diff --git a/.github/scripts/thread-transfer-report.cjs b/.github/scripts/thread-transfer-report.cjs
deleted file mode 100644
index 94a02b7806dc..000000000000
--- a/.github/scripts/thread-transfer-report.cjs
+++ /dev/null
@@ -1,429 +0,0 @@
-const fs = require("node:fs");
-const path = require("node:path");
-
-const ARTIFACT_NAME = "thread-transfer-results";
-const RESULT_FILE = "thread-transfer-result.json";
-const COMMENT_MARKER = "<!-- t3-thread-transfer-report -->";
-const PROVIDERS = ["codex", "claudeAgent"];
-const OBSERVED_KEYS = [
-  "totalWireBytes",
-  "threadSnapshotWireBytes",
-  "threadSnapshotDecodedBytes",
-  "measuredTurnWebSocketWireBytes",
-  "measuredTurnWebSocketDecodedBytes",
-  "measuredTurnWebSocketMessages",
-];
-const CEILING_KEYS = [
-  "totalWireBytes",
-  "threadSnapshotWireBytes",
-  "measuredTurnWebSocketWireBytes",
-  "measuredTurnWebSocketDecodedBytes",
-  "measuredTurnWebSocketMessages",
-];
-const SCENARIO_KEYS = [
-  "id",
-  "historyTurns",
-  "historyCommandToolsPerTurn",
-  "historyMcpResultBytes",
-  "measuredCommandTools",
-  "measuredMcpResultBytes",
-];
-
-function resultShaMarker(sha) {
-  return `<!-- t3-thread-transfer-result-sha:${sha} -->`;
-}
-
-function assertObject(value, label) {
-  if (value === null || typeof value !== "object" || Array.isArray(value)) {
-    throw new Error(`${label} must be an object`);
-  }
-}
-
-function assertExactKeys(value, expected, label) {
-  assertObject(value, label);
-  const actual = Object.keys(value).sort();
-  const wanted = [...expected].sort();
-  if (actual.length !== wanted.length || actual.some((key, index) => key !== wanted[index])) {
-    throw new Error(`${label} has unexpected fields`);
-  }
-}
-
-function assertMetric(value, label) {
-  if (!Number.isSafeInteger(value) || value < 0 || value > 1_000_000_000) {
-    throw new Error(`${label} must be a non-negative safe integer below 1,000,000,000`);
-  }
-}
-
-function validateResult(value) {
-  assertExactKeys(value, ["schemaVersion", "scenario", "providers"], "result");
-  if (value.schemaVersion !== 1) {
-    throw new Error("result.schemaVersion must be 1");
-  }
-
-  assertExactKeys(value.scenario, SCENARIO_KEYS, "result.scenario");
-  if (value.scenario.id !== "thread-transfer-v1") {
-    throw new Error("result.scenario.id is not supported");
-  }
-  for (const key of SCENARIO_KEYS.slice(1)) {
-    assertMetric(value.scenario[key], `result.scenario.${key}`);
-  }
-
-  assertExactKeys(value.providers, PROVIDERS, "result.providers");
-  for (const provider of PROVIDERS) {
-    const entry = value.providers[provider];
-    assertExactKeys(entry, ["observed", "ceiling"], `result.providers.${provider}`);
-    assertExactKeys(entry.observed, OBSERVED_KEYS, `result.providers.${provider}.observed`);
-    assertExactKeys(entry.ceiling, CEILING_KEYS, `result.providers.${provider}.ceiling`);
-    for (const key of OBSERVED_KEYS) {
-      assertMetric(entry.observed[key], `result.providers.${provider}.observed.${key}`);
-    }
-    for (const key of CEILING_KEYS) {
-      assertMetric(entry.ceiling[key], `result.providers.${provider}.ceiling.${key}`);
-    }
-  }
-
-  return value;
-}
-
-function readResult(directory) {
-  if (!directory) return undefined;
-  const file = path.join(directory, RESULT_FILE);
-  if (!fs.existsSync(file)) return undefined;
-  const stat = fs.lstatSync(file);
-  if (!stat.isFile() || stat.size > 64 * 1_024) {
-    throw new Error("thread transfer result must be a regular file smaller than 64 KiB");
-  }
-  return validateResult(JSON.parse(fs.readFileSync(file, "utf8")));
-}
-
-function formatBytes(bytes) {
-  if (bytes < 1_024) return `${bytes} B`;
-  if (bytes >= 1_024 * 1_024) return `${(bytes / 1_024 / 1_024).toFixed(2)} MiB`;
-  return `${(bytes / 1_024).toFixed(1)} KiB`;
-}
-
-function formatValue(value, kind) {
-  return kind === "messages" ? value.toLocaleString("en-US") : formatBytes(value);
-}
-
-function formatImpact(current, baseline, kind) {
-  if (baseline === undefined) return "—";
-  const delta = current - baseline;
-  const prefix = delta > 0 ? "+" : delta < 0 ? "−" : "";
-  const magnitude = formatValue(Math.abs(delta), kind);
-  const percent =
-    baseline === 0 ? "" : ` (${prefix}${Math.abs((delta / baseline) * 100).toFixed(1)}%)`;
-  return `${prefix}${magnitude}${percent}`;
-}
-
-function sameScenario(left, right) {
-  return SCENARIO_KEYS.every((key) => left[key] === right[key]);
-}
-
-const METRICS = [
-  { key: "totalWireBytes", label: "Total thread wire", kind: "bytes" },
-  { key: "threadSnapshotWireBytes", label: "Thread snapshot wire", kind: "bytes" },
-  {
-    key: "measuredTurnWebSocketWireBytes",
-    label: "Live turn WebSocket wire",
-    kind: "bytes",
-  },
-  {
-    key: "measuredTurnWebSocketDecodedBytes",
-    label: "Live turn WebSocket decoded",
-    kind: "bytes",
-  },
-  { key: "measuredTurnWebSocketMessages", label: "Live turn messages", kind: "messages" },
-];
-
-function renderComment(input) {
-  const current = input.current;
-  const baseline = input.baseline;
-  const comparable = baseline !== undefined && sameScenario(current.scenario, baseline.scenario);
-  const rows = [];
-  const ceilingChanges = [];
-  let failed = false;
-
-  for (const provider of PROVIDERS) {
-    for (const metric of METRICS) {
-      const observed = current.providers[provider].observed[metric.key];
-      const ceiling = current.providers[provider].ceiling[metric.key];
-      const baselineObserved = comparable
-        ? baseline.providers[provider].observed[metric.key]
-        : undefined;
-      const pass = observed <= ceiling;
-      failed ||= !pass;
-      rows.push(
-        `| ${provider === "codex" ? "Codex" : "Claude"} | ${metric.label} | ${baselineObserved === undefined ? "—" : formatValue(baselineObserved, metric.kind)} | ${formatValue(observed, metric.kind)} | ${formatImpact(observed, baselineObserved, metric.kind)} | ${formatValue(ceiling, metric.kind)} | ${pass ? "✅" : "❌"} |`,
-      );
-
-      if (baseline && baseline.providers[provider].ceiling[metric.key] !== ceiling) {
-        ceilingChanges.push(
-          `- ${provider === "codex" ? "Codex" : "Claude"} ${metric.label}: ${formatValue(baseline.providers[provider].ceiling[metric.key], metric.kind)} → ${formatValue(ceiling, metric.kind)}`,
-        );
-      }
-    }
-  }
-
-  const baselineLink = input.baselineRun
-    ? `[\`${input.baselineRun.sha.slice(0, 7)}\`](${input.baselineRun.url})`
-    : "unavailable";
-  const currentLink = `[\`${input.currentRun.sha.slice(0, 7)}\`](${input.currentRun.url})`;
-  const notices = [];
-  if (!baseline) {
-    notices.push(
-      "> ℹ️ No successful `main` baseline artifact is available yet. This run establishes the initial measurement.",
-    );
-  } else if (!comparable) {
-    notices.push(
-      "> ⚠️ The thread fixture changed, so impact percentages are not directly comparable to the `main` baseline.",
-    );
-  } else if (!input.baselineRun.matchesBase) {
-    notices.push(
-      "> ℹ️ The exact PR base did not have a successful artifact. Baseline uses the latest successful `main` measurement shown below.",
-    );
-  }
-  if (ceilingChanges.length > 0) {
-    notices.push(
-      `> ⚠️ **This PR changes transfer ceilings:**\n>\n${ceilingChanges.map((line) => `> ${line}`).join("\n")}`,
-    );
-  }
-
-  return [
-    COMMENT_MARKER,
-    resultShaMarker(input.currentRun.sha),
-    "## Thread transfer impact",
-    "",
-    failed
-      ? "❌ One or more thread transfer ceilings were exceeded."
-      : "✅ Thread transfer remains within every enforced ceiling.",
-    ...(notices.length > 0 ? ["", ...notices] : []),
-    "",
-    "| Provider | Metric | Main baseline | This PR | Impact | PR ceiling | |",
-    "| --- | --- | ---: | ---: | ---: | ---: | --- |",
-    ...rows,
-    "",
-    `Baseline: ${baselineLink} · PR result: ${currentLink} · Source CI: ${input.currentRun.conclusion}`,
-    "",
-    "<details>",
-    "<summary>Scenario and decoded snapshot size</summary>",
-    "",
-    `${current.scenario.historyTurns} historical turns, ${current.scenario.historyCommandToolsPerTurn} command tools per turn, ${formatBytes(current.scenario.historyMcpResultBytes)} retained MCP result per historical turn, and a ${formatBytes(current.scenario.measuredMcpResultBytes)} retained result in the measured turn.`,
-    "",
-    ...PROVIDERS.map(
-      (provider) =>
-        `- ${provider === "codex" ? "Codex" : "Claude"} decoded thread snapshot: ${formatBytes(current.providers[provider].observed.threadSnapshotDecodedBytes)}`,
-    ),
-    "",
-    "</details>",
-    "",
-    "_Updated in place by a trusted workflow. PR artifacts are strictly validated and never executed._",
-  ].join("\n");
-}
-
-async function artifactsForRun(github, owner, repo, runId) {
-  return github.paginate(github.rest.actions.listWorkflowRunArtifacts, {
-    owner,
-    repo,
-    run_id: runId,
-    per_page: 100,
-  });
-}
-
-function findResultArtifact(artifacts) {
-  return artifacts.find((artifact) => artifact.name === ARTIFACT_NAME && !artifact.expired);
-}
-
-async function resolve({ github, context, core }) {
-  const source = context.payload.workflow_run;
-  const { owner, repo } = context.repo;
-  if (source.event !== "pull_request") {
-    core.setOutput("publish", "false");
-    return;
-  }
-
-  let pullNumber = source.pull_requests?.[0]?.number;
-  if (!pullNumber) {
-    const associated = await github.paginate(
-      github.rest.repos.listPullRequestsAssociatedWithCommit,
-      { owner, repo, commit_sha: source.head_sha, per_page: 100 },
-    );
-    const matchingPulls = associated.filter(
-      (pull) =>
-        pull.state === "open" &&
-        pull.head.sha === source.head_sha &&
-        pull.head.ref === source.head_branch,
-    );
-    if (matchingPulls.length !== 1) {
-      core.info(
-        `Expected one open pull request for ${source.head_repository?.full_name ?? "unknown repository"}:${source.head_branch ?? "unknown branch"} at ${source.head_sha}; found ${matchingPulls.length}.`,
-      );
-      core.setOutput("publish", "false");
-      return;
-    }
-    pullNumber = matchingPulls[0].number;
-  }
-  if (!pullNumber) {
-    core.info("No open pull request is associated with the completed CI run.");
-    core.setOutput("publish", "false");
-    return;
-  }
-
-  const { data: pull } = await github.rest.pulls.get({ owner, repo, pull_number: pullNumber });
-  if (pull.head.sha !== source.head_sha) {
-    core.info(`Skipping stale CI result ${source.head_sha}; PR head is ${pull.head.sha}.`);
-    core.setOutput("publish", "false");
-    return;
-  }
-
-  const sourceArtifacts = await artifactsForRun(github, owner, repo, source.id);
-  const sourceArtifact = findResultArtifact(sourceArtifacts);
-  const workflowRuns = await github.paginate(github.rest.actions.listWorkflowRuns, {
-    owner,
-    repo,
-    workflow_id: source.workflow_id,
-    branch: pull.base.ref,
-    event: "push",
-    status: "success",
-    per_page: 100,
-  });
-  const orderedRuns = [
-    ...workflowRuns.filter((run) => run.head_sha === pull.base.sha),
-    ...workflowRuns.filter((run) => run.head_sha !== pull.base.sha),
-  ].slice(0, 20);
-
-  let baselineRun;
-  for (const run of orderedRuns) {
-    const artifacts = await artifactsForRun(github, owner, repo, run.id);
-    if (findResultArtifact(artifacts)) {
-      baselineRun = run;
-      break;
-    }
-  }
-
-  core.setOutput("publish", "true");
-  core.setOutput("pull_number", String(pullNumber));
-  core.setOutput("pr_artifact", sourceArtifact ? "true" : "false");
-  core.setOutput("pr_run_id", String(source.id));
-  core.setOutput("pr_sha", source.head_sha);
-  core.setOutput("pr_conclusion", source.conclusion ?? "unknown");
-  core.setOutput("baseline_artifact", baselineRun ? "true" : "false");
-  core.setOutput("baseline_run_id", baselineRun ? String(baselineRun.id) : "");
-  core.setOutput("baseline_sha", baselineRun?.head_sha ?? "");
-  core.setOutput(
-    "baseline_matches_base",
-    baselineRun?.head_sha === pull.base.sha ? "true" : "false",
-  );
-}
-
-async function upsertComment(github, context, pullNumber, body, options = {}) {
-  const { owner, repo } = context.repo;
-  const comments = await github.paginate(github.rest.issues.listComments, {
-    owner,
-    repo,
-    issue_number: pullNumber,
-    per_page: 100,
-  });
-  const existing = comments.find(
-    (comment) =>
-      comment.user?.login === "github-actions[bot]" && comment.body?.includes(COMMENT_MARKER),
-  );
-  if (
-    options.preserveResultSha &&
-    existing?.body?.includes(resultShaMarker(options.preserveResultSha))
-  ) {
-    return;
-  }
-  if (existing) {
-    await github.rest.issues.updateComment({ owner, repo, comment_id: existing.id, body });
-  } else {
-    await github.rest.issues.createComment({ owner, repo, issue_number: pullNumber, body });
-  }
-}
-
-async function upsertCommentForCurrentHead(
-  github,
-  context,
-  core,
-  pullNumber,
-  expectedSha,
-  body,
-  options,
-) {
-  const { owner, repo } = context.repo;
-  const { data: pull } = await github.rest.pulls.get({
-    owner,
-    repo,
-    pull_number: pullNumber,
-  });
-  if (pull.head.sha !== expectedSha) {
-    core.info(`Skipping stale CI result ${expectedSha}; PR head is ${pull.head.sha}.`);
-    return false;
-  }
-
-  await upsertComment(github, context, pullNumber, body, options);
-  return true;
-}
-
-async function publish({ github, context, core }) {
-  const pullNumber = Number(process.env.PR_NUMBER);
-  if (!Number.isSafeInteger(pullNumber) || pullNumber <= 0) {
-    throw new Error("PR_NUMBER is invalid");
-  }
-
-  const current = readResult(process.env.PR_RESULT_DIR);
-  const currentRun = {
-    sha: process.env.PR_SHA,
-    conclusion: process.env.PR_CONCLUSION,
-    url: `https://github.com/${context.repo.owner}/${context.repo.repo}/actions/runs/${process.env.PR_RUN_ID}`,
-  };
-  if (!current) {
-    await upsertCommentForCurrentHead(
-      github,
-      context,
-      core,
-      pullNumber,
-      currentRun.sha,
-      [
-        COMMENT_MARKER,
-        "## Thread transfer impact",
-        "",
-        `⚠️ The latest [CI run](${currentRun.url}) did not produce a thread transfer result for \`${currentRun.sha.slice(0, 7)}\`.`,
-        "",
-        "_This comment will update automatically after the next completed run._",
-      ].join("\n"),
-      { preserveResultSha: currentRun.sha },
-    );
-    return;
-  }
-
-  const baseline = readResult(process.env.BASELINE_RESULT_DIR);
-  const baselineRun = baseline
-    ? {
-        sha: process.env.BASELINE_SHA,
-        matchesBase: process.env.BASELINE_MATCHES_BASE === "true",
-        url: `https://github.com/${context.repo.owner}/${context.repo.repo}/actions/runs/${process.env.BASELINE_RUN_ID}`,
-      }
-    : undefined;
-  const body = renderComment({ current, baseline, currentRun, baselineRun });
-  const published = await upsertCommentForCurrentHead(
-    github,
-    context,
-    core,
-    pullNumber,
-    currentRun.sha,
-    body,
-  );
-  if (published) {
-    core.info(`Updated thread transfer report on PR #${pullNumber}.`);
-  }
-}
-
-module.exports = {
-  publish,
-  readResult,
-  renderComment,
-  resolve,
-  upsertCommentForCurrentHead,
-  validateResult,
-};
diff --git a/.github/scripts/thread-transfer-report.test.cjs b/.github/scripts/thread-transfer-report.test.cjs
deleted file mode 100644
index 4935864e46f0..000000000000
--- a/.github/scripts/thread-transfer-report.test.cjs
+++ /dev/null
@@ -1,292 +0,0 @@
-const assert = require("node:assert/strict");
-const test = require("node:test");
-
-const {
-  renderComment,
-  resolve,
-  upsertCommentForCurrentHead,
-  validateResult,
-} = require("./thread-transfer-report.cjs");
-
-function result(overrides = {}) {
-  const observed = {
-    totalWireBytes: 2_200_000,
-    threadSnapshotWireBytes: 1_950_000,
-    threadSnapshotDecodedBytes: 9_100_000,
-    measuredTurnWebSocketWireBytes: 250_000,
-    measuredTurnWebSocketDecodedBytes: 1_150_000,
-    measuredTurnWebSocketMessages: 15,
-  };
-  const ceiling = {
-    totalWireBytes: 2_900_000,
-    threadSnapshotWireBytes: 2_600_000,
-    measuredTurnWebSocketWireBytes: 320_000,
-    measuredTurnWebSocketDecodedBytes: 1_550_000,
-    measuredTurnWebSocketMessages: 20,
-  };
-  return {
-    schemaVersion: 1,
-    scenario: {
-      id: "thread-transfer-v1",
-      historyTurns: 10,
-      historyCommandToolsPerTurn: 5,
-      historyMcpResultBytes: 900_000,
-      measuredCommandTools: 20,
-      measuredMcpResultBytes: 1_100_000,
-    },
-    providers: {
-      codex: { observed: { ...observed, ...overrides }, ceiling },
-      claudeAgent: { observed, ceiling },
-    },
-  };
-}
-
-test("validates the fixed artifact schema", () => {
-  assert.equal(validateResult(result()).schemaVersion, 1);
-  assert.throws(
-    () => validateResult({ ...result(), injectedMarkdown: "@everyone" }),
-    /unexpected fields/,
-  );
-  assert.throws(
-    () => validateResult(result({ totalWireBytes: "lots" })),
-    /non-negative safe integer/,
-  );
-});
-
-test("renders baseline, impact, ceiling, and ceiling changes", () => {
-  const baseline = result();
-  const current = result({ measuredTurnWebSocketWireBytes: 260_000 });
-  current.providers.codex.ceiling = {
-    ...current.providers.codex.ceiling,
-    measuredTurnWebSocketWireBytes: 330_000,
-  };
-  const comment = renderComment({
-    current,
-    baseline,
-    currentRun: {
-      sha: "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
-      conclusion: "success",
-      url: "https://github.com/pingdotgg/t3code/actions/runs/2",
-    },
-    baselineRun: {
-      sha: "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
-      matchesBase: true,
-      url: "https://github.com/pingdotgg/t3code/actions/runs/1",
-    },
-  });
-
-  assert.match(comment, /Main baseline \| This PR \| Impact \| PR ceiling/);
-  assert.match(comment, /\+9\.8 KiB \(\+4\.0%\)/);
-  assert.match(comment, /This PR changes transfer ceilings/);
-  assert.match(comment, /312\.5 KiB → 322\.3 KiB/);
-  assert.match(comment, /<!-- t3-thread-transfer-report -->/);
-  assert.match(
-    comment,
-    /<!-- t3-thread-transfer-result-sha:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb -->/,
-  );
-});
-
-test("resolves a fallback PR with a redacted head repo and exact main baseline", async () => {
-  const outputs = {};
-  const listWorkflowRunArtifacts = () => {};
-  const listWorkflowRuns = () => {};
-  const listPullRequestsAssociatedWithCommit = () => {};
-  const github = {
-    paginate: async (method, input) => {
-      if (method === listPullRequestsAssociatedWithCommit) {
-        return [
-          {
-            number: 5350,
-            state: "open",
-            head: { sha: "head-sha", ref: "feature-branch", repo: null },
-          },
-        ];
-      }
-      if (method === listWorkflowRunArtifacts) {
-        return [
-          {
-            name: "thread-transfer-results",
-            expired: false,
-            runId: input.run_id,
-          },
-        ];
-      }
-      if (method === listWorkflowRuns) {
-        return [{ id: 1, head_sha: "base-sha" }];
-      }
-      throw new Error("unexpected pagination call");
-    },
-    rest: {
-      actions: { listWorkflowRunArtifacts, listWorkflowRuns },
-      pulls: {
-        get: async () => ({
-          data: {
-            head: { sha: "head-sha" },
-            base: { sha: "base-sha", ref: "main" },
-          },
-        }),
-      },
-      repos: { listPullRequestsAssociatedWithCommit },
-    },
-  };
-  await resolve({
-    github,
-    context: {
-      repo: { owner: "pingdotgg", repo: "t3code" },
-      payload: {
-        workflow_run: {
-          id: 2,
-          event: "pull_request",
-          workflow_id: 3,
-          head_sha: "head-sha",
-          head_branch: "feature-branch",
-          head_repository: { full_name: "pingdotgg/t3code" },
-          conclusion: "success",
-          pull_requests: [],
-        },
-      },
-    },
-    core: {
-      info: () => {},
-      setOutput: (key, value) => {
-        outputs[key] = value;
-      },
-    },
-  });
-
-  assert.equal(outputs.publish, "true");
-  assert.equal(outputs.pull_number, "5350");
-  assert.equal(outputs.pr_artifact, "true");
-  assert.equal(outputs.baseline_run_id, "1");
-  assert.equal(outputs.baseline_matches_base, "true");
-});
-
-test("does not guess when a fallback commit belongs to multiple PRs", async () => {
-  const outputs = {};
-  const listPullRequestsAssociatedWithCommit = () => {};
-  let fetchedPull = false;
-  await resolve({
-    github: {
-      paginate: async (method) => {
-        assert.equal(method, listPullRequestsAssociatedWithCommit);
-        return [5350, 5351].map((number) => ({
-          number,
-          state: "open",
-          head: {
-            sha: "head-sha",
-            ref: "feature-branch",
-            repo: { full_name: "pingdotgg/t3code" },
-          },
-        }));
-      },
-      rest: {
-        actions: {},
-        pulls: {
-          get: async () => {
-            fetchedPull = true;
-          },
-        },
-        repos: { listPullRequestsAssociatedWithCommit },
-      },
-    },
-    context: {
-      repo: { owner: "pingdotgg", repo: "t3code" },
-      payload: {
-        workflow_run: {
-          id: 2,
-          event: "pull_request",
-          workflow_id: 3,
-          head_sha: "head-sha",
-          head_branch: "feature-branch",
-          head_repository: { full_name: "pingdotgg/t3code" },
-          conclusion: "success",
-          pull_requests: [],
-        },
-      },
-    },
-    core: {
-      info: () => {},
-      setOutput: (key, value) => {
-        outputs[key] = value;
-      },
-    },
-  });
-
-  assert.equal(outputs.publish, "false");
-  assert.equal(fetchedPull, false);
-});
-
-test("does not publish a stale result after the PR head advances", async () => {
-  let listedComments = false;
-  const info = [];
-  const published = await upsertCommentForCurrentHead(
-    {
-      paginate: async () => {
-        listedComments = true;
-        return [];
-      },
-      rest: {
-        issues: {
-          listComments: () => {},
-          createComment: () => {
-            throw new Error("must not create a stale comment");
-          },
-          updateComment: () => {
-            throw new Error("must not update a stale comment");
-          },
-        },
-        pulls: {
-          get: async () => ({ data: { head: { sha: "new-head-sha" } } }),
-        },
-      },
-    },
-    { repo: { owner: "pingdotgg", repo: "t3code" } },
-    { info: (message) => info.push(message) },
-    5350,
-    "old-head-sha",
-    "stale body",
-  );
-
-  assert.equal(published, false);
-  assert.equal(listedComments, false);
-  assert.deepEqual(info, ["Skipping stale CI result old-head-sha; PR head is new-head-sha."]);
-});
-
-test("preserves a successful result when a same-SHA rerun has no artifact", async () => {
-  let updatedComment = false;
-  const sha = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
-  const published = await upsertCommentForCurrentHead(
-    {
-      paginate: async () => [
-        {
-          id: 1,
-          user: { login: "github-actions[bot]" },
-          body: `<!-- t3-thread-transfer-report -->\n<!-- t3-thread-transfer-result-sha:${sha} -->`,
-        },
-      ],
-      rest: {
-        issues: {
-          listComments: () => {},
-          createComment: () => {
-            updatedComment = true;
-          },
-          updateComment: () => {
-            updatedComment = true;
-          },
-        },
-        pulls: {
-          get: async () => ({ data: { head: { sha } } }),
-        },
-      },
-    },
-    { repo: { owner: "pingdotgg", repo: "t3code" } },
-    { info: () => {} },
-    5350,
-    sha,
-    "missing artifact warning",
-    { preserveResultSha: sha },
-  );
-
-  assert.equal(published, true);
-  assert.equal(updatedComment, false);
-});
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 570abd7d0505..019440d0c5b3 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -75,6 +75,16 @@ jobs:
             !/.repos/
           sparse-checkout-cone-mode: false
 
+      # Blacksmith boots GitHub's Ubuntu runner image (gcc is usually present),
+      # but ACP process-tree live tests compile a small pthread fixture with `cc`
+      # and soft-skip when it is missing. Install build-essential so that path
+      # always runs in CI instead of silently no-oping.
+      - name: Install C toolchain for process-tree fixtures
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y --no-install-recommends build-essential
+          command -v cc
+
       - name: Setup Vite+
         uses: voidzero-dev/setup-vp@v1
         with:
diff --git a/.github/workflows/thread-transfer-report.yml b/.github/workflows/thread-transfer-report.yml
deleted file mode 100644
index 23eec72923bd..000000000000
--- a/.github/workflows/thread-transfer-report.yml
+++ /dev/null
@@ -1,75 +0,0 @@
-name: Thread Transfer Report
-
-on:
-  workflow_run:
-    workflows: [CI]
-    types: [completed]
-
-permissions:
-  actions: read
-  contents: read
-  pull-requests: write
-
-jobs:
-  publish:
-    name: Publish PR comment
-    if: github.event.workflow_run.event == 'pull_request'
-    runs-on: ubuntu-24.04
-    concurrency:
-      group: thread-transfer-report-${{ github.event.workflow_run.pull_requests[0].number || github.event.workflow_run.id }}
-      cancel-in-progress: true
-    steps:
-      # workflow_run has a write-capable token even for fork PRs. Only load the
-      # publisher from the trusted default branch and never execute PR code.
-      - name: Checkout trusted publisher
-        uses: actions/checkout@v6
-        with:
-          ref: ${{ github.event.repository.default_branch }}
-          sparse-checkout: .github/scripts
-
-      - name: Test trusted publisher
-        run: node --test .github/scripts/thread-transfer-report.test.cjs
-
-      - id: resolve
-        name: Resolve PR and baseline artifacts
-        uses: actions/github-script@v8
-        with:
-          script: |
-            const reporter = require("./.github/scripts/thread-transfer-report.cjs");
-            await reporter.resolve({ github, context, core });
-
-      - name: Download PR result
-        if: steps.resolve.outputs.publish == 'true' && steps.resolve.outputs.pr_artifact == 'true'
-        uses: actions/download-artifact@v8
-        with:
-          name: thread-transfer-results
-          path: ${{ runner.temp }}/thread-transfer/pr
-          github-token: ${{ secrets.GITHUB_TOKEN }}
-          run-id: ${{ steps.resolve.outputs.pr_run_id }}
-
-      - name: Download main baseline
-        if: steps.resolve.outputs.publish == 'true' && steps.resolve.outputs.baseline_artifact == 'true'
-        uses: actions/download-artifact@v8
-        with:
-          name: thread-transfer-results
-          path: ${{ runner.temp }}/thread-transfer/main
-          github-token: ${{ secrets.GITHUB_TOKEN }}
-          run-id: ${{ steps.resolve.outputs.baseline_run_id }}
-
-      - name: Update thread transfer comment
-        if: steps.resolve.outputs.publish == 'true'
-        uses: actions/github-script@v8
-        env:
-          PR_NUMBER: ${{ steps.resolve.outputs.pull_number }}
-          PR_SHA: ${{ steps.resolve.outputs.pr_sha }}
-          PR_CONCLUSION: ${{ steps.resolve.outputs.pr_conclusion }}
-          PR_RUN_ID: ${{ steps.resolve.outputs.pr_run_id }}
-          PR_RESULT_DIR: ${{ runner.temp }}/thread-transfer/pr
-          BASELINE_SHA: ${{ steps.resolve.outputs.baseline_sha }}
-          BASELINE_MATCHES_BASE: ${{ steps.resolve.outputs.baseline_matches_base }}
-          BASELINE_RUN_ID: ${{ steps.resolve.outputs.baseline_run_id }}
-          BASELINE_RESULT_DIR: ${{ runner.temp }}/thread-transfer/main
-        with:
-          script: |
-            const reporter = require("./.github/scripts/thread-transfer-report.cjs");
-            await reporter.publish({ github, context, core });
diff --git a/README.md b/README.md
index 8ec101387f67..cf90fdf7ef54 100644
--- a/README.md
+++ b/README.md
@@ -79,6 +79,7 @@ Full docs live in [docs/](./docs). There's no docs site yet.
 - [Permission modes](./docs/user/permission-modes.md)
 - [Keyboard shortcuts](./docs/user/keybindings.md)
 - [Customize a project icon](./docs/user/project-settings.md)
+- [Appearance preferences](./docs/user/appearance.md)
 - [Remote access from a phone or another machine](./docs/user/remote-access.md)
 - [Keeping app and server in sync](./docs/user/updating.md)
 - [Source control integrations](./docs/user/source-control.md)
diff --git a/apps/desktop/src/app/DesktopEnvironment.test.ts b/apps/desktop/src/app/DesktopEnvironment.test.ts
index 218e2c3e4ba2..ee12b37b8c8b 100644
--- a/apps/desktop/src/app/DesktopEnvironment.test.ts
+++ b/apps/desktop/src/app/DesktopEnvironment.test.ts
@@ -96,6 +96,8 @@ describe("DesktopEnvironment", () => {
       assert.equal(environment.logDir, "/tmp/t3/userdata/logs");
       assert.equal(environment.browserArtifactsDir, "/tmp/t3/userdata/browser-artifacts");
       assert.equal(environment.serverSettingsPath, "/tmp/t3/userdata/settings.json");
+      assert.equal(environment.userDataDirName, "t3code");
+      assert.equal(environment.legacyUserDataDirName, "T3 Code (Alpha)");
     }),
   );
 
diff --git a/apps/desktop/src/backend/tailscaleEndpointProvider.ts b/apps/desktop/src/backend/tailscaleEndpointProvider.ts
index 0b48adc308c3..4f53a7e6f54a 100644
--- a/apps/desktop/src/backend/tailscaleEndpointProvider.ts
+++ b/apps/desktop/src/backend/tailscaleEndpointProvider.ts
@@ -121,7 +121,7 @@ export const resolveTailscaleAdvertisedEndpoints = Effect.fn("resolveTailscaleAd
       input.readMagicDnsName ??
       readTailscaleStatus.pipe(
         Effect.map((status) => status.magicDnsName),
-        Effect.orElseSucceed(() => null),
+        Effect.orElseSucceed((): string | null => null),
       );
     const dnsName =
       input.statusJson === undefined
diff --git a/apps/desktop/src/settings/DesktopClientSettings.test.ts b/apps/desktop/src/settings/DesktopClientSettings.test.ts
index e32a5e2d0807..850300cb3496 100644
--- a/apps/desktop/src/settings/DesktopClientSettings.test.ts
+++ b/apps/desktop/src/settings/DesktopClientSettings.test.ts
@@ -38,6 +38,7 @@ const clientSettings: ClientSettings = {
   glassOpacity: 80,
   planModeEnabled: false,
   showSkillsInSlashMenu: false,
+  persistComposerContextStrip: true,
   providerModelPreferences: {},
   sidebarAutoSettleAfterDays: 3,
   sidebarAutoSettleOnMerge: true,
diff --git a/apps/marketing/src/pages/index.astro b/apps/marketing/src/pages/index.astro
index e45cb7602873..274ffc3d876b 100644
--- a/apps/marketing/src/pages/index.astro
+++ b/apps/marketing/src/pages/index.astro
@@ -218,7 +218,7 @@ const mobileEndorsementRows = [
           <div class="harness-mark"><img src="/harnesses/cursor_light.svg" alt="" /></div>
           <div class="harness-meta">
             <div class="harness-name">Cursor</div>
-            <div class="harness-tag">cursor-agent</div>
+            <div class="harness-tag">@cursor/sdk</div>
           </div>
         </div>
         <div class="harness">
diff --git a/apps/mobile/generated-uniwind-themes.css b/apps/mobile/generated-uniwind-themes.css
index 7f8f9c16afca..b06ee830d594 100644
--- a/apps/mobile/generated-uniwind-themes.css
+++ b/apps/mobile/generated-uniwind-themes.css
@@ -5,6 +5,8 @@
       --color-adaptive-amber-50-950-a40: oklch(98.7% 0.022 95.277);
       --color-adaptive-amber-200-900-a60: oklch(92.4% 0.12 95.746);
       --color-adaptive-amber-500-a12-a16: oklch(76.9% 0.188 70.08 / 12%);
+      --color-adaptive-amber-500-a10-400-a10: oklch(76.9% 0.188 70.08 / 10%);
+      --color-adaptive-amber-500-a25-400-a25: oklch(76.9% 0.188 70.08 / 25%);
       --color-adaptive-amber-700-300: oklch(55.5% 0.163 48.998);
       --color-adaptive-amber-700-400: oklch(55.5% 0.163 48.998);
       --color-adaptive-amber-800-200: oklch(47.3% 0.137 46.201);
@@ -15,6 +17,7 @@
       --color-adaptive-blue-600-400: oklch(54.6% 0.245 262.881);
       --color-adaptive-black-a10-a25: rgb(0 0 0 / 10%);
       --color-adaptive-black-a15-a35: rgb(0 0 0 / 15%);
+      --color-adaptive-black-a2p5-white-a2p5: rgb(0 0 0 / 2.5%);
       --color-adaptive-emerald-500-a12-a16: oklch(69.6% 0.17 162.48 / 12%);
       --color-adaptive-emerald-600-400: oklch(59.6% 0.145 163.225);
       --color-adaptive-emerald-700-300: oklch(50.8% 0.118 165.612);
@@ -38,6 +41,8 @@
       --color-adaptive-neutral-600-300: oklch(43.9% 0 0);
       --color-adaptive-neutral-600-400: oklch(43.9% 0 0);
       --color-adaptive-neutral-950-50: oklch(14.5% 0 0);
+      --color-adaptive-neutral-950-a5-white-a5: oklch(14.5% 0 0 / 5%);
+      --color-adaptive-neutral-950-a10-white-a10: oklch(14.5% 0 0 / 10%);
       --color-adaptive-red-50-950-a80: oklch(97.1% 0.013 17.38);
       --color-adaptive-red-200-800: oklch(88.5% 0.062 18.334);
       --color-adaptive-red-600-a80-400-a80: oklch(57.7% 0.245 27.325 / 80%);
@@ -50,6 +55,8 @@
       --color-adaptive-rose-600-400: oklch(58.6% 0.253 17.585);
       --color-adaptive-rose-700-300: oklch(51.4% 0.222 16.935);
       --color-adaptive-sky-500-a12-a16: oklch(68.5% 0.169 237.323 / 12%);
+      --color-adaptive-sky-500-a10-400-a10: oklch(68.5% 0.169 237.323 / 10%);
+      --color-adaptive-sky-500-a25-400-a25: oklch(68.5% 0.169 237.323 / 25%);
       --color-adaptive-sky-600-400: oklch(58.8% 0.158 241.966);
       --color-adaptive-sky-700-300: oklch(50% 0.134 242.749);
       --color-adaptive-violet-500-a12-a16: oklch(60.6% 0.25 292.717 / 12%);
@@ -65,6 +72,8 @@
       --color-adaptive-amber-50-950-a40: oklch(27.9% 0.077 45.635 / 40%);
       --color-adaptive-amber-200-900-a60: oklch(41.4% 0.112 45.904 / 60%);
       --color-adaptive-amber-500-a12-a16: oklch(76.9% 0.188 70.08 / 16%);
+      --color-adaptive-amber-500-a10-400-a10: oklch(82.8% 0.189 84.429 / 10%);
+      --color-adaptive-amber-500-a25-400-a25: oklch(82.8% 0.189 84.429 / 25%);
       --color-adaptive-amber-700-300: oklch(87.9% 0.169 91.605);
       --color-adaptive-amber-700-400: oklch(82.8% 0.189 84.429);
       --color-adaptive-amber-800-200: oklch(92.4% 0.12 95.746);
@@ -75,6 +84,7 @@
       --color-adaptive-blue-600-400: oklch(70.7% 0.165 254.624);
       --color-adaptive-black-a10-a25: rgb(0 0 0 / 25%);
       --color-adaptive-black-a15-a35: rgb(0 0 0 / 35%);
+      --color-adaptive-black-a2p5-white-a2p5: rgb(255 255 255 / 2.5%);
       --color-adaptive-emerald-500-a12-a16: oklch(69.6% 0.17 162.48 / 16%);
       --color-adaptive-emerald-600-400: oklch(76.5% 0.177 163.223);
       --color-adaptive-emerald-700-300: oklch(84.5% 0.143 164.978);
@@ -98,6 +108,8 @@
       --color-adaptive-neutral-600-300: oklch(87% 0 0);
       --color-adaptive-neutral-600-400: oklch(70.8% 0 0);
       --color-adaptive-neutral-950-50: oklch(98.5% 0 0);
+      --color-adaptive-neutral-950-a5-white-a5: rgb(255 255 255 / 5%);
+      --color-adaptive-neutral-950-a10-white-a10: rgb(255 255 255 / 10%);
       --color-adaptive-red-50-950-a80: oklch(25.8% 0.092 26.042 / 80%);
       --color-adaptive-red-200-800: oklch(44.4% 0.177 26.899);
       --color-adaptive-red-600-a80-400-a80: oklch(70.4% 0.191 22.216 / 80%);
@@ -110,6 +122,8 @@
       --color-adaptive-rose-600-400: oklch(71.2% 0.194 13.428);
       --color-adaptive-rose-700-300: oklch(81% 0.117 11.638);
       --color-adaptive-sky-500-a12-a16: oklch(68.5% 0.169 237.323 / 16%);
+      --color-adaptive-sky-500-a10-400-a10: oklch(74.6% 0.16 232.661 / 10%);
+      --color-adaptive-sky-500-a25-400-a25: oklch(74.6% 0.16 232.661 / 25%);
       --color-adaptive-sky-600-400: oklch(74.6% 0.16 232.661);
       --color-adaptive-sky-700-300: oklch(82.8% 0.111 230.318);
       --color-adaptive-violet-500-a12-a16: oklch(60.6% 0.25 292.717 / 16%);
@@ -190,6 +204,8 @@
       --color-adaptive-amber-50-950-a40: oklch(98.7% 0.022 95.277);
       --color-adaptive-amber-200-900-a60: oklch(92.4% 0.12 95.746);
       --color-adaptive-amber-500-a12-a16: oklch(76.9% 0.188 70.08 / 12%);
+      --color-adaptive-amber-500-a10-400-a10: oklch(76.9% 0.188 70.08 / 10%);
+      --color-adaptive-amber-500-a25-400-a25: oklch(76.9% 0.188 70.08 / 25%);
       --color-adaptive-amber-700-300: oklch(55.5% 0.163 48.998);
       --color-adaptive-amber-700-400: oklch(55.5% 0.163 48.998);
       --color-adaptive-amber-800-200: oklch(47.3% 0.137 46.201);
@@ -200,6 +216,7 @@
       --color-adaptive-blue-600-400: oklch(54.6% 0.245 262.881);
       --color-adaptive-black-a10-a25: rgb(0 0 0 / 10%);
       --color-adaptive-black-a15-a35: rgb(0 0 0 / 15%);
+      --color-adaptive-black-a2p5-white-a2p5: rgb(0 0 0 / 2.5%);
       --color-adaptive-emerald-500-a12-a16: oklch(69.6% 0.17 162.48 / 12%);
       --color-adaptive-emerald-600-400: oklch(59.6% 0.145 163.225);
       --color-adaptive-emerald-700-300: oklch(50.8% 0.118 165.612);
@@ -223,6 +240,8 @@
       --color-adaptive-neutral-600-300: oklch(43.9% 0 0);
       --color-adaptive-neutral-600-400: oklch(43.9% 0 0);
       --color-adaptive-neutral-950-50: oklch(14.5% 0 0);
+      --color-adaptive-neutral-950-a5-white-a5: oklch(14.5% 0 0 / 5%);
+      --color-adaptive-neutral-950-a10-white-a10: oklch(14.5% 0 0 / 10%);
       --color-adaptive-red-50-950-a80: oklch(97.1% 0.013 17.38);
       --color-adaptive-red-200-800: oklch(88.5% 0.062 18.334);
       --color-adaptive-red-600-a80-400-a80: oklch(57.7% 0.245 27.325 / 80%);
@@ -235,6 +254,8 @@
       --color-adaptive-rose-600-400: oklch(58.6% 0.253 17.585);
       --color-adaptive-rose-700-300: oklch(51.4% 0.222 16.935);
       --color-adaptive-sky-500-a12-a16: oklch(68.5% 0.169 237.323 / 12%);
+      --color-adaptive-sky-500-a10-400-a10: oklch(68.5% 0.169 237.323 / 10%);
+      --color-adaptive-sky-500-a25-400-a25: oklch(68.5% 0.169 237.323 / 25%);
       --color-adaptive-sky-600-400: oklch(58.8% 0.158 241.966);
       --color-adaptive-sky-700-300: oklch(50% 0.134 242.749);
       --color-adaptive-violet-500-a12-a16: oklch(60.6% 0.25 292.717 / 12%);
@@ -315,6 +336,8 @@
       --color-adaptive-amber-50-950-a40: oklch(27.9% 0.077 45.635 / 40%);
       --color-adaptive-amber-200-900-a60: oklch(41.4% 0.112 45.904 / 60%);
       --color-adaptive-amber-500-a12-a16: oklch(76.9% 0.188 70.08 / 16%);
+      --color-adaptive-amber-500-a10-400-a10: oklch(82.8% 0.189 84.429 / 10%);
+      --color-adaptive-amber-500-a25-400-a25: oklch(82.8% 0.189 84.429 / 25%);
       --color-adaptive-amber-700-300: oklch(87.9% 0.169 91.605);
       --color-adaptive-amber-700-400: oklch(82.8% 0.189 84.429);
       --color-adaptive-amber-800-200: oklch(92.4% 0.12 95.746);
@@ -325,6 +348,7 @@
       --color-adaptive-blue-600-400: oklch(70.7% 0.165 254.624);
       --color-adaptive-black-a10-a25: rgb(0 0 0 / 25%);
       --color-adaptive-black-a15-a35: rgb(0 0 0 / 35%);
+      --color-adaptive-black-a2p5-white-a2p5: rgb(255 255 255 / 2.5%);
       --color-adaptive-emerald-500-a12-a16: oklch(69.6% 0.17 162.48 / 16%);
       --color-adaptive-emerald-600-400: oklch(76.5% 0.177 163.223);
       --color-adaptive-emerald-700-300: oklch(84.5% 0.143 164.978);
@@ -348,6 +372,8 @@
       --color-adaptive-neutral-600-300: oklch(87% 0 0);
       --color-adaptive-neutral-600-400: oklch(70.8% 0 0);
       --color-adaptive-neutral-950-50: oklch(98.5% 0 0);
+      --color-adaptive-neutral-950-a5-white-a5: rgb(255 255 255 / 5%);
+      --color-adaptive-neutral-950-a10-white-a10: rgb(255 255 255 / 10%);
       --color-adaptive-red-50-950-a80: oklch(25.8% 0.092 26.042 / 80%);
       --color-adaptive-red-200-800: oklch(44.4% 0.177 26.899);
       --color-adaptive-red-600-a80-400-a80: oklch(70.4% 0.191 22.216 / 80%);
@@ -360,6 +386,8 @@
       --color-adaptive-rose-600-400: oklch(71.2% 0.194 13.428);
       --color-adaptive-rose-700-300: oklch(81% 0.117 11.638);
       --color-adaptive-sky-500-a12-a16: oklch(68.5% 0.169 237.323 / 16%);
+      --color-adaptive-sky-500-a10-400-a10: oklch(74.6% 0.16 232.661 / 10%);
+      --color-adaptive-sky-500-a25-400-a25: oklch(74.6% 0.16 232.661 / 25%);
       --color-adaptive-sky-600-400: oklch(74.6% 0.16 232.661);
       --color-adaptive-sky-700-300: oklch(82.8% 0.111 230.318);
       --color-adaptive-violet-500-a12-a16: oklch(60.6% 0.25 292.717 / 16%);
@@ -440,6 +468,8 @@
       --color-adaptive-amber-50-950-a40: oklch(98.7% 0.022 95.277);
       --color-adaptive-amber-200-900-a60: oklch(92.4% 0.12 95.746);
       --color-adaptive-amber-500-a12-a16: oklch(76.9% 0.188 70.08 / 12%);
+      --color-adaptive-amber-500-a10-400-a10: oklch(76.9% 0.188 70.08 / 10%);
+      --color-adaptive-amber-500-a25-400-a25: oklch(76.9% 0.188 70.08 / 25%);
       --color-adaptive-amber-700-300: oklch(55.5% 0.163 48.998);
       --color-adaptive-amber-700-400: oklch(55.5% 0.163 48.998);
       --color-adaptive-amber-800-200: oklch(47.3% 0.137 46.201);
@@ -450,6 +480,7 @@
       --color-adaptive-blue-600-400: oklch(54.6% 0.245 262.881);
       --color-adaptive-black-a10-a25: rgb(0 0 0 / 10%);
       --color-adaptive-black-a15-a35: rgb(0 0 0 / 15%);
+      --color-adaptive-black-a2p5-white-a2p5: rgb(0 0 0 / 2.5%);
       --color-adaptive-emerald-500-a12-a16: oklch(69.6% 0.17 162.48 / 12%);
       --color-adaptive-emerald-600-400: oklch(59.6% 0.145 163.225);
       --color-adaptive-emerald-700-300: oklch(50.8% 0.118 165.612);
@@ -473,6 +504,8 @@
       --color-adaptive-neutral-600-300: oklch(43.9% 0 0);
       --color-adaptive-neutral-600-400: oklch(43.9% 0 0);
       --color-adaptive-neutral-950-50: oklch(14.5% 0 0);
+      --color-adaptive-neutral-950-a5-white-a5: oklch(14.5% 0 0 / 5%);
+      --color-adaptive-neutral-950-a10-white-a10: oklch(14.5% 0 0 / 10%);
       --color-adaptive-red-50-950-a80: oklch(97.1% 0.013 17.38);
       --color-adaptive-red-200-800: oklch(88.5% 0.062 18.334);
       --color-adaptive-red-600-a80-400-a80: oklch(57.7% 0.245 27.325 / 80%);
@@ -485,6 +518,8 @@
       --color-adaptive-rose-600-400: oklch(58.6% 0.253 17.585);
       --color-adaptive-rose-700-300: oklch(51.4% 0.222 16.935);
       --color-adaptive-sky-500-a12-a16: oklch(68.5% 0.169 237.323 / 12%);
+      --color-adaptive-sky-500-a10-400-a10: oklch(68.5% 0.169 237.323 / 10%);
+      --color-adaptive-sky-500-a25-400-a25: oklch(68.5% 0.169 237.323 / 25%);
       --color-adaptive-sky-600-400: oklch(58.8% 0.158 241.966);
       --color-adaptive-sky-700-300: oklch(50% 0.134 242.749);
       --color-adaptive-violet-500-a12-a16: oklch(60.6% 0.25 292.717 / 12%);
@@ -565,6 +600,8 @@
       --color-adaptive-amber-50-950-a40: oklch(27.9% 0.077 45.635 / 40%);
       --color-adaptive-amber-200-900-a60: oklch(41.4% 0.112 45.904 / 60%);
       --color-adaptive-amber-500-a12-a16: oklch(76.9% 0.188 70.08 / 16%);
+      --color-adaptive-amber-500-a10-400-a10: oklch(82.8% 0.189 84.429 / 10%);
+      --color-adaptive-amber-500-a25-400-a25: oklch(82.8% 0.189 84.429 / 25%);
       --color-adaptive-amber-700-300: oklch(87.9% 0.169 91.605);
       --color-adaptive-amber-700-400: oklch(82.8% 0.189 84.429);
       --color-adaptive-amber-800-200: oklch(92.4% 0.12 95.746);
@@ -575,6 +612,7 @@
       --color-adaptive-blue-600-400: oklch(70.7% 0.165 254.624);
       --color-adaptive-black-a10-a25: rgb(0 0 0 / 25%);
       --color-adaptive-black-a15-a35: rgb(0 0 0 / 35%);
+      --color-adaptive-black-a2p5-white-a2p5: rgb(255 255 255 / 2.5%);
       --color-adaptive-emerald-500-a12-a16: oklch(69.6% 0.17 162.48 / 16%);
       --color-adaptive-emerald-600-400: oklch(76.5% 0.177 163.223);
       --color-adaptive-emerald-700-300: oklch(84.5% 0.143 164.978);
@@ -598,6 +636,8 @@
       --color-adaptive-neutral-600-300: oklch(87% 0 0);
       --color-adaptive-neutral-600-400: oklch(70.8% 0 0);
       --color-adaptive-neutral-950-50: oklch(98.5% 0 0);
+      --color-adaptive-neutral-950-a5-white-a5: rgb(255 255 255 / 5%);
+      --color-adaptive-neutral-950-a10-white-a10: rgb(255 255 255 / 10%);
       --color-adaptive-red-50-950-a80: oklch(25.8% 0.092 26.042 / 80%);
       --color-adaptive-red-200-800: oklch(44.4% 0.177 26.899);
       --color-adaptive-red-600-a80-400-a80: oklch(70.4% 0.191 22.216 / 80%);
@@ -610,6 +650,8 @@
       --color-adaptive-rose-600-400: oklch(71.2% 0.194 13.428);
       --color-adaptive-rose-700-300: oklch(81% 0.117 11.638);
       --color-adaptive-sky-500-a12-a16: oklch(68.5% 0.169 237.323 / 16%);
+      --color-adaptive-sky-500-a10-400-a10: oklch(74.6% 0.16 232.661 / 10%);
+      --color-adaptive-sky-500-a25-400-a25: oklch(74.6% 0.16 232.661 / 25%);
       --color-adaptive-sky-600-400: oklch(74.6% 0.16 232.661);
       --color-adaptive-sky-700-300: oklch(82.8% 0.111 230.318);
       --color-adaptive-violet-500-a12-a16: oklch(60.6% 0.25 292.717 / 16%);
@@ -690,6 +732,8 @@
       --color-adaptive-amber-50-950-a40: oklch(98.7% 0.022 95.277);
       --color-adaptive-amber-200-900-a60: oklch(92.4% 0.12 95.746);
       --color-adaptive-amber-500-a12-a16: oklch(76.9% 0.188 70.08 / 12%);
+      --color-adaptive-amber-500-a10-400-a10: oklch(76.9% 0.188 70.08 / 10%);
+      --color-adaptive-amber-500-a25-400-a25: oklch(76.9% 0.188 70.08 / 25%);
       --color-adaptive-amber-700-300: oklch(55.5% 0.163 48.998);
       --color-adaptive-amber-700-400: oklch(55.5% 0.163 48.998);
       --color-adaptive-amber-800-200: oklch(47.3% 0.137 46.201);
@@ -700,6 +744,7 @@
       --color-adaptive-blue-600-400: oklch(54.6% 0.245 262.881);
       --color-adaptive-black-a10-a25: rgb(0 0 0 / 10%);
       --color-adaptive-black-a15-a35: rgb(0 0 0 / 15%);
+      --color-adaptive-black-a2p5-white-a2p5: rgb(0 0 0 / 2.5%);
       --color-adaptive-emerald-500-a12-a16: oklch(69.6% 0.17 162.48 / 12%);
       --color-adaptive-emerald-600-400: oklch(59.6% 0.145 163.225);
       --color-adaptive-emerald-700-300: oklch(50.8% 0.118 165.612);
@@ -723,6 +768,8 @@
       --color-adaptive-neutral-600-300: oklch(43.9% 0 0);
       --color-adaptive-neutral-600-400: oklch(43.9% 0 0);
       --color-adaptive-neutral-950-50: oklch(14.5% 0 0);
+      --color-adaptive-neutral-950-a5-white-a5: oklch(14.5% 0 0 / 5%);
+      --color-adaptive-neutral-950-a10-white-a10: oklch(14.5% 0 0 / 10%);
       --color-adaptive-red-50-950-a80: oklch(97.1% 0.013 17.38);
       --color-adaptive-red-200-800: oklch(88.5% 0.062 18.334);
       --color-adaptive-red-600-a80-400-a80: oklch(57.7% 0.245 27.325 / 80%);
@@ -735,6 +782,8 @@
       --color-adaptive-rose-600-400: oklch(58.6% 0.253 17.585);
       --color-adaptive-rose-700-300: oklch(51.4% 0.222 16.935);
       --color-adaptive-sky-500-a12-a16: oklch(68.5% 0.169 237.323 / 12%);
+      --color-adaptive-sky-500-a10-400-a10: oklch(68.5% 0.169 237.323 / 10%);
+      --color-adaptive-sky-500-a25-400-a25: oklch(68.5% 0.169 237.323 / 25%);
       --color-adaptive-sky-600-400: oklch(58.8% 0.158 241.966);
       --color-adaptive-sky-700-300: oklch(50% 0.134 242.749);
       --color-adaptive-violet-500-a12-a16: oklch(60.6% 0.25 292.717 / 12%);
@@ -815,6 +864,8 @@
       --color-adaptive-amber-50-950-a40: oklch(27.9% 0.077 45.635 / 40%);
       --color-adaptive-amber-200-900-a60: oklch(41.4% 0.112 45.904 / 60%);
       --color-adaptive-amber-500-a12-a16: oklch(76.9% 0.188 70.08 / 16%);
+      --color-adaptive-amber-500-a10-400-a10: oklch(82.8% 0.189 84.429 / 10%);
+      --color-adaptive-amber-500-a25-400-a25: oklch(82.8% 0.189 84.429 / 25%);
       --color-adaptive-amber-700-300: oklch(87.9% 0.169 91.605);
       --color-adaptive-amber-700-400: oklch(82.8% 0.189 84.429);
       --color-adaptive-amber-800-200: oklch(92.4% 0.12 95.746);
@@ -825,6 +876,7 @@
       --color-adaptive-blue-600-400: oklch(70.7% 0.165 254.624);
       --color-adaptive-black-a10-a25: rgb(0 0 0 / 25%);
       --color-adaptive-black-a15-a35: rgb(0 0 0 / 35%);
+      --color-adaptive-black-a2p5-white-a2p5: rgb(255 255 255 / 2.5%);
       --color-adaptive-emerald-500-a12-a16: oklch(69.6% 0.17 162.48 / 16%);
       --color-adaptive-emerald-600-400: oklch(76.5% 0.177 163.223);
       --color-adaptive-emerald-700-300: oklch(84.5% 0.143 164.978);
@@ -848,6 +900,8 @@
       --color-adaptive-neutral-600-300: oklch(87% 0 0);
       --color-adaptive-neutral-600-400: oklch(70.8% 0 0);
       --color-adaptive-neutral-950-50: oklch(98.5% 0 0);
+      --color-adaptive-neutral-950-a5-white-a5: rgb(255 255 255 / 5%);
+      --color-adaptive-neutral-950-a10-white-a10: rgb(255 255 255 / 10%);
       --color-adaptive-red-50-950-a80: oklch(25.8% 0.092 26.042 / 80%);
       --color-adaptive-red-200-800: oklch(44.4% 0.177 26.899);
       --color-adaptive-red-600-a80-400-a80: oklch(70.4% 0.191 22.216 / 80%);
@@ -860,6 +914,8 @@
       --color-adaptive-rose-600-400: oklch(71.2% 0.194 13.428);
       --color-adaptive-rose-700-300: oklch(81% 0.117 11.638);
       --color-adaptive-sky-500-a12-a16: oklch(68.5% 0.169 237.323 / 16%);
+      --color-adaptive-sky-500-a10-400-a10: oklch(74.6% 0.16 232.661 / 10%);
+      --color-adaptive-sky-500-a25-400-a25: oklch(74.6% 0.16 232.661 / 25%);
       --color-adaptive-sky-600-400: oklch(74.6% 0.16 232.661);
       --color-adaptive-sky-700-300: oklch(82.8% 0.111 230.318);
       --color-adaptive-violet-500-a12-a16: oklch(60.6% 0.25 292.717 / 16%);
@@ -940,6 +996,8 @@
       --color-adaptive-amber-50-950-a40: oklch(98.7% 0.022 95.277);
       --color-adaptive-amber-200-900-a60: oklch(92.4% 0.12 95.746);
       --color-adaptive-amber-500-a12-a16: oklch(76.9% 0.188 70.08 / 12%);
+      --color-adaptive-amber-500-a10-400-a10: oklch(76.9% 0.188 70.08 / 10%);
+      --color-adaptive-amber-500-a25-400-a25: oklch(76.9% 0.188 70.08 / 25%);
       --color-adaptive-amber-700-300: oklch(55.5% 0.163 48.998);
       --color-adaptive-amber-700-400: oklch(55.5% 0.163 48.998);
       --color-adaptive-amber-800-200: oklch(47.3% 0.137 46.201);
@@ -950,6 +1008,7 @@
       --color-adaptive-blue-600-400: oklch(54.6% 0.245 262.881);
       --color-adaptive-black-a10-a25: rgb(0 0 0 / 10%);
       --color-adaptive-black-a15-a35: rgb(0 0 0 / 15%);
+      --color-adaptive-black-a2p5-white-a2p5: rgb(0 0 0 / 2.5%);
       --color-adaptive-emerald-500-a12-a16: oklch(69.6% 0.17 162.48 / 12%);
       --color-adaptive-emerald-600-400: oklch(59.6% 0.145 163.225);
       --color-adaptive-emerald-700-300: oklch(50.8% 0.118 165.612);
@@ -973,6 +1032,8 @@
       --color-adaptive-neutral-600-300: oklch(43.9% 0 0);
       --color-adaptive-neutral-600-400: oklch(43.9% 0 0);
       --color-adaptive-neutral-950-50: oklch(14.5% 0 0);
+      --color-adaptive-neutral-950-a5-white-a5: oklch(14.5% 0 0 / 5%);
+      --color-adaptive-neutral-950-a10-white-a10: oklch(14.5% 0 0 / 10%);
       --color-adaptive-red-50-950-a80: oklch(97.1% 0.013 17.38);
       --color-adaptive-red-200-800: oklch(88.5% 0.062 18.334);
       --color-adaptive-red-600-a80-400-a80: oklch(57.7% 0.245 27.325 / 80%);
@@ -985,6 +1046,8 @@
       --color-adaptive-rose-600-400: oklch(58.6% 0.253 17.585);
       --color-adaptive-rose-700-300: oklch(51.4% 0.222 16.935);
       --color-adaptive-sky-500-a12-a16: oklch(68.5% 0.169 237.323 / 12%);
+      --color-adaptive-sky-500-a10-400-a10: oklch(68.5% 0.169 237.323 / 10%);
+      --color-adaptive-sky-500-a25-400-a25: oklch(68.5% 0.169 237.323 / 25%);
       --color-adaptive-sky-600-400: oklch(58.8% 0.158 241.966);
       --color-adaptive-sky-700-300: oklch(50% 0.134 242.749);
       --color-adaptive-violet-500-a12-a16: oklch(60.6% 0.25 292.717 / 12%);
@@ -1065,6 +1128,8 @@
       --color-adaptive-amber-50-950-a40: oklch(27.9% 0.077 45.635 / 40%);
       --color-adaptive-amber-200-900-a60: oklch(41.4% 0.112 45.904 / 60%);
       --color-adaptive-amber-500-a12-a16: oklch(76.9% 0.188 70.08 / 16%);
+      --color-adaptive-amber-500-a10-400-a10: oklch(82.8% 0.189 84.429 / 10%);
+      --color-adaptive-amber-500-a25-400-a25: oklch(82.8% 0.189 84.429 / 25%);
       --color-adaptive-amber-700-300: oklch(87.9% 0.169 91.605);
       --color-adaptive-amber-700-400: oklch(82.8% 0.189 84.429);
       --color-adaptive-amber-800-200: oklch(92.4% 0.12 95.746);
@@ -1075,6 +1140,7 @@
       --color-adaptive-blue-600-400: oklch(70.7% 0.165 254.624);
       --color-adaptive-black-a10-a25: rgb(0 0 0 / 25%);
       --color-adaptive-black-a15-a35: rgb(0 0 0 / 35%);
+      --color-adaptive-black-a2p5-white-a2p5: rgb(255 255 255 / 2.5%);
       --color-adaptive-emerald-500-a12-a16: oklch(69.6% 0.17 162.48 / 16%);
       --color-adaptive-emerald-600-400: oklch(76.5% 0.177 163.223);
       --color-adaptive-emerald-700-300: oklch(84.5% 0.143 164.978);
@@ -1098,6 +1164,8 @@
       --color-adaptive-neutral-600-300: oklch(87% 0 0);
       --color-adaptive-neutral-600-400: oklch(70.8% 0 0);
       --color-adaptive-neutral-950-50: oklch(98.5% 0 0);
+      --color-adaptive-neutral-950-a5-white-a5: rgb(255 255 255 / 5%);
+      --color-adaptive-neutral-950-a10-white-a10: rgb(255 255 255 / 10%);
       --color-adaptive-red-50-950-a80: oklch(25.8% 0.092 26.042 / 80%);
       --color-adaptive-red-200-800: oklch(44.4% 0.177 26.899);
       --color-adaptive-red-600-a80-400-a80: oklch(70.4% 0.191 22.216 / 80%);
@@ -1110,6 +1178,8 @@
       --color-adaptive-rose-600-400: oklch(71.2% 0.194 13.428);
       --color-adaptive-rose-700-300: oklch(81% 0.117 11.638);
       --color-adaptive-sky-500-a12-a16: oklch(68.5% 0.169 237.323 / 16%);
+      --color-adaptive-sky-500-a10-400-a10: oklch(74.6% 0.16 232.661 / 10%);
+      --color-adaptive-sky-500-a25-400-a25: oklch(74.6% 0.16 232.661 / 25%);
       --color-adaptive-sky-600-400: oklch(74.6% 0.16 232.661);
       --color-adaptive-sky-700-300: oklch(82.8% 0.111 230.318);
       --color-adaptive-violet-500-a12-a16: oklch(60.6% 0.25 292.717 / 16%);
@@ -1190,6 +1260,8 @@
       --color-adaptive-amber-50-950-a40: oklch(98.7% 0.022 95.277);
       --color-adaptive-amber-200-900-a60: oklch(92.4% 0.12 95.746);
       --color-adaptive-amber-500-a12-a16: oklch(76.9% 0.188 70.08 / 12%);
+      --color-adaptive-amber-500-a10-400-a10: oklch(76.9% 0.188 70.08 / 10%);
+      --color-adaptive-amber-500-a25-400-a25: oklch(76.9% 0.188 70.08 / 25%);
       --color-adaptive-amber-700-300: oklch(55.5% 0.163 48.998);
       --color-adaptive-amber-700-400: oklch(55.5% 0.163 48.998);
       --color-adaptive-amber-800-200: oklch(47.3% 0.137 46.201);
@@ -1200,6 +1272,7 @@
       --color-adaptive-blue-600-400: oklch(54.6% 0.245 262.881);
       --color-adaptive-black-a10-a25: rgb(0 0 0 / 10%);
       --color-adaptive-black-a15-a35: rgb(0 0 0 / 15%);
+      --color-adaptive-black-a2p5-white-a2p5: rgb(0 0 0 / 2.5%);
       --color-adaptive-emerald-500-a12-a16: oklch(69.6% 0.17 162.48 / 12%);
       --color-adaptive-emerald-600-400: oklch(59.6% 0.145 163.225);
       --color-adaptive-emerald-700-300: oklch(50.8% 0.118 165.612);
@@ -1223,6 +1296,8 @@
       --color-adaptive-neutral-600-300: oklch(43.9% 0 0);
       --color-adaptive-neutral-600-400: oklch(43.9% 0 0);
       --color-adaptive-neutral-950-50: oklch(14.5% 0 0);
+      --color-adaptive-neutral-950-a5-white-a5: oklch(14.5% 0 0 / 5%);
+      --color-adaptive-neutral-950-a10-white-a10: oklch(14.5% 0 0 / 10%);
       --color-adaptive-red-50-950-a80: oklch(97.1% 0.013 17.38);
       --color-adaptive-red-200-800: oklch(88.5% 0.062 18.334);
       --color-adaptive-red-600-a80-400-a80: oklch(57.7% 0.245 27.325 / 80%);
@@ -1235,6 +1310,8 @@
       --color-adaptive-rose-600-400: oklch(58.6% 0.253 17.585);
       --color-adaptive-rose-700-300: oklch(51.4% 0.222 16.935);
       --color-adaptive-sky-500-a12-a16: oklch(68.5% 0.169 237.323 / 12%);
+      --color-adaptive-sky-500-a10-400-a10: oklch(68.5% 0.169 237.323 / 10%);
+      --color-adaptive-sky-500-a25-400-a25: oklch(68.5% 0.169 237.323 / 25%);
       --color-adaptive-sky-600-400: oklch(58.8% 0.158 241.966);
       --color-adaptive-sky-700-300: oklch(50% 0.134 242.749);
       --color-adaptive-violet-500-a12-a16: oklch(60.6% 0.25 292.717 / 12%);
@@ -1315,6 +1392,8 @@
       --color-adaptive-amber-50-950-a40: oklch(27.9% 0.077 45.635 / 40%);
       --color-adaptive-amber-200-900-a60: oklch(41.4% 0.112 45.904 / 60%);
       --color-adaptive-amber-500-a12-a16: oklch(76.9% 0.188 70.08 / 16%);
+      --color-adaptive-amber-500-a10-400-a10: oklch(82.8% 0.189 84.429 / 10%);
+      --color-adaptive-amber-500-a25-400-a25: oklch(82.8% 0.189 84.429 / 25%);
       --color-adaptive-amber-700-300: oklch(87.9% 0.169 91.605);
       --color-adaptive-amber-700-400: oklch(82.8% 0.189 84.429);
       --color-adaptive-amber-800-200: oklch(92.4% 0.12 95.746);
@@ -1325,6 +1404,7 @@
       --color-adaptive-blue-600-400: oklch(70.7% 0.165 254.624);
       --color-adaptive-black-a10-a25: rgb(0 0 0 / 25%);
       --color-adaptive-black-a15-a35: rgb(0 0 0 / 35%);
+      --color-adaptive-black-a2p5-white-a2p5: rgb(255 255 255 / 2.5%);
       --color-adaptive-emerald-500-a12-a16: oklch(69.6% 0.17 162.48 / 16%);
       --color-adaptive-emerald-600-400: oklch(76.5% 0.177 163.223);
       --color-adaptive-emerald-700-300: oklch(84.5% 0.143 164.978);
@@ -1348,6 +1428,8 @@
       --color-adaptive-neutral-600-300: oklch(87% 0 0);
       --color-adaptive-neutral-600-400: oklch(70.8% 0 0);
       --color-adaptive-neutral-950-50: oklch(98.5% 0 0);
+      --color-adaptive-neutral-950-a5-white-a5: rgb(255 255 255 / 5%);
+      --color-adaptive-neutral-950-a10-white-a10: rgb(255 255 255 / 10%);
       --color-adaptive-red-50-950-a80: oklch(25.8% 0.092 26.042 / 80%);
       --color-adaptive-red-200-800: oklch(44.4% 0.177 26.899);
       --color-adaptive-red-600-a80-400-a80: oklch(70.4% 0.191 22.216 / 80%);
@@ -1360,6 +1442,8 @@
       --color-adaptive-rose-600-400: oklch(71.2% 0.194 13.428);
       --color-adaptive-rose-700-300: oklch(81% 0.117 11.638);
       --color-adaptive-sky-500-a12-a16: oklch(68.5% 0.169 237.323 / 16%);
+      --color-adaptive-sky-500-a10-400-a10: oklch(74.6% 0.16 232.661 / 10%);
+      --color-adaptive-sky-500-a25-400-a25: oklch(74.6% 0.16 232.661 / 25%);
       --color-adaptive-sky-600-400: oklch(74.6% 0.16 232.661);
       --color-adaptive-sky-700-300: oklch(82.8% 0.111 230.318);
       --color-adaptive-violet-500-a12-a16: oklch(60.6% 0.25 292.717 / 16%);
diff --git a/apps/mobile/scripts/generate-uniwind-themes.mts b/apps/mobile/scripts/generate-uniwind-themes.mts
index aa3d9b0bfb03..08eb6264ae8f 100644
--- a/apps/mobile/scripts/generate-uniwind-themes.mts
+++ b/apps/mobile/scripts/generate-uniwind-themes.mts
@@ -57,6 +57,8 @@ const ADAPTIVE_COLORS = {
   "--color-adaptive-amber-50-950-a40": [color("amber", 50), color("amber", 950, 0.4)],
   "--color-adaptive-amber-200-900-a60": [color("amber", 200), color("amber", 900, 0.6)],
   "--color-adaptive-amber-500-a12-a16": [color("amber", 500, 0.12), color("amber", 500, 0.16)],
+  "--color-adaptive-amber-500-a10-400-a10": [color("amber", 500, 0.1), color("amber", 400, 0.1)],
+  "--color-adaptive-amber-500-a25-400-a25": [color("amber", 500, 0.25), color("amber", 400, 0.25)],
   "--color-adaptive-amber-700-300": [color("amber", 700), color("amber", 300)],
   "--color-adaptive-amber-700-400": [color("amber", 700), color("amber", 400)],
   "--color-adaptive-amber-800-200": [color("amber", 800), color("amber", 200)],
@@ -73,6 +75,10 @@ const ADAPTIVE_COLORS = {
     color("black", undefined, 0.15),
     color("black", undefined, 0.35),
   ],
+  "--color-adaptive-black-a2p5-white-a2p5": [
+    color("black", undefined, 0.025),
+    color("white", undefined, 0.025),
+  ],
   "--color-adaptive-emerald-500-a12-a16": [
     color("emerald", 500, 0.12),
     color("emerald", 500, 0.16),
@@ -114,6 +120,14 @@ const ADAPTIVE_COLORS = {
   "--color-adaptive-neutral-600-300": [color("neutral", 600), color("neutral", 300)],
   "--color-adaptive-neutral-600-400": [color("neutral", 600), color("neutral", 400)],
   "--color-adaptive-neutral-950-50": [color("neutral", 950), color("neutral", 50)],
+  "--color-adaptive-neutral-950-a5-white-a5": [
+    color("neutral", 950, 0.05),
+    color("white", undefined, 0.05),
+  ],
+  "--color-adaptive-neutral-950-a10-white-a10": [
+    color("neutral", 950, 0.1),
+    color("white", undefined, 0.1),
+  ],
   "--color-adaptive-red-50-950-a80": [color("red", 50), color("red", 950, 0.8)],
   "--color-adaptive-red-200-800": [color("red", 200), color("red", 800)],
   "--color-adaptive-red-600-a80-400-a80": [color("red", 600, 0.8), color("red", 400, 0.8)],
@@ -126,6 +140,8 @@ const ADAPTIVE_COLORS = {
   "--color-adaptive-rose-600-400": [color("rose", 600), color("rose", 400)],
   "--color-adaptive-rose-700-300": [color("rose", 700), color("rose", 300)],
   "--color-adaptive-sky-500-a12-a16": [color("sky", 500, 0.12), color("sky", 500, 0.16)],
+  "--color-adaptive-sky-500-a10-400-a10": [color("sky", 500, 0.1), color("sky", 400, 0.1)],
+  "--color-adaptive-sky-500-a25-400-a25": [color("sky", 500, 0.25), color("sky", 400, 0.25)],
   "--color-adaptive-sky-600-400": [color("sky", 600), color("sky", 400)],
   "--color-adaptive-sky-700-300": [color("sky", 700), color("sky", 300)],
   "--color-adaptive-violet-500-a12-a16": [color("violet", 500, 0.12), color("violet", 500, 0.16)],
diff --git a/apps/mobile/src/components/BrandMark.tsx b/apps/mobile/src/components/BrandMark.tsx
index c8f1d4385517..1643f3f6fdeb 100644
--- a/apps/mobile/src/components/BrandMark.tsx
+++ b/apps/mobile/src/components/BrandMark.tsx
@@ -3,14 +3,9 @@ import { Image } from "expo-image";
 import { View } from "react-native";
 
 import { AppText as Text } from "./AppText";
+import { T3_CODE_BRAND_MARK_SOURCE } from "./brandAssets";
 
 const appVariant = Constants.expoConfig?.extra?.appVariant;
-const BRAND_MARK_SOURCE =
-  appVariant === "development"
-    ? require("../../../../assets/dev/blueprint-ios-1024.png")
-    : appVariant === "preview"
-      ? require("../../../../assets/nightly/nightly-ios-1024.png")
-      : require("../../../../assets/prod/black-ios-1024.png");
 const DEFAULT_STAGE_LABEL =
   appVariant === "development" ? "Dev" : appVariant === "preview" ? "Preview" : "Alpha";
 
@@ -22,7 +17,7 @@ export function BrandMark(props: { readonly compact?: boolean; readonly stageLab
   return (
     <View className="flex-row items-center gap-3">
       <Image
-        source={BRAND_MARK_SOURCE}
+        source={T3_CODE_BRAND_MARK_SOURCE}
         accessibilityIgnoresInvertColors
         style={{
           width: iconSize,
diff --git a/apps/mobile/src/components/brandAssets.ts b/apps/mobile/src/components/brandAssets.ts
new file mode 100644
index 000000000000..dbf7ab552aa8
--- /dev/null
+++ b/apps/mobile/src/components/brandAssets.ts
@@ -0,0 +1,10 @@
+import Constants from "expo-constants";
+
+const appVariant = Constants.expoConfig?.extra?.appVariant;
+
+export const T3_CODE_BRAND_MARK_SOURCE =
+  appVariant === "development"
+    ? require("../../../../assets/dev/blueprint-ios-1024.png")
+    : appVariant === "preview"
+      ? require("../../../../assets/nightly/nightly-ios-1024.png")
+      : require("../../../../assets/prod/black-ios-1024.png");
diff --git a/apps/mobile/src/connection/environment-cache-store.test.ts b/apps/mobile/src/connection/environment-cache-store.test.ts
index ecb706f9720c..8cf7551a6626 100644
--- a/apps/mobile/src/connection/environment-cache-store.test.ts
+++ b/apps/mobile/src/connection/environment-cache-store.test.ts
@@ -1,5 +1,16 @@
-import { EnvironmentId, type VcsListRefsResult } from "@t3tools/contracts";
+import { ORCHESTRATION_CACHE_SCHEMA_VERSION } from "@t3tools/client-runtime/platform";
+import {
+  CommandId,
+  EnvironmentId,
+  ProjectId,
+  ProviderInstanceId,
+  ThreadId,
+  type OrchestrationV2ShellSnapshot,
+  type OrchestrationV2ThreadDetailSnapshot,
+  type VcsListRefsResult,
+} from "@t3tools/contracts";
 import { describe, expect, it } from "@effect/vitest";
+import * as DateTime from "effect/DateTime";
 import * as Effect from "effect/Effect";
 import * as Option from "effect/Option";
 
@@ -7,6 +18,124 @@ import { type ClientCacheKind, MobileDatabase } from "../persistence/mobile-data
 import { make } from "./environment-cache-store";
 
 const ENVIRONMENT_ID = EnvironmentId.make("environment-1");
+const PROJECT_ID = ProjectId.make("project-1");
+const THREAD_ID = ThreadId.make("thread-1");
+const PROVIDER_INSTANCE_ID = ProviderInstanceId.make("codex");
+const NOW = DateTime.makeUnsafe("2026-07-29T12:00:00.000Z");
+const SHELL_SNAPSHOT: OrchestrationV2ShellSnapshot = {
+  schemaVersion: 1,
+  snapshotSequence: 3,
+  projects: [
+    {
+      id: PROJECT_ID,
+      title: "Project",
+      workspaceRoot: "/repo",
+      repositoryIdentity: null,
+      defaultModelSelection: null,
+      scripts: [],
+      createdAt: "2026-07-29T12:00:00.000Z",
+      updatedAt: "2026-07-29T12:00:00.000Z",
+    },
+  ],
+  threads: [
+    {
+      id: THREAD_ID,
+      projectId: PROJECT_ID,
+      title: "Thread",
+      providerInstanceId: PROVIDER_INSTANCE_ID,
+      modelSelection: {
+        instanceId: PROVIDER_INSTANCE_ID,
+        model: "gpt-5.4",
+      },
+      runtimeMode: "full-access",
+      interactionMode: "default",
+      branch: null,
+      worktreePath: null,
+      activeProviderThreadId: null,
+      lineage: {
+        rootThreadId: THREAD_ID,
+        parentThreadId: null,
+        relationshipToParent: null,
+      },
+      forkedFrom: null,
+      createdBy: "user",
+      creationSource: "mobile",
+      latestRunId: null,
+      activeRunId: null,
+      status: "idle",
+      pendingRuntimeRequest: null,
+      latestVisibleMessage: null,
+      latestUserMessageAt: NOW,
+      hasActionableProposedPlan: false,
+      itemCount: 0,
+      visibleItemCount: 0,
+      createdAt: NOW,
+      updatedAt: NOW,
+      archivedAt: null,
+      settledOverride: null,
+      settledAt: NOW,
+      lastVisitedAt: null,
+      titleRegeneration: {
+        requestId: CommandId.make("title-regeneration-1"),
+        startedAt: NOW,
+      },
+      deletedAt: null,
+    },
+  ],
+  archivedThreads: [],
+};
+const THREAD_SNAPSHOT: OrchestrationV2ThreadDetailSnapshot = {
+  snapshotSequence: 4,
+  projection: {
+    thread: {
+      id: THREAD_ID,
+      projectId: PROJECT_ID,
+      title: "Thread",
+      providerInstanceId: PROVIDER_INSTANCE_ID,
+      modelSelection: {
+        instanceId: PROVIDER_INSTANCE_ID,
+        model: "gpt-5.4",
+      },
+      runtimeMode: "full-access",
+      interactionMode: "default",
+      branch: null,
+      worktreePath: null,
+      activeProviderThreadId: null,
+      lineage: {
+        rootThreadId: THREAD_ID,
+        parentThreadId: null,
+        relationshipToParent: null,
+      },
+      forkedFrom: null,
+      createdBy: "user",
+      creationSource: "mobile",
+      createdAt: NOW,
+      updatedAt: NOW,
+      archivedAt: null,
+      settledOverride: null,
+      settledAt: NOW,
+      lastVisitedAt: null,
+      deletedAt: null,
+    },
+    runs: [],
+    attempts: [],
+    nodes: [],
+    subagents: [],
+    providerSessions: [],
+    providerThreads: [],
+    providerTurns: [],
+    runtimeRequests: [],
+    messages: [],
+    plans: [],
+    turnItems: [],
+    checkpointScopes: [],
+    checkpoints: [],
+    contextHandoffs: [],
+    contextTransfers: [],
+    visibleTurnItems: [],
+    updatedAt: NOW,
+  },
+};
 const REFS: VcsListRefsResult = {
   refs: [
     {
@@ -28,13 +157,16 @@ function cacheId(environmentId: EnvironmentId, kind: ClientCacheKind, cacheKey:
 
 function makeDatabase() {
   const values = new Map<string, string>();
+  const schemaVersions = new Map<string, number>();
   const removed: Array<string> = [];
   const database = MobileDatabase.of({
     loadCache: (environmentId, kind, cacheKey) =>
       Effect.succeed(Option.fromUndefinedOr(values.get(cacheId(environmentId, kind, cacheKey)))),
-    saveCache: (environmentId, kind, cacheKey, _schemaVersion, payload) =>
+    saveCache: (environmentId, kind, cacheKey, schemaVersion, payload) =>
       Effect.sync(() => {
-        values.set(cacheId(environmentId, kind, cacheKey), payload);
+        const id = cacheId(environmentId, kind, cacheKey);
+        values.set(id, payload);
+        schemaVersions.set(id, schemaVersion);
       }),
     removeCache: (environmentId, kind, cacheKey) =>
       Effect.sync(() => {
@@ -59,10 +191,40 @@ function makeDatabase() {
     loadPreferencesJson: Effect.succeed(Option.none()),
     savePreferencesJson: () => Effect.void,
   });
-  return { database, removed, values };
+  return { database, removed, schemaVersions, values };
 }
 
 describe("mobile SQLite environment cache store", () => {
+  it.effect("round-trips V2 shell and thread DateTime fields with the shared cache schema", () =>
+    Effect.gen(function* () {
+      const memory = makeDatabase();
+      const store = yield* make().pipe(Effect.provideService(MobileDatabase, memory.database));
+
+      yield* store.saveShell(ENVIRONMENT_ID, SHELL_SNAPSHOT);
+      yield* store.saveThread(ENVIRONMENT_ID, THREAD_SNAPSHOT);
+
+      const shell = Option.getOrThrow(yield* store.loadShell(ENVIRONMENT_ID));
+      const thread = Option.getOrThrow(yield* store.loadThread(ENVIRONMENT_ID, THREAD_ID));
+
+      expect(DateTime.formatIso(shell.threads[0]!.updatedAt)).toBe("2026-07-29T12:00:00.000Z");
+      expect(DateTime.formatIso(shell.threads[0]!.latestUserMessageAt!)).toBe(
+        "2026-07-29T12:00:00.000Z",
+      );
+      expect(DateTime.formatIso(shell.threads[0]!.titleRegeneration!.startedAt)).toBe(
+        "2026-07-29T12:00:00.000Z",
+      );
+      expect(DateTime.formatIso(thread.projection.thread.updatedAt)).toBe(
+        "2026-07-29T12:00:00.000Z",
+      );
+      expect(memory.schemaVersions.get(cacheId(ENVIRONMENT_ID, "shell", "snapshot"))).toBe(
+        ORCHESTRATION_CACHE_SCHEMA_VERSION,
+      );
+      expect(memory.schemaVersions.get(cacheId(ENVIRONMENT_ID, "thread", THREAD_ID))).toBe(
+        ORCHESTRATION_CACHE_SCHEMA_VERSION,
+      );
+    }),
+  );
+
   it.effect("round-trips schema-validated VCS refs", () =>
     Effect.gen(function* () {
       const memory = makeDatabase();
diff --git a/apps/mobile/src/connection/environment-cache-store.ts b/apps/mobile/src/connection/environment-cache-store.ts
index ad5ef13b62d5..1942cb7cc35d 100644
--- a/apps/mobile/src/connection/environment-cache-store.ts
+++ b/apps/mobile/src/connection/environment-cache-store.ts
@@ -1,14 +1,11 @@
 import {
   ConnectionPersistenceError,
   EnvironmentCacheStore,
+  ORCHESTRATION_CACHE_SCHEMA_VERSION,
+  StoredOrchestrationShellSnapshot,
+  StoredOrchestrationThreadSnapshot,
 } from "@t3tools/client-runtime/platform";
-import {
-  type EnvironmentId,
-  OrchestrationShellSnapshot,
-  OrchestrationThreadDetailSnapshot,
-  ServerConfig,
-  VcsListRefsResult,
-} from "@t3tools/contracts";
+import { type EnvironmentId, ServerConfig, VcsListRefsResult } from "@t3tools/contracts";
 import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
 import * as Option from "effect/Option";
@@ -16,25 +13,9 @@ import * as Schema from "effect/Schema";
 
 import * as MobileDatabase from "../persistence/mobile-database";
 
-const SHELL_SNAPSHOT_CACHE_SCHEMA_VERSION = 1;
-// v3 adds windowed (paginated) snapshots carrying `page` metadata; the bump
-// makes pre-pagination clients discard the record instead of decoding a
-// partial thread as complete (rollback safety).
-const THREAD_SNAPSHOT_CACHE_SCHEMA_VERSION = 3;
 const SERVER_CONFIG_CACHE_SCHEMA_VERSION = 1;
 const VCS_REFS_CACHE_SCHEMA_VERSION = 1;
 
-const StoredShellSnapshot = Schema.Struct({
-  schemaVersion: Schema.Literal(SHELL_SNAPSHOT_CACHE_SCHEMA_VERSION),
-  environmentId: Schema.String,
-  snapshot: OrchestrationShellSnapshot,
-});
-const StoredThreadSnapshot = Schema.Struct({
-  schemaVersion: Schema.Literal(THREAD_SNAPSHOT_CACHE_SCHEMA_VERSION),
-  environmentId: Schema.String,
-  threadId: Schema.String,
-  snapshot: OrchestrationThreadDetailSnapshot,
-});
 const StoredServerConfig = Schema.Struct({
   schemaVersion: Schema.Literal(SERVER_CONFIG_CACHE_SCHEMA_VERSION),
   environmentId: Schema.String,
@@ -48,13 +29,17 @@ const StoredVcsRefs = Schema.Struct({
 });
 
 const decodeStoredShellSnapshot = Schema.decodeUnknownEffect(
-  Schema.fromJsonString(StoredShellSnapshot),
+  Schema.fromJsonString(StoredOrchestrationShellSnapshot),
+);
+const encodeStoredShellSnapshot = Schema.encodeEffect(
+  Schema.fromJsonString(StoredOrchestrationShellSnapshot),
 );
-const encodeStoredShellSnapshot = Schema.encodeEffect(Schema.fromJsonString(StoredShellSnapshot));
 const decodeStoredThreadSnapshot = Schema.decodeUnknownEffect(
-  Schema.fromJsonString(StoredThreadSnapshot),
+  Schema.fromJsonString(StoredOrchestrationThreadSnapshot),
+);
+const encodeStoredThreadSnapshot = Schema.encodeEffect(
+  Schema.fromJsonString(StoredOrchestrationThreadSnapshot),
 );
-const encodeStoredThreadSnapshot = Schema.encodeEffect(Schema.fromJsonString(StoredThreadSnapshot));
 const decodeStoredServerConfig = Schema.decodeUnknownEffect(
   Schema.fromJsonString(StoredServerConfig),
 );
@@ -130,12 +115,12 @@ export const make = Effect.fn("MobileEnvironmentCacheStore.make")(function* () {
     ),
     saveShell: Effect.fn("MobileEnvironmentCache.saveShell")(function* (environmentId, snapshot) {
       const payload = yield* encodeStoredShellSnapshot({
-        schemaVersion: SHELL_SNAPSHOT_CACHE_SCHEMA_VERSION,
+        schemaVersion: ORCHESTRATION_CACHE_SCHEMA_VERSION,
         environmentId,
         snapshot,
       }).pipe(Effect.mapError((cause) => persistenceError("save-shell", cause)));
       yield* database
-        .saveCache(environmentId, "shell", "snapshot", SHELL_SNAPSHOT_CACHE_SCHEMA_VERSION, payload)
+        .saveCache(environmentId, "shell", "snapshot", ORCHESTRATION_CACHE_SCHEMA_VERSION, payload)
         .pipe(Effect.mapError(mapDatabaseError("save-shell")));
     }),
     loadThread: Effect.fn("MobileEnvironmentCache.loadThread")((environmentId, threadId) =>
@@ -153,15 +138,15 @@ export const make = Effect.fn("MobileEnvironmentCacheStore.make")(function* () {
       }),
     ),
     saveThread: Effect.fn("MobileEnvironmentCache.saveThread")(function* (environmentId, snapshot) {
-      const threadId = snapshot.thread.id;
+      const threadId = snapshot.projection.thread.id;
       const payload = yield* encodeStoredThreadSnapshot({
-        schemaVersion: THREAD_SNAPSHOT_CACHE_SCHEMA_VERSION,
+        schemaVersion: ORCHESTRATION_CACHE_SCHEMA_VERSION,
         environmentId,
         threadId,
         snapshot,
       }).pipe(Effect.mapError((cause) => persistenceError("save-thread", cause)));
       yield* database
-        .saveCache(environmentId, "thread", threadId, THREAD_SNAPSHOT_CACHE_SCHEMA_VERSION, payload)
+        .saveCache(environmentId, "thread", threadId, ORCHESTRATION_CACHE_SCHEMA_VERSION, payload)
         .pipe(Effect.mapError(mapDatabaseError("save-thread")));
     }),
     removeThread: Effect.fn("MobileEnvironmentCache.removeThread")((environmentId, threadId) =>
diff --git a/apps/mobile/src/connection/runtime.ts b/apps/mobile/src/connection/runtime.ts
index ee224ce9f6ed..47bb5c365a8e 100644
--- a/apps/mobile/src/connection/runtime.ts
+++ b/apps/mobile/src/connection/runtime.ts
@@ -1,6 +1,9 @@
 import { Connection } from "@t3tools/client-runtime/connection";
 import { shellSnapshotLoaderLayer } from "@t3tools/client-runtime/state/shell";
-import { threadSnapshotLoaderLayer } from "@t3tools/client-runtime/state/threads";
+import {
+  boundedThreadSnapshotLoaderLayer,
+  threadHistoryControllerLayer,
+} from "@t3tools/client-runtime/state/threads";
 import * as Layer from "effect/Layer";
 import { Atom } from "effect/unstable/reactivity";
 
@@ -20,7 +23,11 @@ const providedConnectionPlatformLayer = connectionPlatformLayer.pipe(
   Layer.provide(runtimeContextLayer),
 );
 
-const snapshotLoaderLayer = Layer.merge(threadSnapshotLoaderLayer, shellSnapshotLoaderLayer);
+const snapshotLoaderLayer = Layer.mergeAll(
+  boundedThreadSnapshotLoaderLayer,
+  shellSnapshotLoaderLayer,
+  threadHistoryControllerLayer,
+);
 
 type ConnectionLayerSource =
   | typeof Connection.layer
diff --git a/apps/mobile/src/connection/storage.ts b/apps/mobile/src/connection/storage.ts
index e844181673df..b043a3b414bd 100644
--- a/apps/mobile/src/connection/storage.ts
+++ b/apps/mobile/src/connection/storage.ts
@@ -17,6 +17,7 @@ import * as Context from "effect/Context";
 import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
 import * as Option from "effect/Option";
+
 import * as CatalogStore from "./catalog-store";
 
 function targetPersistenceError(
diff --git a/apps/mobile/src/features/archive/archivedThreadList.test.ts b/apps/mobile/src/features/archive/archivedThreadList.test.ts
index 697d13e7c472..77e45963b831 100644
--- a/apps/mobile/src/features/archive/archivedThreadList.test.ts
+++ b/apps/mobile/src/features/archive/archivedThreadList.test.ts
@@ -1,9 +1,11 @@
 import type { ArchivedSnapshotEntry } from "@t3tools/client-runtime/state/threads";
-import type { OrchestrationProjectShell, OrchestrationThreadShell } from "@t3tools/contracts";
-import { EnvironmentId, ProjectId, ProviderInstanceId, ThreadId } from "@t3tools/contracts";
+import type { OrchestrationProjectShell, OrchestrationV2ThreadShell } from "@t3tools/contracts";
+import { EnvironmentId, ProjectId, ThreadId } from "@t3tools/contracts";
 import { describe, expect, it } from "vite-plus/test";
+import * as DateTime from "effect/DateTime";
 
 import { buildArchivedThreadGroups } from "./archivedThreadList";
+import { makeRawThreadShell } from "../../test-fixtures";
 
 const environmentId = EnvironmentId.make("environment-1");
 
@@ -22,42 +24,30 @@ function makeProject(
 }
 
 function makeThread(
-  input: Partial<OrchestrationThreadShell> &
-    Pick<OrchestrationThreadShell, "id" | "projectId" | "title">,
-): OrchestrationThreadShell {
-  return {
-    modelSelection: { instanceId: ProviderInstanceId.make("codex"), model: "gpt-5.4" },
-    runtimeMode: "full-access",
-    interactionMode: "default",
-    branch: null,
-    worktreePath: null,
-    latestTurn: null,
-    createdAt: "2026-06-01T00:00:00.000Z",
-    updatedAt: "2026-06-01T00:00:00.000Z",
-    archivedAt: "2026-06-02T00:00:00.000Z",
-    session: null,
-    latestUserMessageAt: null,
-    hasPendingApprovals: false,
-    hasPendingUserInput: false,
-    hasActionableProposedPlan: false,
+  input: Pick<OrchestrationV2ThreadShell, "id" | "projectId" | "title"> & {
+    readonly branch?: string | null;
+    readonly archivedAt?: string | null;
+  },
+): OrchestrationV2ThreadShell {
+  const archivedAt = input.archivedAt === undefined ? "2026-06-02T00:00:00.000Z" : input.archivedAt;
+  return makeRawThreadShell({
     ...input,
-    settledOverride: input.settledOverride ?? null,
-    settledAt: input.settledAt ?? null,
-  };
+    archivedAt: archivedAt === null ? null : DateTime.makeUnsafe(archivedAt),
+  });
 }
 
 function makeSnapshot(
   projects: ReadonlyArray<OrchestrationProjectShell>,
-  threads: ReadonlyArray<OrchestrationThreadShell>,
+  threads: ReadonlyArray<OrchestrationV2ThreadShell>,
   targetEnvironmentId = environmentId,
 ): ArchivedSnapshotEntry {
   return {
     environmentId: targetEnvironmentId,
     snapshot: {
+      schemaVersion: 1,
       snapshotSequence: 1,
       projects,
       threads,
-      updatedAt: "2026-06-04T00:00:00.000Z",
     },
   };
 }
diff --git a/apps/mobile/src/features/home/HomeScreen.tsx b/apps/mobile/src/features/home/HomeScreen.tsx
index b738ff6dd12f..f4f045ecf8ed 100644
--- a/apps/mobile/src/features/home/HomeScreen.tsx
+++ b/apps/mobile/src/features/home/HomeScreen.tsx
@@ -192,7 +192,7 @@ function deriveEmptyState(props: {
 
   return {
     title: "No threads yet",
-    detail: "Create a task to start a new coding session in one of your connected projects.",
+    detail: "Create a task to start a new coding runtime in one of your connected projects.",
     loading: false,
   };
 }
@@ -828,7 +828,7 @@ export function HomeScreen(props: HomeScreenProps) {
               ?.providers.find(
                 (provider) =>
                   provider.instanceId ===
-                  (thread.session?.providerInstanceId ?? thread.modelSelection.instanceId),
+                  (thread.runtime?.providerInstanceId ?? thread.modelSelection.instanceId),
               )?.driver ?? null
           }
           environmentLabel={
@@ -1116,7 +1116,7 @@ export function HomeScreen(props: HomeScreenProps) {
         detail="Choose another environment or create a new task."
       />
     ) : (
-      <EmptyState title="No threads yet" detail="Create a task to start a new coding session." />
+      <EmptyState title="No threads yet" detail="Create a task to start a new coding runtime." />
     )
   ) : null;
   // Self-contained: v1's listEmpty keys off projectGroups, which ignores the
diff --git a/apps/mobile/src/features/home/homeListItems.test.ts b/apps/mobile/src/features/home/homeListItems.test.ts
index c5a9f2c6bbcb..89727851a921 100644
--- a/apps/mobile/src/features/home/homeListItems.test.ts
+++ b/apps/mobile/src/features/home/homeListItems.test.ts
@@ -1,8 +1,10 @@
-import type {
-  EnvironmentProject,
-  EnvironmentThreadShell,
+import {
+  presentThreadShell,
+  type EnvironmentProject,
+  type EnvironmentThreadShell,
 } from "@t3tools/client-runtime/state/shell";
 import { EnvironmentId, ProjectId, ProviderInstanceId, ThreadId } from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
 import { describe, expect, it } from "vite-plus/test";
 
 import {
@@ -32,29 +34,41 @@ function makeProject(id: string, title: string): EnvironmentProject {
   };
 }
 
+const threadTimestamp = DateTime.makeUnsafe("2026-06-01T00:00:00.000Z");
+
 function makeThread(id: string, projectId: ProjectId): EnvironmentThreadShell {
-  return {
-    environmentId,
-    id: ThreadId.make(id),
+  const threadId = ThreadId.make(id);
+  return presentThreadShell(environmentId, {
+    id: threadId,
     projectId,
     title: `Thread ${id}`,
+    providerInstanceId: ProviderInstanceId.make("codex"),
     modelSelection: { instanceId: ProviderInstanceId.make("codex"), model: "gpt-5.4" },
     runtimeMode: "full-access",
     interactionMode: "default",
     branch: null,
     worktreePath: null,
-    latestTurn: null,
-    createdAt: "2026-06-01T00:00:00.000Z",
-    updatedAt: "2026-06-01T00:00:00.000Z",
-    archivedAt: null,
+    activeProviderThreadId: null,
+    lineage: { rootThreadId: threadId, parentThreadId: null, relationshipToParent: null },
+    forkedFrom: null,
+    createdBy: "user",
+    creationSource: "mobile",
+    latestRunId: null,
+    activeRunId: null,
+    status: "idle",
+    pendingRuntimeRequest: null,
+    latestVisibleMessage: null,
     settledOverride: null,
     settledAt: null,
-    session: null,
     latestUserMessageAt: null,
-    hasPendingApprovals: false,
-    hasPendingUserInput: false,
     hasActionableProposedPlan: false,
-  };
+    itemCount: 0,
+    visibleItemCount: 0,
+    createdAt: threadTimestamp,
+    updatedAt: threadTimestamp,
+    archivedAt: null,
+    deletedAt: null,
+  });
 }
 
 function makeGroup(key: string, threadCount: number): HomeThreadGroup {
diff --git a/apps/mobile/src/features/home/homeThreadList.test.ts b/apps/mobile/src/features/home/homeThreadList.test.ts
index 60d3ab2c867a..6ed8f01982ed 100644
--- a/apps/mobile/src/features/home/homeThreadList.test.ts
+++ b/apps/mobile/src/features/home/homeThreadList.test.ts
@@ -11,6 +11,7 @@ import {
   buildHomeThreadGroups,
   sortHomeProjectScopes,
 } from "./homeThreadList";
+import { makeThreadShellFixture } from "../../test-fixtures";
 
 function makeProject(
   input: Partial<EnvironmentProject> & Pick<EnvironmentProject, "environmentId" | "id" | "title">,
@@ -30,25 +31,21 @@ function makeThread(
   input: Partial<EnvironmentThreadShell> &
     Pick<EnvironmentThreadShell, "environmentId" | "id" | "projectId" | "title">,
 ): EnvironmentThreadShell {
-  return {
+  return makeThreadShellFixture({
     modelSelection: { instanceId: ProviderInstanceId.make("codex"), model: "gpt-5.4" },
     runtimeMode: "full-access",
     interactionMode: "default",
     branch: null,
     worktreePath: null,
-    latestTurn: null,
     createdAt: "2026-06-01T00:00:00.000Z",
     updatedAt: "2026-06-01T00:00:00.000Z",
     archivedAt: null,
-    session: null,
     latestUserMessageAt: null,
     hasPendingApprovals: false,
     hasPendingUserInput: false,
     hasActionableProposedPlan: false,
     ...input,
-    settledOverride: input.settledOverride ?? null,
-    settledAt: input.settledAt ?? null,
-  };
+  });
 }
 
 const NOW = Date.parse("2026-06-29T00:00:00.000Z");
diff --git a/apps/mobile/src/features/home/threadArchive.test.ts b/apps/mobile/src/features/home/threadArchive.test.ts
new file mode 100644
index 000000000000..5f1320b76240
--- /dev/null
+++ b/apps/mobile/src/features/home/threadArchive.test.ts
@@ -0,0 +1,40 @@
+import { ProviderInstanceId, RunId } from "@t3tools/contracts";
+import { describe, expect, it } from "vite-plus/test";
+
+import type { ThreadRuntimeSummary } from "@t3tools/client-runtime/state/models";
+import { threadCanArchive } from "./threadArchive";
+
+function runtime(
+  status: ThreadRuntimeSummary["status"],
+  activeRunId: ThreadRuntimeSummary["activeRunId"],
+): ThreadRuntimeSummary {
+  return {
+    status,
+    activeRunId,
+    providerInstanceId: ProviderInstanceId.make("codex"),
+    providerName: "codex",
+    lastError: null,
+    updatedAt: "2026-07-28T10:00:00.000Z",
+  };
+}
+
+describe("threadCanArchive", () => {
+  it("blocks provider-active work", () => {
+    const activeRunId = RunId.make("run-live");
+    expect(threadCanArchive(runtime("preparing", activeRunId))).toBe(false);
+    expect(threadCanArchive(runtime("starting", activeRunId))).toBe(false);
+    expect(threadCanArchive(runtime("running", activeRunId))).toBe(false);
+  });
+
+  it("only allows queued work when no provider run remains active", () => {
+    const activeRunId = RunId.make("run-live");
+    expect(threadCanArchive(runtime("queued", null))).toBe(true);
+    expect(threadCanArchive(runtime("queued", activeRunId))).toBe(false);
+  });
+
+  it("allows post-provider waiting work despite a retained active run id", () => {
+    const staleActiveRunId = RunId.make("run-finished");
+    expect(threadCanArchive(runtime("waiting", null))).toBe(true);
+    expect(threadCanArchive(runtime("waiting", staleActiveRunId))).toBe(true);
+  });
+});
diff --git a/apps/mobile/src/features/home/threadArchive.ts b/apps/mobile/src/features/home/threadArchive.ts
new file mode 100644
index 000000000000..8eaf9fa541d5
--- /dev/null
+++ b/apps/mobile/src/features/home/threadArchive.ts
@@ -0,0 +1,16 @@
+import type { ThreadRuntimeSummary } from "@t3tools/client-runtime/state/models";
+
+/**
+ * Archiving may discard queued work, but it must not detach a provider while
+ * that provider is still executing a turn.
+ */
+export function threadCanArchive(runtime: ThreadRuntimeSummary | null | undefined): boolean {
+  if (runtime?.status === "queued") {
+    return runtime.activeRunId === null;
+  }
+  return (
+    runtime?.status !== "preparing" &&
+    runtime?.status !== "starting" &&
+    runtime?.status !== "running"
+  );
+}
diff --git a/apps/mobile/src/features/home/useThreadListActions.ts b/apps/mobile/src/features/home/useThreadListActions.ts
index 5c66944042ad..6ec496d52a44 100644
--- a/apps/mobile/src/features/home/useThreadListActions.ts
+++ b/apps/mobile/src/features/home/useThreadListActions.ts
@@ -17,6 +17,7 @@ import { appAtomRegistry } from "../../state/atom-registry";
 import { environmentServerConfigsAtom } from "../../state/server";
 import { environmentThreadShells, threadEnvironment } from "../../state/threads";
 import { useAtomCommand } from "../../state/use-atom-command";
+import { threadCanArchive } from "./threadArchive";
 
 /** Version skew: never send settle/unsettle to a server that predates them
     (capability defaults false on decode for older servers). */
@@ -128,13 +129,9 @@ function useThreadActionExecutor(
           );
           return false;
         }
-        // Archive keeps its original, narrower guard: never interrupt a
-        // thread mid-turn.
-        if (
-          action === "archive" &&
-          thread.session?.status === "running" &&
-          thread.session.activeTurnId != null
-        ) {
+        // The server cancels queued runs on archive. Only an actual provider
+        // turn still needs the user to interrupt it first.
+        if (action === "archive" && !threadCanArchive(thread.runtime)) {
           Alert.alert(
             actionFailureTitle(action),
             "This thread is working. Interrupt it first, then try again.",
diff --git a/apps/mobile/src/features/keyboard/hardwareKeyboardCommands.ts b/apps/mobile/src/features/keyboard/hardwareKeyboardCommands.ts
index 300434eb736a..28a8d6c72309 100644
--- a/apps/mobile/src/features/keyboard/hardwareKeyboardCommands.ts
+++ b/apps/mobile/src/features/keyboard/hardwareKeyboardCommands.ts
@@ -55,7 +55,10 @@ export function subscribeToHardwareKeyboardCommandRegistrations(listener: () =>
 export function dispatchHardwareKeyboardCommand(command: HardwareKeyboardCommand): boolean {
   const commandHandlers = handlers.get(command);
   if (!commandHandlers) return false;
-  for (const handler of [...commandHandlers].toReversed()) {
+  const handlersInRegistrationOrder = Array.from(commandHandlers);
+  for (let index = handlersInRegistrationOrder.length - 1; index >= 0; index -= 1) {
+    const handler = handlersInRegistrationOrder[index];
+    if (!handler) continue;
     if (handler() !== false) return true;
   }
   return false;
diff --git a/apps/mobile/src/features/projects/AddProjectScreen.tsx b/apps/mobile/src/features/projects/AddProjectScreen.tsx
index a82f6937378e..5f6a38273e8f 100644
--- a/apps/mobile/src/features/projects/AddProjectScreen.tsx
+++ b/apps/mobile/src/features/projects/AddProjectScreen.tsx
@@ -605,7 +605,6 @@ function useCreateProject(environment: EnvironmentOption | null) {
         commandId: CommandId.make(uuidv4()),
         projectId,
         workspaceRoot,
-        createdAt: new Date().toISOString(),
       });
       const result = await createProject({
         environmentId: environment.environmentId,
diff --git a/apps/mobile/src/features/review/reviewModel.test.ts b/apps/mobile/src/features/review/reviewModel.test.ts
index 3390afd9ff27..770a6561360b 100644
--- a/apps/mobile/src/features/review/reviewModel.test.ts
+++ b/apps/mobile/src/features/review/reviewModel.test.ts
@@ -1,11 +1,7 @@
 import { describe, expect, it } from "vite-plus/test";
 
-import {
-  MessageId,
-  TurnId,
-  type OrchestrationCheckpointSummary,
-  type ReviewDiffPreviewSource,
-} from "@t3tools/contracts";
+import { MessageId, RunId, type ReviewDiffPreviewSource } from "@t3tools/contracts";
+import type { ThreadCheckpointSummary } from "@t3tools/client-runtime/state/thread-checkpoints";
 
 import {
   buildReviewListItems,
@@ -18,9 +14,9 @@ import {
 } from "./reviewModel";
 
 function makeCheckpoint(
-  input: Partial<OrchestrationCheckpointSummary> &
-    Pick<OrchestrationCheckpointSummary, "turnId" | "checkpointTurnCount" | "completedAt">,
-): OrchestrationCheckpointSummary {
+  input: Partial<ThreadCheckpointSummary> &
+    Pick<ThreadCheckpointSummary, "runId" | "checkpointTurnCount" | "completedAt">,
+): ThreadCheckpointSummary {
   return {
     checkpointRef: `refs/t3/checkpoints/thread/${input.checkpointTurnCount}` as any,
     status: "ready",
@@ -52,12 +48,12 @@ describe("buildReviewSectionItems", () => {
   it("keeps one chip per checkpoint and appends git sources", () => {
     const checkpoints = [
       makeCheckpoint({
-        turnId: TurnId.make("turn-1"),
+        runId: RunId.make("run-1"),
         checkpointTurnCount: 1,
         completedAt: "2026-04-01T00:00:00.000Z",
       }),
       makeCheckpoint({
-        turnId: TurnId.make("turn-2"),
+        runId: RunId.make("run-2"),
         checkpointTurnCount: 2,
         completedAt: "2026-04-02T00:00:00.000Z",
       }),
diff --git a/apps/mobile/src/features/review/reviewModel.ts b/apps/mobile/src/features/review/reviewModel.ts
index 9459d41872d1..5e1ae6bac5a2 100644
--- a/apps/mobile/src/features/review/reviewModel.ts
+++ b/apps/mobile/src/features/review/reviewModel.ts
@@ -1,6 +1,7 @@
 import { parsePatchFiles } from "@pierre/diffs/utils/parsePatchFiles";
 import type { ChangeTypes, FileDiffMetadata } from "@pierre/diffs/types";
-import type { OrchestrationCheckpointSummary, ReviewDiffPreviewSource } from "@t3tools/contracts";
+import type { ThreadCheckpointSummary } from "@t3tools/client-runtime/state/thread-checkpoints";
+import type { ReviewDiffPreviewSource } from "@t3tools/contracts";
 import * as Arr from "effect/Array";
 import { pipe } from "effect/Function";
 import * as Order from "effect/Order";
@@ -128,11 +129,11 @@ export type ReviewParsedDiff =
       readonly notice: string | null;
     };
 
-function checkpointTitle(checkpoint: OrchestrationCheckpointSummary): string {
+function checkpointTitle(checkpoint: ThreadCheckpointSummary): string {
   return `Turn ${checkpoint.checkpointTurnCount}`;
 }
 
-function checkpointSubtitle(checkpoint: OrchestrationCheckpointSummary): string {
+function checkpointSubtitle(checkpoint: ThreadCheckpointSummary): string {
   const fileCount = checkpoint.files.length;
   if (checkpoint.status !== "ready") {
     return `Diff ${checkpoint.status}`;
@@ -141,8 +142,8 @@ function checkpointSubtitle(checkpoint: OrchestrationCheckpointSummary): string
 }
 
 function compareCheckpointTurnCountDescending(
-  left: OrchestrationCheckpointSummary,
-  right: OrchestrationCheckpointSummary,
+  left: ThreadCheckpointSummary,
+  right: ThreadCheckpointSummary,
 ): -1 | 0 | 1 {
   if (left.checkpointTurnCount === right.checkpointTurnCount) {
     return 0;
@@ -151,7 +152,7 @@ function compareCheckpointTurnCountDescending(
   return left.checkpointTurnCount > right.checkpointTurnCount ? -1 : 1;
 }
 
-const readyCheckpointOrder = Order.make<OrchestrationCheckpointSummary>(
+const readyCheckpointOrder = Order.make<ThreadCheckpointSummary>(
   compareCheckpointTurnCountDescending,
 );
 
@@ -510,14 +511,14 @@ function mapRenderableFile(file: FileDiffMetadata): ReviewRenderableFile {
 }
 
 export function getReviewSectionIdForCheckpoint(
-  checkpoint: Pick<OrchestrationCheckpointSummary, "checkpointTurnCount">,
+  checkpoint: Pick<ThreadCheckpointSummary, "checkpointTurnCount">,
 ): string {
   return `turn:${checkpoint.checkpointTurnCount}`;
 }
 
 export function getReadyReviewCheckpoints(
-  checkpoints: ReadonlyArray<OrchestrationCheckpointSummary>,
-): ReadonlyArray<OrchestrationCheckpointSummary> {
+  checkpoints: ReadonlyArray<ThreadCheckpointSummary>,
+): ReadonlyArray<ThreadCheckpointSummary> {
   return pipe(
     checkpoints,
     Arr.filter((checkpoint) => checkpoint.status === "ready"),
@@ -526,7 +527,7 @@ export function getReadyReviewCheckpoints(
 }
 
 export function buildReviewSectionItems(input: {
-  readonly checkpoints: ReadonlyArray<OrchestrationCheckpointSummary>;
+  readonly checkpoints: ReadonlyArray<ThreadCheckpointSummary>;
   readonly gitSections: ReadonlyArray<ReviewDiffPreviewSource>;
   readonly turnDiffById: Readonly<Record<string, string | undefined>>;
   readonly loadingTurnIds: Readonly<Record<string, boolean | undefined>>;
diff --git a/apps/mobile/src/features/review/useReviewSections.ts b/apps/mobile/src/features/review/useReviewSections.ts
index 87325490990c..b8a002801975 100644
--- a/apps/mobile/src/features/review/useReviewSections.ts
+++ b/apps/mobile/src/features/review/useReviewSections.ts
@@ -1,11 +1,15 @@
 import { useCallback, useEffect, useMemo } from "react";
 
-import type { EnvironmentId, OrchestrationCheckpointSummary, ThreadId } from "@t3tools/contracts";
+import {
+  deriveThreadCheckpointSummaries,
+  type ThreadCheckpointSummary,
+} from "@t3tools/client-runtime/state/thread-checkpoints";
+import type { EnvironmentId, ThreadId } from "@t3tools/contracts";
 
 import { useCheckpointDiff } from "../../state/queries";
 import { useEnvironmentQuery } from "../../state/query";
 import { reviewEnvironment } from "../../state/review";
-import { useSelectedThreadDetail } from "../../state/use-thread-detail";
+import { useSelectedThreadProjection } from "../../state/use-thread-detail";
 import { useSelectedThreadWorktree } from "../../state/use-selected-thread-worktree";
 import {
   buildReviewSectionItems,
@@ -30,7 +34,7 @@ export function useReviewSections(input: {
 }) {
   const { environmentId, reviewCache, threadId } = input;
   const enabled = input.enabled ?? true;
-  const selectedThread = useSelectedThreadDetail();
+  const selectedThread = useSelectedThreadProjection();
   const { selectedThreadCwd } = useSelectedThreadWorktree();
   const diffPreview = useEnvironmentQuery(
     enabled && environmentId !== undefined && selectedThreadCwd !== null
@@ -49,8 +53,11 @@ export function useReviewSections(input: {
   }, [diffPreview.data, reviewCache.threadKey]);
 
   const readyCheckpoints = useMemo(
-    () => getReadyReviewCheckpoints(selectedThread?.checkpoints ?? []),
-    [selectedThread?.checkpoints],
+    () =>
+      getReadyReviewCheckpoints(
+        selectedThread === null ? [] : deriveThreadCheckpointSummaries(selectedThread.projection),
+      ),
+    [selectedThread],
   );
   const checkpointBySectionId = useMemo(
     () =>
@@ -59,7 +66,7 @@ export function useReviewSections(input: {
           getReviewSectionIdForCheckpoint(checkpoint),
           checkpoint,
         ]),
-      ) as Record<string, OrchestrationCheckpointSummary>,
+      ) as Record<string, ThreadCheckpointSummary>,
     [readyCheckpoints],
   );
   const reviewSections = useMemo(
diff --git a/apps/mobile/src/features/terminal/ThreadTerminalRouteScreen.tsx b/apps/mobile/src/features/terminal/ThreadTerminalRouteScreen.tsx
index f370401e8ecc..546f6b5165d5 100644
--- a/apps/mobile/src/features/terminal/ThreadTerminalRouteScreen.tsx
+++ b/apps/mobile/src/features/terminal/ThreadTerminalRouteScreen.tsx
@@ -40,7 +40,7 @@ import {
   useKnownTerminalSessions,
 } from "../../state/use-terminal-session";
 import { useThreadSelection } from "../../state/use-thread-selection";
-import { useSelectedThreadDetail } from "../../state/use-thread-detail";
+import { useSelectedThreadProjection } from "../../state/use-thread-detail";
 import { EnvironmentConnectionNotice } from "../connection/EnvironmentConnectionNotice";
 import { useAdaptiveWorkspaceLayout } from "../layout/AdaptiveWorkspaceLayout";
 import { TerminalSurface } from "./NativeTerminalSurface";
@@ -171,7 +171,9 @@ export function ThreadTerminalRouteScreen(props: ThreadTerminalRouteScreenProps)
   const params = props.route.params;
   const { selectedThread, selectedThreadProject, selectedEnvironmentConnection } =
     useThreadSelection();
-  const selectedThreadDetail = useSelectedThreadDetail();
+  const selectedThreadDetail = useSelectedThreadProjection();
+  const selectedThreadDetailWorktreePath =
+    selectedThreadDetail?.projection.thread.worktreePath ?? null;
   const routeEnvironmentIdRaw = firstRouteParam(params.environmentId);
   const routeThreadIdRaw = firstRouteParam(params.threadId);
   const routeEnvironmentId = routeEnvironmentIdRaw
@@ -284,13 +286,13 @@ export function ThreadTerminalRouteScreen(props: ThreadTerminalRouteScreenProps)
       activeSessionLocation: activeKnownSession?.state.summary ?? null,
       workspaceRoot: selectedThreadProject.workspaceRoot,
       threadShellWorktreePath: selectedThread.worktreePath ?? null,
-      threadDetailWorktreePath: selectedThreadDetail?.worktreePath ?? null,
+      threadDetailWorktreePath: selectedThreadDetailWorktreePath,
     });
   }, [
     activeKnownSession?.state.summary,
     pendingLaunch,
     selectedThread,
-    selectedThreadDetail?.worktreePath,
+    selectedThreadDetailWorktreePath,
     selectedThreadProject?.workspaceRoot,
   ]);
   const [initialLaunchLocationEntry, setInitialLaunchLocationEntry] = useState(() => ({
diff --git a/apps/mobile/src/features/threads/NewTaskDraftScreen.tsx b/apps/mobile/src/features/threads/NewTaskDraftScreen.tsx
index 5dbb1ed835a0..d3786e27b759 100644
--- a/apps/mobile/src/features/threads/NewTaskDraftScreen.tsx
+++ b/apps/mobile/src/features/threads/NewTaskDraftScreen.tsx
@@ -20,6 +20,7 @@ import {
   isAtomCommandInterrupted,
   squashAtomCommandFailure,
 } from "@t3tools/client-runtime/state/runtime";
+import { deriveThreadTitleSeed } from "@t3tools/client-runtime/operations";
 
 import { ComposerEditor, type ComposerEditorHandle } from "../../components/ComposerEditor";
 import {
@@ -52,7 +53,7 @@ import {
   type ComposerDraft,
 } from "../../state/use-composer-drafts";
 import { useEnvironmentServerConfig, useProjects } from "../../state/entities";
-import { resolveSelectableModelSelection } from "../../lib/modelOptions";
+import { buildModelMenuActions, resolveSelectableModelSelection } from "../../lib/modelOptions";
 import { deriveThreadTitleFromPrompt } from "../../lib/projectThreadStartTurn";
 import { armAgentAwarenessLiveActivityForLocalWork } from "../agent-awareness/remoteRegistration";
 import { enqueueThreadOutboxMessage, removeThreadOutboxMessage } from "../../state/thread-outbox";
@@ -745,7 +746,10 @@ export function NewTaskDraftScreen(props: {
     // finds no work and ends the card within seconds.
     armAgentAwarenessLiveActivityForLocalWork({
       environmentId: selectedProject.environmentId,
-      threadTitle: deriveThreadTitleFromPrompt(initialMessageText),
+      threadTitle: deriveThreadTitleSeed({
+        text: initialMessageText,
+        attachments: draft.attachments,
+      }),
       projectTitle: selectedProject.title,
     });
     const creationBranch = resolveProjectThreadCreationBranch({
diff --git a/apps/mobile/src/features/threads/PendingApprovalCard.tsx b/apps/mobile/src/features/threads/PendingApprovalCard.tsx
index 0239cac1e041..d708dbb13b09 100644
--- a/apps/mobile/src/features/threads/PendingApprovalCard.tsx
+++ b/apps/mobile/src/features/threads/PendingApprovalCard.tsx
@@ -1,7 +1,7 @@
 import type {
-  ApprovalRequestId,
   ProviderApprovalDecision,
   ProviderApprovalOption,
+  RuntimeRequestId,
 } from "@t3tools/contracts";
 import { Pressable, View } from "react-native";
 
@@ -10,9 +10,9 @@ import type { PendingApproval } from "../../lib/threadActivity";
 
 export interface PendingApprovalCardProps {
   readonly approval: PendingApproval;
-  readonly respondingApprovalId: ApprovalRequestId | null;
+  readonly respondingApprovalId: RuntimeRequestId | null;
   readonly onRespond: (
-    requestId: ApprovalRequestId,
+    requestId: RuntimeRequestId,
     decision: ProviderApprovalDecision,
   ) => Promise<unknown>;
 }
@@ -27,6 +27,8 @@ export function PendingApprovalCard(props: PendingApprovalCardProps) {
   const options = props.approval.options ?? DEFAULT_APPROVAL_OPTIONS;
   // Opaque for the same reason as PendingUserInputCard: nothing blurs the feed
   // behind this card, so a translucent surface bleeds messages through it.
+  const canRespond = props.approval.responseCapability === "live";
+  const disabled = !canRespond || props.respondingApprovalId === props.approval.requestId;
   return (
     <View className="gap-2.5 rounded-[20px] border border-adaptive-neutral-200-white-a6 bg-adaptive-neutral-100-900 p-4">
       <Text className="font-t3-bold text-2xs uppercase tracking-[1.1px] text-adaptive-sky-700-300">
@@ -40,6 +42,12 @@ export function PendingApprovalCard(props: PendingApprovalCardProps) {
           {props.approval.detail}
         </Text>
       ) : null}
+      {!canRespond ? (
+        <Text className="font-sans text-sm leading-5 text-adaptive-neutral-600-400">
+          The provider process for this request is no longer available. Interrupt or restart the run
+          to continue.
+        </Text>
+      ) : null}
       <View className="flex-row flex-wrap gap-2.5">
         {options.map((option) => (
           <Pressable
diff --git a/apps/mobile/src/features/threads/PendingUserInputCard.tsx b/apps/mobile/src/features/threads/PendingUserInputCard.tsx
index 5700d1b79e44..ad405ab36a82 100644
--- a/apps/mobile/src/features/threads/PendingUserInputCard.tsx
+++ b/apps/mobile/src/features/threads/PendingUserInputCard.tsx
@@ -1,4 +1,5 @@
-import type { ApprovalRequestId, UserInputQuestion } from "@t3tools/contracts";
+import type { RuntimeRequestId } from "@t3tools/contracts";
+import type { ThreadUserInputQuestion } from "@t3tools/client-runtime/state/thread-requests";
 import { useCallback, useRef } from "react";
 import { Platform, Pressable, ScrollView, View, type LayoutChangeEvent } from "react-native";
 import Animated, {
@@ -54,14 +55,14 @@ export interface PendingUserInputCardProps {
   readonly onInputFocusChange?: (focused: boolean) => void;
   readonly drafts: Record<string, PendingUserInputDraftAnswer>;
   readonly answers: Record<string, string | ReadonlyArray<string>> | null;
-  readonly respondingUserInputId: ApprovalRequestId | null;
+  readonly respondingUserInputId: RuntimeRequestId | null;
   readonly onSelectOption: (
-    requestId: ApprovalRequestId,
-    question: UserInputQuestion,
+    requestId: RuntimeRequestId,
+    question: ThreadUserInputQuestion,
     label: string,
   ) => void;
   readonly onChangeCustomAnswer: (
-    requestId: ApprovalRequestId,
+    requestId: RuntimeRequestId,
     questionId: string,
     customAnswer: string,
   ) => void;
@@ -87,6 +88,9 @@ const CARD_LAYOUT_TRANSITION = LinearTransition.duration(200);
 
 export function PendingUserInputCard(props: PendingUserInputCardProps) {
   const questionCount = props.pendingUserInput.questions.length;
+  // V2 runtime requests carry response capability: a dead provider process
+  // cannot accept answers, so the card reads-only until the run restarts.
+  const canRespond = props.pendingUserInput.responseCapability === "live";
 
   const cardCoverage = props.cardCoverage;
   const barHeightRef = useRef(0);
@@ -255,6 +259,12 @@ export function PendingUserInputCard(props: PendingUserInputCardProps) {
         showsVerticalScrollIndicator
         style={{ flexShrink: 1 }}
       >
+        {!canRespond ? (
+          <Text className="font-sans text-sm leading-5 text-adaptive-neutral-600-400">
+            The provider process for this request is no longer available. Interrupt or restart the
+            run to continue.
+          </Text>
+        ) : null}
         {props.pendingUserInput.questions.map((question) => {
           const draft = props.drafts[question.id];
           return (
@@ -273,6 +283,7 @@ export function PendingUserInputCard(props: PendingUserInputCardProps) {
                   return (
                     <Pressable
                       key={option.label}
+                      disabled={!canRespond}
                       className={cn(
                         "min-h-12 w-full rounded-2xl border px-3.5 py-3",
                         selected
@@ -309,6 +320,7 @@ export function PendingUserInputCard(props: PendingUserInputCardProps) {
                 })}
               </View>
               <TextInput
+                editable={canRespond}
                 value={draft?.customAnswer ?? ""}
                 onChangeText={(value) =>
                   props.onChangeCustomAnswer(props.pendingUserInput.requestId, question.id, value)
@@ -328,7 +340,9 @@ export function PendingUserInputCard(props: PendingUserInputCardProps) {
           props.answers ? "bg-blue-500" : "bg-adaptive-neutral-200-700-a60",
         )}
         disabled={
-          props.answers === null || props.respondingUserInputId === props.pendingUserInput.requestId
+          !canRespond ||
+          props.answers === null ||
+          props.respondingUserInputId === props.pendingUserInput.requestId
         }
         onPress={() => void props.onSubmit()}
       >
diff --git a/apps/mobile/src/features/threads/ThreadActivityInspector.tsx b/apps/mobile/src/features/threads/ThreadActivityInspector.tsx
new file mode 100644
index 000000000000..642e26a495f8
--- /dev/null
+++ b/apps/mobile/src/features/threads/ThreadActivityInspector.tsx
@@ -0,0 +1,203 @@
+import * as Haptics from "expo-haptics";
+import { SymbolView } from "expo-symbols";
+import type { EnvironmentId, ThreadId } from "@t3tools/contracts";
+import { useNavigation } from "@react-navigation/native";
+import { useMemo, useState } from "react";
+import { Linking, Pressable, ScrollView, type ColorValue, View } from "react-native";
+
+import { AppText as Text } from "../../components/AppText";
+import type { ThreadFeedActivity } from "../../lib/threadActivity";
+import { buildThreadActivityInspector } from "../../lib/threadActivityInspector";
+import { resolveWorkspaceRelativeFilePath } from "../files/filePath";
+import { threadEnvironment } from "../../state/threads";
+import { useAtomCommand } from "../../state/use-atom-command";
+import { useV2ItemSupport } from "../../state/v2-item-support";
+import { buildThreadActivityFileParams } from "./threadActivityFileNavigation";
+
+export function ThreadActivityInspector(props: {
+  readonly activity: ThreadFeedActivity;
+  readonly currentThreadId: ThreadId;
+  readonly environmentId: EnvironmentId;
+  readonly iconColor: ColorValue;
+  readonly workspaceRoot?: string | null;
+}) {
+  const navigation = useNavigation();
+  const row = props.activity.projectedItem;
+  const support = useV2ItemSupport({
+    environmentId: props.environmentId,
+    sourceThreadId: row.sourceThreadId,
+    sourceItemId: row.sourceItemId,
+  });
+  const model = useMemo(
+    () => buildThreadActivityInspector(props.activity, support, props.currentThreadId),
+    [props.activity, props.currentThreadId, support],
+  );
+  const revertCheckpoint = useAtomCommand(threadEnvironment.revertCheckpoint, {
+    label: "checkpoint rollback",
+    reportFailure: true,
+  });
+  const [rollingBack, setRollingBack] = useState(false);
+
+  return (
+    <View className="gap-3">
+      <View className="flex-row flex-wrap gap-x-4 gap-y-2 rounded-lg border border-adaptive-neutral-300-a60-white-a12 bg-adaptive-black-a2p5-white-a2p5 p-2.5">
+        {model.fields.map((field) => (
+          <View key={`${field.label}:${field.value}`} className="min-w-[42%] flex-1 gap-0.5">
+            <Text className="font-t3-medium text-3xs uppercase tracking-wide text-foreground-muted opacity-60">
+              {field.label}
+            </Text>
+            <Text selectable className="text-2xs leading-4 text-foreground">
+              {field.value}
+            </Text>
+          </View>
+        ))}
+      </View>
+
+      {model.blocks.map((block) => (
+        <View key={`${block.label}:${block.value}`} className="gap-1">
+          <Text className="font-t3-medium text-3xs uppercase tracking-wide text-foreground-muted opacity-60">
+            {block.label}
+          </Text>
+          <ScrollView
+            nestedScrollEnabled
+            directionalLockEnabled
+            showsVerticalScrollIndicator
+            style={{ maxHeight: 240 }}
+            contentContainerStyle={{ paddingRight: 8 }}
+          >
+            <Text
+              selectable
+              className="text-2xs leading-[17px] text-foreground-muted"
+              style={block.monospaced ? { fontFamily: "ui-monospace" } : undefined}
+            >
+              {block.value}
+            </Text>
+          </ScrollView>
+        </View>
+      ))}
+
+      {model.fileLinks.length > 0 ? (
+        <View className="gap-1">
+          <Text className="font-t3-medium text-3xs uppercase tracking-wide text-foreground-muted opacity-60">
+            Files
+          </Text>
+          {model.fileLinks.map((link) => {
+            const relativePath =
+              resolveWorkspaceRelativeFilePath(props.workspaceRoot, link.path) ??
+              (link.path.startsWith("/") ? null : link.path);
+            return (
+              <Pressable
+                key={`${link.path}:${link.line ?? 0}:${link.label}`}
+                accessibilityRole={relativePath ? "link" : undefined}
+                disabled={relativePath === null}
+                onPress={() => {
+                  if (!relativePath) return;
+                  void Haptics.selectionAsync();
+                  navigation.navigate(
+                    "ThreadFile",
+                    buildThreadActivityFileParams({
+                      environmentId: props.environmentId,
+                      currentThreadId: props.currentThreadId,
+                      activitySourceThreadId: row.sourceThreadId,
+                      relativePath,
+                      line: link.line,
+                    }),
+                  );
+                }}
+                className="min-h-9 flex-row items-center gap-2 rounded-md border border-adaptive-neutral-300-a60-white-a12 px-2.5 py-1.5"
+              >
+                <SymbolView
+                  name="doc.text"
+                  size={13}
+                  tintColor={props.iconColor}
+                  type="monochrome"
+                />
+                <Text className="min-w-0 flex-1 text-2xs leading-4 text-foreground">
+                  {link.label}
+                </Text>
+              </Pressable>
+            );
+          })}
+        </View>
+      ) : null}
+
+      {model.webLinks.length > 0 ? (
+        <View className="gap-1">
+          <Text className="font-t3-medium text-3xs uppercase tracking-wide text-foreground-muted opacity-60">
+            Sources
+          </Text>
+          {model.webLinks.map((link) => (
+            <Pressable
+              key={link.url}
+              accessibilityRole="link"
+              onPress={() => void Linking.openURL(link.url)}
+              className="min-h-9 flex-row items-center gap-2 rounded-md border border-adaptive-neutral-300-a60-white-a12 px-2.5 py-1.5"
+            >
+              <SymbolView
+                name="arrow.up.right.square"
+                size={13}
+                tintColor={props.iconColor}
+                type="monochrome"
+              />
+              <Text className="min-w-0 flex-1 text-2xs leading-4 text-foreground">
+                {link.label}
+              </Text>
+            </Pressable>
+          ))}
+        </View>
+      ) : null}
+
+      {model.rollbackTarget ? (
+        <Pressable
+          accessibilityRole="button"
+          accessibilityLabel="Roll back to this checkpoint"
+          disabled={rollingBack}
+          onPress={() => {
+            setRollingBack(true);
+            void Haptics.selectionAsync();
+            void revertCheckpoint({
+              environmentId: props.environmentId,
+              input: {
+                threadId: model.rollbackTarget!.threadId,
+                checkpointId: model.rollbackTarget!.checkpointId,
+                scopeId: model.rollbackTarget!.scopeId,
+              },
+            }).finally(() => setRollingBack(false));
+          }}
+          className="min-h-10 flex-row items-center justify-center gap-2 rounded-lg border border-adaptive-neutral-300-a60-white-a12 px-3 py-2"
+        >
+          <SymbolView
+            name={rollingBack ? "hourglass" : "arrow.counterclockwise"}
+            size={14}
+            tintColor={props.iconColor}
+            type="monochrome"
+          />
+          <Text className="font-t3-medium text-xs text-foreground">
+            {rollingBack ? "Rolling back…" : "Roll back to checkpoint"}
+          </Text>
+        </Pressable>
+      ) : null}
+
+      <View className="gap-1 border-t border-adaptive-neutral-300-a60-white-a12 pt-2">
+        <Text className="font-t3-medium text-3xs uppercase tracking-wide text-foreground-muted opacity-60">
+          Structured details
+        </Text>
+        <ScrollView
+          nestedScrollEnabled
+          directionalLockEnabled
+          showsVerticalScrollIndicator
+          style={{ maxHeight: 280 }}
+          contentContainerStyle={{ paddingRight: 8 }}
+        >
+          <Text
+            selectable
+            className="text-2xs leading-[17px] text-foreground-muted"
+            style={{ fontFamily: "ui-monospace" }}
+          >
+            {model.structuredDetails}
+          </Text>
+        </ScrollView>
+      </View>
+    </View>
+  );
+}
diff --git a/apps/mobile/src/features/threads/ThreadComposer.tsx b/apps/mobile/src/features/threads/ThreadComposer.tsx
index 2339994e9f5e..c8338960f8bf 100644
--- a/apps/mobile/src/features/threads/ThreadComposer.tsx
+++ b/apps/mobile/src/features/threads/ThreadComposer.tsx
@@ -1,8 +1,9 @@
+import { isLiquidGlassSupported, LiquidGlassView } from "@callstack/liquid-glass";
+import type { EnvironmentThreadShell } from "@t3tools/client-runtime/state/shell";
 import type {
   EnvironmentId,
   MessageId,
   ModelSelection,
-  OrchestrationThreadShell,
   ProviderInteractionMode,
   RuntimeMode,
   ServerConfig as T3ServerConfig,
@@ -78,9 +79,11 @@ export interface ThreadComposerProps {
    * are on screen while they reconcile with the server.
    */
   readonly threadSyncPhase?: "loading" | "syncing" | null;
-  readonly selectedThread: OrchestrationThreadShell;
+  readonly selectedThread: EnvironmentThreadShell;
   readonly serverConfig: T3ServerConfig | null;
   readonly queueCount: number;
+  readonly activeThreadBusy: boolean;
+  readonly canStopThread: boolean;
   readonly environmentId: EnvironmentId;
   readonly projectCwd: string | null;
   readonly editorRef?: RefObject<ComposerEditorHandle | null>;
@@ -286,9 +289,7 @@ export const ThreadComposer = memo(function ThreadComposer(props: ThreadComposer
     setIsFocused(false);
     onEditorFocusChange?.(false);
   }, [onEditorFocusChange]);
-  const showStopAction =
-    props.selectedThread.session?.status === "running" ||
-    props.selectedThread.session?.status === "starting";
+  const showStopAction = props.canStopThread;
 
   const sendLabel =
     props.connectionState !== "connected" || props.queueCount > 0 ? "Queue" : "Send";
diff --git a/apps/mobile/src/features/threads/ThreadDetailScreen.tsx b/apps/mobile/src/features/threads/ThreadDetailScreen.tsx
index 2c6860199722..887e45df9ad2 100644
--- a/apps/mobile/src/features/threads/ThreadDetailScreen.tsx
+++ b/apps/mobile/src/features/threads/ThreadDetailScreen.tsx
@@ -1,21 +1,21 @@
 import { type EnvironmentConnectionPhase } from "@t3tools/client-runtime/connection";
+import type { EnvironmentThreadShell } from "@t3tools/client-runtime/state/shell";
 import type { EnvironmentThreadStatus } from "@t3tools/client-runtime/state/threads";
 import { useKeyboardChatComposerInset, useKeyboardScrollToEnd } from "@legendapp/list/keyboard";
 import type { LegendListRef } from "@legendapp/list/react-native";
 import { HeaderHeightContext } from "@react-navigation/elements";
 import type {
-  ApprovalRequestId,
   EnvironmentId,
   MessageId,
   ModelSelection,
-  OrchestrationThreadShell,
   ProviderApprovalDecision,
   ProviderInteractionMode,
   RuntimeMode,
+  RuntimeRequestId,
   ServerConfig as T3ServerConfig,
   ThreadId,
-  UserInputQuestion,
 } from "@t3tools/contracts";
+import type { ThreadUserInputQuestion } from "@t3tools/client-runtime/state/thread-requests";
 import * as Haptics from "expo-haptics";
 import {
   memo,
@@ -57,13 +57,15 @@ import type { ComposerEditorHandle } from "../../components/ComposerEditor";
 import type { StatusTone } from "../../components/StatusPill";
 import type { DraftComposerImageAttachment } from "../../lib/composerImages";
 import { CHAT_CONTENT_MAX_WIDTH, type LayoutVariant } from "../../lib/layout";
-import { IOS_NAV_BAR_HEIGHT } from "../../lib/layoutMetrics";
 import { scopedThreadKey } from "../../lib/scopedEntities";
+import { threadEnvironment } from "../../state/threads";
+import { useAtomCommand } from "../../state/use-atom-command";
 import type {
   PendingApproval,
   PendingUserInput,
   PendingUserInputDraftAnswer,
   ThreadFeedEntry,
+  ThreadFeedLatestRun,
 } from "../../lib/threadActivity";
 import { PendingApprovalCard } from "./PendingApprovalCard";
 import { PendingUserInputCard } from "./PendingUserInputCard";
@@ -77,31 +79,35 @@ import {
   COMPOSER_EXPANDED_CHROME,
   ThreadComposer,
 } from "./ThreadComposer";
-import { ThreadFeed } from "./ThreadFeed";
+import { ThreadFeed, type ThreadFeedHistoryControls } from "./ThreadFeed";
+import { ThreadRelationshipsBanner } from "./ThreadRelationshipsBanner";
+import { ThreadQueueControl } from "./ThreadQueueControl";
 import type { ThreadContentPresentation } from "./threadContentPresentation";
-import { resolveThreadFeedSubmissionAnchor } from "./thread-feed-live-follow";
 
 export interface ThreadDetailScreenProps {
-  readonly selectedThread: OrchestrationThreadShell;
+  readonly selectedThread: EnvironmentThreadShell;
   readonly contentPresentation: ThreadContentPresentation;
   readonly screenTone: StatusTone;
   readonly connectionError: string | null;
   readonly environmentLabel: string | null;
   readonly selectedThreadFeed: ReadonlyArray<ThreadFeedEntry>;
+  readonly activityRun: ThreadFeedLatestRun | null;
   readonly activeWorkStartedAt: string | null;
   readonly activePendingApproval: PendingApproval | null;
-  readonly respondingApprovalId: ApprovalRequestId | null;
+  readonly respondingApprovalId: RuntimeRequestId | null;
   readonly activePendingUserInput: PendingUserInput | null;
   readonly activePendingUserInputDrafts: Record<string, PendingUserInputDraftAnswer>;
   readonly activePendingUserInputAnswers: Record<string, string | ReadonlyArray<string>> | null;
-  readonly respondingUserInputId: ApprovalRequestId | null;
+  readonly respondingUserInputId: RuntimeRequestId | null;
   readonly draftMessage: string;
   readonly draftAttachments: ReadonlyArray<DraftComposerImageAttachment>;
   readonly connectionStateLabel: EnvironmentConnectionPhase;
   /** Message sync status for the selected thread (drives the composer status pill). */
   readonly threadSyncStatus?: EnvironmentThreadStatus;
-  /** Non-null when older turns exist beyond the loaded window. */
-  readonly loadEarlier?: { readonly loading: boolean; readonly onLoadEarlier: () => void } | null;
+  /** Progressive history controls for oversized mobile thread opens. */
+  readonly historyControls?: ThreadFeedHistoryControls;
+  readonly activeThreadBusy: boolean;
+  readonly canStopThread: boolean;
   readonly environmentId: EnvironmentId;
   readonly projectWorkspaceRoot: string | null;
   readonly threadCwd: string | null;
@@ -122,16 +128,16 @@ export interface ThreadDetailScreenProps {
   readonly onUpdateThreadRuntimeMode: (runtimeMode: RuntimeMode) => void;
   readonly onUpdateThreadInteractionMode: (interactionMode: ProviderInteractionMode) => void;
   readonly onRespondToApproval: (
-    requestId: ApprovalRequestId,
+    requestId: RuntimeRequestId,
     decision: ProviderApprovalDecision,
   ) => Promise<unknown>;
   readonly onSelectUserInputOption: (
-    requestId: ApprovalRequestId,
-    question: UserInputQuestion,
+    requestId: RuntimeRequestId,
+    question: ThreadUserInputQuestion,
     label: string,
   ) => void;
   readonly onChangeUserInputCustomAnswer: (
-    requestId: ApprovalRequestId,
+    requestId: RuntimeRequestId,
     questionId: string,
     customAnswer: string,
   ) => void;
@@ -250,7 +256,7 @@ export const ThreadDetailScreen = memo(function ThreadDetailScreen(props: Thread
     }
   }, []);
   const windowHeight = useWindowDimensions().height;
-  const navigationHeaderHeight = useContext(HeaderHeightContext) || insets.top + IOS_NAV_BAR_HEIGHT;
+  const navigationHeaderHeight = useContext(HeaderHeightContext) || insets.top + 44;
   const agentLabel = `${props.selectedThread.modelSelection.instanceId} agent`;
   const selectedThreadKey = scopedThreadKey(props.environmentId, props.selectedThread.id);
   const composerEditorRef = useRef<ComposerEditorHandle>(null);
@@ -258,10 +264,9 @@ export const ThreadDetailScreen = memo(function ThreadDetailScreen(props: Thread
   const listRef = useRef<LegendListRef>(null);
   const feedTouchStartRef = useRef<{ pageX: number; pageY: number } | null>(null);
   const selectedThreadKeyRef = useRef(selectedThreadKey);
-  const lastScrolledSubmittedMessageIdRef = useRef<MessageId | null>(null);
+  const lastScrolledAnchorMessageIdRef = useRef<MessageId | null>(null);
   const [composerExpanded, setComposerExpanded] = useState(false);
   const [anchorMessageId, setAnchorMessageId] = useState<MessageId | null>(null);
-  const [submittedMessageId, setSubmittedMessageId] = useState<MessageId | null>(null);
   const [endFollowEnabled, setEndFollowEnabled] = useState(true);
   // Android keys the safe-area padding on keyboard visibility (#5988): the
   // back gesture closes the keyboard while the editor stays focused, and a
@@ -300,7 +305,7 @@ export const ThreadDetailScreen = memo(function ThreadDetailScreen(props: Thread
   // keyboard animations coherent. Collapse state is keyed by request id so a
   // new request re-expands automatically.
   const [collapsedUserInputRequestId, setCollapsedUserInputRequestId] =
-    useState<ApprovalRequestId | null>(null);
+    useState<RuntimeRequestId | null>(null);
   const activeUserInputRequestId = props.activePendingUserInput?.requestId ?? null;
   const userInputCollapsed =
     activeUserInputRequestId !== null && collapsedUserInputRequestId === activeUserInputRequestId;
@@ -458,22 +463,52 @@ export const ThreadDetailScreen = memo(function ThreadDetailScreen(props: Thread
     selectedThreadKeyRef.current = selectedThreadKey;
   }, [selectedThreadKey]);
 
+  const visitThread = useAtomCommand(threadEnvironment.visit, { reportFailure: false });
+  const lastDispatchedVisitRef = useRef<string | null>(null);
+  const selectedThreadId = props.selectedThread.id;
+  const selectedThreadUpdatedAt = props.selectedThread.updatedAt;
+  const selectedThreadLastVisitedAt = props.selectedThread.lastVisitedAt;
+  useEffect(() => {
+    // Records the server-side visited watermark while the thread is on
+    // screen (mirror of web ChatView), so the "Done" marker clears on every
+    // device. Field absent → the server predates visited tracking.
+    if (selectedThreadLastVisitedAt === undefined) return;
+    const threadUpdatedAtMs = Date.parse(selectedThreadUpdatedAt);
+    if (Number.isNaN(threadUpdatedAtMs)) return;
+    const lastVisitedAtMs = selectedThreadLastVisitedAt
+      ? Date.parse(selectedThreadLastVisitedAt)
+      : NaN;
+    if (!Number.isNaN(lastVisitedAtMs) && lastVisitedAtMs >= threadUpdatedAtMs) return;
+    // Dedupe per watermark — the effect re-runs before the command echo lands.
+    const dispatchKey = `${selectedThreadKey}:${selectedThreadUpdatedAt}`;
+    if (lastDispatchedVisitRef.current === dispatchKey) return;
+    lastDispatchedVisitRef.current = dispatchKey;
+    void visitThread({
+      environmentId: props.environmentId,
+      input: { threadId: selectedThreadId, visitedAt: selectedThreadUpdatedAt },
+    });
+  }, [
+    props.environmentId,
+    selectedThreadId,
+    selectedThreadKey,
+    selectedThreadLastVisitedAt,
+    selectedThreadUpdatedAt,
+    visitThread,
+  ]);
+
   useEffect(() => {
     setAnchorMessageId(null);
-    setSubmittedMessageId(null);
-    lastScrolledSubmittedMessageIdRef.current = null;
+    lastScrolledAnchorMessageIdRef.current = null;
     setEndFollowEnabled(true);
     freeze.set(false);
   }, [freeze, selectedThreadKey]);
 
   useEffect(() => {
     if (
-      submittedMessageId === null ||
-      lastScrolledSubmittedMessageIdRef.current === submittedMessageId ||
+      anchorMessageId === null ||
+      lastScrolledAnchorMessageIdRef.current === anchorMessageId ||
       contentPresentationKind !== "ready" ||
-      !selectedThreadFeed.some(
-        (entry) => entry.type === "message" && entry.id === submittedMessageId,
-      )
+      !selectedThreadFeed.some((entry) => entry.type === "message" && entry.id === anchorMessageId)
     ) {
       return;
     }
@@ -483,7 +518,7 @@ export const ThreadDetailScreen = memo(function ThreadDetailScreen(props: Thread
       if (selectedThreadKeyRef.current !== targetThreadKey) {
         return;
       }
-      lastScrolledSubmittedMessageIdRef.current = submittedMessageId;
+      lastScrolledAnchorMessageIdRef.current = anchorMessageId;
       // Wait for the keyboard dismissal (started by blur() on send) to finish
       // before scrolling: scrollMessageToEnd freezes keyboard-driven inset
       // updates while it runs, and a close event swallowed by that freeze
@@ -493,7 +528,7 @@ export const ThreadDetailScreen = memo(function ThreadDetailScreen(props: Thread
         .then(() => {
           if (
             selectedThreadKeyRef.current !== targetThreadKey ||
-            lastScrolledSubmittedMessageIdRef.current !== submittedMessageId
+            lastScrolledAnchorMessageIdRef.current !== anchorMessageId
           ) {
             return;
           }
@@ -502,17 +537,17 @@ export const ThreadDetailScreen = memo(function ThreadDetailScreen(props: Thread
         .catch(() => {
           if (
             selectedThreadKeyRef.current !== targetThreadKey ||
-            lastScrolledSubmittedMessageIdRef.current !== submittedMessageId
+            lastScrolledAnchorMessageIdRef.current !== anchorMessageId
           ) {
             return;
           }
-          lastScrolledSubmittedMessageIdRef.current = null;
+          lastScrolledAnchorMessageIdRef.current = null;
           freeze.set(false);
         });
     });
     return () => cancelAnimationFrame(frame);
   }, [
-    submittedMessageId,
+    anchorMessageId,
     freeze,
     contentPresentationKind,
     selectedThreadFeed,
@@ -522,34 +557,15 @@ export const ThreadDetailScreen = memo(function ThreadDetailScreen(props: Thread
 
   const handleSendMessage = useCallback(async () => {
     const targetThreadKey = selectedThreadKey;
-    const hasUserMessage = selectedThreadFeed.some(
-      (entry) => entry.type === "message" && entry.message.role === "user",
-    );
     const messageId = await props.onSendMessage();
     if (messageId === null || selectedThreadKeyRef.current !== targetThreadKey) {
       return messageId;
     }
 
-    setSubmittedMessageId(messageId);
-    setAnchorMessageId(
-      resolveThreadFeedSubmissionAnchor({
-        currentAnchorMessageId: anchorMessageId,
-        submittedMessageId: messageId,
-        hasStartedTurn: props.selectedThread.latestTurn !== null,
-        hasUserMessage,
-        queuedMessageCount: props.selectedThreadQueueCount,
-      }),
-    );
+    setAnchorMessageId(messageId);
     composerEditorRef.current?.blur();
     return messageId;
-  }, [
-    anchorMessageId,
-    props.onSendMessage,
-    props.selectedThread.latestTurn,
-    props.selectedThreadQueueCount,
-    selectedThreadFeed,
-    selectedThreadKey,
-  ]);
+  }, [props.onSendMessage, selectedThreadKey]);
 
   const collapseComposer = useCallback(() => {
     composerEditorRef.current?.blur();
@@ -614,22 +630,28 @@ export const ThreadDetailScreen = memo(function ThreadDetailScreen(props: Thread
             feed={props.selectedThreadFeed}
             contentPresentation={props.contentPresentation}
             agentLabel={agentLabel}
-            latestTurn={props.selectedThread.latestTurn}
+            threadTitle={props.selectedThread.title}
+            latestRun={props.activityRun}
             activeWorkStartedAt={props.activeWorkStartedAt}
             listRef={listRef}
             freeze={freeze}
             anchorMessageId={anchorMessageId}
-            submittedMessageId={submittedMessageId}
             contentInsetEndAdjustment={combinedContentInsetEndAdjustment}
             contentTopInset={0}
             contentBottomInset={estimatedOverlayHeight}
             contentMaxWidth={contentMaxWidth}
+            historyControls={props.historyControls}
+            topAccessory={
+              <ThreadRelationshipsBanner
+                environmentId={props.environmentId}
+                threadId={props.selectedThread.id}
+              />
+            }
             layoutVariant={layoutVariant}
             usesAutomaticContentInsets={props.usesAutomaticContentInsets}
             onHeaderMaterialVisibilityChange={props.onHeaderMaterialVisibilityChange}
             onEndFollowEnabledChange={setEndFollowEnabled}
             skills={selectedProviderSkills}
-            loadEarlier={props.loadEarlier ?? null}
           />
         </View>
       ) : (
@@ -694,6 +716,11 @@ export const ThreadDetailScreen = memo(function ThreadDetailScreen(props: Thread
               </Animated.View>
             ) : null}
             <View className="w-full self-center" style={{ maxWidth: contentMaxWidth }}>
+              <ThreadQueueControl
+                environmentId={props.environmentId}
+                threadId={props.selectedThread.id}
+              />
+
               {props.activePendingApproval || props.activePendingUserInput ? (
                 <Animated.View
                   className="shrink-0 gap-3 px-4 pb-3"
@@ -752,6 +779,8 @@ export const ThreadDetailScreen = memo(function ThreadDetailScreen(props: Thread
                 selectedThread={props.selectedThread}
                 serverConfig={props.serverConfig}
                 queueCount={props.selectedThreadQueueCount}
+                activeThreadBusy={props.activeThreadBusy}
+                canStopThread={props.canStopThread}
                 environmentId={props.environmentId}
                 projectCwd={props.projectWorkspaceRoot}
                 bottomInset={composerBottomInset}
diff --git a/apps/mobile/src/features/threads/ThreadFeed.tsx b/apps/mobile/src/features/threads/ThreadFeed.tsx
index 23bee49455e9..aaed5e041cc1 100644
--- a/apps/mobile/src/features/threads/ThreadFeed.tsx
+++ b/apps/mobile/src/features/threads/ThreadFeed.tsx
@@ -1,8 +1,15 @@
 import * as Haptics from "expo-haptics";
 import { KeyboardAwareLegendList } from "@legendapp/list/keyboard";
 import { type LegendListRef } from "@legendapp/list/react-native";
-import type { EnvironmentId, MessageId, ThreadId, TurnId } from "@t3tools/contracts";
-import { classifyMarkdownImageSource } from "@t3tools/client-runtime/markdown-images";
+import { scopeThreadRef } from "@t3tools/client-runtime/environment";
+import { canForkProjectedAssistantItem } from "@t3tools/client-runtime/state/thread-workflows";
+import {
+  ThreadId,
+  type EnvironmentId,
+  type MessageId,
+  type OrchestrationV2ProjectedTurnItem,
+  type RunId,
+} from "@t3tools/contracts";
 import { CHAT_LIST_ANCHOR_OFFSET, resolveChatListAnchoredEndSpace } from "@t3tools/shared/chatList";
 import { formatElapsed } from "@t3tools/shared/orchestrationTiming";
 import { SymbolView } from "../../components/AppSymbol";
@@ -28,6 +35,7 @@ import {
 } from "react-native-nitro-markdown";
 import {
   ActivityIndicator,
+  Alert,
   Image,
   Platform,
   type LayoutChangeEvent,
@@ -56,7 +64,6 @@ import { hasWideMarkdownBlock } from "../../lib/wideMarkdownBlocks";
 import {
   hasNativeSelectableMarkdownText,
   SelectableMarkdownText,
-  type MarkdownImageRenderer,
   type NativeMarkdownTextStyle,
   type SelectableMarkdownSkill,
 } from "../../native/SelectableMarkdownText";
@@ -76,41 +83,39 @@ import {
 } from "../review/nativeReviewDiffAdapter";
 import { buildReviewParsedDiff } from "../review/reviewModel";
 import { cn } from "../../lib/cn";
-import {
-  deriveCenteredContentHorizontalPadding,
-  deriveThreadFeedInitialContentInset,
-  type LayoutVariant,
-} from "../../lib/layout";
+import { deriveCenteredContentHorizontalPadding, type LayoutVariant } from "../../lib/layout";
+import { uuidv4 } from "../../lib/uuid";
 import {
   resolveMarkdownFontSizes,
   resolveNativeMarkdownTypography,
-  scaledTypographyLineHeight,
 } from "../../lib/appearancePreferences";
-import { MOBILE_TYPOGRAPHY } from "../../lib/typography";
 import { useAppearancePreferences } from "../settings/appearance/AppearancePreferencesProvider";
 import { useAppearanceCodeSurface } from "../settings/appearance/useAppearanceCodeSurface";
 import { markdownFileIconSource } from "@t3tools/mobile-markdown-text/file-icons";
 import { resolveMarkdownLinkPresentation } from "@t3tools/mobile-markdown-text/links";
 import {
   deriveThreadFeedPresentation,
+  threadFeedRunIsUnsettled,
   type ThreadFeedEntry,
-  type ThreadFeedLatestTurn,
+  type ThreadFeedLatestRun,
 } from "../../lib/threadActivity";
 import type { ThreadContentPresentation } from "./threadContentPresentation";
 import {
   resolveThreadFeedLiveFollow,
   type ThreadFeedLiveFollowEvent,
 } from "./thread-feed-live-follow";
-import {
-  collapsedWorkLogHeight,
-  ThreadWorkGroupToggle,
-  ThreadWorkLog,
-  WORK_GROUP_TOGGLE_HEIGHT,
-} from "./thread-work-log";
+import { ThreadWorkGroupToggle, ThreadWorkLog } from "./thread-work-log";
+import { resolveThreadFeedFixedItemSize } from "./thread-feed-item-size";
 import { useMarkdownCodeHighlight } from "./markdownCodeHighlightState";
 import { useAssetUrl, useAssetUrlState } from "../../state/assets";
-import { resolveWorkspaceRelativeFilePath } from "../files/filePath";
 import { MARKDOWN_IMAGE_MAX_WIDTH, resolveMarkdownImageDisplaySize } from "./markdownImageSize";
+import { appAtomRegistry } from "../../state/atom-registry";
+import { environmentThreadShells, threadEnvironment } from "../../state/threads";
+import { useAtomCommand } from "../../state/use-atom-command";
+import { useV2ItemSupport } from "../../state/v2-item-support";
+import { resolveWorkspaceRelativeFilePath } from "../files/filePath";
+import { waitForThreadShellReady } from "./threadForkNavigation";
+import { resolveUserMessageIntentBadge } from "./userMessageIntentBadge";
 
 const WIDE_MARKDOWN_BLOCK_OPTIONS = {
   includeOrderedLists: Platform.OS === "android",
@@ -128,16 +133,6 @@ function formatMessageTime(input: string): string {
   return MESSAGE_TIME_FORMATTER.format(timestamp);
 }
 
-// Pre-measurement heights for getFixedItemSize, mirroring renderFeedEntry's
-// classNames. The fold row's min-h-11 (44px) stays taller than its single
-// text-sm line at every supported base font size (26px at the 22pt maximum),
-// so its height is a constant; a drifted value costs one correction on
-// measure, not a persistent offset.
-const TURN_FOLD_HEIGHT = 56; // min-h-11 (44) + mb-3 (12)
-// The working row has no min-height clamp — its height follows the scaled
-// text-xs line height (see workingRowHeight in ThreadFeed).
-const WORKING_ROW_VERTICAL_EXTRAS = 24; // py-1 (8) + mb-4 (16)
-
 // Entering animations must only play for rows born just now — LegendList
 // remounts rows when they scroll back into view, and replaying an entrance for
 // old content would be its own kind of jank.
@@ -147,33 +142,121 @@ function isFreshTimestamp(input: string): boolean {
   return Number.isFinite(timestamp) && Date.now() - timestamp < FRESH_ENTRY_WINDOW_MS;
 }
 
+export interface ThreadFeedHistoryControls {
+  readonly hasMoreHistory: boolean;
+  readonly loading: boolean;
+  readonly error: string | null;
+  readonly onLoadEarlier: () => void;
+}
+
 export interface ThreadFeedProps {
   readonly environmentId: EnvironmentId;
   readonly threadId: ThreadId;
+  readonly threadTitle: string;
   readonly workspaceRoot?: string | null;
   readonly feed: ReadonlyArray<ThreadFeedEntry>;
   readonly contentPresentation: ThreadContentPresentation;
   readonly agentLabel: string;
-  readonly latestTurn: ThreadFeedLatestTurn | null;
+  readonly latestRun: ThreadFeedLatestRun | null;
   readonly activeWorkStartedAt: string | null;
   readonly listRef: RefObject<LegendListRef | null>;
   readonly freeze: SharedValue<boolean>;
   readonly anchorMessageId: MessageId | null;
-  readonly submittedMessageId: MessageId | null;
   readonly contentInsetEndAdjustment: SharedValue<number>;
   readonly contentTopInset?: number;
   readonly contentBottomInset?: number;
+  readonly historyControls?: ThreadFeedHistoryControls;
+  readonly topAccessory?: ReactNode;
   readonly contentMaxWidth?: number;
   readonly layoutVariant?: LayoutVariant;
   readonly usesAutomaticContentInsets?: boolean;
   readonly onHeaderMaterialVisibilityChange?: (visible: boolean) => void;
   readonly onEndFollowEnabledChange?: (enabled: boolean) => void;
   readonly skills?: ReadonlyArray<SelectableMarkdownSkill>;
-  /** Non-null when older turns exist beyond the loaded window. */
-  readonly loadEarlier?: {
-    readonly loading: boolean;
-    readonly onLoadEarlier: () => void;
-  } | null;
+}
+
+async function waitForThreadShell(
+  environmentId: EnvironmentId,
+  threadId: ThreadId,
+): Promise<boolean> {
+  const atom = environmentThreadShells.threadShellAtom(scopeThreadRef(environmentId, threadId));
+  return waitForThreadShellReady({
+    read: () => appAtomRegistry.get(atom) !== null,
+  });
+}
+
+function AssistantForkButton(props: {
+  readonly environmentId: EnvironmentId;
+  readonly iconColor: ColorValue;
+  readonly projectedItem: OrchestrationV2ProjectedTurnItem;
+  readonly sourceTitle: string;
+}) {
+  const support = useV2ItemSupport({
+    environmentId: props.environmentId,
+    sourceThreadId: props.projectedItem.sourceThreadId,
+    sourceItemId: props.projectedItem.sourceItemId,
+  });
+  const forkFromRun = useAtomCommand(threadEnvironment.forkFromRun, "fork from response");
+  const navigation = useNavigation();
+  const [busy, setBusy] = useState(false);
+  const canFork = canForkProjectedAssistantItem({
+    projectedItem: props.projectedItem,
+    capabilities: support.providerSession?.capabilities,
+  });
+  const runId = props.projectedItem.item.runId;
+
+  if (!canFork || runId === null) return null;
+
+  return (
+    <Pressable
+      accessibilityRole="button"
+      accessibilityLabel="Fork from this response"
+      disabled={busy}
+      onPress={() => {
+        const targetThreadId = ThreadId.make(uuidv4());
+        setBusy(true);
+        void Haptics.selectionAsync();
+        void forkFromRun({
+          environmentId: props.environmentId,
+          input: {
+            sourceThreadId: props.projectedItem.sourceThreadId,
+            targetThreadId,
+            runId,
+            title: `${props.sourceTitle} fork`,
+            creationSource: "mobile",
+          },
+        })
+          .then(async (result) => {
+            if (result._tag !== "Success") return;
+            const targetThreadReady = await waitForThreadShell(props.environmentId, targetThreadId);
+            if (!targetThreadReady) {
+              Alert.alert(
+                "Fork created",
+                "Its thread data did not reach this client. Reconnect and try opening it from the thread list.",
+              );
+              return;
+            }
+            navigation.navigate("Thread", {
+              environmentId: props.environmentId,
+              threadId: targetThreadId,
+            });
+          })
+          .finally(() => setBusy(false));
+      }}
+      className="h-7 w-7 items-center justify-center disabled:opacity-40"
+    >
+      {busy ? (
+        <ActivityIndicator size="small" />
+      ) : (
+        <SymbolView
+          name="arrow.triangle.branch"
+          size={13}
+          tintColor={props.iconColor}
+          type="monochrome"
+        />
+      )}
+    </Pressable>
+  );
 }
 
 function MessageAttachmentImage(props: {
@@ -563,10 +646,7 @@ function useReviewCommentColors(): ReviewCommentColors {
   );
 }
 
-function useMarkdownStyles(
-  onLinkPress: (href: string) => void,
-  renderImage: MarkdownImageRenderer,
-): MarkdownStyleSets {
+function useMarkdownStyles(onLinkPress: (href: string) => void): MarkdownStyleSets {
   const { appearance, themeAppearance } = useAppearancePreferences();
   const markdownFontSizes = useMemo(
     () => resolveMarkdownFontSizes(appearance.baseFontSize),
@@ -772,14 +852,6 @@ function useMarkdownStyles(
           })}
         </View>
       ),
-      image: ({ node }) =>
-        node.href
-          ? (renderImage({
-              href: node.href,
-              alt: node.alt ?? null,
-              title: node.title ?? null,
-            }) ?? undefined)
-          : undefined,
       code_inline: ({ content }) => {
         const value = content ?? "";
         return (
@@ -953,7 +1025,6 @@ function useMarkdownStyles(
     nativeMarkdownTypography,
     onLinkPress,
     regularFontFamily,
-    renderImage,
     themeMode,
     userBubbleForegroundMuted,
     userBubbleSkillForeground,
@@ -962,24 +1033,25 @@ function useMarkdownStyles(
 
 function renderFeedEntry(
   info: { item: ThreadFeedEntry; index: number },
-  props: Pick<ThreadFeedProps, "environmentId" | "skills"> & {
+  props: Pick<ThreadFeedProps, "environmentId" | "skills" | "threadId" | "workspaceRoot"> & {
     readonly copiedRowId: string | null;
+    readonly expandedWorkGroups: Record<string, boolean>;
     readonly expandedWorkRows: Record<string, boolean>;
     readonly terminalAssistantMessageIds: ReadonlySet<string>;
-    readonly unsettledTurnId: TurnId | null;
+    readonly unsettledTurnId: RunId | null;
     readonly onCopyWorkRow: (rowId: string, value: string) => void;
     readonly onToggleWorkGroup: (groupId: string) => void;
-    readonly onToggleWorkRow: (rowId: string) => void;
-    readonly onToggleTurnFold: (turnId: TurnId) => void;
+    readonly onToggleWorkRow: (rowId: string, anchorKey?: string) => void;
+    readonly onToggleTurnFold: (runId: RunId) => void;
     readonly onPressImage: (uri: string, headers?: Record<string, string>) => void;
     readonly onMarkdownLinkPress: (href: string) => void;
-    readonly renderMarkdownImage: MarkdownImageRenderer;
     readonly iconSubtleColor: string | import("react-native").ColorValue;
     readonly userBubbleColor: string | import("react-native").ColorValue;
     readonly markdownStyles: MarkdownStyleSets;
     readonly reviewCommentColors: ReviewCommentColors;
     readonly reviewCommentBubbleWidth: number;
     readonly userBubbleMaxWidth: number;
+    readonly threadTitle: string;
   },
 ) {
   const entry = info.item;
@@ -989,12 +1061,12 @@ function renderFeedEntry(
     return <WorkingTimelineRow startedAt={entry.createdAt} />;
   }
 
-  if (entry.type === "turn-fold") {
+  if (entry.type === "run-fold") {
     return (
       <Pressable
         accessibilityRole="button"
         accessibilityState={{ expanded: entry.expanded }}
-        onPress={() => props.onToggleTurnFold(entry.turnId)}
+        onPress={() => props.onToggleTurnFold(entry.runId)}
         hitSlop={4}
         className="mb-3 min-h-11 flex-row items-center gap-2 border-b border-adaptive-neutral-200-a80-white-a8 px-2"
       >
@@ -1041,7 +1113,7 @@ function renderFeedEntry(
     const assistantTurnStillInProgress =
       message.role === "assistant" &&
       props.unsettledTurnId !== null &&
-      message.turnId === props.unsettledTurnId;
+      message.runId === props.unsettledTurnId;
     const showAssistantMeta =
       message.role === "assistant" &&
       props.terminalAssistantMessageIds.has(message.id) &&
@@ -1050,11 +1122,17 @@ function renderFeedEntry(
 
     if (isUser) {
       const enterAnimated = isFreshTimestamp(message.createdAt);
+      const intentBadge = resolveUserMessageIntentBadge(message.inputIntent);
       return (
         <Animated.View
           className="mb-5 items-end"
           {...(enterAnimated ? { entering: FadeInUp.duration(220) } : {})}
         >
+          {message.createdBy === "agent" ? (
+            <Text className="mb-1 pr-1 font-t3-medium text-2xs text-foreground-muted opacity-60">
+              Sent by another agent
+            </Text>
+          ) : null}
           <View
             className="min-w-0 gap-2 rounded-[20px] px-3.5 py-2.5"
             style={{
@@ -1074,7 +1152,6 @@ function renderFeedEntry(
                 reviewCommentColors={props.reviewCommentColors}
                 skills={props.skills}
                 onLinkPress={props.onMarkdownLinkPress}
-                renderImage={props.renderMarkdownImage}
               />
             ) : null}
             {attachments.map((attachment) => {
@@ -1090,6 +1167,30 @@ function renderFeedEntry(
             })}
           </View>
           <View className="mt-1 flex-row items-center justify-end gap-1 pr-0.5">
+            {intentBadge ? (
+              <View
+                accessible
+                accessibilityRole="text"
+                accessibilityLabel={intentBadge.accessibilityLabel}
+                className={cn(
+                  "rounded-full border px-1.5 py-0.5",
+                  intentBadge.tone === "queued"
+                    ? "border-adaptive-amber-500-a25-400-a25 bg-adaptive-amber-500-a10-400-a10"
+                    : "border-adaptive-sky-500-a25-400-a25 bg-adaptive-sky-500-a10-400-a10",
+                )}
+              >
+                <Text
+                  className={cn(
+                    "font-t3-medium text-2xs tracking-wide",
+                    intentBadge.tone === "queued"
+                      ? "text-adaptive-amber-700-300"
+                      : "text-adaptive-sky-700-300",
+                  )}
+                >
+                  {intentBadge.label}
+                </Text>
+              </View>
+            ) : null}
             <Text className="font-t3-medium text-xs tabular-nums text-adaptive-neutral-600-400">
               {timestampLabel}
             </Text>
@@ -1126,7 +1227,6 @@ function renderFeedEntry(
               skills={props.skills}
               textStyle={styles.nativeTextStyle}
               onLinkPress={props.onMarkdownLinkPress}
-              renderImage={props.renderMarkdownImage}
             />
           ) : (
             <Markdown
@@ -1152,6 +1252,14 @@ function renderFeedEntry(
         })}
         {showAssistantMeta ? (
           <View className="mt-1 flex-row items-center gap-1">
+            {message.projectedItem ? (
+              <AssistantForkButton
+                environmentId={props.environmentId}
+                iconColor={iconSubtleColor}
+                projectedItem={message.projectedItem}
+                sourceTitle={props.threadTitle}
+              />
+            ) : null}
             <CopyTextButton
               accessibilityLabel="Copy message"
               text={message.text}
@@ -1172,10 +1280,15 @@ function renderFeedEntry(
     <ThreadWorkLog
       activities={entry.activities}
       copiedRowId={props.copiedRowId}
+      currentThreadId={props.threadId}
+      environmentId={props.environmentId}
+      expanded={props.expandedWorkGroups[entry.id] ?? false}
       expandedRows={props.expandedWorkRows}
       iconSubtleColor={iconSubtleColor}
       onCopyRow={props.onCopyWorkRow}
-      onToggleRow={props.onToggleWorkRow}
+      onToggleGroup={() => props.onToggleWorkGroup(entry.id)}
+      onToggleRow={(rowId) => props.onToggleWorkRow(rowId, entry.id)}
+      workspaceRoot={props.workspaceRoot}
     />
   );
 }
@@ -1212,7 +1325,6 @@ function UserMessageContent(props: {
   readonly reviewCommentColors: ReviewCommentColors;
   readonly skills?: ReadonlyArray<SelectableMarkdownSkill>;
   readonly onLinkPress: (href: string) => void;
-  readonly renderImage: MarkdownImageRenderer;
 }) {
   const segments = parseReviewCommentMessageSegments(props.text);
   const hasReviewComment = segments.some((segment) => segment.kind === "review-comment");
@@ -1225,7 +1337,6 @@ function UserMessageContent(props: {
           textStyle={props.markdownStyles.nativeTextStyle}
           preserveSoftBreaks
           onLinkPress={props.onLinkPress}
-          renderImage={props.renderImage}
         />
       );
     }
@@ -1267,7 +1378,6 @@ function UserMessageContent(props: {
             textStyle={props.markdownStyles.nativeTextStyle}
             preserveSoftBreaks
             onLinkPress={props.onLinkPress}
-            renderImage={props.renderImage}
           />
         ) : (
           <Markdown
@@ -1447,6 +1557,42 @@ function compactFileName(filePath: string): string {
   return lastSlashIndex >= 0 ? normalized.slice(lastSlashIndex + 1) : normalized;
 }
 
+function ThreadFeedLoadEarlierControl(props: ThreadFeedHistoryControls) {
+  const theme = useUniwindTheme();
+  const mutedColor = theme["--color-icon-subtle"];
+  const accentColor = theme["--color-primary"];
+  if (!props.hasMoreHistory && props.error === null) {
+    return null;
+  }
+  return (
+    <View className="mb-3 items-center gap-1.5 px-2">
+      {props.hasMoreHistory ? (
+        <Pressable
+          accessibilityRole="button"
+          accessibilityLabel="Load earlier activity"
+          disabled={props.loading}
+          onPress={props.onLoadEarlier}
+          className="min-h-9 flex-row items-center justify-center gap-2 rounded-full border border-border/60 bg-surface/80 px-4 py-2 disabled:opacity-50"
+        >
+          {props.loading ? (
+            <ActivityIndicator size="small" color={accentColor} />
+          ) : (
+            <SymbolView name="chevron.up" size={12} tintColor={accentColor} type="monochrome" />
+          )}
+          <Text className="text-sm font-medium text-foreground">
+            {props.loading ? "Loading earlier activity…" : "Load earlier activity"}
+          </Text>
+        </Pressable>
+      ) : null}
+      {props.error !== null ? (
+        <Text className="text-center text-xs" style={{ color: mutedColor }}>
+          {props.error}
+        </Text>
+      ) : null}
+    </View>
+  );
+}
+
 function ThreadFeedPlaceholder(props: {
   readonly bottomInset: number;
   readonly detail: string;
@@ -1481,10 +1627,10 @@ export const ThreadFeed = memo(function ThreadFeed(props: ThreadFeedProps) {
   const copyFeedbackTimeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);
   const foldSettleFrameRef = useRef<number | null>(null);
   const foldSettleSecondFrameRef = useRef<number | null>(null);
+  const previousLatestTurnRef = useRef(props.latestRun);
+  const userScrollSettleTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
   const disclosureAnchorKeyRef = useRef<string | null>(null);
   const headerMaterialVisibleRef = useRef(false);
-  const previousLatestTurnRef = useRef(props.latestTurn);
-  const userScrollSettleTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
   const { width: windowWidth } = useWindowDimensions();
   const { appearance } = useAppearancePreferences();
   const [viewportWidth, setViewportWidth] = useState(() =>
@@ -1492,11 +1638,11 @@ export const ThreadFeed = memo(function ThreadFeed(props: ThreadFeedProps) {
   );
   const [viewportHeight, setViewportHeight] = useState(0);
   const [disclosureToggleSettling, setDisclosureToggleSettling] = useState(false);
-  // Live-follow latch. LegendList's maintainScrollAtEnd alone re-pins the feed
-  // whenever the viewport drifts back inside its geometric threshold, which
-  // yanked users off history they were reading every time a stream chunk grew
-  // a row. Follow breaks when the user scrolls up and away, and re-arms only
-  // when the list actually returns to the end (or on send / thread switch).
+  // Live-follow latch (#5566). LegendList's maintainScrollAtEnd alone re-pins
+  // the feed whenever the viewport drifts back inside its geometric threshold,
+  // which yanked users off history they were reading every time a stream chunk
+  // grew a row. Follow breaks when the user scrolls up and away, and re-arms
+  // only when the list actually returns to the end (or on send / thread switch).
   const [endFollowEnabled, setEndFollowEnabled] = useState(true);
   const endFollowEnabledRef = useRef(true);
   // A "user scroll session" spans from drag start through the end of its
@@ -1524,7 +1670,7 @@ export const ThreadFeed = memo(function ThreadFeed(props: ThreadFeedProps) {
     readonly copiedRowId: string | null;
     readonly expandedWorkGroups: Record<string, boolean>;
     readonly expandedWorkRows: Record<string, boolean>;
-    readonly expandedTurnIds: ReadonlySet<TurnId>;
+    readonly expandedTurnIds: ReadonlySet<RunId>;
   }>({
     copiedRowId: null,
     expandedWorkGroups: {},
@@ -1550,11 +1696,6 @@ export const ThreadFeed = memo(function ThreadFeed(props: ThreadFeedProps) {
   const bottomContentInset = props.contentBottomInset ?? 18;
   const usesNativeAutomaticInsets =
     props.usesAutomaticContentInsets === true && Platform.OS === "ios";
-  const initialContentInset = deriveThreadFeedInitialContentInset({
-    platform: Platform.OS,
-    usesNativeAutomaticInsets,
-    bottomContentInset,
-  });
   // With automatic insets the header inset lives in UIKit's adjustedContentInset,
   // which LegendList's JS anchoring math cannot see — it measures the anchored
   // end space from the scroll view's frame top. Fold the header height back into
@@ -1596,42 +1737,14 @@ export const ThreadFeed = memo(function ThreadFeed(props: ThreadFeedProps) {
     },
     [props.environmentId, props.threadId, props.workspaceRoot, navigation],
   );
-  const renderMarkdownImage = useCallback<MarkdownImageRenderer>(
-    (image) => {
-      const imageSource = classifyMarkdownImageSource(image.href, props.workspaceRoot ?? null);
-      if (imageSource._tag === "Direct") {
-        return (
-          <ThreadMarkdownImageView
-            uri={imageSource.uri}
-            sourceKey={imageSource.uri}
-            unavailable={false}
-            alt={image.alt}
-            onPressImage={(uri) => setExpandedImage({ uri })}
-          />
-        );
-      }
-      if (imageSource._tag === "Blocked") {
-        return <ThreadMarkdownImageUnavailable alt={image.alt} />;
-      }
-      return (
-        <ThreadMarkdownImage
-          environmentId={props.environmentId}
-          threadId={props.threadId}
-          path={imageSource.path}
-          alt={image.alt}
-          onPressImage={(uri) => setExpandedImage({ uri })}
-        />
-      );
-    },
-    [props.environmentId, props.threadId, props.workspaceRoot],
-  );
-  const markdownStyles = useMarkdownStyles(onMarkdownLinkPress, renderMarkdownImage);
+  const markdownStyles = useMarkdownStyles(onMarkdownLinkPress);
   const reviewCommentColors = useReviewCommentColors();
   // LegendList does not invalidate visible rows when only the renderItem closure changes.
   // Keep row-local interaction props in extraData so disclosures and copy feedback repaint.
   const listAppearanceData = useMemo(
     () => ({
       copiedRowId,
+      expandedWorkGroups,
       expandedWorkRows,
       iconSubtleColor,
       markdownStyles,
@@ -1641,6 +1754,7 @@ export const ThreadFeed = memo(function ThreadFeed(props: ThreadFeedProps) {
     }),
     [
       copiedRowId,
+      expandedWorkGroups,
       expandedWorkRows,
       iconSubtleColor,
       markdownStyles,
@@ -1733,22 +1847,10 @@ export const ThreadFeed = memo(function ThreadFeed(props: ThreadFeedProps) {
 
   useEffect(() => clearUserScrollSettle, [clearUserScrollSettle]);
 
-  const handleViewportLayout = useCallback((event: LayoutChangeEvent) => {
-    const nextWidth = Math.round(event.nativeEvent.layout.width);
-    const nextHeight = Math.round(event.nativeEvent.layout.height);
-    setViewportWidth((current) => (Math.abs(current - nextWidth) > 1 ? nextWidth : current));
-    setViewportHeight((current) => (Math.abs(current - nextHeight) > 1 ? nextHeight : current));
-  }, []);
-
   // Thread identity is env-scoped: two environments can hold the same
   // ThreadId, and keying resets (or the list mount) on the bare id would
   // carry stale scroll/follow state across an environment switch.
   const feedThreadKey = scopedThreadKey(props.environmentId, props.threadId);
-
-  useEffect(() => {
-    reportHeaderMaterialVisibility(false);
-  }, [feedThreadKey, reportHeaderMaterialVisibility]);
-
   // A thread switch opens pinned to the end; a send explicitly returns to the
   // live edge (ThreadDetailScreen scrolls the new message into place). Both
   // re-arm follow regardless of where the user had scrolled before.
@@ -1758,47 +1860,47 @@ export const ThreadFeed = memo(function ThreadFeed(props: ThreadFeedProps) {
     transitionEndFollow({ type: "reset" });
   }, [clearUserScrollSettle, feedThreadKey, transitionEndFollow]);
   useEffect(() => {
-    if (props.submittedMessageId !== null) {
+    if (props.anchorMessageId !== null) {
       clearUserScrollSettle();
       userScrollSessionRef.current = false;
       transitionEndFollow({ type: "reset" });
     }
-  }, [clearUserScrollSettle, props.submittedMessageId, transitionEndFollow]);
+  }, [clearUserScrollSettle, props.anchorMessageId, transitionEndFollow]);
+
+  const handleViewportLayout = useCallback((event: LayoutChangeEvent) => {
+    const nextWidth = Math.round(event.nativeEvent.layout.width);
+    const nextHeight = Math.round(event.nativeEvent.layout.height);
+    setViewportWidth((current) => (Math.abs(current - nextWidth) > 1 ? nextWidth : current));
+    setViewportHeight((current) => (Math.abs(current - nextHeight) > 1 ? nextHeight : current));
+  }, []);
+
+  useEffect(() => {
+    reportHeaderMaterialVisibility(false);
+  }, [feedThreadKey, reportHeaderMaterialVisibility]);
 
-  const expandedWorkGroupIds = useMemo(() => {
-    const ids = new Set<string>();
-    for (const [groupId, expanded] of Object.entries(expandedWorkGroups)) {
-      if (expanded) {
-        ids.add(groupId);
-      }
-    }
-    return ids;
-  }, [expandedWorkGroups]);
   const presentedFeed = useMemo(
     () =>
       deriveThreadFeedPresentation(
         props.feed,
-        props.latestTurn,
+        props.latestRun,
         expandedTurnIds,
-        expandedWorkGroupIds,
+        new Set(
+          Object.entries(expandedWorkGroups)
+            .filter(([, expanded]) => expanded)
+            .map(([groupId]) => groupId),
+        ),
         props.activeWorkStartedAt,
       ),
-    [
-      expandedTurnIds,
-      expandedWorkGroupIds,
-      props.activeWorkStartedAt,
-      props.feed,
-      props.latestTurn,
-    ],
+    [expandedTurnIds, expandedWorkGroups, props.activeWorkStartedAt, props.feed, props.latestRun],
   );
 
   // The empty↔filled key below remounts the list, which resets its imperative
   // content-inset override — and useKeyboardChatComposerInset (mounted above
   // the remount boundary) deduplicates by height, so it never re-reports the
-  // composer inset to the fresh instance. Re-report the measured overlay height
-  // (composer plus any pending approval / user-input card) so the remounted
-  // list's scroll math gets the true value; on Android the declarative
-  // contentInset floor below covers the window before this effect lands.
+  // composer inset to the fresh instance. Without this, the remounted list's
+  // initial scroll-to-end computes with a zero end inset and rests one
+  // composer-height short of the end. Layout effect: it must land before the
+  // list's first positioning tick or the one-shot initial scroll misses it.
   const listMountKey = `${feedThreadKey}:${props.feed.length === 0 ? "empty" : "filled"}`;
   useLayoutEffect(() => {
     const bottom = props.contentInsetEndAdjustment.value;
@@ -1812,35 +1914,31 @@ export const ThreadFeed = memo(function ThreadFeed(props: ThreadFeedProps) {
       resolveChatListAnchoredEndSpace(
         presentedFeed,
         props.anchorMessageId,
-        (entry) => (entry.type === "message" && entry.message.role === "user" ? entry.id : null),
+        (entry) => (entry.type === "message" ? entry.id : null),
         { anchorOffset: anchorTopInset + CHAT_LIST_ANCHOR_OFFSET },
       ),
     [presentedFeed, props.anchorMessageId, anchorTopInset],
   );
   const terminalAssistantMessageIds = useMemo(() => {
-    const terminalIdsByTurn = new Map<TurnId, string>();
+    const terminalIdsByTurn = new Map<RunId, string>();
     for (const entry of props.feed) {
-      if (entry.type === "message" && entry.message.role === "assistant" && entry.message.turnId) {
-        terminalIdsByTurn.set(entry.message.turnId, entry.message.id);
+      if (entry.type === "message" && entry.message.role === "assistant" && entry.message.runId) {
+        terminalIdsByTurn.set(entry.message.runId, entry.message.id);
       }
     }
     return new Set(terminalIdsByTurn.values());
   }, [props.feed]);
-  const unsettledTurnId =
-    props.latestTurn &&
-    (props.latestTurn.completedAt === null || props.latestTurn.state === "running")
-      ? props.latestTurn.turnId
-      : null;
+  const unsettledTurnId = threadFeedRunIsUnsettled(props.latestRun) ? props.latestRun.runId : null;
 
   useEffect(() => {
     const previous = previousLatestTurnRef.current;
-    previousLatestTurnRef.current = props.latestTurn;
-    if (!props.latestTurn || !previous) {
+    previousLatestTurnRef.current = props.latestRun;
+    if (!props.latestRun || !previous) {
       return;
     }
-    if (props.latestTurn.turnId === previous.turnId) {
-      if (previous.state === "running" && props.latestTurn.state === "interrupted") {
-        const interruptedTurnId = props.latestTurn.turnId;
+    if (props.latestRun.runId === previous.runId) {
+      if (previous.status === "running" && props.latestRun.status === "interrupted") {
+        const interruptedTurnId = props.latestRun.runId;
         setInteractionState((current) => ({
           ...current,
           expandedTurnIds: new Set(current.expandedTurnIds).add(interruptedTurnId),
@@ -1849,14 +1947,14 @@ export const ThreadFeed = memo(function ThreadFeed(props: ThreadFeedProps) {
       return;
     }
     setInteractionState((current) => {
-      if (!current.expandedTurnIds.has(previous.turnId)) {
+      if (!current.expandedTurnIds.has(previous.runId)) {
         return current;
       }
       const next = new Set(current.expandedTurnIds);
-      next.delete(previous.turnId);
+      next.delete(previous.runId);
       return { ...current, expandedTurnIds: next };
     });
-  }, [props.latestTurn]);
+  }, [props.latestRun]);
 
   useEffect(() => {
     return () => {
@@ -1937,8 +2035,8 @@ export const ThreadFeed = memo(function ThreadFeed(props: ThreadFeedProps) {
   );
 
   const onToggleWorkRow = useCallback(
-    (rowId: string) => {
-      suspendEndScrollMaintenanceForDisclosure(rowId);
+    (rowId: string, anchorKey?: string) => {
+      suspendEndScrollMaintenanceForDisclosure(anchorKey ?? null);
       setInteractionState((current) => ({
         ...current,
         expandedWorkRows: {
@@ -1951,14 +2049,14 @@ export const ThreadFeed = memo(function ThreadFeed(props: ThreadFeedProps) {
   );
 
   const onToggleTurnFold = useCallback(
-    (turnId: TurnId) => {
-      suspendEndScrollMaintenanceForDisclosure(`turn-fold:${turnId}`);
+    (runId: RunId) => {
+      suspendEndScrollMaintenanceForDisclosure(`run-fold:${runId}`);
       setInteractionState((current) => {
         const next = new Set(current.expandedTurnIds);
-        if (next.has(turnId)) {
-          next.delete(turnId);
+        if (next.has(runId)) {
+          next.delete(runId);
         } else {
-          next.add(turnId);
+          next.add(runId);
         }
         return { ...current, expandedTurnIds: next };
       });
@@ -1975,38 +2073,22 @@ export const ThreadFeed = memo(function ThreadFeed(props: ThreadFeedProps) {
   // scrolling up through unmeasured content corrects each row's height as it
   // mounts — the feed visibly jumps. Fixed sizes make the small chrome rows
   // exact; message rows stay undefined and use LegendList's per-type running
-  // average once one of their type has been measured. Text-driven heights
-  // follow the configurable base font size via scaledTypographyLineHeight.
-  const workingRowHeight =
-    WORKING_ROW_VERTICAL_EXTRAS +
-    scaledTypographyLineHeight(MOBILE_TYPOGRAPHY.label, appearance.baseFontSize);
+  // average once one of their type has been measured. Activity groups are
+  // also content-driven: prominent v2 items add a card and related-thread
+  // link, so marking them fixed would make LegendList skip their measurement
+  // and position the next message inside the card.
   const getFixedItemSize = useCallback(
-    (entry: ThreadFeedEntry) => {
-      switch (entry.type) {
-        case "turn-fold":
-          return TURN_FOLD_HEIGHT;
-        case "work-toggle":
-          return WORK_GROUP_TOGGLE_HEIGHT;
-        case "working":
-          return workingRowHeight;
-        case "activity-group":
-          // Expanded rows append a variable detail block — fall back to
-          // measurement for those groups.
-          return entry.activities.some((activity) => expandedWorkRows[activity.id])
-            ? undefined
-            : collapsedWorkLogHeight(entry.activities, appearance.baseFontSize);
-        default:
-          return undefined;
-      }
-    },
-    [expandedWorkRows, workingRowHeight, appearance.baseFontSize],
+    (entry: ThreadFeedEntry) => resolveThreadFeedFixedItemSize(entry.type, appearance.baseFontSize),
+    [appearance.baseFontSize],
   );
 
   const renderItem = useCallback(
     (info: { item: ThreadFeedEntry; index: number }) =>
       renderFeedEntry(info, {
         environmentId: props.environmentId,
+        threadId: props.threadId,
         copiedRowId,
+        expandedWorkGroups,
         expandedWorkRows,
         terminalAssistantMessageIds,
         unsettledTurnId,
@@ -2016,17 +2098,19 @@ export const ThreadFeed = memo(function ThreadFeed(props: ThreadFeedProps) {
         onToggleTurnFold,
         onPressImage,
         onMarkdownLinkPress,
-        renderMarkdownImage,
         iconSubtleColor,
         userBubbleColor,
         markdownStyles,
         reviewCommentColors,
         reviewCommentBubbleWidth,
         userBubbleMaxWidth,
+        threadTitle: props.threadTitle,
         skills: props.skills,
+        workspaceRoot: props.workspaceRoot,
       }),
     [
       copiedRowId,
+      expandedWorkGroups,
       expandedWorkRows,
       terminalAssistantMessageIds,
       unsettledTurnId,
@@ -2043,8 +2127,10 @@ export const ThreadFeed = memo(function ThreadFeed(props: ThreadFeedProps) {
       onToggleWorkGroup,
       onToggleWorkRow,
       props.environmentId,
+      props.threadId,
+      props.threadTitle,
       props.skills,
-      renderMarkdownImage,
+      props.workspaceRoot,
     ],
   );
 
@@ -2105,17 +2191,6 @@ export const ThreadFeed = memo(function ThreadFeed(props: ThreadFeedProps) {
             // ThreadDetailScreen); this tells LegendList's scroll math about the
             // extra so programmatic end scrolls land at the true resting offset.
             contentInsetEndStaticAdjustment={usesNativeAutomaticInsets ? insets.bottom : 0}
-            // Android: the composer overlay only exists as the keyboard
-            // integration's animated bottom padding, which the list's scroll
-            // math cannot see until the inset reports above land — and those
-            // arrive via runOnJS, racing the remounted list's one-shot initial
-            // scroll-at-end. Seed the estimated overlay height as a declarative
-            // contentInset floor: LegendList consumes it in JS math only
-            // (Android's ScrollView has no native contentInset prop) and the
-            // first reported override REPLACES it instead of adding to it.
-            // Not on iOS: there the prop would reach UIKit and inset natively
-            // on top of the animated padding.
-            {...(initialContentInset ? { contentInset: initialContentInset } : {})}
             // The keyboard integration's offset math (end pinning, max scroll)
             // must add the same UIKit-added extra, or its keyboard-open end
             // targets land one safe-area short of the true resting offset.
@@ -2185,17 +2260,10 @@ export const ThreadFeed = memo(function ThreadFeed(props: ThreadFeedProps) {
             ListHeaderComponent={
               <>
                 {usesNativeAutomaticInsets ? null : <View style={{ height: topContentInset }} />}
-                {props.loadEarlier != null ? (
-                  <Pressable
-                    onPress={props.loadEarlier.onLoadEarlier}
-                    disabled={props.loadEarlier.loading}
-                    className="items-center py-2"
-                  >
-                    <Text className="text-xs text-foreground-secondary">
-                      {props.loadEarlier.loading ? "Loading earlier turns…" : "Load earlier turns"}
-                    </Text>
-                  </Pressable>
+                {props.historyControls ? (
+                  <ThreadFeedLoadEarlierControl {...props.historyControls} />
                 ) : null}
+                {props.topAccessory}
               </>
             }
             contentContainerStyle={{
diff --git a/apps/mobile/src/features/threads/ThreadNavigationSidebar.tsx b/apps/mobile/src/features/threads/ThreadNavigationSidebar.tsx
index 512b9b78a4ca..a94c82afcba3 100644
--- a/apps/mobile/src/features/threads/ThreadNavigationSidebar.tsx
+++ b/apps/mobile/src/features/threads/ThreadNavigationSidebar.tsx
@@ -888,7 +888,7 @@ function ThreadNavigationSidebarPane(
                   ?.providers.find(
                     (provider) =>
                       provider.instanceId ===
-                      (thread.session?.providerInstanceId ?? thread.modelSelection.instanceId),
+                      (thread.runtime?.providerInstanceId ?? thread.modelSelection.instanceId),
                   )?.driver ?? null
               }
               environmentLabel={
diff --git a/apps/mobile/src/features/threads/ThreadQueueControl.tsx b/apps/mobile/src/features/threads/ThreadQueueControl.tsx
new file mode 100644
index 000000000000..e70d71083988
--- /dev/null
+++ b/apps/mobile/src/features/threads/ThreadQueueControl.tsx
@@ -0,0 +1,150 @@
+import * as Haptics from "expo-haptics";
+import { SymbolView } from "expo-symbols";
+import { deriveThreadQueueWorkflowState } from "@t3tools/client-runtime/state/thread-workflows";
+import type { EnvironmentId, RunId, ThreadId } from "@t3tools/contracts";
+import { useMemo, useState } from "react";
+import { Pressable, ScrollView, View } from "react-native";
+
+import { AppText as Text } from "../../components/AppText";
+import { useUniwindTheme } from "../../lib/useUniwindTheme";
+import { threadEnvironment } from "../../state/threads";
+import { useAtomCommand } from "../../state/use-atom-command";
+import { useThreadProjection } from "../../state/use-thread-detail";
+import {
+  buildCancelQueuedRunCommand,
+  resolveThreadQueueRowControls,
+} from "./threadQueueControlPresentation";
+
+export function ThreadQueueControl(props: {
+  readonly environmentId: EnvironmentId;
+  readonly threadId: ThreadId;
+}) {
+  const scoped = useThreadProjection(props);
+  const workflow = useMemo(
+    () => (scoped ? deriveThreadQueueWorkflowState(scoped.projection) : null),
+    [scoped],
+  );
+  const reorder = useAtomCommand(threadEnvironment.reorderQueuedRun, "reorder queued message");
+  const promote = useAtomCommand(threadEnvironment.promoteQueuedRun, "promote queued message");
+  const cancel = useAtomCommand(threadEnvironment.cancelQueuedRun, "cancel queued message");
+  const [busyRunId, setBusyRunId] = useState<RunId | null>(null);
+  const theme = useUniwindTheme();
+  const iconColor = theme["--color-icon-subtle"];
+
+  if (!workflow || workflow.queuedRuns.length === 0) return null;
+
+  const move = async (runId: RunId, beforeRunId: RunId | null) => {
+    setBusyRunId(runId);
+    void Haptics.selectionAsync();
+    await reorder({
+      environmentId: props.environmentId,
+      input: { threadId: props.threadId, runId, beforeRunId },
+    });
+    setBusyRunId(null);
+  };
+
+  const steer = async (queuedRunId: RunId) => {
+    if (!workflow.activeRun || !workflow.canPromoteToSteer) return;
+    setBusyRunId(queuedRunId);
+    void Haptics.selectionAsync();
+    await promote({
+      environmentId: props.environmentId,
+      input: {
+        threadId: props.threadId,
+        queuedRunId,
+        targetRunId: workflow.activeRun.id,
+      },
+    });
+    setBusyRunId(null);
+  };
+
+  const dismiss = async (runId: RunId) => {
+    setBusyRunId(runId);
+    void Haptics.selectionAsync();
+    await cancel(
+      buildCancelQueuedRunCommand({
+        environmentId: props.environmentId,
+        runId,
+        threadId: props.threadId,
+      }),
+    );
+    setBusyRunId(null);
+  };
+
+  return (
+    <View className="mx-4 mb-3 overflow-hidden rounded-2xl border border-adaptive-neutral-300-a60-white-a12 bg-card">
+      <View className="flex-row items-center gap-2 border-b border-adaptive-neutral-300-a60-white-a12 px-3 py-2">
+        <SymbolView name="list.number" size={13} tintColor={iconColor} type="monochrome" />
+        <Text className="font-t3-medium text-xs text-foreground">Queue</Text>
+        <Text className="ml-auto text-2xs tabular-nums text-foreground-muted">
+          {workflow.queuedRuns.length}
+        </Text>
+      </View>
+      <ScrollView style={{ maxHeight: 156 }} contentContainerStyle={{ paddingVertical: 4 }}>
+        {workflow.queuedRuns.map(({ run, text }, index) => {
+          const controls = resolveThreadQueueRowControls({
+            busy: busyRunId !== null,
+            canPromoteToSteer: workflow.canPromoteToSteer,
+            canReorder: workflow.canReorder,
+            index,
+            queuedCount: workflow.queuedRuns.length,
+            text,
+          });
+
+          return (
+            <View key={run.id} className="min-h-11 flex-row items-center gap-1.5 px-2">
+              <Text className="w-5 text-right text-3xs tabular-nums text-foreground-muted">
+                {index + 1}
+              </Text>
+              <Text className="min-w-0 flex-1 text-xs text-foreground" numberOfLines={1}>
+                {controls.displayText}
+              </Text>
+              <Pressable
+                accessibilityRole="button"
+                accessibilityLabel="Move queued message up"
+                disabled={!controls.canMoveUp}
+                onPress={() => void move(run.id, workflow.queuedRuns[index - 1]?.run.id ?? null)}
+                className="h-9 w-9 items-center justify-center disabled:opacity-30"
+              >
+                <SymbolView name="arrow.up" size={13} tintColor={iconColor} type="monochrome" />
+              </Pressable>
+              <Pressable
+                accessibilityRole="button"
+                accessibilityLabel="Move queued message down"
+                disabled={!controls.canMoveDown}
+                onPress={() => void move(run.id, workflow.queuedRuns[index + 2]?.run.id ?? null)}
+                className="h-9 w-9 items-center justify-center disabled:opacity-30"
+              >
+                <SymbolView name="arrow.down" size={13} tintColor={iconColor} type="monochrome" />
+              </Pressable>
+              <Pressable
+                accessibilityRole="button"
+                accessibilityLabel="Promote queued message to steer"
+                disabled={!controls.canSteer}
+                onPress={() => void steer(run.id)}
+                className="min-h-8 flex-row items-center gap-1 rounded-lg border border-adaptive-neutral-300-a60-white-a12 px-2 disabled:opacity-30"
+              >
+                <SymbolView
+                  name="arrow.turn.left.up"
+                  size={12}
+                  tintColor={iconColor}
+                  type="monochrome"
+                />
+                <Text className="font-t3-medium text-2xs text-foreground">Steer</Text>
+              </Pressable>
+              <Pressable
+                accessibilityRole="button"
+                accessibilityLabel={controls.dismissAccessibilityLabel}
+                disabled={!controls.canDismiss}
+                onPress={() => void dismiss(run.id)}
+                className="h-9 w-9 items-center justify-center disabled:opacity-30"
+              >
+                <SymbolView name="xmark" size={13} tintColor={iconColor} type="monochrome" />
+              </Pressable>
+            </View>
+          );
+        })}
+      </ScrollView>
+    </View>
+  );
+}
diff --git a/apps/mobile/src/features/threads/ThreadRelationshipsBanner.tsx b/apps/mobile/src/features/threads/ThreadRelationshipsBanner.tsx
new file mode 100644
index 000000000000..902a83791fc8
--- /dev/null
+++ b/apps/mobile/src/features/threads/ThreadRelationshipsBanner.tsx
@@ -0,0 +1,307 @@
+import * as Haptics from "expo-haptics";
+import { SymbolView, type SFSymbol } from "expo-symbols";
+import {
+  deriveThreadRelationshipGraph,
+  immediateThreadRelationships,
+  resolveMergeBackTargetThreadId,
+  type ThreadRelationshipEdge,
+} from "@t3tools/client-runtime/state/thread-relationships";
+import {
+  canDetachThreadProviderSession,
+  resolveLatestMergeBackRun,
+} from "@t3tools/client-runtime/state/thread-workflows";
+import type { EnvironmentId, OrchestrationV2ThreadShell, ThreadId } from "@t3tools/contracts";
+import { copySorted } from "@t3tools/shared/Array";
+import { useNavigation } from "@react-navigation/native";
+import { useMemo, useState } from "react";
+import { ActivityIndicator, Modal, Pressable, ScrollView, View } from "react-native";
+import { useSafeAreaInsets } from "react-native-safe-area-context";
+
+import { AppText as Text } from "../../components/AppText";
+import { useUniwindTheme } from "../../lib/useUniwindTheme";
+import { useThreadShells } from "../../state/entities";
+import { threadEnvironment } from "../../state/threads";
+import { useAtomCommand } from "../../state/use-atom-command";
+import { useThreadProjection } from "../../state/use-thread-detail";
+import { useArchivedThreadSnapshots } from "../archive/useArchivedThreadSnapshots";
+
+function relationshipLabel(edge: ThreadRelationshipEdge, currentThreadId: ThreadId): string {
+  if (edge.kind === "transfer") {
+    return edge.sourceThreadId === currentThreadId ? "Context sent to" : "Context received from";
+  }
+  if (edge.kind === "subagent") {
+    return edge.sourceThreadId === currentThreadId ? "Subagent" : "Parent agent";
+  }
+  return edge.sourceThreadId === currentThreadId ? "Fork" : "Forked from";
+}
+
+function relationshipSymbol(edge: ThreadRelationshipEdge): SFSymbol {
+  if (edge.kind === "subagent") return "person.2";
+  if (edge.kind === "transfer") return "arrow.left.arrow.right";
+  return "arrow.triangle.branch";
+}
+
+function threadAvailability(
+  thread: OrchestrationV2ThreadShell | null,
+  missing: boolean,
+): string | null {
+  if (missing) return "Unavailable";
+  if (thread?.deletedAt !== null && thread?.deletedAt !== undefined) return "Deleted";
+  if (thread?.archivedAt !== null && thread?.archivedAt !== undefined) return "Archived";
+  return null;
+}
+
+const EMPTY_THREAD_SHELLS: ReadonlyArray<OrchestrationV2ThreadShell> = [];
+
+export function ThreadRelationshipsBanner(props: {
+  readonly environmentId: EnvironmentId;
+  readonly threadId: ThreadId;
+}) {
+  const scopedProjection = useThreadProjection(props);
+  const projection = scopedProjection?.projection ?? null;
+  const threadShells = useThreadShells();
+  const environmentIds = useMemo(() => [props.environmentId], [props.environmentId]);
+  const archived = useArchivedThreadSnapshots(environmentIds);
+  const archivedShells =
+    archived.snapshots.find((entry) => entry.environmentId === props.environmentId)?.snapshot
+      .threads ?? EMPTY_THREAD_SHELLS;
+  const shells = useMemo<ReadonlyArray<OrchestrationV2ThreadShell>>(() => {
+    const environmentShells: OrchestrationV2ThreadShell[] = [];
+    for (const thread of threadShells) {
+      if (thread.environmentId === props.environmentId) {
+        environmentShells.push(thread.source);
+      }
+    }
+    environmentShells.push(...archivedShells);
+    return environmentShells;
+  }, [archivedShells, props.environmentId, threadShells]);
+  const graph = useMemo(
+    () => deriveThreadRelationshipGraph({ threads: shells, projection }),
+    [projection, shells],
+  );
+  const mergeTargetThreadId = resolveMergeBackTargetThreadId(projection);
+  const rows = useMemo(
+    () =>
+      copySorted(
+        immediateThreadRelationships(graph, props.threadId),
+        (left, right) =>
+          Number(right.threadId === mergeTargetThreadId) -
+          Number(left.threadId === mergeTargetThreadId),
+      ),
+    [graph, mergeTargetThreadId, props.threadId],
+  );
+  const latestMergeBackRun = projection === null ? null : resolveLatestMergeBackRun(projection);
+  const canMerge = mergeTargetThreadId !== null && latestMergeBackRun !== null;
+  const canDetach = projection ? canDetachThreadProviderSession(projection) : false;
+  const [visible, setVisible] = useState(false);
+  const [busyAction, setBusyAction] = useState<"merge" | "detach" | null>(null);
+  const navigation = useNavigation();
+  const mergeBack = useAtomCommand(threadEnvironment.mergeBack, "merge thread back");
+  const stopSession = useAtomCommand(threadEnvironment.stopSession, "thread session stop");
+  const insets = useSafeAreaInsets();
+  const theme = useUniwindTheme();
+  const backdropColor = theme["--color-backdrop"];
+  const sheetColor = theme["--color-sheet"];
+  const iconColor = theme["--color-icon-subtle"];
+
+  if (rows.length === 0 && !canDetach) return null;
+
+  const primaryParent = rows.find(({ edge }) => edge.targetThreadId === props.threadId) ?? rows[0];
+  const primaryNode = primaryParent ? graph.nodes.get(primaryParent.threadId) : null;
+  const summary = primaryParent
+    ? `${relationshipLabel(primaryParent.edge, props.threadId)}: ${primaryNode?.thread?.title ?? "related thread"}`
+    : "Agent session connected";
+
+  const openThread = (threadId: ThreadId, archivedThread: boolean) => {
+    setVisible(false);
+    void Haptics.selectionAsync();
+    if (archivedThread) {
+      navigation.navigate("SettingsSheet", {
+        screen: "SettingsContent",
+        params: { screen: "SettingsArchive" },
+      });
+      return;
+    }
+    navigation.navigate("Thread", {
+      environmentId: props.environmentId,
+      threadId,
+    });
+  };
+
+  const merge = async () => {
+    if (!canMerge || mergeTargetThreadId === null || latestMergeBackRun === null) return;
+    setBusyAction("merge");
+    const result = await mergeBack({
+      environmentId: props.environmentId,
+      input: {
+        sourceThreadId: props.threadId,
+        targetThreadId: mergeTargetThreadId,
+        runId: latestMergeBackRun.id,
+        creationSource: "mobile",
+      },
+    });
+    setBusyAction(null);
+    if (result._tag === "Success") openThread(mergeTargetThreadId, false);
+  };
+
+  const detach = async () => {
+    if (!canDetach) return;
+    setBusyAction("detach");
+    await stopSession({
+      environmentId: props.environmentId,
+      input: { threadId: props.threadId },
+    });
+    setBusyAction(null);
+  };
+
+  return (
+    <>
+      <Pressable
+        accessibilityRole="button"
+        accessibilityLabel={`${summary}. Show thread relationships`}
+        onPress={() => {
+          void Haptics.selectionAsync();
+          setVisible(true);
+        }}
+        className="mb-4 min-h-11 flex-row items-center gap-2 rounded-xl border border-adaptive-neutral-300-a60-white-a12 bg-card px-3 py-2.5"
+      >
+        <SymbolView
+          name={primaryParent ? relationshipSymbol(primaryParent.edge) : "link"}
+          size={14}
+          tintColor={iconColor}
+          type="monochrome"
+        />
+        <Text className="min-w-0 flex-1 font-t3-medium text-xs text-foreground" numberOfLines={1}>
+          {summary}
+        </Text>
+        {rows.length > 1 ? (
+          <Text className="text-2xs tabular-nums text-foreground-muted">+{rows.length - 1}</Text>
+        ) : null}
+        <SymbolView name="chevron.right" size={12} tintColor={iconColor} type="monochrome" />
+      </Pressable>
+
+      <Modal
+        transparent
+        animationType="fade"
+        visible={visible}
+        statusBarTranslucent
+        onRequestClose={() => setVisible(false)}
+      >
+        <View className="flex-1 justify-end">
+          <View
+            pointerEvents="none"
+            className="absolute inset-0"
+            style={{ backgroundColor: backdropColor }}
+          />
+          <Pressable className="absolute inset-0" onPress={() => setVisible(false)} />
+          <View
+            className="max-h-[78%] rounded-t-[28px] px-4 pt-3"
+            style={{ backgroundColor: sheetColor, paddingBottom: Math.max(insets.bottom, 16) }}
+          >
+            <View className="mb-4 h-1 w-10 self-center rounded-full bg-neutral-400/40" />
+            <View className="mb-3 flex-row items-center justify-between px-1">
+              <View>
+                <Text className="font-t3-bold text-lg text-foreground">Thread lineage</Text>
+                <Text className="text-xs text-foreground-muted">
+                  {rows.length} related {rows.length === 1 ? "thread" : "threads"}
+                </Text>
+              </View>
+              <Pressable
+                accessibilityRole="button"
+                accessibilityLabel="Close thread lineage"
+                onPress={() => setVisible(false)}
+                className="h-10 w-10 items-center justify-center rounded-full bg-adaptive-neutral-200-a70-white-a8"
+              >
+                <SymbolView name="xmark" size={14} tintColor={iconColor} type="monochrome" />
+              </Pressable>
+            </View>
+
+            <ScrollView contentContainerStyle={{ gap: 8 }} showsVerticalScrollIndicator={false}>
+              {rows.map(({ threadId, edge }) => {
+                const node = graph.nodes.get(threadId);
+                const availability = threadAvailability(
+                  node?.thread ?? null,
+                  node?.missing ?? true,
+                );
+                const archivedThread = availability === "Archived";
+                const disabled = availability === "Unavailable" || availability === "Deleted";
+                return (
+                  <Pressable
+                    key={`${edge.kind}:${threadId}`}
+                    accessibilityRole={disabled ? undefined : "link"}
+                    accessibilityState={{ disabled }}
+                    disabled={disabled}
+                    onPress={() => openThread(threadId, archivedThread)}
+                    className="min-h-14 flex-row items-center gap-3 rounded-2xl border border-adaptive-neutral-300-a60-white-a12 bg-card px-3 py-2.5"
+                  >
+                    <View className="h-8 w-8 items-center justify-center rounded-full bg-adaptive-neutral-200-a70-white-a8">
+                      <SymbolView
+                        name={relationshipSymbol(edge)}
+                        size={14}
+                        tintColor={iconColor}
+                        type="monochrome"
+                      />
+                    </View>
+                    <View className="min-w-0 flex-1">
+                      <Text className="text-3xs uppercase tracking-wide text-foreground-muted">
+                        {relationshipLabel(edge, props.threadId)}
+                      </Text>
+                      <Text className="font-t3-medium text-sm text-foreground" numberOfLines={1}>
+                        {node?.thread?.title ?? threadId}
+                      </Text>
+                    </View>
+                    {availability ? (
+                      <Text className="text-2xs text-foreground-muted">{availability}</Text>
+                    ) : (
+                      <SymbolView
+                        name="chevron.right"
+                        size={12}
+                        tintColor={iconColor}
+                        type="monochrome"
+                      />
+                    )}
+                  </Pressable>
+                );
+              })}
+            </ScrollView>
+
+            {canMerge || canDetach ? (
+              <View className="mt-4 gap-2 border-t border-adaptive-neutral-300-a60-white-a12 pt-4">
+                {canMerge ? (
+                  <Pressable
+                    accessibilityRole="button"
+                    disabled={busyAction !== null}
+                    onPress={() => void merge()}
+                    className="min-h-11 flex-row items-center justify-center gap-2 rounded-xl bg-primary px-3"
+                  >
+                    {busyAction === "merge" ? (
+                      <ActivityIndicator color="white" />
+                    ) : (
+                      <SymbolView name="arrow.triangle.merge" size={14} tintColor="white" />
+                    )}
+                    <Text className="font-t3-medium text-sm text-primary-foreground">
+                      Merge back to source
+                    </Text>
+                  </Pressable>
+                ) : null}
+                {canDetach ? (
+                  <Pressable
+                    accessibilityRole="button"
+                    disabled={busyAction !== null}
+                    onPress={() => void detach()}
+                    className="min-h-11 flex-row items-center justify-center gap-2 rounded-xl border border-adaptive-neutral-300-a60-white-a12 px-3"
+                  >
+                    {busyAction === "detach" ? <ActivityIndicator /> : null}
+                    <Text className="font-t3-medium text-sm text-foreground">
+                      Disconnect agent session
+                    </Text>
+                  </Pressable>
+                ) : null}
+              </View>
+            ) : null}
+          </View>
+        </View>
+      </Modal>
+    </>
+  );
+}
diff --git a/apps/mobile/src/features/threads/ThreadRouteScreen.tsx b/apps/mobile/src/features/threads/ThreadRouteScreen.tsx
index cad1cab8e602..3af9ecf8dc46 100644
--- a/apps/mobile/src/features/threads/ThreadRouteScreen.tsx
+++ b/apps/mobile/src/features/threads/ThreadRouteScreen.tsx
@@ -8,10 +8,6 @@ import {
 import { useCallback, useEffect, useMemo, useRef, useState, type ReactNode } from "react";
 import * as Option from "effect/Option";
 import { EnvironmentId, ThreadId, type ProjectScript } from "@t3tools/contracts";
-import {
-  requestOlderThreadTurns,
-  threadHasOlderTurns,
-} from "@t3tools/client-runtime/state/threads";
 import { projectScriptCwd, projectScriptRuntimeEnv } from "@t3tools/shared/projectScripts";
 import { Platform, ScrollView, View } from "react-native";
 import { useSafeAreaInsets } from "react-native-safe-area-context";
@@ -194,26 +190,36 @@ function ThreadRouteContent(
     useThreadSelection();
   const selectedThreadDetailState = props.selectedThreadDetailState;
   const selectedThreadDetail = Option.getOrNull(selectedThreadDetailState.data);
-  // "Load earlier turns" header state for windowed (paginated) thread loads.
-  const loadEarlierTurns = useMemo(() => {
-    if (selectedThread === null || !threadHasOlderTurns(selectedThreadDetailState)) {
-      return null;
-    }
-    return {
-      loading:
-        selectedThreadDetailState.page._tag === "Some" &&
-        selectedThreadDetailState.page.value.loadingOlder,
-      onLoadEarlier: () => {
-        requestOlderThreadTurns(selectedThread.environmentId, selectedThread.id);
-      },
-    };
-  }, [selectedThread, selectedThreadDetailState]);
   const { selectedThreadCwd } = useSelectedThreadWorktree();
   const composer = useThreadComposerState();
   const gitState = useSelectedThreadGitState();
   const gitActions = useSelectedThreadGitActions();
   const requests = useSelectedThreadRequests();
   const interruptThreadTurn = useAtomCommand(threadEnvironment.interruptTurn, "thread interrupt");
+  const loadEarlierHistory = useAtomCommand(threadEnvironment.loadEarlierHistory, {
+    label: "load earlier thread history",
+    reportFailure: false,
+  });
+  const historyControls = useMemo(() => {
+    const history = selectedThreadDetailState.history;
+    if (!selectedThread) {
+      return undefined;
+    }
+    if (!history.hasMoreHistory && history.error === null) {
+      return undefined;
+    }
+    return {
+      hasMoreHistory: history.hasMoreHistory,
+      loading: history.loading,
+      error: history.error,
+      onLoadEarlier: () => {
+        void loadEarlierHistory({
+          environmentId: selectedThread.environmentId,
+          input: { threadId: selectedThread.id },
+        });
+      },
+    };
+  }, [loadEarlierHistory, selectedThread, selectedThreadDetailState.history]);
   const navigation = useNavigation();
   const params = props.route.params;
   const environmentIdRaw = firstRouteParam(params.environmentId);
@@ -325,7 +331,7 @@ function ThreadRouteContent(
       }),
     [knownTerminalSessions, selectedThreadProject?.workspaceRoot],
   );
-  const selectedThreadDetailWorktreePath = selectedThreadDetail?.worktreePath ?? null;
+  const selectedThreadDetailWorktreePath = selectedThreadDetail?.thread.worktreePath ?? null;
   const handleReconnectEnvironment = useCallback(() => {
     if (!environmentId) {
       return;
@@ -479,23 +485,17 @@ function ThreadRouteContent(
     void navigation.navigate("Connections");
   }, [navigation]);
   const handleStopThread = useCallback(() => {
-    if (
-      !selectedThread ||
-      (selectedThread.session?.status !== "running" &&
-        selectedThread.session?.status !== "starting")
-    ) {
+    if (!selectedThread || composer.interruptibleRunId === null) {
       return;
     }
     return interruptThreadTurn({
       environmentId: selectedThread.environmentId,
       input: {
         threadId: selectedThread.id,
-        ...(selectedThread.session.activeTurnId
-          ? { turnId: selectedThread.session.activeTurnId }
-          : {}),
+        runId: composer.interruptibleRunId,
       },
     });
-  }, [interruptThreadTurn, selectedThread]);
+  }, [composer.interruptibleRunId, interruptThreadTurn, selectedThread]);
 
   const handleOpenTerminal = useCallback(
     (nextTerminalId?: string | null) => {
@@ -773,6 +773,7 @@ function ThreadRouteContent(
           connectionError={routeConnectionError}
           environmentLabel={selectedEnvironmentConnection?.environmentLabel ?? null}
           selectedThreadFeed={composer.selectedThreadFeed}
+          activityRun={composer.selectedThreadActivityRun}
           activeWorkStartedAt={composer.activeWorkStartedAt}
           activePendingApproval={requests.activePendingApproval}
           respondingApprovalId={requests.respondingApprovalId}
@@ -784,7 +785,9 @@ function ThreadRouteContent(
           draftAttachments={composer.draftAttachments}
           connectionStateLabel={routeConnectionState}
           threadSyncStatus={selectedThreadDetailState.status}
-          loadEarlier={loadEarlierTurns}
+          historyControls={historyControls}
+          activeThreadBusy={composer.activeThreadBusy}
+          canStopThread={composer.interruptibleRunId !== null}
           environmentId={selectedThread.environmentId}
           projectWorkspaceRoot={selectedThreadProject?.workspaceRoot ?? null}
           threadCwd={selectedThreadCwd}
diff --git a/apps/mobile/src/features/threads/thread-activity-row-presentation.test.ts b/apps/mobile/src/features/threads/thread-activity-row-presentation.test.ts
new file mode 100644
index 000000000000..05ab59b5e96d
--- /dev/null
+++ b/apps/mobile/src/features/threads/thread-activity-row-presentation.test.ts
@@ -0,0 +1,42 @@
+import { ProviderDriverKind, ProviderInstanceId } from "@t3tools/contracts";
+import { describe, expect, it } from "vite-plus/test";
+
+import {
+  resolveThreadActivityMetadata,
+  resolveThreadActivityStatus,
+} from "./thread-activity-row-presentation";
+
+describe("thread activity row presentation", () => {
+  it("shows the provider and model as compact metadata", () => {
+    expect(
+      resolveThreadActivityMetadata({
+        providerDriver: ProviderDriverKind.make("codex"),
+        providerInstanceId: ProviderInstanceId.make("codex"),
+        model: "gpt-5.4",
+      }),
+    ).toBe("Codex · gpt-5.4");
+  });
+
+  it("falls back to the provider instance and removes duplicate metadata", () => {
+    expect(
+      resolveThreadActivityMetadata({
+        providerDriver: null,
+        providerInstanceId: ProviderInstanceId.make("custom-agent"),
+        model: "custom-agent",
+      }),
+    ).toBe("custom-agent");
+  });
+
+  it("maps lifecycle status to dot tone and an accessible label", () => {
+    expect(resolveThreadActivityStatus("running")).toEqual({ label: "Running", tone: "active" });
+    expect(resolveThreadActivityStatus("completed")).toEqual({
+      label: "Completed",
+      tone: "success",
+    });
+    expect(resolveThreadActivityStatus("failed")).toEqual({ label: "Failed", tone: "danger" });
+    expect(resolveThreadActivityStatus("interrupted")).toEqual({
+      label: "Interrupted",
+      tone: "warning",
+    });
+  });
+});
diff --git a/apps/mobile/src/features/threads/thread-activity-row-presentation.ts b/apps/mobile/src/features/threads/thread-activity-row-presentation.ts
new file mode 100644
index 000000000000..8d972c8389a3
--- /dev/null
+++ b/apps/mobile/src/features/threads/thread-activity-row-presentation.ts
@@ -0,0 +1,40 @@
+import {
+  PROVIDER_DISPLAY_NAMES,
+  type OrchestrationV2TurnItem,
+  type ProviderDriverKind,
+  type ProviderInstanceId,
+} from "@t3tools/contracts";
+
+export function resolveThreadActivityMetadata(input: {
+  readonly providerDriver: ProviderDriverKind | null;
+  readonly providerInstanceId: ProviderInstanceId | null;
+  readonly model: string | null;
+}): string {
+  const providerLabel = input.providerDriver
+    ? (PROVIDER_DISPLAY_NAMES[input.providerDriver] ?? input.providerInstanceId)
+    : input.providerInstanceId;
+  const values = [providerLabel, input.model].filter(
+    (value): value is string => value !== null && value.length > 0,
+  );
+  return [...new Set(values)].join(" · ");
+}
+
+export function resolveThreadActivityStatus(status: OrchestrationV2TurnItem["status"]): {
+  readonly label: string;
+  readonly tone: "active" | "danger" | "success" | "warning";
+} {
+  const label = status.charAt(0).toUpperCase() + status.slice(1).replaceAll("_", " ");
+  switch (status) {
+    case "completed":
+      return { label, tone: "success" };
+    case "failed":
+      return { label, tone: "danger" };
+    case "cancelled":
+    case "interrupted":
+      return { label, tone: "warning" };
+    case "pending":
+    case "running":
+    case "waiting":
+      return { label, tone: "active" };
+  }
+}
diff --git a/apps/mobile/src/features/threads/thread-feed-item-size.test.ts b/apps/mobile/src/features/threads/thread-feed-item-size.test.ts
new file mode 100644
index 000000000000..5d5d2bc59b71
--- /dev/null
+++ b/apps/mobile/src/features/threads/thread-feed-item-size.test.ts
@@ -0,0 +1,15 @@
+import { describe, expect, it } from "vite-plus/test";
+
+import { resolveThreadFeedFixedItemSize } from "./thread-feed-item-size";
+
+describe("resolveThreadFeedFixedItemSize", () => {
+  it("leaves activity groups to native measurement", () => {
+    expect(resolveThreadFeedFixedItemSize("activity-group", 16)).toBeUndefined();
+  });
+
+  it("keeps fixed timeline chrome on the premeasured path", () => {
+    expect(resolveThreadFeedFixedItemSize("run-fold", 16)).toBe(56);
+    expect(resolveThreadFeedFixedItemSize("work-toggle", 16)).toBe(36);
+    expect(resolveThreadFeedFixedItemSize("working", 16)).toBeGreaterThan(24);
+  });
+});
diff --git a/apps/mobile/src/features/threads/thread-feed-item-size.ts b/apps/mobile/src/features/threads/thread-feed-item-size.ts
new file mode 100644
index 000000000000..55a96b8c1c93
--- /dev/null
+++ b/apps/mobile/src/features/threads/thread-feed-item-size.ts
@@ -0,0 +1,30 @@
+import type { ThreadFeedEntry } from "../../lib/threadActivity";
+import { scaledTypographyLineHeight } from "../../lib/appearancePreferences";
+import { MOBILE_TYPOGRAPHY } from "../../lib/typography";
+
+// These rows are pure timeline chrome whose rendered height is independent of
+// their content. Content-driven rows must be measured by LegendList: returning
+// a fixed size makes the list skip native measurement entirely.
+const TURN_FOLD_HEIGHT = 56;
+const WORK_GROUP_TOGGLE_HEIGHT = 36;
+const WORKING_ROW_VERTICAL_EXTRAS = 24;
+
+export function resolveThreadFeedFixedItemSize(
+  entryType: ThreadFeedEntry["type"],
+  baseFontSize: number,
+): number | undefined {
+  switch (entryType) {
+    case "run-fold":
+      return TURN_FOLD_HEIGHT;
+    case "work-toggle":
+      return WORK_GROUP_TOGGLE_HEIGHT;
+    case "working":
+      return (
+        WORKING_ROW_VERTICAL_EXTRAS +
+        scaledTypographyLineHeight(MOBILE_TYPOGRAPHY.label, baseFontSize)
+      );
+    case "activity-group":
+    case "message":
+      return undefined;
+  }
+}
diff --git a/apps/mobile/src/features/threads/thread-list-v2-items.tsx b/apps/mobile/src/features/threads/thread-list-v2-items.tsx
index 51b1ed7afcdb..5c8c000e79a3 100644
--- a/apps/mobile/src/features/threads/thread-list-v2-items.tsx
+++ b/apps/mobile/src/features/threads/thread-list-v2-items.tsx
@@ -24,10 +24,11 @@ import { useAppearancePreferences } from "../settings/appearance/AppearancePrefe
 import { buildThreadTitleRegenerationMenuItems } from "./thread-title-regeneration-menu";
 import {
   resolveThreadListV2ChangeRequestState,
-  resolveThreadListV2SnoozeMenuSelection,
   resolveThreadListV2SnoozeGateExpiryMs,
+  resolveThreadListV2SnoozeMenuSelection,
   resolveThreadListV2Status,
   resolveThreadListV2SwipeActions,
+  threadHasUnseenCompletion,
   type ThreadListV2ChangeRequestState,
   type ThreadListV2Status,
 } from "./threadListV2";
@@ -426,7 +427,13 @@ export const ThreadListV2Row = memo(function ThreadListV2Row(props: {
   const selected = props.selected === true;
 
   const status = resolveThreadListV2Status(thread);
-  const statusLabel = STATUS_LABEL_BY_STATUS[status];
+  // "Done" marks a completion the user has not opened yet — same emerald
+  // label as the web sidebar, sourced from the server-side visited watermark
+  // so checking a thread on any device clears it everywhere.
+  const isUnread = status === "ready" && threadHasUnseenCompletion(thread);
+  const statusLabel =
+    STATUS_LABEL_BY_STATUS[status] ??
+    (isUnread ? { label: "Done", className: "text-adaptive-emerald-700-300" } : undefined);
   const timeLabel = threadTimeLabel(thread);
 
   const handleDelete = useCallback(() => onDeleteThread(thread), [onDeleteThread, thread]);
@@ -735,7 +742,7 @@ export const ThreadListV2Row = memo(function ThreadListV2Row(props: {
         </View>
       ) : null}
       <View className="mt-1 flex-row items-center gap-2">
-        {status === "failed" && thread.session?.lastError ? (
+        {status === "failed" && thread.runtime?.lastError ? (
           <Text
             className={cn(
               "flex-1 text-xs",
@@ -743,7 +750,7 @@ export const ThreadListV2Row = memo(function ThreadListV2Row(props: {
             )}
             numberOfLines={1}
           >
-            {thread.session.lastError}
+            {thread.runtime.lastError}
           </Text>
         ) : thread.branch || props.environmentLabel ? (
           /* "branch · machine" share one truncating line. The machine sits
diff --git a/apps/mobile/src/features/threads/thread-work-log-labels.test.ts b/apps/mobile/src/features/threads/thread-work-log-labels.test.ts
new file mode 100644
index 000000000000..eb4d621abb40
--- /dev/null
+++ b/apps/mobile/src/features/threads/thread-work-log-labels.test.ts
@@ -0,0 +1,15 @@
+import { describe, expect, it } from "vite-plus/test";
+
+import { threadWorkLogOverflowNoun } from "./thread-work-log-labels";
+
+describe("thread work log overflow labels", () => {
+  it("describes tool-only groups as tool calls", () => {
+    expect(threadWorkLogOverflowNoun(true, 1)).toBe("tool call");
+    expect(threadWorkLogOverflowNoun(true, 2)).toBe("tool calls");
+  });
+
+  it("describes mixed groups as log entries", () => {
+    expect(threadWorkLogOverflowNoun(false, 1)).toBe("log entry");
+    expect(threadWorkLogOverflowNoun(false, 2)).toBe("log entries");
+  });
+});
diff --git a/apps/mobile/src/features/threads/thread-work-log-labels.ts b/apps/mobile/src/features/threads/thread-work-log-labels.ts
new file mode 100644
index 000000000000..bff7f22fc484
--- /dev/null
+++ b/apps/mobile/src/features/threads/thread-work-log-labels.ts
@@ -0,0 +1,9 @@
+export function threadWorkLogOverflowNoun(
+  onlyToolRows: boolean,
+  count: number,
+): "tool call" | "tool calls" | "log entry" | "log entries" {
+  if (onlyToolRows) {
+    return count === 1 ? "tool call" : "tool calls";
+  }
+  return count === 1 ? "log entry" : "log entries";
+}
diff --git a/apps/mobile/src/features/threads/thread-work-log.tsx b/apps/mobile/src/features/threads/thread-work-log.tsx
index 192d82f92cbf..302d9d277a47 100644
--- a/apps/mobile/src/features/threads/thread-work-log.tsx
+++ b/apps/mobile/src/features/threads/thread-work-log.tsx
@@ -1,14 +1,24 @@
 import * as Haptics from "expo-haptics";
+import { Image } from "expo-image";
 import { type AppSymbolName, SymbolView } from "../../components/AppSymbol";
-import { LayoutAnimation, Pressable, ScrollView, View } from "react-native";
+import type { EnvironmentId, ThreadId } from "@t3tools/contracts";
+import { useNavigation } from "@react-navigation/native";
+import { LayoutAnimation, Pressable, View } from "react-native";
 
 import { AppText as Text } from "../../components/AppText";
-import { scaledTypographyLineHeight } from "../../lib/appearancePreferences";
+import { T3_CODE_BRAND_MARK_SOURCE } from "../../components/brandAssets";
 import { cn } from "../../lib/cn";
-import type { ThreadFeedActivity } from "../../lib/threadActivity";
-import { MOBILE_TYPOGRAPHY } from "../../lib/typography";
+import { threadFeedActivityIsVisible, type ThreadFeedActivity } from "../../lib/threadActivity";
 import Animated, { FadeIn } from "react-native-reanimated";
+import { useV2ItemSupport } from "../../state/v2-item-support";
+import { ThreadActivityInspector } from "./ThreadActivityInspector";
+import {
+  resolveThreadActivityMetadata,
+  resolveThreadActivityStatus,
+} from "./thread-activity-row-presentation";
+import { threadWorkLogOverflowNoun } from "./thread-work-log-labels";
 
+const MAX_VISIBLE_WORK_LOG_ENTRIES = 1;
 const WORK_LOG_LAYOUT_ANIMATION = {
   duration: 180,
   create: {
@@ -71,6 +81,121 @@ function workRowSymbolName(icon: ThreadFeedActivity["icon"]): AppSymbolName {
   }
 }
 
+function WorkRowIcon(props: {
+  readonly row: ThreadFeedActivity;
+  readonly iconSubtleColor: import("react-native").ColorValue;
+}) {
+  const iconIsDestructive = props.row.icon === "alert" || props.row.icon === "warning";
+  if (props.row.logo === "t3-code") {
+    return (
+      <Image
+        source={T3_CODE_BRAND_MARK_SOURCE}
+        accessibilityIgnoresInvertColors
+        style={{
+          width: 16,
+          height: 16,
+          borderRadius: 4,
+        }}
+      />
+    );
+  }
+
+  return (
+    <SymbolView
+      name={workRowSymbolName(props.row.icon)}
+      size={14}
+      weight="medium"
+      tintColor={iconIsDestructive ? "#e11d48" : props.iconSubtleColor}
+      type="monochrome"
+    />
+  );
+}
+
+function ThreadActivityThreadRow(props: {
+  readonly activity: ThreadFeedActivity;
+  readonly environmentId: EnvironmentId;
+  readonly iconColor: import("react-native").ColorValue;
+}) {
+  const row = props.activity.projectedItem;
+  const support = useV2ItemSupport({
+    environmentId: props.environmentId,
+    sourceThreadId: row.sourceThreadId,
+    sourceItemId: row.sourceItemId,
+  });
+  const navigation = useNavigation();
+  const item = row.item;
+  let targetThreadId: ThreadId | null = null;
+  let label = "Open related thread";
+  let providerDriver = support.providerSession?.driver ?? null;
+  let providerInstanceId = support.providerSession?.providerInstanceId ?? null;
+  let model = support.providerSession?.model ?? null;
+
+  if (item.type === "thread_created") {
+    targetThreadId = item.targetThreadId;
+    label = "Open created thread";
+    providerInstanceId = item.targetProviderInstanceId;
+    model = item.targetModel;
+  } else if (item.type === "subagent") {
+    targetThreadId = support.subagent?.childThreadId ?? item.childThreadId;
+    label = "Open subagent thread";
+    providerDriver = support.subagent?.driver ?? item.driver;
+    providerInstanceId = support.subagent?.providerInstanceId ?? item.providerInstanceId;
+    model = support.subagent?.model ?? model;
+  } else if (item.type === "fork") {
+    targetThreadId =
+      item.targetThreadId === row.sourceThreadId && item.source.type === "run"
+        ? item.source.threadId
+        : item.targetThreadId;
+    label = targetThreadId === item.targetThreadId ? "Open forked thread" : "Open parent thread";
+  }
+
+  const metadata = resolveThreadActivityMetadata({ providerDriver, providerInstanceId, model });
+  const status = resolveThreadActivityStatus(item.status);
+  const statusDotClassName =
+    status.tone === "success"
+      ? "bg-emerald-500"
+      : status.tone === "danger"
+        ? "bg-rose-500"
+        : status.tone === "warning"
+          ? "bg-amber-500"
+          : "bg-sky-500";
+
+  return (
+    <View className="mb-2 min-h-11 flex-row items-center gap-2 rounded-xl border border-continuous border-adaptive-neutral-950-a10-white-a10 bg-card px-2.5 py-1.5">
+      <View
+        accessible
+        accessibilityRole="text"
+        accessibilityLabel={status.label}
+        className={cn("size-2 shrink-0 rounded-full", statusDotClassName)}
+      />
+
+      <Text className="min-w-0 flex-1 text-sm text-foreground" numberOfLines={1}>
+        <Text className="font-t3-medium text-foreground">{props.activity.summary}</Text>
+        {metadata ? <Text className="text-foreground-muted opacity-60"> · {metadata}</Text> : null}
+      </Text>
+
+      <Pressable
+        accessibilityRole="link"
+        accessibilityLabel={label}
+        disabled={targetThreadId === null}
+        hitSlop={10}
+        onPress={() => {
+          if (targetThreadId === null) return;
+          void Haptics.selectionAsync();
+          navigation.navigate("Thread", {
+            environmentId: props.environmentId,
+            threadId: targetThreadId,
+          });
+        }}
+        className="h-8 shrink-0 flex-row items-center gap-1 rounded-lg bg-adaptive-neutral-950-a5-white-a5 py-1.5 pl-2.5 pr-1.5 active:bg-adaptive-neutral-950-a10-white-a10 disabled:opacity-40"
+      >
+        <Text className="font-t3-medium text-sm text-foreground">Open</Text>
+        <SymbolView name="arrow.right" size={11} tintColor={props.iconColor} type="monochrome" />
+      </Pressable>
+    </View>
+  );
+}
+
 // Entering fades only for rows created moments ago: rows remount whenever the
 // list scrolls them back into view, and old rows must not replay an entrance.
 const FRESH_ROW_WINDOW_MS = 3_000;
@@ -79,53 +204,26 @@ function isFreshRow(createdAt: string): boolean {
   return Number.isFinite(timestamp) && Date.now() - timestamp < FRESH_ROW_WINDOW_MS;
 }
 
-// Tool-like activities with a neutral status carry no signal worth a row.
+// Routine neutral tool activity carries no signal worth a row. Prominent
+// linked activity stays visible so its live status and thread affordance do.
 export function visibleWorkLogActivities(
   activities: ReadonlyArray<ThreadFeedActivity>,
 ): ReadonlyArray<ThreadFeedActivity> {
-  return activities.filter((activity) => !(activity.toolLike && activity.status === "neutral"));
-}
-
-// Pre-measurement heights for the feed's getFixedItemSize. Collapsed work-log
-// rows are single-line (numberOfLines={1}) inside a min-height that stays
-// taller than the text at every supported base font size (text-xs reaches
-// 23px at the 22pt maximum, under the 32px min-h-8), so row height is
-// deterministic. The "work log" label has no such clamp — its height follows
-// the scaled text-2xs line height. Values mirror the classNames below — keep
-// them in sync; a mismatch only costs a one-time correction on measure.
-const WORK_ROW_HEIGHT = 32; // min-h-8
-const WORK_ROW_GAP = 1; // gap-px
-const WORK_LOG_HEADER_PADDING = 2; // pb-0.5 under the "work log" label
-const WORK_LOG_BOTTOM_MARGIN = 4; // mb-1
-
-export const WORK_GROUP_TOGGLE_HEIGHT = 36; // min-h-8 (32) + mb-1 (4)
-
-export function collapsedWorkLogHeight(
-  activities: ReadonlyArray<ThreadFeedActivity>,
-  baseFontSize: number,
-): number {
-  const rows = visibleWorkLogActivities(activities);
-  if (rows.length === 0) {
-    return 0;
-  }
-  const onlyToolRows = rows.every((row) => row.toolLike);
-  const headerHeight =
-    scaledTypographyLineHeight(MOBILE_TYPOGRAPHY.caption, baseFontSize) + WORK_LOG_HEADER_PADDING;
-  return (
-    WORK_LOG_BOTTOM_MARGIN +
-    (onlyToolRows ? 0 : headerHeight) +
-    rows.length * WORK_ROW_HEIGHT +
-    (rows.length - 1) * WORK_ROW_GAP
-  );
+  return activities.filter(threadFeedActivityIsVisible);
 }
 
 export function ThreadWorkLog(props: {
   readonly activities: ReadonlyArray<ThreadFeedActivity>;
   readonly copiedRowId: string | null;
+  readonly currentThreadId: ThreadId;
+  readonly environmentId: EnvironmentId;
+  readonly expanded: boolean;
   readonly expandedRows: Readonly<Record<string, boolean>>;
   readonly iconSubtleColor: import("react-native").ColorValue;
   readonly onCopyRow: (rowId: string, value: string) => void;
+  readonly onToggleGroup: () => void;
   readonly onToggleRow: (rowId: string) => void;
+  readonly workspaceRoot?: string | null;
 }) {
   const rows = visibleWorkLogActivities(props.activities).map((activity) => ({
     ...activity,
@@ -136,10 +234,15 @@ export function ThreadWorkLog(props: {
     return null;
   }
 
+  const hasOverflow = rows.length > MAX_VISIBLE_WORK_LOG_ENTRIES;
+  const visibleRows =
+    hasOverflow && !props.expanded ? rows.slice(-MAX_VISIBLE_WORK_LOG_ENTRIES) : rows;
+  const hiddenCount = rows.length - visibleRows.length;
   const onlyToolRows = rows.every((row) => row.toolLike);
+  const overflowNoun = threadWorkLogOverflowNoun(onlyToolRows, hiddenCount);
 
   return (
-    <View className="-mx-1 mb-1 px-1 py-0">
+    <View className="-mx-1 mb-3 px-1 py-0.5">
       {!onlyToolRows ? (
         <Text className="px-0.5 pb-0.5 font-t3-medium text-2xs text-foreground-muted opacity-60">
           work log
@@ -147,12 +250,27 @@ export function ThreadWorkLog(props: {
       ) : null}
 
       <View className="gap-px">
-        {rows.map((row) => {
+        {visibleRows.map((row) => {
           const expanded = props.expandedRows[row.id] ?? false;
           const canExpand = row.canExpand;
-          const fullDetail = expanded ? row.getFullDetail() : null;
-          const displayText = row.detail ? `${row.summary} ${row.detail}` : row.summary;
-          const iconIsDestructive = row.icon === "alert" || row.icon === "warning";
+          const detail = compactActivityDetail(row.detail);
+          const displayText = detail ? `${row.summary} ${detail}` : row.summary;
+          const textIsDestructive = row.icon === "alert" || row.icon === "warning";
+
+          if (row.prominent) {
+            return (
+              <Animated.View
+                key={row.id}
+                {...(isFreshRow(row.createdAt) ? { entering: FadeIn.duration(200) } : {})}
+              >
+                <ThreadActivityThreadRow
+                  activity={row}
+                  environmentId={props.environmentId}
+                  iconColor={props.iconSubtleColor}
+                />
+              </Animated.View>
+            );
+          }
 
           return (
             <Animated.View
@@ -178,28 +296,22 @@ export function ThreadWorkLog(props: {
                 onLongPress={() => props.onCopyRow(row.id, row.getCopyText())}
                 className="rounded-md px-0.5 py-0 active:bg-subtle"
               >
-                <View className="min-h-8 flex-row items-center gap-1.5">
-                  <View className="h-[18px] w-5 shrink-0 items-center justify-center">
-                    <SymbolView
-                      name={workRowSymbolName(row.icon)}
-                      size={13}
-                      weight="medium"
-                      tintColor={iconIsDestructive ? "#e11d48" : props.iconSubtleColor}
-                      type="monochrome"
-                    />
+                <View className="min-h-9 flex-row items-center gap-1.5">
+                  <View className="h-5 w-5 shrink-0 items-center justify-center">
+                    <WorkRowIcon row={row} iconSubtleColor={props.iconSubtleColor} />
                   </View>
 
                   <Text className="min-w-0 flex-1 text-xs text-foreground" numberOfLines={1}>
                     <Text
                       className={cn(
                         "font-t3-medium text-foreground",
-                        iconIsDestructive && "text-adaptive-rose-600-400",
+                        textIsDestructive && "text-adaptive-rose-600-400",
                       )}
                     >
                       {row.summary}
                     </Text>
-                    {row.detail ? (
-                      <Text className="text-foreground-muted opacity-60"> {row.detail}</Text>
+                    {detail ? (
+                      <Text className="text-foreground-muted opacity-60"> {detail}</Text>
                     ) : null}
                   </Text>
 
@@ -243,28 +355,53 @@ export function ThreadWorkLog(props: {
                 </View>
               </Pressable>
 
-              {fullDetail ? (
-                <View className="ml-7 border-l border-adaptive-neutral-300-a60-white-a12 pb-1 pl-3 pt-0.5">
-                  <ScrollView
-                    nestedScrollEnabled
-                    directionalLockEnabled
-                    showsVerticalScrollIndicator
-                    className="max-h-60"
-                    contentContainerStyle={{ paddingRight: 8 }}
-                  >
-                    <Text
-                      selectable
-                      className="font-mono text-2xs leading-normal text-foreground-muted"
-                    >
-                      {fullDetail}
-                    </Text>
-                  </ScrollView>
+              {expanded && canExpand ? (
+                <View className="ml-7 border-l border-adaptive-neutral-300-a60-white-a12 pb-1.5 pl-3 pt-0.5">
+                  <ThreadActivityInspector
+                    activity={row}
+                    currentThreadId={props.currentThreadId}
+                    environmentId={props.environmentId}
+                    iconColor={props.iconSubtleColor}
+                    workspaceRoot={props.workspaceRoot}
+                  />
                 </View>
               ) : null}
             </Animated.View>
           );
         })}
       </View>
+
+      {hasOverflow ? (
+        <Pressable
+          accessibilityRole="button"
+          accessibilityState={{ expanded: props.expanded }}
+          accessibilityLabel={
+            props.expanded
+              ? `Show fewer ${overflowNoun}`
+              : `Show ${hiddenCount} previous ${overflowNoun}`
+          }
+          hitSlop={4}
+          onPress={() => {
+            triggerDisclosureFeedback();
+            props.onToggleGroup();
+          }}
+          className="min-h-9 flex-row items-center gap-1.5 rounded-md px-0.5 py-0.5 active:bg-subtle"
+        >
+          <View className="h-5 w-5 items-center justify-center">
+            <SymbolView
+              name={props.expanded ? "chevron.up" : "chevron.down"}
+              size={13}
+              tintColor={props.iconSubtleColor}
+              type="monochrome"
+            />
+          </View>
+          <Text className="font-t3-medium text-xs text-foreground opacity-80">
+            {props.expanded
+              ? `Show fewer ${overflowNoun}`
+              : `+${hiddenCount} previous ${overflowNoun}`}
+          </Text>
+        </Pressable>
+      ) : null}
     </View>
   );
 }
@@ -276,45 +413,33 @@ export function ThreadWorkGroupToggle(props: {
   readonly onlyToolActivities: boolean;
   readonly onToggle: () => void;
 }) {
-  const noun = props.onlyToolActivities
-    ? props.hiddenCount === 1
-      ? "tool call"
-      : "tool calls"
-    : props.hiddenCount === 1
-      ? "log entry"
-      : "log entries";
-  const collapsedLabel = `Show ${props.hiddenCount} previous ${noun}`;
-  const expandedLabel = props.onlyToolActivities
-    ? "Show fewer tool calls"
-    : "Show fewer log entries";
+  const noun = threadWorkLogOverflowNoun(props.onlyToolActivities, props.hiddenCount);
 
   return (
-    <View className="-mx-1 mb-1 px-1 py-0">
+    <View className="-mx-1 mb-1 px-1">
       <Pressable
         accessibilityRole="button"
         accessibilityState={{ expanded: props.expanded }}
-        accessibilityLabel={props.expanded ? expandedLabel : collapsedLabel}
+        accessibilityLabel={
+          props.expanded ? `Show fewer ${noun}` : `Show ${props.hiddenCount} previous ${noun}`
+        }
         hitSlop={4}
         onPress={() => {
-          void Haptics.selectionAsync();
+          triggerDisclosureFeedback();
           props.onToggle();
         }}
         className="min-h-8 flex-row items-center gap-1.5 rounded-md px-0.5 py-0 active:bg-subtle"
       >
         <View className="h-[18px] w-5 items-center justify-center">
           <SymbolView
-            name={
-              props.expanded
-                ? { ios: "chevron.up", android: "keyboard_arrow_up" }
-                : { ios: "chevron.down", android: "keyboard_arrow_down" }
-            }
+            name={props.expanded ? "chevron.up" : "chevron.down"}
             size={12}
             tintColor={props.iconSubtleColor}
             type="monochrome"
           />
         </View>
         <Text className="font-t3-medium text-xs text-foreground opacity-80">
-          {props.expanded ? expandedLabel : `+${props.hiddenCount} previous ${noun}`}
+          {props.expanded ? `Show fewer ${noun}` : `+${props.hiddenCount} previous ${noun}`}
         </Text>
       </Pressable>
     </View>
diff --git a/apps/mobile/src/features/threads/threadActivityFileNavigation.test.ts b/apps/mobile/src/features/threads/threadActivityFileNavigation.test.ts
new file mode 100644
index 000000000000..a8f9343085b8
--- /dev/null
+++ b/apps/mobile/src/features/threads/threadActivityFileNavigation.test.ts
@@ -0,0 +1,26 @@
+import { EnvironmentId, ThreadId } from "@t3tools/contracts";
+import { describe, expect, it } from "@effect/vitest";
+
+import { buildThreadActivityFileParams } from "./threadActivityFileNavigation";
+
+describe("thread activity file navigation", () => {
+  it("keeps inherited activity file links on the currently selected thread", () => {
+    const sourceThreadId = ThreadId.make("source-thread");
+    const currentThreadId = ThreadId.make("current-thread");
+
+    const params = buildThreadActivityFileParams({
+      environmentId: EnvironmentId.make("environment"),
+      currentThreadId,
+      activitySourceThreadId: sourceThreadId,
+      relativePath: "apps/mobile/src/index.ts",
+      line: 12,
+    });
+
+    expect(params).toEqual({
+      environmentId: "environment",
+      threadId: "current-thread",
+      path: ["apps", "mobile", "src", "index.ts"],
+      line: "12",
+    });
+  });
+});
diff --git a/apps/mobile/src/features/threads/threadActivityFileNavigation.ts b/apps/mobile/src/features/threads/threadActivityFileNavigation.ts
new file mode 100644
index 000000000000..21dfc44c0268
--- /dev/null
+++ b/apps/mobile/src/features/threads/threadActivityFileNavigation.ts
@@ -0,0 +1,22 @@
+import type { EnvironmentId, ThreadId } from "@t3tools/contracts";
+
+interface ThreadActivityFileContext {
+  readonly environmentId: EnvironmentId;
+  readonly currentThreadId: ThreadId;
+  readonly activitySourceThreadId: ThreadId;
+  readonly relativePath: string;
+  readonly line?: number | null;
+}
+
+export function buildThreadActivityFileParams(input: ThreadActivityFileContext) {
+  // Activity provenance may come from a parent thread, but file routes stay scoped
+  // to the thread whose workspace is currently selected.
+  return {
+    environmentId: String(input.environmentId),
+    threadId: String(input.currentThreadId),
+    path: input.relativePath.split("/").filter((segment) => segment.length > 0),
+    ...(Number.isFinite(input.line) && Number(input.line) > 0
+      ? { line: String(Math.floor(Number(input.line))) }
+      : {}),
+  };
+}
diff --git a/apps/mobile/src/features/threads/threadForkNavigation.test.ts b/apps/mobile/src/features/threads/threadForkNavigation.test.ts
new file mode 100644
index 000000000000..a56cb3da2e36
--- /dev/null
+++ b/apps/mobile/src/features/threads/threadForkNavigation.test.ts
@@ -0,0 +1,38 @@
+import { describe, expect, it } from "vite-plus/test";
+
+import { waitForThreadShellReady } from "./threadForkNavigation";
+
+describe("waitForThreadShellReady", () => {
+  it("returns true when the forked thread shell arrives before the deadline", async () => {
+    let elapsedMs = 0;
+
+    const ready = await waitForThreadShellReady({
+      read: () => elapsedMs >= 80,
+      timeoutMs: 120,
+      pollIntervalMs: 40,
+      now: () => elapsedMs,
+      delay: async (durationMs) => {
+        elapsedMs += durationMs;
+      },
+    });
+
+    expect(ready).toBe(true);
+  });
+
+  it("returns false instead of navigating when the shell never arrives", async () => {
+    let elapsedMs = 0;
+
+    const ready = await waitForThreadShellReady({
+      read: () => false,
+      timeoutMs: 80,
+      pollIntervalMs: 40,
+      now: () => elapsedMs,
+      delay: async (durationMs) => {
+        elapsedMs += durationMs;
+      },
+    });
+
+    expect(ready).toBe(false);
+    expect(elapsedMs).toBe(80);
+  });
+});
diff --git a/apps/mobile/src/features/threads/threadForkNavigation.ts b/apps/mobile/src/features/threads/threadForkNavigation.ts
new file mode 100644
index 000000000000..97ebf9c97bc0
--- /dev/null
+++ b/apps/mobile/src/features/threads/threadForkNavigation.ts
@@ -0,0 +1,26 @@
+const DEFAULT_TIMEOUT_MS = 2_000;
+const DEFAULT_POLL_INTERVAL_MS = 40;
+
+export async function waitForThreadShellReady(input: {
+  readonly read: () => boolean;
+  readonly timeoutMs?: number;
+  readonly pollIntervalMs?: number;
+  readonly now?: () => number;
+  readonly delay?: (durationMs: number) => Promise<void>;
+}): Promise<boolean> {
+  const now = input.now ?? Date.now;
+  const delay =
+    input.delay ??
+    ((durationMs: number) =>
+      new Promise<void>((resolve) => {
+        setTimeout(resolve, durationMs);
+      }));
+  const deadline = now() + (input.timeoutMs ?? DEFAULT_TIMEOUT_MS);
+  const pollIntervalMs = input.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+
+  while (!input.read() && now() < deadline) {
+    await delay(Math.min(pollIntervalMs, deadline - now()));
+  }
+
+  return input.read();
+}
diff --git a/apps/mobile/src/features/threads/threadListV2.test.ts b/apps/mobile/src/features/threads/threadListV2.test.ts
index 24c07eae6da1..6b912bd5f302 100644
--- a/apps/mobile/src/features/threads/threadListV2.test.ts
+++ b/apps/mobile/src/features/threads/threadListV2.test.ts
@@ -7,16 +7,16 @@ import {
   MessageId,
   ProjectId,
   ProviderInstanceId,
+  RunId,
   ThreadId,
-  TurnId,
 } from "@t3tools/contracts";
 import { describe, expect, it } from "vite-plus/test";
 
 import type { PendingNewTask } from "../../state/use-pending-new-tasks";
+import { makeThreadShellFixture } from "../../test-fixtures";
 import {
   buildThreadListV2Items,
   buildThreadListV2ListItems,
-  resolveThreadListV2ChangeRequestState,
   resolveThreadListV2Enabled,
   resolveThreadListV2SnoozeMenuSelection,
   resolveThreadListV2SnoozeGateExpiryMs,
@@ -30,30 +30,14 @@ const environmentId = EnvironmentId.make("environment-1");
 function makeThread(
   input: Partial<EnvironmentThreadShell> & Pick<EnvironmentThreadShell, "id" | "title">,
 ): EnvironmentThreadShell {
-  return {
+  return makeThreadShellFixture({
     environmentId,
-    projectId: ProjectId.make("project-1"),
-    modelSelection: { instanceId: ProviderInstanceId.make("codex"), model: "gpt-5.4" },
-    runtimeMode: "full-access",
-    interactionMode: "default",
-    branch: null,
-    worktreePath: null,
-    latestTurn: null,
-    createdAt: "2026-06-01T00:00:00.000Z",
-    updatedAt: "2026-06-01T00:00:00.000Z",
-    archivedAt: null,
-    settledOverride: null,
-    settledAt: null,
-    session: null,
-    latestUserMessageAt: null,
-    hasPendingApprovals: false,
-    hasPendingUserInput: false,
-    hasActionableProposedPlan: false,
     ...input,
-  };
+  });
 }
 
 const NOW = "2026-06-02T00:00:00.000Z";
+
 const linkedPullRequest = {
   projectId: ProjectId.make("project-1"),
   repository: "pingdotgg/t3code",
@@ -61,42 +45,6 @@ const linkedPullRequest = {
   url: "https://github.com/pingdotgg/t3code/pull/42",
 };
 
-describe("resolveThreadListV2ChangeRequestState", () => {
-  it("preserves the previous state while a linked pull request reloads", () => {
-    expect(
-      resolveThreadListV2ChangeRequestState({
-        linkedPullRequest,
-        state: null,
-        updatedAt: null,
-      }),
-    ).toBeUndefined();
-  });
-
-  it("clears the previous state after a pull request is unlinked", () => {
-    expect(
-      resolveThreadListV2ChangeRequestState({
-        linkedPullRequest: null,
-        state: null,
-        updatedAt: null,
-      }),
-    ).toBeNull();
-  });
-
-  it("reports a loaded linked pull request", () => {
-    expect(
-      resolveThreadListV2ChangeRequestState({
-        linkedPullRequest,
-        state: "merged",
-        updatedAt: "2026-06-02T00:00:00.000Z",
-      }),
-    ).toEqual({
-      state: "merged",
-      updatedAt: "2026-06-02T00:00:00.000Z",
-      linkedPullRequestKey: '["project-1","pingdotgg/t3code",42]',
-    });
-  });
-});
-
 describe("resolveThreadListV2SnoozeMenuSelection", () => {
   it("accepts a displayed evening preset while its wake time is still future", () => {
     const menuOpenedAt = new Date(2026, 4, 8, 16, 59, 30);
@@ -169,18 +117,16 @@ describe("resolveThreadListV2Enabled", () => {
 });
 
 describe("resolveThreadListV2Status", () => {
-  it("prioritizes approval over a running session", () => {
+  it("prioritizes approval over a running runtime", () => {
     const thread = makeThread({
       id: ThreadId.make("t"),
       title: "t",
       hasPendingApprovals: true,
-      session: {
-        threadId: ThreadId.make("t"),
+      runtime: {
         status: "running",
+        activeRunId: RunId.make("run-t"),
         providerName: "Codex",
         providerInstanceId: ProviderInstanceId.make("codex"),
-        runtimeMode: "full-access",
-        activeTurnId: null,
         lastError: null,
         updatedAt: NOW,
       },
@@ -188,6 +134,26 @@ describe("resolveThreadListV2Status", () => {
     expect(resolveThreadListV2Status(thread)).toBe("approval");
   });
 
+  it("reports waiting when presentation parks runtime idle for background tasks", () => {
+    expect(
+      resolveThreadListV2Status(
+        makeThread({
+          id: ThreadId.make("t"),
+          title: "t",
+          pendingBackgroundTasks: [{ taskId: "bg-1", description: "Run Codex review" }],
+          runtime: {
+            status: "idle",
+            activeRunId: null,
+            providerInstanceId: ProviderInstanceId.make("codex"),
+            providerName: "Codex",
+            lastError: null,
+            updatedAt: NOW,
+          },
+        }),
+      ),
+    ).toBe("waiting");
+  });
+
   it("resolves ready for quiescent threads", () => {
     expect(resolveThreadListV2Status(makeThread({ id: ThreadId.make("t"), title: "t" }))).toBe(
       "ready",
@@ -303,22 +269,71 @@ describe("sortThreadsForListV2", () => {
     ]);
     expect(sorted.map((thread) => thread.id)).toEqual(["newest", "middle", "oldest"]);
   });
-
-  it("surfaces an un-settled thread at the top via its re-entry stamp", () => {
-    const sorted = sortThreadsForListV2([
-      {
-        id: "old-unsettled",
-        createdAt: "2026-06-01T08:00:00.000Z",
-        unsettledAt: "2026-06-01T13:00:00.000Z",
-      },
-      { id: "newest", createdAt: "2026-06-01T12:00:00.000Z" },
-      { id: "middle", createdAt: "2026-06-01T10:00:00.000Z" },
-    ]);
-    expect(sorted.map((thread) => thread.id)).toEqual(["old-unsettled", "newest", "middle"]);
-  });
 });
 
 describe("buildThreadListV2Items", () => {
+  it("excludes subagent child threads from top-level rows and counts", () => {
+    const rootThreadId = ThreadId.make("root");
+    const activeChildId = ThreadId.make("active-child");
+    const forkId = ThreadId.make("fork");
+    const settledChildId = ThreadId.make("settled-child");
+    const snoozedChildId = ThreadId.make("snoozed-child");
+    const layout = buildThreadListV2Items({
+      threads: [
+        makeThread({ id: rootThreadId, title: "Root" }),
+        makeThread({
+          id: forkId,
+          title: "Fork",
+          lineage: {
+            rootThreadId,
+            parentThreadId: rootThreadId,
+            relationshipToParent: "fork",
+          },
+        }),
+        makeThread({
+          id: activeChildId,
+          title: "Active child",
+          lineage: {
+            rootThreadId,
+            parentThreadId: rootThreadId,
+            relationshipToParent: "subagent",
+          },
+        }),
+        makeThread({
+          id: settledChildId,
+          title: "Settled child",
+          lineage: {
+            rootThreadId,
+            parentThreadId: rootThreadId,
+            relationshipToParent: "subagent",
+          },
+          settledOverride: "settled",
+          settledAt: "2026-06-01T12:00:00.000Z",
+        }),
+        makeThread({
+          id: snoozedChildId,
+          title: "Snoozed child",
+          lineage: {
+            rootThreadId,
+            parentThreadId: rootThreadId,
+            relationshipToParent: "subagent",
+          },
+          snoozedUntil: "2026-06-03T09:00:00.000Z",
+          snoozedAt: "2026-06-01T12:00:00.000Z",
+        }),
+      ],
+      environmentId: null,
+      searchQuery: "",
+      now: NOW,
+      settledLimit: 0,
+    });
+
+    expect(layout.items.map((item) => item.thread.id)).toEqual([forkId, rootThreadId]);
+    expect(layout.hiddenSettledCount).toBe(0);
+    expect(layout.snoozedCount).toBe(0);
+    expect(layout.nextSnoozeWakeAt).toBeNull();
+  });
+
   it("ignores the previous pull request state after a different pull request is linked", () => {
     const thread = makeThread({
       id: ThreadId.make("linked"),
@@ -371,74 +386,6 @@ describe("buildThreadListV2Items", () => {
     expect(layout.items[0]?.variant).toBe("slim");
   });
 
-  it("keeps a merged thread active when auto-settle on merge is off", () => {
-    const merged = makeThread({ id: ThreadId.make("merged"), title: "Merged" });
-    const layout = buildThreadListV2Items({
-      threads: [merged],
-      environmentId: null,
-      searchQuery: "",
-      changeRequestByKey: new Map([
-        [`${environmentId}:${merged.id}`, { state: "merged" as const }],
-      ]),
-      autoSettleOnMerge: false,
-      now: NOW,
-    });
-
-    expect(layout.items.map((item) => item.thread.id)).toEqual(["merged"]);
-    expect(layout.settledCount).toBe(0);
-  });
-
-  it("hides snoozed threads and counts them — visibility parity with web", () => {
-    const layout = buildThreadListV2Items({
-      threads: [
-        makeThread({ id: ThreadId.make("active"), title: "Active" }),
-        makeThread({
-          id: ThreadId.make("snoozed"),
-          title: "Snoozed",
-          snoozedUntil: "2026-06-03T09:00:00.000Z",
-          snoozedAt: "2026-06-01T12:00:00.000Z",
-        }),
-        makeThread({
-          id: ThreadId.make("woken"),
-          title: "Woken",
-          // Wake time already passed: back in the active list.
-          snoozedUntil: "2026-06-01T18:00:00.000Z",
-          snoozedAt: "2026-06-01T12:00:00.000Z",
-        }),
-      ],
-      environmentId: null,
-      searchQuery: "",
-      now: NOW,
-    });
-
-    // Same createdAt → static sort tiebreaks by id; the point is the woken
-    // thread is BACK in the card block and the snoozed one is gone.
-    expect(layout.items.map((item) => item.thread.id)).toEqual(["active", "woken"]);
-    expect(layout.snoozedCount).toBe(1);
-  });
-
-  it("places settled pinned threads in the settled shelf", () => {
-    const layout = buildThreadListV2Items({
-      threads: [
-        makeThread({ id: ThreadId.make("active"), title: "Active" }),
-        makeThread({
-          id: ThreadId.make("pinned-settled"),
-          title: "Pinned while settled",
-          pinnedAt: "2026-06-01T12:00:00.000Z",
-          settledOverride: "settled",
-          settledAt: "2026-06-01T12:00:00.000Z",
-        }),
-      ],
-      environmentId: null,
-      searchQuery: "",
-      now: NOW,
-    });
-
-    expect(layout.items.map((item) => item.thread.id)).toEqual(["active", "pinned-settled"]);
-    expect(layout.items.map((item) => item.pinned)).toEqual([false, false]);
-    expect(layout.settledCount).toBe(1);
-  });
-
   it("moves pinned threads to the settled shelf when their pull request merges", () => {
     const merged = makeThread({
       id: ThreadId.make("pinned-merged"),
@@ -465,9 +412,9 @@ describe("buildThreadListV2Items", () => {
       title: "Pinned inactive thread",
       createdAt: "2026-05-20T00:00:00.000Z",
       pinnedAt: "2026-05-21T00:00:00.000Z",
-      latestTurn: {
-        turnId: TurnId.make("turn-inactive"),
-        state: "completed",
+      latestRun: {
+        runId: RunId.make("run-inactive"),
+        status: "completed",
         requestedAt: "2026-05-21T00:00:00.000Z",
         startedAt: "2026-05-21T00:00:01.000Z",
         completedAt: "2026-05-21T00:00:02.000Z",
@@ -512,6 +459,77 @@ describe("buildThreadListV2Items", () => {
     expect(layout.settledCount).toBe(0);
   });
 
+  it("keeps a merged thread active when auto-settle on merge is off", () => {
+    const merged = makeThread({ id: ThreadId.make("merged"), title: "Merged" });
+    const layout = buildThreadListV2Items({
+      threads: [merged],
+      environmentId: null,
+      searchQuery: "",
+      changeRequestByKey: new Map([
+        [`${environmentId}:${merged.id}`, { state: "merged" as const }],
+      ]),
+      autoSettleOnMerge: false,
+      now: NOW,
+    });
+
+    expect(layout.items.map((item) => item.thread.id)).toEqual(["merged"]);
+    expect(layout.settledCount).toBe(0);
+  });
+
+  it("hides snoozed threads and counts them — visibility parity with web", () => {
+    const layout = buildThreadListV2Items({
+      threads: [
+        makeThread({ id: ThreadId.make("active"), title: "Active" }),
+        makeThread({
+          id: ThreadId.make("snoozed"),
+          title: "Snoozed",
+          snoozedUntil: "2026-06-03T09:00:00.000Z",
+          snoozedAt: "2026-06-01T12:00:00.000Z",
+        }),
+        makeThread({
+          id: ThreadId.make("woken"),
+          title: "Woken",
+          // Wake time already passed: back in the active list.
+          snoozedUntil: "2026-06-01T18:00:00.000Z",
+          snoozedAt: "2026-06-01T12:00:00.000Z",
+        }),
+      ],
+      environmentId: null,
+      searchQuery: "",
+      now: NOW,
+    });
+
+    // Same createdAt → static sort tiebreaks by id; the point is the woken
+    // thread is BACK in the card block and the snoozed one is gone.
+    expect(layout.items.map((item) => item.thread.id)).toEqual(["active", "woken"]);
+    expect(layout.snoozedCount).toBe(1);
+  });
+
+  it("moves a settled pinned thread into the settled shelf — parity with web (#7969)", () => {
+    const layout = buildThreadListV2Items({
+      threads: [
+        makeThread({ id: ThreadId.make("active"), title: "Active" }),
+        makeThread({
+          id: ThreadId.make("pinned-settled"),
+          title: "Pinned while settled",
+          pinnedAt: "2026-06-01T12:00:00.000Z",
+          // Stale settled state (the decider clears it on pin): the pin wins.
+          settledOverride: "settled",
+          settledAt: "2026-06-01T12:00:00.000Z",
+        }),
+      ],
+      environmentId: null,
+      searchQuery: "",
+      now: NOW,
+    });
+
+    // Since #7969 a settled thread leaves the active block even while pinned;
+    // the pin re-applies when the thread is un-settled.
+    expect(layout.items.map((item) => item.thread.id)).toEqual(["active", "pinned-settled"]);
+    expect(layout.items.map((item) => item.pinned)).toEqual([false, false]);
+    expect(layout.settledCount).toBe(1);
+  });
+
   it("snooze hides a pinned thread and wake restores it to the pinned block", () => {
     const snoozedInput = {
       threads: [
@@ -827,10 +845,11 @@ describe("buildThreadListV2Items", () => {
   });
 
   it("scopes the flat list to one project", () => {
+    const projectId = ProjectId.make("project-1");
     const otherProjectId = ProjectId.make("project-2");
     const { items } = buildThreadListV2Items({
       threads: [
-        makeThread({ id: ThreadId.make("included"), title: "Included" }),
+        makeThread({ id: ThreadId.make("included"), projectId, title: "Included" }),
         makeThread({
           id: ThreadId.make("excluded"),
           projectId: otherProjectId,
@@ -838,7 +857,7 @@ describe("buildThreadListV2Items", () => {
         }),
       ],
       environmentId: null,
-      projectRefs: [{ environmentId, projectId: ProjectId.make("project-1") }],
+      projectRefs: [{ environmentId, projectId }],
       searchQuery: "",
       now: NOW,
     });
@@ -848,19 +867,21 @@ describe("buildThreadListV2Items", () => {
 
   it("scopes the flat list to every environment member of a logical project", () => {
     const remoteEnvironmentId = EnvironmentId.make("environment-remote");
+    const projectId = ProjectId.make("project-1");
     const { items } = buildThreadListV2Items({
       threads: [
-        makeThread({ id: ThreadId.make("local"), title: "Local" }),
+        makeThread({ id: ThreadId.make("local"), projectId, title: "Local" }),
         makeThread({
           environmentId: remoteEnvironmentId,
           id: ThreadId.make("remote"),
+          projectId,
           title: "Remote",
         }),
       ],
       environmentId: null,
       projectRefs: [
-        { environmentId, projectId: ProjectId.make("project-1") },
-        { environmentId: remoteEnvironmentId, projectId: ProjectId.make("project-1") },
+        { environmentId, projectId },
+        { environmentId: remoteEnvironmentId, projectId },
       ],
       searchQuery: "",
       now: NOW,
@@ -883,9 +904,9 @@ describe("buildThreadListV2Items settled paging", () => {
           latestUserMessageAt: `2026-06-01T0${index}:00:00.000Z`,
           // A turn adopted the message (same requestedAt): without it the
           // thread reads as a queued turn start, which never settles.
-          latestTurn: {
-            turnId: TurnId.make(`turn-${index}`),
-            state: "completed",
+          latestRun: {
+            runId: RunId.make(`run-${index}`),
+            status: "completed",
             requestedAt: `2026-06-01T0${index}:00:00.000Z`,
             startedAt: `2026-06-01T0${index}:00:00.000Z`,
             completedAt: `2026-06-01T0${index}:10:00.000Z`,
diff --git a/apps/mobile/src/features/threads/threadListV2.ts b/apps/mobile/src/features/threads/threadListV2.ts
index be3343a21bad..c0782c9d8c6b 100644
--- a/apps/mobile/src/features/threads/threadListV2.ts
+++ b/apps/mobile/src/features/threads/threadListV2.ts
@@ -26,11 +26,13 @@ export { snoozeWakeLabel };
  * Thread List v2 model, ported from the web sidebar v2
  * (apps/web/src/components/Sidebar.logic.ts + SidebarV2.tsx).
  *
- * Four visual states, three colors: color is reserved for "act now"
- * (approval), "in motion" (working), and "broken" (failed). Ready is the
- * unlabeled resting state.
+ * Six visual states. Color distinguishes approval, input, active work, and
+ * failures. Ready is the unlabeled resting state; waiting (runtime status "idle") is the agent
+ * parked on open background tasks, grey like working rather than a false Done.
+ * The orchestrator v2 presentation bridge parks runtime at idle when the
+ * post-settlement background roster is nonempty.
  */
-export type ThreadListV2Status = "approval" | "input" | "working" | "failed" | "ready";
+export type ThreadListV2Status = "approval" | "input" | "working" | "waiting" | "failed" | "ready";
 export type ThreadListV2SwipeAction = "archive" | "settle" | "unsettle" | "snooze" | "unsnooze";
 
 export interface ThreadListV2ChangeRequestState extends ChangeRequestSettleSource {
@@ -120,7 +122,7 @@ export function resolveThreadListV2SwipeActions(input: {
 export function resolveThreadListV2SnoozeGateExpiryMs(
   thread: Pick<
     EnvironmentThreadShell,
-    "hasPendingApprovals" | "hasPendingUserInput" | "latestUserMessageAt" | "latestTurn" | "session"
+    "hasPendingApprovals" | "hasPendingUserInput" | "latestRun" | "latestUserMessageAt" | "runtime"
   >,
   options: { readonly now: string },
 ): number | null {
@@ -157,8 +159,29 @@ export function resolveThreadListV2Enabled(input: {
   return input.legacyPreference !== true;
 }
 
+/**
+ * Completed-but-not-yet-seen, mirroring the web sidebar's
+ * hasUnseenCompletion. The visited watermark is server state
+ * (thread.lastVisitedAt), so the marker agrees across web and mobile.
+ * Never-visited threads count as read — a fresh environment must not light
+ * up its whole history — and pre-tracking servers (field absent) never
+ * report unread.
+ */
+export function threadHasUnseenCompletion(
+  thread: Pick<EnvironmentThreadShell, "latestRun" | "lastVisitedAt">,
+): boolean {
+  const completedAt = thread.latestRun?.completedAt;
+  if (!completedAt) return false;
+  const completedAtMs = Date.parse(completedAt);
+  if (Number.isNaN(completedAtMs)) return false;
+  if (!thread.lastVisitedAt) return false;
+  const lastVisitedAtMs = Date.parse(thread.lastVisitedAt);
+  if (Number.isNaN(lastVisitedAtMs)) return true;
+  return completedAtMs > lastVisitedAtMs;
+}
+
 export function resolveThreadListV2Status(
-  thread: Pick<EnvironmentThreadShell, "hasPendingApprovals" | "hasPendingUserInput" | "session">,
+  thread: Pick<EnvironmentThreadShell, "hasPendingApprovals" | "hasPendingUserInput" | "runtime">,
 ): ThreadListV2Status {
   if (thread.hasPendingApprovals) {
     return "approval";
@@ -166,10 +189,16 @@ export function resolveThreadListV2Status(
   if (thread.hasPendingUserInput) {
     return "input";
   }
-  if (thread.session?.status === "running" || thread.session?.status === "starting") {
+  if (
+    thread.runtime !== null &&
+    ["preparing", "queued", "starting", "running", "waiting"].includes(thread.runtime.status)
+  ) {
     return "working";
   }
-  if (thread.session?.status === "error") {
+  if (thread.runtime?.status === "idle") {
+    return "waiting";
+  }
+  if (thread.runtime?.status === "failed") {
     return "failed";
   }
   return "ready";
@@ -402,6 +431,7 @@ export function buildThreadListV2Items(input: {
   const snoozed: EnvironmentThreadShell[] = [];
   let nextSnoozeWakeAt: string | null = null;
   for (const thread of input.threads) {
+    if (thread.lineage.relationshipToParent === "subagent") continue;
     // Callers pass live (unarchived) shells; settled threads are among them
     // and partition into the tail via effectiveSettled.
     if (input.environmentId !== null && thread.environmentId !== input.environmentId) continue;
diff --git a/apps/mobile/src/features/threads/threadPresentation.ts b/apps/mobile/src/features/threads/threadPresentation.ts
index b91c7152a163..18a92f7a3569 100644
--- a/apps/mobile/src/features/threads/threadPresentation.ts
+++ b/apps/mobile/src/features/threads/threadPresentation.ts
@@ -1,6 +1,8 @@
 import type { StatusTone } from "../../components/StatusPill";
-import type { OrchestrationLatestTurn, OrchestrationSession } from "@t3tools/contracts";
-import { EnvironmentThreadShell } from "@t3tools/client-runtime/state/shell";
+import {
+  threadRuntimeIsActive,
+  type EnvironmentThreadShell,
+} from "@t3tools/client-runtime/state/shell";
 
 export function threadSortValue(thread: EnvironmentThreadShell): number {
   const candidate = Date.parse(thread.updatedAt ?? thread.createdAt);
@@ -31,14 +33,10 @@ export const THREAD_STATUS_NEUTRAL_ICON = {
   iconBackground: "rgba(142,142,147,0.22)",
 } as const;
 
-function isLatestTurnSettled(
-  latestTurn: OrchestrationLatestTurn | null,
-  session: OrchestrationSession | null,
-): boolean {
-  if (!latestTurn?.startedAt) return false;
-  if (!latestTurn.completedAt) return false;
-  if (!session) return true;
-  return session.status !== "running";
+function isLatestRunSettled(thread: EnvironmentThreadShell): boolean {
+  if (!thread.latestRun?.startedAt) return false;
+  if (!thread.latestRun.completedAt) return false;
+  return !threadRuntimeIsActive(thread.runtime);
 }
 
 /**
@@ -73,7 +71,9 @@ export function resolveThreadStatus(
     };
   }
 
-  if (thread.session?.status === "running") {
+  const runtimeStatus = thread.runtime?.status;
+
+  if (runtimeStatus === "running" || runtimeStatus === "waiting") {
     return {
       kind: "working",
       label: "Working",
@@ -85,7 +85,7 @@ export function resolveThreadStatus(
     };
   }
 
-  if (thread.session?.status === "starting") {
+  if (runtimeStatus === "preparing" || runtimeStatus === "queued" || runtimeStatus === "starting") {
     return {
       kind: "connecting",
       label: "Connecting",
@@ -97,7 +97,7 @@ export function resolveThreadStatus(
     };
   }
 
-  if (thread.session?.status === "error" || thread.latestTurn?.state === "error") {
+  if (runtimeStatus === "failed" || thread.latestRun?.status === "failed") {
     return {
       kind: "error",
       label: "Error",
@@ -111,7 +111,7 @@ export function resolveThreadStatus(
 
   const hasPlanReadyPrompt =
     thread.interactionMode === "plan" &&
-    isLatestTurnSettled(thread.latestTurn, thread.session) &&
+    isLatestRunSettled(thread) &&
     thread.hasActionableProposedPlan;
   if (hasPlanReadyPrompt) {
     return {
diff --git a/apps/mobile/src/features/threads/threadQueueControlPresentation.test.ts b/apps/mobile/src/features/threads/threadQueueControlPresentation.test.ts
new file mode 100644
index 000000000000..5e4593557b36
--- /dev/null
+++ b/apps/mobile/src/features/threads/threadQueueControlPresentation.test.ts
@@ -0,0 +1,69 @@
+import { describe, expect, it } from "vite-plus/test";
+
+import {
+  REMOVE_QUEUED_MESSAGE_ACCESSIBILITY_LABEL,
+  buildCancelQueuedRunCommand,
+  resolveThreadQueueRowControls,
+} from "./threadQueueControlPresentation";
+
+describe("threadQueueControlPresentation", () => {
+  it("preserves queue reorder and steer controls with removal", () => {
+    const controls = resolveThreadQueueRowControls({
+      busy: false,
+      canPromoteToSteer: true,
+      canReorder: true,
+      index: 1,
+      queuedCount: 3,
+      text: "Please review the follow-up change.",
+    });
+
+    expect(controls.displayText).toBe("Please review the follow-up change.");
+    expect(controls.canMoveUp).toBe(true);
+    expect(controls.canMoveDown).toBe(true);
+    expect(controls.canSteer).toBe(true);
+    expect(controls.canDismiss).toBe(true);
+    expect(controls.dismissAccessibilityLabel).toBe(REMOVE_QUEUED_MESSAGE_ACCESSIBILITY_LABEL);
+  });
+
+  it("disables edge reorder controls and busy dismissal", () => {
+    const first = resolveThreadQueueRowControls({
+      busy: false,
+      canPromoteToSteer: false,
+      canReorder: true,
+      index: 0,
+      queuedCount: 2,
+      text: "First",
+    });
+    const busy = resolveThreadQueueRowControls({
+      busy: true,
+      canPromoteToSteer: true,
+      canReorder: true,
+      index: 0,
+      queuedCount: 1,
+      text: "Queued message",
+    });
+
+    expect(first.canMoveUp).toBe(false);
+    expect(first.canMoveDown).toBe(true);
+    expect(first.canSteer).toBe(false);
+    expect(busy.canDismiss).toBe(false);
+    expect(busy.canMoveUp).toBe(false);
+    expect(busy.canSteer).toBe(false);
+  });
+
+  it("builds cancelQueuedRun command arguments for removal", () => {
+    expect(
+      buildCancelQueuedRunCommand({
+        environmentId: "environment:test" as never,
+        runId: "run:queued" as never,
+        threadId: "thread:test" as never,
+      }),
+    ).toEqual({
+      environmentId: "environment:test",
+      input: {
+        runId: "run:queued",
+        threadId: "thread:test",
+      },
+    });
+  });
+});
diff --git a/apps/mobile/src/features/threads/threadQueueControlPresentation.ts b/apps/mobile/src/features/threads/threadQueueControlPresentation.ts
new file mode 100644
index 000000000000..def490455d9e
--- /dev/null
+++ b/apps/mobile/src/features/threads/threadQueueControlPresentation.ts
@@ -0,0 +1,52 @@
+import type { EnvironmentId, RunId, ThreadId } from "@t3tools/contracts";
+
+export const REMOVE_QUEUED_MESSAGE_ACCESSIBILITY_LABEL = "Remove queued message";
+
+export interface ThreadQueueRowControls {
+  readonly canDismiss: boolean;
+  readonly canMoveDown: boolean;
+  readonly canMoveUp: boolean;
+  readonly canSteer: boolean;
+  readonly dismissAccessibilityLabel: string;
+  readonly displayText: string;
+}
+
+export function resolveThreadQueueRowControls(input: {
+  readonly busy: boolean;
+  readonly canPromoteToSteer: boolean;
+  readonly canReorder: boolean;
+  readonly index: number;
+  readonly queuedCount: number;
+  readonly text: string;
+}): ThreadQueueRowControls {
+  const mutationEnabled = !input.busy;
+
+  return {
+    canDismiss: !input.busy,
+    canMoveDown: mutationEnabled && input.canReorder && input.index < input.queuedCount - 1,
+    canMoveUp: mutationEnabled && input.canReorder && input.index > 0,
+    canSteer: mutationEnabled && input.canPromoteToSteer,
+    dismissAccessibilityLabel: REMOVE_QUEUED_MESSAGE_ACCESSIBILITY_LABEL,
+    displayText: input.text,
+  };
+}
+
+export function buildCancelQueuedRunCommand(input: {
+  readonly environmentId: EnvironmentId;
+  readonly runId: RunId;
+  readonly threadId: ThreadId;
+}): {
+  readonly environmentId: EnvironmentId;
+  readonly input: {
+    readonly runId: RunId;
+    readonly threadId: ThreadId;
+  };
+} {
+  return {
+    environmentId: input.environmentId,
+    input: {
+      runId: input.runId,
+      threadId: input.threadId,
+    },
+  };
+}
diff --git a/apps/mobile/src/features/threads/userMessageIntentBadge.test.ts b/apps/mobile/src/features/threads/userMessageIntentBadge.test.ts
new file mode 100644
index 000000000000..f29c4bba1643
--- /dev/null
+++ b/apps/mobile/src/features/threads/userMessageIntentBadge.test.ts
@@ -0,0 +1,34 @@
+import { describe, expect, it } from "@effect/vitest";
+
+import { resolveUserMessageIntentBadge } from "./userMessageIntentBadge";
+
+describe("user message intent badge", () => {
+  it("does not label ordinary turn-start messages", () => {
+    expect(resolveUserMessageIntentBadge(undefined)).toBeNull();
+    expect(resolveUserMessageIntentBadge("turn_start")).toBeNull();
+  });
+
+  it("labels messages waiting behind the active turn", () => {
+    expect(resolveUserMessageIntentBadge("queued_turn")).toEqual({
+      label: "queued",
+      accessibilityLabel: "Queued behind the active turn",
+      tone: "queued",
+    });
+  });
+
+  it("labels messages that steer the active turn", () => {
+    expect(resolveUserMessageIntentBadge("steer")).toEqual({
+      label: "steer",
+      accessibilityLabel: "Steered the active turn",
+      tone: "steer",
+    });
+  });
+
+  it("preserves the queued origin after promotion to steer", () => {
+    expect(resolveUserMessageIntentBadge("promoted_queued_to_steer")).toEqual({
+      label: "queued → steer",
+      accessibilityLabel: "Originally queued, then promoted to steer the active turn",
+      tone: "steer",
+    });
+  });
+});
diff --git a/apps/mobile/src/features/threads/userMessageIntentBadge.ts b/apps/mobile/src/features/threads/userMessageIntentBadge.ts
new file mode 100644
index 000000000000..c72c1c342d83
--- /dev/null
+++ b/apps/mobile/src/features/threads/userMessageIntentBadge.ts
@@ -0,0 +1,35 @@
+import type { OrchestrationV2UserMessageInputIntent } from "@t3tools/contracts";
+
+export interface UserMessageIntentBadgePresentation {
+  readonly label: string;
+  readonly accessibilityLabel: string;
+  readonly tone: "queued" | "steer";
+}
+
+export function resolveUserMessageIntentBadge(
+  intent: OrchestrationV2UserMessageInputIntent | undefined,
+): UserMessageIntentBadgePresentation | null {
+  switch (intent) {
+    case "queued_turn":
+      return {
+        label: "queued",
+        accessibilityLabel: "Queued behind the active turn",
+        tone: "queued",
+      };
+    case "steer":
+      return {
+        label: "steer",
+        accessibilityLabel: "Steered the active turn",
+        tone: "steer",
+      };
+    case "promoted_queued_to_steer":
+      return {
+        label: "queued → steer",
+        accessibilityLabel: "Originally queued, then promoted to steer the active turn",
+        tone: "steer",
+      };
+    case "turn_start":
+    case undefined:
+      return null;
+  }
+}
diff --git a/apps/mobile/src/lib/modelOptions.ts b/apps/mobile/src/lib/modelOptions.ts
index 26ffd6855582..8c8f5a66b6be 100644
--- a/apps/mobile/src/lib/modelOptions.ts
+++ b/apps/mobile/src/lib/modelOptions.ts
@@ -1,3 +1,4 @@
+import type { MenuAction } from "@react-native-menu/menu";
 import type {
   ModelCapabilities,
   ModelSelection,
@@ -203,3 +204,53 @@ export function groupByProvider(options: ReadonlyArray<ModelOption>): ReadonlyAr
     models: group.models,
   }));
 }
+
+function modelMenuAction(option: ModelOption, selectedModel: ModelSelection | null): MenuAction {
+  return {
+    id: `model:${option.key}`,
+    title: option.label,
+    state:
+      option.selection.instanceId === selectedModel?.instanceId &&
+      option.selection.model === selectedModel.model
+        ? "on"
+        : undefined,
+  };
+}
+
+export function buildModelMenuActions(
+  groups: ReadonlyArray<ProviderGroup>,
+  selectedModel: ModelSelection | null,
+): MenuAction[] {
+  return groups.flatMap((group) => {
+    const currentModels = group.models.filter((model) => !model.isLegacy);
+    const legacyModels = group.models.filter((model) => model.isLegacy);
+    const selected = group.models.find(
+      (model) =>
+        model.selection.instanceId === selectedModel?.instanceId &&
+        model.selection.model === selectedModel.model,
+    );
+
+    return [
+      ...(currentModels.length > 0
+        ? [
+            {
+              id: `provider:${group.providerKey}`,
+              title: group.providerLabel,
+              subtitle: selected && !selected.isLegacy ? selected.label : undefined,
+              subactions: currentModels.map((option) => modelMenuAction(option, selectedModel)),
+            },
+          ]
+        : []),
+      ...(legacyModels.length > 0
+        ? [
+            {
+              id: `legacy-models:${group.providerKey}`,
+              title: `${group.providerLabel} legacy models`,
+              subtitle: selected?.isLegacy ? selected.label : undefined,
+              subactions: legacyModels.map((option) => modelMenuAction(option, selectedModel)),
+            },
+          ]
+        : []),
+    ];
+  });
+}
diff --git a/apps/mobile/src/lib/projectThreadStartTurn.ts b/apps/mobile/src/lib/projectThreadStartTurn.ts
index 85523175a2f5..37171c2d886f 100644
--- a/apps/mobile/src/lib/projectThreadStartTurn.ts
+++ b/apps/mobile/src/lib/projectThreadStartTurn.ts
@@ -7,19 +7,10 @@ import {
   type ProviderInteractionMode,
   type RuntimeMode,
 } from "@t3tools/contracts";
+import { deriveThreadTitleSeed } from "@t3tools/client-runtime/operations";
 
 import { toUploadChatImageAttachments, type DraftComposerImageAttachment } from "./composerImages";
 
-export function deriveThreadTitleFromPrompt(value: string): string {
-  const trimmed = value.trim();
-  if (trimmed.length === 0) {
-    return "New thread";
-  }
-
-  const compact = trimmed.replace(/\s+/g, " ");
-  return compact.length <= 72 ? compact : `${compact.slice(0, 69).trimEnd()}...`;
-}
-
 export interface ProjectThreadStartTurnSpec {
   readonly projectId: ProjectId;
   readonly projectCwd: string;
@@ -46,10 +37,11 @@ export interface ProjectThreadStartTurnSpec {
  * offline outbox drain so both deliver identical commands.
  */
 export function buildProjectThreadStartTurnInput(spec: ProjectThreadStartTurnSpec) {
-  const title = deriveThreadTitleFromPrompt(spec.text);
+  const title = deriveThreadTitleSeed({ text: spec.text, attachments: spec.attachments });
   const isWorktree = spec.workspaceMode === "worktree";
   return {
     commandId: CommandId.make(spec.commandId),
+    creationSource: "mobile" as const,
     threadId: ThreadId.make(spec.threadId),
     message: {
       messageId: MessageId.make(spec.messageId),
@@ -87,3 +79,13 @@ export function buildProjectThreadStartTurnInput(spec: ProjectThreadStartTurnSpe
     createdAt: spec.createdAt,
   };
 }
+
+export function deriveThreadTitleFromPrompt(value: string): string {
+  const trimmed = value.trim();
+  if (trimmed.length === 0) {
+    return "New thread";
+  }
+
+  const compact = trimmed.replace(/\s+/g, " ");
+  return compact.length <= 72 ? compact : `${compact.slice(0, 69).trimEnd()}...`;
+}
diff --git a/apps/mobile/src/lib/scopedEntities.ts b/apps/mobile/src/lib/scopedEntities.ts
index 34709957fd48..6464b3561919 100644
--- a/apps/mobile/src/lib/scopedEntities.ts
+++ b/apps/mobile/src/lib/scopedEntities.ts
@@ -1,4 +1,4 @@
-import { ApprovalRequestId, EnvironmentId, ProjectId, ThreadId } from "@t3tools/contracts";
+import { EnvironmentId, ProjectId, RuntimeRequestId, ThreadId } from "@t3tools/contracts";
 
 export function scopedProjectKey(environmentId: EnvironmentId, projectId: ProjectId): string {
   return `${environmentId}:${projectId}`;
@@ -10,7 +10,7 @@ export function scopedThreadKey(environmentId: EnvironmentId, threadId: ThreadId
 
 export function scopedRequestKey(
   environmentId: EnvironmentId,
-  requestId: ApprovalRequestId,
+  requestId: RuntimeRequestId,
 ): string {
   return `${environmentId}:${requestId}`;
 }
diff --git a/apps/mobile/src/lib/threadActivity.test.ts b/apps/mobile/src/lib/threadActivity.test.ts
index 19194ea3a573..849ef9df8cbe 100644
--- a/apps/mobile/src/lib/threadActivity.test.ts
+++ b/apps/mobile/src/lib/threadActivity.test.ts
@@ -1,773 +1,499 @@
-import { describe, expect, it } from "vite-plus/test";
-import { codexFeedbackMessage } from "@t3tools/client-runtime/state/threads";
-
 import {
-  EventId,
   MessageId,
-  ProjectId,
-  ProviderInstanceId,
+  RunId,
   ThreadId,
-  TurnId,
-  type OrchestrationThread,
-  type OrchestrationThreadActivity,
+  TurnItemId,
+  type OrchestrationV2ProjectedTurnItem,
+  type OrchestrationV2TurnItem,
 } from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+import { describe, expect, it } from "vite-plus/test";
 
 import {
-  buildPendingUserInputAnswers,
   buildThreadFeed,
-  derivePendingApprovals,
   deriveThreadFeedPresentation,
-  isPendingUserInputOptionSelected,
-  setPendingUserInputCustomAnswer,
-  togglePendingUserInputOptionSelection,
+  threadFeedActivityIsVisible,
+  threadFeedRunIsUnsettled,
   type ThreadFeedActivity,
   type ThreadFeedEntry,
+  togglePendingUserInputOptionSelection,
+  setPendingUserInputCustomAnswer,
+  isPendingUserInputOptionSelected,
+  buildPendingUserInputAnswers,
 } from "./threadActivity";
 
-describe("Codex feedback pseudo-messages", () => {
-  it("keeps pending and completed feedback messages in the mobile thread body", () => {
-    const pending = {
-      id: MessageId.make("feedback-command"),
-      command: "/feedback The agent stopped early.",
-      createdAt: "2026-08-23T00:00:00.000Z",
-      status: "uploading" as const,
-    };
-    const entries = [codexFeedbackMessage(pending), codexFeedbackMessage(pending, "assistant")].map(
-      (message) => ({
-        type: "message" as const,
-        id: message.id,
-        createdAt: message.createdAt,
-        message,
-      }),
-    );
+const threadId = ThreadId.make("thread-1");
+const sourceThreadId = ThreadId.make("thread-source");
+const runId = RunId.make("run-1");
+
+it("keeps historical plan detail accessible from its paged turn item", () => {
+  const item = {
+    ...base("historical-plan", "2026-08-29T00:00:00.000Z", 1),
+    type: "proposed_plan",
+    planId: "plan-historical",
+    markdown: "Full historical plan text",
+    streaming: false,
+  } as OrchestrationV2TurnItem;
+
+  const entries = buildThreadFeed([projected(item, 0)]);
+  const activity = entries.flatMap((entry) =>
+    entry.type === "activity-group" ? entry.activities : [],
+  )[0];
+  expect(activity?.detail).toBe("Full historical plan text");
+  expect(activity?.getFullDetail()).toContain("Full historical plan text");
+});
 
-    expect(deriveThreadFeedPresentation(entries, null, new Set())).toEqual(entries);
-    expect(entries[1]?.message.text).toBe("Sending feedback to OpenAI...");
+function base(id: string, updatedAt: string, ordinal: number) {
+  const timestamp = DateTime.makeUnsafe(updatedAt);
+  return {
+    id: TurnItemId.make(id),
+    threadId,
+    runId,
+    nodeId: null,
+    providerThreadId: null,
+    providerTurnId: null,
+    nativeItemRef: null,
+    parentItemId: null,
+    ordinal,
+    status: "completed" as const,
+    title: null,
+    startedAt: timestamp,
+    completedAt: timestamp,
+    updatedAt: timestamp,
+  };
+}
 
-    const completed = codexFeedbackMessage(
-      { ...pending, status: "sent", feedbackId: "codex-thread-1" },
-      "assistant",
-    );
-    expect(completed.text).toContain("codex-thread-1");
-  });
-});
+function projected(
+  item: OrchestrationV2TurnItem,
+  position: number,
+  visibility: OrchestrationV2ProjectedTurnItem["visibility"] = "local",
+): OrchestrationV2ProjectedTurnItem {
+  return {
+    position,
+    visibility,
+    sourceThreadId: visibility === "local" ? threadId : sourceThreadId,
+    sourceItemId: item.id,
+    item,
+  };
+}
 
-const singleSelectQuestion = {
-  id: "runtime",
-  header: "Runtime",
-  question: "Which runtime should be used?",
-  options: [
-    { label: "Go", description: "One binary" },
-    { label: "Node.js", description: "Reuse TypeScript" },
-  ],
-  multiSelect: false,
-} as const;
+function userMessage(updatedAt = "2026-06-20T00:00:01.000Z") {
+  return {
+    ...base("item-user", updatedAt, 0),
+    type: "user_message" as const,
+    messageId: MessageId.make("message-user"),
+    createdBy: "user" as const,
+    creationSource: "mobile" as const,
+    inputIntent: "turn_start" as const,
+    text: "Run checks",
+    attachments: [],
+  };
+}
 
-const multiSelectQuestion = {
-  id: "scope",
-  header: "Scope",
-  question: "Which data should be collected?",
-  options: [
-    { label: "Orders", description: "Receipts" },
-    { label: "Listings", description: "Inventory" },
-  ],
-  multiSelect: true,
-} as const;
+function command(updatedAt = "2026-06-20T00:00:02.000Z") {
+  return {
+    ...base("item-command", updatedAt, 1),
+    type: "command_execution" as const,
+    input: "vp check",
+    output: "ok",
+    exitCode: 0,
+  };
+}
 
-describe("pending user input answers", () => {
-  it("replaces single-select options and toggles multi-select options", () => {
-    expect(
-      togglePendingUserInputOptionSelection(
-        singleSelectQuestion,
-        { selectedOptionLabels: ["Go"] },
-        "Node.js",
-      ),
-    ).toEqual({ customAnswer: "", selectedOptionLabels: ["Node.js"] });
+function assistantMessage(updatedAt = "2026-06-20T00:00:03.000Z") {
+  return {
+    ...base("item-assistant", updatedAt, 2),
+    type: "assistant_message" as const,
+    messageId: MessageId.make("message-assistant"),
+    text: "Done",
+    streaming: false,
+  };
+}
 
-    const orders = togglePendingUserInputOptionSelection(multiSelectQuestion, undefined, "Orders");
-    const ordersAndListings = togglePendingUserInputOptionSelection(
-      multiSelectQuestion,
-      orders,
-      "Listings",
-    );
-    expect(ordersAndListings).toEqual({
-      customAnswer: "",
-      selectedOptionLabels: ["Orders", "Listings"],
+describe("buildThreadFeed", () => {
+  it("adds local feedback messages to an otherwise server-authored feed", () => {
+    const feed = buildThreadFeed([], {
+      localMessages: [
+        {
+          id: MessageId.make("feedback-local"),
+          role: "assistant",
+          text: "Feedback sent to OpenAI.\n\nThread ID: `codex-thread-1`",
+          turnId: null,
+          streaming: false,
+          createdAt: "2026-08-29T00:00:00.000Z",
+          updatedAt: "2026-08-29T00:00:00.000Z",
+        },
+      ],
     });
-    expect(
-      togglePendingUserInputOptionSelection(multiSelectQuestion, ordersAndListings, "Orders"),
-    ).toEqual({ customAnswer: "", selectedOptionLabels: ["Listings"] });
 
-    const paddedOrders = togglePendingUserInputOptionSelection(
-      multiSelectQuestion,
-      undefined,
-      "  Orders  ",
-    );
-    expect(paddedOrders).toEqual({ customAnswer: "", selectedOptionLabels: ["Orders"] });
-    expect(
-      togglePendingUserInputOptionSelection(multiSelectQuestion, paddedOrders, "  Orders  "),
-    ).toEqual({ customAnswer: "" });
-  });
-
-  it("builds array answers for multi-select questions", () => {
-    expect(
-      buildPendingUserInputAnswers([singleSelectQuestion, multiSelectQuestion], {
-        runtime: { selectedOptionLabels: ["Go"] },
-        scope: { selectedOptionLabels: ["Orders", "Listings"] },
-      }),
-    ).toEqual({
-      runtime: "Go",
-      scope: ["Orders", "Listings"],
+    expect(feed).toHaveLength(1);
+    expect(feed[0]).toMatchObject({
+      type: "message",
+      message: {
+        id: "feedback-local",
+        role: "assistant",
+        text: expect.stringContaining("codex-thread-1"),
+      },
     });
   });
 
-  it("clears selected options while a custom answer is active", () => {
+  it("anchors feedback before later committed turns and appends true optimistic messages", () => {
+    const laterUser = {
+      ...userMessage("2026-08-29T00:00:05.000Z"),
+      id: TurnItemId.make("item-later-user"),
+      messageId: MessageId.make("message-later-user"),
+      ordinal: 2,
+      text: "Later user turn",
+    };
+    const laterAssistant = {
+      ...assistantMessage("2026-08-29T00:00:04.000Z"),
+      id: TurnItemId.make("item-later-assistant"),
+      messageId: MessageId.make("message-later-assistant"),
+      ordinal: 3,
+      text: "Later assistant turn",
+    };
+    const localMessage = (id: string, role: "user" | "assistant") => ({
+      id: MessageId.make(id),
+      role,
+      text: id,
+      turnId: null,
+      streaming: false,
+      createdAt: "2026-08-29T00:00:03.000Z",
+      updatedAt: "2026-08-29T00:00:03.000Z",
+    });
+    const feed = buildThreadFeed(
+      [
+        projected(userMessage("2026-08-29T00:00:01.000Z"), 0),
+        projected(laterUser, 1),
+        projected(laterAssistant, 2),
+      ],
+      {
+        anchoredMessages: [
+          localMessage("feedback-user", "user"),
+          localMessage("feedback-assistant", "assistant"),
+          localMessage("message-later-user", "user"),
+        ],
+        localMessages: [
+          {
+            ...localMessage("optimistic-user", "user"),
+            createdAt: "2026-08-29T00:00:00.000Z",
+          },
+        ],
+      },
+    );
+    const messages = feed.filter((entry) => entry.type === "message");
+
+    expect(messages.map((entry) => entry.id)).toEqual([
+      "message-user",
+      "feedback-user",
+      "feedback-assistant",
+      "message-later-user",
+      "message-later-assistant",
+      "optimistic-user",
+    ]);
     expect(
-      setPendingUserInputCustomAnswer(
-        { selectedOptionLabels: ["Orders", "Listings"] },
-        "Orders first",
-      ),
-    ).toEqual({ customAnswer: "Orders first" });
+      messages
+        .filter((entry) => entry.id.startsWith("feedback-"))
+        .every((entry) => entry.message.projectedItem === undefined),
+    ).toBe(true);
   });
 
-  it("matches selected chips against normalized option labels", () => {
+  it("keeps prominent activity visible while it is running", () => {
     expect(
-      isPendingUserInputOptionSelected({ selectedOptionLabels: ["Orders"] }, "  Orders  "),
+      threadFeedActivityIsVisible({ prominent: true, status: "neutral", toolLike: true }),
     ).toBe(true);
     expect(
-      isPendingUserInputOptionSelected(
-        { selectedOptionLabels: ["Orders"], customAnswer: "Orders first" },
-        "  Orders  ",
-      ),
+      threadFeedActivityIsVisible({ prominent: false, status: "neutral", toolLike: true }),
     ).toBe(false);
   });
-});
 
-describe("pending approvals", () => {
-  it("keeps app access approvals and persistence choices from remote environments", () => {
-    const options = [
-      { decision: "decline", label: "Decline" },
-      { decision: "acceptAlways", label: "Always allow Safari" },
-      { decision: "accept", label: "Approve" },
-    ];
-    const activity = makeActivity({
-      id: EventId.make("approval-safari"),
-      kind: "approval.requested",
-      summary: "App access approval requested",
-      createdAt: "2026-08-24T00:00:00.000Z",
-      payload: {
-        requestId: "req-safari",
-        requestType: "mcp_elicitation_approval",
-        detail: "Allow ChatGPT to use Safari?",
-        appName: "Safari",
-        options,
+  it("presents provider retries as visible work-log activity", () => {
+    const retryBase = {
+      ...base("item-provider-retry", "2026-06-20T00:00:02.000Z", 1),
+      type: "error" as const,
+      failure: {
+        class: "transport_error" as const,
+        message: "The response stream disconnected.",
+        code: "responseStreamDisconnected",
+        retryable: true,
       },
-    });
-
-    expect(derivePendingApprovals([activity])).toEqual([
-      {
-        requestId: "req-safari",
-        requestKind: "mcp-elicitation",
-        createdAt: "2026-08-24T00:00:00.000Z",
-        detail: "Allow ChatGPT to use Safari?",
-        appName: "Safari",
-        options,
+      retry: {
+        attempt: 2,
+        maxAttempts: 5,
+        retryDelayMs: null,
       },
+    };
+    const runningFeed = buildThreadFeed([
+      projected(
+        {
+          ...retryBase,
+          status: "running",
+          title: "Provider retry",
+          completedAt: null,
+        },
+        0,
+      ),
     ]);
-  });
+    const recoveredFeed = buildThreadFeed([
+      projected(
+        {
+          ...retryBase,
+          status: "completed",
+          title: "Provider recovered",
+        },
+        0,
+      ),
+    ]);
+    const runningActivity = runningFeed.find((entry) => entry.type === "activity-group")
+      ?.activities[0];
+    const recoveredActivity = recoveredFeed.find((entry) => entry.type === "activity-group")
+      ?.activities[0];
+    if (runningActivity === undefined || recoveredActivity === undefined) {
+      throw new Error("Expected provider retry work-log activities.");
+    }
 
-  it("removes an app access approval after a remote client rejects it", () => {
-    const requested = makeActivity({
-      id: EventId.make("approval-safari-open"),
-      kind: "approval.requested",
-      summary: "App access approval requested",
-      createdAt: "2026-08-24T00:00:00.000Z",
-      payload: { requestId: "req-safari", requestKind: "mcp-elicitation" },
+    expect(runningActivity).toMatchObject({
+      summary: "Provider retry",
+      status: "neutral",
+      toolLike: false,
     });
-    const resolved = makeActivity({
-      id: EventId.make("approval-safari-resolved"),
-      kind: "approval.resolved",
-      summary: "Approval resolved",
-      createdAt: "2026-08-24T00:00:01.000Z",
-      payload: { requestId: "req-safari", decision: "decline" },
+    expect(threadFeedActivityIsVisible(runningActivity)).toBe(true);
+    expect(recoveredActivity).toMatchObject({
+      summary: "Provider recovered",
+      status: "success",
+      toolLike: false,
     });
-
-    expect(derivePendingApprovals([requested, resolved])).toEqual([]);
   });
-});
 
-function makeActivity(
-  input: Partial<OrchestrationThreadActivity> &
-    Pick<OrchestrationThreadActivity, "id" | "kind" | "summary" | "createdAt">,
-): OrchestrationThreadActivity {
-  return {
-    tone: "info",
-    payload: {},
-    turnId: null,
-    ...input,
-  };
-}
+  it("hides synthetic workspace preparation activity", () => {
+    const workspacePreparation = projected(
+      {
+        ...command(),
+        title: "Workspace ready",
+        input: "Preparing workspace",
+        output: "Workspace preparation completed.",
+      },
+      0,
+    );
 
-function makeThread(
-  input: Partial<OrchestrationThread> & Pick<OrchestrationThread, "id" | "projectId" | "title">,
-): OrchestrationThread {
-  return {
-    modelSelection: { instanceId: ProviderInstanceId.make("codex"), model: "gpt-5.4" },
-    runtimeMode: "full-access",
-    interactionMode: "default",
-    branch: null,
-    worktreePath: null,
-    latestTurn: null,
-    createdAt: "2026-04-01T00:00:00.000Z",
-    updatedAt: "2026-04-01T00:00:00.000Z",
-    archivedAt: null,
-    deletedAt: null,
-    messages: [],
-    proposedPlans: [],
-    activities: [],
-    checkpoints: [],
-    session: null,
-    ...input,
-    settledOverride: input.settledOverride ?? null,
-    settledAt: input.settledAt ?? null,
-  };
-}
+    expect(buildThreadFeed([workspacePreparation])).toEqual([]);
+  });
 
-describe("buildThreadFeed", () => {
-  it("keeps older local feedback before newer messages returned by the server", () => {
-    const submission = {
-      id: MessageId.make("feedback-command-ordering"),
-      command: "/feedback The agent stopped early.",
-      createdAt: "2026-08-23T00:00:01.000Z",
-      status: "sent" as const,
-      feedbackId: "codex-thread-1",
-    };
-    const laterMessage = {
-      id: MessageId.make("later-server-message"),
-      role: "assistant" as const,
-      text: "Newer server response",
-      turnId: null,
-      createdAt: "2026-08-23T00:00:02.000Z",
-      updatedAt: "2026-08-23T00:00:02.000Z",
-      streaming: false,
-    };
-    const thread = makeThread({
-      id: ThreadId.make("thread-feedback-ordering"),
-      projectId: ProjectId.make("project-1"),
-      title: "Feedback ordering",
-      messages: [laterMessage],
-    });
+  it("does not treat a queued-only run as live feed activity", () => {
+    expect(
+      threadFeedRunIsUnsettled({
+        runId,
+        status: "queued",
+        startedAt: null,
+        completedAt: null,
+      }),
+    ).toBe(false);
+    expect(
+      threadFeedRunIsUnsettled({
+        runId,
+        status: "running",
+        startedAt: "2026-06-20T00:00:01.000Z",
+        completedAt: null,
+      }),
+    ).toBe(true);
+  });
 
-    const feed = buildThreadFeed(thread, {
-      localMessages: [
-        codexFeedbackMessage(submission),
-        codexFeedbackMessage(submission, "assistant"),
-      ],
-    });
+  it("adds queued input only after dispatch creates its turn item", () => {
+    const dispatchedRunId = RunId.make("run-dispatched-queued");
+    const dispatchedMessageId = MessageId.make("message-dispatched-queued");
+    expect(buildThreadFeed([])).toEqual([]);
 
-    expect(feed.map((entry) => entry.id)).toEqual([
-      "feedback-command-ordering",
-      "feedback-command-ordering:feedback",
-      "later-server-message",
+    const promotedEntries = buildThreadFeed([
+      projected(
+        {
+          ...userMessage(),
+          id: TurnItemId.make("item-dispatched-queued"),
+          runId: dispatchedRunId,
+          messageId: dispatchedMessageId,
+          inputIntent: "turn_start",
+        },
+        0,
+      ),
     ]);
+    expect(promotedEntries.map((entry) => entry.id)).toEqual([dispatchedMessageId]);
+    expect(
+      promotedEntries[0]?.type === "message" ? promotedEntries[0].message.inputIntent : undefined,
+    ).toBe("turn_start");
   });
 
-  it("keeps historic work entries attributed to their turns", () => {
-    const thread = makeThread({
-      id: ThreadId.make("thread-1"),
-      projectId: ProjectId.make("project-1"),
-      title: "Runtime warning thread",
-      latestTurn: {
-        turnId: TurnId.make("turn-latest"),
-        state: "running",
-        requestedAt: "2026-04-01T00:00:00.000Z",
-        startedAt: "2026-04-01T00:00:01.000Z",
-        completedAt: null,
-        assistantMessageId: null,
-      },
-      activities: [
-        makeActivity({
-          id: EventId.make("activity-old"),
-          kind: "runtime.warning",
-          summary: "Runtime warning",
-          createdAt: "2026-04-01T00:00:02.000Z",
-          turnId: TurnId.make("turn-old"),
-          payload: {
-            message: "Old warning",
-          },
-        }),
-        makeActivity({
-          id: EventId.make("activity-latest"),
-          kind: "runtime.warning",
-          summary: "Runtime warning",
-          createdAt: "2026-04-01T00:00:03.000Z",
-          turnId: TurnId.make("turn-latest"),
-          payload: {
-            message: "Latest warning",
-          },
-        }),
-      ],
-    });
-
-    const feed = buildThreadFeed(thread);
-    expect(feed).toMatchObject([
+  it("hides the interruption request and keeps the terminal result", () => {
+    const request = projected(
       {
-        type: "activity-group",
-        turnId: "turn-old",
-        activities: [{ id: "activity-old", turnId: "turn-old" }],
+        ...base("item-interrupt-request", "2026-06-20T00:00:02.000Z", 1),
+        type: "run_interrupt_request",
+        message: "Interrupt requested",
       },
+      0,
+    );
+    const result = projected(
       {
-        type: "activity-group",
-        turnId: "turn-latest",
-        activities: [{ id: "activity-latest", turnId: "turn-latest" }],
+        ...base("item-interrupt-result", "2026-06-20T00:00:03.000Z", 2),
+        type: "run_interrupt_result",
+        message: "Run interrupted before provider start",
       },
-    ]);
-  });
+      1,
+    );
 
-  it("drops runtime warnings with no displayable content", () => {
-    const thread = makeThread({
-      id: ThreadId.make("thread-noise"),
-      projectId: ProjectId.make("project-1"),
-      title: "Warning noise thread",
-      activities: [
-        makeActivity({
-          id: EventId.make("activity-noise"),
-          kind: "runtime.warning",
-          summary: "Claude system message 'background_tasks_changed' (no displayable text content)",
-          createdAt: "2026-04-01T00:00:02.000Z",
-          turnId: TurnId.make("turn-1"),
-        }),
-        makeActivity({
-          id: EventId.make("activity-signal"),
-          kind: "runtime.warning",
-          summary: "Reconnecting... 2/5",
-          createdAt: "2026-04-01T00:00:03.000Z",
-          turnId: TurnId.make("turn-1"),
-        }),
-      ],
-    });
+    const activities = buildThreadFeed([request, result]).flatMap((entry) =>
+      entry.type === "activity-group" ? entry.activities : [],
+    );
 
-    const feed = buildThreadFeed(thread);
-    expect(feed).toMatchObject([
-      {
-        type: "activity-group",
-        activities: [{ id: "activity-signal" }],
-      },
-    ]);
+    expect(activities).toHaveLength(1);
+    expect(activities[0]?.summary).toBe("Run interrupted");
+    expect(activities[0]?.detail).toBe("Run interrupted before provider start");
   });
 
-  it("collapses matching tool lifecycle rows like desktop", () => {
-    const thread = makeThread({
-      id: ThreadId.make("thread-2"),
-      projectId: ProjectId.make("project-1"),
-      title: "Collapsed tools",
-      latestTurn: {
-        turnId: TurnId.make("turn-1"),
-        state: "completed",
-        requestedAt: "2026-04-01T00:00:00.000Z",
-        startedAt: "2026-04-01T00:00:01.000Z",
-        completedAt: "2026-04-01T00:00:03.000Z",
-        assistantMessageId: null,
-      },
-      activities: [
-        makeActivity({
-          id: EventId.make("tool-updated"),
-          kind: "tool.updated",
-          tone: "tool",
-          summary: "Run tests",
-          createdAt: "2026-04-01T00:00:01.000Z",
-          turnId: TurnId.make("turn-1"),
-          payload: {
-            title: "Run tests",
-            itemType: "command_execution",
-            detail: "/bin/zsh -lc 'bun run test'",
-          },
-        }),
-        makeActivity({
-          id: EventId.make("tool-completed"),
-          kind: "tool.completed",
-          tone: "tool",
-          summary: "Run tests completed",
-          createdAt: "2026-04-01T00:00:02.000Z",
-          turnId: TurnId.make("turn-1"),
-          payload: {
-            title: "Run tests",
-            itemType: "command_execution",
-            detail: "/bin/zsh -lc 'bun run test'",
-          },
-        }),
-      ],
-    });
-
-    const feed = buildThreadFeed(thread);
-    const group = feed[0];
-
-    expect(group).toMatchObject({
-      type: "activity-group",
-    });
-    if (!group || group.type !== "activity-group") {
-      return;
-    }
+  it("preserves authoritative V2 order instead of sorting reconstructed collections", () => {
+    const rows = [
+      projected(userMessage("2026-06-20T00:00:03.000Z"), 0),
+      projected(command("2026-06-20T00:00:01.000Z"), 1),
+      projected(assistantMessage("2026-06-20T00:00:02.000Z"), 2),
+    ];
 
-    expect(group.activities).toHaveLength(1);
-    expect(group.activities[0]).toMatchObject({
-      id: "tool-completed",
-      createdAt: "2026-04-01T00:00:02.000Z",
-      turnId: "turn-1",
-      summary: "Run tests",
-      detail: "bun run test",
-      canExpand: true,
-      icon: "command",
-      toolLike: true,
-      status: "success",
-    });
-    expect(group.activities[0]?.getFullDetail()).toBe("/bin/zsh -lc 'bun run test'");
-    expect(group.activities[0]?.getCopyText()).toBe(
-      "Run tests\nbun run test\n/bin/zsh -lc 'bun run test'",
-    );
+    const feed = buildThreadFeed(rows);
+    expect(feed.map((entry) => entry.type)).toEqual(["message", "activity-group", "message"]);
+    expect(feed.map((entry) => entry.id)).toEqual([
+      "message-user",
+      "local:thread-1:item-command",
+      "message-assistant",
+    ]);
+    const activity = feed.find((entry) => entry.type === "activity-group")?.activities[0];
+    expect(activity?.projectedItem).toBe(rows[1]);
+    expect(activity?.getFullDetail()).toContain('"input": "vp check"');
   });
 
-  it("keeps MCP inputs available to expanded mobile work rows", () => {
-    const turnId = TurnId.make("turn-mcp");
-    const thread = makeThread({
-      id: ThreadId.make("thread-mcp"),
-      projectId: ProjectId.make("project-1"),
-      title: "Expandable MCP call",
-      latestTurn: {
-        turnId,
-        state: "completed",
-        requestedAt: "2026-04-01T00:00:00.000Z",
-        startedAt: "2026-04-01T00:00:01.000Z",
-        completedAt: "2026-04-01T00:00:03.000Z",
-        assistantMessageId: null,
+  it("retains inherited and synthetic rows with their original projected identity", () => {
+    const inherited = projected(command(), 0, "inherited");
+    const { providerThreadId: _providerThreadId, ...forkBase } = base(
+      "item-fork",
+      "2026-06-20T00:00:03.000Z",
+      2,
+    );
+    const synthetic = projected(
+      {
+        ...forkBase,
+        type: "fork",
+        source: { type: "run", threadId: sourceThreadId, runId },
+        targetThreadId: threadId,
       },
-      activities: [
-        makeActivity({
-          id: EventId.make("mcp-completed"),
-          kind: "tool.completed",
-          tone: "tool",
-          summary: "Call repository tool",
-          createdAt: "2026-04-01T00:00:02.000Z",
-          turnId,
-          payload: {
-            title: "Call repository tool",
-            itemType: "mcp_tool_call",
-            detail: "repository.search",
-            status: "completed",
-            data: {
-              item: {
-                server: "repository",
-                tool: "search",
-                arguments: { query: "work log" },
-              },
-            },
-          },
-        }),
-      ],
-    });
-
-    const group = buildThreadFeed(thread)[0];
-    expect(group).toMatchObject({ type: "activity-group" });
-    if (!group || group.type !== "activity-group") {
-      return;
-    }
-
-    expect(group.activities[0]?.icon).toBe("wrench");
-    expect(group.activities[0]?.getFullDetail()).toContain('"query": "work log"');
-    expect(group.activities[0]?.getFullDetail()).toContain("repository.search");
-  });
-
-  it("defers large tool output expansion until a work row is opened or copied", () => {
-    let serializedToolOutputs = 0;
-    const activities = Array.from({ length: 5_000 }, (_, index) =>
-      makeActivity({
-        id: EventId.make(`large-tool-${index}`),
-        kind: "tool.completed",
-        tone: "tool",
-        summary: `Tool ${index}`,
-        createdAt: new Date(Date.UTC(2026, 3, 1, 0, 0, index)).toISOString(),
-        payload: {
-          title: `Tool ${index}`,
-          itemType: "mcp_tool_call",
-          status: "completed",
-          data: {
-            item: {
-              toJSON: () => {
-                serializedToolOutputs += 1;
-                return { output: "x".repeat(32_768) };
-              },
-            },
-          },
-        },
-      }),
+      1,
+      "synthetic",
     );
-    const thread = makeThread({
-      id: ThreadId.make("thread-large-tools"),
-      projectId: ProjectId.make("project-1"),
-      title: "Large tools",
-      activities,
-    });
-
-    const feed = buildThreadFeed(thread);
-    expect(serializedToolOutputs).toBe(0);
 
-    const group = feed[0];
-    expect(group).toMatchObject({ type: "activity-group" });
-    if (!group || group.type !== "activity-group") {
-      return;
-    }
-
-    expect(group.activities).toHaveLength(5_000);
-    expect(group.activities[0]?.getFullDetail()).toContain('"output"');
-    expect(serializedToolOutputs).toBe(1);
-    expect(group.activities[0]?.getCopyText()).toContain('"output"');
-    expect(serializedToolOutputs).toBe(1);
+    const feed = buildThreadFeed([inherited, synthetic]);
+    const activities = feed.flatMap((entry) =>
+      entry.type === "activity-group" ? entry.activities : [],
+    );
+    expect(activities.map((activity) => activity.projectedItem)).toEqual([inherited, synthetic]);
+    expect(activities.map((activity) => activity.projectedItem.visibility)).toEqual([
+      "inherited",
+      "synthetic",
+    ]);
+    expect(activities.at(-1)?.prominent).toBe(true);
   });
 
-  it("keeps the first and terminal assistant messages visible around settled work", () => {
-    const turnId = TurnId.make("turn-1");
-    const thread = makeThread({
-      id: ThreadId.make("thread-3"),
-      projectId: ProjectId.make("project-1"),
-      title: "Folded work",
-      latestTurn: {
-        turnId,
-        state: "completed",
-        requestedAt: "2026-04-01T00:00:00.000Z",
-        startedAt: "2026-04-01T00:00:01.000Z",
-        completedAt: "2026-04-01T00:00:18.000Z",
-        assistantMessageId: MessageId.make("assistant-final"),
-      },
-      messages: [
-        {
-          id: MessageId.make("assistant-first"),
-          role: "assistant",
-          text: "Synthetic deployment checklist\n1. Confirm the deployment is ready.",
-          turnId,
-          streaming: false,
-          createdAt: "2026-04-01T00:00:02.000Z",
-          updatedAt: "2026-04-01T00:00:03.000Z",
-        },
+  it("keeps orchestration relationship cards visible when a completed run is folded", () => {
+    const { providerThreadId: _providerThreadId, ...forkBase } = base(
+      "item-fork",
+      "2026-06-20T00:00:02.500Z",
+      2,
+    );
+    const feed = buildThreadFeed([
+      projected(userMessage(), 0),
+      projected(command(), 1),
+      projected(
         {
-          id: MessageId.make("assistant-final"),
-          role: "assistant",
-          text: "Done.",
-          turnId,
-          streaming: false,
-          createdAt: "2026-04-01T00:00:17.000Z",
-          updatedAt: "2026-04-01T00:00:18.000Z",
+          ...forkBase,
+          type: "fork",
+          source: { type: "run", threadId, runId },
+          targetThreadId: sourceThreadId,
         },
-      ],
-      activities: [
-        makeActivity({
-          id: EventId.make("tool-completed"),
-          kind: "tool.completed",
-          tone: "tool",
-          summary: "Read files",
-          createdAt: "2026-04-01T00:00:05.000Z",
-          turnId,
-          payload: {
-            title: "Read files",
-            itemType: "file_read",
-            status: "completed",
-          },
-        }),
-      ],
-    });
-
-    const feed = buildThreadFeed(thread);
-    const collapsed = deriveThreadFeedPresentation(feed, thread.latestTurn, new Set());
-    expect(collapsed.map((entry) => entry.id)).toEqual([
-      "assistant-first",
-      "turn-fold:turn-1",
-      "assistant-final",
-    ]);
-    expect(collapsed[1]).toMatchObject({
-      type: "turn-fold",
-      label: "Worked for 17s",
-      expanded: false,
-    });
-
-    const expanded = deriveThreadFeedPresentation(feed, thread.latestTurn, new Set([turnId]));
-    expect(expanded.map((entry) => entry.id)).toEqual([
-      "assistant-first",
-      "turn-fold:turn-1",
-      "tool-completed",
-      "assistant-final",
+        2,
+      ),
+      projected(assistantMessage(), 3),
     ]);
-  });
 
-  it("folds assistant messages between the first and terminal messages", () => {
-    const turnId = TurnId.make("turn-1");
-    const thread = makeThread({
-      id: ThreadId.make("thread-middle-message"),
-      projectId: ProjectId.make("project-1"),
-      title: "Bounded narration",
-      latestTurn: {
-        turnId,
-        state: "completed",
-        requestedAt: "2026-04-01T00:00:00.000Z",
-        startedAt: "2026-04-01T00:00:01.000Z",
-        completedAt: "2026-04-01T00:00:06.000Z",
-        assistantMessageId: MessageId.make("assistant-final"),
+    const collapsed = deriveThreadFeedPresentation(
+      feed,
+      {
+        runId,
+        status: "completed",
+        startedAt: "2026-06-20T00:00:01.000Z",
+        completedAt: "2026-06-20T00:00:03.000Z",
       },
-      messages: [
-        {
-          id: MessageId.make("assistant-first"),
-          role: "assistant",
-          text: "The main result is ready.",
-          turnId,
-          streaming: false,
-          createdAt: "2026-04-01T00:00:01.000Z",
-          updatedAt: "2026-04-01T00:00:02.000Z",
-        },
-        {
-          id: MessageId.make("assistant-middle"),
-          role: "assistant",
-          text: "I am checking one more detail.",
-          turnId,
-          streaming: false,
-          createdAt: "2026-04-01T00:00:03.000Z",
-          updatedAt: "2026-04-01T00:00:04.000Z",
-        },
-        {
-          id: MessageId.make("assistant-final"),
-          role: "assistant",
-          text: "Verification finished.",
-          turnId,
-          streaming: false,
-          createdAt: "2026-04-01T00:00:05.000Z",
-          updatedAt: "2026-04-01T00:00:06.000Z",
-        },
-      ],
-    });
+      new Set(),
+    );
 
-    const feed = buildThreadFeed(thread);
-    const rows = deriveThreadFeedPresentation(feed, thread.latestTurn, new Set());
+    expect(
+      collapsed.some(
+        (entry) =>
+          entry.type === "activity-group" &&
+          entry.activities.some((activity) => activity.projectedItem.item.type === "fork"),
+      ),
+    ).toBe(true);
+    expect(
+      collapsed.some(
+        (entry) =>
+          entry.type === "activity-group" &&
+          entry.activities.some(
+            (activity) => activity.projectedItem.item.type === "command_execution",
+          ),
+      ),
+    ).toBe(false);
+  });
 
-    expect(rows.map((entry) => entry.id)).toEqual([
-      "assistant-first",
-      "turn-fold:turn-1",
-      "assistant-final",
+  it("folds settled V2 run work while keeping the terminal assistant message visible", () => {
+    const feed = buildThreadFeed([
+      projected(userMessage(), 0),
+      projected(command(), 1),
+      projected(assistantMessage(), 2),
     ]);
-  });
+    const latestRun = {
+      runId,
+      status: "completed" as const,
+      startedAt: "2026-06-20T00:00:01.000Z",
+      completedAt: "2026-06-20T00:00:03.000Z",
+    };
 
-  it("measures a steer-superseded turn from its user boundary through trailing work", () => {
-    const firstTurnId = TurnId.make("turn-1");
-    const secondTurnId = TurnId.make("turn-2");
-    const thread = makeThread({
-      id: ThreadId.make("thread-steered"),
-      projectId: ProjectId.make("project-1"),
-      title: "Steered work",
-      latestTurn: {
-        turnId: secondTurnId,
-        state: "running",
-        requestedAt: "2026-04-01T00:00:14.000Z",
-        startedAt: "2026-04-01T00:00:14.000Z",
-        completedAt: null,
-        assistantMessageId: MessageId.make("assistant-next"),
-      },
-      messages: [
-        {
-          id: MessageId.make("user-1"),
-          role: "user",
-          text: "Do it once more.",
-          turnId: null,
-          streaming: false,
-          createdAt: "2026-04-01T00:00:00.000Z",
-          updatedAt: "2026-04-01T00:00:00.000Z",
-        },
-        {
-          id: MessageId.make("assistant-commentary"),
-          role: "assistant",
-          text: "Kicking off call 1.",
-          turnId: firstTurnId,
-          streaming: false,
-          createdAt: "2026-04-01T00:00:09.000Z",
-          updatedAt: "2026-04-01T00:00:09.000Z",
-        },
-        {
-          id: MessageId.make("user-2"),
-          role: "user",
-          text: "Actually do 15.",
-          turnId: null,
-          streaming: false,
-          createdAt: "2026-04-01T00:00:14.000Z",
-          updatedAt: "2026-04-01T00:00:14.000Z",
-        },
-        {
-          id: MessageId.make("assistant-next"),
-          role: "assistant",
-          text: "One down - adjusting.",
-          turnId: secondTurnId,
-          streaming: true,
-          createdAt: "2026-04-01T00:00:17.000Z",
-          updatedAt: "2026-04-01T00:00:17.000Z",
-        },
-      ],
-      activities: [
-        makeActivity({
-          id: EventId.make("work-1"),
-          kind: "tool.completed",
-          tone: "tool",
-          summary: "Ran command",
-          createdAt: "2026-04-01T00:00:12.000Z",
-          turnId: firstTurnId,
-          payload: {
-            title: "Ran command",
-            itemType: "command_execution",
-            status: "completed",
-          },
-        }),
-      ],
-    });
+    const collapsed = deriveThreadFeedPresentation(feed, latestRun, new Set());
+    expect(collapsed.map((entry) => entry.type)).toEqual(["message", "run-fold", "message"]);
 
-    const feed = buildThreadFeed(thread);
-    const collapsed = deriveThreadFeedPresentation(feed, thread.latestTurn, new Set());
-    expect(collapsed.find((entry) => entry.type === "turn-fold")).toMatchObject({
-      turnId: firstTurnId,
-      label: "Worked for 12s",
-    });
+    const expanded = deriveThreadFeedPresentation(feed, latestRun, new Set([runId]));
+    expect(expanded.map((entry) => entry.type)).toEqual([
+      "message",
+      "run-fold",
+      "activity-group",
+      "message",
+    ]);
   });
 
-  it("keeps an active turn expanded and classifies error-shaped tool output", () => {
-    const turnId = TurnId.make("turn-running");
-    const thread = makeThread({
-      id: ThreadId.make("thread-4"),
-      projectId: ProjectId.make("project-1"),
-      title: "Running work",
-      latestTurn: {
-        turnId,
-        state: "running",
-        requestedAt: "2026-04-01T00:00:00.000Z",
-        startedAt: "2026-04-01T00:00:01.000Z",
+  it("keeps an active run expanded and marks failed tools as failures", () => {
+    const failedCommand: OrchestrationV2TurnItem = {
+      ...command(),
+      status: "failed",
+      completedAt: DateTime.makeUnsafe("2026-06-20T00:00:02.000Z"),
+    };
+    const feed = buildThreadFeed([projected(userMessage(), 0), projected(failedCommand, 1)]);
+    const presented = deriveThreadFeedPresentation(
+      feed,
+      {
+        runId,
+        status: "running",
+        startedAt: "2026-06-20T00:00:01.000Z",
         completedAt: null,
-        assistantMessageId: null,
       },
-      activities: [
-        makeActivity({
-          id: EventId.make("tool-failed"),
-          kind: "tool.completed",
-          tone: "tool",
-          summary: "Run command",
-          createdAt: "2026-04-01T00:00:05.000Z",
-          turnId,
-          payload: {
-            title: "Run command",
-            itemType: "command_execution",
-            detail: "zsh: command not found: nope",
-            status: "completed",
-          },
-        }),
-      ],
-    });
+      new Set(),
+    );
 
-    const feed = buildThreadFeed(thread);
-    expect(deriveThreadFeedPresentation(feed, thread.latestTurn, new Set())).toEqual(feed);
-    expect(feed[0]).toMatchObject({
-      type: "activity-group",
-      activities: [{ status: "failure" }],
-    });
+    expect(presented.some((entry) => entry.type === "run-fold")).toBe(false);
+    expect(presented.find((entry) => entry.type === "activity-group")?.activities[0]?.status).toBe(
+      "failure",
+    );
   });
 
   it("appends active work as a normal timeline row", () => {
@@ -792,22 +518,25 @@ describe("buildThreadFeed", () => {
     ): ThreadFeedActivity => ({
       id,
       createdAt,
-      turnId: null,
+      runId: null,
       summary: `Tool ${id}`,
       detail: null,
       canExpand: false,
       getFullDetail: () => null,
       getCopyText: () => id,
       icon: "command",
+      logo: null,
       toolLike: true,
+      prominent: false,
       status,
+      projectedItem: projected(command(createdAt), 0),
     });
     const feed: ThreadFeedEntry[] = [
       {
         type: "activity-group",
         id: "work-group-1",
         createdAt: "2026-04-01T00:00:01.000Z",
-        turnId: null,
+        runId: null,
         activities: [
           activity("activity-1", "2026-04-01T00:00:01.000Z"),
           activity("activity-neutral", "2026-04-01T00:00:02.000Z", "neutral"),
@@ -838,40 +567,112 @@ describe("buildThreadFeed", () => {
       expanded: true,
     });
   });
+
+  it("pretty prints T3 MCP dynamic tool activities and attaches the product logo", () => {
+    const toolItem: OrchestrationV2TurnItem = {
+      ...base("item-t3-tool", "2026-06-20T00:00:04.000Z", 3),
+      type: "dynamic_tool",
+      toolName: "mcp__t3-code__t3_thread_read",
+      input: { threadId: "thread-child" },
+      output: { messages: [] },
+    };
+
+    const feed = buildThreadFeed([projected(toolItem, 0)]);
+    const activity = feed[0]?.type === "activity-group" ? feed[0].activities[0] : null;
+
+    expect(activity?.summary).toBe("Read a T3 thread");
+    expect(activity?.logo).toBe("t3-code");
+    expect(activity?.getCopyText().split("\n")[0]).toBe("Read a T3 thread");
+  });
 });
 
-describe("quiet timeline: nested agents", () => {
-  it("keeps a nested agent's terminal row but hides its background work", () => {
-    const thread = makeThread({
-      id: ThreadId.make("thread-nested"),
-      projectId: ProjectId.make("project-1"),
-      title: "Nested agents",
-      activities: [
-        // A subagent's own shell: internal, covered by the owner's liveness.
-        makeActivity({
-          id: EventId.make("shell-done"),
-          kind: "task.completed",
-          summary: "Task completed",
-          createdAt: "2026-04-01T00:00:02.000Z",
-          payload: { taskId: "sh-1", agentId: "owner", agentKind: "background" },
-        }),
-        // A nested AGENT's completion: mobile has no Agents sheet, so this
-        // terminal row is the only signal it ever finished.
-        makeActivity({
-          id: EventId.make("nested-done"),
-          kind: "task.completed",
-          summary: "Task completed",
-          createdAt: "2026-04-01T00:00:03.000Z",
-          payload: { taskId: "n-1", agentId: "owner", agentKind: "agent" },
-        }),
-      ],
+const singleSelectQuestion = {
+  id: "runtime",
+  header: "Runtime",
+  question: "Which runtime should be used?",
+  options: [
+    { label: "Go", description: "One binary" },
+    { label: "Node.js", description: "Reuse TypeScript" },
+  ],
+  multiSelect: false,
+} as const;
+
+const multiSelectQuestion = {
+  id: "scope",
+  header: "Scope",
+  question: "Which data should be collected?",
+  options: [
+    { label: "Orders", description: "Receipts" },
+    { label: "Listings", description: "Inventory" },
+  ],
+  multiSelect: true,
+} as const;
+
+describe("pending user input answers", () => {
+  it("replaces single-select options and toggles multi-select options", () => {
+    expect(
+      togglePendingUserInputOptionSelection(
+        singleSelectQuestion,
+        { selectedOptionLabels: ["Go"] },
+        "Node.js",
+      ),
+    ).toEqual({ customAnswer: "", selectedOptionLabels: ["Node.js"] });
+
+    const orders = togglePendingUserInputOptionSelection(multiSelectQuestion, undefined, "Orders");
+    const ordersAndListings = togglePendingUserInputOptionSelection(
+      multiSelectQuestion,
+      orders,
+      "Listings",
+    );
+    expect(ordersAndListings).toEqual({
+      customAnswer: "",
+      selectedOptionLabels: ["Orders", "Listings"],
     });
+    expect(
+      togglePendingUserInputOptionSelection(multiSelectQuestion, ordersAndListings, "Orders"),
+    ).toEqual({ customAnswer: "", selectedOptionLabels: ["Listings"] });
 
-    const feed = buildThreadFeed(thread);
-    const ids = feed.flatMap((entry) =>
-      entry.type === "activity-group" ? entry.activities.map((row) => row.id) : [],
+    const paddedOrders = togglePendingUserInputOptionSelection(
+      multiSelectQuestion,
+      undefined,
+      "  Orders  ",
     );
-    expect(ids).toContain("nested-done");
-    expect(ids).not.toContain("shell-done");
+    expect(paddedOrders).toEqual({ customAnswer: "", selectedOptionLabels: ["Orders"] });
+    expect(
+      togglePendingUserInputOptionSelection(multiSelectQuestion, paddedOrders, "  Orders  "),
+    ).toEqual({ customAnswer: "" });
+  });
+
+  it("builds array answers for multi-select questions", () => {
+    expect(
+      buildPendingUserInputAnswers([singleSelectQuestion, multiSelectQuestion], {
+        runtime: { selectedOptionLabels: ["Go"] },
+        scope: { selectedOptionLabels: ["Orders", "Listings"] },
+      }),
+    ).toEqual({
+      runtime: "Go",
+      scope: ["Orders", "Listings"],
+    });
+  });
+
+  it("clears selected options while a custom answer is active", () => {
+    expect(
+      setPendingUserInputCustomAnswer(
+        { selectedOptionLabels: ["Orders", "Listings"] },
+        "Orders first",
+      ),
+    ).toEqual({ customAnswer: "Orders first" });
+  });
+
+  it("matches selected chips against normalized option labels", () => {
+    expect(
+      isPendingUserInputOptionSelected({ selectedOptionLabels: ["Orders"] }, "  Orders  "),
+    ).toBe(true);
+    expect(
+      isPendingUserInputOptionSelected(
+        { selectedOptionLabels: ["Orders"], customAnswer: "Orders first" },
+        "  Orders  ",
+      ),
+    ).toBe(false);
   });
 });
diff --git a/apps/mobile/src/lib/threadActivity.ts b/apps/mobile/src/lib/threadActivity.ts
index 6dd8230307a5..bede9a64ddaf 100644
--- a/apps/mobile/src/lib/threadActivity.ts
+++ b/apps/mobile/src/lib/threadActivity.ts
@@ -1,40 +1,34 @@
+import type {
+  ThreadPendingApproval,
+  ThreadPendingUserInput,
+  ThreadUserInputQuestion,
+} from "@t3tools/client-runtime/state/thread-requests";
+import { turnItemIsWorkspacePreparation } from "@t3tools/client-runtime/state/turn-item-presentation";
 import {
-  ApprovalRequestId,
-  isToolLifecycleItemType,
-  ProviderApprovalOption,
-  ProviderRequestKind,
-} from "@t3tools/contracts";
+  resolveT3McpToolPresentation,
+  type T3McpToolLogo,
+  type T3McpToolPresentation,
+} from "@t3tools/shared/t3McpToolPresentation";
 import type {
-  OrchestrationLatestTurn,
-  OrchestrationThread,
-  OrchestrationThreadActivity,
-  ToolLifecycleItemType,
-  TurnId,
-  UserInputQuestion,
+  ChatAttachment,
+  MessageId,
+  OrchestrationV2Actor,
+  OrchestrationV2CreationSource,
+  OrchestrationMessage,
+  OrchestrationV2ProjectedTurnItem,
+  OrchestrationV2RunStatus,
+  OrchestrationV2TurnItem,
+  OrchestrationV2UserMessageInputIntent,
+  RunId,
 } from "@t3tools/contracts";
+import { ThreadId } from "@t3tools/contracts";
 import { formatDuration } from "@t3tools/shared/orchestrationTiming";
+import * as DateTime from "effect/DateTime";
 
-import * as Arr from "effect/Array";
-import * as Order from "effect/Order";
-import * as Schema from "effect/Schema";
+export type PendingApproval = ThreadPendingApproval;
+export type PendingUserInput = ThreadPendingUserInput;
 
-export interface PendingApproval {
-  readonly requestId: ApprovalRequestId;
-  readonly requestKind: ProviderRequestKind;
-  readonly createdAt: string;
-  readonly detail?: string;
-  readonly appName?: string;
-  readonly options?: ReadonlyArray<ProviderApprovalOption>;
-}
-
-const isProviderRequestKind = Schema.is(ProviderRequestKind);
-const isProviderApprovalOption = Schema.is(ProviderApprovalOption);
-
-export interface PendingUserInput {
-  readonly requestId: ApprovalRequestId;
-  readonly createdAt: string;
-  readonly questions: ReadonlyArray<UserInputQuestion>;
-}
+const MAX_VISIBLE_WORK_LOG_ENTRIES = 1;
 
 export interface PendingUserInputDraftAnswer {
   readonly selectedOptionLabels?: ReadonlyArray<string>;
@@ -44,7 +38,7 @@ export interface PendingUserInputDraftAnswer {
 export interface ThreadFeedActivity {
   readonly id: string;
   readonly createdAt: string;
-  readonly turnId: TurnId | null;
+  readonly runId: RunId | null;
   readonly summary: string;
   readonly detail: string | null;
   readonly canExpand: boolean;
@@ -63,36 +57,28 @@ export interface ThreadFeedActivity {
     | "warning"
     | "wrench"
     | "zap";
+  readonly logo: T3McpToolLogo | null;
   readonly toolLike: boolean;
+  readonly prominent: boolean;
   readonly status: "success" | "failure" | "neutral" | null;
-}
-
-const MAX_VISIBLE_WORK_LOG_ENTRIES = 1;
-
-type WorkLogToolLifecycleStatus = "inProgress" | "completed" | "failed" | "declined" | "stopped";
-
-interface WorkLogEntry {
-  id: string;
-  createdAt: string;
-  turnId: TurnId | null;
-  label: string;
-  detail?: string;
-  command?: string;
-  rawCommand?: string;
-  changedFiles?: ReadonlyArray<string>;
-  tone: "thinking" | "tool" | "info" | "error";
-  toolTitle?: string;
-  itemType?: ToolLifecycleItemType;
-  requestKind?: PendingApproval["requestKind"];
-  toolLifecycleStatus?: WorkLogToolLifecycleStatus;
-  toolData?: unknown;
-}
-
-interface DerivedWorkLogEntry extends WorkLogEntry {
-  activityKind: OrchestrationThreadActivity["kind"];
-  collapseKey?: string;
-  /** Grouping key for subagent lifecycle rows (one row per agent). */
-  taskId?: string;
+  readonly projectedItem: OrchestrationV2ProjectedTurnItem;
+}
+
+export interface ThreadFeedMessage {
+  readonly id: MessageId;
+  readonly role: "user" | "assistant";
+  readonly text: string;
+  readonly attachments: ReadonlyArray<ChatAttachment>;
+  readonly runId: RunId | null;
+  readonly streaming: boolean;
+  readonly inputIntent?: OrchestrationV2UserMessageInputIntent;
+  readonly createdBy?: OrchestrationV2Actor;
+  readonly creationSource?: OrchestrationV2CreationSource;
+  readonly visibility: OrchestrationV2ProjectedTurnItem["visibility"];
+  readonly sourceThreadId: ThreadId;
+  readonly createdAt: string;
+  readonly updatedAt: string;
+  readonly projectedItem?: OrchestrationV2ProjectedTurnItem;
 }
 
 type RawThreadFeedEntry =
@@ -100,13 +86,13 @@ type RawThreadFeedEntry =
       readonly type: "message";
       readonly id: string;
       readonly createdAt: string;
-      readonly message: OrchestrationThread["messages"][number];
+      readonly message: ThreadFeedMessage;
     }
   | {
       readonly type: "activity";
       readonly id: string;
       readonly createdAt: string;
-      readonly turnId: TurnId | null;
+      readonly runId: RunId | null;
       readonly activity: ThreadFeedActivity;
     };
 
@@ -121,121 +107,37 @@ export type ThreadFeedEntry =
       readonly type: "activity-group";
       readonly id: string;
       readonly createdAt: string;
-      readonly turnId: TurnId | null;
+      readonly runId: RunId | null;
       readonly activities: ReadonlyArray<ThreadFeedActivity>;
     }
   | {
       readonly type: "work-toggle";
       readonly id: string;
       readonly createdAt: string;
-      readonly turnId: TurnId | null;
+      readonly runId: RunId | null;
       readonly groupId: string;
       readonly hiddenCount: number;
       readonly expanded: boolean;
       readonly onlyToolActivities: boolean;
     }
   | {
-      readonly type: "turn-fold";
+      readonly type: "run-fold";
       readonly id: string;
       readonly createdAt: string;
-      readonly turnId: TurnId;
+      readonly runId: RunId;
       readonly label: string;
       readonly expanded: boolean;
     };
 
-export type ThreadFeedLatestTurn = Pick<
-  OrchestrationLatestTurn,
-  "turnId" | "state" | "startedAt" | "completedAt"
->;
-
-function requestKindFromRequestType(requestType: unknown): PendingApproval["requestKind"] | null {
-  switch (requestType) {
-    case "command_execution_approval":
-    case "exec_command_approval":
-      return "command";
-    case "file_read_approval":
-      return "file-read";
-    case "file_change_approval":
-    case "apply_patch_approval":
-      return "file-change";
-    case "mcp_elicitation_approval":
-      return "mcp-elicitation";
-    default:
-      return null;
-  }
-}
-
-function isStalePendingRequestFailureDetail(detail: string | undefined): boolean {
-  const normalized = detail?.toLowerCase();
-  if (!normalized) {
-    return false;
-  }
-  return (
-    normalized.includes("stale pending approval request") ||
-    normalized.includes("stale pending user-input request") ||
-    normalized.includes("unknown pending approval request") ||
-    normalized.includes("unknown pending permission request") ||
-    normalized.includes("unknown pending user-input request")
-  );
-}
-
-function parseApprovalRequestId(value: unknown): ApprovalRequestId | null {
-  return typeof value === "string" && value.length > 0 ? ApprovalRequestId.make(value) : null;
-}
-
-function parseUserInputQuestions(
-  payload: Record<string, unknown> | null,
-): ReadonlyArray<UserInputQuestion> | null {
-  const questions = payload?.questions;
-  if (!Array.isArray(questions)) {
-    return null;
-  }
-
-  const parsed = questions
-    .map<UserInputQuestion | null>((entry) => {
-      if (!entry || typeof entry !== "object") return null;
-      const question = entry as Record<string, unknown>;
-      if (
-        typeof question.id !== "string" ||
-        typeof question.header !== "string" ||
-        typeof question.question !== "string" ||
-        !Array.isArray(question.options)
-      ) {
-        return null;
-      }
-      const options = question.options
-        .map<UserInputQuestion["options"][number] | null>((option) => {
-          if (!option || typeof option !== "object") return null;
-          const record = option as Record<string, unknown>;
-          if (typeof record.label !== "string" || typeof record.description !== "string") {
-            return null;
-          }
-          return {
-            label: record.label,
-            description: record.description,
-          };
-        })
-        .filter((option): option is UserInputQuestion["options"][number] => option !== null);
-      if (options.length === 0) {
-        return null;
-      }
-      return {
-        id: question.id,
-        header: question.header,
-        question: question.question,
-        options,
-        multiSelect: question.multiSelect === true,
-      };
-    })
-    .filter((question): question is UserInputQuestion => question !== null);
-
-  return parsed.length > 0 ? parsed : null;
+export interface ThreadFeedLatestRun {
+  readonly runId: RunId;
+  readonly status: OrchestrationV2RunStatus;
+  readonly startedAt: string | null;
+  readonly completedAt: string | null;
 }
 
 function normalizeDraftAnswer(value: string | undefined): string | null {
-  if (typeof value !== "string") {
-    return null;
-  }
+  if (typeof value !== "string") return null;
   const trimmed = value.trim();
   return trimmed.length > 0 ? trimmed : null;
 }
@@ -253,7 +155,7 @@ function normalizeSelectedOptionLabels(
 }
 
 function resolvePendingUserInputAnswer(
-  question: UserInputQuestion,
+  question: ThreadUserInputQuestion,
   draft: PendingUserInputDraftAnswer | undefined,
 ): string | ReadonlyArray<string> | null {
   const customAnswer = normalizeDraftAnswer(draft?.customAnswer);
@@ -268,437 +170,9 @@ function resolvePendingUserInputAnswer(
   return selectedOptionLabels[0] ?? null;
 }
 
-/** Codex children settle via task.updated (idle/failed/interrupted), never
- * task.completed — these rows are mobile's only terminal signal for them. */
-const MOBILE_TERMINAL_UPDATE_STATUSES: ReadonlySet<string> = new Set([
-  "idle",
-  "completed",
-  "failed",
-  "cancelled",
-  "interrupted",
-]);
-
-function isTerminalBypassUpdate(activity: OrchestrationThreadActivity): boolean {
-  if (activity.kind !== "task.updated") {
-    return false;
-  }
-  const payload =
-    activity.payload && typeof activity.payload === "object"
-      ? (activity.payload as Record<string, unknown>)
-      : null;
-  return (
-    payload?.timelineBypass === true &&
-    typeof payload.status === "string" &&
-    MOBILE_TERMINAL_UPDATE_STATUSES.has(payload.status)
-  );
-}
-
-/**
- * Quiet-timeline guarantee (mirrors web's session-logic): agent-internal
- * activity lives in the Agents sheet, not the work log. Terminal rows are
- * kept — with no Agents surface on mobile they are the terminal signal
- * (a surface that hides rows must keep its own terminal signal). That means
- * task.completed (Claude) AND terminal bypassed task.updated (Codex, whose
- * children never emit task.completed — review finding).
- */
-function isAgentInternalActivity(activity: OrchestrationThreadActivity): boolean {
-  const payload =
-    activity.payload && typeof activity.payload === "object"
-      ? (activity.payload as Record<string, unknown>)
-      : null;
-  if (!payload) {
-    return false;
-  }
-  const isTerminalTaskRow = activity.kind === "task.completed" || isTerminalBypassUpdate(activity);
-  if (payload.timelineBypass === true && !isTerminalTaskRow) {
-    return true;
-  }
-  // agentId marks ownership, not "hide me": a NESTED AGENT's terminal row is
-  // the only signal mobile gets (no Agents sheet), so it stays. Only an
-  // agent's own background work (stamped "background") is internal — same
-  // rule as web (review finding: hiding on agentId alone dropped nested
-  // completions with no replacement UI).
-  const ownedByAgent = typeof payload.agentId === "string" && payload.agentId.trim().length > 0;
-  if (!ownedByAgent) {
-    return false;
-  }
-  return !(isTerminalTaskRow && payload.agentKind === "agent");
-}
-
-function deriveWorkLogEntries(
-  activities: ReadonlyArray<OrchestrationThreadActivity>,
-): DerivedWorkLogEntry[] {
-  const ordered = Arr.sort(activities, activityOrder);
-  const entries: DerivedWorkLogEntry[] = [];
-  for (const activity of ordered) {
-    if (activity.kind === "tool.started") continue;
-    if (activity.kind === "task.started") continue;
-    // Terminal bypassed updates pass: Codex children's only terminal signal.
-    if (activity.kind === "task.updated" && !isTerminalBypassUpdate(activity)) continue;
-    if (activity.kind === "tool.progress") continue;
-    if (activity.kind === "context-window.updated") continue;
-    if (activity.summary === "Checkpoint captured") continue;
-    if (isNoContentRuntimeWarning(activity)) continue;
-    if (isPlanBoundaryToolActivity(activity)) continue;
-    if (isAgentInternalActivity(activity)) continue;
-    entries.push(toDerivedWorkLogEntry(activity));
-  }
-  return collapseDerivedWorkLogEntries(entries);
-}
-
-/** Adapters forward unknown wire-only SDK messages (background_tasks_changed,
- *  commands_changed, ...) as runtime warnings. The suffix comes from
- *  describeUnknownSdkMessage in the Claude adapter; a row with no displayable
- *  text carries nothing a user can act on, so it does not render. */
-function isNoContentRuntimeWarning(activity: OrchestrationThreadActivity): boolean {
-  return (
-    activity.kind === "runtime.warning" &&
-    activity.summary.endsWith("(no displayable text content)")
-  );
-}
-
-function isPlanBoundaryToolActivity(activity: OrchestrationThreadActivity): boolean {
-  if (activity.kind !== "tool.updated" && activity.kind !== "tool.completed") {
-    return false;
-  }
-
-  const payload =
-    activity.payload && typeof activity.payload === "object"
-      ? (activity.payload as Record<string, unknown>)
-      : null;
-  return typeof payload?.detail === "string" && payload.detail.startsWith("ExitPlanMode:");
-}
-
-function toDerivedWorkLogEntry(activity: OrchestrationThreadActivity): DerivedWorkLogEntry {
-  const payload =
-    activity.payload && typeof activity.payload === "object"
-      ? (activity.payload as Record<string, unknown>)
-      : null;
-  const commandPreview = extractToolCommand(payload);
-  const changedFiles = extractChangedFiles(payload);
-  const title = extractToolTitle(payload);
-  // task.updated included: terminal bypassed updates (Codex children's only
-  // terminal signal) must carry task identity so they collapse per child
-  // instead of stacking anonymous "Task idle" rows.
-  const isTaskActivity =
-    activity.kind === "task.progress" ||
-    activity.kind === "task.completed" ||
-    activity.kind === "task.updated";
-  const taskSummary =
-    isTaskActivity && typeof payload?.summary === "string" && payload.summary.length > 0
-      ? payload.summary
-      : null;
-  const taskDetailAsLabel =
-    isTaskActivity &&
-    !taskSummary &&
-    typeof payload?.detail === "string" &&
-    payload.detail.length > 0
-      ? payload.detail
-      : null;
-  const taskLabel = taskSummary || taskDetailAsLabel;
-  const taskId =
-    isTaskActivity && typeof payload?.taskId === "string" && payload.taskId.length > 0
-      ? payload.taskId
-      : undefined;
-  const entry: DerivedWorkLogEntry = {
-    id: activity.id,
-    createdAt: activity.createdAt,
-    turnId: activity.turnId,
-    ...(taskId ? { taskId } : {}),
-    label: taskLabel || activity.summary,
-    tone:
-      activity.kind === "task.progress"
-        ? "thinking"
-        : activity.tone === "approval"
-          ? "info"
-          : activity.tone,
-    activityKind: activity.kind,
-  };
-  const itemType = extractWorkLogItemType(payload);
-  const requestKind = extractWorkLogRequestKind(payload);
-  if (
-    !taskDetailAsLabel &&
-    payload &&
-    typeof payload.detail === "string" &&
-    payload.detail.length > 0
-  ) {
-    const detail = stripTrailingExitCode(payload.detail).output;
-    if (detail) {
-      entry.detail = detail;
-    }
-  }
-  if (commandPreview.command) {
-    entry.command = commandPreview.command;
-  }
-  if (commandPreview.rawCommand) {
-    entry.rawCommand = commandPreview.rawCommand;
-  }
-  if (changedFiles.length > 0) {
-    entry.changedFiles = changedFiles;
-  }
-  if (title) {
-    entry.toolTitle = title;
-  }
-  if (itemType === "mcp_tool_call") {
-    const data = asRecord(payload?.data);
-    if (data?.item !== undefined) {
-      entry.toolData = data.item;
-    }
-  }
-  if (itemType) {
-    entry.itemType = itemType;
-  }
-  if (requestKind) {
-    entry.requestKind = requestKind;
-  }
-  let toolLifecycleStatus = extractWorkLogToolLifecycleStatus(payload);
-  if (!toolLifecycleStatus && activity.kind === "tool.completed") {
-    toolLifecycleStatus = "completed";
-  }
-  if (toolLifecycleStatus) {
-    entry.toolLifecycleStatus = toolLifecycleStatus;
-  }
-  const collapseKey = deriveToolLifecycleCollapseKey(entry);
-  if (collapseKey) {
-    entry.collapseKey = collapseKey;
-  }
-  return entry;
-}
-
-function collapseDerivedWorkLogEntries(
-  entries: ReadonlyArray<DerivedWorkLogEntry>,
-): DerivedWorkLogEntry[] {
-  const collapsed: DerivedWorkLogEntry[] = [];
-  // Subagent rows collapse by identity, not adjacency (quiet-timeline
-  // guarantee; mirrors web's session-logic).
-  const taskRowIndex = new Map<string, number>();
-  for (const entry of entries) {
-    const isTaskRow =
-      entry.taskId !== undefined &&
-      (entry.activityKind === "task.progress" ||
-        entry.activityKind === "task.completed" ||
-        entry.activityKind === "task.updated");
-    if (isTaskRow && entry.taskId !== undefined) {
-      const existingIndex = taskRowIndex.get(entry.taskId);
-      if (existingIndex !== undefined) {
-        collapsed[existingIndex] = mergeDerivedWorkLogEntries(collapsed[existingIndex]!, entry);
-        continue;
-      }
-      taskRowIndex.set(entry.taskId, collapsed.length);
-      collapsed.push(entry);
-      continue;
-    }
-    const previous = collapsed.at(-1);
-    if (previous && shouldCollapseToolLifecycleEntries(previous, entry)) {
-      collapsed[collapsed.length - 1] = mergeDerivedWorkLogEntries(previous, entry);
-      continue;
-    }
-    collapsed.push(entry);
-  }
-  return collapsed;
-}
-
-function shouldCollapseToolLifecycleEntries(
-  previous: DerivedWorkLogEntry,
-  next: DerivedWorkLogEntry,
-): boolean {
-  if (previous.activityKind !== "tool.updated" && previous.activityKind !== "tool.completed") {
-    return false;
-  }
-  if (next.activityKind !== "tool.updated" && next.activityKind !== "tool.completed") {
-    return false;
-  }
-  if (previous.activityKind === "tool.completed") {
-    return false;
-  }
-  return previous.collapseKey !== undefined && previous.collapseKey === next.collapseKey;
-}
-
-function mergeDerivedWorkLogEntries(
-  previous: DerivedWorkLogEntry,
-  next: DerivedWorkLogEntry,
-): DerivedWorkLogEntry {
-  const changedFiles = mergeChangedFiles(previous.changedFiles, next.changedFiles);
-  const detail = next.detail ?? previous.detail;
-  const command = next.command ?? previous.command;
-  const rawCommand = next.rawCommand ?? previous.rawCommand;
-  const toolTitle = next.toolTitle ?? previous.toolTitle;
-  const itemType = next.itemType ?? previous.itemType;
-  const requestKind = next.requestKind ?? previous.requestKind;
-  const collapseKey = next.collapseKey ?? previous.collapseKey;
-  const toolLifecycleStatus = next.toolLifecycleStatus ?? previous.toolLifecycleStatus;
-  const toolData = next.toolData ?? previous.toolData;
-  return {
-    ...previous,
-    ...next,
-    ...(detail ? { detail } : {}),
-    ...(command ? { command } : {}),
-    ...(rawCommand ? { rawCommand } : {}),
-    ...(changedFiles.length > 0 ? { changedFiles } : {}),
-    ...(toolTitle ? { toolTitle } : {}),
-    ...(itemType ? { itemType } : {}),
-    ...(requestKind ? { requestKind } : {}),
-    ...(collapseKey ? { collapseKey } : {}),
-    ...(toolLifecycleStatus ? { toolLifecycleStatus } : {}),
-    ...(toolData !== undefined ? { toolData } : {}),
-  };
-}
-
-function mergeChangedFiles(
-  previous: ReadonlyArray<string> | undefined,
-  next: ReadonlyArray<string> | undefined,
-): string[] {
-  const merged = [...(previous ?? []), ...(next ?? [])];
-  if (merged.length === 0) {
-    return [];
-  }
-  return [...new Set(merged)];
-}
-
-function deriveToolLifecycleCollapseKey(entry: DerivedWorkLogEntry): string | undefined {
-  if (entry.activityKind !== "tool.updated" && entry.activityKind !== "tool.completed") {
-    return undefined;
-  }
-  const normalizedLabel = normalizeCompactToolLabel(entry.toolTitle ?? entry.label);
-  const detail = entry.detail?.trim() ?? "";
-  const itemType = entry.itemType ?? "";
-  if (normalizedLabel.length === 0 && detail.length === 0 && itemType.length === 0) {
-    return undefined;
-  }
-  return [itemType, normalizedLabel, detail].join("\u001f");
-}
-
-function normalizeCompactToolLabel(value: string): string {
-  return value.replace(/\s+(?:complete|completed)\s*$/i, "").trim();
-}
-
-function workLogEntryIsToolLike(entry: WorkLogEntry): boolean {
-  if (entry.tone === "tool" || entry.tone === "thinking" || entry.tone === "error") {
-    return true;
-  }
-  if (entry.command !== undefined && entry.command.trim().length > 0) {
-    return true;
-  }
-  if (entry.requestKind !== undefined) {
-    return true;
-  }
-  return entry.itemType !== undefined && isToolLifecycleItemType(entry.itemType);
-}
-
-function toolDetailTextLooksLikeFailure(text: string): boolean {
-  const normalized = text.toLowerCase();
-  return (
-    normalized.includes("file not found") ||
-    normalized.includes("no files found") ||
-    normalized.includes("enoent") ||
-    normalized.includes("no such file or directory") ||
-    normalized.includes("no such file") ||
-    normalized.includes("commandnotfoundexception") ||
-    normalized.includes("command not found") ||
-    (normalized.includes("cannot find path") && normalized.includes("because it does not exist")) ||
-    (normalized.includes("is not recognized") && normalized.includes("the term '")) ||
-    normalized.includes("is not recognized as the name of a cmdlet") ||
-    normalized.includes("a parameter cannot be found that matches parameter name") ||
-    /<exited with exit code\s+[1-9]\d*\s*>/i.test(text) ||
-    /exit(?:ed)? with exit code\s+[1-9]\d*/i.test(text) ||
-    /exit code\s*[:\s]\s*[1-9]\d*\b/i.test(text)
-  );
-}
-
-function workEntryIndicatesToolFailure(entry: WorkLogEntry): boolean {
-  if (entry.tone === "error") {
-    return true;
-  }
-  if (entry.toolLifecycleStatus === "failed" || entry.toolLifecycleStatus === "declined") {
-    return true;
-  }
-  if (!workLogEntryIsToolLike(entry)) {
-    return false;
-  }
-  return toolDetailTextLooksLikeFailure([entry.detail, entry.command].filter(Boolean).join("\n"));
-}
-
-function workEntryIndicatesToolSuccess(entry: WorkLogEntry): boolean {
-  if (!workLogEntryIsToolLike(entry) || workEntryIndicatesToolFailure(entry)) {
-    return false;
-  }
-  if (entry.tone === "thinking") {
-    return false;
-  }
-  return (
-    entry.toolLifecycleStatus !== "inProgress" &&
-    entry.toolLifecycleStatus !== "stopped" &&
-    entry.toolLifecycleStatus !== "failed" &&
-    entry.toolLifecycleStatus !== "declined"
-  );
-}
-
-function workEntryStatus(entry: WorkLogEntry): ThreadFeedActivity["status"] {
-  if (!workLogEntryIsToolLike(entry)) {
-    return null;
-  }
-  if (workEntryIndicatesToolFailure(entry)) {
-    return "failure";
-  }
-  if (workEntryIndicatesToolSuccess(entry)) {
-    return "success";
-  }
-  return "neutral";
-}
-
-function workEntryIcon(entry: DerivedWorkLogEntry): ThreadFeedActivity["icon"] {
-  if (
-    entry.activityKind === "user-input.requested" ||
-    entry.activityKind === "user-input.resolved"
-  ) {
-    return "message";
-  }
-  if (entry.activityKind === "runtime.warning") return "warning";
-  if (entry.requestKind === "command") return "command";
-  if (entry.requestKind === "file-read") return "eye";
-  if (entry.requestKind === "file-change") return "edit";
-  if (entry.itemType === "command_execution" || entry.command) return "command";
-  if (entry.itemType === "file_change" || (entry.changedFiles?.length ?? 0) > 0) return "edit";
-  if (entry.itemType === "web_search") return "globe";
-  if (entry.itemType === "image_view") return "eye";
-  if (entry.itemType === "mcp_tool_call") return "wrench";
-  if (entry.itemType === "dynamic_tool_call" || entry.itemType === "collab_agent_tool_call") {
-    return "hammer";
-  }
-  if (entry.tone === "error") return "alert";
-  if (entry.tone === "thinking") return "agent";
-  if (entry.tone === "info") return "check";
-  return "zap";
-}
-
-function buildWorkEntryExpandedBody(entry: WorkLogEntry): string | null {
-  const blocks: string[] = [];
-  const appendUniqueBlock = (value: string | null | undefined) => {
-    const trimmed = value?.trim();
-    if (trimmed && !blocks.includes(trimmed)) {
-      blocks.push(trimmed);
-    }
-  };
-
-  if (entry.itemType === "mcp_tool_call" && entry.toolData !== undefined) {
-    appendUniqueBlock(`MCP call\n${JSON.stringify(entry.toolData, null, 2)}`);
-  }
-  appendUniqueBlock(entry.rawCommand ?? entry.command);
-  appendUniqueBlock(entry.detail);
-  if ((entry.changedFiles?.length ?? 0) > 0) {
-    appendUniqueBlock(entry.changedFiles!.join("\n"));
-  }
-
-  return blocks.length > 0 ? blocks.join("\n\n") : null;
-}
-
-function workEntryHasExpandedBody(entry: WorkLogEntry): boolean {
-  return (
-    (entry.itemType === "mcp_tool_call" && entry.toolData !== undefined) ||
-    Boolean((entry.rawCommand ?? entry.command)?.trim()) ||
-    Boolean(entry.detail?.trim()) ||
-    (entry.changedFiles?.some((path) => path.trim().length > 0) ?? false)
-  );
+function capitalizePhrase(value: string): string {
+  const trimmed = value.trim();
+  return trimmed.length === 0 ? value : `${trimmed.charAt(0).toUpperCase()}${trimmed.slice(1)}`;
 }
 
 function memoizeValue<T>(build: () => T): () => T {
@@ -713,383 +187,225 @@ function memoizeValue<T>(build: () => T): () => T {
   };
 }
 
-function workEntryPreview(
-  workEntry: Pick<WorkLogEntry, "detail" | "command" | "changedFiles">,
-): string | null {
-  if (workEntry.command) return workEntry.command;
-  if (workEntry.detail) return workEntry.detail;
-  if ((workEntry.changedFiles?.length ?? 0) === 0) return null;
-  const [firstPath] = workEntry.changedFiles ?? [];
-  if (!firstPath) return null;
-  return workEntry.changedFiles!.length === 1
-    ? firstPath
-    : `${firstPath} +${workEntry.changedFiles!.length - 1} more`;
-}
-
-function capitalizePhrase(value: string): string {
-  const trimmed = value.trim();
-  if (trimmed.length === 0) {
-    return value;
-  }
-  return `${trimmed.charAt(0).toUpperCase()}${trimmed.slice(1)}`;
-}
-
-function workEntryHeading(workEntry: WorkLogEntry): string {
-  if (!workEntry.toolTitle) {
-    return capitalizePhrase(normalizeCompactToolLabel(workEntry.label));
-  }
-  return capitalizePhrase(normalizeCompactToolLabel(workEntry.toolTitle));
-}
-
-function asRecord(value: unknown): Record<string, unknown> | null {
-  return value && typeof value === "object" ? (value as Record<string, unknown>) : null;
-}
-
-function asTrimmedString(value: unknown): string | null {
-  if (typeof value !== "string") {
-    return null;
-  }
-  const trimmed = value.trim();
-  return trimmed.length > 0 ? trimmed : null;
+function itemIsToolLike(item: OrchestrationV2TurnItem): boolean {
+  return (
+    item.type === "reasoning" ||
+    item.type === "command_execution" ||
+    item.type === "file_change" ||
+    item.type === "file_search" ||
+    item.type === "web_search" ||
+    item.type === "approval_request" ||
+    item.type === "user_input_request" ||
+    item.type === "dynamic_tool" ||
+    item.type === "subagent"
+  );
 }
 
-function trimMatchingOuterQuotes(value: string): string {
-  const trimmed = value.trim();
-  if (
-    (trimmed.startsWith("'") && trimmed.endsWith("'")) ||
-    (trimmed.startsWith('"') && trimmed.endsWith('"'))
-  ) {
-    const unquoted = trimmed.slice(1, -1).trim();
-    return unquoted.length > 0 ? unquoted : trimmed;
-  }
-  return trimmed;
+function itemIsProminent(item: OrchestrationV2TurnItem): boolean {
+  return item.type === "fork" || item.type === "thread_created" || item.type === "subagent";
 }
 
-function executableBasename(value: string): string | null {
-  const trimmed = trimMatchingOuterQuotes(value);
-  if (trimmed.length === 0) {
-    return null;
+function itemStatus(item: OrchestrationV2TurnItem): ThreadFeedActivity["status"] {
+  if (item.type === "error") {
+    if (item.status === "failed") return "failure";
+    return item.status === "completed" ? "success" : "neutral";
   }
-  const normalized = trimmed.replace(/\\/g, "/");
-  const segments = normalized.split("/");
-  const last = segments.at(-1)?.trim() ?? "";
-  return last.length > 0 ? last.toLowerCase() : null;
+  if (!itemIsToolLike(item)) return null;
+  if (item.status === "failed") return "failure";
+  return item.status === "completed" ? "success" : "neutral";
 }
 
-function splitExecutableAndRest(value: string): { executable: string; rest: string } | null {
-  const trimmed = value.trim();
-  if (trimmed.length === 0) {
+function itemIcon(item: OrchestrationV2TurnItem): ThreadFeedActivity["icon"] {
+  switch (item.type) {
+    case "reasoning":
+      return "agent";
+    case "command_execution":
+      return "command";
+    case "file_change":
+      return "edit";
+    case "file_search":
+      return "eye";
+    case "web_search":
+      return "globe";
+    case "approval_request":
+    case "user_input_request":
+    case "user_message":
+    case "assistant_message":
+      return "message";
+    case "dynamic_tool":
+      return "wrench";
+    case "subagent":
+      return "hammer";
+    case "run_interrupt_request":
+    case "run_interrupt_result":
+      return "warning";
+    case "error":
+      return "alert";
+    case "checkpoint":
+    case "proposed_plan":
+    case "todo_list":
+      return "check";
+    case "compaction":
+    case "handoff":
+    case "fork":
+    case "thread_created":
+      return "zap";
+  }
+}
+
+function itemToolPresentation(item: OrchestrationV2TurnItem): T3McpToolPresentation | null {
+  if (item.type !== "dynamic_tool") {
     return null;
   }
-
-  if (trimmed.startsWith('"') || trimmed.startsWith("'")) {
-    const quote = trimmed.charAt(0);
-    const closeIndex = trimmed.indexOf(quote, 1);
-    if (closeIndex <= 0) {
+  return resolveT3McpToolPresentation(item.toolName) ?? resolveT3McpToolPresentation(item.title);
+}
+
+function itemSummary(
+  item: OrchestrationV2TurnItem,
+  toolPresentation: T3McpToolPresentation | null = null,
+): string {
+  const title = item.title?.trim();
+  if (title) return toolPresentation?.displayName ?? capitalizePhrase(title);
+  switch (item.type) {
+    case "reasoning":
+      return "Thinking";
+    case "command_execution":
+      return "Command";
+    case "file_change":
+      return `Changed ${item.fileName}`;
+    case "file_search":
+      return "Searched files";
+    case "web_search":
+      return "Searched the web";
+    case "approval_request":
+      return "Approval requested";
+    case "user_input_request":
+      return "Input requested";
+    case "checkpoint":
+      return "Checkpoint captured";
+    case "run_interrupt_request":
+      return "Interrupt requested";
+    case "run_interrupt_result":
+      return "Run interrupted";
+    case "error":
+      return "Provider error";
+    case "compaction":
+      return "Context compacted";
+    case "handoff":
+      return "Context handed off";
+    case "fork":
+      return "Thread forked";
+    case "thread_created":
+      return "Thread created";
+    case "subagent":
+      return "Subagent";
+    case "dynamic_tool":
+      return toolPresentation?.displayName ?? item.toolName ?? "Tool call";
+    case "proposed_plan":
+      return "Proposed plan";
+    case "todo_list":
+      return "Plan updated";
+    case "user_message":
+      return "User message";
+    case "assistant_message":
+      return "Assistant message";
+  }
+}
+
+function itemPreview(item: OrchestrationV2TurnItem): string | null {
+  switch (item.type) {
+    case "reasoning":
+      return item.text || null;
+    case "command_execution":
+      return item.input || null;
+    case "file_change":
+      return item.fileName;
+    case "file_search":
+      return item.pattern ?? null;
+    case "web_search":
+      return item.patterns?.join(", ") ?? null;
+    case "approval_request":
+      return item.prompt ?? null;
+    case "user_input_request":
+      return item.questions.map((question) => question.question).join(" · ") || null;
+    case "checkpoint":
+      return item.files.length === 1
+        ? (item.files[0]?.path ?? null)
+        : `${item.files.length} changed files`;
+    case "run_interrupt_request":
+    case "run_interrupt_result":
+      return item.message || null;
+    case "error":
+      return item.failure.message;
+    case "compaction":
+    case "handoff":
+      return item.summary ?? null;
+    case "fork":
+    case "thread_created":
+      return item.targetThreadId;
+    case "subagent":
+      return item.result ?? item.progress ?? item.prompt;
+    case "dynamic_tool":
       return null;
-    }
-    return {
-      executable: trimmed.slice(0, closeIndex + 1),
-      rest: trimmed.slice(closeIndex + 1).trim(),
-    };
-  }
-
-  const firstWhitespace = trimmed.search(/\s/);
-  if (firstWhitespace < 0) {
-    return {
-      executable: trimmed,
-      rest: "",
-    };
-  }
-
-  return {
-    executable: trimmed.slice(0, firstWhitespace),
-    rest: trimmed.slice(firstWhitespace).trim(),
-  };
-}
-
-const SHELL_WRAPPER_SPECS = [
-  {
-    executables: ["pwsh", "pwsh.exe", "powershell", "powershell.exe"],
-    wrapperFlagPattern: /(?:^|\s)-command\s+/i,
-  },
-  {
-    executables: ["cmd", "cmd.exe"],
-    wrapperFlagPattern: /(?:^|\s)\/c\s+/i,
-  },
-  {
-    executables: ["bash", "sh", "zsh"],
-    wrapperFlagPattern: /(?:^|\s)-(?:l)?c\s+/i,
-  },
-] as const;
-
-function findShellWrapperSpec(shell: string) {
-  return SHELL_WRAPPER_SPECS.find((spec) =>
-    (spec.executables as ReadonlyArray<string>).includes(shell),
+    case "proposed_plan":
+      return item.markdown || null;
+    case "todo_list":
+      return `${item.steps.filter((step) => step.status === "completed").length}/${item.steps.length} completed`;
+    case "user_message":
+    case "assistant_message":
+      return item.text || null;
+  }
+}
+
+function toFeedActivity(row: OrchestrationV2ProjectedTurnItem): ThreadFeedActivity {
+  const item = row.item;
+  const toolPresentation = itemToolPresentation(item);
+  const summary = itemSummary(item, toolPresentation);
+  const detail = itemPreview(item);
+  const getFullDetail = memoizeValue(() =>
+    JSON.stringify(
+      {
+        visibility: row.visibility,
+        sourceThreadId: row.sourceThreadId,
+        sourceItemId: row.sourceItemId,
+        item,
+      },
+      null,
+      2,
+    ),
   );
-}
-
-function unwrapCommandRemainder(value: string, wrapperFlagPattern: RegExp): string | null {
-  const match = wrapperFlagPattern.exec(value);
-  if (!match) {
-    return null;
-  }
-
-  const command = value.slice(match.index + match[0].length).trim();
-  if (command.length === 0) {
-    return null;
-  }
-
-  const unwrapped = trimMatchingOuterQuotes(command);
-  return unwrapped.length > 0 ? unwrapped : null;
-}
-
-function unwrapKnownShellCommandWrapper(value: string): string {
-  const split = splitExecutableAndRest(value);
-  if (!split || split.rest.length === 0) {
-    return value;
-  }
-
-  const shell = executableBasename(split.executable);
-  if (!shell) {
-    return value;
-  }
-
-  const spec = findShellWrapperSpec(shell);
-  if (!spec) {
-    return value;
-  }
-
-  return unwrapCommandRemainder(split.rest, spec.wrapperFlagPattern) ?? value;
-}
-
-function formatCommandArrayPart(value: string): string {
-  return /[\s"'`]/.test(value) ? `"${value.replace(/"/g, '\\"')}"` : value;
-}
-
-function formatCommandValue(value: unknown): string | null {
-  const direct = asTrimmedString(value);
-  if (direct) {
-    return direct;
-  }
-  if (!Array.isArray(value)) {
-    return null;
-  }
-  const parts: Array<string> = [];
-  for (const entry of value) {
-    const part = asTrimmedString(entry);
-    if (part !== null) {
-      parts.push(part);
-    }
-  }
-  if (parts.length === 0) {
-    return null;
-  }
-  return parts.map((part) => formatCommandArrayPart(part)).join(" ");
-}
-
-function normalizeCommandValue(value: unknown): string | null {
-  const formatted = formatCommandValue(value);
-  return formatted ? unwrapKnownShellCommandWrapper(formatted) : null;
-}
-
-function toRawToolCommand(value: unknown, normalizedCommand: string | null): string | null {
-  const formatted = formatCommandValue(value);
-  if (!formatted || normalizedCommand === null) {
-    return null;
-  }
-  return formatted === normalizedCommand ? null : formatted;
-}
-
-function extractToolCommand(payload: Record<string, unknown> | null): {
-  command: string | null;
-  rawCommand: string | null;
-} {
-  const data = asRecord(payload?.data);
-  const item = asRecord(data?.item);
-  const itemResult = asRecord(item?.result);
-  const itemInput = asRecord(item?.input);
-  const itemType = asTrimmedString(payload?.itemType);
-  const detail = asTrimmedString(payload?.detail);
-  const candidates: unknown[] = [
-    item?.command,
-    itemInput?.command,
-    itemResult?.command,
-    data?.command,
-    itemType === "command_execution" && detail ? stripTrailingExitCode(detail).output : null,
-  ];
-
-  for (const candidate of candidates) {
-    const command = normalizeCommandValue(candidate);
-    if (!command) {
-      continue;
-    }
-    return {
-      command,
-      rawCommand: toRawToolCommand(candidate, command),
-    };
-  }
-
-  return {
-    command: null,
-    rawCommand: null,
-  };
-}
-
-function extractToolTitle(payload: Record<string, unknown> | null): string | null {
-  return asTrimmedString(payload?.title);
-}
-
-function extractWorkLogToolLifecycleStatus(
-  payload: Record<string, unknown> | null,
-): WorkLogToolLifecycleStatus | undefined {
-  const status = payload?.status;
-  if (
-    status === "inProgress" ||
-    status === "completed" ||
-    status === "failed" ||
-    status === "declined" ||
-    status === "stopped"
-  ) {
-    return status;
-  }
-  return undefined;
-}
-
-function stripTrailingExitCode(value: string): {
-  output: string | null;
-  exitCode?: number | undefined;
-} {
-  const trimmed = value.trim();
-  const match = /^(?<output>[\s\S]*?)(?:\s*<exited with exit code (?<code>\d+)>)\s*$/i.exec(
-    trimmed,
+  const getCopyText = memoizeValue(() =>
+    [summary, detail, getFullDetail()]
+      .filter(
+        (value, index, values): value is string =>
+          Boolean(value) && values.indexOf(value) === index,
+      )
+      .join("\n"),
   );
-  if (!match?.groups) {
-    return {
-      output: trimmed.length > 0 ? trimmed : null,
-    };
-  }
-  const exitCode = Number.parseInt(match.groups.code ?? "", 10);
-  const normalizedOutput = match.groups.output?.trim() ?? "";
   return {
-    output: normalizedOutput.length > 0 ? normalizedOutput : null,
-    ...(Number.isInteger(exitCode) ? { exitCode } : {}),
+    id: `${row.visibility}:${row.sourceThreadId}:${row.sourceItemId}`,
+    createdAt: DateTime.formatIso(item.startedAt ?? item.updatedAt),
+    runId: item.runId,
+    summary,
+    detail,
+    canExpand: true,
+    getFullDetail,
+    getCopyText,
+    icon: itemIcon(item),
+    logo: toolPresentation?.logo ?? null,
+    toolLike: itemIsToolLike(item),
+    prominent: itemIsProminent(item),
+    status: itemStatus(item),
+    projectedItem: row,
   };
 }
 
-function extractWorkLogItemType(
-  payload: Record<string, unknown> | null,
-): WorkLogEntry["itemType"] | undefined {
-  if (typeof payload?.itemType === "string" && isToolLifecycleItemType(payload.itemType)) {
-    return payload.itemType;
-  }
-  return undefined;
-}
-
-function extractWorkLogRequestKind(
-  payload: Record<string, unknown> | null,
-): WorkLogEntry["requestKind"] | undefined {
-  if (
-    payload?.requestKind === "command" ||
-    payload?.requestKind === "file-read" ||
-    payload?.requestKind === "file-change"
-  ) {
-    return payload.requestKind;
-  }
-  return requestKindFromRequestType(payload?.requestType) ?? undefined;
-}
-
-function pushChangedFile(target: string[], seen: Set<string>, value: unknown) {
-  const normalized = asTrimmedString(value);
-  if (!normalized || seen.has(normalized)) {
-    return;
-  }
-  seen.add(normalized);
-  target.push(normalized);
-}
-
-function collectChangedFiles(value: unknown, target: string[], seen: Set<string>, depth: number) {
-  if (depth > 4 || target.length >= 12) {
-    return;
-  }
-  if (Array.isArray(value)) {
-    for (const entry of value) {
-      collectChangedFiles(entry, target, seen, depth + 1);
-      if (target.length >= 12) {
-        return;
-      }
-    }
-    return;
-  }
-
-  const record = asRecord(value);
-  if (!record) {
-    return;
-  }
-
-  pushChangedFile(target, seen, record.path);
-  pushChangedFile(target, seen, record.filePath);
-  pushChangedFile(target, seen, record.relativePath);
-  pushChangedFile(target, seen, record.filename);
-  pushChangedFile(target, seen, record.newPath);
-  pushChangedFile(target, seen, record.oldPath);
-
-  for (const nestedKey of [
-    "item",
-    "result",
-    "input",
-    "data",
-    "changes",
-    "files",
-    "edits",
-    "patch",
-    "patches",
-    "operations",
-  ]) {
-    if (!(nestedKey in record)) {
-      continue;
-    }
-    collectChangedFiles(record[nestedKey], target, seen, depth + 1);
-    if (target.length >= 12) {
-      return;
-    }
-  }
-}
-
-function extractChangedFiles(payload: Record<string, unknown> | null): string[] {
-  const changedFiles: string[] = [];
-  const seen = new Set<string>();
-  collectChangedFiles(asRecord(payload?.data), changedFiles, seen, 0);
-  return changedFiles;
-}
-
-function compareActivityLifecycleRank(kind: string): number {
-  if (kind.endsWith(".started") || kind === "tool.started") {
-    return 0;
-  }
-  if (kind.endsWith(".progress") || kind.endsWith(".updated")) {
-    return 1;
-  }
-  if (kind.endsWith(".completed") || kind.endsWith(".resolved")) {
-    return 2;
-  }
-  return 1;
-}
-
-const activityOrder = Order.combineAll<OrchestrationThreadActivity>([
-  Order.mapInput(Order.Number, (activity) => activity.sequence ?? Number.MAX_SAFE_INTEGER),
-  Order.mapInput(Order.String, (activity) => activity.createdAt),
-  Order.mapInput(Order.Number, (activity) => compareActivityLifecycleRank(activity.kind)),
-  Order.mapInput(Order.String, (activity) => activity.id),
-]);
-
 function isEmptyMessage(entry: RawThreadFeedEntry): boolean {
-  if (entry.type !== "message") {
-    return false;
-  }
-  const hasText = entry.message.text.trim().length > 0;
-  const hasAttachments = (entry.message.attachments ?? []).length > 0;
-  return !hasText && !hasAttachments;
+  return (
+    entry.type === "message" &&
+    entry.message.text.trim().length === 0 &&
+    entry.message.attachments.length === 0
+  );
 }
 
 function groupAdjacentActivities(entries: ReadonlyArray<RawThreadFeedEntry>): ThreadFeedEntry[] {
@@ -1098,160 +414,153 @@ function groupAdjacentActivities(entries: ReadonlyArray<RawThreadFeedEntry>): Th
   // O(1) instead of re-copying the group (which made this loop quadratic on
   // long tool runs). The array is only mutated while it is the trailing group.
   let openGroupActivities: ThreadFeedActivity[] | null = null;
-  let openGroupTurnId: TurnId | null = null;
+  let openGroupRunId: string | null = null;
+  let openGroupHasProminent = false;
 
   for (const entry of entries) {
-    // Skip empty messages so they don't break activity grouping.
-    if (isEmptyMessage(entry)) {
-      continue;
-    }
-
+    if (isEmptyMessage(entry)) continue;
     if (entry.type !== "activity") {
       grouped.push(entry);
       openGroupActivities = null;
       continue;
     }
 
-    if (openGroupActivities !== null && openGroupTurnId === entry.turnId) {
+    if (
+      openGroupActivities !== null &&
+      openGroupRunId === entry.runId &&
+      !entry.activity.prominent &&
+      !openGroupHasProminent
+    ) {
       openGroupActivities.push(entry.activity);
       continue;
     }
 
     openGroupActivities = [entry.activity];
-    openGroupTurnId = entry.turnId;
+    openGroupRunId = entry.runId;
+    openGroupHasProminent = entry.activity.prominent === true;
     grouped.push({
       type: "activity-group",
       id: entry.id,
       createdAt: entry.createdAt,
-      turnId: entry.turnId,
+      runId: entry.runId,
       activities: openGroupActivities,
     });
   }
-
   return grouped;
 }
 
 function computeElapsedMs(startIso: string, endIso: string): number | null {
   const start = Date.parse(startIso);
   const end = Date.parse(endIso);
-  if (!Number.isFinite(start) || !Number.isFinite(end)) {
-    return null;
-  }
-  return Math.max(0, end - start);
+  return Number.isFinite(start) && Number.isFinite(end) ? Math.max(0, end - start) : null;
 }
 
-function maxIsoTimestamp(a: string | null, b: string | null): string | null {
-  if (a === null) return b;
-  if (b === null) return a;
-  const aMs = Date.parse(a);
-  const bMs = Date.parse(b);
-  if (!Number.isFinite(aMs)) return b;
-  if (!Number.isFinite(bMs)) return a;
-  return bMs > aMs ? b : a;
+function maxIsoTimestamp(left: string | null, right: string | null): string | null {
+  if (left === null) return right;
+  if (right === null) return left;
+  return Date.parse(right) > Date.parse(left) ? right : left;
 }
 
-function deriveUnsettledTurnId(latestTurn: ThreadFeedLatestTurn | null): TurnId | null {
-  if (!latestTurn) {
-    return null;
-  }
-  const settled = latestTurn.completedAt !== null && latestTurn.state !== "running";
-  return settled ? null : latestTurn.turnId;
+function unsettledRunId(latestRun: ThreadFeedLatestRun | null): RunId | null {
+  return threadFeedRunIsUnsettled(latestRun) ? latestRun.runId : null;
 }
 
-interface ThreadFeedTurnFold {
-  readonly turnId: TurnId;
+export function threadFeedRunIsUnsettled(
+  run: ThreadFeedLatestRun | null,
+): run is ThreadFeedLatestRun {
+  return (
+    run !== null &&
+    (run.status === "preparing" ||
+      run.status === "starting" ||
+      run.status === "running" ||
+      run.status === "waiting")
+  );
+}
+
+export function threadFeedActivityIsVisible(
+  activity: Pick<ThreadFeedActivity, "prominent" | "status" | "toolLike">,
+): boolean {
+  return activity.prominent || !(activity.toolLike && activity.status === "neutral");
+}
+
+interface ThreadFeedRunFold {
+  readonly runId: RunId;
   readonly createdAt: string;
   readonly hiddenEntryIds: ReadonlySet<string>;
   readonly label: string;
 }
 
-function deriveThreadFeedTurnFolds(
+function deriveThreadFeedRunFolds(
   feed: ReadonlyArray<ThreadFeedEntry>,
-  latestTurn: ThreadFeedLatestTurn | null,
-): ReadonlyMap<string, ThreadFeedTurnFold> {
-  const firstAssistantMessageIdByTurn = new Map<TurnId, string>();
-  const terminalAssistantMessageIdByTurn = new Map<TurnId, string>();
+  latestRun: ThreadFeedLatestRun | null,
+): ReadonlyMap<string, ThreadFeedRunFold> {
+  const terminalAssistantMessageIdByRun = new Map<RunId, string>();
   for (const entry of feed) {
-    if (entry.type === "message" && entry.message.role === "assistant" && entry.message.turnId) {
-      if (!firstAssistantMessageIdByTurn.has(entry.message.turnId)) {
-        firstAssistantMessageIdByTurn.set(entry.message.turnId, entry.id);
-      }
-      terminalAssistantMessageIdByTurn.set(entry.message.turnId, entry.id);
+    if (entry.type === "message" && entry.message.role === "assistant" && entry.message.runId) {
+      terminalAssistantMessageIdByRun.set(entry.message.runId, entry.id);
     }
   }
 
-  interface TurnGroup {
-    readonly entries: ThreadFeedEntry[];
-    readonly startBoundary: string | null;
-  }
-  const groupsByTurnId = new Map<TurnId, TurnGroup>();
+  const groupsByRunId = new Map<
+    RunId,
+    { entries: ThreadFeedEntry[]; startBoundary: string | null }
+  >();
   let pendingUserBoundary: string | null = null;
   for (const entry of feed) {
     if (entry.type === "message" && entry.message.role === "user") {
       pendingUserBoundary = entry.message.createdAt;
       continue;
     }
-    const turnId =
+    const runId =
       entry.type === "message" && entry.message.role === "assistant"
-        ? entry.message.turnId
+        ? entry.message.runId
         : entry.type === "activity-group"
-          ? entry.turnId
+          ? entry.runId
           : null;
-    if (!turnId) {
-      continue;
-    }
-    let group = groupsByTurnId.get(turnId);
+    if (!runId) continue;
+    let group = groupsByRunId.get(runId);
     if (!group) {
-      group = {
-        entries: [],
-        startBoundary: pendingUserBoundary,
-      };
+      group = { entries: [], startBoundary: pendingUserBoundary };
       pendingUserBoundary = null;
-      groupsByTurnId.set(turnId, group);
+      groupsByRunId.set(runId, group);
     }
     group.entries.push(entry);
   }
 
-  const unsettledTurnId = deriveUnsettledTurnId(latestTurn);
-  const foldsByAnchorId = new Map<string, ThreadFeedTurnFold>();
-  for (const [turnId, group] of groupsByTurnId) {
-    const { entries } = group;
-    if (turnId === unsettledTurnId) {
-      continue;
-    }
-    if (entries.some((entry) => entry.type === "message" && entry.message.streaming)) {
+  const activeRunId = unsettledRunId(latestRun);
+  const foldsByAnchorId = new Map<string, ThreadFeedRunFold>();
+  for (const [runId, group] of groupsByRunId) {
+    if (
+      runId === activeRunId ||
+      group.entries.some((entry) => entry.type === "message" && entry.message.streaming)
+    ) {
       continue;
     }
-
-    const firstAssistantMessageId = firstAssistantMessageIdByTurn.get(turnId);
-    const terminalAssistantMessageId = terminalAssistantMessageIdByTurn.get(turnId);
+    const terminalAssistantId = terminalAssistantMessageIdByRun.get(runId);
     const hiddenEntryIds = new Set(
-      entries
+      group.entries
         .filter(
           (entry) =>
-            entry.id !== firstAssistantMessageId && entry.id !== terminalAssistantMessageId,
+            entry.id !== terminalAssistantId &&
+            !(
+              entry.type === "activity-group" &&
+              entry.activities.some((activity) => activity.prominent)
+            ),
         )
         .map((entry) => entry.id),
     );
-    if (hiddenEntryIds.size === 0) {
-      continue;
-    }
-
-    const firstEntry = entries[0];
-    const firstHiddenEntry = entries.find((entry) => hiddenEntryIds.has(entry.id));
-    const lastEntry = entries.at(-1);
-    if (!firstEntry || !firstHiddenEntry || !lastEntry) {
-      continue;
-    }
-    const terminalEntry = terminalAssistantMessageId
-      ? entries.find((entry) => entry.id === terminalAssistantMessageId)
+    const firstEntry = group.entries[0];
+    const lastEntry = group.entries.at(-1);
+    if (hiddenEntryIds.size === 0 || !firstEntry || !lastEntry) continue;
+    const terminalEntry = terminalAssistantId
+      ? group.entries.find((entry) => entry.id === terminalAssistantId)
       : null;
-    const latestTurnMatches = latestTurn?.turnId === turnId;
+    const latestRunMatches = latestRun?.runId === runId;
     const lastEntryEnd =
       lastEntry.type === "message" ? lastEntry.message.updatedAt : lastEntry.createdAt;
     const elapsedMs =
-      latestTurnMatches && latestTurn.startedAt && latestTurn.completedAt
-        ? computeElapsedMs(latestTurn.startedAt, latestTurn.completedAt)
+      latestRunMatches && latestRun.startedAt && latestRun.completedAt
+        ? computeElapsedMs(latestRun.startedAt, latestRun.completedAt)
         : computeElapsedMs(
             group.startBoundary ?? firstEntry.createdAt,
             maxIsoTimestamp(
@@ -1260,20 +569,19 @@ function deriveThreadFeedTurnFolds(
             ) ?? lastEntryEnd,
           );
     const duration = elapsedMs === null ? null : formatDuration(elapsedMs);
-    const interrupted = latestTurnMatches && latestTurn.state === "interrupted";
-    const label = interrupted
-      ? duration
-        ? `You stopped after ${duration}`
-        : "You stopped this response"
-      : duration
-        ? `Worked for ${duration}`
-        : "Worked";
-
-    foldsByAnchorId.set(firstHiddenEntry.id, {
-      turnId,
-      createdAt: firstHiddenEntry.createdAt,
+    const interrupted =
+      latestRunMatches && (latestRun.status === "interrupted" || latestRun.status === "cancelled");
+    foldsByAnchorId.set(firstEntry.id, {
+      runId,
+      createdAt: firstEntry.createdAt,
       hiddenEntryIds,
-      label,
+      label: interrupted
+        ? duration
+          ? `You stopped after ${duration}`
+          : "You stopped this response"
+        : duration
+          ? `Worked for ${duration}`
+          : "Worked",
     });
   }
   return foldsByAnchorId;
@@ -1281,36 +589,33 @@ function deriveThreadFeedTurnFolds(
 
 export function deriveThreadFeedPresentation(
   feed: ReadonlyArray<ThreadFeedEntry>,
-  latestTurn: ThreadFeedLatestTurn | null,
-  expandedTurnIds: ReadonlySet<TurnId>,
+  latestRun: ThreadFeedLatestRun | null,
+  expandedRunIds: ReadonlySet<RunId>,
   expandedWorkGroupIds: ReadonlySet<string> = new Set(),
   activeWorkStartedAt: string | null = null,
 ): ThreadFeedEntry[] {
   const sourceFeed = feed.filter(
     (entry) =>
-      entry.type !== "turn-fold" && entry.type !== "work-toggle" && entry.type !== "working",
+      entry.type !== "run-fold" && entry.type !== "work-toggle" && entry.type !== "working",
   );
-  const foldsByAnchorId = deriveThreadFeedTurnFolds(sourceFeed, latestTurn);
+  const foldsByAnchorId = deriveThreadFeedRunFolds(sourceFeed, latestRun);
   const collapsedEntryIds = new Set<string>();
   for (const fold of foldsByAnchorId.values()) {
-    if (!expandedTurnIds.has(fold.turnId)) {
-      for (const entryId of fold.hiddenEntryIds) {
-        collapsedEntryIds.add(entryId);
-      }
+    if (!expandedRunIds.has(fold.runId)) {
+      for (const entryId of fold.hiddenEntryIds) collapsedEntryIds.add(entryId);
     }
   }
-
   const result: ThreadFeedEntry[] = [];
   for (const entry of sourceFeed) {
     const fold = foldsByAnchorId.get(entry.id);
     if (fold) {
       result.push({
-        type: "turn-fold",
-        id: `turn-fold:${fold.turnId}`,
+        type: "run-fold",
+        id: `run-fold:${fold.runId}`,
         createdAt: fold.createdAt,
-        turnId: fold.turnId,
+        runId: fold.runId,
         label: fold.label,
-        expanded: expandedTurnIds.has(fold.turnId),
+        expanded: expandedRunIds.has(fold.runId),
       });
     }
     if (!collapsedEntryIds.has(entry.id)) {
@@ -1329,7 +634,7 @@ export function deriveThreadFeedPresentation(
 
 function appendPresentedFeedEntry(
   result: ThreadFeedEntry[],
-  entry: Exclude<ThreadFeedEntry, { readonly type: "turn-fold" | "work-toggle" | "working" }>,
+  entry: Exclude<ThreadFeedEntry, { readonly type: "run-fold" | "work-toggle" | "working" }>,
   expandedWorkGroupIds: ReadonlySet<string>,
 ): void {
   if (entry.type !== "activity-group") {
@@ -1337,9 +642,7 @@ function appendPresentedFeedEntry(
     return;
   }
 
-  const activities = entry.activities.filter(
-    (activity) => !(activity.toolLike && activity.status === "neutral"),
-  );
+  const activities = entry.activities.filter(threadFeedActivityIsVisible);
   if (activities.length === 0) {
     return;
   }
@@ -1361,7 +664,7 @@ function appendPresentedFeedEntry(
       type: "activity-group",
       id: activity.id,
       createdAt: activity.createdAt,
-      turnId: activity.turnId,
+      runId: activity.runId,
       activities: [activity],
     });
   }
@@ -1369,118 +672,13 @@ function appendPresentedFeedEntry(
     type: "work-toggle",
     id: `work-toggle:${groupId}`,
     createdAt: entry.createdAt,
-    turnId: entry.turnId,
+    runId: entry.runId,
     groupId,
     hiddenCount,
     expanded,
     onlyToolActivities: activities.every((activity) => activity.toolLike),
   });
 }
-
-/**
- * Sorts activities into lifecycle order. `derivePendingApprovals` and
- * `derivePendingUserInputs` both expect this ordering; sorting once and
- * passing the result to both avoids re-sorting the full activity history
- * per derivation.
- */
-export function sortThreadActivities(
-  activities: ReadonlyArray<OrchestrationThreadActivity>,
-): ReadonlyArray<OrchestrationThreadActivity> {
-  return Arr.sort(activities, activityOrder);
-}
-
-export function derivePendingApprovals(
-  sortedActivities: ReadonlyArray<OrchestrationThreadActivity>,
-): PendingApproval[] {
-  const openByRequestId = new Map<ApprovalRequestId, PendingApproval>();
-
-  for (const activity of sortedActivities) {
-    const payload =
-      activity.payload && typeof activity.payload === "object"
-        ? (activity.payload as Record<string, unknown>)
-        : null;
-    const requestId = parseApprovalRequestId(payload?.requestId);
-    const requestKind = isProviderRequestKind(payload?.requestKind)
-      ? payload.requestKind
-      : requestKindFromRequestType(payload?.requestType);
-    const detail = typeof payload?.detail === "string" ? payload.detail : undefined;
-    const appName = typeof payload?.appName === "string" ? payload.appName : undefined;
-    const options = Array.isArray(payload?.options)
-      ? payload.options.filter(isProviderApprovalOption)
-      : undefined;
-
-    if (activity.kind === "approval.requested" && requestId && requestKind) {
-      openByRequestId.set(requestId, {
-        requestId,
-        requestKind,
-        createdAt: activity.createdAt,
-        ...(detail ? { detail } : {}),
-        ...(appName ? { appName } : {}),
-        ...(options && options.length > 0 ? { options } : {}),
-      });
-      continue;
-    }
-
-    if (activity.kind === "approval.resolved" && requestId) {
-      openByRequestId.delete(requestId);
-      continue;
-    }
-
-    if (
-      activity.kind === "provider.approval.respond.failed" &&
-      requestId &&
-      isStalePendingRequestFailureDetail(detail)
-    ) {
-      openByRequestId.delete(requestId);
-    }
-  }
-
-  return Arr.sortWith([...openByRequestId.values()], (s) => new Date(s.createdAt), Order.Date);
-}
-
-export function derivePendingUserInputs(
-  sortedActivities: ReadonlyArray<OrchestrationThreadActivity>,
-): PendingUserInput[] {
-  const openByRequestId = new Map<ApprovalRequestId, PendingUserInput>();
-
-  for (const activity of sortedActivities) {
-    const payload =
-      activity.payload && typeof activity.payload === "object"
-        ? (activity.payload as Record<string, unknown>)
-        : null;
-    const requestId = parseApprovalRequestId(payload?.requestId);
-    const detail = typeof payload?.detail === "string" ? payload.detail : undefined;
-
-    if (activity.kind === "user-input.requested" && requestId) {
-      const questions = parseUserInputQuestions(payload);
-      if (!questions) {
-        continue;
-      }
-      openByRequestId.set(requestId, {
-        requestId,
-        createdAt: activity.createdAt,
-        questions,
-      });
-      continue;
-    }
-
-    if (activity.kind === "user-input.resolved" && requestId) {
-      openByRequestId.delete(requestId);
-      continue;
-    }
-
-    if (
-      activity.kind === "provider.user-input.respond.failed" &&
-      requestId &&
-      isStalePendingRequestFailureDetail(detail)
-    ) {
-      openByRequestId.delete(requestId);
-    }
-  }
-
-  return Arr.sortWith(openByRequestId.values(), (s) => new Date(s.createdAt), Order.Date);
-}
-
 export function setPendingUserInputCustomAnswer(
   draft: PendingUserInputDraftAnswer | undefined,
   customAnswer: string,
@@ -1507,7 +705,7 @@ export function isPendingUserInputOptionSelected(
 }
 
 export function togglePendingUserInputOptionSelection(
-  question: UserInputQuestion,
+  question: ThreadUserInputQuestion,
   draft: PendingUserInputDraftAnswer | undefined,
   optionLabel: string,
 ): PendingUserInputDraftAnswer {
@@ -1534,7 +732,7 @@ export function togglePendingUserInputOptionSelection(
 }
 
 export function buildPendingUserInputAnswers(
-  questions: ReadonlyArray<UserInputQuestion>,
+  questions: ReadonlyArray<ThreadUserInputQuestion>,
   draftAnswers: Record<string, PendingUserInputDraftAnswer>,
 ): Record<string, string | ReadonlyArray<string>> | null {
   const answers: Record<string, string | ReadonlyArray<string>> = {};
@@ -1546,76 +744,103 @@ export function buildPendingUserInputAnswers(
     }
     answers[question.id] = answer;
   }
-
   return answers;
 }
 
+/**
+ * Projects the server-authored visible sequence into mobile row presentation.
+ * It deliberately preserves the incoming order and never rebuilds chat from
+ * separate message, plan, or work-entry collections.
+ */
 export function buildThreadFeed(
-  thread: OrchestrationThread,
+  visibleTurnItems: ReadonlyArray<OrchestrationV2ProjectedTurnItem>,
   options?: {
-    readonly loadedMessages?: ReadonlyArray<OrchestrationThread["messages"][number]>;
-    readonly localMessages?: ReadonlyArray<OrchestrationThread["messages"][number]>;
+    readonly localMessages?: ReadonlyArray<OrchestrationMessage>;
+    readonly anchoredMessages?: ReadonlyArray<OrchestrationMessage>;
   },
 ): ThreadFeedEntry[] {
-  const loadedMessages = options?.loadedMessages ?? thread.messages;
-  const messages = options?.localMessages
-    ? [...loadedMessages, ...options.localMessages]
-    : loadedMessages;
-  const oldestLoadedMessageCreatedAt =
-    options?.loadedMessages !== undefined ? (loadedMessages[0]?.createdAt ?? null) : null;
-  const workLogEntries = deriveWorkLogEntries(thread.activities);
-  const entries = Arr.sortWith(
-    [
-      ...messages.map<RawThreadFeedEntry>((message) => ({
+  const entries: RawThreadFeedEntry[] = [];
+  for (const row of visibleTurnItems) {
+    const item = row.item;
+    if (turnItemIsWorkspacePreparation(item)) continue;
+    // Match the web timeline: only the terminal interrupt result is useful to
+    // users; the preceding request is transient bookkeeping.
+    if (item.type === "run_interrupt_request") {
+      continue;
+    }
+    const createdAt = DateTime.formatIso(item.startedAt ?? item.updatedAt);
+    if (item.type === "user_message" || item.type === "assistant_message") {
+      const updatedAt = DateTime.formatIso(item.updatedAt);
+      entries.push({
         type: "message",
-        id: message.id,
-        createdAt: message.createdAt,
-        message,
-      })),
-      ...workLogEntries
-        .filter((entry) => {
-          if (options?.loadedMessages === undefined) {
-            return true;
-          }
-          return (
-            oldestLoadedMessageCreatedAt === null || entry.createdAt >= oldestLoadedMessageCreatedAt
-          );
-        })
-        .map<RawThreadFeedEntry>((entry) => {
-          const summary = workEntryHeading(entry);
-          const detail = workEntryPreview(entry);
-          const getFullDetail = memoizeValue(() => buildWorkEntryExpandedBody(entry));
-          const getCopyText = memoizeValue(() =>
-            [summary, detail, getFullDetail()]
-              .filter((value, index, values): value is string => {
-                return Boolean(value) && values.indexOf(value) === index;
-              })
-              .join("\n"),
-          );
-          return {
-            type: "activity",
-            id: entry.id,
-            createdAt: entry.createdAt,
-            turnId: entry.turnId,
-            activity: {
-              id: entry.id,
-              createdAt: entry.createdAt,
-              turnId: entry.turnId,
-              summary,
-              detail,
-              canExpand: workEntryHasExpandedBody(entry),
-              getFullDetail,
-              getCopyText,
-              icon: workEntryIcon(entry),
-              toolLike: workLogEntryIsToolLike(entry),
-              status: workEntryStatus(entry),
-            },
-          };
-        }),
-    ],
-    (s) => new Date(s.createdAt),
-    Order.Date,
+        id: item.messageId,
+        createdAt,
+        message: {
+          id: item.messageId,
+          role: item.type === "user_message" ? "user" : "assistant",
+          text: item.text,
+          attachments: item.type === "user_message" ? item.attachments : [],
+          runId: item.runId,
+          streaming: item.type === "assistant_message" && item.streaming,
+          ...(item.type === "user_message"
+            ? {
+                inputIntent: item.inputIntent,
+                createdBy: item.createdBy,
+                creationSource: item.creationSource,
+              }
+            : {}),
+          visibility: row.visibility,
+          sourceThreadId: row.sourceThreadId,
+          createdAt,
+          updatedAt,
+          projectedItem: row,
+        },
+      });
+      continue;
+    }
+    const activity = toFeedActivity(row);
+    entries.push({
+      type: "activity",
+      id: activity.id,
+      createdAt,
+      runId: item.runId,
+      activity,
+    });
+  }
+  const retainedMessageIds = new Set(
+    entries.flatMap((entry) => (entry.type === "message" ? [entry.id] : [])),
   );
-
+  const appendLocalMessage = (message: OrchestrationMessage): RawThreadFeedEntry => ({
+    type: "message",
+    id: message.id,
+    createdAt: message.createdAt,
+    message: {
+      id: message.id,
+      role: message.role === "assistant" ? "assistant" : "user",
+      text: message.text,
+      attachments: message.attachments ?? [],
+      runId: null,
+      streaming: message.streaming,
+      visibility: "local",
+      sourceThreadId: ThreadId.make("local-feedback"),
+      createdAt: message.createdAt,
+      updatedAt: message.updatedAt,
+    },
+  });
+  for (const message of options?.anchoredMessages ?? []) {
+    if (retainedMessageIds.has(message.id)) continue;
+    retainedMessageIds.add(message.id);
+    const entry = appendLocalMessage(message);
+    const insertionIndex = entries.findIndex(
+      (candidate) => candidate.createdAt > message.createdAt,
+    );
+    if (insertionIndex === -1) entries.push(entry);
+    else entries.splice(insertionIndex, 0, entry);
+  }
+  for (const message of options?.localMessages ?? []) {
+    if (retainedMessageIds.has(message.id)) continue;
+    retainedMessageIds.add(message.id);
+    entries.push(appendLocalMessage(message));
+  }
   return groupAdjacentActivities(entries);
 }
diff --git a/apps/mobile/src/lib/threadActivityInspector.test.ts b/apps/mobile/src/lib/threadActivityInspector.test.ts
new file mode 100644
index 000000000000..1d4ae359be52
--- /dev/null
+++ b/apps/mobile/src/lib/threadActivityInspector.test.ts
@@ -0,0 +1,257 @@
+import { EMPTY_V2_ITEM_SUPPORT } from "@t3tools/client-runtime/state/item-support";
+import {
+  CheckpointId,
+  CheckpointScopeId,
+  NodeId,
+  ProviderDriverKind,
+  ProviderInstanceId,
+  RunId,
+  ThreadId,
+  TurnItemId,
+  type OrchestrationV2ProjectedTurnItem,
+  type OrchestrationV2TurnItem,
+} from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+import { describe, expect, it } from "vite-plus/test";
+
+import { buildThreadFeed, type ThreadFeedActivity } from "./threadActivity";
+import { buildThreadActivityInspector } from "./threadActivityInspector";
+
+const threadId = ThreadId.make("thread-1");
+const sourceThreadId = ThreadId.make("thread-source");
+const runId = RunId.make("run-1");
+const nodeId = NodeId.make("node-1");
+const startedAt = DateTime.makeUnsafe("2026-06-20T00:00:00.000Z");
+const completedAt = DateTime.makeUnsafe("2026-06-20T00:00:02.000Z");
+
+function itemBase(id: string) {
+  return {
+    id: TurnItemId.make(id),
+    threadId,
+    runId,
+    nodeId,
+    providerThreadId: null,
+    providerTurnId: null,
+    nativeItemRef: null,
+    parentItemId: null,
+    ordinal: 0,
+    status: "completed" as const,
+    title: null,
+    startedAt,
+    completedAt,
+    updatedAt: completedAt,
+  };
+}
+
+function activityFor(item: OrchestrationV2TurnItem): ThreadFeedActivity {
+  const row: OrchestrationV2ProjectedTurnItem = {
+    position: 0,
+    visibility: "inherited",
+    sourceThreadId,
+    sourceItemId: item.id,
+    item,
+  };
+  const group = buildThreadFeed([row])[0];
+  if (group?.type !== "activity-group" || !group.activities[0]) {
+    throw new Error("Expected an activity group");
+  }
+  return group.activities[0];
+}
+
+describe("buildThreadActivityInspector", () => {
+  it("presents command lifecycle, execution support, output, and exit state", () => {
+    const item: OrchestrationV2TurnItem = {
+      ...itemBase("command"),
+      type: "command_execution",
+      input: "vp check",
+      output: "all checks passed",
+      exitCode: 0,
+    };
+    const support = {
+      ...EMPTY_V2_ITEM_SUPPORT,
+      item,
+      run: { status: "completed" } as never,
+      attempts: [
+        {
+          id: "attempt-1",
+          attemptOrdinal: 1,
+          status: "superseded",
+          reason: "initial",
+        },
+        {
+          id: "attempt-2",
+          attemptOrdinal: 2,
+          status: "completed",
+          reason: "steering_restart",
+        },
+      ] as never,
+      node: { kind: "tool_call", status: "completed" } as never,
+      providerSession: {
+        status: "ready",
+        model: "gpt-5.4",
+        cwd: "/workspace/project",
+      } as never,
+    };
+
+    const model = buildThreadActivityInspector(activityFor(item), support, sourceThreadId);
+    expect(model.fields).toEqual(
+      expect.arrayContaining([
+        { label: "Duration", value: "2.0s" },
+        { label: "Run", value: "completed" },
+        { label: "Working directory", value: "/workspace/project" },
+        { label: "Visibility", value: "inherited" },
+      ]),
+    );
+    expect(model.blocks).toEqual(
+      expect.arrayContaining([
+        expect.objectContaining({ label: "Command", value: "vp check" }),
+        expect.objectContaining({ label: "Output", value: "all checks passed" }),
+        expect.objectContaining({ label: "Exit", value: "Process exited with code 0" }),
+        expect.objectContaining({ label: "Attempt history" }),
+      ]),
+    );
+  });
+
+  it("exposes file and web result provenance plus dynamic structured data", () => {
+    const fileSearch: OrchestrationV2TurnItem = {
+      ...itemBase("file-search"),
+      type: "file_search",
+      pattern: "resolveSession",
+      results: [{ fileName: "src/session.ts", line: 42, preview: "function resolveSession()" }],
+    };
+    const fileModel = buildThreadActivityInspector(
+      activityFor(fileSearch),
+      EMPTY_V2_ITEM_SUPPORT,
+      sourceThreadId,
+    );
+    expect(fileModel.fileLinks).toEqual([
+      {
+        label: "src/session.ts — function resolveSession()",
+        path: "src/session.ts",
+        line: 42,
+      },
+    ]);
+
+    const webSearch: OrchestrationV2TurnItem = {
+      ...itemBase("web-search"),
+      type: "web_search",
+      patterns: ["Effect Schema docs"],
+      results: [
+        { title: "Schema", url: "https://effect.website/docs/schema", snippet: "Typed schemas" },
+      ],
+    };
+    const webModel = buildThreadActivityInspector(
+      activityFor(webSearch),
+      EMPTY_V2_ITEM_SUPPORT,
+      sourceThreadId,
+    );
+    expect(webModel.webLinks).toEqual([
+      { label: "Schema", url: "https://effect.website/docs/schema" },
+    ]);
+    expect(webModel.blocks).toEqual(
+      expect.arrayContaining([
+        expect.objectContaining({ label: "Schema", value: "Typed schemas" }),
+      ]),
+    );
+
+    const dynamicTool: OrchestrationV2TurnItem = {
+      ...itemBase("dynamic"),
+      type: "dynamic_tool",
+      toolName: "custom",
+      input: { nested: { value: 1 } },
+      output: { ok: true },
+    };
+    const dynamicModel = buildThreadActivityInspector(
+      activityFor(dynamicTool),
+      EMPTY_V2_ITEM_SUPPORT,
+      sourceThreadId,
+    );
+    expect(dynamicModel.blocks).toEqual(
+      expect.arrayContaining([
+        expect.objectContaining({ label: "Input", value: expect.stringContaining('"nested"') }),
+        expect.objectContaining({ label: "Output", value: expect.stringContaining('"ok"') }),
+      ]),
+    );
+    expect(dynamicModel.structuredDetails).toContain('"type": "dynamic_tool"');
+  });
+
+  it("enables rollback only for the matching ready checkpoint", () => {
+    const checkpointId = CheckpointId.make("checkpoint-1");
+    const scopeId = CheckpointScopeId.make("scope-1");
+    const item: OrchestrationV2TurnItem = {
+      ...itemBase("checkpoint"),
+      type: "checkpoint",
+      checkpointId,
+      scopeId,
+      files: [{ path: "src/main.ts", kind: "modified", additions: 2, deletions: 1 }],
+    };
+    const checkpoint = { id: checkpointId, scopeId, status: "ready" } as never;
+    const model = buildThreadActivityInspector(
+      activityFor(item),
+      {
+        ...EMPTY_V2_ITEM_SUPPORT,
+        item,
+        checkpoint,
+      },
+      sourceThreadId,
+    );
+
+    expect(model.canRollback).toBe(true);
+    expect(model.rollbackTarget).toEqual({
+      threadId: sourceThreadId,
+      checkpointId,
+      scopeId,
+    });
+
+    const inheritedModel = buildThreadActivityInspector(
+      activityFor(item),
+      {
+        ...EMPTY_V2_ITEM_SUPPORT,
+        item,
+        checkpoint,
+      },
+      ThreadId.make("child-thread"),
+    );
+    expect(inheritedModel.canRollback).toBe(false);
+    expect(inheritedModel.rollbackTarget).toBeNull();
+  });
+
+  it("prefers live subagent progress from supporting state", () => {
+    const item: OrchestrationV2TurnItem = {
+      ...itemBase("subagent"),
+      type: "subagent",
+      subagentId: nodeId,
+      origin: "provider_native",
+      driver: ProviderDriverKind.make("claude"),
+      providerInstanceId: ProviderInstanceId.make("claude"),
+      childThreadId: null,
+      prompt: "Audit the reducer",
+      progress: "Starting",
+      result: null,
+    };
+    const model = buildThreadActivityInspector(
+      activityFor(item),
+      {
+        ...EMPTY_V2_ITEM_SUPPORT,
+        item,
+        subagent: {
+          origin: "provider_native",
+          status: "running",
+          progress: "Reading projection tests",
+          result: null,
+        } as never,
+      },
+      sourceThreadId,
+    );
+
+    expect(model.fields).toContainEqual({
+      label: "Delegated task",
+      value: "provider native · running",
+    });
+    expect(model.blocks).toContainEqual({
+      label: "Progress",
+      value: "Reading projection tests",
+      monospaced: false,
+    });
+  });
+});
diff --git a/apps/mobile/src/lib/threadActivityInspector.ts b/apps/mobile/src/lib/threadActivityInspector.ts
new file mode 100644
index 000000000000..76fbd232ad91
--- /dev/null
+++ b/apps/mobile/src/lib/threadActivityInspector.ts
@@ -0,0 +1,308 @@
+import type { V2ItemSupport } from "@t3tools/client-runtime/state/item-support";
+import type { ThreadId } from "@t3tools/contracts";
+import { formatDuration } from "@t3tools/shared/orchestrationTiming";
+import * as DateTime from "effect/DateTime";
+
+import type { ThreadFeedActivity } from "./threadActivity";
+
+export interface ThreadActivityInspectorField {
+  readonly label: string;
+  readonly value: string;
+}
+
+export interface ThreadActivityInspectorBlock {
+  readonly label: string;
+  readonly value: string;
+  readonly monospaced: boolean;
+}
+
+export interface ThreadActivityFileLink {
+  readonly label: string;
+  readonly path: string;
+  readonly line?: number;
+}
+
+export interface ThreadActivityWebLink {
+  readonly label: string;
+  readonly url: string;
+}
+
+export interface ThreadActivityInspectorModel {
+  readonly fields: ReadonlyArray<ThreadActivityInspectorField>;
+  readonly blocks: ReadonlyArray<ThreadActivityInspectorBlock>;
+  readonly fileLinks: ReadonlyArray<ThreadActivityFileLink>;
+  readonly webLinks: ReadonlyArray<ThreadActivityWebLink>;
+  readonly canRollback: boolean;
+  readonly rollbackTarget: {
+    readonly threadId: ThreadId;
+    readonly checkpointId: string;
+    readonly scopeId: string;
+  } | null;
+  readonly structuredDetails: string;
+}
+
+function formatStructured(value: unknown): string {
+  if (typeof value === "string") return value;
+  try {
+    return JSON.stringify(value, null, 2) ?? String(value);
+  } catch {
+    return String(value);
+  }
+}
+
+function durationLabel(
+  startedAt: DateTime.Utc | null,
+  completedAt: DateTime.Utc | null,
+): string | null {
+  if (startedAt === null) return null;
+  const start = DateTime.toEpochMillis(startedAt);
+  const end = completedAt === null ? Date.now() : DateTime.toEpochMillis(completedAt);
+  return formatDuration(Math.max(0, end - start));
+}
+
+function addBlock(
+  blocks: ThreadActivityInspectorBlock[],
+  label: string,
+  value: unknown,
+  monospaced = true,
+): void {
+  if (value === undefined || value === null || value === "") return;
+  blocks.push({ label, value: formatStructured(value), monospaced });
+}
+
+export function buildThreadActivityInspector(
+  activity: ThreadFeedActivity,
+  support: V2ItemSupport,
+  currentThreadId: ThreadId,
+): ThreadActivityInspectorModel {
+  const row = activity.projectedItem;
+  const item = row.item;
+  const fields: ThreadActivityInspectorField[] = [
+    { label: "Item", value: item.type.replaceAll("_", " ") },
+    { label: "Status", value: item.status.replaceAll("_", " ") },
+  ];
+  const duration = durationLabel(item.startedAt, item.completedAt);
+  if (duration) fields.push({ label: "Duration", value: duration });
+  if (row.visibility !== "local") fields.push({ label: "Visibility", value: row.visibility });
+  if (support.run) fields.push({ label: "Run", value: support.run.status });
+
+  const latestAttempt = support.attempts.at(-1);
+  if (latestAttempt) {
+    fields.push({
+      label: "Attempt",
+      value: `${latestAttempt.attemptOrdinal} · ${latestAttempt.status} · ${latestAttempt.reason.replaceAll("_", " ")}`,
+    });
+  }
+  if (support.node) {
+    fields.push({
+      label: "Node",
+      value: `${support.node.kind.replaceAll("_", " ")} · ${support.node.status}`,
+    });
+  }
+  if (support.providerThread) {
+    fields.push({
+      label: "Provider thread",
+      value: `${support.providerThread.providerInstanceId} · ${support.providerThread.status}`,
+    });
+  }
+  if (support.providerTurn) {
+    fields.push({ label: "Provider turn", value: support.providerTurn.status });
+  }
+  if (support.providerSession) {
+    fields.push({
+      label: "Session",
+      value: `${support.providerSession.status} · ${support.providerSession.model ?? "default model"}`,
+    });
+    fields.push({ label: "Working directory", value: support.providerSession.cwd });
+  }
+  if (support.runtimeRequest) {
+    fields.push({
+      label: "Request",
+      value: `${support.runtimeRequest.status} · ${support.runtimeRequest.responseCapability.type.replaceAll("_", " ")}`,
+    });
+  }
+
+  const blocks: ThreadActivityInspectorBlock[] = [];
+  const fileLinks: ThreadActivityFileLink[] = [];
+  const webLinks: ThreadActivityWebLink[] = [];
+
+  if (support.attempts.length > 1) {
+    addBlock(
+      blocks,
+      "Attempt history",
+      support.attempts
+        .map(
+          (attempt) =>
+            `Attempt ${attempt.attemptOrdinal} · ${attempt.status} · ${attempt.reason.replaceAll("_", " ")}`,
+        )
+        .join("\n"),
+    );
+  }
+
+  switch (item.type) {
+    case "reasoning":
+      addBlock(blocks, "Reasoning", item.text, false);
+      break;
+    case "command_execution":
+      addBlock(blocks, "Command", item.input);
+      addBlock(blocks, "Output", item.output);
+      if (item.exitCode !== undefined) {
+        addBlock(blocks, "Exit", `Process exited with code ${item.exitCode}`);
+      }
+      break;
+    case "file_change":
+      fileLinks.push({ label: item.fileName, path: item.fileName });
+      if (item.additions !== undefined || item.deletions !== undefined) {
+        fields.push({
+          label: "Changes",
+          value: `+${item.additions ?? 0} −${item.deletions ?? 0}`,
+        });
+      }
+      addBlock(blocks, "Patch", item.diffStr);
+      addBlock(blocks, "Before", item.oldStr);
+      addBlock(blocks, "After", item.newStr);
+      break;
+    case "file_search":
+      addBlock(blocks, "Query", item.pattern);
+      for (const result of item.results ?? []) {
+        fileLinks.push({
+          label: result.preview ? `${result.fileName} — ${result.preview}` : result.fileName,
+          path: result.fileName,
+          ...(result.line === undefined ? {} : { line: result.line }),
+        });
+      }
+      break;
+    case "web_search":
+      addBlock(blocks, "Queries", item.patterns?.join("\n"));
+      for (const result of item.results ?? []) {
+        if (result.url) {
+          webLinks.push({
+            label: result.title ?? result.url,
+            url: result.url,
+          });
+        }
+        if (result.snippet)
+          addBlock(blocks, result.title ?? "Search result", result.snippet, false);
+      }
+      break;
+    case "dynamic_tool":
+      addBlock(blocks, "Input", item.input);
+      addBlock(blocks, "Output", item.output);
+      break;
+    case "approval_request":
+      addBlock(blocks, "Prompt", item.prompt, false);
+      break;
+    case "user_input_request":
+      addBlock(
+        blocks,
+        "Questions",
+        item.questions.map((question) => question.question).join("\n"),
+        false,
+      );
+      break;
+    case "checkpoint":
+      addBlock(
+        blocks,
+        "Files",
+        item.files
+          .map((file) => `${file.path}  +${file.additions} −${file.deletions}  ${file.kind}`)
+          .join("\n"),
+      );
+      break;
+    case "subagent":
+      addBlock(blocks, "Prompt", item.prompt, false);
+      addBlock(blocks, "Progress", support.subagent?.progress ?? item.progress, false);
+      addBlock(blocks, "Result", support.subagent?.result ?? item.result, false);
+      if (support.subagent) {
+        fields.push({
+          label: "Delegated task",
+          value: `${support.subagent.origin.replaceAll("_", " ")} · ${support.subagent.status}`,
+        });
+      }
+      break;
+    case "handoff":
+      addBlock(blocks, "Summary", item.summary, false);
+      fields.push({
+        label: "Handoff",
+        value: `${item.strategy.replaceAll("_", " ")} · ${support.contextHandoff?.status ?? item.status}`,
+      });
+      if (support.contextTransfer) {
+        fields.push({
+          label: "Transfer",
+          value: `${support.contextTransfer.type.replaceAll("_", " ")} · ${support.contextTransfer.status}`,
+        });
+        if (support.contextTransfer.resolution) {
+          fields.push({
+            label: "Context",
+            value: support.contextTransfer.resolution.strategy.replaceAll("_", " "),
+          });
+        }
+      }
+      break;
+    case "error":
+      addBlock(blocks, "Error", item.failure.message, false);
+      if (item.failure.code) fields.push({ label: "Code", value: item.failure.code });
+      if (item.failure.retryable !== null) {
+        fields.push({ label: "Retryable", value: item.failure.retryable ? "yes" : "no" });
+      }
+      break;
+    case "proposed_plan":
+      addBlock(blocks, "Plan", item.markdown, false);
+      break;
+    case "todo_list":
+      addBlock(
+        blocks,
+        "Tasks",
+        item.steps
+          .map((step) => `${step.status === "completed" ? "✓" : "○"} ${step.text}`)
+          .join("\n"),
+        false,
+      );
+      addBlock(blocks, "Explanation", item.explanation, false);
+      break;
+    case "compaction":
+      addBlock(blocks, "Summary", item.summary, false);
+      if (item.beforeTokenCount !== undefined || item.afterTokenCount !== undefined) {
+        fields.push({
+          label: "Context tokens",
+          value: `${item.beforeTokenCount ?? "?"} → ${item.afterTokenCount ?? "?"}`,
+        });
+      }
+      break;
+    case "run_interrupt_request":
+    case "run_interrupt_result":
+      addBlock(blocks, "Message", item.message, false);
+      break;
+    case "fork":
+    case "thread_created":
+    case "user_message":
+    case "assistant_message":
+      break;
+  }
+
+  const checkpoint =
+    item.type === "checkpoint" && row.sourceThreadId === currentThreadId
+      ? support.checkpoint
+      : null;
+  return {
+    fields,
+    blocks,
+    fileLinks,
+    webLinks,
+    canRollback: checkpoint?.status === "ready",
+    rollbackTarget:
+      checkpoint?.status === "ready"
+        ? {
+            threadId: row.sourceThreadId,
+            checkpointId: checkpoint.id,
+            scopeId: checkpoint.scopeId,
+          }
+        : null,
+    structuredDetails: formatStructured({
+      visibility: row.visibility,
+      sourceThreadId: row.sourceThreadId,
+      sourceItemId: row.sourceItemId,
+      item,
+    }),
+  };
+}
diff --git a/apps/mobile/src/state/queries.ts b/apps/mobile/src/state/queries.ts
index 0c0da1f847d5..f65b0960b99d 100644
--- a/apps/mobile/src/state/queries.ts
+++ b/apps/mobile/src/state/queries.ts
@@ -1,11 +1,5 @@
 import type { VcsRefTarget } from "@t3tools/client-runtime/state/vcs";
-import type {
-  EnvironmentId,
-  OrchestrationThread,
-  ThreadId,
-  VcsListRefsResult,
-  VcsRef,
-} from "@t3tools/contracts";
+import type { EnvironmentId, ThreadId, VcsListRefsResult, VcsRef } from "@t3tools/contracts";
 import {
   createThreadSearchResultsAtomFamily,
   makeThreadSearchKey,
@@ -21,7 +15,6 @@ import { appAtomRegistry } from "./atom-registry";
 import { orchestrationEnvironment } from "./orchestration";
 import { projectEnvironment } from "./projects";
 import { useEnvironmentQuery } from "./query";
-import { useEnvironmentThread } from "./threads";
 import { vcsEnvironment } from "./vcs";
 import {
   buildCheckpointDiffTargets,
@@ -50,13 +43,6 @@ const threadSearchResultsAtom = createThreadSearchResultsAtomFamily({
   labelPrefix: "mobile:thread-search",
 });
 
-export interface ThreadDetailView {
-  readonly data: OrchestrationThread | null;
-  readonly error: string | null;
-  readonly isPending: boolean;
-  readonly isDeleted: boolean;
-}
-
 export interface ComposerPathSearchTarget {
   readonly environmentId: EnvironmentId | null;
   readonly cwd: string | null;
@@ -103,19 +89,6 @@ export function useThreadSearch(
   };
 }
 
-export function useThreadDetail(
-  environmentId: EnvironmentId | null,
-  threadId: ThreadId | null,
-): ThreadDetailView {
-  const state = useEnvironmentThread(environmentId, threadId);
-  return {
-    data: Option.getOrNull(state.data),
-    error: Option.getOrNull(state.error),
-    isPending: state.status === "synchronizing",
-    isDeleted: state.status === "deleted",
-  };
-}
-
 export function useBranches(input: {
   readonly environmentId: EnvironmentId | null;
   readonly cwd: string | null;
diff --git a/apps/mobile/src/state/threads.ts b/apps/mobile/src/state/threads.ts
index 7f2471230510..34dc85f16899 100644
--- a/apps/mobile/src/state/threads.ts
+++ b/apps/mobile/src/state/threads.ts
@@ -38,8 +38,9 @@ export function useEnvironmentThread(
       ? environmentThreads.stateAtom(environmentId, threadId)
       : EMPTY_THREAD_STATE_ATOM,
   );
-  return Option.getOrElse(
+  const state = Option.getOrElse(
     AsyncResult.value(result),
     () => EMPTY_ENVIRONMENT_THREAD_STATE,
   ) as EnvironmentThreadState;
+  return state;
 }
diff --git a/apps/mobile/src/state/use-pending-new-tasks.ts b/apps/mobile/src/state/use-pending-new-tasks.ts
index ccfe1527b3dc..bbb508983fff 100644
--- a/apps/mobile/src/state/use-pending-new-tasks.ts
+++ b/apps/mobile/src/state/use-pending-new-tasks.ts
@@ -1,6 +1,6 @@
 import { useMemo } from "react";
+import { deriveThreadTitleSeed } from "@t3tools/client-runtime/operations";
 
-import { deriveThreadTitleFromPrompt } from "../lib/projectThreadStartTurn";
 import {
   flattenQueuedThreadMessages,
   type QueuedThreadCreation,
@@ -26,7 +26,7 @@ export function usePendingNewTasks(): ReadonlyArray<PendingNewTask> {
       tasks.push({
         message,
         creation: message.creation,
-        title: deriveThreadTitleFromPrompt(message.text),
+        title: deriveThreadTitleSeed({ text: message.text, attachments: message.attachments }),
       });
     }
     tasks.sort((left, right) => right.message.createdAt.localeCompare(left.message.createdAt));
diff --git a/apps/mobile/src/state/use-selected-thread-requests.ts b/apps/mobile/src/state/use-selected-thread-requests.ts
index 30b3a0704f8e..c7c6c02fa2bf 100644
--- a/apps/mobile/src/state/use-selected-thread-requests.ts
+++ b/apps/mobile/src/state/use-selected-thread-requests.ts
@@ -1,26 +1,23 @@
 import { useAtomValue } from "@effect/atom-react";
 import { useCallback, useMemo, useState } from "react";
 
+import { type ProviderApprovalDecision, type RuntimeRequestId } from "@t3tools/contracts";
 import {
-  ApprovalRequestId,
-  type ProviderApprovalDecision,
-  type UserInputQuestion,
-} from "@t3tools/contracts";
+  derivePendingThreadRequests,
+  type ThreadUserInputQuestion,
+} from "@t3tools/client-runtime/state/thread-requests";
 import { Atom } from "effect/unstable/reactivity";
 
 import { threadEnvironment } from "../state/threads";
 import { scopedRequestKey } from "../lib/scopedEntities";
 import {
   buildPendingUserInputAnswers,
-  derivePendingApprovals,
-  derivePendingUserInputs,
   setPendingUserInputCustomAnswer,
-  sortThreadActivities,
   togglePendingUserInputOptionSelection,
   type PendingUserInputDraftAnswer,
 } from "../lib/threadActivity";
 import { appAtomRegistry } from "./atom-registry";
-import { useSelectedThreadDetail } from "./use-thread-detail";
+import { useSelectedThreadProjection } from "./use-thread-detail";
 import { useThreadSelection } from "./use-thread-selection";
 import { useAtomCommand } from "./use-atom-command";
 
@@ -30,7 +27,7 @@ const userInputDraftsByRequestKeyAtom = Atom.make<
 
 function setUserInputDraftOption(
   requestKey: string,
-  question: UserInputQuestion,
+  question: ThreadUserInputQuestion,
   label: string,
 ): void {
   const current = appAtomRegistry.get(userInputDraftsByRequestKeyAtom);
@@ -75,27 +72,21 @@ export function useSelectedThreadRequests() {
     "thread user input response",
   );
   const { selectedThread: selectedThreadShell } = useThreadSelection();
-  const selectedThread = useSelectedThreadDetail();
+  const selectedThread = useSelectedThreadProjection();
   const userInputDraftsByRequestKey = useAtomValue(userInputDraftsByRequestKeyAtom);
-  const [respondingApprovalId, setRespondingApprovalId] = useState<ApprovalRequestId | null>(null);
-  const [respondingUserInputId, setRespondingUserInputId] = useState<ApprovalRequestId | null>(
-    null,
-  );
-
-  // Sort once; both derivations expect the same lifecycle ordering.
-  const sortedActivities = useMemo(
-    () => (selectedThread ? sortThreadActivities(selectedThread.activities) : []),
+  const [respondingApprovalId, setRespondingApprovalId] = useState<RuntimeRequestId | null>(null);
+  const [respondingUserInputId, setRespondingUserInputId] = useState<RuntimeRequestId | null>(null);
+
+  const pendingRequests = useMemo(
+    () =>
+      selectedThread === null
+        ? { approvals: [], userInputs: [] }
+        : derivePendingThreadRequests(selectedThread.projection),
     [selectedThread],
   );
-  const activePendingApprovals = useMemo(
-    () => derivePendingApprovals(sortedActivities),
-    [sortedActivities],
-  );
+  const activePendingApprovals = pendingRequests.approvals;
   const activePendingApproval = activePendingApprovals[0] ?? null;
-  const activePendingUserInputs = useMemo(
-    () => derivePendingUserInputs(sortedActivities),
-    [sortedActivities],
-  );
+  const activePendingUserInputs = pendingRequests.userInputs;
   const activePendingUserInput = activePendingUserInputs[0] ?? null;
   const activePendingUserInputDrafts =
     activePendingUserInput && selectedThreadShell
@@ -108,7 +99,7 @@ export function useSelectedThreadRequests() {
     : null;
 
   const onSelectUserInputOption = useCallback(
-    (requestId: ApprovalRequestId, question: UserInputQuestion, label: string) => {
+    (requestId: RuntimeRequestId, question: ThreadUserInputQuestion, label: string) => {
       if (!selectedThreadShell) {
         return;
       }
@@ -120,7 +111,7 @@ export function useSelectedThreadRequests() {
   );
 
   const onChangeUserInputCustomAnswer = useCallback(
-    (requestId: ApprovalRequestId, questionId: string, customAnswer: string) => {
+    (requestId: RuntimeRequestId, questionId: string, customAnswer: string) => {
       if (!selectedThreadShell) {
         return;
       }
@@ -132,10 +123,16 @@ export function useSelectedThreadRequests() {
   );
 
   const onRespondToApproval = useCallback(
-    async (requestId: ApprovalRequestId, decision: ProviderApprovalDecision) => {
+    async (requestId: RuntimeRequestId, decision: ProviderApprovalDecision) => {
       if (!selectedThreadShell) {
         return;
       }
+      if (
+        activePendingApprovals.find((approval) => approval.requestId === requestId)
+          ?.responseCapability !== "live"
+      ) {
+        return;
+      }
 
       setRespondingApprovalId(requestId);
       const result = await respondToApproval({
@@ -149,11 +146,16 @@ export function useSelectedThreadRequests() {
       setRespondingApprovalId((current) => (current === requestId ? null : current));
       return result;
     },
-    [respondToApproval, selectedThreadShell],
+    [activePendingApprovals, respondToApproval, selectedThreadShell],
   );
 
   const onSubmitUserInput = useCallback(async () => {
-    if (!selectedThreadShell || !activePendingUserInput || !activePendingUserInputAnswers) {
+    if (
+      !selectedThreadShell ||
+      !activePendingUserInput ||
+      activePendingUserInput.responseCapability !== "live" ||
+      !activePendingUserInputAnswers
+    ) {
       return;
     }
 
diff --git a/apps/mobile/src/state/use-selected-thread-worktree.ts b/apps/mobile/src/state/use-selected-thread-worktree.ts
index c5046c5b135c..d39df1d77206 100644
--- a/apps/mobile/src/state/use-selected-thread-worktree.ts
+++ b/apps/mobile/src/state/use-selected-thread-worktree.ts
@@ -1,20 +1,21 @@
 import { useMemo } from "react";
 
-import { useSelectedThreadDetail } from "./use-thread-detail";
+import { useSelectedThreadProjection } from "./use-thread-detail";
 import { useThreadSelection } from "./use-thread-selection";
 import { resolvePreferredThreadWorktreePath } from "../features/terminal/terminalLaunchContext";
 
 export function useSelectedThreadWorktree() {
   const { selectedThread, selectedThreadProject } = useThreadSelection();
-  const selectedThreadDetail = useSelectedThreadDetail();
+  const selectedThreadDetail = useSelectedThreadProjection();
+  const detailWorktreePath = selectedThreadDetail?.projection.thread.worktreePath ?? null;
 
   const selectedThreadWorktreePath = useMemo(
     () =>
       resolvePreferredThreadWorktreePath({
         threadShellWorktreePath: selectedThread?.worktreePath ?? null,
-        threadDetailWorktreePath: selectedThreadDetail?.worktreePath ?? null,
+        threadDetailWorktreePath: detailWorktreePath,
       }),
-    [selectedThread?.worktreePath, selectedThreadDetail?.worktreePath],
+    [detailWorktreePath, selectedThread?.worktreePath],
   );
 
   return {
diff --git a/apps/mobile/src/state/use-thread-composer-state.ts b/apps/mobile/src/state/use-thread-composer-state.ts
index dd7ace60ad99..9d469fc28968 100644
--- a/apps/mobile/src/state/use-thread-composer-state.ts
+++ b/apps/mobile/src/state/use-thread-composer-state.ts
@@ -1,5 +1,11 @@
 import { useAtomValue } from "@effect/atom-react";
-import { useCallback, useEffect, useMemo, useState } from "react";
+import { threadRuntimeIsActive } from "@t3tools/client-runtime/state/shell";
+import {
+  deriveThreadActivityRun,
+  deriveThreadRuntime,
+  threadRuntimeHasInterruptibleRun,
+} from "@t3tools/client-runtime/state/thread-execution";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { Alert } from "react-native";
 import * as Cause from "effect/Cause";
 
@@ -14,6 +20,7 @@ import {
 } from "@t3tools/contracts";
 import { safeErrorLogAttributes } from "@t3tools/client-runtime/errors";
 import {
+  beginCodexFeedbackSubmission,
   codexFeedbackMessage,
   parseCodexFeedbackCommand,
   submitCodexFeedback,
@@ -47,7 +54,10 @@ import {
   useComposerDraft,
 } from "./use-composer-drafts";
 import { setPendingConnectionError } from "../state/use-remote-environment-registry";
-import { useSelectedThreadDetail } from "../state/use-thread-detail";
+import {
+  useSelectedThreadProjection,
+  useSelectedThreadVisibleTurnItems,
+} from "../state/use-thread-detail";
 import { useThreadSelection } from "../state/use-thread-selection";
 import { enqueueThreadOutboxMessage } from "./thread-outbox";
 import { useThreadOutboxMessages } from "./use-thread-outbox";
@@ -87,12 +97,14 @@ export function useThreadDraftForThread(input: {
 
 export function useThreadComposerState() {
   const { selectedThread: selectedThreadShell, selectedEnvironmentRuntime } = useThreadSelection();
-  const selectedThreadDetail = useSelectedThreadDetail();
+  const selectedThreadProjection = useSelectedThreadProjection();
+  const selectedThreadVisibleTurnItems = useSelectedThreadVisibleTurnItems();
   const composerDrafts = useAtomValue(composerDraftsAtom);
   const queuedMessagesByThreadKey = useThreadOutboxMessages();
   const [feedbackSubmissionsByThreadKey, setFeedbackSubmissionsByThreadKey] = useState<
     Record<string, ReadonlyArray<CodexFeedbackSubmission>>
   >({});
+  const feedbackUploadsInFlightRef = useRef(new Set<string>());
   const uploadThreadFeedback = useAtomCommand(threadEnvironment.uploadFeedback, {
     reportFailure: false,
   });
@@ -109,54 +121,67 @@ export function useThreadComposerState() {
     [queuedMessagesByThreadKey, selectedThreadKey],
   );
   const selectedThreadFeed = useMemo(() => {
-    if (!selectedThreadDetail) {
-      return [];
-    }
     const submissions = selectedThreadKey
       ? (feedbackSubmissionsByThreadKey[selectedThreadKey] ?? [])
       : [];
-    return buildThreadFeed(selectedThreadDetail, {
-      localMessages: submissions.flatMap((submission) =>
+    return buildThreadFeed(selectedThreadVisibleTurnItems, {
+      anchoredMessages: submissions.flatMap((submission) =>
         submission.status === "interrupted"
           ? []
           : [codexFeedbackMessage(submission), codexFeedbackMessage(submission, "assistant")],
       ),
     });
-  }, [feedbackSubmissionsByThreadKey, selectedThreadDetail, selectedThreadKey]);
+  }, [feedbackSubmissionsByThreadKey, selectedThreadKey, selectedThreadVisibleTurnItems]);
 
   const selectedDraft = selectedThreadKey ? composerDrafts[selectedThreadKey] : null;
   const draftMessage = selectedDraft?.text ?? "";
   const draftAttachments = selectedDraft?.attachments ?? [];
   const selectedThreadQueueCount = selectedThreadQueuedMessages.length;
-  const selectedThread = selectedThreadDetail ?? selectedThreadShell;
+  const selectedThread = selectedThreadShell;
   const modelSelection = selectedDraft?.modelSelection ?? selectedThread?.modelSelection ?? null;
   const runtimeMode = selectedDraft?.runtimeMode ?? selectedThread?.runtimeMode ?? null;
   const interactionMode = selectedDraft?.interactionMode ?? selectedThread?.interactionMode ?? null;
+  const selectedThreadRuntime = useMemo(
+    () =>
+      selectedThreadProjection
+        ? deriveThreadRuntime(selectedThreadProjection.projection)
+        : (selectedThreadShell?.runtime ?? null),
+    [selectedThreadProjection, selectedThreadShell?.runtime],
+  );
+  const selectedThreadActivityRun = useMemo(
+    () =>
+      selectedThreadProjection
+        ? deriveThreadActivityRun(selectedThreadProjection.projection)
+        : (selectedThreadShell?.latestRun ?? null),
+    [selectedThreadProjection, selectedThreadShell?.latestRun],
+  );
 
   const selectedThreadSessionActivity = useMemo(() => {
-    const selectedThread = selectedThreadDetail ?? selectedThreadShell;
-    if (!selectedThread?.session) {
+    if (!selectedThreadRuntime) {
       return null;
     }
 
     return {
-      orchestrationStatus: selectedThread.session.status,
-      activeTurnId: selectedThread.session.activeTurnId ?? undefined,
+      orchestrationStatus: selectedThreadRuntime.status,
+      activeRunId: selectedThreadRuntime.activeRunId ?? undefined,
     };
-  }, [selectedThreadDetail, selectedThreadShell]);
+  }, [selectedThreadRuntime]);
 
   const activeWorkStartedAt = useMemo(() => {
-    const selectedThread = selectedThreadDetail ?? selectedThreadShell;
-    if (!selectedThread) {
+    if (!selectedThreadShell) {
       return null;
     }
-
     return deriveActiveWorkStartedAt(
-      selectedThread.latestTurn,
+      selectedThreadActivityRun,
       selectedThreadSessionActivity,
       null,
     );
-  }, [selectedThreadDetail, selectedThreadSessionActivity, selectedThreadShell]);
+  }, [selectedThreadActivityRun, selectedThreadSessionActivity, selectedThreadShell]);
+
+  const activeThreadBusy = threadRuntimeIsActive(selectedThreadRuntime);
+  const interruptibleRunId = threadRuntimeHasInterruptibleRun(selectedThreadRuntime)
+    ? (selectedThreadRuntime?.activeRunId ?? null)
+    : null;
 
   const onSendMessage = useCallback(async () => {
     if (!selectedThreadShell) {
@@ -165,7 +190,7 @@ export function useThreadComposerState() {
 
     const threadKey = scopedThreadKey(selectedThreadShell.environmentId, selectedThreadShell.id);
     const draft = getComposerDraftSnapshot(threadKey);
-    const thread = selectedThreadDetail ?? selectedThreadShell;
+    const thread = selectedThreadShell;
     const text = draft.text.trim();
     const attachments = draft.attachments;
     if (text.length === 0 && attachments.length === 0) {
@@ -176,15 +201,19 @@ export function useThreadComposerState() {
       (entry) => entry.instanceId === thread.modelSelection.instanceId,
     );
     const feedbackCommand =
-      attachments.length === 0 &&
-      (provider?.driver === "codex" || thread.session?.providerName === "codex")
+      attachments.length === 0 && provider?.driver === "codex"
         ? parseCodexFeedbackCommand(text)
         : null;
     if (feedbackCommand) {
-      if (thread.session === null) {
+      if (thread.activeProviderThreadId === null) {
         Alert.alert("Start a Codex thread first", "Send a message before you submit feedback.");
         return null;
       }
+      const finishFeedbackSubmission = beginCodexFeedbackSubmission(
+        feedbackUploadsInFlightRef.current,
+        threadKey,
+      );
+      if (finishFeedbackSubmission === null) return null;
       const metadata = makeQueuedMessageMetadata();
       const result = await submitCodexFeedback({
         submission: {
@@ -207,22 +236,18 @@ export function useThreadComposerState() {
         },
         upload: () =>
           uploadThreadFeedback({
-            environmentId: selectedThreadShell.environmentId,
-            input: {
-              threadId: selectedThreadShell.id,
-              ...feedbackCommand,
-            },
+            environmentId: thread.environmentId,
+            input: { threadId: thread.id, ...feedbackCommand },
           }),
-      });
+      }).finally(finishFeedbackSubmission);
       if (result._tag === "Failure") {
-        if (isAtomCommandInterrupted(result)) {
-          return null;
+        if (!isAtomCommandInterrupted(result)) {
+          const error = Cause.squash(result.cause);
+          Alert.alert(
+            "Could not send feedback to OpenAI",
+            error instanceof Error ? error.message : "An error occurred.",
+          );
         }
-        const error = Cause.squash(result.cause);
-        Alert.alert(
-          "Could not send feedback to OpenAI",
-          error instanceof Error ? error.message : "An error occurred.",
-        );
         return null;
       }
       const feedbackId = result.value.feedbackId;
@@ -270,7 +295,6 @@ export function useThreadComposerState() {
     return messageId;
   }, [
     selectedEnvironmentRuntime?.serverConfig?.providers,
-    selectedThreadDetail,
     selectedThreadShell,
     uploadThreadFeedback,
   ]);
@@ -395,6 +419,7 @@ export function useThreadComposerState() {
 
   return {
     selectedThreadFeed,
+    selectedThreadActivityRun,
     selectedThreadQueueCount,
     activeWorkStartedAt,
     draftMessage,
@@ -402,6 +427,8 @@ export function useThreadComposerState() {
     modelSelection,
     runtimeMode,
     interactionMode,
+    activeThreadBusy,
+    interruptibleRunId,
     onChangeDraftMessage,
     onPickDraftImages,
     onPasteIntoDraft,
diff --git a/apps/mobile/src/state/use-thread-detail.ts b/apps/mobile/src/state/use-thread-detail.ts
index 388b4d9afcb9..8c48aa880ec5 100644
--- a/apps/mobile/src/state/use-thread-detail.ts
+++ b/apps/mobile/src/state/use-thread-detail.ts
@@ -1,9 +1,18 @@
-import type { EnvironmentId, ThreadId } from "@t3tools/contracts";
-import * as Option from "effect/Option";
+import { useAtomValue } from "@effect/atom-react";
+import type { EnvironmentThread } from "@t3tools/client-runtime/state/shell";
+import type { EnvironmentId, OrchestrationV2ThreadProjection, ThreadId } from "@t3tools/contracts";
+import { Atom } from "effect/unstable/reactivity";
 
-import { useEnvironmentThread } from "./threads";
+import { environmentThreadDetails, useEnvironmentThread } from "./threads";
 import { useThreadSelection } from "./use-thread-selection";
 
+const EMPTY_THREAD_PROJECTION_ATOM = Atom.make<EnvironmentThread | null>(null).pipe(
+  Atom.withLabel("mobile-thread-projection:empty"),
+);
+const EMPTY_VISIBLE_TURN_ITEMS_ATOM = Atom.make<
+  OrchestrationV2ThreadProjection["visibleTurnItems"]
+>(Object.freeze([])).pipe(Atom.withLabel("mobile-thread-visible-turn-items:empty"));
+
 export interface ThreadDetailTarget {
   readonly environmentId: EnvironmentId | null;
   readonly threadId: ThreadId | null;
@@ -21,6 +30,42 @@ export function useSelectedThreadDetailState() {
   });
 }
 
-export function useSelectedThreadDetail() {
-  return Option.getOrNull(useSelectedThreadDetailState().data);
+export function useThreadProjection(target: ThreadDetailTarget): EnvironmentThread | null {
+  return useAtomValue(
+    target.environmentId === null || target.threadId === null
+      ? EMPTY_THREAD_PROJECTION_ATOM
+      : environmentThreadDetails.threadAtom({
+          environmentId: target.environmentId,
+          threadId: target.threadId,
+        }),
+  );
+}
+
+export function useSelectedThreadProjection(): EnvironmentThread | null {
+  const { selectedThread } = useThreadSelection();
+  return useThreadProjection({
+    environmentId: selectedThread?.environmentId ?? null,
+    threadId: selectedThread?.id ?? null,
+  });
+}
+
+export function useThreadVisibleTurnItems(
+  target: ThreadDetailTarget,
+): OrchestrationV2ThreadProjection["visibleTurnItems"] {
+  return useAtomValue(
+    target.environmentId === null || target.threadId === null
+      ? EMPTY_VISIBLE_TURN_ITEMS_ATOM
+      : environmentThreadDetails.visibleTurnItemsAtom({
+          environmentId: target.environmentId,
+          threadId: target.threadId,
+        }),
+  );
+}
+
+export function useSelectedThreadVisibleTurnItems(): OrchestrationV2ThreadProjection["visibleTurnItems"] {
+  const { selectedThread } = useThreadSelection();
+  return useThreadVisibleTurnItems({
+    environmentId: selectedThread?.environmentId ?? null,
+    threadId: selectedThread?.id ?? null,
+  });
 }
diff --git a/apps/mobile/src/state/use-thread-outbox-drain.ts b/apps/mobile/src/state/use-thread-outbox-drain.ts
index 68c973ff97e3..df57e5f7bc3c 100644
--- a/apps/mobile/src/state/use-thread-outbox-drain.ts
+++ b/apps/mobile/src/state/use-thread-outbox-drain.ts
@@ -1,9 +1,11 @@
 import { useAtomValue } from "@effect/atom-react";
-import type {
-  EnvironmentProject,
-  EnvironmentThreadShell,
+import {
+  threadRuntimeIsActive,
+  type EnvironmentProject,
+  type EnvironmentThreadShell,
 } from "@t3tools/client-runtime/state/shell";
 import type { AtomCommandResult } from "@t3tools/client-runtime/state/runtime";
+import { deriveThreadTitleSeed } from "@t3tools/client-runtime/operations";
 import {
   CommandId,
   DEFAULT_PROVIDER_INTERACTION_MODE,
@@ -221,6 +223,7 @@ export function useThreadOutboxDrain(): void {
         environmentId: queuedMessage.environmentId,
         input: {
           commandId: queuedMessage.commandId,
+          creationSource: "mobile",
           threadId: queuedMessage.threadId,
           message: {
             messageId: queuedMessage.messageId,
@@ -229,9 +232,14 @@ export function useThreadOutboxDrain(): void {
             attachments: toUploadChatImageAttachments(queuedMessage.attachments),
           },
           modelSelection: settings.modelSelection,
+          titleSeed: deriveThreadTitleSeed({
+            text: queuedMessage.text,
+            attachments: queuedMessage.attachments,
+          }),
           runtimeMode: settings.runtimeMode,
           interactionMode: settings.interactionMode,
           createdAt: queuedMessage.createdAt,
+          dispatchMode: "start",
         },
       });
       return completeDelivery(deliveryResult);
@@ -314,7 +322,7 @@ export function useThreadOutboxDrain(): void {
         threadExists: thread !== undefined,
         shellStatus,
         environmentConnected: environment?.connectionState === "connected",
-        threadBusy: thread?.session?.status === "running" || thread?.session?.status === "starting",
+        threadBusy: threadRuntimeIsActive(thread?.runtime),
       });
       if (deliveryAction === "wait") {
         continue;
diff --git a/apps/mobile/src/state/use-thread-selection.ts b/apps/mobile/src/state/use-thread-selection.ts
index 8e340ef33bd4..890c0f3008ab 100644
--- a/apps/mobile/src/state/use-thread-selection.ts
+++ b/apps/mobile/src/state/use-thread-selection.ts
@@ -2,12 +2,20 @@ import { useRoute, type RouteProp } from "@react-navigation/native";
 import { useMemo, useRef } from "react";
 import {
   EnvironmentId,
-  type OrchestrationThread,
   ThreadId,
+  type OrchestrationV2ThreadProjection,
+  type OrchestrationV2ThreadShell,
   type ScopedProjectRef,
   type ScopedThreadRef,
 } from "@t3tools/contracts";
-import type { EnvironmentThreadShell } from "@t3tools/client-runtime/state/shell";
+import {
+  presentThreadShell,
+  type EnvironmentThreadShell,
+} from "@t3tools/client-runtime/state/shell";
+import {
+  deriveLatestThreadRun,
+  deriveThreadRuntime,
+} from "@t3tools/client-runtime/state/thread-execution";
 import * as Option from "effect/Option";
 
 import { useProject, useThreadShell } from "../state/entities";
@@ -29,9 +37,11 @@ function firstRouteParam(value: string | string[] | undefined): string | null {
   return value ?? null;
 }
 
-function latestUserMessageAt(thread: OrchestrationThread): OrchestrationThread["updatedAt"] | null {
-  for (let index = thread.messages.length - 1; index >= 0; index -= 1) {
-    const message = thread.messages[index];
+function latestUserMessageAt(
+  projection: OrchestrationV2ThreadProjection,
+): OrchestrationV2ThreadShell["latestUserMessageAt"] {
+  for (let index = projection.messages.length - 1; index >= 0; index -= 1) {
+    const message = projection.messages[index];
     if (message?.role === "user") {
       return message.createdAt;
     }
@@ -40,21 +50,47 @@ function latestUserMessageAt(thread: OrchestrationThread): OrchestrationThread["
   return null;
 }
 
+/**
+ * Builds an optimistic thread shell from the detail projection for the window
+ * where the shell list has not materialized the thread yet (e.g. a thread that
+ * was just created from this device).
+ */
 function threadDetailToShell(
   environmentId: EnvironmentId,
-  thread: OrchestrationThread,
+  projection: OrchestrationV2ThreadProjection,
 ): EnvironmentThreadShell {
-  return {
-    environmentId,
+  const thread = projection.thread;
+  const latestRun = deriveLatestThreadRun(projection);
+  const runtime = deriveThreadRuntime(projection);
+  const pendingRequest =
+    projection.runtimeRequests.find((request) => request.status === "pending") ?? null;
+  return presentThreadShell(environmentId, {
     id: thread.id,
     projectId: thread.projectId,
     title: thread.title,
+    providerInstanceId: thread.providerInstanceId,
     modelSelection: thread.modelSelection,
     runtimeMode: thread.runtimeMode,
     interactionMode: thread.interactionMode,
     branch: thread.branch,
     worktreePath: thread.worktreePath,
-    latestTurn: thread.latestTurn,
+    activeProviderThreadId: thread.activeProviderThreadId,
+    lineage: thread.lineage,
+    forkedFrom: thread.forkedFrom,
+    createdBy: thread.createdBy,
+    creationSource: thread.creationSource,
+    latestRunId: latestRun?.runId ?? null,
+    activeRunId: runtime?.activeRunId ?? null,
+    status: runtime?.status ?? "idle",
+    pendingRuntimeRequest:
+      pendingRequest === null
+        ? null
+        : { id: pendingRequest.id, kind: pendingRequest.kind, createdAt: pendingRequest.createdAt },
+    latestVisibleMessage: null,
+    latestUserMessageAt: latestUserMessageAt(projection),
+    hasActionableProposedPlan: false,
+    itemCount: projection.turnItems.length,
+    visibleItemCount: projection.visibleTurnItems.length,
     createdAt: thread.createdAt,
     updatedAt: thread.updatedAt,
     archivedAt: thread.archivedAt,
@@ -62,12 +98,8 @@ function threadDetailToShell(
     settledAt: thread.settledAt,
     snoozedUntil: thread.snoozedUntil ?? null,
     snoozedAt: thread.snoozedAt ?? null,
-    session: thread.session,
-    latestUserMessageAt: latestUserMessageAt(thread),
-    hasPendingApprovals: false,
-    hasPendingUserInput: false,
-    hasActionableProposedPlan: false,
-  };
+    deletedAt: thread.deletedAt,
+  });
 }
 
 function useResolvedThreadSelection(params: ThreadSelectionRouteParams | undefined) {
diff --git a/apps/mobile/src/state/v2-item-support.ts b/apps/mobile/src/state/v2-item-support.ts
new file mode 100644
index 000000000000..f9fa51dc7567
--- /dev/null
+++ b/apps/mobile/src/state/v2-item-support.ts
@@ -0,0 +1,56 @@
+import { useAtomValue } from "@effect/atom-react";
+import { scopeThreadRef } from "@t3tools/client-runtime/environment";
+import {
+  EMPTY_V2_ITEM_SUPPORT,
+  resolveV2ItemSupport,
+  v2ItemSupportEqual,
+  type V2ItemSupport,
+} from "@t3tools/client-runtime/state/item-support";
+import type { EnvironmentId, ThreadId, TurnItemId } from "@t3tools/contracts";
+import { Atom } from "effect/unstable/reactivity";
+
+import { environmentThreadDetails } from "./threads";
+
+interface ItemSupportTarget {
+  readonly environmentId: EnvironmentId;
+  readonly threadId: ThreadId;
+  readonly itemId: TurnItemId;
+}
+
+function supportKey(target: ItemSupportTarget): string {
+  return JSON.stringify(target);
+}
+
+function parseSupportKey(key: string): ItemSupportTarget {
+  return JSON.parse(key) as ItemSupportTarget;
+}
+
+const itemSupportAtomFamily = Atom.family((key: string) => {
+  const target = parseSupportKey(key);
+  const ref = scopeThreadRef(target.environmentId, target.threadId);
+  let previous = EMPTY_V2_ITEM_SUPPORT;
+  return Atom.make((get): V2ItemSupport => {
+    const scoped = get(environmentThreadDetails.threadAtom(ref));
+    if (scoped === null) return EMPTY_V2_ITEM_SUPPORT;
+    const next = resolveV2ItemSupport(scoped.projection, target.itemId);
+    if (v2ItemSupportEqual(previous, next)) return previous;
+    previous = next;
+    return next;
+  }).pipe(Atom.withLabel(`mobile-v2-item-support:${key}`));
+});
+
+export function useV2ItemSupport(target: {
+  readonly environmentId: EnvironmentId;
+  readonly sourceThreadId: ThreadId;
+  readonly sourceItemId: TurnItemId;
+}): V2ItemSupport {
+  return useAtomValue(
+    itemSupportAtomFamily(
+      supportKey({
+        environmentId: target.environmentId,
+        threadId: target.sourceThreadId,
+        itemId: target.sourceItemId,
+      }),
+    ),
+  );
+}
diff --git a/apps/mobile/src/test-fixtures.ts b/apps/mobile/src/test-fixtures.ts
new file mode 100644
index 000000000000..cc5128d83fa7
--- /dev/null
+++ b/apps/mobile/src/test-fixtures.ts
@@ -0,0 +1,72 @@
+import {
+  presentThreadShell,
+  type EnvironmentThreadShell,
+} from "@t3tools/client-runtime/state/shell";
+import {
+  EnvironmentId,
+  ProjectId,
+  ProviderInstanceId,
+  ThreadId,
+  type OrchestrationV2ThreadShell,
+} from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+
+const DEFAULT_TIMESTAMP = "2026-01-01T00:00:00.000Z";
+
+export function makeRawThreadShell(
+  input: Partial<OrchestrationV2ThreadShell> = {},
+): OrchestrationV2ThreadShell {
+  const id = input.id ?? ThreadId.make("thread-test");
+  const providerInstanceId = input.providerInstanceId ?? ProviderInstanceId.make("codex");
+  const now = DateTime.makeUnsafe(DEFAULT_TIMESTAMP);
+  return {
+    id,
+    projectId: ProjectId.make("project-test"),
+    title: "Thread",
+    providerInstanceId,
+    modelSelection: { instanceId: providerInstanceId, model: "gpt-5.4" },
+    runtimeMode: "full-access",
+    interactionMode: "default",
+    branch: null,
+    worktreePath: null,
+    activeProviderThreadId: null,
+    lineage: { rootThreadId: id, parentThreadId: null, relationshipToParent: null },
+    forkedFrom: null,
+    createdBy: "user",
+    creationSource: "mobile",
+    latestRunId: null,
+    activeRunId: null,
+    status: "idle",
+    pendingRuntimeRequest: null,
+    latestVisibleMessage: null,
+    latestUserMessageAt: null,
+    hasActionableProposedPlan: false,
+    itemCount: 0,
+    visibleItemCount: 0,
+    createdAt: now,
+    updatedAt: now,
+    archivedAt: null,
+    settledOverride: null,
+    settledAt: null,
+    deletedAt: null,
+    ...input,
+  };
+}
+
+export function makeThreadShellFixture(
+  overrides: Partial<EnvironmentThreadShell> = {},
+): EnvironmentThreadShell {
+  const environmentId = overrides.environmentId ?? EnvironmentId.make("environment-test");
+  const raw = makeRawThreadShell({
+    id: overrides.id,
+    projectId: overrides.projectId,
+    title: overrides.title,
+    providerInstanceId: overrides.providerInstanceId,
+    modelSelection: overrides.modelSelection,
+    runtimeMode: overrides.runtimeMode,
+    interactionMode: overrides.interactionMode,
+    branch: overrides.branch,
+    worktreePath: overrides.worktreePath,
+  });
+  return { ...presentThreadShell(environmentId, raw), ...overrides };
+}
diff --git a/apps/server/README.md b/apps/server/README.md
new file mode 100644
index 000000000000..5864e80b0338
--- /dev/null
+++ b/apps/server/README.md
@@ -0,0 +1,3 @@
+# Server
+
+Node.js WebSocket server for the T3 Code app.
diff --git a/apps/server/integration/NetworkTransferMeasurement.integration.ts b/apps/server/integration/NetworkTransferMeasurement.integration.ts
deleted file mode 100644
index 75714d1519e2..000000000000
--- a/apps/server/integration/NetworkTransferMeasurement.integration.ts
+++ /dev/null
@@ -1,177 +0,0 @@
-// @effect-diagnostics nodeBuiltinImport:off - Measures the real Node HTTP and WebSocket transports.
-import * as NodeHttp from "node:http";
-import * as NodeZlib from "node:zlib";
-
-import * as NodeSocket from "@effect/platform-node/NodeSocket";
-import { WsRpcGroup } from "@t3tools/contracts";
-import * as Effect from "effect/Effect";
-import * as Layer from "effect/Layer";
-import * as Schema from "effect/Schema";
-import { RpcClient, RpcSerialization } from "effect/unstable/rpc";
-import * as Socket from "effect/unstable/socket/Socket";
-
-export class TransferHttpRequestError extends Schema.TaggedErrorClass<TransferHttpRequestError>()(
-  "TransferHttpRequestError",
-  {
-    url: Schema.String,
-    cause: Schema.Defect(),
-  },
-) {}
-
-export interface HttpTransferMeasurement {
-  readonly status: number;
-  readonly contentEncoding: string | null;
-  readonly encodedBody: Uint8Array;
-  readonly encodedBodyBytes: number;
-  readonly decodedBody: Uint8Array;
-  readonly decodedBodyBytes: number;
-  /** HTTP response bytes read from the socket, including status line and headers. */
-  readonly wireBytes: number;
-}
-
-export const measureHttpGet = Effect.fn("TransferBudget.measureHttpGet")(function* (input: {
-  readonly url: string;
-  readonly headers?: Readonly<Record<string, string>>;
-}) {
-  return yield* Effect.tryPromise({
-    try: () =>
-      new Promise<HttpTransferMeasurement>((resolve, reject) => {
-        let socketBytesBeforeResponse = 0;
-        const request = NodeHttp.get(
-          input.url,
-          {
-            agent: false,
-            headers: {
-              "accept-encoding": "gzip",
-              connection: "close",
-              ...input.headers,
-            },
-          },
-          (response) => {
-            const chunks: Buffer[] = [];
-            response.on("data", (chunk: Buffer) => chunks.push(chunk));
-            response.once("error", reject);
-            response.once("end", () => {
-              try {
-                const encodedBody = Buffer.concat(chunks);
-                const header = response.headers["content-encoding"];
-                const contentEncoding = Array.isArray(header)
-                  ? (header[0] ?? null)
-                  : (header ?? null);
-                const decodedBody =
-                  contentEncoding === "gzip" ? NodeZlib.gunzipSync(encodedBody) : encodedBody;
-                resolve({
-                  status: response.statusCode ?? 0,
-                  contentEncoding,
-                  encodedBody,
-                  encodedBodyBytes: encodedBody.byteLength,
-                  decodedBody,
-                  decodedBodyBytes: decodedBody.byteLength,
-                  wireBytes: Math.max(0, response.socket.bytesRead - socketBytesBeforeResponse),
-                });
-              } catch (cause) {
-                reject(cause);
-              }
-            });
-          },
-        );
-        request.once("socket", (socket) => {
-          socketBytesBeforeResponse = socket.bytesRead;
-        });
-        request.once("error", reject);
-        request.setTimeout(10_000, () => {
-          request.destroy(new Error(`Timed out reading ${input.url}`));
-        });
-      }),
-    catch: (cause) => new TransferHttpRequestError({ url: input.url, cause }),
-  });
-});
-
-export interface WebSocketTransferTotals {
-  readonly wireBytes: number;
-  readonly decodedBytes: number;
-  readonly messages: number;
-}
-
-export interface WebSocketTransferRecorder {
-  readonly connect: (
-    url: string,
-    protocols: string | string[] | undefined,
-    cookie: string,
-  ) => globalThis.WebSocket;
-  readonly totals: () => WebSocketTransferTotals;
-  readonly negotiatedExtensions: () => string;
-}
-
-interface NodeWebSocketWithTransport extends NodeSocket.NodeWS.WebSocket {
-  readonly _socket?: {
-    readonly bytesRead: number;
-  };
-}
-
-function rawDataBytes(data: NodeSocket.NodeWS.RawData): number {
-  if (Array.isArray(data)) {
-    return data.reduce((total, chunk) => total + chunk.byteLength, 0);
-  }
-  return data.byteLength;
-}
-
-export function makeWebSocketTransferRecorder(): WebSocketTransferRecorder {
-  let socket: NodeWebSocketWithTransport | null = null;
-  let decodedBytes = 0;
-  let messages = 0;
-
-  return {
-    connect: (url, protocols, cookie) => {
-      const nextSocket = new NodeSocket.NodeWS.WebSocket(url, protocols, {
-        headers: { cookie },
-        perMessageDeflate: true,
-      }) as NodeWebSocketWithTransport;
-      socket = nextSocket;
-      nextSocket.on("message", (data) => {
-        const bytes = rawDataBytes(data);
-        decodedBytes += bytes;
-        messages += 1;
-      });
-      return nextSocket as unknown as globalThis.WebSocket;
-    },
-    totals: () => ({
-      wireBytes: socket?._socket?.bytesRead ?? 0,
-      decodedBytes,
-      messages,
-    }),
-    negotiatedExtensions: () => socket?.extensions ?? "",
-  };
-}
-
-export function transferDelta(
-  start: WebSocketTransferTotals,
-  end: WebSocketTransferTotals,
-): WebSocketTransferTotals {
-  return {
-    wireBytes: Math.max(0, end.wireBytes - start.wireBytes),
-    decodedBytes: Math.max(0, end.decodedBytes - start.decodedBytes),
-    messages: Math.max(0, end.messages - start.messages),
-  };
-}
-
-export function countingWsRpcProtocolLayer(input: {
-  readonly url: string;
-  readonly cookie: string;
-  readonly recorder: WebSocketTransferRecorder;
-}) {
-  const webSocketConstructorLayer = Layer.succeed(Socket.WebSocketConstructor, (url, protocols) =>
-    input.recorder.connect(url, protocols, input.cookie),
-  );
-  return RpcClient.layerProtocolSocket().pipe(
-    Layer.provide(
-      Socket.layerWebSocket(input.url, { openTimeout: "10 seconds" }).pipe(
-        Layer.provide(webSocketConstructorLayer),
-      ),
-    ),
-    Layer.provide(RpcSerialization.layerJson),
-  );
-}
-
-export const makeCountingWsRpcClient = RpcClient.make(WsRpcGroup);
-export type CountingWsRpcClient = Effect.Success<typeof makeCountingWsRpcClient>;
diff --git a/apps/server/integration/OrchestrationEngineHarness.integration.ts b/apps/server/integration/OrchestrationEngineHarness.integration.ts
deleted file mode 100644
index 6ade6025bcbc..000000000000
--- a/apps/server/integration/OrchestrationEngineHarness.integration.ts
+++ /dev/null
@@ -1,579 +0,0 @@
-// @effect-diagnostics nodeBuiltinImport:off
-import * as NodeChildProcess from "node:child_process";
-
-import * as NodeServices from "@effect/platform-node/NodeServices";
-import {
-  ApprovalRequestId,
-  CodexSettings,
-  ProviderDriverKind,
-  type OrchestrationEvent,
-  type OrchestrationThread,
-  type ProviderApprovalDecision,
-} from "@t3tools/contracts";
-import * as Effect from "effect/Effect";
-import * as Exit from "effect/Exit";
-import * as FileSystem from "effect/FileSystem";
-import * as Layer from "effect/Layer";
-import * as ManagedRuntime from "effect/ManagedRuntime";
-import * as Option from "effect/Option";
-import * as Path from "effect/Path";
-import * as Ref from "effect/Ref";
-import * as Schedule from "effect/Schedule";
-import * as Schema from "effect/Schema";
-import * as Scope from "effect/Scope";
-import * as Stream from "effect/Stream";
-
-import * as CheckpointStore from "../src/checkpointing/CheckpointStore.ts";
-import { TextGeneration, type TextGenerationShape } from "../src/textGeneration/TextGeneration.ts";
-import { OrchestrationCommandReceiptRepositoryLive } from "../src/persistence/Layers/OrchestrationCommandReceipts.ts";
-import { OrchestrationEventStoreLive } from "../src/persistence/Layers/OrchestrationEventStore.ts";
-import { ProjectionCheckpointRepositoryLive } from "../src/persistence/Layers/ProjectionCheckpoints.ts";
-import { ProjectionPendingApprovalRepositoryLive } from "../src/persistence/Layers/ProjectionPendingApprovals.ts";
-import { ProviderSessionRuntimeRepositoryLive } from "../src/persistence/Layers/ProviderSessionRuntime.ts";
-import { makeSqlitePersistenceLive } from "../src/persistence/Layers/Sqlite.ts";
-import { ProjectionCheckpointRepository } from "../src/persistence/Services/ProjectionCheckpoints.ts";
-import { ProjectionPendingApprovalRepository } from "../src/persistence/Services/ProjectionPendingApprovals.ts";
-import { makeAdapterRegistryMock } from "../src/provider/testUtils/providerAdapterRegistryMock.ts";
-import { ProviderAdapterRegistry } from "../src/provider/Services/ProviderAdapterRegistry.ts";
-import { makeProviderRegistryLayer } from "../src/provider/testUtils/providerRegistryMock.ts";
-import { ProviderSessionDirectoryLive } from "../src/provider/Layers/ProviderSessionDirectory.ts";
-import { ServerSettingsService } from "../src/serverSettings.ts";
-import { makeProviderServiceLive } from "../src/provider/Layers/ProviderService.ts";
-import { makeCodexAdapter } from "../src/provider/Layers/CodexAdapter.ts";
-import {
-  NoOpProviderEventLoggers,
-  ProviderEventLoggers,
-} from "../src/provider/Layers/ProviderEventLoggers.ts";
-import { ProviderService } from "../src/provider/Services/ProviderService.ts";
-import { AnalyticsService } from "../src/telemetry/Services/AnalyticsService.ts";
-import { CheckpointReactorLive } from "../src/orchestration/Layers/CheckpointReactor.ts";
-import * as RepositoryIdentityResolver from "../src/project/RepositoryIdentityResolver.ts";
-import { OrchestrationEngineLive } from "../src/orchestration/Layers/OrchestrationEngine.ts";
-import { OrchestrationProjectionPipelineLive } from "../src/orchestration/Layers/ProjectionPipeline.ts";
-import { OrchestrationProjectionSnapshotQueryLive } from "../src/orchestration/Layers/ProjectionSnapshotQuery.ts";
-import * as ThreadBackgroundLiveness from "../src/orchestration/ThreadBackgroundLiveness.ts";
-import * as ThreadPlanProgress from "../src/orchestration/ThreadPlanProgress.ts";
-import { RuntimeReceiptBusTest } from "../src/orchestration/Layers/RuntimeReceiptBus.ts";
-import { OrchestrationReactorLive } from "../src/orchestration/Layers/OrchestrationReactor.ts";
-import { ProviderCommandReactorLive } from "../src/orchestration/Layers/ProviderCommandReactor.ts";
-import { ProviderRuntimeIngestionLive } from "../src/orchestration/Layers/ProviderRuntimeIngestion.ts";
-import { CheckpointReactor } from "../src/orchestration/Services/CheckpointReactor.ts";
-import { ProviderRuntimeIngestionService } from "../src/orchestration/Services/ProviderRuntimeIngestion.ts";
-import {
-  OrchestrationEngineService,
-  type OrchestrationEngineShape,
-} from "../src/orchestration/Services/OrchestrationEngine.ts";
-import { ThreadDeletionReactor } from "../src/orchestration/Services/ThreadDeletionReactor.ts";
-import { OrchestrationReactor } from "../src/orchestration/Services/OrchestrationReactor.ts";
-import { ProjectionSnapshotQuery } from "../src/orchestration/Services/ProjectionSnapshotQuery.ts";
-import {
-  RuntimeReceiptBus,
-  type OrchestrationRuntimeReceipt,
-} from "../src/orchestration/Services/RuntimeReceiptBus.ts";
-
-import {
-  makeTestProviderAdapterHarness,
-  type TestProviderAdapterHarness,
-} from "./TestProviderAdapter.integration.ts";
-import { deriveServerPaths, ServerConfig } from "../src/config.ts";
-import * as WorkspaceEntries from "../src/workspace/WorkspaceEntries.ts";
-import * as WorkspacePaths from "../src/workspace/WorkspacePaths.ts";
-import * as VcsDriverRegistry from "../src/vcs/VcsDriverRegistry.ts";
-import { VcsStatusBroadcaster } from "../src/vcs/VcsStatusBroadcaster.ts";
-import { GitWorkflowService } from "../src/git/GitWorkflowService.ts";
-import * as VcsProcess from "../src/vcs/VcsProcess.ts";
-import * as AgentAwarenessRelay from "../src/relay/AgentAwarenessRelay.ts";
-
-const decodeCodexSettings = Schema.decodeEffect(CodexSettings);
-
-function runGit(cwd: string, args: ReadonlyArray<string>) {
-  return NodeChildProcess.execFileSync("git", args, {
-    cwd,
-    stdio: ["ignore", "pipe", "pipe"],
-    encoding: "utf8",
-  });
-}
-
-const initializeGitWorkspace = Effect.fn(function* (cwd: string) {
-  runGit(cwd, ["init", "--initial-branch=main"]);
-  runGit(cwd, ["config", "user.email", "test@example.com"]);
-  runGit(cwd, ["config", "user.name", "Test User"]);
-  const fileSystem = yield* FileSystem.FileSystem;
-  const { join } = yield* Path.Path;
-  yield* fileSystem.writeFileString(join(cwd, "README.md"), "v1\n");
-  runGit(cwd, ["add", "."]);
-  runGit(cwd, ["commit", "-m", "Initial"]);
-});
-
-export function gitRefExists(cwd: string, ref: string): boolean {
-  try {
-    runGit(cwd, ["show-ref", "--verify", "--quiet", ref]);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-export function gitShowFileAtRef(cwd: string, ref: string, filePath: string): string {
-  return runGit(cwd, ["show", `${ref}:${filePath}`]);
-}
-
-class WaitForTimeoutError extends Schema.TaggedErrorClass<WaitForTimeoutError>()(
-  "WaitForTimeoutError",
-  {
-    description: Schema.String,
-  },
-) {}
-
-function waitFor<A, E>(
-  read: Effect.Effect<A, E>,
-  predicate: (value: A) => boolean,
-  description: string,
-  timeoutMs?: number,
-): Effect.Effect<A, never>;
-function waitFor<A, B extends A, E>(
-  read: Effect.Effect<A, E>,
-  predicate: (value: A) => value is B,
-  description: string,
-  timeoutMs?: number,
-): Effect.Effect<B, never>;
-function waitFor<A, E>(
-  read: Effect.Effect<A, E>,
-  predicate: (value: A) => boolean,
-  description: string,
-  timeoutMs = 40_000,
-): Effect.Effect<A, never> {
-  const RETRY_SIGNAL = "wait_for_retry";
-  const retryIntervalMs = 10;
-  const maxRetries = Math.max(0, Math.floor(timeoutMs / retryIntervalMs));
-  const retrySchedule = Schedule.spaced(`${retryIntervalMs} millis`);
-
-  return read.pipe(
-    Effect.filterOrFail(predicate, () => RETRY_SIGNAL),
-    Effect.retry({
-      schedule: retrySchedule,
-      times: maxRetries,
-      while: (error) => error === RETRY_SIGNAL,
-    }),
-    Effect.mapError((error) =>
-      error === RETRY_SIGNAL ? new WaitForTimeoutError({ description }) : error,
-    ),
-    Effect.orDie,
-  );
-}
-
-class OrchestrationHarnessRuntimeError extends Schema.TaggedErrorClass<OrchestrationHarnessRuntimeError>()(
-  "OrchestrationHarnessRuntimeError",
-  {
-    operation: Schema.String,
-    cause: Schema.optional(Schema.Defect()),
-  },
-) {}
-
-const tryRuntimePromise = <A>(operation: string, run: () => Promise<A>) =>
-  Effect.tryPromise({
-    try: run,
-    catch: (cause) => new OrchestrationHarnessRuntimeError({ operation, cause }),
-  });
-
-export interface OrchestrationIntegrationHarness {
-  readonly rootDir: string;
-  readonly workspaceDir: string;
-  readonly dbPath: string;
-  readonly adapterHarness: TestProviderAdapterHarness | null;
-  readonly engine: OrchestrationEngineShape;
-  readonly snapshotQuery: ProjectionSnapshotQuery["Service"];
-  readonly providerService: ProviderService["Service"];
-  readonly checkpointStore: CheckpointStore.CheckpointStore["Service"];
-  readonly checkpointRepository: ProjectionCheckpointRepository["Service"];
-  readonly pendingApprovalRepository: ProjectionPendingApprovalRepository["Service"];
-  readonly waitForThread: (
-    threadId: string,
-    predicate: (thread: OrchestrationThread) => boolean,
-    timeoutMs?: number,
-  ) => Effect.Effect<OrchestrationThread, never>;
-  readonly waitForDomainEvent: (
-    predicate: (event: OrchestrationEvent) => boolean,
-    timeoutMs?: number,
-  ) => Effect.Effect<ReadonlyArray<OrchestrationEvent>, never>;
-  readonly waitForPendingApproval: (
-    requestId: string,
-    predicate: (row: {
-      readonly status: "pending" | "resolved";
-      readonly decision: ProviderApprovalDecision | null;
-      readonly resolvedAt: string | null;
-    }) => boolean,
-    timeoutMs?: number,
-  ) => Effect.Effect<
-    {
-      readonly status: "pending" | "resolved";
-      readonly decision: ProviderApprovalDecision | null;
-      readonly resolvedAt: string | null;
-    },
-    never
-  >;
-  readonly waitForReceipt: {
-    (
-      predicate: (receipt: OrchestrationRuntimeReceipt) => boolean,
-      timeoutMs?: number,
-    ): Effect.Effect<OrchestrationRuntimeReceipt, never>;
-    <Receipt extends OrchestrationRuntimeReceipt>(
-      predicate: (receipt: OrchestrationRuntimeReceipt) => receipt is Receipt,
-      timeoutMs?: number,
-    ): Effect.Effect<Receipt, never>;
-  };
-  readonly drainProviderRuntime: Effect.Effect<void>;
-  readonly drainCheckpointReactor: Effect.Effect<void>;
-  readonly dispose: Effect.Effect<void, never>;
-}
-
-interface MakeOrchestrationIntegrationHarnessOptions {
-  readonly provider?: ProviderDriverKind;
-  readonly realCodex?: boolean;
-}
-
-export const makeOrchestrationIntegrationHarness = (
-  options?: MakeOrchestrationIntegrationHarnessOptions,
-) =>
-  Effect.gen(function* () {
-    const path = yield* Path.Path;
-    const fileSystem = yield* FileSystem.FileSystem;
-
-    const provider = options?.provider ?? ProviderDriverKind.make("codex");
-    const useRealCodex = options?.realCodex === true;
-    const adapterHarness = useRealCodex
-      ? null
-      : yield* makeTestProviderAdapterHarness({
-          provider,
-        });
-    const fakeRegistry = adapterHarness
-      ? Layer.succeed(
-          ProviderAdapterRegistry,
-          makeAdapterRegistryMock({ [adapterHarness.provider]: adapterHarness.adapter }),
-        )
-      : null;
-    const rootDir = yield* fileSystem.makeTempDirectoryScoped({
-      prefix: "t3-orchestration-integration-",
-    });
-    const workspaceDir = path.join(rootDir, "workspace");
-    const { stateDir, dbPath } = yield* deriveServerPaths(rootDir, undefined).pipe(
-      Effect.provideService(Path.Path, path),
-    );
-    yield* fileSystem.makeDirectory(workspaceDir, { recursive: true });
-    yield* fileSystem.makeDirectory(stateDir, { recursive: true });
-    yield* initializeGitWorkspace(workspaceDir);
-
-    const persistenceLayer = makeSqlitePersistenceLive(dbPath);
-    const orchestrationLayer = OrchestrationEngineLive.pipe(
-      Layer.provide(OrchestrationProjectionPipelineLive),
-      Layer.provide(OrchestrationEventStoreLive),
-      Layer.provide(OrchestrationCommandReceiptRepositoryLive),
-    );
-    const providerSessionDirectoryLayer = ProviderSessionDirectoryLive.pipe(
-      Layer.provide(ProviderSessionRuntimeRepositoryLive),
-    );
-    const realCodexRegistry = Layer.effect(
-      ProviderAdapterRegistry,
-      Effect.gen(function* () {
-        const codexSettings = yield* decodeCodexSettings({});
-        const codexAdapter = yield* makeCodexAdapter(codexSettings);
-        return makeAdapterRegistryMock({
-          [ProviderDriverKind.make("codex")]: codexAdapter,
-        });
-      }),
-    ).pipe(
-      Layer.provideMerge(ServerConfig.layerTest(workspaceDir, rootDir)),
-      Layer.provideMerge(NodeServices.layer),
-      Layer.provideMerge(providerSessionDirectoryLayer),
-    );
-    const providerEventLoggersLayer = Layer.succeed(ProviderEventLoggers, NoOpProviderEventLoggers);
-    const providerLayer = useRealCodex
-      ? makeProviderServiceLive().pipe(
-          Layer.provide(providerSessionDirectoryLayer),
-          Layer.provide(realCodexRegistry),
-          Layer.provide(AnalyticsService.layerTest),
-          Layer.provide(providerEventLoggersLayer),
-        )
-      : makeProviderServiceLive().pipe(
-          Layer.provide(providerSessionDirectoryLayer),
-          Layer.provide(fakeRegistry!),
-          Layer.provide(AnalyticsService.layerTest),
-          Layer.provide(providerEventLoggersLayer),
-        );
-    const providerRegistryLayer = makeProviderRegistryLayer();
-
-    const checkpointStoreLayer = CheckpointStore.layer.pipe(Layer.provide(VcsDriverRegistry.layer));
-    const projectionSnapshotQueryLayer = OrchestrationProjectionSnapshotQueryLive;
-    const runtimeServicesLayer = Layer.mergeAll(
-      projectionSnapshotQueryLayer,
-      orchestrationLayer.pipe(Layer.provide(projectionSnapshotQueryLayer)),
-      ProjectionCheckpointRepositoryLive,
-      ProjectionPendingApprovalRepositoryLive,
-      checkpointStoreLayer,
-      providerLayer,
-      RuntimeReceiptBusTest,
-    ).pipe(
-      Layer.provideMerge(ThreadBackgroundLiveness.layer),
-      Layer.provideMerge(ThreadPlanProgress.layer),
-    );
-    const serverSettingsLayer = ServerSettingsService.layerTest();
-    const runtimeIngestionLayer = ProviderRuntimeIngestionLive.pipe(
-      Layer.provideMerge(runtimeServicesLayer),
-      Layer.provideMerge(serverSettingsLayer),
-    );
-    const gitWorkflowLayer = Layer.mock(GitWorkflowService)({
-      renameBranch: (input: {
-        readonly cwd: string;
-        readonly oldBranch: string;
-        readonly newBranch: string;
-      }) => Effect.succeed({ branch: input.newBranch }),
-    });
-    const textGenerationLayer = Layer.succeed(TextGeneration, {
-      generateBranchName: () => Effect.succeed({ branch: "update" }),
-      generateThreadTitle: () => Effect.succeed({ title: "New thread" }),
-    } as unknown as TextGenerationShape);
-    const providerCommandReactorLayer = ProviderCommandReactorLive.pipe(
-      Layer.provideMerge(runtimeServicesLayer),
-      Layer.provideMerge(gitWorkflowLayer),
-      Layer.provideMerge(textGenerationLayer),
-      Layer.provideMerge(serverSettingsLayer),
-    );
-    const checkpointReactorLayer = CheckpointReactorLive.pipe(
-      Layer.provideMerge(runtimeServicesLayer),
-      Layer.provideMerge(
-        Layer.succeed(VcsStatusBroadcaster, {
-          getStatus: () => Effect.die("getStatus should not be called in this test"),
-          refreshLocalStatus: () =>
-            Effect.succeed({
-              isRepo: true,
-              hasPrimaryRemote: false,
-              isDefaultRef: true,
-              refName: "main",
-              hasWorkingTreeChanges: false,
-              workingTree: { files: [], insertions: 0, deletions: 0 },
-            }),
-          refreshStatus: () => Effect.die("refreshStatus should not be called in this test"),
-          streamStatus: () => Stream.empty,
-        }),
-      ),
-      Layer.provideMerge(
-        WorkspaceEntries.layer.pipe(
-          Layer.provide(WorkspacePaths.layer),
-          Layer.provideMerge(VcsDriverRegistry.layer),
-          Layer.provide(NodeServices.layer),
-        ),
-      ),
-      Layer.provideMerge(WorkspacePaths.layer),
-      Layer.provideMerge(VcsProcess.layer),
-    );
-    const orchestrationReactorLayer = OrchestrationReactorLive.pipe(
-      Layer.provideMerge(runtimeIngestionLayer),
-      Layer.provideMerge(providerCommandReactorLayer),
-      Layer.provideMerge(checkpointReactorLayer),
-      Layer.provideMerge(
-        Layer.succeed(ThreadDeletionReactor, {
-          start: () => Effect.void,
-          drainThrough: () => Effect.void,
-        }),
-      ),
-      Layer.provideMerge(
-        Layer.succeed(AgentAwarenessRelay.AgentAwarenessRelay, {
-          publishThread: () => Effect.void,
-          start: () => Effect.void,
-        }),
-      ),
-    );
-    const layer = Layer.empty.pipe(
-      Layer.provideMerge(runtimeServicesLayer),
-      Layer.provideMerge(orchestrationReactorLayer),
-      Layer.provideMerge(providerRegistryLayer),
-      Layer.provide(persistenceLayer),
-      Layer.provideMerge(RepositoryIdentityResolver.layer),
-      Layer.provideMerge(ServerSettingsService.layerTest()),
-      Layer.provideMerge(ServerConfig.layerTest(workspaceDir, rootDir)),
-      Layer.provideMerge(NodeServices.layer),
-    );
-
-    const runtime = ManagedRuntime.make(layer);
-    const engine = yield* tryRuntimePromise("load OrchestrationEngine service", () =>
-      runtime.runPromise(Effect.service(OrchestrationEngineService)),
-    ).pipe(Effect.orDie);
-    const reactor = yield* tryRuntimePromise("load OrchestrationReactor service", () =>
-      runtime.runPromise(Effect.service(OrchestrationReactor)),
-    ).pipe(Effect.orDie);
-    const providerRuntimeIngestion = yield* tryRuntimePromise(
-      "load ProviderRuntimeIngestion service",
-      () => runtime.runPromise(Effect.service(ProviderRuntimeIngestionService)),
-    ).pipe(Effect.orDie);
-    const checkpointReactor = yield* tryRuntimePromise("load CheckpointReactor service", () =>
-      runtime.runPromise(Effect.service(CheckpointReactor)),
-    ).pipe(Effect.orDie);
-    const snapshotQuery = yield* tryRuntimePromise("load ProjectionSnapshotQuery service", () =>
-      runtime.runPromise(Effect.service(ProjectionSnapshotQuery)),
-    ).pipe(Effect.orDie);
-    const providerService = yield* tryRuntimePromise("load ProviderService service", () =>
-      runtime.runPromise(Effect.service(ProviderService)),
-    ).pipe(Effect.orDie);
-    const checkpointStore = yield* tryRuntimePromise("load CheckpointStore service", () =>
-      runtime.runPromise(Effect.service(CheckpointStore.CheckpointStore)),
-    ).pipe(Effect.orDie);
-    const checkpointRepository = yield* tryRuntimePromise(
-      "load ProjectionCheckpointRepository service",
-      () => runtime.runPromise(Effect.service(ProjectionCheckpointRepository)),
-    ).pipe(Effect.orDie);
-    const pendingApprovalRepository = yield* tryRuntimePromise(
-      "load ProjectionPendingApprovalRepository service",
-      () => runtime.runPromise(Effect.service(ProjectionPendingApprovalRepository)),
-    ).pipe(Effect.orDie);
-    const runtimeReceiptBus = yield* tryRuntimePromise("load RuntimeReceiptBus service", () =>
-      runtime.runPromise(Effect.service(RuntimeReceiptBus)),
-    ).pipe(Effect.orDie);
-
-    const scope = yield* Scope.make("sequential");
-    yield* tryRuntimePromise("start OrchestrationReactor", () =>
-      runtime.runPromise(reactor.start().pipe(Scope.provide(scope))),
-    ).pipe(Effect.orDie);
-    const receiptHistory = yield* Ref.make<ReadonlyArray<OrchestrationRuntimeReceipt>>([]);
-    yield* Stream.runForEach(runtimeReceiptBus.streamEventsForTest, (receipt) =>
-      Ref.update(receiptHistory, (history) => [...history, receipt]).pipe(Effect.asVoid),
-    ).pipe(Effect.forkIn(scope));
-    yield* Effect.sleep(10);
-
-    const waitForThread: OrchestrationIntegrationHarness["waitForThread"] = (
-      threadId,
-      predicate,
-      timeoutMs,
-    ) =>
-      waitFor(
-        snapshotQuery
-          .getSnapshot()
-          .pipe(
-            Effect.map(
-              (snapshot) => snapshot.threads.find((thread) => thread.id === threadId) ?? null,
-            ),
-          ),
-        (thread): thread is OrchestrationThread => thread !== null && predicate(thread),
-        `projected thread '${threadId}'`,
-        timeoutMs,
-      ) as Effect.Effect<OrchestrationThread, never>;
-
-    const waitForDomainEvent: OrchestrationIntegrationHarness["waitForDomainEvent"] = (
-      predicate,
-      timeoutMs,
-    ) =>
-      waitFor(
-        Stream.runCollect(engine.readEvents(0)).pipe(
-          Effect.map((chunk): ReadonlyArray<OrchestrationEvent> => Array.from(chunk)),
-        ),
-        (events) => events.some(predicate),
-        "domain event",
-        timeoutMs,
-      );
-
-    const waitForPendingApproval: OrchestrationIntegrationHarness["waitForPendingApproval"] = (
-      requestId,
-      predicate,
-      timeoutMs,
-    ) =>
-      waitFor(
-        pendingApprovalRepository
-          .getByRequestId({ requestId: ApprovalRequestId.make(requestId) })
-          .pipe(
-            Effect.map((row) =>
-              Option.match(row, {
-                onNone: () => null,
-                onSome: (value) => ({
-                  status: value.status,
-                  decision: value.decision,
-                  resolvedAt: value.resolvedAt,
-                }),
-              }),
-            ),
-          ),
-        (
-          row,
-        ): row is {
-          readonly status: "pending" | "resolved";
-          readonly decision: ProviderApprovalDecision | null;
-          readonly resolvedAt: string | null;
-        } => row !== null && predicate(row),
-        `pending approval '${requestId}'`,
-        timeoutMs,
-      ) as Effect.Effect<
-        {
-          readonly status: "pending" | "resolved";
-          readonly decision: ProviderApprovalDecision | null;
-          readonly resolvedAt: string | null;
-        },
-        never
-      >;
-
-    function waitForReceipt(
-      predicate: (receipt: OrchestrationRuntimeReceipt) => boolean,
-      timeoutMs?: number,
-    ): Effect.Effect<OrchestrationRuntimeReceipt, never>;
-    function waitForReceipt<Receipt extends OrchestrationRuntimeReceipt>(
-      predicate: (receipt: OrchestrationRuntimeReceipt) => receipt is Receipt,
-      timeoutMs?: number,
-    ): Effect.Effect<Receipt, never>;
-    function waitForReceipt(
-      predicate: (receipt: OrchestrationRuntimeReceipt) => boolean,
-      timeoutMs?: number,
-    ) {
-      const readMatchingReceipt = Ref.get(receiptHistory).pipe(
-        Effect.map((history) => history.find(predicate)),
-      );
-
-      return waitFor(
-        readMatchingReceipt,
-        (receipt): receipt is OrchestrationRuntimeReceipt => receipt !== undefined,
-        "runtime receipt",
-        timeoutMs,
-      );
-    }
-
-    let disposed = false;
-    const dispose = Effect.gen(function* () {
-      if (disposed) {
-        return;
-      }
-      disposed = true;
-
-      const shutdown = Effect.gen(function* () {
-        const closeScopeExit = yield* Effect.exit(Scope.close(scope, Exit.void));
-        const disposeRuntimeExit = yield* Effect.exit(Effect.promise(() => runtime.dispose()));
-
-        const failureCause = Exit.isFailure(closeScopeExit)
-          ? closeScopeExit.cause
-          : Exit.isFailure(disposeRuntimeExit)
-            ? disposeRuntimeExit.cause
-            : null;
-
-        if (failureCause) {
-          return yield* Effect.failCause(failureCause);
-        }
-      });
-
-      yield* shutdown;
-    });
-
-    return {
-      rootDir,
-      workspaceDir,
-      dbPath,
-      adapterHarness,
-      engine,
-      snapshotQuery,
-      providerService,
-      checkpointStore,
-      checkpointRepository,
-      pendingApprovalRepository,
-      waitForThread,
-      waitForDomainEvent,
-      waitForPendingApproval,
-      waitForReceipt,
-      drainProviderRuntime: providerRuntimeIngestion.drain,
-      drainCheckpointReactor: checkpointReactor.drain,
-      dispose,
-    } satisfies OrchestrationIntegrationHarness;
-  });
diff --git a/apps/server/integration/TestProviderAdapter.integration.ts b/apps/server/integration/TestProviderAdapter.integration.ts
deleted file mode 100644
index 095cca4e5e74..000000000000
--- a/apps/server/integration/TestProviderAdapter.integration.ts
+++ /dev/null
@@ -1,568 +0,0 @@
-import {
-  ApprovalRequestId,
-  EventId,
-  ProviderApprovalDecision,
-  ProviderRuntimeEvent,
-  RuntimeSessionId,
-  ProviderSession,
-  ProviderTurnStartResult,
-  ThreadId,
-  TurnId,
-  ProviderDriverKind,
-} from "@t3tools/contracts";
-import * as Effect from "effect/Effect";
-import * as Queue from "effect/Queue";
-import * as Stream from "effect/Stream";
-
-import {
-  ProviderAdapterSessionNotFoundError,
-  ProviderAdapterValidationError,
-  type ProviderAdapterError,
-} from "../src/provider/Errors.ts";
-import type {
-  ProviderAdapterShape,
-  ProviderThreadSnapshot,
-  ProviderThreadTurnSnapshot,
-} from "../src/provider/Services/ProviderAdapter.ts";
-
-export interface TestTurnResponse {
-  readonly events: ReadonlyArray<FixtureProviderRuntimeEvent>;
-  readonly mutateWorkspace?: (input: {
-    readonly cwd: string;
-    readonly turnCount: number;
-  }) => Effect.Effect<void, never>;
-}
-
-export type FixtureProviderRuntimeEvent = {
-  readonly type: string;
-  readonly eventId: EventId;
-  readonly provider: ProviderDriverKind;
-  readonly createdAt: string;
-  readonly threadId: string;
-  readonly turnId?: string | undefined;
-  readonly itemId?: string | undefined;
-  readonly requestId?: string | undefined;
-  readonly payload?: unknown | undefined;
-  readonly [key: string]: unknown;
-};
-
-// Temporary alias while fixtures migrate to the new name.
-export type LegacyProviderRuntimeEvent = FixtureProviderRuntimeEvent;
-
-interface SessionState {
-  readonly session: ProviderSession;
-  snapshot: ProviderThreadSnapshot;
-  turnCount: number;
-  readonly queuedResponses: Array<TestTurnResponse>;
-  readonly rollbackCalls: Array<number>;
-}
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === "object" && value !== null;
-}
-
-function normalizeTurnState(value: unknown): "completed" | "failed" | "interrupted" | "cancelled" {
-  if (
-    value === "completed" ||
-    value === "failed" ||
-    value === "interrupted" ||
-    value === "cancelled"
-  ) {
-    return value;
-  }
-  return "completed";
-}
-
-function mapRequestType(
-  requestKind: unknown,
-): "command_execution_approval" | "file_change_approval" | "unknown" {
-  if (requestKind === "command") {
-    return "command_execution_approval";
-  }
-  if (requestKind === "file-change") {
-    return "file_change_approval";
-  }
-  return "unknown";
-}
-
-function mapItemType(toolKind: unknown): "command_execution" | "file_change" | "unknown" {
-  if (toolKind === "command") {
-    return "command_execution";
-  }
-  if (toolKind === "file-change") {
-    return "file_change";
-  }
-  return "unknown";
-}
-
-function normalizeFixtureEvent(rawEvent: Record<string, unknown>): ProviderRuntimeEvent {
-  const type = typeof rawEvent.type === "string" ? rawEvent.type : "";
-  switch (type) {
-    case "turn.started":
-      return {
-        ...rawEvent,
-        type: "turn.started",
-        payload: isRecord(rawEvent.payload) ? rawEvent.payload : {},
-      } as ProviderRuntimeEvent;
-    case "turn.completed":
-      return {
-        ...rawEvent,
-        type: "turn.completed",
-        payload: isRecord(rawEvent.payload)
-          ? rawEvent.payload
-          : {
-              state: normalizeTurnState(rawEvent.status),
-            },
-      } as ProviderRuntimeEvent;
-    case "message.delta":
-      return {
-        ...rawEvent,
-        type: "content.delta",
-        payload: {
-          streamKind: "assistant_text",
-          delta: typeof rawEvent.delta === "string" ? rawEvent.delta : "",
-        },
-      } as ProviderRuntimeEvent;
-    case "message.completed":
-      return {
-        ...rawEvent,
-        type: "item.completed",
-        payload: {
-          itemType: "assistant_message",
-          ...(typeof rawEvent.detail === "string" ? { detail: rawEvent.detail } : {}),
-        },
-      } as ProviderRuntimeEvent;
-    case "tool.started":
-      return {
-        ...rawEvent,
-        type: "item.started",
-        payload: {
-          itemType: mapItemType(rawEvent.toolKind),
-          ...(typeof rawEvent.title === "string" ? { title: rawEvent.title } : {}),
-          ...(typeof rawEvent.detail === "string" ? { detail: rawEvent.detail } : {}),
-        },
-      } as ProviderRuntimeEvent;
-    case "tool.completed":
-      return {
-        ...rawEvent,
-        type: "item.completed",
-        payload: {
-          itemType: mapItemType(rawEvent.toolKind),
-          status: "completed",
-          ...(typeof rawEvent.title === "string" ? { title: rawEvent.title } : {}),
-          ...(typeof rawEvent.detail === "string" ? { detail: rawEvent.detail } : {}),
-        },
-      } as ProviderRuntimeEvent;
-    case "approval.requested":
-      return {
-        ...rawEvent,
-        type: "request.opened",
-        payload: {
-          requestType: mapRequestType(rawEvent.requestKind),
-          ...(typeof rawEvent.detail === "string" ? { detail: rawEvent.detail } : {}),
-        },
-      } as ProviderRuntimeEvent;
-    case "approval.resolved":
-      return {
-        ...rawEvent,
-        type: "request.resolved",
-        payload: {
-          requestType: mapRequestType(rawEvent.requestKind),
-          ...(typeof rawEvent.decision === "string" ? { decision: rawEvent.decision } : {}),
-        },
-      } as ProviderRuntimeEvent;
-    default:
-      return rawEvent as ProviderRuntimeEvent;
-  }
-}
-
-export interface TestProviderAdapterHarness {
-  readonly adapter: ProviderAdapterShape<ProviderAdapterError>;
-  readonly provider: ProviderDriverKind;
-  readonly queueTurnResponse: (
-    threadId: ThreadId,
-    response: TestTurnResponse,
-  ) => Effect.Effect<void, ProviderAdapterSessionNotFoundError>;
-  readonly queueTurnResponseForNextSession: (
-    response: TestTurnResponse,
-  ) => Effect.Effect<void, never>;
-  readonly getStartCount: () => number;
-  readonly getRollbackCalls: (threadId: ThreadId) => ReadonlyArray<number>;
-  readonly getInterruptCalls: (threadId: ThreadId) => ReadonlyArray<TurnId | undefined>;
-  readonly listActiveSessionIds: () => ReadonlyArray<ThreadId>;
-  readonly getApprovalResponses: (threadId: ThreadId) => ReadonlyArray<{
-    readonly threadId: ThreadId;
-    readonly requestId: ApprovalRequestId;
-    readonly decision: ProviderApprovalDecision;
-  }>;
-}
-
-interface MakeTestProviderAdapterHarnessOptions {
-  readonly provider?: ProviderDriverKind;
-}
-
-function nowIso(): string {
-  return "2026-01-01T00:00:00.000Z";
-}
-
-function sessionNotFound(
-  provider: ProviderDriverKind,
-  threadId: ThreadId,
-): ProviderAdapterSessionNotFoundError {
-  return new ProviderAdapterSessionNotFoundError({
-    provider,
-    threadId: String(threadId),
-  });
-}
-
-function missingSessionEffect(
-  provider: ProviderDriverKind,
-  threadId: ThreadId,
-): Effect.Effect<never, ProviderAdapterError> {
-  return Effect.fail(sessionNotFound(provider, threadId));
-}
-
-export const makeTestProviderAdapterHarness = (options?: MakeTestProviderAdapterHarnessOptions) =>
-  Effect.gen(function* () {
-    const provider = options?.provider ?? ProviderDriverKind.make("codex");
-    const runtimeEvents = yield* Queue.unbounded<ProviderRuntimeEvent>();
-    let sessionCount = 0;
-    let eventCount = 0;
-    const sessions = new Map<ThreadId, SessionState>();
-    const queuedResponsesForNextSession: TestTurnResponse[] = [];
-    const interruptCallsBySession = new Map<ThreadId, Array<TurnId | undefined>>();
-    const approvalResponsesBySession = new Map<
-      ThreadId,
-      Array<{
-        readonly threadId: ThreadId;
-        readonly requestId: ApprovalRequestId;
-        readonly decision: ProviderApprovalDecision;
-      }>
-    >();
-
-    const emit = (event: ProviderRuntimeEvent) => Queue.offer(runtimeEvents, event);
-    const nextEventId = (threadId: ThreadId) => {
-      eventCount += 1;
-      return EventId.make(`test-provider:${provider}:${threadId}:${eventCount}`);
-    };
-
-    const startSession: ProviderAdapterShape<ProviderAdapterError>["startSession"] = (input) =>
-      Effect.gen(function* () {
-        if (input.provider !== undefined && input.provider !== provider) {
-          return yield* new ProviderAdapterValidationError({
-            provider,
-            operation: "startSession",
-            issue: `Expected provider '${provider}' but received '${input.provider}'.`,
-          });
-        }
-
-        sessionCount += 1;
-        const threadId = input.threadId;
-        const createdAt = nowIso();
-
-        const session: ProviderSession = {
-          provider,
-          ...(input.providerInstanceId !== undefined
-            ? { providerInstanceId: input.providerInstanceId }
-            : {}),
-          status: "ready",
-          runtimeMode: input.runtimeMode,
-          threadId,
-          cwd: input.cwd,
-          resumeCursor: input.resumeCursor ?? { threadId: String(threadId), seed: sessionCount },
-          createdAt,
-          updatedAt: createdAt,
-        };
-
-        sessions.set(threadId, {
-          session,
-          snapshot: {
-            threadId,
-            turns: [],
-          },
-          turnCount: 0,
-          queuedResponses: queuedResponsesForNextSession.splice(0),
-          rollbackCalls: [],
-        });
-
-        return session;
-      });
-
-    const sendTurn: ProviderAdapterShape<ProviderAdapterError>["sendTurn"] = (input) =>
-      Effect.gen(function* () {
-        const state = sessions.get(input.threadId);
-        if (!state) {
-          return yield* missingSessionEffect(provider, input.threadId);
-        }
-
-        state.turnCount += 1;
-        const turnCount = state.turnCount;
-        const turnId = TurnId.make(`turn-${turnCount}`);
-
-        const response = state.queuedResponses.shift();
-        if (!response) {
-          return yield* new ProviderAdapterValidationError({
-            provider,
-            operation: "sendTurn",
-            issue: `No queued turn response for thread ${input.threadId}.`,
-          });
-        }
-
-        const assistantDeltas: string[] = [];
-        const deferredTurnCompletedEvents: ProviderRuntimeEvent[] = [];
-        for (const fixtureEvent of response.events) {
-          const rawEvent: Record<string, unknown> = {
-            ...(fixtureEvent as Record<string, unknown>),
-            eventId: nextEventId(input.threadId),
-            provider,
-            sessionId: RuntimeSessionId.make(String(input.threadId)),
-          };
-          rawEvent.threadId = state.snapshot.threadId;
-          if (Object.hasOwn(rawEvent, "turnId")) {
-            rawEvent.turnId = turnId;
-          }
-
-          const runtimeEvent = normalizeFixtureEvent(rawEvent);
-          const runtimeType = (runtimeEvent as { type: string }).type;
-          if (runtimeType === "content.delta") {
-            const payload = runtimeEvent.payload as { delta?: unknown } | undefined;
-            if (typeof payload?.delta === "string") {
-              assistantDeltas.push(payload.delta);
-            }
-          } else if (runtimeType === "message.delta") {
-            const legacyDelta = (runtimeEvent as { delta?: unknown }).delta;
-            if (typeof legacyDelta === "string") {
-              assistantDeltas.push(legacyDelta);
-            }
-          }
-          if (runtimeEvent.type === "turn.completed") {
-            deferredTurnCompletedEvents.push(runtimeEvent);
-            continue;
-          }
-
-          yield* emit(runtimeEvent);
-        }
-
-        if (response.mutateWorkspace && state.session.cwd) {
-          yield* response.mutateWorkspace({ cwd: state.session.cwd!, turnCount });
-        }
-
-        const userItem = {
-          type: "userMessage",
-          content: [{ type: "text", text: input.input }],
-        } as const;
-        const assistantText = assistantDeltas.join("");
-        const nextItems: Array<unknown> =
-          assistantText.length > 0
-            ? [userItem, { type: "agentMessage", text: assistantText }]
-            : [userItem];
-
-        const nextTurn: ProviderThreadTurnSnapshot = {
-          id: turnId,
-          items: nextItems,
-        };
-
-        state.snapshot = {
-          threadId: state.snapshot.threadId,
-          turns: [...state.snapshot.turns, nextTurn],
-        };
-
-        if (deferredTurnCompletedEvents.length === 0) {
-          yield* emit({
-            type: "turn.completed",
-            eventId: nextEventId(input.threadId),
-            provider,
-            createdAt: nowIso(),
-            threadId: state.snapshot.threadId,
-            turnId,
-            payload: {
-              state: "completed",
-            },
-          });
-        } else {
-          for (const completedEvent of deferredTurnCompletedEvents) {
-            yield* emit(completedEvent);
-          }
-        }
-
-        return {
-          threadId: state.snapshot.threadId,
-          turnId,
-        } satisfies ProviderTurnStartResult;
-      });
-
-    const interruptTurn: ProviderAdapterShape<ProviderAdapterError>["interruptTurn"] = (
-      threadId,
-      turnId,
-    ) =>
-      sessions.has(threadId)
-        ? Effect.sync(() => {
-            const existing = interruptCallsBySession.get(threadId) ?? [];
-            existing.push(turnId);
-            interruptCallsBySession.set(threadId, existing);
-          })
-        : missingSessionEffect(provider, threadId);
-
-    const respondToRequest: ProviderAdapterShape<ProviderAdapterError>["respondToRequest"] = (
-      threadId,
-      requestId,
-      decision,
-    ) =>
-      sessions.has(threadId)
-        ? Effect.sync(() => {
-            const existing = approvalResponsesBySession.get(threadId) ?? [];
-            existing.push({
-              threadId,
-              requestId,
-              decision,
-            });
-            approvalResponsesBySession.set(threadId, existing);
-          })
-        : missingSessionEffect(provider, threadId);
-
-    const respondToUserInput: ProviderAdapterShape<ProviderAdapterError>["respondToUserInput"] = (
-      threadId,
-      _requestId,
-      _answers,
-    ) => (sessions.has(threadId) ? Effect.void : missingSessionEffect(provider, threadId));
-
-    const stopSession: ProviderAdapterShape<ProviderAdapterError>["stopSession"] = (threadId) =>
-      Effect.sync(() => {
-        sessions.delete(threadId);
-      });
-
-    const listSessions: ProviderAdapterShape<ProviderAdapterError>["listSessions"] = () =>
-      Effect.sync(() => Array.from(sessions.values(), (state) => state.session));
-
-    const hasSession: ProviderAdapterShape<ProviderAdapterError>["hasSession"] = (threadId) =>
-      Effect.succeed(sessions.has(threadId));
-
-    const readThread: ProviderAdapterShape<ProviderAdapterError>["readThread"] = (threadId) => {
-      const state = sessions.get(threadId);
-      if (!state) {
-        return missingSessionEffect(provider, threadId);
-      }
-      return Effect.succeed(state.snapshot);
-    };
-
-    const rollbackThread: ProviderAdapterShape<ProviderAdapterError>["rollbackThread"] = (
-      threadId,
-      numTurns,
-    ) => {
-      const state = sessions.get(threadId);
-      if (!state) {
-        return missingSessionEffect(provider, threadId);
-      }
-      if (!Number.isInteger(numTurns) || numTurns < 0 || numTurns > state.snapshot.turns.length) {
-        return Effect.fail(
-          new ProviderAdapterValidationError({
-            provider,
-            operation: "rollbackThread",
-            issue: "numTurns must be an integer between 0 and current turn count.",
-          }),
-        );
-      }
-
-      return Effect.sync(() => {
-        state.rollbackCalls.push(numTurns);
-        state.snapshot = {
-          threadId: state.snapshot.threadId,
-          turns: state.snapshot.turns.slice(0, state.snapshot.turns.length - numTurns),
-        };
-        state.turnCount = state.snapshot.turns.length;
-        return state.snapshot;
-      });
-    };
-
-    const stopAll: ProviderAdapterShape<ProviderAdapterError>["stopAll"] = () =>
-      Effect.sync(() => {
-        sessions.clear();
-      });
-
-    const adapter: ProviderAdapterShape<ProviderAdapterError> = {
-      provider,
-      capabilities: {
-        sessionModelSwitch: "in-session",
-      },
-      startSession,
-      sendTurn,
-      interruptTurn,
-      respondToRequest,
-      respondToUserInput,
-      stopSession,
-      listSessions,
-      hasSession,
-      readThread,
-      rollbackThread,
-      stopAll,
-      streamEvents: Stream.fromQueue(runtimeEvents),
-    };
-
-    const queueTurnResponse = (
-      threadId: ThreadId,
-      response: TestTurnResponse,
-    ): Effect.Effect<void, ProviderAdapterSessionNotFoundError> =>
-      Effect.sync(() => sessions.get(threadId)).pipe(
-        Effect.flatMap((state) =>
-          state
-            ? Effect.sync(() => {
-                state.queuedResponses.push(response);
-              })
-            : Effect.fail(sessionNotFound(provider, threadId)),
-        ),
-      );
-
-    const queueTurnResponseForNextSession = (
-      response: TestTurnResponse,
-    ): Effect.Effect<void, never> =>
-      Effect.sync(() => {
-        queuedResponsesForNextSession.push(response);
-      });
-
-    const getRollbackCalls = (threadId: ThreadId): ReadonlyArray<number> => {
-      const state = sessions.get(threadId);
-      if (!state) {
-        return [];
-      }
-      return [...state.rollbackCalls];
-    };
-
-    const getStartCount = (): number => sessionCount;
-
-    const getInterruptCalls = (threadId: ThreadId): ReadonlyArray<TurnId | undefined> => {
-      const calls = interruptCallsBySession.get(threadId);
-      if (!calls) {
-        return [];
-      }
-      return [...calls];
-    };
-
-    const listActiveSessionIds = (): ReadonlyArray<ThreadId> =>
-      Array.from(sessions.values(), (state) => state.session.threadId);
-
-    const getApprovalResponses = (
-      threadId: ThreadId,
-    ): ReadonlyArray<{
-      readonly threadId: ThreadId;
-      readonly requestId: ApprovalRequestId;
-      readonly decision: ProviderApprovalDecision;
-    }> => {
-      const responses = approvalResponsesBySession.get(threadId);
-      if (!responses) {
-        return [];
-      }
-      return [...responses];
-    };
-
-    return {
-      adapter,
-      provider,
-      queueTurnResponse,
-      queueTurnResponseForNextSession,
-      getStartCount,
-      getRollbackCalls,
-      getInterruptCalls,
-      listActiveSessionIds,
-      getApprovalResponses,
-    } satisfies TestProviderAdapterHarness;
-  });
diff --git a/apps/server/integration/TransferBudgetReport.integration.ts b/apps/server/integration/TransferBudgetReport.integration.ts
deleted file mode 100644
index f773b5b8b844..000000000000
--- a/apps/server/integration/TransferBudgetReport.integration.ts
+++ /dev/null
@@ -1,212 +0,0 @@
-import type { ProviderDriverKind } from "@t3tools/contracts";
-
-import type {
-  HttpTransferMeasurement,
-  WebSocketTransferTotals,
-} from "./NetworkTransferMeasurement.integration.ts";
-import {
-  TRANSFER_HISTORY_MCP_RESULT_BYTES,
-  TRANSFER_HISTORY_TOOLS_PER_TURN,
-  TRANSFER_HISTORY_TURN_COUNT,
-  TRANSFER_MEASURED_MCP_RESULT_BYTES,
-  TRANSFER_MEASURED_TOOLS,
-} from "./fixtures/transferBudget.ts";
-
-export interface TransferBudgetRun {
-  readonly provider: ProviderDriverKind;
-  readonly threadSnapshot: HttpTransferMeasurement;
-  readonly measuredTurnWebSocket: WebSocketTransferTotals;
-}
-
-interface ProviderTransferBudget {
-  readonly totalWireBytes: number;
-  readonly threadSnapshotWireBytes: number;
-  readonly measuredTurnWebSocketWireBytes: number;
-  readonly measuredTurnWebSocketDecodedBytes: number;
-  readonly measuredTurnWebSocketMessages: number;
-}
-
-// These caps leave roughly 30% headroom above the client projection of the
-// deterministic 9 MB retained-result fixture. Full MCP results stay in
-// persistence, so accidentally shipping them again exceeds these caps by
-// orders of magnitude. The CI report preserves exact values for review.
-const TRANSFER_BUDGET = {
-  totalWireBytes: 15_500,
-  threadSnapshotWireBytes: 7_500,
-  measuredTurnWebSocketWireBytes: 8_000,
-  measuredTurnWebSocketDecodedBytes: 68_000,
-  measuredTurnWebSocketMessages: 21,
-} satisfies ProviderTransferBudget;
-
-export const TRANSFER_BUDGETS: Readonly<Record<string, ProviderTransferBudget>> = {
-  codex: TRANSFER_BUDGET,
-  claudeAgent: TRANSFER_BUDGET,
-};
-
-function totalWireBytes(run: TransferBudgetRun): number {
-  return run.threadSnapshot.wireBytes + run.measuredTurnWebSocket.wireBytes;
-}
-
-function observedTransfer(run: TransferBudgetRun) {
-  return {
-    totalWireBytes: totalWireBytes(run),
-    threadSnapshotWireBytes: run.threadSnapshot.wireBytes,
-    threadSnapshotDecodedBytes: run.threadSnapshot.decodedBodyBytes,
-    measuredTurnWebSocketWireBytes: run.measuredTurnWebSocket.wireBytes,
-    measuredTurnWebSocketDecodedBytes: run.measuredTurnWebSocket.decodedBytes,
-    measuredTurnWebSocketMessages: run.measuredTurnWebSocket.messages,
-  };
-}
-
-/** Machine-readable input for the trusted PR comment publisher. */
-export function formatTransferBudgetResult(runs: ReadonlyArray<TransferBudgetRun>): string {
-  const providers = Object.fromEntries(
-    runs.flatMap((run) => {
-      const ceiling = TRANSFER_BUDGETS[run.provider];
-      return ceiling ? [[run.provider, { observed: observedTransfer(run), ceiling }]] : [];
-    }),
-  );
-
-  return `${JSON.stringify(
-    {
-      schemaVersion: 1,
-      scenario: {
-        id: "thread-transfer-v1",
-        historyTurns: TRANSFER_HISTORY_TURN_COUNT,
-        historyCommandToolsPerTurn: TRANSFER_HISTORY_TOOLS_PER_TURN,
-        historyMcpResultBytes: TRANSFER_HISTORY_MCP_RESULT_BYTES,
-        measuredCommandTools: TRANSFER_MEASURED_TOOLS,
-        measuredMcpResultBytes: TRANSFER_MEASURED_MCP_RESULT_BYTES,
-      },
-      providers,
-    },
-    null,
-    2,
-  )}\n`;
-}
-
-function formatBytes(bytes: number): string {
-  if (bytes < 1_024) return `${bytes} B`;
-  if (bytes >= 1_024 * 1_024) {
-    return `${(bytes / 1_024 / 1_024).toFixed(2)} MiB (${bytes.toLocaleString("en-US")} B)`;
-  }
-  return `${(bytes / 1_024).toFixed(1)} KiB (${bytes.toLocaleString("en-US")} B)`;
-}
-
-function row(
-  provider: ProviderDriverKind,
-  phase: string,
-  metric: string,
-  observed: number,
-  maximum: number,
-  format: (value: number) => string = formatBytes,
-): string {
-  const status = observed <= maximum ? "PASS" : "FAIL";
-  return `| ${provider} | ${phase} | ${metric} | ${format(observed)} | ${format(maximum)} | ${status} |`;
-}
-
-export function transferBudgetViolations(runs: ReadonlyArray<TransferBudgetRun>): string[] {
-  const violations: string[] = [];
-  for (const run of runs) {
-    const budget = TRANSFER_BUDGETS[run.provider];
-    if (!budget) {
-      violations.push(`${run.provider}: no transfer budget is configured`);
-      continue;
-    }
-    const checks = [
-      ["total thread wire bytes", totalWireBytes(run), budget.totalWireBytes],
-      ["thread snapshot wire bytes", run.threadSnapshot.wireBytes, budget.threadSnapshotWireBytes],
-      [
-        "measured-turn WebSocket wire bytes",
-        run.measuredTurnWebSocket.wireBytes,
-        budget.measuredTurnWebSocketWireBytes,
-      ],
-      [
-        "measured-turn WebSocket decoded bytes",
-        run.measuredTurnWebSocket.decodedBytes,
-        budget.measuredTurnWebSocketDecodedBytes,
-      ],
-      [
-        "measured-turn WebSocket messages",
-        run.measuredTurnWebSocket.messages,
-        budget.measuredTurnWebSocketMessages,
-      ],
-    ] as const;
-    for (const [metric, observed, maximum] of checks) {
-      if (observed > maximum) {
-        violations.push(`${run.provider}: ${metric} was ${observed}, maximum ${maximum}`);
-      }
-    }
-  }
-  return violations;
-}
-
-export function formatTransferBudgetReport(runs: ReadonlyArray<TransferBudgetRun>): string {
-  const lines = [
-    "# T3 Code thread transfer budget",
-    "",
-    "Wire values are thread data bytes read from local HTTP and WebSocket sockets. HTTP includes response headers; WebSocket measurement starts after the resumed thread subscription synchronizes. TCP/IP, TLS framing, and the WebSocket upgrade are excluded. WebSocket permessage-deflate is negotiated.",
-    `Scenario: ${TRANSFER_HISTORY_TURN_COUNT} historical turns with ${TRANSFER_HISTORY_TOOLS_PER_TURN} command tools and one retained ${formatBytes(TRANSFER_HISTORY_MCP_RESULT_BYTES)} MCP result each, followed by one measured turn with ${TRANSFER_MEASURED_TOOLS} command tools and a retained ${formatBytes(TRANSFER_MEASURED_MCP_RESULT_BYTES)} MCP result. Payload sizes are calibrated from heavy local Codex and Claude histories and contain no user data.`,
-    "",
-    "| Provider | Total thread wire | Budget | Result |",
-    "| --- | ---: | ---: | --- |",
-    ...runs.flatMap((run) => {
-      const budget = TRANSFER_BUDGETS[run.provider];
-      if (!budget) return [];
-      const observed = observedTransfer(run).totalWireBytes;
-      return [
-        `| ${run.provider} | ${formatBytes(observed)} | ${formatBytes(budget.totalWireBytes)} | ${observed <= budget.totalWireBytes ? "PASS" : "FAIL"} |`,
-      ];
-    }),
-    "",
-    "## Detailed measurements",
-    "",
-    "| Provider | Phase | Metric | Observed | Budget | Result |",
-    "| --- | --- | --- | ---: | ---: | --- |",
-  ];
-
-  for (const run of runs) {
-    const budget = TRANSFER_BUDGETS[run.provider];
-    if (!budget) continue;
-    lines.push(
-      row(
-        run.provider,
-        "thread snapshot",
-        "HTTP wire",
-        run.threadSnapshot.wireBytes,
-        budget.threadSnapshotWireBytes,
-      ),
-      row(
-        run.provider,
-        "measured turn",
-        "WebSocket wire",
-        run.measuredTurnWebSocket.wireBytes,
-        budget.measuredTurnWebSocketWireBytes,
-      ),
-      row(
-        run.provider,
-        "measured turn",
-        "WebSocket decoded",
-        run.measuredTurnWebSocket.decodedBytes,
-        budget.measuredTurnWebSocketDecodedBytes,
-      ),
-      row(
-        run.provider,
-        "measured turn",
-        "WebSocket messages",
-        run.measuredTurnWebSocket.messages,
-        budget.measuredTurnWebSocketMessages,
-        String,
-      ),
-    );
-  }
-
-  lines.push("", "## Compression diagnostics", "");
-  for (const run of runs) {
-    lines.push(
-      `- ${run.provider}: thread snapshot ${formatBytes(run.threadSnapshot.decodedBodyBytes)} decoded to ${formatBytes(run.threadSnapshot.encodedBodyBytes)} gzip.`,
-    );
-  }
-
-  return `${lines.join("\n")}\n`;
-}
diff --git a/apps/server/integration/TransferBudgetScenario.integration.ts b/apps/server/integration/TransferBudgetScenario.integration.ts
deleted file mode 100644
index 77dfbc1dd7fb..000000000000
--- a/apps/server/integration/TransferBudgetScenario.integration.ts
+++ /dev/null
@@ -1,128 +0,0 @@
-import {
-  CommandId,
-  defaultInstanceIdForDriver,
-  DEFAULT_MODEL,
-  DEFAULT_MODEL_BY_PROVIDER,
-  DEFAULT_PROVIDER_INTERACTION_MODE,
-  MessageId,
-  ProjectId,
-  ProviderDriverKind,
-  ThreadId,
-} from "@t3tools/contracts";
-import * as Effect from "effect/Effect";
-
-import type { TurnProcessingQuiescedReceipt } from "../src/orchestration/Services/RuntimeReceiptBus.ts";
-import type { OrchestrationIntegrationHarness } from "./OrchestrationEngineHarness.integration.ts";
-import {
-  expectedRecordedAssistantText,
-  makeRecordedTransferTurn,
-  TRANSFER_HISTORY_TURN_COUNT,
-} from "./fixtures/transferBudget.ts";
-
-export const TRANSFER_PROJECT_ID = ProjectId.make("transfer-budget-project");
-export const TRANSFER_THREAD_ID = ThreadId.make("transfer-budget-thread");
-export const TRANSFER_MEASURED_TURN_INDEX = TRANSFER_HISTORY_TURN_COUNT;
-
-export function transferModelSelection(provider: ProviderDriverKind) {
-  return {
-    instanceId: defaultInstanceIdForDriver(provider),
-    model: DEFAULT_MODEL_BY_PROVIDER[provider] ?? DEFAULT_MODEL,
-  };
-}
-
-function turnTimestamp(turnIndex: number): string {
-  return `2026-06-01T00:${String(turnIndex).padStart(2, "0")}:00.000Z`;
-}
-
-export const TRANSFER_MEASURED_TURN_CREATED_AT = turnTimestamp(TRANSFER_MEASURED_TURN_INDEX);
-
-const waitForTurnQuiesced = Effect.fn("TransferBudget.waitForTurnQuiesced")(function* (
-  harness: OrchestrationIntegrationHarness,
-  checkpointTurnCount: number,
-) {
-  const receipt = yield* harness.waitForReceipt(
-    (receipt): receipt is TurnProcessingQuiescedReceipt =>
-      receipt.type === "turn.processing.quiesced" &&
-      receipt.threadId === TRANSFER_THREAD_ID &&
-      receipt.checkpointTurnCount === checkpointTurnCount,
-  );
-  yield* harness.drainProviderRuntime;
-  yield* harness.drainCheckpointReactor;
-  return receipt;
-});
-
-export const seedTransferBudgetHistory = Effect.fn("TransferBudget.seedHistory")(function* (
-  harness: OrchestrationIntegrationHarness,
-  provider: ProviderDriverKind,
-) {
-  if (!harness.adapterHarness) {
-    return yield* Effect.die(new Error("Transfer budget history requires the replay adapter."));
-  }
-
-  const modelSelection = transferModelSelection(provider);
-  yield* harness.engine.dispatch({
-    type: "project.create",
-    commandId: CommandId.make(`transfer:${provider}:project-create`),
-    projectId: TRANSFER_PROJECT_ID,
-    title: "Transfer Budget Project",
-    workspaceRoot: harness.workspaceDir,
-    defaultModelSelection: modelSelection,
-    createdAt: turnTimestamp(0),
-  });
-  yield* harness.engine.dispatch({
-    type: "thread.create",
-    commandId: CommandId.make(`transfer:${provider}:thread-create`),
-    threadId: TRANSFER_THREAD_ID,
-    projectId: TRANSFER_PROJECT_ID,
-    title: `${provider} transfer history`,
-    modelSelection,
-    runtimeMode: "approval-required",
-    interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-    branch: "main",
-    worktreePath: harness.workspaceDir,
-    createdAt: turnTimestamp(0),
-  });
-
-  for (let turnIndex = 0; turnIndex < TRANSFER_HISTORY_TURN_COUNT; turnIndex += 1) {
-    const response = makeRecordedTransferTurn(provider, turnIndex);
-    if (turnIndex === 0) {
-      yield* harness.adapterHarness.queueTurnResponseForNextSession(response);
-    } else {
-      yield* harness.adapterHarness.queueTurnResponse(TRANSFER_THREAD_ID, response);
-    }
-
-    yield* harness.engine.dispatch({
-      type: "thread.turn.start",
-      commandId: CommandId.make(`transfer:${provider}:turn:${turnIndex + 1}`),
-      threadId: TRANSFER_THREAD_ID,
-      message: {
-        messageId: MessageId.make(`transfer-user-${turnIndex + 1}`),
-        role: "user",
-        text: `Inspect transfer behavior for historical turn ${turnIndex + 1}.`,
-        attachments: [],
-      },
-      modelSelection,
-      runtimeMode: "approval-required",
-      interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-      createdAt: turnTimestamp(turnIndex),
-    });
-    yield* waitForTurnQuiesced(harness, turnIndex + 1);
-  }
-});
-
-export const queueMeasuredTransferTurn = Effect.fn("TransferBudget.queueMeasuredTurn")(function* (
-  harness: OrchestrationIntegrationHarness,
-  provider: ProviderDriverKind,
-) {
-  if (!harness.adapterHarness) {
-    return yield* Effect.die(new Error("Transfer budget measurement requires the replay adapter."));
-  }
-  const response = makeRecordedTransferTurn(provider, TRANSFER_MEASURED_TURN_INDEX);
-  yield* harness.adapterHarness.queueTurnResponse(TRANSFER_THREAD_ID, response);
-});
-
-export function expectedMeasuredAssistantText(provider: ProviderDriverKind): string {
-  return expectedRecordedAssistantText(provider, TRANSFER_MEASURED_TURN_INDEX);
-}
-
-export { TRANSFER_HISTORY_TURN_COUNT, waitForTurnQuiesced };
diff --git a/apps/server/integration/fixtures/providerRuntime.ts b/apps/server/integration/fixtures/providerRuntime.ts
deleted file mode 100644
index e1258c4cc62a..000000000000
--- a/apps/server/integration/fixtures/providerRuntime.ts
+++ /dev/null
@@ -1,162 +0,0 @@
-import { EventId, ProviderDriverKind, RuntimeRequestId } from "@t3tools/contracts";
-import type { LegacyProviderRuntimeEvent } from "../TestProviderAdapter.integration.ts";
-
-const PROVIDER = ProviderDriverKind.make("codex");
-const SESSION_ID = "fixture-session";
-const THREAD_ID = "fixture-thread";
-const TURN_ID = "fixture-turn";
-const REQUEST_ID = RuntimeRequestId.make("req-1");
-
-function baseEvent(
-  eventId: string,
-  createdAt: string,
-): Pick<LegacyProviderRuntimeEvent, "eventId" | "provider" | "sessionId" | "createdAt"> {
-  return {
-    eventId: EventId.make(eventId),
-    provider: PROVIDER,
-    sessionId: SESSION_ID,
-    createdAt,
-  };
-}
-
-export const codexTurnTextFixture = [
-  {
-    type: "turn.started",
-    ...baseEvent("evt-1", "2026-02-23T00:00:00.000Z"),
-    threadId: THREAD_ID,
-    turnId: TURN_ID,
-    payload: {},
-  },
-  {
-    type: "content.delta",
-    ...baseEvent("evt-2", "2026-02-23T00:00:00.100Z"),
-    threadId: THREAD_ID,
-    turnId: TURN_ID,
-    payload: {
-      streamKind: "assistant_text",
-      delta: "I will make a small update.\n",
-    },
-  },
-  {
-    type: "content.delta",
-    ...baseEvent("evt-3", "2026-02-23T00:00:00.200Z"),
-    threadId: THREAD_ID,
-    turnId: TURN_ID,
-    payload: {
-      streamKind: "assistant_text",
-      delta: "Done.\n",
-    },
-  },
-  {
-    type: "turn.completed",
-    ...baseEvent("evt-4", "2026-02-23T00:00:00.300Z"),
-    threadId: THREAD_ID,
-    turnId: TURN_ID,
-    payload: {
-      state: "completed",
-    },
-  },
-] satisfies ReadonlyArray<LegacyProviderRuntimeEvent>;
-
-export const codexTurnToolFixture = [
-  {
-    type: "turn.started",
-    ...baseEvent("evt-11", "2026-02-23T00:01:00.000Z"),
-    threadId: THREAD_ID,
-    turnId: TURN_ID,
-    payload: {},
-  },
-  {
-    type: "item.started",
-    ...baseEvent("evt-12", "2026-02-23T00:01:00.100Z"),
-    threadId: THREAD_ID,
-    turnId: TURN_ID,
-    payload: {
-      itemType: "command_execution",
-      title: "Ran command",
-      detail: "echo integration",
-    },
-  },
-  {
-    type: "item.completed",
-    ...baseEvent("evt-13", "2026-02-23T00:01:00.200Z"),
-    threadId: THREAD_ID,
-    turnId: TURN_ID,
-    payload: {
-      itemType: "command_execution",
-      status: "completed",
-      title: "Ran command",
-      detail: "echo integration",
-    },
-  },
-  {
-    type: "content.delta",
-    ...baseEvent("evt-14", "2026-02-23T00:01:00.300Z"),
-    threadId: THREAD_ID,
-    turnId: TURN_ID,
-    payload: {
-      streamKind: "assistant_text",
-      delta: "Applied the requested edit.\n",
-    },
-  },
-  {
-    type: "turn.completed",
-    ...baseEvent("evt-15", "2026-02-23T00:01:00.400Z"),
-    threadId: THREAD_ID,
-    turnId: TURN_ID,
-    payload: {
-      state: "completed",
-    },
-  },
-] satisfies ReadonlyArray<LegacyProviderRuntimeEvent>;
-
-export const codexTurnApprovalFixture = [
-  {
-    type: "turn.started",
-    ...baseEvent("evt-21", "2026-02-23T00:02:00.000Z"),
-    threadId: THREAD_ID,
-    turnId: TURN_ID,
-    payload: {},
-  },
-  {
-    type: "request.opened",
-    ...baseEvent("evt-22", "2026-02-23T00:02:00.100Z"),
-    threadId: THREAD_ID,
-    turnId: TURN_ID,
-    requestId: REQUEST_ID,
-    payload: {
-      requestType: "command_execution_approval",
-      detail: "Please approve command",
-    },
-  },
-  {
-    type: "request.resolved",
-    ...baseEvent("evt-23", "2026-02-23T00:02:00.200Z"),
-    threadId: THREAD_ID,
-    turnId: TURN_ID,
-    requestId: REQUEST_ID,
-    payload: {
-      requestType: "command_execution_approval",
-      decision: "accept",
-    },
-  },
-  {
-    type: "content.delta",
-    ...baseEvent("evt-24", "2026-02-23T00:02:00.300Z"),
-    threadId: THREAD_ID,
-    turnId: TURN_ID,
-    payload: {
-      streamKind: "assistant_text",
-      delta: "Approval received and command executed.\n",
-    },
-  },
-  {
-    type: "turn.completed",
-    ...baseEvent("evt-25", "2026-02-23T00:02:00.400Z"),
-    threadId: THREAD_ID,
-    turnId: TURN_ID,
-    payload: {
-      state: "completed",
-    },
-  },
-] satisfies ReadonlyArray<LegacyProviderRuntimeEvent>;
diff --git a/apps/server/integration/fixtures/transferBudget.ts b/apps/server/integration/fixtures/transferBudget.ts
deleted file mode 100644
index d3567d386b9e..000000000000
--- a/apps/server/integration/fixtures/transferBudget.ts
+++ /dev/null
@@ -1,372 +0,0 @@
-import { EventId, ProviderDriverKind } from "@t3tools/contracts";
-
-import type {
-  FixtureProviderRuntimeEvent,
-  TestTurnResponse,
-} from "../TestProviderAdapter.integration.ts";
-
-const FIXTURE_THREAD_ID = "transfer-budget-thread";
-const FIXTURE_TURN_ID = "transfer-budget-turn";
-
-export const TRANSFER_HISTORY_TURN_COUNT = 10;
-export const TRANSFER_HISTORY_TOOLS_PER_TURN = 5;
-export const TRANSFER_MEASURED_TOOLS = 20;
-export const TRANSFER_HISTORY_MCP_RESULT_BYTES = 900_000;
-export const TRANSFER_MEASURED_MCP_RESULT_BYTES = 1_100_000;
-
-const sourceModules = [
-  "connection/session.ts",
-  "connection/supervisor.ts",
-  "rpc/client.ts",
-  "rpc/protocol.ts",
-  "state/threads.ts",
-  "state/threadReducer.ts",
-  "state/threadSnapshotHttp.ts",
-  "orchestration/http.ts",
-  "orchestration/Normalizer.ts",
-  "orchestration/ActivityPayloadProjection.ts",
-  "provider/ProviderService.ts",
-  "provider/ProviderRuntimeIngestion.ts",
-  "persistence/ProjectionSnapshotQuery.ts",
-  "persistence/OrchestrationEventStore.ts",
-  "checkpointing/CheckpointStore.ts",
-  "checkpointing/CheckpointDiffQuery.ts",
-  "server.ts",
-] as const;
-
-function fixtureTimestamp(turnIndex: number, eventIndex: number): string {
-  const minute = String(turnIndex).padStart(2, "0");
-  const second = String(Math.floor(eventIndex / 1_000)).padStart(2, "0");
-  const millisecond = String(eventIndex % 1_000).padStart(3, "0");
-  return `2026-06-01T00:${minute}:${second}.${millisecond}Z`;
-}
-
-function mix(value: number): number {
-  let mixed = value | 0;
-  mixed ^= mixed >>> 16;
-  mixed = Math.imul(mixed, 0x7feb352d);
-  mixed ^= mixed >>> 15;
-  mixed = Math.imul(mixed, 0x846ca68b);
-  mixed ^= mixed >>> 16;
-  return mixed >>> 0;
-}
-
-function digest(seed: number): string {
-  return [0, 1, 2, 3]
-    .map((offset) =>
-      mix(seed + offset * 0x9e3779b9)
-        .toString(16)
-        .padStart(8, "0"),
-    )
-    .join("");
-}
-
-/** Produces safe, deterministic output with enough entropy to exercise gzip. */
-function diagnosticOutput(input: {
-  readonly provider: ProviderDriverKind;
-  readonly turnIndex: number;
-  readonly toolIndex: number;
-  readonly targetBytes: number;
-}): string {
-  const chunks: string[] = [];
-  const providerSeed = input.provider === "codex" ? 0x43_4f_44_45 : 0x43_4c_41_55;
-  let length = 0;
-  let lineIndex = 0;
-
-  while (length < input.targetBytes) {
-    const modulePath = sourceModules[(input.toolIndex + lineIndex) % sourceModules.length];
-    const seed =
-      providerSeed + input.turnIndex * 100_003 + input.toolIndex * 10_007 + lineIndex * 101;
-    const line =
-      `${String(lineIndex + 1).padStart(6, "0")} ${modulePath} ` +
-      `operation=project-transfer-${input.turnIndex + 1}-${input.toolIndex + 1} ` +
-      `cursor=${mix(seed)} digest=${digest(seed)} status=completed\n`;
-    chunks.push(line);
-    length += line.length;
-    lineIndex += 1;
-  }
-
-  return chunks.join("").slice(0, input.targetBytes);
-}
-
-function assistantChunks(provider: ProviderDriverKind, turnIndex: number): ReadonlyArray<string> {
-  const providerName = provider === "codex" ? "Codex" : "Claude";
-  const paragraphs: string[] = [
-    `I traced the ${providerName} request through the environment connection and orchestration layers. `,
-  ];
-  let paragraphIndex = 0;
-  while (paragraphs.join("").length < 4_096) {
-    const modulePath = sourceModules[paragraphIndex % sourceModules.length];
-    paragraphs.push(
-      `Pass ${paragraphIndex + 1} reviewed ${modulePath} for turn ${turnIndex + 1}. ` +
-        "The shell cursor stayed monotonic, the thread snapshot remained resumable, and the client received only incremental events. ",
-    );
-    paragraphIndex += 1;
-  }
-  const text = paragraphs.join("").slice(0, 4_096);
-  return Array.from({ length: Math.ceil(text.length / 256) }, (_, index) =>
-    text.slice(index * 256, (index + 1) * 256),
-  );
-}
-
-export function expectedRecordedAssistantText(
-  provider: ProviderDriverKind,
-  turnIndex: number,
-): string {
-  return assistantChunks(provider, turnIndex).join("");
-}
-
-function unifiedDiff(provider: ProviderDriverKind, turnIndex: number): string {
-  const lines = sourceModules
-    .slice(0, 8)
-    .flatMap((modulePath, index) => [
-      `diff --git a/${modulePath} b/${modulePath}`,
-      `--- a/${modulePath}`,
-      `+++ b/${modulePath}`,
-      `@@ -${index + 1},2 +${index + 1},3 @@`,
-      ` const provider = "${provider}";`,
-      `+const transferTurn = ${turnIndex + 1};`,
-      `+const transferSample = ${1_500 + index * 97};`,
-    ]);
-  return lines.join("\n");
-}
-
-function baseEvent(
-  provider: ProviderDriverKind,
-  turnIndex: number,
-  eventIndex: number,
-): Pick<FixtureProviderRuntimeEvent, "eventId" | "provider" | "createdAt" | "threadId"> {
-  return {
-    eventId: EventId.make(`recorded:${provider}:${turnIndex}:${eventIndex}`),
-    provider,
-    createdAt: fixtureTimestamp(turnIndex, eventIndex),
-    threadId: FIXTURE_THREAD_ID,
-  };
-}
-
-/**
- * Synthetic canonical events calibrated from heavy local Codex and Claude
- * threads. Ten historical turns produce 9 MB of retained MCP results without
- * committing user content. Command output is intentionally modest because the
- * client projection strips it.
- */
-export function makeRecordedTransferTurn(
-  provider: ProviderDriverKind,
-  turnIndex: number,
-): TestTurnResponse {
-  const measuredTurn = turnIndex >= TRANSFER_HISTORY_TURN_COUNT;
-  const toolCount = measuredTurn ? TRANSFER_MEASURED_TOOLS : TRANSFER_HISTORY_TOOLS_PER_TURN;
-  const turnId = `${FIXTURE_TURN_ID}-${turnIndex + 1}`;
-  const events: FixtureProviderRuntimeEvent[] = [];
-  let eventIndex = 0;
-
-  events.push({
-    type: "turn.started",
-    ...baseEvent(provider, turnIndex, eventIndex++),
-    turnId,
-    payload: {
-      model: provider === "codex" ? "gpt-5.4" : "claude-opus-4-1",
-      effort: provider === "codex" ? "high" : "default",
-    },
-  });
-
-  for (let toolIndex = 0; toolIndex < toolCount; toolIndex += 1) {
-    const itemId = `tool-${turnIndex + 1}-${toolIndex + 1}`;
-    const command =
-      provider === "codex"
-        ? `vp test transfer-budget-${toolIndex + 1}`
-        : `review transfer budget ${toolIndex + 1}`;
-    events.push(
-      {
-        type: "item.started",
-        ...baseEvent(provider, turnIndex, eventIndex++),
-        turnId,
-        itemId,
-        payload: {
-          itemType: "command_execution",
-          status: "inProgress",
-          title: `Inspect transfer path ${toolIndex + 1}`,
-          detail: "Inspecting the HTTP snapshot and WebSocket projection boundaries.",
-          data: {
-            threadId: FIXTURE_THREAD_ID,
-            turnId,
-            startedAtMs: turnIndex * 60_000 + eventIndex,
-            item: {
-              id: itemId,
-              type: "commandExecution",
-              command,
-              cwd: "/workspace/transfer-budget",
-              processId: String(toolIndex + 1),
-              status: "inProgress",
-              commandActions: [],
-              aggregatedOutput: "",
-            },
-          },
-        },
-      },
-      {
-        type: "item.completed",
-        ...baseEvent(provider, turnIndex, eventIndex++),
-        turnId,
-        itemId,
-        payload: {
-          itemType: "command_execution",
-          status: "completed",
-          title: `Inspected transfer path ${toolIndex + 1}`,
-          detail: "Collected a deterministic multi-module transfer diagnostic.",
-          data: {
-            threadId: FIXTURE_THREAD_ID,
-            turnId,
-            completedAtMs: turnIndex * 60_000 + eventIndex,
-            item: {
-              id: itemId,
-              type: "commandExecution",
-              command,
-              cwd: "/workspace/transfer-budget",
-              processId: String(toolIndex + 1),
-              status: "completed",
-              commandActions: [],
-              aggregatedOutput: diagnosticOutput({
-                provider,
-                turnIndex,
-                toolIndex,
-                targetBytes: 1_000,
-              }),
-              exitCode: 0,
-              durationMs: 500 + toolIndex,
-            },
-          },
-        },
-      },
-    );
-  }
-
-  const mcpItemId = `mcp-${turnIndex + 1}`;
-  const mcpResultBytes = measuredTurn
-    ? TRANSFER_MEASURED_MCP_RESULT_BYTES
-    : TRANSFER_HISTORY_MCP_RESULT_BYTES;
-  events.push(
-    {
-      type: "item.started",
-      ...baseEvent(provider, turnIndex, eventIndex++),
-      turnId,
-      itemId: mcpItemId,
-      payload: {
-        itemType: "mcp_tool_call",
-        status: "inProgress",
-        title: "fixture-history · inspect_transfer_log",
-        detail: "Reading a retained diagnostic result from the provider history.",
-        data: {
-          startedAtMs: turnIndex * 60_000 + eventIndex,
-          threadId: FIXTURE_THREAD_ID,
-          turnId,
-          item: {
-            type: "mcpToolCall",
-            id: mcpItemId,
-            server: "fixture-history",
-            tool: "inspect_transfer_log",
-            arguments: { turn: turnIndex + 1 },
-            status: "inProgress",
-          },
-        },
-      },
-    },
-    {
-      type: "item.completed",
-      ...baseEvent(provider, turnIndex, eventIndex++),
-      turnId,
-      itemId: mcpItemId,
-      payload: {
-        itemType: "mcp_tool_call",
-        status: "completed",
-        title: "fixture-history · inspect_transfer_log",
-        detail: "Retained a deterministic diagnostic result in the thread history.",
-        data: {
-          completedAtMs: turnIndex * 60_000 + eventIndex,
-          threadId: FIXTURE_THREAD_ID,
-          turnId,
-          item: {
-            type: "mcpToolCall",
-            id: mcpItemId,
-            server: "fixture-history",
-            tool: "inspect_transfer_log",
-            arguments: { turn: turnIndex + 1 },
-            durationMs: 1_000 + turnIndex,
-            error: null,
-            result: {
-              content: [
-                {
-                  type: "text",
-                  text: diagnosticOutput({
-                    provider,
-                    turnIndex,
-                    toolIndex: toolCount,
-                    targetBytes: mcpResultBytes,
-                  }),
-                },
-              ],
-            },
-            status: "completed",
-          },
-        },
-      },
-    },
-  );
-
-  const chunks = assistantChunks(provider, turnIndex);
-  for (const [contentIndex, delta] of chunks.entries()) {
-    events.push({
-      type: "content.delta",
-      ...baseEvent(provider, turnIndex, eventIndex++),
-      turnId,
-      itemId: `assistant-${turnIndex + 1}`,
-      payload: {
-        streamKind: "assistant_text",
-        delta,
-        contentIndex,
-      },
-    });
-  }
-
-  events.push(
-    {
-      type: "thread.token-usage.updated",
-      ...baseEvent(provider, turnIndex, eventIndex++),
-      turnId,
-      payload: {
-        usage: {
-          usedTokens: 18_000 + turnIndex * 1_900,
-          maxTokens: 200_000,
-          inputTokens: 15_000 + turnIndex * 1_700,
-          cachedInputTokens: 9_000 + turnIndex * 1_100,
-          outputTokens: 3_000 + turnIndex * 200,
-          toolUses: toolCount,
-          durationMs: 4_000 + turnIndex * 250,
-        },
-      },
-    },
-    {
-      type: "turn.diff.updated",
-      ...baseEvent(provider, turnIndex, eventIndex++),
-      turnId,
-      payload: {
-        unifiedDiff: unifiedDiff(provider, turnIndex),
-      },
-    },
-    {
-      type: "turn.completed",
-      ...baseEvent(provider, turnIndex, eventIndex),
-      turnId,
-      payload: {
-        state: "completed",
-        stopReason: "end_turn",
-        usage: {
-          inputTokens: 15_000 + turnIndex * 1_700,
-          outputTokens: 3_000 + turnIndex * 200,
-        },
-      },
-    },
-  );
-
-  return { events };
-}
diff --git a/apps/server/integration/orchestrationEngine.integration.test.ts b/apps/server/integration/orchestrationEngine.integration.test.ts
deleted file mode 100644
index ccfb9c467421..000000000000
--- a/apps/server/integration/orchestrationEngine.integration.test.ts
+++ /dev/null
@@ -1,1441 +0,0 @@
-// @effect-diagnostics nodeBuiltinImport:off
-import * as NodeFS from "node:fs";
-import * as NodePath from "node:path";
-
-import {
-  ApprovalRequestId,
-  CommandId,
-  defaultInstanceIdForDriver,
-  DEFAULT_PROVIDER_INTERACTION_MODE,
-  DEFAULT_MODEL,
-  DEFAULT_MODEL_BY_PROVIDER,
-  EventId,
-  MessageId,
-  ProjectId,
-  ProviderDriverKind,
-  ThreadId,
-  ModelSelection,
-  ProviderInstanceId,
-} from "@t3tools/contracts";
-import { assert, it } from "@effect/vitest";
-import * as Clock from "effect/Clock";
-import * as Effect from "effect/Effect";
-import * as Option from "effect/Option";
-import * as Schema from "effect/Schema";
-
-import type { TestTurnResponse } from "./TestProviderAdapter.integration.ts";
-import {
-  gitRefExists,
-  gitShowFileAtRef,
-  makeOrchestrationIntegrationHarness,
-  type OrchestrationIntegrationHarness,
-} from "./OrchestrationEngineHarness.integration.ts";
-import { checkpointRefForThreadTurn } from "../src/checkpointing/Utils.ts";
-import type {
-  CheckpointDiffFinalizedReceipt,
-  TurnProcessingQuiescedReceipt,
-} from "../src/orchestration/Services/RuntimeReceiptBus.ts";
-import * as NodeServices from "@effect/platform-node/NodeServices";
-
-const asMessageId = (value: string): MessageId => MessageId.make(value);
-const asProjectId = (value: string): ProjectId => ProjectId.make(value);
-const asEventId = (value: string): EventId => EventId.make(value);
-const asApprovalRequestId = (value: string): ApprovalRequestId => ApprovalRequestId.make(value);
-
-const PROJECT_ID = asProjectId("project-1");
-const THREAD_ID = ThreadId.make("thread-1");
-const FIXTURE_TURN_ID = "fixture-turn";
-const APPROVAL_REQUEST_ID = asApprovalRequestId("req-approval-1");
-type IntegrationProvider = ProviderDriverKind;
-const CODEX_PROVIDER = ProviderDriverKind.make("codex");
-const CLAUDE_AGENT_PROVIDER = ProviderDriverKind.make("claudeAgent");
-
-function nowIso() {
-  return "2026-05-01T00:00:00.000Z";
-}
-
-class IntegrationWaitTimeoutError extends Schema.TaggedErrorClass<IntegrationWaitTimeoutError>()(
-  "IntegrationWaitTimeoutError",
-  {
-    description: Schema.String,
-  },
-) {}
-
-function waitForSync<A>(
-  read: () => A,
-  predicate: (value: A) => boolean,
-  description: string,
-  timeoutMs = 10_000,
-): Effect.Effect<A, never> {
-  return Effect.gen(function* () {
-    const deadline = (yield* Clock.currentTimeMillis) + timeoutMs;
-
-    while (true) {
-      const value = read();
-      if (predicate(value)) {
-        return value;
-      }
-      if ((yield* Clock.currentTimeMillis) >= deadline) {
-        return yield* Effect.die(new IntegrationWaitTimeoutError({ description }));
-      }
-      yield* Effect.sleep(10);
-    }
-  });
-}
-
-function runtimeBase(
-  eventId: string,
-  createdAt: string,
-  provider: IntegrationProvider = CODEX_PROVIDER,
-) {
-  return {
-    eventId: asEventId(eventId),
-    provider,
-    createdAt,
-  };
-}
-
-function withHarness<A, E>(
-  use: (harness: OrchestrationIntegrationHarness) => Effect.Effect<A, E>,
-  provider: IntegrationProvider = CODEX_PROVIDER,
-) {
-  return Effect.acquireUseRelease(
-    makeOrchestrationIntegrationHarness({ provider }),
-    use,
-    (harness) => harness.dispose,
-  ).pipe(Effect.provide(NodeServices.layer));
-}
-
-function withRealCodexHarness<A, E>(
-  use: (harness: OrchestrationIntegrationHarness) => Effect.Effect<A, E>,
-) {
-  return Effect.acquireUseRelease(
-    makeOrchestrationIntegrationHarness({ provider: CODEX_PROVIDER, realCodex: true }),
-    use,
-    (harness) => harness.dispose,
-  ).pipe(Effect.provide(NodeServices.layer));
-}
-
-const seedProjectAndThread = (harness: OrchestrationIntegrationHarness) =>
-  Effect.gen(function* () {
-    const createdAt = nowIso();
-    const provider = harness.adapterHarness?.provider ?? CODEX_PROVIDER;
-    const defaultModel = DEFAULT_MODEL_BY_PROVIDER[provider] ?? DEFAULT_MODEL;
-    const instanceId = defaultInstanceIdForDriver(provider);
-
-    yield* harness.engine.dispatch({
-      type: "project.create",
-      commandId: CommandId.make("cmd-project-create"),
-      projectId: PROJECT_ID,
-      title: "Integration Project",
-      workspaceRoot: harness.workspaceDir,
-      defaultModelSelection: {
-        instanceId,
-        model: defaultModel,
-      },
-      createdAt,
-    });
-
-    yield* harness.engine.dispatch({
-      type: "thread.create",
-      commandId: CommandId.make("cmd-thread-create"),
-      threadId: THREAD_ID,
-      projectId: PROJECT_ID,
-      title: "Integration Thread",
-      modelSelection: {
-        instanceId,
-        model: defaultModel,
-      },
-      interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-      runtimeMode: "approval-required",
-      branch: null,
-      worktreePath: harness.workspaceDir,
-      createdAt,
-    });
-  });
-
-const startTurn = (input: {
-  readonly harness: OrchestrationIntegrationHarness;
-  readonly commandId: string;
-  readonly messageId: string;
-  readonly text: string;
-  readonly modelSelection?: ModelSelection;
-  readonly createdAt?: string;
-}) =>
-  input.harness.engine.dispatch({
-    type: "thread.turn.start",
-    commandId: CommandId.make(input.commandId),
-    threadId: THREAD_ID,
-    message: {
-      messageId: asMessageId(input.messageId),
-      role: "user",
-      text: input.text,
-      attachments: [],
-    },
-    ...(input.modelSelection !== undefined
-      ? {
-          modelSelection: input.modelSelection,
-        }
-      : {}),
-    interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-    runtimeMode: "approval-required",
-    createdAt: input.createdAt ?? nowIso(),
-  });
-
-it.live("runs a single turn end-to-end and persists checkpoint state in sqlite + git", () =>
-  withHarness((harness) =>
-    Effect.gen(function* () {
-      yield* seedProjectAndThread(harness);
-
-      const turnResponse: TestTurnResponse = {
-        events: [
-          {
-            type: "turn.started",
-            ...runtimeBase("evt-single-1", "2026-02-24T10:00:00.000Z"),
-            threadId: THREAD_ID,
-            turnId: FIXTURE_TURN_ID,
-          },
-          {
-            type: "message.delta",
-            ...runtimeBase("evt-single-2", "2026-02-24T10:00:00.100Z"),
-            threadId: THREAD_ID,
-            turnId: FIXTURE_TURN_ID,
-            delta: "Single turn response.\n",
-          },
-          {
-            type: "turn.completed",
-            ...runtimeBase("evt-single-3", "2026-02-24T10:00:00.200Z"),
-            threadId: THREAD_ID,
-            turnId: FIXTURE_TURN_ID,
-            status: "completed",
-          },
-        ],
-      };
-
-      yield* harness.adapterHarness!.queueTurnResponseForNextSession(turnResponse);
-      yield* startTurn({
-        harness,
-        commandId: "cmd-turn-start-single",
-        messageId: "msg-user-single",
-        text: "Say hello",
-      });
-      const finalizedReceipt = yield* harness.waitForReceipt(
-        (receipt): receipt is CheckpointDiffFinalizedReceipt =>
-          receipt.type === "checkpoint.diff.finalized" &&
-          receipt.threadId === THREAD_ID &&
-          receipt.checkpointTurnCount === 1,
-      );
-      if (finalizedReceipt.type !== "checkpoint.diff.finalized") {
-        throw new Error("Expected checkpoint.diff.finalized receipt.");
-      }
-      assert.equal(finalizedReceipt.status, "ready");
-      yield* harness.waitForReceipt(
-        (receipt): receipt is TurnProcessingQuiescedReceipt =>
-          receipt.type === "turn.processing.quiesced" &&
-          receipt.threadId === THREAD_ID &&
-          receipt.checkpointTurnCount === 1,
-      );
-
-      const thread = yield* harness.waitForThread(
-        THREAD_ID,
-        (entry) =>
-          entry.session?.status === "ready" &&
-          entry.messages.some(
-            (message) => message.role === "assistant" && message.streaming === false,
-          ) &&
-          entry.checkpoints.length === 1,
-      );
-      assert.equal(thread.checkpoints[0]?.status, "ready");
-      assert.equal(thread.checkpoints[0]?.checkpointTurnCount, 1);
-
-      const checkpointRows = yield* harness.checkpointRepository.listByThreadId({
-        threadId: THREAD_ID,
-      });
-      assert.equal(checkpointRows.length, 1);
-      assert.equal(checkpointRows[0]?.checkpointTurnCount, 1);
-      assert.equal(checkpointRows[0]?.status, "ready");
-      assert.deepEqual(checkpointRows[0]?.files, []);
-
-      const ref0 = checkpointRefForThreadTurn(THREAD_ID, 0);
-      const ref1 = checkpointRefForThreadTurn(THREAD_ID, 1);
-      assert.equal(gitRefExists(harness.workspaceDir, ref0), true);
-      assert.equal(gitRefExists(harness.workspaceDir, ref1), true);
-      assert.equal(gitShowFileAtRef(harness.workspaceDir, ref0, "README.md"), "v1\n");
-      assert.equal(gitShowFileAtRef(harness.workspaceDir, ref1, "README.md"), "v1\n");
-    }),
-  ),
-);
-
-it.live.skipIf(!process.env.CODEX_BINARY_PATH)(
-  "keeps the same Codex provider thread across runtime mode switches",
-  () =>
-    withRealCodexHarness((harness) =>
-      Effect.gen(function* () {
-        const createdAt = nowIso();
-
-        yield* harness.engine.dispatch({
-          type: "project.create",
-          commandId: CommandId.make("cmd-project-create-real-codex"),
-          projectId: PROJECT_ID,
-          title: "Integration Project",
-          workspaceRoot: harness.workspaceDir,
-          defaultModelSelection: {
-            instanceId: ProviderInstanceId.make("codex"),
-            model: "gpt-5.3-codex",
-          },
-          createdAt,
-        });
-
-        yield* harness.engine.dispatch({
-          type: "thread.create",
-          commandId: CommandId.make("cmd-thread-create-real-codex"),
-          threadId: THREAD_ID,
-          projectId: PROJECT_ID,
-          title: "Integration Thread",
-          modelSelection: {
-            instanceId: ProviderInstanceId.make("codex"),
-            model: "gpt-5.3-codex",
-          },
-          interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-          runtimeMode: "full-access",
-          branch: null,
-          worktreePath: harness.workspaceDir,
-          createdAt,
-        });
-
-        yield* harness.engine.dispatch({
-          type: "thread.turn.start",
-          commandId: CommandId.make("cmd-turn-start-real-codex-1"),
-          threadId: THREAD_ID,
-          message: {
-            messageId: asMessageId("msg-real-codex-1"),
-            role: "user",
-            text: "Reply with exactly ALPHA.",
-            attachments: [],
-          },
-          interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-          runtimeMode: "full-access",
-          createdAt: nowIso(),
-        });
-
-        const firstThread = yield* harness.waitForThread(
-          THREAD_ID,
-          (entry) =>
-            entry.session?.status === "ready" &&
-            entry.session.providerName === "codex" &&
-            entry.messages.some(
-              (message) => message.role === "assistant" && message.streaming === false,
-            ),
-          180_000,
-        );
-        assert.equal(firstThread.session?.threadId, "thread-1");
-
-        yield* harness.engine.dispatch({
-          type: "thread.turn.start",
-          commandId: CommandId.make("cmd-turn-start-real-codex-2"),
-          threadId: THREAD_ID,
-          message: {
-            messageId: asMessageId("msg-real-codex-2"),
-            role: "user",
-            text: "Reply with exactly BETA.",
-            attachments: [],
-          },
-          interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-          runtimeMode: "approval-required",
-          createdAt: nowIso(),
-        });
-
-        const secondThread = yield* harness.waitForThread(
-          THREAD_ID,
-          (entry) =>
-            entry.session?.status === "ready" &&
-            entry.session.providerName === "codex" &&
-            entry.session.runtimeMode === "approval-required" &&
-            entry.messages.some(
-              (message) => message.role === "assistant" && message.text.includes("BETA"),
-            ),
-          180_000,
-        );
-        assert.equal(secondThread.session?.threadId, "thread-1");
-      }),
-    ),
-);
-
-it.live("runs multi-turn file edits and persists checkpoint diffs", () =>
-  withHarness((harness) =>
-    Effect.gen(function* () {
-      yield* seedProjectAndThread(harness);
-
-      yield* harness.adapterHarness!.queueTurnResponseForNextSession({
-        events: [
-          {
-            type: "turn.started",
-            ...runtimeBase("evt-multi-1", "2026-02-24T10:01:00.000Z"),
-            threadId: THREAD_ID,
-            turnId: FIXTURE_TURN_ID,
-          },
-          {
-            type: "tool.started",
-            ...runtimeBase("evt-multi-2", "2026-02-24T10:01:00.100Z"),
-            threadId: THREAD_ID,
-            turnId: FIXTURE_TURN_ID,
-            toolKind: "command",
-            title: "Edit file",
-            detail: "README.md",
-          },
-          {
-            type: "tool.completed",
-            ...runtimeBase("evt-multi-3", "2026-02-24T10:01:00.200Z"),
-            threadId: THREAD_ID,
-            turnId: FIXTURE_TURN_ID,
-            toolKind: "command",
-            title: "Edit file",
-            detail: "README.md",
-          },
-          {
-            type: "message.delta",
-            ...runtimeBase("evt-multi-4", "2026-02-24T10:01:00.300Z"),
-            threadId: THREAD_ID,
-            turnId: FIXTURE_TURN_ID,
-            delta: "Updated README to v2.\n",
-          },
-          {
-            type: "turn.completed",
-            ...runtimeBase("evt-multi-5", "2026-02-24T10:01:00.400Z"),
-            threadId: THREAD_ID,
-            turnId: FIXTURE_TURN_ID,
-            status: "completed",
-          },
-        ],
-        mutateWorkspace: ({ cwd }) =>
-          Effect.sync(() => {
-            NodeFS.writeFileSync(NodePath.join(cwd, "README.md"), "v2\n", "utf8");
-          }),
-      });
-
-      yield* startTurn({
-        harness,
-        commandId: "cmd-turn-start-multi-1",
-        messageId: "msg-user-multi-1",
-        text: "Make first edit",
-      });
-      yield* harness.waitForReceipt(
-        (receipt): receipt is CheckpointDiffFinalizedReceipt =>
-          receipt.type === "checkpoint.diff.finalized" &&
-          receipt.threadId === THREAD_ID &&
-          receipt.checkpointTurnCount === 1,
-      );
-
-      yield* harness.waitForThread(
-        THREAD_ID,
-        (entry) => entry.checkpoints.length === 1 && entry.session?.threadId === "thread-1",
-      );
-
-      yield* harness.adapterHarness!.queueTurnResponse(THREAD_ID, {
-        events: [
-          {
-            type: "turn.started",
-            ...runtimeBase("evt-multi-6", "2026-02-24T10:02:00.000Z"),
-            threadId: THREAD_ID,
-            turnId: FIXTURE_TURN_ID,
-          },
-          {
-            type: "message.delta",
-            ...runtimeBase("evt-multi-7", "2026-02-24T10:02:00.100Z"),
-            threadId: THREAD_ID,
-            turnId: FIXTURE_TURN_ID,
-            delta: "Updated README to v3.\n",
-          },
-          {
-            type: "turn.completed",
-            ...runtimeBase("evt-multi-8", "2026-02-24T10:02:00.200Z"),
-            threadId: THREAD_ID,
-            turnId: FIXTURE_TURN_ID,
-            status: "completed",
-          },
-        ],
-        mutateWorkspace: ({ cwd }) =>
-          Effect.sync(() => {
-            NodeFS.writeFileSync(NodePath.join(cwd, "README.md"), "v3\n", "utf8");
-          }),
-      });
-
-      yield* startTurn({
-        harness,
-        commandId: "cmd-turn-start-multi-2",
-        messageId: "msg-user-multi-2",
-        text: "Make second edit",
-      });
-      const secondReceipt = yield* harness.waitForReceipt(
-        (receipt): receipt is CheckpointDiffFinalizedReceipt =>
-          receipt.type === "checkpoint.diff.finalized" &&
-          receipt.threadId === THREAD_ID &&
-          receipt.checkpointTurnCount === 2,
-      );
-      if (secondReceipt.type !== "checkpoint.diff.finalized") {
-        throw new Error("Expected checkpoint.diff.finalized receipt.");
-      }
-      assert.equal(secondReceipt.status, "ready");
-      yield* harness.waitForReceipt(
-        (receipt): receipt is TurnProcessingQuiescedReceipt =>
-          receipt.type === "turn.processing.quiesced" &&
-          receipt.threadId === THREAD_ID &&
-          receipt.checkpointTurnCount === 2,
-      );
-
-      const secondTurnThread = yield* harness.waitForThread(
-        THREAD_ID,
-        (entry) =>
-          entry.latestTurn?.turnId === "turn-2" &&
-          entry.checkpoints.length === 2 &&
-          entry.checkpoints.some((checkpoint) => checkpoint.checkpointTurnCount === 2),
-      );
-      const secondCheckpoint = secondTurnThread.checkpoints.find(
-        (checkpoint) => checkpoint.checkpointTurnCount === 2,
-      );
-      assert.equal(
-        secondCheckpoint?.files.some((file) => file.path === "README.md"),
-        true,
-      );
-
-      const checkpointRows = yield* harness.checkpointRepository.listByThreadId({
-        threadId: THREAD_ID,
-      });
-      assert.deepEqual(
-        checkpointRows.map((row) => row.checkpointTurnCount),
-        [1, 2],
-      );
-
-      const incrementalDiff = yield* harness.checkpointStore.diffCheckpoints({
-        cwd: harness.workspaceDir,
-        fromCheckpointRef: checkpointRefForThreadTurn(THREAD_ID, 1),
-        toCheckpointRef: checkpointRefForThreadTurn(THREAD_ID, 2),
-        fallbackFromToHead: false,
-        ignoreWhitespace: false,
-      });
-      assert.equal(incrementalDiff.includes("README.md"), true);
-
-      const fullDiff = yield* harness.checkpointStore.diffCheckpoints({
-        cwd: harness.workspaceDir,
-        fromCheckpointRef: checkpointRefForThreadTurn(THREAD_ID, 0),
-        toCheckpointRef: checkpointRefForThreadTurn(THREAD_ID, 2),
-        fallbackFromToHead: false,
-        ignoreWhitespace: false,
-      });
-      assert.equal(fullDiff.includes("README.md"), true);
-
-      assert.equal(
-        gitShowFileAtRef(
-          harness.workspaceDir,
-          checkpointRefForThreadTurn(THREAD_ID, 1),
-          "README.md",
-        ),
-        "v2\n",
-      );
-      assert.equal(
-        gitShowFileAtRef(
-          harness.workspaceDir,
-          checkpointRefForThreadTurn(THREAD_ID, 2),
-          "README.md",
-        ),
-        "v3\n",
-      );
-    }),
-  ),
-);
-
-it.live("tracks approval requests and resolves pending approvals on user response", () =>
-  withHarness((harness) =>
-    Effect.gen(function* () {
-      yield* seedProjectAndThread(harness);
-
-      yield* harness.adapterHarness!.queueTurnResponseForNextSession({
-        events: [
-          {
-            type: "turn.started",
-            ...runtimeBase("evt-approval-1", "2026-02-24T10:03:00.000Z"),
-            threadId: THREAD_ID,
-            turnId: FIXTURE_TURN_ID,
-          },
-          {
-            type: "approval.requested",
-            ...runtimeBase("evt-approval-2", "2026-02-24T10:03:00.100Z"),
-            threadId: THREAD_ID,
-            turnId: FIXTURE_TURN_ID,
-            requestId: APPROVAL_REQUEST_ID,
-            requestKind: "command",
-            detail: "Approve command execution",
-          },
-          {
-            type: "turn.completed",
-            ...runtimeBase("evt-approval-3", "2026-02-24T10:03:00.200Z"),
-            threadId: THREAD_ID,
-            turnId: FIXTURE_TURN_ID,
-            status: "completed",
-          },
-        ],
-      });
-
-      yield* startTurn({
-        harness,
-        commandId: "cmd-turn-start-approval",
-        messageId: "msg-user-approval",
-        text: "Run command needing approval",
-      });
-
-      const thread = yield* harness.waitForThread(THREAD_ID, (entry) =>
-        entry.activities.some((activity) => activity.kind === "approval.requested"),
-      );
-      assert.equal(
-        thread.activities.some((activity) => activity.kind === "approval.requested"),
-        true,
-      );
-
-      const pendingRow = yield* harness.waitForPendingApproval(
-        "req-approval-1",
-        (row) => row.status === "pending" && row.decision === null,
-      );
-      assert.equal(pendingRow.status, "pending");
-
-      yield* harness.engine.dispatch({
-        type: "thread.approval.respond",
-        commandId: CommandId.make("cmd-approval-respond"),
-        threadId: THREAD_ID,
-        requestId: APPROVAL_REQUEST_ID,
-        decision: "accept",
-        createdAt: nowIso(),
-      });
-
-      const resolvedRow = yield* harness.waitForPendingApproval(
-        "req-approval-1",
-        (row) => row.status === "resolved" && row.decision === "accept",
-      );
-      assert.equal(resolvedRow.status, "resolved");
-      assert.equal(resolvedRow.decision, "accept");
-
-      const approvalResponses = yield* waitForSync(
-        () => harness.adapterHarness!.getApprovalResponses(THREAD_ID),
-        (responses) => responses.length === 1,
-        "provider approval response",
-      );
-      assert.equal(approvalResponses.length, 1);
-      assert.equal(approvalResponses[0]?.requestId, "req-approval-1");
-      assert.equal(approvalResponses[0]?.decision, "accept");
-    }),
-  ),
-);
-
-it.live("records failed turn runtime state and checkpoint status as error", () =>
-  withHarness((harness) =>
-    Effect.gen(function* () {
-      yield* seedProjectAndThread(harness);
-
-      yield* harness.adapterHarness!.queueTurnResponseForNextSession({
-        events: [
-          {
-            type: "turn.started",
-            ...runtimeBase("evt-failure-1", "2026-02-24T10:04:00.000Z"),
-            threadId: THREAD_ID,
-            turnId: FIXTURE_TURN_ID,
-          },
-          {
-            type: "content.delta",
-            ...runtimeBase("evt-failure-2", "2026-02-24T10:04:00.100Z"),
-            threadId: THREAD_ID,
-            turnId: FIXTURE_TURN_ID,
-            payload: {
-              streamKind: "assistant_text",
-              delta: "Partial output before failure.\n",
-            },
-          },
-          {
-            type: "runtime.error",
-            ...runtimeBase("evt-failure-3", "2026-02-24T10:04:00.200Z"),
-            threadId: THREAD_ID,
-            turnId: FIXTURE_TURN_ID,
-            payload: {
-              message: "Sandbox command failed.",
-            },
-          },
-          {
-            type: "turn.completed",
-            ...runtimeBase("evt-failure-4", "2026-02-24T10:04:00.300Z"),
-            threadId: THREAD_ID,
-            turnId: FIXTURE_TURN_ID,
-            payload: {
-              state: "failed",
-              errorMessage: "Sandbox command failed.",
-            },
-          },
-        ],
-      });
-
-      yield* startTurn({
-        harness,
-        commandId: "cmd-turn-start-failure",
-        messageId: "msg-user-failure",
-        text: "Run risky command",
-      });
-
-      const thread = yield* harness.waitForThread(
-        THREAD_ID,
-        (entry) =>
-          entry.session?.status === "error" &&
-          entry.session?.lastError === "Sandbox command failed." &&
-          entry.activities.some((activity) => activity.kind === "runtime.error") &&
-          entry.checkpoints.length === 1,
-      );
-      assert.equal(thread.session?.status, "error");
-      assert.equal(thread.checkpoints[0]?.status, "error");
-
-      const checkpointRow = yield* harness.checkpointRepository.getByThreadAndTurnCount({
-        threadId: THREAD_ID,
-        checkpointTurnCount: 1,
-      });
-      assert.equal(Option.isSome(checkpointRow), true);
-      if (Option.isSome(checkpointRow)) {
-        assert.equal(checkpointRow.value.status, "error");
-      }
-      assert.equal(
-        gitRefExists(harness.workspaceDir, checkpointRefForThreadTurn(THREAD_ID, 1)),
-        true,
-      );
-    }),
-  ),
-);
-
-it.live("reverts to an earlier checkpoint and trims checkpoint projections + git refs", () =>
-  withHarness((harness) =>
-    Effect.gen(function* () {
-      yield* seedProjectAndThread(harness);
-
-      yield* harness.adapterHarness!.queueTurnResponseForNextSession({
-        events: [
-          {
-            type: "turn.started",
-            ...runtimeBase("evt-revert-1", "2026-02-24T10:05:00.000Z"),
-            threadId: THREAD_ID,
-            turnId: FIXTURE_TURN_ID,
-          },
-          {
-            type: "tool.started",
-            ...runtimeBase("evt-revert-1-tool-started", "2026-02-24T10:05:00.025Z"),
-            threadId: THREAD_ID,
-            turnId: FIXTURE_TURN_ID,
-            toolKind: "command",
-            title: "Edit file",
-            detail: "README.md",
-          },
-          {
-            type: "tool.completed",
-            ...runtimeBase("evt-revert-1-tool-completed", "2026-02-24T10:05:00.035Z"),
-            threadId: THREAD_ID,
-            turnId: FIXTURE_TURN_ID,
-            toolKind: "command",
-            title: "Edit file",
-            detail: "README.md",
-          },
-          {
-            type: "message.delta",
-            ...runtimeBase("evt-revert-1a", "2026-02-24T10:05:00.050Z"),
-            threadId: THREAD_ID,
-            turnId: FIXTURE_TURN_ID,
-            delta: "Updated README to v2.\n",
-          },
-          {
-            type: "turn.completed",
-            ...runtimeBase("evt-revert-2", "2026-02-24T10:05:00.100Z"),
-            threadId: THREAD_ID,
-            turnId: FIXTURE_TURN_ID,
-            status: "completed",
-          },
-        ],
-        mutateWorkspace: ({ cwd }) =>
-          Effect.sync(() => {
-            NodeFS.writeFileSync(NodePath.join(cwd, "README.md"), "v2\n", "utf8");
-          }),
-      });
-      yield* startTurn({
-        harness,
-        commandId: "cmd-turn-start-revert-1",
-        messageId: "msg-user-revert-1",
-        text: "First edit",
-        createdAt: "2026-02-24T10:04:59.900Z",
-      });
-
-      yield* harness.waitForThread(
-        THREAD_ID,
-        (entry) => entry.session?.threadId === "thread-1" && entry.checkpoints.length === 1,
-      );
-
-      yield* harness.adapterHarness!.queueTurnResponse(THREAD_ID, {
-        events: [
-          {
-            type: "turn.started",
-            ...runtimeBase("evt-revert-3", "2026-02-24T10:05:01.000Z"),
-            threadId: THREAD_ID,
-            turnId: FIXTURE_TURN_ID,
-          },
-          {
-            type: "tool.started",
-            ...runtimeBase("evt-revert-3-tool-started", "2026-02-24T10:05:01.025Z"),
-            threadId: THREAD_ID,
-            turnId: FIXTURE_TURN_ID,
-            toolKind: "command",
-            title: "Edit file",
-            detail: "README.md",
-          },
-          {
-            type: "tool.completed",
-            ...runtimeBase("evt-revert-3-tool-completed", "2026-02-24T10:05:01.035Z"),
-            threadId: THREAD_ID,
-            turnId: FIXTURE_TURN_ID,
-            toolKind: "command",
-            title: "Edit file",
-            detail: "README.md",
-          },
-          {
-            type: "message.delta",
-            ...runtimeBase("evt-revert-3a", "2026-02-24T10:05:01.050Z"),
-            threadId: THREAD_ID,
-            turnId: FIXTURE_TURN_ID,
-            delta: "Updated README to v3.\n",
-          },
-          {
-            type: "turn.completed",
-            ...runtimeBase("evt-revert-4", "2026-02-24T10:05:01.100Z"),
-            threadId: THREAD_ID,
-            turnId: FIXTURE_TURN_ID,
-            status: "completed",
-          },
-        ],
-        mutateWorkspace: ({ cwd }) =>
-          Effect.sync(() => {
-            NodeFS.writeFileSync(NodePath.join(cwd, "README.md"), "v3\n", "utf8");
-          }),
-      });
-      yield* startTurn({
-        harness,
-        commandId: "cmd-turn-start-revert-2",
-        messageId: "msg-user-revert-2",
-        text: "Second edit",
-        createdAt: "2026-02-24T10:05:00.900Z",
-      });
-
-      yield* harness.waitForThread(
-        THREAD_ID,
-        (entry) =>
-          entry.latestTurn?.turnId === "turn-2" &&
-          entry.checkpoints.length === 2 &&
-          entry.activities.some((activity) => activity.turnId === "turn-2"),
-        8000,
-      );
-
-      yield* harness.engine.dispatch({
-        type: "thread.checkpoint.revert",
-        commandId: CommandId.make("cmd-checkpoint-revert"),
-        threadId: THREAD_ID,
-        turnCount: 1,
-        createdAt: nowIso(),
-      });
-
-      yield* harness.waitForDomainEvent((event) => event.type === "thread.reverted");
-      const revertedThread = yield* harness.waitForThread(
-        THREAD_ID,
-        (entry) =>
-          entry.checkpoints.length === 1 && entry.checkpoints[0]?.checkpointTurnCount === 1,
-      );
-      assert.equal(revertedThread.checkpoints[0]?.checkpointTurnCount, 1);
-      assert.deepEqual(
-        revertedThread.messages.map((message) => ({ role: message.role, text: message.text })),
-        [
-          { role: "user", text: "First edit" },
-          { role: "assistant", text: "Updated README to v2.\n" },
-        ],
-      );
-      assert.equal(
-        revertedThread.activities.some((activity) => activity.turnId === "turn-2"),
-        false,
-      );
-      assert.equal(
-        revertedThread.activities.some(
-          (activity) => activity.turnId === "turn-1" && activity.kind === "tool.started",
-        ),
-        true,
-      );
-      assert.equal(
-        revertedThread.activities.some(
-          (activity) => activity.turnId === "turn-1" && activity.kind === "tool.completed",
-        ),
-        true,
-      );
-      assert.equal(
-        NodeFS.readFileSync(NodePath.join(harness.workspaceDir, "README.md"), "utf8"),
-        "v2\n",
-      );
-      assert.equal(
-        gitRefExists(harness.workspaceDir, checkpointRefForThreadTurn(THREAD_ID, 2)),
-        false,
-      );
-      assert.deepEqual(harness.adapterHarness!.getRollbackCalls(THREAD_ID), [1]);
-
-      const checkpointRows = yield* harness.checkpointRepository.listByThreadId({
-        threadId: THREAD_ID,
-      });
-      assert.equal(checkpointRows.length, 1);
-    }),
-  ),
-);
-
-it.live(
-  "appends checkpoint.revert.failed activity when revert is requested without an active session",
-  () =>
-    withHarness((harness) =>
-      Effect.gen(function* () {
-        yield* seedProjectAndThread(harness);
-
-        yield* harness.engine.dispatch({
-          type: "thread.checkpoint.revert",
-          commandId: CommandId.make("cmd-checkpoint-revert-no-session"),
-          threadId: THREAD_ID,
-          turnCount: 0,
-          createdAt: nowIso(),
-        });
-
-        const thread = yield* harness.waitForThread(THREAD_ID, (entry) =>
-          entry.activities.some(
-            (activity) =>
-              activity.kind === "checkpoint.revert.failed" &&
-              typeof activity.payload === "object" &&
-              activity.payload !== null,
-          ),
-        );
-        const failureActivity = thread.activities.find(
-          (activity) => activity.kind === "checkpoint.revert.failed",
-        );
-        assert.equal(failureActivity !== undefined, true);
-        assert.equal(
-          String(
-            (failureActivity?.payload as { readonly detail?: string } | undefined)?.detail,
-          ).includes("No active provider session"),
-          true,
-        );
-      }),
-    ),
-);
-
-it.live("starts a claudeAgent session on first turn when provider is requested", () =>
-  withHarness(
-    (harness) =>
-      Effect.gen(function* () {
-        yield* seedProjectAndThread(harness);
-
-        yield* harness.adapterHarness!.queueTurnResponseForNextSession({
-          events: [
-            {
-              type: "turn.started",
-              ...runtimeBase(
-                "evt-claude-start-1",
-                "2026-02-24T10:10:00.000Z",
-                CLAUDE_AGENT_PROVIDER,
-              ),
-              threadId: THREAD_ID,
-              turnId: FIXTURE_TURN_ID,
-            },
-            {
-              type: "message.delta",
-              ...runtimeBase(
-                "evt-claude-start-2",
-                "2026-02-24T10:10:00.050Z",
-                CLAUDE_AGENT_PROVIDER,
-              ),
-              threadId: THREAD_ID,
-              turnId: FIXTURE_TURN_ID,
-              delta: "Claude first turn.\n",
-            },
-            {
-              type: "turn.completed",
-              ...runtimeBase(
-                "evt-claude-start-3",
-                "2026-02-24T10:10:00.100Z",
-                CLAUDE_AGENT_PROVIDER,
-              ),
-              threadId: THREAD_ID,
-              turnId: FIXTURE_TURN_ID,
-              status: "completed",
-            },
-          ],
-        });
-
-        yield* startTurn({
-          harness,
-          commandId: "cmd-turn-start-claude-initial",
-          messageId: "msg-user-claude-initial",
-          text: "Use Claude",
-          modelSelection: {
-            instanceId: ProviderInstanceId.make("claudeAgent"),
-            model: "claude-sonnet-4-6",
-          },
-        });
-
-        const thread = yield* harness.waitForThread(
-          THREAD_ID,
-          (entry) =>
-            entry.session?.providerName === "claudeAgent" &&
-            entry.session.status === "ready" &&
-            entry.messages.some(
-              (message) => message.role === "assistant" && message.text === "Claude first turn.\n",
-            ),
-        );
-        assert.equal(thread.session?.providerName, "claudeAgent");
-      }),
-    CLAUDE_AGENT_PROVIDER,
-  ),
-);
-
-it.live("recovers claudeAgent sessions after provider stopAll using persisted resume state", () =>
-  withHarness(
-    (harness) =>
-      Effect.gen(function* () {
-        yield* seedProjectAndThread(harness);
-
-        yield* harness.adapterHarness!.queueTurnResponseForNextSession({
-          events: [
-            {
-              type: "turn.started",
-              ...runtimeBase(
-                "evt-claude-recover-1",
-                "2026-02-24T10:11:00.000Z",
-                CLAUDE_AGENT_PROVIDER,
-              ),
-              threadId: THREAD_ID,
-              turnId: FIXTURE_TURN_ID,
-            },
-            {
-              type: "message.delta",
-              ...runtimeBase(
-                "evt-claude-recover-2",
-                "2026-02-24T10:11:00.050Z",
-                CLAUDE_AGENT_PROVIDER,
-              ),
-              threadId: THREAD_ID,
-              turnId: FIXTURE_TURN_ID,
-              delta: "Turn before restart.\n",
-            },
-            {
-              type: "turn.completed",
-              ...runtimeBase(
-                "evt-claude-recover-3",
-                "2026-02-24T10:11:00.100Z",
-                CLAUDE_AGENT_PROVIDER,
-              ),
-              threadId: THREAD_ID,
-              turnId: FIXTURE_TURN_ID,
-              status: "completed",
-            },
-          ],
-        });
-
-        yield* startTurn({
-          harness,
-          commandId: "cmd-turn-start-claude-recover-1",
-          messageId: "msg-user-claude-recover-1",
-          text: "Before restart",
-          modelSelection: {
-            instanceId: ProviderInstanceId.make("claudeAgent"),
-            model: "claude-sonnet-4-6",
-          },
-        });
-
-        yield* harness.waitForThread(
-          THREAD_ID,
-          (entry) =>
-            entry.latestTurn?.turnId === "turn-1" && entry.session?.threadId === "thread-1",
-        );
-
-        yield* harness.adapterHarness!.adapter.stopAll();
-        yield* waitForSync(
-          () => harness.adapterHarness!.listActiveSessionIds(),
-          (sessionIds) => sessionIds.length === 0,
-          "provider stopAll",
-        );
-
-        yield* harness.adapterHarness!.queueTurnResponseForNextSession({
-          events: [
-            {
-              type: "turn.started",
-              ...runtimeBase(
-                "evt-claude-recover-4",
-                "2026-02-24T10:11:01.000Z",
-                CLAUDE_AGENT_PROVIDER,
-              ),
-              threadId: THREAD_ID,
-              turnId: FIXTURE_TURN_ID,
-            },
-            {
-              type: "message.delta",
-              ...runtimeBase(
-                "evt-claude-recover-5",
-                "2026-02-24T10:11:01.050Z",
-                CLAUDE_AGENT_PROVIDER,
-              ),
-              threadId: THREAD_ID,
-              turnId: FIXTURE_TURN_ID,
-              delta: "Turn after restart.\n",
-            },
-            {
-              type: "turn.completed",
-              ...runtimeBase(
-                "evt-claude-recover-6",
-                "2026-02-24T10:11:01.100Z",
-                CLAUDE_AGENT_PROVIDER,
-              ),
-              threadId: THREAD_ID,
-              turnId: FIXTURE_TURN_ID,
-              status: "completed",
-            },
-          ],
-        });
-
-        yield* startTurn({
-          harness,
-          commandId: "cmd-turn-start-claude-recover-2",
-          messageId: "msg-user-claude-recover-2",
-          text: "After restart",
-        });
-        yield* waitForSync(
-          () => harness.adapterHarness!.getStartCount(),
-          (count) => count === 2,
-          "claude provider recovery start",
-        );
-
-        const recoveredThread = yield* harness.waitForThread(
-          THREAD_ID,
-          (entry) =>
-            entry.session?.providerName === "claudeAgent" &&
-            entry.messages.some(
-              (message) => message.role === "user" && message.text === "After restart",
-            ) &&
-            !entry.activities.some((activity) => activity.kind === "provider.turn.start.failed"),
-        );
-        assert.equal(recoveredThread.session?.providerName, "claudeAgent");
-        assert.equal(recoveredThread.session?.threadId, "thread-1");
-      }),
-    CLAUDE_AGENT_PROVIDER,
-  ),
-);
-
-it.live("forwards claudeAgent approval responses to the provider session", () =>
-  withHarness(
-    (harness) =>
-      Effect.gen(function* () {
-        yield* seedProjectAndThread(harness);
-
-        yield* harness.adapterHarness!.queueTurnResponseForNextSession({
-          events: [
-            {
-              type: "turn.started",
-              ...runtimeBase(
-                "evt-claude-approval-1",
-                "2026-02-24T10:12:00.000Z",
-                CLAUDE_AGENT_PROVIDER,
-              ),
-              threadId: THREAD_ID,
-              turnId: FIXTURE_TURN_ID,
-            },
-            {
-              type: "approval.requested",
-              ...runtimeBase(
-                "evt-claude-approval-2",
-                "2026-02-24T10:12:00.050Z",
-                CLAUDE_AGENT_PROVIDER,
-              ),
-              threadId: THREAD_ID,
-              turnId: FIXTURE_TURN_ID,
-              requestId: APPROVAL_REQUEST_ID,
-              requestKind: "command",
-              detail: "Approve Claude tool call",
-            },
-            {
-              type: "turn.completed",
-              ...runtimeBase(
-                "evt-claude-approval-3",
-                "2026-02-24T10:12:00.100Z",
-                CLAUDE_AGENT_PROVIDER,
-              ),
-              threadId: THREAD_ID,
-              turnId: FIXTURE_TURN_ID,
-              status: "completed",
-            },
-          ],
-        });
-
-        yield* startTurn({
-          harness,
-          commandId: "cmd-turn-start-claude-approval",
-          messageId: "msg-user-claude-approval",
-          text: "Need approval",
-          modelSelection: {
-            instanceId: ProviderInstanceId.make("claudeAgent"),
-            model: "claude-sonnet-4-6",
-          },
-        });
-
-        const thread = yield* harness.waitForThread(THREAD_ID, (entry) =>
-          entry.activities.some((activity) => activity.kind === "approval.requested"),
-        );
-        assert.equal(thread.session?.threadId, "thread-1");
-
-        yield* harness.engine.dispatch({
-          type: "thread.approval.respond",
-          commandId: CommandId.make("cmd-claude-approval-respond"),
-          threadId: THREAD_ID,
-          requestId: APPROVAL_REQUEST_ID,
-          decision: "accept",
-          createdAt: nowIso(),
-        });
-
-        yield* harness.waitForPendingApproval(
-          "req-approval-1",
-          (row) => row.status === "resolved" && row.decision === "accept",
-        );
-
-        const approvalResponses = yield* waitForSync(
-          () => harness.adapterHarness!.getApprovalResponses(THREAD_ID),
-          (responses) => responses.length === 1,
-          "claude provider approval response",
-        );
-        assert.equal(approvalResponses[0]?.decision, "accept");
-      }),
-    CLAUDE_AGENT_PROVIDER,
-  ),
-);
-
-it.live("forwards thread.turn.interrupt to claudeAgent provider sessions", () =>
-  withHarness(
-    (harness) =>
-      Effect.gen(function* () {
-        yield* seedProjectAndThread(harness);
-
-        yield* harness.adapterHarness!.queueTurnResponseForNextSession({
-          events: [
-            {
-              type: "turn.started",
-              ...runtimeBase(
-                "evt-claude-interrupt-1",
-                "2026-02-24T10:13:00.000Z",
-                CLAUDE_AGENT_PROVIDER,
-              ),
-              threadId: THREAD_ID,
-              turnId: FIXTURE_TURN_ID,
-            },
-            {
-              type: "message.delta",
-              ...runtimeBase(
-                "evt-claude-interrupt-2",
-                "2026-02-24T10:13:00.050Z",
-                CLAUDE_AGENT_PROVIDER,
-              ),
-              threadId: THREAD_ID,
-              turnId: FIXTURE_TURN_ID,
-              delta: "Long running output.\n",
-            },
-            {
-              type: "turn.completed",
-              ...runtimeBase(
-                "evt-claude-interrupt-3",
-                "2026-02-24T10:13:00.100Z",
-                CLAUDE_AGENT_PROVIDER,
-              ),
-              threadId: THREAD_ID,
-              turnId: FIXTURE_TURN_ID,
-              status: "completed",
-            },
-          ],
-        });
-
-        yield* startTurn({
-          harness,
-          commandId: "cmd-turn-start-claude-interrupt",
-          messageId: "msg-user-claude-interrupt",
-          text: "Start long turn",
-          modelSelection: {
-            instanceId: ProviderInstanceId.make("claudeAgent"),
-            model: "claude-sonnet-4-6",
-          },
-        });
-
-        const thread = yield* harness.waitForThread(
-          THREAD_ID,
-          (entry) => entry.session?.threadId === "thread-1",
-        );
-        assert.equal(thread.session?.threadId, "thread-1");
-
-        yield* harness.engine.dispatch({
-          type: "thread.turn.interrupt",
-          commandId: CommandId.make("cmd-turn-interrupt-claude"),
-          threadId: THREAD_ID,
-          createdAt: nowIso(),
-        });
-        yield* harness.waitForDomainEvent(
-          (event) => event.type === "thread.turn-interrupt-requested",
-        );
-
-        const interruptCalls = yield* waitForSync(
-          () => harness.adapterHarness!.getInterruptCalls(THREAD_ID),
-          (calls) => calls.length === 1,
-          "claude provider interrupt call",
-        );
-        assert.equal(interruptCalls.length, 1);
-      }),
-    CLAUDE_AGENT_PROVIDER,
-  ),
-);
-
-it.live("reverts claudeAgent turns and rolls back provider conversation state", () =>
-  withHarness(
-    (harness) =>
-      Effect.gen(function* () {
-        yield* seedProjectAndThread(harness);
-
-        yield* harness.adapterHarness!.queueTurnResponseForNextSession({
-          events: [
-            {
-              type: "turn.started",
-              ...runtimeBase(
-                "evt-claude-revert-1",
-                "2026-02-24T10:14:00.000Z",
-                CLAUDE_AGENT_PROVIDER,
-              ),
-              threadId: THREAD_ID,
-              turnId: FIXTURE_TURN_ID,
-            },
-            {
-              type: "message.delta",
-              ...runtimeBase(
-                "evt-claude-revert-2",
-                "2026-02-24T10:14:00.050Z",
-                CLAUDE_AGENT_PROVIDER,
-              ),
-              threadId: THREAD_ID,
-              turnId: FIXTURE_TURN_ID,
-              delta: "README -> v2\n",
-            },
-            {
-              type: "turn.completed",
-              ...runtimeBase(
-                "evt-claude-revert-3",
-                "2026-02-24T10:14:00.100Z",
-                CLAUDE_AGENT_PROVIDER,
-              ),
-              threadId: THREAD_ID,
-              turnId: FIXTURE_TURN_ID,
-              status: "completed",
-            },
-          ],
-          mutateWorkspace: ({ cwd }) =>
-            Effect.sync(() => {
-              NodeFS.writeFileSync(NodePath.join(cwd, "README.md"), "v2\n", "utf8");
-            }),
-        });
-
-        yield* startTurn({
-          harness,
-          commandId: "cmd-turn-start-claude-revert-1",
-          messageId: "msg-user-claude-revert-1",
-          text: "First Claude edit",
-          modelSelection: {
-            instanceId: ProviderInstanceId.make("claudeAgent"),
-            model: "claude-sonnet-4-6",
-          },
-        });
-
-        yield* harness.waitForThread(
-          THREAD_ID,
-          (entry) =>
-            entry.latestTurn?.turnId === "turn-1" && entry.session?.threadId === "thread-1",
-        );
-
-        yield* harness.adapterHarness!.queueTurnResponse(THREAD_ID, {
-          events: [
-            {
-              type: "turn.started",
-              ...runtimeBase(
-                "evt-claude-revert-4",
-                "2026-02-24T10:14:01.000Z",
-                CLAUDE_AGENT_PROVIDER,
-              ),
-              threadId: THREAD_ID,
-              turnId: FIXTURE_TURN_ID,
-            },
-            {
-              type: "message.delta",
-              ...runtimeBase(
-                "evt-claude-revert-5",
-                "2026-02-24T10:14:01.050Z",
-                CLAUDE_AGENT_PROVIDER,
-              ),
-              threadId: THREAD_ID,
-              turnId: FIXTURE_TURN_ID,
-              delta: "README -> v3\n",
-            },
-            {
-              type: "turn.completed",
-              ...runtimeBase(
-                "evt-claude-revert-6",
-                "2026-02-24T10:14:01.100Z",
-                CLAUDE_AGENT_PROVIDER,
-              ),
-              threadId: THREAD_ID,
-              turnId: FIXTURE_TURN_ID,
-              status: "completed",
-            },
-          ],
-          mutateWorkspace: ({ cwd }) =>
-            Effect.sync(() => {
-              NodeFS.writeFileSync(NodePath.join(cwd, "README.md"), "v3\n", "utf8");
-            }),
-        });
-
-        yield* startTurn({
-          harness,
-          commandId: "cmd-turn-start-claude-revert-2",
-          messageId: "msg-user-claude-revert-2",
-          text: "Second Claude edit",
-        });
-
-        yield* harness.waitForThread(
-          THREAD_ID,
-          (entry) =>
-            entry.latestTurn?.turnId === "turn-2" &&
-            entry.checkpoints.length === 2 &&
-            entry.session?.providerName === "claudeAgent",
-        );
-
-        yield* harness.engine.dispatch({
-          type: "thread.checkpoint.revert",
-          commandId: CommandId.make("cmd-checkpoint-revert-claude"),
-          threadId: THREAD_ID,
-          turnCount: 1,
-          createdAt: nowIso(),
-        });
-
-        const revertedThread = yield* harness.waitForThread(
-          THREAD_ID,
-          (entry) =>
-            entry.checkpoints.length === 1 && entry.checkpoints[0]?.checkpointTurnCount === 1,
-        );
-        assert.equal(revertedThread.checkpoints[0]?.checkpointTurnCount, 1);
-        assert.equal(
-          gitRefExists(harness.workspaceDir, checkpointRefForThreadTurn(THREAD_ID, 1)),
-          true,
-        );
-        assert.equal(
-          gitRefExists(harness.workspaceDir, checkpointRefForThreadTurn(THREAD_ID, 2)),
-          false,
-        );
-        assert.deepEqual(harness.adapterHarness!.getRollbackCalls(THREAD_ID), [1]);
-      }),
-    CLAUDE_AGENT_PROVIDER,
-  ),
-);
diff --git a/apps/server/integration/orphanedProviderSessionStartup.integration.test.ts b/apps/server/integration/orphanedProviderSessionStartup.integration.test.ts
deleted file mode 100644
index 78a33364f5a3..000000000000
--- a/apps/server/integration/orphanedProviderSessionStartup.integration.test.ts
+++ /dev/null
@@ -1,359 +0,0 @@
-import * as NodeServices from "@effect/platform-node/NodeServices";
-import {
-  CommandId,
-  DEFAULT_PROVIDER_INTERACTION_MODE,
-  EnvironmentId,
-  MessageId,
-  ProjectId,
-  ProviderDriverKind,
-  ProviderInstanceId,
-  ThreadId,
-} from "@t3tools/contracts";
-import { assert, it } from "@effect/vitest";
-import * as DateTime from "effect/DateTime";
-import * as Effect from "effect/Effect";
-import * as Exit from "effect/Exit";
-import * as Layer from "effect/Layer";
-import * as Option from "effect/Option";
-import * as Stream from "effect/Stream";
-import * as SqlClient from "effect/unstable/sql/SqlClient";
-import { HttpServer } from "effect/unstable/http";
-
-import * as EnvironmentAuth from "../src/auth/EnvironmentAuth.ts";
-import * as ServiceLauncherClient from "../src/cloud/serviceLauncherClient.ts";
-import * as ServerConfig from "../src/config.ts";
-import * as ServerEnvironment from "../src/environment/ServerEnvironment.ts";
-import * as Keybindings from "../src/keybindings.ts";
-import { OrchestrationLayerLive } from "../src/orchestration/runtimeLayer.ts";
-import * as OrchestrationEngine from "../src/orchestration/Services/OrchestrationEngine.ts";
-import * as OrchestrationReactor from "../src/orchestration/Services/OrchestrationReactor.ts";
-import * as ProjectionSnapshotQuery from "../src/orchestration/Services/ProjectionSnapshotQuery.ts";
-import { makeSqlitePersistenceLive } from "../src/persistence/Layers/Sqlite.ts";
-import * as ProviderSessionRuntime from "../src/persistence/ProviderSessionRuntime.ts";
-import * as ExternalLauncher from "../src/process/externalLauncher.ts";
-import { ProviderSessionDirectoryLive } from "../src/provider/Layers/ProviderSessionDirectory.ts";
-import * as ProviderService from "../src/provider/Services/ProviderService.ts";
-import * as ProviderSessionDirectory from "../src/provider/Services/ProviderSessionDirectory.ts";
-import * as ProviderSessionReaper from "../src/provider/Services/ProviderSessionReaper.ts";
-import * as RepositoryIdentityResolver from "../src/project/RepositoryIdentityResolver.ts";
-import * as ServerLifecycleEvents from "../src/serverLifecycleEvents.ts";
-import * as ServerRuntimeStartup from "../src/serverRuntimeStartup.ts";
-import * as ServerSettings from "../src/serverSettings.ts";
-import * as AnalyticsService from "../src/telemetry/AnalyticsService.ts";
-
-const providerInstanceId = ProviderInstanceId.make("codex");
-const projectId = ProjectId.make("project-startup-orphan");
-const threadId = ThreadId.make("thread-startup-orphan");
-const stoppedBindingThreadId = ThreadId.make("thread-startup-orphan-stopped-binding");
-const resumeCursor = { schemaVersion: 1, sessionId: "provider-session-before-restart" };
-const stoppedBindingResumeCursor = {
-  schemaVersion: 1,
-  sessionId: "provider-session-stopped-before-restart",
-};
-
-const makePersistedRuntimeLayer = (dbPath: string) => {
-  const persistence = makeSqlitePersistenceLive(dbPath);
-  const orchestration = OrchestrationLayerLive.pipe(
-    Layer.provideMerge(RepositoryIdentityResolver.layer),
-    Layer.provideMerge(persistence),
-  );
-  const directory = ProviderSessionDirectoryLive.pipe(
-    Layer.provide(ProviderSessionRuntime.layer),
-    Layer.provide(persistence),
-  );
-  return Layer.mergeAll(orchestration, directory);
-};
-
-const startupDependencies = Layer.mergeAll(
-  Layer.mock(Keybindings.Keybindings)({
-    start: Effect.void,
-  }),
-  ServerSettings.layerTest(),
-  Layer.succeed(OrchestrationReactor.OrchestrationReactor, {
-    start: () => Effect.void,
-  }),
-  Layer.succeed(ProviderSessionReaper.ProviderSessionReaper, {
-    start: () => Effect.void,
-  }),
-  ServerLifecycleEvents.layer,
-  Layer.succeed(ServerEnvironment.ServerEnvironment, {
-    getEnvironmentId: Effect.succeed(EnvironmentId.make("environment-startup-orphan")),
-    getDescriptor: Effect.succeed({
-      environmentId: EnvironmentId.make("environment-startup-orphan"),
-      label: "Startup orphan test",
-      version: "test",
-      platform: { os: "linux", arch: "x64" },
-      capabilities: {},
-    } as never),
-  }),
-  Layer.mock(EnvironmentAuth.EnvironmentAuth)({
-    issueStartupPairingUrl: (baseUrl: string) => Effect.succeed(`${baseUrl}/pair`),
-  }),
-  Layer.mock(ExternalLauncher.ExternalLauncher)({
-    launchBrowser: () => Effect.void,
-  }),
-  Layer.succeed(ServiceLauncherClient.ServiceLauncherClient, {
-    managed: false,
-    requestUpdate: () => Effect.die("unused"),
-    prepareTrial: Effect.sync(() => undefined),
-  }),
-  Layer.succeed(
-    HttpServer.HttpServer,
-    HttpServer.HttpServer.of({
-      address: { _tag: "TcpAddress", hostname: "127.0.0.1", port: 3773 },
-      serve: (() => Effect.void) as HttpServer.HttpServer["Service"]["serve"],
-    }),
-  ),
-  AnalyticsService.layerTest,
-  Layer.succeed(ProviderService.ProviderService, {
-    startSession: () => Effect.die("unused"),
-    sendTurn: () => Effect.die("unused"),
-    interruptTurn: () => Effect.die("unused"),
-    respondToRequest: () => Effect.die("unused"),
-    respondToUserInput: () => Effect.die("unused"),
-    stopSession: () => Effect.die("unused"),
-    listSessions: () => Effect.succeed([]),
-    getCapabilities: () => Effect.die("unused"),
-    getInstanceInfo: () => Effect.die("unused"),
-    rollbackConversation: () => Effect.die("unused"),
-    uploadFeedback: () => Effect.die("unused"),
-    streamEvents: Stream.empty,
-  }),
-);
-
-it.effect(
-  "recovers a persisted starting session before opening the command gate after restart",
-  () =>
-    Effect.gen(function* () {
-      const config = yield* ServerConfig.ServerConfig;
-      const firstRuntime = makePersistedRuntimeLayer(config.dbPath);
-      const now = yield* DateTime.now;
-      const createdAt = DateTime.formatIso(now);
-
-      yield* Effect.gen(function* () {
-        const engine = yield* OrchestrationEngine.OrchestrationEngineService;
-        const directory = yield* ProviderSessionDirectory.ProviderSessionDirectory;
-
-        yield* engine.dispatch({
-          type: "project.create",
-          commandId: CommandId.make("command-create-project"),
-          projectId,
-          title: "Startup orphan project",
-          workspaceRoot: "/tmp/startup-orphan-project",
-          defaultModelSelection: { instanceId: providerInstanceId, model: "gpt-5" },
-          createdAt,
-        });
-        yield* engine.dispatch({
-          type: "thread.create",
-          commandId: CommandId.make("command-create-thread"),
-          threadId,
-          projectId,
-          title: "Startup orphan thread",
-          modelSelection: { instanceId: providerInstanceId, model: "gpt-5" },
-          interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-          runtimeMode: "full-access",
-          branch: null,
-          worktreePath: null,
-          createdAt,
-        });
-        yield* engine.dispatch({
-          type: "thread.turn.start",
-          commandId: CommandId.make("command-start-pending-turn"),
-          threadId,
-          message: {
-            messageId: MessageId.make("message-pending-before-restart"),
-            role: "user",
-            text: "Persist this queued turn before restart",
-            attachments: [],
-          },
-          interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-          runtimeMode: "full-access",
-          createdAt,
-        });
-        yield* engine.dispatch({
-          type: "thread.session.set",
-          commandId: CommandId.make("command-mark-session-starting"),
-          threadId,
-          session: {
-            threadId,
-            status: "starting",
-            providerName: "codex",
-            providerInstanceId,
-            runtimeMode: "full-access",
-            activeTurnId: null,
-            lastError: null,
-            updatedAt: createdAt,
-          },
-          createdAt,
-        });
-        yield* directory.upsert({
-          threadId,
-          provider: ProviderDriverKind.make("codex"),
-          providerInstanceId,
-          status: "running",
-          resumeCursor,
-          runtimePayload: { activeTurnId: null, unrelated: "preserve-me" },
-          runtimeMode: "full-access",
-        });
-        yield* engine.dispatch({
-          type: "thread.create",
-          commandId: CommandId.make("command-create-stopped-binding-thread"),
-          threadId: stoppedBindingThreadId,
-          projectId,
-          title: "Startup orphan with stopped binding",
-          modelSelection: { instanceId: providerInstanceId, model: "gpt-5" },
-          interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-          runtimeMode: "full-access",
-          branch: null,
-          worktreePath: null,
-          createdAt,
-        });
-        yield* engine.dispatch({
-          type: "thread.turn.start",
-          commandId: CommandId.make("command-start-stopped-binding-pending-turn"),
-          threadId: stoppedBindingThreadId,
-          message: {
-            messageId: MessageId.make("message-stopped-binding-pending-before-restart"),
-            role: "user",
-            text: "Persist another queued turn before restart",
-            attachments: [],
-          },
-          interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-          runtimeMode: "full-access",
-          createdAt,
-        });
-        yield* engine.dispatch({
-          type: "thread.session.set",
-          commandId: CommandId.make("command-mark-stopped-binding-session-starting"),
-          threadId: stoppedBindingThreadId,
-          session: {
-            threadId: stoppedBindingThreadId,
-            status: "starting",
-            providerName: "codex",
-            providerInstanceId,
-            runtimeMode: "full-access",
-            activeTurnId: null,
-            lastError: null,
-            updatedAt: createdAt,
-          },
-          createdAt,
-        });
-        yield* directory.upsert({
-          threadId: stoppedBindingThreadId,
-          provider: ProviderDriverKind.make("codex"),
-          providerInstanceId,
-          status: "stopped",
-          resumeCursor: stoppedBindingResumeCursor,
-          runtimePayload: { activeTurnId: "stale", unrelated: "also-preserve-me" },
-          runtimeMode: "full-access",
-        });
-      }).pipe(Effect.provide(firstRuntime));
-
-      const secondRuntime = makePersistedRuntimeLayer(config.dbPath);
-      const startupLayer = ServerRuntimeStartup.layer.pipe(
-        Layer.provideMerge(secondRuntime),
-        Layer.provideMerge(startupDependencies),
-      );
-
-      const result = yield* Effect.gen(function* () {
-        const startup = yield* ServerRuntimeStartup.ServerRuntimeStartup;
-        const engine = yield* OrchestrationEngine.OrchestrationEngineService;
-        const query = yield* ProjectionSnapshotQuery.ProjectionSnapshotQuery;
-        const directory = yield* ProviderSessionDirectory.ProviderSessionDirectory;
-        const sql = yield* SqlClient.SqlClient;
-
-        yield* startup.markHttpListening;
-        yield* startup.awaitCommandReady;
-
-        const restartedThread = Option.getOrThrow(yield* query.getThreadDetailById(threadId));
-        const restartedStoppedBindingThread = Option.getOrThrow(
-          yield* query.getThreadDetailById(stoppedBindingThreadId),
-        );
-        const pendingRows = yield* sql<{ readonly threadId: string }>`
-          SELECT thread_id AS "threadId"
-          FROM projection_turns
-          WHERE thread_id IN (${threadId}, ${stoppedBindingThreadId})
-            AND turn_id IS NULL
-            AND state = 'pending'
-        `;
-        const settleExit = yield* Effect.exit(
-          engine.dispatch({
-            type: "thread.settle",
-            commandId: CommandId.make("command-settle-after-restart"),
-            threadId,
-          }),
-        );
-        const snoozeExit = yield* Effect.exit(
-          engine.dispatch({
-            type: "thread.snooze",
-            commandId: CommandId.make("command-snooze-after-restart"),
-            threadId,
-            snoozedUntil: DateTime.formatIso(DateTime.add(now, { hours: 1 })),
-          }),
-        );
-        const newTurnExit = yield* Effect.exit(
-          engine.dispatch({
-            type: "thread.turn.start",
-            commandId: CommandId.make("command-new-turn-after-restart"),
-            threadId,
-            message: {
-              messageId: MessageId.make("message-new-turn-after-restart"),
-              role: "user",
-              text: "Continue immediately after restart",
-              attachments: [],
-            },
-            interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-            runtimeMode: "full-access",
-            createdAt,
-          }),
-        );
-        const binding = Option.getOrThrow(yield* directory.getBinding(threadId));
-        const stoppedBinding = Option.getOrThrow(
-          yield* directory.getBinding(stoppedBindingThreadId),
-        );
-
-        return {
-          sessionStatus: restartedThread.session?.status,
-          activeTurnId: restartedThread.session?.activeTurnId,
-          latestTurn: restartedThread.latestTurn,
-          pendingTurnCount: pendingRows.length,
-          settleSucceeded: Exit.isSuccess(settleExit),
-          snoozeSucceeded: Exit.isSuccess(snoozeExit),
-          newTurnSucceeded: Exit.isSuccess(newTurnExit),
-          bindingStatus: binding.status,
-          resumeCursor: binding.resumeCursor,
-          runtimePayload: binding.runtimePayload,
-          stoppedBindingSessionStatus: restartedStoppedBindingThread.session?.status,
-          stoppedBindingStatus: stoppedBinding.status,
-          stoppedBindingResumeCursor: stoppedBinding.resumeCursor,
-          stoppedBindingRuntimePayload: stoppedBinding.runtimePayload,
-        };
-      }).pipe(Effect.provide(startupLayer));
-
-      assert.deepStrictEqual(result, {
-        sessionStatus: "error",
-        activeTurnId: null,
-        latestTurn: null,
-        pendingTurnCount: 0,
-        settleSucceeded: true,
-        snoozeSucceeded: true,
-        newTurnSucceeded: true,
-        bindingStatus: "stopped",
-        resumeCursor,
-        runtimePayload: { activeTurnId: null, unrelated: "preserve-me" },
-        stoppedBindingSessionStatus: "error",
-        stoppedBindingStatus: "stopped",
-        stoppedBindingResumeCursor,
-        stoppedBindingRuntimePayload: {
-          activeTurnId: null,
-          unrelated: "also-preserve-me",
-        },
-      });
-    }).pipe(
-      Effect.provide(
-        ServerConfig.layerTest(process.cwd(), {
-          prefix: "t3-orphaned-provider-session-startup-",
-        }).pipe(Layer.provideMerge(NodeServices.layer)),
-      ),
-    ),
-);
diff --git a/apps/server/integration/providerService.integration.test.ts b/apps/server/integration/providerService.integration.test.ts
deleted file mode 100644
index 6089d22d9aa3..000000000000
--- a/apps/server/integration/providerService.integration.test.ts
+++ /dev/null
@@ -1,386 +0,0 @@
-import type { ProviderRuntimeEvent } from "@t3tools/contracts";
-import { ProviderDriverKind, ProviderInstanceId, ThreadId } from "@t3tools/contracts";
-import { DEFAULT_SERVER_SETTINGS } from "@t3tools/contracts/settings";
-import * as NodeServices from "@effect/platform-node/NodeServices";
-import { it, assert } from "@effect/vitest";
-import * as Effect from "effect/Effect";
-import * as FileSystem from "effect/FileSystem";
-import * as Layer from "effect/Layer";
-import * as Path from "effect/Path";
-import * as Queue from "effect/Queue";
-import * as Ref from "effect/Ref";
-import * as Stream from "effect/Stream";
-
-import { ProviderAdapterRegistry } from "../src/provider/Services/ProviderAdapterRegistry.ts";
-import { makeAdapterRegistryMock } from "../src/provider/testUtils/providerAdapterRegistryMock.ts";
-import { ProviderSessionDirectoryLive } from "../src/provider/Layers/ProviderSessionDirectory.ts";
-import {
-  NoOpProviderEventLoggers,
-  ProviderEventLoggers,
-} from "../src/provider/Layers/ProviderEventLoggers.ts";
-import { makeProviderServiceLive } from "../src/provider/Layers/ProviderService.ts";
-import {
-  ProviderService,
-  type ProviderServiceShape,
-} from "../src/provider/Services/ProviderService.ts";
-import * as ServerConfig from "../src/config.ts";
-import { ServerSettingsService } from "../src/serverSettings.ts";
-import { AnalyticsService } from "../src/telemetry/Services/AnalyticsService.ts";
-import { SqlitePersistenceMemory } from "../src/persistence/Layers/Sqlite.ts";
-import * as ProviderSessionRuntime from "../src/persistence/ProviderSessionRuntime.ts";
-
-import {
-  makeTestProviderAdapterHarness,
-  type TestProviderAdapterHarness,
-  type TestTurnResponse,
-} from "./TestProviderAdapter.integration.ts";
-import {
-  codexTurnApprovalFixture,
-  codexTurnToolFixture,
-  codexTurnTextFixture,
-} from "./fixtures/providerRuntime.ts";
-
-const codexInstanceId = ProviderInstanceId.make("codex");
-
-const makeWorkspaceDirectory = Effect.gen(function* () {
-  const fs = yield* FileSystem.FileSystem;
-  const pathService = yield* Path.Path;
-  const cwd = yield* fs.makeTempDirectory();
-  yield* fs.writeFileString(pathService.join(cwd, "README.md"), "v1\n");
-  return cwd;
-}).pipe(Effect.provide(NodeServices.layer));
-
-interface IntegrationFixture {
-  readonly cwd: string;
-  readonly harness: TestProviderAdapterHarness;
-  readonly layer: Layer.Layer<ProviderService, unknown, never>;
-}
-
-interface RecordedAnalyticsEvent {
-  readonly event: string;
-  readonly properties: Readonly<Record<string, unknown>> | undefined;
-}
-
-/**
- * Analytics layer that keeps captured events in memory so tests can assert on
- * telemetry payloads. `AnalyticsService.layerTest` discards them.
- */
-const makeRecordingAnalytics = Effect.gen(function* () {
-  const recorded = yield* Ref.make<ReadonlyArray<RecordedAnalyticsEvent>>([]);
-  const layer = Layer.succeed(
-    AnalyticsService,
-    AnalyticsService.of({
-      record: (event, properties) =>
-        Ref.update(recorded, (current) => [...current, { event, properties }]),
-      flush: Effect.void,
-    }),
-  );
-  return { layer, get: Ref.get(recorded) } as const;
-});
-
-const makeIntegrationFixture = (options?: { readonly analytics?: Layer.Layer<AnalyticsService> }) =>
-  Effect.gen(function* () {
-    const cwd = yield* makeWorkspaceDirectory;
-    const harness = yield* makeTestProviderAdapterHarness();
-
-    const registry = makeAdapterRegistryMock({
-      [ProviderDriverKind.make("codex")]: harness.adapter,
-    });
-
-    const directoryLayer = ProviderSessionDirectoryLive.pipe(
-      Layer.provide(ProviderSessionRuntime.layer),
-    );
-
-    const shared = Layer.mergeAll(
-      directoryLayer,
-      Layer.succeed(ProviderAdapterRegistry, registry),
-      ServerConfig.layerTest(cwd, cwd).pipe(Layer.provide(NodeServices.layer)),
-      ServerSettingsService.layerTest(DEFAULT_SERVER_SETTINGS),
-      options?.analytics ?? AnalyticsService.layerTest,
-      Layer.succeed(ProviderEventLoggers, NoOpProviderEventLoggers),
-    ).pipe(Layer.provide(SqlitePersistenceMemory));
-
-    const layer = makeProviderServiceLive().pipe(Layer.provide(shared));
-
-    return {
-      cwd,
-      harness,
-      layer,
-    } satisfies IntegrationFixture;
-  });
-
-const collectEventsDuring = <A, E, R>(
-  stream: Stream.Stream<ProviderRuntimeEvent>,
-  count: number,
-  action: Effect.Effect<A, E, R>,
-) =>
-  Effect.gen(function* () {
-    const queue = yield* Queue.unbounded<ProviderRuntimeEvent>();
-    yield* Stream.runForEach(stream, (event) => Queue.offer(queue, event).pipe(Effect.asVoid)).pipe(
-      Effect.forkScoped,
-    );
-
-    yield* Effect.sleep("50 millis");
-    yield* action;
-
-    return yield* Effect.forEach(
-      Array.from({ length: count }, () => undefined),
-      () => Queue.take(queue),
-      { discard: false },
-    );
-  });
-
-const runTurn = (input: {
-  readonly provider: ProviderServiceShape;
-  readonly harness: TestProviderAdapterHarness;
-  readonly threadId: ThreadId;
-  readonly userText: string;
-  readonly response: TestTurnResponse;
-}) =>
-  Effect.gen(function* () {
-    yield* input.harness.queueTurnResponse(input.threadId, input.response);
-    return yield* collectEventsDuring(
-      input.provider.streamEvents,
-      input.response.events.length,
-      input.provider.sendTurn({
-        threadId: input.threadId,
-        input: input.userText,
-        attachments: [],
-      }),
-    );
-  });
-
-it.live("replays typed runtime fixture events", () =>
-  Effect.gen(function* () {
-    const fixture = yield* makeIntegrationFixture();
-
-    yield* Effect.gen(function* () {
-      const provider = yield* ProviderService;
-      const session = yield* provider.startSession(ThreadId.make("thread-integration-typed"), {
-        threadId: ThreadId.make("thread-integration-typed"),
-        provider: ProviderDriverKind.make("codex"),
-        providerInstanceId: codexInstanceId,
-        cwd: fixture.cwd,
-        runtimeMode: "full-access",
-      });
-      assert.equal((session.threadId ?? "").length > 0, true);
-
-      const observedEvents = yield* runTurn({
-        provider,
-        harness: fixture.harness,
-        threadId: session.threadId,
-        userText: "hello",
-        response: { events: codexTurnTextFixture },
-      });
-
-      assert.deepEqual(
-        observedEvents.map((event) => event.type),
-        codexTurnTextFixture.map((event) => event.type),
-      );
-      assert.deepEqual(
-        observedEvents.map((event) => event.providerInstanceId),
-        codexTurnTextFixture.map(() => codexInstanceId),
-      );
-    }).pipe(Effect.provide(fixture.layer));
-  }).pipe(Effect.provide(NodeServices.layer)),
-);
-
-it.live("replays file-changing fixture turn events", () =>
-  Effect.gen(function* () {
-    const fixture = yield* makeIntegrationFixture();
-    const { join } = yield* Path.Path;
-    const { writeFileString } = yield* FileSystem.FileSystem;
-
-    yield* Effect.gen(function* () {
-      const provider = yield* ProviderService;
-      const session = yield* provider.startSession(ThreadId.make("thread-integration-tools"), {
-        threadId: ThreadId.make("thread-integration-tools"),
-        provider: ProviderDriverKind.make("codex"),
-        providerInstanceId: codexInstanceId,
-        cwd: fixture.cwd,
-        runtimeMode: "full-access",
-      });
-      assert.equal((session.threadId ?? "").length > 0, true);
-
-      const observedEvents = yield* runTurn({
-        provider,
-        harness: fixture.harness,
-        threadId: session.threadId,
-        userText: "make a small change",
-        response: {
-          events: codexTurnToolFixture,
-          mutateWorkspace: ({ cwd }) =>
-            writeFileString(join(cwd, "README.md"), "v2\n").pipe(Effect.asVoid, Effect.ignore),
-        },
-      });
-
-      assert.deepEqual(
-        observedEvents.map((event) => event.type),
-        codexTurnToolFixture.map((event) => event.type),
-      );
-    }).pipe(Effect.provide(fixture.layer));
-  }).pipe(Effect.provide(NodeServices.layer)),
-);
-
-it.live("runs multi-turn tool/approval flow", () =>
-  Effect.gen(function* () {
-    const fixture = yield* makeIntegrationFixture();
-    const { join } = yield* Path.Path;
-    const { writeFileString } = yield* FileSystem.FileSystem;
-
-    yield* Effect.gen(function* () {
-      const provider = yield* ProviderService;
-      const session = yield* provider.startSession(ThreadId.make("thread-integration-multi"), {
-        threadId: ThreadId.make("thread-integration-multi"),
-        provider: ProviderDriverKind.make("codex"),
-        providerInstanceId: codexInstanceId,
-        cwd: fixture.cwd,
-        runtimeMode: "full-access",
-      });
-      assert.equal((session.threadId ?? "").length > 0, true);
-
-      const firstTurnEvents = yield* runTurn({
-        provider,
-        harness: fixture.harness,
-        threadId: session.threadId,
-        userText: "turn 1",
-        response: {
-          events: codexTurnToolFixture,
-          mutateWorkspace: ({ cwd }) =>
-            writeFileString(join(cwd, "README.md"), "v2\n").pipe(Effect.asVoid, Effect.ignore),
-        },
-      });
-      assert.deepEqual(
-        firstTurnEvents.map((event) => event.type),
-        codexTurnToolFixture.map((event) => event.type),
-      );
-
-      const secondTurnEvents = yield* runTurn({
-        provider,
-        harness: fixture.harness,
-        threadId: session.threadId,
-        userText: "turn 2 approval",
-        response: {
-          events: codexTurnApprovalFixture,
-          mutateWorkspace: ({ cwd }) =>
-            writeFileString(join(cwd, "README.md"), "v3\n").pipe(Effect.asVoid, Effect.ignore),
-        },
-      });
-      assert.deepEqual(
-        secondTurnEvents.map((event) => event.type),
-        codexTurnApprovalFixture.map((event) => event.type),
-      );
-    }).pipe(Effect.provide(fixture.layer));
-  }).pipe(Effect.provide(NodeServices.layer)),
-);
-
-it.live("rolls back provider conversation state only", () =>
-  Effect.gen(function* () {
-    const fixture = yield* makeIntegrationFixture();
-    const { join } = yield* Path.Path;
-    const { writeFileString, readFileString } = yield* FileSystem.FileSystem;
-
-    yield* Effect.gen(function* () {
-      const provider = yield* ProviderService;
-      const session = yield* provider.startSession(ThreadId.make("thread-integration-rollback"), {
-        threadId: ThreadId.make("thread-integration-rollback"),
-        provider: ProviderDriverKind.make("codex"),
-        providerInstanceId: codexInstanceId,
-        cwd: fixture.cwd,
-        runtimeMode: "full-access",
-      });
-      assert.equal((session.threadId ?? "").length > 0, true);
-
-      yield* runTurn({
-        provider,
-        harness: fixture.harness,
-        threadId: session.threadId,
-        userText: "turn 1",
-        response: {
-          events: codexTurnToolFixture,
-          mutateWorkspace: ({ cwd }) =>
-            writeFileString(join(cwd, "README.md"), "v2\n").pipe(Effect.asVoid, Effect.ignore),
-        },
-      });
-
-      yield* runTurn({
-        provider,
-        harness: fixture.harness,
-        threadId: session.threadId,
-        userText: "turn 2 approval",
-        response: {
-          events: codexTurnApprovalFixture,
-          mutateWorkspace: ({ cwd }) =>
-            writeFileString(join(cwd, "README.md"), "v3\n").pipe(Effect.asVoid, Effect.ignore),
-        },
-      });
-
-      yield* provider.rollbackConversation({
-        threadId: session.threadId,
-        numTurns: 1,
-      });
-
-      const rollbackCalls = fixture.harness.getRollbackCalls(session.threadId);
-      assert.deepEqual(rollbackCalls, [1]);
-
-      const readme = yield* readFileString(join(fixture.cwd, "README.md"));
-      assert.equal(readme, "v3\n");
-    }).pipe(Effect.provide(fixture.layer));
-  }).pipe(Effect.provide(NodeServices.layer)),
-);
-
-it.live("reports runtime mode per turn and on mode transitions", () =>
-  Effect.gen(function* () {
-    const analytics = yield* makeRecordingAnalytics;
-    const fixture = yield* makeIntegrationFixture({ analytics: analytics.layer });
-    const threadId = ThreadId.make("thread-integration-runtime-mode");
-
-    yield* Effect.gen(function* () {
-      const provider = yield* ProviderService;
-      const startSession = (runtimeMode: "approval-required" | "full-access") =>
-        provider.startSession(threadId, {
-          threadId,
-          provider: ProviderDriverKind.make("codex"),
-          providerInstanceId: codexInstanceId,
-          cwd: fixture.cwd,
-          runtimeMode,
-        });
-
-      yield* startSession("approval-required");
-      yield* runTurn({
-        provider,
-        harness: fixture.harness,
-        threadId,
-        userText: "supervised turn",
-        response: { events: codexTurnTextFixture },
-      });
-
-      // Toggling the mode restarts the session, which is the only place the
-      // transition is observable.
-      yield* startSession("full-access");
-      yield* runTurn({
-        provider,
-        harness: fixture.harness,
-        threadId,
-        userText: "full access turn",
-        response: { events: codexTurnTextFixture },
-      });
-
-      const recorded = yield* analytics.get;
-
-      assert.deepEqual(
-        recorded
-          .filter((entry) => entry.event === "provider.turn.sent")
-          .map((entry) => entry.properties?.runtimeMode),
-        ["approval-required", "full-access"],
-      );
-
-      assert.deepEqual(
-        recorded
-          .filter((entry) => entry.event === "provider.runtime_mode.changed")
-          .map((entry) => [entry.properties?.from, entry.properties?.to]),
-        [["approval-required", "full-access"]],
-      );
-    }).pipe(Effect.provide(fixture.layer));
-  }).pipe(Effect.provide(NodeServices.layer)),
-);
diff --git a/apps/server/package.json b/apps/server/package.json
index fb50816ee198..9a1fb58a43d7 100644
--- a/apps/server/package.json
+++ b/apps/server/package.json
@@ -16,13 +16,19 @@
   "type": "module",
   "scripts": {
     "dev": "node --watch src/bin.ts",
+    "record:codex-replay": "bun scripts/record-codex-app-server-replay-fixture.ts",
+    "record:claude-replay": "bun scripts/record-claude-agent-sdk-replay-fixture.ts",
+    "record:cursor-replay": "node --env-file-if-exists=../../.env --experimental-strip-types scripts/record-cursor-agent-sdk-replay-fixture.ts",
     "build:bundle": "vp pack && vp pack src/service-launcher.ts --out-dir dist --no-clean",
     "start": "node dist/bin.mjs",
     "typecheck": "tsgo --noEmit",
     "test": "vp test run"
   },
   "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "^0.3.170",
+    "@anthropic-ai/claude-agent-sdk": "^0.3.205",
+    "@connectrpc/connect": "1.7.0",
+    "@connectrpc/connect-node": "1.7.0",
+    "@cursor/sdk": "1.0.22",
     "@effect/platform-bun": "catalog:",
     "@effect/platform-node": "catalog:",
     "@effect/platform-node-shared": "catalog:",
diff --git a/apps/server/scripts/acp-mock-agent.ts b/apps/server/scripts/acp-mock-agent.ts
index e51a8883f4f9..82bc48ce3754 100644
--- a/apps/server/scripts/acp-mock-agent.ts
+++ b/apps/server/scripts/acp-mock-agent.ts
@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 // @effect-diagnostics nodeBuiltinImport:off
+import * as NodeChildProcess from "node:child_process";
 import * as NodeFS from "node:fs";
 
 import * as Effect from "effect/Effect";
@@ -11,13 +12,21 @@ import * as EffectAcpAgent from "effect-acp/agent";
 import * as AcpError from "effect-acp/errors";
 import type * as AcpSchema from "effect-acp/schema";
 
+import { beginAcpMockPrompt } from "./acpMockCancellationState.ts";
+
 const requestLogPath = process.env.T3_ACP_REQUEST_LOG_PATH;
 const exitLogPath = process.env.T3_ACP_EXIT_LOG_PATH;
 const emitToolCalls = process.env.T3_ACP_EMIT_TOOL_CALLS === "1";
 const emitInterleavedAssistantToolCalls =
   process.env.T3_ACP_EMIT_INTERLEAVED_ASSISTANT_TOOL_CALLS === "1";
 const emitGenericToolPlaceholders = process.env.T3_ACP_EMIT_GENERIC_TOOL_PLACEHOLDERS === "1";
+const emitPostSettleMonitorFlow = process.env.T3_ACP_EMIT_POST_SETTLE_MONITOR_FLOW === "1";
+const emitInTurnTaskOutputThenLateDuplicate =
+  process.env.T3_ACP_EMIT_IN_TURN_TASKOUTPUT_THEN_LATE_DUPLICATE === "1";
+const injectedReportTriggerPath = process.env.T3_ACP_INJECTED_REPORT_TRIGGER_PATH;
 const emitAskQuestion = process.env.T3_ACP_EMIT_ASK_QUESTION === "1";
+const emitElicitation = process.env.T3_ACP_EMIT_ELICITATION === "1";
+const emitUrlElicitation = process.env.T3_ACP_EMIT_URL_ELICITATION === "1";
 const emitXAiAskUserQuestion = process.env.T3_ACP_EMIT_XAI_ASK_USER_QUESTION === "1";
 const emitXAiExitPlanMode = process.env.T3_ACP_EMIT_XAI_EXIT_PLAN_MODE === "1";
 const emitXAiPlanMdWrite = process.env.T3_ACP_EMIT_XAI_PLAN_MD_WRITE === "1";
@@ -30,8 +39,25 @@ const emitPlanThenHang = process.env.T3_ACP_EMIT_PLAN_THEN_HANG === "1";
 const emitActiveToolThenHang = process.env.T3_ACP_EMIT_ACTIVE_TOOL_THEN_HANG === "1";
 const emitForeignSessionUpdates = process.env.T3_ACP_EMIT_FOREIGN_SESSION_UPDATES === "1";
 const hangPromptForever = process.env.T3_ACP_HANG_PROMPT_FOREVER === "1";
+const hangAfterPermission = process.env.T3_ACP_HANG_AFTER_PERMISSION === "1";
 const hangFirstPromptForever = process.env.T3_ACP_HANG_FIRST_PROMPT_FOREVER === "1";
 const emitLateUpdateAfterCancel = process.env.T3_ACP_EMIT_LATE_UPDATE_AFTER_CANCEL === "1";
+const emitTaskBackgroundedAfterCancel =
+  process.env.T3_ACP_EMIT_TASK_BACKGROUNDED_AFTER_CANCEL === "1";
+const residualCallbackResponseLogPath = process.env.T3_ACP_RESIDUAL_CALLBACK_RESPONSE_LOG_PATH;
+const residualCallbackTriggerPath = process.env.T3_ACP_RESIDUAL_CALLBACK_TRIGGER_PATH;
+const exitAfterResidualCallbacks = process.env.T3_ACP_EXIT_AFTER_RESIDUAL_CALLBACKS === "1";
+const emitRunningCommandThenHang = process.env.T3_ACP_EMIT_RUNNING_COMMAND_THEN_HANG === "1";
+const emitRunningCommandThenHangOnFirstPrompt =
+  process.env.T3_ACP_EMIT_RUNNING_COMMAND_THEN_HANG_FIRST_PROMPT === "1";
+const emitEmptySuccessfulBash = process.env.T3_ACP_EMIT_EMPTY_SUCCESSFUL_BASH === "1";
+const emitEmptySuccessfulBashThenHang =
+  process.env.T3_ACP_EMIT_EMPTY_SUCCESSFUL_BASH_THEN_HANG === "1";
+const exitOnCancel = process.env.T3_ACP_EXIT_ON_CANCEL === "1";
+const runningCommandIgnoresTerm = process.env.T3_ACP_RUNNING_COMMAND_IGNORE_TERM === "1";
+const runningCommandPidPath = process.env.T3_ACP_RUNNING_COMMAND_PID_PATH;
+const runningCommandSeparateSession = process.env.T3_ACP_RUNNING_COMMAND_SEPARATE_SESSION === "1";
+const exitAfterRunningCommandLaunch = process.env.T3_ACP_EXIT_AFTER_RUNNING_COMMAND_LAUNCH === "1";
 const omitXAiPromptCompleteStopReason =
   process.env.T3_ACP_OMIT_XAI_PROMPT_COMPLETE_STOP_REASON === "1";
 const failLoadSession = process.env.T3_ACP_FAIL_LOAD_SESSION === "1";
@@ -50,6 +76,9 @@ const promptResponseText = process.env.T3_ACP_PROMPT_RESPONSE_TEXT;
 const initialGrokReasoningEffort =
   process.env.T3_ACP_INITIAL_GROK_REASONING_EFFORT?.trim() || undefined;
 const promptDelayMs = Number(process.env.T3_ACP_PROMPT_DELAY_MS ?? "0");
+const supportsSessionLifecycle = process.env.T3_ACP_SESSION_LIFECYCLE === "1";
+const advertisedAuthMethodId = process.env.T3_ACP_AUTH_METHOD_ID?.trim();
+const requiresAuthentication = process.env.T3_ACP_REQUIRE_AUTH === "1";
 const permissionOptionIds = {
   allowOnce: process.env.T3_ACP_ALLOW_ONCE_OPTION_ID ?? "allow-once",
   allowAlways: process.env.T3_ACP_ALLOW_ALWAYS_OPTION_ID ?? "allow-always",
@@ -68,6 +97,7 @@ let parameterizedModelPicker = false;
 let currentReasoning = "medium";
 let currentContext = "272k";
 let currentFast = false;
+let authenticated = !requiresAuthentication;
 let promptCount = 0;
 let overlappingFirstPromptId: string | undefined;
 const cancelledSessions = new Set<string>();
@@ -94,6 +124,11 @@ function writeJsonRpcNotification(method: string, params: unknown): void {
   process.stdout.write(`${JSON.stringify({ jsonrpc: "2.0", method, params })}\n`);
 }
 
+function logResidualCallbackResponse(kind: string): void {
+  if (!residualCallbackResponseLogPath) return;
+  NodeFS.appendFileSync(residualCallbackResponseLogPath, `${kind}\n`, "utf8");
+}
+
 process.once("SIGTERM", () => {
   logExit("SIGTERM");
   process.exit(0);
@@ -239,35 +274,6 @@ function configOptions(): ReadonlyArray<AcpSchema.SessionConfigOption> {
   ];
 }
 
-function modelConfigOptionsFor(modelId: string): ReadonlyArray<AcpSchema.SessionConfigOption> {
-  const previousModelId = currentModelId;
-  try {
-    currentModelId = modelId;
-    return configOptions().filter(
-      (option) => option.category !== "mode" && option.category !== "model",
-    );
-  } finally {
-    currentModelId = previousModelId;
-  }
-}
-
-function availableModels(): ReadonlyArray<{
-  readonly value: string;
-  readonly name: string;
-  readonly configOptions: ReadonlyArray<AcpSchema.SessionConfigOption>;
-}> {
-  return [
-    { value: "default", name: "Auto" },
-    { value: "composer-2", name: "Composer 2" },
-    { value: "gpt-5.4", name: "GPT-5.4" },
-    { value: "claude-opus-4-6", name: "Opus 4.6" },
-  ].map((model) => ({
-    value: model.value,
-    name: model.name,
-    configOptions: modelConfigOptionsFor(model.value),
-  }));
-}
-
 const availableModes: ReadonlyArray<AcpSchema.SessionMode> = [
   {
     id: "ask",
@@ -323,19 +329,60 @@ const program = Effect.gen(function* () {
         request.clientCapabilities?._meta?.parameterizedModelPicker === true;
       return {
         protocolVersion: 1,
-        agentCapabilities: { loadSession: true },
+        agentCapabilities: {
+          loadSession: true,
+          ...(supportsSessionLifecycle
+            ? {
+                sessionCapabilities: {
+                  list: {},
+                  fork: {},
+                  resume: {},
+                  close: {},
+                },
+              }
+            : {}),
+        },
+        ...(advertisedAuthMethodId
+          ? {
+              authMethods: [
+                {
+                  id: advertisedAuthMethodId,
+                  name: "Mock agent authentication",
+                },
+              ],
+            }
+          : {}),
       };
     }),
   );
 
-  yield* agent.handleAuthenticate(() => Effect.succeed({}));
+  yield* agent.handleAuthenticate((request) =>
+    Effect.gen(function* () {
+      if (advertisedAuthMethodId && request.methodId !== advertisedAuthMethodId) {
+        return yield* AcpError.AcpRequestError.invalidParams(
+          `Unknown mock authentication method: ${request.methodId}`,
+        );
+      }
+      authenticated = true;
+      return {};
+    }),
+  );
+
+  const requireAuthentication = Effect.fn("acpMockAgent.requireAuthentication")(function* () {
+    if (!authenticated) {
+      return yield* AcpError.AcpRequestError.authRequired();
+    }
+  });
 
   yield* agent.handleCreateSession(() =>
-    Effect.succeed({
-      sessionId,
-      modes: modeState(),
-      models: modelState(),
-      configOptions: configOptions(),
+    Effect.gen(function* () {
+      yield* requireAuthentication();
+      return {
+        sessionId,
+        modes: modeState(),
+        models: modelState(),
+        configOptions: configOptions(),
+      };
     }),
   );
 
@@ -401,6 +448,52 @@ const program = Effect.gen(function* () {
     }),
   );
 
+  yield* agent.handleListSessions((request) =>
+    Effect.gen(function* () {
+      yield* requireAuthentication();
+      return {
+        sessions: [
+          {
+            sessionId,
+            cwd: request.cwd ?? process.cwd(),
+            title: "Mock session",
+            updatedAt: "1970-01-01T00:00:00.000Z",
+          },
+        ],
+      };
+    }),
+  );
+
+  yield* agent.handleForkSession((request) =>
+    Effect.gen(function* () {
+      yield* requireAuthentication();
+      return {
+        sessionId: `${request.sessionId}-fork`,
+        modes: modeState(),
+        models: modelState(),
+        configOptions: configOptions(),
+      };
+    }),
+  );
+
+  yield* agent.handleResumeSession(() =>
+    Effect.gen(function* () {
+      yield* requireAuthentication();
+      return {
+        modes: modeState(),
+        models: modelState(),
+        configOptions: configOptions(),
+      };
+    }),
+  );
+
+  yield* agent.handleCloseSession(() =>
+    Effect.gen(function* () {
+      yield* requireAuthentication();
+      return {};
+    }),
+  );
+
   yield* agent.handleSetSessionModel((request) =>
     Effect.gen(function* () {
       if (!grokAcpModels.some((model) => model.modelId === request.modelId)) {
@@ -458,6 +551,9 @@ const program = Effect.gen(function* () {
     Effect.gen(function* () {
       const cancelledSessionId = String(sessionId ?? "mock-session-1");
       cancelledSessions.add(cancelledSessionId);
+      if (exitOnCancel) {
+        return yield* Effect.sync(() => process.exit(0));
+      }
       if (emitLateUpdateAfterCancel) {
         yield* Effect.sleep("50 millis");
         yield* Effect.sync(() => {
@@ -470,14 +566,119 @@ const program = Effect.gen(function* () {
           });
         });
       }
+      if (emitTaskBackgroundedAfterCancel) {
+        // Grok cancel-as-detach: the foreground command is re-run as a
+        // background task that later completes on its own.
+        yield* Effect.sync(() => {
+          writeJsonRpcNotification("_x.ai/task_backgrounded", {
+            sessionId: cancelledSessionId,
+            update: {
+              sessionUpdate: "task_backgrounded",
+              tool_call_id: "task-bg-1",
+              task_id: "task-bg-1",
+              command: "sleep 30",
+            },
+          });
+        });
+        yield* Effect.sleep("1200 millis")
+          .pipe(
+            Effect.andThen(
+              Effect.sync(() => {
+                writeJsonRpcNotification("_x.ai/task_completed", {
+                  sessionId: cancelledSessionId,
+                  update: {
+                    sessionUpdate: "task_completed",
+                    task_snapshot: { task_id: "task-bg-1", command: "sleep 30" },
+                  },
+                });
+              }),
+            ),
+          )
+          .pipe(Effect.forkDetach);
+      }
     }),
   );
 
   yield* agent.handlePrompt((request) =>
     Effect.gen(function* () {
       const requestedSessionId = String(request.sessionId ?? sessionId);
+      beginAcpMockPrompt(cancelledSessions, requestedSessionId);
       promptCount += 1;
 
+      if (residualCallbackTriggerPath !== undefined) {
+        yield* Effect.gen(function* () {
+          while (!(yield* Effect.sync(() => NodeFS.existsSync(residualCallbackTriggerPath)))) {
+            yield* Effect.sleep("20 millis");
+          }
+          yield* Effect.sync(() => {
+            writeJsonRpcNotification("session/update", {
+              sessionId: requestedSessionId,
+              update: {
+                sessionUpdate: "agent_message_chunk",
+                content: { type: "text", text: "residual assistant callback" },
+              },
+            });
+            writeJsonRpcNotification("session/update", {
+              sessionId: requestedSessionId,
+              update: {
+                sessionUpdate: "tool_call",
+                toolCallId: "residual-tool-call",
+                title: "Residual tool callback",
+                kind: "other",
+                status: "pending",
+                rawInput: {},
+              },
+            });
+            writeJsonRpcNotification("session/update", {
+              sessionId: requestedSessionId,
+              update: {
+                sessionUpdate: "plan",
+                entries: [
+                  { content: "Residual plan callback", priority: "high", status: "pending" },
+                ],
+              },
+            });
+          });
+          yield* agent.client
+            .requestPermission({
+              sessionId: requestedSessionId,
+              toolCall: {
+                toolCallId: "residual-permission",
+                title: "Residual permission callback",
+              },
+              options: [{ optionId: "allow", name: "Allow", kind: "allow_once" }],
+            })
+            .pipe(
+              Effect.exit,
+              Effect.tap(() => Effect.sync(() => logResidualCallbackResponse("permission"))),
+              Effect.ignore,
+              Effect.forkDetach,
+            );
+          yield* agent.client
+            .elicit({
+              sessionId: requestedSessionId,
+              message: "Residual elicitation callback",
+              mode: "form",
+              requestedSchema: {
+                type: "object",
+                properties: {
+                  approved: { type: "boolean", title: "Approved" },
+                },
+              },
+            })
+            .pipe(
+              Effect.exit,
+              Effect.tap(() => Effect.sync(() => logResidualCallbackResponse("elicitation"))),
+              Effect.ignore,
+              Effect.forkDetach,
+            );
+          if (exitAfterResidualCallbacks) {
+            yield* Effect.sleep("100 millis");
+            return yield* Effect.sync(() => process.exit(0));
+          }
+        }).pipe(Effect.forkDetach);
+      }
+
       if (Number.isFinite(promptDelayMs) && promptDelayMs > 0) {
         yield* Effect.sleep(`${promptDelayMs} millis`);
       }
@@ -539,10 +740,107 @@ const program = Effect.gen(function* () {
         return yield* Effect.never;
       }
 
-      if (hangPromptForever || (hangFirstPromptForever && promptCount === 1)) {
+      if (
+        hangPromptForever ||
+        (hangFirstPromptForever && promptCount === 1) ||
+        (emitEmptySuccessfulBashThenHang && promptCount === 2)
+      ) {
         return yield* Effect.never;
       }
 
+      if (
+        emitRunningCommandThenHang ||
+        (emitRunningCommandThenHangOnFirstPrompt && promptCount === 1)
+      ) {
+        const toolCallId = "tool-call-running-1";
+        if (runningCommandPidPath !== undefined) {
+          const command = runningCommandIgnoresTerm
+            ? 'trap "" TERM; bash -c \'trap "" TERM; while :; do sleep 1; done\' & child=$!; printf "%s %s\n" "$$" "$child" > "$1"; wait "$child"'
+            : 'sleep 120 & child=$!; printf "%s %s\n" "$$" "$child" > "$1"; wait "$child"';
+          if (runningCommandSeparateSession) {
+            const launcher = [
+              'const { spawn } = require("node:child_process");',
+              "const child = spawn(process.argv[1], process.argv.slice(2), { stdio: 'ignore' });",
+              "child.once('exit', (code, signal) => process.exitCode = code ?? (signal ? 1 : 0));",
+            ].join(" ");
+            const detachedCommand = runningCommandIgnoresTerm
+              ? 'trap "" TERM; bash -c \'trap "" TERM; while :; do sleep 1; done\' & child=$!; printf "%s %s %s\n" "$PPID" "$$" "$child" > "$1"; wait "$child"'
+              : 'sleep 120 & child=$!; printf "%s %s %s\n" "$PPID" "$$" "$child" > "$1"; wait "$child"';
+            // Nested bash publishes "$PPID $$ $child" once it starts. Do not
+            // write the launcher PID alone here: that races with bash and can
+            // clobber the triple that interrupt tests wait for.
+            const detachedLauncher = NodeChildProcess.spawn(
+              process.execPath,
+              ["-e", launcher, "bash", "-c", detachedCommand, "bash", runningCommandPidPath],
+              { detached: true, stdio: "ignore" },
+            );
+            detachedLauncher.unref();
+          } else {
+            NodeChildProcess.spawn("bash", ["-c", command, "bash", runningCommandPidPath], {
+              stdio: "ignore",
+            });
+          }
+        }
+        yield* agent.client.sessionUpdate({
+          sessionId: requestedSessionId,
+          update: {
+            sessionUpdate: "tool_call",
+            toolCallId,
+            title: "Terminal",
+            kind: "execute",
+            status: "pending",
+            rawInput: {
+              command: ["sleep", "120"],
+            },
+          },
+        });
+        yield* agent.client.sessionUpdate({
+          sessionId: requestedSessionId,
+          update: {
+            sessionUpdate: "tool_call_update",
+            toolCallId,
+            title: "Terminal",
+            kind: "execute",
+            status: "in_progress",
+            rawInput: {
+              command: ["sleep", "120"],
+            },
+            // Grok-like mid-stream Bash re-report: exit_code 0 while still running.
+            rawOutput: { type: "Bash", exit_code: 0 },
+          },
+        });
+        yield* agent.client.sessionUpdate({
+          sessionId: requestedSessionId,
+          update: {
+            sessionUpdate: "tool_call",
+            toolCallId: "tool-call-output-1",
+            title: "get_command_or_subagent_output",
+            kind: "other",
+            status: "pending",
+            rawInput: { task_id: "task-running-1" },
+          },
+        });
+        yield* agent.client.sessionUpdate({
+          sessionId: requestedSessionId,
+          update: {
+            sessionUpdate: "tool_call_update",
+            toolCallId: "tool-call-output-1",
+            status: "in_progress",
+            rawOutput: { task_id: "task-running-1", status: "running" },
+          },
+        });
+        if (exitAfterRunningCommandLaunch) {
+          yield* Effect.sleep("100 millis");
+          return yield* Effect.sync(() => process.exit(0));
+        }
+        // Stay open until session/cancel so interrupt tests can observe a running tool.
+        while (!cancelledSessions.has(requestedSessionId)) {
+          yield* Effect.sleep("25 millis");
+        }
+        cancelledSessions.delete(requestedSessionId);
+        return { stopReason: "cancelled" };
+      }
+
       if (emitXAiRateLimitThenHang) {
         writeJsonRpcNotification("_x.ai/session/prompt_complete", {
           sessionId: requestedSessionId,
@@ -604,6 +902,24 @@ const program = Effect.gen(function* () {
         });
         return yield* Effect.never;
       }
+      if (emitEmptySuccessfulBash || (emitEmptySuccessfulBashThenHang && promptCount === 1)) {
+        const update = {
+          sessionId: requestedSessionId,
+          update: {
+            sessionUpdate: "tool_call_update",
+            toolCallId: "tool-call-empty-success-1",
+            title: "Terminal",
+            kind: "execute",
+            status: "completed",
+            rawInput: { command: "true" },
+            rawOutput: { type: "Bash", exit_code: 0 },
+          },
+        } as const;
+        yield* agent.client.sessionUpdate(update);
+        yield* Effect.sleep("25 millis");
+        yield* agent.client.sessionUpdate(update);
+        return { stopReason: "end_turn" };
+      }
 
       if (emitXAiPromptCompleteThenHang) {
         writeJsonRpcNotification("session/update", {
@@ -713,6 +1029,32 @@ const program = Effect.gen(function* () {
         return { stopReason: "end_turn" };
       }
 
+      if (emitElicitation) {
+        yield* agent.client.elicit({
+          sessionId: requestedSessionId,
+          message: "Approve this request?",
+          mode: "form",
+          requestedSchema: {
+            type: "object",
+            properties: {
+              approved: { type: "boolean", title: "Approved" },
+            },
+          },
+        });
+        return { stopReason: "end_turn" };
+      }
+
+      if (emitUrlElicitation) {
+        yield* agent.client.elicit({
+          sessionId: requestedSessionId,
+          message: "Open authentication page",
+          mode: "url",
+          url: "https://example.com/auth",
+          elicitationId: "url-elicitation-1",
+        });
+        return { stopReason: "end_turn" };
+      }
+
       if (emitToolCalls) {
         const toolCallId = "tool-call-1";
 
@@ -792,6 +1134,10 @@ const program = Effect.gen(function* () {
           }
         }
 
+        if (hangAfterPermission) {
+          return yield* Effect.never;
+        }
+
         yield* agent.client.sessionUpdate({
           sessionId: requestedSessionId,
           update: {
@@ -858,6 +1204,159 @@ const program = Effect.gen(function* () {
         return { stopReason: "end_turn" };
       }
 
+      // In-turn monitor + TaskOutput hydrate, then a late post-finalize
+      // duplicate terminal TaskOutput for the same task. Exercises the
+      // already-handled short-circuit: must not pin hasPendingBackgroundWork.
+      if (emitInTurnTaskOutputThenLateDuplicate) {
+        const monitorToolCallId = "tool-call-monitor-1";
+        yield* agent.client.sessionUpdate({
+          sessionId: requestedSessionId,
+          update: {
+            sessionUpdate: "tool_call",
+            toolCallId: monitorToolCallId,
+            title: "Monitor: mock background task",
+            kind: "execute",
+            status: "pending",
+            rawInput: {},
+          },
+        });
+        yield* agent.client.sessionUpdate({
+          sessionId: requestedSessionId,
+          update: {
+            sessionUpdate: "tool_call_update",
+            toolCallId: monitorToolCallId,
+            status: "in_progress",
+          },
+        });
+        yield* agent.client.sessionUpdate({
+          sessionId: requestedSessionId,
+          update: {
+            sessionUpdate: "tool_call",
+            toolCallId: "tool-call-fetch-1",
+            title: "get_command_or_subagent_output",
+            kind: "other",
+            status: "pending",
+            rawInput: { task_id: "task-monitor-1" },
+          },
+        });
+        yield* agent.client.sessionUpdate({
+          sessionId: requestedSessionId,
+          update: {
+            sessionUpdate: "tool_call_update",
+            toolCallId: "tool-call-fetch-1",
+            status: "completed",
+            rawOutput: { output: "MONITOR_LISTING_TOKEN" },
+          },
+        });
+        yield* agent.client.sessionUpdate({
+          sessionId: requestedSessionId,
+          update: {
+            sessionUpdate: "agent_message_chunk",
+            content: { type: "text", text: "Monitor listing ready in-turn." },
+          },
+        });
+        // After deferred finalize (~2s) clears activeTurn, re-emit a terminal
+        // TaskOutput for the same task so bufferPostSettleWake sees
+        // alreadyHandledToolUpdate with a non-empty wake path.
+        yield* Effect.gen(function* () {
+          yield* Effect.sleep("2500 millis");
+          yield* Effect.sync(() => {
+            writeJsonRpcNotification("session/update", {
+              sessionId: requestedSessionId,
+              update: {
+                sessionUpdate: "tool_call_update",
+                toolCallId: "tool-call-fetch-1",
+                title: "get_command_or_subagent_output",
+                kind: "other",
+                status: "completed",
+                rawOutput: { output: "MONITOR_LISTING_TOKEN_LATE" },
+              },
+            });
+          });
+        }).pipe(Effect.forkDetach);
+        return { stopReason: "end_turn" };
+      }
+
+      if (emitPostSettleMonitorFlow) {
+        const monitorToolCallId = "tool-call-monitor-1";
+
+        yield* agent.client.sessionUpdate({
+          sessionId: requestedSessionId,
+          update: {
+            sessionUpdate: "tool_call",
+            toolCallId: monitorToolCallId,
+            title: "Monitor: mock background task",
+            kind: "execute",
+            status: "pending",
+            rawInput: {},
+          },
+        });
+
+        yield* agent.client.sessionUpdate({
+          sessionId: requestedSessionId,
+          update: {
+            sessionUpdate: "tool_call_update",
+            toolCallId: monitorToolCallId,
+            status: "in_progress",
+          },
+        });
+
+        // After the prompt settles, replay the CLI-injected monitor-event
+        // turn: end notice, TaskOutput hydration, then (once the trigger
+        // file exists) the report chunk. Detached fiber on the real clock;
+        // it outlives the prompt handler.
+        yield* Effect.gen(function* () {
+          yield* Effect.sleep("150 millis");
+          yield* Effect.sync(() => {
+            writeJsonRpcNotification("session/update", {
+              sessionId: requestedSessionId,
+              update: {
+                sessionUpdate: "user_message_chunk",
+                content: {
+                  type: "text",
+                  text: 'Monitor "task-monitor-1" ended: [monitor ended: exit 0]',
+                },
+              },
+            });
+            writeJsonRpcNotification("session/update", {
+              sessionId: requestedSessionId,
+              update: {
+                sessionUpdate: "tool_call",
+                toolCallId: "tool-call-fetch-1",
+                title: "get_command_or_subagent_output",
+                kind: "other",
+                status: "pending",
+                rawInput: { task_id: "task-monitor-1" },
+              },
+            });
+            writeJsonRpcNotification("session/update", {
+              sessionId: requestedSessionId,
+              update: {
+                sessionUpdate: "tool_call_update",
+                toolCallId: "tool-call-fetch-1",
+                status: "completed",
+                rawOutput: { output: "MONITOR_LISTING_TOKEN" },
+              },
+            });
+          });
+          if (injectedReportTriggerPath === undefined) return;
+          while (!(yield* Effect.sync(() => NodeFS.existsSync(injectedReportTriggerPath)))) {
+            yield* Effect.sleep("20 millis");
+          }
+          yield* Effect.sync(() => {
+            writeJsonRpcNotification("session/update", {
+              sessionId: requestedSessionId,
+              update: {
+                sessionUpdate: "agent_message_chunk",
+                content: { type: "text", text: "Monitor finished. MONITOR_REPORT_TOKEN" },
+              },
+            });
+          });
+        }).pipe(Effect.forkDetach);
+
+        return { stopReason: "end_turn" };
+      }
+
       if (emitAskQuestion) {
         yield* agent.client.extRequest("cursor/ask_question", {
           toolCallId: "ask-question-tool-call-1",
@@ -1060,12 +1559,6 @@ const program = Effect.gen(function* () {
   );
 
   yield* agent.handleUnknownExtRequest((method, params) => {
-    if (method === "cursor/list_available_models") {
-      return Effect.succeed({
-        models: availableModels(),
-      });
-    }
-
     if (method !== "session/mode/set") {
       return Effect.fail(AcpError.AcpRequestError.methodNotFound(method));
     }
diff --git a/apps/server/scripts/acp-replay-agent.test.ts b/apps/server/scripts/acp-replay-agent.test.ts
new file mode 100644
index 000000000000..2a662a0ff808
--- /dev/null
+++ b/apps/server/scripts/acp-replay-agent.test.ts
@@ -0,0 +1,78 @@
+// @effect-diagnostics nodeBuiltinImport:off
+import * as NodeChildProcess from "node:child_process";
+import * as NodeFS from "node:fs";
+import * as NodeOS from "node:os";
+import * as NodePath from "node:path";
+import * as NodeURL from "node:url";
+
+import { expect, it } from "vite-plus/test";
+
+import { acpReplayAgentArgs } from "../src/orchestration-v2/Adapters/AcpAdapterV2.testkit.ts";
+
+const replayAgentPath = NodeURL.fileURLToPath(new URL("./acp-replay-agent.ts", import.meta.url));
+
+async function runRuntimeExit(status: "success" | "error" | "cancelled") {
+  const scratch = NodeFS.mkdtempSync(NodePath.join(NodeOS.tmpdir(), "t3-acp-replay-agent-"));
+  const statusPath = NodePath.join(scratch, "status.json");
+  const transcript = {
+    scenario: `${status}-runtime-exit`,
+    entries: [{ type: "runtime_exit", status }],
+  };
+  const args = acpReplayAgentArgs(replayAgentPath);
+  const child = NodeChildProcess.spawn(process.execPath, args, {
+    env: {
+      ...process.env,
+      T3_ACP_REPLAY_STATUS_PATH: statusPath,
+      T3_ACP_REPLAY_TRANSCRIPT: Buffer.from(JSON.stringify(transcript), "utf8").toString("base64"),
+      T3_ACP_REPLAY_WORKSPACE: scratch,
+    },
+    stdio: ["pipe", "pipe", "pipe"],
+  });
+  let stderr = "";
+  child.stderr.setEncoding("utf8");
+  child.stderr.on("data", (chunk: string) => {
+    stderr += chunk;
+  });
+  child.stdin.end();
+
+  try {
+    const code = await new Promise<number | null>((resolve, reject) => {
+      child.once("error", reject);
+      child.once("exit", resolve);
+    });
+    return {
+      code,
+      status: JSON.parse(NodeFS.readFileSync(statusPath, "utf8")) as unknown,
+      stderr,
+      transcript,
+      args,
+    };
+  } finally {
+    NodeFS.rmSync(scratch, { recursive: true, force: true });
+  }
+}
+
+it("accepts a recorded cancelled runtime exit", async () => {
+  const result = await runRuntimeExit("cancelled");
+  expect(result.code, result.stderr).toBe(0);
+  expect(result.args).toEqual(["--experimental-strip-types", replayAgentPath]);
+  expect(result.status).toEqual({
+    scenario: result.transcript.scenario,
+    cursor: 1,
+    total: 1,
+  });
+});
+
+it("still rejects a recorded error runtime exit", async () => {
+  const result = await runRuntimeExit("error");
+  expect(result.code).toBe(1);
+  expect(result.status).toMatchObject({
+    scenario: result.transcript.scenario,
+    cursor: 0,
+    total: 1,
+    failure: {
+      detail: "Recorded runtime exit was error",
+      cursor: 0,
+    },
+  });
+});
diff --git a/apps/server/scripts/acp-replay-agent.ts b/apps/server/scripts/acp-replay-agent.ts
new file mode 100644
index 000000000000..d467d835a41b
--- /dev/null
+++ b/apps/server/scripts/acp-replay-agent.ts
@@ -0,0 +1,285 @@
+#!/usr/bin/env node
+// @effect-diagnostics nodeBuiltinImport:off
+import * as NodeFS from "node:fs";
+import * as NodeReadline from "node:readline";
+
+interface ReplayEntry {
+  readonly type: "emit_inbound" | "expect_outbound" | "runtime_exit";
+  readonly label?: string;
+  readonly frame?: unknown;
+  readonly status?: "success" | "error" | "cancelled";
+  readonly error?: unknown;
+}
+
+interface ReplayTranscript {
+  readonly scenario: string;
+  readonly entries: ReadonlyArray<ReplayEntry>;
+}
+
+interface LogicalFrame {
+  readonly kind: "notification" | "request" | "response";
+  readonly method: string;
+  readonly params?: unknown;
+  readonly result?: unknown;
+  readonly error?: unknown;
+}
+
+interface JsonRpcMessage {
+  readonly jsonrpc?: string;
+  readonly id?: string | number | null;
+  readonly method?: string;
+  readonly params?: unknown;
+  readonly result?: unknown;
+  readonly error?: unknown;
+  readonly headers?: ReadonlyArray<unknown>;
+}
+
+const encodedTranscript = process.env.T3_ACP_REPLAY_TRANSCRIPT;
+const statusPath = process.env.T3_ACP_REPLAY_STATUS_PATH;
+const replayWorkspace = process.env.T3_ACP_REPLAY_WORKSPACE ?? process.cwd();
+
+if (encodedTranscript === undefined || statusPath === undefined) {
+  process.stderr.write("ACP replay requires transcript and status environment variables.\n");
+  process.exit(2);
+}
+
+const replayStatusPath = statusPath;
+const transcript = JSON.parse(
+  Buffer.from(encodedTranscript, "base64").toString("utf8"),
+) as ReplayTranscript;
+let cursor = 0;
+let stopped = false;
+let nextAgentRequestId = 1;
+const pendingClientRequestIds = new Map<string, string | number>();
+const pendingAgentRequestMethods = new Map<string, string>();
+
+function writeStatus(failure?: unknown): void {
+  NodeFS.writeFileSync(
+    replayStatusPath,
+    JSON.stringify({
+      scenario: transcript.scenario,
+      cursor,
+      total: transcript.entries.length,
+      ...(failure === undefined ? {} : { failure }),
+    }),
+    "utf8",
+  );
+}
+
+function stableStringify(value: unknown): string {
+  if (Array.isArray(value)) {
+    return `[${value.map(stableStringify).join(",")}]`;
+  }
+  if (typeof value === "object" && value !== null) {
+    const record = value as Record<string, unknown>;
+    return `{${Object.keys(record)
+      .toSorted()
+      .map((key) => `${JSON.stringify(key)}:${stableStringify(record[key])}`)
+      .join(",")}}`;
+  }
+  return JSON.stringify(value);
+}
+
+function expandExpectedString(value: string): string {
+  return value.replaceAll("<workspace>", replayWorkspace);
+}
+
+function matchesExpected(expected: unknown, actual: unknown): boolean {
+  if (expected === "<any>") return true;
+  if (typeof expected === "string" && typeof actual === "string") {
+    const expanded = expandExpectedString(expected);
+    if (!expanded.includes("<any>")) return expanded === actual;
+    const parts = expanded.split("<any>");
+    let offset = 0;
+    for (const part of parts) {
+      const index = actual.indexOf(part, offset);
+      if (index === -1) return false;
+      offset = index + part.length;
+    }
+    return true;
+  }
+  if (Array.isArray(expected)) {
+    return (
+      Array.isArray(actual) &&
+      expected.length === actual.length &&
+      expected.every((entry, index) => matchesExpected(entry, actual[index]))
+    );
+  }
+  if (typeof expected === "object" && expected !== null) {
+    if (typeof actual !== "object" || actual === null || Array.isArray(actual)) return false;
+    const expectedRecord = expected as Record<string, unknown>;
+    const actualRecord = actual as Record<string, unknown>;
+    const expectedKeys = Object.keys(expectedRecord).toSorted();
+    const actualKeys = Object.keys(actualRecord).toSorted();
+    return (
+      stableStringify(expectedKeys) === stableStringify(actualKeys) &&
+      expectedKeys.every((key) => matchesExpected(expectedRecord[key], actualRecord[key]))
+    );
+  }
+  return Object.is(expected, actual);
+}
+
+function stopWithFailure(detail: string, actual?: unknown): void {
+  if (stopped) return;
+  stopped = true;
+  const entry = transcript.entries[cursor];
+  const failure = {
+    detail,
+    cursor,
+    expected: entry,
+    ...(actual === undefined ? {} : { actual }),
+  };
+  writeStatus(failure);
+  process.stderr.write(`ACP replay mismatch: ${JSON.stringify(failure)}\n`);
+  process.exitCode = 1;
+  process.stdin.pause();
+}
+
+function advance(): void {
+  cursor += 1;
+  writeStatus();
+}
+
+function send(message: JsonRpcMessage): void {
+  process.stdout.write(`${JSON.stringify(message)}\n`);
+}
+
+function pendingClientRequestId(method: string): string | number | undefined {
+  return pendingClientRequestIds.get(method);
+}
+
+function logicalIncoming(message: JsonRpcMessage): LogicalFrame | undefined {
+  if (typeof message.method === "string") {
+    return {
+      kind:
+        message.id === undefined || message.id === null || message.id === ""
+          ? "notification"
+          : "request",
+      method: message.method,
+      ...(message.params === undefined ? {} : { params: message.params }),
+    };
+  }
+  if (message.id === undefined || message.id === null) return undefined;
+  const method = pendingAgentRequestMethods.get(String(message.id));
+  if (method === undefined) return undefined;
+  return {
+    kind: "response",
+    method,
+    ...(message.result === undefined ? {} : { result: message.result }),
+    ...(message.error === undefined ? {} : { error: message.error }),
+  };
+}
+
+function emitInbound(frame: LogicalFrame): void {
+  switch (frame.kind) {
+    case "notification":
+      send({
+        jsonrpc: "2.0",
+        method: frame.method,
+        ...(frame.params === undefined ? {} : { params: frame.params }),
+      });
+      return;
+    case "request": {
+      const id = nextAgentRequestId;
+      nextAgentRequestId += 1;
+      pendingAgentRequestMethods.set(String(id), frame.method);
+      send({
+        jsonrpc: "2.0",
+        id,
+        method: frame.method,
+        ...(frame.params === undefined ? {} : { params: frame.params }),
+        headers: [],
+      });
+      return;
+    }
+    case "response": {
+      const id = pendingClientRequestId(frame.method);
+      if (id === undefined) {
+        stopWithFailure(`No pending client request for ${frame.method}`, frame);
+        return;
+      }
+      pendingClientRequestIds.delete(frame.method);
+      send({
+        jsonrpc: "2.0",
+        id,
+        ...(frame.result === undefined ? {} : { result: frame.result }),
+        ...(frame.error === undefined ? {} : { error: frame.error }),
+      });
+    }
+  }
+}
+
+function flushInbound(): void {
+  while (!stopped) {
+    const entry = transcript.entries[cursor];
+    if (entry === undefined || entry.type === "expect_outbound") return;
+    if (entry.type === "runtime_exit") {
+      if (entry.status !== "success" && entry.status !== "cancelled") {
+        stopWithFailure(`Recorded runtime exit was ${entry.status ?? "unknown"}`, entry.error);
+        return;
+      }
+      advance();
+      continue;
+    }
+    const frame = entry.frame as LogicalFrame;
+    if (
+      typeof frame !== "object" ||
+      frame === null ||
+      !["notification", "request", "response"].includes(frame.kind) ||
+      typeof frame.method !== "string"
+    ) {
+      stopWithFailure("Invalid emit_inbound logical ACP frame", entry.frame);
+      return;
+    }
+    emitInbound(frame);
+    if (stopped) return;
+    advance();
+  }
+}
+
+function handleMessage(message: JsonRpcMessage): void {
+  if (stopped) return;
+  const actual = logicalIncoming(message);
+  if (actual === undefined) {
+    stopWithFailure("Could not identify outbound ACP frame", message);
+    return;
+  }
+  const entry = transcript.entries[cursor];
+  if (entry?.type !== "expect_outbound" || !matchesExpected(entry.frame, actual)) {
+    if (actual.kind === "request" && message.id !== undefined && message.id !== null) {
+      send({
+        jsonrpc: "2.0",
+        id: message.id,
+        error: { code: -32603, message: "ACP replay frame mismatch" },
+      });
+    }
+    stopWithFailure("Unexpected outbound ACP frame", actual);
+    return;
+  }
+  if (actual.kind === "request" && message.id !== undefined && message.id !== null) {
+    pendingClientRequestIds.set(actual.method, message.id);
+  } else if (actual.kind === "response" && message.id !== undefined && message.id !== null) {
+    pendingAgentRequestMethods.delete(String(message.id));
+  }
+  advance();
+  flushInbound();
+}
+
+writeStatus();
+flushInbound();
+
+const input = NodeReadline.createInterface({ input: process.stdin, crlfDelay: Infinity });
+input.on("line", (line) => {
+  if (stopped || line.trim().length === 0) return;
+  try {
+    handleMessage(JSON.parse(line) as JsonRpcMessage);
+  } catch (cause) {
+    stopWithFailure("Failed to decode outbound ACP JSON-RPC", String(cause));
+  }
+});
+
+input.on("close", () => {
+  if (!stopped && cursor !== transcript.entries.length) {
+    stopWithFailure("ACP replay input closed before transcript completion");
+  }
+});
diff --git a/apps/server/scripts/acp-thread-spawn-helper.c b/apps/server/scripts/acp-thread-spawn-helper.c
new file mode 100644
index 000000000000..f5b84ee6d986
--- /dev/null
+++ b/apps/server/scripts/acp-thread-spawn-helper.c
@@ -0,0 +1,37 @@
+#define _GNU_SOURCE
+
+#include <pthread.h>
+#include <stdio.h>
+#include <stdlib.h>
+#include <sys/syscall.h>
+#include <sys/types.h>
+#include <sys/wait.h>
+#include <unistd.h>
+
+static const char *pid_path;
+
+static void *spawn_child(void *unused) {
+    (void)unused;
+    pid_t child = fork();
+    if (child == 0) {
+        execlp("sleep", "sleep", "120", NULL);
+        _exit(127);
+    }
+    if (child < 0) return NULL;
+    FILE *file = fopen(pid_path, "w");
+    if (file != NULL) {
+        fprintf(file, "%ld %d\n", syscall(SYS_gettid), child);
+        fclose(file);
+    }
+    waitpid(child, NULL, 0);
+    return NULL;
+}
+
+int main(int argc, char **argv) {
+    if (argc != 2) return 2;
+    pid_path = argv[1];
+    pthread_t worker;
+    if (pthread_create(&worker, NULL, spawn_child, NULL) != 0) return 3;
+    if (pthread_join(worker, NULL) != 0) return 4;
+    return 0;
+}
diff --git a/apps/server/scripts/acpMockCancellationState.test.ts b/apps/server/scripts/acpMockCancellationState.test.ts
new file mode 100644
index 000000000000..98ce4f9a1327
--- /dev/null
+++ b/apps/server/scripts/acpMockCancellationState.test.ts
@@ -0,0 +1,12 @@
+import { assert, it } from "@effect/vitest";
+
+import { beginAcpMockPrompt } from "./acpMockCancellationState.ts";
+
+it("does not carry an idle cancellation into the next prompt", () => {
+  const cancelledSessions = new Set(["session:cancelled-while-idle", "session:other"]);
+
+  beginAcpMockPrompt(cancelledSessions, "session:cancelled-while-idle");
+
+  assert.isFalse(cancelledSessions.has("session:cancelled-while-idle"));
+  assert.isTrue(cancelledSessions.has("session:other"));
+});
diff --git a/apps/server/scripts/acpMockCancellationState.ts b/apps/server/scripts/acpMockCancellationState.ts
new file mode 100644
index 000000000000..2b141e9248ba
--- /dev/null
+++ b/apps/server/scripts/acpMockCancellationState.ts
@@ -0,0 +1,3 @@
+export function beginAcpMockPrompt(cancelledSessions: Set<string>, sessionId: string): void {
+  cancelledSessions.delete(sessionId);
+}
diff --git a/apps/server/scripts/claudeReplayRecordingConfig.test.ts b/apps/server/scripts/claudeReplayRecordingConfig.test.ts
new file mode 100644
index 000000000000..4df53b9fa21f
--- /dev/null
+++ b/apps/server/scripts/claudeReplayRecordingConfig.test.ts
@@ -0,0 +1,43 @@
+import { assert, it } from "@effect/vitest";
+
+import { validateClaudeReplayRecordingSelection } from "./claudeReplayRecordingConfig.ts";
+
+it("rejects a query mode that is incompatible with the selected scenario", () => {
+  assert.throws(
+    () =>
+      validateClaudeReplayRecordingSelection({
+        scenario: "simple",
+        configuredQueryMode: "streaming",
+        selectedQueryMode: "fork_session_siblings",
+        configuredPromptCount: 1,
+        selectedPromptCount: 1,
+      }),
+    "Select a scenario configured for the requested query mode",
+  );
+});
+
+it("rejects prompt overrides that do not preserve the scenario shape", () => {
+  assert.throws(
+    () =>
+      validateClaudeReplayRecordingSelection({
+        scenario: "thread_fork_native_siblings",
+        configuredQueryMode: "fork_session_siblings",
+        selectedQueryMode: "fork_session_siblings",
+        configuredPromptCount: 3,
+        selectedPromptCount: 1,
+      }),
+    "requires exactly 3 prompt(s)",
+  );
+});
+
+it("accepts the configured scenario mode and prompt shape", () => {
+  assert.doesNotThrow(() =>
+    validateClaudeReplayRecordingSelection({
+      scenario: "thread_fork_native_siblings",
+      configuredQueryMode: "fork_session_siblings",
+      selectedQueryMode: "fork_session_siblings",
+      configuredPromptCount: 3,
+      selectedPromptCount: 3,
+    }),
+  );
+});
diff --git a/apps/server/scripts/claudeReplayRecordingConfig.ts b/apps/server/scripts/claudeReplayRecordingConfig.ts
new file mode 100644
index 000000000000..5d5baf332aab
--- /dev/null
+++ b/apps/server/scripts/claudeReplayRecordingConfig.ts
@@ -0,0 +1,32 @@
+export type ClaudeRecordingQueryMode =
+  | "streaming"
+  | "restart"
+  | "resume_at_cursor"
+  | "fork_session"
+  | "fork_session_prior_turn"
+  | "fork_session_continue"
+  | "fork_session_siblings"
+  | "fork_session_merge_back"
+  | "fork_session_merge_back_siblings"
+  | "active_steering"
+  | "interrupt"
+  | "interrupt_restart";
+
+export function validateClaudeReplayRecordingSelection(input: {
+  readonly scenario: string;
+  readonly configuredQueryMode: ClaudeRecordingQueryMode;
+  readonly selectedQueryMode: ClaudeRecordingQueryMode;
+  readonly configuredPromptCount: number;
+  readonly selectedPromptCount: number;
+}): void {
+  if (input.selectedQueryMode !== input.configuredQueryMode) {
+    throw new Error(
+      `Claude replay fixture '${input.scenario}' uses query mode '${input.configuredQueryMode}', not '${input.selectedQueryMode}'. Select a scenario configured for the requested query mode.`,
+    );
+  }
+  if (input.selectedPromptCount !== input.configuredPromptCount) {
+    throw new Error(
+      `Claude replay fixture '${input.scenario}' requires exactly ${input.configuredPromptCount} prompt(s) for query mode '${input.configuredQueryMode}', but received ${input.selectedPromptCount}.`,
+    );
+  }
+}
diff --git a/apps/server/scripts/codexReplayRecordingRecords.test.ts b/apps/server/scripts/codexReplayRecordingRecords.test.ts
new file mode 100644
index 000000000000..476781214ffd
--- /dev/null
+++ b/apps/server/scripts/codexReplayRecordingRecords.test.ts
@@ -0,0 +1,35 @@
+import { assert, it } from "@effect/vitest";
+
+import { codexReplayRecordingOutputRecords } from "./codexReplayRecordingRecords.ts";
+
+it("preserves monotonic request ids across native Codex forks", () => {
+  const records = [
+    {
+      type: "expect_outbound",
+      label: "initialize",
+      frame: { id: 1, method: "initialize" },
+    },
+    {
+      type: "expect_outbound",
+      label: "thread/fork",
+      frame: { id: 4, method: "thread/fork" },
+    },
+    {
+      type: "expect_outbound",
+      label: "turn/start",
+      frame: { id: 5, method: "turn/start" },
+    },
+  ];
+
+  const output = codexReplayRecordingOutputRecords(records);
+
+  assert.deepEqual(output, records);
+  assert.deepEqual(
+    output.map((record) => record.label),
+    ["initialize", "thread/fork", "turn/start"],
+  );
+  assert.deepEqual(
+    output.map((record) => (record.frame as { readonly id: number }).id),
+    [1, 4, 5],
+  );
+});
diff --git a/apps/server/scripts/codexReplayRecordingRecords.ts b/apps/server/scripts/codexReplayRecordingRecords.ts
new file mode 100644
index 000000000000..41475437197a
--- /dev/null
+++ b/apps/server/scripts/codexReplayRecordingRecords.ts
@@ -0,0 +1,9 @@
+/**
+ * Codex supports multiple provider threads in one app-server session, so native
+ * fork recording keeps the request ids emitted by that single client.
+ */
+export function codexReplayRecordingOutputRecords(
+  records: ReadonlyArray<Record<string, unknown>>,
+): ReadonlyArray<Record<string, unknown>> {
+  return [...records];
+}
diff --git a/apps/server/scripts/cursor-acp-model-mismatch-probe.ts b/apps/server/scripts/cursor-acp-model-mismatch-probe.ts
deleted file mode 100644
index 7e4e88aeb2b4..000000000000
--- a/apps/server/scripts/cursor-acp-model-mismatch-probe.ts
+++ /dev/null
@@ -1,442 +0,0 @@
-// @effect-diagnostics nodeBuiltinImport:off
-import * as NodeChildProcess from "node:child_process";
-import * as NodeProcess from "node:process";
-import * as NodeReadline from "node:readline";
-import * as NodeTimers from "node:timers";
-import { resolveSpawnCommand } from "@t3tools/shared/shell";
-import * as Effect from "effect/Effect";
-
-type JsonPrimitive = null | boolean | number | string;
-type JsonValue = JsonPrimitive | JsonValue[] | { [key: string]: JsonValue };
-
-type JsonRpcId = number | string;
-
-type JsonRpcMessage = {
-  jsonrpc?: string;
-  id?: JsonRpcId;
-  method?: string;
-  params?: JsonValue;
-  result?: JsonValue;
-  error?: JsonValue;
-  headers?: JsonValue;
-};
-
-type SelectLeafOption = {
-  value: string;
-  label?: string;
-  name?: string;
-};
-
-type SelectGroupOption = {
-  label?: string;
-  name?: string;
-  options: SelectLeafOption[];
-};
-
-type SessionConfigOption = {
-  id: string;
-  name?: string;
-  category?: string;
-  type?: string;
-  options?: Array<SelectLeafOption | SelectGroupOption>;
-};
-
-type SessionNewResult = {
-  sessionId: string;
-  configOptions?: SessionConfigOption[];
-};
-
-type SetConfigResult = {
-  configOptions?: SessionConfigOption[];
-};
-
-type PendingRequest = {
-  method: string;
-  resolve: (value: JsonValue | undefined) => void;
-  reject: (error: Error) => void;
-};
-
-const targetCwd = NodeProcess.argv[2] ?? NodeProcess.cwd();
-const targetModel = NodeProcess.argv[3] ?? "gpt-5.4";
-const promptText = NodeProcess.argv[4] ?? "helo";
-const targetReasoning = NodeProcess.env.CURSOR_REASONING ?? "";
-const targetContext = NodeProcess.env.CURSOR_CONTEXT ?? "";
-const targetFast = NodeProcess.env.CURSOR_FAST ?? "";
-const agentBin = NodeProcess.env.CURSOR_AGENT_BIN ?? "cursor-agent";
-const promptWaitMs = Number(NodeProcess.env.CURSOR_PROMPT_WAIT_MS ?? "4000");
-const requestTimeoutMs = Number(NodeProcess.env.CURSOR_REQUEST_TIMEOUT_MS ?? "20000");
-
-function logSection(title: string, value: unknown) {
-  NodeProcess.stdout.write(`\n=== ${title} ===\n`);
-  NodeProcess.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
-}
-
-function fail(message: string): never {
-  throw new Error(message);
-}
-
-function asString(value: JsonValue | undefined): string | null {
-  return typeof value === "string" ? value : null;
-}
-
-function flattenSelectValues(option: SessionConfigOption | undefined): string[] {
-  if (!option || option.type !== "select" || !Array.isArray(option.options)) {
-    return [];
-  }
-
-  const values: string[] = [];
-  for (const entry of option.options) {
-    if (!entry || typeof entry !== "object") {
-      continue;
-    }
-    if ("value" in entry && typeof entry.value === "string") {
-      values.push(entry.value);
-      continue;
-    }
-    if ("options" in entry && Array.isArray(entry.options)) {
-      for (const nested of entry.options) {
-        if (nested && typeof nested === "object" && typeof nested.value === "string") {
-          values.push(nested.value);
-        }
-      }
-    }
-  }
-  return values;
-}
-
-function findConfigOption(
-  configOptions: SessionConfigOption[],
-  predicate: (option: SessionConfigOption) => boolean,
-): SessionConfigOption | undefined {
-  return configOptions.find(predicate);
-}
-
-function matchesKeyword(option: SessionConfigOption, keyword: string): boolean {
-  const haystack = `${option.id} ${option.name ?? ""}`.toLowerCase();
-  return haystack.includes(keyword.toLowerCase());
-}
-
-function sleep(ms: number) {
-  return new Promise<void>((resolve) => {
-    // @effect-diagnostics-next-line globalTimers:off - Standalone Node probe script, not an Effect runtime test.
-    NodeTimers.setTimeout(resolve, ms);
-  });
-}
-
-class JsonRpcChild {
-  readonly child: NodeChildProcess.ChildProcessWithoutNullStreams;
-  readonly pending = new Map<JsonRpcId, PendingRequest>();
-  nextId = 1;
-  closed = false;
-
-  constructor(bin: string, args: string[], cwd: string) {
-    const spawnCommand = Effect.runSync(resolveSpawnCommand(bin, args));
-    this.child = NodeChildProcess.spawn(spawnCommand.command, spawnCommand.args, {
-      cwd,
-      shell: spawnCommand.shell,
-      stdio: ["pipe", "pipe", "pipe"],
-      env: NodeProcess.env,
-    });
-
-    this.child.on("exit", (code, signal) => {
-      this.closed = true;
-      const detail = `ACP process exited (code=${String(code)}, signal=${String(signal)})`;
-      for (const pending of this.pending.values()) {
-        pending.reject(new Error(`${detail} while waiting for ${pending.method}`));
-      }
-      this.pending.clear();
-    });
-
-    this.child.on("error", (error) => {
-      this.closed = true;
-      for (const pending of this.pending.values()) {
-        pending.reject(error);
-      }
-      this.pending.clear();
-    });
-
-    const stdout = NodeReadline.createInterface({ input: this.child.stdout });
-    stdout.on("line", (line) => {
-      void this.handleStdoutLine(line);
-    });
-
-    const stderr = NodeReadline.createInterface({ input: this.child.stderr });
-    stderr.on("line", (line) => {
-      NodeProcess.stdout.write(`[stderr] ${line}\n`);
-    });
-  }
-
-  write(message: JsonRpcMessage) {
-    if (this.closed) {
-      fail("ACP process is already closed.");
-    }
-    const payload = JSON.stringify({
-      jsonrpc: "2.0",
-      headers: [],
-      ...message,
-    });
-    NodeProcess.stdout.write(`>>> ${payload}\n`);
-    this.child.stdin.write(`${payload}\n`);
-  }
-
-  async request(method: string, params: JsonValue, timeoutMs = requestTimeoutMs) {
-    const id = this.nextId++;
-
-    const responsePromise = new Promise<JsonValue | undefined>((resolve, reject) => {
-      // @effect-diagnostics-next-line globalTimers:off - Standalone Node probe script request timeout.
-      const timeout = NodeTimers.setTimeout(() => {
-        this.pending.delete(id);
-        reject(new Error(`Timed out waiting for ${method} response after ${timeoutMs}ms.`));
-      }, timeoutMs);
-
-      this.pending.set(id, {
-        method,
-        resolve: (value) => {
-          NodeTimers.clearTimeout(timeout);
-          resolve(value);
-        },
-        reject: (error) => {
-          NodeTimers.clearTimeout(timeout);
-          reject(error);
-        },
-      });
-    });
-
-    this.write({
-      id,
-      method,
-      params,
-    });
-
-    return responsePromise;
-  }
-
-  notify(method: string, params: JsonValue) {
-    this.write({
-      method,
-      params,
-    });
-  }
-
-  respond(id: JsonRpcId, result: JsonValue) {
-    this.write({
-      id,
-      result,
-    });
-  }
-
-  respondError(id: JsonRpcId, code: number, message: string) {
-    this.write({
-      id,
-      error: {
-        code,
-        message,
-      },
-    });
-  }
-
-  async handleStdoutLine(line: string) {
-    if (line.trim().length === 0) {
-      return;
-    }
-
-    NodeProcess.stdout.write(`<<< ${line}\n`);
-
-    let message: JsonRpcMessage;
-    try {
-      message = JSON.parse(line) as JsonRpcMessage;
-    } catch (error) {
-      NodeProcess.stdout.write(`[parse-error] ${(error as Error).message}\n`);
-      return;
-    }
-
-    if (typeof message.id !== "undefined" && !message.method) {
-      const pending = this.pending.get(message.id);
-      if (!pending) {
-        return;
-      }
-      this.pending.delete(message.id);
-      if (typeof message.error !== "undefined") {
-        pending.reject(
-          new Error(`RPC ${pending.method} failed: ${JSON.stringify(message.error, null, 2)}`),
-        );
-        return;
-      }
-      pending.resolve(message.result);
-      return;
-    }
-
-    if (message.method === "session/request_permission" && typeof message.id !== "undefined") {
-      this.respond(message.id, {
-        outcome: {
-          outcome: "selected",
-          optionId: "allow",
-        },
-      });
-      return;
-    }
-
-    if (typeof message.id !== "undefined" && message.id !== "") {
-      this.respondError(
-        message.id,
-        -32601,
-        `Unhandled server request: ${message.method ?? "unknown"}`,
-      );
-    }
-  }
-
-  async close() {
-    if (this.closed) {
-      return;
-    }
-    this.child.kill("SIGTERM");
-    await sleep(250);
-    if (!this.closed) {
-      this.child.kill("SIGKILL");
-    }
-  }
-}
-
-async function setSelectOptionIfAdvertised(
-  rpc: JsonRpcChild,
-  sessionId: string,
-  configOptions: SessionConfigOption[],
-  predicate: (option: SessionConfigOption) => boolean,
-  value: string,
-  label: string,
-) {
-  if (value.length === 0) {
-    return configOptions;
-  }
-
-  const option = findConfigOption(configOptions, predicate);
-  const values = flattenSelectValues(option);
-  if (!option || !values.includes(value)) {
-    logSection(`SKIP_${label}`, {
-      requestedValue: value,
-      availableValues: values,
-    });
-    return configOptions;
-  }
-
-  const response = (await rpc.request("session/set_config_option", {
-    sessionId,
-    configId: option.id,
-    value,
-  })) as SetConfigResult | null | undefined;
-
-  logSection(`SET_${label}_RESPONSE`, response);
-  return response?.configOptions ?? configOptions;
-}
-
-async function main() {
-  const rpc = new JsonRpcChild(agentBin, ["acp"], targetCwd);
-
-  try {
-    const initializeResponse = await rpc.request("initialize", {
-      protocolVersion: 1,
-      clientCapabilities: {
-        fs: { readTextFile: false, writeTextFile: false },
-        terminal: false,
-        _meta: {
-          parameterizedModelPicker: true,
-        },
-      },
-      clientInfo: {
-        name: "cursor-acp-model-mismatch-probe",
-        version: "0.0.0",
-      },
-    });
-    logSection("INITIALIZE_RESPONSE", initializeResponse);
-
-    const authenticateResponse = await rpc.request("authenticate", {
-      methodId: "cursor_login",
-    });
-    logSection("AUTHENTICATE_RESPONSE", authenticateResponse);
-
-    const sessionResponse = (await rpc.request("session/new", {
-      cwd: targetCwd,
-      mcpServers: [],
-    })) as SessionNewResult;
-    logSection("SESSION_NEW_RESPONSE", sessionResponse);
-
-    const sessionId = asString(sessionResponse.sessionId);
-    if (!sessionId) {
-      fail("session/new did not return a sessionId.");
-    }
-
-    let configOptions = sessionResponse.configOptions ?? [];
-    const modelConfig = findConfigOption(configOptions, (option) => option.category === "model");
-    const advertisedModels = flattenSelectValues(modelConfig);
-    logSection("ADVERTISED_MODEL_VALUES", advertisedModels);
-
-    if (!modelConfig || modelConfig.type !== "select") {
-      fail("Cursor ACP did not expose a select-type model config option.");
-    }
-
-    if (!advertisedModels.includes(targetModel)) {
-      fail(
-        `Cursor ACP did not advertise model ${JSON.stringify(targetModel)}. Advertised values: ${advertisedModels.join(", ")}`,
-      );
-    }
-
-    const setModelResponse = (await rpc.request("session/set_config_option", {
-      sessionId,
-      configId: modelConfig.id,
-      value: targetModel,
-    })) as SetConfigResult | null | undefined;
-    logSection("SET_MODEL_RESPONSE", setModelResponse);
-
-    configOptions = setModelResponse?.configOptions ?? configOptions;
-
-    configOptions = await setSelectOptionIfAdvertised(
-      rpc,
-      sessionId,
-      configOptions,
-      (option) => option.category === "thought_level",
-      targetReasoning,
-      "REASONING",
-    );
-
-    configOptions = await setSelectOptionIfAdvertised(
-      rpc,
-      sessionId,
-      configOptions,
-      (option) => option.category === "model_config" && matchesKeyword(option, "context"),
-      targetContext,
-      "CONTEXT",
-    );
-
-    configOptions = await setSelectOptionIfAdvertised(
-      rpc,
-      sessionId,
-      configOptions,
-      (option) => option.category === "model_config" && matchesKeyword(option, "fast"),
-      targetFast,
-      "FAST",
-    );
-
-    const promptResponse = await rpc.request("session/prompt", {
-      sessionId,
-      prompt: [
-        {
-          type: "text",
-          text: promptText,
-        },
-      ],
-    });
-    logSection("PROMPT_RESPONSE", promptResponse);
-
-    await sleep(promptWaitMs);
-    rpc.notify("session/cancel", { sessionId });
-  } finally {
-    await rpc.close();
-  }
-}
-
-void main().catch((error: unknown) => {
-  NodeProcess.stderr.write(
-    `${error instanceof Error ? (error.stack ?? error.message) : String(error)}\n`,
-  );
-  process.exitCode = 1;
-});
diff --git a/apps/server/scripts/cursorReplayRecordingWorkspace.test.ts b/apps/server/scripts/cursorReplayRecordingWorkspace.test.ts
new file mode 100644
index 000000000000..d14f48326d29
--- /dev/null
+++ b/apps/server/scripts/cursorReplayRecordingWorkspace.test.ts
@@ -0,0 +1,44 @@
+import { assert, it } from "@effect/vitest";
+
+import {
+  cursorReplayPromptsForWorkspace,
+  cursorReplayTranscriptCwd,
+  shouldSeedCursorReplayWorkspace,
+} from "./cursorReplayRecordingWorkspace.ts";
+
+it("points the read-only prompt at the unique recording workspace", () => {
+  assert.deepEqual(
+    cursorReplayPromptsForWorkspace({
+      scenario: "tool_call_read_only",
+      configuredPrompts: ["stale global path"],
+      packageJsonPath: "/tmp/t3-cursor-owned-abc123/package.json",
+      tsconfigPath: "/tmp/t3-cursor-owned-abc123/tsconfig.json",
+    }),
+    [
+      "Read /tmp/t3-cursor-owned-abc123/package.json and /tmp/t3-cursor-owned-abc123/tsconfig.json, then answer exactly: read only tool fixture complete",
+    ],
+  );
+});
+
+it("never seeds files into an externally supplied workspace", () => {
+  assert.isFalse(
+    shouldSeedCursorReplayWorkspace({
+      scenario: "tool_call_read_only",
+      owned: false,
+    }),
+  );
+  assert.isTrue(
+    shouldSeedCursorReplayWorkspace({
+      scenario: "tool_call_read_only",
+      owned: true,
+    }),
+  );
+});
+
+it("canonicalizes read-only tool paths to the stable fixture workspace", () => {
+  assert.equal(
+    cursorReplayTranscriptCwd("tool_call_read_only"),
+    "/tmp/claude-replay-tool_call_read_only",
+  );
+  assert.equal(cursorReplayTranscriptCwd("simple"), undefined);
+});
diff --git a/apps/server/scripts/cursorReplayRecordingWorkspace.ts b/apps/server/scripts/cursorReplayRecordingWorkspace.ts
new file mode 100644
index 000000000000..bd8f363f2535
--- /dev/null
+++ b/apps/server/scripts/cursorReplayRecordingWorkspace.ts
@@ -0,0 +1,29 @@
+import { TOOL_CALL_READ_ONLY_WORKSPACE_ROOT } from "../src/orchestration-v2/testkit/fixtures/shared.ts";
+
+const SEEDED_CURSOR_REPLAY_SCENARIOS = new Set(["subagent", "tool_call_read_only", "todo_list"]);
+
+export function cursorReplayPromptsForWorkspace(input: {
+  readonly scenario: string;
+  readonly configuredPrompts: ReadonlyArray<string>;
+  readonly packageJsonPath: string;
+  readonly tsconfigPath: string;
+}): ReadonlyArray<string> {
+  if (input.scenario !== "tool_call_read_only") {
+    return input.configuredPrompts;
+  }
+
+  return [
+    `Read ${input.packageJsonPath} and ${input.tsconfigPath}, then answer exactly: read only tool fixture complete`,
+  ];
+}
+
+export function shouldSeedCursorReplayWorkspace(input: {
+  readonly scenario: string;
+  readonly owned: boolean;
+}): boolean {
+  return input.owned && SEEDED_CURSOR_REPLAY_SCENARIOS.has(input.scenario);
+}
+
+export function cursorReplayTranscriptCwd(scenario: string): string | undefined {
+  return scenario === "tool_call_read_only" ? TOOL_CALL_READ_ONLY_WORKSPACE_ROOT : undefined;
+}
diff --git a/apps/server/scripts/probe-claude-fork-local-rollback-replay.ts b/apps/server/scripts/probe-claude-fork-local-rollback-replay.ts
new file mode 100644
index 000000000000..e5a233dcc5c8
--- /dev/null
+++ b/apps/server/scripts/probe-claude-fork-local-rollback-replay.ts
@@ -0,0 +1,358 @@
+import {
+  forkSession,
+  query,
+  type SDKAssistantMessage,
+  type SDKMessage,
+} from "@anthropic-ai/claude-agent-sdk";
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import { ProviderInstanceId, type ProviderReplayEntry } from "@t3tools/contracts";
+import * as Console from "effect/Console";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+
+import {
+  makeClaudeQueryOptions,
+  makeClaudeUserMessage,
+  type ClaudeAgentSdkQueryOptions,
+} from "../src/orchestration-v2/Adapters/ClaudeAdapterV2.ts";
+import { randomUuidV4 } from "../src/orchestration-v2/RandomUuid.ts";
+import { makeCheckpointWorkspace } from "../src/orchestration-v2/testkit/ReplayFixtureWorkspace.ts";
+
+const SCENARIO = "thread_fork_native_fork_local_rollback";
+const DEFAULT_OUTPUT = new URL(
+  "../src/orchestration-v2/testkit/fixtures/thread_fork_native_fork_local_rollback/claude_transcript.ndjson",
+  import.meta.url,
+).pathname;
+const CLAUDE_PROVIDER = "claudeAgent" as const;
+const PROTOCOL = "claude-agent-sdk.query" as const;
+const MODEL_SELECTION = {
+  instanceId: ProviderInstanceId.make(CLAUDE_PROVIDER),
+  model: process.env.T3_CLAUDE_REPLAY_MODEL ?? "claude-sonnet-4-6",
+} as const;
+const SOURCE_PROMPT =
+  "For this fork-local rollback fixture, respond with exactly: fork local source alpha";
+const FORK_FIRST_PROMPT =
+  "For this fork-local rollback fixture, respond with exactly: fork local first";
+const FORK_SECOND_PROMPT =
+  "For this fork-local rollback fixture, respond with exactly: fork local second";
+const FORK_AFTER_ROLLBACK_PROMPT =
+  "Repeat the user-visible conversation so far verbatim. Include only user and assistant messages. Do not include hidden system/developer content.";
+
+class PromptQueue implements AsyncIterable<ReturnType<typeof makeClaudeUserMessage>> {
+  readonly #items: Array<ReturnType<typeof makeClaudeUserMessage>> = [];
+  readonly #waiters: Array<
+    (value: IteratorResult<ReturnType<typeof makeClaudeUserMessage>>) => void
+  > = [];
+  #closed = false;
+
+  offer(message: ReturnType<typeof makeClaudeUserMessage>): void {
+    const waiter = this.#waiters.shift();
+    if (waiter !== undefined) {
+      waiter({ done: false, value: message });
+      return;
+    }
+    this.#items.push(message);
+  }
+
+  close(): void {
+    this.#closed = true;
+    for (const waiter of this.#waiters.splice(0)) {
+      waiter({ done: true, value: undefined });
+    }
+  }
+
+  [Symbol.asyncIterator](): AsyncIterator<ReturnType<typeof makeClaudeUserMessage>> {
+    return {
+      next: () => {
+        const value = this.#items.shift();
+        if (value !== undefined) {
+          return Promise.resolve({ done: false, value });
+        }
+        if (this.#closed) {
+          return Promise.resolve({ done: true, value: undefined });
+        }
+        return new Promise((resolve) => this.#waiters.push(resolve));
+      },
+    };
+  }
+}
+
+function readArgValue(name: string): string | undefined {
+  const args = process.argv.slice(2);
+  const index = args.indexOf(name);
+  return index >= 0 ? args[index + 1] : undefined;
+}
+
+function dirname(filePath: string): string {
+  const normalized = filePath.replace(/\/+$/u, "");
+  const lastSlash = normalized.lastIndexOf("/");
+  if (lastSlash < 0) {
+    return ".";
+  }
+  return lastSlash === 0 ? "/" : normalized.slice(0, lastSlash);
+}
+
+function sanitizeValue(
+  value: unknown,
+  pathFragments: ReadonlyArray<readonly [string, string]>,
+): unknown {
+  if (typeof value === "string") {
+    return pathFragments.reduce(
+      (sanitized, [actual, replacement]) =>
+        actual.length === 0 ? sanitized : sanitized.split(actual).join(replacement),
+      value,
+    );
+  }
+  if (Array.isArray(value)) {
+    return value.map((entry) => sanitizeValue(entry, pathFragments));
+  }
+  if (typeof value === "object" && value !== null) {
+    return Object.fromEntries(
+      Object.entries(value).map(([key, entry]) => [key, sanitizeValue(entry, pathFragments)]),
+    );
+  }
+  return value;
+}
+
+function stableOptions(options: ClaudeAgentSdkQueryOptions): ClaudeAgentSdkQueryOptions {
+  const stable = {
+    model: options.model,
+    tools: options.tools,
+    permissionMode: options.permissionMode,
+    ...(options.allowedTools === undefined ? {} : { allowedTools: options.allowedTools }),
+    ...(options.disallowedTools === undefined ? {} : { disallowedTools: options.disallowedTools }),
+    ...(options.settings === undefined ? {} : { settings: options.settings }),
+    ...(options.allowDangerouslySkipPermissions === true
+      ? { allowDangerouslySkipPermissions: true }
+      : {}),
+    ...(options.resumeSessionAt === undefined ? {} : { resumeSessionAt: options.resumeSessionAt }),
+    ...(options.forkSession === true ? { forkSession: true } : {}),
+  };
+  return options.resume === undefined
+    ? { ...stable, sessionId: options.sessionId }
+    : { ...stable, resume: options.resume };
+}
+
+function queryOptions(input: {
+  readonly cwd: string;
+  readonly nativeThreadId: string;
+  readonly resume: boolean;
+  readonly resumeSessionAt?: string;
+}): ClaudeAgentSdkQueryOptions {
+  return {
+    ...makeClaudeQueryOptions({
+      modelSelection: MODEL_SELECTION,
+      cwd: input.cwd,
+      nativeThreadId: input.nativeThreadId,
+      resume: input.resume,
+      tools: { type: "preset", preset: "claude_code" },
+      permissionMode: "bypassPermissions",
+      allowDangerouslySkipPermissions: true,
+    }),
+    ...(input.resumeSessionAt === undefined ? {} : { resumeSessionAt: input.resumeSessionAt }),
+  };
+}
+
+async function recordTurn(input: {
+  readonly entries: Array<ProviderReplayEntry>;
+  readonly iterator: AsyncIterator<SDKMessage>;
+  readonly promptQueue: PromptQueue;
+  readonly prompt: string;
+  readonly label: string;
+  readonly pathFragments: ReadonlyArray<readonly [string, string]>;
+}): Promise<SDKAssistantMessage["uuid"]> {
+  const message = makeClaudeUserMessage({ text: input.prompt });
+  input.entries.push({
+    type: "expect_outbound",
+    label: input.label,
+    frame: { type: "prompt.offer", message },
+  });
+  input.promptQueue.offer(message);
+
+  let assistantMessageUuid: SDKAssistantMessage["uuid"] | null = null;
+  while (true) {
+    const next = await input.iterator.next();
+    if (next.done === true) {
+      throw new Error(`Claude query ended before ${input.label} completed.`);
+    }
+    const frame = sanitizeValue(next.value, input.pathFragments);
+    input.entries.push({
+      type: "emit_inbound",
+      label: next.value.type,
+      frame,
+    });
+    if (next.value.type === "assistant") {
+      assistantMessageUuid = next.value.uuid;
+    }
+    if (next.value.type === "result") {
+      if (assistantMessageUuid === null) {
+        throw new Error(`Claude query completed ${input.label} without assistant UUID.`);
+      }
+      return assistantMessageUuid;
+    }
+  }
+}
+
+function encodeTranscript(input: {
+  readonly entries: ReadonlyArray<ProviderReplayEntry>;
+  readonly metadata: Record<string, unknown>;
+}): string {
+  return [
+    JSON.stringify({
+      type: "transcript_start",
+      provider: CLAUDE_PROVIDER,
+      protocol: PROTOCOL,
+      version: "0.2.111",
+      scenario: SCENARIO,
+      metadata: input.metadata,
+    }),
+    ...input.entries.map((entry) => JSON.stringify(entry)),
+    "",
+  ].join("\n");
+}
+
+const outputPath = readArgValue("--out") ?? DEFAULT_OUTPUT;
+const cwd =
+  process.env.T3_CLAUDE_REPLAY_CWD ??
+  (await makeCheckpointWorkspace(`claude-agent-sdk-record-${SCENARIO}`));
+const cwdRealPath = await Effect.runPromise(
+  Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    return yield* fs.realPath(cwd);
+  }).pipe(Effect.provide(NodeServices.layer)),
+);
+const pathFragments = [
+  [cwd, `/tmp/claude-replay-${SCENARIO}`],
+  [cwdRealPath, `/tmp/claude-replay-${SCENARIO}`],
+  [process.env.HOME ?? "", "/home/replay-user"],
+] as const;
+const sessionId =
+  process.env.T3_CLAUDE_REPLAY_SESSION_ID ?? (await Effect.runPromise(randomUuidV4));
+const entries: Array<ProviderReplayEntry> = [];
+const metadata: Record<string, unknown> = {
+  prompts: [SOURCE_PROMPT, FORK_FIRST_PROMPT, FORK_SECOND_PROMPT, FORK_AFTER_ROLLBACK_PROMPT],
+  model: MODEL_SELECTION.model,
+  nativeSessionId: sessionId,
+  queryMode: "fork_session_resume_at_fork_cursor",
+  tools: "claude_code",
+  permissionMode: "bypassPermissions",
+  generatedBy: "probeClaudeForkLocalRollbackReplay",
+};
+
+const sourceQueue = new PromptQueue();
+const sourceOptions = queryOptions({ cwd, nativeThreadId: sessionId, resume: false });
+entries.push({
+  type: "expect_outbound",
+  label: "query.open:source",
+  frame: { type: "query.open", options: stableOptions(sourceOptions) },
+});
+const sourceRuntime = query({ prompt: sourceQueue, options: sourceOptions });
+try {
+  const sourceCursor = await recordTurn({
+    entries,
+    iterator: sourceRuntime[Symbol.asyncIterator](),
+    promptQueue: sourceQueue,
+    prompt: SOURCE_PROMPT,
+    label: "prompt.offer:source",
+    pathFragments,
+  });
+  sourceQueue.close();
+  sourceRuntime.close();
+  entries.push({ type: "runtime_exit", status: "success" });
+
+  entries.push({
+    type: "expect_outbound",
+    label: "session.fork",
+    frame: {
+      type: "session.fork",
+      sessionId,
+      options: {
+        dir: `/tmp/claude-replay-${SCENARIO}`,
+        upToMessageId: sourceCursor,
+      },
+    },
+  });
+  const forked = await forkSession(sessionId, { dir: cwd, upToMessageId: sourceCursor });
+  metadata.sourceAssistantMessageUuids = [sourceCursor];
+  metadata.forkUpToMessageId = sourceCursor;
+  metadata.forkedNativeSessionId = forked.sessionId;
+  entries.push({
+    type: "emit_inbound",
+    label: "session.forked",
+    frame: { type: "session.forked", sessionId: forked.sessionId },
+  });
+
+  const forkQueue = new PromptQueue();
+  const forkOptions = queryOptions({ cwd, nativeThreadId: forked.sessionId, resume: true });
+  entries.push({
+    type: "expect_outbound",
+    label: "query.open:fork",
+    frame: { type: "query.open", options: stableOptions(forkOptions) },
+  });
+  const forkRuntime = query({ prompt: forkQueue, options: forkOptions });
+  const forkIterator = forkRuntime[Symbol.asyncIterator]();
+  const forkFirstCursor = await recordTurn({
+    entries,
+    iterator: forkIterator,
+    promptQueue: forkQueue,
+    prompt: FORK_FIRST_PROMPT,
+    label: "prompt.offer:fork-first",
+    pathFragments,
+  });
+  const forkSecondCursor = await recordTurn({
+    entries,
+    iterator: forkIterator,
+    promptQueue: forkQueue,
+    prompt: FORK_SECOND_PROMPT,
+    label: "prompt.offer:fork-second",
+    pathFragments,
+  });
+  forkQueue.close();
+  forkRuntime.close();
+  entries.push({ type: "runtime_exit", status: "success" });
+  metadata.forkAssistantMessageUuids = [forkFirstCursor, forkSecondCursor];
+  metadata.resumeSessionAt = forkFirstCursor;
+
+  const resumedQueue = new PromptQueue();
+  const resumedOptions = queryOptions({
+    cwd,
+    nativeThreadId: forked.sessionId,
+    resume: true,
+    resumeSessionAt: forkFirstCursor,
+  });
+  entries.push({
+    type: "expect_outbound",
+    label: "query.open:fork-resume-at-cursor",
+    frame: { type: "query.open", options: stableOptions(resumedOptions) },
+  });
+  const resumedRuntime = query({ prompt: resumedQueue, options: resumedOptions });
+  await recordTurn({
+    entries,
+    iterator: resumedRuntime[Symbol.asyncIterator](),
+    promptQueue: resumedQueue,
+    prompt: FORK_AFTER_ROLLBACK_PROMPT,
+    label: "prompt.offer:fork-after-rollback",
+    pathFragments,
+  });
+  resumedQueue.close();
+  resumedRuntime.close();
+  entries.push({ type: "runtime_exit", status: "success" });
+} catch (error) {
+  sourceQueue.close();
+  sourceRuntime.close();
+  entries.push({
+    type: "runtime_exit",
+    status: "error",
+    error: error instanceof Error ? error.message : String(error),
+  });
+  throw error;
+}
+
+await Effect.runPromise(
+  Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    yield* fs.makeDirectory(dirname(outputPath), { recursive: true });
+    yield* fs.writeFileString(outputPath, encodeTranscript({ entries, metadata }));
+    yield* Console.log(`Wrote ${entries.length} ${PROTOCOL} replay entries to ${outputPath}`);
+  }).pipe(Effect.provide(NodeServices.layer)),
+);
diff --git a/apps/server/scripts/record-claude-agent-sdk-replay-fixture.ts b/apps/server/scripts/record-claude-agent-sdk-replay-fixture.ts
new file mode 100644
index 000000000000..0aff87a35c92
--- /dev/null
+++ b/apps/server/scripts/record-claude-agent-sdk-replay-fixture.ts
@@ -0,0 +1,444 @@
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import * as Console from "effect/Console";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Schema from "effect/Schema";
+
+import {
+  recordClaudeAgentSdkReplayTranscript,
+  CLAUDE_AGENT_SDK_REPLAY_PROTOCOL,
+} from "../src/orchestration-v2/Adapters/ClaudeAdapterV2.testkit.ts";
+import { claudeRuntimeQueryPolicyForRuntimePolicy } from "../src/orchestration-v2/Adapters/ClaudeAdapterV2.ts";
+import {
+  ProviderAdapterV2RuntimePolicy,
+  type ProviderAdapterV2RuntimePolicy as ProviderAdapterV2RuntimePolicyType,
+} from "../src/orchestration-v2/ProviderAdapter.ts";
+import type { RuntimePolicyV2Override } from "../src/orchestration-v2/RuntimePolicy.ts";
+import { makeCheckpointWorkspace } from "../src/orchestration-v2/testkit/ReplayFixtureWorkspace.ts";
+import { CLAUDE_MODEL_SELECTION } from "../src/orchestration-v2/testkit/fixtures/shared.ts";
+import {
+  MESSAGE_STEERING_INITIAL_PROMPT,
+  MULTI_TURN_FIRST_PROMPT,
+  MESSAGE_STEERING_STEER_PROMPT,
+  READ_ONLY_NEVER_POLICY,
+  READ_ONLY_ON_REQUEST_POLICY,
+  RESTRICTED_GRANULAR_POLICY,
+  MULTI_TURN_SECOND_PROMPT,
+  SIMPLE_PROMPT,
+  SUBAGENT_PROMPT,
+  THREAD_FORK_NATIVE_PRIOR_TURN_ALPHA_PROMPT,
+  THREAD_FORK_NATIVE_PRIOR_TURN_BETA_PROMPT,
+  THREAD_FORK_NATIVE_PRIOR_TURN_REPEAT_PROMPT,
+  THREAD_FORK_NATIVE_CONTINUE_FIRST_PROMPT,
+  THREAD_FORK_NATIVE_CONTINUE_SECOND_PROMPT,
+  THREAD_FORK_NATIVE_CONTINUE_SOURCE_PROMPT,
+  THREAD_FORK_NATIVE_SIBLINGS_FIRST_PROMPT,
+  THREAD_FORK_NATIVE_SIBLINGS_SECOND_PROMPT,
+  THREAD_FORK_NATIVE_SIBLINGS_SOURCE_PROMPT,
+  THREAD_FORK_NATIVE_SOURCE_PROMPT,
+  THREAD_FORK_NATIVE_TARGET_PROMPT,
+  THREAD_MERGE_BACK_FORK_PROMPT,
+  THREAD_MERGE_BACK_HANDOFF_PROMPT,
+  THREAD_MERGE_BACK_RECALL_PROMPT,
+  THREAD_MERGE_BACK_SIBLINGS_FIRST_FORK_PROMPT,
+  THREAD_MERGE_BACK_SIBLINGS_FIRST_HANDOFF_PROMPT,
+  THREAD_MERGE_BACK_SIBLINGS_RECALL_PROMPT,
+  THREAD_MERGE_BACK_SIBLINGS_SECOND_FORK_PROMPT,
+  THREAD_MERGE_BACK_SIBLINGS_SECOND_HANDOFF_PROMPT,
+  THREAD_MERGE_BACK_SIBLINGS_SOURCE_PROMPT,
+  THREAD_MERGE_BACK_SOURCE_PROMPT,
+  THREAD_ROLLBACK_AFTER_PROMPT,
+  THREAD_ROLLBACK_FIRST_PROMPT,
+  THREAD_ROLLBACK_SECOND_PROMPT,
+  TOOL_CALL_READ_ONLY_PROMPT,
+  TOOL_CALL_READ_ONLY_WORKSPACE_ROOT,
+  TOOL_CALL_WRITE_PROMPT,
+  TURN_INTERRUPT_MID_TOOL_PROMPT,
+  TURN_INTERRUPT_PROMPT,
+  TURN_INTERRUPT_RECOVERY_PROMPT,
+  WORKSPACE_NEVER_POLICY,
+  WEB_SEARCH_PROMPT,
+} from "../src/orchestration-v2/testkit/fixtures/shared.ts";
+import {
+  validateClaudeReplayRecordingSelection,
+  type ClaudeRecordingQueryMode,
+} from "./claudeReplayRecordingConfig.ts";
+
+const CLAUDE_RECORDINGS = {
+  simple: {
+    prompts: [SIMPLE_PROMPT],
+    defaultTranscriptFile: "fixtures/simple/claude_transcript.ndjson",
+    queryMode: "streaming",
+    enableTools: true,
+  },
+  multi_turn: {
+    prompts: [MULTI_TURN_FIRST_PROMPT, MULTI_TURN_SECOND_PROMPT],
+    defaultTranscriptFile: "fixtures/multi_turn/claude_transcript.ndjson",
+    queryMode: "streaming",
+    enableTools: true,
+  },
+  multi_turn_restart: {
+    prompts: [MULTI_TURN_FIRST_PROMPT, MULTI_TURN_SECOND_PROMPT],
+    defaultTranscriptFile: "fixtures/multi_turn_restart/claude_transcript.ndjson",
+    queryMode: "restart",
+    enableTools: true,
+  },
+  queued_turn: {
+    prompts: [MULTI_TURN_FIRST_PROMPT, MULTI_TURN_SECOND_PROMPT],
+    defaultTranscriptFile: "fixtures/queued_turn/claude_transcript.ndjson",
+    queryMode: "streaming",
+    enableTools: true,
+  },
+  message_steering: {
+    prompts: [MESSAGE_STEERING_INITIAL_PROMPT, MESSAGE_STEERING_STEER_PROMPT],
+    defaultTranscriptFile: "fixtures/message_steering/claude_transcript.ndjson",
+    queryMode: "active_steering",
+    enableTools: true,
+  },
+  turn_interrupt_mid_tool: {
+    prompts: [TURN_INTERRUPT_MID_TOOL_PROMPT],
+    defaultTranscriptFile: "fixtures/turn_interrupt_mid_tool/claude_transcript.ndjson",
+    queryMode: "interrupt",
+    enableTools: true,
+    interruptAfter: "tool_use",
+  },
+  turn_interrupt: {
+    prompts: [TURN_INTERRUPT_PROMPT],
+    defaultTranscriptFile: "fixtures/turn_interrupt/claude_transcript.ndjson",
+    queryMode: "interrupt",
+    enableTools: true,
+  },
+  turn_interrupt_restart: {
+    prompts: [TURN_INTERRUPT_MID_TOOL_PROMPT, TURN_INTERRUPT_RECOVERY_PROMPT],
+    defaultTranscriptFile: "fixtures/turn_interrupt_restart/claude_transcript.ndjson",
+    queryMode: "interrupt_restart",
+    enableTools: true,
+    interruptAfter: "tool_use",
+  },
+  tool_call_read_only: {
+    prompts: [TOOL_CALL_READ_ONLY_PROMPT],
+    defaultTranscriptFile: "fixtures/tool_call_read_only/claude_transcript.ndjson",
+    queryMode: "streaming",
+    enableTools: true,
+    runtimePolicyOverride: READ_ONLY_NEVER_POLICY,
+  },
+  tool_call_read_only_on_request: {
+    prompts: [TOOL_CALL_WRITE_PROMPT],
+    defaultTranscriptFile: "fixtures/tool_call_read_only_on_request/claude_transcript.ndjson",
+    queryMode: "streaming",
+    enableTools: true,
+    runtimePolicyOverride: READ_ONLY_ON_REQUEST_POLICY,
+  },
+  tool_call_workspace_never: {
+    prompts: [TOOL_CALL_WRITE_PROMPT],
+    defaultTranscriptFile: "fixtures/tool_call_workspace_never/claude_transcript.ndjson",
+    queryMode: "streaming",
+    enableTools: true,
+    runtimePolicyOverride: WORKSPACE_NEVER_POLICY,
+  },
+  tool_call_restricted_granular: {
+    prompts: [TOOL_CALL_WRITE_PROMPT],
+    defaultTranscriptFile: "fixtures/tool_call_restricted_granular/claude_transcript.ndjson",
+    queryMode: "streaming",
+    enableTools: true,
+    runtimePolicyOverride: RESTRICTED_GRANULAR_POLICY,
+  },
+  web_search: {
+    prompts: [WEB_SEARCH_PROMPT],
+    defaultTranscriptFile: "fixtures/web_search/claude_transcript.ndjson",
+    queryMode: "streaming",
+    enableTools: true,
+  },
+  subagent: {
+    prompts: [SUBAGENT_PROMPT],
+    defaultTranscriptFile: "fixtures/subagent/claude_transcript.ndjson",
+    queryMode: "streaming",
+    enableTools: true,
+  },
+  thread_rollback: {
+    prompts: [
+      THREAD_ROLLBACK_FIRST_PROMPT,
+      THREAD_ROLLBACK_SECOND_PROMPT,
+      THREAD_ROLLBACK_AFTER_PROMPT,
+    ],
+    defaultTranscriptFile: "fixtures/thread_rollback/claude_transcript.ndjson",
+    queryMode: "resume_at_cursor",
+    enableTools: true,
+  },
+  thread_fork_native: {
+    prompts: [THREAD_FORK_NATIVE_SOURCE_PROMPT, THREAD_FORK_NATIVE_TARGET_PROMPT],
+    defaultTranscriptFile: "fixtures/thread_fork_native/claude_transcript.ndjson",
+    queryMode: "fork_session",
+    enableTools: true,
+  },
+  thread_fork_native_prior_turn: {
+    prompts: [
+      THREAD_FORK_NATIVE_PRIOR_TURN_ALPHA_PROMPT,
+      THREAD_FORK_NATIVE_PRIOR_TURN_BETA_PROMPT,
+      THREAD_FORK_NATIVE_PRIOR_TURN_REPEAT_PROMPT,
+    ],
+    defaultTranscriptFile: "fixtures/thread_fork_native_prior_turn/claude_transcript.ndjson",
+    queryMode: "fork_session_prior_turn",
+    enableTools: true,
+  },
+  thread_fork_native_continue: {
+    prompts: [
+      THREAD_FORK_NATIVE_CONTINUE_SOURCE_PROMPT,
+      THREAD_FORK_NATIVE_CONTINUE_FIRST_PROMPT,
+      THREAD_FORK_NATIVE_CONTINUE_SECOND_PROMPT,
+    ],
+    defaultTranscriptFile: "fixtures/thread_fork_native_continue/claude_transcript.ndjson",
+    queryMode: "fork_session_continue",
+    enableTools: true,
+  },
+  thread_fork_native_siblings: {
+    prompts: [
+      THREAD_FORK_NATIVE_SIBLINGS_SOURCE_PROMPT,
+      THREAD_FORK_NATIVE_SIBLINGS_FIRST_PROMPT,
+      THREAD_FORK_NATIVE_SIBLINGS_SECOND_PROMPT,
+    ],
+    defaultTranscriptFile: "fixtures/thread_fork_native_siblings/claude_transcript.ndjson",
+    queryMode: "fork_session_siblings",
+    enableTools: true,
+  },
+  thread_merge_back_continue: {
+    prompts: [
+      THREAD_MERGE_BACK_SOURCE_PROMPT,
+      THREAD_MERGE_BACK_FORK_PROMPT,
+      THREAD_MERGE_BACK_HANDOFF_PROMPT,
+      THREAD_MERGE_BACK_RECALL_PROMPT,
+    ],
+    defaultTranscriptFile: "fixtures/thread_merge_back_continue/claude_transcript.ndjson",
+    queryMode: "fork_session_merge_back",
+    enableTools: true,
+  },
+  thread_merge_back_siblings: {
+    prompts: [
+      THREAD_MERGE_BACK_SIBLINGS_SOURCE_PROMPT,
+      THREAD_MERGE_BACK_SIBLINGS_FIRST_FORK_PROMPT,
+      THREAD_MERGE_BACK_SIBLINGS_SECOND_FORK_PROMPT,
+      THREAD_MERGE_BACK_SIBLINGS_FIRST_HANDOFF_PROMPT,
+      THREAD_MERGE_BACK_SIBLINGS_SECOND_HANDOFF_PROMPT,
+      THREAD_MERGE_BACK_SIBLINGS_RECALL_PROMPT,
+    ],
+    defaultTranscriptFile: "fixtures/thread_merge_back_siblings/claude_transcript.ndjson",
+    queryMode: "fork_session_merge_back_siblings",
+    enableTools: true,
+  },
+} as const;
+
+function readArgValue(name: string): string | undefined {
+  const args = process.argv.slice(2);
+  const index = args.indexOf(name);
+  return index >= 0 ? args[index + 1] : undefined;
+}
+
+function selectedQueryMode(defaultMode: ClaudeRecordingQueryMode): ClaudeRecordingQueryMode {
+  const raw = readArgValue("--query-mode") ?? process.env.T3_CLAUDE_REPLAY_QUERY_MODE;
+  if (raw === undefined) {
+    return defaultMode;
+  }
+  if (
+    raw === "streaming" ||
+    raw === "restart" ||
+    raw === "resume_at_cursor" ||
+    raw === "fork_session" ||
+    raw === "fork_session_prior_turn" ||
+    raw === "fork_session_continue" ||
+    raw === "fork_session_siblings" ||
+    raw === "fork_session_merge_back" ||
+    raw === "fork_session_merge_back_siblings" ||
+    raw === "active_steering" ||
+    raw === "interrupt" ||
+    raw === "interrupt_restart"
+  ) {
+    return raw;
+  }
+  throw new Error(
+    `Unsupported Claude replay query mode '${raw}'. Use 'streaming', 'restart', 'resume_at_cursor', 'fork_session', 'fork_session_prior_turn', 'fork_session_continue', 'fork_session_siblings', 'fork_session_merge_back', 'fork_session_merge_back_siblings', 'active_steering', 'interrupt', or 'interrupt_restart'.`,
+  );
+}
+
+const scenario = readArgValue("--scenario") ?? process.env.T3_CLAUDE_REPLAY_SCENARIO ?? "simple";
+const recording = CLAUDE_RECORDINGS[scenario as keyof typeof CLAUDE_RECORDINGS];
+const encodeUnknownJsonString = Schema.encodeSync(Schema.fromJsonString(Schema.Unknown));
+
+if (recording === undefined) {
+  throw new Error(
+    `Claude replay fixture '${scenario}' is not configured. ` +
+      "TODO: approval fixtures need permission callback recording before they can be generated.",
+  );
+}
+
+const positionalOutputPath = process.argv[2]?.startsWith("--") ? undefined : process.argv[2];
+const outputPath =
+  readArgValue("--out") ??
+  positionalOutputPath ??
+  new URL(`../src/orchestration-v2/testkit/${recording.defaultTranscriptFile}`, import.meta.url)
+    .pathname;
+
+function encodeTranscriptNdjson(
+  transcript: Awaited<ReturnType<typeof recordClaudeAgentSdkReplayTranscript>>,
+): string {
+  const { entries, ...metadata } = transcript;
+  return [
+    JSON.stringify({ type: "transcript_start", ...metadata }),
+    ...entries.map((entry) => JSON.stringify(entry)),
+    "",
+  ].join("\n");
+}
+
+function dirname(filePath: string): string {
+  const normalized = filePath.replace(/\/+$/u, "");
+  const lastSlash = normalized.lastIndexOf("/");
+  if (lastSlash < 0) {
+    return ".";
+  }
+  return lastSlash === 0 ? "/" : normalized.slice(0, lastSlash);
+}
+
+function joinPath(directory: string, fileName: string): string {
+  return `${directory.replace(/\/+$/u, "")}/${fileName.replace(/^\/+/u, "")}`;
+}
+
+function runFileSystem<A, E>(effect: Effect.Effect<A, E, FileSystem.FileSystem>): Promise<A> {
+  return Effect.runPromise(effect.pipe(Effect.provide(NodeServices.layer)));
+}
+
+function selectedPrompts(): ReadonlyArray<string> {
+  if (process.env.T3_CLAUDE_REPLAY_PROMPTS !== undefined) {
+    return process.env.T3_CLAUDE_REPLAY_PROMPTS.split("\n---\n").filter(
+      (prompt) => prompt.length > 0,
+    );
+  }
+  if (process.env.T3_CLAUDE_REPLAY_PROMPT !== undefined) {
+    return [process.env.T3_CLAUDE_REPLAY_PROMPT];
+  }
+  return recording.prompts;
+}
+
+const prompts = selectedPrompts();
+const queryMode = selectedQueryMode(recording.queryMode);
+validateClaudeReplayRecordingSelection({
+  scenario,
+  configuredQueryMode: recording.queryMode,
+  selectedQueryMode: queryMode,
+  configuredPromptCount: recording.prompts.length,
+  selectedPromptCount: prompts.length,
+});
+
+function runtimePolicyForRecording(input: {
+  readonly cwd: string;
+  readonly override?: RuntimePolicyV2Override;
+}): ProviderAdapterV2RuntimePolicyType {
+  return ProviderAdapterV2RuntimePolicy.make({
+    runtimeMode: "full-access",
+    interactionMode: "default",
+    cwd: input.override?.cwd ?? input.cwd,
+    ...(input.override?.approvalPolicy === undefined
+      ? {}
+      : { approvalPolicy: input.override.approvalPolicy }),
+    ...(input.override?.sandboxPolicy === undefined
+      ? {}
+      : { sandboxPolicy: input.override.sandboxPolicy }),
+    ...(input.override?.reasoningEffort === undefined
+      ? {}
+      : { reasoningEffort: input.override.reasoningEffort }),
+  });
+}
+
+async function makeToolCallReadOnlyRecordingWorkspace(): Promise<string> {
+  await runFileSystem(
+    Effect.gen(function* () {
+      const fs = yield* FileSystem.FileSystem;
+      yield* fs.remove(TOOL_CALL_READ_ONLY_WORKSPACE_ROOT, { recursive: true, force: true });
+      yield* fs.makeDirectory(TOOL_CALL_READ_ONLY_WORKSPACE_ROOT, { recursive: true });
+    }),
+  );
+  return TOOL_CALL_READ_ONLY_WORKSPACE_ROOT;
+}
+
+const cwd =
+  process.env.T3_CLAUDE_REPLAY_CWD ??
+  (scenario === "tool_call_read_only"
+    ? await makeToolCallReadOnlyRecordingWorkspace()
+    : await makeCheckpointWorkspace(`claude-agent-sdk-record-${scenario}`));
+const shouldRemoveCwd = process.env.T3_CLAUDE_REPLAY_CWD === undefined;
+
+if (shouldRemoveCwd && (scenario === "tool_call_read_only" || scenario === "subagent")) {
+  await runFileSystem(
+    Effect.gen(function* () {
+      const fs = yield* FileSystem.FileSystem;
+      yield* fs.writeFileString(
+        joinPath(cwd, "package.json"),
+        encodeUnknownJsonString({
+          name: "claude-read-only-fixture",
+          private: true,
+          scripts: { typecheck: "tsc --noEmit" },
+        }),
+      );
+      yield* fs.writeFileString(
+        joinPath(cwd, "tsconfig.json"),
+        encodeUnknownJsonString({
+          compilerOptions: {
+            module: "ESNext",
+            strict: true,
+            target: "ES2022",
+          },
+        }),
+      );
+    }),
+  );
+}
+
+try {
+  const runtimePolicy = runtimePolicyForRecording({
+    cwd,
+    ...("runtimePolicyOverride" in recording ? { override: recording.runtimePolicyOverride } : {}),
+  });
+  const queryPolicy = claudeRuntimeQueryPolicyForRuntimePolicy(runtimePolicy);
+
+  const transcript = await recordClaudeAgentSdkReplayTranscript({
+    scenario,
+    prompts,
+    modelSelection: {
+      ...CLAUDE_MODEL_SELECTION,
+      model: process.env.T3_CLAUDE_REPLAY_MODEL ?? CLAUDE_MODEL_SELECTION.model,
+    },
+    cwd,
+    ...(process.env.T3_CLAUDE_REPLAY_SESSION_ID === undefined
+      ? {}
+      : { sessionId: process.env.T3_CLAUDE_REPLAY_SESSION_ID }),
+    queryMode,
+    ...("enableTools" in recording && recording.enableTools === true ? { enableTools: true } : {}),
+    ...(queryPolicy.tools === undefined ? {} : { tools: queryPolicy.tools }),
+    permissionMode: queryPolicy.permissionMode,
+    ...(queryPolicy.allowedTools === undefined ? {} : { allowedTools: queryPolicy.allowedTools }),
+    ...(queryPolicy.allowDangerouslySkipPermissions === undefined
+      ? {}
+      : { allowDangerouslySkipPermissions: queryPolicy.allowDangerouslySkipPermissions }),
+    ...(queryPolicy.installPermissionCallback ? { enablePermissionCallback: true } : {}),
+    ...("interruptAfter" in recording ? { interruptAfter: recording.interruptAfter } : {}),
+  });
+  await runFileSystem(
+    Effect.gen(function* () {
+      const fs = yield* FileSystem.FileSystem;
+      yield* fs.makeDirectory(dirname(outputPath), { recursive: true });
+      yield* fs.writeFileString(outputPath, encodeTranscriptNdjson(transcript));
+    }),
+  );
+  await Effect.runPromise(
+    Console.log(
+      `Wrote ${transcript.entries.length} ${CLAUDE_AGENT_SDK_REPLAY_PROTOCOL} replay entries to ${outputPath}`,
+    ),
+  );
+} finally {
+  if (shouldRemoveCwd) {
+    await runFileSystem(
+      Effect.gen(function* () {
+        const fs = yield* FileSystem.FileSystem;
+        yield* fs.remove(cwd, { recursive: true, force: true });
+      }),
+    );
+  }
+}
diff --git a/apps/server/scripts/record-codex-app-server-replay-fixture.ts b/apps/server/scripts/record-codex-app-server-replay-fixture.ts
new file mode 100644
index 000000000000..6468e230a83a
--- /dev/null
+++ b/apps/server/scripts/record-codex-app-server-replay-fixture.ts
@@ -0,0 +1,1310 @@
+import * as NodeRuntime from "@effect/platform-node/NodeRuntime";
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import { HostProcessEnvironment } from "@t3tools/shared/hostProcess";
+import { resolveSpawnCommand } from "@t3tools/shared/shell";
+import * as Console from "effect/Console";
+import * as Deferred from "effect/Deferred";
+import * as FileSystem from "effect/FileSystem";
+import * as Layer from "effect/Layer";
+import * as Path from "effect/Path";
+import * as PlatformError from "effect/PlatformError";
+import * as Effect from "effect/Effect";
+import { ChildProcess, ChildProcessSpawner } from "effect/unstable/process";
+
+import * as CodexClient from "effect-codex-app-server/client";
+import type * as CodexSchema from "effect-codex-app-server/schema";
+
+import {
+  MESSAGE_STEERING_INITIAL_PROMPT,
+  MESSAGE_STEERING_STEER_PROMPT,
+  MULTI_TURN_FIRST_PROMPT,
+  MULTI_TURN_SECOND_PROMPT,
+  PLAN_QUESTIONS_PROMPT,
+  PROPOSED_PLAN_PROMPT,
+  PROVIDER_THREAD_RESUME_FIRST_PROMPT,
+  PROVIDER_THREAD_RESUME_SECOND_PROMPT,
+  SIMPLE_PROMPT,
+  SUBAGENT_CONTINUE_PARENT_PROMPT,
+  SUBAGENT_CONTINUE_PROMPT,
+  SUBAGENT_PROMPT,
+  THREAD_ROLLBACK_AFTER_PROMPT,
+  THREAD_ROLLBACK_FIRST_PROMPT,
+  THREAD_ROLLBACK_SECOND_PROMPT,
+  THREAD_FORK_NATIVE_CONTINUE_FIRST_PROMPT,
+  THREAD_FORK_NATIVE_CONTINUE_SECOND_PROMPT,
+  THREAD_FORK_NATIVE_CONTINUE_SOURCE_PROMPT,
+  THREAD_FORK_NATIVE_SIBLINGS_FIRST_PROMPT,
+  THREAD_FORK_NATIVE_SIBLINGS_SECOND_PROMPT,
+  THREAD_FORK_NATIVE_SIBLINGS_SOURCE_PROMPT,
+  THREAD_MERGE_BACK_FORK_PROMPT,
+  THREAD_MERGE_BACK_HANDOFF_PROMPT,
+  THREAD_MERGE_BACK_RECALL_PROMPT,
+  THREAD_MERGE_BACK_SIBLINGS_FIRST_FORK_PROMPT,
+  THREAD_MERGE_BACK_SIBLINGS_FIRST_HANDOFF_PROMPT,
+  THREAD_MERGE_BACK_SIBLINGS_RECALL_PROMPT,
+  THREAD_MERGE_BACK_SIBLINGS_SECOND_FORK_PROMPT,
+  THREAD_MERGE_BACK_SIBLINGS_SECOND_HANDOFF_PROMPT,
+  THREAD_MERGE_BACK_SIBLINGS_SOURCE_PROMPT,
+  THREAD_MERGE_BACK_SOURCE_PROMPT,
+  TODO_LIST_PROMPT,
+  TOOL_CALL_WRITE_PROMPT,
+  TURN_INTERRUPT_MID_TOOL_PROMPT,
+  TURN_INTERRUPT_PROMPT,
+} from "../src/orchestration-v2/testkit/fixtures/shared.ts";
+import { codexReplayRecordingOutputRecords } from "./codexReplayRecordingRecords.ts";
+import { makeReplayRecorderDeferredRegistry } from "./replayRecorderDeferredRegistry.ts";
+
+const CODEX_REPLAY_PLAN_MODE_DEVELOPER_INSTRUCTIONS =
+  process.env.T3_CODEX_REPLAY_PLAN_DEVELOPER_INSTRUCTIONS ??
+  "You are in Plan mode. Prefer request_user_input for clarifying questions. When presenting a complete plan, wrap it in <proposed_plan> and </proposed_plan>.";
+const CODEX_CLIENT_INFO = {
+  name: "t3code_desktop",
+  title: "T3 Code Desktop",
+  version: "0.1.0",
+} as const;
+const CODEX_CLIENT_CAPABILITIES = {
+  experimentalApi: true,
+} as const;
+
+const SCENARIO_NAMES = [
+  "simple",
+  "tool_call_read_only_on_request",
+  "tool_call_workspace_never",
+  "tool_call_restricted_granular",
+  "subagent",
+  "subagent_continue",
+  "multi_turn",
+  "provider_thread_resume",
+  "todo_list",
+  "plan_questions",
+  "proposed_plan",
+  "message_steering",
+  "turn_interrupt",
+  "turn_interrupt_mid_tool",
+  "thread_rollback",
+  "thread_fork_native_continue",
+  "thread_fork_native_siblings",
+  "thread_merge_back_continue",
+  "thread_merge_back_siblings",
+] as const;
+
+type ScenarioName = (typeof SCENARIO_NAMES)[number];
+type TurnStartParams = CodexSchema.ClientRequestParamsByMethod["turn/start"] & {
+  readonly collaborationMode?: CodexSchema.V2TurnStartParams__CollaborationMode;
+};
+type TurnStartInput = TurnStartParams["input"];
+type TurnStartResponse = CodexSchema.ClientRequestResponsesByMethod["turn/start"];
+type SandboxPolicy = NonNullable<TurnStartParams["sandboxPolicy"]>;
+type ApprovalPolicy = NonNullable<TurnStartParams["approvalPolicy"]>;
+
+interface ReplayRun {
+  readonly name: string;
+  readonly prompt?: string;
+  readonly description: string;
+  readonly steps: ReadonlyArray<ReplayStep>;
+  readonly turnDefaults?: Omit<TurnStartParams, "input" | "threadId">;
+}
+
+type ReplayStep =
+  | {
+      readonly type: "turn";
+      readonly label: string;
+      readonly prompt: string;
+      readonly thread?: string;
+      readonly turnOverrides?: Omit<TurnStartParams, "input" | "threadId">;
+    }
+  | {
+      readonly type: "steeredTurn";
+      readonly label: string;
+      readonly prompt: string;
+      readonly steer: string;
+      readonly turnOverrides?: Omit<TurnStartParams, "input" | "threadId">;
+    }
+  | {
+      readonly type: "interruptedTurn";
+      readonly label: string;
+      readonly prompt: string;
+      readonly interruptAfterMs?: number;
+      readonly interruptAfterCommandExecutionStarted?: boolean;
+      readonly turnOverrides?: Omit<TurnStartParams, "input" | "threadId">;
+    }
+  | {
+      readonly type: "rollback";
+      readonly label: string;
+      readonly numTurns: number;
+    }
+  | {
+      readonly type: "fork";
+      readonly label: string;
+      readonly from?: string;
+      readonly as?: string;
+    };
+type TurnReplayStep = Exclude<
+  ReplayStep,
+  { readonly type: "rollback" } | { readonly type: "fork" }
+>;
+
+interface ReplayScenario {
+  readonly name: ScenarioName;
+  readonly fileName: `${ScenarioName}.ndjson`;
+  readonly description: string;
+  readonly runs: ReadonlyArray<ReplayRun>;
+}
+
+interface Recorder {
+  readonly path: string;
+  readonly setVersion: (version: string) => Effect.Effect<void>;
+  readonly writeRecord: (
+    record: Record<string, unknown>,
+  ) => Effect.Effect<void, PlatformError.PlatformError>;
+  readonly flush: () => Effect.Effect<void, PlatformError.PlatformError>;
+}
+
+function readArgValue(name: string): string | undefined {
+  const args = process.argv.slice(2);
+  const index = args.indexOf(name);
+  return index >= 0 ? args[index + 1] : undefined;
+}
+
+function readArgValues(name: string): ReadonlyArray<string> {
+  const args = process.argv.slice(2);
+  return args.flatMap((arg, index) => (arg === name && args[index + 1] ? [args[index + 1]!] : []));
+}
+
+function defaultTranscriptUrl(scenario: ReplayScenario): URL {
+  return new URL(
+    `../src/orchestration-v2/testkit/fixtures/${scenario.name}/codex_transcript.ndjson`,
+    import.meta.url,
+  );
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null;
+}
+
+function parseScenarios(): ReadonlyArray<ScenarioName> {
+  const rawValues = [
+    ...readArgValues("--scenario"),
+    ...(process.env.T3_CODEX_REPLAY_SCENARIOS ? [process.env.T3_CODEX_REPLAY_SCENARIOS] : []),
+  ];
+  const requested = rawValues.length > 0 ? rawValues : ["simple"];
+  const names = requested.flatMap((value) =>
+    value
+      .split(",")
+      .map((part) => part.trim())
+      .filter((part) => part.length > 0),
+  );
+
+  if (names.includes("all")) {
+    return SCENARIO_NAMES;
+  }
+
+  const expandedNames = names.flatMap((name) =>
+    name === "tool_call"
+      ? [
+          "tool_call_read_only_on_request",
+          "tool_call_workspace_never",
+          "tool_call_restricted_granular",
+        ]
+      : [name],
+  );
+
+  const invalid = expandedNames.filter(
+    (name): name is string => !SCENARIO_NAMES.includes(name as ScenarioName),
+  );
+  if (invalid.length > 0) {
+    throw new Error(`Unknown scenario(s): ${invalid.join(", ")}`);
+  }
+
+  return [...new Set(expandedNames)] as ReadonlyArray<ScenarioName>;
+}
+
+function classifyJsonRpcPayload(payload: unknown): string {
+  if (!isRecord(payload)) {
+    return "unknown";
+  }
+  if (typeof payload.method === "string" && "id" in payload) {
+    return "request";
+  }
+  if (typeof payload.method === "string") {
+    return "notification";
+  }
+  if ("id" in payload && "error" in payload) {
+    return "error_response";
+  }
+  if ("id" in payload && "result" in payload) {
+    return "response";
+  }
+  return "unknown";
+}
+
+function protocolMethod(payload: unknown): string | undefined {
+  return isRecord(payload) && typeof payload.method === "string" ? payload.method : undefined;
+}
+
+function protocolId(payload: unknown): string | number | undefined {
+  if (!isRecord(payload)) {
+    return undefined;
+  }
+  return typeof payload.id === "string" || typeof payload.id === "number" ? payload.id : undefined;
+}
+
+function protocolResult(payload: unknown): unknown {
+  return isRecord(payload) && "result" in payload ? payload.result : undefined;
+}
+
+function inferCodexVersion(payload: unknown): string | undefined {
+  const result = protocolResult(payload);
+  if (!isRecord(result)) {
+    return undefined;
+  }
+
+  if (typeof result.userAgent === "string") {
+    const match = result.userAgent.match(/\/([0-9][^\s)]*)/u);
+    if (match?.[1]) {
+      return match[1];
+    }
+  }
+
+  const thread = result.thread;
+  return isRecord(thread) && typeof thread.cliVersion === "string" ? thread.cliVersion : undefined;
+}
+
+function turnInput(prompt: string): TurnStartInput {
+  return [{ type: "text", text: prompt }];
+}
+
+function getTurnId(response: TurnStartResponse): string {
+  return response.turn.id;
+}
+
+function readOnlyFullAccessSandbox(): SandboxPolicy {
+  return {
+    networkAccess: false,
+    type: "readOnly",
+  };
+}
+
+function readOnlyRestrictedSandbox(): SandboxPolicy {
+  return {
+    networkAccess: false,
+    type: "readOnly",
+  };
+}
+
+function workspaceWriteSandbox(): SandboxPolicy {
+  return {
+    networkAccess: false,
+    type: "workspaceWrite",
+    writableRoots: [],
+  };
+}
+
+function granularApprovalPolicy(): ApprovalPolicy {
+  return {
+    granular: {
+      mcp_elicitations: true,
+      request_permissions: true,
+      rules: true,
+      sandbox_approval: true,
+      skill_approval: true,
+    },
+  };
+}
+
+function collaborationMode(
+  mode: Extract<CodexSchema.V2TurnStartParams__ModeKind, "plan">,
+): CodexSchema.V2TurnStartParams__CollaborationMode {
+  return {
+    mode,
+    settings: {
+      developer_instructions: CODEX_REPLAY_PLAN_MODE_DEVELOPER_INSTRUCTIONS,
+      model: "gpt-5.4",
+      reasoning_effort: "medium",
+    },
+  };
+}
+
+function scenarios(): ReadonlyArray<ReplayScenario> {
+  return [
+    {
+      name: "simple",
+      fileName: "simple.ndjson",
+      description: "One thread and one turn with a deterministic text-only response.",
+      runs: [
+        {
+          name: "simple",
+          description: "Single text-only turn.",
+          prompt: SIMPLE_PROMPT,
+          steps: [{ type: "turn", label: "simple", prompt: SIMPLE_PROMPT }],
+        },
+      ],
+    },
+    {
+      name: "tool_call_read_only_on_request",
+      fileName: "tool_call_read_only_on_request.ndjson",
+      description:
+        "Write a small fixture file with read-only full filesystem visibility and on-request approvals.",
+      runs: [
+        {
+          name: "read-only-on-request",
+          description:
+            "Write action under read-only full filesystem visibility with on-request approvals.",
+          prompt: TOOL_CALL_WRITE_PROMPT,
+          turnDefaults: {
+            approvalPolicy: "on-request",
+            sandboxPolicy: readOnlyFullAccessSandbox(),
+          },
+          steps: [{ type: "turn", label: "write-fixture-file", prompt: TOOL_CALL_WRITE_PROMPT }],
+        },
+      ],
+    },
+    {
+      name: "tool_call_workspace_never",
+      fileName: "tool_call_workspace_never.ndjson",
+      description:
+        "Write a small fixture file with workspace-write sandbox policy and never approvals.",
+      runs: [
+        {
+          name: "workspace-never",
+          description:
+            "Write action under workspace-write policy with never approvals for baseline no-prompt behavior.",
+          prompt: TOOL_CALL_WRITE_PROMPT,
+          turnDefaults: {
+            approvalPolicy: "never",
+            sandboxPolicy: workspaceWriteSandbox(),
+          },
+          steps: [{ type: "turn", label: "write-fixture-file", prompt: TOOL_CALL_WRITE_PROMPT }],
+        },
+      ],
+    },
+    {
+      name: "tool_call_restricted_granular",
+      fileName: "tool_call_restricted_granular.ndjson",
+      description:
+        "Write a small fixture file with restricted read access and granular approval flags enabled.",
+      runs: [
+        {
+          name: "restricted-granular",
+          description:
+            "Write action under restricted read access with granular approval flags enabled, intended to capture permission request flows when Codex escalates.",
+          prompt: TOOL_CALL_WRITE_PROMPT,
+          turnDefaults: {
+            approvalPolicy: granularApprovalPolicy(),
+            sandboxPolicy: readOnlyRestrictedSandbox(),
+          },
+          steps: [
+            {
+              type: "turn",
+              label: "write-fixture-file",
+              prompt: TOOL_CALL_WRITE_PROMPT,
+            },
+          ],
+        },
+      ],
+    },
+    {
+      name: "subagent",
+      fileName: "subagent.ndjson",
+      description: "One root turn that asks Codex to spawn two collab agents.",
+      runs: [
+        {
+          name: "two-subagents",
+          description: "Root turn asks for two subagents reading different files.",
+          prompt: SUBAGENT_PROMPT,
+          turnDefaults: {
+            approvalPolicy: "on-request",
+            sandboxPolicy: readOnlyFullAccessSandbox(),
+          },
+          steps: [{ type: "turn", label: "spawn-two-subagents", prompt: SUBAGENT_PROMPT }],
+        },
+      ],
+    },
+    {
+      name: "subagent_continue",
+      fileName: "subagent_continue.ndjson",
+      description:
+        "A root turn spawns one native Codex subagent, then a later root turn resumes and messages the same child thread.",
+      runs: [
+        {
+          name: "continued-subagent",
+          description:
+            "The second root turn asks Codex to continue the subagent created by the first root turn.",
+          steps: [
+            {
+              type: "turn",
+              label: "spawn-subagent",
+              prompt: SUBAGENT_CONTINUE_PROMPT,
+            },
+            {
+              type: "turn",
+              label: "continue-subagent",
+              prompt: SUBAGENT_CONTINUE_PARENT_PROMPT,
+            },
+          ],
+        },
+      ],
+    },
+    {
+      name: "multi_turn",
+      fileName: "multi_turn.ndjson",
+      description: "One thread with two sequential user turns.",
+      runs: [
+        {
+          name: "two-turns-same-thread",
+          description: "Second turn starts after the first root turn completes.",
+          steps: [
+            {
+              type: "turn",
+              label: "first",
+              prompt: MULTI_TURN_FIRST_PROMPT,
+            },
+            {
+              type: "turn",
+              label: "second",
+              prompt: MULTI_TURN_SECOND_PROMPT,
+            },
+          ],
+        },
+      ],
+    },
+    {
+      name: "provider_thread_resume",
+      fileName: "provider_thread_resume.ndjson",
+      description:
+        "One provider-native thread is started, completed, then resumed by thread id in a fresh app-server session.",
+      runs: [
+        {
+          name: "resume-provider-thread",
+          description:
+            "First turn completes, the app-server runtime is restarted, thread/resume loads the existing provider thread, then a second turn completes.",
+          steps: [
+            {
+              type: "turn",
+              label: "first-before-resume",
+              prompt: PROVIDER_THREAD_RESUME_FIRST_PROMPT,
+            },
+            {
+              type: "turn",
+              label: "second-after-resume",
+              prompt: PROVIDER_THREAD_RESUME_SECOND_PROMPT,
+            },
+          ],
+        },
+      ],
+    },
+    {
+      name: "todo_list",
+      fileName: "todo_list.ndjson",
+      description: "One turn that asks Codex to emit progress through update_plan.",
+      runs: [
+        {
+          name: "todo-list",
+          description: "Default-mode turn that should surface turn/plan/updated notifications.",
+          prompt: TODO_LIST_PROMPT,
+          turnDefaults: {
+            approvalPolicy: "never",
+            sandboxPolicy: readOnlyFullAccessSandbox(),
+          },
+          steps: [{ type: "turn", label: "todo-list", prompt: TODO_LIST_PROMPT }],
+        },
+      ],
+    },
+    {
+      name: "plan_questions",
+      fileName: "plan_questions.ndjson",
+      description: "One plan-mode turn that asks a structured clarifying question.",
+      runs: [
+        {
+          name: "plan-questions",
+          description: "Plan-mode turn intended to surface item/tool/requestUserInput.",
+          prompt: PLAN_QUESTIONS_PROMPT,
+          turnDefaults: {
+            approvalPolicy: "never",
+            collaborationMode: collaborationMode("plan"),
+            sandboxPolicy: readOnlyFullAccessSandbox(),
+          },
+          steps: [{ type: "turn", label: "plan-questions", prompt: PLAN_QUESTIONS_PROMPT }],
+        },
+      ],
+    },
+    {
+      name: "proposed_plan",
+      fileName: "proposed_plan.ndjson",
+      description: "One plan-mode turn that emits a proposed plan document.",
+      runs: [
+        {
+          name: "proposed-plan",
+          description:
+            "Plan-mode turn intended to surface item/plan/delta and completed plan item.",
+          prompt: PROPOSED_PLAN_PROMPT,
+          turnDefaults: {
+            approvalPolicy: "never",
+            collaborationMode: collaborationMode("plan"),
+            sandboxPolicy: readOnlyFullAccessSandbox(),
+          },
+          steps: [{ type: "turn", label: "proposed-plan", prompt: PROPOSED_PLAN_PROMPT }],
+        },
+      ],
+    },
+    {
+      name: "message_steering",
+      fileName: "message_steering.ndjson",
+      description: "One active turn receives an immediate turn/steer request.",
+      runs: [
+        {
+          name: "immediate-steer",
+          description: "Start a turn, then immediately steer the active root turn.",
+          steps: [
+            {
+              type: "steeredTurn",
+              label: "steered",
+              prompt: MESSAGE_STEERING_INITIAL_PROMPT,
+              steer: MESSAGE_STEERING_STEER_PROMPT,
+            },
+          ],
+        },
+      ],
+    },
+    {
+      name: "turn_interrupt",
+      fileName: "turn_interrupt.ndjson",
+      description: "One active turn is interrupted before it finishes naturally.",
+      runs: [
+        {
+          name: "interrupt-active-turn",
+          description: "Start a long-running turn, then send turn/interrupt.",
+          prompt: TURN_INTERRUPT_PROMPT,
+          turnDefaults: {
+            approvalPolicy: "never",
+            sandboxPolicy: workspaceWriteSandbox(),
+          },
+          steps: [
+            {
+              type: "interruptedTurn",
+              label: "interrupt-active-turn",
+              prompt: TURN_INTERRUPT_PROMPT,
+              interruptAfterMs: 1_500,
+            },
+          ],
+        },
+      ],
+    },
+    {
+      name: "turn_interrupt_mid_tool",
+      fileName: "turn_interrupt_mid_tool.ndjson",
+      description:
+        "One active turn is interrupted after Codex has already executed a local command.",
+      runs: [
+        {
+          name: "interrupt-after-command-execution",
+          description: "Start a turn, wait for command execution, then send turn/interrupt.",
+          prompt: TURN_INTERRUPT_MID_TOOL_PROMPT,
+          turnDefaults: {
+            approvalPolicy: "never",
+            sandboxPolicy: workspaceWriteSandbox(),
+          },
+          steps: [
+            {
+              type: "interruptedTurn",
+              label: "interrupt-after-command-execution",
+              prompt: TURN_INTERRUPT_MID_TOOL_PROMPT,
+              interruptAfterCommandExecutionStarted: true,
+            },
+          ],
+        },
+      ],
+    },
+    {
+      name: "thread_rollback",
+      fileName: "thread_rollback.ndjson",
+      description:
+        "One thread completes two turns, rolls back the most recent turn, then starts another turn.",
+      runs: [
+        {
+          name: "rollback-one-turn",
+          description:
+            "Two completed turns, thread/rollback numTurns=1, then a post-rollback turn.",
+          steps: [
+            {
+              type: "turn",
+              label: "first-before-rollback",
+              prompt: THREAD_ROLLBACK_FIRST_PROMPT,
+            },
+            {
+              type: "turn",
+              label: "second-before-rollback",
+              prompt: THREAD_ROLLBACK_SECOND_PROMPT,
+            },
+            {
+              type: "rollback",
+              label: "rollback-latest-turn",
+              numTurns: 1,
+            },
+            {
+              type: "turn",
+              label: "post-rollback",
+              prompt: THREAD_ROLLBACK_AFTER_PROMPT,
+            },
+          ],
+        },
+      ],
+    },
+    {
+      name: "thread_fork_native_continue",
+      fileName: "thread_fork_native_continue.ndjson",
+      description:
+        "One source marker turn, a native thread fork, a fork-local marker turn, and a recall turn that requires both contexts.",
+      runs: [
+        {
+          name: "continue-native-fork",
+          description:
+            "Proves the native fork inherits source context and retains its own first turn into a second fork-local turn.",
+          steps: [
+            {
+              type: "turn",
+              label: "source",
+              prompt: THREAD_FORK_NATIVE_CONTINUE_SOURCE_PROMPT,
+            },
+            {
+              type: "fork",
+              label: "fork-source",
+            },
+            {
+              type: "turn",
+              label: "fork-first-delta",
+              prompt: THREAD_FORK_NATIVE_CONTINUE_FIRST_PROMPT,
+            },
+            {
+              type: "turn",
+              label: "fork-second-delta",
+              prompt: THREAD_FORK_NATIVE_CONTINUE_SECOND_PROMPT,
+            },
+          ],
+        },
+      ],
+    },
+    {
+      name: "thread_fork_native_siblings",
+      fileName: "thread_fork_native_siblings.ndjson",
+      description:
+        "One source marker turn and two independent native forks that each recall the source plus only their own fork marker.",
+      runs: [
+        {
+          name: "native-sibling-forks",
+          description:
+            "Creates two native forks from the same source provider thread and proves their contexts remain isolated.",
+          steps: [
+            {
+              type: "turn",
+              label: "source",
+              prompt: THREAD_FORK_NATIVE_SIBLINGS_SOURCE_PROMPT,
+              thread: "source",
+            },
+            {
+              type: "fork",
+              label: "fork-first",
+              from: "source",
+              as: "first",
+            },
+            {
+              type: "turn",
+              label: "first-recall",
+              prompt: THREAD_FORK_NATIVE_SIBLINGS_FIRST_PROMPT,
+              thread: "first",
+            },
+            {
+              type: "fork",
+              label: "fork-second",
+              from: "source",
+              as: "second",
+            },
+            {
+              type: "turn",
+              label: "second-recall",
+              prompt: THREAD_FORK_NATIVE_SIBLINGS_SECOND_PROMPT,
+              thread: "second",
+            },
+          ],
+        },
+      ],
+    },
+    {
+      name: "thread_merge_back_continue",
+      fileName: "thread_merge_back_continue.ndjson",
+      description:
+        "A source thread consumes one fork-delta handoff and later recalls source and transferred context.",
+      runs: [
+        {
+          name: "merge-native-fork",
+          description:
+            "Proves a merge-back handoff becomes durable context on the original provider thread.",
+          steps: [
+            {
+              type: "turn",
+              label: "source",
+              prompt: THREAD_MERGE_BACK_SOURCE_PROMPT,
+              thread: "source",
+            },
+            {
+              type: "fork",
+              label: "fork",
+              from: "source",
+              as: "fork",
+            },
+            {
+              type: "turn",
+              label: "fork-delta",
+              prompt: THREAD_MERGE_BACK_FORK_PROMPT,
+              thread: "fork",
+            },
+            {
+              type: "turn",
+              label: "merge-back",
+              prompt: THREAD_MERGE_BACK_HANDOFF_PROMPT,
+              thread: "source",
+            },
+            {
+              type: "turn",
+              label: "source-recall",
+              prompt: THREAD_MERGE_BACK_RECALL_PROMPT,
+              thread: "source",
+            },
+          ],
+        },
+      ],
+    },
+    {
+      name: "thread_merge_back_siblings",
+      fileName: "thread_merge_back_siblings.ndjson",
+      description:
+        "Two sibling fork deltas are merged sequentially into one source provider thread and recalled together.",
+      runs: [
+        {
+          name: "merge-native-sibling-forks",
+          description:
+            "Proves repeated merge-back handoffs accumulate on the source while native sibling forks remain independent.",
+          steps: [
+            {
+              type: "turn",
+              label: "source",
+              prompt: THREAD_MERGE_BACK_SIBLINGS_SOURCE_PROMPT,
+              thread: "source",
+            },
+            {
+              type: "fork",
+              label: "fork-first",
+              from: "source",
+              as: "first",
+            },
+            {
+              type: "turn",
+              label: "first-fork-delta",
+              prompt: THREAD_MERGE_BACK_SIBLINGS_FIRST_FORK_PROMPT,
+              thread: "first",
+            },
+            {
+              type: "fork",
+              label: "fork-second",
+              from: "source",
+              as: "second",
+            },
+            {
+              type: "turn",
+              label: "second-fork-delta",
+              prompt: THREAD_MERGE_BACK_SIBLINGS_SECOND_FORK_PROMPT,
+              thread: "second",
+            },
+            {
+              type: "turn",
+              label: "merge-first",
+              prompt: THREAD_MERGE_BACK_SIBLINGS_FIRST_HANDOFF_PROMPT,
+              thread: "source",
+            },
+            {
+              type: "turn",
+              label: "merge-second",
+              prompt: THREAD_MERGE_BACK_SIBLINGS_SECOND_HANDOFF_PROMPT,
+              thread: "source",
+            },
+            {
+              type: "turn",
+              label: "source-recall",
+              prompt: THREAD_MERGE_BACK_SIBLINGS_RECALL_PROMPT,
+              thread: "source",
+            },
+          ],
+        },
+      ],
+    },
+  ];
+}
+
+function makeRecorder({
+  outPath,
+  scenario,
+}: {
+  readonly outPath: string;
+  readonly scenario: ReplayScenario;
+}): Effect.Effect<Recorder, PlatformError.PlatformError, FileSystem.FileSystem> {
+  return Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    let version = "unknown";
+    const records: Array<Record<string, unknown>> = [];
+    const setVersion = (nextVersion: string) =>
+      Effect.sync(() => {
+        version = nextVersion;
+      });
+    const writeRecord = (record: Record<string, unknown>) =>
+      Effect.sync(() => {
+        records.push(record);
+      });
+    const flush = () => {
+      const outputRecords = codexReplayRecordingOutputRecords(records);
+      return fs.writeFileString(
+        outPath,
+        `${[
+          {
+            type: "transcript_start",
+            provider: "codex",
+            protocol: "codex.app-server",
+            version,
+            scenario: scenario.name,
+            metadata: {
+              source: "record-codex-app-server-replay-fixture",
+              fileName: scenario.fileName,
+              description: scenario.description,
+            },
+          },
+          ...outputRecords,
+        ]
+          .map((record) => JSON.stringify(record))
+          .join("\n")}\n`,
+      );
+    };
+
+    return { path: outPath, setVersion, writeRecord, flush };
+  });
+}
+
+function makeCodexLayer({ recorder }: { readonly recorder: Recorder }) {
+  const clientRequestMethodById = new Map<string, string>();
+  const serverRequestMethodById = new Map<string, string>();
+  const clientOptions: CodexClient.CodexAppServerClientOptions = {
+    logIncoming: true,
+    logOutgoing: true,
+    logger: (event) => {
+      if (event.stage === "raw") {
+        return Effect.void;
+      }
+
+      const id = protocolId(event.payload);
+      const idKey = id === undefined ? undefined : String(id);
+      const method = protocolMethod(event.payload);
+      const messageKind = classifyJsonRpcPayload(event.payload);
+      let correlatedRequestMethod: string | undefined;
+
+      if (messageKind === "request" && idKey && method) {
+        if (event.direction === "outgoing") {
+          clientRequestMethodById.set(idKey, method);
+        } else {
+          serverRequestMethodById.set(idKey, method);
+        }
+      }
+
+      if (messageKind === "response" || messageKind === "error_response") {
+        if (event.direction === "incoming" && idKey) {
+          correlatedRequestMethod = clientRequestMethodById.get(idKey);
+          clientRequestMethodById.delete(idKey);
+        }
+        if (event.direction === "outgoing" && idKey) {
+          correlatedRequestMethod = serverRequestMethodById.get(idKey);
+          serverRequestMethodById.delete(idKey);
+        }
+      }
+
+      const version = inferCodexVersion(event.payload);
+      const updateVersion = version ? recorder.setVersion(version) : Effect.void;
+
+      const label = method ?? correlatedRequestMethod;
+      const record =
+        event.direction === "outgoing"
+          ? {
+              type: "expect_outbound",
+              ...(label ? { label } : {}),
+              frame: event.payload,
+            }
+          : {
+              type: "emit_inbound",
+              ...(label ? { label } : {}),
+              frame: event.payload,
+            };
+
+      return Effect.gen(function* () {
+        yield* updateVersion;
+        yield* recorder.writeRecord(record);
+      }).pipe(Effect.ignore);
+    },
+  };
+
+  return Layer.effect(
+    CodexClient.CodexAppServerClient,
+    Effect.gen(function* () {
+      const environment = yield* HostProcessEnvironment;
+      const spawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const commandName = environment.T3_CODEX_BIN ?? environment.CODEX_BIN ?? "codex";
+      const spawnCommand = yield* resolveSpawnCommand(commandName, ["app-server"], {
+        env: environment,
+      });
+      const handle = yield* spawner.spawn(
+        ChildProcess.make(spawnCommand.command, spawnCommand.args, {
+          cwd: process.cwd(),
+          env: environment,
+          shell: spawnCommand.shell,
+        }),
+      );
+      const context = yield* Layer.build(CodexClient.layerChildProcess(handle, clientOptions));
+      return yield* Effect.service(CodexClient.CodexAppServerClient).pipe(Effect.provide(context));
+    }),
+  );
+}
+
+function installReplayHandlers({
+  client,
+  startTurn,
+  completeTurn,
+  startCommandExecution,
+  beforeApprovalResponse,
+}: {
+  readonly client: CodexClient.CodexAppServerClient["Service"];
+  readonly startTurn: (turnId: string) => Effect.Effect<void>;
+  readonly completeTurn: (turnId: string) => Effect.Effect<void>;
+  readonly startCommandExecution: (turnId: string) => Effect.Effect<void>;
+  readonly beforeApprovalResponse: () => Effect.Effect<void>;
+}) {
+  return Effect.all(
+    [
+      client.handleServerRequest("item/tool/requestUserInput", (payload) =>
+        Effect.succeed({
+          answers: Object.fromEntries(
+            payload.questions.map((question) => [
+              question.id,
+              {
+                answers:
+                  question.options && question.options.length > 0
+                    ? [question.options[0]!.label]
+                    : ["ok"],
+              },
+            ]),
+          ),
+        }),
+      ),
+      client.handleServerRequest("item/commandExecution/requestApproval", () =>
+        beforeApprovalResponse().pipe(Effect.as({ decision: "accept" })),
+      ),
+      client.handleServerRequest("item/fileChange/requestApproval", () =>
+        beforeApprovalResponse().pipe(Effect.as({ decision: "accept" })),
+      ),
+      client.handleServerRequest("item/permissions/requestApproval", (payload) =>
+        beforeApprovalResponse().pipe(
+          Effect.as({
+            permissions: payload.permissions,
+            scope: "turn" as const,
+          }),
+        ),
+      ),
+      client.handleServerRequest("mcpServer/elicitation/request", () =>
+        Effect.succeed({ action: "accept" }),
+      ),
+      client.handleServerRequest("item/tool/call", (payload) =>
+        Effect.succeed({
+          contentItems: [
+            {
+              text: `Replay dynamic tool handler did not execute external tool: ${payload.tool}`,
+              type: "inputText" as const,
+            },
+          ],
+          success: false,
+        }),
+      ),
+      client.handleServerRequest("applyPatchApproval", () =>
+        Effect.succeed({ decision: "approved" }),
+      ),
+      client.handleServerRequest("execCommandApproval", () =>
+        Effect.succeed({ decision: "approved" }),
+      ),
+      client.handleUnknownServerRequest((method) =>
+        Effect.die(new Error(`Unhandled Codex app-server request in replay recorder: ${method}`)),
+      ),
+      client.handleServerNotification("turn/started", (payload) =>
+        startTurn(payload.turn.id).pipe(Effect.ignore),
+      ),
+      client.handleServerNotification("turn/completed", (payload) =>
+        completeTurn(payload.turn.id).pipe(Effect.ignore),
+      ),
+      client.handleServerNotification("item/completed", (payload) =>
+        isRecord(payload.item) && payload.item.type === "commandExecution"
+          ? startCommandExecution(payload.turnId).pipe(Effect.ignore)
+          : Effect.void,
+      ),
+      client.handleServerNotification("item/started", (payload) =>
+        isRecord(payload.item) && payload.item.type === "commandExecution"
+          ? startCommandExecution(payload.turnId).pipe(Effect.ignore)
+          : Effect.void,
+      ),
+    ],
+    { discard: true },
+  );
+}
+
+function runReplaySession({
+  scenario,
+  run,
+  recorder,
+}: {
+  readonly scenario: ReplayScenario;
+  readonly run: ReplayRun;
+  readonly recorder: Recorder;
+}) {
+  return Effect.gen(function* () {
+    const startedTurns = yield* makeReplayRecorderDeferredRegistry();
+    const completedTurns = yield* makeReplayRecorderDeferredRegistry();
+    const startedCommandExecutions = yield* makeReplayRecorderDeferredRegistry();
+    let approvalGate: Deferred.Deferred<void> | undefined;
+    const getStarted = startedTurns.getOrCreate;
+    const getCompletion = completedTurns.getOrCreate;
+    const getCommandExecutionStarted = startedCommandExecutions.getOrCreate;
+    const startTurn = startedTurns.succeed;
+    const completeTurn = completedTurns.succeed;
+    const startCommandExecution = startedCommandExecutions.succeed;
+    const beforeApprovalResponse = () =>
+      approvalGate ? Deferred.await(approvalGate) : Effect.void;
+
+    const initializeClient = Effect.gen(function* () {
+      const client = yield* CodexClient.CodexAppServerClient;
+
+      yield* installReplayHandlers({
+        client,
+        startTurn,
+        completeTurn,
+        startCommandExecution,
+        beforeApprovalResponse,
+      });
+
+      yield* client.request("initialize", {
+        clientInfo: CODEX_CLIENT_INFO,
+        capabilities: CODEX_CLIENT_CAPABILITIES,
+      });
+
+      yield* client.notify("initialized", undefined);
+
+      return client;
+    });
+
+    const runTurnStep = (
+      client: CodexClient.CodexAppServerClient["Service"],
+      threadId: string,
+      step: TurnReplayStep,
+    ) =>
+      Effect.gen(function* () {
+        const turnParams: TurnStartParams = {
+          ...run.turnDefaults,
+          ...step.turnOverrides,
+          input: turnInput(step.prompt),
+          threadId,
+        };
+
+        if (step.type === "steeredTurn") {
+          approvalGate = yield* Deferred.make<void>();
+        }
+
+        const turn = yield* client.request("turn/start", turnParams);
+        const turnId = getTurnId(turn);
+        const started = yield* getStarted(turnId);
+        yield* getCompletion(turnId);
+
+        if (step.type === "steeredTurn") {
+          yield* Deferred.await(started);
+          yield* client.request("turn/steer", {
+            expectedTurnId: turnId,
+            input: turnInput(step.steer),
+            threadId,
+          });
+          if (approvalGate) {
+            yield* Deferred.succeed(approvalGate, void 0);
+            approvalGate = undefined;
+          }
+        }
+
+        if (step.type === "interruptedTurn") {
+          if (step.interruptAfterCommandExecutionStarted === true) {
+            const commandExecutionStarted = yield* getCommandExecutionStarted(turnId);
+            yield* Deferred.await(commandExecutionStarted);
+          } else {
+            yield* Effect.sleep(`${step.interruptAfterMs ?? 1_500} millis`);
+          }
+          yield* client.request("turn/interrupt", {
+            threadId,
+            turnId,
+          });
+        }
+
+        const completed = yield* getCompletion(turnId);
+        yield* Deferred.await(completed);
+      });
+
+    if (scenario.name === "provider_thread_resume") {
+      const firstStep = run.steps[0];
+      const secondStep = run.steps[1];
+      if (
+        !firstStep ||
+        !secondStep ||
+        firstStep.type === "rollback" ||
+        firstStep.type === "fork" ||
+        secondStep.type === "rollback" ||
+        secondStep.type === "fork"
+      ) {
+        throw new Error("provider_thread_resume replay recording requires two turn steps.");
+      }
+
+      const firstThread = yield* Effect.gen(function* () {
+        const client = yield* initializeClient;
+        const thread = yield* client.request("thread/start", {});
+        yield* runTurnStep(client, thread.thread.id, firstStep);
+        return thread;
+      }).pipe(
+        Effect.provide(
+          makeCodexLayer({
+            recorder,
+          }),
+        ),
+      );
+
+      yield* recorder.writeRecord({
+        type: "runtime_exit",
+        status: "success",
+      });
+
+      yield* Effect.gen(function* () {
+        const client = yield* initializeClient;
+        const thread = yield* client.request("thread/resume", {
+          threadId: firstThread.thread.id,
+        });
+        yield* runTurnStep(client, thread.thread.id, secondStep);
+      }).pipe(
+        Effect.provide(
+          makeCodexLayer({
+            recorder,
+          }),
+        ),
+      );
+      return;
+    }
+
+    yield* Effect.gen(function* () {
+      const client = yield* initializeClient;
+      const thread = yield* client.request("thread/start", {});
+      let activeThreadId = thread.thread.id;
+      const threadIds = new Map<string, string>([["source", thread.thread.id]]);
+
+      for (const [stepIndex, step] of run.steps.entries()) {
+        if (step.type === "rollback") {
+          yield* client.request("thread/rollback", {
+            threadId: activeThreadId,
+            numTurns: step.numTurns,
+          });
+          continue;
+        }
+        if (step.type === "fork") {
+          const sourceThreadId =
+            step.from === undefined ? activeThreadId : threadIds.get(step.from);
+          if (sourceThreadId === undefined) {
+            throw new Error(`Unknown replay thread alias '${step.from}'.`);
+          }
+          const forked = yield* client.request("thread/fork", {
+            threadId: sourceThreadId,
+          });
+          activeThreadId = forked.thread.id;
+          if (step.as !== undefined) {
+            threadIds.set(step.as, forked.thread.id);
+          }
+          continue;
+        }
+
+        const threadAlias = "thread" in step ? step.thread : undefined;
+        const turnThreadId =
+          threadAlias === undefined ? activeThreadId : threadIds.get(threadAlias);
+        if (turnThreadId === undefined) {
+          throw new Error(`Unknown replay thread alias '${threadAlias}'.`);
+        }
+        yield* runTurnStep(client, turnThreadId, step);
+        void stepIndex;
+      }
+    }).pipe(
+      Effect.provide(
+        makeCodexLayer({
+          recorder,
+        }),
+      ),
+    );
+  });
+}
+
+function runScenario({
+  scenario,
+  outPath,
+}: {
+  readonly scenario: ReplayScenario;
+  readonly outPath: string;
+}) {
+  return Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const recorder = yield* makeRecorder({ outPath, scenario });
+
+    yield* fs.makeDirectory(path.dirname(outPath), { recursive: true });
+    yield* Console.log(`Writing ${scenario.name} Codex replay events to ${recorder.path}`);
+
+    yield* Effect.forEach(scenario.runs, (run) => runReplaySession({ scenario, run, recorder }), {
+      concurrency: 1,
+    });
+
+    yield* recorder.writeRecord({
+      type: "runtime_exit",
+      status: "success",
+    });
+    yield* recorder.flush();
+  });
+}
+
+const program = Effect.gen(function* () {
+  const path = yield* Path.Path;
+  const requestedScenarios = parseScenarios();
+  const allScenarios = scenarios();
+  const outDir = readArgValue("--out-dir") ?? process.env.T3_CODEX_REPLAY_OUT_DIR;
+  const singleOutPath = readArgValue("--out") ?? process.env.T3_CODEX_REPLAY_OUT;
+  const selected = allScenarios.filter((scenario) => requestedScenarios.includes(scenario.name));
+
+  if (selected.length === 0) {
+    throw new Error("No replay scenarios selected.");
+  }
+  if (singleOutPath && selected.length !== 1) {
+    throw new Error("--out / T3_CODEX_REPLAY_OUT can only be used with exactly one --scenario.");
+  }
+
+  yield* Effect.forEach(
+    selected,
+    (scenario) =>
+      Effect.gen(function* () {
+        const defaultOutPath = yield* path.fromFileUrl(defaultTranscriptUrl(scenario));
+        yield* runScenario({
+          scenario,
+          outPath:
+            singleOutPath ?? (outDir ? path.join(outDir, scenario.fileName) : defaultOutPath),
+        });
+      }),
+    { concurrency: 1 },
+  );
+});
+
+program.pipe(Effect.scoped, Effect.provide(NodeServices.layer), NodeRuntime.runMain);
diff --git a/apps/server/scripts/record-cursor-agent-sdk-replay-fixture.ts b/apps/server/scripts/record-cursor-agent-sdk-replay-fixture.ts
new file mode 100644
index 000000000000..8d5cfa95893f
--- /dev/null
+++ b/apps/server/scripts/record-cursor-agent-sdk-replay-fixture.ts
@@ -0,0 +1,222 @@
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import * as Console from "effect/Console";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as Schema from "effect/Schema";
+
+import { recordCursorAgentSdkReplayTranscript } from "../src/orchestration-v2/Adapters/CursorAdapterV2.testkit.ts";
+import { makeCheckpointWorkspace } from "../src/orchestration-v2/testkit/ReplayFixtureWorkspace.ts";
+import {
+  CURSOR_MODEL_SELECTION,
+  MESSAGE_STEERING_INITIAL_PROMPT,
+  MESSAGE_STEERING_STEER_PROMPT,
+  MULTI_TURN_FIRST_PROMPT,
+  MULTI_TURN_SECOND_PROMPT,
+  PROVIDER_THREAD_RESUME_FIRST_PROMPT,
+  PROVIDER_THREAD_RESUME_SECOND_PROMPT,
+  PROPOSED_PLAN_PROMPT,
+  SIMPLE_PROMPT,
+  SUBAGENT_PROMPT,
+  TODO_LIST_PROMPT,
+  TOOL_CALL_READ_ONLY_PROMPT,
+  TURN_INTERRUPT_MID_TOOL_PROMPT,
+} from "../src/orchestration-v2/testkit/fixtures/shared.ts";
+import {
+  cursorReplayPromptsForWorkspace,
+  cursorReplayTranscriptCwd,
+  shouldSeedCursorReplayWorkspace,
+} from "./cursorReplayRecordingWorkspace.ts";
+
+const RECORDINGS = {
+  simple: {
+    prompts: [SIMPLE_PROMPT],
+    output: "../src/orchestration-v2/testkit/fixtures/simple/cursor_transcript.ndjson",
+  },
+  multi_turn: {
+    prompts: [MULTI_TURN_FIRST_PROMPT, MULTI_TURN_SECOND_PROMPT],
+    output: "../src/orchestration-v2/testkit/fixtures/multi_turn/cursor_transcript.ndjson",
+  },
+  message_steering: {
+    prompts: [MESSAGE_STEERING_INITIAL_PROMPT, MESSAGE_STEERING_STEER_PROMPT],
+    output: "../src/orchestration-v2/testkit/fixtures/message_steering/cursor_transcript.ndjson",
+    interruptAfterRunStartPromptIndex: 0,
+  },
+  provider_thread_resume: {
+    prompts: [PROVIDER_THREAD_RESUME_FIRST_PROMPT, PROVIDER_THREAD_RESUME_SECOND_PROMPT],
+    output:
+      "../src/orchestration-v2/testkit/fixtures/provider_thread_resume/cursor_transcript.ndjson",
+    restartBeforePromptIndex: 1,
+  },
+  queued_turn: {
+    prompts: [MULTI_TURN_FIRST_PROMPT, MULTI_TURN_SECOND_PROMPT],
+    output: "../src/orchestration-v2/testkit/fixtures/queued_turn/cursor_transcript.ndjson",
+  },
+  proposed_plan: {
+    prompts: [PROPOSED_PLAN_PROMPT],
+    output: "../src/orchestration-v2/testkit/fixtures/proposed_plan/cursor_transcript.ndjson",
+    interactionMode: "plan",
+  },
+  todo_list: {
+    prompts: [TODO_LIST_PROMPT],
+    output: "../src/orchestration-v2/testkit/fixtures/todo_list/cursor_transcript.ndjson",
+  },
+  subagent: {
+    prompts: [SUBAGENT_PROMPT],
+    output: "../src/orchestration-v2/testkit/fixtures/subagent/cursor_transcript.ndjson",
+  },
+  tool_call_read_only: {
+    prompts: [TOOL_CALL_READ_ONLY_PROMPT],
+    output: "../src/orchestration-v2/testkit/fixtures/tool_call_read_only/cursor_transcript.ndjson",
+  },
+  turn_interrupt_mid_tool: {
+    prompts: [TURN_INTERRUPT_MID_TOOL_PROMPT],
+    output:
+      "../src/orchestration-v2/testkit/fixtures/turn_interrupt_mid_tool/cursor_transcript.ndjson",
+    interruptAfterToolStart: true,
+  },
+} as const;
+
+type RecordingName = keyof typeof RECORDINGS;
+
+const encodeUnknownJsonString = Schema.encodeSync(Schema.fromJsonString(Schema.Unknown));
+
+function readArgValue(name: string): string | undefined {
+  const index = process.argv.indexOf(name);
+  return index === -1 ? undefined : process.argv[index + 1];
+}
+
+function encodeTranscriptNdjson(
+  transcript: Awaited<ReturnType<typeof recordCursorAgentSdkReplayTranscript>>,
+): string {
+  const { entries, ...metadata } = transcript;
+  return [
+    encodeUnknownJsonString({ type: "transcript_start", ...metadata }),
+    ...entries.map((entry) => encodeUnknownJsonString(entry)),
+    "",
+  ].join("\n");
+}
+
+const runFileSystem = <A, E>(
+  effect: Effect.Effect<A, E, FileSystem.FileSystem | Path.Path>,
+): Promise<A> => Effect.runPromise(effect.pipe(Effect.provide(NodeServices.layer)));
+
+async function prepareWorkspace(scenario: RecordingName): Promise<{
+  readonly cwd: string;
+  readonly owned: boolean;
+}> {
+  const configuredCwd = process.env.T3_CURSOR_REPLAY_CWD?.trim();
+  if (configuredCwd) {
+    return {
+      cwd: configuredCwd,
+      owned: false,
+    };
+  }
+  return {
+    cwd: await makeCheckpointWorkspace(`cursor-agent-sdk-record-${scenario}`),
+    owned: true,
+  };
+}
+
+async function writeFixtureFiles(cwd: string): Promise<void> {
+  await runFileSystem(
+    Effect.gen(function* () {
+      const fs = yield* FileSystem.FileSystem;
+      const path = yield* Path.Path;
+      yield* fs.writeFileString(
+        path.join(cwd, "package.json"),
+        encodeUnknownJsonString({
+          name: "cursor-read-only-fixture",
+          private: true,
+          scripts: { typecheck: "tsc --noEmit" },
+        }),
+      );
+      yield* fs.writeFileString(
+        path.join(cwd, "tsconfig.json"),
+        encodeUnknownJsonString({
+          compilerOptions: {
+            module: "ESNext",
+            strict: true,
+            target: "ES2022",
+          },
+        }),
+      );
+    }),
+  );
+}
+
+const scenario = (readArgValue("--scenario") ?? process.env.T3_CURSOR_REPLAY_SCENARIO) as
+  | RecordingName
+  | undefined;
+if (scenario === undefined || RECORDINGS[scenario] === undefined) {
+  throw new Error(`Pass --scenario with one of: ${Object.keys(RECORDINGS).join(", ")}`);
+}
+
+const apiKey = process.env.CURSOR_API_KEY?.trim();
+if (!apiKey) {
+  throw new Error("CURSOR_API_KEY is required to record Cursor SDK replay fixtures.");
+}
+
+const recording = RECORDINGS[scenario];
+const workspace = await prepareWorkspace(scenario);
+const transcriptCwd = cursorReplayTranscriptCwd(scenario);
+const outputPath = readArgValue("--out") ?? new URL(recording.output, import.meta.url).pathname;
+
+try {
+  if (shouldSeedCursorReplayWorkspace({ scenario, owned: workspace.owned })) {
+    await writeFixtureFiles(workspace.cwd);
+  }
+  const prompts = await runFileSystem(
+    Effect.gen(function* () {
+      const path = yield* Path.Path;
+      return cursorReplayPromptsForWorkspace({
+        scenario,
+        configuredPrompts: recording.prompts,
+        packageJsonPath: path.join(workspace.cwd, "package.json"),
+        tsconfigPath: path.join(workspace.cwd, "tsconfig.json"),
+      });
+    }),
+  );
+  const transcript = await recordCursorAgentSdkReplayTranscript({
+    scenario,
+    prompts,
+    ...(scenario === "tool_call_read_only" ? { transcriptPrompts: recording.prompts } : {}),
+    modelSelection: {
+      ...CURSOR_MODEL_SELECTION,
+      model: process.env.T3_CURSOR_REPLAY_MODEL ?? CURSOR_MODEL_SELECTION.model,
+    },
+    cwd: workspace.cwd,
+    ...(transcriptCwd === undefined ? {} : { transcriptCwd }),
+    apiKey,
+    ...("interactionMode" in recording ? { interactionMode: recording.interactionMode } : {}),
+    ...("interruptAfterToolStart" in recording
+      ? { interruptAfterToolStart: recording.interruptAfterToolStart }
+      : {}),
+    ...("interruptAfterRunStartPromptIndex" in recording
+      ? { interruptAfterRunStartPromptIndex: recording.interruptAfterRunStartPromptIndex }
+      : {}),
+    ...("restartBeforePromptIndex" in recording
+      ? { restartBeforePromptIndex: recording.restartBeforePromptIndex }
+      : {}),
+  });
+  await runFileSystem(
+    Effect.gen(function* () {
+      const fs = yield* FileSystem.FileSystem;
+      const path = yield* Path.Path;
+      yield* fs.makeDirectory(path.dirname(outputPath), { recursive: true });
+      yield* fs.writeFileString(outputPath, encodeTranscriptNdjson(transcript));
+    }),
+  );
+  await Effect.runPromise(
+    Console.log(`Wrote ${transcript.entries.length} Cursor SDK replay entries to ${outputPath}`),
+  );
+} finally {
+  if (workspace.owned) {
+    await runFileSystem(
+      Effect.gen(function* () {
+        const fs = yield* FileSystem.FileSystem;
+        yield* fs.remove(workspace.cwd, { recursive: true, force: true });
+      }),
+    );
+  }
+}
diff --git a/apps/server/scripts/replayRecorderDeferredRegistry.test.ts b/apps/server/scripts/replayRecorderDeferredRegistry.test.ts
new file mode 100644
index 000000000000..0aa0949f09c1
--- /dev/null
+++ b/apps/server/scripts/replayRecorderDeferredRegistry.test.ts
@@ -0,0 +1,26 @@
+import { assert, it } from "@effect/vitest";
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+
+import { makeReplayRecorderDeferredRegistry } from "./replayRecorderDeferredRegistry.ts";
+
+it.effect("atomically shares one deferred across concurrent get-or-create calls", () =>
+  Effect.gen(function* () {
+    const registry = yield* makeReplayRecorderDeferredRegistry();
+    const deferreds = yield* Effect.all(
+      Array.from({ length: 100 }, () => registry.getOrCreate("turn-1")),
+      { concurrency: "unbounded" },
+    );
+
+    for (const deferred of deferreds) {
+      assert.strictEqual(deferred, deferreds[0]);
+    }
+
+    yield* registry.succeed("turn-1");
+    assert.isTrue(yield* Deferred.isDone(deferreds[0]!));
+    yield* Effect.all(deferreds.map(Deferred.await), {
+      concurrency: "unbounded",
+      discard: true,
+    });
+  }),
+);
diff --git a/apps/server/scripts/replayRecorderDeferredRegistry.ts b/apps/server/scripts/replayRecorderDeferredRegistry.ts
new file mode 100644
index 000000000000..3970eaa901bf
--- /dev/null
+++ b/apps/server/scripts/replayRecorderDeferredRegistry.ts
@@ -0,0 +1,43 @@
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+import * as SynchronizedRef from "effect/SynchronizedRef";
+
+export interface ReplayRecorderDeferredRegistry {
+  readonly getOrCreate: (key: string) => Effect.Effect<Deferred.Deferred<void>>;
+  readonly succeed: (key: string) => Effect.Effect<void>;
+}
+
+export const makeReplayRecorderDeferredRegistry = Effect.fn("makeReplayRecorderDeferredRegistry")(
+  function* () {
+    const state = yield* SynchronizedRef.make(new Map<string, Deferred.Deferred<void>>());
+
+    const getOrCreate = Effect.fn("ReplayRecorderDeferredRegistry.getOrCreate")(function* (
+      key: string,
+    ) {
+      return yield* SynchronizedRef.modifyEffect(state, (deferreds) => {
+        const existing = deferreds.get(key);
+        if (existing !== undefined) {
+          return Effect.succeed([existing, deferreds] as const);
+        }
+
+        return Deferred.make<void>().pipe(
+          Effect.map((deferred) => {
+            const next = new Map(deferreds);
+            next.set(key, deferred);
+            return [deferred, next] as const;
+          }),
+        );
+      });
+    });
+
+    const succeed = Effect.fn("ReplayRecorderDeferredRegistry.succeed")(function* (key: string) {
+      const deferred = yield* getOrCreate(key);
+      yield* Deferred.succeed(deferred, undefined);
+    });
+
+    return {
+      getOrCreate,
+      succeed,
+    } satisfies ReplayRecorderDeferredRegistry;
+  },
+);
diff --git a/apps/server/src/attachmentStore.test.ts b/apps/server/src/attachmentStore.test.ts
index 59374f18ba48..4cc9c919623f 100644
--- a/apps/server/src/attachmentStore.test.ts
+++ b/apps/server/src/attachmentStore.test.ts
@@ -8,6 +8,7 @@ import { describe, expect, it } from "vite-plus/test";
 import {
   attachmentFileExtension,
   createAttachmentId,
+  createDeterministicAttachmentId,
   createPendingAttachmentId,
   parseAttachmentUuid,
   parseAttachmentFileExtension,
@@ -18,6 +19,27 @@ import {
 } from "./attachmentStore.ts";
 
 describe("attachmentStore", () => {
+  it("derives stable attachment ids for idempotent message retries", () => {
+    const first = createDeterministicAttachmentId("thread-1", "message-1:0");
+    const retry = createDeterministicAttachmentId("thread-1", "message-1:0");
+    const next = createDeterministicAttachmentId("thread-1", "message-1:1");
+
+    expect(first).toBe(retry);
+    expect(next).not.toBe(first);
+    expect(first && parseThreadSegmentFromAttachmentId(first)).toBe("thread-1");
+  });
+
+  it("keeps deterministic ids distinct when sanitized thread segments collide", () => {
+    const dotted = createDeterministicAttachmentId("thread.a", "message-1:0");
+    const dashed = createDeterministicAttachmentId("thread-a", "message-1:0");
+
+    expect(dotted).toBeTruthy();
+    expect(dashed).toBeTruthy();
+    expect(dotted).not.toBe(dashed);
+    expect(dotted && parseThreadSegmentFromAttachmentId(dotted)).toBe("thread-a");
+    expect(dashed && parseThreadSegmentFromAttachmentId(dashed)).toBe("thread-a");
+  });
+
   it("sanitizes thread ids when creating attachment ids", () => {
     const attachmentId = createAttachmentId("thread.folder/unsafe space");
     expect(attachmentId).toBeTruthy();
diff --git a/apps/server/src/attachmentStore.ts b/apps/server/src/attachmentStore.ts
index 261b094645b9..89b831995dae 100644
--- a/apps/server/src/attachmentStore.ts
+++ b/apps/server/src/attachmentStore.ts
@@ -88,6 +88,20 @@ export function createAttachmentId(threadId: string, extension?: string): string
   return `${threadSegment}-${NodeCrypto.randomUUID()}${attachmentIdExtensionSuffix(extension)}`;
 }
 
+export function createDeterministicAttachmentId(
+  threadId: string,
+  stableKey: string,
+): string | null {
+  const threadSegment = toSafeThreadAttachmentSegment(threadId);
+  if (!threadSegment) return null;
+  const hash = NodeCrypto.createHash("sha256")
+    .update(JSON.stringify([threadId, stableKey]))
+    .digest("hex")
+    .slice(0, 32);
+  const uuid = `${hash.slice(0, 8)}-${hash.slice(8, 12)}-${hash.slice(12, 16)}-${hash.slice(16, 20)}-${hash.slice(20)}`;
+  return `${threadSegment}-${uuid}`;
+}
+
 export function parseThreadSegmentFromAttachmentId(attachmentId: string): string | null {
   const normalizedId = normalizeAttachmentRelativePath(attachmentId);
   if (!normalizedId || normalizedId.includes("/") || normalizedId.includes(".")) {
diff --git a/apps/server/src/auth/RpcAuthorization.ts b/apps/server/src/auth/RpcAuthorization.ts
index 28ceac4cec99..4759b102d078 100644
--- a/apps/server/src/auth/RpcAuthorization.ts
+++ b/apps/server/src/auth/RpcAuthorization.ts
@@ -6,7 +6,7 @@ import {
   AuthRelayWriteScope,
   AuthReviewWriteScope,
   AuthTerminalOperateScope,
-  ORCHESTRATION_WS_METHODS,
+  ORCHESTRATION_V2_WS_METHODS,
   type AuthEnvironmentScope,
   WS_METHODS,
   WsRpcGroup,
@@ -21,14 +21,18 @@ type WsRpcMethod = RpcGroup.Rpcs<typeof WsRpcGroup>["_tag"];
  * runtime failure.
  */
 export const RPC_REQUIRED_SCOPES = {
-  [ORCHESTRATION_WS_METHODS.dispatchCommand]: AuthOrchestrationOperateScope,
-  [ORCHESTRATION_WS_METHODS.getWorkflowScript]: AuthOrchestrationReadScope,
-  [ORCHESTRATION_WS_METHODS.getTurnDiff]: AuthOrchestrationReadScope,
-  [ORCHESTRATION_WS_METHODS.getFullThreadDiff]: AuthOrchestrationReadScope,
-  [ORCHESTRATION_WS_METHODS.searchThreads]: AuthOrchestrationReadScope,
-  [ORCHESTRATION_WS_METHODS.subscribeShell]: AuthOrchestrationReadScope,
-  [ORCHESTRATION_WS_METHODS.getArchivedShellSnapshot]: AuthOrchestrationReadScope,
-  [ORCHESTRATION_WS_METHODS.subscribeThread]: AuthOrchestrationReadScope,
+  [ORCHESTRATION_V2_WS_METHODS.dispatchCommand]: AuthOrchestrationOperateScope,
+  [ORCHESTRATION_V2_WS_METHODS.getWorkflowScript]: AuthOrchestrationReadScope,
+  [ORCHESTRATION_V2_WS_METHODS.getTurnDiff]: AuthOrchestrationReadScope,
+  [ORCHESTRATION_V2_WS_METHODS.getFullThreadDiff]: AuthOrchestrationReadScope,
+  [ORCHESTRATION_V2_WS_METHODS.searchThreads]: AuthOrchestrationReadScope,
+  [ORCHESTRATION_V2_WS_METHODS.getArchivedShellSnapshot]: AuthOrchestrationReadScope,
+  [ORCHESTRATION_V2_WS_METHODS.getThreadProjection]: AuthOrchestrationReadScope,
+  [ORCHESTRATION_V2_WS_METHODS.launchThread]: AuthOrchestrationOperateScope,
+  [ORCHESTRATION_V2_WS_METHODS.subscribeArchivedShell]: AuthOrchestrationReadScope,
+  [ORCHESTRATION_V2_WS_METHODS.subscribeShell]: AuthOrchestrationReadScope,
+  [ORCHESTRATION_V2_WS_METHODS.subscribeThread]: AuthOrchestrationReadScope,
+  [WS_METHODS.projectsMutate]: AuthOrchestrationOperateScope,
   [WS_METHODS.serverProbe]: AuthOrchestrationReadScope,
   [WS_METHODS.serverGetConfig]: AuthOrchestrationReadScope,
   [WS_METHODS.serverRefreshProviders]: AuthOrchestrationOperateScope,
@@ -50,6 +54,12 @@ export const RPC_REQUIRED_SCOPES = {
   [WS_METHODS.serverReportClientActivity]: AuthOrchestrationReadScope,
   [WS_METHODS.serverReportHostPowerState]: AuthOrchestrationOperateScope,
   [WS_METHODS.serverGetBackgroundPolicy]: AuthOrchestrationReadScope,
+  [WS_METHODS.scheduledTasksList]: AuthOrchestrationReadScope,
+  [WS_METHODS.scheduledTasksSubscribe]: AuthOrchestrationReadScope,
+  [WS_METHODS.scheduledTasksUpsert]: AuthOrchestrationOperateScope,
+  [WS_METHODS.scheduledTasksSetEnabled]: AuthOrchestrationOperateScope,
+  [WS_METHODS.scheduledTasksDelete]: AuthOrchestrationOperateScope,
+  [WS_METHODS.scheduledTasksRunNow]: AuthOrchestrationOperateScope,
   [WS_METHODS.cloudGetRelayClientStatus]: AuthRelayReadScope,
   [WS_METHODS.cloudInstallRelayClient]: AuthRelayWriteScope,
   [WS_METHODS.pullRequestsList]: AuthOrchestrationReadScope,
@@ -84,6 +94,7 @@ export const RPC_REQUIRED_SCOPES = {
   [WS_METHODS.shellOpenInEditor]: AuthOrchestrationOperateScope,
   [WS_METHODS.filesystemBrowse]: AuthOrchestrationReadScope,
   [WS_METHODS.assetsCreateUrl]: AuthOrchestrationReadScope,
+  [WS_METHODS.assetsPersistChatAttachments]: AuthOrchestrationOperateScope,
   [WS_METHODS.attachmentsCreateUploadUrl]: AuthOrchestrationOperateScope,
   [WS_METHODS.attachmentsDelete]: AuthOrchestrationOperateScope,
   [WS_METHODS.providerUploadFeedback]: AuthOrchestrationOperateScope,
diff --git a/apps/server/src/bin.test.ts b/apps/server/src/bin.test.ts
deleted file mode 100644
index fcb662b9b780..000000000000
--- a/apps/server/src/bin.test.ts
+++ /dev/null
@@ -1,602 +0,0 @@
-// @effect-diagnostics nodeBuiltinImport:off - CLI integration exercises Node HTTP and filesystem boundaries.
-import * as NodeHttp from "node:http";
-import * as NodeFS from "node:fs";
-import * as NodeOS from "node:os";
-import * as NodePath from "node:path";
-
-import * as NodeHttpServer from "@effect/platform-node/NodeHttpServer";
-import * as NodeServices from "@effect/platform-node/NodeServices";
-import {
-  CommandId,
-  EnvironmentOrchestrationHttpApi,
-  ProviderInstanceId,
-  ThreadId,
-} from "@t3tools/contracts";
-import * as NetService from "@t3tools/shared/Net";
-import { assert, it } from "@effect/vitest";
-import * as Effect from "effect/Effect";
-import * as DateTime from "effect/DateTime";
-import * as Layer from "effect/Layer";
-import * as HttpRouter from "effect/unstable/http/HttpRouter";
-import * as HttpServer from "effect/unstable/http/HttpServer";
-import * as HttpApi from "effect/unstable/httpapi/HttpApi";
-import * as HttpApiBuilder from "effect/unstable/httpapi/HttpApiBuilder";
-import * as CliError from "effect/unstable/cli/CliError";
-import * as TestConsole from "effect/testing/TestConsole";
-import { Command } from "effect/unstable/cli";
-
-import { cli, makeCli } from "./bin.ts";
-import * as ServerConfig from "./config.ts";
-import * as ProjectionSnapshotQuery from "./orchestration/Services/ProjectionSnapshotQuery.ts";
-import * as OrchestrationEngine from "./orchestration/Services/OrchestrationEngine.ts";
-import { OrchestrationLayerLive } from "./orchestration/runtimeLayer.ts";
-import { orchestrationHttpApiLayer } from "./orchestration/http.ts";
-import { layerConfig as SqlitePersistenceLayerLive } from "./persistence/Layers/Sqlite.ts";
-import * as RepositoryIdentityResolver from "./project/RepositoryIdentityResolver.ts";
-import {
-  makePersistedServerRuntimeState,
-  persistServerRuntimeState,
-} from "./serverRuntimeState.ts";
-import * as WorkspacePaths from "./workspace/WorkspacePaths.ts";
-import * as ServerSecretStore from "./auth/ServerSecretStore.ts";
-import * as EnvironmentAuth from "./auth/EnvironmentAuth.ts";
-import { environmentAuthenticatedAuthLayer } from "./auth/http.ts";
-
-const CliRuntimeLayer = Layer.mergeAll(NodeServices.layer, NetService.layer);
-class ProjectCliHttpApi extends HttpApi.make("environment").add(EnvironmentOrchestrationHttpApi) {}
-
-const connectCli = makeCli({ cloudEnabled: true });
-const noConnectCli = makeCli({ cloudEnabled: false });
-const runCli = (args: ReadonlyArray<string>, command = cli) =>
-  Command.runWith(command, { version: "0.0.0" })(args);
-const runConnectCli = (args: ReadonlyArray<string>) => runCli(args, connectCli);
-const runCliWithRuntime = (args: ReadonlyArray<string>) =>
-  runCli(args).pipe(Effect.provide(CliRuntimeLayer));
-
-const captureStdout = <A, E, R>(effect: Effect.Effect<A, E, R>) =>
-  Effect.gen(function* () {
-    const result = yield* effect;
-    const output =
-      (yield* TestConsole.logLines).findLast((line): line is string => typeof line === "string") ??
-      "";
-    return { result, output };
-  }).pipe(Effect.provide(Layer.mergeAll(CliRuntimeLayer, TestConsole.layer)));
-
-const makeCliTestServerConfig = (baseDir: string) =>
-  Effect.gen(function* () {
-    const derivedPaths = yield* ServerConfig.deriveServerPaths(baseDir, undefined);
-    return {
-      logLevel: "Info",
-      traceMinLevel: "Info",
-      traceTimingEnabled: true,
-      traceBatchWindowMs: 200,
-      traceMaxBytes: 10 * 1024 * 1024,
-      traceMaxFiles: 10,
-      otlpTracesUrl: undefined,
-      otlpMetricsUrl: undefined,
-      otlpExportIntervalMs: 10_000,
-      otlpServiceName: "t3-server",
-      mode: "web",
-      port: 0,
-      host: "127.0.0.1",
-      cwd: process.cwd(),
-      baseDir,
-      ...derivedPaths,
-      staticDir: undefined,
-      devUrl: undefined,
-      devAllowedOrigins: [],
-      noBrowser: true,
-      startupPresentation: "browser",
-      desktopBootstrapToken: undefined,
-      autoBootstrapProjectFromCwd: false,
-      logWebSocketEvents: false,
-      tailscaleServeEnabled: false,
-      tailscaleServePort: 443,
-    } satisfies ServerConfig.ServerConfig["Service"];
-  });
-
-const makeProjectPersistenceLayer = (config: ServerConfig.ServerConfig["Service"]) =>
-  Layer.mergeAll(
-    OrchestrationLayerLive.pipe(
-      Layer.provideMerge(RepositoryIdentityResolver.layer),
-      Layer.provideMerge(SqlitePersistenceLayerLive),
-    ),
-    WorkspacePaths.layer,
-  ).pipe(Layer.provideMerge(NodeServices.layer), Layer.provide(ServerConfig.layer(config)));
-
-const readPersistedSnapshot = (baseDir: string) =>
-  Effect.gen(function* () {
-    const config = yield* makeCliTestServerConfig(baseDir);
-    return yield* Effect.gen(function* () {
-      const projectionSnapshotQuery = yield* ProjectionSnapshotQuery.ProjectionSnapshotQuery;
-      return yield* projectionSnapshotQuery.getSnapshot();
-    }).pipe(Effect.provide(makeProjectPersistenceLayer(config)));
-  });
-
-const withLiveProjectCliServer = <A, E, R>(baseDir: string, run: () => Effect.Effect<A, E, R>) =>
-  Effect.gen(function* () {
-    const config = yield* makeCliTestServerConfig(baseDir);
-    const routesLayer = HttpApiBuilder.layer(ProjectCliHttpApi).pipe(
-      Layer.provide(orchestrationHttpApiLayer),
-      Layer.provide(environmentAuthenticatedAuthLayer),
-    );
-    const appLayer = HttpRouter.serve(routesLayer, {
-      disableListenLog: true,
-      disableLogger: true,
-    }).pipe(
-      Layer.provideMerge(
-        EnvironmentAuth.layer.pipe(
-          Layer.provideMerge(SqlitePersistenceLayerLive),
-          Layer.provide(ServerSecretStore.layer),
-        ),
-      ),
-      Layer.provideMerge(makeProjectPersistenceLayer(config)),
-      Layer.provideMerge(
-        NodeHttpServer.layer(NodeHttp.createServer, {
-          host: "127.0.0.1",
-          port: 0,
-        }),
-      ),
-      Layer.provideMerge(NodeServices.layer),
-      Layer.provide(ServerConfig.layer(config)),
-    );
-
-    return yield* Effect.scoped(
-      Effect.gen(function* () {
-        const server = yield* HttpServer.HttpServer;
-        const address = server.address;
-        if (typeof address === "string" || !("port" in address)) {
-          assert.fail(`Expected TCP address, got ${address}`);
-        }
-        yield* persistServerRuntimeState({
-          path: config.serverRuntimeStatePath,
-          state: yield* makePersistedServerRuntimeState({
-            config,
-            port: address.port,
-          }),
-        });
-        return yield* run();
-      }).pipe(Effect.provide(Layer.mergeAll(appLayer, NodeServices.layer))),
-    );
-  });
-
-it.layer(NodeServices.layer)("bin cli parsing", (it) => {
-  it.effect("accepts the built-in lowercase log-level flag values", () =>
-    runCliWithRuntime(["--log-level", "debug", "--version"]),
-  );
-
-  it.effect("accepts canonical --no-<flag> boolean negation", () =>
-    runCliWithRuntime(["--no-log-websocket-events", "--version"]),
-  );
-
-  it.effect("rejects invalid log-level casing before launching the server", () =>
-    Effect.gen(function* () {
-      const error = yield* runCliWithRuntime(["--log-level", "Debug"]).pipe(Effect.flip);
-
-      if (!CliError.isCliError(error)) {
-        assert.fail(`Expected CliError, got ${String(error)}`);
-      }
-      if (error._tag !== "InvalidValue") {
-        assert.fail(`Expected InvalidValue, got ${error._tag}`);
-      }
-      assert.equal(error.option, "log-level");
-      assert.equal(error.value, "Debug");
-    }),
-  );
-
-  it.effect("rejects connect commands when public configuration is missing", () =>
-    Effect.gen(function* () {
-      const error = yield* runCli(["connect", "status"], noConnectCli).pipe(Effect.flip);
-
-      if (!CliError.isCliError(error)) {
-        assert.fail(`Expected CliError, got ${String(error)}`);
-      }
-      if (error._tag !== "ShowHelp") {
-        assert.fail(`Expected ShowHelp, got ${error._tag}`);
-      }
-      assert.deepEqual(error.commandPath, ["t3", "connect"]);
-      assert.include(error.errors[0]?.message ?? "", "missing T3 Connect public configuration");
-
-      const output = (yield* TestConsole.errorLines).join("\n");
-      assert.include(output, "ERROR");
-      assert.include(output, "missing T3 Connect public configuration");
-    }).pipe(Effect.provide(Layer.mergeAll(CliRuntimeLayer, TestConsole.layer))),
-  );
-
-  it.effect("exposes service lifecycle commands without T3 Connect configuration", () =>
-    Effect.gen(function* () {
-      const { output } = yield* captureStdout(runCli(["service", "--help"], noConnectCli));
-
-      assert.include(output, "Manage the T3 Code background service.");
-      assert.include(output, "install");
-      assert.include(output, "uninstall");
-      assert.include(output, "update");
-      assert.include(output, "status");
-    }),
-  );
-
-  it.effect("reports fresh headless connect state without requiring local configuration", () =>
-    Effect.gen(function* () {
-      const baseDir = NodeFS.mkdtempSync(
-        NodePath.join(NodeOS.tmpdir(), "t3-cli-cloud-status-test-"),
-      );
-      const { output } = yield* captureStdout(
-        runConnectCli(["connect", "status", "--base-dir", baseDir, "--json"]),
-      );
-      // @effect-diagnostics-next-line preferSchemaOverJson:off - CLI JSON output is decoded as a presentation DTO.
-      const status = JSON.parse(output) as {
-        readonly desired: boolean;
-        readonly authenticated: boolean;
-        readonly linked: boolean;
-        readonly cloudUserId: string | null;
-        readonly relayUrl: string | null;
-      };
-
-      assert.equal(status.desired, false);
-      assert.equal(status.authenticated, false);
-      assert.equal(status.linked, false);
-      assert.equal(status.cloudUserId, null);
-      assert.equal(status.relayUrl, null);
-    }),
-  );
-
-  it.effect("reports actionable human-readable headless connect state", () =>
-    Effect.gen(function* () {
-      const baseDir = NodeFS.mkdtempSync(
-        NodePath.join(NodeOS.tmpdir(), "t3-cli-cloud-status-human-test-"),
-      );
-      const { output } = yield* captureStdout(
-        runConnectCli(["connect", "status", "--base-dir", baseDir]),
-      );
-
-      assert.include(output, "T3 Connect\n  Exposure: disabled");
-      assert.include(output, "  Authorization: missing");
-      assert.include(output, "  Environment link: not provisioned");
-      assert.include(output, "Next: Run `t3 connect link` to authorize and enable T3 Connect.");
-    }),
-  );
-
-  it.effect("accepts the --headless login override without enabling access", () =>
-    Effect.gen(function* () {
-      const baseDir = NodeFS.mkdtempSync(
-        NodePath.join(NodeOS.tmpdir(), "t3-cli-cloud-login-test-"),
-      );
-      const { secretsDir } = yield* ServerConfig.deriveServerPaths(baseDir, undefined);
-      NodeFS.mkdirSync(secretsDir, { recursive: true });
-      NodeFS.writeFileSync(
-        NodePath.join(secretsDir, "cloud-cli-oauth-token.bin"),
-        // @effect-diagnostics-next-line preferSchemaOverJson:off - Test fixture matches the persisted CLI token representation.
-        JSON.stringify({
-          accessToken: "access-token",
-          refreshToken: "refresh-token",
-          expiresAtEpochMs: Number.MAX_SAFE_INTEGER,
-        }),
-      );
-
-      const login = yield* captureStdout(
-        runConnectCli(["connect", "login", "--base-dir", baseDir, "--headless"]),
-      );
-      const status = yield* captureStdout(
-        runConnectCli(["connect", "status", "--base-dir", baseDir, "--json"]),
-      );
-      // @effect-diagnostics-next-line preferSchemaOverJson:off - CLI JSON output is decoded as a presentation DTO.
-      const decoded = JSON.parse(status.output) as {
-        readonly desired: boolean;
-        readonly authenticated: boolean;
-      };
-
-      assert.equal(login.output, "✓ Signed in");
-      assert.isFalse(decoded.desired);
-      assert.isTrue(decoded.authenticated);
-    }),
-  );
-
-  it.effect("disables headless connect without a running server", () =>
-    Effect.gen(function* () {
-      const baseDir = NodeFS.mkdtempSync(
-        NodePath.join(NodeOS.tmpdir(), "t3-cli-cloud-unlink-test-"),
-      );
-      const { output } = yield* captureStdout(
-        runConnectCli(["connect", "unlink", "--base-dir", baseDir]),
-      );
-
-      assert.equal(output, "T3 Connect is disabled locally.");
-    }),
-  );
-
-  it.effect("logs out of headless connect and removes the stored CLI authorization", () =>
-    Effect.gen(function* () {
-      const baseDir = NodeFS.mkdtempSync(
-        NodePath.join(NodeOS.tmpdir(), "t3-cli-cloud-logout-test-"),
-      );
-      const { secretsDir } = yield* ServerConfig.deriveServerPaths(baseDir, undefined);
-      const tokenPath = NodePath.join(secretsDir, "cloud-cli-oauth-token.bin");
-      NodeFS.mkdirSync(secretsDir, { recursive: true });
-      NodeFS.writeFileSync(tokenPath, "invalid persisted token");
-
-      const { output } = yield* captureStdout(
-        runConnectCli(["connect", "logout", "--base-dir", baseDir]),
-      );
-
-      assert.equal(
-        output,
-        "Signed out of T3 Connect locally.\nThe background service is managed separately with `t3 service`.",
-      );
-      assert.isFalse(NodeFS.existsSync(tokenPath));
-    }),
-  );
-
-  it.effect("executes auth pairing subcommands and redacts secrets from list output", () =>
-    Effect.gen(function* () {
-      const baseDir = NodeFS.mkdtempSync(
-        NodePath.join(NodeOS.tmpdir(), "t3-cli-auth-pairing-test-"),
-      );
-
-      const createdOutput = yield* captureStdout(
-        runCli(["auth", "pairing", "create", "--base-dir", baseDir, "--json"]),
-      );
-      // @effect-diagnostics-next-line preferSchemaOverJson:off
-      const created = JSON.parse(createdOutput.output) as {
-        readonly id: string;
-        readonly credential: string;
-      };
-      const listedOutput = yield* captureStdout(
-        runCli(["auth", "pairing", "list", "--base-dir", baseDir, "--json"]),
-      );
-      // @effect-diagnostics-next-line preferSchemaOverJson:off
-      const listed = JSON.parse(listedOutput.output) as ReadonlyArray<{
-        readonly id: string;
-        readonly credential?: string;
-      }>;
-
-      assert.equal(typeof created.id, "string");
-      assert.equal(typeof created.credential, "string");
-      assert.equal(created.credential.length > 0, true);
-      assert.equal(listed.length, 1);
-      assert.equal(listed[0]?.id, created.id);
-      assert.equal("credential" in (listed[0] ?? {}), false);
-    }),
-  );
-
-  it.effect("executes auth session subcommands and redacts secrets from list output", () =>
-    Effect.gen(function* () {
-      const baseDir = NodeFS.mkdtempSync(
-        NodePath.join(NodeOS.tmpdir(), "t3-cli-auth-session-test-"),
-      );
-
-      const issuedOutput = yield* captureStdout(
-        runCli(["auth", "session", "issue", "--base-dir", baseDir, "--json"]),
-      );
-      // @effect-diagnostics-next-line preferSchemaOverJson:off
-      const issued = JSON.parse(issuedOutput.output) as {
-        readonly sessionId: string;
-        readonly token: string;
-        readonly scopes: ReadonlyArray<string>;
-      };
-      const listedOutput = yield* captureStdout(
-        runCli(["auth", "session", "list", "--base-dir", baseDir, "--json"]),
-      );
-      // @effect-diagnostics-next-line preferSchemaOverJson:off
-      const listed = JSON.parse(listedOutput.output) as ReadonlyArray<{
-        readonly sessionId: string;
-        readonly token?: string;
-        readonly scopes: ReadonlyArray<string>;
-      }>;
-
-      assert.equal(typeof issued.sessionId, "string");
-      assert.equal(typeof issued.token, "string");
-      assert.deepEqual(issued.scopes, [
-        "orchestration:read",
-        "orchestration:operate",
-        "terminal:operate",
-        "review:write",
-        "relay:read",
-        "access:read",
-        "access:write",
-        "relay:write",
-      ]);
-      assert.equal(listed.length, 1);
-      assert.equal(listed[0]?.sessionId, issued.sessionId);
-      assert.deepEqual(listed[0]?.scopes, [
-        "orchestration:read",
-        "orchestration:operate",
-        "terminal:operate",
-        "review:write",
-        "relay:read",
-        "access:read",
-        "access:write",
-        "relay:write",
-      ]);
-      assert.equal("token" in (listed[0] ?? {}), false);
-    }),
-  );
-
-  it.effect("rejects invalid ttl values before running auth commands", () =>
-    Effect.gen(function* () {
-      const error = yield* runCliWithRuntime(["auth", "pairing", "create", "--ttl", "soon"]).pipe(
-        Effect.flip,
-      );
-
-      if (!CliError.isCliError(error)) {
-        assert.fail(`Expected CliError, got ${String(error)}`);
-      }
-      if (error._tag !== "ShowHelp") {
-        assert.fail(`Expected ShowHelp, got ${error._tag}`);
-      }
-      assert.deepEqual(error.commandPath, ["t3", "auth", "pairing", "create"]);
-      const ttlError = error.errors[0] as CliError.CliError | undefined;
-      if (!ttlError || ttlError._tag !== "InvalidValue") {
-        assert.fail(`Expected InvalidValue, got ${String(ttlError?._tag)}`);
-      }
-      assert.equal(ttlError.option, "ttl");
-      assert.equal(ttlError.value, "soon");
-      assert.isTrue(ttlError.message.includes("Invalid duration"));
-      assert.isTrue(ttlError.message.includes("5m, 1h, 30d, or 15 minutes"));
-    }),
-  );
-
-  it.effect("adds, renames, and removes projects offline through the orchestration engine", () =>
-    Effect.gen(function* () {
-      const baseDir = NodeFS.mkdtempSync(
-        NodePath.join(NodeOS.tmpdir(), "t3-cli-projects-offline-test-"),
-      );
-      const workspaceRoot = NodeFS.mkdtempSync(
-        NodePath.join(NodeOS.tmpdir(), "t3-cli-projects-workspace-"),
-      );
-
-      yield* runCliWithRuntime([
-        "project",
-        "add",
-        workspaceRoot,
-        "--title",
-        "Alpha",
-        "--base-dir",
-        baseDir,
-      ]);
-      const afterAdd = yield* readPersistedSnapshot(baseDir);
-      const addedProject = afterAdd.projects.find(
-        (project) => project.workspaceRoot === workspaceRoot && project.deletedAt === null,
-      );
-      assert.isTrue(addedProject !== undefined);
-      assert.equal(addedProject?.title, "Alpha");
-
-      yield* runCliWithRuntime(["project", "rename", workspaceRoot, "Beta", "--base-dir", baseDir]);
-      const afterRename = yield* readPersistedSnapshot(baseDir);
-      const renamedProject = afterRename.projects.find(
-        (project) => project.id === addedProject?.id,
-      );
-      assert.equal(renamedProject?.title, "Beta");
-      assert.equal(renamedProject?.deletedAt, null);
-
-      yield* runCliWithRuntime([
-        "project",
-        "remove",
-        addedProject?.id ?? "",
-        "--base-dir",
-        baseDir,
-      ]);
-      const afterRemove = yield* readPersistedSnapshot(baseDir);
-      const removedProject = afterRemove.projects.find(
-        (project) => project.id === addedProject?.id,
-      );
-      assert.isTrue((removedProject?.deletedAt ?? null) !== null);
-    }),
-  );
-
-  it.effect("force removes projects that still contain threads", () =>
-    Effect.gen(function* () {
-      const baseDir = NodeFS.mkdtempSync(
-        NodePath.join(NodeOS.tmpdir(), "t3-cli-projects-force-remove-test-"),
-      );
-      const workspaceRoot = NodeFS.mkdtempSync(
-        NodePath.join(NodeOS.tmpdir(), "t3-cli-projects-force-remove-workspace-"),
-      );
-
-      yield* runCliWithRuntime(["project", "add", workspaceRoot, "--base-dir", baseDir]);
-      const afterAdd = yield* readPersistedSnapshot(baseDir);
-      const project = afterAdd.projects.find(
-        (candidate) => candidate.workspaceRoot === workspaceRoot && candidate.deletedAt === null,
-      );
-      assert.isTrue(project !== undefined);
-
-      const config = yield* makeCliTestServerConfig(baseDir);
-      yield* Effect.gen(function* () {
-        const engine = yield* OrchestrationEngine.OrchestrationEngineService;
-        yield* engine.dispatch({
-          type: "thread.create",
-          commandId: CommandId.make("cmd-cli-force-remove-thread"),
-          threadId: ThreadId.make("thread-cli-force-remove"),
-          projectId: project!.id,
-          title: "Thread",
-          modelSelection: {
-            instanceId: ProviderInstanceId.make("codex"),
-            model: "gpt-5-codex",
-          },
-          interactionMode: "default",
-          runtimeMode: "approval-required",
-          branch: null,
-          worktreePath: null,
-          createdAt: DateTime.formatIso(yield* DateTime.now),
-        });
-      }).pipe(Effect.provide(makeProjectPersistenceLayer(config)));
-
-      yield* runCliWithRuntime([
-        "project",
-        "remove",
-        project!.id,
-        "--force",
-        "--base-dir",
-        baseDir,
-      ]);
-      const afterRemove = yield* readPersistedSnapshot(baseDir);
-      assert.isTrue(
-        (afterRemove.projects.find((candidate) => candidate.id === project!.id)?.deletedAt ??
-          null) !== null,
-      );
-      assert.isTrue(
-        (afterRemove.threads.find((thread) => thread.id === "thread-cli-force-remove")?.deletedAt ??
-          null) !== null,
-      );
-    }),
-  );
-
-  it.effect("routes project commands through a running server when runtime state is present", () =>
-    Effect.gen(function* () {
-      const baseDir = NodeFS.mkdtempSync(
-        NodePath.join(NodeOS.tmpdir(), "t3-cli-projects-live-test-"),
-      );
-      const workspaceRoot = NodeFS.mkdtempSync(
-        NodePath.join(NodeOS.tmpdir(), "t3-cli-projects-live-workspace-"),
-      );
-
-      yield* withLiveProjectCliServer(baseDir, () =>
-        Effect.gen(function* () {
-          yield* runCliWithRuntime([
-            "project",
-            "add",
-            workspaceRoot,
-            "--title",
-            "Live Project",
-            "--base-dir",
-            baseDir,
-          ]);
-          const projectionSnapshotQuery = yield* ProjectionSnapshotQuery.ProjectionSnapshotQuery;
-          const readModel = yield* projectionSnapshotQuery.getSnapshot();
-          const addedProject = readModel.projects.find(
-            (project) => project.workspaceRoot === workspaceRoot && project.deletedAt === null,
-          );
-          assert.isTrue(addedProject !== undefined);
-          assert.equal(addedProject?.title, "Live Project");
-        }),
-      );
-    }),
-  );
-
-  it.effect("rejects dev-url on project commands", () =>
-    Effect.gen(function* () {
-      const workspaceRoot = NodeFS.mkdtempSync(
-        NodePath.join(NodeOS.tmpdir(), "t3-cli-projects-unknown-option-workspace-"),
-      );
-      const error = yield* runCliWithRuntime([
-        "project",
-        "add",
-        workspaceRoot,
-        "--dev-url",
-        "http://127.0.0.1:5173",
-      ]).pipe(Effect.flip);
-
-      if (!CliError.isCliError(error)) {
-        assert.fail(`Expected CliError, got ${String(error)}`);
-      }
-      if (error._tag !== "ShowHelp") {
-        assert.fail(`Expected ShowHelp, got ${error._tag}`);
-      }
-      assert.deepEqual(error.commandPath, ["t3", "project", "add"]);
-      const optionError = error.errors[0] as CliError.CliError | undefined;
-      if (!optionError || optionError._tag !== "UnrecognizedOption") {
-        assert.fail(`Expected UnrecognizedOption, got ${String(optionError?._tag)}`);
-      }
-      assert.equal(optionError.option, "--dev-url");
-    }),
-  );
-});
diff --git a/apps/server/src/checkpointing/CheckpointDiffQuery.test.ts b/apps/server/src/checkpointing/CheckpointDiffQuery.test.ts
index fe093c451e25..718c23f95a68 100644
--- a/apps/server/src/checkpointing/CheckpointDiffQuery.test.ts
+++ b/apps/server/src/checkpointing/CheckpointDiffQuery.test.ts
@@ -1,436 +1,197 @@
-import { CheckpointRef, ProjectId, ThreadId, TurnId } from "@t3tools/contracts";
-import { it } from "@effect/vitest";
+import { assert, it, vi } from "@effect/vitest";
+import {
+  CheckpointRef,
+  CheckpointScopeId,
+  RunId,
+  ThreadId,
+  type OrchestrationV2ThreadProjection,
+} from "@t3tools/contracts";
 import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
-import * as Option from "effect/Option";
-import { describe, expect } from "vite-plus/test";
 
-import * as ProjectionSnapshotQuery from "../orchestration/Services/ProjectionSnapshotQuery.ts";
-import { checkpointRefForThreadTurn } from "./Utils.ts";
+import { checkpointRefForScopeOrdinal } from "../orchestration-v2/CheckpointService.ts";
+import { OrchestratorProjectionError } from "../orchestration-v2/Orchestrator.ts";
+import * as ThreadManagement from "../orchestration-v2/ThreadManagementService.ts";
 import * as CheckpointDiffQuery from "./CheckpointDiffQuery.ts";
 import * as CheckpointStore from "./CheckpointStore.ts";
-import { CheckpointThreadNotFoundError } from "./Errors.ts";
-
-function makeThreadCheckpointContext(input: {
-  readonly projectId: ProjectId;
-  readonly threadId: ThreadId;
-  readonly workspaceRoot: string;
-  readonly worktreePath: string | null;
-  readonly checkpointTurnCount: number;
-  readonly checkpointRef: CheckpointRef;
-}): ProjectionSnapshotQuery.ProjectionThreadCheckpointContext {
+import {
+  CheckpointRefUnavailableError,
+  CheckpointThreadNotFoundError,
+  CheckpointTurnRangeUnavailableError,
+} from "./Errors.ts";
+
+const threadId = ThreadId.make("thread:checkpoint-diff-v2");
+const firstRunId = RunId.make("run:checkpoint-diff-v2:1");
+const secondRunId = RunId.make("run:checkpoint-diff-v2:2");
+const firstScopeId = CheckpointScopeId.make("scope:checkpoint-diff-v2:1");
+const secondScopeId = CheckpointScopeId.make("scope:checkpoint-diff-v2:2");
+const secondRef = CheckpointRef.make("refs/t3/test/second");
+
+function makeProjection(): OrchestrationV2ThreadProjection {
   return {
-    threadId: input.threadId,
-    projectId: input.projectId,
-    workspaceRoot: input.workspaceRoot,
-    worktreePath: input.worktreePath,
+    runs: [
+      { id: firstRunId, ordinal: 1, status: "completed" },
+      { id: secondRunId, ordinal: 2, status: "completed" },
+    ],
+    checkpointScopes: [
+      { id: firstScopeId, runId: firstRunId, kind: "root_run", cwd: "/repo" },
+      { id: secondScopeId, runId: secondRunId, kind: "root_run", cwd: "/repo" },
+    ],
     checkpoints: [
       {
-        turnId: TurnId.make("turn-1"),
-        checkpointTurnCount: input.checkpointTurnCount,
-        checkpointRef: input.checkpointRef,
+        scopeId: secondScopeId,
+        runId: secondRunId,
+        appRunOrdinal: 2,
         status: "ready",
-        files: [],
-        assistantMessageId: null,
-        completedAt: "2026-01-01T00:00:00.000Z",
+        ref: secondRef,
       },
     ],
-  };
+  } as unknown as OrchestrationV2ThreadProjection;
 }
 
-describe("CheckpointDiffQuery.layer", () => {
-  it.effect("uses the narrow full-thread context lookup for all-turns diffs", () =>
-    Effect.gen(function* () {
-      const projectId = ProjectId.make("project-full-thread");
-      const threadId = ThreadId.make("thread-full-thread");
-      const toCheckpointRef = checkpointRefForThreadTurn(threadId, 4);
-      let getThreadCheckpointContextCalls = 0;
-      let getFullThreadDiffContextCalls = 0;
-      const diffCheckpointsCalls: Array<{
-        readonly fromCheckpointRef: CheckpointRef;
-        readonly toCheckpointRef: CheckpointRef;
-        readonly cwd: string;
-        readonly ignoreWhitespace: boolean;
-      }> = [];
-
-      const checkpointStore: CheckpointStore.CheckpointStore["Service"] = {
-        isGitRepository: () => Effect.succeed(true),
-        captureCheckpoint: () => Effect.void,
-        hasCheckpointRef: () => Effect.succeed(true),
-        restoreCheckpoint: () => Effect.succeed(true),
-        diffCheckpoints: ({ fromCheckpointRef, toCheckpointRef, cwd, ignoreWhitespace }) =>
-          Effect.sync(() => {
-            diffCheckpointsCalls.push({
-              fromCheckpointRef,
-              toCheckpointRef,
-              cwd,
-              ignoreWhitespace,
-            });
-            return "full thread diff patch";
-          }),
-        deleteCheckpointRefs: () => Effect.void,
-      };
-
-      const layer = CheckpointDiffQuery.layer.pipe(
-        Layer.provideMerge(Layer.succeed(CheckpointStore.CheckpointStore, checkpointStore)),
-        Layer.provideMerge(
-          Layer.succeed(ProjectionSnapshotQuery.ProjectionSnapshotQuery, {
-            getCommandReadModel: () =>
-              Effect.die("CheckpointDiffQuery should not request the command read model"),
-            getSnapshot: () =>
-              Effect.die("CheckpointDiffQuery should not request the full orchestration snapshot"),
-            getShellSnapshot: () =>
-              Effect.die("CheckpointDiffQuery should not request the orchestration shell snapshot"),
-            getArchivedShellSnapshot: () =>
-              Effect.die("CheckpointDiffQuery should not request archived shell snapshots"),
-            getSnapshotSequence: () => Effect.succeed({ snapshotSequence: 0 }),
-            getCounts: () => Effect.succeed({ projectCount: 0, threadCount: 0 }),
-            getActiveProjectByWorkspaceRoot: () => Effect.succeed(Option.none()),
-            getProjectShellById: () => Effect.succeed(Option.none()),
-            getFirstActiveThreadIdByProjectId: () => Effect.succeed(Option.none()),
-            getThreadCheckpointContext: () =>
-              Effect.sync(() => {
-                getThreadCheckpointContextCalls += 1;
-                return Option.none();
-              }),
-            getFullThreadDiffContext: () =>
-              Effect.sync(() => {
-                getFullThreadDiffContextCalls += 1;
-                return Option.some({
-                  threadId,
-                  projectId,
-                  workspaceRoot: "/tmp/workspace",
-                  worktreePath: "/tmp/worktree",
-                  latestCheckpointTurnCount: 4,
-                  toCheckpointRef,
-                });
-              }),
-            getThreadShellById: () => Effect.succeed(Option.none()),
-            getThreadDetailById: () => Effect.succeed(Option.none()),
-            getThreadDetailSnapshot: () => Effect.succeed(Option.none()),
-            searchThreads: () => Effect.succeed({ matches: [] }),
-          }),
-        ),
-      );
-
-      const result = yield* Effect.gen(function* () {
-        const query = yield* CheckpointDiffQuery.CheckpointDiffQuery;
-        return yield* query.getFullThreadDiff({
-          threadId,
-          toTurnCount: 4,
-          ignoreWhitespace: true,
-        });
-      }).pipe(Effect.provide(layer));
-
-      expect(getThreadCheckpointContextCalls).toBe(0);
-      expect(getFullThreadDiffContextCalls).toBe(1);
-      expect(diffCheckpointsCalls).toEqual([
-        {
-          cwd: "/tmp/worktree",
-          fromCheckpointRef: checkpointRefForThreadTurn(threadId, 0),
-          toCheckpointRef,
-          ignoreWhitespace: true,
-        },
-      ]);
-      expect(result).toEqual({
-        threadId,
-        fromTurnCount: 0,
-        toTurnCount: 4,
-        diff: "full thread diff patch",
-      });
-    }),
+function makeLayer(input: {
+  readonly projection: Effect.Effect<OrchestrationV2ThreadProjection, OrchestratorProjectionError>;
+  readonly diffCheckpoints?: CheckpointStore.CheckpointStore["Service"]["diffCheckpoints"];
+}) {
+  return CheckpointDiffQuery.layer.pipe(
+    Layer.provide(
+      Layer.mergeAll(
+        Layer.mock(ThreadManagement.ThreadManagementService)({
+          getThreadProjection: () => input.projection,
+        }),
+        Layer.mock(CheckpointStore.CheckpointStore)({
+          diffCheckpoints: input.diffCheckpoints ?? (() => Effect.succeed("diff")),
+        }),
+      ),
+    ),
   );
+}
 
-  it.effect("computes diffs using canonical turn-0 checkpoint refs", () =>
-    Effect.gen(function* () {
-      const projectId = ProjectId.make("project-1");
-      const threadId = ThreadId.make("thread-1");
-      const toCheckpointRef = checkpointRefForThreadTurn(threadId, 1);
-      const diffCheckpointsCalls: Array<{
-        readonly fromCheckpointRef: CheckpointRef;
-        readonly toCheckpointRef: CheckpointRef;
-        readonly cwd: string;
-        readonly ignoreWhitespace: boolean;
-      }> = [];
+it.effect("computes V2 run diffs from projected checkpoint scopes", () => {
+  const diffCheckpoints = vi.fn((_input: CheckpointStore.DiffCheckpointsInput) =>
+    Effect.succeed("diff --git a/file b/file"),
+  );
+  const layer = makeLayer({ projection: Effect.succeed(makeProjection()), diffCheckpoints });
+
+  return Effect.gen(function* () {
+    const query = yield* CheckpointDiffQuery.CheckpointDiffQuery;
+    const result = yield* query.getFullThreadDiff({ threadId, toTurnCount: 2 });
+
+    assert.deepEqual(result, {
+      threadId,
+      fromTurnCount: 0,
+      toTurnCount: 2,
+      diff: "diff --git a/file b/file",
+    });
+    assert.deepEqual(diffCheckpoints.mock.calls[0]?.[0], {
+      cwd: "/repo",
+      fromCheckpointRef: checkpointRefForScopeOrdinal({
+        scopeId: firstScopeId,
+        ordinalWithinScope: 0,
+      }),
+      toCheckpointRef: secondRef,
+      fallbackFromToHead: false,
+      ignoreWhitespace: true,
+    });
+  }).pipe(Effect.provide(layer));
+});
 
-      const threadCheckpointContext = makeThreadCheckpointContext({
-        projectId,
-        threadId,
-        workspaceRoot: "/tmp/workspace",
-        worktreePath: null,
-        checkpointTurnCount: 1,
-        checkpointRef: toCheckpointRef,
-      });
+it.effect("preserves the typed missing-thread error contract", () => {
+  const layer = makeLayer({
+    projection: Effect.fail(new OrchestratorProjectionError({ threadId })),
+  });
+
+  return Effect.gen(function* () {
+    const query = yield* CheckpointDiffQuery.CheckpointDiffQuery;
+    const error = yield* query
+      .getTurnDiff({ threadId, fromTurnCount: 0, toTurnCount: 1 })
+      .pipe(Effect.flip);
+
+    assert.instanceOf(error, CheckpointThreadNotFoundError);
+    assert.deepEqual(
+      { operation: error.operation, threadId: error.threadId },
+      { operation: "CheckpointDiffQuery.getTurnDiff", threadId },
+    );
+  }).pipe(Effect.provide(layer));
+});
 
-      const checkpointStore: CheckpointStore.CheckpointStore["Service"] = {
-        isGitRepository: () => Effect.succeed(true),
-        captureCheckpoint: () => Effect.void,
-        hasCheckpointRef: () => Effect.succeed(true),
-        restoreCheckpoint: () => Effect.succeed(true),
-        diffCheckpoints: ({ fromCheckpointRef, toCheckpointRef, cwd, ignoreWhitespace }) =>
-          Effect.sync(() => {
-            diffCheckpointsCalls.push({
-              fromCheckpointRef,
-              toCheckpointRef,
-              cwd,
-              ignoreWhitespace,
-            });
-            return "diff patch";
-          }),
-        deleteCheckpointRefs: () => Effect.void,
-      };
+it.effect("preserves the typed unavailable-range error contract", () => {
+  const layer = makeLayer({ projection: Effect.succeed(makeProjection()) });
 
-      const layer = CheckpointDiffQuery.layer.pipe(
-        Layer.provideMerge(Layer.succeed(CheckpointStore.CheckpointStore, checkpointStore)),
-        Layer.provideMerge(
-          Layer.succeed(ProjectionSnapshotQuery.ProjectionSnapshotQuery, {
-            getCommandReadModel: () =>
-              Effect.die("CheckpointDiffQuery should not request the command read model"),
-            getSnapshot: () =>
-              Effect.die("CheckpointDiffQuery should not request the full orchestration snapshot"),
-            getShellSnapshot: () =>
-              Effect.die("CheckpointDiffQuery should not request the orchestration shell snapshot"),
-            getArchivedShellSnapshot: () =>
-              Effect.die("CheckpointDiffQuery should not request archived shell snapshots"),
-            getSnapshotSequence: () => Effect.succeed({ snapshotSequence: 0 }),
-            getCounts: () => Effect.succeed({ projectCount: 0, threadCount: 0 }),
-            getActiveProjectByWorkspaceRoot: () => Effect.succeed(Option.none()),
-            getProjectShellById: () => Effect.succeed(Option.none()),
-            getFirstActiveThreadIdByProjectId: () => Effect.succeed(Option.none()),
-            getThreadCheckpointContext: () => Effect.succeed(Option.some(threadCheckpointContext)),
-            getFullThreadDiffContext: () => Effect.die("unused"),
-            getThreadShellById: () => Effect.succeed(Option.none()),
-            getThreadDetailById: () => Effect.succeed(Option.none()),
-            getThreadDetailSnapshot: () => Effect.succeed(Option.none()),
-            searchThreads: () => Effect.succeed({ matches: [] }),
-          }),
-        ),
-      );
+  return Effect.gen(function* () {
+    const query = yield* CheckpointDiffQuery.CheckpointDiffQuery;
+    const error = yield* query
+      .getTurnDiff({ threadId, fromTurnCount: 0, toTurnCount: 3 })
+      .pipe(Effect.flip);
 
-      const result = yield* Effect.gen(function* () {
-        const query = yield* CheckpointDiffQuery.CheckpointDiffQuery;
-        return yield* query.getTurnDiff({
-          threadId,
-          fromTurnCount: 0,
-          toTurnCount: 1,
-          ignoreWhitespace: true,
-        });
-      }).pipe(Effect.provide(layer));
+    assert.instanceOf(error, CheckpointTurnRangeUnavailableError);
+    assert.deepEqual(
+      {
+        requestedTurnCount: error.requestedTurnCount,
+        availableTurnCount: error.availableTurnCount,
+      },
+      { requestedTurnCount: 3, availableTurnCount: 2 },
+    );
+  }).pipe(Effect.provide(layer));
+});
 
-      const expectedFromRef = checkpointRefForThreadTurn(threadId, 0);
-      expect(diffCheckpointsCalls).toEqual([
+it.effect("excludes ready checkpoints from rolled-back runs", () => {
+  const projection = makeProjection();
+  const layer = makeLayer({
+    projection: Effect.succeed({
+      ...projection,
+      runs: projection.runs.map((run) =>
+        run.id === secondRunId ? { ...run, status: "rolled_back" as const } : run,
+      ),
+      checkpoints: [
         {
-          cwd: "/tmp/workspace",
-          fromCheckpointRef: expectedFromRef,
-          toCheckpointRef,
-          ignoreWhitespace: true,
+          ...projection.checkpoints[0]!,
+          scopeId: firstScopeId,
+          runId: firstRunId,
+          appRunOrdinal: 1,
+          ref: CheckpointRef.make("refs/t3/test/first"),
         },
-      ]);
-      expect(result).toEqual({
-        threadId,
-        fromTurnCount: 0,
-        toTurnCount: 1,
-        diff: "diff patch",
-      });
-    }),
-  );
-
-  it.effect("defaults to hide whitespace changes", () =>
-    Effect.gen(function* () {
-      const projectId = ProjectId.make("project-default-whitespace");
-      const threadId = ThreadId.make("thread-default-whitespace");
-      const toCheckpointRef = checkpointRefForThreadTurn(threadId, 1);
-      const diffCheckpointsCalls: Array<{ readonly ignoreWhitespace: boolean }> = [];
-
-      const threadCheckpointContext = makeThreadCheckpointContext({
-        projectId,
-        threadId,
-        workspaceRoot: "/tmp/workspace",
-        worktreePath: null,
-        checkpointTurnCount: 1,
-        checkpointRef: toCheckpointRef,
-      });
-
-      const checkpointStore: CheckpointStore.CheckpointStore["Service"] = {
-        isGitRepository: () => Effect.succeed(true),
-        captureCheckpoint: () => Effect.void,
-        hasCheckpointRef: () => Effect.succeed(true),
-        restoreCheckpoint: () => Effect.succeed(true),
-        diffCheckpoints: ({ ignoreWhitespace }) =>
-          Effect.sync(() => {
-            diffCheckpointsCalls.push({ ignoreWhitespace });
-            return "diff patch";
-          }),
-        deleteCheckpointRefs: () => Effect.void,
-      };
-
-      const layer = CheckpointDiffQuery.layer.pipe(
-        Layer.provideMerge(Layer.succeed(CheckpointStore.CheckpointStore, checkpointStore)),
-        Layer.provideMerge(
-          Layer.succeed(ProjectionSnapshotQuery.ProjectionSnapshotQuery, {
-            getCommandReadModel: () =>
-              Effect.die("CheckpointDiffQuery should not request the command read model"),
-            getSnapshot: () =>
-              Effect.die("CheckpointDiffQuery should not request the full orchestration snapshot"),
-            getShellSnapshot: () =>
-              Effect.die("CheckpointDiffQuery should not request the orchestration shell snapshot"),
-            getArchivedShellSnapshot: () =>
-              Effect.die("CheckpointDiffQuery should not request archived shell snapshots"),
-            getSnapshotSequence: () => Effect.succeed({ snapshotSequence: 0 }),
-            getCounts: () => Effect.succeed({ projectCount: 0, threadCount: 0 }),
-            getActiveProjectByWorkspaceRoot: () => Effect.succeed(Option.none()),
-            getProjectShellById: () => Effect.succeed(Option.none()),
-            getFirstActiveThreadIdByProjectId: () => Effect.succeed(Option.none()),
-            getThreadCheckpointContext: () => Effect.succeed(Option.some(threadCheckpointContext)),
-            getFullThreadDiffContext: () => Effect.die("unused"),
-            getThreadShellById: () => Effect.succeed(Option.none()),
-            getThreadDetailById: () => Effect.succeed(Option.none()),
-            getThreadDetailSnapshot: () => Effect.succeed(Option.none()),
-            searchThreads: () => Effect.succeed({ matches: [] }),
-          }),
-        ),
-      );
-
-      yield* Effect.gen(function* () {
-        const query = yield* CheckpointDiffQuery.CheckpointDiffQuery;
-        return yield* query.getTurnDiff({
-          threadId,
-          fromTurnCount: 0,
-          toTurnCount: 1,
-        });
-      }).pipe(Effect.provide(layer));
-
-      expect(diffCheckpointsCalls).toEqual([{ ignoreWhitespace: true }]);
-    }),
-  );
-
-  it.effect("does not preflight checkpoint refs before diffing", () =>
-    Effect.gen(function* () {
-      const projectId = ProjectId.make("project-no-preflight");
-      const threadId = ThreadId.make("thread-no-preflight");
-      const toCheckpointRef = checkpointRefForThreadTurn(threadId, 1);
-      let hasCheckpointRefCallCount = 0;
-
-      const threadCheckpointContext = makeThreadCheckpointContext({
-        projectId,
-        threadId,
-        workspaceRoot: "/tmp/workspace",
-        worktreePath: null,
-        checkpointTurnCount: 1,
-        checkpointRef: toCheckpointRef,
-      });
-
-      const checkpointStore: CheckpointStore.CheckpointStore["Service"] = {
-        isGitRepository: () => Effect.succeed(true),
-        captureCheckpoint: () => Effect.void,
-        hasCheckpointRef: () =>
-          Effect.sync(() => {
-            hasCheckpointRefCallCount += 1;
-            return true;
-          }),
-        restoreCheckpoint: () => Effect.succeed(true),
-        diffCheckpoints: () => Effect.succeed("diff patch"),
-        deleteCheckpointRefs: () => Effect.void,
-      };
-
-      const layer = CheckpointDiffQuery.layer.pipe(
-        Layer.provideMerge(Layer.succeed(CheckpointStore.CheckpointStore, checkpointStore)),
-        Layer.provideMerge(
-          Layer.succeed(ProjectionSnapshotQuery.ProjectionSnapshotQuery, {
-            getCommandReadModel: () =>
-              Effect.die("CheckpointDiffQuery should not request the command read model"),
-            getSnapshot: () =>
-              Effect.die("CheckpointDiffQuery should not request the full orchestration snapshot"),
-            getShellSnapshot: () =>
-              Effect.die("CheckpointDiffQuery should not request the orchestration shell snapshot"),
-            getArchivedShellSnapshot: () =>
-              Effect.die("CheckpointDiffQuery should not request archived shell snapshots"),
-            getSnapshotSequence: () => Effect.succeed({ snapshotSequence: 0 }),
-            getCounts: () => Effect.succeed({ projectCount: 0, threadCount: 0 }),
-            getActiveProjectByWorkspaceRoot: () => Effect.succeed(Option.none()),
-            getProjectShellById: () => Effect.succeed(Option.none()),
-            getFirstActiveThreadIdByProjectId: () => Effect.succeed(Option.none()),
-            getThreadCheckpointContext: () => Effect.succeed(Option.some(threadCheckpointContext)),
-            getFullThreadDiffContext: () => Effect.die("unused"),
-            getThreadShellById: () => Effect.succeed(Option.none()),
-            getThreadDetailById: () => Effect.succeed(Option.none()),
-            getThreadDetailSnapshot: () => Effect.succeed(Option.none()),
-            searchThreads: () => Effect.succeed({ matches: [] }),
-          }),
-        ),
-      );
-
-      yield* Effect.gen(function* () {
-        const query = yield* CheckpointDiffQuery.CheckpointDiffQuery;
-        return yield* query.getTurnDiff({
-          threadId,
-          fromTurnCount: 0,
-          toTurnCount: 1,
-          ignoreWhitespace: true,
-        });
-      }).pipe(Effect.provide(layer));
-
-      expect(hasCheckpointRefCallCount).toBe(0);
+        ...projection.checkpoints,
+      ],
     }),
-  );
-
-  it.effect("fails when the thread is missing from the snapshot", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("thread-missing");
+  });
 
-      const checkpointStore: CheckpointStore.CheckpointStore["Service"] = {
-        isGitRepository: () => Effect.succeed(true),
-        captureCheckpoint: () => Effect.void,
-        hasCheckpointRef: () => Effect.succeed(true),
-        restoreCheckpoint: () => Effect.succeed(true),
-        diffCheckpoints: () => Effect.succeed(""),
-        deleteCheckpointRefs: () => Effect.void,
-      };
+  return Effect.gen(function* () {
+    const query = yield* CheckpointDiffQuery.CheckpointDiffQuery;
+    const error = yield* query
+      .getTurnDiff({ threadId, fromTurnCount: 0, toTurnCount: 2 })
+      .pipe(Effect.flip);
 
-      const layer = CheckpointDiffQuery.layer.pipe(
-        Layer.provideMerge(Layer.succeed(CheckpointStore.CheckpointStore, checkpointStore)),
-        Layer.provideMerge(
-          Layer.succeed(ProjectionSnapshotQuery.ProjectionSnapshotQuery, {
-            getCommandReadModel: () =>
-              Effect.die("CheckpointDiffQuery should not request the command read model"),
-            getSnapshot: () =>
-              Effect.die("CheckpointDiffQuery should not request the full orchestration snapshot"),
-            getShellSnapshot: () =>
-              Effect.die("CheckpointDiffQuery should not request the orchestration shell snapshot"),
-            getArchivedShellSnapshot: () =>
-              Effect.die("CheckpointDiffQuery should not request archived shell snapshots"),
-            getSnapshotSequence: () => Effect.succeed({ snapshotSequence: 0 }),
-            getCounts: () => Effect.succeed({ projectCount: 0, threadCount: 0 }),
-            getActiveProjectByWorkspaceRoot: () => Effect.succeed(Option.none()),
-            getProjectShellById: () => Effect.succeed(Option.none()),
-            getFirstActiveThreadIdByProjectId: () => Effect.succeed(Option.none()),
-            getThreadCheckpointContext: () => Effect.succeed(Option.none()),
-            getFullThreadDiffContext: () => Effect.succeed(Option.none()),
-            getThreadShellById: () => Effect.succeed(Option.none()),
-            getThreadDetailById: () => Effect.succeed(Option.none()),
-            getThreadDetailSnapshot: () => Effect.succeed(Option.none()),
-            searchThreads: () => Effect.succeed({ matches: [] }),
-          }),
-        ),
-      );
-
-      const error = yield* Effect.gen(function* () {
-        const query = yield* CheckpointDiffQuery.CheckpointDiffQuery;
-        return yield* query.getTurnDiff({
-          threadId,
-          fromTurnCount: 0,
-          toTurnCount: 1,
-        });
-      }).pipe(Effect.provide(layer), Effect.flip);
+    assert.instanceOf(error, CheckpointTurnRangeUnavailableError);
+    assert.deepEqual(
+      {
+        requestedTurnCount: error.requestedTurnCount,
+        availableTurnCount: error.availableTurnCount,
+      },
+      { requestedTurnCount: 2, availableTurnCount: 1 },
+    );
+  }).pipe(Effect.provide(layer));
+});
 
-      expect(error).toBeInstanceOf(CheckpointThreadNotFoundError);
-      expect(error).toMatchObject({
-        operation: "CheckpointDiffQuery.getTurnDiff",
-        threadId,
-      });
-      expect(error.message).toBe(
-        "Checkpoint invariant violation in CheckpointDiffQuery.getTurnDiff: Thread 'thread-missing' not found.",
-      );
+it.effect("preserves the typed missing-baseline-ref error contract", () => {
+  const projection = makeProjection();
+  const layer = makeLayer({
+    projection: Effect.succeed({
+      ...projection,
+      checkpointScopes: projection.checkpointScopes.filter((scope) => scope.id !== firstScopeId),
     }),
-  );
+  });
+
+  return Effect.gen(function* () {
+    const query = yield* CheckpointDiffQuery.CheckpointDiffQuery;
+    const error = yield* query
+      .getTurnDiff({ threadId, fromTurnCount: 0, toTurnCount: 2 })
+      .pipe(Effect.flip);
+
+    assert.instanceOf(error, CheckpointRefUnavailableError);
+    assert.deepEqual(
+      { checkpoint: error.checkpoint, turnCount: error.turnCount },
+      { checkpoint: "from", turnCount: 0 },
+    );
+  }).pipe(Effect.provide(layer));
 });
diff --git a/apps/server/src/checkpointing/CheckpointDiffQuery.ts b/apps/server/src/checkpointing/CheckpointDiffQuery.ts
index 077506ff3a84..e4c34528a05f 100644
--- a/apps/server/src/checkpointing/CheckpointDiffQuery.ts
+++ b/apps/server/src/checkpointing/CheckpointDiffQuery.ts
@@ -7,7 +7,6 @@
  * @module CheckpointDiffQuery
  */
 import {
-  type CheckpointRef,
   OrchestrationGetTurnDiffResult,
   type OrchestrationGetFullThreadDiffInput,
   type OrchestrationGetFullThreadDiffResult,
@@ -18,19 +17,18 @@ import {
 import * as Context from "effect/Context";
 import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
-import * as Option from "effect/Option";
 import * as Schema from "effect/Schema";
 
-import * as ProjectionSnapshotQuery from "../orchestration/Services/ProjectionSnapshotQuery.ts";
+import { checkpointRefForScopeOrdinal } from "../orchestration-v2/CheckpointService.ts";
+import * as ThreadManagement from "../orchestration-v2/ThreadManagementService.ts";
 import {
   CheckpointDiffResultInvalidError,
   CheckpointRefUnavailableError,
   CheckpointThreadNotFoundError,
   CheckpointTurnRangeUnavailableError,
   CheckpointWorkspacePathMissingError,
+  type CheckpointServiceError,
 } from "./Errors.ts";
-import type { CheckpointServiceError } from "./Errors.ts";
-import { checkpointRefForThreadTurn } from "./Utils.ts";
 import * as CheckpointStore from "./CheckpointStore.ts";
 
 /** Service tag for checkpoint diff queries. */
@@ -76,7 +74,7 @@ function buildTurnDiffResult(
 }
 
 export const make = Effect.gen(function* () {
-  const projectionSnapshotQuery = yield* ProjectionSnapshotQuery.ProjectionSnapshotQuery;
+  const threads = yield* ThreadManagement.ThreadManagementService;
   const checkpointStore = yield* CheckpointStore.CheckpointStore;
 
   const getTurnDiff: CheckpointDiffQuery["Service"]["getTurnDiff"] = Effect.fn("getTurnDiff")(
@@ -91,12 +89,7 @@ export const make = Effect.gen(function* () {
       });
 
       if (input.fromTurnCount === input.toTurnCount) {
-        const emptyDiff: OrchestrationGetTurnDiffResultType = {
-          threadId: input.threadId,
-          fromTurnCount: input.fromTurnCount,
-          toTurnCount: input.toTurnCount,
-          diff: "",
-        };
+        const emptyDiff = buildTurnDiffResult(input, "");
         if (!isTurnDiffResult(emptyDiff)) {
           return yield* new CheckpointDiffResultInvalidError({
             operation,
@@ -106,18 +99,28 @@ export const make = Effect.gen(function* () {
         return emptyDiff;
       }
 
-      const threadContext = yield* projectionSnapshotQuery
-        .getThreadCheckpointContext(input.threadId)
-        .pipe(Effect.withSpan("checkpoint.turnDiff.lookupContext"));
-      if (Option.isNone(threadContext)) {
-        return yield* new CheckpointThreadNotFoundError({
-          operation,
-          threadId: input.threadId,
-        });
-      }
-
-      const maxTurnCount = threadContext.value.checkpoints.reduce(
-        (max, checkpoint) => Math.max(max, checkpoint.checkpointTurnCount),
+      const projection = yield* threads.getThreadProjection(input.threadId).pipe(
+        Effect.mapError(
+          () =>
+            new CheckpointThreadNotFoundError({
+              operation,
+              threadId: input.threadId,
+            }),
+        ),
+        Effect.withSpan("checkpoint.turnDiff.lookupProjection"),
+      );
+      const completedRunIds = new Set(
+        projection.runs.filter((run) => run.status === "completed").map((run) => run.id),
+      );
+      const readyCheckpoints = projection.checkpoints.filter(
+        (checkpoint) =>
+          checkpoint.status === "ready" &&
+          checkpoint.appRunOrdinal !== null &&
+          checkpoint.runId !== null &&
+          completedRunIds.has(checkpoint.runId),
+      );
+      const maxTurnCount = readyCheckpoints.reduce(
+        (max, checkpoint) => Math.max(max, checkpoint.appRunOrdinal ?? 0),
         0,
       );
       if (input.toTurnCount > maxTurnCount) {
@@ -129,46 +132,58 @@ export const make = Effect.gen(function* () {
         });
       }
 
-      const workspaceCwd = threadContext.value.worktreePath ?? threadContext.value.workspaceRoot;
-      if (!workspaceCwd) {
-        return yield* new CheckpointWorkspacePathMissingError({
+      const toCheckpoint = readyCheckpoints.find(
+        (checkpoint) => checkpoint.appRunOrdinal === input.toTurnCount,
+      );
+      if (toCheckpoint === undefined) {
+        return yield* new CheckpointRefUnavailableError({
           operation,
           threadId: input.threadId,
+          turnCount: input.toTurnCount,
+          checkpoint: "to",
         });
       }
 
-      const fromCheckpointRef =
-        input.fromTurnCount === 0
-          ? checkpointRefForThreadTurn(input.threadId, 0)
-          : threadContext.value.checkpoints.find(
-              (checkpoint) => checkpoint.checkpointTurnCount === input.fromTurnCount,
-            )?.checkpointRef;
-      if (!fromCheckpointRef) {
-        return yield* new CheckpointRefUnavailableError({
+      const toScope = projection.checkpointScopes.find(
+        (scope) => scope.id === toCheckpoint.scopeId,
+      );
+      if (toScope === undefined) {
+        return yield* new CheckpointWorkspacePathMissingError({
           operation,
           threadId: input.threadId,
-          turnCount: input.fromTurnCount,
-          checkpoint: "from",
         });
       }
 
-      const toCheckpointRef = threadContext.value.checkpoints.find(
-        (checkpoint) => checkpoint.checkpointTurnCount === input.toTurnCount,
-      )?.checkpointRef;
-      if (!toCheckpointRef) {
+      const fromCheckpointRef =
+        input.fromTurnCount === 0
+          ? (() => {
+              const firstRun = projection.runs.find((run) => run.ordinal === 1);
+              const firstScope = projection.checkpointScopes.find(
+                (scope) => scope.runId === firstRun?.id && scope.kind === "root_run",
+              );
+              return firstScope === undefined
+                ? undefined
+                : checkpointRefForScopeOrdinal({
+                    scopeId: firstScope.id,
+                    ordinalWithinScope: 0,
+                  });
+            })()
+          : readyCheckpoints.find((checkpoint) => checkpoint.appRunOrdinal === input.fromTurnCount)
+              ?.ref;
+      if (fromCheckpointRef === undefined) {
         return yield* new CheckpointRefUnavailableError({
           operation,
           threadId: input.threadId,
-          turnCount: input.toTurnCount,
-          checkpoint: "to",
+          turnCount: input.fromTurnCount,
+          checkpoint: "from",
         });
       }
 
       const diff = yield* checkpointStore
         .diffCheckpoints({
-          cwd: workspaceCwd,
+          cwd: toScope.cwd,
           fromCheckpointRef,
-          toCheckpointRef,
+          toCheckpointRef: toCheckpoint.ref,
           fallbackFromToHead: false,
           ignoreWhitespace,
         })
@@ -217,61 +232,12 @@ export const make = Effect.gen(function* () {
       return emptyDiff satisfies OrchestrationGetFullThreadDiffResult;
     }
 
-    const threadContext = yield* projectionSnapshotQuery
-      .getFullThreadDiffContext(input.threadId, input.toTurnCount)
-      .pipe(Effect.withSpan("checkpoint.fullThread.lookupContext"));
-
-    if (Option.isNone(threadContext)) {
-      return yield* new CheckpointThreadNotFoundError({
-        operation,
-        threadId: input.threadId,
-      });
-    }
-
-    if (input.toTurnCount > threadContext.value.latestCheckpointTurnCount) {
-      return yield* new CheckpointTurnRangeUnavailableError({
-        operation,
-        threadId: input.threadId,
-        requestedTurnCount: input.toTurnCount,
-        availableTurnCount: threadContext.value.latestCheckpointTurnCount,
-      });
-    }
-
-    const workspaceCwd = threadContext.value.worktreePath ?? threadContext.value.workspaceRoot;
-    if (!workspaceCwd) {
-      return yield* new CheckpointWorkspacePathMissingError({
-        operation,
-        threadId: input.threadId,
-      });
-    }
-
-    if (!threadContext.value.toCheckpointRef) {
-      return yield* new CheckpointRefUnavailableError({
-        operation,
-        threadId: input.threadId,
-        turnCount: input.toTurnCount,
-        checkpoint: "to",
-      });
-    }
-
-    const diff = yield* checkpointStore
-      .diffCheckpoints({
-        cwd: workspaceCwd,
-        fromCheckpointRef: checkpointRefForThreadTurn(input.threadId, 0),
-        toCheckpointRef: threadContext.value.toCheckpointRef as CheckpointRef,
-        fallbackFromToHead: false,
-        ignoreWhitespace,
-      })
-      .pipe(Effect.withSpan("checkpoint.fullThread.diffCheckpoints"));
-
-    const turnDiff = buildTurnDiffResult(
-      {
-        threadId: input.threadId,
-        fromTurnCount: 0,
-        toTurnCount: input.toTurnCount,
-      },
-      diff,
-    );
+    const turnDiff = yield* getTurnDiff({
+      threadId: input.threadId,
+      fromTurnCount: 0,
+      toTurnCount: input.toTurnCount,
+      ignoreWhitespace,
+    });
     if (!isTurnDiffResult(turnDiff)) {
       return yield* new CheckpointDiffResultInvalidError({
         operation,
diff --git a/apps/server/src/claudeModelOptions.test.ts b/apps/server/src/claudeModelOptions.test.ts
new file mode 100644
index 000000000000..005609008f33
--- /dev/null
+++ b/apps/server/src/claudeModelOptions.test.ts
@@ -0,0 +1,57 @@
+import { describe, expect, it } from "@effect/vitest";
+
+import { ProviderInstanceId, type ModelSelection } from "@t3tools/contracts";
+
+import { compileClaudeModelSelection } from "./claudeModelOptions.ts";
+
+const selection = (
+  model: string,
+  options: NonNullable<ModelSelection["options"]>,
+): ModelSelection => ({
+  instanceId: ProviderInstanceId.make("claude_test"),
+  model,
+  options,
+});
+
+describe("compileClaudeModelSelection", () => {
+  it("compiles context, effort, and settings together", () => {
+    expect(
+      compileClaudeModelSelection(
+        selection("claude-fable-5", [
+          { id: "contextWindow", value: "1m" },
+          { id: "effort", value: "ultracode" },
+        ]),
+      ),
+    ).toMatchObject({
+      apiModelId: "claude-fable-5[1m]",
+      effort: "xhigh",
+      settings: { ultracode: true },
+    });
+  });
+
+  it("compiles fast mode only for models that expose it", () => {
+    expect(
+      compileClaudeModelSelection(selection("claude-opus-4-6", [{ id: "fastMode", value: true }]))
+        .settings,
+    ).toEqual({ fastMode: true });
+    expect(
+      compileClaudeModelSelection(selection("claude-opus-4-6", [{ id: "fastMode", value: false }]))
+        .settings,
+    ).toEqual({ fastMode: false });
+  });
+
+  it("uses the model default SDK effort alongside prompt-injected effort", () => {
+    expect(
+      compileClaudeModelSelection(
+        selection("claude-sonnet-4-6", [{ id: "effort", value: "ultrathink" }]),
+      ),
+    ).toMatchObject({ effort: "high", promptEffort: "ultrathink" });
+  });
+
+  it("compiles the thinking toggle for models that expose it", () => {
+    expect(
+      compileClaudeModelSelection(selection("claude-haiku-4-5", [{ id: "thinking", value: false }]))
+        .settings,
+    ).toEqual({ alwaysThinkingEnabled: false });
+  });
+});
diff --git a/apps/server/src/claudeModelOptions.ts b/apps/server/src/claudeModelOptions.ts
new file mode 100644
index 000000000000..74909ad3d627
--- /dev/null
+++ b/apps/server/src/claudeModelOptions.ts
@@ -0,0 +1,56 @@
+import type { ModelSelection } from "@t3tools/contracts";
+import {
+  getModelSelectionBooleanOptionValue,
+  getModelSelectionStringOptionValue,
+  getProviderOptionDescriptors,
+  resolvePromptInjectedEffort,
+} from "@t3tools/shared/model";
+
+import {
+  getClaudeModelCapabilities,
+  isClaudeUltracodeEffort,
+  normalizeClaudeCliEffort,
+  resolveClaudeApiModelId,
+  resolveClaudeEffort,
+} from "./provider/Layers/ClaudeProvider.ts";
+
+export interface CompiledClaudeModelSelection {
+  readonly apiModelId: string;
+  readonly effort: string | undefined;
+  readonly promptEffort: string | undefined;
+  readonly settings: Readonly<Record<string, boolean>>;
+  readonly queryIdentity: string;
+}
+
+/** Compile every Claude model option at the provider boundary. */
+export function compileClaudeModelSelection(
+  selection: ModelSelection,
+): CompiledClaudeModelSelection {
+  const capabilities = getClaudeModelCapabilities(selection.model);
+  const descriptors = getProviderOptionDescriptors({ caps: capabilities });
+  const supportsBoolean = (id: string) =>
+    descriptors.some((descriptor) => descriptor.type === "boolean" && descriptor.id === id);
+  const rawEffort = getModelSelectionStringOptionValue(selection, "effort");
+  const resolvedEffort = resolveClaudeEffort(capabilities, rawEffort);
+  const effort = normalizeClaudeCliEffort(resolvedEffort, selection.model);
+  const fastMode = supportsBoolean("fastMode")
+    ? getModelSelectionBooleanOptionValue(selection, "fastMode")
+    : undefined;
+  const thinking = supportsBoolean("thinking")
+    ? getModelSelectionBooleanOptionValue(selection, "thinking")
+    : undefined;
+  const settings = {
+    ...(typeof thinking === "boolean" ? { alwaysThinkingEnabled: thinking } : {}),
+    ...(typeof fastMode === "boolean" ? { fastMode } : {}),
+    ...(isClaudeUltracodeEffort(resolvedEffort) ? { ultracode: true } : {}),
+  };
+  const apiModelId = resolveClaudeApiModelId(selection);
+  const promptEffort = resolvePromptInjectedEffort(capabilities, rawEffort) ?? undefined;
+  return {
+    apiModelId,
+    effort,
+    promptEffort,
+    settings,
+    queryIdentity: JSON.stringify({ apiModelId, effort: effort ?? null, settings }),
+  };
+}
diff --git a/apps/server/src/cli/project.test.ts b/apps/server/src/cli/project.test.ts
index 5395592c889a..a027e7c232a2 100644
--- a/apps/server/src/cli/project.test.ts
+++ b/apps/server/src/cli/project.test.ts
@@ -1,17 +1,94 @@
-import { assert, it } from "@effect/vitest";
+// @effect-diagnostics nodeBuiltinImport:off - CLI integration uses temporary Node paths.
+import * as NodeFS from "node:fs";
+import * as NodeOS from "node:os";
+import * as NodePath from "node:path";
 
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import { assert, it } from "@effect/vitest";
 import { EnvironmentInternalError } from "@t3tools/contracts";
+import * as NetService from "@t3tools/shared/Net";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as References from "effect/References";
+import { Command } from "effect/unstable/cli";
 
+import { cli } from "../bin.ts";
+import * as ServerConfig from "../config.ts";
+import { ProjectServiceLayerLive } from "../orchestration-v2/runtimeLayer.ts";
+import { layerConfig as SqlitePersistenceLayerLive } from "../persistence/Layers/Sqlite.ts";
+import * as ProjectEnrichmentService from "../project/ProjectEnrichmentService.ts";
+import * as ProjectFaviconResolver from "../project/ProjectFaviconResolver.ts";
+import * as ProjectService from "../project/ProjectService.ts";
+import * as RepositoryIdentityResolver from "../project/RepositoryIdentityResolver.ts";
+import * as T3ProjectFileLoader from "../project/T3ProjectFileLoader.ts";
+import * as WorkspacePaths from "../workspace/WorkspacePaths.ts";
 import {
   ProjectLiveServerDeclaredResponseError,
   ProjectLiveServerRequestError,
   projectCommandErrorFromLiveServerRequest,
 } from "./project.ts";
 
+const CliRuntimeLayer = Layer.mergeAll(NodeServices.layer, NetService.layer);
+const runCli = (args: ReadonlyArray<string>) =>
+  Command.runWith(cli, { version: "0.0.0" })(args).pipe(Effect.provide(CliRuntimeLayer));
+
+const makeConfig = (baseDir: string) =>
+  Effect.gen(function* () {
+    const derivedPaths = yield* ServerConfig.deriveServerPaths(baseDir, undefined);
+    return {
+      logLevel: "Info",
+      traceMinLevel: "Info",
+      traceTimingEnabled: true,
+      traceBatchWindowMs: 200,
+      traceMaxBytes: 10 * 1024 * 1024,
+      traceMaxFiles: 10,
+      otlpTracesUrl: undefined,
+      otlpMetricsUrl: undefined,
+      otlpExportIntervalMs: 10_000,
+      otlpServiceName: "t3-server",
+      mode: "web",
+      port: 0,
+      host: "127.0.0.1",
+      cwd: process.cwd(),
+      baseDir,
+      ...derivedPaths,
+      staticDir: undefined,
+      devUrl: undefined,
+      devAllowedOrigins: [],
+      noBrowser: true,
+      startupPresentation: "browser",
+      desktopBootstrapToken: undefined,
+      autoBootstrapProjectFromCwd: false,
+      logWebSocketEvents: false,
+      tailscaleServeEnabled: false,
+      tailscaleServePort: 443,
+    } satisfies ServerConfig.ServerConfig["Service"];
+  });
+
+const readProjects = (baseDir: string) =>
+  Effect.gen(function* () {
+    const config = yield* makeConfig(baseDir);
+    const layer = ProjectServiceLayerLive.pipe(
+      Layer.provideMerge(ProjectEnrichmentService.layer),
+      Layer.provideMerge(RepositoryIdentityResolver.layer),
+      Layer.provideMerge(ProjectFaviconResolver.layer),
+      Layer.provideMerge(T3ProjectFileLoader.layer),
+      Layer.provideMerge(WorkspacePaths.layer),
+      Layer.provideMerge(SqlitePersistenceLayerLive),
+      Layer.provideMerge(NodeServices.layer),
+      Layer.provide(ServerConfig.layer(config)),
+      Layer.provide(Layer.succeed(References.MinimumLogLevel, config.logLevel)),
+    );
+    return yield* ProjectService.ProjectService.pipe(
+      Effect.flatMap((projects) => projects.snapshot),
+      Effect.provide(layer),
+    );
+  });
+
 it("maps declared server failures into structural project command errors", () => {
   const cause = new EnvironmentInternalError({
     code: "internal_error",
-    reason: "orchestration_snapshot_failed",
+    reason: "access_token_issuance_failed",
     traceId: "trace-123",
   });
 
@@ -35,3 +112,23 @@ it("preserves unexpected server failures without deriving the message from them"
   assert.strictEqual(error.message, "Failed to call the running server.");
   assert.strictEqual(error.cause, cause);
 });
+
+it.effect("adds, renames, and removes projects through the V2 project CLI domain", () =>
+  Effect.gen(function* () {
+    const baseDir = NodeFS.mkdtempSync(NodePath.join(NodeOS.tmpdir(), "t3-v2-project-cli-"));
+    const workspaceRoot = NodeFS.mkdtempSync(
+      NodePath.join(NodeOS.tmpdir(), "t3-v2-project-workspace-"),
+    );
+
+    yield* runCli(["project", "add", workspaceRoot, "--title", "Alpha", "--base-dir", baseDir]);
+    const added = (yield* readProjects(baseDir)).projects[0];
+    assert.equal(added?.title, "Alpha");
+    assert.equal(added?.workspaceRoot, workspaceRoot);
+
+    yield* runCli(["project", "rename", workspaceRoot, "Beta", "--base-dir", baseDir]);
+    assert.equal((yield* readProjects(baseDir)).projects[0]?.title, "Beta");
+
+    yield* runCli(["project", "remove", added?.id ?? "", "--base-dir", baseDir]);
+    assert.deepEqual((yield* readProjects(baseDir)).projects, []);
+  }).pipe(Effect.provide(NodeServices.layer)),
+);
diff --git a/apps/server/src/cli/project.ts b/apps/server/src/cli/project.ts
index 39b3b2431129..611159b55f89 100644
--- a/apps/server/src/cli/project.ts
+++ b/apps/server/src/cli/project.ts
@@ -1,15 +1,14 @@
 import {
-  CommandId,
   AuthAdministrativeScopes,
+  CommandId,
   EnvironmentHttpApi,
   EnvironmentHttpCommonError,
-  type OrchestrationReadModel,
+  type ProjectMutation,
+  type ProjectSnapshot,
   ProjectId,
-  type ClientOrchestrationCommand,
 } from "@t3tools/contracts";
 import * as Console from "effect/Console";
 import * as Crypto from "effect/Crypto";
-import * as DateTime from "effect/DateTime";
 import * as Duration from "effect/Duration";
 import * as Effect from "effect/Effect";
 import * as FileSystem from "effect/FileSystem";
@@ -25,11 +24,13 @@ import * as HttpApiClient from "effect/unstable/httpapi/HttpApiClient";
 import * as EnvironmentAuth from "../auth/EnvironmentAuth.ts";
 
 import * as ServerConfig from "../config.ts";
-import * as OrchestrationEngine from "../orchestration/Services/OrchestrationEngine.ts";
-import * as ProjectionSnapshotQuery from "../orchestration/Services/ProjectionSnapshotQuery.ts";
-import { OrchestrationLayerLive } from "../orchestration/runtimeLayer.ts";
 import { layerConfig as SqlitePersistenceLayerLive } from "../persistence/Layers/Sqlite.ts";
+import { ProjectServiceLayerLive } from "../orchestration-v2/runtimeLayer.ts";
+import * as ProjectEnrichmentService from "../project/ProjectEnrichmentService.ts";
+import * as ProjectFaviconResolver from "../project/ProjectFaviconResolver.ts";
 import * as RepositoryIdentityResolver from "../project/RepositoryIdentityResolver.ts";
+import * as ProjectService from "../project/ProjectService.ts";
+import * as T3ProjectFileLoader from "../project/T3ProjectFileLoader.ts";
 import * as ServerRuntimeStartup from "../serverRuntimeStartup.ts";
 import {
   clearPersistedServerRuntimeState,
@@ -45,10 +46,7 @@ type ProjectMutationTarget = {
 };
 
 type ProjectCommandExecutionMode = "live" | "offline";
-type ProjectCliDispatchCommand = Extract<
-  ClientOrchestrationCommand,
-  { type: "project.create" | "project.meta.update" | "project.delete" }
->;
+type ProjectCliDispatchCommand = ProjectMutation;
 
 const isEnvironmentHttpCommonError = Schema.is(EnvironmentHttpCommonError);
 
@@ -198,12 +196,17 @@ const projectCommandUuid = Crypto.Crypto.pipe(
   ),
 );
 
-const ProjectCliRuntimeLive = Layer.mergeAll(
-  WorkspacePaths.layer,
-  OrchestrationLayerLive.pipe(
-    Layer.provideMerge(RepositoryIdentityResolver.layer),
-    Layer.provideMerge(SqlitePersistenceLayerLive),
+const ProjectCliRuntimeLive = ProjectServiceLayerLive.pipe(
+  Layer.provideMerge(ProjectEnrichmentService.layer),
+  Layer.provideMerge(RepositoryIdentityResolver.layer),
+  Layer.provideMerge(
+    ProjectFaviconResolver.layer.pipe(
+      Layer.provide(WorkspacePaths.layer),
+      Layer.provide(T3ProjectFileLoader.layer),
+    ),
   ),
+  Layer.provideMerge(WorkspacePaths.layer),
+  Layer.provideMerge(SqlitePersistenceLayerLive),
 );
 
 const PROJECT_CLI_LIVE_SERVER_TIMEOUT = Duration.seconds(1);
@@ -256,7 +259,7 @@ const resolveProjectTitle = Effect.fn("resolveProjectTitle")(function* (
 });
 
 const findActiveProjectTarget = Effect.fn("findActiveProjectTarget")(function* (input: {
-  readonly snapshot: OrchestrationReadModel;
+  readonly snapshot: ProjectSnapshot;
   readonly identifier: string;
 }) {
   const trimmedIdentifier = input.identifier.trim();
@@ -311,7 +314,7 @@ const findActiveProjectTarget = Effect.fn("findActiveProjectTarget")(function* (
 const fetchLiveOrchestrationSnapshot = (origin: string, bearerToken: string) =>
   Effect.gen(function* () {
     const client = yield* makeLiveServerClient(origin);
-    return yield* client.orchestration.snapshot({
+    return yield* client.projects.snapshot({
       headers: { authorization: `Bearer ${bearerToken}` },
     });
   }).pipe(
@@ -326,20 +329,18 @@ const dispatchLiveOrchestrationCommand = (
 ) =>
   Effect.gen(function* () {
     const client = yield* makeLiveServerClient(origin);
-    yield* client.orchestration.dispatch({
+    yield* client.projects.mutate({
       headers: { authorization: `Bearer ${bearerToken}` },
       payload: command,
-    } as Parameters<typeof client.orchestration.dispatch>[0]);
+    } as Parameters<typeof client.projects.mutate>[0]);
   }).pipe(
     withProjectCliLiveServerTimeout,
     Effect.mapError(projectCommandErrorFromLiveServerRequest),
   );
 
 const getOfflineSnapshot = Effect.fn("getOfflineSnapshot")(function* () {
-  const projectionSnapshotQuery = yield* ProjectionSnapshotQuery.ProjectionSnapshotQuery;
-  // Project commands only read the project list, so use the lightweight
-  // command read model instead of hydrating every thread body in the database.
-  return yield* projectionSnapshotQuery.getCommandReadModel();
+  const projects = yield* ProjectService.ProjectService;
+  return yield* projects.snapshot;
 });
 
 const tryResolveLiveProjectExecutionMode = Effect.fn("tryResolveLiveProjectExecutionMode")(
@@ -377,7 +378,7 @@ const tryResolveLiveProjectExecutionMode = Effect.fn("tryResolveLiveProjectExecu
 const runProjectMutation = Effect.fn("runProjectMutation")(function* (
   flags: CliAuthLocationFlags,
   run: (input: {
-    readonly snapshot: OrchestrationReadModel;
+    readonly snapshot: ProjectSnapshot;
     readonly dispatch: (
       command: ProjectCliDispatchCommand,
     ) => Effect.Effect<void, Error, FileSystem.FileSystem | HttpClient.HttpClient | Path.Path>;
@@ -422,10 +423,41 @@ const runProjectMutation = Effect.fn("runProjectMutation")(function* (
 
     return yield* Effect.gen(function* () {
       const snapshot = yield* getOfflineSnapshot();
-      const orchestrationEngine = yield* OrchestrationEngine.OrchestrationEngineService;
+      const projects = yield* ProjectService.ProjectService;
       const output = yield* run({
         snapshot,
-        dispatch: (command) => orchestrationEngine.dispatch(command),
+        dispatch: (command) =>
+          command.type === "project.create"
+            ? projects
+                .create({
+                  commandId: command.commandId,
+                  projectId: command.projectId,
+                  title: command.title,
+                  workspaceRoot: command.workspaceRoot,
+                  ...(command.defaultModelSelection === undefined
+                    ? {}
+                    : { defaultModelSelection: command.defaultModelSelection }),
+                  ...(command.scripts === undefined ? {} : { scripts: command.scripts }),
+                })
+                .pipe(Effect.asVoid)
+            : command.type === "project.update"
+              ? projects
+                  .update({
+                    commandId: command.commandId,
+                    projectId: command.projectId,
+                    ...(command.title === undefined ? {} : { title: command.title }),
+                    ...(command.workspaceRoot === undefined
+                      ? {}
+                      : { workspaceRoot: command.workspaceRoot }),
+                    ...(command.defaultModelSelection === undefined
+                      ? {}
+                      : { defaultModelSelection: command.defaultModelSelection }),
+                    ...(command.scripts === undefined ? {} : { scripts: command.scripts }),
+                  })
+                  .pipe(Effect.asVoid)
+              : projects
+                  .delete({ commandId: command.commandId, projectId: command.projectId })
+                  .pipe(Effect.asVoid),
         mode: "offline",
       });
       yield* Console.log(output);
@@ -456,7 +488,7 @@ const projectAddCommand = Command.make("add", {
         snapshot,
         dispatch,
       }: {
-        readonly snapshot: OrchestrationReadModel;
+        readonly snapshot: ProjectSnapshot;
         readonly dispatch: (
           command: ProjectCliDispatchCommand,
         ) => Effect.Effect<void, Error, FileSystem.FileSystem | HttpClient.HttpClient | Path.Path>;
@@ -482,7 +514,6 @@ const projectAddCommand = Command.make("add", {
           title,
           workspaceRoot,
           defaultModelSelection: ServerRuntimeStartup.getAutoBootstrapDefaultModelSelection(),
-          createdAt: DateTime.formatIso(yield* DateTime.now),
         });
         return `Added project ${projectId} (${title}) at ${workspaceRoot}.`;
       }),
@@ -508,7 +539,7 @@ const projectRemoveCommand = Command.make("remove", {
         snapshot,
         dispatch,
       }: {
-        readonly snapshot: OrchestrationReadModel;
+        readonly snapshot: ProjectSnapshot;
         readonly dispatch: (
           command: ProjectCliDispatchCommand,
         ) => Effect.Effect<void, Error, FileSystem.FileSystem | HttpClient.HttpClient | Path.Path>;
@@ -544,7 +575,7 @@ const projectRenameCommand = Command.make("rename", {
         snapshot,
         dispatch,
       }: {
-        readonly snapshot: OrchestrationReadModel;
+        readonly snapshot: ProjectSnapshot;
         readonly dispatch: (
           command: ProjectCliDispatchCommand,
         ) => Effect.Effect<void, Error, FileSystem.FileSystem | HttpClient.HttpClient | Path.Path>;
@@ -559,7 +590,7 @@ const projectRenameCommand = Command.make("rename", {
         }
 
         yield* dispatch({
-          type: "project.meta.update",
+          type: "project.update",
           commandId: CommandId.make(yield* projectCommandUuid),
           projectId: project.id,
           title: nextTitle,
diff --git a/apps/server/src/environment/ServerEnvironment.ts b/apps/server/src/environment/ServerEnvironment.ts
index 9c3a0d2a9637..5c2f8eed87ec 100644
--- a/apps/server/src/environment/ServerEnvironment.ts
+++ b/apps/server/src/environment/ServerEnvironment.ts
@@ -1,4 +1,5 @@
 import {
+  ORCHESTRATION_PROTOCOL_VERSION,
   EnvironmentId,
   PROVIDER_SEND_TURN_MAX_FILE_BYTES,
   type ExecutionEnvironmentDescriptor,
@@ -147,6 +148,7 @@ export const make = Effect.gen(function* () {
       arch: platformArch(hostArchitecture),
     },
     serverVersion: packageJson.version,
+    orchestrationProtocolVersion: ORCHESTRATION_PROTOCOL_VERSION,
     capabilities: {
       repositoryIdentity: true,
       connectionProbe: true,
@@ -159,6 +161,7 @@ export const make = Effect.gen(function* () {
       threadPinning: true,
       threadPinReorder: true,
       threadTitleRegeneration: true,
+      threadVisitedTracking: true,
       threadPullRequestLinking: true,
       ...(serverSelfUpdate === null ? {} : { serverSelfUpdate }),
       ...(serverSelfUpdate === "boot-service" ? { serverSelfUpdateProgress: true } : {}),
diff --git a/apps/server/src/git/GitWorkflowService.ts b/apps/server/src/git/GitWorkflowService.ts
index a73aa59d5516..3098c5aeaf83 100644
--- a/apps/server/src/git/GitWorkflowService.ts
+++ b/apps/server/src/git/GitWorkflowService.ts
@@ -65,6 +65,7 @@ export class GitWorkflowService extends Context.Service<
     readonly createWorktree: (
       input: VcsCreateWorktreeInput,
     ) => Effect.Effect<VcsCreateWorktreeResult, GitCommandError>;
+    readonly listLocalBranchNames: (cwd: string) => Effect.Effect<string[], GitCommandError>;
     readonly fetchRemote: (input: {
       readonly cwd: string;
       readonly remoteName: string;
@@ -87,6 +88,9 @@ export class GitWorkflowService extends Context.Service<
     readonly pruneWorktrees: (input: {
       readonly cwd: string;
     }) => Effect.Effect<void, GitCommandError>;
+    readonly deleteLocalBranch: (
+      input: GitVcsDriver.GitDeleteLocalBranchInput,
+    ) => Effect.Effect<void, GitCommandError>;
     readonly createRef: (
       input: VcsCreateRefInput,
     ) => Effect.Effect<VcsCreateRefResult, GitCommandError>;
@@ -306,6 +310,10 @@ export const make = Effect.gen(function* () {
       ensureGitCommand("GitWorkflowService.createWorktree", input.cwd).pipe(
         Effect.andThen(git.createWorktree(input)),
       ),
+    listLocalBranchNames: (cwd) =>
+      ensureGitCommand("GitWorkflowService.listLocalBranchNames", cwd).pipe(
+        Effect.andThen(git.listLocalBranchNames(cwd)),
+      ),
     fetchRemote: (input) =>
       ensureGitCommand("GitWorkflowService.fetchRemote", input.cwd).pipe(
         Effect.andThen(git.fetchRemote(input)),
@@ -326,6 +334,10 @@ export const make = Effect.gen(function* () {
       ensureGitCommand("GitWorkflowService.pruneWorktrees", input.cwd).pipe(
         Effect.andThen(git.pruneWorktrees(input)),
       ),
+    deleteLocalBranch: (input) =>
+      ensureGitCommand("GitWorkflowService.deleteLocalBranch", input.cwd).pipe(
+        Effect.andThen(git.deleteLocalBranch(input)),
+      ),
     createRef: (input) =>
       ensureGitCommand("GitWorkflowService.createRef", input.cwd).pipe(
         Effect.andThen(git.createRef(input)),
diff --git a/apps/server/src/http.test.ts b/apps/server/src/http.test.ts
index edb3967a078c..3174d645f1f0 100644
--- a/apps/server/src/http.test.ts
+++ b/apps/server/src/http.test.ts
@@ -1,13 +1,68 @@
 import { expect, it } from "@effect/vitest";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { HttpRouter, HttpServerResponse } from "effect/unstable/http";
 import { describe } from "vite-plus/test";
 
+import { ORCHESTRATION_PROTOCOL_HEADER } from "@t3tools/contracts";
+import * as NodeServices from "@effect/platform-node/NodeServices";
+
+import * as ServerConfig from "./config.ts";
+
 import {
   assetResponseHeaders,
+  browserApiCorsLayer,
   downloadContentDisposition,
   isLoopbackHostname,
   resolveDevRedirectUrl,
 } from "./http.ts";
 
+describe("browser API CORS", () => {
+  it("accepts protocol negotiation with authenticated browser headers", async () => {
+    const routeLayer = Layer.effectDiscard(
+      Effect.gen(function* () {
+        const router = yield* HttpRouter.HttpRouter;
+        yield* router.add("GET", "/api/environment", HttpServerResponse.empty());
+      }),
+    );
+    const appLayer = Layer.merge(routeLayer, browserApiCorsLayer).pipe(
+      Layer.provide(ServerConfig.layerTest(process.cwd(), { prefix: "http-cors-test-" })),
+      Layer.provide(NodeServices.layer),
+    );
+    const { handler, dispose } = HttpRouter.toWebHandler(appLayer, { disableLogger: true });
+
+    try {
+      const response = await handler(
+        new Request("https://backend.example/api/environment", {
+          method: "OPTIONS",
+          headers: {
+            origin: "https://app.t3.codes",
+            "access-control-request-method": "GET",
+            "access-control-request-headers": [
+              ORCHESTRATION_PROTOCOL_HEADER,
+              "authorization",
+              "dpop",
+            ].join(", "),
+          },
+        }),
+      );
+
+      expect(response.status).toBe(204);
+      expect(response.headers.get("access-control-allow-origin")).toBe("*");
+      const allowedHeaders = new Set(
+        (response.headers.get("access-control-allow-headers") ?? "")
+          .split(",")
+          .map((header) => header.trim().toLowerCase()),
+      );
+      expect(allowedHeaders.has(ORCHESTRATION_PROTOCOL_HEADER)).toBe(true);
+      expect(allowedHeaders.has("authorization")).toBe(true);
+      expect(allowedHeaders.has("dpop")).toBe(true);
+    } finally {
+      await dispose();
+    }
+  });
+});
+
 describe("http dev routing", () => {
   it("treats localhost and loopback addresses as local", () => {
     expect(isLoopbackHostname("127.0.0.1")).toBe(true);
diff --git a/apps/server/src/httpCors.ts b/apps/server/src/httpCors.ts
index aeb8dbce5a52..032a78624a83 100644
--- a/apps/server/src/httpCors.ts
+++ b/apps/server/src/httpCors.ts
@@ -5,6 +5,7 @@ export const browserApiCorsAllowedHeaders = [
   "traceparent",
   "content-type",
   "dpop",
+  ORCHESTRATION_PROTOCOL_HEADER,
 ] as const;
 
 export const browserApiCorsHeaders = {
@@ -12,3 +13,4 @@ export const browserApiCorsHeaders = {
   "access-control-allow-methods": browserApiCorsAllowedMethods.join(", "),
   "access-control-allow-headers": browserApiCorsAllowedHeaders.join(", "),
 } as const;
+import { ORCHESTRATION_PROTOCOL_HEADER } from "@t3tools/contracts";
diff --git a/apps/server/src/mcp/McpHttpServer.ts b/apps/server/src/mcp/McpHttpServer.ts
index 87975a49de2c..03492c3ef366 100644
--- a/apps/server/src/mcp/McpHttpServer.ts
+++ b/apps/server/src/mcp/McpHttpServer.ts
@@ -11,8 +11,11 @@ import { HttpRouter, HttpServerRequest, HttpServerResponse } from "effect/unstab
 
 import packageJson from "../../package.json" with { type: "json" };
 import * as McpInvocationContext from "./McpInvocationContext.ts";
+import * as OrchestratorMcpService from "./OrchestratorMcpService.ts";
 import * as McpSessionRegistry from "./McpSessionRegistry.ts";
 import * as PreviewAutomationBroker from "./PreviewAutomationBroker.ts";
+import { OrchestratorToolkitHandlersLive } from "./toolkits/orchestrator/handlers.ts";
+import { OrchestratorToolkit } from "./toolkits/orchestrator/tools.ts";
 import {
   PreviewSnapshotToolkitHandlersLive,
   PreviewStandardToolkitHandlersLive,
@@ -22,6 +25,9 @@ import {
   PreviewSnapshotToolkit,
   PreviewStandardToolkit,
 } from "./toolkits/preview/tools.ts";
+import { WorktreeToolkitHandlersLive } from "./toolkits/worktree/handlers.ts";
+import { WorktreeToolkit } from "./toolkits/worktree/tools.ts";
+import * as WorktreeMcpService from "./WorktreeMcpService.ts";
 
 const unauthorized = HttpServerResponse.jsonUnsafe(
   {
@@ -216,6 +222,16 @@ export const PreviewToolkitRegistrationLive = Layer.mergeAll(
   PreviewSnapshotRegistrationLive,
 );
 
+export const OrchestratorToolkitRegistrationLive = McpServer.toolkit(OrchestratorToolkit).pipe(
+  Layer.provide(OrchestratorToolkitHandlersLive),
+  Layer.provide(OrchestratorMcpService.layer),
+);
+
+export const WorktreeToolkitRegistrationLive = McpServer.toolkit(WorktreeToolkit).pipe(
+  Layer.provide(WorktreeToolkitHandlersLive),
+  Layer.provide(WorktreeMcpService.layer),
+);
+
 const McpTransportLive = McpServer.layerHttp({
   name: "T3 Code",
   version: packageJson.version,
@@ -223,4 +239,8 @@ const McpTransportLive = McpServer.layerHttp({
   protocols: [McpProtocol.v2025_06_18],
 }).pipe(Layer.provide(McpAuthMiddlewareLive));
 
-export const layer = PreviewToolkitRegistrationLive.pipe(Layer.provideMerge(McpTransportLive));
+export const layer = Layer.mergeAll(
+  PreviewToolkitRegistrationLive,
+  OrchestratorToolkitRegistrationLive,
+  WorktreeToolkitRegistrationLive,
+).pipe(Layer.provideMerge(McpTransportLive));
diff --git a/apps/server/src/mcp/McpInvocationContext.ts b/apps/server/src/mcp/McpInvocationContext.ts
index 49273485a44d..4f28874f1992 100644
--- a/apps/server/src/mcp/McpInvocationContext.ts
+++ b/apps/server/src/mcp/McpInvocationContext.ts
@@ -7,7 +7,8 @@ import {
 import * as Context from "effect/Context";
 import * as Effect from "effect/Effect";
 
-export type McpCapability = "preview";
+export const ALL_MCP_CAPABILITIES = ["preview", "orchestration", "worktree"] as const;
+export type McpCapability = (typeof ALL_MCP_CAPABILITIES)[number];
 
 export interface McpInvocationScope {
   readonly environmentId: EnvironmentId;
@@ -24,7 +25,7 @@ export class McpInvocationContext extends Context.Service<
 >()("t3/mcp/McpInvocationContext") {}
 
 export const requireMcpCapability = Effect.fn("mcp.requireCapability")(function* (
-  capability: McpCapability,
+  capability: "preview",
 ) {
   const invocation = yield* McpInvocationContext;
   if (!invocation.capabilities.has(capability)) {
diff --git a/apps/server/src/mcp/McpProviderSession.ts b/apps/server/src/mcp/McpProviderSession.ts
index d5dc582046c1..30d14385c3fd 100644
--- a/apps/server/src/mcp/McpProviderSession.ts
+++ b/apps/server/src/mcp/McpProviderSession.ts
@@ -7,6 +7,13 @@ export interface McpProviderSessionConfig {
   readonly providerInstanceId: ProviderInstanceId;
   readonly endpoint: string;
   readonly authorizationHeader: string;
+  /**
+   * Whether this credential includes the "preview" capability. Adapters read
+   * it to keep developer instructions truthful: when the user withholds agent
+   * browser access, the prompt must not advertise `preview_*` tools that every
+   * call would reject.
+   */
+  readonly browserToolsAvailable: boolean;
 }
 
 const sessionsByThread = new Map<ThreadId, McpProviderSessionConfig>();
diff --git a/apps/server/src/mcp/McpSessionRegistry.test.ts b/apps/server/src/mcp/McpSessionRegistry.test.ts
index 1d8aead99d0d..d693ab18ae50 100644
--- a/apps/server/src/mcp/McpSessionRegistry.test.ts
+++ b/apps/server/src/mcp/McpSessionRegistry.test.ts
@@ -46,6 +46,7 @@ it.effect("stores only a token hash, resolves the bearer token, and revokes by t
 
     const resolved = yield* registry.resolve(token);
     expect(resolved?.threadId).toBe(threadId);
+    expect(resolved?.capabilities).toEqual(new Set(["preview", "orchestration", "worktree"]));
 
     yield* registry.revokeThread(threadId);
     expect(yield* registry.resolve(token)).toBeUndefined();
diff --git a/apps/server/src/mcp/McpSessionRegistry.testkit.ts b/apps/server/src/mcp/McpSessionRegistry.testkit.ts
new file mode 100644
index 000000000000..623e8208a7a5
--- /dev/null
+++ b/apps/server/src/mcp/McpSessionRegistry.testkit.ts
@@ -0,0 +1,28 @@
+import { EnvironmentId } from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+
+import { McpSessionRegistry } from "./McpSessionRegistry.ts";
+
+export const layer = Layer.succeed(
+  McpSessionRegistry,
+  McpSessionRegistry.of({
+    issue: ({ threadId, providerInstanceId }) =>
+      Effect.succeed({
+        config: {
+          environmentId: EnvironmentId.make("environment:mcp-test"),
+          threadId,
+          providerSessionId: `mcp-test:${threadId}`,
+          providerInstanceId,
+          endpoint: "http://127.0.0.1/mcp",
+          authorizationHeader: `Bearer mcp-test:${threadId}`,
+          browserToolsAvailable: true,
+        },
+      }),
+    resolve: () => Effect.succeed(undefined),
+    touch: () => Effect.void,
+    revokeProviderSession: () => Effect.void,
+    revokeThread: () => Effect.void,
+    revokeAll: Effect.void,
+  }),
+);
diff --git a/apps/server/src/mcp/McpSessionRegistry.ts b/apps/server/src/mcp/McpSessionRegistry.ts
index f19a4f4e8c49..6feb38f9d487 100644
--- a/apps/server/src/mcp/McpSessionRegistry.ts
+++ b/apps/server/src/mcp/McpSessionRegistry.ts
@@ -14,6 +14,12 @@ import * as McpProviderSession from "./McpProviderSession.ts";
 export interface McpCredentialRequest {
   readonly threadId: ThreadId;
   readonly providerInstanceId: ProviderInstanceId;
+  /**
+   * When false, the credential is minted without the "preview" capability so
+   * the user's choice to withhold agent browser access holds everywhere the
+   * token is honored (#7083). Defaults to full access.
+   */
+  readonly browserToolsAvailable?: boolean;
 }
 
 export interface McpIssuedCredential {
@@ -123,12 +129,19 @@ const makeWithOptions = Effect.fn("McpSessionRegistry.make")(function* (
       const providerSessionId = yield* crypto.randomUUIDv4.pipe(Effect.orDie);
       const rawToken = yield* crypto.randomBytes(32).pipe(Effect.map(tokenFromBytes), Effect.orDie);
       const tokenHash = yield* hashToken(rawToken);
+      const browserToolsAvailable = request.browserToolsAvailable ?? true;
       const scope: McpInvocationContext.McpInvocationScope = {
         environmentId,
         threadId: ThreadId.make(request.threadId),
         providerSessionId,
         providerInstanceId: ProviderInstanceId.make(request.providerInstanceId),
-        capabilities: new Set(["preview"]),
+        capabilities: new Set(
+          browserToolsAvailable
+            ? McpInvocationContext.ALL_MCP_CAPABILITIES
+            : McpInvocationContext.ALL_MCP_CAPABILITIES.filter(
+                (capability) => capability !== "preview",
+              ),
+        ),
         issuedAt,
       };
       yield* SynchronizedRef.update(state, ({ records }) => {
@@ -144,6 +157,7 @@ const makeWithOptions = Effect.fn("McpSessionRegistry.make")(function* (
           providerInstanceId: scope.providerInstanceId,
           endpoint,
           authorizationHeader: `Bearer ${rawToken}`,
+          browserToolsAvailable,
         },
       };
     },
diff --git a/apps/server/src/mcp/OrchestratorMcpService.activity.test.ts b/apps/server/src/mcp/OrchestratorMcpService.activity.test.ts
new file mode 100644
index 000000000000..ccb4393684cf
--- /dev/null
+++ b/apps/server/src/mcp/OrchestratorMcpService.activity.test.ts
@@ -0,0 +1,307 @@
+import {
+  EnvironmentId,
+  NodeId,
+  type OrchestrationV2ThreadProjection,
+  ProjectId,
+  ProviderDriverKind,
+  ProviderInstanceId,
+  RunId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as NodeCrypto from "@effect/platform-node/NodeCrypto";
+import { expect, it } from "vite-plus/test";
+
+import { ProviderRegistry } from "../provider/Services/ProviderRegistry.ts";
+import { ScheduledTaskService } from "../scheduledTasks/ScheduledTaskService.ts";
+import { ThreadManagementService } from "../orchestration-v2/ThreadManagementService.ts";
+import type * as McpInvocationContext from "./McpInvocationContext.ts";
+import {
+  layer as orchestratorMcpServiceLayer,
+  OrchestratorMcpService,
+} from "./OrchestratorMcpService.ts";
+
+const environmentId = EnvironmentId.make("environment-mcp-orchestrator-detail");
+const projectId = ProjectId.make("project-mcp-orchestrator-detail");
+const parentThreadId = ThreadId.make("thread-mcp-orchestrator-parent");
+const childThreadId = ThreadId.make("thread-mcp-orchestrator-child");
+const activeRunId = RunId.make("run-mcp-active");
+const cancelledRunId = RunId.make("run-mcp-cancelled");
+const childRunId = RunId.make("run-mcp-child");
+const taskId = NodeId.make("node-mcp-task-1");
+const now = DateTime.makeUnsafe("2026-08-04T12:00:00.000Z");
+const codexDriver = ProviderDriverKind.make("codex");
+// Distinct from driver kind so a regression that re-derives from driver fails.
+const customCodexInstanceId = ProviderInstanceId.make("codex-custom-workspace");
+const parentInstanceId = ProviderInstanceId.make("codex");
+
+const makeScope = (): McpInvocationContext.McpInvocationScope => ({
+  environmentId,
+  threadId: parentThreadId,
+  providerSessionId: "provider-session-mcp-orchestrator-detail",
+  providerInstanceId: parentInstanceId,
+  capabilities: new Set(["orchestration"]),
+  issuedAt: 1,
+});
+
+function baseThread(input: {
+  readonly threadId: ThreadId;
+  readonly title: string;
+  readonly instanceId: ProviderInstanceId;
+  readonly model: string;
+}) {
+  return {
+    id: input.threadId,
+    projectId,
+    title: input.title,
+    createdBy: "user" as const,
+    creationSource: "mcp" as const,
+    modelSelection: {
+      instanceId: input.instanceId,
+      model: input.model,
+    },
+    runtimeMode: "full-access" as const,
+    interactionMode: "default" as const,
+    branch: null,
+    worktreePath: null,
+    lineage: {
+      parentThreadId: null,
+      relationshipToParent: null,
+      rootThreadId: input.threadId,
+    },
+    archivedAt: null,
+    deletedAt: null,
+    providerInstanceId: input.instanceId,
+    createdAt: now,
+    updatedAt: now,
+  };
+}
+
+function makeRun(input: {
+  readonly id: RunId;
+  readonly ordinal: number;
+  readonly status: "running" | "waiting" | "cancelled" | "queued" | "completed";
+  readonly instanceId?: ProviderInstanceId;
+}) {
+  return {
+    id: input.id,
+    ordinal: input.ordinal,
+    status: input.status,
+    modelSelection: {
+      instanceId: input.instanceId ?? parentInstanceId,
+      model: "gpt-5.4",
+    },
+    providerInstanceId: input.instanceId ?? parentInstanceId,
+    requestedAt: now,
+    startedAt: input.status === "cancelled" || input.status === "queued" ? null : now,
+    completedAt: input.status === "cancelled" || input.status === "completed" ? now : null,
+  };
+}
+
+it("readThread prefers activity-run status over a newer cancelled queued run", async () => {
+  const projection = {
+    thread: baseThread({
+      threadId: parentThreadId,
+      title: "Parent",
+      instanceId: parentInstanceId,
+      model: "gpt-5.4",
+    }),
+    runs: [
+      makeRun({ id: activeRunId, ordinal: 1, status: "running" }),
+      makeRun({ id: cancelledRunId, ordinal: 2, status: "cancelled" }),
+    ],
+    visibleTurnItems: [],
+    runtimeRequests: [],
+    messages: [],
+    contextTransfers: [],
+    subagents: [],
+    updatedAt: now,
+  } as unknown as OrchestrationV2ThreadProjection;
+
+  const layer = orchestratorMcpServiceLayer.pipe(
+    Layer.provide(
+      Layer.mergeAll(
+        Layer.mock(ThreadManagementService)({
+          getThreadProjection: (threadId) =>
+            threadId === parentThreadId
+              ? Effect.succeed(projection)
+              : Effect.die(`unexpected thread ${threadId}`),
+        } satisfies Partial<ThreadManagementService["Service"]>),
+        Layer.mock(ProviderRegistry)({
+          getProviders: Effect.succeed([]),
+        } satisfies Partial<ProviderRegistry["Service"]>),
+        Layer.mock(ScheduledTaskService)({
+          list: () => Effect.succeed({ tasks: [] }),
+        } satisfies Partial<ScheduledTaskService["Service"]>),
+        NodeCrypto.layer,
+      ),
+    ),
+  );
+
+  await Effect.gen(function* () {
+    const service = yield* OrchestratorMcpService;
+    const result = yield* service.readThread(makeScope(), { threadId: parentThreadId });
+    expect(result.thread.status).toBe("running");
+    expect(result.thread.latestRunId).toBe(cancelledRunId);
+    expect(result.thread.activeRunId).toBe(activeRunId);
+  }).pipe(Effect.provide(layer), Effect.runPromise);
+});
+
+it("readThread prefers waiting activity status over a newer cancelled queued run", async () => {
+  const projection = {
+    thread: baseThread({
+      threadId: parentThreadId,
+      title: "Parent waiting",
+      instanceId: parentInstanceId,
+      model: "gpt-5.4",
+    }),
+    runs: [
+      makeRun({ id: activeRunId, ordinal: 1, status: "waiting" }),
+      makeRun({ id: cancelledRunId, ordinal: 2, status: "cancelled" }),
+    ],
+    visibleTurnItems: [],
+    runtimeRequests: [],
+    messages: [],
+    contextTransfers: [],
+    subagents: [],
+    updatedAt: now,
+  } as unknown as OrchestrationV2ThreadProjection;
+
+  const layer = orchestratorMcpServiceLayer.pipe(
+    Layer.provide(
+      Layer.mergeAll(
+        Layer.mock(ThreadManagementService)({
+          getThreadProjection: (threadId) =>
+            threadId === parentThreadId
+              ? Effect.succeed(projection)
+              : Effect.die(`unexpected thread ${threadId}`),
+        } satisfies Partial<ThreadManagementService["Service"]>),
+        Layer.mock(ProviderRegistry)({
+          getProviders: Effect.succeed([]),
+        } satisfies Partial<ProviderRegistry["Service"]>),
+        Layer.mock(ScheduledTaskService)({
+          list: () => Effect.succeed({ tasks: [] }),
+        } satisfies Partial<ScheduledTaskService["Service"]>),
+        NodeCrypto.layer,
+      ),
+    ),
+  );
+
+  await Effect.gen(function* () {
+    const service = yield* OrchestratorMcpService;
+    const result = yield* service.readThread(makeScope(), { threadId: parentThreadId });
+    expect(result.thread.status).toBe("waiting");
+    expect(result.thread.activeRunId).toBe(activeRunId);
+  }).pipe(Effect.provide(layer), Effect.runPromise);
+});
+
+it("taskStatus returns task.providerInstanceId rather than the driver kind", async () => {
+  const parentProjection = {
+    thread: baseThread({
+      threadId: parentThreadId,
+      title: "Parent",
+      instanceId: parentInstanceId,
+      model: "gpt-5.4",
+    }),
+    runs: [makeRun({ id: activeRunId, ordinal: 1, status: "running" })],
+    visibleTurnItems: [],
+    runtimeRequests: [],
+    messages: [],
+    contextTransfers: [],
+    subagents: [
+      {
+        id: taskId,
+        threadId: parentThreadId,
+        runId: activeRunId,
+        parentNodeId: NodeId.make("node-parent"),
+        origin: "app_owned",
+        createdBy: "agent",
+        driver: codexDriver,
+        providerInstanceId: customCodexInstanceId,
+        providerThreadId: null,
+        childThreadId,
+        nativeTaskRef: null,
+        prompt: "Inspect the custom instance.",
+        title: null,
+        model: "gpt-5.4",
+        status: "running",
+        result: null,
+        startedAt: now,
+        completedAt: null,
+        updatedAt: now,
+      },
+    ],
+    updatedAt: now,
+  } as unknown as OrchestrationV2ThreadProjection;
+
+  const childProjection = {
+    thread: {
+      ...baseThread({
+        threadId: childThreadId,
+        title: "Child",
+        instanceId: customCodexInstanceId,
+        model: "gpt-5.4",
+      }),
+      lineage: {
+        parentThreadId,
+        relationshipToParent: "subagent",
+        rootThreadId: parentThreadId,
+      },
+      createdBy: "agent",
+    },
+    runs: [
+      makeRun({
+        id: childRunId,
+        ordinal: 1,
+        status: "running",
+        instanceId: customCodexInstanceId,
+      }),
+    ],
+    visibleTurnItems: [],
+    runtimeRequests: [],
+    messages: [],
+    contextTransfers: [
+      {
+        type: "subagent_spawn",
+        sourceThreadId: parentThreadId,
+        targetThreadId: childThreadId,
+        targetRunId: childRunId,
+      },
+    ],
+    subagents: [],
+    updatedAt: now,
+  } as unknown as OrchestrationV2ThreadProjection;
+
+  const layer = orchestratorMcpServiceLayer.pipe(
+    Layer.provide(
+      Layer.mergeAll(
+        Layer.mock(ThreadManagementService)({
+          getThreadProjection: (threadId) => {
+            if (threadId === parentThreadId) return Effect.succeed(parentProjection);
+            if (threadId === childThreadId) return Effect.succeed(childProjection);
+            return Effect.die(`unexpected thread ${threadId}`);
+          },
+        } satisfies Partial<ThreadManagementService["Service"]>),
+        Layer.mock(ProviderRegistry)({
+          getProviders: Effect.succeed([]),
+        } satisfies Partial<ProviderRegistry["Service"]>),
+        Layer.mock(ScheduledTaskService)({
+          list: () => Effect.succeed({ tasks: [] }),
+        } satisfies Partial<ScheduledTaskService["Service"]>),
+        NodeCrypto.layer,
+      ),
+    ),
+  );
+
+  await Effect.gen(function* () {
+    const service = yield* OrchestratorMcpService;
+    const result = yield* service.taskStatus(makeScope(), taskId);
+    expect(result.providerInstanceId).toBe(customCodexInstanceId);
+    expect(result.providerInstanceId).not.toBe(ProviderInstanceId.make(String(codexDriver)));
+    expect(result.status).toBe("running");
+    expect(result.taskId).toBe(taskId);
+    expect(result.childThreadId).toBe(childThreadId);
+  }).pipe(Effect.provide(layer), Effect.runPromise);
+});
diff --git a/apps/server/src/mcp/OrchestratorMcpService.test.ts b/apps/server/src/mcp/OrchestratorMcpService.test.ts
new file mode 100644
index 000000000000..d1fd1975003a
--- /dev/null
+++ b/apps/server/src/mcp/OrchestratorMcpService.test.ts
@@ -0,0 +1,292 @@
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import { assert, describe, it } from "@effect/vitest";
+import {
+  EnvironmentId,
+  NodeId,
+  ProviderInstanceId,
+  RunId,
+  ThreadId,
+  type OrchestrationV2ThreadProjection,
+} from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Ref from "effect/Ref";
+
+import { ThreadManagementService } from "../orchestration-v2/ThreadManagementService.ts";
+import { ProviderRegistry } from "../provider/Services/ProviderRegistry.ts";
+import { ScheduledTaskService } from "../scheduledTasks/ScheduledTaskService.ts";
+import type { McpInvocationScope } from "./McpInvocationContext.ts";
+import * as OrchestratorMcpService from "./OrchestratorMcpService.ts";
+
+describe("OrchestratorMcpService", () => {
+  it.effect("retries terminal acknowledgement with a fresh command id", () =>
+    Effect.gen(function* () {
+      const parentThreadId = ThreadId.make("thread:mcp-ack-parent");
+      const childThreadId = ThreadId.make("thread:mcp-ack-child");
+      const childRunId = RunId.make("run:mcp-ack-child");
+      const taskId = NodeId.make("node:mcp-ack-task");
+      const acknowledgementCommandIds = yield* Ref.make<ReadonlyArray<string>>([]);
+      const acknowledgementAttempts = yield* Ref.make(0);
+      const parentProjection = {
+        thread: { id: parentThreadId },
+        runs: [],
+        contextTransfers: [],
+        subagents: [
+          {
+            id: taskId,
+            threadId: parentThreadId,
+            origin: "app_owned",
+            childThreadId,
+            driver: "codex",
+            model: "gpt-5.6-terra",
+            result: "terminal result",
+            completionDelivery: { state: "pending" },
+          },
+        ],
+      } as unknown as OrchestrationV2ThreadProjection;
+      const childProjection = {
+        thread: { id: childThreadId },
+        runs: [{ id: childRunId, ordinal: 1, status: "completed" }],
+        contextTransfers: [],
+      } as unknown as OrchestrationV2ThreadProjection;
+      const dependencies = Layer.mergeAll(
+        NodeServices.layer,
+        Layer.mock(ThreadManagementService)({
+          getThreadProjection: (threadId) =>
+            Effect.succeed(threadId === parentThreadId ? parentProjection : childProjection),
+          dispatch: (command) =>
+            Ref.update(acknowledgementCommandIds, (commandIds) => [
+              ...commandIds,
+              String(command.commandId),
+            ]).pipe(
+              Effect.andThen(Ref.updateAndGet(acknowledgementAttempts, (count) => count + 1)),
+              Effect.flatMap((attempt) =>
+                attempt === 1
+                  ? Effect.fail(new Error("simulated acknowledgement failure") as never)
+                  : Effect.succeed({} as never),
+              ),
+            ),
+        }),
+        Layer.mock(ProviderRegistry)({ getProviders: Effect.succeed([]) }),
+        Layer.mock(ScheduledTaskService)({}),
+      );
+      const scope: McpInvocationScope = {
+        environmentId: EnvironmentId.make("environment:mcp-ack"),
+        threadId: parentThreadId,
+        providerSessionId: "provider-session:mcp-ack",
+        providerInstanceId: ProviderInstanceId.make("codex"),
+        capabilities: new Set(["orchestration"]),
+        issuedAt: 1,
+      };
+
+      yield* Effect.gen(function* () {
+        const service = yield* OrchestratorMcpService.OrchestratorMcpService;
+        const error = yield* service.taskStatus(scope, taskId).pipe(Effect.flip);
+        assert.equal(error.code, "orchestration_error");
+
+        const result = yield* service.taskStatus(scope, taskId);
+        assert.equal(result.status, "completed");
+        assert.equal(result.summary, "terminal result");
+        const commandIds = yield* Ref.get(acknowledgementCommandIds);
+        assert.equal(commandIds.length, 2);
+        assert.notEqual(commandIds[0], commandIds[1]);
+      }).pipe(Effect.provide(OrchestratorMcpService.layer.pipe(Layer.provide(dependencies))));
+    }),
+  );
+
+  it.effect("does not dispose delivery when a nonterminal task has no active child run", () =>
+    Effect.gen(function* () {
+      const parentThreadId = ThreadId.make("thread:mcp-cancel-parent");
+      const childThreadId = ThreadId.make("thread:mcp-cancel-child");
+      const taskId = NodeId.make("node:mcp-cancel-task");
+      const dispatched = yield* Ref.make<ReadonlyArray<unknown>>([]);
+      const parentProjection = {
+        thread: { id: parentThreadId },
+        runs: [],
+        contextTransfers: [],
+        subagents: [
+          {
+            id: taskId,
+            threadId: parentThreadId,
+            origin: "app_owned",
+            childThreadId,
+            driver: "codex",
+            model: "gpt-5.6-terra",
+            result: null,
+            completionDelivery: { state: "pending" },
+          },
+        ],
+      } as unknown as OrchestrationV2ThreadProjection;
+      const childProjection = {
+        thread: { id: childThreadId },
+        runs: [],
+        contextTransfers: [],
+      } as unknown as OrchestrationV2ThreadProjection;
+      const dependencies = Layer.mergeAll(
+        NodeServices.layer,
+        Layer.mock(ThreadManagementService)({
+          getThreadProjection: (threadId) =>
+            Effect.succeed(threadId === parentThreadId ? parentProjection : childProjection),
+          dispatch: (command) =>
+            Ref.update(dispatched, (commands) => [...commands, command]).pipe(
+              Effect.as({} as never),
+            ),
+        }),
+        Layer.mock(ProviderRegistry)({ getProviders: Effect.succeed([]) }),
+        Layer.mock(ScheduledTaskService)({}),
+      );
+      const scope: McpInvocationScope = {
+        environmentId: EnvironmentId.make("environment:mcp-cancel"),
+        threadId: parentThreadId,
+        providerSessionId: "provider-session:mcp-cancel",
+        providerInstanceId: ProviderInstanceId.make("codex"),
+        capabilities: new Set(["orchestration"]),
+        issuedAt: 1,
+      };
+
+      yield* Effect.gen(function* () {
+        const service = yield* OrchestratorMcpService.OrchestratorMcpService;
+        const error = yield* service
+          .cancelTask(scope, { taskId, clientRequestId: "cancel-unstarted-task" })
+          .pipe(Effect.flip);
+        assert.equal(error.code, "task_not_cancellable");
+        assert.deepEqual(yield* Ref.get(dispatched), []);
+      }).pipe(Effect.provide(OrchestratorMcpService.layer.pipe(Layer.provide(dependencies))));
+    }),
+  );
+
+  it.effect("does not dispose delivery when the child interrupt fails", () =>
+    Effect.gen(function* () {
+      const parentThreadId = ThreadId.make("thread:mcp-cancel-failed-parent");
+      const childThreadId = ThreadId.make("thread:mcp-cancel-failed-child");
+      const childRunId = RunId.make("run:mcp-cancel-failed-child");
+      const taskId = NodeId.make("node:mcp-cancel-failed-task");
+      const dispatched = yield* Ref.make<ReadonlyArray<unknown>>([]);
+      const parentProjection = {
+        thread: { id: parentThreadId },
+        runs: [],
+        contextTransfers: [],
+        subagents: [
+          {
+            id: taskId,
+            threadId: parentThreadId,
+            origin: "app_owned",
+            childThreadId,
+            driver: "codex",
+            model: "gpt-5.6-terra",
+            result: null,
+            completionDelivery: { state: "pending" },
+          },
+        ],
+      } as unknown as OrchestrationV2ThreadProjection;
+      const childProjection = {
+        thread: { id: childThreadId },
+        runs: [{ id: childRunId, status: "running" }],
+        contextTransfers: [],
+      } as unknown as OrchestrationV2ThreadProjection;
+      const dependencies = Layer.mergeAll(
+        NodeServices.layer,
+        Layer.mock(ThreadManagementService)({
+          getThreadProjection: (threadId) =>
+            Effect.succeed(threadId === parentThreadId ? parentProjection : childProjection),
+          dispatch: (command) =>
+            Ref.update(dispatched, (commands) => [...commands, command]).pipe(
+              Effect.andThen(Effect.fail(new Error("simulated interrupt failure") as never)),
+            ),
+        }),
+        Layer.mock(ProviderRegistry)({ getProviders: Effect.succeed([]) }),
+        Layer.mock(ScheduledTaskService)({}),
+      );
+      const scope: McpInvocationScope = {
+        environmentId: EnvironmentId.make("environment:mcp-cancel-failed"),
+        threadId: parentThreadId,
+        providerSessionId: "provider-session:mcp-cancel-failed",
+        providerInstanceId: ProviderInstanceId.make("codex"),
+        capabilities: new Set(["orchestration"]),
+        issuedAt: 1,
+      };
+
+      yield* Effect.gen(function* () {
+        const service = yield* OrchestratorMcpService.OrchestratorMcpService;
+        const error = yield* service
+          .cancelTask(scope, { taskId, clientRequestId: "cancel-failed-task" })
+          .pipe(Effect.flip);
+        assert.equal(error.code, "task_not_cancellable");
+        assert.deepEqual(
+          (yield* Ref.get(dispatched)).map((command) => (command as { type: string }).type),
+          ["run.interrupt"],
+        );
+      }).pipe(Effect.provide(OrchestratorMcpService.layer.pipe(Layer.provide(dependencies))));
+    }),
+  );
+
+  it.effect("returns cancel requested when post-interrupt disposal fails", () =>
+    Effect.gen(function* () {
+      const parentThreadId = ThreadId.make("thread:mcp-cancel-dispose-failed-parent");
+      const childThreadId = ThreadId.make("thread:mcp-cancel-dispose-failed-child");
+      const childRunId = RunId.make("run:mcp-cancel-dispose-failed-child");
+      const taskId = NodeId.make("node:mcp-cancel-dispose-failed-task");
+      const dispatched = yield* Ref.make<ReadonlyArray<unknown>>([]);
+      const parentProjection = {
+        thread: { id: parentThreadId },
+        runs: [],
+        contextTransfers: [],
+        subagents: [
+          {
+            id: taskId,
+            threadId: parentThreadId,
+            origin: "app_owned",
+            childThreadId,
+            driver: "codex",
+            model: "gpt-5.6-terra",
+            result: null,
+            completionDelivery: { state: "pending" },
+          },
+        ],
+      } as unknown as OrchestrationV2ThreadProjection;
+      const childProjection = {
+        thread: { id: childThreadId },
+        runs: [{ id: childRunId, status: "running" }],
+        contextTransfers: [],
+      } as unknown as OrchestrationV2ThreadProjection;
+      const dependencies = Layer.mergeAll(
+        NodeServices.layer,
+        Layer.mock(ThreadManagementService)({
+          getThreadProjection: (threadId) =>
+            Effect.succeed(threadId === parentThreadId ? parentProjection : childProjection),
+          dispatch: (command) =>
+            Ref.update(dispatched, (commands) => [...commands, command]).pipe(
+              Effect.andThen(
+                command.type === "delegated_task.completion-delivery.dispose"
+                  ? Effect.fail(new Error("simulated disposal failure") as never)
+                  : Effect.succeed({} as never),
+              ),
+            ),
+        }),
+        Layer.mock(ProviderRegistry)({ getProviders: Effect.succeed([]) }),
+        Layer.mock(ScheduledTaskService)({}),
+      );
+      const scope: McpInvocationScope = {
+        environmentId: EnvironmentId.make("environment:mcp-cancel-dispose-failed"),
+        threadId: parentThreadId,
+        providerSessionId: "provider-session:mcp-cancel-dispose-failed",
+        providerInstanceId: ProviderInstanceId.make("codex"),
+        capabilities: new Set(["orchestration"]),
+        issuedAt: 1,
+      };
+
+      yield* Effect.gen(function* () {
+        const service = yield* OrchestratorMcpService.OrchestratorMcpService;
+        const result = yield* service.cancelTask(scope, {
+          taskId,
+          clientRequestId: "cancel-dispose-failed-task",
+        });
+        assert.equal(result.status, "cancel_requested");
+        assert.deepEqual(
+          (yield* Ref.get(dispatched)).map((command) => (command as { type: string }).type),
+          ["run.interrupt", "delegated_task.completion-delivery.dispose"],
+        );
+      }).pipe(Effect.provide(OrchestratorMcpService.layer.pipe(Layer.provide(dependencies))));
+    }),
+  );
+});
diff --git a/apps/server/src/mcp/OrchestratorMcpService.ts b/apps/server/src/mcp/OrchestratorMcpService.ts
new file mode 100644
index 000000000000..7d7bd24f02de
--- /dev/null
+++ b/apps/server/src/mcp/OrchestratorMcpService.ts
@@ -0,0 +1,1681 @@
+import {
+  CommandId,
+  isProviderAvailable,
+  MessageId,
+  type ModelSelection,
+  NodeId,
+  type OrchestrationV2Run,
+  type OrchestrationV2Subagent,
+  type OrchestrationV2ThreadProjection,
+  type OrchestrationV2ThreadShell,
+  type OrchestrationV2TurnItem,
+  OrchestratorMcpFailure,
+  type OrchestratorMcpCapabilitiesResult,
+  type OrchestratorMcpCreateThreadsInput,
+  type OrchestratorMcpCreateThreadsResult,
+  type OrchestratorMcpCreatedThread,
+  type OrchestratorMcpDelegateTaskInput,
+  type OrchestratorMcpDelegateTaskResult,
+  type OrchestratorMcpInteractionMode,
+  type OrchestratorMcpDeleteScheduledTaskInput,
+  type OrchestratorMcpDeleteScheduledTaskResult,
+  type OrchestratorMcpListScheduledTasksResult,
+  type OrchestratorMcpRuntimeMode,
+  type OrchestratorMcpScheduledTask,
+  type OrchestratorMcpScheduleTaskInput,
+  type OrchestratorMcpScheduleTaskResult,
+  type OrchestratorMcpTarget,
+  type OrchestratorMcpTaskCancelInput,
+  type OrchestratorMcpTaskCancelResult,
+  type OrchestratorMcpUpdateScheduledTaskInput,
+  type OrchestratorMcpThreadDetail,
+  type OrchestratorMcpThreadInterruptInput,
+  type OrchestratorMcpThreadInterruptResult,
+  type OrchestratorMcpThreadListInput,
+  type OrchestratorMcpThreadListItem,
+  type OrchestratorMcpThreadListResult,
+  type OrchestratorMcpThreadReadInput,
+  type OrchestratorMcpThreadReadResult,
+  type OrchestratorMcpThreadRun,
+  type OrchestratorMcpThreadSendInput,
+  type OrchestratorMcpThreadSendResult,
+  type OrchestratorMcpThreadTimelineItem,
+  type OrchestratorMcpThreadWaitInput,
+  type OrchestratorMcpThreadWaitResult,
+  type ProviderInteractionMode,
+  type ProviderOptionDescriptor,
+  type ProviderOptionSelection,
+  type RuntimeMode,
+  type ScheduledTask,
+  type ScheduledTaskUpsertInput,
+  type ServerProvider,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as Context from "effect/Context";
+import * as Crypto from "effect/Crypto";
+import * as DateTime from "effect/DateTime";
+import * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Schema from "effect/Schema";
+
+import { isBuiltInProviderAdapterDriverV2 } from "../orchestration-v2/builtInProviderAdapterDrivers.ts";
+import { subagentResultForRun } from "../orchestration-v2/SubagentProjection.ts";
+import {
+  isActiveRun,
+  latestActiveRun,
+  latestRun,
+  ThreadManagementError,
+  ThreadManagementService,
+} from "../orchestration-v2/ThreadManagementService.ts";
+import { ProviderRegistry } from "../provider/Services/ProviderRegistry.ts";
+import { ScheduledTaskService } from "../scheduledTasks/ScheduledTaskService.ts";
+import type { McpInvocationScope } from "./McpInvocationContext.ts";
+
+const DEFAULT_WAIT_TIMEOUT_MS = 10 * 60 * 1_000;
+const MAX_WAIT_TIMEOUT_MS = 60 * 60 * 1_000;
+const TASK_POLL_INTERVAL_MS = 50;
+const DEFAULT_THREAD_LIST_LIMIT = 50;
+const DEFAULT_THREAD_READ_LIMIT = 50;
+const DEFAULT_THREAD_RUN_LIMIT = 10;
+const DEFAULT_THREAD_ITEM_MAX_CHARS = 20_000;
+
+interface ResolvedTarget {
+  readonly modelSelection: ModelSelection;
+}
+
+type TerminalTaskStatus = Extract<
+  OrchestratorMcpDelegateTaskResult["status"],
+  "completed" | "failed" | "cancelled" | "interrupted"
+>;
+
+export interface OrchestratorMcpServiceShape {
+  readonly capabilities: (
+    scope: McpInvocationScope,
+  ) => Effect.Effect<OrchestratorMcpCapabilitiesResult, OrchestratorMcpFailure>;
+  readonly delegateTask: (
+    scope: McpInvocationScope,
+    input: OrchestratorMcpDelegateTaskInput,
+  ) => Effect.Effect<OrchestratorMcpDelegateTaskResult, OrchestratorMcpFailure>;
+  readonly taskStatus: (
+    scope: McpInvocationScope,
+    taskId: NodeId,
+  ) => Effect.Effect<OrchestratorMcpDelegateTaskResult, OrchestratorMcpFailure>;
+  readonly cancelTask: (
+    scope: McpInvocationScope,
+    input: OrchestratorMcpTaskCancelInput,
+  ) => Effect.Effect<OrchestratorMcpTaskCancelResult, OrchestratorMcpFailure>;
+  readonly createThreads: (
+    scope: McpInvocationScope,
+    input: OrchestratorMcpCreateThreadsInput,
+  ) => Effect.Effect<OrchestratorMcpCreateThreadsResult, OrchestratorMcpFailure>;
+  readonly scheduleTask: (
+    scope: McpInvocationScope,
+    input: OrchestratorMcpScheduleTaskInput,
+  ) => Effect.Effect<OrchestratorMcpScheduleTaskResult, OrchestratorMcpFailure>;
+  readonly listScheduledTasks: (
+    scope: McpInvocationScope,
+  ) => Effect.Effect<OrchestratorMcpListScheduledTasksResult, OrchestratorMcpFailure>;
+  readonly updateScheduledTask: (
+    scope: McpInvocationScope,
+    input: OrchestratorMcpUpdateScheduledTaskInput,
+  ) => Effect.Effect<OrchestratorMcpScheduleTaskResult, OrchestratorMcpFailure>;
+  readonly deleteScheduledTask: (
+    scope: McpInvocationScope,
+    input: OrchestratorMcpDeleteScheduledTaskInput,
+  ) => Effect.Effect<OrchestratorMcpDeleteScheduledTaskResult, OrchestratorMcpFailure>;
+  readonly listThreads: (
+    scope: McpInvocationScope,
+    input: OrchestratorMcpThreadListInput,
+  ) => Effect.Effect<OrchestratorMcpThreadListResult, OrchestratorMcpFailure>;
+  readonly readThread: (
+    scope: McpInvocationScope,
+    input: OrchestratorMcpThreadReadInput,
+  ) => Effect.Effect<OrchestratorMcpThreadReadResult, OrchestratorMcpFailure>;
+  readonly sendToThread: (
+    scope: McpInvocationScope,
+    input: OrchestratorMcpThreadSendInput,
+  ) => Effect.Effect<OrchestratorMcpThreadSendResult, OrchestratorMcpFailure>;
+  readonly waitForThread: (
+    scope: McpInvocationScope,
+    input: OrchestratorMcpThreadWaitInput,
+  ) => Effect.Effect<OrchestratorMcpThreadWaitResult, OrchestratorMcpFailure>;
+  readonly interruptThread: (
+    scope: McpInvocationScope,
+    input: OrchestratorMcpThreadInterruptInput,
+  ) => Effect.Effect<OrchestratorMcpThreadInterruptResult, OrchestratorMcpFailure>;
+}
+
+export class OrchestratorMcpService extends Context.Service<
+  OrchestratorMcpService,
+  OrchestratorMcpServiceShape
+>()("t3/mcp/OrchestratorMcpService") {}
+
+const isThreadManagementError = Schema.is(ThreadManagementError);
+
+function failure(code: OrchestratorMcpFailure["code"], message: string): OrchestratorMcpFailure {
+  return new OrchestratorMcpFailure({ code, message });
+}
+
+function threadManagementFailure(error: ThreadManagementError): OrchestratorMcpFailure {
+  switch (error._tag) {
+    case "ThreadManagementThreadNotFoundError":
+      return failure("thread_not_found", error.message);
+    case "ThreadManagementRunNotFoundError":
+      return failure("run_not_found", error.message);
+    case "ThreadManagementThreadArchivedError":
+    case "ThreadManagementNoSteerableRunError":
+      return failure("thread_not_sendable", error.message);
+    case "ThreadManagementThreadNotInterruptibleError":
+      return failure("thread_not_interruptible", error.message);
+    case "ThreadManagementProjectionLoadError":
+    case "ThreadManagementProjectThreadsListError":
+    case "ThreadManagementDurableRunProjectionError":
+      return failure("orchestration_error", error.message);
+  }
+}
+
+function errorMessage(error: unknown): string {
+  return error instanceof Error ? error.message : String(error);
+}
+
+/**
+ * Workspace strategy for a scheduled task created/updated over MCP: bound runs
+ * post into the existing thread (the strategy is unused, keep root); unbound
+ * runs launch a fresh worktree per run.
+ */
+function scheduledTaskWorkspaceStrategy(
+  boundToThread: boolean,
+): ScheduledTask["workspaceStrategy"] {
+  return boundToThread
+    ? { type: "root" }
+    : { type: "worktree", baseRef: "main", startFromOrigin: true };
+}
+
+function scheduledTaskSummary(task: ScheduledTask): OrchestratorMcpScheduledTask {
+  return {
+    scheduledTaskId: task.id,
+    title: task.title,
+    prompt: task.prompt,
+    enabled: task.enabled,
+    projectId: task.projectId,
+    boundThreadId: task.threadId,
+    schedule: task.schedule,
+    nextRunAt: task.nextRunAt,
+    lastRunStatus: task.lastRunStatus,
+  };
+}
+
+function providerConstraints(
+  provider: ServerProvider | undefined,
+  supportsOrchestrationV2: boolean,
+): ReadonlyArray<string> {
+  const constraints: Array<string> = [];
+  if (!supportsOrchestrationV2) {
+    constraints.push("No V2 provider adapter is registered.");
+  }
+  if (provider === undefined) return constraints;
+  if (!provider.enabled) constraints.push("Provider instance is disabled.");
+  if (!provider.installed) constraints.push("Provider executable is not installed.");
+  if (!isProviderAvailable(provider)) {
+    constraints.push(provider.unavailableReason ?? "Provider driver is unavailable.");
+  }
+  if (provider.status === "error" || provider.status === "disabled") {
+    constraints.push(provider.message ?? `Provider status is ${provider.status}.`);
+  }
+  if (provider.auth.status === "unauthenticated") {
+    constraints.push("Provider is not authenticated.");
+  }
+  return constraints;
+}
+
+/**
+ * Checks requested option selections for duplicates and, when the model
+ * advertises option descriptors, against those descriptors. Models without
+ * descriptors skip the descriptor checks (mirroring how model slugs are only
+ * validated when the provider advertises models), but duplicate ids always
+ * fail: downstream consumers disagree on whether the first or last value of
+ * a duplicated id wins.
+ */
+function invalidOptionSelections(
+  selections: ReadonlyArray<ProviderOptionSelection>,
+  descriptors: ReadonlyArray<ProviderOptionDescriptor> | undefined,
+): ReadonlyArray<string> {
+  const problems: Array<string> = [];
+  const seen = new Set<string>();
+  for (const selection of selections) {
+    if (seen.has(selection.id)) {
+      problems.push(`Option ${selection.id} was specified more than once.`);
+      continue;
+    }
+    seen.add(selection.id);
+    if (descriptors === undefined) continue;
+    const descriptor = descriptors.find((candidate) => candidate.id === selection.id);
+    if (descriptor === undefined) {
+      const known = descriptors.map((candidate) => candidate.id).join(", ");
+      problems.push(`Unknown option ${selection.id}; supported options: ${known || "none"}.`);
+      continue;
+    }
+    if (descriptor.type === "boolean" && typeof selection.value !== "boolean") {
+      problems.push(`Option ${selection.id} expects a boolean value.`);
+      continue;
+    }
+    if (
+      descriptor.type === "select" &&
+      !descriptor.options.some((choice) => choice.id === selection.value)
+    ) {
+      const choices = descriptor.options.map((choice) => choice.id).join(", ");
+      problems.push(`Option ${selection.id} must be one of: ${choices}.`);
+    }
+  }
+  return problems;
+}
+
+function taskStatusForRun(
+  run: OrchestrationV2Run | undefined,
+): OrchestratorMcpDelegateTaskResult["status"] {
+  switch (run?.status) {
+    case "queued":
+      return "queued";
+    case "waiting":
+      return "waiting";
+    case "completed":
+      return "completed";
+    case "failed":
+      return "failed";
+    case "cancelled":
+    case "rolled_back":
+      return "cancelled";
+    case "interrupted":
+      return "interrupted";
+    case "preparing":
+    case "starting":
+    case "running":
+    case undefined:
+      return "running";
+  }
+}
+
+function delegatedTaskRun(
+  childProjection: OrchestrationV2ThreadProjection,
+  task: OrchestrationV2Subagent,
+): OrchestrationV2Run | undefined {
+  const spawnTransfer = childProjection.contextTransfers.find(
+    (transfer) =>
+      transfer.type === "subagent_spawn" &&
+      transfer.sourceThreadId === task.threadId &&
+      transfer.targetThreadId === task.childThreadId,
+  );
+  if (spawnTransfer === undefined) {
+    // Legacy delegated-task projections predate the durable spawn transfer.
+    return latestRun(childProjection);
+  }
+  return spawnTransfer.targetRunId === null
+    ? undefined
+    : childProjection.runs.find((run) => run.id === spawnTransfer.targetRunId);
+}
+
+function isTerminalTaskStatus(
+  status: OrchestratorMcpDelegateTaskResult["status"],
+): status is TerminalTaskStatus {
+  return (
+    status === "completed" ||
+    status === "failed" ||
+    status === "cancelled" ||
+    status === "interrupted"
+  );
+}
+
+function directAppOwnedChildTask(
+  parent: OrchestrationV2ThreadProjection,
+  target: OrchestrationV2ThreadProjection,
+): OrchestrationV2Subagent | undefined {
+  if (
+    target.thread.lineage.parentThreadId !== parent.thread.id ||
+    target.thread.lineage.relationshipToParent !== "subagent"
+  ) {
+    return undefined;
+  }
+  return parent.subagents.find(
+    (task) =>
+      task.origin === "app_owned" &&
+      task.threadId === parent.thread.id &&
+      task.childThreadId === target.thread.id,
+  );
+}
+
+function pageIncludesTerminalTaskResult(input: {
+  readonly page: ReadonlyArray<OrchestrationV2ThreadProjection["visibleTurnItems"][number]>;
+  readonly task: OrchestrationV2Subagent;
+  readonly target: OrchestrationV2ThreadProjection;
+  readonly maxChars: number;
+}): boolean {
+  const run = delegatedTaskRun(input.target, input.task);
+  if (run === undefined || !isTerminalTaskStatus(taskStatusForRun(run))) return false;
+
+  const result = subagentResultForRun(input.target, run);
+  if (result.messageId === null && result.turnItemId === null) return false;
+
+  return input.page.some((row) => {
+    if (row.sourceThreadId !== input.target.thread.id) return false;
+    const matchesResult =
+      (result.turnItemId !== null && row.sourceItemId === result.turnItemId) ||
+      (result.messageId !== null &&
+        row.item.type === "assistant_message" &&
+        row.item.messageId === result.messageId);
+    if (!matchesResult) return false;
+
+    const text = turnItemText(row.item);
+    return text !== null && text.length <= input.maxChars;
+  });
+}
+
+function runtimeModeRank(mode: RuntimeMode): number {
+  switch (mode) {
+    case "approval-required":
+      return 0;
+    case "auto-accept-edits":
+      return 1;
+    case "auto":
+      return 2;
+    case "full-access":
+      return 3;
+  }
+}
+
+function interactionModeRank(mode: ProviderInteractionMode): number {
+  return mode === "plan" ? 0 : 1;
+}
+
+function resolveRuntimeMode(
+  parentMode: RuntimeMode,
+  requested: OrchestratorMcpRuntimeMode | undefined,
+): Effect.Effect<RuntimeMode, OrchestratorMcpFailure> {
+  const resolved = requested === undefined || requested === "inherit" ? parentMode : requested;
+  return runtimeModeRank(resolved) > runtimeModeRank(parentMode)
+    ? Effect.fail(
+        failure(
+          "runtime_mode_escalation_denied",
+          `Child runtime mode ${resolved} is broader than parent mode ${parentMode}.`,
+        ),
+      )
+    : Effect.succeed(resolved);
+}
+
+function resolveInteractionMode(
+  parentMode: ProviderInteractionMode,
+  requested: OrchestratorMcpInteractionMode | undefined,
+): Effect.Effect<ProviderInteractionMode, OrchestratorMcpFailure> {
+  const resolved = requested === undefined || requested === "inherit" ? parentMode : requested;
+  return interactionModeRank(resolved) > interactionModeRank(parentMode)
+    ? Effect.fail(
+        failure(
+          "interaction_mode_escalation_denied",
+          `Child interaction mode ${resolved} is broader than parent mode ${parentMode}.`,
+        ),
+      )
+    : Effect.succeed(resolved);
+}
+
+function stablePart(value: string): string {
+  return encodeURIComponent(value);
+}
+
+function stableCommandId(input: {
+  readonly scope: McpInvocationScope;
+  readonly requestKey: string;
+  readonly operation: string;
+  readonly index?: number;
+}): CommandId {
+  return CommandId.make(
+    [
+      "command",
+      "mcp",
+      stablePart(input.scope.providerSessionId),
+      stablePart(input.operation),
+      stablePart(input.requestKey),
+      ...(input.index === undefined ? [] : [String(input.index)]),
+    ].join(":"),
+  );
+}
+
+function stableThreadId(input: {
+  readonly scope: McpInvocationScope;
+  readonly requestKey: string;
+  readonly index: number;
+}): ThreadId {
+  return ThreadId.make(
+    [
+      "thread",
+      "mcp",
+      stablePart(input.scope.providerSessionId),
+      stablePart(input.requestKey),
+      String(input.index),
+    ].join(":"),
+  );
+}
+
+function stableMessageId(input: {
+  readonly scope: McpInvocationScope;
+  readonly requestKey: string;
+  readonly index: number;
+}): MessageId {
+  return MessageId.make(
+    [
+      "message",
+      "mcp",
+      stablePart(input.scope.providerSessionId),
+      stablePart(input.requestKey),
+      String(input.index),
+    ].join(":"),
+  );
+}
+
+function stableOperationMessageId(input: {
+  readonly scope: McpInvocationScope;
+  readonly requestKey: string;
+  readonly operation: string;
+}): MessageId {
+  return MessageId.make(
+    [
+      "message",
+      "mcp",
+      stablePart(input.scope.providerSessionId),
+      stablePart(input.operation),
+      stablePart(input.requestKey),
+    ].join(":"),
+  );
+}
+
+function threadTitle(input: {
+  readonly parentTitle: string;
+  readonly prompt: string | undefined;
+  readonly title: string | undefined;
+  readonly index: number;
+}): string {
+  const detail = input.title?.trim() || input.prompt?.trim();
+  if (!detail) return `${input.parentTitle} thread ${input.index + 1}`;
+  return detail.length > 80 ? `${detail.slice(0, 77)}...` : detail;
+}
+
+function taskPrompt(input: OrchestratorMcpDelegateTaskInput): string {
+  return input.role === undefined || input.role === "general"
+    ? input.task
+    : `Act as the ${input.role} sub-agent for this task.\n\n${input.task}`;
+}
+
+function listItemFromShell(shell: OrchestrationV2ThreadShell): OrchestratorMcpThreadListItem {
+  return {
+    threadId: shell.id,
+    title: shell.title,
+    createdBy: shell.createdBy,
+    creationSource: shell.creationSource,
+    status: shell.activityRunStatus ?? shell.status,
+    latestRunId: shell.latestRunId,
+    providerInstanceId: shell.modelSelection.instanceId,
+    model: shell.modelSelection.model,
+    runtimeMode: shell.runtimeMode,
+    interactionMode: shell.interactionMode,
+    parentThreadId: shell.lineage.parentThreadId,
+    relationshipToParent: shell.lineage.relationshipToParent,
+    itemCount: shell.visibleItemCount,
+    createdAt: DateTime.formatIso(shell.createdAt),
+    updatedAt: DateTime.formatIso(shell.updatedAt),
+  };
+}
+
+function threadDetail(projection: OrchestrationV2ThreadProjection): OrchestratorMcpThreadDetail {
+  const latest = latestRun(projection);
+  const active = latestActiveRun(projection);
+  return {
+    threadId: projection.thread.id,
+    projectId: projection.thread.projectId,
+    title: projection.thread.title,
+    createdBy: projection.thread.createdBy,
+    creationSource: projection.thread.creationSource,
+    status: active?.status ?? latest?.status ?? "idle",
+    latestRunId: latest?.id ?? null,
+    activeRunId: active?.id ?? null,
+    providerInstanceId: projection.thread.modelSelection.instanceId,
+    model: projection.thread.modelSelection.model,
+    runtimeMode: projection.thread.runtimeMode,
+    interactionMode: projection.thread.interactionMode,
+    branch: projection.thread.branch,
+    worktreePath: projection.thread.worktreePath,
+    parentThreadId: projection.thread.lineage.parentThreadId,
+    relationshipToParent: projection.thread.lineage.relationshipToParent,
+    runCount: projection.runs.length,
+    itemCount: projection.visibleTurnItems.length,
+    pendingRequestCount: projection.runtimeRequests.filter(
+      (request) => request.status === "pending",
+    ).length,
+    archived: projection.thread.archivedAt !== null,
+    createdAt: DateTime.formatIso(projection.thread.createdAt),
+    updatedAt: DateTime.formatIso(projection.updatedAt),
+  };
+}
+
+function threadRun(run: OrchestrationV2Run): OrchestratorMcpThreadRun {
+  return {
+    runId: run.id,
+    ordinal: run.ordinal,
+    status: run.status,
+    providerInstanceId: run.modelSelection.instanceId,
+    model: run.modelSelection.model,
+    requestedAt: DateTime.formatIso(run.requestedAt),
+    startedAt: run.startedAt === null ? null : DateTime.formatIso(run.startedAt),
+    completedAt: run.completedAt === null ? null : DateTime.formatIso(run.completedAt),
+  };
+}
+
+function jsonText(value: unknown): string {
+  try {
+    return JSON.stringify(value, null, 2);
+  } catch {
+    return String(value);
+  }
+}
+
+function turnItemText(item: OrchestrationV2TurnItem): string | null {
+  switch (item.type) {
+    case "user_message":
+    case "assistant_message":
+    case "reasoning":
+      return item.text;
+    case "proposed_plan":
+      return item.markdown;
+    case "todo_list":
+      return [item.explanation, ...item.steps.map((step) => `[${step.status}] ${step.text}`)]
+        .filter((line): line is string => line !== undefined)
+        .join("\n");
+    case "user_input_request":
+      return jsonText(item.questions);
+    case "file_change":
+      return [
+        item.fileName,
+        item.additions === undefined && item.deletions === undefined
+          ? undefined
+          : `+${item.additions ?? 0} -${item.deletions ?? 0}`,
+        item.diffStr ?? item.newStr,
+      ]
+        .filter((line): line is string => line !== undefined)
+        .join("\n");
+    case "command_execution":
+      return [`$ ${item.input}`, item.output]
+        .filter((line): line is string => line !== undefined)
+        .join("\n");
+    case "file_search":
+      return jsonText({ pattern: item.pattern, results: item.results });
+    case "web_search":
+      return jsonText({ patterns: item.patterns, results: item.results });
+    case "approval_request":
+      return item.prompt ?? item.requestKind;
+    case "checkpoint":
+      return jsonText(item.files);
+    case "run_interrupt_request":
+    case "run_interrupt_result":
+      return item.message;
+    case "error":
+      return item.failure.message;
+    case "compaction":
+      return item.summary ?? null;
+    case "handoff":
+      return item.summary ?? `${item.strategy} handoff to ${item.toProviderInstanceId}`;
+    case "fork":
+      return `Forked to thread ${item.targetThreadId}.`;
+    case "thread_created":
+      return `Created thread ${item.targetThreadId} with ${item.targetProviderInstanceId} (${item.targetModel}).`;
+    case "subagent":
+      return item.result ?? item.progress ?? item.prompt;
+    case "dynamic_tool":
+      return jsonText({ toolName: item.toolName, input: item.input, output: item.output });
+  }
+}
+
+function timelineItem(input: {
+  readonly row: OrchestrationV2ThreadProjection["visibleTurnItems"][number];
+  readonly maxChars: number;
+  readonly messagesByThreadId: ReadonlyMap<ThreadId, OrchestrationV2ThreadProjection["messages"]>;
+}): OrchestratorMcpThreadTimelineItem {
+  const text = turnItemText(input.row.item);
+  const textTruncated = text !== null && text.length > input.maxChars;
+  const messageId =
+    input.row.item.type === "user_message" || input.row.item.type === "assistant_message"
+      ? input.row.item.messageId
+      : null;
+  const message =
+    messageId === null
+      ? undefined
+      : input.messagesByThreadId
+          .get(input.row.sourceThreadId)
+          ?.find((candidate) => candidate.id === messageId);
+  return {
+    position: input.row.position,
+    visibility: input.row.visibility,
+    sourceThreadId: input.row.sourceThreadId,
+    itemId: input.row.sourceItemId,
+    runId: input.row.item.runId,
+    messageId,
+    createdBy: message?.createdBy ?? null,
+    creationSource: message?.creationSource ?? null,
+    type: input.row.item.type,
+    status: input.row.item.status,
+    title: input.row.item.title,
+    text: textTruncated ? `${text.slice(0, input.maxChars)}\n…[truncated]` : text,
+    textTruncated,
+    updatedAt: DateTime.formatIso(input.row.item.updatedAt),
+  };
+}
+
+const make = Effect.gen(function* () {
+  const crypto = yield* Crypto.Crypto;
+  const threadManagement = yield* ThreadManagementService;
+  const providerRegistry = yield* ProviderRegistry;
+  const scheduledTasks = yield* ScheduledTaskService;
+
+  const requireCapability = (scope: McpInvocationScope) =>
+    scope.capabilities.has("orchestration")
+      ? Effect.void
+      : Effect.fail(
+          failure(
+            "capability_denied",
+            "This MCP credential does not grant orchestration capabilities.",
+          ),
+        );
+
+  const loadProjection = (threadId: ThreadId) =>
+    threadManagement
+      .getThreadProjection(threadId)
+      .pipe(
+        Effect.mapError((error) =>
+          failure(
+            "orchestration_error",
+            `Unable to read thread ${threadId}: ${errorMessage(error)}`,
+          ),
+        ),
+      );
+
+  const loadProjectThread = (
+    projectId: OrchestrationV2ThreadProjection["thread"]["projectId"],
+    threadId: ThreadId,
+  ): Effect.Effect<OrchestrationV2ThreadProjection, OrchestratorMcpFailure> =>
+    threadManagement
+      .getProjectThread({ projectId, threadId })
+      .pipe(Effect.mapError(threadManagementFailure));
+
+  const loadScopedThread = (scope: McpInvocationScope, threadId: ThreadId) =>
+    Effect.gen(function* () {
+      yield* requireCapability(scope);
+      const parent = yield* loadProjection(scope.threadId);
+      const target =
+        threadId === scope.threadId
+          ? parent
+          : yield* loadProjectThread(parent.thread.projectId, threadId);
+      return { parent, target } as const;
+    });
+
+  const loadProviders = providerRegistry.getProviders;
+
+  const resolveTarget = (input: {
+    readonly parent: OrchestrationV2ThreadProjection;
+    readonly target: OrchestratorMcpTarget | undefined;
+    readonly providers: ReadonlyArray<ServerProvider>;
+  }): Effect.Effect<ResolvedTarget, OrchestratorMcpFailure> =>
+    Effect.gen(function* () {
+      const requestedInstanceId = input.target?.providerInstanceId;
+      const requestedDriver = input.target?.driverKind;
+      let instanceId = requestedInstanceId;
+
+      if (instanceId === undefined && requestedDriver !== undefined) {
+        const candidates = input.providers.filter(
+          (provider) =>
+            provider.driver === requestedDriver &&
+            isBuiltInProviderAdapterDriverV2(provider.driver),
+        );
+        if (candidates.length === 0) {
+          return yield* failure(
+            "provider_unavailable",
+            `No V2 provider adapter is registered for driver ${requestedDriver}.`,
+          );
+        }
+        const inheritedCandidate = candidates.find(
+          (candidate) => candidate.instanceId === input.parent.thread.modelSelection.instanceId,
+        );
+        const availableCandidate = candidates.find((candidate) => {
+          return (
+            providerConstraints(candidate, isBuiltInProviderAdapterDriverV2(candidate.driver))
+              .length === 0
+          );
+        });
+        instanceId = inheritedCandidate?.instanceId ?? availableCandidate?.instanceId;
+      }
+      instanceId ??= input.parent.thread.modelSelection.instanceId;
+
+      const provider = input.providers.find((candidate) => candidate.instanceId === instanceId);
+      if (provider === undefined) {
+        return yield* failure(
+          "provider_unavailable",
+          `Provider instance ${instanceId} is not registered.`,
+        );
+      }
+      if (requestedDriver !== undefined && provider.driver !== requestedDriver) {
+        return yield* failure(
+          "invalid_request",
+          `Provider instance ${instanceId} uses driver ${provider.driver}, not ${requestedDriver}.`,
+        );
+      }
+      const constraints = providerConstraints(
+        provider,
+        isBuiltInProviderAdapterDriverV2(provider.driver),
+      );
+      if (constraints.length > 0) {
+        return yield* failure(
+          "provider_unavailable",
+          `Provider ${instanceId} cannot run a child task: ${constraints.join(" ")}`,
+        );
+      }
+
+      const inheritedSelection = input.parent.thread.modelSelection;
+      const requestedModel = input.target?.model;
+      const model =
+        requestedModel ??
+        (instanceId === inheritedSelection.instanceId
+          ? inheritedSelection.model
+          : provider?.models[0]?.slug);
+      if (model === undefined) {
+        return yield* failure(
+          "model_unavailable",
+          `Provider ${instanceId} has no model available for inheritance.`,
+        );
+      }
+      if (
+        requestedModel !== undefined &&
+        provider !== undefined &&
+        provider.models.length > 0 &&
+        !provider.models.some((candidate) => candidate.slug === requestedModel)
+      ) {
+        return yield* failure(
+          "model_unavailable",
+          `Model ${requestedModel} is not advertised by provider ${instanceId}.`,
+        );
+      }
+
+      const requestedOptions = input.target?.options;
+      if (requestedOptions !== undefined) {
+        const descriptors = provider.models.find((candidate) => candidate.slug === model)
+          ?.capabilities?.optionDescriptors;
+        const invalid = invalidOptionSelections(requestedOptions, descriptors);
+        if (invalid.length > 0) {
+          return yield* failure(
+            "invalid_request",
+            `Model ${model} on provider ${instanceId} rejected options: ${invalid.join(" ")}`,
+          );
+        }
+      }
+
+      return {
+        modelSelection:
+          instanceId === inheritedSelection.instanceId &&
+          model === inheritedSelection.model &&
+          requestedOptions === undefined
+            ? inheritedSelection
+            : requestedOptions === undefined
+              ? { instanceId, model }
+              : { instanceId, model, options: requestedOptions },
+      };
+    });
+
+  const requestKey = (clientRequestId: string | undefined): Effect.Effect<string> =>
+    clientRequestId === undefined
+      ? crypto.randomUUIDv4.pipe(Effect.orDie)
+      : Effect.succeed(clientRequestId);
+
+  const readTask = (
+    scope: McpInvocationScope,
+    taskId: NodeId,
+    waitTimedOut = false,
+    acknowledgeTerminal = false,
+    acknowledgementOperation = "task-status-acknowledge",
+  ): Effect.Effect<OrchestratorMcpDelegateTaskResult, OrchestratorMcpFailure> =>
+    Effect.gen(function* () {
+      yield* requireCapability(scope);
+      const parentProjection = yield* loadProjection(scope.threadId);
+      const task = parentProjection.subagents.find(
+        (candidate) =>
+          candidate.id === taskId &&
+          candidate.origin === "app_owned" &&
+          candidate.threadId === scope.threadId,
+      );
+      if (task === undefined || task.childThreadId === null) {
+        return yield* failure(
+          "task_not_found",
+          `Delegated task ${taskId} does not belong to thread ${scope.threadId}.`,
+        );
+      }
+      const childProjection = yield* loadProjection(task.childThreadId);
+      const childRun = delegatedTaskRun(childProjection, task);
+      const status = taskStatusForRun(childRun);
+      const derivedResult =
+        task.result !== null
+          ? task.result
+          : childRun !== undefined && isTerminalTaskStatus(status)
+            ? subagentResultForRun(childProjection, childRun).text
+            : null;
+      const resultTransfer =
+        parentProjection.contextTransfers.find(
+          (transfer) =>
+            transfer.type === "subagent_result" &&
+            transfer.sourceThreadId === task.childThreadId &&
+            transfer.targetThreadId === scope.threadId,
+        ) ?? null;
+      const response = {
+        taskId: task.id,
+        childThreadId: task.childThreadId,
+        childRunId: childRun?.id ?? null,
+        childNodeId: task.id,
+        status,
+        providerInstanceId: task.providerInstanceId,
+        model: task.model,
+        summary: derivedResult,
+        resultContextTransferId: resultTransfer?.id ?? null,
+        waitTimedOut,
+      } satisfies OrchestratorMcpDelegateTaskResult;
+      if (
+        acknowledgeTerminal &&
+        isTerminalTaskStatus(status) &&
+        task.completionDelivery?.state !== "acknowledged" &&
+        task.completionDelivery?.state !== "disposed"
+      ) {
+        const observingRun = latestActiveRun(parentProjection);
+        const acknowledgementRequestKey = yield* requestKey(undefined);
+        yield* threadManagement
+          .dispatch({
+            type: "delegated_task.completion-delivery.acknowledge",
+            commandId: stableCommandId({
+              scope,
+              requestKey: acknowledgementRequestKey,
+              operation: acknowledgementOperation,
+            }),
+            parentThreadId: scope.threadId,
+            taskId,
+            observedByRunId:
+              observingRun?.providerInstanceId === scope.providerInstanceId
+                ? observingRun.id
+                : null,
+          })
+          .pipe(
+            Effect.mapError((error) =>
+              failure(
+                "orchestration_error",
+                `Unable to acknowledge delegated task ${taskId}: ${errorMessage(error)}`,
+              ),
+            ),
+          );
+      }
+      return response;
+    });
+
+  const waitForTask = (scope: McpInvocationScope, taskId: NodeId, timeoutMs: number) =>
+    Effect.gen(function* () {
+      while (true) {
+        const result = yield* readTask(scope, taskId, false, true);
+        if (isTerminalTaskStatus(result.status)) return result;
+        yield* Effect.sleep(Duration.millis(TASK_POLL_INTERVAL_MS));
+      }
+    }).pipe(Effect.timeoutOption(Duration.millis(timeoutMs)));
+
+  // Load a single scheduled task and enforce that it belongs to the calling
+  // thread's project, so agents can only read/mutate tasks in their own scope.
+  const loadScopedScheduledTask = (
+    projectId: ScheduledTask["projectId"],
+    scheduledTaskId: ScheduledTask["id"],
+  ): Effect.Effect<ScheduledTask, OrchestratorMcpFailure> =>
+    Effect.gen(function* () {
+      const { tasks } = yield* scheduledTasks
+        .list()
+        .pipe(
+          Effect.mapError((error) =>
+            failure("orchestration_error", `Could not load scheduled task: ${error.message}`),
+          ),
+        );
+      const task = tasks.find((candidate) => candidate.id === scheduledTaskId);
+      if (task === undefined || task.projectId !== projectId) {
+        return yield* failure(
+          "task_not_found",
+          `Scheduled task ${scheduledTaskId} was not found in the calling project.`,
+        );
+      }
+      return task;
+    });
+
+  return OrchestratorMcpService.of({
+    scheduleTask: (scope, input) =>
+      Effect.gen(function* () {
+        yield* requireCapability(scope);
+        const parent = yield* loadProjection(scope.threadId);
+        const bindToCurrentThread = input.bindToCurrentThread ?? true;
+        const derivedTitle = input.prompt.split("\n")[0]?.trim() ?? "";
+        const title =
+          input.title ?? (derivedTitle.length > 0 ? derivedTitle.slice(0, 80) : "Scheduled task");
+        const upsertInput: ScheduledTaskUpsertInput = {
+          title,
+          prompt: input.prompt,
+          enabled: input.enabled ?? true,
+          schedule: input.schedule,
+          projectId: parent.thread.projectId,
+          threadId: bindToCurrentThread ? scope.threadId : null,
+          workspaceStrategy: scheduledTaskWorkspaceStrategy(bindToCurrentThread),
+          modelSelection: parent.thread.modelSelection,
+          runtimeMode: parent.thread.runtimeMode,
+          interactionMode: parent.thread.interactionMode,
+          createdBy: "agent",
+          creationSource: "mcp",
+          // Scope the idempotency key by provider session so two callers
+          // reusing the same clientRequestId cannot collide on one task row.
+          ...(input.clientRequestId === undefined
+            ? {}
+            : {
+                commandId: stableCommandId({
+                  scope,
+                  requestKey: input.clientRequestId,
+                  operation: "schedule-task",
+                }),
+              }),
+        };
+        const { task } = yield* scheduledTasks
+          .upsert(upsertInput)
+          .pipe(
+            Effect.mapError((error) =>
+              failure("orchestration_error", `Could not schedule task: ${error.message}`),
+            ),
+          );
+        return scheduledTaskSummary(task);
+      }),
+    listScheduledTasks: (scope) =>
+      Effect.gen(function* () {
+        yield* requireCapability(scope);
+        const parent = yield* loadProjection(scope.threadId);
+        const { tasks } = yield* scheduledTasks
+          .list()
+          .pipe(
+            Effect.mapError((error) =>
+              failure("orchestration_error", `Could not list scheduled tasks: ${error.message}`),
+            ),
+          );
+        // Only expose tasks belonging to the calling thread's project.
+        return {
+          tasks: tasks
+            .filter((task) => task.projectId === parent.thread.projectId)
+            .map(scheduledTaskSummary),
+        };
+      }),
+    updateScheduledTask: (scope, input) =>
+      Effect.gen(function* () {
+        yield* requireCapability(scope);
+        const parent = yield* loadProjection(scope.threadId);
+        const existing = yield* loadScopedScheduledTask(
+          parent.thread.projectId,
+          input.scheduledTaskId,
+        );
+        const threadId =
+          input.bindToCurrentThread === undefined
+            ? existing.threadId
+            : input.bindToCurrentThread
+              ? scope.threadId
+              : null;
+        // Rebinding changes where runs execute, so the workspace strategy must
+        // follow: unbinding a root-strategy task would otherwise run loose
+        // prompts in the shared project checkout.
+        const workspaceStrategy =
+          input.bindToCurrentThread === undefined
+            ? existing.workspaceStrategy
+            : scheduledTaskWorkspaceStrategy(input.bindToCurrentThread);
+        const upsertInput: ScheduledTaskUpsertInput = {
+          id: existing.id,
+          title: input.title ?? existing.title,
+          prompt: input.prompt ?? existing.prompt,
+          enabled: input.enabled ?? existing.enabled,
+          schedule: input.schedule ?? existing.schedule,
+          projectId: existing.projectId,
+          threadId,
+          workspaceStrategy,
+          modelSelection: existing.modelSelection,
+          runtimeMode: existing.runtimeMode,
+          interactionMode: existing.interactionMode,
+          createdBy: existing.createdBy,
+          creationSource: existing.creationSource,
+        };
+        const { task } = yield* scheduledTasks
+          .upsert(upsertInput)
+          .pipe(
+            Effect.mapError((error) =>
+              failure("orchestration_error", `Could not update scheduled task: ${error.message}`),
+            ),
+          );
+        return scheduledTaskSummary(task);
+      }),
+    deleteScheduledTask: (scope, input) =>
+      Effect.gen(function* () {
+        yield* requireCapability(scope);
+        const parent = yield* loadProjection(scope.threadId);
+        const existing = yield* loadScopedScheduledTask(
+          parent.thread.projectId,
+          input.scheduledTaskId,
+        );
+        yield* scheduledTasks
+          .delete({ id: existing.id })
+          .pipe(
+            Effect.mapError((error) =>
+              failure("orchestration_error", `Could not delete scheduled task: ${error.message}`),
+            ),
+          );
+        return { scheduledTaskId: existing.id, deleted: true };
+      }),
+    capabilities: (scope) =>
+      Effect.gen(function* () {
+        yield* requireCapability(scope);
+        const parent = yield* loadProjection(scope.threadId);
+        const providers = yield* loadProviders;
+        return {
+          parentThreadId: scope.threadId,
+          inheritedProviderInstanceId: parent.thread.modelSelection.instanceId,
+          inheritedModel: parent.thread.modelSelection.model,
+          runtimeMode: parent.thread.runtimeMode,
+          interactionMode: parent.thread.interactionMode,
+          providers: providers.map((provider) => {
+            const constraints = providerConstraints(
+              provider,
+              isBuiltInProviderAdapterDriverV2(provider.driver),
+            );
+            return {
+              providerInstanceId: provider.instanceId,
+              driverKind: provider.driver,
+              displayName: provider?.displayName ?? null,
+              models:
+                provider?.models.map((model) => ({
+                  id: model.slug,
+                  label: model.name ?? null,
+                  ...(model.capabilities?.optionDescriptors === undefined
+                    ? {}
+                    : { options: model.capabilities.optionDescriptors }),
+                })) ?? [],
+              canRunChildTask: constraints.length === 0,
+              canRunCrossProviderChildTask: constraints.length === 0,
+              constraints: [...constraints],
+            };
+          }),
+          features: {
+            appOwnedSubagents: true,
+            asyncPolling: true,
+            cancellation: true,
+            batchThreadCreation: true,
+            threadManagement: true,
+            incrementalThreadRead: true,
+            scheduledTasks: true,
+            maxBatchThreads: 20,
+          },
+        };
+      }),
+    delegateTask: (scope, input) =>
+      Effect.gen(function* () {
+        yield* requireCapability(scope);
+        const parent = yield* loadProjection(scope.threadId);
+        const parentRun = parent.runs
+          .filter(isActiveRun)
+          .toSorted((left, right) => right.ordinal - left.ordinal)[0];
+        if (
+          parentRun === undefined ||
+          parentRun.rootNodeId === null ||
+          parentRun.providerInstanceId !== scope.providerInstanceId
+        ) {
+          return yield* failure(
+            "parent_not_active",
+            "Delegated tasks require an active run owned by this MCP provider session.",
+          );
+        }
+        const providers = yield* loadProviders;
+        const target = yield* resolveTarget({
+          parent,
+          target: input.target,
+          providers,
+        });
+        const runtimeMode = yield* resolveRuntimeMode(parent.thread.runtimeMode, input.runtimeMode);
+        const interactionMode = yield* resolveInteractionMode(
+          parent.thread.interactionMode,
+          input.interactionMode,
+        );
+        const key = yield* requestKey(input.clientRequestId);
+        const commandId = stableCommandId({
+          scope,
+          requestKey: key,
+          operation: "delegate-task",
+        });
+        const result = yield* threadManagement
+          .dispatch({
+            type: "delegated_task.request",
+            createdBy: "agent",
+            creationSource: "mcp",
+            commandId,
+            parentThreadId: scope.threadId,
+            parentRunId: parentRun.id,
+            parentNodeId: parentRun.rootNodeId,
+            task: taskPrompt(input),
+            ...(input.title === undefined ? {} : { title: input.title }),
+            modelSelection: target.modelSelection,
+            runtimeMode,
+            interactionMode,
+            // Async delegations wake the parent on every child terminal; wait
+            // delegations deliver through the blocking tool call, so a wake is
+            // only needed if the parent settled first (timeout, disconnect).
+            completionWake: input.mode === "wait" ? "settled_only" : "always",
+          })
+          .pipe(
+            Effect.mapError((error) =>
+              failure(
+                "orchestration_error",
+                `Unable to create delegated task: ${errorMessage(error)}`,
+              ),
+            ),
+          );
+        const taskEvent = result.storedEvents.find(
+          (stored) =>
+            stored.event.type === "subagent.updated" && stored.event.payload.origin === "app_owned",
+        );
+        if (taskEvent?.event.type !== "subagent.updated") {
+          return yield* failure(
+            "orchestration_error",
+            "Delegated task command did not produce a task projection.",
+          );
+        }
+        const taskId = taskEvent.event.payload.id;
+
+        if (input.mode !== "wait") {
+          return yield* readTask(scope, taskId, false, true);
+        }
+        const timeoutMs = Math.min(
+          MAX_WAIT_TIMEOUT_MS,
+          Math.max(1, input.timeoutMs ?? DEFAULT_WAIT_TIMEOUT_MS),
+        );
+        const waited = yield* waitForTask(scope, taskId, timeoutMs);
+        if (Option.isSome(waited)) {
+          return waited.value;
+        }
+        // The blocking wait timed out, so it no longer owns delivery: upgrade
+        // the task so a later terminal wakes the parent even mid-turn. Best
+        // effort; on failure the settled_only policy still wakes a settled
+        // parent.
+        yield* threadManagement
+          .dispatch({
+            type: "delegated_task.wake-policy",
+            commandId: stableCommandId({
+              scope,
+              requestKey: key,
+              operation: "delegate-task-wake-policy",
+            }),
+            parentThreadId: scope.threadId,
+            taskId,
+            completionWake: "always",
+          })
+          .pipe(
+            // The tool result is the timed-out task either way, so failures
+            // stay warnings. Keep the two shapes apart: a rejected receipt
+            // means this exact command id already failed (a replay of a
+            // no-op upgrade), while anything else is a fresh dispatch fault.
+            Effect.catch((error) =>
+              Effect.logWarning("orchestrator-mcp.delegate-task.wake-policy-failed", {
+                taskId,
+                outcome:
+                  error._tag === "OrchestratorCommandPreviouslyRejectedError"
+                    ? "previously_rejected"
+                    : "dispatch_failed",
+                error,
+              }),
+            ),
+            Effect.catchCause((cause) =>
+              Effect.logWarning("orchestrator-mcp.delegate-task.wake-policy-failed", {
+                taskId,
+                outcome: "defect",
+                cause,
+              }),
+            ),
+          );
+        return yield* readTask(scope, taskId, true, true);
+      }),
+    taskStatus: (scope, taskId) => readTask(scope, taskId, false, true),
+    cancelTask: (scope, input) =>
+      Effect.gen(function* () {
+        const current = yield* readTask(scope, input.taskId);
+        const key = yield* requestKey(input.clientRequestId);
+        const parentProjection = yield* loadProjection(scope.threadId);
+        const parentTask = parentProjection.subagents.find(
+          (task) => task.id === input.taskId && task.origin === "app_owned",
+        );
+        const disposeCompletionDelivery =
+          parentTask?.completionDelivery?.state === "disposed"
+            ? Effect.void
+            : threadManagement
+                .dispatch({
+                  type: "delegated_task.completion-delivery.dispose",
+                  commandId: stableCommandId({
+                    scope,
+                    requestKey: key,
+                    operation: "cancel-task-completion-delivery",
+                  }),
+                  parentThreadId: scope.threadId,
+                  taskId: input.taskId,
+                })
+                .pipe(
+                  Effect.asVoid,
+                  Effect.mapError((error) =>
+                    failure(
+                      "orchestration_error",
+                      `Unable to dispose delegated task ${input.taskId} completion delivery: ${errorMessage(error)}`,
+                    ),
+                  ),
+                );
+        if (isTerminalTaskStatus(current.status)) {
+          yield* disposeCompletionDelivery;
+          return {
+            taskId: input.taskId,
+            status: current.status,
+          } satisfies OrchestratorMcpTaskCancelResult;
+        }
+        const child = yield* loadProjection(current.childThreadId);
+        const activeRun = child.runs.find(
+          (run) => run.id === current.childRunId && isActiveRun(run),
+        );
+        if (activeRun === undefined) {
+          return yield* failure(
+            "task_not_cancellable",
+            `Delegated task ${input.taskId} has no interruptible child run.`,
+          );
+        }
+        yield* threadManagement
+          .dispatch({
+            type: "run.interrupt",
+            commandId: stableCommandId({
+              scope,
+              requestKey: key,
+              operation: "cancel-task",
+            }),
+            threadId: current.childThreadId,
+            runId: activeRun.id,
+            ...(input.reason === undefined ? {} : { reason: input.reason }),
+          })
+          .pipe(
+            Effect.mapError((error) =>
+              failure(
+                "task_not_cancellable",
+                `Unable to interrupt delegated task ${input.taskId}: ${errorMessage(error)}`,
+              ),
+            ),
+          );
+        yield* disposeCompletionDelivery.pipe(
+          Effect.catchCause((cause) =>
+            Effect.logWarning("orchestrator-mcp.cancel-task.delivery-dispose-failed", {
+              taskId: input.taskId,
+              cause,
+            }),
+          ),
+        );
+        return {
+          taskId: input.taskId,
+          status: "cancel_requested",
+        };
+      }),
+    createThreads: (scope, input) =>
+      Effect.gen(function* () {
+        yield* requireCapability(scope);
+        const parent = yield* loadProjection(scope.threadId);
+        const parentRun = latestActiveRun(parent);
+        if (
+          parentRun === undefined ||
+          parentRun.rootNodeId === null ||
+          parentRun.providerInstanceId !== scope.providerInstanceId
+        ) {
+          return yield* failure(
+            "parent_not_active",
+            "Thread creation requires an active run owned by this MCP provider session.",
+          );
+        }
+        const parentNodeId = parentRun.rootNodeId;
+        const providers = yield* loadProviders;
+        const key = yield* requestKey(input.clientRequestId);
+        const created = yield* Effect.forEach(
+          input.threads,
+          (request, index) =>
+            Effect.gen(function* () {
+              const target = yield* resolveTarget({
+                parent,
+                target: request.target,
+                providers,
+              });
+              const runtimeMode = yield* resolveRuntimeMode(
+                parent.thread.runtimeMode,
+                request.runtimeMode,
+              );
+              const interactionMode = yield* resolveInteractionMode(
+                parent.thread.interactionMode,
+                request.interactionMode,
+              );
+              const threadId = stableThreadId({
+                scope,
+                requestKey: key,
+                index,
+              });
+              const title = threadTitle({
+                parentTitle: parent.thread.title,
+                prompt: request.prompt,
+                title: request.title,
+                index,
+              });
+              yield* threadManagement
+                .dispatch({
+                  type: "thread.create",
+                  createdBy: "agent",
+                  creationSource: "mcp",
+                  commandId: stableCommandId({
+                    scope,
+                    requestKey: key,
+                    operation: "create-thread",
+                    index,
+                  }),
+                  threadId,
+                  projectId: parent.thread.projectId,
+                  title,
+                  modelSelection: target.modelSelection,
+                  runtimeMode,
+                  interactionMode,
+                  branch: parent.thread.branch,
+                  worktreePath: parent.thread.worktreePath,
+                })
+                .pipe(
+                  Effect.mapError((error) =>
+                    failure(
+                      "orchestration_error",
+                      `Unable to create thread ${index + 1}: ${errorMessage(error)}`,
+                    ),
+                  ),
+                );
+              if (request.prompt !== undefined) {
+                yield* threadManagement
+                  .dispatch({
+                    type: "message.dispatch",
+                    createdBy: "agent",
+                    creationSource: "mcp",
+                    commandId: stableCommandId({
+                      scope,
+                      requestKey: key,
+                      operation: "dispatch-thread",
+                      index,
+                    }),
+                    threadId,
+                    messageId: stableMessageId({
+                      scope,
+                      requestKey: key,
+                      index,
+                    }),
+                    text: request.prompt,
+                    attachments: [],
+                    modelSelection: target.modelSelection,
+                    dispatchMode: { type: "start_immediately" },
+                  })
+                  .pipe(
+                    Effect.mapError((error) =>
+                      failure(
+                        "orchestration_error",
+                        `Unable to start thread ${index + 1}: ${errorMessage(error)}`,
+                      ),
+                    ),
+                  );
+              }
+              const projection = yield* loadProjection(threadId);
+              const run = projection.runs.at(-1);
+              yield* threadManagement
+                .dispatch({
+                  type: "thread.created.record",
+                  commandId: stableCommandId({
+                    scope,
+                    requestKey: key,
+                    operation: "record-created-thread",
+                    index,
+                  }),
+                  parentThreadId: scope.threadId,
+                  parentRunId: parentRun.id,
+                  parentNodeId,
+                  targetThreadId: threadId,
+                  targetRunId: run?.id ?? null,
+                })
+                .pipe(
+                  Effect.mapError((error) =>
+                    failure(
+                      "orchestration_error",
+                      `Unable to record thread ${index + 1} in the parent timeline: ${errorMessage(error)}`,
+                    ),
+                  ),
+                );
+              return {
+                threadId,
+                runId: run?.id ?? null,
+                status: run?.status ?? "idle",
+                title: projection.thread.title,
+                createdBy: projection.thread.createdBy,
+                creationSource: projection.thread.creationSource,
+                providerInstanceId: target.modelSelection.instanceId,
+                model: target.modelSelection.model,
+              } satisfies OrchestratorMcpCreatedThread;
+            }),
+          { concurrency: 1 },
+        );
+        return { threads: created };
+      }),
+    listThreads: (scope, input) =>
+      Effect.gen(function* () {
+        yield* requireCapability(scope);
+        const parent = yield* loadProjection(scope.threadId);
+        const projectThreads = yield* threadManagement
+          .listProjectThreads({
+            projectId: parent.thread.projectId,
+            includeSubagents: input.includeSubagents !== false,
+          })
+          .pipe(
+            Effect.mapError((error) =>
+              failure("orchestration_error", `Unable to list threads: ${errorMessage(error)}`),
+            ),
+          );
+        const statuses = input.statuses === undefined ? null : new Set(input.statuses);
+        const titleContains = input.titleContains?.toLocaleLowerCase();
+        const filtered = projectThreads
+          .filter(
+            (thread) =>
+              statuses === null || statuses.has(thread.activityRunStatus ?? thread.status),
+          )
+          .filter(
+            (thread) =>
+              titleContains === undefined ||
+              thread.title.toLocaleLowerCase().includes(titleContains),
+          );
+        const cursor = input.cursor ?? 0;
+        const limit = input.limit ?? DEFAULT_THREAD_LIST_LIMIT;
+        const page = filtered.slice(cursor, cursor + limit);
+        const nextCursor = cursor + page.length < filtered.length ? cursor + page.length : null;
+        return {
+          projectId: parent.thread.projectId,
+          currentThreadId: scope.threadId,
+          threads: page.map(listItemFromShell),
+          nextCursor,
+          total: filtered.length,
+        } satisfies OrchestratorMcpThreadListResult;
+      }),
+    readThread: (scope, input) =>
+      Effect.gen(function* () {
+        const { parent, target } = yield* loadScopedThread(scope, input.threadId);
+        const view = input.view ?? "messages";
+        const afterPosition = input.afterPosition ?? -1;
+        const limit = input.limit ?? DEFAULT_THREAD_READ_LIMIT;
+        const maxChars = input.maxCharsPerItem ?? DEFAULT_THREAD_ITEM_MAX_CHARS;
+        const matching = target.visibleTurnItems
+          .filter((row) => row.position > afterPosition)
+          .filter(
+            (row) =>
+              view === "activity" ||
+              row.item.type === "user_message" ||
+              row.item.type === "assistant_message" ||
+              row.item.type === "proposed_plan",
+          );
+        const page = matching.slice(0, limit);
+        const sourceThreadIds = [
+          ...new Set(
+            page
+              .filter(
+                (row) => row.item.type === "user_message" || row.item.type === "assistant_message",
+              )
+              .map((row) => row.sourceThreadId)
+              .filter((threadId) => threadId !== target.thread.id),
+          ),
+        ];
+        const sourceProjections = yield* Effect.forEach(
+          sourceThreadIds,
+          (sourceThreadId) => loadProjectThread(target.thread.projectId, sourceThreadId),
+          { concurrency: 8 },
+        );
+        const messagesByThreadId = new Map<ThreadId, OrchestrationV2ThreadProjection["messages"]>([
+          [target.thread.id, target.messages],
+          ...sourceProjections.map(
+            (projection) => [projection.thread.id, projection.messages] as const,
+          ),
+        ]);
+        const task = directAppOwnedChildTask(parent, target);
+        if (
+          task !== undefined &&
+          pageIncludesTerminalTaskResult({ page, task, target, maxChars })
+        ) {
+          yield* readTask(scope, task.id, false, true, "thread-read-acknowledge");
+        }
+        return {
+          thread: threadDetail(target),
+          recentRuns: target.runs
+            .toSorted((left, right) => right.ordinal - left.ordinal)
+            .slice(0, input.runLimit ?? DEFAULT_THREAD_RUN_LIMIT)
+            .map(threadRun),
+          items: page.map((row) => timelineItem({ row, maxChars, messagesByThreadId })),
+          nextPosition: page.at(-1)?.position ?? null,
+          hasMore: page.length < matching.length,
+        } satisfies OrchestratorMcpThreadReadResult;
+      }),
+    sendToThread: (scope, input) =>
+      Effect.gen(function* () {
+        const { parent, target } = yield* loadScopedThread(scope, input.threadId);
+        yield* resolveRuntimeMode(parent.thread.runtimeMode, target.thread.runtimeMode);
+        yield* resolveInteractionMode(parent.thread.interactionMode, target.thread.interactionMode);
+
+        const mode = input.mode ?? "auto";
+        const key = yield* requestKey(input.clientRequestId);
+        const messageId = stableOperationMessageId({
+          scope,
+          requestKey: key,
+          operation: "thread-send",
+        });
+        const result = yield* threadManagement
+          .sendToThread({
+            projectId: parent.thread.projectId,
+            commandId: stableCommandId({
+              scope,
+              requestKey: key,
+              operation: "thread-send",
+            }),
+            threadId: input.threadId,
+            messageId,
+            text: input.message,
+            attachments: [],
+            mode,
+            createdBy: "agent",
+            creationSource: "mcp",
+          })
+          .pipe(
+            Effect.mapError((error) =>
+              isThreadManagementError(error)
+                ? threadManagementFailure(error)
+                : failure(
+                    "orchestration_error",
+                    `Unable to send to thread ${input.threadId}: ${errorMessage(error)}`,
+                  ),
+            ),
+          );
+        return {
+          threadId: input.threadId,
+          messageId,
+          runId: result.run.id,
+          status: result.run.status,
+          delivery: result.delivery,
+        } satisfies OrchestratorMcpThreadSendResult;
+      }),
+    waitForThread: (scope, input) =>
+      Effect.gen(function* () {
+        const { parent } = yield* loadScopedThread(scope, input.threadId);
+        const result = yield* threadManagement
+          .waitForThread({
+            projectId: parent.thread.projectId,
+            threadId: input.threadId,
+            ...(input.runId === undefined ? {} : { runId: input.runId }),
+            timeoutMs: Math.min(
+              MAX_WAIT_TIMEOUT_MS,
+              Math.max(1, input.timeoutMs ?? DEFAULT_WAIT_TIMEOUT_MS),
+            ),
+          })
+          .pipe(Effect.mapError(threadManagementFailure));
+        return {
+          threadId: input.threadId,
+          runId: result.run?.id ?? null,
+          status: result.run?.status ?? "idle",
+          timedOut: result.timedOut,
+        } satisfies OrchestratorMcpThreadWaitResult;
+      }),
+    interruptThread: (scope, input) =>
+      Effect.gen(function* () {
+        const { parent } = yield* loadScopedThread(scope, input.threadId);
+        const key = yield* requestKey(input.clientRequestId);
+        const result = yield* threadManagement
+          .interruptThread({
+            projectId: parent.thread.projectId,
+            commandId: stableCommandId({
+              scope,
+              requestKey: key,
+              operation: "thread-interrupt",
+            }),
+            threadId: input.threadId,
+            ...(input.runId === undefined ? {} : { runId: input.runId }),
+            ...(input.reason === undefined ? {} : { reason: input.reason }),
+          })
+          .pipe(
+            Effect.mapError((error) =>
+              isThreadManagementError(error)
+                ? threadManagementFailure(error)
+                : failure(
+                    "orchestration_error",
+                    `Unable to interrupt thread ${input.threadId}: ${errorMessage(error)}`,
+                  ),
+            ),
+          );
+        if (result.type === "no_active_run") {
+          return {
+            threadId: input.threadId,
+            runId: null,
+            status: "no_active_run",
+          } satisfies OrchestratorMcpThreadInterruptResult;
+        }
+        return {
+          threadId: input.threadId,
+          runId: result.run.id,
+          status: result.type === "already_terminal" ? result.run.status : "interrupt_requested",
+        } satisfies OrchestratorMcpThreadInterruptResult;
+      }),
+  });
+});
+
+export const layer: Layer.Layer<
+  OrchestratorMcpService,
+  never,
+  Crypto.Crypto | ThreadManagementService | ProviderRegistry | ScheduledTaskService
+> = Layer.effect(OrchestratorMcpService, make);
diff --git a/apps/server/src/mcp/OrchestratorMcpToolkit.integration.test.ts b/apps/server/src/mcp/OrchestratorMcpToolkit.integration.test.ts
new file mode 100644
index 000000000000..ad6ea73c7688
--- /dev/null
+++ b/apps/server/src/mcp/OrchestratorMcpToolkit.integration.test.ts
@@ -0,0 +1,2620 @@
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import { describe, expect, it } from "@effect/vitest";
+import {
+  CommandId,
+  EnvironmentId,
+  IsoDateTime,
+  MessageId,
+  type ModelSelection,
+  type OrchestrationV2ProviderCapabilities,
+  type OrchestrationV2ProviderSession,
+  type OrchestrationV2ProviderThread,
+  type OrchestrationV2ThreadProjection,
+  OrchestratorMcpCreateThreadsResult,
+  OrchestratorMcpCreatedThread,
+  OrchestratorMcpDelegateTaskResult,
+  OrchestratorMcpTaskCancelResult,
+  OrchestratorMcpThreadInterruptResult,
+  OrchestratorMcpThreadListResult,
+  OrchestratorMcpThreadReadResult,
+  OrchestratorMcpThreadSendResult,
+  OrchestratorMcpThreadWaitResult,
+  ProjectId,
+  ProviderDriverKind,
+  ProviderInstanceId,
+  type ProviderOptionDescriptor,
+  ProviderThreadId,
+  ProviderTurnId,
+  type ScheduledTask,
+  ScheduledTaskId,
+  type ScheduledTaskUpsertInput,
+  type ServerProvider,
+  ThreadId,
+  TurnItemId,
+} from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as PubSub from "effect/PubSub";
+import * as Ref from "effect/Ref";
+import * as Schema from "effect/Schema";
+import * as Stream from "effect/Stream";
+import { McpSchema, McpServer } from "effect/unstable/ai";
+
+import { ClaudeProviderCapabilitiesV2 } from "../orchestration-v2/Adapters/ClaudeAdapterV2.ts";
+import { CodexProviderCapabilitiesV2 } from "../orchestration-v2/Adapters/CodexAdapterV2.ts";
+import { OrchestratorV2, type OrchestratorV2Shape } from "../orchestration-v2/Orchestrator.ts";
+import { layer as threadManagementServiceLayer } from "../orchestration-v2/ThreadManagementService.ts";
+import {
+  type ProviderAdapterV2Event,
+  ProviderAdapterProtocolError,
+  type ProviderAdapterV2Shape,
+  type ProviderAdapterV2TurnInput,
+} from "../orchestration-v2/ProviderAdapter.ts";
+import { makeLayer as makeProviderAdapterRegistryLayer } from "../orchestration-v2/ProviderAdapterRegistry.ts";
+import {
+  type ProviderContinuationRequest,
+  ProviderContinuationRequests,
+} from "../orchestration-v2/ProviderContinuationRequests.ts";
+import { checkpointWorkspace } from "../orchestration-v2/testkit/ReplayFixtureWorkspace.ts";
+import { makeOrchestratorV2ReplayLayerWithRegistry } from "../orchestration-v2/testkit/ProviderReplayHarness.ts";
+import { makeProviderRegistryLayer } from "../provider/testUtils/providerRegistryMock.ts";
+import { ScheduledTaskService } from "../scheduledTasks/ScheduledTaskService.ts";
+import * as McpHttpServer from "./McpHttpServer.ts";
+import * as McpInvocationContext from "./McpInvocationContext.ts";
+
+const parentThreadId = ThreadId.make("thread:mcp-orchestrator-parent");
+const projectId = ProjectId.make("project:mcp-orchestrator");
+const codexInstanceId = ProviderInstanceId.make("codex");
+const claudeInstanceId = ProviderInstanceId.make("claudeAgent");
+const codexModel = "gpt-5.4";
+const claudeModel = "claude-sonnet-4-6";
+const parentPrompt = "Keep this parent turn active while orchestration tools are tested.";
+const delegatedPrompt = "Inspect the delegated API boundary and return the result.";
+const delegatedResult = "Delegated API boundary inspected.";
+const cancellationPrompt = "Remain active until the parent cancels this delegated task.";
+const createdThreadPrompt = "Complete the newly created ordinary thread.";
+
+const decodeCreateThreadsResult = Schema.decodeUnknownEffect(OrchestratorMcpCreateThreadsResult);
+const decodeCreatedThread = Schema.decodeUnknownEffect(OrchestratorMcpCreatedThread);
+const decodeDelegateTaskResult = Schema.decodeUnknownEffect(OrchestratorMcpDelegateTaskResult);
+const decodeTaskCancelResult = Schema.decodeUnknownEffect(OrchestratorMcpTaskCancelResult);
+const decodeThreadInterruptResult = Schema.decodeUnknownEffect(
+  OrchestratorMcpThreadInterruptResult,
+);
+const decodeThreadListResult = Schema.decodeUnknownEffect(OrchestratorMcpThreadListResult);
+const decodeThreadReadResult = Schema.decodeUnknownEffect(OrchestratorMcpThreadReadResult);
+const decodeThreadSendResult = Schema.decodeUnknownEffect(OrchestratorMcpThreadSendResult);
+const decodeThreadWaitResult = Schema.decodeUnknownEffect(OrchestratorMcpThreadWaitResult);
+
+const codexSelection = {
+  instanceId: codexInstanceId,
+  model: codexModel,
+} satisfies ModelSelection;
+
+const claudeSelection = {
+  instanceId: claudeInstanceId,
+  model: claudeModel,
+} satisfies ModelSelection;
+
+interface CapturedTurn {
+  readonly instanceId: ProviderInstanceId;
+  readonly threadId: ThreadId;
+  readonly text: string;
+}
+
+function unsupported(driver: ProviderDriverKind, detail: string) {
+  return Effect.fail(new ProviderAdapterProtocolError({ driver, detail }));
+}
+
+function makeProviderSnapshot(input: {
+  readonly instanceId: ProviderInstanceId;
+  readonly driver: ProviderDriverKind;
+  readonly model: string;
+  readonly optionDescriptors?: ReadonlyArray<ProviderOptionDescriptor>;
+}): ServerProvider {
+  return {
+    instanceId: input.instanceId,
+    driver: input.driver,
+    enabled: true,
+    installed: true,
+    version: "test",
+    status: "ready",
+    auth: { status: "authenticated" },
+    checkedAt: "2026-06-17T00:00:00.000Z",
+    models: [
+      {
+        slug: input.model,
+        name: input.model,
+        isCustom: false,
+        capabilities:
+          input.optionDescriptors === undefined
+            ? null
+            : { optionDescriptors: input.optionDescriptors },
+      },
+    ],
+    slashCommands: [],
+    skills: [],
+  };
+}
+
+function makeDeterministicAdapter(input: {
+  readonly instanceId: ProviderInstanceId;
+  readonly driver: ProviderDriverKind;
+  readonly capabilities: OrchestrationV2ProviderCapabilities;
+  readonly capturedTurns: Ref.Ref<ReadonlyArray<CapturedTurn>>;
+  readonly shouldComplete: (turn: ProviderAdapterV2TurnInput) => boolean;
+  readonly terminalGate?: (turn: ProviderAdapterV2TurnInput) => Deferred.Deferred<void> | undefined;
+  readonly response: (turn: ProviderAdapterV2TurnInput) => string;
+}): ProviderAdapterV2Shape {
+  return {
+    instanceId: input.instanceId,
+    driver: input.driver,
+    getCapabilities: () => Effect.succeed(input.capabilities),
+    planSelectionTransition: () => Effect.succeed({ type: "apply_on_next_turn" }),
+    openSession: (sessionInput) =>
+      Effect.gen(function* () {
+        const events = yield* PubSub.unbounded<ProviderAdapterV2Event>();
+        const now = yield* DateTime.now;
+        const providerSession: OrchestrationV2ProviderSession = {
+          id: sessionInput.providerSessionId,
+          driver: input.driver,
+          providerInstanceId: input.instanceId,
+          status: "ready",
+          cwd: sessionInput.runtimePolicy.cwd ?? process.cwd(),
+          model: sessionInput.modelSelection.model,
+          capabilities: input.capabilities,
+          createdAt: now,
+          updatedAt: now,
+          lastError: null,
+        };
+
+        const publish = (providerEvents: ReadonlyArray<ProviderAdapterV2Event>) =>
+          Effect.forEach(providerEvents, (event) => PubSub.publish(events, event), {
+            discard: true,
+          });
+        const runOrdinals = new Map<ProviderTurnId, number>();
+        const turnInputs = new Map<ProviderTurnId, ProviderAdapterV2TurnInput>();
+
+        return {
+          instanceId: input.instanceId,
+          driver: input.driver,
+          providerSessionId: sessionInput.providerSessionId,
+          providerSession,
+          events: Stream.fromPubSub(events),
+          ensureThread: (threadInput) =>
+            Effect.gen(function* () {
+              const createdAt = yield* DateTime.now;
+              const nativeThreadId = `${input.driver}:${threadInput.threadId}`;
+              return {
+                id: ProviderThreadId.make(`provider-thread:${nativeThreadId}`),
+                driver: input.driver,
+                providerInstanceId: input.instanceId,
+                providerSessionId: sessionInput.providerSessionId,
+                appThreadId: threadInput.threadId,
+                ownerNodeId: null,
+                nativeThreadRef: {
+                  driver: input.driver,
+                  nativeId: nativeThreadId,
+                  strength: "strong",
+                },
+                nativeConversationHeadRef: null,
+                status: "idle",
+                firstRunOrdinal: null,
+                lastRunOrdinal: null,
+                handoffIds: [],
+                forkedFrom: null,
+                createdAt,
+                updatedAt: createdAt,
+              } satisfies OrchestrationV2ProviderThread;
+            }),
+          resumeThread: ({ providerThread }) => Effect.succeed(providerThread),
+          startTurn: (turnInput) =>
+            Effect.gen(function* () {
+              yield* Ref.update(input.capturedTurns, (turns) => [
+                ...turns,
+                {
+                  instanceId: input.instanceId,
+                  threadId: turnInput.threadId,
+                  text: turnInput.message.text,
+                },
+              ]);
+              const eventTime = yield* DateTime.now;
+              const providerTurnId = ProviderTurnId.make(
+                `provider-turn:${input.instanceId}:${turnInput.threadId}:${turnInput.runOrdinal}`,
+              );
+              runOrdinals.set(providerTurnId, turnInput.runOrdinal);
+              turnInputs.set(providerTurnId, turnInput);
+              yield* publish([
+                {
+                  type: "provider_turn.updated",
+                  driver: input.driver,
+                  providerTurn: {
+                    id: providerTurnId,
+                    providerThreadId: turnInput.providerThread.id,
+                    nodeId: turnInput.rootNodeId,
+                    runAttemptId: turnInput.attemptId,
+                    nativeTurnRef: {
+                      driver: input.driver,
+                      nativeId: `native-turn:${turnInput.threadId}:${turnInput.runOrdinal}`,
+                      strength: "strong",
+                    },
+                    ordinal: turnInput.providerTurnOrdinal,
+                    status: "running",
+                    startedAt: eventTime,
+                    completedAt: null,
+                  },
+                },
+              ]);
+              const terminalGate = input.terminalGate?.(turnInput);
+              if (terminalGate !== undefined) {
+                yield* Deferred.await(terminalGate);
+              } else if (!input.shouldComplete(turnInput)) {
+                return;
+              }
+              const response = input.response(turnInput);
+              yield* publish([
+                {
+                  type: "provider_turn.updated",
+                  driver: input.driver,
+                  providerTurn: {
+                    id: providerTurnId,
+                    providerThreadId: turnInput.providerThread.id,
+                    nodeId: turnInput.rootNodeId,
+                    runAttemptId: turnInput.attemptId,
+                    nativeTurnRef: {
+                      driver: input.driver,
+                      nativeId: `native-turn:${turnInput.threadId}:${turnInput.runOrdinal}`,
+                      strength: "strong",
+                    },
+                    ordinal: turnInput.providerTurnOrdinal,
+                    status: "completed",
+                    startedAt: eventTime,
+                    completedAt: eventTime,
+                  },
+                },
+                {
+                  type: "turn_item.updated",
+                  driver: input.driver,
+                  turnItem: {
+                    id: TurnItemId.make(
+                      `turn-item:${input.instanceId}:${turnInput.threadId}:${turnInput.runOrdinal}:assistant`,
+                    ),
+                    threadId: turnInput.threadId,
+                    runId: turnInput.runId,
+                    nodeId: turnInput.rootNodeId,
+                    providerThreadId: turnInput.providerThread.id,
+                    providerTurnId,
+                    nativeItemRef: null,
+                    parentItemId: null,
+                    ordinal: turnInput.runOrdinal * 100 + 1,
+                    status: "completed",
+                    title: null,
+                    startedAt: eventTime,
+                    completedAt: eventTime,
+                    updatedAt: eventTime,
+                    type: "assistant_message",
+                    messageId: MessageId.make(
+                      `message:${input.instanceId}:${turnInput.threadId}:${turnInput.runOrdinal}:assistant`,
+                    ),
+                    text: response,
+                    streaming: false,
+                  },
+                },
+                {
+                  type: "turn.terminal",
+                  driver: input.driver,
+                  providerThreadId: turnInput.providerThread.id,
+                  providerTurnId,
+                  runOrdinal: turnInput.runOrdinal,
+                  status: "completed",
+                  failure: null,
+                  threadDisposition: "reusable",
+                },
+              ]);
+            }),
+          steerTurn: () => Effect.void,
+          interruptTurn: ({ providerThread, providerTurnId }) =>
+            Effect.gen(function* () {
+              const turnInput = turnInputs.get(providerTurnId);
+              const completedAt = yield* DateTime.now;
+              if (turnInput !== undefined) {
+                yield* publish([
+                  {
+                    type: "provider_turn.updated",
+                    driver: input.driver,
+                    providerTurn: {
+                      id: providerTurnId,
+                      providerThreadId: providerThread.id,
+                      nodeId: turnInput.rootNodeId,
+                      runAttemptId: turnInput.attemptId,
+                      nativeTurnRef: {
+                        driver: input.driver,
+                        nativeId: `native-turn:${turnInput.threadId}:${turnInput.runOrdinal}`,
+                        strength: "strong",
+                      },
+                      ordinal: turnInput.providerTurnOrdinal,
+                      status: "interrupted",
+                      startedAt: completedAt,
+                      completedAt,
+                    },
+                  },
+                ]);
+              }
+              yield* publish([
+                {
+                  type: "turn.terminal",
+                  driver: input.driver,
+                  providerThreadId: providerThread.id,
+                  providerTurnId,
+                  runOrdinal: runOrdinals.get(providerTurnId) ?? 1,
+                  status: "interrupted",
+                  failure: null,
+                  threadDisposition: "reusable",
+                },
+              ]);
+            }),
+          respondToRuntimeRequest: () => Effect.void,
+          readThreadSnapshot: () =>
+            unsupported(input.driver, "readThreadSnapshot is unused in this test"),
+          rollbackThread: () => unsupported(input.driver, "rollbackThread is unused in this test"),
+          forkThread: () => unsupported(input.driver, "forkThread is unused in this test"),
+        };
+      }),
+  };
+}
+
+function waitForProjection(
+  orchestrator: OrchestratorV2Shape,
+  threadId: ThreadId,
+  predicate: (projection: OrchestrationV2ThreadProjection) => boolean,
+) {
+  return Effect.gen(function* () {
+    for (let attempt = 0; attempt < 1_000; attempt += 1) {
+      const projection = yield* orchestrator.getThreadProjection(threadId);
+      if (predicate(projection)) {
+        return projection;
+      }
+      yield* Effect.sleep("5 millis");
+    }
+    return yield* Effect.die(
+      new Error(`Timed out waiting for orchestration projection ${threadId}.`),
+    );
+  });
+}
+
+const client = McpSchema.McpServerClient.of({
+  clientId: 1,
+  protocolVersion: "2025-06-18",
+  initializePayload: {
+    protocolVersion: "2025-06-18",
+    capabilities: {},
+    clientInfo: { name: "orchestrator-mcp-test", version: "1.0.0" },
+  },
+  getClient: Effect.die("unused"),
+});
+
+/** Build a persisted-looking ScheduledTask from an upsert input for the in-memory stub. */
+function scheduledTaskFromUpsert(input: ScheduledTaskUpsertInput): ScheduledTask {
+  const timestamp = IsoDateTime.make("2026-07-01T09:00:00.000Z");
+  return {
+    id: input.id ?? ScheduledTaskId.make(`scheduled-task:${input.commandId ?? "stub"}`),
+    title: input.title,
+    prompt: input.prompt,
+    enabled: input.enabled,
+    schedule: input.schedule,
+    projectId: input.projectId,
+    threadId: input.threadId ?? null,
+    workspaceStrategy: input.workspaceStrategy,
+    modelSelection: input.modelSelection,
+    runtimeMode: input.runtimeMode,
+    interactionMode: input.interactionMode,
+    createdBy: input.createdBy ?? "user",
+    creationSource: input.creationSource ?? "web",
+    createdAt: timestamp,
+    updatedAt: timestamp,
+    nextRunAt: null,
+    lastRunAt: null,
+    lastRunStatus: "never",
+    lastRunError: null,
+    runCount: 0,
+  };
+}
+
+describe("orchestrator MCP toolkit", () => {
+  it.live(
+    "delegates cross-provider tasks, polls and cancels children, and creates ordinary threads",
+    () =>
+      Effect.scoped(
+        Effect.gen(function* () {
+          const cwd = yield* checkpointWorkspace("orchestrator-mcp-toolkit");
+          const capturedTurns = yield* Ref.make<ReadonlyArray<CapturedTurn>>([]);
+          const parentTerminalGates = new Map<ThreadId, Deferred.Deferred<void>>();
+          const deliveryTerminalGates = new Map<ThreadId, Deferred.Deferred<void>>();
+          const registryLayer = makeProviderAdapterRegistryLayer([
+            makeDeterministicAdapter({
+              instanceId: codexInstanceId,
+              driver: ProviderDriverKind.make("codex"),
+              capabilities: CodexProviderCapabilitiesV2,
+              capturedTurns,
+              shouldComplete: (turn) =>
+                turn.threadId !== parentThreadId && turn.message.text !== cancellationPrompt,
+              terminalGate: (turn) =>
+                turn.message.text.startsWith("Delegated task") ||
+                turn.message.text.startsWith("Delegated tasks")
+                  ? deliveryTerminalGates.get(turn.threadId)
+                  : parentTerminalGates.get(turn.threadId),
+              response: (turn) => `Codex completed: ${turn.message.text}`,
+            }),
+            makeDeterministicAdapter({
+              instanceId: claudeInstanceId,
+              driver: ProviderDriverKind.make("claudeAgent"),
+              capabilities: ClaudeProviderCapabilitiesV2,
+              capturedTurns,
+              shouldComplete: (turn) => turn.message.text !== cancellationPrompt,
+              terminalGate: (turn) =>
+                turn.message.text.startsWith("Delegated task") ||
+                turn.message.text.startsWith("Delegated tasks")
+                  ? deliveryTerminalGates.get(turn.threadId)
+                  : parentTerminalGates.get(turn.threadId),
+              response: (turn) =>
+                turn.message.text === delegatedPrompt
+                  ? delegatedResult
+                  : `Claude completed: ${turn.message.text}`,
+            }),
+          ]);
+          // Captures parent-wake offers made when a delegated child
+          // terminalizes after the parent run settled.
+          const continuationOffers = yield* Ref.make<ReadonlyArray<ProviderContinuationRequest>>(
+            [],
+          );
+          const continuationProbeLayer = Layer.succeed(ProviderContinuationRequests, {
+            offer: (request) =>
+              Ref.update(continuationOffers, (existing) => [...existing, request]),
+            take: Effect.never,
+          });
+          // Offers land after the finalize projection writes, so poll briefly
+          // instead of asserting counts immediately.
+          const waitForContinuationOffers = (count: number) =>
+            Effect.gen(function* () {
+              for (let attempt = 0; attempt < 1_000; attempt += 1) {
+                const current = yield* Ref.get(continuationOffers);
+                if (current.length >= count) {
+                  return current;
+                }
+                yield* Effect.sleep("5 millis");
+              }
+              return yield* Ref.get(continuationOffers);
+            });
+          // Absence has no event to await, so sample repeatedly instead of
+          // trusting a single sleep to outlast a late offer.
+          const expectOffersToStay = (count: number) =>
+            Effect.gen(function* () {
+              for (let sample = 0; sample < 4; sample += 1) {
+                yield* Effect.sleep("50 millis");
+                expect(yield* Ref.get(continuationOffers)).toHaveLength(count);
+              }
+            });
+          const orchestratorLayer = makeOrchestratorV2ReplayLayerWithRegistry(
+            {
+              name: "orchestrator-mcp-toolkit",
+              runtimePolicyOverride: {
+                cwd,
+                approvalPolicy: "never",
+                sandboxPolicy: {
+                  type: "readOnly",
+                  access: { type: "fullAccess" },
+                  networkAccess: false,
+                },
+              },
+            },
+            registryLayer,
+          ).pipe(Layer.provide(continuationProbeLayer));
+          const orchestrationLayer = Layer.merge(
+            orchestratorLayer,
+            threadManagementServiceLayer.pipe(Layer.provide(orchestratorLayer)),
+          );
+          const providerRegistryLayer = makeProviderRegistryLayer([
+            makeProviderSnapshot({
+              instanceId: codexInstanceId,
+              driver: ProviderDriverKind.make("codex"),
+              model: codexModel,
+              optionDescriptors: [
+                {
+                  id: "reasoning",
+                  label: "Reasoning effort",
+                  type: "select",
+                  options: [
+                    { id: "low", label: "Low" },
+                    { id: "medium", label: "Medium" },
+                    { id: "high", label: "High" },
+                  ],
+                },
+              ],
+            }),
+            makeProviderSnapshot({
+              instanceId: claudeInstanceId,
+              driver: ProviderDriverKind.make("claudeAgent"),
+              model: claudeModel,
+            }),
+            makeProviderSnapshot({
+              instanceId: ProviderInstanceId.make("opencode"),
+              driver: ProviderDriverKind.make("opencode"),
+              model: "opencode/test",
+            }),
+          ]);
+          // In-memory ScheduledTaskService stub so the schedule/list/update/
+          // delete tools can be exercised without SQL/launch wiring.
+          const scheduledStore = yield* Ref.make<ReadonlyArray<ScheduledTask>>([]);
+          const scheduledTaskStubLayer = Layer.succeed(
+            ScheduledTaskService,
+            ScheduledTaskService.of({
+              list: () => Ref.get(scheduledStore).pipe(Effect.map((tasks) => ({ tasks }))),
+              subscribeList: () => Stream.empty,
+              upsert: (input) =>
+                Effect.gen(function* () {
+                  const task = scheduledTaskFromUpsert(input);
+                  yield* Ref.update(scheduledStore, (all) => [
+                    ...all.filter((candidate) => candidate.id !== task.id),
+                    task,
+                  ]);
+                  return { task };
+                }),
+              setEnabled: () =>
+                Effect.die("ScheduledTaskService.setEnabled is unused in this test"),
+              delete: (input) =>
+                Ref.update(scheduledStore, (all) =>
+                  all.filter((candidate) => candidate.id !== input.id),
+                ).pipe(Effect.as({ id: input.id })),
+              runNow: () => Effect.die("ScheduledTaskService.runNow is unused in this test"),
+            }),
+          );
+          const testLayer = McpHttpServer.OrchestratorToolkitRegistrationLive.pipe(
+            Layer.provideMerge(McpServer.McpServer.layer),
+            Layer.provideMerge(orchestrationLayer),
+            Layer.provide(providerRegistryLayer),
+            Layer.provide(scheduledTaskStubLayer),
+            Layer.provide(NodeServices.layer),
+          );
+
+          yield* Effect.gen(function* () {
+            const orchestrator = yield* OrchestratorV2;
+            const server = yield* McpServer.McpServer;
+            yield* orchestrator.dispatch({
+              type: "thread.create",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: CommandId.make("command:mcp-parent:create"),
+              threadId: parentThreadId,
+              projectId,
+              title: "MCP parent",
+              modelSelection: codexSelection,
+              runtimeMode: "full-access",
+              interactionMode: "default",
+              branch: null,
+              worktreePath: cwd,
+            });
+            yield* orchestrator.dispatch({
+              type: "message.dispatch",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: CommandId.make("command:mcp-parent:start"),
+              threadId: parentThreadId,
+              messageId: MessageId.make("message:mcp-parent:start"),
+              text: parentPrompt,
+              attachments: [],
+              modelSelection: codexSelection,
+              dispatchMode: { type: "start_immediately" },
+            });
+            const parent = yield* waitForProjection(
+              orchestrator,
+              parentThreadId,
+              (projection) =>
+                projection.runs.some((run) =>
+                  ["starting", "running", "waiting"].includes(run.status),
+                ) && projection.providerTurns.some((turn) => turn.status === "running"),
+            );
+            const parentRun = parent.runs[0];
+            expect(parentRun?.status).toBe("running");
+
+            const invocation: McpInvocationContext.McpInvocationScope = {
+              environmentId: EnvironmentId.make("environment:mcp-orchestrator"),
+              threadId: parentThreadId,
+              providerSessionId: "mcp-provider-session-parent",
+              providerInstanceId: codexInstanceId,
+              capabilities: new Set(["orchestration"]),
+              issuedAt: 1,
+            };
+            const invoke = (name: string, args: Record<string, unknown>) =>
+              server
+                .callTool({ name, arguments: args })
+                .pipe(
+                  Effect.provideService(McpInvocationContext.McpInvocationContext, invocation),
+                  Effect.provideService(McpSchema.McpServerClient, client),
+                );
+
+            if (parentRun === undefined || parentRun.rootNodeId === null) {
+              return yield* Effect.die(new Error("Parent run missing."));
+            }
+            let parentRootNodeId = parentRun.rootNodeId;
+            const queueAutomaticCompletion = (suffix: string, taskText: string) =>
+              Effect.gen(function* () {
+                const delegated = yield* orchestrator.dispatch({
+                  type: "delegated_task.request",
+                  createdBy: "agent",
+                  creationSource: "mcp",
+                  commandId: CommandId.make(`command:mcp-parent:${suffix}:delegate`),
+                  parentThreadId,
+                  parentRunId: parentRun.id,
+                  parentNodeId: parentRootNodeId,
+                  task: taskText,
+                  modelSelection: claudeSelection,
+                  runtimeMode: "full-access",
+                  interactionMode: "default",
+                  completionWake: "always",
+                });
+                const taskEvent = delegated.storedEvents.find(
+                  (stored) =>
+                    stored.event.type === "subagent.updated" &&
+                    stored.event.payload.origin === "app_owned",
+                );
+                if (taskEvent?.event.type !== "subagent.updated") {
+                  return yield* Effect.die(
+                    new Error(`Automatic completion task ${suffix} was not created.`),
+                  );
+                }
+                const task = taskEvent.event.payload;
+                const reserved = yield* waitForProjection(
+                  orchestrator,
+                  parentThreadId,
+                  (projection) => {
+                    const delivery = projection.runs.find((run) => run.id === parentRun.id)
+                      ?.delegatedCompletion?.delivery;
+                    return (
+                      projection.subagents.find((candidate) => candidate.id === task.id)?.status ===
+                        "completed" &&
+                      delivery !== undefined &&
+                      delivery !== null &&
+                      delivery.taskIds.includes(task.id)
+                    );
+                  },
+                );
+                const delivery = reserved.runs.find((run) => run.id === parentRun.id)
+                  ?.delegatedCompletion?.delivery;
+                if (delivery === undefined || delivery === null) {
+                  return yield* Effect.die(
+                    new Error(`Automatic completion delivery ${suffix} was not reserved.`),
+                  );
+                }
+                yield* orchestrator.dispatch({
+                  type: "message.dispatch",
+                  createdBy: "agent",
+                  creationSource: "server",
+                  commandId: CommandId.make(`command:mcp-parent:${suffix}:dispatch`),
+                  threadId: parentThreadId,
+                  messageId: delivery.messageId,
+                  text: "Delegated task reached a terminal state.",
+                  attachments: [],
+                  modelSelection: codexSelection,
+                  dispatchMode: { type: "queue_after_active" },
+                  delegatedCompletion: {
+                    parentRunId: parentRun.id,
+                    generation: delivery.generation,
+                    taskIds: delivery.taskIds,
+                  },
+                });
+                const queued = yield* waitForProjection(
+                  orchestrator,
+                  parentThreadId,
+                  (projection) =>
+                    projection.runs.some(
+                      (run) => run.userMessageId === delivery.messageId && run.status === "queued",
+                    ),
+                );
+                const queuedRun = queued.runs.find(
+                  (run) => run.userMessageId === delivery.messageId,
+                );
+                if (queuedRun === undefined) {
+                  return yield* Effect.die(
+                    new Error(`Automatic completion delivery ${suffix} was not queued.`),
+                  );
+                }
+                return { task, delivery, queuedRun };
+              });
+
+            // Several async terminals belonging to one parent run reserve one
+            // durable delivery. The continuation worker owns the later
+            // message.dispatch, so use the same metadata here while the test
+            // probe records the offers instead of starting a worker.
+            const coalescedTask = (suffix: string) =>
+              orchestrator.dispatch({
+                type: "delegated_task.request",
+                createdBy: "agent",
+                creationSource: "mcp",
+                commandId: CommandId.make(`command:mcp-parent:coalesced-${suffix}`),
+                parentThreadId,
+                parentRunId: parentRun.id,
+                parentNodeId: parentRootNodeId,
+                task: `Complete coalesced task ${suffix}.`,
+                modelSelection: claudeSelection,
+                runtimeMode: "full-access",
+                interactionMode: "default",
+                completionWake: "always",
+              });
+            const firstCoalesced = yield* coalescedTask("one");
+            const secondCoalesced = yield* coalescedTask("two");
+            const coalescedTaskIds = [firstCoalesced, secondCoalesced].map((result) => {
+              const taskEvent = result.storedEvents.find(
+                (stored) =>
+                  stored.event.type === "subagent.updated" &&
+                  stored.event.payload.origin === "app_owned",
+              );
+              if (taskEvent?.event.type !== "subagent.updated") {
+                throw new Error("Coalesced delegated task projection missing.");
+              }
+              return taskEvent.event.payload.id;
+            });
+            const coalescedProjection = yield* waitForProjection(
+              orchestrator,
+              parentThreadId,
+              (projection) =>
+                coalescedTaskIds.every(
+                  (taskId) =>
+                    projection.subagents.find((task) => task.id === taskId)?.status === "completed",
+                ) &&
+                projection.runs.find((run) => run.id === parentRun.id)?.delegatedCompletion !==
+                  undefined,
+            );
+            const coalescedCohort = coalescedProjection.runs.find(
+              (run) => run.id === parentRun.id,
+            )?.delegatedCompletion;
+            expect(coalescedCohort?.delivery?.taskIds).toEqual(
+              expect.arrayContaining(coalescedTaskIds),
+            );
+            expect(coalescedCohort?.delivery?.taskIds).toHaveLength(2);
+            const coalescedOffers = yield* waitForContinuationOffers(1);
+            expect(coalescedOffers).toEqual(
+              expect.arrayContaining([
+                expect.objectContaining({
+                  delegatedCompletion: expect.objectContaining({
+                    parentRunId: parentRun.id,
+                    messageId: coalescedCohort?.delivery?.messageId,
+                  }),
+                }),
+              ]),
+            );
+            if (coalescedCohort?.delivery === undefined || coalescedCohort.delivery === null) {
+              return yield* Effect.die(new Error("Coalesced delivery reservation missing."));
+            }
+            const coalescedDelivery = coalescedCohort.delivery;
+            yield* orchestrator.dispatch({
+              type: "message.dispatch",
+              createdBy: "agent",
+              creationSource: "server",
+              commandId: CommandId.make("command:mcp-parent:dispatch-coalesced-delivery"),
+              threadId: parentThreadId,
+              messageId: coalescedDelivery.messageId,
+              text: "Delegated tasks reached terminal states.",
+              attachments: [],
+              modelSelection: codexSelection,
+              dispatchMode: { type: "queue_after_active" },
+              delegatedCompletion: {
+                parentRunId: parentRun.id,
+                generation: coalescedDelivery.generation,
+                taskIds: coalescedDelivery.taskIds,
+              },
+            });
+            const queuedCoalesced = yield* waitForProjection(
+              orchestrator,
+              parentThreadId,
+              (projection) =>
+                projection.runs.some(
+                  (run) =>
+                    run.userMessageId === coalescedDelivery.messageId && run.status === "queued",
+                ),
+            );
+            const queuedCoalescedRun = queuedCoalesced.runs.find(
+              (run) => run.userMessageId === coalescedDelivery.messageId,
+            );
+            expect(queuedCoalescedRun?.status).toBe("queued");
+            if (queuedCoalescedRun === undefined) {
+              return yield* Effect.die(new Error("Queued coalesced delivery missing."));
+            }
+
+            // Server-owned delivery ownership is authoritative even if a
+            // stale client tries to mutate the queue directly.
+            const completionEditError = yield* orchestrator
+              .dispatch({
+                type: "queued-run.edit",
+                commandId: CommandId.make("command:mcp-parent:edit-coalesced-delivery"),
+                threadId: parentThreadId,
+                runId: queuedCoalescedRun.id,
+                text: "Rewrite the automatic delivery.",
+              })
+              .pipe(Effect.flip);
+            expect(completionEditError._tag).toBe("OrchestratorDispatchError");
+            const completionReorderError = yield* orchestrator
+              .dispatch({
+                type: "queued-run.reorder",
+                commandId: CommandId.make("command:mcp-parent:reorder-coalesced-delivery"),
+                threadId: parentThreadId,
+                runId: queuedCoalescedRun.id,
+                beforeRunId: null,
+              })
+              .pipe(Effect.flip);
+            expect(completionReorderError._tag).toBe("OrchestratorDispatchError");
+            const completionSteerError = yield* orchestrator
+              .dispatch({
+                type: "queued-message.promote-to-steer",
+                commandId: CommandId.make("command:mcp-parent:steer-coalesced-delivery"),
+                threadId: parentThreadId,
+                queuedRunId: queuedCoalescedRun.id,
+                targetRunId: parentRun.id,
+              })
+              .pipe(Effect.flip);
+            expect(completionSteerError._tag).toBe("OrchestratorDispatchError");
+
+            for (const taskId of coalescedTaskIds) {
+              const statusCall = yield* invoke("task_status", { taskId });
+              expect(statusCall.isError).toBe(false);
+            }
+            const acknowledgedCoalesced = yield* waitForProjection(
+              orchestrator,
+              parentThreadId,
+              (projection) =>
+                projection.runs.find((run) => run.id === queuedCoalescedRun.id)?.status ===
+                  "cancelled" &&
+                coalescedTaskIds.every(
+                  (taskId) =>
+                    projection.subagents.find((task) => task.id === taskId)?.completionDelivery
+                      ?.state === "acknowledged",
+                ),
+            );
+            expect(
+              acknowledgedCoalesced.runs.find((run) => run.id === parentRun.id)?.delegatedCompletion
+                ?.delivery,
+            ).toBeNull();
+            yield* Ref.set(continuationOffers, []);
+
+            // Waiting only observes the child run's status. A direct parent
+            // read acknowledges delivery only after the terminal result is
+            // returned untruncated, never from the child prompt or a partial
+            // result page.
+            const directRead = yield* queueAutomaticCompletion(
+              "direct-child-read",
+              "Complete before a parent reads this child result directly.",
+            );
+            if (directRead.task.childThreadId === null) {
+              return yield* Effect.die(new Error("Direct-read child thread missing."));
+            }
+            const directChildThreadId = directRead.task.childThreadId;
+            const directChildWaitCall = yield* invoke("t3_thread_wait", {
+              threadId: directChildThreadId,
+              timeoutMs: 10_000,
+            });
+            const directChildWait = yield* decodeThreadWaitResult(
+              directChildWaitCall.structuredContent,
+            ).pipe(Effect.orDie);
+            expect(directChildWait).toMatchObject({
+              threadId: directChildThreadId,
+              status: "completed",
+              timedOut: false,
+            });
+            const pendingAfterWait = yield* orchestrator.getThreadProjection(parentThreadId);
+            expect(
+              pendingAfterWait.subagents.find((task) => task.id === directRead.task.id)
+                ?.completionDelivery?.state,
+            ).toBe("claimed");
+            expect(
+              pendingAfterWait.runs.find((run) => run.id === directRead.queuedRun.id)?.status,
+            ).toBe("queued");
+
+            const childPromptReadCall = yield* invoke("t3_thread_read", {
+              threadId: directChildThreadId,
+              limit: 1,
+            });
+            const childPromptRead = yield* decodeThreadReadResult(
+              childPromptReadCall.structuredContent,
+            ).pipe(Effect.orDie);
+            expect(childPromptRead.items.map((item) => item.type)).toEqual(["user_message"]);
+            if (childPromptRead.nextPosition === null) {
+              return yield* Effect.die(new Error("Direct-read child prompt position missing."));
+            }
+            expect(
+              (yield* orchestrator.getThreadProjection(parentThreadId)).subagents.find(
+                (task) => task.id === directRead.task.id,
+              )?.completionDelivery?.state,
+            ).toBe("claimed");
+
+            const truncatedResultReadCall = yield* invoke("t3_thread_read", {
+              threadId: directChildThreadId,
+              afterPosition: childPromptRead.nextPosition,
+              limit: 1,
+              maxCharsPerItem: 1,
+            });
+            const truncatedResultRead = yield* decodeThreadReadResult(
+              truncatedResultReadCall.structuredContent,
+            ).pipe(Effect.orDie);
+            expect(truncatedResultRead.items).toMatchObject([
+              { type: "assistant_message", textTruncated: true },
+            ]);
+            expect(
+              (yield* orchestrator.getThreadProjection(parentThreadId)).subagents.find(
+                (task) => task.id === directRead.task.id,
+              )?.completionDelivery?.state,
+            ).toBe("claimed");
+
+            const terminalResultReadCall = yield* invoke("t3_thread_read", {
+              threadId: directChildThreadId,
+              afterPosition: childPromptRead.nextPosition,
+              limit: 1,
+            });
+            const terminalResultRead = yield* decodeThreadReadResult(
+              terminalResultReadCall.structuredContent,
+            ).pipe(Effect.orDie);
+            expect(terminalResultRead.items).toMatchObject([
+              {
+                type: "assistant_message",
+                text: "Claude completed: Complete before a parent reads this child result directly.",
+                textTruncated: false,
+              },
+            ]);
+            const acknowledgedByDirectRead = yield* waitForProjection(
+              orchestrator,
+              parentThreadId,
+              (projection) =>
+                projection.runs.find((run) => run.id === directRead.queuedRun.id)?.status ===
+                  "cancelled" &&
+                projection.subagents.find((task) => task.id === directRead.task.id)
+                  ?.completionDelivery?.state === "acknowledged",
+            );
+            expect(
+              acknowledgedByDirectRead.subagents.find((task) => task.id === directRead.task.id)
+                ?.completionDelivery,
+            ).toMatchObject({ state: "acknowledged", observedByRunId: parentRun.id });
+            yield* Ref.set(continuationOffers, []);
+
+            // New user work retains its own queue entry while an explicit
+            // observation disposes the stale automatic one.
+            const queueRace = yield* queueAutomaticCompletion(
+              "queue-race",
+              "Complete before a user queues follow-up work.",
+            );
+            const queuedUserMessageId = MessageId.make("message:mcp-parent:queue-race:user");
+            yield* orchestrator.dispatch({
+              type: "message.dispatch",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: CommandId.make("command:mcp-parent:queue-race:user"),
+              threadId: parentThreadId,
+              messageId: queuedUserMessageId,
+              text: "Queue user follow-up work.",
+              attachments: [],
+              modelSelection: codexSelection,
+              dispatchMode: { type: "queue_after_active" },
+            });
+            const queueRaceQueued = yield* waitForProjection(
+              orchestrator,
+              parentThreadId,
+              (projection) =>
+                projection.runs.some((run) => run.id === queueRace.queuedRun.id) &&
+                projection.runs.some(
+                  (run) => run.userMessageId === queuedUserMessageId && run.status === "queued",
+                ),
+            );
+            const queuedUserRun = queueRaceQueued.runs.find(
+              (run) => run.userMessageId === queuedUserMessageId,
+            );
+            if (queuedUserRun === undefined) {
+              return yield* Effect.die(new Error("Queued user follow-up missing."));
+            }
+            const queueRaceStatus = yield* invoke("task_status", { taskId: queueRace.task.id });
+            expect(queueRaceStatus.isError).toBe(false);
+            yield* waitForProjection(
+              orchestrator,
+              parentThreadId,
+              (projection) =>
+                projection.runs.find((run) => run.id === queueRace.queuedRun.id)?.status ===
+                  "cancelled" &&
+                projection.runs.find((run) => run.id === queuedUserRun.id)?.status === "queued" &&
+                projection.subagents.find((task) => task.id === queueRace.task.id)
+                  ?.completionDelivery?.state === "acknowledged",
+            );
+            yield* orchestrator.dispatch({
+              type: "queued-run.cancel",
+              commandId: CommandId.make("command:mcp-parent:queue-race:cleanup"),
+              threadId: parentThreadId,
+              runId: queuedUserRun.id,
+            });
+
+            // A native in-place Steer keeps the parent active. Once the
+            // parent observes the child result, its queued delivery is stale.
+            const steerRace = yield* queueAutomaticCompletion(
+              "steer-race",
+              "Complete before a user steers the parent.",
+            );
+            const steerMessageId = MessageId.make("message:mcp-parent:steer-race:user");
+            yield* orchestrator.dispatch({
+              type: "message.dispatch",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: CommandId.make("command:mcp-parent:steer-race:user"),
+              threadId: parentThreadId,
+              messageId: steerMessageId,
+              text: "Steer the active parent after receiving the result.",
+              attachments: [],
+              modelSelection: codexSelection,
+              dispatchMode: { type: "steer_active", targetRunId: parentRun.id },
+            });
+            const steerRaceStatus = yield* invoke("task_status", { taskId: steerRace.task.id });
+            expect(steerRaceStatus.isError).toBe(false);
+            const acknowledgedSteerRace = yield* waitForProjection(
+              orchestrator,
+              parentThreadId,
+              (projection) =>
+                projection.messages.some((message) => message.id === steerMessageId) &&
+                projection.runs.find((run) => run.id === parentRun.id)?.status === "running" &&
+                projection.runs.find((run) => run.id === steerRace.queuedRun.id)?.status ===
+                  "cancelled" &&
+                projection.subagents.find((task) => task.id === steerRace.task.id)
+                  ?.completionDelivery?.state === "acknowledged",
+            );
+            expect(
+              acknowledgedSteerRace.runs.find((run) => run.id === parentRun.id)?.delegatedCompletion
+                ?.delivery,
+            ).toBeNull();
+
+            // Restart creates a new attempt for the same parent cohort. The
+            // old terminal must not turn that continuation into a Stop
+            // barrier, and an acknowledged result cancels the stale delivery.
+            const restartRace = yield* queueAutomaticCompletion(
+              "restart-race",
+              "Complete before a user restarts the parent.",
+            );
+            const attemptBeforeRestart = (yield* orchestrator.getThreadProjection(
+              parentThreadId,
+            )).runs.find((run) => run.id === parentRun.id)?.activeAttemptId;
+            const restartMessageId = MessageId.make("message:mcp-parent:restart-race:user");
+            yield* orchestrator.dispatch({
+              type: "message.dispatch",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: CommandId.make("command:mcp-parent:restart-race:user"),
+              threadId: parentThreadId,
+              messageId: restartMessageId,
+              text: "Restart the active parent after receiving the result.",
+              attachments: [],
+              modelSelection: codexSelection,
+              dispatchMode: { type: "restart_active", targetRunId: parentRun.id },
+            });
+            const restartedParent = yield* waitForProjection(
+              orchestrator,
+              parentThreadId,
+              (projection) => {
+                const run = projection.runs.find((candidate) => candidate.id === parentRun.id);
+                return (
+                  run?.status === "running" &&
+                  run.activeAttemptId !== attemptBeforeRestart &&
+                  run.rootNodeId !== null
+                );
+              },
+            );
+            const currentParentRun = restartedParent.runs.find((run) => run.id === parentRun.id);
+            if (currentParentRun?.rootNodeId === null || currentParentRun === undefined) {
+              return yield* Effect.die(new Error("Restarted parent run missing."));
+            }
+            parentRootNodeId = currentParentRun.rootNodeId;
+            expect(currentParentRun.delegatedCompletion?.disposition).toBe("open");
+            const restartRaceStatus = yield* invoke("task_status", {
+              taskId: restartRace.task.id,
+            });
+            expect(restartRaceStatus.isError).toBe(false);
+            yield* waitForProjection(
+              orchestrator,
+              parentThreadId,
+              (projection) =>
+                projection.messages.some((message) => message.id === restartMessageId) &&
+                projection.runs.find((run) => run.id === restartRace.queuedRun.id)?.status ===
+                  "cancelled" &&
+                projection.subagents.find((task) => task.id === restartRace.task.id)
+                  ?.completionDelivery?.state === "acknowledged" &&
+                projection.runs.find((run) => run.id === parentRun.id)?.delegatedCompletion
+                  ?.disposition === "open",
+            );
+            yield* Ref.set(continuationOffers, []);
+
+            const capabilitiesTool = server.tools.find(
+              ({ tool }) => tool.name === "orchestrator_capabilities",
+            );
+            expect(capabilitiesTool?.tool.annotations?.readOnlyHint).toBe(true);
+            expect(capabilitiesTool?.tool.annotations?.idempotentHint).toBe(true);
+            const delegateTool = server.tools.find(({ tool }) => tool.name === "delegate_task");
+            expect(delegateTool?.tool.annotations?.destructiveHint).toBe(true);
+            expect(delegateTool?.tool.annotations?.openWorldHint).toBe(true);
+            const taskStatusTool = server.tools.find(({ tool }) => tool.name === "task_status");
+            expect(taskStatusTool?.tool.annotations?.readOnlyHint).toBe(false);
+            expect(taskStatusTool?.tool.annotations?.idempotentHint).toBe(true);
+            const createThreadsTool = server.tools.find(
+              ({ tool }) => tool.name === "create_threads",
+            );
+            expect(createThreadsTool?.tool.annotations?.destructiveHint).toBe(true);
+            const threadListTool = server.tools.find(({ tool }) => tool.name === "t3_thread_list");
+            expect(threadListTool?.tool.annotations?.readOnlyHint).toBe(true);
+            expect(threadListTool?.tool.annotations?.idempotentHint).toBe(true);
+            const threadReadTool = server.tools.find(({ tool }) => tool.name === "t3_thread_read");
+            expect(threadReadTool?.tool.annotations?.readOnlyHint).toBe(false);
+            const threadSendTool = server.tools.find(({ tool }) => tool.name === "t3_thread_send");
+            expect(threadSendTool?.tool.annotations?.destructiveHint).toBe(true);
+            const threadWaitTool = server.tools.find(({ tool }) => tool.name === "t3_thread_wait");
+            expect(threadWaitTool?.tool.annotations?.readOnlyHint).toBe(true);
+            const threadInterruptTool = server.tools.find(
+              ({ tool }) => tool.name === "t3_thread_interrupt",
+            );
+            expect(threadInterruptTool?.tool.annotations?.destructiveHint).toBe(true);
+
+            const capabilities = yield* invoke("orchestrator_capabilities", {});
+            expect(capabilities.isError).toBe(false);
+            expect(capabilities.structuredContent).toMatchObject({
+              inheritedProviderInstanceId: codexInstanceId,
+              inheritedModel: codexModel,
+              features: {
+                appOwnedSubagents: true,
+                asyncPolling: true,
+                cancellation: true,
+                batchThreadCreation: true,
+                threadManagement: true,
+                incrementalThreadRead: true,
+              },
+              providers: expect.arrayContaining([
+                expect.objectContaining({
+                  providerInstanceId: claudeInstanceId,
+                  canRunCrossProviderChildTask: true,
+                }),
+                expect.objectContaining({
+                  providerInstanceId: "opencode",
+                  canRunChildTask: true,
+                }),
+                // Models advertise their option descriptors so agents can
+                // discover valid target.options ids and values.
+                expect.objectContaining({
+                  providerInstanceId: codexInstanceId,
+                  models: [
+                    expect.objectContaining({
+                      id: codexModel,
+                      options: [expect.objectContaining({ id: "reasoning", type: "select" })],
+                    }),
+                  ],
+                }),
+              ]),
+            });
+
+            const scheduleTool = server.tools.find(({ tool }) => tool.name === "schedule_task");
+            expect(scheduleTool?.tool.annotations?.destructiveHint).toBe(true);
+            const scheduleCall = yield* invoke("schedule_task", {
+              prompt: "wake up in this thread and say hello",
+              schedule: { type: "interval", everyMs: 60_000 },
+              clientRequestId: "schedule-hello-1",
+            });
+            expect(scheduleCall.isError).toBe(false);
+            expect(scheduleCall.structuredContent).toMatchObject({
+              // Defaults to binding the calling thread.
+              boundThreadId: parentThreadId,
+              projectId,
+              enabled: true,
+              schedule: { type: "interval", everyMs: 60_000 },
+              // Title is derived from the prompt when omitted.
+              title: "wake up in this thread and say hello",
+            });
+            const scheduledTaskId = (scheduleCall.structuredContent as { scheduledTaskId: string })
+              .scheduledTaskId;
+            const storedAfterCreate = yield* Ref.get(scheduledStore);
+            expect(storedAfterCreate).toHaveLength(1);
+            expect(storedAfterCreate[0]).toMatchObject({
+              threadId: parentThreadId,
+              projectId,
+              createdBy: "agent",
+              creationSource: "mcp",
+              // Inherits the parent thread's model selection.
+              modelSelection: codexSelection,
+            });
+
+            // list_scheduled_tasks returns the task scoped to this project.
+            const scheduledListCall = yield* invoke("list_scheduled_tasks", {});
+            expect(scheduledListCall.isError).toBe(false);
+            expect(scheduledListCall.structuredContent).toMatchObject({
+              tasks: [{ scheduledTaskId, boundThreadId: parentThreadId }],
+            });
+
+            // update_scheduled_task pauses without deleting.
+            const scheduledUpdateCall = yield* invoke("update_scheduled_task", {
+              scheduledTaskId,
+              enabled: false,
+            });
+            expect(scheduledUpdateCall.isError).toBe(false);
+            expect(scheduledUpdateCall.structuredContent).toMatchObject({
+              scheduledTaskId,
+              enabled: false,
+            });
+
+            // delete_scheduled_task removes it entirely.
+            const scheduledDeleteCall = yield* invoke("delete_scheduled_task", { scheduledTaskId });
+            expect(scheduledDeleteCall.isError).toBe(false);
+            expect(scheduledDeleteCall.structuredContent).toMatchObject({
+              scheduledTaskId,
+              deleted: true,
+            });
+            expect(yield* Ref.get(scheduledStore)).toHaveLength(0);
+
+            // OpenCode 1.15 has emitted this exact nested-object-as-JSON-string
+            // shape. Decode it at the MCP boundary rather than failing a task
+            // the model otherwise specified correctly.
+            const serializedScheduleCall = yield* invoke("schedule_task", {
+              prompt: "check for new pull requests",
+              schedule: '{"type":"interval","everyMs":3600000}',
+              clientRequestId: "schedule-opencode-compat-1",
+            });
+            expect(serializedScheduleCall.isError).toBe(false);
+            expect(serializedScheduleCall.structuredContent).toMatchObject({
+              schedule: { type: "interval", everyMs: 3_600_000 },
+              boundThreadId: parentThreadId,
+            });
+            const serializedScheduledTaskId = (
+              serializedScheduleCall.structuredContent as { scheduledTaskId: string }
+            ).scheduledTaskId;
+            yield* invoke("delete_scheduled_task", {
+              scheduledTaskId: serializedScheduledTaskId,
+            });
+            expect(yield* Ref.get(scheduledStore)).toHaveLength(0);
+
+            const delegatedCall = yield* invoke("delegate_task", {
+              task: delegatedPrompt,
+              target: {
+                providerInstanceId: claudeInstanceId,
+                model: claudeModel,
+              },
+              mode: "wait",
+              timeoutMs: 10_000,
+              clientRequestId: "delegate-claude-1",
+            });
+            expect(delegatedCall.isError).toBe(false);
+            const delegated = yield* decodeDelegateTaskResult(delegatedCall.structuredContent).pipe(
+              Effect.orDie,
+            );
+            expect(delegated.status).toBe("completed");
+            expect(delegated.summary).toBe(delegatedResult);
+            expect(delegated.providerInstanceId).toBe(claudeInstanceId);
+
+            const completedParent = yield* waitForProjection(
+              orchestrator,
+              parentThreadId,
+              (projection) =>
+                projection.subagents.some(
+                  (task) =>
+                    task.id === delegated.taskId &&
+                    task.status === "completed" &&
+                    task.result === delegatedResult,
+                ) &&
+                projection.contextTransfers.some(
+                  (transfer) =>
+                    transfer.type === "subagent_result" &&
+                    transfer.sourceThreadId === delegated.childThreadId,
+                ),
+            );
+            const completedTask = completedParent.subagents.find(
+              (task) => task.id === delegated.taskId,
+            );
+            expect(completedTask).toMatchObject({
+              origin: "app_owned",
+              createdBy: "agent",
+              childThreadId: delegated.childThreadId,
+              status: "completed",
+              result: delegatedResult,
+            });
+            const child = yield* orchestrator.getThreadProjection(delegated.childThreadId);
+            expect(child.thread.lineage).toEqual({
+              parentThreadId,
+              relationshipToParent: "subagent",
+              rootThreadId: parentThreadId,
+            });
+            expect(child.thread).toMatchObject({
+              createdBy: "agent",
+              creationSource: "mcp",
+            });
+            expect(child.thread.modelSelection).toEqual(claudeSelection);
+            expect(
+              child.messages
+                .filter((message) => message.role === "user")
+                .map((message) => message.text),
+            ).toEqual([delegatedPrompt]);
+            expect(
+              child.contextTransfers.some(
+                (transfer) =>
+                  transfer.type === "subagent_spawn" && transfer.sourceThreadId === parentThreadId,
+              ),
+            ).toBe(true);
+            const capturedAfterDelegate = yield* Ref.get(capturedTurns);
+            expect(
+              capturedAfterDelegate.filter((turn) => turn.threadId === delegated.childThreadId),
+            ).toEqual([
+              {
+                instanceId: claudeInstanceId,
+                threadId: delegated.childThreadId,
+                text: delegatedPrompt,
+              },
+            ]);
+            expect(
+              capturedAfterDelegate.some(
+                (turn) =>
+                  turn.threadId === delegated.childThreadId && turn.text.includes(parentPrompt),
+              ),
+            ).toBe(false);
+
+            const delegatedStatusCall = yield* invoke("task_status", {
+              taskId: delegated.taskId,
+            });
+            const delegatedStatus = yield* decodeDelegateTaskResult(
+              delegatedStatusCall.structuredContent,
+            ).pipe(Effect.orDie);
+            expect(delegatedStatus.status).toBe("completed");
+            expect(delegatedStatus.resultContextTransferId).not.toBeNull();
+
+            const childFollowupCall = yield* invoke("t3_thread_send", {
+              threadId: delegated.childThreadId,
+              message: "Confirm the delegated API boundary remains inspected.",
+              clientRequestId: "delegated-child-followup-1",
+            });
+            const childFollowup = yield* decodeThreadSendResult(
+              childFollowupCall.structuredContent,
+            ).pipe(Effect.orDie);
+            const childFollowupWaitCall = yield* invoke("t3_thread_wait", {
+              threadId: delegated.childThreadId,
+              runId: childFollowup.runId,
+              timeoutMs: 10_000,
+            });
+            const childFollowupWait = yield* decodeThreadWaitResult(
+              childFollowupWaitCall.structuredContent,
+            ).pipe(Effect.orDie);
+            expect(childFollowupWait).toMatchObject({
+              runId: childFollowup.runId,
+              status: "completed",
+              timedOut: false,
+            });
+            const delegatedStatusAfterFollowupCall = yield* invoke("task_status", {
+              taskId: delegated.taskId,
+            });
+            const delegatedStatusAfterFollowup = yield* decodeDelegateTaskResult(
+              delegatedStatusAfterFollowupCall.structuredContent,
+            ).pipe(Effect.orDie);
+            expect(delegatedStatusAfterFollowup).toMatchObject({
+              childRunId: delegated.childRunId,
+              status: "completed",
+              summary: delegatedResult,
+            });
+
+            const activeChildFollowupCall = yield* invoke("t3_thread_send", {
+              threadId: delegated.childThreadId,
+              message: cancellationPrompt,
+              clientRequestId: "delegated-child-active-followup-1",
+            });
+            const activeChildFollowup = yield* decodeThreadSendResult(
+              activeChildFollowupCall.structuredContent,
+            ).pipe(Effect.orDie);
+            yield* waitForProjection(orchestrator, delegated.childThreadId, (projection) =>
+              projection.runs.some(
+                (run) => run.id === activeChildFollowup.runId && run.status === "running",
+              ),
+            );
+            const completedTaskCancelCall = yield* invoke("task_cancel", {
+              taskId: delegated.taskId,
+              reason: "Must not interrupt a later unrelated child run.",
+              clientRequestId: "cancel-completed-delegated-task-1",
+            });
+            const completedTaskCancel = yield* decodeTaskCancelResult(
+              completedTaskCancelCall.structuredContent,
+            ).pipe(Effect.orDie);
+            expect(completedTaskCancel).toEqual({
+              taskId: delegated.taskId,
+              status: "completed",
+            });
+            expect(
+              (yield* orchestrator.getThreadProjection(delegated.childThreadId)).runs.find(
+                (run) => run.id === activeChildFollowup.runId,
+              )?.status,
+            ).toBe("running");
+            const activeChildCleanupCall = yield* invoke("t3_thread_interrupt", {
+              threadId: delegated.childThreadId,
+              runId: activeChildFollowup.runId,
+              reason: "Clean up the active follow-up after verifying task cancellation isolation.",
+              clientRequestId: "interrupt-delegated-child-followup-1",
+            });
+            const activeChildCleanup = yield* decodeThreadInterruptResult(
+              activeChildCleanupCall.structuredContent,
+            ).pipe(Effect.orDie);
+            expect(activeChildCleanup).toMatchObject({
+              runId: activeChildFollowup.runId,
+              status: "interrupt_requested",
+            });
+            yield* waitForProjection(orchestrator, delegated.childThreadId, (projection) =>
+              projection.runs.some(
+                (run) => run.id === activeChildFollowup.runId && run.status === "interrupted",
+              ),
+            );
+
+            // A wait-mode child (completionWake settled_only) that completes
+            // while the parent run is live does not offer a wake: the
+            // blocking delegate_task call above already returned the result.
+            yield* expectOffersToStay(0);
+
+            const repeatedDelegatedCall = yield* invoke("delegate_task", {
+              task: delegatedPrompt,
+              target: {
+                providerInstanceId: claudeInstanceId,
+                model: claudeModel,
+              },
+              mode: "async",
+              clientRequestId: "delegate-claude-1",
+            });
+            const repeatedDelegated = yield* decodeDelegateTaskResult(
+              repeatedDelegatedCall.structuredContent,
+            ).pipe(Effect.orDie);
+            expect(repeatedDelegated.taskId).toBe(delegated.taskId);
+            expect(
+              (yield* orchestrator.getThreadProjection(parentThreadId)).subagents.filter(
+                (task) => task.id === delegated.taskId,
+              ),
+            ).toHaveLength(1);
+
+            // Options outside the model's advertised descriptors are rejected
+            // before any child thread is created.
+            const rejectedOptionsCall = yield* invoke("delegate_task", {
+              task: cancellationPrompt,
+              target: {
+                providerInstanceId: codexInstanceId,
+                model: codexModel,
+                options: { reasoning: "extreme" },
+              },
+              mode: "async",
+              clientRequestId: "delegate-rejected-options-1",
+            });
+            expect(rejectedOptionsCall.structuredContent).toMatchObject({
+              _tag: "OrchestratorMcpFailure",
+              code: "invalid_request",
+              message: expect.stringContaining("rejected options"),
+            });
+
+            // Duplicate option ids fail fast: downstream consumers disagree on
+            // whether the first or last value of a duplicated id wins.
+            const duplicateOptionsCall = yield* invoke("delegate_task", {
+              task: cancellationPrompt,
+              target: {
+                providerInstanceId: codexInstanceId,
+                model: codexModel,
+                options: [
+                  { id: "reasoning", value: "low" },
+                  { id: "reasoning", value: "high" },
+                ],
+              },
+              mode: "async",
+              clientRequestId: "delegate-duplicate-options-1",
+            });
+            expect(duplicateOptionsCall.structuredContent).toMatchObject({
+              _tag: "OrchestratorMcpFailure",
+              code: "invalid_request",
+              message: expect.stringContaining("more than once"),
+            });
+
+            const cancellableCall = yield* invoke("delegate_task", {
+              task: cancellationPrompt,
+              target: {
+                providerInstanceId: codexInstanceId,
+                model: codexModel,
+                // Shorthand record form; decodes to the canonical array.
+                options: { reasoning: "low" },
+              },
+              mode: "async",
+              clientRequestId: "delegate-cancel-1",
+            });
+            const cancellable = yield* decodeDelegateTaskResult(
+              cancellableCall.structuredContent,
+            ).pipe(Effect.orDie);
+            expect(cancellable.status).toBe("running");
+            yield* waitForProjection(orchestrator, cancellable.childThreadId, (projection) =>
+              projection.providerTurns.some((turn) => turn.status === "running"),
+            );
+            // The requested model options reach the child thread's selection.
+            const optionedChild = yield* orchestrator.getThreadProjection(
+              cancellable.childThreadId,
+            );
+            expect(optionedChild.thread.modelSelection).toEqual({
+              instanceId: codexInstanceId,
+              model: codexModel,
+              options: [{ id: "reasoning", value: "low" }],
+            });
+            const cancelCall = yield* invoke("task_cancel", {
+              taskId: cancellable.taskId,
+              reason: "Parent no longer needs this work.",
+              clientRequestId: "cancel-1",
+            });
+            const cancelResult = yield* decodeTaskCancelResult(cancelCall.structuredContent).pipe(
+              Effect.orDie,
+            );
+            expect(cancelResult.status).toBe("cancel_requested");
+            yield* waitForProjection(orchestrator, cancellable.childThreadId, (projection) =>
+              projection.runs.some((run) => run.status === "interrupted"),
+            );
+            const cancelledStatusCall = yield* invoke("task_status", {
+              taskId: cancellable.taskId,
+            });
+            const cancelledStatus = yield* decodeDelegateTaskResult(
+              cancelledStatusCall.structuredContent,
+            ).pipe(Effect.orDie);
+            expect(cancelledStatus.status).toBe("interrupted");
+
+            // Explicit task_cancel disposes automatic delivery after the child
+            // interrupt succeeds. The interrupted result remains readable,
+            // but it cannot create a parent continuation.
+            expect(
+              (yield* orchestrator.getThreadProjection(parentThreadId)).subagents.find(
+                (task) => task.id === cancellable.taskId,
+              )?.completionDelivery,
+            ).toMatchObject({ state: "disposed" });
+            yield* expectOffersToStay(0);
+
+            const createInput = {
+              clientRequestId: "create-thread-batch-1",
+              threads: [
+                {
+                  title: "Inherited empty thread",
+                },
+                {
+                  title: "Claude ordinary thread",
+                  prompt: createdThreadPrompt,
+                  target: {
+                    driverKind: "claudeAgent",
+                  },
+                },
+              ],
+            };
+            const createCall = yield* invoke("create_threads", createInput);
+            expect(createCall.isError).toBe(false);
+            const created = yield* decodeCreateThreadsResult(createCall.structuredContent).pipe(
+              Effect.orDie,
+            );
+            expect(created.threads).toHaveLength(2);
+            const emptyThread = created.threads[0]!;
+            const promptedThread = created.threads[1]!;
+            expect(emptyThread).toMatchObject({
+              status: "idle",
+              createdBy: "agent",
+              creationSource: "mcp",
+              providerInstanceId: codexInstanceId,
+              model: codexModel,
+            });
+            expect(promptedThread).toMatchObject({
+              createdBy: "agent",
+              creationSource: "mcp",
+              providerInstanceId: claudeInstanceId,
+              model: claudeModel,
+            });
+            const emptyProjection = yield* orchestrator.getThreadProjection(emptyThread.threadId);
+            expect(emptyProjection.thread.lineage).toEqual({
+              parentThreadId: null,
+              relationshipToParent: null,
+              rootThreadId: emptyThread.threadId,
+            });
+            expect(emptyProjection.thread).toMatchObject({
+              createdBy: "agent",
+              creationSource: "mcp",
+            });
+            expect(emptyProjection.thread.forkedFrom).toBeNull();
+            expect(emptyProjection.runs).toEqual([]);
+            const promptedProjection = yield* waitForProjection(
+              orchestrator,
+              promptedThread.threadId,
+              (projection) => projection.runs.some((run) => run.status === "completed"),
+            );
+            expect(promptedProjection.thread.lineage.parentThreadId).toBeNull();
+            expect(
+              promptedProjection.messages
+                .filter((message) => message.role === "user")
+                .map((message) => message.text),
+            ).toEqual([createdThreadPrompt]);
+            const createdThreadItems = (yield* orchestrator.getThreadProjection(
+              parentThreadId,
+            )).visibleTurnItems
+              .map((row) => row.item)
+              .filter((item) => item.type === "thread_created");
+            expect(
+              createdThreadItems.map((item) => ({
+                targetThreadId: item.targetThreadId,
+                targetRunId: item.targetRunId,
+                title: item.title,
+                providerInstanceId: item.targetProviderInstanceId,
+                model: item.targetModel,
+              })),
+            ).toEqual([
+              {
+                targetThreadId: emptyThread.threadId,
+                targetRunId: null,
+                title: emptyThread.title,
+                providerInstanceId: codexInstanceId,
+                model: codexModel,
+              },
+              {
+                targetThreadId: promptedThread.threadId,
+                targetRunId: promptedThread.runId,
+                title: promptedThread.title,
+                providerInstanceId: claudeInstanceId,
+                model: claudeModel,
+              },
+            ]);
+
+            const repeatedCreateCall = yield* invoke("create_threads", createInput);
+            const repeatedCreated = yield* decodeCreateThreadsResult(
+              repeatedCreateCall.structuredContent,
+            ).pipe(Effect.orDie);
+            expect(repeatedCreated.threads.map((thread) => thread.threadId)).toEqual(
+              created.threads.map((thread) => thread.threadId),
+            );
+            expect(
+              (yield* orchestrator.getThreadProjection(parentThreadId)).visibleTurnItems.filter(
+                (row) => {
+                  if (row.item.type !== "thread_created") return false;
+                  const targetThreadId = row.item.targetThreadId;
+                  return created.threads.some((thread) => thread.threadId === targetThreadId);
+                },
+              ),
+            ).toHaveLength(2);
+
+            const promptedReadCall = yield* invoke("t3_thread_read", {
+              threadId: promptedThread.threadId,
+              limit: 1,
+            });
+            const promptedRead = yield* decodeThreadReadResult(
+              promptedReadCall.structuredContent,
+            ).pipe(Effect.orDie);
+            expect(promptedRead.thread.status).toBe("completed");
+            expect(promptedRead.thread).toMatchObject({
+              createdBy: "agent",
+              creationSource: "mcp",
+            });
+            expect(promptedRead.items.map((item) => item.type)).toEqual(["user_message"]);
+            expect(promptedRead.items[0]).toMatchObject({
+              createdBy: "agent",
+              creationSource: "mcp",
+            });
+            expect(promptedRead.hasMore).toBe(true);
+            const promptedReadNextCall = yield* invoke("t3_thread_read", {
+              threadId: promptedThread.threadId,
+              afterPosition: promptedRead.nextPosition,
+              limit: 1,
+            });
+            const promptedReadNext = yield* decodeThreadReadResult(
+              promptedReadNextCall.structuredContent,
+            ).pipe(Effect.orDie);
+            expect(promptedReadNext.items.map((item) => item.type)).toEqual(["assistant_message"]);
+            expect(promptedReadNext.items[0]?.text).toBe(
+              `Claude completed: ${createdThreadPrompt}`,
+            );
+
+            const forkedThreadId = ThreadId.make("thread:mcp-orchestrator-inherited-read");
+            yield* orchestrator.dispatch({
+              type: "thread.fork",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: CommandId.make("command:mcp-orchestrator-inherited-read"),
+              sourceThreadId: promptedThread.threadId,
+              targetThreadId: forkedThreadId,
+              sourcePoint: { type: "latest_stable" },
+              title: "Inherited read thread",
+            });
+            const forkedProjection = yield* orchestrator.getThreadProjection(forkedThreadId);
+            expect(forkedProjection.messages).toEqual([]);
+            expect(
+              forkedProjection.visibleTurnItems.some(
+                (row) =>
+                  row.sourceThreadId === promptedThread.threadId &&
+                  row.item.type === "user_message",
+              ),
+            ).toBe(true);
+
+            const forkedReadCall = yield* invoke("t3_thread_read", {
+              threadId: forkedThreadId,
+            });
+            const forkedRead = yield* decodeThreadReadResult(forkedReadCall.structuredContent).pipe(
+              Effect.orDie,
+            );
+            expect(
+              forkedRead.items.find((item) => item.text === createdThreadPrompt),
+            ).toMatchObject({
+              sourceThreadId: promptedThread.threadId,
+              createdBy: "agent",
+              creationSource: "mcp",
+            });
+
+            const ordinaryLoopPrompt = "Run an ordinary thread loop iteration.";
+            const sendCall = yield* invoke("t3_thread_send", {
+              threadId: emptyThread.threadId,
+              message: ordinaryLoopPrompt,
+              clientRequestId: "ordinary-loop-send-1",
+            });
+            const sent = yield* decodeThreadSendResult(sendCall.structuredContent).pipe(
+              Effect.orDie,
+            );
+            expect(sent.delivery).toBe("started");
+            const waitCall = yield* invoke("t3_thread_wait", {
+              threadId: emptyThread.threadId,
+              runId: sent.runId,
+              timeoutMs: 10_000,
+            });
+            const waited = yield* decodeThreadWaitResult(waitCall.structuredContent).pipe(
+              Effect.orDie,
+            );
+            expect(waited).toMatchObject({
+              runId: sent.runId,
+              status: "completed",
+              timedOut: false,
+            });
+            const repeatedSendCall = yield* invoke("t3_thread_send", {
+              threadId: emptyThread.threadId,
+              message: ordinaryLoopPrompt,
+              clientRequestId: "ordinary-loop-send-1",
+            });
+            const repeatedSend = yield* decodeThreadSendResult(
+              repeatedSendCall.structuredContent,
+            ).pipe(Effect.orDie);
+            expect(repeatedSend.runId).toBe(sent.runId);
+            expect(
+              (yield* orchestrator.getThreadProjection(emptyThread.threadId)).runs,
+            ).toHaveLength(1);
+
+            const activeThreadCall = yield* invoke("t3_thread_start", {
+              prompt: cancellationPrompt,
+              title: "Managed active thread",
+              clientRequestId: "managed-active-thread-1",
+            });
+            const activeThread = yield* decodeCreatedThread(
+              activeThreadCall.structuredContent,
+            ).pipe(Effect.orDie);
+            const activeThreadItem = (yield* orchestrator.getThreadProjection(
+              parentThreadId,
+            )).visibleTurnItems
+              .map((row) => row.item)
+              .find(
+                (item) =>
+                  item.type === "thread_created" && item.targetThreadId === activeThread.threadId,
+              );
+            expect(activeThreadItem).toMatchObject({
+              type: "thread_created",
+              title: "Managed active thread",
+              targetThreadId: activeThread.threadId,
+              targetRunId: activeThread.runId,
+              targetProviderInstanceId: codexInstanceId,
+              targetModel: codexModel,
+            });
+            const activeProjection = yield* waitForProjection(
+              orchestrator,
+              activeThread.threadId,
+              (projection) =>
+                projection.runs.some((run) => run.status === "running") &&
+                projection.providerTurns.some((turn) => turn.status === "running"),
+            );
+            const activeRun = activeProjection.runs[0]!;
+            const activeTimeoutCall = yield* invoke("t3_thread_wait", {
+              threadId: activeThread.threadId,
+              runId: activeRun.id,
+              timeoutMs: 1,
+            });
+            const activeTimeout = yield* decodeThreadWaitResult(
+              activeTimeoutCall.structuredContent,
+            ).pipe(Effect.orDie);
+            expect(activeTimeout).toMatchObject({
+              runId: activeRun.id,
+              status: "running",
+              timedOut: true,
+            });
+            const steerCall = yield* invoke("t3_thread_send", {
+              threadId: activeThread.threadId,
+              message: "Include the latest parent guidance before finishing.",
+              mode: "steer",
+              clientRequestId: "managed-active-steer-1",
+            });
+            const steered = yield* decodeThreadSendResult(steerCall.structuredContent).pipe(
+              Effect.orDie,
+            );
+            expect(steered).toMatchObject({
+              runId: activeRun.id,
+              delivery: "steered",
+            });
+            const interruptCall = yield* invoke("t3_thread_interrupt", {
+              threadId: activeThread.threadId,
+              reason: "The orchestration loop has enough evidence.",
+              clientRequestId: "managed-active-interrupt-1",
+            });
+            const interrupted = yield* decodeThreadInterruptResult(
+              interruptCall.structuredContent,
+            ).pipe(Effect.orDie);
+            expect(interrupted).toMatchObject({
+              runId: activeRun.id,
+              status: "interrupt_requested",
+            });
+            const interruptedWaitCall = yield* invoke("t3_thread_wait", {
+              threadId: activeThread.threadId,
+              runId: activeRun.id,
+              timeoutMs: 10_000,
+            });
+            const interruptedWait = yield* decodeThreadWaitResult(
+              interruptedWaitCall.structuredContent,
+            ).pipe(Effect.orDie);
+            expect(interruptedWait.status).toBe("interrupted");
+            const repeatedInterruptCall = yield* invoke("t3_thread_interrupt", {
+              threadId: activeThread.threadId,
+              runId: activeRun.id,
+            });
+            const repeatedInterrupt = yield* decodeThreadInterruptResult(
+              repeatedInterruptCall.structuredContent,
+            ).pipe(Effect.orDie);
+            expect(repeatedInterrupt.status).toBe("interrupted");
+
+            const foreignThreadId = ThreadId.make("thread:mcp-foreign-project");
+            yield* orchestrator.dispatch({
+              type: "thread.create",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: CommandId.make("command:mcp-foreign-project:create"),
+              threadId: foreignThreadId,
+              projectId: ProjectId.make("project:mcp-foreign"),
+              title: "Foreign project thread",
+              modelSelection: codexSelection,
+              runtimeMode: "full-access",
+              interactionMode: "default",
+              branch: null,
+              worktreePath: cwd,
+            });
+            const foreignReadCall = yield* invoke("t3_thread_read", {
+              threadId: foreignThreadId,
+            });
+            expect(foreignReadCall.structuredContent).toMatchObject({
+              _tag: "OrchestratorMcpFailure",
+              code: "thread_not_found",
+            });
+            const listCall = yield* invoke("t3_thread_list", {
+              includeSubagents: false,
+              limit: 100,
+            });
+            const listed = yield* decodeThreadListResult(listCall.structuredContent).pipe(
+              Effect.orDie,
+            );
+            expect(listed.projectId).toBe(projectId);
+            expect(listed.threads.map((thread) => thread.threadId)).toEqual(
+              expect.arrayContaining([
+                parentThreadId,
+                emptyThread.threadId,
+                promptedThread.threadId,
+                activeThread.threadId,
+              ]),
+            );
+            expect(
+              listed.threads.find((thread) => thread.threadId === emptyThread.threadId),
+            ).toMatchObject({
+              createdBy: "agent",
+              creationSource: "mcp",
+            });
+            expect(listed.threads.some((thread) => thread.threadId === foreignThreadId)).toBe(
+              false,
+            );
+            expect(
+              listed.threads.some((thread) => thread.relationshipToParent === "subagent"),
+            ).toBe(false);
+
+            // A wait-mode delegation whose blocking wait times out no longer
+            // owns delivery, so delegate_task upgrades the task to "always".
+            // Its terminal then wakes the parent even mid-turn.
+            const upgradedCall = yield* invoke("delegate_task", {
+              task: cancellationPrompt,
+              target: {
+                providerInstanceId: codexInstanceId,
+                model: codexModel,
+              },
+              mode: "wait",
+              timeoutMs: 1,
+              clientRequestId: "delegate-wait-upgrade-1",
+            });
+            const upgradedDelegated = yield* decodeDelegateTaskResult(
+              upgradedCall.structuredContent,
+            ).pipe(Effect.orDie);
+            expect(upgradedDelegated.status).toBe("running");
+            yield* waitForProjection(orchestrator, upgradedDelegated.childThreadId, (projection) =>
+              projection.providerTurns.some((turn) => turn.status === "running"),
+            );
+            expect(
+              (yield* orchestrator.getThreadProjection(parentThreadId)).subagents.find(
+                (task) => task.id === upgradedDelegated.taskId,
+              )?.completionWake,
+            ).toBe("always");
+            const upgradeCancelCall = yield* invoke("task_cancel", {
+              taskId: upgradedDelegated.taskId,
+              reason: "Terminalize while the parent run is live.",
+              clientRequestId: "cancel-wait-upgrade-1",
+            });
+            expect(upgradeCancelCall.isError).toBe(false);
+            yield* waitForProjection(orchestrator, parentThreadId, (projection) =>
+              projection.subagents.some(
+                (task) => task.id === upgradedDelegated.taskId && task.status === "interrupted",
+              ),
+            );
+            expect(
+              (yield* orchestrator.getThreadProjection(parentThreadId)).subagents.find(
+                (task) => task.id === upgradedDelegated.taskId,
+              )?.completionDelivery,
+            ).toMatchObject({ state: "disposed" });
+            yield* expectOffersToStay(0);
+
+            // The MCP tool cannot force the reverse interleaving (child
+            // terminal before the upgrade lands), so dispatch the command
+            // directly. The first wait-mode delegation completed while the
+            // parent run was live, so finalize skipped its offer under
+            // settled_only; the upgrade must accept, persist the policy, and
+            // deliver the wake finalize declined.
+            const terminalUpgrade = yield* orchestrator.dispatch({
+              type: "delegated_task.wake-policy",
+              commandId: CommandId.make("command:mcp-parent:wake-policy-terminal"),
+              parentThreadId,
+              taskId: delegated.taskId,
+              completionWake: "always",
+            });
+            expect(
+              terminalUpgrade.storedEvents.some(
+                (stored) =>
+                  stored.event.type === "subagent.updated" &&
+                  stored.event.payload.id === delegated.taskId &&
+                  stored.event.payload.completionWake === "always",
+              ),
+            ).toBe(true);
+            expect(
+              (yield* orchestrator.getThreadProjection(parentThreadId)).subagents.find(
+                (task) => task.id === delegated.taskId,
+              )?.completionWake,
+            ).toBe("always");
+            // task_status above acknowledged this terminal result, so making
+            // its policy eager later cannot re-arm a stale parent wake.
+            yield* expectOffersToStay(0);
+
+            // Legacy records omit completionWake and stay settled_only. The
+            // MCP service always sets the field now, so dispatch the request
+            // directly to cover the legacy shape.
+            const legacyDispatch = yield* orchestrator.dispatch({
+              type: "delegated_task.request",
+              createdBy: "agent",
+              creationSource: "mcp",
+              commandId: CommandId.make("command:mcp-parent:delegate-legacy"),
+              parentThreadId,
+              parentRunId: parentRun.id,
+              parentNodeId: parentRootNodeId,
+              task: cancellationPrompt,
+              modelSelection: codexSelection,
+              runtimeMode: "full-access",
+              interactionMode: "default",
+            });
+            const legacyTaskEvent = legacyDispatch.storedEvents.find(
+              (stored) =>
+                stored.event.type === "subagent.updated" &&
+                stored.event.payload.origin === "app_owned",
+            );
+            if (legacyTaskEvent?.event.type !== "subagent.updated") {
+              return yield* Effect.die(new Error("Legacy delegated task projection missing."));
+            }
+            const legacyTask = legacyTaskEvent.event.payload;
+            expect(legacyTask.completionWake).toBeUndefined();
+            if (legacyTask.childThreadId === null) {
+              return yield* Effect.die(new Error("Legacy delegated task child thread missing."));
+            }
+            const legacyChildThreadId = legacyTask.childThreadId;
+            yield* waitForProjection(orchestrator, legacyChildThreadId, (projection) =>
+              projection.providerTurns.some((turn) => turn.status === "running"),
+            );
+            // Nothing terminalized here, so the offer count must hold.
+            yield* expectOffersToStay(0);
+
+            // Stop cancels a queued server-owned delivery for this cohort and
+            // records a barrier before any still-running child reaches a
+            // terminal state.
+            const stopQueuedDispatch = yield* orchestrator.dispatch({
+              type: "delegated_task.request",
+              createdBy: "agent",
+              creationSource: "mcp",
+              commandId: CommandId.make("command:mcp-parent:stop-queued-delivery"),
+              parentThreadId,
+              parentRunId: parentRun.id,
+              parentNodeId: parentRootNodeId,
+              task: "Complete the stop barrier delivery task.",
+              modelSelection: claudeSelection,
+              runtimeMode: "full-access",
+              interactionMode: "default",
+              completionWake: "always",
+            });
+            const stopQueuedTaskEvent = stopQueuedDispatch.storedEvents.find(
+              (stored) =>
+                stored.event.type === "subagent.updated" &&
+                stored.event.payload.origin === "app_owned",
+            );
+            if (stopQueuedTaskEvent?.event.type !== "subagent.updated") {
+              return yield* Effect.die(
+                new Error("Stop barrier delegated task projection missing."),
+              );
+            }
+            const stopQueuedTaskId = stopQueuedTaskEvent.event.payload.id;
+            const stopQueuedProjection = yield* waitForProjection(
+              orchestrator,
+              parentThreadId,
+              (projection) =>
+                projection.subagents.find((task) => task.id === stopQueuedTaskId)?.status ===
+                  "completed" &&
+                projection.runs.find((run) => run.id === parentRun.id)?.delegatedCompletion
+                  ?.delivery !== null &&
+                projection.runs.find((run) => run.id === parentRun.id)?.delegatedCompletion
+                  ?.delivery !== undefined,
+            );
+            const stopQueuedDelivery = stopQueuedProjection.runs.find(
+              (run) => run.id === parentRun.id,
+            )?.delegatedCompletion?.delivery;
+            if (stopQueuedDelivery === undefined || stopQueuedDelivery === null) {
+              return yield* Effect.die(new Error("Stop barrier delivery reservation missing."));
+            }
+            yield* orchestrator.dispatch({
+              type: "message.dispatch",
+              createdBy: "agent",
+              creationSource: "server",
+              commandId: CommandId.make("command:mcp-parent:dispatch-stop-queued-delivery"),
+              threadId: parentThreadId,
+              messageId: stopQueuedDelivery.messageId,
+              text: "Delegated task reached a terminal state.",
+              attachments: [],
+              modelSelection: codexSelection,
+              dispatchMode: { type: "queue_after_active" },
+              delegatedCompletion: {
+                parentRunId: parentRun.id,
+                generation: stopQueuedDelivery.generation,
+                taskIds: stopQueuedDelivery.taskIds,
+              },
+            });
+            const queuedStopDelivery = yield* waitForProjection(
+              orchestrator,
+              parentThreadId,
+              (projection) =>
+                projection.runs.some(
+                  (run) =>
+                    run.userMessageId === stopQueuedDelivery.messageId && run.status === "queued",
+                ),
+            );
+            const queuedStopDeliveryRun = queuedStopDelivery.runs.find(
+              (run) => run.userMessageId === stopQueuedDelivery.messageId,
+            );
+            if (queuedStopDeliveryRun === undefined) {
+              return yield* Effect.die(new Error("Queued stop barrier delivery missing."));
+            }
+            yield* Ref.set(continuationOffers, []);
+
+            const parentStop = yield* orchestrator.dispatch({
+              type: "run.interrupt",
+              commandId: CommandId.make("command:mcp-parent:interrupt-wake"),
+              threadId: parentThreadId,
+              runId: parentRun.id,
+              reason: "Settle the parent before the legacy child terminalizes.",
+            });
+            yield* waitForProjection(orchestrator, parentThreadId, (projection) =>
+              projection.runs.every(
+                (run) =>
+                  run.status !== "preparing" &&
+                  run.status !== "starting" &&
+                  run.status !== "running",
+              ),
+            );
+            const stoppedParent = yield* orchestrator.getThreadProjection(parentThreadId);
+            expect(stoppedParent.runs.some((run) => run.id === parentRun.id)).toBe(true);
+            expect(
+              parentStop.storedEvents.some(
+                (stored) =>
+                  stored.event.type === "run.updated" &&
+                  stored.event.payload.id === parentRun.id &&
+                  stored.event.payload.delegatedCompletion?.disposition === "stopped",
+              ),
+            ).toBe(true);
+            expect(
+              stoppedParent.runs.find((run) => run.id === parentRun.id)?.delegatedCompletion,
+            ).toMatchObject({ disposition: "stopped", delivery: null });
+            expect(
+              stoppedParent.runs.find((run) => run.id === queuedStopDeliveryRun.id)?.status,
+            ).toBe("cancelled");
+            expect(
+              stoppedParent.subagents.find((task) => task.id === legacyTask.id)?.completionDelivery,
+            ).toMatchObject({ state: "disposed" });
+            const legacyChildRun = (yield* orchestrator.getThreadProjection(
+              legacyChildThreadId,
+            )).runs.find((run) => run.status === "running");
+            if (legacyChildRun === undefined) {
+              return yield* Effect.die(
+                new Error("Still-running child was missing after parent Stop."),
+              );
+            }
+            yield* orchestrator.dispatch({
+              type: "run.interrupt",
+              commandId: CommandId.make("command:mcp-parent:interrupt-legacy-after-parent-stop"),
+              threadId: legacyChildThreadId,
+              runId: legacyChildRun.id,
+              reason: "Terminalize after the parent Stop barrier.",
+            });
+            yield* waitForProjection(orchestrator, legacyChildThreadId, (projection) =>
+              projection.runs.some((run) => run.status === "interrupted"),
+            );
+            expect(
+              (yield* orchestrator.getThreadProjection(parentThreadId)).subagents.find(
+                (task) => task.id === legacyTask.id,
+              )?.completionDelivery,
+            ).toMatchObject({ state: "disposed" });
+            yield* expectOffersToStay(0);
+
+            // Same command against a terminal task whose finalize already
+            // offered (the parent was settled then, and still is): the policy
+            // must persist without a second offer, or the parent wakes twice.
+            const settledUpgrade = yield* orchestrator.dispatch({
+              type: "delegated_task.wake-policy",
+              commandId: CommandId.make("command:mcp-parent:wake-policy-settled"),
+              parentThreadId,
+              taskId: legacyTask.id,
+              completionWake: "always",
+            });
+            expect(
+              settledUpgrade.storedEvents.some(
+                (stored) =>
+                  stored.event.type === "subagent.updated" &&
+                  stored.event.payload.id === legacyTask.id &&
+                  stored.event.payload.completionWake === "always",
+              ),
+            ).toBe(true);
+            expect(
+              (yield* orchestrator.getThreadProjection(parentThreadId)).subagents.find(
+                (task) => task.id === legacyTask.id,
+              )?.completionWake,
+            ).toBe("always");
+            yield* expectOffersToStay(0);
+
+            // A child that terminalizes after the coalesced delivery started
+            // is held for one successor. It must not fan out into a second
+            // concurrent delivery for the same parent run.
+            const lateParentThreadId = ThreadId.make("thread:mcp-late-completion-parent");
+            const lateParentGate = yield* Deferred.make<void>();
+            const lateDeliveryGate = yield* Deferred.make<void>();
+            parentTerminalGates.set(lateParentThreadId, lateParentGate);
+            deliveryTerminalGates.set(lateParentThreadId, lateDeliveryGate);
+            yield* Ref.set(continuationOffers, []);
+            yield* orchestrator.dispatch({
+              type: "thread.create",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: CommandId.make("command:mcp-late-parent:create"),
+              threadId: lateParentThreadId,
+              projectId,
+              title: "Late completion parent",
+              modelSelection: codexSelection,
+              runtimeMode: "full-access",
+              interactionMode: "default",
+              branch: null,
+              worktreePath: cwd,
+            });
+            yield* orchestrator.dispatch({
+              type: "message.dispatch",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: CommandId.make("command:mcp-late-parent:start"),
+              threadId: lateParentThreadId,
+              messageId: MessageId.make("message:mcp-late-parent:start"),
+              text: "Hold this parent until its completion delivery is queued.",
+              attachments: [],
+              modelSelection: codexSelection,
+              dispatchMode: { type: "start_immediately" },
+            });
+            const lateParentProjection = yield* waitForProjection(
+              orchestrator,
+              lateParentThreadId,
+              (projection) =>
+                projection.runs.some((run) => run.status === "running") &&
+                projection.providerTurns.some((turn) => turn.status === "running"),
+            );
+            const lateParentRun = lateParentProjection.runs.find((run) => run.status === "running");
+            if (lateParentRun?.rootNodeId === null || lateParentRun === undefined) {
+              return yield* Effect.die(new Error("Late completion parent run missing."));
+            }
+            const earlyLateDelivery = yield* orchestrator.dispatch({
+              type: "delegated_task.request",
+              createdBy: "agent",
+              creationSource: "mcp",
+              commandId: CommandId.make("command:mcp-late-parent:early-task"),
+              parentThreadId: lateParentThreadId,
+              parentRunId: lateParentRun.id,
+              parentNodeId: lateParentRun.rootNodeId,
+              task: "Complete before the first delivery starts.",
+              modelSelection: claudeSelection,
+              runtimeMode: "full-access",
+              interactionMode: "default",
+              completionWake: "always",
+            });
+            const lateChild = yield* orchestrator.dispatch({
+              type: "delegated_task.request",
+              createdBy: "agent",
+              creationSource: "mcp",
+              commandId: CommandId.make("command:mcp-late-parent:late-task"),
+              parentThreadId: lateParentThreadId,
+              parentRunId: lateParentRun.id,
+              parentNodeId: lateParentRun.rootNodeId,
+              task: cancellationPrompt,
+              modelSelection: codexSelection,
+              runtimeMode: "full-access",
+              interactionMode: "default",
+              completionWake: "always",
+            });
+            const taskFromDispatch = (result: typeof earlyLateDelivery) => {
+              const taskEvent = result.storedEvents.find(
+                (stored) =>
+                  stored.event.type === "subagent.updated" &&
+                  stored.event.payload.origin === "app_owned",
+              );
+              if (taskEvent?.event.type !== "subagent.updated") {
+                throw new Error("Late completion delegated task projection missing.");
+              }
+              return taskEvent.event.payload;
+            };
+            const earlyLateTask = taskFromDispatch(earlyLateDelivery);
+            const lateTask = taskFromDispatch(lateChild);
+            const thirdLateChild = yield* orchestrator.dispatch({
+              type: "delegated_task.request",
+              createdBy: "agent",
+              creationSource: "mcp",
+              commandId: CommandId.make("command:mcp-late-parent:third-late-task"),
+              parentThreadId: lateParentThreadId,
+              parentRunId: lateParentRun.id,
+              parentNodeId: lateParentRun.rootNodeId,
+              task: cancellationPrompt,
+              modelSelection: codexSelection,
+              runtimeMode: "full-access",
+              interactionMode: "default",
+              completionWake: "always",
+            });
+            const thirdLateTask = taskFromDispatch(thirdLateChild);
+            if (lateTask.childThreadId === null || thirdLateTask.childThreadId === null) {
+              return yield* Effect.die(new Error("Late completion child thread missing."));
+            }
+            const beforeFirstDelivery = yield* waitForProjection(
+              orchestrator,
+              lateParentThreadId,
+              (projection) =>
+                projection.subagents.find((task) => task.id === earlyLateTask.id)?.status ===
+                  "completed" &&
+                projection.subagents.find((task) => task.id === lateTask.id)?.status ===
+                  "running" &&
+                projection.runs.find((run) => run.id === lateParentRun.id)?.delegatedCompletion
+                  ?.delivery !== null &&
+                projection.runs.find((run) => run.id === lateParentRun.id)?.delegatedCompletion
+                  ?.delivery !== undefined,
+            );
+            const firstLateDelivery = beforeFirstDelivery.runs.find(
+              (run) => run.id === lateParentRun.id,
+            )?.delegatedCompletion?.delivery;
+            if (firstLateDelivery === undefined || firstLateDelivery === null) {
+              return yield* Effect.die(new Error("First late completion delivery missing."));
+            }
+            yield* orchestrator.dispatch({
+              type: "message.dispatch",
+              createdBy: "agent",
+              creationSource: "server",
+              commandId: CommandId.make("command:mcp-late-parent:dispatch-first-delivery"),
+              threadId: lateParentThreadId,
+              messageId: firstLateDelivery.messageId,
+              text: "Delegated task reached a terminal state.",
+              attachments: [],
+              modelSelection: codexSelection,
+              dispatchMode: { type: "queue_after_active" },
+              delegatedCompletion: {
+                parentRunId: lateParentRun.id,
+                generation: firstLateDelivery.generation,
+                taskIds: firstLateDelivery.taskIds,
+              },
+            });
+            yield* Deferred.succeed(lateParentGate, undefined);
+            const activeFirstDelivery = yield* waitForProjection(
+              orchestrator,
+              lateParentThreadId,
+              (projection) =>
+                projection.runs.some(
+                  (run) =>
+                    run.userMessageId === firstLateDelivery.messageId && run.status === "running",
+                ),
+            );
+            const activeFirstDeliveryRun = activeFirstDelivery.runs.find(
+              (run) => run.userMessageId === firstLateDelivery.messageId,
+            );
+            if (activeFirstDeliveryRun === undefined) {
+              return yield* Effect.die(new Error("First late completion delivery did not start."));
+            }
+            const lateChildProjection = yield* orchestrator.getThreadProjection(
+              lateTask.childThreadId,
+            );
+            const lateChildRun = lateChildProjection.runs[0];
+            if (lateChildRun === undefined) {
+              return yield* Effect.die(new Error("Late completion child run missing."));
+            }
+            yield* orchestrator.dispatch({
+              type: "run.interrupt",
+              commandId: CommandId.make("command:mcp-late-parent:interrupt-late-child"),
+              threadId: lateTask.childThreadId,
+              runId: lateChildRun.id,
+              reason: "Terminalize after the first completion delivery started.",
+            });
+            yield* waitForProjection(
+              orchestrator,
+              lateParentThreadId,
+              (projection) =>
+                projection.subagents.find((task) => task.id === lateTask.id)?.completionDelivery
+                  ?.state === "pending",
+            );
+            yield* Deferred.succeed(lateDeliveryGate, undefined);
+            const successorReserved = yield* waitForProjection(
+              orchestrator,
+              lateParentThreadId,
+              (projection) => {
+                const delivery = projection.runs.find((run) => run.id === lateParentRun.id)
+                  ?.delegatedCompletion?.delivery;
+                return (
+                  delivery !== undefined &&
+                  delivery !== null &&
+                  delivery.generation === firstLateDelivery.generation + 1 &&
+                  delivery.taskIds.length === 1 &&
+                  delivery.taskIds[0] === lateTask.id
+                );
+              },
+            );
+            const successorDelivery = successorReserved.runs.find(
+              (run) => run.id === lateParentRun.id,
+            )?.delegatedCompletion?.delivery;
+            expect(successorDelivery).toMatchObject({
+              generation: firstLateDelivery.generation + 1,
+              taskIds: [lateTask.id],
+            });
+            const lateOffers = yield* waitForContinuationOffers(2);
+            expect(lateOffers).toHaveLength(2);
+            expect(
+              successorReserved.runs.filter((run) => {
+                const message = successorReserved.messages.find(
+                  (candidate) => candidate.id === run.userMessageId,
+                );
+                return message?.delegatedCompletion?.parentRunId === lateParentRun.id;
+              }),
+            ).toHaveLength(1);
+            if (successorDelivery === undefined || successorDelivery === null) {
+              return yield* Effect.die(new Error("Late completion successor delivery missing."));
+            }
+
+            // The bounded successor can coalesce a late result only once. A
+            // third terminal after that successor has started remains
+            // inspectable, but cannot recursively create a third parent run.
+            const successorGate = yield* Deferred.make<void>();
+            deliveryTerminalGates.set(lateParentThreadId, successorGate);
+            yield* orchestrator.dispatch({
+              type: "message.dispatch",
+              createdBy: "agent",
+              creationSource: "server",
+              commandId: CommandId.make("command:mcp-late-parent:dispatch-successor-delivery"),
+              threadId: lateParentThreadId,
+              messageId: successorDelivery.messageId,
+              text: "Delegated task reached a terminal state.",
+              attachments: [],
+              modelSelection: codexSelection,
+              dispatchMode: { type: "queue_after_active" },
+              delegatedCompletion: {
+                parentRunId: lateParentRun.id,
+                generation: successorDelivery.generation,
+                taskIds: successorDelivery.taskIds,
+              },
+            });
+            const activeSuccessor = yield* waitForProjection(
+              orchestrator,
+              lateParentThreadId,
+              (projection) =>
+                projection.runs.some(
+                  (run) =>
+                    run.userMessageId === successorDelivery.messageId && run.status === "running",
+                ),
+            );
+            const activeSuccessorRun = activeSuccessor.runs.find(
+              (run) => run.userMessageId === successorDelivery.messageId,
+            );
+            if (activeSuccessorRun === undefined) {
+              return yield* Effect.die(new Error("Late completion successor did not start."));
+            }
+            const thirdLateChildProjection = yield* waitForProjection(
+              orchestrator,
+              thirdLateTask.childThreadId,
+              (projection) =>
+                projection.runs.some((run) => run.status === "running") &&
+                projection.providerTurns.some((turn) => turn.status === "running"),
+            );
+            const thirdLateChildRun = thirdLateChildProjection.runs.find(
+              (run) => run.status === "running",
+            );
+            if (thirdLateChildRun === undefined) {
+              return yield* Effect.die(new Error("Third late completion child run missing."));
+            }
+            yield* orchestrator.dispatch({
+              type: "run.interrupt",
+              commandId: CommandId.make("command:mcp-late-parent:interrupt-third-late-child"),
+              threadId: thirdLateTask.childThreadId,
+              runId: thirdLateChildRun.id,
+              reason: "Terminalize after the bounded successor started.",
+            });
+            yield* waitForProjection(
+              orchestrator,
+              lateParentThreadId,
+              (projection) =>
+                projection.subagents.find((task) => task.id === thirdLateTask.id)
+                  ?.completionDelivery?.state === "pending",
+            );
+            yield* Deferred.succeed(successorGate, undefined);
+            const exhaustedCohort = yield* waitForProjection(
+              orchestrator,
+              lateParentThreadId,
+              (projection) => {
+                const cohort = projection.runs.find(
+                  (run) => run.id === lateParentRun.id,
+                )?.delegatedCompletion;
+                return (
+                  cohort?.settledDeliveryCount === 2 &&
+                  cohort.delivery === null &&
+                  projection.runs.find((run) => run.id === activeSuccessorRun.id)?.status ===
+                    "completed" &&
+                  projection.subagents.find((task) => task.id === thirdLateTask.id)
+                    ?.completionDelivery?.state === "pending"
+                );
+              },
+            );
+            expect(
+              exhaustedCohort.runs.find((run) => run.id === lateParentRun.id)?.delegatedCompletion,
+            ).toMatchObject({ settledDeliveryCount: 2, delivery: null });
+            yield* expectOffersToStay(2);
+
+            // Queue Remove is a durable disposal action, not a local queue
+            // edit. Start a fresh parent-run cohort so removing this delivery
+            // cannot interfere with the bounded late-delivery assertions.
+            const removeParentGate = yield* Deferred.make<void>();
+            parentTerminalGates.set(lateParentThreadId, removeParentGate);
+            const removeParentMessageId = MessageId.make("message:mcp-late-parent:remove-start");
+            yield* orchestrator.dispatch({
+              type: "message.dispatch",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: CommandId.make("command:mcp-late-parent:remove-start"),
+              threadId: lateParentThreadId,
+              messageId: removeParentMessageId,
+              text: "Keep the parent active while removing automatic delivery.",
+              attachments: [],
+              modelSelection: codexSelection,
+              dispatchMode: { type: "start_immediately" },
+            });
+            const removeParentProjection = yield* waitForProjection(
+              orchestrator,
+              lateParentThreadId,
+              (projection) =>
+                projection.runs.some(
+                  (run) => run.userMessageId === removeParentMessageId && run.status === "running",
+                ),
+            );
+            const removeParentRun = removeParentProjection.runs.find(
+              (run) => run.userMessageId === removeParentMessageId,
+            );
+            if (removeParentRun?.rootNodeId === null || removeParentRun === undefined) {
+              return yield* Effect.die(new Error("Queue Remove parent run missing."));
+            }
+            const removeDelegation = yield* orchestrator.dispatch({
+              type: "delegated_task.request",
+              createdBy: "agent",
+              creationSource: "mcp",
+              commandId: CommandId.make("command:mcp-late-parent:remove-delegate"),
+              parentThreadId: lateParentThreadId,
+              parentRunId: removeParentRun.id,
+              parentNodeId: removeParentRun.rootNodeId,
+              task: "Complete before Queue Remove disposes this automatic delivery.",
+              modelSelection: claudeSelection,
+              runtimeMode: "full-access",
+              interactionMode: "default",
+              completionWake: "always",
+            });
+            const removeTaskEvent = removeDelegation.storedEvents.find(
+              (stored) =>
+                stored.event.type === "subagent.updated" &&
+                stored.event.payload.origin === "app_owned",
+            );
+            if (removeTaskEvent?.event.type !== "subagent.updated") {
+              return yield* Effect.die(
+                new Error("Queue Remove delegated task projection missing."),
+              );
+            }
+            const removeTask = removeTaskEvent.event.payload;
+            const removeReserved = yield* waitForProjection(
+              orchestrator,
+              lateParentThreadId,
+              (projection) =>
+                projection.subagents.find((task) => task.id === removeTask.id)?.status ===
+                  "completed" &&
+                projection.runs.find((run) => run.id === removeParentRun.id)?.delegatedCompletion
+                  ?.delivery !== null &&
+                projection.runs.find((run) => run.id === removeParentRun.id)?.delegatedCompletion
+                  ?.delivery !== undefined,
+            );
+            const removeDelivery = removeReserved.runs.find((run) => run.id === removeParentRun.id)
+              ?.delegatedCompletion?.delivery;
+            if (removeDelivery === undefined || removeDelivery === null) {
+              return yield* Effect.die(new Error("Queue Remove delivery reservation missing."));
+            }
+            yield* orchestrator.dispatch({
+              type: "message.dispatch",
+              createdBy: "agent",
+              creationSource: "server",
+              commandId: CommandId.make("command:mcp-late-parent:remove-dispatch"),
+              threadId: lateParentThreadId,
+              messageId: removeDelivery.messageId,
+              text: "Delegated task reached a terminal state.",
+              attachments: [],
+              modelSelection: codexSelection,
+              dispatchMode: { type: "queue_after_active" },
+              delegatedCompletion: {
+                parentRunId: removeParentRun.id,
+                generation: removeDelivery.generation,
+                taskIds: removeDelivery.taskIds,
+              },
+            });
+            const removeQueued = yield* waitForProjection(
+              orchestrator,
+              lateParentThreadId,
+              (projection) =>
+                projection.runs.some(
+                  (run) =>
+                    run.userMessageId === removeDelivery.messageId && run.status === "queued",
+                ),
+            );
+            const removeQueuedRun = removeQueued.runs.find(
+              (run) => run.userMessageId === removeDelivery.messageId,
+            );
+            if (removeQueuedRun === undefined) {
+              return yield* Effect.die(new Error("Queue Remove delivery did not queue."));
+            }
+            yield* Ref.set(continuationOffers, []);
+            yield* orchestrator.dispatch({
+              type: "queued-run.cancel",
+              commandId: CommandId.make("command:mcp-late-parent:remove-queued-delivery"),
+              threadId: lateParentThreadId,
+              runId: removeQueuedRun.id,
+            });
+            const removedDelivery = yield* waitForProjection(
+              orchestrator,
+              lateParentThreadId,
+              (projection) =>
+                projection.runs.find((run) => run.id === removeParentRun.id)?.delegatedCompletion
+                  ?.disposition === "disposed" &&
+                projection.runs.find((run) => run.id === removeQueuedRun.id)?.status ===
+                  "cancelled" &&
+                projection.subagents.find((task) => task.id === removeTask.id)?.completionDelivery
+                  ?.state === "disposed",
+            );
+            expect(
+              removedDelivery.runs.find((run) => run.id === removeParentRun.id)
+                ?.delegatedCompletion,
+            ).toMatchObject({ disposition: "disposed", delivery: null });
+            expect(
+              removedDelivery.subagents.find((task) => task.id === removeTask.id),
+            ).toMatchObject({ result: expect.any(String), status: "completed" });
+            yield* expectOffersToStay(0);
+          }).pipe(Effect.provide(testLayer));
+        }),
+      ),
+  );
+});
diff --git a/apps/server/src/mcp/WorktreeMcpService.test.ts b/apps/server/src/mcp/WorktreeMcpService.test.ts
new file mode 100644
index 000000000000..193087f2eb3c
--- /dev/null
+++ b/apps/server/src/mcp/WorktreeMcpService.test.ts
@@ -0,0 +1,1062 @@
+import { describe, expect, it, vi } from "@effect/vitest";
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import {
+  CommandId,
+  EnvironmentId,
+  type OrchestrationV2ThreadProjection,
+  type Project,
+  ProjectId,
+  ProviderInstanceId,
+  ThreadId,
+  WorktreeMcpHandoffInput,
+} from "@t3tools/contracts";
+import * as Cause from "effect/Cause";
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as Fiber from "effect/Fiber";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+import * as Schema from "effect/Schema";
+
+import * as GitWorkflowService from "../git/GitWorkflowService.ts";
+import {
+  OrchestratorDispatchError,
+  OrchestratorProjectionError,
+} from "../orchestration-v2/Orchestrator.ts";
+import {
+  ThreadManagementService,
+  ThreadManagementThreadArchivedError,
+  type ThreadManagementSendResult,
+} from "../orchestration-v2/ThreadManagementService.ts";
+import * as ProjectService from "../project/ProjectService.ts";
+import * as ProjectSetupScriptRunner from "../project/ProjectSetupScriptRunner.ts";
+import * as ServerSettings from "../serverSettings.ts";
+import { VcsStatusBroadcaster } from "../vcs/VcsStatusBroadcaster.ts";
+import type * as McpInvocationContext from "./McpInvocationContext.ts";
+import { layer as worktreeMcpServiceLayer, WorktreeMcpService } from "./WorktreeMcpService.ts";
+
+const environmentId = EnvironmentId.make("environment-worktree-test");
+const threadId = ThreadId.make("thread-worktree-test");
+const projectId = ProjectId.make("project-worktree-test");
+const workspaceRoot = "/repo/project";
+
+const makeScope = (
+  capabilities: ReadonlySet<McpInvocationContext.McpCapability>,
+): McpInvocationContext.McpInvocationScope => ({
+  environmentId,
+  threadId,
+  providerSessionId: "provider-session-worktree-test",
+  providerInstanceId: ProviderInstanceId.make("claudeAgent"),
+  capabilities,
+  issuedAt: 1,
+});
+
+interface ThreadFixture {
+  readonly branch?: string | null;
+  readonly worktreePath?: string | null;
+  readonly archivedAt?: string | null;
+  readonly deletedAt?: string | null;
+}
+
+const makeProjection = (overrides: ThreadFixture = {}): OrchestrationV2ThreadProjection =>
+  ({
+    thread: {
+      id: threadId,
+      projectId,
+      title: "Worktree test thread",
+      branch: null,
+      worktreePath: null,
+      archivedAt: null,
+      deletedAt: null,
+      ...overrides,
+    },
+  }) as OrchestrationV2ThreadProjection;
+
+const project: Project = {
+  id: projectId,
+  title: "Worktree test project",
+  workspaceRoot,
+  defaultModelSelection: null,
+  scripts: [],
+  createdAt: "2026-01-01T00:00:00.000Z",
+  updatedAt: "2026-01-01T00:00:00.000Z",
+  deletedAt: null,
+} as Project;
+
+interface HarnessOptions {
+  readonly thread?: ThreadFixture | null;
+  readonly threadReadError?: "projection" | "dispatch";
+  readonly capabilities?: ReadonlySet<McpInvocationContext.McpCapability>;
+  readonly currentBranch?: string | null;
+  readonly notARepo?: boolean;
+  readonly newWorktreesStartFromOrigin?: boolean;
+  readonly setupScript?: "started" | "no-script" | "fails" | "dies";
+  readonly dispatchFails?: boolean;
+  readonly dispatchDies?: boolean;
+  readonly dispatchInterrupts?: boolean;
+  readonly dispatchGate?: Effect.Effect<void>;
+  readonly threadAttachedOnRecheck?: boolean;
+  readonly threadArchivedOnRecheck?: boolean;
+  readonly threadReadFailsOnRecheck?: boolean;
+  readonly continuation?: "queued" | "fails" | "dies";
+  readonly projectMissing?: boolean;
+  readonly projectReadFails?: boolean;
+  readonly existingBranchWorktreePath?: string | null;
+  readonly pathSemantics?: "win32" | "posix";
+  readonly createWorktreeFails?: boolean;
+  readonly fetchRemoteFails?: boolean;
+  readonly resolveRemoteFails?: boolean;
+  readonly removeWorktreeFails?: boolean;
+  readonly deleteLocalBranchFails?: boolean;
+  readonly createWorktreeGate?: Effect.Effect<void>;
+}
+
+const makeHarness = (options: HarnessOptions = {}) => {
+  const thread = options.thread === undefined ? {} : options.thread;
+  const scope = makeScope(options.capabilities ?? new Set(["preview", "worktree"]));
+  const dispatch = vi.fn((_: unknown) =>
+    (options.dispatchGate ?? Effect.void).pipe(
+      Effect.andThen(
+        options.dispatchInterrupts
+          ? (Effect.failCause(Cause.interrupt()) as never)
+          : options.dispatchDies
+            ? Effect.die(new Error("dispatch defect"))
+            : options.dispatchFails
+              ? (Effect.fail("simulated dispatch failure") as never)
+              : Effect.succeed({ sequence: 1, storedEvents: [] }),
+      ),
+    ),
+  );
+  const listLocalBranchNames = vi.fn((_: string) =>
+    Effect.succeed(
+      options.existingBranchWorktreePath === undefined
+        ? ["dev"]
+        : ["dev", "feature/taken", "feature/taken-idle"],
+    ),
+  );
+  const getThreadProjection = vi.fn((id: ThreadId) => {
+    if (options.threadReadError === "dispatch") {
+      return Effect.fail(
+        new OrchestratorDispatchError({
+          commandId: CommandId.make("command:test:read"),
+          commandType: "thread.metadata.update",
+        }),
+      ) as never;
+    }
+    if (options.threadReadFailsOnRecheck === true && getThreadProjection.mock.calls.length > 1) {
+      return Effect.fail(
+        new OrchestratorDispatchError({
+          commandId: CommandId.make("command:test:recheck"),
+          commandType: "thread.metadata.update",
+        }),
+      ) as never;
+    }
+    if (
+      options.threadAttachedOnRecheck === true &&
+      getThreadProjection.mock.calls.length > 1 &&
+      thread !== null
+    ) {
+      return Effect.succeed(
+        makeProjection({ ...thread, worktreePath: "/worktrees/project/raced" }),
+      );
+    }
+    if (
+      options.threadArchivedOnRecheck === true &&
+      getThreadProjection.mock.calls.length > 1 &&
+      thread !== null
+    ) {
+      return Effect.succeed(makeProjection({ ...thread, archivedAt: "2026-01-02T00:00:00.000Z" }));
+    }
+    return id === threadId && thread !== null
+      ? Effect.succeed(makeProjection(thread))
+      : Effect.fail(new OrchestratorProjectionError({ threadId: id }));
+  });
+  const sendToThread = vi.fn((_: unknown) => {
+    switch (options.continuation ?? "queued") {
+      case "fails":
+        return Effect.fail(
+          new ThreadManagementThreadArchivedError({
+            threadId,
+          }),
+        );
+      case "dies":
+        return Effect.die(new Error("send defect"));
+      default:
+        return Effect.succeed({ delivery: "queued" } as ThreadManagementSendResult);
+    }
+  });
+  const getById = vi.fn((id: ProjectId) =>
+    options.projectReadFails
+      ? (Effect.fail("simulated project read failure") as never)
+      : Effect.succeed(
+          id === projectId && options.projectMissing !== true
+            ? Option.some(project)
+            : Option.none(),
+        ),
+  );
+  const removeWorktree = vi.fn((_: unknown) =>
+    options.removeWorktreeFails
+      ? (Effect.fail("simulated worktree removal failure") as never)
+      : Effect.void,
+  );
+  const deleteLocalBranch = vi.fn((_: unknown) =>
+    options.deleteLocalBranchFails
+      ? (Effect.fail("simulated local branch deletion failure") as never)
+      : Effect.void,
+  );
+  const fetchRemote = vi.fn((_: unknown) =>
+    options.fetchRemoteFails ? (Effect.fail("simulated fetch failure") as never) : Effect.void,
+  );
+  const resolveRemoteTrackingCommit = vi.fn((_: unknown) =>
+    options.resolveRemoteFails
+      ? (Effect.fail("simulated remote resolve failure") as never)
+      : Effect.succeed({ commitSha: "abc123", remoteRefName: "origin/dev" }),
+  );
+  const createWorktree = vi.fn(
+    (input: { readonly newRefName?: string | undefined; readonly path: string | null }) =>
+      options.createWorktreeFails
+        ? (Effect.fail("simulated worktree creation failure") as never)
+        : (options.createWorktreeGate ?? Effect.void).pipe(
+            Effect.andThen(
+              Effect.succeed({
+                worktree: {
+                  path: input.path ?? `/worktrees/project/${input.newRefName}`,
+                  refName: input.newRefName ?? "detached",
+                },
+              }),
+            ),
+          ),
+  );
+  const listRefs = vi.fn((input: { readonly query?: string | undefined }) =>
+    Effect.succeed({
+      refs:
+        options.existingBranchWorktreePath === undefined
+          ? []
+          : [
+              {
+                name: input.query ?? "",
+                current: false,
+                isDefault: false,
+                worktreePath: options.existingBranchWorktreePath,
+              },
+            ],
+      isRepo: true,
+      hasPrimaryRemote: true,
+      nextCursor: null,
+      totalCount: options.existingBranchWorktreePath === undefined ? 0 : 1,
+    }),
+  );
+  const localStatus = vi.fn((_: unknown) =>
+    Effect.succeed({
+      isRepo: options.notARepo !== true,
+      hasPrimaryRemote: true,
+      isDefaultRef: false,
+      refName: options.currentBranch === undefined ? "dev" : options.currentBranch,
+      hasWorkingTreeChanges: false,
+      workingTree: { files: [], insertions: 0, deletions: 0 },
+    }),
+  );
+  const refreshStatus = vi.fn((_: string) => Effect.die("refreshStatus stub"));
+  const runForThread = vi.fn((input: { readonly worktreePath: string }) => {
+    switch (options.setupScript ?? "started") {
+      case "no-script":
+        return Effect.succeed({ status: "no-script" } as const);
+      case "dies":
+        return Effect.die(new Error("setup runner defect"));
+      case "fails":
+        return Effect.fail(
+          new ProjectSetupScriptRunner.ProjectSetupScriptProjectNotFoundError({
+            threadId,
+            worktreePath: input.worktreePath,
+          }),
+        );
+      default:
+        return Effect.succeed({
+          status: "started",
+          scriptId: "setup",
+          scriptName: "Setup",
+          terminalId: "setup-terminal",
+          cwd: input.worktreePath,
+        } as const);
+    }
+  });
+
+  // Optional deterministic Path semantics: providing this BEFORE the general
+  // mocks means the service resolves Path here rather than from NodeServices,
+  // so absolute-path validation is testable independently of the host OS. The
+  // service only calls isAbsolute; the minimal per-platform semantics are
+  // inlined so the test does not depend on the host's path module.
+  const win32IsAbsolute = (value: string) => /^(?:[a-zA-Z]:[\\/]|[\\/])/.test(value);
+  const posixIsAbsolute = (value: string) => value.startsWith("/");
+  const serviceLayer =
+    options.pathSemantics === undefined
+      ? worktreeMcpServiceLayer
+      : worktreeMcpServiceLayer.pipe(
+          Layer.provide(
+            Layer.succeed(Path.Path, {
+              isAbsolute: options.pathSemantics === "win32" ? win32IsAbsolute : posixIsAbsolute,
+            } as unknown as Path.Path),
+          ),
+        );
+  const layer = serviceLayer.pipe(
+    Layer.provide(
+      Layer.mergeAll(
+        Layer.mock(ThreadManagementService)({
+          dispatch,
+          getThreadProjection,
+          sendToThread,
+        } satisfies Partial<ThreadManagementService["Service"]>),
+        Layer.mock(ProjectService.ProjectService)({
+          getById,
+        } satisfies Partial<ProjectService.ProjectService["Service"]>),
+        ServerSettings.layerTest({
+          newWorktreesStartFromOrigin: options.newWorktreesStartFromOrigin ?? false,
+        }),
+        Layer.mock(GitWorkflowService.GitWorkflowService)({
+          listRefs,
+          listLocalBranchNames,
+          localStatus,
+          fetchRemote,
+          resolveRemoteTrackingCommit,
+          createWorktree,
+          removeWorktree,
+          deleteLocalBranch,
+        } satisfies Partial<GitWorkflowService.GitWorkflowService["Service"]>),
+        Layer.mock(ProjectSetupScriptRunner.ProjectSetupScriptRunner)({
+          runForThread,
+        } satisfies Partial<ProjectSetupScriptRunner.ProjectSetupScriptRunner["Service"]>),
+        Layer.mock(VcsStatusBroadcaster)({
+          refreshStatus,
+        } satisfies Partial<VcsStatusBroadcaster["Service"]>),
+        NodeServices.layer,
+      ),
+    ),
+  );
+
+  return {
+    layer,
+    scope,
+    dispatch,
+    sendToThread,
+    fetchRemote,
+    resolveRemoteTrackingCommit,
+    createWorktree,
+    removeWorktree,
+    deleteLocalBranch,
+    localStatus,
+    runForThread,
+  };
+};
+
+const expectTypedFailure = (exit: Exit.Exit<unknown, unknown>, expected: object): void => {
+  if (!Exit.isFailure(exit)) {
+    expect.fail(`Expected a failure exit, got: ${JSON.stringify(exit)}`);
+  }
+  const reason = exit.cause.reasons[0];
+  if (reason?._tag !== "Fail") {
+    expect.fail(`Expected a typed Fail cause, got: ${reason?._tag ?? "no reason"}`);
+  }
+  expect(reason.error).toMatchObject(expected);
+};
+
+// Resolves the service once from the harness layer; used by tests that must
+// make several calls against the SAME instance (the in-flight guard lives in
+// the layer's closure, so a fresh layer per call would never see it).
+const resolveService = (harness: ReturnType<typeof makeHarness>) =>
+  Effect.gen(function* () {
+    return yield* WorktreeMcpService;
+  }).pipe(Effect.provide(harness.layer));
+
+const runHandoff = (
+  harness: ReturnType<typeof makeHarness>,
+  input: Parameters<WorktreeMcpService["Service"]["handoff"]>[1],
+) =>
+  Effect.gen(function* () {
+    const service = yield* WorktreeMcpService;
+    return yield* service.handoff(harness.scope, input);
+  }).pipe(Effect.provide(harness.layer));
+
+const runStatus = (harness: ReturnType<typeof makeHarness>) =>
+  Effect.gen(function* () {
+    const service = yield* WorktreeMcpService;
+    return yield* service.status(harness.scope);
+  }).pipe(Effect.provide(harness.layer));
+
+describe("t3_worktree_handoff", () => {
+  it.effect("creates a worktree from the current branch and re-points the thread", () => {
+    const harness = makeHarness();
+    return Effect.gen(function* () {
+      const result = yield* runHandoff(harness, { branch: "feature/handoff" });
+
+      expect(result.branch).toBe("feature/handoff");
+      expect(result.baseRef).toBe("dev");
+      expect(result.startedFromOrigin).toBe(false);
+      expect(result.worktreePath).toBe("/worktrees/project/feature/handoff");
+      expect(result.setupScript).toMatchObject({ status: "started", scriptName: "Setup" });
+
+      expect(harness.fetchRemote).not.toHaveBeenCalled();
+      expect(harness.createWorktree).toHaveBeenCalledWith({
+        cwd: workspaceRoot,
+        refName: "dev",
+        newRefName: "feature/handoff",
+        baseRefName: "dev",
+        path: null,
+      });
+      expect(harness.dispatch).toHaveBeenCalledWith(
+        expect.objectContaining({
+          type: "thread.metadata.update",
+          threadId,
+          branch: "feature/handoff",
+          worktreePath: "/worktrees/project/feature/handoff",
+          expectedWorktreePath: null,
+        }),
+      );
+      expect(harness.runForThread).toHaveBeenCalledWith({
+        threadId,
+        projectId,
+        projectCwd: workspaceRoot,
+        worktreePath: "/worktrees/project/feature/handoff",
+        project: { workspaceRoot, scripts: [] },
+      });
+    });
+  });
+
+  it.effect("skips the continuation when no continuationPrompt is given", () => {
+    const harness = makeHarness();
+    return Effect.gen(function* () {
+      const result = yield* runHandoff(harness, { branch: "feature/no-continuation" });
+      expect(result.continuation).toEqual({ status: "skipped" });
+      expect(harness.sendToThread).not.toHaveBeenCalled();
+    });
+  });
+
+  it.effect("queues the continuation prompt as the thread's next message", () => {
+    const harness = makeHarness();
+    return Effect.gen(function* () {
+      const result = yield* runHandoff(harness, {
+        branch: "feature/continue",
+        continuationPrompt: "Keep fixing the login bug in the new worktree.",
+      });
+
+      expect(result.continuation).toEqual({ status: "scheduled", delivery: "queued" });
+      expect(harness.sendToThread).toHaveBeenCalledWith(
+        expect.objectContaining({
+          projectId,
+          threadId,
+          text: "Keep fixing the login bug in the new worktree.",
+          mode: "queue",
+          createdBy: "agent",
+          creationSource: "mcp",
+        }),
+      );
+      // The continuation must be durably queued before anything slower runs.
+      expect(harness.sendToThread.mock.invocationCallOrder[0]).toBeLessThan(
+        harness.runForThread.mock.invocationCallOrder[0]!,
+      );
+    });
+  });
+
+  it.effect("reports a continuation failure without failing the handoff", () => {
+    const harness = makeHarness({ continuation: "fails" });
+    return Effect.gen(function* () {
+      const result = yield* runHandoff(harness, {
+        branch: "feature/continue-fails",
+        continuationPrompt: "Keep going.",
+      });
+      expect(result.continuation).toMatchObject({ status: "failed" });
+      expect(result.worktreePath).toBe("/worktrees/project/feature/continue-fails");
+      expect(harness.dispatch).toHaveBeenCalled();
+    });
+  });
+
+  it.effect("reports a continuation defect without failing the handoff", () => {
+    const harness = makeHarness({ continuation: "dies" });
+    return Effect.gen(function* () {
+      const result = yield* runHandoff(harness, {
+        branch: "feature/continue-dies",
+        continuationPrompt: "Keep going.",
+      });
+      expect(result.continuation).toEqual({ status: "failed", detail: "send defect" });
+      expect(result.setupScript).toMatchObject({ status: "started" });
+    });
+  });
+
+  it.effect("does not queue a continuation when the thread update fails", () => {
+    const harness = makeHarness({ dispatchFails: true });
+    return Effect.gen(function* () {
+      const exit = yield* Effect.exit(
+        runHandoff(harness, {
+          branch: "feature/dispatch-fails-continue",
+          continuationPrompt: "Keep going.",
+        }),
+      );
+      expectTypedFailure(exit, { _tag: "WorktreeMcpFailure", code: "operation_failed" });
+      expect(harness.sendToThread).not.toHaveBeenCalled();
+    });
+  });
+
+  it.effect("starts from origin and honors explicit baseRef and path", () => {
+    const harness = makeHarness();
+    return Effect.gen(function* () {
+      const result = yield* runHandoff(harness, {
+        branch: "feature/from-origin",
+        baseRef: "dev",
+        startFromOrigin: true,
+        path: "/custom/worktree/location",
+        runSetupScript: false,
+      });
+
+      expect(harness.fetchRemote).toHaveBeenCalledWith({
+        cwd: workspaceRoot,
+        remoteName: "origin",
+      });
+      expect(harness.resolveRemoteTrackingCommit).toHaveBeenCalledWith({
+        cwd: workspaceRoot,
+        refName: "dev",
+        fallbackRemoteName: "origin",
+      });
+      expect(harness.createWorktree).toHaveBeenCalledWith({
+        cwd: workspaceRoot,
+        refName: "abc123",
+        newRefName: "feature/from-origin",
+        baseRefName: "dev",
+        path: "/custom/worktree/location",
+      });
+      // localStatus is always consulted now (repo pre-check), but its branch
+      // must not override the explicit baseRef.
+      expect(harness.localStatus).toHaveBeenCalled();
+      expect(harness.runForThread).not.toHaveBeenCalled();
+      expect(result.worktreePath).toBe("/custom/worktree/location");
+      expect(result.startedFromOrigin).toBe(true);
+      expect(result.setupScript).toEqual({ status: "skipped" });
+    });
+  });
+
+  it.effect("uses the server setting for startFromOrigin when unspecified", () => {
+    const harness = makeHarness({ newWorktreesStartFromOrigin: true });
+    return Effect.gen(function* () {
+      const result = yield* runHandoff(harness, { branch: "feature/settings-origin" });
+      expect(result.startedFromOrigin).toBe(true);
+      expect(harness.fetchRemote).toHaveBeenCalled();
+    });
+  });
+
+  it.effect("fails when the thread is already attached to a worktree", () => {
+    const harness = makeHarness({
+      thread: { branch: "feature/existing", worktreePath: "/worktrees/project/existing" },
+    });
+    return Effect.gen(function* () {
+      const exit = yield* Effect.exit(runHandoff(harness, { branch: "feature/second" }));
+      expectTypedFailure(exit, {
+        _tag: "WorktreeMcpFailure",
+        code: "already_in_worktree",
+      });
+      expect(harness.createWorktree).not.toHaveBeenCalled();
+    });
+  });
+
+  it.effect("fails when the thread does not exist", () => {
+    const harness = makeHarness({ thread: null });
+    return Effect.gen(function* () {
+      const exit = yield* Effect.exit(runHandoff(harness, { branch: "feature/missing" }));
+      expectTypedFailure(exit, { _tag: "WorktreeMcpFailure", code: "thread_not_found" });
+      expect(harness.createWorktree).not.toHaveBeenCalled();
+    });
+  });
+
+  it.effect("treats a soft-deleted thread as not found", () => {
+    const harness = makeHarness({ thread: { deletedAt: "2026-01-02T00:00:00.000Z" } });
+    return Effect.gen(function* () {
+      const exit = yield* Effect.exit(runHandoff(harness, { branch: "feature/deleted" }));
+      expectTypedFailure(exit, { _tag: "WorktreeMcpFailure", code: "thread_not_found" });
+      expect(harness.createWorktree).not.toHaveBeenCalled();
+    });
+  });
+
+  it.effect("maps a non-projection orchestrator error to operation_failed", () => {
+    const harness = makeHarness({ threadReadError: "dispatch" });
+    return Effect.gen(function* () {
+      const exit = yield* Effect.exit(runHandoff(harness, { branch: "feature/read-error" }));
+      expectTypedFailure(exit, { _tag: "WorktreeMcpFailure", code: "operation_failed" });
+      expect(harness.createWorktree).not.toHaveBeenCalled();
+    });
+  });
+
+  it.effect("fails when the project does not exist", () => {
+    const harness = makeHarness({ projectMissing: true });
+    return Effect.gen(function* () {
+      const exit = yield* Effect.exit(runHandoff(harness, { branch: "feature/no-project" }));
+      expectTypedFailure(exit, { _tag: "WorktreeMcpFailure", code: "project_not_found" });
+      expect(harness.createWorktree).not.toHaveBeenCalled();
+    });
+  });
+
+  it.effect("maps a project read error to operation_failed", () => {
+    const harness = makeHarness({ projectReadFails: true });
+    return Effect.gen(function* () {
+      const exit = yield* Effect.exit(runHandoff(harness, { branch: "feature/project-error" }));
+      expectTypedFailure(exit, { _tag: "WorktreeMcpFailure", code: "operation_failed" });
+      expect(harness.createWorktree).not.toHaveBeenCalled();
+    });
+  });
+
+  it.effect("fails when the project workspace is not a git repository", () => {
+    const harness = makeHarness({ notARepo: true });
+    return Effect.gen(function* () {
+      const exit = yield* Effect.exit(runHandoff(harness, { branch: "feature/no-repo" }));
+      expectTypedFailure(exit, { _tag: "WorktreeMcpFailure", code: "invalid_request" });
+      expect(harness.createWorktree).not.toHaveBeenCalled();
+    });
+  });
+
+  it.effect("rejects an existing branch with an actionable error naming its checkout", () => {
+    const harness = makeHarness({ existingBranchWorktreePath: "/elsewhere/checkout" });
+    return Effect.gen(function* () {
+      const exit = yield* Effect.exit(runHandoff(harness, { branch: "feature/taken" }));
+      if (!Exit.isFailure(exit)) {
+        return expect.fail("expected a failure exit");
+      }
+      const reason = exit.cause.reasons[0];
+      expect(reason?._tag).toBe("Fail");
+      const error = (reason as { readonly error: { code: string; message: string } }).error;
+      expect(error.code).toBe("invalid_request");
+      expect(error.message).toContain("feature/taken");
+      expect(error.message).toContain("already exists");
+      expect(error.message).toContain("/elsewhere/checkout");
+      expect(harness.createWorktree).not.toHaveBeenCalled();
+      expect(harness.fetchRemote).not.toHaveBeenCalled();
+    });
+  });
+
+  it.effect("rejects an existing branch that is not checked out anywhere", () => {
+    const harness = makeHarness({ existingBranchWorktreePath: null });
+    return Effect.gen(function* () {
+      const exit = yield* Effect.exit(runHandoff(harness, { branch: "feature/taken-idle" }));
+      expectTypedFailure(exit, { _tag: "WorktreeMcpFailure", code: "invalid_request" });
+      expect(harness.createWorktree).not.toHaveBeenCalled();
+    });
+  });
+
+  it.effect("does not trip the pre-flight on similarly named branches", () => {
+    const harness = makeHarness({ existingBranchWorktreePath: null });
+    return Effect.gen(function* () {
+      // "feature/taken" exists in the mock branch list; "feature/take" does
+      // not, and a substring-based check would wrongly match it.
+      const result = yield* runHandoff(harness, { branch: "feature/take" });
+      expect(result.branch).toBe("feature/take");
+      expect(harness.createWorktree).toHaveBeenCalledTimes(1);
+    });
+  });
+
+  it.effect("rejects a non-repository workspace even when baseRef is explicit", () => {
+    const harness = makeHarness({ notARepo: true });
+    return Effect.gen(function* () {
+      const exit = yield* Effect.exit(
+        runHandoff(harness, { branch: "feature/no-repo-baseref", baseRef: "dev" }),
+      );
+      expectTypedFailure(exit, { _tag: "WorktreeMcpFailure", code: "invalid_request" });
+      expect(harness.createWorktree).not.toHaveBeenCalled();
+    });
+  });
+
+  it.effect("propagates an interrupted dispatch without rolling back the worktree", () => {
+    const harness = makeHarness({ dispatchInterrupts: true });
+    return Effect.gen(function* () {
+      const exit = yield* Effect.exit(runHandoff(harness, { branch: "feature/dispatch-int" }));
+      if (!Exit.isFailure(exit)) {
+        return expect.fail("expected a failure exit");
+      }
+      // Whether the binding committed is unknown on interruption, so the
+      // worktree must not be force-deleted and no typed failure is invented.
+      expect(Cause.hasInterruptsOnly(exit.cause)).toBe(true);
+      expect(harness.removeWorktree).not.toHaveBeenCalled();
+    });
+  });
+
+  it.effect("maps a worktree creation failure to operation_failed", () => {
+    const harness = makeHarness({ createWorktreeFails: true });
+    return Effect.gen(function* () {
+      const exit = yield* Effect.exit(runHandoff(harness, { branch: "feature/create-fails" }));
+      expectTypedFailure(exit, { _tag: "WorktreeMcpFailure", code: "operation_failed" });
+      expect(harness.dispatch).not.toHaveBeenCalled();
+      expect(harness.removeWorktree).not.toHaveBeenCalled();
+    });
+  });
+
+  it.effect("maps an origin fetch failure to operation_failed", () => {
+    const harness = makeHarness({ fetchRemoteFails: true });
+    return Effect.gen(function* () {
+      const exit = yield* Effect.exit(
+        runHandoff(harness, { branch: "feature/fetch-fails", startFromOrigin: true }),
+      );
+      expectTypedFailure(exit, { _tag: "WorktreeMcpFailure", code: "operation_failed" });
+      expect(harness.createWorktree).not.toHaveBeenCalled();
+    });
+  });
+
+  it.effect("maps a remote-tracking resolve failure to operation_failed", () => {
+    const harness = makeHarness({ resolveRemoteFails: true });
+    return Effect.gen(function* () {
+      const exit = yield* Effect.exit(
+        runHandoff(harness, { branch: "feature/resolve-fails", startFromOrigin: true }),
+      );
+      expectTypedFailure(exit, { _tag: "WorktreeMcpFailure", code: "operation_failed" });
+      expect(harness.createWorktree).not.toHaveBeenCalled();
+    });
+  });
+
+  it.effect("removes the created worktree when the thread update dies with a defect", () => {
+    const harness = makeHarness({ dispatchDies: true });
+    return Effect.gen(function* () {
+      const exit = yield* Effect.exit(runHandoff(harness, { branch: "feature/dispatch-defect" }));
+      expectTypedFailure(exit, { _tag: "WorktreeMcpFailure", code: "operation_failed" });
+      expect(harness.removeWorktree).toHaveBeenCalledWith({
+        cwd: workspaceRoot,
+        path: "/worktrees/project/feature/dispatch-defect",
+        force: true,
+      });
+    });
+  });
+
+  it.effect("re-checks attachment after creating the worktree and backs out on a race", () => {
+    const harness = makeHarness({ threadAttachedOnRecheck: true });
+    return Effect.gen(function* () {
+      const exit = yield* Effect.exit(runHandoff(harness, { branch: "feature/raced" }));
+      expectTypedFailure(exit, { _tag: "WorktreeMcpFailure", code: "already_in_worktree" });
+      expect(harness.createWorktree).toHaveBeenCalledTimes(1);
+      // The freshly created worktree must not be left orphaned.
+      expect(harness.removeWorktree).toHaveBeenCalledWith({
+        cwd: workspaceRoot,
+        path: "/worktrees/project/feature/raced",
+        force: true,
+      });
+      expect(harness.deleteLocalBranch).toHaveBeenCalledWith({
+        cwd: workspaceRoot,
+        refName: "feature/raced",
+        force: true,
+      });
+      expect(harness.dispatch).not.toHaveBeenCalled();
+    });
+  });
+
+  it.effect("removes the created worktree when the recheck read fails", () => {
+    const harness = makeHarness({ threadReadFailsOnRecheck: true });
+    return Effect.gen(function* () {
+      const exit = yield* Effect.exit(runHandoff(harness, { branch: "feature/recheck-fails" }));
+      expectTypedFailure(exit, { _tag: "WorktreeMcpFailure", code: "operation_failed" });
+      expect(harness.removeWorktree).toHaveBeenCalledWith({
+        cwd: workspaceRoot,
+        path: "/worktrees/project/feature/recheck-fails",
+        force: true,
+      });
+      expect(harness.dispatch).not.toHaveBeenCalled();
+    });
+  });
+
+  it.effect("backs out when the thread is archived during worktree creation", () => {
+    const harness = makeHarness({ threadArchivedOnRecheck: true });
+    return Effect.gen(function* () {
+      const exit = yield* Effect.exit(runHandoff(harness, { branch: "feature/archived-race" }));
+      expectTypedFailure(exit, { _tag: "WorktreeMcpFailure", code: "invalid_request" });
+      expect(harness.dispatch).not.toHaveBeenCalled();
+      // The created worktree must not be left orphaned.
+      expect(harness.removeWorktree).toHaveBeenCalledWith({
+        cwd: workspaceRoot,
+        path: "/worktrees/project/feature/archived-race",
+        force: true,
+      });
+    });
+  });
+
+  it.effect("rejects a handoff for an archived thread", () => {
+    const harness = makeHarness({ thread: { archivedAt: "2026-01-02T00:00:00.000Z" } });
+    return Effect.gen(function* () {
+      const exit = yield* Effect.exit(runHandoff(harness, { branch: "feature/archived" }));
+      expectTypedFailure(exit, { _tag: "WorktreeMcpFailure", code: "invalid_request" });
+      expect(harness.createWorktree).not.toHaveBeenCalled();
+    });
+  });
+
+  it.effect("queues the continuation even when interrupted during the binding dispatch", () =>
+    Effect.gen(function* () {
+      const gate = yield* Deferred.make<void>();
+      const harness = makeHarness({ dispatchGate: Deferred.await(gate) });
+
+      // Interrupt arrives while the metadata dispatch is in flight; the
+      // binding-plus-continuation section must run to completion anyway so the
+      // continuation is never lost between the commit and the queue.
+      const fiber = yield* Effect.forkChild(
+        runHandoff(harness, {
+          branch: "feature/interrupted",
+          continuationPrompt: "Keep going in the worktree.",
+        }),
+      );
+      yield* Effect.yieldNow;
+      const interruption = yield* Effect.forkChild(Fiber.interrupt(fiber));
+      yield* Effect.yieldNow;
+      yield* Deferred.succeed(gate, undefined);
+      yield* Fiber.await(fiber);
+      yield* Fiber.join(interruption);
+
+      expect(harness.dispatch).toHaveBeenCalledTimes(1);
+      expect(harness.sendToThread).toHaveBeenCalledTimes(1);
+      // The setup script must also survive the pending interrupt; otherwise
+      // the continuation run starts in a worktree that was never set up.
+      expect(harness.runForThread).toHaveBeenCalledTimes(1);
+    }),
+  );
+
+  it.effect("still fails with a typed error when the rollback removal also fails", () => {
+    const harness = makeHarness({ dispatchFails: true, removeWorktreeFails: true });
+    return Effect.gen(function* () {
+      const exit = yield* Effect.exit(runHandoff(harness, { branch: "feature/rollback-fails" }));
+      expectTypedFailure(exit, { _tag: "WorktreeMcpFailure", code: "operation_failed" });
+      expect(harness.removeWorktree).toHaveBeenCalledTimes(1);
+      expect(harness.deleteLocalBranch).not.toHaveBeenCalled();
+    });
+  });
+
+  it.effect("preserves the typed failure when rollback branch deletion also fails", () => {
+    const harness = makeHarness({ dispatchFails: true, deleteLocalBranchFails: true });
+    return Effect.gen(function* () {
+      const exit = yield* Effect.exit(
+        runHandoff(harness, { branch: "feature/rollback-branch-fails" }),
+      );
+      expectTypedFailure(exit, { _tag: "WorktreeMcpFailure", code: "operation_failed" });
+      expect(harness.removeWorktree).toHaveBeenCalledTimes(1);
+      expect(harness.deleteLocalBranch).toHaveBeenCalledWith({
+        cwd: workspaceRoot,
+        refName: "feature/rollback-branch-fails",
+        force: true,
+      });
+    });
+  });
+
+  it.effect("accepts a Windows drive path under win32 path semantics", () => {
+    const harness = makeHarness({ pathSemantics: "win32" });
+    return Effect.gen(function* () {
+      const result = yield* runHandoff(harness, {
+        branch: "feature/windows-path",
+        path: "C:\\worktrees\\custom",
+      });
+      expect(result.worktreePath).toBe("C:\\worktrees\\custom");
+      expect(harness.createWorktree).toHaveBeenCalledWith(
+        expect.objectContaining({ path: "C:\\worktrees\\custom" }),
+      );
+    });
+  });
+
+  it.effect("rejects a Windows drive path under posix path semantics", () => {
+    const harness = makeHarness({ pathSemantics: "posix" });
+    return Effect.gen(function* () {
+      // The schema-level pattern admits drive paths cross-platform; the
+      // runtime check reflects the host the worktree would be created on.
+      const exit = yield* Effect.exit(
+        runHandoff(harness, { branch: "feature/windows-path", path: "C:\\worktrees\\custom" }),
+      );
+      expectTypedFailure(exit, { _tag: "WorktreeMcpFailure", code: "invalid_request" });
+      expect(harness.createWorktree).not.toHaveBeenCalled();
+    });
+  });
+
+  it.effect("releases the per-thread guard after a failed handoff", () => {
+    const harness = makeHarness({
+      thread: { worktreePath: "/worktrees/project/existing" },
+    });
+    return Effect.gen(function* () {
+      const service = yield* resolveService(harness);
+
+      const first = yield* Effect.exit(
+        service.handoff(harness.scope, { branch: "feature/guard-1" }),
+      );
+      expectTypedFailure(first, { _tag: "WorktreeMcpFailure", code: "already_in_worktree" });
+      // A leaked guard would surface as handoff_in_progress here.
+      const second = yield* Effect.exit(
+        service.handoff(harness.scope, { branch: "feature/guard-2" }),
+      );
+      expectTypedFailure(second, { _tag: "WorktreeMcpFailure", code: "already_in_worktree" });
+    });
+  });
+
+  it.effect("fails when the worktree capability is missing", () => {
+    const harness = makeHarness({ capabilities: new Set(["preview"]) });
+    return Effect.gen(function* () {
+      const exit = yield* Effect.exit(runHandoff(harness, { branch: "feature/no-capability" }));
+      expectTypedFailure(exit, { _tag: "WorktreeMcpFailure", code: "capability_denied" });
+    });
+  });
+
+  it.effect("serializes concurrent handoffs for the same thread", () =>
+    Effect.gen(function* () {
+      const gate = yield* Deferred.make<void>();
+      const harness = makeHarness({ createWorktreeGate: Deferred.await(gate) });
+
+      const service = yield* resolveService(harness);
+
+      // First handoff acquires the per-thread guard and blocks on the gate.
+      const first = yield* Effect.forkChild(
+        Effect.exit(service.handoff(harness.scope, { branch: "feature/race-1" })),
+      );
+      yield* Effect.yieldNow;
+
+      // Second handoff for the same thread must be refused while the first
+      // is still in flight.
+      const second = yield* Effect.exit(
+        service.handoff(harness.scope, { branch: "feature/race-2" }),
+      );
+      expectTypedFailure(second, { _tag: "WorktreeMcpFailure", code: "handoff_in_progress" });
+
+      yield* Deferred.succeed(gate, undefined);
+      const firstExit = yield* Fiber.join(first);
+      expect(Exit.isSuccess(firstExit)).toBe(true);
+      expect(harness.createWorktree).toHaveBeenCalledTimes(1);
+    }),
+  );
+
+  it.effect("removes the created worktree when the thread update fails", () => {
+    const harness = makeHarness({ dispatchFails: true });
+    return Effect.gen(function* () {
+      const exit = yield* Effect.exit(runHandoff(harness, { branch: "feature/dispatch-fails" }));
+      expectTypedFailure(exit, { _tag: "WorktreeMcpFailure", code: "operation_failed" });
+      expect(harness.createWorktree).toHaveBeenCalledTimes(1);
+      expect(harness.removeWorktree).toHaveBeenCalledWith({
+        cwd: workspaceRoot,
+        path: "/worktrees/project/feature/dispatch-fails",
+        force: true,
+      });
+    });
+  });
+
+  it.effect("rejects a relative path", () => {
+    const harness = makeHarness();
+    return Effect.gen(function* () {
+      const exit = yield* Effect.exit(
+        runHandoff(harness, { branch: "feature/relative-path", path: "worktrees/nested" }),
+      );
+      expectTypedFailure(exit, { _tag: "WorktreeMcpFailure", code: "invalid_request" });
+      expect(harness.createWorktree).not.toHaveBeenCalled();
+    });
+  });
+
+  it.effect("fails when baseRef is omitted and HEAD is detached", () => {
+    const harness = makeHarness({ currentBranch: null });
+    return Effect.gen(function* () {
+      const exit = yield* Effect.exit(runHandoff(harness, { branch: "feature/detached" }));
+      expectTypedFailure(exit, { _tag: "WorktreeMcpFailure", code: "invalid_request" });
+    });
+  });
+
+  it.effect("reports setup script failure without failing the handoff", () => {
+    const harness = makeHarness({ setupScript: "fails" });
+    return Effect.gen(function* () {
+      const result = yield* runHandoff(harness, { branch: "feature/setup-fails" });
+      expect(result.setupScript.status).toBe("failed");
+      expect(harness.dispatch).toHaveBeenCalled();
+    });
+  });
+
+  it.effect("reports a setup script defect without failing the handoff", () => {
+    const harness = makeHarness({ setupScript: "dies" });
+    return Effect.gen(function* () {
+      const result = yield* runHandoff(harness, { branch: "feature/setup-dies" });
+      expect(result.setupScript).toEqual({ status: "failed", detail: "setup runner defect" });
+      expect(harness.dispatch).toHaveBeenCalled();
+    });
+  });
+});
+
+describe("t3_worktree_status", () => {
+  it.effect("reports an unattached thread", () => {
+    const harness = makeHarness({ newWorktreesStartFromOrigin: true });
+    return Effect.gen(function* () {
+      const result = yield* runStatus(harness);
+      expect(result).toEqual({
+        attached: false,
+        worktreePath: null,
+        branch: null,
+        projectWorkspaceRoot: workspaceRoot,
+        defaultStartFromOrigin: true,
+      });
+    });
+  });
+
+  it.effect("reports an attached thread's worktree and branch", () => {
+    const harness = makeHarness({
+      thread: {
+        worktreePath: "/worktrees/project/existing",
+        branch: "feature/existing",
+      },
+    });
+    return Effect.gen(function* () {
+      const result = yield* runStatus(harness);
+      expect(result).toMatchObject({
+        attached: true,
+        worktreePath: "/worktrees/project/existing",
+        branch: "feature/existing",
+        defaultStartFromOrigin: false,
+      });
+    });
+  });
+
+  it.effect("fails when the worktree capability is missing", () => {
+    const harness = makeHarness({ capabilities: new Set(["preview"]) });
+    return Effect.gen(function* () {
+      const exit = yield* Effect.exit(runStatus(harness));
+      expectTypedFailure(exit, { _tag: "WorktreeMcpFailure", code: "capability_denied" });
+    });
+  });
+
+  it.effect("fails when the thread does not exist", () => {
+    const harness = makeHarness({ thread: null });
+    return Effect.gen(function* () {
+      const exit = yield* Effect.exit(runStatus(harness));
+      expectTypedFailure(exit, { _tag: "WorktreeMcpFailure", code: "thread_not_found" });
+    });
+  });
+
+  it.effect("fails when the project does not exist", () => {
+    const harness = makeHarness({ projectMissing: true });
+    return Effect.gen(function* () {
+      const exit = yield* Effect.exit(runStatus(harness));
+      expectTypedFailure(exit, { _tag: "WorktreeMcpFailure", code: "project_not_found" });
+    });
+  });
+});
+
+describe("WorktreeMcpHandoffInput schema", () => {
+  const decode = Schema.decodeUnknownEffect(WorktreeMcpHandoffInput);
+
+  it.effect("accepts POSIX, Windows drive, and UNC absolute paths", () =>
+    Effect.gen(function* () {
+      for (const path of ["/abs/posix", "C:\\abs\\drive", "C:/abs/drive", "\\\\host\\share"]) {
+        const decoded = yield* decode({ branch: "feature/x", path });
+        expect(decoded.path).toBe(path);
+      }
+    }),
+  );
+
+  it.effect("rejects relative paths", () =>
+    Effect.gen(function* () {
+      for (const path of ["worktrees/nested", "./nested", "../sibling"]) {
+        const exit = yield* Effect.exit(decode({ branch: "feature/x", path }));
+        expect(Exit.isFailure(exit), `path '${path}' should be rejected`).toBe(true);
+      }
+    }),
+  );
+
+  it.effect("rejects a missing or blank branch", () =>
+    Effect.gen(function* () {
+      expect(Exit.isFailure(yield* Effect.exit(decode({})))).toBe(true);
+      expect(Exit.isFailure(yield* Effect.exit(decode({ branch: "   " })))).toBe(true);
+    }),
+  );
+
+  it.effect("rejects a blank continuationPrompt", () =>
+    Effect.gen(function* () {
+      const exit = yield* Effect.exit(decode({ branch: "feature/x", continuationPrompt: " " }));
+      expect(Exit.isFailure(exit)).toBe(true);
+    }),
+  );
+});
diff --git a/apps/server/src/mcp/WorktreeMcpService.ts b/apps/server/src/mcp/WorktreeMcpService.ts
new file mode 100644
index 000000000000..c287f68b3bc1
--- /dev/null
+++ b/apps/server/src/mcp/WorktreeMcpService.ts
@@ -0,0 +1,494 @@
+import {
+  CommandId,
+  MessageId,
+  type ProjectId,
+  WorktreeMcpFailure,
+  type WorktreeMcpContinuationStatus,
+  type WorktreeMcpHandoffInput,
+  type WorktreeMcpHandoffResult,
+  type WorktreeMcpSetupScriptStatus,
+  type WorktreeMcpStatusResult,
+} from "@t3tools/contracts";
+import * as Cause from "effect/Cause";
+import * as Context from "effect/Context";
+import * as Crypto from "effect/Crypto";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+
+import * as GitWorkflowService from "../git/GitWorkflowService.ts";
+import { ThreadManagementService } from "../orchestration-v2/ThreadManagementService.ts";
+import * as ProjectService from "../project/ProjectService.ts";
+import * as ProjectSetupScriptRunner from "../project/ProjectSetupScriptRunner.ts";
+import * as ServerSettings from "../serverSettings.ts";
+import * as VcsStatusBroadcaster from "../vcs/VcsStatusBroadcaster.ts";
+import type { McpInvocationScope } from "./McpInvocationContext.ts";
+
+export class WorktreeMcpService extends Context.Service<
+  WorktreeMcpService,
+  {
+    readonly handoff: (
+      scope: McpInvocationScope,
+      input: WorktreeMcpHandoffInput,
+    ) => Effect.Effect<WorktreeMcpHandoffResult, WorktreeMcpFailure>;
+    readonly status: (
+      scope: McpInvocationScope,
+    ) => Effect.Effect<WorktreeMcpStatusResult, WorktreeMcpFailure>;
+  }
+>()("t3/mcp/WorktreeMcpService") {}
+
+function failure(code: WorktreeMcpFailure["code"], message: string): WorktreeMcpFailure {
+  return new WorktreeMcpFailure({ code, message });
+}
+
+function errorMessage(error: unknown): string {
+  if (error instanceof Error) return error.message;
+  if (typeof error === "object" && error !== null && "message" in error) {
+    return String((error as { message: unknown }).message);
+  }
+  return String(error);
+}
+
+const asOperationFailed = (prefix: string) =>
+  Effect.mapError((error: unknown) =>
+    failure("operation_failed", `${prefix}: ${errorMessage(error)}`),
+  );
+
+const make = Effect.gen(function* () {
+  const crypto = yield* Crypto.Crypto;
+  const path = yield* Path.Path;
+  const threadManagement = yield* ThreadManagementService;
+  const projects = yield* ProjectService.ProjectService;
+  const serverSettings = yield* ServerSettings.ServerSettingsService;
+  const gitWorkflow = yield* GitWorkflowService.GitWorkflowService;
+  const setupScriptRunner = yield* ProjectSetupScriptRunner.ProjectSetupScriptRunner;
+  const vcsStatusBroadcaster = yield* VcsStatusBroadcaster.VcsStatusBroadcaster;
+
+  // Serializes handoffs per thread: two concurrent calls could otherwise both
+  // pass the worktreePath === null check and each create a worktree, leaving
+  // one untracked on disk.
+  const handoffThreadsInFlight = new Set<string>();
+
+  const requireCapability = (scope: McpInvocationScope) =>
+    scope.capabilities.has("worktree")
+      ? Effect.void
+      : Effect.fail(
+          failure("capability_denied", "This MCP credential does not grant worktree capabilities."),
+        );
+
+  const loadThread = (scope: McpInvocationScope) =>
+    threadManagement.getThreadProjection(scope.threadId).pipe(
+      Effect.mapError((error) =>
+        error._tag === "OrchestratorProjectionError"
+          ? failure("thread_not_found", `Thread '${scope.threadId}' was not found.`)
+          : failure(
+              "operation_failed",
+              `Unable to read thread ${scope.threadId}: ${errorMessage(error)}`,
+            ),
+      ),
+      Effect.filterOrFail(
+        (projection) => projection.thread.deletedAt === null,
+        () => failure("thread_not_found", `Thread '${scope.threadId}' was not found.`),
+      ),
+    );
+
+  const loadProject = (scope: McpInvocationScope, projectId: ProjectId) =>
+    projects.getById(projectId).pipe(
+      asOperationFailed(`Unable to read project ${projectId}`),
+      Effect.flatMap(
+        Option.match({
+          onNone: () =>
+            Effect.fail(
+              failure(
+                "project_not_found",
+                `Project '${projectId}' was not found for thread '${scope.threadId}'.`,
+              ),
+            ),
+          onSome: Effect.succeed,
+        }),
+      ),
+    );
+
+  const readDefaultStartFromOrigin = serverSettings.getSettings.pipe(
+    Effect.map((settings) => settings.newWorktreesStartFromOrigin),
+    asOperationFailed("Unable to read server settings"),
+  );
+
+  const handoffIds = (scope: McpInvocationScope) =>
+    crypto.randomUUIDv4.pipe(
+      Effect.map((uuid) => {
+        const part = (kind: string, operation: string) =>
+          [kind, "mcp", encodeURIComponent(scope.providerSessionId), operation, uuid].join(":");
+        return {
+          commandId: CommandId.make(part("command", "worktree-handoff")),
+          continuationCommandId: CommandId.make(part("command", "worktree-continuation")),
+          continuationMessageId: MessageId.make(part("message", "worktree-continuation")),
+        };
+      }),
+      Effect.orDie,
+    );
+
+  const performHandoff = Effect.fn("WorktreeMcpService.performHandoff")(function* (
+    scope: McpInvocationScope,
+    input: WorktreeMcpHandoffInput,
+  ) {
+    const alreadyInWorktree = (worktreePath: string) =>
+      failure(
+        "already_in_worktree",
+        `Thread '${scope.threadId}' is already attached to worktree '${worktreePath}'.`,
+      );
+
+    const projection = yield* loadThread(scope);
+    if (projection.thread.worktreePath !== null) {
+      return yield* alreadyInWorktree(projection.thread.worktreePath);
+    }
+    // An archived thread would accept the binding but refuse the continuation
+    // message (and any other follow-up), so reject the handoff outright.
+    if (projection.thread.archivedAt !== null) {
+      return yield* failure(
+        "invalid_request",
+        `Thread '${scope.threadId}' is archived and cannot be handed off to a worktree.`,
+      );
+    }
+
+    const project = yield* loadProject(scope, projection.thread.projectId);
+    const projectCwd = project.workspaceRoot;
+
+    if (input.path !== undefined && !path.isAbsolute(input.path)) {
+      return yield* failure(
+        "invalid_request",
+        `path must be an absolute filesystem path, got '${input.path}'. A relative path would be created relative to the project workspace but stored verbatim as the thread's worktree binding.`,
+      );
+    }
+
+    // The repo check runs regardless of whether baseRef was supplied, so a
+    // non-repository workspace fails with an actionable error instead of an
+    // opaque git failure further down.
+    const localStatus = yield* gitWorkflow
+      .localStatus({ cwd: projectCwd })
+      .pipe(asOperationFailed("Unable to read git status"));
+    if (!localStatus.isRepo) {
+      return yield* failure(
+        "invalid_request",
+        `Project workspace '${projectCwd}' is not a git repository.`,
+      );
+    }
+
+    // Fail fast with an actionable message when the branch already exists:
+    // the git driver deliberately keeps stderr out of its errors, so letting
+    // `git worktree add` fail would surface only an opaque failure. The
+    // existence check uses the complete local branch list (exact match); the
+    // paginated substring search only enriches the message with the checkout
+    // location when available.
+    const localBranchNames = yield* gitWorkflow
+      .listLocalBranchNames(projectCwd)
+      .pipe(asOperationFailed("Unable to list branches"));
+    if (localBranchNames.includes(input.branch)) {
+      const existingRef = yield* gitWorkflow
+        .listRefs({ cwd: projectCwd, query: input.branch, refKind: "local" })
+        .pipe(
+          Effect.map((result) =>
+            result.refs.find((ref) => ref.name === input.branch && ref.isRemote !== true),
+          ),
+          Effect.orElseSucceed(() => undefined),
+        );
+      const checkoutPath = existingRef?.worktreePath ?? null;
+      return yield* failure(
+        "invalid_request",
+        `Branch '${input.branch}' already exists${
+          checkoutPath === null ? "" : ` and is checked out at '${checkoutPath}'`
+        }. Choose a different branch name, or delete the existing branch${
+          checkoutPath === null ? "" : " and its worktree"
+        } first.`,
+      );
+    }
+
+    let baseRef = input.baseRef;
+    if (baseRef === undefined) {
+      if (localStatus.refName === null) {
+        return yield* failure(
+          "invalid_request",
+          "Could not determine the current branch of the project workspace (detached HEAD?). Pass baseRef explicitly.",
+        );
+      }
+      baseRef = localStatus.refName;
+    }
+
+    const startFromOrigin = input.startFromOrigin ?? (yield* readDefaultStartFromOrigin);
+
+    let worktreeBaseRef = baseRef;
+    if (startFromOrigin) {
+      yield* gitWorkflow
+        .fetchRemote({ cwd: projectCwd, remoteName: "origin" })
+        .pipe(asOperationFailed("Unable to fetch origin"));
+      const resolvedRemoteBase = yield* gitWorkflow
+        .resolveRemoteTrackingCommit({
+          cwd: projectCwd,
+          refName: baseRef,
+          fallbackRemoteName: "origin",
+        })
+        .pipe(asOperationFailed(`Unable to resolve the remote-tracking commit of '${baseRef}'`));
+      worktreeBaseRef = resolvedRemoteBase.commitSha;
+    }
+
+    const ids = yield* handoffIds(scope);
+
+    // uninterruptibleMask: only the potentially slow worktree creation itself
+    // stays interruptible (restore). From the moment it succeeds, through the
+    // binding, continuation queue, setup script launch, and result
+    // construction, there is no interruptible gap: a client cancel can
+    // therefore neither orphan the created worktree before the rollback is
+    // armed, nor skip setting up a worktree the thread was just bound to
+    // (once the binding commits, the scheduled session detach can sever this
+    // request's connection and interrupt the fiber).
+    return yield* Effect.uninterruptibleMask((restore) =>
+      Effect.gen(function* () {
+        const worktree = yield* restore(
+          gitWorkflow
+            .createWorktree({
+              cwd: projectCwd,
+              refName: worktreeBaseRef,
+              newRefName: input.branch,
+              baseRefName: baseRef,
+              path: input.path ?? null,
+            })
+            .pipe(asOperationFailed("Unable to create the worktree")),
+        );
+        const worktreePath = worktree.worktree.path;
+
+        // Shared shape for "the handoff already succeeded, so report the failure
+        // in the result instead of failing the call" (continuation, setup script).
+        const reportFailed = (logMessage: string) =>
+          Effect.catchCause((cause: Cause.Cause<unknown>) => {
+            const detail = errorMessage(Cause.squash(cause));
+            return Effect.logWarning(logMessage, {
+              threadId: scope.threadId,
+              worktreePath,
+              detail,
+            }).pipe(Effect.as({ status: "failed", detail } as const));
+          });
+
+        // suspend: build the rollback only if cleanup actually runs. Removing
+        // the worktree must succeed before deleting its freshly created branch;
+        // otherwise the branch may still be checked out there.
+        const removeCreatedWorktree = Effect.suspend(() =>
+          gitWorkflow.removeWorktree({ cwd: projectCwd, path: worktreePath, force: true }).pipe(
+            Effect.andThen(
+              Effect.suspend(() =>
+                gitWorkflow.deleteLocalBranch({
+                  cwd: projectCwd,
+                  refName: worktree.worktree.refName,
+                  force: true,
+                }),
+              ),
+            ),
+          ),
+        ).pipe(Effect.ignoreCause({ log: true }));
+
+        const recheckAndBind = Effect.gen(function* () {
+          // The projection was read before the potentially slow git work
+          // above; a concurrent binding (for example from the UI) could have
+          // attached the thread in the meantime. Re-check before committing so
+          // the race cannot leave a second, untracked worktree.
+          const recheck = yield* loadThread(scope);
+          if (recheck.thread.worktreePath !== null) {
+            return yield* alreadyInWorktree(recheck.thread.worktreePath);
+          }
+          // Mirror the up-front archived check: the thread may have been
+          // archived during the slow git work, and an archived thread must
+          // not be bound to a fresh worktree it can never use.
+          if (recheck.thread.archivedAt !== null) {
+            return yield* failure(
+              "invalid_request",
+              `Thread '${scope.threadId}' was archived while the worktree was being created; the handoff was rolled back.`,
+            );
+          }
+          yield* threadManagement
+            .dispatch({
+              type: "thread.metadata.update",
+              commandId: ids.commandId,
+              threadId: scope.threadId,
+              branch: worktree.worktree.refName,
+              worktreePath,
+              expectedWorktreePath: null,
+            })
+            .pipe(
+              Effect.catchCause((cause) =>
+                // Interrupt-only causes propagate unchanged: whether the
+                // dispatch committed is unknown, so neither a typed failure
+                // nor a rollback would be correct. Failures and defects
+                // (including mixed causes) map to a typed operation_failed.
+                Cause.hasInterruptsOnly(cause)
+                  ? Effect.failCause(cause as Cause.Cause<never>)
+                  : Effect.fail(
+                      failure(
+                        "operation_failed",
+                        `Unable to re-point the thread at the worktree: ${errorMessage(Cause.squash(cause))}`,
+                      ),
+                    ),
+              ),
+            );
+        }).pipe(
+          // onError: the worktree was already created, so any failure between
+          // here and the committed binding (recheck read, recheck race,
+          // dispatch typed failure or defect) must remove it again so a failed
+          // handoff leaves nothing behind on disk. Interrupt-only causes skip
+          // the removal: the binding may have committed, and force-deleting a
+          // worktree the thread now points at would be worse than leaking one.
+          Effect.onError((cause) =>
+            Cause.hasInterruptsOnly(cause) ? Effect.void : removeCreatedWorktree,
+          ),
+        );
+
+        // Queue the continuation right after the binding commits: the detach
+        // that the metadata update schedules will terminate the calling
+        // session, and a durably queued message is what guarantees the thread
+        // re-launches inside the worktree. When the dying run reaches a
+        // terminal state the orchestrator promotes the queued run, which
+        // derives its cwd from the updated projection.
+        // suspend: build the send effect only when the binding has succeeded,
+        // so a failed dispatch never even constructs the continuation call.
+        const queueContinuation: Effect.Effect<WorktreeMcpContinuationStatus, WorktreeMcpFailure> =
+          Effect.suspend(() =>
+            input.continuationPrompt === undefined
+              ? Effect.succeed<WorktreeMcpContinuationStatus>({ status: "skipped" })
+              : threadManagement
+                  .sendToThread({
+                    projectId: projection.thread.projectId,
+                    commandId: ids.continuationCommandId,
+                    threadId: scope.threadId,
+                    messageId: ids.continuationMessageId,
+                    text: input.continuationPrompt,
+                    attachments: [],
+                    mode: "queue",
+                    createdBy: "agent",
+                    creationSource: "mcp",
+                  })
+                  .pipe(
+                    Effect.map(
+                      (sendResult): WorktreeMcpContinuationStatus => ({
+                        status: "scheduled",
+                        delivery: sendResult.delivery,
+                      }),
+                    ),
+                    // catchCause via reportFailed: the binding is already recorded,
+                    // so a failed continuation must be reported, not fail the handoff.
+                    reportFailed("worktree handoff continuation failed to queue"),
+                  ),
+          );
+
+        const continuation = yield* recheckAndBind.pipe(Effect.andThen(queueContinuation));
+
+        yield* vcsStatusBroadcaster
+          .refreshStatus(worktreePath)
+          .pipe(Effect.ignoreCause({ log: true }), Effect.forkDetach);
+
+        let setupScript: WorktreeMcpSetupScriptStatus = { status: "skipped" };
+        if (input.runSetupScript ?? true) {
+          setupScript = yield* setupScriptRunner
+            .runForThread({
+              threadId: scope.threadId,
+              projectId: projection.thread.projectId,
+              projectCwd,
+              worktreePath,
+              project: {
+                workspaceRoot: project.workspaceRoot,
+                scripts: project.scripts,
+              },
+            })
+            .pipe(
+              Effect.map(
+                (result): WorktreeMcpSetupScriptStatus =>
+                  result.status === "started"
+                    ? {
+                        status: "started",
+                        scriptName: result.scriptName,
+                        terminalId: result.terminalId,
+                      }
+                    : { status: "no-script" },
+              ),
+              // catchCause via reportFailed: the thread is already re-pointed at the
+              // worktree, so even a defect in the setup runner must not fail the handoff.
+              reportFailed("worktree handoff setup script failed"),
+            );
+        }
+
+        const result: WorktreeMcpHandoffResult = {
+          worktreePath,
+          branch: worktree.worktree.refName,
+          baseRef,
+          startedFromOrigin: startFromOrigin,
+          setupScript,
+          continuation,
+          note:
+            continuation.status === "scheduled"
+              ? "Handoff recorded. Changing the workspace detaches this provider session, so the current turn ends shortly after this call; the queued continuation prompt then starts the next turn inside the worktree with the conversation preserved. The worktree is not removed automatically when the thread is deleted."
+              : "Handoff recorded. Changing the workspace detaches this provider session, so the current turn ends shortly after this call; the conversation continues inside the worktree when the thread receives its next message. Pass continuationPrompt to resume automatically. The worktree is not removed automatically when the thread is deleted.",
+        };
+        return result;
+      }),
+    );
+  });
+
+  const handoff: WorktreeMcpService["Service"]["handoff"] = Effect.fn("WorktreeMcpService.handoff")(
+    function* (scope, input) {
+      yield* requireCapability(scope);
+      // uninterruptibleMask: the guard acquisition and the registration of the
+      // releasing finalizer happen with no interruptible gap in between. An
+      // interrupt landing between a bare add() and the start of an ensured
+      // effect would otherwise leak the guard entry and block every future
+      // handoff for this thread until restart.
+      return yield* Effect.uninterruptibleMask((restore) =>
+        Effect.suspend(() => {
+          if (handoffThreadsInFlight.has(scope.threadId)) {
+            return Effect.fail(
+              failure(
+                "handoff_in_progress",
+                `A worktree handoff is already in progress for thread '${scope.threadId}'.`,
+              ),
+            );
+          }
+          handoffThreadsInFlight.add(scope.threadId);
+          return restore(performHandoff(scope, input)).pipe(
+            Effect.ensuring(Effect.sync(() => handoffThreadsInFlight.delete(scope.threadId))),
+          );
+        }),
+      );
+    },
+  );
+
+  const status: WorktreeMcpService["Service"]["status"] = Effect.fn("WorktreeMcpService.status")(
+    function* (scope) {
+      yield* requireCapability(scope);
+      const projection = yield* loadThread(scope);
+      const project = yield* loadProject(scope, projection.thread.projectId);
+
+      const defaultStartFromOrigin = yield* readDefaultStartFromOrigin;
+
+      const result: WorktreeMcpStatusResult = {
+        attached: projection.thread.worktreePath !== null,
+        worktreePath: projection.thread.worktreePath,
+        branch: projection.thread.branch,
+        projectWorkspaceRoot: project.workspaceRoot,
+        defaultStartFromOrigin,
+      };
+      return result;
+    },
+  );
+
+  return WorktreeMcpService.of({ handoff, status });
+});
+
+export const layer: Layer.Layer<
+  WorktreeMcpService,
+  never,
+  | Crypto.Crypto
+  | Path.Path
+  | ThreadManagementService
+  | ProjectService.ProjectService
+  | ServerSettings.ServerSettingsService
+  | GitWorkflowService.GitWorkflowService
+  | ProjectSetupScriptRunner.ProjectSetupScriptRunner
+  | VcsStatusBroadcaster.VcsStatusBroadcaster
+> = Layer.effect(WorktreeMcpService, make);
diff --git a/apps/server/src/mcp/toolkits/orchestrator/handlers.ts b/apps/server/src/mcp/toolkits/orchestrator/handlers.ts
new file mode 100644
index 000000000000..ab9f55341822
--- /dev/null
+++ b/apps/server/src/mcp/toolkits/orchestrator/handlers.ts
@@ -0,0 +1,114 @@
+import { OrchestratorToolkit } from "./tools.ts";
+import * as Effect from "effect/Effect";
+
+import { McpInvocationContext } from "../../McpInvocationContext.ts";
+import { OrchestratorMcpService } from "../../OrchestratorMcpService.ts";
+
+const handlers = {
+  orchestrator_capabilities: () =>
+    Effect.gen(function* () {
+      const scope = yield* McpInvocationContext;
+      const service = yield* OrchestratorMcpService;
+      return yield* service.capabilities(scope);
+    }),
+  delegate_task: (input) =>
+    Effect.gen(function* () {
+      const scope = yield* McpInvocationContext;
+      const service = yield* OrchestratorMcpService;
+      return yield* service.delegateTask(scope, input);
+    }),
+  task_status: ({ taskId }) =>
+    Effect.gen(function* () {
+      const scope = yield* McpInvocationContext;
+      const service = yield* OrchestratorMcpService;
+      return yield* service.taskStatus(scope, taskId);
+    }),
+  task_cancel: (input) =>
+    Effect.gen(function* () {
+      const scope = yield* McpInvocationContext;
+      const service = yield* OrchestratorMcpService;
+      return yield* service.cancelTask(scope, input);
+    }),
+  schedule_task: (input) =>
+    Effect.gen(function* () {
+      const scope = yield* McpInvocationContext;
+      const service = yield* OrchestratorMcpService;
+      return yield* service.scheduleTask(scope, input);
+    }),
+  list_scheduled_tasks: () =>
+    Effect.gen(function* () {
+      const scope = yield* McpInvocationContext;
+      const service = yield* OrchestratorMcpService;
+      return yield* service.listScheduledTasks(scope);
+    }),
+  update_scheduled_task: (input) =>
+    Effect.gen(function* () {
+      const scope = yield* McpInvocationContext;
+      const service = yield* OrchestratorMcpService;
+      return yield* service.updateScheduledTask(scope, input);
+    }),
+  delete_scheduled_task: (input) =>
+    Effect.gen(function* () {
+      const scope = yield* McpInvocationContext;
+      const service = yield* OrchestratorMcpService;
+      return yield* service.deleteScheduledTask(scope, input);
+    }),
+  create_threads: (input) =>
+    Effect.gen(function* () {
+      const scope = yield* McpInvocationContext;
+      const service = yield* OrchestratorMcpService;
+      return yield* service.createThreads(scope, input);
+    }),
+  t3_thread_start: (input) =>
+    Effect.gen(function* () {
+      const scope = yield* McpInvocationContext;
+      const service = yield* OrchestratorMcpService;
+      const result = yield* service.createThreads(scope, {
+        ...(input.clientRequestId === undefined ? {} : { clientRequestId: input.clientRequestId }),
+        threads: [
+          {
+            prompt: input.prompt,
+            ...(input.title === undefined ? {} : { title: input.title }),
+            ...(input.target === undefined ? {} : { target: input.target }),
+            ...(input.runtimeMode === undefined ? {} : { runtimeMode: input.runtimeMode }),
+            ...(input.interactionMode === undefined
+              ? {}
+              : { interactionMode: input.interactionMode }),
+          },
+        ],
+      });
+      return result.threads[0]!;
+    }),
+  t3_thread_list: (input) =>
+    Effect.gen(function* () {
+      const scope = yield* McpInvocationContext;
+      const service = yield* OrchestratorMcpService;
+      return yield* service.listThreads(scope, input);
+    }),
+  t3_thread_read: (input) =>
+    Effect.gen(function* () {
+      const scope = yield* McpInvocationContext;
+      const service = yield* OrchestratorMcpService;
+      return yield* service.readThread(scope, input);
+    }),
+  t3_thread_send: (input) =>
+    Effect.gen(function* () {
+      const scope = yield* McpInvocationContext;
+      const service = yield* OrchestratorMcpService;
+      return yield* service.sendToThread(scope, input);
+    }),
+  t3_thread_wait: (input) =>
+    Effect.gen(function* () {
+      const scope = yield* McpInvocationContext;
+      const service = yield* OrchestratorMcpService;
+      return yield* service.waitForThread(scope, input);
+    }),
+  t3_thread_interrupt: (input) =>
+    Effect.gen(function* () {
+      const scope = yield* McpInvocationContext;
+      const service = yield* OrchestratorMcpService;
+      return yield* service.interruptThread(scope, input);
+    }),
+} satisfies Parameters<typeof OrchestratorToolkit.toLayer>[0];
+
+export const OrchestratorToolkitHandlersLive = OrchestratorToolkit.toLayer(handlers);
diff --git a/apps/server/src/mcp/toolkits/orchestrator/tools.test.ts b/apps/server/src/mcp/toolkits/orchestrator/tools.test.ts
new file mode 100644
index 000000000000..9d7294e6356e
--- /dev/null
+++ b/apps/server/src/mcp/toolkits/orchestrator/tools.test.ts
@@ -0,0 +1,28 @@
+import { assert, describe, it } from "@effect/vitest";
+import { Tool } from "effect/unstable/ai";
+
+import { CreateThreadsTool, DelegateTaskTool, ScheduleTaskTool } from "./tools.ts";
+
+describe("orchestrator MCP tool guidance", () => {
+  it("directs subagent requests to delegation instead of ordinary threads", () => {
+    assert.include(DelegateTaskTool.description ?? "", "child agent/subagent");
+    assert.include(DelegateTaskTool.description ?? "", "cross-provider");
+    assert.include(CreateThreadsTool.description ?? "", "not delegation");
+    assert.include(CreateThreadsTool.description ?? "", "call delegate_task");
+  });
+
+  it("publishes an actionable schedule schema and compatibility string branch", () => {
+    const schema = Tool.getJsonSchema(ScheduleTaskTool) as {
+      readonly type?: unknown;
+      readonly properties?: Readonly<
+        Record<string, { readonly description?: unknown; readonly anyOf?: ReadonlyArray<unknown> }>
+      >;
+    };
+
+    assert.equal(schema.type, "object");
+    assert.isString(schema.properties?.schedule?.description);
+    assert.isAtLeast(schema.properties?.schedule?.anyOf?.length ?? 0, 2);
+    assert.include(ScheduleTaskTool.description ?? "", "STRUCTURED OBJECT");
+    assert.include(ScheduleTaskTool.description ?? "", "nextRunAt");
+  });
+});
diff --git a/apps/server/src/mcp/toolkits/orchestrator/tools.ts b/apps/server/src/mcp/toolkits/orchestrator/tools.ts
new file mode 100644
index 000000000000..9a453695ad30
--- /dev/null
+++ b/apps/server/src/mcp/toolkits/orchestrator/tools.ts
@@ -0,0 +1,248 @@
+import {
+  OrchestratorMcpCapabilitiesResult,
+  OrchestratorMcpCreatedThread,
+  OrchestratorMcpCreateThreadsInput,
+  OrchestratorMcpCreateThreadsResult,
+  OrchestratorMcpDelegateTaskInput,
+  OrchestratorMcpDelegateTaskResult,
+  OrchestratorMcpDeleteScheduledTaskInput,
+  OrchestratorMcpDeleteScheduledTaskResult,
+  OrchestratorMcpFailure,
+  OrchestratorMcpListScheduledTasksResult,
+  OrchestratorMcpScheduleTaskInput,
+  OrchestratorMcpScheduleTaskResult,
+  OrchestratorMcpTaskCancelInput,
+  OrchestratorMcpTaskCancelResult,
+  OrchestratorMcpUpdateScheduledTaskInput,
+  OrchestratorMcpTaskStatusInput,
+  OrchestratorMcpThreadInterruptInput,
+  OrchestratorMcpThreadInterruptResult,
+  OrchestratorMcpThreadListInput,
+  OrchestratorMcpThreadListResult,
+  OrchestratorMcpThreadReadInput,
+  OrchestratorMcpThreadReadResult,
+  OrchestratorMcpThreadSendInput,
+  OrchestratorMcpThreadSendResult,
+  OrchestratorMcpThreadStartInput,
+  OrchestratorMcpThreadWaitInput,
+  OrchestratorMcpThreadWaitResult,
+} from "@t3tools/contracts";
+import { Tool, Toolkit } from "effect/unstable/ai";
+
+import * as McpInvocationContext from "../../McpInvocationContext.ts";
+import { OrchestratorMcpService } from "../../OrchestratorMcpService.ts";
+
+const dependencies = [McpInvocationContext.McpInvocationContext, OrchestratorMcpService];
+
+export const OrchestratorCapabilitiesTool = Tool.make("orchestrator_capabilities", {
+  description:
+    "List the V2 provider instances, models, inherited runtime settings, and app-owned orchestration features available to this T3 thread.",
+  success: OrchestratorMcpCapabilitiesResult,
+  failure: OrchestratorMcpFailure,
+  failureMode: "return",
+  dependencies,
+})
+  .annotate(Tool.Title, "Get orchestration capabilities")
+  .annotate(Tool.Readonly, true)
+  .annotate(Tool.Destructive, false)
+  .annotate(Tool.Idempotent, true);
+
+export const DelegateTaskTool = Tool.make("delegate_task", {
+  description:
+    "Delegate one task to a T3-owned child agent/subagent of THIS thread and run it with only the supplied task prompt, without copying parent conversation history. Use this whenever the user asks for an agent, subagent, worker, delegated task, or parallel help—including cross-provider work. The childThreadId is backing storage, not an ordinary top-level thread. Provider, model, model options (see orchestrator_capabilities), runtime mode, and interaction mode inherit unless target overrides them. Prefer mode='async' for long work; mode='wait' blocks until completion or timeout. An async child's completion wakes this thread with a continuation message naming the task (queued behind any turn in progress), so end the turn instead of polling or spawning watchers; use task_status only when the result is needed mid-turn.",
+  parameters: OrchestratorMcpDelegateTaskInput,
+  success: OrchestratorMcpDelegateTaskResult,
+  failure: OrchestratorMcpFailure,
+  failureMode: "return",
+  dependencies,
+})
+  .annotate(Tool.Title, "Delegate a child task")
+  .annotate(Tool.Destructive, true)
+  .annotate(Tool.OpenWorld, true);
+
+export const TaskStatusTool = Tool.make("task_status", {
+  description:
+    "Read the latest durable state and final summary for a T3-owned delegated task created by this parent thread. Reading a terminal result acknowledges its automatic parent delivery.",
+  parameters: OrchestratorMcpTaskStatusInput,
+  success: OrchestratorMcpDelegateTaskResult,
+  failure: OrchestratorMcpFailure,
+  failureMode: "return",
+  dependencies,
+})
+  .annotate(Tool.Title, "Get delegated task status")
+  .annotate(Tool.Readonly, false)
+  .annotate(Tool.Destructive, false)
+  .annotate(Tool.Idempotent, true);
+
+export const TaskCancelTool = Tool.make("task_cancel", {
+  description:
+    "Request interruption of an active T3-owned delegated task and dispose its automatic parent delivery. Completed task results remain available.",
+  parameters: OrchestratorMcpTaskCancelInput,
+  success: OrchestratorMcpTaskCancelResult,
+  failure: OrchestratorMcpFailure,
+  failureMode: "return",
+  dependencies,
+})
+  .annotate(Tool.Title, "Cancel delegated task")
+  .annotate(Tool.Destructive, true);
+
+export const ScheduleTaskTool = Tool.make("schedule_task", {
+  description:
+    "Create persistent recurring work in the app scheduler, which runs even when no turn is active. Pass schedule as a STRUCTURED OBJECT, never JSON text: {type:'interval', everyMs:3600000} means hourly; {type:'fixed_time', timeOfDay:'09:00', weekdays:[1,2,3,4,5]} means weekday mornings. By default (bindToCurrentThread=true) each run posts into THIS thread; use false only when the user wants a fresh top-level thread per run. Provider, model, and runtime settings inherit from this thread. Report the returned schedule and nextRunAt after success.",
+  parameters: OrchestratorMcpScheduleTaskInput,
+  success: OrchestratorMcpScheduleTaskResult,
+  failure: OrchestratorMcpFailure,
+  failureMode: "return",
+  dependencies,
+})
+  .annotate(Tool.Title, "Schedule a recurring task")
+  .annotate(Tool.Destructive, true)
+  .annotate(Tool.OpenWorld, true);
+
+export const ListScheduledTasksTool = Tool.make("list_scheduled_tasks", {
+  description:
+    "List the recurring scheduled tasks in the calling thread's project, including their id, schedule, prompt, enabled state, bound thread, next run time, and last run status. Use the returned scheduledTaskId with update_scheduled_task or delete_scheduled_task.",
+  success: OrchestratorMcpListScheduledTasksResult,
+  failure: OrchestratorMcpFailure,
+  failureMode: "return",
+  dependencies,
+})
+  .annotate(Tool.Title, "List scheduled tasks")
+  .annotate(Tool.Readonly, true)
+  .annotate(Tool.Destructive, false)
+  .annotate(Tool.Idempotent, true);
+
+export const UpdateScheduledTaskTool = Tool.make("update_scheduled_task", {
+  description:
+    "Update an existing scheduled task by scheduledTaskId (from list_scheduled_tasks). Only the provided fields change; omit a field to leave it as-is. Use enabled=false to pause a task without deleting it. Set bindToCurrentThread to move the task between posting into this thread and launching a fresh thread per run.",
+  parameters: OrchestratorMcpUpdateScheduledTaskInput,
+  success: OrchestratorMcpScheduleTaskResult,
+  failure: OrchestratorMcpFailure,
+  failureMode: "return",
+  dependencies,
+})
+  .annotate(Tool.Title, "Update a scheduled task")
+  .annotate(Tool.Destructive, true);
+
+export const DeleteScheduledTaskTool = Tool.make("delete_scheduled_task", {
+  description:
+    "Permanently delete a scheduled task by scheduledTaskId (from list_scheduled_tasks). The task stops running immediately. To keep it but stop runs, use update_scheduled_task with enabled=false instead.",
+  parameters: OrchestratorMcpDeleteScheduledTaskInput,
+  success: OrchestratorMcpDeleteScheduledTaskResult,
+  failure: OrchestratorMcpFailure,
+  failureMode: "return",
+  dependencies,
+})
+  .annotate(Tool.Title, "Delete a scheduled task")
+  .annotate(Tool.Destructive, true);
+
+export const CreateThreadsTool = Tool.make("create_threads", {
+  description:
+    "Create one or more ORDINARY TOP-LEVEL T3 conversations. This is not delegation and does not create child agents/subagents. If the user asks for agents, subagents, workers, delegation, or parallel help, call delegate_task once per child instead—even when selecting different providers. Use create_threads only when the user explicitly asks for separate/new/top-level threads or conversations. Each entry may override provider, model, options, runtime mode, and interaction mode; omitted settings inherit.",
+  parameters: OrchestratorMcpCreateThreadsInput,
+  success: OrchestratorMcpCreateThreadsResult,
+  failure: OrchestratorMcpFailure,
+  failureMode: "return",
+  dependencies,
+})
+  .annotate(Tool.Title, "Create T3 threads")
+  .annotate(Tool.Destructive, true)
+  .annotate(Tool.OpenWorld, true);
+
+export const ThreadStartTool = Tool.make("t3_thread_start", {
+  description:
+    "Create an ordinary TOP-LEVEL T3 conversation and immediately start its first turn. This is not a child agent/subagent; use delegate_task for delegated work. The new thread inherits this thread's project, checkout, provider, model, and runtime settings unless overridden. Use t3_thread_wait and t3_thread_read to collect its result.",
+  parameters: OrchestratorMcpThreadStartInput,
+  success: OrchestratorMcpCreatedThread,
+  failure: OrchestratorMcpFailure,
+  failureMode: "return",
+  dependencies,
+})
+  .annotate(Tool.Title, "Start a T3 thread")
+  .annotate(Tool.Destructive, true)
+  .annotate(Tool.OpenWorld, true);
+
+export const ThreadListTool = Tool.make("t3_thread_list", {
+  description:
+    "List T3 threads in the calling thread's project, newest first. Filter by durable run status or title and paginate with the returned cursor. Threads from other projects are never exposed.",
+  parameters: OrchestratorMcpThreadListInput,
+  success: OrchestratorMcpThreadListResult,
+  failure: OrchestratorMcpFailure,
+  failureMode: "return",
+  dependencies,
+})
+  .annotate(Tool.Title, "List T3 threads")
+  .annotate(Tool.Readonly, true)
+  .annotate(Tool.Destructive, false)
+  .annotate(Tool.Idempotent, true);
+
+export const ThreadReadTool = Tool.make("t3_thread_read", {
+  description:
+    "Read durable state and a paginated timeline from a T3 thread in the calling project. The default messages view returns user messages, assistant messages, and proposed plans; activity returns all summarized timeline items. Reading an untruncated terminal assistant result from this parent thread's direct app-owned child acknowledges that child's automatic completion delivery. Continue with afterPosition=nextPosition.",
+  parameters: OrchestratorMcpThreadReadInput,
+  success: OrchestratorMcpThreadReadResult,
+  failure: OrchestratorMcpFailure,
+  failureMode: "return",
+  dependencies,
+})
+  .annotate(Tool.Title, "Read a T3 thread")
+  .annotate(Tool.Readonly, false)
+  .annotate(Tool.Destructive, false)
+  .annotate(Tool.Idempotent, true);
+
+export const ThreadSendTool = Tool.make("t3_thread_send", {
+  description:
+    "Send a message to a T3 thread in the calling project. mode='auto' starts an idle thread, steers a fully active turn, or queues behind a turn that is not yet steerable. Use queue for a separate follow-up turn, steer for an in-flight update, or restart to interrupt-and-restart the active turn. clientRequestId makes retries idempotent.",
+  parameters: OrchestratorMcpThreadSendInput,
+  success: OrchestratorMcpThreadSendResult,
+  failure: OrchestratorMcpFailure,
+  failureMode: "return",
+  dependencies,
+})
+  .annotate(Tool.Title, "Send to a T3 thread")
+  .annotate(Tool.Destructive, true)
+  .annotate(Tool.OpenWorld, true);
+
+export const ThreadWaitTool = Tool.make("t3_thread_wait", {
+  description:
+    "Wait for a T3 thread run to reach a terminal durable state. Without runId, the latest run at call time is selected; an idle thread returns immediately. Timeout does not interrupt work, so call again or use t3_thread_read/list after timedOut=true. Waiting reports status only and does not acknowledge a delegated result.",
+  parameters: OrchestratorMcpThreadWaitInput,
+  success: OrchestratorMcpThreadWaitResult,
+  failure: OrchestratorMcpFailure,
+  failureMode: "return",
+  dependencies,
+})
+  .annotate(Tool.Title, "Wait for a T3 thread")
+  .annotate(Tool.Readonly, true)
+  .annotate(Tool.Destructive, false)
+  .annotate(Tool.Idempotent, true);
+
+export const ThreadInterruptTool = Tool.make("t3_thread_interrupt", {
+  description:
+    "Request interruption of a running turn in a T3 thread in the calling project. Without runId, the newest interruptible run is selected. Terminal runs and threads without an active turn return without another side effect. clientRequestId makes retries idempotent.",
+  parameters: OrchestratorMcpThreadInterruptInput,
+  success: OrchestratorMcpThreadInterruptResult,
+  failure: OrchestratorMcpFailure,
+  failureMode: "return",
+  dependencies,
+})
+  .annotate(Tool.Title, "Interrupt a T3 thread")
+  .annotate(Tool.Destructive, true);
+
+export const OrchestratorToolkit = Toolkit.make(
+  OrchestratorCapabilitiesTool,
+  DelegateTaskTool,
+  TaskStatusTool,
+  TaskCancelTool,
+  ScheduleTaskTool,
+  ListScheduledTasksTool,
+  UpdateScheduledTaskTool,
+  DeleteScheduledTaskTool,
+  CreateThreadsTool,
+  ThreadStartTool,
+  ThreadListTool,
+  ThreadReadTool,
+  ThreadSendTool,
+  ThreadWaitTool,
+  ThreadInterruptTool,
+);
diff --git a/apps/server/src/mcp/toolkits/worktree/handlers.ts b/apps/server/src/mcp/toolkits/worktree/handlers.ts
new file mode 100644
index 000000000000..b75e0c5dfbef
--- /dev/null
+++ b/apps/server/src/mcp/toolkits/worktree/handlers.ts
@@ -0,0 +1,22 @@
+import * as Effect from "effect/Effect";
+
+import { McpInvocationContext } from "../../McpInvocationContext.ts";
+import { WorktreeMcpService } from "../../WorktreeMcpService.ts";
+import { WorktreeToolkit } from "./tools.ts";
+
+const handlers = {
+  t3_worktree_handoff: (input) =>
+    Effect.gen(function* () {
+      const scope = yield* McpInvocationContext;
+      const service = yield* WorktreeMcpService;
+      return yield* service.handoff(scope, input);
+    }),
+  t3_worktree_status: () =>
+    Effect.gen(function* () {
+      const scope = yield* McpInvocationContext;
+      const service = yield* WorktreeMcpService;
+      return yield* service.status(scope);
+    }),
+} satisfies Parameters<typeof WorktreeToolkit.toLayer>[0];
+
+export const WorktreeToolkitHandlersLive = WorktreeToolkit.toLayer(handlers);
diff --git a/apps/server/src/mcp/toolkits/worktree/registration.test.ts b/apps/server/src/mcp/toolkits/worktree/registration.test.ts
new file mode 100644
index 000000000000..3300a869fe67
--- /dev/null
+++ b/apps/server/src/mcp/toolkits/worktree/registration.test.ts
@@ -0,0 +1,137 @@
+import { expect, it } from "@effect/vitest";
+import { NodeHttpServer } from "@effect/platform-node";
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import { ProviderInstanceId, ThreadId } from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Schema from "effect/Schema";
+import { HttpBody, HttpClient, HttpRouter } from "effect/unstable/http";
+
+import * as ServerEnvironment from "../../../environment/ServerEnvironment.ts";
+import * as GitWorkflowService from "../../../git/GitWorkflowService.ts";
+import { ThreadManagementService } from "../../../orchestration-v2/ThreadManagementService.ts";
+import * as ProjectService from "../../../project/ProjectService.ts";
+import * as ProjectSetupScriptRunner from "../../../project/ProjectSetupScriptRunner.ts";
+import { ProviderRegistry } from "../../../provider/Services/ProviderRegistry.ts";
+import { ScheduledTaskService } from "../../../scheduledTasks/ScheduledTaskService.ts";
+import * as ServerSettings from "../../../serverSettings.ts";
+import { VcsStatusBroadcaster } from "../../../vcs/VcsStatusBroadcaster.ts";
+import * as McpHttpServer from "../../McpHttpServer.ts";
+import * as McpSessionRegistry from "../../McpSessionRegistry.ts";
+import * as PreviewAutomationBroker from "../../PreviewAutomationBroker.ts";
+
+const StubServicesLive = Layer.mergeAll(
+  Layer.mock(ThreadManagementService)({}),
+  Layer.mock(ProviderRegistry)({}),
+  Layer.mock(ScheduledTaskService)({}),
+  Layer.mock(ProjectService.ProjectService)({}),
+  ServerSettings.layerTest({}),
+  Layer.mock(GitWorkflowService.GitWorkflowService)({}),
+  Layer.mock(ProjectSetupScriptRunner.ProjectSetupScriptRunner)({}),
+  Layer.mock(VcsStatusBroadcaster)({}),
+);
+
+const ToolsListPayload = Schema.fromJsonString(
+  Schema.Struct({
+    result: Schema.Struct({
+      tools: Schema.Array(
+        Schema.Struct({
+          name: Schema.String,
+          inputSchema: Schema.Struct({ type: Schema.optional(Schema.String) }),
+          annotations: Schema.optional(
+            Schema.Struct({
+              readOnlyHint: Schema.optional(Schema.Boolean),
+              destructiveHint: Schema.optional(Schema.Boolean),
+              openWorldHint: Schema.optional(Schema.Boolean),
+            }),
+          ),
+        }),
+      ),
+    }),
+  }),
+);
+const decodeToolsListPayload = Schema.decodeUnknownEffect(ToolsListPayload);
+
+it.effect("production mcp layer lists worktree tools over http", () =>
+  Effect.scoped(
+    Effect.gen(function* () {
+      const routes = McpHttpServer.layer.pipe(Layer.provide(McpSessionRegistry.layer));
+      yield* HttpRouter.serve(routes, {
+        disableListenLog: true,
+        disableLogger: true,
+      }).pipe(
+        Layer.provide(
+          Layer.mock(ServerEnvironment.ServerEnvironment)({
+            getEnvironmentId: Effect.succeed("environment-scratch" as never),
+          }),
+        ),
+        Layer.provide(PreviewAutomationBroker.layer),
+        Layer.provide(StubServicesLive),
+        Layer.build,
+      );
+
+      const registry = McpSessionRegistry.issueActiveMcpCredential({
+        threadId: ThreadId.make("thread-scratch"),
+        providerInstanceId: ProviderInstanceId.make("claudeAgent"),
+      });
+      const credential = yield* registry;
+      expect(credential).toBeDefined();
+
+      const httpClient = yield* HttpClient.HttpClient;
+      const auth = credential!.config.authorizationHeader;
+      const initResponse = yield* httpClient.post("/mcp", {
+        headers: {
+          accept: "application/json, text/event-stream",
+          authorization: auth,
+        },
+        body: HttpBody.text(
+          `{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"scratch","version":"1.0.0"}}}`,
+          "application/json",
+        ),
+      });
+      expect(initResponse.status).toBe(200);
+      const sessionId = initResponse.headers["mcp-session-id"];
+
+      const listResponse = yield* httpClient.post("/mcp", {
+        headers: {
+          accept: "application/json, text/event-stream",
+          authorization: auth,
+          "mcp-protocol-version": "2025-06-18",
+          ...(sessionId ? { "mcp-session-id": sessionId } : {}),
+        },
+        body: HttpBody.text(
+          `{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}`,
+          "application/json",
+        ),
+      });
+      const bodyText = yield* listResponse.text;
+      const payload = yield* decodeToolsListPayload(bodyText.match(/\{.*\}/s)![0]);
+      const tools = payload.result.tools;
+      const toolNames = tools.map((tool) => tool.name);
+      expect(toolNames).toContain("t3_worktree_handoff");
+      expect(toolNames).toContain("t3_worktree_status");
+      // The worktree registration merges alongside the other toolkits rather
+      // than replacing them.
+      expect(toolNames).toContain("preview_status");
+      expect(toolNames).toContain("delegate_task");
+
+      // The handoff tool mutates thread state, reaches the network (origin
+      // fetch), and runs project setup scripts, so its MCP hints must not
+      // promise a read-only, closed-world, non-destructive tool.
+      const handoff = tools.find((tool) => tool.name === "t3_worktree_handoff");
+      expect(handoff?.annotations?.readOnlyHint).toBe(false);
+      expect(handoff?.annotations?.destructiveHint).toBe(true);
+      expect(handoff?.annotations?.openWorldHint).toBe(true);
+      const status = tools.find((tool) => tool.name === "t3_worktree_status");
+      expect(status?.annotations?.readOnlyHint).toBe(true);
+      expect(status?.annotations?.destructiveHint).toBe(false);
+
+      // MCP requires every tool input schema to be a top-level object schema.
+      // A non-object schema (e.g. the anyOf produced by an empty
+      // Schema.Struct({})) makes clients reject the entire server.
+      for (const tool of tools) {
+        expect(tool.inputSchema.type, `inputSchema.type of ${tool.name}`).toBe("object");
+      }
+    }),
+  ).pipe(Effect.provide(Layer.mergeAll(NodeHttpServer.layerTest, NodeServices.layer))),
+);
diff --git a/apps/server/src/mcp/toolkits/worktree/tools.ts b/apps/server/src/mcp/toolkits/worktree/tools.ts
new file mode 100644
index 000000000000..69a33cb79d07
--- /dev/null
+++ b/apps/server/src/mcp/toolkits/worktree/tools.ts
@@ -0,0 +1,47 @@
+import {
+  WorktreeMcpFailure,
+  WorktreeMcpHandoffInput,
+  WorktreeMcpHandoffResult,
+  WorktreeMcpStatusResult,
+} from "@t3tools/contracts";
+import { Tool, Toolkit } from "effect/unstable/ai";
+
+import * as McpInvocationContext from "../../McpInvocationContext.ts";
+import { WorktreeMcpService } from "../../WorktreeMcpService.ts";
+
+const dependencies = [McpInvocationContext.McpInvocationContext, WorktreeMcpService];
+
+export const WorktreeHandoffTool = Tool.make("t3_worktree_handoff", {
+  description:
+    "Move this agent thread into a new git worktree. Creates the worktree branch (optionally from origin), re-points the thread at the worktree, and by default runs the project's setup script there. Changing the workspace detaches the live provider session, so the current turn ends shortly after the handoff is recorded; call this as the last action of the turn. To keep working after the handoff, pass continuationPrompt with the remaining work: it is queued as the thread's next message and starts a new turn inside the worktree with the conversation preserved. Without it the thread stays idle until the next message. The worktree is not removed automatically when the thread is deleted. Fails if the thread is already attached to a worktree.",
+  parameters: WorktreeMcpHandoffInput,
+  success: WorktreeMcpHandoffResult,
+  failure: WorktreeMcpFailure,
+  failureMode: "return",
+  dependencies,
+})
+  .annotate(Tool.Title, "Hand off thread to a git worktree")
+  .annotate(Tool.Readonly, false)
+  .annotate(Tool.Destructive, true)
+  .annotate(Tool.Idempotent, false)
+  .annotate(Tool.OpenWorld, true);
+
+export const WorktreeStatusTool = Tool.make("t3_worktree_status", {
+  description:
+    "Report this agent thread's worktree binding: whether it is attached to a git worktree, the worktree path and branch, the project's main workspace root, and the server default for t3_worktree_handoff's startFromOrigin. Call this before t3_worktree_handoff to check whether a handoff is possible or has already happened.",
+  // No `parameters`: Tool.make defaults to Tool.EmptyParams, which serializes
+  // to a top-level `type: "object"` JSON Schema. An explicit empty
+  // Schema.Struct({}) serializes to `anyOf: [object, array]`, which is not a
+  // valid MCP tool input schema and makes clients reject the whole server.
+  success: WorktreeMcpStatusResult,
+  failure: WorktreeMcpFailure,
+  failureMode: "return",
+  dependencies,
+})
+  .annotate(Tool.Title, "Get thread worktree status")
+  .annotate(Tool.Readonly, true)
+  .annotate(Tool.Destructive, false)
+  .annotate(Tool.Idempotent, true)
+  .annotate(Tool.OpenWorld, false);
+
+export const WorktreeToolkit = Toolkit.make(WorktreeHandoffTool, WorktreeStatusTool);
diff --git a/apps/server/src/observability/Metrics.ts b/apps/server/src/observability/Metrics.ts
index 886833d6e2c7..16c8d0e8a25f 100644
--- a/apps/server/src/observability/Metrics.ts
+++ b/apps/server/src/observability/Metrics.ts
@@ -42,6 +42,18 @@ export const orchestrationEventsProcessedTotal = Metric.counter(
   },
 );
 
+export const orchestrationEffectClaimsTotal = Metric.counter(
+  "t3_orchestration_effect_claims_total",
+  {
+    description: "Total completed orchestration effect outbox claim attempts by result.",
+  },
+);
+
+export const orchestrationEffectQueueWait = Metric.timer("t3_orchestration_effect_queue_wait", {
+  description:
+    "Time from an orchestration effect's temporal availability until claim, including same-thread blocking.",
+});
+
 export const providerSessionsTotal = Metric.counter("t3_provider_sessions_total", {
   description: "Total provider session lifecycle operations.",
 });
diff --git a/apps/server/src/orchestration-v2/AcpRegistryOrchestratorV2.live.test.ts b/apps/server/src/orchestration-v2/AcpRegistryOrchestratorV2.live.test.ts
new file mode 100644
index 000000000000..4aa05325a21c
--- /dev/null
+++ b/apps/server/src/orchestration-v2/AcpRegistryOrchestratorV2.live.test.ts
@@ -0,0 +1,209 @@
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import { assert, it } from "@effect/vitest";
+import {
+  CommandId,
+  type ModelSelection,
+  MessageId,
+  ProjectId,
+  ProviderDriverKind,
+  ProviderInstanceId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as Console from "effect/Console";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { FetchHttpClient } from "effect/unstable/http";
+import { describe } from "vite-plus/test";
+
+import * as CheckpointStore from "../checkpointing/CheckpointStore.ts";
+import * as BackgroundPolicy from "../background/BackgroundPolicy.ts";
+import * as HostPowerMonitor from "../background/HostPowerMonitor.ts";
+import { ServerConfig } from "../config.ts";
+import { SqlitePersistenceMemory } from "../persistence/Layers/Sqlite.ts";
+import * as ModelManifest from "../provider/ModelManifest.ts";
+import { ProviderInstanceRegistryHydrationLive } from "../provider/Layers/ProviderInstanceRegistryHydration.ts";
+import {
+  NoOpProviderEventLoggers,
+  ProviderEventLoggers,
+} from "../provider/Layers/ProviderEventLoggers.ts";
+import { OpenCodeRuntimeLive } from "../provider/opencodeRuntime.ts";
+import { ServerSettingsService } from "../serverSettings.ts";
+import * as VcsDriverRegistry from "../vcs/VcsDriverRegistry.ts";
+import * as VcsProcess from "../vcs/VcsProcess.ts";
+import { OrchestratorV2 } from "./Orchestrator.ts";
+import { worktreeRepairDependenciesTestLayer } from "./ProviderTurnStartService.testkit.ts";
+import { OrchestrationV2LayerLive } from "./runtimeLayer.ts";
+import { layer as mcpSessionRegistryTestLayer } from "../mcp/McpSessionRegistry.testkit.ts";
+
+const liveAgentId = process.env.T3_ACP_REGISTRY_LIVE_AGENT_ID?.trim() || "devin";
+const liveCommandPath = process.env.T3_ACP_REGISTRY_LIVE_COMMAND?.trim();
+const liveInstanceId = ProviderInstanceId.make("acpRegistry_live");
+const liveModelSelection = {
+  instanceId: liveInstanceId,
+  model: "default",
+} satisfies ModelSelection;
+
+const serverConfigLayer = ServerConfig.layerTest(process.cwd(), {
+  prefix: "t3-acp-registry-v2-live-",
+});
+
+const vcsDriverRegistryLayer = VcsDriverRegistry.layer.pipe(
+  Layer.provide(VcsProcess.layer),
+  Layer.provide(serverConfigLayer),
+  Layer.provide(NodeServices.layer),
+);
+
+const checkpointStoreLayer = CheckpointStore.layer.pipe(Layer.provide(vcsDriverRegistryLayer));
+
+const serverSettingsLayer = ServerSettingsService.layerTest({
+  providerInstances: {
+    [liveInstanceId]: {
+      driver: ProviderDriverKind.make("acpRegistry"),
+      displayName: `ACP Registry: ${liveAgentId}`,
+      enabled: true,
+      config: {
+        agentId: liveAgentId,
+        ...(liveCommandPath ? { commandPath: liveCommandPath } : {}),
+      },
+    },
+  },
+});
+const backgroundPolicyLayer = BackgroundPolicy.layer.pipe(
+  Layer.provide(Layer.effect(HostPowerMonitor.HostPowerMonitor, HostPowerMonitor.make())),
+  Layer.provide(serverSettingsLayer),
+);
+const providerInstanceRegistryLayer = ProviderInstanceRegistryHydrationLive.pipe(
+  Layer.provide(
+    Layer.mergeAll(
+      serverConfigLayer.pipe(Layer.provide(NodeServices.layer)),
+      serverSettingsLayer,
+      NodeServices.layer,
+      FetchHttpClient.layer,
+      OpenCodeRuntimeLive.pipe(Layer.provide(NodeServices.layer)),
+      Layer.succeed(ProviderEventLoggers, NoOpProviderEventLoggers),
+      ModelManifest.layerTest,
+    ),
+  ),
+);
+
+const liveLayer = OrchestrationV2LayerLive.pipe(
+  Layer.provide(mcpSessionRegistryTestLayer),
+  Layer.provide(SqlitePersistenceMemory),
+  Layer.provide(checkpointStoreLayer),
+  Layer.provide(serverConfigLayer),
+  Layer.provide(serverSettingsLayer),
+  Layer.provide(providerInstanceRegistryLayer),
+  Layer.provide(backgroundPolicyLayer),
+  Layer.provide(worktreeRepairDependenciesTestLayer),
+  Layer.provide(NodeServices.layer),
+);
+
+const waitForIdle = Effect.fn("AcpRegistryOrchestratorV2Live.waitForIdle")(function* (
+  threadId: ThreadId,
+  expectedRunCount: number,
+) {
+  const orchestrator = yield* OrchestratorV2;
+  for (let attempt = 0; attempt < 900; attempt += 1) {
+    const projection = yield* orchestrator.getThreadProjection(threadId);
+    if (
+      projection.runs.length >= expectedRunCount &&
+      projection.runs.every(
+        (run) => !["queued", "starting", "running", "waiting"].includes(run.status),
+      )
+    ) {
+      return projection;
+    }
+    yield* Effect.sleep("500 millis");
+  }
+  return yield* Effect.die(new Error(`Timed out waiting for ACP Registry thread ${threadId}.`));
+});
+
+describe.runIf(process.env.T3_ACP_REGISTRY_LIVE_ORCHESTRATOR === "1")(
+  "ACP Registry V2 live orchestrator",
+  () => {
+    it.live(
+      "runs and resumes a real registry agent through the production V2 harness",
+      () =>
+        Effect.gen(function* () {
+          const orchestrator = yield* OrchestratorV2;
+          const projectId = ProjectId.make("project:acp-registry-live");
+          const threadId = ThreadId.make("thread:acp-registry-live");
+          const marker = "ACP_REGISTRY_LIVE_7H3Q";
+
+          yield* orchestrator.dispatch({
+            type: "thread.create",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command:acp-registry-live:create"),
+            threadId,
+            projectId,
+            title: `ACP Registry live: ${liveAgentId}`,
+            modelSelection: liveModelSelection,
+            runtimeMode: "full-access",
+            interactionMode: "default",
+            branch: null,
+            worktreePath: null,
+          });
+          yield* Console.log(
+            `ACP Registry thread created for '${liveAgentId}'; dispatching first prompt.`,
+          );
+          yield* orchestrator.dispatch({
+            type: "message.dispatch",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command:acp-registry-live:first"),
+            threadId,
+            messageId: MessageId.make("message:acp-registry-live:first"),
+            text: `Remember this opaque marker. Respond with exactly: ${marker}`,
+            attachments: [],
+            modelSelection: liveModelSelection,
+            dispatchMode: { type: "start_immediately" },
+          });
+          const firstProjection = yield* waitForIdle(threadId, 1);
+          const firstAssistant = firstProjection.messages.findLast(
+            (message) => message.role === "assistant",
+          )?.text;
+
+          assert.deepEqual(
+            firstProjection.runs.map((run) => [run.providerInstanceId, run.status]),
+            [[liveInstanceId, "completed"]],
+          );
+          assert.include(firstAssistant ?? "", marker);
+
+          yield* Console.log("First ACP turn completed; dispatching continuation prompt.");
+          yield* orchestrator.dispatch({
+            type: "message.dispatch",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command:acp-registry-live:second"),
+            threadId,
+            messageId: MessageId.make("message:acp-registry-live:second"),
+            text: "Return the opaque marker from the previous turn. Respond with only the marker.",
+            attachments: [],
+            modelSelection: liveModelSelection,
+            dispatchMode: { type: "start_immediately" },
+          });
+          const finalProjection = yield* waitForIdle(threadId, 2);
+          const finalAssistant = finalProjection.messages.findLast(
+            (message) => message.role === "assistant",
+          )?.text;
+
+          assert.deepEqual(
+            finalProjection.runs.map((run) => [run.providerInstanceId, run.status]),
+            [
+              [liveInstanceId, "completed"],
+              [liveInstanceId, "completed"],
+            ],
+          );
+          assert.include(finalAssistant ?? "", marker);
+          assert.deepEqual(finalProjection.providerSessions.length, 2);
+          assert.isAtLeast(finalProjection.providerThreads.length, 1);
+          assert.deepEqual(
+            finalProjection.providerTurns.map((turn) => turn.status),
+            ["completed", "completed"],
+          );
+        }).pipe(Effect.provide(liveLayer), Effect.scoped),
+      480_000,
+    );
+  },
+);
diff --git a/apps/server/src/orchestration-v2/Adapters/AcpAdapterV2.test.ts b/apps/server/src/orchestration-v2/Adapters/AcpAdapterV2.test.ts
new file mode 100644
index 000000000000..d7958b360147
--- /dev/null
+++ b/apps/server/src/orchestration-v2/Adapters/AcpAdapterV2.test.ts
@@ -0,0 +1,12118 @@
+// @effect-diagnostics nodeBuiltinImport:off
+import * as NodeChildProcess from "node:child_process";
+import * as NodeFS from "node:fs";
+import * as NodePath from "node:path";
+
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import { assert, describe, it } from "@effect/vitest";
+import {
+  EnvironmentId,
+  MessageId,
+  type ModelSelection,
+  NodeId,
+  ProjectId,
+  ProviderDriverKind,
+  ProviderInstanceId,
+  ProviderSessionId,
+  ProviderThreadId,
+  RunAttemptId,
+  RunId,
+  ThreadId,
+  type OrchestrationV2ProviderThread,
+} from "@t3tools/contracts";
+import { HostProcessPlatform } from "@t3tools/shared/hostProcess";
+import * as DateTime from "effect/DateTime";
+import * as Crypto from "effect/Crypto";
+import * as Deferred from "effect/Deferred";
+import type * as Duration from "effect/Duration";
+import * as Cause from "effect/Cause";
+import * as Clock from "effect/Clock";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as FileSystem from "effect/FileSystem";
+import * as Fiber from "effect/Fiber";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+import * as PlatformError from "effect/PlatformError";
+import * as Queue from "effect/Queue";
+import * as Schema from "effect/Schema";
+import * as Sink from "effect/Sink";
+import * as Stream from "effect/Stream";
+import * as Scope from "effect/Scope";
+import * as TestClock from "effect/testing/TestClock";
+import { ChildProcessSpawner } from "effect/unstable/process";
+import * as EffectAcpErrors from "effect-acp/errors";
+import type * as EffectAcpProtocol from "effect-acp/protocol";
+import type * as EffectAcpSchema from "effect-acp/schema";
+
+import { ServerConfig } from "../../config.ts";
+import * as McpProviderSession from "../../mcp/McpProviderSession.ts";
+import * as AcpSessionRuntime from "../../provider/acp/AcpSessionRuntime.ts";
+import {
+  extractXAiAcpSubagentEndNotice,
+  extractXAiAcpSubagentUpdate,
+  normalizeXAiAcpToolCallState,
+  registerXAiBackgroundTaskTracking,
+} from "../../provider/acp/XAiAcpExtension.ts";
+import { layer as idAllocatorLayer, IdAllocatorV2 } from "../IdAllocator.ts";
+import {
+  ProviderAdapterProtocolError,
+  ProviderAdapterV2RuntimePolicy,
+  type ProviderAdapterV2Event,
+  type ProviderAdapterV2TurnInput,
+} from "../ProviderAdapter.ts";
+import type { ProviderContinuationRequest } from "../ProviderContinuationRequests.ts";
+import {
+  AcpProviderCapabilitiesV2,
+  acpCarryoverTerminalShouldClearContinuation,
+  acpCanonicalJson,
+  acpClaimNativeTransportRequest,
+  acpPermissionDisposition,
+  acpNativeUserInputRequestMatches,
+  acpPostSettleContinuationOfferEvidence,
+  acpIsAppOwnedWakeTurn,
+  acpPostSettleMonitorPromptShouldSuppress,
+  acpPostSettleWakeEvidence,
+  acpPostSettleWakeShouldBuffer,
+  acpProjectedCommandExitCode,
+  acpTurnStartShouldPreserveContinuation,
+  makeAcpAdapterV2,
+  type AcpAdapterV2ExtensionContext,
+  type AcpAdapterV2Flavor,
+  type AcpAdapterV2RuntimeInput,
+  type AcpAdapterV2SubagentUpdate,
+} from "./AcpAdapterV2.ts";
+
+const serverConfigLayer = ServerConfig.layerTest(process.cwd(), {
+  prefix: "t3-acp-v2-adapter-",
+}).pipe(Layer.provide(NodeServices.layer));
+
+const testLayer = Layer.mergeAll(NodeServices.layer, idAllocatorLayer, serverConfigLayer);
+const ACP_TEST_DRIVER = ProviderDriverKind.make("acp-test");
+const decodeUnknownJson = Schema.decodeUnknownOption(Schema.fromJsonString(Schema.Unknown));
+
+function permissionRequest(
+  kind: NonNullable<EffectAcpSchema.RequestPermissionRequest["toolCall"]["kind"]>,
+  locations?: ReadonlyArray<EffectAcpSchema.ToolCallLocation>,
+): EffectAcpSchema.RequestPermissionRequest {
+  return {
+    options: [],
+    sessionId: "permission-session",
+    toolCall: {
+      kind,
+      ...(locations === undefined ? {} : { locations }),
+      toolCallId: "permission-tool-call",
+    },
+  };
+}
+
+describe("acpPermissionDisposition", () => {
+  const cwd = NodePath.resolve(process.cwd(), "acp-permission-workspace");
+  const writableRoot = NodePath.resolve(process.cwd(), "acp-additional-writable-root");
+  const policy = ProviderAdapterV2RuntimePolicy.make({
+    runtimeMode: "full-access",
+    interactionMode: "default",
+    cwd,
+    approvalPolicy: "never",
+    sandboxPolicy: {
+      type: "workspaceWrite",
+      writableRoots: [writableRoot],
+      networkAccess: false,
+    },
+  });
+
+  it("auto-allows mutations only when every location is in cwd or an additional writable root", () => {
+    assert.equal(
+      acpPermissionDisposition(policy, permissionRequest("edit", [{ path: "src/index.ts" }])),
+      "allow",
+    );
+    assert.equal(
+      acpPermissionDisposition(
+        policy,
+        permissionRequest("delete", [{ path: NodePath.join(writableRoot, "generated.ts") }]),
+      ),
+      "allow",
+    );
+    assert.equal(
+      acpPermissionDisposition(
+        policy,
+        permissionRequest("move", [
+          { path: NodePath.join(cwd, "from.ts") },
+          { path: NodePath.join(writableRoot, "to.ts") },
+        ]),
+      ),
+      "allow",
+    );
+  });
+
+  it("denies missing or out-of-root mutation locations", () => {
+    const outside = NodePath.resolve(process.cwd(), "outside-acp-permission-workspace", "file.ts");
+    assert.equal(acpPermissionDisposition(policy, permissionRequest("edit")), "deny");
+    assert.equal(
+      acpPermissionDisposition(policy, permissionRequest("delete", [{ path: "../escape.ts" }])),
+      "deny",
+    );
+    assert.equal(
+      acpPermissionDisposition(
+        policy,
+        permissionRequest("move", [{ path: NodePath.join(cwd, "inside.ts") }, { path: outside }]),
+      ),
+      "deny",
+    );
+  });
+
+  it("keeps non-mutating workspace permissions and denials unchanged", () => {
+    assert.equal(acpPermissionDisposition(policy, permissionRequest("read")), "allow");
+    assert.equal(acpPermissionDisposition(policy, permissionRequest("execute")), "deny");
+  });
+
+  it.effect("denies mutations through workspace symlinks that escape the writable roots", () =>
+    Effect.gen(function* () {
+      const fileSystem = yield* FileSystem.FileSystem;
+      const path = yield* Path.Path;
+      const workspace = yield* fileSystem.makeTempDirectoryScoped({
+        prefix: "t3-acp-permission-workspace-",
+      });
+      const outside = yield* fileSystem.makeTempDirectoryScoped({
+        prefix: "t3-acp-permission-outside-",
+      });
+      const outsideFile = path.join(outside, "existing.ts");
+      yield* fileSystem.writeFileString(outsideFile, "outside");
+      yield* fileSystem.symlink(outsideFile, path.join(workspace, "linked-file.ts"));
+      yield* fileSystem.symlink(outside, path.join(workspace, "linked-directory"));
+
+      const realPolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: workspace,
+        approvalPolicy: "never",
+        sandboxPolicy: {
+          type: "workspaceWrite",
+          writableRoots: [],
+          networkAccess: false,
+        },
+      });
+
+      assert.equal(
+        acpPermissionDisposition(
+          realPolicy,
+          permissionRequest("edit", [{ path: "linked-file.ts" }]),
+        ),
+        "deny",
+      );
+      assert.equal(
+        acpPermissionDisposition(
+          realPolicy,
+          permissionRequest("edit", [{ path: "linked-directory/new-file.ts" }]),
+        ),
+        "deny",
+        "a missing leaf below an escaping directory symlink must not be auto-approved",
+      );
+      assert.equal(
+        acpPermissionDisposition(
+          realPolicy,
+          permissionRequest("edit", [{ path: "linked-directory/../escaped-file.ts" }]),
+        ),
+        "deny",
+        "physical symlink traversal must be resolved before parent segments",
+      );
+    }).pipe(Effect.provide(NodeServices.layer)),
+  );
+
+  it.effect("allows existing and new files beneath canonical writable roots", () =>
+    Effect.gen(function* () {
+      const fileSystem = yield* FileSystem.FileSystem;
+      const path = yield* Path.Path;
+      const workspace = yield* fileSystem.makeTempDirectoryScoped({
+        prefix: "t3-acp-permission-workspace-",
+      });
+      const workspaceLinkParent = yield* fileSystem.makeTempDirectoryScoped({
+        prefix: "t3-acp-permission-link-parent-",
+      });
+      const workspaceLink = path.join(workspaceLinkParent, "workspace-link");
+      yield* fileSystem.makeDirectory(path.join(workspace, "src"), { recursive: true });
+      yield* fileSystem.writeFileString(path.join(workspace, "src", "existing.ts"), "existing");
+      yield* fileSystem.symlink(workspace, workspaceLink);
+
+      const realPolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: workspaceLink,
+        approvalPolicy: "never",
+        sandboxPolicy: {
+          type: "workspaceWrite",
+          writableRoots: [],
+          networkAccess: false,
+        },
+      });
+
+      assert.equal(
+        acpPermissionDisposition(
+          realPolicy,
+          permissionRequest("edit", [{ path: "src/existing.ts" }]),
+        ),
+        "allow",
+      );
+      assert.equal(
+        acpPermissionDisposition(
+          realPolicy,
+          permissionRequest("edit", [{ path: "src/generated/new-file.ts" }]),
+        ),
+        "allow",
+        "non-existent descendants of a real in-root ancestor remain writable",
+      );
+    }).pipe(Effect.provide(NodeServices.layer)),
+  );
+});
+
+describe("acpProjectedCommandExitCode", () => {
+  const successOutput = { type: "Bash", exit_code: 0 };
+  const failedOutput = { type: "Bash", exit_code: 1 };
+
+  it("omits exit codes for non-terminal and interrupted tool statuses", () => {
+    assert.equal(acpProjectedCommandExitCode("pending", successOutput), undefined);
+    assert.equal(acpProjectedCommandExitCode("running", successOutput), undefined);
+    assert.equal(acpProjectedCommandExitCode("interrupted", successOutput), undefined);
+  });
+
+  it("projects real exit codes only for completed and failed tools", () => {
+    assert.equal(acpProjectedCommandExitCode("completed", successOutput), 0);
+    assert.equal(acpProjectedCommandExitCode("completed", failedOutput), 1);
+    assert.equal(acpProjectedCommandExitCode("failed", failedOutput), 1);
+    assert.equal(acpProjectedCommandExitCode("completed", {}), undefined);
+  });
+});
+
+describe("ACP continuation ownership", () => {
+  it("preserves a continuation offered during non-buffered carryover handling", () => {
+    assert.isFalse(
+      acpCarryoverTerminalShouldClearContinuation({
+        continuationOffered: true,
+        wakeBufferLength: 0,
+      }),
+    );
+    assert.isFalse(
+      acpCarryoverTerminalShouldClearContinuation({
+        continuationOffered: false,
+        wakeBufferLength: 1,
+      }),
+    );
+    assert.isTrue(
+      acpCarryoverTerminalShouldClearContinuation({
+        continuationOffered: false,
+        wakeBufferLength: 0,
+      }),
+    );
+  });
+
+  it("preserves only user-raced offers that still own buffered wake traffic", () => {
+    assert.isTrue(
+      acpTurnStartShouldPreserveContinuation({
+        continuationRequested: true,
+        isContinuationTurn: false,
+        wakeBufferLength: 1,
+      }),
+    );
+    assert.isFalse(
+      acpTurnStartShouldPreserveContinuation({
+        continuationRequested: true,
+        isContinuationTurn: false,
+        wakeBufferLength: 0,
+      }),
+    );
+    assert.isFalse(
+      acpTurnStartShouldPreserveContinuation({
+        continuationRequested: true,
+        isContinuationTurn: true,
+        wakeBufferLength: 1,
+      }),
+    );
+  });
+});
+
+const taskkillPlatformError = (method: string) =>
+  PlatformError.systemError({ _tag: "Unknown", module: "taskkill-test", method });
+
+function makeTaskkillSpawner(input: {
+  readonly exitCode?: number;
+  readonly exitFailure?: boolean;
+  readonly output?: string;
+  readonly outputFailure?: boolean;
+  readonly spawnFailure?: boolean;
+  readonly commands?: Array<{ readonly command: string; readonly args: ReadonlyArray<string> }>;
+}) {
+  return ChildProcessSpawner.make((command) => {
+    const value = command as unknown as {
+      readonly command: string;
+      readonly args: ReadonlyArray<string>;
+    };
+    input.commands?.push({ command: value.command, args: value.args });
+    if (input.spawnFailure === true) return Effect.fail(taskkillPlatformError("spawn"));
+    const output = input.outputFailure
+      ? Stream.fail(taskkillPlatformError("output"))
+      : Stream.encodeText(Stream.make(input.output ?? ""));
+    return Effect.succeed(
+      ChildProcessSpawner.makeHandle({
+        pid: ChildProcessSpawner.ProcessId(1234),
+        exitCode: input.exitFailure
+          ? Effect.fail(taskkillPlatformError("exitCode"))
+          : Effect.succeed(ChildProcessSpawner.ExitCode(input.exitCode ?? 0)),
+        isRunning: Effect.succeed(false),
+        kill: () => Effect.void,
+        unref: Effect.succeed(Effect.void),
+        stdin: Sink.drain,
+        stdout: Stream.empty,
+        stderr: Stream.empty,
+        all: output,
+        getInputFd: () => Sink.drain,
+        getOutputFd: () => Stream.empty,
+      }),
+    );
+  });
+}
+
+function processExists(pid: number): boolean {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+const waitForProcesses = (pids: ReadonlyArray<number>) =>
+  Effect.gen(function* () {
+    while (!pids.every(processExists)) {
+      yield* Effect.sleep("10 millis");
+    }
+  }).pipe(Effect.timeoutOption("2 seconds"));
+
+const waitForProcessesToExit = (pids: ReadonlyArray<number>) =>
+  Effect.gen(function* () {
+    while (pids.some(processExists)) {
+      yield* Effect.sleep("10 millis");
+    }
+  }).pipe(Effect.timeoutOption("2 seconds"));
+
+function linuxProcessStart(pid: number): string | undefined {
+  try {
+    const stat = NodeFS.readFileSync(`/proc/${pid}/stat`, "utf8");
+    const commandEnd = stat.lastIndexOf(")");
+    return commandEnd < 0
+      ? undefined
+      : stat
+          .slice(commandEnd + 2)
+          .trim()
+          .split(/\s+/)[19];
+  } catch {
+    return undefined;
+  }
+}
+
+function cleanupPublishedDetachedFixture(path: string): void {
+  let published: Array<number>;
+  try {
+    published = NodeFS.readFileSync(path, "utf8")
+      .trim()
+      .split(/\s+/)
+      .map(Number)
+      .filter((pid) => Number.isSafeInteger(pid) && pid > 1);
+  } catch {
+    return;
+  }
+  const roots = published.filter((pid) => {
+    try {
+      return NodeFS.readFileSync(`/proc/${pid}/cmdline`, "utf8").includes(path);
+    } catch {
+      return false;
+    }
+  });
+  const owned = new Map<number, string>();
+  const pending = [...roots];
+  while (pending.length > 0) {
+    const pid = pending.shift();
+    if (pid === undefined || owned.has(pid)) continue;
+    const start = linuxProcessStart(pid);
+    if (start === undefined) continue;
+    owned.set(pid, start);
+    try {
+      pending.push(
+        ...NodeFS.readFileSync(`/proc/${pid}/task/${pid}/children`, "utf8")
+          .trim()
+          .split(/\s+/)
+          .filter(Boolean)
+          .map(Number),
+      );
+    } catch {
+      // The process already exited.
+    }
+  }
+  for (const [pid, start] of [...owned.entries()].toReversed()) {
+    if (linuxProcessStart(pid) !== start) continue;
+    try {
+      process.kill(pid, "SIGKILL");
+    } catch {
+      // The exact fixture process already exited.
+    }
+  }
+}
+
+const waitForPublishedProcessIds = (
+  fileSystem: FileSystem.FileSystem,
+  path: string,
+  count: number,
+) =>
+  Effect.gen(function* () {
+    while (true) {
+      const ids = (yield* fileSystem.readFileString(path))
+        .trim()
+        .split(/\s+/)
+        .filter(Boolean)
+        .map(Number);
+      if (ids.length === count && ids.every((pid) => Number.isSafeInteger(pid) && pid > 1)) {
+        return ids;
+      }
+      yield* Effect.sleep("10 millis");
+    }
+  }).pipe(Effect.timeoutOption("2 seconds"));
+
+function makeMockRuntime(input: {
+  readonly childProcessSpawner: ChildProcessSpawner.ChildProcessSpawner["Service"];
+  readonly mockAgentPath: string;
+  readonly environment?:
+    | Readonly<Record<string, string>>
+    | ((runtimeOrdinal: number) => Readonly<Record<string, string>>);
+  readonly protocolEvents?: Queue.Queue<EffectAcpProtocol.AcpProtocolLogEvent>;
+  readonly ownDescendantProcessGroups?: boolean;
+  readonly ownDetachedProcessGroup?: boolean;
+  readonly processGroupPlatform?: NodeJS.Platform;
+  readonly processGroupTerminationGrace?: Duration.Input;
+  readonly linuxCgroupController?: AcpSessionRuntime.AcpSessionRuntimeOptions["linuxCgroupController"];
+  readonly posixProcessTreeController?: AcpSessionRuntime.AcpSessionRuntimeOptions["posixProcessTreeController"];
+  readonly windowsProcessTreeTerminator?: AcpSessionRuntime.AcpSessionRuntimeOptions["windowsProcessTreeTerminator"];
+  readonly wrapCancel?: (
+    cancel: AcpSessionRuntime.AcpSessionRuntime["Service"]["cancel"],
+  ) => AcpSessionRuntime.AcpSessionRuntime["Service"]["cancel"];
+  readonly wrapOutgoingResponse?: (
+    onOutgoingResponse: NonNullable<AcpAdapterV2RuntimeInput["onOutgoingResponse"]>,
+  ) => NonNullable<AcpAdapterV2RuntimeInput["onOutgoingResponse"]>;
+  readonly wrapIncomingRequest?: (
+    onIncomingRequest: NonNullable<AcpAdapterV2RuntimeInput["onIncomingRequest"]>,
+  ) => NonNullable<AcpAdapterV2RuntimeInput["onIncomingRequest"]>;
+  readonly wrapRuntime?: (
+    runtime: AcpSessionRuntime.AcpSessionRuntime["Service"],
+    runtimeOrdinal: number,
+  ) => AcpSessionRuntime.AcpSessionRuntime["Service"];
+}): AcpAdapterV2Flavor["makeRuntime"] {
+  let runtimeOrdinal = 0;
+  return (runtimeInput) =>
+    Effect.gen(function* () {
+      runtimeOrdinal += 1;
+      const protocolEvents = input.protocolEvents;
+      const protocolLogging =
+        protocolEvents === undefined
+          ? runtimeInput.protocolLogging
+          : {
+              ...runtimeInput.protocolLogging,
+              logger: (event: EffectAcpProtocol.AcpProtocolLogEvent) =>
+                Queue.offer(protocolEvents, event).pipe(
+                  Effect.andThen(runtimeInput.protocolLogging.logger?.(event) ?? Effect.void),
+                  Effect.asVoid,
+                ),
+            };
+      const context = yield* Layer.build(
+        AcpSessionRuntime.layer({
+          ...runtimeInput,
+          ...(input.ownDetachedProcessGroup === undefined
+            ? {}
+            : { ownDetachedProcessGroup: input.ownDetachedProcessGroup }),
+          ...(input.ownDescendantProcessGroups === undefined
+            ? {}
+            : { ownDescendantProcessGroups: input.ownDescendantProcessGroups }),
+          ...(input.ownDetachedProcessGroup === true
+            ? { processGroupPlatform: input.processGroupPlatform ?? "linux" }
+            : {}),
+          ...(input.processGroupTerminationGrace === undefined
+            ? {}
+            : { processGroupTerminationGrace: input.processGroupTerminationGrace }),
+          ...(input.linuxCgroupController === undefined
+            ? {}
+            : { linuxCgroupController: input.linuxCgroupController }),
+          ...(input.posixProcessTreeController === undefined
+            ? {}
+            : { posixProcessTreeController: input.posixProcessTreeController }),
+          ...(input.windowsProcessTreeTerminator === undefined
+            ? {}
+            : { windowsProcessTreeTerminator: input.windowsProcessTreeTerminator }),
+          protocolLogging,
+          spawn: {
+            command: process.execPath,
+            args: [input.mockAgentPath],
+            cwd: runtimeInput.cwd,
+            env: {
+              T3_ACP_SESSION_LIFECYCLE: "1",
+              ...(typeof input.environment === "function"
+                ? input.environment(runtimeOrdinal)
+                : input.environment),
+            },
+          },
+          authMethodId: "test",
+          ...(input.wrapIncomingRequest === undefined ||
+          runtimeInput.onIncomingRequest === undefined
+            ? {}
+            : {
+                onIncomingRequest: input.wrapIncomingRequest(runtimeInput.onIncomingRequest),
+              }),
+          ...(input.wrapOutgoingResponse === undefined ||
+          runtimeInput.onOutgoingResponse === undefined
+            ? {}
+            : {
+                onOutgoingResponse: input.wrapOutgoingResponse(runtimeInput.onOutgoingResponse),
+              }),
+        }).pipe(
+          Layer.provide(
+            Layer.succeed(ChildProcessSpawner.ChildProcessSpawner, input.childProcessSpawner),
+          ),
+        ),
+      );
+      const runtime = yield* Effect.service(AcpSessionRuntime.AcpSessionRuntime).pipe(
+        Effect.provide(context),
+      );
+      const wrapped = {
+        ...runtime,
+        ...(input.wrapCancel === undefined ? {} : { cancel: input.wrapCancel(runtime.cancel) }),
+      };
+      return input.wrapRuntime?.(wrapped, runtimeOrdinal) ?? wrapped;
+    });
+}
+
+function rawProtocolMethod(event: EffectAcpProtocol.AcpProtocolLogEvent): string | undefined {
+  if (event.stage !== "raw" || typeof event.payload !== "string") return undefined;
+  for (const line of event.payload.split("\n")) {
+    const trimmed = line.trim();
+    if (trimmed.length === 0) continue;
+    const decoded = Option.getOrUndefined(decodeUnknownJson(trimmed));
+    if (typeof decoded === "object" && decoded !== null && "method" in decoded) {
+      const method = (decoded as { readonly method?: unknown }).method;
+      if (typeof method === "string") return method;
+    }
+  }
+  return undefined;
+}
+
+function rawProtocolRequest(
+  event: EffectAcpProtocol.AcpProtocolLogEvent,
+): { readonly method?: unknown; readonly params?: unknown } | undefined {
+  if (event.stage !== "raw" || typeof event.payload !== "string") return undefined;
+  for (const line of event.payload.split("\n")) {
+    const trimmed = line.trim();
+    if (trimmed.length === 0) continue;
+    const decoded = Option.getOrUndefined(decodeUnknownJson(trimmed));
+    if (typeof decoded === "object" && decoded !== null && "method" in decoded) {
+      return decoded;
+    }
+  }
+  return undefined;
+}
+
+const pollProtocolMethods = (events: Queue.Queue<EffectAcpProtocol.AcpProtocolLogEvent>) =>
+  Effect.gen(function* () {
+    const methods: string[] = [];
+    let polled = 0;
+    let event = yield* Queue.poll(events);
+    while (Option.isSome(event) && polled < 256) {
+      polled += 1;
+      const method = rawProtocolMethod(event.value);
+      if (method !== undefined) methods.push(method);
+      event = yield* Queue.poll(events);
+    }
+    return methods;
+  });
+
+function makeTurnInput(input: {
+  readonly threadId: ThreadId;
+  readonly providerThread: OrchestrationV2ProviderThread;
+  readonly instanceId: ProviderInstanceId;
+  readonly runtimePolicy: ProviderAdapterV2RuntimePolicy;
+  readonly now: DateTime.Utc;
+  readonly ordinal?: number;
+  readonly modelSelection?: ModelSelection;
+  /** agent+provider marks a post-settle continuation attach (drains wakeBuffer). */
+  readonly messageCreatedBy?: "user" | "agent";
+  readonly messageCreationSource?: "web" | "mobile" | "mcp" | "provider" | "server";
+  readonly messageText?: string;
+}): ProviderAdapterV2TurnInput {
+  const ordinal = input.ordinal ?? 1;
+  const suffix = `${input.threadId}:${ordinal}`;
+  const modelSelection =
+    input.modelSelection ?? ({ instanceId: input.instanceId, model: "default" } as const);
+  return {
+    appThread: {
+      createdBy: "user",
+      creationSource: "web",
+      id: input.threadId,
+      projectId: ProjectId.make(`project:${input.threadId}`),
+      title: "ACP adapter test",
+      providerInstanceId: input.instanceId,
+      modelSelection,
+      runtimeMode: "approval-required",
+      interactionMode: "default",
+      branch: null,
+      worktreePath: null,
+      activeProviderThreadId: input.providerThread.id,
+      lineage: {
+        parentThreadId: null,
+        relationshipToParent: null,
+        rootThreadId: input.threadId,
+      },
+      forkedFrom: null,
+      createdAt: input.now,
+      updatedAt: input.now,
+      archivedAt: null,
+      settledOverride: null,
+      settledAt: null,
+      lastVisitedAt: null,
+      deletedAt: null,
+    },
+    threadId: input.threadId,
+    runId: RunId.make(`run:${suffix}`),
+    runOrdinal: ordinal,
+    providerTurnOrdinal: ordinal,
+    attemptId: RunAttemptId.make(`attempt:${suffix}`),
+    rootNodeId: NodeId.make(`node:${suffix}`),
+    providerThread: input.providerThread,
+    message: {
+      createdBy: input.messageCreatedBy ?? "user",
+      creationSource: input.messageCreationSource ?? "web",
+      messageId: MessageId.make(`message:${suffix}`),
+      text: input.messageText ?? "test prompt",
+      attachments: [],
+    },
+    modelSelection,
+    runtimePolicy: input.runtimePolicy,
+  };
+}
+
+describe("AcpAdapterV2", () => {
+  it.live("cleans detached fixtures when an assertion aborts the test scope", () =>
+    Effect.gen(function* () {
+      if ((yield* HostProcessPlatform) !== "linux") return;
+      const fileSystem = yield* FileSystem.FileSystem;
+      let published: ReadonlyArray<number> = [];
+      const failed = yield* Effect.scoped(
+        Effect.gen(function* () {
+          const commandPidPath = yield* fileSystem.makeTempFileScoped({
+            prefix: "t3-acp-forced-failure-command-",
+          });
+          yield* Effect.addFinalizer(() =>
+            Effect.sync(() => cleanupPublishedDetachedFixture(commandPidPath)),
+          );
+          const fixture = NodeChildProcess.spawn(
+            "bash",
+            [
+              "-c",
+              'sleep 120 & child=$!; printf "%s %s\\n" "$$" "$child" > "$1"; wait "$child"',
+              "bash",
+              commandPidPath,
+            ],
+            { detached: true, stdio: "ignore" },
+          );
+          fixture.unref();
+          published = Option.getOrThrow(
+            yield* waitForPublishedProcessIds(fileSystem, commandPidPath, 2),
+          );
+          return yield* Effect.fail("forced assertion failure");
+        }),
+      ).pipe(Effect.exit);
+
+      assert.isTrue(Exit.isFailure(failed));
+      assert.isTrue(
+        Option.isSome(yield* waitForProcessesToExit(published)),
+        "detached cleanup finalizer must reap the Bash and sleep fixture",
+      );
+    }).pipe(Effect.provide(testLayer)),
+  );
+
+  it("matches xAI native request identities exactly across shared prefixes", () => {
+    const request = {
+      nativeMethod: "x.ai/ask_user_question",
+      nativeRequestId: "1",
+      nativeSessionId: "session-1",
+    };
+    assert.isTrue(
+      acpNativeUserInputRequestMatches(request, {
+        method: "x.ai/ask_user_question",
+        payload: { sessionId: "session-1", toolCallId: 1 },
+      }),
+    );
+    assert.isFalse(
+      acpNativeUserInputRequestMatches(request, {
+        method: "x.ai/ask_user_question",
+        payload: { sessionId: "session-1", toolCallId: "10", note: "request 1" },
+      }),
+    );
+    for (const incomplete of [
+      { ...request, nativeMethod: "" },
+      { ...request, nativeRequestId: "" },
+      { ...request, nativeSessionId: "" },
+    ]) {
+      assert.isFalse(
+        acpNativeUserInputRequestMatches(incomplete, {
+          method: "x.ai/ask_user_question",
+          payload: { sessionId: "session-1", toolCallId: "1" },
+        }),
+      );
+    }
+    assert.isFalse(
+      acpNativeUserInputRequestMatches(request, {
+        method: "_x.ai/ask_user_question",
+        payload: { sessionId: "session-1", toolCallId: "1" },
+      }),
+    );
+    assert.isFalse(
+      acpNativeUserInputRequestMatches(request, {
+        method: "x.ai/ask_user_question",
+        payload: {
+          method: "x.ai/ask_user_question",
+          params: { sessionId: "session-10", toolCallId: "1" },
+        },
+      }),
+    );
+  });
+
+  it("claims concurrent identical native requests in per-runtime sequence order", () => {
+    const requests = [
+      { generation: 2, requestId: "second", sequence: 8, identity: "shared" },
+      { generation: 1, requestId: "stale", sequence: 1, identity: "shared" },
+      { generation: 2, requestId: "first", sequence: 7, identity: "shared" },
+      { generation: 2, requestId: "other", sequence: 6, identity: "other" },
+    ];
+    const [firstId, afterFirst] = acpClaimNativeTransportRequest(
+      requests,
+      2,
+      (request) => request.identity === "shared",
+    );
+    const [secondId, afterSecond] = acpClaimNativeTransportRequest(
+      afterFirst,
+      2,
+      (request) => request.identity === "shared",
+    );
+
+    assert.equal(firstId, "first");
+    assert.equal(secondId, "second");
+    assert.deepEqual(
+      afterSecond.map((request) => request.requestId),
+      ["stale", "other"],
+    );
+  });
+
+  it("canonicalizes nested elicitation schemas independently of object key order", () => {
+    assert.equal(
+      acpCanonicalJson({
+        type: "object",
+        properties: { answer: { type: "string", title: "Answer", enum: ["a", "b"] } },
+      }),
+      acpCanonicalJson({
+        properties: { answer: { enum: ["a", "b"], title: "Answer", type: "string" } },
+        type: "object",
+      }),
+    );
+  });
+
+  it.live("replaces an unexpectedly terminated ACP runtime before the next turn", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const runtimeInputs: AcpAdapterV2RuntimeInput[] = [];
+      let runtimeOrdinalSeen = 0;
+      const baseMakeRuntime = makeMockRuntime({
+        childProcessSpawner,
+        mockAgentPath,
+        environment: (runtimeOrdinal) => {
+          runtimeOrdinalSeen = runtimeOrdinal;
+          return {};
+        },
+      });
+      const instanceId = ProviderInstanceId.make("acp-test-unexpected-termination");
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          makeRuntime: (runtimeInput) =>
+            Effect.sync(() => {
+              runtimeInputs.push(runtimeInput);
+            }).pipe(Effect.andThen(baseMakeRuntime(runtimeInput))),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+      });
+      const threadId = ThreadId.make("thread-acp-unexpected-termination");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make("provider-session-acp-unexpected-termination"),
+        modelSelection,
+        runtimePolicy,
+      });
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      assert.equal(runtimeOrdinalSeen, 1);
+      yield* runtimeInputs[0]!.onTermination!(
+        new EffectAcpErrors.AcpTransportError({
+          detail: "Injected unexpected writer termination",
+          cause: "test",
+        }),
+      );
+
+      yield* runtime.startTurn(
+        makeTurnInput({
+          threadId,
+          providerThread,
+          instanceId,
+          runtimePolicy,
+          now: yield* DateTime.now,
+        }),
+      );
+      yield* runtime.events.pipe(
+        Stream.filter((event) => event.type === "turn.terminal"),
+        Stream.runHead,
+      );
+      assert.equal(runtimeOrdinalSeen, 2);
+      assert.lengthOf(runtimeInputs, 2);
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.live("reaps detached native work when the provider exits before explicit teardown", () =>
+    Effect.gen(function* () {
+      if ((yield* HostProcessPlatform) !== "linux") return;
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const commandPidPath = yield* fileSystem.makeTempFileScoped({
+        prefix: "t3-acp-provider-exit-command-",
+      });
+      yield* Effect.addFinalizer(() =>
+        Effect.sync(() => cleanupPublishedDetachedFixture(commandPidPath)),
+      );
+      const instanceId = ProviderInstanceId.make("acp-test-provider-exit");
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          terminateRuntimeProcessGroupOnInterrupt: true,
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            mockAgentPath,
+            ownDescendantProcessGroups: true,
+            ownDetachedProcessGroup: true,
+            processGroupTerminationGrace: 0,
+            environment: {
+              T3_ACP_EMIT_RUNNING_COMMAND_THEN_HANG: "1",
+              T3_ACP_EXIT_AFTER_RUNNING_COMMAND_LAUNCH: "1",
+              T3_ACP_RUNNING_COMMAND_PID_PATH: commandPidPath,
+              T3_ACP_RUNNING_COMMAND_SEPARATE_SESSION: "1",
+            },
+          }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+      });
+      const threadId = ThreadId.make("thread-acp-provider-exit-running-command");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make("provider-session-acp-provider-exit"),
+        modelSelection,
+        runtimePolicy,
+      });
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      yield* runtime
+        .startTurn(
+          makeTurnInput({
+            threadId,
+            providerThread,
+            instanceId,
+            runtimePolicy,
+            now: yield* DateTime.now,
+          }),
+        )
+        .pipe(Effect.exit, Effect.forkScoped);
+
+      const published = yield* waitForPublishedProcessIds(fileSystem, commandPidPath, 3);
+      assert.isTrue(Option.isSome(published), "detached fixture must publish all process IDs");
+      const pids = Option.getOrThrow(published);
+      assert.isTrue(
+        Option.isSome(yield* waitForProcessesToExit(pids)),
+        "provider termination must reap the detached launcher, Bash, and sleep processes",
+      );
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.live("surfaces reduced guarantee when delegated cgroup containment is unavailable", () =>
+    Effect.gen(function* () {
+      if ((yield* HostProcessPlatform) !== "linux") return;
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      let containment:
+        | AcpSessionRuntime.AcpSessionRuntime["Service"]["processContainment"]
+        | undefined;
+      const instanceId = ProviderInstanceId.make("acp-test-cgroup-unavailable");
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            linuxCgroupController: null,
+            mockAgentPath,
+            ownDescendantProcessGroups: true,
+            ownDetachedProcessGroup: true,
+            wrapRuntime: (runtime) => {
+              containment = runtime.processContainment;
+              return runtime;
+            },
+          }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+      });
+      const threadId = ThreadId.make("thread-acp-cgroup-unavailable");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make("provider-session-acp-cgroup-unavailable"),
+        modelSelection,
+        runtimePolicy,
+      });
+      yield* runtime.ensureThread({ threadId, modelSelection, runtimePolicy });
+      assert.equal(containment, "process-ledger-reduced-guarantee");
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.live("cleans a cgroup lease when the pre-exec join wrapper fails", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      let createCalls = 0;
+      let cgroupExists = true;
+      let killCalls = 0;
+      let removeCalls = 0;
+      const cgroupController: AcpSessionRuntime.AcpLinuxCgroupController = {
+        create: () => {
+          createCalls += 1;
+          return {
+            contains: () => false,
+            exists: () => cgroupExists,
+            path: "/definitely-missing/t3-acp-cgroup",
+            relativePath: "/definitely-missing/t3-acp-cgroup",
+            kill: () => {
+              killCalls += 1;
+            },
+            populated: () => false,
+            remove: () => {
+              removeCalls += 1;
+              cgroupExists = false;
+            },
+          };
+        },
+      };
+      const instanceId = ProviderInstanceId.make("acp-test-cgroup-join-failure");
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            linuxCgroupController: cgroupController,
+            mockAgentPath,
+            ownDescendantProcessGroups: true,
+            ownDetachedProcessGroup: true,
+          }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+      });
+      const threadId = ThreadId.make("thread-acp-cgroup-join-failure");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const sessionScope = yield* Scope.make();
+      const opened = yield* adapter
+        .openSession({
+          threadId,
+          providerSessionId: ProviderSessionId.make("provider-session-acp-cgroup-join-failure"),
+          modelSelection,
+          runtimePolicy,
+        })
+        .pipe(Effect.provideService(Scope.Scope, sessionScope), Effect.exit);
+      assert.isTrue(Exit.isFailure(opened));
+      yield* Scope.close(sessionScope, Exit.void);
+      assert.equal(createCalls, 1);
+      assert.isAtLeast(killCalls, 1);
+      assert.isAtLeast(removeCalls, 1);
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect("negotiates and executes optional native session forks through the ACP runtime", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+      const makeRuntime = makeMockRuntime({ childProcessSpawner, mockAgentPath, protocolEvents });
+
+      const instanceId = ProviderInstanceId.make("acp-test");
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          makeRuntime,
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+      });
+      const sourceThreadId = ThreadId.make("thread-acp-native-fork-source");
+      const targetThreadId = ThreadId.make("thread-acp-native-fork-target");
+      McpProviderSession.setMcpProviderSession({
+        environmentId: EnvironmentId.make("environment-acp-native-fork"),
+        threadId: targetThreadId,
+        providerSessionId: "mcp-session-acp-native-fork",
+        providerInstanceId: instanceId,
+        endpoint: "http://127.0.0.1:43123/mcp",
+        authorizationHeader: "Bearer target-thread-token",
+        browserToolsAvailable: true,
+      });
+      yield* Effect.addFinalizer(() =>
+        Effect.sync(() => McpProviderSession.clearMcpProviderSession(targetThreadId)),
+      );
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId: sourceThreadId,
+        providerSessionId: ProviderSessionId.make("provider-session-acp-native-fork"),
+        modelSelection,
+        runtimePolicy,
+      });
+
+      assert.isTrue(runtime.providerSession.capabilities.threads.canForkThread);
+      assert.isTrue(runtime.providerSession.capabilities.threads.canReadThreadSnapshot);
+      assert.isTrue(runtime.providerSession.capabilities.sessions.supportsModelSwitchInSession);
+      assert.isFalse(
+        runtime.providerSession.capabilities.sessions.supportsRuntimeModeSwitchInSession,
+      );
+
+      const sourceProviderThread = yield* runtime.ensureThread({
+        threadId: sourceThreadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      const forkedProviderThread = yield* runtime.forkThread({
+        sourceProviderThread,
+        targetThreadId,
+      });
+      const forkRequestEvent = Option.getOrThrow(
+        yield* Stream.fromQueue(protocolEvents).pipe(
+          Stream.filter(
+            (event) =>
+              event.direction === "outgoing" && rawProtocolMethod(event) === "session/fork",
+          ),
+          Stream.runHead,
+        ),
+      );
+      const forkRequest = Option.getOrThrow(
+        Option.fromNullishOr(rawProtocolRequest(forkRequestEvent)),
+      );
+
+      assert.equal(sourceProviderThread.nativeThreadRef?.nativeId, "mock-session-1");
+      assert.equal(forkedProviderThread.nativeThreadRef?.nativeId, "mock-session-1-fork");
+      assert.equal(forkedProviderThread.appThreadId, targetThreadId);
+      assert.equal(forkedProviderThread.forkedFrom?.providerThreadId, sourceProviderThread.id);
+      assert.deepEqual(forkRequest.params, {
+        sessionId: "mock-session-1",
+        cwd: process.cwd(),
+        mcpServers: [
+          {
+            type: "http",
+            name: "t3-code",
+            url: "http://127.0.0.1:43123/mcp",
+            headers: [{ name: "Authorization", value: "Bearer target-thread-token" }],
+          },
+        ],
+      });
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect("fails missing native ACP session ids through the typed start-turn error channel", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const instanceId = ProviderInstanceId.make("acp-test-missing-native-thread");
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          makeRuntime: makeMockRuntime({ childProcessSpawner, mockAgentPath }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+      });
+      const threadId = ThreadId.make("thread-acp-missing-native-thread");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make("provider-session-acp-missing-native-thread"),
+        modelSelection,
+        runtimePolicy,
+      });
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      const now = yield* DateTime.now;
+      const error = yield* runtime
+        .startTurn(
+          makeTurnInput({
+            threadId,
+            providerThread: { ...providerThread, nativeThreadRef: null },
+            instanceId,
+            runtimePolicy,
+            now,
+          }),
+        )
+        .pipe(Effect.flip);
+
+      assert.equal(error._tag, "ProviderAdapterTurnStartError");
+      assert.instanceOf(error.cause, ProviderAdapterProtocolError);
+      assert.include(String(error.cause), "missing its ACP session id");
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect("closes an idle ACP session exactly once through the transition permit", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+      const instanceId = ProviderInstanceId.make("acp-test");
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          makeRuntime: makeMockRuntime({ childProcessSpawner, mockAgentPath, protocolEvents }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+      });
+      const threadId = ThreadId.make("thread-acp-idle-finalizer");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const sessionScope = yield* Scope.make();
+      yield* adapter
+        .openSession({
+          threadId,
+          providerSessionId: ProviderSessionId.make("provider-session-acp-idle-finalizer"),
+          modelSelection,
+          runtimePolicy,
+        })
+        .pipe(Effect.provideService(Scope.Scope, sessionScope));
+      yield* pollProtocolMethods(protocolEvents);
+      yield* Scope.close(sessionScope, Exit.void);
+      const finalizerMethods = yield* pollProtocolMethods(protocolEvents);
+      assert.equal(finalizerMethods.filter((method) => method === "session/close").length, 1);
+    }).pipe(Effect.provide(testLayer)),
+  );
+
+  it.effect("rejects requested options that the active ACP session does not expose", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const instanceId = ProviderInstanceId.make("acp-test");
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          makeRuntime: makeMockRuntime({ childProcessSpawner, mockAgentPath }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+      });
+      const threadId = ThreadId.make("thread-acp-unsupported-option");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const error = yield* adapter
+        .openSession({
+          threadId,
+          providerSessionId: ProviderSessionId.make("provider-session-acp-unsupported-option"),
+          modelSelection: {
+            instanceId,
+            model: "default",
+            options: [{ id: "missing-option", value: "high" }],
+          },
+          runtimePolicy,
+        })
+        .pipe(Effect.flip);
+
+      assert.equal(error._tag, "ProviderAdapterOpenSessionError");
+      assert.include(String(error.cause), "does not expose requested configuration option(s)");
+      assert.include(String(error.cause), "missing-option");
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect("reconfigures a loaded ACP session from its own active setup metadata", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+      const instanceId = ProviderInstanceId.make("acp-test");
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          makeRuntime: makeMockRuntime({ childProcessSpawner, mockAgentPath, protocolEvents }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+      });
+      const firstThreadId = ThreadId.make("thread-acp-active-setup:first");
+      const secondThreadId = ThreadId.make("thread-acp-active-setup:second");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const initialSelection = { instanceId, model: "default" } satisfies ModelSelection;
+      const alternateSelection = {
+        instanceId,
+        model: "grok-mock-alt",
+      } satisfies ModelSelection;
+      const originalSelection = { instanceId, model: "grok-build" } satisfies ModelSelection;
+      const runtime = yield* adapter.openSession({
+        threadId: firstThreadId,
+        providerSessionId: ProviderSessionId.make("provider-session-acp-active-setup"),
+        modelSelection: initialSelection,
+        runtimePolicy,
+      });
+      const firstProviderThread = yield* runtime.ensureThread({
+        threadId: firstThreadId,
+        modelSelection: initialSelection,
+        runtimePolicy,
+      });
+      const now = yield* DateTime.now;
+      yield* runtime.startTurn(
+        makeTurnInput({
+          threadId: firstThreadId,
+          providerThread: firstProviderThread,
+          instanceId,
+          runtimePolicy,
+          modelSelection: alternateSelection,
+          now,
+        }),
+      );
+      yield* runtime.events.pipe(
+        Stream.filter((event) => event.type === "turn.terminal"),
+        Stream.runHead,
+      );
+
+      const secondProviderThread: OrchestrationV2ProviderThread = {
+        ...firstProviderThread,
+        id: ProviderThreadId.make("provider-thread-acp-active-setup:second"),
+        appThreadId: secondThreadId,
+        nativeThreadRef: {
+          driver: ACP_TEST_DRIVER,
+          nativeId: "mock-session-2",
+          strength: "strong",
+        },
+        status: "idle",
+      };
+      yield* runtime.resumeThread({
+        providerThread: secondProviderThread,
+        modelSelection: alternateSelection,
+        runtimePolicy,
+      });
+      yield* runtime.startTurn(
+        makeTurnInput({
+          threadId: secondThreadId,
+          providerThread: secondProviderThread,
+          instanceId,
+          runtimePolicy,
+          modelSelection: originalSelection,
+          now,
+          ordinal: 2,
+        }),
+      );
+      yield* runtime.events.pipe(
+        Stream.filter((event) => event.type === "turn.terminal"),
+        Stream.runHead,
+      );
+
+      const setModelRequests = Array.from(yield* Queue.takeAll(protocolEvents)).filter(
+        (event) =>
+          event.direction === "outgoing" && rawProtocolMethod(event) === "session/set_model",
+      );
+      assert.lengthOf(setModelRequests, 2);
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.live("terminalizes an empty successful foreground Bash tool when the turn completes", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+      const instanceId = ProviderInstanceId.make("acp-test");
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            mockAgentPath,
+            environment: (runtimeOrdinal) =>
+              runtimeOrdinal === 1 ? { T3_ACP_EMIT_EMPTY_SUCCESSFUL_BASH_THEN_HANG: "1" } : {},
+            ownDetachedProcessGroup: true,
+            protocolEvents,
+          }),
+          normalizeToolCall: normalizeXAiAcpToolCallState,
+          restartRuntimeAfterInterrupt: true,
+          terminateRuntimeProcessGroupOnInterrupt: true,
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+      });
+      const threadId = ThreadId.make("thread-acp-empty-successful-bash");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make("provider-session-acp-empty-successful-bash"),
+        modelSelection,
+        runtimePolicy,
+      });
+      const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+      yield* runtime.events.pipe(
+        Stream.runForEach((event) => Queue.offer(events, event)),
+        Effect.forkScoped,
+      );
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      const now = yield* DateTime.now;
+      yield* runtime.startTurn(
+        makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now }),
+      );
+
+      const statuses: string[] = [];
+      let runningStartedAt: DateTime.Utc | null = null;
+      let completedStartedAt: DateTime.Utc | null = null;
+      let completedAt: DateTime.Utc | null = null;
+      let completedInput: string | null = null;
+      let completedOutput: string | null | undefined;
+      let completedExitCode: number | null | undefined;
+      let runningProjectedExitCode: number | undefined = undefined;
+      let terminal = false;
+      while (!terminal) {
+        const event = yield* Queue.take(events);
+        if (
+          event.type === "turn_item.updated" &&
+          event.turnItem.nativeItemRef?.nativeId === "tool-call-empty-success-1"
+        ) {
+          statuses.push(event.turnItem.status);
+          if (event.turnItem.status === "running") {
+            runningStartedAt ??= event.turnItem.startedAt;
+            if (event.turnItem.type === "command_execution") {
+              runningProjectedExitCode = event.turnItem.exitCode;
+            }
+          }
+          if (event.turnItem.status === "completed") {
+            completedStartedAt = event.turnItem.startedAt;
+            completedAt = event.turnItem.completedAt;
+            if (event.turnItem.type === "command_execution") {
+              completedInput = event.turnItem.input;
+              completedOutput = event.turnItem.output;
+              completedExitCode = event.turnItem.exitCode;
+            }
+          }
+        }
+        if (event.type === "turn.terminal") terminal = true;
+      }
+
+      assert.deepEqual(statuses, ["running", "running", "completed"]);
+      assert.deepEqual(completedStartedAt, runningStartedAt);
+      assert.isNotNull(completedAt);
+      assert.equal(completedInput, "true");
+      assert.equal(completedOutput, undefined);
+      assert.equal(
+        runningProjectedExitCode,
+        undefined,
+        "mid-stream exit_code must not project until the tool is terminal",
+      );
+      assert.equal(completedExitCode, 0);
+
+      yield* Queue.takeAll(protocolEvents);
+      yield* runtime
+        .startTurn(
+          makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now, ordinal: 2 }),
+        )
+        .pipe(Effect.forkScoped);
+      yield* Stream.fromQueue(protocolEvents).pipe(
+        Stream.filter(
+          (event) =>
+            event.direction === "outgoing" && rawProtocolMethod(event) === "session/prompt",
+        ),
+        Stream.runHead,
+      );
+      const secondProviderTurnId = idAllocator.derive.providerTurn({
+        driver: ACP_TEST_DRIVER,
+        nativeTurnId: "mock-session-1:turn:2",
+      });
+      yield* runtime.interruptTurn({
+        providerThread,
+        providerTurnId: secondProviderTurnId,
+        requestRuntimeRestart: true,
+      });
+      yield* runtime.startTurn(
+        makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now, ordinal: 3 }),
+      );
+      const loadAfterRestart = yield* Stream.fromQueue(protocolEvents).pipe(
+        Stream.filter(
+          (event) => event.direction === "outgoing" && rawProtocolMethod(event) === "session/load",
+        ),
+        Stream.runHead,
+      );
+      assert.isTrue(Option.isSome(loadAfterRestart));
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect("cancels pending permission requests while interrupting an ACP turn", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const releaseCancel = yield* Deferred.make<void>();
+      const instanceId = ProviderInstanceId.make("acp-test");
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            mockAgentPath,
+            environment: { T3_ACP_EMIT_TOOL_CALLS: "1" },
+            wrapCancel: (cancel) => Deferred.await(releaseCancel).pipe(Effect.andThen(cancel)),
+          }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+      });
+      const threadId = ThreadId.make("thread-acp-cancel-permission");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "approval-required",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make("provider-session-acp-cancel-permission"),
+        modelSelection,
+        runtimePolicy,
+      });
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      const now = yield* DateTime.now;
+      yield* runtime.startTurn(
+        makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now }),
+      );
+
+      const pendingRequest = Option.getOrThrow(
+        yield* runtime.events.pipe(
+          Stream.filter(
+            (event) =>
+              event.type === "runtime_request.updated" && event.runtimeRequest.status === "pending",
+          ),
+          Stream.runHead,
+        ),
+      );
+      if (
+        pendingRequest.type !== "runtime_request.updated" ||
+        pendingRequest.runtimeRequest.providerTurnId === null
+      ) {
+        return yield* Effect.die("Expected a pending ACP permission request with a provider turn");
+      }
+
+      const interruptFiber = yield* runtime
+        .interruptTurn({
+          providerThread,
+          providerTurnId: pendingRequest.runtimeRequest.providerTurnId,
+        })
+        .pipe(Effect.forkScoped);
+
+      const cancelledRequest = Option.getOrThrow(
+        yield* runtime.events.pipe(
+          Stream.filter(
+            (event) =>
+              event.type === "runtime_request.updated" &&
+              event.runtimeRequest.id === pendingRequest.runtimeRequest.id &&
+              event.runtimeRequest.status === "cancelled",
+          ),
+          Stream.runHead,
+        ),
+      );
+      assert.equal(cancelledRequest.type, "runtime_request.updated");
+      yield* Deferred.succeed(releaseCancel, undefined);
+      yield* Fiber.join(interruptFiber);
+      const terminal = Option.getOrThrow(
+        yield* runtime.events.pipe(
+          Stream.filter((event) => event.type === "turn.terminal"),
+          Stream.runHead,
+        ),
+      );
+      assert.equal(terminal.type, "turn.terminal");
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.live("keeps hard teardown excluded until a permission response is enqueued", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const responseEnqueued = yield* Deferred.make<void>();
+      const releaseResponseAcknowledgement = yield* Deferred.make<void>();
+      const instanceId = ProviderInstanceId.make("acp-test");
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            mockAgentPath,
+            environment: { T3_ACP_EMIT_TOOL_CALLS: "1" },
+            wrapOutgoingResponse: (onOutgoingResponse) => (requestId) =>
+              Deferred.succeed(responseEnqueued, undefined).pipe(
+                Effect.andThen(Deferred.await(releaseResponseAcknowledgement)),
+                Effect.andThen(onOutgoingResponse(requestId)),
+              ),
+          }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+      });
+      const threadId = ThreadId.make("thread-acp-response-wins-permission");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "approval-required",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make("provider-session-acp-response-wins-permission"),
+        modelSelection,
+        runtimePolicy,
+      });
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      yield* runtime.startTurn(
+        makeTurnInput({
+          threadId,
+          providerThread,
+          instanceId,
+          runtimePolicy,
+          now: yield* DateTime.now,
+        }),
+      );
+      const pending = Option.getOrThrow(
+        yield* runtime.events.pipe(
+          Stream.filter(
+            (event) =>
+              event.type === "runtime_request.updated" && event.runtimeRequest.status === "pending",
+          ),
+          Stream.runHead,
+        ),
+      );
+      if (
+        pending.type !== "runtime_request.updated" ||
+        pending.runtimeRequest.providerTurnId === null
+      ) {
+        return yield* Effect.die("Expected a pending permission request");
+      }
+      const responseFiber = yield* runtime
+        .respondToRuntimeRequest({ requestId: pending.runtimeRequest.id, decision: "accept" })
+        .pipe(Effect.forkScoped);
+      yield* Deferred.await(responseEnqueued);
+      const interruptFiber = yield* runtime
+        .interruptTurn({
+          providerThread,
+          providerTurnId: pending.runtimeRequest.providerTurnId,
+          requestRuntimeRestart: true,
+        })
+        .pipe(Effect.forkScoped);
+      yield* Effect.yieldNow;
+      assert.isUndefined(responseFiber.pollUnsafe());
+      assert.isUndefined(interruptFiber.pollUnsafe());
+
+      yield* Deferred.succeed(releaseResponseAcknowledgement, undefined);
+      yield* Fiber.join(responseFiber);
+      yield* Fiber.join(interruptFiber);
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.live("correlates reordered elicitation schemas through the completed stdout write", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const responseWritten = yield* Deferred.make<void>();
+      const releaseResponseAcknowledgement = yield* Deferred.make<void>();
+      const instanceId = ProviderInstanceId.make("acp-test-reordered-elicitation");
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            mockAgentPath,
+            environment: { T3_ACP_EMIT_ELICITATION: "1" },
+            wrapIncomingRequest: (onIncomingRequest) => (requestId, method, payload) => {
+              if (method !== "session/elicitation") {
+                return onIncomingRequest(requestId, method, payload);
+              }
+              const record = payload as Record<string, unknown>;
+              return onIncomingRequest(requestId, method, {
+                ...record,
+                requestedSchema: {
+                  properties: {
+                    approved: { title: "Approved", type: "boolean" },
+                  },
+                  type: "object",
+                },
+              });
+            },
+            wrapOutgoingResponse: (onOutgoingResponse) => (requestId) =>
+              Deferred.succeed(responseWritten, undefined).pipe(
+                Effect.andThen(Deferred.await(releaseResponseAcknowledgement)),
+                Effect.andThen(onOutgoingResponse(requestId)),
+              ),
+          }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+      });
+      const threadId = ThreadId.make("thread-acp-reordered-elicitation");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "approval-required",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make("provider-session-acp-reordered-elicitation"),
+        modelSelection,
+        runtimePolicy,
+      });
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      yield* runtime.startTurn(
+        makeTurnInput({
+          threadId,
+          providerThread,
+          instanceId,
+          runtimePolicy,
+          now: yield* DateTime.now,
+        }),
+      );
+      const pending = Option.getOrThrow(
+        yield* runtime.events.pipe(
+          Stream.filter(
+            (event) =>
+              event.type === "runtime_request.updated" && event.runtimeRequest.status === "pending",
+          ),
+          Stream.runHead,
+        ),
+      );
+      if (pending.type !== "runtime_request.updated") {
+        return yield* Effect.die("Expected a pending elicitation request");
+      }
+      const responseFiber = yield* runtime
+        .respondToRuntimeRequest({
+          requestId: pending.runtimeRequest.id,
+          answers: { approved: ["true"] },
+        })
+        .pipe(Effect.forkScoped);
+
+      yield* Deferred.await(responseWritten);
+      assert.isUndefined(responseFiber.pollUnsafe());
+      yield* Deferred.succeed(releaseResponseAcknowledgement, undefined);
+      yield* Fiber.join(responseFiber);
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.live("fails a held native response acknowledgement before normal session close", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const responseWritten = yield* Deferred.make<void>();
+      const releaseResponseAcknowledgement = yield* Deferred.make<void>();
+      const responseLifecycle: Array<string> = [];
+      const instanceId = ProviderInstanceId.make("acp-test-normal-close-held-response");
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            mockAgentPath,
+            environment: { T3_ACP_EMIT_TOOL_CALLS: "1" },
+            wrapOutgoingResponse: (onOutgoingResponse) => (requestId) =>
+              Deferred.succeed(responseWritten, undefined).pipe(
+                Effect.andThen(Deferred.await(releaseResponseAcknowledgement)),
+                Effect.andThen(onOutgoingResponse(requestId)),
+              ),
+          }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+        testHooks: {
+          onNativeResponseLifecycle: (event) =>
+            Effect.sync(() => {
+              responseLifecycle.push(event.type);
+            }),
+        },
+      });
+      const threadId = ThreadId.make("thread-acp-normal-close-held-response");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "approval-required",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const sessionScope = yield* Scope.make();
+      const runtime = yield* adapter
+        .openSession({
+          threadId,
+          providerSessionId: ProviderSessionId.make(
+            "provider-session-acp-normal-close-held-response",
+          ),
+          modelSelection,
+          runtimePolicy,
+        })
+        .pipe(Effect.provideService(Scope.Scope, sessionScope));
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      yield* runtime.startTurn(
+        makeTurnInput({
+          threadId,
+          providerThread,
+          instanceId,
+          runtimePolicy,
+          now: yield* DateTime.now,
+        }),
+      );
+      const pending = Option.getOrThrow(
+        yield* runtime.events.pipe(
+          Stream.filter(
+            (event) =>
+              event.type === "runtime_request.updated" && event.runtimeRequest.status === "pending",
+          ),
+          Stream.runHead,
+        ),
+      );
+      if (pending.type !== "runtime_request.updated") {
+        return yield* Effect.die("Expected a pending permission request");
+      }
+      const responseFiber = yield* runtime
+        .respondToRuntimeRequest({ requestId: pending.runtimeRequest.id, decision: "accept" })
+        .pipe(Effect.exit, Effect.forkScoped);
+      yield* Deferred.await(responseWritten);
+
+      const closeFiber = yield* Scope.close(sessionScope, Exit.void).pipe(Effect.forkScoped);
+      while (!responseLifecycle.includes("failed")) {
+        yield* Effect.yieldNow;
+      }
+      const responseExit = yield* Fiber.join(responseFiber);
+      if (Exit.isSuccess(responseExit)) {
+        assert.fail("normal close must fail a response whose transport acknowledgement is held");
+      }
+      assert.include(Cause.pretty(responseExit.cause), "ACP session transport closed");
+      assert.include(responseLifecycle, "removed");
+      assert.include(responseLifecycle, "failed");
+      yield* Deferred.succeed(releaseResponseAcknowledgement, undefined);
+      yield* Fiber.join(closeFiber);
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.live("rejects delayed native response registration when normal close wins the permit", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const registrationStarted = yield* Deferred.make<void>();
+      const releaseRegistration = yield* Deferred.make<void>();
+      const transportClosed = yield* Deferred.make<void>();
+      const releaseTransportClose = yield* Deferred.make<void>();
+      const responseLifecycle: Array<string> = [];
+      const instanceId = ProviderInstanceId.make("acp-test-close-wins-registration");
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            mockAgentPath,
+            environment: { T3_ACP_EMIT_TOOL_CALLS: "1" },
+          }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+        testHooks: {
+          afterNativeResponseTransportClosed: () =>
+            Deferred.succeed(transportClosed, undefined).pipe(
+              Effect.andThen(Deferred.await(releaseTransportClose)),
+            ),
+          beforeNativeResponseAdmissionCheck: () =>
+            Deferred.succeed(registrationStarted, undefined).pipe(
+              Effect.andThen(Deferred.await(releaseRegistration)),
+            ),
+          onNativeResponseLifecycle: (event) =>
+            Effect.sync(() => {
+              responseLifecycle.push(event.type);
+            }),
+        },
+      });
+      const threadId = ThreadId.make("thread-acp-close-wins-registration");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "approval-required",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const sessionScope = yield* Scope.make();
+      const runtime = yield* adapter
+        .openSession({
+          threadId,
+          providerSessionId: ProviderSessionId.make("provider-session-acp-close-wins-registration"),
+          modelSelection,
+          runtimePolicy,
+        })
+        .pipe(Effect.provideService(Scope.Scope, sessionScope));
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      yield* runtime.startTurn(
+        makeTurnInput({
+          threadId,
+          providerThread,
+          instanceId,
+          runtimePolicy,
+          now: yield* DateTime.now,
+        }),
+      );
+      const pending = Option.getOrThrow(
+        yield* runtime.events.pipe(
+          Stream.filter(
+            (event) =>
+              event.type === "runtime_request.updated" && event.runtimeRequest.status === "pending",
+          ),
+          Stream.runHead,
+        ),
+      );
+      if (pending.type !== "runtime_request.updated") {
+        return yield* Effect.die("Expected a pending permission request");
+      }
+      const responseFiber = yield* runtime
+        .respondToRuntimeRequest({ requestId: pending.runtimeRequest.id, decision: "accept" })
+        .pipe(Effect.exit, Effect.forkScoped);
+      yield* Deferred.await(registrationStarted);
+
+      const closeFiber = yield* Scope.close(sessionScope, Exit.void).pipe(Effect.forkScoped);
+      yield* Deferred.await(transportClosed);
+      yield* Deferred.succeed(releaseRegistration, undefined);
+      while (!responseLifecycle.includes("admission_rejected")) {
+        yield* Effect.yieldNow;
+      }
+      const responseExit = yield* Fiber.join(responseFiber);
+      if (Exit.isSuccess(responseExit)) {
+        assert.fail("normal close must reject a response delayed before transport registration");
+      }
+      assert.include(Cause.pretty(responseExit.cause), "ACP session transport closed");
+      assert.equal(responseLifecycle.filter((event) => event === "registered").length, 1);
+      assert.equal(responseLifecycle.filter((event) => event === "removed").length, 1);
+      assert.equal(responseLifecycle.filter((event) => event === "admission_rejected").length, 1);
+      yield* Deferred.succeed(releaseTransportClose, undefined);
+      yield* Fiber.join(closeFiber);
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.live("bounds a missing pending permission response acknowledgement", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const responseEnqueued = yield* Deferred.make<void>();
+      const releaseNativeHook = yield* Deferred.make<void>();
+      const responseLifecycle: Array<string> = [];
+      const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+      const instanceId = ProviderInstanceId.make("acp-test-pending-response-timeout");
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          restartRuntimeAfterInterrupt: true,
+          terminateRuntimeProcessGroupOnInterrupt: true,
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            mockAgentPath,
+            environment: {
+              T3_ACP_EMIT_TOOL_CALLS: "1",
+              T3_ACP_HANG_AFTER_PERMISSION: "1",
+            },
+            ownDetachedProcessGroup: true,
+            processGroupPlatform: "win32",
+            protocolEvents,
+            windowsProcessTreeTerminator: (pid) =>
+              Deferred.succeed(releaseNativeHook, undefined).pipe(
+                Effect.andThen(
+                  Effect.sync(() => {
+                    process.kill(pid, "SIGTERM");
+                  }),
+                ),
+              ),
+            wrapOutgoingResponse: (onOutgoingResponse) => (requestId) =>
+              Deferred.succeed(responseEnqueued, undefined).pipe(
+                Effect.andThen(Deferred.await(releaseNativeHook)),
+                Effect.andThen(onOutgoingResponse(requestId)),
+              ),
+          }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+        testHooks: {
+          onNativeResponseLifecycle: (event) =>
+            Effect.sync(() => {
+              responseLifecycle.push(event.type);
+            }),
+        },
+      });
+      const threadId = ThreadId.make("thread-acp-pending-response-timeout");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "approval-required",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const sessionScope = yield* Scope.make();
+      const runtime = yield* adapter
+        .openSession({
+          threadId,
+          providerSessionId: ProviderSessionId.make(
+            "provider-session-acp-pending-response-timeout",
+          ),
+          modelSelection,
+          runtimePolicy,
+        })
+        .pipe(Effect.provideService(Scope.Scope, sessionScope));
+      yield* pollProtocolMethods(protocolEvents);
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      yield* runtime.startTurn(
+        makeTurnInput({
+          threadId,
+          providerThread,
+          instanceId,
+          runtimePolicy,
+          now: yield* DateTime.now,
+        }),
+      );
+      const pending = Option.getOrThrow(
+        yield* runtime.events.pipe(
+          Stream.filter(
+            (event) =>
+              event.type === "runtime_request.updated" && event.runtimeRequest.status === "pending",
+          ),
+          Stream.runHead,
+        ),
+      );
+      if (
+        pending.type !== "runtime_request.updated" ||
+        pending.runtimeRequest.providerTurnId === null
+      ) {
+        return yield* Effect.die("Expected a pending permission request");
+      }
+      const responseExit = yield* runtime
+        .respondToRuntimeRequest({ requestId: pending.runtimeRequest.id, decision: "accept" })
+        .pipe(Effect.exit);
+      if (Exit.isSuccess(responseExit)) {
+        assert.fail("missing native response acknowledgement must fail the pending response");
+      }
+      assert.include(Cause.pretty(responseExit.cause), "Native response acknowledgement timed out");
+      assert.isTrue(yield* Deferred.isDone(responseEnqueued));
+      assert.isFalse(yield* Deferred.isDone(releaseNativeHook));
+      assert.isBelow(responseLifecycle.indexOf("removed"), responseLifecycle.indexOf("failed"));
+      assert.includeMembers(responseLifecycle, [
+        "registered",
+        "removed",
+        "failed",
+        "timer_exited",
+        "timer_started",
+        "watcher_exited",
+        "watcher_started",
+      ]);
+
+      yield* runtime.interruptTurn({
+        providerThread,
+        providerTurnId: pending.runtimeRequest.providerTurnId,
+        requestRuntimeRestart: true,
+      });
+      assert.isTrue(yield* Deferred.isDone(releaseNativeHook));
+      yield* Effect.sleep("50 millis");
+      assert.include(responseLifecycle, "late_noop");
+      yield* Scope.close(sessionScope, Exit.void);
+      assert.notInclude(yield* pollProtocolMethods(protocolEvents), "session/close");
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.live("defers caller cancellation until a pending response acknowledgement is bounded", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const responseEnqueued = yield* Deferred.make<void>();
+      const releaseNativeHook = yield* Deferred.make<void>();
+      const instanceId = ProviderInstanceId.make("acp-test-pending-response-cancel");
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          restartRuntimeAfterInterrupt: true,
+          terminateRuntimeProcessGroupOnInterrupt: true,
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            mockAgentPath,
+            environment: {
+              T3_ACP_EMIT_TOOL_CALLS: "1",
+              T3_ACP_HANG_AFTER_PERMISSION: "1",
+            },
+            ownDetachedProcessGroup: true,
+            processGroupPlatform: "win32",
+            windowsProcessTreeTerminator: (pid) =>
+              Deferred.succeed(releaseNativeHook, undefined).pipe(
+                Effect.andThen(
+                  Effect.sync(() => {
+                    process.kill(pid, "SIGTERM");
+                  }),
+                ),
+              ),
+            wrapOutgoingResponse: (onOutgoingResponse) => (requestId) =>
+              Deferred.succeed(responseEnqueued, undefined).pipe(
+                Effect.andThen(Deferred.await(releaseNativeHook)),
+                Effect.andThen(onOutgoingResponse(requestId)),
+              ),
+          }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+      });
+      const threadId = ThreadId.make("thread-acp-pending-response-cancel");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "approval-required",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make("provider-session-acp-pending-response-cancel"),
+        modelSelection,
+        runtimePolicy,
+      });
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      yield* runtime.startTurn(
+        makeTurnInput({
+          threadId,
+          providerThread,
+          instanceId,
+          runtimePolicy,
+          now: yield* DateTime.now,
+        }),
+      );
+      const pending = Option.getOrThrow(
+        yield* runtime.events.pipe(
+          Stream.filter(
+            (event) =>
+              event.type === "runtime_request.updated" && event.runtimeRequest.status === "pending",
+          ),
+          Stream.runHead,
+        ),
+      );
+      if (
+        pending.type !== "runtime_request.updated" ||
+        pending.runtimeRequest.providerTurnId === null
+      ) {
+        return yield* Effect.die("Expected a pending permission request");
+      }
+      const responseFiber = yield* runtime
+        .respondToRuntimeRequest({ requestId: pending.runtimeRequest.id, decision: "accept" })
+        .pipe(Effect.forkScoped);
+      yield* Deferred.await(responseEnqueued);
+      const cancellationFiber = yield* Fiber.interrupt(responseFiber).pipe(Effect.forkScoped);
+      const interruptFiber = yield* runtime
+        .interruptTurn({
+          providerThread,
+          providerTurnId: pending.runtimeRequest.providerTurnId,
+          requestRuntimeRestart: true,
+        })
+        .pipe(Effect.forkScoped);
+      yield* Effect.sleep("100 millis");
+      assert.isUndefined(cancellationFiber.pollUnsafe());
+      assert.isUndefined(interruptFiber.pollUnsafe());
+      assert.isFalse(yield* Deferred.isDone(releaseNativeHook));
+
+      yield* Fiber.join(cancellationFiber);
+      yield* Fiber.join(interruptFiber);
+      assert.isTrue(yield* Deferred.isDone(releaseNativeHook));
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.live("waits for immediate allow and deny permission responses before hard teardown", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+
+      for (const [name, sandboxPolicy] of [
+        ["allow", undefined],
+        ["deny", { type: "readOnly" } as const],
+      ] as const) {
+        yield* Effect.gen(function* () {
+          const responseEnqueued = yield* Deferred.make<void>();
+          const releaseResponseAcknowledgement = yield* Deferred.make<void>();
+          const instanceId = ProviderInstanceId.make(`acp-test-${name}`);
+          const adapter = makeAcpAdapterV2({
+            crypto: yield* Crypto.Crypto,
+            instanceId,
+            flavor: {
+              driver: ACP_TEST_DRIVER,
+              capabilities: AcpProviderCapabilitiesV2,
+              restartRuntimeAfterInterrupt: true,
+              terminateRuntimeProcessGroupOnInterrupt: true,
+              makeRuntime: makeMockRuntime({
+                childProcessSpawner,
+                mockAgentPath,
+                environment: { T3_ACP_EMIT_TOOL_CALLS: "1" },
+                ownDetachedProcessGroup: true,
+                processGroupPlatform: "win32",
+                windowsProcessTreeTerminator: (pid) =>
+                  Effect.sync(() => {
+                    process.kill(pid, "SIGTERM");
+                  }),
+                wrapOutgoingResponse: (onOutgoingResponse) => (requestId) =>
+                  Deferred.succeed(responseEnqueued, undefined).pipe(
+                    Effect.andThen(Deferred.await(releaseResponseAcknowledgement)),
+                    Effect.andThen(onOutgoingResponse(requestId)),
+                  ),
+              }),
+            },
+            fileSystem,
+            idAllocator,
+            serverConfig,
+          });
+          const threadId = ThreadId.make(`thread-acp-immediate-permission-${name}`);
+          const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+            runtimeMode: "full-access",
+            interactionMode: "default",
+            approvalPolicy: "never",
+            cwd: process.cwd(),
+            ...(sandboxPolicy === undefined ? {} : { sandboxPolicy }),
+          });
+          const modelSelection = { instanceId, model: "default" } as const;
+          const runtime = yield* adapter.openSession({
+            threadId,
+            providerSessionId: ProviderSessionId.make(
+              `provider-session-acp-immediate-permission-${name}`,
+            ),
+            modelSelection,
+            runtimePolicy,
+          });
+          const providerThread = yield* runtime.ensureThread({
+            threadId,
+            modelSelection,
+            runtimePolicy,
+          });
+          const turnFiber = yield* runtime
+            .startTurn(
+              makeTurnInput({
+                threadId,
+                providerThread,
+                instanceId,
+                runtimePolicy,
+                now: yield* DateTime.now,
+              }),
+            )
+            .pipe(Effect.forkDetach);
+          yield* Deferred.await(responseEnqueued);
+          const interruptFiber = yield* runtime
+            .interruptTurn({
+              providerThread,
+              providerTurnId: idAllocator.derive.providerTurn({
+                driver: ACP_TEST_DRIVER,
+                nativeTurnId: "mock-session-1:turn:1",
+              }),
+              requestRuntimeRestart: true,
+            })
+            .pipe(Effect.forkScoped);
+          yield* Effect.yieldNow;
+          assert.isUndefined(interruptFiber.pollUnsafe());
+
+          yield* Deferred.succeed(releaseResponseAcknowledgement, undefined);
+          yield* Fiber.join(interruptFiber);
+          yield* Fiber.interrupt(turnFiber).pipe(Effect.forkDetach);
+        }).pipe(Effect.scoped);
+      }
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.live("waits for immediate URL elicitation responses before hard teardown", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const responseEnqueued = yield* Deferred.make<void>();
+      const releaseResponseAcknowledgement = yield* Deferred.make<void>();
+      const instanceId = ProviderInstanceId.make("acp-test-url-elicitation");
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          restartRuntimeAfterInterrupt: true,
+          terminateRuntimeProcessGroupOnInterrupt: true,
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            mockAgentPath,
+            environment: { T3_ACP_EMIT_URL_ELICITATION: "1" },
+            ownDetachedProcessGroup: true,
+            processGroupPlatform: "win32",
+            windowsProcessTreeTerminator: (pid) =>
+              Effect.sync(() => {
+                process.kill(pid, "SIGTERM");
+              }),
+            wrapOutgoingResponse: (onOutgoingResponse) => (requestId) =>
+              Deferred.succeed(responseEnqueued, undefined).pipe(
+                Effect.andThen(Deferred.await(releaseResponseAcknowledgement)),
+                Effect.andThen(onOutgoingResponse(requestId)),
+              ),
+          }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+      });
+      const threadId = ThreadId.make("thread-acp-immediate-url-elicitation");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make("provider-session-acp-immediate-url-elicitation"),
+        modelSelection,
+        runtimePolicy,
+      });
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      const turnFiber = yield* runtime
+        .startTurn(
+          makeTurnInput({
+            threadId,
+            providerThread,
+            instanceId,
+            runtimePolicy,
+            now: yield* DateTime.now,
+          }),
+        )
+        .pipe(Effect.forkDetach);
+      yield* Deferred.await(responseEnqueued);
+      const interruptFiber = yield* runtime
+        .interruptTurn({
+          providerThread,
+          providerTurnId: idAllocator.derive.providerTurn({
+            driver: ACP_TEST_DRIVER,
+            nativeTurnId: "mock-session-1:turn:1",
+          }),
+          requestRuntimeRestart: true,
+        })
+        .pipe(Effect.forkScoped);
+      yield* Effect.yieldNow;
+      assert.isUndefined(interruptFiber.pollUnsafe());
+
+      yield* Deferred.succeed(releaseResponseAcknowledgement, undefined);
+      yield* Fiber.join(interruptFiber);
+      yield* Fiber.interrupt(turnFiber).pipe(Effect.forkDetach);
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.live("bounds a missing immediate response acknowledgement before hard teardown", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const responseEnqueued = yield* Deferred.make<void>();
+      const releaseNativeHook = yield* Deferred.make<void>();
+      const instanceId = ProviderInstanceId.make("acp-test-missing-response-ack");
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          restartRuntimeAfterInterrupt: true,
+          terminateRuntimeProcessGroupOnInterrupt: true,
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            mockAgentPath,
+            environment: { T3_ACP_EMIT_TOOL_CALLS: "1" },
+            ownDetachedProcessGroup: true,
+            processGroupPlatform: "win32",
+            windowsProcessTreeTerminator: (pid) =>
+              Deferred.succeed(releaseNativeHook, undefined).pipe(
+                Effect.andThen(
+                  Effect.sync(() => {
+                    process.kill(pid, "SIGTERM");
+                  }),
+                ),
+              ),
+            wrapOutgoingResponse: (onOutgoingResponse) => (requestId) =>
+              Deferred.succeed(responseEnqueued, undefined).pipe(
+                Effect.andThen(Deferred.await(releaseNativeHook)),
+                Effect.andThen(onOutgoingResponse(requestId)),
+              ),
+          }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+      });
+      const threadId = ThreadId.make("thread-acp-missing-response-ack");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        approvalPolicy: "never",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make("provider-session-acp-missing-response-ack"),
+        modelSelection,
+        runtimePolicy,
+      });
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      const turnFiber = yield* runtime
+        .startTurn(
+          makeTurnInput({
+            threadId,
+            providerThread,
+            instanceId,
+            runtimePolicy,
+            now: yield* DateTime.now,
+          }),
+        )
+        .pipe(Effect.forkDetach);
+      yield* Deferred.await(responseEnqueued);
+      const startedAt = yield* Clock.currentTimeMillis;
+      yield* runtime.interruptTurn({
+        providerThread,
+        providerTurnId: idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:1",
+        }),
+        requestRuntimeRestart: true,
+      });
+      assert.isAtLeast((yield* Clock.currentTimeMillis) - startedAt, 1_500);
+      yield* Fiber.interrupt(turnFiber).pipe(Effect.forkDetach);
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.live("rejects an elicitation response when hard teardown wins admission", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const teardownStarted = yield* Deferred.make<void>();
+      const releaseTeardown = yield* Deferred.make<void>();
+      const instanceId = ProviderInstanceId.make("acp-test");
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          restartRuntimeAfterInterrupt: true,
+          terminateRuntimeProcessGroupOnInterrupt: true,
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            mockAgentPath,
+            environment: { T3_ACP_EMIT_ELICITATION: "1" },
+            ownDetachedProcessGroup: true,
+            processGroupPlatform: "win32",
+            windowsProcessTreeTerminator: (pid) =>
+              Deferred.succeed(teardownStarted, undefined).pipe(
+                Effect.andThen(Deferred.await(releaseTeardown)),
+                Effect.andThen(
+                  Effect.sync(() => {
+                    process.kill(pid, "SIGTERM");
+                  }),
+                ),
+              ),
+          }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+      });
+      const threadId = ThreadId.make("thread-acp-teardown-wins-elicitation");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "approval-required",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make("provider-session-acp-teardown-wins-elicitation"),
+        modelSelection,
+        runtimePolicy,
+      });
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      yield* runtime.startTurn(
+        makeTurnInput({
+          threadId,
+          providerThread,
+          instanceId,
+          runtimePolicy,
+          now: yield* DateTime.now,
+        }),
+      );
+      const pending = Option.getOrThrow(
+        yield* runtime.events.pipe(
+          Stream.filter(
+            (event) =>
+              event.type === "runtime_request.updated" && event.runtimeRequest.status === "pending",
+          ),
+          Stream.runHead,
+        ),
+      );
+      if (
+        pending.type !== "runtime_request.updated" ||
+        pending.runtimeRequest.providerTurnId === null
+      ) {
+        return yield* Effect.die("Expected a pending elicitation request");
+      }
+      const interruptFiber = yield* runtime
+        .interruptTurn({
+          providerThread,
+          providerTurnId: pending.runtimeRequest.providerTurnId,
+          requestRuntimeRestart: true,
+        })
+        .pipe(Effect.forkScoped);
+      yield* Deferred.await(teardownStarted);
+      const responseFiber = yield* runtime
+        .respondToRuntimeRequest({
+          requestId: pending.runtimeRequest.id,
+          answers: { approved: ["true"] },
+        })
+        .pipe(Effect.exit, Effect.forkScoped);
+      yield* Effect.yieldNow;
+      assert.isUndefined(responseFiber.pollUnsafe());
+
+      yield* Deferred.succeed(releaseTeardown, undefined);
+      yield* Fiber.join(interruptFiber);
+      const responseExit = yield* Fiber.join(responseFiber);
+      if (Exit.isSuccess(responseExit)) {
+        assert.fail("teardown winning admission must reject the elicitation response");
+      }
+      assert.include(Cause.pretty(responseExit.cause), "No pending ACP runtime request");
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect("releases an ACP turn when cancellation times out", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const instanceId = ProviderInstanceId.make("acp-test");
+      const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            mockAgentPath,
+            environment: { T3_ACP_PROMPT_DELAY_MS: "5000" },
+            protocolEvents,
+          }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+      });
+      const threadId = ThreadId.make("thread-acp-cancel-timeout");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make("provider-session-acp-cancel-timeout"),
+        modelSelection,
+        runtimePolicy,
+      });
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      const now = yield* DateTime.now;
+      const firstTurn = makeTurnInput({
+        threadId,
+        providerThread,
+        instanceId,
+        runtimePolicy,
+        now,
+      });
+      yield* runtime.startTurn(firstTurn);
+      yield* Stream.fromQueue(protocolEvents).pipe(
+        Stream.filter(
+          (event) =>
+            event.direction === "outgoing" && rawProtocolMethod(event) === "session/prompt",
+        ),
+        Stream.runHead,
+      );
+      const providerTurnId = idAllocator.derive.providerTurn({
+        driver: ACP_TEST_DRIVER,
+        nativeTurnId: "mock-session-1:turn:1",
+      });
+      const interruptFiber = yield* runtime
+        .interruptTurn({ providerThread, providerTurnId })
+        .pipe(Effect.flip, Effect.forkScoped);
+      yield* Stream.fromQueue(protocolEvents).pipe(
+        Stream.filter(
+          (event) =>
+            event.direction === "outgoing" && rawProtocolMethod(event) === "session/cancel",
+        ),
+        Stream.runHead,
+      );
+      yield* TestClock.adjust("10 seconds");
+      const interruptError = yield* Fiber.join(interruptFiber);
+      assert.equal(interruptError._tag, "ProviderAdapterInterruptError");
+
+      yield* runtime.startTurn(
+        makeTurnInput({
+          threadId,
+          providerThread,
+          instanceId,
+          runtimePolicy,
+          now,
+          ordinal: 2,
+        }),
+      );
+      yield* Stream.fromQueue(protocolEvents).pipe(
+        Stream.filter(
+          (event) =>
+            event.direction === "outgoing" && rawProtocolMethod(event) === "session/prompt",
+        ),
+        Stream.runHead,
+      );
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.live("treats a second hard Stop as success when the turn is already gone", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+      const instanceId = ProviderInstanceId.make("acp-test");
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          interruptPromptOnCancel: false,
+          restartRuntimeAfterInterrupt: true,
+          terminateRuntimeProcessGroupOnInterrupt: true,
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            mockAgentPath,
+            ownDetachedProcessGroup: true,
+            environment: { T3_ACP_HANG_PROMPT_FOREVER: "1" },
+            protocolEvents,
+          }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+      });
+      const threadId = ThreadId.make("thread-acp-double-stop");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make("provider-session-acp-double-stop"),
+        modelSelection,
+        runtimePolicy,
+      });
+      const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+      yield* runtime.events.pipe(
+        Stream.runForEach((event) => Queue.offer(events, event)),
+        Effect.forkScoped,
+      );
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      const now = yield* DateTime.now;
+      yield* runtime
+        .startTurn(makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now }))
+        .pipe(Effect.forkScoped);
+      yield* Stream.fromQueue(protocolEvents).pipe(
+        Stream.filter(
+          (event) =>
+            event.direction === "outgoing" && rawProtocolMethod(event) === "session/prompt",
+        ),
+        Stream.runHead,
+      );
+      const providerTurnId = idAllocator.derive.providerTurn({
+        driver: ACP_TEST_DRIVER,
+        nativeTurnId: "mock-session-1:turn:1",
+      });
+      yield* runtime.interruptTurn({
+        providerThread,
+        providerTurnId,
+        requestRuntimeRestart: true,
+      });
+      // Second durable interrupt after activeTurn is cleared must not fail.
+      const second = yield* Effect.exit(
+        runtime.interruptTurn({
+          providerThread,
+          providerTurnId,
+          requestRuntimeRestart: true,
+        }),
+      );
+      assert.isTrue(Exit.isSuccess(second), "duplicate hard Stop must be idempotent");
+      let terminal: string | null = null;
+      while (terminal === null) {
+        const event = yield* Queue.take(events);
+        if (event.type === "turn.terminal" && event.providerTurnId === providerTurnId) {
+          terminal = event.status;
+        }
+      }
+      assert.equal(terminal, "interrupted");
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect("finalizes a settled turn held open for background work when interrupted", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+      const instanceId = ProviderInstanceId.make("acp-test");
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          deferFinalizeForBackgroundWork: true,
+          extractSubagentUpdate: (toolCall) =>
+            toolCall.toolCallId === "tool-call-generic-1"
+              ? {
+                  nativeTaskId: "task-generic-1",
+                  prompt: "background subagent",
+                  title: "background subagent",
+                  model: null,
+                  status: "running",
+                  childSessionId: null,
+                  result: null,
+                }
+              : undefined,
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            mockAgentPath,
+            environment: { T3_ACP_EMIT_GENERIC_TOOL_PLACEHOLDERS: "1" },
+            protocolEvents,
+          }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+      });
+      const threadId = ThreadId.make("thread-acp-interrupt-background-hold");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make("provider-session-acp-interrupt-background"),
+        modelSelection,
+        runtimePolicy,
+      });
+      const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+      yield* runtime.events.pipe(
+        Stream.runForEach((event) => Queue.offer(events, event)),
+        Effect.forkScoped,
+      );
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      const now = yield* DateTime.now;
+      yield* runtime.startTurn(
+        makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now }),
+      );
+      // The still-running subagent defers finalize after session/prompt returns.
+      yield* Stream.fromQueue(protocolEvents).pipe(
+        Stream.filter(
+          (event) =>
+            event.direction === "incoming" &&
+            event.stage === "raw" &&
+            typeof event.payload === "string" &&
+            event.payload.includes('"stopReason"'),
+        ),
+        Stream.runHead,
+      );
+      yield* Effect.yieldNow;
+      yield* Effect.yieldNow;
+
+      const providerTurnId = idAllocator.derive.providerTurn({
+        driver: ACP_TEST_DRIVER,
+        nativeTurnId: "mock-session-1:turn:1",
+      });
+      const interruptFiber = yield* runtime
+        .interruptTurn({ providerThread, providerTurnId })
+        .pipe(Effect.forkScoped);
+      yield* TestClock.adjust("10 seconds");
+      yield* Fiber.join(interruptFiber);
+
+      let terminalStatus: string | null = null;
+      while (terminalStatus === null) {
+        const event = yield* Queue.take(events);
+        if (event.type === "turn.terminal" && event.providerTurnId === providerTurnId) {
+          terminalStatus = event.status;
+        }
+      }
+      assert.equal(terminalStatus, "interrupted");
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect(
+    "carries a live subagent lineage across an interrupt so the next turn can complete it",
+    () =>
+      Effect.gen(function* () {
+        const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+        const fileSystem = yield* FileSystem.FileSystem;
+        const idAllocator = yield* IdAllocatorV2;
+        const path = yield* Path.Path;
+        const serverConfig = yield* ServerConfig;
+        const mockAgentPath = yield* path.fromFileUrl(
+          new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+        );
+        const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+        const instanceId = ProviderInstanceId.make("acp-test");
+        let subagentPhase: "spawn" | "complete" = "spawn";
+        const adapter = makeAcpAdapterV2({
+          crypto: yield* Crypto.Crypto,
+          instanceId,
+          flavor: {
+            driver: ACP_TEST_DRIVER,
+            capabilities: AcpProviderCapabilitiesV2,
+            deferFinalizeForBackgroundWork: true,
+            extractSubagentUpdate: (toolCall) =>
+              toolCall.toolCallId !== "tool-call-generic-1"
+                ? undefined
+                : subagentPhase === "spawn"
+                  ? {
+                      nativeTaskId: "task-generic-1",
+                      prompt: "background subagent",
+                      title: "background subagent",
+                      model: null,
+                      status: "running",
+                      childSessionId: null,
+                      result: null,
+                    }
+                  : // Hydration-only shape (empty prompt, null title): without a
+                    // carried-over lineage this update is dropped and the item
+                    // stays running forever.
+                    {
+                      nativeTaskId: "task-generic-1",
+                      prompt: "",
+                      title: null,
+                      model: null,
+                      status: "completed",
+                      childSessionId: null,
+                      result: "SUB_DONE",
+                    },
+            makeRuntime: makeMockRuntime({
+              childProcessSpawner,
+              mockAgentPath,
+              environment: { T3_ACP_EMIT_GENERIC_TOOL_PLACEHOLDERS: "1" },
+              protocolEvents,
+            }),
+          },
+          fileSystem,
+          idAllocator,
+          serverConfig,
+        });
+        const threadId = ThreadId.make("thread-acp-subagent-carryover");
+        const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          cwd: process.cwd(),
+        });
+        const modelSelection = { instanceId, model: "default" } as const;
+        const runtime = yield* adapter.openSession({
+          threadId,
+          providerSessionId: ProviderSessionId.make("provider-session-acp-subagent-carryover"),
+          modelSelection,
+          runtimePolicy,
+        });
+        const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+        yield* runtime.events.pipe(
+          Stream.runForEach((event) => Queue.offer(events, event)),
+          Effect.forkScoped,
+        );
+        const providerThread = yield* runtime.ensureThread({
+          threadId,
+          modelSelection,
+          runtimePolicy,
+        });
+        const now = yield* DateTime.now;
+        yield* runtime.startTurn(
+          makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now }),
+        );
+        yield* Stream.fromQueue(protocolEvents).pipe(
+          Stream.filter(
+            (event) =>
+              event.direction === "incoming" &&
+              event.stage === "raw" &&
+              typeof event.payload === "string" &&
+              event.payload.includes('"stopReason"'),
+          ),
+          Stream.runHead,
+        );
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+
+        const firstProviderTurnId = idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:1",
+        });
+        const interruptFiber = yield* runtime
+          .interruptTurn({ providerThread, providerTurnId: firstProviderTurnId })
+          .pipe(Effect.forkScoped);
+        yield* TestClock.adjust("10 seconds");
+        yield* Fiber.join(interruptFiber);
+
+        let subagentTurnItemId: string | null = null;
+        let firstTerminalStatus: string | null = null;
+        while (firstTerminalStatus === null) {
+          const event = yield* Queue.take(events);
+          if (event.type === "turn_item.updated" && event.turnItem.type === "subagent") {
+            subagentTurnItemId = event.turnItem.id;
+          }
+          if (event.type === "turn.terminal" && event.providerTurnId === firstProviderTurnId) {
+            firstTerminalStatus = event.status;
+          }
+        }
+        assert.equal(firstTerminalStatus, "interrupted");
+        assert.notEqual(subagentTurnItemId, null);
+
+        subagentPhase = "complete";
+        const secondNow = yield* DateTime.now;
+        yield* runtime.startTurn(
+          makeTurnInput({
+            threadId,
+            providerThread,
+            instanceId,
+            runtimePolicy,
+            now: secondNow,
+            ordinal: 2,
+          }),
+        );
+        const secondProviderTurnId = idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:2",
+        });
+        let carriedItemStatus: string | null = null;
+        let secondTerminalStatus: string | null = null;
+        while (secondTerminalStatus === null) {
+          const event = yield* Queue.take(events);
+          if (
+            event.type === "turn_item.updated" &&
+            event.turnItem.type === "subagent" &&
+            event.turnItem.id === subagentTurnItemId
+          ) {
+            carriedItemStatus = event.turnItem.status;
+          }
+          if (event.type === "turn.terminal" && event.providerTurnId === secondProviderTurnId) {
+            secondTerminalStatus = event.status;
+          }
+        }
+        assert.equal(carriedItemStatus, "completed");
+        assert.equal(secondTerminalStatus, "completed");
+      }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect(
+    "pins hasPendingBackgroundWork while carryover holds a live subagent after root settle",
+    () =>
+      Effect.gen(function* () {
+        const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+        const fileSystem = yield* FileSystem.FileSystem;
+        const idAllocator = yield* IdAllocatorV2;
+        const path = yield* Path.Path;
+        const serverConfig = yield* ServerConfig;
+        const mockAgentPath = yield* path.fromFileUrl(
+          new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+        );
+        const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+        const instanceId = ProviderInstanceId.make("acp-test");
+        let subagentPhase: "spawn" | "complete" = "spawn";
+        const adapter = makeAcpAdapterV2({
+          crypto: yield* Crypto.Crypto,
+          instanceId,
+          flavor: {
+            driver: ACP_TEST_DRIVER,
+            capabilities: AcpProviderCapabilitiesV2,
+            deferFinalizeForBackgroundWork: true,
+            enablePostSettleContinuation: true,
+            extractSubagentUpdate: (toolCall) =>
+              toolCall.toolCallId !== "tool-call-generic-1"
+                ? undefined
+                : subagentPhase === "spawn"
+                  ? {
+                      nativeTaskId: "task-generic-1",
+                      prompt: "background subagent",
+                      title: "background subagent",
+                      model: null,
+                      status: "running",
+                      childSessionId: null,
+                      result: null,
+                    }
+                  : {
+                      nativeTaskId: "task-generic-1",
+                      prompt: "",
+                      title: null,
+                      model: null,
+                      status: "completed",
+                      childSessionId: null,
+                      result: "SUB_DONE",
+                    },
+            makeRuntime: makeMockRuntime({
+              childProcessSpawner,
+              mockAgentPath,
+              environment: { T3_ACP_EMIT_GENERIC_TOOL_PLACEHOLDERS: "1" },
+              protocolEvents,
+            }),
+          },
+          fileSystem,
+          idAllocator,
+          serverConfig,
+          continuationRequests: { offer: () => Effect.void },
+        });
+        const threadId = ThreadId.make("thread-acp-carryover-pending-pin");
+        const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          cwd: process.cwd(),
+        });
+        const modelSelection = { instanceId, model: "default" } as const;
+        const runtime = yield* adapter.openSession({
+          threadId,
+          providerSessionId: ProviderSessionId.make("provider-session-acp-carryover-pending-pin"),
+          modelSelection,
+          runtimePolicy,
+        });
+        if (runtime.hasPendingBackgroundWork === undefined) {
+          return yield* Effect.die(
+            "ACP runtime must expose hasPendingBackgroundWork when post-settle continuation is enabled.",
+          );
+        }
+        const hasPendingBackgroundWork = runtime.hasPendingBackgroundWork;
+        const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+        yield* runtime.events.pipe(
+          Stream.runForEach((event) => Queue.offer(events, event)),
+          Effect.forkScoped,
+        );
+        const providerThread = yield* runtime.ensureThread({
+          threadId,
+          modelSelection,
+          runtimePolicy,
+        });
+        const now = yield* DateTime.now;
+        yield* runtime.startTurn(
+          makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now }),
+        );
+        yield* Stream.fromQueue(protocolEvents).pipe(
+          Stream.filter(
+            (event) =>
+              event.direction === "incoming" &&
+              event.stage === "raw" &&
+              typeof event.payload === "string" &&
+              event.payload.includes('"stopReason"'),
+          ),
+          Stream.runHead,
+        );
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+
+        const firstProviderTurnId = idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:1",
+        });
+        const interruptFiber = yield* runtime
+          .interruptTurn({ providerThread, providerTurnId: firstProviderTurnId })
+          .pipe(Effect.forkScoped);
+        yield* TestClock.adjust("10 seconds");
+        yield* Fiber.join(interruptFiber);
+
+        let firstTerminalStatus: string | null = null;
+        while (firstTerminalStatus === null) {
+          const event = yield* Queue.take(events);
+          if (event.type === "turn.terminal" && event.providerTurnId === firstProviderTurnId) {
+            firstTerminalStatus = event.status;
+          }
+        }
+        assert.equal(firstTerminalStatus, "interrupted");
+        // Root settled with a live projected subagent in carryover: pin idle release.
+        assert.isTrue(
+          yield* hasPendingBackgroundWork,
+          "carryover live subagent must pin hasPendingBackgroundWork after root settle",
+        );
+
+        subagentPhase = "complete";
+        const secondNow = yield* DateTime.now;
+        yield* runtime.startTurn(
+          makeTurnInput({
+            threadId,
+            providerThread,
+            instanceId,
+            runtimePolicy,
+            now: secondNow,
+            ordinal: 2,
+          }),
+        );
+        const secondProviderTurnId = idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:2",
+        });
+        let secondTerminalStatus: string | null = null;
+        while (secondTerminalStatus === null) {
+          const event = yield* Queue.take(events);
+          if (event.type === "turn.terminal" && event.providerTurnId === secondProviderTurnId) {
+            secondTerminalStatus = event.status;
+          }
+        }
+        assert.equal(secondTerminalStatus, "completed");
+        // Carryover is consumed into the next turn and terminalized; pin clears.
+        assert.isFalse(
+          yield* hasPendingBackgroundWork,
+          "hasPendingBackgroundWork must clear after carryover subagent terminals",
+        );
+      }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect("handles a child terminal after carryover rehydrate", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+      const secondPromptWireReturned = yield* Deferred.make<void>();
+      const releaseSecondPromptCompletion = yield* Deferred.make<void>();
+      const instanceId = ProviderInstanceId.make("acp-test");
+      const childSessionId = "mock-child-session-active-carryover";
+      let promptCount = 0;
+      let subagentPhase: "spawn" | "complete" = "spawn";
+      type RuntimeService = AcpSessionRuntime.AcpSessionRuntime["Service"];
+      let sessionUpdateHandler: Parameters<RuntimeService["handleSessionUpdate"]>[0] | undefined;
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          deferFinalizeForBackgroundWork: true,
+          enablePostSettleContinuation: true,
+          extractSubagentUpdate: (toolCall) =>
+            toolCall.toolCallId !== "tool-call-generic-1"
+              ? undefined
+              : subagentPhase === "spawn"
+                ? {
+                    nativeTaskId: "task-generic-1",
+                    prompt: "background subagent",
+                    title: "background subagent",
+                    model: null,
+                    status: "running",
+                    childSessionId,
+                    result: null,
+                  }
+                : {
+                    nativeTaskId: "task-generic-1",
+                    prompt: "",
+                    title: null,
+                    model: null,
+                    status: "completed",
+                    childSessionId,
+                    result: "SUB_DONE",
+                  },
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            mockAgentPath,
+            environment: { T3_ACP_EMIT_GENERIC_TOOL_PLACEHOLDERS: "1" },
+            protocolEvents,
+            wrapRuntime: (runtime) => ({
+              ...runtime,
+              handleSessionUpdate: (handler) =>
+                Effect.sync(() => {
+                  sessionUpdateHandler = handler;
+                }).pipe(Effect.andThen(runtime.handleSessionUpdate(handler))),
+              prompt: (payload) =>
+                Effect.gen(function* () {
+                  const currentPrompt = ++promptCount;
+                  const result = yield* runtime.prompt(payload);
+                  if (currentPrompt === 2) {
+                    yield* Deferred.succeed(secondPromptWireReturned, undefined);
+                    yield* Deferred.await(releaseSecondPromptCompletion);
+                  }
+                  return result;
+                }),
+            }),
+          }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+        continuationRequests: { offer: () => Effect.void },
+      });
+      const threadId = ThreadId.make("thread-acp-active-carryover-pending-pin");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make(
+          "provider-session-acp-active-carryover-pending-pin",
+        ),
+        modelSelection,
+        runtimePolicy,
+      });
+      if (runtime.hasPendingBackgroundWork === undefined) {
+        return yield* Effect.die(
+          "ACP runtime must expose hasPendingBackgroundWork when post-settle continuation is enabled.",
+        );
+      }
+      const hasPendingBackgroundWork = runtime.hasPendingBackgroundWork;
+      const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+      yield* runtime.events.pipe(
+        Stream.runForEach((event) => Queue.offer(events, event)),
+        Effect.forkScoped,
+      );
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      const now = yield* DateTime.now;
+      yield* runtime.startTurn(
+        makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now }),
+      );
+      yield* Stream.fromQueue(protocolEvents).pipe(
+        Stream.filter(
+          (event) =>
+            event.direction === "incoming" &&
+            event.stage === "raw" &&
+            typeof event.payload === "string" &&
+            event.payload.includes('"stopReason"'),
+        ),
+        Stream.runHead,
+      );
+      yield* Effect.yieldNow;
+      yield* Effect.yieldNow;
+
+      const firstProviderTurnId = idAllocator.derive.providerTurn({
+        driver: ACP_TEST_DRIVER,
+        nativeTurnId: "mock-session-1:turn:1",
+      });
+      const interruptFiber = yield* runtime
+        .interruptTurn({ providerThread, providerTurnId: firstProviderTurnId })
+        .pipe(Effect.forkScoped);
+      yield* TestClock.adjust("10 seconds");
+      yield* Fiber.join(interruptFiber);
+
+      let firstTerminalStatus: string | null = null;
+      while (firstTerminalStatus === null) {
+        const event = yield* Queue.take(events);
+        if (event.type === "turn.terminal" && event.providerTurnId === firstProviderTurnId) {
+          firstTerminalStatus = event.status;
+        }
+      }
+      assert.equal(firstTerminalStatus, "interrupted");
+      assert.isTrue(yield* hasPendingBackgroundWork);
+      assert.isDefined(sessionUpdateHandler, "session update handler must be wired");
+
+      const secondNow = yield* DateTime.now;
+      const secondTurnFiber = yield* runtime
+        .startTurn(
+          makeTurnInput({
+            threadId,
+            providerThread,
+            instanceId,
+            runtimePolicy,
+            now: secondNow,
+            ordinal: 2,
+          }),
+        )
+        .pipe(Effect.forkScoped);
+      yield* Deferred.await(secondPromptWireReturned);
+      assert.isTrue(
+        yield* hasPendingBackgroundWork,
+        "rehydrated live subagent must pin from activeTurn",
+      );
+      while (Option.isSome(yield* Queue.poll(events))) {
+        // Discard setup events so the assertions below cover only child-session
+        // tool traffic after rehydration.
+      }
+
+      subagentPhase = "complete";
+      yield* sessionUpdateHandler!({
+        sessionId: childSessionId,
+        update: {
+          sessionUpdate: "tool_call_update",
+          toolCallId: "tool-call-generic-1",
+          title: "background subagent",
+          kind: "other",
+          status: "completed",
+          rawOutput: { content: "SUB_DONE" },
+        },
+      });
+      // Duplicate terminal replay is harmless, and an older running frame cannot
+      // resurrect the completed lineage.
+      yield* sessionUpdateHandler!({
+        sessionId: childSessionId,
+        update: {
+          sessionUpdate: "tool_call_update",
+          toolCallId: "tool-call-generic-1",
+          title: "background subagent",
+          kind: "other",
+          status: "completed",
+          rawOutput: { content: "SUB_DONE" },
+        },
+      });
+      subagentPhase = "spawn";
+      yield* sessionUpdateHandler!({
+        sessionId: childSessionId,
+        update: {
+          sessionUpdate: "tool_call_update",
+          toolCallId: "tool-call-generic-1",
+          title: "background subagent",
+          kind: "other",
+          status: "in_progress",
+          rawOutput: {},
+        },
+      });
+      yield* Effect.yieldNow;
+      yield* Effect.yieldNow;
+      assert.isFalse(
+        yield* hasPendingBackgroundWork,
+        "active-turn pin must clear after the child-session terminal is projected",
+      );
+      let completedSubagentUpdates = 0;
+      let resurrectedSubagentUpdates = 0;
+      let normalChildToolUpdates = 0;
+      let polled = yield* Queue.poll(events);
+      while (Option.isSome(polled)) {
+        const event = polled.value;
+        if (event.type === "turn_item.updated") {
+          if (event.turnItem.type === "subagent") {
+            if (event.turnItem.status === "completed") {
+              completedSubagentUpdates += 1;
+            }
+            if (
+              event.turnItem.status === "running" &&
+              event.turnItem.nativeItemRef?.nativeId === "task-generic-1"
+            ) {
+              resurrectedSubagentUpdates += 1;
+            }
+          } else if (event.turnItem.nativeItemRef?.nativeId === "tool-call-generic-1") {
+            normalChildToolUpdates += 1;
+          }
+        }
+        polled = yield* Queue.poll(events);
+      }
+      assert.equal(completedSubagentUpdates, 1);
+      assert.equal(resurrectedSubagentUpdates, 0);
+      assert.equal(normalChildToolUpdates, 0);
+
+      yield* Deferred.succeed(releaseSecondPromptCompletion, undefined);
+      yield* Fiber.join(secondTurnFiber);
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect(
+    "projects a child terminal in the completed-root finalization window exactly once",
+    () =>
+      Effect.gen(function* () {
+        const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+        const fileSystem = yield* FileSystem.FileSystem;
+        const idAllocator = yield* IdAllocatorV2;
+        const path = yield* Path.Path;
+        const serverConfig = yield* ServerConfig;
+        const mockAgentPath = yield* path.fromFileUrl(
+          new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+        );
+        const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+        const baseClock = yield* Clock.Clock;
+        const finalizationClockRead = yield* Deferred.make<void>();
+        const releaseFinalizationClockRead = yield* Deferred.make<void>();
+        let blockNextClockRead = false;
+        const blockingClock: Clock.Clock = {
+          ...baseClock,
+          currentTimeMillis: Effect.suspend(() => {
+            if (!blockNextClockRead) return baseClock.currentTimeMillis;
+            blockNextClockRead = false;
+            return Deferred.succeed(finalizationClockRead, undefined).pipe(
+              Effect.andThen(Deferred.await(releaseFinalizationClockRead)),
+              Effect.andThen(baseClock.currentTimeMillis),
+            );
+          }),
+        };
+        yield* Effect.gen(function* () {
+          const instanceId = ProviderInstanceId.make("acp-test");
+          const firstChildSessionId = "mock-child-session-finalize-window-first";
+          const secondChildSessionId = "mock-child-session-finalize-window-second";
+          let firstSubagentStatus: "running" | "completed" = "running";
+          // Keep the pending-work pin without blocking the deferred-finalize
+          // timer, so the test can stop inside finalizeTurn deterministically.
+          let secondSubagentStatus: "waiting" | "completed" = "waiting";
+          type RuntimeService = AcpSessionRuntime.AcpSessionRuntime["Service"];
+          let sessionUpdateHandler:
+            | Parameters<RuntimeService["handleSessionUpdate"]>[0]
+            | undefined;
+          const adapter = makeAcpAdapterV2({
+            crypto: yield* Crypto.Crypto,
+            instanceId,
+            flavor: {
+              driver: ACP_TEST_DRIVER,
+              capabilities: AcpProviderCapabilitiesV2,
+              deferFinalizeForBackgroundWork: true,
+              enablePostSettleContinuation: true,
+              settleRootTurnWhenIdle: true,
+              extractSubagentUpdate: (toolCall) => {
+                if (toolCall.toolCallId === "tool-call-generic-1") {
+                  return {
+                    nativeTaskId: "task-finalize-window-first",
+                    prompt: "first background subagent",
+                    title: "first background subagent",
+                    model: null,
+                    status: firstSubagentStatus,
+                    childSessionId: firstChildSessionId,
+                    result: firstSubagentStatus === "completed" ? "FIRST_DONE" : null,
+                    suppressNormalTool: true,
+                  };
+                }
+                if (toolCall.toolCallId === "tool-call-generic-2") {
+                  return {
+                    nativeTaskId: "task-finalize-window-second",
+                    prompt: "second background subagent",
+                    title: "second background subagent",
+                    model: null,
+                    status: secondSubagentStatus,
+                    childSessionId: secondChildSessionId,
+                    result: secondSubagentStatus === "completed" ? "SECOND_DONE" : null,
+                    suppressNormalTool: true,
+                  } as AcpAdapterV2SubagentUpdate;
+                }
+                return undefined;
+              },
+              makeRuntime: makeMockRuntime({
+                childProcessSpawner,
+                mockAgentPath,
+                environment: { T3_ACP_EMIT_GENERIC_TOOL_PLACEHOLDERS: "1" },
+                protocolEvents,
+                wrapRuntime: (runtime) => ({
+                  ...runtime,
+                  handleSessionUpdate: (handler) =>
+                    Effect.sync(() => {
+                      sessionUpdateHandler = handler;
+                    }).pipe(Effect.andThen(runtime.handleSessionUpdate(handler))),
+                }),
+              }),
+            },
+            fileSystem,
+            idAllocator,
+            serverConfig,
+            continuationRequests: { offer: () => Effect.void },
+          });
+          const threadId = ThreadId.make("thread-acp-subagent-finalize-window");
+          const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+            runtimeMode: "full-access",
+            interactionMode: "default",
+            cwd: process.cwd(),
+          });
+          const modelSelection = { instanceId, model: "default" } as const;
+          const runtime = yield* adapter.openSession({
+            threadId,
+            providerSessionId: ProviderSessionId.make(
+              "provider-session-acp-subagent-finalize-window",
+            ),
+            modelSelection,
+            runtimePolicy,
+          });
+          if (runtime.hasPendingBackgroundWork === undefined) {
+            return yield* Effect.die(
+              "ACP runtime must expose hasPendingBackgroundWork when post-settle continuation is enabled.",
+            );
+          }
+          const hasPendingBackgroundWork = runtime.hasPendingBackgroundWork;
+          const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+          yield* runtime.events.pipe(
+            Stream.runForEach((event) => Queue.offer(events, event)),
+            Effect.forkScoped,
+          );
+          const providerThread = yield* runtime.ensureThread({
+            threadId,
+            modelSelection,
+            runtimePolicy,
+          });
+          const now = yield* DateTime.now;
+          yield* runtime.startTurn(
+            makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now }),
+          );
+          yield* Stream.fromQueue(protocolEvents).pipe(
+            Stream.filter(
+              (event) =>
+                event.direction === "incoming" &&
+                event.stage === "raw" &&
+                typeof event.payload === "string" &&
+                event.payload.includes('"stopReason"'),
+            ),
+            Stream.runHead,
+          );
+          yield* Effect.yieldNow;
+          yield* Effect.yieldNow;
+          yield* TestClock.adjust("1 second");
+          assert.isDefined(sessionUpdateHandler, "session update handler must be wired");
+
+          firstSubagentStatus = "completed";
+          yield* sessionUpdateHandler!({
+            sessionId: "mock-session-1",
+            update: {
+              sessionUpdate: "tool_call_update",
+              toolCallId: "tool-call-generic-1",
+              title: "first background subagent",
+              kind: "other",
+              status: "completed",
+              rawOutput: { content: "FIRST_DONE" },
+            },
+          }).pipe(Effect.provideService(Clock.Clock, blockingClock));
+          for (let attempt = 0; attempt < 10; attempt += 1) {
+            yield* Effect.yieldNow;
+          }
+
+          yield* sessionUpdateHandler!({
+            sessionId: "mock-session-1",
+            update: {
+              sessionUpdate: "tool_call_update",
+              toolCallId: "tool-call-generic-2",
+              title: "second background subagent",
+              kind: "other",
+              status: "in_progress",
+              rawOutput: {},
+            },
+          });
+          assert.isTrue(yield* hasPendingBackgroundWork);
+
+          while (Option.isSome(yield* Queue.poll(events))) {
+            // Discard setup and first-subagent events.
+          }
+
+          blockNextClockRead = true;
+          const adjustFiber = yield* TestClock.adjust("3 seconds").pipe(Effect.forkScoped);
+          yield* Deferred.await(finalizationClockRead);
+          secondSubagentStatus = "completed";
+          yield* sessionUpdateHandler!({
+            sessionId: secondChildSessionId,
+            update: {
+              sessionUpdate: "tool_call_update",
+              toolCallId: "tool-call-generic-2",
+              title: "second background subagent",
+              kind: "other",
+              status: "completed",
+              rawOutput: { content: "SECOND_DONE" },
+            },
+          });
+          yield* Deferred.succeed(releaseFinalizationClockRead, undefined);
+          yield* Fiber.join(adjustFiber);
+          yield* Effect.yieldNow;
+          yield* Effect.yieldNow;
+
+          const providerTurnId = idAllocator.derive.providerTurn({
+            driver: ACP_TEST_DRIVER,
+            nativeTurnId: "mock-session-1:turn:1",
+          });
+          let completedSubagentUpdates = 0;
+          let rootTerminalStatus: string | null = null;
+          let polled = yield* Queue.poll(events);
+          while (Option.isSome(polled)) {
+            const event = polled.value;
+            if (
+              event.type === "turn_item.updated" &&
+              event.turnItem.type === "subagent" &&
+              event.turnItem.nativeItemRef?.nativeId === "task-finalize-window-second" &&
+              event.turnItem.status === "completed"
+            ) {
+              completedSubagentUpdates += 1;
+            }
+            if (event.type === "turn.terminal" && event.providerTurnId === providerTurnId) {
+              rootTerminalStatus = event.status;
+            }
+            polled = yield* Queue.poll(events);
+          }
+          assert.equal(rootTerminalStatus, "completed");
+          assert.equal(completedSubagentUpdates, 1);
+          assert.isFalse(
+            yield* hasPendingBackgroundWork,
+            "finalize-window terminal must clear the carryover pin",
+          );
+        }).pipe(Effect.provideService(Clock.Clock, blockingClock));
+      }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect(
+    "defers an interrupted pending-spawn carryover terminal until the next observable attach",
+    () =>
+      Effect.gen(function* () {
+        const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+        const fileSystem = yield* FileSystem.FileSystem;
+        const idAllocator = yield* IdAllocatorV2;
+        const path = yield* Path.Path;
+        const serverConfig = yield* ServerConfig;
+        const mockAgentPath = yield* path.fromFileUrl(
+          new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+        );
+        const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+        const continuationRequests: Array<ProviderContinuationRequest> = [];
+        const instanceId = ProviderInstanceId.make("acp-test");
+        const childSessionId = "mock-child-session-post-settle";
+        let subagentPhase: "spawn" | "complete" = "spawn";
+        type RuntimeService = AcpSessionRuntime.AcpSessionRuntime["Service"];
+        let sessionUpdateHandler: Parameters<RuntimeService["handleSessionUpdate"]>[0] | undefined;
+        const adapter = makeAcpAdapterV2({
+          crypto: yield* Crypto.Crypto,
+          instanceId,
+          flavor: {
+            driver: ACP_TEST_DRIVER,
+            capabilities: AcpProviderCapabilitiesV2,
+            deferFinalizeForBackgroundWork: true,
+            enablePostSettleContinuation: true,
+            extractSubagentUpdate: (toolCall) =>
+              toolCall.toolCallId !== "tool-call-generic-1"
+                ? undefined
+                : subagentPhase === "spawn"
+                  ? {
+                      nativeTaskId: "task-generic-1",
+                      prompt: "background subagent",
+                      title: "background subagent",
+                      model: null,
+                      status: "pending",
+                      childSessionId,
+                      result: null,
+                    }
+                  : {
+                      nativeTaskId: "task-generic-1",
+                      prompt: "",
+                      title: null,
+                      model: null,
+                      status: "completed",
+                      childSessionId,
+                      result: "SUB_DONE",
+                    },
+            makeRuntime: makeMockRuntime({
+              childProcessSpawner,
+              mockAgentPath,
+              environment: { T3_ACP_EMIT_GENERIC_TOOL_PLACEHOLDERS: "1" },
+              protocolEvents,
+              wrapRuntime: (runtime) => ({
+                ...runtime,
+                handleSessionUpdate: (handler) =>
+                  Effect.sync(() => {
+                    sessionUpdateHandler = handler;
+                  }).pipe(Effect.andThen(runtime.handleSessionUpdate(handler))),
+              }),
+            }),
+          },
+          fileSystem,
+          idAllocator,
+          serverConfig,
+          continuationRequests: {
+            offer: (request) =>
+              Effect.sync(() => {
+                continuationRequests.push(request);
+              }),
+          },
+        });
+        const threadId = ThreadId.make("thread-acp-carryover-child-session-post-settle");
+        const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          cwd: process.cwd(),
+        });
+        const modelSelection = { instanceId, model: "default" } as const;
+        const runtime = yield* adapter.openSession({
+          threadId,
+          providerSessionId: ProviderSessionId.make(
+            "provider-session-acp-carryover-child-session-post-settle",
+          ),
+          modelSelection,
+          runtimePolicy,
+        });
+        if (runtime.hasPendingBackgroundWork === undefined) {
+          return yield* Effect.die(
+            "ACP runtime must expose hasPendingBackgroundWork when post-settle continuation is enabled.",
+          );
+        }
+        const hasPendingBackgroundWork = runtime.hasPendingBackgroundWork;
+        const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+        yield* runtime.events.pipe(
+          Stream.runForEach((event) => Queue.offer(events, event)),
+          Effect.forkScoped,
+        );
+        const providerThread = yield* runtime.ensureThread({
+          threadId,
+          modelSelection,
+          runtimePolicy,
+        });
+        const now = yield* DateTime.now;
+        yield* runtime.startTurn(
+          makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now }),
+        );
+        yield* Stream.fromQueue(protocolEvents).pipe(
+          Stream.filter(
+            (event) =>
+              event.direction === "incoming" &&
+              event.stage === "raw" &&
+              typeof event.payload === "string" &&
+              event.payload.includes('"stopReason"'),
+          ),
+          Stream.runHead,
+        );
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+
+        const firstProviderTurnId = idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:1",
+        });
+        const interruptFiber = yield* runtime
+          .interruptTurn({ providerThread, providerTurnId: firstProviderTurnId })
+          .pipe(Effect.forkScoped);
+        yield* TestClock.adjust("10 seconds");
+        yield* Fiber.join(interruptFiber);
+
+        let firstTerminalStatus: string | null = null;
+        while (firstTerminalStatus === null) {
+          const event = yield* Queue.take(events);
+          if (event.type === "turn.terminal" && event.providerTurnId === firstProviderTurnId) {
+            firstTerminalStatus = event.status;
+          }
+        }
+        assert.equal(firstTerminalStatus, "interrupted");
+        assert.isTrue(
+          yield* hasPendingBackgroundWork,
+          "carryover live subagent must pin hasPendingBackgroundWork after root settle",
+        );
+        assert.isDefined(sessionUpdateHandler, "session update handler must be wired");
+
+        // The interrupted root's subscription is already closed in execution
+        // service, so the adapter must retain this terminal without claiming it
+        // reached the projection.
+        subagentPhase = "complete";
+        yield* sessionUpdateHandler!({
+          sessionId: childSessionId,
+          update: {
+            sessionUpdate: "tool_call_update",
+            toolCallId: "tool-call-generic-1",
+            title: "background subagent",
+            kind: "other",
+            status: "completed",
+            rawOutput: { content: "SUB_DONE" },
+          },
+        });
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+        let completedBeforeAttach = 0;
+        let polled = yield* Queue.poll(events);
+        while (Option.isSome(polled)) {
+          const event = polled.value;
+          if (
+            event.type === "turn_item.updated" &&
+            event.turnItem.type === "subagent" &&
+            event.turnItem.status === "completed"
+          ) {
+            completedBeforeAttach += 1;
+          }
+          polled = yield* Queue.poll(events);
+        }
+        assert.equal(
+          completedBeforeAttach,
+          0,
+          "closed interrupted subscription must not be treated as projected",
+        );
+        assert.isTrue(
+          yield* hasPendingBackgroundWork,
+          "terminal carryover must stay pinned until an attach can project it",
+        );
+        assert.lengthOf(
+          continuationRequests,
+          0,
+          "child-session completion must not open a root continuation",
+        );
+
+        const attachNow = yield* DateTime.now;
+        yield* runtime.startTurn(
+          makeTurnInput({
+            threadId,
+            providerThread,
+            instanceId,
+            runtimePolicy,
+            now: attachNow,
+            ordinal: 2,
+            messageCreatedBy: "agent",
+            messageCreationSource: "provider",
+            messageText: "Attach deferred completion.",
+          }),
+        );
+        const attachProviderTurnId = idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:2",
+        });
+        let attachTerminal: string | null = null;
+        let completedAfterAttach = 0;
+        while (attachTerminal === null) {
+          const event = yield* Queue.take(events);
+          if (
+            event.type === "turn_item.updated" &&
+            event.turnItem.type === "subagent" &&
+            event.turnItem.status === "completed"
+          ) {
+            completedAfterAttach += 1;
+          }
+          if (event.type === "turn.terminal" && event.providerTurnId === attachProviderTurnId) {
+            attachTerminal = event.status;
+          }
+        }
+        assert.equal(attachTerminal, "completed");
+        assert.equal(completedAfterAttach, 1);
+        assert.isFalse(yield* hasPendingBackgroundWork);
+      }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect("projects completed-root carryover eagerly and drain cannot resurrect it", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+      const continuationRequests: Array<ProviderContinuationRequest> = [];
+      const instanceId = ProviderInstanceId.make("acp-test");
+      const childSessionId = "019f44a6-4820-7402-925d-bc862ee711dd";
+      let subagentPhase: "spawn" | "complete" = "spawn";
+      type RuntimeService = AcpSessionRuntime.AcpSessionRuntime["Service"];
+      let sessionUpdateHandler: Parameters<RuntimeService["handleSessionUpdate"]>[0] | undefined;
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          enablePostSettleContinuation: true,
+          normalizeToolCall: normalizeXAiAcpToolCallState,
+          extractSubagentUpdate: (toolCall) =>
+            extractXAiAcpSubagentUpdate(toolCall) ??
+            (toolCall.toolCallId !== "tool-call-generic-1"
+              ? undefined
+              : subagentPhase === "spawn"
+                ? {
+                    nativeTaskId: "task-generic-1",
+                    prompt: "background subagent",
+                    title: "background subagent",
+                    model: null,
+                    status: "running",
+                    childSessionId,
+                    result: null,
+                  }
+                : {
+                    nativeTaskId: "task-generic-1",
+                    prompt: "",
+                    title: null,
+                    model: null,
+                    status: "completed",
+                    childSessionId,
+                    result: "SUB_DONE",
+                  }),
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            mockAgentPath,
+            environment: { T3_ACP_EMIT_GENERIC_TOOL_PLACEHOLDERS: "1" },
+            protocolEvents,
+            wrapRuntime: (runtime) => ({
+              ...runtime,
+              handleSessionUpdate: (handler) =>
+                Effect.sync(() => {
+                  sessionUpdateHandler = handler;
+                }).pipe(Effect.andThen(runtime.handleSessionUpdate(handler))),
+            }),
+          }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+        continuationRequests: {
+          offer: (request) =>
+            Effect.sync(() => {
+              continuationRequests.push(request);
+            }),
+        },
+      });
+      const threadId = ThreadId.make("thread-acp-completed-root-eager-carryover");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make(
+          "provider-session-acp-completed-root-eager-carryover",
+        ),
+        modelSelection,
+        runtimePolicy,
+      });
+      if (runtime.hasPendingBackgroundWork === undefined) {
+        return yield* Effect.die(
+          "ACP runtime must expose hasPendingBackgroundWork when post-settle continuation is enabled.",
+        );
+      }
+      const hasPendingBackgroundWork = runtime.hasPendingBackgroundWork;
+      const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+      yield* runtime.events.pipe(
+        Stream.runForEach((event) => Queue.offer(events, event)),
+        Effect.forkScoped,
+      );
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      const now = yield* DateTime.now;
+      yield* runtime.startTurn(
+        makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now }),
+      );
+      yield* Stream.fromQueue(protocolEvents).pipe(
+        Stream.filter(
+          (event) =>
+            event.direction === "incoming" &&
+            event.stage === "raw" &&
+            typeof event.payload === "string" &&
+            event.payload.includes('"stopReason"'),
+        ),
+        Stream.runHead,
+      );
+      yield* Effect.yieldNow;
+      yield* Effect.yieldNow;
+      yield* TestClock.adjust("1 second");
+
+      const firstProviderTurnId = idAllocator.derive.providerTurn({
+        driver: ACP_TEST_DRIVER,
+        nativeTurnId: "mock-session-1:turn:1",
+      });
+      let firstTerminalStatus: string | null = null;
+      while (firstTerminalStatus === null) {
+        const event = yield* Queue.take(events);
+        if (event.type === "turn.terminal" && event.providerTurnId === firstProviderTurnId) {
+          firstTerminalStatus = event.status;
+        }
+      }
+      assert.equal(firstTerminalStatus, "completed");
+      assert.isTrue(yield* hasPendingBackgroundWork);
+      assert.isDefined(sessionUpdateHandler, "session update handler must be wired");
+
+      // A production Grok spawn ACK has raw tool status completed but extracts
+      // as a running subagent with its original non-empty prompt. It buffers and
+      // offers a continuation after root settlement.
+      yield* sessionUpdateHandler!({
+        sessionId: "mock-session-1",
+        update: {
+          sessionUpdate: "tool_call",
+          toolCallId: "tool-call-generic-1",
+          title: "spawn_subagent",
+          kind: "other",
+          status: "completed",
+          rawInput: {
+            description: "background subagent",
+            prompt: "background subagent",
+            subagent_type: "general-purpose",
+          },
+          rawOutput: {
+            type: "Text",
+            text: [
+              "Subagent started in background.",
+              `subagent_id: ${childSessionId}`,
+              "type: general-purpose",
+              "description: background subagent",
+              "",
+              `Use get_command_or_subagent_output with task_ids=["${childSessionId}"] and timeout_ms to wait for results.`,
+            ].join("\n"),
+          },
+        },
+      });
+
+      // The child-session terminal bypasses the root wake buffer and projects
+      // eagerly through the still-observable completed-root subscriber.
+      subagentPhase = "complete";
+      yield* sessionUpdateHandler!({
+        sessionId: childSessionId,
+        update: {
+          sessionUpdate: "tool_call_update" as const,
+          toolCallId: "tool-call-generic-1",
+          title: "background subagent",
+          kind: "other" as const,
+          status: "completed" as const,
+          rawOutput: { content: "SUB_DONE" },
+        },
+      });
+      yield* Effect.yieldNow;
+      yield* Effect.yieldNow;
+
+      let eagerCompletedUpdates = 0;
+      let eagerRunningUpdates = 0;
+      let polled = yield* Queue.poll(events);
+      while (Option.isSome(polled)) {
+        const event = polled.value;
+        if (event.type === "turn_item.updated" && event.turnItem.type === "subagent") {
+          if (event.turnItem.status === "completed") eagerCompletedUpdates += 1;
+          if (event.turnItem.status === "running") eagerRunningUpdates += 1;
+        }
+        polled = yield* Queue.poll(events);
+      }
+      assert.equal(eagerCompletedUpdates, 1, "completed root must project before any attach");
+      assert.equal(eagerRunningUpdates, 0);
+      assert.lengthOf(continuationRequests, 1);
+      assert.isTrue(yield* hasPendingBackgroundWork, "buffered spawn ACK still requires a drain");
+
+      const continuationNow = yield* DateTime.now;
+      const continuationInput = makeTurnInput({
+        threadId,
+        providerThread,
+        instanceId,
+        runtimePolicy,
+        now: continuationNow,
+        ordinal: 2,
+        messageCreatedBy: "agent",
+        messageCreationSource: "provider",
+        messageText: "Background task completed.",
+      });
+      yield* runtime.startTurn(continuationInput);
+      yield* Effect.yieldNow;
+      let replayedLineages = 0;
+      let replayedSubagentUpdates = 0;
+      let replayedTurnItems = 0;
+      polled = yield* Queue.poll(events);
+      while (Option.isSome(polled)) {
+        const event = polled.value;
+        if (event.type === "app_thread.created") {
+          replayedLineages += 1;
+        }
+        if (event.type === "subagent.updated" && event.subagent.runId === continuationInput.runId) {
+          replayedSubagentUpdates += 1;
+        }
+        if (
+          event.type === "turn_item.updated" &&
+          event.turnItem.runId === continuationInput.runId
+        ) {
+          replayedTurnItems += 1;
+        }
+        polled = yield* Queue.poll(events);
+      }
+      assert.equal(replayedLineages, 0, "buffered spawn ACK must not create a second lineage");
+      assert.equal(
+        replayedSubagentUpdates,
+        0,
+        "buffered spawn ACK must not re-open the terminal subagent",
+      );
+      assert.equal(
+        replayedTurnItems,
+        0,
+        "buffered spawn ACK must not create a continuation-owned turn item",
+      );
+      assert.isFalse(yield* hasPendingBackgroundWork);
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect(
+    "user attach flushes a deferred terminal but leaves wake traffic for its continuation",
+    () =>
+      Effect.gen(function* () {
+        const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+        const fileSystem = yield* FileSystem.FileSystem;
+        const idAllocator = yield* IdAllocatorV2;
+        const path = yield* Path.Path;
+        const serverConfig = yield* ServerConfig;
+        const mockAgentPath = yield* path.fromFileUrl(
+          new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+        );
+        const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+        const continuationRequests: Array<ProviderContinuationRequest> = [];
+        const bufferedAssistantText = "BUFFERED_WAKE_AFTER_USER_ATTACH";
+        const instanceId = ProviderInstanceId.make("acp-test");
+        let subagentPhase: "spawn" | "complete" = "spawn";
+        type RuntimeService = AcpSessionRuntime.AcpSessionRuntime["Service"];
+        let sessionUpdateHandler: Parameters<RuntimeService["handleSessionUpdate"]>[0] | undefined;
+        const adapter = makeAcpAdapterV2({
+          crypto: yield* Crypto.Crypto,
+          instanceId,
+          flavor: {
+            driver: ACP_TEST_DRIVER,
+            capabilities: AcpProviderCapabilitiesV2,
+            deferFinalizeForBackgroundWork: true,
+            enablePostSettleContinuation: true,
+            extractSubagentUpdate: (toolCall) =>
+              toolCall.toolCallId !== "tool-call-generic-1"
+                ? undefined
+                : subagentPhase === "spawn"
+                  ? {
+                      nativeTaskId: "task-generic-1",
+                      prompt: "background subagent",
+                      title: "background subagent",
+                      model: null,
+                      status: "running",
+                      childSessionId: null,
+                      result: null,
+                    }
+                  : {
+                      nativeTaskId: "task-generic-1",
+                      prompt: "",
+                      title: null,
+                      model: null,
+                      status: "completed",
+                      childSessionId: null,
+                      result: "SUB_DONE",
+                    },
+            makeRuntime: makeMockRuntime({
+              childProcessSpawner,
+              mockAgentPath,
+              environment: { T3_ACP_EMIT_GENERIC_TOOL_PLACEHOLDERS: "1" },
+              protocolEvents,
+              wrapRuntime: (runtime) => ({
+                ...runtime,
+                handleSessionUpdate: (handler) =>
+                  Effect.sync(() => {
+                    sessionUpdateHandler = handler;
+                  }).pipe(Effect.andThen(runtime.handleSessionUpdate(handler))),
+              }),
+            }),
+          },
+          fileSystem,
+          idAllocator,
+          serverConfig,
+          continuationRequests: {
+            offer: (request) =>
+              Effect.sync(() => {
+                continuationRequests.push(request);
+              }),
+          },
+        });
+        const threadId = ThreadId.make("thread-acp-carryover-root-session-continuation");
+        const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          cwd: process.cwd(),
+        });
+        const modelSelection = { instanceId, model: "default" } as const;
+        const runtime = yield* adapter.openSession({
+          threadId,
+          providerSessionId: ProviderSessionId.make(
+            "provider-session-acp-carryover-root-session-continuation",
+          ),
+          modelSelection,
+          runtimePolicy,
+        });
+        if (runtime.hasPendingBackgroundWork === undefined) {
+          return yield* Effect.die(
+            "ACP runtime must expose hasPendingBackgroundWork when post-settle continuation is enabled.",
+          );
+        }
+        const hasPendingBackgroundWork = runtime.hasPendingBackgroundWork;
+        const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+        yield* runtime.events.pipe(
+          Stream.runForEach((event) => Queue.offer(events, event)),
+          Effect.forkScoped,
+        );
+        const providerThread = yield* runtime.ensureThread({
+          threadId,
+          modelSelection,
+          runtimePolicy,
+        });
+        const now = yield* DateTime.now;
+        yield* runtime.startTurn(
+          makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now }),
+        );
+        yield* Stream.fromQueue(protocolEvents).pipe(
+          Stream.filter(
+            (event) =>
+              event.direction === "incoming" &&
+              event.stage === "raw" &&
+              typeof event.payload === "string" &&
+              event.payload.includes('"stopReason"'),
+          ),
+          Stream.runHead,
+        );
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+
+        const firstProviderTurnId = idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:1",
+        });
+        const interruptFiber = yield* runtime
+          .interruptTurn({ providerThread, providerTurnId: firstProviderTurnId })
+          .pipe(Effect.forkScoped);
+        yield* TestClock.adjust("10 seconds");
+        yield* Fiber.join(interruptFiber);
+
+        let firstTerminalStatus: string | null = null;
+        while (firstTerminalStatus === null) {
+          const event = yield* Queue.take(events);
+          if (event.type === "turn.terminal" && event.providerTurnId === firstProviderTurnId) {
+            firstTerminalStatus = event.status;
+          }
+        }
+        assert.equal(firstTerminalStatus, "interrupted");
+        assert.isTrue(
+          yield* hasPendingBackgroundWork,
+          "carryover live subagent must pin hasPendingBackgroundWork after root settle",
+        );
+        assert.isDefined(sessionUpdateHandler, "session update handler must be wired");
+
+        // Root-session terminal tool is wake evidence and will buffer: in-memory
+        // only so the continuation drain projects exactly once.
+        subagentPhase = "complete";
+        yield* sessionUpdateHandler!({
+          sessionId: "mock-session-1",
+          update: {
+            sessionUpdate: "tool_call_update",
+            toolCallId: "tool-call-generic-1",
+            title: "background subagent",
+            kind: "other",
+            status: "completed",
+            rawOutput: { content: "SUB_DONE" },
+          },
+        });
+        yield* sessionUpdateHandler!({
+          sessionId: "mock-session-1",
+          update: {
+            sessionUpdate: "agent_message_chunk",
+            content: { type: "text", text: bufferedAssistantText },
+          },
+        });
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+
+        let completedBeforeDrain = 0;
+        let polled = yield* Queue.poll(events);
+        while (Option.isSome(polled)) {
+          const event = polled.value;
+          if (
+            event.type === "turn_item.updated" &&
+            event.turnItem.type === "subagent" &&
+            event.turnItem.status === "completed"
+          ) {
+            completedBeforeDrain += 1;
+          }
+          polled = yield* Queue.poll(events);
+        }
+        assert.equal(
+          completedBeforeDrain,
+          0,
+          "interrupted root-session terminal must wait for an observable attach",
+        );
+        assert.lengthOf(
+          continuationRequests,
+          1,
+          "root-session post-settle subagent terminal must offer a continuation",
+        );
+        assert.isTrue(
+          yield* hasPendingBackgroundWork,
+          "interrupted unprojected terminal must pin hasPendingBackgroundWork until attach",
+        );
+
+        const userTurnNow = yield* DateTime.now;
+        yield* runtime.startTurn(
+          makeTurnInput({
+            threadId,
+            providerThread,
+            instanceId,
+            runtimePolicy,
+            now: userTurnNow,
+            ordinal: 2,
+            messageText: "What finished while the prior turn was settling?",
+          }),
+        );
+        yield* TestClock.adjust("3 seconds");
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+
+        const userProviderTurnId = idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:2",
+        });
+        let userTurnTerminal: string | null = null;
+        let completedSubagentTurnItems = 0;
+        let bufferedTextSeenInUserTurn = false;
+        while (userTurnTerminal === null) {
+          const event = yield* Queue.take(events);
+          if (
+            event.type === "turn_item.updated" &&
+            event.turnItem.type === "subagent" &&
+            event.turnItem.status === "completed"
+          ) {
+            completedSubagentTurnItems += 1;
+          }
+          if (
+            event.type === "message.updated" &&
+            event.message.role === "assistant" &&
+            event.message.text.includes(bufferedAssistantText)
+          ) {
+            bufferedTextSeenInUserTurn = true;
+          }
+          if (event.type === "turn.terminal" && event.providerTurnId === userProviderTurnId) {
+            userTurnTerminal = event.status;
+          }
+        }
+        assert.equal(userTurnTerminal, "completed");
+        assert.equal(
+          completedSubagentTurnItems,
+          1,
+          "user attach must project the deferred terminal subagent turn item once",
+        );
+        assert.isFalse(bufferedTextSeenInUserTurn, "user attach must not drain wake traffic");
+        assert.isTrue(
+          yield* hasPendingBackgroundWork,
+          "wake traffic must remain pinned for the already-dispatched continuation",
+        );
+
+        const continuationNow = yield* DateTime.now;
+        yield* runtime.startTurn(
+          makeTurnInput({
+            threadId,
+            providerThread,
+            instanceId,
+            runtimePolicy,
+            now: continuationNow,
+            ordinal: 3,
+            messageCreatedBy: "agent",
+            messageCreationSource: "provider",
+            messageText: "Background task completed.",
+          }),
+        );
+        yield* TestClock.adjust("3 seconds");
+        const continuationProviderTurnId = idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:3",
+        });
+        let continuationTerminal: string | null = null;
+        let bufferedTextSeenInContinuation = false;
+        while (continuationTerminal === null) {
+          const event = yield* Queue.take(events);
+          if (
+            event.type === "message.updated" &&
+            event.message.role === "assistant" &&
+            event.message.text.includes(bufferedAssistantText)
+          ) {
+            bufferedTextSeenInContinuation = true;
+          }
+          if (
+            event.type === "turn.terminal" &&
+            event.providerTurnId === continuationProviderTurnId
+          ) {
+            continuationTerminal = event.status;
+          }
+        }
+        assert.equal(continuationTerminal, "completed");
+        assert.isTrue(
+          bufferedTextSeenInContinuation,
+          "queued continuation must drain the wake content after the user run",
+        );
+        assert.isFalse(yield* hasPendingBackgroundWork);
+      }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect(
+    "projects a carryover terminal when an in-turn-handled tool is re-reported post-settle",
+    () =>
+      Effect.gen(function* () {
+        const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+        const fileSystem = yield* FileSystem.FileSystem;
+        const idAllocator = yield* IdAllocatorV2;
+        const path = yield* Path.Path;
+        const serverConfig = yield* ServerConfig;
+        const mockAgentPath = yield* path.fromFileUrl(
+          new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+        );
+        const continuationRequests: Array<ProviderContinuationRequest> = [];
+        const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+        const promptWireReturned = yield* Deferred.make<void>();
+        const releasePromptCompletion = yield* Deferred.make<void>();
+        const instanceId = ProviderInstanceId.make("acp-test");
+        let subagentPhase: "spawn" | "complete" = "spawn";
+        type RuntimeService = AcpSessionRuntime.AcpSessionRuntime["Service"];
+        let sessionUpdateHandler: Parameters<RuntimeService["handleSessionUpdate"]>[0] | undefined;
+        const adapter = makeAcpAdapterV2({
+          crypto: yield* Crypto.Crypto,
+          instanceId,
+          flavor: {
+            driver: ACP_TEST_DRIVER,
+            capabilities: AcpProviderCapabilitiesV2,
+            deferFinalizeForBackgroundWork: true,
+            enablePostSettleContinuation: true,
+            extractBackgroundTaskId: (toolCall) =>
+              toolCall.toolCallId === "tool-call-generic-1" ? "task-generic-1" : undefined,
+            extractSubagentUpdate: (toolCall) =>
+              toolCall.toolCallId !== "tool-call-generic-1"
+                ? undefined
+                : subagentPhase === "spawn"
+                  ? {
+                      nativeTaskId: "task-generic-1",
+                      prompt: "background subagent",
+                      title: "background subagent",
+                      model: null,
+                      status: "running",
+                      childSessionId: null,
+                      result: null,
+                    }
+                  : {
+                      nativeTaskId: "task-generic-1",
+                      prompt: "",
+                      title: null,
+                      model: null,
+                      status: "completed",
+                      childSessionId: null,
+                      result: "SUB_DONE",
+                    },
+            makeRuntime: makeMockRuntime({
+              childProcessSpawner,
+              mockAgentPath,
+              environment: { T3_ACP_EMIT_GENERIC_TOOL_PLACEHOLDERS: "1" },
+              protocolEvents,
+              wrapRuntime: (runtime) => ({
+                ...runtime,
+                handleSessionUpdate: (handler) =>
+                  Effect.sync(() => {
+                    sessionUpdateHandler = handler;
+                  }).pipe(Effect.andThen(runtime.handleSessionUpdate(handler))),
+                prompt: (payload) =>
+                  Effect.gen(function* () {
+                    const result = yield* runtime.prompt(payload);
+                    yield* Deferred.succeed(promptWireReturned, undefined);
+                    yield* Deferred.await(releasePromptCompletion);
+                    return result;
+                  }),
+              }),
+            }),
+          },
+          fileSystem,
+          idAllocator,
+          serverConfig,
+          continuationRequests: {
+            offer: (request) =>
+              Effect.sync(() => {
+                continuationRequests.push(request);
+              }),
+          },
+        });
+        const threadId = ThreadId.make("thread-acp-carryover-already-handled-re-report");
+        const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          cwd: process.cwd(),
+        });
+        const modelSelection = { instanceId, model: "default" } as const;
+        const runtime = yield* adapter.openSession({
+          threadId,
+          providerSessionId: ProviderSessionId.make(
+            "provider-session-acp-carryover-already-handled-re-report",
+          ),
+          modelSelection,
+          runtimePolicy,
+        });
+        if (runtime.hasPendingBackgroundWork === undefined) {
+          return yield* Effect.die(
+            "ACP runtime must expose hasPendingBackgroundWork when post-settle continuation is enabled.",
+          );
+        }
+        const hasPendingBackgroundWork = runtime.hasPendingBackgroundWork;
+        const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+        yield* runtime.events.pipe(
+          Stream.runForEach((event) => Queue.offer(events, event)),
+          Effect.forkScoped,
+        );
+        const providerThread = yield* runtime.ensureThread({
+          threadId,
+          modelSelection,
+          runtimePolicy,
+        });
+        const now = yield* DateTime.now;
+        yield* runtime.startTurn(
+          makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now }),
+        );
+        yield* Deferred.await(promptWireReturned);
+        assert.isDefined(sessionUpdateHandler, "session update handler must be wired");
+
+        // The root turn consumes a terminal re-report while the native prompt is
+        // still open. The subagent flavor keeps its carried lineage running.
+        yield* sessionUpdateHandler!({
+          sessionId: "mock-session-1",
+          update: {
+            sessionUpdate: "tool_call_update",
+            toolCallId: "tool-call-generic-1",
+            title: "background subagent",
+            kind: "other",
+            status: "completed",
+            rawOutput: { content: "IN_TURN_RESULT" },
+          },
+        });
+        yield* Deferred.succeed(releasePromptCompletion, undefined);
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+
+        const firstProviderTurnId = idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:1",
+        });
+        const interruptFiber = yield* runtime
+          .interruptTurn({ providerThread, providerTurnId: firstProviderTurnId })
+          .pipe(Effect.forkScoped);
+        yield* TestClock.adjust("10 seconds");
+        yield* Fiber.join(interruptFiber);
+
+        let firstTerminalStatus: string | null = null;
+        while (firstTerminalStatus === null) {
+          const event = yield* Queue.take(events);
+          if (event.type === "turn.terminal" && event.providerTurnId === firstProviderTurnId) {
+            firstTerminalStatus = event.status;
+          }
+        }
+        assert.equal(firstTerminalStatus, "interrupted");
+        assert.isTrue(
+          yield* hasPendingBackgroundWork,
+          "live carryover must remain pending after the superseded root settles",
+        );
+
+        // The same tool is now a terminal carryover update. Since it was handled
+        // in-turn, bufferPostSettleWake drops it instead of offering a drain.
+        subagentPhase = "complete";
+        yield* sessionUpdateHandler!({
+          sessionId: "mock-session-1",
+          update: {
+            sessionUpdate: "tool_call_update",
+            toolCallId: "tool-call-generic-1",
+            title: "background subagent",
+            kind: "other",
+            status: "completed",
+            rawOutput: { content: "SUB_DONE" },
+          },
+        });
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+
+        let completedSubagentTurnItems = 0;
+        let polled = yield* Queue.poll(events);
+        while (Option.isSome(polled)) {
+          const event = polled.value;
+          if (
+            event.type === "turn_item.updated" &&
+            event.turnItem.type === "subagent" &&
+            event.turnItem.status === "completed"
+          ) {
+            completedSubagentTurnItems += 1;
+          }
+          polled = yield* Queue.poll(events);
+        }
+        assert.equal(
+          completedSubagentTurnItems,
+          0,
+          "an interrupted root's non-buffered re-report must wait for an observable attach",
+        );
+        assert.lengthOf(
+          continuationRequests,
+          0,
+          "an in-turn-handled re-report must not offer a continuation",
+        );
+        assert.isTrue(
+          yield* hasPendingBackgroundWork,
+          "the unprojected terminal carryover must remain pinned",
+        );
+
+        const attachNow = yield* DateTime.now;
+        yield* runtime.startTurn(
+          makeTurnInput({
+            threadId,
+            providerThread,
+            instanceId,
+            runtimePolicy,
+            now: attachNow,
+            ordinal: 2,
+            messageCreatedBy: "agent",
+            messageCreationSource: "provider",
+            messageText: "Attach deferred completion.",
+          }),
+        );
+        const attachProviderTurnId = idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:2",
+        });
+        let attachTerminal: string | null = null;
+        while (attachTerminal === null) {
+          const event = yield* Queue.take(events);
+          if (
+            event.type === "turn_item.updated" &&
+            event.turnItem.type === "subagent" &&
+            event.turnItem.status === "completed"
+          ) {
+            completedSubagentTurnItems += 1;
+          }
+          if (event.type === "turn.terminal" && event.providerTurnId === attachProviderTurnId) {
+            attachTerminal = event.status;
+          }
+        }
+        assert.equal(completedSubagentTurnItems, 1);
+        assert.isFalse(yield* hasPendingBackgroundWork);
+      }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect("projects an interrupted root-session end notice at the next attach", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+      const continuationRequests: Array<ProviderContinuationRequest> = [];
+      const instanceId = ProviderInstanceId.make("acp-test");
+      const childSessionId = "019f5470-bf92-7a90-afb3-5a6cea5b34a3";
+      let subagentPhase: "spawn" | "complete" = "spawn";
+      type RuntimeService = AcpSessionRuntime.AcpSessionRuntime["Service"];
+      let sessionUpdateHandler: Parameters<RuntimeService["handleSessionUpdate"]>[0] | undefined;
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          deferFinalizeForBackgroundWork: true,
+          enablePostSettleContinuation: true,
+          extractSubagentEndNotice: (text) => {
+            // Prefer the production parser; fall back only if the harness text
+            // is too short for its UUID + outcome rules.
+            const parsed = extractXAiAcpSubagentEndNotice(text);
+            if (parsed !== undefined) return parsed;
+            if (!text.includes(childSessionId)) return undefined;
+            if (/completed successfully/i.test(text)) {
+              return { childSessionId, status: "completed" as const };
+            }
+            return undefined;
+          },
+          extractSubagentUpdate: (toolCall) =>
+            toolCall.toolCallId !== "tool-call-generic-1"
+              ? undefined
+              : subagentPhase === "spawn"
+                ? {
+                    nativeTaskId: "task-generic-1",
+                    prompt: "background subagent",
+                    title: "background subagent",
+                    model: null,
+                    status: "running",
+                    childSessionId,
+                    result: null,
+                  }
+                : {
+                    nativeTaskId: "task-generic-1",
+                    prompt: "",
+                    title: null,
+                    model: null,
+                    status: "completed",
+                    childSessionId,
+                    result: "SUB_DONE",
+                  },
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            mockAgentPath,
+            environment: { T3_ACP_EMIT_GENERIC_TOOL_PLACEHOLDERS: "1" },
+            protocolEvents,
+            wrapRuntime: (runtime) => ({
+              ...runtime,
+              handleSessionUpdate: (handler) =>
+                Effect.sync(() => {
+                  sessionUpdateHandler = handler;
+                }).pipe(Effect.andThen(runtime.handleSessionUpdate(handler))),
+            }),
+          }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+        continuationRequests: {
+          offer: (request) =>
+            Effect.sync(() => {
+              continuationRequests.push(request);
+            }),
+        },
+      });
+      const threadId = ThreadId.make("thread-acp-carryover-root-end-notice");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make("provider-session-acp-carryover-root-end-notice"),
+        modelSelection,
+        runtimePolicy,
+      });
+      if (runtime.hasPendingBackgroundWork === undefined) {
+        return yield* Effect.die(
+          "ACP runtime must expose hasPendingBackgroundWork when post-settle continuation is enabled.",
+        );
+      }
+      const hasPendingBackgroundWork = runtime.hasPendingBackgroundWork;
+      const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+      yield* runtime.events.pipe(
+        Stream.runForEach((event) => Queue.offer(events, event)),
+        Effect.forkScoped,
+      );
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      const now = yield* DateTime.now;
+      yield* runtime.startTurn(
+        makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now }),
+      );
+      yield* Stream.fromQueue(protocolEvents).pipe(
+        Stream.filter(
+          (event) =>
+            event.direction === "incoming" &&
+            event.stage === "raw" &&
+            typeof event.payload === "string" &&
+            event.payload.includes('"stopReason"'),
+        ),
+        Stream.runHead,
+      );
+      yield* Effect.yieldNow;
+      yield* Effect.yieldNow;
+
+      const firstProviderTurnId = idAllocator.derive.providerTurn({
+        driver: ACP_TEST_DRIVER,
+        nativeTurnId: "mock-session-1:turn:1",
+      });
+      const interruptFiber = yield* runtime
+        .interruptTurn({ providerThread, providerTurnId: firstProviderTurnId })
+        .pipe(Effect.forkScoped);
+      yield* TestClock.adjust("10 seconds");
+      yield* Fiber.join(interruptFiber);
+
+      let firstTerminalStatus: string | null = null;
+      while (firstTerminalStatus === null) {
+        const event = yield* Queue.take(events);
+        if (event.type === "turn.terminal" && event.providerTurnId === firstProviderTurnId) {
+          firstTerminalStatus = event.status;
+        }
+      }
+      assert.equal(firstTerminalStatus, "interrupted");
+      assert.isTrue(
+        yield* hasPendingBackgroundWork,
+        "carryover live subagent must pin hasPendingBackgroundWork after root settle",
+      );
+      assert.isDefined(sessionUpdateHandler, "session update handler must be wired");
+
+      // End notices are root user_message_chunk text and never buffer. The
+      // interrupted root still cannot project them until the next subscription
+      // attaches.
+      yield* sessionUpdateHandler!({
+        sessionId: "mock-session-1",
+        update: {
+          sessionUpdate: "user_message_chunk",
+          content: {
+            type: "text",
+            text: `Background subagent "${childSessionId}" (general-purpose: "background subagent") completed successfully.`,
+          },
+        },
+      });
+      // Do not use Effect.timeout under TestClock; poll after yielding so a
+      // missed projection fails the assertion instead of hanging the suite.
+      yield* Effect.yieldNow;
+      yield* Effect.yieldNow;
+
+      let completedSubagentTurnItems = 0;
+      let polled = yield* Queue.poll(events);
+      while (Option.isSome(polled)) {
+        const event = polled.value;
+        if (
+          event.type === "turn_item.updated" &&
+          event.turnItem.type === "subagent" &&
+          event.turnItem.status === "completed"
+        ) {
+          completedSubagentTurnItems += 1;
+        }
+        polled = yield* Queue.poll(events);
+      }
+      assert.equal(
+        completedSubagentTurnItems,
+        0,
+        "root-session end notice must remain memory-only after interrupted settle",
+      );
+      assert.lengthOf(
+        continuationRequests,
+        0,
+        "root-session end notice must not open a continuation",
+      );
+      assert.isTrue(
+        yield* hasPendingBackgroundWork,
+        "hasPendingBackgroundWork must retain the unprojected end notice",
+      );
+
+      const attachNow = yield* DateTime.now;
+      yield* runtime.startTurn(
+        makeTurnInput({
+          threadId,
+          providerThread,
+          instanceId,
+          runtimePolicy,
+          now: attachNow,
+          ordinal: 2,
+          messageCreatedBy: "agent",
+          messageCreationSource: "provider",
+          messageText: "Attach deferred completion.",
+        }),
+      );
+      const attachProviderTurnId = idAllocator.derive.providerTurn({
+        driver: ACP_TEST_DRIVER,
+        nativeTurnId: "mock-session-1:turn:2",
+      });
+      let attachTerminal: string | null = null;
+      while (attachTerminal === null) {
+        const event = yield* Queue.take(events);
+        if (
+          event.type === "turn_item.updated" &&
+          event.turnItem.type === "subagent" &&
+          event.turnItem.status === "completed"
+        ) {
+          completedSubagentTurnItems += 1;
+        }
+        if (event.type === "turn.terminal" && event.providerTurnId === attachProviderTurnId) {
+          attachTerminal = event.status;
+        }
+      }
+      assert.equal(completedSubagentTurnItems, 1);
+      assert.isFalse(yield* hasPendingBackgroundWork);
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect(
+    "preserves wakeBuffer when a child-session completes while a continuation is pending",
+    () =>
+      Effect.gen(function* () {
+        const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+        const fileSystem = yield* FileSystem.FileSystem;
+        const idAllocator = yield* IdAllocatorV2;
+        const path = yield* Path.Path;
+        const serverConfig = yield* ServerConfig;
+        const mockAgentPath = yield* path.fromFileUrl(
+          new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+        );
+        const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+        const continuationRequests: Array<ProviderContinuationRequest> = [];
+        const instanceId = ProviderInstanceId.make("acp-test");
+        const childSessionId = "mock-child-session-pending-continuation";
+        const bufferedAssistantText = "POST_SETTLE_BUFFERED_ASSISTANT_TEXT";
+        let subagentPhase: "spawn" | "complete" = "spawn";
+        type RuntimeService = AcpSessionRuntime.AcpSessionRuntime["Service"];
+        let sessionUpdateHandler: Parameters<RuntimeService["handleSessionUpdate"]>[0] | undefined;
+        const adapter = makeAcpAdapterV2({
+          crypto: yield* Crypto.Crypto,
+          instanceId,
+          flavor: {
+            driver: ACP_TEST_DRIVER,
+            capabilities: AcpProviderCapabilitiesV2,
+            deferFinalizeForBackgroundWork: true,
+            enablePostSettleContinuation: true,
+            extractSubagentUpdate: (toolCall) =>
+              toolCall.toolCallId !== "tool-call-generic-1"
+                ? undefined
+                : subagentPhase === "spawn"
+                  ? {
+                      nativeTaskId: "task-generic-1",
+                      prompt: "background subagent",
+                      title: "background subagent",
+                      model: null,
+                      status: "running",
+                      childSessionId,
+                      result: null,
+                    }
+                  : {
+                      nativeTaskId: "task-generic-1",
+                      prompt: "",
+                      title: null,
+                      model: null,
+                      status: "completed",
+                      childSessionId,
+                      result: "SUB_DONE",
+                    },
+            makeRuntime: makeMockRuntime({
+              childProcessSpawner,
+              mockAgentPath,
+              environment: { T3_ACP_EMIT_GENERIC_TOOL_PLACEHOLDERS: "1" },
+              protocolEvents,
+              wrapRuntime: (runtime) => ({
+                ...runtime,
+                handleSessionUpdate: (handler) =>
+                  Effect.sync(() => {
+                    sessionUpdateHandler = handler;
+                  }).pipe(Effect.andThen(runtime.handleSessionUpdate(handler))),
+              }),
+            }),
+          },
+          fileSystem,
+          idAllocator,
+          serverConfig,
+          continuationRequests: {
+            offer: (request) =>
+              Effect.sync(() => {
+                continuationRequests.push(request);
+              }),
+          },
+        });
+        const threadId = ThreadId.make("thread-acp-carryover-child-pending-continuation");
+        const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          cwd: process.cwd(),
+        });
+        const modelSelection = { instanceId, model: "default" } as const;
+        const runtime = yield* adapter.openSession({
+          threadId,
+          providerSessionId: ProviderSessionId.make(
+            "provider-session-acp-carryover-child-pending-continuation",
+          ),
+          modelSelection,
+          runtimePolicy,
+        });
+        if (runtime.hasPendingBackgroundWork === undefined) {
+          return yield* Effect.die(
+            "ACP runtime must expose hasPendingBackgroundWork when post-settle continuation is enabled.",
+          );
+        }
+        const hasPendingBackgroundWork = runtime.hasPendingBackgroundWork;
+        const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+        yield* runtime.events.pipe(
+          Stream.runForEach((event) => Queue.offer(events, event)),
+          Effect.forkScoped,
+        );
+        const providerThread = yield* runtime.ensureThread({
+          threadId,
+          modelSelection,
+          runtimePolicy,
+        });
+        const now = yield* DateTime.now;
+        yield* runtime.startTurn(
+          makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now }),
+        );
+        yield* Stream.fromQueue(protocolEvents).pipe(
+          Stream.filter(
+            (event) =>
+              event.direction === "incoming" &&
+              event.stage === "raw" &&
+              typeof event.payload === "string" &&
+              event.payload.includes('"stopReason"'),
+          ),
+          Stream.runHead,
+        );
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+
+        const firstProviderTurnId = idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:1",
+        });
+        const interruptFiber = yield* runtime
+          .interruptTurn({ providerThread, providerTurnId: firstProviderTurnId })
+          .pipe(Effect.forkScoped);
+        yield* TestClock.adjust("10 seconds");
+        yield* Fiber.join(interruptFiber);
+
+        let firstTerminalStatus: string | null = null;
+        while (firstTerminalStatus === null) {
+          const event = yield* Queue.take(events);
+          if (event.type === "turn.terminal" && event.providerTurnId === firstProviderTurnId) {
+            firstTerminalStatus = event.status;
+          }
+        }
+        assert.equal(firstTerminalStatus, "interrupted");
+        assert.isTrue(
+          yield* hasPendingBackgroundWork,
+          "carryover live subagent must pin hasPendingBackgroundWork after root settle",
+        );
+        assert.isDefined(sessionUpdateHandler, "session update handler must be wired");
+
+        // Root-session terminal + distinctive assistant text: both enter wakeBuffer
+        // and the terminal offers a continuation that will drain them.
+        subagentPhase = "complete";
+        yield* sessionUpdateHandler!({
+          sessionId: "mock-session-1",
+          update: {
+            sessionUpdate: "tool_call_update",
+            toolCallId: "tool-call-generic-1",
+            title: "background subagent",
+            kind: "other",
+            status: "completed",
+            rawOutput: { content: "SUB_DONE" },
+          },
+        });
+        yield* sessionUpdateHandler!({
+          sessionId: "mock-session-1",
+          update: {
+            sessionUpdate: "agent_message_chunk",
+            content: { type: "text", text: bufferedAssistantText },
+          },
+        });
+        assert.lengthOf(
+          continuationRequests,
+          1,
+          "root-session terminal must offer a continuation before child completion",
+        );
+        assert.isTrue(
+          yield* hasPendingBackgroundWork,
+          "pending continuation must keep hasPendingBackgroundWork pinned",
+        );
+
+        // Child path must not wipe wakeBuffer or clear the sticky continuation pin.
+        yield* sessionUpdateHandler!({
+          sessionId: childSessionId,
+          update: {
+            sessionUpdate: "tool_call_update",
+            toolCallId: "tool-call-generic-1",
+            title: "background subagent",
+            kind: "other",
+            status: "completed",
+            rawOutput: { content: "SUB_DONE" },
+          },
+        });
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+
+        let completedBeforeDrain = 0;
+        let polled = yield* Queue.poll(events);
+        while (Option.isSome(polled)) {
+          const event = polled.value;
+          if (
+            event.type === "turn_item.updated" &&
+            event.turnItem.type === "subagent" &&
+            event.turnItem.status === "completed"
+          ) {
+            completedBeforeDrain += 1;
+          }
+          polled = yield* Queue.poll(events);
+        }
+        assert.equal(
+          completedBeforeDrain,
+          0,
+          "interrupted child-session terminal must wait for the continuation attach",
+        );
+        assert.isTrue(
+          yield* hasPendingBackgroundWork,
+          "child-session must not clear the pin while wakeBuffer still has delivery",
+        );
+
+        // Continuation attach drains the preserved buffer and projects it.
+        const continuationNow = yield* DateTime.now;
+        yield* runtime.startTurn(
+          makeTurnInput({
+            threadId,
+            providerThread,
+            instanceId,
+            runtimePolicy,
+            now: continuationNow,
+            ordinal: 2,
+            messageCreatedBy: "agent",
+            messageCreationSource: "provider",
+            messageText: "Background task completed.",
+          }),
+        );
+        yield* TestClock.adjust("3 seconds");
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+
+        const continuationProviderTurnId = idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:2",
+        });
+        let continuationTerminal: string | null = null;
+        let completedSubagentTurnItems = 0;
+        let bufferedTextSeen = false;
+        while (continuationTerminal === null) {
+          const event = yield* Queue.take(events);
+          if (
+            event.type === "turn_item.updated" &&
+            event.turnItem.type === "subagent" &&
+            event.turnItem.status === "completed"
+          ) {
+            completedSubagentTurnItems += 1;
+          }
+          if (
+            event.type === "message.updated" &&
+            event.message.role === "assistant" &&
+            event.message.text.includes(bufferedAssistantText)
+          ) {
+            bufferedTextSeen = true;
+          }
+          if (
+            event.type === "turn.terminal" &&
+            event.providerTurnId === continuationProviderTurnId
+          ) {
+            continuationTerminal = event.status;
+          }
+        }
+        assert.equal(continuationTerminal, "completed");
+        assert.isTrue(
+          bufferedTextSeen,
+          "continuation drain must project buffered post-settle assistant text (buffer not wiped)",
+        );
+        assert.equal(
+          completedSubagentTurnItems,
+          1,
+          "continuation drain must project the terminal subagent turn item once",
+        );
+        assert.isFalse(
+          yield* hasPendingBackgroundWork,
+          "pin must clear after the continuation drains, not when the child session completed",
+        );
+      }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect(
+    "projects once when root-session then child-session complete the same carryover subagent",
+    () =>
+      Effect.gen(function* () {
+        const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+        const fileSystem = yield* FileSystem.FileSystem;
+        const idAllocator = yield* IdAllocatorV2;
+        const path = yield* Path.Path;
+        const serverConfig = yield* ServerConfig;
+        const mockAgentPath = yield* path.fromFileUrl(
+          new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+        );
+        const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+        const continuationRequests: Array<ProviderContinuationRequest> = [];
+        const instanceId = ProviderInstanceId.make("acp-test");
+        const childSessionId = "mock-child-session-root-then-child";
+        let subagentPhase: "spawn" | "complete" = "spawn";
+        type RuntimeService = AcpSessionRuntime.AcpSessionRuntime["Service"];
+        let sessionUpdateHandler: Parameters<RuntimeService["handleSessionUpdate"]>[0] | undefined;
+        const adapter = makeAcpAdapterV2({
+          crypto: yield* Crypto.Crypto,
+          instanceId,
+          flavor: {
+            driver: ACP_TEST_DRIVER,
+            capabilities: AcpProviderCapabilitiesV2,
+            deferFinalizeForBackgroundWork: true,
+            enablePostSettleContinuation: true,
+            extractSubagentUpdate: (toolCall) =>
+              toolCall.toolCallId !== "tool-call-generic-1"
+                ? undefined
+                : subagentPhase === "spawn"
+                  ? {
+                      nativeTaskId: "task-generic-1",
+                      prompt: "background subagent",
+                      title: "background subagent",
+                      model: null,
+                      status: "running",
+                      childSessionId,
+                      result: null,
+                    }
+                  : {
+                      nativeTaskId: "task-generic-1",
+                      prompt: "",
+                      title: null,
+                      model: null,
+                      status: "completed",
+                      childSessionId,
+                      result: "SUB_DONE",
+                    },
+            makeRuntime: makeMockRuntime({
+              childProcessSpawner,
+              mockAgentPath,
+              environment: { T3_ACP_EMIT_GENERIC_TOOL_PLACEHOLDERS: "1" },
+              protocolEvents,
+              wrapRuntime: (runtime) => ({
+                ...runtime,
+                handleSessionUpdate: (handler) =>
+                  Effect.sync(() => {
+                    sessionUpdateHandler = handler;
+                  }).pipe(Effect.andThen(runtime.handleSessionUpdate(handler))),
+              }),
+            }),
+          },
+          fileSystem,
+          idAllocator,
+          serverConfig,
+          continuationRequests: {
+            offer: (request) =>
+              Effect.sync(() => {
+                continuationRequests.push(request);
+              }),
+          },
+        });
+        const threadId = ThreadId.make("thread-acp-carryover-root-then-child");
+        const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          cwd: process.cwd(),
+        });
+        const modelSelection = { instanceId, model: "default" } as const;
+        const runtime = yield* adapter.openSession({
+          threadId,
+          providerSessionId: ProviderSessionId.make(
+            "provider-session-acp-carryover-root-then-child",
+          ),
+          modelSelection,
+          runtimePolicy,
+        });
+        if (runtime.hasPendingBackgroundWork === undefined) {
+          return yield* Effect.die(
+            "ACP runtime must expose hasPendingBackgroundWork when post-settle continuation is enabled.",
+          );
+        }
+        const hasPendingBackgroundWork = runtime.hasPendingBackgroundWork;
+        const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+        yield* runtime.events.pipe(
+          Stream.runForEach((event) => Queue.offer(events, event)),
+          Effect.forkScoped,
+        );
+        const providerThread = yield* runtime.ensureThread({
+          threadId,
+          modelSelection,
+          runtimePolicy,
+        });
+        const now = yield* DateTime.now;
+        yield* runtime.startTurn(
+          makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now }),
+        );
+        yield* Stream.fromQueue(protocolEvents).pipe(
+          Stream.filter(
+            (event) =>
+              event.direction === "incoming" &&
+              event.stage === "raw" &&
+              typeof event.payload === "string" &&
+              event.payload.includes('"stopReason"'),
+          ),
+          Stream.runHead,
+        );
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+
+        const firstProviderTurnId = idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:1",
+        });
+        const interruptFiber = yield* runtime
+          .interruptTurn({ providerThread, providerTurnId: firstProviderTurnId })
+          .pipe(Effect.forkScoped);
+        yield* TestClock.adjust("10 seconds");
+        yield* Fiber.join(interruptFiber);
+
+        let firstTerminalStatus: string | null = null;
+        while (firstTerminalStatus === null) {
+          const event = yield* Queue.take(events);
+          if (event.type === "turn.terminal" && event.providerTurnId === firstProviderTurnId) {
+            firstTerminalStatus = event.status;
+          }
+        }
+        assert.equal(firstTerminalStatus, "interrupted");
+        assert.isTrue(
+          yield* hasPendingBackgroundWork,
+          "carryover live subagent must pin hasPendingBackgroundWork after root settle",
+        );
+        assert.isDefined(sessionUpdateHandler, "session update handler must be wired");
+
+        // The interrupted root-session completion advances in-memory carryover
+        // without projecting and offers a continuation. Child-session replay
+        // must not project a second copy before that observable attach.
+        subagentPhase = "complete";
+        yield* sessionUpdateHandler!({
+          sessionId: "mock-session-1",
+          update: {
+            sessionUpdate: "tool_call_update",
+            toolCallId: "tool-call-generic-1",
+            title: "background subagent",
+            kind: "other",
+            status: "completed",
+            rawOutput: { content: "SUB_DONE" },
+          },
+        });
+        assert.lengthOf(
+          continuationRequests,
+          1,
+          "root-session terminal must still offer a continuation",
+        );
+
+        yield* sessionUpdateHandler!({
+          sessionId: childSessionId,
+          update: {
+            sessionUpdate: "tool_call_update",
+            toolCallId: "tool-call-generic-1",
+            title: "background subagent",
+            kind: "other",
+            status: "completed",
+            rawOutput: { content: "SUB_DONE" },
+          },
+        });
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+
+        let completedBeforeDrain = 0;
+        let polled = yield* Queue.poll(events);
+        while (Option.isSome(polled)) {
+          const event = polled.value;
+          if (
+            event.type === "turn_item.updated" &&
+            event.turnItem.type === "subagent" &&
+            event.turnItem.status === "completed"
+          ) {
+            completedBeforeDrain += 1;
+          }
+          polled = yield* Queue.poll(events);
+        }
+        assert.equal(
+          completedBeforeDrain,
+          0,
+          "interrupted root-then-child completion must defer to the continuation attach",
+        );
+
+        const continuationNow = yield* DateTime.now;
+        yield* runtime.startTurn(
+          makeTurnInput({
+            threadId,
+            providerThread,
+            instanceId,
+            runtimePolicy,
+            now: continuationNow,
+            ordinal: 2,
+            messageCreatedBy: "agent",
+            messageCreationSource: "provider",
+            messageText: "Background task completed.",
+          }),
+        );
+        yield* TestClock.adjust("3 seconds");
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+
+        const continuationProviderTurnId = idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:2",
+        });
+        let continuationTerminal: string | null = null;
+        let completedSubagentTurnItems = 0;
+        while (continuationTerminal === null) {
+          const event = yield* Queue.take(events);
+          if (
+            event.type === "turn_item.updated" &&
+            event.turnItem.type === "subagent" &&
+            event.turnItem.status === "completed"
+          ) {
+            completedSubagentTurnItems += 1;
+          }
+          if (
+            event.type === "turn.terminal" &&
+            event.providerTurnId === continuationProviderTurnId
+          ) {
+            continuationTerminal = event.status;
+          }
+        }
+        assert.equal(continuationTerminal, "completed");
+        assert.equal(
+          completedSubagentTurnItems,
+          1,
+          "root-then-child completion must project the terminal subagent turn item exactly once",
+        );
+        assert.isFalse(
+          yield* hasPendingBackgroundWork,
+          "hasPendingBackgroundWork must end false after the continuation drains",
+        );
+      }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect(
+    "preserveRuntimeOnSettledInterrupt keeps the process alive and carries subagents through a settled steering interrupt",
+    () =>
+      Effect.gen(function* () {
+        const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+        const fileSystem = yield* FileSystem.FileSystem;
+        const idAllocator = yield* IdAllocatorV2;
+        const path = yield* Path.Path;
+        const serverConfig = yield* ServerConfig;
+        const mockAgentPath = yield* path.fromFileUrl(
+          new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+        );
+        const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+        const instanceId = ProviderInstanceId.make("acp-test");
+        let subagentPhase: "spawn" | "complete" = "spawn";
+        let cancelCalled = false;
+        let runtimeOrdinalSeen = 0;
+        const adapter = makeAcpAdapterV2({
+          crypto: yield* Crypto.Crypto,
+          instanceId,
+          flavor: {
+            driver: ACP_TEST_DRIVER,
+            capabilities: AcpProviderCapabilitiesV2,
+            deferFinalizeForBackgroundWork: true,
+            // Hard interrupt flags (stricter than production Grok, which no
+            // longer sets restartRuntimeOnEveryInterrupt): every interrupt
+            // would hard-kill the process group without the settled-soft gate
+            // under test.
+            restartRuntimeAfterInterrupt: true,
+            restartRuntimeOnEveryInterrupt: true,
+            terminateRuntimeProcessGroupOnInterrupt: true,
+            preserveRuntimeOnSettledInterrupt: true,
+            extractSubagentUpdate: (toolCall) =>
+              toolCall.toolCallId !== "tool-call-generic-1"
+                ? undefined
+                : subagentPhase === "spawn"
+                  ? {
+                      nativeTaskId: "task-generic-1",
+                      prompt: "background subagent",
+                      title: "background subagent",
+                      model: null,
+                      status: "running",
+                      childSessionId: null,
+                      result: null,
+                    }
+                  : {
+                      nativeTaskId: "task-generic-1",
+                      prompt: "",
+                      title: null,
+                      model: null,
+                      status: "completed",
+                      childSessionId: null,
+                      result: "SUB_DONE",
+                    },
+            // No ownDetachedProcessGroup: if the interrupt wrongly takes the
+            // hard path, terminateProcessGroup is missing and the interrupt
+            // fails loudly with a poisoned session.
+            makeRuntime: makeMockRuntime({
+              childProcessSpawner,
+              mockAgentPath,
+              environment: (runtimeOrdinal) => {
+                runtimeOrdinalSeen = Math.max(runtimeOrdinalSeen, runtimeOrdinal);
+                return { T3_ACP_EMIT_GENERIC_TOOL_PLACEHOLDERS: "1" };
+              },
+              protocolEvents,
+              wrapCancel: (cancel) =>
+                Effect.sync(() => {
+                  cancelCalled = true;
+                }).pipe(Effect.andThen(cancel)),
+            }),
+          },
+          fileSystem,
+          idAllocator,
+          serverConfig,
+        });
+        const threadId = ThreadId.make("thread-acp-settled-soft-steer");
+        const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          cwd: process.cwd(),
+        });
+        const modelSelection = { instanceId, model: "default" } as const;
+        const runtime = yield* adapter.openSession({
+          threadId,
+          providerSessionId: ProviderSessionId.make("provider-session-acp-settled-soft-steer"),
+          modelSelection,
+          runtimePolicy,
+        });
+        const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+        yield* runtime.events.pipe(
+          Stream.runForEach((event) => Queue.offer(events, event)),
+          Effect.forkScoped,
+        );
+        const providerThread = yield* runtime.ensureThread({
+          threadId,
+          modelSelection,
+          runtimePolicy,
+        });
+        const now = yield* DateTime.now;
+        yield* runtime.startTurn(
+          makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now }),
+        );
+        // The still-running subagent defers finalize after session/prompt returns,
+        // so the interrupt below hits a settled turn held open for background work.
+        yield* Stream.fromQueue(protocolEvents).pipe(
+          Stream.filter(
+            (event) =>
+              event.direction === "incoming" &&
+              event.stage === "raw" &&
+              typeof event.payload === "string" &&
+              event.payload.includes('"stopReason"'),
+          ),
+          Stream.runHead,
+        );
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+
+        const firstProviderTurnId = idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:1",
+        });
+        const interruptFiber = yield* runtime
+          .interruptTurn({ providerThread, providerTurnId: firstProviderTurnId })
+          .pipe(Effect.forkScoped);
+        yield* TestClock.adjust("10 seconds");
+        yield* Fiber.join(interruptFiber);
+        assert.isFalse(
+          cancelCalled,
+          "settled soft steer must not send session/cancel (the real Grok CLI kills background subagents on cancel)",
+        );
+
+        let subagentTurnItemId: string | null = null;
+        let firstTerminalStatus: string | null = null;
+        while (firstTerminalStatus === null) {
+          const event = yield* Queue.take(events);
+          if (event.type === "turn_item.updated" && event.turnItem.type === "subagent") {
+            subagentTurnItemId = event.turnItem.id;
+          }
+          if (event.type === "turn.terminal" && event.providerTurnId === firstProviderTurnId) {
+            firstTerminalStatus = event.status;
+          }
+        }
+        assert.equal(firstTerminalStatus, "interrupted");
+        assert.notEqual(subagentTurnItemId, null);
+
+        subagentPhase = "complete";
+        const secondNow = yield* DateTime.now;
+        yield* runtime.startTurn(
+          makeTurnInput({
+            threadId,
+            providerThread,
+            instanceId,
+            runtimePolicy,
+            now: secondNow,
+            ordinal: 2,
+          }),
+        );
+        // Same runtime process (mock-session-1): a respawn would start
+        // mock-session-2 and drop the carryover on the session mismatch.
+        const secondProviderTurnId = idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:2",
+        });
+        let carriedItemStatus: string | null = null;
+        let secondTerminalStatus: string | null = null;
+        while (secondTerminalStatus === null) {
+          const event = yield* Queue.take(events);
+          if (
+            event.type === "turn_item.updated" &&
+            event.turnItem.type === "subagent" &&
+            event.turnItem.id === subagentTurnItemId
+          ) {
+            carriedItemStatus = event.turnItem.status;
+          }
+          if (event.type === "turn.terminal" && event.providerTurnId === secondProviderTurnId) {
+            secondTerminalStatus = event.status;
+          }
+        }
+        assert.equal(carriedItemStatus, "completed");
+        assert.equal(secondTerminalStatus, "completed");
+        assert.equal(
+          runtimeOrdinalSeen,
+          1,
+          "settled soft steer must not respawn the ACP runtime process",
+        );
+      }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.live("preserveRuntimeOnSettledInterrupt does not soften a mid-prompt steering interrupt", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+      const instanceId = ProviderInstanceId.make("acp-test");
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          restartRuntimeAfterInterrupt: true,
+          // Local hard-flavor gate: production Grok no longer sets
+          // restartRuntimeOnEveryInterrupt, but when a flavor does, the
+          // settled-soft gate must not leak onto an unsettled prompt.
+          restartRuntimeOnEveryInterrupt: true,
+          terminateRuntimeProcessGroupOnInterrupt: true,
+          preserveRuntimeOnSettledInterrupt: true,
+          // No ownDetachedProcessGroup: the expected hard path fails loudly
+          // on the missing terminateProcessGroup, proving the settled-soft
+          // gate did not apply to an unsettled prompt.
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            mockAgentPath,
+            environment: { T3_ACP_HANG_PROMPT_FOREVER: "1" },
+            protocolEvents,
+          }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+      });
+      const threadId = ThreadId.make("thread-acp-unsettled-steer-stays-hard");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make(
+          "provider-session-acp-unsettled-steer-stays-hard",
+        ),
+        modelSelection,
+        runtimePolicy,
+      });
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      const now = yield* DateTime.now;
+      yield* runtime
+        .startTurn(
+          makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now, ordinal: 1 }),
+        )
+        .pipe(Effect.forkScoped);
+      yield* Stream.fromQueue(protocolEvents).pipe(
+        Stream.filter(
+          (event) =>
+            event.direction === "outgoing" && rawProtocolMethod(event) === "session/prompt",
+        ),
+        Stream.runHead,
+      );
+      const providerTurnId = idAllocator.derive.providerTurn({
+        driver: ACP_TEST_DRIVER,
+        nativeTurnId: "mock-session-1:turn:1",
+      });
+      const interruptExit = yield* runtime
+        .interruptTurn({ providerThread, providerTurnId })
+        .pipe(Effect.exit);
+      if (Exit.isSuccess(interruptExit)) {
+        assert.fail("mid-prompt steering interrupt must still take the hard teardown path");
+      }
+      assert.include(Cause.pretty(interruptExit.cause), "session is poisoned");
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.live(
+    "soft mid-prompt interrupt cancels in place, reuses the runtime, and tracks cancel-backgrounded work",
+    () =>
+      Effect.gen(function* () {
+        const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+        const fileSystem = yield* FileSystem.FileSystem;
+        const idAllocator = yield* IdAllocatorV2;
+        const path = yield* Path.Path;
+        const serverConfig = yield* ServerConfig;
+        const mockAgentPath = yield* path.fromFileUrl(
+          new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+        );
+        const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+        const continuationRequests: Array<ProviderContinuationRequest> = [];
+        const instanceId = ProviderInstanceId.make("acp-test");
+        let cancelCalled = false;
+        let runtimeOrdinalSeen = 0;
+        const adapter = makeAcpAdapterV2({
+          crypto: yield* Crypto.Crypto,
+          instanceId,
+          flavor: {
+            driver: ACP_TEST_DRIVER,
+            capabilities: AcpProviderCapabilitiesV2,
+            enablePostSettleContinuation: true,
+            // Production Grok interrupt flags: hard teardown only with
+            // requestRuntimeRestart (user Stop). Without
+            // restartRuntimeOnEveryInterrupt a mid-prompt steering interrupt
+            // stays soft: session/cancel, same process, session reuse.
+            restartRuntimeAfterInterrupt: true,
+            terminateRuntimeProcessGroupOnInterrupt: true,
+            preserveRuntimeOnSettledInterrupt: true,
+            registerExtensions: ({ runtime: extensionRuntime, applyBackgroundTaskMutation }) =>
+              registerXAiBackgroundTaskTracking(extensionRuntime, applyBackgroundTaskMutation),
+            // No ownDetachedProcessGroup: if the interrupt wrongly takes the
+            // hard path, terminateProcessGroup is missing and the interrupt
+            // fails loudly with a poisoned session.
+            makeRuntime: makeMockRuntime({
+              childProcessSpawner,
+              mockAgentPath,
+              environment: (runtimeOrdinal) => {
+                runtimeOrdinalSeen = Math.max(runtimeOrdinalSeen, runtimeOrdinal);
+                return {
+                  T3_ACP_EMIT_RUNNING_COMMAND_THEN_HANG_FIRST_PROMPT: "1",
+                  T3_ACP_EMIT_TASK_BACKGROUNDED_AFTER_CANCEL: "1",
+                };
+              },
+              protocolEvents,
+              wrapCancel: (cancel) =>
+                Effect.sync(() => {
+                  cancelCalled = true;
+                }).pipe(Effect.andThen(cancel)),
+            }),
+          },
+          fileSystem,
+          idAllocator,
+          serverConfig,
+          continuationRequests: {
+            offer: (request) =>
+              Effect.sync(() => {
+                continuationRequests.push(request);
+              }),
+          },
+        });
+        const threadId = ThreadId.make("thread-acp-soft-mid-prompt-steer");
+        const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          cwd: process.cwd(),
+        });
+        const modelSelection = { instanceId, model: "default" } as const;
+        const runtime = yield* adapter.openSession({
+          threadId,
+          providerSessionId: ProviderSessionId.make("provider-session-acp-soft-mid-prompt-steer"),
+          modelSelection,
+          runtimePolicy,
+        });
+        if (runtime.hasPendingBackgroundWork === undefined) {
+          return yield* Effect.die(
+            "ACP runtime must expose hasPendingBackgroundWork when post-settle continuation is enabled.",
+          );
+        }
+        const hasPendingBackgroundWork = runtime.hasPendingBackgroundWork;
+        const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+        yield* runtime.events.pipe(
+          Stream.runForEach((event) => Queue.offer(events, event)),
+          Effect.forkScoped,
+        );
+        const providerThread = yield* runtime.ensureThread({
+          threadId,
+          modelSelection,
+          runtimePolicy,
+        });
+        const now = yield* DateTime.now;
+        yield* runtime
+          .startTurn(
+            makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now, ordinal: 1 }),
+          )
+          .pipe(Effect.forkScoped);
+        // Wait for the running command tool so the interrupt lands mid-prompt.
+        yield* Stream.fromQueue(protocolEvents).pipe(
+          Stream.filter(
+            (event) =>
+              event.direction === "incoming" &&
+              event.stage === "raw" &&
+              typeof event.payload === "string" &&
+              event.payload.includes("tool-call-running-1"),
+          ),
+          Stream.runHead,
+        );
+
+        const firstProviderTurnId = idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:1",
+        });
+        // No requestRuntimeRestart: a steering interrupt, not a user Stop.
+        yield* runtime.interruptTurn({ providerThread, providerTurnId: firstProviderTurnId });
+        assert.isTrue(
+          cancelCalled,
+          "soft mid-prompt interrupt must send session/cancel to detach the running work",
+        );
+
+        let firstTerminalStatus: string | null = null;
+        while (firstTerminalStatus === null) {
+          const event = yield* Queue.take(events);
+          if (event.type === "turn.terminal" && event.providerTurnId === firstProviderTurnId) {
+            firstTerminalStatus = event.status;
+          }
+        }
+        assert.equal(firstTerminalStatus, "interrupted");
+        // The cancel handler emitted _x.ai/task_backgrounded for the detached
+        // command; the tracked task must report as pending background work.
+        let backgroundTracked = false;
+        for (let attempt = 0; attempt < 80 && !backgroundTracked; attempt += 1) {
+          backgroundTracked = yield* hasPendingBackgroundWork;
+          if (!backgroundTracked) {
+            yield* Effect.sleep("25 millis");
+          }
+        }
+        assert.isTrue(
+          backgroundTracked,
+          "cancel-backgrounded task must be tracked as running background work",
+        );
+
+        // The second prompt reuses the same process and session.
+        const secondNow = yield* DateTime.now;
+        yield* runtime.startTurn(
+          makeTurnInput({
+            threadId,
+            providerThread,
+            instanceId,
+            runtimePolicy,
+            now: secondNow,
+            ordinal: 2,
+          }),
+        );
+        const secondProviderTurnId = idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:2",
+        });
+        let secondTerminalStatus: string | null = null;
+        while (secondTerminalStatus === null) {
+          const event = yield* Queue.take(events);
+          if (event.type === "turn.terminal" && event.providerTurnId === secondProviderTurnId) {
+            secondTerminalStatus = event.status;
+          }
+        }
+        assert.equal(secondTerminalStatus, "completed");
+        assert.equal(
+          runtimeOrdinalSeen,
+          1,
+          "soft mid-prompt interrupt must not respawn the ACP runtime process",
+        );
+
+        // _x.ai/task_completed lands ~1.2s after the cancel and clears the
+        // tracked task without opening a synthetic continuation run.
+        let backgroundPending = true;
+        for (let attempt = 0; attempt < 50 && backgroundPending; attempt += 1) {
+          backgroundPending = yield* hasPendingBackgroundWork;
+          if (backgroundPending) {
+            yield* Effect.sleep("100 millis");
+          }
+        }
+        assert.isFalse(
+          backgroundPending,
+          "tracked background task must clear after _x.ai/task_completed",
+        );
+        assert.lengthOf(
+          continuationRequests,
+          0,
+          "a cancel-backgrounded task completion must not wake a synthetic continuation run",
+        );
+      }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.live("direct Stop quarantine drops late background task mutations from the stopped run", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+      const instanceId = ProviderInstanceId.make("acp-test");
+      const capturedMutation: {
+        current:
+          | ((mutation: {
+              readonly sessionId: string;
+              readonly taskId: string;
+              readonly status: "running" | "completed" | "failed";
+            }) => Effect.Effect<void>)
+          | null;
+      } = { current: null };
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          enablePostSettleContinuation: true,
+          restartRuntimeAfterInterrupt: true,
+          terminateRuntimeProcessGroupOnInterrupt: true,
+          preserveRuntimeOnSettledInterrupt: true,
+          registerExtensions: (context) =>
+            Effect.sync(() => {
+              capturedMutation.current = context.applyBackgroundTaskMutation;
+            }),
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            mockAgentPath,
+            environment: { T3_ACP_HANG_PROMPT_FOREVER: "1" },
+            ownDetachedProcessGroup: true,
+            protocolEvents,
+          }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+        continuationRequests: { offer: () => Effect.void },
+      });
+      const threadId = ThreadId.make("thread-acp-stop-quarantine-late-task");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make("provider-session-acp-stop-quarantine-late-task"),
+        modelSelection,
+        runtimePolicy,
+      });
+      if (runtime.hasPendingBackgroundWork === undefined) {
+        return yield* Effect.die(
+          "ACP runtime must expose hasPendingBackgroundWork when post-settle continuation is enabled.",
+        );
+      }
+      const hasPendingBackgroundWork = runtime.hasPendingBackgroundWork;
+      const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+      yield* runtime.events.pipe(
+        Stream.runForEach((event) => Queue.offer(events, event)),
+        Effect.forkScoped,
+      );
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      const now = yield* DateTime.now;
+      yield* runtime
+        .startTurn(
+          makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now, ordinal: 1 }),
+        )
+        .pipe(Effect.forkScoped);
+      yield* Stream.fromQueue(protocolEvents).pipe(
+        Stream.filter(
+          (event) =>
+            event.direction === "outgoing" && rawProtocolMethod(event) === "session/prompt",
+        ),
+        Stream.runHead,
+      );
+      const applyMutation = capturedMutation.current;
+      if (applyMutation === null) {
+        return yield* Effect.die("registerExtensions must capture applyBackgroundTaskMutation");
+      }
+      // Plumbing sanity: pre-Stop mutations on the root session track and
+      // clear pending background work through the extension callback.
+      yield* applyMutation({
+        sessionId: "mock-session-1",
+        taskId: "task-pre-stop",
+        status: "running",
+      });
+      assert.isTrue(
+        yield* hasPendingBackgroundWork,
+        "a running background task mutation on the root session must track before Stop",
+      );
+      yield* applyMutation({
+        sessionId: "mock-session-1",
+        taskId: "task-pre-stop",
+        status: "completed",
+      });
+      assert.isFalse(
+        yield* hasPendingBackgroundWork,
+        "a completed background task mutation must clear pending background work",
+      );
+
+      const providerTurnId = idAllocator.derive.providerTurn({
+        driver: ACP_TEST_DRIVER,
+        nativeTurnId: "mock-session-1:turn:1",
+      });
+      yield* runtime.interruptTurn({ providerThread, providerTurnId, requestRuntimeRestart: true });
+      let terminalStatus: string | null = null;
+      while (terminalStatus === null) {
+        const event = yield* Queue.take(events);
+        if (event.type === "turn.terminal" && event.providerTurnId === providerTurnId) {
+          terminalStatus = event.status;
+        }
+      }
+      assert.equal(terminalStatus, "interrupted");
+
+      // Residual lifecycle from the stopped run: activeSessionId still points
+      // at the stopped session until the next turn respawns the runtime, so
+      // only the direct Stop quarantine stands between this mutation and the
+      // wake machinery.
+      yield* applyMutation({
+        sessionId: "mock-session-1",
+        taskId: "task-late-after-stop",
+        status: "running",
+      });
+      assert.isFalse(
+        yield* hasPendingBackgroundWork,
+        "direct Stop quarantine must drop residual background task mutations from the stopped run",
+      );
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.live("production Grok interrupt flags still hard-kill and respawn on user Stop", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+      const instanceId = ProviderInstanceId.make("acp-test");
+      let runtimeOrdinalSeen = 0;
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          enablePostSettleContinuation: true,
+          // The full production Grok interrupt flag set after the non-Stop
+          // softening: no restartRuntimeOnEveryInterrupt. User Stop
+          // (requestRuntimeRestart) must still take the hard teardown and
+          // respawn path, not the soft cancel path.
+          restartRuntimeAfterInterrupt: true,
+          terminateRuntimeProcessGroupOnInterrupt: true,
+          preserveRuntimeOnSettledInterrupt: true,
+          registerExtensions: ({ runtime: extensionRuntime, applyBackgroundTaskMutation }) =>
+            registerXAiBackgroundTaskTracking(extensionRuntime, applyBackgroundTaskMutation),
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            mockAgentPath,
+            // Only hang the interrupted first turn. The replacement process must
+            // complete normally so startTurn / session-load assertions can finish.
+            environment: (runtimeOrdinal) => {
+              runtimeOrdinalSeen = Math.max(runtimeOrdinalSeen, runtimeOrdinal);
+              return runtimeOrdinal === 1 ? { T3_ACP_HANG_PROMPT_FOREVER: "1" } : {};
+            },
+            ownDetachedProcessGroup: true,
+            protocolEvents,
+          }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+        continuationRequests: { offer: () => Effect.void },
+      });
+      const threadId = ThreadId.make("thread-acp-production-stop-hard-kill");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make("provider-session-acp-production-stop-hard-kill"),
+        modelSelection,
+        runtimePolicy,
+      });
+      const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+      yield* runtime.events.pipe(
+        Stream.runForEach((event) => Queue.offer(events, event)),
+        Effect.forkScoped,
+      );
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      const now = yield* DateTime.now;
+      yield* runtime
+        .startTurn(
+          makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now, ordinal: 1 }),
+        )
+        .pipe(Effect.forkScoped);
+      yield* Stream.fromQueue(protocolEvents).pipe(
+        Stream.filter(
+          (event) =>
+            event.direction === "outgoing" && rawProtocolMethod(event) === "session/prompt",
+        ),
+        Stream.runHead,
+      );
+      const providerTurnId = idAllocator.derive.providerTurn({
+        driver: ACP_TEST_DRIVER,
+        nativeTurnId: "mock-session-1:turn:1",
+      });
+      yield* runtime.interruptTurn({ providerThread, providerTurnId, requestRuntimeRestart: true });
+      let terminalStatus: string | null = null;
+      while (terminalStatus === null) {
+        const event = yield* Queue.take(events);
+        if (event.type === "turn.terminal" && event.providerTurnId === providerTurnId) {
+          terminalStatus = event.status;
+        }
+      }
+      assert.equal(terminalStatus, "interrupted");
+
+      // Effect 4 Queue.takeAll waits for at least one element when empty. After
+      // the session/prompt stream drain the protocol queue is often empty, so
+      // takeAll would hang forever. Use clear (non-blocking drain) instead so
+      // the session/load wait cannot match residual pre-restart traffic.
+      yield* Queue.clear(protocolEvents);
+      yield* runtime.startTurn(
+        makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now, ordinal: 2 }),
+      );
+      const loadAfterRestart = yield* Stream.fromQueue(protocolEvents).pipe(
+        Stream.filter(
+          (event) => event.direction === "outgoing" && rawProtocolMethod(event) === "session/load",
+        ),
+        Stream.runHead,
+      );
+      assert.isTrue(
+        Option.isSome(loadAfterRestart),
+        "user Stop must respawn the runtime and reload the session on the next turn",
+      );
+      assert.equal(
+        runtimeOrdinalSeen,
+        2,
+        "user Stop with production Grok flags must replace the ACP runtime process",
+      );
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  // it.live: ownDetachedProcessGroup teardown uses wall-clock sleeps; under
+  // it.effect the interrupt timeout on context.completed still needs real time
+  // after the soft steer clears the turn.
+  it.live(
+    "Stop after settled soft steer contains the orphan runtime and respawns without subagent carryover",
+    () =>
+      Effect.gen(function* () {
+        const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+        const fileSystem = yield* FileSystem.FileSystem;
+        const idAllocator = yield* IdAllocatorV2;
+        const path = yield* Path.Path;
+        const serverConfig = yield* ServerConfig;
+        const mockAgentPath = yield* path.fromFileUrl(
+          new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+        );
+        const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+        const instanceId = ProviderInstanceId.make("acp-test");
+        let subagentPhase: "spawn" | "complete" = "spawn";
+        let cancelCalled = false;
+        let runtimeOrdinalSeen = 0;
+        const childSessionId = "mock-child-session-1";
+        const streamedSubagentText = "streamed subagent carryover text";
+        type RuntimeService = AcpSessionRuntime.AcpSessionRuntime["Service"];
+        let sessionUpdateHandler: Parameters<RuntimeService["handleSessionUpdate"]>[0] | undefined;
+        const adapter = makeAcpAdapterV2({
+          crypto: yield* Crypto.Crypto,
+          instanceId,
+          flavor: {
+            driver: ACP_TEST_DRIVER,
+            capabilities: AcpProviderCapabilitiesV2,
+            deferFinalizeForBackgroundWork: true,
+            // Production Grok interrupt flags: soft settle keeps the process;
+            // only requestRuntimeRestart (user Stop) hard-kills.
+            restartRuntimeAfterInterrupt: true,
+            terminateRuntimeProcessGroupOnInterrupt: true,
+            preserveRuntimeOnSettledInterrupt: true,
+            extractSubagentUpdate: (toolCall) =>
+              toolCall.toolCallId !== "tool-call-generic-1"
+                ? undefined
+                : subagentPhase === "spawn"
+                  ? {
+                      nativeTaskId: "task-generic-1",
+                      prompt: "background subagent",
+                      title: "background subagent",
+                      model: null,
+                      status: "running",
+                      childSessionId,
+                      result: null,
+                    }
+                  : {
+                      nativeTaskId: "task-generic-1",
+                      prompt: "",
+                      title: null,
+                      model: null,
+                      status: "completed",
+                      childSessionId: null,
+                      result: "SUB_DONE",
+                    },
+            makeRuntime: makeMockRuntime({
+              childProcessSpawner,
+              mockAgentPath,
+              environment: (runtimeOrdinal) => {
+                runtimeOrdinalSeen = Math.max(runtimeOrdinalSeen, runtimeOrdinal);
+                return { T3_ACP_EMIT_GENERIC_TOOL_PLACEHOLDERS: "1" };
+              },
+              ownDetachedProcessGroup: true,
+              protocolEvents,
+              wrapCancel: (cancel) =>
+                Effect.sync(() => {
+                  cancelCalled = true;
+                }).pipe(Effect.andThen(cancel)),
+              wrapRuntime: (runtime) => ({
+                ...runtime,
+                handleSessionUpdate: (handler) =>
+                  Effect.sync(() => {
+                    sessionUpdateHandler = handler;
+                  }).pipe(Effect.andThen(runtime.handleSessionUpdate(handler))),
+              }),
+            }),
+          },
+          fileSystem,
+          idAllocator,
+          serverConfig,
+        });
+        const threadId = ThreadId.make("thread-acp-stop-after-soft-steer-orphan");
+        const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          cwd: process.cwd(),
+        });
+        const modelSelection = { instanceId, model: "default" } as const;
+        const runtime = yield* adapter.openSession({
+          threadId,
+          providerSessionId: ProviderSessionId.make(
+            "provider-session-acp-stop-after-soft-steer-orphan",
+          ),
+          modelSelection,
+          runtimePolicy,
+        });
+        const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+        yield* runtime.events.pipe(
+          Stream.runForEach((event) => Queue.offer(events, event)),
+          Effect.forkScoped,
+        );
+        const providerThread = yield* runtime.ensureThread({
+          threadId,
+          modelSelection,
+          runtimePolicy,
+        });
+        const now = yield* DateTime.now;
+        yield* runtime.startTurn(
+          makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now }),
+        );
+        yield* Stream.fromQueue(protocolEvents).pipe(
+          Stream.filter(
+            (event) =>
+              event.direction === "incoming" &&
+              event.stage === "raw" &&
+              typeof event.payload === "string" &&
+              event.payload.includes('"stopReason"'),
+          ),
+          Stream.runHead,
+        );
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+
+        // Stream assistant text onto the carryover subagent while the deferred
+        // turn is still active so assistantText races ahead of task.result.
+        assert.isDefined(sessionUpdateHandler, "session update handler must be wired");
+        yield* sessionUpdateHandler!({
+          sessionId: childSessionId,
+          update: {
+            sessionUpdate: "agent_message_chunk",
+            content: { type: "text", text: streamedSubagentText },
+          },
+        });
+        let subagentTurnItemId: string | null = null;
+        let streamedTextSeen = false;
+        for (let attempt = 0; attempt < 64; attempt += 1) {
+          const maybeEvent = yield* Queue.take(events).pipe(Effect.timeoutOption("50 millis"));
+          if (Option.isNone(maybeEvent)) break;
+          const event = maybeEvent.value;
+          if (event.type === "turn_item.updated" && event.turnItem.type === "subagent") {
+            subagentTurnItemId = event.turnItem.id;
+          }
+          if (
+            event.type === "message.updated" &&
+            event.message.text.includes(streamedSubagentText)
+          ) {
+            streamedTextSeen = true;
+            break;
+          }
+        }
+        assert.isTrue(
+          streamedTextSeen,
+          "pre-steer child session chunk must project as subagent assistant text",
+        );
+
+        const firstProviderTurnId = idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:1",
+        });
+        // Soft steer first: clears the turn, leaves the process alive.
+        yield* runtime.interruptTurn({ providerThread, providerTurnId: firstProviderTurnId });
+        assert.isFalse(
+          cancelCalled,
+          "settled soft steer must not send session/cancel before the later Stop",
+        );
+
+        let firstTerminalStatus: string | null = null;
+        while (firstTerminalStatus === null) {
+          const event = yield* Queue.take(events);
+          if (event.type === "turn_item.updated" && event.turnItem.type === "subagent") {
+            subagentTurnItemId = event.turnItem.id;
+          }
+          if (event.type === "turn.terminal" && event.providerTurnId === firstProviderTurnId) {
+            firstTerminalStatus = event.status;
+          }
+        }
+        assert.equal(firstTerminalStatus, "interrupted");
+        assert.notEqual(subagentTurnItemId, null);
+        assert.equal(
+          runtimeOrdinalSeen,
+          1,
+          "soft steer must leave the original ACP runtime process alive",
+        );
+
+        // User Stop against the already-cleared turn: contain the orphan runtime.
+        const stopExit = yield* runtime
+          .interruptTurn({
+            providerThread,
+            providerTurnId: firstProviderTurnId,
+            requestRuntimeRestart: true,
+          })
+          .pipe(Effect.exit);
+        if (Exit.isFailure(stopExit)) {
+          assert.fail(
+            `cleared-turn Stop must contain the orphan runtime, not fail: ${Cause.pretty(stopExit.cause)}`,
+          );
+        }
+
+        // Orphan Stop must terminalize carried-over subagents (soft steer left them
+        // running on purpose; quarantine alone would leave them stuck "running").
+        let subagentStopStatus: string | null = null;
+        let subagentStopResult: string | null | undefined;
+        let subagentStopProviderThreadId: string | null | undefined;
+        let subagentUpdatedResult: string | null | undefined;
+        for (let attempt = 0; attempt < 64; attempt += 1) {
+          const maybeEvent = yield* Queue.take(events).pipe(Effect.timeoutOption("50 millis"));
+          if (Option.isNone(maybeEvent)) break;
+          const event = maybeEvent.value;
+          if (
+            event.type === "turn_item.updated" &&
+            event.turnItem.type === "subagent" &&
+            event.turnItem.id === subagentTurnItemId
+          ) {
+            subagentStopStatus = event.turnItem.status;
+            subagentStopResult = event.turnItem.result;
+            subagentStopProviderThreadId = event.turnItem.providerThreadId;
+            if (subagentStopStatus === "interrupted") break;
+          }
+          if (
+            event.type === "subagent.updated" &&
+            event.subagent.status === "interrupted" &&
+            event.subagent.result === streamedSubagentText
+          ) {
+            subagentUpdatedResult = event.subagent.result;
+          }
+        }
+        assert.equal(
+          subagentStopStatus,
+          "interrupted",
+          "orphan Stop must emit interrupted terminal for turn-1 carryover subagent",
+        );
+        assert.equal(
+          subagentStopResult,
+          streamedSubagentText,
+          "orphan Stop must merge streamed assistantText into the interrupted result",
+        );
+        assert.equal(
+          subagentStopProviderThreadId,
+          providerThread.id,
+          "orphan Stop parent-level events must use the spawn-time parent provider thread id",
+        );
+        assert.equal(
+          subagentUpdatedResult,
+          streamedSubagentText,
+          "orphan Stop subagent.updated must also carry the streamed result",
+        );
+
+        yield* Queue.clear(protocolEvents);
+        const secondNow = yield* DateTime.now;
+        yield* runtime.startTurn(
+          makeTurnInput({
+            threadId,
+            providerThread,
+            instanceId,
+            runtimePolicy,
+            now: secondNow,
+            ordinal: 2,
+          }),
+        );
+        const loadAfterRestart = yield* Stream.fromQueue(protocolEvents).pipe(
+          Stream.filter(
+            (event) =>
+              event.direction === "outgoing" &&
+              (rawProtocolMethod(event) === "session/load" ||
+                rawProtocolMethod(event) === "session/new"),
+          ),
+          Stream.runHead,
+        );
+        assert.isTrue(
+          Option.isSome(loadAfterRestart),
+          "orphan containment must force a runtime respawn before the next turn",
+        );
+        assert.equal(
+          runtimeOrdinalSeen,
+          2,
+          "Stop after soft steer must replace the orphan ACP runtime process",
+        );
+
+        // nativeTurnId is `${sessionId}:turn:${ordinal}`. The mock always uses
+        // mock-session-1; ordinal 2 yields turn:2 on the replacement process.
+        // Carryover was quarantined by Stop, so turn-1's subagent must not re-attach.
+        subagentPhase = "complete";
+        const secondProviderTurnId = idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:2",
+        });
+        let carriedItemStatus: string | null = null;
+        let secondTerminalStatus: string | null = null;
+        while (secondTerminalStatus === null) {
+          const event = yield* Queue.take(events);
+          if (
+            event.type === "turn_item.updated" &&
+            event.turnItem.type === "subagent" &&
+            event.turnItem.id === subagentTurnItemId
+          ) {
+            carriedItemStatus = event.turnItem.status;
+          }
+          if (event.type === "turn.terminal" && event.providerTurnId === secondProviderTurnId) {
+            secondTerminalStatus = event.status;
+          }
+        }
+        assert.isNull(
+          carriedItemStatus,
+          "Stop quarantine must drop turn-1 subagent carryover on the respawned runtime",
+        );
+        assert.equal(secondTerminalStatus, "completed");
+      }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.live("Direct Stop projects an interrupt-deferred terminal exactly once", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+      const instanceId = ProviderInstanceId.make("acp-test");
+      const childSessionId = "mock-child-session-direct-stop-deferred-terminal";
+      let subagentPhase: "spawn" | "complete" = "spawn";
+      type RuntimeService = AcpSessionRuntime.AcpSessionRuntime["Service"];
+      let sessionUpdateHandler: Parameters<RuntimeService["handleSessionUpdate"]>[0] | undefined;
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          deferFinalizeForBackgroundWork: true,
+          enablePostSettleContinuation: true,
+          restartRuntimeAfterInterrupt: true,
+          terminateRuntimeProcessGroupOnInterrupt: true,
+          preserveRuntimeOnSettledInterrupt: true,
+          extractSubagentUpdate: (toolCall) =>
+            toolCall.toolCallId !== "tool-call-generic-1"
+              ? undefined
+              : subagentPhase === "spawn"
+                ? {
+                    nativeTaskId: "task-generic-1",
+                    prompt: "background subagent",
+                    title: "background subagent",
+                    model: null,
+                    status: "running",
+                    childSessionId,
+                    result: null,
+                  }
+                : {
+                    nativeTaskId: "task-generic-1",
+                    prompt: "",
+                    title: null,
+                    model: null,
+                    status: "completed",
+                    childSessionId,
+                    result: "SUB_DONE",
+                  },
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            mockAgentPath,
+            environment: { T3_ACP_EMIT_GENERIC_TOOL_PLACEHOLDERS: "1" },
+            ownDetachedProcessGroup: true,
+            protocolEvents,
+            wrapRuntime: (runtime) => ({
+              ...runtime,
+              handleSessionUpdate: (handler) =>
+                Effect.sync(() => {
+                  sessionUpdateHandler = handler;
+                }).pipe(Effect.andThen(runtime.handleSessionUpdate(handler))),
+            }),
+          }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+        continuationRequests: { offer: () => Effect.void },
+      });
+      const threadId = ThreadId.make("thread-acp-direct-stop-deferred-terminal");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make(
+          "provider-session-acp-direct-stop-deferred-terminal",
+        ),
+        modelSelection,
+        runtimePolicy,
+      });
+      if (runtime.hasPendingBackgroundWork === undefined) {
+        return yield* Effect.die(
+          "ACP runtime must expose hasPendingBackgroundWork when post-settle continuation is enabled.",
+        );
+      }
+      const hasPendingBackgroundWork = runtime.hasPendingBackgroundWork;
+      const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+      yield* runtime.events.pipe(
+        Stream.runForEach((event) => Queue.offer(events, event)),
+        Effect.forkScoped,
+      );
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      const now = yield* DateTime.now;
+      yield* runtime.startTurn(
+        makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now }),
+      );
+      yield* Stream.fromQueue(protocolEvents).pipe(
+        Stream.filter(
+          (event) =>
+            event.direction === "incoming" &&
+            event.stage === "raw" &&
+            typeof event.payload === "string" &&
+            event.payload.includes('"stopReason"'),
+        ),
+        Stream.runHead,
+      );
+      yield* Effect.yieldNow;
+      yield* Effect.yieldNow;
+
+      const providerTurnId = idAllocator.derive.providerTurn({
+        driver: ACP_TEST_DRIVER,
+        nativeTurnId: "mock-session-1:turn:1",
+      });
+      yield* runtime.interruptTurn({ providerThread, providerTurnId });
+      let rootTerminal: string | null = null;
+      while (rootTerminal === null) {
+        const event = yield* Queue.take(events);
+        if (event.type === "turn.terminal" && event.providerTurnId === providerTurnId) {
+          rootTerminal = event.status;
+        }
+      }
+      assert.equal(rootTerminal, "interrupted");
+      assert.isDefined(sessionUpdateHandler, "session update handler must be wired");
+
+      subagentPhase = "complete";
+      yield* sessionUpdateHandler!({
+        sessionId: childSessionId,
+        update: {
+          sessionUpdate: "tool_call_update",
+          toolCallId: "tool-call-generic-1",
+          title: "background subagent",
+          kind: "other",
+          status: "completed",
+          rawOutput: { content: "SUB_DONE" },
+        },
+      });
+      yield* Effect.yieldNow;
+      let completedBeforeStop = 0;
+      let polled = yield* Queue.poll(events);
+      while (Option.isSome(polled)) {
+        const event = polled.value;
+        if (
+          event.type === "turn_item.updated" &&
+          event.turnItem.type === "subagent" &&
+          event.turnItem.status === "completed"
+        ) {
+          completedBeforeStop += 1;
+        }
+        polled = yield* Queue.poll(events);
+      }
+      assert.equal(completedBeforeStop, 0);
+      assert.isTrue(
+        yield* hasPendingBackgroundWork,
+        "interrupt-deferred terminal must pin until hard-stop projection",
+      );
+
+      const stopExit = yield* runtime
+        .interruptTurn({
+          providerThread,
+          providerTurnId,
+          requestRuntimeRestart: true,
+        })
+        .pipe(Effect.exit);
+      if (Exit.isFailure(stopExit)) {
+        assert.fail(`Direct Stop must contain the orphan runtime: ${Cause.pretty(stopExit.cause)}`);
+      }
+
+      let completedAfterStop = 0;
+      for (let attempt = 0; attempt < 64; attempt += 1) {
+        const maybeEvent = yield* Queue.take(events).pipe(Effect.timeoutOption("50 millis"));
+        if (Option.isNone(maybeEvent)) break;
+        const event = maybeEvent.value;
+        if (
+          event.type === "turn_item.updated" &&
+          event.turnItem.type === "subagent" &&
+          event.turnItem.status === "completed"
+        ) {
+          completedAfterStop += 1;
+        }
+      }
+      assert.equal(completedAfterStop, 1);
+      assert.isFalse(yield* hasPendingBackgroundWork);
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect(
+    "settled soft interrupt skips cancel when prompt wire is settled before completion callback",
+    () =>
+      Effect.gen(function* () {
+        const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+        const fileSystem = yield* FileSystem.FileSystem;
+        const idAllocator = yield* IdAllocatorV2;
+        const path = yield* Path.Path;
+        const serverConfig = yield* ServerConfig;
+        const mockAgentPath = yield* path.fromFileUrl(
+          new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+        );
+        const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+        const instanceId = ProviderInstanceId.make("acp-test");
+        let subagentPhase: "spawn" | "complete" = "spawn";
+        let cancelCalled = false;
+        const promptPhases: Array<string> = [];
+        // Gate adapter-visible prompt return so we can open the race window after
+        // the native stopReason is on the wire. Release lets Effect.tap mark
+        // promptWireSettled before the completion callback requests the permit;
+        // interrupt then ORs wire-done with promptSettled under the permit.
+        const promptWireReturned = yield* Deferred.make<void>();
+        const releasePromptCompletion = yield* Deferred.make<void>();
+        const adapter = makeAcpAdapterV2({
+          crypto: yield* Crypto.Crypto,
+          instanceId,
+          flavor: {
+            driver: ACP_TEST_DRIVER,
+            capabilities: AcpProviderCapabilitiesV2,
+            deferFinalizeForBackgroundWork: true,
+            // Production Grok flags: without settled-soft, a steer soft-cancels.
+            restartRuntimeAfterInterrupt: true,
+            terminateRuntimeProcessGroupOnInterrupt: true,
+            preserveRuntimeOnSettledInterrupt: true,
+            extractSubagentUpdate: (toolCall) =>
+              toolCall.toolCallId !== "tool-call-generic-1"
+                ? undefined
+                : subagentPhase === "spawn"
+                  ? {
+                      nativeTaskId: "task-generic-1",
+                      prompt: "background subagent",
+                      title: "background subagent",
+                      model: null,
+                      status: "running",
+                      childSessionId: null,
+                      result: null,
+                    }
+                  : {
+                      nativeTaskId: "task-generic-1",
+                      prompt: "",
+                      title: null,
+                      model: null,
+                      status: "completed",
+                      childSessionId: null,
+                      result: "SUB_DONE",
+                    },
+            makeRuntime: makeMockRuntime({
+              childProcessSpawner,
+              mockAgentPath,
+              environment: { T3_ACP_EMIT_GENERIC_TOOL_PLACEHOLDERS: "1" },
+              protocolEvents,
+              wrapCancel: (cancel) =>
+                Effect.sync(() => {
+                  cancelCalled = true;
+                }).pipe(Effect.andThen(cancel)),
+              wrapRuntime: (runtime) => ({
+                ...runtime,
+                prompt: (payload) =>
+                  Effect.gen(function* () {
+                    promptPhases.push("prompt-start");
+                    const result = yield* runtime.prompt(payload);
+                    promptPhases.push("wire-returned");
+                    yield* Deferred.succeed(promptWireReturned, undefined);
+                    yield* Deferred.await(releasePromptCompletion);
+                    promptPhases.push("completion-released");
+                    return result;
+                  }),
+              }),
+            }),
+          },
+          fileSystem,
+          idAllocator,
+          serverConfig,
+        });
+        const threadId = ThreadId.make("thread-acp-settled-soft-admission-race");
+        const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          cwd: process.cwd(),
+        });
+        const modelSelection = { instanceId, model: "default" } as const;
+        const runtime = yield* adapter.openSession({
+          threadId,
+          providerSessionId: ProviderSessionId.make(
+            "provider-session-acp-settled-soft-admission-race",
+          ),
+          modelSelection,
+          runtimePolicy,
+        });
+        const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+        yield* runtime.events.pipe(
+          Stream.runForEach((event) => Queue.offer(events, event)),
+          Effect.forkScoped,
+        );
+        const providerThread = yield* runtime.ensureThread({
+          threadId,
+          modelSelection,
+          runtimePolicy,
+        });
+        const now = yield* DateTime.now;
+        yield* runtime.startTurn(
+          makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now }),
+        );
+        yield* Deferred.await(promptWireReturned);
+        yield* Stream.fromQueue(protocolEvents).pipe(
+          Stream.filter(
+            (event) =>
+              event.direction === "incoming" &&
+              event.stage === "raw" &&
+              typeof event.payload === "string" &&
+              event.payload.includes('"stopReason"'),
+          ),
+          Stream.runHead,
+        );
+        assert.deepEqual(promptPhases, ["prompt-start", "wire-returned"]);
+
+        const firstProviderTurnId = idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:1",
+        });
+        // Fork interrupt while the adapter-side return is still gated. Release so
+        // promptWireSettled completes (Effect.tap) before/while the completion
+        // callback contends for runtimeCallbackPermit. Holding the gate forever
+        // would also block the wire signal (same Effect resolution), so release
+        // is required; the assertion is cancel skipped after that race window.
+        const interruptFiber = yield* runtime
+          .interruptTurn({ providerThread, providerTurnId: firstProviderTurnId })
+          .pipe(Effect.forkScoped);
+        yield* Deferred.succeed(releasePromptCompletion, undefined);
+        for (let attempt = 0; attempt < 20; attempt += 1) {
+          if (promptPhases.includes("completion-released")) break;
+          yield* Effect.yieldNow;
+        }
+        yield* TestClock.adjust("10 seconds");
+        yield* Fiber.join(interruptFiber);
+
+        assert.includeMembers(promptPhases, [
+          "prompt-start",
+          "wire-returned",
+          "completion-released",
+        ]);
+        assert.isFalse(
+          cancelCalled,
+          "settled soft steer must skip session/cancel once the prompt wire has settled",
+        );
+
+        let firstTerminalStatus: string | null = null;
+        while (firstTerminalStatus === null) {
+          const event = yield* Queue.take(events);
+          if (event.type === "turn.terminal" && event.providerTurnId === firstProviderTurnId) {
+            firstTerminalStatus = event.status;
+          }
+        }
+        assert.equal(firstTerminalStatus, "interrupted");
+        assert.equal(subagentPhase, "spawn");
+      }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect(
+    "does not pin hasPendingBackgroundWork when a late TaskOutput re-reports an in-turn-handled task",
+    () =>
+      Effect.gen(function* () {
+        const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+        const fileSystem = yield* FileSystem.FileSystem;
+        const idAllocator = yield* IdAllocatorV2;
+        const path = yield* Path.Path;
+        const serverConfig = yield* ServerConfig;
+        const mockAgentPath = yield* path.fromFileUrl(
+          new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+        );
+        const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+        const continuationRequests: Array<ProviderContinuationRequest> = [];
+        const instanceId = ProviderInstanceId.make("acp-test");
+        const adapter = makeAcpAdapterV2({
+          crypto: yield* Crypto.Crypto,
+          instanceId,
+          flavor: {
+            driver: ACP_TEST_DRIVER,
+            capabilities: AcpProviderCapabilitiesV2,
+            enablePostSettleContinuation: true,
+            extractBackgroundTaskId: (toolCall) =>
+              toolCall.toolCallId === "tool-call-monitor-1" ? "task-monitor-1" : undefined,
+            extractBackgroundTaskCompletion: (toolCall) =>
+              toolCall.toolCallId === "tool-call-fetch-1"
+                ? [
+                    {
+                      taskId: "task-monitor-1",
+                      status: toolCall.status === "completed" ? "completed" : "running",
+                      appendOutput: toolCall.status === "completed" ? "MONITOR_LISTING_TOKEN" : "",
+                    },
+                  ]
+                : [],
+            makeRuntime: makeMockRuntime({
+              childProcessSpawner,
+              mockAgentPath,
+              environment: {
+                T3_ACP_EMIT_IN_TURN_TASKOUTPUT_THEN_LATE_DUPLICATE: "1",
+              },
+              protocolEvents,
+            }),
+          },
+          fileSystem,
+          idAllocator,
+          serverConfig,
+          continuationRequests: {
+            offer: (request) =>
+              Effect.sync(() => {
+                continuationRequests.push(request);
+              }),
+          },
+        });
+        const threadId = ThreadId.make("thread-acp-already-handled-wake-pin");
+        const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          cwd: process.cwd(),
+        });
+        const modelSelection = { instanceId, model: "default" } as const;
+        const runtime = yield* adapter.openSession({
+          threadId,
+          providerSessionId: ProviderSessionId.make(
+            "provider-session-acp-already-handled-wake-pin",
+          ),
+          modelSelection,
+          runtimePolicy,
+        });
+        if (runtime.hasPendingBackgroundWork === undefined) {
+          return yield* Effect.die(
+            "ACP runtime must expose hasPendingBackgroundWork when post-settle continuation is enabled.",
+          );
+        }
+        const hasPendingBackgroundWork = runtime.hasPendingBackgroundWork;
+        const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+        yield* runtime.events.pipe(
+          Stream.runForEach((event) => Queue.offer(events, event)),
+          Effect.forkScoped,
+        );
+        const providerThread = yield* runtime.ensureThread({
+          threadId,
+          modelSelection,
+          runtimePolicy,
+        });
+        const now = yield* DateTime.now;
+        yield* runtime.startTurn(
+          makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now }),
+        );
+        const providerTurnId = idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:1",
+        });
+
+        let terminalStatus: string | null = null;
+        while (terminalStatus === null) {
+          const event = yield* Queue.take(events);
+          if (event.type === "turn.terminal" && event.providerTurnId === providerTurnId) {
+            terminalStatus = event.status;
+          }
+        }
+        assert.equal(terminalStatus, "completed");
+
+        // Wait for the late post-finalize duplicate TaskOutput frame.
+        yield* Stream.fromQueue(protocolEvents).pipe(
+          Stream.filter(
+            (event) =>
+              event.direction === "incoming" &&
+              event.stage === "raw" &&
+              typeof event.payload === "string" &&
+              event.payload.includes("MONITOR_LISTING_TOKEN_LATE"),
+          ),
+          Stream.runHead,
+        );
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+
+        assert.lengthOf(
+          continuationRequests,
+          0,
+          "already-handled late TaskOutput must not open a continuation run",
+        );
+        assert.isFalse(
+          yield* hasPendingBackgroundWork,
+          "wake buffer must not stay non-empty and pin idle release after an already-handled re-report",
+        );
+      }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect(
+    "keeps a dispatched continuation offer sticky until a turn starts or the worker drops it",
+    () =>
+      Effect.gen(function* () {
+        const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+        const fileSystem = yield* FileSystem.FileSystem;
+        const idAllocator = yield* IdAllocatorV2;
+        const path = yield* Path.Path;
+        const serverConfig = yield* ServerConfig;
+        const mockAgentPath = yield* path.fromFileUrl(
+          new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+        );
+        const continuationRequests: Array<ProviderContinuationRequest> = [];
+        type RuntimeService = AcpSessionRuntime.AcpSessionRuntime["Service"];
+        let sessionUpdateHandler: Parameters<RuntimeService["handleSessionUpdate"]>[0] | undefined;
+        const instanceId = ProviderInstanceId.make("acp-test");
+        const adapter = makeAcpAdapterV2({
+          crypto: yield* Crypto.Crypto,
+          instanceId,
+          flavor: {
+            driver: ACP_TEST_DRIVER,
+            capabilities: AcpProviderCapabilitiesV2,
+            enablePostSettleContinuation: true,
+            makeRuntime: makeMockRuntime({
+              childProcessSpawner,
+              mockAgentPath,
+              wrapRuntime: (runtime) => ({
+                ...runtime,
+                handleSessionUpdate: (handler) =>
+                  Effect.sync(() => {
+                    sessionUpdateHandler = handler;
+                  }).pipe(Effect.andThen(runtime.handleSessionUpdate(handler))),
+              }),
+            }),
+          },
+          fileSystem,
+          idAllocator,
+          serverConfig,
+          continuationRequests: {
+            offer: (request) =>
+              Effect.sync(() => {
+                continuationRequests.push(request);
+              }),
+          },
+        });
+        const threadId = ThreadId.make("thread-acp-sticky-continuation-dispatch");
+        const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          cwd: process.cwd(),
+        });
+        const modelSelection = { instanceId, model: "default" } as const;
+        const runtime = yield* adapter.openSession({
+          threadId,
+          providerSessionId: ProviderSessionId.make(
+            "provider-session-acp-sticky-continuation-dispatch",
+          ),
+          modelSelection,
+          runtimePolicy,
+        });
+        const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+        yield* runtime.events.pipe(
+          Stream.runForEach((event) => Queue.offer(events, event)),
+          Effect.forkScoped,
+        );
+        const providerThread = yield* runtime.ensureThread({
+          threadId,
+          modelSelection,
+          runtimePolicy,
+        });
+        const now = yield* DateTime.now;
+        yield* runtime.startTurn(
+          makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now }),
+        );
+        const providerTurnId = idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:1",
+        });
+        let terminalStatus: string | null = null;
+        while (terminalStatus === null) {
+          const event = yield* Queue.take(events);
+          if (event.type === "turn.terminal" && event.providerTurnId === providerTurnId) {
+            terminalStatus = event.status;
+          }
+        }
+        assert.equal(terminalStatus, "completed");
+        assert.isDefined(sessionUpdateHandler, "session update handler must be wired");
+
+        const lateTool = (toolCallId: string) =>
+          sessionUpdateHandler!({
+            sessionId: "mock-session-1",
+            update: {
+              sessionUpdate: "tool_call_update",
+              toolCallId,
+              title: "Late tool result",
+              kind: "other",
+              status: "completed",
+              rawOutput: { output: toolCallId },
+            },
+          });
+        yield* lateTool("first-late-result");
+        assert.lengthOf(continuationRequests, 1);
+        const first = continuationRequests[0]!;
+        assert.isDefined(first.dispatchIfCurrent);
+        assert.isTrue(Option.isSome(yield* first.dispatchIfCurrent!(Effect.void)));
+
+        yield* lateTool("second-frame-before-dispatched-turn-starts");
+        assert.lengthOf(
+          continuationRequests,
+          1,
+          "late frames must not enqueue duplicate continuations during dispatch-to-start",
+        );
+
+        assert.isDefined(first.clearIfCurrent);
+        yield* first.clearIfCurrent!();
+        yield* lateTool("new-result-after-worker-drop");
+        assert.lengthOf(continuationRequests, 2);
+      }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect("keeps a buffered continuation current when a user turn starts before dispatch", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const continuationRequests: Array<ProviderContinuationRequest> = [];
+      const userPromptStarted = yield* Deferred.make<void>();
+      const releaseUserPrompt = yield* Deferred.make<void>();
+      const bufferedAssistantText = "BUFFERED_WAKE_QUEUED_AFTER_USER";
+      let promptOrdinal = 0;
+      type RuntimeService = AcpSessionRuntime.AcpSessionRuntime["Service"];
+      let sessionUpdateHandler: Parameters<RuntimeService["handleSessionUpdate"]>[0] | undefined;
+      const instanceId = ProviderInstanceId.make("acp-test");
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          deferFinalizeForBackgroundWork: true,
+          enablePostSettleContinuation: true,
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            mockAgentPath,
+            wrapRuntime: (runtime) => ({
+              ...runtime,
+              handleSessionUpdate: (handler) =>
+                Effect.sync(() => {
+                  sessionUpdateHandler = handler;
+                }).pipe(Effect.andThen(runtime.handleSessionUpdate(handler))),
+              prompt: (payload) =>
+                Effect.gen(function* () {
+                  promptOrdinal += 1;
+                  const currentPromptOrdinal = promptOrdinal;
+                  const result = yield* runtime.prompt(payload);
+                  if (currentPromptOrdinal === 2) {
+                    yield* Deferred.succeed(userPromptStarted, undefined);
+                    yield* Deferred.await(releaseUserPrompt);
+                  }
+                  return result;
+                }),
+            }),
+          }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+        continuationRequests: {
+          offer: (request) =>
+            Effect.sync(() => {
+              continuationRequests.push(request);
+            }),
+        },
+      });
+      const threadId = ThreadId.make("thread-acp-buffered-continuation-user-race");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make(
+          "provider-session-acp-buffered-continuation-user-race",
+        ),
+        modelSelection,
+        runtimePolicy,
+      });
+      if (runtime.hasPendingBackgroundWork === undefined) {
+        return yield* Effect.die(
+          "ACP runtime must expose hasPendingBackgroundWork when post-settle continuation is enabled.",
+        );
+      }
+      const hasPendingBackgroundWork = runtime.hasPendingBackgroundWork;
+      const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+      yield* runtime.events.pipe(
+        Stream.runForEach((event) => Queue.offer(events, event)),
+        Effect.forkScoped,
+      );
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      yield* runtime.startTurn(
+        makeTurnInput({
+          threadId,
+          providerThread,
+          instanceId,
+          runtimePolicy,
+          now: yield* DateTime.now,
+        }),
+      );
+      const firstProviderTurnId = idAllocator.derive.providerTurn({
+        driver: ACP_TEST_DRIVER,
+        nativeTurnId: "mock-session-1:turn:1",
+      });
+      let firstTerminalStatus: string | null = null;
+      while (firstTerminalStatus === null) {
+        const event = yield* Queue.take(events);
+        if (event.type === "turn.terminal" && event.providerTurnId === firstProviderTurnId) {
+          firstTerminalStatus = event.status;
+        }
+      }
+      assert.equal(firstTerminalStatus, "completed");
+      assert.isDefined(sessionUpdateHandler, "session update handler must be wired");
+
+      yield* sessionUpdateHandler!({
+        sessionId: "mock-session-1",
+        update: {
+          sessionUpdate: "agent_message_chunk",
+          content: { type: "text", text: bufferedAssistantText },
+        },
+      });
+      assert.lengthOf(continuationRequests, 1);
+      const continuationRequest = continuationRequests[0]!;
+      assert.isDefined(continuationRequest.dispatchIfCurrent);
+
+      yield* runtime.startTurn(
+        makeTurnInput({
+          threadId,
+          providerThread,
+          instanceId,
+          runtimePolicy,
+          now: yield* DateTime.now,
+          ordinal: 2,
+          messageText: "User turn won the continuation dispatch race.",
+        }),
+      );
+      yield* Deferred.await(userPromptStarted);
+      let continuationDispatched = false;
+      const dispatchOutcome = yield* continuationRequest.dispatchIfCurrent!(
+        Effect.sync(() => {
+          continuationDispatched = true;
+        }),
+      );
+      assert.isTrue(
+        Option.isSome(dispatchOutcome),
+        "queue_after_active dispatch must remain current while the user run is active",
+      );
+      assert.isTrue(continuationDispatched);
+      yield* Deferred.succeed(releaseUserPrompt, undefined);
+
+      const userProviderTurnId = idAllocator.derive.providerTurn({
+        driver: ACP_TEST_DRIVER,
+        nativeTurnId: "mock-session-1:turn:2",
+      });
+      let userTerminalStatus: string | null = null;
+      while (userTerminalStatus === null) {
+        const event = yield* Queue.take(events);
+        if (event.type === "turn.terminal" && event.providerTurnId === userProviderTurnId) {
+          userTerminalStatus = event.status;
+        }
+      }
+      assert.equal(userTerminalStatus, "completed");
+      assert.isTrue(
+        yield* hasPendingBackgroundWork,
+        "the queued continuation must retain ownership of its buffered wake traffic",
+      );
+
+      yield* runtime.startTurn(
+        makeTurnInput({
+          threadId,
+          providerThread,
+          instanceId,
+          runtimePolicy,
+          now: yield* DateTime.now,
+          ordinal: 3,
+          messageCreatedBy: "agent",
+          messageCreationSource: "provider",
+          messageText: "Background task completed.",
+        }),
+      );
+      yield* TestClock.adjust("3 seconds");
+      const continuationProviderTurnId = idAllocator.derive.providerTurn({
+        driver: ACP_TEST_DRIVER,
+        nativeTurnId: "mock-session-1:turn:3",
+      });
+      let continuationTerminalStatus: string | null = null;
+      let bufferedTextSeen = false;
+      while (continuationTerminalStatus === null) {
+        const event = yield* Queue.take(events);
+        if (
+          event.type === "message.updated" &&
+          event.message.role === "assistant" &&
+          event.message.text.includes(bufferedAssistantText)
+        ) {
+          bufferedTextSeen = true;
+        }
+        if (event.type === "turn.terminal" && event.providerTurnId === continuationProviderTurnId) {
+          continuationTerminalStatus = event.status;
+        }
+      }
+      assert.equal(continuationTerminalStatus, "completed");
+      assert.isTrue(bufferedTextSeen, "continuation must drain the wake buffer after the user run");
+      assert.isFalse(yield* hasPendingBackgroundWork);
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect(
+    "holds a settled turn until the injected monitor report streams instead of finalizing into it",
+    () =>
+      Effect.gen(function* () {
+        const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+        const fileSystem = yield* FileSystem.FileSystem;
+        const idAllocator = yield* IdAllocatorV2;
+        const path = yield* Path.Path;
+        const serverConfig = yield* ServerConfig;
+        const mockAgentPath = yield* path.fromFileUrl(
+          new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+        );
+        const triggerDir = yield* fileSystem.makeTempDirectoryScoped();
+        const triggerPath = path.join(triggerDir, "report-trigger");
+        const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+        const instanceId = ProviderInstanceId.make("acp-test");
+        const adapter = makeAcpAdapterV2({
+          crypto: yield* Crypto.Crypto,
+          instanceId,
+          flavor: {
+            driver: ACP_TEST_DRIVER,
+            capabilities: AcpProviderCapabilitiesV2,
+            deferFinalizeForBackgroundWork: true,
+            extractBackgroundTaskId: (toolCall) =>
+              toolCall.toolCallId === "tool-call-monitor-1" ? "task-monitor-1" : undefined,
+            extractBackgroundToolMutation: (text) =>
+              text.includes('Monitor "task-monitor-1" ended')
+                ? [{ taskId: "task-monitor-1", status: "completed", appendOutput: "" }]
+                : [],
+            extractBackgroundTaskCompletion: (toolCall) =>
+              toolCall.toolCallId === "tool-call-fetch-1"
+                ? [
+                    {
+                      taskId: "task-monitor-1",
+                      status: toolCall.status === "completed" ? "completed" : "running",
+                      appendOutput: toolCall.status === "completed" ? "MONITOR_LISTING_TOKEN" : "",
+                    },
+                  ]
+                : [],
+            makeRuntime: makeMockRuntime({
+              childProcessSpawner,
+              mockAgentPath,
+              environment: {
+                T3_ACP_EMIT_POST_SETTLE_MONITOR_FLOW: "1",
+                T3_ACP_INJECTED_REPORT_TRIGGER_PATH: triggerPath,
+              },
+              protocolEvents,
+            }),
+          },
+          fileSystem,
+          idAllocator,
+          serverConfig,
+        });
+        const threadId = ThreadId.make("thread-acp-injected-report-hold");
+        const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          cwd: process.cwd(),
+        });
+        const modelSelection = { instanceId, model: "default" } as const;
+        const runtime = yield* adapter.openSession({
+          threadId,
+          providerSessionId: ProviderSessionId.make("provider-session-acp-injected-report"),
+          modelSelection,
+          runtimePolicy,
+        });
+        const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+        yield* runtime.events.pipe(
+          Stream.runForEach((event) => Queue.offer(events, event)),
+          Effect.forkScoped,
+        );
+        const providerThread = yield* runtime.ensureThread({
+          threadId,
+          modelSelection,
+          runtimePolicy,
+        });
+        const now = yield* DateTime.now;
+        yield* runtime.startTurn(
+          makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now }),
+        );
+        const providerTurnId = idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:1",
+        });
+
+        // Wait (real time) until the post-settle end notice and TaskOutput
+        // hydration are ingested: the hydrated monitor card carries the
+        // fetched listing.
+        let reportSeen = false;
+        const trackReport = (event: ProviderAdapterV2Event): void => {
+          if (
+            event.type === "turn_item.updated" &&
+            event.turnItem.type === "assistant_message" &&
+            event.turnItem.text.includes("MONITOR_REPORT_TOKEN")
+          ) {
+            reportSeen = true;
+          }
+        };
+        let hydrated = false;
+        while (!hydrated) {
+          const event = yield* Queue.take(events);
+          if (
+            event.type === "turn_item.updated" &&
+            event.turnItem.type === "command_execution" &&
+            event.turnItem.status === "completed" &&
+            (event.turnItem.output ?? "").includes("MONITOR_LISTING_TOKEN")
+          ) {
+            hydrated = true;
+          }
+        }
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+
+        // Pre-fix the 2s deferred-finalize debounce fires here and the report
+        // streamed by the injected turn afterwards is dropped on the floor.
+        yield* TestClock.adjust("3 seconds");
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+        let drained = yield* Queue.poll(events);
+        while (Option.isSome(drained)) {
+          trackReport(drained.value);
+          assert.notEqual(
+            drained.value.type,
+            "turn.terminal",
+            "deferred finalize must hold while the injected-turn report is owed",
+          );
+          drained = yield* Queue.poll(events);
+        }
+
+        // Release the report, then the normal debounce finalizes the turn.
+        yield* fileSystem.writeFileString(triggerPath, "go");
+        yield* Stream.fromQueue(protocolEvents).pipe(
+          Stream.filter(
+            (event) =>
+              event.direction === "incoming" &&
+              event.stage === "raw" &&
+              typeof event.payload === "string" &&
+              event.payload.includes("MONITOR_REPORT_TOKEN"),
+          ),
+          Stream.runHead,
+        );
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+        yield* TestClock.adjust("3 seconds");
+
+        let terminalStatus: string | null = null;
+        while (terminalStatus === null) {
+          const event = yield* Queue.take(events);
+          trackReport(event);
+          if (event.type === "turn.terminal" && event.providerTurnId === providerTurnId) {
+            terminalStatus = event.status;
+          }
+        }
+        assert.equal(terminalStatus, "completed");
+        assert.isTrue(
+          reportSeen,
+          "the injected-turn report must project before the turn finalizes",
+        );
+      }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect(
+    "settle-without-report held turn with mid-hold ext completion does not open a wake after the injected report",
+    () =>
+      Effect.gen(function* () {
+        const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+        const fileSystem = yield* FileSystem.FileSystem;
+        const idAllocator = yield* IdAllocatorV2;
+        const path = yield* Path.Path;
+        const serverConfig = yield* ServerConfig;
+        const mockAgentPath = yield* path.fromFileUrl(
+          new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+        );
+        const triggerDir = yield* fileSystem.makeTempDirectoryScoped();
+        const triggerPath = path.join(triggerDir, "report-trigger");
+        const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+        const continuationRequests: Array<ProviderContinuationRequest> = [];
+        const capturedMutation: {
+          current:
+            | ((mutation: {
+                readonly sessionId: string;
+                readonly taskId: string;
+                readonly status: "running" | "completed" | "failed";
+              }) => Effect.Effect<void>)
+            | null;
+        } = { current: null };
+        const instanceId = ProviderInstanceId.make("acp-test");
+        const adapter = makeAcpAdapterV2({
+          crypto: yield* Crypto.Crypto,
+          instanceId,
+          flavor: {
+            driver: ACP_TEST_DRIVER,
+            capabilities: AcpProviderCapabilitiesV2,
+            deferFinalizeForBackgroundWork: true,
+            enablePostSettleContinuation: true,
+            extractBackgroundTaskId: (toolCall) =>
+              toolCall.toolCallId === "tool-call-monitor-1" ? "task-monitor-1" : undefined,
+            extractBackgroundToolMutation: (text) =>
+              text.includes('Monitor "task-monitor-1" ended')
+                ? [{ taskId: "task-monitor-1", status: "completed", appendOutput: "" }]
+                : [],
+            extractBackgroundTaskCompletion: (toolCall) =>
+              toolCall.toolCallId === "tool-call-fetch-1"
+                ? [
+                    {
+                      taskId: "task-monitor-1",
+                      status: toolCall.status === "completed" ? "completed" : "running",
+                      appendOutput: toolCall.status === "completed" ? "MONITOR_LISTING_TOKEN" : "",
+                    },
+                  ]
+                : [],
+            registerExtensions: (context) =>
+              Effect.sync(() => {
+                capturedMutation.current = context.applyBackgroundTaskMutation;
+              }),
+            makeRuntime: makeMockRuntime({
+              childProcessSpawner,
+              mockAgentPath,
+              environment: {
+                T3_ACP_EMIT_POST_SETTLE_MONITOR_FLOW: "1",
+                T3_ACP_INJECTED_REPORT_TRIGGER_PATH: triggerPath,
+              },
+              protocolEvents,
+            }),
+          },
+          fileSystem,
+          idAllocator,
+          serverConfig,
+          continuationRequests: {
+            offer: (request) =>
+              Effect.sync(() => {
+                continuationRequests.push(request);
+              }),
+          },
+        });
+        const threadId = ThreadId.make("thread-acp-settle-hold-ext-complete-no-wake");
+        const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          cwd: process.cwd(),
+        });
+        const modelSelection = { instanceId, model: "default" } as const;
+        const runtime = yield* adapter.openSession({
+          threadId,
+          providerSessionId: ProviderSessionId.make(
+            "provider-session-acp-settle-hold-ext-complete-no-wake",
+          ),
+          modelSelection,
+          runtimePolicy,
+        });
+        const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+        yield* runtime.events.pipe(
+          Stream.runForEach((event) => Queue.offer(events, event)),
+          Effect.forkScoped,
+        );
+        const providerThread = yield* runtime.ensureThread({
+          threadId,
+          modelSelection,
+          runtimePolicy,
+        });
+        const now = yield* DateTime.now;
+        yield* runtime.startTurn(
+          makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now }),
+        );
+        const providerTurnId = idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:1",
+        });
+
+        let reportSeen = false;
+        const trackReport = (event: ProviderAdapterV2Event): void => {
+          if (
+            event.type === "turn_item.updated" &&
+            event.turnItem.type === "assistant_message" &&
+            event.turnItem.text.includes("MONITOR_REPORT_TOKEN")
+          ) {
+            reportSeen = true;
+          }
+        };
+        let hydrated = false;
+        while (!hydrated) {
+          const event = yield* Queue.take(events);
+          if (
+            event.type === "turn_item.updated" &&
+            event.turnItem.type === "command_execution" &&
+            event.turnItem.status === "completed" &&
+            (event.turnItem.output ?? "").includes("MONITOR_LISTING_TOKEN")
+          ) {
+            hydrated = true;
+          }
+        }
+        // Settled-held window: prompt returned, deferred finalize is holding for
+        // the injected report. An x.ai/task_completed ext mutation must not arm
+        // midTurnUnreported and open a wake after the report streams.
+        const applyMutation = capturedMutation.current;
+        if (applyMutation === null) {
+          return yield* Effect.die("registerExtensions must capture applyBackgroundTaskMutation");
+        }
+        yield* applyMutation({
+          sessionId: "mock-session-1",
+          taskId: "task-monitor-1",
+          status: "completed",
+        });
+        assert.lengthOf(
+          continuationRequests,
+          0,
+          "ext completion during the settled-held window must not offer mid-hold",
+        );
+
+        yield* TestClock.adjust("3 seconds");
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+        let drained = yield* Queue.poll(events);
+        while (Option.isSome(drained)) {
+          trackReport(drained.value);
+          assert.notEqual(
+            drained.value.type,
+            "turn.terminal",
+            "deferred finalize must hold while the injected-turn report is owed",
+          );
+          drained = yield* Queue.poll(events);
+        }
+
+        yield* fileSystem.writeFileString(triggerPath, "go");
+        yield* Stream.fromQueue(protocolEvents).pipe(
+          Stream.filter(
+            (event) =>
+              event.direction === "incoming" &&
+              event.stage === "raw" &&
+              typeof event.payload === "string" &&
+              event.payload.includes("MONITOR_REPORT_TOKEN"),
+          ),
+          Stream.runHead,
+        );
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+        yield* TestClock.adjust("3 seconds");
+
+        let terminalStatus: string | null = null;
+        while (terminalStatus === null) {
+          const event = yield* Queue.take(events);
+          trackReport(event);
+          if (event.type === "turn.terminal" && event.providerTurnId === providerTurnId) {
+            terminalStatus = event.status;
+          }
+        }
+        assert.equal(terminalStatus, "completed");
+        assert.isTrue(
+          reportSeen,
+          "the injected-turn report must project before the turn finalizes",
+        );
+        assert.lengthOf(
+          continuationRequests,
+          0,
+          "settle-without-report with mid-hold ext completion must not open a wake after the report streams",
+        );
+      }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect(
+    "pre-settle ext completion arm is cleared when the report precedes its end notice",
+    () =>
+      Effect.gen(function* () {
+        const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+        const fileSystem = yield* FileSystem.FileSystem;
+        const idAllocator = yield* IdAllocatorV2;
+        const path = yield* Path.Path;
+        const serverConfig = yield* ServerConfig;
+        const mockAgentPath = yield* path.fromFileUrl(
+          new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+        );
+        const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+        const continuationRequests: Array<ProviderContinuationRequest> = [];
+        type RuntimeService = AcpSessionRuntime.AcpSessionRuntime["Service"];
+        let sessionUpdateHandler: Parameters<RuntimeService["handleSessionUpdate"]>[0] | undefined;
+        const promptGate = yield* Deferred.make<EffectAcpSchema.PromptResponse>();
+        const capturedMutation: {
+          current:
+            | ((mutation: {
+                readonly sessionId: string;
+                readonly taskId: string;
+                readonly status: "running" | "completed" | "failed";
+              }) => Effect.Effect<void>)
+            | null;
+        } = { current: null };
+        const instanceId = ProviderInstanceId.make("acp-test");
+        const adapter = makeAcpAdapterV2({
+          crypto: yield* Crypto.Crypto,
+          instanceId,
+          flavor: {
+            driver: ACP_TEST_DRIVER,
+            capabilities: AcpProviderCapabilitiesV2,
+            deferFinalizeForBackgroundWork: true,
+            enablePostSettleContinuation: true,
+            extractBackgroundTaskId: (toolCall) =>
+              toolCall.toolCallId === "tool-call-monitor-1" ? "task-monitor-1" : undefined,
+            extractBackgroundToolMutation: (text) =>
+              text.includes('Monitor "task-monitor-1" ended')
+                ? [{ taskId: "task-monitor-1", status: "completed", appendOutput: "" }]
+                : [],
+            registerExtensions: (context) =>
+              Effect.sync(() => {
+                capturedMutation.current = context.applyBackgroundTaskMutation;
+              }),
+            makeRuntime: makeMockRuntime({
+              childProcessSpawner,
+              mockAgentPath,
+              environment: { T3_ACP_HANG_PROMPT_FOREVER: "1" },
+              protocolEvents,
+              wrapRuntime: (runtime) => ({
+                ...runtime,
+                handleSessionUpdate: (handler) =>
+                  Effect.sync(() => {
+                    sessionUpdateHandler = handler;
+                  }).pipe(Effect.andThen(runtime.handleSessionUpdate(handler))),
+                prompt: () => Deferred.await(promptGate),
+              }),
+            }),
+          },
+          fileSystem,
+          idAllocator,
+          serverConfig,
+          continuationRequests: {
+            offer: (request) =>
+              Effect.sync(() => {
+                continuationRequests.push(request);
+              }),
+          },
+        });
+        const threadId = ThreadId.make("thread-acp-pre-settle-arm-cleared-by-report");
+        const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          cwd: process.cwd(),
+        });
+        const modelSelection = { instanceId, model: "default" } as const;
+        const runtime = yield* adapter.openSession({
+          threadId,
+          providerSessionId: ProviderSessionId.make(
+            "provider-session-acp-pre-settle-arm-cleared-by-report",
+          ),
+          modelSelection,
+          runtimePolicy,
+        });
+        const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+        yield* runtime.events.pipe(
+          Stream.runForEach((event) => Queue.offer(events, event)),
+          Effect.forkScoped,
+        );
+        const providerThread = yield* runtime.ensureThread({
+          threadId,
+          modelSelection,
+          runtimePolicy,
+        });
+        const now = yield* DateTime.now;
+        yield* runtime
+          .startTurn(
+            makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now, ordinal: 1 }),
+          )
+          .pipe(Effect.forkScoped);
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+        assert.isDefined(sessionUpdateHandler);
+        const applyMutation = capturedMutation.current;
+        if (applyMutation === null) {
+          return yield* Effect.die("registerExtensions must capture applyBackgroundTaskMutation");
+        }
+
+        // Start a monitor mid-turn; leave it unhandled (no get_command).
+        yield* sessionUpdateHandler!({
+          sessionId: "mock-session-1",
+          update: {
+            sessionUpdate: "tool_call",
+            toolCallId: "tool-call-monitor-1",
+            title: "Monitor: pre-settle complete",
+            kind: "execute",
+            status: "pending",
+            rawInput: {},
+          },
+        });
+        yield* sessionUpdateHandler!({
+          sessionId: "mock-session-1",
+          update: {
+            sessionUpdate: "tool_call_update",
+            toolCallId: "tool-call-monitor-1",
+            status: "in_progress",
+          },
+        });
+        yield* applyMutation({
+          sessionId: "mock-session-1",
+          taskId: "task-monitor-1",
+          status: "running",
+        });
+        // Completion ext PRE-settle: arms midTurnUnreportedCompletedTaskIds.
+        yield* applyMutation({
+          sessionId: "mock-session-1",
+          taskId: "task-monitor-1",
+          status: "completed",
+        });
+        assert.lengthOf(
+          continuationRequests,
+          0,
+          "pre-settle unhandled completion must not offer while the turn is active",
+        );
+
+        // Settle without reporting. Tool stays in_progress so deferred finalize
+        // holds the turn open for the injected report.
+        yield* Deferred.succeed(promptGate, { stopReason: "end_turn" });
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+        assert.lengthOf(
+          continuationRequests,
+          0,
+          "settle must hold for deferred background work; midTurn alone must not offer mid-hold",
+        );
+
+        // The injected report can race ahead of the end notice. It must be
+        // remembered so the later notice consumes the pre-settle arm.
+        yield* sessionUpdateHandler!({
+          sessionId: "mock-session-1",
+          update: {
+            sessionUpdate: "agent_message_chunk",
+            content: { type: "text", text: "Monitor finished. MONITOR_REPORT_TOKEN" },
+          },
+        });
+        yield* sessionUpdateHandler!({
+          sessionId: "mock-session-1",
+          update: {
+            sessionUpdate: "user_message_chunk",
+            content: {
+              type: "text",
+              text: 'Monitor "task-monitor-1" ended: [monitor ended: exit 0]',
+            },
+          },
+        });
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+
+        let reportSeen = false;
+        const trackReport = (event: ProviderAdapterV2Event): void => {
+          if (
+            event.type === "turn_item.updated" &&
+            event.turnItem.type === "assistant_message" &&
+            event.turnItem.text.includes("MONITOR_REPORT_TOKEN")
+          ) {
+            reportSeen = true;
+          }
+          if (
+            event.type === "message.updated" &&
+            event.message.text.includes("MONITOR_REPORT_TOKEN")
+          ) {
+            reportSeen = true;
+          }
+        };
+        let drained = yield* Queue.poll(events);
+        while (Option.isSome(drained)) {
+          trackReport(drained.value);
+          assert.notEqual(
+            drained.value.type,
+            "turn.terminal",
+            "turn must stay open while hydration hold / quiet window remain",
+          );
+          drained = yield* Queue.poll(events);
+        }
+        assert.isTrue(reportSeen, "injected report must project into the held turn");
+
+        // Hydration safety (60s) force-completes the monitor tool, then the 3s
+        // quiet window finalizes. No TaskOutput path: that would also clear
+        // midTurn and hide the agent_message_chunk consumption site under test.
+        yield* TestClock.adjust("60 seconds");
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+        yield* TestClock.adjust("3 seconds");
+
+        const providerTurnId = idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:1",
+        });
+        let terminalStatus: string | null = null;
+        while (terminalStatus === null) {
+          const event = yield* Queue.take(events);
+          trackReport(event);
+          if (event.type === "turn.terminal" && event.providerTurnId === providerTurnId) {
+            terminalStatus = event.status;
+          }
+        }
+        assert.equal(terminalStatus, "completed");
+        assert.lengthOf(
+          continuationRequests,
+          0,
+          "pre-settle arm must be cleared when the injected report streams; no duplicate wake",
+        );
+      }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect(
+    "staggered pre-settle completion keeps midTurn marks until last background task ends post-finalize",
+    () =>
+      Effect.gen(function* () {
+        const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+        const fileSystem = yield* FileSystem.FileSystem;
+        const idAllocator = yield* IdAllocatorV2;
+        const path = yield* Path.Path;
+        const serverConfig = yield* ServerConfig;
+        const mockAgentPath = yield* path.fromFileUrl(
+          new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+        );
+        const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+        const continuationRequests: Array<ProviderContinuationRequest> = [];
+        type RuntimeService = AcpSessionRuntime.AcpSessionRuntime["Service"];
+        let sessionUpdateHandler: Parameters<RuntimeService["handleSessionUpdate"]>[0] | undefined;
+        const promptGate = yield* Deferred.make<EffectAcpSchema.PromptResponse>();
+        const capturedMutation: {
+          current:
+            | ((mutation: {
+                readonly sessionId: string;
+                readonly taskId: string;
+                readonly status: "running" | "completed" | "failed";
+              }) => Effect.Effect<void>)
+            | null;
+        } = { current: null };
+        const instanceId = ProviderInstanceId.make("acp-test");
+        const adapter = makeAcpAdapterV2({
+          crypto: yield* Crypto.Crypto,
+          instanceId,
+          flavor: {
+            driver: ACP_TEST_DRIVER,
+            capabilities: AcpProviderCapabilitiesV2,
+            enablePostSettleContinuation: true,
+            extractBackgroundTaskId: (toolCall) => {
+              if (toolCall.toolCallId === "tool-call-monitor-a") return "task-monitor-a";
+              if (toolCall.toolCallId === "tool-call-monitor-b") return "task-monitor-b";
+              return undefined;
+            },
+            extractBackgroundToolMutation: (text) => {
+              if (text.includes('Monitor "task-monitor-a" ended')) {
+                return [{ taskId: "task-monitor-a", status: "completed", appendOutput: "" }];
+              }
+              if (text.includes('Monitor "task-monitor-b" ended')) {
+                return [{ taskId: "task-monitor-b", status: "completed", appendOutput: "" }];
+              }
+              return [];
+            },
+            registerExtensions: (context) =>
+              Effect.sync(() => {
+                capturedMutation.current = context.applyBackgroundTaskMutation;
+              }),
+            makeRuntime: makeMockRuntime({
+              childProcessSpawner,
+              mockAgentPath,
+              environment: { T3_ACP_HANG_PROMPT_FOREVER: "1" },
+              protocolEvents,
+              wrapRuntime: (runtime) => ({
+                ...runtime,
+                handleSessionUpdate: (handler) =>
+                  Effect.sync(() => {
+                    sessionUpdateHandler = handler;
+                  }).pipe(Effect.andThen(runtime.handleSessionUpdate(handler))),
+                prompt: () => Deferred.await(promptGate),
+              }),
+            }),
+          },
+          fileSystem,
+          idAllocator,
+          serverConfig,
+          continuationRequests: {
+            offer: (request) =>
+              Effect.sync(() => {
+                continuationRequests.push(request);
+              }),
+          },
+        });
+        const threadId = ThreadId.make("thread-acp-staggered-midturn-keep-until-last");
+        const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          cwd: process.cwd(),
+        });
+        const modelSelection = { instanceId, model: "default" } as const;
+        const runtime = yield* adapter.openSession({
+          threadId,
+          providerSessionId: ProviderSessionId.make(
+            "provider-session-acp-staggered-midturn-keep-until-last",
+          ),
+          modelSelection,
+          runtimePolicy,
+        });
+        const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+        yield* runtime.events.pipe(
+          Stream.runForEach((event) => Queue.offer(events, event)),
+          Effect.forkScoped,
+        );
+        const providerThread = yield* runtime.ensureThread({
+          threadId,
+          modelSelection,
+          runtimePolicy,
+        });
+        const now = yield* DateTime.now;
+        yield* runtime
+          .startTurn(
+            makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now, ordinal: 1 }),
+          )
+          .pipe(Effect.forkScoped);
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+        assert.isDefined(sessionUpdateHandler);
+        const applyMutation = capturedMutation.current;
+        if (applyMutation === null) {
+          return yield* Effect.die("registerExtensions must capture applyBackgroundTaskMutation");
+        }
+
+        // Register monitors A and B in-turn; leave both unhandled.
+        for (const [toolCallId, title] of [
+          ["tool-call-monitor-a", "Monitor: staggered A"],
+          ["tool-call-monitor-b", "Monitor: staggered B"],
+        ] as const) {
+          yield* sessionUpdateHandler!({
+            sessionId: "mock-session-1",
+            update: {
+              sessionUpdate: "tool_call",
+              toolCallId,
+              title,
+              kind: "execute",
+              status: "pending",
+              rawInput: {},
+            },
+          });
+          yield* sessionUpdateHandler!({
+            sessionId: "mock-session-1",
+            update: {
+              sessionUpdate: "tool_call_update",
+              toolCallId,
+              status: "in_progress",
+            },
+          });
+        }
+        yield* applyMutation({
+          sessionId: "mock-session-1",
+          taskId: "task-monitor-a",
+          status: "running",
+        });
+        yield* applyMutation({
+          sessionId: "mock-session-1",
+          taskId: "task-monitor-b",
+          status: "running",
+        });
+        // A completes pre-settle while unhandled: arms midTurnUnreportedCompletedTaskIds.
+        yield* applyMutation({
+          sessionId: "mock-session-1",
+          taskId: "task-monitor-a",
+          status: "completed",
+        });
+        assert.lengthOf(
+          continuationRequests,
+          0,
+          "pre-settle unhandled completion must not offer while the turn is active",
+        );
+
+        // Turn settles and finalizes with B still running: no offer at finalize
+        // (running set non-empty), but marks must be kept for the later end.
+        yield* Deferred.succeed(promptGate, { stopReason: "end_turn" });
+        const providerTurnId = idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:1",
+        });
+        let terminalStatus: string | null = null;
+        while (terminalStatus === null) {
+          const event = yield* Queue.take(events);
+          if (event.type === "turn.terminal" && event.providerTurnId === providerTurnId) {
+            terminalStatus = event.status;
+          }
+        }
+        assert.equal(terminalStatus, "completed");
+        assert.lengthOf(
+          continuationRequests,
+          0,
+          "finalize must not offer while B is still running",
+        );
+
+        // B ends post-finalize via mutation-only end-notice (fails
+        // acpPostSettleWakeEvidence: extractBackgroundToolMutation matches).
+        // Without kept midTurn marks this path would neither buffer nor offer.
+        const bEndNotice = {
+          sessionId: "mock-session-1",
+          update: {
+            sessionUpdate: "user_message_chunk" as const,
+            content: {
+              type: "text" as const,
+              text: 'Monitor "task-monitor-b" ended: [monitor ended: exit 0]',
+            },
+          },
+        };
+        assert.isFalse(
+          acpPostSettleWakeEvidence(bEndNotice, {
+            extractBackgroundToolMutation: (text) =>
+              text.includes('Monitor "task-monitor-b" ended')
+                ? [{ taskId: "task-monitor-b", status: "completed", appendOutput: "" }]
+                : [],
+          }),
+          "mutation-only end-notice must not count as post-settle wake evidence",
+        );
+        yield* sessionUpdateHandler!(bEndNotice);
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+        assert.lengthOf(
+          continuationRequests,
+          1,
+          "exactly one continuation when the last running task ends post-finalize with kept midTurn marks",
+        );
+      }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect(
+    "staggered pre-settle completion does not keep midTurn marks when the turn is interrupted",
+    () =>
+      Effect.gen(function* () {
+        const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+        const fileSystem = yield* FileSystem.FileSystem;
+        const idAllocator = yield* IdAllocatorV2;
+        const path = yield* Path.Path;
+        const serverConfig = yield* ServerConfig;
+        const mockAgentPath = yield* path.fromFileUrl(
+          new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+        );
+        const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+        const continuationRequests: Array<ProviderContinuationRequest> = [];
+        type RuntimeService = AcpSessionRuntime.AcpSessionRuntime["Service"];
+        let sessionUpdateHandler: Parameters<RuntimeService["handleSessionUpdate"]>[0] | undefined;
+        const promptGate = yield* Deferred.make<EffectAcpSchema.PromptResponse>();
+        const capturedMutation: {
+          current:
+            | ((mutation: {
+                readonly sessionId: string;
+                readonly taskId: string;
+                readonly status: "running" | "completed" | "failed";
+              }) => Effect.Effect<void>)
+            | null;
+        } = { current: null };
+        const instanceId = ProviderInstanceId.make("acp-test");
+        const adapter = makeAcpAdapterV2({
+          crypto: yield* Crypto.Crypto,
+          instanceId,
+          flavor: {
+            driver: ACP_TEST_DRIVER,
+            capabilities: AcpProviderCapabilitiesV2,
+            // Hold finalize after prompt settle while monitor tools stay open so
+            // interrupt lands on the settled-soft path (cancel need not race the
+            // hang prompt).
+            deferFinalizeForBackgroundWork: true,
+            enablePostSettleContinuation: true,
+            extractBackgroundTaskId: (toolCall) => {
+              if (toolCall.toolCallId === "tool-call-monitor-a") return "task-monitor-a";
+              if (toolCall.toolCallId === "tool-call-monitor-b") return "task-monitor-b";
+              return undefined;
+            },
+            extractBackgroundToolMutation: (text) => {
+              if (text.includes('Monitor "task-monitor-a" ended')) {
+                return [{ taskId: "task-monitor-a", status: "completed", appendOutput: "" }];
+              }
+              if (text.includes('Monitor "task-monitor-b" ended')) {
+                return [{ taskId: "task-monitor-b", status: "completed", appendOutput: "" }];
+              }
+              return [];
+            },
+            registerExtensions: (context) =>
+              Effect.sync(() => {
+                capturedMutation.current = context.applyBackgroundTaskMutation;
+              }),
+            makeRuntime: makeMockRuntime({
+              childProcessSpawner,
+              mockAgentPath,
+              environment: { T3_ACP_HANG_PROMPT_FOREVER: "1" },
+              protocolEvents,
+              wrapRuntime: (runtime) => ({
+                ...runtime,
+                handleSessionUpdate: (handler) =>
+                  Effect.sync(() => {
+                    sessionUpdateHandler = handler;
+                  }).pipe(Effect.andThen(runtime.handleSessionUpdate(handler))),
+                prompt: () => Deferred.await(promptGate),
+              }),
+            }),
+          },
+          fileSystem,
+          idAllocator,
+          serverConfig,
+          continuationRequests: {
+            offer: (request) =>
+              Effect.sync(() => {
+                continuationRequests.push(request);
+              }),
+          },
+        });
+        const threadId = ThreadId.make("thread-acp-staggered-midturn-clear-on-interrupt");
+        const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          cwd: process.cwd(),
+        });
+        const modelSelection = { instanceId, model: "default" } as const;
+        const runtime = yield* adapter.openSession({
+          threadId,
+          providerSessionId: ProviderSessionId.make(
+            "provider-session-acp-staggered-midturn-clear-on-interrupt",
+          ),
+          modelSelection,
+          runtimePolicy,
+        });
+        const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+        yield* runtime.events.pipe(
+          Stream.runForEach((event) => Queue.offer(events, event)),
+          Effect.forkScoped,
+        );
+        const providerThread = yield* runtime.ensureThread({
+          threadId,
+          modelSelection,
+          runtimePolicy,
+        });
+        const now = yield* DateTime.now;
+        yield* runtime
+          .startTurn(
+            makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now, ordinal: 1 }),
+          )
+          .pipe(Effect.forkScoped);
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+        assert.isDefined(sessionUpdateHandler);
+        const applyMutation = capturedMutation.current;
+        if (applyMutation === null) {
+          return yield* Effect.die("registerExtensions must capture applyBackgroundTaskMutation");
+        }
+
+        for (const [toolCallId, title] of [
+          ["tool-call-monitor-a", "Monitor: staggered interrupt A"],
+          ["tool-call-monitor-b", "Monitor: staggered interrupt B"],
+        ] as const) {
+          yield* sessionUpdateHandler!({
+            sessionId: "mock-session-1",
+            update: {
+              sessionUpdate: "tool_call",
+              toolCallId,
+              title,
+              kind: "execute",
+              status: "pending",
+              rawInput: {},
+            },
+          });
+          yield* sessionUpdateHandler!({
+            sessionId: "mock-session-1",
+            update: {
+              sessionUpdate: "tool_call_update",
+              toolCallId,
+              status: "in_progress",
+            },
+          });
+        }
+        yield* applyMutation({
+          sessionId: "mock-session-1",
+          taskId: "task-monitor-a",
+          status: "running",
+        });
+        yield* applyMutation({
+          sessionId: "mock-session-1",
+          taskId: "task-monitor-b",
+          status: "running",
+        });
+        yield* applyMutation({
+          sessionId: "mock-session-1",
+          taskId: "task-monitor-a",
+          status: "completed",
+        });
+        assert.lengthOf(continuationRequests, 0);
+
+        // Settle while B's tool row still open: deferred finalize holds the
+        // turn. Interrupt then takes the settled-soft path.
+        yield* Deferred.succeed(promptGate, { stopReason: "end_turn" });
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+        assert.lengthOf(
+          continuationRequests,
+          0,
+          "settle must hold for deferred background tools; no mid-hold offer",
+        );
+
+        const providerTurnId = idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:1",
+        });
+        yield* runtime.interruptTurn({ providerThread, providerTurnId });
+
+        let terminalStatus: string | null = null;
+        while (terminalStatus === null) {
+          const event = yield* Queue.take(events);
+          if (event.type === "turn.terminal" && event.providerTurnId === providerTurnId) {
+            terminalStatus = event.status;
+          }
+        }
+        assert.equal(terminalStatus, "interrupted");
+        assert.lengthOf(
+          continuationRequests,
+          0,
+          "interrupted finalize must not offer a continuation",
+        );
+
+        yield* sessionUpdateHandler!({
+          sessionId: "mock-session-1",
+          update: {
+            sessionUpdate: "user_message_chunk",
+            content: {
+              type: "text",
+              text: 'Monitor "task-monitor-b" ended: [monitor ended: exit 0]',
+            },
+          },
+        });
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+        assert.lengthOf(
+          continuationRequests,
+          0,
+          "interrupted turns must clear midTurn marks; B ending post-finalize must not offer",
+        );
+      }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect(
+    "two-turn in-turn monitors never open a wake run or retain turn-1 injected-turn ack chatter",
+    () =>
+      Effect.gen(function* () {
+        const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+        const fileSystem = yield* FileSystem.FileSystem;
+        const idAllocator = yield* IdAllocatorV2;
+        const path = yield* Path.Path;
+        const serverConfig = yield* ServerConfig;
+        const mockAgentPath = yield* path.fromFileUrl(
+          new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+        );
+        const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+        const continuationRequests: Array<ProviderContinuationRequest> = [];
+        type RuntimeService = AcpSessionRuntime.AcpSessionRuntime["Service"];
+        let sessionUpdateHandler: Parameters<RuntimeService["handleSessionUpdate"]>[0] | undefined;
+        const promptGates: Array<Deferred.Deferred<EffectAcpSchema.PromptResponse, never>> = [];
+        const capturedMutation: {
+          current:
+            | ((mutation: {
+                readonly sessionId: string;
+                readonly taskId: string;
+                readonly status: "running" | "completed" | "failed";
+              }) => Effect.Effect<void>)
+            | null;
+        } = { current: null };
+        const instanceId = ProviderInstanceId.make("acp-test");
+        const adapter = makeAcpAdapterV2({
+          crypto: yield* Crypto.Crypto,
+          instanceId,
+          flavor: {
+            driver: ACP_TEST_DRIVER,
+            capabilities: AcpProviderCapabilitiesV2,
+            enablePostSettleContinuation: true,
+            extractBackgroundTaskId: (toolCall) => {
+              if (toolCall.toolCallId === "tool-call-monitor-1") return "task-monitor-1";
+              if (toolCall.toolCallId === "tool-call-monitor-2") return "task-monitor-2";
+              return undefined;
+            },
+            extractBackgroundToolMutation: (text) => {
+              if (text.includes('Monitor "task-monitor-1" ended')) {
+                return [{ taskId: "task-monitor-1", status: "completed", appendOutput: "" }];
+              }
+              if (text.includes('Monitor "task-monitor-2" ended')) {
+                return [{ taskId: "task-monitor-2", status: "completed", appendOutput: "" }];
+              }
+              return [];
+            },
+            extractBackgroundTaskCompletion: (toolCall) => {
+              if (toolCall.toolCallId === "tool-call-fetch-1") {
+                return [
+                  {
+                    taskId: "task-monitor-1",
+                    status: toolCall.status === "completed" ? "completed" : "running",
+                    appendOutput: toolCall.status === "completed" ? "MONITOR_LISTING_TOKEN" : "",
+                  },
+                ];
+              }
+              if (toolCall.toolCallId === "tool-call-fetch-2") {
+                return [
+                  {
+                    taskId: "task-monitor-2",
+                    status: toolCall.status === "completed" ? "completed" : "running",
+                    appendOutput: toolCall.status === "completed" ? "MONITOR_LISTING_TOKEN_2" : "",
+                  },
+                ];
+              }
+              return [];
+            },
+            registerExtensions: (context) =>
+              Effect.sync(() => {
+                capturedMutation.current = context.applyBackgroundTaskMutation;
+              }),
+            makeRuntime: makeMockRuntime({
+              childProcessSpawner,
+              mockAgentPath,
+              environment: { T3_ACP_HANG_PROMPT_FOREVER: "1" },
+              protocolEvents,
+              wrapRuntime: (runtime) => ({
+                ...runtime,
+                handleSessionUpdate: (handler) =>
+                  Effect.sync(() => {
+                    sessionUpdateHandler = handler;
+                  }).pipe(Effect.andThen(runtime.handleSessionUpdate(handler))),
+                prompt: () =>
+                  Effect.gen(function* () {
+                    const gate = yield* Deferred.make<EffectAcpSchema.PromptResponse>();
+                    promptGates.push(gate);
+                    return yield* Deferred.await(gate);
+                  }),
+              }),
+            }),
+          },
+          fileSystem,
+          idAllocator,
+          serverConfig,
+          continuationRequests: {
+            offer: (request) =>
+              Effect.sync(() => {
+                continuationRequests.push(request);
+              }),
+          },
+        });
+        const threadId = ThreadId.make("thread-acp-multiturn-in-turn-monitor-no-wake");
+        const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          cwd: process.cwd(),
+        });
+        const modelSelection = { instanceId, model: "default" } as const;
+        const runtime = yield* adapter.openSession({
+          threadId,
+          providerSessionId: ProviderSessionId.make(
+            "provider-session-acp-multiturn-in-turn-monitor-no-wake",
+          ),
+          modelSelection,
+          runtimePolicy,
+        });
+        if (runtime.hasPendingBackgroundWork === undefined) {
+          return yield* Effect.die(
+            "ACP runtime must expose hasPendingBackgroundWork when post-settle continuation is enabled.",
+          );
+        }
+        const hasPendingBackgroundWork = runtime.hasPendingBackgroundWork;
+        const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+        yield* runtime.events.pipe(
+          Stream.runForEach((event) => Queue.offer(events, event)),
+          Effect.forkScoped,
+        );
+        const providerThread = yield* runtime.ensureThread({
+          threadId,
+          modelSelection,
+          runtimePolicy,
+        });
+        const now = yield* DateTime.now;
+        yield* runtime
+          .startTurn(
+            makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now, ordinal: 1 }),
+          )
+          .pipe(Effect.forkScoped);
+        while (promptGates.length < 1) {
+          yield* Effect.yieldNow;
+        }
+        assert.isDefined(sessionUpdateHandler, "session update handler must be wired");
+        const applyMutation = capturedMutation.current;
+        if (applyMutation === null) {
+          return yield* Effect.die("registerExtensions must capture applyBackgroundTaskMutation");
+        }
+
+        // Turn 1: in-turn monitor + get_command hydrate + report.
+        yield* sessionUpdateHandler!({
+          sessionId: "mock-session-1",
+          update: {
+            sessionUpdate: "tool_call",
+            toolCallId: "tool-call-monitor-1",
+            title: "Monitor: first turn",
+            kind: "execute",
+            status: "pending",
+            rawInput: {},
+          },
+        });
+        yield* sessionUpdateHandler!({
+          sessionId: "mock-session-1",
+          update: {
+            sessionUpdate: "tool_call_update",
+            toolCallId: "tool-call-monitor-1",
+            status: "in_progress",
+          },
+        });
+        yield* applyMutation({
+          sessionId: "mock-session-1",
+          taskId: "task-monitor-1",
+          status: "running",
+        });
+        yield* sessionUpdateHandler!({
+          sessionId: "mock-session-1",
+          update: {
+            sessionUpdate: "tool_call",
+            toolCallId: "tool-call-fetch-1",
+            title: "get_command_or_subagent_output",
+            kind: "other",
+            status: "pending",
+            rawInput: { task_id: "task-monitor-1" },
+          },
+        });
+        yield* sessionUpdateHandler!({
+          sessionId: "mock-session-1",
+          update: {
+            sessionUpdate: "tool_call_update",
+            toolCallId: "tool-call-fetch-1",
+            status: "completed",
+            rawOutput: { output: "MONITOR_LISTING_TOKEN" },
+          },
+        });
+        yield* sessionUpdateHandler!({
+          sessionId: "mock-session-1",
+          update: {
+            sessionUpdate: "agent_message_chunk",
+            content: { type: "text", text: "Monitor listing ready in-turn." },
+          },
+        });
+        yield* applyMutation({
+          sessionId: "mock-session-1",
+          taskId: "task-monitor-1",
+          status: "completed",
+        });
+        assert.lengthOf(continuationRequests, 0);
+
+        yield* Deferred.succeed(promptGates[0]!, { stopReason: "end_turn" });
+        const firstProviderTurnId = idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:1",
+        });
+        let firstTerminal: string | null = null;
+        while (firstTerminal === null) {
+          const event = yield* Queue.take(events);
+          if (event.type === "turn.terminal" && event.providerTurnId === firstProviderTurnId) {
+            firstTerminal = event.status;
+          }
+        }
+        assert.equal(firstTerminal, "completed");
+
+        // Post-finalize injected monitor-event + ack chatter (live Grok CLI path).
+        yield* sessionUpdateHandler!({
+          sessionId: "mock-session-1",
+          update: {
+            sessionUpdate: "user_message_chunk",
+            content: {
+              type: "text",
+              text: '<monitor-event taskId="task-monitor-1">Monitor "task-monitor-1" ended</monitor-event>',
+            },
+          },
+        });
+        yield* sessionUpdateHandler!({
+          sessionId: "mock-session-1",
+          update: {
+            sessionUpdate: "agent_thought_chunk",
+            content: {
+              type: "text",
+              text: "That monitor event is the same run I already summarized.",
+            },
+          },
+        });
+        yield* sessionUpdateHandler!({
+          sessionId: "mock-session-1",
+          update: {
+            sessionUpdate: "agent_message_chunk",
+            content: {
+              type: "text",
+              text: "That monitor event is the same run I already summarized above.",
+            },
+          },
+        });
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+        assert.lengthOf(
+          continuationRequests,
+          0,
+          "turn-1 injected-turn acks must not open a continuation",
+        );
+        assert.isFalse(
+          yield* hasPendingBackgroundWork,
+          "turn-1 injected-turn ack chatter must not remain as wake buffer evidence",
+        );
+
+        // Turn 2: second in-turn monitor; mid-turn lifecycle must not wake.
+        yield* runtime
+          .startTurn(
+            makeTurnInput({
+              threadId,
+              providerThread,
+              instanceId,
+              runtimePolicy,
+              now: yield* DateTime.now,
+              ordinal: 2,
+            }),
+          )
+          .pipe(Effect.forkScoped);
+        while (promptGates.length < 2) {
+          yield* Effect.yieldNow;
+        }
+        if (sessionUpdateHandler === undefined || capturedMutation.current === null) {
+          return yield* Effect.die("extensions and session handler must be wired for turn 2");
+        }
+
+        yield* sessionUpdateHandler({
+          sessionId: "mock-session-1",
+          update: {
+            sessionUpdate: "tool_call",
+            toolCallId: "tool-call-monitor-2",
+            title: "Monitor: second turn",
+            kind: "execute",
+            status: "pending",
+            rawInput: {},
+          },
+        });
+        yield* sessionUpdateHandler({
+          sessionId: "mock-session-1",
+          update: {
+            sessionUpdate: "tool_call_update",
+            toolCallId: "tool-call-monitor-2",
+            status: "in_progress",
+          },
+        });
+        yield* capturedMutation.current({
+          sessionId: "mock-session-1",
+          taskId: "task-monitor-2",
+          status: "running",
+        });
+        yield* sessionUpdateHandler({
+          sessionId: "mock-session-1",
+          update: {
+            sessionUpdate: "tool_call",
+            toolCallId: "tool-call-fetch-2",
+            title: "get_command_or_subagent_output",
+            kind: "other",
+            status: "pending",
+            rawInput: { task_id: "task-monitor-2" },
+          },
+        });
+        yield* sessionUpdateHandler({
+          sessionId: "mock-session-1",
+          update: {
+            sessionUpdate: "tool_call_update",
+            toolCallId: "tool-call-fetch-2",
+            status: "completed",
+            rawOutput: { output: "MONITOR_LISTING_TOKEN_2" },
+          },
+        });
+        yield* sessionUpdateHandler({
+          sessionId: "mock-session-1",
+          update: {
+            sessionUpdate: "agent_message_chunk",
+            content: { type: "text", text: "Second monitor listing ready in-turn." },
+          },
+        });
+        yield* capturedMutation.current({
+          sessionId: "mock-session-1",
+          taskId: "task-monitor-2",
+          status: "completed",
+        });
+        assert.lengthOf(
+          continuationRequests,
+          0,
+          "mid-turn task_completed for an in-turn-handled monitor must not open a wake run",
+        );
+
+        yield* Deferred.succeed(promptGates[1]!, { stopReason: "end_turn" });
+        const secondProviderTurnId = idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:2",
+        });
+        let secondTerminal: string | null = null;
+        while (secondTerminal === null) {
+          const event = yield* Queue.take(events);
+          if (event.type === "turn.terminal" && event.providerTurnId === secondProviderTurnId) {
+            secondTerminal = event.status;
+          }
+        }
+        assert.equal(secondTerminal, "completed");
+        assert.lengthOf(
+          continuationRequests,
+          0,
+          "no continuation must be offered across the multiturn in-turn monitor sequence",
+        );
+        assert.isFalse(
+          yield* hasPendingBackgroundWork,
+          "wake buffer must not retain turn-1 or turn-2 in-turn-handled ack residue",
+        );
+      }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect("mid-turn completed mutation defers offer until finalize only when unhandled", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+      const continuationRequests: Array<ProviderContinuationRequest> = [];
+      type RuntimeService = AcpSessionRuntime.AcpSessionRuntime["Service"];
+      let sessionUpdateHandler: Parameters<RuntimeService["handleSessionUpdate"]>[0] | undefined;
+      const promptGates: Array<Deferred.Deferred<EffectAcpSchema.PromptResponse, never>> = [];
+      const capturedMutation: {
+        current:
+          | ((mutation: {
+              readonly sessionId: string;
+              readonly taskId: string;
+              readonly status: "running" | "completed" | "failed";
+            }) => Effect.Effect<void>)
+          | null;
+      } = { current: null };
+      const instanceId = ProviderInstanceId.make("acp-test");
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          enablePostSettleContinuation: true,
+          extractBackgroundTaskId: (toolCall) =>
+            toolCall.toolCallId === "tool-call-monitor-unhandled"
+              ? "task-monitor-unhandled"
+              : toolCall.toolCallId === "tool-call-monitor-handled"
+                ? "task-monitor-handled"
+                : undefined,
+          extractBackgroundTaskCompletion: (toolCall) =>
+            toolCall.toolCallId === "tool-call-fetch-handled"
+              ? [
+                  {
+                    taskId: "task-monitor-handled",
+                    status: toolCall.status === "completed" ? "completed" : "running",
+                    appendOutput: toolCall.status === "completed" ? "HANDLED_LISTING" : "",
+                  },
+                ]
+              : [],
+          registerExtensions: (context) =>
+            Effect.sync(() => {
+              capturedMutation.current = context.applyBackgroundTaskMutation;
+            }),
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            mockAgentPath,
+            environment: { T3_ACP_HANG_PROMPT_FOREVER: "1" },
+            protocolEvents,
+            wrapRuntime: (runtime) => ({
+              ...runtime,
+              handleSessionUpdate: (handler) =>
+                Effect.sync(() => {
+                  sessionUpdateHandler = handler;
+                }).pipe(Effect.andThen(runtime.handleSessionUpdate(handler))),
+              prompt: () =>
+                Effect.gen(function* () {
+                  const gate = yield* Deferred.make<EffectAcpSchema.PromptResponse>();
+                  promptGates.push(gate);
+                  return yield* Deferred.await(gate);
+                }),
+            }),
+          }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+        continuationRequests: {
+          offer: (request) =>
+            Effect.sync(() => {
+              continuationRequests.push(request);
+            }),
+        },
+      });
+      const threadId = ThreadId.make("thread-acp-mid-turn-dirty-wake-buffer");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make(
+          "provider-session-acp-mid-turn-dirty-wake-buffer",
+        ),
+        modelSelection,
+        runtimePolicy,
+      });
+      if (runtime.hasPendingBackgroundWork === undefined) {
+        return yield* Effect.die(
+          "ACP runtime must expose hasPendingBackgroundWork when post-settle continuation is enabled.",
+        );
+      }
+      const hasPendingBackgroundWork = runtime.hasPendingBackgroundWork;
+      const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+      yield* runtime.events.pipe(
+        Stream.runForEach((event) => Queue.offer(events, event)),
+        Effect.forkScoped,
+      );
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      const now = yield* DateTime.now;
+      // Seed turn: complete promptly, then dirty the wake buffer with a
+      // thought-only frame (buffers, no offer).
+      yield* runtime
+        .startTurn(
+          makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now, ordinal: 1 }),
+        )
+        .pipe(Effect.forkScoped);
+      while (promptGates.length < 1) {
+        yield* Effect.yieldNow;
+      }
+      yield* Deferred.succeed(promptGates[0]!, { stopReason: "end_turn" });
+      const firstProviderTurnId = idAllocator.derive.providerTurn({
+        driver: ACP_TEST_DRIVER,
+        nativeTurnId: "mock-session-1:turn:1",
+      });
+      let firstTerminal: string | null = null;
+      while (firstTerminal === null) {
+        const event = yield* Queue.take(events);
+        if (event.type === "turn.terminal" && event.providerTurnId === firstProviderTurnId) {
+          firstTerminal = event.status;
+        }
+      }
+      assert.equal(firstTerminal, "completed");
+      assert.isDefined(sessionUpdateHandler);
+      yield* sessionUpdateHandler!({
+        sessionId: "mock-session-1",
+        update: {
+          sessionUpdate: "agent_thought_chunk",
+          content: { type: "text", text: "stale wake residue from prior turn" },
+        },
+      });
+      assert.isTrue(yield* hasPendingBackgroundWork, "thought residue must dirty the wake buffer");
+      assert.lengthOf(continuationRequests, 0);
+
+      // Active un-finalized turn 2: user-turn start clears prior residue.
+      yield* runtime
+        .startTurn(
+          makeTurnInput({
+            threadId,
+            providerThread,
+            instanceId,
+            runtimePolicy,
+            now: yield* DateTime.now,
+            ordinal: 2,
+          }),
+        )
+        .pipe(Effect.forkScoped);
+      while (promptGates.length < 2) {
+        yield* Effect.yieldNow;
+      }
+      assert.isFalse(
+        yield* hasPendingBackgroundWork,
+        "user-turn start must drop prior-turn wake residue",
+      );
+      const applyMutation = capturedMutation.current;
+      if (applyMutation === null || sessionUpdateHandler === undefined) {
+        return yield* Effect.die("extensions and session handler must be wired for turn 2");
+      }
+
+      // Unhandled monitor: mid-turn complete must not offer while active.
+      yield* sessionUpdateHandler({
+        sessionId: "mock-session-1",
+        update: {
+          sessionUpdate: "tool_call",
+          toolCallId: "tool-call-monitor-unhandled",
+          title: "Monitor: unhandled",
+          kind: "execute",
+          status: "pending",
+          rawInput: {},
+        },
+      });
+      yield* sessionUpdateHandler({
+        sessionId: "mock-session-1",
+        update: {
+          sessionUpdate: "tool_call_update",
+          toolCallId: "tool-call-monitor-unhandled",
+          status: "in_progress",
+        },
+      });
+      yield* applyMutation({
+        sessionId: "mock-session-1",
+        taskId: "task-monitor-unhandled",
+        status: "running",
+      });
+      // Re-seed dirty wakeBuffer while the turn is still active by routing a
+      // post-settle-style frame is impossible (active context). Defect B is
+      // covered by the mid-turn unreported set: completion lands mid-turn
+      // with empty buffer and must still not offer until finalize.
+      yield* applyMutation({
+        sessionId: "mock-session-1",
+        taskId: "task-monitor-unhandled",
+        status: "completed",
+      });
+      assert.lengthOf(
+        continuationRequests,
+        0,
+        "mid-turn completed mutation must not offer while the root turn is active",
+      );
+
+      yield* Deferred.succeed(promptGates[1]!, { stopReason: "end_turn" });
+      const secondProviderTurnId = idAllocator.derive.providerTurn({
+        driver: ACP_TEST_DRIVER,
+        nativeTurnId: "mock-session-1:turn:2",
+      });
+      let secondTerminal: string | null = null;
+      while (secondTerminal === null) {
+        const event = yield* Queue.take(events);
+        if (event.type === "turn.terminal" && event.providerTurnId === secondProviderTurnId) {
+          secondTerminal = event.status;
+        }
+      }
+      assert.equal(secondTerminal, "completed");
+      assert.lengthOf(
+        continuationRequests,
+        1,
+        "post-finalize must offer when mid-turn completion was never handled in-turn",
+      );
+
+      // Third turn: hydrate in-turn before lifecycle complete; no offer.
+      const firstOffer = continuationRequests[0]!;
+      if (firstOffer.clearIfCurrent !== undefined) {
+        yield* firstOffer.clearIfCurrent();
+      }
+      continuationRequests.length = 0;
+      yield* runtime
+        .startTurn(
+          makeTurnInput({
+            threadId,
+            providerThread,
+            instanceId,
+            runtimePolicy,
+            now: yield* DateTime.now,
+            ordinal: 3,
+          }),
+        )
+        .pipe(Effect.forkScoped);
+      while (promptGates.length < 3) {
+        yield* Effect.yieldNow;
+      }
+      if (sessionUpdateHandler === undefined || capturedMutation.current === null) {
+        return yield* Effect.die("handler must remain wired for turn 3");
+      }
+      yield* sessionUpdateHandler({
+        sessionId: "mock-session-1",
+        update: {
+          sessionUpdate: "tool_call",
+          toolCallId: "tool-call-monitor-handled",
+          title: "Monitor: handled",
+          kind: "execute",
+          status: "pending",
+          rawInput: {},
+        },
+      });
+      yield* sessionUpdateHandler({
+        sessionId: "mock-session-1",
+        update: {
+          sessionUpdate: "tool_call_update",
+          toolCallId: "tool-call-monitor-handled",
+          status: "in_progress",
+        },
+      });
+      yield* capturedMutation.current({
+        sessionId: "mock-session-1",
+        taskId: "task-monitor-handled",
+        status: "running",
+      });
+      yield* sessionUpdateHandler({
+        sessionId: "mock-session-1",
+        update: {
+          sessionUpdate: "tool_call",
+          toolCallId: "tool-call-fetch-handled",
+          title: "get_command_or_subagent_output",
+          kind: "other",
+          status: "pending",
+          rawInput: {},
+        },
+      });
+      yield* sessionUpdateHandler({
+        sessionId: "mock-session-1",
+        update: {
+          sessionUpdate: "tool_call_update",
+          toolCallId: "tool-call-fetch-handled",
+          status: "completed",
+          rawOutput: { output: "HANDLED_LISTING" },
+        },
+      });
+      yield* capturedMutation.current({
+        sessionId: "mock-session-1",
+        taskId: "task-monitor-handled",
+        status: "completed",
+      });
+      assert.lengthOf(continuationRequests, 0, "handled mid-turn completion must not offer");
+      yield* Deferred.succeed(promptGates[2]!, { stopReason: "end_turn" });
+      const thirdProviderTurnId = idAllocator.derive.providerTurn({
+        driver: ACP_TEST_DRIVER,
+        nativeTurnId: "mock-session-1:turn:3",
+      });
+      let thirdTerminal: string | null = null;
+      while (thirdTerminal === null) {
+        const event = yield* Queue.take(events);
+        if (event.type === "turn.terminal" && event.providerTurnId === thirdProviderTurnId) {
+          thirdTerminal = event.status;
+        }
+      }
+      assert.equal(thirdTerminal, "completed");
+      assert.lengthOf(
+        continuationRequests,
+        0,
+        "post-finalize must not offer when the mid-turn completion was handled in-turn",
+      );
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect(
+    "mid-turn unhandled background completion still offers exactly one continuation after finalize",
+    () =>
+      Effect.gen(function* () {
+        const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+        const fileSystem = yield* FileSystem.FileSystem;
+        const idAllocator = yield* IdAllocatorV2;
+        const path = yield* Path.Path;
+        const serverConfig = yield* ServerConfig;
+        const mockAgentPath = yield* path.fromFileUrl(
+          new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+        );
+        const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+        const continuationRequests: Array<ProviderContinuationRequest> = [];
+        type RuntimeService = AcpSessionRuntime.AcpSessionRuntime["Service"];
+        let sessionUpdateHandler: Parameters<RuntimeService["handleSessionUpdate"]>[0] | undefined;
+        const promptGate = yield* Deferred.make<EffectAcpSchema.PromptResponse>();
+        const capturedMutation: {
+          current:
+            | ((mutation: {
+                readonly sessionId: string;
+                readonly taskId: string;
+                readonly status: "running" | "completed" | "failed";
+              }) => Effect.Effect<void>)
+            | null;
+        } = { current: null };
+        const instanceId = ProviderInstanceId.make("acp-test");
+        const adapter = makeAcpAdapterV2({
+          crypto: yield* Crypto.Crypto,
+          instanceId,
+          flavor: {
+            driver: ACP_TEST_DRIVER,
+            capabilities: AcpProviderCapabilitiesV2,
+            enablePostSettleContinuation: true,
+            extractBackgroundTaskId: (toolCall) =>
+              toolCall.toolCallId === "tool-call-monitor-late" ? "task-monitor-late" : undefined,
+            registerExtensions: (context) =>
+              Effect.sync(() => {
+                capturedMutation.current = context.applyBackgroundTaskMutation;
+              }),
+            makeRuntime: makeMockRuntime({
+              childProcessSpawner,
+              mockAgentPath,
+              environment: { T3_ACP_HANG_PROMPT_FOREVER: "1" },
+              protocolEvents,
+              wrapRuntime: (runtime) => ({
+                ...runtime,
+                handleSessionUpdate: (handler) =>
+                  Effect.sync(() => {
+                    sessionUpdateHandler = handler;
+                  }).pipe(Effect.andThen(runtime.handleSessionUpdate(handler))),
+                prompt: () => Deferred.await(promptGate),
+              }),
+            }),
+          },
+          fileSystem,
+          idAllocator,
+          serverConfig,
+          continuationRequests: {
+            offer: (request) =>
+              Effect.sync(() => {
+                continuationRequests.push(request);
+              }),
+          },
+        });
+        const threadId = ThreadId.make("thread-acp-mid-turn-unhandled-offers-after-finalize");
+        const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          cwd: process.cwd(),
+        });
+        const modelSelection = { instanceId, model: "default" } as const;
+        const runtime = yield* adapter.openSession({
+          threadId,
+          providerSessionId: ProviderSessionId.make(
+            "provider-session-acp-mid-turn-unhandled-offers-after-finalize",
+          ),
+          modelSelection,
+          runtimePolicy,
+        });
+        const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+        yield* runtime.events.pipe(
+          Stream.runForEach((event) => Queue.offer(events, event)),
+          Effect.forkScoped,
+        );
+        const providerThread = yield* runtime.ensureThread({
+          threadId,
+          modelSelection,
+          runtimePolicy,
+        });
+        const now = yield* DateTime.now;
+        yield* runtime
+          .startTurn(
+            makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now, ordinal: 1 }),
+          )
+          .pipe(Effect.forkScoped);
+        // Wait until the wrapped prompt is awaiting the gate.
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+        assert.isDefined(sessionUpdateHandler);
+        const applyMutation = capturedMutation.current;
+        if (applyMutation === null) {
+          return yield* Effect.die("registerExtensions must capture applyBackgroundTaskMutation");
+        }
+
+        // Start a monitor mid-turn; do not hydrate via get_command (unhandled).
+        yield* sessionUpdateHandler!({
+          sessionId: "mock-session-1",
+          update: {
+            sessionUpdate: "tool_call",
+            toolCallId: "tool-call-monitor-late",
+            title: "Monitor: late complete",
+            kind: "execute",
+            status: "pending",
+            rawInput: {},
+          },
+        });
+        yield* sessionUpdateHandler!({
+          sessionId: "mock-session-1",
+          update: {
+            sessionUpdate: "tool_call_update",
+            toolCallId: "tool-call-monitor-late",
+            status: "in_progress",
+          },
+        });
+        yield* applyMutation({
+          sessionId: "mock-session-1",
+          taskId: "task-monitor-late",
+          status: "running",
+        });
+        yield* applyMutation({
+          sessionId: "mock-session-1",
+          taskId: "task-monitor-late",
+          status: "completed",
+        });
+        assert.lengthOf(
+          continuationRequests,
+          0,
+          "mid-turn unhandled completion must not offer while the turn is active",
+        );
+
+        yield* Deferred.succeed(promptGate, { stopReason: "end_turn" });
+        const providerTurnId = idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:1",
+        });
+        let terminalStatus: string | null = null;
+        while (terminalStatus === null) {
+          const event = yield* Queue.take(events);
+          if (event.type === "turn.terminal" && event.providerTurnId === providerTurnId) {
+            terminalStatus = event.status;
+          }
+        }
+        assert.equal(terminalStatus, "completed");
+        assert.lengthOf(
+          continuationRequests,
+          1,
+          "exactly one continuation must be offered after finalize for mid-turn unhandled completion",
+        );
+        const beforeWhitespace = yield* runtime.readThreadSnapshot({ providerThread });
+        yield* Queue.clear(events);
+        yield* sessionUpdateHandler!({
+          sessionId: "mock-session-1",
+          update: {
+            sessionUpdate: "agent_message_chunk",
+            content: { type: "text", text: " \n\t " },
+          },
+        });
+        const lateEvents: Array<ProviderAdapterV2Event> = [];
+        let lateEvent = yield* Queue.poll(events);
+        while (Option.isSome(lateEvent)) {
+          lateEvents.push(lateEvent.value);
+          lateEvent = yield* Queue.poll(events);
+        }
+        assert.isFalse(
+          lateEvents.some((event) => event.type === "message.updated"),
+          "whitespace-only late chunks must not append assistant history",
+        );
+        const afterWhitespace = yield* runtime.readThreadSnapshot({ providerThread });
+        assert.deepEqual(
+          afterWhitespace.messages,
+          beforeWhitespace.messages,
+          "whitespace-only late chunks must not mutate the loaded history snapshot",
+        );
+      }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect("empty-drain continuation turn waits the quiet window so late frames can attach", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+      const continuationRequests: Array<ProviderContinuationRequest> = [];
+      type RuntimeService = AcpSessionRuntime.AcpSessionRuntime["Service"];
+      let sessionUpdateHandler: Parameters<RuntimeService["handleSessionUpdate"]>[0] | undefined;
+      const promptGate = yield* Deferred.make<EffectAcpSchema.PromptResponse>();
+      const capturedMutation: {
+        current:
+          | ((mutation: {
+              readonly sessionId: string;
+              readonly taskId: string;
+              readonly status: "running" | "completed" | "failed";
+            }) => Effect.Effect<void>)
+          | null;
+      } = { current: null };
+      const instanceId = ProviderInstanceId.make("acp-test");
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          // Quiet window on empty-drain continuation; persistent so the root
+          // monitor does not pin deferred finalize after mid-turn complete.
+          deferFinalizeForBackgroundWork: true,
+          enablePostSettleContinuation: true,
+          extractBackgroundTaskId: (toolCall) =>
+            toolCall.toolCallId === "tool-call-monitor-late" ? "task-monitor-late" : undefined,
+          isPersistentBackgroundTool: () => true,
+          registerExtensions: (context) =>
+            Effect.sync(() => {
+              capturedMutation.current = context.applyBackgroundTaskMutation;
+            }),
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            mockAgentPath,
+            environment: { T3_ACP_HANG_PROMPT_FOREVER: "1" },
+            protocolEvents,
+            wrapRuntime: (runtime) => ({
+              ...runtime,
+              handleSessionUpdate: (handler) =>
+                Effect.sync(() => {
+                  sessionUpdateHandler = handler;
+                }).pipe(Effect.andThen(runtime.handleSessionUpdate(handler))),
+              prompt: () => Deferred.await(promptGate),
+            }),
+          }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+        continuationRequests: {
+          offer: (request) =>
+            Effect.sync(() => {
+              continuationRequests.push(request);
+            }),
+        },
+      });
+      const threadId = ThreadId.make("thread-acp-empty-drain-continuation-quiet");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make(
+          "provider-session-acp-empty-drain-continuation-quiet",
+        ),
+        modelSelection,
+        runtimePolicy,
+      });
+      const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+      yield* runtime.events.pipe(
+        Stream.runForEach((event) => Queue.offer(events, event)),
+        Effect.forkScoped,
+      );
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      const now = yield* DateTime.now;
+      yield* runtime
+        .startTurn(
+          makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now, ordinal: 1 }),
+        )
+        .pipe(Effect.forkScoped);
+      yield* Effect.yieldNow;
+      yield* Effect.yieldNow;
+      assert.isDefined(sessionUpdateHandler);
+      const applyMutation = capturedMutation.current;
+      if (applyMutation === null) {
+        return yield* Effect.die("registerExtensions must capture applyBackgroundTaskMutation");
+      }
+
+      // Mid-turn unhandled completion arms midTurn and offers after finalize
+      // with an empty wakeBuffer (midTurn-only offer).
+      yield* sessionUpdateHandler!({
+        sessionId: "mock-session-1",
+        update: {
+          sessionUpdate: "tool_call",
+          toolCallId: "tool-call-monitor-late",
+          title: "Monitor: late complete",
+          kind: "execute",
+          status: "pending",
+          rawInput: {},
+        },
+      });
+      yield* sessionUpdateHandler!({
+        sessionId: "mock-session-1",
+        update: {
+          sessionUpdate: "tool_call_update",
+          toolCallId: "tool-call-monitor-late",
+          status: "in_progress",
+        },
+      });
+      yield* applyMutation({
+        sessionId: "mock-session-1",
+        taskId: "task-monitor-late",
+        status: "running",
+      });
+      yield* applyMutation({
+        sessionId: "mock-session-1",
+        taskId: "task-monitor-late",
+        status: "completed",
+      });
+      yield* Deferred.succeed(promptGate, { stopReason: "end_turn" });
+      const rootProviderTurnId = idAllocator.derive.providerTurn({
+        driver: ACP_TEST_DRIVER,
+        nativeTurnId: "mock-session-1:turn:1",
+      });
+      let rootTerminal: string | null = null;
+      while (rootTerminal === null) {
+        const event = yield* Queue.take(events);
+        if (event.type === "turn.terminal" && event.providerTurnId === rootProviderTurnId) {
+          rootTerminal = event.status;
+        }
+      }
+      assert.equal(rootTerminal, "completed");
+      assert.lengthOf(continuationRequests, 1, "midTurn-only evidence must offer one continuation");
+
+      // Continuation attach with empty wakeBuffer: must schedule the quiet
+      // window rather than finalizing immediately blank.
+      const rootInput = makeTurnInput({
+        threadId,
+        providerThread,
+        instanceId,
+        runtimePolicy,
+        now: yield* DateTime.now,
+        ordinal: 2,
+      });
+      yield* runtime
+        .startTurn({
+          ...rootInput,
+          message: {
+            ...rootInput.message,
+            createdBy: "agent",
+            creationSource: "provider",
+            text: "Background task completed.",
+          },
+        })
+        .pipe(Effect.forkScoped);
+      yield* Effect.yieldNow;
+      yield* Effect.yieldNow;
+      yield* Effect.yieldNow;
+
+      const continuationProviderTurnId = idAllocator.derive.providerTurn({
+        driver: ACP_TEST_DRIVER,
+        nativeTurnId: "mock-session-1:turn:2",
+      });
+      // Still open: no terminal yet (quiet window).
+      let polled = yield* Queue.poll(events);
+      while (Option.isSome(polled)) {
+        assert.notEqual(
+          polled.value.type === "turn.terminal" &&
+            polled.value.providerTurnId === continuationProviderTurnId
+            ? "turn.terminal"
+            : "",
+          "turn.terminal",
+          "empty-drain continuation must not finalize immediately",
+        );
+        polled = yield* Queue.poll(events);
+      }
+
+      // Late wake frame during the quiet window attaches to this run.
+      assert.isDefined(sessionUpdateHandler);
+      yield* sessionUpdateHandler!({
+        sessionId: "mock-session-1",
+        update: {
+          sessionUpdate: "agent_message_chunk",
+          content: { type: "text", text: "LATE_WAKE_FRAME_TOKEN" },
+        },
+      });
+      yield* Effect.yieldNow;
+      yield* Effect.yieldNow;
+
+      // Partial advance keeps the window open; full 3s after rearm finalizes.
+      yield* TestClock.adjust("1 second");
+      yield* Effect.yieldNow;
+      polled = yield* Queue.poll(events);
+      let lateFrameSeen = false;
+      while (Option.isSome(polled)) {
+        if (
+          polled.value.type === "turn_item.updated" &&
+          polled.value.turnItem.type === "assistant_message" &&
+          polled.value.turnItem.text.includes("LATE_WAKE_FRAME_TOKEN")
+        ) {
+          lateFrameSeen = true;
+        }
+        if (
+          polled.value.type === "turn.terminal" &&
+          polled.value.providerTurnId === continuationProviderTurnId
+        ) {
+          assert.fail("continuation must not finalize before the quiet window elapses");
+        }
+        polled = yield* Queue.poll(events);
+      }
+      assert.isTrue(lateFrameSeen, "late wake frame must attach to the continuation run");
+
+      yield* TestClock.adjust("3 seconds");
+      let continuationTerminal: string | null = null;
+      while (continuationTerminal === null) {
+        const event = yield* Queue.take(events);
+        if (event.type === "turn.terminal" && event.providerTurnId === continuationProviderTurnId) {
+          continuationTerminal = event.status;
+        }
+      }
+      assert.equal(continuationTerminal, "completed");
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect("empty-drain continuation turn finalizes after the quiet window with no frames", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+      const continuationRequests: Array<ProviderContinuationRequest> = [];
+      type RuntimeService = AcpSessionRuntime.AcpSessionRuntime["Service"];
+      let sessionUpdateHandler: Parameters<RuntimeService["handleSessionUpdate"]>[0] | undefined;
+      const promptGate = yield* Deferred.make<EffectAcpSchema.PromptResponse>();
+      const capturedMutation: {
+        current:
+          | ((mutation: {
+              readonly sessionId: string;
+              readonly taskId: string;
+              readonly status: "running" | "completed" | "failed";
+            }) => Effect.Effect<void>)
+          | null;
+      } = { current: null };
+      const instanceId = ProviderInstanceId.make("acp-test");
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          deferFinalizeForBackgroundWork: true,
+          enablePostSettleContinuation: true,
+          extractBackgroundTaskId: (toolCall) =>
+            toolCall.toolCallId === "tool-call-monitor-late" ? "task-monitor-late" : undefined,
+          isPersistentBackgroundTool: () => true,
+          registerExtensions: (context) =>
+            Effect.sync(() => {
+              capturedMutation.current = context.applyBackgroundTaskMutation;
+            }),
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            mockAgentPath,
+            environment: { T3_ACP_HANG_PROMPT_FOREVER: "1" },
+            protocolEvents,
+            wrapRuntime: (runtime) => ({
+              ...runtime,
+              handleSessionUpdate: (handler) =>
+                Effect.sync(() => {
+                  sessionUpdateHandler = handler;
+                }).pipe(Effect.andThen(runtime.handleSessionUpdate(handler))),
+              prompt: () => Deferred.await(promptGate),
+            }),
+          }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+        continuationRequests: {
+          offer: (request) =>
+            Effect.sync(() => {
+              continuationRequests.push(request);
+            }),
+        },
+      });
+      const threadId = ThreadId.make("thread-acp-empty-drain-continuation-no-wedge");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make(
+          "provider-session-acp-empty-drain-continuation-no-wedge",
+        ),
+        modelSelection,
+        runtimePolicy,
+      });
+      const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+      yield* runtime.events.pipe(
+        Stream.runForEach((event) => Queue.offer(events, event)),
+        Effect.forkScoped,
+      );
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      const now = yield* DateTime.now;
+      yield* runtime
+        .startTurn(
+          makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now, ordinal: 1 }),
+        )
+        .pipe(Effect.forkScoped);
+      yield* Effect.yieldNow;
+      yield* Effect.yieldNow;
+      assert.isDefined(sessionUpdateHandler);
+      const applyMutation = capturedMutation.current;
+      if (applyMutation === null) {
+        return yield* Effect.die("registerExtensions must capture applyBackgroundTaskMutation");
+      }
+
+      yield* sessionUpdateHandler!({
+        sessionId: "mock-session-1",
+        update: {
+          sessionUpdate: "tool_call",
+          toolCallId: "tool-call-monitor-late",
+          title: "Monitor: late complete",
+          kind: "execute",
+          status: "pending",
+          rawInput: {},
+        },
+      });
+      yield* sessionUpdateHandler!({
+        sessionId: "mock-session-1",
+        update: {
+          sessionUpdate: "tool_call_update",
+          toolCallId: "tool-call-monitor-late",
+          status: "in_progress",
+        },
+      });
+      yield* applyMutation({
+        sessionId: "mock-session-1",
+        taskId: "task-monitor-late",
+        status: "running",
+      });
+      yield* applyMutation({
+        sessionId: "mock-session-1",
+        taskId: "task-monitor-late",
+        status: "completed",
+      });
+      yield* Deferred.succeed(promptGate, { stopReason: "end_turn" });
+      const rootProviderTurnId = idAllocator.derive.providerTurn({
+        driver: ACP_TEST_DRIVER,
+        nativeTurnId: "mock-session-1:turn:1",
+      });
+      let rootTerminal: string | null = null;
+      while (rootTerminal === null) {
+        const event = yield* Queue.take(events);
+        if (event.type === "turn.terminal" && event.providerTurnId === rootProviderTurnId) {
+          rootTerminal = event.status;
+        }
+      }
+      assert.equal(rootTerminal, "completed");
+      assert.lengthOf(continuationRequests, 1);
+
+      const rootInput = makeTurnInput({
+        threadId,
+        providerThread,
+        instanceId,
+        runtimePolicy,
+        now: yield* DateTime.now,
+        ordinal: 2,
+      });
+      yield* runtime
+        .startTurn({
+          ...rootInput,
+          message: {
+            ...rootInput.message,
+            createdBy: "agent",
+            creationSource: "provider",
+            text: "Background task completed.",
+          },
+        })
+        .pipe(Effect.forkScoped);
+      yield* Effect.yieldNow;
+      yield* Effect.yieldNow;
+      yield* Effect.yieldNow;
+
+      const continuationProviderTurnId = idAllocator.derive.providerTurn({
+        driver: ACP_TEST_DRIVER,
+        nativeTurnId: "mock-session-1:turn:2",
+      });
+      // No frames: quiet window must still finalize (no wedge).
+      yield* TestClock.adjust("3 seconds");
+      let continuationTerminal: string | null = null;
+      while (continuationTerminal === null) {
+        const event = yield* Queue.take(events);
+        if (event.type === "turn.terminal" && event.providerTurnId === continuationProviderTurnId) {
+          continuationTerminal = event.status;
+        }
+      }
+      assert.equal(continuationTerminal, "completed");
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect("restarts the ACP child process before the next prompt after interrupt", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+      const instanceId = ProviderInstanceId.make("acp-test");
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          restartRuntimeAfterInterrupt: true,
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            mockAgentPath,
+            protocolEvents,
+          }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+      });
+      const threadId = ThreadId.make("thread-acp-restart-after-interrupt");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make("provider-session-acp-restart-after-interrupt"),
+        modelSelection,
+        runtimePolicy,
+      });
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      const now = yield* DateTime.now;
+      yield* runtime.startTurn(
+        makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now, ordinal: 1 }),
+      );
+      yield* Stream.fromQueue(protocolEvents).pipe(
+        Stream.filter(
+          (event) =>
+            event.direction === "outgoing" && rawProtocolMethod(event) === "session/prompt",
+        ),
+        Stream.runHead,
+      );
+      const providerTurnId = idAllocator.derive.providerTurn({
+        driver: ACP_TEST_DRIVER,
+        nativeTurnId: `${providerThread.nativeThreadRef?.nativeId}:turn:1`,
+      });
+      yield* runtime.interruptTurn({
+        providerThread,
+        providerTurnId,
+        requestRuntimeRestart: true,
+      });
+      yield* Stream.fromQueue(protocolEvents).pipe(
+        Stream.filter(
+          (event) =>
+            event.direction === "outgoing" && rawProtocolMethod(event) === "session/cancel",
+        ),
+        Stream.runHead,
+      );
+
+      yield* runtime.startTurn(
+        makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now, ordinal: 2 }),
+      );
+      const loadAfterRestart = yield* Stream.fromQueue(protocolEvents).pipe(
+        Stream.filter(
+          (event) => event.direction === "outgoing" && rawProtocolMethod(event) === "session/load",
+        ),
+        Stream.runHead,
+      );
+      assert.isTrue(
+        Option.isSome(loadAfterRestart),
+        "post-interrupt startTurn should respawn the runtime and replay session/load",
+      );
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect("Windows teardown is one-shot explicitly with independent finalizer cleanup", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const path = yield* Path.Path;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const runtimeScope = yield* Scope.make();
+      const taskkillCommands: Array<{
+        readonly command: string;
+        readonly args: ReadonlyArray<string>;
+      }> = [];
+      const taskkillSpawner = makeTaskkillSpawner({ exitCode: 0, commands: taskkillCommands });
+      const spawner = ChildProcessSpawner.make((command) => {
+        const value = command as unknown as { readonly command: string };
+        return value.command === "taskkill"
+          ? taskkillSpawner.spawn(command)
+          : childProcessSpawner.spawn(command);
+      });
+      const context = yield* Layer.build(
+        AcpSessionRuntime.layer({
+          spawn: {
+            command: process.execPath,
+            args: [mockAgentPath],
+            cwd: process.cwd(),
+            env: { T3_ACP_SESSION_LIFECYCLE: "1" },
+          },
+          cwd: process.cwd(),
+          clientInfo: { name: "t3-acp-test", version: "0.0.0" },
+          ownDetachedProcessGroup: true,
+          processGroupPlatform: "win32",
+        }).pipe(Layer.provide(Layer.succeed(ChildProcessSpawner.ChildProcessSpawner, spawner))),
+      ).pipe(Effect.provideService(Scope.Scope, runtimeScope));
+      const runtime = yield* Effect.service(AcpSessionRuntime.AcpSessionRuntime).pipe(
+        Effect.provide(context),
+      );
+      assert.isDefined(runtime.terminateProcessGroup);
+      yield* Effect.all([runtime.terminateProcessGroup!, runtime.terminateProcessGroup!], {
+        concurrency: "unbounded",
+      });
+      assert.equal(taskkillCommands.length, 1);
+      yield* Scope.close(runtimeScope, Exit.void);
+      assert.equal(taskkillCommands.length, 1);
+    }).pipe(Effect.provide(testLayer)),
+  );
+
+  it("accepts only taskkill exit code zero as successful tree termination", () => {
+    assert.isTrue(AcpSessionRuntime.windowsTaskkillResultIsSuccess(0, ""));
+    assert.isFalse(
+      AcpSessionRuntime.windowsTaskkillResultIsSuccess(
+        128,
+        "FEHLER: Der Prozess wurde nicht gefunden.",
+      ),
+    );
+    assert.isFalse(AcpSessionRuntime.windowsTaskkillResultIsSuccess(128, ""));
+    assert.isFalse(AcpSessionRuntime.windowsTaskkillResultIsSuccess(1, "localized failure"));
+    assert.isFalse(AcpSessionRuntime.windowsTaskkillResultIsSuccess(255, ""));
+  });
+
+  it.effect("runs the default taskkill path and preserves every failure mode", () =>
+    Effect.gen(function* () {
+      const commands: Array<{ readonly command: string; readonly args: ReadonlyArray<string> }> =
+        [];
+      yield* AcpSessionRuntime.terminateWindowsProcessTreeWithTaskkill(
+        makeTaskkillSpawner({ exitCode: 0, commands }),
+        4321,
+      );
+      assert.deepEqual(commands, [{ command: "taskkill", args: ["/PID", "4321", "/T", "/F"] }]);
+
+      for (const fixture of [
+        { exitCode: 128, output: 'ERROR: The process "4321" not found.' },
+        { exitCode: 128, output: "FEHLER: Prozess nicht gefunden." },
+        { exitCode: 128, output: "" },
+        { exitCode: 128, output: "ERROR: Access is denied." },
+        { exitCode: 1, output: "generic failure" },
+      ]) {
+        const failed = yield* AcpSessionRuntime.terminateWindowsProcessTreeWithTaskkill(
+          makeTaskkillSpawner(fixture),
+          4321,
+        ).pipe(Effect.exit);
+        if (Exit.isSuccess(failed)) assert.fail(`taskkill ${fixture.exitCode} must fail`);
+        const error = Cause.squash(failed.cause);
+        assert.instanceOf(error, AcpSessionRuntime.AcpProcessGroupTerminationError);
+        const termination = error as AcpSessionRuntime.AcpProcessGroupTerminationError;
+        assert.equal(
+          termination.detail,
+          `taskkill exited ${fixture.exitCode} for ACP process tree 4321`,
+        );
+        assert.equal(termination.pid, 4321);
+        assert.equal(termination.exitCode, fixture.exitCode);
+        if (fixture.output.length > 0) {
+          assert.equal(termination.cause, fixture.output);
+        }
+      }
+
+      for (const fixture of [
+        { spawnFailure: true },
+        { outputFailure: true },
+        { exitFailure: true },
+      ]) {
+        const failed = yield* AcpSessionRuntime.terminateWindowsProcessTreeWithTaskkill(
+          makeTaskkillSpawner(fixture),
+          4321,
+        ).pipe(Effect.exit);
+        if (Exit.isSuccess(failed)) assert.fail("taskkill infrastructure failure must fail");
+        const error = Cause.squash(failed.cause);
+        assert.instanceOf(error, AcpSessionRuntime.AcpProcessGroupTerminationError);
+        assert.equal(
+          (error as AcpSessionRuntime.AcpProcessGroupTerminationError).detail,
+          "Failed to run taskkill for ACP process tree 4321",
+        );
+      }
+    }),
+  );
+
+  it.effect("Windows process-tree teardown surfaces taskkill failure", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const path = yield* Path.Path;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const context = yield* Layer.build(
+        AcpSessionRuntime.layer({
+          spawn: { command: process.execPath, args: [mockAgentPath], cwd: process.cwd() },
+          cwd: process.cwd(),
+          clientInfo: { name: "t3-acp-test", version: "0.0.0" },
+          ownDetachedProcessGroup: true,
+          processGroupPlatform: "win32",
+          windowsProcessTreeTerminator: () =>
+            Effect.fail(
+              new AcpSessionRuntime.AcpProcessGroupTerminationError({
+                detail: "mock taskkill failure",
+              }),
+            ),
+        }).pipe(
+          Layer.provide(
+            Layer.succeed(ChildProcessSpawner.ChildProcessSpawner, childProcessSpawner),
+          ),
+        ),
+      );
+      const runtime = yield* Effect.service(AcpSessionRuntime.AcpSessionRuntime).pipe(
+        Effect.provide(context),
+      );
+      const error = yield* Effect.flip(runtime.terminateProcessGroup!);
+      assert.equal(error.detail, "mock taskkill failure");
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.live("poisons the session when hard teardown defects and blocks replacement work", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const commandPidPath = yield* fileSystem.makeTempFileScoped({
+        prefix: "t3-acp-failed-teardown-command-",
+      });
+      const residualCallbackDir = yield* fileSystem.makeTempDirectoryScoped();
+      const residualCallbackResponseLogPath = path.join(residualCallbackDir, "responses.log");
+      const residualCallbackTriggerPath = path.join(residualCallbackDir, "trigger");
+      const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+      const continuationRequests: Array<ProviderContinuationRequest> = [];
+      const teardownStarted = yield* Deferred.make<void>();
+      const releaseTeardown = yield* Deferred.make<void>();
+      let terminatorCallCount = 0;
+      const instanceId = ProviderInstanceId.make("acp-test");
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          enablePostSettleContinuation: true,
+          restartRuntimeAfterInterrupt: true,
+          terminateRuntimeProcessGroupOnInterrupt: true,
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            mockAgentPath,
+            ownDetachedProcessGroup: true,
+            processGroupPlatform: "win32",
+            windowsProcessTreeTerminator: () =>
+              Effect.gen(function* () {
+                terminatorCallCount += 1;
+                yield* Deferred.succeed(teardownStarted, undefined);
+                yield* Deferred.await(releaseTeardown);
+                return yield* Effect.die("mock taskkill defect");
+              }),
+            environment: {
+              T3_ACP_EMIT_RUNNING_COMMAND_THEN_HANG: "1",
+              T3_ACP_RESIDUAL_CALLBACK_RESPONSE_LOG_PATH: residualCallbackResponseLogPath,
+              T3_ACP_RESIDUAL_CALLBACK_TRIGGER_PATH: residualCallbackTriggerPath,
+              T3_ACP_RUNNING_COMMAND_PID_PATH: commandPidPath,
+            },
+            protocolEvents,
+          }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+        continuationRequests: {
+          offer: (request) =>
+            Effect.sync(() => {
+              continuationRequests.push(request);
+            }),
+        },
+      });
+      const threadId = ThreadId.make("thread-acp-failed-hard-teardown");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const sessionScope = yield* Scope.make();
+      const runtime = yield* adapter
+        .openSession({
+          threadId,
+          providerSessionId: ProviderSessionId.make("provider-session-acp-failed-hard-teardown"),
+          modelSelection,
+          runtimePolicy,
+        })
+        .pipe(Effect.provideService(Scope.Scope, sessionScope));
+      const adapterEvents = yield* Queue.unbounded<ProviderAdapterV2Event>();
+      yield* runtime.events.pipe(
+        Stream.runForEach((event) => Queue.offer(adapterEvents, event)),
+        Effect.forkIn(sessionScope),
+      );
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      const now = yield* DateTime.now;
+      yield* runtime
+        .startTurn(
+          makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now, ordinal: 1 }),
+        )
+        .pipe(Effect.forkScoped);
+      while ((yield* fileSystem.readFileString(commandPidPath)).trim().length === 0) {
+        yield* Effect.yieldNow;
+      }
+      const [commandRootPid, commandSleepPid] = (yield* fileSystem.readFileString(commandPidPath))
+        .trim()
+        .split(/\s+/)
+        .map(Number);
+      assert.isTrue(
+        Option.isSome(yield* waitForProcesses([commandRootPid!, commandSleepPid!])),
+        "declared failed-teardown Bash and sleep PIDs must both become live",
+      );
+      yield* pollProtocolMethods(protocolEvents);
+
+      const providerTurnId = idAllocator.derive.providerTurn({
+        driver: ACP_TEST_DRIVER,
+        nativeTurnId: "mock-session-1:turn:1",
+      });
+      const interruptFiber = yield* runtime
+        .interruptTurn({ providerThread, providerTurnId, requestRuntimeRestart: true })
+        .pipe(Effect.exit, Effect.forkScoped);
+      yield* Deferred.await(teardownStarted);
+      const startFiber = yield* runtime
+        .startTurn(
+          makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now, ordinal: 2 }),
+        )
+        .pipe(Effect.exit, Effect.forkScoped);
+      yield* Effect.yieldNow;
+      yield* Effect.yieldNow;
+      assert.isUndefined(startFiber.pollUnsafe());
+      const methodsDuringTeardown = yield* pollProtocolMethods(protocolEvents);
+      yield* Deferred.succeed(releaseTeardown, undefined);
+      assert.notInclude(methodsDuringTeardown, "session/load");
+      assert.notInclude(methodsDuringTeardown, "session/prompt");
+
+      const interruptExit = yield* Fiber.join(interruptFiber);
+      if (Exit.isSuccess(interruptExit)) assert.fail("hard teardown failure must fail interrupt");
+      assert.include(Cause.pretty(interruptExit.cause), "session is poisoned");
+      assert.isTrue(
+        Option.isSome(yield* waitForProcesses([commandRootPid!, commandSleepPid!])),
+        "failed teardown must leave both declared Bash and sleep PIDs live",
+      );
+
+      while (Option.isSome(yield* Queue.poll(adapterEvents))) {
+        // Discard the interrupted turn's expected projection before residual traffic.
+      }
+      yield* fileSystem.writeFileString(residualCallbackTriggerPath, "go");
+      yield* Stream.fromQueue(protocolEvents).pipe(
+        Stream.filter(
+          (event) =>
+            event.direction === "incoming" &&
+            event.stage === "raw" &&
+            typeof event.payload === "string" &&
+            event.payload.includes('"method":"session/elicitation"'),
+        ),
+        Stream.runHead,
+      );
+      yield* Effect.sleep("100 millis");
+      assert.isTrue(
+        Option.isNone(yield* Queue.poll(adapterEvents)),
+        "residual callbacks must not mutate or emit adapter projection after poison",
+      );
+      assert.isFalse(
+        yield* fileSystem.exists(residualCallbackResponseLogPath),
+        "permission and elicitation callbacks must remain unresolved after poison",
+      );
+      assert.lengthOf(
+        continuationRequests,
+        0,
+        "residual callbacks must not offer a continuation after poison",
+      );
+
+      const startExit = yield* Fiber.join(startFiber);
+      if (Exit.isSuccess(startExit)) assert.fail("poisoned session must reject startTurn");
+      assert.include(Cause.pretty(startExit.cause), "session is poisoned");
+      const resumeExit = yield* runtime
+        .resumeThread({ providerThread, modelSelection, runtimePolicy })
+        .pipe(Effect.exit);
+      if (Exit.isSuccess(resumeExit)) assert.fail("poisoned session must reject resumeThread");
+      assert.include(Cause.pretty(resumeExit.cause), "session is poisoned");
+      const snapshotExit = yield* runtime.readThreadSnapshot({ providerThread }).pipe(Effect.exit);
+      if (Exit.isSuccess(snapshotExit)) {
+        assert.fail("poisoned session must reject readThreadSnapshot");
+      }
+      assert.include(Cause.pretty(snapshotExit.cause), "session is poisoned");
+      const forkExit = yield* runtime
+        .forkThread({
+          sourceProviderThread: providerThread,
+          targetThreadId: ThreadId.make("thread-acp-poisoned-fork"),
+        })
+        .pipe(Effect.exit);
+      if (Exit.isSuccess(forkExit)) assert.fail("poisoned session must reject forkThread");
+      assert.include(Cause.pretty(forkExit.cause), "session is poisoned");
+      yield* pollProtocolMethods(protocolEvents);
+      const retryInterruptExit = yield* runtime
+        .interruptTurn({ providerThread, providerTurnId, requestRuntimeRestart: true })
+        .pipe(Effect.exit);
+      if (Exit.isSuccess(retryInterruptExit)) {
+        assert.fail("poisoned session must reject a repeated hard interrupt");
+      }
+      const firstInterruptError = Cause.squash(interruptExit.cause) as Error;
+      const retryInterruptError = Cause.squash(retryInterruptExit.cause) as Error;
+      assert.strictEqual(retryInterruptError.cause, firstInterruptError.cause);
+      assert.equal(terminatorCallCount, 1);
+      const methodsAfterPoison = yield* pollProtocolMethods(protocolEvents);
+      assert.notInclude(methodsAfterPoison, "initialize");
+      assert.notInclude(methodsAfterPoison, "session/cancel");
+      assert.notInclude(methodsAfterPoison, "session/fork");
+      assert.notInclude(methodsAfterPoison, "session/load");
+      assert.notInclude(methodsAfterPoison, "session/prompt");
+      assert.isTrue(processExists(commandRootPid!));
+      assert.isTrue(processExists(commandSleepPid!));
+      yield* Scope.close(sessionScope, Exit.void);
+      assert.isTrue(
+        Option.isSome(yield* waitForProcessesToExit([commandRootPid!, commandSleepPid!])),
+        "finalizer cleanup must reap both declared Bash and sleep PIDs",
+      );
+      assert.isFalse(processExists(commandRootPid!));
+      assert.isFalse(processExists(commandSleepPid!));
+      const finalizerMethods = yield* pollProtocolMethods(protocolEvents);
+      assert.notInclude(finalizerMethods, "session/close");
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.live("durably poisons start and resume when required hard teardown is unavailable", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+      const instanceId = ProviderInstanceId.make("acp-test");
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          restartRuntimeAfterInterrupt: true,
+          terminateRuntimeProcessGroupOnInterrupt: true,
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            mockAgentPath,
+            environment: { T3_ACP_HANG_PROMPT_FOREVER: "1" },
+            protocolEvents,
+          }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+      });
+      const threadId = ThreadId.make("thread-acp-missing-hard-teardown");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make("provider-session-acp-missing-hard-teardown"),
+        modelSelection,
+        runtimePolicy,
+      });
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      const now = yield* DateTime.now;
+      yield* runtime
+        .startTurn(
+          makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now, ordinal: 1 }),
+        )
+        .pipe(Effect.forkScoped);
+      yield* Stream.fromQueue(protocolEvents).pipe(
+        Stream.filter(
+          (event) =>
+            event.direction === "outgoing" && rawProtocolMethod(event) === "session/prompt",
+        ),
+        Stream.runHead,
+      );
+      const providerTurnId = idAllocator.derive.providerTurn({
+        driver: ACP_TEST_DRIVER,
+        nativeTurnId: "mock-session-1:turn:1",
+      });
+      const interruptExit = yield* runtime
+        .interruptTurn({ providerThread, providerTurnId, requestRuntimeRestart: true })
+        .pipe(Effect.exit);
+      if (Exit.isSuccess(interruptExit)) assert.fail("missing hard teardown must fail interrupt");
+      assert.include(Cause.pretty(interruptExit.cause), "session is poisoned");
+
+      const startExit = yield* runtime
+        .startTurn(
+          makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now, ordinal: 2 }),
+        )
+        .pipe(Effect.exit);
+      if (Exit.isSuccess(startExit)) assert.fail("poisoned session must reject startTurn");
+      assert.include(Cause.pretty(startExit.cause), "session is poisoned");
+      const resumeExit = yield* runtime
+        .resumeThread({ providerThread, modelSelection, runtimePolicy })
+        .pipe(Effect.exit);
+      if (Exit.isSuccess(resumeExit)) assert.fail("poisoned session must reject resumeThread");
+      assert.include(Cause.pretty(resumeExit.cause), "session is poisoned");
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.live("holds concurrent startTurn behind successful hard teardown and reloads once", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+      const teardownStarted = yield* Deferred.make<void>();
+      const releaseTeardown = yield* Deferred.make<void>();
+      let runtimeOrdinalSeen = 0;
+      const instanceId = ProviderInstanceId.make("acp-test");
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          interruptPromptOnCancel: true,
+          restartRuntimeAfterInterrupt: true,
+          terminateRuntimeProcessGroupOnInterrupt: true,
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            mockAgentPath,
+            ownDetachedProcessGroup: true,
+            processGroupPlatform: "win32",
+            windowsProcessTreeTerminator: () =>
+              Deferred.succeed(teardownStarted, undefined).pipe(
+                Effect.andThen(Deferred.await(releaseTeardown)),
+              ),
+            environment: (runtimeOrdinal) => {
+              runtimeOrdinalSeen = runtimeOrdinal;
+              return runtimeOrdinal === 1 ? { T3_ACP_HANG_PROMPT_FOREVER: "1" } : {};
+            },
+            protocolEvents,
+          }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+      });
+      const threadId = ThreadId.make("thread-acp-concurrent-hard-teardown");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make("provider-session-acp-concurrent-hard-teardown"),
+        modelSelection,
+        runtimePolicy,
+      });
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      const now = yield* DateTime.now;
+      yield* runtime
+        .startTurn(
+          makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now, ordinal: 1 }),
+        )
+        .pipe(Effect.forkScoped);
+      yield* Effect.yieldNow;
+      yield* Effect.yieldNow;
+      yield* Effect.yieldNow;
+      const providerTurnId = idAllocator.derive.providerTurn({
+        driver: ACP_TEST_DRIVER,
+        nativeTurnId: "mock-session-1:turn:1",
+      });
+      yield* pollProtocolMethods(protocolEvents);
+      const interruptFiber = yield* runtime
+        .interruptTurn({ providerThread, providerTurnId, requestRuntimeRestart: true })
+        .pipe(Effect.forkScoped);
+      yield* Deferred.await(teardownStarted);
+      const startFiber = yield* runtime
+        .startTurn(
+          makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now, ordinal: 2 }),
+        )
+        .pipe(Effect.forkScoped);
+      yield* Effect.yieldNow;
+      yield* Effect.yieldNow;
+      assert.isUndefined(startFiber.pollUnsafe());
+      assert.equal(runtimeOrdinalSeen, 1);
+      const methodsDuringTeardown = yield* pollProtocolMethods(protocolEvents);
+      assert.notInclude(methodsDuringTeardown, "session/load");
+      assert.notInclude(methodsDuringTeardown, "session/prompt");
+
+      yield* Deferred.succeed(releaseTeardown, undefined);
+      yield* Fiber.join(interruptFiber);
+      yield* Fiber.join(startFiber);
+      assert.equal(runtimeOrdinalSeen, 2);
+      const replacementMethods = yield* pollProtocolMethods(protocolEvents);
+      assert.equal(replacementMethods.filter((method) => method === "session/load").length, 1);
+      if (!replacementMethods.includes("session/prompt")) {
+        yield* Stream.fromQueue(protocolEvents).pipe(
+          Stream.filter(
+            (event) =>
+              event.direction === "outgoing" && rawProtocolMethod(event) === "session/prompt",
+          ),
+          Stream.runHead,
+        );
+      }
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.live("quarantines old-runtime callbacks after successful hard teardown", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+      const continuationRequests: Array<ProviderContinuationRequest> = [];
+      const responseLifecycle: Array<string> = [];
+      type RuntimeService = AcpSessionRuntime.AcpSessionRuntime["Service"];
+      type HandlerRecord = {
+        sessionUpdate?: Parameters<RuntimeService["handleSessionUpdate"]>[0];
+        permission?: Parameters<RuntimeService["handleRequestPermission"]>[0];
+        elicitation?: Parameters<RuntimeService["handleElicitation"]>[0];
+        requestUserInput?: AcpAdapterV2ExtensionContext["requestUserInput"];
+      };
+      const handlerRecords: HandlerRecord[] = [];
+      const runtimeInputs: AcpAdapterV2RuntimeInput[] = [];
+      const oldPromptCompletion = yield* Deferred.make<EffectAcpSchema.PromptResponse>();
+      const transportDrained = yield* Deferred.make<void>();
+      const releaseTransportDrain = yield* Deferred.make<void>();
+      let extensionOrdinal = 0;
+      let runtimeOrdinalSeen = 0;
+      const instanceId = ProviderInstanceId.make("acp-test");
+      const makeRuntime = makeMockRuntime({
+        childProcessSpawner,
+        mockAgentPath,
+        ownDetachedProcessGroup: true,
+        processGroupPlatform: "win32",
+        windowsProcessTreeTerminator: () => Effect.void,
+        environment: (runtimeOrdinal) => {
+          runtimeOrdinalSeen = runtimeOrdinal;
+          return { T3_ACP_HANG_PROMPT_FOREVER: "1" };
+        },
+        protocolEvents,
+        wrapRuntime: (runtime, runtimeOrdinal) => {
+          const record: HandlerRecord = {};
+          handlerRecords[runtimeOrdinal - 1] = record;
+          return {
+            ...runtime,
+            handleSessionUpdate: (handler) =>
+              Effect.sync(() => {
+                record.sessionUpdate = handler;
+              }).pipe(Effect.andThen(runtime.handleSessionUpdate(handler))),
+            handleRequestPermission: (handler) =>
+              Effect.sync(() => {
+                record.permission = handler;
+              }).pipe(Effect.andThen(runtime.handleRequestPermission(handler))),
+            handleElicitation: (handler) =>
+              Effect.sync(() => {
+                record.elicitation = handler;
+              }).pipe(Effect.andThen(runtime.handleElicitation(handler))),
+            ...(runtimeOrdinal === 1
+              ? {
+                  prompt: (payload) =>
+                    Effect.gen(function* () {
+                      yield* runtime.prompt(payload).pipe(Effect.ignore, Effect.forkDetach);
+                      return yield* Deferred.await(oldPromptCompletion);
+                    }),
+                }
+              : {}),
+          };
+        },
+      });
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          enablePostSettleContinuation: true,
+          registerExtensions: ({ requestUserInput }) =>
+            Effect.sync(() => {
+              handlerRecords[extensionOrdinal++]!.requestUserInput = requestUserInput;
+            }),
+          restartRuntimeAfterInterrupt: true,
+          terminateRuntimeProcessGroupOnInterrupt: true,
+          makeRuntime: (runtimeInput) =>
+            Effect.sync(() => {
+              runtimeInputs.push(runtimeInput);
+            }).pipe(Effect.andThen(makeRuntime(runtimeInput))),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+        testHooks: {
+          afterHardTeardownTransportDrained: () =>
+            Deferred.succeed(transportDrained, undefined).pipe(
+              Effect.andThen(Deferred.await(releaseTransportDrain)),
+            ),
+          onNativeResponseLifecycle: (event) =>
+            Effect.sync(() => {
+              responseLifecycle.push(event.type);
+            }),
+        },
+        continuationRequests: {
+          offer: (request) =>
+            Effect.sync(() => {
+              continuationRequests.push(request);
+            }),
+        },
+      });
+      const threadId = ThreadId.make("thread-acp-successful-teardown-callback-quarantine");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make(
+          "provider-session-acp-successful-teardown-callback-quarantine",
+        ),
+        modelSelection,
+        runtimePolicy,
+      });
+      const adapterEvents = yield* Queue.unbounded<ProviderAdapterV2Event>();
+      yield* runtime.events.pipe(
+        Stream.runForEach((event) => Queue.offer(adapterEvents, event)),
+        Effect.forkScoped,
+      );
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      const now = yield* DateTime.now;
+      yield* runtime
+        .startTurn(
+          makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now, ordinal: 1 }),
+        )
+        .pipe(Effect.forkScoped);
+      yield* Stream.fromQueue(protocolEvents).pipe(
+        Stream.filter(
+          (event) =>
+            event.direction === "outgoing" && rawProtocolMethod(event) === "session/prompt",
+        ),
+        Stream.runHead,
+      );
+      const providerTurnId = idAllocator.derive.providerTurn({
+        driver: ACP_TEST_DRIVER,
+        nativeTurnId: "mock-session-1:turn:1",
+      });
+      const permissionRequest = {
+        sessionId: "mock-session-1",
+        toolCall: {
+          toolCallId: "stale-generation-1-permission",
+          title: "Stale generation 1 permission",
+        },
+        options: [{ optionId: "allow", name: "Allow", kind: "allow_once" as const }],
+      };
+      const interruptFiber = yield* runtime
+        .interruptTurn({
+          providerThread,
+          providerTurnId,
+          requestRuntimeRestart: true,
+        })
+        .pipe(Effect.forkScoped);
+      yield* Deferred.await(transportDrained);
+      const heldInboundFiber = yield* runtimeInputs[0]!.onIncomingRequest!(
+        "post-drain-stale-permission-id",
+        "session/request_permission",
+        permissionRequest,
+      ).pipe(Effect.forkScoped);
+      yield* Effect.yieldNow;
+      assert.isUndefined(heldInboundFiber.pollUnsafe());
+      yield* Deferred.succeed(releaseTransportDrain, undefined);
+      yield* Fiber.join(heldInboundFiber);
+      yield* Fiber.join(interruptFiber);
+      assert.notInclude(responseLifecycle, "registered");
+      assert.notInclude(responseLifecycle, "watcher_started");
+      assert.isFalse(
+        (yield* Queue.takeAll(adapterEvents)).some(
+          (event) => event.type === "runtime_request.updated",
+        ),
+        "post-drain inbound callback must not emit a runtime request",
+      );
+      assert.equal(runtimeOrdinalSeen, 1);
+      yield* runtime.startTurn(
+        makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now, ordinal: 2 }),
+      );
+      yield* Stream.fromQueue(protocolEvents).pipe(
+        Stream.filter(
+          (event) =>
+            event.direction === "outgoing" && rawProtocolMethod(event) === "session/prompt",
+        ),
+        Stream.runHead,
+      );
+      assert.equal(runtimeOrdinalSeen, 2);
+      const oldHandlers = handlerRecords[0]!;
+      const replacementHandlers = handlerRecords[1]!;
+      assert.isDefined(oldHandlers.sessionUpdate);
+      assert.isDefined(oldHandlers.permission);
+      assert.isDefined(oldHandlers.elicitation);
+      assert.isDefined(oldHandlers.requestUserInput);
+      assert.isDefined(replacementHandlers.sessionUpdate);
+      assert.isDefined(replacementHandlers.permission);
+      assert.isDefined(replacementHandlers.elicitation);
+      assert.isDefined(replacementHandlers.requestUserInput);
+      assert.lengthOf(runtimeInputs, 2);
+      while (Option.isSome(yield* Queue.poll(adapterEvents))) {
+        // Discard generation 1 terminal and generation 2 startup projection.
+      }
+
+      yield* oldHandlers.sessionUpdate!({
+        sessionId: "mock-session-1",
+        update: {
+          sessionUpdate: "agent_message_chunk",
+          content: { type: "text", text: "stale generation 1 assistant" },
+        },
+      });
+      yield* oldHandlers.sessionUpdate!({
+        sessionId: "mock-session-1",
+        update: {
+          sessionUpdate: "tool_call_update",
+          toolCallId: "stale-generation-1-tool",
+          title: "Stale generation 1 tool",
+          kind: "other",
+          status: "completed",
+          rawOutput: { output: "stale continuation evidence" },
+        },
+      });
+      const oldPermissionFiber = yield* oldHandlers.permission!(permissionRequest).pipe(
+        Effect.exit,
+        Effect.forkScoped,
+      );
+      const oldElicitationFiber = yield* oldHandlers.elicitation!({
+        sessionId: "mock-session-1",
+        message: "Stale generation 1 elicitation",
+        mode: "form",
+        requestedSchema: {
+          type: "object",
+          properties: { approved: { type: "boolean", title: "Approved" } },
+        },
+      }).pipe(Effect.exit, Effect.forkScoped);
+      const oldXAiUserInputFiber = yield* oldHandlers.requestUserInput!({
+        nativeItemId: "stale-generation-1-xai-item",
+        nativeMethod: "_x.ai/ask_user_question",
+        nativeRequestId: "stale-generation-1-xai-request",
+        nativeSessionId: "mock-session-1",
+        questions: [
+          {
+            id: "approved",
+            header: "Approve",
+            question: "Approve stale generation 1?",
+            options: [{ label: "yes", description: "Approve" }],
+          },
+        ],
+      }).pipe(Effect.exit, Effect.forkScoped);
+      yield* Deferred.succeed(oldPromptCompletion, { stopReason: "end_turn" });
+      yield* Effect.sleep("100 millis");
+      assert.isTrue(Option.isNone(yield* Queue.poll(adapterEvents)));
+      assert.isUndefined(oldPermissionFiber.pollUnsafe());
+      assert.isUndefined(oldElicitationFiber.pollUnsafe());
+      assert.isUndefined(oldXAiUserInputFiber.pollUnsafe());
+      assert.lengthOf(continuationRequests, 0);
+
+      yield* replacementHandlers.sessionUpdate!({
+        sessionId: "mock-session-1",
+        update: {
+          sessionUpdate: "agent_message_chunk",
+          content: { type: "text", text: "live generation 2 assistant" },
+        },
+      });
+      let replacementMessageSeen = false;
+      while (!replacementMessageSeen) {
+        const event = yield* Queue.take(adapterEvents);
+        replacementMessageSeen =
+          event.type === "message.updated" && event.message.text.includes("live generation 2");
+      }
+      const missingPermissionTransport = yield* replacementHandlers.permission!(
+        permissionRequest,
+      ).pipe(Effect.exit);
+      if (Exit.isSuccess(missingPermissionTransport)) {
+        assert.fail("a core permission request without transport correlation must fail closed");
+      }
+      assert.include(Cause.pretty(missingPermissionTransport.cause), "Could not correlate");
+      yield* runtimeInputs[1]!.onIncomingRequest!(
+        "live-generation-2-permission-id",
+        "session/request_permission",
+        permissionRequest,
+      );
+      const replacementPermission = yield* replacementHandlers.permission!(permissionRequest);
+      assert.equal(replacementPermission.outcome.outcome, "selected");
+      yield* runtimeInputs[1]!.onOutgoingResponse!("live-generation-2-permission-id");
+      const urlElicitation = {
+        elicitationId: "replacement-url-id",
+        message: "Open replacement URL",
+        mode: "url" as const,
+        sessionId: "mock-session-1",
+        url: "https://example.com/replacement",
+      };
+      const missingElicitationTransport = yield* replacementHandlers.elicitation!(
+        urlElicitation,
+      ).pipe(Effect.exit);
+      if (Exit.isSuccess(missingElicitationTransport)) {
+        assert.fail("a core elicitation request without transport correlation must fail closed");
+      }
+      assert.include(Cause.pretty(missingElicitationTransport.cause), "Could not correlate");
+      yield* runtimeInputs[1]!.onIncomingRequest!(
+        "live-generation-2-url-id",
+        "session/elicitation",
+        urlElicitation,
+      );
+      yield* replacementHandlers.elicitation!(urlElicitation);
+      yield* runtimeInputs[1]!.onOutgoingResponse!("live-generation-2-url-id");
+
+      const collidingRequestPayload = {
+        sessionId: "mock-session-1",
+        toolCallId: "shared-request-id",
+      };
+      const missingXAiTransport = yield* replacementHandlers.requestUserInput!({
+        nativeItemId: "missing-generation-2-xai-item",
+        nativeMethod: "_x.ai/ask_user_question",
+        nativeRequestId: "shared-request-id",
+        nativeSessionId: "mock-session-1",
+        questions: [
+          {
+            id: "approved",
+            header: "Approve",
+            question: "Approve missing transport?",
+            options: [{ label: "yes", description: "Approve" }],
+          },
+        ],
+      }).pipe(Effect.exit);
+      if (Exit.isSuccess(missingXAiTransport)) {
+        assert.fail("an xAI user input request without transport correlation must fail closed");
+      }
+      assert.include(Cause.pretty(missingXAiTransport.cause), "Could not correlate");
+      yield* runtimeInputs[0]!.onIncomingRequest!(
+        "stale-generation-1-transport-id",
+        "x.ai/ask_user_question",
+        collidingRequestPayload,
+      );
+      yield* runtimeInputs[1]!.onIncomingRequest!(
+        "live-generation-2-wrong-method-id",
+        "x.ai/ask_user_question",
+        collidingRequestPayload,
+      );
+      yield* runtimeInputs[1]!.onIncomingRequest!(
+        "live-generation-2-transport-id",
+        "_x.ai/ask_user_question",
+        collidingRequestPayload,
+      );
+      const replacementUserInputFiber = yield* replacementHandlers.requestUserInput!({
+        nativeItemId: "live-generation-2-xai-item",
+        nativeMethod: "_x.ai/ask_user_question",
+        nativeRequestId: "shared-request-id",
+        nativeSessionId: "mock-session-1",
+        questions: [
+          {
+            id: "approved",
+            header: "Approve",
+            question: "Approve live generation 2?",
+            options: [{ label: "yes", description: "Approve" }],
+          },
+        ],
+      }).pipe(Effect.forkScoped);
+      let replacementRequest: ProviderAdapterV2Event | undefined;
+      while (replacementRequest === undefined) {
+        const event = yield* Queue.take(adapterEvents);
+        if (event.type === "runtime_request.updated" && event.runtimeRequest.status === "pending") {
+          replacementRequest = event;
+        }
+      }
+      if (replacementRequest.type !== "runtime_request.updated") {
+        return yield* Effect.die("Expected generation 2 xAI user input request");
+      }
+      const responseFiber = yield* runtime
+        .respondToRuntimeRequest({
+          requestId: replacementRequest.runtimeRequest.id,
+          answers: { approved: ["yes"] },
+        })
+        .pipe(Effect.forkScoped);
+      const replacementUserInput = yield* Fiber.join(replacementUserInputFiber);
+      assert.deepEqual(replacementUserInput.answers, { approved: ["yes"] });
+      yield* replacementUserInput.acknowledgeNativeResponse;
+      yield* runtimeInputs[0]!.onOutgoingResponse!("stale-generation-1-transport-id");
+      yield* runtimeInputs[1]!.onOutgoingResponse!("live-generation-2-wrong-method-id");
+      yield* Effect.yieldNow;
+      assert.isUndefined(responseFiber.pollUnsafe());
+      yield* runtimeInputs[1]!.onOutgoingResponse!("live-generation-2-transport-id");
+      yield* Fiber.join(responseFiber);
+
+      yield* runtime.interruptTurn({
+        providerThread,
+        providerTurnId: idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:2",
+        }),
+        requestRuntimeRestart: true,
+      });
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.live("keeps stale deferred cleanup inert while replacement requests remain live", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+      const instanceId = ProviderInstanceId.make("acp-test");
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          restartRuntimeAfterInterrupt: true,
+          terminateRuntimeProcessGroupOnInterrupt: true,
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            mockAgentPath,
+            ownDetachedProcessGroup: true,
+            processGroupPlatform: "win32",
+            windowsProcessTreeTerminator: () => Effect.void,
+            environment: { T3_ACP_EMIT_TOOL_CALLS: "1" },
+            protocolEvents,
+          }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+      });
+      const threadId = ThreadId.make("thread-acp-stale-deferred-cleanup");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "approval-required",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make("provider-session-acp-stale-deferred-cleanup"),
+        modelSelection,
+        runtimePolicy,
+      });
+      const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+      yield* runtime.events.pipe(
+        Stream.runForEach((event) => Queue.offer(events, event)),
+        Effect.forkScoped,
+      );
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      const now = yield* DateTime.now;
+      yield* runtime.startTurn(
+        makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now, ordinal: 1 }),
+      );
+      const oldPending = yield* Queue.take(events).pipe(
+        Effect.repeat({
+          until: (event) =>
+            event.type === "runtime_request.updated" && event.runtimeRequest.status === "pending",
+        }),
+      );
+      if (
+        oldPending.type !== "runtime_request.updated" ||
+        oldPending.runtimeRequest.providerTurnId === null
+      ) {
+        return yield* Effect.die("Expected the old runtime permission request");
+      }
+      yield* runtime.interruptTurn({
+        providerThread,
+        providerTurnId: oldPending.runtimeRequest.providerTurnId,
+        requestRuntimeRestart: true,
+      });
+      const staleResponse = yield* runtime
+        .respondToRuntimeRequest({
+          requestId: oldPending.runtimeRequest.id,
+          decision: "accept",
+        })
+        .pipe(Effect.exit);
+      if (Exit.isSuccess(staleResponse)) {
+        assert.fail("teardown must synchronously remove the old pending request");
+      }
+      while (Option.isSome(yield* Queue.poll(events))) {
+        // Discard generation 1 cancellation and terminal projection.
+      }
+
+      yield* runtime.startTurn(
+        makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now, ordinal: 2 }),
+      );
+      let replacementPending: ProviderAdapterV2Event | undefined;
+      while (replacementPending === undefined) {
+        const event = yield* Queue.take(events);
+        if (event.type === "runtime_request.updated" && event.runtimeRequest.status === "pending") {
+          replacementPending = event;
+        }
+      }
+      if (replacementPending.type !== "runtime_request.updated") {
+        return yield* Effect.die("Expected the replacement runtime permission request");
+      }
+      assert.notEqual(replacementPending.runtimeRequest.id, oldPending.runtimeRequest.id);
+      yield* runtime.respondToRuntimeRequest({
+        requestId: replacementPending.runtimeRequest.id,
+        decision: "accept",
+      });
+      let replacementTerminal = false;
+      while (!replacementTerminal) {
+        const event = yield* Queue.take(events);
+        if (
+          event.type === "runtime_request.updated" &&
+          event.runtimeRequest.id === oldPending.runtimeRequest.id
+        ) {
+          assert.fail("stale deferred cleanup must not emit into generation 2");
+        }
+        replacementTerminal = event.type === "turn.terminal";
+      }
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.live("resolves owner cancellation and concurrent resume waiters after hard teardown", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+      const teardownStarted = yield* Deferred.make<void>();
+      const releaseTeardown = yield* Deferred.make<void>();
+      let runtimeOrdinalSeen = 0;
+      const instanceId = ProviderInstanceId.make("acp-test");
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          interruptPromptOnCancel: true,
+          restartRuntimeAfterInterrupt: true,
+          terminateRuntimeProcessGroupOnInterrupt: true,
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            mockAgentPath,
+            ownDetachedProcessGroup: true,
+            processGroupPlatform: "win32",
+            windowsProcessTreeTerminator: () =>
+              Deferred.succeed(teardownStarted, undefined).pipe(
+                Effect.andThen(Deferred.await(releaseTeardown)),
+              ),
+            environment: (runtimeOrdinal) => {
+              runtimeOrdinalSeen = runtimeOrdinal;
+              return runtimeOrdinal === 1 ? { T3_ACP_HANG_PROMPT_FOREVER: "1" } : {};
+            },
+            protocolEvents,
+          }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+      });
+      const threadId = ThreadId.make("thread-acp-concurrent-resume-teardown");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make(
+          "provider-session-acp-concurrent-resume-teardown",
+        ),
+        modelSelection,
+        runtimePolicy,
+      });
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      const now = yield* DateTime.now;
+      yield* runtime
+        .startTurn(
+          makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now, ordinal: 1 }),
+        )
+        .pipe(Effect.forkScoped);
+      yield* Effect.yieldNow;
+      yield* Effect.yieldNow;
+      yield* Effect.yieldNow;
+      yield* pollProtocolMethods(protocolEvents);
+      const providerTurnId = idAllocator.derive.providerTurn({
+        driver: ACP_TEST_DRIVER,
+        nativeTurnId: "mock-session-1:turn:1",
+      });
+      const interruptFiber = yield* runtime
+        .interruptTurn({ providerThread, providerTurnId, requestRuntimeRestart: true })
+        .pipe(Effect.forkScoped);
+      yield* Deferred.await(teardownStarted);
+      const resumeFiber = yield* runtime
+        .resumeThread({ providerThread, modelSelection, runtimePolicy })
+        .pipe(Effect.forkScoped);
+      const secondResumeFiber = yield* runtime
+        .resumeThread({ providerThread, modelSelection, runtimePolicy })
+        .pipe(Effect.forkScoped);
+      const snapshotProviderThread = {
+        ...providerThread,
+        nativeThreadRef: {
+          ...providerThread.nativeThreadRef!,
+          nativeId: "mock-session-snapshot",
+        },
+      };
+      const snapshotFiber = yield* runtime
+        .readThreadSnapshot({ providerThread: snapshotProviderThread })
+        .pipe(Effect.forkScoped);
+      const forkFiber = yield* runtime
+        .forkThread({
+          sourceProviderThread: providerThread,
+          targetThreadId: ThreadId.make("thread-acp-concurrent-fork-after-teardown"),
+        })
+        .pipe(Effect.forkScoped);
+      yield* Effect.yieldNow;
+      yield* Effect.yieldNow;
+      assert.isUndefined(resumeFiber.pollUnsafe());
+      assert.isUndefined(secondResumeFiber.pollUnsafe());
+      assert.isUndefined(snapshotFiber.pollUnsafe());
+      assert.isUndefined(forkFiber.pollUnsafe());
+      assert.equal(runtimeOrdinalSeen, 1);
+      const methodsDuringTeardown = yield* pollProtocolMethods(protocolEvents);
+      assert.notInclude(methodsDuringTeardown, "session/load");
+      assert.notInclude(methodsDuringTeardown, "session/fork");
+      const cancelInterruptOwner = yield* Fiber.interrupt(interruptFiber).pipe(Effect.forkScoped);
+      yield* Effect.yieldNow;
+      yield* Effect.yieldNow;
+      assert.isUndefined(cancelInterruptOwner.pollUnsafe());
+      yield* Deferred.succeed(releaseTeardown, undefined);
+      yield* Fiber.join(cancelInterruptOwner);
+      yield* Fiber.join(resumeFiber);
+      yield* Fiber.join(secondResumeFiber);
+      yield* Fiber.join(snapshotFiber);
+      yield* Fiber.join(forkFiber);
+      assert.equal(runtimeOrdinalSeen, 2);
+      const methodsAfterRestart = yield* pollProtocolMethods(protocolEvents);
+      assert.equal(methodsAfterRestart.filter((method) => method === "session/load").length, 2);
+      assert.equal(methodsAfterRestart.filter((method) => method === "session/fork").length, 1);
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.live("direct Stop skips uninterruptible ACP cancel and recovers after native teardown", () =>
+    Effect.gen(function* () {
+      if ((yield* HostProcessPlatform) !== "linux") return;
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+      const commandPidPath = yield* fileSystem.makeTempFileScoped({
+        prefix: "t3-acp-direct-stop-command-",
+      });
+      yield* Effect.addFinalizer(() =>
+        Effect.sync(() => cleanupPublishedDetachedFixture(commandPidPath)),
+      );
+      let cancelCalled = false;
+      const instanceId = ProviderInstanceId.make("acp-test");
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          enablePostSettleContinuation: true,
+          extractBackgroundTaskId: (toolCall) =>
+            toolCall.toolCallId === "tool-call-running-1" ? "task-running-1" : undefined,
+          extractBackgroundTaskCompletion: (toolCall) =>
+            toolCall.toolCallId === "tool-call-output-1"
+              ? [{ taskId: "task-running-1", status: "running", appendOutput: "" }]
+              : [],
+          interruptPromptOnCancel: true,
+          restartRuntimeAfterInterrupt: true,
+          terminateRuntimeProcessGroupOnInterrupt: true,
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            mockAgentPath,
+            ownDescendantProcessGroups: true,
+            ownDetachedProcessGroup: true,
+            environment: (runtimeOrdinal) =>
+              runtimeOrdinal === 1
+                ? {
+                    T3_ACP_EMIT_RUNNING_COMMAND_THEN_HANG: "1",
+                    T3_ACP_EMIT_LATE_UPDATE_AFTER_CANCEL: "1",
+                    T3_ACP_RUNNING_COMMAND_PID_PATH: commandPidPath,
+                    T3_ACP_RUNNING_COMMAND_IGNORE_TERM: "1",
+                    T3_ACP_RUNNING_COMMAND_SEPARATE_SESSION: "1",
+                  }
+                : {},
+            protocolEvents,
+            wrapCancel: () =>
+              Effect.sync(() => {
+                cancelCalled = true;
+              }).pipe(Effect.andThen(Effect.never)),
+          }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+        continuationRequests: { offer: () => Effect.void },
+      });
+      const threadId = ThreadId.make("thread-acp-direct-stop-running-command");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make(
+          "provider-session-acp-direct-stop-running-command",
+        ),
+        modelSelection,
+        runtimePolicy,
+      });
+      const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+      yield* runtime.events.pipe(
+        Stream.runForEach((event) => Queue.offer(events, event)),
+        Effect.forkScoped,
+      );
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      const now = yield* DateTime.now;
+      yield* runtime
+        .startTurn(
+          makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now, ordinal: 1 }),
+        )
+        .pipe(Effect.forkScoped);
+
+      let runningMonitorSeen = false;
+      let runningTaskOutputSeen = false;
+      while (!runningMonitorSeen || !runningTaskOutputSeen) {
+        const event = yield* Queue.take(events);
+        if (
+          event.type === "turn_item.updated" &&
+          (event.turnItem.status === "running" || event.turnItem.status === "pending")
+        ) {
+          if (event.turnItem.nativeItemRef?.nativeId === "tool-call-running-1") {
+            runningMonitorSeen = true;
+          }
+          if (event.turnItem.nativeItemRef?.nativeId === "tool-call-output-1") {
+            runningTaskOutputSeen = true;
+          }
+        }
+      }
+      const [commandLauncherPid, commandRootPid, commandSleepPid] = Option.getOrThrow(
+        yield* waitForPublishedProcessIds(fileSystem, commandPidPath, 3),
+      );
+      assert.isTrue(
+        Option.isSome(
+          yield* waitForProcesses([commandLauncherPid!, commandRootPid!, commandSleepPid!]),
+        ),
+        "declared direct Stop launcher, Bash, and sleep PIDs must become live",
+      );
+
+      const firstProviderTurnId = idAllocator.derive.providerTurn({
+        driver: ACP_TEST_DRIVER,
+        nativeTurnId: "mock-session-1:turn:1",
+      });
+      yield* Queue.takeAll(events);
+      const interruptFiber = yield* runtime
+        .interruptTurn({
+          providerThread,
+          providerTurnId: firstProviderTurnId,
+          requestRuntimeRestart: true,
+        })
+        .pipe(Effect.forkScoped);
+      const interruptCompleted = yield* Fiber.join(interruptFiber).pipe(
+        Effect.timeoutOption("3 seconds"),
+      );
+      assert.isTrue(Option.isSome(interruptCompleted), "hung ACP cancel must not block teardown");
+      assert.isFalse(cancelCalled, "hard process-group teardown must skip ACP cancel");
+      yield* Effect.sleep("250 millis");
+      assert.isFalse(processExists(commandLauncherPid!));
+      assert.isFalse(processExists(commandRootPid!));
+      assert.isFalse(processExists(commandSleepPid!));
+
+      let terminalStatus: string | null = null;
+      let openToolTerminalStatus: string | null = null;
+      let openToolInterruptedExitCode: number | undefined = 42;
+      let lateAfterCancelSeen = false;
+      let runningMonitorAfterInterrupt = false;
+      while (terminalStatus === null || openToolTerminalStatus === null) {
+        const event = yield* Queue.take(events);
+        if (
+          event.type === "turn_item.updated" &&
+          event.turnItem.nativeItemRef?.nativeId === "tool-call-running-1" &&
+          event.turnItem.status === "running"
+        ) {
+          runningMonitorAfterInterrupt = true;
+          if (event.turnItem.type === "command_execution") {
+            assert.equal(
+              event.turnItem.exitCode,
+              undefined,
+              "mid-stream exit_code 0 must not project while the command is still running",
+            );
+          }
+        }
+        if (
+          event.type === "turn_item.updated" &&
+          event.turnItem.type === "command_execution" &&
+          (event.turnItem.status === "failed" ||
+            event.turnItem.status === "cancelled" ||
+            event.turnItem.status === "interrupted" ||
+            event.turnItem.status === "completed")
+        ) {
+          openToolTerminalStatus = event.turnItem.status;
+          openToolInterruptedExitCode = event.turnItem.exitCode;
+        }
+        if (event.type === "turn.terminal" && event.providerTurnId === firstProviderTurnId) {
+          terminalStatus = event.status;
+        }
+        if (
+          event.type === "message.updated" &&
+          event.message.role === "assistant" &&
+          event.message.text.includes("late after cancel")
+        ) {
+          lateAfterCancelSeen = true;
+        }
+      }
+      assert.equal(terminalStatus, "interrupted");
+      assert.equal(openToolTerminalStatus, "interrupted");
+      assert.equal(
+        openToolInterruptedExitCode,
+        undefined,
+        "interrupted commands must not retain a mid-stream exit_code 0",
+      );
+      assert.isFalse(runningMonitorAfterInterrupt);
+      assert.isFalse(yield* runtime.hasPendingBackgroundWork!);
+      assert.isFalse(
+        lateAfterCancelSeen,
+        "late post-Stop assistant text must not attach to the stopped run",
+      );
+
+      // Give residual cancel-path updates a chance to mis-project if quarantine fails.
+      yield* Effect.sleep("200 millis");
+      yield* Effect.yieldNow;
+      yield* Effect.yieldNow;
+      let residual = yield* Queue.poll(events);
+      while (Option.isSome(residual)) {
+        const event = residual.value;
+        if (
+          event.type === "turn_item.updated" &&
+          event.turnItem.nativeItemRef?.nativeId === "tool-call-running-1"
+        ) {
+          assert.notEqual(event.turnItem.status, "running");
+        }
+        if (
+          event.type === "message.updated" &&
+          event.message.role === "assistant" &&
+          event.message.text.includes("late after cancel")
+        ) {
+          lateAfterCancelSeen = true;
+        }
+        residual = yield* Queue.poll(events);
+      }
+      assert.isFalse(lateAfterCancelSeen, "quarantine must drop residual stopped-run events");
+
+      const secondNow = yield* DateTime.now;
+      yield* runtime.startTurn(
+        makeTurnInput({
+          threadId,
+          providerThread,
+          instanceId,
+          runtimePolicy,
+          now: secondNow,
+          ordinal: 2,
+        }),
+      );
+      const loadAfterRestart = yield* Stream.fromQueue(protocolEvents).pipe(
+        Stream.filter(
+          (event) => event.direction === "outgoing" && rawProtocolMethod(event) === "session/load",
+        ),
+        Stream.runHead,
+      );
+      assert.isTrue(
+        Option.isSome(loadAfterRestart),
+        "Direct Stop follow-up must respawn the ACP runtime",
+      );
+
+      const secondProviderTurnId = idAllocator.derive.providerTurn({
+        driver: ACP_TEST_DRIVER,
+        nativeTurnId: "mock-session-1:turn:2",
+      });
+      let secondTerminal: string | null = null;
+      let stoppedRunTextOnFollowUp = false;
+      while (secondTerminal === null) {
+        const event = yield* Queue.take(events);
+        if (
+          event.type === "message.updated" &&
+          event.message.role === "assistant" &&
+          event.message.text.includes("late after cancel")
+        ) {
+          stoppedRunTextOnFollowUp = true;
+        }
+        if (event.type === "turn.terminal" && event.providerTurnId === secondProviderTurnId) {
+          secondTerminal = event.status;
+        }
+      }
+      assert.equal(secondTerminal, "completed");
+      assert.isFalse(
+        stoppedRunTextOnFollowUp,
+        "stopped-run residual text must not attach to the follow-up run",
+      );
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.effect(
+    "direct Stop on a deferred subagent hold terminalizes the subagent and does not carry it forward",
+    () =>
+      Effect.gen(function* () {
+        const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+        const fileSystem = yield* FileSystem.FileSystem;
+        const idAllocator = yield* IdAllocatorV2;
+        const path = yield* Path.Path;
+        const serverConfig = yield* ServerConfig;
+        const mockAgentPath = yield* path.fromFileUrl(
+          new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+        );
+        const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+        const instanceId = ProviderInstanceId.make("acp-test");
+        let subagentPhase: "spawn" | "complete" = "spawn";
+        const adapter = makeAcpAdapterV2({
+          crypto: yield* Crypto.Crypto,
+          instanceId,
+          flavor: {
+            driver: ACP_TEST_DRIVER,
+            capabilities: AcpProviderCapabilitiesV2,
+            deferFinalizeForBackgroundWork: true,
+            restartRuntimeAfterInterrupt: true,
+            extractSubagentUpdate: (toolCall) =>
+              toolCall.toolCallId !== "tool-call-generic-1"
+                ? undefined
+                : subagentPhase === "spawn"
+                  ? {
+                      nativeTaskId: "task-generic-1",
+                      prompt: "background subagent",
+                      title: "background subagent",
+                      model: null,
+                      status: "running",
+                      childSessionId: null,
+                      result: null,
+                    }
+                  : {
+                      nativeTaskId: "task-generic-1",
+                      prompt: "",
+                      title: null,
+                      model: null,
+                      status: "completed",
+                      childSessionId: null,
+                      result: "SUB_DONE",
+                    },
+            makeRuntime: makeMockRuntime({
+              childProcessSpawner,
+              mockAgentPath,
+              environment: { T3_ACP_EMIT_GENERIC_TOOL_PLACEHOLDERS: "1" },
+              protocolEvents,
+            }),
+          },
+          fileSystem,
+          idAllocator,
+          serverConfig,
+        });
+        const threadId = ThreadId.make("thread-acp-direct-stop-subagent-hold");
+        const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          cwd: process.cwd(),
+        });
+        const modelSelection = { instanceId, model: "default" } as const;
+        const runtime = yield* adapter.openSession({
+          threadId,
+          providerSessionId: ProviderSessionId.make(
+            "provider-session-acp-direct-stop-subagent-hold",
+          ),
+          modelSelection,
+          runtimePolicy,
+        });
+        const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+        yield* runtime.events.pipe(
+          Stream.runForEach((event) => Queue.offer(events, event)),
+          Effect.forkScoped,
+        );
+        const providerThread = yield* runtime.ensureThread({
+          threadId,
+          modelSelection,
+          runtimePolicy,
+        });
+        const now = yield* DateTime.now;
+        yield* runtime.startTurn(
+          makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now }),
+        );
+        yield* Stream.fromQueue(protocolEvents).pipe(
+          Stream.filter(
+            (event) =>
+              event.direction === "incoming" &&
+              event.stage === "raw" &&
+              typeof event.payload === "string" &&
+              event.payload.includes('"stopReason"'),
+          ),
+          Stream.runHead,
+        );
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+
+        const firstProviderTurnId = idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:1",
+        });
+        const interruptFiber = yield* runtime
+          .interruptTurn({
+            providerThread,
+            providerTurnId: firstProviderTurnId,
+            requestRuntimeRestart: true,
+          })
+          .pipe(Effect.forkScoped);
+        yield* TestClock.adjust("10 seconds");
+        yield* Fiber.join(interruptFiber);
+
+        let subagentStatus: string | null = null;
+        let firstTerminalStatus: string | null = null;
+        while (firstTerminalStatus === null) {
+          const event = yield* Queue.take(events);
+          if (event.type === "turn_item.updated" && event.turnItem.type === "subagent") {
+            subagentStatus = event.turnItem.status;
+          }
+          if (event.type === "turn.terminal" && event.providerTurnId === firstProviderTurnId) {
+            firstTerminalStatus = event.status;
+          }
+        }
+        assert.equal(firstTerminalStatus, "interrupted");
+        assert.equal(subagentStatus, "interrupted");
+
+        subagentPhase = "complete";
+        const secondNow = yield* DateTime.now;
+        yield* runtime.startTurn(
+          makeTurnInput({
+            threadId,
+            providerThread,
+            instanceId,
+            runtimePolicy,
+            now: secondNow,
+            ordinal: 2,
+          }),
+        );
+        const secondProviderTurnId = idAllocator.derive.providerTurn({
+          driver: ACP_TEST_DRIVER,
+          nativeTurnId: "mock-session-1:turn:2",
+        });
+        let carriedCompleted = false;
+        let secondTerminalStatus: string | null = null;
+        while (secondTerminalStatus === null) {
+          const event = yield* Queue.take(events);
+          if (
+            event.type === "turn_item.updated" &&
+            event.turnItem.type === "subagent" &&
+            event.turnItem.status === "completed"
+          ) {
+            carriedCompleted = true;
+          }
+          if (event.type === "turn.terminal" && event.providerTurnId === secondProviderTurnId) {
+            secondTerminalStatus = event.status;
+          }
+        }
+        assert.equal(secondTerminalStatus, "completed");
+        assert.isFalse(
+          carriedCompleted,
+          "Direct Stop must not carry a stopped subagent into the follow-up run",
+        );
+      }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+
+  it.live("restart_active terminates native work and reloads a clean runtime", () =>
+    Effect.gen(function* () {
+      if ((yield* HostProcessPlatform) !== "linux") return;
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const protocolEvents = yield* Queue.bounded<EffectAcpProtocol.AcpProtocolLogEvent>(256);
+      const commandPidPath = yield* fileSystem.makeTempFileScoped({
+        prefix: "t3-acp-restart-active-command-",
+      });
+      yield* Effect.addFinalizer(() =>
+        Effect.sync(() => cleanupPublishedDetachedFixture(commandPidPath)),
+      );
+      const instanceId = ProviderInstanceId.make("acp-test");
+      const adapter = makeAcpAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        flavor: {
+          driver: ACP_TEST_DRIVER,
+          capabilities: AcpProviderCapabilitiesV2,
+          interruptPromptOnCancel: true,
+          restartRuntimeAfterInterrupt: true,
+          restartRuntimeOnEveryInterrupt: true,
+          terminateRuntimeProcessGroupOnInterrupt: true,
+          makeRuntime: makeMockRuntime({
+            childProcessSpawner,
+            mockAgentPath,
+            ownDescendantProcessGroups: true,
+            ownDetachedProcessGroup: true,
+            processGroupTerminationGrace: 0,
+            environment: (runtimeOrdinal) =>
+              runtimeOrdinal === 1
+                ? {
+                    T3_ACP_EXIT_ON_CANCEL: "1",
+                    T3_ACP_EMIT_LATE_UPDATE_AFTER_CANCEL: "1",
+                    T3_ACP_EMIT_RUNNING_COMMAND_THEN_HANG: "1",
+                    T3_ACP_RUNNING_COMMAND_PID_PATH: commandPidPath,
+                    T3_ACP_RUNNING_COMMAND_SEPARATE_SESSION: "1",
+                  }
+                : {},
+            protocolEvents,
+            wrapCancel: (cancel) => cancel.pipe(Effect.andThen(Effect.sleep("250 millis"))),
+          }),
+        },
+        fileSystem,
+        idAllocator,
+        serverConfig,
+      });
+      const threadId = ThreadId.make("thread-acp-restart-active-in-process");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make("provider-session-acp-restart-active-in-process"),
+        modelSelection,
+        runtimePolicy,
+      });
+      const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+      yield* runtime.events.pipe(
+        Stream.runForEach((event) => Queue.offer(events, event)),
+        Effect.forkScoped,
+      );
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+      const now = yield* DateTime.now;
+      yield* runtime
+        .startTurn(
+          makeTurnInput({ threadId, providerThread, instanceId, runtimePolicy, now, ordinal: 1 }),
+        )
+        .pipe(Effect.forkScoped);
+
+      let runningToolSeen = false;
+      while (!runningToolSeen) {
+        const event = yield* Queue.take(events);
+        if (
+          event.type === "turn_item.updated" &&
+          event.turnItem.type === "command_execution" &&
+          (event.turnItem.status === "running" || event.turnItem.status === "pending")
+        ) {
+          runningToolSeen = true;
+        }
+      }
+      const [commandLauncherPid, commandRootPid, commandSleepPid] = Option.getOrThrow(
+        yield* waitForPublishedProcessIds(fileSystem, commandPidPath, 3),
+      );
+      assert.isTrue(
+        Option.isSome(
+          yield* waitForProcesses([commandLauncherPid!, commandRootPid!, commandSleepPid!]),
+        ),
+        "declared restart_active launcher, Bash, and sleep PIDs must become live",
+      );
+
+      const firstProviderTurnId = idAllocator.derive.providerTurn({
+        driver: ACP_TEST_DRIVER,
+        nativeTurnId: "mock-session-1:turn:1",
+      });
+      // restart_active path: interrupt without requestRuntimeRestart.
+      const interruptFiber = yield* runtime
+        .interruptTurn({
+          providerThread,
+          providerTurnId: firstProviderTurnId,
+        })
+        .pipe(Effect.forkScoped);
+      yield* Fiber.join(interruptFiber);
+      yield* Effect.sleep("250 millis");
+      assert.isFalse(processExists(commandLauncherPid!));
+      assert.isFalse(processExists(commandRootPid!));
+      assert.isFalse(processExists(commandSleepPid!));
+
+      let firstTerminal: string | null = null;
+      while (firstTerminal === null) {
+        const event = yield* Queue.take(events);
+        if (event.type === "turn.terminal" && event.providerTurnId === firstProviderTurnId) {
+          firstTerminal = event.status;
+        }
+      }
+      assert.equal(firstTerminal, "interrupted");
+
+      yield* Queue.takeAll(protocolEvents);
+      yield* runtime
+        .startTurn(
+          makeTurnInput({
+            threadId,
+            providerThread,
+            instanceId,
+            runtimePolicy,
+            now,
+            ordinal: 2,
+          }),
+        )
+        .pipe(Effect.forkScoped);
+      let loadSeen = false;
+      let promptSeen = false;
+      while (!loadSeen || !promptSeen) {
+        const event = yield* Queue.take(protocolEvents);
+        if (event.direction !== "outgoing") continue;
+        const method = rawProtocolMethod(event);
+        loadSeen ||= method === "session/load";
+        promptSeen ||= method === "session/prompt";
+      }
+      assert.isTrue(loadSeen, "restart_active must replay session/load on a new ACP process");
+      assert.isTrue(promptSeen, "replacement prompt must start after reload");
+      const secondProviderTurnId = idAllocator.derive.providerTurn({
+        driver: ACP_TEST_DRIVER,
+        nativeTurnId: "mock-session-1:turn:2",
+      });
+      let staleEventSeen = false;
+      let secondTerminal: string | null = null;
+      while (secondTerminal === null) {
+        const event = yield* Queue.take(events);
+        if (
+          event.type === "turn_item.updated" &&
+          event.turnItem.nativeItemRef?.nativeId === "tool-call-running-1"
+        ) {
+          staleEventSeen = true;
+        }
+        if (
+          event.type === "message.updated" &&
+          event.message.role === "assistant" &&
+          event.message.text.includes("late after cancel")
+        ) {
+          staleEventSeen = true;
+        }
+        if (event.type === "turn.terminal" && event.providerTurnId === secondProviderTurnId) {
+          secondTerminal = event.status;
+        }
+      }
+      assert.equal(secondTerminal, "completed");
+      assert.isFalse(staleEventSeen, "interrupted runtime events must not attach to attempt 2");
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+});
+
+describe("acpPostSettleWakeEvidence", () => {
+  const sessionId = "session-wake";
+
+  it("accepts assistant text and tool updates as wake evidence", () => {
+    assert.isTrue(
+      acpPostSettleWakeEvidence({
+        sessionId,
+        update: {
+          sessionUpdate: "agent_message_chunk",
+          content: { type: "text", text: "Subagent finished. SUBAGENT_DONE" },
+        },
+      }),
+    );
+    assert.isTrue(
+      acpPostSettleWakeEvidence({
+        sessionId,
+        update: {
+          sessionUpdate: "tool_call",
+          toolCallId: "call-1",
+          title: "get_command_or_subagent_output",
+          status: "pending",
+          kind: "other",
+          content: [],
+          locations: [],
+          rawInput: {},
+        },
+      }),
+    );
+  });
+
+  it("rejects monitor end chatter and background mutations", () => {
+    assert.isFalse(
+      acpPostSettleWakeEvidence({
+        sessionId,
+        update: {
+          sessionUpdate: "agent_message_chunk",
+          content: {
+            type: "text",
+            text: 'Monitor "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee" ended',
+          },
+        },
+      }),
+    );
+    assert.isFalse(
+      acpPostSettleWakeEvidence(
+        {
+          sessionId,
+          update: {
+            sessionUpdate: "user_message_chunk",
+            content: { type: "text", text: "task-1 completed" },
+          },
+        },
+        {
+          extractBackgroundToolMutation: () => [
+            {
+              taskId: "task-1",
+              status: "completed",
+              appendOutput: "",
+            },
+          ],
+        },
+      ),
+    );
+  });
+});
+
+describe("acpPostSettleContinuationOfferEvidence", () => {
+  const sessionId = "session-wake-offer";
+
+  it("offers on assistant text and terminal tool status", () => {
+    assert.isTrue(
+      acpPostSettleContinuationOfferEvidence({
+        sessionId,
+        update: {
+          sessionUpdate: "agent_message_chunk",
+          content: { type: "text", text: "Background shell finished." },
+        },
+      }),
+    );
+    assert.isTrue(
+      acpPostSettleContinuationOfferEvidence({
+        sessionId,
+        update: {
+          sessionUpdate: "tool_call_update",
+          toolCallId: "call-1",
+          title: "run_terminal_command",
+          status: "completed",
+          kind: "other",
+          content: [],
+          locations: [],
+          rawInput: {},
+        },
+      }),
+    );
+    assert.isTrue(
+      acpPostSettleContinuationOfferEvidence({
+        sessionId,
+        update: {
+          sessionUpdate: "tool_call_update",
+          toolCallId: "call-2",
+          title: "run_terminal_command",
+          status: "failed",
+          kind: "other",
+          content: [],
+          locations: [],
+          rawInput: {},
+        },
+      }),
+    );
+  });
+
+  it("does not offer on thought-only chunks", () => {
+    assert.isFalse(
+      acpPostSettleContinuationOfferEvidence({
+        sessionId,
+        update: {
+          sessionUpdate: "agent_thought_chunk",
+          content: { type: "text", text: "Still reasoning about the monitor output…" },
+        },
+      }),
+    );
+    // Thoughts may still be wake evidence for buffering once a real offer opens.
+    assert.isTrue(
+      acpPostSettleWakeEvidence({
+        sessionId,
+        update: {
+          sessionUpdate: "agent_thought_chunk",
+          content: { type: "text", text: "Still reasoning about the monitor output…" },
+        },
+      }),
+    );
+  });
+
+  it("does not offer on whitespace-only assistant chunks", () => {
+    const notification = {
+      sessionId,
+      update: {
+        sessionUpdate: "agent_message_chunk" as const,
+        content: { type: "text" as const, text: " \n\t " },
+      },
+    };
+    assert.isFalse(acpPostSettleWakeEvidence(notification));
+    assert.isFalse(acpPostSettleContinuationOfferEvidence(notification));
+  });
+
+  it("buffers in-progress tool updates without offering", () => {
+    assert.isTrue(
+      acpPostSettleWakeEvidence({
+        sessionId,
+        update: {
+          sessionUpdate: "tool_call_update",
+          toolCallId: "call-1",
+          title: "run_terminal_command",
+          status: "in_progress",
+          kind: "other",
+          content: [],
+          locations: [],
+          rawInput: {},
+        },
+      }),
+    );
+    assert.isFalse(
+      acpPostSettleContinuationOfferEvidence({
+        sessionId,
+        update: {
+          sessionUpdate: "tool_call_update",
+          toolCallId: "call-1",
+          title: "run_terminal_command",
+          status: "in_progress",
+          kind: "other",
+          content: [],
+          locations: [],
+          rawInput: {},
+        },
+      }),
+    );
+    assert.isFalse(
+      acpPostSettleContinuationOfferEvidence({
+        sessionId,
+        update: {
+          sessionUpdate: "tool_call",
+          toolCallId: "call-1",
+          title: "run_terminal_command",
+          status: "pending",
+          kind: "other",
+          content: [],
+          locations: [],
+          rawInput: {},
+        },
+      }),
+    );
+  });
+
+  it("does not offer filtered monitor chatter", () => {
+    assert.isFalse(
+      acpPostSettleContinuationOfferEvidence({
+        sessionId,
+        update: {
+          sessionUpdate: "agent_message_chunk",
+          content: {
+            type: "text",
+            text: 'Monitor "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee" ended',
+          },
+        },
+      }),
+    );
+  });
+
+  it("does not offer on a normalized monitor start ACK despite raw completed status", () => {
+    const monitorStartAck = {
+      sessionId,
+      update: {
+        sessionUpdate: "tool_call_update",
+        toolCallId: "call-monitor",
+        title: "Tool",
+        status: "completed",
+        kind: "other",
+        content: [],
+        locations: [],
+        rawInput: { variant: "Monitor", description: "stream test" },
+        rawOutput: {
+          type: "Monitor",
+          taskId: "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
+          timeoutMs: 60000,
+        },
+      },
+    } as const;
+    // Raw frame looks terminal; the Grok flavor knows it is a running monitor.
+    assert.isTrue(acpPostSettleContinuationOfferEvidence(monitorStartAck));
+    assert.isFalse(
+      acpPostSettleContinuationOfferEvidence(monitorStartAck, {
+        normalizeToolCall: normalizeXAiAcpToolCallState,
+      }),
+    );
+  });
+});
+
+describe("acpPostSettleWakeShouldBuffer", () => {
+  const sessionId = "session-wake-buffer";
+
+  it("drops agent progress chatter while background work is running", () => {
+    for (const sessionUpdate of ["agent_message_chunk", "agent_thought_chunk"] as const) {
+      assert.isFalse(
+        acpPostSettleWakeShouldBuffer(
+          {
+            sessionId,
+            update: {
+              sessionUpdate,
+              content: { type: "text", text: "Still running." },
+            },
+          },
+          true,
+        ),
+      );
+    }
+  });
+
+  it("retains tool state while running and agent output after completion", () => {
+    const agentMessage = {
+      sessionId,
+      update: {
+        sessionUpdate: "agent_message_chunk",
+        content: { type: "text", text: "Monitor finished successfully." },
+      },
+    } as const;
+    const toolUpdate = {
+      sessionId,
+      update: {
+        sessionUpdate: "tool_call_update",
+        toolCallId: "call-monitor",
+        title: "monitor",
+        status: "in_progress",
+        kind: "other",
+        content: [],
+        locations: [],
+        rawInput: {},
+      },
+    } as const;
+
+    assert.isTrue(acpPostSettleWakeShouldBuffer(toolUpdate, true));
+    assert.isTrue(acpPostSettleWakeShouldBuffer(agentMessage, false));
+  });
+});
+
+describe("acpIsAppOwnedWakeTurn", () => {
+  it("recognizes only the orchestrator-injected app-owned wake", () => {
+    // Delegated-child wake: must preserve this session's own wake frames.
+    assert.isTrue(acpIsAppOwnedWakeTurn({ createdBy: "agent", creationSource: "server" }));
+    // Provider-native continuation: handled by the continuation branch instead.
+    assert.isFalse(acpIsAppOwnedWakeTurn({ createdBy: "agent", creationSource: "provider" }));
+    // Real user turns still clear stale wake residue.
+    assert.isFalse(acpIsAppOwnedWakeTurn({ createdBy: "user", creationSource: "web" }));
+    assert.isFalse(acpIsAppOwnedWakeTurn({ createdBy: "user", creationSource: "mcp" }));
+    // A user-authored message never counts, whatever its surface.
+    assert.isFalse(acpIsAppOwnedWakeTurn({ createdBy: "user", creationSource: "server" }));
+  });
+});
+
+describe("acpPostSettleMonitorPromptShouldSuppress", () => {
+  it("suppresses running monitor prompts but not terminal notices", () => {
+    assert.isTrue(
+      acpPostSettleMonitorPromptShouldSuppress({ taskId: "task-active", status: "running" }),
+    );
+    assert.isFalse(
+      acpPostSettleMonitorPromptShouldSuppress({ taskId: "task-ended", status: "completed" }),
+    );
+    assert.isFalse(
+      acpPostSettleMonitorPromptShouldSuppress({ taskId: "task-failed", status: "failed" }),
+    );
+  });
+});
diff --git a/apps/server/src/orchestration-v2/Adapters/AcpAdapterV2.testkit.ts b/apps/server/src/orchestration-v2/Adapters/AcpAdapterV2.testkit.ts
new file mode 100644
index 000000000000..a1b481ed8195
--- /dev/null
+++ b/apps/server/src/orchestration-v2/Adapters/AcpAdapterV2.testkit.ts
@@ -0,0 +1,195 @@
+import {
+  ProviderDriverKind,
+  ProviderReplayEntry,
+  type ProviderReplayTranscript,
+} from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as Crypto from "effect/Crypto";
+import * as FileSystem from "effect/FileSystem";
+import * as Layer from "effect/Layer";
+import * as Schema from "effect/Schema";
+import type * as Scope from "effect/Scope";
+import { ChildProcessSpawner } from "effect/unstable/process";
+import * as EffectAcpErrors from "effect-acp/errors";
+
+import * as AcpSessionRuntime from "../../provider/acp/AcpSessionRuntime.ts";
+import { ACP_PROTOCOL, type AcpAdapterV2RuntimeInput } from "./AcpAdapterV2.ts";
+
+export const AcpReplayTranscript = Schema.Struct({
+  provider: ProviderDriverKind,
+  protocol: Schema.Literal(ACP_PROTOCOL),
+  version: Schema.String,
+  scenario: Schema.String,
+  metadata: Schema.optional(Schema.Record(Schema.String, Schema.Unknown)),
+  entries: Schema.Array(ProviderReplayEntry),
+});
+export type AcpReplayTranscript = typeof AcpReplayTranscript.Type;
+
+const decodeAcpReplayTranscriptSchema = Schema.decodeUnknownEffect(AcpReplayTranscript);
+
+export class AcpReplayTranscriptDecodeError extends Schema.TaggedErrorClass<AcpReplayTranscriptDecodeError>()(
+  "AcpReplayTranscriptDecodeError",
+  {
+    expectedProvider: ProviderDriverKind,
+    driver: Schema.optional(Schema.String),
+    protocol: Schema.optional(Schema.String),
+    scenario: Schema.optional(Schema.String),
+    cause: Schema.Defect(),
+  },
+) {
+  override get message(): string {
+    return `Failed to decode ${this.expectedProvider} ACP replay transcript for scenario ${this.scenario ?? "<unknown>"}.`;
+  }
+}
+
+const isAcpReplayTranscriptDecodeError = Schema.is(AcpReplayTranscriptDecodeError);
+
+function metadataFromTranscript(transcript: ProviderReplayTranscript): {
+  readonly provider?: string;
+  readonly protocol?: string;
+  readonly scenario?: string;
+} {
+  return {
+    provider: transcript.provider,
+    protocol: transcript.protocol,
+    scenario: transcript.scenario,
+  };
+}
+
+export function decodeAcpReplayTranscript(
+  transcript: ProviderReplayTranscript,
+  expectedProvider: ProviderDriverKind,
+  options: { readonly retargetProvider?: boolean } = {},
+): Effect.Effect<AcpReplayTranscript, AcpReplayTranscriptDecodeError> {
+  const candidate = options.retargetProvider
+    ? { ...transcript, provider: expectedProvider }
+    : transcript;
+  return decodeAcpReplayTranscriptSchema(candidate).pipe(
+    Effect.filterOrFail(
+      (decoded) => decoded.provider === expectedProvider,
+      () =>
+        new AcpReplayTranscriptDecodeError({
+          expectedProvider,
+          ...metadataFromTranscript(transcript),
+          cause: `Expected provider ${expectedProvider}, received ${transcript.provider}`,
+        }),
+    ),
+    Effect.mapError((cause) =>
+      isAcpReplayTranscriptDecodeError(cause)
+        ? cause
+        : new AcpReplayTranscriptDecodeError({
+            expectedProvider,
+            ...metadataFromTranscript(transcript),
+            cause,
+          }),
+    ),
+  );
+}
+
+interface ReplayStatus {
+  readonly cursor: number;
+  readonly total: number;
+  readonly failure?: unknown;
+}
+
+function decodeReplayStatus(raw: string): ReplayStatus {
+  const value: unknown = JSON.parse(raw);
+  if (
+    typeof value !== "object" ||
+    value === null ||
+    typeof Reflect.get(value, "cursor") !== "number" ||
+    typeof Reflect.get(value, "total") !== "number"
+  ) {
+    throw new Error("ACP replay status is malformed.");
+  }
+  return value as ReplayStatus;
+}
+
+export function makeAcpReplayCompletenessAssertion(
+  fileSystem: FileSystem.FileSystem,
+  statusPath: string,
+  transcript: AcpReplayTranscript,
+): Effect.Effect<void, EffectAcpErrors.AcpError> {
+  return fileSystem.readFileString(statusPath).pipe(
+    Effect.mapError(
+      (cause) =>
+        new EffectAcpErrors.AcpTransportError({
+          detail: `Failed to read ACP replay status for ${transcript.scenario}`,
+          cause,
+        }),
+    ),
+    Effect.flatMap((raw) =>
+      Effect.try({
+        try: () => decodeReplayStatus(raw),
+        catch: (cause) =>
+          new EffectAcpErrors.AcpTransportError({
+            detail: `Failed to decode ACP replay status for ${transcript.scenario}`,
+            cause,
+          }),
+      }),
+    ),
+    Effect.flatMap((status) => {
+      if (
+        status.failure === undefined &&
+        status.cursor === transcript.entries.length &&
+        status.total === transcript.entries.length
+      ) {
+        return Effect.void;
+      }
+      return Effect.fail(
+        new EffectAcpErrors.AcpTransportError({
+          detail: `ACP replay did not consume all frames for ${transcript.scenario}`,
+          cause: status,
+        }),
+      );
+    }),
+  );
+}
+
+export function acpReplayAgentArgs(scriptPath: string): ReadonlyArray<string> {
+  return ["--experimental-strip-types", scriptPath];
+}
+
+export function makeAcpReplayRuntime(input: {
+  readonly transcript: AcpReplayTranscript;
+  readonly statusPath: string;
+  readonly scriptPath: string;
+  readonly childProcessSpawner: ChildProcessSpawner.ChildProcessSpawner["Service"];
+}): (
+  runtimeInput: AcpAdapterV2RuntimeInput,
+) => Effect.Effect<
+  AcpSessionRuntime.AcpSessionRuntime["Service"],
+  EffectAcpErrors.AcpError,
+  Crypto.Crypto | Scope.Scope
+> {
+  const encodedTranscript = Buffer.from(JSON.stringify(input.transcript), "utf8").toString(
+    "base64",
+  );
+  return (runtimeInput) =>
+    Effect.gen(function* () {
+      const context = yield* Layer.build(
+        AcpSessionRuntime.layer({
+          ...runtimeInput,
+          spawn: {
+            command: process.execPath,
+            args: acpReplayAgentArgs(input.scriptPath),
+            cwd: runtimeInput.cwd,
+            env: {
+              ...process.env,
+              T3_ACP_REPLAY_TRANSCRIPT: encodedTranscript,
+              T3_ACP_REPLAY_STATUS_PATH: input.statusPath,
+              T3_ACP_REPLAY_WORKSPACE: runtimeInput.cwd,
+            },
+          },
+          authMethodId: "replay",
+        }).pipe(
+          Layer.provide(
+            Layer.succeed(ChildProcessSpawner.ChildProcessSpawner, input.childProcessSpawner),
+          ),
+        ),
+      );
+      return yield* Effect.service(AcpSessionRuntime.AcpSessionRuntime).pipe(
+        Effect.provide(context),
+      );
+    });
+}
diff --git a/apps/server/src/orchestration-v2/Adapters/AcpAdapterV2.ts b/apps/server/src/orchestration-v2/Adapters/AcpAdapterV2.ts
new file mode 100644
index 000000000000..28b36fe3ea61
--- /dev/null
+++ b/apps/server/src/orchestration-v2/Adapters/AcpAdapterV2.ts
@@ -0,0 +1,6170 @@
+// @effect-diagnostics nodeBuiltinImport:off
+import * as NodeFS from "node:fs";
+import * as NodePath from "node:path";
+
+import {
+  type ChatAttachment,
+  type ModelSelection,
+  type OrchestrationV2ConversationMessage,
+  type OrchestrationV2ExecutionNode,
+  type OrchestrationV2PlanArtifact,
+  type OrchestrationV2PlanStep,
+  type OrchestrationV2ProviderCapabilities,
+  type OrchestrationV2ProviderFailure,
+  type OrchestrationV2ProviderSession,
+  type OrchestrationV2ProviderThread,
+  type OrchestrationV2ProviderTurn,
+  type OrchestrationV2RuntimeRequest,
+  type OrchestrationV2Subagent,
+  type OrchestrationV2TurnItem,
+  type OrchestrationV2UserInputQuestion,
+  type ProviderApprovalDecision,
+  type ProviderInstanceId,
+  type ProviderDriverKind,
+  type ProviderRequestKind,
+  type ProviderThreadId,
+  type ProviderUserInputAnswers,
+  type RuntimeRequestId,
+  type ThreadId,
+} from "@t3tools/contracts";
+import { modelSelectionsEqual } from "@t3tools/shared/model";
+import * as Cause from "effect/Cause";
+import * as Crypto from "effect/Crypto";
+import * as DateTime from "effect/DateTime";
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as FileSystem from "effect/FileSystem";
+import * as Fiber from "effect/Fiber";
+import * as Option from "effect/Option";
+import * as Queue from "effect/Queue";
+import * as Ref from "effect/Ref";
+import * as Scope from "effect/Scope";
+import * as Semaphore from "effect/Semaphore";
+import * as Stream from "effect/Stream";
+import * as EffectAcpErrors from "effect-acp/errors";
+import type * as EffectAcpSchema from "effect-acp/schema";
+
+import { resolveAttachmentPath } from "../../attachmentStore.ts";
+import { ServerConfig } from "../../config.ts";
+import * as McpProviderSession from "../../mcp/McpProviderSession.ts";
+import {
+  mergeToolCallState,
+  parsePermissionRequest,
+  parseSessionUpdateEvent,
+  type AcpPlanUpdate,
+  type AcpToolCallState,
+} from "../../provider/acp/AcpRuntimeModel.ts";
+import type {
+  AcpSessionRuntimeOptions,
+  AcpSessionRuntimeStartResult,
+} from "../../provider/acp/AcpSessionRuntime.ts";
+import * as AcpSessionRuntime from "../../provider/acp/AcpSessionRuntime.ts";
+import { t3OrchestrationPromptForFirstRun } from "../../provider/T3OrchestrationInstructions.ts";
+import { IdAllocatorV2, type IdAllocatorV2Shape } from "../IdAllocator.ts";
+import { type ProviderContinuationRequest } from "../ProviderContinuationRequests.ts";
+import { makeProviderFailure } from "../ProviderFailure.ts";
+import { acpSelectionTransition } from "../ProviderSelectionTransition.ts";
+import {
+  isProviderNativeImageAttachment,
+  providerMessageTextWithAttachmentPaths,
+} from "../AttachmentPrompt.ts";
+import {
+  makeSubagentChildThread,
+  makeSubagentConversationArtifacts,
+  subagentThreadTitle,
+} from "../SubagentProjection.ts";
+import {
+  ProviderAdapterEnsureThreadError,
+  ProviderAdapterForkThreadError,
+  ProviderAdapterInterruptError,
+  ProviderAdapterOpenSessionError,
+  ProviderAdapterProtocolError,
+  ProviderAdapterReadThreadSnapshotError,
+  ProviderAdapterResumeThreadError,
+  ProviderAdapterRollbackThreadError,
+  ProviderAdapterRuntimeRequestResponseError,
+  ProviderAdapterSteerRunUnsupportedError,
+  ProviderAdapterTurnStartError,
+  ProviderAdapterV2,
+  type ProviderAdapterV2EnsureThreadInput,
+  type ProviderAdapterV2Event,
+  type ProviderAdapterV2InterruptInput,
+  type ProviderAdapterV2OpenSessionInput,
+  type ProviderAdapterV2RuntimePolicy,
+  type ProviderAdapterV2SessionRuntime,
+  type ProviderAdapterV2Shape,
+  type ProviderAdapterV2TurnInput,
+} from "../ProviderAdapter.ts";
+
+export const ACP_PROTOCOL = "acp.ndjson-jsonrpc" as const;
+
+export interface AcpAdapterV2RuntimeInput {
+  readonly cwd: string;
+  readonly mcpServers: ReadonlyArray<EffectAcpSchema.McpServer>;
+  readonly interruptPromptOnCancel?: boolean;
+  readonly clientCapabilities: EffectAcpSchema.InitializeRequest["clientCapabilities"];
+  readonly clientInfo: AcpSessionRuntimeOptions["clientInfo"];
+  readonly requestLogger?: NonNullable<AcpSessionRuntimeOptions["requestLogger"]>;
+  readonly protocolLogging: NonNullable<AcpSessionRuntimeOptions["protocolLogging"]>;
+  readonly onIncomingRequest?: AcpSessionRuntimeOptions["onIncomingRequest"];
+  readonly onTermination: NonNullable<AcpSessionRuntimeOptions["onTermination"]>;
+  readonly onOutgoingResponseFailure?: AcpSessionRuntimeOptions["onOutgoingResponseFailure"];
+  readonly onOutgoingResponse?: AcpSessionRuntimeOptions["onOutgoingResponse"];
+}
+
+export type AcpAdapterV2NativeLogging = Pick<
+  AcpSessionRuntimeOptions,
+  "requestLogger" | "protocolLogging"
+>;
+
+export interface AcpAdapterV2UserInputRequest {
+  readonly nativeItemId: string;
+  readonly nativeMethod?: string;
+  readonly nativeRequestId: string;
+  readonly nativeSessionId?: string;
+  readonly questions: ReadonlyArray<OrchestrationV2UserInputQuestion>;
+}
+
+export interface AcpAdapterV2ExtensionContext {
+  readonly runtime: AcpSessionRuntime.AcpSessionRuntime["Service"];
+  /**
+   * Session-scoped background-task lifecycle reported via extension
+   * notifications (e.g. Grok `x.ai/task_backgrounded`; older builds use the
+   * underscore alias). Mutations for non-root sessions are ignored.
+   */
+  readonly applyBackgroundTaskMutation: (mutation: {
+    readonly sessionId: string;
+    readonly taskId: string;
+    readonly status: "running" | "completed" | "failed";
+  }) => Effect.Effect<void>;
+  readonly requestUserInput: (input: AcpAdapterV2UserInputRequest) => Effect.Effect<
+    {
+      readonly acknowledgeNativeResponse: Effect.Effect<void, EffectAcpErrors.AcpError>;
+      readonly answers: ProviderUserInputAnswers | null;
+    },
+    EffectAcpErrors.AcpError
+  >;
+  /** Surfaces plan markdown as this turn's proposed-plan card (#8358). */
+  readonly captureProposedPlan: (input: { readonly planMarkdown: string }) => Effect.Effect<void>;
+  /** Last markdown captured for the active turn, as the exit-gate fallback. */
+  readonly lastProposedPlanMarkdown: Effect.Effect<string | undefined>;
+}
+
+export interface AcpRootTurnIdleSnapshot {
+  readonly finalized: boolean;
+  readonly interrupted: boolean;
+  readonly assistantStreamOpen: boolean;
+  readonly reasoningStreamOpen: boolean;
+  readonly hasRunningTool: boolean;
+  readonly hasPendingRuntimeRequest: boolean;
+  readonly hasToolHistory: boolean;
+  readonly hasActiveSubagent: boolean;
+  readonly hasOutput: boolean;
+}
+
+/**
+ * Debounce used if a flavor re-enables speculative idle settlement.
+ * Kept for tests and future root-matched recovery; Grok no longer idle-settles.
+ */
+export const acpRootTurnSettleDebounceMs = 2_000;
+
+/** Let trailing root session chunks land before terminalizing a settled turn. */
+export const acpRootTurnCompletionDrainMs = 100;
+
+/**
+ * True when root-session streaming is quiescent enough for speculative settle.
+ *
+ * Always false today: settling on "assistant text then quiet" over-settles Grok
+ * preamble-before-tools turns, and settling after tools drops later tool waves
+ * while `session/prompt` is still open. Terminalize from the prompt RPC (or a
+ * future root-matched completion signal), not from local silence.
+ */
+export function acpRootTurnIsIdle(snapshot: AcpRootTurnIdleSnapshot): boolean {
+  if (snapshot.finalized || snapshot.interrupted) return false;
+  if (snapshot.assistantStreamOpen || snapshot.reasoningStreamOpen) return false;
+  if (snapshot.hasRunningTool || snapshot.hasPendingRuntimeRequest) return false;
+  if (snapshot.hasActiveSubagent) return false;
+  if (!snapshot.hasOutput) return false;
+  // Structural gates above stay for unit tests / future re-enable. Speculative
+  // idle completion is intentionally disabled.
+  return false;
+}
+
+/** True when idle settle should be (re-)scheduled after pending runtime work clears. */
+export function acpRootTurnShouldRearmRecoveryTimers(context: {
+  readonly finalized: boolean;
+  readonly interrupted: boolean;
+}): boolean {
+  return !context.finalized && !context.interrupted;
+}
+
+export interface AcpAdapterV2Flavor {
+  readonly driver: ProviderDriverKind;
+  readonly capabilities: OrchestrationV2ProviderCapabilities;
+  readonly makeRuntime: (
+    input: AcpAdapterV2RuntimeInput,
+  ) => Effect.Effect<
+    AcpSessionRuntime.AcpSessionRuntime["Service"],
+    EffectAcpErrors.AcpError,
+    Crypto.Crypto | Scope.Scope
+  >;
+  readonly resolveModelId?: (selection: ModelSelection) => string | undefined;
+  readonly registerExtensions?: (
+    context: AcpAdapterV2ExtensionContext,
+  ) => Effect.Effect<void, EffectAcpErrors.AcpError>;
+  readonly extractSubagentUpdate?: (
+    toolCall: AcpToolCallState,
+  ) => AcpAdapterV2SubagentUpdate | undefined;
+  /**
+   * Optional Grok-style rewrite before tool projection (e.g. keep monitor start
+   * ACKs in the running state until stream end).
+   */
+  readonly normalizeToolCall?: (toolCall: AcpToolCallState) => AcpToolCallState;
+  /**
+   * Optional plan-file sniffing (#8358): providers that write their proposed
+   * plan to a file mid-turn (Grok plan.md) return its markdown from a tool
+   * call so T3 can show the proposed-plan card while plan mode is active.
+   */
+  readonly extractProposedPlanMarkdown?: (toolCall: AcpToolCallState) => string | undefined;
+  /**
+   * Optional mapping from a long-lived background tool start ACK to a task id
+   * (e.g. monitor task uuid) so later synthetic text events can update it.
+   */
+  readonly extractBackgroundTaskId?: (toolCall: AcpToolCallState) => string | undefined;
+  /**
+   * Optional parse of root-session synthetic text (monitor-event lines, monitor
+   * ended reminders). Returns every task mutation in the chunk so coalesced
+   * progress / end notices are not dropped.
+   */
+  readonly extractBackgroundToolMutation?: (text: string) => ReadonlyArray<{
+    readonly taskId: string;
+    readonly status: "running" | "completed" | "failed";
+    readonly appendOutput: string;
+  }>;
+  /**
+   * Optional parse of root-session synthetic text announcing a background
+   * subagent's end ("Background subagent "<uuid>" ... completed successfully").
+   * Older builds may never hydrate via get_command_or_subagent_output, so this
+   * remains a terminal fallback. Current Grok additionally emits structured
+   * `subagent_finished` session notifications.
+   */
+  readonly extractSubagentEndNotice?: (text: string) =>
+    | {
+        readonly childSessionId: string;
+        readonly status: "completed" | "failed";
+      }
+    | undefined;
+  /**
+   * Optional hydration when a later tool (e.g. get_command TaskOutput) completes
+   * previously registered background task id(s).
+   */
+  readonly extractBackgroundTaskCompletion?: (toolCall: AcpToolCallState) => ReadonlyArray<{
+    readonly taskId: string;
+    readonly status: "running" | "completed" | "failed";
+    readonly appendOutput: string;
+  }>;
+  /**
+   * Persistent monitors (e.g. Grok `persistent: true`) should not hold root-turn
+   * deferred finalize open forever. Still tracked for post-settle wake.
+   */
+  readonly isPersistentBackgroundTool?: (toolCall: AcpToolCallState) => boolean;
+  /**
+   * When true, keep the active turn open after session/prompt returns while
+   * background tools/subagents are still running so later monitor/wake traffic
+   * can project (Grok monitors finish after the root prompt settles).
+   */
+  readonly deferFinalizeForBackgroundWork?: boolean;
+  readonly assertComplete?: Effect.Effect<void, EffectAcpErrors.AcpError>;
+  /**
+   * When true, schedule speculative local settlement after root session
+   * quiet. Disabled for Grok: short idle windows over-settle preamble-before-
+   * tools turns and `session/cancel` from that path freezes projection while
+   * the agent keeps working. Prefer `session/prompt` return (or a future
+   * root-matched terminal signal).
+   */
+  readonly settleRootTurnWhenIdle?: boolean;
+  /** Interrupt the local prompt fiber before `session/cancel` (Grok wedged prompts). */
+  readonly interruptPromptOnCancel?: boolean;
+  /**
+   * Kill and respawn the ACP child process before the next `session/prompt` after a
+   * user interrupt. Grok can keep `task_already_running` state until the process exits.
+   */
+  readonly restartRuntimeAfterInterrupt?: boolean;
+  /**
+   * When true, every interrupt restarts the runtime, not just those carrying
+   * `requestRuntimeRestart` (user Stop). Leave unset to keep non-Stop
+   * interrupts (steering, restart_active) soft: `session/cancel` plus session
+   * reuse in the same process.
+   */
+  readonly restartRuntimeOnEveryInterrupt?: boolean;
+  readonly terminateRuntimeProcessGroupOnInterrupt?: boolean;
+  /**
+   * When true, an interrupt without `requestRuntimeRestart` (steering restart)
+   * on a turn whose native prompt already settled skips the hard process-group
+   * kill, the ACP cancel, and the runtime respawn entirely: the turn
+   * terminalizes locally while background subagents keep running in the same
+   * process and carry over into the replacement turn. Verified against the
+   * real Grok CLI (tmp/grok-acp-experiments E1): a new session/prompt is
+   * accepted concurrently while a fire-and-forget subagent is still running,
+   * with no task_already_running. User Stop (`requestRuntimeRestart: true`)
+   * keeps the hard teardown; mid-prompt non-Stop interrupts go soft
+   * (`session/cancel` plus same-session re-prompt) unless
+   * `restartRuntimeOnEveryInterrupt` is set.
+   */
+  readonly preserveRuntimeOnSettledInterrupt?: boolean;
+  /**
+   * When true (with continuationRequests), post-settle root session/update traffic
+   * buffers and requests a provider continuation run instead of being dropped or
+   * only appended to loaded history.
+   */
+  readonly enablePostSettleContinuation?: boolean;
+  /**
+   * When true, send image attachment content blocks even if the ACP agent
+   * advertises `promptCapabilities.image: false`. Grok CLI currently accepts
+   * and vision-processes image blocks while still reporting the capability as
+   * false; without this override, screenshot turns fail before `session/prompt`.
+   */
+  readonly supportsImagePrompts?: boolean;
+}
+
+/** Whether image attachment blocks may be included in session/prompt. */
+export function acpSupportsImagePrompts(input: {
+  readonly flavorSupportsImagePrompts?: boolean | undefined;
+  readonly negotiatedImage?: boolean | undefined;
+}): boolean {
+  return input.flavorSupportsImagePrompts === true || input.negotiatedImage === true;
+}
+
+export interface AcpAdapterV2SubagentUpdate {
+  readonly nativeTaskId: string;
+  readonly prompt: string;
+  readonly title: string | null;
+  readonly model: string | null;
+  readonly status: "pending" | "running" | "completed" | "failed" | "interrupted" | "cancelled";
+  readonly childSessionId: string | null;
+  readonly result: string | null;
+  /**
+   * When false, still project a normal tool turn item after the subagent update
+   * (hydration tools like get_command_or_subagent_output). Defaults to true.
+   */
+  readonly suppressNormalTool?: boolean;
+}
+
+export interface AcpAdapterV2Options {
+  readonly instanceId: ProviderInstanceId;
+  readonly flavor: AcpAdapterV2Flavor;
+  readonly crypto: Crypto.Crypto;
+  readonly fileSystem: FileSystem.FileSystem;
+  readonly idAllocator: IdAllocatorV2Shape;
+  readonly serverConfig: ServerConfig["Service"];
+  readonly nativeLogging?: (threadId: ThreadId) => AcpAdapterV2NativeLogging;
+  /**
+   * Shared with ProviderContinuationService so post-settle wake traffic can start
+   * a continuation run. Optional: adapters that omit it keep pre-continuation drop
+   * / history-only behavior for null-activeTurn updates.
+   */
+  readonly continuationRequests?: {
+    readonly offer: (request: ProviderContinuationRequest) => Effect.Effect<void>;
+  };
+  readonly testHooks?: {
+    readonly afterNativeResponseTransportClosed?: () => Effect.Effect<void>;
+    readonly afterHardTeardownTransportDrained?: () => Effect.Effect<void>;
+    readonly beforeNativeResponseAdmissionCheck?: (
+      generation: number,
+      requestId: string,
+    ) => Effect.Effect<void>;
+    readonly onNativeResponseLifecycle?: (event: {
+      readonly generation?: number;
+      readonly requestId?: string;
+      readonly type:
+        | "admission_rejected"
+        | "failed"
+        | "late_noop"
+        | "registered"
+        | "removed"
+        | "timer_exited"
+        | "timer_started"
+        | "watcher_exited"
+        | "watcher_started";
+    }) => Effect.Effect<void>;
+  };
+}
+
+export const AcpProviderCapabilitiesV2 = {
+  sessions: {
+    supportsMultipleProviderThreadsPerSession: false,
+    supportsModelSwitchInSession: false,
+    supportsProviderSwitchingViaHandoff: true,
+    supportsRuntimeModeSwitchInSession: false,
+    pendingRequestsSurviveRestart: false,
+  },
+  threads: {
+    canCreateEmptyThread: true,
+    canReadThreadSnapshot: false,
+    canRollbackThread: false,
+    canForkThread: false,
+    canForkFromTurn: false,
+    canForkFromSubagentThread: false,
+    exposesNativeThreadId: true,
+  },
+  turns: {
+    exposesNativeTurnId: false,
+    emitsTurnStarted: true,
+    emitsTurnCompleted: true,
+    supportsInterrupt: true,
+    supportsActiveSteering: false,
+    supportsSteeringByInterruptRestart: true,
+    supportsQueuedMessages: true,
+    terminalStatusQuality: "strong",
+  },
+  streaming: {
+    streamsAssistantText: true,
+    streamsReasoning: true,
+    streamsToolOutput: true,
+    streamsPlanText: false,
+    emitsMessageCompleted: true,
+  },
+  tools: {
+    exposesToolItemIds: true,
+    emitsToolStarted: true,
+    emitsToolCompleted: true,
+    emitsToolOutput: true,
+    supportsMcpTools: false,
+    supportsDynamicToolCallbacks: false,
+  },
+  approvals: {
+    supportsCommandApproval: true,
+    supportsFileReadApproval: true,
+    supportsFileChangeApproval: true,
+    supportsApplyPatchApproval: false,
+    approvalsHaveNativeRequestIds: false,
+    approvalCallbacksAreLiveOnly: true,
+    approvalsCanOriginateFromSubagents: false,
+  },
+  planning: {
+    emitsPlanUpdated: true,
+    emitsTodoList: true,
+    emitsProposedPlan: false,
+    supportsStructuredQuestions: true,
+    planDeltasHaveItemIds: false,
+  },
+  subagents: {
+    supportsSubagents: false,
+    exposesSubagentThreadIds: false,
+    emitsSubagentLifecycle: false,
+    canWaitForSubagents: false,
+    canCloseSubagents: false,
+    canForkSubagentThread: false,
+  },
+  context: {
+    acceptsSystemContext: false,
+    acceptsDeveloperContext: false,
+    acceptsSyntheticUserContext: true,
+    canGenerateSummaries: true,
+    canConsumeHandoffSummaries: true,
+    supportsDeltaHandoff: true,
+    supportsFullThreadHandoff: true,
+    maxRecommendedHandoffChars: null,
+  },
+  checkpointing: {
+    appCanCheckpointFilesystem: true,
+    supportsNestedCheckpointScopes: true,
+    providerCanRollbackConversation: false,
+    providerRollbackReturnsSnapshot: false,
+    providerCanReadConversationSnapshot: false,
+  },
+  identity: {
+    nativeThreadIds: "strong",
+    nativeTurnIds: "weak",
+    nativeItemIds: "weak",
+    nativeRequestIds: "weak",
+  },
+} satisfies OrchestrationV2ProviderCapabilities;
+
+function negotiatedCapabilities(
+  base: OrchestrationV2ProviderCapabilities,
+  started: AcpSessionRuntimeStartResult,
+): OrchestrationV2ProviderCapabilities {
+  const agent = started.initializeResult.agentCapabilities ?? {};
+  const session = agent.sessionCapabilities;
+  const setup = started.sessionSetupResult;
+  const hasModelConfig =
+    setup.configOptions?.some((option) => option.category === "model") === true;
+  const supportsMcp = agent.mcpCapabilities?.http === true || agent.mcpCapabilities?.sse === true;
+  const canLoad = agent.loadSession === true;
+  const canFork = session?.fork != null;
+  return {
+    ...base,
+    sessions: {
+      ...base.sessions,
+      supportsModelSwitchInSession: setup.models != null || hasModelConfig,
+    },
+    threads: {
+      ...base.threads,
+      canReadThreadSnapshot: canLoad,
+      canForkThread: canFork,
+      canForkFromTurn: false,
+    },
+    tools: {
+      ...base.tools,
+      supportsMcpTools: supportsMcp,
+    },
+    checkpointing: {
+      ...base.checkpointing,
+      providerCanReadConversationSnapshot: canLoad,
+    },
+  };
+}
+
+function acpMcpServers(threadId: ThreadId | null): ReadonlyArray<EffectAcpSchema.McpServer> {
+  if (threadId === null) return [];
+  const session = McpProviderSession.readMcpProviderSession(threadId);
+  if (session === undefined) {
+    return [];
+  }
+  return [
+    {
+      type: "http",
+      name: "t3-code",
+      url: session.endpoint,
+      headers: [
+        {
+          name: "Authorization",
+          value: session.authorizationHeader,
+        },
+      ],
+    },
+  ];
+}
+
+function nativeThreadId(
+  driver: ProviderDriverKind,
+  thread: OrchestrationV2ProviderThread,
+): Effect.Effect<string, ProviderAdapterProtocolError> {
+  const id = thread.nativeThreadRef?.nativeId;
+  if (id === null || id === undefined || id.trim().length === 0) {
+    return Effect.fail(
+      new ProviderAdapterProtocolError({
+        driver,
+        detail: `Provider thread ${thread.id} is missing its ACP session id`,
+      }),
+    );
+  }
+  return Effect.succeed(id);
+}
+
+function makeProviderThread(input: {
+  readonly driver: ProviderDriverKind;
+  readonly providerInstanceId: ProviderInstanceId;
+  readonly idAllocator: IdAllocatorV2Shape;
+  readonly appThreadId: OrchestrationV2ProviderThread["appThreadId"];
+  readonly providerSessionId: OrchestrationV2ProviderThread["providerSessionId"];
+  readonly nativeThreadId: string;
+  readonly ownerNodeId?: OrchestrationV2ProviderThread["ownerNodeId"];
+  readonly forkedFrom?: OrchestrationV2ProviderThread["forkedFrom"];
+  readonly now: DateTime.Utc;
+}): OrchestrationV2ProviderThread {
+  return {
+    id: input.idAllocator.derive.providerThread({
+      driver: input.driver,
+      nativeThreadId: input.nativeThreadId,
+    }),
+    driver: input.driver,
+    providerInstanceId: input.providerInstanceId,
+    providerSessionId: input.providerSessionId,
+    appThreadId: input.appThreadId,
+    ownerNodeId: input.ownerNodeId ?? null,
+    nativeThreadRef: {
+      driver: input.driver,
+      nativeId: input.nativeThreadId,
+      strength: "strong",
+    },
+    nativeConversationHeadRef: null,
+    status: "idle",
+    firstRunOrdinal: null,
+    lastRunOrdinal: null,
+    handoffIds: [],
+    forkedFrom: input.forkedFrom ?? null,
+    createdAt: input.now,
+    updatedAt: input.now,
+  };
+}
+
+function unknownRecord(value: unknown): Record<string, unknown> | undefined {
+  return typeof value === "object" && value !== null && !Array.isArray(value)
+    ? (value as Record<string, unknown>)
+    : undefined;
+}
+
+export function acpCanonicalJson(value: unknown): string {
+  if (Array.isArray(value)) {
+    return `[${value.map(acpCanonicalJson).join(",")}]`;
+  }
+  const record = unknownRecord(value);
+  if (record !== undefined) {
+    return `{${Object.keys(record)
+      .toSorted()
+      .map((key) => `${JSON.stringify(key)}:${acpCanonicalJson(record[key])}`)
+      .join(",")}}`;
+  }
+  return JSON.stringify(value) ?? "undefined";
+}
+
+export function acpNativeUserInputRequestMatches(
+  request: Pick<
+    AcpAdapterV2UserInputRequest,
+    "nativeMethod" | "nativeRequestId" | "nativeSessionId"
+  >,
+  transport: { readonly method: string; readonly payload: unknown },
+): boolean {
+  if (
+    request.nativeMethod === undefined ||
+    request.nativeMethod.trim().length === 0 ||
+    request.nativeRequestId.trim().length === 0 ||
+    request.nativeSessionId === undefined ||
+    request.nativeSessionId.trim().length === 0
+  ) {
+    return false;
+  }
+  if (
+    transport.method !== "x.ai/ask_user_question" &&
+    transport.method !== "_x.ai/ask_user_question"
+  ) {
+    return false;
+  }
+  if (transport.method !== request.nativeMethod) {
+    return false;
+  }
+  const payloadRecord = unknownRecord(transport.payload);
+  const paramsRecord = unknownRecord(payloadRecord?.params) ?? payloadRecord;
+  return (
+    paramsRecord?.toolCallId !== undefined &&
+    String(paramsRecord.toolCallId).trim().length > 0 &&
+    String(paramsRecord.toolCallId) === request.nativeRequestId &&
+    paramsRecord.sessionId !== undefined &&
+    String(paramsRecord.sessionId).trim().length > 0 &&
+    String(paramsRecord.sessionId) === request.nativeSessionId
+  );
+}
+
+export function acpClaimNativeTransportRequest<
+  T extends {
+    readonly generation: number;
+    readonly requestId: string;
+    readonly sequence: number;
+  },
+>(
+  requests: ReadonlyArray<T>,
+  generation: number,
+  predicate: (request: T) => boolean,
+): readonly [string | undefined, Array<T>] {
+  let claimedIndex = -1;
+  let claimedSequence = Number.POSITIVE_INFINITY;
+  for (let index = 0; index < requests.length; index += 1) {
+    const request = requests[index]!;
+    if (
+      request.generation === generation &&
+      request.sequence < claimedSequence &&
+      predicate(request)
+    ) {
+      claimedIndex = index;
+      claimedSequence = request.sequence;
+    }
+  }
+  if (claimedIndex < 0) return [undefined, [...requests]];
+  return [
+    requests[claimedIndex]!.requestId,
+    [...requests.slice(0, claimedIndex), ...requests.slice(claimedIndex + 1)],
+  ];
+}
+
+function nonEmptyText(value: unknown, fallback: string): string {
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : fallback;
+}
+
+function decodeByteText(value: unknown): string | undefined {
+  if (!Array.isArray(value) || value.length === 0) return undefined;
+  if (!value.every((entry) => typeof entry === "number" && Number.isInteger(entry))) {
+    return undefined;
+  }
+  try {
+    // Preserve leading/trailing whitespace like the string path in textFromUnknown.
+    const text = new TextDecoder().decode(Uint8Array.from(value as number[]));
+    return text.length > 0 ? text : undefined;
+  } catch {
+    return undefined;
+  }
+}
+
+function textFromUnknown(value: unknown): string | undefined {
+  if (typeof value === "string") {
+    return value;
+  }
+  const fromBytes = decodeByteText(value);
+  if (fromBytes !== undefined) {
+    return fromBytes;
+  }
+  if (Array.isArray(value)) {
+    const parts = value.flatMap((entry) => {
+      const text = textFromUnknown(entry);
+      return text === undefined || text.length === 0 ? [] : [text];
+    });
+    return parts.length === 0 ? undefined : parts.join("\n");
+  }
+  const record = unknownRecord(value);
+  if (record === undefined) {
+    return undefined;
+  }
+  // Prefer prompt-facing Grok fields before nested envelopes.
+  for (const key of [
+    "output_for_prompt",
+    "stdout",
+    "stderr",
+    "output",
+    "content",
+    "text",
+    "message",
+  ]) {
+    const direct = record[key];
+    if (typeof direct === "string" && direct.length > 0) {
+      return direct;
+    }
+    const decoded = decodeByteText(direct);
+    if (decoded !== undefined) {
+      return decoded;
+    }
+    const text = textFromUnknown(direct);
+    if (text !== undefined && text.length > 0) {
+      return text;
+    }
+  }
+  const result = unknownRecord(record.Result) ?? unknownRecord(record.result);
+  if (result !== undefined) {
+    return textFromUnknown(result);
+  }
+  return undefined;
+}
+
+function commandExitCode(value: unknown): number | undefined {
+  const record = unknownRecord(value);
+  for (const key of ["exitCode", "exit_code", "code"]) {
+    const candidate = record?.[key];
+    if (typeof candidate === "number" && Number.isInteger(candidate)) {
+      return candidate;
+    }
+  }
+  return undefined;
+}
+
+/**
+ * Project an exit code only when the tool has a terminal native status.
+ * Mid-stream Grok Bash re-reports carry exit_code 0 while still in progress;
+ * interrupted tools must not retain that stale success code.
+ */
+export function acpProjectedCommandExitCode(
+  status: "pending" | "running" | "completed" | "failed" | "interrupted",
+  rawOutput: unknown,
+): number | undefined {
+  if (status !== "completed" && status !== "failed") {
+    return undefined;
+  }
+  return commandExitCode(rawOutput);
+}
+
+function pathFromToolCall(toolCall: AcpToolCallState): string | undefined {
+  const locations = toolCall.data.locations;
+  if (Array.isArray(locations)) {
+    for (const location of locations) {
+      const path = unknownRecord(location)?.path;
+      if (typeof path === "string" && path.trim().length > 0) {
+        return path.trim();
+      }
+    }
+  }
+  const rawInput = unknownRecord(toolCall.data.rawInput);
+  for (const key of ["path", "filePath", "file_path", "url", "query", "pattern"]) {
+    const candidate = rawInput?.[key];
+    if (typeof candidate === "string" && candidate.trim().length > 0) {
+      return candidate.trim();
+    }
+  }
+  return undefined;
+}
+
+function providerRequestKind(kind: string | "unknown"): ProviderRequestKind {
+  switch (kind) {
+    case "execute":
+      return "command";
+    case "read":
+    case "search":
+    case "fetch":
+      return "file-read";
+    case "edit":
+    case "delete":
+    case "move":
+      return "file-change";
+    default:
+      return "command";
+  }
+}
+
+function toolStatus(
+  status: AcpToolCallState["status"],
+): "pending" | "running" | "completed" | "failed" {
+  switch (status) {
+    case "completed":
+      return "completed";
+    case "failed":
+      return "failed";
+    case "pending":
+      return "pending";
+    default:
+      return "running";
+  }
+}
+
+type ProjectedToolStatus = ReturnType<typeof toolStatus> | "interrupted";
+
+function nodeStatus(status: ProjectedToolStatus): OrchestrationV2ExecutionNode["status"] {
+  return status === "pending" ? "running" : status;
+}
+
+function completedAtForStatus(status: ProjectedToolStatus, now: DateTime.Utc): DateTime.Utc | null {
+  return status === "completed" || status === "failed" || status === "interrupted" ? now : null;
+}
+
+function selectPermissionOptionId(
+  request: EffectAcpSchema.RequestPermissionRequest,
+  decision: Exclude<ProviderApprovalDecision, "cancel">,
+): string | undefined {
+  const kind =
+    decision === "acceptForSession"
+      ? "allow_always"
+      : decision === "accept"
+        ? "allow_once"
+        : "reject_once";
+  return request.options.find((option) => option.kind === kind)?.optionId.trim() || undefined;
+}
+
+function selectAutoApprovedPermissionOption(
+  request: EffectAcpSchema.RequestPermissionRequest,
+): string | undefined {
+  return (
+    selectPermissionOptionId(request, "acceptForSession") ??
+    selectPermissionOptionId(request, "accept")
+  );
+}
+
+export type AcpPermissionDisposition = "allow" | "ask" | "deny";
+
+function resolveAcpPermissionPath(path: string, cwd: string | null): string | undefined {
+  const trimmed = path.trim();
+  if (trimmed.length === 0) return undefined;
+  if (NodePath.isAbsolute(trimmed)) return trimmed;
+  if (cwd === null || cwd.trim().length === 0) return undefined;
+  return `${cwd}${cwd.endsWith(NodePath.sep) ? "" : NodePath.sep}${trimmed}`;
+}
+
+function acpPathIsWithinRoot(path: string, root: string): boolean {
+  const relative = NodePath.relative(root, path);
+  return (
+    relative === "" ||
+    (relative !== ".." &&
+      !relative.startsWith(`..${NodePath.sep}`) &&
+      !NodePath.isAbsolute(relative))
+  );
+}
+
+/**
+ * Canonicalize a path for an authorization containment check.
+ *
+ * `realpath` cannot resolve a file that has not been created yet, so walk up
+ * to the deepest existing ancestor and append the missing suffix to that
+ * ancestor's canonical path. This follows symlinked directories while still
+ * allowing normal writes to new files. If an existing entry cannot be
+ * canonicalized (for example, a broken symlink), fail closed.
+ */
+function acpCanonicalPathForContainment(path: string): string | undefined {
+  // Do not lexically normalize before realpath. For a path such as
+  // `workspace/link/../file`, the kernel resolves `link` before `..`; an
+  // eager NodePath.resolve would erase that symlink traversal and could turn
+  // an outside target into an apparently in-workspace path.
+  let candidate = path;
+  const missingSuffix: Array<string> = [];
+
+  while (true) {
+    try {
+      return NodePath.resolve(NodeFS.realpathSync.native(candidate), ...missingSuffix);
+    } catch (cause) {
+      if ((cause as NodeJS.ErrnoException | undefined)?.code !== "ENOENT") {
+        return undefined;
+      }
+    }
+
+    try {
+      NodeFS.lstatSync(candidate);
+      // The entry exists but realpath could not resolve it, as with a broken
+      // symlink. Treat it as untrusted rather than authorizing its lexical path.
+      return undefined;
+    } catch (cause) {
+      if ((cause as NodeJS.ErrnoException | undefined)?.code !== "ENOENT") {
+        return undefined;
+      }
+    }
+
+    const parent = NodePath.dirname(candidate);
+    if (parent === candidate) return undefined;
+    missingSuffix.unshift(NodePath.basename(candidate));
+    candidate = parent;
+  }
+}
+
+function acpWorkspaceWriteAllowsMutation(
+  runtimePolicy: ProviderAdapterV2RuntimePolicy,
+  sandboxPolicy: Record<string, unknown>,
+  request: EffectAcpSchema.RequestPermissionRequest,
+): boolean {
+  const cwd =
+    typeof runtimePolicy.cwd === "string" && runtimePolicy.cwd.trim().length > 0
+      ? (resolveAcpPermissionPath(runtimePolicy.cwd, process.cwd()) ?? null)
+      : null;
+  const roots: Array<string> = [];
+  if (cwd !== null) {
+    const canonicalCwd = acpCanonicalPathForContainment(cwd);
+    if (canonicalCwd !== undefined) roots.push(canonicalCwd);
+  }
+  const writableRoots = sandboxPolicy.writableRoots;
+  if (Array.isArray(writableRoots)) {
+    for (const writableRoot of writableRoots) {
+      if (typeof writableRoot !== "string") continue;
+      const resolved = resolveAcpPermissionPath(writableRoot, cwd);
+      if (resolved === undefined) continue;
+      const canonicalRoot = acpCanonicalPathForContainment(resolved);
+      if (canonicalRoot !== undefined) roots.push(canonicalRoot);
+    }
+  }
+  if (roots.length === 0) return false;
+
+  const locations = request.toolCall.locations;
+  if (locations === undefined || locations === null || locations.length === 0) {
+    return false;
+  }
+  for (const location of locations) {
+    const resolved = resolveAcpPermissionPath(location.path, cwd);
+    const canonicalPath =
+      resolved === undefined ? undefined : acpCanonicalPathForContainment(resolved);
+    if (
+      canonicalPath === undefined ||
+      !roots.some((root) => acpPathIsWithinRoot(canonicalPath, root))
+    ) {
+      return false;
+    }
+  }
+  return true;
+}
+
+export function acpPermissionDisposition(
+  runtimePolicy: ProviderAdapterV2RuntimePolicy,
+  request: EffectAcpSchema.RequestPermissionRequest,
+): AcpPermissionDisposition {
+  const approvalPolicy = runtimePolicy.approvalPolicy;
+  const requiresApproval =
+    approvalPolicy === undefined
+      ? runtimePolicy.runtimeMode === "approval-required"
+      : approvalPolicy !== "never";
+  if (requiresApproval) {
+    return "ask";
+  }
+
+  const sandboxPolicy = unknownRecord(runtimePolicy.sandboxPolicy);
+  const sandboxType = sandboxPolicy?.type;
+  const toolKind = request.toolCall.kind ?? "other";
+  switch (sandboxType) {
+    case "readOnly":
+      return toolKind === "read" || toolKind === "search" || toolKind === "think"
+        ? "allow"
+        : "deny";
+    case "workspaceWrite":
+      if (toolKind === "read" || toolKind === "search" || toolKind === "think") {
+        return "allow";
+      }
+      if (toolKind === "edit" || toolKind === "delete" || toolKind === "move") {
+        return acpWorkspaceWriteAllowsMutation(runtimePolicy, sandboxPolicy ?? {}, request)
+          ? "allow"
+          : "deny";
+      }
+      return "deny";
+    case "dangerFullAccess":
+    case "externalSandbox":
+      return "allow";
+    case undefined:
+      return runtimePolicy.runtimeMode === "approval-required" ? "deny" : "allow";
+    default:
+      return "deny";
+  }
+}
+
+function elicitationContent(
+  answers: ProviderUserInputAnswers,
+  allowedKeys: ReadonlySet<string>,
+): Record<string, EffectAcpSchema.ElicitationContentValue> {
+  const content: Record<string, EffectAcpSchema.ElicitationContentValue> = {};
+  for (const [key, value] of Object.entries(answers)) {
+    if (!allowedKeys.has(key)) continue;
+    if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+      content[key] = value;
+    } else if (Array.isArray(value)) {
+      content[key] = value.filter((entry): entry is string => typeof entry === "string");
+    }
+  }
+  return content;
+}
+
+interface ActiveTextSegment {
+  readonly nativeItemId: string;
+  readonly startedAt: DateTime.Utc;
+  text: string;
+}
+
+interface ActiveTextStream {
+  current: ActiveTextSegment | null;
+  nextSegment: number;
+}
+
+interface ActiveAcpTurn {
+  readonly input: ProviderAdapterV2TurnInput;
+  readonly providerTurnId: OrchestrationV2ProviderTurn["id"];
+  readonly nativeThreadId: string;
+  readonly nativeTurnId: string;
+  readonly startedAt: DateTime.Utc;
+  readonly completed: Deferred.Deferred<void, never>;
+  readonly assistant: ActiveTextStream;
+  readonly reasoning: ActiveTextStream;
+  readonly tools: Map<string, AcpToolCallState>;
+  readonly toolStartedAt: Map<string, DateTime.Utc>;
+  readonly subagents: Map<string, ActiveAcpSubagent>;
+  readonly subagentsBySessionId: Map<string, ActiveAcpSubagent>;
+  readonly pendingSubagentNotifications: Map<string, Array<EffectAcpSchema.SessionNotification>>;
+  /** Background monitor/task id → toolCallId for synthetic root text updates. */
+  readonly toolCallIdsByBackgroundTaskId: Map<string, string>;
+  /**
+   * Persistent monitors registered this turn. Excluded from deferred-finalize
+   * holds so the root turn can settle while they keep streaming post-settle.
+   */
+  readonly persistentBackgroundTaskIds: Set<string>;
+  /**
+   * Monitor end events often only say "use get_command…"; keep the turn open
+   * until TaskOutput hydration arrives (or the safety timeout elapses).
+   */
+  readonly awaitingBackgroundHydration: Set<string>;
+  /**
+   * A monitor end notice landed after the prompt settled: the CLI runs an
+   * injected turn whose report never gets a turn_completed marker, so the
+   * report chunk races the deferred-finalize debounce (thread a8e8b0a9 run 5
+   * dropped the listing this way). Hold finalize until the report streams or
+   * the safety timeout elapses.
+   */
+  readonly pendingInjectedReport: Set<string>;
+  /**
+   * An injected assistant report can race ahead of its monitor end notice.
+   * Remember that unmatched report so the later notice consumes, rather than
+   * re-arming, the task's pre-settle completion marker.
+   */
+  earlyInjectedReportObserved: boolean;
+  plan: {
+    readonly id: OrchestrationV2PlanArtifact["id"];
+    readonly startedAt: DateTime.Utc;
+  } | null;
+  interrupted: boolean;
+  finalized: boolean;
+  finalizedStatus: "completed" | "interrupted" | "failed" | "cancelled" | null;
+  settleScheduleGeneration: number;
+  /** session/prompt already returned; finalize deferred for background work. */
+  promptSettled: boolean;
+  promptSettledStatus: "completed" | "interrupted" | "failed" | "cancelled" | null;
+  /**
+   * Completed the moment `runtime.prompt` resolves on the wire, before the
+   * completion callback requests `runtimeCallbackPermit`. Failure does not
+   * complete this; settled-soft classification ORs it with `promptSettled`.
+   */
+  readonly promptWireSettled: Deferred.Deferred<void, never>;
+  backgroundFinalizeGeneration: number;
+}
+
+type AcpRuntimeTeardownState =
+  | { readonly _tag: "Idle" }
+  | {
+      readonly _tag: "InProgress";
+      readonly completed: Deferred.Deferred<void, ProviderAdapterProtocolError>;
+    }
+  | { readonly _tag: "Failed"; readonly error: ProviderAdapterProtocolError };
+
+export function acpRootTurnHasIngestedOutput(context: {
+  readonly assistant: ActiveTextStream;
+  readonly reasoning: ActiveTextStream;
+  readonly tools: ReadonlyMap<string, AcpToolCallState>;
+  readonly plan: unknown;
+}): boolean {
+  return (
+    context.assistant.nextSegment > 0 ||
+    context.reasoning.nextSegment > 0 ||
+    context.tools.size > 0 ||
+    context.plan !== null
+  );
+}
+
+/** True when a root session/update carries ingestible turn output, not keepalive noise. */
+export function acpRootSessionUpdateIngestsOutput(
+  notification: EffectAcpSchema.SessionNotification,
+): boolean {
+  const update = notification.update;
+  switch (update.sessionUpdate) {
+    case "agent_message_chunk":
+    case "agent_thought_chunk":
+      return update.content.type === "text" && update.content.text.length > 0;
+    case "tool_call":
+    case "tool_call_update":
+    case "plan":
+      return parseSessionUpdateEvent(notification).events.some(
+        (event) => event._tag === "ToolCallUpdated" || event._tag === "PlanUpdated",
+      );
+    default:
+      return false;
+  }
+}
+
+/**
+ * Post-settle traffic that should be *buffered* for a continuation attach.
+ * Excludes monitor end/event chatter that must not become ghost history.
+ * Broader than {@link acpPostSettleContinuationOfferEvidence}: incremental
+ * tool progress may still need replay once a real completion offers a run.
+ */
+export function acpPostSettleWakeEvidence(
+  notification: EffectAcpSchema.SessionNotification,
+  flavor: Pick<AcpAdapterV2Flavor, "extractBackgroundToolMutation"> = {},
+): boolean {
+  if (!acpRootSessionUpdateIngestsOutput(notification)) return false;
+  const update = notification.update;
+  if (
+    (update.sessionUpdate === "user_message_chunk" ||
+      update.sessionUpdate === "agent_message_chunk") &&
+    update.content.type === "text"
+  ) {
+    const text = update.content.text;
+    if ((flavor.extractBackgroundToolMutation?.(text) ?? []).length > 0) return false;
+    if (update.sessionUpdate === "agent_message_chunk" && text.trim().length === 0) return false;
+    if (/<monitor-event\b/i.test(text) || /Monitor\s+["']?[0-9a-f-]{8,}["']?\s+ended/i.test(text)) {
+      return false;
+    }
+  }
+  return true;
+}
+
+/**
+ * Whether buffered post-settle traffic should *offer* a continuation run now.
+ * Still-running tool streams often land farther apart than the deferred-finalize
+ * quiet window; treating every tool_call_update as offer evidence re-opens a
+ * synthetic "Background task completed." run on each chunk. Only completion-like
+ * frames (real agent text, or a terminal tool status) should open a new run.
+ */
+export function acpPostSettleContinuationOfferEvidence(
+  notification: EffectAcpSchema.SessionNotification,
+  flavor: Pick<AcpAdapterV2Flavor, "extractBackgroundToolMutation" | "normalizeToolCall"> = {},
+): boolean {
+  if (!acpPostSettleWakeEvidence(notification, flavor)) {
+    return false;
+  }
+  const update = notification.update;
+  // Assistant text only. Thought/reasoning bursts alone must not open synthetic
+  // "Background task completed." runs (duplicate-run spam after monitors).
+  if (update.sessionUpdate === "agent_message_chunk") {
+    return update.content.type === "text" && update.content.text.trim().length > 0;
+  }
+  if (update.sessionUpdate === "tool_call" || update.sessionUpdate === "tool_call_update") {
+    return parseSessionUpdateEvent(notification).events.some((event) => {
+      if (event._tag !== "ToolCallUpdated") return false;
+      // Normalize first: a Grok monitor start ACK arrives with raw status
+      // "completed" but is a still-running background task, not completion.
+      const toolCall = flavor.normalizeToolCall?.(event.toolCall) ?? event.toolCall;
+      return toolCall.status === "completed" || toolCall.status === "failed";
+    });
+  }
+  return false;
+}
+
+export function acpPostSettleWakeShouldBuffer(
+  notification: EffectAcpSchema.SessionNotification,
+  backgroundWorkRunning: boolean,
+): boolean {
+  if (!backgroundWorkRunning) return true;
+  const update = notification.update;
+  return (
+    update.sessionUpdate !== "agent_message_chunk" && update.sessionUpdate !== "agent_thought_chunk"
+  );
+}
+
+/**
+ * An app-owned wake (a delegated child finishing) is injected by the
+ * orchestrator, not typed by the user. It reports on a sibling child and says
+ * nothing about this session's own pending wake frames, so it must not discard
+ * them the way a real user turn does. ClaudeAdapterV2 already leaves its buffer
+ * alone on non-continuation turns; this keeps ACP consistent.
+ */
+export function acpIsAppOwnedWakeTurn(message: {
+  readonly createdBy: string;
+  readonly creationSource: string;
+}): boolean {
+  return message.createdBy === "agent" && message.creationSource === "server";
+}
+
+export function acpCarryoverTerminalShouldClearContinuation(input: {
+  readonly continuationOffered: boolean;
+  readonly wakeBufferLength: number;
+}): boolean {
+  return !input.continuationOffered && input.wakeBufferLength === 0;
+}
+
+export function acpTurnStartShouldPreserveContinuation(input: {
+  readonly continuationRequested: boolean;
+  readonly isContinuationTurn: boolean;
+  readonly wakeBufferLength: number;
+}): boolean {
+  return !input.isContinuationTurn && input.continuationRequested && input.wakeBufferLength > 0;
+}
+
+export function acpPostSettleMonitorPromptShouldSuppress(
+  mutation:
+    | {
+        readonly taskId: string;
+        readonly status: "running" | "completed" | "failed";
+      }
+    | undefined,
+): boolean {
+  return mutation?.status === "running";
+}
+
+export function acpCompletedTurnShouldTerminalizeTool(
+  tool: AcpToolCallState,
+  flavor: Pick<AcpAdapterV2Flavor, "extractBackgroundTaskId" | "extractSubagentUpdate">,
+): boolean {
+  const status = toolStatus(tool.status);
+  if (status !== "pending" && status !== "running") return false;
+  if (flavor.extractBackgroundTaskId?.(tool) !== undefined) return false;
+  return flavor.extractSubagentUpdate?.(tool) === undefined;
+}
+
+interface ActiveAcpSubagent {
+  task: OrchestrationV2Subagent;
+  readonly childThreadId: ThreadId;
+  readonly childRootNodeId: OrchestrationV2ExecutionNode["id"];
+  readonly turnItemId: OrchestrationV2TurnItem["id"];
+  readonly turnItemOrdinal: number;
+  /** Turn that spawned the subagent; carryover updates keep this lineage. */
+  readonly providerTurnId: OrchestrationV2ProviderTurn["id"];
+  readonly parentProviderThreadId: ProviderThreadId;
+  childSessionId: string | null;
+  assistantText: string;
+  nextChildOrdinal: number;
+  /**
+   * Whether a terminal carryover status has been projected to events.
+   * Completed roots project post-settle terminals immediately while their
+   * subscriber remains observable. Non-completed roots retain terminals in
+   * memory until the next attach. A later project:true path for the same entry
+   * must still project once; this flag prevents double emission and pins
+   * hasPendingBackgroundWork until projection lands.
+   */
+  terminalStatusProjected: boolean;
+}
+
+function acpSubagentStatusIsTerminal(status: OrchestrationV2Subagent["status"]): boolean {
+  return (
+    status === "completed" ||
+    status === "failed" ||
+    status === "interrupted" ||
+    status === "cancelled"
+  );
+}
+
+export function acpSubagentStatusBlocksTurnSettlement(
+  status: OrchestrationV2Subagent["status"],
+): boolean {
+  return status === "running" || status === "pending";
+}
+
+function acpSubagentHasPendingBackgroundWork(subagent: ActiveAcpSubagent): boolean {
+  return (
+    acpSubagentStatusBlocksTurnSettlement(subagent.task.status) || !subagent.terminalStatusProjected
+  );
+}
+
+type AcpCarryoverSubagents = {
+  readonly sessionId: string;
+  readonly rootTerminalStatus: "completed" | "interrupted" | "failed" | "cancelled";
+  readonly subagents: ReadonlyArray<ActiveAcpSubagent>;
+};
+
+function acpTurnHasPendingRuntimeRequest(
+  providerTurnId: OrchestrationV2ProviderTurn["id"],
+  pending: ReadonlyMap<string, PendingRuntimeRequest>,
+): boolean {
+  return [...pending.values()].some(
+    (request) =>
+      request.runtimeRequest.providerTurnId === providerTurnId &&
+      request.runtimeRequest.status === "pending",
+  );
+}
+
+type PendingRuntimeRequest = {
+  readonly generation: number;
+  readonly nativeResponseAcknowledgement: Deferred.Deferred<void, EffectAcpErrors.AcpError>;
+  readonly transportRequestId: string;
+  readonly requestId: RuntimeRequestId;
+  readonly runtimeRequest: OrchestrationV2RuntimeRequest;
+  readonly node: OrchestrationV2ExecutionNode;
+  readonly turnItem: OrchestrationV2TurnItem;
+} & (
+  | {
+      readonly type: "approval";
+      readonly decision: Deferred.Deferred<ProviderApprovalDecision>;
+    }
+  | {
+      readonly type: "user_input";
+      readonly answers: Deferred.Deferred<ProviderUserInputAnswers | null>;
+    }
+);
+
+interface SnapshotMessageState {
+  readonly order: Array<string>;
+  readonly messages: Map<string, OrchestrationV2ConversationMessage>;
+  loadingRole: "user" | "assistant" | null;
+  loadingIndex: number;
+}
+
+export function makeAcpAdapterV2(options: AcpAdapterV2Options): ProviderAdapterV2Shape {
+  const { flavor, fileSystem, idAllocator, serverConfig } = options;
+  const driver = flavor.driver;
+  const continuationRequests = options.continuationRequests;
+  const postSettleContinuationEnabled =
+    flavor.enablePostSettleContinuation === true && continuationRequests !== undefined;
+
+  return ProviderAdapterV2.of({
+    instanceId: options.instanceId,
+    driver,
+    getCapabilities: () => Effect.succeed(flavor.capabilities),
+    planSelectionTransition: (input) => Effect.succeed(acpSelectionTransition(input)),
+    openSession: Effect.fn("AcpAdapterV2.openSession")(
+      function* (input: ProviderAdapterV2OpenSessionInput) {
+        const sessionScope = yield* Effect.scope;
+        const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+        const activeTurn = yield* Ref.make<ActiveAcpTurn | null>(null);
+        const activeSessionId = yield* Ref.make<string | null>(null);
+        const activeSessionSetup = yield* Ref.make<AcpSessionRuntimeStartResult | null>(null);
+        const activeSelection = yield* Ref.make<ModelSelection | null>(null);
+        const runtimeRestartRequired = yield* Ref.make(false);
+        const runtimeTeardownState = yield* Ref.make<AcpRuntimeTeardownState>({ _tag: "Idle" });
+        const runtimeCallbackGeneration = yield* Ref.make(0);
+        const runtimeCallbackPermit = yield* Semaphore.make(1);
+        const runtimeTransitionPermit = yield* Semaphore.make(1);
+        const nativeTransportRequests = yield* Ref.make<
+          Array<{
+            readonly generation: number;
+            readonly method: string;
+            readonly payload: unknown;
+            readonly requestId: string;
+            readonly sequence: number;
+          }>
+        >([]);
+        const nextNativeTransportSequence = yield* Ref.make(0);
+        const nativeResponseAcknowledgements = yield* Ref.make(
+          new Map<
+            string,
+            {
+              readonly acknowledgement: Deferred.Deferred<void, EffectAcpErrors.AcpError>;
+              readonly generation: number;
+            }
+          >(),
+        );
+        const pendingRuntimeRequests = yield* Ref.make(new Map<string, PendingRuntimeRequest>());
+        const emitNativeResponseLifecycle =
+          options.testHooks?.onNativeResponseLifecycle ?? (() => Effect.void);
+        const nextElicitationOrdinal = yield* Ref.make(0);
+        const itemOrdinals = yield* Ref.make(new Map<string, number>());
+        const nextItemOrdinalsByTurn = yield* Ref.make(new Map<string, number>());
+        const providerTurns = yield* Ref.make(new Map<string, OrchestrationV2ProviderTurn>());
+        const snapshot = yield* Ref.make<SnapshotMessageState>({
+          order: [],
+          messages: new Map(),
+          loadingRole: null,
+          loadingIndex: 0,
+        });
+
+        const awaitRuntimeTeardown = Effect.fnUntraced(function* () {
+          const state = yield* Ref.get(runtimeTeardownState);
+          if (state._tag === "InProgress") {
+            yield* Deferred.await(state.completed);
+          } else if (state._tag === "Failed") {
+            return yield* state.error;
+          }
+        });
+        const runRuntimeCallbackAtGeneration = <A, E, R>(
+          generation: number,
+          effect: Effect.Effect<A, E, R>,
+        ) =>
+          runtimeCallbackPermit.withPermit(
+            Effect.gen(function* () {
+              if ((yield* Ref.get(runtimeTeardownState))._tag !== "Idle") {
+                return Option.none<A>();
+              }
+              if ((yield* Ref.get(runtimeCallbackGeneration)) !== generation) {
+                return Option.none<A>();
+              }
+              return Option.some(yield* effect);
+            }),
+          );
+        const claimNativeTransportRequest = (
+          generation: number,
+          predicate: (request: { readonly method: string; readonly payload: unknown }) => boolean,
+        ) =>
+          Ref.modify(
+            nativeTransportRequests,
+            (
+              requests,
+            ): readonly [
+              string | undefined,
+              Array<{
+                readonly generation: number;
+                readonly method: string;
+                readonly payload: unknown;
+                readonly requestId: string;
+                readonly sequence: number;
+              }>,
+            ] => acpClaimNativeTransportRequest(requests, generation, predicate),
+          );
+        const registerNativeResponseAcknowledgement = (
+          generation: number,
+          transportRequestId: string,
+          acknowledgement: Deferred.Deferred<void, EffectAcpErrors.AcpError>,
+        ) =>
+          Effect.gen(function* () {
+            yield* Ref.update(nativeResponseAcknowledgements, (current) => {
+              const updated = new Map(current);
+              updated.set(transportRequestId, { acknowledgement, generation });
+              return updated;
+            });
+            yield* emitNativeResponseLifecycle({
+              type: "registered",
+              generation,
+              requestId: transportRequestId,
+            });
+            if (!(yield* Deferred.isDone(acknowledgement))) return;
+            yield* Ref.update(nativeResponseAcknowledgements, (current) => {
+              if (current.get(transportRequestId)?.acknowledgement !== acknowledgement) {
+                return current;
+              }
+              const updated = new Map(current);
+              updated.delete(transportRequestId);
+              return updated;
+            });
+          });
+        const acknowledgeNativeResponse = (generation: number, transportRequestId: string) =>
+          (
+            options.testHooks?.beforeNativeResponseAdmissionCheck?.(
+              generation,
+              transportRequestId,
+            ) ?? Effect.void
+          ).pipe(
+            Effect.andThen(runRuntimeCallbackAtGeneration(generation, Effect.void)),
+            Effect.flatMap((registered) =>
+              Option.isSome(registered)
+                ? Effect.void
+                : emitNativeResponseLifecycle({
+                    type: "admission_rejected",
+                    generation,
+                    requestId: transportRequestId,
+                  }).pipe(
+                    Effect.andThen(
+                      new EffectAcpErrors.AcpTransportError({
+                        detail: "The ACP runtime closed before its response could be admitted",
+                        cause: "Native response registration rejected during teardown",
+                      }),
+                    ),
+                  ),
+            ),
+          );
+        const awaitNativeResponseAcknowledgements = Effect.fnUntraced(function* (
+          acknowledgements: ReadonlyArray<
+            readonly [string | undefined, Deferred.Deferred<void, EffectAcpErrors.AcpError>]
+          >,
+        ) {
+          if (acknowledgements.length === 0) return true;
+          const completed = yield* Deferred.make<"settled" | "timeout">();
+          yield* emitNativeResponseLifecycle({ type: "watcher_started" });
+          const acknowledgementFiber = yield* Effect.forEach(
+            acknowledgements,
+            ([, acknowledgement]) => Deferred.await(acknowledgement).pipe(Effect.exit),
+            { concurrency: "unbounded", discard: true },
+          ).pipe(
+            Effect.andThen(Deferred.succeed(completed, "settled")),
+            Effect.interruptible,
+            Effect.ensuring(emitNativeResponseLifecycle({ type: "watcher_exited" })),
+            Effect.forkDetach,
+          );
+          yield* emitNativeResponseLifecycle({ type: "timer_started" });
+          const timerFiber = yield* Effect.sleep("2 seconds").pipe(
+            Effect.andThen(Deferred.succeed(completed, "timeout")),
+            Effect.interruptible,
+            Effect.ensuring(emitNativeResponseLifecycle({ type: "timer_exited" })),
+            Effect.forkDetach,
+          );
+          const outcome = yield* Deferred.await(completed);
+          yield* Fiber.interrupt(acknowledgementFiber);
+          yield* Fiber.interrupt(timerFiber);
+          if (outcome === "settled") return true;
+
+          yield* Ref.update(nativeResponseAcknowledgements, (current) => {
+            const updated = new Map(current);
+            for (const [requestId, acknowledgement] of acknowledgements) {
+              if (
+                requestId !== undefined &&
+                updated.get(requestId)?.acknowledgement === acknowledgement
+              ) {
+                updated.delete(requestId);
+              }
+            }
+            return updated;
+          });
+          yield* Effect.forEach(
+            acknowledgements,
+            ([requestId]) =>
+              emitNativeResponseLifecycle({
+                type: "removed",
+                ...(requestId === undefined ? {} : { requestId }),
+              }),
+            { concurrency: "unbounded", discard: true },
+          );
+          const timeoutError = new EffectAcpErrors.AcpTransportError({
+            detail: "Timed out waiting for an admitted ACP response to reach the transport queue",
+            cause: "Native response acknowledgement timed out",
+          });
+          yield* Effect.forEach(
+            acknowledgements,
+            ([requestId, acknowledgement]) =>
+              Deferred.fail(acknowledgement, timeoutError).pipe(
+                Effect.andThen(
+                  emitNativeResponseLifecycle({
+                    type: "failed",
+                    ...(requestId === undefined ? {} : { requestId }),
+                  }),
+                ),
+              ),
+            { concurrency: "unbounded", discard: true },
+          );
+          return false;
+        });
+        const awaitAdmittedNativeResponses = Effect.gen(function* () {
+          yield* awaitNativeResponseAcknowledgements(
+            [...(yield* Ref.get(nativeResponseAcknowledgements)).entries()].map(
+              ([requestId, entry]) => [requestId, entry.acknowledgement] as const,
+            ),
+          );
+        });
+        const quarantineNativeTransportAtGeneration = Effect.fnUntraced(function* (
+          generation: number,
+        ) {
+          yield* Ref.update(nativeTransportRequests, (requests) =>
+            requests.filter((request) => request.generation !== generation),
+          );
+          const quarantined = yield* Ref.modify(nativeResponseAcknowledgements, (current) => {
+            const updated = new Map(current);
+            const acknowledgements: Array<Deferred.Deferred<void, EffectAcpErrors.AcpError>> = [];
+            for (const [requestId, entry] of updated) {
+              if (entry.generation !== generation) continue;
+              updated.delete(requestId);
+              acknowledgements.push(entry.acknowledgement);
+            }
+            return [acknowledgements, updated] as const;
+          });
+          const error = new EffectAcpErrors.AcpTransportError({
+            detail: "The ACP runtime was replaced before its response reached the transport queue",
+            cause: "ACP runtime transport was quarantined during teardown",
+          });
+          yield* Effect.forEach(
+            quarantined,
+            (acknowledgement) => Deferred.fail(acknowledgement, error),
+            { concurrency: "unbounded", discard: true },
+          );
+        });
+        const closeNativeTransport = runtimeCallbackPermit.withPermit(
+          Effect.gen(function* () {
+            yield* Ref.update(runtimeCallbackGeneration, (generation) => generation + 1);
+            yield* Ref.set(nativeTransportRequests, []);
+            const acknowledgements = yield* Ref.getAndSet(
+              nativeResponseAcknowledgements,
+              new Map(),
+            );
+            const error = new EffectAcpErrors.AcpTransportError({
+              detail: "The ACP session closed before its admitted response reached the transport",
+              cause: "ACP session transport closed",
+            });
+            yield* Effect.forEach(
+              acknowledgements,
+              ([requestId, entry]) =>
+                Deferred.fail(entry.acknowledgement, error).pipe(
+                  Effect.andThen(
+                    emitNativeResponseLifecycle({
+                      type: "removed",
+                      generation: entry.generation,
+                      requestId,
+                    }),
+                  ),
+                  Effect.andThen(
+                    emitNativeResponseLifecycle({
+                      type: "failed",
+                      generation: entry.generation,
+                      requestId,
+                    }),
+                  ),
+                ),
+              { concurrency: "unbounded", discard: true },
+            );
+            return acknowledgements.size > 0;
+          }),
+        );
+        // Post-settle wake support (Grok async subagent/monitor follow-up). After
+        // the root turn finalizes, later root session/update traffic buffers here
+        // until a provider continuation run attaches and drains it.
+        const lastTurnRoute = yield* Ref.make<{
+          readonly threadId: ThreadId;
+          readonly providerThreadId: ProviderThreadId;
+        } | null>(null);
+        const wakeBuffer = yield* Ref.make<Array<EffectAcpSchema.SessionNotification>>([]);
+        const continuationRequested = yield* Ref.make(false);
+        const continuationGeneration = yield* Ref.make(0);
+        const continuationPermit = yield* Semaphore.make(1);
+        const continuationClosed = yield* Ref.make(false);
+        // Direct Stop (requestRuntimeRestart) quarantines residual events from the
+        // stopped run so they cannot wake or attach to a later prompt/run.
+        const stoppedRunQuarantine = yield* Ref.make(false);
+        // A steering restart (or any interrupt) can finalize a turn while its
+        // spawned subagents are still running natively. Carry the live
+        // lineages into the next turn on the same session so their terminal
+        // signals can still flip the original turn items instead of leaving
+        // them running forever.
+        const carryoverSubagents = yield* Ref.make<AcpCarryoverSubagents | null>(null);
+        const handledBackgroundTaskIdsInActiveTurn = yield* Ref.make<ReadonlySet<string>>(
+          new Set(),
+        );
+        // Background tasks that reached a genuine terminal mutation while a root
+        // turn was still streaming and were not yet marked handled in-turn. The
+        // mid-turn offer is suppressed (active turn owns the work); on finalize
+        // these ids re-arm a single continuation when the agent never hydrated
+        // or reported them before settle (regression: mid-turn complete + no
+        // get_command must still wake after finalize).
+        const midTurnUnreportedCompletedTaskIds = yield* Ref.make<ReadonlySet<string>>(new Set());
+        // A monitor-event can arrive after its task and the user-facing provider
+        // turn already completed. Grok starts another internal prompt for that
+        // stale notification; suppress its agent output until a genuine terminal
+        // mutation or the next app turn so it cannot create a redundant app
+        // continuation. Tool frames continue through normal hydration.
+        const suppressPostSettleMonitorPrompt = yield* Ref.make(false);
+        // Background tasks (Grok monitors) known to still run at session level.
+        // Turn contexts are too short-lived to carry this: a continuation run
+        // finalizes between monitor events, and the next commentary burst must
+        // not reopen a run while the monitor is still streaming.
+        const runningBackgroundTaskIds = yield* Ref.make<ReadonlySet<string>>(new Set());
+        // Task ids with a GENUINE end signal (monitor-ended reminder or
+        // TaskOutput completion). Normalized tool statuses are not genuine:
+        // Grok Bash re-reports carry exit_code 0 mid-stream. A straggler
+        // monitor-event can land after the real end (the CLI keeps streaming
+        // while the agent already consumed the output via
+        // get_command_or_subagent_output); without the tombstone it would
+        // resurrect the running set and pin offers/idle-release forever.
+        // A tool-level failed get_command tombstones too: failing open to a
+        // single continuation beats failing closed to a dead thread.
+        const endedBackgroundTaskIds = yield* Ref.make<ReadonlySet<string>>(new Set());
+        const endedBackgroundTaskIdLimit = 128;
+
+        const setBackgroundTaskRunning = (taskId: string, running: boolean) =>
+          Effect.gen(function* () {
+            if (running && (yield* Ref.get(endedBackgroundTaskIds)).has(taskId)) {
+              return;
+            }
+            yield* Ref.update(runningBackgroundTaskIds, (current) => {
+              if (current.has(taskId) === running) return current;
+              const next = new Set(current);
+              if (running) {
+                next.add(taskId);
+              } else {
+                next.delete(taskId);
+              }
+              return next;
+            });
+          });
+
+        const markBackgroundTaskEnded = (taskId: string) =>
+          Ref.update(endedBackgroundTaskIds, (current) => {
+            if (current.has(taskId)) return current;
+            const next = new Set(current).add(taskId);
+            for (const oldest of next) {
+              if (next.size <= endedBackgroundTaskIdLimit) break;
+              next.delete(oldest);
+            }
+            return next;
+          }).pipe(Effect.andThen(setBackgroundTaskRunning(taskId, false)));
+
+        const applyBackgroundTaskMutationRunning = (mutation: {
+          readonly taskId: string;
+          readonly status: "running" | "completed" | "failed";
+        }) =>
+          mutation.status === "running"
+            ? setBackgroundTaskRunning(mutation.taskId, true)
+            : markBackgroundTaskEnded(mutation.taskId);
+
+        const trackRunningBackgroundTools = (
+          notification: EffectAcpSchema.SessionNotification,
+        ): Effect.Effect<void> =>
+          Effect.gen(function* () {
+            if (flavor.extractBackgroundTaskId === undefined) return;
+            for (const event of parseSessionUpdateEvent(notification).events) {
+              if (event._tag !== "ToolCallUpdated") continue;
+              const toolCall = flavor.normalizeToolCall?.(event.toolCall) ?? event.toolCall;
+              const taskId = flavor.extractBackgroundTaskId(toolCall);
+              if (taskId === undefined) continue;
+              const status = toolStatus(toolCall.status);
+              yield* setBackgroundTaskRunning(taskId, status === "pending" || status === "running");
+            }
+          });
+
+        const emitProviderEvent = (event: ProviderAdapterV2Event) =>
+          Queue.offer(events, event).pipe(Effect.asVoid);
+        let scheduleSettleRootTurnWhenIdle = (_context: ActiveAcpTurn) => Effect.void;
+        let rearmRootTurnRecoveryTimers = (_context: ActiveAcpTurn) => Effect.void;
+        let scheduleDeferredFinalize: (context: ActiveAcpTurn) => Effect.Effect<void> = () =>
+          Effect.void;
+
+        const nativeLogging = options.nativeLogging?.(input.threadId);
+        const makeRuntimeInput = (runtimeGeneration: number): AcpAdapterV2RuntimeInput => ({
+          cwd: input.runtimePolicy.cwd ?? process.cwd(),
+          mcpServers: acpMcpServers(input.threadId),
+          interruptPromptOnCancel: flavor.interruptPromptOnCancel ?? false,
+          clientCapabilities: {
+            fs: { readTextFile: false, writeTextFile: false },
+            terminal: false,
+            elicitation: { form: {} },
+          },
+          clientInfo: { name: "t3-code", version: "0.0.0" },
+          onIncomingRequest: (requestId, method, payload) =>
+            runRuntimeCallbackAtGeneration(
+              runtimeGeneration,
+              Effect.gen(function* () {
+                const sequence = yield* Ref.getAndUpdate(
+                  nextNativeTransportSequence,
+                  (current) => current + 1,
+                );
+                yield* Ref.update(nativeTransportRequests, (current) => [
+                  ...current,
+                  { generation: runtimeGeneration, method, payload, requestId, sequence },
+                ]);
+              }),
+            ).pipe(Effect.asVoid),
+          onTermination: () =>
+            runRuntimeCallbackAtGeneration(
+              runtimeGeneration,
+              Ref.set(runtimeRestartRequired, true),
+            ).pipe(Effect.asVoid),
+          onOutgoingResponseFailure: (requestId, error) =>
+            Ref.modify(nativeResponseAcknowledgements, (current) => {
+              const entry = current.get(requestId);
+              if (entry === undefined || entry.generation !== runtimeGeneration) {
+                return [
+                  emitNativeResponseLifecycle({
+                    type: "late_noop",
+                    generation: runtimeGeneration,
+                    requestId,
+                  }),
+                  current,
+                ] as const;
+              }
+              const updated = new Map(current);
+              updated.delete(requestId);
+              return [
+                Deferred.fail(entry.acknowledgement, error).pipe(
+                  Effect.andThen(
+                    emitNativeResponseLifecycle({
+                      type: "removed",
+                      generation: runtimeGeneration,
+                      requestId,
+                    }),
+                  ),
+                  Effect.asVoid,
+                ),
+                updated,
+              ] as const;
+            }).pipe(Effect.flatten),
+          onOutgoingResponse: (requestId) =>
+            Ref.modify(nativeResponseAcknowledgements, (current) => {
+              const entry = current.get(requestId);
+              if (entry === undefined || entry.generation !== runtimeGeneration) {
+                return [
+                  emitNativeResponseLifecycle({
+                    type: "late_noop",
+                    generation: runtimeGeneration,
+                    requestId,
+                  }),
+                  current,
+                ] as const;
+              }
+              const updated = new Map(current);
+              updated.delete(requestId);
+              return [
+                Deferred.succeed(entry.acknowledgement, undefined).pipe(
+                  Effect.andThen(
+                    emitNativeResponseLifecycle({
+                      type: "removed",
+                      generation: runtimeGeneration,
+                      requestId,
+                    }),
+                  ),
+                  Effect.asVoid,
+                ),
+                updated,
+              ] as const;
+            }).pipe(Effect.flatten),
+          ...(nativeLogging?.requestLogger === undefined
+            ? {}
+            : { requestLogger: nativeLogging.requestLogger }),
+          protocolLogging: nativeLogging?.protocolLogging ?? {
+            logIncoming: true,
+            logOutgoing: true,
+            logger: () => Effect.void,
+          },
+        });
+        let runtimeScope: Scope.Closeable | undefined;
+        let runtime!: AcpSessionRuntime.AcpSessionRuntime["Service"];
+        yield* Effect.addFinalizer(() =>
+          runtimeScope === undefined
+            ? Effect.void
+            : Scope.close(runtimeScope, Exit.void).pipe(Effect.ignore),
+        );
+
+        const resolveItemOrdinal = Effect.fnUntraced(function* (
+          context: ActiveAcpTurn,
+          nativeItemId: string,
+        ) {
+          const existing = (yield* Ref.get(itemOrdinals)).get(nativeItemId);
+          if (existing !== undefined) return existing;
+          const nextWithinTurn = yield* Ref.modify(nextItemOrdinalsByTurn, (current) => {
+            const next = (current.get(context.nativeTurnId) ?? 0) + 1;
+            const updated = new Map(current);
+            updated.set(context.nativeTurnId, next);
+            return [next, updated] as const;
+          });
+          const ordinal = context.input.providerTurnOrdinal * 100 + nextWithinTurn;
+          yield* Ref.update(itemOrdinals, (current) => {
+            const updated = new Map(current);
+            updated.set(nativeItemId, ordinal);
+            return updated;
+          });
+          return ordinal;
+        });
+
+        const lastCapturedProposedPlan = yield* Ref.make<{
+          readonly nativeTurnId: string;
+          readonly markdown: string;
+          readonly planId: OrchestrationV2PlanArtifact["id"];
+        } | null>(null);
+        /**
+         * Emits a completed proposed-plan artifact for the active turn. Same
+         * plan id per turn so repeated captures (plan.md rewrites, the exit
+         * gate) update one card; identical markdown within a turn is a no-op.
+         */
+        const captureProposedPlan = Effect.fnUntraced(function* (input: {
+          readonly planMarkdown: string;
+        }) {
+          const context = yield* Ref.get(activeTurn);
+          if (context === null) return;
+          const markdown = input.planMarkdown.trim();
+          if (markdown.length === 0) return;
+          const previous = yield* Ref.get(lastCapturedProposedPlan);
+          if (
+            previous !== null &&
+            previous.nativeTurnId === context.nativeTurnId &&
+            previous.markdown === markdown
+          ) {
+            return;
+          }
+          const nativeItemId = `${context.nativeTurnId}:proposed-plan`;
+          const planId =
+            previous !== null && previous.nativeTurnId === context.nativeTurnId
+              ? previous.planId
+              : yield* idAllocator.allocate
+                  .plan({
+                    threadId: context.input.threadId,
+                    runId: context.input.runId,
+                    driver,
+                  })
+                  .pipe(Effect.orDie);
+          yield* Ref.set(lastCapturedProposedPlan, {
+            nativeTurnId: context.nativeTurnId,
+            markdown,
+            planId,
+          });
+          const now = yield* DateTime.now;
+          const nodeId = idAllocator.derive.nodeFromProviderItem({ driver, nativeItemId });
+          const turnItemId = idAllocator.derive.turnItemFromProviderItem({ driver, nativeItemId });
+          const ordinal = yield* resolveItemOrdinal(context, nativeItemId);
+          const nativeItemRef = { driver, nativeId: nativeItemId, strength: "weak" as const };
+          yield* emitProviderEvent({
+            type: "node.updated",
+            driver,
+            node: {
+              id: nodeId,
+              threadId: context.input.threadId,
+              runId: context.input.runId,
+              parentNodeId: context.input.rootNodeId,
+              rootNodeId: context.input.rootNodeId,
+              kind: "plan",
+              status: "completed",
+              countsForRun: false,
+              providerThreadId: context.input.providerThread.id,
+              providerTurnId: context.providerTurnId,
+              nativeItemRef,
+              runtimeRequestId: null,
+              checkpointScopeId: null,
+              startedAt: context.startedAt,
+              completedAt: now,
+            },
+          });
+          yield* emitProviderEvent({
+            type: "plan.updated",
+            driver,
+            plan: {
+              id: planId,
+              threadId: context.input.threadId,
+              runId: context.input.runId,
+              nodeId,
+              kind: "proposed_plan",
+              status: "completed",
+              markdown,
+            },
+          });
+          yield* emitProviderEvent({
+            type: "turn_item.updated",
+            driver,
+            turnItem: {
+              id: turnItemId,
+              threadId: context.input.threadId,
+              runId: context.input.runId,
+              nodeId,
+              providerThreadId: context.input.providerThread.id,
+              providerTurnId: context.providerTurnId,
+              nativeItemRef,
+              parentItemId: null,
+              ordinal,
+              status: "completed",
+              title: null,
+              startedAt: context.startedAt,
+              completedAt: now,
+              updatedAt: now,
+              type: "proposed_plan",
+              planId,
+              markdown,
+              streaming: false,
+            },
+          });
+        });
+        const lastProposedPlanMarkdown = Effect.gen(function* () {
+          const context = yield* Ref.get(activeTurn);
+          const previous = yield* Ref.get(lastCapturedProposedPlan);
+          return context !== null && previous?.nativeTurnId === context.nativeTurnId
+            ? previous.markdown
+            : undefined;
+        });
+
+        const rememberSnapshotMessage = (message: OrchestrationV2ConversationMessage) =>
+          Ref.update(snapshot, (current) => {
+            const key = String(message.id);
+            const exists = current.messages.has(key);
+            const messages = new Map(current.messages);
+            messages.set(key, message);
+            return {
+              ...current,
+              order: exists ? current.order : [...current.order, key],
+              messages,
+            };
+          });
+
+        const emitTextSegment = Effect.fnUntraced(function* (
+          context: ActiveAcpTurn,
+          kind: "assistant" | "reasoning",
+          completed: boolean,
+        ) {
+          const stream = kind === "assistant" ? context.assistant : context.reasoning;
+          const segment = stream.current;
+          if (segment === null || segment.text.length === 0) return;
+          const now = yield* DateTime.now;
+          const ordinal = yield* resolveItemOrdinal(context, segment.nativeItemId);
+          const nodeId = idAllocator.derive.nodeFromProviderItem({
+            driver,
+            nativeItemId: segment.nativeItemId,
+          });
+          const turnItemId = idAllocator.derive.turnItemFromProviderItem({
+            driver,
+            nativeItemId: segment.nativeItemId,
+          });
+          const nativeItemRef = {
+            driver,
+            nativeId: segment.nativeItemId,
+            strength: "weak" as const,
+          };
+          yield* emitProviderEvent({
+            type: "node.updated",
+            driver,
+            node: {
+              id: nodeId,
+              threadId: context.input.threadId,
+              runId: context.input.runId,
+              parentNodeId: context.input.rootNodeId,
+              rootNodeId: context.input.rootNodeId,
+              kind: kind === "assistant" ? "assistant_message" : "reasoning",
+              status: completed ? "completed" : "running",
+              countsForRun: false,
+              providerThreadId: context.input.providerThread.id,
+              providerTurnId: context.providerTurnId,
+              nativeItemRef,
+              runtimeRequestId: null,
+              checkpointScopeId: null,
+              startedAt: segment.startedAt,
+              completedAt: completed ? now : null,
+            },
+          });
+          if (kind === "assistant") {
+            const messageId = idAllocator.derive.messageFromProviderItem({
+              driver,
+              nativeItemId: segment.nativeItemId,
+            });
+            const message: OrchestrationV2ConversationMessage = {
+              createdBy: "agent",
+              creationSource: "provider",
+              id: messageId,
+              threadId: context.input.threadId,
+              runId: context.input.runId,
+              nodeId,
+              role: "assistant",
+              text: segment.text,
+              attachments: [],
+              streaming: !completed,
+              createdAt: segment.startedAt,
+              updatedAt: now,
+            };
+            yield* emitProviderEvent({ type: "message.updated", driver, message });
+            yield* emitProviderEvent({
+              type: "turn_item.updated",
+              driver,
+              turnItem: {
+                id: turnItemId,
+                threadId: context.input.threadId,
+                runId: context.input.runId,
+                nodeId,
+                providerThreadId: context.input.providerThread.id,
+                providerTurnId: context.providerTurnId,
+                nativeItemRef,
+                parentItemId: null,
+                ordinal,
+                status: completed ? "completed" : "running",
+                title: null,
+                startedAt: segment.startedAt,
+                completedAt: completed ? now : null,
+                updatedAt: now,
+                type: "assistant_message",
+                messageId,
+                text: segment.text,
+                streaming: !completed,
+              },
+            });
+            if (completed) yield* rememberSnapshotMessage(message);
+            return;
+          }
+          yield* emitProviderEvent({
+            type: "turn_item.updated",
+            driver,
+            turnItem: {
+              id: turnItemId,
+              threadId: context.input.threadId,
+              runId: context.input.runId,
+              nodeId,
+              providerThreadId: context.input.providerThread.id,
+              providerTurnId: context.providerTurnId,
+              nativeItemRef,
+              parentItemId: null,
+              ordinal,
+              status: completed ? "completed" : "running",
+              title: null,
+              startedAt: segment.startedAt,
+              completedAt: completed ? now : null,
+              updatedAt: now,
+              type: "reasoning",
+              text: segment.text,
+              streaming: !completed,
+            },
+          });
+        });
+
+        const closeTextStream = Effect.fnUntraced(function* (
+          context: ActiveAcpTurn,
+          kind: "assistant" | "reasoning",
+        ) {
+          const stream = kind === "assistant" ? context.assistant : context.reasoning;
+          if (stream.current === null) return;
+          yield* emitTextSegment(context, kind, true);
+          stream.current = null;
+          if (kind === "assistant") {
+            yield* scheduleSettleRootTurnWhenIdle(context);
+          }
+        });
+
+        const closeTextStreams = Effect.fnUntraced(function* (context: ActiveAcpTurn) {
+          yield* closeTextStream(context, "reasoning");
+          yield* closeTextStream(context, "assistant");
+        });
+
+        const appendText = Effect.fnUntraced(function* (
+          context: ActiveAcpTurn,
+          kind: "assistant" | "reasoning",
+          text: string,
+        ) {
+          if (text.length === 0) return;
+          const other = kind === "assistant" ? "reasoning" : "assistant";
+          yield* closeTextStream(context, other);
+          const stream = kind === "assistant" ? context.assistant : context.reasoning;
+          if (stream.current === null) {
+            const now = yield* DateTime.now;
+            stream.current = {
+              nativeItemId: `${context.nativeTurnId}:${kind}:${stream.nextSegment}`,
+              startedAt: now,
+              text: "",
+            };
+            stream.nextSegment += 1;
+          }
+          stream.current.text += text;
+          yield* emitTextSegment(context, kind, false);
+        });
+
+        const emitSubagentAssistant = Effect.fnUntraced(function* (
+          subagent: ActiveAcpSubagent,
+          text: string,
+        ) {
+          if (text.length === 0) return;
+          subagent.assistantText += text;
+          const now = yield* DateTime.now;
+          const nativeItemId = `${subagent.task.nativeTaskRef?.nativeId ?? subagent.task.id}:result`;
+          const artifacts = makeSubagentConversationArtifacts({
+            messageId: idAllocator.derive.messageFromProviderItem({ driver, nativeItemId }),
+            turnItemId: idAllocator.derive.turnItemFromProviderItem({ driver, nativeItemId }),
+            threadId: subagent.childThreadId,
+            rootNodeId: subagent.childRootNodeId,
+            providerThreadId: subagent.task.providerThreadId,
+            providerTurnId: null,
+            nativeItemRef: { driver, nativeId: nativeItemId, strength: "weak" },
+            role: "assistant",
+            text: subagent.assistantText,
+            ordinal: subagent.nextChildOrdinal,
+            now,
+          });
+          yield* emitProviderEvent({ type: "message.updated", driver, message: artifacts.message });
+          yield* emitProviderEvent({
+            type: "turn_item.updated",
+            driver,
+            turnItem: artifacts.turnItem,
+          });
+        });
+
+        const projectSubagentNotification = Effect.fnUntraced(function* (
+          subagent: ActiveAcpSubagent,
+          notification: EffectAcpSchema.SessionNotification,
+        ) {
+          const update = notification.update;
+          if (update.sessionUpdate === "agent_message_chunk" && update.content.type === "text") {
+            yield* emitSubagentAssistant(subagent, update.content.text);
+          }
+        });
+
+        const emitSubagent = Effect.fnUntraced(function* (
+          context: ActiveAcpTurn,
+          update: AcpAdapterV2SubagentUpdate,
+        ) {
+          // Hydration tools (get_command_or_subagent_output) use a new toolCallId
+          // but reference the child via subagent_id / task id.
+          const existing =
+            context.subagents.get(update.nativeTaskId) ??
+            (update.childSessionId !== null
+              ? context.subagentsBySessionId.get(update.childSessionId)
+              : undefined);
+          const updateIsTerminal = acpSubagentStatusIsTerminal(update.status);
+          if (
+            existing !== undefined &&
+            acpSubagentStatusIsTerminal(existing.task.status) &&
+            !updateIsTerminal
+          ) {
+            return;
+          }
+          if (
+            existing !== undefined &&
+            existing.task.status === update.status &&
+            updateIsTerminal &&
+            existing.terminalStatusProjected
+          ) {
+            return;
+          }
+          // get_command_or_subagent_output may target monitors/bash tasks. Only
+          // hydrate when we already have a matching subagent lineage. Spawn ACKs
+          // (non-empty prompt) may create a new lineage; empty-prompt hydration
+          // with suppressNormalTool must not invent a phantom subagent.
+          if (existing === undefined) {
+            const isHydrationOnly = update.prompt === "" && update.title === null;
+            if (isHydrationOnly || update.suppressNormalTool === false) {
+              return;
+            }
+          }
+          const now = yield* DateTime.now;
+          const nativeTaskId = existing?.task.nativeTaskRef?.nativeId ?? update.nativeTaskId;
+          const nativeItemRef = {
+            driver,
+            nativeId: nativeTaskId,
+            strength: "strong" as const,
+          };
+          const nodeId =
+            existing?.task.id ??
+            idAllocator.derive.nodeFromProviderItem({
+              driver,
+              nativeItemId: nativeTaskId,
+            });
+          const childThreadId =
+            existing?.childThreadId ??
+            idAllocator.derive.threadFromProviderThread({
+              driver,
+              nativeThreadId: `${context.nativeThreadId}:task:${nativeTaskId}`,
+            });
+          const childRootNodeId =
+            existing?.childRootNodeId ??
+            idAllocator.derive.nodeFromProviderItem({
+              driver,
+              nativeItemId: `${nativeTaskId}:child-root`,
+            });
+          const turnItemId =
+            existing?.turnItemId ??
+            idAllocator.derive.turnItemFromProviderItem({
+              driver,
+              nativeItemId: nativeTaskId,
+            });
+          const turnItemOrdinal =
+            existing?.turnItemOrdinal ?? (yield* resolveItemOrdinal(context, nativeTaskId));
+          const taskStatus = update.status;
+          const task: OrchestrationV2Subagent = {
+            ...(existing?.task ?? {
+              id: nodeId,
+              threadId: context.input.threadId,
+              runId: context.input.runId,
+              parentNodeId: context.input.rootNodeId,
+              origin: "provider_native" as const,
+              createdBy: "agent" as const,
+              driver,
+              providerInstanceId: context.input.modelSelection.instanceId,
+              providerThreadId: null,
+              childThreadId,
+              nativeTaskRef: nativeItemRef,
+              prompt: update.prompt,
+              title: update.title,
+              model: update.model,
+              result: null,
+              startedAt: now,
+            }),
+            status: taskStatus,
+            result: existing?.assistantText || update.result,
+            completedAt: acpSubagentStatusIsTerminal(taskStatus) ? now : null,
+            updatedAt: now,
+          };
+          const subagent: ActiveAcpSubagent = existing ?? {
+            task,
+            childThreadId,
+            childRootNodeId,
+            turnItemId,
+            turnItemOrdinal,
+            providerTurnId: context.providerTurnId,
+            parentProviderThreadId: context.input.providerThread.id,
+            childSessionId: null,
+            assistantText: "",
+            nextChildOrdinal: 101,
+            terminalStatusProjected: false,
+          };
+          subagent.task = task;
+          context.subagents.set(nativeTaskId, subagent);
+
+          if (existing === undefined) {
+            yield* emitProviderEvent({
+              type: "app_thread.created",
+              driver,
+              appThread: makeSubagentChildThread({
+                parentThread: context.input.appThread,
+                childThreadId,
+                parentNodeId: nodeId,
+                activeProviderThreadId: null,
+                providerInstanceId: context.input.modelSelection.instanceId,
+                modelSelection: {
+                  ...context.input.modelSelection,
+                  model: update.model ?? context.input.modelSelection.model,
+                },
+                title: subagentThreadTitle({
+                  parentTitle: context.input.appThread.title,
+                  title: update.title,
+                  prompt: update.prompt,
+                  ordinal: context.subagents.size,
+                }),
+                now,
+                createdBy: "agent",
+                creationSource: "provider",
+              }),
+            });
+            const promptNativeItemId = `${nativeTaskId}:prompt`;
+            const promptArtifacts = makeSubagentConversationArtifacts({
+              messageId: idAllocator.derive.messageFromProviderItem({
+                driver,
+                nativeItemId: promptNativeItemId,
+              }),
+              turnItemId: idAllocator.derive.turnItemFromProviderItem({
+                driver,
+                nativeItemId: promptNativeItemId,
+              }),
+              threadId: childThreadId,
+              rootNodeId: childRootNodeId,
+              providerThreadId: null,
+              providerTurnId: null,
+              nativeItemRef: { driver, nativeId: promptNativeItemId, strength: "weak" },
+              role: "user",
+              text: update.prompt,
+              ordinal: 100,
+              now,
+            });
+            yield* emitProviderEvent({
+              type: "message.updated",
+              driver,
+              message: promptArtifacts.message,
+            });
+            yield* emitProviderEvent({
+              type: "turn_item.updated",
+              driver,
+              turnItem: promptArtifacts.turnItem,
+            });
+          }
+
+          if (update.childSessionId !== null && subagent.childSessionId === null) {
+            subagent.childSessionId = update.childSessionId;
+            context.subagentsBySessionId.set(update.childSessionId, subagent);
+            const providerThread = makeProviderThread({
+              driver,
+              providerInstanceId: context.input.modelSelection.instanceId,
+              idAllocator,
+              appThreadId: childThreadId,
+              providerSessionId: input.providerSessionId,
+              nativeThreadId: update.childSessionId,
+              forkedFrom: {
+                providerThreadId: context.input.providerThread.id,
+                providerTurnId: context.providerTurnId,
+              },
+              now,
+            });
+            subagent.task = { ...subagent.task, providerThreadId: providerThread.id };
+            yield* emitProviderEvent({
+              type: "provider_thread.updated",
+              driver,
+              providerThread: { ...providerThread, status: "idle" },
+            });
+            const buffered = context.pendingSubagentNotifications.get(update.childSessionId) ?? [];
+            context.pendingSubagentNotifications.delete(update.childSessionId);
+            yield* Effect.forEach(
+              buffered,
+              (notification) => projectSubagentNotification(subagent, notification),
+              { concurrency: 1, discard: true },
+            );
+          }
+
+          if (
+            taskStatus !== "running" &&
+            subagent.assistantText.length === 0 &&
+            update.result !== null
+          ) {
+            yield* emitSubagentAssistant(subagent, update.result);
+          }
+          const result = subagent.assistantText || update.result;
+          subagent.task = {
+            ...subagent.task,
+            status: taskStatus,
+            result,
+            completedAt: acpSubagentStatusIsTerminal(taskStatus) ? now : null,
+            updatedAt: now,
+          };
+          const providerThreadId = subagent.task.providerThreadId;
+          yield* emitProviderEvent({
+            type: "node.updated",
+            driver,
+            node: {
+              id: nodeId,
+              threadId: context.input.threadId,
+              runId: subagent.task.runId,
+              parentNodeId: subagent.task.parentNodeId,
+              rootNodeId: subagent.task.parentNodeId,
+              kind: "subagent",
+              status: taskStatus,
+              countsForRun: false,
+              providerThreadId: context.input.providerThread.id,
+              providerTurnId: subagent.providerTurnId,
+              nativeItemRef,
+              runtimeRequestId: null,
+              checkpointScopeId: null,
+              startedAt: subagent.task.startedAt,
+              completedAt: subagent.task.completedAt,
+            },
+          });
+          yield* emitProviderEvent({
+            type: "node.updated",
+            driver,
+            node: {
+              id: childRootNodeId,
+              threadId: childThreadId,
+              runId: null,
+              parentNodeId: null,
+              rootNodeId: childRootNodeId,
+              kind: "root_turn",
+              status: taskStatus,
+              countsForRun: false,
+              providerThreadId,
+              providerTurnId: null,
+              nativeItemRef,
+              runtimeRequestId: null,
+              checkpointScopeId: null,
+              startedAt: subagent.task.startedAt,
+              completedAt: subagent.task.completedAt,
+            },
+          });
+          yield* emitProviderEvent({ type: "subagent.updated", driver, subagent: subagent.task });
+          yield* emitProviderEvent({
+            type: "turn_item.updated",
+            driver,
+            turnItem: {
+              id: turnItemId,
+              threadId: context.input.threadId,
+              runId: subagent.task.runId,
+              nodeId,
+              providerThreadId: context.input.providerThread.id,
+              providerTurnId: subagent.providerTurnId,
+              nativeItemRef,
+              parentItemId: null,
+              ordinal: turnItemOrdinal,
+              status: taskStatus,
+              title: subagent.task.title,
+              startedAt: subagent.task.startedAt,
+              completedAt: subagent.task.completedAt,
+              updatedAt: now,
+              type: "subagent",
+              subagentId: subagent.task.id,
+              origin: "provider_native",
+              driver,
+              providerInstanceId: context.input.modelSelection.instanceId,
+              childThreadId,
+              prompt: subagent.task.prompt,
+              result,
+            },
+          });
+          if (acpSubagentStatusIsTerminal(taskStatus)) {
+            subagent.terminalStatusProjected = true;
+          }
+        });
+
+        const toolOutputText = (toolCall: AcpToolCallState): string => {
+          if (typeof toolCall.data.rawOutput === "string") {
+            return toolCall.data.rawOutput;
+          }
+          if (
+            typeof (toolCall.data.rawOutput as { text?: unknown } | undefined)?.text === "string"
+          ) {
+            return String((toolCall.data.rawOutput as { text: string }).text);
+          }
+          return textFromUnknown(toolCall.data.rawOutput) ?? "";
+        };
+
+        const setToolOutputText = (toolCall: AcpToolCallState, text: string): AcpToolCallState => ({
+          ...toolCall,
+          data: {
+            ...toolCall.data,
+            rawOutput: {
+              type: "Text",
+              text,
+            },
+          },
+        });
+
+        const appendToolOutputText = (
+          toolCall: AcpToolCallState,
+          appendOutput: string,
+        ): AcpToolCallState => {
+          if (appendOutput.length === 0) return toolCall;
+          return setToolOutputText(toolCall, `${toolOutputText(toolCall)}${appendOutput}`);
+        };
+
+        const isMonitorEndNoticeText = (text: string): boolean =>
+          /Monitor\s+["']?[0-9a-f-]{8,}/i.test(text) && /ended/i.test(text);
+
+        const hasDeferredBackgroundWork = (context: ActiveAcpTurn): boolean => {
+          if (context.awaitingBackgroundHydration.size > 0) return true;
+          if (context.pendingInjectedReport.size > 0) return true;
+          for (const [taskId, toolCallId] of context.toolCallIdsByBackgroundTaskId) {
+            // Persistent monitors stream after root settle; do not pin finalize.
+            if (context.persistentBackgroundTaskIds.has(taskId)) continue;
+            const tool = context.tools.get(toolCallId);
+            if (tool === undefined) continue;
+            const status = toolStatus(tool.status);
+            if (status === "pending" || status === "running") return true;
+          }
+          for (const subagent of context.subagents.values()) {
+            if (acpSubagentStatusBlocksTurnSettlement(subagent.task.status)) {
+              return true;
+            }
+          }
+          return false;
+        };
+
+        // scheduleDeferredFinalize is declared above openSession body start and
+        // assigned after finalizeTurn so forked finalize Effect typing stays clean.
+        const rearmDeferredFinalize = (context: ActiveAcpTurn) =>
+          Effect.gen(function* () {
+            if (!flavor.deferFinalizeForBackgroundWork) return;
+            if (!context.promptSettled || context.finalized) return;
+            if (hasDeferredBackgroundWork(context)) return;
+            yield* scheduleDeferredFinalize(context);
+          });
+
+        // `let` breaks circular inference from monitor hydration re-entry.
+        let emitTool: (
+          context: ActiveAcpTurn,
+          incoming: AcpToolCallState,
+          projectedStatus?: ProjectedToolStatus,
+        ) => Effect.Effect<void> = () => Effect.void;
+
+        const markAwaitingBackgroundHydration = (context: ActiveAcpTurn, taskId: string) =>
+          Effect.gen(function* () {
+            if (context.awaitingBackgroundHydration.has(taskId)) return;
+            context.awaitingBackgroundHydration.add(taskId);
+            // Safety: do not hold the root turn forever if the agent never hydrates.
+            yield* Effect.gen(function* () {
+              yield* Effect.sleep("60000 millis");
+              if (context.finalized || !context.awaitingBackgroundHydration.has(taskId)) return;
+              context.awaitingBackgroundHydration.delete(taskId);
+              // End notices keep the tool running until hydration; force-complete so
+              // deferred finalize can proceed when get_command never arrives.
+              const toolCallId = context.toolCallIdsByBackgroundTaskId.get(taskId);
+              const tool = toolCallId !== undefined ? context.tools.get(toolCallId) : undefined;
+              if (tool !== undefined) {
+                const status = toolStatus(tool.status);
+                if (status === "pending" || status === "running") {
+                  yield* emitTool(context, { ...tool, status: "completed" });
+                }
+              }
+              yield* rearmDeferredFinalize(context);
+            }).pipe(Effect.forkIn(sessionScope), Effect.asVoid);
+          });
+
+        const markPendingInjectedReport = (context: ActiveAcpTurn, taskId: string) =>
+          Effect.gen(function* () {
+            // Only the settled-and-held window has the race; mid-turn reports
+            // are protected by the prompt RPC still being open.
+            if (!context.promptSettled) return;
+            if (context.pendingInjectedReport.has(taskId)) return;
+            context.pendingInjectedReport.add(taskId);
+            // Safety: the injected turn may end without a report chunk.
+            yield* Effect.gen(function* () {
+              yield* Effect.sleep("25000 millis");
+              if (context.finalized || !context.pendingInjectedReport.has(taskId)) return;
+              context.pendingInjectedReport.delete(taskId);
+              yield* rearmDeferredFinalize(context);
+            }).pipe(Effect.forkIn(sessionScope), Effect.asVoid);
+          });
+
+        const clearMidTurnUnreportedTaskIds = (taskIds: ReadonlyArray<string>) =>
+          Ref.update(midTurnUnreportedCompletedTaskIds, (current) => {
+            let next: Set<string> | null = null;
+            for (const taskId of taskIds) {
+              if (!current.has(taskId)) continue;
+              if (next === null) next = new Set(current);
+              next.delete(taskId);
+            }
+            return next ?? current;
+          });
+
+        emitTool = Effect.fnUntraced(function* (
+          context: ActiveAcpTurn,
+          incoming: AcpToolCallState,
+          projectedStatus?: ProjectedToolStatus,
+        ) {
+          yield* closeTextStreams(context);
+          const previous = context.tools.get(incoming.toolCallId);
+          const merged = mergeToolCallState(previous, incoming);
+          const toolCall = flavor.normalizeToolCall?.(merged) ?? merged;
+          context.tools.set(toolCall.toolCallId, toolCall);
+          const backgroundTaskId = flavor.extractBackgroundTaskId?.(toolCall);
+          if (backgroundTaskId !== undefined) {
+            context.toolCallIdsByBackgroundTaskId.set(backgroundTaskId, toolCall.toolCallId);
+            if (flavor.isPersistentBackgroundTool?.(toolCall) === true) {
+              context.persistentBackgroundTaskIds.add(backgroundTaskId);
+            }
+            const backgroundStatus = projectedStatus ?? toolStatus(toolCall.status);
+            yield* setBackgroundTaskRunning(
+              backgroundTaskId,
+              backgroundStatus === "pending" || backgroundStatus === "running",
+            );
+            // Background tool that reaches a terminal status while the root
+            // prompt is still open (completed, failed, or interrupted) was
+            // consumed in-turn. Mark handled so late CLI re-reports and residual
+            // agent chatter do not open synthetic "Background task completed."
+            // runs. get_command TaskOutput still marks handled below.
+            // Only before promptSettled: after STARTED the deferred-finalize
+            // hold can let a monitor finish while the turn is still active;
+            // marking then would suppress the legitimate post-settle TaskOutput
+            // continuation (live: grok-post-settle-continuation-poll).
+            // Terminal statuses only after normalizeToolCall (start ACKs stay
+            // inProgress/running).
+            //
+            // Tradeoff: a pre-settle false "completed" normalization (Bash-
+            // shaped re-report with exit_code 0, or the hydration safety
+            // force-complete firing pre-settle) would permanently mark the task
+            // handled and suppress its injected report chatter. The deleted
+            // handled-id removal on late monitor-event mutations used to rescue
+            // that case; likelihood is low because mid-turn monitor ends
+            // normally arrive as reminder mutations that force inProgress, and
+            // re-reports are documented post-settle traffic.
+            if (
+              !context.promptSettled &&
+              backgroundStatus !== "pending" &&
+              backgroundStatus !== "running"
+            ) {
+              yield* Ref.update(handledBackgroundTaskIdsInActiveTurn, (current) =>
+                new Set(current).add(backgroundTaskId),
+              );
+              yield* Ref.update(midTurnUnreportedCompletedTaskIds, (current) => {
+                if (!current.has(backgroundTaskId)) return current;
+                const next = new Set(current);
+                next.delete(backgroundTaskId);
+                return next;
+              });
+            }
+          }
+
+          // get_command TaskOutput for registered monitor(s): hydrate those tools.
+          const backgroundCompletions =
+            projectedStatus === undefined
+              ? (flavor.extractBackgroundTaskCompletion?.(toolCall) ?? [])
+              : [];
+          let hydratedRegisteredMonitor = false;
+          for (const backgroundCompletion of backgroundCompletions) {
+            // Genuine end signal when terminal: tombstone so straggler
+            // monitor-event chatter cannot resurrect the running set after the
+            // task truly ended. A still-running poll keeps the id running.
+            yield* applyBackgroundTaskMutationRunning(backgroundCompletion);
+            if (backgroundCompletion.status !== "running") {
+              yield* Ref.update(handledBackgroundTaskIdsInActiveTurn, (current) =>
+                new Set(current).add(backgroundCompletion.taskId),
+              );
+              yield* Ref.update(midTurnUnreportedCompletedTaskIds, (current) => {
+                if (!current.has(backgroundCompletion.taskId)) return current;
+                const next = new Set(current);
+                next.delete(backgroundCompletion.taskId);
+                return next;
+              });
+            }
+            // A still-running fetch must keep the hydration hold (and its
+            // safety timer) alive until output actually lands.
+            if (backgroundCompletion.status !== "running") {
+              context.awaitingBackgroundHydration.delete(backgroundCompletion.taskId);
+            }
+            const targetToolCallId = context.toolCallIdsByBackgroundTaskId.get(
+              backgroundCompletion.taskId,
+            );
+            // Known background-task id (monitor registration) — never open a
+            // phantom subagent for the same get_output poll.
+            if (targetToolCallId !== undefined) {
+              hydratedRegisteredMonitor = true;
+            }
+            const target =
+              targetToolCallId !== undefined ? context.tools.get(targetToolCallId) : undefined;
+            if (target !== undefined && target.toolCallId !== toolCall.toolCallId) {
+              const nextStatus =
+                backgroundCompletion.status === "running"
+                  ? ("inProgress" as const)
+                  : backgroundCompletion.status === "failed"
+                    ? ("failed" as const)
+                    : ("completed" as const);
+              const hydrated =
+                backgroundCompletion.appendOutput.length > 0
+                  ? // TaskOutput is the real stdout; replace end-notice boilerplate
+                    // so the timeline shows the listing, not only "Monitor ended…".
+                    isMonitorEndNoticeText(toolOutputText(target)) ||
+                    toolOutputText(target).trim().length === 0
+                    ? setToolOutputText(
+                        { ...target, status: nextStatus },
+                        backgroundCompletion.appendOutput,
+                      )
+                    : appendToolOutputText(
+                        { ...target, status: nextStatus },
+                        backgroundCompletion.appendOutput,
+                      )
+                  : { ...target, status: nextStatus };
+              yield* emitTool(context, hydrated);
+            }
+          }
+
+          // Monitor TaskOutput shares the get_command tool shape with subagent
+          // hydration; do not spawn a phantom subagent for a registered monitor.
+          const subagentUpdate = hydratedRegisteredMonitor
+            ? undefined
+            : flavor.extractSubagentUpdate?.(toolCall);
+          if (subagentUpdate !== undefined) {
+            yield* emitSubagent(context, subagentUpdate);
+            if (subagentUpdate.suppressNormalTool !== false) {
+              yield* rearmDeferredFinalize(context);
+              return;
+            }
+          }
+          const status = projectedStatus ?? toolStatus(toolCall.status);
+          const now = yield* DateTime.now;
+          const nativeItemId = `${context.nativeThreadId}:tool:${toolCall.toolCallId}`;
+          const ordinal = yield* resolveItemOrdinal(context, nativeItemId);
+          const nodeId = idAllocator.derive.nodeFromProviderItem({ driver, nativeItemId });
+          const turnItemId = idAllocator.derive.turnItemFromProviderItem({
+            driver,
+            nativeItemId,
+          });
+          const nativeItemRef = {
+            driver,
+            nativeId: toolCall.toolCallId,
+            strength: "strong" as const,
+          };
+          const startedAt = context.toolStartedAt.get(toolCall.toolCallId) ?? now;
+          context.toolStartedAt.set(toolCall.toolCallId, startedAt);
+          const completedAt = completedAtForStatus(status, now);
+          const title = toolCall.title ?? null;
+          yield* emitProviderEvent({
+            type: "node.updated",
+            driver,
+            node: {
+              id: nodeId,
+              threadId: context.input.threadId,
+              runId: context.input.runId,
+              parentNodeId: context.input.rootNodeId,
+              rootNodeId: context.input.rootNodeId,
+              kind: "tool_call",
+              status: nodeStatus(status),
+              countsForRun: true,
+              providerThreadId: context.input.providerThread.id,
+              providerTurnId: context.providerTurnId,
+              nativeItemRef,
+              runtimeRequestId: null,
+              checkpointScopeId: null,
+              startedAt,
+              completedAt,
+            },
+          });
+
+          const base = {
+            id: turnItemId,
+            threadId: context.input.threadId,
+            runId: context.input.runId,
+            nodeId,
+            providerThreadId: context.input.providerThread.id,
+            providerTurnId: context.providerTurnId,
+            nativeItemRef,
+            parentItemId: null,
+            ordinal,
+            status,
+            title,
+            startedAt,
+            completedAt,
+            updatedAt: now,
+          } as const;
+          const rawInput = toolCall.data.rawInput;
+          const rawOutput = toolCall.data.rawOutput ?? toolCall.data.content;
+          const path = pathFromToolCall(toolCall);
+          const rawInputRecord = unknownRecord(rawInput);
+          const inputVariant =
+            typeof rawInputRecord?.variant === "string"
+              ? rawInputRecord.variant.trim().toLowerCase()
+              : "";
+          const rawOutputRecord = unknownRecord(rawOutput);
+          const outputCommand =
+            typeof rawOutputRecord?.command === "string" &&
+            rawOutputRecord.command.trim().length > 0
+              ? rawOutputRecord.command.trim()
+              : undefined;
+          const monitorCommand =
+            (typeof rawInputRecord?.command === "string" && rawInputRecord.command.trim().length > 0
+              ? rawInputRecord.command.trim()
+              : undefined) ?? outputCommand;
+          const outputIsBashResult =
+            typeof rawOutputRecord?.type === "string" &&
+            rawOutputRecord.type.trim().toLowerCase() === "bash" &&
+            commandExitCode(rawOutput) !== undefined;
+          // Grok Monitor tools arrive as generic kind + variant; project like shell
+          // so stdout is plain text in the timeline (not JSON {type:Text,text:...}).
+          // Post-settle wake re-reports of a finished monitor carry no rawInput at
+          // all, only a structured Bash result; project those as commands too.
+          const projectAsCommandExecution = inputVariant === "monitor" || outputIsBashResult;
+          let turnItem: OrchestrationV2TurnItem;
+          switch (toolCall.kind) {
+            case "read":
+            case "search":
+              turnItem = {
+                ...base,
+                type: "file_search",
+                ...(path === undefined ? {} : { pattern: path }),
+                ...(path === undefined
+                  ? {}
+                  : {
+                      results: [
+                        {
+                          fileName: path,
+                          ...(textFromUnknown(rawOutput) === undefined
+                            ? {}
+                            : { preview: textFromUnknown(rawOutput) }),
+                        },
+                      ],
+                    }),
+              };
+              break;
+            case "execute": {
+              const exitCode = acpProjectedCommandExitCode(status, rawOutput);
+              turnItem = {
+                ...base,
+                type: "command_execution",
+                input: toolCall.command ?? monitorCommand ?? toolCall.title ?? "Command",
+                ...(textFromUnknown(rawOutput) === undefined
+                  ? {}
+                  : { output: textFromUnknown(rawOutput) }),
+                ...(exitCode === undefined ? {} : { exitCode }),
+              };
+              break;
+            }
+            case "edit":
+            case "delete":
+            case "move":
+              turnItem = {
+                ...base,
+                type: "file_change",
+                fileName: path ?? toolCall.title ?? "File change",
+                ...(textFromUnknown(rawOutput) === undefined
+                  ? {}
+                  : { diffStr: textFromUnknown(rawOutput) }),
+              };
+              break;
+            case "fetch":
+              turnItem = {
+                ...base,
+                type: "web_search",
+                ...(path === undefined ? {} : { patterns: [path] }),
+                ...(path === undefined
+                  ? {}
+                  : {
+                      results: [
+                        {
+                          url: path,
+                          ...(textFromUnknown(rawOutput) === undefined
+                            ? {}
+                            : { snippet: textFromUnknown(rawOutput) }),
+                        },
+                      ],
+                    }),
+              };
+              break;
+            default:
+              if (projectAsCommandExecution) {
+                const exitCode = acpProjectedCommandExitCode(status, rawOutput);
+                turnItem = {
+                  ...base,
+                  type: "command_execution",
+                  input:
+                    toolCall.command ??
+                    monitorCommand ??
+                    toolCall.title ??
+                    (inputVariant === "monitor" ? "Monitor" : "Command"),
+                  ...(textFromUnknown(rawOutput) === undefined
+                    ? {}
+                    : { output: textFromUnknown(rawOutput) }),
+                  ...(exitCode === undefined ? {} : { exitCode }),
+                };
+              } else {
+                turnItem = {
+                  ...base,
+                  type: "dynamic_tool",
+                  toolName: toolCall.title ?? toolCall.kind ?? null,
+                  input: rawInput ?? {},
+                  ...(rawOutput === undefined ? {} : { output: rawOutput }),
+                };
+              }
+          }
+          yield* emitProviderEvent({ type: "turn_item.updated", driver, turnItem });
+          yield* rearmDeferredFinalize(context);
+        });
+
+        const emitPlan = Effect.fnUntraced(function* (
+          context: ActiveAcpTurn,
+          update: AcpPlanUpdate,
+        ) {
+          yield* closeTextStreams(context);
+          const nativeItemId = `${context.nativeTurnId}:plan`;
+          const ordinal = yield* resolveItemOrdinal(context, nativeItemId);
+          const now = yield* DateTime.now;
+          const nodeId = idAllocator.derive.nodeFromProviderItem({ driver, nativeItemId });
+          const turnItemId = idAllocator.derive.turnItemFromProviderItem({
+            driver,
+            nativeItemId,
+          });
+          if (context.plan === null) {
+            context.plan = {
+              id: yield* idAllocator.allocate.plan({
+                threadId: context.input.threadId,
+                runId: context.input.runId,
+                driver,
+              }),
+              startedAt: now,
+            };
+          }
+          const planId = context.plan.id;
+          const steps: ReadonlyArray<OrchestrationV2PlanStep> = update.plan.map((step, index) => ({
+            id: `acp-step-${index + 1}`,
+            text: nonEmptyText(step.step, `Step ${index + 1}`),
+            status:
+              step.status === "inProgress"
+                ? "running"
+                : step.status === "completed"
+                  ? "completed"
+                  : "pending",
+          }));
+          const completed = steps.length > 0 && steps.every((step) => step.status === "completed");
+          const nativeItemRef = { driver, nativeId: nativeItemId, strength: "weak" as const };
+          const plan: OrchestrationV2PlanArtifact = {
+            id: planId,
+            threadId: context.input.threadId,
+            runId: context.input.runId,
+            nodeId,
+            status: completed ? "completed" : "active",
+            kind: "todo_list",
+            steps,
+            ...(update.explanation == null ? {} : { explanation: update.explanation }),
+          };
+          yield* emitProviderEvent({
+            type: "node.updated",
+            driver,
+            node: {
+              id: nodeId,
+              threadId: context.input.threadId,
+              runId: context.input.runId,
+              parentNodeId: context.input.rootNodeId,
+              rootNodeId: context.input.rootNodeId,
+              kind: "todo_list",
+              status: completed ? "completed" : "running",
+              countsForRun: false,
+              providerThreadId: context.input.providerThread.id,
+              providerTurnId: context.providerTurnId,
+              nativeItemRef,
+              runtimeRequestId: null,
+              checkpointScopeId: null,
+              startedAt: context.plan.startedAt,
+              completedAt: completed ? now : null,
+            },
+          });
+          yield* emitProviderEvent({ type: "plan.updated", driver, plan });
+          yield* emitProviderEvent({
+            type: "turn_item.updated",
+            driver,
+            turnItem: {
+              id: turnItemId,
+              threadId: context.input.threadId,
+              runId: context.input.runId,
+              nodeId,
+              providerThreadId: context.input.providerThread.id,
+              providerTurnId: context.providerTurnId,
+              nativeItemRef,
+              parentItemId: null,
+              ordinal,
+              status: completed ? "completed" : "running",
+              title: null,
+              startedAt: context.plan.startedAt,
+              completedAt: completed ? now : null,
+              updatedAt: now,
+              type: "todo_list",
+              planId,
+              steps,
+              ...(update.explanation == null ? {} : { explanation: update.explanation }),
+            },
+          });
+        });
+
+        const appendLoadedHistory = (
+          notification: EffectAcpSchema.SessionNotification,
+          role: "user" | "assistant",
+          text: string,
+        ) =>
+          Effect.gen(function* () {
+            if (text.length === 0) return;
+            const now = yield* DateTime.now;
+            yield* Ref.update(snapshot, (current) => {
+              const startsNew = current.loadingRole !== role;
+              const loadingIndex = startsNew ? current.loadingIndex + 1 : current.loadingIndex;
+              const nativeItemId = `${notification.sessionId}:history:${role}:${loadingIndex}`;
+              const messageId = idAllocator.derive.messageFromProviderItem({
+                driver,
+                nativeItemId,
+              });
+              const key = String(messageId);
+              const previous = current.messages.get(key);
+              const messages = new Map(current.messages);
+              messages.set(key, {
+                createdBy: previous?.createdBy ?? (role === "user" ? "user" : "agent"),
+                creationSource: previous?.creationSource ?? "provider",
+                id: messageId,
+                threadId: input.threadId,
+                runId: null,
+                nodeId: null,
+                role,
+                text: `${previous?.text ?? ""}${text}`,
+                attachments: [],
+                streaming: false,
+                createdAt: previous?.createdAt ?? now,
+                updatedAt: now,
+              });
+              return {
+                order: current.order.includes(key) ? current.order : [...current.order, key],
+                messages,
+                loadingRole: role,
+                loadingIndex,
+              };
+            });
+          });
+
+        const offerContinuationRun = Effect.fnUntraced(function* (_sessionId: string) {
+          if (continuationRequests === undefined) {
+            return false;
+          }
+          const pending = yield* continuationPermit.withPermit(
+            Effect.gen(function* () {
+              if (yield* Ref.get(continuationClosed)) return Option.none();
+              if (yield* Ref.get(stoppedRunQuarantine)) return Option.none();
+              if (yield* Ref.get(continuationRequested)) return Option.none();
+              const route = yield* Ref.get(lastTurnRoute);
+              if (route === null) return Option.none();
+              yield* Ref.set(continuationRequested, true);
+              const generation = yield* Ref.updateAndGet(
+                continuationGeneration,
+                (value) => value + 1,
+              );
+              return Option.some({ route, generation });
+            }),
+          );
+          if (Option.isNone(pending)) return false;
+          const { route, generation } = pending.value;
+          yield* Effect.logInfo("orchestration-v2.acp-wake-turn-detected", {
+            driver,
+            providerSessionId: input.providerSessionId,
+            threadId: route.threadId,
+            providerThreadId: route.providerThreadId,
+          });
+          yield* continuationRequests.offer({
+            threadId: route.threadId,
+            providerThreadId: route.providerThreadId,
+            driver,
+            detail: null,
+            clearIfCurrent: () =>
+              continuationPermit.withPermit(
+                Effect.gen(function* () {
+                  if ((yield* Ref.get(continuationGeneration)) === generation) {
+                    yield* Ref.set(continuationRequested, false);
+                  }
+                }),
+              ),
+            dispatchIfCurrent: (effect) =>
+              continuationPermit.withPermit(
+                Effect.gen(function* () {
+                  const clearIfOwner = Effect.gen(function* () {
+                    if ((yield* Ref.get(continuationGeneration)) === generation) {
+                      yield* Ref.set(continuationRequested, false);
+                    }
+                  });
+                  if (yield* Ref.get(stoppedRunQuarantine)) {
+                    yield* clearIfOwner;
+                    return Option.none();
+                  }
+                  if ((yield* Ref.get(continuationGeneration)) !== generation) {
+                    // Superseded by a newer offer; do not clear its flag.
+                    return Option.none();
+                  }
+                  if (!(yield* Ref.get(continuationRequested))) return Option.none();
+                  // A successful durable dispatch owns the sticky flag until its
+                  // continuation turn starts. Clearing here opens a dispatch-to-
+                  // start race where every late ACP frame can enqueue another
+                  // synthetic continuation. Failures clear immediately because
+                  // no turn will arrive to do so.
+                  const exit = yield* Effect.exit(effect);
+                  if (Exit.isFailure(exit)) {
+                    yield* clearIfOwner;
+                    return yield* Effect.failCause(exit.cause);
+                  }
+                  return Option.some(exit.value);
+                }),
+              ),
+          });
+          return true;
+        });
+
+        const applyLateBackgroundMutation = Effect.fnUntraced(function* (
+          sessionId: string,
+          mutation: {
+            readonly taskId: string;
+            readonly status: "running" | "completed" | "failed";
+          },
+        ) {
+          const taskAlreadyEnded = (yield* Ref.get(endedBackgroundTaskIds)).has(mutation.taskId);
+          yield* applyBackgroundTaskMutationRunning(mutation);
+          if (mutation.status === "running") {
+            // Straggler running notice after a genuine end: suppress residual
+            // monitor-prompt agent chatter so it cannot open a synthetic wake.
+            if (taskAlreadyEnded && acpPostSettleMonitorPromptShouldSuppress(mutation)) {
+              yield* Ref.set(suppressPostSettleMonitorPrompt, true);
+            }
+            return;
+          }
+          // First genuine terminal: allow subsequent agent output. Re-delivery
+          // of an already-ended terminal must not un-suppress residual ack
+          // chatter from the injected monitor-event turn.
+          if (!taskAlreadyEnded) {
+            yield* Ref.set(suppressPostSettleMonitorPrompt, false);
+          }
+          // Keep handledBackgroundTaskIdsInActiveTurn intact. Erasing the mark
+          // on a late monitor-event mutation defeated the in-turn chatter guard
+          // and let injected-turn acks arm wakeBuffer for a later spurious
+          // "Background task completed." run (multiturn live repro). Monitors
+          // the agent settled without reporting never enter that set, so their
+          // injected report still streams via pendingInjectedReport / hold.
+          const activeContext = yield* Ref.get(activeTurn);
+          // Completions that land while a root turn is still streaming are
+          // owned by in-turn machinery (emitTool handled marks, deferred
+          // finalize, injected-report hold). Do not open a synthetic wake mid-
+          // turn; finalizeTurn re-checks wakeBuffer / midTurnUnreported once
+          // the turn leaves the active slot so legitimate unhandled evidence
+          // still offers after finalize.
+          if (activeContext !== null && !activeContext.finalized) {
+            const handled = yield* Ref.get(handledBackgroundTaskIdsInActiveTurn);
+            // Only arm deferred wake when this turn registered the task (monitor
+            // tool started in-turn) and the root prompt is still open. Completions
+            // that land in the settled-held window (promptSettled, deferred
+            // finalize holding for injected report) fall back to the pre-existing
+            // post-finalize injected-turn path; arming here would spuriously
+            // offer "Background task completed." after the report streams into
+            // the held turn. Residual cancel-backgrounded completions from a
+            // prior interrupt must not open a synthetic continuation.
+            if (
+              !activeContext.promptSettled &&
+              !handled.has(mutation.taskId) &&
+              activeContext.toolCallIdsByBackgroundTaskId.has(mutation.taskId)
+            ) {
+              yield* Ref.update(midTurnUnreportedCompletedTaskIds, (current) =>
+                new Set(current).add(mutation.taskId),
+              );
+            }
+            return;
+          }
+          if (
+            postSettleContinuationEnabled &&
+            (yield* Ref.get(activeSessionId)) === sessionId &&
+            (yield* Ref.get(runningBackgroundTaskIds)).size === 0 &&
+            ((yield* Ref.get(wakeBuffer)).length > 0 ||
+              (yield* Ref.get(midTurnUnreportedCompletedTaskIds)).size > 0)
+          ) {
+            yield* offerContinuationRun(sessionId);
+          }
+        });
+
+        const bufferPostSettleWake = Effect.fnUntraced(function* (
+          notification: EffectAcpSchema.SessionNotification,
+        ) {
+          if (!postSettleContinuationEnabled || continuationRequests === undefined) {
+            return {
+              buffered: false,
+              offerContinuation: false,
+              stopProcessing: false,
+            };
+          }
+          // Direct Stop quarantine: drop residual wake evidence instead of
+          // buffering it for a later continuation or follow-up run.
+          if (yield* Ref.get(stoppedRunQuarantine)) {
+            return {
+              buffered: false,
+              offerContinuation: false,
+              stopProcessing: true,
+            };
+          }
+          const rootSessionId = yield* Ref.get(activeSessionId);
+          if (rootSessionId === null || notification.sessionId !== rootSessionId) {
+            return {
+              buffered: false,
+              offerContinuation: false,
+              stopProcessing: false,
+            };
+          }
+          if (!acpPostSettleWakeEvidence(notification, flavor)) {
+            return {
+              buffered: false,
+              offerContinuation: false,
+              stopProcessing: false,
+            };
+          }
+          const update = notification.update;
+          let alreadyHandledToolUpdate = false;
+          if (update.sessionUpdate === "tool_call" || update.sessionUpdate === "tool_call_update") {
+            yield* trackRunningBackgroundTools(notification);
+            // When the agent consumes the monitor output itself via
+            // get_command_or_subagent_output (long timeout), the TaskOutput
+            // completion is the ONLY end signal: no "Monitor ended" reminder
+            // follows. Without applying it here the running set never clears,
+            // every offer stays suppressed, and the wake buffer never drains
+            // (observed live 2026-07-12, thread 8dbe607f). The completion
+            // frame itself is offer evidence, so clearing the id before the
+            // gate below lets it open the single continuation run.
+            for (const event of parseSessionUpdateEvent(notification).events) {
+              if (event._tag !== "ToolCallUpdated") continue;
+              const toolCall = flavor.normalizeToolCall?.(event.toolCall) ?? event.toolCall;
+              const proposedPlanMarkdown = flavor.extractProposedPlanMarkdown?.(toolCall);
+              if (proposedPlanMarkdown !== undefined && proposedPlanMarkdown.length > 0) {
+                yield* captureProposedPlan({ planMarkdown: proposedPlanMarkdown });
+              }
+              const toolTaskId = flavor.extractBackgroundTaskId?.(toolCall);
+              if (
+                toolTaskId !== undefined &&
+                (yield* Ref.get(handledBackgroundTaskIdsInActiveTurn)).has(toolTaskId)
+              ) {
+                alreadyHandledToolUpdate = true;
+              }
+              if (flavor.extractBackgroundTaskCompletion !== undefined) {
+                for (const completion of flavor.extractBackgroundTaskCompletion(toolCall)) {
+                  alreadyHandledToolUpdate =
+                    alreadyHandledToolUpdate ||
+                    (yield* Ref.get(handledBackgroundTaskIdsInActiveTurn)).has(completion.taskId);
+                  yield* applyBackgroundTaskMutationRunning(completion);
+                }
+              }
+            }
+          }
+          const backgroundWorkRunning = (yield* Ref.get(runningBackgroundTaskIds)).size > 0;
+          // Residual Grok agent/thought chatter after in-turn-handled background
+          // work must not be retained as wake evidence. Tool-path alreadyHandled
+          // covers re-reports with a task id; this covers agent_message_chunk /
+          // agent_thought_chunk frames that carry no task id (live:
+          // grok-in-turn-monitor-no-wake, multiturn stale-buffer arm). Check
+          // before buffering so the frames cannot dirty wakeBuffer and later
+          // arm a mid-turn offer when a second monitor completes.
+          const handledInTurnCount = (yield* Ref.get(handledBackgroundTaskIdsInActiveTurn)).size;
+          const isInTurnHandledAgentChatter =
+            handledInTurnCount > 0 &&
+            (update.sessionUpdate === "agent_message_chunk" ||
+              update.sessionUpdate === "agent_thought_chunk");
+          // Grok prompts itself for every monitor event after the root turn
+          // settles. Its assistant/reasoning replies are progress chatter, not
+          // separate wake results. Retaining them would replay the entire burst
+          // into the single continuation once the monitor finishes. Keep tool
+          // state so the final command card still hydrates, then begin retaining
+          // agent output again after the genuine end signal clears the running
+          // set. With multiple tasks, text remains best-effort until every task
+          // ends; their retained tool cards are the authoritative results.
+          //
+          // Skip retaining frames for tasks already hydrated in the root turn
+          // (`handledBackgroundTaskIdsInActiveTurn`). Those re-reports must not
+          // pin `hasPendingBackgroundWork` via a wake buffer that never drains
+          // (the already-handled gate below intentionally skips
+          // `offerContinuationRun` to avoid synthetic "Background task
+          // completed." spam).
+          let buffered = false;
+          if (
+            !alreadyHandledToolUpdate &&
+            !isInTurnHandledAgentChatter &&
+            acpPostSettleWakeShouldBuffer(notification, backgroundWorkRunning)
+          ) {
+            yield* Ref.update(wakeBuffer, (current) => [...current, notification]);
+            buffered = true;
+          }
+          // Buffer progress without offering; only completion-like frames open a run.
+          if (!acpPostSettleContinuationOfferEvidence(notification, flavor)) {
+            return {
+              buffered,
+              offerContinuation: false,
+              stopProcessing: true,
+            };
+          }
+          // While a monitor is still streaming, tool re-reports buffer without
+          // offering and per-event agent commentary is consumed without being
+          // retained. Grok re-reports a running monitor as Bash frames that
+          // already carry exit_code 0 mid-stream, so a "terminal" normalized
+          // status is not evidence the task ended; each burst would otherwise
+          // reopen a synthetic "Background task completed." run. Retained tool
+          // frames drain into the single continuation offered once the monitor
+          // actually ends (end-notice mutation below, or the first frame after
+          // it).
+          if (backgroundWorkRunning) {
+            return {
+              buffered,
+              offerContinuation: false,
+              stopProcessing: true,
+            };
+          }
+          if (alreadyHandledToolUpdate) {
+            // Drop leftover wake noise for in-turn-handled work so idle release
+            // is not pinned forever. Leave the buffer alone when a continuation
+            // is already outstanding: its startTurn will drain legitimate frames
+            // from other tasks.
+            if (!(yield* Ref.get(continuationRequested))) {
+              yield* Ref.set(wakeBuffer, []);
+            }
+            return {
+              buffered,
+              offerContinuation: false,
+              stopProcessing: true,
+            };
+          }
+          // Same in-turn-handled agent chatter: do not open a synthetic wake.
+          // Do not clear wakeBuffer here: frames for other still-tracked tasks
+          // must remain drainable when a real (tool) completion later offers.
+          if (isInTurnHandledAgentChatter) {
+            return {
+              buffered,
+              offerContinuation: false,
+              stopProcessing: true,
+            };
+          }
+          return {
+            buffered,
+            offerContinuation: true,
+            stopProcessing: true,
+          };
+        });
+
+        let applyFinalizedActiveTurnSubagentTerminal: (
+          context: ActiveAcpTurn,
+          notification: EffectAcpSchema.SessionNotification,
+        ) => Effect.Effect<boolean> = () => Effect.succeed(false);
+
+        const handleSessionUpdate = Effect.fnUntraced(function* (
+          notification: EffectAcpSchema.SessionNotification,
+        ) {
+          const context = yield* Ref.get(activeTurn);
+          const update = notification.update;
+          if (
+            context?.finalized === true &&
+            (yield* applyFinalizedActiveTurnSubagentTerminal(context, notification))
+          ) {
+            return;
+          }
+          // Only while a finalized turn is still the active context. When
+          // activeTurn is null, post-settle agent frames must reach
+          // bufferPostSettleWake so continuation can attach (context?.finalized
+          // !== false incorrectly treated null as finalized and dropped them).
+          if (
+            context !== null &&
+            context.finalized &&
+            (yield* Ref.get(handledBackgroundTaskIdsInActiveTurn)).size > 0 &&
+            (update.sessionUpdate === "agent_message_chunk" ||
+              update.sessionUpdate === "agent_thought_chunk")
+          ) {
+            yield* Ref.set(suppressPostSettleMonitorPrompt, true);
+            return;
+          }
+          if (
+            context !== null &&
+            (yield* Ref.get(suppressPostSettleMonitorPrompt)) &&
+            (update.sessionUpdate === "agent_message_chunk" ||
+              update.sessionUpdate === "agent_thought_chunk")
+          ) {
+            return;
+          }
+          if (
+            context?.finalized === true &&
+            update.sessionUpdate === "user_message_chunk" &&
+            update.content.type === "text"
+          ) {
+            const mutations = flavor.extractBackgroundToolMutation?.(update.content.text) ?? [];
+            for (const mutation of mutations) {
+              yield* applyLateBackgroundMutation(notification.sessionId, mutation);
+            }
+            return;
+          }
+          if (context === null) {
+            // Direct Stop: quarantine residual events from the stopped run so
+            // they cannot become history, wake buffers, or a later run attach.
+            if (yield* Ref.get(stoppedRunQuarantine)) {
+              return;
+            }
+            const bufferOutcome = yield* bufferPostSettleWake(notification);
+            // Post-settle carryover sync: keep in-memory carryover accurate so
+            // hasPendingBackgroundWork reasons correctly after root settle.
+            // A completed root keeps its subscriber open while background items
+            // remain, so project its terminals immediately even when the wake
+            // frame is buffered for a continuation. Non-completed roots stay
+            // memory-only: durable ingest requires a subscriber that owns the
+            // original runId, which the interrupted path does not guarantee.
+            const carryover = yield* Ref.get(carryoverSubagents);
+            const rootTerminalCanStillProject =
+              carryover !== null &&
+              carryover.sessionId === (yield* Ref.get(activeSessionId)) &&
+              carryover.rootTerminalStatus === "completed";
+            const projectCarryover = rootTerminalCanStillProject;
+            let carryoverTerminalized = false;
+            if (
+              flavor.extractSubagentUpdate !== undefined &&
+              (update.sessionUpdate === "tool_call" || update.sessionUpdate === "tool_call_update")
+            ) {
+              for (const event of parseSessionUpdateEvent(notification).events) {
+                if (event._tag !== "ToolCallUpdated") continue;
+                const toolCall = flavor.normalizeToolCall?.(event.toolCall) ?? event.toolCall;
+                const subagentUpdate = flavor.extractSubagentUpdate(toolCall);
+                if (subagentUpdate === undefined) continue;
+                if (!acpSubagentStatusIsTerminal(subagentUpdate.status)) {
+                  continue;
+                }
+                if (
+                  yield* updateCarryoverSubagentStatus(
+                    subagentUpdate.nativeTaskId,
+                    subagentUpdate.status,
+                    subagentUpdate.result,
+                    { project: projectCarryover },
+                  )
+                ) {
+                  carryoverTerminalized = true;
+                }
+                if (
+                  subagentUpdate.childSessionId !== null &&
+                  (yield* updateCarryoverSubagentStatus(
+                    subagentUpdate.childSessionId,
+                    subagentUpdate.status,
+                    subagentUpdate.result,
+                    { project: projectCarryover },
+                  ))
+                ) {
+                  carryoverTerminalized = true;
+                }
+              }
+            }
+            if (
+              update.sessionUpdate === "user_message_chunk" &&
+              update.content.type === "text" &&
+              flavor.extractSubagentEndNotice !== undefined
+            ) {
+              const notice = flavor.extractSubagentEndNotice(update.content.text);
+              if (
+                notice !== undefined &&
+                (yield* updateCarryoverSubagentStatus(
+                  notice.childSessionId,
+                  notice.status,
+                  undefined,
+                  {
+                    project: projectCarryover,
+                  },
+                ))
+              ) {
+                carryoverTerminalized = true;
+              }
+            }
+            // Synchronize carryover before an eager continuation can attach and
+            // drain the frame.
+            const continuationOffered = bufferOutcome.offerContinuation
+              ? yield* offerContinuationRun(notification.sessionId)
+              : false;
+            const wakeOutcome = { ...bufferOutcome, continuationOffered };
+            // Frames that will not buffer never reach the continuation drain for
+            // this traffic. Once carryover is terminalized, skip history append /
+            // residual handling (and avoid double-projecting on child re-entry).
+            if (carryoverTerminalized && !wakeOutcome.buffered) {
+              // Projected above. Never clear a non-empty wakeBuffer. A sticky
+              // continuationRequested with an empty buffer is safe to drop so
+              // idle release is not wed on a pin with nothing to deliver.
+              if (
+                acpCarryoverTerminalShouldClearContinuation({
+                  continuationOffered: wakeOutcome.continuationOffered,
+                  wakeBufferLength: (yield* Ref.get(wakeBuffer)).length,
+                })
+              ) {
+                yield* Ref.set(continuationRequested, false);
+              }
+              return;
+            }
+            // Prefer continuation buffering over history append so the same
+            // frames are not double-counted once a continuation run attaches.
+            if (wakeOutcome.stopProcessing) {
+              return;
+            }
+            if (
+              (update.sessionUpdate === "user_message_chunk" ||
+                update.sessionUpdate === "agent_message_chunk") &&
+              update.content.type === "text"
+            ) {
+              // Late monitor end/event reminders must not become ghost user/assistant
+              // history (or OS-facing chatter) after the root turn already finalized.
+              const text = update.content.text;
+              const lateBackgroundMutations = flavor.extractBackgroundToolMutation?.(text) ?? [];
+              for (const lateBackgroundMutation of lateBackgroundMutations) {
+                yield* applyLateBackgroundMutation(notification.sessionId, lateBackgroundMutation);
+              }
+              const lateMonitorChatter =
+                /<monitor-event\b/i.test(text) ||
+                /Monitor\s+["']?[0-9a-f-]{8,}["']?\s+ended/i.test(text);
+              if (
+                text.trim().length > 0 &&
+                lateBackgroundMutations.length === 0 &&
+                !lateMonitorChatter
+              ) {
+                yield* appendLoadedHistory(
+                  notification,
+                  update.sessionUpdate === "user_message_chunk" ? "user" : "assistant",
+                  text,
+                );
+              }
+            } else if (
+              update.sessionUpdate === "tool_call" ||
+              update.sessionUpdate === "tool_call_update" ||
+              update.sessionUpdate === "plan"
+            ) {
+              yield* Ref.update(snapshot, (current) => ({ ...current, loadingRole: null }));
+            }
+            return;
+          }
+          if (context.finalized) return;
+          if (notification.sessionId !== (yield* Ref.get(activeSessionId))) {
+            // Finalize may have completed during the activeSessionId yield.
+            if (context.finalized) return;
+            if (flavor.extractSubagentUpdate === undefined) return;
+            const subagent = context.subagentsBySessionId.get(notification.sessionId);
+            if (
+              update.sessionUpdate === "tool_call" ||
+              update.sessionUpdate === "tool_call_update"
+            ) {
+              if (subagent === undefined) return;
+              const nativeTaskId =
+                subagent.task.nativeTaskRef?.nativeId ?? String(subagent.task.id);
+              for (const event of parseSessionUpdateEvent(notification).events) {
+                if (event._tag !== "ToolCallUpdated") continue;
+                const toolCall = flavor.normalizeToolCall?.(event.toolCall) ?? event.toolCall;
+                const subagentUpdate = flavor.extractSubagentUpdate(toolCall);
+                if (
+                  subagentUpdate === undefined ||
+                  (subagentUpdate.nativeTaskId !== nativeTaskId &&
+                    subagentUpdate.childSessionId !== notification.sessionId)
+                ) {
+                  continue;
+                }
+                yield* emitSubagent(context, subagentUpdate);
+              }
+              return;
+            }
+            if (update.sessionUpdate !== "agent_message_chunk" || update.content.type !== "text") {
+              return;
+            }
+            if (subagent !== undefined) {
+              yield* projectSubagentNotification(subagent, notification);
+              return;
+            }
+            const buffered = context.pendingSubagentNotifications.get(notification.sessionId) ?? [];
+            buffered.push(notification);
+            context.pendingSubagentNotifications.set(notification.sessionId, buffered);
+            return;
+          }
+          // Re-check after the activeSessionId yield: idle/prompt settle can
+          // finalize the same context object while we waited.
+          if (context.finalized) return;
+          switch (update.sessionUpdate) {
+            case "agent_message_chunk":
+              if (update.content.type === "text") {
+                const startsNewAssistantSegment = context.assistant.current === null;
+                // The injected-turn report is streaming; the normal debounce
+                // after the last chunk takes over from here. Drop matching
+                // mid-turn armed ids so finalize does not open a duplicate
+                // wake after the report already projected into this turn.
+                if (context.pendingInjectedReport.size > 0) {
+                  const reportedTaskIds = [...context.pendingInjectedReport];
+                  context.pendingInjectedReport.clear();
+                  yield* clearMidTurnUnreportedTaskIds(reportedTaskIds);
+                } else if (
+                  startsNewAssistantSegment &&
+                  context.promptSettled &&
+                  (yield* Ref.get(midTurnUnreportedCompletedTaskIds)).size > 0
+                ) {
+                  // Some ACP implementations deliver the injected assistant
+                  // report before the synthetic monitor end notice. Correlation
+                  // arrives with that notice, so remember the unmatched report
+                  // and consume its task id when the notice follows.
+                  context.earlyInjectedReportObserved = true;
+                }
+                yield* appendText(context, "assistant", update.content.text);
+              }
+              break;
+            case "agent_thought_chunk":
+              if (update.content.type === "text") {
+                yield* appendText(context, "reasoning", update.content.text);
+              }
+              break;
+            case "user_message_chunk":
+              if (update.content.type === "text" && flavor.extractBackgroundToolMutation) {
+                const mutations = flavor.extractBackgroundToolMutation(update.content.text);
+                const terminalTaskIds = mutations
+                  .filter((mutation) => mutation.status !== "running")
+                  .map((mutation) => mutation.taskId);
+                const reportArrivedBeforeNotice =
+                  context.earlyInjectedReportObserved && terminalTaskIds.length > 0;
+                if (reportArrivedBeforeNotice) {
+                  context.earlyInjectedReportObserved = false;
+                  yield* clearMidTurnUnreportedTaskIds(terminalTaskIds);
+                }
+                for (const mutation of mutations) {
+                  const toolCallId = context.toolCallIdsByBackgroundTaskId.get(mutation.taskId);
+                  const previous =
+                    toolCallId !== undefined ? context.tools.get(toolCallId) : undefined;
+                  if (previous !== undefined) {
+                    let nextStatus =
+                      mutation.status === "running"
+                        ? ("inProgress" as const)
+                        : mutation.status === "failed"
+                          ? ("failed" as const)
+                          : ("completed" as const);
+                    // End notices typically omit full stdout (no get_command mention
+                    // either). Keep the tool running and hold finalize until
+                    // TaskOutput hydrates, or the safety timer force-completes.
+                    if (nextStatus !== "inProgress") {
+                      yield* markAwaitingBackgroundHydration(context, mutation.taskId);
+                      nextStatus = "inProgress";
+                    }
+                    yield* emitTool(
+                      context,
+                      appendToolOutputText(
+                        { ...previous, status: nextStatus },
+                        mutation.appendOutput,
+                      ),
+                    );
+                  }
+                  // After emitTool: the hydration hold keeps the tool row at
+                  // inProgress past an end notice, but the offer gate must see
+                  // the mutation's semantic status. Also tracks monitors that
+                  // never surfaced a tool_call row at all.
+                  yield* applyBackgroundTaskMutationRunning(mutation);
+                  if (mutation.status !== "running" && !reportArrivedBeforeNotice) {
+                    yield* markPendingInjectedReport(context, mutation.taskId);
+                  }
+                }
+              }
+              if (update.content.type === "text" && flavor.extractSubagentEndNotice) {
+                const notice = flavor.extractSubagentEndNotice(update.content.text);
+                const subagent =
+                  notice !== undefined
+                    ? context.subagentsBySessionId.get(notice.childSessionId)
+                    : undefined;
+                if (
+                  notice !== undefined &&
+                  subagent !== undefined &&
+                  (subagent.task.status === "running" || subagent.task.status === "pending")
+                ) {
+                  // The agent is free to answer with text only and never call
+                  // get_command_or_subagent_output; without this, the subagent
+                  // row stays running and holds deferred finalize open forever.
+                  yield* emitSubagent(context, {
+                    nativeTaskId: subagent.task.nativeTaskRef?.nativeId ?? notice.childSessionId,
+                    prompt: subagent.task.prompt,
+                    title: subagent.task.title,
+                    model: subagent.task.model,
+                    status: notice.status,
+                    childSessionId: notice.childSessionId,
+                    result: null,
+                    suppressNormalTool: true,
+                  });
+                }
+              }
+              break;
+            default: {
+              const parsed = parseSessionUpdateEvent(notification);
+              for (const event of parsed.events) {
+                if (event._tag === "ToolCallUpdated") {
+                  yield* emitTool(context, event.toolCall);
+                } else if (event._tag === "PlanUpdated") {
+                  yield* emitPlan(context, event.payload);
+                }
+              }
+            }
+          }
+          if (acpRootSessionUpdateIngestsOutput(notification)) {
+            yield* scheduleSettleRootTurnWhenIdle(context);
+          }
+          // Keep deferred finalize quiet-window fresh while wake traffic lands.
+          yield* rearmDeferredFinalize(context);
+        });
+
+        const activeContext = Effect.gen(function* () {
+          const context = yield* Ref.get(activeTurn);
+          if (context === null) {
+            return yield* new EffectAcpErrors.AcpTransportError({
+              detail: "ACP agent requested input without an active turn",
+              cause: "No active ACP turn",
+            });
+          }
+          return context;
+        });
+
+        const beginApprovalRequest = Effect.fnUntraced(function* (
+          context: ActiveAcpTurn,
+          params: EffectAcpSchema.RequestPermissionRequest,
+          generation: number,
+          transportRequestId: string,
+        ) {
+          yield* closeTextStreams(context);
+          const parsed = parsePermissionRequest(params);
+          const nativeRequestId = params.toolCall.toolCallId;
+          const requestId = yield* idAllocator.allocate.runtimeRequest({
+            driver,
+            providerTurnId: context.providerTurnId,
+            nativeRequestId,
+          });
+          const decision = yield* Deferred.make<ProviderApprovalDecision>();
+          const nativeResponseAcknowledgement = yield* Deferred.make<
+            void,
+            EffectAcpErrors.AcpError
+          >();
+          yield* registerNativeResponseAcknowledgement(
+            generation,
+            transportRequestId,
+            nativeResponseAcknowledgement,
+          );
+          const now = yield* DateTime.now;
+          const nodeId = idAllocator.derive.approvalNode({ requestId });
+          const requestKind = providerRequestKind(parsed.kind);
+          const nativeItemRef = { driver, nativeId: nativeRequestId, strength: "weak" as const };
+          const ordinal = yield* resolveItemOrdinal(
+            context,
+            `${context.nativeTurnId}:approval:${nativeRequestId}`,
+          );
+          const runtimeRequest: OrchestrationV2RuntimeRequest = {
+            id: requestId,
+            nodeId,
+            providerTurnId: context.providerTurnId,
+            nativeRequestRef: nativeItemRef,
+            kind: requestKind,
+            status: "pending",
+            responseCapability: {
+              type: "live",
+              providerSessionId: input.providerSessionId,
+            },
+            createdAt: now,
+            resolvedAt: null,
+          };
+          const node: OrchestrationV2ExecutionNode = {
+            id: nodeId,
+            threadId: context.input.threadId,
+            runId: context.input.runId,
+            parentNodeId: context.input.rootNodeId,
+            rootNodeId: context.input.rootNodeId,
+            kind: "approval_request",
+            status: "waiting",
+            countsForRun: false,
+            providerThreadId: context.input.providerThread.id,
+            providerTurnId: context.providerTurnId,
+            nativeItemRef,
+            runtimeRequestId: requestId,
+            checkpointScopeId: null,
+            startedAt: now,
+            completedAt: null,
+          };
+          const turnItem: OrchestrationV2TurnItem = {
+            id: idAllocator.derive.approvalTurnItem({ requestId }),
+            threadId: context.input.threadId,
+            runId: context.input.runId,
+            nodeId,
+            providerThreadId: context.input.providerThread.id,
+            providerTurnId: context.providerTurnId,
+            nativeItemRef,
+            parentItemId: null,
+            ordinal,
+            status: "waiting",
+            title: null,
+            startedAt: now,
+            completedAt: null,
+            updatedAt: now,
+            type: "approval_request",
+            requestId,
+            requestKind,
+            ...(parsed.detail === undefined ? {} : { prompt: parsed.detail }),
+          };
+          yield* Ref.update(pendingRuntimeRequests, (current) => {
+            const updated = new Map(current);
+            updated.set(String(requestId), {
+              type: "approval",
+              generation,
+              nativeResponseAcknowledgement,
+              requestId,
+              transportRequestId,
+              decision,
+              runtimeRequest,
+              node,
+              turnItem,
+            });
+            return updated;
+          });
+          yield* emitProviderEvent({
+            type: "node.updated",
+            driver,
+            node,
+          });
+          yield* emitProviderEvent({
+            type: "runtime_request.updated",
+            driver,
+            threadId: context.input.threadId,
+            runtimeRequest,
+          });
+          yield* emitProviderEvent({
+            type: "turn_item.updated",
+            driver,
+            turnItem,
+          });
+          return {
+            context,
+            decision,
+            nativeResponseAcknowledgement,
+            requestId,
+            transportRequestId,
+          } as const;
+        });
+
+        const beginUserInputRequest = Effect.fnUntraced(function* (
+          request: AcpAdapterV2UserInputRequest,
+          generation: number,
+          transportRequestId: string,
+        ) {
+          const context = yield* activeContext;
+          yield* closeTextStreams(context);
+          const requestId = yield* idAllocator.allocate.runtimeRequest({
+            driver,
+            providerTurnId: context.providerTurnId,
+            nativeRequestId: request.nativeRequestId,
+          });
+          const answers = yield* Deferred.make<ProviderUserInputAnswers | null>();
+          const nativeResponseAcknowledgement = yield* Deferred.make<
+            void,
+            EffectAcpErrors.AcpError
+          >();
+          yield* registerNativeResponseAcknowledgement(
+            generation,
+            transportRequestId,
+            nativeResponseAcknowledgement,
+          );
+          const now = yield* DateTime.now;
+          const nodeId = idAllocator.derive.nodeFromProviderItem({
+            driver,
+            nativeItemId: request.nativeItemId,
+          });
+          const turnItemId = idAllocator.derive.turnItemFromProviderItem({
+            driver,
+            nativeItemId: request.nativeItemId,
+          });
+          const nativeItemRef = {
+            driver,
+            nativeId: request.nativeItemId,
+            strength: "weak" as const,
+          };
+          const ordinal = yield* resolveItemOrdinal(context, request.nativeItemId);
+          const runtimeRequest: OrchestrationV2RuntimeRequest = {
+            id: requestId,
+            nodeId,
+            providerTurnId: context.providerTurnId,
+            nativeRequestRef: {
+              driver,
+              nativeId: request.nativeRequestId,
+              strength: "weak",
+            },
+            kind: "user_input",
+            status: "pending",
+            responseCapability: {
+              type: "live",
+              providerSessionId: input.providerSessionId,
+            },
+            createdAt: now,
+            resolvedAt: null,
+          };
+          const node: OrchestrationV2ExecutionNode = {
+            id: nodeId,
+            threadId: context.input.threadId,
+            runId: context.input.runId,
+            parentNodeId: context.input.rootNodeId,
+            rootNodeId: context.input.rootNodeId,
+            kind: "user_input_request",
+            status: "waiting",
+            countsForRun: false,
+            providerThreadId: context.input.providerThread.id,
+            providerTurnId: context.providerTurnId,
+            nativeItemRef,
+            runtimeRequestId: requestId,
+            checkpointScopeId: null,
+            startedAt: now,
+            completedAt: null,
+          };
+          const turnItem: OrchestrationV2TurnItem = {
+            id: turnItemId,
+            threadId: context.input.threadId,
+            runId: context.input.runId,
+            nodeId,
+            providerThreadId: context.input.providerThread.id,
+            providerTurnId: context.providerTurnId,
+            nativeItemRef,
+            parentItemId: null,
+            ordinal,
+            status: "waiting",
+            title: null,
+            startedAt: now,
+            completedAt: null,
+            updatedAt: now,
+            type: "user_input_request",
+            requestId,
+            questions: [...request.questions],
+          };
+          yield* Ref.update(pendingRuntimeRequests, (current) => {
+            const updated = new Map(current);
+            updated.set(String(requestId), {
+              type: "user_input",
+              generation,
+              nativeResponseAcknowledgement,
+              requestId,
+              transportRequestId,
+              answers,
+              runtimeRequest,
+              node,
+              turnItem,
+            });
+            return updated;
+          });
+          yield* emitProviderEvent({
+            type: "node.updated",
+            driver,
+            node,
+          });
+          yield* emitProviderEvent({
+            type: "runtime_request.updated",
+            driver,
+            threadId: context.input.threadId,
+            runtimeRequest,
+          });
+          yield* emitProviderEvent({
+            type: "turn_item.updated",
+            driver,
+            turnItem,
+          });
+          return {
+            answers,
+            context,
+            nativeResponseAcknowledgement,
+            requestId,
+            transportRequestId,
+          } as const;
+        });
+
+        const requestUserInputWithAdmission = (
+          generation: number,
+          request: Effect.Effect<AcpAdapterV2UserInputRequest>,
+          transportRequestId: string,
+        ) =>
+          runRuntimeCallbackAtGeneration(
+            generation,
+            request.pipe(
+              Effect.flatMap((value) =>
+                beginUserInputRequest(value, generation, transportRequestId),
+              ),
+            ),
+          ).pipe(
+            Effect.flatMap((pending) => {
+              if (Option.isNone(pending)) return Effect.never;
+              const { answers, context, requestId, transportRequestId } = pending.value;
+              return Deferred.await(answers).pipe(
+                Effect.flatMap((result) =>
+                  runRuntimeCallbackAtGeneration(generation, Effect.succeed(result)).pipe(
+                    Effect.flatMap((checked) =>
+                      Option.isSome(checked)
+                        ? Effect.succeed({
+                            acknowledgeNativeResponse: acknowledgeNativeResponse(
+                              generation,
+                              transportRequestId,
+                            ),
+                            answers: checked.value,
+                          })
+                        : Effect.never,
+                    ),
+                  ),
+                ),
+                Effect.ensuring(
+                  runRuntimeCallbackAtGeneration(
+                    generation,
+                    Effect.gen(function* () {
+                      yield* Ref.update(pendingRuntimeRequests, (current) => {
+                        const updated = new Map(current);
+                        updated.delete(String(requestId));
+                        return updated;
+                      });
+                      yield* rearmRootTurnRecoveryTimers(context);
+                    }),
+                  ).pipe(Effect.asVoid),
+                ),
+              );
+            }),
+            Effect.mapError(
+              (cause) =>
+                new EffectAcpErrors.AcpTransportError({
+                  detail: "Failed to handle ACP user input request",
+                  cause,
+                }),
+            ),
+          );
+
+        const cancelPendingRuntimeRequests = Effect.fnUntraced(function* () {
+          const requests = yield* Ref.modify(pendingRuntimeRequests, (current) => [
+            [...current.values()],
+            new Map<string, PendingRuntimeRequest>(),
+          ]);
+          if (requests.length === 0) return;
+
+          const now = yield* DateTime.now;
+          yield* Effect.forEach(
+            requests,
+            (request) =>
+              Effect.gen(function* () {
+                const cancelled = yield* request.type === "approval"
+                  ? Deferred.succeed(request.decision, "cancel")
+                  : Deferred.succeed(request.answers, null);
+                if (!cancelled) return;
+
+                yield* emitProviderEvent({
+                  type: "runtime_request.updated",
+                  driver,
+                  threadId: request.node.threadId,
+                  runtimeRequest: {
+                    ...request.runtimeRequest,
+                    status: "cancelled",
+                    resolvedAt: now,
+                  },
+                });
+                yield* emitProviderEvent({
+                  type: "node.updated",
+                  driver,
+                  node: {
+                    ...request.node,
+                    status: "cancelled",
+                    completedAt: now,
+                  },
+                });
+                yield* emitProviderEvent({
+                  type: "turn_item.updated",
+                  driver,
+                  turnItem: {
+                    ...request.turnItem,
+                    status: "cancelled",
+                    completedAt: now,
+                    updatedAt: now,
+                  },
+                });
+              }),
+            { concurrency: 1, discard: true },
+          );
+        });
+
+        /**
+         * Mutate a carryover subagent's in-memory task status without projecting.
+         * Used after a non-completed root whose original run subscriber is no
+         * longer guaranteed to ingest the terminal event.
+         */
+        const mutateCarryoverSubagentStatus = Effect.fnUntraced(function* (
+          subagent: ActiveAcpSubagent,
+          status: OrchestrationV2Subagent["status"],
+          resultOverride?: string | null,
+        ) {
+          const now = yield* DateTime.now;
+          const result =
+            resultOverride !== undefined && resultOverride !== null && resultOverride.length > 0
+              ? resultOverride
+              : subagent.assistantText || subagent.task.result;
+          const completedAt = acpSubagentStatusIsTerminal(status) ? now : null;
+          subagent.task = {
+            ...subagent.task,
+            status,
+            result,
+            completedAt,
+            updatedAt: now,
+          };
+        });
+
+        /**
+         * Project a carryover subagent status change without an ActiveAcpTurn.
+         * Shared by completed-root post-settle completion, deferred attach, and
+         * Direct Stop terminalization.
+         */
+        const projectCarryoverSubagentStatus = Effect.fnUntraced(function* (
+          subagent: ActiveAcpSubagent,
+          status: OrchestrationV2Subagent["status"],
+          resultOverride?: string | null,
+        ) {
+          yield* mutateCarryoverSubagentStatus(subagent, status, resultOverride);
+          const now = subagent.task.updatedAt;
+          const nativeTaskId = subagent.task.nativeTaskRef?.nativeId ?? subagent.task.id;
+          const nativeItemRef = {
+            driver,
+            nativeId: nativeTaskId,
+            strength: "strong" as const,
+          };
+          const parentProviderThreadId = subagent.parentProviderThreadId;
+          const result = subagent.task.result;
+          const completedAt = subagent.task.completedAt;
+          yield* emitProviderEvent({
+            type: "node.updated",
+            driver,
+            node: {
+              id: subagent.task.id,
+              threadId: subagent.task.threadId,
+              runId: subagent.task.runId,
+              parentNodeId: subagent.task.parentNodeId,
+              rootNodeId: subagent.task.parentNodeId,
+              kind: "subagent",
+              status,
+              countsForRun: false,
+              providerThreadId: parentProviderThreadId,
+              providerTurnId: subagent.providerTurnId,
+              nativeItemRef,
+              runtimeRequestId: null,
+              checkpointScopeId: null,
+              startedAt: subagent.task.startedAt,
+              completedAt,
+            },
+          });
+          yield* emitProviderEvent({
+            type: "node.updated",
+            driver,
+            node: {
+              id: subagent.childRootNodeId,
+              threadId: subagent.childThreadId,
+              runId: null,
+              parentNodeId: null,
+              rootNodeId: subagent.childRootNodeId,
+              kind: "root_turn",
+              status,
+              countsForRun: false,
+              providerThreadId: subagent.task.providerThreadId,
+              providerTurnId: null,
+              nativeItemRef,
+              runtimeRequestId: null,
+              checkpointScopeId: null,
+              startedAt: subagent.task.startedAt,
+              completedAt,
+            },
+          });
+          yield* emitProviderEvent({
+            type: "subagent.updated",
+            driver,
+            subagent: subagent.task,
+          });
+          yield* emitProviderEvent({
+            type: "turn_item.updated",
+            driver,
+            turnItem: {
+              id: subagent.turnItemId,
+              threadId: subagent.task.threadId,
+              runId: subagent.task.runId,
+              nodeId: subagent.task.id,
+              providerThreadId: parentProviderThreadId,
+              providerTurnId: subagent.providerTurnId,
+              nativeItemRef,
+              parentItemId: null,
+              ordinal: subagent.turnItemOrdinal,
+              status,
+              title: subagent.task.title,
+              startedAt: subagent.task.startedAt,
+              completedAt,
+              updatedAt: now,
+              type: "subagent",
+              subagentId: subagent.task.id,
+              origin: "provider_native",
+              driver,
+              providerInstanceId: subagent.task.providerInstanceId,
+              childThreadId: subagent.childThreadId,
+              prompt: subagent.task.prompt,
+              result,
+            },
+          });
+          if (acpSubagentStatusIsTerminal(status)) {
+            subagent.terminalStatusProjected = true;
+          }
+        });
+
+        /**
+         * Update a carryover subagent matched by native task id or child session
+         * id. Post-settle completions must flip the pin in hasPendingBackgroundWork
+         * without waiting for a new user turn to consume carryover.
+         * When `project` is false, only the in-memory carryover status advances
+         * (the next attach projects the terminal state).
+         * If status already matches but projection was deferred, a later
+         * project:true caller still projects once via terminalStatusProjected.
+         */
+        const updateCarryoverSubagentStatus = Effect.fnUntraced(function* (
+          nativeIdOrChildSessionId: string,
+          status: OrchestrationV2Subagent["status"],
+          result?: string | null,
+          options?: { readonly project?: boolean },
+        ) {
+          const carryover = yield* Ref.get(carryoverSubagents);
+          if (carryover === null) return false;
+          const match = carryover.subagents.find((subagent) => {
+            const nativeId = subagent.task.nativeTaskRef?.nativeId ?? String(subagent.task.id);
+            return (
+              nativeId === nativeIdOrChildSessionId ||
+              subagent.childSessionId === nativeIdOrChildSessionId
+            );
+          });
+          if (match === undefined) return false;
+          const shouldProject = options?.project !== false;
+          if (match.task.status === status) {
+            // Already at this status: only project if requested and not yet done.
+            if (!shouldProject || match.terminalStatusProjected) {
+              return true;
+            }
+            yield* projectCarryoverSubagentStatus(match, status, result);
+            return true;
+          }
+          // Only advance nonterminal entries; do not resurrect a terminal one.
+          if (match.task.status !== "running" && match.task.status !== "pending") {
+            return false;
+          }
+          if (!shouldProject) {
+            yield* mutateCarryoverSubagentStatus(match, status, result);
+          } else {
+            yield* projectCarryoverSubagentStatus(match, status, result);
+          }
+          return true;
+        });
+
+        applyFinalizedActiveTurnSubagentTerminal = Effect.fnUntraced(function* (
+          context: ActiveAcpTurn,
+          notification: EffectAcpSchema.SessionNotification,
+        ) {
+          if (flavor.extractSubagentUpdate === undefined) return false;
+
+          const applyTerminal = Effect.fnUntraced(function* (
+            subagent: ActiveAcpSubagent,
+            update: AcpAdapterV2SubagentUpdate,
+          ) {
+            if (!acpSubagentStatusIsTerminal(update.status)) return false;
+            if (acpSubagentStatusIsTerminal(subagent.task.status)) {
+              if (subagent.terminalStatusProjected || context.finalizedStatus !== "completed") {
+                return true;
+              }
+            }
+            if (context.finalizedStatus === "completed") {
+              yield* emitSubagent(context, update);
+            } else {
+              yield* mutateCarryoverSubagentStatus(subagent, update.status, update.result);
+            }
+            return true;
+          });
+
+          const sessionUpdate = notification.update;
+          if (
+            sessionUpdate.sessionUpdate === "tool_call" ||
+            sessionUpdate.sessionUpdate === "tool_call_update"
+          ) {
+            for (const event of parseSessionUpdateEvent(notification).events) {
+              if (event._tag !== "ToolCallUpdated") continue;
+              const toolCall = flavor.normalizeToolCall?.(event.toolCall) ?? event.toolCall;
+              const subagentUpdate = flavor.extractSubagentUpdate(toolCall);
+              if (
+                subagentUpdate === undefined ||
+                !acpSubagentStatusIsTerminal(subagentUpdate.status)
+              ) {
+                continue;
+              }
+              const subagent =
+                context.subagents.get(subagentUpdate.nativeTaskId) ??
+                (subagentUpdate.childSessionId === null
+                  ? undefined
+                  : context.subagentsBySessionId.get(subagentUpdate.childSessionId)) ??
+                context.subagentsBySessionId.get(notification.sessionId);
+              if (subagent === undefined) continue;
+              const nativeTaskId =
+                subagent.task.nativeTaskRef?.nativeId ?? String(subagent.task.id);
+              if (
+                subagentUpdate.nativeTaskId !== nativeTaskId &&
+                (subagentUpdate.childSessionId === null ||
+                  (subagentUpdate.childSessionId !== subagent.childSessionId &&
+                    subagentUpdate.childSessionId !== notification.sessionId))
+              ) {
+                continue;
+              }
+              if (yield* applyTerminal(subagent, subagentUpdate)) return true;
+            }
+          }
+
+          if (
+            sessionUpdate.sessionUpdate === "user_message_chunk" &&
+            sessionUpdate.content.type === "text" &&
+            flavor.extractSubagentEndNotice !== undefined
+          ) {
+            const notice = flavor.extractSubagentEndNotice(sessionUpdate.content.text);
+            const subagent =
+              notice === undefined
+                ? undefined
+                : context.subagentsBySessionId.get(notice.childSessionId);
+            if (notice !== undefined && subagent !== undefined) {
+              return yield* applyTerminal(subagent, {
+                nativeTaskId: subagent.task.nativeTaskRef?.nativeId ?? String(subagent.task.id),
+                prompt: subagent.task.prompt,
+                title: subagent.task.title,
+                model: subagent.task.model,
+                status: notice.status,
+                childSessionId: notice.childSessionId,
+                result: null,
+                suppressNormalTool: true,
+              });
+            }
+          }
+
+          return false;
+        });
+
+        const projectDeferredCarryoverTerminals = Effect.fnUntraced(function* (
+          subagents: ReadonlyArray<ActiveAcpSubagent>,
+        ) {
+          for (const subagent of subagents) {
+            if (
+              subagent.task.status === "running" ||
+              subagent.task.status === "pending" ||
+              subagent.terminalStatusProjected
+            ) {
+              continue;
+            }
+            yield* projectCarryoverSubagentStatus(
+              subagent,
+              subagent.task.status,
+              subagent.task.result,
+            );
+          }
+        });
+
+        /**
+         * Direct Stop after a soft steer clears carryover without an active turn.
+         * Emit the same interrupted terminal events terminalizeOpenRunOwnedItems
+         * would have, context-free (no ActiveAcpTurn).
+         */
+        const terminalizeCarryoverSubagents = Effect.fnUntraced(function* (
+          carryover: AcpCarryoverSubagents | null,
+        ) {
+          if (carryover === null) return;
+          for (const subagent of carryover.subagents) {
+            if (acpSubagentStatusIsTerminal(subagent.task.status)) {
+              if (!subagent.terminalStatusProjected) {
+                yield* projectCarryoverSubagentStatus(
+                  subagent,
+                  subagent.task.status,
+                  subagent.task.result,
+                );
+              }
+              continue;
+            }
+            yield* projectCarryoverSubagentStatus(subagent, "interrupted");
+          }
+        });
+
+        const wireAcpRuntimeHandlers = Effect.fnUntraced(function* () {
+          const handlerGeneration = yield* Ref.get(runtimeCallbackGeneration);
+          const requestUserInput = (request: AcpAdapterV2UserInputRequest) =>
+            Effect.gen(function* () {
+              const transportRequestId = yield* claimNativeTransportRequest(
+                handlerGeneration,
+                (transport) => acpNativeUserInputRequestMatches(request, transport),
+              );
+              const correlated = yield* runRuntimeCallbackAtGeneration(
+                handlerGeneration,
+                transportRequestId === undefined
+                  ? new EffectAcpErrors.AcpTransportError({
+                      detail:
+                        "Could not correlate the ACP user input request with its transport ID",
+                      cause: "Could not correlate xAI user input transport request",
+                    })
+                  : Effect.succeed(transportRequestId),
+              );
+              if (Option.isNone(correlated)) return yield* Effect.never;
+              return yield* requestUserInputWithAdmission(
+                handlerGeneration,
+                Effect.succeed(request),
+                correlated.value,
+              );
+            });
+          yield* runtime.handleSessionUpdate((notification) =>
+            runRuntimeCallbackAtGeneration(
+              handlerGeneration,
+              handleSessionUpdate(notification),
+            ).pipe(
+              Effect.asVoid,
+              Effect.mapError(
+                (cause) =>
+                  new EffectAcpErrors.AcpTransportError({
+                    detail: "Failed to project an ACP session update",
+                    cause,
+                  }),
+              ),
+            ),
+          );
+          yield* runtime.handleRequestPermission((params) =>
+            Effect.gen(function* () {
+              const transportRequestId = yield* claimNativeTransportRequest(
+                handlerGeneration,
+                ({ method, payload }) =>
+                  method === "session/request_permission" &&
+                  unknownRecord(payload)?.sessionId === params.sessionId &&
+                  unknownRecord(unknownRecord(payload)?.toolCall)?.toolCallId ===
+                    params.toolCall.toolCallId,
+              );
+              const correlated = yield* runRuntimeCallbackAtGeneration(
+                handlerGeneration,
+                transportRequestId === undefined
+                  ? new EffectAcpErrors.AcpTransportError({
+                      detail:
+                        "Could not correlate the ACP permission request with its transport ID",
+                      cause: "Could not correlate session/request_permission transport request",
+                    })
+                  : Effect.succeed(transportRequestId),
+              );
+              if (Option.isNone(correlated)) return yield* Effect.never;
+              const correlatedTransportRequestId = correlated.value;
+              const admitted = yield* runRuntimeCallbackAtGeneration(
+                handlerGeneration,
+                Effect.gen(function* () {
+                  const context = yield* activeContext;
+                  const disposition = acpPermissionDisposition(context.input.runtimePolicy, params);
+                  if (disposition === "allow") {
+                    const optionId = selectAutoApprovedPermissionOption(params);
+                    return {
+                      _tag: "Immediate" as const,
+                      response:
+                        optionId === undefined
+                          ? ({ outcome: { outcome: "cancelled" } } as const)
+                          : ({ outcome: { outcome: "selected", optionId } } as const),
+                    };
+                  }
+                  if (disposition === "deny") {
+                    const optionId = selectPermissionOptionId(params, "decline");
+                    return {
+                      _tag: "Immediate" as const,
+                      response:
+                        optionId === undefined
+                          ? ({ outcome: { outcome: "cancelled" } } as const)
+                          : ({ outcome: { outcome: "selected", optionId } } as const),
+                    };
+                  }
+                  return {
+                    _tag: "Pending" as const,
+                    pending: yield* beginApprovalRequest(
+                      context,
+                      params,
+                      handlerGeneration,
+                      correlatedTransportRequestId,
+                    ),
+                  };
+                }),
+              );
+              if (Option.isNone(admitted)) {
+                return yield* Effect.never;
+              }
+              if (admitted.value._tag === "Immediate") {
+                const response = admitted.value.response;
+                const checked = yield* runRuntimeCallbackAtGeneration(
+                  handlerGeneration,
+                  Effect.gen(function* () {
+                    const nativeResponseAcknowledgement = yield* Deferred.make<
+                      void,
+                      EffectAcpErrors.AcpError
+                    >();
+                    yield* registerNativeResponseAcknowledgement(
+                      handlerGeneration,
+                      correlatedTransportRequestId,
+                      nativeResponseAcknowledgement,
+                    );
+                    return response;
+                  }),
+                );
+                return Option.isSome(checked) ? checked.value : yield* Effect.never;
+              }
+              const {
+                context,
+                decision: pendingDecision,
+                requestId,
+                transportRequestId: pendingTransportRequestId,
+              } = admitted.value.pending;
+              const decision = yield* Deferred.await(pendingDecision).pipe(
+                Effect.ensuring(
+                  runRuntimeCallbackAtGeneration(
+                    handlerGeneration,
+                    Effect.gen(function* () {
+                      yield* Ref.update(pendingRuntimeRequests, (current) => {
+                        const updated = new Map(current);
+                        updated.delete(String(requestId));
+                        return updated;
+                      });
+                      yield* rearmRootTurnRecoveryTimers(context);
+                    }),
+                  ).pipe(Effect.asVoid),
+                ),
+              );
+              const response = (() => {
+                if (decision === "cancel") {
+                  return { outcome: { outcome: "cancelled" } } as const;
+                }
+                const optionId = selectPermissionOptionId(params, decision);
+                return optionId === undefined
+                  ? ({ outcome: { outcome: "cancelled" } } as const)
+                  : ({ outcome: { outcome: "selected", optionId } } as const);
+              })();
+              const checked = yield* runRuntimeCallbackAtGeneration(
+                handlerGeneration,
+                Effect.succeed(response),
+              );
+              if (Option.isNone(checked)) return yield* Effect.never;
+              yield* acknowledgeNativeResponse(handlerGeneration, pendingTransportRequestId);
+              return checked.value;
+            }).pipe(
+              Effect.mapError(
+                (cause) =>
+                  new EffectAcpErrors.AcpTransportError({
+                    detail: "Failed to handle an ACP permission request",
+                    cause,
+                  }),
+              ),
+            ),
+          );
+          yield* runtime.handleElicitation((params) =>
+            Effect.gen(function* () {
+              const transportRequestId = yield* claimNativeTransportRequest(
+                handlerGeneration,
+                ({ method, payload }) => {
+                  const record = unknownRecord(payload);
+                  return (
+                    method === "session/elicitation" &&
+                    record?.sessionId === params.sessionId &&
+                    record.message === params.message &&
+                    record.mode === params.mode &&
+                    (params.mode === "url"
+                      ? record.elicitationId === params.elicitationId && record.url === params.url
+                      : acpCanonicalJson(record.requestedSchema) ===
+                        acpCanonicalJson(params.requestedSchema))
+                  );
+                },
+              );
+              const correlated = yield* runRuntimeCallbackAtGeneration(
+                handlerGeneration,
+                transportRequestId === undefined
+                  ? new EffectAcpErrors.AcpTransportError({
+                      detail:
+                        "Could not correlate the ACP elicitation request with its transport ID",
+                      cause: "Could not correlate session/elicitation transport request",
+                    })
+                  : Effect.succeed(transportRequestId),
+              );
+              if (Option.isNone(correlated)) return yield* Effect.never;
+              const correlatedTransportRequestId = correlated.value;
+              if (params.mode === "url") {
+                const admitted = yield* runRuntimeCallbackAtGeneration(
+                  handlerGeneration,
+                  Effect.gen(function* () {
+                    const nativeResponseAcknowledgement = yield* Deferred.make<
+                      void,
+                      EffectAcpErrors.AcpError
+                    >();
+                    yield* registerNativeResponseAcknowledgement(
+                      handlerGeneration,
+                      correlatedTransportRequestId,
+                      nativeResponseAcknowledgement,
+                    );
+                    return { action: { action: "decline" } } as const;
+                  }),
+                );
+                if (Option.isNone(admitted)) return yield* Effect.never;
+                return admitted.value;
+              }
+              const questions = Object.entries(params.requestedSchema.properties ?? {}).map(
+                ([id, property], index): OrchestrationV2UserInputQuestion => {
+                  const record = unknownRecord(property);
+                  const enumValues = Array.isArray(record?.enum)
+                    ? record.enum.filter((value): value is string => typeof value === "string")
+                    : [];
+                  const options =
+                    enumValues.length > 0
+                      ? enumValues.map((value) => ({ label: value, description: value }))
+                      : record?.type === "boolean"
+                        ? [
+                            { label: "true", description: "Yes" },
+                            { label: "false", description: "No" },
+                          ]
+                        : [];
+                  return {
+                    id,
+                    header: nonEmptyText(record?.title, `Question ${index + 1}`),
+                    question: nonEmptyText(record?.description, params.message),
+                    options,
+                  };
+                },
+              );
+              const userInput = yield* requestUserInputWithAdmission(
+                handlerGeneration,
+                Effect.gen(function* () {
+                  const ordinal = yield* Ref.getAndUpdate(
+                    nextElicitationOrdinal,
+                    (current) => current + 1,
+                  );
+                  const nativeRequestId = `${params.sessionId}:elicitation:${ordinal}`;
+                  return {
+                    nativeItemId: nativeRequestId,
+                    nativeRequestId,
+                    questions,
+                  };
+                }),
+                correlatedTransportRequestId,
+              );
+              const response =
+                userInput.answers === null
+                  ? ({ action: { action: "cancel" } } as const)
+                  : ({
+                      action: {
+                        action: "accept",
+                        content: elicitationContent(
+                          userInput.answers,
+                          new Set(Object.keys(params.requestedSchema.properties ?? {})),
+                        ),
+                      },
+                    } as const);
+              yield* userInput.acknowledgeNativeResponse;
+              return response;
+            }),
+          );
+          if (flavor.registerExtensions !== undefined) {
+            yield* flavor.registerExtensions({
+              runtime,
+              requestUserInput,
+              captureProposedPlan,
+              lastProposedPlanMarkdown,
+              applyBackgroundTaskMutation: (mutation) =>
+                Effect.gen(function* () {
+                  // Direct Stop quarantine: drop residual task lifecycle from
+                  // the stopped run instead of mutating wake machinery.
+                  if (yield* Ref.get(stoppedRunQuarantine)) return;
+                  // Root-session tasks only: a cancelled subagent's re-run in
+                  // its child session must not gate root wake machinery.
+                  if ((yield* Ref.get(activeSessionId)) !== mutation.sessionId) return;
+                  yield* applyLateBackgroundMutation(mutation.sessionId, mutation);
+                }),
+            });
+          }
+        });
+
+        const spawnAcpRuntime = Effect.fnUntraced(function* () {
+          if (runtimeScope !== undefined) {
+            yield* Scope.close(runtimeScope, Exit.void);
+          }
+          runtimeScope = yield* Scope.make();
+          const runtimeGeneration = yield* Ref.get(runtimeCallbackGeneration);
+          runtime = yield* flavor
+            .makeRuntime(makeRuntimeInput(runtimeGeneration))
+            .pipe(
+              Effect.provideService(Scope.Scope, runtimeScope),
+              Effect.provideService(Crypto.Crypto, options.crypto),
+            );
+        });
+
+        const restartAcpRuntime = Effect.fnUntraced(function* () {
+          yield* spawnAcpRuntime();
+          yield* wireAcpRuntimeHandlers();
+        });
+
+        yield* spawnAcpRuntime();
+        yield* wireAcpRuntimeHandlers();
+
+        const started = yield* runtime.start();
+        yield* Ref.set(activeSessionId, started.sessionId);
+        yield* Ref.set(activeSessionSetup, started);
+        const capabilities = negotiatedCapabilities(flavor.capabilities, started);
+        const canLoadSession = started.initializeResult.agentCapabilities?.loadSession === true;
+        const canResumeSession =
+          started.initializeResult.agentCapabilities?.sessionCapabilities?.resume != null;
+        const supportsImagePrompts = acpSupportsImagePrompts({
+          flavorSupportsImagePrompts: flavor.supportsImagePrompts,
+          negotiatedImage:
+            started.initializeResult.agentCapabilities?.promptCapabilities?.image === true,
+        });
+
+        const activateSession = Effect.fnUntraced(function* (
+          sessionId: string,
+          threadId: ThreadId | null,
+        ) {
+          const activationOptions = { mcpServers: acpMcpServers(threadId) };
+          if (canLoadSession) {
+            return yield* runtime.loadSession(sessionId, activationOptions);
+          }
+          if (canResumeSession) {
+            return yield* runtime.resumeSession(sessionId, activationOptions);
+          }
+          return yield* new ProviderAdapterProtocolError({
+            driver,
+            detail: `ACP driver cannot load or resume session ${sessionId}`,
+          });
+        });
+
+        const configureSession = Effect.fnUntraced(function* (
+          startResult: AcpSessionRuntimeStartResult,
+          modelSelection: ModelSelection,
+          runtimePolicy: ProviderAdapterV2RuntimePolicy,
+        ) {
+          const requestedModel = flavor.resolveModelId?.(modelSelection) ?? modelSelection.model;
+          if (
+            requestedModel.length > 0 &&
+            requestedModel !== "auto" &&
+            requestedModel !== "default"
+          ) {
+            const currentModel = startResult.sessionSetupResult.models?.currentModelId;
+            if (currentModel !== requestedModel) {
+              if (startResult.sessionSetupResult.models != null) {
+                yield* runtime.setSessionModel(requestedModel);
+              } else if (
+                startResult.sessionSetupResult.configOptions?.some(
+                  (option) => option.category === "model",
+                ) === true
+              ) {
+                yield* runtime.setModel(requestedModel);
+              }
+            }
+          }
+          const configOptions = yield* runtime.getConfigOptions;
+          const availableConfigIds = new Set(configOptions.map((option) => option.id));
+          const unsupportedConfigIds = (modelSelection.options ?? [])
+            .map((selection) => selection.id)
+            .filter((id) => !availableConfigIds.has(id));
+          if (unsupportedConfigIds.length > 0) {
+            return yield* new ProviderAdapterProtocolError({
+              driver,
+              detail: `ACP session ${startResult.sessionId} does not expose requested configuration option(s): ${unsupportedConfigIds.join(", ")}`,
+            });
+          }
+          for (const selection of modelSelection.options ?? []) {
+            yield* runtime.setConfigOption(selection.id, selection.value);
+          }
+          const modeState = yield* runtime.getModeState;
+          if (runtimePolicy.interactionMode === "plan" && modeState !== undefined) {
+            const planMode = modeState.availableModes.find(
+              (mode) => mode.id === "plan" || mode.id === "architect",
+            );
+            if (planMode !== undefined) yield* runtime.setMode(planMode.id);
+          }
+        });
+
+        yield* configureSession(started, input.modelSelection, input.runtimePolicy);
+        yield* Ref.set(activeSelection, input.modelSelection);
+        const createdAt = yield* DateTime.now;
+        const providerSession: OrchestrationV2ProviderSession = {
+          id: input.providerSessionId,
+          driver,
+          providerInstanceId: options.instanceId,
+          status: "ready",
+          cwd: input.runtimePolicy.cwd ?? process.cwd(),
+          model: input.modelSelection.model,
+          capabilities,
+          createdAt,
+          updatedAt: createdAt,
+          lastError: null,
+        };
+
+        const providerTurnPayload = (
+          context: ActiveAcpTurn,
+          status: OrchestrationV2ProviderTurn["status"],
+          completedAt: DateTime.Utc | null,
+        ): OrchestrationV2ProviderTurn => ({
+          id: context.providerTurnId,
+          providerThreadId: context.input.providerThread.id,
+          nodeId: context.input.rootNodeId,
+          runAttemptId: context.input.attemptId,
+          nativeTurnRef: {
+            driver,
+            nativeId: context.nativeTurnId,
+            strength: "weak",
+          },
+          ordinal: context.input.providerTurnOrdinal,
+          status,
+          startedAt: context.startedAt,
+          completedAt,
+        });
+
+        const drainTrailingRootTurnChunks = Effect.fnUntraced(function* () {
+          if (!flavor.settleRootTurnWhenIdle) return;
+          // Projected via handleSessionUpdate, not getEvents(). Cooperative yield
+          // only — replay uses TestClock; Effect.sleep here would stall settlement.
+          yield* Effect.yieldNow;
+          yield* Effect.yieldNow;
+        });
+
+        const terminalizeOpenRunOwnedItems = Effect.fnUntraced(function* (
+          context: ActiveAcpTurn,
+          options: { readonly terminalizeSubagents: boolean },
+        ) {
+          for (const tool of context.tools.values()) {
+            const status = toolStatus(tool.status);
+            if (status === "pending" || status === "running") {
+              yield* emitTool(context, tool, "interrupted");
+            }
+          }
+          if (!options.terminalizeSubagents) return;
+          for (const subagent of context.subagents.values()) {
+            if (subagent.task.status !== "running" && subagent.task.status !== "pending") {
+              continue;
+            }
+            yield* emitSubagent(context, {
+              nativeTaskId: subagent.task.nativeTaskRef?.nativeId ?? subagent.task.id,
+              prompt: subagent.task.prompt,
+              title: subagent.task.title,
+              model: subagent.task.model,
+              status: "interrupted",
+              childSessionId: subagent.childSessionId,
+              result: subagent.task.result,
+              suppressNormalTool: true,
+            });
+          }
+        });
+
+        const terminalizeOpenForegroundTools = Effect.fnUntraced(function* (
+          context: ActiveAcpTurn,
+        ) {
+          for (const tool of context.tools.values()) {
+            if (!acpCompletedTurnShouldTerminalizeTool(tool, flavor)) continue;
+            yield* emitTool(context, tool, "completed");
+          }
+        });
+
+        const quarantineStoppedRun = Effect.fnUntraced(function* () {
+          yield* continuationPermit.withPermit(
+            Effect.gen(function* () {
+              yield* Ref.update(continuationGeneration, (value) => value + 1);
+              yield* Ref.set(stoppedRunQuarantine, true);
+              yield* Ref.set(wakeBuffer, []);
+              yield* Ref.set(continuationRequested, false);
+              yield* Ref.set(runningBackgroundTaskIds, new Set());
+              yield* Ref.set(midTurnUnreportedCompletedTaskIds, new Set());
+              yield* Ref.set(carryoverSubagents, null);
+              yield* Ref.set(lastTurnRoute, null);
+            }),
+          );
+        });
+
+        const finalizeTurn = Effect.fnUntraced(function* (
+          context: ActiveAcpTurn,
+          status: "completed" | "interrupted" | "failed" | "cancelled",
+          failure?: OrchestrationV2ProviderFailure,
+          options?: { readonly drainTrailingChunks?: boolean },
+        ) {
+          if (context.finalized) return;
+          const settledStatus = context.interrupted ? "interrupted" : status;
+          context.finalizedStatus = settledStatus;
+          context.finalized = true;
+          if (options?.drainTrailingChunks === true) {
+            yield* drainTrailingRootTurnChunks();
+          }
+          const directStopQuarantine = yield* Ref.get(stoppedRunQuarantine);
+          if (settledStatus === "completed") {
+            yield* terminalizeOpenForegroundTools(context);
+          } else if (settledStatus === "interrupted") {
+            // Direct Stop terminalizes every visible run-owned item. restart_active
+            // keeps live subagent lineages for in-process replacement carryover.
+            yield* terminalizeOpenRunOwnedItems(context, {
+              terminalizeSubagents: directStopQuarantine,
+            });
+          }
+          yield* closeTextStreams(context);
+          const now = yield* DateTime.now;
+          const turn = providerTurnPayload(context, settledStatus, now);
+          yield* Ref.update(providerTurns, (current) => {
+            const updated = new Map(current);
+            updated.set(String(turn.id), turn);
+            return updated;
+          });
+          yield* emitProviderEvent({
+            type: "provider_turn.updated",
+            driver,
+            threadId: context.input.threadId,
+            providerTurn: turn,
+          });
+          yield* emitProviderEvent({
+            type: "provider_thread.updated",
+            driver,
+            providerThread: {
+              ...context.input.providerThread,
+              providerSessionId: input.providerSessionId,
+              status: "active",
+              lastRunOrdinal: context.input.runOrdinal,
+              firstRunOrdinal:
+                context.input.providerThread.firstRunOrdinal ?? context.input.runOrdinal,
+              updatedAt: now,
+            },
+          });
+          yield* emitProviderEvent(
+            settledStatus === "failed"
+              ? {
+                  type: "turn.terminal",
+                  driver,
+                  providerThreadId: context.input.providerThread.id,
+                  providerTurnId: context.providerTurnId,
+                  runOrdinal: context.input.runOrdinal,
+                  failureItemOrdinal: yield* resolveItemOrdinal(
+                    context,
+                    `terminal-failure:${context.providerTurnId}`,
+                  ),
+                  status: settledStatus,
+                  failure: failure ?? makeProviderFailure({ class: "provider_error" }),
+                  threadDisposition: "reusable",
+                }
+              : {
+                  type: "turn.terminal",
+                  driver,
+                  providerThreadId: context.input.providerThread.id,
+                  providerTurnId: context.providerTurnId,
+                  runOrdinal: context.input.runOrdinal,
+                  status: settledStatus,
+                  failure: null,
+                  threadDisposition: "reusable",
+                },
+          );
+          const subagentsRequiringCarryover = [...context.subagents.values()].filter(
+            acpSubagentHasPendingBackgroundWork,
+          );
+          // Direct Stop must not carry residual subagents into a later run.
+          if (subagentsRequiringCarryover.length > 0 && !directStopQuarantine) {
+            const sessionId = yield* Ref.get(activeSessionId);
+            if (sessionId !== null) {
+              yield* Ref.set(carryoverSubagents, {
+                sessionId,
+                rootTerminalStatus: settledStatus,
+                subagents: subagentsRequiringCarryover,
+              });
+            }
+          }
+          yield* Ref.set(activeTurn, null);
+          // A mid-turn background completion may have deferred its offer while
+          // this root turn was still streaming. Once the turn leaves the active
+          // slot, re-check: empty running set + residual wake evidence (or a
+          // mid-turn unreported completion) means a legitimate unhandled
+          // completion can open exactly one continuation. Sticky
+          // continuationRequested prevents double-offer if a later frame also
+          // races into offerContinuationRun.
+          if (
+            postSettleContinuationEnabled &&
+            settledStatus === "completed" &&
+            !directStopQuarantine &&
+            (yield* Ref.get(runningBackgroundTaskIds)).size === 0 &&
+            ((yield* Ref.get(wakeBuffer)).length > 0 ||
+              (yield* Ref.get(midTurnUnreportedCompletedTaskIds)).size > 0)
+          ) {
+            const sessionId = yield* Ref.get(activeSessionId);
+            if (sessionId !== null) {
+              yield* offerContinuationRun(sessionId);
+            }
+          }
+          // Clear mid-turn unreported marks unless a completed turn still has
+          // running background work: keep them so the post-finalize gate can
+          // offer once when the last task ends. Interrupted/failed turns must
+          // not leave marks that open a wake after interrupt (quarantine owns
+          // that path). Non-continuation turn start also clears (~user turn).
+          if (
+            settledStatus !== "completed" ||
+            (yield* Ref.get(runningBackgroundTaskIds)).size === 0
+          ) {
+            yield* Ref.set(midTurnUnreportedCompletedTaskIds, new Set());
+          }
+          yield* Deferred.succeed(context.completed, undefined).pipe(Effect.ignore);
+        });
+
+        const trySettleRootTurnWhenIdle = Effect.fnUntraced(function* (context: ActiveAcpTurn) {
+          const pending = yield* Ref.get(pendingRuntimeRequests);
+          const hasPendingRuntimeRequest = acpTurnHasPendingRuntimeRequest(
+            context.providerTurnId,
+            pending,
+          );
+          const hasRunningTool = [...context.tools.values()].some((tool) => {
+            const status = toolStatus(tool.status);
+            return status === "pending" || status === "running";
+          });
+          // Debounce already proved root-session quiescence; open segment handles
+          // without an explicit close should not block settlement.
+          const hasActiveSubagent = [...context.subagents.values()].some((subagent) =>
+            acpSubagentStatusBlocksTurnSettlement(subagent.task.status),
+          );
+          if (
+            !acpRootTurnIsIdle({
+              finalized: context.finalized,
+              interrupted: context.interrupted,
+              assistantStreamOpen: false,
+              reasoningStreamOpen: false,
+              hasRunningTool,
+              hasPendingRuntimeRequest,
+              hasToolHistory: context.tools.size > 0,
+              hasActiveSubagent,
+              hasOutput: context.assistant.nextSegment > 0,
+            })
+          ) {
+            return;
+          }
+          // Never session/cancel here. Speculative settle must not kill in-flight
+          // Grok work; late tools would arrive with activeTurn null and drop.
+          yield* finalizeTurn(context, "completed", undefined, { drainTrailingChunks: true });
+        });
+
+        scheduleDeferredFinalize = (context) =>
+          Effect.gen(function* () {
+            if (!flavor.deferFinalizeForBackgroundWork) return;
+            if (!context.promptSettled || context.finalized || context.interrupted) return;
+            if (hasDeferredBackgroundWork(context)) return;
+            context.backgroundFinalizeGeneration += 1;
+            const generation = context.backgroundFinalizeGeneration;
+            // Minimal quiet for all models (no per-model carveouts). Defer +
+            // awaitingBackgroundHydration hold the turn through monitors; this
+            // is only a short debounce after the last rearm so a slightly late
+            // post-hydration assistant chunk stays in the same continuation.
+            // Grok commonly sends its final summary just over two seconds after
+            // the hydrated tool frame; two seconds split that tail into a second
+            // synthetic wake. Longer floors (4–20s) only prolonged Working.
+            yield* Effect.gen(function* () {
+              yield* Effect.sleep("3000 millis");
+              if (
+                context.finalized ||
+                context.interrupted ||
+                context.backgroundFinalizeGeneration !== generation
+              ) {
+                return;
+              }
+              if (hasDeferredBackgroundWork(context)) return;
+              const status = context.promptSettledStatus ?? "completed";
+              yield* finalizeTurn(context, status, undefined, { drainTrailingChunks: true });
+            }).pipe(Effect.forkIn(sessionScope), Effect.asVoid);
+          });
+
+        scheduleSettleRootTurnWhenIdle = (context) =>
+          Effect.gen(function* () {
+            if (!flavor.settleRootTurnWhenIdle) return;
+            context.settleScheduleGeneration += 1;
+            const generation = context.settleScheduleGeneration;
+            yield* Effect.gen(function* () {
+              yield* Effect.sleep(`${acpRootTurnSettleDebounceMs} millis`);
+              if (context.finalized || context.interrupted) return;
+              if (context.settleScheduleGeneration !== generation) return;
+              const active = yield* Ref.get(activeTurn);
+              if (active !== context) return;
+              yield* trySettleRootTurnWhenIdle(context);
+            }).pipe(Effect.forkIn(sessionScope), Effect.asVoid);
+          });
+
+        rearmRootTurnRecoveryTimers = (context) =>
+          Effect.gen(function* () {
+            if (!acpRootTurnShouldRearmRecoveryTimers(context)) return;
+            yield* scheduleSettleRootTurnWhenIdle(context);
+          });
+
+        const resolvePromptParts = Effect.fnUntraced(function* (
+          turnInput: ProviderAdapterV2TurnInput,
+        ) {
+          const prompt: Array<EffectAcpSchema.ContentBlock> = [];
+          const text = t3OrchestrationPromptForFirstRun({
+            prompt: providerMessageTextWithAttachmentPaths({
+              text: turnInput.message.text,
+              attachments: turnInput.message.attachments,
+              attachmentsDir: serverConfig.attachmentsDir,
+            }),
+            runOrdinal: turnInput.runOrdinal,
+            hasT3Mcp: acpMcpServers(turnInput.threadId).length > 0,
+          });
+          if (text.length > 0) {
+            prompt.push({ type: "text", text });
+          }
+          const imageAttachments = turnInput.message.attachments.filter(
+            isProviderNativeImageAttachment,
+          );
+          if (imageAttachments.length > 0 && !supportsImagePrompts) {
+            return yield* new ProviderAdapterProtocolError({
+              driver,
+              detail: "ACP driver did not negotiate image prompt support",
+            });
+          }
+          for (const attachment of imageAttachments) {
+            const path = resolveAttachmentPath({
+              attachmentsDir: serverConfig.attachmentsDir,
+              attachment: attachment as ChatAttachment,
+            });
+            if (path === null) {
+              return yield* new ProviderAdapterProtocolError({
+                driver,
+                detail: `Invalid attachment id '${attachment.id}'`,
+              });
+            }
+            const bytes = yield* fileSystem.readFile(path).pipe(
+              Effect.mapError(
+                (cause) =>
+                  new ProviderAdapterProtocolError({
+                    driver,
+                    detail: `Failed to read attachment '${attachment.id}'`,
+                    payload: cause,
+                  }),
+              ),
+            );
+            prompt.push({
+              type: "image",
+              data: Buffer.from(bytes).toString("base64"),
+              mimeType: attachment.mimeType,
+            });
+          }
+          if (prompt.length === 0) {
+            return yield* new ProviderAdapterProtocolError({
+              driver,
+              detail: "ACP turn requires non-empty text or attachments",
+            });
+          }
+          return prompt;
+        });
+
+        const restartRuntimeAfterTeardownIfRequired = Effect.fnUntraced(function* () {
+          const restartRequired = yield* Ref.get(runtimeRestartRequired);
+          if (!restartRequired) return false;
+          yield* restartAcpRuntime();
+          yield* Ref.set(runtimeRestartRequired, false);
+          yield* Ref.set(activeSessionId, null);
+          yield* Ref.set(activeSessionSetup, null);
+          yield* Ref.set(activeSelection, null);
+          yield* Ref.set(snapshot, {
+            order: [],
+            messages: new Map(),
+            loadingRole: null,
+            loadingIndex: 0,
+          });
+          return true;
+        });
+
+        const startTurnUnlocked = Effect.fn("AcpAdapterV2.startTurn")(
+          function* (turnInput: ProviderAdapterV2TurnInput) {
+            yield* awaitRuntimeTeardown();
+            const existing = yield* Ref.get(activeTurn);
+            if (existing !== null) {
+              return yield* new ProviderAdapterProtocolError({
+                driver,
+                detail: `ACP provider turn ${existing.providerTurnId} is still active`,
+              });
+            }
+            const requestedSessionId = yield* nativeThreadId(driver, turnInput.providerThread);
+            const restartAfterInterrupt = yield* restartRuntimeAfterTeardownIfRequired();
+            const needsSessionActivation =
+              (yield* Ref.get(activeSessionId)) !== requestedSessionId || restartAfterInterrupt;
+            if (needsSessionActivation) {
+              const activated = yield* activateSession(requestedSessionId, turnInput.threadId);
+              yield* Ref.set(activeSessionId, activated.sessionId);
+              yield* Ref.set(activeSessionSetup, activated);
+              yield* configureSession(activated, turnInput.modelSelection, turnInput.runtimePolicy);
+              yield* Ref.set(activeSelection, turnInput.modelSelection);
+            } else {
+              const configuredSelection = yield* Ref.get(activeSelection);
+              if (
+                configuredSelection === null ||
+                !modelSelectionsEqual(configuredSelection, turnInput.modelSelection)
+              ) {
+                const currentSessionSetup = yield* Ref.get(activeSessionSetup);
+                if (currentSessionSetup === null) {
+                  return yield* new ProviderAdapterProtocolError({
+                    driver,
+                    detail: `ACP session ${requestedSessionId} has no active setup metadata`,
+                  });
+                }
+                yield* configureSession(
+                  currentSessionSetup,
+                  turnInput.modelSelection,
+                  turnInput.runtimePolicy,
+                );
+                yield* Ref.set(activeSelection, turnInput.modelSelection);
+              }
+            }
+            yield* Ref.set(lastTurnRoute, {
+              threadId: turnInput.threadId,
+              providerThreadId: turnInput.providerThread.id,
+            });
+            yield* Ref.set(suppressPostSettleMonitorPrompt, false);
+            yield* Ref.set(handledBackgroundTaskIdsInActiveTurn, new Set());
+            // Continuation turns attach to wake traffic the agent already produced
+            // after the prior root turn settled; do not re-prompt the ACP session.
+            const isContinuationTurn =
+              postSettleContinuationEnabled &&
+              turnInput.message.createdBy === "agent" &&
+              turnInput.message.creationSource === "provider";
+            const isAppOwnedWakeTurn = acpIsAppOwnedWakeTurn(turnInput.message);
+            // An app-owned wake reports on a sibling delegated child and owns
+            // none of this session's background work, so it must not discard
+            // pending wake evidence: neither the mid-turn completion marks kept
+            // across a settle with work still running, nor the wake buffer
+            // below. Dropping the marks here would lose the offer for a task
+            // that completed unreported before the settle.
+            if (!isAppOwnedWakeTurn) {
+              yield* Ref.set(midTurnUnreportedCompletedTaskIds, new Set());
+            }
+            // A user turn supersedes an empty offer, but not an offer that owns
+            // buffered wake traffic. ProviderContinuationService queues that
+            // continuation behind the user run so it can drain afterwards.
+            const continuationWasRequested = yield* continuationPermit.withPermit(
+              Effect.gen(function* () {
+                const wasRequested = yield* Ref.get(continuationRequested);
+                const preserveBufferedContinuation = acpTurnStartShouldPreserveContinuation({
+                  continuationRequested: wasRequested,
+                  isContinuationTurn,
+                  wakeBufferLength: (yield* Ref.get(wakeBuffer)).length,
+                });
+                // User turns must not inherit prior-turn wake residue. Stale
+                // injected-turn ack chatter can otherwise arm a later offer.
+                // Preserve only a queued continuation that owns buffered wake
+                // traffic, and exempt app-owned sibling wakes entirely.
+                if (!isContinuationTurn && !isAppOwnedWakeTurn && !preserveBufferedContinuation) {
+                  yield* Ref.set(wakeBuffer, []);
+                }
+                if (preserveBufferedContinuation) return wasRequested;
+                yield* Ref.update(continuationGeneration, (value) => value + 1);
+                yield* Ref.set(continuationRequested, false);
+                return wasRequested;
+              }),
+            );
+            const prompt = isContinuationTurn ? null : yield* resolvePromptParts(turnInput);
+            const startedAt = yield* DateTime.now;
+            const nativeTurnId = `${requestedSessionId}:turn:${turnInput.providerTurnOrdinal}`;
+            const providerTurnId = idAllocator.derive.providerTurn({ driver, nativeTurnId });
+            const completed = yield* Deferred.make<void, never>();
+            const promptWireSettled = yield* Deferred.make<void, never>();
+            const context: ActiveAcpTurn = {
+              input: turnInput,
+              providerTurnId,
+              nativeThreadId: requestedSessionId,
+              nativeTurnId,
+              startedAt,
+              completed,
+              assistant: { current: null, nextSegment: 0 },
+              reasoning: { current: null, nextSegment: 0 },
+              tools: new Map(),
+              toolStartedAt: new Map(),
+              subagents: new Map(),
+              subagentsBySessionId: new Map(),
+              pendingSubagentNotifications: new Map(),
+              toolCallIdsByBackgroundTaskId: new Map(),
+              persistentBackgroundTaskIds: new Set(),
+              awaitingBackgroundHydration: new Set(),
+              pendingInjectedReport: new Set(),
+              earlyInjectedReportObserved: false,
+              plan: null,
+              interrupted: false,
+              finalized: false,
+              finalizedStatus: null,
+              settleScheduleGeneration: 0,
+              promptSettled: false,
+              promptSettledStatus: null,
+              promptWireSettled,
+              backgroundFinalizeGeneration: 0,
+            };
+            const carryover = yield* Ref.getAndSet(carryoverSubagents, null);
+            let rehydratedCarryoverSubagents: ReadonlyArray<ActiveAcpSubagent> = [];
+            if (carryover !== null && carryover.sessionId === requestedSessionId) {
+              rehydratedCarryoverSubagents = carryover.subagents;
+              for (const subagent of carryover.subagents) {
+                const nativeId = subagent.task.nativeTaskRef?.nativeId ?? null;
+                if (nativeId !== null) {
+                  context.subagents.set(nativeId, subagent);
+                }
+                if (subagent.childSessionId !== null) {
+                  context.subagentsBySessionId.set(subagent.childSessionId, subagent);
+                }
+              }
+            }
+            yield* Ref.set(activeTurn, context);
+            // Direct Stop closes and recreates the old runtime before reaching
+            // this reset. The quarantine remains session-scoped by design.
+            yield* Ref.set(stoppedRunQuarantine, false);
+            const runningTurn = providerTurnPayload(context, "running", null);
+            yield* Ref.update(providerTurns, (current) => {
+              const updated = new Map(current);
+              updated.set(String(runningTurn.id), runningTurn);
+              return updated;
+            });
+            yield* emitProviderEvent({
+              type: "provider_turn.updated",
+              driver,
+              threadId: turnInput.threadId,
+              providerTurn: runningTurn,
+            });
+            yield* emitProviderEvent({
+              type: "provider_thread.updated",
+              driver,
+              providerThread: {
+                ...turnInput.providerThread,
+                providerSessionId: input.providerSessionId,
+                status: "active",
+                updatedAt: startedAt,
+              },
+            });
+            yield* rememberSnapshotMessage({
+              createdBy: turnInput.message.createdBy,
+              creationSource: turnInput.message.creationSource,
+              id: turnInput.message.messageId,
+              threadId: turnInput.threadId,
+              runId: turnInput.runId,
+              nodeId: turnInput.rootNodeId,
+              role: "user",
+              text: turnInput.message.text,
+              attachments: [...turnInput.message.attachments],
+              streaming: false,
+              createdAt: startedAt,
+              updatedAt: startedAt,
+            });
+            // Every attach ends the deferred-terminal contract, but only the
+            // queued provider continuation owns wake traffic. A user turn may
+            // start before that continuation and must leave its buffer intact.
+            yield* projectDeferredCarryoverTerminals(rehydratedCarryoverSubagents);
+            // Keep projected terminals addressable through the wake drain so
+            // emitSubagent's monotonic guard can reject replayed spawn frames.
+            // Finalize carries only entries with pending background work, so a
+            // terminal-and-projected lineage still expires with this turn.
+            if (isContinuationTurn) {
+              yield* Ref.set(continuationRequested, false);
+              const drainedWakeCount = yield* Ref.modify(wakeBuffer, (current) => {
+                const next: Array<EffectAcpSchema.SessionNotification> = [];
+                return [
+                  current.filter((notification) => notification.sessionId === requestedSessionId),
+                  next,
+                ] as const;
+              }).pipe(
+                Effect.tap((drained) =>
+                  Effect.forEach(drained, handleSessionUpdate, {
+                    concurrency: 1,
+                    discard: true,
+                  }),
+                ),
+                Effect.map((drained) => drained.length),
+              );
+              // Treat attach mode as prompt-settled so deferred finalize / quiet
+              // windows can complete the continuation after wake traffic drains.
+              context.promptSettled = true;
+              context.promptSettledStatus = "completed";
+              if (drainedWakeCount === 0) {
+                // A requested continuation with only mid-turn evidence has no
+                // buffered frame yet. Wait the quiet window so late CLI frames
+                // can attach. A provider-authored attach without a matching
+                // request only exists to project deferred carryover terminals,
+                // so it can finish immediately once those terminals are visible.
+                if (continuationWasRequested && flavor.deferFinalizeForBackgroundWork === true) {
+                  if (hasDeferredBackgroundWork(context)) {
+                    yield* rearmDeferredFinalize(context);
+                  } else {
+                    yield* scheduleDeferredFinalize(context);
+                  }
+                } else {
+                  yield* finalizeTurn(context, "completed", undefined, {
+                    drainTrailingChunks: true,
+                  });
+                }
+                return;
+              }
+              if (!context.finalized) {
+                if (hasDeferredBackgroundWork(context)) {
+                  yield* rearmDeferredFinalize(context);
+                } else {
+                  yield* scheduleDeferredFinalize(context);
+                }
+              }
+              return;
+            }
+            const promptGeneration = yield* Ref.get(runtimeCallbackGeneration);
+            yield* runtime.prompt({ prompt: prompt! }).pipe(
+              // Wire settlement precedes the completion callback's permit request so
+              // settled-soft classification can observe the native return even when
+              // the completion fiber has not yet set promptSettled under the permit.
+              Effect.tap(() =>
+                Deferred.succeed(context.promptWireSettled, undefined).pipe(Effect.asVoid),
+              ),
+              Effect.flatMap((result) =>
+                runRuntimeCallbackAtGeneration(
+                  promptGeneration,
+                  Effect.gen(function* () {
+                    if (context.finalized) return;
+                    const status =
+                      result.stopReason === "cancelled"
+                        ? context.interrupted
+                          ? "interrupted"
+                          : "cancelled"
+                        : "completed";
+                    // Grok monitors (and async subagents) keep working after the root
+                    // prompt RPC returns. Defer finalize so their later updates and
+                    // wake-turn traffic still project onto this run.
+                    if (
+                      flavor.deferFinalizeForBackgroundWork === true &&
+                      !context.interrupted &&
+                      hasDeferredBackgroundWork(context)
+                    ) {
+                      context.promptSettled = true;
+                      context.promptSettledStatus = status;
+                      return;
+                    }
+                    // Only completed turns drain trailing chunks. Interrupted turns
+                    // must not wait for residual output from a stopped prompt.
+                    yield* finalizeTurn(context, status, undefined, {
+                      drainTrailingChunks: status === "completed",
+                    });
+                  }),
+                ).pipe(Effect.asVoid),
+              ),
+              // Prompt failure is not wire-settled: only a successful resolve marks
+              // the signal. catchCause must not complete promptWireSettled.
+              Effect.catchCause((cause) =>
+                runRuntimeCallbackAtGeneration(
+                  promptGeneration,
+                  Effect.gen(function* () {
+                    if (context.finalized) return;
+                    yield* finalizeTurn(
+                      context,
+                      context.interrupted ? "interrupted" : "failed",
+                      makeProviderFailure({
+                        cause: Cause.squash(cause),
+                        class: "provider_error",
+                      }),
+                    ).pipe(
+                      Effect.andThen(
+                        Effect.logWarning("orchestration-v2.acp-prompt-failed", {
+                          driver,
+                          providerSessionId: input.providerSessionId,
+                          providerThreadId: turnInput.providerThread.id,
+                          providerTurnId,
+                          cause,
+                        }),
+                      ),
+                    );
+                  }),
+                ).pipe(Effect.asVoid),
+              ),
+              Effect.forkIn(sessionScope),
+            );
+          },
+          (effect, turnInput) =>
+            effect.pipe(
+              Effect.mapError(
+                (cause) =>
+                  new ProviderAdapterTurnStartError({
+                    driver,
+                    threadId: turnInput.threadId,
+                    providerThreadId: turnInput.providerThread.id,
+                    runId: turnInput.runId,
+                    cause,
+                  }),
+              ),
+            ),
+        );
+
+        const startTurn = Effect.fn("AcpAdapterV2.startTurn.transition")(function* (
+          turnInput: ProviderAdapterV2TurnInput,
+        ) {
+          return yield* runtimeTransitionPermit.withPermit(startTurnUnlocked(turnInput));
+        });
+
+        yield* Effect.addFinalizer(() =>
+          Effect.gen(function* () {
+            yield* continuationPermit.withPermit(
+              Effect.gen(function* () {
+                yield* Ref.set(continuationClosed, true);
+                yield* Ref.update(continuationGeneration, (value) => value + 1);
+              }),
+            );
+            const requests = [...(yield* Ref.get(pendingRuntimeRequests)).values()];
+            yield* Effect.forEach(
+              requests,
+              (request) =>
+                request.type === "approval"
+                  ? Deferred.succeed(request.decision, "cancel").pipe(Effect.ignore)
+                  : Deferred.succeed(request.answers, null).pipe(Effect.ignore),
+              { discard: true },
+            );
+            const closingError = new EffectAcpErrors.AcpTransportError({
+              detail: "The ACP session closed before its admitted response reached the transport",
+              cause: "ACP session transport closed",
+            });
+            yield* Effect.forEach(
+              requests,
+              (request) => Deferred.fail(request.nativeResponseAcknowledgement, closingError),
+              { discard: true },
+            );
+            const transportHadOutstandingResponses = yield* closeNativeTransport;
+            yield* options.testHooks?.afterNativeResponseTransportClosed?.() ?? Effect.void;
+            const sessionCapabilities =
+              started.initializeResult.agentCapabilities?.sessionCapabilities;
+            if (sessionCapabilities?.close != null) {
+              yield* runtimeTransitionPermit.withPermitsIfAvailable(1)(
+                Effect.gen(function* () {
+                  const teardownState = yield* Ref.get(runtimeTeardownState);
+                  const restartRequired = yield* Ref.get(runtimeRestartRequired);
+                  if (
+                    teardownState._tag === "Idle" &&
+                    !restartRequired &&
+                    !transportHadOutstandingResponses
+                  ) {
+                    yield* runtime.closeSession().pipe(Effect.ignore);
+                  }
+                }),
+              );
+            }
+            if (flavor.assertComplete !== undefined) {
+              yield* flavor.assertComplete.pipe(Effect.orDie);
+            }
+            if (runtimeScope !== undefined) {
+              yield* Scope.close(runtimeScope, Exit.void).pipe(Effect.ignore);
+            }
+          }),
+        );
+
+        const sessionRuntime: ProviderAdapterV2SessionRuntime = {
+          instanceId: options.instanceId,
+          driver,
+          providerSessionId: input.providerSessionId,
+          providerSession,
+          events: Stream.fromEffectRepeat(Queue.take(events)),
+          ...(postSettleContinuationEnabled
+            ? {
+                hasPendingBackgroundWork: Effect.gen(function* () {
+                  if ((yield* Ref.get(wakeBuffer)).length > 0) return true;
+                  if (yield* Ref.get(continuationRequested)) return true;
+                  if ((yield* Ref.get(runningBackgroundTaskIds)).size > 0) return true;
+                  // Projected post-settle Grok subagents can outlive the root
+                  // turn via carryover; keep the ACP process pinned until they
+                  // terminalize or teardown clears the carryover.
+                  // Also pin while a terminal status is held only in memory
+                  // (project:false) so idle release cannot drop the session
+                  // before the continuation drain (or a later project:true path)
+                  // delivers the turn_item terminal.
+                  const active = yield* Ref.get(activeTurn);
+                  if (
+                    active !== null &&
+                    [...active.subagents.values()].some(acpSubagentHasPendingBackgroundWork)
+                  ) {
+                    return true;
+                  }
+                  const carryover = yield* Ref.get(carryoverSubagents);
+                  if (
+                    carryover !== null &&
+                    carryover.subagents.some(acpSubagentHasPendingBackgroundWork)
+                  ) {
+                    return true;
+                  }
+                  return false;
+                }),
+              }
+            : {}),
+          ensureThread: Effect.fn("AcpAdapterV2.ensureThread")(
+            function* (threadInput: ProviderAdapterV2EnsureThreadInput) {
+              const now = yield* DateTime.now;
+              const sessionId = yield* Ref.get(activeSessionId);
+              if (sessionId === null) {
+                return yield* new ProviderAdapterProtocolError({
+                  driver,
+                  detail: "ACP runtime did not produce a session id",
+                });
+              }
+              return makeProviderThread({
+                driver,
+                providerInstanceId: options.instanceId,
+                idAllocator,
+                appThreadId: threadInput.threadId,
+                providerSessionId: input.providerSessionId,
+                nativeThreadId: sessionId,
+                now,
+              });
+            },
+            (effect, threadInput) =>
+              effect.pipe(
+                Effect.mapError(
+                  (cause) =>
+                    new ProviderAdapterEnsureThreadError({
+                      driver,
+                      threadId: threadInput.threadId,
+                      cause,
+                    }),
+                ),
+              ),
+          ),
+          resumeThread: Effect.fn("AcpAdapterV2.resumeThread")(
+            function* (threadInput: {
+              readonly providerThread: OrchestrationV2ProviderThread;
+              readonly modelSelection?: ModelSelection;
+              readonly runtimePolicy?: ProviderAdapterV2RuntimePolicy;
+            }) {
+              return yield* runtimeTransitionPermit.withPermit(
+                Effect.gen(function* () {
+                  yield* awaitRuntimeTeardown();
+                  const restartAfterInterrupt = yield* restartRuntimeAfterTeardownIfRequired();
+                  const sessionId = yield* nativeThreadId(driver, threadInput.providerThread);
+                  if ((yield* Ref.get(activeSessionId)) !== sessionId || restartAfterInterrupt) {
+                    yield* Ref.set(snapshot, {
+                      order: [],
+                      messages: new Map(),
+                      loadingRole: null,
+                      loadingIndex: 0,
+                    });
+                    const activated = yield* activateSession(
+                      sessionId,
+                      threadInput.providerThread.appThreadId,
+                    );
+                    yield* Ref.set(activeSessionId, activated.sessionId);
+                    yield* Ref.set(activeSessionSetup, activated);
+                    const nextSelection = threadInput.modelSelection ?? input.modelSelection;
+                    yield* configureSession(
+                      activated,
+                      nextSelection,
+                      threadInput.runtimePolicy ?? input.runtimePolicy,
+                    );
+                    yield* Ref.set(activeSelection, nextSelection);
+                  }
+                  const now = yield* DateTime.now;
+                  return {
+                    ...threadInput.providerThread,
+                    providerSessionId: input.providerSessionId,
+                    status: "idle" as const,
+                    updatedAt: now,
+                  };
+                }),
+              );
+            },
+            (effect, threadInput) =>
+              effect.pipe(
+                Effect.mapError(
+                  (cause) =>
+                    new ProviderAdapterResumeThreadError({
+                      driver,
+                      providerSessionId: input.providerSessionId,
+                      providerThreadId: threadInput.providerThread.id,
+                      cause,
+                    }),
+                ),
+              ),
+          ),
+          startTurn,
+          steerTurn: (turnInput) =>
+            Effect.fail(
+              new ProviderAdapterSteerRunUnsupportedError({
+                driver,
+                providerThreadId: turnInput.providerThread.id,
+              }),
+            ),
+          interruptTurn: Effect.fn("AcpAdapterV2.interruptTurn")(
+            function* (turnInput: ProviderAdapterV2InterruptInput) {
+              return yield* Effect.uninterruptibleMask((restore) =>
+                Effect.gen(function* () {
+                  yield* restore(runtimeTransitionPermit.take(1));
+                  return yield* Effect.gen(function* () {
+                    const transition = yield* Effect.gen(function* () {
+                      const interruptContext = yield* Ref.get(activeTurn);
+                      // Settled steering restart: the native prompt already
+                      // returned and this is not a user Stop, so keep the
+                      // process (and its background subagents) alive instead
+                      // of hard-killing it. The turn still terminalizes below.
+                      const softSteerCandidate =
+                        flavor.preserveRuntimeOnSettledInterrupt === true &&
+                        turnInput.requestRuntimeRestart !== true &&
+                        interruptContext?.providerTurnId === turnInput.providerTurnId;
+                      // Settlement is read under the callback permit after
+                      // draining admitted responses: the native prompt can have
+                      // returned on the wire while its completion callback has
+                      // not yet run, and a cancel sent in that window is exactly
+                      // what settled-soft mode exists to avoid. Also treat the
+                      // turn as settled when the wire signal is already done
+                      // (non-blocking; do not await under the permit).
+                      let settledSoftInterrupt = false;
+                      if (softSteerCandidate && interruptContext !== null) {
+                        const promptSettledUnderPermit = yield* runtimeCallbackPermit.withPermit(
+                          awaitAdmittedNativeResponses.pipe(
+                            Effect.andThen(
+                              Effect.sync(() => interruptContext.promptSettled === true),
+                            ),
+                          ),
+                        );
+                        const wireSettled = yield* Deferred.isDone(
+                          interruptContext.promptWireSettled,
+                        );
+                        settledSoftInterrupt = promptSettledUnderPermit || wireSettled;
+                      }
+                      const restartRuntime =
+                        !settledSoftInterrupt &&
+                        (turnInput.requestRuntimeRestart === true ||
+                          flavor.restartRuntimeOnEveryInterrupt === true);
+                      const hardRestart =
+                        restartRuntime && flavor.terminateRuntimeProcessGroupOnInterrupt === true;
+                      if (hardRestart) {
+                        const teardownState = yield* Ref.get(runtimeTeardownState);
+                        if (teardownState._tag === "Failed") {
+                          return yield* teardownState.error;
+                        }
+                        if (teardownState._tag === "InProgress") {
+                          // Concurrent Stop/restart: wait for the in-flight hard
+                          // teardown instead of failing the durable effect.
+                          yield* Effect.logInfo(
+                            "ACP interrupt awaiting in-progress hard teardown",
+                            {
+                              driver,
+                              providerTurnId: turnInput.providerTurnId,
+                            },
+                          );
+                          yield* Deferred.await(teardownState.completed);
+                          return undefined;
+                        }
+                      }
+                      const context = interruptContext;
+                      if (context?.providerTurnId !== turnInput.providerTurnId) {
+                        // A soft steering interrupt can clear the turn while
+                        // intentionally leaving the process alive. A queued user
+                        // Stop must still contain that orphan runtime. With a
+                        // different live turn active this stays a pure no-op
+                        // success instead: quarantine and teardown are
+                        // session-global and would maim the replacement turn.
+                        const containOrphanRuntime =
+                          context === null &&
+                          hardRestart &&
+                          turnInput.requestRuntimeRestart === true;
+                        // Transport death or a prior Stop already cleared the
+                        // turn. Failing here caused effect-worker retries while
+                        // the process was already gone; treat as success.
+                        yield* Effect.logWarning(
+                          containOrphanRuntime
+                            ? "ACP Stop raced a soft interrupt that cleared the turn; containing the orphan runtime"
+                            : "ACP interrupt raced transport teardown or a prior Stop; treating as already interrupted",
+                          {
+                            driver,
+                            requestedProviderTurnId: turnInput.providerTurnId,
+                            activeProviderTurnId: context?.providerTurnId ?? null,
+                            hardRestart,
+                            requestRuntimeRestart: turnInput.requestRuntimeRestart === true,
+                            teardownState: (yield* Ref.get(runtimeTeardownState))._tag,
+                          },
+                        );
+                        if (containOrphanRuntime) {
+                          const teardownBarrier = yield* Deferred.make<
+                            void,
+                            ProviderAdapterProtocolError
+                          >();
+                          yield* runtimeCallbackPermit.withPermit(
+                            Effect.gen(function* () {
+                              yield* awaitAdmittedNativeResponses;
+                              const stoppedGeneration = yield* Ref.get(runtimeCallbackGeneration);
+                              yield* quarantineNativeTransportAtGeneration(stoppedGeneration);
+                              yield* Ref.set(runtimeTeardownState, {
+                                _tag: "InProgress",
+                                completed: teardownBarrier,
+                              });
+                              yield* Ref.update(
+                                runtimeCallbackGeneration,
+                                (generation) => generation + 1,
+                              );
+                            }),
+                          );
+                          // Capture before quarantineStoppedRun clears carryover.
+                          const orphanCarryover = yield* Ref.getAndSet(carryoverSubagents, null);
+                          yield* quarantineStoppedRun();
+                          // Match the main hard-restart path: cancel pending
+                          // approvals/elicitations after quarantine, before kill.
+                          yield* cancelPendingRuntimeRequests();
+                          yield* terminalizeCarryoverSubagents(orphanCarryover);
+                          if (runtime.terminateProcessGroup === undefined) {
+                            const error = new ProviderAdapterProtocolError({
+                              driver,
+                              detail:
+                                "ACP runtime does not expose its required process-group teardown; the session is poisoned",
+                            });
+                            yield* Ref.set(runtimeTeardownState, { _tag: "Failed", error });
+                            yield* Deferred.fail(teardownBarrier, error).pipe(Effect.ignore);
+                            return yield* error;
+                          }
+                          const teardownExit = yield* runtime.terminateProcessGroup.pipe(
+                            Effect.exit,
+                          );
+                          if (Exit.isFailure(teardownExit)) {
+                            const error = new ProviderAdapterProtocolError({
+                              driver,
+                              detail:
+                                "ACP orphan runtime process-group teardown failed; the session is poisoned",
+                              payload: Cause.squash(teardownExit.cause),
+                            });
+                            yield* Ref.set(runtimeTeardownState, { _tag: "Failed", error });
+                            yield* Deferred.fail(teardownBarrier, error).pipe(Effect.ignore);
+                            return yield* error;
+                          }
+                          yield* Ref.set(runtimeRestartRequired, true);
+                          yield* Ref.set(runtimeTeardownState, { _tag: "Idle" });
+                          yield* Deferred.succeed(teardownBarrier, undefined).pipe(Effect.ignore);
+                        }
+                        return undefined;
+                      }
+                      const teardownBarrier = hardRestart
+                        ? yield* Deferred.make<void, ProviderAdapterProtocolError>()
+                        : null;
+                      if (teardownBarrier !== null) {
+                        yield* runtimeCallbackPermit.withPermit(
+                          Effect.gen(function* () {
+                            yield* awaitAdmittedNativeResponses;
+                            const stoppedGeneration = yield* Ref.get(runtimeCallbackGeneration);
+                            yield* quarantineNativeTransportAtGeneration(stoppedGeneration);
+                            yield* Ref.set(runtimeTeardownState, {
+                              _tag: "InProgress",
+                              completed: teardownBarrier,
+                            });
+                            yield* Ref.update(
+                              runtimeCallbackGeneration,
+                              (generation) => generation + 1,
+                            );
+                            yield* (
+                              options.testHooks?.afterHardTeardownTransportDrained?.() ??
+                                Effect.void
+                            );
+                          }),
+                        );
+                      }
+                      return {
+                        context,
+                        restartRuntime,
+                        hardRestart,
+                        teardownBarrier,
+                        settledSoftInterrupt,
+                      };
+                    });
+                    // Concurrent hard teardown already completed above.
+                    if (transition === undefined) return;
+                    const {
+                      context,
+                      restartRuntime,
+                      hardRestart,
+                      teardownBarrier,
+                      settledSoftInterrupt,
+                    } = transition;
+                    const poisonTeardown = Effect.fnUntraced(function* (
+                      detail: string,
+                      payload?: unknown,
+                    ) {
+                      const error = new ProviderAdapterProtocolError({
+                        driver,
+                        detail,
+                        ...(payload === undefined ? {} : { payload }),
+                      });
+                      yield* Ref.set(runtimeTeardownState, { _tag: "Failed", error });
+                      yield* Deferred.fail(teardownBarrier!, error).pipe(Effect.ignore);
+                      return error;
+                    });
+                    const runTransition = Effect.gen(function* () {
+                      context.interrupted = true;
+                      // Quarantine only when this run is discarded (user Stop /
+                      // hard process kill). Soft in-process restarts must keep
+                      // carryoverSubagents so a still-running subagent can
+                      // complete into the replacement turn.
+                      if (hardRestart || turnInput.requestRuntimeRestart === true) {
+                        yield* quarantineStoppedRun();
+                      }
+                      yield* cancelPendingRuntimeRequests();
+                      // Finalize before process-group kill so projection/UI cannot
+                      // lag a dead transport, and concurrent interrupt effects see
+                      // activeTurn cleared (idempotent success) rather than racing.
+                      if (
+                        (hardRestart || context.promptSettled || settledSoftInterrupt) &&
+                        !context.finalized
+                      ) {
+                        // hardRestart: always terminalize locally.
+                        // promptSettled / settledSoftInterrupt (incl. wire-settled):
+                        // native prompt already returned; only deferred background
+                        // work remains, so session/cancel has nothing to acknowledge.
+                        yield* finalizeTurn(context, "interrupted");
+                      }
+                      if (hardRestart) {
+                        if (runtime.terminateProcessGroup === undefined) {
+                          return yield* poisonTeardown(
+                            "ACP runtime does not expose its required process-group teardown; the session is poisoned",
+                          ).pipe(Effect.flatMap(Effect.fail));
+                        }
+                        const teardownExit = yield* runtime.terminateProcessGroup!.pipe(
+                          Effect.exit,
+                        );
+                        if (Exit.isFailure(teardownExit)) {
+                          return yield* poisonTeardown(
+                            "ACP runtime process-group teardown failed; the session is poisoned",
+                            Cause.squash(teardownExit.cause),
+                          ).pipe(Effect.flatMap(Effect.fail));
+                        }
+                        // Process group is gone; the next turn must spawn a
+                        // replacement even if the flavor only set hardRestart
+                        // without restartRuntimeAfterInterrupt.
+                        yield* Ref.set(runtimeRestartRequired, true);
+                        yield* Ref.set(runtimeTeardownState, { _tag: "Idle" });
+                        yield* Deferred.succeed(teardownBarrier!, undefined).pipe(Effect.ignore);
+                      } else {
+                        // Settled soft interrupt: the native prompt already
+                        // returned, so session/cancel has nothing to
+                        // acknowledge and would only threaten still-running
+                        // background subagents. Skip it and leave the runtime
+                        // untouched for the replacement turn.
+                        if (!settledSoftInterrupt) {
+                          yield* runtime.cancel;
+                        }
+                        if (restartRuntime && flavor.restartRuntimeAfterInterrupt === true) {
+                          yield* Ref.set(runtimeRestartRequired, true);
+                        }
+                      }
+                      const stopped = yield* Deferred.await(context.completed).pipe(
+                        Effect.timeoutOption("10 seconds"),
+                      );
+                      if (Option.isNone(stopped)) {
+                        if (!context.finalized) {
+                          yield* finalizeTurn(context, "interrupted");
+                        }
+                        return yield* new ProviderAdapterProtocolError({
+                          driver,
+                          detail: `ACP provider turn ${turnInput.providerTurnId} did not acknowledge cancellation before the interrupt timeout`,
+                        });
+                      }
+                    });
+                    if (!hardRestart) {
+                      return yield* restore(runTransition);
+                    }
+                    return yield* runTransition.pipe(
+                      Effect.catchCause((cause) =>
+                        Effect.gen(function* () {
+                          const state = yield* Ref.get(runtimeTeardownState);
+                          if (state._tag === "InProgress") {
+                            yield* poisonTeardown(
+                              "ACP hard teardown failed unexpectedly; the session is poisoned",
+                              Cause.squash(cause),
+                            );
+                          }
+                          return yield* Effect.failCause(cause);
+                        }),
+                      ),
+                    );
+                  }).pipe(Effect.ensuring(runtimeTransitionPermit.release(1)));
+                }),
+              );
+            },
+            (effect, turnInput) =>
+              effect.pipe(
+                Effect.mapError(
+                  (cause) =>
+                    new ProviderAdapterInterruptError({
+                      driver,
+                      providerThreadId: turnInput.providerThread.id,
+                      providerTurnId: turnInput.providerTurnId,
+                      cause,
+                    }),
+                ),
+              ),
+          ),
+          respondToRuntimeRequest: (requestInput) =>
+            Effect.uninterruptibleMask((restore) =>
+              Effect.gen(function* () {
+                yield* restore(runtimeTransitionPermit.take(1));
+                return yield* Effect.gen(function* () {
+                  yield* awaitRuntimeTeardown();
+                  const generation = yield* Ref.get(runtimeCallbackGeneration);
+                  const pending = (yield* Ref.get(pendingRuntimeRequests)).get(
+                    String(requestInput.requestId),
+                  );
+                  if (pending === undefined || pending.generation !== generation) {
+                    return yield* new ProviderAdapterProtocolError({
+                      driver,
+                      detail: `No pending ACP runtime request ${requestInput.requestId}`,
+                    });
+                  }
+                  const settled =
+                    pending.type === "user_input"
+                      ? yield* Deferred.succeed(pending.answers, requestInput.answers ?? null)
+                      : requestInput.decision === undefined
+                        ? yield* new ProviderAdapterProtocolError({
+                            driver,
+                            detail: `ACP approval request ${requestInput.requestId} requires a decision`,
+                          })
+                        : yield* Deferred.succeed(pending.decision, requestInput.decision);
+                  if (!settled) {
+                    return yield* new ProviderAdapterProtocolError({
+                      driver,
+                      detail: `ACP runtime request ${requestInput.requestId} was already resolved`,
+                    });
+                  }
+                  yield* awaitNativeResponseAcknowledgements([
+                    [pending.transportRequestId, pending.nativeResponseAcknowledgement],
+                  ]);
+                  yield* Deferred.await(pending.nativeResponseAcknowledgement);
+                }).pipe(Effect.ensuring(runtimeTransitionPermit.release(1)));
+              }),
+            ).pipe(
+              Effect.mapError(
+                (cause) =>
+                  new ProviderAdapterRuntimeRequestResponseError({
+                    driver,
+                    requestId: requestInput.requestId,
+                    cause,
+                  }),
+              ),
+            ),
+          readThreadSnapshot: Effect.fn("AcpAdapterV2.readThreadSnapshot")(
+            function* (snapshotInput) {
+              return yield* runtimeTransitionPermit.withPermit(
+                Effect.gen(function* () {
+                  yield* awaitRuntimeTeardown();
+                  yield* restartRuntimeAfterTeardownIfRequired();
+                  const sessionId = yield* nativeThreadId(driver, snapshotInput.providerThread);
+                  if ((yield* Ref.get(activeSessionId)) !== sessionId) {
+                    if (!capabilities.threads.canReadThreadSnapshot) {
+                      return yield* new ProviderAdapterProtocolError({
+                        driver,
+                        detail: "ACP driver does not support session/load snapshots",
+                      });
+                    }
+                    yield* Ref.set(snapshot, {
+                      order: [],
+                      messages: new Map(),
+                      loadingRole: null,
+                      loadingIndex: 0,
+                    });
+                    const activated = yield* runtime.loadSession(sessionId, {
+                      mcpServers: acpMcpServers(snapshotInput.providerThread.appThreadId),
+                    });
+                    yield* Ref.set(activeSessionId, activated.sessionId);
+                    yield* Ref.set(activeSessionSetup, activated);
+                    yield* Ref.set(activeSelection, null);
+                  }
+                  const state = yield* Ref.get(snapshot);
+                  const now = yield* DateTime.now;
+                  return {
+                    providerThread: {
+                      ...snapshotInput.providerThread,
+                      providerSessionId: input.providerSessionId,
+                      status: "idle" as const,
+                      updatedAt: now,
+                    },
+                    providerTurns: [...(yield* Ref.get(providerTurns)).values()],
+                    messages: state.order.flatMap((key) => {
+                      const message = state.messages.get(key);
+                      return message === undefined ? [] : [message];
+                    }),
+                    runtimeRequests: [],
+                    providerPayload: { protocol: ACP_PROTOCOL, sessionId },
+                  };
+                }),
+              );
+            },
+            (effect, snapshotInput) =>
+              effect.pipe(
+                Effect.mapError(
+                  (cause) =>
+                    new ProviderAdapterReadThreadSnapshotError({
+                      driver,
+                      providerThreadId: snapshotInput.providerThread.id,
+                      cause,
+                    }),
+                ),
+              ),
+          ),
+          rollbackThread: (rollbackInput) =>
+            Effect.fail(
+              new ProviderAdapterRollbackThreadError({
+                driver,
+                providerThreadId: rollbackInput.providerThread.id,
+                checkpointId: rollbackInput.target.checkpointId,
+                cause: "ACP does not define conversation rollback.",
+              }),
+            ),
+          forkThread: Effect.fn("AcpAdapterV2.forkThread")(
+            function* (forkInput) {
+              return yield* runtimeTransitionPermit.withPermit(
+                Effect.gen(function* () {
+                  yield* awaitRuntimeTeardown();
+                  yield* restartRuntimeAfterTeardownIfRequired();
+                  if (!capabilities.threads.canForkThread) {
+                    return yield* new ProviderAdapterProtocolError({
+                      driver,
+                      detail: "ACP driver did not negotiate session/fork",
+                    });
+                  }
+                  if (forkInput.providerTurnId !== undefined) {
+                    return yield* new ProviderAdapterProtocolError({
+                      driver,
+                      detail: "ACP session/fork can only fork the current session head",
+                    });
+                  }
+                  const sourceSessionId = yield* nativeThreadId(
+                    driver,
+                    forkInput.sourceProviderThread,
+                  );
+                  const forked = yield* runtime.forkSession(sourceSessionId, {
+                    mcpServers: acpMcpServers(forkInput.targetThreadId),
+                  });
+                  yield* Ref.set(activeSessionId, forked.sessionId);
+                  yield* Ref.set(activeSessionSetup, forked);
+                  yield* Ref.set(activeSelection, null);
+                  const now = yield* DateTime.now;
+                  return makeProviderThread({
+                    driver,
+                    providerInstanceId: options.instanceId,
+                    idAllocator,
+                    appThreadId: forkInput.targetThreadId,
+                    providerSessionId: input.providerSessionId,
+                    nativeThreadId: forked.sessionId,
+                    ...(forkInput.ownerNodeId === undefined
+                      ? {}
+                      : { ownerNodeId: forkInput.ownerNodeId }),
+                    forkedFrom: {
+                      providerThreadId: forkInput.sourceProviderThread.id,
+                      ...(forkInput.providerTurnId === undefined
+                        ? {}
+                        : { providerTurnId: forkInput.providerTurnId }),
+                    },
+                    now,
+                  });
+                }),
+              );
+            },
+            (effect, forkInput) =>
+              effect.pipe(
+                Effect.mapError(
+                  (cause) =>
+                    new ProviderAdapterForkThreadError({
+                      driver,
+                      providerThreadId: forkInput.sourceProviderThread.id,
+                      cause,
+                    }),
+                ),
+              ),
+          ),
+        };
+        return sessionRuntime;
+      },
+      (effect, input) =>
+        effect.pipe(
+          Effect.mapError(
+            (cause) =>
+              new ProviderAdapterOpenSessionError({
+                driver,
+                providerSessionId: input.providerSessionId,
+                cause,
+              }),
+          ),
+        ),
+    ),
+  });
+}
+
+export type AcpAdapterV2Env = FileSystem.FileSystem | IdAllocatorV2;
diff --git a/apps/server/src/orchestration-v2/Adapters/AcpRegistryAdapterV2.test.ts b/apps/server/src/orchestration-v2/Adapters/AcpRegistryAdapterV2.test.ts
new file mode 100644
index 000000000000..04e5eda12d49
--- /dev/null
+++ b/apps/server/src/orchestration-v2/Adapters/AcpRegistryAdapterV2.test.ts
@@ -0,0 +1,159 @@
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import { assert, describe, it } from "@effect/vitest";
+import { ProviderInstanceId, ProviderSessionId, ThreadId } from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as Crypto from "effect/Crypto";
+import * as FileSystem from "effect/FileSystem";
+import * as Layer from "effect/Layer";
+import * as Path from "effect/Path";
+import * as Schema from "effect/Schema";
+import { HttpClient, HttpClientResponse } from "effect/unstable/http";
+import { ChildProcessSpawner } from "effect/unstable/process";
+
+import { ServerConfig } from "../../config.ts";
+import { makeAcpRegistryResolver } from "../../provider/acp/AcpRegistrySupport.ts";
+import { layer as idAllocatorLayer, IdAllocatorV2 } from "../IdAllocator.ts";
+import { ProviderAdapterV2RuntimePolicy } from "../ProviderAdapter.ts";
+import { BUILT_IN_PROVIDER_ADAPTER_DRIVER_KINDS_V2 } from "../builtInProviderAdapterDrivers.ts";
+import {
+  ACP_REGISTRY_DRIVER_KIND,
+  AcpRegistryAdapterV2Driver,
+  makeAcpRegistryAdapterV2,
+} from "./AcpRegistryAdapterV2.ts";
+
+const registryUrl = "https://registry.test/registry.json";
+const decodeAcpRegistryAdapterSettings = Schema.decodeUnknownEffect(
+  AcpRegistryAdapterV2Driver.configSchema,
+);
+
+const serverConfigLayer = ServerConfig.layerTest(process.cwd(), {
+  prefix: "t3-acp-registry-v2-adapter-",
+}).pipe(Layer.provide(NodeServices.layer));
+
+const registryLayer = Layer.succeed(
+  HttpClient.HttpClient,
+  HttpClient.make((request) =>
+    Effect.succeed(
+      HttpClientResponse.fromWeb(
+        request,
+        Response.json({
+          version: "1.0.0",
+          agents: [
+            {
+              id: "fixture-agent",
+              name: "Fixture Agent",
+              version: "1.0.0",
+              description: "ACP V2 adapter fixture",
+              distribution: {
+                binary: {
+                  "darwin-aarch64": {
+                    archive: "https://registry.test/unused",
+                    cmd: "fixture-agent",
+                    args: [],
+                  },
+                  "linux-x86_64": {
+                    archive: "https://registry.test/unused",
+                    cmd: "fixture-agent",
+                    args: [],
+                  },
+                },
+              },
+            },
+          ],
+        }),
+      ),
+    ),
+  ),
+);
+
+const testLayer = Layer.mergeAll(
+  NodeServices.layer,
+  idAllocatorLayer,
+  serverConfigLayer,
+  registryLayer,
+);
+
+describe("AcpRegistryAdapterV2", () => {
+  it("is registered as a generic provider driver with schema defaults", () => {
+    assert.isTrue(BUILT_IN_PROVIDER_ADAPTER_DRIVER_KINDS_V2.has(ACP_REGISTRY_DRIVER_KIND));
+    assert.equal(AcpRegistryAdapterV2Driver.driverKind, ACP_REGISTRY_DRIVER_KIND);
+    assert.deepEqual(AcpRegistryAdapterV2Driver.defaultConfig(), {
+      enabled: true,
+      agentId: "",
+      commandPath: "",
+      authMethodId: "",
+      distribution: "auto",
+      customModels: [],
+    });
+  });
+
+  it.effect("opens a real ACP child process resolved from registry configuration", () =>
+    Effect.gen(function* () {
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const path = yield* Path.Path;
+      const serverConfig = yield* ServerConfig;
+      const mockAgentPath = yield* path.fromFileUrl(
+        new URL("../../../scripts/acp-mock-agent.ts", import.meta.url),
+      );
+      const resolver = yield* makeAcpRegistryResolver({
+        cacheDir: serverConfig.providerStatusCacheDir,
+        registryUrl,
+      });
+      const settings = yield* decodeAcpRegistryAdapterSettings({
+        agentId: "fixture-agent",
+        commandPath: process.execPath,
+        authMethodId: "test",
+      });
+      const instanceId = ProviderInstanceId.make("acp-registry-fixture");
+      const adapter = makeAcpRegistryAdapterV2({
+        crypto: yield* Crypto.Crypto,
+        instanceId,
+        settings,
+        environment: {
+          T3_ACP_SESSION_LIFECYCLE: "1",
+        },
+        childProcessSpawner,
+        fileSystem,
+        idAllocator,
+        resolver: {
+          resolve: (configuredSettings, cwd, environment) =>
+            resolver.resolve(configuredSettings, cwd, environment).pipe(
+              Effect.map((resolved) => ({
+                ...resolved,
+                spawn: {
+                  ...resolved.spawn,
+                  args: [mockAgentPath],
+                },
+              })),
+            ),
+        },
+        serverConfig,
+      });
+      const threadId = ThreadId.make("thread-acp-registry-fixture");
+      const runtimePolicy = ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: process.cwd(),
+      });
+      const modelSelection = { instanceId, model: "default" } as const;
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make("provider-session-acp-registry-fixture"),
+        modelSelection,
+        runtimePolicy,
+      });
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy,
+      });
+
+      assert.equal(runtime.providerSession.driver, "acpRegistry");
+      assert.equal(providerThread.nativeThreadRef?.nativeId, "mock-session-1");
+      assert.isTrue(runtime.providerSession.capabilities.threads.canReadThreadSnapshot);
+      assert.isTrue(runtime.providerSession.capabilities.threads.canForkThread);
+    }).pipe(Effect.provide(testLayer), Effect.scoped),
+  );
+});
diff --git a/apps/server/src/orchestration-v2/Adapters/AcpRegistryAdapterV2.testkit.ts b/apps/server/src/orchestration-v2/Adapters/AcpRegistryAdapterV2.testkit.ts
new file mode 100644
index 000000000000..0384fab0ac0a
--- /dev/null
+++ b/apps/server/src/orchestration-v2/Adapters/AcpRegistryAdapterV2.testkit.ts
@@ -0,0 +1,92 @@
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import { AcpRegistrySettings } from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as Crypto from "effect/Crypto";
+import * as FileSystem from "effect/FileSystem";
+import * as Layer from "effect/Layer";
+import * as Path from "effect/Path";
+import * as Schema from "effect/Schema";
+import { ChildProcessSpawner } from "effect/unstable/process";
+
+import { ServerConfig } from "../../config.ts";
+import { layer as idAllocatorLayer, IdAllocatorV2 } from "../IdAllocator.ts";
+import { makeLayerEffect as makeProviderAdapterRegistryLayerEffect } from "../ProviderAdapterRegistry.ts";
+import type { OrchestratorV2ProviderReplayHarness } from "../testkit/ProviderReplayHarness.ts";
+import { makeReplayServerConfig } from "../testkit/ProviderReplayHarness.ts";
+import {
+  type AcpReplayTranscript,
+  AcpReplayTranscriptDecodeError,
+  decodeAcpReplayTranscript,
+  makeAcpReplayCompletenessAssertion,
+  makeAcpReplayRuntime,
+} from "./AcpAdapterV2.testkit.ts";
+import {
+  ACP_REGISTRY_DEFAULT_INSTANCE_ID,
+  ACP_REGISTRY_PROVIDER,
+  makeAcpRegistryAdapterV2,
+} from "./AcpRegistryAdapterV2.ts";
+
+const REPLAY_SETTINGS = Schema.decodeUnknownSync(AcpRegistrySettings)({
+  agentId: "replay-agent",
+  authMethodId: "replay",
+});
+
+export function makeAcpRegistryProviderAdapterRegistryReplayLayer(transcript: AcpReplayTranscript) {
+  const serverConfigLayer = Layer.effect(
+    ServerConfig,
+    makeReplayServerConfig(`acp-registry-${transcript.scenario}`).pipe(Effect.orDie),
+  ).pipe(Layer.provide(NodeServices.layer));
+
+  return makeProviderAdapterRegistryLayerEffect(
+    Effect.gen(function* () {
+      const fileSystem = yield* FileSystem.FileSystem;
+      const path = yield* Path.Path;
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const crypto = yield* Crypto.Crypto;
+      const idAllocator = yield* IdAllocatorV2;
+      const serverConfig = yield* ServerConfig;
+      const replayDir = yield* fileSystem
+        .makeTempDirectory({
+          prefix: `t3-orchestration-v2-acp-registry-replay-${transcript.scenario}-`,
+        })
+        .pipe(Effect.orDie);
+      const statusPath = path.join(replayDir, "status.json");
+      const scriptPath = yield* path
+        .fromFileUrl(new URL("../../../scripts/acp-replay-agent.ts", import.meta.url))
+        .pipe(Effect.orDie);
+      const adapter = makeAcpRegistryAdapterV2({
+        instanceId: ACP_REGISTRY_DEFAULT_INSTANCE_ID,
+        settings: REPLAY_SETTINGS,
+        environment: {},
+        childProcessSpawner,
+        crypto,
+        fileSystem,
+        idAllocator,
+        resolver: {
+          resolve: () => Effect.die("ACP registry resolver must not run during replay"),
+        },
+        serverConfig,
+        makeRuntime: makeAcpReplayRuntime({
+          transcript,
+          statusPath,
+          scriptPath,
+          childProcessSpawner,
+        }),
+        assertComplete: makeAcpReplayCompletenessAssertion(fileSystem, statusPath, transcript),
+      });
+      return [adapter];
+    }),
+  ).pipe(Layer.provide(Layer.mergeAll(serverConfigLayer, NodeServices.layer, idAllocatorLayer)));
+}
+
+export const AcpRegistryOrchestratorReplayHarness: OrchestratorV2ProviderReplayHarness<
+  AcpReplayTranscript,
+  AcpReplayTranscriptDecodeError
+> = {
+  driver: ACP_REGISTRY_PROVIDER,
+  decodeTranscript: (transcript) =>
+    decodeAcpReplayTranscript(transcript, ACP_REGISTRY_PROVIDER, {
+      retargetProvider: true,
+    }),
+  makeProviderAdapterRegistryLayer: makeAcpRegistryProviderAdapterRegistryReplayLayer,
+};
diff --git a/apps/server/src/orchestration-v2/Adapters/AcpRegistryAdapterV2.ts b/apps/server/src/orchestration-v2/Adapters/AcpRegistryAdapterV2.ts
new file mode 100644
index 000000000000..a88cedce117c
--- /dev/null
+++ b/apps/server/src/orchestration-v2/Adapters/AcpRegistryAdapterV2.ts
@@ -0,0 +1,184 @@
+import {
+  AcpRegistrySettings,
+  defaultInstanceIdForDriver,
+  ProviderDriverKind,
+} from "@t3tools/contracts";
+import { HostProcessEnvironment } from "@t3tools/shared/hostProcess";
+import * as Crypto from "effect/Crypto";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Layer from "effect/Layer";
+import * as Path from "effect/Path";
+import * as Schema from "effect/Schema";
+import type * as Scope from "effect/Scope";
+import { HttpClient } from "effect/unstable/http";
+import { ChildProcessSpawner } from "effect/unstable/process";
+import * as EffectAcpErrors from "effect-acp/errors";
+
+import { ServerConfig } from "../../config.ts";
+import {
+  makeAcpRegistryResolver,
+  type AcpRegistryResolverShape,
+} from "../../provider/acp/AcpRegistrySupport.ts";
+import * as AcpSessionRuntime from "../../provider/acp/AcpSessionRuntime.ts";
+import { makeAcpNativeLoggerFactory } from "../../provider/acp/AcpNativeLogging.ts";
+import { ProviderEventLoggers } from "../../provider/Layers/ProviderEventLoggers.ts";
+import { mergeProviderInstanceEnvironment } from "../../provider/ProviderInstanceEnvironment.ts";
+import { IdAllocatorV2 } from "../IdAllocator.ts";
+import {
+  ProviderAdapterDriverCreateError,
+  type ProviderAdapterDriver,
+  type ProviderAdapterDriverCreateInput,
+} from "../ProviderAdapterDriver.ts";
+import {
+  AcpProviderCapabilitiesV2,
+  makeAcpAdapterV2,
+  type AcpAdapterV2Flavor,
+  type AcpAdapterV2RuntimeInput,
+} from "./AcpAdapterV2.ts";
+
+export const ACP_REGISTRY_PROVIDER = ProviderDriverKind.make("acpRegistry");
+export const ACP_REGISTRY_DRIVER_KIND = ACP_REGISTRY_PROVIDER;
+export const ACP_REGISTRY_DEFAULT_INSTANCE_ID =
+  defaultInstanceIdForDriver(ACP_REGISTRY_DRIVER_KIND);
+
+const DEFAULT_ACP_REGISTRY_SETTINGS = Schema.decodeSync(AcpRegistrySettings)({});
+
+export interface AcpRegistryAdapterV2Options {
+  readonly instanceId: Parameters<typeof makeAcpAdapterV2>[0]["instanceId"];
+  readonly settings: AcpRegistrySettings;
+  readonly environment: NodeJS.ProcessEnv;
+  readonly childProcessSpawner: ChildProcessSpawner.ChildProcessSpawner["Service"];
+  readonly crypto: Crypto.Crypto;
+  readonly fileSystem: FileSystem.FileSystem;
+  readonly idAllocator: IdAllocatorV2["Service"];
+  readonly resolver: AcpRegistryResolverShape;
+  readonly serverConfig: ServerConfig["Service"];
+  readonly nativeLogging?: Parameters<typeof makeAcpAdapterV2>[0]["nativeLogging"];
+  readonly makeRuntime?: (
+    input: AcpAdapterV2RuntimeInput,
+  ) => Effect.Effect<
+    AcpSessionRuntime.AcpSessionRuntime["Service"],
+    EffectAcpErrors.AcpError,
+    Crypto.Crypto | Scope.Scope
+  >;
+  readonly assertComplete?: Effect.Effect<void, EffectAcpErrors.AcpError>;
+}
+
+function makeAcpRegistryRuntime(options: AcpRegistryAdapterV2Options) {
+  return (
+    input: AcpAdapterV2RuntimeInput,
+  ): Effect.Effect<
+    AcpSessionRuntime.AcpSessionRuntime["Service"],
+    EffectAcpErrors.AcpError,
+    Crypto.Crypto | Scope.Scope
+  > =>
+    Effect.gen(function* () {
+      const resolved = yield* options.resolver
+        .resolve(options.settings, input.cwd, options.environment)
+        .pipe(
+          Effect.mapError(
+            (cause) =>
+              new EffectAcpErrors.AcpSpawnError({
+                command: options.settings.agentId || ACP_REGISTRY_PROVIDER,
+                cause,
+              }),
+          ),
+        );
+      const context = yield* Layer.build(
+        AcpSessionRuntime.layer({
+          ...input,
+          spawn: resolved.spawn,
+          ...(options.settings.authMethodId ? { authMethodId: options.settings.authMethodId } : {}),
+        }).pipe(
+          Layer.provide(
+            Layer.succeed(ChildProcessSpawner.ChildProcessSpawner, options.childProcessSpawner),
+          ),
+        ),
+      );
+      return yield* Effect.service(AcpSessionRuntime.AcpSessionRuntime).pipe(
+        Effect.provide(context),
+      );
+    });
+}
+
+export function makeAcpRegistryAdapterV2(options: AcpRegistryAdapterV2Options) {
+  const flavor: AcpAdapterV2Flavor = {
+    driver: ACP_REGISTRY_PROVIDER,
+    capabilities: AcpProviderCapabilitiesV2,
+    makeRuntime: options.makeRuntime ?? makeAcpRegistryRuntime(options),
+    ...(options.assertComplete === undefined ? {} : { assertComplete: options.assertComplete }),
+  };
+  return makeAcpAdapterV2({
+    instanceId: options.instanceId,
+    flavor,
+    crypto: options.crypto,
+    fileSystem: options.fileSystem,
+    idAllocator: options.idAllocator,
+    serverConfig: options.serverConfig,
+    ...(options.nativeLogging === undefined ? {} : { nativeLogging: options.nativeLogging }),
+  });
+}
+
+export type AcpRegistryAdapterV2DriverEnv =
+  | ChildProcessSpawner.ChildProcessSpawner
+  | Crypto.Crypto
+  | FileSystem.FileSystem
+  | HttpClient.HttpClient
+  | IdAllocatorV2
+  | Path.Path
+  | ProviderEventLoggers
+  | ServerConfig;
+
+export const AcpRegistryAdapterV2Driver: ProviderAdapterDriver<
+  AcpRegistrySettings,
+  AcpRegistryAdapterV2DriverEnv
+> = {
+  driverKind: ACP_REGISTRY_DRIVER_KIND,
+  configSchema: AcpRegistrySettings,
+  defaultConfig: (): AcpRegistrySettings => DEFAULT_ACP_REGISTRY_SETTINGS,
+  create: Effect.fn("AcpRegistryAdapterV2Driver.create")(
+    function* (input: ProviderAdapterDriverCreateInput<AcpRegistrySettings>) {
+      const hostEnvironment = yield* HostProcessEnvironment;
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const crypto = yield* Crypto.Crypto;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const providerEventLoggers = yield* ProviderEventLoggers;
+      const serverConfig = yield* ServerConfig;
+      const makeNativeLogger = yield* makeAcpNativeLoggerFactory();
+      const resolver = yield* makeAcpRegistryResolver({
+        cacheDir: serverConfig.providerStatusCacheDir,
+      });
+      return makeAcpRegistryAdapterV2({
+        instanceId: input.instanceId,
+        settings: { ...input.config, enabled: input.enabled },
+        environment: mergeProviderInstanceEnvironment(input.environment, hostEnvironment),
+        childProcessSpawner,
+        crypto,
+        fileSystem,
+        idAllocator,
+        resolver,
+        serverConfig,
+        nativeLogging: (threadId) =>
+          makeNativeLogger({
+            nativeEventLogger: providerEventLoggers.native,
+            provider: ACP_REGISTRY_PROVIDER,
+            threadId,
+          }),
+      });
+    },
+    (effect, input) =>
+      effect.pipe(
+        Effect.mapError(
+          (cause) =>
+            new ProviderAdapterDriverCreateError({
+              driver: ACP_REGISTRY_DRIVER_KIND,
+              instanceId: input.instanceId,
+              detail: "Failed to create ACP Registry adapter.",
+              cause,
+            }),
+        ),
+      ),
+  ),
+};
diff --git a/apps/server/src/orchestration-v2/Adapters/ClaudeAdapterV2.test.ts b/apps/server/src/orchestration-v2/Adapters/ClaudeAdapterV2.test.ts
new file mode 100644
index 000000000000..35a3eb55a7e8
--- /dev/null
+++ b/apps/server/src/orchestration-v2/Adapters/ClaudeAdapterV2.test.ts
@@ -0,0 +1,5605 @@
+import type {
+  Query as ClaudeQuery,
+  SDKMessage,
+  SDKUserMessage,
+} from "@anthropic-ai/claude-agent-sdk";
+import type { AskUserQuestionInput } from "@anthropic-ai/claude-agent-sdk/sdk-tools";
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import {
+  ChatAttachmentId,
+  ChatFileAttachment,
+  ChatImageAttachment,
+  ClaudeSettings,
+  EnvironmentId,
+  MessageId,
+  type ModelSelection,
+  NodeId,
+  type OrchestrationV2AppThread,
+  type OrchestrationV2ProviderThread,
+  ProjectId,
+  ProviderInstanceId,
+  type ProviderApprovalDecision,
+  ProviderSessionId,
+  ProviderTurnId,
+  RunAttemptId,
+  RunId,
+  ThreadId,
+} from "@t3tools/contracts";
+import { assert, describe, it } from "@effect/vitest";
+import * as Context from "effect/Context";
+import * as DateTime from "effect/DateTime";
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as FileSystem from "effect/FileSystem";
+import * as Fiber from "effect/Fiber";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+import * as Queue from "effect/Queue";
+import * as Schema from "effect/Schema";
+import * as Scope from "effect/Scope";
+import * as Stream from "effect/Stream";
+import { Tool } from "effect/unstable/ai";
+import { formatClaudeResumeCompactionQuestion } from "@t3tools/shared/claudeCompaction";
+
+import { attachmentRelativePath } from "../../attachmentStore.ts";
+import * as McpProviderSession from "../../mcp/McpProviderSession.ts";
+import { OrchestratorToolkit } from "../../mcp/toolkits/orchestrator/tools.ts";
+import type { EventNdjsonLogger } from "../../provider/Layers/EventNdjsonLogger.ts";
+import {
+  ProviderAdapterV2RuntimePolicy,
+  type ProviderAdapterV2Event,
+  type ProviderAdapterV2TurnInput,
+} from "../ProviderAdapter.ts";
+import type { ProviderContinuationRequest } from "../ProviderContinuationRequests.ts";
+import {
+  CLAUDE_AGENT_SDK_QUERY_PROTOCOL,
+  CLAUDE_DEFAULT_INSTANCE_ID,
+  CLAUDE_PROVIDER,
+  CLAUDE_READ_ONLY_ALLOWED_TOOLS,
+  CLAUDE_READ_ONLY_T3_MCP_ALLOWED_TOOLS,
+  CLAUDE_T3_MCP_TOOL_WILDCARD,
+  ClaudeProviderCapabilitiesV2,
+  ClaudeAgentSdkQueryRunnerError,
+  claudeEffectiveQueryPolicyKey,
+  claudeProviderTurnTokenUsage,
+  claudeMcpQueryOverrides,
+  claudeQueryMessages,
+  claudeRuntimeQueryPolicyForRuntimePolicy,
+  claudeSdkUserInputAnswers,
+  claudeUserInputQuestions,
+  claudeTodoSteps,
+  claudeProposedPlan,
+  awaitClaudeApprovalDecision,
+  loggedClaudeQueryOptions,
+  makeClaudeAdapterV2,
+  makeClaudeAgentSdkProtocolLogger,
+  makeClaudeQueryOptions,
+  permissionResultFromDecision,
+  type ClaudeAgentSdkQueryOptions,
+  type ClaudeAgentSdkQueryOpenInput,
+} from "./ClaudeAdapterV2.ts";
+import { layer as idAllocatorLayer, IdAllocatorV2 } from "../IdAllocator.ts";
+
+const DEFAULT_CLAUDE_SETTINGS = Schema.decodeSync(ClaudeSettings)({});
+const AUTO_COMPACT_CLAUDE_SETTINGS = Schema.decodeSync(ClaudeSettings)({
+  autoCompactWindow: "300000",
+});
+const CLAUDE_TEST_MODEL_SELECTION = {
+  instanceId: ProviderInstanceId.make(CLAUDE_PROVIDER),
+  model: "claude-sonnet-4-6",
+  options: [{ id: "effort", value: "ultrathink" }],
+} satisfies ModelSelection;
+const CLAUDE_TEST_RUNTIME_POLICY = ProviderAdapterV2RuntimePolicy.make({
+  runtimeMode: "full-access",
+  interactionMode: "default",
+  cwd: "/workspace",
+});
+
+function makeClaudeTestAppThread(input: {
+  readonly threadId: ThreadId;
+  readonly providerThread: OrchestrationV2ProviderThread;
+  readonly now: DateTime.Utc;
+}): OrchestrationV2AppThread {
+  return {
+    createdBy: "user",
+    creationSource: "web",
+    id: input.threadId,
+    projectId: ProjectId.make(`project-${input.threadId}`),
+    title: "Claude attachment test",
+    providerInstanceId: ProviderInstanceId.make(CLAUDE_PROVIDER),
+    modelSelection: CLAUDE_TEST_MODEL_SELECTION,
+    runtimeMode: "full-access",
+    interactionMode: "default",
+    branch: null,
+    worktreePath: null,
+    activeProviderThreadId: input.providerThread.id,
+    lineage: {
+      parentThreadId: null,
+      relationshipToParent: null,
+      rootThreadId: input.threadId,
+    },
+    forkedFrom: null,
+    createdAt: input.now,
+    updatedAt: input.now,
+    archivedAt: null,
+    settledOverride: null,
+    settledAt: null,
+    lastVisitedAt: null,
+    deletedAt: null,
+  };
+}
+
+function makeClaudeTestTurnInput(input: {
+  readonly threadId: ThreadId;
+  readonly providerThread: OrchestrationV2ProviderThread;
+  readonly now: DateTime.Utc;
+  readonly attemptId: RunAttemptId;
+  readonly text: string;
+  readonly attachments: ProviderAdapterV2TurnInput["message"]["attachments"];
+  readonly providerTurnOrdinal?: number;
+  readonly messageCreatedBy?: ProviderAdapterV2TurnInput["message"]["createdBy"];
+  readonly messageCreationSource?: ProviderAdapterV2TurnInput["message"]["creationSource"];
+  readonly modelSelection?: ModelSelection;
+  readonly runtimePolicy?: ProviderAdapterV2RuntimePolicy;
+}): ProviderAdapterV2TurnInput {
+  return {
+    appThread: makeClaudeTestAppThread(input),
+    threadId: input.threadId,
+    runId: RunId.make(`run-${input.attemptId}`),
+    runOrdinal: 1,
+    providerTurnOrdinal: input.providerTurnOrdinal ?? 1,
+    attemptId: input.attemptId,
+    rootNodeId: NodeId.make(`node-${input.attemptId}`),
+    providerThread: input.providerThread,
+    message: {
+      createdBy: input.messageCreatedBy ?? "user",
+      creationSource: input.messageCreationSource ?? "web",
+      messageId: MessageId.make(`message-${input.attemptId}`),
+      text: input.text,
+      attachments: input.attachments,
+    },
+    modelSelection: input.modelSelection ?? CLAUDE_TEST_MODEL_SELECTION,
+    runtimePolicy: input.runtimePolicy ?? CLAUDE_TEST_RUNTIME_POLICY,
+  };
+}
+
+describe("ClaudeAdapterV2 runtime query policy", () => {
+  it("passes automatic compaction and resume-dialog controls to the SDK", () => {
+    const onUserDialog = async () => ({
+      behavior: "completed" as const,
+      result: "continue" as const,
+    });
+    const options = makeClaudeQueryOptions({
+      modelSelection: CLAUDE_TEST_MODEL_SELECTION,
+      nativeThreadId: "native-thread-auto-compact",
+      resume: true,
+      cwd: "/workspace",
+      settings: AUTO_COMPACT_CLAUDE_SETTINGS,
+      onUserDialog,
+      supportedDialogKinds: ["resume_return"],
+    });
+
+    assert.equal((options.settings as { autoCompactWindow?: number }).autoCompactWindow, 300_000);
+    assert.equal(options.onUserDialog, onUserDialog);
+    assert.deepEqual(options.supportedDialogKinds, ["resume_return"]);
+  });
+
+  it("projects AskUserQuestion input with question text as the answer key", () => {
+    assert.deepEqual(
+      claudeUserInputQuestions({
+        questions: [
+          {
+            header: "Approach",
+            question: "Which approach?",
+            options: [{ label: "Simple", description: "Use fewer moving parts" }],
+            multiSelect: true,
+          },
+        ],
+      }),
+      [
+        {
+          id: "Which approach?",
+          header: "Approach",
+          question: "Which approach?",
+          options: [{ label: "Simple", description: "Use fewer moving parts" }],
+          multiSelect: true,
+        },
+      ],
+    );
+    const sdkAnswers: NonNullable<AskUserQuestionInput["answers"]> = claudeSdkUserInputAnswers({
+      "Which approach?": ["Simple", "Safe"],
+      "Deploy now?": "Yes",
+    });
+    assert.deepEqual(sdkAnswers, {
+      "Which approach?": "Simple, Safe",
+      "Deploy now?": "Yes",
+    });
+    assert.isTrue(ClaudeProviderCapabilitiesV2.planning.supportsStructuredQuestions);
+  });
+
+  it("normalizes Claude todo and proposed-plan tool input", () => {
+    assert.deepEqual(
+      claudeTodoSteps({
+        todos: [
+          { content: "Inspect", status: "completed" },
+          { content: "Implement", status: "in_progress" },
+        ],
+      }),
+      [
+        { id: "todo-0", text: "Inspect", status: "completed" },
+        { id: "todo-1", text: "Implement", status: "running" },
+      ],
+    );
+    assert.equal(claudeProposedPlan({ plan: "  # Plan\nShip it  " }), "# Plan\nShip it");
+    assert.isTrue(ClaudeProviderCapabilitiesV2.planning.emitsTodoList);
+    assert.isTrue(ClaudeProviderCapabilitiesV2.planning.emitsProposedPlan);
+  });
+
+  it("maps canonical read-only never policy to Claude dontAsk with read-only tools", () => {
+    const queryPolicy = claudeRuntimeQueryPolicyForRuntimePolicy(
+      ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: "/workspace",
+        approvalPolicy: "never",
+        sandboxPolicy: {
+          type: "readOnly",
+          access: { type: "fullAccess" },
+          networkAccess: false,
+        },
+      }),
+    );
+
+    assert.deepEqual(queryPolicy, {
+      permissionMode: "dontAsk",
+      tools: CLAUDE_READ_ONLY_ALLOWED_TOOLS,
+      allowedTools: CLAUDE_READ_ONLY_ALLOWED_TOOLS,
+      installPermissionCallback: false,
+    });
+  });
+
+  it("maps canonical read-only on-request policy to Claude default with callbacks", () => {
+    const queryPolicy = claudeRuntimeQueryPolicyForRuntimePolicy(
+      ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: "/workspace",
+        approvalPolicy: "on-request",
+        sandboxPolicy: {
+          type: "readOnly",
+          access: { type: "fullAccess" },
+          networkAccess: false,
+        },
+      }),
+    );
+
+    assert.deepEqual(queryPolicy, {
+      permissionMode: "default",
+      tools: CLAUDE_READ_ONLY_ALLOWED_TOOLS,
+      allowedTools: CLAUDE_READ_ONLY_ALLOWED_TOOLS,
+      installPermissionCallback: true,
+    });
+  });
+
+  it("does not auto-allow reads for canonical restricted read-only never policy", () => {
+    const queryPolicy = claudeRuntimeQueryPolicyForRuntimePolicy(
+      ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: "/workspace",
+        approvalPolicy: "never",
+        sandboxPolicy: {
+          type: "readOnly",
+          access: {
+            type: "restricted",
+            includePlatformDefaults: false,
+            readableRoots: [],
+          },
+          networkAccess: false,
+        },
+      }),
+    );
+
+    assert.deepEqual(queryPolicy, {
+      permissionMode: "dontAsk",
+      tools: CLAUDE_READ_ONLY_ALLOWED_TOOLS,
+      installPermissionCallback: false,
+    });
+  });
+
+  it("maps default full-access policy to Claude bypass permissions", () => {
+    const queryPolicy = claudeRuntimeQueryPolicyForRuntimePolicy(
+      ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: "/workspace",
+      }),
+    );
+
+    assert.deepEqual(queryPolicy, {
+      permissionMode: "bypassPermissions",
+      allowDangerouslySkipPermissions: true,
+      installPermissionCallback: false,
+    });
+  });
+
+  it("maps Auto runtime mode to Claude's AI-reviewed permission mode", () => {
+    const queryPolicy = claudeRuntimeQueryPolicyForRuntimePolicy(
+      ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "auto",
+        interactionMode: "default",
+        cwd: "/workspace",
+      }),
+    );
+
+    assert.deepEqual(queryPolicy, {
+      permissionMode: "auto",
+      installPermissionCallback: false,
+    });
+  });
+
+  it("keeps approval-required mode interactive with danger-full-access sandboxing", () => {
+    const queryPolicy = claudeRuntimeQueryPolicyForRuntimePolicy(
+      ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "approval-required",
+        interactionMode: "default",
+        cwd: "/workspace",
+        sandboxPolicy: {
+          type: "dangerFullAccess",
+        },
+      }),
+    );
+
+    assert.deepEqual(queryPolicy, {
+      permissionMode: "default",
+      installPermissionCallback: true,
+    });
+  });
+
+  it("installs the permission callback for approval-required plan mode", () => {
+    const queryPolicy = claudeRuntimeQueryPolicyForRuntimePolicy(
+      ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "approval-required",
+        interactionMode: "plan",
+        cwd: "/workspace",
+      }),
+    );
+
+    assert.deepEqual(queryPolicy, {
+      permissionMode: "plan",
+      installPermissionCallback: true,
+    });
+  });
+
+  it("honors never approvals for approval-required workspace-write policy", () => {
+    const queryPolicy = claudeRuntimeQueryPolicyForRuntimePolicy(
+      ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "approval-required",
+        interactionMode: "default",
+        cwd: "/workspace",
+        approvalPolicy: "never",
+        sandboxPolicy: {
+          type: "workspaceWrite",
+        },
+      }),
+    );
+
+    assert.deepEqual(queryPolicy, {
+      permissionMode: "dontAsk",
+      installPermissionCallback: false,
+    });
+  });
+
+  it("honors never approvals for externally sandboxed policy", () => {
+    const queryPolicy = claudeRuntimeQueryPolicyForRuntimePolicy(
+      ProviderAdapterV2RuntimePolicy.make({
+        runtimeMode: "approval-required",
+        interactionMode: "default",
+        cwd: "/workspace",
+        approvalPolicy: "never",
+        sandboxPolicy: {
+          type: "externalSandbox",
+        },
+      }),
+    );
+
+    assert.deepEqual(queryPolicy, {
+      permissionMode: "bypassPermissions",
+      allowDangerouslySkipPermissions: true,
+      installPermissionCallback: false,
+    });
+  });
+});
+
+describe("ClaudeAdapterV2 MCP query overrides", () => {
+  const T3_MCP_SERVERS = {
+    "t3-code": {
+      type: "http",
+      url: "http://127.0.0.1:43123/mcp",
+      headers: {
+        Authorization: "Bearer secret-claude-token",
+      },
+    },
+  } as const;
+
+  const withMcpSession = (threadId: ThreadId, run: () => void) => {
+    McpProviderSession.setMcpProviderSession({
+      environmentId: EnvironmentId.make(`environment-${threadId}`),
+      threadId,
+      providerSessionId: `mcp-session-${threadId}`,
+      providerInstanceId: ProviderInstanceId.make("claudeAgent"),
+      endpoint: "http://127.0.0.1:43123/mcp",
+      authorizationHeader: "Bearer secret-claude-token",
+      browserToolsAvailable: true,
+    });
+    try {
+      run();
+    } finally {
+      McpProviderSession.clearMcpProviderSession(threadId);
+    }
+  };
+
+  it("leaves an absent allowlist absent when no MCP session exists", () => {
+    const overrides = claudeMcpQueryOverrides({
+      threadId: ThreadId.make("thread-claude-no-mcp-no-allowlist"),
+      readOnlySandbox: false,
+    });
+
+    assert.deepEqual(overrides, {});
+  });
+
+  it("preserves an explicit allowlist when no MCP session exists", () => {
+    const overrides = claudeMcpQueryOverrides({
+      threadId: ThreadId.make("thread-claude-no-mcp-with-allowlist"),
+      readOnlySandbox: false,
+      allowedTools: ["Read"],
+    });
+
+    assert.deepEqual(overrides, { allowedTools: ["Read"] });
+  });
+
+  it("pre-approves all t3-code tools when attaching an MCP session without an allowlist", () => {
+    const threadId = ThreadId.make("thread-claude-mcp-no-allowlist");
+    withMcpSession(threadId, () => {
+      const overrides = claudeMcpQueryOverrides({ threadId, readOnlySandbox: false });
+
+      assert.deepEqual(overrides, {
+        allowedTools: [CLAUDE_T3_MCP_TOOL_WILDCARD],
+        mcpServers: T3_MCP_SERVERS,
+      });
+    });
+  });
+
+  it("extends an explicit allowlist with the t3-code wildcard", () => {
+    const threadId = ThreadId.make("thread-claude-mcp-with-allowlist");
+    withMcpSession(threadId, () => {
+      const overrides = claudeMcpQueryOverrides({
+        threadId,
+        readOnlySandbox: false,
+        allowedTools: ["Read", "mcp__t3-code__*"],
+      });
+
+      assert.deepEqual(overrides, {
+        allowedTools: ["Read", "mcp__t3-code__*"],
+        mcpServers: T3_MCP_SERVERS,
+      });
+    });
+  });
+
+  it("pre-approves only read-only t3-code tools in a read-only sandbox", () => {
+    const threadId = ThreadId.make("thread-claude-mcp-read-only");
+    withMcpSession(threadId, () => {
+      const overrides = claudeMcpQueryOverrides({
+        threadId,
+        readOnlySandbox: true,
+        allowedTools: [...CLAUDE_READ_ONLY_ALLOWED_TOOLS],
+      });
+
+      assert.deepEqual(overrides, {
+        allowedTools: [...CLAUDE_READ_ONLY_ALLOWED_TOOLS, ...CLAUDE_READ_ONLY_T3_MCP_ALLOWED_TOOLS],
+        mcpServers: T3_MCP_SERVERS,
+      });
+      assert.isFalse(overrides.allowedTools?.includes(CLAUDE_T3_MCP_TOOL_WILDCARD));
+    });
+  });
+
+  it("pre-approves only read-only t3-code tools in a read-only sandbox without an allowlist", () => {
+    const threadId = ThreadId.make("thread-claude-mcp-read-only-no-allowlist");
+    withMcpSession(threadId, () => {
+      const overrides = claudeMcpQueryOverrides({ threadId, readOnlySandbox: true });
+
+      assert.deepEqual(overrides.allowedTools, [...CLAUDE_READ_ONLY_T3_MCP_ALLOWED_TOOLS]);
+    });
+  });
+
+  it("keys live-query reuse on the MCP-derived pre-approvals", () => {
+    const threadId = ThreadId.make("thread-claude-mcp-query-key");
+    withMcpSession(threadId, () => {
+      const queryPolicy = claudeRuntimeQueryPolicyForRuntimePolicy(
+        ProviderAdapterV2RuntimePolicy.make({
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          cwd: "/workspace",
+          approvalPolicy: "on-request",
+          sandboxPolicy: {
+            type: "readOnly",
+            access: { type: "fullAccess" },
+            networkAccess: false,
+          },
+        }),
+      );
+
+      const readOnlyKey = claudeEffectiveQueryPolicyKey(
+        queryPolicy,
+        claudeMcpQueryOverrides({ threadId, readOnlySandbox: true }),
+      );
+      const fullAccessKey = claudeEffectiveQueryPolicyKey(
+        queryPolicy,
+        claudeMcpQueryOverrides({ threadId, readOnlySandbox: false }),
+      );
+      const detachedKey = claudeEffectiveQueryPolicyKey(queryPolicy, {});
+
+      assert.notEqual(readOnlyKey, fullAccessKey);
+      assert.notEqual(fullAccessKey, detachedKey);
+    });
+  });
+
+  it("invalidates live-query reuse when MCP credentials rotate", () => {
+    const threadId = ThreadId.make("thread-claude-mcp-credential-rotation");
+    withMcpSession(threadId, () => {
+      const queryPolicy = claudeRuntimeQueryPolicyForRuntimePolicy(
+        ProviderAdapterV2RuntimePolicy.make({
+          runtimeMode: "approval-required",
+          interactionMode: "default",
+          cwd: "/workspace",
+        }),
+      );
+      const initialKey = claudeEffectiveQueryPolicyKey(
+        queryPolicy,
+        claudeMcpQueryOverrides({ threadId, readOnlySandbox: false }),
+      );
+
+      McpProviderSession.setMcpProviderSession({
+        environmentId: EnvironmentId.make(`environment-${threadId}`),
+        threadId,
+        providerSessionId: `mcp-session-${threadId}`,
+        providerInstanceId: ProviderInstanceId.make("claudeAgent"),
+        endpoint: "http://127.0.0.1:43123/mcp",
+        authorizationHeader: "Bearer rotated-claude-token",
+        browserToolsAvailable: true,
+      });
+
+      const rotatedKey = claudeEffectiveQueryPolicyKey(
+        queryPolicy,
+        claudeMcpQueryOverrides({ threadId, readOnlySandbox: false }),
+      );
+      assert.notEqual(rotatedKey, initialKey);
+    });
+  });
+
+  it("matches the read-only allowlist to the orchestrator toolkit annotations", () => {
+    const readOnlyToolNames = Object.values(OrchestratorToolkit.tools)
+      .filter((tool) => Context.get(tool.annotations, Tool.Readonly))
+      .map((tool) => `mcp__t3-code__${tool.name}`)
+      .sort();
+
+    assert.deepEqual([...CLAUDE_READ_ONLY_T3_MCP_ALLOWED_TOOLS].sort(), readOnlyToolNames);
+  });
+});
+
+describe("ClaudeAdapterV2 native protocol logging", () => {
+  it("injects thread-scoped MCP configuration without logging the credential", () => {
+    const threadId = ThreadId.make("thread-claude-mcp");
+    McpProviderSession.setMcpProviderSession({
+      environmentId: EnvironmentId.make("environment-claude-mcp"),
+      threadId,
+      providerSessionId: "mcp-session-claude",
+      providerInstanceId: ProviderInstanceId.make("claudeAgent"),
+      endpoint: "http://127.0.0.1:43123/mcp",
+      authorizationHeader: "Bearer secret-claude-token",
+      browserToolsAvailable: true,
+    });
+
+    try {
+      const overrides = claudeMcpQueryOverrides({
+        threadId,
+        readOnlySandbox: false,
+        allowedTools: ["Read"],
+      });
+      assert.deepEqual(overrides, {
+        allowedTools: ["Read", "mcp__t3-code__*"],
+        mcpServers: {
+          "t3-code": {
+            type: "http",
+            url: "http://127.0.0.1:43123/mcp",
+            headers: {
+              Authorization: "Bearer secret-claude-token",
+            },
+          },
+        },
+      });
+
+      const options = makeClaudeQueryOptions({
+        modelSelection: {
+          instanceId: ProviderInstanceId.make("claudeAgent"),
+          model: "claude-sonnet-4-6",
+        },
+        nativeThreadId: "native-thread-claude-mcp",
+        resume: false,
+        cwd: "/workspace",
+        ...overrides,
+      });
+      assert.isObject(options.systemPrompt);
+      const systemPrompt = options.systemPrompt as {
+        readonly type: string;
+        readonly preset: string;
+        readonly append?: string;
+      };
+      assert.equal(systemPrompt.type, "preset");
+      assert.equal(systemPrompt.preset, "claude_code");
+      assert.include(systemPrompt.append ?? "", "use `delegate_task`");
+      const logged = loggedClaudeQueryOptions(options);
+      assert.equal(logged.hasMcpServers, true);
+      assert.notInclude(JSON.stringify(logged), "secret-claude-token");
+    } finally {
+      McpProviderSession.clearMcpProviderSession(threadId);
+    }
+  });
+
+  it.effect("writes Claude Agent SDK protocol frames to the native provider log", () =>
+    Effect.gen(function* () {
+      const writes: Array<{
+        readonly event: unknown;
+        readonly threadId: ThreadId | null;
+      }> = [];
+      const logger: EventNdjsonLogger = {
+        filePath: "/tmp/events.log",
+        write: (event, threadId) =>
+          Effect.sync(() => {
+            writes.push({ event, threadId });
+          }),
+        close: () => Effect.void,
+      };
+      const threadId = ThreadId.make("thread-1");
+      const providerSessionId = ProviderSessionId.make("provider-session-1");
+      const protocolLogger = makeClaudeAgentSdkProtocolLogger({
+        nativeEventLogger: logger,
+        threadId,
+        providerSessionId,
+      });
+
+      assert.notEqual(protocolLogger, undefined);
+      if (protocolLogger === undefined) {
+        return;
+      }
+
+      yield* protocolLogger({
+        direction: "outgoing",
+        stage: "decoded",
+        payload: {
+          type: "query.interrupt",
+        },
+      });
+
+      assert.equal(writes.length, 1);
+      assert.equal(writes[0]?.threadId, threadId);
+      assert.deepEqual(writes[0]?.event, {
+        provider: "claudeAgent",
+        protocol: CLAUDE_AGENT_SDK_QUERY_PROTOCOL,
+        kind: "protocol",
+        providerSessionId,
+        event: {
+          direction: "outgoing",
+          stage: "decoded",
+          payload: {
+            type: "query.interrupt",
+          },
+        },
+      });
+    }),
+  );
+
+  it("does not install a protocol logger when native logging is unavailable", () => {
+    const protocolLogger = makeClaudeAgentSdkProtocolLogger({
+      nativeEventLogger: undefined,
+      threadId: ThreadId.make("thread-1"),
+      providerSessionId: ProviderSessionId.make("provider-session-1"),
+    });
+
+    assert.equal(protocolLogger, undefined);
+  });
+
+  it("logs query options without leaking environment values or callback functions", () => {
+    const options: ClaudeAgentSdkQueryOptions = {
+      model: "claude-sonnet-4-6",
+      tools: {
+        type: "preset",
+        preset: "claude_code",
+      },
+      permissionMode: "default",
+      sessionId: "native-thread-1",
+      cwd: "/workspace",
+      env: {
+        ANTHROPIC_API_KEY: "secret",
+      },
+      extraArgs: {
+        "append-system-prompt": "secret launch prompt",
+      },
+      canUseTool: (_toolName, input, callbackOptions) =>
+        Promise.resolve({
+          behavior: "allow",
+          updatedInput: input,
+          toolUseID: callbackOptions.toolUseID,
+          decisionClassification: "user_temporary",
+        }),
+    };
+
+    assert.deepEqual(loggedClaudeQueryOptions(options), {
+      model: "claude-sonnet-4-6",
+      tools: {
+        type: "preset",
+        preset: "claude_code",
+      },
+      permissionMode: "default",
+      sessionId: "native-thread-1",
+      cwd: "/workspace",
+      hasCanUseTool: true,
+      hasEnvironment: true,
+      hasExtraArgs: true,
+    });
+    assert.notInclude(JSON.stringify(loggedClaudeQueryOptions(options)), "secret launch prompt");
+  });
+});
+
+describe("ClaudeAdapterV2 context usage", () => {
+  it("projects assistant usage against the selected context window", () => {
+    const usage = claudeProviderTurnTokenUsage(
+      {
+        input_tokens: 42_000,
+        cache_creation_input_tokens: 2_000,
+        cache_read_input_tokens: 5_000,
+        output_tokens: 1_000,
+      },
+      CLAUDE_TEST_MODEL_SELECTION,
+      "2026-08-29T00:00:00.000Z",
+    );
+
+    assert.deepEqual(usage, {
+      usedTokens: 50_000,
+      maxTokens: 200_000,
+      inputTokens: 49_000,
+      cachedInputTokens: 5_000,
+      outputTokens: 1_000,
+      reasoningOutputTokens: 0,
+      updatedAt: "2026-08-29T00:00:00.000Z",
+    });
+  });
+});
+
+describe("ClaudeAdapterV2 session permissions", () => {
+  it("forces suggested permission updates to session scope", () => {
+    const result = permissionResultFromDecision({
+      toolName: "Bash",
+      decision: "acceptForSession",
+      toolInput: { command: "git status" },
+      toolUseID: "tool-1",
+      suggestions: [
+        {
+          type: "addRules",
+          rules: [{ toolName: "Bash", ruleContent: "git status" }],
+          behavior: "allow",
+          destination: "localSettings",
+        },
+      ],
+    });
+
+    assert.equal(result.behavior, "allow");
+    if (result.behavior !== "allow") {
+      return;
+    }
+    assert.deepEqual(result.updatedPermissions, [
+      {
+        type: "addRules",
+        rules: [{ toolName: "Bash", ruleContent: "git status" }],
+        behavior: "allow",
+        destination: "session",
+      },
+    ]);
+  });
+
+  it("adds a whole-tool session rule when Claude offers no suggestion", () => {
+    const result = permissionResultFromDecision({
+      toolName: "mcp__t3__custom_tool",
+      decision: "acceptForSession",
+      toolInput: {},
+      toolUseID: "tool-2",
+    });
+
+    assert.equal(result.behavior, "allow");
+    if (result.behavior !== "allow") {
+      return;
+    }
+    assert.deepEqual(result.updatedPermissions, [
+      {
+        type: "addRules",
+        rules: [{ toolName: "mcp__t3__custom_tool" }],
+        behavior: "allow",
+        destination: "session",
+      },
+    ]);
+  });
+});
+
+describe("ClaudeAdapterV2 approval cancellation", () => {
+  it.effect("observes an approval signal that was already aborted", () =>
+    Effect.gen(function* () {
+      const decision = yield* Deferred.make<ProviderApprovalDecision>();
+      const controller = new AbortController();
+      controller.abort();
+
+      const result = yield* awaitClaudeApprovalDecision(decision, controller.signal);
+
+      assert.equal(result, "cancel");
+    }),
+  );
+
+  it.effect("removes the cancellation listener after approval resolves", () =>
+    Effect.gen(function* () {
+      const decision = yield* Deferred.make<ProviderApprovalDecision>();
+      const controller = new AbortController();
+      let removes = 0;
+      const removeEventListener = controller.signal.removeEventListener.bind(controller.signal);
+      controller.signal.removeEventListener = (...args) => {
+        removes += 1;
+        return removeEventListener(...args);
+      };
+      const fiber = yield* Effect.forkChild(
+        awaitClaudeApprovalDecision(decision, controller.signal),
+      );
+      yield* Effect.yieldNow;
+      yield* Deferred.succeed(decision, "accept");
+      const result = yield* Fiber.join(fiber);
+
+      assert.equal(result, "accept");
+      assert.equal(removes, 1);
+    }),
+  );
+});
+
+describe("ClaudeAdapterV2 resume compaction", () => {
+  it.effect("resolves and cancels the SDK resume dialog through structured runtime input", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const fileSystem = yield* FileSystem.FileSystem;
+        const idAllocator = yield* IdAllocatorV2;
+        const attachmentsDir = yield* fileSystem.makeTempDirectoryScoped({
+          prefix: "t3-claude-resume-",
+        });
+        let openedOptions: ClaudeAgentSdkQueryOptions | undefined;
+        const adapter = makeClaudeAdapterV2({
+          instanceId: CLAUDE_DEFAULT_INSTANCE_ID,
+          settings: DEFAULT_CLAUDE_SETTINGS,
+          environment: {},
+          attachmentsDir,
+          fileSystem,
+          idAllocator,
+          queryRunner: {
+            allocateSessionId: Effect.succeed("native-thread-claude-resume"),
+            open: (input) =>
+              Effect.sync(() => {
+                openedOptions = input.options;
+                return {
+                  messages: Stream.never,
+                  offer: () => Effect.void,
+                  setModel: () => Effect.void,
+                  interrupt: Effect.void,
+                  close: Effect.void,
+                };
+              }),
+            forkSession: () => Effect.die("unused"),
+            assertComplete: Effect.void,
+          },
+        });
+        const threadId = ThreadId.make("thread-claude-resume");
+        const runtime = yield* adapter.openSession({
+          threadId,
+          providerSessionId: ProviderSessionId.make("provider-session-claude-resume"),
+          modelSelection: CLAUDE_TEST_MODEL_SELECTION,
+          runtimePolicy: CLAUDE_TEST_RUNTIME_POLICY,
+        });
+        const providerThread = yield* runtime.ensureThread({
+          threadId,
+          modelSelection: CLAUDE_TEST_MODEL_SELECTION,
+          runtimePolicy: CLAUDE_TEST_RUNTIME_POLICY,
+        });
+        const now = yield* DateTime.now;
+        yield* runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId,
+            providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-resume"),
+            text: "continue",
+            attachments: [],
+          }),
+        );
+        const callback = openedOptions?.onUserDialog;
+        assert.isFunction(callback);
+        const canUseTool = openedOptions?.canUseTool;
+        assert.isFunction(canUseTool);
+        const ordinaryToolResult = yield* Effect.promise(() =>
+          canUseTool!(
+            "Bash",
+            { command: "pwd" },
+            {
+              signal: new AbortController().signal,
+              toolUseID: "tool-bash-full-access",
+              requestId: "request-bash-full-access",
+            },
+          ),
+        );
+        assert.deepEqual(ordinaryToolResult, {
+          behavior: "allow",
+          updatedInput: { command: "pwd" },
+          toolUseID: "tool-bash-full-access",
+        });
+        const longQuestion = `Choose a deployment target: ${"region ".repeat(80)}`;
+        const questionRequestEvent = yield* runtime.events.pipe(
+          Stream.filter((event) => event.type === "runtime_request.updated"),
+          Stream.runHead,
+          Effect.forkScoped,
+        );
+        const questionResult = yield* Effect.promise(() =>
+          canUseTool!(
+            "AskUserQuestion",
+            {
+              questions: [
+                {
+                  header: "Target",
+                  question: longQuestion,
+                  options: [
+                    { label: "Production", description: "Deploy to production." },
+                    { label: "Staging", description: "Deploy to staging." },
+                  ],
+                  multiSelect: true,
+                },
+              ],
+            },
+            {
+              signal: new AbortController().signal,
+              toolUseID: "tool-question-full-access",
+              requestId: "request-question-full-access",
+            },
+          ),
+        ).pipe(Effect.forkScoped);
+        const questionEvent = yield* Fiber.join(questionRequestEvent);
+        assert.isTrue(Option.isSome(questionEvent));
+        if (
+          Option.isNone(questionEvent) ||
+          questionEvent.value.type !== "runtime_request.updated"
+        ) {
+          return;
+        }
+        yield* runtime.respondToRuntimeRequest({
+          requestId: questionEvent.value.runtimeRequest.id,
+          answers: { [longQuestion]: ["Production", "Staging"] },
+        });
+        assert.deepEqual(yield* Fiber.join(questionResult), {
+          behavior: "allow",
+          updatedInput: {
+            questions: [
+              {
+                header: "Target",
+                question: longQuestion,
+                options: [
+                  { label: "Production", description: "Deploy to production." },
+                  { label: "Staging", description: "Deploy to staging." },
+                ],
+                multiSelect: true,
+              },
+            ],
+            answers: { [longQuestion]: "Production, Staging" },
+          },
+          toolUseID: "tool-question-full-access",
+        });
+        const longPlan = `# Deployment plan\n\n${"Validate every region before promotion.\n".repeat(120)}`;
+        const proposedPlanEvent = yield* runtime.events.pipe(
+          Stream.filter((event) => event.type === "plan.updated"),
+          Stream.runHead,
+          Effect.forkScoped,
+        );
+        const exitPlanResult = yield* Effect.promise(() =>
+          canUseTool!(
+            "ExitPlanMode",
+            { plan: longPlan },
+            {
+              signal: new AbortController().signal,
+              toolUseID: "tool-exit-plan-full-access",
+              requestId: "request-exit-plan-full-access",
+            },
+          ),
+        );
+        assert.deepEqual(exitPlanResult, {
+          behavior: "deny",
+          message:
+            "The client captured your proposed plan. Stop here and wait for the user's feedback or implementation request in a later turn.",
+          toolUseID: "tool-exit-plan-full-access",
+        });
+        const planEvent = yield* Fiber.join(proposedPlanEvent);
+        assert.isTrue(Option.isSome(planEvent));
+        if (Option.isSome(planEvent) && planEvent.value.type === "plan.updated") {
+          assert.equal(planEvent.value.plan.kind, "proposed_plan");
+          if (planEvent.value.plan.kind === "proposed_plan") {
+            assert.equal(planEvent.value.plan.markdown, longPlan.trim());
+          }
+        }
+        const requestEvent = yield* runtime.events
+          .pipe(
+            Stream.filter((event) => event.type === "runtime_request.updated"),
+            Stream.runHead,
+          )
+          .pipe(Effect.forkScoped);
+        const controller = new AbortController();
+        const dialog = yield* Effect.promise(() =>
+          callback!(
+            {
+              dialogKind: "resume_return",
+              payload: { sessionAgeMinutes: 90, estimatedTokens: 120000 },
+            },
+            { signal: controller.signal, requestId: "dialog-resume-1" },
+          ),
+        ).pipe(Effect.forkScoped);
+        const event = yield* Fiber.join(requestEvent);
+        assert.isTrue(Option.isSome(event));
+        if (Option.isNone(event) || event.value.type !== "runtime_request.updated") return;
+        const question = formatClaudeResumeCompactionQuestion({
+          ageMinutes: 90,
+          estimatedTokens: 120000,
+        });
+        yield* runtime.respondToRuntimeRequest({
+          requestId: event.value.runtimeRequest.id,
+          answers: { [question]: "Compact and continue" },
+        });
+        assert.deepEqual(yield* Fiber.join(dialog), { behavior: "completed", result: "compact" });
+
+        const cancelledController = new AbortController();
+        cancelledController.abort();
+        assert.deepEqual(
+          yield* Effect.promise(() =>
+            callback!(
+              {
+                dialogKind: "resume_return",
+                payload: { sessionAgeMinutes: 90, estimatedTokens: 120000 },
+              },
+              { signal: cancelledController.signal, requestId: "dialog-resume-2" },
+            ),
+          ),
+          { behavior: "cancelled" },
+        );
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+});
+
+describe("ClaudeAdapterV2 attachments", () => {
+  it.effect("forwards images and references generic files on sends and steering", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const fileSystem = yield* FileSystem.FileSystem;
+        const idAllocator = yield* IdAllocatorV2;
+        const path = yield* Path.Path;
+        const attachmentsDir = yield* fileSystem.makeTempDirectoryScoped({
+          prefix: "t3-claude-v2-attachments-",
+        });
+        const offeredMessages: Array<SDKUserMessage> = [];
+        const adapter = makeClaudeAdapterV2({
+          instanceId: CLAUDE_DEFAULT_INSTANCE_ID,
+          settings: DEFAULT_CLAUDE_SETTINGS,
+          environment: {},
+          attachmentsDir,
+          fileSystem,
+          idAllocator,
+          queryRunner: {
+            allocateSessionId: Effect.succeed("native-thread-claude-attachments"),
+            open: () =>
+              Effect.succeed({
+                messages: Stream.never,
+                offer: (message) =>
+                  Effect.sync(() => {
+                    offeredMessages.push(message);
+                  }),
+                setModel: () => Effect.void,
+                interrupt: Effect.void,
+                close: Effect.void,
+              }),
+            forkSession: () => Effect.die("unused forkSession"),
+            assertComplete: Effect.void,
+          },
+        });
+        const threadId = ThreadId.make("thread-claude-attachments");
+        const providerSessionId = ProviderSessionId.make("provider-session-claude-attachments");
+        const runtime = yield* adapter.openSession({
+          threadId,
+          providerSessionId,
+          modelSelection: CLAUDE_TEST_MODEL_SELECTION,
+          runtimePolicy: CLAUDE_TEST_RUNTIME_POLICY,
+        });
+        const providerThread = yield* runtime.ensureThread({
+          threadId,
+          modelSelection: CLAUDE_TEST_MODEL_SELECTION,
+          runtimePolicy: CLAUDE_TEST_RUNTIME_POLICY,
+        });
+        const attachment = ChatImageAttachment.make({
+          type: "image",
+          id: ChatAttachmentId.make(
+            "thread-claude-attachments-12345678-1234-1234-1234-123456789abc",
+          ),
+          name: "diagram.png",
+          mimeType: "image/png",
+          sizeBytes: 4,
+        });
+        const document = ChatFileAttachment.make({
+          type: "file",
+          id: ChatAttachmentId.make(
+            "thread-claude-attachments-abcdefab-1234-1234-1234-123456789abc",
+          ),
+          name: "requirements.pdf",
+          mimeType: "application/pdf",
+          sizeBytes: 4,
+        });
+        yield* fileSystem.writeFile(
+          path.join(attachmentsDir, attachmentRelativePath(attachment)!),
+          Uint8Array.from([1, 2, 3, 4]),
+        );
+        yield* fileSystem.writeFile(
+          path.join(attachmentsDir, attachmentRelativePath(document)!),
+          Uint8Array.from([5, 6, 7, 8]),
+        );
+        const attemptId = RunAttemptId.make("attempt-claude-attachments");
+        const now = yield* DateTime.now;
+
+        yield* runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId,
+            providerThread,
+            now,
+            attemptId,
+            text: "What's in this image?",
+            attachments: [attachment, document],
+          }),
+        );
+
+        const expectedImageBlock = {
+          type: "image",
+          source: {
+            type: "base64",
+            media_type: "image/png",
+            data: "AQIDBA==",
+          },
+        } as const;
+        const expectedAttachmentPath = path.join(
+          attachmentsDir,
+          attachmentRelativePath(attachment)!,
+        );
+        const expectedDocumentPath = path.join(attachmentsDir, attachmentRelativePath(document)!);
+        assert.deepEqual(offeredMessages[0]?.message.content, [
+          {
+            type: "text",
+            text: `Ultrathink:\nWhat's in this image?\n\n[Attached image "diagram.png" is saved at: ${expectedAttachmentPath}]\n[Attached file "requirements.pdf" is saved at: ${expectedDocumentPath}]`,
+          },
+          expectedImageBlock,
+        ]);
+
+        const providerTurnId = idAllocator.derive.providerTurn({
+          driver: CLAUDE_PROVIDER,
+          nativeTurnId: `turn:${attemptId}`,
+        });
+        yield* runtime.steerTurn({
+          threadId,
+          runId: RunId.make("run-claude-attachments"),
+          providerThread,
+          providerTurnId,
+          message: {
+            createdBy: "user",
+            creationSource: "web",
+            messageId: MessageId.make("message-claude-attachments-steer"),
+            text: "Focus on the diagram labels.",
+            attachments: [attachment, document],
+          },
+        });
+
+        assert.equal(offeredMessages[1]?.priority, "now");
+        assert.deepEqual(offeredMessages[1]?.message.content, [
+          {
+            type: "text",
+            text: `Ultrathink:\nFocus on the diagram labels.\n\n[Attached image "diagram.png" is saved at: ${expectedAttachmentPath}]\n[Attached file "requirements.pdf" is saved at: ${expectedDocumentPath}]`,
+          },
+          expectedImageBlock,
+        ]);
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  it.effect("rejects unsupported image types before opening a provider query", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const fileSystem = yield* FileSystem.FileSystem;
+        const idAllocator = yield* IdAllocatorV2;
+        const attachmentsDir = yield* fileSystem.makeTempDirectoryScoped({
+          prefix: "t3-claude-v2-unsupported-attachment-",
+        });
+        let openCount = 0;
+        const adapter = makeClaudeAdapterV2({
+          instanceId: CLAUDE_DEFAULT_INSTANCE_ID,
+          settings: DEFAULT_CLAUDE_SETTINGS,
+          environment: {},
+          attachmentsDir,
+          fileSystem,
+          idAllocator,
+          queryRunner: {
+            allocateSessionId: Effect.succeed("native-thread-claude-unsupported-attachment"),
+            open: () =>
+              Effect.sync(() => {
+                openCount += 1;
+                return {
+                  messages: Stream.never,
+                  offer: () => Effect.void,
+                  setModel: () => Effect.void,
+                  interrupt: Effect.void,
+                  close: Effect.void,
+                };
+              }),
+            forkSession: () => Effect.die("unused forkSession"),
+            assertComplete: Effect.void,
+          },
+        });
+        const threadId = ThreadId.make("thread-claude-unsupported-attachment");
+        const runtime = yield* adapter.openSession({
+          threadId,
+          providerSessionId: ProviderSessionId.make(
+            "provider-session-claude-unsupported-attachment",
+          ),
+          modelSelection: CLAUDE_TEST_MODEL_SELECTION,
+          runtimePolicy: CLAUDE_TEST_RUNTIME_POLICY,
+        });
+        const providerThread = yield* runtime.ensureThread({
+          threadId,
+          modelSelection: CLAUDE_TEST_MODEL_SELECTION,
+          runtimePolicy: CLAUDE_TEST_RUNTIME_POLICY,
+        });
+        const attachment = ChatImageAttachment.make({
+          type: "image",
+          id: ChatAttachmentId.make(
+            "thread-claude-unsupported-12345678-1234-1234-1234-123456789abc",
+          ),
+          name: "diagram.svg",
+          mimeType: "image/svg+xml",
+          sizeBytes: 4,
+        });
+        const now = yield* DateTime.now;
+
+        const error = yield* runtime
+          .startTurn(
+            makeClaudeTestTurnInput({
+              threadId,
+              providerThread,
+              now,
+              attemptId: RunAttemptId.make("attempt-claude-unsupported-attachment"),
+              text: "Inspect this image.",
+              attachments: [attachment],
+            }),
+          )
+          .pipe(Effect.flip);
+
+        assert.equal(error._tag, "ProviderAdapterTurnStartError");
+        assert.include(String(error.cause), "Unsupported Claude image attachment type");
+        assert.equal(openCount, 0);
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+});
+
+describe("ClaudeAdapterV2 native fork", () => {
+  it("advertises Claude Agent SDK session forks", () => {
+    assert.equal(ClaudeProviderCapabilitiesV2.threads.canForkThread, true);
+    assert.equal(ClaudeProviderCapabilitiesV2.threads.canForkFromTurn, true);
+  });
+
+  it.effect("forks at the source assistant cursor and resumes the forked session", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const fileSystem = yield* FileSystem.FileSystem;
+        const idAllocator = yield* IdAllocatorV2;
+        const attachmentsDir = yield* fileSystem.makeTempDirectoryScoped({
+          prefix: "t3-claude-v2-fork-attachments-",
+        });
+        const openedQueries: Array<ClaudeAgentSdkQueryOpenInput> = [];
+        const forkCalls: Array<{
+          readonly sessionId: string;
+          readonly options: unknown;
+          readonly threadId: ThreadId;
+          readonly providerSessionId: ProviderSessionId;
+        }> = [];
+        const adapter = makeClaudeAdapterV2({
+          instanceId: CLAUDE_DEFAULT_INSTANCE_ID,
+          settings: DEFAULT_CLAUDE_SETTINGS,
+          environment: {},
+          attachmentsDir,
+          fileSystem,
+          idAllocator,
+          queryRunner: {
+            allocateSessionId: Effect.succeed("source-native-session"),
+            open: (input) =>
+              Effect.sync(() => {
+                openedQueries.push(input);
+                return {
+                  messages: Stream.empty,
+                  offer: () => Effect.void,
+                  setModel: () => Effect.void,
+                  interrupt: Effect.void,
+                  close: Effect.void,
+                };
+              }),
+            forkSession: (input) =>
+              Effect.sync(() => {
+                forkCalls.push(input);
+                return { sessionId: "forked-native-session" };
+              }),
+            assertComplete: Effect.void,
+          },
+        });
+        const providerSessionId = ProviderSessionId.make("provider-session-claude-fork");
+        const sourceThreadId = ThreadId.make("thread-claude-fork-source");
+        const targetThreadId = ThreadId.make("thread-claude-fork-target");
+        const runtime = yield* adapter.openSession({
+          threadId: sourceThreadId,
+          providerSessionId,
+          modelSelection: {
+            instanceId: ProviderInstanceId.make(CLAUDE_PROVIDER),
+            model: "claude-sonnet-4-6",
+          },
+          runtimePolicy: ProviderAdapterV2RuntimePolicy.make({
+            runtimeMode: "full-access",
+            interactionMode: "default",
+            cwd: "/workspace",
+          }),
+        });
+        const sourceProviderThread = yield* runtime.ensureThread({
+          threadId: sourceThreadId,
+          modelSelection: {
+            instanceId: ProviderInstanceId.make(CLAUDE_PROVIDER),
+            model: "claude-sonnet-4-6",
+          },
+          runtimePolicy: ProviderAdapterV2RuntimePolicy.make({
+            runtimeMode: "full-access",
+            interactionMode: "default",
+            cwd: "/workspace",
+          }),
+        });
+        const now = yield* DateTime.now;
+        const providerTurnId = ProviderTurnId.make("provider-turn-claude-source");
+        const forkedProviderThread = yield* runtime.forkThread({
+          sourceProviderThread,
+          sourceProviderTurns: [
+            {
+              id: providerTurnId,
+              providerThreadId: sourceProviderThread.id,
+              nodeId: NodeId.make("node-claude-source"),
+              runAttemptId: RunAttemptId.make("run-attempt-claude-source"),
+              nativeTurnRef: {
+                driver: CLAUDE_PROVIDER,
+                nativeId: "assistant-message-cursor",
+                strength: "weak",
+              },
+              ordinal: 1,
+              status: "completed",
+              startedAt: now,
+              completedAt: now,
+            },
+          ],
+          providerTurnId,
+          targetThreadId,
+        });
+
+        assert.deepEqual(forkCalls, [
+          {
+            sessionId: "source-native-session",
+            options: {
+              dir: "/workspace",
+              upToMessageId: "assistant-message-cursor",
+            },
+            threadId: targetThreadId,
+            providerSessionId,
+          },
+        ]);
+        assert.equal(forkedProviderThread.nativeThreadRef?.nativeId, "forked-native-session");
+        assert.equal(forkedProviderThread.forkedFrom?.providerThreadId, sourceProviderThread.id);
+        assert.equal(forkedProviderThread.forkedFrom?.providerTurnId, providerTurnId);
+
+        yield* runtime.startTurn({
+          appThread: {
+            createdBy: "user",
+            creationSource: "web",
+            id: targetThreadId,
+            projectId: ProjectId.make("project-claude-fork-target"),
+            title: "Claude fork target",
+            providerInstanceId: ProviderInstanceId.make(CLAUDE_PROVIDER),
+            modelSelection: {
+              instanceId: ProviderInstanceId.make(CLAUDE_PROVIDER),
+              model: "claude-sonnet-4-6",
+            },
+            runtimeMode: "full-access",
+            interactionMode: "default",
+            branch: null,
+            worktreePath: null,
+            activeProviderThreadId: forkedProviderThread.id,
+            lineage: {
+              parentThreadId: sourceThreadId,
+              relationshipToParent: "fork",
+              rootThreadId: sourceThreadId,
+            },
+            forkedFrom: null,
+            createdAt: now,
+            updatedAt: now,
+            archivedAt: null,
+            settledOverride: null,
+            settledAt: null,
+            lastVisitedAt: null,
+            deletedAt: null,
+          },
+          threadId: targetThreadId,
+          runId: RunId.make("run-claude-fork-target"),
+          runOrdinal: 1,
+          providerTurnOrdinal: 1,
+          attemptId: RunAttemptId.make("run-attempt-claude-fork-target"),
+          rootNodeId: NodeId.make("node-claude-fork-target-root"),
+          providerThread: forkedProviderThread,
+          message: {
+            createdBy: "user",
+            creationSource: "web",
+            messageId: MessageId.make("message-claude-fork-target"),
+            text: "Respond with fork ok",
+            attachments: [],
+          },
+          modelSelection: {
+            instanceId: ProviderInstanceId.make(CLAUDE_PROVIDER),
+            model: "claude-sonnet-4-6",
+          },
+          runtimePolicy: ProviderAdapterV2RuntimePolicy.make({
+            runtimeMode: "full-access",
+            interactionMode: "default",
+            cwd: "/workspace",
+          }),
+        });
+
+        assert.equal(openedQueries[0]?.options.resume, "forked-native-session");
+        assert.equal(openedQueries[0]?.options.sessionId, undefined);
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+});
+
+describe("ClaudeAdapterV2 native session identity", () => {
+  const openTurnWithOrdinal = (providerTurnOrdinal: number) =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const fileSystem = yield* FileSystem.FileSystem;
+        const idAllocator = yield* IdAllocatorV2;
+        const attachmentsDir = yield* fileSystem.makeTempDirectoryScoped({
+          prefix: "t3-claude-v2-session-identity-",
+        });
+        const openedQueries: Array<ClaudeAgentSdkQueryOpenInput> = [];
+        const adapter = makeClaudeAdapterV2({
+          instanceId: CLAUDE_DEFAULT_INSTANCE_ID,
+          settings: DEFAULT_CLAUDE_SETTINGS,
+          environment: {},
+          attachmentsDir,
+          fileSystem,
+          idAllocator,
+          queryRunner: {
+            allocateSessionId: Effect.succeed("native-session-identity"),
+            open: (input) =>
+              Effect.sync(() => {
+                openedQueries.push(input);
+                return {
+                  messages: Stream.empty,
+                  offer: () => Effect.void,
+                  setModel: () => Effect.void,
+                  interrupt: Effect.void,
+                  close: Effect.void,
+                };
+              }),
+            forkSession: () => Effect.die("unused forkSession"),
+            assertComplete: Effect.void,
+          },
+        });
+        const threadId = ThreadId.make("thread-claude-session-identity");
+        const providerSessionId = ProviderSessionId.make("provider-session-claude-identity");
+        const runtime = yield* adapter.openSession({
+          threadId,
+          providerSessionId,
+          modelSelection: CLAUDE_TEST_MODEL_SELECTION,
+          runtimePolicy: CLAUDE_TEST_RUNTIME_POLICY,
+        });
+        const providerThread = yield* runtime.ensureThread({
+          threadId,
+          modelSelection: CLAUDE_TEST_MODEL_SELECTION,
+          runtimePolicy: CLAUDE_TEST_RUNTIME_POLICY,
+        });
+        const now = yield* DateTime.now;
+        yield* runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId,
+            providerThread,
+            now,
+            attemptId: RunAttemptId.make("run-attempt-claude-session-identity"),
+            text: "Respond with identity ok",
+            attachments: [],
+            providerTurnOrdinal,
+          }),
+        );
+        return openedQueries;
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    );
+
+  it.effect("creates the native session on the first provider turn", () =>
+    Effect.gen(function* () {
+      const openedQueries = yield* openTurnWithOrdinal(1);
+      assert.equal(openedQueries.length, 1);
+      assert.equal(openedQueries[0]?.options.sessionId, "native-session-identity");
+      assert.equal(openedQueries[0]?.options.resume, undefined);
+    }),
+  );
+
+  it.effect(
+    "resumes the native session on a fresh session instance when prior provider turns exist",
+    () =>
+      Effect.gen(function* () {
+        const openedQueries = yield* openTurnWithOrdinal(2);
+        assert.equal(openedQueries.length, 1);
+        assert.equal(openedQueries[0]?.options.resume, "native-session-identity");
+        assert.equal(openedQueries[0]?.options.sessionId, undefined);
+      }),
+  );
+});
+
+describe("ClaudeAdapterV2 background wake turns", () => {
+  const WAKE_NATIVE_SESSION = "native-thread-claude-wake";
+  const WAKE_TASK_ID = "task-wake-build";
+  const WAKE_SUMMARY = "Background build completed successfully";
+  const WAKE_ASSISTANT_TEXT = "The background build has finished.";
+  const WAKE_RESULT_TEXT = "The background build finished; everything passed.";
+
+  function claudeSdkFrame(frame: unknown): SDKMessage {
+    if (
+      typeof frame !== "object" ||
+      frame === null ||
+      typeof Reflect.get(frame, "type") !== "string"
+    ) {
+      throw new Error("Frame is not a Claude Agent SDK message.");
+    }
+    return frame as SDKMessage;
+  }
+
+  const wakeTaskStarted = claudeSdkFrame({
+    type: "system",
+    subtype: "task_started",
+    task_id: WAKE_TASK_ID,
+    description: "npm run build",
+    task_type: "local_bash",
+    uuid: "00000000-0000-4000-8000-000000000101",
+    session_id: WAKE_NATIVE_SESSION,
+  });
+  const makeAssistantTextFrame = (input: { readonly uuid: string; readonly text: string }) =>
+    claudeSdkFrame({
+      type: "assistant",
+      message: {
+        model: "claude-sonnet-4-6",
+        id: `msg_${input.uuid}`,
+        type: "message",
+        role: "assistant",
+        content: [{ type: "text", text: input.text }],
+        stop_reason: null,
+        stop_sequence: null,
+        usage: {
+          input_tokens: 1,
+          output_tokens: 1,
+          cache_creation_input_tokens: 0,
+          cache_read_input_tokens: 0,
+        },
+      },
+      parent_tool_use_id: null,
+      uuid: input.uuid,
+      session_id: WAKE_NATIVE_SESSION,
+    });
+  const makeResultFrame = (input: {
+    readonly uuid: string;
+    readonly result: string;
+    readonly numTurns?: number;
+    readonly origin?: { readonly kind: "task-notification" };
+    readonly subtype?: string;
+    readonly isError?: boolean;
+    readonly errors?: ReadonlyArray<string>;
+    readonly apiErrorStatus?: number;
+  }) =>
+    claudeSdkFrame({
+      type: "result",
+      subtype: input.subtype ?? "success",
+      duration_ms: 10,
+      duration_api_ms: 10,
+      is_error: input.isError ?? false,
+      num_turns: input.numTurns ?? 1,
+      result: input.result,
+      stop_reason: "end_turn",
+      total_cost_usd: 0,
+      usage: {
+        input_tokens: 1,
+        output_tokens: 1,
+        cache_creation_input_tokens: 0,
+        cache_read_input_tokens: 0,
+      },
+      modelUsage: {},
+      permission_denials: [],
+      uuid: input.uuid,
+      session_id: WAKE_NATIVE_SESSION,
+      ...(input.origin === undefined ? {} : { origin: input.origin }),
+      ...(input.errors === undefined ? {} : { errors: input.errors }),
+      ...(input.apiErrorStatus === undefined ? {} : { api_error_status: input.apiErrorStatus }),
+    });
+  const turnOneResult = makeResultFrame({
+    uuid: "00000000-0000-4000-8000-000000000102",
+    result: "Kicked off the build in the background.",
+  });
+  const wakeNotification = claudeSdkFrame({
+    type: "system",
+    subtype: "task_notification",
+    task_id: WAKE_TASK_ID,
+    status: "completed",
+    output_file: "/tmp/task-wake-build.log",
+    summary: WAKE_SUMMARY,
+    uuid: "00000000-0000-4000-8000-000000000103",
+    session_id: WAKE_NATIVE_SESSION,
+  });
+  const wakeAssistant = claudeSdkFrame({
+    type: "assistant",
+    message: {
+      role: "assistant",
+      content: [{ type: "text", text: WAKE_ASSISTANT_TEXT }],
+    },
+    parent_tool_use_id: null,
+    uuid: "00000000-0000-4000-8000-000000000107",
+    session_id: WAKE_NATIVE_SESSION,
+  });
+  const wakeResult = makeResultFrame({
+    uuid: "00000000-0000-4000-8000-000000000104",
+    result: WAKE_RESULT_TEXT,
+    origin: { kind: "task-notification" },
+  });
+  const STALE_TASK_NOTIFICATION_RESULT_TEXT =
+    "Stale task-notification origin text that must not appear.";
+  const staleTaskNotificationResult = makeResultFrame({
+    uuid: "00000000-0000-4000-8000-000000000106",
+    result: STALE_TASK_NOTIFICATION_RESULT_TEXT,
+    numTurns: 0,
+    origin: { kind: "task-notification" },
+  });
+
+  const awaitUntil = (predicate: () => boolean, label: string): Effect.Effect<void> =>
+    Effect.gen(function* () {
+      for (let attempt = 0; attempt < 5000; attempt++) {
+        if (predicate()) {
+          return;
+        }
+        yield* Effect.yieldNow;
+      }
+      return yield* Effect.die(`Timed out waiting for ${label}.`);
+    });
+
+  const makeWakeHarnessWithOptions = (options?: {
+    readonly close?: (sdkMessages: Queue.Queue<SDKMessage>) => Effect.Effect<void>;
+    readonly interrupt?: Effect.Effect<void>;
+  }) =>
+    Effect.gen(function* () {
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const attachmentsDir = yield* fileSystem.makeTempDirectoryScoped({
+        prefix: "t3-claude-v2-wake-",
+      });
+      const sdkMessages = yield* Queue.unbounded<SDKMessage>();
+      const offeredMessages: Array<SDKUserMessage> = [];
+      const continuationRequests: Array<ProviderContinuationRequest> = [];
+      const terminalReceipts =
+        yield* Queue.unbounded<Extract<ProviderAdapterV2Event, { type: "turn.terminal" }>>();
+      let openedOptions: ClaudeAgentSdkQueryOptions | undefined;
+      const adapter = makeClaudeAdapterV2({
+        instanceId: CLAUDE_DEFAULT_INSTANCE_ID,
+        settings: DEFAULT_CLAUDE_SETTINGS,
+        environment: {},
+        attachmentsDir,
+        fileSystem,
+        idAllocator,
+        continuationRequests: {
+          offer: (request) =>
+            Effect.sync(() => {
+              continuationRequests.push(request);
+            }),
+        },
+        queryRunner: {
+          allocateSessionId: Effect.succeed(WAKE_NATIVE_SESSION),
+          open: (input) =>
+            Effect.sync(() => {
+              openedOptions = input.options;
+              return {
+                messages: Stream.fromQueue(sdkMessages),
+                offer: (message) =>
+                  Effect.sync(() => {
+                    offeredMessages.push(message);
+                  }),
+                setModel: () => Effect.void,
+                interrupt: options?.interrupt ?? Effect.void,
+                close: options?.close?.(sdkMessages) ?? Effect.void,
+              };
+            }),
+          forkSession: () => Effect.die("unused forkSession"),
+          assertComplete: Effect.void,
+        },
+      });
+      const threadId = ThreadId.make("thread-claude-wake");
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make("provider-session-claude-wake"),
+        modelSelection: CLAUDE_TEST_MODEL_SELECTION,
+        runtimePolicy: CLAUDE_TEST_RUNTIME_POLICY,
+      });
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection: CLAUDE_TEST_MODEL_SELECTION,
+        runtimePolicy: CLAUDE_TEST_RUNTIME_POLICY,
+      });
+      const events: Array<ProviderAdapterV2Event> = [];
+      yield* runtime.events.pipe(
+        Stream.runForEach((event) =>
+          Effect.gen(function* () {
+            events.push(event);
+            if (event.type === "turn.terminal") {
+              yield* Queue.offer(terminalReceipts, event);
+            }
+          }),
+        ),
+        Effect.forkScoped,
+      );
+      if (runtime.hasPendingBackgroundWork === undefined) {
+        throw new Error("Claude adapter runtime must expose hasPendingBackgroundWork.");
+      }
+      const hasPendingBackgroundWork = runtime.hasPendingBackgroundWork;
+      const terminalEvents = () =>
+        events.filter(
+          (event): event is Extract<ProviderAdapterV2Event, { type: "turn.terminal" }> =>
+            event.type === "turn.terminal",
+        );
+      return {
+        runtime,
+        providerThread,
+        threadId,
+        sdkMessages,
+        offeredMessages,
+        continuationRequests,
+        events,
+        terminalReceipts,
+        getOpenedOptions: () => openedOptions,
+        terminalEvents,
+        hasPendingBackgroundWork,
+      };
+    });
+  const makeWakeHarness = makeWakeHarnessWithOptions();
+
+  it.effect("preserves typed Claude plans and todos through generic tool completion", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const harness = yield* makeWakeHarness;
+        const now = yield* DateTime.now;
+        const assistantTools = (
+          uuid: string,
+          tools: ReadonlyArray<Record<string, unknown>>,
+          parentToolUseId: string | null = null,
+        ) =>
+          claudeSdkFrame({
+            type: "assistant",
+            message: {
+              model: "claude-sonnet-4-6",
+              id: `msg_${uuid}`,
+              type: "message",
+              role: "assistant",
+              content: tools.map((tool) => ({ type: "tool_use", ...tool })),
+              stop_reason: "tool_use",
+              stop_sequence: null,
+              usage: {
+                input_tokens: 1,
+                output_tokens: 1,
+                cache_creation_input_tokens: 0,
+                cache_read_input_tokens: 0,
+              },
+            },
+            parent_tool_use_id: parentToolUseId,
+            uuid,
+            session_id: WAKE_NATIVE_SESSION,
+          });
+        const toolResults = (uuid: string, toolUseIds: ReadonlyArray<string>) =>
+          claudeSdkFrame({
+            type: "user",
+            message: {
+              role: "user",
+              content: toolUseIds.map((toolUseId) => ({
+                type: "tool_result",
+                tool_use_id: toolUseId,
+                content: "ok",
+              })),
+            },
+            parent_tool_use_id: null,
+            uuid,
+            session_id: WAKE_NATIVE_SESSION,
+          });
+
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-plan-lifecycle-1"),
+            text: "Plan the work.",
+            attachments: [],
+          }),
+        );
+        yield* Queue.offer(
+          harness.sdkMessages,
+          assistantTools("00000000-0000-4000-8000-000000000501", [
+            {
+              id: "tool-todo-1",
+              name: "TodoWrite",
+              input: { todos: [{ content: "Inspect", status: "in_progress" }] },
+            },
+          ]),
+        );
+        yield* Queue.offer(
+          harness.sdkMessages,
+          assistantTools("00000000-0000-4000-8000-000000000501", [
+            {
+              id: "tool-todo-1",
+              name: "TodoWrite",
+              input: { todos: [{ content: "Inspect", status: "in_progress" }] },
+            },
+          ]),
+        );
+        yield* Queue.offer(
+          harness.sdkMessages,
+          toolResults("00000000-0000-4000-8000-000000000502", ["tool-todo-1"]),
+        );
+        yield* Queue.offer(
+          harness.sdkMessages,
+          makeResultFrame({
+            uuid: "00000000-0000-4000-8000-000000000503",
+            result: "Todo recorded.",
+          }),
+        );
+        yield* Queue.take(harness.terminalReceipts);
+
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-plan-lifecycle-2"),
+            providerTurnOrdinal: 2,
+            text: "Finish the plan.",
+            attachments: [],
+          }),
+        );
+        const canUseTool = harness.getOpenedOptions()?.canUseTool;
+        assert.isFunction(canUseTool);
+        const planMarkdown = "# Ready to implement\n\n1. Ship it.";
+        yield* Effect.promise(() =>
+          canUseTool!(
+            "ExitPlanMode",
+            { plan: planMarkdown },
+            {
+              signal: new AbortController().signal,
+              toolUseID: "tool-exit-plan-1",
+              requestId: "request-exit-plan-1",
+            },
+          ),
+        );
+        yield* Queue.offer(
+          harness.sdkMessages,
+          assistantTools("00000000-0000-4000-8000-000000000504", [
+            {
+              id: "tool-todo-2",
+              name: "TodoWrite",
+              input: { todos: [{ content: "Inspect", status: "completed" }] },
+            },
+            { id: "tool-exit-plan-1", name: "ExitPlanMode", input: { plan: planMarkdown } },
+          ]),
+        );
+        yield* Queue.offer(
+          harness.sdkMessages,
+          assistantTools(
+            "00000000-0000-4000-8000-000000000507",
+            [
+              {
+                id: "tool-subagent-todo",
+                name: "TodoWrite",
+                input: { todos: [{ content: "Child-only work", status: "in_progress" }] },
+              },
+            ],
+            "tool-parent-agent",
+          ),
+        );
+        yield* Queue.offer(
+          harness.sdkMessages,
+          toolResults("00000000-0000-4000-8000-000000000505", ["tool-todo-2", "tool-exit-plan-1"]),
+        );
+        yield* Queue.offer(
+          harness.sdkMessages,
+          makeResultFrame({
+            uuid: "00000000-0000-4000-8000-000000000506",
+            result: "Plan captured.",
+          }),
+        );
+        yield* Queue.take(harness.terminalReceipts);
+
+        const items = new Map(
+          harness.events.flatMap((event) =>
+            event.type === "turn_item.updated" ? [[String(event.turnItem.id), event.turnItem]] : [],
+          ),
+        );
+        const plans = new Map(
+          harness.events.flatMap((event) =>
+            event.type === "plan.updated" ? [[String(event.plan.id), event.plan]] : [],
+          ),
+        );
+        const todoItems = [...items.values()].filter((item) => item.type === "todo_list");
+        const proposedItems = [...items.values()].filter((item) => item.type === "proposed_plan");
+        assert.lengthOf(todoItems, 2);
+        assert.lengthOf(proposedItems, 1);
+        assert.equal(
+          proposedItems[0]?.type === "proposed_plan" && proposedItems[0].markdown,
+          planMarkdown,
+        );
+        assert.isTrue(
+          [...items.values()].some(
+            (item) =>
+              item.type === "dynamic_tool" && item.nativeItemRef?.nativeId === "tool-todo-2",
+          ),
+        );
+        assert.isTrue(
+          [...items.values()].some(
+            (item) =>
+              item.type === "dynamic_tool" && item.nativeItemRef?.nativeId === "tool-exit-plan-1",
+          ),
+        );
+        assert.deepEqual(
+          [...plans.values()]
+            .filter((plan) => plan.kind === "todo_list")
+            .map((plan) => plan.status),
+          ["superseded", "completed"],
+        );
+        const proposedPlan = [...plans.values()].find((plan) => plan.kind === "proposed_plan");
+        assert.equal(proposedPlan?.status, "active");
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  it.effect("resolves API retries on resumed assistant activity", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const harness = yield* makeWakeHarness;
+        const now = yield* DateTime.now;
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-api-retry"),
+            text: "Open github.com.",
+            attachments: [],
+          }),
+        );
+
+        yield* Queue.offer(
+          harness.sdkMessages,
+          claudeSdkFrame({
+            type: "system",
+            subtype: "api_retry",
+            attempt: 2,
+            max_retries: 10,
+            retry_delay_ms: 1_500,
+            error_status: 529,
+            error: "overloaded",
+            uuid: "00000000-0000-4000-8000-000000000201",
+            session_id: WAKE_NATIVE_SESSION,
+          }),
+        );
+        const retryItems = () =>
+          harness.events.flatMap((event) =>
+            event.type === "turn_item.updated" &&
+            event.turnItem.type === "error" &&
+            event.turnItem.retry !== undefined
+              ? [event.turnItem]
+              : [],
+          );
+        yield* awaitUntil(() => retryItems().length === 1, "Claude retry item");
+        const runningRetry = retryItems()[0];
+        assert.equal(runningRetry?.status, "running");
+        assert.equal(runningRetry?.failure.code, "api_error_529");
+        assert.deepEqual(runningRetry?.retry, {
+          attempt: 2,
+          maxAttempts: 10,
+          retryDelayMs: 1_500,
+        });
+
+        yield* Queue.offer(
+          harness.sdkMessages,
+          makeAssistantTextFrame({
+            uuid: "00000000-0000-4000-8000-000000000202",
+            text: "Opening GitHub.",
+          }),
+        );
+        yield* awaitUntil(() => retryItems().length === 2, "resolved Claude retry item");
+        assert.lengthOf(harness.terminalEvents(), 0);
+        const recoveredRetry = retryItems()[1];
+        assert.equal(recoveredRetry?.id, runningRetry?.id);
+        assert.equal(recoveredRetry?.status, "completed");
+        assert.equal(recoveredRetry?.title, "Provider recovered");
+
+        yield* Queue.offer(
+          harness.sdkMessages,
+          makeResultFrame({
+            uuid: "00000000-0000-4000-8000-000000000203",
+            result: "Opened GitHub.",
+          }),
+        );
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "recovered Claude turn");
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  it.effect("carries exhausted retry progress into the terminal provider error", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const harness = yield* makeWakeHarness;
+        const now = yield* DateTime.now;
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-api-retry-exhausted"),
+            text: "Open github.com.",
+            attachments: [],
+          }),
+        );
+        yield* Queue.offer(
+          harness.sdkMessages,
+          claudeSdkFrame({
+            type: "system",
+            subtype: "api_retry",
+            attempt: 10,
+            max_retries: 10,
+            retry_delay_ms: 38_010,
+            error_status: 529,
+            error: "overloaded",
+            uuid: "00000000-0000-4000-8000-000000000203",
+            session_id: WAKE_NATIVE_SESSION,
+          }),
+        );
+        yield* Queue.offer(
+          harness.sdkMessages,
+          makeResultFrame({
+            uuid: "00000000-0000-4000-8000-000000000204",
+            result: "Claude is temporarily overloaded.",
+            isError: true,
+            apiErrorStatus: 529,
+          }),
+        );
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "failed Claude turn");
+
+        const terminal = harness.terminalEvents()[0];
+        assert.equal(terminal?.status, "failed");
+        if (terminal?.status !== "failed") return;
+        assert.deepEqual(terminal.retry, {
+          attempt: 10,
+          maxAttempts: 10,
+          retryDelayMs: 38_010,
+        });
+        assert.isDefined(terminal.retryStartedAt);
+        assert.equal(terminal.failure.code, "api_error_529");
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  const providerThreadRosterEvents = (events: ReadonlyArray<ProviderAdapterV2Event>) =>
+    events.filter(
+      (event): event is Extract<ProviderAdapterV2Event, { type: "provider_thread.updated" }> =>
+        event.type === "provider_thread.updated",
+    );
+
+  it.effect(
+    "projects an authoritative background_tasks_changed roster on the provider thread",
+    () =>
+      Effect.scoped(
+        Effect.gen(function* () {
+          const harness = yield* makeWakeHarness;
+          const now = yield* DateTime.now;
+          const rosterSnapshot = claudeSdkFrame({
+            type: "system",
+            subtype: "background_tasks_changed",
+            tasks: [
+              {
+                task_id: WAKE_TASK_ID,
+                description: "npm run build",
+                task_type: "local_bash",
+              },
+            ],
+            uuid: "00000000-0000-4000-8000-000000000201",
+            session_id: WAKE_NATIVE_SESSION,
+          });
+
+          yield* harness.runtime.startTurn(
+            makeClaudeTestTurnInput({
+              threadId: harness.threadId,
+              providerThread: harness.providerThread,
+              now,
+              attemptId: RunAttemptId.make("attempt-claude-roster-snapshot"),
+              text: "Run the build in the background.",
+              attachments: [],
+            }),
+          );
+          yield* Queue.offer(harness.sdkMessages, rosterSnapshot);
+          yield* Queue.offer(harness.sdkMessages, turnOneResult);
+          yield* awaitUntil(() => harness.terminalEvents().length === 1, "first turn terminal");
+
+          const rosterEvents = providerThreadRosterEvents(harness.events).filter(
+            (event) => (event.providerThread.pendingBackgroundTasks?.length ?? 0) > 0,
+          );
+          assert.isAtLeast(rosterEvents.length, 1);
+          assert.deepEqual(rosterEvents.at(-1)?.providerThread.pendingBackgroundTasks ?? [], [
+            {
+              taskId: WAKE_TASK_ID,
+              description: "npm run build",
+              taskType: "local_bash",
+            },
+          ]);
+          assert.isTrue(yield* harness.hasPendingBackgroundWork);
+        }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+      ),
+  );
+
+  it.effect(
+    "uses task_started as an incremental roster fallback and clears on empty snapshot",
+    () =>
+      Effect.scoped(
+        Effect.gen(function* () {
+          const harness = yield* makeWakeHarness;
+          const now = yield* DateTime.now;
+          const emptyRoster = claudeSdkFrame({
+            type: "system",
+            subtype: "background_tasks_changed",
+            tasks: [],
+            uuid: "00000000-0000-4000-8000-000000000202",
+            session_id: WAKE_NATIVE_SESSION,
+          });
+
+          yield* harness.runtime.startTurn(
+            makeClaudeTestTurnInput({
+              threadId: harness.threadId,
+              providerThread: harness.providerThread,
+              now,
+              attemptId: RunAttemptId.make("attempt-claude-roster-fallback"),
+              text: "Run the build in the background.",
+              attachments: [],
+            }),
+          );
+          yield* Queue.offer(harness.sdkMessages, wakeTaskStarted);
+          yield* Queue.offer(harness.sdkMessages, turnOneResult);
+          yield* awaitUntil(() => harness.terminalEvents().length === 1, "first turn terminal");
+
+          const afterStart = providerThreadRosterEvents(harness.events).filter(
+            (event) => (event.providerThread.pendingBackgroundTasks?.length ?? 0) > 0,
+          );
+          assert.isAtLeast(afterStart.length, 1);
+          assert.equal(
+            (afterStart.at(-1)?.providerThread.pendingBackgroundTasks ?? [])[0]?.taskId,
+            WAKE_TASK_ID,
+          );
+
+          yield* Queue.offer(harness.sdkMessages, emptyRoster);
+          yield* awaitUntil(
+            () =>
+              providerThreadRosterEvents(harness.events).some(
+                (event) =>
+                  event.providerThread.status === "idle" &&
+                  (event.providerThread.pendingBackgroundTasks?.length ?? 0) === 0,
+              ),
+            "empty roster clear",
+          );
+          assert.isFalse(yield* harness.hasPendingBackgroundWork);
+        }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+      ),
+  );
+
+  it.effect("clears the roster when a turn fails", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const harness = yield* makeWakeHarness;
+        const now = yield* DateTime.now;
+        const failedResult = claudeSdkFrame({
+          type: "result",
+          subtype: "error_during_execution",
+          duration_ms: 10,
+          duration_api_ms: 10,
+          is_error: true,
+          num_turns: 1,
+          result: "boom",
+          stop_reason: "end_turn",
+          total_cost_usd: 0,
+          usage: {
+            input_tokens: 1,
+            output_tokens: 1,
+            cache_creation_input_tokens: 0,
+            cache_read_input_tokens: 0,
+          },
+          modelUsage: {},
+          permission_denials: [],
+          errors: ["boom"],
+          uuid: "00000000-0000-4000-8000-000000000203",
+          session_id: WAKE_NATIVE_SESSION,
+        });
+
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-roster-fail"),
+            text: "Run the build in the background.",
+            attachments: [],
+          }),
+        );
+        yield* Queue.offer(harness.sdkMessages, wakeTaskStarted);
+        yield* awaitUntil(
+          () =>
+            providerThreadRosterEvents(harness.events).some(
+              (event) => (event.providerThread.pendingBackgroundTasks?.length ?? 0) > 0,
+            ),
+          "roster after task_started",
+        );
+        yield* Queue.offer(harness.sdkMessages, failedResult);
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "failed terminal");
+        assert.equal(harness.terminalEvents()[0]?.status, "failed");
+
+        const afterFailure = providerThreadRosterEvents(harness.events).at(-1);
+        assert.deepEqual(afterFailure?.providerThread.pendingBackgroundTasks ?? [], []);
+        assert.isFalse(yield* harness.hasPendingBackgroundWork);
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  it.effect("clears the native-thread roster when a turn is interrupted", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const fileSystem = yield* FileSystem.FileSystem;
+        const idAllocator = yield* IdAllocatorV2;
+        const attachmentsDir = yield* fileSystem.makeTempDirectoryScoped({
+          prefix: "t3-claude-v2-roster-interrupt-",
+        });
+        const sdkMessages = yield* Queue.unbounded<SDKMessage>();
+        const events: Array<ProviderAdapterV2Event> = [];
+        const adapter = makeClaudeAdapterV2({
+          instanceId: CLAUDE_DEFAULT_INSTANCE_ID,
+          settings: DEFAULT_CLAUDE_SETTINGS,
+          environment: {},
+          attachmentsDir,
+          fileSystem,
+          idAllocator,
+          continuationRequests: { offer: () => Effect.void },
+          queryRunner: {
+            allocateSessionId: Effect.succeed(WAKE_NATIVE_SESSION),
+            open: () =>
+              Effect.succeed({
+                messages: Stream.fromQueue(sdkMessages),
+                offer: () => Effect.void,
+                setModel: () => Effect.void,
+                interrupt: Effect.void,
+                // End the message stream so interruptTurn's closed wait resolves
+                // via stream exit finalize (interrupted status clears roster).
+                close: Queue.shutdown(sdkMessages),
+              }),
+            forkSession: () => Effect.die("unused forkSession"),
+            assertComplete: Effect.void,
+          },
+        });
+        const threadId = ThreadId.make("thread-claude-roster-interrupt");
+        const runtime = yield* adapter.openSession({
+          threadId,
+          providerSessionId: ProviderSessionId.make("provider-session-claude-roster-interrupt"),
+          modelSelection: CLAUDE_TEST_MODEL_SELECTION,
+          runtimePolicy: CLAUDE_TEST_RUNTIME_POLICY,
+        });
+        const providerThread = yield* runtime.ensureThread({
+          threadId,
+          modelSelection: CLAUDE_TEST_MODEL_SELECTION,
+          runtimePolicy: CLAUDE_TEST_RUNTIME_POLICY,
+        });
+        yield* runtime.events.pipe(
+          Stream.runForEach((event) =>
+            Effect.sync(() => {
+              events.push(event);
+            }),
+          ),
+          Effect.forkScoped,
+        );
+        if (runtime.hasPendingBackgroundWork === undefined) {
+          return yield* Effect.die("Claude adapter runtime must expose hasPendingBackgroundWork.");
+        }
+        const now = yield* DateTime.now;
+
+        yield* runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId,
+            providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-roster-interrupt"),
+            text: "Run the build in the background.",
+            attachments: [],
+          }),
+        );
+        yield* Queue.offer(sdkMessages, wakeTaskStarted);
+        yield* awaitUntil(
+          () =>
+            providerThreadRosterEvents(events).some(
+              (event) => (event.providerThread.pendingBackgroundTasks?.length ?? 0) > 0,
+            ),
+          "roster after task_started",
+        );
+
+        const providerTurnId = events.find(
+          (event): event is Extract<ProviderAdapterV2Event, { type: "provider_turn.updated" }> =>
+            event.type === "provider_turn.updated",
+        )?.providerTurn.id;
+        assert.isDefined(providerTurnId);
+        yield* runtime.interruptTurn({
+          providerThread,
+          providerTurnId: providerTurnId!,
+        });
+        yield* awaitUntil(
+          () =>
+            events.some(
+              (event) => event.type === "turn.terminal" && event.status === "interrupted",
+            ),
+          "interrupted terminal",
+        );
+
+        const afterInterrupt = providerThreadRosterEvents(events).at(-1);
+        assert.deepEqual(afterInterrupt?.providerThread.pendingBackgroundTasks ?? [], []);
+        assert.isFalse(yield* runtime.hasPendingBackgroundWork);
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  it.effect(
+    "clears the replaced sibling native thread roster when openQuery switches processes",
+    () =>
+      Effect.scoped(
+        Effect.gen(function* () {
+          const fileSystem = yield* FileSystem.FileSystem;
+          const idAllocator = yield* IdAllocatorV2;
+          const attachmentsDir = yield* fileSystem.makeTempDirectoryScoped({
+            prefix: "t3-claude-v2-sibling-replace-",
+          });
+          const nativeIds = ["native-thread-roster-a", "native-thread-roster-b"] as const;
+          let allocateIndex = 0;
+          // Real two-process model: each openQuery owns its own message queue.
+          // A shared queue would mask sibling process death on replacement.
+          const processQueues: Array<{
+            readonly nativeThreadId: string;
+            readonly queue: Queue.Queue<SDKMessage>;
+          }> = [];
+          const events: Array<ProviderAdapterV2Event> = [];
+          const adapter = makeClaudeAdapterV2({
+            instanceId: CLAUDE_DEFAULT_INSTANCE_ID,
+            settings: DEFAULT_CLAUDE_SETTINGS,
+            environment: {},
+            attachmentsDir,
+            fileSystem,
+            idAllocator,
+            continuationRequests: {
+              offer: () => Effect.void,
+            },
+            queryRunner: {
+              allocateSessionId: Effect.sync(() => {
+                const next =
+                  nativeIds[allocateIndex] ?? `native-thread-roster-extra-${allocateIndex}`;
+                allocateIndex += 1;
+                return next;
+              }),
+              open: (openInput) =>
+                Effect.gen(function* () {
+                  const nativeThreadId = openInput.options.sessionId ?? openInput.options.resume;
+                  if (typeof nativeThreadId !== "string" || nativeThreadId.length === 0) {
+                    return yield* Effect.die("openQuery must supply a native session id");
+                  }
+                  const queue = yield* Queue.unbounded<SDKMessage>();
+                  processQueues.push({ nativeThreadId, queue });
+                  return {
+                    messages: Stream.fromQueue(queue),
+                    offer: () => Effect.void,
+                    setModel: () => Effect.void,
+                    interrupt: Effect.void,
+                    close: Queue.shutdown(queue),
+                  };
+                }),
+              forkSession: () => Effect.die("unused forkSession"),
+              assertComplete: Effect.void,
+            },
+          });
+          const appThreadA = ThreadId.make("thread-claude-roster-a");
+          const appThreadB = ThreadId.make("thread-claude-roster-b");
+          const runtime = yield* adapter.openSession({
+            threadId: appThreadA,
+            providerSessionId: ProviderSessionId.make("provider-session-claude-sibling-replace"),
+            modelSelection: CLAUDE_TEST_MODEL_SELECTION,
+            runtimePolicy: CLAUDE_TEST_RUNTIME_POLICY,
+          });
+          const providerThreadA = yield* runtime.ensureThread({
+            threadId: appThreadA,
+            modelSelection: CLAUDE_TEST_MODEL_SELECTION,
+            runtimePolicy: CLAUDE_TEST_RUNTIME_POLICY,
+          });
+          const providerThreadB = yield* runtime.ensureThread({
+            threadId: appThreadB,
+            modelSelection: CLAUDE_TEST_MODEL_SELECTION,
+            runtimePolicy: CLAUDE_TEST_RUNTIME_POLICY,
+          });
+          assert.notEqual(
+            providerThreadA.nativeThreadRef?.nativeId,
+            providerThreadB.nativeThreadRef?.nativeId,
+          );
+          yield* runtime.events.pipe(
+            Stream.runForEach((event) =>
+              Effect.sync(() => {
+                events.push(event);
+              }),
+            ),
+            Effect.forkScoped,
+          );
+          if (runtime.hasPendingBackgroundWork === undefined) {
+            return yield* Effect.die(
+              "Claude adapter runtime must expose hasPendingBackgroundWork.",
+            );
+          }
+          if (runtime.hasPendingBackgroundWorkForThread === undefined) {
+            return yield* Effect.die(
+              "Claude adapter runtime must expose hasPendingBackgroundWorkForThread.",
+            );
+          }
+          const hasPendingBackgroundWork = runtime.hasPendingBackgroundWork;
+          const hasPendingBackgroundWorkForThread = runtime.hasPendingBackgroundWorkForThread;
+          const now = yield* DateTime.now;
+          const taskA = "task-roster-a";
+          const taskB = "task-roster-b";
+
+          yield* runtime.startTurn(
+            makeClaudeTestTurnInput({
+              threadId: appThreadA,
+              providerThread: providerThreadA,
+              now,
+              attemptId: RunAttemptId.make("attempt-roster-iso-a"),
+              text: "Background work on A.",
+              attachments: [],
+            }),
+          );
+          assert.equal(processQueues.length, 1);
+          const processA = processQueues[0]!;
+          yield* Queue.offer(
+            processA.queue,
+            claudeSdkFrame({
+              type: "system",
+              subtype: "task_started",
+              task_id: taskA,
+              description: "work on A",
+              task_type: "local_bash",
+              uuid: "00000000-0000-4000-8000-000000000301",
+              session_id: nativeIds[0],
+            }),
+          );
+          yield* Queue.offer(
+            processA.queue,
+            makeResultFrame({
+              uuid: "00000000-0000-4000-8000-000000000302",
+              result: "A settled with background work.",
+            }),
+          );
+          yield* awaitUntil(
+            () =>
+              events.some(
+                (event) =>
+                  event.type === "turn.terminal" &&
+                  event.providerThreadId === providerThreadA.id &&
+                  event.status === "completed",
+              ),
+            "thread A terminal",
+          );
+          const rosterAAfterSettle = providerThreadRosterEvents(events).findLast(
+            (event) => event.providerThread.id === providerThreadA.id,
+          )?.providerThread.pendingBackgroundTasks;
+          assert.deepEqual(rosterAAfterSettle ?? [], [
+            { taskId: taskA, description: "work on A", taskType: "local_bash" },
+          ]);
+          assert.isTrue(yield* hasPendingBackgroundWork);
+          assert.isTrue(yield* hasPendingBackgroundWorkForThread(providerThreadA));
+          assert.isFalse(yield* hasPendingBackgroundWorkForThread(providerThreadB));
+
+          // Starting B closes A's only live query. A can never emit a roster
+          // clear from a dead process, so openQuery must idle-clear A.
+          yield* runtime.startTurn(
+            makeClaudeTestTurnInput({
+              threadId: appThreadB,
+              providerThread: { ...providerThreadB, status: "active" },
+              now,
+              attemptId: RunAttemptId.make("attempt-roster-iso-b"),
+              text: "Background work on B.",
+              attachments: [],
+            }),
+          );
+          assert.equal(processQueues.length, 2);
+          yield* awaitUntil(
+            () =>
+              providerThreadRosterEvents(events).some(
+                (event) =>
+                  event.providerThread.id === providerThreadA.id &&
+                  event.providerThread.status === "idle" &&
+                  (event.providerThread.pendingBackgroundTasks?.length ?? 0) === 0,
+              ),
+            "sibling A roster cleared idle on process replacement",
+          );
+          assert.isFalse(yield* hasPendingBackgroundWorkForThread(providerThreadA));
+
+          const processB = processQueues[1]!;
+          yield* Queue.offer(
+            processB.queue,
+            claudeSdkFrame({
+              type: "system",
+              subtype: "task_started",
+              task_id: taskB,
+              description: "work on B",
+              task_type: "local_bash",
+              uuid: "00000000-0000-4000-8000-000000000303",
+              session_id: nativeIds[1],
+            }),
+          );
+          yield* awaitUntil(
+            () =>
+              providerThreadRosterEvents(events).some(
+                (event) =>
+                  event.providerThread.id === providerThreadB.id &&
+                  (event.providerThread.pendingBackgroundTasks?.length ?? 0) > 0,
+              ),
+            "thread B roster populated",
+          );
+          assert.isTrue(yield* hasPendingBackgroundWorkForThread(providerThreadB));
+          assert.isTrue(yield* hasPendingBackgroundWork);
+          // Starting B's process clears only B's process-scoped level; A stays
+          // empty from the sibling replacement clear above.
+          assert.isFalse(yield* hasPendingBackgroundWorkForThread(providerThreadA));
+
+          yield* Queue.offer(
+            processB.queue,
+            claudeSdkFrame({
+              type: "result",
+              subtype: "error_during_execution",
+              duration_ms: 10,
+              duration_api_ms: 10,
+              is_error: true,
+              num_turns: 1,
+              result: "B failed",
+              stop_reason: "end_turn",
+              total_cost_usd: 0,
+              usage: {
+                input_tokens: 1,
+                output_tokens: 1,
+                cache_creation_input_tokens: 0,
+                cache_read_input_tokens: 0,
+              },
+              modelUsage: {},
+              permission_denials: [],
+              errors: ["B failed"],
+              uuid: "00000000-0000-4000-8000-000000000304",
+              session_id: nativeIds[1],
+            }),
+          );
+          yield* awaitUntil(
+            () =>
+              events.some(
+                (event) =>
+                  event.type === "turn.terminal" &&
+                  event.providerThreadId === providerThreadB.id &&
+                  event.status === "failed",
+              ),
+            "thread B failed terminal",
+          );
+
+          const rosterBAfterFail = providerThreadRosterEvents(events).findLast(
+            (event) => event.providerThread.id === providerThreadB.id,
+          )?.providerThread.pendingBackgroundTasks;
+          assert.deepEqual(rosterBAfterFail ?? [], []);
+          assert.isFalse(yield* hasPendingBackgroundWorkForThread(providerThreadA));
+          assert.isFalse(yield* hasPendingBackgroundWorkForThread(providerThreadB));
+          assert.isFalse(yield* hasPendingBackgroundWork);
+        }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+      ),
+  );
+
+  it.effect("buffers wake output and requests a single continuation run", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const harness = yield* makeWakeHarness;
+        const now = yield* DateTime.now;
+
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-wake-1"),
+            text: "Run the build in the background.",
+            attachments: [],
+          }),
+        );
+        yield* Queue.offer(harness.sdkMessages, wakeTaskStarted);
+        yield* Queue.offer(harness.sdkMessages, turnOneResult);
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "first turn terminal");
+        assert.equal(harness.terminalEvents()[0]?.status, "completed");
+        assert.isTrue(yield* harness.hasPendingBackgroundWork);
+        assert.lengthOf(harness.continuationRequests, 0);
+
+        yield* Queue.offer(harness.sdkMessages, wakeNotification);
+        let quietYields = 0;
+        yield* awaitUntil(() => quietYields++ >= 50, "notification-only quiet window");
+        assert.lengthOf(harness.continuationRequests, 0);
+        assert.isFalse(yield* harness.hasPendingBackgroundWork);
+
+        yield* Queue.offer(harness.sdkMessages, wakeAssistant);
+        yield* awaitUntil(() => harness.continuationRequests.length === 1, "continuation request");
+        assert.equal(harness.continuationRequests[0]?.threadId, harness.threadId);
+        assert.equal(harness.continuationRequests[0]?.providerThreadId, harness.providerThread.id);
+        assert.equal(harness.continuationRequests[0]?.driver, CLAUDE_PROVIDER);
+        assert.equal(harness.continuationRequests[0]?.detail, WAKE_SUMMARY);
+
+        yield* Queue.offer(harness.sdkMessages, wakeResult);
+        let settleYields = 0;
+        yield* awaitUntil(() => settleYields++ >= 50, "wake result to settle into the buffer");
+        assert.lengthOf(harness.continuationRequests, 1);
+        assert.lengthOf(harness.terminalEvents(), 1);
+        assert.isTrue(yield* harness.hasPendingBackgroundWork);
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  it.effect("does not offer a continuation for notification-only opaque work", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const harness = yield* makeWakeHarness;
+        const now = yield* DateTime.now;
+
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-notification-only"),
+            text: "Start opaque background work.",
+            attachments: [],
+          }),
+        );
+        yield* Queue.offer(harness.sdkMessages, wakeTaskStarted);
+        yield* Queue.offer(harness.sdkMessages, turnOneResult);
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "first turn terminal");
+        assert.isTrue(yield* harness.hasPendingBackgroundWork);
+
+        yield* Queue.offer(harness.sdkMessages, wakeNotification);
+        let quietYields = 0;
+        yield* awaitUntil(() => quietYields++ >= 100, "notification-only quiet window");
+        assert.lengthOf(harness.continuationRequests, 0);
+        assert.lengthOf(harness.terminalEvents(), 1);
+        assert.isFalse(yield* harness.hasPendingBackgroundWork);
+
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-notification-only-continuation"),
+            text: "Background task completed.",
+            attachments: [],
+            providerTurnOrdinal: 2,
+            messageCreatedBy: "agent",
+            messageCreationSource: "provider",
+          }),
+        );
+        yield* awaitUntil(
+          () => harness.terminalEvents().length === 2,
+          "notification-only continuation terminal",
+        );
+        assert.equal(harness.terminalEvents()[1]?.status, "completed");
+        assert.lengthOf(harness.offeredMessages, 1);
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  it.effect("drains buffered wake messages into a continuation turn", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const harness = yield* makeWakeHarness;
+        const now = yield* DateTime.now;
+
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-wake-2a"),
+            text: "Run the build in the background.",
+            attachments: [],
+          }),
+        );
+        yield* Queue.offer(harness.sdkMessages, wakeTaskStarted);
+        yield* Queue.offer(harness.sdkMessages, turnOneResult);
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "first turn terminal");
+        yield* Queue.offer(harness.sdkMessages, wakeNotification);
+        yield* Queue.offer(harness.sdkMessages, wakeResult);
+        yield* awaitUntil(() => harness.continuationRequests.length === 1, "continuation request");
+
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-wake-2b"),
+            text: "Background task completed.",
+            attachments: [],
+            providerTurnOrdinal: 2,
+            messageCreatedBy: "agent",
+            messageCreationSource: "provider",
+          }),
+        );
+
+        yield* awaitUntil(() => harness.terminalEvents().length === 2, "continuation terminal");
+        assert.equal(harness.terminalEvents()[1]?.status, "completed");
+        // The continuation prompt never reaches the CLI; only the first turn
+        // offered a user message.
+        assert.lengthOf(harness.offeredMessages, 1);
+        // The wake result text surfaces as the continuation turn's assistant
+        // output.
+        assert.isTrue(
+          harness.events.some(
+            (event) => event.type === "message.updated" && event.message.text === WAKE_RESULT_TEXT,
+          ),
+        );
+        // The background task never renders as a subagent node.
+        assert.isFalse(
+          harness.events.some(
+            (event) =>
+              event.type !== "provider_thread.updated" &&
+              JSON.stringify(event).includes(WAKE_TASK_ID),
+          ),
+        );
+        assert.isFalse(yield* harness.hasPendingBackgroundWork);
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  it.effect("leaves buffered wake messages for the continuation queued behind a user turn", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const harness = yield* makeWakeHarness;
+        const now = yield* DateTime.now;
+
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-wake-4a"),
+            text: "Run the build in the background.",
+            attachments: [],
+          }),
+        );
+        yield* Queue.offer(harness.sdkMessages, wakeTaskStarted);
+        yield* Queue.offer(harness.sdkMessages, turnOneResult);
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "first turn terminal");
+        yield* Queue.offer(harness.sdkMessages, wakeNotification);
+        yield* Queue.offer(harness.sdkMessages, wakeResult);
+        yield* awaitUntil(() => harness.continuationRequests.length === 1, "continuation request");
+
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-wake-4b"),
+            text: "How is the build going?",
+            attachments: [],
+            providerTurnOrdinal: 2,
+          }),
+        );
+
+        // The user prompt reaches the CLI and the buffer stays untouched: the
+        // wake result must not settle the user turn or surface under it.
+        yield* awaitUntil(() => harness.offeredMessages.length === 2, "user prompt offered");
+        assert.lengthOf(harness.terminalEvents(), 1);
+        assert.isTrue(yield* harness.hasPendingBackgroundWork);
+
+        yield* Queue.offer(
+          harness.sdkMessages,
+          makeResultFrame({
+            uuid: "00000000-0000-4000-8000-000000000105",
+            result: "The build passed; nothing else pending.",
+          }),
+        );
+        yield* awaitUntil(() => harness.terminalEvents().length === 2, "user turn terminal");
+        assert.equal(harness.terminalEvents()[1]?.status, "completed");
+        assert.isFalse(
+          harness.events.some(
+            (event) => event.type === "message.updated" && event.message.text === WAKE_RESULT_TEXT,
+          ),
+        );
+
+        // The continuation run queued behind the user turn drains the wake
+        // output afterwards.
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-wake-4c"),
+            text: "Background task completed.",
+            attachments: [],
+            providerTurnOrdinal: 3,
+            messageCreatedBy: "agent",
+            messageCreationSource: "provider",
+          }),
+        );
+        yield* awaitUntil(() => harness.terminalEvents().length === 3, "continuation terminal");
+        assert.equal(harness.terminalEvents()[2]?.status, "completed");
+        assert.lengthOf(harness.offeredMessages, 2);
+        assert.isTrue(
+          harness.events.some(
+            (event) => event.type === "message.updated" && event.message.text === WAKE_RESULT_TEXT,
+          ),
+        );
+        assert.isFalse(
+          harness.events.some(
+            (event) =>
+              event.type !== "provider_thread.updated" &&
+              JSON.stringify(event).includes(WAKE_TASK_ID),
+          ),
+        );
+        assert.isFalse(yield* harness.hasPendingBackgroundWork);
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  it.effect("terminalizes an agent server wake from a positive task-notification result", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const harness = yield* makeWakeHarness;
+        const now = yield* DateTime.now;
+        const wakeText = "The background command completed.";
+
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-agent-server-wake"),
+            text: "Background task completed.",
+            attachments: [],
+            messageCreatedBy: "agent",
+            messageCreationSource: "server",
+          }),
+        );
+        yield* Queue.offer(
+          harness.sdkMessages,
+          makeAssistantTextFrame({
+            uuid: "00000000-0000-4000-8000-00000000010b",
+            text: wakeText,
+          }),
+        );
+        yield* Queue.offer(
+          harness.sdkMessages,
+          makeResultFrame({
+            uuid: "00000000-0000-4000-8000-00000000010c",
+            result: wakeText,
+            numTurns: 154,
+            origin: { kind: "task-notification" },
+          }),
+        );
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "server wake terminal");
+        assert.equal(harness.terminalEvents()[0]?.status, "completed");
+
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-agent-server-next"),
+            text: "What finished?",
+            attachments: [],
+            providerTurnOrdinal: 2,
+          }),
+        );
+        yield* Queue.offer(
+          harness.sdkMessages,
+          makeResultFrame({
+            uuid: "00000000-0000-4000-8000-00000000010d",
+            result: "The background command finished.",
+          }),
+        );
+        yield* awaitUntil(() => harness.terminalEvents().length === 2, "queued turn terminal");
+        assert.equal(harness.terminalEvents()[1]?.status, "completed");
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  it.effect("terminalizes a user mobile turn from a positive task-notification result", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const harness = yield* makeWakeHarness;
+        const now = yield* DateTime.now;
+        const fallbackText = "The ordinary mobile turn completed.";
+
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-mobile-notif-origin"),
+            text: "Complete this task.",
+            attachments: [],
+            messageCreationSource: "mobile",
+          }),
+        );
+        yield* Queue.offer(
+          harness.sdkMessages,
+          makeResultFrame({
+            uuid: "00000000-0000-4000-8000-00000000010e",
+            result: fallbackText,
+            numTurns: 60,
+            origin: { kind: "task-notification" },
+          }),
+        );
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "mobile turn terminal");
+        assert.equal(harness.terminalEvents()[0]?.status, "completed");
+        assert.isTrue(
+          harness.events.some(
+            (event) => event.type === "message.updated" && event.message.text === fallbackText,
+          ),
+        );
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  it.effect("ignores a zero-turn task-notification origin result during a normal user turn", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const harness = yield* makeWakeHarness;
+        const now = yield* DateTime.now;
+        const probeAssistantText = "Probe after stale task-notification result.";
+        const recoveryAssistantText = "Recovered after the interrupt; continuing.";
+        const staleResultText = STALE_TASK_NOTIFICATION_RESULT_TEXT;
+        const hasMessageText = (text: string) =>
+          harness.events.some(
+            (event) => event.type === "message.updated" && event.message.text === text,
+          );
+
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-stale-notif-1"),
+            text: "Continue after interrupt.",
+            attachments: [],
+          }),
+        );
+        yield* awaitUntil(() => harness.offeredMessages.length === 1, "recovery prompt offered");
+
+        // Live interleaving seen after interrupt recovery: a stale stopped
+        // task_notification and its task-notification-origin result arrive
+        // before the real root assistant stream.
+        yield* Queue.offer(
+          harness.sdkMessages,
+          claudeSdkFrame({
+            type: "system",
+            subtype: "task_notification",
+            task_id: "task-stale-stopped",
+            status: "stopped",
+            output_file: "/tmp/task-stale-stopped.log",
+            summary: "",
+            uuid: "00000000-0000-4000-8000-000000000107",
+            session_id: WAKE_NATIVE_SESSION,
+          }),
+        );
+        yield* Queue.offer(harness.sdkMessages, staleTaskNotificationResult);
+        // Queue-ordered probe: once this assistant text is emitted, the stale
+        // origin result ahead of it has been consumed.
+        yield* Queue.offer(
+          harness.sdkMessages,
+          claudeSdkFrame({
+            type: "assistant",
+            message: {
+              role: "assistant",
+              content: [{ type: "text", text: probeAssistantText }],
+            },
+            parent_tool_use_id: null,
+            uuid: "00000000-0000-4000-8000-00000000010a",
+            session_id: WAKE_NATIVE_SESSION,
+          }),
+        );
+
+        yield* awaitUntil(
+          () => hasMessageText(probeAssistantText),
+          "probe assistant after stale task-notification result",
+        );
+        assert.lengthOf(harness.terminalEvents(), 0);
+        assert.isFalse(hasMessageText(staleResultText));
+
+        yield* Queue.offer(
+          harness.sdkMessages,
+          claudeSdkFrame({
+            type: "assistant",
+            message: {
+              role: "assistant",
+              content: [{ type: "text", text: recoveryAssistantText }],
+            },
+            parent_tool_use_id: null,
+            uuid: "00000000-0000-4000-8000-000000000108",
+            session_id: WAKE_NATIVE_SESSION,
+          }),
+        );
+        yield* Queue.offer(
+          harness.sdkMessages,
+          makeResultFrame({
+            uuid: "00000000-0000-4000-8000-000000000109",
+            result: recoveryAssistantText,
+          }),
+        );
+
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "user turn terminal");
+        assert.equal(harness.terminalEvents()[0]?.status, "completed");
+        assert.isTrue(hasMessageText(recoveryAssistantText));
+        assert.isFalse(hasMessageText(staleResultText));
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  it.effect("terminalizes a zero-turn task-notification result in a provider continuation", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const harness = yield* makeWakeHarness;
+        const now = yield* DateTime.now;
+
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-zero-continuation-1"),
+            text: "Run the build in the background.",
+            attachments: [],
+          }),
+        );
+        yield* Queue.offer(harness.sdkMessages, wakeTaskStarted);
+        yield* Queue.offer(harness.sdkMessages, turnOneResult);
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "first turn terminal");
+        yield* Queue.offer(harness.sdkMessages, wakeNotification);
+        yield* Queue.offer(
+          harness.sdkMessages,
+          makeResultFrame({
+            uuid: "00000000-0000-4000-8000-00000000010f",
+            result: "Wake result with no model turns.",
+            numTurns: 0,
+            origin: { kind: "task-notification" },
+          }),
+        );
+        yield* awaitUntil(() => harness.continuationRequests.length === 1, "continuation request");
+
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-zero-continuation-2"),
+            text: "Background task completed.",
+            attachments: [],
+            providerTurnOrdinal: 2,
+            messageCreatedBy: "agent",
+            messageCreationSource: "provider",
+          }),
+        );
+        yield* awaitUntil(() => harness.terminalEvents().length === 2, "continuation terminal");
+        assert.equal(harness.terminalEvents()[1]?.status, "completed");
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  it.effect(
+    "emits one interrupted terminal for a positive task-notification result racing interrupt",
+    () =>
+      Effect.scoped(
+        Effect.gen(function* () {
+          const closeGate = yield* Deferred.make<void>();
+          const testScope = yield* Scope.Scope;
+          yield* Scope.addFinalizer(testScope, Deferred.succeed(closeGate, undefined));
+          const interruptStarted = yield* Deferred.make<void>();
+          const harness = yield* makeWakeHarnessWithOptions({
+            close: (sdkMessages) =>
+              Deferred.await(closeGate).pipe(Effect.andThen(Queue.shutdown(sdkMessages))),
+            interrupt: Deferred.succeed(interruptStarted, undefined),
+          });
+          const idAllocator = yield* IdAllocatorV2;
+          const now = yield* DateTime.now;
+          const attemptId = RunAttemptId.make("attempt-claude-interrupt-positive-notif");
+          const providerTurnId = idAllocator.derive.providerTurn({
+            driver: CLAUDE_PROVIDER,
+            nativeTurnId: `turn:${attemptId}`,
+          });
+
+          yield* harness.runtime.startTurn(
+            makeClaudeTestTurnInput({
+              threadId: harness.threadId,
+              providerThread: harness.providerThread,
+              now,
+              attemptId,
+              text: "Stop this task.",
+              attachments: [],
+            }),
+          );
+          yield* harness.runtime
+            .interruptTurn({ providerThread: harness.providerThread, providerTurnId })
+            .pipe(Effect.forkScoped);
+          yield* Deferred.await(interruptStarted);
+          yield* Queue.offer(
+            harness.sdkMessages,
+            makeResultFrame({
+              uuid: "00000000-0000-4000-8000-000000000115",
+              result: "Late result after interrupt.",
+              numTurns: 7,
+              origin: { kind: "task-notification" },
+            }),
+          );
+          const terminalized = Exit.isSuccess(
+            yield* awaitUntil(
+              () => harness.terminalEvents().length === 1,
+              "interrupted terminal",
+            ).pipe(Effect.exit),
+          );
+          yield* Deferred.succeed(closeGate, undefined);
+          assert.isTrue(terminalized);
+          assert.equal(harness.terminalEvents()[0]?.status, "interrupted");
+          assert.lengthOf(harness.terminalEvents(), 1);
+        }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+      ),
+  );
+
+  it.effect("drops zero-turn task-notification debris racing interrupt", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const closeGate = yield* Deferred.make<void>();
+        const testScope = yield* Scope.Scope;
+        yield* Scope.addFinalizer(testScope, Deferred.succeed(closeGate, undefined));
+        const interruptStarted = yield* Deferred.make<void>();
+        const harness = yield* makeWakeHarnessWithOptions({
+          close: (sdkMessages) =>
+            Deferred.await(closeGate).pipe(Effect.andThen(Queue.shutdown(sdkMessages))),
+          interrupt: Deferred.succeed(interruptStarted, undefined),
+        });
+        const idAllocator = yield* IdAllocatorV2;
+        const now = yield* DateTime.now;
+        const attemptId = RunAttemptId.make("attempt-claude-interrupt-zero-notif");
+        const providerTurnId = idAllocator.derive.providerTurn({
+          driver: CLAUDE_PROVIDER,
+          nativeTurnId: `turn:${attemptId}`,
+        });
+        const staleText = "Zero-turn debris must not leak.";
+
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId,
+            text: "Stop this task.",
+            attachments: [],
+          }),
+        );
+        yield* harness.runtime
+          .interruptTurn({ providerThread: harness.providerThread, providerTurnId })
+          .pipe(Effect.forkScoped);
+        yield* Deferred.await(interruptStarted);
+        yield* Queue.offer(
+          harness.sdkMessages,
+          makeResultFrame({
+            uuid: "00000000-0000-4000-8000-000000000116",
+            result: staleText,
+            numTurns: 0,
+            origin: { kind: "task-notification" },
+          }),
+        );
+        let debrisYields = 0;
+        yield* awaitUntil(() => debrisYields++ >= 50, "zero-turn debris consumed");
+        yield* Deferred.succeed(closeGate, undefined);
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "interrupted terminal");
+        assert.lengthOf(harness.terminalEvents(), 1);
+        assert.equal(harness.terminalEvents()[0]?.status, "interrupted");
+        assert.isFalse(
+          harness.events.some(
+            (event) => event.type === "message.updated" && event.message.text === staleText,
+          ),
+        );
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  it.effect("fails a positive task-notification error result", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const harness = yield* makeWakeHarness;
+        const now = yield* DateTime.now;
+
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-positive-notif-error"),
+            text: "Run the task.",
+            attachments: [],
+          }),
+        );
+        yield* Queue.offer(
+          harness.sdkMessages,
+          makeResultFrame({
+            uuid: "00000000-0000-4000-8000-000000000117",
+            result: "The task failed.",
+            numTurns: 7,
+            origin: { kind: "task-notification" },
+            subtype: "error_during_execution",
+            isError: true,
+            errors: ["The task failed."],
+          }),
+        );
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "failed terminal");
+        assert.equal(harness.terminalEvents()[0]?.status, "failed");
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  it.effect("terminalizes a continuation turn from a task-notification origin wake result", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const harness = yield* makeWakeHarness;
+        const now = yield* DateTime.now;
+
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-notif-origin-2a"),
+            text: "Run the build in the background.",
+            attachments: [],
+          }),
+        );
+        yield* Queue.offer(harness.sdkMessages, wakeTaskStarted);
+        yield* Queue.offer(harness.sdkMessages, turnOneResult);
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "first turn terminal");
+        yield* Queue.offer(harness.sdkMessages, wakeNotification);
+        yield* Queue.offer(harness.sdkMessages, wakeResult);
+        yield* awaitUntil(() => harness.continuationRequests.length === 1, "continuation request");
+
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-notif-origin-2b"),
+            text: "Background task completed.",
+            attachments: [],
+            providerTurnOrdinal: 2,
+            messageCreatedBy: "agent",
+            messageCreationSource: "provider",
+          }),
+        );
+
+        yield* awaitUntil(() => harness.terminalEvents().length === 2, "continuation terminal");
+        assert.equal(harness.terminalEvents()[1]?.status, "completed");
+        assert.lengthOf(harness.offeredMessages, 1);
+        assert.isTrue(
+          harness.events.some(
+            (event) => event.type === "message.updated" && event.message.text === WAKE_RESULT_TEXT,
+          ),
+        );
+        assert.isFalse(yield* harness.hasPendingBackgroundWork);
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  it.effect("clears the pending task when the wake notification carries no summary", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const harness = yield* makeWakeHarness;
+        const now = yield* DateTime.now;
+
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-wake-5a"),
+            text: "Run the build in the background.",
+            attachments: [],
+          }),
+        );
+        yield* Queue.offer(harness.sdkMessages, wakeTaskStarted);
+        yield* Queue.offer(harness.sdkMessages, turnOneResult);
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "first turn terminal");
+
+        yield* Queue.offer(
+          harness.sdkMessages,
+          claudeSdkFrame({
+            type: "system",
+            subtype: "task_notification",
+            task_id: WAKE_TASK_ID,
+            status: "completed",
+            output_file: "/tmp/task-wake-build.log",
+            summary: null,
+            uuid: "00000000-0000-4000-8000-000000000106",
+            session_id: WAKE_NATIVE_SESSION,
+          }),
+        );
+        yield* Queue.offer(harness.sdkMessages, wakeResult);
+        yield* awaitUntil(() => harness.continuationRequests.length === 1, "continuation request");
+        assert.isNull(harness.continuationRequests[0]?.detail);
+
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-wake-5b"),
+            text: "Background task completed.",
+            attachments: [],
+            providerTurnOrdinal: 2,
+            messageCreatedBy: "agent",
+            messageCreationSource: "provider",
+          }),
+        );
+        yield* awaitUntil(() => harness.terminalEvents().length === 2, "continuation terminal");
+        assert.equal(harness.terminalEvents()[1]?.status, "completed");
+        assert.isFalse(yield* harness.hasPendingBackgroundWork);
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  it.effect("settles a continuation turn immediately when no wake output is buffered", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const harness = yield* makeWakeHarness;
+        const now = yield* DateTime.now;
+
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-wake-3"),
+            text: "Background task completed.",
+            attachments: [],
+            messageCreatedBy: "agent",
+            messageCreationSource: "provider",
+          }),
+        );
+
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "spurious terminal");
+        assert.equal(harness.terminalEvents()[0]?.status, "completed");
+        assert.lengthOf(harness.offeredMessages, 0);
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  it.effect("wakes and hydrates a subagent that completes after the root turn settled", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const SUBAGENT_TASK_ID = "task-wake-subagent";
+        const SUBAGENT_TOOL_USE_ID = "toolu-wake-subagent";
+        const SUBAGENT_SUMMARY = "SUB_SETTLE_DONE";
+        const subagentTaskStarted = claudeSdkFrame({
+          type: "system",
+          subtype: "task_started",
+          task_id: SUBAGENT_TASK_ID,
+          tool_use_id: SUBAGENT_TOOL_USE_ID,
+          description: "Sleep then echo done token",
+          subagent_type: "general-purpose",
+          task_type: "local_agent",
+          prompt: "Run the shell command, then return exactly SUB_SETTLE_DONE.",
+          uuid: "00000000-0000-4000-8000-000000000201",
+          session_id: WAKE_NATIVE_SESSION,
+        });
+        const subagentNotification = claudeSdkFrame({
+          type: "system",
+          subtype: "task_notification",
+          task_id: SUBAGENT_TASK_ID,
+          tool_use_id: SUBAGENT_TOOL_USE_ID,
+          status: "completed",
+          output_file: "/tmp/task-wake-subagent.output",
+          summary: SUBAGENT_SUMMARY,
+          uuid: "00000000-0000-4000-8000-000000000202",
+          session_id: WAKE_NATIVE_SESSION,
+        });
+        // The SDK resolves a background Agent tool_use immediately with an
+        // async-launch ACK; it must not terminalize the subagent.
+        const subagentAsyncAck = claudeSdkFrame({
+          type: "user",
+          message: {
+            role: "user",
+            content: [
+              {
+                type: "tool_result",
+                tool_use_id: SUBAGENT_TOOL_USE_ID,
+                content: [{ type: "text", text: "Async agent launched successfully." }],
+              },
+            ],
+          },
+          parent_tool_use_id: null,
+          uuid: "00000000-0000-4000-8000-000000000205",
+          session_id: WAKE_NATIVE_SESSION,
+          tool_use_result: {
+            isAsync: true,
+            status: "async_launched",
+            agentId: SUBAGENT_TASK_ID,
+            prompt: "Run the shell command, then return exactly SUB_SETTLE_DONE.",
+          },
+        });
+
+        const harness = yield* makeWakeHarness;
+        const now = yield* DateTime.now;
+        const subagentEvents = () =>
+          harness.events.filter(
+            (event): event is Extract<ProviderAdapterV2Event, { type: "subagent.updated" }> =>
+              event.type === "subagent.updated",
+          );
+
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-wake-6a"),
+            text: "Spawn a background subagent and stop.",
+            attachments: [],
+          }),
+        );
+        yield* Queue.offer(harness.sdkMessages, subagentTaskStarted);
+        yield* awaitUntil(() => subagentEvents().length >= 1, "subagent node created");
+        assert.equal(subagentEvents()[0]?.subagent.status, "running");
+        yield* Queue.offer(harness.sdkMessages, subagentAsyncAck);
+        yield* Queue.offer(
+          harness.sdkMessages,
+          makeResultFrame({
+            uuid: "00000000-0000-4000-8000-000000000203",
+            result: "Spawned the subagent in the background.",
+          }),
+        );
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "first turn terminal");
+        assert.equal(harness.terminalEvents()[0]?.status, "completed");
+        // The ACK tool_result did not terminalize the row, and a still-running
+        // subagent pins idle release like a background task.
+        assert.equal(subagentEvents().at(-1)?.subagent.status, "running");
+        assert.isTrue(yield* harness.hasPendingBackgroundWork);
+        assert.lengthOf(harness.continuationRequests, 0);
+
+        yield* Queue.offer(harness.sdkMessages, subagentNotification);
+        yield* awaitUntil(() => harness.continuationRequests.length === 1, "continuation request");
+        assert.equal(harness.continuationRequests[0]?.threadId, harness.threadId);
+        assert.equal(harness.continuationRequests[0]?.detail, SUBAGENT_SUMMARY);
+
+        yield* Queue.offer(
+          harness.sdkMessages,
+          makeResultFrame({
+            uuid: "00000000-0000-4000-8000-000000000204",
+            result: "The subagent finished with SUB_SETTLE_DONE.",
+          }),
+        );
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-wake-6b"),
+            text: "Background task completed.",
+            attachments: [],
+            providerTurnOrdinal: 2,
+            messageCreatedBy: "agent",
+            messageCreationSource: "provider",
+          }),
+        );
+        yield* awaitUntil(() => harness.terminalEvents().length === 2, "continuation terminal");
+        assert.equal(harness.terminalEvents()[1]?.status, "completed");
+
+        // The replayed notification hydrates the original subagent node with
+        // its terminal status and result, and keeps the original run
+        // attribution instead of re-parenting to the continuation run.
+        const finalSubagent = subagentEvents().at(-1)?.subagent;
+        assert.equal(finalSubagent?.status, "completed");
+        assert.equal(finalSubagent?.result, SUBAGENT_SUMMARY);
+        assert.equal(finalSubagent?.runId, subagentEvents()[0]?.subagent.runId);
+        const subagentNodeEvents = harness.events.filter(
+          (event): event is Extract<ProviderAdapterV2Event, { type: "node.updated" }> =>
+            event.type === "node.updated" &&
+            event.node.kind === "subagent" &&
+            event.node.nativeItemRef?.nativeId === SUBAGENT_TASK_ID,
+        );
+        const finalSubagentNode = subagentNodeEvents.at(-1)?.node;
+        assert.equal(finalSubagentNode?.status, "completed");
+        assert.equal(finalSubagentNode?.runId, subagentNodeEvents[0]?.node.runId);
+        assert.isFalse(yield* harness.hasPendingBackgroundWork);
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  it.effect("keeps a subagent snapshot model that arrives before task_started", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const harness = yield* makeWakeHarness;
+        const now = yield* DateTime.now;
+        const toolUseId = "toolu-early-model";
+        const taskId = "task-early-model";
+
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-early-model"),
+            text: "Spawn a subagent.",
+            attachments: [],
+            modelSelection: {
+              ...CLAUDE_TEST_MODEL_SELECTION,
+              model: "claude-opus-4-6",
+            },
+          }),
+        );
+        yield* Queue.offer(
+          harness.sdkMessages,
+          claudeSdkFrame({
+            type: "assistant",
+            parent_tool_use_id: toolUseId,
+            message: {
+              model: "claude-sonnet-4-6",
+              content: [],
+            },
+            uuid: "00000000-0000-4000-8000-000000000206",
+            session_id: WAKE_NATIVE_SESSION,
+          }),
+        );
+        yield* Queue.offer(
+          harness.sdkMessages,
+          claudeSdkFrame({
+            type: "system",
+            subtype: "task_started",
+            task_id: taskId,
+            tool_use_id: toolUseId,
+            description: "Early model task",
+            task_type: "local_agent",
+            uuid: "00000000-0000-4000-8000-000000000207",
+            session_id: WAKE_NATIVE_SESSION,
+          }),
+        );
+        const subagentEvents = () =>
+          harness.events.filter(
+            (event): event is Extract<ProviderAdapterV2Event, { type: "subagent.updated" }> =>
+              event.type === "subagent.updated",
+          );
+        yield* awaitUntil(() => subagentEvents().length === 1, "early model subagent");
+
+        assert.equal(subagentEvents()[0]?.subagent.model, "claude-sonnet-4-6");
+
+        yield* Queue.offer(
+          harness.sdkMessages,
+          makeResultFrame({
+            uuid: "00000000-0000-4000-8000-000000000208",
+            result: "Spawned the subagent.",
+          }),
+        );
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "early model turn terminal");
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  it.effect("extracts text from direct content-block subagent results", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const SUBAGENT_TASK_ID = "task-direct-content-blocks";
+        const SUBAGENT_TOOL_USE_ID = "toolu-direct-content-blocks";
+        const harness = yield* makeWakeHarness;
+        const now = yield* DateTime.now;
+        const subagentEvents = () =>
+          harness.events.filter(
+            (event): event is Extract<ProviderAdapterV2Event, { type: "subagent.updated" }> =>
+              event.type === "subagent.updated",
+          );
+
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-direct-content-blocks"),
+            text: "Delegate this task.",
+            attachments: [],
+          }),
+        );
+        yield* Queue.offer(
+          harness.sdkMessages,
+          claudeSdkFrame({
+            type: "system",
+            subtype: "task_started",
+            task_id: SUBAGENT_TASK_ID,
+            tool_use_id: SUBAGENT_TOOL_USE_ID,
+            description: "Delegated task",
+            subagent_type: "general-purpose",
+            task_type: "local_agent",
+            prompt: "Return the result.",
+            uuid: "00000000-0000-4000-8000-000000000206",
+            session_id: WAKE_NATIVE_SESSION,
+          }),
+        );
+        yield* awaitUntil(() => subagentEvents().length === 1, "subagent node created");
+
+        yield* Queue.offer(
+          harness.sdkMessages,
+          claudeSdkFrame({
+            type: "user",
+            message: {
+              role: "user",
+              content: [
+                {
+                  type: "tool_result",
+                  tool_use_id: SUBAGENT_TOOL_USE_ID,
+                  content: [
+                    { type: "text", text: "First line." },
+                    { type: "text", text: "Second line." },
+                  ],
+                },
+              ],
+            },
+            parent_tool_use_id: null,
+            uuid: "00000000-0000-4000-8000-000000000207",
+            session_id: WAKE_NATIVE_SESSION,
+          }),
+        );
+        yield* awaitUntil(
+          () => subagentEvents().at(-1)?.subagent.status === "completed",
+          "subagent terminal",
+        );
+
+        assert.equal(subagentEvents().at(-1)?.subagent.result, "First line.\nSecond line.");
+
+        yield* Queue.offer(
+          harness.sdkMessages,
+          makeResultFrame({
+            uuid: "00000000-0000-4000-8000-000000000208",
+            result: "Delegation completed.",
+          }),
+        );
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "turn terminal");
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  it.effect("releases the idle pin when a post-settle subagent stops without completing", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const SUBAGENT_TASK_ID = "task-wake-subagent-stopped";
+        const subagentTaskStarted = claudeSdkFrame({
+          type: "system",
+          subtype: "task_started",
+          task_id: SUBAGENT_TASK_ID,
+          tool_use_id: "toolu-wake-subagent-stopped",
+          description: "Long-running research task",
+          subagent_type: "general-purpose",
+          task_type: "local_agent",
+          prompt: "Investigate the flaky test.",
+          uuid: "00000000-0000-4000-8000-000000000301",
+          session_id: WAKE_NATIVE_SESSION,
+        });
+        const subagentStoppedNotification = claudeSdkFrame({
+          type: "system",
+          subtype: "task_notification",
+          task_id: SUBAGENT_TASK_ID,
+          tool_use_id: "toolu-wake-subagent-stopped",
+          status: "stopped",
+          output_file: "/tmp/task-wake-subagent-stopped.output",
+          summary: "Agent was stopped before finishing.",
+          uuid: "00000000-0000-4000-8000-000000000302",
+          session_id: WAKE_NATIVE_SESSION,
+        });
+
+        const harness = yield* makeWakeHarness;
+        const now = yield* DateTime.now;
+        const subagentEvents = () =>
+          harness.events.filter(
+            (event): event is Extract<ProviderAdapterV2Event, { type: "subagent.updated" }> =>
+              event.type === "subagent.updated",
+          );
+
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-wake-7a"),
+            text: "Spawn a background subagent and stop.",
+            attachments: [],
+          }),
+        );
+        yield* Queue.offer(harness.sdkMessages, subagentTaskStarted);
+        yield* awaitUntil(() => subagentEvents().length >= 1, "subagent node created");
+        yield* Queue.offer(
+          harness.sdkMessages,
+          makeResultFrame({
+            uuid: "00000000-0000-4000-8000-000000000303",
+            result: "Spawned the subagent in the background.",
+          }),
+        );
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "first turn terminal");
+        assert.isTrue(yield* harness.hasPendingBackgroundWork);
+
+        yield* Queue.offer(harness.sdkMessages, subagentStoppedNotification);
+        yield* awaitUntil(() => harness.continuationRequests.length === 1, "continuation request");
+
+        yield* Queue.offer(
+          harness.sdkMessages,
+          makeResultFrame({
+            uuid: "00000000-0000-4000-8000-000000000304",
+            result: "The subagent was stopped.",
+          }),
+        );
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-wake-7b"),
+            text: "Background task completed.",
+            attachments: [],
+            providerTurnOrdinal: 2,
+            messageCreatedBy: "agent",
+            messageCreationSource: "provider",
+          }),
+        );
+        yield* awaitUntil(() => harness.terminalEvents().length === 2, "continuation terminal");
+
+        assert.equal(subagentEvents().at(-1)?.subagent.status, "cancelled");
+        assert.isFalse(yield* harness.hasPendingBackgroundWork);
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  it.effect("re-opens a resumed subagent and hydrates its second result", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const SUBAGENT_TASK_ID = "task-resume-subagent";
+        const SUBAGENT_TOOL_USE_ID = "toolu-resume-subagent";
+        const RESUME_TOOL_USE_ID = "toolu-resume-sendmessage";
+        const FIRST_SUMMARY = "Timer armed. Waiting for it to complete.";
+        const SECOND_SUMMARY = "RESUME_DONE";
+        const subagentTaskStarted = claudeSdkFrame({
+          type: "system",
+          subtype: "task_started",
+          task_id: SUBAGENT_TASK_ID,
+          tool_use_id: SUBAGENT_TOOL_USE_ID,
+          description: "Sleep then echo done token",
+          subagent_type: "general-purpose",
+          task_type: "local_agent",
+          prompt: "Run the shell command, then return exactly RESUME_DONE.",
+          uuid: "00000000-0000-4000-8000-000000000401",
+          session_id: WAKE_NATIVE_SESSION,
+        });
+        const firstNotification = claudeSdkFrame({
+          type: "system",
+          subtype: "task_notification",
+          task_id: SUBAGENT_TASK_ID,
+          tool_use_id: SUBAGENT_TOOL_USE_ID,
+          status: "completed",
+          output_file: "/tmp/task-resume-subagent.output",
+          summary: FIRST_SUMMARY,
+          uuid: "00000000-0000-4000-8000-000000000402",
+          session_id: WAKE_NATIVE_SESSION,
+        });
+        // SendMessage to a completed subagent resumes it: the CLI re-emits
+        // task_started with the same task id but the SendMessage call's
+        // tool_use_id, not the original Agent launch's.
+        const resumeTaskStarted = claudeSdkFrame({
+          type: "system",
+          subtype: "task_started",
+          task_id: SUBAGENT_TASK_ID,
+          tool_use_id: RESUME_TOOL_USE_ID,
+          description: "Sleep then echo done token",
+          subagent_type: "general-purpose",
+          task_type: "local_agent",
+          prompt: "Run the shell command, then return exactly RESUME_DONE.",
+          uuid: "00000000-0000-4000-8000-000000000405",
+          session_id: WAKE_NATIVE_SESSION,
+        });
+        const secondNotification = claudeSdkFrame({
+          type: "system",
+          subtype: "task_notification",
+          task_id: SUBAGENT_TASK_ID,
+          tool_use_id: SUBAGENT_TOOL_USE_ID,
+          status: "completed",
+          output_file: "/tmp/task-resume-subagent.output",
+          summary: SECOND_SUMMARY,
+          uuid: "00000000-0000-4000-8000-000000000407",
+          session_id: WAKE_NATIVE_SESSION,
+        });
+
+        const harness = yield* makeWakeHarness;
+        const now = yield* DateTime.now;
+        const subagentEvents = () =>
+          harness.events.filter(
+            (event): event is Extract<ProviderAdapterV2Event, { type: "subagent.updated" }> =>
+              event.type === "subagent.updated",
+          );
+
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-wake-8a"),
+            text: "Spawn a background subagent and stop.",
+            attachments: [],
+          }),
+        );
+        yield* Queue.offer(harness.sdkMessages, subagentTaskStarted);
+        yield* awaitUntil(() => subagentEvents().length >= 1, "subagent node created");
+        yield* Queue.offer(
+          harness.sdkMessages,
+          makeResultFrame({
+            uuid: "00000000-0000-4000-8000-000000000403",
+            result: "Spawned the subagent in the background.",
+          }),
+        );
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "first turn terminal");
+
+        yield* Queue.offer(harness.sdkMessages, firstNotification);
+        yield* awaitUntil(
+          () => harness.continuationRequests.length === 1,
+          "first continuation request",
+        );
+        assert.equal(harness.continuationRequests[0]?.detail, FIRST_SUMMARY);
+        yield* Queue.offer(
+          harness.sdkMessages,
+          makeResultFrame({
+            uuid: "00000000-0000-4000-8000-000000000404",
+            result: "The subagent finished early.",
+          }),
+        );
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-wake-8b"),
+            text: "Background task completed.",
+            attachments: [],
+            providerTurnOrdinal: 2,
+            messageCreatedBy: "agent",
+            messageCreationSource: "provider",
+          }),
+        );
+        yield* awaitUntil(() => harness.terminalEvents().length === 2, "continuation terminal");
+        assert.equal(subagentEvents().at(-1)?.subagent.status, "completed");
+        assert.equal(subagentEvents().at(-1)?.subagent.result, FIRST_SUMMARY);
+        assert.isFalse(yield* harness.hasPendingBackgroundWork);
+
+        // A user turn nudges the completed subagent via SendMessage; the
+        // resume task_started re-opens the row across turn contexts (the new
+        // turn's maps are empty, so this exercises the session registry).
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-wake-8c"),
+            text: "Nudge the subagent to finish.",
+            attachments: [],
+            providerTurnOrdinal: 3,
+          }),
+        );
+        yield* awaitUntil(() => harness.offeredMessages.length === 2, "nudge prompt offered");
+        // The resume rides on a SendMessage tool call: the CLI re-emits
+        // task_started with the SendMessage tool_use_id, and that tool call's
+        // result is a delivery ACK which must not terminalize the subagent.
+        yield* Queue.offer(
+          harness.sdkMessages,
+          claudeSdkFrame({
+            type: "assistant",
+            message: {
+              role: "assistant",
+              content: [
+                {
+                  type: "tool_use",
+                  id: RESUME_TOOL_USE_ID,
+                  name: "SendMessage",
+                  input: { agent_id: SUBAGENT_TASK_ID, message: "Continue and return the token." },
+                },
+              ],
+            },
+            parent_tool_use_id: null,
+            uuid: "00000000-0000-4000-8000-000000000411",
+            session_id: WAKE_NATIVE_SESSION,
+          }),
+        );
+        yield* Queue.offer(harness.sdkMessages, resumeTaskStarted);
+        yield* Queue.offer(
+          harness.sdkMessages,
+          claudeSdkFrame({
+            type: "user",
+            message: {
+              role: "user",
+              content: [
+                {
+                  type: "tool_result",
+                  tool_use_id: RESUME_TOOL_USE_ID,
+                  content: [
+                    {
+                      type: "text",
+                      text: '{"success":true,"message":"Message sent to agent; it will resume."}',
+                    },
+                  ],
+                },
+              ],
+            },
+            parent_tool_use_id: null,
+            uuid: "00000000-0000-4000-8000-000000000412",
+            session_id: WAKE_NATIVE_SESSION,
+          }),
+        );
+        yield* awaitUntil(
+          () => subagentEvents().at(-1)?.subagent.status === "running",
+          "subagent re-opened",
+        );
+        const reopened = subagentEvents().at(-1)?.subagent;
+        assert.isNull(reopened?.result);
+        // The reopen re-attributes the subagent to the resuming run:
+        // RunExecutionService routes parent-thread events by runId, and the
+        // launch run's ingestion fiber stops once its child subagents
+        // terminalize, so only the resuming run's fiber can persist the
+        // resumed lifecycle.
+        assert.equal(reopened?.runId, "run-attempt-claude-wake-8c");
+        assert.notEqual(reopened?.runId, subagentEvents()[0]?.subagent.runId);
+        yield* Queue.offer(
+          harness.sdkMessages,
+          makeResultFrame({
+            uuid: "00000000-0000-4000-8000-000000000406",
+            result: "Nudged the subagent.",
+          }),
+        );
+        yield* awaitUntil(() => harness.terminalEvents().length === 3, "nudge turn terminal");
+        // The re-opened subagent pins idle release again.
+        assert.isTrue(yield* harness.hasPendingBackgroundWork);
+
+        // The resumed run's notification is wake evidence again and carries
+        // its summary as the continuation detail.
+        yield* Queue.offer(harness.sdkMessages, secondNotification);
+        yield* awaitUntil(
+          () => harness.continuationRequests.length === 2,
+          "second continuation request",
+        );
+        assert.equal(harness.continuationRequests[1]?.detail, SECOND_SUMMARY);
+        yield* Queue.offer(
+          harness.sdkMessages,
+          makeResultFrame({
+            uuid: "00000000-0000-4000-8000-000000000408",
+            result: "The subagent finished with RESUME_DONE.",
+          }),
+        );
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-wake-8d"),
+            text: "Background task completed.",
+            attachments: [],
+            providerTurnOrdinal: 4,
+            messageCreatedBy: "agent",
+            messageCreationSource: "provider",
+          }),
+        );
+        yield* awaitUntil(
+          () => harness.terminalEvents().length === 4,
+          "second continuation terminal",
+        );
+
+        const finalSubagent = subagentEvents().at(-1)?.subagent;
+        assert.equal(finalSubagent?.status, "completed");
+        assert.equal(finalSubagent?.result, SECOND_SUMMARY);
+        // The completion keeps the resuming run's attribution.
+        assert.equal(finalSubagent?.runId, "run-attempt-claude-wake-8c");
+        assert.isFalse(yield* harness.hasPendingBackgroundWork);
+
+        // Only task_started may re-open a terminal subagent: a late
+        // task_progress must not flip the row back to running or re-pin idle.
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-wake-8e"),
+            text: "Anything new?",
+            attachments: [],
+            providerTurnOrdinal: 5,
+          }),
+        );
+        yield* awaitUntil(() => harness.offeredMessages.length === 3, "final prompt offered");
+        yield* Queue.offer(
+          harness.sdkMessages,
+          claudeSdkFrame({
+            type: "system",
+            subtype: "task_progress",
+            task_id: SUBAGENT_TASK_ID,
+            tool_use_id: SUBAGENT_TOOL_USE_ID,
+            description: "Stale progress line",
+            uuid: "00000000-0000-4000-8000-000000000409",
+            session_id: WAKE_NATIVE_SESSION,
+          }),
+        );
+        yield* Queue.offer(
+          harness.sdkMessages,
+          makeResultFrame({
+            uuid: "00000000-0000-4000-8000-000000000410",
+            result: "Nothing new.",
+          }),
+        );
+        yield* awaitUntil(() => harness.terminalEvents().length === 5, "final turn terminal");
+        assert.equal(subagentEvents().at(-1)?.subagent.status, "completed");
+        assert.equal(subagentEvents().at(-1)?.subagent.result, SECOND_SUMMARY);
+        assert.isFalse(yield* harness.hasPendingBackgroundWork);
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  it.effect("re-opens a resumed subagent whose task_started races past settle", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const SUBAGENT_TASK_ID = "task-resume-postsettle";
+        const SUBAGENT_TOOL_USE_ID = "toolu-resume-postsettle";
+        const RESUME_TOOL_USE_ID = "toolu-resume-postsettle-sendmessage";
+        const FIRST_SUMMARY = "Answered early.";
+        const SECOND_SUMMARY = "RESUME_SETTLE_DONE";
+        const subagentTaskStarted = claudeSdkFrame({
+          type: "system",
+          subtype: "task_started",
+          task_id: SUBAGENT_TASK_ID,
+          tool_use_id: SUBAGENT_TOOL_USE_ID,
+          description: "Sleep then echo done token",
+          subagent_type: "general-purpose",
+          task_type: "local_agent",
+          prompt: "Run the shell command, then return exactly RESUME_SETTLE_DONE.",
+          uuid: "00000000-0000-4000-8000-000000000501",
+          session_id: WAKE_NATIVE_SESSION,
+        });
+        const firstNotification = claudeSdkFrame({
+          type: "system",
+          subtype: "task_notification",
+          task_id: SUBAGENT_TASK_ID,
+          tool_use_id: SUBAGENT_TOOL_USE_ID,
+          status: "completed",
+          output_file: "/tmp/task-resume-postsettle.output",
+          summary: FIRST_SUMMARY,
+          uuid: "00000000-0000-4000-8000-000000000502",
+          session_id: WAKE_NATIVE_SESSION,
+        });
+        const resumeTaskStarted = claudeSdkFrame({
+          type: "system",
+          subtype: "task_started",
+          task_id: SUBAGENT_TASK_ID,
+          tool_use_id: RESUME_TOOL_USE_ID,
+          description: "Sleep then echo done token",
+          subagent_type: "general-purpose",
+          task_type: "local_agent",
+          prompt: "Run the shell command, then return exactly RESUME_SETTLE_DONE.",
+          uuid: "00000000-0000-4000-8000-000000000505",
+          session_id: WAKE_NATIVE_SESSION,
+        });
+        const secondNotification = claudeSdkFrame({
+          type: "system",
+          subtype: "task_notification",
+          task_id: SUBAGENT_TASK_ID,
+          tool_use_id: SUBAGENT_TOOL_USE_ID,
+          status: "completed",
+          output_file: "/tmp/task-resume-postsettle.output",
+          summary: SECOND_SUMMARY,
+          uuid: "00000000-0000-4000-8000-000000000506",
+          session_id: WAKE_NATIVE_SESSION,
+        });
+
+        const harness = yield* makeWakeHarness;
+        const now = yield* DateTime.now;
+        const subagentEvents = () =>
+          harness.events.filter(
+            (event): event is Extract<ProviderAdapterV2Event, { type: "subagent.updated" }> =>
+              event.type === "subagent.updated",
+          );
+
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-wake-9a"),
+            text: "Spawn a background subagent and stop.",
+            attachments: [],
+          }),
+        );
+        yield* Queue.offer(harness.sdkMessages, subagentTaskStarted);
+        yield* awaitUntil(() => subagentEvents().length >= 1, "subagent node created");
+        yield* Queue.offer(
+          harness.sdkMessages,
+          makeResultFrame({
+            uuid: "00000000-0000-4000-8000-000000000503",
+            result: "Spawned the subagent in the background.",
+          }),
+        );
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "first turn terminal");
+
+        yield* Queue.offer(harness.sdkMessages, firstNotification);
+        yield* awaitUntil(
+          () => harness.continuationRequests.length === 1,
+          "first continuation request",
+        );
+        yield* Queue.offer(
+          harness.sdkMessages,
+          makeResultFrame({
+            uuid: "00000000-0000-4000-8000-000000000504",
+            result: "The subagent answered early.",
+          }),
+        );
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-wake-9b"),
+            text: "Background task completed.",
+            attachments: [],
+            providerTurnOrdinal: 2,
+            messageCreatedBy: "agent",
+            messageCreationSource: "provider",
+          }),
+        );
+        yield* awaitUntil(() => harness.terminalEvents().length === 2, "continuation terminal");
+        assert.equal(subagentEvents().at(-1)?.subagent.status, "completed");
+        assert.equal(subagentEvents().at(-1)?.subagent.result, FIRST_SUMMARY);
+        assert.isFalse(yield* harness.hasPendingBackgroundWork);
+
+        // The resume task_started races past settle: no turn is active, so it
+        // must re-open the session registry entry (pinning idle again) and
+        // buffer for replay. Its notification then counts as wake evidence
+        // and carries the new summary as the continuation detail. The resume
+        // rides on a SendMessage tool call whose frames race past settle too;
+        // on drain replay the SendMessage tool_result is a delivery ACK and
+        // must not terminalize the re-opened subagent.
+        yield* Queue.offer(
+          harness.sdkMessages,
+          claudeSdkFrame({
+            type: "assistant",
+            message: {
+              role: "assistant",
+              content: [
+                {
+                  type: "tool_use",
+                  id: RESUME_TOOL_USE_ID,
+                  name: "SendMessage",
+                  input: { agent_id: SUBAGENT_TASK_ID, message: "Continue and return the token." },
+                },
+              ],
+            },
+            parent_tool_use_id: null,
+            uuid: "00000000-0000-4000-8000-000000000508",
+            session_id: WAKE_NATIVE_SESSION,
+          }),
+        );
+        yield* Queue.offer(harness.sdkMessages, resumeTaskStarted);
+        yield* Queue.offer(
+          harness.sdkMessages,
+          claudeSdkFrame({
+            type: "user",
+            message: {
+              role: "user",
+              content: [
+                {
+                  type: "tool_result",
+                  tool_use_id: RESUME_TOOL_USE_ID,
+                  content: [
+                    {
+                      type: "text",
+                      text: '{"success":true,"message":"Message sent to agent; it will resume."}',
+                    },
+                  ],
+                },
+              ],
+            },
+            parent_tool_use_id: null,
+            uuid: "00000000-0000-4000-8000-000000000509",
+            session_id: WAKE_NATIVE_SESSION,
+          }),
+        );
+        yield* Queue.offer(harness.sdkMessages, secondNotification);
+        yield* awaitUntil(
+          () => harness.continuationRequests.length === 2,
+          "second continuation request",
+        );
+        assert.equal(harness.continuationRequests[1]?.detail, SECOND_SUMMARY);
+        assert.isTrue(yield* harness.hasPendingBackgroundWork);
+
+        yield* Queue.offer(
+          harness.sdkMessages,
+          makeResultFrame({
+            uuid: "00000000-0000-4000-8000-000000000507",
+            result: "The subagent finished with RESUME_SETTLE_DONE.",
+          }),
+        );
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-wake-9c"),
+            text: "Background task completed.",
+            attachments: [],
+            providerTurnOrdinal: 3,
+            messageCreatedBy: "agent",
+            messageCreationSource: "provider",
+          }),
+        );
+        yield* awaitUntil(
+          () => harness.terminalEvents().length === 3,
+          "resume continuation terminal",
+        );
+
+        // The drained replay re-opens the row (running, stale result cleared)
+        // before the second notification terminalizes it again.
+        const statuses = subagentEvents().map((event) => event.subagent.status);
+        const firstCompleted = statuses.indexOf("completed");
+        const reopenedIndex = statuses.lastIndexOf("running");
+        assert.isAbove(reopenedIndex, firstCompleted);
+        assert.isNull(subagentEvents()[reopenedIndex]?.subagent.result);
+        // The drain-replayed reopen re-attributes the subagent to the
+        // continuation run performing the replay, so that run's ingestion
+        // fiber routes the resumed lifecycle and lingers past settle until
+        // the resumed task completes.
+        assert.equal(subagentEvents()[reopenedIndex]?.subagent.runId, "run-attempt-claude-wake-9c");
+        // The execution node re-opens too, even though the registry entry was
+        // already pre-opened by the wake buffer before the drain replay.
+        const nodeStatuses = harness.events
+          .filter(
+            (event): event is Extract<ProviderAdapterV2Event, { type: "node.updated" }> =>
+              event.type === "node.updated" &&
+              event.node.kind === "subagent" &&
+              event.node.nativeItemRef?.nativeId === SUBAGENT_TASK_ID,
+          )
+          .map((event) => event.node.status);
+        assert.isAbove(nodeStatuses.lastIndexOf("running"), nodeStatuses.indexOf("completed"));
+        const finalSubagent = subagentEvents().at(-1)?.subagent;
+        assert.equal(finalSubagent?.status, "completed");
+        assert.equal(finalSubagent?.result, SECOND_SUMMARY);
+        // The completion keeps the resuming run's attribution.
+        assert.equal(finalSubagent?.runId, "run-attempt-claude-wake-9c");
+        assert.isFalse(yield* harness.hasPendingBackgroundWork);
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  it.effect(
+    "orders nonempty level, empty level, notification, and continuation drain without subagent projection",
+    () =>
+      Effect.scoped(
+        Effect.gen(function* () {
+          const harness = yield* makeWakeHarness;
+          const now = yield* DateTime.now;
+          const nonemptyRoster = claudeSdkFrame({
+            type: "system",
+            subtype: "background_tasks_changed",
+            tasks: [
+              {
+                task_id: WAKE_TASK_ID,
+                description: "npm run build",
+                task_type: "local_bash",
+              },
+            ],
+            uuid: "00000000-0000-4000-8000-000000000600",
+            session_id: WAKE_NATIVE_SESSION,
+          });
+          const emptyRoster = claudeSdkFrame({
+            type: "system",
+            subtype: "background_tasks_changed",
+            tasks: [],
+            uuid: "00000000-0000-4000-8000-000000000601",
+            session_id: WAKE_NATIVE_SESSION,
+          });
+          const duplicateNotification = claudeSdkFrame({
+            type: "system",
+            subtype: "task_notification",
+            task_id: WAKE_TASK_ID,
+            status: "completed",
+            output_file: "/tmp/task-wake-build-dup.log",
+            summary: "duplicate should not re-buffer",
+            uuid: "00000000-0000-4000-8000-000000000605",
+            session_id: WAKE_NATIVE_SESSION,
+          });
+
+          yield* harness.runtime.startTurn(
+            makeClaudeTestTurnInput({
+              threadId: harness.threadId,
+              providerThread: harness.providerThread,
+              now,
+              attemptId: RunAttemptId.make("attempt-claude-level-before-edge-a"),
+              text: "Run the build in the background.",
+              attachments: [],
+            }),
+          );
+          // 1) Nonempty authoritative level admits local_bash to Waiting +
+          // wake eligibility.
+          yield* Queue.offer(harness.sdkMessages, nonemptyRoster);
+          yield* awaitUntil(
+            () =>
+              providerThreadRosterEvents(harness.events).some(
+                (event) => (event.providerThread.pendingBackgroundTasks?.length ?? 0) > 0,
+              ),
+            "nonempty level populated Waiting roster",
+          );
+          assert.deepEqual(
+            providerThreadRosterEvents(harness.events).at(-1)?.providerThread
+              .pendingBackgroundTasks ?? [],
+            [
+              {
+                taskId: WAKE_TASK_ID,
+                description: "npm run build",
+                taskType: "local_bash",
+              },
+            ],
+          );
+          yield* Queue.offer(harness.sdkMessages, turnOneResult);
+          yield* awaitUntil(() => harness.terminalEvents().length === 1, "first turn terminal");
+          assert.isTrue(yield* harness.hasPendingBackgroundWork);
+
+          // 2) Empty level clears Waiting but keeps wake eligibility so the
+          // later notification can still offer exactly one continuation.
+          yield* Queue.offer(harness.sdkMessages, emptyRoster);
+          yield* awaitUntil(
+            () =>
+              providerThreadRosterEvents(harness.events).some(
+                (event) =>
+                  event.providerThread.status === "idle" &&
+                  (event.providerThread.pendingBackgroundTasks?.length ?? 0) === 0,
+              ),
+            "empty level cleared Waiting roster",
+          );
+          assert.isFalse(yield* harness.hasPendingBackgroundWork);
+          assert.lengthOf(harness.continuationRequests, 0);
+
+          // 3) First idle notification buffers and consumes eligibility. The
+          // following native assistant frame proves Claude began a wake turn.
+          yield* Queue.offer(harness.sdkMessages, wakeNotification);
+          yield* Queue.offer(harness.sdkMessages, wakeAssistant);
+          yield* awaitUntil(
+            () => harness.continuationRequests.length === 1,
+            "continuation after level-before-edge",
+          );
+          assert.equal(harness.continuationRequests[0]?.detail, WAKE_SUMMARY);
+
+          // A duplicate notification must not re-buffer or re-offer.
+          yield* Queue.offer(harness.sdkMessages, duplicateNotification);
+          let settleYields = 0;
+          yield* awaitUntil(() => settleYields++ >= 50, "duplicate notification settle");
+          assert.lengthOf(harness.continuationRequests, 1);
+
+          // 4) Continuation drain classifies the buffered notification as
+          // local_bash (replay tombstone) and never fabricates a subagent.
+          yield* Queue.offer(harness.sdkMessages, wakeResult);
+          yield* harness.runtime.startTurn(
+            makeClaudeTestTurnInput({
+              threadId: harness.threadId,
+              providerThread: harness.providerThread,
+              now,
+              attemptId: RunAttemptId.make("attempt-claude-level-before-edge-b"),
+              text: "Background task completed.",
+              attachments: [],
+              providerTurnOrdinal: 2,
+              messageCreatedBy: "agent",
+              messageCreationSource: "provider",
+            }),
+          );
+          yield* awaitUntil(() => harness.terminalEvents().length === 2, "continuation terminal");
+          assert.equal(harness.terminalEvents()[1]?.status, "completed");
+          assert.lengthOf(harness.continuationRequests, 1);
+          assert.isTrue(
+            harness.events.some(
+              (event) =>
+                event.type === "message.updated" && event.message.text === WAKE_ASSISTANT_TEXT,
+            ),
+          );
+          assert.isFalse(
+            harness.events.some(
+              (event) =>
+                event.type === "subagent.updated" ||
+                (event.type === "node.updated" && event.node.kind === "subagent"),
+            ),
+          );
+          assert.isFalse(
+            harness.events.some(
+              (event) =>
+                event.type !== "provider_thread.updated" &&
+                JSON.stringify(event).includes(WAKE_TASK_ID),
+            ),
+          );
+          assert.isFalse(yield* harness.hasPendingBackgroundWork);
+        }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+      ),
+  );
+
+  it.effect("resets Waiting roster and wake eligibility when the CLI process is replaced", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const fileSystem = yield* FileSystem.FileSystem;
+        const idAllocator = yield* IdAllocatorV2;
+        const attachmentsDir = yield* fileSystem.makeTempDirectoryScoped({
+          prefix: "t3-claude-v2-process-reset-",
+        });
+        const processQueues: Array<Queue.Queue<SDKMessage>> = [];
+        const events: Array<ProviderAdapterV2Event> = [];
+        const continuationRequests: Array<ProviderContinuationRequest> = [];
+        const adapter = makeClaudeAdapterV2({
+          instanceId: CLAUDE_DEFAULT_INSTANCE_ID,
+          settings: DEFAULT_CLAUDE_SETTINGS,
+          environment: {},
+          attachmentsDir,
+          fileSystem,
+          idAllocator,
+          continuationRequests: {
+            offer: (request) =>
+              Effect.sync(() => {
+                continuationRequests.push(request);
+              }),
+          },
+          queryRunner: {
+            allocateSessionId: Effect.succeed(WAKE_NATIVE_SESSION),
+            open: () =>
+              Effect.gen(function* () {
+                const sdkMessages = yield* Queue.unbounded<SDKMessage>();
+                processQueues.push(sdkMessages);
+                return {
+                  messages: Stream.fromQueue(sdkMessages),
+                  offer: () => Effect.void,
+                  setModel: () => Effect.void,
+                  interrupt: Effect.void,
+                  // End this process stream so openQuery can replace it.
+                  close: Queue.shutdown(sdkMessages),
+                };
+              }),
+            forkSession: () => Effect.die("unused forkSession"),
+            assertComplete: Effect.void,
+          },
+        });
+        const threadId = ThreadId.make("thread-claude-process-reset");
+        const runtime = yield* adapter.openSession({
+          threadId,
+          providerSessionId: ProviderSessionId.make("provider-session-claude-process-reset"),
+          modelSelection: CLAUDE_TEST_MODEL_SELECTION,
+          runtimePolicy: CLAUDE_TEST_RUNTIME_POLICY,
+        });
+        const providerThread = yield* runtime.ensureThread({
+          threadId,
+          modelSelection: CLAUDE_TEST_MODEL_SELECTION,
+          runtimePolicy: CLAUDE_TEST_RUNTIME_POLICY,
+        });
+        yield* runtime.events.pipe(
+          Stream.runForEach((event) =>
+            Effect.sync(() => {
+              events.push(event);
+            }),
+          ),
+          Effect.forkScoped,
+        );
+        if (runtime.hasPendingBackgroundWork === undefined) {
+          return yield* Effect.die("Claude adapter runtime must expose hasPendingBackgroundWork.");
+        }
+        const hasPendingBackgroundWork = runtime.hasPendingBackgroundWork;
+        const now = yield* DateTime.now;
+
+        yield* runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId,
+            providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-process-reset-a"),
+            text: "Run the build in the background.",
+            attachments: [],
+          }),
+        );
+        assert.equal(processQueues.length, 1);
+        const firstProcess = processQueues[0]!;
+        yield* Queue.offer(firstProcess, wakeTaskStarted);
+        yield* Queue.offer(firstProcess, turnOneResult);
+        yield* awaitUntil(
+          () => events.some((event) => event.type === "turn.terminal"),
+          "first turn terminal",
+        );
+        assert.isTrue(yield* hasPendingBackgroundWork);
+
+        const alternateModel = {
+          ...CLAUDE_TEST_MODEL_SELECTION,
+          model: "claude-haiku-4-5-20251001",
+        } satisfies ModelSelection;
+        // ProviderTurnStartService marks the thread active before startTurn;
+        // the process-reset clear must preserve that status.
+        const activeProviderThread = {
+          ...providerThread,
+          status: "active" as const,
+        } satisfies OrchestrationV2ProviderThread;
+        yield* runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId,
+            providerThread: activeProviderThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-process-reset-b"),
+            text: "Continue after process restart.",
+            attachments: [],
+            providerTurnOrdinal: 2,
+            modelSelection: alternateModel,
+          }),
+        );
+        assert.equal(processQueues.length, 2);
+
+        // Process-scoped level resets to empty on CLI (re)start while the
+        // starting turn's provider thread remains active (not idle).
+        yield* awaitUntil(
+          () =>
+            providerThreadRosterEvents(events).some(
+              (event) =>
+                event.providerThread.status === "active" &&
+                (event.providerThread.pendingBackgroundTasks?.length ?? 0) === 0 &&
+                // Prefer the post-replace clear over the initial empty thread.
+                event.providerThread.updatedAt !== undefined,
+            ),
+          "roster cleared on process replace while remaining active",
+        );
+        // After replace, the in-memory Waiting probe must be false even if a
+        // late empty-level event was already present before background work.
+        assert.isFalse(yield* hasPendingBackgroundWork);
+        const emptyActiveRosterEvents = providerThreadRosterEvents(events).filter(
+          (event) =>
+            event.providerThread.status === "active" &&
+            (event.providerThread.pendingBackgroundTasks?.length ?? 0) === 0,
+        );
+        assert.isAtLeast(emptyActiveRosterEvents.length, 1);
+        assert.deepEqual(
+          emptyActiveRosterEvents.at(-1)?.providerThread.pendingBackgroundTasks ?? [],
+          [],
+        );
+        assert.equal(emptyActiveRosterEvents.at(-1)?.providerThread.status, "active");
+
+        // A late notification from the previous process must not wake after
+        // eligibility was reset with the process. Offer on the new process
+        // stream (the old queue is shut down).
+        const secondProcess = processQueues[1]!;
+        yield* Queue.offer(secondProcess, wakeNotification);
+        let settleYields = 0;
+        yield* awaitUntil(() => settleYields++ >= 50, "stale notification settle");
+        assert.lengthOf(continuationRequests, 0);
+
+        yield* Queue.offer(
+          secondProcess,
+          makeResultFrame({
+            uuid: "00000000-0000-4000-8000-000000000602",
+            result: "Process restart turn finished.",
+          }),
+        );
+        yield* awaitUntil(
+          () => events.filter((event) => event.type === "turn.terminal").length === 2,
+          "second turn terminal",
+        );
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  it.effect("admits only local_bash from a mixed background_tasks_changed snapshot", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const harness = yield* makeWakeHarness;
+        const now = yield* DateTime.now;
+        const SUBAGENT_TASK_ID = "task-mixed-snapshot-subagent";
+        const SUBAGENT_TOOL_USE_ID = "toolu-mixed-snapshot-subagent";
+        const mixedSnapshot = claudeSdkFrame({
+          type: "system",
+          subtype: "background_tasks_changed",
+          tasks: [
+            {
+              task_id: WAKE_TASK_ID,
+              description: "npm run build",
+              task_type: "local_bash",
+            },
+            {
+              task_id: SUBAGENT_TASK_ID,
+              description: "Agent review",
+              task_type: "local_agent",
+            },
+            {
+              task_id: "task-mixed-foreground-agent",
+              description: "Backgrounded foreground agent",
+              task_type: "local_agent",
+            },
+          ],
+          uuid: "00000000-0000-4000-8000-000000000603",
+          session_id: WAKE_NATIVE_SESSION,
+        });
+        const subagentTaskStarted = claudeSdkFrame({
+          type: "system",
+          subtype: "task_started",
+          task_id: SUBAGENT_TASK_ID,
+          tool_use_id: SUBAGENT_TOOL_USE_ID,
+          description: "Agent review",
+          subagent_type: "general-purpose",
+          task_type: "local_agent",
+          prompt: "Review the change.",
+          uuid: "00000000-0000-4000-8000-000000000604",
+          session_id: WAKE_NATIVE_SESSION,
+        });
+
+        yield* harness.runtime.startTurn(
+          makeClaudeTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-claude-mixed-snapshot"),
+            text: "Background a bash task and a subagent.",
+            attachments: [],
+          }),
+        );
+        yield* Queue.offer(harness.sdkMessages, subagentTaskStarted);
+        yield* awaitUntil(
+          () =>
+            harness.events.some(
+              (event) =>
+                event.type === "subagent.updated" &&
+                event.subagent.nativeTaskRef?.nativeId === SUBAGENT_TASK_ID,
+            ),
+          "subagent projected normally",
+        );
+        yield* Queue.offer(harness.sdkMessages, mixedSnapshot);
+        yield* awaitUntil(
+          () =>
+            providerThreadRosterEvents(harness.events).some(
+              (event) => (event.providerThread.pendingBackgroundTasks?.length ?? 0) > 0,
+            ),
+          "roster after mixed snapshot",
+        );
+
+        const roster = providerThreadRosterEvents(harness.events).at(-1)?.providerThread
+          .pendingBackgroundTasks;
+        assert.deepEqual(roster ?? [], [
+          {
+            taskId: WAKE_TASK_ID,
+            description: "npm run build",
+            taskType: "local_bash",
+          },
+        ]);
+        // Subagent lifecycle stays on the subagent path, not the Waiting roster.
+        assert.isTrue(
+          harness.events.some(
+            (event) =>
+              event.type === "subagent.updated" &&
+              event.subagent.nativeTaskRef?.nativeId === SUBAGENT_TASK_ID &&
+              event.subagent.status === "running",
+          ),
+        );
+        assert.isFalse((roster ?? []).some((task) => task.taskId === SUBAGENT_TASK_ID));
+
+        yield* Queue.offer(harness.sdkMessages, turnOneResult);
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "turn terminal");
+        assert.isTrue(yield* harness.hasPendingBackgroundWork);
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  it.effect(
+    "preserves buffered local_bash notification classification across model/policy query replacement",
+    () =>
+      Effect.scoped(
+        Effect.gen(function* () {
+          const fileSystem = yield* FileSystem.FileSystem;
+          const idAllocator = yield* IdAllocatorV2;
+          const attachmentsDir = yield* fileSystem.makeTempDirectoryScoped({
+            prefix: "t3-claude-v2-buffer-replace-",
+          });
+          const processQueues: Array<Queue.Queue<SDKMessage>> = [];
+          const events: Array<ProviderAdapterV2Event> = [];
+          const continuationRequests: Array<ProviderContinuationRequest> = [];
+          const adapter = makeClaudeAdapterV2({
+            instanceId: CLAUDE_DEFAULT_INSTANCE_ID,
+            settings: DEFAULT_CLAUDE_SETTINGS,
+            environment: {},
+            attachmentsDir,
+            fileSystem,
+            idAllocator,
+            continuationRequests: {
+              offer: (request) =>
+                Effect.sync(() => {
+                  continuationRequests.push(request);
+                }),
+            },
+            queryRunner: {
+              allocateSessionId: Effect.succeed(WAKE_NATIVE_SESSION),
+              open: () =>
+                Effect.gen(function* () {
+                  const sdkMessages = yield* Queue.unbounded<SDKMessage>();
+                  processQueues.push(sdkMessages);
+                  return {
+                    messages: Stream.fromQueue(sdkMessages),
+                    offer: () => Effect.void,
+                    setModel: () => Effect.void,
+                    interrupt: Effect.void,
+                    close: Queue.shutdown(sdkMessages),
+                  };
+                }),
+              forkSession: () => Effect.die("unused forkSession"),
+              assertComplete: Effect.void,
+            },
+          });
+          const threadId = ThreadId.make("thread-claude-buffer-replace");
+          const runtime = yield* adapter.openSession({
+            threadId,
+            providerSessionId: ProviderSessionId.make("provider-session-claude-buffer-replace"),
+            modelSelection: CLAUDE_TEST_MODEL_SELECTION,
+            runtimePolicy: CLAUDE_TEST_RUNTIME_POLICY,
+          });
+          const providerThread = yield* runtime.ensureThread({
+            threadId,
+            modelSelection: CLAUDE_TEST_MODEL_SELECTION,
+            runtimePolicy: CLAUDE_TEST_RUNTIME_POLICY,
+          });
+          yield* runtime.events.pipe(
+            Stream.runForEach((event) =>
+              Effect.sync(() => {
+                events.push(event);
+              }),
+            ),
+            Effect.forkScoped,
+          );
+          if (runtime.hasPendingBackgroundWork === undefined) {
+            return yield* Effect.die(
+              "Claude adapter runtime must expose hasPendingBackgroundWork.",
+            );
+          }
+          const hasPendingBackgroundWork = runtime.hasPendingBackgroundWork;
+          const now = yield* DateTime.now;
+
+          yield* runtime.startTurn(
+            makeClaudeTestTurnInput({
+              threadId,
+              providerThread,
+              now,
+              attemptId: RunAttemptId.make("attempt-claude-buffer-replace-a"),
+              text: "Run the build in the background.",
+              attachments: [],
+            }),
+          );
+          assert.equal(processQueues.length, 1);
+          const firstProcess = processQueues[0]!;
+          yield* Queue.offer(firstProcess, wakeTaskStarted);
+          yield* Queue.offer(firstProcess, turnOneResult);
+          yield* awaitUntil(
+            () => events.some((event) => event.type === "turn.terminal"),
+            "first turn terminal",
+          );
+          assert.isTrue(yield* hasPendingBackgroundWork);
+
+          // Idle completion notification buffers before any continuation runs.
+          yield* Queue.offer(firstProcess, wakeNotification);
+          let quietYields = 0;
+          yield* awaitUntil(() => quietYields++ >= 50, "notification-only quiet window");
+          assert.lengthOf(continuationRequests, 0);
+
+          // User turn changes model, replacing the query while the wake buffer
+          // stays queued for the later provider continuation.
+          const alternateModel = {
+            ...CLAUDE_TEST_MODEL_SELECTION,
+            model: "claude-haiku-4-5-20251001",
+          } satisfies ModelSelection;
+          yield* runtime.startTurn(
+            makeClaudeTestTurnInput({
+              threadId,
+              providerThread: { ...providerThread, status: "active" },
+              now,
+              attemptId: RunAttemptId.make("attempt-claude-buffer-replace-user"),
+              text: "Switch model while background work completes.",
+              attachments: [],
+              providerTurnOrdinal: 2,
+              modelSelection: alternateModel,
+            }),
+          );
+          assert.equal(processQueues.length, 2);
+          const secondProcess = processQueues[1]!;
+          yield* Queue.offer(
+            secondProcess,
+            makeResultFrame({
+              uuid: "00000000-0000-4000-8000-000000000701",
+              result: "User turn finished after model switch.",
+            }),
+          );
+          yield* awaitUntil(
+            () => events.filter((event) => event.type === "turn.terminal").length === 2,
+            "user turn terminal after replace",
+          );
+          // The terminal notification remains buffered for classification, but
+          // notification-only traffic no longer pins pending work.
+          assert.isFalse(yield* hasPendingBackgroundWork);
+          assert.lengthOf(continuationRequests, 0);
+
+          // Continuation drains the buffered local_bash notification with no
+          // fabricated subagent/node and attributes the wake result text.
+          yield* Queue.offer(secondProcess, wakeResult);
+          yield* awaitUntil(() => continuationRequests.length === 1, "continuation after result");
+          assert.equal(continuationRequests[0]?.detail, WAKE_SUMMARY);
+          yield* runtime.startTurn(
+            makeClaudeTestTurnInput({
+              threadId,
+              providerThread: { ...providerThread, status: "active" },
+              now,
+              attemptId: RunAttemptId.make("attempt-claude-buffer-replace-cont"),
+              text: "Background task completed.",
+              attachments: [],
+              providerTurnOrdinal: 3,
+              modelSelection: alternateModel,
+              messageCreatedBy: "agent",
+              messageCreationSource: "provider",
+            }),
+          );
+          yield* awaitUntil(
+            () => events.filter((event) => event.type === "turn.terminal").length === 3,
+            "continuation terminal after buffered drain",
+          );
+          assert.isTrue(
+            events.some(
+              (event) =>
+                event.type === "message.updated" && event.message.text === WAKE_RESULT_TEXT,
+            ),
+          );
+          assert.isFalse(
+            events.some(
+              (event) =>
+                event.type === "subagent.updated" ||
+                (event.type === "node.updated" && event.node.kind === "subagent"),
+            ),
+          );
+          // Must not re-project the opaque task id as anything but roster history.
+          assert.isFalse(
+            events.some(
+              (event) =>
+                event.type !== "provider_thread.updated" &&
+                JSON.stringify(event).includes(WAKE_TASK_ID),
+            ),
+          );
+          assert.isFalse(yield* hasPendingBackgroundWork);
+        }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+      ),
+  );
+
+  it.effect(
+    "does not opaque-misclassify a buffered subagent notification across model/policy query replacement",
+    () =>
+      Effect.scoped(
+        Effect.gen(function* () {
+          const SUBAGENT_TASK_ID = "task-buffer-replace-subagent";
+          const SUBAGENT_TOOL_USE_ID = "toolu-buffer-replace-subagent";
+          const SUBAGENT_SUMMARY = "SUB_BUFFER_REPLACE_DONE";
+          const subagentTaskStarted = claudeSdkFrame({
+            type: "system",
+            subtype: "task_started",
+            task_id: SUBAGENT_TASK_ID,
+            tool_use_id: SUBAGENT_TOOL_USE_ID,
+            description: "Background research",
+            subagent_type: "general-purpose",
+            task_type: "local_agent",
+            prompt: "Research then return SUB_BUFFER_REPLACE_DONE.",
+            uuid: "00000000-0000-4000-8000-000000000801",
+            session_id: WAKE_NATIVE_SESSION,
+          });
+          const subagentNotification = claudeSdkFrame({
+            type: "system",
+            subtype: "task_notification",
+            task_id: SUBAGENT_TASK_ID,
+            tool_use_id: SUBAGENT_TOOL_USE_ID,
+            status: "completed",
+            output_file: "/tmp/task-buffer-replace-subagent.output",
+            summary: SUBAGENT_SUMMARY,
+            uuid: "00000000-0000-4000-8000-000000000802",
+            session_id: WAKE_NATIVE_SESSION,
+          });
+          const subagentAsyncAck = claudeSdkFrame({
+            type: "user",
+            message: {
+              role: "user",
+              content: [
+                {
+                  type: "tool_result",
+                  tool_use_id: SUBAGENT_TOOL_USE_ID,
+                  content: [{ type: "text", text: "Async agent launched successfully." }],
+                },
+              ],
+            },
+            parent_tool_use_id: null,
+            uuid: "00000000-0000-4000-8000-000000000803",
+            session_id: WAKE_NATIVE_SESSION,
+            tool_use_result: {
+              isAsync: true,
+              status: "async_launched",
+              agentId: SUBAGENT_TASK_ID,
+              prompt: "Research then return SUB_BUFFER_REPLACE_DONE.",
+            },
+          });
+
+          const fileSystem = yield* FileSystem.FileSystem;
+          const idAllocator = yield* IdAllocatorV2;
+          const attachmentsDir = yield* fileSystem.makeTempDirectoryScoped({
+            prefix: "t3-claude-v2-subagent-buffer-replace-",
+          });
+          const processQueues: Array<Queue.Queue<SDKMessage>> = [];
+          const events: Array<ProviderAdapterV2Event> = [];
+          const continuationRequests: Array<ProviderContinuationRequest> = [];
+          const adapter = makeClaudeAdapterV2({
+            instanceId: CLAUDE_DEFAULT_INSTANCE_ID,
+            settings: DEFAULT_CLAUDE_SETTINGS,
+            environment: {},
+            attachmentsDir,
+            fileSystem,
+            idAllocator,
+            continuationRequests: {
+              offer: (request) =>
+                Effect.sync(() => {
+                  continuationRequests.push(request);
+                }),
+            },
+            queryRunner: {
+              allocateSessionId: Effect.succeed(WAKE_NATIVE_SESSION),
+              open: () =>
+                Effect.gen(function* () {
+                  const sdkMessages = yield* Queue.unbounded<SDKMessage>();
+                  processQueues.push(sdkMessages);
+                  return {
+                    messages: Stream.fromQueue(sdkMessages),
+                    offer: () => Effect.void,
+                    setModel: () => Effect.void,
+                    interrupt: Effect.void,
+                    close: Queue.shutdown(sdkMessages),
+                  };
+                }),
+              forkSession: () => Effect.die("unused forkSession"),
+              assertComplete: Effect.void,
+            },
+          });
+          const threadId = ThreadId.make("thread-claude-subagent-buffer-replace");
+          const runtime = yield* adapter.openSession({
+            threadId,
+            providerSessionId: ProviderSessionId.make(
+              "provider-session-claude-subagent-buffer-replace",
+            ),
+            modelSelection: CLAUDE_TEST_MODEL_SELECTION,
+            runtimePolicy: CLAUDE_TEST_RUNTIME_POLICY,
+          });
+          const providerThread = yield* runtime.ensureThread({
+            threadId,
+            modelSelection: CLAUDE_TEST_MODEL_SELECTION,
+            runtimePolicy: CLAUDE_TEST_RUNTIME_POLICY,
+          });
+          yield* runtime.events.pipe(
+            Stream.runForEach((event) =>
+              Effect.sync(() => {
+                events.push(event);
+              }),
+            ),
+            Effect.forkScoped,
+          );
+          if (runtime.hasPendingBackgroundWork === undefined) {
+            return yield* Effect.die(
+              "Claude adapter runtime must expose hasPendingBackgroundWork.",
+            );
+          }
+          const hasPendingBackgroundWork = runtime.hasPendingBackgroundWork;
+          const subagentEvents = () =>
+            events.filter(
+              (event): event is Extract<ProviderAdapterV2Event, { type: "subagent.updated" }> =>
+                event.type === "subagent.updated",
+            );
+          const now = yield* DateTime.now;
+
+          yield* runtime.startTurn(
+            makeClaudeTestTurnInput({
+              threadId,
+              providerThread,
+              now,
+              attemptId: RunAttemptId.make("attempt-claude-subagent-buffer-replace-a"),
+              text: "Spawn a background subagent and stop.",
+              attachments: [],
+            }),
+          );
+          assert.equal(processQueues.length, 1);
+          const firstProcess = processQueues[0]!;
+          yield* Queue.offer(firstProcess, subagentTaskStarted);
+          yield* awaitUntil(() => subagentEvents().length >= 1, "subagent node created");
+          assert.equal(subagentEvents()[0]?.subagent.status, "running");
+          yield* Queue.offer(firstProcess, subagentAsyncAck);
+          yield* Queue.offer(
+            firstProcess,
+            makeResultFrame({
+              uuid: "00000000-0000-4000-8000-000000000804",
+              result: "Spawned the subagent in the background.",
+            }),
+          );
+          yield* awaitUntil(
+            () => events.some((event) => event.type === "turn.terminal"),
+            "first turn terminal",
+          );
+          assert.isTrue(yield* hasPendingBackgroundWork);
+
+          // Session-registered subagent completion buffers; no opaque tombstone.
+          yield* Queue.offer(firstProcess, subagentNotification);
+          yield* awaitUntil(() => continuationRequests.length === 1, "continuation after notify");
+          assert.equal(continuationRequests[0]?.detail, SUBAGENT_SUMMARY);
+
+          // Model-changing user turn replaces the query while continuation stays
+          // queued. Process reset must not invent opaque classification for the
+          // buffered subagent notification.
+          const alternateModel = {
+            ...CLAUDE_TEST_MODEL_SELECTION,
+            model: "claude-haiku-4-5-20251001",
+          } satisfies ModelSelection;
+          yield* runtime.startTurn(
+            makeClaudeTestTurnInput({
+              threadId,
+              providerThread: { ...providerThread, status: "active" },
+              now,
+              attemptId: RunAttemptId.make("attempt-claude-subagent-buffer-replace-user"),
+              text: "Switch model while the subagent completes.",
+              attachments: [],
+              providerTurnOrdinal: 2,
+              modelSelection: alternateModel,
+            }),
+          );
+          assert.equal(processQueues.length, 2);
+          const secondProcess = processQueues[1]!;
+          yield* Queue.offer(
+            secondProcess,
+            makeResultFrame({
+              uuid: "00000000-0000-4000-8000-000000000805",
+              result: "User turn finished after model switch.",
+            }),
+          );
+          yield* awaitUntil(
+            () => events.filter((event) => event.type === "turn.terminal").length === 2,
+            "user turn terminal after replace",
+          );
+          assert.isTrue(yield* hasPendingBackgroundWork);
+          assert.lengthOf(continuationRequests, 1);
+
+          yield* Queue.offer(
+            secondProcess,
+            makeResultFrame({
+              uuid: "00000000-0000-4000-8000-000000000806",
+              result: "The subagent finished with SUB_BUFFER_REPLACE_DONE.",
+            }),
+          );
+          yield* runtime.startTurn(
+            makeClaudeTestTurnInput({
+              threadId,
+              providerThread: { ...providerThread, status: "active" },
+              now,
+              attemptId: RunAttemptId.make("attempt-claude-subagent-buffer-replace-cont"),
+              text: "Background task completed.",
+              attachments: [],
+              providerTurnOrdinal: 3,
+              modelSelection: alternateModel,
+              messageCreatedBy: "agent",
+              messageCreationSource: "provider",
+            }),
+          );
+          yield* awaitUntil(
+            () => events.filter((event) => event.type === "turn.terminal").length === 3,
+            "continuation terminal after buffered subagent drain",
+          );
+
+          const finalSubagent = subagentEvents().at(-1)?.subagent;
+          assert.equal(finalSubagent?.status, "completed");
+          assert.equal(finalSubagent?.result, SUBAGENT_SUMMARY);
+          assert.equal(finalSubagent?.runId, subagentEvents()[0]?.subagent.runId);
+          const subagentNodeEvents = events.filter(
+            (event): event is Extract<ProviderAdapterV2Event, { type: "node.updated" }> =>
+              event.type === "node.updated" &&
+              event.node.kind === "subagent" &&
+              event.node.nativeItemRef?.nativeId === SUBAGENT_TASK_ID,
+          );
+          assert.equal(subagentNodeEvents.at(-1)?.node.status, "completed");
+          assert.isFalse(yield* hasPendingBackgroundWork);
+        }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+      ),
+  );
+
+  it.effect(
+    "clears process-scoped roster when same-native-thread replacement open fails after close",
+    () =>
+      Effect.scoped(
+        Effect.gen(function* () {
+          const fileSystem = yield* FileSystem.FileSystem;
+          const idAllocator = yield* IdAllocatorV2;
+          const attachmentsDir = yield* fileSystem.makeTempDirectoryScoped({
+            prefix: "t3-claude-v2-replace-open-fail-",
+          });
+          let openCount = 0;
+          const processQueues: Array<Queue.Queue<SDKMessage>> = [];
+          const events: Array<ProviderAdapterV2Event> = [];
+          const adapter = makeClaudeAdapterV2({
+            instanceId: CLAUDE_DEFAULT_INSTANCE_ID,
+            settings: DEFAULT_CLAUDE_SETTINGS,
+            environment: {},
+            attachmentsDir,
+            fileSystem,
+            idAllocator,
+            continuationRequests: {
+              offer: () => Effect.void,
+            },
+            queryRunner: {
+              allocateSessionId: Effect.succeed(WAKE_NATIVE_SESSION),
+              open: () => {
+                openCount += 1;
+                if (openCount === 2) {
+                  return Effect.fail(
+                    new ClaudeAgentSdkQueryRunnerError({
+                      method: "open",
+                      cause: "forced replacement open failure",
+                    }),
+                  );
+                }
+                return Effect.gen(function* () {
+                  const sdkMessages = yield* Queue.unbounded<SDKMessage>();
+                  processQueues.push(sdkMessages);
+                  return {
+                    messages: Stream.fromQueue(sdkMessages),
+                    offer: () => Effect.void,
+                    setModel: () => Effect.void,
+                    interrupt: Effect.void,
+                    close: Queue.shutdown(sdkMessages),
+                  };
+                });
+              },
+              forkSession: () => Effect.die("unused forkSession"),
+              assertComplete: Effect.void,
+            },
+          });
+          const threadId = ThreadId.make("thread-claude-replace-open-fail");
+          const runtime = yield* adapter.openSession({
+            threadId,
+            providerSessionId: ProviderSessionId.make("provider-session-claude-replace-open-fail"),
+            modelSelection: CLAUDE_TEST_MODEL_SELECTION,
+            runtimePolicy: CLAUDE_TEST_RUNTIME_POLICY,
+          });
+          const providerThread = yield* runtime.ensureThread({
+            threadId,
+            modelSelection: CLAUDE_TEST_MODEL_SELECTION,
+            runtimePolicy: CLAUDE_TEST_RUNTIME_POLICY,
+          });
+          yield* runtime.events.pipe(
+            Stream.runForEach((event) =>
+              Effect.sync(() => {
+                events.push(event);
+              }),
+            ),
+            Effect.forkScoped,
+          );
+          if (runtime.hasPendingBackgroundWork === undefined) {
+            return yield* Effect.die(
+              "Claude adapter runtime must expose hasPendingBackgroundWork.",
+            );
+          }
+          const hasPendingBackgroundWork = runtime.hasPendingBackgroundWork;
+          const now = yield* DateTime.now;
+
+          yield* runtime.startTurn(
+            makeClaudeTestTurnInput({
+              threadId,
+              providerThread,
+              now,
+              attemptId: RunAttemptId.make("attempt-claude-replace-open-fail-a"),
+              text: "Run the build in the background.",
+              attachments: [],
+            }),
+          );
+          assert.equal(processQueues.length, 1);
+          yield* Queue.offer(processQueues[0]!, wakeTaskStarted);
+          yield* Queue.offer(processQueues[0]!, turnOneResult);
+          yield* awaitUntil(
+            () => events.some((event) => event.type === "turn.terminal"),
+            "first turn terminal",
+          );
+          assert.isTrue(yield* hasPendingBackgroundWork);
+
+          const alternateModel = {
+            ...CLAUDE_TEST_MODEL_SELECTION,
+            model: "claude-haiku-4-5-20251001",
+          } satisfies ModelSelection;
+          const failedStart = yield* runtime
+            .startTurn(
+              makeClaudeTestTurnInput({
+                threadId,
+                providerThread: { ...providerThread, status: "active" },
+                now,
+                attemptId: RunAttemptId.make("attempt-claude-replace-open-fail-b"),
+                text: "Replace process but fail open.",
+                attachments: [],
+                providerTurnOrdinal: 2,
+                modelSelection: alternateModel,
+              }),
+            )
+            .pipe(Effect.exit);
+          assert.isTrue(Exit.isFailure(failedStart));
+          // Old process was closed before the failed open: roster must not stick.
+          yield* awaitUntil(
+            () =>
+              providerThreadRosterEvents(events).some(
+                (event) =>
+                  event.providerThread.status === "idle" &&
+                  (event.providerThread.pendingBackgroundTasks?.length ?? 0) === 0,
+              ),
+            "roster cleared after failed same-thread replacement open",
+          );
+          assert.isFalse(yield* hasPendingBackgroundWork);
+        }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+      ),
+  );
+
+  it.effect(
+    "clears buffered wake and continuation state when same-native-thread replacement open fails",
+    () =>
+      Effect.scoped(
+        Effect.gen(function* () {
+          const fileSystem = yield* FileSystem.FileSystem;
+          const idAllocator = yield* IdAllocatorV2;
+          const attachmentsDir = yield* fileSystem.makeTempDirectoryScoped({
+            prefix: "t3-claude-v2-replace-open-fail-wake-",
+          });
+          let openCount = 0;
+          const processQueues: Array<Queue.Queue<SDKMessage>> = [];
+          const events: Array<ProviderAdapterV2Event> = [];
+          const continuationRequests: Array<ProviderContinuationRequest> = [];
+          const adapter = makeClaudeAdapterV2({
+            instanceId: CLAUDE_DEFAULT_INSTANCE_ID,
+            settings: DEFAULT_CLAUDE_SETTINGS,
+            environment: {},
+            attachmentsDir,
+            fileSystem,
+            idAllocator,
+            continuationRequests: {
+              offer: (request) =>
+                Effect.sync(() => {
+                  continuationRequests.push(request);
+                }),
+            },
+            queryRunner: {
+              allocateSessionId: Effect.succeed(WAKE_NATIVE_SESSION),
+              open: () => {
+                openCount += 1;
+                if (openCount === 2) {
+                  return Effect.fail(
+                    new ClaudeAgentSdkQueryRunnerError({
+                      method: "open",
+                      cause: "forced replacement open failure",
+                    }),
+                  );
+                }
+                return Effect.gen(function* () {
+                  const sdkMessages = yield* Queue.unbounded<SDKMessage>();
+                  processQueues.push(sdkMessages);
+                  return {
+                    messages: Stream.fromQueue(sdkMessages),
+                    offer: () => Effect.void,
+                    setModel: () => Effect.void,
+                    interrupt: Effect.void,
+                    close: Queue.shutdown(sdkMessages),
+                  };
+                });
+              },
+              forkSession: () => Effect.die("unused forkSession"),
+              assertComplete: Effect.void,
+            },
+          });
+          const threadId = ThreadId.make("thread-claude-replace-open-fail-wake");
+          const runtime = yield* adapter.openSession({
+            threadId,
+            providerSessionId: ProviderSessionId.make(
+              "provider-session-claude-replace-open-fail-wake",
+            ),
+            modelSelection: CLAUDE_TEST_MODEL_SELECTION,
+            runtimePolicy: CLAUDE_TEST_RUNTIME_POLICY,
+          });
+          const providerThread = yield* runtime.ensureThread({
+            threadId,
+            modelSelection: CLAUDE_TEST_MODEL_SELECTION,
+            runtimePolicy: CLAUDE_TEST_RUNTIME_POLICY,
+          });
+          yield* runtime.events.pipe(
+            Stream.runForEach((event) =>
+              Effect.sync(() => {
+                events.push(event);
+              }),
+            ),
+            Effect.forkScoped,
+          );
+          if (runtime.hasPendingBackgroundWork === undefined) {
+            return yield* Effect.die(
+              "Claude adapter runtime must expose hasPendingBackgroundWork.",
+            );
+          }
+          const hasPendingBackgroundWork = runtime.hasPendingBackgroundWork;
+          const now = yield* DateTime.now;
+
+          yield* runtime.startTurn(
+            makeClaudeTestTurnInput({
+              threadId,
+              providerThread,
+              now,
+              attemptId: RunAttemptId.make("attempt-claude-replace-open-fail-wake-a"),
+              text: "Run the build in the background.",
+              attachments: [],
+            }),
+          );
+          yield* Queue.offer(processQueues[0]!, wakeTaskStarted);
+          yield* Queue.offer(processQueues[0]!, turnOneResult);
+          yield* awaitUntil(
+            () => events.filter((event) => event.type === "turn.terminal").length === 1,
+            "first turn terminal",
+          );
+          yield* Queue.offer(processQueues[0]!, wakeNotification);
+          yield* Queue.offer(processQueues[0]!, wakeAssistant);
+          yield* awaitUntil(() => continuationRequests.length === 1, "first continuation request");
+          assert.isTrue(yield* hasPendingBackgroundWork);
+
+          const alternateModel = {
+            ...CLAUDE_TEST_MODEL_SELECTION,
+            model: "claude-haiku-4-5-20251001",
+          } satisfies ModelSelection;
+          const failedStart = yield* runtime
+            .startTurn(
+              makeClaudeTestTurnInput({
+                threadId,
+                providerThread: { ...providerThread, status: "active" },
+                now,
+                attemptId: RunAttemptId.make("attempt-claude-replace-open-fail-wake-b"),
+                text: "Replace process but fail open.",
+                attachments: [],
+                providerTurnOrdinal: 2,
+                modelSelection: alternateModel,
+              }),
+            )
+            .pipe(Effect.exit);
+          assert.isTrue(Exit.isFailure(failedStart));
+          assert.isFalse(yield* hasPendingBackgroundWork);
+
+          yield* runtime.startTurn(
+            makeClaudeTestTurnInput({
+              threadId,
+              providerThread: { ...providerThread, status: "active" },
+              now,
+              attemptId: RunAttemptId.make("attempt-claude-replace-open-fail-wake-c"),
+              text: "Retry after the failed replacement.",
+              attachments: [],
+              providerTurnOrdinal: 2,
+              modelSelection: alternateModel,
+            }),
+          );
+          const retryProcess = processQueues[1]!;
+          const retryTaskId = "task-wake-build-after-retry";
+          yield* Queue.offer(
+            retryProcess,
+            claudeSdkFrame({
+              type: "system",
+              subtype: "task_started",
+              task_id: retryTaskId,
+              description: "npm run build after retry",
+              task_type: "local_bash",
+              uuid: "00000000-0000-4000-8000-000000000901",
+              session_id: WAKE_NATIVE_SESSION,
+            }),
+          );
+          yield* Queue.offer(
+            retryProcess,
+            makeResultFrame({
+              uuid: "00000000-0000-4000-8000-000000000902",
+              result: "Kicked off the retry build in the background.",
+            }),
+          );
+          yield* awaitUntil(
+            () => events.filter((event) => event.type === "turn.terminal").length === 2,
+            "retry turn terminal",
+          );
+          yield* Queue.offer(
+            retryProcess,
+            claudeSdkFrame({
+              type: "system",
+              subtype: "task_notification",
+              task_id: retryTaskId,
+              status: "completed",
+              output_file: "/tmp/task-wake-build-after-retry.log",
+              summary: "Retry build completed successfully",
+              uuid: "00000000-0000-4000-8000-000000000903",
+              session_id: WAKE_NATIVE_SESSION,
+            }),
+          );
+          yield* Queue.offer(
+            retryProcess,
+            claudeSdkFrame({
+              type: "assistant",
+              message: {
+                role: "assistant",
+                content: [{ type: "text", text: "The retry build has finished." }],
+              },
+              parent_tool_use_id: null,
+              uuid: "00000000-0000-4000-8000-000000000904",
+              session_id: WAKE_NATIVE_SESSION,
+            }),
+          );
+          yield* awaitUntil(
+            () => continuationRequests.length === 2,
+            "continuation request after retry",
+          );
+          assert.equal(continuationRequests[1]?.detail, "Retry build completed successfully");
+        }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+      ),
+  );
+
+  it.effect("does not invent process reset state on a first-ever failed open", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const fileSystem = yield* FileSystem.FileSystem;
+        const idAllocator = yield* IdAllocatorV2;
+        const attachmentsDir = yield* fileSystem.makeTempDirectoryScoped({
+          prefix: "t3-claude-v2-first-open-fail-",
+        });
+        const events: Array<ProviderAdapterV2Event> = [];
+        const adapter = makeClaudeAdapterV2({
+          instanceId: CLAUDE_DEFAULT_INSTANCE_ID,
+          settings: DEFAULT_CLAUDE_SETTINGS,
+          environment: {},
+          attachmentsDir,
+          fileSystem,
+          idAllocator,
+          continuationRequests: {
+            offer: () => Effect.void,
+          },
+          queryRunner: {
+            allocateSessionId: Effect.succeed(WAKE_NATIVE_SESSION),
+            open: () =>
+              Effect.fail(
+                new ClaudeAgentSdkQueryRunnerError({
+                  method: "open",
+                  cause: "forced first open failure",
+                }),
+              ),
+            forkSession: () => Effect.die("unused forkSession"),
+            assertComplete: Effect.void,
+          },
+        });
+        const threadId = ThreadId.make("thread-claude-first-open-fail");
+        const runtime = yield* adapter.openSession({
+          threadId,
+          providerSessionId: ProviderSessionId.make("provider-session-claude-first-open-fail"),
+          modelSelection: CLAUDE_TEST_MODEL_SELECTION,
+          runtimePolicy: CLAUDE_TEST_RUNTIME_POLICY,
+        });
+        const providerThread = yield* runtime.ensureThread({
+          threadId,
+          modelSelection: CLAUDE_TEST_MODEL_SELECTION,
+          runtimePolicy: CLAUDE_TEST_RUNTIME_POLICY,
+        });
+        yield* runtime.events.pipe(
+          Stream.runForEach((event) =>
+            Effect.sync(() => {
+              events.push(event);
+            }),
+          ),
+          Effect.forkScoped,
+        );
+        const now = yield* DateTime.now;
+        const failedStart = yield* runtime
+          .startTurn(
+            makeClaudeTestTurnInput({
+              threadId,
+              providerThread,
+              now,
+              attemptId: RunAttemptId.make("attempt-claude-first-open-fail"),
+              text: "First open fails.",
+              attachments: [],
+            }),
+          )
+          .pipe(Effect.exit);
+        assert.isTrue(Exit.isFailure(failedStart));
+        // No live process ever existed: do not emit a fabricated empty roster.
+        assert.lengthOf(providerThreadRosterEvents(events), 0);
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+});
+
+describe("ClaudeAdapterV2 query message stream", () => {
+  it.effect("closes the query when the message stream is interrupted mid-read", () =>
+    Effect.gen(function* () {
+      let closed = false;
+      let releaseRead = () => {};
+      const readStarted = Promise.withResolvers<void>();
+      // Never yields a message — the read stays pending until close() flips
+      // `closed` and releases the in-flight await.
+      // oxlint-disable-next-line require-yield
+      async function* sdkMessages(): AsyncGenerator<SDKMessage, void> {
+        for (;;) {
+          if (closed) return;
+          await new Promise<void>((resolve) => {
+            releaseRead = resolve;
+            readStarted.resolve();
+          });
+        }
+      }
+      const generator = sdkMessages();
+      const close = () => {
+        closed = true;
+        releaseRead();
+      };
+      const query = {
+        next: () => generator.next(),
+        return: async (value?: void) => {
+          close();
+          return generator.return(value);
+        },
+        throw: (error?: unknown) => generator.throw(error),
+        [Symbol.asyncIterator]: () => generator,
+        close,
+      } as unknown as ClaudeQuery;
+
+      const scope = yield* Scope.make();
+      yield* Stream.fromAsyncIterable(claudeQueryMessages(query), (cause) => cause).pipe(
+        Stream.runForEach(() => Effect.void),
+        Effect.forkIn(scope),
+      );
+      yield* Effect.promise(() => readStarted.promise);
+
+      // Iterating query[Symbol.asyncIterator]() directly deadlocks here:
+      // the raw generator's return() queues behind the in-flight read and
+      // scope close never completes.
+      yield* Scope.close(scope, Exit.void);
+      assert.isTrue(closed);
+    }),
+  );
+});
diff --git a/apps/server/src/orchestration-v2/Adapters/ClaudeAdapterV2.testkit.test.ts b/apps/server/src/orchestration-v2/Adapters/ClaudeAdapterV2.testkit.test.ts
new file mode 100644
index 000000000000..a246a74b3ad5
--- /dev/null
+++ b/apps/server/src/orchestration-v2/Adapters/ClaudeAdapterV2.testkit.test.ts
@@ -0,0 +1,770 @@
+import { assert, describe, it } from "@effect/vitest";
+import {
+  ProviderInstanceId,
+  ProviderSessionId,
+  ThreadId,
+  type ProviderReplayEntry,
+} from "@t3tools/contracts";
+import * as Cause from "effect/Cause";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as Fiber from "effect/Fiber";
+import * as Schema from "effect/Schema";
+import * as Stream from "effect/Stream";
+import { vi } from "vite-plus/test";
+
+import {
+  CLAUDE_PROVIDER,
+  ClaudeAgentSdkQueryRunnerError,
+  makeClaudeUserMessage,
+  type ClaudeAgentSdkQueryOptions,
+} from "./ClaudeAdapterV2.ts";
+import {
+  CLAUDE_AGENT_SDK_REPLAY_PROTOCOL,
+  ClaudeReplayIncompleteError,
+  ClaudeReplayRuntimeExitError,
+  ClaudeReplayUnexpectedOutboundError,
+  makeReplayQueryRunner,
+  recordInterruptedClaudeQuery,
+  recordMessagesUntilTurnResultAndFinalize,
+} from "./ClaudeAdapterV2.testkit.ts";
+import { makeProviderReplayGate } from "../testkit/ProviderReplayGate.testkit.ts";
+
+const isClaudeAgentSdkQueryRunnerError = Schema.is(ClaudeAgentSdkQueryRunnerError);
+const isClaudeReplayIncompleteError = Schema.is(ClaudeReplayIncompleteError);
+const isClaudeReplayRuntimeExitError = Schema.is(ClaudeReplayRuntimeExitError);
+const isClaudeReplayUnexpectedOutboundError = Schema.is(ClaudeReplayUnexpectedOutboundError);
+
+const claudeSdkMock = vi.hoisted(() => {
+  const close = vi.fn();
+  const interrupt = vi.fn(async () => {});
+  let prompt: AsyncIterable<unknown> | undefined;
+  const query = vi.fn((input: { readonly prompt: AsyncIterable<unknown> }) => {
+    prompt = input.prompt;
+    return {
+      [Symbol.asyncIterator]: () => ({
+        next: async () => ({ done: true as const, value: undefined }),
+      }),
+      close,
+      interrupt,
+    };
+  });
+
+  return {
+    close,
+    interrupt,
+    getPrompt: () => prompt,
+    query,
+    reset: () => {
+      close.mockClear();
+      interrupt.mockClear();
+      query.mockClear();
+      prompt = undefined;
+    },
+  };
+});
+
+vi.mock("@anthropic-ai/claude-agent-sdk", () => ({
+  forkSession: vi.fn(),
+  query: claudeSdkMock.query,
+}));
+
+function makeGatedReplaySession() {
+  const options = {
+    model: "claude-sonnet-4-6",
+    tools: [],
+    permissionMode: "default",
+    sessionId: "session-replay-gate",
+  } satisfies ClaudeAgentSdkQueryOptions;
+  const label = "background_tasks_changed:empty";
+  const replayGate = makeProviderReplayGate([label]);
+  const runner = makeReplayQueryRunner(
+    {
+      provider: CLAUDE_PROVIDER,
+      protocol: CLAUDE_AGENT_SDK_REPLAY_PROTOCOL,
+      version: "test",
+      scenario: "labeled-inbound-replay-gate",
+      entries: [
+        {
+          type: "expect_outbound",
+          frame: {
+            type: "query.open",
+            options,
+          },
+        },
+        {
+          type: "emit_inbound",
+          label,
+          frame: {
+            type: "system",
+            subtype: "background_tasks_changed",
+            tasks: [],
+            uuid: "replay-gate-message",
+            session_id: options.sessionId,
+          },
+        },
+        {
+          type: "runtime_exit",
+          status: "success",
+        },
+      ],
+    },
+    { replayGate },
+  );
+  const session = runner.open({
+    options,
+    threadId: ThreadId.make("thread-replay-gate"),
+    providerSessionId: ProviderSessionId.make("provider-session-replay-gate"),
+  });
+  return { label, replayGate, runner, session };
+}
+
+const yieldToReplayStream = Effect.promise(
+  () =>
+    new Promise<void>((resolve) => {
+      setImmediate(resolve);
+    }),
+);
+
+describe("ClaudeAdapterV2 replay testkit", () => {
+  it.effect("holds a labeled inbound frame until its replay gate is released", () =>
+    Effect.gen(function* () {
+      const { label, replayGate, runner, session } = makeGatedReplaySession();
+      const streamFiber = yield* Stream.runDrain(session.messages).pipe(Effect.forkChild);
+
+      yield* yieldToReplayStream;
+      assert.isTrue(replayGate.hasReached(label));
+      assert.isUndefined(streamFiber.pollUnsafe());
+
+      assert.isTrue(replayGate.release(label));
+      yield* Fiber.join(streamFiber);
+      runner.assertComplete();
+    }),
+  );
+
+  it.effect("releases a replay gate when its stream consumer is interrupted", () =>
+    Effect.gen(function* () {
+      const { label, replayGate, session } = makeGatedReplaySession();
+      const streamFiber = yield* Stream.runDrain(session.messages).pipe(Effect.forkChild);
+
+      yield* yieldToReplayStream;
+      assert.isTrue(replayGate.hasReached(label));
+
+      yield* Fiber.interrupt(streamFiber);
+      assert.isFalse(replayGate.release(label));
+    }),
+  );
+
+  it.effect("interrupts a delayed inbound frame without emitting or advancing it", () =>
+    Effect.gen(function* () {
+      const options = {
+        model: "claude-sonnet-4-6",
+        tools: [],
+        permissionMode: "default",
+        sessionId: "session-replay-delayed-interrupt",
+      } satisfies ClaudeAgentSdkQueryOptions;
+      const label = "delayed-inbound";
+      const replayGate = makeProviderReplayGate([label]);
+      const runner = makeReplayQueryRunner(
+        {
+          provider: CLAUDE_PROVIDER,
+          protocol: CLAUDE_AGENT_SDK_REPLAY_PROTOCOL,
+          version: "test",
+          scenario: "delayed-inbound-interruption",
+          entries: [
+            {
+              type: "expect_outbound",
+              frame: {
+                type: "query.open",
+                options,
+              },
+            },
+            {
+              type: "emit_inbound",
+              label,
+              afterMs: 30_000,
+              frame: {
+                type: "assistant",
+                message: { content: [] },
+                parent_tool_use_id: null,
+                session_id: options.sessionId,
+                uuid: "delayed-inbound-message",
+              },
+            },
+            {
+              type: "runtime_exit",
+              status: "success",
+            },
+          ],
+        },
+        { replayGate },
+      );
+      const session = runner.open({
+        options,
+        threadId: ThreadId.make("thread-replay-delayed-interrupt"),
+        providerSessionId: ProviderSessionId.make("provider-session-replay-delayed-interrupt"),
+      });
+      const emittedMessages: Array<unknown> = [];
+      const streamFiber = yield* session.messages.pipe(
+        Stream.tap((message) => Effect.sync(() => emittedMessages.push(message))),
+        Stream.runDrain,
+        Effect.forkChild,
+      );
+
+      yield* yieldToReplayStream;
+      assert.isTrue(replayGate.hasReached(label));
+      assert.isTrue(replayGate.release(label));
+      yield* yieldToReplayStream;
+
+      yield* Fiber.interrupt(streamFiber);
+
+      assert.deepEqual(emittedMessages, []);
+      const incomplete = assert.throws(() => runner.assertComplete());
+      assert.isTrue(isClaudeReplayIncompleteError(incomplete));
+      if (isClaudeReplayIncompleteError(incomplete)) {
+        assert.equal(incomplete.cursor, 1);
+        assert.equal(incomplete.remaining, 2);
+      }
+    }),
+  );
+
+  it.effect("wakes a gated replay stream when an outbound frame mismatches", () =>
+    Effect.gen(function* () {
+      const { label, replayGate, session } = makeGatedReplaySession();
+      const emittedMessages: Array<unknown> = [];
+      const streamFiber = yield* session.messages.pipe(
+        Stream.tap((message) => Effect.sync(() => emittedMessages.push(message))),
+        Stream.runDrain,
+        Effect.exit,
+        Effect.forkChild,
+      );
+
+      yield* yieldToReplayStream;
+      assert.isTrue(replayGate.hasReached(label));
+
+      const offerExit = yield* Effect.exit(
+        session.offer(makeClaudeUserMessage({ text: "unexpected gated prompt" })),
+      );
+      assert.isTrue(Exit.isFailure(offerExit));
+
+      const streamExit = yield* Fiber.join(streamFiber);
+      assert.isTrue(Exit.isFailure(streamExit));
+      if (Exit.isFailure(streamExit)) {
+        const error = Cause.squash(streamExit.cause);
+        assert.isTrue(isClaudeAgentSdkQueryRunnerError(error));
+        if (isClaudeAgentSdkQueryRunnerError(error)) {
+          assert.isTrue(isClaudeReplayUnexpectedOutboundError(error.cause));
+        }
+      }
+      assert.deepEqual(emittedMessages, []);
+    }),
+  );
+
+  it.effect("surfaces an outbound mismatch during a delay without inbound callbacks", () =>
+    Effect.gen(function* () {
+      const stableOptions = {
+        model: "claude-sonnet-4-6",
+        tools: [],
+        permissionMode: "default",
+        sessionId: "session-replay-gated-permission",
+      } satisfies ClaudeAgentSdkQueryOptions;
+      const canUseTool = vi.fn<NonNullable<ClaudeAgentSdkQueryOptions["canUseTool"]>>(
+        async (_toolName, input, options) => ({
+          behavior: "allow",
+          updatedInput: input,
+          toolUseID: options.toolUseID,
+        }),
+      );
+      const label = "permission_request";
+      const replayGate = makeProviderReplayGate([label]);
+      const runner = makeReplayQueryRunner(
+        {
+          provider: CLAUDE_PROVIDER,
+          protocol: CLAUDE_AGENT_SDK_REPLAY_PROTOCOL,
+          version: "test",
+          scenario: "gated-permission-stops-after-failure",
+          entries: [
+            {
+              type: "expect_outbound",
+              frame: {
+                type: "query.open",
+                options: stableOptions,
+              },
+            },
+            {
+              type: "emit_inbound",
+              label,
+              afterMs: 30_000,
+              frame: {
+                type: "permission.request",
+                toolName: "Read",
+                input: { file_path: "/workspace/gated.ts" },
+                options: { toolUseID: "tool-use-gated" },
+              },
+            },
+            {
+              type: "runtime_exit",
+              status: "success",
+            },
+          ],
+        },
+        { replayGate },
+      );
+      const session = runner.open({
+        options: { ...stableOptions, canUseTool },
+        threadId: ThreadId.make("thread-replay-gated-permission"),
+        providerSessionId: ProviderSessionId.make("provider-session-replay-gated-permission"),
+      });
+      const emittedMessages: Array<unknown> = [];
+      const streamFiber = yield* session.messages.pipe(
+        Stream.tap((message) => Effect.sync(() => emittedMessages.push(message))),
+        Stream.runDrain,
+        Effect.exit,
+        Effect.forkChild,
+      );
+
+      yield* yieldToReplayStream;
+      assert.isTrue(replayGate.hasReached(label));
+      assert.isTrue(replayGate.release(label));
+      yield* yieldToReplayStream;
+
+      const offerExit = yield* Effect.exit(
+        session.offer(makeClaudeUserMessage({ text: "unexpected gated prompt" })),
+      );
+      assert.isTrue(Exit.isFailure(offerExit));
+
+      const streamExit = yield* Fiber.join(streamFiber);
+      assert.isTrue(Exit.isFailure(streamExit));
+      if (Exit.isFailure(streamExit)) {
+        const error = Cause.squash(streamExit.cause);
+        assert.isTrue(isClaudeAgentSdkQueryRunnerError(error));
+        if (isClaudeAgentSdkQueryRunnerError(error)) {
+          assert.isTrue(isClaudeReplayUnexpectedOutboundError(error.cause));
+        }
+      }
+      assert.deepEqual(emittedMessages, []);
+      assert.equal(canUseTool.mock.calls.length, 0);
+    }),
+  );
+
+  it.effect("wakes a replay stream waiting on an outbound frame when that frame mismatches", () =>
+    Effect.gen(function* () {
+      const options = {
+        model: "claude-sonnet-4-6",
+        tools: [],
+        permissionMode: "default",
+        sessionId: "session-replay-mismatch",
+      } satisfies ClaudeAgentSdkQueryOptions;
+      const expectedMessage = makeClaudeUserMessage({ text: "expected prompt" });
+      const actualMessage = makeClaudeUserMessage({ text: "unexpected prompt" });
+      const runner = makeReplayQueryRunner({
+        provider: CLAUDE_PROVIDER,
+        protocol: CLAUDE_AGENT_SDK_REPLAY_PROTOCOL,
+        version: "test",
+        scenario: "outbound-mismatch-wakes-stream",
+        entries: [
+          {
+            type: "expect_outbound",
+            frame: {
+              type: "query.open",
+              options,
+            },
+          },
+          {
+            type: "expect_outbound",
+            frame: {
+              type: "prompt.offer",
+              message: expectedMessage,
+            },
+          },
+        ],
+      });
+      const session = runner.open({
+        options,
+        threadId: ThreadId.make("thread-replay-mismatch"),
+        providerSessionId: ProviderSessionId.make("provider-session-replay-mismatch"),
+      });
+      const streamFiber = yield* Stream.runDrain(session.messages).pipe(
+        Effect.exit,
+        Effect.forkChild,
+      );
+
+      yield* Effect.yieldNow;
+      const offerExit = yield* Effect.exit(session.offer(actualMessage));
+      assert.isTrue(Exit.isFailure(offerExit));
+
+      yield* Effect.yieldNow;
+      assert.isDefined(
+        streamFiber.pollUnsafe(),
+        "expected the replay stream to finish after the mismatch",
+      );
+    }),
+  );
+
+  it.effect("interrupts a replay stream waiting on its next outbound frame", () =>
+    Effect.gen(function* () {
+      const options = {
+        model: "claude-sonnet-4-6",
+        tools: [],
+        permissionMode: "default",
+        sessionId: "session-replay-outbound-interrupt",
+      } satisfies ClaudeAgentSdkQueryOptions;
+      const runner = makeReplayQueryRunner({
+        provider: CLAUDE_PROVIDER,
+        protocol: CLAUDE_AGENT_SDK_REPLAY_PROTOCOL,
+        version: "test",
+        scenario: "outbound-wait-interruption",
+        entries: [
+          {
+            type: "expect_outbound",
+            frame: {
+              type: "query.open",
+              options,
+            },
+          },
+          {
+            type: "expect_outbound",
+            frame: {
+              type: "prompt.offer",
+              message: makeClaudeUserMessage({ text: "next prompt" }),
+            },
+          },
+        ],
+      });
+      const session = runner.open({
+        options,
+        threadId: ThreadId.make("thread-replay-outbound-interrupt"),
+        providerSessionId: ProviderSessionId.make("provider-session-replay-outbound-interrupt"),
+      });
+      const streamFiber = yield* Stream.runDrain(session.messages).pipe(Effect.forkChild);
+
+      yield* yieldToReplayStream;
+      assert.isUndefined(streamFiber.pollUnsafe());
+
+      yield* Fiber.interrupt(streamFiber);
+
+      const incomplete = assert.throws(() => runner.assertComplete());
+      assert.isTrue(isClaudeReplayIncompleteError(incomplete));
+      if (isClaudeReplayIncompleteError(incomplete)) {
+        assert.equal(incomplete.cursor, 1);
+        assert.equal(incomplete.remaining, 1);
+      }
+    }),
+  );
+
+  it.effect("aborts a pending permission callback when replay fails", () =>
+    Effect.gen(function* () {
+      const stableOptions = {
+        model: "claude-sonnet-4-6",
+        tools: [],
+        permissionMode: "default",
+        sessionId: "session-replay-permission-abort",
+      } satisfies ClaudeAgentSdkQueryOptions;
+      let callbackSignal: AbortSignal | undefined;
+      let notifyCallbackStarted = () => {};
+      const callbackStarted = new Promise<void>((resolve) => {
+        notifyCallbackStarted = resolve;
+      });
+      const canUseTool = vi.fn<NonNullable<ClaudeAgentSdkQueryOptions["canUseTool"]>>(
+        async (_toolName, _input, options) => {
+          callbackSignal = options.signal;
+          notifyCallbackStarted();
+          await new Promise<never>((_resolve, reject) => {
+            const rejectOnAbort = () => reject(new Error("permission callback aborted"));
+            options.signal.addEventListener("abort", rejectOnAbort, { once: true });
+            if (options.signal.aborted) {
+              rejectOnAbort();
+            }
+          });
+          return {
+            behavior: "allow",
+            updatedInput: _input,
+            toolUseID: options.toolUseID,
+          };
+        },
+      );
+      const runner = makeReplayQueryRunner({
+        provider: CLAUDE_PROVIDER,
+        protocol: CLAUDE_AGENT_SDK_REPLAY_PROTOCOL,
+        version: "test",
+        scenario: "pending-permission-aborts-on-replay-failure",
+        entries: [
+          {
+            type: "expect_outbound",
+            frame: {
+              type: "query.open",
+              options: stableOptions,
+            },
+          },
+          {
+            type: "emit_inbound",
+            frame: {
+              type: "permission.request",
+              toolName: "Read",
+              input: { file_path: "/workspace/pending.ts" },
+              options: { toolUseID: "tool-use-pending" },
+            },
+          },
+          {
+            type: "runtime_exit",
+            status: "success",
+          },
+        ],
+      });
+      const session = runner.open({
+        options: { ...stableOptions, canUseTool },
+        threadId: ThreadId.make("thread-replay-permission-abort"),
+        providerSessionId: ProviderSessionId.make("provider-session-replay-permission-abort"),
+      });
+      const streamFiber = yield* Stream.runDrain(session.messages).pipe(
+        Effect.exit,
+        Effect.forkChild,
+      );
+
+      yield* Effect.promise(() => callbackStarted);
+      const offerExit = yield* Effect.exit(
+        session.offer(makeClaudeUserMessage({ text: "unexpected prompt" })),
+      );
+
+      assert.isTrue(Exit.isFailure(offerExit));
+      const streamExit = yield* Fiber.join(streamFiber);
+      assert.isTrue(Exit.isFailure(streamExit));
+      if (Exit.isFailure(streamExit)) {
+        const error = Cause.squash(streamExit.cause);
+        assert.isTrue(isClaudeAgentSdkQueryRunnerError(error));
+        if (isClaudeAgentSdkQueryRunnerError(error)) {
+          assert.isTrue(isClaudeReplayUnexpectedOutboundError(error.cause));
+        }
+      }
+      assert.equal(canUseTool.mock.calls.length, 1);
+      assert.isTrue(callbackSignal?.aborted);
+    }),
+  );
+
+  it.effect("keeps permission callbacks scoped to the query that opened the stream", () =>
+    Effect.gen(function* () {
+      const firstCanUseTool = vi.fn<NonNullable<ClaudeAgentSdkQueryOptions["canUseTool"]>>(
+        async (_toolName, _input, options) => ({
+          behavior: "allow",
+          updatedInput: { query: "first" },
+          toolUseID: options.toolUseID,
+          decisionClassification: "user_temporary",
+        }),
+      );
+      const secondCanUseTool = vi.fn<NonNullable<ClaudeAgentSdkQueryOptions["canUseTool"]>>(
+        async (_toolName, _input, options) => ({
+          behavior: "allow",
+          updatedInput: { query: "second" },
+          toolUseID: options.toolUseID,
+          decisionClassification: "user_temporary",
+        }),
+      );
+      const firstStableOptions = {
+        model: "claude-sonnet-4-6",
+        tools: [],
+        permissionMode: "default",
+        sessionId: "session-replay-permission-first",
+      } satisfies ClaudeAgentSdkQueryOptions;
+      const secondStableOptions = {
+        model: "claude-sonnet-4-6",
+        tools: [],
+        permissionMode: "default",
+        sessionId: "session-replay-permission-second",
+      } satisfies ClaudeAgentSdkQueryOptions;
+      const runner = makeReplayQueryRunner({
+        provider: CLAUDE_PROVIDER,
+        protocol: CLAUDE_AGENT_SDK_REPLAY_PROTOCOL,
+        version: "test",
+        scenario: "permission-callbacks-are-query-scoped",
+        entries: [
+          {
+            type: "expect_outbound",
+            frame: {
+              type: "query.open",
+              options: firstStableOptions,
+            },
+          },
+          {
+            type: "expect_outbound",
+            frame: {
+              type: "query.open",
+              options: secondStableOptions,
+            },
+          },
+          {
+            type: "emit_inbound",
+            frame: {
+              type: "permission.request",
+              toolName: "Read",
+              input: { file_path: "/workspace/first.ts" },
+              options: {
+                toolUseID: "tool-use-first",
+              },
+            },
+          },
+          {
+            type: "expect_outbound",
+            frame: {
+              type: "permission.response",
+              result: {
+                behavior: "allow",
+                updatedInput: { query: "first" },
+                toolUseID: "tool-use-first",
+                decisionClassification: "user_temporary",
+              },
+            },
+          },
+          {
+            type: "runtime_exit",
+            status: "success",
+          },
+          {
+            type: "runtime_exit",
+            status: "success",
+          },
+        ],
+      });
+      const firstSession = runner.open({
+        options: {
+          ...firstStableOptions,
+          canUseTool: firstCanUseTool,
+        },
+        threadId: ThreadId.make("thread-replay-permission-first"),
+        providerSessionId: ProviderSessionId.make("provider-session-replay-permission-first"),
+      });
+      const secondSession = runner.open({
+        options: {
+          ...secondStableOptions,
+          canUseTool: secondCanUseTool,
+        },
+        threadId: ThreadId.make("thread-replay-permission-second"),
+        providerSessionId: ProviderSessionId.make("provider-session-replay-permission-second"),
+      });
+
+      yield* Stream.runDrain(firstSession.messages);
+      yield* Stream.runDrain(secondSession.messages);
+      runner.assertComplete();
+
+      assert.equal(firstCanUseTool.mock.calls.length, 1);
+      assert.equal(secondCanUseTool.mock.calls.length, 0);
+    }),
+  );
+
+  it.effect("fails a replay stream when the recorded runtime was cancelled", () =>
+    Effect.gen(function* () {
+      const options = {
+        model: "claude-sonnet-4-6",
+        tools: [],
+        permissionMode: "default",
+        sessionId: "session-replay-cancelled",
+      } satisfies ClaudeAgentSdkQueryOptions;
+      const runner = makeReplayQueryRunner({
+        provider: CLAUDE_PROVIDER,
+        protocol: CLAUDE_AGENT_SDK_REPLAY_PROTOCOL,
+        version: "test",
+        scenario: "cancelled-runtime-is-not-success",
+        entries: [
+          {
+            type: "expect_outbound",
+            frame: {
+              type: "query.open",
+              options,
+            },
+          },
+          {
+            type: "runtime_exit",
+            status: "cancelled",
+          },
+        ],
+      });
+      const session = runner.open({
+        options,
+        threadId: ThreadId.make("thread-replay-cancelled"),
+        providerSessionId: ProviderSessionId.make("provider-session-replay-cancelled"),
+      });
+
+      const exit = yield* Effect.exit(Stream.runDrain(session.messages));
+
+      assert.isTrue(Exit.isFailure(exit));
+      if (Exit.isFailure(exit)) {
+        const error = Cause.squash(exit.cause);
+        assert.isTrue(isClaudeAgentSdkQueryRunnerError(error));
+        if (isClaudeAgentSdkQueryRunnerError(error)) {
+          assert.isTrue(isClaudeReplayRuntimeExitError(error.cause));
+          if (isClaudeReplayRuntimeExitError(error.cause)) {
+            assert.equal(error.cause.status, "cancelled");
+          }
+        }
+      }
+    }),
+  );
+
+  it.effect("closes an interrupted recording and emits runtime_exit when no tool use arrives", () =>
+    Effect.gen(function* () {
+      claudeSdkMock.reset();
+      const entries: Array<ProviderReplayEntry> = [];
+
+      const recordingExit = yield* Effect.exit(
+        Effect.tryPromise(() =>
+          recordInterruptedClaudeQuery({
+            scenario: "interrupt-without-tool-use",
+            prompt: "use a tool",
+            modelSelection: {
+              instanceId: ProviderInstanceId.make("claudeAgent"),
+              model: "claude-sonnet-4-6",
+            },
+            cwd: "/workspace",
+            sessionId: "session-interrupt-without-tool-use",
+            resume: false,
+            entries,
+            queryOpenLabel: "query.open",
+            promptOfferLabel: "prompt.offer",
+            interruptLabel: "query.interrupt",
+            interruptAfter: "tool_use",
+          }),
+        ),
+      );
+      assert.isTrue(Exit.isFailure(recordingExit));
+
+      assert.equal(claudeSdkMock.close.mock.calls.length, 1);
+      assert.deepInclude(entries.at(-1), {
+        type: "runtime_exit",
+        status: "error",
+      });
+
+      const prompt = claudeSdkMock.getPrompt();
+      assert.isDefined(prompt);
+      const promptIterator = prompt[Symbol.asyncIterator]();
+      assert.isFalse((yield* Effect.promise(() => promptIterator.next())).done);
+      assert.isTrue((yield* Effect.promise(() => promptIterator.next())).done);
+    }),
+  );
+
+  it("finalizes a resumed recording as soon as its terminal result arrives", async () => {
+    const next = vi.fn().mockResolvedValue({
+      done: false,
+      value: {
+        type: "result",
+        subtype: "success",
+      },
+    });
+    const finalize = vi.fn();
+    const entries: Array<ProviderReplayEntry> = [];
+
+    const completed = await recordMessagesUntilTurnResultAndFinalize({
+      iterator: { next },
+      entries,
+      scenario: "resume-at-cursor-terminal",
+      finalize,
+    });
+
+    assert.isTrue(completed);
+    assert.equal(next.mock.calls.length, 1);
+    assert.equal(finalize.mock.calls.length, 1);
+    const terminalEntry = entries.at(-1);
+    assert.equal(terminalEntry?.type, "emit_inbound");
+    if (terminalEntry?.type === "emit_inbound") {
+      assert.equal(terminalEntry.label, "result");
+    }
+  });
+});
diff --git a/apps/server/src/orchestration-v2/Adapters/ClaudeAdapterV2.testkit.ts b/apps/server/src/orchestration-v2/Adapters/ClaudeAdapterV2.testkit.ts
new file mode 100644
index 000000000000..76cb486d391f
--- /dev/null
+++ b/apps/server/src/orchestration-v2/Adapters/ClaudeAdapterV2.testkit.ts
@@ -0,0 +1,2555 @@
+import {
+  forkSession,
+  query,
+  type CanUseTool,
+  type PermissionResult,
+  type SDKAssistantMessage,
+  type SDKMessage,
+  type SDKUserMessage,
+} from "@anthropic-ai/claude-agent-sdk";
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import {
+  ProviderReplayEntry,
+  type ModelSelection,
+  type ProviderApprovalDecision,
+  type ProviderReplayTranscript,
+} from "@t3tools/contracts";
+import * as Cause from "effect/Cause";
+import * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as Layer from "effect/Layer";
+import * as Schema from "effect/Schema";
+import * as Stream from "effect/Stream";
+
+import { ServerConfig } from "../../config.ts";
+import {
+  CLAUDE_PROVIDER,
+  CLAUDE_DEFAULT_INSTANCE_ID,
+  CLAUDE_DRIVER_KIND,
+  ClaudeAdapterV2Driver,
+  ClaudeAgentSdkQueryRunner,
+  ClaudeAgentSdkQueryRunnerError,
+  makeClaudeUserMessage,
+  makeClaudeQueryOptions,
+  type ClaudeAgentSdkSessionForkInput,
+  type ClaudeAgentSdkQueryOpenInput,
+  type ClaudeAgentSdkQueryOptions,
+  type ClaudeAgentSdkQuerySession,
+  type ClaudeAgentSdkQueryTools,
+} from "./ClaudeAdapterV2.ts";
+import { layer as idAllocatorLayer } from "../IdAllocator.ts";
+import { ProviderAdapterDriverCreateError } from "../ProviderAdapterDriver.ts";
+import { makeDriverLayer as makeProviderAdapterRegistryDriverLayer } from "../ProviderAdapterRegistry.ts";
+import { randomUuidV4 } from "../RandomUuid.ts";
+import {
+  makeReplayServerConfig,
+  type OrchestratorV2ProviderReplayHarness,
+} from "../testkit/ProviderReplayHarness.ts";
+import type { ProviderReplayGate } from "../testkit/ProviderReplayGate.testkit.ts";
+
+export const CLAUDE_AGENT_SDK_REPLAY_PROTOCOL = "claude-agent-sdk.query" as const;
+
+const ClaudeAgentSdkReplayTranscript = Schema.Struct({
+  provider: Schema.Literal(CLAUDE_PROVIDER),
+  protocol: Schema.Literal(CLAUDE_AGENT_SDK_REPLAY_PROTOCOL),
+  version: Schema.String,
+  scenario: Schema.String,
+  metadata: Schema.optional(Schema.Record(Schema.String, Schema.Unknown)),
+  entries: Schema.Array(ProviderReplayEntry),
+});
+type ClaudeAgentSdkReplayTranscript = typeof ClaudeAgentSdkReplayTranscript.Type;
+
+export class ClaudeReplayTranscriptDecodeError extends Schema.TaggedErrorClass<ClaudeReplayTranscriptDecodeError>()(
+  "ClaudeReplayTranscriptDecodeError",
+  {
+    driver: Schema.optional(Schema.String),
+    protocol: Schema.optional(Schema.String),
+    scenario: Schema.optional(Schema.String),
+    cause: Schema.Defect(),
+  },
+) {
+  override get message(): string {
+    return `Failed to decode Claude Agent SDK replay transcript for scenario ${this.scenario ?? "<unknown>"}.`;
+  }
+}
+
+export class ClaudeReplayExhaustedError extends Schema.TaggedErrorClass<ClaudeReplayExhaustedError>()(
+  "ClaudeReplayExhaustedError",
+  {
+    scenario: Schema.String,
+    cursor: Schema.Number,
+    actual: Schema.Unknown,
+  },
+) {
+  override get message(): string {
+    return `Claude Agent SDK replay transcript exhausted before outbound frame ${this.cursor} in scenario ${this.scenario}.`;
+  }
+}
+
+export class ClaudeReplayUnexpectedOutboundError extends Schema.TaggedErrorClass<ClaudeReplayUnexpectedOutboundError>()(
+  "ClaudeReplayUnexpectedOutboundError",
+  {
+    scenario: Schema.String,
+    cursor: Schema.Number,
+    expectedType: Schema.String,
+    actual: Schema.Unknown,
+  },
+) {
+  override get message(): string {
+    return `Unexpected outbound Claude Agent SDK frame at replay cursor ${this.cursor} in scenario ${this.scenario}.`;
+  }
+}
+
+export class ClaudeReplayFrameMismatchError extends Schema.TaggedErrorClass<ClaudeReplayFrameMismatchError>()(
+  "ClaudeReplayFrameMismatchError",
+  {
+    scenario: Schema.String,
+    cursor: Schema.Number,
+    label: Schema.optional(Schema.String),
+    expected: Schema.Unknown,
+    actual: Schema.Unknown,
+  },
+) {
+  override get message(): string {
+    return `Outbound Claude Agent SDK frame did not match replay cursor ${this.cursor} in scenario ${this.scenario}.`;
+  }
+}
+
+export class ClaudeReplayRuntimeExitError extends Schema.TaggedErrorClass<ClaudeReplayRuntimeExitError>()(
+  "ClaudeReplayRuntimeExitError",
+  {
+    scenario: Schema.String,
+    cursor: Schema.Number,
+    status: Schema.Literals(["error", "cancelled"]),
+    error: Schema.optional(Schema.Unknown),
+  },
+) {
+  override get message(): string {
+    return `Claude Agent SDK replay exited with status ${this.status} at cursor ${this.cursor} in scenario ${this.scenario}.`;
+  }
+}
+
+export class ClaudeReplayIncompleteError extends Schema.TaggedErrorClass<ClaudeReplayIncompleteError>()(
+  "ClaudeReplayIncompleteError",
+  {
+    scenario: Schema.String,
+    cursor: Schema.Number,
+    remaining: Schema.Number,
+  },
+) {
+  override get message(): string {
+    return `Claude Agent SDK replay ended with ${this.remaining} unconsumed entries in scenario ${this.scenario}.`;
+  }
+}
+
+export class ClaudeReplayDriverError extends Schema.TaggedErrorClass<ClaudeReplayDriverError>()(
+  "ClaudeReplayDriverError",
+  {
+    scenario: Schema.String,
+    cause: Schema.Defect(),
+  },
+) {
+  override get message(): string {
+    return `Claude Agent SDK replay driver failed in scenario ${this.scenario}.`;
+  }
+}
+
+export const ClaudeAgentSdkReplayError = Schema.Union([
+  ClaudeReplayTranscriptDecodeError,
+  ClaudeReplayExhaustedError,
+  ClaudeReplayUnexpectedOutboundError,
+  ClaudeReplayFrameMismatchError,
+  ClaudeReplayRuntimeExitError,
+  ClaudeReplayIncompleteError,
+  ClaudeReplayDriverError,
+]);
+export type ClaudeAgentSdkReplayError = typeof ClaudeAgentSdkReplayError.Type;
+export const ClaudeOrchestratorReplayHarnessError = Schema.Union([
+  ClaudeAgentSdkReplayError,
+  ProviderAdapterDriverCreateError,
+]);
+export type ClaudeOrchestratorReplayHarnessError = typeof ClaudeOrchestratorReplayHarnessError.Type;
+
+interface ClaudeQueryOpenFrame {
+  readonly type: "query.open";
+  readonly options: ClaudeAgentSdkQueryOptions;
+}
+
+interface ClaudePromptOfferFrame {
+  readonly type: "prompt.offer";
+  readonly message: SDKUserMessage;
+}
+
+interface ClaudeQuerySetModelFrame {
+  readonly type: "query.set_model";
+  readonly model: string;
+}
+
+interface ClaudeQueryInterruptFrame {
+  readonly type: "query.interrupt";
+}
+
+interface ClaudePermissionRequestFrame {
+  readonly type: "permission.request";
+  readonly toolName: string;
+  readonly input: Record<string, unknown>;
+  readonly options: {
+    readonly suggestions?: Parameters<CanUseTool>[2]["suggestions"];
+    readonly blockedPath?: string;
+    readonly decisionReason?: string;
+    readonly title?: string;
+    readonly displayName?: string;
+    readonly description?: string;
+    readonly toolUseID: string;
+    readonly agentID?: string;
+  };
+}
+
+interface ClaudePermissionResponseFrame {
+  readonly type: "permission.response";
+  readonly result: PermissionResult;
+}
+
+interface ClaudeSessionForkFrame {
+  readonly type: "session.fork";
+  readonly sessionId: string;
+  readonly options: {
+    readonly dir?: string;
+    readonly upToMessageId?: string;
+    readonly title?: string;
+  };
+}
+
+interface ClaudeSessionForkedFrame {
+  readonly type: "session.forked";
+  readonly sessionId: string;
+}
+
+type ClaudeOutboundFrame =
+  | ClaudeQueryOpenFrame
+  | ClaudePromptOfferFrame
+  | ClaudeQuerySetModelFrame
+  | ClaudeQueryInterruptFrame
+  | ClaudePermissionResponseFrame
+  | ClaudeSessionForkFrame;
+
+interface ClaudeQueryRunner {
+  readonly open: (input: ClaudeAgentSdkQueryOpenInput) => ClaudeAgentSdkQuerySession;
+  readonly forkSession: (input: ClaudeAgentSdkSessionForkInput) => ClaudeSessionForkedFrame;
+  readonly assertComplete: () => void;
+}
+
+function stableStringify(value: unknown): string {
+  if (Array.isArray(value)) {
+    return `[${value.map(stableStringify).join(",")}]`;
+  }
+  if (typeof value === "object" && value !== null) {
+    const record = value as Record<string, unknown>;
+    return `{${Object.keys(record)
+      .toSorted()
+      .map((key) => `${JSON.stringify(key)}:${stableStringify(record[key])}`)
+      .join(",")}}`;
+  }
+  return JSON.stringify(value);
+}
+
+function normalizeContextHandoffText(value: string): string {
+  if (!value.startsWith("Context handoff (")) {
+    return value;
+  }
+  const userMessageMarker = "\n\nUser message:\n";
+  const userMessageIndex = value.indexOf(userMessageMarker);
+  const headerEndIndex = value.indexOf(":\n");
+  if (headerEndIndex === -1 || userMessageIndex === -1 || headerEndIndex >= userMessageIndex) {
+    return value;
+  }
+  return `${value.slice(0, headerEndIndex + 2)}<dynamic-summary>${value.slice(userMessageIndex)}`;
+}
+
+function normalizeReplayFrame(value: unknown): unknown {
+  if (typeof value === "string") {
+    return normalizeContextHandoffText(value);
+  }
+  if (Array.isArray(value)) {
+    return value.map(normalizeReplayFrame);
+  }
+  if (typeof value !== "object" || value === null) {
+    return value;
+  }
+  return Object.fromEntries(
+    Object.entries(value).map(([key, entry]) => [key, normalizeReplayFrame(entry)]),
+  );
+}
+
+function sameFrame(left: unknown, right: unknown): boolean {
+  return (
+    stableStringify(normalizeReplayFrame(left)) === stableStringify(normalizeReplayFrame(right))
+  );
+}
+
+function isClaudeSdkReplayMessage(frame: unknown): frame is SDKMessage {
+  if (typeof frame !== "object" || frame === null) {
+    return false;
+  }
+  const type = Reflect.get(frame, "type");
+  return (
+    type === "assistant" ||
+    type === "user" ||
+    type === "result" ||
+    type === "system" ||
+    type === "rate_limit_event"
+  );
+}
+
+function sdkMessageFromReplayFrame(frame: unknown): SDKMessage {
+  if (!isClaudeSdkReplayMessage(frame)) {
+    throw new Error("Replay frame is not a Claude Agent SDK message.");
+  }
+  return frame;
+}
+
+function isClaudePermissionRequestFrame(frame: unknown): frame is ClaudePermissionRequestFrame {
+  const options =
+    typeof frame === "object" && frame !== null ? Reflect.get(frame, "options") : undefined;
+  return (
+    typeof frame === "object" &&
+    frame !== null &&
+    Reflect.get(frame, "type") === "permission.request" &&
+    typeof Reflect.get(frame, "toolName") === "string" &&
+    typeof Reflect.get(frame, "input") === "object" &&
+    Reflect.get(frame, "input") !== null &&
+    typeof options === "object" &&
+    options !== null &&
+    typeof Reflect.get(options, "toolUseID") === "string"
+  );
+}
+
+function makeClaudePermissionResponseFrame(
+  result: PermissionResult,
+): ClaudePermissionResponseFrame {
+  return {
+    type: "permission.response",
+    result,
+  };
+}
+
+function permissionRequestOptionsFromFrame(
+  frame: ClaudePermissionRequestFrame,
+  signal: AbortSignal,
+): Parameters<CanUseTool>[2] {
+  const options = frame.options;
+  return {
+    signal,
+    ...(options.suggestions === undefined ? {} : { suggestions: options.suggestions }),
+    ...(options.blockedPath === undefined ? {} : { blockedPath: options.blockedPath }),
+    ...(options.decisionReason === undefined ? {} : { decisionReason: options.decisionReason }),
+    ...(options.title === undefined ? {} : { title: options.title }),
+    ...(options.displayName === undefined ? {} : { displayName: options.displayName }),
+    ...(options.description === undefined ? {} : { description: options.description }),
+    toolUseID: options.toolUseID,
+    ...(options.agentID === undefined ? {} : { agentID: options.agentID }),
+    requestId: options.toolUseID,
+  };
+}
+
+function unresolvedCursorSignal(): void {}
+
+function makeCursorSignal(): {
+  readonly promise: Promise<void>;
+  readonly resolve: () => void;
+} {
+  let resolve: () => void = unresolvedCursorSignal;
+  const promise = new Promise<void>((onResolve) => {
+    resolve = onResolve;
+  });
+  return { promise, resolve };
+}
+
+function waitForCursorAdvance(promise: Promise<void>, signal: AbortSignal): Promise<void> {
+  if (signal.aborted) {
+    return Promise.resolve();
+  }
+  return new Promise<void>((resolve) => {
+    let waiting = true;
+    const finish = () => {
+      if (!waiting) {
+        return;
+      }
+      waiting = false;
+      signal.removeEventListener("abort", finish);
+      resolve();
+    };
+    signal.addEventListener("abort", finish, { once: true });
+    void promise.then(finish);
+    if (signal.aborted) {
+      finish();
+    }
+  });
+}
+
+async function waitForReplayDelay(afterMs: number, signal: AbortSignal): Promise<void> {
+  const exit = await Effect.runPromiseExit(Effect.sleep(Duration.millis(afterMs)), { signal });
+  if (Exit.isFailure(exit) && !Cause.hasInterruptsOnly(exit.cause)) {
+    throw Cause.squash(exit.cause);
+  }
+}
+
+function stableClaudeQueryOptions(options: ClaudeAgentSdkQueryOptions): ClaudeAgentSdkQueryOptions {
+  const stable = {
+    model: options.model,
+    tools: options.tools,
+    permissionMode: options.permissionMode,
+    ...(options.allowedTools === undefined ? {} : { allowedTools: options.allowedTools }),
+    ...(options.disallowedTools === undefined ? {} : { disallowedTools: options.disallowedTools }),
+    ...(options.settings === undefined ? {} : { settings: options.settings }),
+    ...(options.allowDangerouslySkipPermissions === true
+      ? { allowDangerouslySkipPermissions: true }
+      : {}),
+    ...(options.resumeSessionAt === undefined ? {} : { resumeSessionAt: options.resumeSessionAt }),
+    ...(options.forkSession === true ? { forkSession: true } : {}),
+  };
+  return options.resume === undefined
+    ? { ...stable, sessionId: options.sessionId }
+    : { ...stable, resume: options.resume };
+}
+
+function makeClaudeQueryOpenFrame(
+  input: Pick<ClaudeAgentSdkQueryOpenInput, "options">,
+): ClaudeQueryOpenFrame {
+  return {
+    type: "query.open",
+    options: stableClaudeQueryOptions(input.options),
+  };
+}
+
+function makeClaudePromptOfferFrame(message: SDKUserMessage): ClaudePromptOfferFrame {
+  return {
+    type: "prompt.offer",
+    message,
+  };
+}
+
+function makeClaudeSessionForkFrame(
+  input: ClaudeAgentSdkSessionForkInput,
+  scenario: string,
+): ClaudeSessionForkFrame {
+  return {
+    type: "session.fork",
+    sessionId: input.sessionId,
+    options: {
+      ...(input.options.dir === undefined ? {} : { dir: sanitizedReplayCwd(scenario) }),
+      ...(input.options.upToMessageId === undefined
+        ? {}
+        : { upToMessageId: input.options.upToMessageId }),
+      ...(input.options.title === undefined ? {} : { title: input.options.title }),
+    },
+  };
+}
+
+export function makeReplayQueryRunner(
+  transcript: ClaudeAgentSdkReplayTranscript,
+  replayOptions: { readonly replayGate?: ProviderReplayGate } = {},
+): ClaudeQueryRunner {
+  let cursor = 0;
+  let failure: ClaudeAgentSdkReplayError | null = null;
+  let cursorAdvanced = makeCursorSignal();
+  const iteratorAbortControllers = new Set<AbortController>();
+
+  const abortReplayIterators = () => {
+    for (const abortController of iteratorAbortControllers) {
+      abortController.abort();
+    }
+  };
+
+  const fail = (error: ClaudeAgentSdkReplayError): never => {
+    failure = error;
+    abortReplayIterators();
+    replayOptions.replayGate?.releaseAll();
+    cursorAdvanced.resolve();
+    throw error;
+  };
+
+  const throwIfFailed = () => {
+    if (failure !== null) {
+      throw failure;
+    }
+  };
+
+  const advance = () => {
+    cursor += 1;
+    const signal = cursorAdvanced;
+    cursorAdvanced = makeCursorSignal();
+    signal.resolve();
+  };
+
+  async function* replayMessages(
+    options: ClaudeAgentSdkQueryOptions,
+    signal: AbortSignal,
+  ): AsyncGenerator<SDKMessage, void> {
+    while (true) {
+      throwIfFailed();
+
+      const entry = transcript.entries[cursor];
+      if (entry === undefined) {
+        return;
+      }
+
+      if (entry.type === "emit_inbound") {
+        if (replayOptions.replayGate !== undefined) {
+          await replayOptions.replayGate.beforeEmit(entry.label, signal);
+          throwIfFailed();
+          if (signal.aborted) {
+            return;
+          }
+        }
+        if (entry.afterMs !== undefined && entry.afterMs > 0) {
+          await waitForReplayDelay(entry.afterMs, signal);
+          throwIfFailed();
+          if (signal.aborted) {
+            return;
+          }
+        }
+        if (isClaudePermissionRequestFrame(entry.frame)) {
+          const request = entry.frame;
+          const invokeCanUseTool = options.canUseTool;
+          if (invokeCanUseTool === undefined) {
+            const error = new ClaudeReplayUnexpectedOutboundError({
+              scenario: transcript.scenario,
+              cursor,
+              expectedType: "permission.request",
+              actual: request,
+            });
+            return fail(error);
+          }
+          advance();
+          let result: PermissionResult | null;
+          try {
+            result = await invokeCanUseTool(
+              request.toolName,
+              request.input,
+              permissionRequestOptionsFromFrame(request, signal),
+            );
+          } catch (cause) {
+            throwIfFailed();
+            if (signal.aborted) {
+              return;
+            }
+            throw cause;
+          }
+          throwIfFailed();
+          if (signal.aborted) {
+            return;
+          }
+          if (result === null) {
+            const error = new ClaudeReplayUnexpectedOutboundError({
+              scenario: transcript.scenario,
+              cursor,
+              expectedType: "permission.response",
+              actual: null,
+            });
+            return fail(error);
+          }
+          assertNextOutboundFrame(makeClaudePermissionResponseFrame(result));
+          continue;
+        }
+        advance();
+        yield sdkMessageFromReplayFrame(entry.frame);
+        continue;
+      }
+
+      if (entry.type === "runtime_exit") {
+        advance();
+        if (entry.status === "success") {
+          return;
+        }
+        fail(
+          new ClaudeReplayRuntimeExitError({
+            scenario: transcript.scenario,
+            cursor: cursor - 1,
+            status: entry.status,
+            ...(entry.error === undefined ? {} : { error: entry.error }),
+          }),
+        );
+      }
+
+      if (entry.type === "expect_outbound") {
+        await waitForCursorAdvance(cursorAdvanced.promise, signal);
+        throwIfFailed();
+        if (signal.aborted) {
+          return;
+        }
+        continue;
+      }
+    }
+  }
+
+  const replayMessagesWithGateCleanup = (
+    options: ClaudeAgentSdkQueryOptions,
+  ): AsyncIterable<SDKMessage> => ({
+    [Symbol.asyncIterator]: () => {
+      const abortController = new AbortController();
+      iteratorAbortControllers.add(abortController);
+      const iterator = replayMessages(options, abortController.signal);
+      return {
+        next: async () => {
+          try {
+            const result = await iterator.next();
+            if (result.done) {
+              iteratorAbortControllers.delete(abortController);
+            }
+            return result;
+          } catch (cause) {
+            iteratorAbortControllers.delete(abortController);
+            throw cause;
+          }
+        },
+        return: async () => {
+          abortController.abort();
+          replayOptions.replayGate?.releaseAll();
+          try {
+            return await iterator.return();
+          } finally {
+            iteratorAbortControllers.delete(abortController);
+          }
+        },
+      };
+    },
+  });
+
+  const assertNextOutboundFrame = (actual: ClaudeOutboundFrame) => {
+    if (failure !== null) {
+      throw failure;
+    }
+    const entry = transcript.entries[cursor];
+    if (entry === undefined) {
+      return fail(
+        new ClaudeReplayExhaustedError({
+          scenario: transcript.scenario,
+          cursor,
+          actual,
+        }),
+      );
+    }
+    if (entry.type !== "expect_outbound") {
+      return fail(
+        new ClaudeReplayUnexpectedOutboundError({
+          scenario: transcript.scenario,
+          cursor,
+          expectedType: entry.type,
+          actual,
+        }),
+      );
+    }
+
+    const expected = entry.frame;
+    if (!sameFrame(expected, actual)) {
+      fail(
+        new ClaudeReplayFrameMismatchError({
+          scenario: transcript.scenario,
+          cursor,
+          ...(entry.label === undefined ? {} : { label: entry.label }),
+          expected,
+          actual,
+        }),
+      );
+    }
+
+    advance();
+  };
+
+  const assertNextForkedFrame = (): ClaudeSessionForkedFrame => {
+    const entry = transcript.entries[cursor];
+    if (entry === undefined) {
+      return fail(
+        new ClaudeReplayExhaustedError({
+          scenario: transcript.scenario,
+          cursor,
+          actual: { type: "session.forked" },
+        }),
+      );
+    }
+    if (entry.type !== "emit_inbound") {
+      return fail(
+        new ClaudeReplayUnexpectedOutboundError({
+          scenario: transcript.scenario,
+          cursor,
+          expectedType: entry.type,
+          actual: { type: "session.forked" },
+        }),
+      );
+    }
+    if (
+      typeof entry.frame !== "object" ||
+      entry.frame === null ||
+      Reflect.get(entry.frame, "type") !== "session.forked" ||
+      typeof Reflect.get(entry.frame, "sessionId") !== "string"
+    ) {
+      return fail(
+        new ClaudeReplayFrameMismatchError({
+          scenario: transcript.scenario,
+          cursor,
+          expected: { type: "session.forked" },
+          actual: entry.frame,
+        }),
+      );
+    }
+
+    const frame = entry.frame as ClaudeSessionForkedFrame;
+    advance();
+    return frame;
+  };
+
+  const replayEffect = (tryEffect: () => void) =>
+    Effect.try({
+      try: tryEffect,
+      catch: (cause) => replayQueryRunnerError(transcript, cause),
+    });
+
+  return {
+    open: (input) => {
+      assertNextOutboundFrame(makeClaudeQueryOpenFrame(input));
+      return {
+        messages: Stream.fromAsyncIterable(replayMessagesWithGateCleanup(input.options), (cause) =>
+          replayQueryRunnerError(transcript, cause),
+        ),
+        offer: (message) =>
+          replayEffect(() => {
+            assertNextOutboundFrame(makeClaudePromptOfferFrame(message));
+          }),
+        setModel: (model) =>
+          replayEffect(() => {
+            assertNextOutboundFrame({
+              type: "query.set_model",
+              model,
+            });
+          }),
+        interrupt: replayEffect(() => {
+          assertNextOutboundFrame({ type: "query.interrupt" });
+        }),
+        close: Effect.void,
+      };
+    },
+    forkSession: (input) => {
+      assertNextOutboundFrame(makeClaudeSessionForkFrame(input, transcript.scenario));
+      return assertNextForkedFrame();
+    },
+    assertComplete: () => {
+      if (failure !== null) {
+        throw failure;
+      }
+      if (cursor !== transcript.entries.length) {
+        replayOptions.replayGate?.releaseAll();
+        throw new ClaudeReplayIncompleteError({
+          scenario: transcript.scenario,
+          cursor,
+          remaining: transcript.entries.length - cursor,
+        });
+      }
+    },
+  };
+}
+
+function metadataFromTranscript(transcript: ProviderReplayTranscript): {
+  readonly provider?: string;
+  readonly protocol?: string;
+  readonly scenario?: string;
+} {
+  return {
+    provider: transcript.provider,
+    protocol: transcript.protocol,
+    scenario: transcript.scenario,
+  };
+}
+
+function nativeSessionIdFor(transcript: ClaudeAgentSdkReplayTranscript): string {
+  const metadataSessionId = transcript.metadata?.nativeSessionId;
+  return typeof metadataSessionId === "string"
+    ? metadataSessionId
+    : "00000000-0000-4000-8000-000000000000";
+}
+
+const isClaudeAgentSdkQueryRunnerError = Schema.is(ClaudeAgentSdkQueryRunnerError);
+const isClaudeAgentSdkReplayError = Schema.is(ClaudeAgentSdkReplayError);
+
+function replayQueryRunnerError(
+  transcript: ClaudeAgentSdkReplayTranscript,
+  cause: unknown,
+): ClaudeAgentSdkQueryRunnerError {
+  if (isClaudeAgentSdkQueryRunnerError(cause)) {
+    return cause;
+  }
+  const replayCause = isClaudeAgentSdkReplayError(cause)
+    ? cause
+    : new ClaudeReplayDriverError({ scenario: transcript.scenario, cause });
+  return new ClaudeAgentSdkQueryRunnerError({
+    cause: replayCause,
+    method: `replay-scenario:${transcript.scenario}`,
+  });
+}
+
+const makeClaudeAgentSdkReplayQueryRunner = Effect.fn("ClaudeAgentSdkReplayQueryRunner.layer")(
+  function* (
+    transcript: ClaudeAgentSdkReplayTranscript,
+    options: { readonly replayGate?: ProviderReplayGate } = {},
+  ) {
+    const queryRunner = makeReplayQueryRunner(transcript, options);
+    yield* Effect.addFinalizer(() =>
+      Effect.sync(() => {
+        queryRunner.assertComplete();
+      }),
+    );
+
+    return ClaudeAgentSdkQueryRunner.of({
+      allocateSessionId: Effect.succeed(nativeSessionIdFor(transcript)),
+      open: (input) =>
+        Effect.try({
+          try: () => queryRunner.open(input),
+          catch: (cause) => replayQueryRunnerError(transcript, cause),
+        }),
+      forkSession: (input) =>
+        Effect.try({
+          try: () => queryRunner.forkSession(input),
+          catch: (cause) => replayQueryRunnerError(transcript, cause),
+        }),
+      assertComplete: Effect.try({
+        try: () => queryRunner.assertComplete(),
+        catch: (cause) => replayQueryRunnerError(transcript, cause),
+      }),
+    });
+  },
+);
+
+export function makeClaudeAgentSdkReplayQueryRunnerLayer(
+  transcript: ClaudeAgentSdkReplayTranscript,
+  options: { readonly replayGate?: ProviderReplayGate } = {},
+): Layer.Layer<ClaudeAgentSdkQueryRunner> {
+  return Layer.effect(
+    ClaudeAgentSdkQueryRunner,
+    makeClaudeAgentSdkReplayQueryRunner(transcript, options),
+  );
+}
+
+export function makeClaudeAgentSdkReplayLayer(
+  transcript: ClaudeAgentSdkReplayTranscript,
+  options: { readonly replayGate?: ProviderReplayGate } = {},
+): Layer.Layer<ClaudeAgentSdkQueryRunner> {
+  const queryRunner = makeReplayQueryRunner(transcript, options);
+  return Layer.effect(
+    ClaudeAgentSdkQueryRunner,
+    Effect.gen(function* () {
+      yield* Effect.addFinalizer(() =>
+        Effect.sync(() => {
+          queryRunner.assertComplete();
+        }),
+      );
+
+      return ClaudeAgentSdkQueryRunner.of({
+        allocateSessionId: Effect.succeed(nativeSessionIdFor(transcript)),
+        open: (input) =>
+          Effect.try({
+            try: () => queryRunner.open(input),
+            catch: (cause) => replayQueryRunnerError(transcript, cause),
+          }),
+        forkSession: (input) =>
+          Effect.try({
+            try: () => queryRunner.forkSession(input),
+            catch: (cause) => replayQueryRunnerError(transcript, cause),
+          }),
+        assertComplete: Effect.try({
+          try: () => queryRunner.assertComplete(),
+          catch: (cause) => replayQueryRunnerError(transcript, cause),
+        }),
+      });
+    }),
+  );
+}
+
+export function makeClaudeProviderAdapterRegistryReplayLayer(
+  transcript: ClaudeAgentSdkReplayTranscript,
+  options: { readonly replayGate?: ProviderReplayGate } = {},
+) {
+  const serverConfigLayer = Layer.effect(
+    ServerConfig,
+    makeReplayServerConfig(transcript.scenario).pipe(Effect.orDie),
+  ).pipe(Layer.provide(NodeServices.layer));
+  return makeProviderAdapterRegistryDriverLayer({
+    drivers: [ClaudeAdapterV2Driver],
+    configMap: {
+      [CLAUDE_DEFAULT_INSTANCE_ID]: {
+        driver: CLAUDE_DRIVER_KIND,
+      },
+    },
+  }).pipe(
+    Layer.provide(
+      Layer.mergeAll(
+        makeClaudeAgentSdkReplayLayer(transcript, options),
+        idAllocatorLayer,
+        NodeServices.layer,
+        serverConfigLayer,
+      ),
+    ),
+  );
+}
+
+export async function replayClaudeAgentSdkTranscript(input: {
+  readonly transcript: ClaudeAgentSdkReplayTranscript;
+  readonly prompts: ReadonlyArray<string>;
+  readonly modelSelection: ModelSelection;
+  readonly cwd?: string;
+}): Promise<ReadonlyArray<SDKMessage>> {
+  return input.transcript.entries.flatMap((entry) =>
+    entry.type === "emit_inbound" && isClaudeSdkReplayMessage(entry.frame)
+      ? [sdkMessageFromReplayFrame(entry.frame)]
+      : [],
+  );
+}
+
+function serializeReplayError(error: unknown, scenario?: string): unknown {
+  return error instanceof Error
+    ? {
+        name: error.name,
+        message:
+          scenario === undefined
+            ? error.message
+            : sanitizeReplayText({ text: error.message, scenario }),
+      }
+    : error;
+}
+
+function permissionResultForRecording(input: {
+  readonly decision: ProviderApprovalDecision;
+  readonly toolInput: Record<string, unknown>;
+  readonly toolUseID: string;
+  readonly suggestions?: Parameters<CanUseTool>[2]["suggestions"];
+}): PermissionResult {
+  if (input.decision === "accept" || input.decision === "acceptForSession") {
+    return {
+      behavior: "allow",
+      updatedInput: input.toolInput,
+      toolUseID: input.toolUseID,
+      decisionClassification:
+        input.decision === "acceptForSession" ? "user_permanent" : "user_temporary",
+      ...(input.decision === "acceptForSession" && input.suggestions !== undefined
+        ? { updatedPermissions: input.suggestions }
+        : {}),
+    };
+  }
+  return {
+    behavior: "deny",
+    message:
+      input.decision === "cancel"
+        ? "User cancelled tool execution."
+        : "User declined tool execution.",
+    toolUseID: input.toolUseID,
+    decisionClassification: "user_reject",
+    ...(input.decision === "cancel" ? { interrupt: true } : {}),
+  };
+}
+
+function permissionRequestFrame(input: {
+  readonly toolName: string;
+  readonly toolInput: Record<string, unknown>;
+  readonly callbackOptions: Parameters<CanUseTool>[2];
+}): ClaudePermissionRequestFrame {
+  const { callbackOptions } = input;
+  return {
+    type: "permission.request",
+    toolName: input.toolName,
+    input: input.toolInput,
+    options: {
+      ...(callbackOptions.suggestions === undefined
+        ? {}
+        : { suggestions: callbackOptions.suggestions }),
+      ...(callbackOptions.blockedPath === undefined
+        ? {}
+        : { blockedPath: callbackOptions.blockedPath }),
+      ...(callbackOptions.decisionReason === undefined
+        ? {}
+        : { decisionReason: callbackOptions.decisionReason }),
+      ...(callbackOptions.title === undefined ? {} : { title: callbackOptions.title }),
+      ...(callbackOptions.displayName === undefined
+        ? {}
+        : { displayName: callbackOptions.displayName }),
+      ...(callbackOptions.description === undefined
+        ? {}
+        : { description: callbackOptions.description }),
+      toolUseID: callbackOptions.toolUseID,
+      ...(callbackOptions.agentID === undefined ? {} : { agentID: callbackOptions.agentID }),
+    },
+  };
+}
+
+function sanitizedReplayCwd(scenario: string): string {
+  return `/tmp/claude-replay-${scenario}`;
+}
+
+function parentDirectory(input: string): string {
+  const trimmed = input.replace(/\/+$/u, "");
+  const lastSlash = trimmed.lastIndexOf("/");
+  if (lastSlash <= 0) {
+    return "/";
+  }
+  return trimmed.slice(0, lastSlash);
+}
+
+function sanitizeReplayText(input: { readonly text: string; readonly scenario: string }): string {
+  const sanitizedCwd = sanitizedReplayCwd(input.scenario);
+  const repoRoot = parentDirectory(parentDirectory(process.cwd()));
+  return [repoRoot, process.cwd()]
+    .toSorted((left, right) => right.length - left.length)
+    .reduce((text, localPath) => text.replaceAll(localPath, sanitizedCwd), input.text);
+}
+
+function sanitizeSdkMessageForReplay(input: {
+  readonly message: SDKMessage;
+  readonly scenario: string;
+}): SDKMessage {
+  const { message } = input;
+  if (message.type === "system" && message.subtype === "init") {
+    return {
+      type: "system",
+      subtype: "init",
+      ...(message.agents === undefined ? {} : { agents: [] }),
+      apiKeySource: message.apiKeySource,
+      ...(message.betas === undefined ? {} : { betas: message.betas }),
+      claude_code_version: message.claude_code_version,
+      cwd: sanitizedReplayCwd(input.scenario),
+      tools: [],
+      mcp_servers: [],
+      model: message.model,
+      permissionMode: message.permissionMode,
+      slash_commands: [],
+      output_style: message.output_style,
+      skills: [],
+      plugins: [],
+      ...(message.fast_mode_state === undefined
+        ? {}
+        : { fast_mode_state: message.fast_mode_state }),
+      uuid: message.uuid,
+      session_id: message.session_id,
+    };
+  }
+  if (message.type === "rate_limit_event") {
+    return {
+      ...message,
+      rate_limit_info: {
+        status: message.rate_limit_info.status,
+      },
+    };
+  }
+  if (message.type === "result" && message.subtype !== "success" && message.errors.length > 0) {
+    return {
+      ...message,
+      errors: message.errors.map((error) =>
+        sanitizeReplayText({ text: error, scenario: input.scenario }),
+      ),
+    };
+  }
+  return message;
+}
+
+class RecordingPromptQueue implements AsyncIterable<SDKUserMessage> {
+  private readonly pending: Array<IteratorResult<SDKUserMessage>> = [];
+  private readonly waiters: Array<(result: IteratorResult<SDKUserMessage>) => void> = [];
+  private closed = false;
+
+  offer(message: SDKUserMessage): void {
+    if (this.closed) {
+      throw new Error("Cannot offer a prompt to a closed Claude recording queue.");
+    }
+    this.push({ done: false, value: message });
+  }
+
+  close(): void {
+    if (this.closed) {
+      return;
+    }
+    this.closed = true;
+    this.push({ done: true, value: undefined });
+  }
+
+  async *[Symbol.asyncIterator](): AsyncIterator<SDKUserMessage> {
+    while (true) {
+      const next = await this.take();
+      if (next.done === true) {
+        return;
+      }
+      yield next.value;
+    }
+  }
+
+  private push(result: IteratorResult<SDKUserMessage>): void {
+    const waiter = this.waiters.shift();
+    if (waiter === undefined) {
+      this.pending.push(result);
+      return;
+    }
+    waiter(result);
+  }
+
+  private take(): Promise<IteratorResult<SDKUserMessage>> {
+    const next = this.pending.shift();
+    if (next !== undefined) {
+      return Promise.resolve(next);
+    }
+    return new Promise((resolve) => {
+      this.waiters.push(resolve);
+    });
+  }
+}
+
+async function recordMessagesUntilTurnResult(input: {
+  readonly iterator: AsyncIterator<SDKMessage>;
+  readonly entries: Array<ProviderReplayEntry>;
+  readonly scenario: string;
+}): Promise<boolean> {
+  while (true) {
+    const next = await input.iterator.next();
+    if (next.done === true) {
+      return false;
+    }
+    const replayMessage = sanitizeSdkMessageForReplay({
+      message: next.value,
+      scenario: input.scenario,
+    });
+    input.entries.push({
+      type: "emit_inbound",
+      label: replayMessage.type,
+      frame: replayMessage,
+    });
+    if (replayMessage.type === "result") {
+      return true;
+    }
+  }
+}
+
+export async function recordMessagesUntilTurnResultAndFinalize(input: {
+  readonly iterator: AsyncIterator<SDKMessage>;
+  readonly entries: Array<ProviderReplayEntry>;
+  readonly scenario: string;
+  readonly finalize: () => void;
+}): Promise<boolean> {
+  try {
+    return await recordMessagesUntilTurnResult(input);
+  } finally {
+    input.finalize();
+  }
+}
+
+async function recordMessagesUntilTurnResultWithCursor(input: {
+  readonly iterator: AsyncIterator<SDKMessage>;
+  readonly entries: Array<ProviderReplayEntry>;
+  readonly scenario: string;
+}): Promise<{
+  readonly completed: boolean;
+  readonly assistantMessageUuid: SDKAssistantMessage["uuid"] | null;
+}> {
+  let assistantMessageUuid: SDKAssistantMessage["uuid"] | null = null;
+  while (true) {
+    const next = await input.iterator.next();
+    if (next.done === true) {
+      return { completed: false, assistantMessageUuid };
+    }
+    const replayMessage = sanitizeSdkMessageForReplay({
+      message: next.value,
+      scenario: input.scenario,
+    });
+    input.entries.push({
+      type: "emit_inbound",
+      label: replayMessage.type,
+      frame: replayMessage,
+    });
+    if (replayMessage.type === "assistant") {
+      assistantMessageUuid = replayMessage.uuid;
+    }
+    if (replayMessage.type === "result") {
+      return { completed: true, assistantMessageUuid };
+    }
+  }
+}
+
+function requireAssistantCursor(input: {
+  readonly scenario: string;
+  readonly promptIndex: number;
+  readonly cursor: SDKAssistantMessage["uuid"] | null;
+}): SDKAssistantMessage["uuid"] {
+  if (input.cursor !== null) {
+    return input.cursor;
+  }
+  throw new Error(
+    `Claude replay scenario ${input.scenario} prompt ${input.promptIndex} completed without an SDKAssistantMessage.uuid cursor.`,
+  );
+}
+
+async function recordMessagesUntilTurnResults(input: {
+  readonly iterator: AsyncIterator<SDKMessage>;
+  readonly entries: Array<ProviderReplayEntry>;
+  readonly scenario: string;
+  readonly resultCount: number;
+}): Promise<boolean> {
+  let seenResults = 0;
+  while (true) {
+    const next = await input.iterator.next();
+    if (next.done === true) {
+      return false;
+    }
+    const replayMessage = sanitizeSdkMessageForReplay({
+      message: next.value,
+      scenario: input.scenario,
+    });
+    input.entries.push({
+      type: "emit_inbound",
+      label: replayMessage.type,
+      frame: replayMessage,
+    });
+    if (replayMessage.type === "result") {
+      seenResults += 1;
+      if (seenResults >= input.resultCount) {
+        return true;
+      }
+    }
+  }
+}
+
+async function recordMessagesUntilIteratorDone(input: {
+  readonly iterator: AsyncIterator<SDKMessage>;
+  readonly entries: Array<ProviderReplayEntry>;
+  readonly scenario: string;
+}): Promise<void> {
+  while (true) {
+    const next = await input.iterator.next();
+    if (next.done === true) {
+      return;
+    }
+    const replayMessage = sanitizeSdkMessageForReplay({
+      message: next.value,
+      scenario: input.scenario,
+    });
+    input.entries.push({
+      type: "emit_inbound",
+      label: replayMessage.type,
+      frame: replayMessage,
+    });
+  }
+}
+
+function sdkMessageHasToolUse(message: SDKMessage): boolean {
+  return (
+    message.type === "assistant" && message.message.content.some((part) => part.type === "tool_use")
+  );
+}
+
+async function recordMessagesUntilFirstToolUse(input: {
+  readonly iterator: AsyncIterator<SDKMessage>;
+  readonly entries: Array<ProviderReplayEntry>;
+  readonly scenario: string;
+}): Promise<void> {
+  while (true) {
+    const next = await input.iterator.next();
+    if (next.done === true) {
+      throw new Error(`Claude query ended before ${input.scenario} started a tool use.`);
+    }
+    const replayMessage = sanitizeSdkMessageForReplay({
+      message: next.value,
+      scenario: input.scenario,
+    });
+    input.entries.push({
+      type: "emit_inbound",
+      label: replayMessage.type,
+      frame: replayMessage,
+    });
+    if (replayMessage.type === "result") {
+      throw new Error(`Claude query completed before ${input.scenario} started a tool use.`);
+    }
+    if (sdkMessageHasToolUse(replayMessage)) {
+      return;
+    }
+  }
+}
+
+async function recordClaudeStreamingQuery(input: {
+  readonly scenario: string;
+  readonly prompts: ReadonlyArray<string>;
+  readonly modelSelection: ModelSelection;
+  readonly cwd: string;
+  readonly sessionId: string;
+  readonly entries: Array<ProviderReplayEntry>;
+  readonly enableTools?: boolean;
+  readonly tools?: ClaudeAgentSdkQueryTools;
+  readonly permissionMode?: ClaudeAgentSdkQueryOptions["permissionMode"];
+  readonly allowedTools?: ReadonlyArray<string>;
+  readonly disallowedTools?: ReadonlyArray<string>;
+  readonly allowDangerouslySkipPermissions?: boolean;
+  readonly enablePermissionCallback?: boolean;
+  readonly permissionDecision?: ProviderApprovalDecision;
+}): Promise<void> {
+  const promptQueue = new RecordingPromptQueue();
+  const canUseTool: CanUseTool | undefined =
+    input.enablePermissionCallback === true
+      ? async (toolName, toolInput, callbackOptions) => {
+          const requestFrame = permissionRequestFrame({
+            toolName,
+            toolInput,
+            callbackOptions,
+          });
+          input.entries.push({
+            type: "emit_inbound",
+            label: `permission.request:${toolName}`,
+            frame: requestFrame,
+          });
+          const result = permissionResultForRecording({
+            decision: input.permissionDecision ?? "accept",
+            toolInput,
+            toolUseID: callbackOptions.toolUseID,
+            ...(callbackOptions.suggestions === undefined
+              ? {}
+              : { suggestions: callbackOptions.suggestions }),
+          });
+          input.entries.push({
+            type: "expect_outbound",
+            label: `permission.response:${toolName}`,
+            frame: makeClaudePermissionResponseFrame(result),
+          });
+          return result;
+        }
+      : undefined;
+  const options = makeClaudeQueryOptions({
+    modelSelection: input.modelSelection,
+    nativeThreadId: input.sessionId,
+    resume: false,
+    cwd: input.cwd,
+    ...(input.enableTools === true
+      ? {
+          tools: input.tools ?? { type: "preset", preset: "claude_code" },
+          permissionMode: input.permissionMode ?? "default",
+          ...(input.allowedTools === undefined ? {} : { allowedTools: input.allowedTools }),
+          ...(input.disallowedTools === undefined
+            ? {}
+            : { disallowedTools: input.disallowedTools }),
+          ...(input.allowDangerouslySkipPermissions === true
+            ? { allowDangerouslySkipPermissions: true }
+            : {}),
+          ...(canUseTool === undefined ? {} : { canUseTool }),
+        }
+      : {}),
+  });
+  input.entries.push({
+    type: "expect_outbound",
+    label: "query.open",
+    frame: makeClaudeQueryOpenFrame({ options }),
+  });
+  const queryRuntime = query({
+    prompt: promptQueue,
+    options,
+  });
+  const iterator = queryRuntime[Symbol.asyncIterator]();
+  try {
+    for (const [index, prompt] of input.prompts.entries()) {
+      const message = makeClaudeUserMessage({ text: prompt });
+      input.entries.push({
+        type: "expect_outbound",
+        label: `prompt.offer:${index + 1}`,
+        frame: makeClaudePromptOfferFrame(message),
+      });
+      promptQueue.offer(message);
+      const completed = await recordMessagesUntilTurnResult({
+        iterator,
+        entries: input.entries,
+        scenario: input.scenario,
+      });
+      if (!completed) {
+        throw new Error(`Claude streaming query ended before prompt ${index + 1} completed.`);
+      }
+    }
+    promptQueue.close();
+    queryRuntime.close();
+    input.entries.push({
+      type: "runtime_exit",
+      status: "success",
+    });
+  } catch (error) {
+    promptQueue.close();
+    queryRuntime.close();
+    input.entries.push({
+      type: "runtime_exit",
+      status: "error",
+      error: serializeReplayError(error, input.scenario),
+    });
+    throw error;
+  }
+}
+
+async function recordClaudeActiveSteeringQuery(input: {
+  readonly scenario: string;
+  readonly prompts: ReadonlyArray<string>;
+  readonly modelSelection: ModelSelection;
+  readonly cwd: string;
+  readonly sessionId: string;
+  readonly entries: Array<ProviderReplayEntry>;
+  readonly enableTools?: boolean;
+  readonly tools?: ClaudeAgentSdkQueryTools;
+  readonly permissionMode?: ClaudeAgentSdkQueryOptions["permissionMode"];
+  readonly allowedTools?: ReadonlyArray<string>;
+  readonly disallowedTools?: ReadonlyArray<string>;
+  readonly allowDangerouslySkipPermissions?: boolean;
+  readonly enablePermissionCallback?: boolean;
+  readonly permissionDecision?: ProviderApprovalDecision;
+}): Promise<void> {
+  if (input.prompts.length < 2) {
+    throw new Error("Claude active steering replay recording requires at least two prompts.");
+  }
+
+  const promptQueue = new RecordingPromptQueue();
+  const offeredPrompts = new Set<number>();
+  const offerPrompt = (index: number, priority?: SDKUserMessage["priority"]) => {
+    const message = makeClaudeUserMessage({
+      text: input.prompts[index]!,
+      ...(priority === undefined ? {} : { priority }),
+    });
+    input.entries.push({
+      type: "expect_outbound",
+      label: `prompt.offer:${index + 1}`,
+      frame: makeClaudePromptOfferFrame(message),
+    });
+    promptQueue.offer(message);
+    offeredPrompts.add(index);
+  };
+  const offerSteeringPrompts = () => {
+    for (let index = 1; index < input.prompts.length; index += 1) {
+      if (!offeredPrompts.has(index)) {
+        offerPrompt(index, "now");
+      }
+    }
+  };
+
+  const canUseTool: CanUseTool | undefined =
+    input.enablePermissionCallback === true
+      ? async (toolName, toolInput, callbackOptions) => {
+          const requestFrame = permissionRequestFrame({
+            toolName,
+            toolInput,
+            callbackOptions,
+          });
+          input.entries.push({
+            type: "emit_inbound",
+            label: `permission.request:${toolName}`,
+            frame: requestFrame,
+          });
+          const result = permissionResultForRecording({
+            decision: input.permissionDecision ?? "accept",
+            toolInput,
+            toolUseID: callbackOptions.toolUseID,
+            ...(callbackOptions.suggestions === undefined
+              ? {}
+              : { suggestions: callbackOptions.suggestions }),
+          });
+          input.entries.push({
+            type: "expect_outbound",
+            label: `permission.response:${toolName}`,
+            frame: makeClaudePermissionResponseFrame(result),
+          });
+          return result;
+        }
+      : undefined;
+  const options = makeClaudeQueryOptions({
+    modelSelection: input.modelSelection,
+    nativeThreadId: input.sessionId,
+    resume: false,
+    cwd: input.cwd,
+    ...(input.enableTools === true
+      ? {
+          tools: input.tools ?? { type: "preset", preset: "claude_code" },
+          permissionMode: input.permissionMode ?? "default",
+          ...(input.allowedTools === undefined ? {} : { allowedTools: input.allowedTools }),
+          ...(input.disallowedTools === undefined
+            ? {}
+            : { disallowedTools: input.disallowedTools }),
+          ...(input.allowDangerouslySkipPermissions === true
+            ? { allowDangerouslySkipPermissions: true }
+            : {}),
+          ...(canUseTool === undefined ? {} : { canUseTool }),
+        }
+      : {}),
+  });
+  input.entries.push({
+    type: "expect_outbound",
+    label: "query.open",
+    frame: makeClaudeQueryOpenFrame({ options }),
+  });
+  const queryRuntime = query({
+    prompt: promptQueue,
+    options,
+  });
+  const iterator = queryRuntime[Symbol.asyncIterator]();
+  try {
+    offerPrompt(0);
+    offerSteeringPrompts();
+    const completed = await recordMessagesUntilTurnResults({
+      iterator,
+      entries: input.entries,
+      scenario: input.scenario,
+      resultCount: input.prompts.length,
+    });
+    if (!completed) {
+      throw new Error("Claude active steering query ended before the turn completed.");
+    }
+    if (offeredPrompts.size < input.prompts.length) {
+      throw new Error("Claude active steering prompts were not all offered before completion.");
+    }
+    promptQueue.close();
+    queryRuntime.close();
+    input.entries.push({
+      type: "runtime_exit",
+      status: "success",
+    });
+  } catch (error) {
+    promptQueue.close();
+    queryRuntime.close();
+    input.entries.push({
+      type: "runtime_exit",
+      status: "error",
+      error: serializeReplayError(error, input.scenario),
+    });
+    throw error;
+  }
+}
+
+async function recordClaudeRestartingQueries(input: {
+  readonly scenario: string;
+  readonly prompts: ReadonlyArray<string>;
+  readonly modelSelection: ModelSelection;
+  readonly cwd: string;
+  readonly sessionId: string;
+  readonly entries: Array<ProviderReplayEntry>;
+  readonly enableTools?: boolean;
+  readonly tools?: ClaudeAgentSdkQueryTools;
+  readonly permissionMode?: ClaudeAgentSdkQueryOptions["permissionMode"];
+  readonly allowedTools?: ReadonlyArray<string>;
+  readonly disallowedTools?: ReadonlyArray<string>;
+  readonly allowDangerouslySkipPermissions?: boolean;
+}): Promise<void> {
+  for (const [index, prompt] of input.prompts.entries()) {
+    const promptQueue = new RecordingPromptQueue();
+    const options = makeClaudeQueryOptions({
+      modelSelection: input.modelSelection,
+      nativeThreadId: input.sessionId,
+      resume: index > 0,
+      cwd: input.cwd,
+      ...(input.enableTools === true
+        ? {
+            tools: input.tools ?? { type: "preset", preset: "claude_code" },
+            permissionMode: input.permissionMode ?? "default",
+            ...(input.allowedTools === undefined ? {} : { allowedTools: input.allowedTools }),
+            ...(input.disallowedTools === undefined
+              ? {}
+              : { disallowedTools: input.disallowedTools }),
+            ...(input.allowDangerouslySkipPermissions === true
+              ? { allowDangerouslySkipPermissions: true }
+              : {}),
+          }
+        : {}),
+    });
+
+    input.entries.push({
+      type: "expect_outbound",
+      label: `query.open:${index + 1}`,
+      frame: makeClaudeQueryOpenFrame({ options }),
+    });
+    const message = makeClaudeUserMessage({ text: prompt });
+    input.entries.push({
+      type: "expect_outbound",
+      label: `prompt.offer:${index + 1}`,
+      frame: makeClaudePromptOfferFrame(message),
+    });
+
+    try {
+      const queryRuntime = query({
+        prompt: promptQueue,
+        options,
+      });
+      promptQueue.offer(message);
+      promptQueue.close();
+      const iterator = queryRuntime[Symbol.asyncIterator]();
+      for (;;) {
+        const next = await iterator.next();
+        if (next.done === true) {
+          break;
+        }
+        const replayMessage = sanitizeSdkMessageForReplay({
+          message: next.value,
+          scenario: input.scenario,
+        });
+        input.entries.push({
+          type: "emit_inbound",
+          label: replayMessage.type,
+          frame: replayMessage,
+        });
+      }
+      input.entries.push({
+        type: "runtime_exit",
+        status: "success",
+      });
+    } catch (error) {
+      promptQueue.close();
+      input.entries.push({
+        type: "runtime_exit",
+        status: "error",
+        error: serializeReplayError(error, input.scenario),
+      });
+      throw error;
+    }
+  }
+}
+
+async function recordClaudeResumeAtCursorQuery(input: {
+  readonly scenario: string;
+  readonly prompts: ReadonlyArray<string>;
+  readonly modelSelection: ModelSelection;
+  readonly cwd: string;
+  readonly sessionId: string;
+  readonly entries: Array<ProviderReplayEntry>;
+  readonly metadata: Record<string, unknown>;
+  readonly enableTools?: boolean;
+  readonly tools?: ClaudeAgentSdkQueryTools;
+  readonly permissionMode?: ClaudeAgentSdkQueryOptions["permissionMode"];
+  readonly allowedTools?: ReadonlyArray<string>;
+  readonly disallowedTools?: ReadonlyArray<string>;
+  readonly allowDangerouslySkipPermissions?: boolean;
+}): Promise<void> {
+  if (input.prompts.length !== 3) {
+    throw new Error(
+      `Claude resume-at-cursor replay scenario ${input.scenario} requires exactly three prompts.`,
+    );
+  }
+
+  const sourcePromptQueue = new RecordingPromptQueue();
+  const sourceOptions = makeClaudeQueryOptions({
+    modelSelection: input.modelSelection,
+    nativeThreadId: input.sessionId,
+    resume: false,
+    cwd: input.cwd,
+    ...(input.enableTools === true
+      ? {
+          tools: input.tools ?? { type: "preset", preset: "claude_code" },
+          permissionMode: input.permissionMode ?? "default",
+          ...(input.allowedTools === undefined ? {} : { allowedTools: input.allowedTools }),
+          ...(input.disallowedTools === undefined
+            ? {}
+            : { disallowedTools: input.disallowedTools }),
+          ...(input.allowDangerouslySkipPermissions === true
+            ? { allowDangerouslySkipPermissions: true }
+            : {}),
+        }
+      : {}),
+  });
+
+  input.entries.push({
+    type: "expect_outbound",
+    label: "query.open:source",
+    frame: makeClaudeQueryOpenFrame({ options: sourceOptions }),
+  });
+  const sourceRuntime = query({
+    prompt: sourcePromptQueue,
+    options: sourceOptions,
+  });
+  const sourceIterator = sourceRuntime[Symbol.asyncIterator]();
+
+  try {
+    const sourceCursors: Array<SDKAssistantMessage["uuid"]> = [];
+    for (const [index, prompt] of input.prompts.slice(0, 2).entries()) {
+      const message = makeClaudeUserMessage({ text: prompt });
+      input.entries.push({
+        type: "expect_outbound",
+        label: `prompt.offer:${index + 1}`,
+        frame: makeClaudePromptOfferFrame(message),
+      });
+      sourcePromptQueue.offer(message);
+      const result = await recordMessagesUntilTurnResultWithCursor({
+        iterator: sourceIterator,
+        entries: input.entries,
+        scenario: input.scenario,
+      });
+      if (!result.completed) {
+        throw new Error(`Claude source query ended before prompt ${index + 1} completed.`);
+      }
+      sourceCursors.push(
+        requireAssistantCursor({
+          scenario: input.scenario,
+          promptIndex: index + 1,
+          cursor: result.assistantMessageUuid,
+        }),
+      );
+    }
+    sourcePromptQueue.close();
+    sourceRuntime.close();
+    input.entries.push({
+      type: "runtime_exit",
+      status: "success",
+    });
+
+    const resumeSessionAt = sourceCursors[0]!;
+    input.metadata.resumeSessionAt = resumeSessionAt;
+    input.metadata.sourceAssistantMessageUuids = sourceCursors;
+
+    const resumedPromptQueue = new RecordingPromptQueue();
+    const resumedOptions = {
+      ...makeClaudeQueryOptions({
+        modelSelection: input.modelSelection,
+        nativeThreadId: input.sessionId,
+        resume: true,
+        cwd: input.cwd,
+        ...(input.enableTools === true
+          ? {
+              tools: input.tools ?? { type: "preset", preset: "claude_code" },
+              permissionMode: input.permissionMode ?? "default",
+              ...(input.allowedTools === undefined ? {} : { allowedTools: input.allowedTools }),
+              ...(input.disallowedTools === undefined
+                ? {}
+                : { disallowedTools: input.disallowedTools }),
+              ...(input.allowDangerouslySkipPermissions === true
+                ? { allowDangerouslySkipPermissions: true }
+                : {}),
+            }
+          : {}),
+      }),
+      resumeSessionAt,
+    } satisfies ClaudeAgentSdkQueryOptions;
+    input.entries.push({
+      type: "expect_outbound",
+      label: "query.open:resume_at_cursor",
+      frame: makeClaudeQueryOpenFrame({ options: resumedOptions }),
+    });
+    const resumedMessage = makeClaudeUserMessage({ text: input.prompts[2]! });
+    input.entries.push({
+      type: "expect_outbound",
+      label: "prompt.offer:3",
+      frame: makeClaudePromptOfferFrame(resumedMessage),
+    });
+
+    const resumedRuntime = query({
+      prompt: resumedPromptQueue,
+      options: resumedOptions,
+    });
+    resumedPromptQueue.offer(resumedMessage);
+    resumedPromptQueue.close();
+    const resumedIterator = resumedRuntime[Symbol.asyncIterator]();
+    const resumed = await recordMessagesUntilTurnResultAndFinalize({
+      iterator: resumedIterator,
+      entries: input.entries,
+      scenario: input.scenario,
+      finalize: () => {
+        resumedPromptQueue.close();
+        resumedRuntime.close();
+      },
+    });
+    if (!resumed) {
+      throw new Error("Claude resumed query ended before prompt 3 completed.");
+    }
+    input.entries.push({
+      type: "runtime_exit",
+      status: "success",
+    });
+  } catch (error) {
+    sourcePromptQueue.close();
+    sourceRuntime.close();
+    input.entries.push({
+      type: "runtime_exit",
+      status: "error",
+      error: serializeReplayError(error, input.scenario),
+    });
+    throw error;
+  }
+}
+
+async function recordClaudeForkSessionQuery(input: {
+  readonly scenario: string;
+  readonly prompts: ReadonlyArray<string>;
+  readonly modelSelection: ModelSelection;
+  readonly cwd: string;
+  readonly sessionId: string;
+  readonly entries: Array<ProviderReplayEntry>;
+  readonly metadata: Record<string, unknown>;
+  readonly forkFromPromptIndex?: 1 | 2;
+  readonly sourcePromptCount?: number;
+  readonly forkPromptGroups?: ReadonlyArray<ReadonlyArray<string>>;
+  readonly sourceContinuationPromptCount?: number;
+  readonly enableTools?: boolean;
+  readonly tools?: ClaudeAgentSdkQueryTools;
+  readonly permissionMode?: ClaudeAgentSdkQueryOptions["permissionMode"];
+  readonly allowedTools?: ReadonlyArray<string>;
+  readonly disallowedTools?: ReadonlyArray<string>;
+  readonly allowDangerouslySkipPermissions?: boolean;
+}): Promise<void> {
+  if (input.prompts.length < 2) {
+    throw new Error(
+      `Claude fork-session replay scenario ${input.scenario} requires at least two prompts.`,
+    );
+  }
+  const sourceContinuationPromptCount = input.sourceContinuationPromptCount ?? 0;
+  const forkPromptEnd = input.prompts.length - sourceContinuationPromptCount;
+  const sourcePromptCount = input.sourcePromptCount ?? forkPromptEnd - 1;
+  if (
+    sourceContinuationPromptCount < 0 ||
+    sourceContinuationPromptCount >= input.prompts.length ||
+    sourcePromptCount < 1 ||
+    sourcePromptCount >= forkPromptEnd
+  ) {
+    throw new Error(
+      `Claude fork-session replay scenario ${input.scenario} requires at least one source prompt and one fork prompt.`,
+    );
+  }
+  const forkFromPromptIndex = input.forkFromPromptIndex ?? sourcePromptCount;
+  if (forkFromPromptIndex > sourcePromptCount) {
+    throw new Error(
+      `Claude fork-session replay scenario ${input.scenario} cannot fork from prompt ${forkFromPromptIndex} after recording ${sourcePromptCount} source prompts.`,
+    );
+  }
+
+  const sourcePromptQueue = new RecordingPromptQueue();
+  const sourceOptions = makeClaudeQueryOptions({
+    modelSelection: input.modelSelection,
+    nativeThreadId: input.sessionId,
+    resume: false,
+    cwd: input.cwd,
+    ...(input.enableTools === true
+      ? {
+          tools: input.tools ?? { type: "preset", preset: "claude_code" },
+          permissionMode: input.permissionMode ?? "default",
+          ...(input.allowedTools === undefined ? {} : { allowedTools: input.allowedTools }),
+          ...(input.disallowedTools === undefined
+            ? {}
+            : { disallowedTools: input.disallowedTools }),
+          ...(input.allowDangerouslySkipPermissions === true
+            ? { allowDangerouslySkipPermissions: true }
+            : {}),
+        }
+      : {}),
+  });
+  input.entries.push({
+    type: "expect_outbound",
+    label: "query.open:source",
+    frame: makeClaudeQueryOpenFrame({ options: sourceOptions }),
+  });
+  const sourceRuntime = query({
+    prompt: sourcePromptQueue,
+    options: sourceOptions,
+  });
+  const sourceIterator = sourceRuntime[Symbol.asyncIterator]();
+
+  try {
+    const sourceCursors: Array<SDKAssistantMessage["uuid"]> = [];
+    for (const [index, prompt] of input.prompts.slice(0, sourcePromptCount).entries()) {
+      const message = makeClaudeUserMessage({ text: prompt });
+      input.entries.push({
+        type: "expect_outbound",
+        label: `prompt.offer:${index + 1}`,
+        frame: makeClaudePromptOfferFrame(message),
+      });
+      sourcePromptQueue.offer(message);
+      const result = await recordMessagesUntilTurnResultWithCursor({
+        iterator: sourceIterator,
+        entries: input.entries,
+        scenario: input.scenario,
+      });
+      if (!result.completed) {
+        throw new Error(`Claude source query ended before prompt ${index + 1} completed.`);
+      }
+      sourceCursors.push(
+        requireAssistantCursor({
+          scenario: input.scenario,
+          promptIndex: index + 1,
+          cursor: result.assistantMessageUuid,
+        }),
+      );
+    }
+    sourcePromptQueue.close();
+    sourceRuntime.close();
+    input.entries.push({
+      type: "runtime_exit",
+      status: "success",
+    });
+
+    const upToMessageId = sourceCursors[forkFromPromptIndex - 1]!;
+    const forkPrompts = input.prompts.slice(sourcePromptCount, forkPromptEnd);
+    const forkPromptGroups = input.forkPromptGroups ?? [forkPrompts];
+    if (
+      forkPromptGroups.length === 0 ||
+      forkPromptGroups.some((group) => group.length === 0) ||
+      forkPromptGroups.flat().join("\n") !== forkPrompts.join("\n")
+    ) {
+      throw new Error(
+        `Claude fork-session replay scenario ${input.scenario} has invalid fork prompt groups.`,
+      );
+    }
+    input.metadata.sourceAssistantMessageUuids = sourceCursors;
+    input.metadata.forkUpToMessageId = upToMessageId;
+    const forkedNativeSessionIds: Array<string> = [];
+    let promptOrdinal = sourcePromptCount;
+    for (const [groupIndex, forkPrompts] of forkPromptGroups.entries()) {
+      const labelSuffix = forkPromptGroups.length === 1 ? "" : `:${groupIndex + 1}`;
+      input.entries.push({
+        type: "expect_outbound",
+        label: `session.fork${labelSuffix}`,
+        frame: {
+          type: "session.fork",
+          sessionId: input.sessionId,
+          options: {
+            dir: sanitizedReplayCwd(input.scenario),
+            upToMessageId,
+          },
+        },
+      });
+      const forked = await forkSession(input.sessionId, {
+        dir: input.cwd,
+        upToMessageId,
+      });
+      forkedNativeSessionIds.push(forked.sessionId);
+      input.entries.push({
+        type: "emit_inbound",
+        label: `session.forked${labelSuffix}`,
+        frame: {
+          type: "session.forked",
+          sessionId: forked.sessionId,
+        },
+      });
+
+      const targetPromptQueue = new RecordingPromptQueue();
+      const targetOptions = makeClaudeQueryOptions({
+        modelSelection: input.modelSelection,
+        nativeThreadId: forked.sessionId,
+        resume: true,
+        cwd: input.cwd,
+        ...(input.enableTools === true
+          ? {
+              tools: input.tools ?? { type: "preset", preset: "claude_code" },
+              permissionMode: input.permissionMode ?? "default",
+              ...(input.allowedTools === undefined ? {} : { allowedTools: input.allowedTools }),
+              ...(input.disallowedTools === undefined
+                ? {}
+                : { disallowedTools: input.disallowedTools }),
+              ...(input.allowDangerouslySkipPermissions === true
+                ? { allowDangerouslySkipPermissions: true }
+                : {}),
+            }
+          : {}),
+      });
+      input.entries.push({
+        type: "expect_outbound",
+        label: `query.open:fork${labelSuffix}`,
+        frame: makeClaudeQueryOpenFrame({ options: targetOptions }),
+      });
+      const targetRuntime = query({
+        prompt: targetPromptQueue,
+        options: targetOptions,
+      });
+      const targetIterator = targetRuntime[Symbol.asyncIterator]();
+      for (const prompt of forkPrompts) {
+        promptOrdinal += 1;
+        const targetMessage = makeClaudeUserMessage({ text: prompt });
+        input.entries.push({
+          type: "expect_outbound",
+          label: `prompt.offer:${promptOrdinal}`,
+          frame: makeClaudePromptOfferFrame(targetMessage),
+        });
+        targetPromptQueue.offer(targetMessage);
+        const completed = await recordMessagesUntilTurnResult({
+          iterator: targetIterator,
+          entries: input.entries,
+          scenario: input.scenario,
+        });
+        if (!completed) {
+          throw new Error(`Claude fork query ended before prompt ${promptOrdinal} completed.`);
+        }
+      }
+      targetPromptQueue.close();
+      targetRuntime.close();
+      input.entries.push({
+        type: "runtime_exit",
+        status: "success",
+      });
+    }
+    input.metadata.forkedNativeSessionId = forkedNativeSessionIds[0];
+    input.metadata.forkedNativeSessionIds = forkedNativeSessionIds;
+    if (sourceContinuationPromptCount > 0) {
+      const continuationPromptQueue = new RecordingPromptQueue();
+      const continuationOptions = makeClaudeQueryOptions({
+        modelSelection: input.modelSelection,
+        nativeThreadId: input.sessionId,
+        resume: true,
+        cwd: input.cwd,
+        ...(input.enableTools === true
+          ? {
+              tools: input.tools ?? { type: "preset", preset: "claude_code" },
+              permissionMode: input.permissionMode ?? "default",
+              ...(input.allowedTools === undefined ? {} : { allowedTools: input.allowedTools }),
+              ...(input.disallowedTools === undefined
+                ? {}
+                : { disallowedTools: input.disallowedTools }),
+              ...(input.allowDangerouslySkipPermissions === true
+                ? { allowDangerouslySkipPermissions: true }
+                : {}),
+            }
+          : {}),
+      });
+      input.entries.push({
+        type: "expect_outbound",
+        label: "query.open:source-continuation",
+        frame: makeClaudeQueryOpenFrame({ options: continuationOptions }),
+      });
+      const continuationRuntime = query({
+        prompt: continuationPromptQueue,
+        options: continuationOptions,
+      });
+      const continuationIterator = continuationRuntime[Symbol.asyncIterator]();
+      for (const prompt of input.prompts.slice(forkPromptEnd)) {
+        promptOrdinal += 1;
+        const continuationMessage = makeClaudeUserMessage({ text: prompt });
+        input.entries.push({
+          type: "expect_outbound",
+          label: `prompt.offer:${promptOrdinal}`,
+          frame: makeClaudePromptOfferFrame(continuationMessage),
+        });
+        continuationPromptQueue.offer(continuationMessage);
+        const completed = await recordMessagesUntilTurnResult({
+          iterator: continuationIterator,
+          entries: input.entries,
+          scenario: input.scenario,
+        });
+        if (!completed) {
+          throw new Error(
+            `Claude source continuation ended before prompt ${promptOrdinal} completed.`,
+          );
+        }
+      }
+      continuationPromptQueue.close();
+      continuationRuntime.close();
+      input.entries.push({
+        type: "runtime_exit",
+        status: "success",
+      });
+      input.metadata.sourceContinuationPromptCount = sourceContinuationPromptCount;
+    }
+  } catch (error) {
+    sourcePromptQueue.close();
+    sourceRuntime.close();
+    input.entries.push({
+      type: "runtime_exit",
+      status: "error",
+      error: serializeReplayError(error, input.scenario),
+    });
+    throw error;
+  }
+}
+
+export async function recordInterruptedClaudeQuery(input: {
+  readonly scenario: string;
+  readonly prompt: string;
+  readonly modelSelection: ModelSelection;
+  readonly cwd: string;
+  readonly sessionId: string;
+  readonly resume: boolean;
+  readonly entries: Array<ProviderReplayEntry>;
+  readonly queryOpenLabel: string;
+  readonly promptOfferLabel: string;
+  readonly interruptLabel: string;
+  readonly interruptAfter?: "prompt_offer" | "tool_use";
+  readonly enableTools?: boolean;
+  readonly tools?: ClaudeAgentSdkQueryTools;
+  readonly permissionMode?: ClaudeAgentSdkQueryOptions["permissionMode"];
+  readonly allowedTools?: ReadonlyArray<string>;
+  readonly disallowedTools?: ReadonlyArray<string>;
+  readonly allowDangerouslySkipPermissions?: boolean;
+}): Promise<void> {
+  const promptQueue = new RecordingPromptQueue();
+  const options = makeClaudeQueryOptions({
+    modelSelection: input.modelSelection,
+    nativeThreadId: input.sessionId,
+    resume: input.resume,
+    cwd: input.cwd,
+    ...(input.enableTools === true
+      ? {
+          tools: input.tools ?? { type: "preset", preset: "claude_code" },
+          permissionMode: input.permissionMode ?? "default",
+          ...(input.allowedTools === undefined ? {} : { allowedTools: input.allowedTools }),
+          ...(input.disallowedTools === undefined
+            ? {}
+            : { disallowedTools: input.disallowedTools }),
+          ...(input.allowDangerouslySkipPermissions === true
+            ? { allowDangerouslySkipPermissions: true }
+            : {}),
+        }
+      : {}),
+  });
+  input.entries.push({
+    type: "expect_outbound",
+    label: input.queryOpenLabel,
+    frame: makeClaudeQueryOpenFrame({ options }),
+  });
+  const runtime = query({
+    prompt: promptQueue,
+    options,
+  });
+  const iterator = runtime[Symbol.asyncIterator]();
+  const message = makeClaudeUserMessage({ text: input.prompt });
+  input.entries.push({
+    type: "expect_outbound",
+    label: input.promptOfferLabel,
+    frame: makeClaudePromptOfferFrame(message),
+  });
+  promptQueue.offer(message);
+
+  try {
+    if (input.interruptAfter === "tool_use") {
+      await recordMessagesUntilFirstToolUse({
+        iterator,
+        entries: input.entries,
+        scenario: input.scenario,
+      });
+      await Effect.runPromise(Effect.sleep(Duration.millis(250)));
+    }
+    input.entries.push({
+      type: "expect_outbound",
+      label: input.interruptLabel,
+      frame: { type: "query.interrupt" },
+    });
+
+    let cancelledError: unknown;
+    try {
+      await runtime.interrupt();
+    } catch (error) {
+      cancelledError = error;
+    }
+    promptQueue.close();
+    runtime.close();
+    try {
+      await recordMessagesUntilIteratorDone({
+        iterator,
+        entries: input.entries,
+        scenario: input.scenario,
+      });
+    } catch (error) {
+      cancelledError = error;
+    }
+    input.entries.push({
+      type: "runtime_exit",
+      status: cancelledError === undefined ? "success" : "cancelled",
+      ...(cancelledError === undefined
+        ? {}
+        : { error: serializeReplayError(cancelledError, input.scenario) }),
+    });
+  } catch (error) {
+    promptQueue.close();
+    runtime.close();
+    input.entries.push({
+      type: "runtime_exit",
+      status: "error",
+      error: serializeReplayError(error, input.scenario),
+    });
+    throw error;
+  }
+}
+
+async function recordClaudeInterruptQuery(input: {
+  readonly scenario: string;
+  readonly prompts: ReadonlyArray<string>;
+  readonly modelSelection: ModelSelection;
+  readonly cwd: string;
+  readonly sessionId: string;
+  readonly entries: Array<ProviderReplayEntry>;
+  readonly enableTools?: boolean;
+  readonly tools?: ClaudeAgentSdkQueryTools;
+  readonly permissionMode?: ClaudeAgentSdkQueryOptions["permissionMode"];
+  readonly allowedTools?: ReadonlyArray<string>;
+  readonly disallowedTools?: ReadonlyArray<string>;
+  readonly allowDangerouslySkipPermissions?: boolean;
+  readonly interruptAfter?: "prompt_offer" | "tool_use";
+}): Promise<void> {
+  if (input.prompts.length !== 1) {
+    throw new Error(
+      `Claude interrupt replay scenario ${input.scenario} requires exactly one prompt.`,
+    );
+  }
+
+  await recordInterruptedClaudeQuery({
+    scenario: input.scenario,
+    prompt: input.prompts[0]!,
+    modelSelection: input.modelSelection,
+    cwd: input.cwd,
+    sessionId: input.sessionId,
+    resume: false,
+    entries: input.entries,
+    queryOpenLabel: "query.open",
+    promptOfferLabel: "prompt.offer:1",
+    interruptLabel: "query.interrupt:1",
+    ...(input.interruptAfter === undefined ? {} : { interruptAfter: input.interruptAfter }),
+    ...(input.enableTools === undefined ? {} : { enableTools: input.enableTools }),
+    ...(input.tools === undefined ? {} : { tools: input.tools }),
+    ...(input.permissionMode === undefined ? {} : { permissionMode: input.permissionMode }),
+    ...(input.allowedTools === undefined ? {} : { allowedTools: input.allowedTools }),
+    ...(input.disallowedTools === undefined ? {} : { disallowedTools: input.disallowedTools }),
+    ...(input.allowDangerouslySkipPermissions === undefined
+      ? {}
+      : { allowDangerouslySkipPermissions: input.allowDangerouslySkipPermissions }),
+  });
+}
+
+async function recordClaudeInterruptRestartQuery(input: {
+  readonly scenario: string;
+  readonly prompts: ReadonlyArray<string>;
+  readonly modelSelection: ModelSelection;
+  readonly cwd: string;
+  readonly sessionId: string;
+  readonly entries: Array<ProviderReplayEntry>;
+  readonly enableTools?: boolean;
+  readonly tools?: ClaudeAgentSdkQueryTools;
+  readonly permissionMode?: ClaudeAgentSdkQueryOptions["permissionMode"];
+  readonly allowedTools?: ReadonlyArray<string>;
+  readonly disallowedTools?: ReadonlyArray<string>;
+  readonly allowDangerouslySkipPermissions?: boolean;
+  readonly interruptAfter?: "prompt_offer" | "tool_use";
+}): Promise<void> {
+  if (input.prompts.length !== 2) {
+    throw new Error(
+      `Claude interrupt-restart replay scenario ${input.scenario} requires exactly two prompts.`,
+    );
+  }
+
+  await recordInterruptedClaudeQuery({
+    scenario: input.scenario,
+    prompt: input.prompts[0]!,
+    modelSelection: input.modelSelection,
+    cwd: input.cwd,
+    sessionId: input.sessionId,
+    resume: false,
+    entries: input.entries,
+    queryOpenLabel: "query.open:1",
+    promptOfferLabel: "prompt.offer:1",
+    interruptLabel: "query.interrupt:1",
+    ...(input.interruptAfter === undefined ? {} : { interruptAfter: input.interruptAfter }),
+    ...(input.enableTools === undefined ? {} : { enableTools: input.enableTools }),
+    ...(input.tools === undefined ? {} : { tools: input.tools }),
+    ...(input.permissionMode === undefined ? {} : { permissionMode: input.permissionMode }),
+    ...(input.allowedTools === undefined ? {} : { allowedTools: input.allowedTools }),
+    ...(input.disallowedTools === undefined ? {} : { disallowedTools: input.disallowedTools }),
+    ...(input.allowDangerouslySkipPermissions === undefined
+      ? {}
+      : { allowDangerouslySkipPermissions: input.allowDangerouslySkipPermissions }),
+  });
+
+  const secondPromptQueue = new RecordingPromptQueue();
+  const secondOptions = makeClaudeQueryOptions({
+    modelSelection: input.modelSelection,
+    nativeThreadId: input.sessionId,
+    resume: true,
+    cwd: input.cwd,
+    ...(input.enableTools === true
+      ? {
+          tools: input.tools ?? { type: "preset", preset: "claude_code" },
+          permissionMode: input.permissionMode ?? "default",
+          ...(input.allowedTools === undefined ? {} : { allowedTools: input.allowedTools }),
+          ...(input.disallowedTools === undefined
+            ? {}
+            : { disallowedTools: input.disallowedTools }),
+          ...(input.allowDangerouslySkipPermissions === true
+            ? { allowDangerouslySkipPermissions: true }
+            : {}),
+        }
+      : {}),
+  });
+  input.entries.push({
+    type: "expect_outbound",
+    label: "query.open:2",
+    frame: makeClaudeQueryOpenFrame({ options: secondOptions }),
+  });
+  const secondMessage = makeClaudeUserMessage({ text: input.prompts[1]! });
+  input.entries.push({
+    type: "expect_outbound",
+    label: "prompt.offer:2",
+    frame: makeClaudePromptOfferFrame(secondMessage),
+  });
+
+  try {
+    const secondRuntime = query({
+      prompt: secondPromptQueue,
+      options: secondOptions,
+    });
+    secondPromptQueue.offer(secondMessage);
+    secondPromptQueue.close();
+    const secondIterator = secondRuntime[Symbol.asyncIterator]();
+    await recordMessagesUntilIteratorDone({
+      iterator: secondIterator,
+      entries: input.entries,
+      scenario: input.scenario,
+    });
+    secondRuntime.close();
+    input.entries.push({
+      type: "runtime_exit",
+      status: "success",
+    });
+  } catch (error) {
+    secondPromptQueue.close();
+    input.entries.push({
+      type: "runtime_exit",
+      status: "error",
+      error: serializeReplayError(error, input.scenario),
+    });
+    throw error;
+  }
+}
+
+export async function recordClaudeAgentSdkReplayTranscript(input: {
+  readonly scenario: string;
+  readonly prompts: ReadonlyArray<string>;
+  readonly modelSelection: ModelSelection;
+  readonly cwd: string;
+  readonly sessionId?: string;
+  readonly queryMode?:
+    | "streaming"
+    | "restart"
+    | "resume_at_cursor"
+    | "fork_session"
+    | "fork_session_prior_turn"
+    | "fork_session_continue"
+    | "fork_session_siblings"
+    | "fork_session_merge_back"
+    | "fork_session_merge_back_siblings"
+    | "active_steering"
+    | "interrupt"
+    | "interrupt_restart";
+  readonly enableTools?: boolean;
+  readonly tools?: ClaudeAgentSdkQueryTools;
+  readonly permissionMode?: ClaudeAgentSdkQueryOptions["permissionMode"];
+  readonly allowedTools?: ReadonlyArray<string>;
+  readonly disallowedTools?: ReadonlyArray<string>;
+  readonly allowDangerouslySkipPermissions?: boolean;
+  readonly enablePermissionCallback?: boolean;
+  readonly permissionDecision?: ProviderApprovalDecision;
+  readonly interruptAfter?: "prompt_offer" | "tool_use";
+}): Promise<ClaudeAgentSdkReplayTranscript> {
+  if (input.prompts.length === 0) {
+    throw new Error(
+      `Claude Agent SDK replay scenario ${input.scenario} needs at least one prompt.`,
+    );
+  }
+
+  const entries: Array<ProviderReplayEntry> = [];
+  const sessionId = input.sessionId ?? (await Effect.runPromise(randomUuidV4));
+  const queryMode = input.queryMode ?? "streaming";
+  const recordingMetadata: Record<string, unknown> = {};
+  if (queryMode === "streaming") {
+    await recordClaudeStreamingQuery({
+      scenario: input.scenario,
+      prompts: input.prompts,
+      modelSelection: input.modelSelection,
+      cwd: input.cwd,
+      sessionId,
+      entries,
+      ...(input.enableTools === undefined ? {} : { enableTools: input.enableTools }),
+      ...(input.tools === undefined ? {} : { tools: input.tools }),
+      ...(input.permissionMode === undefined ? {} : { permissionMode: input.permissionMode }),
+      ...(input.allowedTools === undefined ? {} : { allowedTools: input.allowedTools }),
+      ...(input.disallowedTools === undefined ? {} : { disallowedTools: input.disallowedTools }),
+      ...(input.allowDangerouslySkipPermissions === undefined
+        ? {}
+        : { allowDangerouslySkipPermissions: input.allowDangerouslySkipPermissions }),
+      ...(input.enablePermissionCallback === undefined
+        ? {}
+        : { enablePermissionCallback: input.enablePermissionCallback }),
+      ...(input.permissionDecision === undefined
+        ? {}
+        : { permissionDecision: input.permissionDecision }),
+    });
+  } else if (queryMode === "active_steering") {
+    await recordClaudeActiveSteeringQuery({
+      scenario: input.scenario,
+      prompts: input.prompts,
+      modelSelection: input.modelSelection,
+      cwd: input.cwd,
+      sessionId,
+      entries,
+      ...(input.enableTools === undefined ? {} : { enableTools: input.enableTools }),
+      ...(input.tools === undefined ? {} : { tools: input.tools }),
+      ...(input.permissionMode === undefined ? {} : { permissionMode: input.permissionMode }),
+      ...(input.allowedTools === undefined ? {} : { allowedTools: input.allowedTools }),
+      ...(input.disallowedTools === undefined ? {} : { disallowedTools: input.disallowedTools }),
+      ...(input.allowDangerouslySkipPermissions === undefined
+        ? {}
+        : { allowDangerouslySkipPermissions: input.allowDangerouslySkipPermissions }),
+      ...(input.enablePermissionCallback === undefined
+        ? {}
+        : { enablePermissionCallback: input.enablePermissionCallback }),
+      ...(input.permissionDecision === undefined
+        ? {}
+        : { permissionDecision: input.permissionDecision }),
+    });
+  } else if (queryMode === "restart") {
+    await recordClaudeRestartingQueries({
+      scenario: input.scenario,
+      prompts: input.prompts,
+      modelSelection: input.modelSelection,
+      cwd: input.cwd,
+      sessionId,
+      entries,
+      ...(input.enableTools === undefined ? {} : { enableTools: input.enableTools }),
+      ...(input.tools === undefined ? {} : { tools: input.tools }),
+      ...(input.permissionMode === undefined ? {} : { permissionMode: input.permissionMode }),
+      ...(input.allowedTools === undefined ? {} : { allowedTools: input.allowedTools }),
+      ...(input.disallowedTools === undefined ? {} : { disallowedTools: input.disallowedTools }),
+      ...(input.allowDangerouslySkipPermissions === undefined
+        ? {}
+        : { allowDangerouslySkipPermissions: input.allowDangerouslySkipPermissions }),
+    });
+  } else if (queryMode === "resume_at_cursor") {
+    await recordClaudeResumeAtCursorQuery({
+      scenario: input.scenario,
+      prompts: input.prompts,
+      modelSelection: input.modelSelection,
+      cwd: input.cwd,
+      sessionId,
+      entries,
+      metadata: recordingMetadata,
+      ...(input.enableTools === undefined ? {} : { enableTools: input.enableTools }),
+      ...(input.tools === undefined ? {} : { tools: input.tools }),
+      ...(input.permissionMode === undefined ? {} : { permissionMode: input.permissionMode }),
+      ...(input.allowedTools === undefined ? {} : { allowedTools: input.allowedTools }),
+      ...(input.disallowedTools === undefined ? {} : { disallowedTools: input.disallowedTools }),
+      ...(input.allowDangerouslySkipPermissions === undefined
+        ? {}
+        : { allowDangerouslySkipPermissions: input.allowDangerouslySkipPermissions }),
+    });
+  } else if (
+    queryMode === "fork_session" ||
+    queryMode === "fork_session_prior_turn" ||
+    queryMode === "fork_session_continue" ||
+    queryMode === "fork_session_siblings" ||
+    queryMode === "fork_session_merge_back" ||
+    queryMode === "fork_session_merge_back_siblings"
+  ) {
+    await recordClaudeForkSessionQuery({
+      scenario: input.scenario,
+      prompts: input.prompts,
+      modelSelection: input.modelSelection,
+      cwd: input.cwd,
+      sessionId,
+      entries,
+      metadata: recordingMetadata,
+      ...(queryMode === "fork_session_prior_turn" ? { forkFromPromptIndex: 1 as const } : {}),
+      ...(queryMode === "fork_session_continue" ? { sourcePromptCount: 1 } : {}),
+      ...(queryMode === "fork_session_siblings"
+        ? {
+            sourcePromptCount: 1,
+            forkPromptGroups: [[input.prompts[1]!], [input.prompts[2]!]],
+          }
+        : {}),
+      ...(queryMode === "fork_session_merge_back"
+        ? {
+            sourcePromptCount: 1,
+            forkPromptGroups: [[input.prompts[1]!]],
+            sourceContinuationPromptCount: 2,
+          }
+        : {}),
+      ...(queryMode === "fork_session_merge_back_siblings"
+        ? {
+            sourcePromptCount: 1,
+            forkPromptGroups: [[input.prompts[1]!], [input.prompts[2]!]],
+            sourceContinuationPromptCount: 3,
+          }
+        : {}),
+      ...(input.enableTools === undefined ? {} : { enableTools: input.enableTools }),
+      ...(input.tools === undefined ? {} : { tools: input.tools }),
+      ...(input.permissionMode === undefined ? {} : { permissionMode: input.permissionMode }),
+      ...(input.allowedTools === undefined ? {} : { allowedTools: input.allowedTools }),
+      ...(input.disallowedTools === undefined ? {} : { disallowedTools: input.disallowedTools }),
+      ...(input.allowDangerouslySkipPermissions === undefined
+        ? {}
+        : { allowDangerouslySkipPermissions: input.allowDangerouslySkipPermissions }),
+    });
+  } else if (queryMode === "interrupt") {
+    await recordClaudeInterruptQuery({
+      scenario: input.scenario,
+      prompts: input.prompts,
+      modelSelection: input.modelSelection,
+      cwd: input.cwd,
+      sessionId,
+      entries,
+      ...(input.enableTools === undefined ? {} : { enableTools: input.enableTools }),
+      ...(input.tools === undefined ? {} : { tools: input.tools }),
+      ...(input.permissionMode === undefined ? {} : { permissionMode: input.permissionMode }),
+      ...(input.allowedTools === undefined ? {} : { allowedTools: input.allowedTools }),
+      ...(input.disallowedTools === undefined ? {} : { disallowedTools: input.disallowedTools }),
+      ...(input.allowDangerouslySkipPermissions === undefined
+        ? {}
+        : { allowDangerouslySkipPermissions: input.allowDangerouslySkipPermissions }),
+      ...(input.interruptAfter === undefined ? {} : { interruptAfter: input.interruptAfter }),
+    });
+  } else {
+    await recordClaudeInterruptRestartQuery({
+      scenario: input.scenario,
+      prompts: input.prompts,
+      modelSelection: input.modelSelection,
+      cwd: input.cwd,
+      sessionId,
+      entries,
+      ...(input.enableTools === undefined ? {} : { enableTools: input.enableTools }),
+      ...(input.tools === undefined ? {} : { tools: input.tools }),
+      ...(input.permissionMode === undefined ? {} : { permissionMode: input.permissionMode }),
+      ...(input.allowedTools === undefined ? {} : { allowedTools: input.allowedTools }),
+      ...(input.disallowedTools === undefined ? {} : { disallowedTools: input.disallowedTools }),
+      ...(input.allowDangerouslySkipPermissions === undefined
+        ? {}
+        : { allowDangerouslySkipPermissions: input.allowDangerouslySkipPermissions }),
+      ...(input.interruptAfter === undefined ? {} : { interruptAfter: input.interruptAfter }),
+    });
+  }
+
+  return {
+    provider: CLAUDE_PROVIDER,
+    protocol: CLAUDE_AGENT_SDK_REPLAY_PROTOCOL,
+    version: "0.2.111",
+    scenario: input.scenario,
+    metadata: {
+      prompts: [...input.prompts],
+      model: input.modelSelection.model,
+      nativeSessionId: sessionId,
+      queryMode,
+      tools: input.enableTools === true ? (input.tools ?? "claude_code") : "none",
+      ...(input.permissionMode === undefined ? {} : { permissionMode: input.permissionMode }),
+      ...(input.allowedTools === undefined ? {} : { allowedTools: input.allowedTools }),
+      ...(input.disallowedTools === undefined ? {} : { disallowedTools: input.disallowedTools }),
+      ...(input.enablePermissionCallback === undefined
+        ? {}
+        : { enablePermissionCallback: input.enablePermissionCallback }),
+      ...(input.permissionDecision === undefined
+        ? {}
+        : { permissionDecision: input.permissionDecision }),
+      ...(input.interruptAfter === undefined ? {} : { interruptAfter: input.interruptAfter }),
+      generatedBy: "recordClaudeAgentSdkReplayTranscript",
+      ...recordingMetadata,
+    },
+    entries,
+  };
+}
+
+const decodeClaudeAgentSdkReplayTranscript = Schema.decodeUnknownEffect(
+  ClaudeAgentSdkReplayTranscript,
+);
+
+export const ClaudeOrchestratorReplayHarness: OrchestratorV2ProviderReplayHarness<
+  ClaudeAgentSdkReplayTranscript,
+  ClaudeOrchestratorReplayHarnessError
+> = {
+  driver: CLAUDE_PROVIDER,
+  decodeTranscript: (transcript) =>
+    decodeClaudeAgentSdkReplayTranscript(transcript).pipe(
+      Effect.mapError(
+        (cause) =>
+          new ClaudeReplayTranscriptDecodeError({
+            ...metadataFromTranscript(transcript),
+            cause,
+          }),
+      ),
+    ),
+  makeProviderAdapterRegistryLayer: (transcript, options) =>
+    makeClaudeProviderAdapterRegistryReplayLayer(transcript, options),
+};
diff --git a/apps/server/src/orchestration-v2/Adapters/ClaudeAdapterV2.ts b/apps/server/src/orchestration-v2/Adapters/ClaudeAdapterV2.ts
new file mode 100644
index 000000000000..f1ac2fbe2afd
--- /dev/null
+++ b/apps/server/src/orchestration-v2/Adapters/ClaudeAdapterV2.ts
@@ -0,0 +1,5712 @@
+import {
+  type CanUseTool,
+  forkSession as forkClaudeSession,
+  type ForkSessionOptions,
+  type ForkSessionResult,
+  query,
+  type Options as ClaudeQueryOptions,
+  type PermissionMode,
+  type PermissionResult,
+  type PermissionUpdate,
+  type Query as ClaudeQuery,
+  type Settings as ClaudeSdkSettings,
+  type SDKAssistantMessage,
+  type SDKAPIRetryMessage,
+  type SDKMessage,
+  type SDKResultMessage,
+  type SDKUserMessage,
+} from "@anthropic-ai/claude-agent-sdk";
+import type {
+  AskUserQuestionInput,
+  WebSearchOutput,
+} from "@anthropic-ai/claude-agent-sdk/sdk-tools";
+import { parseCliArgs } from "@t3tools/shared/cliArgs";
+import { HostProcessEnvironment } from "@t3tools/shared/hostProcess";
+import { applyClaudePromptEffortPrefix } from "@t3tools/shared/model";
+import {
+  CLAUDE_RESUME_COMPACTION_NEVER_ANSWER,
+  formatClaudeResumeCompactionQuestion,
+} from "@t3tools/shared/claudeCompaction";
+import {
+  type ChatAttachment,
+  ClaudeSettings,
+  defaultInstanceIdForDriver,
+  type ModelSelection,
+  type OrchestrationV2ConversationMessage,
+  type OrchestrationV2ExecutionNode,
+  type OrchestrationV2ProviderCapabilities,
+  type OrchestrationV2ProviderFailure,
+  type OrchestrationV2PlanArtifact,
+  type OrchestrationV2PlanStep,
+  type OrchestrationV2PendingBackgroundTask,
+  type OrchestrationV2ProviderRetry,
+  type OrchestrationV2ProviderSession,
+  type OrchestrationV2ProviderThread,
+  type OrchestrationV2ProviderTurn,
+  type OrchestrationV2RuntimeRequest,
+  type OrchestrationV2UserInputQuestion,
+  type OrchestrationV2Subagent,
+  type OrchestrationV2TurnItem,
+  type OrchestrationV2WebSearchResult,
+  type ProviderApprovalDecision,
+  ProviderDriverKind,
+  type ProviderInstanceId,
+  type ProviderRequestKind,
+  type ProviderUserInputAnswers,
+  type ProviderThreadId,
+  type ThreadId,
+} from "@t3tools/contracts";
+
+import * as Cause from "effect/Cause";
+import * as Context from "effect/Context";
+import * as Crypto from "effect/Crypto";
+import * as DateTime from "effect/DateTime";
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as FileSystem from "effect/FileSystem";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+import * as Queue from "effect/Queue";
+import * as Ref from "effect/Ref";
+import * as Schema from "effect/Schema";
+import * as Stream from "effect/Stream";
+
+import { resolveAttachmentPath } from "../../attachmentStore.ts";
+import { compileClaudeModelSelection } from "../../claudeModelOptions.ts";
+import { ServerConfig } from "../../config.ts";
+import { makeClaudeEnvironment } from "../../provider/Drivers/ClaudeHome.ts";
+import { resolveClaudeContextWindow } from "../../provider/Layers/ClaudeProvider.ts";
+import type { EventNdjsonLogger } from "../../provider/Layers/EventNdjsonLogger.ts";
+import { ProviderEventLoggers } from "../../provider/Layers/ProviderEventLoggers.ts";
+import { mergeProviderInstanceEnvironment } from "../../provider/ProviderInstanceEnvironment.ts";
+import { T3_CODE_ORCHESTRATION_INSTRUCTIONS } from "../../provider/T3OrchestrationInstructions.ts";
+import * as McpProviderSession from "../../mcp/McpProviderSession.ts";
+import { IdAllocatorV2, type IdAllocatorV2Shape } from "../IdAllocator.ts";
+import { makeProviderFailure, makeProviderRetryTurnItem } from "../ProviderFailure.ts";
+import { turnScopedSelectionTransition } from "../ProviderSelectionTransition.ts";
+import { providerMessageTextWithAttachmentPaths } from "../AttachmentPrompt.ts";
+import {
+  ProviderAdapterEnsureThreadError,
+  ProviderAdapterForkThreadError,
+  ProviderAdapterInterruptError,
+  ProviderAdapterOpenSessionError,
+  ProviderAdapterProtocolError,
+  ProviderAdapterReadThreadSnapshotError,
+  ProviderAdapterResumeThreadError,
+  ProviderAdapterRollbackThreadError,
+  ProviderAdapterRuntimeRequestResponseError,
+  ProviderAdapterSteerRunError,
+  ProviderAdapterTurnStartError,
+  ProviderAdapterV2,
+  type ProviderAdapterV2EnsureThreadInput,
+  type ProviderAdapterV2Event,
+  type ProviderAdapterV2ForkThreadInput,
+  type ProviderAdapterV2InterruptInput,
+  type ProviderAdapterV2OpenSessionInput,
+  type ProviderAdapterV2RollbackThreadInput,
+  type ProviderAdapterV2RuntimePolicy,
+  type ProviderAdapterV2Shape,
+  type ProviderAdapterV2SessionRuntime,
+  type ProviderAdapterV2SteerInput,
+  type ProviderAdapterV2TurnInput,
+} from "../ProviderAdapter.ts";
+import {
+  ProviderAdapterDriverCreateError,
+  type ProviderAdapterDriver,
+  type ProviderAdapterDriverCreateInput,
+} from "../ProviderAdapterDriver.ts";
+import {
+  type ProviderContinuationRequest,
+  ProviderContinuationRequests,
+} from "../ProviderContinuationRequests.ts";
+import {
+  makeSubagentChildThread,
+  makeSubagentConversationArtifacts,
+  subagentThreadTitle,
+} from "../SubagentProjection.ts";
+
+export const CLAUDE_PROVIDER = ProviderDriverKind.make("claudeAgent");
+export const CLAUDE_AGENT_SDK_QUERY_PROTOCOL = "claude-agent-sdk.query" as const;
+
+function claudeContextWindow(modelSelection: ModelSelection): number | null {
+  if (modelSelection.model === "claude-opus-4-6" || modelSelection.model === "claude-opus-4-7") {
+    return 1_000_000;
+  }
+  return resolveClaudeContextWindow(modelSelection) === "1m" ? 1_000_000 : 200_000;
+}
+
+export function claudeProviderTurnTokenUsage(
+  usage: {
+    readonly input_tokens: number;
+    readonly cache_creation_input_tokens?: number | null;
+    readonly cache_read_input_tokens?: number | null;
+    readonly output_tokens: number;
+  },
+  modelSelection: ModelSelection,
+  updatedAt: string,
+) {
+  const inputTokens =
+    usage.input_tokens +
+    (usage.cache_creation_input_tokens ?? 0) +
+    (usage.cache_read_input_tokens ?? 0);
+  const outputTokens = usage.output_tokens;
+  return {
+    usedTokens: inputTokens + outputTokens,
+    maxTokens: claudeContextWindow(modelSelection),
+    inputTokens,
+    cachedInputTokens: usage.cache_read_input_tokens ?? 0,
+    outputTokens,
+    reasoningOutputTokens: 0,
+    updatedAt,
+  };
+}
+export const CLAUDE_DRIVER_KIND = CLAUDE_PROVIDER;
+export const CLAUDE_DEFAULT_INSTANCE_ID = defaultInstanceIdForDriver(CLAUDE_DRIVER_KIND);
+const DEFAULT_CLAUDE_SETTINGS = Schema.decodeSync(ClaudeSettings)({});
+
+export const ClaudeProviderCapabilitiesV2 = {
+  sessions: {
+    supportsMultipleProviderThreadsPerSession: false,
+    supportsModelSwitchInSession: true,
+    supportsProviderSwitchingViaHandoff: true,
+    supportsRuntimeModeSwitchInSession: false,
+    pendingRequestsSurviveRestart: false,
+  },
+  threads: {
+    canCreateEmptyThread: true,
+    canReadThreadSnapshot: false,
+    canRollbackThread: true,
+    canForkThread: true,
+    canForkFromTurn: true,
+    canForkFromSubagentThread: false,
+    exposesNativeThreadId: true,
+  },
+  turns: {
+    exposesNativeTurnId: false,
+    emitsTurnStarted: true,
+    emitsTurnCompleted: true,
+    supportsInterrupt: true,
+    supportsActiveSteering: true,
+    supportsSteeringByInterruptRestart: false,
+    supportsQueuedMessages: true,
+    terminalStatusQuality: "strong",
+  },
+  streaming: {
+    streamsAssistantText: true,
+    streamsReasoning: false,
+    streamsToolOutput: false,
+    streamsPlanText: false,
+    emitsMessageCompleted: true,
+  },
+  tools: {
+    exposesToolItemIds: true,
+    emitsToolStarted: true,
+    emitsToolCompleted: true,
+    emitsToolOutput: true,
+    supportsMcpTools: true,
+    supportsDynamicToolCallbacks: true,
+  },
+  approvals: {
+    supportsCommandApproval: true,
+    supportsFileReadApproval: true,
+    supportsFileChangeApproval: true,
+    supportsApplyPatchApproval: false,
+    approvalsHaveNativeRequestIds: true,
+    approvalCallbacksAreLiveOnly: true,
+    approvalsCanOriginateFromSubagents: false,
+  },
+  planning: {
+    emitsPlanUpdated: true,
+    emitsTodoList: true,
+    emitsProposedPlan: true,
+    supportsStructuredQuestions: true,
+    planDeltasHaveItemIds: false,
+  },
+  subagents: {
+    supportsSubagents: true,
+    exposesSubagentThreadIds: false,
+    emitsSubagentLifecycle: true,
+    canWaitForSubagents: false,
+    canCloseSubagents: false,
+    canForkSubagentThread: false,
+  },
+  context: {
+    acceptsSystemContext: true,
+    acceptsDeveloperContext: true,
+    acceptsSyntheticUserContext: true,
+    canGenerateSummaries: true,
+    canConsumeHandoffSummaries: true,
+    supportsDeltaHandoff: true,
+    supportsFullThreadHandoff: true,
+    maxRecommendedHandoffChars: null,
+  },
+  checkpointing: {
+    appCanCheckpointFilesystem: true,
+    supportsNestedCheckpointScopes: true,
+    providerCanRollbackConversation: true,
+    providerRollbackReturnsSnapshot: true,
+    providerCanReadConversationSnapshot: false,
+  },
+  identity: {
+    nativeThreadIds: "strong",
+    nativeTurnIds: "weak",
+    nativeItemIds: "strong",
+    nativeRequestIds: "strong",
+  },
+} satisfies OrchestrationV2ProviderCapabilities;
+
+const CLAUDE_CODE_PRESET_TOOLS = {
+  type: "preset",
+  preset: "claude_code",
+} satisfies NonNullable<ClaudeQueryOptions["tools"]>;
+
+export type ClaudeAgentSdkQueryToolList = ReadonlyArray<string>;
+export interface ClaudeAgentSdkQueryPresetTools {
+  readonly type: "preset";
+  readonly preset: "claude_code";
+}
+export type ClaudeAgentSdkQueryTools = ClaudeAgentSdkQueryToolList | ClaudeAgentSdkQueryPresetTools;
+
+export const CLAUDE_READ_ONLY_ALLOWED_TOOLS = ["Read", "Glob", "Grep"] as const;
+
+function claudeAgentSdkQueryToolsForSdk(
+  tools: ClaudeAgentSdkQueryTools,
+): NonNullable<ClaudeQueryOptions["tools"]> {
+  if (isClaudeAgentSdkQueryToolList(tools)) {
+    return [...tools];
+  }
+  return { type: tools.type, preset: tools.preset };
+}
+
+function isClaudeAgentSdkQueryToolList(
+  tools: ClaudeAgentSdkQueryTools,
+): tools is ClaudeAgentSdkQueryToolList {
+  return Array.isArray(tools);
+}
+
+type ClaudeAgentSdkThreadIdentity =
+  | {
+      readonly sessionId: string;
+      readonly resume?: never;
+    }
+  | {
+      readonly sessionId?: never;
+      readonly resume: string;
+    };
+
+export type ClaudeAgentSdkQueryOptions = Omit<
+  ClaudeQueryOptions,
+  "maxTurns" | "model" | "permissionMode" | "resume" | "sessionId" | "tools"
+> & {
+  readonly model: string;
+  readonly tools: NonNullable<ClaudeQueryOptions["tools"]>;
+  readonly permissionMode: NonNullable<ClaudeQueryOptions["permissionMode"]>;
+} & ClaudeAgentSdkThreadIdentity;
+
+export interface ClaudeAgentSdkQueryOpenInput {
+  readonly options: ClaudeAgentSdkQueryOptions;
+  readonly threadId: ThreadId;
+  readonly providerSessionId: OrchestrationV2ProviderSession["id"];
+}
+
+export interface ClaudeAgentSdkQuerySession {
+  readonly messages: Stream.Stream<SDKMessage, ClaudeAgentSdkQueryRunnerError>;
+  readonly offer: (message: SDKUserMessage) => Effect.Effect<void, ClaudeAgentSdkQueryRunnerError>;
+  readonly setModel: (model: string) => Effect.Effect<void, ClaudeAgentSdkQueryRunnerError>;
+  readonly interrupt: Effect.Effect<void, ClaudeAgentSdkQueryRunnerError>;
+  readonly close: Effect.Effect<void, ClaudeAgentSdkQueryRunnerError>;
+}
+
+type ClaudeQueryStreamExit = Exit.Exit<void, ClaudeAgentSdkQueryRunnerError>;
+
+export class ClaudeAgentSdkQueryRunnerError extends Schema.TaggedErrorClass<ClaudeAgentSdkQueryRunnerError>()(
+  "ClaudeAgentSdkQueryRunnerError",
+  {
+    method: Schema.String,
+    cause: Schema.Defect(),
+  },
+) {
+  override get message(): string {
+    return "Claude Agent SDK query failed.";
+  }
+}
+
+export interface ClaudeAgentSdkQueryRunnerShape {
+  readonly allocateSessionId: Effect.Effect<string, ClaudeAgentSdkQueryRunnerError>;
+  readonly open: (
+    input: ClaudeAgentSdkQueryOpenInput,
+  ) => Effect.Effect<ClaudeAgentSdkQuerySession, ClaudeAgentSdkQueryRunnerError>;
+  readonly forkSession: (
+    input: ClaudeAgentSdkSessionForkInput,
+  ) => Effect.Effect<ForkSessionResult, ClaudeAgentSdkQueryRunnerError>;
+  readonly assertComplete: Effect.Effect<void, ClaudeAgentSdkQueryRunnerError>;
+}
+
+export class ClaudeAgentSdkQueryRunner extends Context.Service<
+  ClaudeAgentSdkQueryRunner,
+  ClaudeAgentSdkQueryRunnerShape
+>()("t3/orchestration-v2/Adapters/ClaudeAdapterV2/ClaudeAgentSdkQueryRunner") {}
+
+export interface ClaudeAgentSdkSessionForkInput {
+  readonly sessionId: string;
+  readonly options: ForkSessionOptions;
+  readonly threadId: ThreadId;
+  readonly providerSessionId: OrchestrationV2ProviderSession["id"];
+}
+
+const isClaudeAgentSdkQueryRunnerError = Schema.is(ClaudeAgentSdkQueryRunnerError);
+const isProviderAdapterRuntimeRequestResponseError = Schema.is(
+  ProviderAdapterRuntimeRequestResponseError,
+);
+const isProviderAdapterRollbackThreadError = Schema.is(ProviderAdapterRollbackThreadError);
+
+function queryRunnerError(cause: unknown, method: string): ClaudeAgentSdkQueryRunnerError {
+  return isClaudeAgentSdkQueryRunnerError(cause)
+    ? cause
+    : new ClaudeAgentSdkQueryRunnerError({ cause, method });
+}
+
+function closeClaudeQuery(queryRuntime: ClaudeQuery) {
+  return Effect.try({
+    try: () => queryRuntime.close(),
+    catch: (cause) => queryRunnerError(cause, "close"),
+  });
+}
+
+// Iterate the Query itself, not query[Symbol.asyncIterator]() (the raw
+// sdkMessages generator). The raw generator's return() queues behind the
+// in-flight read of the next CLI message and never settles while the CLI is
+// idle, deadlocking stream interruption (and with it, session scope close).
+// Query.return() runs cleanup() first, which closes the transport and
+// unblocks that read.
+export function claudeQueryMessages(queryRuntime: ClaudeQuery): AsyncIterable<SDKMessage, void> {
+  return { [Symbol.asyncIterator]: () => queryRuntime };
+}
+
+export interface ClaudeAgentSdkLoggedQueryOptions {
+  readonly model: ClaudeAgentSdkQueryOptions["model"];
+  readonly tools: ClaudeAgentSdkQueryOptions["tools"];
+  readonly permissionMode: ClaudeAgentSdkQueryOptions["permissionMode"];
+  readonly sessionId?: string;
+  readonly resume?: string;
+  readonly resumeSessionAt?: ClaudeAgentSdkQueryOptions["resumeSessionAt"];
+  readonly cwd?: ClaudeAgentSdkQueryOptions["cwd"];
+  readonly allowedTools?: ClaudeAgentSdkQueryOptions["allowedTools"];
+  readonly disallowedTools?: ClaudeAgentSdkQueryOptions["disallowedTools"];
+  readonly settings?: ClaudeAgentSdkQueryOptions["settings"];
+  readonly effort?: ClaudeAgentSdkQueryOptions["effort"];
+  readonly includePartialMessages?: true;
+  readonly pathToClaudeCodeExecutable?: ClaudeAgentSdkQueryOptions["pathToClaudeCodeExecutable"];
+  readonly hasExtraArgs?: true;
+  readonly allowDangerouslySkipPermissions?: true;
+  readonly hasCanUseTool?: true;
+  readonly hasEnvironment?: true;
+  readonly hasMcpServers?: true;
+}
+
+export type ClaudeAgentSdkProtocolLogEvent =
+  | {
+      readonly direction: "outgoing";
+      readonly stage: "decoded";
+      readonly payload: {
+        readonly type: "query.open";
+        readonly options: ClaudeAgentSdkLoggedQueryOptions;
+      };
+    }
+  | {
+      readonly direction: "outgoing";
+      readonly stage: "decoded";
+      readonly payload: {
+        readonly type: "prompt.offer";
+        readonly message: SDKUserMessage;
+      };
+    }
+  | {
+      readonly direction: "outgoing";
+      readonly stage: "decoded";
+      readonly payload: {
+        readonly type: "query.set_model";
+        readonly model: string;
+      };
+    }
+  | {
+      readonly direction: "outgoing";
+      readonly stage: "decoded";
+      readonly payload: {
+        readonly type: "query.interrupt";
+      };
+    }
+  | {
+      readonly direction: "outgoing";
+      readonly stage: "decoded";
+      readonly payload: {
+        readonly type: "query.close";
+      };
+    }
+  | {
+      readonly direction: "outgoing";
+      readonly stage: "decoded";
+      readonly payload: {
+        readonly type: "session.fork";
+        readonly sessionId: string;
+        readonly options: ForkSessionOptions;
+      };
+    }
+  | {
+      readonly direction: "incoming";
+      readonly stage: "decoded";
+      readonly payload: {
+        readonly type: "session.forked";
+        readonly sessionId: string;
+      };
+    }
+  | {
+      readonly direction: "incoming";
+      readonly stage: "decoded";
+      readonly payload: SDKMessage;
+    };
+
+export type ClaudeAgentSdkProtocolLogger = (
+  event: ClaudeAgentSdkProtocolLogEvent,
+) => Effect.Effect<void>;
+
+export function loggedClaudeQueryOptions(
+  options: ClaudeAgentSdkQueryOptions,
+): ClaudeAgentSdkLoggedQueryOptions {
+  return {
+    model: options.model,
+    tools: options.tools,
+    permissionMode: options.permissionMode,
+    ...(options.sessionId === undefined ? {} : { sessionId: options.sessionId }),
+    ...(options.resume === undefined ? {} : { resume: options.resume }),
+    ...(options.resumeSessionAt === undefined ? {} : { resumeSessionAt: options.resumeSessionAt }),
+    ...(options.cwd === undefined ? {} : { cwd: options.cwd }),
+    ...(options.allowedTools === undefined ? {} : { allowedTools: options.allowedTools }),
+    ...(options.disallowedTools === undefined ? {} : { disallowedTools: options.disallowedTools }),
+    ...(options.settings === undefined ? {} : { settings: options.settings }),
+    ...(options.effort === undefined ? {} : { effort: options.effort }),
+    ...(options.includePartialMessages === true ? { includePartialMessages: true } : {}),
+    ...(options.pathToClaudeCodeExecutable === undefined
+      ? {}
+      : { pathToClaudeCodeExecutable: options.pathToClaudeCodeExecutable }),
+    ...(options.extraArgs === undefined ? {} : { hasExtraArgs: true }),
+    ...(options.allowDangerouslySkipPermissions === true
+      ? { allowDangerouslySkipPermissions: true }
+      : {}),
+    ...(options.canUseTool === undefined ? {} : { hasCanUseTool: true }),
+    ...(options.env === undefined ? {} : { hasEnvironment: true }),
+    ...(options.mcpServers === undefined ? {} : { hasMcpServers: true }),
+  };
+}
+
+export function makeClaudeAgentSdkProtocolLogger(input: {
+  readonly nativeEventLogger: EventNdjsonLogger | undefined;
+  readonly threadId: ThreadId;
+  readonly providerSessionId: OrchestrationV2ProviderSession["id"];
+}): ClaudeAgentSdkProtocolLogger | undefined {
+  const { nativeEventLogger } = input;
+  if (nativeEventLogger === undefined) {
+    return undefined;
+  }
+
+  return (event) =>
+    nativeEventLogger
+      .write(
+        {
+          provider: CLAUDE_PROVIDER,
+          protocol: CLAUDE_AGENT_SDK_QUERY_PROTOCOL,
+          kind: "protocol",
+          providerSessionId: input.providerSessionId,
+          event,
+        },
+        input.threadId,
+      )
+      .pipe(Effect.ignore);
+}
+
+export const claudeAgentSdkQueryRunnerLiveLayer: Layer.Layer<
+  ClaudeAgentSdkQueryRunner,
+  never,
+  Crypto.Crypto | ProviderEventLoggers
+> = Layer.effect(
+  ClaudeAgentSdkQueryRunner,
+  Effect.gen(function* () {
+    const crypto = yield* Crypto.Crypto;
+    const { native: nativeEventLogger } = yield* ProviderEventLoggers;
+
+    return ClaudeAgentSdkQueryRunner.of({
+      allocateSessionId: crypto.randomUUIDv4.pipe(
+        Effect.mapError((cause) => queryRunnerError(cause, "allocateSessionId")),
+      ),
+      open: Effect.fn("ClaudeAgentSdkQueryRunner.open")(function* (
+        input: ClaudeAgentSdkQueryOpenInput,
+      ) {
+        const protocolLogger = makeClaudeAgentSdkProtocolLogger({
+          nativeEventLogger,
+          threadId: input.threadId,
+          providerSessionId: input.providerSessionId,
+        });
+        const logProtocolEvent = (event: ClaudeAgentSdkProtocolLogEvent) =>
+          protocolLogger === undefined ? Effect.void : protocolLogger(event);
+        const promptQueue = yield* Queue.unbounded<SDKUserMessage>();
+        const prompt = Stream.fromQueue(promptQueue).pipe(
+          Stream.catchCause((cause) =>
+            Cause.hasInterruptsOnly(cause) ? Stream.empty : Stream.failCause(cause),
+          ),
+          Stream.toAsyncIterable,
+        );
+        const queryRuntime = yield* Effect.try({
+          try: () =>
+            query({
+              prompt,
+              options: input.options,
+            }),
+          catch: (cause) => queryRunnerError(cause, "query"),
+        });
+        yield* logProtocolEvent({
+          direction: "outgoing",
+          stage: "decoded",
+          payload: {
+            type: "query.open",
+            options: loggedClaudeQueryOptions(input.options),
+          },
+        });
+
+        return {
+          messages: Stream.fromAsyncIterable(claudeQueryMessages(queryRuntime), (cause) =>
+            queryRunnerError(cause, "fromAsyncIterable"),
+          ).pipe(
+            Stream.tap((message) =>
+              logProtocolEvent({
+                direction: "incoming",
+                stage: "decoded",
+                payload: message,
+              }),
+            ),
+          ),
+          offer: (message) =>
+            Queue.offer(promptQueue, message).pipe(
+              Effect.asVoid,
+              Effect.tap(() =>
+                logProtocolEvent({
+                  direction: "outgoing",
+                  stage: "decoded",
+                  payload: {
+                    type: "prompt.offer",
+                    message,
+                  },
+                }),
+              ),
+            ),
+          setModel: (model) =>
+            Effect.tryPromise({
+              try: () => queryRuntime.setModel(model),
+              catch: (cause) => queryRunnerError(cause, "setModel"),
+            }).pipe(
+              Effect.tap(() =>
+                logProtocolEvent({
+                  direction: "outgoing",
+                  stage: "decoded",
+                  payload: {
+                    type: "query.set_model",
+                    model,
+                  },
+                }),
+              ),
+            ),
+          interrupt: Effect.tryPromise({
+            try: () => queryRuntime.interrupt(),
+            catch: (cause) => queryRunnerError(cause, "interrupt"),
+          }).pipe(
+            Effect.tap(() =>
+              logProtocolEvent({
+                direction: "outgoing",
+                stage: "decoded",
+                payload: {
+                  type: "query.interrupt",
+                },
+              }),
+            ),
+          ),
+          close: Queue.shutdown(promptQueue).pipe(
+            Effect.andThen(closeClaudeQuery(queryRuntime)),
+            Effect.tap(() =>
+              logProtocolEvent({
+                direction: "outgoing",
+                stage: "decoded",
+                payload: {
+                  type: "query.close",
+                },
+              }),
+            ),
+          ),
+        } satisfies ClaudeAgentSdkQuerySession;
+      }),
+      forkSession: Effect.fn("ClaudeAgentSdkQueryRunner.forkSession")(function* (
+        input: ClaudeAgentSdkSessionForkInput,
+      ) {
+        const protocolLogger = makeClaudeAgentSdkProtocolLogger({
+          nativeEventLogger,
+          threadId: input.threadId,
+          providerSessionId: input.providerSessionId,
+        });
+        const logProtocolEvent = (event: ClaudeAgentSdkProtocolLogEvent) =>
+          protocolLogger === undefined ? Effect.void : protocolLogger(event);
+        yield* logProtocolEvent({
+          direction: "outgoing",
+          stage: "decoded",
+          payload: {
+            type: "session.fork",
+            sessionId: input.sessionId,
+            options: input.options,
+          },
+        });
+        const result = yield* Effect.tryPromise({
+          try: () => forkClaudeSession(input.sessionId, input.options),
+          catch: (cause) => queryRunnerError(cause, "forkSession"),
+        });
+        yield* logProtocolEvent({
+          direction: "incoming",
+          stage: "decoded",
+          payload: {
+            type: "session.forked",
+            sessionId: result.sessionId,
+          },
+        });
+        return result;
+      }),
+      assertComplete: Effect.void,
+    });
+  }),
+);
+
+export function makeClaudeQueryOptions(input: {
+  readonly modelSelection: ModelSelection;
+  readonly nativeThreadId: string;
+  readonly resume: boolean;
+  readonly resumeSessionAt?: string;
+  readonly cwd: string | null;
+  /**
+   * The attachments dir grant lets the agent Read/copy pasted images at the
+   * paths appended to the turn text, without an approval prompt. It is a leaf
+   * directory holding only attachment files; siblings like secrets/ and
+   * state.sqlite stay ungranted.
+   */
+  readonly attachmentsDir?: string;
+  readonly settings?: ClaudeSettings;
+  readonly sdkSettings?: string | ClaudeSdkSettings;
+  readonly environment?: NodeJS.ProcessEnv;
+  readonly mcpServers?: ClaudeQueryOptions["mcpServers"];
+  readonly tools?: ClaudeAgentSdkQueryTools;
+  readonly allowedTools?: ReadonlyArray<string>;
+  readonly disallowedTools?: ReadonlyArray<string>;
+  readonly permissionMode?: PermissionMode;
+  readonly canUseTool?: CanUseTool;
+  readonly onUserDialog?: ClaudeQueryOptions["onUserDialog"];
+  readonly supportedDialogKinds?: ClaudeQueryOptions["supportedDialogKinds"];
+  readonly allowDangerouslySkipPermissions?: boolean;
+}): ClaudeAgentSdkQueryOptions {
+  const compiledSelection = compileClaudeModelSelection(input.modelSelection);
+  const extraArgs =
+    input.settings === undefined ? {} : parseCliArgs(input.settings.launchArgs).flags;
+  const threadIdentity: ClaudeAgentSdkThreadIdentity = input.resume
+    ? { resume: input.nativeThreadId }
+    : { sessionId: input.nativeThreadId };
+  const selectedTools = input.tools ?? CLAUDE_CODE_PRESET_TOOLS;
+  const selectionSettings =
+    Object.keys(compiledSelection.settings).length === 0
+      ? undefined
+      : (compiledSelection.settings as ClaudeSdkSettings);
+  const querySettings =
+    selectionSettings === undefined
+      ? input.sdkSettings
+      : typeof input.sdkSettings === "object" && input.sdkSettings !== null
+        ? ({ ...input.sdkSettings, ...selectionSettings } as ClaudeSdkSettings)
+        : selectionSettings;
+  const effectiveQuerySettings =
+    input.settings?.autoCompactWindow === undefined || input.settings.autoCompactWindow.length === 0
+      ? querySettings
+      : ({
+          ...(typeof querySettings === "object" && querySettings !== null ? querySettings : {}),
+          autoCompactWindow: Number(input.settings.autoCompactWindow),
+        } as ClaudeSdkSettings);
+  const options: ClaudeAgentSdkQueryOptions = {
+    model: compiledSelection.apiModelId,
+    tools: claudeAgentSdkQueryToolsForSdk(selectedTools),
+    permissionMode: input.permissionMode ?? "default",
+    includePartialMessages: true,
+    ...(compiledSelection.effort === undefined
+      ? {}
+      : {
+          effort: compiledSelection.effort as NonNullable<ClaudeQueryOptions["effort"]>,
+        }),
+    ...threadIdentity,
+    ...(input.resumeSessionAt === undefined ? {} : { resumeSessionAt: input.resumeSessionAt }),
+    ...(input.allowedTools === undefined ? {} : { allowedTools: [...input.allowedTools] }),
+    ...(input.disallowedTools === undefined ? {} : { disallowedTools: [...input.disallowedTools] }),
+    ...(input.canUseTool === undefined ? {} : { canUseTool: input.canUseTool }),
+    ...(input.allowDangerouslySkipPermissions === true
+      ? { allowDangerouslySkipPermissions: true }
+      : {}),
+    ...(effectiveQuerySettings === undefined ? {} : { settings: effectiveQuerySettings }),
+    ...(input.onUserDialog === undefined ? {} : { onUserDialog: input.onUserDialog }),
+    ...(input.supportedDialogKinds === undefined
+      ? {}
+      : { supportedDialogKinds: input.supportedDialogKinds }),
+    ...(input.settings?.binaryPath
+      ? { pathToClaudeCodeExecutable: input.settings.binaryPath }
+      : {}),
+    ...(input.environment === undefined ? {} : { env: input.environment }),
+    ...(input.mcpServers === undefined ? {} : { mcpServers: input.mcpServers }),
+    ...(input.mcpServers === undefined
+      ? {}
+      : {
+          systemPrompt: {
+            type: "preset" as const,
+            preset: "claude_code" as const,
+            append: T3_CODE_ORCHESTRATION_INSTRUCTIONS,
+          },
+        }),
+    ...(Object.keys(extraArgs).length === 0 ? {} : { extraArgs }),
+  };
+  const additionalDirectories = [
+    ...(input.cwd === null ? [] : [input.cwd]),
+    ...(input.attachmentsDir === undefined ? [] : [input.attachmentsDir]),
+  ];
+  const withDirectories =
+    additionalDirectories.length === 0 ? options : { ...options, additionalDirectories };
+  return input.cwd === null ? withDirectories : { ...withDirectories, cwd: input.cwd };
+}
+
+export const CLAUDE_T3_MCP_TOOL_WILDCARD = "mcp__t3-code__*";
+
+// Must stay in sync with the Tool.Readonly annotations on OrchestratorToolkit;
+// ClaudeAdapterV2.test.ts cross-checks this list against the toolkit.
+export const CLAUDE_READ_ONLY_T3_MCP_ALLOWED_TOOLS: ReadonlyArray<string> = [
+  "mcp__t3-code__orchestrator_capabilities",
+  "mcp__t3-code__list_scheduled_tasks",
+  "mcp__t3-code__t3_thread_list",
+  "mcp__t3-code__t3_thread_wait",
+];
+
+// The SDK's `allowedTools` only pre-approves tool calls; availability is the
+// separate `tools` option. Attaching the t3-code MCP server therefore always
+// pre-approves its tools (headless modes like `dontAsk` deny anything that is
+// not pre-approved), but read-only sandboxes pre-approve only the annotated
+// read-only orchestrator tools so a read-only session cannot silently spawn
+// threads or scheduled tasks.
+export function claudeMcpQueryOverrides(input: {
+  readonly threadId: ThreadId;
+  readonly readOnlySandbox: boolean;
+  readonly allowedTools?: ReadonlyArray<string>;
+}): {
+  readonly allowedTools?: ReadonlyArray<string>;
+  readonly mcpServers?: ClaudeQueryOptions["mcpServers"];
+} {
+  const session = McpProviderSession.readMcpProviderSession(input.threadId);
+  if (session === undefined) {
+    return input.allowedTools === undefined ? {} : { allowedTools: input.allowedTools };
+  }
+  const mcpAllowedTools = input.readOnlySandbox
+    ? CLAUDE_READ_ONLY_T3_MCP_ALLOWED_TOOLS
+    : [CLAUDE_T3_MCP_TOOL_WILDCARD];
+  return {
+    allowedTools: Array.from(new Set([...(input.allowedTools ?? []), ...mcpAllowedTools])),
+    mcpServers: {
+      "t3-code": {
+        type: "http",
+        url: session.endpoint,
+        headers: {
+          Authorization: session.authorizationHeader,
+        },
+      },
+    },
+  };
+}
+
+function providerSession(input: {
+  readonly providerSessionId: OrchestrationV2ProviderSession["id"];
+  readonly providerInstanceId: ProviderInstanceId;
+  readonly cwd: string | null;
+  readonly model: string;
+  readonly now: DateTime.Utc;
+}): OrchestrationV2ProviderSession {
+  return {
+    id: input.providerSessionId,
+    driver: CLAUDE_PROVIDER,
+    providerInstanceId: input.providerInstanceId,
+    status: "ready",
+    cwd: input.cwd ?? process.cwd(),
+    model: input.model,
+    capabilities: ClaudeProviderCapabilitiesV2,
+    createdAt: input.now,
+    updatedAt: input.now,
+    lastError: null,
+  };
+}
+
+function textFromClaudeContent(content: SDKAssistantMessage["message"]["content"]): string {
+  return content.flatMap((part) => (part.type === "text" ? [part.text] : [])).join("");
+}
+
+function assistantTextFromSdkMessage(
+  message: SDKMessage,
+): { readonly nativeItemId: string; readonly text: string } | null {
+  if (message.type !== "assistant") {
+    return null;
+  }
+  return {
+    nativeItemId: message.uuid,
+    text: textFromClaudeContent(message.message.content),
+  };
+}
+
+function resultTextFromSdkMessage(
+  message: SDKMessage,
+): { readonly nativeItemId: string; readonly text: string } | null {
+  if (message.type !== "result" || message.subtype !== "success") {
+    return null;
+  }
+  return {
+    nativeItemId: message.uuid,
+    text: message.result,
+  };
+}
+
+function makeProviderThread(input: {
+  readonly idAllocator: IdAllocatorV2Shape;
+  readonly providerInstanceId: ProviderInstanceId;
+  readonly appThreadId: OrchestrationV2ProviderThread["appThreadId"];
+  readonly ownerNodeId?: OrchestrationV2ProviderThread["ownerNodeId"];
+  readonly providerSessionId: OrchestrationV2ProviderThread["providerSessionId"];
+  readonly nativeThreadId: string;
+  readonly forkedFrom?: NonNullable<OrchestrationV2ProviderThread["forkedFrom"]>;
+  readonly now: DateTime.Utc;
+}): OrchestrationV2ProviderThread {
+  return {
+    id: input.idAllocator.derive.providerThread({
+      driver: CLAUDE_PROVIDER,
+      nativeThreadId: input.nativeThreadId,
+    }),
+    driver: CLAUDE_PROVIDER,
+    providerInstanceId: input.providerInstanceId,
+    providerSessionId: input.providerSessionId,
+    appThreadId: input.appThreadId,
+    ownerNodeId: input.ownerNodeId ?? null,
+    nativeThreadRef: {
+      driver: CLAUDE_PROVIDER,
+      nativeId: input.nativeThreadId,
+      strength: "strong",
+    },
+    nativeConversationHeadRef: null,
+    status: "idle",
+    firstRunOrdinal: null,
+    lastRunOrdinal: null,
+    handoffIds: [],
+    forkedFrom: input.forkedFrom ?? null,
+    createdAt: input.now,
+    updatedAt: input.now,
+  };
+}
+
+const getNativeThreadId = Effect.fnUntraced(function* (
+  providerThread: OrchestrationV2ProviderThread,
+) {
+  const nativeThreadId = providerThread.nativeThreadRef?.nativeId;
+  if (nativeThreadId === undefined || nativeThreadId === null) {
+    return yield* new ProviderAdapterProtocolError({
+      driver: CLAUDE_PROVIDER,
+      detail: `Provider thread ${providerThread.id} is missing a native Claude session id.`,
+    });
+  }
+  return nativeThreadId;
+});
+
+const isSyntheticClaudeTurnId = (nativeTurnId: string): boolean => nativeTurnId.startsWith("turn:");
+
+const isTerminalProviderTurn = (turn: OrchestrationV2ProviderTurn): boolean =>
+  turn.status === "completed" ||
+  turn.status === "interrupted" ||
+  turn.status === "failed" ||
+  turn.status === "cancelled";
+
+const getNativeConversationHeadId = Effect.fnUntraced(function* (
+  providerThread: OrchestrationV2ProviderThread,
+) {
+  const nativeHeadRef = providerThread.nativeConversationHeadRef;
+  if (nativeHeadRef === null) {
+    return undefined;
+  }
+  if (nativeHeadRef.driver !== CLAUDE_PROVIDER) {
+    return yield* new ProviderAdapterProtocolError({
+      driver: CLAUDE_PROVIDER,
+      detail: `Provider thread ${providerThread.id} has a non-Claude native conversation head reference.`,
+    });
+  }
+  if (nativeHeadRef.nativeId === null) {
+    return yield* new ProviderAdapterProtocolError({
+      driver: CLAUDE_PROVIDER,
+      detail: `Provider thread ${providerThread.id} has a Claude native conversation head reference without a native id.`,
+    });
+  }
+  return nativeHeadRef.nativeId;
+});
+
+const resolveClaudeForkUpToMessageId = Effect.fn("ClaudeAdapterV2.resolveForkUpToMessageId")(
+  function* (input: ProviderAdapterV2ForkThreadInput) {
+    if (input.providerTurnId === undefined || input.sourceProviderTurns === undefined) {
+      return undefined;
+    }
+
+    const sourceTurns = input.sourceProviderTurns
+      .filter((turn) => turn.providerThreadId === input.sourceProviderThread.id)
+      .toSorted((left, right) => left.ordinal - right.ordinal);
+    const boundaryIndex = sourceTurns.findIndex((turn) => turn.id === input.providerTurnId);
+    if (boundaryIndex < 0) {
+      return yield* new ProviderAdapterForkThreadError({
+        driver: CLAUDE_PROVIDER,
+        providerThreadId: input.sourceProviderThread.id,
+        cause: `Cannot fork Claude thread from provider turn ${input.providerTurnId}: source turn was not found in provider thread ${input.sourceProviderThread.id}.`,
+      });
+    }
+
+    const boundaryNativeId = sourceTurns[boundaryIndex]?.nativeTurnRef?.nativeId;
+    if (
+      boundaryNativeId !== undefined &&
+      boundaryNativeId !== null &&
+      !isSyntheticClaudeTurnId(boundaryNativeId)
+    ) {
+      return boundaryNativeId;
+    }
+
+    const terminalTurnsAfterBoundary = sourceTurns
+      .slice(boundaryIndex + 1)
+      .filter(isTerminalProviderTurn);
+    if (terminalTurnsAfterBoundary.length === 0) {
+      return undefined;
+    }
+
+    return yield* new ProviderAdapterForkThreadError({
+      driver: CLAUDE_PROVIDER,
+      providerThreadId: input.sourceProviderThread.id,
+      cause: `Cannot fork Claude thread from prior provider turn ${input.providerTurnId}: no SDK assistant message cursor was recorded for that turn.`,
+    });
+  },
+);
+
+const resolveClaudeRollbackResumeSessionAt = Effect.fn(
+  "ClaudeAdapterV2.resolveRollbackResumeSessionAt",
+)(function* (input: ProviderAdapterV2RollbackThreadInput) {
+  switch (input.target.type) {
+    case "thread_start":
+      return null;
+    case "provider_turn": {
+      const target = input.target;
+      if (target.providerTurn.providerThreadId !== input.providerThread.id) {
+        return yield* new ProviderAdapterRollbackThreadError({
+          driver: CLAUDE_PROVIDER,
+          providerThreadId: input.providerThread.id,
+          cause: `Cannot roll back Claude thread ${input.providerThread.id} to provider turn ${target.providerTurn.id}: target turn belongs to provider thread ${target.providerTurn.providerThreadId}.`,
+        });
+      }
+
+      const nativeTurnRef = target.providerTurn.nativeTurnRef;
+      if (
+        nativeTurnRef !== null &&
+        nativeTurnRef.driver === CLAUDE_PROVIDER &&
+        nativeTurnRef.nativeId !== null &&
+        !isSyntheticClaudeTurnId(nativeTurnRef.nativeId)
+      ) {
+        return nativeTurnRef.nativeId;
+      }
+
+      const providerTurnsAfterTarget = input.providerThreadTurns.filter(
+        (turn) => turn.ordinal > target.providerTurn.ordinal && isTerminalProviderTurn(turn),
+      );
+      if (providerTurnsAfterTarget.length === 0) {
+        return null;
+      }
+
+      return yield* new ProviderAdapterRollbackThreadError({
+        driver: CLAUDE_PROVIDER,
+        providerThreadId: input.providerThread.id,
+        cause: `Cannot roll back Claude thread ${input.providerThread.id} to provider turn ${target.providerTurn.id}: no SDK assistant message cursor was recorded for that turn.`,
+      });
+    }
+  }
+});
+
+type ClaudeUserContent = SDKUserMessage["message"]["content"];
+type ClaudeUserContentBlock = Exclude<ClaudeUserContent, string>[number];
+
+const SUPPORTED_CLAUDE_IMAGE_MIME_TYPES = [
+  "image/gif",
+  "image/jpeg",
+  "image/png",
+  "image/webp",
+] as const;
+type SupportedClaudeImageMimeType = (typeof SUPPORTED_CLAUDE_IMAGE_MIME_TYPES)[number];
+const supportedClaudeImageMimeTypes = new Set<string>(SUPPORTED_CLAUDE_IMAGE_MIME_TYPES);
+
+function isSupportedClaudeImageMimeType(
+  mimeType: string,
+): mimeType is SupportedClaudeImageMimeType {
+  return supportedClaudeImageMimeTypes.has(mimeType);
+}
+
+export function makeClaudeUserMessage(input: {
+  readonly text: string;
+  readonly priority?: SDKUserMessage["priority"];
+}): SDKUserMessage {
+  return {
+    type: "user",
+    message: {
+      role: "user",
+      content: input.text,
+    },
+    parent_tool_use_id: null,
+    ...(input.priority === undefined ? {} : { priority: input.priority }),
+  };
+}
+
+const makeClaudeUserMessageWithAttachments = Effect.fnUntraced(function* (input: {
+  readonly text: string;
+  readonly attachments: ReadonlyArray<ChatAttachment>;
+  readonly priority?: SDKUserMessage["priority"];
+  readonly attachmentsDir: string;
+  readonly fileSystem: FileSystem.FileSystem;
+}) {
+  if (input.attachments.length === 0) {
+    return makeClaudeUserMessage({
+      text: input.text,
+      ...(input.priority === undefined ? {} : { priority: input.priority }),
+    });
+  }
+
+  // The model's tools cannot dereference inlined pixels. Appending the
+  // on-disk path is what lets a turn like "include this screenshot in the
+  // PR" copy the actual file (the query grants attachmentsDir for reads).
+  const textWithAttachmentPaths = providerMessageTextWithAttachmentPaths({
+    text: input.text,
+    attachments: input.attachments,
+    attachmentsDir: input.attachmentsDir,
+  });
+
+  const content: Array<ClaudeUserContentBlock> = [];
+  if (textWithAttachmentPaths.length > 0) {
+    content.push({ type: "text", text: textWithAttachmentPaths });
+  }
+
+  for (const attachment of input.attachments) {
+    if (attachment.type === "file") {
+      continue;
+    }
+    if (!isSupportedClaudeImageMimeType(attachment.mimeType)) {
+      return yield* new ProviderAdapterProtocolError({
+        driver: CLAUDE_PROVIDER,
+        detail: `Unsupported Claude image attachment type '${attachment.mimeType}'`,
+      });
+    }
+
+    const attachmentPath = resolveAttachmentPath({
+      attachmentsDir: input.attachmentsDir,
+      attachment,
+    });
+    if (attachmentPath === null) {
+      return yield* new ProviderAdapterProtocolError({
+        driver: CLAUDE_PROVIDER,
+        detail: `Invalid attachment id '${attachment.id}'`,
+      });
+    }
+
+    const bytes = yield* input.fileSystem.readFile(attachmentPath).pipe(
+      Effect.mapError(
+        (cause) =>
+          new ProviderAdapterProtocolError({
+            driver: CLAUDE_PROVIDER,
+            detail: `Failed to read attachment '${attachment.id}'`,
+            payload: cause,
+          }),
+      ),
+    );
+    content.push({
+      type: "image",
+      source: {
+        type: "base64",
+        media_type: attachment.mimeType,
+        data: Buffer.from(bytes).toString("base64"),
+      },
+    });
+  }
+
+  return {
+    type: "user",
+    message: {
+      role: "user",
+      content,
+    },
+    parent_tool_use_id: null,
+    ...(input.priority === undefined ? {} : { priority: input.priority }),
+  } satisfies SDKUserMessage;
+});
+
+type ClaudeAssistantContentBlock = SDKAssistantMessage["message"]["content"][number];
+type ClaudeToolUseContentBlock = Extract<
+  ClaudeAssistantContentBlock,
+  {
+    readonly id: string;
+    readonly name: string;
+    readonly input: unknown;
+  }
+>;
+type ClaudeAssistantToolResultContentBlock = Extract<
+  ClaudeAssistantContentBlock,
+  {
+    readonly tool_use_id: string;
+  }
+>;
+type ClaudeUserToolResultContentBlock = Extract<
+  ClaudeUserContentBlock,
+  {
+    readonly tool_use_id: string;
+  }
+>;
+type ClaudeToolResultContentBlock =
+  | ClaudeAssistantToolResultContentBlock
+  | ClaudeUserToolResultContentBlock;
+type ClaudeTypedToolResultContentBlock = Exclude<
+  ClaudeToolResultContentBlock,
+  { readonly type: "mcp_tool_result" | "tool_result" }
+>;
+type ClaudeTypedToolResultContent = ClaudeTypedToolResultContentBlock["content"];
+type ClaudeToolResultOutput =
+  | Extract<ClaudeToolResultContentBlock, { readonly type: "tool_result" }>["content"]
+  | Extract<ClaudeToolResultContentBlock, { readonly type: "mcp_tool_result" }>["content"]
+  | ClaudeTypedToolResultContent;
+
+function assertNever(value: never): never {
+  throw new Error(`Unhandled Claude SDK variant: ${jsonStringifyForTool(value)}`);
+}
+
+const ClaudeRuntimeSandboxPolicyKind = Schema.Struct({
+  type: Schema.Literals(["dangerFullAccess", "externalSandbox", "readOnly", "workspaceWrite"]),
+});
+type ClaudeRuntimeSandboxPolicy = typeof ClaudeRuntimeSandboxPolicyKind.Type;
+type ClaudeRuntimeSandboxPolicyKindName = ClaudeRuntimeSandboxPolicy["type"];
+const isClaudeRuntimeSandboxPolicyKind = Schema.is(ClaudeRuntimeSandboxPolicyKind);
+
+const ClaudeRuntimeReadOnlyFullAccessSandboxPolicy = Schema.Struct({
+  type: Schema.Literal("readOnly"),
+  access: Schema.Struct({
+    type: Schema.Literal("fullAccess"),
+  }),
+});
+const isClaudeRuntimeReadOnlyFullAccessSandboxPolicy = Schema.is(
+  ClaudeRuntimeReadOnlyFullAccessSandboxPolicy,
+);
+
+function sandboxPolicyKindForClaudeRuntimePolicy(
+  runtimePolicy: ProviderAdapterV2RuntimePolicy,
+): ClaudeRuntimeSandboxPolicyKindName | undefined {
+  return runtimePolicy.sandboxPolicy !== undefined &&
+    isClaudeRuntimeSandboxPolicyKind(runtimePolicy.sandboxPolicy)
+    ? runtimePolicy.sandboxPolicy.type
+    : undefined;
+}
+
+function readOnlyPolicyAllowsGlobalReads(runtimePolicy: ProviderAdapterV2RuntimePolicy): boolean {
+  return (
+    runtimePolicy.sandboxPolicy !== undefined &&
+    isClaudeRuntimeReadOnlyFullAccessSandboxPolicy(runtimePolicy.sandboxPolicy)
+  );
+}
+
+function permissionModeForClaudeRuntimePolicy(
+  runtimePolicy: ProviderAdapterV2RuntimePolicy,
+): PermissionMode {
+  if (runtimePolicy.interactionMode === "plan") {
+    return "plan";
+  }
+  if (runtimePolicy.approvalPolicy === "never") {
+    switch (sandboxPolicyKindForClaudeRuntimePolicy(runtimePolicy)) {
+      case "readOnly":
+        return "dontAsk";
+      case "dangerFullAccess":
+      case "externalSandbox":
+        return "bypassPermissions";
+      case "workspaceWrite":
+      case undefined:
+        return runtimePolicy.runtimeMode === "approval-required"
+          ? "dontAsk"
+          : runtimePolicy.runtimeMode === "auto-accept-edits"
+            ? "acceptEdits"
+            : "bypassPermissions";
+    }
+  }
+  if (runtimePolicy.approvalPolicy !== undefined && runtimePolicy.approvalPolicy !== "never") {
+    return "default";
+  }
+
+  switch (sandboxPolicyKindForClaudeRuntimePolicy(runtimePolicy)) {
+    case "readOnly":
+      return "dontAsk";
+    case "dangerFullAccess":
+      return runtimePolicy.runtimeMode === "approval-required" ? "default" : "bypassPermissions";
+    case "externalSandbox":
+    case "workspaceWrite":
+    case undefined:
+      break;
+  }
+
+  switch (runtimePolicy.runtimeMode) {
+    case "approval-required":
+      return "default";
+    case "auto-accept-edits":
+      return "acceptEdits";
+    case "auto":
+      return "auto";
+    case "full-access":
+      return "bypassPermissions";
+  }
+}
+
+export interface ClaudeRuntimeQueryPolicy {
+  readonly permissionMode: PermissionMode;
+  readonly tools?: ClaudeAgentSdkQueryTools;
+  readonly allowedTools?: ReadonlyArray<string>;
+  readonly allowDangerouslySkipPermissions?: true;
+  readonly installPermissionCallback: boolean;
+}
+
+export function claudeRuntimeQueryPolicyForRuntimePolicy(
+  runtimePolicy: ProviderAdapterV2RuntimePolicy,
+): ClaudeRuntimeQueryPolicy {
+  const permissionMode = permissionModeForClaudeRuntimePolicy(runtimePolicy);
+  const readOnlyTools =
+    sandboxPolicyKindForClaudeRuntimePolicy(runtimePolicy) === "readOnly"
+      ? CLAUDE_READ_ONLY_ALLOWED_TOOLS
+      : undefined;
+  const allowedTools =
+    readOnlyTools !== undefined && readOnlyPolicyAllowsGlobalReads(runtimePolicy)
+      ? readOnlyTools
+      : undefined;
+  const installPermissionCallback =
+    runtimePolicy.approvalPolicy === undefined
+      ? runtimePolicy.runtimeMode === "approval-required"
+      : runtimePolicy.approvalPolicy !== "never";
+
+  if (permissionMode === "plan") {
+    return {
+      permissionMode,
+      ...(readOnlyTools === undefined ? {} : { tools: readOnlyTools }),
+      ...(allowedTools === undefined ? {} : { allowedTools }),
+      installPermissionCallback,
+    };
+  }
+
+  return {
+    permissionMode,
+    ...(readOnlyTools === undefined ? {} : { tools: readOnlyTools }),
+    ...(allowedTools === undefined ? {} : { allowedTools }),
+    ...(permissionMode === "bypassPermissions" ? { allowDangerouslySkipPermissions: true } : {}),
+    installPermissionCallback,
+  };
+}
+
+function shouldInstallClaudePermissionCallback(policy: ClaudeRuntimeQueryPolicy): boolean {
+  return policy.installPermissionCallback;
+}
+
+function claudeRuntimeQueryPolicyKey(policy: ClaudeRuntimeQueryPolicy): string {
+  return JSON.stringify({
+    permissionMode: policy.permissionMode,
+    tools: policy.tools,
+    allowedTools: policy.allowedTools,
+    allowDangerouslySkipPermissions: policy.allowDangerouslySkipPermissions,
+    installPermissionCallback: policy.installPermissionCallback,
+  });
+}
+
+// Live-query reuse must key on the effective allowlist (including the
+// MCP-derived pre-approvals), not just the runtime policy: policies that
+// share a policy key can still differ in MCP pre-approvals.
+export function claudeEffectiveQueryPolicyKey(
+  queryPolicy: ClaudeRuntimeQueryPolicy,
+  mcpOverrides: {
+    readonly allowedTools?: ReadonlyArray<string>;
+    readonly mcpServers?: ClaudeQueryOptions["mcpServers"];
+  },
+): string {
+  return JSON.stringify({
+    runtimePolicy: claudeRuntimeQueryPolicyKey({
+      ...queryPolicy,
+      ...(mcpOverrides.allowedTools === undefined
+        ? {}
+        : { allowedTools: mcpOverrides.allowedTools }),
+    }),
+    mcpServers: mcpOverrides.mcpServers,
+  });
+}
+
+type ClaudeToolItemType = Extract<
+  OrchestrationV2TurnItem["type"],
+  "command_execution" | "file_change" | "dynamic_tool" | "web_search"
+>;
+
+interface ClaudeToolClassification {
+  readonly known: boolean;
+  readonly normalizedName: string;
+  readonly itemType: ClaudeToolItemType;
+  readonly requestKind: ProviderRequestKind;
+}
+
+function normalizedClaudeToolName(toolName: string): string {
+  return toolName.toLowerCase().replaceAll(/[\s_-]/g, "");
+}
+
+const CLAUDE_KNOWN_TOOL_CLASSIFICATIONS: Record<
+  string,
+  {
+    readonly itemType: ClaudeToolItemType;
+    readonly requestKind: ProviderRequestKind;
+  }
+> = {
+  agent: { itemType: "dynamic_tool", requestKind: "command" },
+  bash: { itemType: "command_execution", requestKind: "command" },
+  edit: { itemType: "file_change", requestKind: "file-change" },
+  glob: { itemType: "dynamic_tool", requestKind: "file-read" },
+  grep: { itemType: "dynamic_tool", requestKind: "file-read" },
+  ls: { itemType: "dynamic_tool", requestKind: "file-read" },
+  multiedit: { itemType: "file_change", requestKind: "file-change" },
+  notebookedit: { itemType: "file_change", requestKind: "file-change" },
+  read: { itemType: "dynamic_tool", requestKind: "file-read" },
+  task: { itemType: "dynamic_tool", requestKind: "command" },
+  todowrite: { itemType: "dynamic_tool", requestKind: "command" },
+  toolsearch: { itemType: "dynamic_tool", requestKind: "command" },
+  webfetch: { itemType: "web_search", requestKind: "command" },
+  websearch: { itemType: "web_search", requestKind: "command" },
+  write: { itemType: "file_change", requestKind: "file-change" },
+};
+
+export function classifyClaudeNativeTool(toolName: string): ClaudeToolClassification {
+  const normalizedName = normalizedClaudeToolName(toolName);
+  const known = CLAUDE_KNOWN_TOOL_CLASSIFICATIONS[normalizedName];
+  return known === undefined
+    ? {
+        known: false,
+        normalizedName,
+        itemType: "dynamic_tool",
+        requestKind: "command",
+      }
+    : {
+        known: true,
+        normalizedName,
+        ...known,
+      };
+}
+
+function providerRequestKindFromClaudeTool(toolName: string): ProviderRequestKind {
+  return classifyClaudeNativeTool(toolName).requestKind;
+}
+
+function isClaudeWebSearchOutput(output: unknown): output is WebSearchOutput {
+  return (
+    typeof output === "object" &&
+    output !== null &&
+    typeof Reflect.get(output, "query") === "string" &&
+    Array.isArray(Reflect.get(output, "results")) &&
+    typeof Reflect.get(output, "durationSeconds") === "number"
+  );
+}
+
+const ClaudeNativeToolInputRecord = Schema.Record(Schema.String, Schema.Unknown);
+type ClaudeNativeToolInputRecord = typeof ClaudeNativeToolInputRecord.Type;
+const isClaudeNativeToolInputRecord = Schema.is(ClaudeNativeToolInputRecord);
+
+type ClaudeNativeToolInput =
+  | {
+      readonly type: "record";
+      readonly value: ClaudeNativeToolInputRecord;
+    }
+  | {
+      readonly type: "non_record";
+      readonly value: unknown;
+    };
+
+const EMPTY_CLAUDE_NATIVE_TOOL_INPUT = {
+  type: "record",
+  value: {},
+} satisfies ClaudeNativeToolInput;
+
+function claudeNativeToolInputFromUnknown(input: unknown): ClaudeNativeToolInput {
+  return isClaudeNativeToolInputRecord(input)
+    ? { type: "record", value: input }
+    : { type: "non_record", value: input };
+}
+
+function claudeNativeToolInputFromRecord(input: Record<string, unknown>): ClaudeNativeToolInput {
+  return { type: "record", value: input };
+}
+
+function claudeNativeToolInputValue(input: ClaudeNativeToolInput): unknown {
+  return input.value;
+}
+
+function inputRecordValue(input: ClaudeNativeToolInput, key: string): unknown {
+  return input.type === "record" ? input.value[key] : undefined;
+}
+
+function firstStringInputField(
+  input: ClaudeNativeToolInput,
+  keys: ReadonlyArray<string>,
+): string | undefined {
+  for (const key of keys) {
+    const value = inputRecordValue(input, key);
+    if (typeof value === "string" && value.trim().length > 0) {
+      return value.trim();
+    }
+  }
+  return undefined;
+}
+
+function jsonStringifyForTool(value: unknown): string {
+  if (typeof value === "string") {
+    return value;
+  }
+  return JSON.stringify(value) ?? String(value);
+}
+
+function commandInputFromClaudeTool(toolName: string, input: ClaudeNativeToolInput): string {
+  return (
+    firstStringInputField(input, ["command", "cmd", "script"]) ??
+    `${toolName}: ${jsonStringifyForTool(claudeNativeToolInputValue(input))}`
+  );
+}
+
+// Opaque non-subagent background work admitted onto the Waiting roster.
+// Subagents project through the normal subagent lifecycle and must not be
+// double-counted when background_tasks_changed includes them.
+const CLAUDE_OPAQUE_BACKGROUND_TASK_TYPES = new Set(["local_bash"]);
+
+function isClaudeOpaqueBackgroundTaskType(taskType: string | null | undefined): boolean {
+  return typeof taskType === "string" && CLAUDE_OPAQUE_BACKGROUND_TASK_TYPES.has(taskType);
+}
+
+function claudeTaskTypeFromSdkMessage(message: SDKMessage): string | null {
+  if (typeof message !== "object" || message === null) {
+    return null;
+  }
+  const taskType = Reflect.get(message, "task_type");
+  return typeof taskType === "string" ? taskType : null;
+}
+
+function isClaudeNonSubagentTask(message: SDKMessage): boolean {
+  return isClaudeOpaqueBackgroundTaskType(claudeTaskTypeFromSdkMessage(message));
+}
+
+function isClaudeBackgroundTasksChangedMessage(message: SDKMessage): boolean {
+  return (
+    message.type === "system" &&
+    // Undeclared SDK subtype: full roster snapshot of live background tasks.
+    (message.subtype as string) === "background_tasks_changed"
+  );
+}
+
+function claudePendingBackgroundTasksFromRoster(
+  roster: ReadonlyMap<string, OrchestrationV2PendingBackgroundTask>,
+): ReadonlyArray<OrchestrationV2PendingBackgroundTask> {
+  return Array.from(roster.values());
+}
+
+function parseClaudeBackgroundTaskEntry(
+  entry: unknown,
+): OrchestrationV2PendingBackgroundTask | null {
+  if (entry === null || typeof entry !== "object") {
+    return null;
+  }
+  const taskId = Reflect.get(entry, "task_id");
+  if (typeof taskId !== "string" || taskId.length === 0) {
+    return null;
+  }
+  const taskType = Reflect.get(entry, "task_type");
+  // Mirror the incremental path: only opaque non-subagent types currently
+  // supported for Waiting. Subagent/agent entries stay on the subagent path.
+  if (!isClaudeOpaqueBackgroundTaskType(typeof taskType === "string" ? taskType : null)) {
+    return null;
+  }
+  const description = Reflect.get(entry, "description");
+  return {
+    taskId,
+    ...(typeof description === "string" && description.trim().length > 0 ? { description } : {}),
+    taskType,
+  };
+}
+
+function fileNameFromClaudeTool(toolName: string, input: ClaudeNativeToolInput): string {
+  return (
+    firstStringInputField(input, ["file_path", "path", "filename", "fileName"]) ??
+    `${toolName} result`
+  );
+}
+
+type ClaudeNativeToolOutput =
+  | {
+      readonly type: "none";
+    }
+  | {
+      readonly type: "content_block";
+      readonly value: ClaudeToolResultOutput;
+    }
+  | {
+      readonly type: "structured_tool_use_result";
+      readonly value: unknown;
+      readonly fallbackValue?: ClaudeToolResultOutput;
+    };
+
+const NO_CLAUDE_NATIVE_TOOL_OUTPUT = { type: "none" } satisfies ClaudeNativeToolOutput;
+
+function claudeNativeToolOutputFromToolResult(
+  toolResult: ClaudeToolResultContentBlock,
+): ClaudeNativeToolOutput {
+  const value = outputFromClaudeToolResult(toolResult);
+  return value === undefined ? NO_CLAUDE_NATIVE_TOOL_OUTPUT : { type: "content_block", value };
+}
+
+function claudeNativeToolOutputFromStructuredResult(input: {
+  readonly structuredOutput: unknown;
+  readonly fallbackValue?: ClaudeToolResultOutput;
+}): ClaudeNativeToolOutput {
+  return {
+    type: "structured_tool_use_result",
+    value: input.structuredOutput,
+    ...(input.fallbackValue === undefined ? {} : { fallbackValue: input.fallbackValue }),
+  };
+}
+
+function claudeNativeToolOutputValue(output: ClaudeNativeToolOutput): unknown | undefined {
+  switch (output.type) {
+    case "none":
+      return undefined;
+    case "content_block":
+    case "structured_tool_use_result":
+      return output.value;
+    default:
+      return assertNever(output);
+  }
+}
+
+function claudeNativeToolOutputText(output: ClaudeNativeToolOutput): string {
+  const value = claudeNativeToolOutputValue(output);
+  return typeof value === "string" ? value : value === undefined ? "" : jsonStringifyForTool(value);
+}
+
+function claudeSubagentResultText(output: ClaudeNativeToolOutput): string {
+  const value = claudeNativeToolOutputValue(output);
+  const content = Array.isArray(value)
+    ? value
+    : typeof value === "object" && value !== null && "content" in value
+      ? value.content
+      : undefined;
+  if (Array.isArray(content)) {
+    const text = content
+      .flatMap((part) =>
+        typeof part === "object" &&
+        part !== null &&
+        "type" in part &&
+        part.type === "text" &&
+        "text" in part &&
+        typeof part.text === "string"
+          ? [part.text]
+          : [],
+      )
+      .join("\n");
+    if (text.length > 0) {
+      return text;
+    }
+  }
+  return claudeNativeToolOutputText(output);
+}
+
+function isClaudeSubagentAsyncLaunchAck(output: ClaudeNativeToolOutput): boolean {
+  const value = claudeNativeToolOutputValue(output);
+  if (typeof value === "object" && value !== null) {
+    if ("isAsync" in value && value.isAsync === true) {
+      return true;
+    }
+    if ("status" in value && value.status === "async_launched") {
+      return true;
+    }
+  }
+  return claudeSubagentResultText(output).startsWith("Async agent launched successfully.");
+}
+
+function webSearchPatternsFromClaudeTool(input: {
+  readonly toolInput: ClaudeNativeToolInput;
+  readonly output: ClaudeNativeToolOutput;
+}): ReadonlyArray<string> {
+  const output = claudeNativeToolOutputValue(input.output);
+  const pattern =
+    firstStringInputField(input.toolInput, ["query", "url", "pattern"]) ??
+    (isClaudeWebSearchOutput(output) ? output.query : undefined);
+  return pattern === undefined || pattern.trim().length === 0 ? [] : [pattern];
+}
+
+function webSearchResultsFromClaudeOutput(
+  output: ClaudeNativeToolOutput,
+): ReadonlyArray<OrchestrationV2WebSearchResult> {
+  const value = claudeNativeToolOutputValue(output);
+  if (!isClaudeWebSearchOutput(value)) {
+    return [];
+  }
+
+  return value.results.flatMap((result) => {
+    if (typeof result === "string") {
+      return [];
+    }
+    return result.content.map((content) => ({
+      title: content.title,
+      url: content.url,
+    }));
+  });
+}
+
+function summarizeClaudeToolRequest(toolName: string, input: ClaudeNativeToolInput): string {
+  const command = firstStringInputField(input, ["command", "cmd", "script"]);
+  if (command !== undefined) {
+    return `${toolName}: ${command.slice(0, 400)}`;
+  }
+  const path = firstStringInputField(input, ["file_path", "path", "filename", "fileName"]);
+  if (path !== undefined) {
+    return `${toolName}: ${path.slice(0, 400)}`;
+  }
+  const serialized = jsonStringifyForTool(claudeNativeToolInputValue(input));
+  return serialized.length <= 400
+    ? `${toolName}: ${serialized}`
+    : `${toolName}: ${serialized.slice(0, 397)}...`;
+}
+
+function outputFromClaudeToolResult(
+  toolResult: ClaudeToolResultContentBlock,
+): ClaudeToolResultOutput | undefined {
+  switch (toolResult.type) {
+    case "tool_result":
+      return toolResult.content;
+    case "mcp_tool_result":
+      return toolResult.content;
+    case "bash_code_execution_tool_result":
+    case "code_execution_tool_result":
+    case "advisor_tool_result":
+    case "text_editor_code_execution_tool_result":
+    case "tool_search_tool_result":
+    case "web_fetch_tool_result":
+    case "web_search_tool_result":
+      return toolResult.content;
+    default:
+      return assertNever(toolResult);
+  }
+}
+
+function isClaudeTypedToolResultErrorContent(content: ClaudeTypedToolResultContent): boolean {
+  if (Array.isArray(content)) {
+    return false;
+  }
+
+  switch (content.type) {
+    case "bash_code_execution_tool_result_error":
+    case "code_execution_tool_result_error":
+    case "text_editor_code_execution_tool_result_error":
+    case "tool_search_tool_result_error":
+    case "web_fetch_tool_result_error":
+    case "web_search_tool_result_error":
+      return true;
+    default:
+      return false;
+  }
+}
+
+function isClaudeToolResultError(toolResult: ClaudeToolResultContentBlock): boolean {
+  switch (toolResult.type) {
+    case "tool_result":
+      return toolResult.is_error === true;
+    case "mcp_tool_result":
+      return toolResult.is_error;
+    case "bash_code_execution_tool_result":
+    case "code_execution_tool_result":
+    case "advisor_tool_result":
+    case "text_editor_code_execution_tool_result":
+    case "tool_search_tool_result":
+    case "web_fetch_tool_result":
+    case "web_search_tool_result":
+      return isClaudeTypedToolResultErrorContent(toolResult.content);
+    default:
+      return assertNever(toolResult);
+  }
+}
+
+function toolNameFromClaudeToolResult(toolResult: ClaudeToolResultContentBlock): string {
+  switch (toolResult.type) {
+    case "bash_code_execution_tool_result":
+      return "bash_code_execution";
+    case "code_execution_tool_result":
+      return "code_execution";
+    case "advisor_tool_result":
+      return "advisor";
+    case "mcp_tool_result":
+      return "mcp_tool";
+    case "text_editor_code_execution_tool_result":
+      return "text_editor_code_execution";
+    case "tool_result":
+      return "tool";
+    case "tool_search_tool_result":
+      return "tool_search";
+    case "web_fetch_tool_result":
+      return "web_fetch";
+    case "web_search_tool_result":
+      return "web_search";
+    default:
+      return assertNever(toolResult);
+  }
+}
+
+function isClaudeAssistantToolResultContentBlock(
+  part: ClaudeAssistantContentBlock,
+): part is ClaudeAssistantToolResultContentBlock {
+  return "tool_use_id" in part && typeof part.tool_use_id === "string";
+}
+
+function isClaudeUserToolResultContentBlock(
+  part: ClaudeUserContentBlock,
+): part is ClaudeUserToolResultContentBlock {
+  return "tool_use_id" in part && typeof part.tool_use_id === "string";
+}
+
+function isClaudeToolUseContentBlock(
+  part: ClaudeAssistantContentBlock,
+): part is ClaudeToolUseContentBlock {
+  return (
+    "id" in part &&
+    typeof part.id === "string" &&
+    "name" in part &&
+    typeof part.name === "string" &&
+    "input" in part
+  );
+}
+
+function claudeToolUseBlocksFromAssistantMessage(
+  message: SDKMessage,
+): ReadonlyArray<ClaudeToolUseContentBlock> {
+  if (message.type !== "assistant") {
+    return [];
+  }
+  return message.message.content.filter(isClaudeToolUseContentBlock);
+}
+
+function claudeToolResultBlocksFromAssistantMessage(
+  message: SDKMessage,
+): ReadonlyArray<ClaudeToolResultContentBlock> {
+  if (message.type !== "assistant") {
+    return [];
+  }
+  return message.message.content.filter(isClaudeAssistantToolResultContentBlock);
+}
+
+function claudeToolResultBlocksFromUserMessage(
+  message: SDKMessage,
+): ReadonlyArray<ClaudeToolResultContentBlock> {
+  if (message.type !== "user" || typeof message.message.content === "string") {
+    return [];
+  }
+  return message.message.content.filter(isClaudeUserToolResultContentBlock);
+}
+
+function claudeToolResultEntriesFromMessage(message: SDKMessage): ReadonlyArray<{
+  readonly toolResult: ClaudeToolResultContentBlock;
+  readonly output: ClaudeNativeToolOutput;
+}> {
+  const assistantResults = claudeToolResultBlocksFromAssistantMessage(message).map(
+    (toolResult) => ({ toolResult, output: claudeNativeToolOutputFromToolResult(toolResult) }),
+  );
+  const userResults = claudeToolResultBlocksFromUserMessage(message);
+  const structuredOutput =
+    message.type === "user" && userResults.length === 1 ? message.tool_use_result : undefined;
+  return [
+    ...assistantResults,
+    ...userResults.map((toolResult) => ({
+      toolResult,
+      output:
+        structuredOutput === undefined
+          ? claudeNativeToolOutputFromToolResult(toolResult)
+          : claudeNativeToolOutputFromStructuredResult({
+              structuredOutput,
+              fallbackValue: outputFromClaudeToolResult(toolResult),
+            }),
+    })),
+  ];
+}
+
+function parentToolUseIdFromSdkMessage(message: SDKMessage): string | null {
+  return message.type === "assistant" || message.type === "user"
+    ? message.parent_tool_use_id
+    : null;
+}
+
+export function permissionResultFromDecision(input: {
+  readonly toolName: string;
+  readonly decision: ProviderApprovalDecision;
+  readonly toolInput: Record<string, unknown>;
+  readonly toolUseID: string;
+  readonly suggestions?: Parameters<CanUseTool>[2]["suggestions"];
+}): PermissionResult {
+  if (input.decision === "accept" || input.decision === "acceptForSession") {
+    return {
+      behavior: "allow",
+      updatedInput: input.toolInput,
+      toolUseID: input.toolUseID,
+      decisionClassification:
+        input.decision === "acceptForSession" ? "user_permanent" : "user_temporary",
+      ...(input.decision === "acceptForSession"
+        ? {
+            updatedPermissions: toSessionPermissionUpdates(input.toolName, input.suggestions),
+          }
+        : {}),
+    };
+  }
+
+  return {
+    behavior: "deny",
+    message:
+      input.decision === "cancel"
+        ? "User cancelled tool execution."
+        : "User declined tool execution.",
+    toolUseID: input.toolUseID,
+    decisionClassification: "user_reject",
+    ...(input.decision === "cancel" ? { interrupt: true } : {}),
+  };
+}
+
+function toSessionPermissionUpdates(
+  toolName: string,
+  suggestions: ReadonlyArray<PermissionUpdate> | undefined,
+): Array<PermissionUpdate> {
+  const updates = (suggestions ?? []).map(
+    (suggestion): PermissionUpdate => ({ ...suggestion, destination: "session" }),
+  );
+  if (updates.length > 0) {
+    return updates;
+  }
+  return [
+    {
+      type: "addRules",
+      rules: [{ toolName }],
+      behavior: "allow",
+      destination: "session",
+    },
+  ];
+}
+
+export const awaitClaudeApprovalDecision = Effect.fn("awaitClaudeApprovalDecision")(function* (
+  decision: Deferred.Deferred<ProviderApprovalDecision>,
+  signal: AbortSignal,
+) {
+  const cancellation = Effect.callback<ProviderApprovalDecision>((resume) => {
+    const abort = () => resume(Effect.succeed("cancel"));
+    signal.addEventListener("abort", abort, { once: true });
+    if (signal.aborted) {
+      abort();
+    }
+    return Effect.sync(() => signal.removeEventListener("abort", abort));
+  });
+  return yield* Effect.raceFirst(Deferred.await(decision), cancellation);
+});
+
+const awaitClaudeUserInputAnswers = Effect.fn("awaitClaudeUserInputAnswers")(function* (
+  answers: Deferred.Deferred<ProviderUserInputAnswers>,
+  signal: AbortSignal,
+) {
+  const cancellation = Effect.callback<ProviderUserInputAnswers>((resume) => {
+    const abort = () => resume(Effect.succeed({}));
+    signal.addEventListener("abort", abort, { once: true });
+    if (signal.aborted) abort();
+    return Effect.sync(() => signal.removeEventListener("abort", abort));
+  });
+  return yield* Effect.raceFirst(Deferred.await(answers), cancellation);
+});
+
+/**
+ * First user-facing error from a non-success result. "[ede_diagnostic] ..."
+ * entries are CLI-internal telemetry (the CLI hides them from its own UI too),
+ * so they must never become the error banner (#5557).
+ */
+function resultUserFacingError(result: SDKResultMessage): string | undefined {
+  if (result.subtype === "success" || !Array.isArray(result.errors)) {
+    return undefined;
+  }
+  return result.errors.find((error) => !error.startsWith("[ede_diagnostic]"));
+}
+
+function terminalStatusFromResult(
+  message: SDKResultMessage,
+): Extract<
+  OrchestrationV2ProviderTurn["status"],
+  "completed" | "interrupted" | "failed" | "cancelled"
+> {
+  if (message.subtype === "success") {
+    // The SDK reports API-level failures (401 auth, 529 overloaded, …) as
+    // subtype "success" with is_error set; the turn produced no real work.
+    return message.is_error ? "failed" : "completed";
+  }
+  // The CLI stamps user aborts explicitly: interrupting mid-tool-call yields
+  // "aborted_tools" (with an internal "[ede_diagnostic] ..." error and
+  // is_error: true), interrupting mid-stream yields "aborted_streaming".
+  if (
+    message.terminal_reason === "aborted_tools" ||
+    message.terminal_reason === "aborted_streaming"
+  ) {
+    return "interrupted";
+  }
+  const errorText = message.errors.join("\n").toLowerCase();
+  if (errorText.includes("interrupt")) {
+    return "interrupted";
+  }
+  if (errorText.includes("cancel")) {
+    return "cancelled";
+  }
+  return "failed";
+}
+
+function isClaudeActiveSteeringAbortResult(message: SDKResultMessage): boolean {
+  return message.terminal_reason === "aborted_streaming";
+}
+
+function isClaudeProviderContinuationTurn(input: ProviderAdapterV2TurnInput): boolean {
+  return input.message.createdBy === "agent" && input.message.creationSource === "provider";
+}
+
+function isClaudeTaskNotificationOriginResult(message: SDKMessage): message is SDKResultMessage & {
+  readonly origin: Extract<
+    NonNullable<SDKResultMessage["origin"]>,
+    { readonly kind: "task-notification" }
+  >;
+} {
+  return message.type === "result" && message.origin?.kind === "task-notification";
+}
+
+function providerFailureFromResult(
+  message: SDKResultMessage,
+): OrchestrationV2ProviderFailure | null {
+  if (message.subtype !== "success") {
+    return makeProviderFailure({
+      message: resultUserFacingError(message) ?? message.errors.join("\n"),
+      code: message.subtype,
+      class: "provider_error",
+    });
+  }
+  if (!message.is_error) {
+    return null;
+  }
+  const apiErrorStatus = message.api_error_status ?? null;
+  return makeProviderFailure({
+    message: message.result,
+    code: apiErrorStatus === null ? "sdk_result_error" : `api_error_${apiErrorStatus}`,
+    class: "provider_error",
+    retryable: apiErrorStatus === 429 || apiErrorStatus === 529 ? true : null,
+  });
+}
+
+function providerFailureFromApiRetry(message: SDKAPIRetryMessage): OrchestrationV2ProviderFailure {
+  const errorName = message.error.replaceAll("_", " ");
+  return makeProviderFailure({
+    message: `Claude API ${errorName}.`,
+    code:
+      message.error_status === null
+        ? message.error
+        : `api_error_${Math.trunc(message.error_status)}`,
+    class: message.error_status === null ? "transport_error" : "provider_error",
+    retryable: true,
+  });
+}
+
+function buildAssistantArtifacts(input: {
+  readonly idAllocator: IdAllocatorV2Shape;
+  readonly turnInput: ProviderAdapterV2TurnInput;
+  readonly providerTurnId: OrchestrationV2ProviderTurn["id"];
+  readonly nativeItemId: string;
+  readonly text: string;
+  readonly ordinal: number;
+  readonly startedAt: DateTime.Utc;
+  readonly completedAt: DateTime.Utc;
+}): {
+  readonly node: OrchestrationV2ExecutionNode;
+  readonly message: OrchestrationV2ConversationMessage;
+  readonly turnItem: OrchestrationV2TurnItem;
+} {
+  const nodeId = input.idAllocator.derive.nodeFromProviderItem({
+    driver: CLAUDE_PROVIDER,
+    nativeItemId: input.nativeItemId,
+  });
+  const messageId = input.idAllocator.derive.messageFromProviderItem({
+    driver: CLAUDE_PROVIDER,
+    nativeItemId: input.nativeItemId,
+  });
+  const turnItemId = input.idAllocator.derive.turnItemFromProviderItem({
+    driver: CLAUDE_PROVIDER,
+    nativeItemId: input.nativeItemId,
+  });
+  const nativeItemRef = {
+    driver: CLAUDE_PROVIDER,
+    nativeId: input.nativeItemId,
+    strength: "strong" as const,
+  };
+
+  return {
+    node: {
+      id: nodeId,
+      threadId: input.turnInput.threadId,
+      runId: input.turnInput.runId,
+      parentNodeId: input.turnInput.rootNodeId,
+      rootNodeId: input.turnInput.rootNodeId,
+      kind: "assistant_message",
+      status: "completed",
+      countsForRun: false,
+      providerThreadId: input.turnInput.providerThread.id,
+      providerTurnId: input.providerTurnId,
+      nativeItemRef,
+      runtimeRequestId: null,
+      checkpointScopeId: null,
+      startedAt: input.startedAt,
+      completedAt: input.completedAt,
+    },
+    message: {
+      createdBy: "agent",
+      creationSource: "provider",
+      id: messageId,
+      threadId: input.turnInput.threadId,
+      runId: input.turnInput.runId,
+      nodeId,
+      role: "assistant",
+      text: input.text,
+      attachments: [],
+      streaming: false,
+      createdAt: input.completedAt,
+      updatedAt: input.completedAt,
+    },
+    turnItem: {
+      id: turnItemId,
+      threadId: input.turnInput.threadId,
+      runId: input.turnInput.runId,
+      nodeId,
+      providerThreadId: input.turnInput.providerThread.id,
+      providerTurnId: input.providerTurnId,
+      nativeItemRef,
+      parentItemId: null,
+      ordinal: input.ordinal,
+      status: "completed",
+      title: null,
+      startedAt: input.startedAt,
+      completedAt: input.completedAt,
+      updatedAt: input.completedAt,
+      type: "assistant_message",
+      messageId,
+      text: input.text,
+      streaming: false,
+    },
+  };
+}
+
+interface ActiveClaudeTurnContext {
+  readonly input: ProviderAdapterV2TurnInput;
+  readonly nativeTurnId: string;
+  nativeMessageCursor: string | null;
+  readonly providerTurnId: OrchestrationV2ProviderTurn["id"];
+  readonly providerTurnOrdinal: number;
+  readonly startedAt: DateTime.Utc;
+  readonly assistant: {
+    fallbackText: string;
+    fallbackNativeItemId: string;
+    emittedNativeItemIds: Set<string>;
+  };
+  readonly toolCalls: Map<string, ActiveClaudeToolCall>;
+  readonly ignoredTaskIds: Set<string>;
+  readonly subagentsByTaskId: Map<string, ActiveClaudeSubagent>;
+  readonly subagentsByToolUseId: Map<string, ActiveClaudeSubagent>;
+  readonly subagentNodesByTaskId: Map<string, OrchestrationV2ExecutionNode["id"]>;
+  readonly pendingSubagentModelsByToolUseId: Map<string, string>;
+}
+
+interface ActiveClaudeProviderRetry {
+  readonly retry: OrchestrationV2ProviderRetry;
+  readonly failure: OrchestrationV2ProviderFailure;
+  readonly startedAt: DateTime.Utc;
+  readonly itemOrdinal: number;
+}
+
+interface ActiveClaudeSubagent {
+  task: OrchestrationV2Subagent;
+  readonly childThreadId: ThreadId;
+  readonly childRootNodeId: OrchestrationV2ExecutionNode["id"];
+  readonly turnItemId: OrchestrationV2TurnItem["id"];
+  readonly turnItemOrdinal: number;
+  nextChildItemOrdinal: number;
+  progressItemOrdinal: number | null;
+  progressStartedAt: DateTime.Utc | null;
+  resultItemOrdinal: number | null;
+}
+
+interface ClaudeLiveQueryContext {
+  readonly nativeThreadId: string;
+  readonly query: ClaudeAgentSdkQuerySession;
+  readonly queryPolicyKey: string;
+  readonly selectionKey: string;
+  readonly closed: Deferred.Deferred<void, never>;
+}
+
+interface ActiveClaudeToolCall {
+  readonly nativeItemId: string;
+  readonly toolName: string;
+  readonly classification: ClaudeToolClassification;
+  readonly input: ClaudeNativeToolInput;
+  readonly threadId: ThreadId;
+  readonly runId: ProviderAdapterV2TurnInput["runId"] | null;
+  readonly rootNodeId: OrchestrationV2ExecutionNode["id"];
+  readonly parentNodeId: OrchestrationV2ExecutionNode["id"];
+  readonly ordinal: number;
+  readonly startedAt: DateTime.Utc;
+}
+
+const PENDING_CLAUDE_SUBAGENT_MODEL_CAP = 64;
+
+function rememberPendingClaudeSubagentModel(
+  pending: Map<string, string>,
+  toolUseId: string,
+  model: string,
+): void {
+  pending.set(toolUseId, model);
+  if (pending.size <= PENDING_CLAUDE_SUBAGENT_MODEL_CAP) {
+    return;
+  }
+  const oldest = pending.keys().next();
+  if (!oldest.done) {
+    pending.delete(oldest.value);
+  }
+}
+
+type PendingClaudeRuntimeRequest =
+  | {
+      readonly type: "approval";
+      readonly requestId: OrchestrationV2RuntimeRequest["id"];
+      readonly requestKind: ProviderRequestKind;
+      readonly decision: Deferred.Deferred<ProviderApprovalDecision, never>;
+    }
+  | {
+      readonly type: "user_input";
+      readonly requestId: OrchestrationV2RuntimeRequest["id"];
+      readonly answers: Deferred.Deferred<ProviderUserInputAnswers, never>;
+    };
+
+export function claudeUserInputQuestions(
+  input: unknown,
+): ReadonlyArray<OrchestrationV2UserInputQuestion> {
+  const value =
+    typeof input === "object" && input !== null && Reflect.get(input, "type") === "record"
+      ? Reflect.get(input, "value")
+      : input;
+  const questions =
+    typeof value === "object" && value !== null ? Reflect.get(value, "questions") : undefined;
+  if (!Array.isArray(questions)) return [];
+  return questions.flatMap((value: unknown, index: number) => {
+    if (typeof value !== "object" || value === null) return [];
+    const record = value as Record<string, unknown>;
+    const question = typeof record.question === "string" ? record.question.trim() : "";
+    if (question.length === 0) return [];
+    const header =
+      typeof record.header === "string" && record.header.trim().length > 0
+        ? record.header.trim()
+        : `Question ${index + 1}`;
+    const options = Array.isArray(record.options)
+      ? record.options.flatMap((option) => {
+          if (typeof option !== "object" || option === null) return [];
+          const optionRecord = option as Record<string, unknown>;
+          const label = typeof optionRecord.label === "string" ? optionRecord.label.trim() : "";
+          if (label.length === 0) return [];
+          return [
+            {
+              label,
+              description:
+                typeof optionRecord.description === "string" ? optionRecord.description.trim() : "",
+            },
+          ];
+        })
+      : [];
+    return [
+      {
+        id: question,
+        header,
+        question,
+        options,
+        multiSelect: record.multiSelect === true,
+      },
+    ];
+  });
+}
+
+export function claudeSdkUserInputAnswers(
+  answers: ProviderUserInputAnswers,
+): NonNullable<AskUserQuestionInput["answers"]> {
+  return Object.fromEntries(
+    Object.entries(answers).map(([question, answer]) => [
+      question,
+      Array.isArray(answer)
+        ? answer.filter((value): value is string => typeof value === "string").join(", ")
+        : typeof answer === "string"
+          ? answer
+          : String(answer ?? ""),
+    ]),
+  );
+}
+
+export function claudeTodoSteps(input: unknown): ReadonlyArray<OrchestrationV2PlanStep> {
+  const value =
+    typeof input === "object" && input !== null && Reflect.get(input, "type") === "record"
+      ? Reflect.get(input, "value")
+      : input;
+  const todos =
+    typeof value === "object" && value !== null ? Reflect.get(value, "todos") : undefined;
+  if (!Array.isArray(todos)) return [];
+  return todos.flatMap((todo, index) => {
+    if (typeof todo !== "object" || todo === null) return [];
+    const text =
+      typeof Reflect.get(todo, "content") === "string"
+        ? String(Reflect.get(todo, "content")).trim()
+        : "";
+    if (text.length === 0) return [];
+    const nativeStatus = Reflect.get(todo, "status");
+    return [
+      {
+        id: `todo-${index}`,
+        text,
+        status:
+          nativeStatus === "completed"
+            ? "completed"
+            : nativeStatus === "in_progress"
+              ? "running"
+              : "pending",
+      },
+    ];
+  });
+}
+
+export function claudeProposedPlan(input: unknown): string | null {
+  const value =
+    typeof input === "object" && input !== null && Reflect.get(input, "type") === "record"
+      ? Reflect.get(input, "value")
+      : input;
+  const plan = typeof value === "object" && value !== null ? Reflect.get(value, "plan") : undefined;
+  return typeof plan === "string" && plan.trim().length > 0 ? plan.trim() : null;
+}
+
+export interface ClaudeAdapterV2Options {
+  readonly instanceId: ProviderInstanceId;
+  readonly settings: ClaudeSettings;
+  readonly environment: NodeJS.ProcessEnv;
+  readonly attachmentsDir: string;
+  readonly fileSystem: FileSystem.FileSystem;
+  readonly idAllocator: IdAllocatorV2Shape;
+  readonly queryRunner: ClaudeAgentSdkQueryRunnerShape;
+  /** Sink for wake-turn continuation requests; defaults to dropping them. */
+  readonly continuationRequests?: {
+    readonly offer: (request: ProviderContinuationRequest) => Effect.Effect<void>;
+  };
+}
+
+export function makeClaudeAdapterV2(
+  adapterOptions: ClaudeAdapterV2Options,
+): ProviderAdapterV2Shape {
+  const { attachmentsDir, fileSystem, idAllocator, queryRunner } = adapterOptions;
+  const continuationRequests = adapterOptions.continuationRequests ?? {
+    offer: () => Effect.void,
+  };
+
+  return ProviderAdapterV2.of({
+    instanceId: adapterOptions.instanceId,
+    driver: CLAUDE_PROVIDER,
+    getCapabilities: () => Effect.succeed(ClaudeProviderCapabilitiesV2),
+    planSelectionTransition: () => Effect.succeed(turnScopedSelectionTransition()),
+    openSession: Effect.fn("ClaudeAdapterV2.openSession")(
+      function* (input: ProviderAdapterV2OpenSessionInput) {
+        const sessionScope = yield* Effect.scope;
+        const now = yield* DateTime.now;
+        const session = providerSession({
+          providerSessionId: input.providerSessionId,
+          providerInstanceId: adapterOptions.instanceId,
+          cwd: input.runtimePolicy.cwd,
+          model: input.modelSelection.model,
+          now,
+        });
+        const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+        const activeTurn = yield* Ref.make<ActiveClaudeTurnContext | null>(null);
+        const interruptedTurns = yield* Ref.make(new Set<OrchestrationV2ProviderTurn["id"]>());
+        const steeredTurns = yield* Ref.make(new Set<OrchestrationV2ProviderTurn["id"]>());
+        const queryContext = yield* Ref.make<ClaudeLiveQueryContext | null>(null);
+        const openedNativeThreads = yield* Ref.make(new Set<string>());
+        const itemOrdinals = yield* Ref.make(new Map<string, number>());
+        const nextItemOrdinalsByTurn = yield* Ref.make(new Map<string, number>());
+        const latestPlanByKind = yield* Ref.make(new Map<string, OrchestrationV2PlanArtifact>());
+        const planIdsByNativeItem = yield* Ref.make(
+          new Map<string, OrchestrationV2PlanArtifact["id"]>(),
+        );
+        const providerRetries = yield* Ref.make(
+          new Map<OrchestrationV2ProviderTurn["id"], ActiveClaudeProviderRetry>(),
+        );
+        const pendingRuntimeRequests = yield* Ref.make(
+          new Map<string, PendingClaudeRuntimeRequest>(),
+        );
+        // Background-task wake support. Claude can settle a turn while a
+        // local_bash background task keeps running; the CLI later re-invokes
+        // the model (a "wake turn") on the same query stream with no active
+        // provider turn. These refs track pending background tasks, buffer
+        // wake messages until a continuation run attaches, and remember where
+        // to dispatch that run.
+        const lastTurnRouteByNativeThread = yield* Ref.make(
+          new Map<
+            string,
+            { readonly threadId: ThreadId; readonly providerThreadId: ProviderThreadId }
+          >(),
+        );
+        // Authoritative + incremental background-task roster for post-settle
+        // Waiting UI. Outer key is native Claude session id so concurrent
+        // provider threads on one runtime cannot share or clear each other.
+        const pendingBackgroundTasksByNativeThread = yield* Ref.make(
+          new Map<string, Map<string, OrchestrationV2PendingBackgroundTask>>(),
+        );
+        // Wake eligibility is separate from the Waiting roster. It survives
+        // empty background_tasks_changed levels (SDK: empty level can precede
+        // task_notification) and is consumed when the first idle notification
+        // is buffered/offered so duplicates cannot re-buffer. A short-lived
+        // replay tombstone then covers continuation drain classification so
+        // local_bash is never projected as a subagent; the tombstone is
+        // cleared after that drained notification is processed. Both sets
+        // clear on CLI process open/replacement and failed/interrupted turns.
+        const wakeEligibleBackgroundTasksByNativeThread = yield* Ref.make(
+          new Map<string, Set<string>>(),
+        );
+        const opaqueBackgroundTaskReplayTombstonesByNativeThread = yield* Ref.make(
+          new Map<string, Set<string>>(),
+        );
+        // Last known provider-thread payload per native session, used to emit
+        // roster-only provider_thread.updated events between turns without
+        // resurrecting an active status after root settlement.
+        const lastProviderThreadByNativeThread = yield* Ref.make(
+          new Map<string, OrchestrationV2ProviderThread>(),
+        );
+        // Subagent registry that survives turn settle: a background subagent
+        // (Agent with run_in_background) can complete after the root turn
+        // ended, and its task_notification must both count as wake evidence
+        // and hydrate the original subagent node instead of being dropped.
+        const sessionSubagentsByTaskId = yield* Ref.make(new Map<string, ActiveClaudeSubagent>());
+        const wakeBuffers = yield* Ref.make(
+          new Map<
+            string,
+            { readonly messages: ReadonlyArray<SDKMessage>; readonly detail: string | null }
+          >(),
+        );
+        const requestedContinuations = yield* Ref.make(new Set<string>());
+        const runtimeContext = yield* Effect.context<never>();
+        const runPromise = Effect.runPromiseWith(runtimeContext);
+
+        const emitProviderEvent = (event: ProviderAdapterV2Event) =>
+          Queue.offer(events, event).pipe(Effect.asVoid);
+
+        // Claude emits retry progress but no recovered frame; the next
+        // assistant message is the first reliable evidence of recovery.
+        const completeProviderRetry = Effect.fn("ClaudeAdapterV2.completeProviderRetry")(function* (
+          context: ActiveClaudeTurnContext,
+          updatedAt: DateTime.Utc,
+        ) {
+          const providerRetry = yield* Ref.modify(providerRetries, (current) => {
+            const retry = current.get(context.providerTurnId);
+            if (retry === undefined) {
+              return [undefined, current] as const;
+            }
+            const updated = new Map(current);
+            updated.delete(context.providerTurnId);
+            return [retry, updated] as const;
+          });
+          if (providerRetry === undefined) {
+            return;
+          }
+          yield* emitProviderEvent({
+            type: "turn_item.updated",
+            driver: CLAUDE_PROVIDER,
+            turnItem: makeProviderRetryTurnItem({
+              idAllocator,
+              driver: CLAUDE_PROVIDER,
+              threadId: context.input.threadId,
+              runId: context.input.runId,
+              nodeId: context.input.rootNodeId,
+              providerThreadId: context.input.providerThread.id,
+              providerTurnId: context.providerTurnId,
+              itemOrdinal: providerRetry.itemOrdinal,
+              failure: providerRetry.failure,
+              retry: providerRetry.retry,
+              status: "completed",
+              startedAt: providerRetry.startedAt,
+              updatedAt,
+            }),
+          });
+        });
+
+        const rememberProviderThread = (providerThread: OrchestrationV2ProviderThread) =>
+          Effect.gen(function* () {
+            const nativeThreadId = providerThread.nativeThreadRef?.nativeId;
+            if (nativeThreadId === undefined || nativeThreadId === null) {
+              return;
+            }
+            yield* Ref.update(lastProviderThreadByNativeThread, (current) =>
+              new Map(current).set(nativeThreadId, providerThread),
+            );
+          });
+
+        const rosterForNativeThread = (
+          all: ReadonlyMap<string, Map<string, OrchestrationV2PendingBackgroundTask>>,
+          nativeThreadId: string,
+        ): Map<string, OrchestrationV2PendingBackgroundTask> =>
+          all.get(nativeThreadId) ?? new Map<string, OrchestrationV2PendingBackgroundTask>();
+
+        const hasPendingBackgroundTaskOnNativeThread = (nativeThreadId: string, taskId: string) =>
+          Ref.get(pendingBackgroundTasksByNativeThread).pipe(
+            Effect.map((all) => rosterForNativeThread(all, nativeThreadId).has(taskId)),
+          );
+
+        const taskIdSetForNativeThread = (
+          all: ReadonlyMap<string, Set<string>>,
+          nativeThreadId: string,
+        ): Set<string> => all.get(nativeThreadId) ?? new Set<string>();
+
+        const addTaskIdsToNativeThreadSet = (
+          ref: Ref.Ref<Map<string, Set<string>>>,
+          nativeThreadId: string,
+          taskIds: ReadonlyArray<string>,
+        ) =>
+          Ref.update(ref, (current) => {
+            if (taskIds.length === 0) {
+              return current;
+            }
+            const next = new Set(taskIdSetForNativeThread(current, nativeThreadId));
+            let changed = false;
+            for (const taskId of taskIds) {
+              if (!next.has(taskId)) {
+                next.add(taskId);
+                changed = true;
+              }
+            }
+            return changed ? new Map(current).set(nativeThreadId, next) : current;
+          });
+
+        const clearTaskIdFromNativeThreadSet = (
+          ref: Ref.Ref<Map<string, Set<string>>>,
+          nativeThreadId: string,
+          taskId: string,
+        ) =>
+          Ref.update(ref, (current) => {
+            const existing = taskIdSetForNativeThread(current, nativeThreadId);
+            if (!existing.has(taskId)) {
+              return current;
+            }
+            const next = new Set(existing);
+            next.delete(taskId);
+            const updated = new Map(current);
+            if (next.size === 0) {
+              updated.delete(nativeThreadId);
+            } else {
+              updated.set(nativeThreadId, next);
+            }
+            return updated;
+          });
+
+        const clearNativeThreadTaskIdSet = (
+          ref: Ref.Ref<Map<string, Set<string>>>,
+          nativeThreadId: string,
+        ) =>
+          Ref.update(ref, (current) => {
+            if (!current.has(nativeThreadId)) {
+              return current;
+            }
+            const updated = new Map(current);
+            updated.delete(nativeThreadId);
+            return updated;
+          });
+
+        // First-notification wake offering only: not the Waiting roster and
+        // not the post-buffer replay tombstone.
+        const isWakeEligibleOpaqueBackgroundTaskOnNativeThread = (
+          nativeThreadId: string,
+          taskId: string,
+        ) =>
+          Ref.get(wakeEligibleBackgroundTasksByNativeThread).pipe(
+            Effect.map((all) => taskIdSetForNativeThread(all, nativeThreadId).has(taskId)),
+          );
+
+        const hasOpaqueBackgroundTaskReplayTombstoneOnNativeThread = (
+          nativeThreadId: string,
+          taskId: string,
+        ) =>
+          Ref.get(opaqueBackgroundTaskReplayTombstonesByNativeThread).pipe(
+            Effect.map((all) => taskIdSetForNativeThread(all, nativeThreadId).has(taskId)),
+          );
+
+        // Classify a task_notification as opaque local_bash (not a subagent):
+        // live roster, still-eligible first notification, or short-lived
+        // replay tombstone left after the idle notification was buffered.
+        const isKnownOpaqueBackgroundTaskOnNativeThread = (
+          nativeThreadId: string,
+          taskId: string,
+        ) =>
+          Effect.gen(function* () {
+            if (yield* hasPendingBackgroundTaskOnNativeThread(nativeThreadId, taskId)) {
+              return true;
+            }
+            if (yield* isWakeEligibleOpaqueBackgroundTaskOnNativeThread(nativeThreadId, taskId)) {
+              return true;
+            }
+            return yield* hasOpaqueBackgroundTaskReplayTombstoneOnNativeThread(
+              nativeThreadId,
+              taskId,
+            );
+          });
+
+        // Admit onto wake eligibility only. Replay tombstones are created when
+        // the first idle notification is buffered, not at task start.
+        const markWakeEligibleOpaqueBackgroundTasks = (
+          nativeThreadId: string,
+          taskIds: ReadonlyArray<string>,
+        ) =>
+          addTaskIdsToNativeThreadSet(
+            wakeEligibleBackgroundTasksByNativeThread,
+            nativeThreadId,
+            taskIds,
+          );
+
+        // After the first idle opaque notification is buffered/offered: stop
+        // further wake buffering for this task id, but keep a replay tombstone
+        // until the continuation drain classifies the buffered notification.
+        const consumeWakeEligibilityForBufferedNotification = (
+          nativeThreadId: string,
+          taskId: string,
+        ) =>
+          Effect.gen(function* () {
+            yield* clearTaskIdFromNativeThreadSet(
+              wakeEligibleBackgroundTasksByNativeThread,
+              nativeThreadId,
+              taskId,
+            );
+            yield* addTaskIdsToNativeThreadSet(
+              opaqueBackgroundTaskReplayTombstonesByNativeThread,
+              nativeThreadId,
+              [taskId],
+            );
+          });
+
+        const clearOpaqueBackgroundTaskReplayTombstone = (nativeThreadId: string, taskId: string) =>
+          clearTaskIdFromNativeThreadSet(
+            opaqueBackgroundTaskReplayTombstonesByNativeThread,
+            nativeThreadId,
+            taskId,
+          );
+
+        const emitProviderThreadRoster = Effect.fnUntraced(function* (input: {
+          readonly nativeThreadId: string;
+          readonly providerThread: OrchestrationV2ProviderThread;
+          readonly status?: OrchestrationV2ProviderThread["status"];
+        }) {
+          const roster = rosterForNativeThread(
+            yield* Ref.get(pendingBackgroundTasksByNativeThread),
+            input.nativeThreadId,
+          );
+          const now = yield* DateTime.now;
+          const providerThread: OrchestrationV2ProviderThread = {
+            ...input.providerThread,
+            providerSessionId: session.id,
+            ...(input.status === undefined ? {} : { status: input.status }),
+            pendingBackgroundTasks: claudePendingBackgroundTasksFromRoster(roster),
+            updatedAt: now,
+          };
+          yield* rememberProviderThread(providerThread);
+          yield* emitProviderEvent({
+            type: "provider_thread.updated",
+            driver: CLAUDE_PROVIDER,
+            providerThread,
+          });
+        });
+
+        const replacePendingBackgroundTasks = (
+          nativeThreadId: string,
+          tasks: ReadonlyArray<OrchestrationV2PendingBackgroundTask>,
+        ) =>
+          Effect.gen(function* () {
+            yield* Ref.update(pendingBackgroundTasksByNativeThread, (current) => {
+              const updated = new Map(current);
+              if (tasks.length === 0) {
+                updated.delete(nativeThreadId);
+              } else {
+                updated.set(
+                  nativeThreadId,
+                  new Map(tasks.map((task) => [task.taskId, task] as const)),
+                );
+              }
+              return updated;
+            });
+            // Empty level must not drop wake eligibility: notification may
+            // still be in flight. Non-empty level admits new task ids to
+            // wake eligibility only (replay tombstones are edge-created).
+            if (tasks.length > 0) {
+              yield* markWakeEligibleOpaqueBackgroundTasks(
+                nativeThreadId,
+                tasks.map((task) => task.taskId),
+              );
+            }
+          });
+
+        const upsertPendingBackgroundTask = (
+          nativeThreadId: string,
+          task: OrchestrationV2PendingBackgroundTask,
+        ) =>
+          Effect.gen(function* () {
+            yield* Ref.update(pendingBackgroundTasksByNativeThread, (current) => {
+              const roster = new Map(rosterForNativeThread(current, nativeThreadId));
+              roster.set(task.taskId, task);
+              return new Map(current).set(nativeThreadId, roster);
+            });
+            yield* markWakeEligibleOpaqueBackgroundTasks(nativeThreadId, [task.taskId]);
+          });
+
+        const clearPendingBackgroundTask = (nativeThreadId: string, taskId: string) =>
+          Ref.modify(pendingBackgroundTasksByNativeThread, (current) => {
+            const roster = rosterForNativeThread(current, nativeThreadId);
+            if (!roster.has(taskId)) {
+              return [false, current] as const;
+            }
+            const nextRoster = new Map(roster);
+            nextRoster.delete(taskId);
+            const updated = new Map(current);
+            if (nextRoster.size === 0) {
+              updated.delete(nativeThreadId);
+            } else {
+              updated.set(nativeThreadId, nextRoster);
+            }
+            return [true, updated] as const;
+          });
+
+        const clearPendingBackgroundTasksForNativeThread = (nativeThreadId: string) =>
+          Ref.update(pendingBackgroundTasksByNativeThread, (current) => {
+            if (!current.has(nativeThreadId)) {
+              return current;
+            }
+            const updated = new Map(current);
+            updated.delete(nativeThreadId);
+            return updated;
+          });
+
+        // Drop idle wake traffic for a dead native process so it cannot pin
+        // session-wide pending work after sibling query replacement.
+        const clearWakeStateForNativeThread = (nativeThreadId: string) =>
+          Effect.gen(function* () {
+            yield* Ref.update(wakeBuffers, (current) => {
+              if (!current.has(nativeThreadId)) {
+                return current;
+              }
+              const updated = new Map(current);
+              updated.delete(nativeThreadId);
+              return updated;
+            });
+            yield* Ref.update(requestedContinuations, (current) => {
+              if (!current.has(nativeThreadId)) {
+                return current;
+              }
+              const updated = new Set(current);
+              updated.delete(nativeThreadId);
+              return updated;
+            });
+          });
+
+        // Process-scoped level: SDK emits nothing at CLI start, so both the
+        // Waiting roster and wake eligibility reset when a live query opens
+        // or is replaced for this native thread. Opaque replay tombstones that
+        // already covered buffered task_notification frames are restored so a
+        // model/policy query replacement still classifies those local_bash
+        // completions on continuation drain. Buffer membership alone must not
+        // invent opaque classification: session-registered subagent
+        // notifications share the same buffer.
+        const resetBackgroundTaskStateForNativeThreadProcess = Effect.fnUntraced(function* (
+          nativeThreadId: string,
+          options?: {
+            // openQuery during startTurn: activeTurn is not installed yet, but
+            // ProviderTurnStartService already marked the provider thread active.
+            readonly status?: OrchestrationV2ProviderThread["status"];
+          },
+        ) {
+          const hadRoster =
+            rosterForNativeThread(
+              yield* Ref.get(pendingBackgroundTasksByNativeThread),
+              nativeThreadId,
+            ).size > 0;
+          const remembered = (yield* Ref.get(lastProviderThreadByNativeThread)).get(nativeThreadId);
+          const hadPersistedRoster = (remembered?.pendingBackgroundTasks?.length ?? 0) > 0;
+          const priorOpaqueTombstones = taskIdSetForNativeThread(
+            yield* Ref.get(opaqueBackgroundTaskReplayTombstonesByNativeThread),
+            nativeThreadId,
+          );
+          const bufferedTaskNotificationIds = new Set<string>();
+          const buffered = (yield* Ref.get(wakeBuffers)).get(nativeThreadId);
+          if (buffered !== undefined) {
+            for (const message of buffered.messages) {
+              if (message.type === "system" && message.subtype === "task_notification") {
+                bufferedTaskNotificationIds.add(message.task_id);
+              }
+            }
+          }
+          const preservedOpaqueTombstones = [...priorOpaqueTombstones].filter((taskId) =>
+            bufferedTaskNotificationIds.has(taskId),
+          );
+          yield* clearPendingBackgroundTasksForNativeThread(nativeThreadId);
+          yield* clearNativeThreadTaskIdSet(
+            wakeEligibleBackgroundTasksByNativeThread,
+            nativeThreadId,
+          );
+          yield* clearNativeThreadTaskIdSet(
+            opaqueBackgroundTaskReplayTombstonesByNativeThread,
+            nativeThreadId,
+          );
+          if (preservedOpaqueTombstones.length > 0) {
+            yield* addTaskIdsToNativeThreadSet(
+              opaqueBackgroundTaskReplayTombstonesByNativeThread,
+              nativeThreadId,
+              preservedOpaqueTombstones,
+            );
+          }
+          if (!hadRoster && !hadPersistedRoster) {
+            return;
+          }
+          if (remembered === undefined) {
+            return;
+          }
+          // Prefer an explicit starting-turn status so a successful openQuery
+          // replacement clear cannot emit idle over an already-active thread.
+          // Otherwise: between turns never resurrect active from process reset;
+          // with a live activeTurn context, upgrade idle → active.
+          const activeContext = yield* Ref.get(activeTurn);
+          const status =
+            options?.status ??
+            (activeContext === null
+              ? ("idle" as const)
+              : remembered.status === "idle"
+                ? ("active" as const)
+                : remembered.status);
+          yield* emitProviderThreadRoster({
+            nativeThreadId,
+            providerThread: remembered,
+            status,
+          });
+        });
+
+        const resolveItemOrdinal = Effect.fnUntraced(function* (
+          context: ActiveClaudeTurnContext,
+          nativeItemId: string,
+        ) {
+          const existing = (yield* Ref.get(itemOrdinals)).get(nativeItemId);
+          if (existing !== undefined) {
+            return existing;
+          }
+
+          const nextWithinTurn = yield* Ref.modify(nextItemOrdinalsByTurn, (current) => {
+            const next = (current.get(context.nativeTurnId) ?? 0) + 1;
+            const updated = new Map(current);
+            updated.set(context.nativeTurnId, next);
+            return [next, updated];
+          });
+          const nextOrdinal = context.input.providerTurnOrdinal * 100 + nextWithinTurn;
+          yield* Ref.update(itemOrdinals, (current) => {
+            const updated = new Map(current);
+            updated.set(nativeItemId, nextOrdinal);
+            return updated;
+          });
+          return nextOrdinal;
+        });
+
+        const providerTurnPayload = (input: {
+          readonly context: ActiveClaudeTurnContext;
+          readonly status: OrchestrationV2ProviderTurn["status"];
+          readonly completedAt: DateTime.Utc | null;
+        }): OrchestrationV2ProviderTurn => ({
+          id: input.context.providerTurnId,
+          providerThreadId: input.context.input.providerThread.id,
+          nodeId: input.context.input.rootNodeId,
+          runAttemptId: input.context.input.attemptId,
+          nativeTurnRef: {
+            driver: CLAUDE_PROVIDER,
+            nativeId: input.context.nativeMessageCursor ?? input.context.nativeTurnId,
+            strength: "weak",
+          },
+          ordinal: input.context.providerTurnOrdinal,
+          status: input.status,
+          startedAt: input.context.startedAt,
+          completedAt: input.completedAt,
+        });
+
+        const buildToolCallArtifacts = (input: {
+          readonly context: ActiveClaudeTurnContext;
+          readonly nativeItemId: string;
+          readonly toolName: string;
+          readonly classification: ClaudeToolClassification;
+          readonly toolInput: ClaudeNativeToolInput;
+          readonly threadId: ThreadId;
+          readonly runId: ProviderAdapterV2TurnInput["runId"] | null;
+          readonly rootNodeId: OrchestrationV2ExecutionNode["id"];
+          readonly parentNodeId: OrchestrationV2ExecutionNode["id"];
+          readonly ordinal: number;
+          readonly output: ClaudeNativeToolOutput;
+          readonly status: Extract<
+            OrchestrationV2TurnItem["status"],
+            "running" | "completed" | "failed"
+          >;
+          readonly startedAt: DateTime.Utc;
+          readonly updatedAt: DateTime.Utc;
+        }) => {
+          const completedAt = input.status === "running" ? null : input.updatedAt;
+          const nodeId = idAllocator.derive.nodeFromProviderItem({
+            driver: CLAUDE_PROVIDER,
+            nativeItemId: input.nativeItemId,
+          });
+          const turnItemId = idAllocator.derive.turnItemFromProviderItem({
+            driver: CLAUDE_PROVIDER,
+            nativeItemId: input.nativeItemId,
+          });
+          const nativeItemRef = {
+            driver: CLAUDE_PROVIDER,
+            nativeId: input.nativeItemId,
+            strength: "strong" as const,
+          };
+          const node: OrchestrationV2ExecutionNode = {
+            id: nodeId,
+            threadId: input.threadId,
+            runId: input.runId,
+            parentNodeId: input.parentNodeId,
+            rootNodeId: input.rootNodeId,
+            kind: "tool_call",
+            status: input.status,
+            countsForRun: false,
+            providerThreadId: input.runId === null ? null : input.context.input.providerThread.id,
+            providerTurnId: input.runId === null ? null : input.context.providerTurnId,
+            nativeItemRef,
+            runtimeRequestId: null,
+            checkpointScopeId: null,
+            startedAt: input.startedAt,
+            completedAt,
+          };
+          const itemBase = {
+            id: turnItemId,
+            threadId: input.threadId,
+            runId: input.runId,
+            nodeId,
+            providerThreadId: input.runId === null ? null : input.context.input.providerThread.id,
+            providerTurnId: input.runId === null ? null : input.context.providerTurnId,
+            nativeItemRef,
+            parentItemId: null,
+            ordinal: input.ordinal,
+            status: input.status,
+            title: null,
+            startedAt: input.startedAt,
+            completedAt,
+            updatedAt: input.updatedAt,
+          } satisfies Pick<
+            OrchestrationV2TurnItem,
+            | "id"
+            | "threadId"
+            | "runId"
+            | "nodeId"
+            | "providerThreadId"
+            | "providerTurnId"
+            | "nativeItemRef"
+            | "parentItemId"
+            | "ordinal"
+            | "status"
+            | "title"
+            | "startedAt"
+            | "completedAt"
+            | "updatedAt"
+          >;
+          const itemType = input.classification.itemType;
+          const webSearchPatterns = webSearchPatternsFromClaudeTool({
+            toolInput: input.toolInput,
+            output: input.output,
+          });
+          const webSearchResults = webSearchResultsFromClaudeOutput(input.output);
+          const outputValue = claudeNativeToolOutputValue(input.output);
+          const outputText = claudeNativeToolOutputText(input.output);
+          const turnItem: OrchestrationV2TurnItem =
+            itemType === "command_execution"
+              ? {
+                  ...itemBase,
+                  type: "command_execution",
+                  input: commandInputFromClaudeTool(input.toolName, input.toolInput),
+                  ...(outputText.length === 0 ? {} : { output: outputText }),
+                }
+              : itemType === "file_change"
+                ? {
+                    ...itemBase,
+                    type: "file_change",
+                    fileName: fileNameFromClaudeTool(input.toolName, input.toolInput),
+                    ...(outputText.length === 0 ? {} : { diffStr: outputText }),
+                  }
+                : itemType === "web_search"
+                  ? {
+                      ...itemBase,
+                      type: "web_search",
+                      ...(webSearchPatterns.length === 0
+                        ? {}
+                        : { patterns: [...webSearchPatterns] }),
+                      ...(webSearchResults.length === 0 ? {} : { results: [...webSearchResults] }),
+                    }
+                  : {
+                      ...itemBase,
+                      type: "dynamic_tool",
+                      toolName: input.toolName,
+                      input: claudeNativeToolInputValue(input.toolInput),
+                      ...(outputValue === undefined ? {} : { output: outputValue }),
+                    };
+          return { node, turnItem };
+        };
+
+        const emitToolCallArtifacts = Effect.fnUntraced(function* (artifacts: {
+          readonly node: OrchestrationV2ExecutionNode;
+          readonly turnItem: OrchestrationV2TurnItem;
+        }) {
+          yield* emitProviderEvent({
+            type: "node.updated",
+            driver: CLAUDE_PROVIDER,
+            node: artifacts.node,
+          });
+          yield* emitProviderEvent({
+            type: "turn_item.updated",
+            driver: CLAUDE_PROVIDER,
+            turnItem: artifacts.turnItem,
+          });
+        });
+
+        const updateClaudeSubagentNode = Effect.fnUntraced(function* (input: {
+          readonly context: ActiveClaudeTurnContext;
+          readonly taskId: string;
+          readonly toolUseId?: string;
+          readonly prompt?: string;
+          readonly title?: string;
+          readonly model?: string;
+          readonly progress?: string;
+          readonly result?: string;
+          readonly status: Extract<
+            OrchestrationV2ExecutionNode["status"],
+            "running" | "completed" | "failed" | "cancelled"
+          >;
+          readonly reopen?: boolean;
+        }) {
+          // The session registry lets a wake-replay turn (fresh context maps)
+          // hydrate a subagent that was created by an earlier, settled turn.
+          const existingSubagent =
+            input.context.subagentsByTaskId.get(input.taskId) ??
+            (input.toolUseId === undefined
+              ? undefined
+              : input.context.subagentsByToolUseId.get(input.toolUseId)) ??
+            (yield* Ref.get(sessionSubagentsByTaskId)).get(input.taskId);
+          if (existingSubagent === undefined && input.status !== "running") {
+            return;
+          }
+          // Status is monotone with one exception: task_started for a known
+          // task id is an authoritative CLI lifecycle event (SendMessage to a
+          // completed subagent resumes it and re-emits task_started with the
+          // same id), so it may re-open a terminal entry. A late or
+          // out-of-order task_progress must not.
+          const isReopen =
+            input.reopen === true &&
+            existingSubagent !== undefined &&
+            existingSubagent.task.status !== "running" &&
+            input.status === "running";
+          if (
+            existingSubagent !== undefined &&
+            existingSubagent.task.status !== "running" &&
+            input.status === "running" &&
+            !isReopen
+          ) {
+            return;
+          }
+          const lifecycleChanged =
+            existingSubagent === undefined ||
+            existingSubagent.task.status !== input.status ||
+            // A drain-replayed resume task_started finds the registry entry
+            // already pre-opened to running by bufferWakeMessage while the
+            // projection node still holds the old terminal status; re-emit
+            // the node lifecycle for authoritative task_started updates.
+            (input.reopen === true && input.status === "running");
+
+          const now = yield* DateTime.now;
+          const nativeItemId = `task:${input.taskId}`;
+          const nodeId =
+            existingSubagent?.task.id ??
+            idAllocator.derive.nodeFromProviderItem({
+              driver: CLAUDE_PROVIDER,
+              nativeItemId,
+            });
+          const childRootNodeId =
+            existingSubagent?.childRootNodeId ??
+            idAllocator.derive.nodeFromProviderItem({
+              driver: CLAUDE_PROVIDER,
+              nativeItemId: `${nativeItemId}:thread-root`,
+            });
+          const childThreadId =
+            existingSubagent?.childThreadId ??
+            idAllocator.derive.threadFromProviderThread({
+              driver: CLAUDE_PROVIDER,
+              nativeThreadId: `${input.context.input.providerThread.id}:${input.taskId}`,
+            });
+          if (existingSubagent === undefined) {
+            input.context.subagentNodesByTaskId.set(input.taskId, nodeId);
+          }
+          const turnItemOrdinal =
+            existingSubagent?.turnItemOrdinal ??
+            (yield* resolveItemOrdinal(input.context, `${nativeItemId}:subagent`));
+          // A resumed subagent's previous final answer and progress no longer
+          // represent its outcome; the next task_progress/task_notification
+          // carry the new ones.
+          const priorTask =
+            existingSubagent === undefined
+              ? undefined
+              : isReopen
+                ? (({ progress: _staleProgress, ...rest }) => ({ ...rest, result: null }))(
+                    existingSubagent.task,
+                  )
+                : existingSubagent.task;
+          const task = {
+            ...(priorTask ?? {
+              id: nodeId,
+              threadId: input.context.input.threadId,
+              runId: input.context.input.runId,
+              parentNodeId: input.context.input.rootNodeId,
+              origin: "provider_native" as const,
+              createdBy: "agent" as const,
+              driver: CLAUDE_PROVIDER,
+              providerInstanceId: input.context.input.modelSelection.instanceId,
+              providerThreadId: null,
+              childThreadId,
+              nativeTaskRef: {
+                driver: CLAUDE_PROVIDER,
+                nativeId: input.taskId,
+                strength: "strong" as const,
+              },
+              prompt: input.prompt ?? "",
+              title: input.title ?? null,
+              model: input.model ?? input.context.input.modelSelection.model,
+              result: null,
+              startedAt: now,
+            }),
+            status: input.status,
+            // A reopen replayed under a continuation run re-attributes the
+            // subagent to that run. RunExecutionService routes parent-thread
+            // events by runId, and only the resuming run's ingestion fiber is
+            // guaranteed alive (the launch run's fiber stops once its child
+            // subagents terminalize); attribution also enrolls the subagent
+            // in the resuming run's active-child tracking so its fiber
+            // outlives settle until the resumed task completes.
+            ...(input.reopen === true &&
+            input.status === "running" &&
+            existingSubagent !== undefined
+              ? { runId: input.context.input.runId }
+              : {}),
+            ...(input.prompt === undefined ? {} : { prompt: input.prompt }),
+            ...(input.title === undefined ? {} : { title: input.title }),
+            ...(input.model === undefined ? {} : { model: input.model }),
+            ...(input.progress === undefined ? {} : { progress: input.progress }),
+            ...(input.result === undefined ? {} : { result: input.result }),
+            completedAt: input.status === "running" ? null : now,
+            updatedAt: now,
+          } satisfies OrchestrationV2Subagent;
+          const subagent = {
+            task,
+            childThreadId,
+            childRootNodeId,
+            turnItemId:
+              existingSubagent?.turnItemId ??
+              idAllocator.derive.turnItemFromProviderItem({
+                driver: CLAUDE_PROVIDER,
+                nativeItemId: `${nativeItemId}:subagent`,
+              }),
+            turnItemOrdinal,
+            nextChildItemOrdinal: existingSubagent?.nextChildItemOrdinal ?? 100,
+            progressItemOrdinal: existingSubagent?.progressItemOrdinal ?? null,
+            progressStartedAt: existingSubagent?.progressStartedAt ?? null,
+            resultItemOrdinal: existingSubagent?.resultItemOrdinal ?? null,
+          } satisfies ActiveClaudeSubagent;
+          input.context.subagentsByTaskId.set(input.taskId, subagent);
+          if (input.toolUseId !== undefined) {
+            input.context.subagentsByToolUseId.set(input.toolUseId, subagent);
+          }
+          // The same terminal protection, applied atomically: a concurrent
+          // fiber (live stream vs continuation drain) may have terminalized
+          // the registry entry after this update's lookup read it. A resume
+          // re-open (task_started) bypasses it only when the registered entry
+          // is still the terminal generation the lookup resolved; if a
+          // concurrent fiber installed a newer terminal entry meanwhile, the
+          // re-open must not clobber its result.
+          yield* Ref.update(sessionSubagentsByTaskId, (current) => {
+            const registered = current.get(input.taskId);
+            if (
+              registered !== undefined &&
+              registered.task.status !== "running" &&
+              input.status === "running" &&
+              !(isReopen && registered === existingSubagent)
+            ) {
+              return current;
+            }
+            return new Map(current).set(input.taskId, subagent);
+          });
+
+          if (existingSubagent === undefined) {
+            const childThread = makeSubagentChildThread({
+              parentThread: input.context.input.appThread,
+              childThreadId,
+              parentNodeId: nodeId,
+              activeProviderThreadId: null,
+              providerInstanceId: input.context.input.modelSelection.instanceId,
+              modelSelection: input.context.input.modelSelection,
+              title: subagentThreadTitle({
+                parentTitle: input.context.input.appThread.title,
+                prompt: task.prompt,
+                title: task.title,
+                ordinal: input.context.subagentsByTaskId.size,
+              }),
+              now,
+              createdBy: "agent",
+              creationSource: "provider",
+            });
+            yield* emitProviderEvent({
+              type: "app_thread.created",
+              driver: CLAUDE_PROVIDER,
+              appThread: childThread,
+            });
+          }
+
+          if (lifecycleChanged) {
+            yield* emitProviderEvent({
+              type: "node.updated",
+              driver: CLAUDE_PROVIDER,
+              node: {
+                id: nodeId,
+                // Parenting stays with the launch run's root node even on
+                // wake-replay; runId follows task.runId, which a reopen
+                // re-attributes to the resuming run (see task construction).
+                threadId: task.threadId,
+                runId: task.runId,
+                parentNodeId: task.parentNodeId,
+                rootNodeId: task.parentNodeId,
+                kind: "subagent",
+                status: input.status,
+                countsForRun: false,
+                providerThreadId: input.context.input.providerThread.id,
+                providerTurnId: input.context.providerTurnId,
+                nativeItemRef: {
+                  driver: CLAUDE_PROVIDER,
+                  nativeId: input.taskId,
+                  strength: "strong",
+                },
+                runtimeRequestId: null,
+                checkpointScopeId: null,
+                startedAt: task.startedAt,
+                completedAt: input.status === "running" ? null : now,
+              },
+            });
+            yield* emitProviderEvent({
+              type: "node.updated",
+              driver: CLAUDE_PROVIDER,
+              node: {
+                id: childRootNodeId,
+                threadId: childThreadId,
+                runId: null,
+                parentNodeId: null,
+                rootNodeId: childRootNodeId,
+                kind: "root_turn",
+                status: input.status,
+                countsForRun: false,
+                providerThreadId: null,
+                providerTurnId: null,
+                nativeItemRef: task.nativeTaskRef,
+                runtimeRequestId: null,
+                checkpointScopeId: null,
+                startedAt: task.startedAt,
+                completedAt: input.status === "running" ? null : now,
+              },
+            });
+          }
+          if (existingSubagent === undefined) {
+            const promptNativeItemId = `${nativeItemId}:prompt`;
+            const promptArtifacts = makeSubagentConversationArtifacts({
+              messageId: idAllocator.derive.messageFromProviderItem({
+                driver: CLAUDE_PROVIDER,
+                nativeItemId: promptNativeItemId,
+              }),
+              turnItemId: idAllocator.derive.turnItemFromProviderItem({
+                driver: CLAUDE_PROVIDER,
+                nativeItemId: promptNativeItemId,
+              }),
+              threadId: childThreadId,
+              rootNodeId: childRootNodeId,
+              providerThreadId: null,
+              providerTurnId: null,
+              nativeItemRef: {
+                driver: CLAUDE_PROVIDER,
+                nativeId: promptNativeItemId,
+                strength: "strong",
+              },
+              role: "user",
+              text: task.prompt,
+              ordinal: 100,
+              now,
+            });
+            yield* emitProviderEvent({
+              type: "message.updated",
+              driver: CLAUDE_PROVIDER,
+              message: promptArtifacts.message,
+            });
+            yield* emitProviderEvent({
+              type: "turn_item.updated",
+              driver: CLAUDE_PROVIDER,
+              turnItem: promptArtifacts.turnItem,
+            });
+          }
+          yield* emitProviderEvent({
+            type: "subagent.updated",
+            driver: CLAUDE_PROVIDER,
+            subagent: task,
+          });
+          yield* emitProviderEvent({
+            type: "turn_item.updated",
+            driver: CLAUDE_PROVIDER,
+            turnItem: {
+              id: subagent.turnItemId,
+              threadId: task.threadId,
+              runId: task.runId,
+              nodeId: task.id,
+              providerThreadId: input.context.input.providerThread.id,
+              providerTurnId: input.context.providerTurnId,
+              nativeItemRef: task.nativeTaskRef,
+              parentItemId: null,
+              ordinal: subagent.turnItemOrdinal,
+              status: task.status,
+              title: task.title,
+              startedAt: task.startedAt,
+              completedAt: task.completedAt,
+              updatedAt: task.updatedAt,
+              type: "subagent",
+              subagentId: task.id,
+              origin: task.origin,
+              driver: task.driver,
+              providerInstanceId: task.providerInstanceId,
+              childThreadId: task.childThreadId,
+              prompt: task.prompt,
+              ...(task.progress === undefined ? {} : { progress: task.progress }),
+              result: task.result,
+            },
+          });
+
+          const progress = task.progress?.trim();
+          if (
+            progress !== undefined &&
+            progress.length > 0 &&
+            (input.progress !== undefined || (lifecycleChanged && input.status !== "running"))
+          ) {
+            const progressNativeItemId = `${nativeItemId}:progress`;
+            const progressItemOrdinal =
+              subagent.progressItemOrdinal ?? ++subagent.nextChildItemOrdinal;
+            const progressStartedAt = subagent.progressStartedAt ?? now;
+            subagent.progressItemOrdinal = progressItemOrdinal;
+            subagent.progressStartedAt = progressStartedAt;
+            yield* emitProviderEvent({
+              type: "turn_item.updated",
+              driver: CLAUDE_PROVIDER,
+              turnItem: {
+                id: idAllocator.derive.turnItemFromProviderItem({
+                  driver: CLAUDE_PROVIDER,
+                  nativeItemId: progressNativeItemId,
+                }),
+                threadId: childThreadId,
+                runId: null,
+                nodeId: childRootNodeId,
+                providerThreadId: null,
+                providerTurnId: null,
+                nativeItemRef: {
+                  driver: CLAUDE_PROVIDER,
+                  nativeId: progressNativeItemId,
+                  strength: "strong",
+                },
+                parentItemId: null,
+                ordinal: progressItemOrdinal,
+                status: input.status,
+                title: "Subagent progress",
+                startedAt: progressStartedAt,
+                completedAt: input.status === "running" ? null : now,
+                updatedAt: now,
+                type: "reasoning",
+                text: progress,
+                streaming: input.status === "running",
+              },
+            });
+          }
+
+          if (
+            input.result !== undefined &&
+            input.result.trim().length > 0 &&
+            input.status !== "running"
+          ) {
+            const resultNativeItemId = `${nativeItemId}:result`;
+            const resultItemOrdinal = subagent.resultItemOrdinal ?? ++subagent.nextChildItemOrdinal;
+            subagent.resultItemOrdinal = resultItemOrdinal;
+            const resultArtifacts = makeSubagentConversationArtifacts({
+              messageId: idAllocator.derive.messageFromProviderItem({
+                driver: CLAUDE_PROVIDER,
+                nativeItemId: resultNativeItemId,
+              }),
+              turnItemId: idAllocator.derive.turnItemFromProviderItem({
+                driver: CLAUDE_PROVIDER,
+                nativeItemId: resultNativeItemId,
+              }),
+              threadId: childThreadId,
+              rootNodeId: childRootNodeId,
+              providerThreadId: null,
+              providerTurnId: null,
+              nativeItemRef: {
+                driver: CLAUDE_PROVIDER,
+                nativeId: resultNativeItemId,
+                strength: "strong",
+              },
+              role: "assistant",
+              text: input.result,
+              ordinal: resultItemOrdinal,
+              now,
+            });
+            yield* emitProviderEvent({
+              type: "message.updated",
+              driver: CLAUDE_PROVIDER,
+              message: resultArtifacts.message,
+            });
+            yield* emitProviderEvent({
+              type: "turn_item.updated",
+              driver: CLAUDE_PROVIDER,
+              turnItem: resultArtifacts.turnItem,
+            });
+          }
+        });
+
+        const emitClaudePlanProjection = Effect.fnUntraced(function* (input: {
+          readonly context: ActiveClaudeTurnContext;
+          readonly nativeItemId: string;
+          readonly kind: "todo_list" | "proposed_plan";
+          readonly steps?: ReadonlyArray<OrchestrationV2PlanStep>;
+          readonly markdown?: string;
+        }) {
+          const updatedAt = yield* DateTime.now;
+          const projectionNativeItemId = `${input.kind}:${input.nativeItemId}`;
+          const planKey = `${input.context.input.threadId}:${projectionNativeItemId}`;
+          const existingPlanId = (yield* Ref.get(planIdsByNativeItem)).get(planKey);
+          const planId =
+            existingPlanId ??
+            (yield* idAllocator.allocate.plan({
+              threadId: input.context.input.threadId,
+              runId: input.context.input.runId,
+              driver: CLAUDE_PROVIDER,
+            }));
+          if (existingPlanId === undefined) {
+            yield* Ref.update(planIdsByNativeItem, (current) => {
+              const updated = new Map(current);
+              updated.set(planKey, planId);
+              return updated;
+            });
+          }
+          const nodeId = idAllocator.derive.nodeFromProviderItem({
+            driver: CLAUDE_PROVIDER,
+            nativeItemId: projectionNativeItemId,
+          });
+          const nativeItemRef = {
+            driver: CLAUDE_PROVIDER,
+            nativeId: input.nativeItemId,
+            strength: "strong" as const,
+          };
+          const ordinal = yield* resolveItemOrdinal(input.context, projectionNativeItemId);
+          const steps = [...(input.steps ?? [])];
+          const todoStatus = steps.every((step) => step.status === "completed")
+            ? "completed"
+            : "active";
+          const plan: OrchestrationV2PlanArtifact =
+            input.kind === "todo_list"
+              ? {
+                  id: planId,
+                  threadId: input.context.input.threadId,
+                  runId: input.context.input.runId,
+                  nodeId,
+                  kind: "todo_list",
+                  status: todoStatus,
+                  steps,
+                }
+              : {
+                  id: planId,
+                  threadId: input.context.input.threadId,
+                  runId: input.context.input.runId,
+                  nodeId,
+                  kind: "proposed_plan",
+                  status: "active",
+                  markdown: input.markdown ?? "",
+                };
+          const node: OrchestrationV2ExecutionNode = {
+            id: nodeId,
+            threadId: input.context.input.threadId,
+            runId: input.context.input.runId,
+            parentNodeId: input.context.input.rootNodeId,
+            rootNodeId: input.context.input.rootNodeId,
+            kind: input.kind === "todo_list" ? "todo_list" : "plan",
+            status: "completed",
+            countsForRun: false,
+            providerThreadId: input.context.input.providerThread.id,
+            providerTurnId: input.context.providerTurnId,
+            nativeItemRef,
+            runtimeRequestId: null,
+            checkpointScopeId: null,
+            startedAt: updatedAt,
+            completedAt: updatedAt,
+          };
+          const common = {
+            id: idAllocator.derive.turnItemFromProviderItem({
+              driver: CLAUDE_PROVIDER,
+              nativeItemId: projectionNativeItemId,
+            }),
+            threadId: input.context.input.threadId,
+            runId: input.context.input.runId,
+            nodeId,
+            providerThreadId: input.context.input.providerThread.id,
+            providerTurnId: input.context.providerTurnId,
+            nativeItemRef,
+            parentItemId: null,
+            ordinal,
+            status: "completed" as const,
+            title: null,
+            startedAt: updatedAt,
+            completedAt: updatedAt,
+            updatedAt,
+          };
+          const turnItem: OrchestrationV2TurnItem =
+            input.kind === "todo_list"
+              ? { ...common, type: "todo_list", planId, steps }
+              : {
+                  ...common,
+                  type: "proposed_plan",
+                  planId,
+                  markdown: input.markdown ?? "",
+                  streaming: false,
+                };
+          const latestPlanKey = `${input.context.input.threadId}:${input.kind}`;
+          const previousPlan = (yield* Ref.get(latestPlanByKind)).get(latestPlanKey);
+          yield* Effect.all(
+            [
+              ...(previousPlan === undefined ||
+              previousPlan.id === plan.id ||
+              previousPlan.status === "completed"
+                ? []
+                : [
+                    emitProviderEvent({
+                      type: "plan.updated" as const,
+                      driver: CLAUDE_PROVIDER,
+                      plan: { ...previousPlan, status: "superseded" as const },
+                    }),
+                  ]),
+              emitProviderEvent({ type: "node.updated", driver: CLAUDE_PROVIDER, node }),
+              emitProviderEvent({ type: "plan.updated", driver: CLAUDE_PROVIDER, plan }),
+              emitProviderEvent({ type: "turn_item.updated", driver: CLAUDE_PROVIDER, turnItem }),
+            ],
+            { concurrency: 1 },
+          );
+          yield* Ref.update(latestPlanByKind, (current) => {
+            const updated = new Map(current);
+            updated.set(latestPlanKey, plan);
+            return updated;
+          });
+        });
+
+        const ensureToolCallStarted = Effect.fnUntraced(function* (input: {
+          readonly context: ActiveClaudeTurnContext;
+          readonly nativeItemId: string;
+          readonly toolName: string;
+          readonly toolInput: ClaudeNativeToolInput;
+          readonly parentToolUseId: string | null;
+        }) {
+          const existing = input.context.toolCalls.get(input.nativeItemId);
+          if (existing !== undefined) {
+            return existing;
+          }
+          const startedAt = yield* DateTime.now;
+          const classification = classifyClaudeNativeTool(input.toolName);
+          const subagent =
+            input.parentToolUseId === null
+              ? undefined
+              : input.context.subagentsByToolUseId.get(input.parentToolUseId);
+          const threadId = subagent?.childThreadId ?? input.context.input.threadId;
+          const runId = subagent === undefined ? input.context.input.runId : null;
+          const rootNodeId = subagent?.childRootNodeId ?? input.context.input.rootNodeId;
+          const parentNodeId = rootNodeId;
+          const ordinal =
+            subagent === undefined
+              ? yield* resolveItemOrdinal(input.context, input.nativeItemId)
+              : ++subagent.nextChildItemOrdinal;
+          const toolCall: ActiveClaudeToolCall = {
+            nativeItemId: input.nativeItemId,
+            toolName: input.toolName,
+            classification,
+            input: input.toolInput,
+            threadId,
+            runId,
+            rootNodeId,
+            parentNodeId,
+            ordinal,
+            startedAt,
+          };
+          input.context.toolCalls.set(input.nativeItemId, toolCall);
+          yield* emitToolCallArtifacts(
+            buildToolCallArtifacts({
+              context: input.context,
+              nativeItemId: input.nativeItemId,
+              toolName: input.toolName,
+              classification,
+              toolInput: input.toolInput,
+              threadId,
+              runId,
+              rootNodeId,
+              parentNodeId,
+              ordinal,
+              output: NO_CLAUDE_NATIVE_TOOL_OUTPUT,
+              status: "running",
+              startedAt,
+              updatedAt: startedAt,
+            }),
+          );
+          return toolCall;
+        });
+
+        const buildApprovalRequestArtifacts = Effect.fnUntraced(function* (input: {
+          readonly context: ActiveClaudeTurnContext;
+          readonly nativeItemId: string;
+          readonly nativeRequestId: string;
+          readonly requestKind: OrchestrationV2RuntimeRequest["kind"];
+          readonly prompt?: string;
+          readonly questions?: ReadonlyArray<OrchestrationV2UserInputQuestion>;
+        }) {
+          const createdAt = yield* DateTime.now;
+          const requestId = yield* idAllocator.allocate.runtimeRequest({
+            driver: CLAUDE_PROVIDER,
+            providerTurnId: input.context.providerTurnId,
+            nativeRequestId: input.nativeRequestId,
+          });
+          const nodeId = idAllocator.derive.approvalNode({ requestId });
+          const providerSessionId = input.context.input.providerThread.providerSessionId;
+          if (providerSessionId === null) {
+            return yield* new ProviderAdapterProtocolError({
+              driver: CLAUDE_PROVIDER,
+              detail: `Provider thread ${input.context.input.providerThread.id} is missing a provider session id.`,
+            });
+          }
+          const ordinal = yield* resolveItemOrdinal(
+            input.context,
+            `${input.nativeItemId}:approval:${input.nativeRequestId}`,
+          );
+          const nativeItemRef = {
+            driver: CLAUDE_PROVIDER,
+            nativeId: input.nativeRequestId,
+            strength: "strong" as const,
+          };
+          const node: OrchestrationV2ExecutionNode = {
+            id: nodeId,
+            threadId: input.context.input.threadId,
+            runId: input.context.input.runId,
+            parentNodeId: idAllocator.derive.nodeFromProviderItem({
+              driver: CLAUDE_PROVIDER,
+              nativeItemId: input.nativeItemId,
+            }),
+            rootNodeId: input.context.input.rootNodeId,
+            kind: input.questions === undefined ? "approval_request" : "user_input_request",
+            status: "waiting",
+            countsForRun: false,
+            providerThreadId: input.context.input.providerThread.id,
+            providerTurnId: input.context.providerTurnId,
+            nativeItemRef,
+            runtimeRequestId: requestId,
+            checkpointScopeId: null,
+            startedAt: createdAt,
+            completedAt: null,
+          };
+          const request: OrchestrationV2RuntimeRequest = {
+            id: requestId,
+            nodeId,
+            providerTurnId: input.context.providerTurnId,
+            nativeRequestRef: {
+              driver: CLAUDE_PROVIDER,
+              nativeId: input.nativeRequestId,
+              strength: "strong",
+            },
+            kind: input.requestKind,
+            status: "pending",
+            responseCapability: {
+              type: "live",
+              providerSessionId,
+            },
+            createdAt,
+            resolvedAt: null,
+          };
+          const turnItem: OrchestrationV2TurnItem = {
+            id: idAllocator.derive.approvalTurnItem({ requestId }),
+            threadId: input.context.input.threadId,
+            runId: input.context.input.runId,
+            nodeId,
+            providerThreadId: input.context.input.providerThread.id,
+            providerTurnId: input.context.providerTurnId,
+            nativeItemRef,
+            parentItemId: null,
+            ordinal,
+            status: "waiting",
+            title: null,
+            startedAt: createdAt,
+            completedAt: null,
+            updatedAt: createdAt,
+            ...(input.questions === undefined
+              ? {
+                  type: "approval_request" as const,
+                  requestId,
+                  requestKind: input.requestKind as ProviderRequestKind,
+                  ...(input.prompt === undefined ? {} : { prompt: input.prompt }),
+                }
+              : {
+                  type: "user_input_request" as const,
+                  requestId,
+                  questions: [...input.questions],
+                }),
+          };
+          return { node, request, turnItem };
+        });
+
+        const finalizeActiveTurn = Effect.fnUntraced(function* (input: {
+          readonly context: ActiveClaudeTurnContext;
+          readonly status: Extract<
+            OrchestrationV2ProviderTurn["status"],
+            "completed" | "interrupted" | "failed" | "cancelled"
+          >;
+          readonly completedAt: DateTime.Utc;
+          readonly failure?: OrchestrationV2ProviderFailure;
+          readonly threadDisposition?: "reusable" | "broken";
+        }) {
+          for (const toolCall of input.context.toolCalls.values()) {
+            const artifacts = buildToolCallArtifacts({
+              context: input.context,
+              nativeItemId: toolCall.nativeItemId,
+              toolName: toolCall.toolName,
+              classification: toolCall.classification,
+              toolInput: toolCall.input,
+              threadId: toolCall.threadId,
+              runId: toolCall.runId,
+              rootNodeId: toolCall.rootNodeId,
+              parentNodeId: toolCall.parentNodeId,
+              ordinal: toolCall.ordinal,
+              output: NO_CLAUDE_NATIVE_TOOL_OUTPUT,
+              status: "failed",
+              startedAt: toolCall.startedAt,
+              updatedAt: input.completedAt,
+            });
+            yield* emitToolCallArtifacts(artifacts);
+          }
+          input.context.toolCalls.clear();
+
+          if (
+            input.context.assistant.emittedNativeItemIds.size === 0 &&
+            input.context.assistant.fallbackText.length > 0
+          ) {
+            const ordinal = yield* resolveItemOrdinal(
+              input.context,
+              input.context.assistant.fallbackNativeItemId,
+            );
+            const artifacts = buildAssistantArtifacts({
+              idAllocator,
+              turnInput: input.context.input,
+              providerTurnId: input.context.providerTurnId,
+              nativeItemId: input.context.assistant.fallbackNativeItemId,
+              text: input.context.assistant.fallbackText,
+              ordinal,
+              startedAt: input.context.startedAt,
+              completedAt: input.completedAt,
+            });
+            yield* Effect.all(
+              [
+                emitProviderEvent({
+                  type: "node.updated",
+                  driver: CLAUDE_PROVIDER,
+                  node: artifacts.node,
+                }),
+                emitProviderEvent({
+                  type: "message.updated",
+                  driver: CLAUDE_PROVIDER,
+                  message: artifacts.message,
+                }),
+                emitProviderEvent({
+                  type: "turn_item.updated",
+                  driver: CLAUDE_PROVIDER,
+                  turnItem: artifacts.turnItem,
+                }),
+              ],
+              { concurrency: 1 },
+            );
+          }
+
+          const providerRetry = yield* Ref.modify(providerRetries, (current) => {
+            const retry = current.get(input.context.providerTurnId);
+            if (retry === undefined) {
+              return [undefined, current] as const;
+            }
+            const updated = new Map(current);
+            updated.delete(input.context.providerTurnId);
+            return [retry, updated] as const;
+          });
+          if (providerRetry !== undefined && input.status !== "failed") {
+            yield* emitProviderEvent({
+              type: "turn_item.updated",
+              driver: CLAUDE_PROVIDER,
+              turnItem: makeProviderRetryTurnItem({
+                idAllocator,
+                driver: CLAUDE_PROVIDER,
+                threadId: input.context.input.threadId,
+                runId: input.context.input.runId,
+                nodeId: input.context.input.rootNodeId,
+                providerThreadId: input.context.input.providerThread.id,
+                providerTurnId: input.context.providerTurnId,
+                itemOrdinal: providerRetry.itemOrdinal,
+                failure: providerRetry.failure,
+                retry: providerRetry.retry,
+                status: input.status,
+                startedAt: providerRetry.startedAt,
+                updatedAt: input.completedAt,
+              }),
+            });
+          }
+
+          const threadDisposition = input.threadDisposition ?? "reusable";
+          const terminalEvent: ProviderAdapterV2Event =
+            input.status === "failed"
+              ? {
+                  type: "turn.terminal",
+                  driver: CLAUDE_PROVIDER,
+                  providerThreadId: input.context.input.providerThread.id,
+                  providerTurnId: input.context.providerTurnId,
+                  runOrdinal: input.context.input.runOrdinal,
+                  failureItemOrdinal: yield* resolveItemOrdinal(
+                    input.context,
+                    `terminal-failure:${input.context.providerTurnId}`,
+                  ),
+                  status: input.status,
+                  failure: input.failure ?? makeProviderFailure({ class: "provider_error" }),
+                  ...(providerRetry === undefined
+                    ? {}
+                    : {
+                        retry: providerRetry.retry,
+                        retryStartedAt: providerRetry.startedAt,
+                      }),
+                  threadDisposition,
+                }
+              : {
+                  type: "turn.terminal",
+                  driver: CLAUDE_PROVIDER,
+                  providerThreadId: input.context.input.providerThread.id,
+                  providerTurnId: input.context.providerTurnId,
+                  runOrdinal: input.context.input.runOrdinal,
+                  status: input.status,
+                  failure: null,
+                  threadDisposition,
+                };
+          yield* Effect.all(
+            [
+              emitProviderEvent({
+                type: "provider_turn.updated",
+                driver: CLAUDE_PROVIDER,
+                providerTurn: providerTurnPayload({
+                  context: input.context,
+                  status: input.status,
+                  completedAt: input.completedAt,
+                }),
+              }),
+              // Surface this native thread's roster before the root turn
+              // terminals so writeFinalRunEvents preserves it. Failed or
+              // interrupted turns drop only this thread's roster so sibling
+              // native threads keep their Waiting state.
+              Effect.gen(function* () {
+                const nativeThreadId =
+                  input.context.input.providerThread.nativeThreadRef?.nativeId ?? null;
+                if (nativeThreadId !== null) {
+                  if (input.status !== "completed") {
+                    yield* clearPendingBackgroundTasksForNativeThread(nativeThreadId);
+                    yield* clearNativeThreadTaskIdSet(
+                      wakeEligibleBackgroundTasksByNativeThread,
+                      nativeThreadId,
+                    );
+                    yield* clearNativeThreadTaskIdSet(
+                      opaqueBackgroundTaskReplayTombstonesByNativeThread,
+                      nativeThreadId,
+                    );
+                  }
+                }
+                const roster =
+                  nativeThreadId === null
+                    ? new Map<string, OrchestrationV2PendingBackgroundTask>()
+                    : rosterForNativeThread(
+                        yield* Ref.get(pendingBackgroundTasksByNativeThread),
+                        nativeThreadId,
+                      );
+                const clearConversationHead =
+                  input.status === "completed" &&
+                  input.context.input.providerThread.nativeConversationHeadRef !== null;
+                const providerThread: OrchestrationV2ProviderThread = {
+                  ...input.context.input.providerThread,
+                  providerSessionId: session.id,
+                  ...(clearConversationHead ? { nativeConversationHeadRef: null } : {}),
+                  firstRunOrdinal:
+                    input.context.input.providerThread.firstRunOrdinal ??
+                    input.context.input.runOrdinal,
+                  lastRunOrdinal: input.context.input.runOrdinal,
+                  pendingBackgroundTasks: claudePendingBackgroundTasksFromRoster(roster),
+                  status: input.status === "completed" ? "active" : "idle",
+                  updatedAt: input.completedAt,
+                };
+                yield* rememberProviderThread(providerThread);
+                yield* emitProviderEvent({
+                  type: "provider_thread.updated" as const,
+                  driver: CLAUDE_PROVIDER,
+                  providerThread,
+                });
+              }),
+              emitProviderEvent(terminalEvent),
+            ],
+            { concurrency: 1 },
+          );
+          yield* Ref.update(activeTurn, (current) =>
+            current?.providerTurnId === input.context.providerTurnId ? null : current,
+          );
+          yield* Ref.update(interruptedTurns, (current) => {
+            const next = new Set(current);
+            next.delete(input.context.providerTurnId);
+            return next;
+          });
+        });
+
+        const emitAssistantTextArtifacts = Effect.fnUntraced(function* (input: {
+          readonly context: ActiveClaudeTurnContext;
+          readonly nativeItemId: string;
+          readonly text: string;
+        }) {
+          if (input.context.assistant.emittedNativeItemIds.has(input.nativeItemId)) {
+            return;
+          }
+          input.context.assistant.emittedNativeItemIds.add(input.nativeItemId);
+          const now = yield* DateTime.now;
+          const ordinal = yield* resolveItemOrdinal(input.context, input.nativeItemId);
+          const artifacts = buildAssistantArtifacts({
+            idAllocator,
+            turnInput: input.context.input,
+            providerTurnId: input.context.providerTurnId,
+            nativeItemId: input.nativeItemId,
+            text: input.text,
+            ordinal,
+            startedAt: now,
+            completedAt: now,
+          });
+          yield* Effect.all(
+            [
+              emitProviderEvent({
+                type: "node.updated",
+                driver: CLAUDE_PROVIDER,
+                node: artifacts.node,
+              }),
+              emitProviderEvent({
+                type: "message.updated",
+                driver: CLAUDE_PROVIDER,
+                message: artifacts.message,
+              }),
+              emitProviderEvent({
+                type: "turn_item.updated",
+                driver: CLAUDE_PROVIDER,
+                turnItem: artifacts.turnItem,
+              }),
+            ],
+            { concurrency: 1 },
+          );
+        });
+
+        const finalizeActiveTurnAfterQueryExit = Effect.fnUntraced(function* (
+          cause?: Cause.Cause<ClaudeAgentSdkQueryRunnerError>,
+        ) {
+          const context = yield* Ref.get(activeTurn);
+          if (context === null) {
+            return;
+          }
+          const completedAt = yield* DateTime.now;
+          const interrupted = (yield* Ref.get(interruptedTurns)).has(context.providerTurnId);
+          yield* finalizeActiveTurn({
+            context,
+            status: interrupted ? "interrupted" : "failed",
+            completedAt,
+            ...(interrupted
+              ? {}
+              : {
+                  failure: makeProviderFailure({
+                    cause: cause === undefined ? undefined : Cause.squash(cause),
+                    class: "transport_error",
+                  }),
+                }),
+          });
+          yield* Ref.update(interruptedTurns, (current) => {
+            const next = new Set(current);
+            next.delete(context.providerTurnId);
+            return next;
+          });
+          if (cause !== undefined) {
+            yield* Effect.logWarning("orchestration-v2.claude-query-stream-failed", {
+              providerSessionId: input.providerSessionId,
+              providerThreadId: context.input.providerThread.id,
+              providerTurnId: context.providerTurnId,
+              cause,
+            });
+          }
+        });
+
+        const bufferWakeMessage = Effect.fnUntraced(function* (wakeInput: {
+          readonly nativeThreadId: string;
+          readonly message: SDKMessage;
+        }) {
+          const message = wakeInput.message;
+          const isNotification =
+            message.type === "system" && message.subtype === "task_notification";
+          // Only notifications for tracked tasks count as wake evidence: a
+          // wake-eligible local_bash task (eligibility set, not the Waiting
+          // roster), or a session-registered subagent that is still running
+          // (Agent with run_in_background settling after the root turn). A
+          // stray notification for an unknown task is dropped as before
+          // instead of triggering a spurious continuation.
+          const isPendingTaskNotification =
+            isNotification &&
+            (yield* isWakeEligibleOpaqueBackgroundTaskOnNativeThread(
+              wakeInput.nativeThreadId,
+              message.task_id,
+            ));
+          const isPendingSubagentNotification =
+            isNotification &&
+            !isPendingTaskNotification &&
+            (yield* Ref.get(sessionSubagentsByTaskId)).get(message.task_id)?.task.status ===
+              "running";
+          // A task_started for a session-registered subagent that races past
+          // settle is a resume (SendMessage to a completed subagent re-emits
+          // task_started with the same task id). Re-open the registry entry
+          // so the resumed run pins idle and its eventual notification counts
+          // as wake evidence again, and buffer the frame so the continuation
+          // drain re-opens the projection row; it does not itself offer a
+          // continuation.
+          const isKnownSubagentTaskStarted =
+            message.type === "system" &&
+            message.subtype === "task_started" &&
+            (yield* Ref.get(sessionSubagentsByTaskId)).has(message.task_id);
+          if (
+            isKnownSubagentTaskStarted &&
+            message.type === "system" &&
+            message.subtype === "task_started"
+          ) {
+            const now = yield* DateTime.now;
+            yield* Ref.update(sessionSubagentsByTaskId, (current) => {
+              const registered = current.get(message.task_id);
+              if (registered === undefined || registered.task.status === "running") {
+                return current;
+              }
+              const { progress: _staleProgress, ...priorTask } = registered.task;
+              return new Map(current).set(message.task_id, {
+                ...registered,
+                task: {
+                  ...priorTask,
+                  status: "running",
+                  result: null,
+                  completedAt: null,
+                  updatedAt: now,
+                },
+              });
+            });
+          }
+          const isWakeEvidence =
+            isPendingTaskNotification ||
+            isPendingSubagentNotification ||
+            isKnownSubagentTaskStarted ||
+            message.type === "assistant" ||
+            message.type === "user" ||
+            message.type === "result";
+          if (!isWakeEvidence) {
+            return;
+          }
+          const notificationSummary =
+            isNotification && typeof message.summary === "string" && message.summary.length > 0
+              ? message.summary
+              : null;
+          yield* Ref.update(wakeBuffers, (current) => {
+            const existing = current.get(wakeInput.nativeThreadId);
+            const updated = new Map(current);
+            updated.set(wakeInput.nativeThreadId, {
+              messages: [...(existing?.messages ?? []), message],
+              detail: notificationSummary ?? existing?.detail ?? null,
+            });
+            return updated;
+          });
+          // First idle opaque notification: consume wake eligibility so a
+          // duplicate cannot re-buffer, and leave a short-lived replay
+          // tombstone for continuation-drain classification.
+          if (isPendingTaskNotification) {
+            yield* consumeWakeEligibilityForBufferedNotification(
+              wakeInput.nativeThreadId,
+              message.task_id,
+            );
+          }
+          // A terminal task notification can clear the Waiting roster without
+          // Claude dequeuing it into a native model turn. Buffer it for replay,
+          // but do not open an opaque-task continuation until native user,
+          // assistant, or result output proves that Claude actually began the
+          // wake turn. Subagent notifications retain their existing immediate
+          // offer because their projected lifecycle owns the continuation.
+          const buffered = (yield* Ref.get(wakeBuffers)).get(wakeInput.nativeThreadId);
+          const hasBufferedNotification =
+            buffered?.messages.some(
+              (entry) => entry.type === "system" && entry.subtype === "task_notification",
+            ) ?? false;
+          const isNativeOpaqueWakeFrame =
+            hasBufferedNotification && (message.type === "assistant" || message.type === "user");
+          if (
+            !isPendingSubagentNotification &&
+            !isNativeOpaqueWakeFrame &&
+            message.type !== "result"
+          ) {
+            return;
+          }
+          const route = (yield* Ref.get(lastTurnRouteByNativeThread)).get(wakeInput.nativeThreadId);
+          if (route === undefined) {
+            yield* Effect.logWarning("orchestration-v2.claude-wake-turn-unroutable", {
+              providerSessionId: input.providerSessionId,
+              nativeThreadId: wakeInput.nativeThreadId,
+            });
+            return;
+          }
+          const shouldOffer = yield* Ref.modify(requestedContinuations, (current) => {
+            if (current.has(wakeInput.nativeThreadId)) {
+              return [false, current] as const;
+            }
+            const updated = new Set(current);
+            updated.add(wakeInput.nativeThreadId);
+            return [true, updated] as const;
+          });
+          if (!shouldOffer) {
+            return;
+          }
+          const detail =
+            (yield* Ref.get(wakeBuffers)).get(wakeInput.nativeThreadId)?.detail ?? null;
+          yield* Effect.logInfo("orchestration-v2.claude-wake-turn-detected", {
+            providerSessionId: input.providerSessionId,
+            threadId: route.threadId,
+            providerThreadId: route.providerThreadId,
+          });
+          yield* continuationRequests.offer({
+            threadId: route.threadId,
+            providerThreadId: route.providerThreadId,
+            driver: CLAUDE_PROVIDER,
+            detail,
+          });
+        });
+
+        const applyBackgroundTaskRosterMessage = Effect.fnUntraced(function* (input: {
+          readonly nativeThreadId: string;
+          readonly message: SDKMessage;
+          readonly activeContext: ActiveClaudeTurnContext | null;
+        }) {
+          const message = input.message;
+          let rosterChanged = false;
+
+          if (isClaudeBackgroundTasksChangedMessage(message)) {
+            const roster = Reflect.get(message, "tasks");
+            if (!Array.isArray(roster)) {
+              return false;
+            }
+            const nextTasks: OrchestrationV2PendingBackgroundTask[] = [];
+            for (const entry of roster) {
+              const task = parseClaudeBackgroundTaskEntry(entry);
+              if (task !== null) {
+                nextTasks.push(task);
+              }
+            }
+            yield* replacePendingBackgroundTasks(input.nativeThreadId, nextTasks);
+            rosterChanged = true;
+          } else if (message.type === "system" && message.subtype === "task_started") {
+            // Incremental fallback when background_tasks_changed is absent.
+            // Subagent tasks project as subagent turn items; only non-subagent
+            // background work (e.g. local_bash) lives on the provider-thread roster.
+            if (!isClaudeNonSubagentTask(message)) {
+              return false;
+            }
+            const description =
+              typeof message.description === "string" && message.description.trim().length > 0
+                ? message.description
+                : undefined;
+            const taskType = claudeTaskTypeFromSdkMessage(message) ?? undefined;
+            yield* upsertPendingBackgroundTask(input.nativeThreadId, {
+              taskId: message.task_id,
+              ...(description === undefined ? {} : { description }),
+              ...(taskType === undefined ? {} : { taskType }),
+            });
+            rosterChanged = true;
+          } else if (message.type === "system" && message.subtype === "task_notification") {
+            const removed = yield* clearPendingBackgroundTask(
+              input.nativeThreadId,
+              message.task_id,
+            );
+            // Waiting roster clears on the notification edge. Wake eligibility
+            // is consumed when the first idle notification is buffered; clear
+            // here too for same-turn active notifications that never entered
+            // the idle buffer path. Replay tombstones are not cleared here.
+            yield* clearTaskIdFromNativeThreadSet(
+              wakeEligibleBackgroundTasksByNativeThread,
+              input.nativeThreadId,
+              message.task_id,
+            );
+            rosterChanged = removed;
+          }
+
+          if (!rosterChanged) {
+            return false;
+          }
+
+          const baseThread =
+            input.activeContext?.input.providerThread ??
+            (yield* Ref.get(lastProviderThreadByNativeThread)).get(input.nativeThreadId);
+          if (baseThread === undefined) {
+            return true;
+          }
+
+          // Between turns, never resurrect active status from a late empty
+          // roster update. During an active turn, preserve the thread status.
+          const status =
+            input.activeContext === null
+              ? ("idle" as const)
+              : baseThread.status === "idle"
+                ? ("active" as const)
+                : baseThread.status;
+          yield* emitProviderThreadRoster({
+            nativeThreadId: input.nativeThreadId,
+            providerThread: baseThread,
+            status,
+          });
+          return true;
+        });
+
+        const handleSdkMessage = Effect.fnUntraced(function* (input: {
+          readonly query: ClaudeAgentSdkQuerySession;
+          readonly message: SDKMessage;
+        }) {
+          const liveQuery = yield* Ref.get(queryContext);
+          if (liveQuery?.query !== input.query) {
+            return;
+          }
+
+          const message = input.message;
+          const context = yield* Ref.get(activeTurn);
+          if (context === null) {
+            // task_notification must buffer wake evidence while still tracked
+            // on the roster; clearing first would drop the wake pin.
+            if (message.type === "system" && message.subtype === "task_notification") {
+              yield* bufferWakeMessage({ nativeThreadId: liveQuery.nativeThreadId, message });
+              yield* applyBackgroundTaskRosterMessage({
+                nativeThreadId: liveQuery.nativeThreadId,
+                message,
+                activeContext: null,
+              });
+            } else {
+              yield* applyBackgroundTaskRosterMessage({
+                nativeThreadId: liveQuery.nativeThreadId,
+                message,
+                activeContext: null,
+              });
+              yield* bufferWakeMessage({ nativeThreadId: liveQuery.nativeThreadId, message });
+            }
+            return;
+          }
+
+          if (message.type === "assistant") {
+            context.nativeMessageCursor = message.uuid;
+          }
+
+          if (message.type === "system" && message.subtype === "api_retry") {
+            const updatedAt = yield* DateTime.now;
+            const previous = (yield* Ref.get(providerRetries)).get(context.providerTurnId);
+            const retry: OrchestrationV2ProviderRetry = {
+              attempt: Math.max(1, Math.trunc(message.attempt)),
+              maxAttempts: Math.max(1, Math.trunc(message.max_retries)),
+              retryDelayMs: Math.max(0, Math.trunc(message.retry_delay_ms)),
+            };
+            const failure = providerFailureFromApiRetry(message);
+            const itemOrdinal =
+              previous?.itemOrdinal ??
+              (yield* resolveItemOrdinal(context, `terminal-failure:${context.providerTurnId}`));
+            const state: ActiveClaudeProviderRetry = {
+              retry,
+              failure,
+              startedAt: previous?.startedAt ?? updatedAt,
+              itemOrdinal,
+            };
+            yield* Ref.update(providerRetries, (current) => {
+              const updated = new Map(current);
+              updated.set(context.providerTurnId, state);
+              return updated;
+            });
+            yield* emitProviderEvent({
+              type: "turn_item.updated",
+              driver: CLAUDE_PROVIDER,
+              turnItem: makeProviderRetryTurnItem({
+                idAllocator,
+                driver: CLAUDE_PROVIDER,
+                threadId: context.input.threadId,
+                runId: context.input.runId,
+                nodeId: context.input.rootNodeId,
+                providerThreadId: context.input.providerThread.id,
+                providerTurnId: context.providerTurnId,
+                itemOrdinal,
+                failure,
+                retry,
+                status: "running",
+                startedAt: state.startedAt,
+                updatedAt,
+              }),
+            });
+            return;
+          }
+
+          if (message.type === "assistant") {
+            const now = yield* DateTime.now;
+            yield* completeProviderRetry(context, now);
+            if (message.parent_tool_use_id === null && message.message.usage !== undefined) {
+              yield* emitProviderEvent({
+                type: "provider_turn.updated",
+                driver: CLAUDE_PROVIDER,
+                threadId: context.input.threadId,
+                providerTurn: {
+                  id: context.providerTurnId,
+                  providerThreadId: context.input.providerThread.id,
+                  nodeId: context.input.rootNodeId,
+                  runAttemptId: context.input.attemptId,
+                  nativeTurnRef: {
+                    driver: CLAUDE_PROVIDER,
+                    nativeId: context.nativeTurnId,
+                    strength: "strong",
+                  },
+                  ordinal: context.providerTurnOrdinal,
+                  status: "running",
+                  startedAt: context.startedAt,
+                  completedAt: null,
+                  tokenUsage: claudeProviderTurnTokenUsage(
+                    message.message.usage,
+                    context.input.modelSelection,
+                    DateTime.formatIso(now),
+                  ),
+                },
+              });
+            }
+            const parentToolUseId = message.parent_tool_use_id;
+            const snapshotModel =
+              typeof message.message.model === "string" ? message.message.model.trim() : "";
+            const model = snapshotModel.length === 0 ? undefined : snapshotModel;
+            if (parentToolUseId !== null && model !== undefined) {
+              const subagent = context.subagentsByToolUseId.get(parentToolUseId);
+              if (subagent === undefined) {
+                rememberPendingClaudeSubagentModel(
+                  context.pendingSubagentModelsByToolUseId,
+                  parentToolUseId,
+                  model,
+                );
+              } else if (subagent.task.status === "running" && subagent.task.model !== model) {
+                yield* updateClaudeSubagentNode({
+                  context,
+                  taskId: subagent.task.nativeTaskRef?.nativeId ?? String(subagent.task.id),
+                  toolUseId: parentToolUseId,
+                  model,
+                  status: subagent.task.status,
+                });
+              }
+            }
+          }
+
+          if (isClaudeBackgroundTasksChangedMessage(message)) {
+            yield* applyBackgroundTaskRosterMessage({
+              nativeThreadId: liveQuery.nativeThreadId,
+              message,
+              activeContext: context,
+            });
+            return;
+          }
+
+          if (message.type === "system" && message.subtype === "task_started") {
+            if (isClaudeNonSubagentTask(message)) {
+              context.ignoredTaskIds.add(message.task_id);
+              yield* applyBackgroundTaskRosterMessage({
+                nativeThreadId: liveQuery.nativeThreadId,
+                message,
+                activeContext: context,
+              });
+            } else {
+              const model =
+                message.tool_use_id === undefined
+                  ? undefined
+                  : context.pendingSubagentModelsByToolUseId.get(message.tool_use_id);
+              if (message.tool_use_id !== undefined) {
+                context.pendingSubagentModelsByToolUseId.delete(message.tool_use_id);
+              }
+              yield* updateClaudeSubagentNode({
+                context,
+                taskId: message.task_id,
+                ...(message.tool_use_id === undefined ? {} : { toolUseId: message.tool_use_id }),
+                ...(message.prompt === undefined ? {} : { prompt: message.prompt }),
+                ...(model === undefined ? {} : { model }),
+                title: message.description,
+                status: "running",
+                reopen: true,
+              });
+            }
+          }
+
+          if (message.type === "system" && message.subtype === "task_progress") {
+            const progress = message.description.trim();
+            const isBackgroundTask = yield* hasPendingBackgroundTaskOnNativeThread(
+              liveQuery.nativeThreadId,
+              message.task_id,
+            );
+            if (
+              progress.length > 0 &&
+              !context.ignoredTaskIds.has(message.task_id) &&
+              !isBackgroundTask
+            ) {
+              yield* updateClaudeSubagentNode({
+                context,
+                taskId: message.task_id,
+                ...(message.tool_use_id === undefined ? {} : { toolUseId: message.tool_use_id }),
+                progress,
+                status: "running",
+              });
+            }
+          }
+
+          if (message.type === "system" && message.subtype === "task_notification") {
+            // A wake-replay turn has empty ignoredTaskIds, so opaque-task
+            // tracking (live roster, wake eligibility, or the short-lived
+            // post-buffer replay tombstone) classifies local_bash before any
+            // subagent handling.
+            const wasBackgroundTask = yield* isKnownOpaqueBackgroundTaskOnNativeThread(
+              liveQuery.nativeThreadId,
+              message.task_id,
+            );
+            yield* applyBackgroundTaskRosterMessage({
+              nativeThreadId: liveQuery.nativeThreadId,
+              message,
+              activeContext: context,
+            });
+            if (!wasBackgroundTask && !context.ignoredTaskIds.has(message.task_id)) {
+              yield* updateClaudeSubagentNode({
+                context,
+                taskId: message.task_id,
+                ...(message.tool_use_id === undefined ? {} : { toolUseId: message.tool_use_id }),
+                result: message.summary,
+                status:
+                  message.status === "completed"
+                    ? "completed"
+                    : message.status === "stopped"
+                      ? "cancelled"
+                      : "failed",
+              });
+            }
+            // Replay tombstone only needs to outlive buffering until this
+            // drained/live classification runs; drop it so it cannot leak.
+            if (wasBackgroundTask) {
+              yield* clearOpaqueBackgroundTaskReplayTombstone(
+                liveQuery.nativeThreadId,
+                message.task_id,
+              );
+            }
+          }
+
+          for (const toolUse of claudeToolUseBlocksFromAssistantMessage(message)) {
+            if (toolUse.name === "Agent") {
+              continue;
+            }
+            const nativeToolInput = claudeNativeToolInputFromUnknown(toolUse.input);
+            if (toolUse.name === "TodoWrite" && parentToolUseIdFromSdkMessage(message) === null) {
+              yield* emitClaudePlanProjection({
+                context,
+                nativeItemId: toolUse.id,
+                kind: "todo_list",
+                steps: claudeTodoSteps(nativeToolInput),
+              }).pipe(Effect.orDie);
+            }
+            yield* ensureToolCallStarted({
+              context,
+              nativeItemId: toolUse.id,
+              toolName: toolUse.name,
+              toolInput: nativeToolInput,
+              parentToolUseId: parentToolUseIdFromSdkMessage(message),
+            });
+          }
+
+          for (const { toolResult, output } of claudeToolResultEntriesFromMessage(message)) {
+            const subagent = context.subagentsByToolUseId.get(toolResult.tool_use_id);
+            // A resume task_started reuses the resuming tool call's
+            // tool_use_id (e.g. SendMessage), whose tool_result only
+            // acknowledges delivery. Only the Agent launch's tool_result may
+            // terminalize the subagent, and Agent tool_uses never enter
+            // toolCalls (they project as subagent rows instead).
+            if (subagent !== undefined && !context.toolCalls.has(toolResult.tool_use_id)) {
+              // A background Agent launch resolves its tool_use immediately
+              // with an async-launch ACK while the task keeps running; only
+              // the eventual task_notification terminalizes the subagent.
+              if (isClaudeSubagentAsyncLaunchAck(output)) {
+                continue;
+              }
+              const result = claudeSubagentResultText(output);
+              yield* updateClaudeSubagentNode({
+                context,
+                taskId: subagent.task.nativeTaskRef?.nativeId ?? String(subagent.task.id),
+                toolUseId: toolResult.tool_use_id,
+                ...(result.length === 0 ? {} : { result }),
+                status: isClaudeToolResultError(toolResult) ? "failed" : "completed",
+              });
+              continue;
+            }
+            const parentToolUseId = parentToolUseIdFromSdkMessage(message);
+            const toolCall =
+              context.toolCalls.get(toolResult.tool_use_id) ??
+              (yield* ensureToolCallStarted({
+                context,
+                nativeItemId: toolResult.tool_use_id,
+                toolName: toolNameFromClaudeToolResult(toolResult),
+                toolInput: EMPTY_CLAUDE_NATIVE_TOOL_INPUT,
+                parentToolUseId,
+              }));
+            const completedAt = yield* DateTime.now;
+            const artifacts = buildToolCallArtifacts({
+              context,
+              nativeItemId: toolCall.nativeItemId,
+              toolName: toolCall.toolName,
+              classification: toolCall.classification,
+              toolInput: toolCall.input,
+              threadId: toolCall.threadId,
+              runId: toolCall.runId,
+              rootNodeId: toolCall.rootNodeId,
+              parentNodeId: toolCall.parentNodeId,
+              ordinal: toolCall.ordinal,
+              output,
+              status: isClaudeToolResultError(toolResult) ? "failed" : "completed",
+              startedAt: toolCall.startedAt,
+              updatedAt: completedAt,
+            });
+            yield* emitToolCallArtifacts(artifacts);
+            context.toolCalls.delete(toolCall.nativeItemId);
+          }
+
+          const assistantText = assistantTextFromSdkMessage(message);
+          if (assistantText !== null && assistantText.text.length > 0) {
+            yield* emitAssistantTextArtifacts({
+              context,
+              nativeItemId: assistantText.nativeItemId,
+              text: assistantText.text,
+            });
+            return;
+          }
+
+          // A zero-turn task-notification-origin result is almost always
+          // lifecycle debris, so it must not finalize a normal turn or supply
+          // fallback assistant text. Provider continuation turns still consume
+          // it when draining buffered wake messages.
+          //
+          // "Almost always" is the honest word: num_turns is a workload count,
+          // not a causal link to the prompt this turn is waiting on. A genuine
+          // wake that fails before any model turn also reports zero, and is
+          // dropped here, so that turn hangs until query exit. Narrowing the
+          // drop to zero-turn results only shrinks a pre-existing drop; closing
+          // the residue needs a correlation id on the result, which the wire
+          // does not carry today.
+          if (
+            isClaudeTaskNotificationOriginResult(message) &&
+            !isClaudeProviderContinuationTurn(context.input) &&
+            message.num_turns === 0
+          ) {
+            // Routine lifecycle noise, so debug rather than warning: interrupt
+            // recovery produces this every time.
+            yield* Effect.logDebug("orchestration-v2.claude-task-notification-result-dropped", {
+              providerTurnId: context.providerTurnId,
+              num_turns: message.num_turns,
+              stop_reason: message.stop_reason,
+              terminal_reason: message.terminal_reason,
+              uuid: message.uuid,
+              session_id: message.session_id,
+              createdBy: context.input.message.createdBy,
+              creationSource: context.input.message.creationSource,
+            });
+            return;
+          }
+
+          // The converse of the drop above, and the case actually worth
+          // watching: a positive-turn task-notification result settling a turn
+          // T3 did not mark as a continuation. That is the hang fix working,
+          // but it is also the shape a stale result would take if one ever
+          // carried model turns, which nothing on the wire lets us rule out.
+          if (
+            isClaudeTaskNotificationOriginResult(message) &&
+            !isClaudeProviderContinuationTurn(context.input)
+          ) {
+            yield* Effect.logInfo("orchestration-v2.claude-task-notification-result-accepted", {
+              providerTurnId: context.providerTurnId,
+              num_turns: message.num_turns,
+              stop_reason: message.stop_reason,
+              terminal_reason: message.terminal_reason,
+              uuid: message.uuid,
+              session_id: message.session_id,
+              createdBy: context.input.message.createdBy,
+              creationSource: context.input.message.creationSource,
+            });
+          }
+
+          // An is_error result's text is the error message; it belongs on the
+          // terminal-failure item, not on a synthetic assistant message.
+          const resultText =
+            message.type === "result" && message.subtype === "success" && message.is_error
+              ? null
+              : resultTextFromSdkMessage(message);
+          if (
+            context.assistant.emittedNativeItemIds.size === 0 &&
+            context.assistant.fallbackText.length === 0 &&
+            resultText !== null &&
+            resultText.text.length > 0
+          ) {
+            context.assistant.fallbackText = resultText.text;
+            context.assistant.fallbackNativeItemId = resultText.nativeItemId;
+          }
+
+          if (message.type === "result") {
+            const completedAt = yield* DateTime.now;
+            const interrupted = (yield* Ref.get(interruptedTurns)).has(context.providerTurnId);
+            const wasSteered = (yield* Ref.get(steeredTurns)).has(context.providerTurnId);
+            if (!interrupted && wasSteered && isClaudeActiveSteeringAbortResult(message)) {
+              return;
+            }
+            yield* Ref.update(steeredTurns, (current) => {
+              const next = new Set(current);
+              next.delete(context.providerTurnId);
+              return next;
+            });
+            const resultFailure = interrupted ? null : providerFailureFromResult(message);
+            yield* finalizeActiveTurn({
+              context,
+              status: interrupted ? "interrupted" : terminalStatusFromResult(message),
+              completedAt,
+              ...(resultFailure === null ? {} : { failure: resultFailure }),
+            });
+          }
+        });
+
+        const canUseToolEffect = Effect.fn("ClaudeAdapterV2.canUseTool")(function* (
+          toolName: Parameters<CanUseTool>[0],
+          toolInput: Parameters<CanUseTool>[1],
+          callbackOptions: Parameters<CanUseTool>[2],
+        ) {
+          const context = yield* Ref.get(activeTurn);
+          if (context === null) {
+            return {
+              behavior: "deny",
+              message: "Claude V2 adapter has no active turn for this tool request.",
+              toolUseID: callbackOptions.toolUseID,
+            } satisfies PermissionResult;
+          }
+
+          const nativeRequestId = callbackOptions.toolUseID;
+          const nativeToolInput = claudeNativeToolInputFromRecord(toolInput);
+          if (toolName !== "Agent") {
+            yield* ensureToolCallStarted({
+              context,
+              nativeItemId: nativeRequestId,
+              toolName,
+              toolInput: nativeToolInput,
+              parentToolUseId: null,
+            });
+          }
+
+          if (toolName === "AskUserQuestion") {
+            const questions = claudeUserInputQuestions(nativeToolInput);
+            const artifacts = yield* buildApprovalRequestArtifacts({
+              context,
+              nativeItemId: nativeRequestId,
+              nativeRequestId,
+              requestKind: "user_input",
+              questions,
+            });
+            const answers = yield* Deferred.make<ProviderUserInputAnswers, never>();
+            yield* Ref.update(pendingRuntimeRequests, (current) => {
+              const updated = new Map(current);
+              updated.set(String(artifacts.request.id), {
+                type: "user_input",
+                requestId: artifacts.request.id,
+                answers,
+              });
+              return updated;
+            });
+            yield* Effect.all(
+              [
+                emitProviderEvent({
+                  type: "node.updated",
+                  driver: CLAUDE_PROVIDER,
+                  node: artifacts.node,
+                }),
+                emitProviderEvent({
+                  type: "runtime_request.updated",
+                  driver: CLAUDE_PROVIDER,
+                  runtimeRequest: artifacts.request,
+                }),
+                emitProviderEvent({
+                  type: "turn_item.updated",
+                  driver: CLAUDE_PROVIDER,
+                  turnItem: artifacts.turnItem,
+                }),
+              ],
+              { concurrency: 1 },
+            );
+            const resolvedAnswers = yield* awaitClaudeUserInputAnswers(
+              answers,
+              callbackOptions.signal,
+            ).pipe(
+              Effect.ensuring(
+                Ref.update(pendingRuntimeRequests, (current) => {
+                  const updated = new Map(current);
+                  updated.delete(String(artifacts.request.id));
+                  return updated;
+                }),
+              ),
+            );
+            return callbackOptions.signal.aborted
+              ? ({
+                  behavior: "deny",
+                  message: "User cancelled tool execution.",
+                } satisfies PermissionResult)
+              : ({
+                  behavior: "allow",
+                  updatedInput: {
+                    questions: toolInput.questions,
+                    answers: claudeSdkUserInputAnswers(resolvedAnswers),
+                  },
+                  toolUseID: callbackOptions.toolUseID,
+                } satisfies PermissionResult);
+          }
+
+          if (toolName === "ExitPlanMode") {
+            const markdown = claudeProposedPlan(nativeToolInput);
+            if (markdown !== null) {
+              yield* emitClaudePlanProjection({
+                context,
+                nativeItemId: nativeRequestId,
+                kind: "proposed_plan",
+                markdown,
+              });
+            }
+            return {
+              behavior: "deny",
+              message:
+                "The client captured your proposed plan. Stop here and wait for the user's feedback or implementation request in a later turn.",
+              toolUseID: callbackOptions.toolUseID,
+            } satisfies PermissionResult;
+          }
+
+          if (
+            !shouldInstallClaudePermissionCallback(
+              claudeRuntimeQueryPolicyForRuntimePolicy(context.input.runtimePolicy),
+            )
+          ) {
+            return {
+              behavior: "allow",
+              updatedInput: toolInput,
+              toolUseID: callbackOptions.toolUseID,
+            } satisfies PermissionResult;
+          }
+
+          const requestKind = providerRequestKindFromClaudeTool(toolName);
+          const prompt =
+            callbackOptions.title ??
+            callbackOptions.description ??
+            callbackOptions.decisionReason ??
+            summarizeClaudeToolRequest(toolName, nativeToolInput);
+          const artifacts = yield* buildApprovalRequestArtifacts({
+            context,
+            nativeItemId: nativeRequestId,
+            nativeRequestId,
+            requestKind,
+            prompt,
+          });
+          const decision = yield* Deferred.make<ProviderApprovalDecision, never>();
+          yield* Ref.update(pendingRuntimeRequests, (current) => {
+            const updated = new Map(current);
+            updated.set(String(artifacts.request.id), {
+              type: "approval",
+              requestId: artifacts.request.id,
+              requestKind,
+              decision,
+            });
+            return updated;
+          });
+          yield* Effect.all(
+            [
+              emitProviderEvent({
+                type: "node.updated",
+                driver: CLAUDE_PROVIDER,
+                node: artifacts.node,
+              }),
+              emitProviderEvent({
+                type: "runtime_request.updated",
+                driver: CLAUDE_PROVIDER,
+                runtimeRequest: artifacts.request,
+              }),
+              emitProviderEvent({
+                type: "turn_item.updated",
+                driver: CLAUDE_PROVIDER,
+                turnItem: artifacts.turnItem,
+              }),
+            ],
+            { concurrency: 1 },
+          );
+
+          const resolvedDecision = yield* awaitClaudeApprovalDecision(
+            decision,
+            callbackOptions.signal,
+          ).pipe(
+            Effect.ensuring(
+              Ref.update(pendingRuntimeRequests, (current) => {
+                const updated = new Map(current);
+                updated.delete(String(artifacts.request.id));
+                return updated;
+              }),
+            ),
+          );
+
+          return permissionResultFromDecision({
+            toolName,
+            decision: resolvedDecision,
+            toolInput,
+            toolUseID: callbackOptions.toolUseID,
+            ...(callbackOptions.suggestions === undefined
+              ? {}
+              : { suggestions: callbackOptions.suggestions }),
+          });
+        });
+
+        const canUseTool: CanUseTool = (toolName, toolInput, callbackOptions) =>
+          runPromise(canUseToolEffect(toolName, toolInput, callbackOptions));
+
+        const onUserDialog: NonNullable<ClaudeQueryOptions["onUserDialog"]> = (
+          request,
+          callbackOptions,
+        ) =>
+          runPromise(
+            Effect.gen(function* () {
+              if (request.dialogKind !== "resume_return") {
+                return { behavior: "cancelled" as const };
+              }
+              const ageMinutes =
+                typeof request.payload.sessionAgeMinutes === "number" &&
+                Number.isFinite(request.payload.sessionAgeMinutes)
+                  ? Math.max(0, Math.floor(request.payload.sessionAgeMinutes))
+                  : 0;
+              const estimatedTokens =
+                typeof request.payload.estimatedTokens === "number" &&
+                Number.isFinite(request.payload.estimatedTokens)
+                  ? Math.max(0, Math.floor(request.payload.estimatedTokens))
+                  : 0;
+              const question = formatClaudeResumeCompactionQuestion({
+                ageMinutes,
+                estimatedTokens,
+              });
+              const result = yield* canUseToolEffect(
+                "AskUserQuestion",
+                {
+                  questions: [
+                    {
+                      header: "Resume session",
+                      question,
+                      options: [
+                        {
+                          label: "Compact and continue",
+                          description: "Resume with a summary and use fewer tokens.",
+                        },
+                        {
+                          label: "Keep full history",
+                          description: "Resume without changing the conversation.",
+                        },
+                        {
+                          label: CLAUDE_RESUME_COMPACTION_NEVER_ANSWER,
+                          description: "Keep full history and skip future resume prompts.",
+                        },
+                      ],
+                      multiSelect: false,
+                    },
+                  ],
+                },
+                {
+                  signal: callbackOptions.signal,
+                  requestId: callbackOptions.requestId,
+                  toolUseID: request.toolUseID ?? callbackOptions.requestId,
+                },
+              );
+              if (result.behavior !== "allow") return { behavior: "cancelled" as const };
+              const answers =
+                result.updatedInput === undefined
+                  ? undefined
+                  : Reflect.get(result.updatedInput, "answers");
+              const selection =
+                typeof answers === "object" && answers !== null
+                  ? Reflect.get(answers, question)
+                  : undefined;
+              return {
+                behavior: "completed" as const,
+                result:
+                  selection === "Compact and continue"
+                    ? ("compact" as const)
+                    : selection === CLAUDE_RESUME_COMPACTION_NEVER_ANSWER
+                      ? ("never" as const)
+                      : ("continue" as const),
+              };
+            }),
+          );
+
+        const openQuery = Effect.fnUntraced(function* (
+          turnInput: ProviderAdapterV2TurnInput,
+          nativeThreadId: string,
+        ) {
+          const queryPolicy = claudeRuntimeQueryPolicyForRuntimePolicy(turnInput.runtimePolicy);
+          const mcpOverrides = claudeMcpQueryOverrides({
+            threadId: turnInput.threadId,
+            readOnlySandbox:
+              sandboxPolicyKindForClaudeRuntimePolicy(turnInput.runtimePolicy) === "readOnly",
+            ...(queryPolicy.allowedTools === undefined
+              ? {}
+              : { allowedTools: queryPolicy.allowedTools }),
+          });
+          const queryPolicyKey = claudeEffectiveQueryPolicyKey(queryPolicy, mcpOverrides);
+          const compiledSelection = compileClaudeModelSelection(turnInput.modelSelection);
+          const resumeSessionAt = yield* getNativeConversationHeadId(turnInput.providerThread);
+          const existing = yield* Ref.get(queryContext);
+          if (
+            existing !== null &&
+            existing.nativeThreadId === nativeThreadId &&
+            existing.queryPolicyKey === queryPolicyKey &&
+            existing.selectionKey === compiledSelection.queryIdentity
+          ) {
+            return existing;
+          }
+
+          // openQuery owns one live process. Closing it for another native
+          // thread kills that sibling's CLI; it can never emit a roster clear,
+          // so drop its process-scoped Waiting/wake state immediately. Closing
+          // for the same native thread leaves a non-authoritative roster until
+          // the replacement open succeeds or fails below.
+          const closedExistingNativeThreadId = existing !== null ? existing.nativeThreadId : null;
+          if (existing !== null) {
+            yield* existing.query.close.pipe(Effect.ignore);
+            if (existing.nativeThreadId !== nativeThreadId) {
+              yield* clearWakeStateForNativeThread(existing.nativeThreadId);
+              yield* resetBackgroundTaskStateForNativeThreadProcess(existing.nativeThreadId, {
+                status: "idle",
+              });
+            }
+          }
+
+          const openedWithResume = (yield* Ref.get(openedNativeThreads)).has(nativeThreadId);
+          // openedNativeThreads is per session instance and is lost when the
+          // provider session is idle-released. A prior persisted provider turn
+          // proves the native session already exists, so the query must resume
+          // it; reopening with a fixed session id makes the CLI fail fast with
+          // "Session ID ... is already in use".
+          const hasPersistedProviderTurn = turnInput.providerTurnOrdinal > 1;
+          const shouldResume =
+            resumeSessionAt !== undefined || openedWithResume || hasPersistedProviderTurn;
+          const querySession = yield* queryRunner
+            .open({
+              threadId: turnInput.threadId,
+              providerSessionId: input.providerSessionId,
+              options: makeClaudeQueryOptions({
+                modelSelection: turnInput.modelSelection,
+                nativeThreadId,
+                resume: shouldResume,
+                ...(resumeSessionAt === undefined ? {} : { resumeSessionAt }),
+                cwd: turnInput.runtimePolicy.cwd,
+                attachmentsDir,
+                settings: adapterOptions.settings,
+                environment: adapterOptions.environment,
+                tools: queryPolicy.tools ?? CLAUDE_CODE_PRESET_TOOLS,
+                ...mcpOverrides,
+                permissionMode: queryPolicy.permissionMode,
+                ...(queryPolicy.allowDangerouslySkipPermissions === undefined
+                  ? {}
+                  : {
+                      allowDangerouslySkipPermissions: queryPolicy.allowDangerouslySkipPermissions,
+                    }),
+                canUseTool,
+                onUserDialog,
+                supportedDialogKinds: ["resume_return"],
+              }),
+            })
+            .pipe(
+              Effect.tapError(() =>
+                // Same-native-thread replacement: the old process is already
+                // dead, so its process-scoped roster is not authoritative.
+                // First-ever failed open (no prior live query) must not invent
+                // native-session reset events.
+                closedExistingNativeThreadId === nativeThreadId
+                  ? Effect.gen(function* () {
+                      yield* clearWakeStateForNativeThread(nativeThreadId);
+                      yield* resetBackgroundTaskStateForNativeThreadProcess(nativeThreadId, {
+                        status: "idle",
+                      });
+                    })
+                  : Effect.void,
+              ),
+            );
+          // Marked only after a successful open: a failed create must not
+          // leave the runtime believing the native session exists, or the
+          // retry would resume a session that was never created.
+          yield* Ref.update(openedNativeThreads, (current) => {
+            if (current.has(nativeThreadId)) {
+              return current;
+            }
+            const updated = new Set(current);
+            updated.add(nativeThreadId);
+            return updated;
+          });
+          // Level is per CLI process: reset Waiting roster and wake
+          // eligibility whenever this native thread's process starts or is
+          // replaced. Membership repopulates on the next snapshot/edge.
+          // openQuery only runs from startTurn after ProviderTurnStartService
+          // marked the provider thread active, and before activeTurn is set.
+          // Buffered local_bash task_notification classification is preserved
+          // across this reset (see resetBackgroundTaskStateForNativeThreadProcess).
+          yield* resetBackgroundTaskStateForNativeThreadProcess(nativeThreadId, {
+            status: "active",
+          });
+          const closed = yield* Deferred.make<void, never>();
+          const context: ClaudeLiveQueryContext = {
+            nativeThreadId,
+            query: querySession,
+            queryPolicyKey,
+            selectionKey: compiledSelection.queryIdentity,
+            closed,
+          };
+          yield* Ref.set(queryContext, context);
+          yield* querySession.messages.pipe(
+            Stream.runForEach((message) => handleSdkMessage({ query: querySession, message })),
+            Effect.exit,
+            Effect.flatMap(
+              Effect.fnUntraced(function* (exit: ClaudeQueryStreamExit) {
+                const ownsLiveQuery = yield* Ref.modify(queryContext, (current) =>
+                  current?.query === querySession ? [true, null] : [false, current],
+                );
+                if (ownsLiveQuery) {
+                  yield* finalizeActiveTurnAfterQueryExit(
+                    exit._tag === "Failure" ? exit.cause : undefined,
+                  );
+                }
+              }),
+            ),
+            Effect.ensuring(Deferred.succeed(closed, undefined)),
+            Effect.forkIn(sessionScope),
+          );
+          return context;
+        });
+
+        const startTurn = Effect.fn("ClaudeAdapterV2.startTurn")(
+          function* (turnInput: ProviderAdapterV2TurnInput) {
+            const startedAt = yield* DateTime.now;
+            const nativeThreadId = yield* getNativeThreadId(turnInput.providerThread);
+            const nativeTurnId = `turn:${turnInput.attemptId}`;
+            const providerTurnId = idAllocator.derive.providerTurn({
+              driver: CLAUDE_PROVIDER,
+              nativeTurnId,
+            });
+            const providerTurnOrdinal = turnInput.providerTurnOrdinal;
+            const currentTurn = yield* Ref.get(activeTurn);
+            if (currentTurn !== null) {
+              return yield* new ProviderAdapterProtocolError({
+                driver: CLAUDE_PROVIDER,
+                detail: `Claude provider turn ${currentTurn.providerTurnId} is still active.`,
+              });
+            }
+            yield* Ref.update(lastTurnRouteByNativeThread, (current) => {
+              const updated = new Map(current);
+              updated.set(nativeThreadId, {
+                threadId: turnInput.threadId,
+                providerThreadId: turnInput.providerThread.id,
+              });
+              return updated;
+            });
+            yield* rememberProviderThread(turnInput.providerThread);
+            const context: ActiveClaudeTurnContext = {
+              input: turnInput,
+              nativeTurnId,
+              nativeMessageCursor: null,
+              providerTurnId,
+              providerTurnOrdinal,
+              startedAt,
+              assistant: {
+                fallbackText: "",
+                fallbackNativeItemId: `assistant:${turnInput.runId}`,
+                emittedNativeItemIds: new Set(),
+              },
+              toolCalls: new Map(),
+              ignoredTaskIds: new Set(),
+              subagentsByTaskId: new Map(),
+              subagentsByToolUseId: new Map(),
+              subagentNodesByTaskId: new Map(),
+              pendingSubagentModelsByToolUseId: new Map(),
+            };
+            // Continuation turns attach to the wake output the CLI already
+            // produced instead of prompting it again: drain the buffered wake
+            // messages into this turn and let any still-streaming messages
+            // follow live. The continuation prompt text never reaches the CLI.
+            const isContinuationTurn = isClaudeProviderContinuationTurn(turnInput);
+            const userMessage = isContinuationTurn
+              ? null
+              : yield* makeClaudeUserMessageWithAttachments({
+                  text: applyClaudePromptEffortPrefix(
+                    turnInput.message.text,
+                    compileClaudeModelSelection(turnInput.modelSelection).promptEffort,
+                  ),
+                  attachments: turnInput.message.attachments,
+                  attachmentsDir,
+                  fileSystem,
+                });
+            const querySession = yield* openQuery(turnInput, nativeThreadId);
+            yield* Ref.set(activeTurn, context);
+            yield* emitProviderEvent({
+              type: "provider_turn.updated",
+              driver: CLAUDE_PROVIDER,
+              providerTurn: providerTurnPayload({
+                context,
+                status: "running",
+                completedAt: null,
+              }),
+            });
+            if (userMessage !== null) {
+              // A user turn that races a wake leaves the buffer alone: the
+              // continuation run the worker queued behind this run drains it
+              // afterwards with correct attribution.
+              yield* querySession.query.offer(userMessage);
+              return;
+            }
+            const drained = yield* Ref.modify(wakeBuffers, (current) => {
+              const entry = current.get(nativeThreadId);
+              if (entry === undefined) {
+                return [[] as ReadonlyArray<SDKMessage>, current] as const;
+              }
+              const updated = new Map(current);
+              updated.delete(nativeThreadId);
+              return [entry.messages, updated] as const;
+            });
+            yield* Ref.update(requestedContinuations, (current) => {
+              const updated = new Set(current);
+              updated.delete(nativeThreadId);
+              return updated;
+            });
+            if (drained.length === 0) {
+              // Spurious continuation (buffer already lost with a recycled
+              // session, or a duplicate request): settle immediately instead
+              // of leaving a run waiting on a prompt that was never sent.
+              const completedAt = yield* DateTime.now;
+              yield* finalizeActiveTurn({ context, status: "completed", completedAt });
+              return;
+            }
+            // Replay any result message last: a result finalizes the turn, and
+            // replaying it before the rest would drop them back into the wake
+            // buffer and request another continuation.
+            const resultMessages = drained.filter((entry) => entry.type === "result");
+            const opaqueReplayTombstones = taskIdSetForNativeThread(
+              yield* Ref.get(opaqueBackgroundTaskReplayTombstonesByNativeThread),
+              nativeThreadId,
+            );
+            const hasOpaqueTaskNotification = drained.some(
+              (entry) =>
+                entry.type === "system" &&
+                entry.subtype === "task_notification" &&
+                opaqueReplayTombstones.has(entry.task_id),
+            );
+            for (const entry of drained) {
+              if (entry.type !== "result") {
+                yield* handleSdkMessage({ query: querySession.query, message: entry });
+              }
+            }
+            const lastResult = resultMessages.at(-1);
+            if (lastResult !== undefined) {
+              yield* handleSdkMessage({ query: querySession.query, message: lastResult });
+              return;
+            }
+            const hasNativeWakeFrame = drained.some(
+              (entry) => entry.type === "user" || entry.type === "assistant",
+            );
+            if (hasOpaqueTaskNotification && !hasNativeWakeFrame) {
+              const completedAt = yield* DateTime.now;
+              yield* finalizeActiveTurn({ context, status: "completed", completedAt });
+            }
+          },
+          (effect, turnInput) =>
+            effect.pipe(
+              Effect.mapError(
+                (cause) =>
+                  new ProviderAdapterTurnStartError({
+                    driver: CLAUDE_PROVIDER,
+                    threadId: turnInput.threadId,
+                    providerThreadId: turnInput.providerThread.id,
+                    runId: turnInput.runId,
+                    cause,
+                  }),
+              ),
+            ),
+        );
+
+        const interruptTurn = Effect.fn("ClaudeAdapterV2.interruptTurn")(
+          function* (turnInput: ProviderAdapterV2InterruptInput) {
+            const existing = yield* Ref.get(queryContext);
+            if (existing === null) {
+              return yield* new ProviderAdapterProtocolError({
+                driver: CLAUDE_PROVIDER,
+                detail: `Claude provider thread ${turnInput.providerThread.id} has no live query.`,
+              });
+            }
+            const currentTurn = yield* Ref.get(activeTurn);
+            if (currentTurn?.providerTurnId !== turnInput.providerTurnId) {
+              return yield* new ProviderAdapterProtocolError({
+                driver: CLAUDE_PROVIDER,
+                detail: `Claude provider turn ${turnInput.providerTurnId} is not the active turn.`,
+              });
+            }
+            yield* Ref.update(interruptedTurns, (current) => {
+              const next = new Set(current);
+              next.add(turnInput.providerTurnId);
+              return next;
+            });
+            yield* existing.query.interrupt;
+            yield* existing.query.close.pipe(Effect.ignore);
+            const closed = yield* Deferred.await(existing.closed).pipe(
+              Effect.timeoutOption("10 seconds"),
+            );
+            if (Option.isSome(closed)) {
+              return;
+            }
+
+            const completedAt = yield* DateTime.now;
+            yield* Effect.logWarning("orchestration-v2.claude-query-interrupt-timeout", {
+              providerSessionId: input.providerSessionId,
+              providerThreadId: turnInput.providerThread.id,
+              providerTurnId: turnInput.providerTurnId,
+            });
+            yield* Ref.update(queryContext, (current) =>
+              current?.query === existing.query ? null : current,
+            );
+            yield* finalizeActiveTurn({
+              context: currentTurn,
+              status: "interrupted",
+              completedAt,
+            });
+            yield* Deferred.succeed(existing.closed, undefined);
+          },
+          (effect, turnInput) =>
+            effect.pipe(
+              Effect.mapError(
+                (cause) =>
+                  new ProviderAdapterInterruptError({
+                    driver: CLAUDE_PROVIDER,
+                    providerThreadId: turnInput.providerThread.id,
+                    providerTurnId: turnInput.providerTurnId,
+                    cause,
+                  }),
+              ),
+            ),
+        );
+
+        const steerTurn = Effect.fn("ClaudeAdapterV2.steerTurn")(
+          function* (turnInput: ProviderAdapterV2SteerInput) {
+            const existing = yield* Ref.get(queryContext);
+            if (existing === null) {
+              return yield* new ProviderAdapterProtocolError({
+                driver: CLAUDE_PROVIDER,
+                detail: `Claude provider thread ${turnInput.providerThread.id} has no live query.`,
+              });
+            }
+            const currentTurn = yield* Ref.get(activeTurn);
+            if (currentTurn?.providerTurnId !== turnInput.providerTurnId) {
+              return yield* new ProviderAdapterProtocolError({
+                driver: CLAUDE_PROVIDER,
+                detail: `Claude provider turn ${turnInput.providerTurnId} is not the active turn.`,
+              });
+            }
+            const userMessage = yield* makeClaudeUserMessageWithAttachments({
+              text: applyClaudePromptEffortPrefix(
+                turnInput.message.text,
+                compileClaudeModelSelection(currentTurn.input.modelSelection).promptEffort,
+              ),
+              attachments: turnInput.message.attachments,
+              priority: "now",
+              attachmentsDir,
+              fileSystem,
+            });
+            yield* Ref.update(steeredTurns, (current) => {
+              const next = new Set(current);
+              next.add(turnInput.providerTurnId);
+              return next;
+            });
+            yield* existing.query.offer(userMessage);
+          },
+          (effect, turnInput) =>
+            effect.pipe(
+              Effect.mapError(
+                (cause) =>
+                  new ProviderAdapterSteerRunError({
+                    driver: CLAUDE_PROVIDER,
+                    providerThreadId: turnInput.providerThread.id,
+                    providerTurnId: turnInput.providerTurnId,
+                    cause,
+                  }),
+              ),
+            ),
+        );
+
+        const closeSession = Effect.fnUntraced(function* () {
+          const existing = yield* Ref.get(queryContext);
+          if (existing !== null) {
+            yield* existing.query.close.pipe(Effect.ignore);
+          }
+          yield* Effect.yieldNow;
+          yield* queryRunner.assertComplete.pipe(
+            Effect.catchCause((cause) =>
+              Effect.logWarning("orchestration-v2.claude-query-runner-incomplete", {
+                providerSessionId: input.providerSessionId,
+                cause,
+              }),
+            ),
+          );
+        });
+
+        const closeLiveQueryForNativeThread = Effect.fnUntraced(function* (nativeThreadId: string) {
+          const existing = yield* Ref.get(queryContext);
+          if (existing === null || existing.nativeThreadId !== nativeThreadId) {
+            return;
+          }
+
+          yield* existing.query.close.pipe(Effect.ignore);
+          const closed = yield* Deferred.await(existing.closed).pipe(
+            Effect.timeoutOption("10 seconds"),
+          );
+          if (Option.isSome(closed)) {
+            return;
+          }
+
+          yield* Effect.logWarning("orchestration-v2.claude-query-close-timeout-before-fork", {
+            providerSessionId: input.providerSessionId,
+            nativeThreadId,
+          });
+          yield* Ref.update(queryContext, (current) =>
+            current?.query === existing.query ? null : current,
+          );
+          yield* Deferred.succeed(existing.closed, undefined);
+        });
+        yield* Effect.addFinalizer(() => closeSession());
+
+        const runtime: ProviderAdapterV2SessionRuntime = {
+          instanceId: adapterOptions.instanceId,
+          driver: CLAUDE_PROVIDER,
+          providerSessionId: input.providerSessionId,
+          providerSession: session,
+          events: Stream.fromEffectRepeat(Queue.take(events)),
+          hasPendingBackgroundWork: Effect.gen(function* () {
+            // Session capability: any native thread with pending work pins idle.
+            for (const roster of (yield* Ref.get(pendingBackgroundTasksByNativeThread)).values()) {
+              if (roster.size > 0) {
+                return true;
+              }
+            }
+            for (const subagent of (yield* Ref.get(sessionSubagentsByTaskId)).values()) {
+              if (subagent.task.status === "running") {
+                return true;
+              }
+            }
+            const buffers = yield* Ref.get(wakeBuffers);
+            for (const entry of buffers.values()) {
+              if (
+                entry.messages.some(
+                  (message) =>
+                    message.type === "user" ||
+                    message.type === "assistant" ||
+                    message.type === "result",
+                )
+              ) {
+                return true;
+              }
+            }
+            return false;
+          }),
+          hasPendingBackgroundWorkForThread: (providerThread) =>
+            Effect.gen(function* () {
+              const nativeThreadId = providerThread.nativeThreadRef?.nativeId;
+              if (nativeThreadId === undefined || nativeThreadId === null) {
+                return false;
+              }
+              // Root-run stop gate: only this native thread's roster. Session
+              // subagents and wake buffers stay on the session-wide probe.
+              return (
+                rosterForNativeThread(
+                  yield* Ref.get(pendingBackgroundTasksByNativeThread),
+                  nativeThreadId,
+                ).size > 0
+              );
+            }),
+          ensureThread: Effect.fn("ClaudeAdapterV2.ensureThread")(
+            function* (threadInput: ProviderAdapterV2EnsureThreadInput) {
+              const createdAt = yield* DateTime.now;
+              const nativeThreadId = yield* queryRunner.allocateSessionId;
+              return makeProviderThread({
+                idAllocator,
+                providerInstanceId: adapterOptions.instanceId,
+                appThreadId: threadInput.threadId,
+                providerSessionId: input.providerSessionId,
+                nativeThreadId,
+                now: createdAt,
+              });
+            },
+            (effect, threadInput) =>
+              effect.pipe(
+                Effect.mapError(
+                  (cause) =>
+                    new ProviderAdapterEnsureThreadError({
+                      driver: CLAUDE_PROVIDER,
+                      threadId: threadInput.threadId,
+                      cause,
+                    }),
+                ),
+              ),
+          ),
+          resumeThread: Effect.fn("ClaudeAdapterV2.resumeThread")(
+            function* (threadInput: { readonly providerThread: OrchestrationV2ProviderThread }) {
+              const updatedAt = yield* DateTime.now;
+              return {
+                ...threadInput.providerThread,
+                providerSessionId: input.providerSessionId,
+                status: "idle" as const,
+                updatedAt,
+              };
+            },
+            (effect, threadInput) =>
+              effect.pipe(
+                Effect.mapError(
+                  (cause) =>
+                    new ProviderAdapterResumeThreadError({
+                      driver: CLAUDE_PROVIDER,
+                      providerSessionId: input.providerSessionId,
+                      providerThreadId: threadInput.providerThread.id,
+                      cause,
+                    }),
+                ),
+              ),
+          ),
+          startTurn,
+          steerTurn,
+          interruptTurn,
+          respondToRuntimeRequest: Effect.fn("ClaudeAdapterV2.respondToRuntimeRequest")(
+            function* (requestInput) {
+              const pending = (yield* Ref.get(pendingRuntimeRequests)).get(
+                String(requestInput.requestId),
+              );
+              if (pending === undefined) {
+                return yield* new ProviderAdapterRuntimeRequestResponseError({
+                  driver: CLAUDE_PROVIDER,
+                  requestId: requestInput.requestId,
+                  cause: new ProviderAdapterProtocolError({
+                    driver: CLAUDE_PROVIDER,
+                    detail: `No pending Claude runtime request ${requestInput.requestId}.`,
+                  }),
+                });
+              }
+              if (pending.type === "user_input") {
+                yield* Deferred.succeed(pending.answers, requestInput.answers ?? {});
+                return;
+              }
+              if (requestInput.decision === undefined) {
+                return yield* new ProviderAdapterRuntimeRequestResponseError({
+                  driver: CLAUDE_PROVIDER,
+                  requestId: requestInput.requestId,
+                  cause: new ProviderAdapterProtocolError({
+                    driver: CLAUDE_PROVIDER,
+                    detail: `Claude ${pending.requestKind} request ${requestInput.requestId} requires an approval decision.`,
+                  }),
+                });
+              }
+              yield* Deferred.succeed(pending.decision, requestInput.decision);
+            },
+            (effect, requestInput) =>
+              effect.pipe(
+                Effect.mapError((cause) =>
+                  isProviderAdapterRuntimeRequestResponseError(cause)
+                    ? cause
+                    : new ProviderAdapterRuntimeRequestResponseError({
+                        driver: CLAUDE_PROVIDER,
+                        requestId: requestInput.requestId,
+                        cause,
+                      }),
+                ),
+              ),
+          ),
+          readThreadSnapshot: (snapshotInput) =>
+            Effect.fail(
+              new ProviderAdapterReadThreadSnapshotError({
+                driver: CLAUDE_PROVIDER,
+                providerThreadId: snapshotInput.providerThread.id,
+                cause: "Claude V2 adapter does not implement snapshots.",
+              }),
+            ),
+          rollbackThread: Effect.fn("ClaudeAdapterV2.rollbackThread")(
+            function* (rollbackInput) {
+              const currentTurn = yield* Ref.get(activeTurn);
+              if (currentTurn !== null) {
+                return yield* new ProviderAdapterProtocolError({
+                  driver: CLAUDE_PROVIDER,
+                  detail: `Cannot roll back Claude provider thread ${rollbackInput.providerThread.id} while provider turn ${currentTurn.providerTurnId} is active.`,
+                });
+              }
+
+              const nativeThreadId = yield* getNativeThreadId(rollbackInput.providerThread);
+              yield* closeLiveQueryForNativeThread(nativeThreadId);
+              const now = yield* DateTime.now;
+
+              if (rollbackInput.target.type === "thread_start") {
+                const resetNativeThreadId = yield* queryRunner.allocateSessionId;
+                return {
+                  providerThread: {
+                    ...makeProviderThread({
+                      idAllocator,
+                      providerInstanceId: adapterOptions.instanceId,
+                      appThreadId: rollbackInput.providerThread.appThreadId,
+                      ...(rollbackInput.providerThread.ownerNodeId === null
+                        ? {}
+                        : { ownerNodeId: rollbackInput.providerThread.ownerNodeId }),
+                      providerSessionId: input.providerSessionId,
+                      nativeThreadId: resetNativeThreadId,
+                      ...(rollbackInput.providerThread.forkedFrom === null
+                        ? {}
+                        : { forkedFrom: rollbackInput.providerThread.forkedFrom }),
+                      now,
+                    }),
+                    handoffIds: rollbackInput.providerThread.handoffIds,
+                  },
+                  providerTurns: [],
+                  messages: [],
+                  runtimeRequests: [],
+                };
+              }
+
+              const resumeSessionAt = yield* resolveClaudeRollbackResumeSessionAt(rollbackInput);
+              return {
+                providerThread: {
+                  ...rollbackInput.providerThread,
+                  providerSessionId: input.providerSessionId,
+                  nativeConversationHeadRef:
+                    resumeSessionAt === null
+                      ? null
+                      : {
+                          driver: CLAUDE_PROVIDER,
+                          nativeId: resumeSessionAt,
+                          strength: "weak" as const,
+                        },
+                  status: "idle" as const,
+                  lastRunOrdinal: rollbackInput.target.appRunOrdinal,
+                  updatedAt: now,
+                },
+                providerTurns: [],
+                messages: [],
+                runtimeRequests: [],
+              };
+            },
+            (effect, rollbackInput) =>
+              effect.pipe(
+                Effect.mapError((cause) =>
+                  isProviderAdapterRollbackThreadError(cause)
+                    ? cause
+                    : new ProviderAdapterRollbackThreadError({
+                        driver: CLAUDE_PROVIDER,
+                        providerThreadId: rollbackInput.providerThread.id,
+                        cause,
+                      }),
+                ),
+              ),
+          ),
+          forkThread: Effect.fn("ClaudeAdapterV2.forkThread")(
+            function* (forkInput) {
+              const currentTurn = yield* Ref.get(activeTurn);
+              if (currentTurn !== null) {
+                return yield* new ProviderAdapterProtocolError({
+                  driver: CLAUDE_PROVIDER,
+                  detail: `Cannot fork Claude provider thread ${forkInput.sourceProviderThread.id} while provider turn ${currentTurn.providerTurnId} is active.`,
+                });
+              }
+
+              const sourceNativeThreadId = yield* getNativeThreadId(forkInput.sourceProviderThread);
+              yield* closeLiveQueryForNativeThread(sourceNativeThreadId);
+              const upToMessageId = yield* resolveClaudeForkUpToMessageId(forkInput);
+              const forkOptions: ForkSessionOptions = {
+                ...(input.runtimePolicy.cwd === null ? {} : { dir: input.runtimePolicy.cwd }),
+                ...(upToMessageId === undefined ? {} : { upToMessageId }),
+              };
+              const forked = yield* queryRunner.forkSession({
+                sessionId: sourceNativeThreadId,
+                options: forkOptions,
+                threadId: forkInput.targetThreadId,
+                providerSessionId: input.providerSessionId,
+              });
+              yield* Ref.update(openedNativeThreads, (current) => {
+                const updated = new Set(current);
+                updated.add(forked.sessionId);
+                return updated;
+              });
+              const now = yield* DateTime.now;
+              return makeProviderThread({
+                idAllocator,
+                providerInstanceId: adapterOptions.instanceId,
+                appThreadId: forkInput.targetThreadId,
+                ownerNodeId: forkInput.ownerNodeId ?? null,
+                providerSessionId: input.providerSessionId,
+                nativeThreadId: forked.sessionId,
+                forkedFrom: {
+                  providerThreadId: forkInput.sourceProviderThread.id,
+                  ...(forkInput.providerTurnId === undefined
+                    ? {}
+                    : { providerTurnId: forkInput.providerTurnId }),
+                },
+                now,
+              });
+            },
+            (effect, forkInput) =>
+              effect.pipe(
+                Effect.mapError(
+                  (cause) =>
+                    new ProviderAdapterForkThreadError({
+                      driver: CLAUDE_PROVIDER,
+                      providerThreadId: forkInput.sourceProviderThread.id,
+                      cause,
+                    }),
+                ),
+              ),
+          ),
+        };
+
+        return runtime;
+      },
+      (effect, input) =>
+        effect.pipe(
+          Effect.mapError(
+            (cause) =>
+              new ProviderAdapterOpenSessionError({
+                driver: CLAUDE_PROVIDER,
+                providerSessionId: input.providerSessionId,
+                cause,
+              }),
+          ),
+        ),
+    ),
+  });
+}
+
+export type ClaudeAdapterV2DriverEnv =
+  | ClaudeAgentSdkQueryRunner
+  | FileSystem.FileSystem
+  | IdAllocatorV2
+  | Path.Path
+  | ServerConfig;
+
+export const ClaudeAdapterV2Driver: ProviderAdapterDriver<
+  ClaudeSettings,
+  ClaudeAdapterV2DriverEnv
+> = {
+  driverKind: CLAUDE_DRIVER_KIND,
+  configSchema: ClaudeSettings,
+  defaultConfig: (): ClaudeSettings => DEFAULT_CLAUDE_SETTINGS,
+  create: Effect.fn("ClaudeAdapterV2Driver.create")(
+    function* (input: ProviderAdapterDriverCreateInput<ClaudeSettings>) {
+      const { instanceId, environment, enabled, config } = input;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const hostEnvironment = yield* HostProcessEnvironment;
+      const idAllocator = yield* IdAllocatorV2;
+      const queryRunner = yield* ClaudeAgentSdkQueryRunner;
+      const serverConfig = yield* ServerConfig;
+      const continuationRequests = yield* ProviderContinuationRequests;
+      const baseEnvironment = mergeProviderInstanceEnvironment(environment, hostEnvironment);
+      const claudeEnvironment = yield* makeClaudeEnvironment(config, baseEnvironment);
+      return makeClaudeAdapterV2({
+        instanceId,
+        settings: { ...config, enabled },
+        environment: claudeEnvironment,
+        attachmentsDir: serverConfig.attachmentsDir,
+        fileSystem,
+        idAllocator,
+        queryRunner,
+        continuationRequests,
+      });
+    },
+    (effect, input) =>
+      effect.pipe(
+        Effect.mapError(
+          (cause) =>
+            new ProviderAdapterDriverCreateError({
+              driver: CLAUDE_DRIVER_KIND,
+              instanceId: input.instanceId,
+              detail: "Failed to create Claude Agent SDK adapter.",
+              cause,
+            }),
+        ),
+      ),
+  ),
+};
+
+const makeDefaultClaudeAdapterV2 = Effect.fn("ClaudeAdapterV2.layer")(function* () {
+  const fileSystem = yield* FileSystem.FileSystem;
+  const hostEnvironment = yield* HostProcessEnvironment;
+  const idAllocator = yield* IdAllocatorV2;
+  const queryRunner = yield* ClaudeAgentSdkQueryRunner;
+  const serverConfig = yield* ServerConfig;
+  const continuationRequests = yield* ProviderContinuationRequests;
+
+  return makeClaudeAdapterV2({
+    instanceId: CLAUDE_DEFAULT_INSTANCE_ID,
+    settings: DEFAULT_CLAUDE_SETTINGS,
+    environment: hostEnvironment,
+    attachmentsDir: serverConfig.attachmentsDir,
+    fileSystem,
+    idAllocator,
+    queryRunner,
+    continuationRequests,
+  });
+});
+
+export const layer: Layer.Layer<
+  ProviderAdapterV2,
+  never,
+  ClaudeAgentSdkQueryRunner | FileSystem.FileSystem | IdAllocatorV2 | ServerConfig
+> = Layer.effect(ProviderAdapterV2, makeDefaultClaudeAdapterV2());
diff --git a/apps/server/src/orchestration-v2/Adapters/CodexAdapterV2.test.ts b/apps/server/src/orchestration-v2/Adapters/CodexAdapterV2.test.ts
new file mode 100644
index 000000000000..f196fc1cbbae
--- /dev/null
+++ b/apps/server/src/orchestration-v2/Adapters/CodexAdapterV2.test.ts
@@ -0,0 +1,3644 @@
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import {
+  CheckpointId,
+  CodexSettings,
+  EnvironmentId,
+  MessageId,
+  type ModelSelection,
+  NodeId,
+  type OrchestrationV2AppThread,
+  type OrchestrationV2ProviderThread,
+  type OrchestrationV2ProviderTurn,
+  ProjectId,
+  ProviderInstanceId,
+  ProviderSessionId,
+  ProviderThreadId,
+  ProviderTurnId,
+  RunAttemptId,
+  RunId,
+  ThreadId,
+} from "@t3tools/contracts";
+import { assert, describe, it } from "@effect/vitest";
+import { HostProcessEnvironment, HostProcessPlatform } from "@t3tools/shared/hostProcess";
+import { SpawnExecutableResolution } from "@t3tools/shared/shell";
+import * as CodexClient from "effect-codex-app-server/client";
+import * as CodexReplay from "effect-codex-app-server/replay";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Fiber from "effect/Fiber";
+import * as Layer from "effect/Layer";
+import * as Ref from "effect/Ref";
+import * as Schema from "effect/Schema";
+import * as Stream from "effect/Stream";
+import { TestClock } from "effect/testing";
+import { ChildProcess } from "effect/unstable/process";
+
+import * as McpProviderSession from "../../mcp/McpProviderSession.ts";
+import type { EventNdjsonLogger } from "../../provider/Layers/EventNdjsonLogger.ts";
+import { layer as idAllocatorLayer, IdAllocatorV2 } from "../IdAllocator.ts";
+import {
+  ProviderAdapterOpenSessionError,
+  ProviderAdapterV2RuntimePolicy,
+  type ProviderAdapterV2Event,
+  type ProviderAdapterV2TurnInput,
+} from "../ProviderAdapter.ts";
+import type { ProviderContinuationRequest } from "../ProviderContinuationRequests.ts";
+import {
+  buildCodexTurnStartParams,
+  CODEX_DEFAULT_INSTANCE_ID,
+  CODEX_DRIVER_KIND,
+  codexBackgroundCommandDetail,
+  codexProviderTurnTokenUsage,
+  codexThreadRuntimeParams,
+  type CodexAgentMessageDeltaUpdate,
+  type CodexAppServerClientFactoryShape,
+  makeCodexAdapterV2,
+  makeCodexAgentMessageDeltaCoalescer,
+  makeCodexAppServerProtocolLogger,
+  makeCodexAppServerSpawnCommand,
+  projectCodexDynamicToolItem,
+  resolveCodexRollbackTurnCount,
+} from "./CodexAdapterV2.ts";
+import { makeReplayServerConfig } from "./CodexAdapterV2.testkit.ts";
+
+describe("CodexAdapterV2 context usage", () => {
+  it("uses the current context rather than cumulative processed tokens", () => {
+    const usage = codexProviderTurnTokenUsage(
+      {
+        total: {
+          totalTokens: 180_000,
+          inputTokens: 160_000,
+          cachedInputTokens: 20_000,
+          outputTokens: 20_000,
+          reasoningOutputTokens: 5_000,
+        },
+        last: {
+          totalTokens: 50_000,
+          inputTokens: 45_000,
+          cachedInputTokens: 10_000,
+          outputTokens: 5_000,
+          reasoningOutputTokens: 1_000,
+        },
+        modelContextWindow: 200_000,
+      },
+      "2026-08-29T00:00:00.000Z",
+    );
+
+    assert.deepEqual(usage, {
+      usedTokens: 50_000,
+      maxTokens: 200_000,
+      inputTokens: 45_000,
+      cachedInputTokens: 10_000,
+      outputTokens: 5_000,
+      reasoningOutputTokens: 1_000,
+      updatedAt: "2026-08-29T00:00:00.000Z",
+    });
+  });
+});
+
+describe("CodexAdapterV2 assistant message streaming", () => {
+  it.effect("makes accumulated assistant text visible after the bounded flush interval", () =>
+    Effect.gen(function* () {
+      const updates = yield* Ref.make<
+        ReadonlyArray<{
+          readonly turnId: string;
+          readonly itemId: string;
+          readonly text: string;
+          readonly completed: boolean;
+        }>
+      >([]);
+      const coalescer = yield* makeCodexAgentMessageDeltaCoalescer({
+        flushIntervalMs: 50,
+        emit: (update) => Ref.update(updates, (current) => [...current, update]),
+      });
+
+      yield* coalescer.append({ turnId: "turn-1", itemId: "message-1", delta: "partial" });
+      assert.deepEqual(yield* Ref.get(updates), []);
+      yield* Effect.yieldNow;
+      yield* TestClock.adjust("50 millis");
+      yield* Effect.yieldNow;
+
+      assert.deepEqual(yield* Ref.get(updates), [
+        {
+          turnId: "turn-1",
+          itemId: "message-1",
+          text: "partial",
+          completed: false,
+        },
+      ]);
+    }),
+  );
+
+  it.effect("coalesces multiple token deltas into one assistant update per interval", () =>
+    Effect.gen(function* () {
+      const updates = yield* Ref.make<ReadonlyArray<CodexAgentMessageDeltaUpdate>>([]);
+      const coalescer = yield* makeCodexAgentMessageDeltaCoalescer({
+        flushIntervalMs: 50,
+        emit: (update) => Ref.update(updates, (current) => [...current, update]),
+      });
+
+      yield* coalescer.append({ turnId: "turn-1", itemId: "message-1", delta: "one" });
+      yield* coalescer.append({ turnId: "turn-1", itemId: "message-1", delta: " two" });
+      yield* coalescer.append({ turnId: "turn-1", itemId: "message-1", delta: " three" });
+      yield* Effect.yieldNow;
+      yield* TestClock.adjust("50 millis");
+      yield* Effect.yieldNow;
+
+      assert.deepEqual(yield* Ref.get(updates), [
+        {
+          turnId: "turn-1",
+          itemId: "message-1",
+          text: "one two three",
+          completed: false,
+        },
+      ]);
+    }),
+  );
+
+  it.effect("flushes buffered text synchronously before item and turn completion", () =>
+    Effect.gen(function* () {
+      const updates = yield* Ref.make<ReadonlyArray<CodexAgentMessageDeltaUpdate>>([]);
+      const coalescer = yield* makeCodexAgentMessageDeltaCoalescer({
+        flushIntervalMs: 50,
+        emit: (update) => Ref.update(updates, (current) => [...current, update]),
+      });
+
+      yield* coalescer.append({ turnId: "turn-1", itemId: "message-1", delta: "item final" });
+      const completedText = yield* coalescer.complete({
+        turnId: "turn-1",
+        itemId: "message-1",
+      });
+      yield* coalescer.append({ turnId: "turn-1", itemId: "message-2", delta: "turn final" });
+      yield* coalescer.flushTurn("turn-1");
+
+      assert.equal(completedText, "item final");
+      assert.deepEqual(yield* Ref.get(updates), [
+        { turnId: "turn-1", itemId: "message-1", text: "item final", completed: true },
+        { turnId: "turn-1", itemId: "message-2", text: "turn final", completed: true },
+      ]);
+      yield* Effect.yieldNow;
+      yield* TestClock.adjust("50 millis");
+      yield* Effect.yieldNow;
+      assert.equal((yield* Ref.get(updates)).length, 2);
+    }),
+  );
+
+  it.effect("retains buffered text until completion updates are emitted", () =>
+    Effect.gen(function* () {
+      const updates = yield* Ref.make<ReadonlyArray<CodexAgentMessageDeltaUpdate>>([]);
+      const failNext = yield* Ref.make(true);
+      const coalescer = yield* makeCodexAgentMessageDeltaCoalescer({
+        flushIntervalMs: 50,
+        emit: (update) =>
+          Ref.getAndSet(failNext, false).pipe(
+            Effect.flatMap((shouldFail) =>
+              shouldFail
+                ? Effect.die("projection unavailable")
+                : Ref.update(updates, (current) => [...current, update]),
+            ),
+          ),
+      });
+
+      yield* coalescer.append({ turnId: "turn-1", itemId: "message-1", delta: "turn final" });
+      const failedFlush = yield* coalescer.flushTurn("turn-1").pipe(Effect.exit);
+      assert.equal(failedFlush._tag, "Failure");
+      yield* coalescer.flushTurn("turn-1");
+
+      yield* coalescer.append({ turnId: "turn-1", itemId: "message-2", delta: "item final" });
+      yield* Ref.set(failNext, true);
+      const failedComplete = yield* coalescer
+        .complete({ turnId: "turn-1", itemId: "message-2" })
+        .pipe(Effect.exit);
+      assert.equal(failedComplete._tag, "Failure");
+      const completedText = yield* coalescer.complete({
+        turnId: "turn-1",
+        itemId: "message-2",
+      });
+
+      assert.equal(completedText, "item final");
+      assert.deepEqual(yield* Ref.get(updates), [
+        { turnId: "turn-1", itemId: "message-1", text: "turn final", completed: true },
+        { turnId: "turn-1", itemId: "message-2", text: "item final", completed: true },
+      ]);
+    }),
+  );
+
+  it.effect("can discard an empty completion without emitting an assistant update", () =>
+    Effect.gen(function* () {
+      const updates = yield* Ref.make<ReadonlyArray<CodexAgentMessageDeltaUpdate>>([]);
+      const coalescer = yield* makeCodexAgentMessageDeltaCoalescer({
+        flushIntervalMs: 50,
+        emit: (update) => Ref.update(updates, (current) => [...current, update]),
+      });
+
+      yield* coalescer.append({ turnId: "turn-1", itemId: "message-1", delta: "" });
+      yield* Effect.yieldNow;
+      yield* TestClock.adjust("50 millis");
+      yield* Effect.yieldNow;
+      const completedText = yield* coalescer.complete({
+        turnId: "turn-1",
+        itemId: "message-1",
+        finalText: "",
+        emitEmpty: false,
+      });
+
+      assert.equal(completedText, "");
+      assert.deepEqual(yield* Ref.get(updates), []);
+
+      yield* coalescer.append({ turnId: "turn-1", itemId: "message-2", delta: "buffered" });
+      assert.equal(
+        yield* coalescer.complete({
+          turnId: "turn-1",
+          itemId: "message-2",
+          emitEmpty: false,
+        }),
+        "buffered",
+      );
+      assert.deepEqual(yield* Ref.get(updates), [
+        {
+          turnId: "turn-1",
+          itemId: "message-2",
+          text: "buffered",
+          completed: true,
+        },
+      ]);
+    }),
+  );
+
+  it.effect("treats explicit empty final text as authoritative over buffered deltas", () =>
+    Effect.gen(function* () {
+      const updates = yield* Ref.make<ReadonlyArray<CodexAgentMessageDeltaUpdate>>([]);
+      const coalescer = yield* makeCodexAgentMessageDeltaCoalescer({
+        flushIntervalMs: 50,
+        emit: (update) => Ref.update(updates, (current) => [...current, update]),
+      });
+
+      yield* coalescer.append({
+        turnId: "turn-1",
+        itemId: "message-1",
+        delta: "stale buffered text",
+      });
+      const completedText = yield* coalescer.complete({
+        turnId: "turn-1",
+        itemId: "message-1",
+        finalText: "",
+      });
+
+      assert.equal(completedText, "");
+      assert.deepEqual(yield* Ref.get(updates), [
+        {
+          turnId: "turn-1",
+          itemId: "message-1",
+          text: "",
+          completed: true,
+        },
+      ]);
+    }),
+  );
+});
+
+describe("CodexAdapterV2 runtime policy", () => {
+  it.effect("derives concrete Codex turn policies from every T3 runtime mode", () =>
+    Effect.gen(function* () {
+      const build = (
+        runtimeMode: "approval-required" | "auto-accept-edits" | "auto" | "full-access",
+      ) =>
+        buildCodexTurnStartParams({
+          nativeThreadId: `native-${runtimeMode}`,
+          codexInput: [{ type: "text", text: "test" }],
+          runtimePolicy: {
+            runtimeMode,
+            interactionMode: "default",
+            cwd: null,
+          },
+          modelSelection: {
+            instanceId: ProviderInstanceId.make("codex"),
+            model: "gpt-5.4",
+          },
+        });
+
+      const approvalRequired = yield* build("approval-required");
+      const autoAcceptEdits = yield* build("auto-accept-edits");
+      const auto = yield* build("auto");
+      const fullAccess = yield* build("full-access");
+
+      assert.equal(approvalRequired.approvalPolicy, "untrusted");
+      assert.equal(approvalRequired.approvalsReviewer, "user");
+      assert.equal(approvalRequired.sandboxPolicy?.type, "readOnly");
+      assert.equal(autoAcceptEdits.approvalPolicy, "on-request");
+      assert.equal(autoAcceptEdits.approvalsReviewer, "user");
+      assert.equal(autoAcceptEdits.sandboxPolicy?.type, "workspaceWrite");
+      assert.equal(auto.approvalPolicy, "on-request");
+      assert.equal(auto.approvalsReviewer, "auto_review");
+      assert.equal(auto.sandboxPolicy?.type, "workspaceWrite");
+      assert.equal(fullAccess.approvalPolicy, "never");
+      assert.equal(fullAccess.approvalsReviewer, "user");
+      assert.equal(fullAccess.sandboxPolicy?.type, "dangerFullAccess");
+    }),
+  );
+
+  it.effect("preserves explicit Codex turn policy overrides", () =>
+    Effect.gen(function* () {
+      const params = yield* buildCodexTurnStartParams({
+        nativeThreadId: "native-override",
+        codexInput: [{ type: "text", text: "test" }],
+        runtimePolicy: {
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          cwd: null,
+          approvalPolicy: "on-request",
+          sandboxPolicy: {
+            type: "readOnly",
+          },
+        },
+        modelSelection: {
+          instanceId: ProviderInstanceId.make("codex"),
+          model: "gpt-5.4",
+        },
+      });
+
+      assert.equal(params.approvalPolicy, "on-request");
+      assert.equal(params.sandboxPolicy?.type, "readOnly");
+    }),
+  );
+
+  it.effect("adds default-mode developer instructions when the T3 MCP server is attached", () =>
+    Effect.gen(function* () {
+      const params = yield* buildCodexTurnStartParams({
+        nativeThreadId: "native-orchestration-instructions",
+        codexInput: [{ type: "text", text: "delegate this task" }],
+        runtimePolicy: {
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          cwd: null,
+        },
+        modelSelection: {
+          instanceId: ProviderInstanceId.make("codex"),
+          model: "gpt-5.4",
+        },
+        hasT3Mcp: true,
+      });
+
+      assert.equal(params.collaborationMode?.mode, "default");
+      assert.include(
+        params.collaborationMode?.settings.developer_instructions ?? "",
+        "use `delegate_task`",
+      );
+      assert.include(
+        params.collaborationMode?.settings.developer_instructions ?? "",
+        "structured object, never as JSON text",
+      );
+    }),
+  );
+
+  it.effect("omits default-mode collaboration settings without the T3 MCP server", () =>
+    Effect.gen(function* () {
+      const params = yield* buildCodexTurnStartParams({
+        nativeThreadId: "native-default-without-t3-mcp",
+        codexInput: [{ type: "text", text: "implement this task" }],
+        runtimePolicy: {
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          cwd: null,
+        },
+        modelSelection: {
+          instanceId: ProviderInstanceId.make("codex"),
+          model: "gpt-5.4",
+        },
+        hasT3Mcp: false,
+      });
+
+      assert.isUndefined(params.collaborationMode);
+    }),
+  );
+
+  it.effect("adds T3 plan-mode developer instructions when the T3 MCP server is attached", () =>
+    Effect.gen(function* () {
+      const params = yield* buildCodexTurnStartParams({
+        nativeThreadId: "native-plan-with-t3-mcp",
+        codexInput: [{ type: "text", text: "plan this task" }],
+        runtimePolicy: {
+          runtimeMode: "full-access",
+          interactionMode: "plan",
+          cwd: null,
+        },
+        modelSelection: {
+          instanceId: ProviderInstanceId.make("codex"),
+          model: "gpt-5.4",
+        },
+        hasT3Mcp: true,
+      });
+
+      assert.equal(params.collaborationMode?.mode, "plan");
+      assert.include(
+        params.collaborationMode?.settings.developer_instructions ?? "",
+        "request_user_input",
+      );
+      assert.include(
+        params.collaborationMode?.settings.developer_instructions ?? "",
+        "preview_status",
+      );
+    }),
+  );
+
+  it.effect("keeps Codex in plan mode without referencing unavailable T3 MCP tools", () =>
+    Effect.gen(function* () {
+      const params = yield* buildCodexTurnStartParams({
+        nativeThreadId: "native-plan-without-t3-mcp",
+        codexInput: [{ type: "text", text: "plan this task" }],
+        runtimePolicy: {
+          runtimeMode: "full-access",
+          interactionMode: "plan",
+          cwd: null,
+        },
+        modelSelection: {
+          instanceId: ProviderInstanceId.make("codex"),
+          model: "gpt-5.4",
+        },
+        hasT3Mcp: false,
+      });
+
+      assert.equal(params.collaborationMode?.mode, "plan");
+      assert.notProperty(params.collaborationMode?.settings, "developer_instructions");
+    }),
+  );
+
+  it.effect("compiles per-turn Codex model options and cwd from their owning inputs", () =>
+    Effect.gen(function* () {
+      const params = yield* buildCodexTurnStartParams({
+        nativeThreadId: "native-model-options",
+        codexInput: [{ type: "text", text: "test" }],
+        runtimePolicy: {
+          runtimeMode: "full-access",
+          interactionMode: "plan",
+          cwd: "/workspace/model-options",
+          reasoningEffort: "low",
+        },
+        modelSelection: {
+          instanceId: ProviderInstanceId.make("codex"),
+          model: "gpt-5.4",
+          options: [
+            { id: "reasoningEffort", value: "xhigh" },
+            { id: "serviceTier", value: "priority" },
+          ],
+        },
+      });
+
+      assert.equal(params.model, "gpt-5.4");
+      assert.equal(params.effort, "xhigh");
+      assert.equal(params.serviceTier, "priority");
+      assert.equal(params.cwd, "/workspace/model-options");
+      assert.equal(params.collaborationMode?.settings.model, "gpt-5.4");
+      assert.equal(params.collaborationMode?.settings.reasoning_effort, "xhigh");
+    }),
+  );
+});
+
+describe("CodexAdapterV2 process spawning", () => {
+  it("injects cwd, model, and MCP authorization into thread-scoped params", () => {
+    const threadId = ThreadId.make("thread-codex-mcp");
+    McpProviderSession.setMcpProviderSession({
+      environmentId: EnvironmentId.make("environment-codex-mcp"),
+      threadId,
+      providerSessionId: "mcp-session-codex",
+      providerInstanceId: ProviderInstanceId.make("codex"),
+      endpoint: "http://127.0.0.1:43123/mcp",
+      authorizationHeader: "Bearer secret-codex-token",
+      browserToolsAvailable: true,
+    });
+
+    try {
+      assert.deepEqual(
+        codexThreadRuntimeParams({
+          threadId,
+          modelSelection: { model: "gpt-5.4" },
+          runtimePolicy: {
+            runtimeMode: "full-access",
+            interactionMode: "default",
+            cwd: "/workspace/thread-codex-mcp",
+          },
+        }),
+        {
+          cwd: "/workspace/thread-codex-mcp",
+          model: "gpt-5.4",
+          config: {
+            mcp_servers: {
+              "t3-code": {
+                url: "http://127.0.0.1:43123/mcp",
+                http_headers: {
+                  Authorization: "Bearer secret-codex-token",
+                },
+              },
+            },
+          },
+        },
+      );
+    } finally {
+      McpProviderSession.clearMcpProviderSession(threadId);
+    }
+  });
+
+  it.effect("resolves Windows command shims through the shared spawn policy", () =>
+    Effect.gen(function* () {
+      const command = yield* makeCodexAppServerSpawnCommand({
+        command: "codex",
+        args: ["app-server", "argument with spaces"],
+        cwd: "C:\\workspace",
+        env: { CUSTOM: "1" },
+        extendEnv: true,
+      });
+
+      assert.isTrue(ChildProcess.isStandardCommand(command));
+      if (!ChildProcess.isStandardCommand(command)) {
+        return;
+      }
+      assert.equal(command.command, '^"C:\\npm\\codex.cmd^"');
+      assert.deepEqual(command.args, ['^"app-server^"', '^"argument^ with^ spaces^"']);
+      assert.equal(command.options.shell, true);
+      assert.equal(command.options.cwd, "C:\\workspace");
+      assert.deepEqual(command.options.env, { CUSTOM: "1" });
+      assert.equal(command.options.extendEnv, true);
+    }).pipe(
+      Effect.provideService(HostProcessPlatform, "win32"),
+      Effect.provideService(HostProcessEnvironment, {
+        PATH: "C:\\Windows\\System32",
+        HOST_ONLY: "1",
+      }),
+      Effect.provideService(SpawnExecutableResolution, (_command, _platform, environment) => {
+        assert.equal(environment.HOST_ONLY, "1");
+        assert.equal(environment.CUSTOM, "1");
+        return "C:\\npm\\codex.cmd";
+      }),
+    ),
+  );
+
+  it.effect("uses direct execution for native executables", () =>
+    Effect.gen(function* () {
+      const command = yield* makeCodexAppServerSpawnCommand({
+        command: "codex.exe",
+        args: ["app-server"],
+      });
+
+      assert.isTrue(ChildProcess.isStandardCommand(command));
+      if (!ChildProcess.isStandardCommand(command)) {
+        return;
+      }
+      assert.equal(command.command, "C:\\bin\\codex.exe");
+      assert.deepEqual(command.args, ["app-server"]);
+      assert.equal(command.options.shell, false);
+    }).pipe(
+      Effect.provideService(HostProcessPlatform, "win32"),
+      Effect.provideService(SpawnExecutableResolution, () => "C:\\bin\\codex.exe"),
+    ),
+  );
+});
+
+describe("CodexAdapterV2 dynamic tool projection", () => {
+  it("preserves MCP arguments and prefers structured output", () => {
+    const projection = projectCodexDynamicToolItem({
+      type: "mcpToolCall",
+      id: "call-create-threads",
+      server: "t3-code",
+      tool: "create_threads",
+      status: "completed",
+      arguments: {
+        threads: [{ title: "Fixture child", prompt: "fixture child prompt" }],
+      },
+      result: {
+        content: [{ type: "text", text: '{"threads":[{"threadId":"thread:mcp:fixture:0"}]}' }],
+        structuredContent: {
+          threads: [{ threadId: "thread:mcp:fixture:0" }],
+        },
+      },
+    });
+
+    assert.deepEqual(projection, {
+      toolName: "t3-code.create_threads",
+      input: {
+        threads: [{ title: "Fixture child", prompt: "fixture child prompt" }],
+      },
+      output: {
+        threads: [{ threadId: "thread:mcp:fixture:0" }],
+      },
+      status: "completed",
+    });
+  });
+
+  it("preserves namespaced dynamic tool output", () => {
+    const projection = projectCodexDynamicToolItem({
+      type: "dynamicToolCall",
+      id: "call-dynamic",
+      namespace: "workspace",
+      tool: "inspect",
+      status: "failed",
+      arguments: { path: "package.json" },
+      contentItems: [{ type: "inputText", text: "inspection failed" }],
+      success: false,
+    });
+
+    assert.deepEqual(projection, {
+      toolName: "workspace.inspect",
+      input: { path: "package.json" },
+      output: [{ type: "inputText", text: "inspection failed" }],
+      status: "failed",
+    });
+  });
+});
+
+describe("CodexAdapterV2 native protocol logging", () => {
+  it.effect("writes app-server protocol frames to the native provider log", () =>
+    Effect.gen(function* () {
+      const writes: Array<{
+        readonly event: unknown;
+        readonly threadId: ThreadId | null;
+      }> = [];
+      const logger: EventNdjsonLogger = {
+        filePath: "/tmp/events.log",
+        write: (event, threadId) =>
+          Effect.sync(() => {
+            writes.push({ event, threadId });
+          }),
+        close: () => Effect.void,
+      };
+      const threadId = ThreadId.make("thread-1");
+      const providerSessionId = ProviderSessionId.make("provider-session-1");
+      const protocolLogger = makeCodexAppServerProtocolLogger({
+        nativeEventLogger: logger,
+        threadId,
+        providerSessionId,
+      });
+
+      assert.notEqual(protocolLogger, undefined);
+      if (protocolLogger === undefined) {
+        return;
+      }
+
+      yield* protocolLogger({
+        direction: "incoming",
+        stage: "decoded",
+        payload: {
+          method: "thread/event",
+          params: {
+            id: "evt-1",
+            http_headers: { Authorization: "Bearer secret-codex-token" },
+            usage: { inputTokens: 12, outputTokens: 8, totalTokens: 20 },
+          },
+        },
+      });
+      yield* protocolLogger({
+        direction: "incoming",
+        stage: "raw",
+        payload:
+          '{"method":"thread/event","params":{"http_headers":{"Authorization":"Bearer secret-codex-token"}}}\n',
+      });
+
+      assert.equal(writes.length, 2);
+      assert.equal(writes[0]?.threadId, threadId);
+      assert.deepEqual(writes[0]?.event, {
+        provider: "codex",
+        protocol: "codex.app-server",
+        kind: "protocol",
+        providerSessionId,
+        event: {
+          direction: "incoming",
+          stage: "decoded",
+          payload: {
+            method: "thread/event",
+            params: {
+              id: "evt-1",
+              http_headers: { Authorization: "[REDACTED]" },
+              usage: { inputTokens: 12, outputTokens: 8, totalTokens: 20 },
+            },
+          },
+        },
+      });
+      assert.equal(writes[1]?.threadId, threadId);
+      assert.deepEqual(writes[1]?.event, {
+        provider: "codex",
+        protocol: "codex.app-server",
+        kind: "protocol",
+        providerSessionId,
+        event: {
+          direction: "incoming",
+          stage: "raw",
+          payload:
+            '{"method":"thread/event","params":{"http_headers":{"Authorization":"[REDACTED]"}}}',
+        },
+      });
+    }),
+  );
+
+  it("does not install a protocol logger when native logging is unavailable", () => {
+    const protocolLogger = makeCodexAppServerProtocolLogger({
+      nativeEventLogger: undefined,
+      threadId: ThreadId.make("thread-1"),
+      providerSessionId: ProviderSessionId.make("provider-session-1"),
+    });
+
+    assert.equal(protocolLogger, undefined);
+  });
+});
+
+describe("CodexAdapterV2 rollback mapping", () => {
+  it.effect("derives native rollback count from durable provider turns", () =>
+    Effect.gen(function* () {
+      const now = yield* DateTime.now;
+      const providerThreadId = ProviderThreadId.make("provider-thread-codex-rollback");
+      const providerThread: OrchestrationV2ProviderThread = {
+        id: providerThreadId,
+        driver: CODEX_DRIVER_KIND,
+        providerInstanceId: ProviderInstanceId.make("codex"),
+        providerSessionId: ProviderSessionId.make("provider-session-codex-rollback"),
+        appThreadId: ThreadId.make("thread-codex-rollback"),
+        ownerNodeId: null,
+        nativeThreadRef: {
+          driver: CODEX_DRIVER_KIND,
+          nativeId: "native-thread-codex-rollback",
+          strength: "strong",
+        },
+        nativeConversationHeadRef: null,
+        status: "idle",
+        firstRunOrdinal: 1,
+        lastRunOrdinal: 3,
+        handoffIds: [],
+        forkedFrom: null,
+        createdAt: now,
+        updatedAt: now,
+      };
+      const providerTurn = (
+        id: string,
+        ordinal: number,
+        status: OrchestrationV2ProviderTurn["status"],
+      ): OrchestrationV2ProviderTurn => ({
+        id: ProviderTurnId.make(id),
+        providerThreadId,
+        nodeId: NodeId.make(`node-${id}`),
+        runAttemptId: RunAttemptId.make(`run-attempt-${id}`),
+        nativeTurnRef: {
+          driver: CODEX_DRIVER_KIND,
+          nativeId: `native-${id}`,
+          strength: "strong",
+        },
+        ordinal,
+        status,
+        startedAt: now,
+        completedAt: status === "running" || status === "pending" ? null : now,
+      });
+      const firstTurn = providerTurn("provider-turn-first", 1, "completed");
+      const secondTurn = providerTurn("provider-turn-second", 2, "completed");
+      const runningTurn = providerTurn("provider-turn-running", 3, "running");
+      const interruptedTurn = providerTurn("provider-turn-interrupted", 4, "interrupted");
+
+      const numTurns = yield* resolveCodexRollbackTurnCount({
+        providerThread,
+        target: {
+          type: "provider_turn",
+          checkpointId: CheckpointId.make("checkpoint-first"),
+          appRunOrdinal: 1,
+          providerTurn: firstTurn,
+        },
+        providerThreadTurns: [interruptedTurn, runningTurn, secondTurn, firstTurn],
+      });
+
+      assert.equal(numTurns, 2);
+    }),
+  );
+});
+
+describe("CodexAdapterV2 background command detail", () => {
+  it("summarizes command, exit code, and output tail", () => {
+    assert.equal(
+      codexBackgroundCommandDetail({
+        command: "sleep 20 && echo CODEX_BG_WAKE_DONE",
+        exitCode: 0,
+        aggregatedOutput: "CODEX_BG_WAKE_DONE\n",
+      }),
+      "Background command completed (exit 0): sleep 20 && echo CODEX_BG_WAKE_DONE\n\n" +
+        "Output tail:\nCODEX_BG_WAKE_DONE",
+    );
+  });
+
+  it("omits the output section and exit code when absent", () => {
+    assert.equal(
+      codexBackgroundCommandDetail({
+        command: "sleep 20",
+        exitCode: null,
+        aggregatedOutput: null,
+      }),
+      "Background command completed: sleep 20",
+    );
+  });
+
+  it("truncates long commands and keeps only the output tail", () => {
+    const detail = codexBackgroundCommandDetail({
+      command: "x".repeat(300),
+      exitCode: 1,
+      aggregatedOutput: `${"y".repeat(2000)}TAIL`,
+    });
+    assert.include(detail, `(exit 1): ${"x".repeat(200)}...`);
+    assert.include(detail, "Output tail:\n...");
+    assert.include(detail, "TAIL");
+    assert.notInclude(detail, "y".repeat(1001));
+  });
+});
+
+const DEFAULT_CODEX_SETTINGS = Schema.decodeSync(CodexSettings)({});
+const CODEX_TEST_MODEL_SELECTION = {
+  instanceId: CODEX_DEFAULT_INSTANCE_ID,
+  model: "gpt-5.4",
+} satisfies ModelSelection;
+const CODEX_TEST_RUNTIME_POLICY = ProviderAdapterV2RuntimePolicy.make({
+  runtimeMode: "full-access",
+  interactionMode: "default",
+  cwd: "/workspace",
+});
+
+function makeCodexTestAppThread(input: {
+  readonly threadId: ThreadId;
+  readonly providerThread: OrchestrationV2ProviderThread;
+  readonly now: DateTime.Utc;
+}): OrchestrationV2AppThread {
+  return {
+    createdBy: "user",
+    creationSource: "web",
+    id: input.threadId,
+    projectId: ProjectId.make(`project-${input.threadId}`),
+    title: "Codex continuation test",
+    providerInstanceId: CODEX_DEFAULT_INSTANCE_ID,
+    modelSelection: CODEX_TEST_MODEL_SELECTION,
+    runtimeMode: "full-access",
+    interactionMode: "default",
+    branch: null,
+    worktreePath: null,
+    activeProviderThreadId: input.providerThread.id,
+    lineage: {
+      parentThreadId: null,
+      relationshipToParent: null,
+      rootThreadId: input.threadId,
+    },
+    forkedFrom: null,
+    createdAt: input.now,
+    updatedAt: input.now,
+    archivedAt: null,
+    settledOverride: null,
+    settledAt: null,
+    lastVisitedAt: null,
+    deletedAt: null,
+  };
+}
+
+function makeCodexTestTurnInput(input: {
+  readonly threadId: ThreadId;
+  readonly providerThread: OrchestrationV2ProviderThread;
+  readonly now: DateTime.Utc;
+  readonly attemptId: RunAttemptId;
+  readonly text: string;
+}): ProviderAdapterV2TurnInput {
+  return {
+    appThread: makeCodexTestAppThread(input),
+    threadId: input.threadId,
+    runId: RunId.make(`run-${input.attemptId}`),
+    runOrdinal: 1,
+    providerTurnOrdinal: 1,
+    attemptId: input.attemptId,
+    rootNodeId: NodeId.make(`node-${input.attemptId}`),
+    providerThread: input.providerThread,
+    message: {
+      createdBy: "user",
+      creationSource: "web",
+      messageId: MessageId.make(`message-${input.attemptId}`),
+      text: input.text,
+      attachments: [],
+    },
+    modelSelection: CODEX_TEST_MODEL_SELECTION,
+    runtimePolicy: CODEX_TEST_RUNTIME_POLICY,
+  };
+}
+
+function makeCodexReplayTurn(input: {
+  readonly id: string;
+  readonly status: "inProgress" | "completed" | "interrupted" | "failed";
+}): Record<string, unknown> {
+  const terminal =
+    input.status === "completed" || input.status === "interrupted" || input.status === "failed";
+  return {
+    id: input.id,
+    items: [],
+    itemsView: "notLoaded",
+    status: input.status,
+    error: null,
+    startedAt: 1782622440,
+    completedAt: terminal ? 1782622450 : null,
+    durationMs: null,
+  };
+}
+
+function codexReplayPreamble(input: {
+  readonly nativeThreadId: string;
+  readonly nativeTurnId: string;
+  readonly prompt: string;
+}): Array<CodexReplay.CodexAppServerReplayEntry> {
+  return [
+    {
+      type: "expect_outbound",
+      label: "initialize",
+      frame: {
+        id: 1,
+        method: "initialize",
+        params: {
+          clientInfo: { name: "t3code_desktop", title: "T3 Code Desktop", version: "0.1.0" },
+          capabilities: { experimentalApi: true },
+        },
+      },
+    },
+    {
+      type: "emit_inbound",
+      label: "initialize",
+      frame: {
+        id: 1,
+        result: {
+          userAgent: "t3code_desktop/0.144.0",
+          codexHome: "/tmp/codex-home",
+          platformFamily: "unix",
+          platformOs: "macos",
+        },
+      },
+    },
+    { type: "expect_outbound", label: "initialized", frame: { method: "initialized" } },
+    {
+      type: "expect_outbound",
+      label: "thread/start",
+      frame: { id: 2, method: "thread/start", params: {} },
+    },
+    {
+      type: "emit_inbound",
+      label: "thread/start",
+      frame: {
+        id: 2,
+        result: {
+          thread: {
+            id: input.nativeThreadId,
+            sessionId: input.nativeThreadId,
+            forkedFromId: null,
+            preview: "",
+            ephemeral: false,
+            modelProvider: "openai",
+            createdAt: 1782622440,
+            updatedAt: 1782622440,
+            status: { type: "idle" },
+            path: `/tmp/${input.nativeThreadId}.jsonl`,
+            cwd: "/workspace",
+            cliVersion: "0.144.0",
+            source: "vscode",
+            threadSource: null,
+            agentNickname: null,
+            agentRole: null,
+            gitInfo: null,
+            name: null,
+            turns: [],
+          },
+          model: "gpt-5.4",
+          modelProvider: "openai",
+          serviceTier: null,
+          cwd: "/workspace",
+          instructionSources: [],
+          approvalPolicy: "on-request",
+          approvalsReviewer: "user",
+          sandbox: { type: "workspaceWrite", writableRoots: [], networkAccess: false },
+          reasoningEffort: "medium",
+        },
+      },
+    },
+    {
+      type: "expect_outbound",
+      label: "turn/start",
+      frame: {
+        id: 3,
+        method: "turn/start",
+        params: {
+          threadId: input.nativeThreadId,
+          input: [{ type: "text", text: input.prompt }],
+          cwd: "/workspace",
+          model: "gpt-5.4",
+          approvalPolicy: "never",
+          approvalsReviewer: "user",
+          sandboxPolicy: { type: "dangerFullAccess" },
+        },
+      },
+    },
+    {
+      type: "emit_inbound",
+      label: "turn/start",
+      frame: {
+        id: 3,
+        result: { turn: makeCodexReplayTurn({ id: input.nativeTurnId, status: "inProgress" }) },
+      },
+    },
+    {
+      type: "emit_inbound",
+      label: "turn/started",
+      frame: {
+        method: "turn/started",
+        params: {
+          threadId: input.nativeThreadId,
+          turn: makeCodexReplayTurn({ id: input.nativeTurnId, status: "inProgress" }),
+        },
+      },
+    },
+  ];
+}
+
+function makeCodexReplayTranscript(input: {
+  readonly scenario: string;
+  readonly entries: ReadonlyArray<CodexReplay.CodexAppServerReplayEntry>;
+}): CodexReplay.CodexAppServerReplayTranscript {
+  return {
+    provider: "codex",
+    protocol: "codex.app-server",
+    version: "0.144.0",
+    scenario: input.scenario,
+    entries: input.entries,
+  };
+}
+
+describe("CodexAdapterV2 post-settle continuation", () => {
+  const awaitUntil = (predicate: () => boolean, label: string): Effect.Effect<void> =>
+    Effect.gen(function* () {
+      for (let attempt = 0; attempt < 5000; attempt++) {
+        if (predicate()) {
+          return;
+        }
+        yield* Effect.yieldNow;
+      }
+      return yield* Effect.die(`Timed out waiting for ${label}.`);
+    });
+
+  const makeCodexReplayHarness = (transcript: CodexReplay.CodexAppServerReplayTranscript) =>
+    Effect.gen(function* () {
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const serverConfig = yield* makeReplayServerConfig(transcript.scenario).pipe(Effect.orDie);
+      const continuationRequests: Array<ProviderContinuationRequest> = [];
+      const clientFactory: CodexAppServerClientFactoryShape = {
+        open: (openInput) =>
+          Layer.build(CodexReplay.layerReplay(transcript)).pipe(
+            Effect.mapError(
+              (cause) =>
+                new ProviderAdapterOpenSessionError({
+                  driver: CODEX_DRIVER_KIND,
+                  providerSessionId: openInput.providerSessionId,
+                  cause,
+                }),
+            ),
+            Effect.flatMap((context) =>
+              Effect.service(CodexClient.CodexAppServerClient).pipe(Effect.provide(context)),
+            ),
+          ),
+      };
+      const adapter = makeCodexAdapterV2({
+        instanceId: CODEX_DEFAULT_INSTANCE_ID,
+        settings: DEFAULT_CODEX_SETTINGS,
+        environment: {},
+        clientFactory,
+        fileSystem,
+        idAllocator,
+        serverConfig,
+        continuationRequests: {
+          offer: (request) =>
+            Effect.sync(() => {
+              continuationRequests.push(request);
+            }),
+        },
+      });
+      const threadId = ThreadId.make(`thread-${transcript.scenario}`);
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId: ProviderSessionId.make(`provider-session-${transcript.scenario}`),
+        modelSelection: CODEX_TEST_MODEL_SELECTION,
+        runtimePolicy: CODEX_TEST_RUNTIME_POLICY,
+      });
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection: CODEX_TEST_MODEL_SELECTION,
+        runtimePolicy: CODEX_TEST_RUNTIME_POLICY,
+      });
+      const events: Array<ProviderAdapterV2Event> = [];
+      yield* runtime.events.pipe(
+        Stream.runForEach((event) =>
+          Effect.sync(() => {
+            events.push(event);
+          }),
+        ),
+        Effect.forkScoped,
+      );
+      if (runtime.hasPendingBackgroundWork === undefined) {
+        return yield* Effect.die("Codex adapter runtime must expose hasPendingBackgroundWork.");
+      }
+      const hasPendingBackgroundWork = runtime.hasPendingBackgroundWork;
+      const terminalEvents = () =>
+        events.filter(
+          (event): event is Extract<ProviderAdapterV2Event, { type: "turn.terminal" }> =>
+            event.type === "turn.terminal",
+        );
+      const subagentUpdates = () =>
+        events.filter(
+          (event): event is Extract<ProviderAdapterV2Event, { type: "subagent.updated" }> =>
+            event.type === "subagent.updated",
+        );
+      return {
+        runtime,
+        providerThread,
+        threadId,
+        events,
+        continuationRequests,
+        terminalEvents,
+        subagentUpdates,
+        hasPendingBackgroundWork,
+      };
+    });
+
+  const assistantMessages = (events: ReadonlyArray<ProviderAdapterV2Event>) =>
+    events.filter(
+      (event): event is Extract<ProviderAdapterV2Event, { type: "message.updated" }> =>
+        event.type === "message.updated" && event.message.role === "assistant",
+    );
+
+  it.effect("resolves retryable app-server errors on resumed provider activity", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const scenario = "codex-provider-api-retry";
+        const nativeThreadId = `native-${scenario}-thread`;
+        const nativeTurnId = `native-${scenario}-turn`;
+        const transcript = makeCodexReplayTranscript({
+          scenario,
+          entries: [
+            ...codexReplayPreamble({
+              nativeThreadId,
+              nativeTurnId,
+              prompt: "Open github.com.",
+            }),
+            {
+              type: "emit_inbound",
+              label: "error/retry",
+              frame: {
+                method: "error",
+                params: {
+                  threadId: nativeThreadId,
+                  turnId: nativeTurnId,
+                  willRetry: true,
+                  error: {
+                    message: "Reconnecting... 2/5",
+                    additionalDetails: "The response stream disconnected.",
+                    codexErrorInfo: {
+                      responseStreamDisconnected: { httpStatusCode: 529 },
+                    },
+                  },
+                },
+              },
+            },
+            {
+              type: "emit_inbound",
+              label: "item/started/after-retry",
+              frame: {
+                method: "item/started",
+                params: {
+                  threadId: nativeThreadId,
+                  turnId: nativeTurnId,
+                  startedAtMs: 1782622445000,
+                  item: {
+                    type: "commandExecution",
+                    id: "command-after-provider-retry",
+                    command: "pwd",
+                    cwd: "/workspace",
+                    processId: "42",
+                    source: "unifiedExecStartup",
+                    status: "inProgress",
+                    commandActions: [{ type: "unknown", command: "pwd" }],
+                    aggregatedOutput: null,
+                    exitCode: null,
+                    durationMs: null,
+                  },
+                },
+              },
+            },
+            {
+              type: "emit_inbound",
+              label: "item/completed/after-retry",
+              frame: {
+                method: "item/completed",
+                params: {
+                  threadId: nativeThreadId,
+                  turnId: nativeTurnId,
+                  completedAtMs: 1782622445010,
+                  item: {
+                    type: "commandExecution",
+                    id: "command-after-provider-retry",
+                    command: "pwd",
+                    cwd: "/workspace",
+                    processId: "42",
+                    source: "unifiedExecStartup",
+                    status: "completed",
+                    commandActions: [{ type: "unknown", command: "pwd" }],
+                    aggregatedOutput: "/workspace\n",
+                    exitCode: 0,
+                    durationMs: 10,
+                  },
+                },
+              },
+            },
+            {
+              type: "emit_inbound",
+              label: "turn/completed",
+              frame: {
+                method: "turn/completed",
+                params: {
+                  threadId: nativeThreadId,
+                  turn: makeCodexReplayTurn({ id: nativeTurnId, status: "completed" }),
+                },
+              },
+            },
+          ],
+        });
+        const harness = yield* makeCodexReplayHarness(transcript);
+        const now = yield* DateTime.now;
+        yield* harness.runtime.startTurn(
+          makeCodexTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-codex-provider-api-retry"),
+            text: "Open github.com.",
+          }),
+        );
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "Codex retry recovery");
+
+        const retryItems = harness.events.flatMap((event) =>
+          event.type === "turn_item.updated" &&
+          event.turnItem.type === "error" &&
+          event.turnItem.retry !== undefined
+            ? [event.turnItem]
+            : [],
+        );
+        assert.lengthOf(retryItems, 2);
+        assert.equal(retryItems[0]?.status, "running");
+        assert.equal(retryItems[0]?.failure.code, "responseStreamDisconnected");
+        assert.deepEqual(retryItems[0]?.retry, {
+          attempt: 2,
+          maxAttempts: 5,
+          retryDelayMs: null,
+        });
+        assert.equal(retryItems[1]?.id, retryItems[0]?.id);
+        assert.equal(retryItems[1]?.status, "completed");
+        assert.equal(retryItems[1]?.title, "Provider recovered");
+
+        const recoveredIndex = harness.events.findIndex(
+          (event) =>
+            event.type === "turn_item.updated" &&
+            event.turnItem.type === "error" &&
+            event.turnItem.status === "completed",
+        );
+        const resumedCommandIndex = harness.events.findIndex(
+          (event) =>
+            event.type === "turn_item.updated" &&
+            event.turnItem.type === "command_execution" &&
+            event.turnItem.input === "pwd",
+        );
+        const terminalIndex = harness.events.findIndex((event) => event.type === "turn.terminal");
+        assert.isAtLeast(recoveredIndex, 0);
+        assert.isAbove(resumedCommandIndex, recoveredIndex);
+        assert.isAbove(terminalIndex, resumedCommandIndex);
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  const finalAnswerTranscript = (
+    scenario: string,
+    answers: ReadonlyArray<{
+      readonly id: string;
+      readonly text: string;
+      readonly phase?: "commentary" | "final_answer" | null;
+      readonly omitPhase?: boolean;
+      readonly streamed?: boolean;
+      readonly completionDelayMs?: number;
+    }>,
+  ) => {
+    const nativeThreadId = `native-${scenario}-thread`;
+    const nativeTurnId = `native-${scenario}-turn`;
+    const prompt = "Reply with the requested recovery marker.";
+    return makeCodexReplayTranscript({
+      scenario,
+      entries: [
+        ...codexReplayPreamble({ nativeThreadId, nativeTurnId, prompt }),
+        ...answers.flatMap(
+          (answer, index): ReadonlyArray<CodexReplay.CodexAppServerReplayEntry> => {
+            const phase = answer.omitPhase
+              ? {}
+              : { phase: answer.phase === undefined ? ("final_answer" as const) : answer.phase };
+            const completed: CodexReplay.CodexAppServerReplayEntry = {
+              type: "emit_inbound",
+              label: `item/completed/${answer.id}`,
+              ...(answer.completionDelayMs === undefined
+                ? {}
+                : { afterMs: answer.completionDelayMs }),
+              frame: {
+                method: "item/completed",
+                params: {
+                  item: {
+                    type: "agentMessage",
+                    id: answer.id,
+                    text: answer.text,
+                    ...phase,
+                    memoryCitation: null,
+                  },
+                  threadId: nativeThreadId,
+                  turnId: nativeTurnId,
+                  completedAtMs: 1782622441000 + index,
+                },
+              },
+            };
+            if (!answer.streamed) {
+              return [completed];
+            }
+            return [
+              {
+                type: "emit_inbound",
+                label: `item/started/${answer.id}`,
+                frame: {
+                  method: "item/started",
+                  params: {
+                    item: {
+                      type: "agentMessage",
+                      id: answer.id,
+                      text: "",
+                      ...phase,
+                      memoryCitation: null,
+                    },
+                    threadId: nativeThreadId,
+                    turnId: nativeTurnId,
+                    startedAtMs: 1782622440500 + index,
+                  },
+                },
+              },
+              {
+                type: "emit_inbound",
+                label: `item/agentMessage/delta/${answer.id}`,
+                frame: {
+                  method: "item/agentMessage/delta",
+                  params: {
+                    threadId: nativeThreadId,
+                    turnId: nativeTurnId,
+                    itemId: answer.id,
+                    delta: answer.text,
+                  },
+                },
+              },
+              completed,
+            ];
+          },
+        ),
+        {
+          type: "emit_inbound",
+          label: "turn/completed",
+          frame: {
+            method: "turn/completed",
+            params: {
+              threadId: nativeThreadId,
+              turn: makeCodexReplayTurn({ id: nativeTurnId, status: "completed" }),
+            },
+          },
+        },
+      ],
+    });
+  };
+
+  it.effect("suppresses a trailing empty final answer after a non-empty final answer", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const transcript = finalAnswerTranscript("codex-redundant-empty-final", [
+          { id: "answer-non-empty", text: "CODEX_RECOVERY_OK" },
+          { id: "answer-empty", text: "" },
+        ]);
+        const harness = yield* makeCodexReplayHarness(transcript);
+        const now = yield* DateTime.now;
+
+        yield* harness.runtime.startTurn(
+          makeCodexTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-codex-redundant-empty-final"),
+            text: "Reply with the requested recovery marker.",
+          }),
+        );
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "root turn terminal");
+
+        assert.deepEqual(
+          assistantMessages(harness.events).map((event) => event.message.text),
+          ["CODEX_RECOVERY_OK"],
+        );
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  it.effect("suppresses a later streamed duplicate final answer", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const transcript = finalAnswerTranscript("codex-streamed-duplicate-final", [
+          { id: "answer-original", text: "CODEX_RECOVERY_OK" },
+          {
+            id: "answer-duplicate",
+            text: "CODEX_RECOVERY_OK",
+            streamed: true,
+            completionDelayMs: 100,
+          },
+        ]);
+        const harness = yield* makeCodexReplayHarness(transcript);
+        const now = yield* DateTime.now;
+
+        yield* harness.runtime.startTurn(
+          makeCodexTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-codex-streamed-duplicate-final"),
+            text: "Reply with the requested recovery marker.",
+          }),
+        );
+        yield* awaitUntil(() => assistantMessages(harness.events).length === 1, "original answer");
+        yield* Effect.yieldNow;
+        yield* TestClock.adjust("50 millis");
+        yield* Effect.yieldNow;
+
+        assert.deepEqual(
+          assistantMessages(harness.events).map((event) => event.message.text),
+          ["CODEX_RECOVERY_OK"],
+        );
+
+        yield* TestClock.adjust("50 millis");
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "root turn terminal");
+        assert.deepEqual(
+          assistantMessages(harness.events).map((event) => event.message.text),
+          ["CODEX_RECOVERY_OK"],
+        );
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  it.effect("buffers an overlapping later final stream until duplicate detection", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const scenario = "codex-overlapping-duplicate-final";
+        const nativeThreadId = `native-${scenario}-thread`;
+        const nativeTurnId = `native-${scenario}-turn`;
+        const answerItem = (id: string, text: string) => ({
+          type: "agentMessage" as const,
+          id,
+          text,
+          phase: "final_answer" as const,
+          memoryCitation: null,
+        });
+        const transcript = makeCodexReplayTranscript({
+          scenario,
+          entries: [
+            ...codexReplayPreamble({
+              nativeThreadId,
+              nativeTurnId,
+              prompt: "Reply with the requested recovery marker.",
+            }),
+            ...["answer-overlap-original", "answer-overlap-duplicate"].flatMap(
+              (itemId, index): ReadonlyArray<CodexReplay.CodexAppServerReplayEntry> => [
+                {
+                  type: "emit_inbound",
+                  label: `item/started/${itemId}`,
+                  frame: {
+                    method: "item/started",
+                    params: {
+                      item: answerItem(itemId, ""),
+                      threadId: nativeThreadId,
+                      turnId: nativeTurnId,
+                      startedAtMs: 1782622440500 + index,
+                    },
+                  },
+                },
+                {
+                  type: "emit_inbound",
+                  label: `item/agentMessage/delta/${itemId}`,
+                  frame: {
+                    method: "item/agentMessage/delta",
+                    params: {
+                      threadId: nativeThreadId,
+                      turnId: nativeTurnId,
+                      itemId,
+                      delta: "CODEX_RECOVERY_OK",
+                    },
+                  },
+                },
+              ],
+            ),
+            {
+              type: "emit_inbound",
+              label: "item/completed/answer-overlap-original",
+              afterMs: 100,
+              frame: {
+                method: "item/completed",
+                params: {
+                  item: answerItem("answer-overlap-original", "CODEX_RECOVERY_OK"),
+                  threadId: nativeThreadId,
+                  turnId: nativeTurnId,
+                  completedAtMs: 1782622441000,
+                },
+              },
+            },
+            {
+              type: "emit_inbound",
+              label: "item/completed/answer-overlap-duplicate",
+              frame: {
+                method: "item/completed",
+                params: {
+                  item: answerItem("answer-overlap-duplicate", "CODEX_RECOVERY_OK"),
+                  threadId: nativeThreadId,
+                  turnId: nativeTurnId,
+                  completedAtMs: 1782622441001,
+                },
+              },
+            },
+            {
+              type: "emit_inbound",
+              label: "turn/completed",
+              frame: {
+                method: "turn/completed",
+                params: {
+                  threadId: nativeThreadId,
+                  turn: makeCodexReplayTurn({ id: nativeTurnId, status: "completed" }),
+                },
+              },
+            },
+          ],
+        });
+        const harness = yield* makeCodexReplayHarness(transcript);
+        const now = yield* DateTime.now;
+
+        yield* harness.runtime.startTurn(
+          makeCodexTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-codex-overlapping-duplicate-final"),
+            text: "Reply with the requested recovery marker.",
+          }),
+        );
+        yield* Effect.yieldNow;
+        yield* TestClock.adjust("50 millis");
+        yield* Effect.yieldNow;
+
+        assert.equal(
+          new Set(assistantMessages(harness.events).map((event) => event.message.id)).size,
+          1,
+        );
+
+        yield* TestClock.adjust("50 millis");
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "root turn terminal");
+        assert.equal(
+          new Set(assistantMessages(harness.events).map((event) => event.message.id)).size,
+          1,
+        );
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  it.effect("preserves a sole empty final answer", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const transcript = finalAnswerTranscript("codex-sole-empty-final", [
+          { id: "answer-empty", text: "" },
+        ]);
+        const harness = yield* makeCodexReplayHarness(transcript);
+        const now = yield* DateTime.now;
+
+        yield* harness.runtime.startTurn(
+          makeCodexTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-codex-sole-empty-final"),
+            text: "Reply with the requested recovery marker.",
+          }),
+        );
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "root turn terminal");
+
+        assert.deepEqual(
+          assistantMessages(harness.events).map((event) => event.message.text),
+          [""],
+        );
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  it.effect("suppresses a second empty final answer", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const transcript = finalAnswerTranscript("codex-duplicate-empty-final", [
+          { id: "answer-empty-original", text: "" },
+          { id: "answer-empty-duplicate", text: "" },
+        ]);
+        const harness = yield* makeCodexReplayHarness(transcript);
+        const now = yield* DateTime.now;
+
+        yield* harness.runtime.startTurn(
+          makeCodexTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-codex-duplicate-empty-final"),
+            text: "Reply with the requested recovery marker.",
+          }),
+        );
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "root turn terminal");
+
+        assert.deepEqual(
+          assistantMessages(harness.events).map((event) => event.message.text),
+          [""],
+        );
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  it.effect("preserves an empty final answer when only commentary preceded it", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const transcript = finalAnswerTranscript("codex-commentary-then-empty-final", [
+          { id: "answer-commentary", text: "Working on it.", phase: "commentary" },
+          { id: "answer-empty", text: "" },
+        ]);
+        const harness = yield* makeCodexReplayHarness(transcript);
+        const now = yield* DateTime.now;
+
+        yield* harness.runtime.startTurn(
+          makeCodexTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-codex-commentary-then-empty-final"),
+            text: "Reply with the requested recovery marker.",
+          }),
+        );
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "root turn terminal");
+
+        assert.deepEqual(
+          assistantMessages(harness.events).map((event) => event.message.text),
+          ["Working on it.", ""],
+        );
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  it.effect("suppresses an empty final answer after a non-empty unknown-phase answer", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const transcript = finalAnswerTranscript("codex-unknown-non-empty-then-empty-final", [
+          { id: "answer-non-empty", text: "CODEX_RECOVERY_OK", phase: null },
+          { id: "answer-empty", text: "" },
+        ]);
+        const harness = yield* makeCodexReplayHarness(transcript);
+        const now = yield* DateTime.now;
+
+        yield* harness.runtime.startTurn(
+          makeCodexTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-codex-unknown-non-empty-then-empty-final"),
+            text: "Reply with the requested recovery marker.",
+          }),
+        );
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "root turn terminal");
+
+        assert.deepEqual(
+          assistantMessages(harness.events).map((event) => event.message.text),
+          ["CODEX_RECOVERY_OK"],
+        );
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  it.effect("suppresses a trailing empty answer with an omitted phase", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const transcript = finalAnswerTranscript("codex-final-then-empty-unknown", [
+          { id: "answer-non-empty", text: "CODEX_RECOVERY_OK" },
+          { id: "answer-empty", text: "", omitPhase: true },
+        ]);
+        const harness = yield* makeCodexReplayHarness(transcript);
+        const now = yield* DateTime.now;
+
+        yield* harness.runtime.startTurn(
+          makeCodexTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-codex-final-then-empty-unknown"),
+            text: "Reply with the requested recovery marker.",
+          }),
+        );
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "root turn terminal");
+
+        assert.deepEqual(
+          assistantMessages(harness.events).map((event) => event.message.text),
+          ["CODEX_RECOVERY_OK"],
+        );
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  it.effect("keeps a later non-empty final answer after an initial empty final answer", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const transcript = finalAnswerTranscript("codex-empty-then-non-empty-final", [
+          { id: "answer-empty", text: "" },
+          { id: "answer-non-empty", text: "CODEX_RECOVERY_OK" },
+        ]);
+        const harness = yield* makeCodexReplayHarness(transcript);
+        const now = yield* DateTime.now;
+
+        yield* harness.runtime.startTurn(
+          makeCodexTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-codex-empty-then-non-empty-final"),
+            text: "Reply with the requested recovery marker.",
+          }),
+        );
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "root turn terminal");
+
+        assert.deepEqual(
+          assistantMessages(harness.events).map((event) => event.message.text),
+          ["", "CODEX_RECOVERY_OK"],
+        );
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  const BG_SCENARIO = "codex-bg-exec-wake";
+  const BG_NATIVE_THREAD = "native-codex-bg-thread";
+  const BG_NATIVE_TURN = "native-codex-bg-turn";
+  const BG_COMMAND_ITEM = "call-codex-bg-command";
+  const BG_COMMAND = "sleep 20 && echo CODEX_BG_WAKE_DONE";
+  const BG_PROMPT = "Start the sleep in the background and reply STARTED.";
+
+  const backgroundCommandItem = (status: "inProgress" | "completed"): Record<string, unknown> => ({
+    type: "commandExecution",
+    id: BG_COMMAND_ITEM,
+    command: BG_COMMAND,
+    cwd: "/workspace",
+    processId: "4242",
+    source: "unifiedExecStartup",
+    status,
+    commandActions: [{ type: "unknown", command: BG_COMMAND }],
+    aggregatedOutput: status === "completed" ? "CODEX_BG_WAKE_DONE\n" : null,
+    exitCode: status === "completed" ? 0 : null,
+    durationMs: status === "completed" ? 25_000 : null,
+  });
+
+  const backgroundExecTranscript = makeCodexReplayTranscript({
+    scenario: BG_SCENARIO,
+    entries: [
+      ...codexReplayPreamble({
+        nativeThreadId: BG_NATIVE_THREAD,
+        nativeTurnId: BG_NATIVE_TURN,
+        prompt: BG_PROMPT,
+      }),
+      {
+        type: "emit_inbound",
+        label: "item/started/command",
+        frame: {
+          method: "item/started",
+          params: {
+            item: backgroundCommandItem("inProgress"),
+            threadId: BG_NATIVE_THREAD,
+            turnId: BG_NATIVE_TURN,
+            startedAtMs: 1782622440500,
+          },
+        },
+      },
+      {
+        type: "emit_inbound",
+        label: "item/completed/root-answer",
+        frame: {
+          method: "item/completed",
+          params: {
+            item: {
+              type: "agentMessage",
+              id: "root-answer-bg",
+              text: "STARTED",
+              phase: "final_answer",
+              memoryCitation: null,
+            },
+            threadId: BG_NATIVE_THREAD,
+            turnId: BG_NATIVE_TURN,
+            completedAtMs: 1782622441000,
+          },
+        },
+      },
+      {
+        type: "emit_inbound",
+        label: "turn/completed",
+        frame: {
+          method: "turn/completed",
+          params: {
+            threadId: BG_NATIVE_THREAD,
+            turn: makeCodexReplayTurn({ id: BG_NATIVE_TURN, status: "completed" }),
+          },
+        },
+      },
+      {
+        type: "emit_inbound",
+        label: "item/completed/command-late",
+        afterMs: 30_000,
+        frame: {
+          method: "item/completed",
+          params: {
+            item: backgroundCommandItem("completed"),
+            threadId: BG_NATIVE_THREAD,
+            turnId: BG_NATIVE_TURN,
+            completedAtMs: 1782622465500,
+          },
+        },
+      },
+    ],
+  });
+
+  it.effect(
+    "projects a post-settle background command completion and requests a continuation",
+    () =>
+      Effect.scoped(
+        Effect.gen(function* () {
+          const harness = yield* makeCodexReplayHarness(backgroundExecTranscript);
+          const now = yield* DateTime.now;
+
+          yield* harness.runtime.startTurn(
+            makeCodexTestTurnInput({
+              threadId: harness.threadId,
+              providerThread: harness.providerThread,
+              now,
+              attemptId: RunAttemptId.make("attempt-codex-bg-wake"),
+              text: BG_PROMPT,
+            }),
+          );
+          yield* awaitUntil(() => harness.terminalEvents().length === 1, "root turn terminal");
+          assert.equal(harness.terminalEvents()[0]?.status, "completed");
+          assert.isTrue(yield* harness.hasPendingBackgroundWork);
+          assert.lengthOf(harness.continuationRequests, 0);
+          const terminalIndex = harness.events.findIndex((event) => event.type === "turn.terminal");
+
+          yield* TestClock.adjust("30 seconds");
+          yield* awaitUntil(
+            () => harness.continuationRequests.length === 1,
+            "continuation request",
+          );
+          const request = harness.continuationRequests[0];
+          assert.equal(request?.threadId, harness.threadId);
+          assert.equal(request?.providerThreadId, harness.providerThread.id);
+          assert.equal(request?.driver, CODEX_DRIVER_KIND);
+          assert.equal(
+            request?.detail,
+            `Background command completed (exit 0): ${BG_COMMAND}\n\n` +
+              "Output tail:\nCODEX_BG_WAKE_DONE",
+          );
+
+          const lateCommandUpdateIndex = () =>
+            harness.events.findIndex(
+              (event, index) =>
+                index > terminalIndex &&
+                event.type === "turn_item.updated" &&
+                event.turnItem.type === "command_execution" &&
+                event.turnItem.status === "completed" &&
+                event.turnItem.output === "CODEX_BG_WAKE_DONE\n" &&
+                event.turnItem.exitCode === 0,
+            );
+          yield* awaitUntil(
+            () => lateCommandUpdateIndex() > terminalIndex,
+            "post-settle command projection",
+          );
+          assert.lengthOf(harness.terminalEvents(), 1);
+          assert.isFalse(yield* harness.hasPendingBackgroundWork);
+        }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+      ),
+  );
+
+  const PRE_SETTLE_SCENARIO = "codex-bg-exec-pre-settle";
+  const PRE_SETTLE_NATIVE_THREAD = "native-codex-pre-settle-thread";
+  const PRE_SETTLE_NATIVE_TURN = "native-codex-pre-settle-turn";
+
+  const preSettleTranscript = makeCodexReplayTranscript({
+    scenario: PRE_SETTLE_SCENARIO,
+    entries: [
+      ...codexReplayPreamble({
+        nativeThreadId: PRE_SETTLE_NATIVE_THREAD,
+        nativeTurnId: PRE_SETTLE_NATIVE_TURN,
+        prompt: BG_PROMPT,
+      }),
+      {
+        type: "emit_inbound",
+        label: "item/started/command",
+        frame: {
+          method: "item/started",
+          params: {
+            item: backgroundCommandItem("inProgress"),
+            threadId: PRE_SETTLE_NATIVE_THREAD,
+            turnId: PRE_SETTLE_NATIVE_TURN,
+            startedAtMs: 1782622440500,
+          },
+        },
+      },
+      {
+        type: "emit_inbound",
+        label: "item/completed/command-pre-settle",
+        frame: {
+          method: "item/completed",
+          params: {
+            item: backgroundCommandItem("completed"),
+            threadId: PRE_SETTLE_NATIVE_THREAD,
+            turnId: PRE_SETTLE_NATIVE_TURN,
+            completedAtMs: 1782622441000,
+          },
+        },
+      },
+      {
+        type: "emit_inbound",
+        label: "item/completed/root-answer",
+        frame: {
+          method: "item/completed",
+          params: {
+            item: {
+              type: "agentMessage",
+              id: "root-answer-pre-settle",
+              text: "DONE",
+              phase: "final_answer",
+              memoryCitation: null,
+            },
+            threadId: PRE_SETTLE_NATIVE_THREAD,
+            turnId: PRE_SETTLE_NATIVE_TURN,
+            completedAtMs: 1782622441500,
+          },
+        },
+      },
+      {
+        type: "emit_inbound",
+        label: "turn/completed",
+        frame: {
+          method: "turn/completed",
+          params: {
+            threadId: PRE_SETTLE_NATIVE_THREAD,
+            turn: makeCodexReplayTurn({ id: PRE_SETTLE_NATIVE_TURN, status: "completed" }),
+          },
+        },
+      },
+    ],
+  });
+
+  it.effect("does not request a continuation for a command that completes before settle", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const harness = yield* makeCodexReplayHarness(preSettleTranscript);
+        const now = yield* DateTime.now;
+
+        yield* harness.runtime.startTurn(
+          makeCodexTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-codex-bg-pre-settle"),
+            text: BG_PROMPT,
+          }),
+        );
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "root turn terminal");
+        assert.equal(harness.terminalEvents()[0]?.status, "completed");
+        yield* awaitUntil(
+          () =>
+            harness.events.some(
+              (event) =>
+                event.type === "turn_item.updated" &&
+                event.turnItem.type === "command_execution" &&
+                event.turnItem.status === "completed" &&
+                event.turnItem.exitCode === 0,
+            ),
+          "pre-settle command projection",
+        );
+
+        yield* TestClock.adjust("30 seconds");
+        for (let attempt = 0; attempt < 100; attempt++) {
+          yield* Effect.yieldNow;
+        }
+        assert.lengthOf(harness.continuationRequests, 0);
+        assert.isFalse(yield* harness.hasPendingBackgroundWork);
+        assert.lengthOf(harness.terminalEvents(), 1);
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  const INTERRUPT_SCENARIO = "codex-interrupt-mid-command";
+  const INTERRUPT_NATIVE_THREAD = "native-codex-interrupt-thread";
+  const INTERRUPT_NATIVE_TURN = "native-codex-interrupt-turn";
+  const INTERRUPT_COMMAND_ITEM = "exec-codex-interrupt-command";
+  const INTERRUPT_COMMAND_ITEM_TWO = "exec-codex-interrupt-command-two";
+  const INTERRUPT_CHILD_COMMAND_ITEM = "exec-codex-interrupt-child-command";
+  const INTERRUPT_CHILD_TIMEOUT_BOUNDARY_ITEM = "exec-codex-interrupt-child-timeout-boundary";
+  const INTERRUPT_CHILD_NATIVE_THREAD = "native-codex-interrupt-child-thread";
+  const INTERRUPT_CHILD_NATIVE_TURN = "native-codex-interrupt-child-turn";
+  const INTERRUPT_LATE_CHILD_NATIVE_TURN = "native-codex-interrupt-late-child-turn";
+  const INTERRUPT_LATE_CHILD_2_NATIVE_TURN = "native-codex-interrupt-late-child-2-turn";
+  const INTERRUPT_TIMEOUT_BOUNDARY_ITEM = "exec-codex-interrupt-timeout-boundary";
+  const INTERRUPT_TIMEOUT_LATE_ITEM = "exec-codex-interrupt-timeout-late";
+  const INTERRUPT_COMMAND = "bash -c 'sleep 30; echo SHOULD_NOT_FINISH_CMD_INTERRUPT_FIXTURE'";
+  const INTERRUPT_COMMAND_TWO = "bash -c 'sleep 20; echo SECOND_COMMAND'";
+  const INTERRUPT_PROMPT = "Run a long foreground command and wait until interrupted.";
+
+  const interruptCommandItem = (status: "inProgress" | "completed"): Record<string, unknown> => ({
+    type: "commandExecution",
+    id: INTERRUPT_COMMAND_ITEM,
+    command: INTERRUPT_COMMAND,
+    cwd: "/workspace",
+    processId: "57680",
+    source: "unifiedExecStartup",
+    status,
+    commandActions: [{ type: "unknown", command: INTERRUPT_COMMAND }],
+    aggregatedOutput: status === "completed" ? "SHOULD_NOT_FINISH_CMD_INTERRUPT_FIXTURE\n" : null,
+    exitCode: status === "completed" ? 0 : null,
+    durationMs: status === "completed" ? 30_000 : null,
+  });
+
+  const interruptMidCommandTranscript = makeCodexReplayTranscript({
+    scenario: INTERRUPT_SCENARIO,
+    entries: [
+      ...codexReplayPreamble({
+        nativeThreadId: INTERRUPT_NATIVE_THREAD,
+        nativeTurnId: INTERRUPT_NATIVE_TURN,
+        prompt: INTERRUPT_PROMPT,
+      }),
+      {
+        type: "emit_inbound",
+        label: "item/started/command",
+        frame: {
+          method: "item/started",
+          params: {
+            item: interruptCommandItem("inProgress"),
+            threadId: INTERRUPT_NATIVE_THREAD,
+            turnId: INTERRUPT_NATIVE_TURN,
+            startedAtMs: 1782622440500,
+          },
+        },
+      },
+      {
+        type: "expect_outbound",
+        label: "turn/interrupt",
+        frame: {
+          id: 4,
+          method: "turn/interrupt",
+          params: {
+            threadId: INTERRUPT_NATIVE_THREAD,
+            turnId: INTERRUPT_NATIVE_TURN,
+          },
+        },
+      },
+      {
+        type: "emit_inbound",
+        label: "turn/interrupt",
+        frame: { id: 4, result: {} },
+      },
+      {
+        type: "emit_inbound",
+        label: "item/started/command-two-after-interrupt-response",
+        frame: {
+          method: "item/started",
+          params: {
+            item: {
+              ...interruptCommandItem("inProgress"),
+              id: INTERRUPT_COMMAND_ITEM_TWO,
+              command: INTERRUPT_COMMAND_TWO,
+              processId: "57681",
+              commandActions: [{ type: "unknown", command: INTERRUPT_COMMAND_TWO }],
+            },
+            threadId: INTERRUPT_NATIVE_THREAD,
+            turnId: INTERRUPT_NATIVE_TURN,
+            startedAtMs: 1782622440600,
+          },
+        },
+      },
+      {
+        type: "emit_inbound",
+        label: "turn/completed",
+        frame: {
+          method: "turn/completed",
+          params: {
+            threadId: INTERRUPT_NATIVE_THREAD,
+            turn: makeCodexReplayTurn({
+              id: INTERRUPT_NATIVE_TURN,
+              status: "interrupted",
+            }),
+          },
+        },
+      },
+      {
+        type: "expect_outbound",
+        label: "thread/backgroundTerminals/terminate/one",
+        frame: {
+          id: 5,
+          method: "thread/backgroundTerminals/terminate",
+          params: { threadId: INTERRUPT_NATIVE_THREAD, processId: "57680" },
+        },
+      },
+      {
+        type: "emit_inbound",
+        label: "thread/backgroundTerminals/terminate/one",
+        frame: { id: 5, result: { terminated: false } },
+      },
+      {
+        type: "expect_outbound",
+        label: "thread/backgroundTerminals/list/after-false",
+        frame: {
+          id: 6,
+          method: "thread/backgroundTerminals/list",
+          params: { threadId: INTERRUPT_NATIVE_THREAD },
+        },
+      },
+      {
+        type: "emit_inbound",
+        label: "thread/backgroundTerminals/list/after-false",
+        frame: { id: 6, result: { data: [], nextCursor: null } },
+      },
+      {
+        type: "expect_outbound",
+        label: "thread/backgroundTerminals/terminate/two",
+        frame: {
+          id: 7,
+          method: "thread/backgroundTerminals/terminate",
+          params: { threadId: INTERRUPT_NATIVE_THREAD, processId: "57681" },
+        },
+      },
+      {
+        type: "emit_inbound",
+        label: "thread/backgroundTerminals/terminate/two",
+        frame: { id: 7, result: { terminated: true } },
+      },
+      {
+        type: "emit_inbound",
+        label: "item/completed/command-late",
+        afterMs: 30_000,
+        frame: {
+          method: "item/completed",
+          params: {
+            item: interruptCommandItem("completed"),
+            threadId: INTERRUPT_NATIVE_THREAD,
+            turnId: INTERRUPT_NATIVE_TURN,
+            completedAtMs: 1782622465500,
+          },
+        },
+      },
+    ],
+  });
+
+  it.effect("contains commands that start before and after the interrupt response", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const harness = yield* makeCodexReplayHarness(interruptMidCommandTranscript);
+        const now = yield* DateTime.now;
+
+        yield* harness.runtime.startTurn(
+          makeCodexTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-codex-interrupt-mid-command"),
+            text: INTERRUPT_PROMPT,
+          }),
+        );
+
+        yield* awaitUntil(
+          () =>
+            harness.events.some(
+              (event) =>
+                event.type === "turn_item.updated" &&
+                event.turnItem.type === "command_execution" &&
+                event.turnItem.status === "running",
+            ),
+          "running command item",
+        );
+
+        const providerTurnId = harness.events.find(
+          (event): event is Extract<ProviderAdapterV2Event, { type: "provider_turn.updated" }> =>
+            event.type === "provider_turn.updated",
+        )?.providerTurn.id;
+        assert.isDefined(providerTurnId);
+
+        yield* harness.runtime.interruptTurn({
+          providerThread: harness.providerThread,
+          providerTurnId,
+        });
+
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "interrupted terminal");
+        assert.equal(harness.terminalEvents()[0]?.status, "interrupted");
+
+        const terminalIndex = harness.events.findIndex((event) => event.type === "turn.terminal");
+        assert.isAtLeast(terminalIndex, 0);
+
+        let lastCommandBeforeTerminal:
+          | Extract<ProviderAdapterV2Event, { type: "turn_item.updated" }>
+          | undefined;
+        for (let index = 0; index < terminalIndex; index++) {
+          const event = harness.events[index];
+          if (event?.type === "turn_item.updated" && event.turnItem.type === "command_execution") {
+            lastCommandBeforeTerminal = event;
+          }
+        }
+        assert.isDefined(lastCommandBeforeTerminal);
+        assert.equal(lastCommandBeforeTerminal.turnItem.status, "interrupted");
+        assert.isNotNull(lastCommandBeforeTerminal.turnItem.completedAt);
+
+        const interruptedCommandsBeforeTerminal = harness.events
+          .slice(0, terminalIndex)
+          .flatMap((event) =>
+            event.type === "turn_item.updated" &&
+            event.turnItem.type === "command_execution" &&
+            event.turnItem.status === "interrupted"
+              ? [event.turnItem.input]
+              : [],
+          )
+          .sort();
+        assert.deepEqual(
+          interruptedCommandsBeforeTerminal,
+          [INTERRUPT_COMMAND, INTERRUPT_COMMAND_TWO].sort(),
+        );
+
+        const interruptedCommandIndex = harness.events.findIndex(
+          (event, index) =>
+            index < terminalIndex &&
+            event.type === "turn_item.updated" &&
+            event.turnItem.type === "command_execution" &&
+            event.turnItem.status === "interrupted",
+        );
+        assert.isAbove(
+          terminalIndex,
+          interruptedCommandIndex,
+          "command terminalization must precede turn.terminal",
+        );
+
+        assert.isFalse(yield* harness.hasPendingBackgroundWork);
+        assert.lengthOf(harness.continuationRequests, 0);
+
+        // Late provider item/completed after interrupt must not revive the card
+        // or request a background-command wake continuation.
+        yield* TestClock.adjust("30 seconds");
+        for (let attempt = 0; attempt < 100; attempt++) {
+          yield* Effect.yieldNow;
+        }
+        assert.lengthOf(harness.continuationRequests, 0);
+        assert.isFalse(yield* harness.hasPendingBackgroundWork);
+        assert.lengthOf(harness.terminalEvents(), 1);
+
+        const postTerminalCommandUpdates = harness.events.filter(
+          (event, index) =>
+            index > terminalIndex &&
+            event.type === "turn_item.updated" &&
+            event.turnItem.type === "command_execution",
+        );
+        assert.lengthOf(
+          postTerminalCommandUpdates,
+          0,
+          "late item/completed after interrupt must not project",
+        );
+
+        const commandUpdates = harness.events.filter(
+          (event): event is Extract<ProviderAdapterV2Event, { type: "turn_item.updated" }> =>
+            event.type === "turn_item.updated" && event.turnItem.type === "command_execution",
+        );
+        assert.isAtLeast(commandUpdates.length, 2, "start + interrupt terminalization");
+        assert.equal(commandUpdates[commandUpdates.length - 1]?.turnItem.status, "interrupted");
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  const interruptSubagentCommandTranscript = makeCodexReplayTranscript({
+    scenario: "codex-interrupt-subagent-command",
+    entries: [
+      ...codexReplayPreamble({
+        nativeThreadId: INTERRUPT_NATIVE_THREAD,
+        nativeTurnId: INTERRUPT_NATIVE_TURN,
+        prompt: INTERRUPT_PROMPT,
+      }),
+      {
+        type: "emit_inbound",
+        label: "item/completed/subAgentActivity-started",
+        frame: {
+          method: "item/completed",
+          params: {
+            item: {
+              type: "subAgentActivity",
+              id: "call-codex-interrupt-subagent",
+              kind: "started",
+              agentThreadId: INTERRUPT_CHILD_NATIVE_THREAD,
+              agentPath: "/root/stop_hold",
+            },
+            threadId: INTERRUPT_NATIVE_THREAD,
+            turnId: INTERRUPT_NATIVE_TURN,
+            completedAtMs: 1782622441000,
+          },
+        },
+      },
+      {
+        type: "emit_inbound",
+        label: "turn/started/child",
+        frame: {
+          method: "turn/started",
+          params: {
+            threadId: INTERRUPT_CHILD_NATIVE_THREAD,
+            turn: makeCodexReplayTurn({
+              id: INTERRUPT_CHILD_NATIVE_TURN,
+              status: "inProgress",
+            }),
+          },
+        },
+      },
+      {
+        type: "emit_inbound",
+        label: "item/started/child-command",
+        frame: {
+          method: "item/started",
+          params: {
+            item: {
+              ...interruptCommandItem("inProgress"),
+              id: INTERRUPT_CHILD_COMMAND_ITEM,
+              processId: "57682",
+            },
+            threadId: INTERRUPT_CHILD_NATIVE_THREAD,
+            turnId: INTERRUPT_CHILD_NATIVE_TURN,
+            startedAtMs: 1782622441500,
+          },
+        },
+      },
+      {
+        type: "expect_outbound",
+        label: "turn/interrupt/root",
+        frame: {
+          id: 4,
+          method: "turn/interrupt",
+          params: {
+            threadId: INTERRUPT_NATIVE_THREAD,
+            turnId: INTERRUPT_NATIVE_TURN,
+          },
+        },
+      },
+      {
+        type: "emit_inbound",
+        label: "turn/interrupt/root",
+        frame: { id: 4, result: {} },
+      },
+      {
+        type: "expect_outbound",
+        label: "turn/interrupt/child",
+        frame: {
+          id: 5,
+          method: "turn/interrupt",
+          params: {
+            threadId: INTERRUPT_CHILD_NATIVE_THREAD,
+            turnId: INTERRUPT_CHILD_NATIVE_TURN,
+          },
+        },
+      },
+      {
+        type: "emit_inbound",
+        label: "turn/interrupt/child",
+        frame: { id: 5, result: {} },
+      },
+      {
+        type: "expect_outbound",
+        label: "thread/backgroundTerminals/terminate/child",
+        frame: {
+          id: 6,
+          method: "thread/backgroundTerminals/terminate",
+          params: { threadId: INTERRUPT_CHILD_NATIVE_THREAD, processId: "57682" },
+        },
+      },
+      {
+        type: "emit_inbound",
+        label: "thread/backgroundTerminals/terminate/child",
+        frame: { id: 6, result: { terminated: true } },
+      },
+      {
+        type: "emit_inbound",
+        label: "turn/completed/root",
+        frame: {
+          method: "turn/completed",
+          params: {
+            threadId: INTERRUPT_NATIVE_THREAD,
+            turn: makeCodexReplayTurn({ id: INTERRUPT_NATIVE_TURN, status: "interrupted" }),
+          },
+        },
+      },
+      {
+        type: "emit_inbound",
+        label: "turn/completed/child-completed-race",
+        frame: {
+          method: "turn/completed",
+          params: {
+            threadId: INTERRUPT_CHILD_NATIVE_THREAD,
+            turn: makeCodexReplayTurn({
+              id: INTERRUPT_CHILD_NATIVE_TURN,
+              status: "completed",
+            }),
+          },
+        },
+      },
+      { type: "runtime_exit", status: "success" },
+    ],
+  });
+
+  const assertChildProviderTerminalBeforeRoot = (
+    events: ReadonlyArray<ProviderAdapterV2Event>,
+    rootThreadId: ThreadId,
+  ) => {
+    const terminalIndex = events.findIndex((event) => event.type === "turn.terminal");
+    const childProviderTurnIndex = events.findIndex(
+      (event) =>
+        event.type === "provider_turn.updated" &&
+        event.threadId !== rootThreadId &&
+        event.providerTurn.status === "interrupted",
+    );
+    const childProviderThreadIndex = events.findIndex(
+      (event) =>
+        event.type === "provider_thread.updated" &&
+        event.providerThread.appThreadId !== rootThreadId &&
+        event.providerThread.status === "idle",
+    );
+    assert.isAtLeast(childProviderTurnIndex, 0, "child provider turn must terminalize");
+    assert.isAtLeast(childProviderThreadIndex, 0, "child provider thread must become idle");
+    assert.isAbove(
+      terminalIndex,
+      childProviderTurnIndex,
+      "child provider turn must terminalize before the root run",
+    );
+    assert.isAbove(
+      terminalIndex,
+      childProviderThreadIndex,
+      "child provider thread must become idle before the root run",
+    );
+  };
+
+  it.effect("contains descendant commands and keeps Stop authoritative", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const harness = yield* makeCodexReplayHarness(interruptSubagentCommandTranscript);
+        const now = yield* DateTime.now;
+
+        yield* harness.runtime.startTurn(
+          makeCodexTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-codex-interrupt-subagent-command"),
+            text: INTERRUPT_PROMPT,
+          }),
+        );
+        yield* awaitUntil(
+          () =>
+            harness.events.some(
+              (event) =>
+                event.type === "turn_item.updated" &&
+                event.turnItem.type === "command_execution" &&
+                event.turnItem.nativeItemRef?.nativeId === INTERRUPT_CHILD_COMMAND_ITEM &&
+                event.turnItem.status === "running",
+            ),
+          "running child command item",
+        );
+        const providerTurnId = harness.events.find(
+          (event): event is Extract<ProviderAdapterV2Event, { type: "provider_turn.updated" }> =>
+            event.type === "provider_turn.updated" && event.threadId === harness.threadId,
+        )?.providerTurn.id;
+        assert.isDefined(providerTurnId);
+
+        yield* harness.runtime.interruptTurn({
+          providerThread: harness.providerThread,
+          providerTurnId,
+        });
+
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "interrupted root terminal");
+        assert.equal(harness.terminalEvents()[0]?.status, "interrupted");
+        const childCommandUpdates = harness.events.filter(
+          (event): event is Extract<ProviderAdapterV2Event, { type: "turn_item.updated" }> =>
+            event.type === "turn_item.updated" &&
+            event.turnItem.type === "command_execution" &&
+            event.turnItem.nativeItemRef?.nativeId === INTERRUPT_CHILD_COMMAND_ITEM,
+        );
+        assert.equal(childCommandUpdates.at(-1)?.turnItem.status, "interrupted");
+        assert.equal(harness.subagentUpdates().at(-1)?.subagent.status, "interrupted");
+        assertChildProviderTerminalBeforeRoot(harness.events, harness.threadId);
+        assert.isFalse(yield* harness.hasPendingBackgroundWork);
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  const childInterruptResponseIndex = interruptSubagentCommandTranscript.entries.findIndex(
+    (entry) => entry.type === "emit_inbound" && entry.label === "turn/interrupt/child",
+  );
+  const rootInterruptResponseIndex = interruptSubagentCommandTranscript.entries.findIndex(
+    (entry) => entry.type === "emit_inbound" && entry.label === "turn/interrupt/root",
+  );
+  const interruptSubagentRequestFailureTranscript = makeCodexReplayTranscript({
+    scenario: "codex-interrupt-subagent-request-failure",
+    entries: [
+      ...interruptSubagentCommandTranscript.entries.slice(0, rootInterruptResponseIndex + 1),
+      {
+        type: "emit_inbound",
+        label: "turn/completed/root-before-child-interrupt-failure",
+        frame: {
+          method: "turn/completed",
+          params: {
+            threadId: INTERRUPT_NATIVE_THREAD,
+            turn: makeCodexReplayTurn({ id: INTERRUPT_NATIVE_TURN, status: "interrupted" }),
+          },
+        },
+      },
+      ...interruptSubagentCommandTranscript.entries.slice(
+        rootInterruptResponseIndex + 1,
+        childInterruptResponseIndex,
+      ),
+      {
+        type: "emit_inbound",
+        label: "turn/interrupt/child",
+        frame: {
+          id: 5,
+          error: { code: -32_000, message: "child interrupt request failed" },
+        },
+      },
+      { type: "runtime_exit", status: "success" },
+    ],
+  });
+
+  it.effect("terminalizes descendants before the root when an interrupt request fails", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const harness = yield* makeCodexReplayHarness(interruptSubagentRequestFailureTranscript);
+        const now = yield* DateTime.now;
+
+        yield* harness.runtime.startTurn(
+          makeCodexTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-codex-interrupt-subagent-request-failure"),
+            text: INTERRUPT_PROMPT,
+          }),
+        );
+        yield* awaitUntil(
+          () =>
+            harness.events.some(
+              (event) =>
+                event.type === "turn_item.updated" &&
+                event.turnItem.type === "command_execution" &&
+                event.turnItem.nativeItemRef?.nativeId === INTERRUPT_CHILD_COMMAND_ITEM &&
+                event.turnItem.status === "running",
+            ),
+          "running child command item",
+        );
+        const providerTurnId = harness.events.find(
+          (event): event is Extract<ProviderAdapterV2Event, { type: "provider_turn.updated" }> =>
+            event.type === "provider_turn.updated" && event.threadId === harness.threadId,
+        )?.providerTurn.id;
+        assert.isDefined(providerTurnId);
+
+        const interruptExit = yield* harness.runtime
+          .interruptTurn({ providerThread: harness.providerThread, providerTurnId })
+          .pipe(Effect.exit);
+
+        assert.equal(interruptExit._tag, "Failure");
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "interrupted root terminal");
+        assertChildProviderTerminalBeforeRoot(harness.events, harness.threadId);
+        assert.isFalse(yield* harness.hasPendingBackgroundWork);
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  const childTerminationResponseIndex = interruptSubagentCommandTranscript.entries.findIndex(
+    (entry) =>
+      entry.type === "emit_inbound" && entry.label === "thread/backgroundTerminals/terminate/child",
+  );
+  const interruptSubagentTimeoutTranscript = makeCodexReplayTranscript({
+    scenario: "codex-interrupt-subagent-timeout",
+    entries: [
+      ...interruptSubagentCommandTranscript.entries.slice(0, childTerminationResponseIndex + 1),
+      {
+        type: "emit_inbound",
+        label: "item/started/child-timeout-boundary",
+        frame: {
+          method: "item/started",
+          params: {
+            item: {
+              ...interruptCommandItem("inProgress"),
+              id: INTERRUPT_CHILD_TIMEOUT_BOUNDARY_ITEM,
+              processId: null,
+            },
+            threadId: INTERRUPT_CHILD_NATIVE_THREAD,
+            turnId: INTERRUPT_CHILD_NATIVE_TURN,
+            startedAtMs: 1782622441600,
+          },
+        },
+      },
+    ],
+  });
+
+  it.effect("terminalizes timed-out descendants before the root", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const harness = yield* makeCodexReplayHarness(interruptSubagentTimeoutTranscript);
+        const now = yield* DateTime.now;
+
+        yield* harness.runtime.startTurn(
+          makeCodexTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-codex-interrupt-subagent-timeout"),
+            text: INTERRUPT_PROMPT,
+          }),
+        );
+        yield* awaitUntil(
+          () =>
+            harness.events.some(
+              (event) =>
+                event.type === "turn_item.updated" &&
+                event.turnItem.type === "command_execution" &&
+                event.turnItem.nativeItemRef?.nativeId === INTERRUPT_CHILD_COMMAND_ITEM &&
+                event.turnItem.status === "running",
+            ),
+          "running child command item",
+        );
+        const providerTurnId = harness.events.find(
+          (event): event is Extract<ProviderAdapterV2Event, { type: "provider_turn.updated" }> =>
+            event.type === "provider_turn.updated" && event.threadId === harness.threadId,
+        )?.providerTurn.id;
+        assert.isDefined(providerTurnId);
+
+        const interruptFiber = yield* harness.runtime
+          .interruptTurn({ providerThread: harness.providerThread, providerTurnId })
+          .pipe(Effect.forkScoped);
+        yield* awaitUntil(
+          () =>
+            harness.events.some(
+              (event) =>
+                event.type === "turn_item.updated" &&
+                event.turnItem.type === "command_execution" &&
+                event.turnItem.nativeItemRef?.nativeId === INTERRUPT_CHILD_TIMEOUT_BOUNDARY_ITEM &&
+                event.turnItem.status === "running",
+            ),
+          "child timeout boundary item",
+        );
+        yield* TestClock.adjust("10 seconds");
+        yield* Fiber.join(interruptFiber);
+
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "interrupted root terminal");
+        assertChildProviderTerminalBeforeRoot(harness.events, harness.threadId);
+        assert.isFalse(yield* harness.hasPendingBackgroundWork);
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  const rootCompletionIndex = interruptSubagentCommandTranscript.entries.findIndex(
+    (entry) => entry.type === "emit_inbound" && entry.label === "turn/completed/root",
+  );
+  const interruptLateSubagentTurnTranscript = makeCodexReplayTranscript({
+    scenario: "codex-interrupt-late-subagent-turn",
+    entries: [
+      ...interruptSubagentCommandTranscript.entries.slice(0, rootCompletionIndex),
+      {
+        type: "emit_inbound",
+        label: "turn/started/late-child",
+        frame: {
+          method: "turn/started",
+          params: {
+            threadId: INTERRUPT_CHILD_NATIVE_THREAD,
+            turn: makeCodexReplayTurn({
+              id: INTERRUPT_LATE_CHILD_NATIVE_TURN,
+              status: "inProgress",
+            }),
+          },
+        },
+      },
+      ...interruptSubagentCommandTranscript.entries.slice(rootCompletionIndex, -1),
+      {
+        type: "expect_outbound",
+        label: "turn/interrupt/late-child",
+        frame: {
+          id: 7,
+          method: "turn/interrupt",
+          params: {
+            threadId: INTERRUPT_CHILD_NATIVE_THREAD,
+            turnId: INTERRUPT_LATE_CHILD_NATIVE_TURN,
+          },
+        },
+      },
+      {
+        type: "emit_inbound",
+        label: "turn/interrupt/late-child",
+        frame: { id: 7, result: {} },
+      },
+      { type: "runtime_exit", status: "success" },
+    ],
+  });
+
+  it.effect("interrupts descendants that start after the initial Stop snapshot", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const harness = yield* makeCodexReplayHarness(interruptLateSubagentTurnTranscript);
+        const now = yield* DateTime.now;
+
+        yield* harness.runtime.startTurn(
+          makeCodexTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-codex-interrupt-late-subagent-turn"),
+            text: INTERRUPT_PROMPT,
+          }),
+        );
+        yield* awaitUntil(
+          () =>
+            harness.events.some(
+              (event) =>
+                event.type === "turn_item.updated" &&
+                event.turnItem.type === "command_execution" &&
+                event.turnItem.nativeItemRef?.nativeId === INTERRUPT_CHILD_COMMAND_ITEM &&
+                event.turnItem.status === "running",
+            ),
+          "running child command item",
+        );
+        const providerTurnId = harness.events.find(
+          (event): event is Extract<ProviderAdapterV2Event, { type: "provider_turn.updated" }> =>
+            event.type === "provider_turn.updated" && event.threadId === harness.threadId,
+        )?.providerTurn.id;
+        assert.isDefined(providerTurnId);
+
+        const interruptFiber = yield* harness.runtime
+          .interruptTurn({ providerThread: harness.providerThread, providerTurnId })
+          .pipe(Effect.forkScoped);
+        yield* awaitUntil(
+          () =>
+            harness.events.some(
+              (event) =>
+                event.type === "provider_turn.updated" &&
+                event.providerTurn.nativeTurnRef?.nativeId === INTERRUPT_LATE_CHILD_NATIVE_TURN,
+            ),
+          "late child provider turn",
+        );
+        yield* Fiber.join(interruptFiber);
+
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "interrupted root terminal");
+        const lateChildUpdates = harness.events.filter(
+          (event): event is Extract<ProviderAdapterV2Event, { type: "provider_turn.updated" }> =>
+            event.type === "provider_turn.updated" &&
+            event.providerTurn.nativeTurnRef?.nativeId === INTERRUPT_LATE_CHILD_NATIVE_TURN,
+        );
+        assert.equal(lateChildUpdates.at(-1)?.providerTurn.status, "interrupted");
+        assertChildProviderTerminalBeforeRoot(harness.events, harness.threadId);
+        assert.isFalse(yield* harness.hasPendingBackgroundWork);
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  const interruptRescanLateSubagentTurnTranscript = makeCodexReplayTranscript({
+    scenario: "codex-interrupt-rescan-late-subagent-turn",
+    entries: [
+      ...interruptSubagentCommandTranscript.entries.slice(0, childTerminationResponseIndex + 1),
+      {
+        type: "emit_inbound",
+        label: "turn/started/late-child-1",
+        frame: {
+          method: "turn/started",
+          params: {
+            threadId: INTERRUPT_CHILD_NATIVE_THREAD,
+            turn: makeCodexReplayTurn({
+              id: INTERRUPT_LATE_CHILD_NATIVE_TURN,
+              status: "inProgress",
+            }),
+          },
+        },
+      },
+      {
+        type: "expect_outbound",
+        label: "turn/interrupt/late-child-1",
+        frame: {
+          id: 7,
+          method: "turn/interrupt",
+          params: {
+            threadId: INTERRUPT_CHILD_NATIVE_THREAD,
+            turnId: INTERRUPT_LATE_CHILD_NATIVE_TURN,
+          },
+        },
+      },
+      {
+        type: "emit_inbound",
+        label: "turn/started/late-child-2",
+        frame: {
+          method: "turn/started",
+          params: {
+            threadId: INTERRUPT_CHILD_NATIVE_THREAD,
+            turn: makeCodexReplayTurn({
+              id: INTERRUPT_LATE_CHILD_2_NATIVE_TURN,
+              status: "inProgress",
+            }),
+          },
+        },
+      },
+      {
+        type: "emit_inbound",
+        label: "turn/interrupt/late-child-1",
+        frame: { id: 7, result: {} },
+      },
+      {
+        type: "expect_outbound",
+        label: "turn/interrupt/late-child-2",
+        frame: {
+          id: 8,
+          method: "turn/interrupt",
+          params: {
+            threadId: INTERRUPT_CHILD_NATIVE_THREAD,
+            turnId: INTERRUPT_LATE_CHILD_2_NATIVE_TURN,
+          },
+        },
+      },
+      {
+        type: "emit_inbound",
+        label: "turn/interrupt/late-child-2",
+        frame: { id: 8, result: {} },
+      },
+      { type: "runtime_exit", status: "success" },
+    ],
+  });
+
+  it.effect("interrupts descendants discovered only by the final interrupt rescan", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const harness = yield* makeCodexReplayHarness(interruptRescanLateSubagentTurnTranscript);
+        const now = yield* DateTime.now;
+
+        yield* harness.runtime.startTurn(
+          makeCodexTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-codex-interrupt-rescan-late-subagent-turn"),
+            text: INTERRUPT_PROMPT,
+          }),
+        );
+        yield* awaitUntil(
+          () =>
+            harness.events.some(
+              (event) =>
+                event.type === "turn_item.updated" &&
+                event.turnItem.type === "command_execution" &&
+                event.turnItem.nativeItemRef?.nativeId === INTERRUPT_CHILD_COMMAND_ITEM &&
+                event.turnItem.status === "running",
+            ),
+          "running child command item",
+        );
+        const providerTurnId = harness.events.find(
+          (event): event is Extract<ProviderAdapterV2Event, { type: "provider_turn.updated" }> =>
+            event.type === "provider_turn.updated" && event.threadId === harness.threadId,
+        )?.providerTurn.id;
+        assert.isDefined(providerTurnId);
+
+        const interruptFiber = yield* harness.runtime
+          .interruptTurn({ providerThread: harness.providerThread, providerTurnId })
+          .pipe(Effect.forkScoped);
+        yield* awaitUntil(
+          () =>
+            harness.events.some(
+              (event) =>
+                event.type === "provider_turn.updated" &&
+                event.providerTurn.nativeTurnRef?.nativeId === INTERRUPT_LATE_CHILD_NATIVE_TURN,
+            ),
+          "late child 1 provider turn",
+        );
+        yield* TestClock.adjust("10 seconds");
+        yield* Fiber.join(interruptFiber);
+
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "interrupted root terminal");
+        assert.equal(harness.terminalEvents()[0]?.status, "interrupted");
+
+        const rootTerminalIndex = harness.events.findIndex(
+          (event) => event.type === "turn.terminal",
+        );
+        const lateChild1InterruptedIndex = harness.events.findIndex(
+          (event) =>
+            event.type === "provider_turn.updated" &&
+            event.providerTurn.nativeTurnRef?.nativeId === INTERRUPT_LATE_CHILD_NATIVE_TURN &&
+            event.providerTurn.status === "interrupted",
+        );
+        const lateChild2InterruptedIndex = harness.events.findIndex(
+          (event) =>
+            event.type === "provider_turn.updated" &&
+            event.providerTurn.nativeTurnRef?.nativeId === INTERRUPT_LATE_CHILD_2_NATIVE_TURN &&
+            event.providerTurn.status === "interrupted",
+        );
+        assert.isAtLeast(
+          lateChild1InterruptedIndex,
+          0,
+          "late child 1 must terminalize interrupted",
+        );
+        assert.isAtLeast(
+          lateChild2InterruptedIndex,
+          0,
+          "late child 2 must terminalize interrupted",
+        );
+        assert.isAbove(
+          rootTerminalIndex,
+          lateChild1InterruptedIndex,
+          "late child 1 must terminalize before the root run",
+        );
+        assert.isAbove(
+          rootTerminalIndex,
+          lateChild2InterruptedIndex,
+          "late child 2 must terminalize before the root run",
+        );
+        assertChildProviderTerminalBeforeRoot(harness.events, harness.threadId);
+        assert.isFalse(yield* harness.hasPendingBackgroundWork);
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  const interruptTimeoutTranscript = makeCodexReplayTranscript({
+    scenario: "codex-interrupt-timeout",
+    entries: [
+      ...codexReplayPreamble({
+        nativeThreadId: INTERRUPT_NATIVE_THREAD,
+        nativeTurnId: INTERRUPT_NATIVE_TURN,
+        prompt: INTERRUPT_PROMPT,
+      }),
+      {
+        type: "emit_inbound",
+        label: "item/started/command",
+        frame: {
+          method: "item/started",
+          params: {
+            item: interruptCommandItem("inProgress"),
+            threadId: INTERRUPT_NATIVE_THREAD,
+            turnId: INTERRUPT_NATIVE_TURN,
+            startedAtMs: 1782622440500,
+          },
+        },
+      },
+      {
+        type: "expect_outbound",
+        label: "turn/interrupt",
+        frame: {
+          id: 4,
+          method: "turn/interrupt",
+          params: {
+            threadId: INTERRUPT_NATIVE_THREAD,
+            turnId: INTERRUPT_NATIVE_TURN,
+          },
+        },
+      },
+      {
+        type: "emit_inbound",
+        label: "turn/interrupt",
+        frame: { id: 4, result: {} },
+      },
+      {
+        type: "emit_inbound",
+        label: "item/started/command-two-after-interrupt-response",
+        frame: {
+          method: "item/started",
+          params: {
+            item: {
+              ...interruptCommandItem("inProgress"),
+              id: INTERRUPT_COMMAND_ITEM_TWO,
+              command: INTERRUPT_COMMAND_TWO,
+              processId: "57681",
+              commandActions: [{ type: "unknown", command: INTERRUPT_COMMAND_TWO }],
+            },
+            threadId: INTERRUPT_NATIVE_THREAD,
+            turnId: INTERRUPT_NATIVE_TURN,
+            startedAtMs: 1782622440600,
+          },
+        },
+      },
+      {
+        type: "expect_outbound",
+        label: "thread/backgroundTerminals/terminate/one",
+        frame: {
+          id: 5,
+          method: "thread/backgroundTerminals/terminate",
+          params: { threadId: INTERRUPT_NATIVE_THREAD, processId: "57680" },
+        },
+      },
+      {
+        type: "emit_inbound",
+        label: "thread/backgroundTerminals/terminate/one",
+        frame: { id: 5, result: { terminated: true } },
+      },
+      {
+        type: "emit_inbound",
+        label: "item/started/command-at-timeout-boundary",
+        afterMs: 9_999,
+        frame: {
+          method: "item/started",
+          params: {
+            item: {
+              ...interruptCommandItem("inProgress"),
+              id: INTERRUPT_TIMEOUT_BOUNDARY_ITEM,
+              command: "echo TIMEOUT_BOUNDARY",
+              processId: null,
+              commandActions: [{ type: "unknown", command: "echo TIMEOUT_BOUNDARY" }],
+            },
+            threadId: INTERRUPT_NATIVE_THREAD,
+            turnId: INTERRUPT_NATIVE_TURN,
+            startedAtMs: 1782622450500,
+          },
+        },
+      },
+      {
+        type: "expect_outbound",
+        label: "thread/backgroundTerminals/terminate/two",
+        frame: {
+          id: 6,
+          method: "thread/backgroundTerminals/terminate",
+          params: { threadId: INTERRUPT_NATIVE_THREAD, processId: "57681" },
+        },
+      },
+      {
+        type: "emit_inbound",
+        label: "thread/backgroundTerminals/terminate/two",
+        frame: { id: 6, result: { terminated: true } },
+      },
+      {
+        type: "emit_inbound",
+        label: "turn/completed/late",
+        afterMs: 20_000,
+        frame: {
+          method: "turn/completed",
+          params: {
+            threadId: INTERRUPT_NATIVE_THREAD,
+            turn: makeCodexReplayTurn({
+              id: INTERRUPT_NATIVE_TURN,
+              status: "interrupted",
+            }),
+          },
+        },
+      },
+      {
+        type: "emit_inbound",
+        label: "item/started/command-after-timeout",
+        frame: {
+          method: "item/started",
+          params: {
+            item: {
+              ...interruptCommandItem("inProgress"),
+              id: INTERRUPT_TIMEOUT_LATE_ITEM,
+              command: "echo LATE_AFTER_TIMEOUT",
+              processId: null,
+              commandActions: [{ type: "unknown", command: "echo LATE_AFTER_TIMEOUT" }],
+            },
+            threadId: INTERRUPT_NATIVE_THREAD,
+            turnId: INTERRUPT_NATIVE_TURN,
+            startedAtMs: 1782622470500,
+          },
+        },
+      },
+      {
+        type: "emit_inbound",
+        label: "item/completed/command-late",
+        frame: {
+          method: "item/completed",
+          params: {
+            item: interruptCommandItem("completed"),
+            threadId: INTERRUPT_NATIVE_THREAD,
+            turnId: INTERRUPT_NATIVE_TURN,
+            completedAtMs: 1782622465500,
+          },
+        },
+      },
+      { type: "runtime_exit", status: "success" },
+    ],
+  });
+
+  it.effect("bounds interrupt settlement and drops late completion events", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const harness = yield* makeCodexReplayHarness(interruptTimeoutTranscript);
+        const now = yield* DateTime.now;
+
+        yield* harness.runtime.startTurn(
+          makeCodexTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-codex-interrupt-timeout"),
+            text: INTERRUPT_PROMPT,
+          }),
+        );
+        yield* awaitUntil(
+          () =>
+            harness.events.filter(
+              (event) =>
+                event.type === "turn_item.updated" &&
+                event.turnItem.type === "command_execution" &&
+                event.turnItem.status === "running",
+            ).length === 1,
+          "running command item",
+        );
+        const providerTurnId = harness.events.find(
+          (event): event is Extract<ProviderAdapterV2Event, { type: "provider_turn.updated" }> =>
+            event.type === "provider_turn.updated",
+        )?.providerTurn.id;
+        assert.isDefined(providerTurnId);
+
+        const interruptFiber = yield* harness.runtime
+          .interruptTurn({
+            providerThread: harness.providerThread,
+            providerTurnId,
+          })
+          .pipe(Effect.forkScoped);
+        yield* awaitUntil(
+          () =>
+            harness.events.filter(
+              (event) =>
+                event.type === "turn_item.updated" &&
+                event.turnItem.type === "command_execution" &&
+                event.turnItem.status === "running",
+            ).length === 2,
+          "post-interrupt running command item",
+        );
+
+        yield* TestClock.adjust("10 seconds");
+        yield* Fiber.join(interruptFiber);
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "timeout terminal");
+        assert.equal(harness.terminalEvents()[0]?.status, "interrupted");
+        const terminalProviderTurnsBeforeLateEvents = harness.events.filter(
+          (event) =>
+            event.type === "provider_turn.updated" && event.providerTurn.status === "interrupted",
+        );
+        assert.lengthOf(terminalProviderTurnsBeforeLateEvents, 1);
+
+        const commandUpdatesBeforeLateEvents = harness.events.filter(
+          (event): event is Extract<ProviderAdapterV2Event, { type: "turn_item.updated" }> =>
+            event.type === "turn_item.updated" && event.turnItem.type === "command_execution",
+        );
+        const terminalCommands = commandUpdatesBeforeLateEvents.filter(
+          (event) =>
+            event.turnItem.status === "interrupted" &&
+            event.turnItem.nativeItemRef?.nativeId !== INTERRUPT_TIMEOUT_BOUNDARY_ITEM,
+        );
+        assert.lengthOf(terminalCommands, 2);
+        const boundaryUpdates = commandUpdatesBeforeLateEvents.filter(
+          (event) => event.turnItem.nativeItemRef?.nativeId === INTERRUPT_TIMEOUT_BOUNDARY_ITEM,
+        );
+        const lastBoundaryUpdate = boundaryUpdates.at(-1);
+        assert.isDefined(lastBoundaryUpdate);
+        assert.equal(lastBoundaryUpdate.turnItem.status, "interrupted");
+        assert.isFalse(yield* harness.hasPendingBackgroundWork);
+
+        yield* TestClock.adjust("20 seconds");
+        for (let attempt = 0; attempt < 100; attempt++) {
+          yield* Effect.yieldNow;
+        }
+        assert.lengthOf(harness.terminalEvents(), 1);
+        assert.lengthOf(
+          harness.events.filter(
+            (event) =>
+              event.type === "provider_turn.updated" && event.providerTurn.status === "interrupted",
+          ),
+          terminalProviderTurnsBeforeLateEvents.length,
+          "late completion must not duplicate provider-turn finalization",
+        );
+        assert.lengthOf(
+          harness.events.filter(
+            (event) =>
+              event.type === "turn_item.updated" && event.turnItem.type === "command_execution",
+          ),
+          commandUpdatesBeforeLateEvents.length,
+          "late starts and completions must not project after timeout",
+        );
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  const interruptTerminationFailureTranscript = makeCodexReplayTranscript({
+    scenario: "codex-interrupt-termination-failure",
+    entries: [
+      ...interruptMidCommandTranscript.entries
+        .filter(
+          (entry) => entry.type === "runtime_exit" || entry.label !== "item/completed/command-late",
+        )
+        .map((entry) =>
+          entry.type === "emit_inbound" &&
+          entry.label === "thread/backgroundTerminals/list/after-false"
+            ? {
+                ...entry,
+                frame: {
+                  id: 6,
+                  result: {
+                    data: [{ processId: "57680" }],
+                    nextCursor: null,
+                  },
+                },
+              }
+            : entry,
+        ),
+      {
+        type: "expect_outbound",
+        label: "thread/backgroundTerminals/terminate/one-retry",
+        frame: {
+          id: 8,
+          method: "thread/backgroundTerminals/terminate",
+          params: { threadId: INTERRUPT_NATIVE_THREAD, processId: "57680" },
+        },
+      },
+      {
+        type: "emit_inbound",
+        label: "thread/backgroundTerminals/terminate/one-retry",
+        frame: { id: 8, result: { terminated: false } },
+      },
+      {
+        type: "expect_outbound",
+        label: "thread/backgroundTerminals/list/after-false-retry",
+        frame: {
+          id: 9,
+          method: "thread/backgroundTerminals/list",
+          params: { threadId: INTERRUPT_NATIVE_THREAD },
+        },
+      },
+      {
+        type: "emit_inbound",
+        label: "thread/backgroundTerminals/list/after-false-retry",
+        frame: {
+          id: 9,
+          result: { data: [{ processId: "57680" }], nextCursor: null },
+        },
+      },
+      { type: "runtime_exit", status: "success" },
+    ],
+  });
+
+  it.effect("attempts every terminal and cleans up tracking when termination fails", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const harness = yield* makeCodexReplayHarness(interruptTerminationFailureTranscript);
+        const now = yield* DateTime.now;
+
+        yield* harness.runtime.startTurn(
+          makeCodexTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-codex-interrupt-termination-failure"),
+            text: INTERRUPT_PROMPT,
+          }),
+        );
+        yield* awaitUntil(
+          () =>
+            harness.events.some(
+              (event) =>
+                event.type === "turn_item.updated" &&
+                event.turnItem.type === "command_execution" &&
+                event.turnItem.status === "running",
+            ),
+          "running command item",
+        );
+        const providerTurnId = harness.events.find(
+          (event): event is Extract<ProviderAdapterV2Event, { type: "provider_turn.updated" }> =>
+            event.type === "provider_turn.updated",
+        )?.providerTurn.id;
+        assert.isDefined(providerTurnId);
+
+        const interruptExit = yield* harness.runtime
+          .interruptTurn({
+            providerThread: harness.providerThread,
+            providerTurnId,
+          })
+          .pipe(Effect.exit);
+
+        assert.equal(interruptExit._tag, "Failure");
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "interrupted terminal");
+        assert.equal(harness.terminalEvents()[0]?.status, "interrupted");
+        assert.isFalse(yield* harness.hasPendingBackgroundWork);
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  const FAILED_SCENARIO = "codex-failed-mid-command";
+  const FAILED_NATIVE_THREAD = "native-codex-failed-thread";
+  const FAILED_NATIVE_TURN = "native-codex-failed-turn";
+  const FAILED_COMMAND_ITEM = "exec-codex-failed-command";
+  const FAILED_COMMAND = "sleep 30";
+  const FAILED_PROMPT = "Run a command that will be abandoned when the turn fails.";
+
+  const failedMidCommandTranscript = makeCodexReplayTranscript({
+    scenario: FAILED_SCENARIO,
+    entries: [
+      ...codexReplayPreamble({
+        nativeThreadId: FAILED_NATIVE_THREAD,
+        nativeTurnId: FAILED_NATIVE_TURN,
+        prompt: FAILED_PROMPT,
+      }),
+      {
+        type: "emit_inbound",
+        label: "item/started/command",
+        frame: {
+          method: "item/started",
+          params: {
+            item: {
+              type: "commandExecution",
+              id: FAILED_COMMAND_ITEM,
+              command: FAILED_COMMAND,
+              cwd: "/workspace",
+              processId: "99",
+              source: "unifiedExecStartup",
+              status: "inProgress",
+              commandActions: [{ type: "unknown", command: FAILED_COMMAND }],
+              aggregatedOutput: null,
+              exitCode: null,
+              durationMs: null,
+            },
+            threadId: FAILED_NATIVE_THREAD,
+            turnId: FAILED_NATIVE_TURN,
+            startedAtMs: 1782622440500,
+          },
+        },
+      },
+      {
+        type: "emit_inbound",
+        label: "turn/completed",
+        frame: {
+          method: "turn/completed",
+          params: {
+            threadId: FAILED_NATIVE_THREAD,
+            turn: {
+              ...makeCodexReplayTurn({
+                id: FAILED_NATIVE_TURN,
+                status: "failed",
+              }),
+              error: { message: "provider failed mid-command" },
+            },
+          },
+        },
+      },
+    ],
+  });
+
+  it.effect("terminalizes running command items before turn.terminal on failed turns", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const harness = yield* makeCodexReplayHarness(failedMidCommandTranscript);
+        const now = yield* DateTime.now;
+
+        yield* harness.runtime.startTurn(
+          makeCodexTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-codex-failed-mid-command"),
+            text: FAILED_PROMPT,
+          }),
+        );
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "failed terminal");
+        assert.equal(harness.terminalEvents()[0]?.status, "failed");
+
+        const terminalIndex = harness.events.findIndex((event) => event.type === "turn.terminal");
+        const failedCommandIndex = harness.events.findIndex(
+          (event, index) =>
+            index < terminalIndex &&
+            event.type === "turn_item.updated" &&
+            event.turnItem.type === "command_execution" &&
+            event.turnItem.status === "failed",
+        );
+        assert.isAtLeast(failedCommandIndex, 0);
+        assert.isAbove(
+          terminalIndex,
+          failedCommandIndex,
+          "failed-turn command terminalization must precede turn.terminal",
+        );
+        assert.isFalse(yield* harness.hasPendingBackgroundWork);
+        assert.lengthOf(harness.continuationRequests, 0);
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+
+  const RESUME_SCENARIO = "codex-resume-subagent";
+  const RESUME_NATIVE_THREAD = "native-codex-resume-thread";
+  const RESUME_NATIVE_TURN = "native-codex-resume-root-turn";
+  const RESUME_CHILD_THREAD = "native-codex-resume-child-thread";
+  const RESUME_CHILD_TURN_1 = "native-codex-resume-child-turn-1";
+  const RESUME_CHILD_TURN_2 = "native-codex-resume-child-turn-2";
+  const RESUME_PROMPT = "Spawn a sub-agent, nudge it, and reply NUDGED.";
+
+  const childAgentMessage = (input: {
+    readonly id: string;
+    readonly text: string;
+    readonly turnId: string;
+    readonly completedAtMs: number;
+    readonly afterMs?: number;
+    readonly omitPhase?: boolean;
+  }): CodexReplay.CodexAppServerReplayEntry => ({
+    type: "emit_inbound",
+    label: `item/completed/${input.id}`,
+    ...(input.afterMs === undefined ? {} : { afterMs: input.afterMs }),
+    frame: {
+      method: "item/completed",
+      params: {
+        item: {
+          type: "agentMessage",
+          id: input.id,
+          text: input.text,
+          ...(input.omitPhase ? {} : { phase: "final_answer" as const }),
+          memoryCitation: null,
+        },
+        threadId: RESUME_CHILD_THREAD,
+        turnId: input.turnId,
+        completedAtMs: input.completedAtMs,
+      },
+    },
+  });
+
+  const childTurnStarted = (
+    turnId: string,
+    afterMs?: number,
+  ): CodexReplay.CodexAppServerReplayEntry => ({
+    type: "emit_inbound",
+    label: `turn/started/${turnId}`,
+    ...(afterMs === undefined ? {} : { afterMs }),
+    frame: {
+      method: "turn/started",
+      params: {
+        threadId: RESUME_CHILD_THREAD,
+        turn: makeCodexReplayTurn({ id: turnId, status: "inProgress" }),
+      },
+    },
+  });
+
+  const childTurnCompleted = (
+    turnId: string,
+    afterMs?: number,
+  ): CodexReplay.CodexAppServerReplayEntry => ({
+    type: "emit_inbound",
+    label: `turn/completed/${turnId}`,
+    ...(afterMs === undefined ? {} : { afterMs }),
+    frame: {
+      method: "turn/completed",
+      params: {
+        threadId: RESUME_CHILD_THREAD,
+        turn: makeCodexReplayTurn({ id: turnId, status: "completed" }),
+      },
+    },
+  });
+
+  const resumeSubagentTranscript = makeCodexReplayTranscript({
+    scenario: RESUME_SCENARIO,
+    entries: [
+      ...codexReplayPreamble({
+        nativeThreadId: RESUME_NATIVE_THREAD,
+        nativeTurnId: RESUME_NATIVE_TURN,
+        prompt: RESUME_PROMPT,
+      }),
+      {
+        type: "emit_inbound",
+        label: "item/completed/subAgentActivity-started",
+        frame: {
+          method: "item/completed",
+          params: {
+            item: {
+              type: "subAgentActivity",
+              id: "call-codex-resume-spawn",
+              kind: "started",
+              agentThreadId: RESUME_CHILD_THREAD,
+              agentPath: "/root/resume_agent",
+            },
+            threadId: RESUME_NATIVE_THREAD,
+            turnId: RESUME_NATIVE_TURN,
+            completedAtMs: 1782622441000,
+          },
+        },
+      },
+      childTurnStarted(RESUME_CHILD_TURN_1),
+      childAgentMessage({
+        id: "child-first-answer",
+        text: "CODEX_FIRST_DONE",
+        turnId: RESUME_CHILD_TURN_1,
+        completedAtMs: 1782622442000,
+      }),
+      childAgentMessage({
+        id: "child-first-answer-empty",
+        text: "",
+        turnId: RESUME_CHILD_TURN_1,
+        completedAtMs: 1782622442001,
+        omitPhase: true,
+      }),
+      childAgentMessage({
+        id: "child-first-answer-duplicate",
+        text: "CODEX_FIRST_DONE",
+        turnId: RESUME_CHILD_TURN_1,
+        completedAtMs: 1782622442002,
+      }),
+      childTurnCompleted(RESUME_CHILD_TURN_1, 100),
+      {
+        type: "emit_inbound",
+        label: "item/completed/root-answer",
+        frame: {
+          method: "item/completed",
+          params: {
+            item: {
+              type: "agentMessage",
+              id: "root-answer-resume",
+              text: "NUDGED",
+              phase: "final_answer",
+              memoryCitation: null,
+            },
+            threadId: RESUME_NATIVE_THREAD,
+            turnId: RESUME_NATIVE_TURN,
+            completedAtMs: 1782622443000,
+          },
+        },
+      },
+      {
+        type: "emit_inbound",
+        label: "turn/completed/root",
+        frame: {
+          method: "turn/completed",
+          params: {
+            threadId: RESUME_NATIVE_THREAD,
+            turn: makeCodexReplayTurn({ id: RESUME_NATIVE_TURN, status: "completed" }),
+          },
+        },
+      },
+      childTurnStarted(RESUME_CHILD_TURN_2, 30_000),
+      childAgentMessage({
+        id: "child-resume-answer",
+        text: "CODEX_RESUME_DONE",
+        turnId: RESUME_CHILD_TURN_2,
+        completedAtMs: 1782622480000,
+        afterMs: 30_000,
+      }),
+      childTurnCompleted(RESUME_CHILD_TURN_2),
+    ],
+  });
+
+  it.effect("preserves a subagent result across a trailing empty final and resume", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const harness = yield* makeCodexReplayHarness(resumeSubagentTranscript);
+        const now = yield* DateTime.now;
+
+        yield* harness.runtime.startTurn(
+          makeCodexTestTurnInput({
+            threadId: harness.threadId,
+            providerThread: harness.providerThread,
+            now,
+            attemptId: RunAttemptId.make("attempt-codex-resume"),
+            text: RESUME_PROMPT,
+          }),
+        );
+        yield* awaitUntil(
+          () =>
+            harness.subagentUpdates().some((event) => event.subagent.result === "CODEX_FIRST_DONE"),
+          "first subagent result",
+        );
+        assert.lengthOf(
+          harness.subagentUpdates().filter((event) => event.subagent.result === "CODEX_FIRST_DONE"),
+          1,
+        );
+        yield* TestClock.adjust("100 millis");
+        yield* awaitUntil(() => harness.terminalEvents().length === 1, "root turn terminal");
+        assert.equal(harness.terminalEvents()[0]?.status, "completed");
+        const settledUpdates = harness.subagentUpdates();
+        const firstCompletion = settledUpdates[settledUpdates.length - 1];
+        assert.equal(firstCompletion?.subagent.status, "completed");
+        assert.equal(firstCompletion?.subagent.result, "CODEX_FIRST_DONE");
+        assert.isFalse(yield* harness.hasPendingBackgroundWork);
+        const settledUpdateCount = settledUpdates.length;
+
+        yield* TestClock.adjust("30 seconds");
+        yield* awaitUntil(
+          () => harness.subagentUpdates().length > settledUpdateCount,
+          "subagent re-open",
+        );
+        const reopened = harness.subagentUpdates()[settledUpdateCount];
+        assert.equal(reopened?.subagent.status, "running");
+        assert.isTrue(yield* harness.hasPendingBackgroundWork);
+
+        yield* TestClock.adjust("30 seconds");
+        yield* awaitUntil(() => {
+          const updates = harness.subagentUpdates();
+          const latest = updates[updates.length - 1];
+          return (
+            latest !== undefined &&
+            latest.subagent.status === "completed" &&
+            latest.subagent.result === "CODEX_RESUME_DONE"
+          );
+        }, "resumed subagent completion");
+        assert.isFalse(yield* harness.hasPendingBackgroundWork);
+        assert.lengthOf(harness.terminalEvents(), 1);
+        assert.lengthOf(harness.continuationRequests, 0);
+      }).pipe(Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer))),
+    ),
+  );
+});
diff --git a/apps/server/src/orchestration-v2/Adapters/CodexAdapterV2.testkit.ts b/apps/server/src/orchestration-v2/Adapters/CodexAdapterV2.testkit.ts
new file mode 100644
index 000000000000..e6105184b72c
--- /dev/null
+++ b/apps/server/src/orchestration-v2/Adapters/CodexAdapterV2.testkit.ts
@@ -0,0 +1,237 @@
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import { type ProviderReplayTranscript } from "@t3tools/contracts";
+import * as CodexClient from "effect-codex-app-server/client";
+import * as CodexReplay from "effect-codex-app-server/replay";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Layer from "effect/Layer";
+import * as Path from "effect/Path";
+import * as PlatformError from "effect/PlatformError";
+import * as Schema from "effect/Schema";
+
+import { ServerConfig } from "../../config.ts";
+import { layer as idAllocatorLayer } from "../IdAllocator.ts";
+import { ProviderAdapterOpenSessionError } from "../ProviderAdapter.ts";
+import { ProviderAdapterDriverCreateError } from "../ProviderAdapterDriver.ts";
+import { makeDriverLayer as makeProviderAdapterRegistryDriverLayer } from "../ProviderAdapterRegistry.ts";
+import type { OrchestratorV2ProviderReplayHarness } from "../testkit/ProviderReplayHarness.ts";
+import type { ProviderReplayGate } from "../testkit/ProviderReplayGate.testkit.ts";
+import {
+  CODEX_DEFAULT_INSTANCE_ID,
+  CODEX_DRIVER_KIND,
+  CodexAdapterV2Driver,
+  CodexAppServerClientFactory,
+} from "./CodexAdapterV2.ts";
+
+export class CodexReplayTranscriptDecodeError extends Schema.TaggedErrorClass<CodexReplayTranscriptDecodeError>()(
+  "CodexReplayTranscriptDecodeError",
+  {
+    driver: Schema.optional(Schema.String),
+    protocol: Schema.optional(Schema.String),
+    scenario: Schema.optional(Schema.String),
+    cause: Schema.Defect(),
+  },
+) {
+  override get message(): string {
+    return `Failed to decode Codex app-server replay transcript for scenario ${this.scenario ?? "<unknown>"}.`;
+  }
+}
+
+export const CodexOrchestratorReplayHarnessError = Schema.Union([
+  CodexReplayTranscriptDecodeError,
+  CodexReplay.CodexAppServerReplayError,
+  ProviderAdapterDriverCreateError,
+]);
+export type CodexOrchestratorReplayHarnessError = typeof CodexOrchestratorReplayHarnessError.Type;
+
+function metadataFromTranscript(transcript: ProviderReplayTranscript): {
+  readonly provider?: string;
+  readonly protocol?: string;
+  readonly scenario?: string;
+} {
+  return {
+    provider: transcript.provider,
+    protocol: transcript.protocol,
+    scenario: transcript.scenario,
+  };
+}
+
+export function makeReplayServerConfig(
+  scenario: string,
+): Effect.Effect<
+  ServerConfig["Service"],
+  PlatformError.PlatformError,
+  FileSystem.FileSystem | Path.Path
+> {
+  return Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const baseDir = yield* fs.makeTempDirectory({
+      prefix: `t3-orchestration-v2-codex-${scenario}-`,
+    });
+    const stateDir = path.join(baseDir, "userdata");
+    const logsDir = path.join(stateDir, "logs");
+    const providerLogsDir = path.join(logsDir, "provider");
+    const terminalLogsDir = path.join(logsDir, "terminals");
+    const attachmentsDir = path.join(stateDir, "attachments");
+    const environmentThemesDir = path.join(stateDir, "themes");
+    const worktreesDir = path.join(baseDir, "worktrees");
+    const providerStatusCacheDir = path.join(baseDir, "caches");
+
+    for (const directory of [
+      stateDir,
+      logsDir,
+      providerLogsDir,
+      terminalLogsDir,
+      attachmentsDir,
+      environmentThemesDir,
+      worktreesDir,
+      providerStatusCacheDir,
+    ]) {
+      yield* fs.makeDirectory(directory, { recursive: true });
+    }
+
+    return {
+      logLevel: "Error",
+      traceMinLevel: "Info",
+      traceTimingEnabled: true,
+      traceBatchWindowMs: 200,
+      traceMaxBytes: 10 * 1024 * 1024,
+      traceMaxFiles: 10,
+      otlpTracesUrl: undefined,
+      otlpMetricsUrl: undefined,
+      otlpExportIntervalMs: 10_000,
+      otlpServiceName: "t3-server",
+      mode: "web",
+      port: 0,
+      host: undefined,
+      cwd: process.cwd(),
+      baseDir,
+      staticDir: undefined,
+      devUrl: undefined,
+      devAllowedOrigins: [],
+      noBrowser: false,
+      startupPresentation: "browser",
+      tailscaleServeEnabled: false,
+      tailscaleServePort: 443,
+      desktopBootstrapToken: undefined,
+      autoBootstrapProjectFromCwd: false,
+      logWebSocketEvents: false,
+      stateDir,
+      dbPath: path.join(stateDir, "state.sqlite"),
+      keybindingsConfigPath: path.join(stateDir, "keybindings.json"),
+      settingsPath: path.join(stateDir, "settings.json"),
+      providerStatusCacheDir,
+      worktreesDir,
+      attachmentsDir,
+      environmentThemesDir,
+      logsDir,
+      serverLogPath: path.join(logsDir, "server.log"),
+      serverTracePath: path.join(logsDir, "server.trace.ndjson"),
+      providerLogsDir,
+      providerEventLogPath: path.join(providerLogsDir, "events.log"),
+      terminalLogsDir,
+      anonymousIdPath: path.join(stateDir, "anonymous-id"),
+      environmentIdPath: path.join(stateDir, "environment-id"),
+      serverRuntimeStatePath: path.join(stateDir, "server-runtime.json"),
+      secretsDir: path.join(stateDir, "secrets"),
+    };
+  });
+}
+
+export function makeCodexProviderAdapterRegistryReplayLayer(input: {
+  readonly transcript: CodexReplay.CodexAppServerReplayTranscript;
+  readonly driver?: CodexReplay.CodexAppServerReplayDriver;
+}) {
+  const replayLayer =
+    input.driver === undefined
+      ? CodexReplay.layerReplay(input.transcript)
+      : CodexReplay.layerReplayWithDriver(input.driver);
+  const replayClientFactoryLayer = Layer.succeed(CodexAppServerClientFactory, {
+    open: (openInput) =>
+      Effect.gen(function* () {
+        const context = yield* Layer.build(replayLayer).pipe(
+          Effect.mapError(
+            (cause) =>
+              new ProviderAdapterOpenSessionError({
+                driver: CODEX_DRIVER_KIND,
+                providerSessionId: openInput.providerSessionId,
+                cause,
+              }),
+          ),
+        );
+        return yield* Effect.service(CodexClient.CodexAppServerClient).pipe(
+          Effect.provide(context),
+        );
+      }),
+  });
+  const serverConfigLayer = Layer.effect(
+    ServerConfig,
+    makeReplayServerConfig(input.transcript.scenario).pipe(Effect.orDie),
+  ).pipe(Layer.provide(NodeServices.layer));
+  const registryLayer = makeProviderAdapterRegistryDriverLayer({
+    drivers: [CodexAdapterV2Driver],
+    configMap: {
+      [CODEX_DEFAULT_INSTANCE_ID]: {
+        driver: CODEX_DRIVER_KIND,
+      },
+    },
+  }).pipe(
+    Layer.provide(
+      Layer.mergeAll(
+        replayClientFactoryLayer,
+        serverConfigLayer,
+        NodeServices.layer,
+        idAllocatorLayer,
+      ),
+    ),
+  );
+
+  return registryLayer;
+}
+
+const decodeCodexAppServerReplayTranscript = Schema.decodeUnknownEffect(
+  CodexReplay.CodexAppServerReplayTranscript,
+);
+
+export const CodexOrchestratorReplayHarness: OrchestratorV2ProviderReplayHarness<
+  CodexReplay.CodexAppServerReplayTranscript,
+  CodexOrchestratorReplayHarnessError
+> = {
+  driver: CODEX_DRIVER_KIND,
+  decodeTranscript: (transcript) =>
+    decodeCodexAppServerReplayTranscript(transcript).pipe(
+      Effect.mapError(
+        (cause) =>
+          new CodexReplayTranscriptDecodeError({
+            ...metadataFromTranscript(transcript),
+            cause,
+          }),
+      ),
+    ),
+  makeProviderAdapterRegistryLayer: (
+    transcript,
+    options: { readonly replayGate?: ProviderReplayGate } = {},
+  ) => {
+    return Layer.effectContext(
+      Effect.gen(function* () {
+        const replayGate = options.replayGate;
+        if (replayGate !== undefined) {
+          yield* Effect.addFinalizer(() => Effect.sync(() => replayGate.releaseAll()));
+        }
+        const driver = yield* CodexReplay.makeReplayDriver(
+          transcript,
+          replayGate === undefined
+            ? {}
+            : {
+                beforeEmitInbound: (entry) =>
+                  Effect.promise((signal) => replayGate.beforeEmit(entry.label, signal)),
+              },
+        );
+        return yield* Layer.build(
+          makeCodexProviderAdapterRegistryReplayLayer({ transcript, driver }),
+        );
+      }),
+    );
+  },
+};
diff --git a/apps/server/src/orchestration-v2/Adapters/CodexAdapterV2.ts b/apps/server/src/orchestration-v2/Adapters/CodexAdapterV2.ts
new file mode 100644
index 000000000000..90e498146f84
--- /dev/null
+++ b/apps/server/src/orchestration-v2/Adapters/CodexAdapterV2.ts
@@ -0,0 +1,5261 @@
+import { CodexSettings, defaultInstanceIdForDriver, ProviderDriverKind } from "@t3tools/contracts";
+import { HostProcessEnvironment } from "@t3tools/shared/hostProcess";
+import { getModelSelectionStringOptionValue } from "@t3tools/shared/model";
+import { resolveSpawnCommand } from "@t3tools/shared/shell";
+import type {
+  ChatAttachment,
+  OrchestrationV2AppThread,
+  OrchestrationV2ConversationMessage,
+  OrchestrationV2ExecutionNode,
+  ModelSelection,
+  OrchestrationV2PlanArtifact,
+  OrchestrationV2ProviderCapabilities,
+  OrchestrationV2ProviderFailure,
+  OrchestrationV2ProviderRetry,
+  OrchestrationV2ProviderSession,
+  OrchestrationV2ProviderThread,
+  OrchestrationV2ProviderTurn,
+  OrchestrationV2PlanStep,
+  OrchestrationV2RuntimeRequest,
+  OrchestrationV2Subagent,
+  OrchestrationV2TurnItem,
+  ProviderUserInputAnswers,
+  ProviderApprovalDecision,
+  ProviderApprovalOption,
+  ProviderRequestKind,
+  ProviderTurnId,
+  ProviderInstanceId,
+  RuntimeMode,
+  RuntimeRequestId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as CodexClient from "effect-codex-app-server/client";
+import * as CodexSchema from "effect-codex-app-server/schema";
+import * as Context from "effect/Context";
+import * as DateTime from "effect/DateTime";
+import * as Deferred from "effect/Deferred";
+import * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+import * as Queue from "effect/Queue";
+import * as Ref from "effect/Ref";
+import * as Schema from "effect/Schema";
+import * as Scope from "effect/Scope";
+import * as Semaphore from "effect/Semaphore";
+import * as Stream from "effect/Stream";
+import { ChildProcess, ChildProcessSpawner } from "effect/unstable/process";
+
+import { resolveAttachmentPath } from "../../attachmentStore.ts";
+import { getCodexServiceTierOptionValue } from "../../codexModelOptions.ts";
+import {
+  describeMcpElicitation,
+  toMcpElicitationResponse,
+} from "../../provider/Layers/CodexSessionRuntime.ts";
+import { ServerConfig } from "../../config.ts";
+import {
+  codexDefaultModeDeveloperInstructions,
+  codexPlanModeDeveloperInstructions,
+} from "../../provider/CodexDeveloperInstructions.ts";
+import {
+  materializeCodexShadowHome,
+  resolveCodexHomeLayout,
+} from "../../provider/Drivers/CodexHomeLayout.ts";
+import type { EventNdjsonLogger } from "../../provider/Layers/EventNdjsonLogger.ts";
+import { ProviderEventLoggers } from "../../provider/Layers/ProviderEventLoggers.ts";
+import { mergeProviderInstanceEnvironment } from "../../provider/ProviderInstanceEnvironment.ts";
+import * as McpProviderSession from "../../mcp/McpProviderSession.ts";
+import {
+  ProviderAdapterDriverCreateError,
+  type ProviderAdapterDriver,
+} from "../ProviderAdapterDriver.ts";
+import { IdAllocatorV2, type IdAllocatorV2Shape } from "../IdAllocator.ts";
+import {
+  type ProviderContinuationRequest,
+  ProviderContinuationRequests,
+} from "../ProviderContinuationRequests.ts";
+import { makeProviderFailure, makeProviderRetryTurnItem } from "../ProviderFailure.ts";
+import { turnScopedSelectionTransition } from "../ProviderSelectionTransition.ts";
+import {
+  isProviderNativeImageAttachment,
+  providerMessageTextWithAttachmentPaths,
+} from "../AttachmentPrompt.ts";
+import {
+  ProviderAdapterEnsureThreadError,
+  ProviderAdapterForkThreadError,
+  ProviderAdapterInterruptError,
+  ProviderAdapterOpenSessionError,
+  ProviderAdapterProtocolError,
+  ProviderAdapterReadThreadSnapshotError,
+  ProviderAdapterResumeThreadError,
+  ProviderAdapterRollbackThreadError,
+  ProviderAdapterRuntimeRequestResponseError,
+  ProviderAdapterSteerRunError,
+  ProviderAdapterTurnStartError,
+  ProviderAdapterV2,
+  type ProviderAdapterV2Shape,
+  type ProviderAdapterV2Event,
+  type ProviderAdapterV2ForkThreadInput,
+  type ProviderAdapterV2RollbackThreadInput,
+  type ProviderAdapterV2RuntimePolicy,
+  type ProviderAdapterV2SessionRuntime,
+  type ProviderAdapterV2SteerInput,
+  type ProviderAdapterV2TurnInput,
+} from "../ProviderAdapter.ts";
+import {
+  makeSubagentChildThread,
+  makeSubagentConversationArtifacts,
+  subagentThreadTitle,
+} from "../SubagentProjection.ts";
+
+const CODEX_PROVIDER = ProviderDriverKind.make("codex");
+export const CODEX_DRIVER_KIND = CODEX_PROVIDER;
+export const CODEX_DEFAULT_INSTANCE_ID = defaultInstanceIdForDriver(CODEX_DRIVER_KIND);
+
+export function codexProviderTurnTokenUsage(
+  tokenUsage: CodexSchema.V2ThreadTokenUsageUpdatedNotification["tokenUsage"],
+  updatedAt: string,
+) {
+  return {
+    usedTokens: Math.max(0, tokenUsage.last.totalTokens),
+    maxTokens: tokenUsage.modelContextWindow ?? null,
+    inputTokens: Math.max(0, tokenUsage.last.inputTokens),
+    cachedInputTokens: Math.max(0, tokenUsage.last.cachedInputTokens),
+    outputTokens: Math.max(0, tokenUsage.last.outputTokens),
+    reasoningOutputTokens: Math.max(0, tokenUsage.last.reasoningOutputTokens),
+    updatedAt,
+  };
+}
+const DEFAULT_CODEX_SETTINGS = Schema.decodeSync(CodexSettings)({});
+const CODEX_ASSISTANT_DELTA_FLUSH_INTERVAL_MS = 50;
+const CodexBackgroundTerminalTerminateResponse = Schema.Struct({
+  terminated: Schema.Boolean,
+});
+const CodexBackgroundTerminalsListResponse = Schema.Struct({
+  data: Schema.Array(
+    Schema.Struct({
+      processId: Schema.String,
+    }),
+  ),
+  nextCursor: Schema.NullOr(Schema.String),
+});
+type CodexBackgroundTerminalsListPage = typeof CodexBackgroundTerminalsListResponse.Type;
+const decodeCodexBackgroundTerminalTerminateResponse = Schema.decodeUnknownEffect(
+  CodexBackgroundTerminalTerminateResponse,
+);
+const decodeCodexBackgroundTerminalsListResponse = Schema.decodeUnknownEffect(
+  CodexBackgroundTerminalsListResponse,
+);
+const CODEX_CLIENT_INFO = {
+  name: "t3code_desktop",
+  title: "T3 Code Desktop",
+  version: "0.1.0",
+} as const;
+const CODEX_CLIENT_CAPABILITIES = {
+  experimentalApi: true,
+} as const;
+
+export const CodexProviderCapabilitiesV2 = {
+  sessions: {
+    supportsMultipleProviderThreadsPerSession: true,
+    supportsModelSwitchInSession: true,
+    supportsProviderSwitchingViaHandoff: true,
+    supportsRuntimeModeSwitchInSession: true,
+    pendingRequestsSurviveRestart: false,
+  },
+  threads: {
+    canCreateEmptyThread: true,
+    canReadThreadSnapshot: true,
+    canRollbackThread: true,
+    canForkThread: true,
+    canForkFromTurn: true,
+    canForkFromSubagentThread: true,
+    exposesNativeThreadId: true,
+  },
+  turns: {
+    exposesNativeTurnId: true,
+    emitsTurnStarted: true,
+    emitsTurnCompleted: true,
+    supportsInterrupt: true,
+    supportsActiveSteering: true,
+    supportsSteeringByInterruptRestart: true,
+    supportsQueuedMessages: true,
+    terminalStatusQuality: "strong",
+  },
+  streaming: {
+    streamsAssistantText: true,
+    streamsReasoning: true,
+    streamsToolOutput: true,
+    streamsPlanText: true,
+    emitsMessageCompleted: true,
+  },
+  tools: {
+    exposesToolItemIds: true,
+    emitsToolStarted: true,
+    emitsToolCompleted: true,
+    emitsToolOutput: true,
+    supportsMcpTools: true,
+    supportsDynamicToolCallbacks: true,
+  },
+  approvals: {
+    supportsCommandApproval: true,
+    supportsFileReadApproval: true,
+    supportsFileChangeApproval: true,
+    supportsApplyPatchApproval: true,
+    approvalsHaveNativeRequestIds: true,
+    approvalCallbacksAreLiveOnly: true,
+    approvalsCanOriginateFromSubagents: true,
+  },
+  planning: {
+    emitsPlanUpdated: true,
+    emitsTodoList: true,
+    emitsProposedPlan: true,
+    supportsStructuredQuestions: true,
+    planDeltasHaveItemIds: true,
+  },
+  subagents: {
+    supportsSubagents: true,
+    exposesSubagentThreadIds: true,
+    emitsSubagentLifecycle: true,
+    canWaitForSubagents: true,
+    canCloseSubagents: true,
+    canForkSubagentThread: true,
+  },
+  context: {
+    acceptsSystemContext: true,
+    acceptsDeveloperContext: true,
+    acceptsSyntheticUserContext: true,
+    canGenerateSummaries: true,
+    canConsumeHandoffSummaries: true,
+    supportsDeltaHandoff: true,
+    supportsFullThreadHandoff: true,
+    maxRecommendedHandoffChars: null,
+  },
+  checkpointing: {
+    appCanCheckpointFilesystem: true,
+    supportsNestedCheckpointScopes: true,
+    providerCanRollbackConversation: true,
+    providerRollbackReturnsSnapshot: true,
+    providerCanReadConversationSnapshot: true,
+  },
+  identity: {
+    nativeThreadIds: "strong",
+    nativeTurnIds: "strong",
+    nativeItemIds: "strong",
+    nativeRequestIds: "strong",
+  },
+} satisfies OrchestrationV2ProviderCapabilities;
+
+function toProtocolError(detail: string, payload?: unknown): ProviderAdapterProtocolError {
+  return new ProviderAdapterProtocolError({
+    driver: CODEX_PROVIDER,
+    detail,
+    ...(payload === undefined ? {} : { payload }),
+  });
+}
+
+function normalizeCodexCause(error: unknown): unknown {
+  return error;
+}
+
+function codexTimestamp(seconds: number | null | undefined): DateTime.Utc {
+  return seconds === null || seconds === undefined
+    ? DateTime.nowUnsafe()
+    : DateTime.makeUnsafe(seconds * 1000);
+}
+
+function codexUserMessageText(
+  content: ReadonlyArray<CodexSchema.V2ItemCompletedNotification__UserInput>,
+): string {
+  return content
+    .flatMap((item) => (item.type === "text" ? [item.text] : []))
+    .join("\n")
+    .trim();
+}
+
+function mapCodexTurnStatus(
+  status: CodexSchema.V2TurnCompletedNotification__TurnStatus,
+): OrchestrationV2ProviderTurn["status"] {
+  switch (status) {
+    case "completed":
+      return "completed";
+    case "interrupted":
+      return "interrupted";
+    case "failed":
+      return "failed";
+    case "inProgress":
+      return "running";
+  }
+}
+
+function providerTurnStatusToTerminal(
+  status: OrchestrationV2ProviderTurn["status"],
+): Extract<ProviderAdapterV2Event, { type: "turn.terminal" }>["status"] {
+  switch (status) {
+    case "completed":
+      return "completed";
+    case "interrupted":
+      return "interrupted";
+    case "failed":
+      return "failed";
+    case "cancelled":
+      return "cancelled";
+    case "pending":
+    case "running":
+      return "failed";
+  }
+}
+
+function codexItemStatus(status: "inProgress" | "completed" | "failed" | "declined"): {
+  readonly node: OrchestrationV2ExecutionNode["status"];
+  readonly turnItem: OrchestrationV2TurnItem["status"];
+  readonly completed: boolean;
+} {
+  switch (status) {
+    case "inProgress":
+      return { node: "running", turnItem: "running", completed: false };
+    case "completed":
+      return {
+        node: "completed",
+        turnItem: "completed",
+        completed: true,
+      };
+    case "failed":
+      return { node: "failed", turnItem: "failed", completed: true };
+    case "declined":
+      return {
+        node: "cancelled",
+        turnItem: "cancelled",
+        completed: true,
+      };
+  }
+}
+
+const BACKGROUND_COMMAND_DETAIL_COMMAND_MAX_LENGTH = 200;
+const BACKGROUND_COMMAND_DETAIL_OUTPUT_TAIL_MAX_LENGTH = 1_000;
+
+export function codexBackgroundCommandDetail(item: {
+  readonly command: string;
+  readonly exitCode?: number | null | undefined;
+  readonly aggregatedOutput?: string | null | undefined;
+}): string {
+  const command =
+    item.command.length > BACKGROUND_COMMAND_DETAIL_COMMAND_MAX_LENGTH
+      ? `${item.command.slice(0, BACKGROUND_COMMAND_DETAIL_COMMAND_MAX_LENGTH)}...`
+      : item.command;
+  const exit =
+    item.exitCode === null || item.exitCode === undefined ? "" : ` (exit ${item.exitCode})`;
+  const output = (item.aggregatedOutput ?? "").trimEnd();
+  const outputTail =
+    output.length > BACKGROUND_COMMAND_DETAIL_OUTPUT_TAIL_MAX_LENGTH
+      ? `...${output.slice(-BACKGROUND_COMMAND_DETAIL_OUTPUT_TAIL_MAX_LENGTH)}`
+      : output;
+  const header = `Background command completed${exit}: ${command}`;
+  return outputTail.length === 0 ? header : `${header}\n\nOutput tail:\n${outputTail}`;
+}
+
+export interface CodexDynamicToolProjection {
+  readonly toolName: string;
+  readonly input: unknown;
+  readonly output?: unknown;
+  readonly status: OrchestrationV2TurnItem["status"];
+}
+
+function codexMcpToolOutput(
+  item: Extract<CodexDynamicToolItem, { readonly type: "mcpToolCall" }>,
+): unknown | undefined {
+  const resultOutput =
+    item.result === null || item.result === undefined
+      ? undefined
+      : item.result.structuredContent !== null && item.result.structuredContent !== undefined
+        ? item.result.structuredContent
+        : item.result.content;
+
+  if (item.error === null || item.error === undefined) {
+    return resultOutput;
+  }
+  return resultOutput === undefined
+    ? { error: item.error.message }
+    : { error: item.error.message, result: resultOutput };
+}
+
+function codexDynamicToolOutput(
+  item: Extract<CodexDynamicToolItem, { readonly type: "dynamicToolCall" }>,
+): unknown | undefined {
+  if (item.contentItems !== null && item.contentItems !== undefined) {
+    return item.contentItems;
+  }
+  return item.success === false ? { success: false } : undefined;
+}
+
+export function projectCodexDynamicToolItem(
+  item: CodexDynamicToolItem,
+): CodexDynamicToolProjection {
+  const output =
+    item.type === "mcpToolCall" ? codexMcpToolOutput(item) : codexDynamicToolOutput(item);
+  const toolName =
+    item.type === "mcpToolCall"
+      ? `${item.server}.${item.tool}`
+      : [trimText(item.namespace), item.tool].filter(Boolean).join(".");
+  const projection: CodexDynamicToolProjection = {
+    toolName,
+    input: item.arguments,
+    status: codexItemStatus(item.status).turnItem,
+  };
+  return output === undefined ? projection : { ...projection, output };
+}
+
+function codexNativeItemRef(nativeItemId: string) {
+  return {
+    driver: CODEX_PROVIDER,
+    nativeId: nativeItemId,
+    strength: "strong" as const,
+  };
+}
+
+function trimText(value: string | null | undefined): string | undefined {
+  const trimmed = value?.trim();
+  return trimmed && trimmed.length > 0 ? trimmed : undefined;
+}
+
+function nonEmptyText(value: string | null | undefined, fallback: string): string {
+  return trimText(value) ?? fallback;
+}
+
+function codexPlanStepStatus(
+  status: CodexSchema.V2TurnPlanUpdatedNotification__TurnPlanStepStatus,
+): OrchestrationV2PlanStep["status"] {
+  switch (status) {
+    case "completed":
+      return "completed";
+    case "inProgress":
+      return "running";
+    case "pending":
+      return "pending";
+  }
+}
+
+function approvalDecisionToLegacyReviewDecision(
+  decision: ProviderApprovalDecision,
+): CodexSchema.ExecCommandApprovalResponse__ReviewDecision {
+  switch (decision) {
+    case "accept":
+      return "approved";
+    case "acceptForSession":
+    case "acceptAlways":
+      return "approved_for_session";
+    case "decline":
+      return "denied";
+    case "cancel":
+      return "abort";
+  }
+}
+
+function providerRequestKindFromPermissions(
+  permissions: CodexSchema.PermissionsRequestApprovalParams["permissions"],
+): ProviderRequestKind {
+  if ((permissions.fileSystem?.write?.length ?? 0) > 0) {
+    return "file-change";
+  }
+  if ((permissions.fileSystem?.read?.length ?? 0) > 0) {
+    return "file-read";
+  }
+  return "command";
+}
+
+function permissionsResponseFromDecision(input: {
+  readonly decision: ProviderApprovalDecision;
+  readonly permissions: CodexSchema.PermissionsRequestApprovalParams["permissions"];
+}): CodexSchema.PermissionsRequestApprovalResponse {
+  if (input.decision !== "accept" && input.decision !== "acceptForSession") {
+    return { permissions: {}, scope: "turn" };
+  }
+
+  return {
+    permissions: input.permissions,
+    scope: input.decision === "acceptForSession" ? "session" : "turn",
+  };
+}
+
+function answerValueToStrings(value: unknown): ReadonlyArray<string> {
+  if (Array.isArray(value)) {
+    return value.map((item) => String(item));
+  }
+  if (typeof value === "string") {
+    return [value];
+  }
+  if (value === null || value === undefined) {
+    return [];
+  }
+  if (typeof value === "number" || typeof value === "boolean") {
+    return [String(value)];
+  }
+  return [JSON.stringify(value)];
+}
+
+function toCodexUserInputAnswers(
+  answers: ProviderUserInputAnswers,
+  allowedQuestionIds: ReadonlySet<string>,
+): CodexSchema.ToolRequestUserInputResponse["answers"] {
+  return Object.fromEntries(
+    Object.entries(answers).flatMap(([questionId, value]) =>
+      allowedQuestionIds.has(questionId)
+        ? [[questionId, { answers: [...answerValueToStrings(value)] }]]
+        : [],
+    ),
+  );
+}
+
+function compactStrings(values: ReadonlyArray<string | null | undefined>): ReadonlyArray<string> {
+  return values.flatMap((value) => {
+    const trimmed = trimText(value);
+    return trimmed === undefined ? [] : [trimmed];
+  });
+}
+
+function webSearchPatterns(item: CodexWebSearchItem): ReadonlyArray<string> {
+  if (item.action === null || item.action === undefined) {
+    return compactStrings([item.query]);
+  }
+
+  switch (item.action.type) {
+    case "search":
+      return compactStrings([...(item.action.queries ?? []), item.action.query, item.query]);
+    case "openPage":
+      return compactStrings([item.action.url, item.query]);
+    case "findInPage":
+      return compactStrings([item.action.pattern, item.action.url, item.query]);
+    case "other":
+      return compactStrings([item.query]);
+  }
+}
+
+const decodeTurnApprovalPolicy = Schema.decodeUnknownEffect(
+  Schema.Union([CodexSchema.V2TurnStartParams__AskForApproval, Schema.Null]),
+);
+const decodeTurnSandboxPolicy = Schema.decodeUnknownEffect(
+  Schema.Union([CodexSchema.V2TurnStartParams__SandboxPolicy, Schema.Null]),
+);
+const decodeTurnReasoningEffort = Schema.decodeUnknownEffect(
+  Schema.Union([CodexSchema.V2TurnStartParams__ReasoningEffort, Schema.Null]),
+);
+
+const CodexTurnStartParamsWithCollaborationMode = CodexSchema.V2TurnStartParams.pipe(
+  Schema.fieldsAssign({
+    collaborationMode: Schema.optionalKey(CodexSchema.ClientRequest__CollaborationMode),
+  }),
+);
+type CodexTurnStartParamsWithCollaborationMode =
+  typeof CodexTurnStartParamsWithCollaborationMode.Type;
+const decodeCodexTurnStartParamsWithCollaborationMode = Schema.decodeUnknownEffect(
+  CodexTurnStartParamsWithCollaborationMode,
+);
+const isProviderAdapterRuntimeRequestResponseError = Schema.is(
+  ProviderAdapterRuntimeRequestResponseError,
+);
+
+function codexRuntimeModeTurnDefaults(runtimeMode: RuntimeMode): {
+  readonly approvalPolicy: CodexSchema.V2TurnStartParams__AskForApproval;
+  readonly approvalsReviewer: CodexSchema.V2TurnStartParams__ApprovalsReviewer;
+  readonly sandboxPolicy: CodexSchema.V2TurnStartParams__SandboxPolicy;
+} {
+  switch (runtimeMode) {
+    case "approval-required":
+      return {
+        approvalPolicy: "untrusted",
+        approvalsReviewer: "user",
+        sandboxPolicy: {
+          type: "readOnly",
+        },
+      };
+    case "auto-accept-edits":
+      return {
+        approvalPolicy: "on-request",
+        approvalsReviewer: "user",
+        sandboxPolicy: {
+          type: "workspaceWrite",
+        },
+      };
+    case "auto":
+      return {
+        approvalPolicy: "on-request",
+        approvalsReviewer: "auto_review",
+        sandboxPolicy: {
+          type: "workspaceWrite",
+        },
+      };
+    case "full-access":
+      return {
+        approvalPolicy: "never",
+        approvalsReviewer: "user",
+        sandboxPolicy: {
+          type: "dangerFullAccess",
+        },
+      };
+  }
+}
+
+export function buildCodexTurnStartParams(input: {
+  readonly nativeThreadId: string;
+  readonly codexInput: ReadonlyArray<CodexSchema.V2TurnStartParams__UserInput>;
+  readonly runtimePolicy: ProviderAdapterV2RuntimePolicy;
+  readonly modelSelection: ModelSelection;
+  readonly hasT3Mcp?: boolean;
+  readonly browserToolsAvailable?: boolean;
+}) {
+  return Effect.gen(function* () {
+    const runtimeModeDefaults = codexRuntimeModeTurnDefaults(input.runtimePolicy.runtimeMode);
+    const approvalPolicy =
+      input.runtimePolicy.approvalPolicy === undefined
+        ? runtimeModeDefaults.approvalPolicy
+        : yield* decodeTurnApprovalPolicy(input.runtimePolicy.approvalPolicy);
+    const sandboxPolicy =
+      input.runtimePolicy.sandboxPolicy === undefined
+        ? runtimeModeDefaults.sandboxPolicy
+        : yield* decodeTurnSandboxPolicy(input.runtimePolicy.sandboxPolicy);
+    const selectedEffort = getModelSelectionStringOptionValue(
+      input.modelSelection,
+      "reasoningEffort",
+    );
+    const effort =
+      selectedEffort === undefined ? undefined : yield* decodeTurnReasoningEffort(selectedEffort);
+    const serviceTier = getCodexServiceTierOptionValue(input.modelSelection);
+    const developerInstructions =
+      input.hasT3Mcp !== true
+        ? undefined
+        : input.runtimePolicy.interactionMode === "plan"
+          ? codexPlanModeDeveloperInstructions(input.browserToolsAvailable ?? true)
+          : codexDefaultModeDeveloperInstructions(input.browserToolsAvailable ?? true);
+    const collaborationMode: CodexSchema.ClientRequest__CollaborationMode | undefined =
+      input.runtimePolicy.interactionMode !== "plan" && developerInstructions === undefined
+        ? undefined
+        : {
+            mode: input.runtimePolicy.interactionMode === "plan" ? "plan" : "default",
+            settings: {
+              model: input.modelSelection.model,
+              reasoning_effort: effort ?? "medium",
+              ...(developerInstructions === undefined
+                ? {}
+                : { developer_instructions: developerInstructions }),
+            },
+          };
+
+    return yield* decodeCodexTurnStartParamsWithCollaborationMode({
+      threadId: input.nativeThreadId,
+      input: input.codexInput,
+      cwd: input.runtimePolicy.cwd,
+      model: input.modelSelection.model,
+      // Always explicit: omitting this on resume leaves Codex's previous
+      // reviewer sticky after switching away from Auto mode.
+      approvalsReviewer: runtimeModeDefaults.approvalsReviewer,
+      ...(approvalPolicy === undefined ? {} : { approvalPolicy }),
+      ...(sandboxPolicy === undefined ? {} : { sandboxPolicy }),
+      ...(effort === undefined ? {} : { effort }),
+      ...(serviceTier === undefined ? {} : { serviceTier }),
+      ...(collaborationMode === undefined ? {} : { collaborationMode }),
+    });
+  });
+}
+
+function providerSession(input: {
+  readonly providerSessionId: OrchestrationV2ProviderSession["id"];
+  readonly providerInstanceId: ProviderInstanceId;
+  readonly cwd: string | null;
+  readonly model: string;
+  readonly now: DateTime.Utc;
+}): OrchestrationV2ProviderSession {
+  return {
+    id: input.providerSessionId,
+    driver: CODEX_PROVIDER,
+    providerInstanceId: input.providerInstanceId,
+    status: "ready",
+    cwd: input.cwd ?? process.cwd(),
+    model: input.model,
+    capabilities: CodexProviderCapabilitiesV2,
+    createdAt: input.now,
+    updatedAt: input.now,
+    lastError: null,
+  };
+}
+
+function getNativeThreadId(providerThread: OrchestrationV2ProviderThread) {
+  return Effect.gen(function* () {
+    const nativeThreadId = providerThread.nativeThreadRef?.nativeId;
+    if (nativeThreadId === undefined || nativeThreadId === null) {
+      return yield* toProtocolError(
+        `Provider thread ${providerThread.id} is missing a native Codex thread id.`,
+      );
+    }
+    return nativeThreadId;
+  });
+}
+
+function providerThreadFromCodexThread(input: {
+  readonly appThreadId: ThreadId | null;
+  readonly idAllocator: IdAllocatorV2Shape;
+  readonly ownerNodeId: OrchestrationV2ProviderThread["ownerNodeId"];
+  readonly providerSessionId: OrchestrationV2ProviderThread["providerSessionId"];
+  readonly providerInstanceId: ProviderInstanceId;
+  readonly thread: {
+    readonly createdAt: number;
+    readonly forkedFromId?: string | null;
+    readonly id: string;
+    readonly updatedAt: number;
+  };
+  readonly forkedFrom?: OrchestrationV2ProviderThread["forkedFrom"];
+}): OrchestrationV2ProviderThread {
+  return {
+    id: input.idAllocator.derive.providerThread({
+      driver: CODEX_PROVIDER,
+      nativeThreadId: input.thread.id,
+    }),
+    driver: CODEX_PROVIDER,
+    providerInstanceId: input.providerInstanceId,
+    providerSessionId: input.providerSessionId,
+    appThreadId: input.appThreadId,
+    ownerNodeId: input.ownerNodeId,
+    nativeThreadRef: {
+      driver: CODEX_PROVIDER,
+      nativeId: input.thread.id,
+      strength: "strong" as const,
+    },
+    nativeConversationHeadRef: null,
+    status: "idle",
+    firstRunOrdinal: null,
+    lastRunOrdinal: null,
+    handoffIds: [],
+    forkedFrom: input.forkedFrom ?? null,
+    createdAt: codexTimestamp(input.thread.createdAt),
+    updatedAt: codexTimestamp(input.thread.updatedAt),
+  };
+}
+
+const isTerminalProviderTurn = (turn: OrchestrationV2ProviderTurn): boolean =>
+  turn.status === "completed" ||
+  turn.status === "interrupted" ||
+  turn.status === "failed" ||
+  turn.status === "cancelled";
+
+const providerTurnsForThread = (
+  providerTurns: ReadonlyArray<OrchestrationV2ProviderTurn>,
+  providerThread: OrchestrationV2ProviderThread,
+): ReadonlyArray<OrchestrationV2ProviderTurn> =>
+  providerTurns.filter((turn) => turn.providerThreadId === providerThread.id);
+
+const countTerminalTurnsAfterBoundary = (
+  providerTurns: ReadonlyArray<OrchestrationV2ProviderTurn>,
+  providerTurnId: ProviderTurnId,
+): number | null => {
+  const boundaryTurn = providerTurns.find((turn) => turn.id === providerTurnId);
+  if (boundaryTurn === undefined) {
+    return null;
+  }
+
+  return providerTurns.filter(
+    (turn) => turn.ordinal > boundaryTurn.ordinal && isTerminalProviderTurn(turn),
+  ).length;
+};
+
+const resolveCodexForkRollbackTurnCount = Effect.fn("CodexAdapterV2.resolveForkRollbackTurnCount")(
+  function* (input: ProviderAdapterV2ForkThreadInput) {
+    if (input.providerTurnId === undefined || input.sourceProviderTurns === undefined) {
+      return 0;
+    }
+
+    const rollbackTurnCount = countTerminalTurnsAfterBoundary(
+      providerTurnsForThread(input.sourceProviderTurns, input.sourceProviderThread),
+      input.providerTurnId,
+    );
+    if (rollbackTurnCount === null) {
+      return yield* new ProviderAdapterForkThreadError({
+        driver: CODEX_PROVIDER,
+        providerThreadId: input.sourceProviderThread.id,
+        cause: `Cannot fork Codex thread from provider turn ${input.providerTurnId}: source turn was not found in provider thread ${input.sourceProviderThread.id}.`,
+      });
+    }
+
+    return rollbackTurnCount;
+  },
+);
+
+export const resolveCodexRollbackTurnCount = Effect.fn("CodexAdapterV2.resolveRollbackTurnCount")(
+  function* (input: ProviderAdapterV2RollbackThreadInput) {
+    const providerTurns = input.providerThreadTurns;
+    switch (input.target.type) {
+      case "thread_start":
+        return providerTurns.filter(isTerminalProviderTurn).length;
+      case "provider_turn": {
+        if (input.target.providerTurn.providerThreadId !== input.providerThread.id) {
+          return yield* new ProviderAdapterRollbackThreadError({
+            driver: CODEX_PROVIDER,
+            providerThreadId: input.providerThread.id,
+            cause: `Cannot roll back Codex thread ${input.providerThread.id} to provider turn ${input.target.providerTurn.id}: target turn belongs to provider thread ${input.target.providerTurn.providerThreadId}.`,
+          });
+        }
+
+        const rollbackTurnCount = countTerminalTurnsAfterBoundary(
+          providerTurns,
+          input.target.providerTurn.id,
+        );
+        if (rollbackTurnCount === null) {
+          return yield* new ProviderAdapterRollbackThreadError({
+            driver: CODEX_PROVIDER,
+            providerThreadId: input.providerThread.id,
+            cause: `Cannot roll back Codex thread ${input.providerThread.id} to provider turn ${input.target.providerTurn.id}: target turn was not found in durable provider turn history.`,
+          });
+        }
+
+        return rollbackTurnCount;
+      }
+    }
+  },
+);
+
+export function parseCodexRetryProgress(
+  message: string,
+): Pick<OrchestrationV2ProviderRetry, "attempt" | "maxAttempts"> | null {
+  const match = /\b(\d+)\s*\/\s*(\d+)\b/u.exec(message);
+  if (match?.[1] === undefined || match[2] === undefined) {
+    return null;
+  }
+  const attempt = Number.parseInt(match[1], 10);
+  const maxAttempts = Number.parseInt(match[2], 10);
+  if (attempt < 1 || maxAttempts < 1) {
+    return null;
+  }
+  return { attempt, maxAttempts };
+}
+
+function codexErrorInfoCode(value: unknown): string | null {
+  if (typeof value === "string") {
+    return value;
+  }
+  if (typeof value !== "object" || value === null) {
+    return null;
+  }
+  return Object.keys(value)[0] ?? null;
+}
+
+interface ActiveCodexTurnContext {
+  readonly input: ProviderAdapterV2TurnInput;
+  readonly projectionAppThread: OrchestrationV2AppThread;
+  readonly projectionThreadId: ThreadId;
+  readonly projectionRunId: ProviderAdapterV2TurnInput["runId"] | null;
+  readonly nativeTurnId: string;
+  readonly providerThread: OrchestrationV2ProviderThread;
+  readonly providerTurnId: ProviderTurnId;
+  readonly providerTurnOrdinal: number;
+  readonly providerNodeId: OrchestrationV2ExecutionNode["id"];
+  readonly providerNodeKind: OrchestrationV2ExecutionNode["kind"];
+  readonly providerNodeStartedAt: DateTime.Utc | null;
+  readonly itemParentNodeId: OrchestrationV2ExecutionNode["id"];
+  readonly rootNodeId: OrchestrationV2ExecutionNode["id"];
+  readonly subagent: CodexSubagentThreadContext | null;
+  readonly startedAt: DateTime.Utc;
+}
+
+interface ActiveCodexProviderRetry {
+  readonly retry: OrchestrationV2ProviderRetry;
+  readonly failure: OrchestrationV2ProviderFailure;
+  readonly startedAt: DateTime.Utc;
+  readonly itemOrdinal: number;
+}
+
+/** Snapshot of a still-running commandExecution item for interrupt/fail terminalization. */
+interface TrackedRunningCommandItem {
+  readonly id: string;
+  readonly command: string;
+  readonly aggregatedOutput?: string;
+  readonly processId?: string;
+}
+
+type CodexRootTerminalEvent = Extract<ProviderAdapterV2Event, { readonly type: "turn.terminal" }>;
+
+interface DeferredCodexRootTerminal {
+  readonly context: ActiveCodexTurnContext;
+  readonly event: CodexRootTerminalEvent;
+}
+
+interface CodexSubagentThreadContext {
+  readonly parentContext: ActiveCodexTurnContext;
+  readonly providerThread: OrchestrationV2ProviderThread;
+  readonly childThread: OrchestrationV2AppThread;
+  readonly subagentNodeId: OrchestrationV2ExecutionNode["id"];
+  readonly childRootNodeId: OrchestrationV2ExecutionNode["id"];
+  readonly childThreadId: ThreadId;
+  readonly nativeToolCallId: string;
+  readonly ordinal: number;
+  readonly startedAt: DateTime.Utc;
+  readonly turnItemId: OrchestrationV2TurnItem["id"];
+  readonly turnItemOrdinal: number;
+  task: OrchestrationV2Subagent;
+}
+
+const isDescendantCodexTurn = (
+  candidate: ActiveCodexTurnContext,
+  ancestor: ActiveCodexTurnContext,
+): boolean => {
+  let parent = candidate.subagent?.parentContext;
+  while (parent !== undefined) {
+    if (parent === ancestor) {
+      return true;
+    }
+    parent = parent.subagent?.parentContext;
+  }
+  return false;
+};
+
+interface PendingCodexSubagentTurnStarted {
+  readonly nativeTurnId: string;
+  readonly startedAt: DateTime.Utc;
+}
+
+type PendingCodexRuntimeRequest =
+  | {
+      readonly type: "approval";
+      readonly requestId: RuntimeRequestId;
+      readonly requestKind: ProviderRequestKind;
+      readonly decision: Deferred.Deferred<ProviderApprovalDecision, never>;
+    }
+  | {
+      readonly type: "user_input";
+      readonly requestId: RuntimeRequestId;
+      readonly answers: Deferred.Deferred<ProviderUserInputAnswers, never>;
+    };
+
+type CodexWebSearchItem = {
+  readonly id: string;
+  readonly type: "webSearch";
+  readonly query?: string | null;
+  readonly action?:
+    | CodexSchema.V2ItemStartedNotification__WebSearchAction
+    | CodexSchema.V2ItemCompletedNotification__WebSearchAction
+    | null;
+};
+
+export type CodexDynamicToolItem = Extract<
+  | CodexSchema.V2ItemStartedNotification__ThreadItem
+  | CodexSchema.V2ItemCompletedNotification__ThreadItem,
+  { readonly type: "mcpToolCall" | "dynamicToolCall" }
+>;
+
+type CodexCollabAgentToolCallItem = Extract<
+  CodexSchema.V2ItemCompletedNotification__ThreadItem,
+  { readonly type: "collabAgentToolCall" }
+>;
+
+type CodexSubAgentActivityItem = Extract<
+  | CodexSchema.V2ItemStartedNotification__ThreadItem
+  | CodexSchema.V2ItemCompletedNotification__ThreadItem,
+  { readonly type: "subAgentActivity" }
+>;
+
+export interface CodexAgentMessageDeltaUpdate {
+  readonly turnId: string;
+  readonly itemId: string;
+  readonly text: string;
+  readonly completed: boolean;
+}
+
+export interface CodexAgentMessageDeltaCoalescer {
+  readonly append: (input: {
+    readonly turnId: string;
+    readonly itemId: string;
+    readonly delta: string;
+  }) => Effect.Effect<void>;
+  readonly complete: (input: {
+    readonly turnId: string;
+    readonly itemId: string;
+    readonly finalText?: string;
+    readonly emitEmpty?: boolean;
+  }) => Effect.Effect<string>;
+  readonly flushTurn: (turnId: string) => Effect.Effect<void>;
+}
+
+interface BufferedCodexAgentMessage {
+  readonly turnId: string;
+  readonly itemId: string;
+  readonly text: string;
+  readonly dirty: boolean;
+}
+
+function codexAgentMessageBufferKey(turnId: string, itemId: string): string {
+  return `${turnId}\u0000${itemId}`;
+}
+
+export const makeCodexAgentMessageDeltaCoalescer = Effect.fn(
+  "CodexAdapterV2.makeCodexAgentMessageDeltaCoalescer",
+)(function* (input: {
+  readonly flushIntervalMs: number;
+  readonly emit: (update: CodexAgentMessageDeltaUpdate) => Effect.Effect<void>;
+}): Effect.fn.Return<CodexAgentMessageDeltaCoalescer, never, Scope.Scope> {
+  const buffered = yield* Ref.make(new Map<string, BufferedCodexAgentMessage>());
+  const flushScheduled = yield* Ref.make(false);
+  const flushLock = yield* Semaphore.make(1);
+  const coalescerScope = yield* Effect.scope;
+
+  const drain = (options: {
+    readonly predicate: (message: BufferedCodexAgentMessage) => boolean;
+    readonly completed: boolean;
+    readonly onlyDirty: boolean;
+    readonly releaseSchedule?: boolean;
+  }) =>
+    flushLock.withPermit(
+      Effect.gen(function* () {
+        const current = yield* Ref.get(buffered);
+        const updates: Array<CodexAgentMessageDeltaUpdate> = [];
+        for (const message of current.values()) {
+          if (!options.predicate(message) || (options.onlyDirty && !message.dirty)) {
+            continue;
+          }
+          updates.push({
+            turnId: message.turnId,
+            itemId: message.itemId,
+            text: message.text,
+            completed: options.completed,
+          });
+        }
+        const emitUpdates = Effect.forEach(updates, input.emit, { discard: true });
+        yield* options.releaseSchedule === true
+          ? emitUpdates.pipe(Effect.ensuring(Ref.set(flushScheduled, false)))
+          : emitUpdates;
+        yield* Ref.update(buffered, (current) => {
+          const next = new Map(current);
+          for (const [key, message] of current) {
+            if (!options.predicate(message) || (options.onlyDirty && !message.dirty)) {
+              continue;
+            }
+            if (options.completed) {
+              next.delete(key);
+            } else {
+              next.set(key, { ...message, dirty: false });
+            }
+          }
+          return next;
+        });
+      }),
+    );
+
+  const flushDirty = drain({
+    predicate: () => true,
+    completed: false,
+    onlyDirty: true,
+    releaseSchedule: true,
+  });
+
+  return {
+    append: ({ turnId, itemId, delta }) =>
+      delta.length === 0
+        ? Effect.void
+        : Effect.uninterruptible(
+            Effect.gen(function* () {
+              const shouldSchedule = yield* flushLock.withPermit(
+                Effect.gen(function* () {
+                  yield* Ref.update(buffered, (current) => {
+                    const key = codexAgentMessageBufferKey(turnId, itemId);
+                    const existing = current.get(key);
+                    const next = new Map(current);
+                    next.set(key, {
+                      turnId,
+                      itemId,
+                      text: `${existing?.text ?? ""}${delta}`,
+                      dirty: true,
+                    });
+                    return next;
+                  });
+                  return yield* Ref.modify(flushScheduled, (scheduled) => [!scheduled, true]);
+                }),
+              );
+              if (shouldSchedule) {
+                yield* Effect.sleep(Duration.millis(Math.max(1, input.flushIntervalMs))).pipe(
+                  Effect.andThen(flushDirty),
+                  Effect.interruptible,
+                  Effect.forkIn(coalescerScope),
+                );
+              }
+            }),
+          ),
+    complete: ({ turnId, itemId, finalText, emitEmpty = true }) =>
+      flushLock.withPermit(
+        Effect.gen(function* () {
+          const key = codexAgentMessageBufferKey(turnId, itemId);
+          const existing = (yield* Ref.get(buffered)).get(key);
+          const text = finalText !== undefined ? finalText : (existing?.text ?? "");
+          if (emitEmpty || text.length > 0) {
+            yield* input.emit({ turnId, itemId, text, completed: true });
+          }
+          yield* Ref.update(buffered, (current) => {
+            const next = new Map(current);
+            next.delete(key);
+            return next;
+          });
+          return text;
+        }),
+      ),
+    flushTurn: (turnId) =>
+      drain({
+        predicate: (message) => message.turnId === turnId,
+        completed: true,
+        onlyDirty: false,
+      }),
+  };
+});
+
+export interface CodexAppServerClientFactoryShape {
+  readonly open: (input: {
+    readonly instanceId: ProviderInstanceId;
+    readonly threadId: ThreadId;
+    readonly providerSessionId: OrchestrationV2ProviderSession["id"];
+    readonly runtimePolicy: ProviderAdapterV2RuntimePolicy;
+    readonly settings: CodexSettings;
+    readonly environment: NodeJS.ProcessEnv;
+  }) => Effect.Effect<
+    CodexClient.CodexAppServerClient["Service"],
+    ProviderAdapterOpenSessionError,
+    Scope.Scope
+  >;
+}
+
+export class CodexAppServerClientFactory extends Context.Service<
+  CodexAppServerClientFactory,
+  CodexAppServerClientFactoryShape
+>()("t3/orchestration-v2/Adapters/CodexAdapterV2/CodexAppServerClientFactory") {}
+
+export function codexThreadRuntimeParams(input: {
+  readonly threadId: ThreadId | null;
+  readonly modelSelection?: { readonly model: string };
+  readonly runtimePolicy?: ProviderAdapterV2RuntimePolicy;
+}): {
+  readonly cwd?: string;
+  readonly model?: string;
+  readonly config?: Readonly<Record<string, unknown>>;
+} {
+  const mcpSession =
+    input.threadId === null ? undefined : McpProviderSession.readMcpProviderSession(input.threadId);
+  return {
+    ...(input.runtimePolicy?.cwd == null ? {} : { cwd: input.runtimePolicy.cwd }),
+    ...(input.modelSelection === undefined ? {} : { model: input.modelSelection.model }),
+    ...(mcpSession === undefined
+      ? {}
+      : {
+          config: {
+            mcp_servers: {
+              "t3-code": {
+                url: mcpSession.endpoint,
+                http_headers: {
+                  Authorization: mcpSession.authorizationHeader,
+                },
+              },
+            },
+          },
+        }),
+  };
+}
+
+export const makeCodexAppServerSpawnCommand = Effect.fn(
+  "CodexAdapterV2.makeCodexAppServerSpawnCommand",
+)(function* (input: {
+  readonly command: string;
+  readonly args: ReadonlyArray<string>;
+  readonly cwd?: string | undefined;
+  readonly env?: NodeJS.ProcessEnv | undefined;
+  readonly extendEnv?: boolean | undefined;
+}) {
+  const spawnCommand = yield* resolveSpawnCommand(input.command, input.args, {
+    ...(input.env === undefined ? {} : { env: input.env }),
+    ...(input.extendEnv === undefined ? {} : { extendEnv: input.extendEnv }),
+  });
+  return ChildProcess.make(spawnCommand.command, spawnCommand.args, {
+    ...(input.cwd === undefined ? {} : { cwd: input.cwd }),
+    ...(input.env === undefined ? {} : { env: input.env }),
+    ...(input.extendEnv === undefined ? {} : { extendEnv: input.extendEnv }),
+    shell: spawnCommand.shell,
+  });
+});
+
+export const makeCodexAppServerClientFactoryCommandLayer = (
+  options: CodexClient.CodexAppServerClientOptions & {
+    readonly command: string;
+    readonly args?: ReadonlyArray<string>;
+    readonly cwd?: string;
+    readonly env?: NodeJS.ProcessEnv;
+  },
+): Layer.Layer<CodexAppServerClientFactory, never, ChildProcessSpawner.ChildProcessSpawner> =>
+  Layer.effect(
+    CodexAppServerClientFactory,
+    Effect.gen(function* () {
+      const spawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      return CodexAppServerClientFactory.of({
+        open: (input) =>
+          Effect.gen(function* () {
+            const scope = yield* Scope.Scope;
+            const command = yield* makeCodexAppServerSpawnCommand({
+              command: options.command,
+              args: [...(options.args ?? [])],
+              ...(options.cwd === undefined ? {} : { cwd: options.cwd }),
+              ...(options.env === undefined ? {} : { env: options.env, extendEnv: true }),
+            });
+            const handle = yield* spawner.spawn(command).pipe(
+              Effect.provideService(Scope.Scope, scope),
+              Effect.mapError(
+                (cause) =>
+                  new ProviderAdapterOpenSessionError({
+                    driver: CODEX_PROVIDER,
+                    providerSessionId: input.providerSessionId,
+                    cause,
+                  }),
+              ),
+            );
+            const context = yield* Layer.build(CodexClient.layerChildProcess(handle, options));
+            return yield* Effect.service(CodexClient.CodexAppServerClient).pipe(
+              Effect.provide(context),
+            );
+          }),
+      });
+    }),
+  );
+
+export function makeCodexAppServerProtocolLogger(input: {
+  readonly nativeEventLogger: EventNdjsonLogger | undefined;
+  readonly threadId: ThreadId;
+  readonly providerSessionId: OrchestrationV2ProviderSession["id"];
+}): CodexClient.CodexAppServerClientOptions["logger"] | undefined {
+  const { nativeEventLogger } = input;
+  if (nativeEventLogger === undefined) {
+    return undefined;
+  }
+
+  return (event) =>
+    nativeEventLogger
+      .write(
+        {
+          provider: CODEX_PROVIDER,
+          protocol: "codex.app-server",
+          kind: "protocol",
+          providerSessionId: input.providerSessionId,
+          event: redactCodexProtocolValue(event),
+        },
+        input.threadId,
+      )
+      .pipe(Effect.ignore);
+}
+
+export function redactCodexProtocolValue(value: unknown): unknown {
+  if (Array.isArray(value)) {
+    return value.map(redactCodexProtocolValue);
+  }
+  if (value === null || typeof value !== "object") {
+    if (typeof value !== "string") {
+      return value;
+    }
+    if (/^Bearer\s+/i.test(value)) {
+      return "[REDACTED]";
+    }
+    const trimmed = value.trim();
+    if (
+      !(
+        (trimmed.startsWith("{") && trimmed.endsWith("}")) ||
+        (trimmed.startsWith("[") && trimmed.endsWith("]"))
+      )
+    ) {
+      return value;
+    }
+    try {
+      return JSON.stringify(redactCodexProtocolValue(JSON.parse(trimmed) as unknown));
+    } catch {
+      return value;
+    }
+  }
+  return Object.fromEntries(
+    Object.entries(value).map(([key, nested]) => [
+      key,
+      isSensitiveCodexProtocolKey(key) ? "[REDACTED]" : redactCodexProtocolValue(nested),
+    ]),
+  );
+}
+
+function isSensitiveCodexProtocolKey(key: string): boolean {
+  const normalized = key.replace(/[^a-z0-9]/gi, "").toLowerCase();
+  return (
+    normalized.endsWith("authorization") ||
+    normalized.endsWith("apikey") ||
+    normalized.endsWith("token") ||
+    normalized.endsWith("password") ||
+    normalized.endsWith("secret")
+  );
+}
+
+export const codexAppServerClientFactoryFromSettingsLayer: Layer.Layer<
+  CodexAppServerClientFactory,
+  never,
+  ChildProcessSpawner.ChildProcessSpawner | ProviderEventLoggers
+> = Layer.effect(
+  CodexAppServerClientFactory,
+  Effect.gen(function* () {
+    const spawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+    const { native: nativeEventLogger } = yield* ProviderEventLoggers;
+
+    return CodexAppServerClientFactory.of({
+      open: (input) =>
+        Effect.gen(function* () {
+          const scope = yield* Scope.Scope;
+          const environment = {
+            ...input.environment,
+            ...(input.settings.homePath ? { CODEX_HOME: input.settings.homePath } : {}),
+          };
+          const command = yield* makeCodexAppServerSpawnCommand({
+            command: input.settings.binaryPath || "codex",
+            args: ["app-server"],
+            env: environment,
+          });
+          const handle = yield* spawner.spawn(command).pipe(
+            Effect.provideService(Scope.Scope, scope),
+            Effect.mapError(
+              (cause) =>
+                new ProviderAdapterOpenSessionError({
+                  driver: CODEX_PROVIDER,
+                  providerSessionId: input.providerSessionId,
+                  cause,
+                }),
+            ),
+          );
+          const protocolLogger = makeCodexAppServerProtocolLogger({
+            nativeEventLogger,
+            threadId: input.threadId,
+            providerSessionId: input.providerSessionId,
+          });
+          const clientOptions: CodexClient.CodexAppServerClientOptions =
+            protocolLogger === undefined
+              ? {}
+              : {
+                  logIncoming: true,
+                  logOutgoing: true,
+                  logger: protocolLogger,
+                };
+          const context = yield* Layer.build(CodexClient.layerChildProcess(handle, clientOptions));
+          return yield* Effect.service(CodexClient.CodexAppServerClient).pipe(
+            Effect.provide(context),
+          );
+        }),
+    });
+  }),
+);
+
+export type CodexAdapterV2DriverEnv =
+  | CodexAppServerClientFactory
+  | FileSystem.FileSystem
+  | IdAllocatorV2
+  | Path.Path
+  | ServerConfig;
+
+export const CodexAdapterV2Driver: ProviderAdapterDriver<CodexSettings, CodexAdapterV2DriverEnv> = {
+  driverKind: CODEX_DRIVER_KIND,
+  configSchema: CodexSettings,
+  defaultConfig: (): CodexSettings => DEFAULT_CODEX_SETTINGS,
+  create: ({ instanceId, environment, enabled, config }) =>
+    Effect.gen(function* () {
+      const clientFactory = yield* CodexAppServerClientFactory;
+      const continuationRequests = yield* ProviderContinuationRequests;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const hostEnvironment = yield* HostProcessEnvironment;
+      const idAllocator = yield* IdAllocatorV2;
+      const serverConfig = yield* ServerConfig;
+      const homeLayout = yield* resolveCodexHomeLayout(config);
+
+      yield* materializeCodexShadowHome(homeLayout).pipe(
+        Effect.mapError(
+          (cause) =>
+            new ProviderAdapterDriverCreateError({
+              driver: CODEX_DRIVER_KIND,
+              instanceId,
+              detail: "Failed to materialize the Codex shadow home.",
+              cause,
+            }),
+        ),
+      );
+
+      const settings = {
+        ...config,
+        enabled,
+        homePath: homeLayout.effectiveHomePath ?? "",
+      } satisfies CodexSettings;
+
+      return makeCodexAdapterV2({
+        instanceId,
+        settings,
+        environment: mergeProviderInstanceEnvironment(environment, hostEnvironment),
+        clientFactory,
+        fileSystem,
+        idAllocator,
+        serverConfig,
+        continuationRequests,
+      });
+    }),
+};
+
+export const layer: Layer.Layer<
+  ProviderAdapterV2,
+  never,
+  CodexAppServerClientFactory | FileSystem.FileSystem | IdAllocatorV2 | ServerConfig
+> = Layer.effect(
+  ProviderAdapterV2,
+  Effect.gen(function* () {
+    const clientFactory = yield* CodexAppServerClientFactory;
+    const continuationRequests = yield* ProviderContinuationRequests;
+    const fileSystem = yield* FileSystem.FileSystem;
+    const hostEnvironment = yield* HostProcessEnvironment;
+    const idAllocator = yield* IdAllocatorV2;
+    const serverConfig = yield* ServerConfig;
+
+    return makeCodexAdapterV2({
+      instanceId: CODEX_DEFAULT_INSTANCE_ID,
+      settings: DEFAULT_CODEX_SETTINGS,
+      environment: hostEnvironment,
+      clientFactory,
+      fileSystem,
+      idAllocator,
+      serverConfig,
+      continuationRequests,
+    });
+  }),
+);
+
+export interface CodexAdapterV2Options {
+  readonly instanceId: ProviderInstanceId;
+  readonly settings: CodexSettings;
+  readonly environment: NodeJS.ProcessEnv;
+  readonly clientFactory: CodexAppServerClientFactoryShape;
+  readonly fileSystem: FileSystem.FileSystem;
+  readonly idAllocator: IdAllocatorV2Shape;
+  readonly serverConfig: ServerConfig["Service"];
+  /**
+   * Sink for post-settle background command completions so the orchestrator
+   * can start a continuation run. Optional: adapters that omit it keep
+   * projection-only handling for late item completions.
+   */
+  readonly continuationRequests?: {
+    readonly offer: (request: ProviderContinuationRequest) => Effect.Effect<void>;
+  };
+}
+
+export function makeCodexAdapterV2(adapterOptions: CodexAdapterV2Options): ProviderAdapterV2Shape {
+  const { clientFactory, fileSystem, idAllocator, serverConfig } = adapterOptions;
+  const continuationRequests = adapterOptions.continuationRequests;
+
+  return ProviderAdapterV2.of({
+    instanceId: adapterOptions.instanceId,
+    driver: CODEX_PROVIDER,
+    getCapabilities: () => Effect.succeed(CodexProviderCapabilitiesV2),
+    planSelectionTransition: () => Effect.succeed(turnScopedSelectionTransition()),
+    openSession: (input) =>
+      Effect.gen(function* () {
+        const client = yield* clientFactory.open({
+          instanceId: adapterOptions.instanceId,
+          threadId: input.threadId,
+          providerSessionId: input.providerSessionId,
+          runtimePolicy: input.runtimePolicy,
+          settings: adapterOptions.settings,
+          environment: adapterOptions.environment,
+        });
+        const initialized = yield* Ref.make(false);
+        const ensureInitialized = Effect.gen(function* () {
+          const alreadyInitialized = yield* Ref.get(initialized);
+          if (alreadyInitialized) {
+            return;
+          }
+
+          yield* client.request("initialize", {
+            clientInfo: CODEX_CLIENT_INFO,
+            capabilities: CODEX_CLIENT_CAPABILITIES,
+          });
+          yield* client.notify("initialized", undefined);
+          yield* Ref.set(initialized, true);
+        });
+        const now = yield* DateTime.now;
+        const session = providerSession({
+          providerSessionId: input.providerSessionId,
+          providerInstanceId: adapterOptions.instanceId,
+          cwd: input.runtimePolicy.cwd,
+          model: input.modelSelection.model,
+          now,
+        });
+        const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+        const activeTurns = yield* Ref.make(new Map<string, ActiveCodexTurnContext>());
+        const pendingRootTurns = yield* Ref.make(new Map<string, ProviderAdapterV2TurnInput>());
+        const turnWaiters = yield* Ref.make(new Map<string, Deferred.Deferred<void, never>>());
+        const subagentThreads = yield* Ref.make(new Map<string, CodexSubagentThreadContext>());
+        const pendingSubagentTurns = yield* Ref.make(
+          new Map<string, ReadonlyArray<PendingCodexSubagentTurnStarted>>(),
+        );
+        const nextProviderTurnOrdinals = yield* Ref.make(new Map<string, number>());
+        const itemOrdinals = yield* Ref.make(new Map<string, number>());
+        const nextItemOrdinalsByTurn = yield* Ref.make(new Map<string, number>());
+        const providerRetries = yield* Ref.make(
+          new Map<ProviderTurnId, ActiveCodexProviderRetry>(),
+        );
+        const planDeltas = yield* Ref.make(new Map<string, string>());
+        const planIds = yield* Ref.make(new Map<string, OrchestrationV2PlanArtifact["id"]>());
+        const pendingRuntimeRequests = yield* Ref.make(
+          new Map<string, PendingCodexRuntimeRequest>(),
+        );
+        /**
+         * Turn contexts retained past turn/completed while background command
+         * items started in that turn are still running, so late item events
+         * keep projecting instead of being dropped.
+         */
+        const settledTurns = yield* Ref.make(new Map<string, ActiveCodexTurnContext>());
+        const runningCommandItemsByTurn = yield* Ref.make(
+          new Map<string, Map<string, TrackedRunningCommandItem>>(),
+        );
+        const interruptingNativeTurns = yield* Ref.make(new Set<string>());
+        const terminalizedNonCompletedNativeTurns = yield* Ref.make(new Set<string>());
+        // Keep the run event stream open until descendant provider state is
+        // terminal, otherwise the root terminal can strand child projections.
+        const deferredRootTerminals = yield* Ref.make(new Map<string, DeferredCodexRootTerminal>());
+        const offeredContinuationItemsByTurn = yield* Ref.make(new Map<string, Set<string>>());
+        const finalAnswerItemIdsByTurn = yield* Ref.make(new Map<string, Set<string>>());
+        const completedFinalAnswerTextsByTurn = yield* Ref.make(new Map<string, Set<string>>());
+        // Native completion and the interrupt timeout share one finalization
+        // path. Serialize the race so only one can publish terminal events.
+        const turnTerminalizationPermit = yield* Semaphore.make(1);
+
+        const emitProviderEvent = (event: ProviderAdapterV2Event) =>
+          Queue.offer(events, event).pipe(Effect.asVoid);
+
+        // Call only for new model-output activity. A local item/completed can
+        // arrive while the upstream response stream is still retrying.
+        const completeProviderRetry = Effect.fn("CodexAdapterV2.completeProviderRetry")(function* (
+          context: ActiveCodexTurnContext,
+          updatedAt: DateTime.Utc,
+        ) {
+          const providerRetry = yield* Ref.modify(providerRetries, (current) => {
+            const retry = current.get(context.providerTurnId);
+            if (retry === undefined) {
+              return [undefined, current] as const;
+            }
+            const updated = new Map(current);
+            updated.delete(context.providerTurnId);
+            return [retry, updated] as const;
+          });
+          if (providerRetry === undefined) {
+            return;
+          }
+          yield* emitProviderEvent({
+            type: "turn_item.updated",
+            driver: CODEX_PROVIDER,
+            turnItem: makeProviderRetryTurnItem({
+              idAllocator,
+              driver: CODEX_PROVIDER,
+              threadId: context.projectionThreadId,
+              runId: context.projectionRunId,
+              nodeId: context.providerNodeId,
+              providerThreadId: context.providerThread.id,
+              providerTurnId: context.providerTurnId,
+              itemOrdinal: providerRetry.itemOrdinal,
+              failure: providerRetry.failure,
+              retry: providerRetry.retry,
+              status: "completed",
+              startedAt: providerRetry.startedAt,
+              updatedAt,
+            }),
+          });
+        });
+
+        const registerRootTurn = (input: {
+          readonly turnInput: ProviderAdapterV2TurnInput;
+          readonly nativeTurnId: string;
+          readonly startedAt: DateTime.Utc;
+        }) =>
+          Effect.gen(function* () {
+            const existing = (yield* Ref.get(activeTurns)).get(input.nativeTurnId);
+            if (existing !== undefined) {
+              return existing;
+            }
+            const providerTurnId = idAllocator.derive.providerTurn({
+              driver: CODEX_PROVIDER,
+              nativeTurnId: input.nativeTurnId,
+            });
+            const context: ActiveCodexTurnContext = {
+              input: input.turnInput,
+              projectionAppThread: input.turnInput.appThread,
+              projectionThreadId: input.turnInput.threadId,
+              projectionRunId: input.turnInput.runId,
+              nativeTurnId: input.nativeTurnId,
+              providerThread: input.turnInput.providerThread,
+              providerTurnId,
+              providerTurnOrdinal: input.turnInput.providerTurnOrdinal,
+              providerNodeId: input.turnInput.rootNodeId,
+              providerNodeKind: "root_turn",
+              providerNodeStartedAt: input.startedAt,
+              itemParentNodeId: input.turnInput.rootNodeId,
+              rootNodeId: input.turnInput.rootNodeId,
+              subagent: null,
+              startedAt: input.startedAt,
+            };
+            yield* Ref.update(activeTurns, (current) => {
+              const updated = new Map(current);
+              updated.set(input.nativeTurnId, context);
+              return updated;
+            });
+            yield* emitProviderEvent({
+              type: "provider_turn.updated",
+              driver: CODEX_PROVIDER,
+              threadId: input.turnInput.threadId,
+              providerTurn: {
+                id: providerTurnId,
+                providerThreadId: input.turnInput.providerThread.id,
+                nodeId: input.turnInput.rootNodeId,
+                runAttemptId: input.turnInput.attemptId,
+                nativeTurnRef: {
+                  driver: CODEX_PROVIDER,
+                  nativeId: input.nativeTurnId,
+                  strength: "strong",
+                },
+                ordinal: input.turnInput.providerTurnOrdinal,
+                status: "running",
+                startedAt: input.startedAt,
+                completedAt: null,
+              },
+            });
+            return context;
+          });
+
+        const findActiveTurnByNativeThreadId = (nativeThreadId: string) =>
+          Effect.gen(function* () {
+            const turns = Array.from((yield* Ref.get(activeTurns)).values());
+            return turns.find(
+              (context) => context.providerThread.nativeThreadRef?.nativeId === nativeThreadId,
+            );
+          });
+
+        const awaitActiveTurn = (
+          nativeTurnId: string,
+          attemptsRemaining = 1_000,
+        ): Effect.Effect<ActiveCodexTurnContext | undefined> =>
+          Effect.gen(function* () {
+            const context = (yield* Ref.get(activeTurns)).get(nativeTurnId);
+            if (context !== undefined || attemptsRemaining <= 0) {
+              return context;
+            }
+            yield* Effect.yieldNow;
+            return yield* awaitActiveTurn(nativeTurnId, attemptsRemaining - 1);
+          });
+
+        /**
+         * Like awaitActiveTurn, but item lifecycle events for a turn that
+         * already settled (background command completions) resolve the
+         * retained settled context instead of dropping.
+         */
+        const resolveItemEventContext = (nativeTurnId: string) =>
+          Effect.gen(function* () {
+            const settled = (yield* Ref.get(settledTurns)).get(nativeTurnId);
+            if (settled !== undefined) {
+              return { context: settled, settled: true } as const;
+            }
+            const context = yield* awaitActiveTurn(nativeTurnId);
+            return context === undefined ? undefined : ({ context, settled: false } as const);
+          });
+
+        const trackRunningCommandItem = (nativeTurnId: string, item: TrackedRunningCommandItem) =>
+          Ref.update(runningCommandItemsByTurn, (current) => {
+            const updated = new Map(current);
+            const items = new Map(updated.get(nativeTurnId) ?? []);
+            items.set(item.id, item);
+            updated.set(nativeTurnId, items);
+            return updated;
+          });
+
+        /** Returns true when the turn has no running command items left. */
+        const clearRunningCommandItem = (nativeTurnId: string, nativeItemId: string) =>
+          Ref.modify(runningCommandItemsByTurn, (current) => {
+            const items = current.get(nativeTurnId);
+            if (items === undefined || !items.has(nativeItemId)) {
+              return [items === undefined || items.size === 0, current] as const;
+            }
+            const remaining = new Map(items);
+            remaining.delete(nativeItemId);
+            const updated = new Map(current);
+            if (remaining.size === 0) {
+              updated.delete(nativeTurnId);
+            } else {
+              updated.set(nativeTurnId, remaining);
+            }
+            return [remaining.size === 0, updated] as const;
+          });
+
+        /**
+         * When a turn is interrupted or failed, Codex often leaves commandExecution
+         * items mid-flight (no item/completed). Emit terminal turn items before
+         * turn.terminal so the projection never keeps a forever-running command card.
+         * Does not retain settled context: late completions must not wake the run.
+         */
+        const terminalizeRunningCommandItems = (
+          context: ActiveCodexTurnContext,
+          nativeTurnId: string,
+          status: "interrupted" | "failed",
+          completedAt: DateTime.Utc,
+        ) =>
+          Effect.gen(function* () {
+            const items = (yield* Ref.get(runningCommandItemsByTurn)).get(nativeTurnId);
+            if (items === undefined || items.size === 0) {
+              return;
+            }
+            for (const tracked of items.values()) {
+              const nodeId = idAllocator.derive.nodeFromProviderItem({
+                driver: CODEX_PROVIDER,
+                nativeItemId: tracked.id,
+              });
+              const turnItemId = idAllocator.derive.turnItemFromProviderItem({
+                driver: CODEX_PROVIDER,
+                nativeItemId: tracked.id,
+              });
+              const ordinal = yield* resolveItemOrdinal(context, tracked.id);
+              const node: OrchestrationV2ExecutionNode = {
+                id: nodeId,
+                threadId: context.projectionThreadId,
+                runId: context.projectionRunId,
+                parentNodeId: context.itemParentNodeId,
+                rootNodeId: context.rootNodeId,
+                kind: "tool_call",
+                status,
+                countsForRun: false,
+                providerThreadId: context.providerThread.id,
+                providerTurnId: context.providerTurnId,
+                nativeItemRef: codexNativeItemRef(tracked.id),
+                runtimeRequestId: null,
+                checkpointScopeId: null,
+                startedAt: context.startedAt,
+                completedAt,
+              };
+              const turnItem: OrchestrationV2TurnItem = {
+                id: turnItemId,
+                threadId: context.projectionThreadId,
+                runId: context.projectionRunId,
+                nodeId,
+                providerThreadId: context.providerThread.id,
+                providerTurnId: context.providerTurnId,
+                nativeItemRef: codexNativeItemRef(tracked.id),
+                parentItemId: null,
+                ordinal,
+                status,
+                title: null,
+                startedAt: context.startedAt,
+                completedAt,
+                updatedAt: completedAt,
+                type: "command_execution",
+                input: tracked.command,
+                ...(tracked.aggregatedOutput === undefined
+                  ? {}
+                  : { output: tracked.aggregatedOutput }),
+              };
+              yield* emitProviderEvent({
+                type: "node.updated",
+                driver: CODEX_PROVIDER,
+                node,
+              });
+              yield* emitProviderEvent({
+                type: "turn_item.updated",
+                driver: CODEX_PROVIDER,
+                turnItem,
+              });
+            }
+          });
+
+        const resolveItemOrdinal = (context: ActiveCodexTurnContext, nativeItemId: string) =>
+          Effect.gen(function* () {
+            const existing = (yield* Ref.get(itemOrdinals)).get(nativeItemId);
+            if (existing !== undefined) {
+              return existing;
+            }
+
+            const turnKey = context.nativeTurnId;
+            const nextWithinTurn = yield* Ref.modify(nextItemOrdinalsByTurn, (current) => {
+              const next = (current.get(turnKey) ?? 0) + 1;
+              const updated = new Map(current);
+              updated.set(turnKey, next);
+              return [next, updated];
+            });
+            const nextOrdinal = context.providerTurnOrdinal * 100 + nextWithinTurn;
+            yield* Ref.update(itemOrdinals, (current) => {
+              const updated = new Map(current);
+              updated.set(nativeItemId, nextOrdinal);
+              return updated;
+            });
+            return nextOrdinal;
+          });
+
+        const nextProviderTurnOrdinal = (
+          providerThreadId: OrchestrationV2ProviderThread["id"],
+          minimum: number,
+        ) =>
+          Ref.modify(nextProviderTurnOrdinals, (current) => {
+            const previous = current.get(String(providerThreadId));
+            const next = previous === undefined ? minimum : Math.max(previous + 1, minimum);
+            const updated = new Map(current);
+            updated.set(String(providerThreadId), next);
+            return [next, updated];
+          });
+
+        const emitSubagentTaskUpdate = (input: {
+          readonly subagent: CodexSubagentThreadContext;
+          readonly status: OrchestrationV2Subagent["status"];
+          readonly result?: string | null;
+          readonly completedAt?: DateTime.Utc | null;
+        }) =>
+          Effect.gen(function* () {
+            const now = yield* DateTime.now;
+            const terminal =
+              input.status === "completed" ||
+              input.status === "failed" ||
+              input.status === "cancelled" ||
+              input.status === "interrupted";
+            const completedAt = terminal ? (input.completedAt ?? now) : null;
+            const task = {
+              ...input.subagent.task,
+              status: input.status,
+              result: input.result === undefined ? input.subagent.task.result : input.result,
+              completedAt,
+              updatedAt: now,
+            } satisfies OrchestrationV2Subagent;
+            input.subagent.task = task;
+
+            yield* emitProviderEvent({
+              type: "subagent.updated",
+              driver: CODEX_PROVIDER,
+              subagent: task,
+            });
+            yield* emitProviderEvent({
+              type: "turn_item.updated",
+              driver: CODEX_PROVIDER,
+              turnItem: {
+                id: input.subagent.turnItemId,
+                threadId: task.threadId,
+                runId: task.runId,
+                nodeId: task.id,
+                providerThreadId: task.providerThreadId,
+                providerTurnId: input.subagent.parentContext.providerTurnId,
+                nativeItemRef: task.nativeTaskRef,
+                parentItemId: null,
+                ordinal: input.subagent.turnItemOrdinal,
+                status: task.status,
+                title: task.title,
+                startedAt: task.startedAt,
+                completedAt: task.completedAt,
+                updatedAt: task.updatedAt,
+                type: "subagent",
+                subagentId: task.id,
+                origin: task.origin,
+                driver: task.driver,
+                providerInstanceId: task.providerInstanceId,
+                childThreadId: task.childThreadId,
+                prompt: task.prompt,
+                result: task.result,
+              },
+            });
+          });
+
+        const emitSubagentProviderTurnStarted = (
+          subagent: CodexSubagentThreadContext,
+          turn: PendingCodexSubagentTurnStarted,
+        ) =>
+          Effect.gen(function* () {
+            const terminalizedNativeTurns = yield* Ref.get(terminalizedNonCompletedNativeTurns);
+            let ancestor: ActiveCodexTurnContext | undefined = subagent.parentContext;
+            while (ancestor !== undefined) {
+              if (terminalizedNativeTurns.has(ancestor.nativeTurnId)) {
+                const nativeThreadId = yield* getNativeThreadId(subagent.providerThread);
+                const interrupted = yield* client
+                  .request("turn/interrupt", {
+                    threadId: nativeThreadId,
+                    turnId: turn.nativeTurnId,
+                  })
+                  .pipe(
+                    Effect.as(true),
+                    Effect.catch((cause) =>
+                      Effect.logWarning("orchestration-v2.codex-late-subagent-interrupt-failed", {
+                        nativeThreadId,
+                        nativeTurnId: turn.nativeTurnId,
+                        cause,
+                      }).pipe(Effect.as(false)),
+                    ),
+                    Effect.timeoutOption("10 seconds"),
+                  );
+                if (Option.isNone(interrupted)) {
+                  yield* Effect.logWarning(
+                    "orchestration-v2.codex-late-subagent-interrupt-timeout",
+                    {
+                      nativeThreadId,
+                      nativeTurnId: turn.nativeTurnId,
+                    },
+                  );
+                }
+                return;
+              }
+              ancestor = ancestor.subagent?.parentContext;
+            }
+            const providerTurnId = idAllocator.derive.providerTurn({
+              driver: CODEX_PROVIDER,
+              nativeTurnId: turn.nativeTurnId,
+            });
+            const providerTurnOrdinal = yield* nextProviderTurnOrdinal(
+              subagent.providerThread.id,
+              1,
+            );
+            const providerNodeId =
+              providerTurnOrdinal === 1
+                ? subagent.childRootNodeId
+                : idAllocator.derive.nodeFromProviderItem({
+                    driver: CODEX_PROVIDER,
+                    nativeItemId: `${turn.nativeTurnId}:thread-root`,
+                  });
+            const activeContext: ActiveCodexTurnContext = {
+              input: subagent.parentContext.input,
+              projectionAppThread: subagent.childThread,
+              projectionThreadId: subagent.childThreadId,
+              projectionRunId: null,
+              nativeTurnId: turn.nativeTurnId,
+              providerThread: subagent.providerThread,
+              providerTurnId,
+              providerTurnOrdinal,
+              providerNodeId,
+              providerNodeKind: "root_turn",
+              providerNodeStartedAt: turn.startedAt,
+              itemParentNodeId: providerNodeId,
+              rootNodeId: providerNodeId,
+              subagent,
+              startedAt: turn.startedAt,
+            };
+            yield* Ref.update(activeTurns, (current) => {
+              const updated = new Map(current);
+              updated.set(turn.nativeTurnId, activeContext);
+              return updated;
+            });
+            if (providerTurnOrdinal > 1 && subagent.task.status !== "running") {
+              yield* emitSubagentTaskUpdate({
+                subagent,
+                status: "running",
+                result: null,
+              });
+            }
+            const now = yield* DateTime.now;
+            yield* emitProviderEvent({
+              type: "provider_thread.updated",
+              driver: CODEX_PROVIDER,
+              providerThread: {
+                ...subagent.providerThread,
+                status: "active",
+                updatedAt: now,
+              },
+            });
+            yield* emitProviderEvent({
+              type: "provider_turn.updated",
+              driver: CODEX_PROVIDER,
+              threadId: subagent.childThreadId,
+              providerTurn: {
+                id: providerTurnId,
+                providerThreadId: subagent.providerThread.id,
+                nodeId: providerNodeId,
+                runAttemptId: null,
+                nativeTurnRef: {
+                  driver: CODEX_PROVIDER,
+                  nativeId: turn.nativeTurnId,
+                  strength: "strong",
+                },
+                ordinal: activeContext.providerTurnOrdinal,
+                status: "running",
+                startedAt: turn.startedAt,
+                completedAt: null,
+              },
+            });
+            yield* emitProviderEvent({
+              type: "node.updated",
+              driver: CODEX_PROVIDER,
+              node: {
+                id: providerNodeId,
+                threadId: subagent.childThreadId,
+                runId: null,
+                parentNodeId: null,
+                rootNodeId: providerNodeId,
+                kind: "root_turn",
+                status: "running",
+                countsForRun: false,
+                providerThreadId: subagent.providerThread.id,
+                providerTurnId,
+                nativeItemRef: subagent.task.nativeTaskRef,
+                runtimeRequestId: null,
+                checkpointScopeId: null,
+                startedAt: turn.startedAt,
+                completedAt: null,
+              },
+            });
+          });
+
+        const rememberSubagentTurnStarted = (input: {
+          readonly nativeThreadId: string;
+          readonly nativeTurnId: string;
+          readonly startedAt: DateTime.Utc;
+        }) =>
+          Effect.gen(function* () {
+            const subagent = (yield* Ref.get(subagentThreads)).get(input.nativeThreadId);
+            if (subagent !== undefined) {
+              yield* emitSubagentProviderTurnStarted(subagent, input);
+              return;
+            }
+            yield* Ref.update(pendingSubagentTurns, (current) => {
+              const updated = new Map(current);
+              updated.set(input.nativeThreadId, [
+                ...(updated.get(input.nativeThreadId) ?? []),
+                { nativeTurnId: input.nativeTurnId, startedAt: input.startedAt },
+              ]);
+              return updated;
+            });
+          });
+
+        const registerSubagentThread = (input: {
+          readonly context: ActiveCodexTurnContext;
+          readonly nativeThreadId: string;
+          readonly nativeItemId: string;
+          readonly nativeToolCallId: string;
+          readonly prompt: string;
+          readonly title: string | null;
+          readonly model: string | null;
+          readonly ordinal: number;
+          readonly emitInitialPrompt: boolean;
+        }) =>
+          Effect.gen(function* () {
+            const registeredSubagents = yield* Ref.get(subagentThreads);
+            if (registeredSubagents.has(input.nativeThreadId)) {
+              return;
+            }
+
+            const now = yield* DateTime.now;
+            const subagentNodeId = idAllocator.derive.nodeFromProviderItem({
+              driver: CODEX_PROVIDER,
+              nativeItemId: input.nativeItemId,
+            });
+            const childRootNodeId = idAllocator.derive.nodeFromProviderItem({
+              driver: CODEX_PROVIDER,
+              nativeItemId: `${input.nativeItemId}:thread-root`,
+            });
+            const childThreadId = idAllocator.derive.threadFromProviderThread({
+              driver: CODEX_PROVIDER,
+              nativeThreadId: input.nativeThreadId,
+            });
+            const turnItemOrdinal = yield* resolveItemOrdinal(input.context, input.nativeItemId);
+            const providerThread = {
+              id: idAllocator.derive.providerThread({
+                driver: CODEX_PROVIDER,
+                nativeThreadId: input.nativeThreadId,
+              }),
+              driver: CODEX_PROVIDER,
+              providerInstanceId: input.context.input.modelSelection.instanceId,
+              providerSessionId: input.context.providerThread.providerSessionId,
+              appThreadId: childThreadId,
+              ownerNodeId: null,
+              nativeThreadRef: {
+                driver: CODEX_PROVIDER,
+                nativeId: input.nativeThreadId,
+                strength: "strong" as const,
+              },
+              nativeConversationHeadRef: null,
+              status: "idle" as const,
+              firstRunOrdinal: null,
+              lastRunOrdinal: null,
+              handoffIds: [],
+              forkedFrom: {
+                providerThreadId: input.context.providerThread.id,
+                providerTurnId: input.context.providerTurnId,
+              },
+              createdAt: now,
+              updatedAt: now,
+            } satisfies OrchestrationV2ProviderThread;
+            const task = {
+              id: subagentNodeId,
+              threadId: input.context.projectionThreadId,
+              runId: input.context.projectionRunId,
+              parentNodeId: input.context.itemParentNodeId,
+              origin: "provider_native",
+              createdBy: "agent",
+              driver: CODEX_PROVIDER,
+              providerInstanceId: input.context.input.modelSelection.instanceId,
+              providerThreadId: providerThread.id,
+              childThreadId,
+              nativeTaskRef: codexNativeItemRef(input.nativeItemId),
+              prompt: input.prompt,
+              title: input.title,
+              model: input.model,
+              status: "running",
+              result: null,
+              startedAt: now,
+              completedAt: null,
+              updatedAt: now,
+            } satisfies OrchestrationV2Subagent;
+            const childThread = makeSubagentChildThread({
+              parentThread: input.context.projectionAppThread,
+              childThreadId,
+              parentNodeId: subagentNodeId,
+              activeProviderThreadId: providerThread.id,
+              providerInstanceId: input.context.input.modelSelection.instanceId,
+              modelSelection: {
+                ...input.context.input.modelSelection,
+                model: task.model ?? input.context.input.modelSelection.model,
+              },
+              title: subagentThreadTitle({
+                parentTitle: input.context.projectionAppThread.title,
+                prompt: task.prompt,
+                title: task.title,
+                ordinal: input.ordinal,
+              }),
+              now,
+              createdBy: "agent",
+              creationSource: "provider",
+            });
+            const subagent = {
+              parentContext: input.context,
+              providerThread,
+              childThread,
+              subagentNodeId,
+              childRootNodeId,
+              childThreadId,
+              nativeToolCallId: input.nativeToolCallId,
+              ordinal: input.ordinal,
+              startedAt: now,
+              turnItemId: idAllocator.derive.turnItemFromProviderItem({
+                driver: CODEX_PROVIDER,
+                nativeItemId: input.nativeItemId,
+              }),
+              turnItemOrdinal,
+              task,
+            } satisfies CodexSubagentThreadContext;
+
+            yield* Ref.update(subagentThreads, (current) => {
+              const updated = new Map(current);
+              updated.set(input.nativeThreadId, subagent);
+              return updated;
+            });
+            yield* emitProviderEvent({
+              type: "app_thread.created",
+              driver: CODEX_PROVIDER,
+              appThread: childThread,
+            });
+            yield* emitProviderEvent({
+              type: "node.updated",
+              driver: CODEX_PROVIDER,
+              node: {
+                id: subagentNodeId,
+                threadId: input.context.projectionThreadId,
+                runId: input.context.projectionRunId,
+                parentNodeId: input.context.itemParentNodeId,
+                rootNodeId: input.context.rootNodeId,
+                kind: "subagent",
+                status: "running",
+                countsForRun: false,
+                providerThreadId: providerThread.id,
+                providerTurnId: input.context.providerTurnId,
+                nativeItemRef: codexNativeItemRef(input.nativeToolCallId),
+                runtimeRequestId: null,
+                checkpointScopeId: null,
+                startedAt: now,
+                completedAt: null,
+              },
+            });
+            yield* emitProviderEvent({
+              type: "node.updated",
+              driver: CODEX_PROVIDER,
+              node: {
+                id: childRootNodeId,
+                threadId: childThreadId,
+                runId: null,
+                parentNodeId: null,
+                rootNodeId: childRootNodeId,
+                kind: "root_turn",
+                status: "running",
+                countsForRun: false,
+                providerThreadId: providerThread.id,
+                providerTurnId: null,
+                nativeItemRef: codexNativeItemRef(input.nativeItemId),
+                runtimeRequestId: null,
+                checkpointScopeId: null,
+                startedAt: now,
+                completedAt: null,
+              },
+            });
+            yield* emitProviderEvent({
+              type: "provider_thread.updated",
+              driver: CODEX_PROVIDER,
+              providerThread,
+            });
+            if (input.emitInitialPrompt && input.prompt.length > 0) {
+              const promptNativeItemId = `${input.nativeItemId}:prompt`;
+              const promptArtifacts = makeSubagentConversationArtifacts({
+                messageId: idAllocator.derive.messageFromProviderItem({
+                  driver: CODEX_PROVIDER,
+                  nativeItemId: promptNativeItemId,
+                }),
+                turnItemId: idAllocator.derive.turnItemFromProviderItem({
+                  driver: CODEX_PROVIDER,
+                  nativeItemId: promptNativeItemId,
+                }),
+                threadId: childThreadId,
+                rootNodeId: childRootNodeId,
+                providerThreadId: providerThread.id,
+                providerTurnId: null,
+                nativeItemRef: codexNativeItemRef(promptNativeItemId),
+                role: "user",
+                text: input.prompt,
+                ordinal: 100,
+                now,
+              });
+              yield* emitProviderEvent({
+                type: "message.updated",
+                driver: CODEX_PROVIDER,
+                message: promptArtifacts.message,
+              });
+              yield* emitProviderEvent({
+                type: "turn_item.updated",
+                driver: CODEX_PROVIDER,
+                turnItem: promptArtifacts.turnItem,
+              });
+            }
+            yield* emitSubagentTaskUpdate({
+              subagent,
+              status: "running",
+            });
+
+            const pendingTurns = yield* Ref.modify(pendingSubagentTurns, (current) => {
+              const pending = current.get(input.nativeThreadId) ?? [];
+              const updated = new Map(current);
+              updated.delete(input.nativeThreadId);
+              return [pending, updated];
+            });
+            for (const pendingTurn of pendingTurns) {
+              yield* emitSubagentProviderTurnStarted(subagent, pendingTurn);
+            }
+          });
+
+        const registerSubagentThreads = (input: {
+          readonly context: ActiveCodexTurnContext;
+          readonly item: CodexCollabAgentToolCallItem;
+        }) =>
+          Effect.gen(function* () {
+            if (input.item.tool !== "spawnAgent" || input.item.receiverThreadIds.length === 0) {
+              return;
+            }
+
+            for (const [index, nativeThreadId] of input.item.receiverThreadIds.entries()) {
+              const model =
+                typeof input.item.model === "string" && input.item.model.length > 0
+                  ? input.item.model
+                  : null;
+              yield* registerSubagentThread({
+                context: input.context,
+                nativeThreadId,
+                nativeItemId: `${input.item.id}:${nativeThreadId}`,
+                nativeToolCallId: input.item.id,
+                prompt: input.item.prompt ?? "",
+                title: null,
+                model,
+                ordinal: index + 1,
+                emitInitialPrompt: true,
+              });
+            }
+          });
+
+        const registerSubagentActivity = (input: {
+          readonly context: ActiveCodexTurnContext;
+          readonly item: CodexSubAgentActivityItem;
+        }) =>
+          Effect.gen(function* () {
+            if (input.item.kind === "started") {
+              const registeredSubagents = yield* Ref.get(subagentThreads);
+              const ordinal =
+                Array.from(registeredSubagents.values()).filter(
+                  (subagent) => subagent.parentContext.rootNodeId === input.context.rootNodeId,
+                ).length + 1;
+              yield* registerSubagentThread({
+                context: input.context,
+                nativeThreadId: input.item.agentThreadId,
+                nativeItemId: `${input.item.id}:${input.item.agentThreadId}`,
+                nativeToolCallId: input.item.id,
+                prompt: "",
+                title: input.item.agentPath,
+                model: null,
+                ordinal,
+                emitInitialPrompt: false,
+              });
+              return;
+            }
+
+            const subagent = (yield* Ref.get(subagentThreads)).get(input.item.agentThreadId);
+            if (subagent === undefined) {
+              return;
+            }
+
+            if (input.item.kind === "interrupted") {
+              yield* emitSubagentTaskUpdate({
+                subagent,
+                status: "interrupted",
+              });
+            }
+          });
+
+        const updateSubagentStates = (input: { readonly item: CodexCollabAgentToolCallItem }) =>
+          Effect.gen(function* () {
+            const subagents = yield* Ref.get(subagentThreads);
+            for (const [nativeThreadId, state] of Object.entries(input.item.agentsStates)) {
+              const subagent = subagents.get(nativeThreadId);
+              if (subagent === undefined) {
+                continue;
+              }
+              const nativeStatus = String(state.status);
+              const status: OrchestrationV2Subagent["status"] =
+                nativeStatus === "completed"
+                  ? "completed"
+                  : nativeStatus === "failed" || nativeStatus === "errored"
+                    ? "failed"
+                    : nativeStatus === "cancelled" || nativeStatus === "closed"
+                      ? "cancelled"
+                      : "running";
+              yield* emitSubagentTaskUpdate({
+                subagent,
+                status,
+                ...(state.message === null ? {} : { result: state.message }),
+              });
+            }
+          });
+
+        const resolvePlanId = (context: ActiveCodexTurnContext, planKey: string) =>
+          Effect.gen(function* () {
+            const existing = (yield* Ref.get(planIds)).get(planKey);
+            if (existing !== undefined) {
+              return existing;
+            }
+            const planId = yield* idAllocator.allocate.plan({
+              threadId: context.projectionThreadId,
+              ...(context.projectionRunId === null ? {} : { runId: context.projectionRunId }),
+              driver: CODEX_PROVIDER,
+            });
+            yield* Ref.update(planIds, (current) => {
+              const updated = new Map(current);
+              updated.set(planKey, planId);
+              return updated;
+            });
+            return planId;
+          });
+
+        const resolveCodexAttachment = (attachment: ChatAttachment) =>
+          Effect.gen(function* () {
+            const attachmentPath = resolveAttachmentPath({
+              attachmentsDir: serverConfig.attachmentsDir,
+              attachment,
+            });
+            if (attachmentPath === null) {
+              return yield* toProtocolError(`Invalid attachment id '${attachment.id}'`);
+            }
+            const bytes = yield* fileSystem
+              .readFile(attachmentPath)
+              .pipe(
+                Effect.mapError((cause) =>
+                  toProtocolError(`Failed to read attachment '${attachment.id}'.`, cause),
+                ),
+              );
+            return {
+              type: "image" as const,
+              url: `data:${attachment.mimeType};base64,${Buffer.from(bytes).toString("base64")}`,
+            } satisfies CodexSchema.V2TurnStartParams__UserInput;
+          });
+
+        const toCodexInput = (
+          turnInput: Pick<ProviderAdapterV2TurnInput | ProviderAdapterV2SteerInput, "message">,
+        ) =>
+          Effect.gen(function* () {
+            const inputItems: Array<CodexSchema.V2TurnStartParams__UserInput> = [];
+            const text = providerMessageTextWithAttachmentPaths({
+              text: turnInput.message.text,
+              attachments: turnInput.message.attachments,
+              attachmentsDir: serverConfig.attachmentsDir,
+            });
+            if (text.length > 0) {
+              inputItems.push({
+                type: "text",
+                text,
+              });
+            }
+            const attachmentItems = yield* Effect.forEach(
+              turnInput.message.attachments.filter(isProviderNativeImageAttachment),
+              resolveCodexAttachment,
+              { concurrency: 1 },
+            );
+            inputItems.push(...attachmentItems);
+            if (inputItems.length === 0) {
+              return yield* toProtocolError("Turn requires non-empty text or attachments.");
+            }
+            return inputItems;
+          });
+
+        const buildAgentMessageArtifacts = (
+          context: ActiveCodexTurnContext,
+          item: { readonly id: string; readonly text: string },
+          completed: boolean,
+        ) =>
+          Effect.gen(function* () {
+            const updatedAt = yield* DateTime.now;
+            const completedAt = completed ? updatedAt : null;
+            const nodeId = idAllocator.derive.nodeFromProviderItem({
+              driver: CODEX_PROVIDER,
+              nativeItemId: item.id,
+            });
+            const ordinal = yield* resolveItemOrdinal(context, item.id);
+            const messageId = idAllocator.derive.messageFromProviderItem({
+              driver: CODEX_PROVIDER,
+              nativeItemId: item.id,
+            });
+            const turnItemId = idAllocator.derive.turnItemFromProviderItem({
+              driver: CODEX_PROVIDER,
+              nativeItemId: item.id,
+            });
+            const node: OrchestrationV2ExecutionNode = {
+              id: nodeId,
+              threadId: context.projectionThreadId,
+              runId: context.projectionRunId,
+              parentNodeId: context.itemParentNodeId,
+              rootNodeId: context.rootNodeId,
+              kind: "assistant_message",
+              status: completed ? "completed" : "running",
+              countsForRun: false,
+              providerThreadId: context.providerThread.id,
+              providerTurnId: context.providerTurnId,
+              nativeItemRef: codexNativeItemRef(item.id),
+              runtimeRequestId: null,
+              checkpointScopeId: null,
+              startedAt: context.startedAt,
+              completedAt,
+            };
+            const message: OrchestrationV2ConversationMessage = {
+              createdBy: "agent",
+              creationSource: "provider",
+              id: messageId,
+              threadId: context.projectionThreadId,
+              runId: context.projectionRunId,
+              nodeId,
+              role: "assistant",
+              text: item.text,
+              attachments: [],
+              streaming: !completed,
+              createdAt: context.startedAt,
+              updatedAt,
+            };
+            const turnItem: OrchestrationV2TurnItem = {
+              id: turnItemId,
+              threadId: context.projectionThreadId,
+              runId: context.projectionRunId,
+              nodeId,
+              providerThreadId: context.providerThread.id,
+              providerTurnId: context.providerTurnId,
+              nativeItemRef: codexNativeItemRef(item.id),
+              parentItemId: null,
+              ordinal,
+              status: completed ? "completed" : "running",
+              title: null,
+              startedAt: context.startedAt,
+              completedAt,
+              updatedAt,
+              type: "assistant_message",
+              messageId,
+              text: item.text,
+              streaming: !completed,
+            };
+            return { node, message, turnItem };
+          });
+
+        const agentMessageDeltas = yield* makeCodexAgentMessageDeltaCoalescer({
+          flushIntervalMs: CODEX_ASSISTANT_DELTA_FLUSH_INTERVAL_MS,
+          emit: (update) =>
+            Effect.gen(function* () {
+              const context = yield* awaitActiveTurn(update.turnId);
+              if (context === undefined) {
+                return;
+              }
+              const finalAnswerItem = (yield* Ref.get(finalAnswerItemIdsByTurn))
+                .get(update.turnId)
+                ?.has(update.itemId);
+              if (finalAnswerItem) {
+                const finalAnswerItemIds = (yield* Ref.get(finalAnswerItemIdsByTurn)).get(
+                  update.turnId,
+                );
+                const completedTexts =
+                  (yield* Ref.get(completedFinalAnswerTextsByTurn)).get(update.turnId) ??
+                  new Set<string>();
+                const firstFinalAnswerItemId = finalAnswerItemIds?.values().next().value;
+                const duplicateCompletion =
+                  update.completed &&
+                  completedTexts.size > 0 &&
+                  (update.text.length === 0 || completedTexts.has(update.text));
+                const deferredStreamingUpdate =
+                  !update.completed &&
+                  (completedTexts.size > 0 || firstFinalAnswerItemId !== update.itemId);
+                if (deferredStreamingUpdate || duplicateCompletion) {
+                  return;
+                }
+              }
+              const artifacts = yield* buildAgentMessageArtifacts(
+                context,
+                { id: update.itemId, text: update.text },
+                update.completed,
+              );
+              yield* emitProviderEvent({
+                type: "node.updated",
+                driver: CODEX_PROVIDER,
+                node: artifacts.node,
+              });
+              yield* emitProviderEvent({
+                type: "message.updated",
+                driver: CODEX_PROVIDER,
+                message: artifacts.message,
+              });
+              yield* emitProviderEvent({
+                type: "turn_item.updated",
+                driver: CODEX_PROVIDER,
+                turnItem: artifacts.turnItem,
+              });
+              if (finalAnswerItem && update.completed) {
+                yield* Ref.update(completedFinalAnswerTextsByTurn, (current) => {
+                  const updated = new Map(current);
+                  const texts = new Set(updated.get(update.turnId) ?? []);
+                  texts.add(update.text);
+                  updated.set(update.turnId, texts);
+                  return updated;
+                });
+              }
+            }),
+        });
+
+        const emitSubagentUserMessage = (
+          context: ActiveCodexTurnContext,
+          item: Extract<
+            | CodexSchema.V2ItemStartedNotification__ThreadItem
+            | CodexSchema.V2ItemCompletedNotification__ThreadItem,
+            { type: "userMessage" }
+          >,
+        ) =>
+          Effect.gen(function* () {
+            if (context.subagent === null || context.providerTurnOrdinal === 1) {
+              return false;
+            }
+            const text = codexUserMessageText(item.content);
+            if (text.length === 0) {
+              return false;
+            }
+            const now = yield* DateTime.now;
+            const ordinal = yield* resolveItemOrdinal(context, item.id);
+            const artifacts = makeSubagentConversationArtifacts({
+              messageId: idAllocator.derive.messageFromProviderItem({
+                driver: CODEX_PROVIDER,
+                nativeItemId: item.id,
+              }),
+              turnItemId: idAllocator.derive.turnItemFromProviderItem({
+                driver: CODEX_PROVIDER,
+                nativeItemId: item.id,
+              }),
+              threadId: context.projectionThreadId,
+              rootNodeId: context.rootNodeId,
+              providerThreadId: context.providerThread.id,
+              providerTurnId: context.providerTurnId,
+              nativeItemRef: codexNativeItemRef(item.id),
+              role: "user",
+              text,
+              ordinal,
+              now,
+            });
+            yield* emitProviderEvent({
+              type: "message.updated",
+              driver: CODEX_PROVIDER,
+              message: artifacts.message,
+            });
+            yield* emitProviderEvent({
+              type: "turn_item.updated",
+              driver: CODEX_PROVIDER,
+              turnItem: artifacts.turnItem,
+            });
+            return true;
+          });
+
+        const buildCommandExecutionArtifacts = (
+          context: ActiveCodexTurnContext,
+          item: Extract<
+            | CodexSchema.V2ItemStartedNotification__ThreadItem
+            | CodexSchema.V2ItemCompletedNotification__ThreadItem,
+            { type: "commandExecution" }
+          >,
+        ) =>
+          Effect.gen(function* () {
+            const updatedAt = yield* DateTime.now;
+            const status = codexItemStatus(item.status);
+            const completedAt = status.completed ? updatedAt : null;
+            const nodeId = idAllocator.derive.nodeFromProviderItem({
+              driver: CODEX_PROVIDER,
+              nativeItemId: item.id,
+            });
+            const turnItemId = idAllocator.derive.turnItemFromProviderItem({
+              driver: CODEX_PROVIDER,
+              nativeItemId: item.id,
+            });
+            const ordinal = yield* resolveItemOrdinal(context, item.id);
+            const node: OrchestrationV2ExecutionNode = {
+              id: nodeId,
+              threadId: context.projectionThreadId,
+              runId: context.projectionRunId,
+              parentNodeId: context.itemParentNodeId,
+              rootNodeId: context.rootNodeId,
+              kind: "tool_call",
+              status: status.node,
+              countsForRun: false,
+              providerThreadId: context.providerThread.id,
+              providerTurnId: context.providerTurnId,
+              nativeItemRef: codexNativeItemRef(item.id),
+              runtimeRequestId: null,
+              checkpointScopeId: null,
+              startedAt: context.startedAt,
+              completedAt,
+            };
+            const turnItem: OrchestrationV2TurnItem = {
+              id: turnItemId,
+              threadId: context.projectionThreadId,
+              runId: context.projectionRunId,
+              nodeId,
+              providerThreadId: context.providerThread.id,
+              providerTurnId: context.providerTurnId,
+              nativeItemRef: codexNativeItemRef(item.id),
+              parentItemId: null,
+              ordinal,
+              status: status.turnItem,
+              title: null,
+              startedAt: context.startedAt,
+              completedAt,
+              updatedAt,
+              type: "command_execution",
+              input: item.command,
+              ...(item.aggregatedOutput === null || item.aggregatedOutput === undefined
+                ? {}
+                : { output: item.aggregatedOutput }),
+              ...(item.exitCode === null || item.exitCode === undefined
+                ? {}
+                : { exitCode: item.exitCode }),
+            };
+            return { node, turnItem };
+          });
+
+        const buildFileChangeArtifacts = (
+          context: ActiveCodexTurnContext,
+          item: Extract<
+            CodexSchema.V2ItemCompletedNotification__ThreadItem,
+            { type: "fileChange" }
+          >,
+        ) =>
+          Effect.gen(function* () {
+            const firstChange = item.changes[0];
+            if (firstChange === undefined) {
+              return null;
+            }
+
+            const updatedAt = yield* DateTime.now;
+            const status = codexItemStatus(item.status);
+            const completedAt = status.completed ? updatedAt : null;
+            const nodeId = idAllocator.derive.nodeFromProviderItem({
+              driver: CODEX_PROVIDER,
+              nativeItemId: item.id,
+            });
+            const turnItemId = idAllocator.derive.turnItemFromProviderItem({
+              driver: CODEX_PROVIDER,
+              nativeItemId: item.id,
+            });
+            const ordinal = yield* resolveItemOrdinal(context, item.id);
+            const node: OrchestrationV2ExecutionNode = {
+              id: nodeId,
+              threadId: context.projectionThreadId,
+              runId: context.projectionRunId,
+              parentNodeId: context.itemParentNodeId,
+              rootNodeId: context.rootNodeId,
+              kind: "tool_call",
+              status: status.node,
+              countsForRun: false,
+              providerThreadId: context.providerThread.id,
+              providerTurnId: context.providerTurnId,
+              nativeItemRef: codexNativeItemRef(item.id),
+              runtimeRequestId: null,
+              checkpointScopeId: null,
+              startedAt: context.startedAt,
+              completedAt,
+            };
+            const turnItem: OrchestrationV2TurnItem = {
+              id: turnItemId,
+              threadId: context.projectionThreadId,
+              runId: context.projectionRunId,
+              nodeId,
+              providerThreadId: context.providerThread.id,
+              providerTurnId: context.providerTurnId,
+              nativeItemRef: codexNativeItemRef(item.id),
+              parentItemId: null,
+              ordinal,
+              status: status.turnItem,
+              title: null,
+              startedAt: context.startedAt,
+              completedAt,
+              updatedAt,
+              type: "file_change",
+              fileName: firstChange.path,
+              diffStr: firstChange.diff,
+            };
+            return { node, turnItem };
+          });
+
+        const buildWebSearchArtifacts = (input: {
+          readonly context: ActiveCodexTurnContext;
+          readonly item: CodexWebSearchItem;
+          readonly completed: boolean;
+        }) =>
+          Effect.gen(function* () {
+            const updatedAt = yield* DateTime.now;
+            const completedAt = input.completed ? updatedAt : null;
+            const nodeId = idAllocator.derive.nodeFromProviderItem({
+              driver: CODEX_PROVIDER,
+              nativeItemId: input.item.id,
+            });
+            const turnItemId = idAllocator.derive.turnItemFromProviderItem({
+              driver: CODEX_PROVIDER,
+              nativeItemId: input.item.id,
+            });
+            const ordinal = yield* resolveItemOrdinal(input.context, input.item.id);
+            const patterns = webSearchPatterns(input.item);
+            const status = input.completed ? "completed" : "running";
+            const node: OrchestrationV2ExecutionNode = {
+              id: nodeId,
+              threadId: input.context.projectionThreadId,
+              runId: input.context.projectionRunId,
+              parentNodeId: input.context.itemParentNodeId,
+              rootNodeId: input.context.rootNodeId,
+              kind: "tool_call",
+              status,
+              countsForRun: false,
+              providerThreadId: input.context.providerThread.id,
+              providerTurnId: input.context.providerTurnId,
+              nativeItemRef: codexNativeItemRef(input.item.id),
+              runtimeRequestId: null,
+              checkpointScopeId: null,
+              startedAt: input.context.startedAt,
+              completedAt,
+            };
+            const turnItem: OrchestrationV2TurnItem = {
+              id: turnItemId,
+              threadId: input.context.projectionThreadId,
+              runId: input.context.projectionRunId,
+              nodeId,
+              providerThreadId: input.context.providerThread.id,
+              providerTurnId: input.context.providerTurnId,
+              nativeItemRef: codexNativeItemRef(input.item.id),
+              parentItemId: null,
+              ordinal,
+              status,
+              title: null,
+              startedAt: input.context.startedAt,
+              completedAt,
+              updatedAt,
+              type: "web_search",
+              ...(patterns.length === 0 ? {} : { patterns: [...patterns] }),
+            };
+            return { node, turnItem };
+          });
+
+        const buildDynamicToolArtifacts = (
+          context: ActiveCodexTurnContext,
+          item: CodexDynamicToolItem,
+        ) =>
+          Effect.gen(function* () {
+            const updatedAt = yield* DateTime.now;
+            const status = codexItemStatus(item.status);
+            const completedAt = status.completed ? updatedAt : null;
+            const nodeId = idAllocator.derive.nodeFromProviderItem({
+              driver: CODEX_PROVIDER,
+              nativeItemId: item.id,
+            });
+            const turnItemId = idAllocator.derive.turnItemFromProviderItem({
+              driver: CODEX_PROVIDER,
+              nativeItemId: item.id,
+            });
+            const ordinal = yield* resolveItemOrdinal(context, item.id);
+            const projection = projectCodexDynamicToolItem(item);
+            const node: OrchestrationV2ExecutionNode = {
+              id: nodeId,
+              threadId: context.projectionThreadId,
+              runId: context.projectionRunId,
+              parentNodeId: context.itemParentNodeId,
+              rootNodeId: context.rootNodeId,
+              kind: "tool_call",
+              status: status.node,
+              countsForRun: false,
+              providerThreadId: context.providerThread.id,
+              providerTurnId: context.providerTurnId,
+              nativeItemRef: codexNativeItemRef(item.id),
+              runtimeRequestId: null,
+              checkpointScopeId: null,
+              startedAt: context.startedAt,
+              completedAt,
+            };
+            const turnItem: OrchestrationV2TurnItem = {
+              id: turnItemId,
+              threadId: context.projectionThreadId,
+              runId: context.projectionRunId,
+              nodeId,
+              providerThreadId: context.providerThread.id,
+              providerTurnId: context.providerTurnId,
+              nativeItemRef: codexNativeItemRef(item.id),
+              parentItemId: null,
+              ordinal,
+              status: projection.status,
+              title: null,
+              startedAt: context.startedAt,
+              completedAt,
+              updatedAt,
+              type: "dynamic_tool",
+              toolName: projection.toolName,
+              input: projection.input,
+              ...(projection.output === undefined ? {} : { output: projection.output }),
+            };
+            return { node, turnItem };
+          });
+
+        const buildProposedPlanArtifacts = (input: {
+          readonly context: ActiveCodexTurnContext;
+          readonly nativeItemId: string;
+          readonly status: OrchestrationV2PlanArtifact["status"];
+          readonly markdown: string;
+          readonly completed?: boolean;
+        }) =>
+          Effect.gen(function* () {
+            const updatedAt = yield* DateTime.now;
+            const completedAt = input.completed === true ? updatedAt : null;
+            const planId = yield* resolvePlanId(input.context, input.nativeItemId);
+            const nodeId = idAllocator.derive.nodeFromProviderItem({
+              driver: CODEX_PROVIDER,
+              nativeItemId: input.nativeItemId,
+            });
+            const turnItemId = idAllocator.derive.turnItemFromProviderItem({
+              driver: CODEX_PROVIDER,
+              nativeItemId: input.nativeItemId,
+            });
+            const ordinal = yield* resolveItemOrdinal(input.context, input.nativeItemId);
+            const plan: OrchestrationV2PlanArtifact = {
+              id: planId,
+              threadId: input.context.projectionThreadId,
+              runId: input.context.projectionRunId,
+              nodeId,
+              kind: "proposed_plan",
+              status: input.status,
+              markdown: input.markdown,
+            };
+            const node: OrchestrationV2ExecutionNode = {
+              id: nodeId,
+              threadId: input.context.projectionThreadId,
+              runId: input.context.projectionRunId,
+              parentNodeId: input.context.itemParentNodeId,
+              rootNodeId: input.context.rootNodeId,
+              kind: "plan",
+              status: input.completed === true ? "completed" : "running",
+              countsForRun: false,
+              providerThreadId: input.context.providerThread.id,
+              providerTurnId: input.context.providerTurnId,
+              nativeItemRef: codexNativeItemRef(input.nativeItemId),
+              runtimeRequestId: null,
+              checkpointScopeId: null,
+              startedAt: input.context.startedAt,
+              completedAt,
+            };
+            const turnItem: OrchestrationV2TurnItem = {
+              id: turnItemId,
+              threadId: input.context.projectionThreadId,
+              runId: input.context.projectionRunId,
+              nodeId,
+              providerThreadId: input.context.providerThread.id,
+              providerTurnId: input.context.providerTurnId,
+              nativeItemRef: codexNativeItemRef(input.nativeItemId),
+              parentItemId: null,
+              ordinal,
+              status: input.completed === true ? "completed" : "running",
+              title: null,
+              startedAt: input.context.startedAt,
+              completedAt,
+              updatedAt,
+              type: "proposed_plan",
+              planId,
+              markdown: input.markdown,
+              streaming: input.completed !== true,
+            };
+            return { node, plan, turnItem };
+          });
+
+        const buildTodoListArtifacts = (input: {
+          readonly context: ActiveCodexTurnContext;
+          readonly nativeItemId: string;
+          readonly status: OrchestrationV2PlanArtifact["status"];
+          readonly steps: ReadonlyArray<OrchestrationV2PlanStep>;
+          readonly explanation?: string;
+          readonly completed?: boolean;
+        }) =>
+          Effect.gen(function* () {
+            const updatedAt = yield* DateTime.now;
+            const completedAt = input.completed === true ? updatedAt : null;
+            const planId = yield* resolvePlanId(input.context, input.nativeItemId);
+            const nodeId = idAllocator.derive.nodeFromProviderItem({
+              driver: CODEX_PROVIDER,
+              nativeItemId: input.nativeItemId,
+            });
+            const turnItemId = idAllocator.derive.turnItemFromProviderItem({
+              driver: CODEX_PROVIDER,
+              nativeItemId: input.nativeItemId,
+            });
+            const ordinal = yield* resolveItemOrdinal(input.context, input.nativeItemId);
+            const plan: OrchestrationV2PlanArtifact = {
+              id: planId,
+              threadId: input.context.projectionThreadId,
+              runId: input.context.projectionRunId,
+              nodeId,
+              kind: "todo_list",
+              status: input.status,
+              steps: [...input.steps],
+              ...(input.explanation === undefined ? {} : { explanation: input.explanation }),
+            };
+            const node: OrchestrationV2ExecutionNode = {
+              id: nodeId,
+              threadId: input.context.projectionThreadId,
+              runId: input.context.projectionRunId,
+              parentNodeId: input.context.itemParentNodeId,
+              rootNodeId: input.context.rootNodeId,
+              kind: "todo_list",
+              status: input.completed === true ? "completed" : "running",
+              countsForRun: false,
+              providerThreadId: input.context.providerThread.id,
+              providerTurnId: input.context.providerTurnId,
+              nativeItemRef: codexNativeItemRef(input.nativeItemId),
+              runtimeRequestId: null,
+              checkpointScopeId: null,
+              startedAt: input.context.startedAt,
+              completedAt,
+            };
+            const turnItem: OrchestrationV2TurnItem = {
+              id: turnItemId,
+              threadId: input.context.projectionThreadId,
+              runId: input.context.projectionRunId,
+              nodeId,
+              providerThreadId: input.context.providerThread.id,
+              providerTurnId: input.context.providerTurnId,
+              nativeItemRef: codexNativeItemRef(input.nativeItemId),
+              parentItemId: null,
+              ordinal,
+              status: input.completed === true ? "completed" : "running",
+              title: null,
+              startedAt: input.context.startedAt,
+              completedAt,
+              updatedAt,
+              type: "todo_list",
+              planId,
+              steps: [...input.steps],
+              ...(input.explanation === undefined ? {} : { explanation: input.explanation }),
+            };
+            return { node, plan, turnItem };
+          });
+
+        const buildApprovalRequestArtifacts = (input: {
+          readonly context: ActiveCodexTurnContext;
+          readonly nativeItemId: string;
+          readonly nativeRequestId: string;
+          readonly requestKind: ProviderRequestKind;
+          readonly prompt?: string | null;
+          readonly appName?: string;
+          readonly options?: ReadonlyArray<ProviderApprovalOption>;
+        }) =>
+          Effect.gen(function* () {
+            const createdAt = yield* DateTime.now;
+            const parentNodeId = idAllocator.derive.nodeFromProviderItem({
+              driver: CODEX_PROVIDER,
+              nativeItemId: input.nativeItemId,
+            });
+            const ordinal = yield* resolveItemOrdinal(
+              input.context,
+              `${input.nativeItemId}:approval:${input.nativeRequestId}`,
+            );
+            const requestId = yield* idAllocator.allocate.runtimeRequest({
+              driver: CODEX_PROVIDER,
+              providerTurnId: input.context.providerTurnId,
+              nativeRequestId: input.nativeRequestId,
+            });
+            const nodeId = idAllocator.derive.approvalNode({ requestId });
+            const providerSessionId = input.context.input.providerThread.providerSessionId;
+            if (providerSessionId === null) {
+              return yield* toProtocolError(
+                `Provider thread ${input.context.providerThread.id} is missing a provider session id.`,
+              );
+            }
+            const node: OrchestrationV2ExecutionNode = {
+              id: nodeId,
+              threadId: input.context.projectionThreadId,
+              runId: input.context.projectionRunId,
+              parentNodeId,
+              rootNodeId: input.context.rootNodeId,
+              kind: "approval_request",
+              status: "waiting",
+              countsForRun: false,
+              providerThreadId: input.context.providerThread.id,
+              providerTurnId: input.context.providerTurnId,
+              nativeItemRef: codexNativeItemRef(input.nativeItemId),
+              runtimeRequestId: requestId,
+              checkpointScopeId: null,
+              startedAt: createdAt,
+              completedAt: null,
+            };
+            const request: OrchestrationV2RuntimeRequest = {
+              id: requestId,
+              nodeId,
+              providerTurnId: input.context.providerTurnId,
+              nativeRequestRef: {
+                driver: CODEX_PROVIDER,
+                nativeId: input.nativeRequestId,
+                strength: "strong",
+              },
+              kind: input.requestKind,
+              status: "pending",
+              responseCapability: {
+                type: "live",
+                providerSessionId,
+              },
+              createdAt,
+              resolvedAt: null,
+            };
+            const turnItem: OrchestrationV2TurnItem = {
+              id: idAllocator.derive.approvalTurnItem({ requestId }),
+              threadId: input.context.projectionThreadId,
+              runId: input.context.projectionRunId,
+              nodeId,
+              providerThreadId: input.context.providerThread.id,
+              providerTurnId: input.context.providerTurnId,
+              nativeItemRef: codexNativeItemRef(input.nativeItemId),
+              parentItemId: null,
+              ordinal,
+              status: "waiting",
+              title: null,
+              startedAt: createdAt,
+              completedAt: null,
+              updatedAt: createdAt,
+              type: "approval_request",
+              requestId,
+              requestKind: input.requestKind,
+              ...(input.prompt === null || input.prompt === undefined
+                ? {}
+                : { prompt: input.prompt }),
+              ...(input.appName === undefined ? {} : { appName: input.appName }),
+              ...(input.options === undefined ? {} : { options: input.options }),
+            };
+            return { node, request, turnItem };
+          });
+
+        const buildUserInputRequestArtifacts = (input: {
+          readonly context: ActiveCodexTurnContext;
+          readonly nativeItemId: string;
+          readonly nativeRequestId: string;
+          readonly questions: ReadonlyArray<CodexSchema.ToolRequestUserInputParams__ToolRequestUserInputQuestion>;
+        }) =>
+          Effect.gen(function* () {
+            const createdAt = yield* DateTime.now;
+            const requestId = yield* idAllocator.allocate.runtimeRequest({
+              driver: CODEX_PROVIDER,
+              providerTurnId: input.context.providerTurnId,
+              nativeRequestId: input.nativeRequestId,
+            });
+            const providerSessionId = input.context.input.providerThread.providerSessionId;
+            if (providerSessionId === null) {
+              return yield* toProtocolError(
+                `Provider thread ${input.context.providerThread.id} is missing a provider session id.`,
+              );
+            }
+            const questions = input.questions.map((question, index) => ({
+              id: nonEmptyText(question.id, `question-${index + 1}`),
+              header: nonEmptyText(question.header, "Question"),
+              question: nonEmptyText(question.question, "Choose an answer."),
+              options:
+                question.options?.map((option, optionIndex) => ({
+                  label: nonEmptyText(option.label, `Option ${optionIndex + 1}`),
+                  description: nonEmptyText(option.description, option.label),
+                })) ?? [],
+            }));
+            const nodeId = idAllocator.derive.nodeFromProviderItem({
+              driver: CODEX_PROVIDER,
+              nativeItemId: input.nativeItemId,
+            });
+            const turnItemId = idAllocator.derive.turnItemFromProviderItem({
+              driver: CODEX_PROVIDER,
+              nativeItemId: input.nativeItemId,
+            });
+            const ordinal = yield* resolveItemOrdinal(input.context, input.nativeItemId);
+            const node: OrchestrationV2ExecutionNode = {
+              id: nodeId,
+              threadId: input.context.projectionThreadId,
+              runId: input.context.projectionRunId,
+              parentNodeId: input.context.itemParentNodeId,
+              rootNodeId: input.context.rootNodeId,
+              kind: "user_input_request",
+              status: "waiting",
+              countsForRun: false,
+              providerThreadId: input.context.providerThread.id,
+              providerTurnId: input.context.providerTurnId,
+              nativeItemRef: codexNativeItemRef(input.nativeItemId),
+              runtimeRequestId: requestId,
+              checkpointScopeId: null,
+              startedAt: createdAt,
+              completedAt: null,
+            };
+            const request: OrchestrationV2RuntimeRequest = {
+              id: requestId,
+              nodeId,
+              providerTurnId: input.context.providerTurnId,
+              nativeRequestRef: {
+                driver: CODEX_PROVIDER,
+                nativeId: input.nativeRequestId,
+                strength: "strong",
+              },
+              kind: "user_input",
+              status: "pending",
+              responseCapability: {
+                type: "live",
+                providerSessionId,
+              },
+              createdAt,
+              resolvedAt: null,
+            };
+            const turnItem: OrchestrationV2TurnItem = {
+              id: turnItemId,
+              threadId: input.context.projectionThreadId,
+              runId: input.context.projectionRunId,
+              nodeId,
+              providerThreadId: input.context.providerThread.id,
+              providerTurnId: input.context.providerTurnId,
+              nativeItemRef: codexNativeItemRef(input.nativeItemId),
+              parentItemId: null,
+              ordinal,
+              status: "waiting",
+              title: null,
+              startedAt: createdAt,
+              completedAt: null,
+              updatedAt: createdAt,
+              type: "user_input_request",
+              requestId,
+              questions,
+            };
+            return { node, request, turnItem };
+          });
+
+        yield* client.handleServerNotification("item/agentMessage/delta", (payload) =>
+          Effect.gen(function* () {
+            const context = (yield* Ref.get(activeTurns)).get(payload.turnId);
+            if (context !== undefined) {
+              yield* completeProviderRetry(context, yield* DateTime.now);
+            }
+            yield* agentMessageDeltas.append({
+              turnId: payload.turnId,
+              itemId: payload.itemId,
+              delta: payload.delta,
+            });
+          }),
+        );
+
+        yield* client.handleServerNotification("item/plan/delta", (payload) =>
+          Effect.gen(function* () {
+            const context = yield* awaitActiveTurn(payload.turnId);
+            if (context === undefined) {
+              return;
+            }
+            yield* completeProviderRetry(context, yield* DateTime.now);
+            const markdown = yield* Ref.modify(planDeltas, (current) => {
+              const updated = new Map(current);
+              const next = `${updated.get(payload.itemId) ?? ""}${payload.delta}`;
+              updated.set(payload.itemId, next);
+              return [next, updated];
+            });
+            const artifacts = yield* buildProposedPlanArtifacts({
+              context,
+              nativeItemId: payload.itemId,
+              status: "active",
+              markdown,
+            });
+            yield* emitProviderEvent({
+              type: "node.updated",
+              driver: CODEX_PROVIDER,
+              node: artifacts.node,
+            });
+            yield* emitProviderEvent({
+              type: "plan.updated",
+              driver: CODEX_PROVIDER,
+              plan: artifacts.plan,
+            });
+            yield* emitProviderEvent({
+              type: "turn_item.updated",
+              driver: CODEX_PROVIDER,
+              turnItem: artifacts.turnItem,
+            });
+          }).pipe(Effect.orDie),
+        );
+
+        yield* client.handleServerNotification("turn/plan/updated", (payload) =>
+          Effect.gen(function* () {
+            const context = yield* awaitActiveTurn(payload.turnId);
+            if (context === undefined) {
+              return;
+            }
+            yield* completeProviderRetry(context, yield* DateTime.now);
+            const steps = payload.plan.map((step, index) => ({
+              id: `step-${index + 1}`,
+              text: nonEmptyText(step.step, `Step ${index + 1}`),
+              status: codexPlanStepStatus(step.status),
+            }));
+            const explanation = trimText(payload.explanation);
+            const artifacts = yield* buildTodoListArtifacts({
+              context,
+              nativeItemId: `turn-plan:${payload.turnId}`,
+              status: "active",
+              ...(explanation === undefined ? {} : { explanation }),
+              steps,
+            });
+            yield* emitProviderEvent({
+              type: "node.updated",
+              driver: CODEX_PROVIDER,
+              node: artifacts.node,
+            });
+            yield* emitProviderEvent({
+              type: "plan.updated",
+              driver: CODEX_PROVIDER,
+              plan: artifacts.plan,
+            });
+            yield* emitProviderEvent({
+              type: "turn_item.updated",
+              driver: CODEX_PROVIDER,
+              turnItem: artifacts.turnItem,
+            });
+          }).pipe(Effect.orDie),
+        );
+
+        yield* client.handleServerNotification("thread/tokenUsage/updated", (payload) =>
+          Effect.gen(function* () {
+            const context = yield* awaitActiveTurn(payload.turnId);
+            if (context === undefined) {
+              return;
+            }
+            const now = yield* DateTime.now;
+            // Live context usage rides on the provider turn (#8144): the turn
+            // is the natural owner and re-emitting it never disturbs items.
+            yield* emitProviderEvent({
+              type: "provider_turn.updated",
+              driver: CODEX_PROVIDER,
+              threadId: context.projectionThreadId,
+              providerTurn: {
+                id: context.providerTurnId,
+                providerThreadId: context.providerThread.id,
+                nodeId: context.providerNodeId,
+                runAttemptId: context.subagent === null ? context.input.attemptId : null,
+                nativeTurnRef: {
+                  driver: CODEX_PROVIDER,
+                  nativeId: payload.turnId,
+                  strength: "strong",
+                },
+                ordinal: context.providerTurnOrdinal,
+                status: "running",
+                startedAt: context.startedAt,
+                completedAt: null,
+                tokenUsage: codexProviderTurnTokenUsage(
+                  payload.tokenUsage,
+                  DateTime.formatIso(now),
+                ),
+              },
+            });
+          }).pipe(Effect.orDie),
+        );
+
+        yield* client.handleServerNotification("turn/started", (payload) =>
+          Effect.gen(function* () {
+            const context = (yield* Ref.get(activeTurns)).get(payload.turn.id);
+            if (context !== undefined) {
+              return;
+            }
+            const pendingRootTurn = (yield* Ref.get(pendingRootTurns)).get(payload.threadId);
+            if (pendingRootTurn !== undefined) {
+              yield* registerRootTurn({
+                turnInput: pendingRootTurn,
+                nativeTurnId: payload.turn.id,
+                startedAt: codexTimestamp(payload.turn.startedAt),
+              });
+              yield* Ref.update(pendingRootTurns, (current) => {
+                const updated = new Map(current);
+                updated.delete(payload.threadId);
+                return updated;
+              });
+              return;
+            }
+            yield* rememberSubagentTurnStarted({
+              nativeThreadId: payload.threadId,
+              nativeTurnId: payload.turn.id,
+              startedAt: codexTimestamp(payload.turn.startedAt),
+            });
+          }).pipe(Effect.orDie, turnTerminalizationPermit.withPermits(1)),
+        );
+
+        yield* client.handleServerNotification("error", (payload) =>
+          Effect.gen(function* () {
+            if (!payload.willRetry) {
+              return;
+            }
+            const context = yield* awaitActiveTurn(payload.turnId);
+            if (context === undefined) {
+              return;
+            }
+            const updatedAt = yield* DateTime.now;
+            const previous = (yield* Ref.get(providerRetries)).get(context.providerTurnId);
+            const progress = parseCodexRetryProgress(payload.error.message);
+            const retry: OrchestrationV2ProviderRetry = {
+              attempt: progress?.attempt ?? (previous?.retry.attempt ?? 0) + 1,
+              maxAttempts: progress?.maxAttempts ?? previous?.retry.maxAttempts ?? null,
+              retryDelayMs: null,
+            };
+            const code = codexErrorInfoCode(payload.error.codexErrorInfo);
+            const additionalDetails = payload.error.additionalDetails?.trim();
+            const failure = makeProviderFailure({
+              message:
+                additionalDetails === undefined || additionalDetails.length === 0
+                  ? payload.error.message
+                  : additionalDetails,
+              code,
+              class:
+                code?.startsWith("http") === true || code?.startsWith("responseStream") === true
+                  ? "transport_error"
+                  : "provider_error",
+              retryable: true,
+            });
+            const itemOrdinal =
+              previous?.itemOrdinal ??
+              (yield* resolveItemOrdinal(context, `terminal-failure:${context.providerTurnId}`));
+            const state: ActiveCodexProviderRetry = {
+              retry,
+              failure,
+              startedAt: previous?.startedAt ?? updatedAt,
+              itemOrdinal,
+            };
+            yield* Ref.update(providerRetries, (current) => {
+              const updated = new Map(current);
+              updated.set(context.providerTurnId, state);
+              return updated;
+            });
+            yield* emitProviderEvent({
+              type: "turn_item.updated",
+              driver: CODEX_PROVIDER,
+              turnItem: makeProviderRetryTurnItem({
+                idAllocator,
+                driver: CODEX_PROVIDER,
+                threadId: context.projectionThreadId,
+                runId: context.projectionRunId,
+                nodeId: context.providerNodeId,
+                providerThreadId: context.providerThread.id,
+                providerTurnId: context.providerTurnId,
+                itemOrdinal,
+                failure,
+                retry,
+                status: "running",
+                startedAt: state.startedAt,
+                updatedAt,
+              }),
+            });
+          }).pipe(Effect.orDie),
+        );
+
+        yield* client.handleServerNotification("item/started", (payload) =>
+          Effect.gen(function* () {
+            const context = yield* awaitActiveTurn(payload.turnId);
+            if (context === undefined) {
+              return;
+            }
+
+            if (payload.item.type === "userMessage") {
+              yield* emitSubagentUserMessage(context, payload.item);
+              return;
+            }
+
+            if (payload.item.type === "subAgentActivity") {
+              yield* registerSubagentActivity({
+                context,
+                item: payload.item,
+              });
+              return;
+            }
+
+            yield* completeProviderRetry(context, yield* DateTime.now);
+
+            if (payload.item.type === "agentMessage") {
+              if (payload.item.phase !== "commentary") {
+                yield* Ref.update(finalAnswerItemIdsByTurn, (current) => {
+                  const updated = new Map(current);
+                  const itemIds = new Set(updated.get(payload.turnId) ?? []);
+                  itemIds.add(payload.item.id);
+                  updated.set(payload.turnId, itemIds);
+                  return updated;
+                });
+              }
+              return;
+            }
+
+            if (payload.item.type === "commandExecution") {
+              if (!codexItemStatus(payload.item.status).completed) {
+                yield* trackRunningCommandItem(payload.turnId, {
+                  id: payload.item.id,
+                  command: payload.item.command,
+                  ...(payload.item.aggregatedOutput === null ||
+                  payload.item.aggregatedOutput === undefined
+                    ? {}
+                    : { aggregatedOutput: payload.item.aggregatedOutput }),
+                  ...(typeof payload.item.processId === "string"
+                    ? { processId: payload.item.processId }
+                    : {}),
+                });
+              }
+              const artifacts = yield* buildCommandExecutionArtifacts(context, payload.item);
+              yield* emitProviderEvent({
+                type: "node.updated",
+                driver: CODEX_PROVIDER,
+                node: artifacts.node,
+              });
+              yield* emitProviderEvent({
+                type: "turn_item.updated",
+                driver: CODEX_PROVIDER,
+                turnItem: artifacts.turnItem,
+              });
+              return;
+            }
+
+            if (payload.item.type === "mcpToolCall" || payload.item.type === "dynamicToolCall") {
+              const artifacts = yield* buildDynamicToolArtifacts(context, payload.item);
+              yield* emitProviderEvent({
+                type: "node.updated",
+                driver: CODEX_PROVIDER,
+                node: artifacts.node,
+              });
+              yield* emitProviderEvent({
+                type: "turn_item.updated",
+                driver: CODEX_PROVIDER,
+                turnItem: artifacts.turnItem,
+              });
+              return;
+            }
+
+            if (payload.item.type !== "webSearch") {
+              return;
+            }
+
+            const artifacts = yield* buildWebSearchArtifacts({
+              context,
+              item: payload.item,
+              completed: false,
+            });
+            yield* emitProviderEvent({
+              type: "node.updated",
+              driver: CODEX_PROVIDER,
+              node: artifacts.node,
+            });
+            yield* emitProviderEvent({
+              type: "turn_item.updated",
+              driver: CODEX_PROVIDER,
+              turnItem: artifacts.turnItem,
+            });
+          }).pipe(Effect.orDie, turnTerminalizationPermit.withPermits(1)),
+        );
+
+        yield* client.handleServerNotification("item/completed", (payload) =>
+          Effect.gen(function* () {
+            const resolved = yield* resolveItemEventContext(payload.turnId);
+            if (resolved === undefined) {
+              return;
+            }
+            const { context, settled } = resolved;
+
+            if (payload.item.type === "userMessage") {
+              if (yield* emitSubagentUserMessage(context, payload.item)) {
+                return;
+              }
+            }
+
+            if (payload.item.type === "commandExecution") {
+              const turnDrained = yield* clearRunningCommandItem(payload.turnId, payload.item.id);
+              const artifacts = yield* buildCommandExecutionArtifacts(context, payload.item);
+              yield* emitProviderEvent({
+                type: "node.updated",
+                driver: CODEX_PROVIDER,
+                node: artifacts.node,
+              });
+              yield* emitProviderEvent({
+                type: "turn_item.updated",
+                driver: CODEX_PROVIDER,
+                turnItem: artifacts.turnItem,
+              });
+              if (settled) {
+                if (context.subagent === null && continuationRequests !== undefined) {
+                  const alreadyOffered = yield* Ref.modify(
+                    offeredContinuationItemsByTurn,
+                    (current) => {
+                      const items = current.get(payload.turnId);
+                      if (items !== undefined && items.has(payload.item.id)) {
+                        return [true, current] as const;
+                      }
+                      const updated = new Map(current);
+                      const updatedItems = new Set(items ?? []);
+                      updatedItems.add(payload.item.id);
+                      updated.set(payload.turnId, updatedItems);
+                      return [false, updated] as const;
+                    },
+                  );
+                  if (!alreadyOffered) {
+                    yield* continuationRequests.offer({
+                      threadId: context.projectionThreadId,
+                      providerThreadId: context.providerThread.id,
+                      driver: CODEX_PROVIDER,
+                      detail: codexBackgroundCommandDetail(payload.item),
+                    });
+                  }
+                }
+                if (turnDrained) {
+                  yield* Ref.update(settledTurns, (current) => {
+                    const updated = new Map(current);
+                    updated.delete(payload.turnId);
+                    return updated;
+                  });
+                  yield* Ref.update(offeredContinuationItemsByTurn, (current) => {
+                    if (!current.has(payload.turnId)) {
+                      return current;
+                    }
+                    const updated = new Map(current);
+                    updated.delete(payload.turnId);
+                    return updated;
+                  });
+                  yield* Ref.update(completedFinalAnswerTextsByTurn, (current) => {
+                    if (!current.has(payload.turnId)) {
+                      return current;
+                    }
+                    const updated = new Map(current);
+                    updated.delete(payload.turnId);
+                    return updated;
+                  });
+                  yield* Ref.update(finalAnswerItemIdsByTurn, (current) => {
+                    if (!current.has(payload.turnId)) {
+                      return current;
+                    }
+                    const updated = new Map(current);
+                    updated.delete(payload.turnId);
+                    return updated;
+                  });
+                }
+              }
+              return;
+            }
+
+            if (payload.item.type === "mcpToolCall" || payload.item.type === "dynamicToolCall") {
+              const artifacts = yield* buildDynamicToolArtifacts(context, payload.item);
+              yield* emitProviderEvent({
+                type: "node.updated",
+                driver: CODEX_PROVIDER,
+                node: artifacts.node,
+              });
+              yield* emitProviderEvent({
+                type: "turn_item.updated",
+                driver: CODEX_PROVIDER,
+                turnItem: artifacts.turnItem,
+              });
+              return;
+            }
+
+            if (payload.item.type === "fileChange") {
+              const artifacts = yield* buildFileChangeArtifacts(context, payload.item);
+              if (artifacts === null) {
+                return;
+              }
+              yield* emitProviderEvent({
+                type: "node.updated",
+                driver: CODEX_PROVIDER,
+                node: artifacts.node,
+              });
+              yield* emitProviderEvent({
+                type: "turn_item.updated",
+                driver: CODEX_PROVIDER,
+                turnItem: artifacts.turnItem,
+              });
+              return;
+            }
+
+            if (payload.item.type === "webSearch") {
+              const artifacts = yield* buildWebSearchArtifacts({
+                context,
+                item: payload.item,
+                completed: true,
+              });
+              yield* emitProviderEvent({
+                type: "node.updated",
+                driver: CODEX_PROVIDER,
+                node: artifacts.node,
+              });
+              yield* emitProviderEvent({
+                type: "turn_item.updated",
+                driver: CODEX_PROVIDER,
+                turnItem: artifacts.turnItem,
+              });
+              return;
+            }
+
+            if (payload.item.type === "plan") {
+              const deltas = yield* Ref.get(planDeltas);
+              const markdown =
+                payload.item.text.length > 0
+                  ? payload.item.text
+                  : (deltas.get(payload.item.id) ?? "");
+              const artifacts = yield* buildProposedPlanArtifacts({
+                context,
+                nativeItemId: payload.item.id,
+                status: "completed",
+                markdown,
+                completed: true,
+              });
+              yield* emitProviderEvent({
+                type: "node.updated",
+                driver: CODEX_PROVIDER,
+                node: artifacts.node,
+              });
+              yield* emitProviderEvent({
+                type: "plan.updated",
+                driver: CODEX_PROVIDER,
+                plan: artifacts.plan,
+              });
+              yield* emitProviderEvent({
+                type: "turn_item.updated",
+                driver: CODEX_PROVIDER,
+                turnItem: artifacts.turnItem,
+              });
+              return;
+            }
+
+            if (payload.item.type === "collabAgentToolCall") {
+              yield* registerSubagentThreads({
+                context,
+                item: payload.item,
+              });
+              yield* updateSubagentStates({
+                item: payload.item,
+              });
+              return;
+            }
+
+            if (payload.item.type === "subAgentActivity") {
+              yield* registerSubagentActivity({
+                context,
+                item: payload.item,
+              });
+              return;
+            }
+
+            if (payload.item.type !== "agentMessage") {
+              return;
+            }
+
+            const finalAnswer = payload.item.phase !== "commentary";
+            if (finalAnswer) {
+              yield* Ref.update(finalAnswerItemIdsByTurn, (current) => {
+                const updated = new Map(current);
+                const itemIds = new Set(updated.get(payload.turnId) ?? []);
+                itemIds.add(payload.item.id);
+                updated.set(payload.turnId, itemIds);
+                return updated;
+              });
+            }
+            const completedTextsBefore =
+              (yield* Ref.get(completedFinalAnswerTextsByTurn)).get(payload.turnId) ??
+              new Set<string>();
+            const text = yield* agentMessageDeltas.complete({
+              turnId: payload.turnId,
+              itemId: payload.item.id,
+              finalText: payload.item.text,
+            });
+            yield* Ref.update(finalAnswerItemIdsByTurn, (current) => {
+              const itemIds = current.get(payload.turnId);
+              if (itemIds === undefined || !itemIds.has(payload.item.id)) {
+                return current;
+              }
+              const updated = new Map(current);
+              const remainingItemIds = new Set(itemIds);
+              remainingItemIds.delete(payload.item.id);
+              if (remainingItemIds.size === 0) {
+                updated.delete(payload.turnId);
+              } else {
+                updated.set(payload.turnId, remainingItemIds);
+              }
+              return updated;
+            });
+            const emitted =
+              !finalAnswer ||
+              completedTextsBefore.size === 0 ||
+              (text.length > 0 && !completedTextsBefore.has(text));
+            if (emitted && context.subagent !== null && finalAnswer) {
+              yield* emitSubagentTaskUpdate({
+                subagent: context.subagent,
+                status: context.subagent.task.status,
+                result: text,
+              });
+            }
+          }).pipe(Effect.orDie, turnTerminalizationPermit.withPermits(1)),
+        );
+
+        yield* client.handleServerRequest("item/commandExecution/requestApproval", (payload) =>
+          Effect.gen(function* () {
+            const context = yield* awaitActiveTurn(payload.turnId);
+            if (context === undefined) {
+              return yield* toProtocolError(
+                `No active Codex turn context for approval turn ${payload.turnId}.`,
+                payload,
+              );
+            }
+
+            const nativeRequestId = payload.approvalId ?? payload.itemId;
+            const artifacts = yield* buildApprovalRequestArtifacts({
+              context,
+              nativeItemId: payload.itemId,
+              nativeRequestId,
+              requestKind: "command",
+              ...((payload.reason ?? payload.command) === undefined
+                ? {}
+                : { prompt: payload.reason ?? payload.command }),
+            });
+            const decision = yield* Deferred.make<ProviderApprovalDecision, never>();
+            yield* Ref.update(pendingRuntimeRequests, (current) => {
+              const updated = new Map(current);
+              updated.set(String(artifacts.request.id), {
+                type: "approval",
+                requestId: artifacts.request.id,
+                requestKind: "command",
+                decision,
+              });
+              return updated;
+            });
+            yield* emitProviderEvent({
+              type: "node.updated",
+              driver: CODEX_PROVIDER,
+              node: artifacts.node,
+            });
+            yield* emitProviderEvent({
+              type: "runtime_request.updated",
+              driver: CODEX_PROVIDER,
+              threadId: artifacts.node.threadId,
+              runtimeRequest: artifacts.request,
+            });
+            yield* emitProviderEvent({
+              type: "turn_item.updated",
+              driver: CODEX_PROVIDER,
+              turnItem: artifacts.turnItem,
+            });
+
+            const resolved = yield* Deferred.await(decision).pipe(
+              Effect.ensuring(
+                Ref.update(pendingRuntimeRequests, (current) => {
+                  const updated = new Map(current);
+                  updated.delete(String(artifacts.request.id));
+                  return updated;
+                }),
+              ),
+            );
+            return {
+              decision: resolved === "acceptAlways" ? "acceptForSession" : resolved,
+            } satisfies CodexSchema.CommandExecutionRequestApprovalResponse;
+          }).pipe(Effect.orDie),
+        );
+
+        yield* client.handleServerRequest("item/fileChange/requestApproval", (payload) =>
+          Effect.gen(function* () {
+            const context = yield* awaitActiveTurn(payload.turnId);
+            if (context === undefined) {
+              return yield* toProtocolError(
+                `No active Codex turn context for file change approval turn ${payload.turnId}.`,
+                payload,
+              );
+            }
+
+            const artifacts = yield* buildApprovalRequestArtifacts({
+              context,
+              nativeItemId: payload.itemId,
+              nativeRequestId: payload.itemId,
+              requestKind: "file-change",
+              ...(payload.reason === undefined ? {} : { prompt: payload.reason }),
+            });
+            const decision = yield* Deferred.make<ProviderApprovalDecision, never>();
+            yield* Ref.update(pendingRuntimeRequests, (current) => {
+              const updated = new Map(current);
+              updated.set(String(artifacts.request.id), {
+                type: "approval",
+                requestId: artifacts.request.id,
+                requestKind: "file-change",
+                decision,
+              });
+              return updated;
+            });
+            yield* emitProviderEvent({
+              type: "node.updated",
+              driver: CODEX_PROVIDER,
+              node: artifacts.node,
+            });
+            yield* emitProviderEvent({
+              type: "runtime_request.updated",
+              driver: CODEX_PROVIDER,
+              threadId: artifacts.node.threadId,
+              runtimeRequest: artifacts.request,
+            });
+            yield* emitProviderEvent({
+              type: "turn_item.updated",
+              driver: CODEX_PROVIDER,
+              turnItem: artifacts.turnItem,
+            });
+
+            const resolved = yield* Deferred.await(decision).pipe(
+              Effect.ensuring(
+                Ref.update(pendingRuntimeRequests, (current) => {
+                  const updated = new Map(current);
+                  updated.delete(String(artifacts.request.id));
+                  return updated;
+                }),
+              ),
+            );
+            return {
+              decision: resolved === "acceptAlways" ? "acceptForSession" : resolved,
+            } satisfies CodexSchema.FileChangeRequestApprovalResponse;
+          }).pipe(Effect.orDie),
+        );
+
+        yield* client.handleServerRequest("item/permissions/requestApproval", (payload) =>
+          Effect.gen(function* () {
+            const context = yield* awaitActiveTurn(payload.turnId);
+            if (context === undefined) {
+              return yield* toProtocolError(
+                `No active Codex turn context for permissions approval turn ${payload.turnId}.`,
+                payload,
+              );
+            }
+
+            const requestKind = providerRequestKindFromPermissions(payload.permissions);
+            const artifacts = yield* buildApprovalRequestArtifacts({
+              context,
+              nativeItemId: payload.itemId,
+              nativeRequestId: payload.itemId,
+              requestKind,
+              ...(payload.reason === undefined ? {} : { prompt: payload.reason }),
+            });
+            const decision = yield* Deferred.make<ProviderApprovalDecision, never>();
+            yield* Ref.update(pendingRuntimeRequests, (current) => {
+              const updated = new Map(current);
+              updated.set(String(artifacts.request.id), {
+                type: "approval",
+                requestId: artifacts.request.id,
+                requestKind,
+                decision,
+              });
+              return updated;
+            });
+            yield* emitProviderEvent({
+              type: "node.updated",
+              driver: CODEX_PROVIDER,
+              node: artifacts.node,
+            });
+            yield* emitProviderEvent({
+              type: "runtime_request.updated",
+              driver: CODEX_PROVIDER,
+              threadId: artifacts.node.threadId,
+              runtimeRequest: artifacts.request,
+            });
+            yield* emitProviderEvent({
+              type: "turn_item.updated",
+              driver: CODEX_PROVIDER,
+              turnItem: artifacts.turnItem,
+            });
+
+            const resolved = yield* Deferred.await(decision).pipe(
+              Effect.ensuring(
+                Ref.update(pendingRuntimeRequests, (current) => {
+                  const updated = new Map(current);
+                  updated.delete(String(artifacts.request.id));
+                  return updated;
+                }),
+              ),
+            );
+            return permissionsResponseFromDecision({
+              decision: resolved,
+              permissions: payload.permissions,
+            });
+          }).pipe(Effect.orDie),
+        );
+
+        yield* client.handleServerRequest("mcpServer/elicitation/request", (payload) =>
+          Effect.gen(function* () {
+            // Unsupported elicitation shapes cannot express an approval, so
+            // decline instead of presenting a request the user cannot answer.
+            if (toMcpElicitationResponse(payload, "accept").action !== "accept") {
+              yield* Effect.logWarning("Declined an unsupported MCP elicitation.", {
+                serverName: payload.serverName,
+                mode: payload.mode,
+              });
+              return {
+                action: "decline",
+              } satisfies CodexSchema.McpServerElicitationRequestResponse;
+            }
+            const context =
+              payload.turnId === undefined || payload.turnId === null
+                ? undefined
+                : yield* awaitActiveTurn(payload.turnId);
+            if (context === undefined) {
+              yield* Effect.logWarning(
+                "Declined an MCP elicitation without an active Codex turn context.",
+                { serverName: payload.serverName },
+              );
+              return {
+                action: "decline",
+              } satisfies CodexSchema.McpServerElicitationRequestResponse;
+            }
+
+            const nativeRequestId =
+              payload.mode === "url"
+                ? payload.elicitationId
+                : `mcp-elicitation:${payload.serverName}`;
+            const described = describeMcpElicitation(payload);
+            const artifacts = yield* buildApprovalRequestArtifacts({
+              context,
+              nativeItemId: nativeRequestId,
+              nativeRequestId,
+              requestKind: "mcp-elicitation",
+              prompt: payload.message,
+              appName: described.appName,
+              options: described.options,
+            });
+            const decision = yield* Deferred.make<ProviderApprovalDecision, never>();
+            yield* Ref.update(pendingRuntimeRequests, (current) => {
+              const updated = new Map(current);
+              updated.set(String(artifacts.request.id), {
+                type: "approval",
+                requestId: artifacts.request.id,
+                requestKind: "mcp-elicitation",
+                decision,
+              });
+              return updated;
+            });
+            yield* emitProviderEvent({
+              type: "node.updated",
+              driver: CODEX_PROVIDER,
+              node: artifacts.node,
+            });
+            yield* emitProviderEvent({
+              type: "runtime_request.updated",
+              driver: CODEX_PROVIDER,
+              threadId: artifacts.node.threadId,
+              runtimeRequest: artifacts.request,
+            });
+            yield* emitProviderEvent({
+              type: "turn_item.updated",
+              driver: CODEX_PROVIDER,
+              turnItem: artifacts.turnItem,
+            });
+
+            const resolved = yield* Deferred.await(decision).pipe(
+              Effect.ensuring(
+                Ref.update(pendingRuntimeRequests, (current) => {
+                  const updated = new Map(current);
+                  updated.delete(String(artifacts.request.id));
+                  return updated;
+                }),
+              ),
+            );
+            return toMcpElicitationResponse(payload, resolved);
+          }).pipe(Effect.orDie),
+        );
+
+        yield* client.handleServerRequest("execCommandApproval", (payload) =>
+          Effect.gen(function* () {
+            const context = yield* findActiveTurnByNativeThreadId(payload.conversationId);
+            if (context === undefined) {
+              return yield* toProtocolError(
+                `No active Codex turn context for exec approval thread ${payload.conversationId}.`,
+                payload,
+              );
+            }
+
+            const nativeRequestId = payload.approvalId ?? payload.callId;
+            const artifacts = yield* buildApprovalRequestArtifacts({
+              context,
+              nativeItemId: payload.callId,
+              nativeRequestId,
+              requestKind: "command",
+              prompt: payload.reason ?? payload.command.join(" "),
+            });
+            const decision = yield* Deferred.make<ProviderApprovalDecision, never>();
+            yield* Ref.update(pendingRuntimeRequests, (current) => {
+              const updated = new Map(current);
+              updated.set(String(artifacts.request.id), {
+                type: "approval",
+                requestId: artifacts.request.id,
+                requestKind: "command",
+                decision,
+              });
+              return updated;
+            });
+            yield* emitProviderEvent({
+              type: "node.updated",
+              driver: CODEX_PROVIDER,
+              node: artifacts.node,
+            });
+            yield* emitProviderEvent({
+              type: "runtime_request.updated",
+              driver: CODEX_PROVIDER,
+              threadId: artifacts.node.threadId,
+              runtimeRequest: artifacts.request,
+            });
+            yield* emitProviderEvent({
+              type: "turn_item.updated",
+              driver: CODEX_PROVIDER,
+              turnItem: artifacts.turnItem,
+            });
+
+            const resolved = yield* Deferred.await(decision).pipe(
+              Effect.ensuring(
+                Ref.update(pendingRuntimeRequests, (current) => {
+                  const updated = new Map(current);
+                  updated.delete(String(artifacts.request.id));
+                  return updated;
+                }),
+              ),
+            );
+            return {
+              decision: approvalDecisionToLegacyReviewDecision(resolved),
+            } satisfies CodexSchema.ExecCommandApprovalResponse;
+          }).pipe(Effect.orDie),
+        );
+
+        yield* client.handleServerRequest("applyPatchApproval", (payload) =>
+          Effect.gen(function* () {
+            const context = yield* findActiveTurnByNativeThreadId(payload.conversationId);
+            if (context === undefined) {
+              return yield* toProtocolError(
+                `No active Codex turn context for apply patch approval thread ${payload.conversationId}.`,
+                payload,
+              );
+            }
+
+            const artifacts = yield* buildApprovalRequestArtifacts({
+              context,
+              nativeItemId: payload.callId,
+              nativeRequestId: payload.callId,
+              requestKind: "file-change",
+              prompt: payload.reason ?? Object.keys(payload.fileChanges).join(", "),
+            });
+            const decision = yield* Deferred.make<ProviderApprovalDecision, never>();
+            yield* Ref.update(pendingRuntimeRequests, (current) => {
+              const updated = new Map(current);
+              updated.set(String(artifacts.request.id), {
+                type: "approval",
+                requestId: artifacts.request.id,
+                requestKind: "file-change",
+                decision,
+              });
+              return updated;
+            });
+            yield* emitProviderEvent({
+              type: "node.updated",
+              driver: CODEX_PROVIDER,
+              node: artifacts.node,
+            });
+            yield* emitProviderEvent({
+              type: "runtime_request.updated",
+              driver: CODEX_PROVIDER,
+              threadId: artifacts.node.threadId,
+              runtimeRequest: artifacts.request,
+            });
+            yield* emitProviderEvent({
+              type: "turn_item.updated",
+              driver: CODEX_PROVIDER,
+              turnItem: artifacts.turnItem,
+            });
+
+            const resolved = yield* Deferred.await(decision).pipe(
+              Effect.ensuring(
+                Ref.update(pendingRuntimeRequests, (current) => {
+                  const updated = new Map(current);
+                  updated.delete(String(artifacts.request.id));
+                  return updated;
+                }),
+              ),
+            );
+            return {
+              decision: approvalDecisionToLegacyReviewDecision(resolved),
+            } satisfies CodexSchema.ApplyPatchApprovalResponse;
+          }).pipe(Effect.orDie),
+        );
+
+        yield* client.handleServerRequest("item/tool/requestUserInput", (payload) =>
+          Effect.gen(function* () {
+            const context = yield* awaitActiveTurn(payload.turnId);
+            if (context === undefined) {
+              return yield* toProtocolError(
+                `No active Codex turn context for user input request turn ${payload.turnId}.`,
+                payload,
+              );
+            }
+
+            const artifacts = yield* buildUserInputRequestArtifacts({
+              context,
+              nativeItemId: payload.itemId,
+              nativeRequestId: payload.itemId,
+              questions: payload.questions,
+            });
+            const answers = yield* Deferred.make<ProviderUserInputAnswers, never>();
+            yield* Ref.update(pendingRuntimeRequests, (current) => {
+              const updated = new Map(current);
+              updated.set(String(artifacts.request.id), {
+                type: "user_input",
+                requestId: artifacts.request.id,
+                answers,
+              });
+              return updated;
+            });
+            yield* emitProviderEvent({
+              type: "node.updated",
+              driver: CODEX_PROVIDER,
+              node: artifacts.node,
+            });
+            yield* emitProviderEvent({
+              type: "runtime_request.updated",
+              driver: CODEX_PROVIDER,
+              threadId: artifacts.node.threadId,
+              runtimeRequest: artifacts.request,
+            });
+            yield* emitProviderEvent({
+              type: "turn_item.updated",
+              driver: CODEX_PROVIDER,
+              turnItem: artifacts.turnItem,
+            });
+
+            const resolved = yield* Deferred.await(answers).pipe(
+              Effect.ensuring(
+                Ref.update(pendingRuntimeRequests, (current) => {
+                  const updated = new Map(current);
+                  updated.delete(String(artifacts.request.id));
+                  return updated;
+                }),
+              ),
+            );
+            return {
+              answers: toCodexUserInputAnswers(
+                resolved,
+                new Set(payload.questions.map((question) => question.id)),
+              ),
+            } satisfies CodexSchema.ToolRequestUserInputResponse;
+          }).pipe(Effect.orDie),
+        );
+
+        const makeRootTerminalEvent = Effect.fn("CodexAdapterV2.makeRootTerminalEvent")(
+          function* (input: {
+            readonly context: ActiveCodexTurnContext;
+            readonly status: OrchestrationV2ProviderTurn["status"];
+            readonly failureMessage?: string;
+            readonly providerRetry?: ActiveCodexProviderRetry;
+          }): Effect.fn.Return<CodexRootTerminalEvent> {
+            const terminalStatus = providerTurnStatusToTerminal(input.status);
+            if (terminalStatus === "failed") {
+              return {
+                type: "turn.terminal",
+                driver: CODEX_PROVIDER,
+                providerThreadId: input.context.providerThread.id,
+                providerTurnId: input.context.providerTurnId,
+                runOrdinal: input.context.input.runOrdinal,
+                failureItemOrdinal: yield* resolveItemOrdinal(
+                  input.context,
+                  `terminal-failure:${input.context.providerTurnId}`,
+                ),
+                status: terminalStatus,
+                failure:
+                  input.failureMessage === undefined && input.providerRetry !== undefined
+                    ? input.providerRetry.failure
+                    : makeProviderFailure({
+                        message: input.failureMessage,
+                        class: "provider_error",
+                      }),
+                ...(input.providerRetry === undefined
+                  ? {}
+                  : {
+                      retry: input.providerRetry.retry,
+                      retryStartedAt: input.providerRetry.startedAt,
+                    }),
+                threadDisposition: "reusable",
+              };
+            }
+            return {
+              type: "turn.terminal",
+              driver: CODEX_PROVIDER,
+              providerThreadId: input.context.providerThread.id,
+              providerTurnId: input.context.providerTurnId,
+              runOrdinal: input.context.input.runOrdinal,
+              status: terminalStatus,
+              failure: null,
+              threadDisposition: "reusable",
+            };
+          },
+        );
+
+        const emitOrDeferRootTerminal = Effect.fn("CodexAdapterV2.emitOrDeferRootTerminal")(
+          function* (input: {
+            readonly context: ActiveCodexTurnContext;
+            readonly nativeTurnId: string;
+            readonly status: OrchestrationV2ProviderTurn["status"];
+            readonly failureMessage?: string;
+            readonly providerRetry?: ActiveCodexProviderRetry;
+          }) {
+            const event = yield* makeRootTerminalEvent(input);
+            const hasActiveDescendants = Array.from((yield* Ref.get(activeTurns)).values()).some(
+              (candidate) => isDescendantCodexTurn(candidate, input.context),
+            );
+            if (event.status !== "completed" && hasActiveDescendants) {
+              yield* Ref.update(deferredRootTerminals, (current) => {
+                const updated = new Map(current);
+                updated.set(input.nativeTurnId, { context: input.context, event });
+                return updated;
+              });
+              return;
+            }
+            yield* emitProviderEvent(event);
+          },
+        );
+
+        const flushReadyRootTerminals = Effect.fn("CodexAdapterV2.flushReadyRootTerminals")(
+          function* () {
+            const activeTurnContexts = Array.from((yield* Ref.get(activeTurns)).values());
+            const readyEvents = yield* Ref.modify(deferredRootTerminals, (current) => {
+              const updated = new Map(current);
+              const ready: Array<CodexRootTerminalEvent> = [];
+              for (const [nativeTurnId, deferred] of current) {
+                if (
+                  !activeTurnContexts.some((candidate) =>
+                    isDescendantCodexTurn(candidate, deferred.context),
+                  )
+                ) {
+                  updated.delete(nativeTurnId);
+                  ready.push(deferred.event);
+                }
+              }
+              return [ready, updated] as const;
+            });
+            for (const event of readyEvents) {
+              yield* emitProviderEvent(event);
+            }
+          },
+        );
+
+        const finalizeCodexTurn = (input: {
+          readonly context: ActiveCodexTurnContext;
+          readonly nativeTurnId: string;
+          readonly status: OrchestrationV2ProviderTurn["status"];
+          readonly completedAt: DateTime.Utc;
+          readonly failureMessage?: string;
+        }) =>
+          turnTerminalizationPermit.withPermits(1)(
+            Effect.gen(function* () {
+              const current = (yield* Ref.get(activeTurns)).get(input.nativeTurnId);
+              if (current !== input.context) {
+                return false;
+              }
+              const providerRetry = yield* Ref.modify(providerRetries, (current) => {
+                const retry = current.get(input.context.providerTurnId);
+                if (retry === undefined) {
+                  return [undefined, current] as const;
+                }
+                const updated = new Map(current);
+                updated.delete(input.context.providerTurnId);
+                return [retry, updated] as const;
+              });
+              if (
+                providerRetry !== undefined &&
+                (input.status !== "failed" || input.context.subagent !== null)
+              ) {
+                yield* emitProviderEvent({
+                  type: "turn_item.updated",
+                  driver: CODEX_PROVIDER,
+                  turnItem: makeProviderRetryTurnItem({
+                    idAllocator,
+                    driver: CODEX_PROVIDER,
+                    threadId: input.context.projectionThreadId,
+                    runId: input.context.projectionRunId,
+                    nodeId: input.context.providerNodeId,
+                    providerThreadId: input.context.providerThread.id,
+                    providerTurnId: input.context.providerTurnId,
+                    itemOrdinal: providerRetry.itemOrdinal,
+                    failure: providerRetry.failure,
+                    retry: providerRetry.retry,
+                    status: providerTurnStatusToTerminal(input.status),
+                    startedAt: providerRetry.startedAt,
+                    updatedAt: input.completedAt,
+                  }),
+                });
+              }
+              if (input.status !== "completed") {
+                yield* Ref.update(terminalizedNonCompletedNativeTurns, (current) => {
+                  const updated = new Set(current);
+                  updated.add(input.nativeTurnId);
+                  return updated;
+                });
+              }
+              yield* agentMessageDeltas.flushTurn(input.nativeTurnId);
+              yield* emitProviderEvent({
+                type: "provider_turn.updated",
+                driver: CODEX_PROVIDER,
+                threadId: input.context.projectionThreadId,
+                providerTurn: {
+                  id: input.context.providerTurnId,
+                  providerThreadId: input.context.providerThread.id,
+                  nodeId: input.context.providerNodeId,
+                  runAttemptId:
+                    input.context.subagent === null ? input.context.input.attemptId : null,
+                  nativeTurnRef: {
+                    driver: CODEX_PROVIDER,
+                    nativeId: input.nativeTurnId,
+                    strength: "strong",
+                  },
+                  ordinal: input.context.providerTurnOrdinal,
+                  status: input.status,
+                  startedAt: input.context.startedAt,
+                  completedAt: input.completedAt,
+                },
+              });
+              if (input.context.subagent !== null) {
+                yield* emitProviderEvent({
+                  type: "node.updated",
+                  driver: CODEX_PROVIDER,
+                  node: {
+                    id: input.context.providerNodeId,
+                    threadId: input.context.projectionThreadId,
+                    runId: null,
+                    parentNodeId: null,
+                    rootNodeId: input.context.rootNodeId,
+                    kind: "root_turn",
+                    status: input.status,
+                    countsForRun: false,
+                    providerThreadId: input.context.providerThread.id,
+                    providerTurnId: input.context.providerTurnId,
+                    nativeItemRef: input.context.subagent.task.nativeTaskRef,
+                    runtimeRequestId: null,
+                    checkpointScopeId: null,
+                    startedAt: input.context.providerNodeStartedAt,
+                    completedAt: input.completedAt,
+                  },
+                });
+                yield* emitProviderEvent({
+                  type: "provider_thread.updated",
+                  driver: CODEX_PROVIDER,
+                  providerThread: {
+                    ...input.context.providerThread,
+                    status: "idle",
+                    updatedAt: input.completedAt,
+                  },
+                });
+                yield* emitProviderEvent({
+                  type: "node.updated",
+                  driver: CODEX_PROVIDER,
+                  node: {
+                    id: input.context.subagent.subagentNodeId,
+                    threadId: input.context.subagent.parentContext.projectionThreadId,
+                    runId: input.context.subagent.parentContext.projectionRunId,
+                    parentNodeId: input.context.subagent.parentContext.itemParentNodeId,
+                    rootNodeId: input.context.subagent.parentContext.rootNodeId,
+                    kind: "subagent",
+                    status: input.status,
+                    countsForRun: false,
+                    providerThreadId: input.context.providerThread.id,
+                    providerTurnId: input.context.subagent.parentContext.providerTurnId,
+                    nativeItemRef: input.context.subagent.task.nativeTaskRef,
+                    runtimeRequestId: null,
+                    checkpointScopeId: null,
+                    startedAt: input.context.subagent.startedAt,
+                    completedAt: input.completedAt,
+                  },
+                });
+                yield* emitSubagentTaskUpdate({
+                  subagent: input.context.subagent,
+                  status: input.status,
+                  completedAt: input.completedAt,
+                });
+              }
+              if (input.status === "interrupted" || input.status === "failed") {
+                yield* terminalizeRunningCommandItems(
+                  input.context,
+                  input.nativeTurnId,
+                  input.status,
+                  input.completedAt,
+                );
+              }
+              if (input.context.subagent === null) {
+                yield* emitOrDeferRootTerminal({
+                  ...input,
+                  ...(providerRetry === undefined ? {} : { providerRetry }),
+                });
+              }
+              const waiter = (yield* Ref.get(turnWaiters)).get(input.nativeTurnId);
+              if (waiter !== undefined) {
+                yield* Deferred.succeed(waiter, undefined);
+              }
+              const runningItems = (yield* Ref.get(runningCommandItemsByTurn)).get(
+                input.nativeTurnId,
+              );
+              const interruptInProgress = (yield* Ref.get(interruptingNativeTurns)).has(
+                input.nativeTurnId,
+              );
+              // Completed turns can retain late background command context.
+              // Interrupted and failed turns never wake from late item events.
+              const retainSettledContext =
+                input.status === "completed" && runningItems !== undefined && runningItems.size > 0;
+              if (retainSettledContext) {
+                yield* Ref.update(settledTurns, (current) => {
+                  const updated = new Map(current);
+                  updated.set(input.nativeTurnId, input.context);
+                  return updated;
+                });
+              }
+              yield* Ref.update(activeTurns, (current) => {
+                const updated = new Map(current);
+                updated.delete(input.nativeTurnId);
+                return updated;
+              });
+              yield* flushReadyRootTerminals();
+              if (!retainSettledContext && !interruptInProgress) {
+                yield* Ref.update(runningCommandItemsByTurn, (current) => {
+                  if (!current.has(input.nativeTurnId)) {
+                    return current;
+                  }
+                  const updated = new Map(current);
+                  updated.delete(input.nativeTurnId);
+                  return updated;
+                });
+              }
+              if (!retainSettledContext) {
+                yield* Ref.update(completedFinalAnswerTextsByTurn, (current) => {
+                  if (!current.has(input.nativeTurnId)) {
+                    return current;
+                  }
+                  const updated = new Map(current);
+                  updated.delete(input.nativeTurnId);
+                  return updated;
+                });
+                yield* Ref.update(finalAnswerItemIdsByTurn, (current) => {
+                  if (!current.has(input.nativeTurnId)) {
+                    return current;
+                  }
+                  const updated = new Map(current);
+                  updated.delete(input.nativeTurnId);
+                  return updated;
+                });
+              }
+              return true;
+            }),
+          );
+
+        yield* client.handleServerNotification("turn/completed", (payload) =>
+          Effect.gen(function* () {
+            const context = (yield* Ref.get(activeTurns)).get(payload.turn.id);
+            if (context === undefined) {
+              return;
+            }
+            const nativeStatus = mapCodexTurnStatus(payload.turn.status);
+            const status =
+              nativeStatus === "completed" &&
+              (yield* Ref.get(interruptingNativeTurns)).has(payload.turn.id)
+                ? "interrupted"
+                : nativeStatus;
+            yield* finalizeCodexTurn({
+              context,
+              nativeTurnId: payload.turn.id,
+              status,
+              completedAt: codexTimestamp(payload.turn.completedAt),
+              ...(payload.turn.error?.message === undefined
+                ? {}
+                : { failureMessage: payload.turn.error.message }),
+            });
+          }),
+        );
+
+        const runtime: ProviderAdapterV2SessionRuntime = {
+          instanceId: adapterOptions.instanceId,
+          driver: CODEX_PROVIDER,
+          providerSessionId: input.providerSessionId,
+          providerSession: session,
+          events: Stream.fromEffectRepeat(Queue.take(events)),
+          // Known gap: a subagent that Codex resumes later reads as completed
+          // (not pending) between turns, so idle release can win the race
+          // against a long-delayed resume. Codex emits no resume-expected
+          // signal to pin on.
+          hasPendingBackgroundWork: Effect.gen(function* () {
+            for (const items of (yield* Ref.get(runningCommandItemsByTurn)).values()) {
+              if (items.size > 0) {
+                return true;
+              }
+            }
+            for (const subagent of (yield* Ref.get(subagentThreads)).values()) {
+              if (subagent.task.status === "running") {
+                return true;
+              }
+            }
+            return false;
+          }),
+          ensureThread: (threadInput) =>
+            ensureInitialized.pipe(
+              Effect.andThen(
+                client.request(
+                  "thread/start",
+                  codexThreadRuntimeParams({
+                    threadId: threadInput.threadId,
+                    modelSelection: threadInput.modelSelection,
+                    runtimePolicy: threadInput.runtimePolicy,
+                  }),
+                ),
+              ),
+              Effect.map(
+                (response): OrchestrationV2ProviderThread =>
+                  providerThreadFromCodexThread({
+                    appThreadId: threadInput.threadId,
+                    idAllocator,
+                    ownerNodeId: null,
+                    providerSessionId: input.providerSessionId,
+                    providerInstanceId: adapterOptions.instanceId,
+                    thread: response.thread,
+                  }),
+              ),
+              Effect.mapError(
+                (cause) =>
+                  new ProviderAdapterEnsureThreadError({
+                    driver: CODEX_PROVIDER,
+                    threadId: threadInput.threadId,
+                    cause: normalizeCodexCause(cause),
+                  }),
+              ),
+            ),
+          resumeThread: (threadInput) =>
+            Effect.gen(function* () {
+              const nativeThreadId = yield* getNativeThreadId(threadInput.providerThread);
+
+              const response = yield* ensureInitialized.pipe(
+                Effect.andThen(
+                  client.request("thread/resume", {
+                    threadId: nativeThreadId,
+                    ...codexThreadRuntimeParams({
+                      threadId: threadInput.threadId ?? threadInput.providerThread.appThreadId,
+                      ...(threadInput.modelSelection === undefined
+                        ? {}
+                        : { modelSelection: threadInput.modelSelection }),
+                      ...(threadInput.runtimePolicy === undefined
+                        ? {}
+                        : { runtimePolicy: threadInput.runtimePolicy }),
+                    }),
+                  }),
+                ),
+              );
+              return {
+                ...threadInput.providerThread,
+                providerSessionId: input.providerSessionId,
+                providerInstanceId: adapterOptions.instanceId,
+                status: "idle",
+                nativeThreadRef: {
+                  driver: CODEX_PROVIDER,
+                  nativeId: response.thread.id,
+                  strength: "strong",
+                },
+                nativeConversationHeadRef: threadInput.providerThread.nativeConversationHeadRef,
+                updatedAt: codexTimestamp(response.thread.updatedAt),
+              } satisfies OrchestrationV2ProviderThread;
+            }).pipe(
+              Effect.mapError(
+                (cause) =>
+                  new ProviderAdapterResumeThreadError({
+                    driver: CODEX_PROVIDER,
+                    providerSessionId: input.providerSessionId,
+                    providerThreadId: threadInput.providerThread.id,
+                    cause: normalizeCodexCause(cause),
+                  }),
+              ),
+            ),
+          startTurn: (turnInput) =>
+            Effect.gen(function* () {
+              const threadId = yield* getNativeThreadId(turnInput.providerThread);
+
+              const codexInput = yield* toCodexInput(turnInput);
+              const mcpSession = McpProviderSession.readMcpProviderSession(turnInput.threadId);
+              const turnStartParams = yield* buildCodexTurnStartParams({
+                nativeThreadId: threadId,
+                codexInput,
+                runtimePolicy: turnInput.runtimePolicy,
+                modelSelection: turnInput.modelSelection,
+                hasT3Mcp: mcpSession !== undefined,
+                browserToolsAvailable: mcpSession?.browserToolsAvailable ?? true,
+              });
+              yield* Ref.update(pendingRootTurns, (current) => {
+                const updated = new Map(current);
+                updated.set(threadId, turnInput);
+                return updated;
+              });
+              const started = yield* client.request("turn/start", turnStartParams);
+              const nativeTurnId = started.turn.id;
+              const startedAt = codexTimestamp(started.turn.startedAt);
+              yield* registerRootTurn({ turnInput, nativeTurnId, startedAt });
+              yield* Ref.update(pendingRootTurns, (current) => {
+                const updated = new Map(current);
+                updated.delete(threadId);
+                return updated;
+              });
+            }).pipe(
+              Effect.ensuring(
+                Effect.flatMap(getNativeThreadId(turnInput.providerThread), (threadId) =>
+                  Ref.update(pendingRootTurns, (current) => {
+                    const updated = new Map(current);
+                    updated.delete(threadId);
+                    return updated;
+                  }),
+                ).pipe(Effect.ignore),
+              ),
+              Effect.mapError(
+                (cause) =>
+                  new ProviderAdapterTurnStartError({
+                    driver: CODEX_PROVIDER,
+                    threadId: turnInput.threadId,
+                    providerThreadId: turnInput.providerThread.id,
+                    runId: turnInput.runId,
+                    cause,
+                  }),
+              ),
+            ),
+          steerTurn: (turnInput) =>
+            Effect.gen(function* () {
+              const threadId = yield* getNativeThreadId(turnInput.providerThread);
+              const activeTurn = Array.from((yield* Ref.get(activeTurns)).values()).find(
+                (candidate) => candidate.providerTurnId === turnInput.providerTurnId,
+              );
+              if (activeTurn === undefined) {
+                return yield* toProtocolError(
+                  `Provider turn ${turnInput.providerTurnId} is not active and cannot be steered.`,
+                );
+              }
+
+              const codexInput = yield* toCodexInput(turnInput);
+              yield* client.request("turn/steer", {
+                expectedTurnId: activeTurn.nativeTurnId,
+                input: codexInput,
+                threadId,
+              });
+            }).pipe(
+              Effect.mapError(
+                (cause) =>
+                  new ProviderAdapterSteerRunError({
+                    driver: CODEX_PROVIDER,
+                    providerThreadId: turnInput.providerThread.id,
+                    providerTurnId: turnInput.providerTurnId,
+                    cause,
+                  }),
+              ),
+            ),
+          interruptTurn: (turnInput) =>
+            Effect.gen(function* () {
+              const activeTurnContexts = Array.from((yield* Ref.get(activeTurns)).values());
+              const activeTurn = activeTurnContexts.find(
+                (candidate) => candidate.providerTurnId === turnInput.providerTurnId,
+              );
+              if (activeTurn === undefined) {
+                return yield* toProtocolError(
+                  `Provider turn ${turnInput.providerTurnId} is not active and cannot be interrupted.`,
+                );
+              }
+              const interruptTargetContexts = [
+                activeTurn,
+                ...activeTurnContexts.filter(
+                  (candidate) =>
+                    candidate !== activeTurn && isDescendantCodexTurn(candidate, activeTurn),
+                ),
+              ];
+              const interruptTargets: Array<{
+                readonly context: ActiveCodexTurnContext;
+                readonly completion: Deferred.Deferred<void, never>;
+              }> = [];
+              for (const context of interruptTargetContexts) {
+                interruptTargets.push({ context, completion: yield* Deferred.make<void>() });
+              }
+              yield* Ref.update(turnWaiters, (current) => {
+                const updated = new Map(current);
+                for (const target of interruptTargets) {
+                  updated.set(target.context.nativeTurnId, target.completion);
+                }
+                return updated;
+              });
+              yield* Ref.update(interruptingNativeTurns, (current) => {
+                const updated = new Set(current);
+                for (const target of interruptTargets) {
+                  updated.add(target.context.nativeTurnId);
+                }
+                return updated;
+              });
+              const registeredActiveTurns = yield* Ref.get(activeTurns);
+              for (const target of interruptTargets) {
+                if (registeredActiveTurns.get(target.context.nativeTurnId) !== target.context) {
+                  yield* Deferred.succeed(target.completion, undefined);
+                }
+              }
+
+              const cleanupInterruptState = Effect.gen(function* () {
+                yield* Ref.update(turnWaiters, (current) => {
+                  const updated = new Map(current);
+                  for (const target of interruptTargets) {
+                    updated.delete(target.context.nativeTurnId);
+                  }
+                  return updated;
+                });
+                yield* Ref.update(interruptingNativeTurns, (current) => {
+                  const updated = new Set(current);
+                  for (const target of interruptTargets) {
+                    updated.delete(target.context.nativeTurnId);
+                  }
+                  return updated;
+                });
+                yield* Ref.update(runningCommandItemsByTurn, (current) => {
+                  const updated = new Map(current);
+                  for (const target of interruptTargets) {
+                    updated.delete(target.context.nativeTurnId);
+                  }
+                  return updated;
+                });
+              });
+
+              const trackedInterruptNativeTurnIds = new Set(
+                interruptTargets.map((target) => target.context.nativeTurnId),
+              );
+              const finalizeRemainingInterruptLineage = Effect.gen(function* () {
+                while (true) {
+                  const newlyDiscovered: Array<ActiveCodexTurnContext> = [];
+                  const activeLineage = yield* turnTerminalizationPermit.withPermits(1)(
+                    Effect.gen(function* () {
+                      const lineage = Array.from((yield* Ref.get(activeTurns)).values()).filter(
+                        (context) =>
+                          context === activeTurn || isDescendantCodexTurn(context, activeTurn),
+                      );
+                      for (const context of lineage) {
+                        if (trackedInterruptNativeTurnIds.has(context.nativeTurnId)) {
+                          continue;
+                        }
+                        const completion = yield* Deferred.make<void>();
+                        interruptTargets.push({ context, completion });
+                        trackedInterruptNativeTurnIds.add(context.nativeTurnId);
+                        newlyDiscovered.push(context);
+                        yield* Ref.update(turnWaiters, (current) => {
+                          const updated = new Map(current);
+                          updated.set(context.nativeTurnId, completion);
+                          return updated;
+                        });
+                        yield* Ref.update(interruptingNativeTurns, (current) => {
+                          const updated = new Set(current);
+                          updated.add(context.nativeTurnId);
+                          return updated;
+                        });
+                      }
+                      return lineage;
+                    }),
+                  );
+                  if (activeLineage.length === 0) {
+                    return;
+                  }
+                  if (newlyDiscovered.length > 0) {
+                    const completed = yield* Effect.forEach(
+                      newlyDiscovered,
+                      (context) =>
+                        Effect.flatMap(getNativeThreadId(context.providerThread), (threadId) =>
+                          client.request("turn/interrupt", {
+                            threadId,
+                            turnId: context.nativeTurnId,
+                          }),
+                        ).pipe(
+                          Effect.catch((cause) =>
+                            Effect.logWarning(
+                              "orchestration-v2.codex-remaining-lineage-interrupt-failed",
+                              {
+                                nativeTurnId: context.nativeTurnId,
+                                providerSessionId: input.providerSessionId,
+                                cause,
+                              },
+                            ),
+                          ),
+                        ),
+                      { concurrency: "unbounded", discard: true },
+                    ).pipe(Effect.timeoutOption("10 seconds"));
+                    if (Option.isNone(completed)) {
+                      yield* Effect.logWarning(
+                        "orchestration-v2.codex-remaining-lineage-interrupt-timeout",
+                        {
+                          nativeTurnIds: newlyDiscovered.map((context) => context.nativeTurnId),
+                          providerSessionId: input.providerSessionId,
+                        },
+                      );
+                    }
+                  }
+                  const completedAt = yield* DateTime.now;
+                  for (const context of activeLineage) {
+                    yield* finalizeCodexTurn({
+                      context,
+                      nativeTurnId: context.nativeTurnId,
+                      status: "interrupted",
+                      completedAt,
+                    });
+                  }
+                }
+              });
+
+              const interruptLateDescendants = Effect.gen(function* () {
+                const activeLineage = yield* turnTerminalizationPermit.withPermits(1)(
+                  Effect.gen(function* () {
+                    const lineage = Array.from((yield* Ref.get(activeTurns)).values()).filter(
+                      (context) =>
+                        context !== activeTurn &&
+                        isDescendantCodexTurn(context, activeTurn) &&
+                        !trackedInterruptNativeTurnIds.has(context.nativeTurnId),
+                    );
+                    for (const context of lineage) {
+                      const completion = yield* Deferred.make<void>();
+                      interruptTargets.push({ context, completion });
+                      trackedInterruptNativeTurnIds.add(context.nativeTurnId);
+                      yield* Ref.update(turnWaiters, (current) => {
+                        const updated = new Map(current);
+                        updated.set(context.nativeTurnId, completion);
+                        return updated;
+                      });
+                      yield* Ref.update(interruptingNativeTurns, (current) => {
+                        const updated = new Set(current);
+                        updated.add(context.nativeTurnId);
+                        return updated;
+                      });
+                    }
+                    return lineage;
+                  }),
+                );
+                const completed = yield* Effect.forEach(
+                  activeLineage,
+                  (context) =>
+                    Effect.flatMap(getNativeThreadId(context.providerThread), (threadId) =>
+                      client.request("turn/interrupt", {
+                        threadId,
+                        turnId: context.nativeTurnId,
+                      }),
+                    ),
+                  { concurrency: "unbounded", discard: true },
+                ).pipe(Effect.timeoutOption("10 seconds"));
+                if (Option.isNone(completed)) {
+                  yield* Effect.logWarning(
+                    "orchestration-v2.codex-late-descendant-interrupt-timeout",
+                    {
+                      nativeTurnIds: activeLineage.map((context) => context.nativeTurnId),
+                      providerSessionId: input.providerSessionId,
+                    },
+                  );
+                }
+              });
+
+              yield* Effect.gen(function* () {
+                for (const target of interruptTargets) {
+                  const context = target.context;
+                  if ((yield* Ref.get(activeTurns)).get(context.nativeTurnId) !== context) {
+                    continue;
+                  }
+                  yield* client.request("turn/interrupt", {
+                    threadId: yield* getNativeThreadId(context.providerThread),
+                    turnId: context.nativeTurnId,
+                  });
+                }
+                const containedTerminalKeys = new Set<string>();
+                const attemptedTerminalKeys = new Set<string>();
+                const collectTrackedTerminals = (targets: typeof interruptTargets) =>
+                  Effect.gen(function* () {
+                    const trackedTerminals = new Map<
+                      string,
+                      { readonly nativeThreadId: string; readonly processId: string }
+                    >();
+                    const runningItems = yield* Ref.get(runningCommandItemsByTurn);
+                    for (const target of targets) {
+                      const nativeThreadId = yield* getNativeThreadId(
+                        target.context.providerThread,
+                      );
+                      const items = runningItems.get(target.context.nativeTurnId);
+                      for (const item of items?.values() ?? []) {
+                        if (item.processId !== undefined) {
+                          trackedTerminals.set(`${nativeThreadId}:${item.processId}`, {
+                            nativeThreadId,
+                            processId: item.processId,
+                          });
+                        }
+                      }
+                    }
+                    return trackedTerminals;
+                  });
+                const isBackgroundTerminalStillRunning = (
+                  nativeThreadId: string,
+                  processId: string,
+                ) =>
+                  Effect.gen(function* () {
+                    let cursor: string | null = null;
+                    while (true) {
+                      const response: unknown = yield* client.raw.request(
+                        "thread/backgroundTerminals/list",
+                        {
+                          threadId: nativeThreadId,
+                          ...(cursor === null ? {} : { cursor }),
+                        },
+                      );
+                      const page: CodexBackgroundTerminalsListPage =
+                        yield* decodeCodexBackgroundTerminalsListResponse(response);
+                      if (page.data.some((terminal) => terminal.processId === processId)) {
+                        return true;
+                      }
+                      if (page.nextCursor === null) {
+                        return false;
+                      }
+                      cursor = page.nextCursor;
+                    }
+                  });
+                const terminateTrackedTerminals = (targets: typeof interruptTargets) =>
+                  Effect.gen(function* () {
+                    const trackedTerminals = yield* collectTrackedTerminals(targets);
+                    const pendingTerminals = Array.from(trackedTerminals.entries())
+                      .filter(([key]) => !containedTerminalKeys.has(key))
+                      .sort(
+                        ([leftKey], [rightKey]) =>
+                          Number(attemptedTerminalKeys.has(leftKey)) -
+                          Number(attemptedTerminalKeys.has(rightKey)),
+                      );
+                    return yield* Effect.forEach(
+                      pendingTerminals,
+                      ([key, { nativeThreadId, processId }]) =>
+                        Effect.gen(function* () {
+                          attemptedTerminalKeys.add(key);
+                          const response = yield* client.raw.request(
+                            "thread/backgroundTerminals/terminate",
+                            {
+                              threadId: nativeThreadId,
+                              processId,
+                            },
+                          );
+                          const result =
+                            yield* decodeCodexBackgroundTerminalTerminateResponse(response);
+                          if (
+                            !result.terminated &&
+                            (yield* isBackgroundTerminalStillRunning(nativeThreadId, processId))
+                          ) {
+                            return yield* toProtocolError(
+                              `Codex background terminal ${processId} remained active after termination.`,
+                            );
+                          }
+                          containedTerminalKeys.add(key);
+                        }).pipe(
+                          Effect.as({ success: true as const }),
+                          Effect.catch((error) =>
+                            Effect.succeed({ success: false as const, error }),
+                          ),
+                        ),
+                    );
+                  });
+
+                const [, completed] = yield* Effect.all(
+                  [
+                    terminateTrackedTerminals(interruptTargets),
+                    Effect.forEach(
+                      interruptTargets,
+                      (target) => Deferred.await(target.completion),
+                      { concurrency: "unbounded", discard: true },
+                    ).pipe(Effect.timeoutOption("10 seconds")),
+                  ],
+                  { concurrency: "unbounded" },
+                );
+                if (Option.isNone(completed)) {
+                  for (const target of interruptTargets) {
+                    const context = target.context;
+                    if ((yield* Ref.get(activeTurns)).get(context.nativeTurnId) !== context) {
+                      continue;
+                    }
+                    yield* Effect.logWarning("orchestration-v2.codex-interrupt-timeout", {
+                      providerSessionId: input.providerSessionId,
+                      providerThreadId: context.providerThread.id,
+                      providerTurnId: context.providerTurnId,
+                      nativeTurnId: context.nativeTurnId,
+                    });
+                  }
+                }
+
+                yield* interruptLateDescendants;
+                yield* finalizeRemainingInterruptLineage;
+
+                const terminationResults = yield* terminateTrackedTerminals(interruptTargets);
+                const failedTermination = terminationResults.find((result) => !result.success);
+                if (failedTermination !== undefined && !failedTermination.success) {
+                  return yield* Effect.fail(failedTermination.error);
+                }
+              }).pipe(
+                Effect.onError(() => finalizeRemainingInterruptLineage),
+                Effect.ensuring(cleanupInterruptState),
+              );
+            }).pipe(
+              Effect.mapError(
+                (cause) =>
+                  new ProviderAdapterInterruptError({
+                    driver: CODEX_PROVIDER,
+                    providerThreadId: turnInput.providerThread.id,
+                    providerTurnId: turnInput.providerTurnId,
+                    cause,
+                  }),
+              ),
+            ),
+          respondToRuntimeRequest: (requestInput) =>
+            Effect.gen(function* () {
+              const pending = (yield* Ref.get(pendingRuntimeRequests)).get(
+                String(requestInput.requestId),
+              );
+              if (pending === undefined) {
+                return yield* new ProviderAdapterRuntimeRequestResponseError({
+                  driver: CODEX_PROVIDER,
+                  requestId: requestInput.requestId,
+                  cause: toProtocolError(
+                    `No pending Codex runtime request ${requestInput.requestId}.`,
+                  ),
+                });
+              }
+              if (pending.type === "user_input") {
+                if (requestInput.answers === undefined) {
+                  return yield* new ProviderAdapterRuntimeRequestResponseError({
+                    driver: CODEX_PROVIDER,
+                    requestId: requestInput.requestId,
+                    cause: toProtocolError(
+                      `Codex user input request ${requestInput.requestId} requires answers.`,
+                    ),
+                  });
+                }
+                yield* Deferred.succeed(pending.answers, requestInput.answers);
+                return;
+              }
+              if (requestInput.decision === undefined) {
+                return yield* new ProviderAdapterRuntimeRequestResponseError({
+                  driver: CODEX_PROVIDER,
+                  requestId: requestInput.requestId,
+                  cause: toProtocolError(
+                    `Codex ${pending.requestKind} request ${requestInput.requestId} requires an approval decision.`,
+                  ),
+                });
+              }
+              yield* Deferred.succeed(pending.decision, requestInput.decision);
+            }).pipe(
+              Effect.mapError((cause) =>
+                isProviderAdapterRuntimeRequestResponseError(cause)
+                  ? cause
+                  : new ProviderAdapterRuntimeRequestResponseError({
+                      driver: CODEX_PROVIDER,
+                      requestId: requestInput.requestId,
+                      cause,
+                    }),
+              ),
+            ),
+          uploadFeedback: (feedbackInput) =>
+            Effect.gen(function* () {
+              const threadId = yield* getNativeThreadId(feedbackInput.providerThread);
+              const response = yield* ensureInitialized.pipe(
+                Effect.andThen(
+                  client.request("feedback/upload", {
+                    classification: "bug",
+                    includeLogs: true,
+                    ...(feedbackInput.reason ? { reason: feedbackInput.reason } : {}),
+                    threadId,
+                  }),
+                ),
+              );
+              return { feedbackId: response.threadId };
+            }).pipe(
+              Effect.mapError(
+                (cause) =>
+                  new ProviderAdapterProtocolError({
+                    driver: CODEX_PROVIDER,
+                    detail: "Failed to upload Codex thread feedback.",
+                    payload: cause,
+                  }),
+              ),
+            ),
+          readThreadSnapshot: (threadInput) =>
+            Effect.gen(function* () {
+              const threadId = yield* getNativeThreadId(threadInput.providerThread);
+              const response = yield* ensureInitialized.pipe(
+                Effect.andThen(client.request("thread/read", { threadId, includeTurns: true })),
+              );
+              return {
+                providerThread: {
+                  ...threadInput.providerThread,
+                  nativeThreadRef: {
+                    driver: CODEX_PROVIDER,
+                    nativeId: response.thread.id,
+                    strength: "strong" as const,
+                  },
+                  nativeConversationHeadRef: threadInput.providerThread.nativeConversationHeadRef,
+                  updatedAt: codexTimestamp(response.thread.updatedAt),
+                },
+                providerTurns: [],
+                messages: [],
+                runtimeRequests: [],
+                providerPayload: response.thread,
+              };
+            }).pipe(
+              Effect.mapError(
+                (cause) =>
+                  new ProviderAdapterReadThreadSnapshotError({
+                    driver: CODEX_PROVIDER,
+                    providerThreadId: threadInput.providerThread.id,
+                    cause,
+                  }),
+              ),
+            ),
+          rollbackThread: (threadInput) =>
+            Effect.gen(function* () {
+              const threadId = yield* getNativeThreadId(threadInput.providerThread);
+              const numTurns = yield* resolveCodexRollbackTurnCount(threadInput);
+              const nativeConversationHeadRef =
+                threadInput.target.type === "provider_turn"
+                  ? threadInput.target.providerTurn.nativeTurnRef
+                  : null;
+              if (numTurns === 0) {
+                return {
+                  providerThread: {
+                    ...threadInput.providerThread,
+                    nativeConversationHeadRef,
+                    status: "idle" as const,
+                  },
+                  providerTurns: [],
+                  messages: [],
+                  runtimeRequests: [],
+                };
+              }
+              const response = yield* ensureInitialized.pipe(
+                Effect.andThen(client.request("thread/rollback", { threadId, numTurns })),
+              );
+              return {
+                providerThread: {
+                  ...threadInput.providerThread,
+                  nativeThreadRef: {
+                    driver: CODEX_PROVIDER,
+                    nativeId: response.thread.id,
+                    strength: "strong" as const,
+                  },
+                  nativeConversationHeadRef,
+                  status: "idle" as const,
+                  updatedAt: codexTimestamp(response.thread.updatedAt),
+                },
+                providerTurns: [],
+                messages: [],
+                runtimeRequests: [],
+                providerPayload: response.thread,
+              };
+            }).pipe(
+              Effect.mapError(
+                (cause) =>
+                  new ProviderAdapterRollbackThreadError({
+                    driver: CODEX_PROVIDER,
+                    providerThreadId: threadInput.providerThread.id,
+                    cause: normalizeCodexCause(cause),
+                  }),
+              ),
+            ),
+          forkThread: (threadInput) =>
+            Effect.gen(function* () {
+              const threadId = yield* getNativeThreadId(threadInput.sourceProviderThread);
+              const response = yield* ensureInitialized.pipe(
+                Effect.andThen(
+                  client.request("thread/fork", {
+                    threadId,
+                    ...codexThreadRuntimeParams({
+                      threadId: threadInput.targetThreadId,
+                      ...(threadInput.modelSelection === undefined
+                        ? {}
+                        : { modelSelection: threadInput.modelSelection }),
+                      ...(threadInput.runtimePolicy === undefined
+                        ? {}
+                        : { runtimePolicy: threadInput.runtimePolicy }),
+                    }),
+                  }),
+                ),
+                Effect.mapError(
+                  (cause) =>
+                    new ProviderAdapterForkThreadError({
+                      driver: CODEX_PROVIDER,
+                      providerThreadId: threadInput.sourceProviderThread.id,
+                      cause: normalizeCodexCause(cause),
+                    }),
+                ),
+              );
+              const rollbackTurnCount = yield* resolveCodexForkRollbackTurnCount(threadInput);
+              const forkedThread =
+                rollbackTurnCount === 0
+                  ? response.thread
+                  : (yield* ensureInitialized.pipe(
+                      Effect.andThen(
+                        client.request("thread/rollback", {
+                          threadId: response.thread.id,
+                          numTurns: rollbackTurnCount,
+                        }),
+                      ),
+                      Effect.mapError(
+                        (cause) =>
+                          new ProviderAdapterForkThreadError({
+                            driver: CODEX_PROVIDER,
+                            providerThreadId: threadInput.sourceProviderThread.id,
+                            cause: normalizeCodexCause(cause),
+                          }),
+                      ),
+                    )).thread;
+              return providerThreadFromCodexThread({
+                appThreadId: threadInput.targetThreadId,
+                idAllocator,
+                ownerNodeId: threadInput.ownerNodeId ?? null,
+                providerSessionId: input.providerSessionId,
+                providerInstanceId: adapterOptions.instanceId,
+                thread: forkedThread,
+                forkedFrom: {
+                  providerThreadId: threadInput.sourceProviderThread.id,
+                  ...(threadInput.providerTurnId === undefined
+                    ? {}
+                    : { providerTurnId: threadInput.providerTurnId }),
+                },
+              });
+            }).pipe(
+              Effect.mapError(
+                (cause) =>
+                  new ProviderAdapterForkThreadError({
+                    driver: CODEX_PROVIDER,
+                    providerThreadId: threadInput.sourceProviderThread.id,
+                    cause: normalizeCodexCause(cause),
+                  }),
+              ),
+            ),
+        };
+        return runtime;
+      }).pipe(
+        Effect.mapError(
+          (cause) =>
+            new ProviderAdapterOpenSessionError({
+              driver: CODEX_PROVIDER,
+              providerSessionId: input.providerSessionId,
+              cause,
+            }),
+        ),
+      ),
+  });
+}
diff --git a/apps/server/src/orchestration-v2/Adapters/CursorAdapterV2.test.ts b/apps/server/src/orchestration-v2/Adapters/CursorAdapterV2.test.ts
new file mode 100644
index 000000000000..bf51ce0011c2
--- /dev/null
+++ b/apps/server/src/orchestration-v2/Adapters/CursorAdapterV2.test.ts
@@ -0,0 +1,196 @@
+import { assert, describe, it } from "@effect/vitest";
+import { EnvironmentId, ProviderInstanceId, ThreadId } from "@t3tools/contracts";
+
+import * as McpProviderSession from "../../mcp/McpProviderSession.ts";
+import {
+  CursorProviderCapabilitiesV2,
+  cursorMcpServers,
+  cursorRuntimeAgentPolicy,
+  cursorSdkModelSelection,
+  makeCursorAgentOptions,
+  nestedToolCallFromEnvelope,
+} from "./CursorAdapterV2.ts";
+import { isCursorCancellationError, loggedCursorAgentOptions } from "./CursorAgentSdk.ts";
+
+describe("CursorAdapterV2", () => {
+  it("maps Cursor auto and model parameters to SDK selections", () => {
+    assert.deepEqual(
+      cursorSdkModelSelection({
+        instanceId: ProviderInstanceId.make("cursor"),
+        model: "auto",
+        options: [
+          { id: "thinking", value: "high" },
+          { id: "contextWindow", value: "1m" },
+          { id: "fastMode", value: true },
+        ],
+      }),
+      {
+        id: "default",
+        params: [
+          { id: "thinking", value: "high" },
+          { id: "context", value: "1m" },
+          { id: "fast", value: "true" },
+        ],
+      },
+    );
+  });
+
+  it("maps runtime modes to the SDK sandbox and auto-review controls", () => {
+    const base = {
+      interactionMode: "default" as const,
+      cwd: "/tmp/cursor-adapter",
+    };
+    assert.deepEqual(
+      cursorRuntimeAgentPolicy({
+        ...base,
+        runtimeMode: "full-access",
+      }),
+      {
+        autoReview: false,
+        sandboxEnabled: false,
+      },
+    );
+    assert.deepEqual(
+      cursorRuntimeAgentPolicy({
+        ...base,
+        runtimeMode: "auto-accept-edits",
+      }),
+      {
+        autoReview: false,
+        sandboxEnabled: true,
+      },
+    );
+    assert.deepEqual(
+      cursorRuntimeAgentPolicy({
+        ...base,
+        runtimeMode: "approval-required",
+      }),
+      {
+        autoReview: true,
+        sandboxEnabled: true,
+      },
+    );
+    assert.deepEqual(
+      cursorRuntimeAgentPolicy({
+        ...base,
+        runtimeMode: "full-access",
+        approvalPolicy: "never",
+        sandboxPolicy: { type: "readOnly" },
+      }),
+      {
+        autoReview: false,
+        sandboxEnabled: true,
+      },
+    );
+    assert.deepEqual(
+      cursorRuntimeAgentPolicy({
+        ...base,
+        runtimeMode: "approval-required",
+        approvalPolicy: "never",
+        sandboxPolicy: { type: "dangerFullAccess" },
+      }),
+      {
+        autoReview: false,
+        sandboxEnabled: false,
+      },
+    );
+  });
+
+  it("advertises only capabilities exposed by the official SDK adapter", () => {
+    assert.isTrue(CursorProviderCapabilitiesV2.threads.canReadThreadSnapshot);
+    assert.isFalse(CursorProviderCapabilitiesV2.threads.canForkThread);
+    assert.isFalse(CursorProviderCapabilitiesV2.threads.canRollbackThread);
+    assert.isTrue(CursorProviderCapabilitiesV2.turns.supportsInterrupt);
+    assert.isFalse(CursorProviderCapabilitiesV2.turns.supportsActiveSteering);
+    assert.isTrue(CursorProviderCapabilitiesV2.turns.supportsSteeringByInterruptRestart);
+    assert.isTrue(CursorProviderCapabilitiesV2.tools.supportsMcpTools);
+    assert.isTrue(CursorProviderCapabilitiesV2.subagents.supportsSubagents);
+    assert.isFalse(CursorProviderCapabilitiesV2.subagents.exposesSubagentThreadIds);
+    assert.equal(CursorProviderCapabilitiesV2.identity.nativeItemIds, "weak");
+    assert.isFalse(CursorProviderCapabilitiesV2.approvals.supportsCommandApproval);
+  });
+
+  it("injects thread-scoped MCP credentials without logging them", () => {
+    const threadId = ThreadId.make("thread-cursor-mcp");
+    McpProviderSession.setMcpProviderSession({
+      environmentId: EnvironmentId.make("environment-cursor-mcp"),
+      threadId,
+      providerSessionId: "mcp-session-cursor",
+      providerInstanceId: ProviderInstanceId.make("cursor"),
+      endpoint: "http://127.0.0.1:43123/mcp",
+      authorizationHeader: "Bearer secret-cursor-mcp-token",
+      browserToolsAvailable: true,
+    });
+
+    try {
+      assert.deepEqual(cursorMcpServers(threadId), {
+        "t3-code": {
+          type: "http",
+          url: "http://127.0.0.1:43123/mcp",
+          headers: {
+            Authorization: "Bearer secret-cursor-mcp-token",
+          },
+        },
+      });
+
+      const options = makeCursorAgentOptions({
+        apiKey: "secret-cursor-api-key",
+        modelSelection: {
+          instanceId: ProviderInstanceId.make("cursor"),
+          model: "composer-2.5",
+        },
+        runtimePolicy: {
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          cwd: "/workspace",
+        },
+        threadId,
+      });
+      assert.deepEqual(options.mcpServers, cursorMcpServers(threadId));
+
+      const logged = JSON.stringify(loggedCursorAgentOptions(options));
+      assert.notInclude(logged, "secret-cursor-api-key");
+      assert.notInclude(logged, "secret-cursor-mcp-token");
+    } finally {
+      McpProviderSession.clearMcpProviderSession(threadId);
+    }
+  });
+
+  it("recognizes direct and SDK-wrapped abort failures as cancellation", () => {
+    assert.isTrue(isCursorCancellationError({ name: "AbortError" }));
+    assert.isTrue(
+      isCursorCancellationError({
+        name: "ConnectError",
+        cause: {
+          name: "ConnectError",
+          cause: { name: "AbortError" },
+        },
+      }),
+    );
+    assert.isFalse(isCursorCancellationError(new Error("request failed")));
+    assert.isFalse(isCursorCancellationError(null));
+  });
+
+  it("preserves failed nested read calls when Cursor omits their path", () => {
+    assert.deepEqual(
+      nestedToolCallFromEnvelope({
+        toolCallId: "tool:failed-read",
+        readToolCall: {
+          args: {},
+          result: { error: "File path was not provided." },
+        },
+      }),
+      {
+        callId: "tool:failed-read",
+        toolCall: {
+          type: "read",
+          args: { path: "<unknown path>" },
+          result: {
+            status: "error",
+            error: "File path was not provided.",
+          },
+        },
+      },
+    );
+  });
+});
diff --git a/apps/server/src/orchestration-v2/Adapters/CursorAdapterV2.testkit.test.ts b/apps/server/src/orchestration-v2/Adapters/CursorAdapterV2.testkit.test.ts
new file mode 100644
index 000000000000..cb9f81d65c5b
--- /dev/null
+++ b/apps/server/src/orchestration-v2/Adapters/CursorAdapterV2.testkit.test.ts
@@ -0,0 +1,102 @@
+import { assert, describe, it } from "@effect/vitest";
+import { ProviderSessionId, ThreadId } from "@t3tools/contracts";
+import * as Cause from "effect/Cause";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as Schema from "effect/Schema";
+
+import {
+  CURSOR_AGENT_SDK_PROTOCOL,
+  CURSOR_PROVIDER,
+  CursorAgentSdkRunnerError,
+} from "./CursorAgentSdk.ts";
+import {
+  CursorReplayFrameMismatchError,
+  makeCursorAgentSdkReplayRunner,
+} from "./CursorAdapterV2.testkit.ts";
+
+const isCursorAgentSdkRunnerError = Schema.is(CursorAgentSdkRunnerError);
+const isCursorReplayFrameMismatchError = Schema.is(CursorReplayFrameMismatchError);
+
+describe("CursorAdapterV2 replay testkit", () => {
+  it.effect("fails promptly when a run is followed by an unrelated outbound frame", () =>
+    Effect.gen(function* () {
+      const agentId = "agent-replay-outbound-mismatch";
+      const runId = "run-replay-outbound-mismatch";
+      const runner = makeCursorAgentSdkReplayRunner({
+        provider: CURSOR_PROVIDER,
+        protocol: CURSOR_AGENT_SDK_PROTOCOL,
+        version: "test",
+        scenario: "unrelated-outbound-after-run-started",
+        entries: [
+          {
+            type: "expect_outbound",
+            frame: {
+              type: "agent.open",
+              operation: "create",
+              options: {},
+            },
+          },
+          {
+            type: "emit_inbound",
+            frame: {
+              type: "agent.opened",
+              agentId,
+            },
+          },
+          {
+            type: "expect_outbound",
+            frame: {
+              type: "run.start",
+              message: "hello",
+              options: {},
+            },
+          },
+          {
+            type: "emit_inbound",
+            frame: {
+              type: "run.started",
+              runId,
+              agentId,
+            },
+          },
+          {
+            type: "expect_outbound",
+            frame: {
+              type: "agent.close",
+              agentId,
+            },
+          },
+        ],
+      });
+      const session = yield* runner.open({
+        operation: "create",
+        options: {},
+        threadId: ThreadId.make("thread-replay-outbound-mismatch"),
+        providerSessionId: ProviderSessionId.make("provider-session-replay-outbound-mismatch"),
+      });
+      const run = yield* session.send({ message: "hello" });
+
+      const exit = yield* Effect.exit(run.wait.pipe(Effect.timeout("100 millis")));
+
+      assert.isTrue(Exit.isFailure(exit));
+      if (Exit.isFailure(exit)) {
+        const error = Cause.squash(exit.cause);
+        assert.isTrue(isCursorAgentSdkRunnerError(error));
+        if (isCursorAgentSdkRunnerError(error)) {
+          assert.isTrue(isCursorReplayFrameMismatchError(error.cause));
+          if (isCursorReplayFrameMismatchError(error.cause)) {
+            assert.deepEqual(error.cause.expected, {
+              type: "run.cancel",
+              runId,
+            });
+            assert.deepEqual(error.cause.actual, {
+              type: "agent.close",
+              agentId,
+            });
+          }
+        }
+      }
+    }),
+  );
+});
diff --git a/apps/server/src/orchestration-v2/Adapters/CursorAdapterV2.testkit.ts b/apps/server/src/orchestration-v2/Adapters/CursorAdapterV2.testkit.ts
new file mode 100644
index 000000000000..246272b8f788
--- /dev/null
+++ b/apps/server/src/orchestration-v2/Adapters/CursorAdapterV2.testkit.ts
@@ -0,0 +1,1013 @@
+import { Agent, type InteractionUpdate, type RunResult } from "@cursor/sdk";
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import {
+  ProviderReplayEntry,
+  type ModelSelection,
+  type ProviderReplayTranscript,
+  type ThreadId,
+} from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Layer from "effect/Layer";
+import * as Path from "effect/Path";
+import * as PlatformError from "effect/PlatformError";
+import * as Schema from "effect/Schema";
+
+import { ServerConfig } from "../../config.ts";
+import { layer as idAllocatorLayer } from "../IdAllocator.ts";
+import { ProviderAdapterDriverCreateError } from "../ProviderAdapterDriver.ts";
+import { makeDriverLayer as makeProviderAdapterRegistryDriverLayer } from "../ProviderAdapterRegistry.ts";
+import type { OrchestratorV2ProviderReplayHarness } from "../testkit/ProviderReplayHarness.ts";
+import {
+  CURSOR_AGENT_SDK_PROTOCOL,
+  CURSOR_PROVIDER,
+  CursorAgentSdkRunner,
+  CursorAgentSdkRunnerError,
+  isCursorCancellationError,
+  loggedCursorAgentOptions,
+  loggedCursorSendOptions,
+  type CursorAgentSdkOpenInput,
+  type CursorAgentSdkProtocolLogEvent,
+  type CursorAgentSdkRun,
+  type CursorAgentSdkRunnerShape,
+  type CursorAgentSdkSendInput,
+  type CursorAgentSdkSession,
+} from "./CursorAgentSdk.ts";
+import {
+  CURSOR_DEFAULT_INSTANCE_ID,
+  CURSOR_DRIVER_KIND,
+  CursorAdapterV2Driver,
+  cursorSdkModelSelection,
+  makeCursorAgentOptions,
+} from "./CursorAdapterV2.ts";
+import type { ProviderAdapterV2RuntimePolicy } from "../ProviderAdapter.ts";
+
+const CursorAgentSdkReplayTranscript = Schema.Struct({
+  provider: Schema.Literal(CURSOR_PROVIDER),
+  protocol: Schema.Literal(CURSOR_AGENT_SDK_PROTOCOL),
+  version: Schema.String,
+  scenario: Schema.String,
+  metadata: Schema.optional(Schema.Record(Schema.String, Schema.Unknown)),
+  entries: Schema.Array(ProviderReplayEntry),
+});
+export type CursorAgentSdkReplayTranscript = typeof CursorAgentSdkReplayTranscript.Type;
+const decodeCursorAgentSdkReplayTranscript = Schema.decodeUnknownEffect(
+  CursorAgentSdkReplayTranscript,
+);
+
+export class CursorReplayTranscriptDecodeError extends Schema.TaggedErrorClass<CursorReplayTranscriptDecodeError>()(
+  "CursorReplayTranscriptDecodeError",
+  {
+    driver: Schema.optional(Schema.String),
+    protocol: Schema.optional(Schema.String),
+    scenario: Schema.optional(Schema.String),
+    cause: Schema.Defect(),
+  },
+) {
+  override get message(): string {
+    return `Failed to decode Cursor Agent SDK replay transcript for scenario ${this.scenario ?? "<unknown>"}.`;
+  }
+}
+
+export class CursorReplayExhaustedError extends Schema.TaggedErrorClass<CursorReplayExhaustedError>()(
+  "CursorReplayExhaustedError",
+  {
+    scenario: Schema.String,
+    cursor: Schema.Number,
+    actual: Schema.Unknown,
+  },
+) {
+  override get message(): string {
+    return `Cursor Agent SDK replay transcript exhausted at cursor ${this.cursor} in scenario ${this.scenario}.`;
+  }
+}
+
+export class CursorReplayFrameMismatchError extends Schema.TaggedErrorClass<CursorReplayFrameMismatchError>()(
+  "CursorReplayFrameMismatchError",
+  {
+    scenario: Schema.String,
+    cursor: Schema.Number,
+    expected: Schema.Unknown,
+    actual: Schema.Unknown,
+  },
+) {
+  override get message(): string {
+    return `Cursor Agent SDK replay frame mismatch at cursor ${this.cursor} in scenario ${this.scenario}.`;
+  }
+}
+
+export class CursorReplayIncompleteError extends Schema.TaggedErrorClass<CursorReplayIncompleteError>()(
+  "CursorReplayIncompleteError",
+  {
+    scenario: Schema.String,
+    cursor: Schema.Number,
+    remaining: Schema.Number,
+  },
+) {
+  override get message(): string {
+    return `Cursor Agent SDK replay ended with ${this.remaining} unconsumed entries in scenario ${this.scenario}.`;
+  }
+}
+
+export class CursorReplayRuntimeError extends Schema.TaggedErrorClass<CursorReplayRuntimeError>()(
+  "CursorReplayRuntimeError",
+  {
+    scenario: Schema.String,
+    cursor: Schema.Number,
+    cause: Schema.Defect(),
+  },
+) {
+  override get message(): string {
+    return `Cursor Agent SDK replay failed at cursor ${this.cursor} in scenario ${this.scenario}.`;
+  }
+}
+
+export const CursorAgentSdkReplayError = Schema.Union([
+  CursorReplayTranscriptDecodeError,
+  CursorReplayExhaustedError,
+  CursorReplayFrameMismatchError,
+  CursorReplayIncompleteError,
+  CursorReplayRuntimeError,
+]);
+export type CursorAgentSdkReplayError = typeof CursorAgentSdkReplayError.Type;
+const isCursorAgentSdkReplayError = Schema.is(CursorAgentSdkReplayError);
+const isCursorAgentSdkRunnerError = Schema.is(CursorAgentSdkRunnerError);
+
+export const CursorOrchestratorReplayHarnessError = Schema.Union([
+  CursorAgentSdkReplayError,
+  ProviderAdapterDriverCreateError,
+]);
+export type CursorOrchestratorReplayHarnessError = typeof CursorOrchestratorReplayHarnessError.Type;
+
+type CursorProtocolPayload = CursorAgentSdkProtocolLogEvent["payload"];
+type CursorOutgoingFrame = Extract<
+  CursorAgentSdkProtocolLogEvent,
+  { readonly direction: "outgoing" }
+>["payload"];
+
+function stableStringify(value: unknown): string {
+  if (Array.isArray(value)) {
+    return `[${value.map(stableStringify).join(",")}]`;
+  }
+  if (typeof value === "object" && value !== null) {
+    const record = value as Record<string, unknown>;
+    return `{${Object.keys(record)
+      .toSorted()
+      .map((key) => `${JSON.stringify(key)}:${stableStringify(record[key])}`)
+      .join(",")}}`;
+  }
+  return JSON.stringify(value);
+}
+
+function normalizeContextHandoffText(value: string): string {
+  if (!value.startsWith("Context handoff (")) {
+    return value;
+  }
+  const marker = "\n\nUser message:\n";
+  const markerIndex = value.indexOf(marker);
+  const headerEnd = value.indexOf(":\n");
+  if (markerIndex === -1 || headerEnd === -1 || headerEnd >= markerIndex) {
+    return value;
+  }
+  return `${value.slice(0, headerEnd + 2)}<dynamic-summary>${value.slice(markerIndex)}`;
+}
+
+function normalizeFrame(value: unknown): unknown {
+  if (typeof value === "string") {
+    return normalizeContextHandoffText(value);
+  }
+  if (Array.isArray(value)) {
+    return value.map(normalizeFrame);
+  }
+  if (typeof value !== "object" || value === null) {
+    return value;
+  }
+  return Object.fromEntries(
+    Object.entries(value).map(([key, entry]) => [key, normalizeFrame(entry)]),
+  );
+}
+
+function sameFrame(left: unknown, right: unknown): boolean {
+  return stableStringify(normalizeFrame(left)) === stableStringify(normalizeFrame(right));
+}
+
+function makeSignal(): {
+  readonly promise: Promise<void>;
+  readonly resolve: () => void;
+} {
+  let resolve = () => {};
+  const promise = new Promise<void>((onResolve) => {
+    resolve = onResolve;
+  });
+  return { promise, resolve };
+}
+
+function replayRunnerError(
+  transcript: CursorAgentSdkReplayTranscript,
+  cause: unknown,
+  method: string,
+): CursorAgentSdkRunnerError {
+  if (isCursorAgentSdkRunnerError(cause)) {
+    return cause;
+  }
+  return new CursorAgentSdkRunnerError({
+    method,
+    cause: isCursorAgentSdkReplayError(cause)
+      ? cause
+      : new CursorReplayRuntimeError({
+          scenario: transcript.scenario,
+          cursor: 0,
+          cause,
+        }),
+  });
+}
+
+export function makeCursorAgentSdkReplayRunner(
+  transcript: CursorAgentSdkReplayTranscript,
+): CursorAgentSdkRunnerShape {
+  let cursor = 0;
+  let failure: CursorAgentSdkReplayError | null = null;
+  let cursorAdvanced = makeSignal();
+
+  const recordFailure = <Error extends CursorAgentSdkReplayError>(error: Error): Error => {
+    failure = error;
+    return error;
+  };
+
+  const fail = (error: CursorAgentSdkReplayError): never => {
+    throw recordFailure(error);
+  };
+
+  const advance = () => {
+    cursor += 1;
+    const signal = cursorAdvanced;
+    cursorAdvanced = makeSignal();
+    signal.resolve();
+  };
+
+  const assertOutbound = (actual: CursorOutgoingFrame) => {
+    if (failure !== null) {
+      throw failure;
+    }
+    const entry = transcript.entries[cursor];
+    if (entry === undefined) {
+      return fail(
+        new CursorReplayExhaustedError({
+          scenario: transcript.scenario,
+          cursor,
+          actual,
+        }),
+      );
+    }
+    if (entry.type !== "expect_outbound" || !sameFrame(entry.frame, actual)) {
+      return fail(
+        new CursorReplayFrameMismatchError({
+          scenario: transcript.scenario,
+          cursor,
+          expected: entry.type === "expect_outbound" ? entry.frame : entry,
+          actual,
+        }),
+      );
+    }
+    advance();
+  };
+
+  const consumeInbound = <Type extends CursorProtocolPayload["type"]>(
+    type: Type,
+  ): Extract<CursorProtocolPayload, { readonly type: Type }> => {
+    const entry = transcript.entries[cursor];
+    if (
+      entry === undefined ||
+      entry.type !== "emit_inbound" ||
+      typeof entry.frame !== "object" ||
+      entry.frame === null ||
+      Reflect.get(entry.frame, "type") !== type
+    ) {
+      return fail(
+        new CursorReplayFrameMismatchError({
+          scenario: transcript.scenario,
+          cursor,
+          expected: { type },
+          actual: entry,
+        }),
+      );
+    }
+    const frame = entry.frame as Extract<CursorProtocolPayload, { readonly type: Type }>;
+    advance();
+    return frame;
+  };
+
+  const waitForRun = <Error>(
+    runId: string,
+    sendInput: CursorAgentSdkSendInput<Error>,
+  ): Effect.Effect<RunResult, CursorAgentSdkReplayError> =>
+    Effect.gen(function* () {
+      while (true) {
+        if (failure !== null) {
+          return yield* failure;
+        }
+        const entry = transcript.entries[cursor];
+        if (entry === undefined) {
+          return yield* recordFailure(
+            new CursorReplayExhaustedError({
+              scenario: transcript.scenario,
+              cursor,
+              actual: { type: "run.completed", runId },
+            }),
+          );
+        }
+        if (entry.type === "expect_outbound") {
+          const expectedCancel = {
+            type: "run.cancel",
+            runId,
+          };
+          if (!sameFrame(entry.frame, expectedCancel)) {
+            return yield* recordFailure(
+              new CursorReplayFrameMismatchError({
+                scenario: transcript.scenario,
+                cursor,
+                expected: expectedCancel,
+                actual: entry.frame,
+              }),
+            );
+          }
+          const signal = cursorAdvanced;
+          yield* Effect.promise(() => signal.promise);
+          continue;
+        }
+        if (entry.type === "runtime_exit") {
+          advance();
+          if (entry.status === "success") {
+            continue;
+          }
+          return yield* recordFailure(
+            new CursorReplayRuntimeError({
+              scenario: transcript.scenario,
+              cursor: cursor - 1,
+              cause: entry.error ?? entry.status,
+            }),
+          );
+        }
+        if (
+          typeof entry.frame !== "object" ||
+          entry.frame === null ||
+          typeof Reflect.get(entry.frame, "type") !== "string"
+        ) {
+          return yield* recordFailure(
+            new CursorReplayFrameMismatchError({
+              scenario: transcript.scenario,
+              cursor,
+              expected: { type: "interaction.update | run.completed" },
+              actual: entry.frame,
+            }),
+          );
+        }
+        const frame = entry.frame as CursorProtocolPayload;
+        if (frame.type === "interaction.update") {
+          if (frame.runId !== runId) {
+            return yield* recordFailure(
+              new CursorReplayFrameMismatchError({
+                scenario: transcript.scenario,
+                cursor,
+                expected: { runId },
+                actual: frame,
+              }),
+            );
+          }
+          advance();
+          yield* (sendInput.onDelta?.(frame.update) ?? Effect.void).pipe(
+            Effect.mapError((cause) =>
+              recordFailure(
+                new CursorReplayRuntimeError({
+                  scenario: transcript.scenario,
+                  cursor: cursor - 1,
+                  cause,
+                }),
+              ),
+            ),
+          );
+          yield* Effect.yieldNow;
+          continue;
+        }
+        if (frame.type === "run.completed") {
+          if (frame.result.id !== runId) {
+            return yield* recordFailure(
+              new CursorReplayFrameMismatchError({
+                scenario: transcript.scenario,
+                cursor,
+                expected: { runId },
+                actual: frame.result,
+              }),
+            );
+          }
+          advance();
+          return frame.result;
+        }
+        return yield* recordFailure(
+          new CursorReplayFrameMismatchError({
+            scenario: transcript.scenario,
+            cursor,
+            expected: { type: "interaction.update | run.completed" },
+            actual: frame,
+          }),
+        );
+      }
+    });
+
+  return {
+    open: (input: CursorAgentSdkOpenInput) =>
+      Effect.try({
+        try: () => {
+          assertOutbound({
+            type: "agent.open",
+            operation: input.operation,
+            ...(input.agentId === undefined ? {} : { agentId: input.agentId }),
+            options: loggedCursorAgentOptions(input.options),
+          });
+          const opened = consumeInbound("agent.opened");
+          const session: CursorAgentSdkSession = {
+            agentId: opened.agentId,
+            send: (sendInput) =>
+              Effect.try({
+                try: () => {
+                  assertOutbound({
+                    type: "run.start",
+                    message: sendInput.message,
+                    options: loggedCursorSendOptions(sendInput.options),
+                  });
+                  const started = consumeInbound("run.started");
+                  const run: CursorAgentSdkRun = {
+                    runId: started.runId,
+                    agentId: started.agentId,
+                    wait: waitForRun(started.runId, sendInput).pipe(
+                      Effect.mapError((cause) =>
+                        replayRunnerError(transcript, cause, "replay.run.wait"),
+                      ),
+                    ),
+                    cancel: Effect.try({
+                      try: () =>
+                        assertOutbound({
+                          type: "run.cancel",
+                          runId: started.runId,
+                        }),
+                      catch: (cause) => replayRunnerError(transcript, cause, "replay.run.cancel"),
+                    }),
+                  };
+                  return run;
+                },
+                catch: (cause) => replayRunnerError(transcript, cause, "replay.session.send"),
+              }),
+            listMessages: Effect.try({
+              try: () => {
+                assertOutbound({
+                  type: "agent.messages.list",
+                  agentId: opened.agentId,
+                });
+                return consumeInbound("agent.messages").messages;
+              },
+              catch: (cause) => replayRunnerError(transcript, cause, "replay.agent.messages.list"),
+            }),
+            close: Effect.try({
+              try: () =>
+                assertOutbound({
+                  type: "agent.close",
+                  agentId: opened.agentId,
+                }),
+              catch: (cause) => replayRunnerError(transcript, cause, "replay.agent.close"),
+            }),
+          };
+          return session;
+        },
+        catch: (cause) => replayRunnerError(transcript, cause, "replay.agent.open"),
+      }),
+    assertComplete: Effect.try({
+      try: () => {
+        if (failure !== null) {
+          throw failure;
+        }
+        if (cursor !== transcript.entries.length) {
+          throw new CursorReplayIncompleteError({
+            scenario: transcript.scenario,
+            cursor,
+            remaining: transcript.entries.length - cursor,
+          });
+        }
+      },
+      catch: (cause) => replayRunnerError(transcript, cause, "replay.assertComplete"),
+    }),
+  };
+}
+
+export function makeCursorAgentSdkReplayLayer(
+  transcript: CursorAgentSdkReplayTranscript,
+  options?: {
+    readonly runner?: CursorAgentSdkRunnerShape;
+    readonly assertCompleteOnFinalize?: boolean;
+  },
+): Layer.Layer<CursorAgentSdkRunner> {
+  const runner = options?.runner ?? makeCursorAgentSdkReplayRunner(transcript);
+  return Layer.effect(
+    CursorAgentSdkRunner,
+    Effect.gen(function* () {
+      yield* Effect.addFinalizer(() =>
+        options?.assertCompleteOnFinalize === false
+          ? Effect.void
+          : runner.assertComplete.pipe(Effect.orDie),
+      );
+      return CursorAgentSdkRunner.of(runner);
+    }),
+  );
+}
+
+function makeReplayServerConfig(
+  scenario: string,
+): Effect.Effect<
+  ServerConfig["Service"],
+  PlatformError.PlatformError,
+  FileSystem.FileSystem | Path.Path
+> {
+  return Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const baseDir = yield* fs.makeTempDirectory({
+      prefix: `t3-orchestration-v2-cursor-${scenario}-`,
+    });
+    const stateDir = path.join(baseDir, "userdata");
+    const logsDir = path.join(stateDir, "logs");
+    const providerLogsDir = path.join(logsDir, "provider");
+    const terminalLogsDir = path.join(logsDir, "terminals");
+    const attachmentsDir = path.join(stateDir, "attachments");
+    const environmentThemesDir = path.join(stateDir, "themes");
+    const worktreesDir = path.join(baseDir, "worktrees");
+    const providerStatusCacheDir = path.join(baseDir, "caches");
+    for (const directory of [
+      stateDir,
+      logsDir,
+      providerLogsDir,
+      terminalLogsDir,
+      attachmentsDir,
+      environmentThemesDir,
+      worktreesDir,
+      providerStatusCacheDir,
+    ]) {
+      yield* fs.makeDirectory(directory, { recursive: true });
+    }
+    return {
+      logLevel: "Error",
+      traceMinLevel: "Info",
+      traceTimingEnabled: true,
+      traceBatchWindowMs: 200,
+      traceMaxBytes: 10 * 1024 * 1024,
+      traceMaxFiles: 10,
+      otlpTracesUrl: undefined,
+      otlpMetricsUrl: undefined,
+      otlpExportIntervalMs: 10_000,
+      otlpServiceName: "t3-server",
+      mode: "web",
+      port: 0,
+      host: undefined,
+      cwd: process.cwd(),
+      baseDir,
+      staticDir: undefined,
+      devUrl: undefined,
+      devAllowedOrigins: [],
+      noBrowser: false,
+      startupPresentation: "browser",
+      tailscaleServeEnabled: false,
+      tailscaleServePort: 443,
+      desktopBootstrapToken: undefined,
+      autoBootstrapProjectFromCwd: false,
+      logWebSocketEvents: false,
+      stateDir,
+      dbPath: path.join(stateDir, "state.sqlite"),
+      keybindingsConfigPath: path.join(stateDir, "keybindings.json"),
+      settingsPath: path.join(stateDir, "settings.json"),
+      providerStatusCacheDir,
+      worktreesDir,
+      attachmentsDir,
+      environmentThemesDir,
+      logsDir,
+      serverLogPath: path.join(logsDir, "server.log"),
+      serverTracePath: path.join(logsDir, "server.trace.ndjson"),
+      providerLogsDir,
+      providerEventLogPath: path.join(providerLogsDir, "events.log"),
+      terminalLogsDir,
+      anonymousIdPath: path.join(stateDir, "anonymous-id"),
+      environmentIdPath: path.join(stateDir, "environment-id"),
+      serverRuntimeStatePath: path.join(stateDir, "server-runtime.json"),
+      secretsDir: path.join(stateDir, "secrets"),
+    };
+  });
+}
+
+export function makeCursorProviderAdapterRegistryReplayLayer(
+  transcript: CursorAgentSdkReplayTranscript,
+  options?: {
+    readonly runner?: CursorAgentSdkRunnerShape;
+    readonly assertCompleteOnFinalize?: boolean;
+  },
+) {
+  const serverConfigLayer = Layer.effect(
+    ServerConfig,
+    makeReplayServerConfig(transcript.scenario).pipe(Effect.orDie),
+  ).pipe(Layer.provide(NodeServices.layer));
+  return makeProviderAdapterRegistryDriverLayer({
+    drivers: [CursorAdapterV2Driver],
+    configMap: {
+      [CURSOR_DEFAULT_INSTANCE_ID]: {
+        driver: CURSOR_DRIVER_KIND,
+      },
+    },
+  }).pipe(
+    Layer.provide(
+      Layer.mergeAll(
+        makeCursorAgentSdkReplayLayer(transcript, options),
+        serverConfigLayer,
+        NodeServices.layer,
+        idAllocatorLayer,
+      ),
+    ),
+  );
+}
+
+function metadataFromTranscript(transcript: ProviderReplayTranscript): {
+  readonly provider?: string;
+  readonly protocol?: string;
+  readonly scenario?: string;
+} {
+  return {
+    provider: transcript.provider,
+    protocol: transcript.protocol,
+    scenario: transcript.scenario,
+  };
+}
+
+export const CursorOrchestratorReplayHarness: OrchestratorV2ProviderReplayHarness<
+  CursorAgentSdkReplayTranscript,
+  CursorOrchestratorReplayHarnessError
+> = {
+  driver: CURSOR_PROVIDER,
+  decodeTranscript: (transcript) =>
+    decodeCursorAgentSdkReplayTranscript(transcript).pipe(
+      Effect.mapError(
+        (cause) =>
+          new CursorReplayTranscriptDecodeError({
+            ...metadataFromTranscript(transcript),
+            cause,
+          }),
+      ),
+    ),
+  makeProviderAdapterRegistryLayer: (transcript) =>
+    makeCursorProviderAdapterRegistryReplayLayer(transcript),
+};
+
+function sanitizeReplayValue(
+  value: unknown,
+  replacements: ReadonlyArray<readonly [string, string]>,
+): unknown {
+  if (typeof value === "string") {
+    return replacements.reduce(
+      (text, [from, to]) => (from.length === 0 ? text : text.replaceAll(from, to)),
+      value,
+    );
+  }
+  if (Array.isArray(value)) {
+    return value.map((entry) => sanitizeReplayValue(entry, replacements));
+  }
+  if (typeof value !== "object" || value === null) {
+    return value;
+  }
+  return Object.fromEntries(
+    Object.entries(value).map(([key, entry]) => [key, sanitizeReplayValue(entry, replacements)]),
+  );
+}
+
+function serializeCursorRecordingError(cause: unknown): unknown {
+  if (typeof cause !== "object" || cause === null) {
+    return cause;
+  }
+  return {
+    name: typeof Reflect.get(cause, "name") === "string" ? Reflect.get(cause, "name") : "Error",
+    message:
+      typeof Reflect.get(cause, "message") === "string"
+        ? Reflect.get(cause, "message")
+        : String(cause),
+  };
+}
+
+function makeRecordingSignal(): {
+  readonly promise: Promise<void>;
+  readonly resolve: () => void;
+} {
+  let resolve = () => {};
+  const promise = new Promise<void>((onResolve) => {
+    resolve = onResolve;
+  });
+  return { promise, resolve };
+}
+
+async function waitForRecordingSignal(signal: Promise<void>, description: string): Promise<void> {
+  const controller = new AbortController();
+  const timeout = Effect.runPromise(
+    Effect.sleep("30 seconds").pipe(
+      Effect.andThen(Effect.die(`Timed out waiting for ${description}.`)),
+    ),
+    { signal: controller.signal },
+  );
+  try {
+    await Promise.race([signal, timeout]);
+  } finally {
+    controller.abort();
+  }
+}
+
+function recordingRuntimePolicy(input: {
+  readonly cwd: string;
+  readonly interactionMode: "default" | "plan";
+}): ProviderAdapterV2RuntimePolicy {
+  return {
+    runtimeMode: "full-access",
+    interactionMode: input.interactionMode,
+    cwd: input.cwd,
+    approvalPolicy: "never",
+    sandboxPolicy: {
+      type: "dangerFullAccess",
+      networkAccess: true,
+    },
+  };
+}
+
+export async function recordCursorAgentSdkReplayTranscript(input: {
+  readonly scenario: string;
+  readonly prompts: ReadonlyArray<string>;
+  /** Stable transcript representation when runtime-only paths were substituted into prompts. */
+  readonly transcriptPrompts?: ReadonlyArray<string>;
+  readonly modelSelection: ModelSelection;
+  readonly cwd: string;
+  /** Stable fixture cwd used to sanitize runtime-only workspace paths in recorded updates. */
+  readonly transcriptCwd?: string;
+  readonly interactionMode?: "default" | "plan";
+  readonly apiKey?: string;
+  readonly interruptAfterToolStart?: boolean;
+  readonly interruptAfterRunStartPromptIndex?: number;
+  readonly restartBeforePromptIndex?: number;
+}): Promise<CursorAgentSdkReplayTranscript> {
+  if (
+    input.transcriptPrompts !== undefined &&
+    input.transcriptPrompts.length !== input.prompts.length
+  ) {
+    throw new Error("Cursor transcript prompts must match the runtime prompt count.");
+  }
+  if (input.interruptAfterToolStart === true && input.prompts.length !== 1) {
+    throw new Error("Cursor interrupt recordings require exactly one prompt.");
+  }
+  if (
+    input.interruptAfterToolStart === true &&
+    input.interruptAfterRunStartPromptIndex !== undefined
+  ) {
+    throw new Error("Cursor recordings cannot use both interrupt triggers.");
+  }
+  if (
+    input.interruptAfterRunStartPromptIndex !== undefined &&
+    (input.interruptAfterRunStartPromptIndex < 0 ||
+      input.interruptAfterRunStartPromptIndex >= input.prompts.length)
+  ) {
+    throw new Error("Cursor interrupt prompt index is outside the prompt list.");
+  }
+  const entries: Array<ProviderReplayEntry> = [];
+  const interactionMode = input.interactionMode ?? "default";
+  const runtimePolicy = recordingRuntimePolicy({
+    cwd: input.cwd,
+    interactionMode,
+  });
+  const options = makeCursorAgentOptions({
+    ...(input.apiKey === undefined ? {} : { apiKey: input.apiKey }),
+    modelSelection: input.modelSelection,
+    runtimePolicy,
+    threadId: "thread:cursor-replay" as ThreadId,
+  });
+  entries.push({
+    type: "expect_outbound",
+    label: "agent.open",
+    frame: {
+      type: "agent.open",
+      operation: "create",
+      options: loggedCursorAgentOptions(options),
+    },
+  });
+
+  let agent = await Agent.create(options);
+  const nativeAgentId = agent.agentId;
+  entries.push({
+    type: "emit_inbound",
+    label: "agent.opened",
+    frame: {
+      type: "agent.opened",
+      agentId: agent.agentId,
+    },
+  });
+
+  const replacements: ReadonlyArray<readonly [string, string]> = [
+    [input.cwd, input.transcriptCwd ?? `/tmp/cursor-replay-${input.scenario}`],
+  ];
+
+  try {
+    for (const [index, prompt] of input.prompts.entries()) {
+      if (input.restartBeforePromptIndex === index) {
+        entries.push({
+          type: "expect_outbound",
+          label: `agent.close:before-prompt-${index + 1}`,
+          frame: {
+            type: "agent.close",
+            agentId: nativeAgentId,
+          },
+        });
+        agent.close();
+        entries.push({
+          type: "expect_outbound",
+          label: `agent.resume:before-prompt-${index + 1}`,
+          frame: {
+            type: "agent.open",
+            operation: "resume",
+            agentId: nativeAgentId,
+            options: loggedCursorAgentOptions(options),
+          },
+        });
+        agent = await Agent.resume(nativeAgentId, options);
+        entries.push({
+          type: "emit_inbound",
+          label: `agent.resumed:before-prompt-${index + 1}`,
+          frame: {
+            type: "agent.opened",
+            agentId: agent.agentId,
+          },
+        });
+      }
+      const sendOptions = {
+        model: cursorSdkModelSelection(input.modelSelection),
+        mode: interactionMode === "plan" ? "plan" : "agent",
+      } as const;
+      entries.push({
+        type: "expect_outbound",
+        label: `run.start:${index + 1}`,
+        frame: {
+          type: "run.start",
+          message: input.transcriptPrompts?.[index] ?? prompt,
+          options: loggedCursorSendOptions(sendOptions),
+        },
+      });
+      const pendingUpdates: Array<InteractionUpdate> = [];
+      let runReady = false;
+      let runId = "";
+      let updatesPaused = false;
+      const toolStarted = makeRecordingSignal();
+      const runActivityStarted = makeRecordingSignal();
+      const resumeUpdates = makeRecordingSignal();
+      let interruptTriggerObserved = false;
+      let callbackChain = Promise.resolve();
+      const recordUpdate = async (update: InteractionUpdate) => {
+        if (updatesPaused) {
+          await resumeUpdates.promise;
+        }
+        entries.push({
+          type: "emit_inbound",
+          label: update.type,
+          frame: {
+            type: "interaction.update",
+            runId,
+            update: sanitizeReplayValue(update, replacements) as InteractionUpdate,
+          },
+        });
+        if (
+          input.interruptAfterToolStart === true &&
+          !interruptTriggerObserved &&
+          update.type === "tool-call-started"
+        ) {
+          interruptTriggerObserved = true;
+          updatesPaused = true;
+          toolStarted.resolve();
+        }
+      };
+      const scheduleUpdate = (update: InteractionUpdate): Promise<void> => {
+        callbackChain = callbackChain.then(() => recordUpdate(update));
+        return callbackChain;
+      };
+      const run = await agent.send(prompt, {
+        ...sendOptions,
+        onDelta: async ({ update }) => {
+          runActivityStarted.resolve();
+          if (!runReady) {
+            pendingUpdates.push(update);
+            return;
+          }
+          await scheduleUpdate(update);
+        },
+      });
+      runId = run.id;
+      entries.push({
+        type: "emit_inbound",
+        label: `run.started:${index + 1}`,
+        frame: {
+          type: "run.started",
+          runId: run.id,
+          agentId: run.agentId,
+        },
+      });
+      runReady = true;
+      for (const update of pendingUpdates) {
+        void scheduleUpdate(update);
+      }
+      const resultPromise = run.wait().then(
+        (result) => ({ type: "success" as const, result }),
+        (cause: unknown) => ({ type: "failure" as const, cause }),
+      );
+      if (input.interruptAfterRunStartPromptIndex === index) {
+        await waitForRecordingSignal(
+          runActivityStarted.promise,
+          "Cursor SDK run activity before interrupt",
+        );
+        entries.push({
+          type: "expect_outbound",
+          label: `run.cancel:${index + 1}`,
+          frame: {
+            type: "run.cancel",
+            runId: run.id,
+          },
+        });
+        await run.cancel().catch((cause: unknown) => {
+          if (!isCursorCancellationError(cause)) {
+            throw cause;
+          }
+        });
+      }
+      if (input.interruptAfterToolStart === true) {
+        await waitForRecordingSignal(
+          toolStarted.promise,
+          "Cursor SDK tool-call-started before interrupt",
+        );
+        entries.push({
+          type: "expect_outbound",
+          label: `run.cancel:${index + 1}`,
+          frame: {
+            type: "run.cancel",
+            runId: run.id,
+          },
+        });
+        const cancelPromise = run.cancel().catch((cause: unknown) => {
+          if (!isCursorCancellationError(cause)) {
+            throw cause;
+          }
+        });
+        updatesPaused = false;
+        resumeUpdates.resolve();
+        await cancelPromise;
+      }
+      const outcome = await resultPromise;
+      await callbackChain;
+      if (outcome.type === "success") {
+        entries.push({
+          type: "emit_inbound",
+          label: `run.completed:${index + 1}`,
+          frame: {
+            type: "run.completed",
+            result: sanitizeReplayValue(outcome.result, replacements) as RunResult,
+          },
+        });
+      } else if (
+        (input.interruptAfterToolStart === true ||
+          input.interruptAfterRunStartPromptIndex === index) &&
+        isCursorCancellationError(outcome.cause)
+      ) {
+        entries.push({
+          type: "runtime_exit",
+          status: "cancelled",
+          error: serializeCursorRecordingError(outcome.cause),
+        });
+      } else {
+        throw outcome.cause;
+      }
+    }
+  } finally {
+    entries.push({
+      type: "expect_outbound",
+      label: "agent.close",
+      frame: {
+        type: "agent.close",
+        agentId: nativeAgentId,
+      },
+    });
+    agent.close();
+  }
+
+  return {
+    provider: CURSOR_PROVIDER,
+    protocol: CURSOR_AGENT_SDK_PROTOCOL,
+    version: "1",
+    scenario: input.scenario,
+    metadata: {
+      generatedBy: "recordCursorAgentSdkReplayTranscript",
+      nativeAgentId,
+    },
+    entries,
+  };
+}
diff --git a/apps/server/src/orchestration-v2/Adapters/CursorAdapterV2.ts b/apps/server/src/orchestration-v2/Adapters/CursorAdapterV2.ts
new file mode 100644
index 000000000000..5113ef3ab33c
--- /dev/null
+++ b/apps/server/src/orchestration-v2/Adapters/CursorAdapterV2.ts
@@ -0,0 +1,2538 @@
+import type {
+  AgentMessage,
+  AgentOptions,
+  InteractionUpdate,
+  McpServerConfig,
+  RunResult,
+  SDKUserMessage,
+  ToolCall,
+} from "@cursor/sdk";
+import { HostProcessEnvironment } from "@t3tools/shared/hostProcess";
+import {
+  CursorSettings,
+  defaultInstanceIdForDriver,
+  type ChatAttachment,
+  type ModelSelection,
+  type OrchestrationV2ConversationMessage,
+  type OrchestrationV2ExecutionNode,
+  type OrchestrationV2PlanArtifact,
+  type OrchestrationV2PlanStep,
+  type OrchestrationV2ProviderCapabilities,
+  type OrchestrationV2ProviderFailure,
+  type OrchestrationV2ProviderSession,
+  type OrchestrationV2ProviderThread,
+  type OrchestrationV2ProviderTurn,
+  type OrchestrationV2Subagent,
+  type OrchestrationV2TurnItem,
+  type ProviderInstanceId,
+  type ThreadId,
+} from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Queue from "effect/Queue";
+import * as Ref from "effect/Ref";
+import * as Schema from "effect/Schema";
+import * as Stream from "effect/Stream";
+
+import { resolveAttachmentPath } from "../../attachmentStore.ts";
+import { ServerConfig } from "../../config.ts";
+import * as McpProviderSession from "../../mcp/McpProviderSession.ts";
+import { cursorSdkModelSelection } from "../../provider/cursorSdkModel.ts";
+import { mergeProviderInstanceEnvironment } from "../../provider/ProviderInstanceEnvironment.ts";
+import { t3OrchestrationPromptForFirstRun } from "../../provider/T3OrchestrationInstructions.ts";
+import { IdAllocatorV2, type IdAllocatorV2Shape } from "../IdAllocator.ts";
+import { makeProviderFailure } from "../ProviderFailure.ts";
+import { turnScopedSelectionTransition } from "../ProviderSelectionTransition.ts";
+import {
+  isProviderNativeImageAttachment,
+  providerMessageTextWithAttachmentPaths,
+} from "../AttachmentPrompt.ts";
+import {
+  ProviderAdapterEnsureThreadError,
+  ProviderAdapterForkThreadError,
+  ProviderAdapterInterruptError,
+  ProviderAdapterOpenSessionError,
+  ProviderAdapterProtocolError,
+  ProviderAdapterReadThreadSnapshotError,
+  ProviderAdapterResumeThreadError,
+  ProviderAdapterRollbackThreadError,
+  ProviderAdapterRuntimeRequestResponseError,
+  ProviderAdapterSteerRunUnsupportedError,
+  ProviderAdapterTurnStartError,
+  ProviderAdapterV2,
+  type ProviderAdapterV2EnsureThreadInput,
+  type ProviderAdapterV2Event,
+  type ProviderAdapterV2InterruptInput,
+  type ProviderAdapterV2OpenSessionInput,
+  type ProviderAdapterV2RuntimePolicy,
+  type ProviderAdapterV2SessionRuntime,
+  type ProviderAdapterV2Shape,
+  type ProviderAdapterV2TurnInput,
+} from "../ProviderAdapter.ts";
+import {
+  ProviderAdapterDriverCreateError,
+  type ProviderAdapterDriver,
+  type ProviderAdapterDriverCreateInput,
+} from "../ProviderAdapterDriver.ts";
+import {
+  makeSubagentChildThread,
+  makeSubagentConversationArtifacts,
+  subagentThreadTitle,
+} from "../SubagentProjection.ts";
+import {
+  CURSOR_PROVIDER,
+  CursorAgentSdkRunner,
+  type CursorAgentSdkRun,
+  type CursorAgentSdkRunnerShape,
+  type CursorAgentSdkSession,
+} from "./CursorAgentSdk.ts";
+
+export { CURSOR_PROVIDER } from "./CursorAgentSdk.ts";
+export { cursorSdkModelSelection } from "../../provider/cursorSdkModel.ts";
+
+export const CURSOR_DRIVER_KIND = CURSOR_PROVIDER;
+export const CURSOR_DEFAULT_INSTANCE_ID = defaultInstanceIdForDriver(CURSOR_DRIVER_KIND);
+const DEFAULT_CURSOR_SETTINGS = Schema.decodeSync(CursorSettings)({});
+
+export const CursorProviderCapabilitiesV2 = {
+  sessions: {
+    supportsMultipleProviderThreadsPerSession: false,
+    supportsModelSwitchInSession: true,
+    supportsProviderSwitchingViaHandoff: true,
+    supportsRuntimeModeSwitchInSession: false,
+    pendingRequestsSurviveRestart: false,
+  },
+  threads: {
+    canCreateEmptyThread: true,
+    canReadThreadSnapshot: true,
+    canRollbackThread: false,
+    canForkThread: false,
+    canForkFromTurn: false,
+    canForkFromSubagentThread: false,
+    exposesNativeThreadId: true,
+  },
+  turns: {
+    exposesNativeTurnId: true,
+    emitsTurnStarted: true,
+    emitsTurnCompleted: true,
+    supportsInterrupt: true,
+    supportsActiveSteering: false,
+    supportsSteeringByInterruptRestart: true,
+    supportsQueuedMessages: true,
+    terminalStatusQuality: "strong",
+  },
+  streaming: {
+    streamsAssistantText: true,
+    streamsReasoning: true,
+    streamsToolOutput: true,
+    streamsPlanText: true,
+    emitsMessageCompleted: true,
+  },
+  tools: {
+    exposesToolItemIds: true,
+    emitsToolStarted: true,
+    emitsToolCompleted: true,
+    emitsToolOutput: true,
+    supportsMcpTools: true,
+    supportsDynamicToolCallbacks: false,
+  },
+  approvals: {
+    supportsCommandApproval: false,
+    supportsFileReadApproval: false,
+    supportsFileChangeApproval: false,
+    supportsApplyPatchApproval: false,
+    approvalsHaveNativeRequestIds: false,
+    approvalCallbacksAreLiveOnly: false,
+    approvalsCanOriginateFromSubagents: false,
+  },
+  planning: {
+    emitsPlanUpdated: true,
+    emitsTodoList: true,
+    emitsProposedPlan: true,
+    supportsStructuredQuestions: false,
+    planDeltasHaveItemIds: true,
+  },
+  subagents: {
+    supportsSubagents: true,
+    exposesSubagentThreadIds: false,
+    emitsSubagentLifecycle: true,
+    canWaitForSubagents: true,
+    canCloseSubagents: false,
+    canForkSubagentThread: false,
+  },
+  context: {
+    acceptsSystemContext: false,
+    acceptsDeveloperContext: false,
+    acceptsSyntheticUserContext: true,
+    canGenerateSummaries: true,
+    canConsumeHandoffSummaries: true,
+    supportsDeltaHandoff: true,
+    supportsFullThreadHandoff: true,
+    maxRecommendedHandoffChars: null,
+  },
+  checkpointing: {
+    appCanCheckpointFilesystem: true,
+    supportsNestedCheckpointScopes: true,
+    providerCanRollbackConversation: false,
+    providerRollbackReturnsSnapshot: false,
+    providerCanReadConversationSnapshot: true,
+  },
+  identity: {
+    nativeThreadIds: "strong",
+    nativeTurnIds: "strong",
+    nativeItemIds: "weak",
+    nativeRequestIds: "none",
+  },
+} satisfies OrchestrationV2ProviderCapabilities;
+
+export interface CursorRuntimeAgentPolicy {
+  readonly autoReview: boolean;
+  readonly sandboxEnabled: boolean;
+}
+
+export function cursorRuntimeAgentPolicy(
+  runtimePolicy: ProviderAdapterV2RuntimePolicy,
+): CursorRuntimeAgentPolicy {
+  const sandboxPolicyType =
+    typeof runtimePolicy.sandboxPolicy === "object" &&
+    runtimePolicy.sandboxPolicy !== null &&
+    "type" in runtimePolicy.sandboxPolicy &&
+    typeof runtimePolicy.sandboxPolicy.type === "string"
+      ? runtimePolicy.sandboxPolicy.type
+      : undefined;
+  return {
+    autoReview:
+      runtimePolicy.approvalPolicy === undefined
+        ? runtimePolicy.runtimeMode === "approval-required"
+        : runtimePolicy.approvalPolicy !== "never",
+    sandboxEnabled:
+      runtimePolicy.sandboxPolicy === undefined
+        ? runtimePolicy.runtimeMode !== "full-access"
+        : sandboxPolicyType !== "dangerFullAccess",
+  };
+}
+
+export function cursorMcpServers(threadId: ThreadId): Record<string, McpServerConfig> | undefined {
+  const session = McpProviderSession.readMcpProviderSession(threadId);
+  if (session === undefined) {
+    return undefined;
+  }
+  return {
+    "t3-code": {
+      type: "http",
+      url: session.endpoint,
+      headers: {
+        Authorization: session.authorizationHeader,
+      },
+    },
+  };
+}
+
+function providerSession(input: {
+  readonly providerSessionId: OrchestrationV2ProviderSession["id"];
+  readonly providerInstanceId: ProviderInstanceId;
+  readonly cwd: string | null;
+  readonly model: string;
+  readonly now: DateTime.Utc;
+}): OrchestrationV2ProviderSession {
+  return {
+    id: input.providerSessionId,
+    driver: CURSOR_PROVIDER,
+    providerInstanceId: input.providerInstanceId,
+    status: "ready",
+    cwd: input.cwd ?? process.cwd(),
+    model: input.model,
+    capabilities: CursorProviderCapabilitiesV2,
+    createdAt: input.now,
+    updatedAt: input.now,
+    lastError: null,
+  };
+}
+
+function makeProviderThread(input: {
+  readonly idAllocator: IdAllocatorV2Shape;
+  readonly providerInstanceId: ProviderInstanceId;
+  readonly appThreadId: OrchestrationV2ProviderThread["appThreadId"];
+  readonly providerSessionId: OrchestrationV2ProviderThread["providerSessionId"];
+  readonly nativeThreadId: string;
+  readonly ownerNodeId?: OrchestrationV2ProviderThread["ownerNodeId"];
+  readonly forkedFrom?: OrchestrationV2ProviderThread["forkedFrom"];
+  readonly now: DateTime.Utc;
+}): OrchestrationV2ProviderThread {
+  return {
+    id: input.idAllocator.derive.providerThread({
+      driver: CURSOR_PROVIDER,
+      nativeThreadId: input.nativeThreadId,
+    }),
+    driver: CURSOR_PROVIDER,
+    providerInstanceId: input.providerInstanceId,
+    providerSessionId: input.providerSessionId,
+    appThreadId: input.appThreadId,
+    ownerNodeId: input.ownerNodeId ?? null,
+    nativeThreadRef: {
+      driver: CURSOR_PROVIDER,
+      nativeId: input.nativeThreadId,
+      strength: "strong",
+    },
+    nativeConversationHeadRef: null,
+    status: "idle",
+    firstRunOrdinal: null,
+    lastRunOrdinal: null,
+    handoffIds: [],
+    forkedFrom: input.forkedFrom ?? null,
+    createdAt: input.now,
+    updatedAt: input.now,
+  };
+}
+
+function nativeThreadId(providerThread: OrchestrationV2ProviderThread): string {
+  const id = providerThread.nativeThreadRef?.nativeId;
+  if (id === null || id === undefined) {
+    throw new ProviderAdapterProtocolError({
+      driver: CURSOR_PROVIDER,
+      detail: `Provider thread ${providerThread.id} is missing its Cursor agent id.`,
+    });
+  }
+  return id;
+}
+
+export function makeCursorAgentOptions(input: {
+  readonly apiKey?: string;
+  readonly modelSelection: ModelSelection;
+  readonly runtimePolicy: ProviderAdapterV2RuntimePolicy;
+  readonly threadId: ThreadId;
+}): AgentOptions {
+  const policy = cursorRuntimeAgentPolicy(input.runtimePolicy);
+  const mcpServers = cursorMcpServers(input.threadId);
+  return {
+    model: cursorSdkModelSelection(input.modelSelection),
+    name: `T3 Code ${input.threadId}`,
+    mode: input.runtimePolicy.interactionMode === "plan" ? "plan" : "agent",
+    ...(input.apiKey === undefined ? {} : { apiKey: input.apiKey }),
+    local: {
+      ...(input.runtimePolicy.cwd === null ? {} : { cwd: input.runtimePolicy.cwd }),
+      autoReview: policy.autoReview,
+      sandboxOptions: {
+        enabled: policy.sandboxEnabled,
+      },
+      enableAgentRetries: true,
+    },
+    ...(mcpServers === undefined ? {} : { mcpServers }),
+  };
+}
+
+function stableJson(value: unknown): string {
+  try {
+    return JSON.stringify(value, null, 2);
+  } catch {
+    return String(value);
+  }
+}
+
+function unknownRecord(value: unknown): Record<string, unknown> | undefined {
+  return typeof value === "object" && value !== null && !Array.isArray(value)
+    ? (value as Record<string, unknown>)
+    : undefined;
+}
+
+function nestedString(value: unknown, keys: ReadonlyArray<string>): string | undefined {
+  let current: unknown = value;
+  for (const key of keys) {
+    current = unknownRecord(current)?.[key];
+  }
+  return typeof current === "string" ? current : undefined;
+}
+
+function cursorToolFailed(toolCall: ToolCall): boolean {
+  if (toolCall.result?.status === "error") {
+    return true;
+  }
+  return toolCall.type === "mcp" && toolCall.result?.status === "success"
+    ? toolCall.result.value.isError
+    : false;
+}
+
+function cursorToolOutput(toolCall: ToolCall): unknown {
+  const result = toolCall.result;
+  if (result === undefined) {
+    return undefined;
+  }
+  return result.status === "success" ? result.value : result.error;
+}
+
+function cursorToolOutputText(toolCall: ToolCall): string {
+  if (toolCall.type === "shell" && toolCall.result?.status === "success") {
+    return [toolCall.result.value.stdout, toolCall.result.value.stderr]
+      .filter((part) => part.length > 0)
+      .join("\n");
+  }
+  if (toolCall.type === "mcp" && toolCall.result?.status === "success") {
+    return toolCall.result.value.content
+      .flatMap((part) => (part.text === undefined ? [] : [part.text.text]))
+      .join("\n");
+  }
+  const output = cursorToolOutput(toolCall);
+  if (output === undefined) {
+    return "";
+  }
+  return typeof output === "string" ? output : stableJson(output);
+}
+
+function cursorToolName(toolCall: ToolCall): string {
+  if (toolCall.type !== "mcp") {
+    return toolCall.type;
+  }
+  const provider = toolCall.args.providerIdentifier ?? "mcp";
+  const tool = toolCall.args.toolName ?? "unknown";
+  return `mcp__${provider}__${tool}`;
+}
+
+function cursorToolFileName(toolCall: ToolCall): string {
+  switch (toolCall.type) {
+    case "write":
+    case "delete":
+    case "read":
+    case "edit":
+    case "ls":
+      return toolCall.args.path;
+    case "generateImage":
+      return toolCall.args.filePath ?? "generated-image";
+    default:
+      return cursorToolName(toolCall);
+  }
+}
+
+function cursorToolSearchPattern(toolCall: ToolCall): string | undefined {
+  switch (toolCall.type) {
+    case "glob":
+      return toolCall.args.globPattern;
+    case "grep":
+      return toolCall.args.pattern;
+    case "semSearch":
+      return toolCall.args.query;
+    case "read":
+    case "ls":
+      return toolCall.args.path;
+    case "readLints":
+      return toolCall.args.paths.join(", ");
+    default:
+      return undefined;
+  }
+}
+
+function cursorToolSearchResults(toolCall: ToolCall): ReadonlyArray<{
+  readonly fileName: string;
+  readonly line?: number;
+  readonly preview?: string;
+}> {
+  if (toolCall.result?.status !== "success") {
+    return [];
+  }
+  switch (toolCall.type) {
+    case "read":
+      return [
+        {
+          fileName: toolCall.args.path,
+          preview: toolCall.result.value.content,
+        },
+      ];
+    case "glob":
+      return toolCall.result.value.files.map((fileName) => ({ fileName }));
+    case "grep":
+      return Object.values(toolCall.result.value.workspaceResults ?? {}).flatMap((result) => {
+        if (result.type === "files") {
+          return result.output.files.map((fileName) => ({ fileName }));
+        }
+        if (result.type === "count") {
+          return result.output.counts.map((entry) => ({
+            fileName: entry.file,
+            preview: `${entry.count} matches`,
+          }));
+        }
+        return result.output.matches.map((entry) => ({
+          fileName: entry.file,
+          ...(entry.lineNumber === undefined ? {} : { line: entry.lineNumber }),
+          preview: entry.line,
+        }));
+      });
+    case "semSearch":
+      return [
+        {
+          fileName: "semantic-search",
+          preview: toolCall.result.value.results,
+        },
+      ];
+    default:
+      return [];
+  }
+}
+
+function cursorTodoSteps(
+  toolCall: Extract<ToolCall, { readonly type: "updateTodos" }>,
+): ReadonlyArray<OrchestrationV2PlanStep> {
+  const todos =
+    toolCall.result?.status === "success" ? toolCall.result.value.todos : toolCall.args.todos;
+  return todos
+    .filter((todo) => todo.status !== "cancelled" && todo.content.trim().length > 0)
+    .map((todo, index) => ({
+      id: `todo-${index + 1}`,
+      text: todo.content,
+      status:
+        todo.status === "inProgress"
+          ? "running"
+          : todo.status === "completed"
+            ? "completed"
+            : "pending",
+    }));
+}
+
+function assistantTextsFromConversationSteps(steps: ReadonlyArray<unknown>): ReadonlyArray<string> {
+  return steps.flatMap((step) => {
+    const record = unknownRecord(step);
+    if (record?.type === "assistantMessage") {
+      const text = nestedString(record, ["message", "text"]);
+      return text === undefined || text.length === 0 ? [] : [text];
+    }
+    const text = nestedString(record, ["assistantMessage", "text"]);
+    return text === undefined || text.length === 0 ? [] : [text];
+  });
+}
+
+function nestedToolResult<Value = Record<string, unknown>>(
+  rawResult: unknown,
+  mapSuccess: (success: Record<string, unknown>) => Value = (success) => success as Value,
+):
+  | { readonly status: "success"; readonly value: Value }
+  | { readonly status: "error"; readonly error: unknown }
+  | undefined {
+  const result = unknownRecord(rawResult);
+  if (result === undefined) {
+    return undefined;
+  }
+  const success = unknownRecord(result.success);
+  if (success !== undefined) {
+    return {
+      status: "success",
+      value: mapSuccess(success),
+    };
+  }
+  return {
+    status: "error",
+    error: result.error ?? result.permissionDenied ?? result,
+  };
+}
+
+function nestedGrepWorkspaceResults(success: Record<string, unknown>): Record<string, unknown> {
+  const workspaces = unknownRecord(success.workspaceResults);
+  if (workspaces === undefined) {
+    return {};
+  }
+  return Object.fromEntries(
+    Object.entries(workspaces).map(([workspace, rawWorkspaceResult]) => {
+      const workspaceResult = unknownRecord(rawWorkspaceResult);
+      const content = unknownRecord(workspaceResult?.content);
+      const rawMatches = Array.isArray(content?.matches) ? content.matches : [];
+      const matches = rawMatches.flatMap((rawFileMatch) => {
+        const fileMatch = unknownRecord(rawFileMatch);
+        const file = typeof fileMatch?.file === "string" ? fileMatch.file : "";
+        const lineMatches = Array.isArray(fileMatch?.matches) ? fileMatch.matches : [];
+        return lineMatches.flatMap((rawLineMatch) => {
+          const lineMatch = unknownRecord(rawLineMatch);
+          if (lineMatch === undefined) {
+            return [];
+          }
+          const line = typeof lineMatch.content === "string" ? lineMatch.content : undefined;
+          if (file.length === 0 || line === undefined) {
+            return [];
+          }
+          return [
+            {
+              file,
+              line,
+              ...(typeof lineMatch.lineNumber === "number"
+                ? { lineNumber: lineMatch.lineNumber }
+                : {}),
+            },
+          ];
+        });
+      });
+      return [
+        workspace,
+        {
+          type: "content",
+          output: {
+            matches,
+            totalMatches:
+              typeof content?.totalMatchedLines === "number"
+                ? content.totalMatchedLines
+                : matches.length,
+          },
+        },
+      ];
+    }),
+  );
+}
+
+export function nestedToolCallFromEnvelope(
+  envelope: Record<string, unknown>,
+): { readonly callId: string; readonly toolCall: ToolCall } | undefined {
+  const callId = typeof envelope.toolCallId === "string" ? envelope.toolCallId : undefined;
+  const wrapperEntry = Object.entries(envelope).find(([key]) => key.endsWith("ToolCall"));
+  if (wrapperEntry === undefined) {
+    return undefined;
+  }
+  const [wrapperName, rawCall] = wrapperEntry;
+  const call = unknownRecord(rawCall);
+  if (call === undefined) {
+    return undefined;
+  }
+  const args = unknownRecord(call.args) ?? {};
+  const fallbackCallId = `nested-${wrapperName}`;
+  const nestedCallId = callId ?? fallbackCallId;
+
+  switch (wrapperName) {
+    case "readToolCall": {
+      const success = unknownRecord(unknownRecord(call.result)?.success);
+      const path =
+        typeof args.path === "string"
+          ? args.path
+          : typeof success?.path === "string"
+            ? success.path
+            : "<unknown path>";
+      return {
+        callId: nestedCallId,
+        toolCall: {
+          type: "read",
+          args: { path },
+          result: nestedToolResult(call.result, (value) => ({
+            content: typeof value.content === "string" ? value.content : "",
+            totalLines: typeof value.totalLines === "number" ? value.totalLines : 0,
+            fileSize: typeof value.fileSize === "number" ? value.fileSize : 0,
+          })),
+        } as unknown as ToolCall,
+      };
+    }
+    case "globToolCall":
+      return {
+        callId: nestedCallId,
+        toolCall: {
+          type: "glob",
+          args: {
+            globPattern: typeof args.globPattern === "string" ? args.globPattern : "**/*",
+            ...(typeof args.targetDirectory === "string"
+              ? { targetDirectory: args.targetDirectory }
+              : {}),
+          },
+          result: nestedToolResult(call.result, (value) => ({
+            files: Array.isArray(value.files)
+              ? value.files.filter((file): file is string => typeof file === "string")
+              : [],
+            totalFiles: typeof value.totalFiles === "number" ? value.totalFiles : 0,
+            clientTruncated: false,
+            ripgrepTruncated: false,
+          })),
+        } as unknown as ToolCall,
+      };
+    case "grepToolCall":
+      return {
+        callId: nestedCallId,
+        toolCall: {
+          type: "grep",
+          args: {
+            pattern: typeof args.pattern === "string" ? args.pattern : "",
+            ...(typeof args.path === "string" ? { path: args.path } : {}),
+            ...(typeof args.glob === "string" ? { glob: args.glob } : {}),
+            ...(typeof args.outputMode === "string" ? { outputMode: args.outputMode } : {}),
+            ...(typeof args.caseInsensitive === "boolean"
+              ? { caseInsensitive: args.caseInsensitive }
+              : {}),
+            ...(typeof args.offset === "number" ? { offset: args.offset } : {}),
+            ...(typeof args.multiline === "boolean" ? { multiline: args.multiline } : {}),
+          },
+          result: nestedToolResult(call.result, (value) => ({
+            workspaceResults: nestedGrepWorkspaceResults(value),
+          })),
+        } as unknown as ToolCall,
+      };
+    case "shellToolCall": {
+      const rawResult = unknownRecord(call.result);
+      const permissionDenied = unknownRecord(rawResult?.permissionDenied);
+      const command =
+        typeof args.command === "string"
+          ? args.command
+          : typeof permissionDenied?.command === "string"
+            ? permissionDenied.command
+            : "<unknown command>";
+      return {
+        callId: nestedCallId,
+        toolCall: {
+          type: "shell",
+          args: { command },
+          result: nestedToolResult(call.result, (value) => ({
+            stdout: typeof value.stdout === "string" ? value.stdout : "",
+            stderr: typeof value.stderr === "string" ? value.stderr : "",
+            exitCode: typeof value.exitCode === "number" ? value.exitCode : 0,
+            signal: typeof value.signal === "string" ? value.signal : "",
+            executionTime: typeof value.executionTime === "number" ? value.executionTime : 0,
+          })),
+        } as unknown as ToolCall,
+      };
+    }
+    default: {
+      const type = wrapperName.slice(0, -"ToolCall".length);
+      return {
+        callId: nestedCallId,
+        toolCall: {
+          type,
+          args,
+          result: nestedToolResult(call.result),
+        } as unknown as ToolCall,
+      };
+    }
+  }
+}
+
+function toolCallsFromConversationSteps(
+  steps: ReadonlyArray<unknown>,
+): ReadonlyArray<{ readonly callId: string; readonly toolCall: ToolCall }> {
+  return steps.flatMap((step) => {
+    const record = unknownRecord(step);
+    if (record?.type === "toolCall") {
+      const message = unknownRecord(record.message);
+      return typeof message?.type === "string"
+        ? [
+            {
+              callId: typeof record.callId === "string" ? record.callId : `nested-${message.type}`,
+              toolCall: message as ToolCall,
+            },
+          ]
+        : [];
+    }
+    const envelope = unknownRecord(record?.toolCall);
+    const nested = envelope === undefined ? undefined : nestedToolCallFromEnvelope(envelope);
+    return nested === undefined ? [] : [nested];
+  });
+}
+
+function textFromAgentMessage(message: AgentMessage): string {
+  const value = message.message;
+  if (typeof value === "string") {
+    return value;
+  }
+  const direct =
+    nestedString(value, ["text"]) ??
+    nestedString(value, ["message", "text"]) ??
+    nestedString(value, ["userMessage", "text"]) ??
+    nestedString(value, ["assistantMessage", "text"]);
+  if (direct !== undefined) {
+    return direct;
+  }
+  const content = unknownRecord(value)?.content;
+  if (!Array.isArray(content)) {
+    return "";
+  }
+  return content
+    .flatMap((part) => {
+      const text = unknownRecord(part)?.text;
+      return typeof text === "string" ? [text] : [];
+    })
+    .join("");
+}
+
+interface CursorProjectionTarget {
+  readonly threadId: ThreadId;
+  readonly runId: ProviderAdapterV2TurnInput["runId"] | null;
+  readonly rootNodeId: OrchestrationV2ExecutionNode["rootNodeId"];
+  readonly parentNodeId: OrchestrationV2ExecutionNode["id"];
+  readonly providerThreadId: OrchestrationV2ProviderThread["id"] | null;
+  readonly providerTurnId: OrchestrationV2ProviderTurn["id"] | null;
+}
+
+interface ActiveCursorToolCall {
+  readonly callId: string;
+  toolCall: ToolCall;
+  readonly target: CursorProjectionTarget;
+  readonly ordinal: number;
+  readonly startedAt: DateTime.Utc;
+  streamedOutput: string;
+}
+
+interface ActiveCursorSubagent {
+  task: OrchestrationV2Subagent;
+  readonly callId: string;
+  readonly childThreadId: ThreadId;
+  readonly childRootNodeId: OrchestrationV2ExecutionNode["id"];
+  readonly turnItemId: OrchestrationV2TurnItem["id"];
+  readonly turnItemOrdinal: number;
+  nextChildOrdinal: number;
+  resultProjected: boolean;
+}
+
+interface ActiveCursorTextSegment {
+  readonly nativeItemId: string;
+  readonly startedAt: DateTime.Utc;
+  text: string;
+}
+
+interface ActiveCursorTextStream {
+  current: ActiveCursorTextSegment | null;
+  nextSegment: number;
+}
+
+interface ActiveCursorTurn {
+  readonly input: ProviderAdapterV2TurnInput;
+  readonly run: CursorAgentSdkRun;
+  readonly providerTurnId: OrchestrationV2ProviderTurn["id"];
+  readonly startedAt: DateTime.Utc;
+  readonly completed: Deferred.Deferred<void, never>;
+  readonly tools: Map<string, ActiveCursorToolCall>;
+  readonly subagents: Map<string, ActiveCursorSubagent>;
+  readonly assistant: ActiveCursorTextStream;
+  readonly reasoning: ActiveCursorTextStream;
+  interrupted: boolean;
+  finalized: boolean;
+}
+
+interface CursorLiveAgent {
+  readonly nativeThreadId: string;
+  readonly session: CursorAgentSdkSession;
+}
+
+export interface CursorAdapterV2Options {
+  readonly instanceId: ProviderInstanceId;
+  readonly settings: CursorSettings;
+  readonly environment: NodeJS.ProcessEnv;
+  readonly fileSystem: FileSystem.FileSystem;
+  readonly idAllocator: IdAllocatorV2Shape;
+  readonly runner: CursorAgentSdkRunnerShape;
+  readonly serverConfig: ServerConfig["Service"];
+}
+
+export function makeCursorAdapterV2(
+  adapterOptions: CursorAdapterV2Options,
+): ProviderAdapterV2Shape {
+  const { fileSystem, idAllocator, runner, serverConfig } = adapterOptions;
+  const apiKey = adapterOptions.environment.CURSOR_API_KEY?.trim() || undefined;
+
+  return ProviderAdapterV2.of({
+    instanceId: adapterOptions.instanceId,
+    driver: CURSOR_PROVIDER,
+    getCapabilities: () => Effect.succeed(CursorProviderCapabilitiesV2),
+    planSelectionTransition: () => Effect.succeed(turnScopedSelectionTransition()),
+    openSession: Effect.fn("CursorAdapterV2.openSession")(
+      function* (input: ProviderAdapterV2OpenSessionInput) {
+        const sessionScope = yield* Effect.scope;
+        const createdAt = yield* DateTime.now;
+        const session = providerSession({
+          providerSessionId: input.providerSessionId,
+          providerInstanceId: adapterOptions.instanceId,
+          cwd: input.runtimePolicy.cwd,
+          model: input.modelSelection.model,
+          now: createdAt,
+        });
+        const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+        const liveAgent = yield* Ref.make<CursorLiveAgent | null>(null);
+        const activeTurn = yield* Ref.make<ActiveCursorTurn | null>(null);
+        const itemOrdinals = yield* Ref.make(new Map<string, number>());
+        const nextItemOrdinalsByTurn = yield* Ref.make(new Map<string, number>());
+        const planIds = yield* Ref.make(new Map<string, OrchestrationV2PlanArtifact["id"]>());
+
+        const emitProviderEvent = (event: ProviderAdapterV2Event) =>
+          Queue.offer(events, event).pipe(Effect.asVoid);
+
+        const resolveItemOrdinal = Effect.fnUntraced(function* (
+          context: ActiveCursorTurn,
+          nativeItemId: string,
+        ) {
+          const existing = (yield* Ref.get(itemOrdinals)).get(nativeItemId);
+          if (existing !== undefined) {
+            return existing;
+          }
+          const nextWithinTurn = yield* Ref.modify(nextItemOrdinalsByTurn, (current) => {
+            const next = (current.get(context.run.runId) ?? 0) + 1;
+            const updated = new Map(current);
+            updated.set(context.run.runId, next);
+            return [next, updated];
+          });
+          const ordinal = context.input.providerTurnOrdinal * 100 + nextWithinTurn;
+          yield* Ref.update(itemOrdinals, (current) => {
+            const updated = new Map(current);
+            updated.set(nativeItemId, ordinal);
+            return updated;
+          });
+          return ordinal;
+        });
+
+        const resolvePlanId = Effect.fnUntraced(function* (
+          context: ActiveCursorTurn,
+          nativeItemId: string,
+        ) {
+          const existing = (yield* Ref.get(planIds)).get(nativeItemId);
+          if (existing !== undefined) {
+            return existing;
+          }
+          const planId = yield* idAllocator.allocate.plan({
+            threadId: context.input.threadId,
+            runId: context.input.runId,
+            driver: CURSOR_PROVIDER,
+          });
+          yield* Ref.update(planIds, (current) => {
+            const updated = new Map(current);
+            updated.set(nativeItemId, planId);
+            return updated;
+          });
+          return planId;
+        });
+
+        const parentTarget = (context: ActiveCursorTurn): CursorProjectionTarget => ({
+          threadId: context.input.threadId,
+          runId: context.input.runId,
+          rootNodeId: context.input.rootNodeId,
+          parentNodeId: context.input.rootNodeId,
+          providerThreadId: context.input.providerThread.id,
+          providerTurnId: context.providerTurnId,
+        });
+
+        const emitAssistant = Effect.fnUntraced(function* (
+          context: ActiveCursorTurn,
+          completed: boolean,
+        ) {
+          const segment = context.assistant.current;
+          if (segment === null || segment.text.length === 0) {
+            return;
+          }
+          const now = yield* DateTime.now;
+          const ordinal = yield* resolveItemOrdinal(context, segment.nativeItemId);
+          const nodeId = idAllocator.derive.nodeFromProviderItem({
+            driver: CURSOR_PROVIDER,
+            nativeItemId: segment.nativeItemId,
+          });
+          const messageId = idAllocator.derive.messageFromProviderItem({
+            driver: CURSOR_PROVIDER,
+            nativeItemId: segment.nativeItemId,
+          });
+          const turnItemId = idAllocator.derive.turnItemFromProviderItem({
+            driver: CURSOR_PROVIDER,
+            nativeItemId: segment.nativeItemId,
+          });
+          const nativeItemRef = {
+            driver: CURSOR_PROVIDER,
+            nativeId: segment.nativeItemId,
+            strength: "weak" as const,
+          };
+          yield* emitProviderEvent({
+            type: "node.updated",
+            driver: CURSOR_PROVIDER,
+            node: {
+              id: nodeId,
+              threadId: context.input.threadId,
+              runId: context.input.runId,
+              parentNodeId: context.input.rootNodeId,
+              rootNodeId: context.input.rootNodeId,
+              kind: "assistant_message",
+              status: completed ? "completed" : "running",
+              countsForRun: false,
+              providerThreadId: context.input.providerThread.id,
+              providerTurnId: context.providerTurnId,
+              nativeItemRef,
+              runtimeRequestId: null,
+              checkpointScopeId: null,
+              startedAt: segment.startedAt,
+              completedAt: completed ? now : null,
+            },
+          });
+          yield* emitProviderEvent({
+            type: "message.updated",
+            driver: CURSOR_PROVIDER,
+            message: {
+              createdBy: "agent",
+              creationSource: "provider",
+              id: messageId,
+              threadId: context.input.threadId,
+              runId: context.input.runId,
+              nodeId,
+              role: "assistant",
+              text: segment.text,
+              attachments: [],
+              streaming: !completed,
+              createdAt: segment.startedAt,
+              updatedAt: now,
+            },
+          });
+          yield* emitProviderEvent({
+            type: "turn_item.updated",
+            driver: CURSOR_PROVIDER,
+            turnItem: {
+              id: turnItemId,
+              threadId: context.input.threadId,
+              runId: context.input.runId,
+              nodeId,
+              providerThreadId: context.input.providerThread.id,
+              providerTurnId: context.providerTurnId,
+              nativeItemRef,
+              parentItemId: null,
+              ordinal,
+              status: completed ? "completed" : "running",
+              title: null,
+              startedAt: segment.startedAt,
+              completedAt: completed ? now : null,
+              updatedAt: now,
+              type: "assistant_message",
+              messageId,
+              text: segment.text,
+              streaming: !completed,
+            },
+          });
+        });
+
+        const emitReasoning = Effect.fnUntraced(function* (
+          context: ActiveCursorTurn,
+          completed: boolean,
+        ) {
+          const segment = context.reasoning.current;
+          if (segment === null || segment.text.length === 0) {
+            return;
+          }
+          const now = yield* DateTime.now;
+          const ordinal = yield* resolveItemOrdinal(context, segment.nativeItemId);
+          const nodeId = idAllocator.derive.nodeFromProviderItem({
+            driver: CURSOR_PROVIDER,
+            nativeItemId: segment.nativeItemId,
+          });
+          const turnItemId = idAllocator.derive.turnItemFromProviderItem({
+            driver: CURSOR_PROVIDER,
+            nativeItemId: segment.nativeItemId,
+          });
+          const nativeItemRef = {
+            driver: CURSOR_PROVIDER,
+            nativeId: segment.nativeItemId,
+            strength: "weak" as const,
+          };
+          yield* emitProviderEvent({
+            type: "node.updated",
+            driver: CURSOR_PROVIDER,
+            node: {
+              id: nodeId,
+              threadId: context.input.threadId,
+              runId: context.input.runId,
+              parentNodeId: context.input.rootNodeId,
+              rootNodeId: context.input.rootNodeId,
+              kind: "reasoning",
+              status: completed ? "completed" : "running",
+              countsForRun: false,
+              providerThreadId: context.input.providerThread.id,
+              providerTurnId: context.providerTurnId,
+              nativeItemRef,
+              runtimeRequestId: null,
+              checkpointScopeId: null,
+              startedAt: segment.startedAt,
+              completedAt: completed ? now : null,
+            },
+          });
+          yield* emitProviderEvent({
+            type: "turn_item.updated",
+            driver: CURSOR_PROVIDER,
+            turnItem: {
+              id: turnItemId,
+              threadId: context.input.threadId,
+              runId: context.input.runId,
+              nodeId,
+              providerThreadId: context.input.providerThread.id,
+              providerTurnId: context.providerTurnId,
+              nativeItemRef,
+              parentItemId: null,
+              ordinal,
+              status: completed ? "completed" : "running",
+              title: null,
+              startedAt: segment.startedAt,
+              completedAt: completed ? now : null,
+              updatedAt: now,
+              type: "reasoning",
+              text: segment.text,
+              streaming: !completed,
+            },
+          });
+        });
+
+        const appendTextSegment = Effect.fnUntraced(function* (input: {
+          readonly context: ActiveCursorTurn;
+          readonly stream: ActiveCursorTextStream;
+          readonly kind: "assistant" | "reasoning";
+          readonly text: string;
+        }) {
+          if (input.stream.current === null) {
+            input.stream.nextSegment += 1;
+            input.stream.current = {
+              nativeItemId: `${input.kind}:${input.context.run.runId}:${input.stream.nextSegment}`,
+              startedAt: yield* DateTime.now,
+              text: "",
+            };
+          }
+          input.stream.current.text += input.text;
+        });
+
+        const completeAssistant = Effect.fnUntraced(function* (context: ActiveCursorTurn) {
+          if (context.assistant.current === null) {
+            return;
+          }
+          yield* emitAssistant(context, true);
+          context.assistant.current = null;
+        });
+
+        const completeReasoning = Effect.fnUntraced(function* (context: ActiveCursorTurn) {
+          if (context.reasoning.current === null) {
+            return;
+          }
+          yield* emitReasoning(context, true);
+          context.reasoning.current = null;
+        });
+
+        const emitToolArtifacts = Effect.fnUntraced(function* (input: {
+          readonly active: ActiveCursorToolCall;
+          readonly completed: boolean;
+        }) {
+          const { active } = input;
+          const toolCall = active.toolCall;
+          const now = yield* DateTime.now;
+          const failed = input.completed && cursorToolFailed(toolCall);
+          const status = input.completed ? (failed ? "failed" : "completed") : "running";
+          const nodeId = idAllocator.derive.nodeFromProviderItem({
+            driver: CURSOR_PROVIDER,
+            nativeItemId: active.callId,
+          });
+          const turnItemId = idAllocator.derive.turnItemFromProviderItem({
+            driver: CURSOR_PROVIDER,
+            nativeItemId: active.callId,
+          });
+          const nativeItemRef = {
+            driver: CURSOR_PROVIDER,
+            nativeId: active.callId,
+            strength: "strong" as const,
+          };
+          const node: OrchestrationV2ExecutionNode = {
+            id: nodeId,
+            threadId: active.target.threadId,
+            runId: active.target.runId,
+            parentNodeId: active.target.parentNodeId,
+            rootNodeId: active.target.rootNodeId,
+            kind: "tool_call",
+            status,
+            countsForRun: false,
+            providerThreadId: active.target.providerThreadId,
+            providerTurnId: active.target.providerTurnId,
+            nativeItemRef,
+            runtimeRequestId: null,
+            checkpointScopeId: null,
+            startedAt: active.startedAt,
+            completedAt: input.completed ? now : null,
+          };
+          const base = {
+            id: turnItemId,
+            threadId: active.target.threadId,
+            runId: active.target.runId,
+            nodeId,
+            providerThreadId: active.target.providerThreadId,
+            providerTurnId: active.target.providerTurnId,
+            nativeItemRef,
+            parentItemId: null,
+            ordinal: active.ordinal,
+            status,
+            title: null,
+            startedAt: active.startedAt,
+            completedAt: input.completed ? now : null,
+            updatedAt: now,
+          } satisfies Pick<
+            OrchestrationV2TurnItem,
+            | "id"
+            | "threadId"
+            | "runId"
+            | "nodeId"
+            | "providerThreadId"
+            | "providerTurnId"
+            | "nativeItemRef"
+            | "parentItemId"
+            | "ordinal"
+            | "status"
+            | "title"
+            | "startedAt"
+            | "completedAt"
+            | "updatedAt"
+          >;
+          const outputText = cursorToolOutputText(toolCall) || active.streamedOutput;
+          let turnItem: OrchestrationV2TurnItem;
+          switch (toolCall.type) {
+            case "shell":
+              turnItem = {
+                ...base,
+                type: "command_execution",
+                input: toolCall.args.command,
+                ...(outputText.length === 0 ? {} : { output: outputText }),
+                ...(toolCall.result?.status === "success"
+                  ? { exitCode: toolCall.result.value.exitCode }
+                  : {}),
+              };
+              break;
+            case "write":
+            case "delete":
+            case "edit":
+            case "generateImage":
+              turnItem = {
+                ...base,
+                type: "file_change",
+                fileName: cursorToolFileName(toolCall),
+                ...(toolCall.type === "edit" &&
+                toolCall.result?.status === "success" &&
+                toolCall.result.value.linesAdded !== undefined
+                  ? { additions: toolCall.result.value.linesAdded }
+                  : {}),
+                ...(toolCall.type === "edit" &&
+                toolCall.result?.status === "success" &&
+                toolCall.result.value.linesRemoved !== undefined
+                  ? { deletions: toolCall.result.value.linesRemoved }
+                  : {}),
+                ...(toolCall.type === "edit" &&
+                toolCall.result?.status === "success" &&
+                toolCall.result.value.diffString !== undefined
+                  ? { diffStr: toolCall.result.value.diffString }
+                  : {}),
+                ...(toolCall.type === "write" ? { newStr: toolCall.args.fileText } : {}),
+              };
+              break;
+            case "glob":
+            case "grep":
+            case "read":
+            case "ls":
+            case "readLints":
+            case "semSearch": {
+              const results = cursorToolSearchResults(toolCall);
+              turnItem = {
+                ...base,
+                type: "file_search",
+                ...(cursorToolSearchPattern(toolCall) === undefined
+                  ? {}
+                  : { pattern: cursorToolSearchPattern(toolCall) }),
+                ...(results.length === 0 ? {} : { results: [...results] }),
+              };
+              break;
+            }
+            default:
+              turnItem = {
+                ...base,
+                type: "dynamic_tool",
+                toolName: cursorToolName(toolCall),
+                input: toolCall.args,
+                ...(cursorToolOutput(toolCall) === undefined
+                  ? {}
+                  : { output: cursorToolOutput(toolCall) }),
+              };
+          }
+          yield* emitProviderEvent({
+            type: "node.updated",
+            driver: CURSOR_PROVIDER,
+            node,
+          });
+          yield* emitProviderEvent({
+            type: "turn_item.updated",
+            driver: CURSOR_PROVIDER,
+            turnItem,
+          });
+        });
+
+        const ensureToolStarted = Effect.fnUntraced(function* (
+          context: ActiveCursorTurn,
+          callId: string,
+          toolCall: ToolCall,
+        ) {
+          const existing = context.tools.get(callId);
+          if (existing !== undefined) {
+            existing.toolCall = toolCall;
+            return existing;
+          }
+          const startedAt = yield* DateTime.now;
+          const active: ActiveCursorToolCall = {
+            callId,
+            toolCall,
+            target: parentTarget(context),
+            ordinal: yield* resolveItemOrdinal(context, callId),
+            startedAt,
+            streamedOutput: "",
+          };
+          context.tools.set(callId, active);
+          yield* emitToolArtifacts({ active, completed: false });
+          return active;
+        });
+
+        const emitPlanArtifacts = Effect.fnUntraced(function* (input: {
+          readonly context: ActiveCursorTurn;
+          readonly callId: string;
+          readonly markdown: string;
+          readonly completed: boolean;
+          readonly failed: boolean;
+        }) {
+          const nativeItemId = `plan:${input.callId}`;
+          const now = yield* DateTime.now;
+          const planId = yield* resolvePlanId(input.context, nativeItemId);
+          const ordinal = yield* resolveItemOrdinal(input.context, nativeItemId);
+          const nodeId = idAllocator.derive.nodeFromProviderItem({
+            driver: CURSOR_PROVIDER,
+            nativeItemId,
+          });
+          const turnItemId = idAllocator.derive.turnItemFromProviderItem({
+            driver: CURSOR_PROVIDER,
+            nativeItemId,
+          });
+          const status = input.failed ? "failed" : input.completed ? "completed" : "running";
+          const nativeItemRef = {
+            driver: CURSOR_PROVIDER,
+            nativeId: input.callId,
+            strength: "strong" as const,
+          };
+          const plan: OrchestrationV2PlanArtifact = {
+            id: planId,
+            threadId: input.context.input.threadId,
+            runId: input.context.input.runId,
+            nodeId,
+            kind: "proposed_plan",
+            status: input.completed ? "active" : "draft",
+            markdown: input.markdown,
+          };
+          yield* emitProviderEvent({
+            type: "node.updated",
+            driver: CURSOR_PROVIDER,
+            node: {
+              id: nodeId,
+              threadId: input.context.input.threadId,
+              runId: input.context.input.runId,
+              parentNodeId: input.context.input.rootNodeId,
+              rootNodeId: input.context.input.rootNodeId,
+              kind: "plan",
+              status,
+              countsForRun: false,
+              providerThreadId: input.context.input.providerThread.id,
+              providerTurnId: input.context.providerTurnId,
+              nativeItemRef,
+              runtimeRequestId: null,
+              checkpointScopeId: null,
+              startedAt: input.context.startedAt,
+              completedAt: input.completed ? now : null,
+            },
+          });
+          yield* emitProviderEvent({
+            type: "plan.updated",
+            driver: CURSOR_PROVIDER,
+            plan,
+          });
+          yield* emitProviderEvent({
+            type: "turn_item.updated",
+            driver: CURSOR_PROVIDER,
+            turnItem: {
+              id: turnItemId,
+              threadId: input.context.input.threadId,
+              runId: input.context.input.runId,
+              nodeId,
+              providerThreadId: input.context.input.providerThread.id,
+              providerTurnId: input.context.providerTurnId,
+              nativeItemRef,
+              parentItemId: null,
+              ordinal,
+              status,
+              title: null,
+              startedAt: input.context.startedAt,
+              completedAt: input.completed ? now : null,
+              updatedAt: now,
+              type: "proposed_plan",
+              planId,
+              markdown: input.markdown,
+              streaming: !input.completed,
+            },
+          });
+        });
+
+        const emitTodoArtifacts = Effect.fnUntraced(function* (input: {
+          readonly context: ActiveCursorTurn;
+          readonly callId: string;
+          readonly toolCall: Extract<ToolCall, { readonly type: "updateTodos" }>;
+          readonly completed: boolean;
+          readonly failed: boolean;
+        }) {
+          const nativeItemId = `todos:${input.callId}`;
+          const now = yield* DateTime.now;
+          const planId = yield* resolvePlanId(input.context, nativeItemId);
+          const ordinal = yield* resolveItemOrdinal(input.context, nativeItemId);
+          const nodeId = idAllocator.derive.nodeFromProviderItem({
+            driver: CURSOR_PROVIDER,
+            nativeItemId,
+          });
+          const turnItemId = idAllocator.derive.turnItemFromProviderItem({
+            driver: CURSOR_PROVIDER,
+            nativeItemId,
+          });
+          const status = input.failed ? "failed" : input.completed ? "completed" : "running";
+          const steps = cursorTodoSteps(input.toolCall);
+          const nativeItemRef = {
+            driver: CURSOR_PROVIDER,
+            nativeId: input.callId,
+            strength: "strong" as const,
+          };
+          yield* emitProviderEvent({
+            type: "node.updated",
+            driver: CURSOR_PROVIDER,
+            node: {
+              id: nodeId,
+              threadId: input.context.input.threadId,
+              runId: input.context.input.runId,
+              parentNodeId: input.context.input.rootNodeId,
+              rootNodeId: input.context.input.rootNodeId,
+              kind: "todo_list",
+              status,
+              countsForRun: false,
+              providerThreadId: input.context.input.providerThread.id,
+              providerTurnId: input.context.providerTurnId,
+              nativeItemRef,
+              runtimeRequestId: null,
+              checkpointScopeId: null,
+              startedAt: input.context.startedAt,
+              completedAt: input.completed ? now : null,
+            },
+          });
+          yield* emitProviderEvent({
+            type: "plan.updated",
+            driver: CURSOR_PROVIDER,
+            plan: {
+              id: planId,
+              threadId: input.context.input.threadId,
+              runId: input.context.input.runId,
+              nodeId,
+              kind: "todo_list",
+              status: input.completed ? "active" : "draft",
+              steps: [...steps],
+            },
+          });
+          yield* emitProviderEvent({
+            type: "turn_item.updated",
+            driver: CURSOR_PROVIDER,
+            turnItem: {
+              id: turnItemId,
+              threadId: input.context.input.threadId,
+              runId: input.context.input.runId,
+              nodeId,
+              providerThreadId: input.context.input.providerThread.id,
+              providerTurnId: input.context.providerTurnId,
+              nativeItemRef,
+              parentItemId: null,
+              ordinal,
+              status,
+              title: null,
+              startedAt: input.context.startedAt,
+              completedAt: input.completed ? now : null,
+              updatedAt: now,
+              type: "todo_list",
+              planId,
+              steps: [...steps],
+            },
+          });
+        });
+
+        const emitSubagent = Effect.fnUntraced(function* (input: {
+          readonly context: ActiveCursorTurn;
+          readonly callId: string;
+          readonly toolCall: Extract<ToolCall, { readonly type: "task" }>;
+          readonly completed: boolean;
+        }) {
+          const args = input.toolCall.args;
+          const result =
+            input.toolCall.result?.status === "success" ? input.toolCall.result.value : undefined;
+          const existing = input.context.subagents.get(input.callId);
+          const now = yield* DateTime.now;
+          const status: OrchestrationV2Subagent["status"] = input.completed
+            ? cursorToolFailed(input.toolCall)
+              ? "failed"
+              : "completed"
+            : "running";
+          const resultText = [
+            ...assistantTextsFromConversationSteps(result?.conversationSteps ?? []),
+            ...(result?.resultSuffix === undefined ? [] : [result.resultSuffix]),
+          ]
+            .filter((part) => part.trim().length > 0)
+            .join("\n");
+          const nativeItemId = input.callId;
+          const nodeId =
+            existing?.task.id ??
+            idAllocator.derive.nodeFromProviderItem({
+              driver: CURSOR_PROVIDER,
+              nativeItemId,
+            });
+          const childRootNodeId =
+            existing?.childRootNodeId ??
+            idAllocator.derive.nodeFromProviderItem({
+              driver: CURSOR_PROVIDER,
+              nativeItemId: `${nativeItemId}:child-root`,
+            });
+          const childThreadId =
+            existing?.childThreadId ??
+            idAllocator.derive.threadFromProviderThread({
+              driver: CURSOR_PROVIDER,
+              nativeThreadId: `${input.context.run.runId}:task:${input.callId}`,
+            });
+          const task: OrchestrationV2Subagent = {
+            ...(existing?.task ?? {
+              id: nodeId,
+              threadId: input.context.input.threadId,
+              runId: input.context.input.runId,
+              parentNodeId: input.context.input.rootNodeId,
+              origin: "provider_native" as const,
+              createdBy: "agent" as const,
+              driver: CURSOR_PROVIDER,
+              providerInstanceId: input.context.input.modelSelection.instanceId,
+              providerThreadId: null,
+              childThreadId,
+              nativeTaskRef: {
+                driver: CURSOR_PROVIDER,
+                nativeId: input.callId,
+                strength: "strong" as const,
+              },
+              prompt: args.prompt,
+              title: args.description,
+              model: args.model ?? input.context.input.modelSelection.model,
+              result: null,
+              startedAt: now,
+            }),
+            nativeTaskRef: {
+              driver: CURSOR_PROVIDER,
+              nativeId: input.callId,
+              strength: "strong" as const,
+            },
+            status,
+            result: resultText.length === 0 ? (existing?.task.result ?? null) : resultText,
+            completedAt: input.completed ? now : null,
+            updatedAt: now,
+          };
+          const subagent: ActiveCursorSubagent = {
+            task,
+            callId: input.callId,
+            childThreadId,
+            childRootNodeId,
+            turnItemId:
+              existing?.turnItemId ??
+              idAllocator.derive.turnItemFromProviderItem({
+                driver: CURSOR_PROVIDER,
+                nativeItemId,
+              }),
+            turnItemOrdinal:
+              existing?.turnItemOrdinal ?? (yield* resolveItemOrdinal(input.context, nativeItemId)),
+            nextChildOrdinal: existing?.nextChildOrdinal ?? 100,
+            resultProjected: existing?.resultProjected ?? false,
+          };
+          input.context.subagents.set(input.callId, subagent);
+
+          if (existing === undefined) {
+            yield* emitProviderEvent({
+              type: "app_thread.created",
+              driver: CURSOR_PROVIDER,
+              appThread: makeSubagentChildThread({
+                parentThread: input.context.input.appThread,
+                childThreadId,
+                parentNodeId: nodeId,
+                activeProviderThreadId: null,
+                providerInstanceId: input.context.input.modelSelection.instanceId,
+                modelSelection: input.context.input.modelSelection,
+                title: subagentThreadTitle({
+                  parentTitle: input.context.input.appThread.title,
+                  title: args.description,
+                  prompt: args.prompt,
+                  ordinal: input.context.subagents.size,
+                }),
+                now,
+                createdBy: "agent",
+                creationSource: "provider",
+              }),
+            });
+            const promptNativeId = `${nativeItemId}:prompt`;
+            const promptArtifacts = makeSubagentConversationArtifacts({
+              messageId: idAllocator.derive.messageFromProviderItem({
+                driver: CURSOR_PROVIDER,
+                nativeItemId: promptNativeId,
+              }),
+              turnItemId: idAllocator.derive.turnItemFromProviderItem({
+                driver: CURSOR_PROVIDER,
+                nativeItemId: promptNativeId,
+              }),
+              threadId: childThreadId,
+              rootNodeId: childRootNodeId,
+              providerThreadId: null,
+              providerTurnId: null,
+              nativeItemRef: {
+                driver: CURSOR_PROVIDER,
+                nativeId: promptNativeId,
+                strength: "weak",
+              },
+              role: "user",
+              text: args.prompt,
+              ordinal: 100,
+              now,
+            });
+            yield* emitProviderEvent({
+              type: "message.updated",
+              driver: CURSOR_PROVIDER,
+              message: promptArtifacts.message,
+            });
+            yield* emitProviderEvent({
+              type: "turn_item.updated",
+              driver: CURSOR_PROVIDER,
+              turnItem: promptArtifacts.turnItem,
+            });
+          }
+
+          yield* emitProviderEvent({
+            type: "node.updated",
+            driver: CURSOR_PROVIDER,
+            node: {
+              id: nodeId,
+              threadId: input.context.input.threadId,
+              runId: input.context.input.runId,
+              parentNodeId: input.context.input.rootNodeId,
+              rootNodeId: input.context.input.rootNodeId,
+              kind: "subagent",
+              status,
+              countsForRun: false,
+              providerThreadId: input.context.input.providerThread.id,
+              providerTurnId: input.context.providerTurnId,
+              nativeItemRef: task.nativeTaskRef,
+              runtimeRequestId: null,
+              checkpointScopeId: null,
+              startedAt: task.startedAt,
+              completedAt: input.completed ? now : null,
+            },
+          });
+          yield* emitProviderEvent({
+            type: "node.updated",
+            driver: CURSOR_PROVIDER,
+            node: {
+              id: childRootNodeId,
+              threadId: childThreadId,
+              runId: null,
+              parentNodeId: null,
+              rootNodeId: childRootNodeId,
+              kind: "root_turn",
+              status,
+              countsForRun: false,
+              providerThreadId: null,
+              providerTurnId: null,
+              nativeItemRef: task.nativeTaskRef,
+              runtimeRequestId: null,
+              checkpointScopeId: null,
+              startedAt: task.startedAt,
+              completedAt: input.completed ? now : null,
+            },
+          });
+          yield* emitProviderEvent({
+            type: "subagent.updated",
+            driver: CURSOR_PROVIDER,
+            subagent: task,
+          });
+          yield* emitProviderEvent({
+            type: "turn_item.updated",
+            driver: CURSOR_PROVIDER,
+            turnItem: {
+              id: subagent.turnItemId,
+              threadId: input.context.input.threadId,
+              runId: input.context.input.runId,
+              nodeId,
+              providerThreadId: input.context.input.providerThread.id,
+              providerTurnId: input.context.providerTurnId,
+              nativeItemRef: task.nativeTaskRef,
+              parentItemId: null,
+              ordinal: subagent.turnItemOrdinal,
+              status,
+              title: task.title,
+              startedAt: task.startedAt,
+              completedAt: task.completedAt,
+              updatedAt: now,
+              type: "subagent",
+              subagentId: task.id,
+              origin: task.origin,
+              driver: task.driver,
+              providerInstanceId: task.providerInstanceId,
+              childThreadId,
+              prompt: task.prompt,
+              result: task.result,
+            },
+          });
+
+          if (input.completed && !subagent.resultProjected) {
+            for (const [index, nestedTool] of toolCallsFromConversationSteps(
+              result?.conversationSteps ?? [],
+            ).entries()) {
+              const callId = `${nativeItemId}:child-tool:${nestedTool.callId || index + 1}`;
+              const startedAt = task.startedAt ?? now;
+              const active: ActiveCursorToolCall = {
+                callId,
+                toolCall: nestedTool.toolCall,
+                target: {
+                  threadId: childThreadId,
+                  runId: null,
+                  rootNodeId: childRootNodeId,
+                  parentNodeId: childRootNodeId,
+                  providerThreadId: null,
+                  providerTurnId: null,
+                },
+                ordinal: ++subagent.nextChildOrdinal,
+                startedAt,
+                streamedOutput: "",
+              };
+              yield* emitToolArtifacts({ active, completed: true });
+            }
+            if (task.result !== null && task.result.length > 0) {
+              const resultNativeId = `${nativeItemId}:result`;
+              const resultArtifacts = makeSubagentConversationArtifacts({
+                messageId: idAllocator.derive.messageFromProviderItem({
+                  driver: CURSOR_PROVIDER,
+                  nativeItemId: resultNativeId,
+                }),
+                turnItemId: idAllocator.derive.turnItemFromProviderItem({
+                  driver: CURSOR_PROVIDER,
+                  nativeItemId: resultNativeId,
+                }),
+                threadId: childThreadId,
+                rootNodeId: childRootNodeId,
+                providerThreadId: null,
+                providerTurnId: null,
+                nativeItemRef: {
+                  driver: CURSOR_PROVIDER,
+                  nativeId: resultNativeId,
+                  strength: "weak",
+                },
+                role: "assistant",
+                text: task.result,
+                ordinal: ++subagent.nextChildOrdinal,
+                now,
+              });
+              yield* emitProviderEvent({
+                type: "message.updated",
+                driver: CURSOR_PROVIDER,
+                message: resultArtifacts.message,
+              });
+              yield* emitProviderEvent({
+                type: "turn_item.updated",
+                driver: CURSOR_PROVIDER,
+                turnItem: resultArtifacts.turnItem,
+              });
+            }
+            subagent.resultProjected = true;
+          }
+        });
+
+        const handleToolUpdate = Effect.fnUntraced(function* (
+          context: ActiveCursorTurn,
+          update: Extract<
+            InteractionUpdate,
+            {
+              readonly type: "tool-call-started" | "partial-tool-call" | "tool-call-completed";
+            }
+          >,
+        ) {
+          const completed = update.type === "tool-call-completed";
+          const toolCall = update.toolCall;
+          switch (toolCall.type) {
+            case "createPlan":
+              yield* emitPlanArtifacts({
+                context,
+                callId: update.callId,
+                markdown: toolCall.args.plan,
+                completed,
+                failed: completed && cursorToolFailed(toolCall),
+              });
+              return;
+            case "updateTodos":
+              yield* emitTodoArtifacts({
+                context,
+                callId: update.callId,
+                toolCall,
+                completed,
+                failed: completed && cursorToolFailed(toolCall),
+              });
+              return;
+            case "task":
+              if (update.type === "partial-tool-call") {
+                return;
+              }
+              yield* emitSubagent({
+                context,
+                callId: update.callId,
+                toolCall,
+                completed,
+              });
+              return;
+            default: {
+              const active = yield* ensureToolStarted(context, update.callId, toolCall);
+              active.toolCall = toolCall;
+              if (update.type !== "tool-call-started") {
+                yield* emitToolArtifacts({ active, completed });
+              }
+              if (completed) {
+                context.tools.delete(update.callId);
+              }
+            }
+          }
+        });
+
+        const shellOutputText = (event: Record<string, unknown>): string => {
+          const candidates = [
+            event.text,
+            event.output,
+            event.data,
+            event.stdout,
+            event.stderr,
+            event.chunk,
+          ];
+          return candidates.filter((value): value is string => typeof value === "string").join("");
+        };
+
+        const handleInteractionUpdate = Effect.fnUntraced(function* (
+          context: ActiveCursorTurn,
+          update: InteractionUpdate,
+        ) {
+          if (context.finalized) {
+            return;
+          }
+          switch (update.type) {
+            case "text-delta":
+              yield* completeReasoning(context);
+              yield* appendTextSegment({
+                context,
+                stream: context.assistant,
+                kind: "assistant",
+                text: update.text,
+              });
+              yield* emitAssistant(context, false);
+              return;
+            case "thinking-delta":
+              yield* completeAssistant(context);
+              yield* appendTextSegment({
+                context,
+                stream: context.reasoning,
+                kind: "reasoning",
+                text: update.text,
+              });
+              yield* emitReasoning(context, false);
+              return;
+            case "thinking-completed":
+              yield* completeReasoning(context);
+              return;
+            case "tool-call-started":
+            case "partial-tool-call":
+            case "tool-call-completed":
+              yield* completeAssistant(context);
+              yield* completeReasoning(context);
+              yield* handleToolUpdate(context, update);
+              return;
+            case "step-completed":
+            case "turn-ended":
+              yield* completeAssistant(context);
+              yield* completeReasoning(context);
+              return;
+            case "shell-output-delta": {
+              const shell = Array.from(context.tools.values())
+                .toReversed()
+                .find((candidate) => candidate.toolCall.type === "shell");
+              if (shell === undefined) {
+                return;
+              }
+              shell.streamedOutput += shellOutputText(update.event);
+              yield* emitToolArtifacts({ active: shell, completed: false });
+              return;
+            }
+            default:
+              return;
+          }
+        });
+
+        const providerTurnPayload = (input: {
+          readonly context: ActiveCursorTurn;
+          readonly status: OrchestrationV2ProviderTurn["status"];
+          readonly completedAt: DateTime.Utc | null;
+        }): OrchestrationV2ProviderTurn => ({
+          id: input.context.providerTurnId,
+          providerThreadId: input.context.input.providerThread.id,
+          nodeId: input.context.input.rootNodeId,
+          runAttemptId: input.context.input.attemptId,
+          nativeTurnRef: {
+            driver: CURSOR_PROVIDER,
+            nativeId: input.context.run.runId,
+            strength: "strong",
+          },
+          ordinal: input.context.input.providerTurnOrdinal,
+          status: input.status,
+          startedAt: input.context.startedAt,
+          completedAt: input.completedAt,
+        });
+
+        const finalizeTurn = Effect.fnUntraced(function* (input: {
+          readonly context: ActiveCursorTurn;
+          readonly status: Extract<
+            OrchestrationV2ProviderTurn["status"],
+            "completed" | "interrupted" | "failed" | "cancelled"
+          >;
+          readonly failure?: OrchestrationV2ProviderFailure;
+          readonly threadDisposition?: "reusable" | "broken";
+        }) {
+          if (input.context.finalized) {
+            return;
+          }
+          input.context.finalized = true;
+          const completedAt = yield* DateTime.now;
+          for (const tool of input.context.tools.values()) {
+            yield* emitToolArtifacts({ active: tool, completed: true });
+          }
+          input.context.tools.clear();
+          yield* completeReasoning(input.context);
+          yield* completeAssistant(input.context);
+          yield* emitProviderEvent({
+            type: "provider_turn.updated",
+            driver: CURSOR_PROVIDER,
+            providerTurn: providerTurnPayload({
+              context: input.context,
+              status: input.status,
+              completedAt,
+            }),
+          });
+          yield* emitProviderEvent({
+            type: "provider_thread.updated",
+            driver: CURSOR_PROVIDER,
+            providerThread: {
+              ...input.context.input.providerThread,
+              providerSessionId: session.id,
+              status: "active",
+              firstRunOrdinal:
+                input.context.input.providerThread.firstRunOrdinal ??
+                input.context.input.runOrdinal,
+              lastRunOrdinal: input.context.input.runOrdinal,
+              updatedAt: completedAt,
+            },
+          });
+          const threadDisposition = input.threadDisposition ?? "reusable";
+          yield* emitProviderEvent(
+            input.status === "failed"
+              ? {
+                  type: "turn.terminal",
+                  driver: CURSOR_PROVIDER,
+                  providerThreadId: input.context.input.providerThread.id,
+                  providerTurnId: input.context.providerTurnId,
+                  runOrdinal: input.context.input.runOrdinal,
+                  failureItemOrdinal: yield* resolveItemOrdinal(
+                    input.context,
+                    `terminal-failure:${input.context.providerTurnId}`,
+                  ),
+                  status: input.status,
+                  failure: input.failure ?? makeProviderFailure({ class: "provider_error" }),
+                  threadDisposition,
+                }
+              : {
+                  type: "turn.terminal",
+                  driver: CURSOR_PROVIDER,
+                  providerThreadId: input.context.input.providerThread.id,
+                  providerTurnId: input.context.providerTurnId,
+                  runOrdinal: input.context.input.runOrdinal,
+                  status: input.status,
+                  failure: null,
+                  threadDisposition,
+                },
+          );
+          yield* Ref.update(activeTurn, (current) =>
+            current?.providerTurnId === input.context.providerTurnId ? null : current,
+          );
+          yield* Deferred.succeed(input.context.completed, undefined);
+        });
+
+        const terminalStatus = (
+          context: ActiveCursorTurn,
+          result: RunResult,
+        ): Extract<
+          OrchestrationV2ProviderTurn["status"],
+          "completed" | "interrupted" | "failed" | "cancelled"
+        > => {
+          if (context.interrupted) {
+            return "interrupted";
+          }
+          switch (result.status) {
+            case "finished":
+              return "completed";
+            case "cancelled":
+              return "cancelled";
+            case "error":
+              return "failed";
+          }
+        };
+
+        const openAgent = Effect.fnUntraced(function* (openInput: {
+          readonly operation: "create" | "resume";
+          readonly threadId: ThreadId;
+          readonly modelSelection: ModelSelection;
+          readonly runtimePolicy: ProviderAdapterV2RuntimePolicy;
+          readonly agentId?: string;
+        }) {
+          const existing = yield* Ref.get(liveAgent);
+          if (
+            existing !== null &&
+            openInput.operation === "resume" &&
+            existing.nativeThreadId === openInput.agentId
+          ) {
+            return existing;
+          }
+          if (existing !== null) {
+            yield* existing.session.close.pipe(Effect.ignore);
+            yield* Ref.set(liveAgent, null);
+          }
+          const sdkSession = yield* runner.open({
+            operation: openInput.operation,
+            ...(openInput.agentId === undefined ? {} : { agentId: openInput.agentId }),
+            options: makeCursorAgentOptions({
+              ...(apiKey === undefined ? {} : { apiKey }),
+              modelSelection: openInput.modelSelection,
+              runtimePolicy: openInput.runtimePolicy,
+              threadId: openInput.threadId,
+            }),
+            threadId: openInput.threadId,
+            providerSessionId: input.providerSessionId,
+          });
+          const next = {
+            nativeThreadId: sdkSession.agentId,
+            session: sdkSession,
+          } satisfies CursorLiveAgent;
+          yield* Ref.set(liveAgent, next);
+          return next;
+        });
+
+        const resolveUserMessage = Effect.fnUntraced(function* (
+          turnInput: ProviderAdapterV2TurnInput,
+        ) {
+          const text = t3OrchestrationPromptForFirstRun({
+            prompt: providerMessageTextWithAttachmentPaths({
+              text: turnInput.message.text,
+              attachments: turnInput.message.attachments,
+              attachmentsDir: serverConfig.attachmentsDir,
+            }),
+            runOrdinal: turnInput.runOrdinal,
+            hasT3Mcp: cursorMcpServers(turnInput.threadId) !== undefined,
+          });
+          const images = yield* Effect.forEach(
+            turnInput.message.attachments.filter(isProviderNativeImageAttachment),
+            (attachment: ChatAttachment) =>
+              Effect.gen(function* () {
+                const path = resolveAttachmentPath({
+                  attachmentsDir: serverConfig.attachmentsDir,
+                  attachment,
+                });
+                if (path === null) {
+                  return yield* new ProviderAdapterProtocolError({
+                    driver: CURSOR_PROVIDER,
+                    detail: `Invalid attachment id '${attachment.id}'.`,
+                  });
+                }
+                const bytes = yield* fileSystem.readFile(path).pipe(
+                  Effect.mapError(
+                    (cause) =>
+                      new ProviderAdapterProtocolError({
+                        driver: CURSOR_PROVIDER,
+                        detail: `Failed to read attachment '${attachment.id}'.`,
+                        payload: cause,
+                      }),
+                  ),
+                );
+                return {
+                  data: Buffer.from(bytes).toString("base64"),
+                  mimeType: attachment.mimeType,
+                };
+              }),
+            { concurrency: 1 },
+          );
+          if (text.length === 0 && images.length === 0) {
+            return yield* new ProviderAdapterProtocolError({
+              driver: CURSOR_PROVIDER,
+              detail: "Cursor turn requires non-empty text or attachments.",
+            });
+          }
+          return images.length === 0
+            ? text
+            : ({
+                text,
+                images,
+              } satisfies SDKUserMessage);
+        });
+
+        const startTurn = Effect.fn("CursorAdapterV2.startTurn")(
+          function* (turnInput: ProviderAdapterV2TurnInput) {
+            const current = yield* Ref.get(activeTurn);
+            if (current !== null) {
+              return yield* new ProviderAdapterProtocolError({
+                driver: CURSOR_PROVIDER,
+                detail: `Cursor provider turn ${current.providerTurnId} is still active.`,
+              });
+            }
+            const agentId = nativeThreadId(turnInput.providerThread);
+            const agent = yield* openAgent({
+              operation: "resume",
+              agentId,
+              threadId: turnInput.threadId,
+              modelSelection: turnInput.modelSelection,
+              runtimePolicy: turnInput.runtimePolicy,
+            });
+            const message = yield* resolveUserMessage(turnInput);
+            const mcpServers = cursorMcpServers(turnInput.threadId);
+            const pendingUpdates: Array<InteractionUpdate> = [];
+            let context: ActiveCursorTurn | null = null;
+            const sdkRun = yield* agent.session.send({
+              message,
+              options: {
+                model: cursorSdkModelSelection(turnInput.modelSelection),
+                mode: turnInput.runtimePolicy.interactionMode === "plan" ? "plan" : "agent",
+                ...(mcpServers === undefined ? {} : { mcpServers }),
+              },
+              onDelta: (update) => {
+                if (context === null) {
+                  return Effect.sync(() => {
+                    pendingUpdates.push(update);
+                  });
+                }
+                return handleInteractionUpdate(context, update);
+              },
+            });
+            const startedAt = yield* DateTime.now;
+            const completed = yield* Deferred.make<void, never>();
+            const providerTurnId = idAllocator.derive.providerTurn({
+              driver: CURSOR_PROVIDER,
+              nativeTurnId: sdkRun.runId,
+            });
+            context = {
+              input: turnInput,
+              run: sdkRun,
+              providerTurnId,
+              startedAt,
+              completed,
+              tools: new Map(),
+              subagents: new Map(),
+              assistant: {
+                current: null,
+                nextSegment: 0,
+              },
+              reasoning: {
+                current: null,
+                nextSegment: 0,
+              },
+              interrupted: false,
+              finalized: false,
+            };
+            yield* Ref.set(activeTurn, context);
+            yield* emitProviderEvent({
+              type: "provider_turn.updated",
+              driver: CURSOR_PROVIDER,
+              providerTurn: providerTurnPayload({
+                context,
+                status: "running",
+                completedAt: null,
+              }),
+            });
+            yield* emitProviderEvent({
+              type: "provider_thread.updated",
+              driver: CURSOR_PROVIDER,
+              providerThread: {
+                ...turnInput.providerThread,
+                providerSessionId: session.id,
+                status: "active",
+                updatedAt: startedAt,
+              },
+            });
+            for (const update of pendingUpdates) {
+              yield* handleInteractionUpdate(context, update);
+            }
+
+            yield* sdkRun.wait.pipe(
+              Effect.flatMap((result) =>
+                Effect.gen(function* () {
+                  if (
+                    context !== null &&
+                    context.assistant.nextSegment === 0 &&
+                    result.result !== undefined &&
+                    result.result.length > 0
+                  ) {
+                    yield* appendTextSegment({
+                      context,
+                      stream: context.assistant,
+                      kind: "assistant",
+                      text: result.result,
+                    });
+                  }
+                  if (context !== null) {
+                    const status = terminalStatus(context, result);
+                    yield* finalizeTurn({
+                      context,
+                      status,
+                      ...(status === "failed"
+                        ? {
+                            failure: makeProviderFailure({
+                              cause: (result as { readonly error?: unknown }).error,
+                              class: "provider_error",
+                            }),
+                          }
+                        : {}),
+                    });
+                  }
+                }),
+              ),
+              Effect.catch((cause) =>
+                Effect.gen(function* () {
+                  if (context !== null) {
+                    yield* finalizeTurn({
+                      context,
+                      status: context.interrupted ? "interrupted" : "failed",
+                      ...(context.interrupted
+                        ? {}
+                        : {
+                            failure: makeProviderFailure({ cause, class: "transport_error" }),
+                          }),
+                    });
+                  }
+                  yield* Effect.logWarning("orchestration-v2.cursor-run-failed", {
+                    providerSessionId: input.providerSessionId,
+                    providerThreadId: turnInput.providerThread.id,
+                    providerTurnId,
+                    cause,
+                  });
+                }),
+              ),
+              Effect.forkIn(sessionScope),
+            );
+          },
+          (effect, turnInput) =>
+            effect.pipe(
+              Effect.mapError(
+                (cause) =>
+                  new ProviderAdapterTurnStartError({
+                    driver: CURSOR_PROVIDER,
+                    threadId: turnInput.threadId,
+                    providerThreadId: turnInput.providerThread.id,
+                    runId: turnInput.runId,
+                    cause,
+                  }),
+              ),
+            ),
+        );
+
+        const closeSession = Effect.fnUntraced(function* () {
+          const existing = yield* Ref.get(liveAgent);
+          if (existing !== null) {
+            yield* existing.session.close.pipe(Effect.ignore);
+            yield* Ref.set(liveAgent, null);
+          }
+          yield* runner.assertComplete.pipe(
+            Effect.catchCause((cause) =>
+              Effect.logWarning("orchestration-v2.cursor-runner-incomplete", {
+                providerSessionId: input.providerSessionId,
+                cause,
+              }),
+            ),
+          );
+        });
+        yield* Effect.addFinalizer(() => closeSession());
+
+        const runtime: ProviderAdapterV2SessionRuntime = {
+          instanceId: adapterOptions.instanceId,
+          driver: CURSOR_PROVIDER,
+          providerSessionId: input.providerSessionId,
+          providerSession: session,
+          events: Stream.fromEffectRepeat(Queue.take(events)),
+          ensureThread: Effect.fn("CursorAdapterV2.ensureThread")(
+            function* (threadInput: ProviderAdapterV2EnsureThreadInput) {
+              const opened = yield* openAgent({
+                operation: "create",
+                threadId: threadInput.threadId,
+                modelSelection: threadInput.modelSelection,
+                runtimePolicy: threadInput.runtimePolicy,
+              });
+              const now = yield* DateTime.now;
+              return makeProviderThread({
+                idAllocator,
+                providerInstanceId: adapterOptions.instanceId,
+                appThreadId: threadInput.threadId,
+                providerSessionId: input.providerSessionId,
+                nativeThreadId: opened.nativeThreadId,
+                now,
+              });
+            },
+            (effect, threadInput) =>
+              effect.pipe(
+                Effect.mapError(
+                  (cause) =>
+                    new ProviderAdapterEnsureThreadError({
+                      driver: CURSOR_PROVIDER,
+                      threadId: threadInput.threadId,
+                      cause,
+                    }),
+                ),
+              ),
+          ),
+          resumeThread: Effect.fn("CursorAdapterV2.resumeThread")(
+            function* (threadInput: { readonly providerThread: OrchestrationV2ProviderThread }) {
+              const agentId = nativeThreadId(threadInput.providerThread);
+              yield* openAgent({
+                operation: "resume",
+                agentId,
+                threadId: threadInput.providerThread.appThreadId ?? input.threadId,
+                modelSelection: input.modelSelection,
+                runtimePolicy: input.runtimePolicy,
+              });
+              const now = yield* DateTime.now;
+              return {
+                ...threadInput.providerThread,
+                providerSessionId: input.providerSessionId,
+                status: "idle" as const,
+                updatedAt: now,
+              };
+            },
+            (effect, threadInput) =>
+              effect.pipe(
+                Effect.mapError(
+                  (cause) =>
+                    new ProviderAdapterResumeThreadError({
+                      driver: CURSOR_PROVIDER,
+                      providerSessionId: input.providerSessionId,
+                      providerThreadId: threadInput.providerThread.id,
+                      cause,
+                    }),
+                ),
+              ),
+          ),
+          startTurn,
+          steerTurn: (turnInput) =>
+            Effect.fail(
+              new ProviderAdapterSteerRunUnsupportedError({
+                driver: CURSOR_PROVIDER,
+                providerThreadId: turnInput.providerThread.id,
+              }),
+            ),
+          interruptTurn: Effect.fn("CursorAdapterV2.interruptTurn")(
+            function* (turnInput: ProviderAdapterV2InterruptInput) {
+              const context = yield* Ref.get(activeTurn);
+              if (context?.providerTurnId !== turnInput.providerTurnId) {
+                return yield* new ProviderAdapterProtocolError({
+                  driver: CURSOR_PROVIDER,
+                  detail: `Cursor provider turn ${turnInput.providerTurnId} is not active.`,
+                });
+              }
+              context.interrupted = true;
+              yield* context.run.cancel;
+              const stopped = yield* Deferred.await(context.completed).pipe(
+                Effect.timeoutOption("10 seconds"),
+              );
+              if (Option.isSome(stopped)) {
+                return;
+              }
+              yield* Effect.logWarning("orchestration-v2.cursor-interrupt-timeout", {
+                providerSessionId: input.providerSessionId,
+                providerThreadId: turnInput.providerThread.id,
+                providerTurnId: turnInput.providerTurnId,
+              });
+              yield* finalizeTurn({ context, status: "interrupted" });
+            },
+            (effect, turnInput) =>
+              effect.pipe(
+                Effect.mapError(
+                  (cause) =>
+                    new ProviderAdapterInterruptError({
+                      driver: CURSOR_PROVIDER,
+                      providerThreadId: turnInput.providerThread.id,
+                      providerTurnId: turnInput.providerTurnId,
+                      cause,
+                    }),
+                ),
+              ),
+          ),
+          respondToRuntimeRequest: (requestInput) =>
+            Effect.fail(
+              new ProviderAdapterRuntimeRequestResponseError({
+                driver: CURSOR_PROVIDER,
+                requestId: requestInput.requestId,
+                cause: new ProviderAdapterProtocolError({
+                  driver: CURSOR_PROVIDER,
+                  detail: "Cursor Agent SDK does not expose interactive approval requests.",
+                }),
+              }),
+            ),
+          readThreadSnapshot: Effect.fn("CursorAdapterV2.readThreadSnapshot")(
+            function* (snapshotInput) {
+              const requestedAgentId = nativeThreadId(snapshotInput.providerThread);
+              const agent = yield* openAgent({
+                operation: "resume",
+                agentId: requestedAgentId,
+                threadId: snapshotInput.providerThread.appThreadId ?? input.threadId,
+                modelSelection: input.modelSelection,
+                runtimePolicy: input.runtimePolicy,
+              });
+              const messages = yield* agent.session.listMessages;
+              const now = yield* DateTime.now;
+              const threadId = snapshotInput.providerThread.appThreadId ?? input.threadId;
+              const projectedMessages: Array<OrchestrationV2ConversationMessage> = messages.flatMap(
+                (message) => {
+                  const text = textFromAgentMessage(message);
+                  if (text.length === 0) {
+                    return [];
+                  }
+                  return [
+                    {
+                      createdBy: message.type === "user" ? "user" : "agent",
+                      creationSource: "provider",
+                      id: idAllocator.derive.messageFromProviderItem({
+                        driver: CURSOR_PROVIDER,
+                        nativeItemId: message.uuid,
+                      }),
+                      threadId,
+                      runId: null,
+                      nodeId: null,
+                      role: message.type,
+                      text,
+                      attachments: [],
+                      streaming: false,
+                      createdAt: now,
+                      updatedAt: now,
+                    },
+                  ];
+                },
+              );
+              return {
+                providerThread: {
+                  ...snapshotInput.providerThread,
+                  providerSessionId: input.providerSessionId,
+                  status: "idle" as const,
+                  updatedAt: now,
+                },
+                providerTurns: [],
+                messages: projectedMessages,
+                runtimeRequests: [],
+                providerPayload: {
+                  agentId: requestedAgentId,
+                  messages,
+                },
+              };
+            },
+            (effect, snapshotInput) =>
+              effect.pipe(
+                Effect.mapError(
+                  (cause) =>
+                    new ProviderAdapterReadThreadSnapshotError({
+                      driver: CURSOR_PROVIDER,
+                      providerThreadId: snapshotInput.providerThread.id,
+                      cause,
+                    }),
+                ),
+              ),
+          ),
+          rollbackThread: (rollbackInput) =>
+            Effect.fail(
+              new ProviderAdapterRollbackThreadError({
+                driver: CURSOR_PROVIDER,
+                providerThreadId: rollbackInput.providerThread.id,
+                checkpointId: rollbackInput.target.checkpointId,
+                cause: "Cursor Agent SDK does not expose conversation rollback.",
+              }),
+            ),
+          forkThread: (forkInput) =>
+            Effect.fail(
+              new ProviderAdapterForkThreadError({
+                driver: CURSOR_PROVIDER,
+                providerThreadId: forkInput.sourceProviderThread.id,
+                cause: "Cursor Agent SDK does not expose native agent forks.",
+              }),
+            ),
+        };
+        return runtime;
+      },
+      (effect, input) =>
+        effect.pipe(
+          Effect.mapError(
+            (cause) =>
+              new ProviderAdapterOpenSessionError({
+                driver: CURSOR_PROVIDER,
+                providerSessionId: input.providerSessionId,
+                cause,
+              }),
+          ),
+        ),
+    ),
+  });
+}
+
+export type CursorAdapterV2DriverEnv =
+  | CursorAgentSdkRunner
+  | FileSystem.FileSystem
+  | IdAllocatorV2
+  | ServerConfig;
+
+export const CursorAdapterV2Driver: ProviderAdapterDriver<
+  CursorSettings,
+  CursorAdapterV2DriverEnv
+> = {
+  driverKind: CURSOR_DRIVER_KIND,
+  configSchema: CursorSettings,
+  defaultConfig: (): CursorSettings => DEFAULT_CURSOR_SETTINGS,
+  create: Effect.fn("CursorAdapterV2Driver.create")(
+    function* (input: ProviderAdapterDriverCreateInput<CursorSettings>) {
+      const hostEnvironment = yield* HostProcessEnvironment;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const runner = yield* CursorAgentSdkRunner;
+      const serverConfig = yield* ServerConfig;
+      return makeCursorAdapterV2({
+        instanceId: input.instanceId,
+        settings: {
+          ...input.config,
+          enabled: input.enabled,
+        },
+        environment: mergeProviderInstanceEnvironment(input.environment, hostEnvironment),
+        fileSystem,
+        idAllocator,
+        runner,
+        serverConfig,
+      });
+    },
+    (effect, input) =>
+      effect.pipe(
+        Effect.mapError(
+          (cause) =>
+            new ProviderAdapterDriverCreateError({
+              driver: CURSOR_DRIVER_KIND,
+              instanceId: input.instanceId,
+              detail: "Failed to create Cursor Agent SDK adapter.",
+              cause,
+            }),
+        ),
+      ),
+  ),
+};
+
+export const layer: Layer.Layer<
+  ProviderAdapterV2,
+  never,
+  CursorAgentSdkRunner | FileSystem.FileSystem | IdAllocatorV2 | ServerConfig
+> = Layer.effect(
+  ProviderAdapterV2,
+  Effect.gen(function* () {
+    const hostEnvironment = yield* HostProcessEnvironment;
+    const fileSystem = yield* FileSystem.FileSystem;
+    const idAllocator = yield* IdAllocatorV2;
+    const runner = yield* CursorAgentSdkRunner;
+    const serverConfig = yield* ServerConfig;
+    return makeCursorAdapterV2({
+      instanceId: CURSOR_DEFAULT_INSTANCE_ID,
+      settings: DEFAULT_CURSOR_SETTINGS,
+      environment: hostEnvironment,
+      fileSystem,
+      idAllocator,
+      runner,
+      serverConfig,
+    });
+  }),
+);
diff --git a/apps/server/src/orchestration-v2/Adapters/CursorAgentSdk.test.ts b/apps/server/src/orchestration-v2/Adapters/CursorAgentSdk.test.ts
new file mode 100644
index 000000000000..84299c8dbc93
--- /dev/null
+++ b/apps/server/src/orchestration-v2/Adapters/CursorAgentSdk.test.ts
@@ -0,0 +1,215 @@
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import { assert, describe, it } from "@effect/vitest";
+import { ProviderSessionId, ThreadId } from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { vi } from "vite-plus/test";
+
+import { ProviderEventLoggers } from "../../provider/Layers/ProviderEventLoggers.ts";
+import {
+  CursorAgentSdkRunner,
+  CursorAgentSdkRunnerError,
+  cursorAgentSdkRunnerLiveLayer,
+} from "./CursorAgentSdk.ts";
+
+const cursorSdkMock = vi.hoisted(() => {
+  const closeExecutionOrder: Array<string> = [];
+  let agentCloseFailure: unknown;
+  const runWait = vi.fn(async () => ({
+    id: "run-cursor-agent-sdk-test",
+    requestId: "request-cursor-agent-sdk-test",
+    status: "finished",
+    result: "ok",
+    model: { id: "default" },
+    durationMs: 1,
+  }));
+  const runCancel = vi.fn(async () => {});
+  const agentClose = vi.fn(() => {
+    closeExecutionOrder.push("sdk:agent.close");
+    if (agentCloseFailure !== undefined) {
+      throw agentCloseFailure;
+    }
+  });
+  const send = vi.fn(
+    async (
+      _message: unknown,
+      options: { readonly onDelta?: (input: { readonly update: unknown }) => Promise<void> },
+    ) => {
+      await options.onDelta?.({
+        update: {
+          type: "assistant-message-chunk",
+          text: "hello",
+        },
+      });
+      return {
+        id: "run-cursor-agent-sdk-test",
+        agentId: "agent-cursor-agent-sdk-test",
+        wait: runWait,
+        cancel: runCancel,
+      };
+    },
+  );
+  const create = vi.fn(async () => ({
+    agentId: "agent-cursor-agent-sdk-test",
+    send,
+    close: agentClose,
+  }));
+
+  return {
+    agentClose,
+    closeExecutionOrder,
+    create,
+    runCancel,
+    runWait,
+    send,
+    setAgentCloseFailure: (failure: unknown) => {
+      agentCloseFailure = failure;
+    },
+  };
+});
+
+vi.mock("@cursor/sdk", () => ({
+  Agent: {
+    create: cursorSdkMock.create,
+    resume: vi.fn(),
+    messages: {
+      list: vi.fn(async () => []),
+    },
+  },
+}));
+
+const testLayer = cursorAgentSdkRunnerLiveLayer.pipe(
+  Layer.provide(
+    Layer.succeed(ProviderEventLoggers, {
+      native: {
+        filePath: "cursor-agent-sdk-test.log",
+        write: (event: unknown) =>
+          Effect.sync(() => {
+            if (
+              typeof event === "object" &&
+              event !== null &&
+              Reflect.get(Reflect.get(event, "event"), "payload")?.type === "agent.close"
+            ) {
+              cursorSdkMock.closeExecutionOrder.push("protocol:agent.close");
+            }
+          }),
+        close: () => Effect.void,
+      },
+      canonical: undefined,
+    }),
+  ),
+  Layer.provide(NodeServices.layer),
+);
+
+describe("CursorAgentSdkRunner", () => {
+  it.effect("logs agent.close before invoking the Cursor SDK", () =>
+    Effect.gen(function* () {
+      cursorSdkMock.agentClose.mockClear();
+      cursorSdkMock.closeExecutionOrder.length = 0;
+      cursorSdkMock.setAgentCloseFailure(undefined);
+
+      const runner = yield* CursorAgentSdkRunner;
+      const session = yield* runner.open({
+        operation: "create",
+        options: {
+          model: { id: "default" },
+          mode: "agent",
+          local: {
+            cwd: process.cwd(),
+          },
+        },
+        threadId: ThreadId.make("thread-cursor-agent-sdk-close-order-test"),
+        providerSessionId: ProviderSessionId.make(
+          "provider-session-cursor-agent-sdk-close-order-test",
+        ),
+      });
+
+      cursorSdkMock.closeExecutionOrder.length = 0;
+      yield* session.close;
+
+      assert.deepStrictEqual(cursorSdkMock.closeExecutionOrder, [
+        "protocol:agent.close",
+        "sdk:agent.close",
+      ]);
+      assert.equal(cursorSdkMock.agentClose.mock.calls.length, 1);
+    }).pipe(Effect.provide(testLayer)),
+  );
+
+  it.effect("logs agent.close even when the Cursor SDK close fails", () =>
+    Effect.gen(function* () {
+      cursorSdkMock.agentClose.mockClear();
+      cursorSdkMock.closeExecutionOrder.length = 0;
+      const closeFailure = new Error("agent close failed");
+      cursorSdkMock.setAgentCloseFailure(closeFailure);
+
+      const runner = yield* CursorAgentSdkRunner;
+      const session = yield* runner.open({
+        operation: "create",
+        options: {
+          model: { id: "default" },
+          mode: "agent",
+          local: {
+            cwd: process.cwd(),
+          },
+        },
+        threadId: ThreadId.make("thread-cursor-agent-sdk-close-failure-test"),
+        providerSessionId: ProviderSessionId.make(
+          "provider-session-cursor-agent-sdk-close-failure-test",
+        ),
+      });
+
+      cursorSdkMock.closeExecutionOrder.length = 0;
+      const error = yield* Effect.flip(session.close);
+
+      assert.instanceOf(error, CursorAgentSdkRunnerError);
+      assert.equal(error.method, "agent.close");
+      assert.strictEqual(error.cause, closeFailure);
+      assert.deepStrictEqual(cursorSdkMock.closeExecutionOrder, [
+        "protocol:agent.close",
+        "sdk:agent.close",
+      ]);
+      assert.equal(cursorSdkMock.agentClose.mock.calls.length, 1);
+      cursorSdkMock.setAgentCloseFailure(undefined);
+    }).pipe(Effect.provide(testLayer)),
+  );
+
+  it.effect("surfaces interaction callback failures through run.wait", () =>
+    Effect.gen(function* () {
+      cursorSdkMock.create.mockClear();
+      cursorSdkMock.runWait.mockClear();
+      cursorSdkMock.send.mockClear();
+
+      const runner = yield* CursorAgentSdkRunner;
+      const session = yield* runner.open({
+        operation: "create",
+        options: {
+          model: { id: "default" },
+          mode: "agent",
+          local: {
+            cwd: process.cwd(),
+            autoReview: false,
+            sandboxOptions: { enabled: false },
+            enableAgentRetries: true,
+          },
+        },
+        threadId: ThreadId.make("thread-cursor-agent-sdk-test"),
+        providerSessionId: ProviderSessionId.make("provider-session-cursor-agent-sdk-test"),
+      });
+
+      const callbackFailure = new Error("delta callback failed");
+      const run = yield* session.send({
+        message: "hello",
+        onDelta: () => Effect.fail(callbackFailure),
+      });
+
+      const error = yield* Effect.flip(run.wait);
+
+      assert.instanceOf(error, CursorAgentSdkRunnerError);
+      assert.equal(error.method, "run.wait");
+      assert.strictEqual(error.cause, callbackFailure);
+      assert.equal(cursorSdkMock.create.mock.calls.length, 1);
+      assert.equal(cursorSdkMock.send.mock.calls.length, 1);
+      assert.equal(cursorSdkMock.runWait.mock.calls.length, 1);
+    }).pipe(Effect.provide(testLayer)),
+  );
+});
diff --git a/apps/server/src/orchestration-v2/Adapters/CursorAgentSdk.ts b/apps/server/src/orchestration-v2/Adapters/CursorAgentSdk.ts
new file mode 100644
index 000000000000..d1806820b0c4
--- /dev/null
+++ b/apps/server/src/orchestration-v2/Adapters/CursorAgentSdk.ts
@@ -0,0 +1,525 @@
+import {
+  Agent,
+  type AgentMessage,
+  type AgentOptions,
+  type InteractionUpdate,
+  type RunResult,
+  type SDKUserMessage,
+  type SendOptions,
+} from "@cursor/sdk";
+import {
+  type OrchestrationV2ProviderSession,
+  ProviderDriverKind,
+  type ThreadId,
+} from "@t3tools/contracts";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Schema from "effect/Schema";
+
+import type { EventNdjsonLogger } from "../../provider/Layers/EventNdjsonLogger.ts";
+import { ProviderEventLoggers } from "../../provider/Layers/ProviderEventLoggers.ts";
+
+export const CURSOR_AGENT_SDK_PROTOCOL = "cursor-agent-sdk.local" as const;
+export const CURSOR_PROVIDER = ProviderDriverKind.make("cursor");
+
+export class CursorAgentSdkRunnerError extends Schema.TaggedErrorClass<CursorAgentSdkRunnerError>()(
+  "CursorAgentSdkRunnerError",
+  {
+    method: Schema.String,
+    cause: Schema.Defect(),
+  },
+) {
+  override get message(): string {
+    return `Cursor Agent SDK ${this.method} failed.`;
+  }
+}
+
+const isCursorAgentSdkRunnerError = Schema.is(CursorAgentSdkRunnerError);
+
+export interface CursorAgentSdkOpenInput {
+  readonly operation: "create" | "resume";
+  readonly agentId?: string;
+  readonly options: AgentOptions;
+  readonly threadId: ThreadId;
+  readonly providerSessionId: OrchestrationV2ProviderSession["id"];
+}
+
+export interface CursorAgentSdkSendInput<Error> {
+  readonly message: string | SDKUserMessage;
+  readonly options?: Omit<SendOptions, "onDelta">;
+  readonly onDelta?: (update: InteractionUpdate) => Effect.Effect<void, Error>;
+}
+
+export interface CursorAgentSdkRun {
+  readonly runId: string;
+  readonly agentId: string;
+  readonly wait: Effect.Effect<RunResult, CursorAgentSdkRunnerError>;
+  readonly cancel: Effect.Effect<void, CursorAgentSdkRunnerError>;
+}
+
+export interface CursorAgentSdkSession {
+  readonly agentId: string;
+  readonly send: <Error>(
+    input: CursorAgentSdkSendInput<Error>,
+  ) => Effect.Effect<CursorAgentSdkRun, CursorAgentSdkRunnerError>;
+  readonly listMessages: Effect.Effect<ReadonlyArray<AgentMessage>, CursorAgentSdkRunnerError>;
+  readonly close: Effect.Effect<void, CursorAgentSdkRunnerError>;
+}
+
+export interface CursorAgentSdkRunnerShape {
+  readonly open: (
+    input: CursorAgentSdkOpenInput,
+  ) => Effect.Effect<CursorAgentSdkSession, CursorAgentSdkRunnerError>;
+  readonly assertComplete: Effect.Effect<void, CursorAgentSdkRunnerError>;
+}
+
+export class CursorAgentSdkRunner extends Context.Service<
+  CursorAgentSdkRunner,
+  CursorAgentSdkRunnerShape
+>()("t3/orchestration-v2/Adapters/CursorAgentSdk/CursorAgentSdkRunner") {}
+
+export interface CursorAgentSdkLoggedAgentOptions {
+  readonly model?: AgentOptions["model"];
+  readonly hasName?: boolean;
+  readonly mode?: AgentOptions["mode"];
+  readonly local?: {
+    readonly hasCwd?: boolean;
+    readonly autoReview?: boolean;
+    readonly settingSources?: AgentOptions["local"] extends infer Local
+      ? Local extends { readonly settingSources?: infer Sources }
+        ? Sources
+        : never
+      : never;
+    readonly sandboxEnabled?: boolean;
+    readonly enableAgentRetries?: boolean;
+    readonly hasCustomTools?: boolean;
+  };
+  readonly agents?: ReadonlyArray<string>;
+}
+
+export interface CursorAgentSdkLoggedSendOptions {
+  readonly model?: SendOptions["model"];
+  readonly mode?: SendOptions["mode"];
+  readonly local?: {
+    readonly force?: boolean;
+    readonly hasCustomTools?: boolean;
+  };
+  readonly idempotencyKey?: string;
+}
+
+export type CursorAgentSdkProtocolLogEvent =
+  | {
+      readonly direction: "outgoing";
+      readonly stage: "decoded";
+      readonly payload: {
+        readonly type: "agent.open";
+        readonly operation: CursorAgentSdkOpenInput["operation"];
+        readonly agentId?: string;
+        readonly options: CursorAgentSdkLoggedAgentOptions;
+      };
+    }
+  | {
+      readonly direction: "incoming";
+      readonly stage: "decoded";
+      readonly payload: {
+        readonly type: "agent.opened";
+        readonly agentId: string;
+      };
+    }
+  | {
+      readonly direction: "outgoing";
+      readonly stage: "decoded";
+      readonly payload: {
+        readonly type: "run.start";
+        readonly message: string | SDKUserMessage;
+        readonly options: CursorAgentSdkLoggedSendOptions;
+      };
+    }
+  | {
+      readonly direction: "incoming";
+      readonly stage: "decoded";
+      readonly payload: {
+        readonly type: "run.started";
+        readonly runId: string;
+        readonly agentId: string;
+      };
+    }
+  | {
+      readonly direction: "incoming";
+      readonly stage: "decoded";
+      readonly payload: {
+        readonly type: "interaction.update";
+        readonly runId: string;
+        readonly update: InteractionUpdate;
+      };
+    }
+  | {
+      readonly direction: "incoming";
+      readonly stage: "decoded";
+      readonly payload: {
+        readonly type: "run.completed";
+        readonly result: RunResult;
+      };
+    }
+  | {
+      readonly direction: "outgoing";
+      readonly stage: "decoded";
+      readonly payload: {
+        readonly type: "run.cancel";
+        readonly runId: string;
+      };
+    }
+  | {
+      readonly direction: "outgoing";
+      readonly stage: "decoded";
+      readonly payload: {
+        readonly type: "agent.messages.list";
+        readonly agentId: string;
+      };
+    }
+  | {
+      readonly direction: "incoming";
+      readonly stage: "decoded";
+      readonly payload: {
+        readonly type: "agent.messages";
+        readonly agentId: string;
+        readonly messages: ReadonlyArray<AgentMessage>;
+      };
+    }
+  | {
+      readonly direction: "outgoing";
+      readonly stage: "decoded";
+      readonly payload: {
+        readonly type: "agent.close";
+        readonly agentId: string;
+      };
+    };
+
+export type CursorAgentSdkProtocolLogger = (
+  event: CursorAgentSdkProtocolLogEvent,
+) => Effect.Effect<void>;
+
+function runnerError(cause: unknown, method: string): CursorAgentSdkRunnerError {
+  return isCursorAgentSdkRunnerError(cause)
+    ? cause
+    : new CursorAgentSdkRunnerError({ method, cause });
+}
+
+export function isCursorCancellationError(cause: unknown): boolean {
+  let current = cause;
+  const seen = new Set<object>();
+
+  while (typeof current === "object" && current !== null && !seen.has(current)) {
+    if (Reflect.get(current, "name") === "AbortError") {
+      return true;
+    }
+    seen.add(current);
+    current = Reflect.get(current, "cause");
+  }
+
+  return false;
+}
+
+export function loggedCursorAgentOptions(options: AgentOptions): CursorAgentSdkLoggedAgentOptions {
+  return {
+    ...(options.model === undefined ? {} : { model: options.model }),
+    ...(options.name === undefined ? {} : { hasName: true }),
+    ...(options.mode === undefined ? {} : { mode: options.mode }),
+    ...(options.local === undefined
+      ? {}
+      : {
+          local: {
+            ...(options.local.cwd === undefined ? {} : { hasCwd: true }),
+            ...(options.local.autoReview === undefined
+              ? {}
+              : { autoReview: options.local.autoReview }),
+            ...(options.local.settingSources === undefined
+              ? {}
+              : { settingSources: options.local.settingSources }),
+            ...(options.local.sandboxOptions === undefined
+              ? {}
+              : { sandboxEnabled: options.local.sandboxOptions.enabled }),
+            ...(options.local.enableAgentRetries === undefined
+              ? {}
+              : { enableAgentRetries: options.local.enableAgentRetries }),
+            ...(options.local.customTools === undefined ? {} : { hasCustomTools: true }),
+          },
+        }),
+    ...(options.agents === undefined ? {} : { agents: Object.keys(options.agents).toSorted() }),
+  };
+}
+
+export function loggedCursorSendOptions(
+  options: Omit<SendOptions, "onDelta"> | undefined,
+): CursorAgentSdkLoggedSendOptions {
+  if (options === undefined) {
+    return {};
+  }
+  return {
+    ...(options.model === undefined ? {} : { model: options.model }),
+    ...(options.mode === undefined ? {} : { mode: options.mode }),
+    ...(options.local === undefined
+      ? {}
+      : {
+          local: {
+            ...(options.local.force === undefined ? {} : { force: options.local.force }),
+            ...(options.local.customTools === undefined ? {} : { hasCustomTools: true }),
+          },
+        }),
+    ...(options.idempotencyKey === undefined ? {} : { idempotencyKey: options.idempotencyKey }),
+  };
+}
+
+export function makeCursorAgentSdkProtocolLogger(input: {
+  readonly nativeEventLogger: EventNdjsonLogger | undefined;
+  readonly threadId: ThreadId;
+  readonly providerSessionId: OrchestrationV2ProviderSession["id"];
+}): CursorAgentSdkProtocolLogger | undefined {
+  if (input.nativeEventLogger === undefined) {
+    return undefined;
+  }
+  const nativeEventLogger = input.nativeEventLogger;
+  return (event) =>
+    nativeEventLogger
+      .write(
+        {
+          provider: CURSOR_PROVIDER,
+          protocol: CURSOR_AGENT_SDK_PROTOCOL,
+          kind: "protocol",
+          providerSessionId: input.providerSessionId,
+          event,
+        },
+        input.threadId,
+      )
+      .pipe(Effect.ignore);
+}
+
+export const cursorAgentSdkRunnerLiveLayer: Layer.Layer<
+  CursorAgentSdkRunner,
+  never,
+  ProviderEventLoggers
+> = Layer.effect(
+  CursorAgentSdkRunner,
+  Effect.gen(function* () {
+    const { native: nativeEventLogger } = yield* ProviderEventLoggers;
+
+    return CursorAgentSdkRunner.of({
+      open: Effect.fn("CursorAgentSdkRunner.open")(function* (input) {
+        const protocolLogger = makeCursorAgentSdkProtocolLogger({
+          nativeEventLogger,
+          threadId: input.threadId,
+          providerSessionId: input.providerSessionId,
+        });
+        const log = (event: CursorAgentSdkProtocolLogEvent) =>
+          protocolLogger === undefined ? Effect.void : protocolLogger(event);
+
+        yield* log({
+          direction: "outgoing",
+          stage: "decoded",
+          payload: {
+            type: "agent.open",
+            operation: input.operation,
+            ...(input.agentId === undefined ? {} : { agentId: input.agentId }),
+            options: loggedCursorAgentOptions(input.options),
+          },
+        });
+
+        const agent = yield* Effect.tryPromise({
+          try: () =>
+            input.operation === "create"
+              ? Agent.create(input.options)
+              : Agent.resume(input.agentId!, input.options),
+          catch: (cause) => runnerError(cause, `agent.${input.operation}`),
+        });
+
+        yield* log({
+          direction: "incoming",
+          stage: "decoded",
+          payload: {
+            type: "agent.opened",
+            agentId: agent.agentId,
+          },
+        });
+
+        const cwd =
+          typeof input.options.local?.cwd === "string"
+            ? input.options.local.cwd
+            : input.options.local?.cwd?.[0];
+
+        return {
+          agentId: agent.agentId,
+          send: Effect.fn("CursorAgentSdkSession.send")(function* (sendInput) {
+            const context = yield* Effect.context();
+            yield* log({
+              direction: "outgoing",
+              stage: "decoded",
+              payload: {
+                type: "run.start",
+                message: sendInput.message,
+                options: loggedCursorSendOptions(sendInput.options),
+              },
+            });
+
+            let callbacksReady = false;
+            const pendingUpdates: Array<InteractionUpdate> = [];
+            let callbackFailure: { readonly cause: unknown } | undefined;
+            let callbackChain = Promise.resolve();
+            let runId = "";
+            const dispatchUpdate = (update: InteractionUpdate): Promise<void> => {
+              callbackChain = callbackChain
+                .then(() => {
+                  if (callbackFailure !== undefined) {
+                    return;
+                  }
+                  return Effect.runPromiseWith(context)(
+                    log({
+                      direction: "incoming",
+                      stage: "decoded",
+                      payload: {
+                        type: "interaction.update",
+                        runId,
+                        update,
+                      },
+                    }).pipe(Effect.andThen(sendInput.onDelta?.(update) ?? Effect.void)),
+                  );
+                })
+                .catch((cause) => {
+                  callbackFailure ??= { cause };
+                });
+              return callbackChain;
+            };
+
+            const run = yield* Effect.tryPromise({
+              try: () =>
+                agent.send(sendInput.message, {
+                  ...sendInput.options,
+                  onDelta: async ({ update }) => {
+                    if (!callbacksReady) {
+                      pendingUpdates.push(update);
+                      return;
+                    }
+                    await dispatchUpdate(update);
+                  },
+                }),
+              catch: (cause) => runnerError(cause, "run.start"),
+            });
+            runId = run.id;
+            yield* log({
+              direction: "incoming",
+              stage: "decoded",
+              payload: {
+                type: "run.started",
+                runId: run.id,
+                agentId: run.agentId,
+              },
+            });
+            callbacksReady = true;
+            for (const update of pendingUpdates) {
+              yield* Effect.tryPromise({
+                try: () => dispatchUpdate(update),
+                catch: (cause) => runnerError(cause, "run.onDelta"),
+              });
+            }
+
+            return {
+              runId: run.id,
+              agentId: run.agentId,
+              wait: Effect.tryPromise({
+                try: async () => {
+                  const result = await run.wait();
+                  await callbackChain;
+                  if (callbackFailure !== undefined) {
+                    throw callbackFailure.cause;
+                  }
+                  return result;
+                },
+                catch: (cause) => runnerError(cause, "run.wait"),
+              }).pipe(
+                Effect.tap((result) =>
+                  log({
+                    direction: "incoming",
+                    stage: "decoded",
+                    payload: {
+                      type: "run.completed",
+                      result,
+                    },
+                  }),
+                ),
+              ),
+              cancel: log({
+                direction: "outgoing",
+                stage: "decoded",
+                payload: {
+                  type: "run.cancel",
+                  runId: run.id,
+                },
+              }).pipe(
+                Effect.andThen(
+                  Effect.tryPromise({
+                    try: async () => {
+                      try {
+                        await run.cancel();
+                      } catch (cause) {
+                        if (!isCursorCancellationError(cause)) {
+                          throw cause;
+                        }
+                      }
+                    },
+                    catch: (cause) => runnerError(cause, "run.cancel"),
+                  }),
+                ),
+              ),
+            } satisfies CursorAgentSdkRun;
+          }),
+          listMessages: log({
+            direction: "outgoing",
+            stage: "decoded",
+            payload: {
+              type: "agent.messages.list",
+              agentId: agent.agentId,
+            },
+          }).pipe(
+            Effect.andThen(
+              Effect.tryPromise({
+                try: () =>
+                  Agent.messages.list(agent.agentId, {
+                    runtime: "local",
+                    ...(cwd === undefined ? {} : { cwd }),
+                  }),
+                catch: (cause) => runnerError(cause, "agent.messages.list"),
+              }),
+            ),
+            Effect.tap((messages) =>
+              log({
+                direction: "incoming",
+                stage: "decoded",
+                payload: {
+                  type: "agent.messages",
+                  agentId: agent.agentId,
+                  messages,
+                },
+              }),
+            ),
+          ),
+          close: log({
+            direction: "outgoing",
+            stage: "decoded",
+            payload: {
+              type: "agent.close",
+              agentId: agent.agentId,
+            },
+          }).pipe(
+            Effect.andThen(
+              Effect.try({
+                try: () => agent.close(),
+                catch: (cause) => runnerError(cause, "agent.close"),
+              }),
+            ),
+          ),
+        } satisfies CursorAgentSdkSession;
+      }),
+      assertComplete: Effect.void,
+    });
+  }),
+);
diff --git a/apps/server/src/orchestration-v2/Adapters/GrokAdapterV2.test.ts b/apps/server/src/orchestration-v2/Adapters/GrokAdapterV2.test.ts
new file mode 100644
index 000000000000..e6d620500521
--- /dev/null
+++ b/apps/server/src/orchestration-v2/Adapters/GrokAdapterV2.test.ts
@@ -0,0 +1,379 @@
+import { assert, describe, it } from "@effect/vitest";
+import * as Effect from "effect/Effect";
+import type * as EffectAcpSchema from "effect-acp/schema";
+
+import { ProviderAdapterV2RuntimePolicy } from "../ProviderAdapter.ts";
+import {
+  AcpProviderCapabilitiesV2,
+  acpCompletedTurnShouldTerminalizeTool,
+  acpPermissionDisposition,
+  acpRootSessionUpdateIngestsOutput,
+  acpRootTurnCompletionDrainMs,
+  acpRootTurnHasIngestedOutput,
+  acpRootTurnIsIdle,
+  acpRootTurnSettleDebounceMs,
+  acpRootTurnShouldRearmRecoveryTimers,
+  acpSubagentStatusBlocksTurnSettlement,
+  acpSupportsImagePrompts,
+} from "./AcpAdapterV2.ts";
+import {
+  makeGrokAcpAdapterFlavor,
+  GrokProviderCapabilitiesV2,
+  type GrokAdapterV2Options,
+} from "./GrokAdapterV2.ts";
+
+function permissionRequest(
+  kind: EffectAcpSchema.ToolKind,
+): EffectAcpSchema.RequestPermissionRequest {
+  return {
+    sessionId: "session-1",
+    options: [
+      { optionId: "allow-once", name: "Allow once", kind: "allow_once" },
+      { optionId: "allow-always", name: "Allow always", kind: "allow_always" },
+      { optionId: "reject-once", name: "Reject", kind: "reject_once" },
+    ],
+    toolCall: {
+      toolCallId: "tool-1",
+      title: "Test tool",
+      kind,
+    },
+  };
+}
+
+function runtimePolicy(input: {
+  readonly runtimeMode: "approval-required" | "auto-accept-edits" | "full-access";
+  readonly approvalPolicy?: unknown;
+  readonly sandboxPolicy?: unknown;
+}) {
+  return ProviderAdapterV2RuntimePolicy.make({
+    runtimeMode: input.runtimeMode,
+    interactionMode: "default",
+    cwd: "/workspace",
+    ...(input.approvalPolicy === undefined ? {} : { approvalPolicy: input.approvalPolicy }),
+    ...(input.sandboxPolicy === undefined ? {} : { sandboxPolicy: input.sandboxPolicy }),
+  });
+}
+
+describe("acpRootTurnSettleDebounceMs", () => {
+  it("keeps the historical debounce constant for re-enable experiments", () => {
+    assert.equal(acpRootTurnSettleDebounceMs, 2_000);
+  });
+});
+
+describe("acpRootTurnCompletionDrainMs", () => {
+  it("gives trailing root chunks a short landing window", () => {
+    assert.equal(acpRootTurnCompletionDrainMs, 100);
+  });
+});
+
+describe("acpRootSessionUpdateIngestsOutput", () => {
+  const sessionId = "session-1";
+
+  it("ignores empty assistant chunks used as Grok keepalives", () => {
+    assert.isFalse(
+      acpRootSessionUpdateIngestsOutput({
+        sessionId,
+        update: {
+          sessionUpdate: "agent_message_chunk",
+          content: { type: "text", text: "" },
+        },
+      }),
+    );
+  });
+
+  it("accepts non-empty assistant and reasoning chunks", () => {
+    assert.isTrue(
+      acpRootSessionUpdateIngestsOutput({
+        sessionId,
+        update: {
+          sessionUpdate: "agent_message_chunk",
+          content: { type: "text", text: "hello" },
+        },
+      }),
+    );
+    assert.isTrue(
+      acpRootSessionUpdateIngestsOutput({
+        sessionId,
+        update: {
+          sessionUpdate: "agent_thought_chunk",
+          content: { type: "text", text: "thinking" },
+        },
+      }),
+    );
+  });
+
+  it("accepts tool and plan updates", () => {
+    assert.isTrue(
+      acpRootSessionUpdateIngestsOutput({
+        sessionId,
+        update: {
+          sessionUpdate: "tool_call",
+          toolCallId: "tool-1",
+          title: "Read",
+          kind: "read",
+          status: "pending",
+        },
+      }),
+    );
+    assert.isTrue(
+      acpRootSessionUpdateIngestsOutput({
+        sessionId,
+        update: {
+          sessionUpdate: "plan",
+          entries: [{ content: "Step 1", status: "pending", priority: "medium" }],
+        },
+      }),
+    );
+  });
+});
+
+describe("acpRootTurnHasIngestedOutput", () => {
+  const empty = {
+    assistant: { current: null, nextSegment: 0 },
+    reasoning: { current: null, nextSegment: 0 },
+    tools: new Map(),
+    plan: null,
+  } as const;
+
+  it("is false before any root turn items land", () => {
+    assert.isFalse(acpRootTurnHasIngestedOutput(empty));
+  });
+
+  it("is true once assistant segments have streamed", () => {
+    assert.isTrue(
+      acpRootTurnHasIngestedOutput({
+        ...empty,
+        assistant: { current: null, nextSegment: 1 },
+      }),
+    );
+  });
+});
+
+describe("acpRootTurn recovery timer re-arm", () => {
+  it("re-arms idle settle after pending clears on active turns", () => {
+    assert.isTrue(acpRootTurnShouldRearmRecoveryTimers({ finalized: false, interrupted: false }));
+  });
+
+  it("skips re-arm when the turn is already terminal", () => {
+    assert.isFalse(acpRootTurnShouldRearmRecoveryTimers({ finalized: true, interrupted: false }));
+    assert.isFalse(acpRootTurnShouldRearmRecoveryTimers({ finalized: false, interrupted: true }));
+  });
+});
+
+describe("acpSubagentStatusBlocksTurnSettlement", () => {
+  it("blocks settlement for pending and running subagents", () => {
+    assert.isTrue(acpSubagentStatusBlocksTurnSettlement("pending"));
+    assert.isTrue(acpSubagentStatusBlocksTurnSettlement("running"));
+  });
+
+  it("does not block settlement for terminal subagents", () => {
+    assert.isFalse(acpSubagentStatusBlocksTurnSettlement("cancelled"));
+    assert.isFalse(acpSubagentStatusBlocksTurnSettlement("completed"));
+    assert.isFalse(acpSubagentStatusBlocksTurnSettlement("failed"));
+    assert.isFalse(acpSubagentStatusBlocksTurnSettlement("interrupted"));
+  });
+});
+
+describe("acpRootTurnIsIdle", () => {
+  const quiet = {
+    finalized: false,
+    interrupted: false,
+    assistantStreamOpen: false,
+    reasoningStreamOpen: false,
+    hasRunningTool: false,
+    hasPendingRuntimeRequest: false,
+    hasToolHistory: false,
+    hasActiveSubagent: false,
+    hasOutput: true,
+  } as const;
+
+  it("is false while assistant text is still streaming", () => {
+    assert.isFalse(acpRootTurnIsIdle({ ...quiet, assistantStreamOpen: true }));
+  });
+
+  it("is false while a tool is running", () => {
+    assert.isFalse(acpRootTurnIsIdle({ ...quiet, hasRunningTool: true }));
+  });
+
+  it("is false after tool history (prompt RPC owns terminalization)", () => {
+    assert.isFalse(acpRootTurnIsIdle({ ...quiet, hasToolHistory: true }));
+  });
+
+  it("is false while a native subagent task is still running", () => {
+    assert.isFalse(acpRootTurnIsIdle({ ...quiet, hasActiveSubagent: true }));
+  });
+
+  it("is false when only reasoning or tools have streamed", () => {
+    assert.isFalse(acpRootTurnIsIdle({ ...quiet, hasOutput: false }));
+  });
+
+  it("is false for assistant-only quiet (preamble-before-tools must not settle)", () => {
+    assert.isFalse(acpRootTurnIsIdle(quiet));
+  });
+
+  it("is false when tools finished and root is quiet (no speculative multi-wave settle)", () => {
+    assert.isFalse(
+      acpRootTurnIsIdle({
+        ...quiet,
+        hasToolHistory: true,
+        hasRunningTool: false,
+      }),
+    );
+  });
+});
+
+describe("GrokAdapterV2 capabilities", () => {
+  it("wires hard Stop teardown but soft non-Stop interrupts in the constructor flavor", () => {
+    const flavor = makeGrokAcpAdapterFlavor({
+      makeRuntime: () => Effect.never,
+    } as unknown as GrokAdapterV2Options);
+
+    assert.isFalse(flavor.interruptPromptOnCancel);
+    // User Stop (requestRuntimeRestart) keeps the hard process-group kill and
+    // respawn: Grok cancel is detach-and-continue, so only a process kill
+    // stops the work.
+    assert.isTrue(flavor.restartRuntimeAfterInterrupt);
+    assert.isTrue(flavor.terminateRuntimeProcessGroupOnInterrupt);
+    // Non-Stop interrupts (steering, restart_active) reuse the process and
+    // session; the cancelled work backgrounds and the model decides its fate.
+    assert.isUndefined(flavor.restartRuntimeOnEveryInterrupt);
+    assert.isTrue(flavor.preserveRuntimeOnSettledInterrupt);
+  });
+
+  it("terminalizes only foreground tools under the actual Grok flavor", () => {
+    const flavor = makeGrokAcpAdapterFlavor({
+      makeRuntime: () => Effect.never,
+    } as unknown as GrokAdapterV2Options);
+    const foreground = {
+      toolCallId: "foreground-1",
+      title: "Terminal",
+      status: "inProgress" as const,
+      data: {
+        rawInput: { command: "true" },
+        rawOutput: { type: "Bash", exit_code: 0 },
+      },
+    };
+    const monitor = {
+      toolCallId: "monitor-1",
+      title: "Monitor",
+      status: "inProgress" as const,
+      data: {
+        rawInput: { variant: "Monitor", command: "sleep 30" },
+        rawOutput: {
+          type: "Monitor",
+          taskId: "019f44b8-8e98-7c80-a40e-df1e26a5f9e3",
+        },
+      },
+    };
+    const subagent = {
+      toolCallId: "subagent-1",
+      title: "Task",
+      status: "inProgress" as const,
+      data: {
+        rawInput: {
+          description: "Inspect interrupt handling",
+          prompt: "Review the adapter.",
+          subagent_type: "generalPurpose",
+        },
+      },
+    };
+
+    assert.isTrue(acpCompletedTurnShouldTerminalizeTool(foreground, flavor));
+    assert.isFalse(acpCompletedTurnShouldTerminalizeTool(monitor, flavor));
+    assert.isFalse(acpCompletedTurnShouldTerminalizeTool(subagent, flavor));
+  });
+
+  it("keeps optional protocol features conservative until a flavor or handshake confirms them", () => {
+    assert.isFalse(AcpProviderCapabilitiesV2.sessions.supportsModelSwitchInSession);
+    assert.isFalse(AcpProviderCapabilitiesV2.sessions.supportsRuntimeModeSwitchInSession);
+    assert.isFalse(AcpProviderCapabilitiesV2.threads.canReadThreadSnapshot);
+    assert.isFalse(AcpProviderCapabilitiesV2.tools.supportsMcpTools);
+  });
+
+  it("overrides ACP image capability false so screenshot attachments can prompt", () => {
+    // Handshake alone would refuse attachments (Grok advertises image:false).
+    assert.isFalse(
+      acpSupportsImagePrompts({
+        negotiatedImage: false,
+      }),
+    );
+    // Flavor override unblocks image content blocks for Grok.
+    assert.isTrue(
+      acpSupportsImagePrompts({
+        flavorSupportsImagePrompts: true,
+        negotiatedImage: false,
+      }),
+    );
+    assert.isTrue(
+      acpSupportsImagePrompts({
+        negotiatedImage: true,
+      }),
+    );
+  });
+
+  it("declares Grok Task envelopes as native subagents", () => {
+    assert.isFalse(GrokProviderCapabilitiesV2.threads.canForkThread);
+    assert.isTrue(GrokProviderCapabilitiesV2.subagents.supportsSubagents);
+    assert.isTrue(GrokProviderCapabilitiesV2.subagents.exposesSubagentThreadIds);
+    assert.isTrue(GrokProviderCapabilitiesV2.subagents.emitsSubagentLifecycle);
+    assert.isFalse(GrokProviderCapabilitiesV2.turns.supportsActiveSteering);
+    assert.isTrue(GrokProviderCapabilitiesV2.turns.supportsInterrupt);
+    assert.isTrue(GrokProviderCapabilitiesV2.turns.supportsSteeringByInterruptRestart);
+    assert.isTrue(GrokProviderCapabilitiesV2.context.supportsFullThreadHandoff);
+  });
+
+  it("declares the optional ACP features verified by the Grok handshake", () => {
+    assert.isTrue(GrokProviderCapabilitiesV2.sessions.supportsModelSwitchInSession);
+    assert.isTrue(GrokProviderCapabilitiesV2.threads.canReadThreadSnapshot);
+    assert.isTrue(GrokProviderCapabilitiesV2.tools.supportsMcpTools);
+    assert.isTrue(GrokProviderCapabilitiesV2.checkpointing.providerCanReadConversationSnapshot);
+  });
+});
+
+describe("ACP permission policy", () => {
+  it("honors explicit on-request approval over full-access runtime mode", () => {
+    assert.equal(
+      acpPermissionDisposition(
+        runtimePolicy({
+          runtimeMode: "full-access",
+          approvalPolicy: "on-request",
+          sandboxPolicy: { type: "readOnly" },
+        }),
+        permissionRequest("execute"),
+      ),
+      "ask",
+    );
+  });
+
+  it("rejects mutating escalation under a non-interactive read-only policy", () => {
+    const policy = runtimePolicy({
+      runtimeMode: "full-access",
+      approvalPolicy: "never",
+      sandboxPolicy: { type: "readOnly" },
+    });
+    assert.equal(acpPermissionDisposition(policy, permissionRequest("execute")), "deny");
+    assert.equal(acpPermissionDisposition(policy, permissionRequest("edit")), "deny");
+    assert.equal(acpPermissionDisposition(policy, permissionRequest("read")), "allow");
+  });
+
+  it("auto-approves requests only when the resolved policy permits them", () => {
+    assert.equal(
+      acpPermissionDisposition(
+        runtimePolicy({
+          runtimeMode: "full-access",
+          approvalPolicy: "never",
+          sandboxPolicy: { type: "dangerFullAccess" },
+        }),
+        permissionRequest("execute"),
+      ),
+      "allow",
+    );
+    assert.equal(
+      acpPermissionDisposition(
+        runtimePolicy({ runtimeMode: "approval-required" }),
+        permissionRequest("read"),
+      ),
+      "ask",
+    );
+  });
+});
diff --git a/apps/server/src/orchestration-v2/Adapters/GrokAdapterV2.testkit.ts b/apps/server/src/orchestration-v2/Adapters/GrokAdapterV2.testkit.ts
new file mode 100644
index 000000000000..78e419ef11b7
--- /dev/null
+++ b/apps/server/src/orchestration-v2/Adapters/GrokAdapterV2.testkit.ts
@@ -0,0 +1,82 @@
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import { GrokSettings } from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as Crypto from "effect/Crypto";
+import * as FileSystem from "effect/FileSystem";
+import * as Layer from "effect/Layer";
+import * as Path from "effect/Path";
+import * as Schema from "effect/Schema";
+import { ChildProcessSpawner } from "effect/unstable/process";
+import { HostProcessPlatform } from "@t3tools/shared/hostProcess";
+
+import { ServerConfig } from "../../config.ts";
+import { layer as idAllocatorLayer, IdAllocatorV2 } from "../IdAllocator.ts";
+import { makeLayerEffect as makeProviderAdapterRegistryLayerEffect } from "../ProviderAdapterRegistry.ts";
+import type { OrchestratorV2ProviderReplayHarness } from "../testkit/ProviderReplayHarness.ts";
+import { makeReplayServerConfig } from "../testkit/ProviderReplayHarness.ts";
+import {
+  type AcpReplayTranscript,
+  AcpReplayTranscriptDecodeError,
+  decodeAcpReplayTranscript,
+  makeAcpReplayCompletenessAssertion,
+  makeAcpReplayRuntime,
+} from "./AcpAdapterV2.testkit.ts";
+import { GROK_DEFAULT_INSTANCE_ID, GROK_PROVIDER, makeGrokAdapterV2 } from "./GrokAdapterV2.ts";
+
+const DEFAULT_GROK_SETTINGS = Schema.decodeUnknownSync(GrokSettings)({});
+
+export function makeGrokProviderAdapterRegistryReplayLayer(transcript: AcpReplayTranscript) {
+  const serverConfigLayer = Layer.effect(
+    ServerConfig,
+    makeReplayServerConfig(`grok-${transcript.scenario}`).pipe(Effect.orDie),
+  ).pipe(Layer.provide(NodeServices.layer));
+
+  return makeProviderAdapterRegistryLayerEffect(
+    Effect.gen(function* () {
+      const fileSystem = yield* FileSystem.FileSystem;
+      const path = yield* Path.Path;
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const crypto = yield* Crypto.Crypto;
+      const hostPlatform = yield* HostProcessPlatform;
+      const idAllocator = yield* IdAllocatorV2;
+      const serverConfig = yield* ServerConfig;
+      const replayDir = yield* fileSystem
+        .makeTempDirectory({
+          prefix: `t3-orchestration-v2-grok-replay-${transcript.scenario}-`,
+        })
+        .pipe(Effect.orDie);
+      const statusPath = path.join(replayDir, "status.json");
+      const scriptPath = yield* path
+        .fromFileUrl(new URL("../../../scripts/acp-replay-agent.ts", import.meta.url))
+        .pipe(Effect.orDie);
+      const adapter = makeGrokAdapterV2({
+        instanceId: GROK_DEFAULT_INSTANCE_ID,
+        settings: DEFAULT_GROK_SETTINGS,
+        environment: {},
+        hostPlatform,
+        childProcessSpawner,
+        crypto,
+        fileSystem,
+        idAllocator,
+        serverConfig,
+        makeRuntime: makeAcpReplayRuntime({
+          transcript,
+          statusPath,
+          scriptPath,
+          childProcessSpawner,
+        }),
+        assertComplete: makeAcpReplayCompletenessAssertion(fileSystem, statusPath, transcript),
+      });
+      return [adapter];
+    }),
+  ).pipe(Layer.provide(Layer.mergeAll(serverConfigLayer, NodeServices.layer, idAllocatorLayer)));
+}
+
+export const GrokOrchestratorReplayHarness: OrchestratorV2ProviderReplayHarness<
+  AcpReplayTranscript,
+  AcpReplayTranscriptDecodeError
+> = {
+  driver: GROK_PROVIDER,
+  decodeTranscript: (transcript) => decodeAcpReplayTranscript(transcript, GROK_PROVIDER),
+  makeProviderAdapterRegistryLayer: makeGrokProviderAdapterRegistryReplayLayer,
+};
diff --git a/apps/server/src/orchestration-v2/Adapters/GrokAdapterV2.ts b/apps/server/src/orchestration-v2/Adapters/GrokAdapterV2.ts
new file mode 100644
index 000000000000..b42887c49ada
--- /dev/null
+++ b/apps/server/src/orchestration-v2/Adapters/GrokAdapterV2.ts
@@ -0,0 +1,375 @@
+import { HostProcessEnvironment, HostProcessPlatform } from "@t3tools/shared/hostProcess";
+import {
+  defaultInstanceIdForDriver,
+  GrokSettings,
+  ProviderDriverKind,
+  type OrchestrationV2ProviderCapabilities,
+} from "@t3tools/contracts";
+import * as Crypto from "effect/Crypto";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Layer from "effect/Layer";
+import * as Schema from "effect/Schema";
+import type * as Scope from "effect/Scope";
+import { ChildProcessSpawner } from "effect/unstable/process";
+import type * as EffectAcpErrors from "effect-acp/errors";
+
+import { ServerConfig } from "../../config.ts";
+import { makeAcpNativeLoggerFactory } from "../../provider/acp/AcpNativeLogging.ts";
+import {
+  makeGrokAcpRuntime,
+  resolveGrokAcpBaseModelId,
+} from "../../provider/acp/GrokAcpSupport.ts";
+import {
+  extractGrokPlanMarkdownFromToolCallData,
+  extractXAiAcpBackgroundToolMutation,
+  extractXAiAcpSubagentEndNotice,
+  extractXAiAcpSubagentUpdate,
+  extractXAiAskUserQuestionIdentity,
+  extractXAiAskUserQuestions,
+  extractXAiBackgroundTaskCompletion,
+  extractXAiKilledBackgroundTasks,
+  extractXAiMonitorTaskId,
+  isXAiPersistentMonitor,
+  extractXAiExitPlanMarkdown,
+  makeXAiAskUserQuestionCancelledResponse,
+  makeXAiAskUserQuestionResponse,
+  makeXAiExitPlanModeCapturedResponse,
+  normalizeXAiAcpToolCallState,
+  registerXAiBackgroundTaskTracking,
+  XAiAskUserQuestionRequest,
+  XAiExitPlanModeRequest,
+} from "../../provider/acp/XAiAcpExtension.ts";
+import { mergeProviderInstanceEnvironment } from "../../provider/ProviderInstanceEnvironment.ts";
+import * as AcpSessionRuntime from "../../provider/acp/AcpSessionRuntime.ts";
+import { ProviderEventLoggers } from "../../provider/Layers/ProviderEventLoggers.ts";
+import { IdAllocatorV2 } from "../IdAllocator.ts";
+import { ProviderContinuationRequests } from "../ProviderContinuationRequests.ts";
+import { ProviderAdapterV2 } from "../ProviderAdapter.ts";
+import {
+  ProviderAdapterDriverCreateError,
+  type ProviderAdapterDriver,
+  type ProviderAdapterDriverCreateInput,
+} from "../ProviderAdapterDriver.ts";
+import {
+  AcpProviderCapabilitiesV2,
+  makeAcpAdapterV2,
+  type AcpAdapterV2ExtensionContext,
+  type AcpAdapterV2Flavor,
+  type AcpAdapterV2RuntimeInput,
+} from "./AcpAdapterV2.ts";
+
+export const GROK_PROVIDER = ProviderDriverKind.make("grok");
+export const GROK_DRIVER_KIND = GROK_PROVIDER;
+export const GROK_DEFAULT_INSTANCE_ID = defaultInstanceIdForDriver(GROK_DRIVER_KIND);
+const DEFAULT_GROK_SETTINGS = Schema.decodeSync(GrokSettings)({});
+
+export const GrokProviderCapabilitiesV2 = {
+  ...AcpProviderCapabilitiesV2,
+  sessions: {
+    ...AcpProviderCapabilitiesV2.sessions,
+    supportsModelSwitchInSession: true,
+    supportsRuntimeModeSwitchInSession: false,
+  },
+  threads: {
+    ...AcpProviderCapabilitiesV2.threads,
+    canReadThreadSnapshot: true,
+    canForkThread: false,
+    canForkFromTurn: false,
+  },
+  subagents: {
+    ...AcpProviderCapabilitiesV2.subagents,
+    supportsSubagents: true,
+    exposesSubagentThreadIds: true,
+    emitsSubagentLifecycle: true,
+  },
+  tools: {
+    ...AcpProviderCapabilitiesV2.tools,
+    supportsMcpTools: true,
+  },
+  checkpointing: {
+    ...AcpProviderCapabilitiesV2.checkpointing,
+    providerCanReadConversationSnapshot: true,
+  },
+} satisfies OrchestrationV2ProviderCapabilities;
+
+export interface GrokAdapterV2Options {
+  readonly instanceId: Parameters<typeof makeAcpAdapterV2>[0]["instanceId"];
+  readonly settings: GrokSettings;
+  readonly environment: NodeJS.ProcessEnv;
+  readonly hostPlatform: NodeJS.Platform;
+  readonly childProcessSpawner: ChildProcessSpawner.ChildProcessSpawner["Service"];
+  readonly crypto: Crypto.Crypto;
+  readonly fileSystem: FileSystem.FileSystem;
+  readonly idAllocator: IdAllocatorV2["Service"];
+  readonly serverConfig: ServerConfig["Service"];
+  readonly nativeLogging?: Parameters<typeof makeAcpAdapterV2>[0]["nativeLogging"];
+  readonly continuationRequests?: Parameters<typeof makeAcpAdapterV2>[0]["continuationRequests"];
+  readonly makeRuntime?: (
+    input: AcpAdapterV2RuntimeInput,
+  ) => Effect.Effect<
+    AcpSessionRuntime.AcpSessionRuntime["Service"],
+    EffectAcpErrors.AcpError,
+    Crypto.Crypto | Scope.Scope
+  >;
+  readonly assertComplete?: Effect.Effect<void, EffectAcpErrors.AcpError>;
+}
+
+export const registerGrokAcpExtensions: NonNullable<AcpAdapterV2Flavor["registerExtensions"]> = ({
+  runtime,
+  requestUserInput,
+  applyBackgroundTaskMutation,
+  captureProposedPlan,
+  lastProposedPlanMarkdown,
+}) =>
+  registerXAiBackgroundTaskTracking(runtime, applyBackgroundTaskMutation).pipe(
+    Effect.andThen(registerGrokAskUserQuestionExtensions({ runtime, requestUserInput })),
+    Effect.andThen(
+      registerGrokExitPlanModeExtensions({
+        runtime,
+        captureProposedPlan,
+        lastProposedPlanMarkdown,
+      }),
+    ),
+  );
+
+/**
+ * Grok intercepts exit_plan_mode and reverse-requests client approval. Capture
+ * the plan into T3's proposed-plan card and abandon the native gate so the
+ * turn does not hang (#8358; mirrors the Claude ExitPlanMode pattern). Plan
+ * content preference: the request payload, then the plan.md contents sniffed
+ * from tool calls this turn, then the empty-state placeholder.
+ */
+const registerGrokExitPlanModeExtensions = ({
+  runtime,
+  captureProposedPlan,
+  lastProposedPlanMarkdown,
+}: Pick<
+  AcpAdapterV2ExtensionContext,
+  "runtime" | "captureProposedPlan" | "lastProposedPlanMarkdown"
+>) =>
+  Effect.forEach(
+    ["x.ai/exit_plan_mode", "_x.ai/exit_plan_mode"] as const,
+    (method) =>
+      runtime.handleExtRequest(method, XAiExitPlanModeRequest, (params) =>
+        Effect.gen(function* () {
+          const fallback = yield* lastProposedPlanMarkdown;
+          yield* captureProposedPlan({
+            planMarkdown: extractXAiExitPlanMarkdown(params, fallback),
+          });
+          return makeXAiExitPlanModeCapturedResponse();
+        }),
+      ),
+    { discard: true },
+  );
+
+const registerGrokAskUserQuestionExtensions = ({
+  runtime,
+  requestUserInput,
+}: Pick<AcpAdapterV2ExtensionContext, "runtime" | "requestUserInput">) =>
+  Effect.forEach(
+    ["x.ai/ask_user_question", "_x.ai/ask_user_question"] as const,
+    (method) =>
+      runtime.handleExtRequest(method, XAiAskUserQuestionRequest, (params) => {
+        const identity = extractXAiAskUserQuestionIdentity(params);
+        const questions = extractXAiAskUserQuestions(params).map((question) => ({
+          id: question.id,
+          header: question.header,
+          question: question.question,
+          options: [...question.options],
+        }));
+        return requestUserInput({
+          nativeItemId: `${identity.sessionId}:xai-question:${identity.toolCallId}`,
+          nativeMethod: method,
+          nativeRequestId: identity.toolCallId,
+          nativeSessionId: identity.sessionId,
+          questions,
+        }).pipe(
+          Effect.flatMap(({ acknowledgeNativeResponse, answers }) =>
+            Effect.succeed(
+              answers === null
+                ? makeXAiAskUserQuestionCancelledResponse()
+                : makeXAiAskUserQuestionResponse(params, answers),
+            ).pipe(Effect.tap(() => acknowledgeNativeResponse)),
+          ),
+        );
+      }),
+    { discard: true },
+  );
+
+export function makeGrokAcpAdapterFlavor(options: GrokAdapterV2Options): AcpAdapterV2Flavor {
+  return {
+    driver: GROK_PROVIDER,
+    capabilities: GrokProviderCapabilitiesV2,
+    // Idle settle over-settled preamble-before-tools turns and cancelled the
+    // prompt while Grok continued, freezing T3 projection mid-turn.
+    settleRootTurnWhenIdle: false,
+    interruptPromptOnCancel: false,
+    // User Stop (requestRuntimeRestart) still hard-kills the process group and
+    // respawns so existing background tasks stop too. Older 0.2.x builds could
+    // detach a cancelled foreground command (E3 harness 2026-07-18); current
+    // source kills foreground work but intentionally preserves already-
+    // backgrounded tasks. Non-Stop interrupts (mid-prompt steering,
+    // restart_active) omit requestRuntimeRestart and stay soft: session/cancel
+    // carries cancelTrigger=ctrl_c, the session survives, and background work
+    // remains available to the replacement turn.
+    restartRuntimeAfterInterrupt: true,
+    terminateRuntimeProcessGroupOnInterrupt: true,
+    // Steering restarts on a settled turn additionally skip session/cancel so
+    // fire-and-forget subagents survive the steer (E1 harness confirmed the
+    // Grok CLI accepts a concurrent session/prompt in that state).
+    preserveRuntimeOnSettledInterrupt: true,
+    // Grok ACP initialize reports promptCapabilities.image:false but the agent
+    // still accepts image content blocks (verified with real screenshots).
+    supportsImagePrompts: true,
+    resolveModelId: (selection) => resolveGrokAcpBaseModelId(selection.model),
+    makeRuntime:
+      options.makeRuntime ??
+      ((input) =>
+        makeGrokAcpRuntime({
+          ...input,
+          interruptPromptOnCancel: input.interruptPromptOnCancel ?? false,
+          grokSettings: options.settings,
+          environment: options.environment,
+          childProcessSpawner: options.childProcessSpawner,
+        })),
+    registerExtensions: registerGrokAcpExtensions,
+    extractSubagentUpdate: extractXAiAcpSubagentUpdate,
+    extractSubagentEndNotice: extractXAiAcpSubagentEndNotice,
+    normalizeToolCall: normalizeXAiAcpToolCallState,
+    // Show the plan while Grok is still writing it: plan.md writes under the
+    // Grok session dir surface as the proposed-plan card before exit (#8358).
+    extractProposedPlanMarkdown: (toolCall) =>
+      extractGrokPlanMarkdownFromToolCallData(toolCall.data, {
+        platform: options.hostPlatform,
+        environment: options.environment,
+      }),
+    extractBackgroundTaskId: extractXAiMonitorTaskId,
+    extractBackgroundToolMutation: extractXAiAcpBackgroundToolMutation,
+    extractBackgroundTaskCompletion: (toolCall) => [
+      ...extractXAiBackgroundTaskCompletion(toolCall),
+      ...extractXAiKilledBackgroundTasks(toolCall),
+    ],
+    isPersistentBackgroundTool: isXAiPersistentMonitor,
+    deferFinalizeForBackgroundWork: true,
+    enablePostSettleContinuation: true,
+    ...(options.assertComplete === undefined ? {} : { assertComplete: options.assertComplete }),
+  };
+}
+
+export function makeGrokAdapterV2(options: GrokAdapterV2Options) {
+  const flavor = makeGrokAcpAdapterFlavor(options);
+  return makeAcpAdapterV2({
+    instanceId: options.instanceId,
+    flavor,
+    crypto: options.crypto,
+    fileSystem: options.fileSystem,
+    idAllocator: options.idAllocator,
+    serverConfig: options.serverConfig,
+    ...(options.nativeLogging === undefined ? {} : { nativeLogging: options.nativeLogging }),
+    ...(options.continuationRequests === undefined
+      ? {}
+      : { continuationRequests: options.continuationRequests }),
+  });
+}
+
+export type GrokAdapterV2DriverEnv =
+  | ChildProcessSpawner.ChildProcessSpawner
+  | Crypto.Crypto
+  | FileSystem.FileSystem
+  | IdAllocatorV2
+  | ProviderEventLoggers
+  | ServerConfig;
+
+export const GrokAdapterV2Driver: ProviderAdapterDriver<GrokSettings, GrokAdapterV2DriverEnv> = {
+  driverKind: GROK_DRIVER_KIND,
+  configSchema: GrokSettings,
+  defaultConfig: (): GrokSettings => DEFAULT_GROK_SETTINGS,
+  create: Effect.fn("GrokAdapterV2Driver.create")(
+    function* (input: ProviderAdapterDriverCreateInput<GrokSettings>) {
+      const hostEnvironment = yield* HostProcessEnvironment;
+      const hostPlatform = yield* HostProcessPlatform;
+      const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+      const crypto = yield* Crypto.Crypto;
+      const fileSystem = yield* FileSystem.FileSystem;
+      const idAllocator = yield* IdAllocatorV2;
+      const providerEventLoggers = yield* ProviderEventLoggers;
+      const serverConfig = yield* ServerConfig;
+      const continuationRequests = yield* ProviderContinuationRequests;
+      const makeNativeLogger = yield* makeAcpNativeLoggerFactory();
+      return makeGrokAdapterV2({
+        instanceId: input.instanceId,
+        settings: { ...input.config, enabled: input.enabled },
+        environment: mergeProviderInstanceEnvironment(input.environment, hostEnvironment),
+        hostPlatform,
+        childProcessSpawner,
+        crypto,
+        fileSystem,
+        idAllocator,
+        serverConfig,
+        continuationRequests,
+        nativeLogging: (threadId) =>
+          makeNativeLogger({
+            nativeEventLogger: providerEventLoggers.native,
+            provider: GROK_PROVIDER,
+            threadId,
+          }),
+      });
+    },
+    (effect, input) =>
+      effect.pipe(
+        Effect.mapError(
+          (cause) =>
+            new ProviderAdapterDriverCreateError({
+              driver: GROK_DRIVER_KIND,
+              instanceId: input.instanceId,
+              detail: "Failed to create Grok ACP adapter.",
+              cause,
+            }),
+        ),
+      ),
+  ),
+};
+
+export const layer: Layer.Layer<
+  ProviderAdapterV2,
+  never,
+  | ChildProcessSpawner.ChildProcessSpawner
+  | Crypto.Crypto
+  | FileSystem.FileSystem
+  | IdAllocatorV2
+  | ProviderEventLoggers
+  | ServerConfig
+> = Layer.effect(
+  ProviderAdapterV2,
+  Effect.gen(function* () {
+    const hostEnvironment = yield* HostProcessEnvironment;
+    const hostPlatform = yield* HostProcessPlatform;
+    const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+    const crypto = yield* Crypto.Crypto;
+    const fileSystem = yield* FileSystem.FileSystem;
+    const idAllocator = yield* IdAllocatorV2;
+    const providerEventLoggers = yield* ProviderEventLoggers;
+    const serverConfig = yield* ServerConfig;
+    const continuationRequests = yield* ProviderContinuationRequests;
+    const makeNativeLogger = yield* makeAcpNativeLoggerFactory();
+    return makeGrokAdapterV2({
+      instanceId: GROK_DEFAULT_INSTANCE_ID,
+      settings: DEFAULT_GROK_SETTINGS,
+      environment: hostEnvironment,
+      hostPlatform,
+      childProcessSpawner,
+      crypto,
+      fileSystem,
+      idAllocator,
+      serverConfig,
+      continuationRequests,
+      nativeLogging: (threadId) =>
+        makeNativeLogger({
+          nativeEventLogger: providerEventLoggers.native,
+          provider: GROK_PROVIDER,
+          threadId,
+        }),
+    });
+  }),
+);
diff --git a/apps/server/src/orchestration-v2/Adapters/OpenCodeAdapterV2.test.ts b/apps/server/src/orchestration-v2/Adapters/OpenCodeAdapterV2.test.ts
new file mode 100644
index 000000000000..d7237c304b6a
--- /dev/null
+++ b/apps/server/src/orchestration-v2/Adapters/OpenCodeAdapterV2.test.ts
@@ -0,0 +1,1173 @@
+import { assert, describe, it } from "@effect/vitest";
+import {
+  NodeId,
+  OpenCodeSettings,
+  ProjectId,
+  ProviderInstanceId,
+  ProviderSessionId,
+  ProviderThreadId,
+  ProviderTurnId,
+  RunAttemptId,
+  RunId,
+  MessageId,
+  ThreadId,
+  type OrchestrationV2ProviderTurn,
+} from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as DateTime from "effect/DateTime";
+import * as Deferred from "effect/Deferred";
+import * as Fiber from "effect/Fiber";
+import * as Exit from "effect/Exit";
+import * as Queue from "effect/Queue";
+import * as Schema from "effect/Schema";
+import * as Stream from "effect/Stream";
+import * as TestClock from "effect/testing/TestClock";
+
+import type { EventNdjsonLogger } from "../../provider/Layers/EventNdjsonLogger.ts";
+import type { OpenCodeRuntimeShape } from "../../provider/opencodeRuntime.ts";
+import type { ServerConfig } from "../../config.ts";
+import { IdAllocatorV2, layer as idAllocatorLayer } from "../IdAllocator.ts";
+
+import {
+  advanceOpenCodePromptAdmission,
+  cancelOpenCodePromptAdmission,
+  openCodeBoundaryAfterProviderTurn,
+  openCodeChildPermissionRules,
+  openCodePermissionRules,
+  openCodePermissionRequestKind,
+  openCodeToolProjectionKind,
+  makeOpenCodeProtocolLogger,
+  makeOpenCodeAdapterV2,
+  OPENCODE_PROVIDER,
+  OpenCodeProviderCapabilitiesV2,
+  reconcileOpenCodePromptAdmissionStatus,
+} from "./OpenCodeAdapterV2.ts";
+import { ProviderAdapterV2RuntimePolicy } from "../ProviderAdapter.ts";
+
+const encodeUnknownJson = Schema.encodeUnknownSync(Schema.fromJsonString(Schema.Unknown));
+const OPEN_CODE_TEST_SETTINGS = Schema.decodeSync(OpenCodeSettings)({
+  serverUrl: "http://test.invalid",
+});
+
+function promiseGate<A>() {
+  let resolve!: (value: A) => void;
+  const promise = new Promise<A>((done) => {
+    resolve = done;
+  });
+  return { promise, resolve };
+}
+
+function asyncEventStream() {
+  const values: Array<{ value: unknown; handled: ReturnType<typeof promiseGate<void>> }> = [];
+  const waiters: Array<(value: IteratorResult<unknown>) => void> = [];
+  let previousHandled: ReturnType<typeof promiseGate<void>> | undefined;
+  return {
+    close() {
+      for (const waiter of waiters.splice(0)) waiter({ done: true, value: undefined });
+    },
+    push(value: unknown) {
+      const handled = promiseGate<void>();
+      const waiter = waiters.shift();
+      if (waiter) {
+        previousHandled = handled;
+        waiter({ done: false, value });
+      } else values.push({ value, handled });
+      return handled.promise;
+    },
+    stream: {
+      [Symbol.asyncIterator]() {
+        return {
+          next: () => {
+            previousHandled?.resolve();
+            const entry = values.shift();
+            if (entry !== undefined) {
+              previousHandled = entry.handled;
+              return Promise.resolve({ done: false as const, value: entry.value });
+            }
+            return new Promise<IteratorResult<unknown>>((resolve) => waiters.push(resolve));
+          },
+        };
+      },
+    },
+  };
+}
+
+function runtimePolicy(
+  runtimeMode: ProviderAdapterV2RuntimePolicy["runtimeMode"],
+  override: Partial<ProviderAdapterV2RuntimePolicy> = {},
+): ProviderAdapterV2RuntimePolicy {
+  return ProviderAdapterV2RuntimePolicy.make({
+    runtimeMode,
+    interactionMode: "default",
+    cwd: null,
+    ...override,
+  });
+}
+
+function permissionAction(rules: ReturnType<typeof openCodePermissionRules>, permission: string) {
+  return rules.findLast((rule) => rule.permission === "*" || rule.permission === permission)
+    ?.action;
+}
+
+function providerTurn(input: {
+  readonly id: string;
+  readonly ordinal: number;
+  readonly nativeId: string | null;
+}): OrchestrationV2ProviderTurn {
+  return {
+    id: ProviderTurnId.make(input.id),
+    providerThreadId: ProviderThreadId.make("provider-thread:opencode-test"),
+    nodeId: NodeId.make(`node:${input.id}`),
+    runAttemptId: null,
+    nativeTurnRef:
+      input.nativeId === null
+        ? null
+        : { driver: OPENCODE_PROVIDER, nativeId: input.nativeId, strength: "weak" },
+    ordinal: input.ordinal,
+    status: "completed",
+    startedAt: null,
+    completedAt: null,
+  };
+}
+
+const makeOpenCodeRuntimeHarness = Effect.fn("makeOpenCodeRuntimeHarness")(function* (
+  suffix: string,
+  nativeSessionId: string,
+  client: object,
+) {
+  const idAllocator = yield* IdAllocatorV2;
+  const instanceId = ProviderInstanceId.make(`opencode-${suffix}`);
+  const threadId = ThreadId.make(`thread-opencode-${suffix}`);
+  const modelSelection = {
+    instanceId,
+    model: "anthropic/claude-sonnet",
+    options: [],
+  };
+  const policy = runtimePolicy("full-access", { cwd: "/workspace" });
+  const adapter = makeOpenCodeAdapterV2({
+    instanceId,
+    settings: OPEN_CODE_TEST_SETTINGS,
+    environment: {},
+    runtime: {
+      connectToOpenCodeServer: () => Effect.succeed({ url: "http://test.invalid", external: true }),
+      createOpenCodeSdkClient: () => client,
+    } as unknown as OpenCodeRuntimeShape,
+    idAllocator,
+    serverConfig: {
+      cwd: "/workspace",
+      attachmentsDir: "/tmp/attachments",
+    } as ServerConfig["Service"],
+  });
+  const runtime = yield* adapter.openSession({
+    threadId,
+    providerSessionId: ProviderSessionId.make(`session-opencode-${suffix}`),
+    modelSelection,
+    runtimePolicy: policy,
+  });
+  const providerThread = yield* runtime.ensureThread({
+    threadId,
+    modelSelection,
+    runtimePolicy: policy,
+  });
+  const now = yield* DateTime.now;
+  const startTurn = () =>
+    runtime.startTurn({
+      appThread: {
+        id: threadId,
+        projectId: ProjectId.make(`project-opencode-${suffix}`),
+        title: suffix,
+        providerInstanceId: modelSelection.instanceId,
+        modelSelection,
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        branch: null,
+        worktreePath: null,
+        activeProviderThreadId: providerThread.id,
+        lineage: { parentThreadId: null, relationshipToParent: null, rootThreadId: threadId },
+        forkedFrom: null,
+        createdBy: "user",
+        creationSource: "web",
+        createdAt: now,
+        updatedAt: now,
+        archivedAt: null,
+        settledOverride: null,
+        settledAt: null,
+        lastVisitedAt: null,
+        deletedAt: null,
+      },
+      threadId,
+      runId: RunId.make(`run-opencode-${suffix}`),
+      runOrdinal: 1,
+      providerTurnOrdinal: 1,
+      attemptId: RunAttemptId.make(`attempt-opencode-${suffix}`),
+      rootNodeId: NodeId.make(`node-opencode-${suffix}`),
+      providerThread,
+      message: {
+        createdBy: "user",
+        creationSource: "web",
+        messageId: MessageId.make(`message-opencode-${suffix}`),
+        text: "hello",
+        attachments: [],
+      },
+      modelSelection,
+      runtimePolicy: policy,
+    });
+  return {
+    nativeSessionId,
+    now,
+    policy,
+    providerThread,
+    runId: RunId.make(`run-opencode-${suffix}`),
+    runtime,
+    startTurn,
+    threadId,
+  };
+});
+
+describe("OpenCodeAdapterV2", () => {
+  it.effect("keeps a newly admitted prompt alive across stale idle and delayed busy evidence", () =>
+    Effect.gen(function* () {
+      const idAllocator = yield* IdAllocatorV2;
+      const nativeEvents = asyncEventStream();
+      const prompt = promiseGate<void>();
+      const promptStarted = promiseGate<void>();
+      const steerPrompt = promiseGate<void>();
+      const steerPromptStarted = promiseGate<void>();
+      const stopPromptStarted = promiseGate<void>();
+      const statusCalled = promiseGate<void>();
+      const steerStatusCalled = promiseGate<void>();
+      const abortCalled = promiseGate<void>();
+      let status: "idle" | "busy" = "busy";
+      let promptCalls = 0;
+      let statusCalls = 0;
+      const promptInputs: Array<{ readonly messageID?: string }> = [];
+      const client = {
+        event: {
+          subscribe: async (_input: unknown, options: { signal?: AbortSignal }) => {
+            options.signal?.addEventListener("abort", () => nativeEvents.close(), { once: true });
+            return { stream: nativeEvents.stream };
+          },
+        },
+        session: {
+          create: async () => ({
+            data: { id: "native-opencode-race", time: { created: 1, updated: 1 } },
+          }),
+          promptAsync: async (
+            input: { readonly messageID?: string },
+            options?: { readonly signal?: AbortSignal },
+          ) => {
+            promptInputs.push(input);
+            promptCalls += 1;
+            if (promptCalls === 1) {
+              promptStarted.resolve();
+              await prompt.promise;
+            } else if (promptCalls === 2) {
+              steerPromptStarted.resolve();
+              await steerPrompt.promise;
+            } else {
+              stopPromptStarted.resolve();
+              await new Promise<void>((_resolve, reject) =>
+                options?.signal?.addEventListener("abort", () => reject(options.signal!.reason), {
+                  once: true,
+                }),
+              );
+            }
+            return { data: true };
+          },
+          status: async () => ({
+            data: (() => {
+              statusCalls += 1;
+              if (statusCalls === 1) statusCalled.resolve();
+              else steerStatusCalled.resolve();
+              return { "native-opencode-race": { type: status } };
+            })(),
+          }),
+          messages: async () => ({ data: [] }),
+          abort: async () => {
+            abortCalled.resolve();
+            return { data: true };
+          },
+        },
+        mcp: { add: async () => ({ data: true }) },
+      };
+      const adapter = makeOpenCodeAdapterV2({
+        instanceId: ProviderInstanceId.make("opencode-test"),
+        settings: OPEN_CODE_TEST_SETTINGS,
+        environment: {},
+        runtime: {
+          connectToOpenCodeServer: () =>
+            Effect.succeed({ url: "http://test.invalid", external: true }),
+          createOpenCodeSdkClient: () => client,
+        } as unknown as OpenCodeRuntimeShape,
+        idAllocator,
+        serverConfig: {
+          cwd: "/workspace",
+          attachmentsDir: "/tmp/attachments",
+        } as ServerConfig["Service"],
+      });
+      const threadId = ThreadId.make("thread-opencode-admission-race");
+      const providerSessionId = ProviderSessionId.make("session-opencode-admission-race");
+      const modelSelection = {
+        instanceId: ProviderInstanceId.make("opencode-test"),
+        model: "anthropic/claude-sonnet",
+        options: [],
+      };
+      const policy = runtimePolicy("full-access", { cwd: "/workspace" });
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId,
+        modelSelection,
+        runtimePolicy: policy,
+      });
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy: policy,
+      });
+      const now = yield* DateTime.now;
+      const attemptId = RunAttemptId.make("attempt-opencode-admission-race");
+      const runId = RunId.make("run-opencode-admission-race");
+      const start = yield* runtime
+        .startTurn({
+          appThread: {
+            id: threadId,
+            projectId: ProjectId.make("project-opencode-admission-race"),
+            title: "race",
+            providerInstanceId: modelSelection.instanceId,
+            modelSelection,
+            runtimeMode: "full-access",
+            interactionMode: "default",
+            branch: null,
+            worktreePath: null,
+            activeProviderThreadId: providerThread.id,
+            lineage: { parentThreadId: null, relationshipToParent: null, rootThreadId: threadId },
+            forkedFrom: null,
+            createdBy: "user",
+            creationSource: "web",
+            createdAt: now,
+            updatedAt: now,
+            archivedAt: null,
+            settledOverride: null,
+            settledAt: null,
+            lastVisitedAt: null,
+            deletedAt: null,
+          },
+          threadId,
+          runId,
+          runOrdinal: 1,
+          providerTurnOrdinal: 1,
+          attemptId,
+          rootNodeId: NodeId.make("node-opencode-admission-race"),
+          providerThread,
+          message: {
+            createdBy: "user",
+            creationSource: "web",
+            messageId: MessageId.make("message-opencode-admission-race"),
+            text: "hello",
+            attachments: [],
+          },
+          modelSelection,
+          runtimePolicy: policy,
+        })
+        .pipe(Effect.forkScoped);
+
+      yield* Effect.promise(() => promptStarted.promise);
+      yield* Effect.promise(() =>
+        nativeEvents.push({
+          type: "session.status",
+          properties: { sessionID: "native-opencode-race", status: { type: "idle" } },
+        }),
+      );
+      prompt.resolve();
+      yield* Fiber.join(start);
+      assert.match(promptInputs[0]?.messageID ?? "", /^msg_[0-9a-f]{12}[0-9A-Za-z]{28}$/);
+      yield* Effect.promise(() =>
+        nativeEvents.push({
+          type: "session.status",
+          properties: { sessionID: "native-opencode-race", status: { type: "busy" } },
+        }),
+      );
+      status = "busy";
+      yield* Effect.promise(() =>
+        nativeEvents.push({
+          type: "message.updated",
+          properties: {
+            sessionID: "native-opencode-race",
+            info: {
+              id: "stale-user-message",
+              sessionID: "native-opencode-race",
+              role: "user",
+              time: { created: DateTime.toEpochMillis(now) },
+            },
+          },
+        }),
+      );
+      yield* Effect.promise(() =>
+        nativeEvents.push({
+          type: "session.status",
+          properties: { sessionID: "native-opencode-race", status: { type: "idle" } },
+        }),
+      );
+      yield* Effect.promise(() =>
+        nativeEvents.push({
+          type: "message.updated",
+          properties: {
+            sessionID: "native-opencode-race",
+            info: {
+              id: promptInputs[0]!.messageID!,
+              sessionID: "native-opencode-race",
+              role: "user",
+              time: { created: DateTime.toEpochMillis(now) },
+            },
+          },
+        }),
+      );
+
+      yield* Effect.promise(() => statusCalled.promise);
+
+      const snapshot = yield* runtime.readThreadSnapshot({ providerThread });
+      assert.equal(snapshot.providerTurns.at(-1)?.status, "running");
+      const activeTurn = snapshot.providerTurns.at(-1)!;
+      const steer = yield* runtime
+        .steerTurn({
+          threadId,
+          runId,
+          providerThread,
+          providerTurnId: activeTurn.id,
+          message: {
+            messageId: MessageId.make("message-opencode-steer-race"),
+            text: "follow up",
+            attachments: [],
+            createdBy: "user",
+            creationSource: "web",
+          },
+        })
+        .pipe(Effect.forkScoped);
+      yield* Effect.promise(() => steerPromptStarted.promise);
+      assert.notEqual(promptInputs[1]?.messageID, promptInputs[0]?.messageID);
+      steerPrompt.resolve();
+      yield* Fiber.join(steer);
+      yield* Effect.promise(() =>
+        nativeEvents.push({
+          type: "session.status",
+          properties: { sessionID: "native-opencode-race", status: { type: "busy" } },
+        }),
+      );
+      yield* Effect.promise(() =>
+        nativeEvents.push({
+          type: "message.updated",
+          properties: {
+            sessionID: "native-opencode-race",
+            info: {
+              id: promptInputs[0]!.messageID!,
+              sessionID: "native-opencode-race",
+              role: "user",
+              time: { created: DateTime.toEpochMillis(now) },
+            },
+          },
+        }),
+      );
+      yield* Effect.promise(() =>
+        nativeEvents.push({
+          type: "session.status",
+          properties: { sessionID: "native-opencode-race", status: { type: "idle" } },
+        }),
+      );
+      yield* Effect.promise(() =>
+        nativeEvents.push({
+          type: "message.updated",
+          properties: {
+            sessionID: "native-opencode-race",
+            info: {
+              id: promptInputs[1]!.messageID!,
+              sessionID: "native-opencode-race",
+              role: "user",
+              time: { created: DateTime.toEpochMillis(now) },
+            },
+          },
+        }),
+      );
+      yield* Effect.promise(() => steerStatusCalled.promise);
+      const pendingSteer = yield* runtime
+        .steerTurn({
+          threadId,
+          runId,
+          providerThread,
+          providerTurnId: activeTurn.id,
+          message: {
+            messageId: MessageId.make("message-opencode-stop-pending"),
+            text: "pending when stopped",
+            attachments: [],
+            createdBy: "user",
+            creationSource: "web",
+          },
+        })
+        .pipe(Effect.exit, Effect.forkScoped);
+      yield* Effect.promise(() => stopPromptStarted.promise);
+      const interrupt = yield* runtime
+        .interruptTurn({ providerThread, providerTurnId: activeTurn.id })
+        .pipe(Effect.forkScoped);
+      yield* Effect.promise(() => abortCalled.promise);
+      yield* Fiber.join(interrupt);
+      assert.isTrue(Exit.isFailure(yield* Fiber.join(pendingSteer)));
+      const promptWhileStopping = yield* Effect.exit(
+        runtime.steerTurn({
+          threadId,
+          runId,
+          providerThread,
+          providerTurnId: activeTurn.id,
+          message: {
+            messageId: MessageId.make("message-opencode-after-stop"),
+            text: "must not pass the pending stop",
+            attachments: [],
+            createdBy: "user",
+            creationSource: "web",
+          },
+        }),
+      );
+      assert.isTrue(Exit.isFailure(promptWhileStopping));
+      assert.equal(promptCalls, 3);
+      yield* Effect.promise(() =>
+        nativeEvents.push({
+          type: "session.status",
+          properties: { sessionID: "native-opencode-race", status: { type: "idle" } },
+        }),
+      );
+      const interrupted = yield* runtime.readThreadSnapshot({ providerThread });
+      assert.equal(interrupted.providerTurns.at(-1)?.status, "interrupted");
+    }).pipe(Effect.provide(idAllocatorLayer), Effect.scoped),
+  );
+
+  it.effect("interrupts an initial prompt while its SDK request is pending", () =>
+    Effect.gen(function* () {
+      const idAllocator = yield* IdAllocatorV2;
+      const nativeEvents = asyncEventStream();
+      const promptStarted = promiseGate<void>();
+      const abortCalled = promiseGate<void>();
+      let abortCalls = 0;
+      const client = {
+        event: {
+          subscribe: async (_input: unknown, options: { signal?: AbortSignal }) => {
+            options.signal?.addEventListener("abort", () => nativeEvents.close(), { once: true });
+            return { stream: nativeEvents.stream };
+          },
+        },
+        session: {
+          create: async () => ({
+            data: { id: "native-opencode-initial-stop", time: { created: 1, updated: 1 } },
+          }),
+          promptAsync: async (_input: unknown, options?: { readonly signal?: AbortSignal }) => {
+            promptStarted.resolve();
+            await new Promise<void>((_resolve, reject) => {
+              const signal = options?.signal;
+              if (signal?.aborted) {
+                reject(signal.reason);
+                return;
+              }
+              signal?.addEventListener("abort", () => reject(signal.reason), { once: true });
+            });
+            return { data: true };
+          },
+          status: async () => ({
+            data: { "native-opencode-initial-stop": { type: "idle" as const } },
+          }),
+          messages: async () => ({ data: [] }),
+          abort: async () => {
+            abortCalls += 1;
+            abortCalled.resolve();
+            return { data: true };
+          },
+        },
+        mcp: { add: async () => ({ data: true }) },
+      };
+      const adapter = makeOpenCodeAdapterV2({
+        instanceId: ProviderInstanceId.make("opencode-initial-stop-test"),
+        settings: OPEN_CODE_TEST_SETTINGS,
+        environment: {},
+        runtime: {
+          connectToOpenCodeServer: () =>
+            Effect.succeed({ url: "http://test.invalid", external: true }),
+          createOpenCodeSdkClient: () => client,
+        } as unknown as OpenCodeRuntimeShape,
+        idAllocator,
+        serverConfig: {
+          cwd: "/workspace",
+          attachmentsDir: "/tmp/attachments",
+        } as ServerConfig["Service"],
+      });
+      const threadId = ThreadId.make("thread-opencode-initial-stop");
+      const providerSessionId = ProviderSessionId.make("session-opencode-initial-stop");
+      const modelSelection = {
+        instanceId: ProviderInstanceId.make("opencode-initial-stop-test"),
+        model: "anthropic/claude-sonnet",
+        options: [],
+      };
+      const policy = runtimePolicy("full-access", { cwd: "/workspace" });
+      const runtime = yield* adapter.openSession({
+        threadId,
+        providerSessionId,
+        modelSelection,
+        runtimePolicy: policy,
+      });
+      const providerThread = yield* runtime.ensureThread({
+        threadId,
+        modelSelection,
+        runtimePolicy: policy,
+      });
+      const terminalEvents = yield* runtime.events.pipe(
+        Stream.takeUntil((event) => event.type === "turn.terminal"),
+        Stream.runCollect,
+        Effect.forkScoped,
+      );
+      const now = yield* DateTime.now;
+      const start = yield* runtime
+        .startTurn({
+          appThread: {
+            id: threadId,
+            projectId: ProjectId.make("project-opencode-initial-stop"),
+            title: "initial stop",
+            providerInstanceId: modelSelection.instanceId,
+            modelSelection,
+            runtimeMode: "full-access",
+            interactionMode: "default",
+            branch: null,
+            worktreePath: null,
+            activeProviderThreadId: providerThread.id,
+            lineage: { parentThreadId: null, relationshipToParent: null, rootThreadId: threadId },
+            forkedFrom: null,
+            createdBy: "user",
+            creationSource: "web",
+            createdAt: now,
+            updatedAt: now,
+            archivedAt: null,
+            settledOverride: null,
+            settledAt: null,
+            lastVisitedAt: null,
+            deletedAt: null,
+          },
+          threadId,
+          runId: RunId.make("run-opencode-initial-stop"),
+          runOrdinal: 1,
+          providerTurnOrdinal: 1,
+          attemptId: RunAttemptId.make("attempt-opencode-initial-stop"),
+          rootNodeId: NodeId.make("node-opencode-initial-stop"),
+          providerThread,
+          message: {
+            createdBy: "user",
+            creationSource: "web",
+            messageId: MessageId.make("message-opencode-initial-stop"),
+            text: "hello",
+            attachments: [],
+          },
+          modelSelection,
+          runtimePolicy: policy,
+        })
+        .pipe(Effect.forkScoped);
+
+      yield* Effect.promise(() => promptStarted.promise);
+      const running = yield* runtime.readThreadSnapshot({ providerThread });
+      const activeTurn = running.providerTurns.at(-1)!;
+      const interrupt = yield* runtime
+        .interruptTurn({ providerThread, providerTurnId: activeTurn.id })
+        .pipe(Effect.forkScoped);
+
+      yield* Effect.promise(() => abortCalled.promise);
+      yield* Fiber.join(start);
+      yield* Fiber.join(interrupt);
+      yield* Effect.promise(() =>
+        nativeEvents.push({
+          type: "session.status",
+          properties: {
+            sessionID: "native-opencode-initial-stop",
+            status: { type: "idle" },
+          },
+        }),
+      );
+
+      const events = Array.from(yield* Fiber.join(terminalEvents));
+      const terminals = events.filter((event) => event.type === "turn.terminal");
+      assert.equal(abortCalls, 1);
+      assert.lengthOf(terminals, 1);
+      assert.equal(terminals[0]?.status, "interrupted");
+      assert.isNull(terminals[0]?.failure ?? null);
+      assert.isFalse(
+        events.some(
+          (event) =>
+            (event.type === "turn.terminal" && event.status === "failed") ||
+            (event.type === "provider_session.updated" && event.providerSession.status === "error"),
+        ),
+      );
+    }).pipe(Effect.provide(idAllocatorLayer), Effect.scoped),
+  );
+
+  it("holds stale idle through prompt admission until the new user message is observed", () => {
+    const admission = {
+      admissionPending: true,
+      admissionAccepted: false,
+      admissionMessageObserved: false,
+      idleDuringAdmission: false,
+    };
+
+    assert.equal(advanceOpenCodePromptAdmission(admission, "idle"), "hold");
+    assert.equal(advanceOpenCodePromptAdmission(admission, "accepted"), "hold");
+    assert.isTrue(admission.admissionPending);
+    assert.equal(advanceOpenCodePromptAdmission(admission, "user-message"), "reconcile-idle");
+    assert.isTrue(admission.admissionPending);
+  });
+
+  it("releases admission only after prompt acceptance and new-turn evidence", () => {
+    const admission = {
+      admissionPending: true,
+      admissionAccepted: false,
+      admissionMessageObserved: false,
+      idleDuringAdmission: false,
+    };
+
+    assert.equal(advanceOpenCodePromptAdmission(admission, "busy"), "hold");
+    assert.equal(advanceOpenCodePromptAdmission(admission, "accepted"), "release");
+    assert.isFalse(admission.admissionPending);
+  });
+
+  it("invalidates pending admission before aborting a turn", () => {
+    const admission = {
+      admissionGeneration: 4,
+      admissionPending: true,
+      admissionAccepted: false,
+      admissionMessageObserved: false,
+      idleDuringAdmission: false,
+    };
+
+    cancelOpenCodePromptAdmission(admission, 5);
+
+    assert.equal(admission.admissionGeneration, 5);
+    assert.isFalse(admission.admissionPending);
+    assert.equal(advanceOpenCodePromptAdmission(admission, "accepted"), "release");
+  });
+
+  it.effect("reconciles current idle and busy status replies after prompt admission", () =>
+    Effect.gen(function* () {
+      for (const expected of ["idle", "busy"] as const) {
+        const admission = { admissionGeneration: 4, admissionPending: true };
+        const status = yield* Deferred.make<"idle" | "busy" | "unknown">();
+        const fiber = yield* reconcileOpenCodePromptAdmissionStatus(
+          admission,
+          4,
+          Deferred.await(status),
+        ).pipe(Effect.forkChild({ startImmediately: true }));
+
+        yield* Deferred.succeed(status, expected);
+
+        assert.equal(yield* Fiber.join(fiber), expected);
+        assert.isFalse(admission.admissionPending);
+      }
+    }),
+  );
+
+  it.effect("keeps admission pending after a transient status failure", () =>
+    Effect.gen(function* () {
+      const admission = { admissionGeneration: 4, admissionPending: true };
+      assert.equal(
+        yield* reconcileOpenCodePromptAdmissionStatus(admission, 4, Effect.succeed("unknown")),
+        "unknown",
+      );
+      assert.isTrue(admission.admissionPending);
+      assert.equal(
+        yield* reconcileOpenCodePromptAdmissionStatus(admission, 4, Effect.succeed("idle")),
+        "idle",
+      );
+      assert.isFalse(admission.admissionPending);
+    }),
+  );
+
+  it.effect("retries a transient status failure without another idle event", () =>
+    Effect.gen(function* () {
+      const nativeSessionId = "native-opencode-status-retry";
+      const nativeEvents = asyncEventStream();
+      const promptRelease = promiseGate<void>();
+      const promptCalls = yield* Queue.unbounded<string>();
+      const statusCalls = yield* Queue.unbounded<number>();
+      let statusCallCount = 0;
+      const client = {
+        event: {
+          subscribe: async (_input: unknown, options: { signal?: AbortSignal }) => {
+            options.signal?.addEventListener("abort", () => nativeEvents.close(), { once: true });
+            return { stream: nativeEvents.stream };
+          },
+        },
+        session: {
+          create: async () => ({
+            data: { id: nativeSessionId, time: { created: 1, updated: 1 } },
+          }),
+          promptAsync: async (input: { readonly messageID?: string }) => {
+            Queue.offerUnsafe(promptCalls, input.messageID!);
+            await promptRelease.promise;
+            return { data: true };
+          },
+          status: async () => {
+            statusCallCount += 1;
+            Queue.offerUnsafe(statusCalls, statusCallCount);
+            if (statusCallCount === 1) throw new Error("transient status failure");
+            return { data: { [nativeSessionId]: { type: "idle" as const } } };
+          },
+          messages: async () => ({ data: [] }),
+          abort: async () => ({ data: true }),
+        },
+        mcp: { add: async () => ({ data: true }) },
+      };
+      const harness = yield* makeOpenCodeRuntimeHarness("status-retry", nativeSessionId, client);
+      const terminalEvents = yield* harness.runtime.events.pipe(
+        Stream.takeUntil((event) => event.type === "turn.terminal"),
+        Stream.runCollect,
+        Effect.forkScoped,
+      );
+      const start = yield* harness.startTurn().pipe(Effect.forkScoped);
+      const admissionMessageId = yield* Queue.take(promptCalls);
+
+      yield* Effect.promise(() =>
+        nativeEvents.push({
+          type: "session.status",
+          properties: { sessionID: nativeSessionId, status: { type: "idle" } },
+        }),
+      );
+      promptRelease.resolve();
+      yield* Fiber.join(start);
+      const userMessage = {
+        type: "message.updated",
+        properties: {
+          sessionID: nativeSessionId,
+          info: {
+            id: admissionMessageId,
+            sessionID: nativeSessionId,
+            role: "user",
+            time: { created: DateTime.toEpochMillis(harness.now) },
+          },
+        },
+      };
+      yield* Effect.promise(() => nativeEvents.push(userMessage));
+      assert.equal(yield* Queue.take(statusCalls), 1);
+
+      yield* Effect.promise(() => nativeEvents.push(userMessage));
+      assert.equal(statusCallCount, 1, "duplicate events must share the generation's retry worker");
+      yield* TestClock.adjust("250 millis");
+      assert.equal(yield* Queue.take(statusCalls), 2);
+
+      const events = Array.from(yield* Fiber.join(terminalEvents));
+      const terminals = events.filter((event) => event.type === "turn.terminal");
+      assert.equal(statusCallCount, 2);
+      assert.lengthOf(terminals, 1);
+      assert.equal(terminals[0]?.status, "completed");
+      assert.isNull(terminals[0]?.failure ?? null);
+    }).pipe(Effect.provide(idAllocatorLayer), Effect.scoped),
+  );
+
+  it.effect("does not let a queued status retry adopt a newer steer generation", () =>
+    Effect.gen(function* () {
+      const nativeSessionId = "native-opencode-stale-status-retry";
+      const nativeEvents = asyncEventStream();
+      const firstPromptRelease = promiseGate<void>();
+      const promptCalls = yield* Queue.unbounded<string>();
+      const statusCalls = yield* Queue.unbounded<number>();
+      let promptCallCount = 0;
+      let statusCallCount = 0;
+      const client = {
+        event: {
+          subscribe: async (_input: unknown, options: { signal?: AbortSignal }) => {
+            options.signal?.addEventListener("abort", () => nativeEvents.close(), { once: true });
+            return { stream: nativeEvents.stream };
+          },
+        },
+        session: {
+          create: async () => ({
+            data: { id: nativeSessionId, time: { created: 1, updated: 1 } },
+          }),
+          promptAsync: async (input: { readonly messageID?: string }) => {
+            promptCallCount += 1;
+            Queue.offerUnsafe(promptCalls, input.messageID!);
+            if (promptCallCount === 1) {
+              await firstPromptRelease.promise;
+            }
+            return { data: true };
+          },
+          status: async () => {
+            statusCallCount += 1;
+            Queue.offerUnsafe(statusCalls, statusCallCount);
+            if (statusCallCount === 1) throw new Error("transient status failure");
+            return { data: { [nativeSessionId]: { type: "idle" as const } } };
+          },
+          messages: async () => ({ data: [] }),
+          abort: async () => ({ data: true }),
+        },
+        mcp: { add: async () => ({ data: true }) },
+      };
+      const harness = yield* makeOpenCodeRuntimeHarness(
+        "stale-status-retry",
+        nativeSessionId,
+        client,
+      );
+      const start = yield* harness.startTurn().pipe(Effect.forkScoped);
+      const firstAdmissionMessageId = yield* Queue.take(promptCalls);
+
+      yield* Effect.promise(() =>
+        nativeEvents.push({
+          type: "session.status",
+          properties: { sessionID: nativeSessionId, status: { type: "idle" } },
+        }),
+      );
+      firstPromptRelease.resolve();
+      yield* Fiber.join(start);
+      yield* Effect.promise(() =>
+        nativeEvents.push({
+          type: "message.updated",
+          properties: {
+            sessionID: nativeSessionId,
+            info: {
+              id: firstAdmissionMessageId,
+              sessionID: nativeSessionId,
+              role: "user",
+              time: { created: DateTime.toEpochMillis(harness.now) },
+            },
+          },
+        }),
+      );
+      assert.equal(yield* Queue.take(statusCalls), 1);
+
+      const running = yield* harness.runtime.readThreadSnapshot({
+        providerThread: harness.providerThread,
+      });
+      const activeTurn = running.providerTurns.at(-1)!;
+      yield* harness.runtime.steerTurn({
+        threadId: harness.threadId,
+        runId: harness.runId,
+        providerThread: harness.providerThread,
+        providerTurnId: activeTurn.id,
+        message: {
+          messageId: MessageId.make("message-opencode-stale-status-retry-steer"),
+          text: "new generation",
+          attachments: [],
+          createdBy: "user",
+          creationSource: "web",
+        },
+      });
+      yield* Queue.take(promptCalls);
+      yield* TestClock.adjust("250 millis");
+
+      const afterRetry = yield* harness.runtime.readThreadSnapshot({
+        providerThread: harness.providerThread,
+      });
+      assert.equal(statusCallCount, 1);
+      assert.equal(afterRetry.providerTurns.at(-1)?.status, "running");
+    }).pipe(Effect.provide(idAllocatorLayer), Effect.scoped),
+  );
+
+  it.effect("ignores a delayed status reply after steering starts a newer admission", () =>
+    Effect.gen(function* () {
+      const admission = { admissionGeneration: 4, admissionPending: true };
+      const status = yield* Deferred.make<"idle" | "busy" | "unknown">();
+      const fiber = yield* reconcileOpenCodePromptAdmissionStatus(
+        admission,
+        4,
+        Deferred.await(status),
+      ).pipe(Effect.forkChild({ startImmediately: true }));
+
+      admission.admissionGeneration = 5;
+      admission.admissionPending = true;
+      yield* Deferred.succeed(status, "idle");
+
+      assert.equal(yield* Fiber.join(fiber), "stale");
+      assert.equal(admission.admissionGeneration, 5);
+      assert.isTrue(admission.admissionPending);
+    }),
+  );
+
+  it.effect("does not revive admission when abort wins a pending status lookup", () =>
+    Effect.gen(function* () {
+      const admission = { admissionGeneration: 4, admissionPending: true };
+      const status = yield* Deferred.make<"idle" | "busy" | "unknown">();
+      const fiber = yield* reconcileOpenCodePromptAdmissionStatus(
+        admission,
+        4,
+        Deferred.await(status),
+      ).pipe(Effect.forkChild({ startImmediately: true }));
+
+      cancelOpenCodePromptAdmission(admission, 5);
+      yield* Deferred.succeed(status, "idle");
+
+      assert.equal(yield* Fiber.join(fiber), "stale");
+      assert.isFalse(admission.admissionPending);
+    }),
+  );
+
+  it.effect("logs bounded structural protocol diagnostics without native payload values", () =>
+    Effect.gen(function* () {
+      const idAllocator = yield* IdAllocatorV2;
+      const records: Array<unknown> = [];
+      const nativeEventLogger: EventNdjsonLogger = {
+        filePath: "/tmp/provider-native.ndjson",
+        write: (event) => Effect.sync(() => void records.push(event)),
+        close: () => Effect.void,
+      };
+      const logProtocolEvent = makeOpenCodeProtocolLogger({
+        nativeEventLogger,
+        idAllocator,
+        providerInstanceId: ProviderInstanceId.make("opencode-test"),
+        providerSessionId: ProviderSessionId.make("provider-session-opencode-test"),
+        threadId: ThreadId.make("thread-opencode-test"),
+      });
+      const secret = "secret-opencode-prompt";
+
+      yield* logProtocolEvent({
+        direction: "outgoing",
+        messageKind: "request",
+        method: "session.prompt",
+        payload: { prompt: secret, nested: { token: secret } },
+      });
+
+      const serialized = encodeUnknownJson(records);
+      assert.notInclude(serialized, secret);
+      assert.include(serialized, '"protocol":"opencode-sdk.sse"');
+      assert.include(serialized, '"method":"session.prompt"');
+      assert.include(serialized, '"fieldCount":2');
+    }).pipe(Effect.provide(idAllocatorLayer)),
+  );
+
+  it("advertises the identity strengths exposed by the SDK boundary", () => {
+    assert.equal(OpenCodeProviderCapabilitiesV2.identity.nativeThreadIds, "strong");
+    assert.equal(OpenCodeProviderCapabilitiesV2.identity.nativeTurnIds, "weak");
+    assert.equal(OpenCodeProviderCapabilitiesV2.identity.nativeItemIds, "strong");
+    assert.equal(OpenCodeProviderCapabilitiesV2.identity.nativeRequestIds, "strong");
+    assert.isTrue(OpenCodeProviderCapabilitiesV2.threads.canForkFromTurn);
+    assert.isTrue(OpenCodeProviderCapabilitiesV2.turns.supportsActiveSteering);
+    assert.equal(OpenCodeProviderCapabilitiesV2.turns.terminalStatusQuality, "strong");
+    assert.isFalse(OpenCodeProviderCapabilitiesV2.subagents.canCloseSubagents);
+  });
+
+  it("maps native permission families to orchestration request kinds", () => {
+    assert.equal(openCodePermissionRequestKind("bash"), "command");
+    assert.equal(openCodePermissionRequestKind("read"), "file-read");
+    assert.equal(openCodePermissionRequestKind("grep"), "file-read");
+    assert.equal(openCodePermissionRequestKind("external_directory"), "file-read");
+    assert.equal(openCodePermissionRequestKind("external_directory", "edit"), "file-change");
+    assert.equal(openCodePermissionRequestKind("edit"), "file-change");
+    assert.equal(openCodePermissionRequestKind("apply_patch"), "file-change");
+    assert.equal(openCodePermissionRequestKind("todowrite"), "command");
+    assert.equal(openCodePermissionRequestKind("custom", "todowrite"), "command");
+  });
+
+  it("maps OpenCode tools to semantic turn-item families", () => {
+    assert.equal(openCodeToolProjectionKind("bash"), "command_execution");
+    assert.equal(openCodeToolProjectionKind("edit"), "file_change");
+    assert.equal(openCodeToolProjectionKind("read"), "file_search");
+    assert.equal(openCodeToolProjectionKind("lsp"), "file_search");
+    assert.equal(openCodeToolProjectionKind("websearch"), "web_search");
+    assert.equal(openCodeToolProjectionKind("codesearch"), "web_search");
+    assert.equal(openCodeToolProjectionKind("todowrite"), "dynamic_tool");
+    assert.equal(openCodeToolProjectionKind("custom_tool"), "dynamic_tool");
+  });
+
+  it("maps runtime modes to safe OpenCode permission rules", () => {
+    const approvalRequired = openCodePermissionRules(runtimePolicy("approval-required"));
+    assert.equal(permissionAction(approvalRequired, "read"), "allow");
+    assert.equal(permissionAction(approvalRequired, "edit"), "ask");
+    assert.equal(permissionAction(approvalRequired, "bash"), "ask");
+    assert.equal(permissionAction(approvalRequired, "doom_loop"), "ask");
+    assert.equal(permissionAction(approvalRequired, "unknown_plugin_tool"), "ask");
+    assert.equal(permissionAction(approvalRequired, "question"), "allow");
+
+    const autoAcceptEdits = openCodePermissionRules(runtimePolicy("auto-accept-edits"));
+    assert.equal(permissionAction(autoAcceptEdits, "edit"), "allow");
+    assert.equal(permissionAction(autoAcceptEdits, "bash"), "ask");
+
+    const fullAccess = openCodePermissionRules(runtimePolicy("full-access"));
+    assert.equal(permissionAction(fullAccess, "bash"), "allow");
+    assert.equal(permissionAction(fullAccess, "edit"), "allow");
+
+    const granularApproval = openCodePermissionRules(
+      runtimePolicy("full-access", {
+        approvalPolicy: { granular: { request_permissions: true } },
+      }),
+    );
+    assert.equal(permissionAction(granularApproval, "bash"), "ask");
+    assert.equal(permissionAction(granularApproval, "read"), "allow");
+
+    const approvalRequiredWorkspaceWrite = openCodePermissionRules(
+      runtimePolicy("approval-required", {
+        sandboxPolicy: {
+          type: "workspaceWrite",
+          writableRoots: ["/tmp/opencode-workspace"],
+          networkAccess: false,
+        },
+      }),
+    );
+    assert.equal(permissionAction(approvalRequiredWorkspaceWrite, "edit"), "ask");
+  });
+
+  it("enforces non-interactive sandbox policy through OpenCode permissions", () => {
+    const readOnly = openCodePermissionRules(
+      runtimePolicy("full-access", {
+        approvalPolicy: "never",
+        sandboxPolicy: {
+          type: "readOnly",
+          access: { type: "fullAccess" },
+          networkAccess: false,
+        },
+      }),
+    );
+    assert.equal(permissionAction(readOnly, "read"), "allow");
+    assert.equal(permissionAction(readOnly, "edit"), "deny");
+    assert.equal(permissionAction(readOnly, "bash"), "deny");
+    assert.equal(permissionAction(readOnly, "webfetch"), "deny");
+    assert.equal(permissionAction(readOnly, "doom_loop"), "deny");
+    assert.equal(permissionAction(readOnly, "unknown_plugin_tool"), "deny");
+    assert.equal(permissionAction(readOnly, "external_directory"), "allow");
+
+    const workspaceWrite = openCodePermissionRules(
+      runtimePolicy("auto-accept-edits", {
+        approvalPolicy: "never",
+        sandboxPolicy: {
+          type: "workspaceWrite",
+          writableRoots: ["/tmp/opencode-workspace"],
+          networkAccess: true,
+        },
+      }),
+    );
+    assert.equal(permissionAction(workspaceWrite, "edit"), "allow");
+    assert.equal(permissionAction(workspaceWrite, "bash"), "deny");
+    assert.equal(permissionAction(workspaceWrite, "webfetch"), "allow");
+    assert.deepInclude(workspaceWrite, {
+      permission: "external_directory",
+      pattern: "/tmp/opencode-workspace/*",
+      action: "allow",
+    });
+  });
+
+  it("preserves OpenCode's recursion guard on task-created child sessions", () => {
+    const childRules = openCodeChildPermissionRules(runtimePolicy("full-access"), [
+      { permission: "task", pattern: "*", action: "deny" },
+    ]);
+
+    assert.equal(permissionAction(childRules, "read"), "allow");
+    assert.equal(permissionAction(childRules, "bash"), "allow");
+    assert.equal(permissionAction(childRules, "task"), "deny");
+
+    const approvalRequiredPolicy = runtimePolicy("approval-required");
+    const parentRules = openCodePermissionRules(approvalRequiredPolicy);
+    const childApprovalRules = openCodeChildPermissionRules(approvalRequiredPolicy, [
+      ...parentRules.filter((rule) => rule.action === "deny"),
+      { permission: "task", pattern: "*", action: "deny" },
+    ]);
+    assert.equal(permissionAction(childApprovalRules, "bash"), "ask");
+    assert.equal(permissionAction(childApprovalRules, "task"), "deny");
+  });
+
+  it("uses the next native user message as the exclusive fork and revert boundary", () => {
+    const first = providerTurn({ id: "turn:first", ordinal: 1, nativeId: "msg-user-1" });
+    const synthetic = providerTurn({ id: "turn:synthetic", ordinal: 2, nativeId: null });
+    const third = providerTurn({ id: "turn:third", ordinal: 3, nativeId: "msg-user-3" });
+
+    assert.equal(
+      openCodeBoundaryAfterProviderTurn([third, first, synthetic], first.id),
+      "msg-user-3",
+    );
+    assert.isUndefined(openCodeBoundaryAfterProviderTurn([first, synthetic, third], third.id));
+  });
+});
diff --git a/apps/server/src/orchestration-v2/Adapters/OpenCodeAdapterV2.testkit.test.ts b/apps/server/src/orchestration-v2/Adapters/OpenCodeAdapterV2.testkit.test.ts
new file mode 100644
index 000000000000..0e819bcfb973
--- /dev/null
+++ b/apps/server/src/orchestration-v2/Adapters/OpenCodeAdapterV2.testkit.test.ts
@@ -0,0 +1,39 @@
+import { assert, describe, it } from "@effect/vitest";
+import * as Effect from "effect/Effect";
+
+import { OPENCODE_PROVIDER } from "./OpenCodeAdapterV2.ts";
+import {
+  OPENCODE_SDK_REPLAY_PROTOCOL,
+  OpenCodeReplayController,
+} from "./OpenCodeAdapterV2.testkit.ts";
+
+describe("OpenCodeAdapterV2 replay testkit", () => {
+  it.effect("stops an event stream when abort races with listener registration", () =>
+    Effect.gen(function* () {
+      let aborted = false;
+      const signal = {
+        get aborted() {
+          return aborted;
+        },
+        addEventListener: () => {
+          aborted = true;
+        },
+        removeEventListener: () => {},
+      } as unknown as AbortSignal;
+      const controller = new OpenCodeReplayController({
+        provider: OPENCODE_PROVIDER,
+        protocol: OPENCODE_SDK_REPLAY_PROTOCOL,
+        version: "test",
+        scenario: "abort-during-listener-registration",
+        entries: [],
+      });
+      const iterator = controller.events(signal)[Symbol.asyncIterator]();
+
+      const result = yield* Effect.promise(() => iterator.next()).pipe(
+        Effect.timeout("100 millis"),
+      );
+
+      assert.isTrue(result.done);
+    }),
+  );
+});
diff --git a/apps/server/src/orchestration-v2/Adapters/OpenCodeAdapterV2.testkit.ts b/apps/server/src/orchestration-v2/Adapters/OpenCodeAdapterV2.testkit.ts
new file mode 100644
index 000000000000..94614a1cb885
--- /dev/null
+++ b/apps/server/src/orchestration-v2/Adapters/OpenCodeAdapterV2.testkit.ts
@@ -0,0 +1,402 @@
+import type { Event as OpenCodeEvent, OpencodeClient } from "@opencode-ai/sdk/v2";
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import { ProviderReplayEntry, type ProviderReplayTranscript } from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as Duration from "effect/Duration";
+import * as Layer from "effect/Layer";
+import * as Schema from "effect/Schema";
+
+import { ServerConfig } from "../../config.ts";
+import {
+  OpenCodeRuntime,
+  OpenCodeRuntimeError,
+  type OpenCodeRuntimeShape,
+} from "../../provider/opencodeRuntime.ts";
+import {
+  NoOpProviderEventLoggers,
+  ProviderEventLoggers,
+} from "../../provider/Layers/ProviderEventLoggers.ts";
+import { layer as idAllocatorLayer } from "../IdAllocator.ts";
+import { ProviderAdapterDriverCreateError } from "../ProviderAdapterDriver.ts";
+import { makeDriverLayer as makeProviderAdapterRegistryDriverLayer } from "../ProviderAdapterRegistry.ts";
+import {
+  makeReplayServerConfig,
+  type OrchestratorV2ProviderReplayHarness,
+} from "../testkit/ProviderReplayHarness.ts";
+import {
+  OPENCODE_DEFAULT_INSTANCE_ID,
+  OPENCODE_DRIVER_KIND,
+  OPENCODE_PROVIDER,
+  OPENCODE_SDK_PROTOCOL,
+  OpenCodeAdapterV2Driver,
+} from "./OpenCodeAdapterV2.ts";
+
+export const OPENCODE_SDK_REPLAY_PROTOCOL = OPENCODE_SDK_PROTOCOL;
+
+const OpenCodeSdkReplayTranscript = Schema.Struct({
+  provider: Schema.Literal(OPENCODE_PROVIDER),
+  protocol: Schema.Literal(OPENCODE_SDK_REPLAY_PROTOCOL),
+  version: Schema.String,
+  scenario: Schema.String,
+  metadata: Schema.optional(Schema.Record(Schema.String, Schema.Unknown)),
+  entries: Schema.Array(ProviderReplayEntry),
+});
+export type OpenCodeSdkReplayTranscript = typeof OpenCodeSdkReplayTranscript.Type;
+const decodeOpenCodeSdkReplayTranscript = Schema.decodeUnknownEffect(OpenCodeSdkReplayTranscript);
+
+export class OpenCodeReplayTranscriptDecodeError extends Schema.TaggedErrorClass<OpenCodeReplayTranscriptDecodeError>()(
+  "OpenCodeReplayTranscriptDecodeError",
+  {
+    driver: Schema.optional(Schema.String),
+    protocol: Schema.optional(Schema.String),
+    scenario: Schema.optional(Schema.String),
+    cause: Schema.Defect(),
+  },
+) {
+  override get message(): string {
+    return `Failed to decode OpenCode replay transcript for scenario ${this.scenario ?? "<unknown>"}.`;
+  }
+}
+
+export class OpenCodeReplayMismatchError extends Schema.TaggedErrorClass<OpenCodeReplayMismatchError>()(
+  "OpenCodeReplayMismatchError",
+  {
+    scenario: Schema.String,
+    cursor: Schema.Number,
+    expected: Schema.Unknown,
+    actual: Schema.Unknown,
+  },
+) {
+  override get message(): string {
+    return `OpenCode replay frame mismatch at cursor ${this.cursor} in scenario ${this.scenario}.`;
+  }
+}
+
+export class OpenCodeReplayIncompleteError extends Schema.TaggedErrorClass<OpenCodeReplayIncompleteError>()(
+  "OpenCodeReplayIncompleteError",
+  {
+    scenario: Schema.String,
+    cursor: Schema.Number,
+    remaining: Schema.Number,
+  },
+) {
+  override get message(): string {
+    return `OpenCode replay ended with ${this.remaining} unconsumed entries in scenario ${this.scenario}.`;
+  }
+}
+
+export const OpenCodeReplayError = Schema.Union([
+  OpenCodeReplayTranscriptDecodeError,
+  OpenCodeReplayMismatchError,
+  OpenCodeReplayIncompleteError,
+]);
+export type OpenCodeReplayError = typeof OpenCodeReplayError.Type;
+export const OpenCodeOrchestratorReplayHarnessError = Schema.Union([
+  OpenCodeReplayError,
+  ProviderAdapterDriverCreateError,
+]);
+export type OpenCodeOrchestratorReplayHarnessError =
+  typeof OpenCodeOrchestratorReplayHarnessError.Type;
+
+function replayValueMatches(expected: unknown, actual: unknown): boolean {
+  if (expected === "<any>" || expected === "<workspace>") return true;
+  if (Array.isArray(expected)) {
+    return (
+      Array.isArray(actual) &&
+      expected.length === actual.length &&
+      expected.every((entry, index) => replayValueMatches(entry, actual[index]))
+    );
+  }
+  if (typeof expected === "object" && expected !== null) {
+    if (typeof actual !== "object" || actual === null) return false;
+    return Object.entries(expected).every(([key, value]) =>
+      replayValueMatches(value, (actual as Record<string, unknown>)[key]),
+    );
+  }
+  return Object.is(expected, actual);
+}
+
+function frameRecord(frame: unknown): Record<string, unknown> | null {
+  return typeof frame === "object" && frame !== null ? (frame as Record<string, unknown>) : null;
+}
+
+export class OpenCodeReplayController {
+  private cursor = 0;
+  private readonly waiters = new Set<() => void>();
+  private failure: unknown = null;
+  private readonly transcript: OpenCodeSdkReplayTranscript;
+
+  constructor(transcript: OpenCodeSdkReplayTranscript) {
+    this.transcript = transcript;
+  }
+
+  async expectOutbound(actual: unknown): Promise<void> {
+    try {
+      const entry = this.transcript.entries[this.cursor];
+      if (entry?.type !== "expect_outbound" || !replayValueMatches(entry.frame, actual)) {
+        throw new OpenCodeReplayMismatchError({
+          scenario: this.transcript.scenario,
+          cursor: this.cursor,
+          expected: entry?.type === "expect_outbound" ? entry.frame : (entry ?? null),
+          actual,
+        });
+      }
+      this.advance();
+    } catch (cause) {
+      this.fail(cause);
+      throw cause;
+    }
+  }
+
+  async response(operation: string): Promise<unknown> {
+    while (true) {
+      this.throwFailure();
+      const entry = this.transcript.entries[this.cursor];
+      if (entry?.type === "emit_inbound") {
+        const frame = frameRecord(entry.frame);
+        if (frame?.type === "sdk.response" && frame.operation === operation) {
+          if (entry.afterMs !== undefined && entry.afterMs > 0) {
+            await Effect.runPromise(Effect.sleep(Duration.millis(entry.afterMs)));
+          }
+          const data = frame.data;
+          this.advance();
+          return data;
+        }
+      }
+      if (entry?.type === "runtime_exit") {
+        const mismatch = new OpenCodeReplayMismatchError({
+          scenario: this.transcript.scenario,
+          cursor: this.cursor,
+          expected: { type: "sdk.response", operation },
+          actual: entry,
+        });
+        this.fail(mismatch);
+        throw mismatch;
+      }
+      await this.changed();
+    }
+  }
+
+  async *events(signal?: AbortSignal): AsyncIterable<OpenCodeEvent> {
+    while (true) {
+      if (signal?.aborted === true) return;
+      this.throwFailure();
+      const entry = this.transcript.entries[this.cursor];
+      if (entry?.type === "emit_inbound") {
+        const frame = frameRecord(entry.frame);
+        if (frame?.type === "sdk.event") {
+          if (entry.afterMs !== undefined && entry.afterMs > 0) {
+            await Effect.runPromise(Effect.sleep(Duration.millis(entry.afterMs)));
+          }
+          const event = frame.event as OpenCodeEvent;
+          this.advance();
+          yield event;
+          continue;
+        }
+      }
+      if (entry?.type === "runtime_exit") {
+        this.advance();
+        if (entry.status === "success") return;
+        const mismatch = new OpenCodeReplayMismatchError({
+          scenario: this.transcript.scenario,
+          cursor: this.cursor - 1,
+          expected: { status: "success" },
+          actual: entry,
+        });
+        this.fail(mismatch);
+        throw mismatch;
+      }
+      await this.changed(signal);
+    }
+  }
+
+  assertComplete(): void {
+    while (this.transcript.entries[this.cursor]?.type === "runtime_exit") {
+      const exit = this.transcript.entries[this.cursor];
+      if (exit?.type !== "runtime_exit" || exit.status !== "success") break;
+      this.cursor += 1;
+    }
+    this.throwFailure();
+    if (this.cursor !== this.transcript.entries.length) {
+      throw new OpenCodeReplayIncompleteError({
+        scenario: this.transcript.scenario,
+        cursor: this.cursor,
+        remaining: this.transcript.entries.length - this.cursor,
+      });
+    }
+  }
+
+  private advance(): void {
+    this.cursor += 1;
+    for (const waiter of this.waiters) waiter();
+    this.waiters.clear();
+  }
+
+  private fail(cause: unknown): void {
+    this.failure = cause;
+    for (const waiter of this.waiters) waiter();
+    this.waiters.clear();
+  }
+
+  private throwFailure(): void {
+    if (this.failure !== null) throw this.failure;
+  }
+
+  private changed(signal?: AbortSignal): Promise<void> {
+    return new Promise((resolve) => {
+      let settled = false;
+      const done = () => {
+        if (settled) return;
+        settled = true;
+        signal?.removeEventListener("abort", done);
+        this.waiters.delete(done);
+        resolve();
+      };
+      this.waiters.add(done);
+      signal?.addEventListener("abort", done, { once: true });
+      if (signal?.aborted === true) done();
+    });
+  }
+}
+
+function makeReplayClient(controller: OpenCodeReplayController): OpencodeClient {
+  const request = async (operation: string, input: unknown) => {
+    await controller.expectOutbound({ type: operation, input });
+    return { data: await controller.response(operation) };
+  };
+  return {
+    event: {
+      subscribe: async (_input?: unknown, options?: { readonly signal?: AbortSignal }) => {
+        await controller.expectOutbound({ type: "event.subscribe" });
+        return { stream: controller.events(options?.signal) };
+      },
+    },
+    session: {
+      create: (input: unknown) => request("session.create", input),
+      get: (input: unknown) => request("session.get", input),
+      update: (input: unknown) => request("session.update", input),
+      messages: (input: unknown) => request("session.messages", input),
+      promptAsync: (input: unknown) => request("session.promptAsync", input),
+      abort: (input: unknown) => request("session.abort", input),
+      revert: (input: unknown) => request("session.revert", input),
+      unrevert: (input: unknown) => request("session.unrevert", input),
+      fork: (input: unknown) => request("session.fork", input),
+    },
+    permission: {
+      reply: (input: unknown) => request("permission.reply", input),
+    },
+    question: {
+      reply: (input: unknown) => request("question.reply", input),
+    },
+    mcp: {
+      add: (input: unknown) => request("mcp.add", input),
+    },
+  } as unknown as OpencodeClient;
+}
+
+function makeOpenCodeReplayRuntimeLayer(transcript: OpenCodeSdkReplayTranscript) {
+  return Layer.effect(
+    OpenCodeRuntime,
+    Effect.gen(function* () {
+      const controller = new OpenCodeReplayController(transcript);
+      yield* Effect.addFinalizer(() =>
+        Effect.sync(() => {
+          controller.assertComplete();
+        }),
+      );
+      const client = makeReplayClient(controller);
+      return OpenCodeRuntime.of({
+        startOpenCodeServerProcess: () =>
+          Effect.fail(
+            new OpenCodeRuntimeError({
+              operation: "startOpenCodeServerProcess",
+              detail: "OpenCode replay uses an external in-memory SDK boundary.",
+            }),
+          ),
+        connectToOpenCodeServer: () =>
+          Effect.succeed({
+            url: "replay://opencode",
+            version: "0.0.0-replay",
+            exitCode: null,
+            external: true,
+          }),
+        runOpenCodeCommand: () =>
+          Effect.fail(
+            new OpenCodeRuntimeError({
+              operation: "runOpenCodeCommand",
+              detail: "OpenCode replay does not execute commands.",
+            }),
+          ),
+        createOpenCodeSdkClient: () => client,
+        loadOpenCodeInventory: () =>
+          Effect.fail(
+            new OpenCodeRuntimeError({
+              operation: "loadOpenCodeInventory",
+              detail: "OpenCode replay does not load inventory.",
+            }),
+          ),
+        loadInventoryFromCli: () =>
+          Effect.fail(
+            new OpenCodeRuntimeError({
+              operation: "loadInventoryFromCli",
+              detail: "OpenCode replay does not load inventory.",
+            }),
+          ),
+      } satisfies OpenCodeRuntimeShape);
+    }),
+  );
+}
+
+export function makeOpenCodeProviderAdapterRegistryReplayLayer(
+  transcript: OpenCodeSdkReplayTranscript,
+) {
+  const serverConfigLayer = Layer.effect(
+    ServerConfig,
+    makeReplayServerConfig(transcript.scenario).pipe(Effect.orDie),
+  ).pipe(Layer.provide(NodeServices.layer));
+  return makeProviderAdapterRegistryDriverLayer({
+    drivers: [OpenCodeAdapterV2Driver],
+    configMap: {
+      [OPENCODE_DEFAULT_INSTANCE_ID]: {
+        driver: OPENCODE_DRIVER_KIND,
+        config: { serverUrl: "replay://opencode" },
+      },
+    },
+  }).pipe(
+    Layer.provide(
+      Layer.mergeAll(
+        makeOpenCodeReplayRuntimeLayer(transcript),
+        serverConfigLayer,
+        NodeServices.layer,
+        idAllocatorLayer,
+        Layer.succeed(ProviderEventLoggers, NoOpProviderEventLoggers),
+      ),
+    ),
+  );
+}
+
+function transcriptMetadata(transcript: ProviderReplayTranscript) {
+  return {
+    provider: transcript.provider,
+    protocol: transcript.protocol,
+    scenario: transcript.scenario,
+  };
+}
+
+export const OpenCodeOrchestratorReplayHarness: OrchestratorV2ProviderReplayHarness<
+  OpenCodeSdkReplayTranscript,
+  OpenCodeOrchestratorReplayHarnessError
+> = {
+  driver: OPENCODE_PROVIDER,
+  decodeTranscript: (transcript) =>
+    decodeOpenCodeSdkReplayTranscript(transcript).pipe(
+      Effect.mapError(
+        (cause) =>
+          new OpenCodeReplayTranscriptDecodeError({
+            ...transcriptMetadata(transcript),
+            cause,
+          }),
+      ),
+    ),
+  makeProviderAdapterRegistryLayer: makeOpenCodeProviderAdapterRegistryReplayLayer,
+};
diff --git a/apps/server/src/orchestration-v2/Adapters/OpenCodeAdapterV2.ts b/apps/server/src/orchestration-v2/Adapters/OpenCodeAdapterV2.ts
new file mode 100644
index 000000000000..adeb80d689a7
--- /dev/null
+++ b/apps/server/src/orchestration-v2/Adapters/OpenCodeAdapterV2.ts
@@ -0,0 +1,3305 @@
+import type {
+  Event as OpenCodeEvent,
+  Message as OpenCodeMessage,
+  Part as OpenCodePart,
+  PermissionRequest,
+  PermissionRuleset,
+  QuestionRequest,
+  Session as OpenCodeSession,
+  Todo as OpenCodeTodo,
+  ToolPart,
+} from "@opencode-ai/sdk/v2";
+import { HostProcessEnvironment } from "@t3tools/shared/hostProcess";
+import { getModelSelectionStringOptionValue } from "@t3tools/shared/model";
+import { causeErrorTag } from "@t3tools/shared/observability";
+import {
+  defaultInstanceIdForDriver,
+  type ModelSelection,
+  type OpenCodeSettings,
+  type OrchestrationV2AppThread,
+  type OrchestrationV2ConversationMessage,
+  type OrchestrationV2ExecutionNode,
+  type OrchestrationV2PlanStep,
+  type OrchestrationV2ProviderCapabilities,
+  type OrchestrationV2ProviderFailure,
+  type OrchestrationV2ProviderRef,
+  type OrchestrationV2ProviderSession,
+  type OrchestrationV2ProviderThread,
+  type OrchestrationV2ProviderTurn,
+  type OrchestrationV2RuntimeRequest,
+  type OrchestrationV2Subagent,
+  type OrchestrationV2TurnItem,
+  OpenCodeSettings as OpenCodeSettingsSchema,
+  type PlanId,
+  ProviderDriverKind,
+  type ProviderInstanceId,
+  type ProviderRequestKind,
+  type ProviderSessionId,
+  type RuntimeRequestId,
+  type ThreadId,
+} from "@t3tools/contracts";
+import * as Cause from "effect/Cause";
+import * as DateTime from "effect/DateTime";
+import * as Deferred from "effect/Deferred";
+import * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Queue from "effect/Queue";
+import * as Random from "effect/Random";
+import * as Schema from "effect/Schema";
+import * as Scope from "effect/Scope";
+import * as Stream from "effect/Stream";
+
+import { resolveAttachmentPath } from "../../attachmentStore.ts";
+import { ServerConfig } from "../../config.ts";
+import * as McpProviderSession from "../../mcp/McpProviderSession.ts";
+import type { EventNdjsonLogger } from "../../provider/Layers/EventNdjsonLogger.ts";
+import { ProviderEventLoggers } from "../../provider/Layers/ProviderEventLoggers.ts";
+import {
+  structuralProtocolMethod,
+  summarizeNativeProtocolPayload,
+} from "../../provider/NativeProtocolLogging.ts";
+import { mergeProviderInstanceEnvironment } from "../../provider/ProviderInstanceEnvironment.ts";
+import { t3OrchestrationSystemPrompt } from "../../provider/T3OrchestrationInstructions.ts";
+import {
+  OpenCodeRuntime,
+  OpenCodeRuntimeError,
+  openCodeQuestionId,
+  openCodeRuntimeErrorDetail,
+  parseOpenCodeModelSlug,
+  runOpenCodeSdk,
+  toOpenCodeFileParts,
+  toOpenCodePermissionReply,
+  toOpenCodeQuestionAnswers,
+  type OpenCodeRuntimeShape,
+} from "../../provider/opencodeRuntime.ts";
+import { IdAllocatorV2, type IdAllocatorV2Shape } from "../IdAllocator.ts";
+import { makeProviderFailure } from "../ProviderFailure.ts";
+import { turnScopedSelectionTransition } from "../ProviderSelectionTransition.ts";
+import { providerMessageTextWithAttachmentPaths } from "../AttachmentPrompt.ts";
+import {
+  ProviderAdapterEnsureThreadError,
+  ProviderAdapterForkThreadError,
+  ProviderAdapterInterruptError,
+  ProviderAdapterOpenSessionError,
+  ProviderAdapterProtocolError,
+  ProviderAdapterReadThreadSnapshotError,
+  ProviderAdapterResumeThreadError,
+  ProviderAdapterRollbackThreadError,
+  ProviderAdapterRuntimeRequestResponseError,
+  ProviderAdapterSteerRunError,
+  ProviderAdapterTurnStartError,
+  ProviderAdapterV2,
+  type ProviderAdapterV2Event,
+  type ProviderAdapterV2OpenSessionInput,
+  type ProviderAdapterV2SessionRuntime,
+  type ProviderAdapterV2Shape,
+  type ProviderAdapterV2RuntimePolicy,
+  type ProviderAdapterV2TurnInput,
+} from "../ProviderAdapter.ts";
+import {
+  ProviderAdapterDriverCreateError,
+  type ProviderAdapterDriver,
+  type ProviderAdapterDriverCreateInput,
+} from "../ProviderAdapterDriver.ts";
+import { makeSubagentChildThread, subagentThreadTitle } from "../SubagentProjection.ts";
+
+export const OPENCODE_PROVIDER = ProviderDriverKind.make("opencode");
+export const OPENCODE_DRIVER_KIND = OPENCODE_PROVIDER;
+export const OPENCODE_DEFAULT_INSTANCE_ID = defaultInstanceIdForDriver(OPENCODE_DRIVER_KIND);
+export const OPENCODE_SDK_PROTOCOL = "opencode-sdk.sse" as const;
+const DEFAULT_OPENCODE_SETTINGS = Schema.decodeSync(OpenCodeSettingsSchema)({});
+
+let openCodeMessageIdEpochMillis = -1;
+let openCodeMessageIdCounter = 0;
+
+const makeOpenCodeMessageId = Effect.fnUntraced(function* () {
+  const epochMillis = DateTime.toEpochMillis(yield* DateTime.now);
+  if (epochMillis !== openCodeMessageIdEpochMillis) {
+    openCodeMessageIdEpochMillis = epochMillis;
+    openCodeMessageIdCounter = 0;
+  }
+  openCodeMessageIdCounter += 1;
+  const encodedTime = BigInt.asUintN(
+    48,
+    BigInt(epochMillis) * 0x1000n + BigInt(openCodeMessageIdCounter),
+  )
+    .toString(16)
+    .padStart(12, "0");
+  const alphabet = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
+  const random = (yield* Effect.forEach(Array.from({ length: 28 }), () =>
+    Random.nextIntBetween(0, alphabet.length - 1),
+  ))
+    .map((index) => alphabet[index])
+    .join("");
+  return `msg_${encodedTime}${random}`;
+});
+
+/**
+ * OpenCode's session, message, part, and interaction-request identifiers are
+ * durable. It does not expose a first-class turn object: the initiating user
+ * message is the best native turn correlation point, and session idle is the
+ * authoritative terminal signal.
+ */
+export const OpenCodeProviderCapabilitiesV2 = {
+  sessions: {
+    // The current adapter owns one directory-bound client/server per session.
+    // Keep it isolated until its runtime is made safe for cross-thread pooling.
+    supportsMultipleProviderThreadsPerSession: false,
+    supportsModelSwitchInSession: true,
+    supportsProviderSwitchingViaHandoff: true,
+    supportsRuntimeModeSwitchInSession: false,
+    pendingRequestsSurviveRestart: false,
+  },
+  threads: {
+    canCreateEmptyThread: true,
+    canReadThreadSnapshot: true,
+    canRollbackThread: true,
+    canForkThread: true,
+    canForkFromTurn: true,
+    canForkFromSubagentThread: true,
+    exposesNativeThreadId: true,
+  },
+  turns: {
+    exposesNativeTurnId: false,
+    emitsTurnStarted: true,
+    emitsTurnCompleted: true,
+    supportsInterrupt: true,
+    supportsActiveSteering: true,
+    supportsSteeringByInterruptRestart: true,
+    supportsQueuedMessages: true,
+    terminalStatusQuality: "strong",
+  },
+  streaming: {
+    streamsAssistantText: true,
+    streamsReasoning: true,
+    streamsToolOutput: true,
+    streamsPlanText: false,
+    emitsMessageCompleted: true,
+  },
+  tools: {
+    exposesToolItemIds: true,
+    emitsToolStarted: true,
+    emitsToolCompleted: true,
+    emitsToolOutput: true,
+    supportsMcpTools: true,
+    supportsDynamicToolCallbacks: false,
+  },
+  approvals: {
+    supportsCommandApproval: true,
+    supportsFileReadApproval: true,
+    supportsFileChangeApproval: true,
+    supportsApplyPatchApproval: true,
+    approvalsHaveNativeRequestIds: true,
+    approvalCallbacksAreLiveOnly: true,
+    approvalsCanOriginateFromSubagents: true,
+  },
+  planning: {
+    emitsPlanUpdated: true,
+    emitsTodoList: true,
+    emitsProposedPlan: false,
+    supportsStructuredQuestions: true,
+    planDeltasHaveItemIds: false,
+  },
+  subagents: {
+    supportsSubagents: true,
+    exposesSubagentThreadIds: true,
+    emitsSubagentLifecycle: true,
+    canWaitForSubagents: true,
+    canCloseSubagents: false,
+    canForkSubagentThread: true,
+  },
+  context: {
+    acceptsSystemContext: false,
+    acceptsDeveloperContext: false,
+    acceptsSyntheticUserContext: true,
+    canGenerateSummaries: true,
+    canConsumeHandoffSummaries: true,
+    supportsDeltaHandoff: true,
+    supportsFullThreadHandoff: true,
+    maxRecommendedHandoffChars: null,
+  },
+  checkpointing: {
+    appCanCheckpointFilesystem: true,
+    supportsNestedCheckpointScopes: true,
+    providerCanRollbackConversation: true,
+    providerRollbackReturnsSnapshot: true,
+    providerCanReadConversationSnapshot: true,
+  },
+  identity: {
+    nativeThreadIds: "strong",
+    nativeTurnIds: "weak",
+    nativeItemIds: "strong",
+    nativeRequestIds: "strong",
+  },
+} satisfies OrchestrationV2ProviderCapabilities;
+
+type TerminalTurnStatus = Extract<
+  OrchestrationV2ProviderTurn["status"],
+  "completed" | "interrupted" | "failed" | "cancelled"
+>;
+
+interface ActiveOpenCodeTurn {
+  readonly isRoot: boolean;
+  readonly threadId: ThreadId;
+  readonly runId: ProviderAdapterV2TurnInput["runId"] | null;
+  readonly rootNodeId: ProviderAdapterV2TurnInput["rootNodeId"];
+  readonly appThread: OrchestrationV2AppThread;
+  readonly modelSelection: ModelSelection;
+  readonly runtimePolicy: ProviderAdapterV2RuntimePolicy;
+  readonly providerTurnId: OrchestrationV2ProviderTurn["id"];
+  readonly providerTurnOrdinal: number;
+  readonly runOrdinal: number;
+  readonly runAttemptId: OrchestrationV2ProviderTurn["runAttemptId"];
+  readonly startedAt: DateTime.Utc;
+  readonly itemOrdinals: Map<string, number>;
+  readonly parts: Map<string, OpenCodePart>;
+  readonly partIdsByMessage: Map<string, Set<string>>;
+  readonly providerTurn: OrchestrationV2ProviderTurn;
+  nextItemOrdinal: number;
+  nativeUserMessageId: string | null;
+  admissionMessageId: string | null;
+  interrupted: boolean;
+  finalized: boolean;
+  planId: PlanId | null;
+  admissionGeneration: number;
+  admissionReconciliationGeneration: number | null;
+  admissionPending: boolean;
+  admissionAccepted: boolean;
+  admissionMessageObserved: boolean;
+  idleDuringAdmission: boolean;
+  admissionSettled: Deferred.Deferred<void>;
+  admissionAbortController: AbortController | null;
+}
+
+type OpenCodeAdmissionSignal = "accepted" | "busy" | "idle" | "user-message";
+type OpenCodeAdmissionAction = "hold" | "reconcile-idle" | "release";
+
+export function advanceOpenCodePromptAdmission(
+  admission: Pick<
+    ActiveOpenCodeTurn,
+    "admissionAccepted" | "admissionMessageObserved" | "admissionPending" | "idleDuringAdmission"
+  >,
+  signal: OpenCodeAdmissionSignal,
+): OpenCodeAdmissionAction {
+  if (!admission.admissionPending) return "release";
+  if (signal === "idle") {
+    admission.idleDuringAdmission = true;
+    return "hold";
+  }
+  if (signal === "accepted") admission.admissionAccepted = true;
+  if (signal === "busy" || signal === "user-message") admission.admissionMessageObserved = true;
+  if (!admission.admissionAccepted || !admission.admissionMessageObserved) return "hold";
+  if (admission.idleDuringAdmission) return "reconcile-idle";
+  admission.admissionPending = false;
+  return "release";
+}
+
+export function cancelOpenCodePromptAdmission(
+  admission: Pick<ActiveOpenCodeTurn, "admissionGeneration" | "admissionPending">,
+  nextGeneration: number,
+): void {
+  admission.admissionGeneration = nextGeneration;
+  admission.admissionPending = false;
+}
+
+export const reconcileOpenCodePromptAdmissionStatus = Effect.fn(
+  "reconcileOpenCodePromptAdmissionStatus",
+)(function* (
+  admission: Pick<ActiveOpenCodeTurn, "admissionGeneration" | "admissionPending">,
+  generation: number,
+  readStatus: Effect.Effect<"busy" | "idle" | "unknown">,
+) {
+  if (admission.admissionGeneration !== generation || !admission.admissionPending) {
+    return "stale" as const;
+  }
+  const status = yield* readStatus;
+  if (admission.admissionGeneration !== generation || !admission.admissionPending) {
+    return "stale" as const;
+  }
+  if (status !== "unknown") admission.admissionPending = false;
+  return status;
+});
+
+interface OpenCodeSubagentContext {
+  readonly nativeItemId: string;
+  readonly nodeId: OrchestrationV2Subagent["id"];
+  readonly parentTurn: ActiveOpenCodeTurn;
+  readonly prompt: string;
+  readonly title: string | null;
+  readonly startedAt: DateTime.Utc;
+  childSessionId: string | null;
+  childThreadId: ThreadId | null;
+  childProviderThreadId: OrchestrationV2ProviderThread["id"] | null;
+  model: string | null;
+  result: string | null;
+}
+
+interface OpenCodeThreadState {
+  readonly nativeSessionId: string;
+  providerThread: OrchestrationV2ProviderThread;
+  appThread: OrchestrationV2AppThread | null;
+  activeTurn: ActiveOpenCodeTurn | null;
+  readonly providerTurns: Map<string, OrchestrationV2ProviderTurn>;
+  readonly messages: Map<string, OrchestrationV2ConversationMessage>;
+  readonly runtimeRequests: Map<string, OrchestrationV2RuntimeRequest>;
+  readonly messageRoles: Map<string, "user" | "assistant">;
+  readonly userMessageIds: Array<string>;
+  parentSubagent: OpenCodeSubagentContext | null;
+  nextChildTurnOrdinal: number;
+  nextAdmissionGeneration: number;
+}
+
+interface PendingOpenCodeRequest {
+  readonly requestId: RuntimeRequestId;
+  readonly nativeRequestId: string;
+  readonly turn: ActiveOpenCodeTurn;
+  readonly state: OpenCodeThreadState;
+  readonly nodeId: OrchestrationV2ExecutionNode["id"];
+  readonly turnItemId: OrchestrationV2TurnItem["id"];
+  readonly requestKind: OpenCodePermissionRequestKind | "user_input";
+  readonly createdAt: DateTime.Utc;
+  readonly permission?: PermissionRequest;
+  readonly question?: QuestionRequest;
+}
+
+export interface OpenCodeAdapterV2Options {
+  readonly instanceId: ProviderInstanceId;
+  readonly settings: OpenCodeSettings;
+  readonly environment: NodeJS.ProcessEnv;
+  readonly runtime: OpenCodeRuntimeShape;
+  readonly idAllocator: IdAllocatorV2Shape;
+  readonly serverConfig: ServerConfig["Service"];
+  readonly nativeEventLogger?: EventNdjsonLogger;
+}
+
+export interface OpenCodeProtocolLogEvent {
+  readonly direction: "incoming" | "outgoing";
+  readonly messageKind: "request" | "response" | "notification" | "error";
+  readonly method: string;
+  readonly payload: unknown;
+}
+
+export function formatOpenCodeProtocolLogPayload(event: OpenCodeProtocolLogEvent) {
+  return {
+    direction: event.direction,
+    messageKind: event.messageKind,
+    method: structuralProtocolMethod(event.method),
+    payload: summarizeNativeProtocolPayload(event.payload),
+  };
+}
+
+export function makeOpenCodeProtocolLogger(input: {
+  readonly nativeEventLogger: EventNdjsonLogger | undefined;
+  readonly idAllocator: IdAllocatorV2Shape;
+  readonly providerInstanceId: ProviderInstanceId;
+  readonly providerSessionId: ProviderSessionId;
+  readonly threadId: ThreadId;
+}): (event: OpenCodeProtocolLogEvent) => Effect.Effect<void, never> {
+  return (event) =>
+    Effect.gen(function* () {
+      if (!input.nativeEventLogger) return;
+      const observedAt = DateTime.formatIso(yield* DateTime.now);
+      const method = structuralProtocolMethod(event.method);
+      yield* input.nativeEventLogger.write(
+        {
+          observedAt,
+          event: {
+            id: yield* input.idAllocator.allocate.rawEvent({
+              providerSessionId: input.providerSessionId,
+              method,
+            }),
+            kind: "protocol",
+            protocol: OPENCODE_SDK_PROTOCOL,
+            provider: OPENCODE_PROVIDER,
+            providerInstanceId: input.providerInstanceId,
+            providerSessionId: input.providerSessionId,
+            createdAt: observedAt,
+            threadId: input.threadId,
+            payload: formatOpenCodeProtocolLogPayload(event),
+          },
+        },
+        input.threadId,
+      );
+    }).pipe(
+      Effect.catchCause((cause) =>
+        Cause.hasInterrupts(cause)
+          ? Effect.interrupt
+          : Effect.logWarning("Failed to write native OpenCode event log.", {
+              errorTag: causeErrorTag(cause),
+              reasonCount: cause.reasons.length,
+              provider: OPENCODE_PROVIDER,
+              threadId: input.threadId,
+            }),
+      ),
+    );
+}
+
+function protocolError(detail: string, payload?: unknown): ProviderAdapterProtocolError {
+  return new ProviderAdapterProtocolError({
+    driver: OPENCODE_PROVIDER,
+    detail,
+    ...(payload === undefined ? {} : { payload }),
+  });
+}
+
+function nativeThreadId(providerThread: OrchestrationV2ProviderThread): string {
+  const nativeId = providerThread.nativeThreadRef?.nativeId;
+  if (nativeId === null || nativeId === undefined) {
+    throw protocolError(`Provider thread ${providerThread.id} has no OpenCode session id`);
+  }
+  return nativeId;
+}
+
+function dateTimeFromEpoch(value: number | undefined, fallback: DateTime.Utc): DateTime.Utc {
+  if (value === undefined) return fallback;
+  return Option.getOrElse(DateTime.make(value), () => fallback);
+}
+
+function nonEmptyString(value: unknown): string | undefined {
+  return typeof value === "string" && value.trim().length > 0 ? value : undefined;
+}
+
+function recordValue(input: unknown, key: string): unknown {
+  return typeof input === "object" && input !== null && key in input
+    ? (input as Record<string, unknown>)[key]
+    : undefined;
+}
+
+function recordString(input: unknown, ...keys: ReadonlyArray<string>): string | undefined {
+  for (const key of keys) {
+    const value = nonEmptyString(recordValue(input, key));
+    if (value !== undefined) return value;
+  }
+  return undefined;
+}
+
+function recordNumber(input: unknown, ...keys: ReadonlyArray<string>): number | undefined {
+  for (const key of keys) {
+    const value = recordValue(input, key);
+    if (typeof value === "number" && Number.isFinite(value)) return value;
+  }
+  return undefined;
+}
+
+function stableJson(value: unknown): string {
+  if (typeof value === "string") return value;
+  try {
+    return JSON.stringify(value, null, 2);
+  } catch {
+    return String(value);
+  }
+}
+
+function sdkResponseForRawLog(value: unknown): unknown {
+  if (typeof value !== "object" || value === null) return value;
+  if ("data" in value) return { data: (value as { readonly data?: unknown }).data ?? null };
+  if ("stream" in value) return { subscribed: true };
+  return value;
+}
+
+type OpenCodePermissionRequestKind = Extract<
+  ProviderRequestKind,
+  "command" | "file-read" | "file-change"
+>;
+
+export function openCodePermissionRequestKind(
+  permission: string,
+  toolName?: string,
+): OpenCodePermissionRequestKind {
+  const normalized = permission.toLowerCase();
+  const normalizedTool = toolName?.toLowerCase() ?? "";
+  if (
+    normalized === "edit" ||
+    normalized === "write" ||
+    normalized === "patch" ||
+    normalized === "apply_patch" ||
+    normalizedTool === "edit" ||
+    normalizedTool === "write" ||
+    normalizedTool === "patch" ||
+    normalizedTool === "apply_patch"
+  ) {
+    return "file-change";
+  }
+  if (
+    normalized === "read" ||
+    normalized === "glob" ||
+    normalized === "grep" ||
+    normalized === "lsp" ||
+    normalized === "external_directory" ||
+    normalizedTool === "read" ||
+    normalizedTool.includes("glob") ||
+    normalizedTool.includes("grep") ||
+    normalizedTool.includes("search")
+  ) {
+    return "file-read";
+  }
+  return "command";
+}
+
+export function openCodeToolProjectionKind(
+  toolName: string,
+): "command_execution" | "file_change" | "file_search" | "web_search" | "dynamic_tool" {
+  const normalized = toolName.toLowerCase();
+  if (normalized === "todowrite") {
+    return "dynamic_tool";
+  }
+  if (normalized.includes("bash") || normalized.includes("shell")) {
+    return "command_execution";
+  }
+  if (normalized.includes("edit") || normalized.includes("write") || normalized.includes("patch")) {
+    return "file_change";
+  }
+  if (normalized.includes("web") || normalized === "codesearch" || normalized === "code_search") {
+    return "web_search";
+  }
+  if (
+    normalized === "read" ||
+    normalized.includes("glob") ||
+    normalized.includes("grep") ||
+    normalized.includes("search") ||
+    normalized.includes("lsp")
+  ) {
+    return "file_search";
+  }
+  return "dynamic_tool";
+}
+
+const OPENCODE_ALWAYS_ALLOWED_PERMISSIONS = [
+  "question",
+  "read",
+  "glob",
+  "grep",
+  "lsp",
+  "todowrite",
+  "task",
+  "skill",
+] as const;
+
+const OPENCODE_RESTRICTED_PERMISSIONS = [
+  "bash",
+  "edit",
+  "webfetch",
+  "websearch",
+  "codesearch",
+  "external_directory",
+  "doom_loop",
+] as const;
+
+/**
+ * OpenCode does not provide an OS sandbox, so permission rules are also the
+ * enforcement boundary for non-interactive policies. Read/planning tools are
+ * safe by default; edits are auto-approved only for workspace-write modes,
+ * while shell/network/external access remains gated unless policy explicitly
+ * allows it.
+ */
+export function openCodePermissionRules(
+  runtimePolicy: ProviderAdapterV2RuntimePolicy,
+): PermissionRuleset {
+  const sandboxPolicy = recordValue(runtimePolicy, "sandboxPolicy");
+  const sandboxType = recordString(sandboxPolicy, "type");
+  const rawApprovalPolicy = runtimePolicy.approvalPolicy;
+  const approvalPolicy = nonEmptyString(rawApprovalPolicy);
+  const requiresApproval =
+    approvalPolicy === undefined
+      ? (typeof rawApprovalPolicy === "object" && rawApprovalPolicy !== null) ||
+        runtimePolicy.runtimeMode !== "full-access"
+      : approvalPolicy !== "never";
+  const externallySandboxed = sandboxType === "externalSandbox";
+  const dangerFullAccess = sandboxType === "dangerFullAccess";
+  const implicitFullAccess =
+    sandboxType === undefined && runtimePolicy.runtimeMode === "full-access";
+
+  if (!requiresApproval && (externallySandboxed || dangerFullAccess || implicitFullAccess)) {
+    return [{ permission: "*", pattern: "*", action: "allow" }];
+  }
+
+  // Task sessions initially inherit only parent deny rules. Seed explicit
+  // denies before the effective ask/allow overrides so a child is safe during
+  // the short interval before emitSubagent installs its complete policy.
+  const rules: PermissionRuleset = [
+    { permission: "*", pattern: "*", action: "deny" },
+    ...OPENCODE_RESTRICTED_PERMISSIONS.map((permission) => ({
+      permission,
+      pattern: "*",
+      action: "deny" as const,
+    })),
+  ];
+
+  if (requiresApproval) {
+    rules.push({ permission: "*", pattern: "*", action: "ask" });
+    for (const permission of OPENCODE_RESTRICTED_PERMISSIONS) {
+      rules.push({ permission, pattern: "*", action: "ask" });
+    }
+  }
+
+  rules.push(
+    ...OPENCODE_ALWAYS_ALLOWED_PERMISSIONS.map((permission) => ({
+      permission,
+      pattern: "*",
+      action: "allow" as const,
+    })),
+  );
+
+  if (
+    runtimePolicy.runtimeMode === "auto-accept-edits" ||
+    (!requiresApproval && sandboxType === "workspaceWrite")
+  ) {
+    rules.push({ permission: "edit", pattern: "*", action: "allow" });
+  }
+
+  if (!requiresApproval && recordValue(sandboxPolicy, "networkAccess") === true) {
+    for (const permission of ["webfetch", "websearch", "codesearch"] as const) {
+      rules.push({ permission, pattern: "*", action: "allow" });
+    }
+  }
+
+  if (!requiresApproval && sandboxType === "readOnly") {
+    const access = recordValue(sandboxPolicy, "access");
+    if (recordString(access, "type") === "fullAccess") {
+      rules.push({ permission: "external_directory", pattern: "*", action: "allow" });
+    }
+  }
+
+  if (!requiresApproval && sandboxType === "workspaceWrite") {
+    const writableRoots = recordValue(sandboxPolicy, "writableRoots");
+    if (Array.isArray(writableRoots)) {
+      for (const root of writableRoots) {
+        if (typeof root === "string" && root.trim().length > 0) {
+          rules.push({
+            permission: "external_directory",
+            pattern: `${root.replace(/\/$/, "")}/*`,
+            action: "allow",
+          });
+        }
+      }
+    }
+  }
+
+  return rules;
+}
+
+function permissionRuleEquals(
+  left: PermissionRuleset[number],
+  right: PermissionRuleset[number],
+): boolean {
+  return (
+    left.permission === right.permission &&
+    left.pattern === right.pattern &&
+    left.action === right.action
+  );
+}
+
+/**
+ * OpenCode task sessions inherit only the parent's deny/external-directory
+ * rules and then add agent-specific restrictions such as disabling nested
+ * tasks. Install the complete parent policy while retaining only rules that
+ * were added specifically for the selected child agent.
+ */
+export function openCodeChildPermissionRules(
+  runtimePolicy: ProviderAdapterV2RuntimePolicy,
+  nativeChildRules: PermissionRuleset,
+): PermissionRuleset {
+  const parentRules = openCodePermissionRules(runtimePolicy);
+  const inheritedRules = parentRules.filter(
+    (rule) => rule.permission === "external_directory" || rule.action === "deny",
+  );
+  const childSpecificRules = nativeChildRules.filter(
+    (childRule) =>
+      !inheritedRules.some((inheritedRule) => permissionRuleEquals(childRule, inheritedRule)),
+  );
+  return [...parentRules, ...childSpecificRules];
+}
+
+/**
+ * OpenCode's fork/revert boundary is exclusive. To retain the selected app
+ * turn, address the next native user message; omitting a boundary retains the
+ * current head when the selected turn is already last.
+ */
+export function openCodeBoundaryAfterProviderTurn(
+  providerTurns: ReadonlyArray<OrchestrationV2ProviderTurn>,
+  selectedProviderTurnId: OrchestrationV2ProviderTurn["id"],
+): string | undefined {
+  const selected = providerTurns.find((turn) => turn.id === selectedProviderTurnId);
+  if (selected === undefined) return undefined;
+  return providerTurns
+    .filter((turn) => turn.ordinal > selected.ordinal)
+    .toSorted((left, right) => left.ordinal - right.ordinal)
+    .map((turn) => turn.nativeTurnRef?.nativeId)
+    .find((nativeId): nativeId is string => nativeId !== null && nativeId !== undefined);
+}
+
+function toolStatus(part: ToolPart): {
+  readonly node: OrchestrationV2ExecutionNode["status"];
+  readonly item: OrchestrationV2TurnItem["status"];
+} {
+  switch (part.state.status) {
+    case "pending":
+      return { node: "pending", item: "pending" };
+    case "running":
+      return { node: "running", item: "running" };
+    case "completed":
+      return { node: "completed", item: "completed" };
+    case "error":
+      return { node: "failed", item: "failed" };
+  }
+}
+
+function toolInput(part: ToolPart): Record<string, unknown> {
+  return part.state.input;
+}
+
+function toolOutput(part: ToolPart): string | undefined {
+  if (part.state.status === "completed") return part.state.output;
+  if (part.state.status === "error") return part.state.error;
+  return undefined;
+}
+
+function toolStartedAt(part: ToolPart, now: DateTime.Utc): DateTime.Utc {
+  return dateTimeFromEpoch(
+    part.state.status === "pending" ? undefined : part.state.time.start,
+    now,
+  );
+}
+
+function toolCompletedAt(part: ToolPart, now: DateTime.Utc): DateTime.Utc | null {
+  return part.state.status === "completed" || part.state.status === "error"
+    ? dateTimeFromEpoch(part.state.time.end, now)
+    : null;
+}
+
+function toolTitle(part: ToolPart): string | null {
+  return part.state.status === "running" || part.state.status === "completed"
+    ? (part.state.title ?? null)
+    : null;
+}
+
+function toolModel(part: ToolPart): string | null {
+  const metadata =
+    part.state.status === "running" ||
+    part.state.status === "completed" ||
+    part.state.status === "error"
+      ? part.state.metadata
+      : undefined;
+  const model = recordValue(metadata, "model");
+  const providerId = recordString(model, "providerID", "providerId");
+  const modelId = recordString(model, "modelID", "modelId", "id");
+  return providerId !== undefined && modelId !== undefined ? `${providerId}/${modelId}` : null;
+}
+
+function taskSessionId(part: ToolPart): string | null {
+  const metadata =
+    part.state.status === "running" ||
+    part.state.status === "completed" ||
+    part.state.status === "error"
+      ? part.state.metadata
+      : undefined;
+  return recordString(metadata, "sessionId", "sessionID") ?? null;
+}
+
+function makeProviderThread(input: {
+  readonly idAllocator: IdAllocatorV2Shape;
+  readonly providerInstanceId: ProviderInstanceId;
+  readonly providerSessionId: OrchestrationV2ProviderThread["providerSessionId"];
+  readonly appThreadId: OrchestrationV2ProviderThread["appThreadId"];
+  readonly ownerNodeId?: OrchestrationV2ProviderThread["ownerNodeId"];
+  readonly nativeSession: OpenCodeSession;
+  readonly forkedFrom?: OrchestrationV2ProviderThread["forkedFrom"];
+  readonly now: DateTime.Utc;
+}): OrchestrationV2ProviderThread {
+  const createdAt = dateTimeFromEpoch(input.nativeSession.time.created, input.now);
+  return {
+    id: input.idAllocator.derive.providerThread({
+      driver: OPENCODE_PROVIDER,
+      nativeThreadId: input.nativeSession.id,
+    }),
+    driver: OPENCODE_PROVIDER,
+    providerInstanceId: input.providerInstanceId,
+    providerSessionId: input.providerSessionId,
+    appThreadId: input.appThreadId,
+    ownerNodeId: input.ownerNodeId ?? null,
+    nativeThreadRef: {
+      driver: OPENCODE_PROVIDER,
+      nativeId: input.nativeSession.id,
+      strength: "strong",
+    },
+    nativeConversationHeadRef: null,
+    status: "idle",
+    firstRunOrdinal: null,
+    lastRunOrdinal: null,
+    handoffIds: [],
+    forkedFrom: input.forkedFrom ?? null,
+    createdAt,
+    updatedAt: dateTimeFromEpoch(input.nativeSession.time.updated, input.now),
+  };
+}
+
+function providerRef(nativeId: string, strength: "strong" | "weak" = "strong") {
+  return {
+    driver: OPENCODE_PROVIDER,
+    nativeId,
+    strength,
+  } satisfies OrchestrationV2ProviderRef;
+}
+
+function openCodeErrorMessage(event: Extract<OpenCodeEvent, { type: "session.error" }>): string {
+  const error = event.properties.error;
+  if (error === undefined) return "OpenCode session failed without an error payload.";
+  return recordString(error.data, "message") ?? error.name;
+}
+
+function terminalStatusForError(
+  event: Extract<OpenCodeEvent, { type: "session.error" }>,
+  turn: ActiveOpenCodeTurn,
+): TerminalTurnStatus {
+  return turn.interrupted || isMessageAbortedError(event) ? "interrupted" : "failed";
+}
+
+function isMessageAbortedError(event: Extract<OpenCodeEvent, { type: "session.error" }>): boolean {
+  return event.properties.error?.name === "MessageAbortedError";
+}
+
+function unwrapData<A>(operation: string, result: { readonly data?: A }): NonNullable<A> {
+  if (result.data === undefined) {
+    throw new OpenCodeRuntimeError({
+      operation,
+      detail: `OpenCode ${operation} returned no response payload.`,
+    });
+  }
+  return result.data as NonNullable<A>;
+}
+
+export function makeOpenCodeAdapterV2(options: OpenCodeAdapterV2Options): ProviderAdapterV2Shape {
+  const { idAllocator, runtime, serverConfig } = options;
+
+  return ProviderAdapterV2.of({
+    instanceId: options.instanceId,
+    driver: OPENCODE_PROVIDER,
+    getCapabilities: () => Effect.succeed(OpenCodeProviderCapabilitiesV2),
+    planSelectionTransition: () => Effect.succeed(turnScopedSelectionTransition()),
+    openSession: Effect.fn("OpenCodeAdapterV2.openSession")(
+      function* (input: ProviderAdapterV2OpenSessionInput) {
+        const scope = yield* Effect.scope;
+        const cwd = input.runtimePolicy.cwd ?? serverConfig.cwd;
+        const connection = yield* runtime.connectToOpenCodeServer({
+          binaryPath: options.settings.binaryPath,
+          directory: cwd,
+          serverUrl: options.settings.serverUrl,
+          environment: options.environment,
+        });
+        const client = runtime.createOpenCodeSdkClient({
+          baseUrl: connection.url,
+          directory: cwd,
+          ...(connection.external && options.settings.serverPassword
+            ? { serverPassword: options.settings.serverPassword }
+            : {}),
+        });
+
+        const mcpSession = McpProviderSession.readMcpProviderSession(input.threadId);
+        const hasT3Mcp = mcpSession !== undefined && !connection.external;
+        const orchestrationSystemPrompt = t3OrchestrationSystemPrompt(hasT3Mcp);
+        if (hasT3Mcp) {
+          yield* runOpenCodeSdk("mcp.add", () =>
+            client.mcp.add({
+              name: "t3-code",
+              config: {
+                type: "remote",
+                url: mcpSession.endpoint,
+                headers: { Authorization: mcpSession.authorizationHeader },
+                oauth: false,
+              },
+            }),
+          );
+        }
+
+        const now = yield* DateTime.now;
+        let sessionEntity: OrchestrationV2ProviderSession = {
+          id: input.providerSessionId,
+          driver: OPENCODE_PROVIDER,
+          providerInstanceId: options.instanceId,
+          status: "ready",
+          cwd,
+          model: input.modelSelection.model,
+          capabilities: OpenCodeProviderCapabilitiesV2,
+          createdAt: now,
+          updatedAt: now,
+          lastError: null,
+        };
+        const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+        const threads = new Map<string, OpenCodeThreadState>();
+        const pendingRequests = new Map<string, PendingOpenCodeRequest>();
+        const pendingRequestsByNativeId = new Map<string, PendingOpenCodeRequest>();
+        const subagentsByNativeItemId = new Map<string, OpenCodeSubagentContext>();
+        const subagentsByChildSessionId = new Map<string, OpenCodeSubagentContext>();
+        // Permission and question requests can originate from child sessions
+        // (task subagents and their descendants). Related sessions map back
+        // to the root thread state whose active turn owns the request; asks
+        // arriving before the relation is known resolve it via session.get.
+        const relatedSessionOwners = new Map<string, OpenCodeThreadState>();
+        // Requests settled before their session relation resolved: a late
+        // routing attempt must never resurrect them. Bounded because entries
+        // only matter for the seconds a routing retry can still be running.
+        const settledNativeRequestIds = new Set<string>();
+        const pendingChildRequestRoutes = new Set<string>();
+        const rememberSettledRequest = (nativeRequestId: string) => {
+          if (settledNativeRequestIds.size >= 2_048) settledNativeRequestIds.clear();
+          settledNativeRequestIds.add(nativeRequestId);
+        };
+        const abortController = new AbortController();
+
+        const emitProviderEvent = (event: ProviderAdapterV2Event) =>
+          Queue.offer(events, event).pipe(Effect.asVoid);
+
+        const logProtocolEvent = makeOpenCodeProtocolLogger({
+          nativeEventLogger: options.nativeEventLogger,
+          idAllocator,
+          providerInstanceId: options.instanceId,
+          providerSessionId: input.providerSessionId,
+          threadId: input.threadId,
+        });
+
+        const sdkCall = <A>(
+          method: string,
+          payload: unknown,
+          call: (signal: AbortSignal) => Promise<A>,
+        ): Effect.Effect<A, OpenCodeRuntimeError> =>
+          logProtocolEvent({
+            direction: "outgoing",
+            messageKind: "request",
+            method,
+            payload,
+          }).pipe(
+            Effect.andThen(runOpenCodeSdk(method, call)),
+            Effect.tap((response) =>
+              logProtocolEvent({
+                direction: "incoming",
+                messageKind: "response",
+                method,
+                payload: sdkResponseForRawLog(response),
+              }),
+            ),
+          );
+
+        const updateProviderSession = (
+          status: OrchestrationV2ProviderSession["status"],
+          lastError: string | null = sessionEntity.lastError,
+        ) =>
+          Effect.gen(function* () {
+            const updatedAt = yield* DateTime.now;
+            sessionEntity = { ...sessionEntity, status, lastError, updatedAt };
+            yield* emitProviderEvent({
+              type: "provider_session.updated",
+              driver: OPENCODE_PROVIDER,
+              providerSession: sessionEntity,
+            });
+          });
+
+        const updateProviderThread = (
+          state: OpenCodeThreadState,
+          patch: Partial<OrchestrationV2ProviderThread>,
+        ) =>
+          Effect.gen(function* () {
+            const updatedAt = yield* DateTime.now;
+            state.providerThread = { ...state.providerThread, ...patch, updatedAt };
+            yield* emitProviderEvent({
+              type: "provider_thread.updated",
+              driver: OPENCODE_PROVIDER,
+              providerThread: state.providerThread,
+            });
+          });
+
+        const itemOrdinal = (turn: ActiveOpenCodeTurn, nativeItemId: string): number => {
+          const existing = turn.itemOrdinals.get(nativeItemId);
+          if (existing !== undefined) return existing;
+          const ordinal = turn.nextItemOrdinal++;
+          turn.itemOrdinals.set(nativeItemId, ordinal);
+          return ordinal;
+        };
+
+        const emitProviderTurn = (
+          state: OpenCodeThreadState,
+          turn: ActiveOpenCodeTurn,
+          status: OrchestrationV2ProviderTurn["status"],
+          completedAt: DateTime.Utc | null,
+        ) => {
+          const providerTurn: OrchestrationV2ProviderTurn = {
+            ...turn.providerTurn,
+            nativeTurnRef:
+              turn.nativeUserMessageId === null
+                ? turn.providerTurn.nativeTurnRef
+                : providerRef(turn.nativeUserMessageId, "weak"),
+            status,
+            completedAt,
+          };
+          Object.assign(turn.providerTurn, providerTurn);
+          state.providerTurns.set(String(providerTurn.id), providerTurn);
+          return emitProviderEvent({
+            type: "provider_turn.updated",
+            driver: OPENCODE_PROVIDER,
+            threadId: turn.threadId,
+            providerTurn,
+          });
+        };
+
+        const emitTextPart = Effect.fnUntraced(function* (
+          state: OpenCodeThreadState,
+          turn: ActiveOpenCodeTurn,
+          part: Extract<OpenCodePart, { type: "text" | "reasoning" }>,
+          forceCompleted = false,
+        ) {
+          if (part.type === "text" && (part.ignored === true || part.synthetic === true)) return;
+          if (part.text.length === 0) return;
+          const emittedAt = yield* DateTime.now;
+          const isCompleted = forceCompleted || part.time?.end !== undefined;
+          const startedAt = dateTimeFromEpoch(part.time?.start, emittedAt);
+          const completedAt = isCompleted ? dateTimeFromEpoch(part.time?.end, emittedAt) : null;
+          const nativeItemRef = providerRef(part.id);
+          const nodeId = idAllocator.derive.nodeFromProviderItem({
+            driver: OPENCODE_PROVIDER,
+            nativeItemId: part.id,
+          });
+          const turnItemId = idAllocator.derive.turnItemFromProviderItem({
+            driver: OPENCODE_PROVIDER,
+            nativeItemId: part.id,
+          });
+          const ordinal = itemOrdinal(turn, part.id);
+          yield* emitProviderEvent({
+            type: "node.updated",
+            driver: OPENCODE_PROVIDER,
+            node: {
+              id: nodeId,
+              threadId: turn.threadId,
+              runId: turn.runId,
+              parentNodeId: turn.rootNodeId,
+              rootNodeId: turn.rootNodeId,
+              kind: part.type === "text" ? "assistant_message" : "reasoning",
+              status: isCompleted ? "completed" : "running",
+              countsForRun: false,
+              providerThreadId: state.providerThread.id,
+              providerTurnId: turn.providerTurnId,
+              nativeItemRef,
+              runtimeRequestId: null,
+              checkpointScopeId: null,
+              startedAt,
+              completedAt,
+            },
+          });
+          if (part.type === "text") {
+            const messageId = idAllocator.derive.messageFromProviderItem({
+              driver: OPENCODE_PROVIDER,
+              nativeItemId: part.id,
+            });
+            const message: OrchestrationV2ConversationMessage = {
+              createdBy: "agent",
+              creationSource: "provider",
+              id: messageId,
+              threadId: turn.threadId,
+              runId: turn.runId,
+              nodeId,
+              role: "assistant",
+              text: part.text,
+              attachments: [],
+              streaming: !isCompleted,
+              createdAt: startedAt,
+              updatedAt: emittedAt,
+            };
+            state.messages.set(String(message.id), message);
+            yield* emitProviderEvent({
+              type: "message.updated",
+              driver: OPENCODE_PROVIDER,
+              message,
+            });
+            yield* emitProviderEvent({
+              type: "turn_item.updated",
+              driver: OPENCODE_PROVIDER,
+              turnItem: {
+                id: turnItemId,
+                threadId: turn.threadId,
+                runId: turn.runId,
+                nodeId,
+                providerThreadId: state.providerThread.id,
+                providerTurnId: turn.providerTurnId,
+                nativeItemRef,
+                parentItemId: null,
+                ordinal,
+                status: isCompleted ? "completed" : "running",
+                title: null,
+                startedAt,
+                completedAt,
+                updatedAt: emittedAt,
+                type: "assistant_message",
+                messageId,
+                text: part.text,
+                streaming: !isCompleted,
+              },
+            });
+            return;
+          }
+          yield* emitProviderEvent({
+            type: "turn_item.updated",
+            driver: OPENCODE_PROVIDER,
+            turnItem: {
+              id: turnItemId,
+              threadId: turn.threadId,
+              runId: turn.runId,
+              nodeId,
+              providerThreadId: state.providerThread.id,
+              providerTurnId: turn.providerTurnId,
+              nativeItemRef,
+              parentItemId: null,
+              ordinal,
+              status: isCompleted ? "completed" : "running",
+              title: null,
+              startedAt,
+              completedAt,
+              updatedAt: emittedAt,
+              type: "reasoning",
+              text: part.text,
+              streaming: !isCompleted,
+            },
+          });
+        });
+
+        const emitSubagent = Effect.fnUntraced(function* (
+          state: OpenCodeThreadState,
+          turn: ActiveOpenCodeTurn,
+          part: ToolPart,
+        ) {
+          const now = yield* DateTime.now;
+          const nativeItemRef = providerRef(part.id);
+          const nodeId = idAllocator.derive.nodeFromProviderItem({
+            driver: OPENCODE_PROVIDER,
+            nativeItemId: part.id,
+          });
+          const turnItemId = idAllocator.derive.turnItemFromProviderItem({
+            driver: OPENCODE_PROVIDER,
+            nativeItemId: part.id,
+          });
+          const input = toolInput(part);
+          const prompt = recordString(input, "prompt") ?? "";
+          const title = toolTitle(part) ?? recordString(input, "description") ?? null;
+          let context = subagentsByNativeItemId.get(part.id);
+          if (context === undefined) {
+            context = {
+              nativeItemId: part.id,
+              nodeId,
+              parentTurn: turn,
+              prompt,
+              title,
+              startedAt: toolStartedAt(part, now),
+              childSessionId: null,
+              childThreadId: null,
+              childProviderThreadId: null,
+              model: null,
+              result: null,
+            };
+            subagentsByNativeItemId.set(part.id, context);
+          }
+          context.model = toolModel(part) ?? context.model;
+          const childSessionId = taskSessionId(part);
+          if (childSessionId !== null && context.childSessionId === null) {
+            context.childSessionId = childSessionId;
+            context.childThreadId = idAllocator.derive.threadFromProviderThread({
+              driver: OPENCODE_PROVIDER,
+              nativeThreadId: childSessionId,
+            });
+            context.childProviderThreadId = idAllocator.derive.providerThread({
+              driver: OPENCODE_PROVIDER,
+              nativeThreadId: childSessionId,
+            });
+            subagentsByChildSessionId.set(childSessionId, context);
+            relatedSessionOwners.set(childSessionId, state);
+            const childModelSelection: ModelSelection = {
+              instanceId: options.instanceId,
+              model: context.model ?? turn.modelSelection.model,
+            };
+            const childThread = makeSubagentChildThread({
+              parentThread: turn.appThread,
+              childThreadId: context.childThreadId,
+              parentNodeId: nodeId,
+              activeProviderThreadId: context.childProviderThreadId,
+              providerInstanceId: options.instanceId,
+              modelSelection: childModelSelection,
+              title: subagentThreadTitle({
+                parentTitle: turn.appThread.title,
+                title,
+                prompt,
+                ordinal: itemOrdinal(turn, part.id),
+              }),
+              now,
+              createdBy: "agent",
+              creationSource: "provider",
+            });
+            const childProviderThread: OrchestrationV2ProviderThread = {
+              id: context.childProviderThreadId,
+              driver: OPENCODE_PROVIDER,
+              providerInstanceId: options.instanceId,
+              providerSessionId: inputProviderSessionId,
+              appThreadId: context.childThreadId,
+              ownerNodeId: nodeId,
+              nativeThreadRef: providerRef(childSessionId),
+              nativeConversationHeadRef: null,
+              status: "active",
+              firstRunOrdinal: null,
+              lastRunOrdinal: null,
+              handoffIds: [],
+              forkedFrom: null,
+              createdAt: now,
+              updatedAt: now,
+            };
+            const childSessionResponse = yield* sdkCall(
+              "session.get",
+              { sessionID: childSessionId },
+              () => client.session.get({ sessionID: childSessionId }),
+            );
+            const nativeChildSession = unwrapData("session.get", childSessionResponse);
+            const childPermission = openCodeChildPermissionRules(
+              turn.runtimePolicy,
+              nativeChildSession.permission ?? [],
+            );
+            yield* sdkCall(
+              "session.update",
+              { sessionID: childSessionId, permission: childPermission },
+              () =>
+                client.session.update({
+                  sessionID: childSessionId,
+                  permission: childPermission,
+                }),
+            );
+            threads.set(childSessionId, {
+              nativeSessionId: childSessionId,
+              providerThread: childProviderThread,
+              appThread: childThread,
+              activeTurn: null,
+              providerTurns: new Map(),
+              messages: new Map(),
+              runtimeRequests: new Map(),
+              messageRoles: new Map(),
+              userMessageIds: [],
+              parentSubagent: context,
+              nextChildTurnOrdinal: 1,
+              nextAdmissionGeneration: 1,
+            });
+            yield* emitProviderEvent({
+              type: "app_thread.created",
+              driver: OPENCODE_PROVIDER,
+              appThread: childThread,
+            });
+            yield* emitProviderEvent({
+              type: "provider_thread.updated",
+              driver: OPENCODE_PROVIDER,
+              providerThread: childProviderThread,
+            });
+          }
+          const output = toolOutput(part);
+          if (part.state.status === "completed" && output !== undefined) context.result = output;
+          const status = toolStatus(part);
+          const completedAt = toolCompletedAt(part, now);
+          const subagentStatus: OrchestrationV2Subagent["status"] =
+            status.item === "failed"
+              ? "failed"
+              : status.item === "completed"
+                ? "completed"
+                : status.item === "pending"
+                  ? "pending"
+                  : "running";
+          const subagent: OrchestrationV2Subagent = {
+            id: nodeId,
+            threadId: turn.threadId,
+            runId: turn.runId,
+            parentNodeId: turn.rootNodeId,
+            origin: "provider_native",
+            createdBy: "agent",
+            driver: OPENCODE_PROVIDER,
+            providerInstanceId: options.instanceId,
+            providerThreadId: context.childProviderThreadId,
+            childThreadId: context.childThreadId,
+            nativeTaskRef: nativeItemRef,
+            prompt,
+            title,
+            model: context.model,
+            status: subagentStatus,
+            result: context.result,
+            startedAt: context.startedAt,
+            completedAt,
+            updatedAt: now,
+          };
+          yield* emitProviderEvent({
+            type: "node.updated",
+            driver: OPENCODE_PROVIDER,
+            node: {
+              id: nodeId,
+              threadId: turn.threadId,
+              runId: turn.runId,
+              parentNodeId: turn.rootNodeId,
+              rootNodeId: turn.rootNodeId,
+              kind: "subagent",
+              status: status.node,
+              countsForRun: false,
+              providerThreadId: context.childProviderThreadId ?? state.providerThread.id,
+              providerTurnId: turn.providerTurnId,
+              nativeItemRef,
+              runtimeRequestId: null,
+              checkpointScopeId: null,
+              startedAt: context.startedAt,
+              completedAt,
+            },
+          });
+          yield* emitProviderEvent({
+            type: "subagent.updated",
+            driver: OPENCODE_PROVIDER,
+            subagent,
+          });
+          yield* emitProviderEvent({
+            type: "turn_item.updated",
+            driver: OPENCODE_PROVIDER,
+            turnItem: {
+              id: turnItemId,
+              threadId: turn.threadId,
+              runId: turn.runId,
+              nodeId,
+              providerThreadId: state.providerThread.id,
+              providerTurnId: turn.providerTurnId,
+              nativeItemRef,
+              parentItemId: null,
+              ordinal: itemOrdinal(turn, part.id),
+              status: status.item,
+              title,
+              startedAt: context.startedAt,
+              completedAt,
+              updatedAt: now,
+              type: "subagent",
+              subagentId: nodeId,
+              origin: "provider_native",
+              driver: OPENCODE_PROVIDER,
+              providerInstanceId: options.instanceId,
+              childThreadId: context.childThreadId,
+              prompt,
+              result: context.result,
+            },
+          });
+        });
+
+        const emitToolPart = Effect.fnUntraced(function* (
+          state: OpenCodeThreadState,
+          turn: ActiveOpenCodeTurn,
+          part: ToolPart,
+        ) {
+          const normalizedTool = part.tool.toLowerCase();
+          if (normalizedTool === "task") {
+            yield* emitSubagent(state, turn, part);
+            return;
+          }
+          // question.asked carries the respondable semantic item. Projecting
+          // the implementation tool as well would duplicate it in the UI.
+          if (normalizedTool === "question") return;
+          const now = yield* DateTime.now;
+          const status = toolStatus(part);
+          const startedAt = toolStartedAt(part, now);
+          const completedAt = toolCompletedAt(part, now);
+          const nativeItemRef = providerRef(part.id);
+          const nodeId = idAllocator.derive.nodeFromProviderItem({
+            driver: OPENCODE_PROVIDER,
+            nativeItemId: part.id,
+          });
+          const turnItemId = idAllocator.derive.turnItemFromProviderItem({
+            driver: OPENCODE_PROVIDER,
+            nativeItemId: part.id,
+          });
+          const base = {
+            id: turnItemId,
+            threadId: turn.threadId,
+            runId: turn.runId,
+            nodeId,
+            providerThreadId: state.providerThread.id,
+            providerTurnId: turn.providerTurnId,
+            nativeItemRef,
+            parentItemId: null,
+            ordinal: itemOrdinal(turn, part.id),
+            status: status.item,
+            title: toolTitle(part),
+            startedAt,
+            completedAt,
+            updatedAt: now,
+          } satisfies Pick<
+            OrchestrationV2TurnItem,
+            | "id"
+            | "threadId"
+            | "runId"
+            | "nodeId"
+            | "providerThreadId"
+            | "providerTurnId"
+            | "nativeItemRef"
+            | "parentItemId"
+            | "ordinal"
+            | "status"
+            | "title"
+            | "startedAt"
+            | "completedAt"
+            | "updatedAt"
+          >;
+          const input = toolInput(part);
+          const output = toolOutput(part);
+          const projectionKind = openCodeToolProjectionKind(part.tool);
+          let turnItem: OrchestrationV2TurnItem;
+          if (projectionKind === "command_execution") {
+            turnItem = {
+              ...base,
+              type: "command_execution",
+              input: recordString(input, "command", "cmd") ?? stableJson(input),
+              ...(output === undefined ? {} : { output }),
+              ...(recordNumber(
+                part.state.status === "completed" ? part.state.metadata : undefined,
+                "exit",
+                "exitCode",
+              ) === undefined
+                ? {}
+                : {
+                    exitCode: recordNumber(
+                      part.state.status === "completed" ? part.state.metadata : undefined,
+                      "exit",
+                      "exitCode",
+                    )!,
+                  }),
+            };
+          } else if (projectionKind === "file_change") {
+            turnItem = {
+              ...base,
+              type: "file_change",
+              fileName: recordString(input, "filePath", "path", "file") ?? part.tool,
+              ...(recordString(input, "oldString", "oldText") === undefined
+                ? {}
+                : { oldStr: recordString(input, "oldString", "oldText")! }),
+              ...(recordString(input, "newString", "content", "newText") === undefined
+                ? {}
+                : { newStr: recordString(input, "newString", "content", "newText")! }),
+              ...(recordString(
+                part.state.status === "completed" ? part.state.metadata : undefined,
+                "diff",
+                "patch",
+              ) === undefined
+                ? {}
+                : {
+                    diffStr: recordString(
+                      part.state.status === "completed" ? part.state.metadata : undefined,
+                      "diff",
+                      "patch",
+                    )!,
+                  }),
+            };
+          } else if (projectionKind === "file_search") {
+            turnItem = {
+              ...base,
+              type: "file_search",
+              ...(recordString(input, "pattern", "query", "path", "filePath") === undefined
+                ? {}
+                : { pattern: recordString(input, "pattern", "query", "path", "filePath")! }),
+            };
+          } else if (projectionKind === "web_search") {
+            const pattern = recordString(input, "query", "url", "pattern");
+            turnItem = {
+              ...base,
+              type: "web_search",
+              ...(pattern === undefined ? {} : { patterns: [pattern] }),
+            };
+          } else {
+            turnItem = {
+              ...base,
+              type: "dynamic_tool",
+              toolName: part.tool,
+              input,
+              ...(output === undefined ? {} : { output }),
+            };
+          }
+          yield* emitProviderEvent({
+            type: "node.updated",
+            driver: OPENCODE_PROVIDER,
+            node: {
+              id: nodeId,
+              threadId: turn.threadId,
+              runId: turn.runId,
+              parentNodeId: turn.rootNodeId,
+              rootNodeId: turn.rootNodeId,
+              kind: "tool_call",
+              status: status.node,
+              countsForRun: false,
+              providerThreadId: state.providerThread.id,
+              providerTurnId: turn.providerTurnId,
+              nativeItemRef,
+              runtimeRequestId: null,
+              checkpointScopeId: null,
+              startedAt,
+              completedAt,
+            },
+          });
+          yield* emitProviderEvent({
+            type: "turn_item.updated",
+            driver: OPENCODE_PROVIDER,
+            turnItem,
+          });
+        });
+
+        const emitTodo = Effect.fnUntraced(function* (
+          state: OpenCodeThreadState,
+          turn: ActiveOpenCodeTurn,
+          todos: ReadonlyArray<OpenCodeTodo>,
+        ) {
+          const now = yield* DateTime.now;
+          if (turn.planId === null) {
+            turn.planId = yield* idAllocator.allocate.plan({
+              threadId: turn.threadId,
+              ...(turn.runId === null ? {} : { runId: turn.runId }),
+              driver: OPENCODE_PROVIDER,
+            });
+          }
+          const planId = turn.planId;
+          const nativeItemId = `${state.nativeSessionId}:todo:${turn.providerTurnId}`;
+          const nodeId = idAllocator.derive.nodeFromProviderItem({
+            driver: OPENCODE_PROVIDER,
+            nativeItemId,
+          });
+          const turnItemId = idAllocator.derive.turnItemFromProviderItem({
+            driver: OPENCODE_PROVIDER,
+            nativeItemId,
+          });
+          const steps: Array<OrchestrationV2PlanStep> = todos.map((todo, index) => ({
+            id: `${nativeItemId}:${index + 1}`,
+            text: todo.content.trim() || `Todo ${index + 1}`,
+            status:
+              todo.status === "completed"
+                ? "completed"
+                : todo.status === "in_progress"
+                  ? "running"
+                  : "pending",
+          }));
+          const completed = steps.length > 0 && steps.every((step) => step.status === "completed");
+          yield* emitProviderEvent({
+            type: "node.updated",
+            driver: OPENCODE_PROVIDER,
+            node: {
+              id: nodeId,
+              threadId: turn.threadId,
+              runId: turn.runId,
+              parentNodeId: turn.rootNodeId,
+              rootNodeId: turn.rootNodeId,
+              kind: "todo_list",
+              status: completed ? "completed" : "running",
+              countsForRun: false,
+              providerThreadId: state.providerThread.id,
+              providerTurnId: turn.providerTurnId,
+              nativeItemRef: providerRef(nativeItemId, "weak"),
+              runtimeRequestId: null,
+              checkpointScopeId: null,
+              startedAt: turn.startedAt,
+              completedAt: completed ? now : null,
+            },
+          });
+          yield* emitProviderEvent({
+            type: "plan.updated",
+            driver: OPENCODE_PROVIDER,
+            plan: {
+              id: planId,
+              threadId: turn.threadId,
+              runId: turn.runId,
+              nodeId,
+              status: completed ? "completed" : "active",
+              kind: "todo_list",
+              steps,
+            },
+          });
+          yield* emitProviderEvent({
+            type: "turn_item.updated",
+            driver: OPENCODE_PROVIDER,
+            turnItem: {
+              id: turnItemId,
+              threadId: turn.threadId,
+              runId: turn.runId,
+              nodeId,
+              providerThreadId: state.providerThread.id,
+              providerTurnId: turn.providerTurnId,
+              nativeItemRef: providerRef(nativeItemId, "weak"),
+              parentItemId: null,
+              ordinal: itemOrdinal(turn, nativeItemId),
+              status: completed ? "completed" : "running",
+              title: "Todo list",
+              startedAt: turn.startedAt,
+              completedAt: completed ? now : null,
+              updatedAt: now,
+              type: "todo_list",
+              planId,
+              steps,
+            },
+          });
+        });
+
+        const requestQuestions = (request: QuestionRequest) =>
+          request.questions.map((question, index) => ({
+            id: openCodeQuestionId(index, question),
+            header: question.header.trim() || `Question ${index + 1}`,
+            question: question.question.trim() || question.header.trim() || `Question ${index + 1}`,
+            options: question.options.map((option) => ({
+              label: option.label.trim() || "Option",
+              description: option.description.trim() || option.label.trim() || "Option",
+            })),
+          }));
+
+        const runtimeRequestTurnItem = (
+          pending: PendingOpenCodeRequest,
+          status: OrchestrationV2TurnItem["status"],
+          completedAt: DateTime.Utc | null,
+          updatedAt: DateTime.Utc,
+        ): OrchestrationV2TurnItem => {
+          const base = {
+            id: pending.turnItemId,
+            threadId: pending.turn.threadId,
+            runId: pending.turn.runId,
+            nodeId: pending.nodeId,
+            providerThreadId: pending.state.providerThread.id,
+            providerTurnId: pending.turn.providerTurnId,
+            nativeItemRef: providerRef(pending.nativeRequestId),
+            parentItemId: null,
+            ordinal: itemOrdinal(pending.turn, pending.nativeRequestId),
+            status,
+            startedAt: pending.createdAt,
+            completedAt,
+            updatedAt,
+          };
+          if (pending.question !== undefined) {
+            return {
+              ...base,
+              title: "User input",
+              type: "user_input_request",
+              requestId: pending.requestId,
+              questions: requestQuestions(pending.question),
+            };
+          }
+          const permission = pending.permission;
+          if (permission === undefined) {
+            throw protocolError(`OpenCode request ${pending.requestId} has no native payload`);
+          }
+          return {
+            ...base,
+            title: permission.permission,
+            type: "approval_request",
+            requestId: pending.requestId,
+            requestKind: pending.requestKind === "user_input" ? "command" : pending.requestKind,
+            prompt:
+              permission.patterns.length === 0
+                ? permission.permission
+                : permission.patterns.join("\n"),
+          };
+        };
+
+        const emitRuntimeRequest = Effect.fnUntraced(function* (
+          state: OpenCodeThreadState,
+          turn: ActiveOpenCodeTurn,
+          nativeRequestId: string,
+          request:
+            | { readonly type: "permission"; readonly value: PermissionRequest }
+            | { readonly type: "question"; readonly value: QuestionRequest },
+        ) {
+          if (pendingRequestsByNativeId.has(nativeRequestId)) return;
+          const now = yield* DateTime.now;
+          const requestId = yield* idAllocator.allocate.runtimeRequest({
+            driver: OPENCODE_PROVIDER,
+            providerTurnId: turn.providerTurnId,
+            nativeRequestId,
+          });
+          const nodeId = idAllocator.derive.approvalNode({ requestId });
+          const turnItemId = idAllocator.derive.approvalTurnItem({ requestId });
+          const permissionToolName =
+            request.type === "permission" && request.value.tool !== undefined
+              ? Array.from(turn.parts.values()).find(
+                  (part): part is ToolPart =>
+                    part.type === "tool" && part.callID === request.value.tool?.callID,
+                )?.tool
+              : undefined;
+          const permissionRequestKind =
+            request.type === "permission"
+              ? openCodePermissionRequestKind(request.value.permission, permissionToolName)
+              : undefined;
+          const requestKind: OrchestrationV2RuntimeRequest["kind"] =
+            permissionRequestKind ?? "user_input";
+          const pending: PendingOpenCodeRequest = {
+            requestId,
+            nativeRequestId,
+            turn,
+            state,
+            nodeId,
+            turnItemId,
+            requestKind,
+            createdAt: now,
+            ...(request.type === "permission"
+              ? { permission: request.value }
+              : { question: request.value }),
+          };
+          pendingRequests.set(String(requestId), pending);
+          pendingRequestsByNativeId.set(nativeRequestId, pending);
+          const runtimeRequest: OrchestrationV2RuntimeRequest = {
+            id: requestId,
+            nodeId,
+            providerTurnId: turn.providerTurnId,
+            nativeRequestRef: providerRef(nativeRequestId),
+            kind: requestKind,
+            status: "pending",
+            responseCapability: {
+              type: "live",
+              providerSessionId: inputProviderSessionId,
+            },
+            createdAt: now,
+            resolvedAt: null,
+          };
+          state.runtimeRequests.set(String(requestId), runtimeRequest);
+          yield* emitProviderEvent({
+            type: "node.updated",
+            driver: OPENCODE_PROVIDER,
+            node: {
+              id: nodeId,
+              threadId: turn.threadId,
+              runId: turn.runId,
+              parentNodeId: turn.rootNodeId,
+              rootNodeId: turn.rootNodeId,
+              kind: request.type === "question" ? "user_input_request" : "approval_request",
+              status: "waiting",
+              countsForRun: false,
+              providerThreadId: state.providerThread.id,
+              providerTurnId: turn.providerTurnId,
+              nativeItemRef: providerRef(nativeRequestId),
+              runtimeRequestId: requestId,
+              checkpointScopeId: null,
+              startedAt: now,
+              completedAt: null,
+            },
+          });
+          yield* emitProviderEvent({
+            type: "runtime_request.updated",
+            driver: OPENCODE_PROVIDER,
+            threadId: turn.threadId,
+            runtimeRequest,
+          });
+          yield* emitProviderEvent({
+            type: "turn_item.updated",
+            driver: OPENCODE_PROVIDER,
+            turnItem: runtimeRequestTurnItem(pending, "waiting", null, now),
+          });
+          yield* updateProviderSession("waiting", null);
+        });
+
+        const resolveRuntimeRequest = Effect.fnUntraced(function* (
+          nativeRequestId: string,
+          status: "resolved" | "cancelled",
+        ) {
+          const pending = pendingRequestsByNativeId.get(nativeRequestId);
+          if (pending === undefined) return;
+          const now = yield* DateTime.now;
+          const current = pending.state.runtimeRequests.get(String(pending.requestId));
+          if (current !== undefined) {
+            const resolved: OrchestrationV2RuntimeRequest = {
+              ...current,
+              status,
+              resolvedAt: now,
+            };
+            pending.state.runtimeRequests.set(String(pending.requestId), resolved);
+            yield* emitProviderEvent({
+              type: "runtime_request.updated",
+              driver: OPENCODE_PROVIDER,
+              threadId: pending.turn.threadId,
+              runtimeRequest: resolved,
+            });
+          }
+          yield* emitProviderEvent({
+            type: "node.updated",
+            driver: OPENCODE_PROVIDER,
+            node: {
+              id: pending.nodeId,
+              threadId: pending.turn.threadId,
+              runId: pending.turn.runId,
+              parentNodeId: pending.turn.rootNodeId,
+              rootNodeId: pending.turn.rootNodeId,
+              kind: pending.question === undefined ? "approval_request" : "user_input_request",
+              status: status === "resolved" ? "completed" : "cancelled",
+              countsForRun: false,
+              providerThreadId: pending.state.providerThread.id,
+              providerTurnId: pending.turn.providerTurnId,
+              nativeItemRef: providerRef(nativeRequestId),
+              runtimeRequestId: pending.requestId,
+              checkpointScopeId: null,
+              startedAt: pending.createdAt,
+              completedAt: now,
+            },
+          });
+          yield* emitProviderEvent({
+            type: "turn_item.updated",
+            driver: OPENCODE_PROVIDER,
+            turnItem: runtimeRequestTurnItem(
+              pending,
+              status === "resolved" ? "completed" : "cancelled",
+              now,
+              now,
+            ),
+          });
+          pendingRequests.delete(String(pending.requestId));
+          pendingRequestsByNativeId.delete(nativeRequestId);
+          const hasOtherPending = Array.from(pendingRequests.values()).some(
+            (candidate) => candidate.turn.isRoot,
+          );
+          if (!hasOtherPending) yield* updateProviderSession("running", null);
+        });
+
+        const requestOwnerState = (sessionId: string): OpenCodeThreadState | undefined => {
+          const direct = threads.get(sessionId);
+          if (direct?.activeTurn != null) return direct;
+          const related = relatedSessionOwners.get(sessionId);
+          if (related?.activeTurn != null) return related;
+          return direct ?? related;
+        };
+
+        /** Resolve which thread state owns a session's requests by walking the
+         *  native parent chain. Registers every hop so later requests from the
+         *  same child resolve without another lookup. */
+        const resolveSessionOwner = Effect.fnUntraced(function* (sessionId: string) {
+          const known = requestOwnerState(sessionId);
+          if (known !== undefined) return known;
+          let cursor = sessionId;
+          const hops: string[] = [];
+          for (let depth = 0; depth < 5; depth += 1) {
+            const response = yield* sdkCall("session.get", { sessionID: cursor }, () =>
+              client.session.get({ sessionID: cursor }),
+            ).pipe(Effect.option);
+            const info = Option.getOrUndefined(response)?.data;
+            const parentId = info?.parentID;
+            if (parentId === undefined) return undefined;
+            hops.push(cursor);
+            const owner = threads.get(parentId) ?? relatedSessionOwners.get(parentId);
+            if (owner !== undefined) {
+              for (const hop of hops) relatedSessionOwners.set(hop, owner);
+              return owner;
+            }
+            cursor = parentId;
+          }
+          return undefined;
+        });
+
+        /** A child's permission can arrive before the task part or
+         *  session.created event that reveals its relation to a thread. The
+         *  first resolution attempt runs inline (the replayable path); if the
+         *  relation or the owning turn is not established yet, a short forked
+         *  backoff keeps trying instead of dropping the request. */
+        const routeChildRequest = Effect.fnUntraced(function* (
+          nativeRequestId: string,
+          sessionId: string,
+          request:
+            | { readonly type: "permission"; readonly value: PermissionRequest }
+            | { readonly type: "question"; readonly value: QuestionRequest },
+        ) {
+          if (pendingChildRequestRoutes.has(nativeRequestId)) return;
+          const attempt = Effect.gen(function* () {
+            if (
+              settledNativeRequestIds.has(nativeRequestId) ||
+              pendingRequestsByNativeId.has(nativeRequestId)
+            ) {
+              return true;
+            }
+            const owner = yield* resolveSessionOwner(sessionId);
+            if (owner?.activeTurn == null) return false;
+            yield* emitRuntimeRequest(owner, owner.activeTurn, nativeRequestId, request);
+            return true;
+          });
+          if (yield* attempt) return;
+          pendingChildRequestRoutes.add(nativeRequestId);
+          yield* Effect.gen(function* () {
+            for (let retry = 0; retry < 5; retry += 1) {
+              yield* Effect.sleep(Duration.millis(Math.min(200 * 2 ** retry, 2_000)));
+              if (yield* attempt) return;
+            }
+          }).pipe(
+            Effect.ensuring(Effect.sync(() => pendingChildRequestRoutes.delete(nativeRequestId))),
+            Effect.forkIn(scope),
+          );
+        });
+
+        const finalizeTurn = Effect.fnUntraced(function* (
+          state: OpenCodeThreadState,
+          turn: ActiveOpenCodeTurn,
+          status: TerminalTurnStatus,
+          terminal?: {
+            readonly failure?: OrchestrationV2ProviderFailure;
+            readonly threadDisposition?: "reusable" | "broken";
+          },
+        ) {
+          if (turn.finalized) return;
+          turn.finalized = true;
+          const completedAt = yield* DateTime.now;
+          for (const part of turn.parts.values()) {
+            if (part.type === "text" || part.type === "reasoning") {
+              yield* emitTextPart(state, turn, part, true);
+            }
+          }
+          for (const pending of Array.from(pendingRequests.values())) {
+            if (pending.turn.providerTurnId === turn.providerTurnId) {
+              yield* resolveRuntimeRequest(pending.nativeRequestId, "cancelled");
+            }
+          }
+          yield* emitProviderTurn(state, turn, status, completedAt);
+          const threadDisposition = terminal?.threadDisposition ?? "reusable";
+          yield* updateProviderThread(state, {
+            status: turn.isRoot ? "active" : threadDisposition === "broken" ? "error" : "idle",
+            nativeConversationHeadRef:
+              turn.nativeUserMessageId === null
+                ? state.providerThread.nativeConversationHeadRef
+                : providerRef(turn.nativeUserMessageId, "weak"),
+          });
+          state.activeTurn = null;
+          if (!turn.isRoot) {
+            yield* emitProviderEvent({
+              type: "node.updated",
+              driver: OPENCODE_PROVIDER,
+              node: {
+                id: turn.rootNodeId,
+                threadId: turn.threadId,
+                runId: null,
+                parentNodeId: null,
+                rootNodeId: turn.rootNodeId,
+                kind: "root_turn",
+                status,
+                countsForRun: false,
+                providerThreadId: state.providerThread.id,
+                providerTurnId: turn.providerTurnId,
+                nativeItemRef: providerRef(state.nativeSessionId),
+                runtimeRequestId: null,
+                checkpointScopeId: null,
+                startedAt: turn.startedAt,
+                completedAt,
+              },
+            });
+            return;
+          }
+          const anotherTurnIsActive = Array.from(threads.values()).some(
+            (candidate) => candidate.activeTurn?.isRoot === true,
+          );
+          yield* updateProviderSession(
+            anotherTurnIsActive ? "running" : status === "failed" ? "error" : "ready",
+            status === "failed" ? sessionEntity.lastError : null,
+          );
+          yield* emitProviderEvent(
+            status === "failed"
+              ? {
+                  type: "turn.terminal",
+                  driver: OPENCODE_PROVIDER,
+                  providerThreadId: state.providerThread.id,
+                  providerTurnId: turn.providerTurnId,
+                  runOrdinal: turn.runOrdinal,
+                  failureItemOrdinal: itemOrdinal(turn, `terminal-failure:${turn.providerTurnId}`),
+                  status,
+                  failure:
+                    terminal?.failure ??
+                    makeProviderFailure({
+                      message: sessionEntity.lastError ?? undefined,
+                      class: "provider_error",
+                    }),
+                  threadDisposition,
+                }
+              : {
+                  type: "turn.terminal",
+                  driver: OPENCODE_PROVIDER,
+                  providerThreadId: state.providerThread.id,
+                  providerTurnId: turn.providerTurnId,
+                  runOrdinal: turn.runOrdinal,
+                  status,
+                  failure: null,
+                  threadDisposition,
+                },
+          );
+        });
+
+        const promptAdmissionIsCurrent = (
+          state: OpenCodeThreadState,
+          turn: ActiveOpenCodeTurn,
+          generation: number,
+        ) =>
+          state.activeTurn === turn &&
+          !turn.finalized &&
+          !turn.interrupted &&
+          turn.admissionPending &&
+          turn.admissionGeneration === generation;
+
+        const runPromptAdmissionReconciliation = Effect.fnUntraced(function* (
+          state: OpenCodeThreadState,
+          turn: ActiveOpenCodeTurn,
+          generation: number,
+        ) {
+          while (promptAdmissionIsCurrent(state, turn, generation)) {
+            const status = yield* reconcileOpenCodePromptAdmissionStatus(
+              turn,
+              generation,
+              sdkCall("session.status", { sessionID: state.nativeSessionId, generation }, () =>
+                client.session.status(),
+              ).pipe(
+                Effect.match({
+                  onFailure: () => "unknown" as const,
+                  onSuccess: (response) => {
+                    const statuses = unwrapData("session.status", response);
+                    const sessionStatus = statuses[state.nativeSessionId];
+                    return sessionStatus === undefined || sessionStatus.type === "idle"
+                      ? ("idle" as const)
+                      : ("busy" as const);
+                  },
+                }),
+              ),
+            );
+            if (
+              state.activeTurn !== turn ||
+              status === "stale" ||
+              turn.finalized ||
+              turn.interrupted ||
+              turn.admissionGeneration !== generation
+            ) {
+              return;
+            }
+            if (status === "idle") {
+              yield* finalizeTurn(state, turn, "completed");
+              return;
+            }
+            if (status === "busy") return;
+            yield* Effect.sleep("250 millis");
+          }
+        });
+
+        const reconcilePromptAdmission = Effect.fnUntraced(function* (
+          state: OpenCodeThreadState,
+          turn: ActiveOpenCodeTurn,
+        ) {
+          const generation = turn.admissionGeneration;
+          if (
+            !promptAdmissionIsCurrent(state, turn, generation) ||
+            turn.admissionReconciliationGeneration === generation
+          ) {
+            return;
+          }
+          turn.admissionReconciliationGeneration = generation;
+          yield* runPromptAdmissionReconciliation(state, turn, generation).pipe(
+            Effect.ensuring(
+              Effect.sync(() => {
+                if (turn.admissionReconciliationGeneration === generation) {
+                  turn.admissionReconciliationGeneration = null;
+                }
+              }),
+            ),
+            Effect.forkIn(scope),
+          );
+        });
+
+        const createChildTurn = Effect.fnUntraced(function* (
+          state: OpenCodeThreadState,
+          message: Extract<OpenCodeMessage, { role: "user" }>,
+        ) {
+          if (state.appThread === null || state.parentSubagent === null) return null;
+          const now = yield* DateTime.now;
+          const startedAt = dateTimeFromEpoch(message.time.created, now);
+          const rootNodeId = idAllocator.derive.nodeFromProviderItem({
+            driver: OPENCODE_PROVIDER,
+            nativeItemId: `${state.nativeSessionId}:root:${message.id}`,
+          });
+          const providerTurnId = idAllocator.derive.providerTurn({
+            driver: OPENCODE_PROVIDER,
+            nativeTurnId: message.id,
+          });
+          const providerTurn: OrchestrationV2ProviderTurn = {
+            id: providerTurnId,
+            providerThreadId: state.providerThread.id,
+            nodeId: rootNodeId,
+            runAttemptId: null,
+            nativeTurnRef: providerRef(message.id, "weak"),
+            ordinal: state.nextChildTurnOrdinal++,
+            status: "running",
+            startedAt,
+            completedAt: null,
+          };
+          const turn: ActiveOpenCodeTurn = {
+            isRoot: false,
+            threadId: state.appThread.id,
+            runId: null,
+            rootNodeId,
+            appThread: state.appThread,
+            modelSelection: state.appThread.modelSelection,
+            runtimePolicy: state.parentSubagent.parentTurn.runtimePolicy,
+            providerTurnId,
+            providerTurnOrdinal: providerTurn.ordinal,
+            runOrdinal: state.parentSubagent.parentTurn.runOrdinal,
+            runAttemptId: null,
+            startedAt,
+            itemOrdinals: new Map(),
+            parts: new Map(),
+            partIdsByMessage: new Map(),
+            providerTurn,
+            nextItemOrdinal: 1,
+            nativeUserMessageId: message.id,
+            admissionMessageId: null,
+            interrupted: false,
+            finalized: false,
+            planId: null,
+            admissionGeneration: 0,
+            admissionReconciliationGeneration: null,
+            admissionPending: false,
+            admissionAccepted: true,
+            admissionMessageObserved: true,
+            idleDuringAdmission: false,
+            admissionSettled: Deferred.makeUnsafe<void>(),
+            admissionAbortController: null,
+          };
+          state.activeTurn = turn;
+          state.providerTurns.set(String(providerTurnId), providerTurn);
+          yield* emitProviderEvent({
+            type: "node.updated",
+            driver: OPENCODE_PROVIDER,
+            node: {
+              id: rootNodeId,
+              threadId: turn.threadId,
+              runId: null,
+              parentNodeId: null,
+              rootNodeId,
+              kind: "root_turn",
+              status: "running",
+              countsForRun: false,
+              providerThreadId: state.providerThread.id,
+              providerTurnId,
+              nativeItemRef: providerRef(message.id, "weak"),
+              runtimeRequestId: null,
+              checkpointScopeId: null,
+              startedAt,
+              completedAt: null,
+            },
+          });
+          yield* emitProviderTurn(state, turn, "running", null);
+          return turn;
+        });
+
+        const projectChildUserPart = Effect.fnUntraced(function* (
+          state: OpenCodeThreadState,
+          turn: ActiveOpenCodeTurn,
+          part: Extract<OpenCodePart, { type: "text" }>,
+        ) {
+          const now = yield* DateTime.now;
+          const messageId = idAllocator.derive.messageFromProviderItem({
+            driver: OPENCODE_PROVIDER,
+            nativeItemId: part.messageID,
+          });
+          const turnItemId = idAllocator.derive.turnItemFromProviderItem({
+            driver: OPENCODE_PROVIDER,
+            nativeItemId: part.messageID,
+          });
+          const projected: OrchestrationV2ConversationMessage = {
+            createdBy: "agent",
+            creationSource: "provider",
+            id: messageId,
+            threadId: turn.threadId,
+            runId: null,
+            nodeId: turn.rootNodeId,
+            role: "user",
+            text: part.text,
+            attachments: [],
+            streaming: false,
+            createdAt: turn.startedAt,
+            updatedAt: now,
+          };
+          state.messages.set(String(messageId), projected);
+          yield* emitProviderEvent({
+            type: "message.updated",
+            driver: OPENCODE_PROVIDER,
+            message: projected,
+          });
+          yield* emitProviderEvent({
+            type: "turn_item.updated",
+            driver: OPENCODE_PROVIDER,
+            turnItem: {
+              createdBy: "agent",
+              creationSource: "provider",
+              id: turnItemId,
+              threadId: turn.threadId,
+              runId: null,
+              nodeId: turn.rootNodeId,
+              providerThreadId: state.providerThread.id,
+              providerTurnId: turn.providerTurnId,
+              nativeItemRef: providerRef(part.messageID),
+              parentItemId: null,
+              ordinal: itemOrdinal(turn, part.messageID),
+              status: "completed",
+              title: null,
+              startedAt: projected.createdAt,
+              completedAt: now,
+              updatedAt: now,
+              type: "user_message",
+              messageId,
+              inputIntent: "turn_start",
+              text: part.text,
+              attachments: [],
+            },
+          });
+        });
+
+        const handleMessageUpdated = Effect.fnUntraced(function* (
+          event: Extract<OpenCodeEvent, { type: "message.updated" }>,
+        ) {
+          const state = threads.get(event.properties.sessionID);
+          if (state === undefined) return;
+          const message = event.properties.info;
+          state.messageRoles.set(message.id, message.role);
+          if (message.role !== "user") return;
+          const isNewUserMessage = !state.userMessageIds.includes(message.id);
+          if (isNewUserMessage) state.userMessageIds.push(message.id);
+          let turn = state.activeTurn;
+          if (turn === null && state.parentSubagent !== null && isNewUserMessage) {
+            turn = yield* createChildTurn(state, message);
+          }
+          const matchesAdmission =
+            turn !== null &&
+            (turn.admissionMessageId === null || turn.admissionMessageId === message.id);
+          if (turn !== null && matchesAdmission && turn.nativeUserMessageId === null) {
+            turn.nativeUserMessageId = message.id;
+            yield* emitProviderTurn(state, turn, "running", null);
+          }
+          if (turn !== null && matchesAdmission && turn.admissionPending) {
+            if (advanceOpenCodePromptAdmission(turn, "user-message") === "reconcile-idle") {
+              yield* reconcilePromptAdmission(state, turn);
+            }
+          }
+        });
+
+        const handlePartUpdated = Effect.fnUntraced(function* (
+          event: Extract<OpenCodeEvent, { type: "message.part.updated" }>,
+        ) {
+          const part = event.properties.part;
+          const state = threads.get(part.sessionID);
+          const turn = state?.activeTurn;
+          if (state === undefined || turn === null || turn === undefined || turn.finalized) return;
+          if (part.type === "text" && state.messageRoles.get(part.messageID) === "user") {
+            if (!turn.isRoot) yield* projectChildUserPart(state, turn, part);
+            return;
+          }
+          turn.parts.set(part.id, part);
+          const ids = turn.partIdsByMessage.get(part.messageID) ?? new Set<string>();
+          ids.add(part.id);
+          turn.partIdsByMessage.set(part.messageID, ids);
+          switch (part.type) {
+            case "text":
+            case "reasoning":
+              yield* emitTextPart(state, turn, part);
+              return;
+            case "tool":
+              yield* emitToolPart(state, turn, part);
+              return;
+            default:
+              return;
+          }
+        });
+
+        const handlePartDelta = Effect.fnUntraced(function* (
+          event: Extract<OpenCodeEvent, { type: "message.part.delta" }>,
+        ) {
+          if (event.properties.field !== "text") return;
+          const state = threads.get(event.properties.sessionID);
+          const turn = state?.activeTurn;
+          const current = turn?.parts.get(event.properties.partID);
+          if (
+            state === undefined ||
+            turn === null ||
+            turn === undefined ||
+            current === undefined ||
+            (current.type !== "text" && current.type !== "reasoning")
+          ) {
+            return;
+          }
+          const updated = { ...current, text: current.text + event.properties.delta };
+          turn.parts.set(updated.id, updated);
+          yield* emitTextPart(state, turn, updated);
+        });
+
+        const handleAssistantCompleted = Effect.fnUntraced(function* (
+          event: Extract<OpenCodeEvent, { type: "message.updated" }>,
+        ) {
+          const message = event.properties.info;
+          if (message.role !== "assistant" || message.time.completed === undefined) return;
+          const state = threads.get(message.sessionID);
+          const turn = state?.activeTurn;
+          if (state === undefined || turn === null || turn === undefined) return;
+          for (const partId of turn.partIdsByMessage.get(message.id) ?? []) {
+            const part = turn.parts.get(partId);
+            if (part?.type === "text" || part?.type === "reasoning") {
+              yield* emitTextPart(state, turn, part, true);
+            }
+          }
+        });
+
+        const handleEvent = Effect.fnUntraced(function* (event: OpenCodeEvent) {
+          yield* logProtocolEvent({
+            direction: "incoming",
+            messageKind: "notification",
+            method: event.type,
+            payload: event,
+          });
+          switch (event.type) {
+            case "message.updated":
+              yield* handleMessageUpdated(event);
+              yield* handleAssistantCompleted(event);
+              return;
+            case "message.part.updated":
+              yield* handlePartUpdated(event);
+              return;
+            case "message.part.delta":
+              yield* handlePartDelta(event);
+              return;
+            case "todo.updated": {
+              const state = threads.get(event.properties.sessionID);
+              if (state?.activeTurn !== null && state?.activeTurn !== undefined) {
+                yield* emitTodo(state, state.activeTurn, event.properties.todos);
+              }
+              return;
+            }
+            case "permission.asked": {
+              const state = requestOwnerState(event.properties.sessionID);
+              if (state?.activeTurn !== null && state?.activeTurn !== undefined) {
+                yield* emitRuntimeRequest(state, state.activeTurn, event.properties.id, {
+                  type: "permission",
+                  value: event.properties,
+                });
+              } else {
+                yield* routeChildRequest(event.properties.id, event.properties.sessionID, {
+                  type: "permission",
+                  value: event.properties,
+                });
+              }
+              return;
+            }
+            case "question.asked": {
+              const state = requestOwnerState(event.properties.sessionID);
+              if (state?.activeTurn !== null && state?.activeTurn !== undefined) {
+                yield* emitRuntimeRequest(state, state.activeTurn, event.properties.id, {
+                  type: "question",
+                  value: event.properties,
+                });
+              } else {
+                yield* routeChildRequest(event.properties.id, event.properties.sessionID, {
+                  type: "question",
+                  value: event.properties,
+                });
+              }
+              return;
+            }
+            case "permission.replied":
+            case "question.replied":
+              rememberSettledRequest(event.properties.requestID);
+              yield* resolveRuntimeRequest(event.properties.requestID, "resolved");
+              return;
+            case "question.rejected":
+              rememberSettledRequest(event.properties.requestID);
+              yield* resolveRuntimeRequest(event.properties.requestID, "cancelled");
+              return;
+            case "session.created":
+            case "session.updated": {
+              const info = event.properties.info;
+              if (info.parentID !== undefined && !threads.has(info.id)) {
+                const owner = threads.get(info.parentID) ?? relatedSessionOwners.get(info.parentID);
+                if (owner !== undefined) {
+                  relatedSessionOwners.set(info.id, owner);
+                }
+              }
+              return;
+            }
+            case "session.deleted":
+              relatedSessionOwners.delete(event.properties.info.id);
+              return;
+            case "session.status": {
+              const state = threads.get(event.properties.sessionID);
+              if (state === undefined) return;
+              if (event.properties.status.type === "busy") {
+                yield* updateProviderThread(state, { status: "active" });
+                return;
+              }
+              if (event.properties.status.type === "idle" && state.activeTurn !== null) {
+                if (state.activeTurn.admissionPending) {
+                  advanceOpenCodePromptAdmission(state.activeTurn, "idle");
+                  return;
+                }
+                yield* finalizeTurn(
+                  state,
+                  state.activeTurn,
+                  state.activeTurn.interrupted ? "interrupted" : "completed",
+                );
+              }
+              return;
+            }
+            case "session.idle": {
+              const state = threads.get(event.properties.sessionID);
+              if (state?.activeTurn !== null && state?.activeTurn !== undefined) {
+                if (state.activeTurn.admissionPending) {
+                  advanceOpenCodePromptAdmission(state.activeTurn, "idle");
+                  return;
+                }
+                yield* finalizeTurn(
+                  state,
+                  state.activeTurn,
+                  state.activeTurn.interrupted ? "interrupted" : "completed",
+                );
+              }
+              return;
+            }
+            case "session.error": {
+              const states =
+                event.properties.sessionID === undefined
+                  ? Array.from(threads.values()).filter((state) => state.activeTurn !== null)
+                  : [threads.get(event.properties.sessionID)].filter(
+                      (state): state is OpenCodeThreadState => state !== undefined,
+                    );
+              const message = openCodeErrorMessage(event);
+              if (
+                !isMessageAbortedError(event) &&
+                (event.properties.sessionID === undefined ||
+                  states.some((state) => state.parentSubagent === null))
+              ) {
+                yield* updateProviderSession("error", message);
+              }
+              for (const state of states) {
+                if (state.activeTurn !== null) {
+                  yield* finalizeTurn(
+                    state,
+                    state.activeTurn,
+                    terminalStatusForError(event, state.activeTurn),
+                    {
+                      failure: makeProviderFailure({
+                        message,
+                        code: event.properties.error?.name ?? null,
+                        class: "provider_error",
+                      }),
+                      threadDisposition:
+                        event.properties.sessionID === undefined ? "broken" : "reusable",
+                    },
+                  );
+                }
+              }
+              return;
+            }
+            default:
+              return;
+          }
+        });
+
+        const inputProviderSessionId = input.providerSessionId;
+
+        const subscription = yield* sdkCall("event.subscribe", {}, () =>
+          client.event.subscribe(undefined, { signal: abortController.signal }),
+        );
+        yield* Scope.addFinalizer(
+          scope,
+          Effect.sync(() => abortController.abort()),
+        );
+        yield* Stream.fromAsyncIterable(
+          subscription.stream,
+          (cause) =>
+            new OpenCodeRuntimeError({
+              operation: "event.subscribe",
+              detail: openCodeRuntimeErrorDetail(cause),
+              cause,
+            }),
+        ).pipe(
+          Stream.runForEach(handleEvent),
+          Effect.exit,
+          Effect.flatMap((exit) =>
+            Effect.gen(function* () {
+              if (abortController.signal.aborted || Exit.isSuccess(exit)) return;
+              const detail = openCodeRuntimeErrorDetail(Cause.squash(exit.cause));
+              yield* updateProviderSession("error", detail);
+              for (const state of threads.values()) {
+                if (state.activeTurn !== null)
+                  yield* finalizeTurn(state, state.activeTurn, "failed", {
+                    failure: makeProviderFailure({ message: detail, class: "transport_error" }),
+                    threadDisposition: "broken",
+                  });
+              }
+            }),
+          ),
+          Effect.forkIn(scope),
+        );
+
+        if (!connection.external && connection.exitCode !== null) {
+          yield* connection.exitCode.pipe(
+            Effect.flatMap((code) =>
+              abortController.signal.aborted
+                ? Effect.void
+                : Effect.gen(function* () {
+                    const detail = `OpenCode server exited unexpectedly (${code}).`;
+                    yield* updateProviderSession("error", detail);
+                    for (const state of threads.values()) {
+                      if (state.activeTurn !== null) {
+                        yield* finalizeTurn(state, state.activeTurn, "failed", {
+                          failure: makeProviderFailure({
+                            message: detail,
+                            class: "transport_error",
+                          }),
+                          threadDisposition: "broken",
+                        });
+                      }
+                    }
+                  }),
+            ),
+            Effect.forkIn(scope),
+          );
+        }
+
+        const registerThread = (
+          nativeSession: OpenCodeSession,
+          providerThread: OrchestrationV2ProviderThread,
+          appThread: OrchestrationV2AppThread | null,
+        ): OpenCodeThreadState => {
+          const existing = threads.get(nativeSession.id);
+          if (existing !== undefined) {
+            existing.providerThread = providerThread;
+            if (appThread !== null) existing.appThread = appThread;
+            return existing;
+          }
+          const state: OpenCodeThreadState = {
+            nativeSessionId: nativeSession.id,
+            providerThread,
+            appThread,
+            activeTurn: null,
+            providerTurns: new Map(),
+            messages: new Map(),
+            runtimeRequests: new Map(),
+            messageRoles: new Map(),
+            userMessageIds: [],
+            parentSubagent: subagentsByChildSessionId.get(nativeSession.id) ?? null,
+            nextChildTurnOrdinal: 1,
+            nextAdmissionGeneration: 1,
+          };
+          threads.set(nativeSession.id, state);
+          return state;
+        };
+
+        const resolvePromptParts = (turnInput: ProviderAdapterV2TurnInput) => {
+          const text = providerMessageTextWithAttachmentPaths({
+            text: turnInput.message.text,
+            attachments: turnInput.message.attachments,
+            attachmentsDir: serverConfig.attachmentsDir,
+          }).trim();
+          const files = toOpenCodeFileParts({
+            attachments: turnInput.message.attachments,
+            resolveAttachmentPath: (attachment) =>
+              resolveAttachmentPath({ attachmentsDir: serverConfig.attachmentsDir, attachment }),
+          });
+          if (text.length === 0 && files.length === 0) {
+            throw protocolError("OpenCode turns require text or at least one valid attachment");
+          }
+          return [...(text.length === 0 ? [] : [{ type: "text" as const, text }]), ...files];
+        };
+
+        const readSnapshot = Effect.fnUntraced(function* (
+          providerThread: OrchestrationV2ProviderThread,
+        ) {
+          const sessionId = nativeThreadId(providerThread);
+          const response = yield* sdkCall("session.messages", { sessionID: sessionId }, () =>
+            client.session.messages({ sessionID: sessionId }),
+          );
+          const nativeMessages = unwrapData("session.messages", response);
+          const state = threads.get(sessionId);
+          const snapshotNow = yield* DateTime.now;
+          const messages: Array<OrchestrationV2ConversationMessage> = nativeMessages.flatMap(
+            ({ info, parts }) => {
+              const text = parts
+                .filter(
+                  (part): part is Extract<OpenCodePart, { type: "text" }> => part.type === "text",
+                )
+                .filter((part) => part.ignored !== true && part.synthetic !== true)
+                .map((part) => part.text)
+                .join("\n");
+              if (text.length === 0) return [];
+              const createdAt = dateTimeFromEpoch(info.time.created, snapshotNow);
+              return [
+                {
+                  createdBy: info.role === "user" ? "user" : "agent",
+                  creationSource: "provider",
+                  id: idAllocator.derive.messageFromProviderItem({
+                    driver: OPENCODE_PROVIDER,
+                    nativeItemId: info.id,
+                  }),
+                  threadId: providerThread.appThreadId ?? input.threadId,
+                  runId: null,
+                  nodeId: null,
+                  role: info.role,
+                  text,
+                  attachments: [],
+                  streaming: false,
+                  createdAt,
+                  updatedAt:
+                    info.role === "assistant"
+                      ? dateTimeFromEpoch(info.time.completed, createdAt)
+                      : createdAt,
+                },
+              ];
+            },
+          );
+          const lastUser = nativeMessages.findLast(({ info }) => info.role === "user")?.info.id;
+          return {
+            providerThread: {
+              ...providerThread,
+              providerSessionId: input.providerSessionId,
+              nativeConversationHeadRef:
+                lastUser === undefined ? null : providerRef(lastUser, "weak"),
+              status: "idle" as const,
+              updatedAt: snapshotNow,
+            },
+            providerTurns: state === undefined ? [] : [...state.providerTurns.values()],
+            messages,
+            runtimeRequests: state === undefined ? [] : [...state.runtimeRequests.values()],
+            providerPayload: nativeMessages,
+          };
+        });
+
+        const runtimeSession: ProviderAdapterV2SessionRuntime = {
+          instanceId: options.instanceId,
+          driver: OPENCODE_PROVIDER,
+          providerSessionId: input.providerSessionId,
+          providerSession: sessionEntity,
+          events: Stream.fromEffectRepeat(Queue.take(events)),
+          ensureThread: (threadInput) =>
+            Effect.gen(function* () {
+              if (threadInput.existingProviderThread !== undefined) {
+                return yield* runtimeSession.resumeThread({
+                  providerThread: threadInput.existingProviderThread,
+                });
+              }
+              const response = yield* sdkCall(
+                "session.create",
+                {
+                  title: `T3 Code ${threadInput.threadId}`,
+                  permission: openCodePermissionRules(threadInput.runtimePolicy),
+                },
+                () =>
+                  client.session.create({
+                    title: `T3 Code ${threadInput.threadId}`,
+                    permission: openCodePermissionRules(threadInput.runtimePolicy),
+                  }),
+              );
+              const nativeSession = unwrapData("session.create", response);
+              const createdAt = yield* DateTime.now;
+              const providerThread = makeProviderThread({
+                idAllocator,
+                providerInstanceId: options.instanceId,
+                providerSessionId: input.providerSessionId,
+                appThreadId: threadInput.threadId,
+                nativeSession,
+                now: createdAt,
+              });
+              registerThread(nativeSession, providerThread, null);
+              return providerThread;
+            }).pipe(
+              Effect.mapError(
+                (cause) =>
+                  new ProviderAdapterEnsureThreadError({
+                    driver: OPENCODE_PROVIDER,
+                    threadId: threadInput.threadId,
+                    cause,
+                  }),
+              ),
+            ),
+          resumeThread: (threadInput) =>
+            Effect.gen(function* () {
+              const sessionId = nativeThreadId(threadInput.providerThread);
+              const response = yield* sdkCall("session.get", { sessionID: sessionId }, () =>
+                client.session.get({ sessionID: sessionId }),
+              );
+              const nativeSession = unwrapData("session.get", response);
+              const resumedAt = yield* DateTime.now;
+              const providerThread = {
+                ...threadInput.providerThread,
+                providerSessionId: input.providerSessionId,
+                status: "idle" as const,
+                updatedAt: dateTimeFromEpoch(nativeSession.time.updated, resumedAt),
+              };
+              registerThread(nativeSession, providerThread, null);
+              return providerThread;
+            }).pipe(
+              Effect.mapError(
+                (cause) =>
+                  new ProviderAdapterResumeThreadError({
+                    driver: OPENCODE_PROVIDER,
+                    providerSessionId: input.providerSessionId,
+                    providerThreadId: threadInput.providerThread.id,
+                    cause,
+                  }),
+              ),
+            ),
+          startTurn: (turnInput) =>
+            Effect.gen(function* () {
+              const sessionId = nativeThreadId(turnInput.providerThread);
+              const state = threads.get(sessionId);
+              if (state === undefined) {
+                return yield* protocolError(`OpenCode session ${sessionId} is not registered`);
+              }
+              if (state.activeTurn !== null) {
+                return yield* protocolError(
+                  `OpenCode provider thread ${turnInput.providerThread.id} already has an active turn`,
+                );
+              }
+              const parsedModel = parseOpenCodeModelSlug(turnInput.modelSelection.model);
+              if (parsedModel === null) {
+                return yield* protocolError(
+                  `OpenCode model '${turnInput.modelSelection.model}' must use provider/model format`,
+                );
+              }
+              const parts = resolvePromptParts(turnInput);
+              const startedAt = yield* DateTime.now;
+              const syntheticNativeTurnId = `${sessionId}:attempt:${turnInput.attemptId}`;
+              const providerTurnId = idAllocator.derive.providerTurn({
+                driver: OPENCODE_PROVIDER,
+                nativeTurnId: syntheticNativeTurnId,
+              });
+              const providerTurn: OrchestrationV2ProviderTurn = {
+                id: providerTurnId,
+                providerThreadId: turnInput.providerThread.id,
+                nodeId: turnInput.rootNodeId,
+                runAttemptId: turnInput.attemptId,
+                nativeTurnRef: providerRef(syntheticNativeTurnId, "weak"),
+                ordinal: turnInput.providerTurnOrdinal,
+                status: "running",
+                startedAt,
+                completedAt: null,
+              };
+              const turn: ActiveOpenCodeTurn = {
+                isRoot: true,
+                threadId: turnInput.threadId,
+                runId: turnInput.runId,
+                rootNodeId: turnInput.rootNodeId,
+                appThread: turnInput.appThread,
+                modelSelection: turnInput.modelSelection,
+                runtimePolicy: turnInput.runtimePolicy,
+                providerTurnId,
+                providerTurnOrdinal: turnInput.providerTurnOrdinal,
+                runOrdinal: turnInput.runOrdinal,
+                runAttemptId: turnInput.attemptId,
+                startedAt,
+                itemOrdinals: new Map(),
+                parts: new Map(),
+                partIdsByMessage: new Map(),
+                providerTurn,
+                nextItemOrdinal: turnInput.providerTurnOrdinal * 100 + 1,
+                nativeUserMessageId: null,
+                admissionMessageId: yield* makeOpenCodeMessageId(),
+                interrupted: false,
+                finalized: false,
+                planId: null,
+                admissionGeneration: state.nextAdmissionGeneration++,
+                admissionReconciliationGeneration: null,
+                admissionPending: true,
+                admissionAccepted: false,
+                admissionMessageObserved: false,
+                idleDuringAdmission: false,
+                admissionSettled: Deferred.makeUnsafe<void>(),
+                admissionAbortController: new AbortController(),
+              };
+              const admissionSettled = turn.admissionSettled;
+              const admissionAbortController = turn.admissionAbortController;
+              state.appThread = turnInput.appThread;
+              state.activeTurn = turn;
+              state.providerTurns.set(String(providerTurnId), providerTurn);
+              yield* emitProviderTurn(state, turn, "running", null);
+              yield* updateProviderThread(state, {
+                status: "active",
+                firstRunOrdinal: state.providerThread.firstRunOrdinal ?? turnInput.runOrdinal,
+                lastRunOrdinal: turnInput.runOrdinal,
+              });
+              yield* updateProviderSession("running", null);
+              const agent =
+                getModelSelectionStringOptionValue(turnInput.modelSelection, "agent") ??
+                (turnInput.runtimePolicy.interactionMode === "plan" ? "plan" : undefined);
+              const variant = getModelSelectionStringOptionValue(
+                turnInput.modelSelection,
+                "variant",
+              );
+              yield* sdkCall(
+                "session.promptAsync",
+                {
+                  sessionID: sessionId,
+                  messageID: turn.admissionMessageId!,
+                  model: parsedModel,
+                  ...(agent === undefined ? {} : { agent }),
+                  ...(variant === undefined ? {} : { variant }),
+                  ...(orchestrationSystemPrompt === undefined
+                    ? {}
+                    : { system: orchestrationSystemPrompt }),
+                  parts,
+                },
+                (signal) =>
+                  client.session.promptAsync(
+                    {
+                      sessionID: sessionId,
+                      messageID: turn.admissionMessageId!,
+                      model: parsedModel,
+                      ...(agent === undefined ? {} : { agent }),
+                      ...(variant === undefined ? {} : { variant }),
+                      ...(orchestrationSystemPrompt === undefined
+                        ? {}
+                        : { system: orchestrationSystemPrompt }),
+                      parts,
+                    },
+                    { signal: AbortSignal.any([signal, admissionAbortController!.signal]) },
+                  ),
+              ).pipe(
+                Effect.tapError((cause) =>
+                  admissionAbortController!.signal.aborted
+                    ? Effect.void
+                    : finalizeTurn(state, turn, "failed", {
+                        failure: makeProviderFailure({ cause, class: "provider_error" }),
+                      }),
+                ),
+                Effect.catch((cause) =>
+                  admissionAbortController!.signal.aborted ? Effect.void : Effect.fail(cause),
+                ),
+                Effect.ensuring(
+                  Effect.all([
+                    Deferred.succeed(admissionSettled, undefined).pipe(Effect.ignore),
+                    Effect.sync(() => {
+                      if (turn.admissionAbortController === admissionAbortController) {
+                        turn.admissionAbortController = null;
+                      }
+                    }),
+                  ]).pipe(Effect.asVoid),
+                ),
+              );
+              if (state.activeTurn === turn && !turn.finalized && !turn.interrupted) {
+                const admissionAction = advanceOpenCodePromptAdmission(turn, "accepted");
+                if (admissionAction === "reconcile-idle") {
+                  yield* reconcilePromptAdmission(state, turn);
+                }
+              }
+            }).pipe(
+              Effect.mapError(
+                (cause) =>
+                  new ProviderAdapterTurnStartError({
+                    driver: OPENCODE_PROVIDER,
+                    threadId: turnInput.threadId,
+                    providerThreadId: turnInput.providerThread.id,
+                    runId: turnInput.runId,
+                    cause,
+                  }),
+              ),
+            ),
+          steerTurn: (steerInput) =>
+            Effect.gen(function* () {
+              const sessionId = nativeThreadId(steerInput.providerThread);
+              const state = threads.get(sessionId);
+              const turn = state?.activeTurn;
+              if (
+                state === undefined ||
+                turn === undefined ||
+                turn === null ||
+                turn.providerTurnId !== steerInput.providerTurnId ||
+                turn.interrupted
+              ) {
+                return yield* protocolError(
+                  `OpenCode turn ${steerInput.providerTurnId} is not active`,
+                );
+              }
+              const parsedModel = parseOpenCodeModelSlug(turn.modelSelection.model);
+              if (parsedModel === null) {
+                return yield* protocolError(
+                  `OpenCode model '${turn.modelSelection.model}' must use provider/model format`,
+                );
+              }
+              const text = providerMessageTextWithAttachmentPaths({
+                text: steerInput.message.text,
+                attachments: steerInput.message.attachments,
+                attachmentsDir: serverConfig.attachmentsDir,
+              }).trim();
+              const files = toOpenCodeFileParts({
+                attachments: steerInput.message.attachments,
+                resolveAttachmentPath: (attachment) =>
+                  resolveAttachmentPath({
+                    attachmentsDir: serverConfig.attachmentsDir,
+                    attachment,
+                  }),
+              });
+              if (text.length === 0 && files.length === 0) {
+                return yield* protocolError("OpenCode steering requires text or an attachment");
+              }
+              const parts = [
+                ...(text.length === 0 ? [] : [{ type: "text" as const, text }]),
+                ...files,
+              ];
+              turn.admissionGeneration = state.nextAdmissionGeneration++;
+              turn.admissionMessageId = yield* makeOpenCodeMessageId();
+              turn.admissionPending = true;
+              turn.admissionAccepted = false;
+              turn.admissionMessageObserved = false;
+              turn.idleDuringAdmission = false;
+              turn.admissionSettled = Deferred.makeUnsafe<void>();
+              turn.admissionAbortController = new AbortController();
+              const admissionSettled = turn.admissionSettled;
+              const admissionAbortController = turn.admissionAbortController;
+              yield* sdkCall(
+                "session.promptAsync",
+                {
+                  sessionID: sessionId,
+                  messageID: turn.admissionMessageId,
+                  model: parsedModel,
+                  parts,
+                },
+                (signal) =>
+                  client.session.promptAsync(
+                    {
+                      sessionID: sessionId,
+                      messageID: turn.admissionMessageId!,
+                      model: parsedModel,
+                      parts,
+                    },
+                    { signal: AbortSignal.any([signal, admissionAbortController.signal]) },
+                  ),
+              ).pipe(
+                Effect.ensuring(
+                  Effect.all([
+                    Deferred.succeed(admissionSettled, undefined).pipe(Effect.ignore),
+                    Effect.sync(() => {
+                      if (turn.admissionAbortController === admissionAbortController) {
+                        turn.admissionAbortController = null;
+                      }
+                    }),
+                  ]).pipe(Effect.asVoid),
+                ),
+              );
+              if (state.activeTurn === turn && !turn.finalized) {
+                const admissionAction = advanceOpenCodePromptAdmission(turn, "accepted");
+                if (admissionAction === "reconcile-idle") {
+                  yield* reconcilePromptAdmission(state, turn);
+                }
+              }
+            }).pipe(
+              Effect.mapError(
+                (cause) =>
+                  new ProviderAdapterSteerRunError({
+                    driver: OPENCODE_PROVIDER,
+                    providerThreadId: steerInput.providerThread.id,
+                    providerTurnId: steerInput.providerTurnId,
+                    cause,
+                  }),
+              ),
+            ),
+          interruptTurn: (interruptInput) =>
+            Effect.gen(function* () {
+              const sessionId = nativeThreadId(interruptInput.providerThread);
+              const state = threads.get(sessionId);
+              const turn = state?.activeTurn;
+              if (
+                turn === undefined ||
+                turn === null ||
+                turn.providerTurnId !== interruptInput.providerTurnId
+              ) {
+                return yield* protocolError(
+                  `OpenCode turn ${interruptInput.providerTurnId} is not active`,
+                );
+              }
+              turn.interrupted = true;
+              const admissionWasPending = turn.admissionPending;
+              cancelOpenCodePromptAdmission(turn, state!.nextAdmissionGeneration++);
+              turn.admissionAbortController?.abort();
+              if (admissionWasPending) {
+                // Settle the cancelled request before sending the session abort.
+                // A timed-out local request must not prevent the definitive
+                // server-side abort below from running.
+                yield* Deferred.await(turn.admissionSettled).pipe(
+                  Effect.timeout("10 seconds"),
+                  Effect.ignore,
+                );
+              }
+              yield* sdkCall("session.abort", { sessionID: sessionId }, () =>
+                client.session.abort({ sessionID: sessionId }),
+              ).pipe(
+                Effect.timeout("10 seconds"),
+                // The turn can settle while the abort is in flight, and
+                // aborting an already-idle session fails. That stop still
+                // succeeded; only surface failures for a turn that is
+                // genuinely still running.
+                Effect.catch((cause) =>
+                  turn.finalized
+                    ? Effect.void
+                    : Effect.suspend(() => {
+                        turn.interrupted = false;
+                        return Effect.fail(cause);
+                      }),
+                ),
+              );
+            }).pipe(
+              Effect.mapError(
+                (cause) =>
+                  new ProviderAdapterInterruptError({
+                    driver: OPENCODE_PROVIDER,
+                    providerThreadId: interruptInput.providerThread.id,
+                    providerTurnId: interruptInput.providerTurnId,
+                    cause,
+                  }),
+              ),
+            ),
+          respondToRuntimeRequest: (requestInput) =>
+            Effect.gen(function* () {
+              const pending = pendingRequests.get(String(requestInput.requestId));
+              if (pending === undefined) {
+                return yield* protocolError(
+                  `No pending OpenCode request ${requestInput.requestId}`,
+                );
+              }
+              if (pending.question !== undefined) {
+                if (requestInput.answers === undefined) {
+                  return yield* protocolError(
+                    `OpenCode question request ${requestInput.requestId} requires answers`,
+                  );
+                }
+                const answers = toOpenCodeQuestionAnswers(pending.question, requestInput.answers);
+                yield* sdkCall(
+                  "question.reply",
+                  { requestID: pending.nativeRequestId, answers },
+                  () =>
+                    client.question.reply({
+                      requestID: pending.nativeRequestId,
+                      answers,
+                    }),
+                );
+                return;
+              }
+              if (requestInput.decision === undefined) {
+                return yield* protocolError(
+                  `OpenCode approval request ${requestInput.requestId} requires a decision`,
+                );
+              }
+              const reply = toOpenCodePermissionReply(requestInput.decision);
+              yield* sdkCall(
+                "permission.reply",
+                { requestID: pending.nativeRequestId, reply },
+                () =>
+                  client.permission.reply({
+                    requestID: pending.nativeRequestId,
+                    reply,
+                  }),
+              );
+            }).pipe(
+              Effect.mapError(
+                (cause) =>
+                  new ProviderAdapterRuntimeRequestResponseError({
+                    driver: OPENCODE_PROVIDER,
+                    requestId: requestInput.requestId,
+                    cause,
+                  }),
+              ),
+            ),
+          readThreadSnapshot: (snapshotInput) =>
+            readSnapshot(snapshotInput.providerThread).pipe(
+              Effect.mapError(
+                (cause) =>
+                  new ProviderAdapterReadThreadSnapshotError({
+                    driver: OPENCODE_PROVIDER,
+                    providerThreadId: snapshotInput.providerThread.id,
+                    cause,
+                  }),
+              ),
+            ),
+          rollbackThread: (rollbackInput) =>
+            Effect.gen(function* () {
+              const sessionId = nativeThreadId(rollbackInput.providerThread);
+              const state = threads.get(sessionId);
+              if (state?.activeTurn !== null && state?.activeTurn !== undefined) {
+                return yield* protocolError(
+                  `Cannot roll back OpenCode thread ${rollbackInput.providerThread.id} while a turn is active`,
+                );
+              }
+              const response = yield* sdkCall("session.messages", { sessionID: sessionId }, () =>
+                client.session.messages({ sessionID: sessionId }),
+              );
+              const messages = unwrapData("session.messages", response);
+              let boundaryMessageId: string | undefined;
+              if (rollbackInput.target.type === "thread_start") {
+                boundaryMessageId = messages.find(({ info }) => info.role === "user")?.info.id;
+              } else {
+                boundaryMessageId = openCodeBoundaryAfterProviderTurn(
+                  rollbackInput.providerThreadTurns,
+                  rollbackInput.target.providerTurn.id,
+                );
+              }
+              if (boundaryMessageId !== undefined) {
+                yield* sdkCall(
+                  "session.revert",
+                  { sessionID: sessionId, messageID: boundaryMessageId },
+                  () =>
+                    client.session.revert({ sessionID: sessionId, messageID: boundaryMessageId }),
+                );
+              }
+              const snapshot = yield* readSnapshot(rollbackInput.providerThread);
+              return {
+                ...snapshot,
+                providerThread: {
+                  ...snapshot.providerThread,
+                  nativeConversationHeadRef:
+                    rollbackInput.target.type === "provider_turn"
+                      ? rollbackInput.target.providerTurn.nativeTurnRef
+                      : null,
+                },
+              };
+            }).pipe(
+              Effect.mapError(
+                (cause) =>
+                  new ProviderAdapterRollbackThreadError({
+                    driver: OPENCODE_PROVIDER,
+                    providerThreadId: rollbackInput.providerThread.id,
+                    checkpointId: rollbackInput.target.checkpointId,
+                    cause,
+                  }),
+              ),
+            ),
+          forkThread: (forkInput) =>
+            Effect.gen(function* () {
+              const sourceSessionId = nativeThreadId(forkInput.sourceProviderThread);
+              const sourceState = threads.get(sourceSessionId);
+              if (sourceState?.activeTurn !== null && sourceState?.activeTurn !== undefined) {
+                return yield* protocolError(
+                  `Cannot fork OpenCode thread ${forkInput.sourceProviderThread.id} while a turn is active`,
+                );
+              }
+              let boundaryMessageId: string | undefined;
+              if (forkInput.providerTurnId !== undefined) {
+                const sourceTurns = forkInput.sourceProviderTurns ?? [];
+                const selected = sourceTurns.find((turn) => turn.id === forkInput.providerTurnId);
+                if (selected === undefined) {
+                  return yield* protocolError(
+                    `OpenCode fork boundary turn ${forkInput.providerTurnId} was not found`,
+                  );
+                }
+                boundaryMessageId = openCodeBoundaryAfterProviderTurn(sourceTurns, selected.id);
+              }
+              const response = yield* sdkCall(
+                "session.fork",
+                {
+                  sessionID: sourceSessionId,
+                  ...(boundaryMessageId === undefined ? {} : { messageID: boundaryMessageId }),
+                },
+                () =>
+                  client.session.fork({
+                    sessionID: sourceSessionId,
+                    ...(boundaryMessageId === undefined ? {} : { messageID: boundaryMessageId }),
+                  }),
+              );
+              const nativeSession = unwrapData("session.fork", response);
+              const forkedAt = yield* DateTime.now;
+              const providerThread = makeProviderThread({
+                idAllocator,
+                providerInstanceId: options.instanceId,
+                providerSessionId: input.providerSessionId,
+                appThreadId: forkInput.targetThreadId,
+                ...(forkInput.ownerNodeId === undefined
+                  ? {}
+                  : { ownerNodeId: forkInput.ownerNodeId }),
+                nativeSession,
+                forkedFrom: {
+                  providerThreadId: forkInput.sourceProviderThread.id,
+                  ...(forkInput.providerTurnId === undefined
+                    ? {}
+                    : { providerTurnId: forkInput.providerTurnId }),
+                },
+                now: forkedAt,
+              });
+              registerThread(nativeSession, providerThread, null);
+              return providerThread;
+            }).pipe(
+              Effect.mapError(
+                (cause) =>
+                  new ProviderAdapterForkThreadError({
+                    driver: OPENCODE_PROVIDER,
+                    providerThreadId: forkInput.sourceProviderThread.id,
+                    cause,
+                  }),
+              ),
+            ),
+        };
+
+        return runtimeSession;
+      },
+      (effect, input) =>
+        effect.pipe(
+          Effect.mapError(
+            (cause) =>
+              new ProviderAdapterOpenSessionError({
+                driver: OPENCODE_PROVIDER,
+                providerSessionId: input.providerSessionId,
+                cause,
+              }),
+          ),
+        ),
+    ),
+  });
+}
+
+export type OpenCodeAdapterV2DriverEnv =
+  | OpenCodeRuntime
+  | IdAllocatorV2
+  | ProviderEventLoggers
+  | ServerConfig;
+
+export const OpenCodeAdapterV2Driver: ProviderAdapterDriver<
+  OpenCodeSettings,
+  OpenCodeAdapterV2DriverEnv
+> = {
+  driverKind: OPENCODE_DRIVER_KIND,
+  configSchema: OpenCodeSettingsSchema,
+  defaultConfig: (): OpenCodeSettings => DEFAULT_OPENCODE_SETTINGS,
+  create: Effect.fn("OpenCodeAdapterV2Driver.create")(
+    function* (input: ProviderAdapterDriverCreateInput<OpenCodeSettings>) {
+      const hostEnvironment = yield* HostProcessEnvironment;
+      const openCodeRuntime = yield* OpenCodeRuntime;
+      const idAllocator = yield* IdAllocatorV2;
+      const providerEventLoggers = yield* ProviderEventLoggers;
+      const serverConfig = yield* ServerConfig;
+      return makeOpenCodeAdapterV2({
+        instanceId: input.instanceId,
+        settings: { ...input.config, enabled: input.enabled },
+        environment: mergeProviderInstanceEnvironment(input.environment, hostEnvironment),
+        runtime: openCodeRuntime,
+        idAllocator,
+        serverConfig,
+        ...(providerEventLoggers.native === undefined
+          ? {}
+          : { nativeEventLogger: providerEventLoggers.native }),
+      });
+    },
+    (effect, input) =>
+      effect.pipe(
+        Effect.mapError(
+          (cause) =>
+            new ProviderAdapterDriverCreateError({
+              driver: OPENCODE_DRIVER_KIND,
+              instanceId: input.instanceId,
+              detail: "Failed to create OpenCode v2 adapter.",
+              cause,
+            }),
+        ),
+      ),
+  ),
+};
+
+export const layer: Layer.Layer<ProviderAdapterV2, never, OpenCodeAdapterV2DriverEnv> =
+  Layer.effect(
+    ProviderAdapterV2,
+    Effect.gen(function* () {
+      const hostEnvironment = yield* HostProcessEnvironment;
+      const openCodeRuntime = yield* OpenCodeRuntime;
+      const idAllocator = yield* IdAllocatorV2;
+      const providerEventLoggers = yield* ProviderEventLoggers;
+      const serverConfig = yield* ServerConfig;
+      return makeOpenCodeAdapterV2({
+        instanceId: OPENCODE_DEFAULT_INSTANCE_ID,
+        settings: DEFAULT_OPENCODE_SETTINGS,
+        environment: hostEnvironment,
+        runtime: openCodeRuntime,
+        idAllocator,
+        serverConfig,
+        ...(providerEventLoggers.native === undefined
+          ? {}
+          : { nativeEventLogger: providerEventLoggers.native }),
+      });
+    }),
+  );
diff --git a/apps/server/src/orchestration-v2/AttachmentClaims.test.ts b/apps/server/src/orchestration-v2/AttachmentClaims.test.ts
new file mode 100644
index 000000000000..608b9a264dce
--- /dev/null
+++ b/apps/server/src/orchestration-v2/AttachmentClaims.test.ts
@@ -0,0 +1,184 @@
+// @effect-diagnostics nodeBuiltinImport:off
+import * as NodeFS from "node:fs";
+import * as NodePath from "node:path";
+
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import { describe, expect, it } from "@effect/vitest";
+import { ChatAttachmentId, type ChatAttachment } from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+
+import {
+  createPendingAttachmentId,
+  parseThreadSegmentFromAttachmentId,
+} from "../attachmentStore.ts";
+import * as ServerConfig from "../config.ts";
+import {
+  attachmentIsPendingUpload,
+  claimPendingAttachments,
+  releaseClaimedAttachments,
+} from "./AttachmentClaims.ts";
+
+const testLayer = Layer.mergeAll(NodeServices.layer).pipe(
+  Layer.provideMerge(ServerConfig.layerTest(process.cwd(), { prefix: "t3-attachment-claims-" })),
+  Layer.provideMerge(NodeServices.layer),
+);
+
+const stagePendingUpload = Effect.fn("test.stagePendingUpload")(function* (input: {
+  readonly name: string;
+  readonly bytes: Uint8Array;
+  readonly mimeType: string;
+}) {
+  const config = yield* ServerConfig.ServerConfig;
+  const pendingId = createPendingAttachmentId();
+  const attachment: ChatAttachment = {
+    type: "image",
+    id: ChatAttachmentId.make(pendingId!),
+    name: input.name,
+    mimeType: input.mimeType,
+    sizeBytes: input.bytes.byteLength,
+  };
+  yield* Effect.sync(() => {
+    NodeFS.mkdirSync(config.attachmentsDir, { recursive: true });
+    NodeFS.writeFileSync(NodePath.join(config.attachmentsDir, `${pendingId}.png`), input.bytes);
+  });
+  return attachment;
+});
+
+describe("AttachmentClaims", () => {
+  it.effect("claims a pending upload into the thread store and rewrites the id", () =>
+    Effect.gen(function* () {
+      const pending = yield* stagePendingUpload({
+        name: "screenshot.png",
+        bytes: new Uint8Array([1, 2, 3, 4]),
+        mimeType: "image/png",
+      });
+      const config = yield* ServerConfig.ServerConfig;
+
+      const claimed = yield* claimPendingAttachments({
+        threadId: "thread-claims-1",
+        attachments: [pending],
+      });
+
+      expect(claimed.attachments).toHaveLength(1);
+      const attachment = claimed.attachments[0]!;
+      expect(attachmentIsPendingUpload(attachment)).toBe(false);
+      expect(parseThreadSegmentFromAttachmentId(attachment.id)).toBe("thread-claims-1");
+      expect(claimed.claimedPaths).toHaveLength(1);
+      expect(NodeFS.existsSync(claimed.claimedPaths[0]!)).toBe(true);
+      // The pending copy stays behind as the retry source.
+      const pendingFiles = NodeFS.readdirSync(config.attachmentsDir).filter((entry) =>
+        entry.startsWith("pending-"),
+      );
+      expect(pendingFiles).toHaveLength(1);
+    }).pipe(Effect.provide(testLayer)),
+  );
+
+  it.effect("passes already-claimed attachments through untouched", () =>
+    Effect.gen(function* () {
+      const stored: ChatAttachment = {
+        type: "image",
+        id: ChatAttachmentId.make("thread-claims-2-00000000-0000-4000-8000-000000000001"),
+        name: "existing.png",
+        mimeType: "image/png",
+        sizeBytes: 4,
+      };
+      const claimed = yield* claimPendingAttachments({
+        threadId: "thread-claims-2",
+        attachments: [stored],
+      });
+      expect(claimed.attachments[0]).toBe(stored);
+      expect(claimed.claimedPaths).toHaveLength(0);
+    }).pipe(Effect.provide(testLayer)),
+  );
+
+  it.effect("rejects a pending ref whose staged file is missing", () =>
+    Effect.gen(function* () {
+      const missing: ChatAttachment = {
+        type: "image",
+        id: ChatAttachmentId.make(createPendingAttachmentId()!),
+        name: "gone.png",
+        mimeType: "image/png",
+        sizeBytes: 4,
+      };
+      const result = yield* Effect.exit(
+        claimPendingAttachments({ threadId: "thread-claims-3", attachments: [missing] }),
+      );
+      expect(result._tag).toBe("Failure");
+    }).pipe(Effect.provide(testLayer)),
+  );
+
+  it.effect("rejects a size mismatch and cleans up earlier claims from the batch", () =>
+    Effect.gen(function* () {
+      const good = yield* stagePendingUpload({
+        name: "one.png",
+        bytes: new Uint8Array([1, 2, 3, 4]),
+        mimeType: "image/png",
+      });
+      const staged = yield* stagePendingUpload({
+        name: "two.png",
+        bytes: new Uint8Array([1, 2, 3, 4]),
+        mimeType: "image/png",
+      });
+      const mismatched = { ...staged, sizeBytes: 999 };
+      const config = yield* ServerConfig.ServerConfig;
+
+      const result = yield* Effect.exit(
+        claimPendingAttachments({
+          threadId: "thread-claims-4",
+          attachments: [good, mismatched],
+        }),
+      );
+
+      expect(result._tag).toBe("Failure");
+      if (result._tag === "Failure") {
+        const error = result.cause;
+        expect(String(error)).toContain("stored size does not match");
+      }
+      // The successfully claimed first attachment was rolled back.
+      const claimedFiles = NodeFS.readdirSync(config.attachmentsDir).filter((entry) =>
+        entry.startsWith("thread-claims-4-"),
+      );
+      expect(claimedFiles).toHaveLength(0);
+    }).pipe(Effect.provide(testLayer)),
+  );
+
+  it.effect("releaseClaimedAttachments removes claimed copies best-effort", () =>
+    Effect.gen(function* () {
+      const pending = yield* stagePendingUpload({
+        name: "release.png",
+        bytes: new Uint8Array([9, 9]),
+        mimeType: "image/png",
+      });
+      const claimed = yield* claimPendingAttachments({
+        threadId: "thread-claims-5",
+        attachments: [pending],
+      });
+      expect(NodeFS.existsSync(claimed.claimedPaths[0]!)).toBe(true);
+      yield* releaseClaimedAttachments(claimed.claimedPaths);
+      expect(NodeFS.existsSync(claimed.claimedPaths[0]!)).toBe(false);
+      // Releasing again is a no-op, not an error.
+      yield* releaseClaimedAttachments(claimed.claimedPaths);
+    }).pipe(Effect.provide(testLayer)),
+  );
+
+  it.effect("treats malformed ids as non-pending and passes them through", () =>
+    Effect.gen(function* () {
+      // Not a parseable pending ref: nothing to claim, so the ref flows
+      // through unchanged and downstream delivery decides what to do with it.
+      const bogus: ChatAttachment = {
+        type: "image",
+        id: ChatAttachmentId.make("pending-not-a-uuid"),
+        name: "weird.png",
+        mimeType: "image/png",
+        sizeBytes: 1,
+      };
+      const claimed = yield* claimPendingAttachments({
+        threadId: "thread-claims-6",
+        attachments: [bogus],
+      });
+      expect(claimed.attachments[0]).toBe(bogus);
+      expect(claimed.claimedPaths).toHaveLength(0);
+    }).pipe(Effect.provide(testLayer)),
+  );
+});
diff --git a/apps/server/src/orchestration-v2/AttachmentClaims.ts b/apps/server/src/orchestration-v2/AttachmentClaims.ts
new file mode 100644
index 000000000000..4657cc4c0321
--- /dev/null
+++ b/apps/server/src/orchestration-v2/AttachmentClaims.ts
@@ -0,0 +1,126 @@
+import * as FileSystem from "effect/FileSystem";
+import { ChatAttachmentId, type ChatAttachment } from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+
+import {
+  parseThreadSegmentFromAttachmentId,
+  PENDING_ATTACHMENT_THREAD_SEGMENT,
+  planAttachmentClaim,
+  resolveAttachmentPath,
+} from "../attachmentStore.ts";
+import * as ServerConfig from "../config.ts";
+
+export class AttachmentClaimError extends Schema.TaggedErrorClass<AttachmentClaimError>()(
+  "AttachmentClaimError",
+  {
+    message: Schema.String,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {}
+
+export interface ClaimedAttachments {
+  readonly attachments: ReadonlyArray<ChatAttachment>;
+  readonly claimedPaths: ReadonlyArray<string>;
+}
+
+export function attachmentIsPendingUpload(attachment: ChatAttachment): boolean {
+  return parseThreadSegmentFromAttachmentId(attachment.id) === PENDING_ATTACHMENT_THREAD_SEGMENT;
+}
+
+/** Best-effort removal of claimed copies after a failed dispatch: the pending
+ *  upload remains the retry source, so only the thread-scoped copies go. */
+export const releaseClaimedAttachments = Effect.fn("AttachmentClaims.releaseClaimedAttachments")(
+  function* (claimedPaths: ReadonlyArray<string>) {
+    if (claimedPaths.length === 0) return;
+    const fileSystem = yield* FileSystem.FileSystem;
+    yield* Effect.forEach(claimedPaths, (path) => fileSystem.remove(path).pipe(Effect.ignore), {
+      concurrency: 1,
+      discard: true,
+    });
+  },
+);
+
+/**
+ * Claims pending uploads into the target thread's attachment store before the
+ * command enters the orchestrator: verifies the staged file, copies it under a
+ * thread-scoped id, and rewrites the attachment ref. A copy, not a move — the
+ * pending file stays behind as the retry source for a failed bootstrap, and
+ * the periodic pending sweep reclaims it later. Already-claimed attachments
+ * pass through untouched.
+ */
+export const claimPendingAttachments = Effect.fn("AttachmentClaims.claimPendingAttachments")(
+  function* (input: {
+    readonly threadId: string;
+    readonly attachments: ReadonlyArray<ChatAttachment>;
+  }) {
+    if (!input.attachments.some(attachmentIsPendingUpload)) {
+      return { attachments: input.attachments, claimedPaths: [] } satisfies ClaimedAttachments;
+    }
+    const serverConfig = yield* ServerConfig.ServerConfig;
+    const fileSystem = yield* FileSystem.FileSystem;
+    const claimedPaths: string[] = [];
+    const attachments = yield* Effect.forEach(
+      input.attachments,
+      (attachment) =>
+        Effect.gen(function* () {
+          if (!attachmentIsPendingUpload(attachment)) {
+            return attachment;
+          }
+          const claim = planAttachmentClaim({
+            attachmentsDir: serverConfig.attachmentsDir,
+            threadId: input.threadId,
+            attachmentId: attachment.id,
+          });
+          if (!claim.ok) {
+            return yield* new AttachmentClaimError({
+              message: `Attachment '${attachment.name}' cannot be sent: ${claim.reason}.`,
+            });
+          }
+          const info = yield* fileSystem.stat(claim.currentPath).pipe(
+            Effect.mapError(
+              (cause) =>
+                new AttachmentClaimError({
+                  message: `Attachment '${attachment.name}' cannot be sent: attachment not found.`,
+                  cause,
+                }),
+            ),
+          );
+          if (Number(info.size) !== attachment.sizeBytes) {
+            return yield* new AttachmentClaimError({
+              message: `Attachment '${attachment.name}' cannot be sent: stored size does not match.`,
+            });
+          }
+          const normalized: ChatAttachment = {
+            ...attachment,
+            id: ChatAttachmentId.make(claim.finalId),
+            mimeType: attachment.mimeType.toLowerCase(),
+          };
+          const expectedPath = resolveAttachmentPath({
+            attachmentsDir: serverConfig.attachmentsDir,
+            attachment: normalized,
+          });
+          if (expectedPath !== claim.finalPath) {
+            return yield* new AttachmentClaimError({
+              message: `Attachment '${attachment.name}' cannot be sent: attachment type does not match the upload.`,
+            });
+          }
+          // A copy, not a hard link: an agent editing the delivered file in
+          // place must not mutate the retry source.
+          yield* fileSystem.copyFile(claim.currentPath, claim.finalPath).pipe(
+            Effect.mapError(
+              (cause) =>
+                new AttachmentClaimError({
+                  message: `Failed to claim attachment '${attachment.name}' for this thread.`,
+                  cause,
+                }),
+            ),
+          );
+          claimedPaths.push(claim.finalPath);
+          return normalized;
+        }),
+      { concurrency: 1 },
+    ).pipe(Effect.tapError(() => releaseClaimedAttachments(claimedPaths)));
+    return { attachments, claimedPaths } satisfies ClaimedAttachments;
+  },
+);
diff --git a/apps/server/src/orchestration-v2/AttachmentPrompt.test.ts b/apps/server/src/orchestration-v2/AttachmentPrompt.test.ts
new file mode 100644
index 000000000000..83fda0054684
--- /dev/null
+++ b/apps/server/src/orchestration-v2/AttachmentPrompt.test.ts
@@ -0,0 +1,41 @@
+import { ChatAttachmentId, ChatFileAttachment, ChatImageAttachment } from "@t3tools/contracts";
+import { assert, describe, it } from "@effect/vitest";
+
+import {
+  isProviderNativeImageAttachment,
+  providerMessageTextWithAttachmentPaths,
+} from "./AttachmentPrompt.ts";
+
+const document = ChatFileAttachment.make({
+  id: ChatAttachmentId.make("file-document"),
+  type: "file",
+  name: "spec.pdf",
+  mimeType: "application/pdf",
+  sizeBytes: 123,
+});
+const image = ChatImageAttachment.make({
+  id: ChatAttachmentId.make("file-image"),
+  type: "image",
+  name: "diagram.png",
+  mimeType: "image/png",
+  sizeBytes: 456,
+});
+
+describe("provider attachment prompts", () => {
+  it("appends resolvable file paths for documents and images", () => {
+    assert.equal(
+      providerMessageTextWithAttachmentPaths({
+        text: "Review these.",
+        attachments: [document, image],
+        attachmentsDir: "/attachments",
+      }),
+      'Review these.\n\n[Attached file "spec.pdf" is saved at: /attachments/file-document.pdf]\n' +
+        '[Attached image "diagram.png" is saved at: /attachments/file-image.png]',
+    );
+  });
+
+  it("classifies only image MIME types for native image payloads", () => {
+    assert.isTrue(isProviderNativeImageAttachment(image));
+    assert.isFalse(isProviderNativeImageAttachment(document));
+  });
+});
diff --git a/apps/server/src/orchestration-v2/AttachmentPrompt.ts b/apps/server/src/orchestration-v2/AttachmentPrompt.ts
new file mode 100644
index 000000000000..150373defc90
--- /dev/null
+++ b/apps/server/src/orchestration-v2/AttachmentPrompt.ts
@@ -0,0 +1,26 @@
+import { type ChatAttachment, isProviderSendTurnSupportedImageMimeType } from "@t3tools/contracts";
+
+import { resolveAttachmentPath } from "../attachmentStore.ts";
+
+export function isProviderNativeImageAttachment(attachment: ChatAttachment): boolean {
+  return (
+    attachment.type === "image" && isProviderSendTurnSupportedImageMimeType(attachment.mimeType)
+  );
+}
+
+export function providerMessageTextWithAttachmentPaths(input: {
+  readonly text: string;
+  readonly attachments: ReadonlyArray<ChatAttachment>;
+  readonly attachmentsDir: string;
+}): string {
+  const paths = input.attachments.flatMap((attachment) => {
+    const path = resolveAttachmentPath({
+      attachmentsDir: input.attachmentsDir,
+      attachment,
+    });
+    return path === null
+      ? []
+      : [`[Attached ${attachment.type} "${attachment.name}" is saved at: ${path}]`];
+  });
+  return [input.text, paths.join("\n")].filter((part) => part.length > 0).join("\n\n");
+}
diff --git a/apps/server/src/orchestration-v2/CheckpointCaptureService.test.ts b/apps/server/src/orchestration-v2/CheckpointCaptureService.test.ts
new file mode 100644
index 000000000000..32c65e7fd7d9
--- /dev/null
+++ b/apps/server/src/orchestration-v2/CheckpointCaptureService.test.ts
@@ -0,0 +1,327 @@
+import { assert, it } from "@effect/vitest";
+import {
+  CheckpointId,
+  CheckpointRef,
+  CheckpointScopeId,
+  EventId,
+  MessageId,
+  NodeId,
+  type OrchestrationV2DomainEvent,
+  type OrchestrationV2Run,
+  ProjectId,
+  ProviderDriverKind,
+  ProviderInstanceId,
+  ProviderThreadId,
+  RunId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Ref from "effect/Ref";
+
+import { SqlitePersistenceMemory } from "../persistence/Layers/Sqlite.ts";
+import { CheckpointServiceV2 } from "./CheckpointService.ts";
+import * as CheckpointCaptureService from "./CheckpointCaptureService.ts";
+import { EventSinkV2 } from "./EventSink.ts";
+import * as IdAllocator from "./IdAllocator.ts";
+import * as ProjectionStore from "./ProjectionStore.ts";
+
+const ProjectionStoreTestLayer = Layer.mergeAll(
+  ProjectionStore.layer.pipe(Layer.provideMerge(SqlitePersistenceMemory)),
+  SqlitePersistenceMemory,
+);
+
+const threadId = ThreadId.make("thread:checkpoint-capture-delegated");
+const projectId = ProjectId.make("project:checkpoint-capture-delegated");
+const runId = RunId.make("run:checkpoint-capture-delegated");
+const scopeId = CheckpointScopeId.make("scope:checkpoint-capture-delegated");
+const rootNodeId = NodeId.make("node:checkpoint-capture-delegated-root");
+const taskId = NodeId.make("node:checkpoint-capture-task");
+const deliveryMessageId = MessageId.make("message:checkpoint-capture-delivery");
+const providerThreadId = ProviderThreadId.make("provider-thread:checkpoint-capture-delegated");
+const providerInstanceId = ProviderInstanceId.make("codex");
+const driver = ProviderDriverKind.make("codex");
+const modelSelection = {
+  instanceId: providerInstanceId,
+  model: "gpt-5.4",
+} as const;
+
+it.layer(ProjectionStoreTestLayer)("CheckpointCaptureServiceV2", (it) => {
+  it.effect(
+    "preserves a newer delegatedCompletion cohort when checkpoint run.updated is applied after it",
+    () =>
+      Effect.gen(function* () {
+        const projectionStore = yield* ProjectionStore.ProjectionStoreV2;
+        const now = yield* DateTime.now;
+        const later = DateTime.add(now, { seconds: 1 });
+
+        const staleDelegatedCompletion = {
+          disposition: "open" as const,
+          nextGeneration: 1,
+          settledDeliveryCount: 0,
+          delivery: null,
+        };
+        const newerCohort = {
+          disposition: "open" as const,
+          nextGeneration: 2,
+          settledDeliveryCount: 1,
+          delivery: {
+            generation: 1,
+            messageId: deliveryMessageId,
+            taskIds: [taskId],
+          },
+        };
+        const staleRun: OrchestrationV2Run = {
+          id: runId,
+          threadId,
+          ordinal: 1,
+          providerInstanceId,
+          modelSelection,
+          providerThreadId,
+          userMessageId: MessageId.make("message:checkpoint-capture-user"),
+          rootNodeId,
+          activeAttemptId: null,
+          status: "waiting",
+          requestedAt: now,
+          startedAt: now,
+          completedAt: null,
+          checkpointId: null,
+          contextHandoffId: null,
+          // Snapshot taken before a concurrent cohort advanced during capture work.
+          delegatedCompletion: staleDelegatedCompletion,
+        };
+        const rootNode = {
+          id: rootNodeId,
+          threadId,
+          runId,
+          parentNodeId: null,
+          rootNodeId,
+          kind: "root_turn" as const,
+          status: "waiting" as const,
+          countsForRun: true,
+          providerThreadId,
+          providerTurnId: null,
+          nativeItemRef: null,
+          runtimeRequestId: null,
+          checkpointScopeId: scopeId,
+          startedAt: now,
+          completedAt: null,
+        };
+        const scope = {
+          id: scopeId,
+          threadId,
+          runId,
+          nodeId: rootNodeId,
+          parentScopeId: null,
+          providerThreadId,
+          kind: "root_run" as const,
+          ordinalWithinParent: 0,
+          advancesAppRunCount: true,
+          cwd: "/repo",
+          createdAt: now,
+        };
+        const providerThread = {
+          id: providerThreadId,
+          driver,
+          providerInstanceId,
+          providerSessionId: null,
+          appThreadId: threadId,
+          ownerNodeId: rootNodeId,
+          nativeThreadRef: null,
+          nativeConversationHeadRef: null,
+          status: "idle" as const,
+          firstRunOrdinal: 1,
+          lastRunOrdinal: 1,
+          handoffIds: [],
+          forkedFrom: null,
+          createdAt: now,
+          updatedAt: now,
+        };
+        const readyBaseline = {
+          id: CheckpointId.make("checkpoint:baseline-0"),
+          threadId,
+          scopeId,
+          runId: null,
+          nodeId: rootNodeId,
+          parentCheckpointId: null,
+          ordinalWithinScope: 0,
+          appRunOrdinal: null,
+          ref: CheckpointRef.make("checkpoint-ref:baseline-0"),
+          status: "ready" as const,
+          files: [],
+          capturedAt: now,
+        };
+        const captured = {
+          id: CheckpointId.make("checkpoint:captured-1"),
+          threadId,
+          scopeId,
+          runId,
+          nodeId: rootNodeId,
+          parentCheckpointId: readyBaseline.id,
+          ordinalWithinScope: 1,
+          appRunOrdinal: 1,
+          ref: CheckpointRef.make("checkpoint-ref:captured-1"),
+          status: "ready" as const,
+          files: [],
+          capturedAt: now,
+        };
+
+        yield* projectionStore.apply({
+          id: EventId.make("event:checkpoint-capture:thread"),
+          type: "thread.created",
+          threadId,
+          occurredAt: now,
+          payload: {
+            createdBy: "user",
+            creationSource: "web",
+            id: threadId,
+            projectId,
+            title: "Checkpoint capture delegated completion",
+            providerInstanceId,
+            modelSelection,
+            runtimeMode: "full-access",
+            interactionMode: "default",
+            branch: null,
+            worktreePath: null,
+            activeProviderThreadId: null,
+            lineage: {
+              parentThreadId: null,
+              relationshipToParent: null,
+              rootThreadId: threadId,
+            },
+            forkedFrom: null,
+            createdAt: now,
+            updatedAt: now,
+            archivedAt: null,
+            settledOverride: null,
+            settledAt: null,
+            lastVisitedAt: null,
+            deletedAt: null,
+          },
+        });
+        yield* projectionStore.apply({
+          id: EventId.make("event:checkpoint-capture:run-stale"),
+          type: "run.updated",
+          threadId,
+          runId,
+          nodeId: rootNodeId,
+          providerInstanceId,
+          occurredAt: now,
+          payload: staleRun,
+        });
+        yield* projectionStore.apply({
+          id: EventId.make("event:checkpoint-capture:node"),
+          type: "node.updated",
+          threadId,
+          runId,
+          nodeId: rootNodeId,
+          providerInstanceId,
+          occurredAt: now,
+          payload: rootNode,
+        });
+        yield* projectionStore.apply({
+          id: EventId.make("event:checkpoint-capture:provider-thread"),
+          type: "provider-thread.updated",
+          threadId,
+          nodeId: rootNodeId,
+          driver,
+          providerInstanceId,
+          occurredAt: now,
+          payload: providerThread,
+        });
+        yield* projectionStore.apply({
+          id: EventId.make("event:checkpoint-capture:scope"),
+          type: "checkpoint-scope.created",
+          threadId,
+          runId,
+          nodeId: rootNodeId,
+          occurredAt: now,
+          payload: scope,
+        });
+        yield* projectionStore.apply({
+          id: EventId.make("event:checkpoint-capture:baseline"),
+          type: "checkpoint.captured",
+          threadId,
+          nodeId: rootNodeId,
+          driver,
+          providerInstanceId,
+          occurredAt: now,
+          payload: readyBaseline,
+        });
+
+        const committed = yield* Ref.make<ReadonlyArray<OrchestrationV2DomainEvent>>([]);
+        const captureLayer = CheckpointCaptureService.layer.pipe(
+          Layer.provide(
+            Layer.mergeAll(
+              IdAllocator.layer,
+              Layer.mock(CheckpointServiceV2)({
+                materializeBaselineCheckpoint: () =>
+                  Effect.die("baseline materialization must be skipped when ordinal 0 is ready"),
+                capture: () => Effect.succeed(captured),
+              }),
+              Layer.mock(EventSinkV2)({
+                commitCommand: (input) =>
+                  Ref.set(committed, input.events).pipe(
+                    Effect.as({
+                      commandId: input.commandId,
+                      committed: true,
+                      sequence: 1,
+                      events: input.events,
+                      effects: [],
+                    } as never),
+                  ),
+              }),
+            ),
+          ),
+        );
+
+        yield* Effect.gen(function* () {
+          const service = yield* CheckpointCaptureService.CheckpointCaptureServiceV2;
+          // Capture reads the waiting run while the projection still holds the stale cohort.
+          yield* service.execute({ threadId, runId, scopeId });
+
+          const events = yield* Ref.get(committed);
+          const runUpdated = events.find((event) => event.type === "run.updated");
+          assert.isDefined(runUpdated);
+          if (runUpdated?.type !== "run.updated") {
+            return;
+          }
+          assert.equal(runUpdated.payload.status, "completed");
+          assert.equal(runUpdated.payload.checkpointId, captured.id);
+          assert.isUndefined(
+            runUpdated.payload.delegatedCompletion,
+            "checkpoint capture must omit delegatedCompletion so ProjectionStore can keep a newer cohort",
+          );
+
+          // Race: a newer cohort lands on the projection after capture read the stale
+          // waiting run and before the capture command's run.updated is applied.
+          yield* projectionStore.apply({
+            id: EventId.make("event:checkpoint-capture:newer-cohort"),
+            type: "run.updated",
+            threadId,
+            runId,
+            nodeId: rootNodeId,
+            providerInstanceId,
+            occurredAt: later,
+            payload: {
+              ...staleRun,
+              delegatedCompletion: newerCohort,
+            },
+          });
+
+          // Apply the real capture-emitted run.updated through ProjectionStore.
+          yield* projectionStore.apply(runUpdated);
+
+          const projection = yield* projectionStore.getThreadProjection(threadId);
+          const projectedRun = projection.runs[0];
+          assert.isDefined(projectedRun);
+          assert.equal(projectedRun?.status, "completed");
+          assert.equal(projectedRun?.checkpointId, captured.id);
+          assert.deepEqual(projectedRun?.delegatedCompletion, newerCohort);
+          assert.equal(projectedRun?.delegatedCompletion?.delivery?.messageId, deliveryMessageId);
+          assert.deepEqual(projectedRun?.delegatedCompletion?.delivery?.taskIds, [taskId]);
+        }).pipe(Effect.provide(captureLayer));
+      }),
+  );
+});
diff --git a/apps/server/src/orchestration-v2/CheckpointCaptureService.ts b/apps/server/src/orchestration-v2/CheckpointCaptureService.ts
new file mode 100644
index 000000000000..e9c9b64fe454
--- /dev/null
+++ b/apps/server/src/orchestration-v2/CheckpointCaptureService.ts
@@ -0,0 +1,273 @@
+import {
+  CheckpointScopeId,
+  CommandId,
+  type OrchestrationV2Checkpoint,
+  type OrchestrationV2ExecutionNode,
+  type OrchestrationV2ProviderThread,
+  type OrchestrationV2Run,
+  type OrchestrationV2TurnItem,
+  RunId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as Context from "effect/Context";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Schema from "effect/Schema";
+
+import { CheckpointServiceV2 } from "./CheckpointService.ts";
+import { EventSinkV2 } from "./EventSink.ts";
+import { IdAllocatorV2, type IdAllocatorV2Shape } from "./IdAllocator.ts";
+import { ProjectionStoreV2 } from "./ProjectionStore.ts";
+
+export class CheckpointCaptureExecutionError extends Schema.TaggedErrorClass<CheckpointCaptureExecutionError>()(
+  "CheckpointCaptureExecutionError",
+  {
+    threadId: ThreadId,
+    runId: RunId,
+    scopeId: CheckpointScopeId,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {}
+
+const isCheckpointCaptureExecutionError = Schema.is(CheckpointCaptureExecutionError);
+
+export interface CheckpointCaptureServiceV2Shape {
+  readonly execute: (input: {
+    readonly threadId: ThreadId;
+    readonly runId: RunId;
+    readonly scopeId: CheckpointScopeId;
+  }) => Effect.Effect<void, CheckpointCaptureExecutionError>;
+}
+
+export class CheckpointCaptureServiceV2 extends Context.Service<
+  CheckpointCaptureServiceV2,
+  CheckpointCaptureServiceV2Shape
+>()("t3/orchestration-v2/CheckpointCaptureService/CheckpointCaptureServiceV2") {}
+
+export const layer: Layer.Layer<
+  CheckpointCaptureServiceV2,
+  never,
+  CheckpointServiceV2 | EventSinkV2 | IdAllocatorV2 | ProjectionStoreV2
+> = Layer.effect(
+  CheckpointCaptureServiceV2,
+  Effect.gen(function* () {
+    const checkpoints = yield* CheckpointServiceV2;
+    const eventSink = yield* EventSinkV2;
+    const ids = yield* IdAllocatorV2;
+    const projections = yield* ProjectionStoreV2;
+
+    const execute = Effect.fn("orchestrationV2.checkpointCapture.execute")(function* (input: {
+      readonly threadId: ThreadId;
+      readonly runId: RunId;
+      readonly scopeId: CheckpointScopeId;
+    }) {
+      const projection = yield* projections.getThreadProjection(input.threadId);
+      const run = projection.runs.find((candidate) => candidate.id === input.runId);
+
+      // The effect is at-least-once. A completed run with a checkpoint proves
+      // that an earlier execution committed its result.
+      if (run?.status === "completed" && run.checkpointId !== null) {
+        return;
+      }
+
+      const rootNode = projection.nodes.find((candidate) => candidate.id === run?.rootNodeId);
+      const scope = projection.checkpointScopes.find((candidate) => candidate.id === input.scopeId);
+      const providerThread = projection.providerThreads.find(
+        (candidate) => candidate.id === run?.providerThreadId,
+      );
+      if (
+        run === undefined ||
+        run.status !== "waiting" ||
+        rootNode === undefined ||
+        scope === undefined ||
+        rootNode.checkpointScopeId !== scope.id ||
+        providerThread === undefined
+      ) {
+        return yield* new CheckpointCaptureExecutionError({
+          threadId: input.threadId,
+          runId: input.runId,
+          scopeId: input.scopeId,
+          cause: "The persisted checkpoint capture target is incomplete or no longer waiting.",
+        });
+      }
+
+      const capturedAt = yield* DateTime.now;
+      const baselineOrdinalWithinScope = Math.max(0, run.ordinal - 1);
+      const hasReadyCheckpoint = (ordinalWithinScope: number) =>
+        projection.checkpoints.some(
+          (candidate) =>
+            candidate.scopeId === scope.id &&
+            candidate.ordinalWithinScope === ordinalWithinScope &&
+            candidate.status === "ready",
+        );
+      const threadStartCheckpoint =
+        baselineOrdinalWithinScope === 0 || hasReadyCheckpoint(0)
+          ? null
+          : yield* checkpoints.materializeBaselineCheckpoint({
+              scope,
+              ordinalWithinScope: 0,
+            });
+      const baselineCheckpoint = hasReadyCheckpoint(baselineOrdinalWithinScope)
+        ? null
+        : yield* checkpoints.materializeBaselineCheckpoint({
+            scope,
+            ordinalWithinScope: baselineOrdinalWithinScope,
+          });
+      const checkpoint = yield* checkpoints.capture({
+        scope,
+        runId: run.id,
+        nodeId: rootNode.id,
+        ordinalWithinScope: run.ordinal,
+        appRunOrdinal: run.ordinal,
+        capturedAt,
+      });
+      // Match RunExecutionService: capture loaded the waiting run before
+      // materializing baselines. Omit delegatedCompletion so a newer cohort
+      // write during capture is not overwritten by this stale snapshot
+      // (ProjectionStore preserves the field when absent from the payload).
+      const { delegatedCompletion: _delegatedCompletion, ...runWithoutDelegatedCompletion } = run;
+      const commandId = CommandId.make(`command:effect:checkpoint.capture:${run.id}`);
+      yield* eventSink.commitCommand({
+        commandId,
+        threadId: input.threadId,
+        commandType: "checkpoint.capture",
+        acceptedAt: capturedAt,
+        effects: [],
+        events: [
+          ...(threadStartCheckpoint === null
+            ? []
+            : [
+                {
+                  id: yield* ids.allocate.event({ threadId: input.threadId, commandId }),
+                  type: "checkpoint.captured" as const,
+                  threadId: input.threadId,
+                  nodeId: threadStartCheckpoint.nodeId,
+                  driver: providerThread.driver,
+                  providerInstanceId: run.providerInstanceId,
+                  occurredAt: capturedAt,
+                  payload: threadStartCheckpoint,
+                },
+              ]),
+          ...(baselineCheckpoint === null
+            ? []
+            : [
+                {
+                  id: yield* ids.allocate.event({ threadId: input.threadId, commandId }),
+                  type: "checkpoint.captured" as const,
+                  threadId: input.threadId,
+                  nodeId: baselineCheckpoint.nodeId,
+                  driver: providerThread.driver,
+                  providerInstanceId: run.providerInstanceId,
+                  occurredAt: capturedAt,
+                  payload: baselineCheckpoint,
+                },
+              ]),
+          {
+            id: yield* ids.allocate.event({ threadId: input.threadId, commandId }),
+            type: "checkpoint.captured",
+            threadId: input.threadId,
+            runId: run.id,
+            nodeId: rootNode.id,
+            driver: providerThread.driver,
+            providerInstanceId: run.providerInstanceId,
+            occurredAt: capturedAt,
+            payload: checkpoint,
+          },
+          {
+            id: yield* ids.allocate.event({ threadId: input.threadId, commandId }),
+            type: "turn-item.updated",
+            threadId: input.threadId,
+            runId: run.id,
+            nodeId: rootNode.id,
+            driver: providerThread.driver,
+            providerInstanceId: run.providerInstanceId,
+            occurredAt: capturedAt,
+            payload: makeCheckpointTurnItem({
+              idAllocator: ids,
+              run,
+              rootNode,
+              providerThread,
+              checkpoint,
+              completedAt: capturedAt,
+            }),
+          },
+          {
+            id: yield* ids.allocate.event({ threadId: input.threadId, commandId }),
+            type: "run.updated",
+            threadId: input.threadId,
+            runId: run.id,
+            nodeId: rootNode.id,
+            providerInstanceId: run.providerInstanceId,
+            occurredAt: capturedAt,
+            payload: {
+              ...runWithoutDelegatedCompletion,
+              status: "completed",
+              completedAt: capturedAt,
+              checkpointId: checkpoint.id,
+            },
+          },
+          {
+            id: yield* ids.allocate.event({ threadId: input.threadId, commandId }),
+            type: "node.updated",
+            threadId: input.threadId,
+            runId: run.id,
+            nodeId: rootNode.id,
+            providerInstanceId: run.providerInstanceId,
+            occurredAt: capturedAt,
+            payload: {
+              ...rootNode,
+              status: "completed",
+              completedAt: capturedAt,
+              checkpointScopeId: scope.id,
+            },
+          },
+        ],
+      });
+    });
+
+    return CheckpointCaptureServiceV2.of({
+      execute: (input) =>
+        execute(input).pipe(
+          Effect.mapError((cause) =>
+            isCheckpointCaptureExecutionError(cause)
+              ? cause
+              : new CheckpointCaptureExecutionError({ ...input, cause }),
+          ),
+        ),
+    });
+  }),
+);
+
+function makeCheckpointTurnItem(input: {
+  readonly idAllocator: IdAllocatorV2Shape;
+  readonly run: OrchestrationV2Run;
+  readonly rootNode: OrchestrationV2ExecutionNode;
+  readonly providerThread: OrchestrationV2ProviderThread;
+  readonly checkpoint: OrchestrationV2Checkpoint;
+  readonly completedAt: DateTime.Utc;
+}): OrchestrationV2TurnItem {
+  return {
+    id: input.idAllocator.derive.turnItemFromProviderItem({
+      driver: input.providerThread.driver,
+      nativeItemId: `checkpoint:${input.checkpoint.id}`,
+    }),
+    threadId: input.run.threadId,
+    runId: input.run.id,
+    nodeId: input.rootNode.id,
+    providerThreadId: input.providerThread.id,
+    providerTurnId: input.rootNode.providerTurnId,
+    nativeItemRef: null,
+    parentItemId: null,
+    ordinal: input.run.ordinal * 100 + 99,
+    status: "completed",
+    title: null,
+    startedAt: input.completedAt,
+    completedAt: input.completedAt,
+    updatedAt: input.completedAt,
+    type: "checkpoint",
+    checkpointId: input.checkpoint.id,
+    scopeId: input.checkpoint.scopeId,
+    files: input.checkpoint.files,
+  };
+}
diff --git a/apps/server/src/orchestration-v2/CheckpointPolicy.ts b/apps/server/src/orchestration-v2/CheckpointPolicy.ts
new file mode 100644
index 000000000000..256f590ae552
--- /dev/null
+++ b/apps/server/src/orchestration-v2/CheckpointPolicy.ts
@@ -0,0 +1,84 @@
+import {
+  CheckpointId,
+  CheckpointScopeId,
+  NodeId,
+  OrchestrationV2Checkpoint,
+  OrchestrationV2CheckpointScope,
+  OrchestrationV2ExecutionNode,
+  OrchestrationV2Run,
+  OrchestrationV2ThreadProjection,
+  RunId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as Context from "effect/Context";
+import * as Schema from "effect/Schema";
+import type * as Effect from "effect/Effect";
+
+export class CheckpointPolicyPrepareRunError extends Schema.TaggedErrorClass<CheckpointPolicyPrepareRunError>()(
+  "CheckpointPolicyPrepareRunError",
+  {
+    threadId: ThreadId,
+    runId: RunId,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to prepare checkpoint policy for run ${this.runId}.`;
+  }
+}
+
+export class CheckpointPolicyFinalizeNodeError extends Schema.TaggedErrorClass<CheckpointPolicyFinalizeNodeError>()(
+  "CheckpointPolicyFinalizeNodeError",
+  {
+    threadId: ThreadId,
+    nodeId: NodeId,
+    scopeId: Schema.optional(CheckpointScopeId),
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to finalize checkpoint policy for node ${this.nodeId}.`;
+  }
+}
+
+export class CheckpointPolicyRollbackError extends Schema.TaggedErrorClass<CheckpointPolicyRollbackError>()(
+  "CheckpointPolicyRollbackError",
+  {
+    threadId: ThreadId,
+    scopeId: CheckpointScopeId,
+    checkpointId: CheckpointId,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to apply checkpoint rollback ${this.checkpointId} for scope ${this.scopeId}.`;
+  }
+}
+
+export const CheckpointPolicyV2Error = Schema.Union([
+  CheckpointPolicyPrepareRunError,
+  CheckpointPolicyFinalizeNodeError,
+  CheckpointPolicyRollbackError,
+]);
+export type CheckpointPolicyV2Error = typeof CheckpointPolicyV2Error.Type;
+
+export interface CheckpointPolicyV2Shape {
+  readonly prepareRun: (input: {
+    readonly projection: OrchestrationV2ThreadProjection;
+    readonly run: OrchestrationV2Run;
+  }) => Effect.Effect<ReadonlyArray<OrchestrationV2CheckpointScope>, CheckpointPolicyV2Error>;
+  readonly finalizeNode: (input: {
+    readonly projection: OrchestrationV2ThreadProjection;
+    readonly node: OrchestrationV2ExecutionNode;
+  }) => Effect.Effect<ReadonlyArray<OrchestrationV2Checkpoint>, CheckpointPolicyV2Error>;
+  readonly rollback: (input: {
+    readonly projection: OrchestrationV2ThreadProjection;
+    readonly scopeId: CheckpointScopeId;
+    readonly checkpointId: CheckpointId;
+  }) => Effect.Effect<ReadonlyArray<OrchestrationV2Checkpoint>, CheckpointPolicyV2Error>;
+}
+
+export class CheckpointPolicyV2 extends Context.Service<
+  CheckpointPolicyV2,
+  CheckpointPolicyV2Shape
+>()("t3/orchestration-v2/CheckpointPolicy/CheckpointPolicyV2") {}
diff --git a/apps/server/src/orchestration-v2/CheckpointRollbackService.test.ts b/apps/server/src/orchestration-v2/CheckpointRollbackService.test.ts
new file mode 100644
index 000000000000..5c22663c8ff6
--- /dev/null
+++ b/apps/server/src/orchestration-v2/CheckpointRollbackService.test.ts
@@ -0,0 +1,331 @@
+import { assert, it, vi } from "@effect/vitest";
+import {
+  CheckpointId,
+  CheckpointScopeId,
+  type OrchestrationV2ThreadProjection,
+  ProviderInstanceId,
+  ProviderSessionId,
+  ProviderThreadId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+
+import { CheckpointServiceV2 } from "./CheckpointService.ts";
+import {
+  CheckpointRollbackServiceV2,
+  layer as checkpointRollbackServiceLayer,
+} from "./CheckpointRollbackService.ts";
+import { EventSinkV2 } from "./EventSink.ts";
+import { layer as idAllocatorLayer } from "./IdAllocator.ts";
+import { ProjectionStoreReadError, ProjectionStoreV2 } from "./ProjectionStore.ts";
+import { ProviderSessionManagerV2 } from "./ProviderSessionManager.ts";
+import { RuntimePolicyV2 } from "./RuntimePolicy.ts";
+
+it.effect("rejects a non-ready checkpoint before opening a session or restoring files", () => {
+  const threadId = ThreadId.make("thread:rollback-non-ready");
+  const providerThreadId = ProviderThreadId.make("provider-thread:rollback-non-ready");
+  const providerSessionId = ProviderSessionId.make("provider-session:rollback-non-ready");
+  const checkpointId = CheckpointId.make("checkpoint:rollback-non-ready");
+  const scopeId = CheckpointScopeId.make("checkpoint-scope:rollback-non-ready");
+  const providerInstanceId = ProviderInstanceId.make("provider_rollback_non_ready");
+  const restore = vi.fn(() => Effect.die("checkpoint restore must not run"));
+  const open = vi.fn(() => Effect.die("provider session open must not run"));
+  const resolveRuntimePolicy = vi.fn(() => Effect.die("runtime policy resolution must not run"));
+  const projection = {
+    thread: {
+      activeProviderThreadId: providerThreadId,
+      modelSelection: { instanceId: providerInstanceId, model: "test-model" },
+    },
+    providerThreads: [{ id: providerThreadId, providerSessionId, providerInstanceId }],
+    checkpoints: [{ id: checkpointId, scopeId, status: "stale" }],
+    checkpointScopes: [{ id: scopeId }],
+  } as unknown as OrchestrationV2ThreadProjection;
+  const testLayer = checkpointRollbackServiceLayer.pipe(
+    Layer.provide(
+      Layer.mergeAll(
+        Layer.mock(CheckpointServiceV2)({ restore }),
+        Layer.mock(EventSinkV2)({}),
+        idAllocatorLayer,
+        Layer.mock(ProjectionStoreV2)({
+          getThreadProjection: () => Effect.succeed(projection),
+        }),
+        Layer.mock(ProviderSessionManagerV2)({ open }),
+        Layer.mock(RuntimePolicyV2)({ resolve: resolveRuntimePolicy }),
+      ),
+    ),
+  );
+
+  return Effect.gen(function* () {
+    const service = yield* CheckpointRollbackServiceV2;
+    const error = yield* service
+      .execute({
+        threadId,
+        providerThreadId,
+        checkpointId,
+        scopeId,
+      })
+      .pipe(Effect.flip);
+
+    assert.equal(error.reason, "rollback-target-invalid");
+    assert.equal(
+      error.message,
+      `Rollback target ${checkpointId} for provider thread ${providerThreadId} on thread ${threadId} is incomplete or invalid.`,
+    );
+    assert.equal(error.cause, undefined);
+    assert.equal(resolveRuntimePolicy.mock.calls.length, 0);
+    assert.equal(open.mock.calls.length, 0);
+    assert.equal(restore.mock.calls.length, 0);
+  }).pipe(Effect.provide(testLayer));
+});
+
+it.effect("rejects a rollback when another provider thread became active", () => {
+  const threadId = ThreadId.make("thread:rollback-inactive-provider-thread");
+  const requestedProviderThreadId = ProviderThreadId.make(
+    "provider-thread:rollback-inactive-provider-thread:requested",
+  );
+  const activeProviderThreadId = ProviderThreadId.make(
+    "provider-thread:rollback-inactive-provider-thread:active",
+  );
+  const providerSessionId = ProviderSessionId.make(
+    "provider-session:rollback-inactive-provider-thread",
+  );
+  const checkpointId = CheckpointId.make("checkpoint:rollback-inactive-provider-thread");
+  const scopeId = CheckpointScopeId.make("checkpoint-scope:rollback-inactive-provider-thread");
+  const providerInstanceId = ProviderInstanceId.make("provider_rollback_inactive_provider_thread");
+  const restore = vi.fn(() => Effect.die("checkpoint restore must not run"));
+  const open = vi.fn(() => Effect.die("provider session open must not run"));
+  const resolveRuntimePolicy = vi.fn(() => Effect.die("runtime policy resolution must not run"));
+  const projection = {
+    thread: {
+      activeProviderThreadId,
+      modelSelection: { instanceId: providerInstanceId, model: "test-model" },
+    },
+    providerThreads: [
+      {
+        id: requestedProviderThreadId,
+        providerSessionId,
+        providerInstanceId,
+      },
+    ],
+    checkpoints: [{ id: checkpointId, scopeId, status: "ready" }],
+    checkpointScopes: [{ id: scopeId }],
+  } as unknown as OrchestrationV2ThreadProjection;
+  const testLayer = checkpointRollbackServiceLayer.pipe(
+    Layer.provide(
+      Layer.mergeAll(
+        Layer.mock(CheckpointServiceV2)({ restore }),
+        Layer.mock(EventSinkV2)({}),
+        idAllocatorLayer,
+        Layer.mock(ProjectionStoreV2)({
+          getThreadProjection: () => Effect.succeed(projection),
+        }),
+        Layer.mock(ProviderSessionManagerV2)({ open }),
+        Layer.mock(RuntimePolicyV2)({ resolve: resolveRuntimePolicy }),
+      ),
+    ),
+  );
+
+  return Effect.gen(function* () {
+    const service = yield* CheckpointRollbackServiceV2;
+    const error = yield* service
+      .execute({
+        threadId,
+        providerThreadId: requestedProviderThreadId,
+        checkpointId,
+        scopeId,
+      })
+      .pipe(Effect.flip);
+
+    assert.equal(error.reason, "active-provider-changed");
+    assert.equal(
+      error.message,
+      `Active provider changed before rollback target ${checkpointId} could execute on thread ${threadId}.`,
+    );
+    assert.equal(error.cause, undefined);
+    assert.equal(resolveRuntimePolicy.mock.calls.length, 0);
+    assert.equal(open.mock.calls.length, 0);
+    assert.equal(restore.mock.calls.length, 0);
+  }).pipe(Effect.provide(testLayer));
+});
+
+it.effect("rejects a rollback when provider selection changed before execution", () => {
+  const threadId = ThreadId.make("thread:rollback-provider-selection-changed");
+  const providerThreadId = ProviderThreadId.make(
+    "provider-thread:rollback-provider-selection-changed",
+  );
+  const providerSessionId = ProviderSessionId.make(
+    "provider-session:rollback-provider-selection-changed",
+  );
+  const checkpointId = CheckpointId.make("checkpoint:rollback-provider-selection-changed");
+  const scopeId = CheckpointScopeId.make("checkpoint-scope:rollback-provider-selection-changed");
+  const originalProviderInstanceId = ProviderInstanceId.make(
+    "provider_rollback_provider_selection_changed_original",
+  );
+  const selectedProviderInstanceId = ProviderInstanceId.make(
+    "provider_rollback_provider_selection_changed_selected",
+  );
+  const restore = vi.fn(() => Effect.die("checkpoint restore must not run"));
+  const open = vi.fn(() => Effect.die("provider session open must not run"));
+  const resolveRuntimePolicy = vi.fn(() => Effect.die("runtime policy resolution must not run"));
+  const projection = {
+    thread: {
+      activeProviderThreadId: providerThreadId,
+      modelSelection: { instanceId: selectedProviderInstanceId, model: "test-model" },
+    },
+    providerThreads: [
+      {
+        id: providerThreadId,
+        providerSessionId,
+        providerInstanceId: originalProviderInstanceId,
+      },
+    ],
+    checkpoints: [{ id: checkpointId, scopeId, status: "ready" }],
+    checkpointScopes: [{ id: scopeId }],
+  } as unknown as OrchestrationV2ThreadProjection;
+  const testLayer = checkpointRollbackServiceLayer.pipe(
+    Layer.provide(
+      Layer.mergeAll(
+        Layer.mock(CheckpointServiceV2)({ restore }),
+        Layer.mock(EventSinkV2)({}),
+        idAllocatorLayer,
+        Layer.mock(ProjectionStoreV2)({
+          getThreadProjection: () => Effect.succeed(projection),
+        }),
+        Layer.mock(ProviderSessionManagerV2)({ open }),
+        Layer.mock(RuntimePolicyV2)({ resolve: resolveRuntimePolicy }),
+      ),
+    ),
+  );
+
+  return Effect.gen(function* () {
+    const service = yield* CheckpointRollbackServiceV2;
+    const error = yield* service
+      .execute({
+        threadId,
+        providerThreadId,
+        checkpointId,
+        scopeId,
+      })
+      .pipe(Effect.flip);
+
+    assert.equal(error.reason, "active-provider-changed");
+    assert.equal(
+      error.message,
+      `Active provider changed before rollback target ${checkpointId} could execute on thread ${threadId}.`,
+    );
+    assert.equal(error.cause, undefined);
+    assert.equal(resolveRuntimePolicy.mock.calls.length, 0);
+    assert.equal(open.mock.calls.length, 0);
+    assert.equal(restore.mock.calls.length, 0);
+  }).pipe(Effect.provide(testLayer));
+});
+
+it.effect("reports a missing provider turn as a structured rollback failure", () => {
+  const threadId = ThreadId.make("thread:rollback-provider-turn-unavailable");
+  const providerThreadId = ProviderThreadId.make(
+    "provider-thread:rollback-provider-turn-unavailable",
+  );
+  const providerSessionId = ProviderSessionId.make(
+    "provider-session:rollback-provider-turn-unavailable",
+  );
+  const checkpointId = CheckpointId.make("checkpoint:rollback-provider-turn-unavailable");
+  const scopeId = CheckpointScopeId.make("checkpoint-scope:rollback-provider-turn-unavailable");
+  const providerInstanceId = ProviderInstanceId.make("provider_rollback_provider_turn_unavailable");
+  const restore = vi.fn(() => Effect.die("checkpoint restore must not run"));
+  const projection = {
+    thread: {
+      activeProviderThreadId: providerThreadId,
+      modelSelection: { instanceId: providerInstanceId, model: "test-model" },
+    },
+    providerThreads: [{ id: providerThreadId, providerSessionId, providerInstanceId }],
+    providerSessions: [],
+    checkpoints: [{ id: checkpointId, scopeId, status: "ready", appRunOrdinal: 1 }],
+    checkpointScopes: [{ id: scopeId }],
+    runs: [],
+    attempts: [],
+    providerTurns: [],
+  } as unknown as OrchestrationV2ThreadProjection;
+  const testLayer = checkpointRollbackServiceLayer.pipe(
+    Layer.provide(
+      Layer.mergeAll(
+        Layer.mock(CheckpointServiceV2)({ restore }),
+        Layer.mock(EventSinkV2)({}),
+        idAllocatorLayer,
+        Layer.mock(ProjectionStoreV2)({
+          getThreadProjection: () => Effect.succeed(projection),
+        }),
+        Layer.mock(ProviderSessionManagerV2)({
+          open: () => Effect.succeed({} as never),
+        }),
+        Layer.mock(RuntimePolicyV2)({
+          resolve: () => Effect.succeed({} as never),
+        }),
+      ),
+    ),
+  );
+
+  return Effect.gen(function* () {
+    const service = yield* CheckpointRollbackServiceV2;
+    const error = yield* service
+      .execute({
+        threadId,
+        providerThreadId,
+        checkpointId,
+        scopeId,
+      })
+      .pipe(Effect.flip);
+
+    assert.equal(error.reason, "provider-turn-unavailable");
+    assert.equal(
+      error.message,
+      `Provider turn for rollback target ${checkpointId} is unavailable on provider thread ${providerThreadId}.`,
+    );
+    assert.equal(error.cause, undefined);
+    assert.equal(restore.mock.calls.length, 0);
+  }).pipe(Effect.provide(testLayer));
+});
+
+it.effect("wraps underlying failures with an unexpected-failure reason and cause", () => {
+  const threadId = ThreadId.make("thread:rollback-unexpected-failure");
+  const providerThreadId = ProviderThreadId.make("provider-thread:rollback-unexpected-failure");
+  const checkpointId = CheckpointId.make("checkpoint:rollback-unexpected-failure");
+  const scopeId = CheckpointScopeId.make("checkpoint-scope:rollback-unexpected-failure");
+  const projectionError = new ProjectionStoreReadError({
+    threadId,
+    cause: new Error("database read failed"),
+  });
+  const testLayer = checkpointRollbackServiceLayer.pipe(
+    Layer.provide(
+      Layer.mergeAll(
+        Layer.mock(CheckpointServiceV2)({}),
+        Layer.mock(EventSinkV2)({}),
+        idAllocatorLayer,
+        Layer.mock(ProjectionStoreV2)({
+          getThreadProjection: () => Effect.fail(projectionError),
+        }),
+        Layer.mock(ProviderSessionManagerV2)({}),
+        Layer.mock(RuntimePolicyV2)({}),
+      ),
+    ),
+  );
+
+  return Effect.gen(function* () {
+    const service = yield* CheckpointRollbackServiceV2;
+    const error = yield* service
+      .execute({
+        threadId,
+        providerThreadId,
+        checkpointId,
+        scopeId,
+      })
+      .pipe(Effect.flip);
+
+    assert.equal(error.reason, "unexpected-failure");
+    assert.equal(
+      error.message,
+      `Failed to execute rollback target ${checkpointId} on provider thread ${providerThreadId} for thread ${threadId}.`,
+    );
+    assert.strictEqual(error.cause, projectionError);
+  }).pipe(Effect.provide(testLayer));
+});
diff --git a/apps/server/src/orchestration-v2/CheckpointRollbackService.ts b/apps/server/src/orchestration-v2/CheckpointRollbackService.ts
new file mode 100644
index 000000000000..1a0acb9007ab
--- /dev/null
+++ b/apps/server/src/orchestration-v2/CheckpointRollbackService.ts
@@ -0,0 +1,288 @@
+import {
+  CheckpointId,
+  CheckpointScopeId,
+  type OrchestrationV2DomainEvent,
+  ProviderThreadId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as Context from "effect/Context";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Schema from "effect/Schema";
+
+import { CheckpointServiceV2 } from "./CheckpointService.ts";
+import { EventSinkV2 } from "./EventSink.ts";
+import { IdAllocatorV2 } from "./IdAllocator.ts";
+import { ProjectionStoreV2 } from "./ProjectionStore.ts";
+import type { ProviderAdapterV2RollbackTarget } from "./ProviderAdapter.ts";
+import { ProviderSessionManagerV2 } from "./ProviderSessionManager.ts";
+import { RuntimePolicyV2 } from "./RuntimePolicy.ts";
+
+export class CheckpointRollbackExecutionError extends Schema.TaggedErrorClass<CheckpointRollbackExecutionError>()(
+  "CheckpointRollbackExecutionError",
+  {
+    reason: Schema.Literals([
+      "rollback-target-invalid",
+      "active-provider-changed",
+      "provider-turn-unavailable",
+      "unexpected-failure",
+    ]),
+    threadId: ThreadId,
+    providerThreadId: ProviderThreadId,
+    checkpointId: CheckpointId,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    switch (this.reason) {
+      case "rollback-target-invalid":
+        return `Rollback target ${this.checkpointId} for provider thread ${this.providerThreadId} on thread ${this.threadId} is incomplete or invalid.`;
+      case "active-provider-changed":
+        return `Active provider changed before rollback target ${this.checkpointId} could execute on thread ${this.threadId}.`;
+      case "provider-turn-unavailable":
+        return `Provider turn for rollback target ${this.checkpointId} is unavailable on provider thread ${this.providerThreadId}.`;
+      case "unexpected-failure":
+        return `Failed to execute rollback target ${this.checkpointId} on provider thread ${this.providerThreadId} for thread ${this.threadId}.`;
+    }
+  }
+}
+
+const isCheckpointRollbackExecutionError = Schema.is(CheckpointRollbackExecutionError);
+
+export interface CheckpointRollbackServiceV2Shape {
+  readonly execute: (input: {
+    readonly threadId: ThreadId;
+    readonly providerThreadId: ProviderThreadId;
+    readonly checkpointId: CheckpointId;
+    readonly scopeId: CheckpointScopeId;
+  }) => Effect.Effect<void, CheckpointRollbackExecutionError>;
+}
+
+export class CheckpointRollbackServiceV2 extends Context.Service<
+  CheckpointRollbackServiceV2,
+  CheckpointRollbackServiceV2Shape
+>()("t3/orchestration-v2/CheckpointRollbackService/CheckpointRollbackServiceV2") {}
+
+export const layer: Layer.Layer<
+  CheckpointRollbackServiceV2,
+  never,
+  | CheckpointServiceV2
+  | EventSinkV2
+  | IdAllocatorV2
+  | ProjectionStoreV2
+  | ProviderSessionManagerV2
+  | RuntimePolicyV2
+> = Layer.effect(
+  CheckpointRollbackServiceV2,
+  Effect.gen(function* () {
+    const checkpoints = yield* CheckpointServiceV2;
+    const eventSink = yield* EventSinkV2;
+    const ids = yield* IdAllocatorV2;
+    const projections = yield* ProjectionStoreV2;
+    const sessions = yield* ProviderSessionManagerV2;
+    const runtimePolicy = yield* RuntimePolicyV2;
+
+    const execute = Effect.fn("orchestrationV2.checkpointRollback.execute")(function* (input: {
+      readonly threadId: ThreadId;
+      readonly providerThreadId: ProviderThreadId;
+      readonly checkpointId: CheckpointId;
+      readonly scopeId: CheckpointScopeId;
+    }) {
+      const projection = yield* projections.getThreadProjection(input.threadId);
+      const providerThread = projection.providerThreads.find(
+        (candidate) => candidate.id === input.providerThreadId,
+      );
+      const checkpoint = projection.checkpoints.find(
+        (candidate) => candidate.id === input.checkpointId,
+      );
+      const scope = projection.checkpointScopes.find((candidate) => candidate.id === input.scopeId);
+      if (
+        providerThread === undefined ||
+        providerThread.providerSessionId === null ||
+        checkpoint === undefined ||
+        scope === undefined ||
+        checkpoint.scopeId !== scope.id ||
+        checkpoint.status !== "ready"
+      ) {
+        return yield* new CheckpointRollbackExecutionError({
+          reason: "rollback-target-invalid",
+          threadId: input.threadId,
+          providerThreadId: input.providerThreadId,
+          checkpointId: input.checkpointId,
+        });
+      }
+      if (
+        providerThread.id !== projection.thread.activeProviderThreadId ||
+        providerThread.providerInstanceId !== projection.thread.modelSelection.instanceId
+      ) {
+        return yield* new CheckpointRollbackExecutionError({
+          reason: "active-provider-changed",
+          threadId: input.threadId,
+          providerThreadId: input.providerThreadId,
+          checkpointId: input.checkpointId,
+        });
+      }
+
+      const modelSelection = projection.thread.modelSelection;
+      const resolvedRuntimePolicy = yield* runtimePolicy.resolve({
+        thread: projection.thread,
+        modelSelection,
+      });
+      const existingSession = projection.providerSessions.find(
+        (candidate) => candidate.id === providerThread.providerSessionId,
+      );
+      const session = yield* sessions.open({
+        threadId: input.threadId,
+        providerSessionId: providerThread.providerSessionId,
+        modelSelection,
+        runtimePolicy: resolvedRuntimePolicy,
+        ...(existingSession === undefined ? {} : { resumeFromSession: existingSession }),
+      });
+
+      const targetOrdinal = checkpoint.appRunOrdinal ?? 0;
+      const runsToRollback = projection.runs.filter(
+        (run) => run.ordinal > targetOrdinal && run.status === "completed",
+      );
+      const providerThreadTurns = projection.providerTurns.filter(
+        (turn) => turn.providerThreadId === providerThread.id,
+      );
+      const rollbackTarget: ProviderAdapterV2RollbackTarget =
+        targetOrdinal === 0
+          ? {
+              type: "thread_start",
+              checkpointId: checkpoint.id,
+              appRunOrdinal: 0,
+            }
+          : yield* Effect.gen(function* () {
+              const targetRun = projection.runs.find((run) => run.ordinal === targetOrdinal);
+              const targetAttempt = projection.attempts.find(
+                (attempt) => attempt.id === targetRun?.activeAttemptId,
+              );
+              const targetTurn = projection.providerTurns.find(
+                (turn) =>
+                  turn.id === targetAttempt?.providerTurnId ||
+                  turn.runAttemptId === targetAttempt?.id,
+              );
+              if (targetTurn === undefined || targetTurn.providerThreadId !== providerThread.id) {
+                return yield* new CheckpointRollbackExecutionError({
+                  reason: "provider-turn-unavailable",
+                  threadId: input.threadId,
+                  providerThreadId: input.providerThreadId,
+                  checkpointId: input.checkpointId,
+                });
+              }
+              return {
+                type: "provider_turn" as const,
+                checkpointId: checkpoint.id,
+                appRunOrdinal: targetOrdinal,
+                providerTurn: targetTurn,
+              };
+            });
+
+      yield* checkpoints.restore({ scope, checkpoint });
+      const snapshot =
+        runsToRollback.length === 0
+          ? { providerThread }
+          : yield* session.rollbackThread({
+              providerThread,
+              target: rollbackTarget,
+              providerThreadTurns,
+            });
+      const staleCheckpoints = projection.checkpoints.filter(
+        (candidate) =>
+          candidate.scopeId === scope.id &&
+          candidate.appRunOrdinal !== null &&
+          candidate.appRunOrdinal > targetOrdinal &&
+          candidate.status === "ready",
+      );
+      if (staleCheckpoints.length > 0) {
+        yield* checkpoints.deleteStaleRefs({ scope, checkpoints: staleCheckpoints });
+      }
+
+      const now = yield* DateTime.now;
+      const makeEvent = <Event extends OrchestrationV2DomainEvent>(event: Omit<Event, "id">) =>
+        Effect.map(
+          ids.allocate.event({ threadId: event.threadId }),
+          (id) =>
+            ({
+              ...event,
+              id,
+            }) as Event,
+        );
+      const events: Array<OrchestrationV2DomainEvent> = [];
+      events.push(
+        yield* makeEvent({
+          type: "provider-thread.updated",
+          threadId: input.threadId,
+          driver: providerThread.driver,
+          providerInstanceId: providerThread.providerInstanceId,
+          occurredAt: now,
+          payload: {
+            ...snapshot.providerThread,
+            lastRunOrdinal: targetOrdinal === 0 ? null : targetOrdinal,
+            updatedAt: now,
+          },
+        }),
+      );
+      for (const staleCheckpoint of staleCheckpoints) {
+        events.push(
+          yield* makeEvent({
+            type: "checkpoint.captured",
+            threadId: input.threadId,
+            ...(staleCheckpoint.runId === null ? {} : { runId: staleCheckpoint.runId }),
+            nodeId: staleCheckpoint.nodeId,
+            providerInstanceId: providerThread.providerInstanceId,
+            occurredAt: now,
+            payload: { ...staleCheckpoint, status: "stale" },
+          }),
+        );
+      }
+      for (const run of runsToRollback) {
+        const rootNode = projection.nodes.find((candidate) => candidate.id === run.rootNodeId);
+        events.push(
+          yield* makeEvent({
+            type: "run.updated",
+            threadId: input.threadId,
+            runId: run.id,
+            ...(rootNode === undefined ? {} : { nodeId: rootNode.id }),
+            providerInstanceId: run.providerInstanceId,
+            occurredAt: now,
+            payload: { ...run, status: "rolled_back", completedAt: now },
+          }),
+        );
+        if (rootNode !== undefined) {
+          events.push(
+            yield* makeEvent({
+              type: "node.updated",
+              threadId: input.threadId,
+              runId: run.id,
+              nodeId: rootNode.id,
+              providerInstanceId: run.providerInstanceId,
+              occurredAt: now,
+              payload: { ...rootNode, status: "rolled_back", completedAt: now },
+            }),
+          );
+        }
+      }
+      yield* eventSink.write({ events });
+    });
+
+    return CheckpointRollbackServiceV2.of({
+      execute: (input) =>
+        execute(input).pipe(
+          Effect.mapError((cause) =>
+            isCheckpointRollbackExecutionError(cause)
+              ? cause
+              : new CheckpointRollbackExecutionError({
+                  reason: "unexpected-failure",
+                  threadId: input.threadId,
+                  providerThreadId: input.providerThreadId,
+                  checkpointId: input.checkpointId,
+                  cause,
+                }),
+          ),
+        ),
+    });
+  }),
+);
diff --git a/apps/server/src/orchestration-v2/CheckpointService.test.ts b/apps/server/src/orchestration-v2/CheckpointService.test.ts
new file mode 100644
index 000000000000..1edfe541e3e0
--- /dev/null
+++ b/apps/server/src/orchestration-v2/CheckpointService.test.ts
@@ -0,0 +1,72 @@
+import { assert, it, vi } from "@effect/vitest";
+import {
+  CheckpointScopeId,
+  NodeId,
+  ProviderThreadId,
+  RunId,
+  ThreadId,
+  type OrchestrationV2CheckpointScope,
+} from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+
+import * as CheckpointStore from "../checkpointing/CheckpointStore.ts";
+import {
+  CheckpointServiceV2,
+  checkpointRefForScopeOrdinal,
+  layer as checkpointServiceLayer,
+} from "./CheckpointService.ts";
+import { layer as idAllocatorLayer } from "./IdAllocator.ts";
+
+it.effect("materializes the captured baseline at the requested scope ordinal", () => {
+  const scope: OrchestrationV2CheckpointScope = {
+    id: CheckpointScopeId.make("checkpoint-scope:materialize-baseline"),
+    threadId: ThreadId.make("thread:materialize-baseline"),
+    runId: RunId.make("run:materialize-baseline:3"),
+    nodeId: NodeId.make("node:materialize-baseline:3"),
+    parentScopeId: null,
+    providerThreadId: ProviderThreadId.make("provider-thread:materialize-baseline"),
+    kind: "root_run",
+    ordinalWithinParent: 0,
+    advancesAppRunCount: true,
+    cwd: "/repo",
+    createdAt: DateTime.makeUnsafe("2026-07-28T00:00:00.000Z"),
+  };
+  const hasCheckpointRef = vi.fn((_input: CheckpointStore.RestoreCheckpointInput) =>
+    Effect.succeed(true),
+  );
+  const testLayer = checkpointServiceLayer.pipe(
+    Layer.provide(
+      Layer.mergeAll(
+        idAllocatorLayer,
+        Layer.mock(CheckpointStore.CheckpointStore)({
+          isGitRepository: () => Effect.succeed(true),
+          hasCheckpointRef,
+        }),
+      ),
+    ),
+  );
+
+  return Effect.gen(function* () {
+    const checkpoints = yield* CheckpointServiceV2;
+    const baseline = yield* checkpoints.materializeBaselineCheckpoint({
+      scope,
+      ordinalWithinScope: 2,
+    });
+
+    assert.equal(baseline.ordinalWithinScope, 2);
+    assert.equal(
+      baseline.ref,
+      checkpointRefForScopeOrdinal({
+        scopeId: scope.id,
+        ordinalWithinScope: 2,
+      }),
+    );
+    assert.equal(baseline.status, "ready");
+    assert.deepEqual(hasCheckpointRef.mock.calls[0]?.[0], {
+      cwd: scope.cwd,
+      checkpointRef: baseline.ref,
+    });
+  }).pipe(Effect.provide(testLayer));
+});
diff --git a/apps/server/src/orchestration-v2/CheckpointService.ts b/apps/server/src/orchestration-v2/CheckpointService.ts
new file mode 100644
index 000000000000..80211418308b
--- /dev/null
+++ b/apps/server/src/orchestration-v2/CheckpointService.ts
@@ -0,0 +1,564 @@
+import {
+  CheckpointId,
+  CheckpointRef,
+  CheckpointScopeId,
+  NodeId,
+  OrchestrationV2Checkpoint,
+  OrchestrationV2CheckpointScope,
+  ProviderThreadId,
+  RunId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as NodeCrypto from "node:crypto";
+import * as Context from "effect/Context";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+import * as Encoding from "effect/Encoding";
+import * as Layer from "effect/Layer";
+import * as Ref from "effect/Ref";
+import * as Schema from "effect/Schema";
+import * as Semaphore from "effect/Semaphore";
+
+import { parseTurnDiffFilesFromUnifiedDiff } from "../checkpointing/Diffs.ts";
+import * as CheckpointStore from "../checkpointing/CheckpointStore.ts";
+import { IdAllocatorV2, type IdAllocatorV2Shape } from "./IdAllocator.ts";
+
+const CHECKPOINT_REFS_PREFIX = "refs/t3/orchestration-v2/checkpoints";
+const ROOT_CHECKPOINT_SCOPE_NAME = "root";
+
+export class CheckpointRootScopePrepareError extends Schema.TaggedErrorClass<CheckpointRootScopePrepareError>()(
+  "CheckpointRootScopePrepareError",
+  {
+    threadId: ThreadId,
+    runId: RunId,
+    cause: Schema.Defect(),
+  },
+) {
+  override get message(): string {
+    return `Failed to prepare root checkpoint scope for run ${this.runId}.`;
+  }
+}
+
+export class CheckpointScopeEnsureError extends Schema.TaggedErrorClass<CheckpointScopeEnsureError>()(
+  "CheckpointScopeEnsureError",
+  {
+    scopeId: CheckpointScopeId,
+    cause: Schema.Defect(),
+  },
+) {
+  override get message(): string {
+    return `Failed to ensure checkpoint scope ${this.scopeId}.`;
+  }
+}
+
+export class CheckpointBaselineCaptureError extends Schema.TaggedErrorClass<CheckpointBaselineCaptureError>()(
+  "CheckpointBaselineCaptureError",
+  {
+    scopeId: CheckpointScopeId,
+    ordinalWithinScope: Schema.Number,
+    cause: Schema.Defect(),
+  },
+) {
+  override get message(): string {
+    return `Failed to capture checkpoint baseline ${this.ordinalWithinScope} for scope ${this.scopeId}.`;
+  }
+}
+
+export class CheckpointCaptureError extends Schema.TaggedErrorClass<CheckpointCaptureError>()(
+  "CheckpointCaptureError",
+  {
+    scopeId: CheckpointScopeId,
+    parentCheckpointId: Schema.optional(CheckpointId),
+    cause: Schema.Defect(),
+  },
+) {
+  override get message(): string {
+    return `Failed to capture checkpoint for scope ${this.scopeId}.`;
+  }
+}
+
+export class CheckpointRestoreError extends Schema.TaggedErrorClass<CheckpointRestoreError>()(
+  "CheckpointRestoreError",
+  {
+    scopeId: CheckpointScopeId,
+    checkpointId: CheckpointId,
+    cause: Schema.Defect(),
+  },
+) {
+  override get message(): string {
+    return `Failed to restore checkpoint ${this.checkpointId} for scope ${this.scopeId}.`;
+  }
+}
+
+export class CheckpointDeleteStaleRefsError extends Schema.TaggedErrorClass<CheckpointDeleteStaleRefsError>()(
+  "CheckpointDeleteStaleRefsError",
+  {
+    scopeId: CheckpointScopeId,
+    checkpointIds: Schema.Array(CheckpointId),
+    cause: Schema.Defect(),
+  },
+) {
+  override get message(): string {
+    return `Failed to delete stale checkpoint refs for scope ${this.scopeId}.`;
+  }
+}
+
+export const CheckpointServiceV2Error = Schema.Union([
+  CheckpointRootScopePrepareError,
+  CheckpointScopeEnsureError,
+  CheckpointBaselineCaptureError,
+  CheckpointCaptureError,
+  CheckpointRestoreError,
+  CheckpointDeleteStaleRefsError,
+]);
+export type CheckpointServiceV2Error = typeof CheckpointServiceV2Error.Type;
+
+const isCheckpointRestoreError = Schema.is(CheckpointRestoreError);
+
+export interface CheckpointServiceV2Shape {
+  readonly prepareRootRunScope: (input: {
+    readonly threadId: ThreadId;
+    readonly runId: RunId;
+    readonly rootNodeId: NodeId;
+    readonly providerThreadId: ProviderThreadId;
+    readonly cwd: string;
+    readonly createdAt: DateTime.Utc;
+  }) => Effect.Effect<OrchestrationV2CheckpointScope, CheckpointServiceV2Error>;
+  readonly ensureScope: (
+    scope: OrchestrationV2CheckpointScope,
+  ) => Effect.Effect<OrchestrationV2CheckpointScope, CheckpointServiceV2Error>;
+  readonly captureBaseline: (input: {
+    readonly scope: OrchestrationV2CheckpointScope;
+    readonly ordinalWithinScope: number;
+  }) => Effect.Effect<void, CheckpointServiceV2Error>;
+  readonly materializeBaselineCheckpoint: (input: {
+    readonly scope: OrchestrationV2CheckpointScope;
+    readonly ordinalWithinScope: number;
+  }) => Effect.Effect<OrchestrationV2Checkpoint, CheckpointServiceV2Error>;
+  readonly capture: (input: {
+    readonly scope: OrchestrationV2CheckpointScope;
+    readonly runId: RunId | null;
+    readonly nodeId: NodeId;
+    readonly ordinalWithinScope: number;
+    readonly appRunOrdinal: number | null;
+    readonly capturedAt: DateTime.Utc;
+  }) => Effect.Effect<OrchestrationV2Checkpoint, CheckpointServiceV2Error>;
+  readonly restore: (input: {
+    readonly scope: OrchestrationV2CheckpointScope;
+    readonly checkpoint: OrchestrationV2Checkpoint;
+  }) => Effect.Effect<void, CheckpointServiceV2Error>;
+  readonly deleteStaleRefs: (input: {
+    readonly scope: OrchestrationV2CheckpointScope;
+    readonly checkpoints: ReadonlyArray<OrchestrationV2Checkpoint>;
+  }) => Effect.Effect<void, CheckpointServiceV2Error>;
+}
+
+export class CheckpointServiceV2 extends Context.Service<
+  CheckpointServiceV2,
+  CheckpointServiceV2Shape
+>()("t3/orchestration-v2/CheckpointService/CheckpointServiceV2") {}
+
+export function checkpointRefForScopeOrdinal(input: {
+  readonly scopeId: CheckpointScopeId;
+  readonly ordinalWithinScope: number;
+}): CheckpointRef {
+  const scopeKey = NodeCrypto.createHash("sha256").update(input.scopeId).digest("hex").slice(0, 32);
+  return CheckpointRef.make(
+    `${CHECKPOINT_REFS_PREFIX}/${Encoding.encodeBase64Url(scopeKey)}/ordinal/${input.ordinalWithinScope}`,
+  );
+}
+
+function checkpointIdForScopeOrdinal(
+  idAllocator: IdAllocatorV2Shape,
+  input: {
+    readonly scopeId: CheckpointScopeId;
+    readonly ordinalWithinScope: number;
+  },
+) {
+  return idAllocator.allocate.checkpoint({
+    checkpointScopeId: input.scopeId,
+    name: String(input.ordinalWithinScope),
+  });
+}
+
+function makeRootRunScope(input: {
+  readonly idAllocator: IdAllocatorV2Shape;
+  readonly threadId: ThreadId;
+  readonly runId: RunId;
+  readonly rootNodeId: NodeId;
+  readonly providerThreadId: ProviderThreadId;
+  readonly cwd: string;
+  readonly createdAt: DateTime.Utc;
+}) {
+  return Effect.gen(function* () {
+    const scopeId = yield* input.idAllocator.allocate.checkpointScope({
+      threadId: input.threadId,
+      name: ROOT_CHECKPOINT_SCOPE_NAME,
+    });
+    return {
+      id: scopeId,
+      threadId: input.threadId,
+      runId: input.runId,
+      nodeId: input.rootNodeId,
+      parentScopeId: null,
+      providerThreadId: input.providerThreadId,
+      kind: "root_run",
+      ordinalWithinParent: 0,
+      advancesAppRunCount: true,
+      cwd: input.cwd,
+      createdAt: input.createdAt,
+    } satisfies OrchestrationV2CheckpointScope;
+  });
+}
+
+function makeCheckpoint(input: {
+  readonly id: CheckpointId;
+  readonly scope: OrchestrationV2CheckpointScope;
+  readonly runId: RunId | null;
+  readonly nodeId: NodeId;
+  readonly parentCheckpointId: CheckpointId | null;
+  readonly ordinalWithinScope: number;
+  readonly appRunOrdinal: number | null;
+  readonly ref: CheckpointRef;
+  readonly status: OrchestrationV2Checkpoint["status"];
+  readonly files: OrchestrationV2Checkpoint["files"];
+  readonly capturedAt: DateTime.Utc;
+}): OrchestrationV2Checkpoint {
+  return {
+    id: input.id,
+    threadId: input.scope.threadId,
+    scopeId: input.scope.id,
+    runId: input.runId,
+    nodeId: input.nodeId,
+    parentCheckpointId: input.parentCheckpointId,
+    ordinalWithinScope: input.ordinalWithinScope,
+    appRunOrdinal: input.appRunOrdinal,
+    ref: input.ref,
+    status: input.status,
+    files: input.files,
+    capturedAt: input.capturedAt,
+  };
+}
+
+export const layer: Layer.Layer<
+  CheckpointServiceV2,
+  never,
+  CheckpointStore.CheckpointStore | IdAllocatorV2
+> = Layer.effect(
+  CheckpointServiceV2,
+  Effect.gen(function* () {
+    const checkpointStore = yield* CheckpointStore.CheckpointStore;
+    const idAllocator = yield* IdAllocatorV2;
+    const workspaceSemaphores = yield* Ref.make(new Map<string, Semaphore.Semaphore>());
+
+    const getWorkspaceSemaphore = (cwd: string) =>
+      Effect.gen(function* () {
+        const existing = (yield* Ref.get(workspaceSemaphores)).get(cwd);
+        if (existing !== undefined) {
+          return existing;
+        }
+
+        const created = yield* Semaphore.make(1);
+        return yield* Ref.modify(workspaceSemaphores, (current) => {
+          const concurrent = current.get(cwd);
+          if (concurrent !== undefined) {
+            return [concurrent, current];
+          }
+          const updated = new Map(current);
+          updated.set(cwd, created);
+          return [created, updated];
+        });
+      });
+
+    const withWorkspaceLock = <A, E, R>(cwd: string, effect: Effect.Effect<A, E, R>) =>
+      Effect.flatMap(getWorkspaceSemaphore(cwd), (semaphore) => semaphore.withPermits(1)(effect));
+
+    const isGitCheckpointable = (cwd: string) =>
+      checkpointStore.isGitRepository(cwd).pipe(Effect.orElseSucceed(() => false));
+
+    const ensureScope: CheckpointServiceV2Shape["ensureScope"] = (scope) => Effect.succeed(scope);
+
+    const captureBaseline: CheckpointServiceV2Shape["captureBaseline"] = (input) =>
+      withWorkspaceLock(
+        input.scope.cwd,
+        Effect.gen(function* () {
+          if (!(yield* isGitCheckpointable(input.scope.cwd))) {
+            return;
+          }
+
+          const checkpointRef = checkpointRefForScopeOrdinal({
+            scopeId: input.scope.id,
+            ordinalWithinScope: input.ordinalWithinScope,
+          });
+          const exists = yield* checkpointStore.hasCheckpointRef({
+            cwd: input.scope.cwd,
+            checkpointRef,
+          });
+          if (exists) {
+            return;
+          }
+
+          yield* checkpointStore.captureCheckpoint({
+            cwd: input.scope.cwd,
+            checkpointRef,
+          });
+        }),
+      ).pipe(
+        Effect.mapError(
+          (cause) =>
+            new CheckpointBaselineCaptureError({
+              scopeId: input.scope.id,
+              ordinalWithinScope: input.ordinalWithinScope,
+              cause,
+            }),
+        ),
+      );
+
+    const materializeBaselineCheckpoint: CheckpointServiceV2Shape["materializeBaselineCheckpoint"] =
+      (input) =>
+        withWorkspaceLock(
+          input.scope.cwd,
+          Effect.gen(function* () {
+            const checkpointRef = checkpointRefForScopeOrdinal({
+              scopeId: input.scope.id,
+              ordinalWithinScope: input.ordinalWithinScope,
+            });
+            const checkpointId = yield* checkpointIdForScopeOrdinal(idAllocator, {
+              scopeId: input.scope.id,
+              ordinalWithinScope: input.ordinalWithinScope,
+            });
+            const checkpointable = yield* isGitCheckpointable(input.scope.cwd);
+            const available = checkpointable
+              ? yield* checkpointStore.hasCheckpointRef({
+                  cwd: input.scope.cwd,
+                  checkpointRef,
+                })
+              : false;
+            return makeCheckpoint({
+              id: checkpointId,
+              scope: input.scope,
+              runId: null,
+              nodeId: input.scope.nodeId,
+              parentCheckpointId: null,
+              ordinalWithinScope: input.ordinalWithinScope,
+              appRunOrdinal: null,
+              ref: checkpointRef,
+              status: available ? "ready" : "missing",
+              files: [],
+              capturedAt: input.scope.createdAt,
+            });
+          }),
+        ).pipe(
+          Effect.mapError(
+            (cause) =>
+              new CheckpointCaptureError({
+                scopeId: input.scope.id,
+                cause,
+              }),
+          ),
+        );
+
+    const capture: CheckpointServiceV2Shape["capture"] = (input) =>
+      withWorkspaceLock(
+        input.scope.cwd,
+        Effect.gen(function* () {
+          const checkpointId = yield* checkpointIdForScopeOrdinal(idAllocator, {
+            scopeId: input.scope.id,
+            ordinalWithinScope: input.ordinalWithinScope,
+          });
+          const parentCheckpointId =
+            input.ordinalWithinScope > 0
+              ? yield* checkpointIdForScopeOrdinal(idAllocator, {
+                  scopeId: input.scope.id,
+                  ordinalWithinScope: input.ordinalWithinScope - 1,
+                })
+              : null;
+          const checkpointRef = checkpointRefForScopeOrdinal({
+            scopeId: input.scope.id,
+            ordinalWithinScope: input.ordinalWithinScope,
+          });
+          const previousCheckpointRef = checkpointRefForScopeOrdinal({
+            scopeId: input.scope.id,
+            ordinalWithinScope: Math.max(0, input.ordinalWithinScope - 1),
+          });
+
+          if (!(yield* isGitCheckpointable(input.scope.cwd))) {
+            return makeCheckpoint({
+              id: checkpointId,
+              scope: input.scope,
+              runId: input.runId,
+              nodeId: input.nodeId,
+              parentCheckpointId,
+              ordinalWithinScope: input.ordinalWithinScope,
+              appRunOrdinal: input.appRunOrdinal,
+              ref: checkpointRef,
+              status: "missing",
+              files: [],
+              capturedAt: input.capturedAt,
+            });
+          }
+
+          const captured = yield* checkpointStore
+            .captureCheckpoint({
+              cwd: input.scope.cwd,
+              checkpointRef,
+            })
+            .pipe(
+              Effect.as(true),
+              Effect.catch((cause) =>
+                Effect.logWarning("orchestration V2 checkpoint capture failed", {
+                  scopeId: input.scope.id,
+                  checkpointRef,
+                  cause: String(cause),
+                }).pipe(Effect.as(false)),
+              ),
+            );
+
+          if (!captured) {
+            return makeCheckpoint({
+              id: checkpointId,
+              scope: input.scope,
+              runId: input.runId,
+              nodeId: input.nodeId,
+              parentCheckpointId,
+              ordinalWithinScope: input.ordinalWithinScope,
+              appRunOrdinal: input.appRunOrdinal,
+              ref: checkpointRef,
+              status: "error",
+              files: [],
+              capturedAt: input.capturedAt,
+            });
+          }
+
+          const previousExists = yield* checkpointStore.hasCheckpointRef({
+            cwd: input.scope.cwd,
+            checkpointRef: previousCheckpointRef,
+          });
+          const files = previousExists
+            ? yield* checkpointStore
+                .diffCheckpoints({
+                  cwd: input.scope.cwd,
+                  fromCheckpointRef: previousCheckpointRef,
+                  toCheckpointRef: checkpointRef,
+                  fallbackFromToHead: false,
+                  ignoreWhitespace: false,
+                })
+                .pipe(
+                  Effect.map((diff) =>
+                    parseTurnDiffFilesFromUnifiedDiff(diff).map((file) => ({
+                      path: file.path,
+                      kind: "modified",
+                      additions: file.additions,
+                      deletions: file.deletions,
+                    })),
+                  ),
+                  Effect.catch((cause) =>
+                    Effect.logWarning("orchestration V2 checkpoint diff summary failed", {
+                      scopeId: input.scope.id,
+                      checkpointRef,
+                      cause: String(cause),
+                    }).pipe(Effect.as([])),
+                  ),
+                )
+            : [];
+
+          return makeCheckpoint({
+            id: checkpointId,
+            scope: input.scope,
+            runId: input.runId,
+            nodeId: input.nodeId,
+            parentCheckpointId,
+            ordinalWithinScope: input.ordinalWithinScope,
+            appRunOrdinal: input.appRunOrdinal,
+            ref: checkpointRef,
+            status: "ready",
+            files,
+            capturedAt: input.capturedAt,
+          });
+        }),
+      ).pipe(
+        Effect.mapError(
+          (cause) =>
+            new CheckpointCaptureError({
+              scopeId: input.scope.id,
+              cause,
+            }),
+        ),
+      );
+
+    const restore: CheckpointServiceV2Shape["restore"] = (input) =>
+      withWorkspaceLock(
+        input.scope.cwd,
+        Effect.gen(function* () {
+          if (input.checkpoint.status !== "ready") {
+            return yield* new CheckpointRestoreError({
+              scopeId: input.scope.id,
+              checkpointId: input.checkpoint.id,
+              cause: `Checkpoint status is ${input.checkpoint.status}.`,
+            });
+          }
+
+          const restored = yield* checkpointStore.restoreCheckpoint({
+            cwd: input.scope.cwd,
+            checkpointRef: input.checkpoint.ref,
+            fallbackToHead: false,
+          });
+          if (!restored) {
+            return yield* new CheckpointRestoreError({
+              scopeId: input.scope.id,
+              checkpointId: input.checkpoint.id,
+              cause: "Checkpoint ref is unavailable.",
+            });
+          }
+        }),
+      ).pipe(
+        Effect.mapError((cause) =>
+          isCheckpointRestoreError(cause)
+            ? cause
+            : new CheckpointRestoreError({
+                scopeId: input.scope.id,
+                checkpointId: input.checkpoint.id,
+                cause,
+              }),
+        ),
+      );
+
+    const deleteStaleRefs: CheckpointServiceV2Shape["deleteStaleRefs"] = (input) =>
+      withWorkspaceLock(
+        input.scope.cwd,
+        checkpointStore.deleteCheckpointRefs({
+          cwd: input.scope.cwd,
+          checkpointRefs: input.checkpoints.map((checkpoint) => checkpoint.ref),
+        }),
+      ).pipe(
+        Effect.mapError(
+          (cause) =>
+            new CheckpointDeleteStaleRefsError({
+              scopeId: input.scope.id,
+              checkpointIds: input.checkpoints.map((checkpoint) => checkpoint.id),
+              cause,
+            }),
+        ),
+      );
+
+    return CheckpointServiceV2.of({
+      prepareRootRunScope: (input) =>
+        makeRootRunScope({ ...input, idAllocator }).pipe(
+          Effect.mapError(
+            (cause) =>
+              new CheckpointRootScopePrepareError({
+                threadId: input.threadId,
+                runId: input.runId,
+                cause,
+              }),
+          ),
+        ),
+      ensureScope,
+      captureBaseline,
+      materializeBaselineCheckpoint,
+      capture,
+      restore,
+      deleteStaleRefs,
+    } satisfies CheckpointServiceV2Shape);
+  }),
+);
diff --git a/apps/server/src/orchestration-v2/CommandPolicy.test.ts b/apps/server/src/orchestration-v2/CommandPolicy.test.ts
new file mode 100644
index 000000000000..90f004f31354
--- /dev/null
+++ b/apps/server/src/orchestration-v2/CommandPolicy.test.ts
@@ -0,0 +1,310 @@
+import { assert, it } from "@effect/vitest";
+import {
+  CommandId,
+  type OrchestrationV2ProviderCapabilities,
+  ProviderInstanceId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+
+import { CodexProviderCapabilitiesV2 } from "./Adapters/CodexAdapterV2.ts";
+import { CursorProviderCapabilitiesV2 } from "./Adapters/CursorAdapterV2.ts";
+import { GrokProviderCapabilitiesV2 } from "./Adapters/GrokAdapterV2.ts";
+import {
+  CommandPolicyCapabilityUnsupportedError,
+  CommandPolicyV2,
+  layer as commandPolicyLayer,
+} from "./CommandPolicy.ts";
+
+const commandId = CommandId.make("command-policy-test");
+const threadId = ThreadId.make("command-policy-thread");
+
+const baseCapabilities: OrchestrationV2ProviderCapabilities = CodexProviderCapabilitiesV2;
+
+function capabilities(
+  override: (current: OrchestrationV2ProviderCapabilities) => OrchestrationV2ProviderCapabilities,
+): OrchestrationV2ProviderCapabilities {
+  return override(baseCapabilities);
+}
+
+const layer = it.layer(commandPolicyLayer);
+
+layer("CommandPolicyV2", (it) => {
+  it.effect("prefers direct active steering when the provider supports it", () =>
+    Effect.gen(function* () {
+      const policy = yield* CommandPolicyV2;
+
+      const result = yield* policy.decideSteeringExecution({
+        commandId,
+        threadId,
+        providerInstanceId: ProviderInstanceId.make("codex"),
+        capabilities: baseCapabilities,
+      });
+
+      assert.equal(result, "active_steering");
+    }),
+  );
+
+  it.effect("uses interrupt-and-restart steering when direct steering is unavailable", () =>
+    Effect.gen(function* () {
+      const policy = yield* CommandPolicyV2;
+
+      const result = yield* policy.decideSteeringExecution({
+        commandId,
+        threadId,
+        providerInstanceId: ProviderInstanceId.make("codex"),
+        capabilities: capabilities((current) => ({
+          ...current,
+          turns: {
+            ...current.turns,
+            supportsActiveSteering: false,
+            supportsInterrupt: true,
+            supportsSteeringByInterruptRestart: true,
+          },
+        })),
+      });
+
+      assert.equal(result, "interrupt_restart");
+    }),
+  );
+
+  it.effect("uses interrupt-and-restart steering for Grok ACP", () =>
+    Effect.gen(function* () {
+      const policy = yield* CommandPolicyV2;
+
+      const result = yield* policy.decideSteeringExecution({
+        commandId,
+        threadId,
+        providerInstanceId: ProviderInstanceId.make("grok"),
+        capabilities: GrokProviderCapabilitiesV2,
+      });
+
+      assert.equal(result, "interrupt_restart");
+    }),
+  );
+
+  it.effect("honors an explicit interrupt-and-restart request", () =>
+    Effect.gen(function* () {
+      const policy = yield* CommandPolicyV2;
+
+      const result = yield* policy.decideSteeringExecution({
+        commandId,
+        threadId,
+        providerInstanceId: ProviderInstanceId.make("codex"),
+        capabilities: CodexProviderCapabilitiesV2,
+        forceRestart: true,
+      });
+
+      assert.equal(result, "interrupt_restart");
+    }),
+  );
+
+  it.effect("returns typed capability errors for unsupported active steering", () =>
+    Effect.gen(function* () {
+      const policy = yield* CommandPolicyV2;
+
+      const error = yield* policy
+        .decideSteeringExecution({
+          commandId,
+          threadId,
+          providerInstanceId: ProviderInstanceId.make("codex"),
+          capabilities: capabilities((current) => ({
+            ...current,
+            turns: {
+              ...current.turns,
+              supportsActiveSteering: false,
+              supportsInterrupt: false,
+              supportsSteeringByInterruptRestart: false,
+            },
+          })),
+        })
+        .pipe(Effect.flip);
+
+      assert.instanceOf(error, CommandPolicyCapabilityUnsupportedError);
+      assert.equal(error.capability, "active_steering");
+    }),
+  );
+
+  it.effect("guards native fork behind fork and identity capabilities", () =>
+    Effect.gen(function* () {
+      const policy = yield* CommandPolicyV2;
+
+      const error = yield* policy
+        .ensureNativeFork({
+          commandId,
+          threadId,
+          providerInstanceId: ProviderInstanceId.make("codex"),
+          fromSpecificTurn: true,
+          capabilities: capabilities((current) => ({
+            ...current,
+            identity: {
+              ...current.identity,
+              nativeThreadIds: "weak",
+            },
+          })),
+        })
+        .pipe(Effect.flip);
+
+      assert.instanceOf(error, CommandPolicyCapabilityUnsupportedError);
+      assert.equal(error.capability, "native_fork");
+    }),
+  );
+
+  it.effect("uses a native fork when the provider supports the requested source point", () =>
+    Effect.gen(function* () {
+      const policy = yield* CommandPolicyV2;
+
+      const result = yield* policy.decideForkExecution({
+        commandId,
+        threadId,
+        providerInstanceId: ProviderInstanceId.make("codex"),
+        capabilities: CodexProviderCapabilitiesV2,
+        sameProvider: true,
+        hasStrongNativeSource: true,
+        fromSpecificTurn: true,
+      });
+
+      assert.equal(result, "native_fork");
+    }),
+  );
+
+  it.effect("falls back to portable context when Cursor cannot fork natively", () =>
+    Effect.gen(function* () {
+      const policy = yield* CommandPolicyV2;
+
+      const result = yield* policy.decideForkExecution({
+        commandId,
+        threadId,
+        providerInstanceId: ProviderInstanceId.make("cursor"),
+        capabilities: CursorProviderCapabilitiesV2,
+        sameProvider: true,
+        hasStrongNativeSource: true,
+        fromSpecificTurn: true,
+      });
+
+      assert.equal(result, "portable_context");
+    }),
+  );
+
+  it.effect("falls back to portable context when Grok ACP cannot fork natively", () =>
+    Effect.gen(function* () {
+      const policy = yield* CommandPolicyV2;
+
+      const result = yield* policy.decideForkExecution({
+        commandId,
+        threadId,
+        providerInstanceId: ProviderInstanceId.make("grok"),
+        capabilities: GrokProviderCapabilitiesV2,
+        sameProvider: true,
+        hasStrongNativeSource: true,
+        fromSpecificTurn: true,
+      });
+
+      assert.equal(result, "portable_context");
+    }),
+  );
+
+  it.effect("returns a typed error when neither native nor portable fork is available", () =>
+    Effect.gen(function* () {
+      const policy = yield* CommandPolicyV2;
+
+      const error = yield* policy
+        .decideForkExecution({
+          commandId,
+          threadId,
+          providerInstanceId: ProviderInstanceId.make("cursor"),
+          capabilities: capabilities((current) => ({
+            ...current,
+            threads: {
+              ...current.threads,
+              canForkThread: false,
+            },
+            context: {
+              ...current.context,
+              canConsumeHandoffSummaries: false,
+            },
+          })),
+          sameProvider: true,
+          hasStrongNativeSource: true,
+          fromSpecificTurn: true,
+        })
+        .pipe(Effect.flip);
+
+      assert.instanceOf(error, CommandPolicyCapabilityUnsupportedError);
+      assert.equal(error.capability, "context_handoff");
+    }),
+  );
+
+  it.effect("guards rollback behind provider rollback snapshot support", () =>
+    Effect.gen(function* () {
+      const policy = yield* CommandPolicyV2;
+
+      const error = yield* policy
+        .ensureRollback({
+          commandId,
+          threadId,
+          providerInstanceId: ProviderInstanceId.make("codex"),
+          capabilities: capabilities((current) => ({
+            ...current,
+            checkpointing: {
+              ...current.checkpointing,
+              providerRollbackReturnsSnapshot: false,
+            },
+          })),
+        })
+        .pipe(Effect.flip);
+
+      assert.instanceOf(error, CommandPolicyCapabilityUnsupportedError);
+      assert.equal(error.capability, "rollback_snapshot");
+    }),
+  );
+
+  it.effect("guards fork-delta handoff behind context handoff capabilities", () =>
+    Effect.gen(function* () {
+      const policy = yield* CommandPolicyV2;
+
+      const error = yield* policy
+        .ensureContextHandoff({
+          commandId,
+          threadId,
+          providerInstanceId: ProviderInstanceId.make("codex"),
+          strategy: "fork_delta_context",
+          capabilities: capabilities((current) => ({
+            ...current,
+            context: {
+              ...current.context,
+              supportsDeltaHandoff: false,
+            },
+          })),
+        })
+        .pipe(Effect.flip);
+
+      assert.instanceOf(error, CommandPolicyCapabilityUnsupportedError);
+      assert.equal(error.capability, "context_handoff");
+    }),
+  );
+
+  it.effect("guards queued turns behind queued-message support", () =>
+    Effect.gen(function* () {
+      const policy = yield* CommandPolicyV2;
+
+      const error = yield* policy
+        .ensureQueuedMessages({
+          commandId,
+          threadId,
+          providerInstanceId: ProviderInstanceId.make("codex"),
+          capabilities: capabilities((current) => ({
+            ...current,
+            turns: {
+              ...current.turns,
+              supportsQueuedMessages: false,
+            },
+          })),
+        })
+        .pipe(Effect.flip);
+
+      assert.instanceOf(error, CommandPolicyCapabilityUnsupportedError);
+      assert.equal(error.capability, "queued_messages");
+    }),
+  );
+});
diff --git a/apps/server/src/orchestration-v2/CommandPolicy.ts b/apps/server/src/orchestration-v2/CommandPolicy.ts
new file mode 100644
index 000000000000..d96ace4dbcc9
--- /dev/null
+++ b/apps/server/src/orchestration-v2/CommandPolicy.ts
@@ -0,0 +1,428 @@
+import {
+  CommandId,
+  ModelSelection,
+  OrchestrationV2ProviderCapabilities,
+  OrchestrationV2ThreadProjection,
+  ProviderInstanceId,
+  ProviderTurnId,
+  RunId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Schema from "effect/Schema";
+
+export const MessageDispatchDecisionV2 = Schema.Union([
+  Schema.Struct({
+    type: Schema.Literal("start_run"),
+    modelSelection: ModelSelection,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("steer_active"),
+    targetRunId: RunId,
+    providerTurnId: ProviderTurnId,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("restart_active"),
+    targetRunId: RunId,
+    interruptProviderTurnId: ProviderTurnId,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("queue_after_active"),
+    activeRunId: RunId,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("switch_provider"),
+    fromProviderInstanceId: ProviderInstanceId,
+    toModelSelection: ModelSelection,
+  }),
+]);
+export type MessageDispatchDecisionV2 = typeof MessageDispatchDecisionV2.Type;
+
+export const SteeringExecutionPolicyV2 = Schema.Literals(["active_steering", "interrupt_restart"]);
+export type SteeringExecutionPolicyV2 = typeof SteeringExecutionPolicyV2.Type;
+
+export const ForkExecutionPolicyV2 = Schema.Literals(["native_fork", "portable_context"]);
+export type ForkExecutionPolicyV2 = typeof ForkExecutionPolicyV2.Type;
+
+export const CommandPolicyCapability = Schema.Literals([
+  "queued_messages",
+  "active_steering",
+  "interrupt",
+  "interrupt_restart_steering",
+  "native_fork",
+  "fork_from_turn",
+  "rollback",
+  "rollback_snapshot",
+  "context_handoff",
+  "strong_terminal_status",
+]);
+export type CommandPolicyCapability = typeof CommandPolicyCapability.Type;
+
+export class CommandPolicyMessageDispatchError extends Schema.TaggedErrorClass<CommandPolicyMessageDispatchError>()(
+  "CommandPolicyMessageDispatchError",
+  {
+    commandId: CommandId,
+    threadId: ThreadId,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to choose message dispatch policy for command ${this.commandId}.`;
+  }
+}
+
+export class CommandPolicyUnsupportedError extends Schema.TaggedErrorClass<CommandPolicyUnsupportedError>()(
+  "CommandPolicyUnsupportedError",
+  {
+    commandId: CommandId,
+    threadId: ThreadId,
+    requestedMode: Schema.String,
+    providerInstanceId: ProviderInstanceId,
+  },
+) {
+  override get message(): string {
+    return `${this.providerInstanceId} cannot satisfy message dispatch mode ${this.requestedMode} for command ${this.commandId}.`;
+  }
+}
+
+export class CommandPolicyCapabilityUnsupportedError extends Schema.TaggedErrorClass<CommandPolicyCapabilityUnsupportedError>()(
+  "CommandPolicyCapabilityUnsupportedError",
+  {
+    commandId: CommandId,
+    threadId: ThreadId,
+    providerInstanceId: ProviderInstanceId,
+    capability: CommandPolicyCapability,
+    detail: Schema.String,
+  },
+) {
+  override get message(): string {
+    return `${this.providerInstanceId} cannot satisfy ${this.capability} for command ${this.commandId}: ${this.detail}`;
+  }
+}
+
+export const CommandPolicyV2Error = Schema.Union([
+  CommandPolicyMessageDispatchError,
+  CommandPolicyUnsupportedError,
+  CommandPolicyCapabilityUnsupportedError,
+]);
+export type CommandPolicyV2Error = typeof CommandPolicyV2Error.Type;
+
+interface CapabilityCheckInput {
+  readonly commandId: CommandId;
+  readonly threadId: ThreadId;
+  readonly providerInstanceId: ProviderInstanceId;
+  readonly capabilities: OrchestrationV2ProviderCapabilities;
+}
+
+export interface CommandPolicyV2Shape {
+  readonly decideMessageDispatch: (input: {
+    readonly commandId: CommandId;
+    readonly projection: OrchestrationV2ThreadProjection;
+    readonly requestedModelSelection?: ModelSelection;
+    readonly requestedMode:
+      | { readonly type: "steer_active"; readonly targetRunId: RunId }
+      | { readonly type: "restart_active"; readonly targetRunId: RunId }
+      | { readonly type: "queue_after_active" }
+      | { readonly type: "start_immediately" };
+    readonly capabilities: OrchestrationV2ProviderCapabilities;
+  }) => Effect.Effect<MessageDispatchDecisionV2, CommandPolicyV2Error>;
+  readonly ensureQueuedMessages: (
+    input: CapabilityCheckInput,
+  ) => Effect.Effect<void, CommandPolicyV2Error>;
+  readonly decideSteeringExecution: (
+    input: CapabilityCheckInput & {
+      readonly forceRestart?: boolean;
+    },
+  ) => Effect.Effect<SteeringExecutionPolicyV2, CommandPolicyV2Error>;
+  readonly ensureInterrupt: (
+    input: CapabilityCheckInput,
+  ) => Effect.Effect<void, CommandPolicyV2Error>;
+  readonly ensureNativeFork: (
+    input: CapabilityCheckInput & {
+      readonly fromSpecificTurn: boolean;
+    },
+  ) => Effect.Effect<void, CommandPolicyV2Error>;
+  readonly decideForkExecution: (
+    input: CapabilityCheckInput & {
+      readonly sameProvider: boolean;
+      readonly hasStrongNativeSource: boolean;
+      readonly fromSpecificTurn: boolean;
+    },
+  ) => Effect.Effect<ForkExecutionPolicyV2, CommandPolicyV2Error>;
+  readonly ensureRollback: (
+    input: CapabilityCheckInput,
+  ) => Effect.Effect<void, CommandPolicyV2Error>;
+  readonly ensureContextHandoff: (
+    input: CapabilityCheckInput & {
+      readonly strategy: "fork_delta_context" | "delta_context" | "full_thread_summary";
+    },
+  ) => Effect.Effect<void, CommandPolicyV2Error>;
+}
+
+export class CommandPolicyV2 extends Context.Service<CommandPolicyV2, CommandPolicyV2Shape>()(
+  "t3/orchestration-v2/CommandPolicy/CommandPolicyV2",
+) {}
+
+function unsupported(
+  input: CapabilityCheckInput,
+  capability: CommandPolicyCapability,
+  detail: string,
+) {
+  return new CommandPolicyCapabilityUnsupportedError({
+    commandId: input.commandId,
+    threadId: input.threadId,
+    providerInstanceId: input.providerInstanceId,
+    capability,
+    detail,
+  });
+}
+
+const ensureQueuedMessages: CommandPolicyV2Shape["ensureQueuedMessages"] = (input) =>
+  input.capabilities.turns.supportsQueuedMessages
+    ? Effect.void
+    : Effect.fail(
+        unsupported(
+          input,
+          "queued_messages",
+          "providerInstanceId does not support app-owned queued turns",
+        ),
+      );
+
+const decideSteeringExecution: CommandPolicyV2Shape["decideSteeringExecution"] = (input) => {
+  if (!input.forceRestart && input.capabilities.turns.supportsActiveSteering) {
+    return Effect.succeed("active_steering");
+  }
+  if (
+    input.capabilities.turns.supportsInterrupt &&
+    input.capabilities.turns.supportsSteeringByInterruptRestart
+  ) {
+    return Effect.succeed("interrupt_restart");
+  }
+  return Effect.fail(
+    unsupported(
+      input,
+      input.capabilities.turns.supportsInterrupt ? "interrupt_restart_steering" : "active_steering",
+      "providerInstanceId cannot steer active turns directly or by interrupt-and-restart",
+    ),
+  );
+};
+
+const ensureInterrupt: CommandPolicyV2Shape["ensureInterrupt"] = (input) =>
+  input.capabilities.turns.supportsInterrupt
+    ? Effect.void
+    : Effect.fail(
+        unsupported(input, "interrupt", "providerInstanceId does not support turn interrupts"),
+      );
+
+const ensureNativeFork: CommandPolicyV2Shape["ensureNativeFork"] = (input) => {
+  if (!input.capabilities.threads.canForkThread) {
+    return Effect.fail(
+      unsupported(input, "native_fork", "providerInstanceId does not support native thread forks"),
+    );
+  }
+  if (input.fromSpecificTurn && !input.capabilities.threads.canForkFromTurn) {
+    return Effect.fail(
+      unsupported(
+        input,
+        "fork_from_turn",
+        "providerInstanceId cannot fork from a specific completed turn",
+      ),
+    );
+  }
+  if (input.capabilities.identity.nativeThreadIds !== "strong") {
+    return Effect.fail(
+      unsupported(
+        input,
+        "native_fork",
+        "providerInstanceId does not expose strong native thread ids",
+      ),
+    );
+  }
+  return Effect.void;
+};
+
+const ensureRollback: CommandPolicyV2Shape["ensureRollback"] = (input) => {
+  if (
+    !input.capabilities.threads.canRollbackThread ||
+    !input.capabilities.checkpointing.providerCanRollbackConversation
+  ) {
+    return Effect.fail(
+      unsupported(input, "rollback", "providerInstanceId conversation rollback is unavailable"),
+    );
+  }
+  if (!input.capabilities.checkpointing.providerRollbackReturnsSnapshot) {
+    return Effect.fail(
+      unsupported(
+        input,
+        "rollback_snapshot",
+        "rollback must return a providerInstanceId thread snapshot",
+      ),
+    );
+  }
+  return Effect.void;
+};
+
+const ensureContextHandoff: CommandPolicyV2Shape["ensureContextHandoff"] = (input) => {
+  if (!input.capabilities.context.canConsumeHandoffSummaries) {
+    return Effect.fail(
+      unsupported(input, "context_handoff", "providerInstanceId cannot consume handoff summaries"),
+    );
+  }
+  if (!input.capabilities.context.acceptsSyntheticUserContext) {
+    return Effect.fail(
+      unsupported(
+        input,
+        "context_handoff",
+        "providerInstanceId cannot receive synthetic user context",
+      ),
+    );
+  }
+  if (
+    (input.strategy === "fork_delta_context" || input.strategy === "delta_context") &&
+    !input.capabilities.context.supportsDeltaHandoff
+  ) {
+    return Effect.fail(
+      unsupported(input, "context_handoff", "providerInstanceId does not support delta handoff"),
+    );
+  }
+  if (
+    input.strategy === "full_thread_summary" &&
+    !input.capabilities.context.supportsFullThreadHandoff
+  ) {
+    return Effect.fail(
+      unsupported(
+        input,
+        "context_handoff",
+        "providerInstanceId does not support full-thread handoff",
+      ),
+    );
+  }
+  return Effect.void;
+};
+
+const decideForkExecution: CommandPolicyV2Shape["decideForkExecution"] = (input) => {
+  const canForkNatively =
+    input.sameProvider &&
+    input.hasStrongNativeSource &&
+    input.capabilities.threads.canForkThread &&
+    (!input.fromSpecificTurn || input.capabilities.threads.canForkFromTurn) &&
+    input.capabilities.identity.nativeThreadIds === "strong";
+
+  if (canForkNatively) {
+    return Effect.succeed("native_fork");
+  }
+
+  return ensureContextHandoff({
+    commandId: input.commandId,
+    threadId: input.threadId,
+    providerInstanceId: input.providerInstanceId,
+    capabilities: input.capabilities,
+    strategy: "full_thread_summary",
+  }).pipe(Effect.as("portable_context"));
+};
+
+const decideMessageDispatch: CommandPolicyV2Shape["decideMessageDispatch"] = (input) => {
+  const activeRun = input.projection.runs.find(
+    (run) =>
+      run.status === "preparing" ||
+      run.status === "starting" ||
+      run.status === "running" ||
+      run.status === "waiting",
+  );
+  const modelSelection = input.requestedModelSelection ?? input.projection.thread.modelSelection;
+
+  switch (input.requestedMode.type) {
+    case "steer_active": {
+      if (activeRun?.id !== input.requestedMode.targetRunId) {
+        return Effect.fail(
+          new CommandPolicyUnsupportedError({
+            commandId: input.commandId,
+            threadId: input.projection.thread.id,
+            requestedMode: input.requestedMode.type,
+            providerInstanceId: modelSelection.instanceId,
+          }),
+        );
+      }
+      const providerTurnId =
+        activeRun.activeAttemptId === null
+          ? undefined
+          : input.projection.providerTurns.find(
+              (turn) =>
+                turn.runAttemptId === activeRun.activeAttemptId && turn.status === "running",
+            )?.id;
+      return providerTurnId === undefined
+        ? Effect.fail(
+            new CommandPolicyMessageDispatchError({
+              commandId: input.commandId,
+              threadId: input.projection.thread.id,
+              cause: `No running providerInstanceId turn found for active run ${activeRun.id}.`,
+            }),
+          )
+        : Effect.succeed({
+            type: "steer_active",
+            targetRunId: activeRun.id,
+            providerTurnId,
+          });
+    }
+    case "restart_active": {
+      if (activeRun?.id !== input.requestedMode.targetRunId || activeRun.activeAttemptId === null) {
+        return Effect.fail(
+          new CommandPolicyUnsupportedError({
+            commandId: input.commandId,
+            threadId: input.projection.thread.id,
+            requestedMode: input.requestedMode.type,
+            providerInstanceId: modelSelection.instanceId,
+          }),
+        );
+      }
+      const providerTurnId = input.projection.providerTurns.find(
+        (turn) => turn.runAttemptId === activeRun.activeAttemptId && turn.status === "running",
+      )?.id;
+      return providerTurnId === undefined
+        ? Effect.fail(
+            new CommandPolicyMessageDispatchError({
+              commandId: input.commandId,
+              threadId: input.projection.thread.id,
+              cause: `No running providerInstanceId turn found for active run ${activeRun.id}.`,
+            }),
+          )
+        : Effect.succeed({
+            type: "restart_active",
+            targetRunId: activeRun.id,
+            interruptProviderTurnId: providerTurnId,
+          });
+    }
+    case "queue_after_active":
+      return activeRun === undefined
+        ? Effect.succeed({ type: "start_run", modelSelection })
+        : ensureQueuedMessages({
+            commandId: input.commandId,
+            threadId: input.projection.thread.id,
+            providerInstanceId: modelSelection.instanceId,
+            capabilities: input.capabilities,
+          }).pipe(Effect.as({ type: "queue_after_active", activeRunId: activeRun.id }));
+    case "start_immediately":
+      if (activeRun === undefined) {
+        return Effect.succeed({ type: "start_run", modelSelection });
+      }
+      return ensureQueuedMessages({
+        commandId: input.commandId,
+        threadId: input.projection.thread.id,
+        providerInstanceId: modelSelection.instanceId,
+        capabilities: input.capabilities,
+      }).pipe(Effect.as({ type: "queue_after_active", activeRunId: activeRun.id }));
+  }
+};
+
+export const layer: Layer.Layer<CommandPolicyV2> = Layer.succeed(CommandPolicyV2, {
+  decideMessageDispatch,
+  ensureQueuedMessages,
+  decideSteeringExecution,
+  ensureInterrupt,
+  ensureNativeFork,
+  decideForkExecution,
+  ensureRollback,
+  ensureContextHandoff,
+});
diff --git a/apps/server/src/orchestration-v2/CommandReceiptStore.ts b/apps/server/src/orchestration-v2/CommandReceiptStore.ts
new file mode 100644
index 000000000000..5cb413027b75
--- /dev/null
+++ b/apps/server/src/orchestration-v2/CommandReceiptStore.ts
@@ -0,0 +1,167 @@
+import { CommandId, NonNegativeInt, ThreadId } from "@t3tools/contracts";
+import * as Context from "effect/Context";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Schema from "effect/Schema";
+
+import { OrchestrationCommandReceiptRepositoryLive } from "../persistence/Layers/OrchestrationCommandReceipts.ts";
+import {
+  OrchestrationCommandReceiptRepository,
+  type OrchestrationCommandReceipt,
+} from "../persistence/Services/OrchestrationCommandReceipts.ts";
+
+/**
+ * ERRORS
+ */
+export class CommandReceiptStoreWriteError extends Schema.TaggedErrorClass<CommandReceiptStoreWriteError>()(
+  "CommandReceiptStoreWriteError",
+  {
+    commandId: CommandId,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to write orchestration V2 command receipt ${this.commandId}.`;
+  }
+}
+
+export class CommandReceiptStoreReadError extends Schema.TaggedErrorClass<CommandReceiptStoreReadError>()(
+  "CommandReceiptStoreReadError",
+  {
+    commandId: CommandId,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to read orchestration V2 command receipt ${this.commandId}.`;
+  }
+}
+
+export const CommandReceiptStoreV2Error = Schema.Union([
+  CommandReceiptStoreWriteError,
+  CommandReceiptStoreReadError,
+]);
+export type CommandReceiptStoreV2Error = typeof CommandReceiptStoreV2Error.Type;
+
+/**
+ * SERVICE DEFINITION
+ */
+export const CommandReceiptV2Status = Schema.Literals(["accepted", "rejected"]);
+export type CommandReceiptV2Status = typeof CommandReceiptV2Status.Type;
+
+export const CommandReceiptV2 = Schema.Struct({
+  commandId: CommandId,
+  threadId: ThreadId,
+  commandType: Schema.String,
+  acceptedAt: Schema.DateTimeUtc,
+  resultSequence: NonNegativeInt,
+  status: CommandReceiptV2Status,
+  error: Schema.NullOr(Schema.String),
+});
+export type CommandReceiptV2 = typeof CommandReceiptV2.Type;
+
+export interface CommandReceiptStoreV2Shape {
+  readonly insertIfAbsent: (
+    receipt: CommandReceiptV2,
+  ) => Effect.Effect<boolean, CommandReceiptStoreV2Error>;
+  readonly upsert: (receipt: CommandReceiptV2) => Effect.Effect<void, CommandReceiptStoreV2Error>;
+  readonly getByCommandId: (
+    commandId: CommandId,
+  ) => Effect.Effect<Option.Option<CommandReceiptV2>, CommandReceiptStoreV2Error>;
+}
+
+export class CommandReceiptStoreV2 extends Context.Service<
+  CommandReceiptStoreV2,
+  CommandReceiptStoreV2Shape
+>()("t3/orchestration-v2/CommandReceiptStore/CommandReceiptStoreV2") {}
+
+/**
+ * IMPLEMENTATIONS
+ */
+const decodeReceipt = Schema.decodeUnknownEffect(
+  CommandReceiptV2.mapFields((fields) => ({
+    ...fields,
+    acceptedAt: Schema.DateTimeUtcFromString,
+  })),
+);
+
+function fromApplicationReceipt(receipt: OrchestrationCommandReceipt) {
+  return decodeReceipt({
+    commandId: receipt.commandId,
+    threadId: receipt.aggregateId,
+    commandType: receipt.commandType,
+    acceptedAt: receipt.acceptedAt,
+    resultSequence: receipt.resultSequence,
+    status: receipt.status,
+    error: receipt.error,
+  });
+}
+
+function toApplicationReceipt(receipt: CommandReceiptV2): OrchestrationCommandReceipt {
+  return {
+    commandId: receipt.commandId,
+    aggregateKind: "thread",
+    aggregateId: receipt.threadId,
+    commandType: receipt.commandType,
+    acceptedAt: DateTime.formatIso(receipt.acceptedAt),
+    resultSequence: receipt.resultSequence,
+    status: receipt.status,
+    error: receipt.error,
+  };
+}
+
+const baseLayer: Layer.Layer<CommandReceiptStoreV2, never, OrchestrationCommandReceiptRepository> =
+  Layer.effect(
+    CommandReceiptStoreV2,
+    Effect.gen(function* () {
+      const receipts = yield* OrchestrationCommandReceiptRepository;
+
+      return CommandReceiptStoreV2.of({
+        insertIfAbsent: (receipt) =>
+          receipts.insertIfAbsent(toApplicationReceipt(receipt)).pipe(
+            Effect.mapError(
+              (cause) =>
+                new CommandReceiptStoreWriteError({
+                  commandId: receipt.commandId,
+                  cause,
+                }),
+            ),
+          ),
+        upsert: (receipt) =>
+          receipts.upsert(toApplicationReceipt(receipt)).pipe(
+            Effect.mapError(
+              (cause) =>
+                new CommandReceiptStoreWriteError({
+                  commandId: receipt.commandId,
+                  cause,
+                }),
+            ),
+          ),
+        getByCommandId: (commandId) =>
+          receipts.getByCommandId({ commandId }).pipe(
+            Effect.flatMap(
+              Option.match({
+                onNone: () => Effect.succeed(Option.none()),
+                onSome: (receipt) =>
+                  receipt.aggregateKind !== "thread"
+                    ? Effect.succeed(Option.none())
+                    : fromApplicationReceipt(receipt).pipe(Effect.map(Option.some)),
+              }),
+            ),
+            Effect.mapError(
+              (cause) =>
+                new CommandReceiptStoreReadError({
+                  commandId,
+                  cause,
+                }),
+            ),
+          ),
+      } satisfies CommandReceiptStoreV2Shape);
+    }),
+  );
+
+export const layer = baseLayer.pipe(Layer.provide(OrchestrationCommandReceiptRepositoryLive));
+
+export const layerFromApplicationReceipts = baseLayer;
diff --git a/apps/server/src/orchestration-v2/ContextHandoffService.test.ts b/apps/server/src/orchestration-v2/ContextHandoffService.test.ts
new file mode 100644
index 000000000000..7b2311b5f260
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ContextHandoffService.test.ts
@@ -0,0 +1,164 @@
+import { assert, it } from "@effect/vitest";
+import {
+  MessageId,
+  ProviderInstanceId,
+  ProviderThreadId,
+  RunId,
+  ThreadId,
+  TurnItemId,
+  type OrchestrationV2TurnItem,
+} from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+
+import {
+  ContextHandoffServiceV2,
+  layer as contextHandoffServiceLayer,
+  providerMessageWithContextHandoff,
+} from "./ContextHandoffService.ts";
+import { layer as idAllocatorLayer } from "./IdAllocator.ts";
+
+const TestLayer = contextHandoffServiceLayer.pipe(Layer.provide(idAllocatorLayer));
+
+function importedItem(
+  input:
+    | {
+        readonly role: "user";
+        readonly id: string;
+        readonly text: string;
+        readonly ordinal: number;
+      }
+    | {
+        readonly role: "assistant";
+        readonly id: string;
+        readonly text: string;
+        readonly ordinal: number;
+      },
+): OrchestrationV2TurnItem {
+  const now = DateTime.makeUnsafe("2026-01-01T00:00:00.000Z");
+  const base = {
+    id: TurnItemId.make(`turn-item:${input.id}`),
+    threadId: ThreadId.make("thread:legacy-context"),
+    runId: null,
+    nodeId: null,
+    providerThreadId: null,
+    providerTurnId: null,
+    nativeItemRef: null,
+    parentItemId: null,
+    ordinal: input.ordinal,
+    status: "completed" as const,
+    title: null,
+    startedAt: now,
+    completedAt: now,
+    updatedAt: now,
+    messageId: MessageId.make(`message:${input.id}`),
+    text: input.text,
+  };
+  return input.role === "user"
+    ? {
+        ...base,
+        createdBy: "user",
+        creationSource: "server",
+        type: "user_message",
+        inputIntent: "turn_start",
+        attachments: [],
+      }
+    : {
+        ...base,
+        type: "assistant_message",
+        streaming: false,
+      };
+}
+
+it.layer(TestLayer)("ContextHandoffService legacy import", (it) => {
+  it.effect("prepares imported history for the first native v2 turn", () =>
+    Effect.gen(function* () {
+      const service = yield* ContextHandoffServiceV2;
+      const handoff = yield* service.prepareLegacyImport({
+        threadId: ThreadId.make("thread:legacy-context"),
+        targetRunId: RunId.make("run:first-v2"),
+        toProviderThreadId: ProviderThreadId.make("provider-thread:first-v2"),
+        toProviderInstanceId: ProviderInstanceId.make("codex"),
+        items: [
+          importedItem({ role: "user", id: "one", text: "What did we decide?", ordinal: 1 }),
+          importedItem({
+            role: "assistant",
+            id: "two",
+            text: "We decided to keep the migration lightweight.",
+            ordinal: 2,
+          }),
+        ],
+        createdAt: DateTime.makeUnsafe("2026-01-02T00:00:00.000Z"),
+      });
+
+      assert.equal(handoff.strategy, "manual_context");
+      assert.deepStrictEqual(handoff.fromProviderThreadIds, []);
+      assert.include(handoff.summaryText, "What did we decide?");
+      assert.include(handoff.summaryText, "keep the migration lightweight");
+      const providerMessage = providerMessageWithContextHandoff({
+        handoff,
+        userText: "Continue from there.",
+      });
+      assert.include(providerMessage, handoff.summaryText);
+      assert.include(providerMessage, "User message:\nContinue from there.");
+    }),
+  );
+
+  it.effect("preserves role attribution when truncating imported history", () =>
+    Effect.gen(function* () {
+      const service = yield* ContextHandoffServiceV2;
+      const handoff = yield* service.prepareLegacyImport({
+        threadId: ThreadId.make("thread:legacy-context"),
+        targetRunId: RunId.make("run:first-v2"),
+        toProviderThreadId: ProviderThreadId.make("provider-thread:first-v2"),
+        toProviderInstanceId: ProviderInstanceId.make("codex"),
+        items: [
+          importedItem({
+            role: "user",
+            id: "long",
+            text: `${"x".repeat(35_000)} retained final words`,
+            ordinal: 1,
+          }),
+        ],
+        createdAt: DateTime.makeUnsafe("2026-01-02T00:00:00.000Z"),
+      });
+
+      assert.isAtMost(handoff.summaryText.length, 32_000);
+      assert.include(handoff.summaryText, "User:\n... retained final words");
+      assert.notMatch(handoff.summaryText, /\n+x+ retained final words/);
+    }),
+  );
+
+  it.effect("retains the newest oversized import even when it has no whitespace", () =>
+    Effect.gen(function* () {
+      const service = yield* ContextHandoffServiceV2;
+      const handoff = yield* service.prepareLegacyImport({
+        threadId: ThreadId.make("thread:legacy-context"),
+        targetRunId: RunId.make("run:first-v2"),
+        toProviderThreadId: ProviderThreadId.make("provider-thread:first-v2"),
+        toProviderInstanceId: ProviderInstanceId.make("codex"),
+        items: [
+          importedItem({
+            role: "assistant",
+            id: "older",
+            text: "older message",
+            ordinal: 1,
+          }),
+          importedItem({
+            role: "user",
+            id: "long-single-token",
+            text: `${"🧪".repeat(20_000)}LATEST_SINGLE_TOKEN`,
+            ordinal: 2,
+          }),
+        ],
+        createdAt: DateTime.makeUnsafe("2026-01-02T00:00:00.000Z"),
+      });
+
+      assert.isAtMost(handoff.summaryText.length, 32_000);
+      assert.include(handoff.summaryText, "User:\n... ");
+      assert.include(handoff.summaryText, "LATEST_SINGLE_TOKEN");
+      assert.notInclude(handoff.summaryText, "\ufffd");
+    }),
+  );
+});
diff --git a/apps/server/src/orchestration-v2/ContextHandoffService.ts b/apps/server/src/orchestration-v2/ContextHandoffService.ts
new file mode 100644
index 000000000000..8f90ba5908bb
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ContextHandoffService.ts
@@ -0,0 +1,459 @@
+import {
+  OrchestrationV2ContextHandoff,
+  type OrchestrationV2TurnItem,
+  ProviderInstanceId,
+  ProviderThreadId,
+  RunId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as Context from "effect/Context";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Schema from "effect/Schema";
+
+import { IdAllocatorV2 } from "./IdAllocator.ts";
+
+export class ContextHandoffPrepareError extends Schema.TaggedErrorClass<ContextHandoffPrepareError>()(
+  "ContextHandoffPrepareError",
+  {
+    threadId: ThreadId,
+    targetRunId: RunId,
+    fromProviderThreadIds: Schema.Array(ProviderThreadId),
+    toProviderThreadId: ProviderThreadId,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to prepare context handoff for run ${this.targetRunId} in thread ${this.threadId}.`;
+  }
+}
+
+export const ContextHandoffServiceV2Error = Schema.Union([ContextHandoffPrepareError]);
+export type ContextHandoffServiceV2Error = typeof ContextHandoffServiceV2Error.Type;
+
+export interface ContextHandoffServiceV2Shape {
+  readonly prepareLegacyImport: (input: {
+    readonly threadId: ThreadId;
+    readonly targetRunId: RunId;
+    readonly toProviderThreadId: ProviderThreadId;
+    readonly toProviderInstanceId: ProviderInstanceId;
+    readonly items: ReadonlyArray<OrchestrationV2TurnItem>;
+    readonly createdAt: DateTime.Utc;
+  }) => Effect.Effect<OrchestrationV2ContextHandoff, ContextHandoffServiceV2Error>;
+  readonly prepare: (input: {
+    readonly threadId: ThreadId;
+    readonly targetRunId: RunId;
+    readonly fromProviderThreadIds: ReadonlyArray<ProviderThreadId>;
+    readonly toProviderThreadId: ProviderThreadId;
+  }) => Effect.Effect<OrchestrationV2ContextHandoff, ContextHandoffServiceV2Error>;
+  readonly prepareForkDelta: (input: {
+    readonly sourceThreadId: ThreadId;
+    readonly targetThreadId: ThreadId;
+    readonly targetRunId: RunId;
+    readonly transferId: OrchestrationV2ContextHandoff["transferId"];
+    readonly fromProviderThreadIds: ReadonlyArray<ProviderThreadId>;
+    readonly toProviderThreadId: ProviderThreadId;
+    readonly fromProviderInstanceId: ProviderInstanceId;
+    readonly toProviderInstanceId: ProviderInstanceId;
+    readonly coveredRunOrdinals: OrchestrationV2ContextHandoff["coveredRunOrdinals"];
+    readonly deltaItems: ReadonlyArray<OrchestrationV2TurnItem>;
+    readonly createdAt: DateTime.Utc;
+  }) => Effect.Effect<OrchestrationV2ContextHandoff, ContextHandoffServiceV2Error>;
+  readonly prepareProviderHandoff: (input: {
+    readonly threadId: ThreadId;
+    readonly targetRunId: RunId;
+    readonly transferId: NonNullable<OrchestrationV2ContextHandoff["transferId"]>;
+    readonly fromProviderThreadIds: ReadonlyArray<ProviderThreadId>;
+    readonly toProviderThreadId: ProviderThreadId;
+    readonly fromProviderInstanceId: ProviderInstanceId;
+    readonly toProviderInstanceId: ProviderInstanceId;
+    readonly coveredRunOrdinals: OrchestrationV2ContextHandoff["coveredRunOrdinals"];
+    readonly strategy: Extract<
+      OrchestrationV2ContextHandoff["strategy"],
+      "delta_since_target_last_seen" | "full_thread_summary"
+    >;
+    readonly items: ReadonlyArray<OrchestrationV2TurnItem>;
+    readonly createdAt: DateTime.Utc;
+  }) => Effect.Effect<OrchestrationV2ContextHandoff, ContextHandoffServiceV2Error>;
+}
+
+export class ContextHandoffServiceV2 extends Context.Service<
+  ContextHandoffServiceV2,
+  ContextHandoffServiceV2Shape
+>()("t3/orchestration-v2/ContextHandoffService/ContextHandoffServiceV2") {}
+
+function compactText(text: string, maxLength = 240): string {
+  const compacted = text.replace(/\s+/g, " ").trim();
+  if (compacted.length <= maxLength) {
+    return compacted;
+  }
+  return `${compacted.slice(0, maxLength - 3)}...`;
+}
+
+function summarizeDeltaItem(item: OrchestrationV2TurnItem): string | null {
+  switch (item.type) {
+    case "user_message":
+      return `- User: ${compactText(item.text)}`;
+    case "assistant_message":
+      return `- Assistant: ${compactText(item.text)}`;
+    case "command_execution":
+      return `- Command: ${compactText(item.input)}`;
+    case "file_change":
+      return `- File change: ${item.fileName}`;
+    case "checkpoint":
+      return `- Checkpoint: ${item.files.length} files`;
+    case "handoff":
+      return `- Handoff: ${compactText(item.summary ?? item.strategy)}`;
+    default:
+      return null;
+  }
+}
+
+function makeForkDeltaSummary(input: {
+  readonly sourceThreadId: ThreadId;
+  readonly targetThreadId: ThreadId;
+  readonly coveredRunOrdinals: OrchestrationV2ContextHandoff["coveredRunOrdinals"];
+  readonly deltaItems: ReadonlyArray<OrchestrationV2TurnItem>;
+}): string {
+  const itemLines = input.deltaItems.flatMap((item) => {
+    const line = summarizeDeltaItem(item);
+    return line === null ? [] : [line];
+  });
+  return [
+    "Merge-back context from forked conversation.",
+    `Source thread: ${input.sourceThreadId}`,
+    `Target thread: ${input.targetThreadId}`,
+    `Covered fork runs: ${input.coveredRunOrdinals.from}-${input.coveredRunOrdinals.to}`,
+    "",
+    "Fork delta:",
+    ...(itemLines.length === 0 ? ["- No user-visible delta items."] : itemLines),
+  ].join("\n");
+}
+
+function makeProviderHandoffSummary(input: {
+  readonly fromProviderInstanceId: ProviderInstanceId;
+  readonly toProviderInstanceId: ProviderInstanceId;
+  readonly coveredRunOrdinals: OrchestrationV2ContextHandoff["coveredRunOrdinals"];
+  readonly strategy: Extract<
+    OrchestrationV2ContextHandoff["strategy"],
+    "delta_since_target_last_seen" | "full_thread_summary"
+  >;
+  readonly items: ReadonlyArray<OrchestrationV2TurnItem>;
+}): string {
+  const itemLines = input.items.flatMap((item) => {
+    if (item.type === "handoff") {
+      return [];
+    }
+    const line = summarizeDeltaItem(item);
+    return line === null ? [] : [line];
+  });
+  return [
+    input.strategy === "full_thread_summary"
+      ? "Full conversation context for provider handoff."
+      : "Conversation delta since this provider last participated.",
+    `From driver: ${input.fromProviderInstanceId}`,
+    `To driver: ${input.toProviderInstanceId}`,
+    `Covered app runs: ${input.coveredRunOrdinals.from}-${input.coveredRunOrdinals.to}`,
+    "",
+    "Canonical conversation context:",
+    ...(itemLines.length === 0 ? ["- No user-visible context items."] : itemLines),
+  ].join("\n");
+}
+
+function makeLegacyImportSummary(items: ReadonlyArray<OrchestrationV2TurnItem>): string {
+  const sections = items.flatMap((item) => {
+    switch (item.type) {
+      case "user_message":
+        return [{ label: "User", body: item.text }];
+      case "assistant_message":
+        return [{ label: "Assistant", body: item.text }];
+      default:
+        return [];
+    }
+  });
+  const header =
+    "Imported conversation history from the previous T3 Code orchestrator. Use it as context; do not repeat it unless the user asks.";
+  const maxChars = 32_000;
+  const selected: Array<string> = [];
+  let remaining = maxChars - header.length - 2;
+  for (const section of sections.toReversed()) {
+    if (remaining <= 0) break;
+    const fullSection = `${section.label}:\n${section.body}`;
+    if (fullSection.length <= remaining) {
+      selected.unshift(fullSection);
+      remaining -= fullSection.length + 2;
+      continue;
+    }
+
+    const prefix = `${section.label}:\n... `;
+    const bodyBudget = remaining - prefix.length;
+    if (bodyBudget <= 0) continue;
+
+    const initialStart = section.body.length - bodyBudget;
+    let bodyStart = Math.max(0, initialStart);
+    if (
+      bodyStart > 0 &&
+      !/\s/.test(section.body[bodyStart - 1] ?? "") &&
+      !/\s/.test(section.body[bodyStart] ?? "")
+    ) {
+      const nextWhitespace = section.body.slice(bodyStart).search(/\s/);
+      if (nextWhitespace !== -1) {
+        bodyStart += nextWhitespace;
+      }
+    }
+    const codeUnitAtStart = section.body.charCodeAt(bodyStart);
+    const codeUnitBeforeStart = section.body.charCodeAt(bodyStart - 1);
+    if (
+      codeUnitAtStart >= 0xdc00 &&
+      codeUnitAtStart <= 0xdfff &&
+      codeUnitBeforeStart >= 0xd800 &&
+      codeUnitBeforeStart <= 0xdbff
+    ) {
+      bodyStart += 1;
+    }
+    const bodySuffix = section.body.slice(bodyStart).trimStart();
+    if (bodySuffix.length === 0) continue;
+
+    const suffix = `${prefix}${bodySuffix}`;
+    selected.unshift(suffix);
+    remaining -= suffix.length + 2;
+  }
+  return [header, ...selected].join("\n\n");
+}
+
+export function providerMessageWithContextHandoff(input: {
+  readonly handoff: OrchestrationV2ContextHandoff;
+  readonly userText: string;
+}): string {
+  return providerMessageWithContextHandoffs({
+    handoffs: [input.handoff],
+    userText: input.userText,
+  });
+}
+
+export function providerMessageWithContextHandoffs(input: {
+  readonly handoffs: ReadonlyArray<OrchestrationV2ContextHandoff>;
+  readonly userText: string;
+}): string {
+  const handoffSections = input.handoffs.flatMap((handoff) => {
+    const label =
+      handoff.strategy === "fork_delta_summary"
+        ? "merge_back / fork_delta_summary"
+        : handoff.strategy;
+    return [`Context handoff (${label}):`, handoff.summaryText, ""];
+  });
+  return [...handoffSections, "User message:", input.userText].join("\n");
+}
+
+const makeContextHandoffService = Effect.fn("orchestrationV2.ContextHandoffService.layer")(
+  function* () {
+    const idAllocator = yield* IdAllocatorV2;
+
+    const prepareLegacyImport = Effect.fn("orchestrationV2.contextHandoff.prepareLegacyImport")(
+      function* (input: {
+        readonly threadId: ThreadId;
+        readonly targetRunId: RunId;
+        readonly toProviderThreadId: ProviderThreadId;
+        readonly toProviderInstanceId: ProviderInstanceId;
+        readonly items: ReadonlyArray<OrchestrationV2TurnItem>;
+        readonly createdAt: DateTime.Utc;
+      }) {
+        const handoffId = yield* idAllocator.allocate
+          .contextHandoff({
+            threadId: input.threadId,
+            fromProviderInstanceId: ProviderInstanceId.make("legacy"),
+            toProviderInstanceId: input.toProviderInstanceId,
+          })
+          .pipe(
+            Effect.mapError(
+              (cause) =>
+                new ContextHandoffPrepareError({
+                  threadId: input.threadId,
+                  targetRunId: input.targetRunId,
+                  fromProviderThreadIds: [],
+                  toProviderThreadId: input.toProviderThreadId,
+                  cause,
+                }),
+            ),
+          );
+        return {
+          id: handoffId,
+          transferId: null,
+          threadId: input.threadId,
+          targetRunId: input.targetRunId,
+          fromProviderThreadIds: [],
+          toProviderThreadId: input.toProviderThreadId,
+          coveredRunOrdinals: { from: 1, to: 1 },
+          strategy: "manual_context",
+          status: "ready",
+          summaryMessageId: null,
+          summaryText: makeLegacyImportSummary(input.items),
+          createdByProviderInstanceId: null,
+          createdAt: input.createdAt,
+          updatedAt: input.createdAt,
+        } satisfies OrchestrationV2ContextHandoff;
+      },
+    );
+
+    const prepare = Effect.fn("orchestrationV2.contextHandoff.prepare")(function* (input: {
+      readonly threadId: ThreadId;
+      readonly targetRunId: RunId;
+      readonly fromProviderThreadIds: ReadonlyArray<ProviderThreadId>;
+      readonly toProviderThreadId: ProviderThreadId;
+    }) {
+      const now = yield* DateTime.now;
+      const handoffId = yield* idAllocator.allocate
+        .contextHandoff({
+          threadId: input.threadId,
+          fromProviderInstanceId: ProviderInstanceId.make("manual"),
+          toProviderInstanceId: ProviderInstanceId.make("manual"),
+        })
+        .pipe(
+          Effect.mapError(
+            (cause) =>
+              new ContextHandoffPrepareError({
+                threadId: input.threadId,
+                targetRunId: input.targetRunId,
+                fromProviderThreadIds: Array.from(input.fromProviderThreadIds),
+                toProviderThreadId: input.toProviderThreadId,
+                cause,
+              }),
+          ),
+        );
+      return {
+        id: handoffId,
+        transferId: null,
+        threadId: input.threadId,
+        targetRunId: input.targetRunId,
+        fromProviderThreadIds: Array.from(input.fromProviderThreadIds),
+        toProviderThreadId: input.toProviderThreadId,
+        coveredRunOrdinals: { from: 1, to: 1 },
+        strategy: "manual_context",
+        status: "ready",
+        summaryMessageId: null,
+        summaryText: "Manual context handoff.",
+        createdByProviderInstanceId: null,
+        createdAt: now,
+        updatedAt: now,
+      } satisfies OrchestrationV2ContextHandoff;
+    });
+
+    const prepareForkDelta = Effect.fn("orchestrationV2.contextHandoff.prepareForkDelta")(
+      function* (input: {
+        readonly sourceThreadId: ThreadId;
+        readonly targetThreadId: ThreadId;
+        readonly targetRunId: RunId;
+        readonly transferId: OrchestrationV2ContextHandoff["transferId"];
+        readonly fromProviderThreadIds: ReadonlyArray<ProviderThreadId>;
+        readonly toProviderThreadId: ProviderThreadId;
+        readonly fromProviderInstanceId: ProviderInstanceId;
+        readonly toProviderInstanceId: ProviderInstanceId;
+        readonly coveredRunOrdinals: OrchestrationV2ContextHandoff["coveredRunOrdinals"];
+        readonly deltaItems: ReadonlyArray<OrchestrationV2TurnItem>;
+        readonly createdAt: DateTime.Utc;
+      }) {
+        const handoffId = yield* idAllocator.allocate
+          .contextHandoff({
+            threadId: input.targetThreadId,
+            fromProviderInstanceId: input.fromProviderInstanceId,
+            toProviderInstanceId: input.toProviderInstanceId,
+          })
+          .pipe(
+            Effect.mapError(
+              (cause) =>
+                new ContextHandoffPrepareError({
+                  threadId: input.targetThreadId,
+                  targetRunId: input.targetRunId,
+                  fromProviderThreadIds: Array.from(input.fromProviderThreadIds),
+                  toProviderThreadId: input.toProviderThreadId,
+                  cause,
+                }),
+            ),
+          );
+        return {
+          id: handoffId,
+          transferId: input.transferId,
+          threadId: input.targetThreadId,
+          targetRunId: input.targetRunId,
+          fromProviderThreadIds: Array.from(input.fromProviderThreadIds),
+          toProviderThreadId: input.toProviderThreadId,
+          coveredRunOrdinals: input.coveredRunOrdinals,
+          strategy: "fork_delta_summary",
+          status: "ready",
+          summaryMessageId: null,
+          summaryText: makeForkDeltaSummary(input),
+          createdByProviderInstanceId: null,
+          createdAt: input.createdAt,
+          updatedAt: input.createdAt,
+        } satisfies OrchestrationV2ContextHandoff;
+      },
+    );
+
+    const prepareProviderHandoff = Effect.fn(
+      "orchestrationV2.contextHandoff.prepareProviderHandoff",
+    )(function* (input: {
+      readonly threadId: ThreadId;
+      readonly targetRunId: RunId;
+      readonly transferId: NonNullable<OrchestrationV2ContextHandoff["transferId"]>;
+      readonly fromProviderThreadIds: ReadonlyArray<ProviderThreadId>;
+      readonly toProviderThreadId: ProviderThreadId;
+      readonly fromProviderInstanceId: ProviderInstanceId;
+      readonly toProviderInstanceId: ProviderInstanceId;
+      readonly coveredRunOrdinals: OrchestrationV2ContextHandoff["coveredRunOrdinals"];
+      readonly strategy: Extract<
+        OrchestrationV2ContextHandoff["strategy"],
+        "delta_since_target_last_seen" | "full_thread_summary"
+      >;
+      readonly items: ReadonlyArray<OrchestrationV2TurnItem>;
+      readonly createdAt: DateTime.Utc;
+    }) {
+      const handoffId = yield* idAllocator.allocate
+        .contextHandoff({
+          threadId: input.threadId,
+          fromProviderInstanceId: input.fromProviderInstanceId,
+          toProviderInstanceId: input.toProviderInstanceId,
+        })
+        .pipe(
+          Effect.mapError(
+            (cause) =>
+              new ContextHandoffPrepareError({
+                threadId: input.threadId,
+                targetRunId: input.targetRunId,
+                fromProviderThreadIds: Array.from(input.fromProviderThreadIds),
+                toProviderThreadId: input.toProviderThreadId,
+                cause,
+              }),
+          ),
+        );
+      return {
+        id: handoffId,
+        transferId: input.transferId,
+        threadId: input.threadId,
+        targetRunId: input.targetRunId,
+        fromProviderThreadIds: Array.from(input.fromProviderThreadIds),
+        toProviderThreadId: input.toProviderThreadId,
+        coveredRunOrdinals: input.coveredRunOrdinals,
+        strategy: input.strategy,
+        status: "ready",
+        summaryMessageId: null,
+        summaryText: makeProviderHandoffSummary(input),
+        createdByProviderInstanceId: null,
+        createdAt: input.createdAt,
+        updatedAt: input.createdAt,
+      } satisfies OrchestrationV2ContextHandoff;
+    });
+
+    return ContextHandoffServiceV2.of({
+      prepareLegacyImport,
+      prepare,
+      prepareForkDelta,
+      prepareProviderHandoff,
+    });
+  },
+);
+
+export const layer: Layer.Layer<ContextHandoffServiceV2, never, IdAllocatorV2> = Layer.effect(
+  ContextHandoffServiceV2,
+  makeContextHandoffService(),
+);
diff --git a/apps/server/src/orchestration-v2/CursorOrchestratorV2.live.test.ts b/apps/server/src/orchestration-v2/CursorOrchestratorV2.live.test.ts
new file mode 100644
index 000000000000..611f813faf0e
--- /dev/null
+++ b/apps/server/src/orchestration-v2/CursorOrchestratorV2.live.test.ts
@@ -0,0 +1,279 @@
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import { assert, it } from "@effect/vitest";
+import {
+  CommandId,
+  MessageId,
+  ProjectId,
+  ThreadId,
+  type OrchestrationV2ThreadProjection,
+} from "@t3tools/contracts";
+import * as Console from "effect/Console";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { FetchHttpClient } from "effect/unstable/http";
+import { describe } from "vite-plus/test";
+
+import * as CheckpointStore from "../checkpointing/CheckpointStore.ts";
+import * as BackgroundPolicy from "../background/BackgroundPolicy.ts";
+import * as HostPowerMonitor from "../background/HostPowerMonitor.ts";
+import { ServerConfig } from "../config.ts";
+import { SqlitePersistenceMemory } from "../persistence/Layers/Sqlite.ts";
+import * as ModelManifest from "../provider/ModelManifest.ts";
+import { ProviderInstanceRegistryHydrationLive } from "../provider/Layers/ProviderInstanceRegistryHydration.ts";
+import {
+  NoOpProviderEventLoggers,
+  ProviderEventLoggers,
+} from "../provider/Layers/ProviderEventLoggers.ts";
+import { OpenCodeRuntimeLive } from "../provider/opencodeRuntime.ts";
+import { ServerSettingsService } from "../serverSettings.ts";
+import * as VcsDriverRegistry from "../vcs/VcsDriverRegistry.ts";
+import * as VcsProcess from "../vcs/VcsProcess.ts";
+import { OrchestratorV2 } from "./Orchestrator.ts";
+import { worktreeRepairDependenciesTestLayer } from "./ProviderTurnStartService.testkit.ts";
+import { runDaemonWithOptions as runEffectWorkerDaemonWithOptions } from "./EffectWorker.ts";
+import { OrchestrationV2LayerLive } from "./runtimeLayer.ts";
+import { layer as mcpSessionRegistryTestLayer } from "../mcp/McpSessionRegistry.testkit.ts";
+import { CURSOR_MODEL_SELECTION, SUBAGENT_PROMPT } from "./testkit/fixtures/shared.ts";
+
+const serverConfigLayer = ServerConfig.layerTest(process.cwd(), {
+  prefix: "t3-cursor-v2-live-",
+});
+
+const vcsDriverRegistryLayer = VcsDriverRegistry.layer.pipe(
+  Layer.provide(VcsProcess.layer),
+  Layer.provide(serverConfigLayer),
+  Layer.provide(NodeServices.layer),
+);
+
+const checkpointStoreLayer = CheckpointStore.layer.pipe(Layer.provide(vcsDriverRegistryLayer));
+
+const serverSettingsLayer = ServerSettingsService.layerTest({
+  providers: {
+    cursor: { enabled: true },
+  },
+});
+const backgroundPolicyLayer = BackgroundPolicy.layer.pipe(
+  Layer.provide(Layer.effect(HostPowerMonitor.HostPowerMonitor, HostPowerMonitor.make())),
+  Layer.provide(serverSettingsLayer),
+);
+const providerInstanceRegistryLayer = ProviderInstanceRegistryHydrationLive.pipe(
+  Layer.provide(
+    Layer.mergeAll(
+      serverConfigLayer.pipe(Layer.provide(NodeServices.layer)),
+      serverSettingsLayer,
+      NodeServices.layer,
+      FetchHttpClient.layer,
+      OpenCodeRuntimeLive.pipe(Layer.provide(NodeServices.layer)),
+      Layer.succeed(ProviderEventLoggers, NoOpProviderEventLoggers),
+      ModelManifest.layerTest,
+    ),
+  ),
+);
+
+const liveLayer = OrchestrationV2LayerLive.pipe(
+  Layer.provide(worktreeRepairDependenciesTestLayer),
+  Layer.provide(mcpSessionRegistryTestLayer),
+  Layer.provide(SqlitePersistenceMemory),
+  Layer.provide(checkpointStoreLayer),
+  Layer.provide(serverConfigLayer),
+  Layer.provide(serverSettingsLayer),
+  Layer.provide(providerInstanceRegistryLayer),
+  Layer.provide(backgroundPolicyLayer),
+  Layer.provide(NodeServices.layer),
+);
+
+const waitForIdle = Effect.fn("CursorOrchestratorV2Live.waitForIdle")(function* (
+  threadId: ThreadId,
+) {
+  const orchestrator = yield* OrchestratorV2;
+  for (let attempt = 0; attempt < 600; attempt += 1) {
+    const projection = yield* orchestrator.getThreadProjection(threadId);
+    if (
+      projection.runs.length > 0 &&
+      projection.runs.every(
+        (run) => !["queued", "starting", "running", "waiting"].includes(run.status),
+      )
+    ) {
+      return projection;
+    }
+    yield* Effect.sleep("500 millis");
+  }
+  return yield* Effect.die(new Error(`Timed out waiting for Cursor thread ${threadId}.`));
+});
+
+describe.runIf(process.env.T3_CURSOR_LIVE_ORCHESTRATOR === "1")(
+  "Cursor V2 live orchestrator",
+  () => {
+    it.live(
+      "forks through portable context using real Cursor agents",
+      () =>
+        Effect.gen(function* () {
+          yield* runEffectWorkerDaemonWithOptions({ concurrency: 2 }).pipe(Effect.forkScoped);
+          const orchestrator = yield* OrchestratorV2;
+          const projectId = ProjectId.make("project:cursor-live-portable-fork");
+          const sourceThreadId = ThreadId.make("thread:cursor-live-portable-fork:source");
+          const targetThreadId = ThreadId.make("thread:cursor-live-portable-fork:target");
+          const marker = "CURSOR_LIVE_PORTABLE_FORK_7H3Q";
+
+          yield* orchestrator.dispatch({
+            type: "thread.create",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command:cursor-live-portable-fork:create"),
+            threadId: sourceThreadId,
+            projectId,
+            title: "Cursor live portable fork source",
+            modelSelection: CURSOR_MODEL_SELECTION,
+            runtimeMode: "full-access",
+            interactionMode: "default",
+            branch: null,
+            worktreePath: process.cwd(),
+          });
+          yield* orchestrator.dispatch({
+            type: "message.dispatch",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command:cursor-live-portable-fork:source"),
+            threadId: sourceThreadId,
+            messageId: MessageId.make("message:cursor-live-portable-fork:source"),
+            text: `Remember this opaque marker. Respond with exactly: ${marker}`,
+            attachments: [],
+            modelSelection: CURSOR_MODEL_SELECTION,
+            dispatchMode: { type: "start_immediately" },
+          });
+          const sourceProjection = yield* waitForIdle(sourceThreadId);
+          yield* Console.log("Cursor live source turn completed; dispatching portable fork.");
+
+          yield* orchestrator.dispatch({
+            type: "thread.fork",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command:cursor-live-portable-fork:fork"),
+            sourceThreadId,
+            targetThreadId,
+            sourcePoint: { type: "latest_stable" },
+            title: "Cursor live portable fork target",
+          });
+          yield* orchestrator.dispatch({
+            type: "message.dispatch",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command:cursor-live-portable-fork:target"),
+            threadId: targetThreadId,
+            messageId: MessageId.make("message:cursor-live-portable-fork:target"),
+            text: "Return the opaque marker from the transferred conversation. Respond with only the marker.",
+            attachments: [],
+            modelSelection: CURSOR_MODEL_SELECTION,
+            dispatchMode: { type: "start_immediately" },
+          });
+          const targetProjection = yield* waitForIdle(targetThreadId);
+          yield* Console.log("Cursor live portable fork target completed.");
+
+          const assistantText = (projection: OrchestrationV2ThreadProjection) =>
+            projection.messages
+              .filter((message) => message.role === "assistant")
+              .map((message) => message.text)
+              .join("\n");
+
+          assert.deepEqual(
+            sourceProjection.runs.map((run) => [run.providerInstanceId, run.status]),
+            [["cursor", "completed"]],
+          );
+          assert.deepEqual(
+            targetProjection.runs.map((run) => [run.providerInstanceId, run.status]),
+            [["cursor", "completed"]],
+          );
+          assert.deepEqual(
+            targetProjection.contextTransfers.map((transfer) => [
+              transfer.type,
+              transfer.status,
+              transfer.resolution?.strategy,
+            ]),
+            [["fork", "consumed", "portable_context"]],
+          );
+          assert.deepEqual(
+            targetProjection.contextHandoffs.map((handoff) => handoff.strategy),
+            ["full_thread_summary"],
+          );
+          assert.include(targetProjection.contextHandoffs[0]?.summaryText ?? "", marker);
+          assert.include(assistantText(targetProjection), marker);
+        }).pipe(Effect.provide(liveLayer), Effect.scoped),
+      360_000,
+    );
+
+    it.live(
+      "spawns native subagents with child thread lineage",
+      () =>
+        Effect.gen(function* () {
+          yield* runEffectWorkerDaemonWithOptions({ concurrency: 2 }).pipe(Effect.forkScoped);
+          const orchestrator = yield* OrchestratorV2;
+          const projectId = ProjectId.make("project:cursor-live-subagent-lineage");
+          const sourceThreadId = ThreadId.make("thread:cursor-live-subagent-lineage");
+
+          yield* orchestrator.dispatch({
+            type: "thread.create",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command:cursor-live-subagent-lineage:create"),
+            threadId: sourceThreadId,
+            projectId,
+            title: "Cursor live subagent lineage",
+            modelSelection: CURSOR_MODEL_SELECTION,
+            runtimeMode: "full-access",
+            interactionMode: "default",
+            branch: null,
+            worktreePath: process.cwd(),
+          });
+          yield* orchestrator.dispatch({
+            type: "message.dispatch",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command:cursor-live-subagent-lineage:message"),
+            threadId: sourceThreadId,
+            messageId: MessageId.make("message:cursor-live-subagent-lineage"),
+            text: `${SUBAGENT_PROMPT}. Do not edit files. After both subagents finish, summarize each result briefly.`,
+            attachments: [],
+            modelSelection: CURSOR_MODEL_SELECTION,
+            dispatchMode: { type: "start_immediately" },
+          });
+
+          const parentProjection = yield* waitForIdle(sourceThreadId);
+          yield* Console.log(
+            `Cursor live subagent lineage completed with ${parentProjection.subagents.length} subagents.`,
+          );
+
+          assert.deepEqual(
+            parentProjection.runs.map((run) => [run.providerInstanceId, run.status]),
+            [["cursor", "completed"]],
+          );
+          assert.isAtLeast(parentProjection.subagents.length, 1);
+
+          for (const subagent of parentProjection.subagents) {
+            assert.equal(subagent.origin, "provider_native");
+            assert.equal(subagent.driver, "cursor");
+            assert.equal(subagent.status, "completed");
+            assert.isNotNull(subagent.childThreadId);
+            assert.isNotNull(subagent.result);
+
+            if (subagent.childThreadId === null) {
+              throw new Error(`Cursor live subagent ${subagent.id} is missing a child thread.`);
+            }
+
+            const childProjection = yield* orchestrator.getThreadProjection(subagent.childThreadId);
+            assert.equal(childProjection.thread.lineage.parentThreadId, parentProjection.thread.id);
+            assert.equal(childProjection.thread.lineage.relationshipToParent, "subagent");
+            assert.equal(
+              childProjection.thread.lineage.rootThreadId,
+              parentProjection.thread.lineage.rootThreadId,
+            );
+            assert.lengthOf(childProjection.runs, 0);
+            assert.isTrue(
+              childProjection.messages.some((message) => message.role === "assistant"),
+              `child thread ${subagent.childThreadId} should contain the subagent response`,
+            );
+          }
+        }).pipe(Effect.provide(liveLayer), Effect.scoped),
+      360_000,
+    );
+  },
+);
diff --git a/apps/server/src/orchestration-v2/DelegatedCompletionDelivery.test.ts b/apps/server/src/orchestration-v2/DelegatedCompletionDelivery.test.ts
new file mode 100644
index 000000000000..33f802310cd0
--- /dev/null
+++ b/apps/server/src/orchestration-v2/DelegatedCompletionDelivery.test.ts
@@ -0,0 +1,549 @@
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import { assert, it } from "@effect/vitest";
+import {
+  CommandId,
+  EventId,
+  MessageId,
+  type ModelSelection,
+  NodeId,
+  ProjectId,
+  ProviderDriverKind,
+  ProviderInstanceId,
+  ProviderThreadId,
+  RunId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Stream from "effect/Stream";
+
+import * as CheckpointStore from "../checkpointing/CheckpointStore.ts";
+import { ServerConfig } from "../config.ts";
+import { layer as mcpSessionRegistryTestLayer } from "../mcp/McpSessionRegistry.testkit.ts";
+import { OrchestrationEngineService } from "../orchestration/Services/OrchestrationEngine.ts";
+import { OrchestrationLayerLive } from "../orchestration/runtimeLayer.ts";
+import { SqlitePersistenceMemory } from "../persistence/Layers/Sqlite.ts";
+import { ProjectEnrichmentService } from "../project/ProjectEnrichmentService.ts";
+import type { ProviderInstance } from "../provider/ProviderDriver.ts";
+import { ProviderInstanceRegistry } from "../provider/Services/ProviderInstanceRegistry.ts";
+import { ServerSettingsService } from "../serverSettings.ts";
+import * as VcsDriverRegistry from "../vcs/VcsDriverRegistry.ts";
+import * as VcsProcess from "../vcs/VcsProcess.ts";
+import { CodexProviderCapabilitiesV2 } from "./Adapters/CodexAdapterV2.ts";
+import { EventSinkV2 } from "./EventSink.ts";
+import { OrchestratorV2 } from "./Orchestrator.ts";
+import type { ProviderAdapterV2Shape } from "./ProviderAdapter.ts";
+import { OrchestrationV2EventSinkLayerLive, OrchestrationV2LayerLive } from "./runtimeLayer.ts";
+import { worktreeRepairDependenciesTestLayer } from "./ProviderTurnStartService.testkit.ts";
+
+const ServerConfigLayer = ServerConfig.layerTest(process.cwd(), {
+  prefix: "t3-orchestration-v2-delegated-completion-",
+});
+
+const modelSelection = {
+  instanceId: ProviderInstanceId.make("codex"),
+  model: "gpt-5.4",
+} satisfies ModelSelection;
+
+const VcsDriverRegistryTestLayer = VcsDriverRegistry.layer.pipe(
+  Layer.provide(VcsProcess.layer),
+  Layer.provide(ServerConfigLayer),
+  Layer.provide(NodeServices.layer),
+);
+
+const CheckpointStoreTestLayer = CheckpointStore.layer.pipe(
+  Layer.provide(VcsDriverRegistryTestLayer),
+);
+
+const driver = ProviderDriverKind.make("codex");
+const orchestrationAdapter = {
+  instanceId: modelSelection.instanceId,
+  driver,
+  getCapabilities: () => Effect.succeed(CodexProviderCapabilitiesV2),
+  planSelectionTransition: () => Effect.succeed({ type: "apply_on_next_turn" }),
+  openSession: () => Effect.die("sessions are not used by delegated completion tests"),
+} as ProviderAdapterV2Shape;
+const providerInstance = {
+  instanceId: modelSelection.instanceId,
+  driverKind: driver,
+  continuationIdentity: {
+    driverKind: driver,
+    continuationKey: "codex:test",
+  },
+  displayName: "Codex test",
+  enabled: true,
+  snapshot: {} as ProviderInstance["snapshot"],
+  orchestrationAdapter,
+  textGeneration: {} as ProviderInstance["textGeneration"],
+} satisfies ProviderInstance;
+
+const TestProviderInstanceRegistry = Layer.succeed(ProviderInstanceRegistry, {
+  getInstance: (instanceId) =>
+    Effect.succeed(instanceId === providerInstance.instanceId ? providerInstance : undefined),
+  listInstances: Effect.succeed([providerInstance]),
+  listUnavailable: Effect.succeed([]),
+  streamChanges: Stream.empty,
+  subscribeChanges: Effect.never,
+});
+
+const TestLayer = Layer.mergeAll(
+  OrchestrationLayerLive,
+  OrchestrationV2LayerLive,
+  OrchestrationV2EventSinkLayerLive,
+).pipe(
+  Layer.provide(worktreeRepairDependenciesTestLayer),
+  Layer.provide(
+    Layer.succeed(ProjectEnrichmentService, {
+      peek: () =>
+        Effect.succeed({
+          repositoryIdentity: null,
+          faviconPath: null,
+          repositoryIdentityResolved: false,
+        }),
+      request: () => Effect.void,
+      getAvailable: () =>
+        Effect.succeed({
+          repositoryIdentity: null,
+          faviconPath: null,
+          repositoryIdentityResolved: false,
+        }),
+      invalidate: () => Effect.void,
+      subscribeChanges: Effect.never,
+    }),
+  ),
+  Layer.provide(mcpSessionRegistryTestLayer),
+  Layer.provide(SqlitePersistenceMemory),
+  Layer.provide(CheckpointStoreTestLayer),
+  Layer.provide(ServerConfigLayer),
+  Layer.provide(ServerSettingsService.layerTest()),
+  Layer.provide(TestProviderInstanceRegistry),
+  Layer.provide(NodeServices.layer),
+);
+
+const seedParentWithTerminalTask = (input: {
+  readonly threadId: ThreadId;
+  readonly projectId: ProjectId;
+  readonly runId: RunId;
+  readonly rootNodeId: NodeId;
+  readonly taskId: NodeId;
+  readonly deliveryState: "delivered" | "claimed" | "acknowledged" | "disposed";
+  readonly completionWake?: "always" | "settled_only";
+  readonly deliveryTaskIds?: ReadonlyArray<NodeId>;
+  readonly now: DateTime.Utc;
+}) =>
+  Effect.gen(function* () {
+    const applicationEngine = yield* OrchestrationEngineService;
+    const orchestrator = yield* OrchestratorV2;
+    const eventSink = yield* EventSinkV2;
+    const providerThreadId = ProviderThreadId.make(
+      `provider-thread:${String(input.threadId).replace("thread:", "")}`,
+    );
+
+    yield* applicationEngine.dispatch({
+      type: "project.create",
+      commandId: CommandId.make(`command:seed-project:${input.threadId}`),
+      projectId: input.projectId,
+      title: "Delegated completion delivery",
+      workspaceRoot: `/workspace/${input.projectId}`,
+      defaultModelSelection: modelSelection,
+      scripts: [],
+      createdAt: DateTime.formatIso(input.now),
+    });
+
+    yield* orchestrator.dispatch({
+      type: "thread.create",
+      createdBy: "user",
+      creationSource: "web",
+      commandId: CommandId.make(`command:seed-create:${input.threadId}`),
+      threadId: input.threadId,
+      projectId: input.projectId,
+      title: "Delegated completion delivery",
+      modelSelection,
+      runtimeMode: "full-access",
+      interactionMode: "default",
+      branch: null,
+      worktreePath: null,
+    });
+
+    yield* eventSink.write({
+      commandId: CommandId.make(`command:seed-projection:${input.threadId}`),
+      events: [
+        {
+          id: EventId.make(`event:seed-provider-thread:${input.threadId}`),
+          type: "provider-thread.updated",
+          threadId: input.threadId,
+          driver,
+          providerInstanceId: modelSelection.instanceId,
+          occurredAt: input.now,
+          payload: {
+            id: providerThreadId,
+            driver,
+            providerInstanceId: modelSelection.instanceId,
+            providerSessionId: null,
+            appThreadId: input.threadId,
+            ownerNodeId: input.rootNodeId,
+            nativeThreadRef: {
+              driver,
+              nativeId: `native:${input.threadId}`,
+              strength: "strong",
+            },
+            nativeConversationHeadRef: null,
+            status: "active",
+            firstRunOrdinal: 1,
+            lastRunOrdinal: 1,
+            handoffIds: [],
+            forkedFrom: null,
+            createdAt: input.now,
+            updatedAt: input.now,
+          },
+        },
+        {
+          id: EventId.make(`event:seed-run:${input.threadId}`),
+          type: "run.updated",
+          threadId: input.threadId,
+          runId: input.runId,
+          nodeId: input.rootNodeId,
+          providerInstanceId: modelSelection.instanceId,
+          occurredAt: input.now,
+          payload: {
+            id: input.runId,
+            threadId: input.threadId,
+            ordinal: 1,
+            providerInstanceId: modelSelection.instanceId,
+            modelSelection,
+            providerThreadId,
+            userMessageId: MessageId.make(`message:seed-user:${input.threadId}`),
+            rootNodeId: input.rootNodeId,
+            activeAttemptId: null,
+            status: "running",
+            requestedAt: input.now,
+            startedAt: input.now,
+            completedAt: null,
+            checkpointId: null,
+            contextHandoffId: null,
+            delegatedCompletion: {
+              disposition: "open",
+              nextGeneration: 2,
+              settledDeliveryCount: 1,
+              delivery:
+                input.deliveryTaskIds === undefined
+                  ? null
+                  : {
+                      generation: 1,
+                      messageId: MessageId.make(`message:delegated-delivery:${input.threadId}`),
+                      taskIds: input.deliveryTaskIds,
+                    },
+            },
+          },
+        },
+        {
+          id: EventId.make(`event:seed-task:${input.threadId}`),
+          type: "subagent.updated",
+          threadId: input.threadId,
+          runId: input.runId,
+          nodeId: input.taskId,
+          driver,
+          providerInstanceId: modelSelection.instanceId,
+          occurredAt: input.now,
+          payload: {
+            id: input.taskId,
+            threadId: input.threadId,
+            runId: input.runId,
+            parentNodeId: input.rootNodeId,
+            origin: "app_owned",
+            createdBy: "agent",
+            driver,
+            providerInstanceId: modelSelection.instanceId,
+            providerThreadId: null,
+            childThreadId: null,
+            nativeTaskRef: null,
+            prompt: "Inspect the delivered ownership edge.",
+            title: null,
+            model: null,
+            completionWake: input.completionWake ?? "settled_only",
+            completionDelivery: {
+              state: input.deliveryState,
+              observedByRunId: input.deliveryState === "acknowledged" ? input.runId : null,
+            },
+            status: "completed",
+            result: "child finished",
+            startedAt: input.now,
+            completedAt: input.now,
+            updatedAt: input.now,
+          },
+        },
+      ],
+    });
+  });
+
+it.layer(TestLayer)("delegated completion delivery repairs", (it) => {
+  it.effect("builds completion text and metadata from the same live cohort", () =>
+    Effect.gen(function* () {
+      const orchestrator = yield* OrchestratorV2;
+      const now = yield* DateTime.now;
+      const threadId = ThreadId.make("thread:delegated-delivery-live-cohort");
+      const projectId = ProjectId.make("project:delegated-delivery-live-cohort");
+      const runId = RunId.make("run:delegated-delivery-live-cohort");
+      const rootNodeId = NodeId.make("node:delegated-delivery-live-cohort-root");
+      const firstTaskId = NodeId.make("node:delegated-delivery-live-cohort-first");
+      const secondTaskId = NodeId.make("node:delegated-delivery-live-cohort-second");
+      const messageId = MessageId.make(`message:delegated-delivery:${threadId}`);
+
+      yield* seedParentWithTerminalTask({
+        threadId,
+        projectId,
+        runId,
+        rootNodeId,
+        taskId: firstTaskId,
+        deliveryState: "claimed",
+        completionWake: "always",
+        deliveryTaskIds: [firstTaskId, secondTaskId],
+        now,
+      });
+
+      yield* orchestrator.dispatch({
+        type: "message.dispatch",
+        commandId: CommandId.make("command:delegated-delivery-live-cohort"),
+        threadId,
+        messageId,
+        text: `Delegated task ${firstTaskId} reached a terminal state.`,
+        attachments: [],
+        dispatchMode: { type: "queue_after_active" },
+        createdBy: "agent",
+        creationSource: "server",
+        delegatedCompletion: {
+          parentRunId: runId,
+          generation: 1,
+          taskIds: [firstTaskId],
+        },
+      });
+
+      const projection = yield* orchestrator.getThreadProjection(threadId);
+      const message = projection.messages.find((candidate) => candidate.id === messageId);
+      assert.deepEqual(message?.delegatedCompletion?.taskIds, [firstTaskId, secondTaskId]);
+      assert.include(message?.text ?? "", String(firstTaskId));
+      assert.include(message?.text ?? "", String(secondTaskId));
+      assert.include(message?.text ?? "", "task_status");
+    }),
+  );
+
+  it.effect("does not re-offer when wake-policy upgrades after delivered ownership settled", () =>
+    Effect.gen(function* () {
+      const orchestrator = yield* OrchestratorV2;
+      const now = yield* DateTime.now;
+      const threadId = ThreadId.make("thread:delegated-delivery-a1");
+      const projectId = ProjectId.make("project:delegated-delivery-a1");
+      const runId = RunId.make("run:delegated-delivery-a1");
+      const rootNodeId = NodeId.make("node:delegated-delivery-a1-root");
+      const taskId = NodeId.make("node:delegated-delivery-a1-task");
+
+      yield* seedParentWithTerminalTask({
+        threadId,
+        projectId,
+        runId,
+        rootNodeId,
+        taskId,
+        deliveryState: "delivered",
+        completionWake: "settled_only",
+        now,
+      });
+
+      const upgrade = yield* orchestrator.dispatch({
+        type: "delegated_task.wake-policy",
+        commandId: CommandId.make("command:delegated-delivery-a1:wake-policy"),
+        parentThreadId: threadId,
+        taskId,
+        completionWake: "always",
+      });
+
+      const projection = yield* orchestrator.getThreadProjection(threadId);
+      const task = projection.subagents.find((candidate) => candidate.id === taskId);
+      const parentRun = projection.runs.find((candidate) => candidate.id === runId);
+
+      assert.equal(task?.completionWake, "always");
+      assert.deepEqual(task?.completionDelivery, {
+        state: "delivered",
+        observedByRunId: null,
+      });
+      assert.deepEqual(parentRun?.delegatedCompletion, {
+        disposition: "open",
+        nextGeneration: 2,
+        settledDeliveryCount: 1,
+        delivery: null,
+      });
+      assert.isFalse(
+        upgrade.storedEvents.some(
+          (stored) =>
+            stored.event.type === "subagent.updated" &&
+            stored.event.payload.id === taskId &&
+            stored.event.payload.completionDelivery?.state === "claimed",
+        ),
+      );
+      assert.isFalse(
+        upgrade.storedEvents.some(
+          (stored) =>
+            stored.event.type === "run.updated" &&
+            stored.event.payload.id === runId &&
+            stored.event.payload.delegatedCompletion?.delivery !== null &&
+            stored.event.payload.delegatedCompletion?.delivery !== undefined,
+        ),
+      );
+    }),
+  );
+
+  it.effect(
+    "treats repeated acknowledge and dispose with distinct command IDs as successful no-ops",
+    () =>
+      Effect.gen(function* () {
+        const orchestrator = yield* OrchestratorV2;
+        const now = yield* DateTime.now;
+        const threadId = ThreadId.make("thread:delegated-delivery-a2");
+        const projectId = ProjectId.make("project:delegated-delivery-a2");
+        const runId = RunId.make("run:delegated-delivery-a2");
+        const rootNodeId = NodeId.make("node:delegated-delivery-a2-root");
+        const taskId = NodeId.make("node:delegated-delivery-a2-task");
+
+        yield* seedParentWithTerminalTask({
+          threadId,
+          projectId,
+          runId,
+          rootNodeId,
+          taskId,
+          deliveryState: "delivered",
+          completionWake: "always",
+          now,
+        });
+
+        // Distinct command IDs mirror task_status vs t3_thread_read racing after
+        // their shared read preflight saw delivered ownership.
+        const firstAck = yield* orchestrator.dispatch({
+          type: "delegated_task.completion-delivery.acknowledge",
+          commandId: CommandId.make("command:delegated-delivery-a2:ack-task-status"),
+          parentThreadId: threadId,
+          taskId,
+          observedByRunId: runId,
+        });
+        const secondAck = yield* orchestrator.dispatch({
+          type: "delegated_task.completion-delivery.acknowledge",
+          commandId: CommandId.make("command:delegated-delivery-a2:ack-thread-read"),
+          parentThreadId: threadId,
+          taskId,
+          observedByRunId: runId,
+        });
+
+        const firstAckTask = firstAck.storedEvents.find(
+          (stored) =>
+            stored.event.type === "subagent.updated" && stored.event.payload.id === taskId,
+        );
+        const secondAckTask = secondAck.storedEvents.find(
+          (stored) =>
+            stored.event.type === "subagent.updated" && stored.event.payload.id === taskId,
+        );
+        assert.isDefined(firstAckTask);
+        assert.isDefined(secondAckTask);
+        if (
+          firstAckTask?.event.type !== "subagent.updated" ||
+          secondAckTask?.event.type !== "subagent.updated"
+        ) {
+          return yield* Effect.die(new Error("Acknowledge events missing."));
+        }
+        assert.equal(firstAckTask.event.payload.completionDelivery?.state, "acknowledged");
+        assert.equal(secondAckTask.event.payload.completionDelivery?.state, "acknowledged");
+        // Idempotent replay keeps the first observation's ownership and timestamp.
+        assert.deepEqual(
+          secondAckTask.event.payload.completionDelivery,
+          firstAckTask.event.payload.completionDelivery,
+        );
+        assert.deepEqual(
+          secondAckTask.event.payload.updatedAt,
+          firstAckTask.event.payload.updatedAt,
+        );
+        assert.equal(secondAck.storedEvents.length, 1);
+
+        const afterAck = yield* orchestrator.getThreadProjection(threadId);
+        assert.deepEqual(
+          afterAck.subagents.find((candidate) => candidate.id === taskId)?.completionDelivery,
+          {
+            state: "acknowledged",
+            observedByRunId: runId,
+          },
+        );
+
+        const firstDispose = yield* orchestrator.dispatch({
+          type: "delegated_task.completion-delivery.dispose",
+          commandId: CommandId.make("command:delegated-delivery-a2:dispose-task-status"),
+          parentThreadId: threadId,
+          taskId,
+        });
+        const secondDispose = yield* orchestrator.dispatch({
+          type: "delegated_task.completion-delivery.dispose",
+          commandId: CommandId.make("command:delegated-delivery-a2:dispose-thread-read"),
+          parentThreadId: threadId,
+          taskId,
+        });
+
+        const firstDisposeTask = firstDispose.storedEvents.find(
+          (stored) =>
+            stored.event.type === "subagent.updated" && stored.event.payload.id === taskId,
+        );
+        const secondDisposeTask = secondDispose.storedEvents.find(
+          (stored) =>
+            stored.event.type === "subagent.updated" && stored.event.payload.id === taskId,
+        );
+        assert.isDefined(firstDisposeTask);
+        assert.isDefined(secondDisposeTask);
+        if (
+          firstDisposeTask?.event.type !== "subagent.updated" ||
+          secondDisposeTask?.event.type !== "subagent.updated"
+        ) {
+          return yield* Effect.die(new Error("Dispose events missing."));
+        }
+        assert.equal(firstDisposeTask.event.payload.completionDelivery?.state, "disposed");
+        assert.equal(secondDisposeTask.event.payload.completionDelivery?.state, "disposed");
+        assert.deepEqual(
+          secondDisposeTask.event.payload.completionDelivery,
+          firstDisposeTask.event.payload.completionDelivery,
+        );
+        assert.equal(secondDispose.storedEvents.length, 1);
+
+        const afterDispose = yield* orchestrator.getThreadProjection(threadId);
+        assert.deepEqual(
+          afterDispose.subagents.find((candidate) => candidate.id === taskId)?.completionDelivery,
+          {
+            state: "disposed",
+            observedByRunId: null,
+          },
+        );
+
+        const acknowledgeAfterDispose = yield* orchestrator.dispatch({
+          type: "delegated_task.completion-delivery.acknowledge",
+          commandId: CommandId.make("command:delegated-delivery-a2:ack-after-dispose"),
+          parentThreadId: threadId,
+          taskId,
+          observedByRunId: runId,
+        });
+        const acknowledgedTask = acknowledgeAfterDispose.storedEvents.find(
+          (stored) => stored.event.type === "subagent.updated",
+        );
+        if (acknowledgedTask?.event.type !== "subagent.updated") {
+          return yield* Effect.die(new Error("Acknowledge-after-dispose event missing."));
+        }
+        assert.deepEqual(acknowledgedTask.event.payload.completionDelivery, {
+          state: "disposed",
+          observedByRunId: null,
+        });
+        assert.equal(acknowledgeAfterDispose.storedEvents.length, 1);
+
+        const afterStaleAcknowledge = yield* orchestrator.getThreadProjection(threadId);
+        assert.deepEqual(
+          afterStaleAcknowledge.subagents.find((candidate) => candidate.id === taskId)
+            ?.completionDelivery,
+          {
+            state: "disposed",
+            observedByRunId: null,
+          },
+        );
+      }),
+  );
+});
diff --git a/apps/server/src/orchestration-v2/EffectOutbox.ts b/apps/server/src/orchestration-v2/EffectOutbox.ts
new file mode 100644
index 000000000000..85180279fc77
--- /dev/null
+++ b/apps/server/src/orchestration-v2/EffectOutbox.ts
@@ -0,0 +1,612 @@
+import {
+  CheckpointId,
+  CheckpointScopeId,
+  CommandId,
+  MessageId,
+  ProviderSessionId,
+  RunAttemptId,
+  ProviderApprovalDecision,
+  ProviderUserInputAnswers,
+  ProviderThreadId,
+  ProviderTurnId,
+  RunId,
+  RuntimeRequestId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as Context from "effect/Context";
+import * as DateTime from "effect/DateTime";
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Queue from "effect/Queue";
+import * as Schema from "effect/Schema";
+import * as SqlClient from "effect/unstable/sql/SqlClient";
+
+export const OrchestrationEffectRequestV2 = Schema.Union([
+  Schema.Struct({
+    type: Schema.Literal("provider-session.detach"),
+    providerSessionId: ProviderSessionId,
+    detail: Schema.optional(Schema.String),
+    /** Set on terminal detaches (thread archive/delete): revoke the thread's MCP credentials. */
+    revokeMcpCredential: Schema.optional(Schema.Boolean),
+  }),
+  Schema.Struct({
+    type: Schema.Literal("provider-turn.start"),
+    runId: RunId,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("provider-turn.interrupt"),
+    providerSessionId: ProviderSessionId,
+    providerThreadId: ProviderThreadId,
+    providerTurnId: ProviderTurnId,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("provider-turn.steer"),
+    providerSessionId: ProviderSessionId,
+    providerThreadId: ProviderThreadId,
+    providerTurnId: ProviderTurnId,
+    messageId: MessageId,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("provider-turn.restart"),
+    providerSessionId: ProviderSessionId,
+    providerThreadId: ProviderThreadId,
+    providerTurnId: ProviderTurnId,
+    interruptedAttemptId: RunAttemptId,
+    runId: RunId,
+    sessionTransition: Schema.optional(
+      Schema.Union([
+        Schema.Struct({
+          type: Schema.Literal("replace"),
+          replacementProviderSessionId: ProviderSessionId,
+        }),
+        Schema.Struct({ type: Schema.Literal("detach") }),
+      ]),
+    ),
+  }),
+  Schema.Struct({
+    type: Schema.Literal("runtime-request.respond"),
+    providerSessionId: ProviderSessionId,
+    requestId: RuntimeRequestId,
+    decision: Schema.optional(ProviderApprovalDecision),
+    answers: Schema.optional(ProviderUserInputAnswers),
+  }),
+  Schema.Struct({
+    type: Schema.Literal("provider-thread.rollback"),
+    providerThreadId: ProviderThreadId,
+    checkpointId: CheckpointId,
+    scopeId: CheckpointScopeId,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("checkpoint.capture"),
+    runId: RunId,
+    scopeId: CheckpointScopeId,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("terminal.cleanup"),
+  }),
+  Schema.Struct({
+    type: Schema.Literal("attachment.cleanup"),
+    attachmentIds: Schema.Array(Schema.String),
+  }),
+  Schema.Struct({
+    type: Schema.Literal("thread-title.generate"),
+    kind: Schema.Union([
+      Schema.Struct({ type: Schema.Literal("initial"), messageId: MessageId }),
+      Schema.Struct({ type: Schema.Literal("regenerate") }),
+    ]),
+  }),
+]);
+export type OrchestrationEffectRequestV2 = typeof OrchestrationEffectRequestV2.Type;
+
+export const REPLAY_SAFE_EFFECT_TYPES_AFTER_PROCESS_LOSS = [
+  "provider-session.detach",
+  "provider-thread.rollback",
+  "checkpoint.capture",
+  "terminal.cleanup",
+  "attachment.cleanup",
+  "thread-title.generate",
+] as const satisfies ReadonlyArray<OrchestrationEffectRequestV2["type"]>;
+
+export const PROCESS_BOUND_EFFECT_TYPES = [
+  "provider-turn.start",
+  "provider-turn.interrupt",
+  "provider-turn.steer",
+  "provider-turn.restart",
+  "runtime-request.respond",
+] as const satisfies ReadonlyArray<OrchestrationEffectRequestV2["type"]>;
+
+export const OrchestrationEffectStatusV2 = Schema.Literals([
+  "pending",
+  "running",
+  "succeeded",
+  "failed",
+  "cancelled",
+]);
+export type OrchestrationEffectStatusV2 = typeof OrchestrationEffectStatusV2.Type;
+
+export interface OrchestrationEffectV2 {
+  readonly id: string;
+  readonly commandId: CommandId;
+  readonly threadId: ThreadId;
+  readonly request: OrchestrationEffectRequestV2;
+  readonly status: OrchestrationEffectStatusV2;
+  readonly attemptCount: number;
+  readonly availableAt: string;
+  readonly leaseOwner: string | null;
+  readonly leaseExpiresAt: string | null;
+  readonly createdAt: string;
+  readonly updatedAt: string;
+  readonly completedAt: string | null;
+  readonly lastError: string | null;
+}
+
+export interface PendingOrchestrationEffectV2 {
+  readonly id: string;
+  readonly commandId: CommandId;
+  readonly threadId: ThreadId;
+  readonly request: OrchestrationEffectRequestV2;
+  readonly availableAt?: DateTime.Utc;
+}
+
+export class EffectOutboxError extends Schema.TaggedErrorClass<EffectOutboxError>()(
+  "EffectOutboxError",
+  {
+    operation: Schema.String,
+    effectId: Schema.optional(Schema.String),
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Orchestration effect outbox ${this.operation} failed${this.effectId === undefined ? "" : ` for ${this.effectId}`}.`;
+  }
+}
+
+const isEffectOutboxError = Schema.is(EffectOutboxError);
+
+export interface EffectOutboxV2Shape {
+  readonly awaitAvailable: Effect.Effect<void>;
+  readonly notifyAvailable: (count?: number) => Effect.Effect<void>;
+  /** Persist rows only. Notify workers after the surrounding transaction commits. */
+  readonly enqueue: (
+    effects: ReadonlyArray<PendingOrchestrationEffectV2>,
+  ) => Effect.Effect<void, EffectOutboxError>;
+  readonly get: (
+    effectId: string,
+  ) => Effect.Effect<Option.Option<OrchestrationEffectV2>, EffectOutboxError>;
+  readonly listByCommandId: (
+    commandId: CommandId,
+  ) => Effect.Effect<ReadonlyArray<OrchestrationEffectV2>, EffectOutboxError>;
+  readonly cancelUnsettled: (input: {
+    readonly threadId: ThreadId;
+    readonly effectTypes: ReadonlyArray<OrchestrationEffectRequestV2["type"]>;
+    readonly reason: string;
+  }) => Effect.Effect<ReadonlyArray<string>, EffectOutboxError>;
+  readonly signalCancellations: (effectIds: ReadonlyArray<string>) => Effect.Effect<void>;
+  readonly awaitCancellation: (effectId: string) => Effect.Effect<void>;
+  readonly clearCancellation: (effectId: string) => Effect.Effect<void>;
+  readonly reconcileAfterProcessLoss: Effect.Effect<
+    { readonly requeued: number; readonly cancelled: number },
+    EffectOutboxError
+  >;
+  readonly claimNext: (input: {
+    readonly workerId: string;
+    readonly leaseDurationMs: number;
+  }) => Effect.Effect<Option.Option<OrchestrationEffectV2>, EffectOutboxError>;
+  readonly nextClaimableAt: Effect.Effect<Option.Option<DateTime.Utc>, EffectOutboxError>;
+  readonly succeed: (input: {
+    readonly effectId: string;
+    readonly workerId: string;
+  }) => Effect.Effect<boolean, EffectOutboxError>;
+  readonly retry: (input: {
+    readonly effectId: string;
+    readonly workerId: string;
+    readonly error: string;
+    readonly delayMs: number;
+  }) => Effect.Effect<boolean, EffectOutboxError>;
+  readonly fail: (input: {
+    readonly effectId: string;
+    readonly workerId: string;
+    readonly error: string;
+  }) => Effect.Effect<boolean, EffectOutboxError>;
+}
+
+export class EffectOutboxV2 extends Context.Service<EffectOutboxV2, EffectOutboxV2Shape>()(
+  "t3/orchestration-v2/EffectOutbox/EffectOutboxV2",
+) {}
+
+type EffectRow = {
+  readonly effect_id: string;
+  readonly command_id: string;
+  readonly thread_id: string;
+  readonly effect_type: string;
+  readonly payload_json: string;
+  readonly status: string;
+  readonly attempt_count: number;
+  readonly available_at: string;
+  readonly lease_owner: string | null;
+  readonly lease_expires_at: string | null;
+  readonly created_at: string;
+  readonly updated_at: string;
+  readonly completed_at: string | null;
+  readonly last_error: string | null;
+};
+
+const encodeRequest = Schema.encodeSync(Schema.fromJsonString(OrchestrationEffectRequestV2));
+const decodeRequest = Schema.decodeUnknownEffect(
+  Schema.fromJsonString(OrchestrationEffectRequestV2),
+);
+
+const rowToEffect = (row: EffectRow) =>
+  decodeRequest(row.payload_json).pipe(
+    Effect.map(
+      (request): OrchestrationEffectV2 => ({
+        id: row.effect_id,
+        commandId: CommandId.make(row.command_id),
+        threadId: ThreadId.make(row.thread_id),
+        request,
+        status: row.status as OrchestrationEffectStatusV2,
+        attemptCount: row.attempt_count,
+        availableAt: row.available_at,
+        leaseOwner: row.lease_owner,
+        leaseExpiresAt: row.lease_expires_at,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+        completedAt: row.completed_at,
+        lastError: row.last_error,
+      }),
+    ),
+  );
+
+export const layer: Layer.Layer<EffectOutboxV2, never, SqlClient.SqlClient> = Layer.effect(
+  EffectOutboxV2,
+  Effect.gen(function* () {
+    const sql = yield* SqlClient.SqlClient;
+    // Availability is only a bounded latency hint; durable rows remain
+    // authoritative. Retaining a small burst lets multiple worker slots wake
+    // for distinct threads without allowing notifications to grow unbounded.
+    const available = yield* Queue.dropping<void>(64);
+    const cancellationSignals = new Map<string, Deferred.Deferred<void>>();
+    const notifyAvailable = (count = 1) =>
+      Queue.offerAll(
+        available,
+        Array.from({ length: Math.min(64, Math.max(0, Math.floor(count))) }, () => undefined),
+      ).pipe(Effect.asVoid);
+    // Title generation is correlated metadata work, so it has its own
+    // per-thread lane and cannot delay provider lifecycle effects.
+    const claimableCandidatePredicate = (availableBefore?: string) =>
+      sql`
+        ${
+          availableBefore === undefined
+            ? sql`1 = 1`
+            : sql`candidate.available_at <= ${availableBefore}`
+        }
+        AND candidate.status = 'pending'
+        AND NOT EXISTS (
+          SELECT 1
+          FROM orchestration_v2_effect_outbox AS active
+          WHERE active.thread_id = candidate.thread_id
+            AND active.status = 'running'
+            AND (
+              (
+                candidate.effect_type = 'thread-title.generate'
+                AND active.effect_type = 'thread-title.generate'
+              )
+              OR
+              (
+                candidate.effect_type != 'thread-title.generate'
+                AND active.effect_type != 'thread-title.generate'
+              )
+            )
+        )
+      `;
+
+    const cancellationSignal = (effectId: string) => {
+      const existing = cancellationSignals.get(effectId);
+      if (existing !== undefined) return existing;
+      const created = Deferred.makeUnsafe<void>();
+      cancellationSignals.set(effectId, created);
+      return created;
+    };
+
+    const decodeRows = (operation: string, rows: ReadonlyArray<EffectRow>) =>
+      Effect.forEach(rows, rowToEffect).pipe(
+        Effect.mapError((cause) => new EffectOutboxError({ operation, cause })),
+      );
+
+    const service: EffectOutboxV2Shape = {
+      enqueue: (effects) =>
+        Effect.gen(function* () {
+          const now = yield* DateTime.now;
+          const nowIso = DateTime.formatIso(now);
+          yield* Effect.forEach(
+            effects,
+            (effect) => sql`
+              INSERT INTO orchestration_v2_effect_outbox (
+                effect_id,
+                command_id,
+                thread_id,
+                effect_type,
+                payload_json,
+                status,
+                attempt_count,
+                available_at,
+                created_at,
+                updated_at
+              )
+              VALUES (
+                ${effect.id},
+                ${effect.commandId},
+                ${effect.threadId},
+                ${effect.request.type},
+                ${encodeRequest(effect.request)},
+                'pending',
+                0,
+                ${DateTime.formatIso(effect.availableAt ?? now)},
+                ${nowIso},
+                ${nowIso}
+              )
+              ON CONFLICT(effect_id) DO NOTHING
+            `,
+            { concurrency: 1, discard: true },
+          );
+          // Do not signal here: callers enqueue inside a larger transaction,
+          // and workers must only observe availability after that transaction
+          // commits. EventSink owns the corresponding post-commit notification.
+        }).pipe(Effect.mapError((cause) => new EffectOutboxError({ operation: "enqueue", cause }))),
+      get: (effectId) =>
+        sql<EffectRow>`
+          SELECT *
+          FROM orchestration_v2_effect_outbox
+          WHERE effect_id = ${effectId}
+          LIMIT 1
+        `.pipe(
+          Effect.flatMap((rows) => {
+            const row = rows[0];
+            return row === undefined
+              ? Effect.succeed(Option.none())
+              : rowToEffect(row).pipe(Effect.map(Option.some));
+          }),
+          Effect.mapError((cause) => new EffectOutboxError({ operation: "get", effectId, cause })),
+        ),
+      awaitAvailable: Queue.take(available),
+      notifyAvailable,
+      listByCommandId: (commandId) =>
+        sql<EffectRow>`
+          SELECT *
+          FROM orchestration_v2_effect_outbox
+          WHERE command_id = ${commandId}
+          ORDER BY created_at ASC, effect_id ASC
+        `.pipe(
+          Effect.flatMap((rows) => decodeRows("list", rows)),
+          Effect.mapError((cause) =>
+            isEffectOutboxError(cause)
+              ? cause
+              : new EffectOutboxError({ operation: "list", cause }),
+          ),
+        ),
+      cancelUnsettled: ({ threadId, effectTypes, reason }) =>
+        Effect.gen(function* () {
+          if (effectTypes.length === 0) return [];
+          const now = DateTime.formatIso(yield* DateTime.now);
+          const rows = yield* sql<{ readonly effect_id: string }>`
+            UPDATE orchestration_v2_effect_outbox
+            SET
+              status = 'cancelled',
+              lease_owner = NULL,
+              lease_expires_at = NULL,
+              completed_at = ${now},
+              updated_at = ${now},
+              last_error = ${reason}
+            WHERE thread_id = ${threadId}
+              AND status IN ('pending', 'running')
+              AND effect_type IN ${sql.in(effectTypes)}
+            RETURNING effect_id
+          `;
+          return rows.map(({ effect_id }) => effect_id);
+        }).pipe(
+          Effect.mapError(
+            (cause) => new EffectOutboxError({ operation: "cancel-unsettled", cause }),
+          ),
+        ),
+      signalCancellations: (effectIds) =>
+        Effect.gen(function* () {
+          yield* Effect.forEach(
+            effectIds,
+            (effectId) => {
+              const signal = cancellationSignals.get(effectId);
+              return signal === undefined ? Effect.void : Deferred.succeed(signal, undefined);
+            },
+            { discard: true },
+          );
+          // Cancellation can unblock other pending work on the same thread.
+          // This method is deliberately post-commit, so it is also the safe
+          // place to wake claimers after the durable status change.
+          if (effectIds.length > 0) yield* notifyAvailable(effectIds.length);
+        }),
+      awaitCancellation: (effectId) => Deferred.await(cancellationSignal(effectId)),
+      clearCancellation: (effectId) =>
+        Effect.sync(() => {
+          cancellationSignals.delete(effectId);
+        }),
+      reconcileAfterProcessLoss: Effect.gen(function* () {
+        const now = DateTime.formatIso(yield* DateTime.now);
+        const cancelledRows = yield* sql<{ readonly effect_id: string }>`
+          UPDATE orchestration_v2_effect_outbox
+          SET
+            status = 'cancelled',
+            lease_owner = NULL,
+            lease_expires_at = NULL,
+            completed_at = ${now},
+            updated_at = ${now},
+            last_error = 'Cancelled because the server process ended before the effect completed.'
+          WHERE status IN ('pending', 'running')
+            AND effect_type IN ${sql.in(PROCESS_BOUND_EFFECT_TYPES)}
+          RETURNING effect_id
+        `;
+        const requeuedRows = yield* sql<{ readonly effect_id: string }>`
+          UPDATE orchestration_v2_effect_outbox
+          SET
+            status = 'pending',
+            lease_owner = NULL,
+            lease_expires_at = NULL,
+            available_at = ${now},
+            updated_at = ${now},
+            last_error = 'Requeued after the previous server process ended.'
+          WHERE status = 'running'
+            AND effect_type IN ${sql.in(REPLAY_SAFE_EFFECT_TYPES_AFTER_PROCESS_LOSS)}
+          RETURNING effect_id
+        `;
+        if (requeuedRows.length > 0) yield* notifyAvailable(requeuedRows.length);
+        return { requeued: requeuedRows.length, cancelled: cancelledRows.length };
+      }).pipe(
+        Effect.mapError(
+          (cause) => new EffectOutboxError({ operation: "reconcile-process-loss", cause }),
+        ),
+      ),
+      claimNext: ({ workerId, leaseDurationMs }) =>
+        Effect.gen(function* () {
+          const now = yield* DateTime.now;
+          const nowIso = DateTime.formatIso(now);
+          const leaseExpiresAt = DateTime.formatIso(
+            DateTime.add(now, { milliseconds: Math.max(1, leaseDurationMs) }),
+          );
+          // Empty safety claims are expected while the daemon is idle. Tracing
+          // this query records the full SQL text on every poll and can dominate
+          // the local trace without adding actionable information.
+          const claimStatement = sql<EffectRow>`
+            UPDATE orchestration_v2_effect_outbox
+            SET
+              status = 'running',
+              attempt_count = attempt_count + 1,
+              lease_owner = ${workerId},
+              lease_expires_at = ${leaseExpiresAt},
+              updated_at = ${nowIso},
+              last_error = NULL
+            WHERE effect_id = (
+              SELECT candidate.effect_id
+              FROM orchestration_v2_effect_outbox AS candidate
+              WHERE ${claimableCandidatePredicate(nowIso)}
+              ORDER BY candidate.available_at ASC, candidate.created_at ASC, candidate.effect_id ASC
+              LIMIT 1
+            )
+            RETURNING *
+          `;
+          const rows = yield* claimStatement.pipe(Effect.withTracerEnabled(false));
+          const row = rows[0];
+          if (row === undefined) return Option.none();
+          cancellationSignals.set(row.effect_id, Deferred.makeUnsafe<void>());
+          return Option.some(yield* rowToEffect(row));
+        }).pipe(Effect.mapError((cause) => new EffectOutboxError({ operation: "claim", cause }))),
+      nextClaimableAt: Effect.gen(function* () {
+        const rows = yield* sql<{ readonly available_at: string | null }>`
+          SELECT MIN(candidate.available_at) AS available_at
+          FROM orchestration_v2_effect_outbox AS candidate
+          WHERE ${claimableCandidatePredicate()}
+        `.pipe(Effect.withTracerEnabled(false));
+        const availableAt = rows[0]?.available_at;
+        if (availableAt === undefined || availableAt === null) return Option.none();
+        const parsed = DateTime.make(availableAt);
+        if (Option.isNone(parsed)) {
+          return yield* new EffectOutboxError({
+            operation: "next-claimable",
+            cause: `Invalid available_at timestamp: ${availableAt}`,
+          });
+        }
+        return parsed;
+      }).pipe(
+        Effect.mapError((cause) =>
+          isEffectOutboxError(cause)
+            ? cause
+            : new EffectOutboxError({ operation: "next-claimable", cause }),
+        ),
+      ),
+      succeed: ({ effectId, workerId }) =>
+        Effect.gen(function* () {
+          const now = DateTime.formatIso(yield* DateTime.now);
+          const rows = yield* sql<{ readonly effect_id: string }>`
+            UPDATE orchestration_v2_effect_outbox
+            SET
+              status = 'succeeded',
+              lease_owner = NULL,
+              lease_expires_at = NULL,
+              completed_at = ${now},
+              updated_at = ${now},
+              last_error = NULL
+            WHERE effect_id = ${effectId}
+              AND status = 'running'
+              AND lease_owner = ${workerId}
+            RETURNING effect_id
+          `;
+          if (rows.length === 1) {
+            cancellationSignals.delete(effectId);
+            yield* notifyAvailable();
+          }
+          return rows.length === 1;
+        }).pipe(
+          Effect.mapError(
+            (cause) => new EffectOutboxError({ operation: "succeed", effectId, cause }),
+          ),
+        ),
+      retry: ({ effectId, workerId, error, delayMs }) =>
+        Effect.gen(function* () {
+          const now = yield* DateTime.now;
+          const nowIso = DateTime.formatIso(now);
+          const availableAt = DateTime.formatIso(
+            DateTime.add(now, { milliseconds: Math.max(0, delayMs) }),
+          );
+          const rows = yield* sql<{ readonly effect_id: string }>`
+            UPDATE orchestration_v2_effect_outbox
+            SET
+              status = 'pending',
+              available_at = ${availableAt},
+              lease_owner = NULL,
+              lease_expires_at = NULL,
+              updated_at = ${nowIso},
+              last_error = ${error}
+            WHERE effect_id = ${effectId}
+              AND status = 'running'
+              AND lease_owner = ${workerId}
+            RETURNING effect_id
+          `;
+          if (rows.length === 1) {
+            cancellationSignals.delete(effectId);
+            yield* notifyAvailable();
+          }
+          return rows.length === 1;
+        }).pipe(
+          Effect.mapError(
+            (cause) => new EffectOutboxError({ operation: "retry", effectId, cause }),
+          ),
+        ),
+      fail: ({ effectId, workerId, error }) =>
+        Effect.gen(function* () {
+          const now = DateTime.formatIso(yield* DateTime.now);
+          const rows = yield* sql<{ readonly effect_id: string }>`
+            UPDATE orchestration_v2_effect_outbox
+            SET
+              status = 'failed',
+              lease_owner = NULL,
+              lease_expires_at = NULL,
+              completed_at = ${now},
+              updated_at = ${now},
+              last_error = ${error}
+            WHERE effect_id = ${effectId}
+              AND status = 'running'
+              AND lease_owner = ${workerId}
+            RETURNING effect_id
+          `;
+          if (rows.length === 1) {
+            cancellationSignals.delete(effectId);
+            yield* notifyAvailable();
+          }
+          return rows.length === 1;
+        }).pipe(
+          Effect.mapError((cause) => new EffectOutboxError({ operation: "fail", effectId, cause })),
+        ),
+    };
+
+    return service;
+  }),
+);
diff --git a/apps/server/src/orchestration-v2/EffectWorker.test.ts b/apps/server/src/orchestration-v2/EffectWorker.test.ts
new file mode 100644
index 000000000000..b39105f36f89
--- /dev/null
+++ b/apps/server/src/orchestration-v2/EffectWorker.test.ts
@@ -0,0 +1,789 @@
+import { assert, it } from "@effect/vitest";
+import {
+  CommandId,
+  MessageId,
+  ProviderSessionId,
+  ProviderThreadId,
+  ProviderTurnId,
+  RunAttemptId,
+  RunId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as Cause from "effect/Cause";
+import * as DateTime from "effect/DateTime";
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Queue from "effect/Queue";
+import * as Ref from "effect/Ref";
+import * as TestClock from "effect/testing/TestClock";
+
+import { CheckpointRollbackServiceV2 } from "./CheckpointRollbackService.ts";
+import { EffectOutboxError, EffectOutboxV2, type OrchestrationEffectV2 } from "./EffectOutbox.ts";
+import {
+  executorLayer,
+  isNonRetryableProviderTurnControlFailure,
+  layerWithOptions as effectWorkerLayerWithOptions,
+  OrchestrationEffectExecutionError,
+  OrchestrationEffectExecutorV2,
+  OrchestrationEffectWorkerError,
+  OrchestrationEffectWorkerV2,
+  runDaemonWithOptions,
+} from "./EffectWorker.ts";
+import { RunFinalizationService } from "./RunFinalizationService.ts";
+import { ProviderSessionManagerV2 } from "./ProviderSessionManager.ts";
+import { ProviderTurnControlServiceV2 } from "./ProviderTurnControlService.ts";
+import { ProviderTurnStartError, ProviderTurnStartServiceV2 } from "./ProviderTurnStartService.ts";
+import { RuntimeRequestServiceV2 } from "./RuntimeRequestService.ts";
+import { ThreadTitleRegenerationService } from "./ThreadTitleRegenerationService.ts";
+
+const threadId = ThreadId.make("thread:effect-worker-restart");
+const oldSessionId = ProviderSessionId.make("provider-session:effect-worker-restart:old");
+const replacementSessionId = ProviderSessionId.make(
+  "provider-session:effect-worker-restart:replacement",
+);
+const providerThreadId = ProviderThreadId.make("provider-thread:effect-worker-restart");
+const providerTurnId = ProviderTurnId.make("provider-turn:effect-worker-restart");
+const attemptId = RunAttemptId.make("run-attempt:effect-worker-restart");
+const runId = RunId.make("run:effect-worker-restart");
+
+function restartEffect(
+  now: DateTime.Utc,
+  sessionTransition: NonNullable<
+    Extract<
+      OrchestrationEffectV2["request"],
+      { readonly type: "provider-turn.restart" }
+    >["sessionTransition"]
+  >,
+): OrchestrationEffectV2 {
+  const timestamp = DateTime.formatIso(now);
+  return {
+    id: `effect:restart:${sessionTransition.type}`,
+    commandId: CommandId.make(`command:restart:${sessionTransition.type}`),
+    threadId,
+    request: {
+      type: "provider-turn.restart",
+      providerSessionId: oldSessionId,
+      providerThreadId,
+      providerTurnId,
+      interruptedAttemptId: attemptId,
+      runId,
+      sessionTransition,
+    },
+    status: "running",
+    attemptCount: 1,
+    availableAt: timestamp,
+    leaseOwner: "test-worker",
+    leaseExpiresAt: timestamp,
+    createdAt: timestamp,
+    updatedAt: timestamp,
+    completedAt: null,
+    lastError: null,
+  };
+}
+
+function makeExecutorLayer(input: {
+  readonly events: Ref.Ref<ReadonlyArray<string>>;
+  readonly failFirstStart?: Ref.Ref<boolean>;
+}) {
+  const record = (event: string) => Ref.update(input.events, (events) => [...events, event]);
+  const dependencies = Layer.mergeAll(
+    Layer.succeed(
+      ProviderTurnControlServiceV2,
+      ProviderTurnControlServiceV2.of({
+        interrupt: () => Effect.void,
+        steer: () => Effect.void,
+        interruptAndAwaitTerminal: (request) =>
+          record(
+            request.replacementProviderSessionId === undefined
+              ? "interrupt"
+              : `interrupt:${request.replacementProviderSessionId}`,
+          ),
+      }),
+    ),
+    Layer.succeed(
+      ProviderSessionManagerV2,
+      ProviderSessionManagerV2.of({
+        shutdown: Effect.void,
+        open: () => Effect.die("unused open"),
+        get: () => Effect.succeed(Option.none()),
+        close: () => Effect.void,
+        release: () => record("release"),
+        detach: () => record("detach"),
+      }),
+    ),
+    Layer.succeed(
+      ProviderTurnStartServiceV2,
+      ProviderTurnStartServiceV2.of({
+        start: () =>
+          Effect.gen(function* () {
+            yield* record("start");
+            if (
+              input.failFirstStart !== undefined &&
+              (yield* Ref.getAndSet(input.failFirstStart, false))
+            ) {
+              return yield* new ProviderTurnStartError({
+                runId,
+                cause: "simulated first start failure",
+              });
+            }
+          }),
+      }),
+    ),
+    Layer.succeed(
+      RunFinalizationService,
+      RunFinalizationService.of({ finalize: () => Effect.void }),
+    ),
+    Layer.succeed(
+      CheckpointRollbackServiceV2,
+      CheckpointRollbackServiceV2.of({ execute: () => Effect.void }),
+    ),
+    Layer.succeed(
+      RuntimeRequestServiceV2,
+      RuntimeRequestServiceV2.of({ respond: () => Effect.void }),
+    ),
+    Layer.succeed(
+      ThreadTitleRegenerationService,
+      ThreadTitleRegenerationService.of({
+        execute: ({ requestId, kind }) => record(`title:${kind.type}:${requestId}`),
+      }),
+    ),
+  );
+  return executorLayer.pipe(Layer.provide(dependencies));
+}
+
+it("does not retry pure interrupt races where the turn is already gone", () => {
+  assert.isTrue(
+    isNonRetryableProviderTurnControlFailure(
+      "provider-turn.interrupt",
+      "ProviderAdapterInterruptError: ... ACP provider turn provider-turn:x is not active",
+    ),
+  );
+  assert.isTrue(
+    isNonRetryableProviderTurnControlFailure(
+      "provider-turn.interrupt",
+      "Provider session provider-session:x is not active.",
+    ),
+  );
+  // Restart is compound (interrupt + detach + start). Do not swallow start failures.
+  assert.isFalse(
+    isNonRetryableProviderTurnControlFailure(
+      "provider-turn.restart",
+      "Provider session provider-session:x is not active.",
+    ),
+  );
+  assert.isFalse(
+    isNonRetryableProviderTurnControlFailure(
+      "provider-turn.start",
+      "Provider session provider-session:x is not active.",
+    ),
+  );
+  assert.isFalse(
+    isNonRetryableProviderTurnControlFailure(
+      "provider-turn.interrupt",
+      "ACP hard teardown failed unexpectedly; the session is poisoned",
+    ),
+  );
+});
+
+it.effect("requeues a claim when a pre-execution worker check fails", () =>
+  Effect.gen(function* () {
+    const now = DateTime.formatIso(yield* DateTime.now);
+    const effectId = "effect:worker-pre-execution-failure";
+    const workerId = "worker-pre-execution-failure";
+    const claimedEffect: OrchestrationEffectV2 = {
+      id: effectId,
+      commandId: CommandId.make("command:worker-pre-execution-failure"),
+      threadId: ThreadId.make("thread:worker-pre-execution-failure"),
+      request: { type: "terminal.cleanup" },
+      status: "running",
+      attemptCount: 1,
+      availableAt: now,
+      leaseOwner: workerId,
+      leaseExpiresAt: now,
+      createdAt: now,
+      updatedAt: now,
+      completedAt: null,
+      lastError: null,
+    };
+    const retries = yield* Ref.make<
+      ReadonlyArray<{
+        readonly effectId: string;
+        readonly workerId: string;
+        readonly error: string;
+        readonly delayMs: number;
+      }>
+    >([]);
+    const executionCount = yield* Ref.make(0);
+    const outboxLayer = Layer.mock(EffectOutboxV2)({
+      claimNext: () => Effect.succeed(Option.some(claimedEffect)),
+      get: () =>
+        Effect.fail(
+          new EffectOutboxError({
+            operation: "get",
+            effectId,
+            cause: "simulated cancellation-state read failure",
+          }),
+        ),
+      retry: (input) =>
+        Ref.update(retries, (existing) => [...existing, input]).pipe(Effect.as(true)),
+    });
+    const executorLayer = Layer.succeed(
+      OrchestrationEffectExecutorV2,
+      OrchestrationEffectExecutorV2.of({
+        execute: () => Ref.update(executionCount, (count) => count + 1),
+      }),
+    );
+    const workerLayer = effectWorkerLayerWithOptions({ workerId }).pipe(
+      Layer.provide(Layer.merge(outboxLayer, executorLayer)),
+    );
+
+    const exit = yield* OrchestrationEffectWorkerV2.pipe(
+      Effect.flatMap((worker) => worker.runOnce),
+      Effect.provide(workerLayer),
+      Effect.exit,
+    );
+
+    assert.isTrue(Exit.isFailure(exit));
+    if (Exit.isFailure(exit)) {
+      assert.include(Cause.pretty(exit.cause), "simulated cancellation-state read failure");
+    }
+    assert.equal(yield* Ref.get(executionCount), 0);
+    const retry = (yield* Ref.get(retries))[0];
+    assert.isDefined(retry);
+    assert.equal(retry.effectId, effectId);
+    assert.equal(retry.workerId, workerId);
+    assert.equal(retry.delayMs, 0);
+    assert.include(retry.error, "simulated cancellation-state read failure");
+  }),
+);
+
+it.effect("arms cancellation before the durable pre-execution check", () =>
+  Effect.gen(function* () {
+    const now = DateTime.formatIso(yield* DateTime.now);
+    const effectId = "effect:worker-cancellation-registration-race";
+    const workerId = "worker-cancellation-registration-race";
+    const claimedEffect: OrchestrationEffectV2 = {
+      id: effectId,
+      commandId: CommandId.make("command:worker-cancellation-registration-race"),
+      threadId: ThreadId.make("thread:worker-cancellation-registration-race"),
+      request: { type: "terminal.cleanup" },
+      status: "running",
+      attemptCount: 1,
+      availableAt: now,
+      leaseOwner: workerId,
+      leaseExpiresAt: now,
+      createdAt: now,
+      updatedAt: now,
+      completedAt: null,
+      lastError: null,
+    };
+    const signal = yield* Deferred.make<void>();
+    let cancellationArmed = false;
+    const executionCount = yield* Ref.make(0);
+    const settlementCount = yield* Ref.make(0);
+    const outboxLayer = Layer.mock(EffectOutboxV2)({
+      claimNext: () => Effect.succeed(Option.some(claimedEffect)),
+      awaitCancellation: () => {
+        cancellationArmed = true;
+        return Deferred.await(signal);
+      },
+      get: () =>
+        Effect.gen(function* () {
+          // Model a cancellation commit immediately after this durable read
+          // took its snapshot. Its process-local signal is only delivered when
+          // the worker registered the waiter before starting the read.
+          if (cancellationArmed) {
+            yield* Deferred.succeed(signal, undefined);
+          }
+          return Option.some(claimedEffect);
+        }),
+      clearCancellation: () => Effect.void,
+      succeed: () => Ref.update(settlementCount, (count) => count + 1).pipe(Effect.as(true)),
+    });
+    const executorLayer = Layer.succeed(
+      OrchestrationEffectExecutorV2,
+      OrchestrationEffectExecutorV2.of({
+        execute: () =>
+          Effect.yieldNow.pipe(Effect.andThen(Ref.update(executionCount, (count) => count + 1))),
+      }),
+    );
+    const workerLayer = effectWorkerLayerWithOptions({ workerId }).pipe(
+      Layer.provide(Layer.merge(outboxLayer, executorLayer)),
+    );
+
+    const exit = yield* OrchestrationEffectWorkerV2.pipe(
+      Effect.flatMap((worker) => worker.runOnce),
+      Effect.provide(workerLayer),
+      Effect.exit,
+    );
+
+    if (Exit.isFailure(exit)) {
+      assert.fail(Cause.pretty(exit.cause));
+    }
+    assert.equal(yield* Ref.get(executionCount), 0);
+    assert.equal(yield* Ref.get(settlementCount), 0);
+  }),
+);
+
+it.effect("terminalizes a process-bound claim when success settlement fails", () =>
+  Effect.gen(function* () {
+    const now = DateTime.formatIso(yield* DateTime.now);
+    const effectId = "effect:worker-process-bound-settlement-failure";
+    const workerId = "worker-process-bound-settlement-failure";
+    const claimedEffect: OrchestrationEffectV2 = {
+      id: effectId,
+      commandId: CommandId.make("command:worker-process-bound-settlement-failure"),
+      threadId: ThreadId.make("thread:worker-process-bound-settlement-failure"),
+      request: {
+        type: "provider-turn.start",
+        runId: RunId.make("run:worker-process-bound-settlement-failure"),
+      },
+      status: "running",
+      attemptCount: 1,
+      availableAt: now,
+      leaseOwner: workerId,
+      leaseExpiresAt: now,
+      createdAt: now,
+      updatedAt: now,
+      completedAt: null,
+      lastError: null,
+    };
+    const retries = yield* Ref.make(0);
+    const terminalErrors = yield* Ref.make<ReadonlyArray<string>>([]);
+    const executionCount = yield* Ref.make(0);
+    const outboxLayer = Layer.mock(EffectOutboxV2)({
+      claimNext: () => Effect.succeed(Option.some(claimedEffect)),
+      get: () => Effect.succeed(Option.some(claimedEffect)),
+      awaitCancellation: () => Effect.never,
+      clearCancellation: () => Effect.void,
+      succeed: () =>
+        Effect.fail(
+          new EffectOutboxError({
+            operation: "succeed",
+            effectId,
+            cause: "simulated success settlement failure",
+          }),
+        ),
+      retry: () => Ref.update(retries, (count) => count + 1).pipe(Effect.as(true)),
+      fail: ({ error }) =>
+        Ref.update(terminalErrors, (existing) => [...existing, error]).pipe(Effect.as(true)),
+    });
+    const executorLayer = Layer.succeed(
+      OrchestrationEffectExecutorV2,
+      OrchestrationEffectExecutorV2.of({
+        execute: () => Ref.update(executionCount, (count) => count + 1),
+      }),
+    );
+    const workerLayer = effectWorkerLayerWithOptions({ workerId }).pipe(
+      Layer.provide(Layer.merge(outboxLayer, executorLayer)),
+    );
+
+    const exit = yield* OrchestrationEffectWorkerV2.pipe(
+      Effect.flatMap((worker) => worker.runOnce),
+      Effect.provide(workerLayer),
+      Effect.exit,
+    );
+
+    assert.isTrue(Exit.isFailure(exit));
+    assert.equal(yield* Ref.get(executionCount), 1);
+    assert.equal(yield* Ref.get(retries), 0);
+    const terminalError = (yield* Ref.get(terminalErrors))[0];
+    assert.isDefined(terminalError);
+    assert.include(terminalError, "after execution started");
+    assert.include(terminalError, "simulated success settlement failure");
+  }),
+);
+
+it.effect("requeues a replay-safe claim when success settlement fails", () =>
+  Effect.gen(function* () {
+    const now = DateTime.formatIso(yield* DateTime.now);
+    const effectId = "effect:worker-replay-safe-settlement-failure";
+    const workerId = "worker-replay-safe-settlement-failure";
+    const claimedEffect: OrchestrationEffectV2 = {
+      id: effectId,
+      commandId: CommandId.make("command:worker-replay-safe-settlement-failure"),
+      threadId: ThreadId.make("thread:worker-replay-safe-settlement-failure"),
+      request: { type: "terminal.cleanup" },
+      status: "running",
+      attemptCount: 1,
+      availableAt: now,
+      leaseOwner: workerId,
+      leaseExpiresAt: now,
+      createdAt: now,
+      updatedAt: now,
+      completedAt: null,
+      lastError: null,
+    };
+    const retries = yield* Ref.make(0);
+    const terminalizations = yield* Ref.make(0);
+    const outboxLayer = Layer.mock(EffectOutboxV2)({
+      claimNext: () => Effect.succeed(Option.some(claimedEffect)),
+      get: () => Effect.succeed(Option.some(claimedEffect)),
+      awaitCancellation: () => Effect.never,
+      clearCancellation: () => Effect.void,
+      succeed: () =>
+        Effect.fail(
+          new EffectOutboxError({
+            operation: "succeed",
+            effectId,
+            cause: "simulated replay-safe settlement failure",
+          }),
+        ),
+      retry: () => Ref.update(retries, (count) => count + 1).pipe(Effect.as(true)),
+      fail: () => Ref.update(terminalizations, (count) => count + 1).pipe(Effect.as(true)),
+    });
+    const executorLayer = Layer.succeed(
+      OrchestrationEffectExecutorV2,
+      OrchestrationEffectExecutorV2.of({ execute: () => Effect.void }),
+    );
+    const workerLayer = effectWorkerLayerWithOptions({ workerId }).pipe(
+      Layer.provide(Layer.merge(outboxLayer, executorLayer)),
+    );
+
+    const exit = yield* OrchestrationEffectWorkerV2.pipe(
+      Effect.flatMap((worker) => worker.runOnce),
+      Effect.provide(workerLayer),
+      Effect.exit,
+    );
+
+    assert.isTrue(Exit.isFailure(exit));
+    assert.equal(yield* Ref.get(retries), 1);
+    assert.equal(yield* Ref.get(terminalizations), 0);
+  }),
+);
+
+it.effect("keeps a process-bound executor failure retryable when retry settlement fails", () =>
+  Effect.gen(function* () {
+    const now = DateTime.formatIso(yield* DateTime.now);
+    const effectId = "effect:worker-process-bound-retry-settlement-failure";
+    const workerId = "worker-process-bound-retry-settlement-failure";
+    const claimedEffect: OrchestrationEffectV2 = {
+      id: effectId,
+      commandId: CommandId.make("command:worker-process-bound-retry-settlement-failure"),
+      threadId: ThreadId.make("thread:worker-process-bound-retry-settlement-failure"),
+      request: {
+        type: "provider-turn.start",
+        runId: RunId.make("run:worker-process-bound-retry-settlement-failure"),
+      },
+      status: "running",
+      attemptCount: 1,
+      availableAt: now,
+      leaseOwner: workerId,
+      leaseExpiresAt: now,
+      createdAt: now,
+      updatedAt: now,
+      completedAt: null,
+      lastError: null,
+    };
+    const retryAttempts = yield* Ref.make(0);
+    const terminalizations = yield* Ref.make(0);
+    const outboxLayer = Layer.mock(EffectOutboxV2)({
+      claimNext: () => Effect.succeed(Option.some(claimedEffect)),
+      get: () => Effect.succeed(Option.some(claimedEffect)),
+      awaitCancellation: () => Effect.never,
+      clearCancellation: () => Effect.void,
+      retry: () =>
+        Ref.updateAndGet(retryAttempts, (count) => count + 1).pipe(
+          Effect.flatMap((attempt) =>
+            attempt === 1
+              ? Effect.fail(
+                  new EffectOutboxError({
+                    operation: "retry",
+                    effectId,
+                    cause: "simulated retry settlement failure",
+                  }),
+                )
+              : Effect.succeed(true),
+          ),
+        ),
+      fail: () => Ref.update(terminalizations, (count) => count + 1).pipe(Effect.as(true)),
+    });
+    const executorLayer = Layer.succeed(
+      OrchestrationEffectExecutorV2,
+      OrchestrationEffectExecutorV2.of({
+        execute: () =>
+          Effect.fail(
+            new OrchestrationEffectExecutionError({
+              effectId,
+              effectType: claimedEffect.request.type,
+              cause: "simulated provider execution failure",
+            }),
+          ),
+      }),
+    );
+    const workerLayer = effectWorkerLayerWithOptions({ workerId }).pipe(
+      Layer.provide(Layer.merge(outboxLayer, executorLayer)),
+    );
+
+    const exit = yield* OrchestrationEffectWorkerV2.pipe(
+      Effect.flatMap((worker) => worker.runOnce),
+      Effect.provide(workerLayer),
+      Effect.exit,
+    );
+
+    assert.isTrue(Exit.isFailure(exit));
+    assert.equal(yield* Ref.get(retryAttempts), 2);
+    assert.equal(yield* Ref.get(terminalizations), 0);
+  }),
+);
+
+it.effect("keeps a max-attempt replay-safe failure terminal when fail settlement fails", () =>
+  Effect.gen(function* () {
+    const now = DateTime.formatIso(yield* DateTime.now);
+    const effectId = "effect:worker-replay-safe-terminal-settlement-failure";
+    const workerId = "worker-replay-safe-terminal-settlement-failure";
+    const claimedEffect: OrchestrationEffectV2 = {
+      id: effectId,
+      commandId: CommandId.make("command:worker-replay-safe-terminal-settlement-failure"),
+      threadId: ThreadId.make("thread:worker-replay-safe-terminal-settlement-failure"),
+      request: { type: "terminal.cleanup" },
+      status: "running",
+      attemptCount: 5,
+      availableAt: now,
+      leaseOwner: workerId,
+      leaseExpiresAt: now,
+      createdAt: now,
+      updatedAt: now,
+      completedAt: null,
+      lastError: null,
+    };
+    const failAttempts = yield* Ref.make(0);
+    const retries = yield* Ref.make(0);
+    const outboxLayer = Layer.mock(EffectOutboxV2)({
+      claimNext: () => Effect.succeed(Option.some(claimedEffect)),
+      get: () => Effect.succeed(Option.some(claimedEffect)),
+      awaitCancellation: () => Effect.never,
+      clearCancellation: () => Effect.void,
+      fail: () =>
+        Ref.updateAndGet(failAttempts, (count) => count + 1).pipe(
+          Effect.flatMap((attempt) =>
+            attempt === 1
+              ? Effect.fail(
+                  new EffectOutboxError({
+                    operation: "fail",
+                    effectId,
+                    cause: "simulated terminal settlement failure",
+                  }),
+                )
+              : Effect.succeed(true),
+          ),
+        ),
+      retry: () => Ref.update(retries, (count) => count + 1).pipe(Effect.as(true)),
+    });
+    const executorLayer = Layer.succeed(
+      OrchestrationEffectExecutorV2,
+      OrchestrationEffectExecutorV2.of({
+        execute: () =>
+          Effect.fail(
+            new OrchestrationEffectExecutionError({
+              effectId,
+              effectType: claimedEffect.request.type,
+              cause: "simulated terminal cleanup failure",
+            }),
+          ),
+      }),
+    );
+    const workerLayer = effectWorkerLayerWithOptions({ workerId, maxAttempts: 5 }).pipe(
+      Layer.provide(Layer.merge(outboxLayer, executorLayer)),
+    );
+
+    const exit = yield* OrchestrationEffectWorkerV2.pipe(
+      Effect.flatMap((worker) => worker.runOnce),
+      Effect.provide(workerLayer),
+      Effect.exit,
+    );
+
+    assert.isTrue(Exit.isFailure(exit));
+    assert.equal(yield* Ref.get(failAttempts), 2);
+    assert.equal(yield* Ref.get(retries), 0);
+  }),
+);
+
+it.effect("uses durable deadlines, notifications, and a slow liveness poll", () =>
+  Effect.gen(function* () {
+    const attempts = yield* Ref.make(0);
+    const available = yield* Queue.unbounded<void>();
+    const now = yield* DateTime.now;
+    const nextClaimableAt = yield* Ref.make<Option.Option<DateTime.Utc>>(
+      Option.some(DateTime.add(now, { milliseconds: 100 })),
+    );
+    const worker = OrchestrationEffectWorkerV2.of({
+      awaitWork: Queue.take(available),
+      runOnce: Effect.gen(function* () {
+        const count = yield* Ref.updateAndGet(attempts, (current) => current + 1);
+        if (count === 2) {
+          yield* Ref.set(nextClaimableAt, Option.some(DateTime.add(now, { milliseconds: 5_000 })));
+        }
+        if (count === 3) yield* Ref.set(nextClaimableAt, Option.none());
+        return false;
+      }),
+      nextClaimableAt: Ref.get(nextClaimableAt),
+      drain: () => Effect.succeed(0),
+    });
+    const awaitAttempts = Effect.fnUntraced(function* (expected: number) {
+      while ((yield* Ref.get(attempts)) < expected) {
+        yield* Effect.yieldNow;
+      }
+    });
+
+    yield* runDaemonWithOptions({
+      concurrency: 1,
+      livenessPollIntervalMs: 1_000,
+    }).pipe(Effect.provideService(OrchestrationEffectWorkerV2, worker), Effect.forkScoped);
+
+    yield* awaitAttempts(1);
+    yield* TestClock.adjust("99 millis");
+    assert.equal(yield* Ref.get(attempts), 1);
+
+    yield* TestClock.adjust("1 millis");
+    yield* awaitAttempts(2);
+    yield* TestClock.adjust("999 millis");
+    assert.equal(yield* Ref.get(attempts), 2);
+
+    yield* Queue.offer(available, undefined);
+    yield* awaitAttempts(3);
+    yield* TestClock.adjust("999 millis");
+    assert.equal(yield* Ref.get(attempts), 3);
+
+    yield* TestClock.adjust("1 millis");
+    yield* awaitAttempts(4);
+  }).pipe(Effect.provide(TestClock.layer())),
+);
+
+it.effect("does not hot-loop when a claim fails", () =>
+  Effect.gen(function* () {
+    const attempts = yield* Ref.make(0);
+    const now = yield* DateTime.now;
+    const worker = OrchestrationEffectWorkerV2.of({
+      awaitWork: Effect.never,
+      runOnce: Ref.update(attempts, (count) => count + 1).pipe(
+        Effect.andThen(
+          new OrchestrationEffectWorkerError({
+            operation: "claim",
+            cause: "simulated database failure",
+          }),
+        ),
+      ),
+      nextClaimableAt: Effect.succeed(Option.some(now)),
+      drain: () => Effect.succeed(0),
+    });
+
+    yield* runDaemonWithOptions({
+      concurrency: 1,
+      livenessPollIntervalMs: 1_000,
+    }).pipe(Effect.provideService(OrchestrationEffectWorkerV2, worker), Effect.forkScoped);
+
+    while ((yield* Ref.get(attempts)) < 1) yield* Effect.yieldNow;
+    yield* TestClock.adjust("999 millis");
+    assert.equal(yield* Ref.get(attempts), 1);
+    yield* TestClock.adjust("1 millis");
+    while ((yield* Ref.get(attempts)) < 2) yield* Effect.yieldNow;
+  }).pipe(Effect.provide(TestClock.layer())),
+);
+
+it.effect("backs off briefly when a due deadline loses a claim race", () =>
+  Effect.gen(function* () {
+    const attempts = yield* Ref.make(0);
+    const now = yield* DateTime.now;
+    const worker = OrchestrationEffectWorkerV2.of({
+      awaitWork: Effect.never,
+      runOnce: Ref.update(attempts, (count) => count + 1).pipe(Effect.as(false)),
+      nextClaimableAt: Effect.succeed(Option.some(now)),
+      drain: () => Effect.succeed(0),
+    });
+
+    yield* runDaemonWithOptions({
+      concurrency: 1,
+      livenessPollIntervalMs: 1_000,
+    }).pipe(Effect.provideService(OrchestrationEffectWorkerV2, worker), Effect.forkScoped);
+
+    while ((yield* Ref.get(attempts)) < 1) yield* Effect.yieldNow;
+    yield* TestClock.adjust("24 millis");
+    assert.equal(yield* Ref.get(attempts), 1);
+    yield* TestClock.adjust("1 millis");
+    while ((yield* Ref.get(attempts)) < 2) yield* Effect.yieldNow;
+  }).pipe(Effect.provide(TestClock.layer())),
+);
+
+it.effect("detaches a handed-off session only after the old turn terminalizes", () =>
+  Effect.gen(function* () {
+    const now = yield* DateTime.now;
+    const events = yield* Ref.make<ReadonlyArray<string>>([]);
+
+    yield* Effect.gen(function* () {
+      const executor = yield* OrchestrationEffectExecutorV2;
+      yield* executor.execute(restartEffect(now, { type: "detach" }));
+    }).pipe(Effect.provide(makeExecutorLayer({ events })));
+
+    assert.deepEqual(yield* Ref.get(events), ["interrupt", "detach", "start"]);
+  }),
+);
+
+it.effect("executes durable thread title generation effects", () =>
+  Effect.gen(function* () {
+    const now = DateTime.formatIso(yield* DateTime.now);
+    const events = yield* Ref.make<ReadonlyArray<string>>([]);
+    const commandId = CommandId.make("command:title-generation");
+    const effect: OrchestrationEffectV2 = {
+      id: "effect:title-generation",
+      commandId,
+      threadId,
+      request: {
+        type: "thread-title.generate",
+        kind: { type: "initial", messageId: MessageId.make("message:title-generation") },
+      },
+      status: "running",
+      attemptCount: 1,
+      availableAt: now,
+      leaseOwner: "test-worker",
+      leaseExpiresAt: now,
+      createdAt: now,
+      updatedAt: now,
+      completedAt: null,
+      lastError: null,
+    };
+
+    yield* Effect.gen(function* () {
+      const executor = yield* OrchestrationEffectExecutorV2;
+      yield* executor.execute(effect);
+    }).pipe(Effect.provide(makeExecutorLayer({ events })));
+
+    assert.deepEqual(yield* Ref.get(events), [`title:initial:${commandId}`]);
+  }),
+);
+
+it.effect("safely retries after replacement cleanup succeeds and start fails", () =>
+  Effect.gen(function* () {
+    const now = yield* DateTime.now;
+    const events = yield* Ref.make<ReadonlyArray<string>>([]);
+    const failFirstStart = yield* Ref.make(true);
+    const effect = restartEffect(now, {
+      type: "replace",
+      replacementProviderSessionId: replacementSessionId,
+    });
+    const layer = makeExecutorLayer({ events, failFirstStart });
+
+    const first = yield* Effect.gen(function* () {
+      const executor = yield* OrchestrationEffectExecutorV2;
+      return yield* Effect.exit(executor.execute(effect));
+    }).pipe(Effect.provide(layer));
+    assert.isTrue(Exit.isFailure(first));
+
+    yield* Effect.gen(function* () {
+      const executor = yield* OrchestrationEffectExecutorV2;
+      yield* executor.execute(effect);
+    }).pipe(Effect.provide(layer));
+
+    assert.deepEqual(yield* Ref.get(events), [
+      `interrupt:${replacementSessionId}`,
+      "detach",
+      "start",
+      `interrupt:${replacementSessionId}`,
+      "detach",
+      "start",
+    ]);
+  }),
+);
diff --git a/apps/server/src/orchestration-v2/EffectWorker.ts b/apps/server/src/orchestration-v2/EffectWorker.ts
new file mode 100644
index 000000000000..1139d2fea3b1
--- /dev/null
+++ b/apps/server/src/orchestration-v2/EffectWorker.ts
@@ -0,0 +1,671 @@
+import * as Cause from "effect/Cause";
+import * as Context from "effect/Context";
+import * as DateTime from "effect/DateTime";
+import * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as Layer from "effect/Layer";
+import * as Metric from "effect/Metric";
+import * as Option from "effect/Option";
+import * as Schema from "effect/Schema";
+
+import {
+  increment,
+  metricAttributes,
+  orchestrationEffectClaimsTotal,
+  orchestrationEffectQueueWait,
+} from "../observability/Metrics.ts";
+import { RunFinalizationService } from "./RunFinalizationService.ts";
+import { ResourceCleanupService } from "./ResourceCleanupService.ts";
+import {
+  EffectOutboxV2,
+  REPLAY_SAFE_EFFECT_TYPES_AFTER_PROCESS_LOSS,
+  type OrchestrationEffectV2,
+} from "./EffectOutbox.ts";
+import { CheckpointRollbackServiceV2 } from "./CheckpointRollbackService.ts";
+import { ProviderSessionManagerV2 } from "./ProviderSessionManager.ts";
+import { ProviderTurnControlServiceV2 } from "./ProviderTurnControlService.ts";
+import { ProviderTurnStartServiceV2 } from "./ProviderTurnStartService.ts";
+import { RuntimeRequestServiceV2 } from "./RuntimeRequestService.ts";
+import { ThreadTitleRegenerationService } from "./ThreadTitleRegenerationService.ts";
+
+export class OrchestrationEffectExecutionError extends Schema.TaggedErrorClass<OrchestrationEffectExecutionError>()(
+  "OrchestrationEffectExecutionError",
+  {
+    effectId: Schema.String,
+    effectType: Schema.String,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {}
+
+/**
+ * Pure interrupt races with hard process teardown or a dead session produce
+ * "not active" protocol errors. Retrying those only delays recovery.
+ *
+ * Do not apply this to `provider-turn.restart`: that compound effect also runs
+ * detach and start. Swallowing a start failure that happens to mention
+ * "is not active" would drop the outbox item without ever starting the
+ * replacement turn.
+ */
+export function isNonRetryableProviderTurnControlFailure(
+  effectType: string,
+  errorText: string,
+): boolean {
+  if (effectType !== "provider-turn.interrupt") {
+    return false;
+  }
+  return (
+    /is not active/i.test(errorText) ||
+    /hard teardown is already in progress/i.test(errorText) ||
+    /treating as already interrupted/i.test(errorText) ||
+    /treating as already stopped/i.test(errorText)
+  );
+}
+
+export interface OrchestrationEffectExecutorV2Shape {
+  readonly execute: (
+    effect: OrchestrationEffectV2,
+  ) => Effect.Effect<void, OrchestrationEffectExecutionError>;
+}
+
+export class OrchestrationEffectExecutorV2 extends Context.Service<
+  OrchestrationEffectExecutorV2,
+  OrchestrationEffectExecutorV2Shape
+>()("t3/orchestration-v2/EffectWorker/OrchestrationEffectExecutorV2") {}
+
+export const executorLayer: Layer.Layer<
+  OrchestrationEffectExecutorV2,
+  never,
+  | ProviderSessionManagerV2
+  | RunFinalizationService
+  | CheckpointRollbackServiceV2
+  | ProviderTurnControlServiceV2
+  | ProviderTurnStartServiceV2
+  | RuntimeRequestServiceV2
+  | ThreadTitleRegenerationService
+> = Layer.effect(
+  OrchestrationEffectExecutorV2,
+  Effect.gen(function* () {
+    const runFinalization = yield* RunFinalizationService;
+    const resourceCleanup = yield* ResourceCleanupService;
+    const checkpointRollback = yield* CheckpointRollbackServiceV2;
+    const providerSessions = yield* ProviderSessionManagerV2;
+    const providerTurnControl = yield* ProviderTurnControlServiceV2;
+    const providerTurnStart = yield* ProviderTurnStartServiceV2;
+    const runtimeRequests = yield* RuntimeRequestServiceV2;
+    const threadTitleRegeneration = yield* ThreadTitleRegenerationService;
+    return OrchestrationEffectExecutorV2.of({
+      execute: (effect) => {
+        switch (effect.request.type) {
+          case "provider-session.detach":
+            return providerSessions
+              .detach({
+                providerSessionId: effect.request.providerSessionId,
+                threadId: effect.threadId,
+                ...(effect.request.detail === undefined ? {} : { detail: effect.request.detail }),
+                ...(effect.request.revokeMcpCredential === undefined
+                  ? {}
+                  : { revokeMcpCredential: effect.request.revokeMcpCredential }),
+              })
+              .pipe(
+                Effect.mapError(
+                  (cause) =>
+                    new OrchestrationEffectExecutionError({
+                      effectId: effect.id,
+                      effectType: effect.request.type,
+                      cause,
+                    }),
+                ),
+              );
+          case "provider-turn.start":
+            return providerTurnStart
+              .start({ threadId: effect.threadId, runId: effect.request.runId })
+              .pipe(
+                Effect.mapError(
+                  (cause) =>
+                    new OrchestrationEffectExecutionError({
+                      effectId: effect.id,
+                      effectType: effect.request.type,
+                      cause,
+                    }),
+                ),
+              );
+          case "provider-turn.interrupt":
+            return providerTurnControl
+              .interrupt({
+                threadId: effect.threadId,
+                providerSessionId: effect.request.providerSessionId,
+                providerThreadId: effect.request.providerThreadId,
+                providerTurnId: effect.request.providerTurnId,
+              })
+              .pipe(
+                Effect.mapError(
+                  (cause) =>
+                    new OrchestrationEffectExecutionError({
+                      effectId: effect.id,
+                      effectType: effect.request.type,
+                      cause,
+                    }),
+                ),
+              );
+          case "provider-turn.steer":
+            return providerTurnControl
+              .steer({
+                threadId: effect.threadId,
+                providerSessionId: effect.request.providerSessionId,
+                providerThreadId: effect.request.providerThreadId,
+                providerTurnId: effect.request.providerTurnId,
+                messageId: effect.request.messageId,
+              })
+              .pipe(
+                Effect.mapError(
+                  (cause) =>
+                    new OrchestrationEffectExecutionError({
+                      effectId: effect.id,
+                      effectType: effect.request.type,
+                      cause,
+                    }),
+                ),
+              );
+          case "provider-turn.restart":
+            return providerTurnControl
+              .interruptAndAwaitTerminal({
+                threadId: effect.threadId,
+                providerSessionId: effect.request.providerSessionId,
+                providerThreadId: effect.request.providerThreadId,
+                providerTurnId: effect.request.providerTurnId,
+                interruptedAttemptId: effect.request.interruptedAttemptId,
+                ...(effect.request.sessionTransition?.type === "replace"
+                  ? {
+                      replacementProviderSessionId:
+                        effect.request.sessionTransition.replacementProviderSessionId,
+                    }
+                  : {}),
+              })
+              .pipe(
+                Effect.andThen(
+                  effect.request.sessionTransition?.type === "replace"
+                    ? providerSessions.detach({
+                        providerSessionId: effect.request.providerSessionId,
+                        threadId: effect.threadId,
+                        detail: "Selection change requires a provider session restart.",
+                      })
+                    : effect.request.sessionTransition?.type === "detach"
+                      ? providerSessions.detach({
+                          providerSessionId: effect.request.providerSessionId,
+                          threadId: effect.threadId,
+                          detail: "Provider thread handoff replaced this session binding.",
+                        })
+                      : Effect.void,
+                ),
+                Effect.andThen(
+                  providerTurnStart.start({
+                    threadId: effect.threadId,
+                    runId: effect.request.runId,
+                  }),
+                ),
+                Effect.mapError(
+                  (cause) =>
+                    new OrchestrationEffectExecutionError({
+                      effectId: effect.id,
+                      effectType: effect.request.type,
+                      cause,
+                    }),
+                ),
+              );
+          case "runtime-request.respond":
+            return runtimeRequests
+              .respond({
+                threadId: effect.threadId,
+                providerSessionId: effect.request.providerSessionId,
+                requestId: effect.request.requestId,
+                ...(effect.request.decision === undefined
+                  ? {}
+                  : { decision: effect.request.decision }),
+                ...(effect.request.answers === undefined
+                  ? {}
+                  : { answers: effect.request.answers }),
+              })
+              .pipe(
+                Effect.mapError(
+                  (cause) =>
+                    new OrchestrationEffectExecutionError({
+                      effectId: effect.id,
+                      effectType: effect.request.type,
+                      cause,
+                    }),
+                ),
+              );
+          case "provider-thread.rollback":
+            return checkpointRollback
+              .execute({
+                threadId: effect.threadId,
+                providerThreadId: effect.request.providerThreadId,
+                checkpointId: effect.request.checkpointId,
+                scopeId: effect.request.scopeId,
+              })
+              .pipe(
+                Effect.mapError(
+                  (cause) =>
+                    new OrchestrationEffectExecutionError({
+                      effectId: effect.id,
+                      effectType: effect.request.type,
+                      cause,
+                    }),
+                ),
+              );
+          case "checkpoint.capture":
+            return runFinalization
+              .finalize({
+                threadId: effect.threadId,
+                runId: effect.request.runId,
+                scopeId: effect.request.scopeId,
+              })
+              .pipe(
+                Effect.mapError(
+                  (cause) =>
+                    new OrchestrationEffectExecutionError({
+                      effectId: effect.id,
+                      effectType: effect.request.type,
+                      cause,
+                    }),
+                ),
+              );
+          case "terminal.cleanup":
+            return resourceCleanup.cleanupTerminals(effect.threadId).pipe(
+              Effect.mapError(
+                (cause) =>
+                  new OrchestrationEffectExecutionError({
+                    effectId: effect.id,
+                    effectType: effect.request.type,
+                    cause,
+                  }),
+              ),
+            );
+          case "attachment.cleanup":
+            return resourceCleanup.cleanupAttachments(effect.request.attachmentIds).pipe(
+              Effect.mapError(
+                (cause) =>
+                  new OrchestrationEffectExecutionError({
+                    effectId: effect.id,
+                    effectType: effect.request.type,
+                    cause,
+                  }),
+              ),
+            );
+          case "thread-title.generate":
+            return threadTitleRegeneration
+              .execute({
+                threadId: effect.threadId,
+                requestId: effect.commandId,
+                kind: effect.request.kind,
+              })
+              .pipe(
+                Effect.mapError(
+                  (cause) =>
+                    new OrchestrationEffectExecutionError({
+                      effectId: effect.id,
+                      effectType: effect.request.type,
+                      cause,
+                    }),
+                ),
+              );
+        }
+      },
+    });
+  }),
+);
+
+export class OrchestrationEffectWorkerError extends Schema.TaggedErrorClass<OrchestrationEffectWorkerError>()(
+  "OrchestrationEffectWorkerError",
+  {
+    operation: Schema.String,
+    effectId: Schema.optional(Schema.String),
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {}
+
+const isOrchestrationEffectWorkerError = Schema.is(OrchestrationEffectWorkerError);
+
+export interface OrchestrationEffectWorkerV2Shape {
+  readonly awaitWork: Effect.Effect<void>;
+  readonly runOnce: Effect.Effect<boolean, OrchestrationEffectWorkerError>;
+  readonly nextClaimableAt: Effect.Effect<
+    Option.Option<DateTime.Utc>,
+    OrchestrationEffectWorkerError
+  >;
+  readonly drain: (maxEffects?: number) => Effect.Effect<number, OrchestrationEffectWorkerError>;
+}
+
+export class OrchestrationEffectWorkerV2 extends Context.Service<
+  OrchestrationEffectWorkerV2,
+  OrchestrationEffectWorkerV2Shape
+>()("t3/orchestration-v2/EffectWorker/OrchestrationEffectWorkerV2") {}
+
+export interface OrchestrationEffectWorkerOptions {
+  readonly workerId?: string;
+  readonly leaseDurationMs?: number;
+  readonly maxAttempts?: number;
+}
+
+export const layerWithOptions = (
+  options: OrchestrationEffectWorkerOptions = {},
+): Layer.Layer<
+  OrchestrationEffectWorkerV2,
+  never,
+  EffectOutboxV2 | OrchestrationEffectExecutorV2
+> =>
+  Layer.effect(
+    OrchestrationEffectWorkerV2,
+    Effect.gen(function* () {
+      const outbox = yield* EffectOutboxV2;
+      const executor = yield* OrchestrationEffectExecutorV2;
+      const workerId = options.workerId ?? `orchestration-v2:${process.pid}`;
+      const leaseDurationMs = Math.max(1, options.leaseDurationMs ?? 30_000);
+      const maxAttempts = Math.max(1, options.maxAttempts ?? 5);
+      const wasCancelled = (effectId: string) =>
+        outbox.get(effectId).pipe(
+          Effect.map(
+            Option.match({
+              onNone: () => false,
+              onSome: (effect) => effect.status === "cancelled",
+            }),
+          ),
+        );
+      const requeueClaim = (effect: OrchestrationEffectV2, cause: Cause.Cause<unknown>) =>
+        Cause.hasInterruptsOnly(cause)
+          ? Effect.void
+          : outbox
+              .retry({
+                effectId: effect.id,
+                workerId,
+                error: `Worker failed before settling the claimed effect: ${Cause.pretty(cause)}`,
+                delayMs: 0,
+              })
+              .pipe(
+                Effect.flatMap((requeued) =>
+                  requeued
+                    ? Effect.logWarning("Requeued effect after unexpected worker failure", {
+                        effectId: effect.id,
+                        effectType: effect.request.type,
+                      })
+                    : Effect.logWarning("Could not requeue effect after worker lost its lease", {
+                        effectId: effect.id,
+                        effectType: effect.request.type,
+                      }),
+                ),
+                Effect.catchCause((requeueCause) =>
+                  Effect.logError("Failed to requeue effect after unexpected worker failure", {
+                    effectId: effect.id,
+                    effectType: effect.request.type,
+                    error: Cause.pretty(requeueCause),
+                  }),
+                ),
+              );
+      const terminalizeClaim = (effect: OrchestrationEffectV2, cause: Cause.Cause<unknown>) => {
+        if (Cause.hasInterruptsOnly(cause)) return Effect.void;
+        return outbox
+          .fail({
+            effectId: effect.id,
+            workerId,
+            error: `Worker failed to settle a process-bound effect after execution started: ${Cause.pretty(cause)}`,
+          })
+          .pipe(
+            Effect.flatMap((failed) =>
+              failed
+                ? Effect.logError("Terminalized process-bound effect after settlement failure", {
+                    effectId: effect.id,
+                    effectType: effect.request.type,
+                  })
+                : Effect.logWarning(
+                    "Could not terminalize process-bound effect after worker lost its lease",
+                    {
+                      effectId: effect.id,
+                      effectType: effect.request.type,
+                    },
+                  ),
+            ),
+            Effect.catchCause((failCause) =>
+              Effect.logError(
+                "Failed to terminalize process-bound effect after settlement failure",
+                {
+                  effectId: effect.id,
+                  effectType: effect.request.type,
+                  error: Cause.pretty(failCause),
+                },
+              ),
+            ),
+          );
+      };
+      const recoverPostSuccessSettlement = (
+        effect: OrchestrationEffectV2,
+        cause: Cause.Cause<unknown>,
+      ) =>
+        REPLAY_SAFE_EFFECT_TYPES_AFTER_PROCESS_LOSS.some(
+          (effectType) => effectType === effect.request.type,
+        )
+          ? requeueClaim(effect, cause)
+          : terminalizeClaim(effect, cause);
+
+      const runOnce = Effect.gen(function* () {
+        const claimExit = yield* Effect.exit(outbox.claimNext({ workerId, leaseDurationMs }));
+        yield* increment(orchestrationEffectClaimsTotal, {
+          result: Exit.isFailure(claimExit)
+            ? "error"
+            : Option.isNone(claimExit.value)
+              ? "empty"
+              : "claimed",
+        });
+        if (Exit.isFailure(claimExit)) return yield* Effect.failCause(claimExit.cause);
+        const claimed = claimExit.value;
+        if (Option.isNone(claimed)) {
+          return false;
+        }
+        const effect = claimed.value;
+        // Arm the process-local cancellation signal before re-reading durable
+        // state. A cancellation that commits after the row read has begun can
+        // then still win the execution race instead of falling into the gap
+        // between the read and signal registration.
+        const cancellation = outbox
+          .awaitCancellation(effect.id)
+          .pipe(Effect.as("cancelled" as const));
+        const cancelledBeforeExecution = yield* Effect.gen(function* () {
+          const claimedAt = DateTime.toEpochMillis(yield* DateTime.now);
+          const eligibleAt = Math.max(
+            DateTime.toEpochMillis(DateTime.makeUnsafe(effect.createdAt)),
+            DateTime.toEpochMillis(DateTime.makeUnsafe(effect.availableAt)),
+          );
+          yield* Metric.update(
+            Metric.withAttributes(
+              orchestrationEffectQueueWait,
+              metricAttributes({ effect_type: effect.request.type }),
+            ),
+            Duration.millis(Math.max(0, claimedAt - eligibleAt)),
+          );
+          // Cancellation can commit after the durable claim but before the
+          // process-local Deferred is registered. Re-read the authoritative row
+          // once before starting external work; later cancellations use the
+          // Deferred raced below.
+          if (yield* wasCancelled(effect.id)) {
+            yield* outbox.clearCancellation(effect.id);
+            return true;
+          }
+          return false;
+        }).pipe(Effect.onError((cause) => requeueClaim(effect, cause)));
+        if (cancelledBeforeExecution) return true;
+
+        const execution = executor.execute(effect).pipe(Effect.as("executed" as const));
+        const exit = yield* Effect.exit(Effect.raceFirst(execution, cancellation)).pipe(
+          Effect.ensuring(outbox.clearCancellation(effect.id)),
+        );
+        if (Exit.isSuccess(exit) && exit.value === "cancelled") {
+          return true;
+        }
+        if (Exit.isSuccess(exit)) {
+          return yield* Effect.gen(function* () {
+            const completed = yield* outbox.succeed({ effectId: effect.id, workerId });
+            if (!completed) {
+              if (yield* wasCancelled(effect.id)) return true;
+              return yield* new OrchestrationEffectWorkerError({
+                operation: "complete",
+                effectId: effect.id,
+                cause: "The worker no longer owns the effect lease.",
+              });
+            }
+            return true;
+          }).pipe(Effect.onError((cause) => recoverPostSuccessSettlement(effect, cause)));
+        }
+
+        const error = Cause.pretty(exit.cause);
+        const nonRetryable = isNonRetryableProviderTurnControlFailure(effect.request.type, error);
+        yield* Effect.logWarning("Orchestration effect execution failed", {
+          effectId: effect.id,
+          effectType: effect.request.type,
+          attemptCount: effect.attemptCount,
+          nonRetryable,
+          error,
+        });
+        // Prefer succeed for terminal interrupt races so the outbox does not
+        // keep a failed interrupt around; fail only when we must not retry.
+        const updated = nonRetryable
+          ? yield* outbox
+              .succeed({ effectId: effect.id, workerId })
+              .pipe(Effect.onError((cause) => terminalizeClaim(effect, cause)))
+          : effect.attemptCount >= maxAttempts
+            ? yield* outbox
+                .fail({ effectId: effect.id, workerId, error })
+                .pipe(Effect.onError((cause) => terminalizeClaim(effect, cause)))
+            : yield* outbox
+                .retry({
+                  effectId: effect.id,
+                  workerId,
+                  error,
+                  delayMs: Math.min(30_000, 100 * 2 ** Math.max(0, effect.attemptCount - 1)),
+                })
+                .pipe(Effect.onError((cause) => requeueClaim(effect, cause)));
+        if (!updated) {
+          if (yield* wasCancelled(effect.id)) return true;
+          return yield* new OrchestrationEffectWorkerError({
+            operation: "reschedule",
+            effectId: effect.id,
+            cause: "The worker no longer owns the effect lease.",
+          });
+        }
+        return true;
+      }).pipe(
+        Effect.mapError((cause) =>
+          isOrchestrationEffectWorkerError(cause)
+            ? cause
+            : new OrchestrationEffectWorkerError({ operation: "run", cause }),
+        ),
+      );
+
+      return OrchestrationEffectWorkerV2.of({
+        awaitWork: outbox.awaitAvailable,
+        runOnce,
+        nextClaimableAt: outbox.nextClaimableAt.pipe(
+          Effect.mapError(
+            (cause) =>
+              new OrchestrationEffectWorkerError({
+                operation: "next-claimable",
+                cause,
+              }),
+          ),
+        ),
+        drain: (maxEffects = Number.MAX_SAFE_INTEGER) =>
+          Effect.gen(function* () {
+            let completed = 0;
+            while (completed < maxEffects && (yield* runOnce)) {
+              completed += 1;
+            }
+            return completed;
+          }),
+      });
+    }),
+  );
+
+export const layer = layerWithOptions();
+
+export interface OrchestrationEffectDaemonOptions {
+  readonly concurrency?: number;
+  readonly livenessPollIntervalMs?: number;
+}
+
+export const DEFAULT_EFFECT_WORKER_CONCURRENCY = 4;
+export const DEFAULT_EFFECT_WORKER_LIVENESS_POLL_INTERVAL_MS = 30_000;
+
+export const runDaemonWithOptions = (options: OrchestrationEffectDaemonOptions = {}) =>
+  Effect.scoped(
+    Effect.gen(function* () {
+      const worker = yield* OrchestrationEffectWorkerV2;
+      const requestedConcurrency = options.concurrency ?? DEFAULT_EFFECT_WORKER_CONCURRENCY;
+      const concurrency = Number.isFinite(requestedConcurrency)
+        ? Math.max(1, Math.floor(requestedConcurrency))
+        : DEFAULT_EFFECT_WORKER_CONCURRENCY;
+      const requestedLivenessPollIntervalMs =
+        options.livenessPollIntervalMs ?? DEFAULT_EFFECT_WORKER_LIVENESS_POLL_INTERVAL_MS;
+      const livenessPollIntervalMs = Number.isFinite(requestedLivenessPollIntervalMs)
+        ? Math.max(1, Math.floor(requestedLivenessPollIntervalMs))
+        : DEFAULT_EFFECT_WORKER_LIVENESS_POLL_INTERVAL_MS;
+      // Post-commit notifications are the low-latency path. `availableAt` is the
+      // durable retry schedule, and the long liveness poll only recovers from a
+      // missed in-process notification or work inserted by another process.
+      const runWorker = Effect.gen(function* () {
+        while (true) {
+          const outcome = yield* worker.runOnce.pipe(
+            Effect.map((worked) => (worked ? ("worked" as const) : ("idle" as const))),
+            Effect.catchCause((cause) =>
+              Effect.logWarning("Orchestration effect worker failed", cause).pipe(
+                Effect.as("failed" as const),
+              ),
+            ),
+          );
+          if (outcome === "worked") {
+            yield* Effect.yieldNow;
+            continue;
+          }
+          if (outcome === "failed") {
+            // A due row can remain visible when a claim UPDATE fails. Do not
+            // feed that past deadline back into the scheduler and retry at the
+            // one-millisecond floor; let transient database failures cool off.
+            yield* Effect.sleep(Duration.millis(Math.min(1_000, livenessPollIntervalMs)));
+            continue;
+          }
+
+          const nextClaimableAt = yield* worker.nextClaimableAt.pipe(
+            Effect.catchCause((cause) =>
+              Effect.logWarning(
+                "Failed to read the next orchestration effect deadline",
+                cause,
+              ).pipe(Effect.as(Option.none<DateTime.Utc>())),
+            ),
+          );
+          const now = DateTime.toEpochMillis(yield* DateTime.now);
+          const sleepMs = Option.match(nextClaimableAt, {
+            onNone: () => livenessPollIntervalMs,
+            onSome: (availableAt) => {
+              const untilAvailable = DateTime.toEpochMillis(availableAt) - now;
+              return Math.min(livenessPollIntervalMs, untilAvailable > 0 ? untilAvailable : 25);
+            },
+          });
+          yield* Effect.raceFirst(
+            worker.awaitWork.pipe(Effect.as("notified" as const)),
+            Effect.sleep(Duration.millis(sleepMs)).pipe(Effect.as("scheduled" as const)),
+          );
+        }
+      });
+
+      return yield* Effect.all(
+        Array.from({ length: concurrency }, () => runWorker),
+        {
+          concurrency: "unbounded",
+          discard: true,
+        },
+      );
+    }),
+  );
+
+export const runDaemon = runDaemonWithOptions();
+
+export const daemonLayer: Layer.Layer<never, never, OrchestrationEffectWorkerV2> =
+  Layer.effectDiscard(runDaemon.pipe(Effect.forkScoped));
diff --git a/apps/server/src/orchestration-v2/EventSink.ts b/apps/server/src/orchestration-v2/EventSink.ts
new file mode 100644
index 000000000000..a9f3db0062f1
--- /dev/null
+++ b/apps/server/src/orchestration-v2/EventSink.ts
@@ -0,0 +1,662 @@
+import {
+  CommandId,
+  type OrchestrationV2Run,
+  OrchestrationV2DomainEvent,
+  OrchestrationV2StoredEvent,
+  ProviderThreadId,
+  RunAttemptId,
+  RunId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as Context from "effect/Context";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as PubSub from "effect/PubSub";
+import * as Schema from "effect/Schema";
+import * as Stream from "effect/Stream";
+import * as SqlClient from "effect/unstable/sql/SqlClient";
+
+import {
+  CommandReceiptStoreV2,
+  type CommandReceiptV2,
+  layer as commandReceiptStoreLayer,
+} from "./CommandReceiptStore.ts";
+import {
+  EffectOutboxV2,
+  type OrchestrationEffectRequestV2,
+  type PendingOrchestrationEffectV2,
+  layer as effectOutboxLayer,
+} from "./EffectOutbox.ts";
+import { EventStoreV2 } from "./EventStore.ts";
+import {
+  ORCHESTRATION_V2_PROJECTION_SCHEMA_VERSION,
+  ProjectionStoreV2,
+} from "./ProjectionStore.ts";
+import {
+  TurnItemPositionStoreV2,
+  layer as turnItemPositionStoreLayer,
+} from "./TurnItemPositionStore.ts";
+
+/**
+ * ERRORS
+ */
+export class EventSinkWriteError extends Schema.TaggedErrorClass<EventSinkWriteError>()(
+  "EventSinkWriteError",
+  {
+    eventCount: Schema.Number,
+    commandId: Schema.optional(CommandId),
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to write ${this.eventCount} orchestration V2 event(s).`;
+  }
+}
+
+export class EventSinkStreamError extends Schema.TaggedErrorClass<EventSinkStreamError>()(
+  "EventSinkStreamError",
+  {
+    threadId: Schema.optional(ThreadId),
+    afterSequence: Schema.optional(Schema.Number),
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return this.threadId === undefined
+      ? "Failed to stream orchestration V2 events."
+      : `Failed to stream orchestration V2 events for thread ${this.threadId}.`;
+  }
+}
+
+export const EventSinkV2Error = Schema.Union([EventSinkWriteError, EventSinkStreamError]);
+export type EventSinkV2Error = typeof EventSinkV2Error.Type;
+
+/**
+ * SERVICE DEFINITION
+ */
+export interface EventSinkV2Shape {
+  readonly write: (input: {
+    readonly commandId?: CommandId;
+    readonly events: ReadonlyArray<OrchestrationV2DomainEvent>;
+  }) => Effect.Effect<ReadonlyArray<OrchestrationV2StoredEvent>, EventSinkV2Error>;
+  readonly writeWithEffects: (input: {
+    readonly commandId?: CommandId;
+    readonly events: ReadonlyArray<OrchestrationV2DomainEvent>;
+    readonly effects: ReadonlyArray<PendingOrchestrationEffectV2>;
+  }) => Effect.Effect<ReadonlyArray<OrchestrationV2StoredEvent>, EventSinkV2Error>;
+  readonly writeIfRunCurrent: (input: {
+    readonly commandId?: CommandId;
+    readonly threadId: ThreadId;
+    readonly runId: RunId;
+    readonly activeAttemptId: RunAttemptId;
+    readonly expectedStatus: OrchestrationV2Run["status"];
+    readonly events: ReadonlyArray<OrchestrationV2DomainEvent>;
+  }) => Effect.Effect<
+    {
+      readonly committed: boolean;
+      readonly storedEvents: ReadonlyArray<OrchestrationV2StoredEvent>;
+    },
+    EventSinkV2Error
+  >;
+  /**
+   * Atomically commit only when the provider thread is still owned by the
+   * expected run attempt and ordinal. Used for late post-terminal
+   * provider_thread updates so a completed or superseded attempt cannot clobber
+   * a newer attempt that already claimed the thread.
+   */
+  readonly writeIfProviderThreadOwner: (input: {
+    readonly commandId?: CommandId;
+    readonly providerThreadId: ProviderThreadId;
+    readonly runId: RunId;
+    readonly activeAttemptId: RunAttemptId;
+    readonly expectedLastRunOrdinal: number;
+    readonly events: ReadonlyArray<OrchestrationV2DomainEvent>;
+  }) => Effect.Effect<
+    {
+      readonly committed: boolean;
+      readonly storedEvents: ReadonlyArray<OrchestrationV2StoredEvent>;
+    },
+    EventSinkV2Error
+  >;
+  readonly commitCommand: (input: {
+    readonly commandId: CommandId;
+    readonly threadId: ThreadId;
+    readonly commandType: string;
+    readonly acceptedAt: DateTime.Utc;
+    readonly events: ReadonlyArray<OrchestrationV2DomainEvent>;
+    readonly effects: ReadonlyArray<PendingOrchestrationEffectV2>;
+    readonly cancelUnsettledEffects?: {
+      readonly effectTypes: ReadonlyArray<OrchestrationEffectRequestV2["type"]>;
+      readonly reason: string;
+    };
+  }) => Effect.Effect<
+    {
+      readonly receipt: CommandReceiptV2;
+      readonly storedEvents: ReadonlyArray<OrchestrationV2StoredEvent>;
+      readonly committed: boolean;
+      readonly cancelledEffectCount: number;
+    },
+    EventSinkV2Error
+  >;
+  readonly commitRejectedCommand: (input: {
+    readonly commandId: CommandId;
+    readonly threadId: ThreadId;
+    readonly commandType: string;
+    readonly rejectedAt: DateTime.Utc;
+    readonly error: string;
+  }) => Effect.Effect<CommandReceiptV2, EventSinkV2Error>;
+  readonly stream: (input?: {
+    readonly threadId?: ThreadId;
+    readonly afterSequence?: number;
+  }) => Stream.Stream<OrchestrationV2StoredEvent, EventSinkV2Error>;
+  readonly latestSequence: (input?: {
+    readonly threadId?: ThreadId;
+  }) => Effect.Effect<number, EventSinkV2Error>;
+  readonly readByCommandId: (input: {
+    readonly commandId: CommandId;
+  }) => Stream.Stream<OrchestrationV2StoredEvent, EventSinkV2Error>;
+}
+
+export class EventSinkV2 extends Context.Service<EventSinkV2, EventSinkV2Shape>()(
+  "t3/orchestration-v2/EventSink/EventSinkV2",
+) {}
+
+/**
+ * IMPLEMENTATIONS
+ */
+const baseLayer: Layer.Layer<
+  EventSinkV2,
+  never,
+  | CommandReceiptStoreV2
+  | EffectOutboxV2
+  | EventStoreV2
+  | ProjectionStoreV2
+  | SqlClient.SqlClient
+  | TurnItemPositionStoreV2
+> = Layer.effect(
+  EventSinkV2,
+  Effect.gen(function* () {
+    const sql = yield* SqlClient.SqlClient;
+    const commandReceipts = yield* CommandReceiptStoreV2;
+    const effectOutbox = yield* EffectOutboxV2;
+    const eventStore = yield* EventStoreV2;
+    const projectionStore = yield* ProjectionStoreV2;
+    const turnItemPositions = yield* TurnItemPositionStoreV2;
+    const liveEvents = yield* PubSub.unbounded<OrchestrationV2StoredEvent>();
+
+    const normalizeEvents = (events: ReadonlyArray<OrchestrationV2DomainEvent>) => {
+      const runOrdinals = new Map(
+        events.flatMap((event) =>
+          event.type === "run.created" || event.type === "run.updated"
+            ? [[event.payload.id, event.payload.ordinal] as const]
+            : [],
+        ),
+      );
+      return Effect.forEach(
+        events,
+        (event): Effect.Effect<OrchestrationV2DomainEvent, unknown> =>
+          event.type === "turn-item.updated"
+            ? turnItemPositions
+                .normalize(
+                  event.payload,
+                  event.payload.runId === null ? undefined : runOrdinals.get(event.payload.runId),
+                )
+                .pipe(Effect.map((payload) => ({ ...event, payload })))
+            : Effect.succeed(event),
+        { concurrency: 1 },
+      );
+    };
+
+    const applyStoredEvents = (storedEvents: ReadonlyArray<OrchestrationV2StoredEvent>) =>
+      Effect.gen(function* () {
+        yield* Effect.forEach(storedEvents, (stored) => projectionStore.apply(stored.event), {
+          concurrency: 1,
+        });
+        const sequence = storedEvents.at(-1)?.sequence;
+        if (sequence !== undefined) {
+          const now = DateTime.formatIso(yield* DateTime.now);
+          yield* sql`
+            INSERT INTO orchestration_v2_projection_metadata (
+              projection_name,
+              schema_version,
+              last_sequence,
+              updated_at
+            )
+            VALUES (
+              'thread-projections',
+              ${ORCHESTRATION_V2_PROJECTION_SCHEMA_VERSION},
+              ${sequence},
+              ${now}
+            )
+            ON CONFLICT(projection_name)
+            DO UPDATE SET
+              schema_version = excluded.schema_version,
+              last_sequence = excluded.last_sequence,
+              updated_at = excluded.updated_at
+          `;
+        }
+      });
+
+    const writeEffect = Effect.fn("orchestrationV2.EventSink.write")(function* (
+      input: Parameters<EventSinkV2Shape["writeWithEffects"]>[0],
+    ) {
+      yield* Effect.annotateCurrentSpan({
+        "orchestration_v2.command_id": input.commandId ?? null,
+        "orchestration_v2.event_count": input.events.length,
+        "orchestration_v2.thread_id": input.events[0]?.threadId ?? null,
+      });
+
+      const storedEvents = yield* sql.withTransaction(
+        Effect.gen(function* () {
+          const normalized = yield* normalizeEvents(input.events);
+          const committed = yield* eventStore.append({
+            ...(input.commandId === undefined ? {} : { commandId: input.commandId }),
+            events: normalized,
+          });
+          yield* applyStoredEvents(committed);
+          yield* effectOutbox.enqueue(input.effects);
+          return committed;
+        }),
+      );
+      if (input.effects.length > 0) {
+        yield* effectOutbox.notifyAvailable(input.effects.length);
+      }
+      yield* eventStore.publishCommitted(storedEvents);
+      yield* PubSub.publishAll(liveEvents, storedEvents);
+      return storedEvents;
+    });
+
+    const writeIfRunCurrentEffect = Effect.fn("orchestrationV2.EventSink.writeIfRunCurrent")(
+      function* (input: Parameters<EventSinkV2Shape["writeIfRunCurrent"]>[0]) {
+        yield* Effect.annotateCurrentSpan({
+          "orchestration_v2.command_id": input.commandId ?? null,
+          "orchestration_v2.event_count": input.events.length,
+          "orchestration_v2.run_id": input.runId,
+          "orchestration_v2.thread_id": input.threadId,
+        });
+
+        const result = yield* sql.withTransaction(
+          Effect.gen(function* () {
+            const rows = yield* sql<{
+              readonly status: string;
+              readonly active_attempt_id: string | null;
+            }>`
+            SELECT
+              status,
+              json_extract(payload_json, '$.activeAttemptId') AS active_attempt_id
+            FROM orchestration_v2_projection_runs
+            WHERE run_id = ${input.runId}
+              AND thread_id = ${input.threadId}
+            LIMIT 1
+          `;
+            const current = rows[0];
+            if (
+              current === undefined ||
+              current.status !== input.expectedStatus ||
+              current.active_attempt_id !== input.activeAttemptId
+            ) {
+              return {
+                committed: false as const,
+                storedEvents: [] as ReadonlyArray<OrchestrationV2StoredEvent>,
+              };
+            }
+
+            const normalized = yield* normalizeEvents(input.events);
+            const storedEvents = yield* eventStore.append({
+              ...(input.commandId === undefined ? {} : { commandId: input.commandId }),
+              events: normalized,
+            });
+            yield* applyStoredEvents(storedEvents);
+            return { committed: true as const, storedEvents };
+          }),
+        );
+        if (result.committed) {
+          yield* eventStore.publishCommitted(result.storedEvents);
+          yield* PubSub.publishAll(liveEvents, result.storedEvents);
+        }
+        return result;
+      },
+    );
+
+    const writeIfProviderThreadOwnerEffect = Effect.fn(
+      "orchestrationV2.EventSink.writeIfProviderThreadOwner",
+    )(function* (input: Parameters<EventSinkV2Shape["writeIfProviderThreadOwner"]>[0]) {
+      yield* Effect.annotateCurrentSpan({
+        "orchestration_v2.command_id": input.commandId ?? null,
+        "orchestration_v2.event_count": input.events.length,
+        "orchestration_v2.provider_thread_id": input.providerThreadId,
+        "orchestration_v2.run_id": input.runId,
+        "orchestration_v2.active_attempt_id": input.activeAttemptId,
+        "orchestration_v2.expected_last_run_ordinal": input.expectedLastRunOrdinal,
+      });
+
+      const result = yield* sql.withTransaction(
+        Effect.gen(function* () {
+          const rows = yield* sql<{
+            readonly active_attempt_id: string | null;
+            readonly last_run_ordinal: number | null;
+          }>`
+            SELECT
+              json_extract(r.payload_json, '$.activeAttemptId') AS active_attempt_id,
+              p.last_run_ordinal
+            FROM orchestration_v2_projection_provider_threads p
+            JOIN orchestration_v2_projection_runs r
+              ON r.run_id = ${input.runId}
+             AND r.thread_id = p.thread_id
+            WHERE p.provider_thread_id = ${input.providerThreadId}
+            LIMIT 1
+          `;
+          const current = rows[0];
+          if (
+            current === undefined ||
+            current.active_attempt_id !== input.activeAttemptId ||
+            current.last_run_ordinal !== input.expectedLastRunOrdinal
+          ) {
+            return {
+              committed: false as const,
+              storedEvents: [] as ReadonlyArray<OrchestrationV2StoredEvent>,
+            };
+          }
+
+          const normalized = yield* normalizeEvents(input.events);
+          const storedEvents = yield* eventStore.append({
+            ...(input.commandId === undefined ? {} : { commandId: input.commandId }),
+            events: normalized,
+          });
+          yield* applyStoredEvents(storedEvents);
+          return { committed: true as const, storedEvents };
+        }),
+      );
+      if (result.committed) {
+        yield* eventStore.publishCommitted(result.storedEvents);
+        yield* PubSub.publishAll(liveEvents, result.storedEvents);
+      }
+      return result;
+    });
+
+    const existingCommandResult = (commandId: CommandId) =>
+      Effect.gen(function* () {
+        const existing = yield* commandReceipts.getByCommandId(commandId);
+        if (Option.isNone(existing)) {
+          return yield* Effect.die(
+            new Error(`Command receipt ${commandId} disappeared during its transaction.`),
+          );
+        }
+        const storedEvents = yield* eventStore.readByCommandId({ commandId }).pipe(
+          Stream.runCollect,
+          Effect.map((events): ReadonlyArray<OrchestrationV2StoredEvent> => Array.from(events)),
+        );
+        return { receipt: existing.value, storedEvents };
+      });
+
+    const commitCommandEffect = Effect.fn("orchestrationV2.EventSink.commitCommand")(function* (
+      input: Parameters<EventSinkV2Shape["commitCommand"]>[0],
+    ) {
+      const result = yield* sql.withTransaction(
+        Effect.gen(function* () {
+          const reserved = yield* commandReceipts.insertIfAbsent({
+            commandId: input.commandId,
+            threadId: input.threadId,
+            commandType: input.commandType,
+            acceptedAt: input.acceptedAt,
+            resultSequence: 0,
+            status: "accepted",
+            error: null,
+          });
+          if (!reserved) {
+            const existing = yield* existingCommandResult(input.commandId);
+            return { ...existing, committed: false as const, cancelledEffectIds: [] };
+          }
+
+          const normalized = yield* normalizeEvents(input.events);
+          const storedEvents = yield* eventStore.append({
+            commandId: input.commandId,
+            events: normalized,
+          });
+          const sequence = storedEvents.at(-1)?.sequence;
+          if (sequence === undefined) {
+            return yield* Effect.die(
+              new Error(`Command ${input.commandId} produced no orchestration events.`),
+            );
+          }
+          yield* applyStoredEvents(storedEvents);
+          yield* effectOutbox.enqueue(input.effects);
+          const receipt: CommandReceiptV2 = {
+            commandId: input.commandId,
+            threadId: input.threadId,
+            commandType: input.commandType,
+            acceptedAt: input.acceptedAt,
+            resultSequence: sequence,
+            status: "accepted",
+            error: null,
+          };
+          yield* commandReceipts.upsert(receipt);
+          const cancelledEffectIds =
+            input.cancelUnsettledEffects === undefined
+              ? []
+              : yield* effectOutbox.cancelUnsettled({
+                  threadId: input.threadId,
+                  ...input.cancelUnsettledEffects,
+                });
+          return { receipt, storedEvents, committed: true as const, cancelledEffectIds };
+        }),
+      );
+      yield* effectOutbox.signalCancellations(result.cancelledEffectIds);
+      if (result.committed && input.effects.length > 0) {
+        yield* effectOutbox.notifyAvailable(input.effects.length);
+      }
+      if (result.committed) {
+        yield* eventStore.publishCommitted(result.storedEvents);
+        yield* PubSub.publishAll(liveEvents, result.storedEvents);
+      }
+      return {
+        receipt: result.receipt,
+        storedEvents: result.storedEvents,
+        committed: result.committed,
+        cancelledEffectCount: result.cancelledEffectIds.length,
+      };
+    });
+
+    const commitRejectedCommandEffect = Effect.fn(
+      "orchestrationV2.EventSink.commitRejectedCommand",
+    )(function* (input: Parameters<EventSinkV2Shape["commitRejectedCommand"]>[0]) {
+      return yield* sql.withTransaction(
+        Effect.gen(function* () {
+          const sequence = yield* eventStore.latestSequence({ threadId: input.threadId });
+          const receipt: CommandReceiptV2 = {
+            commandId: input.commandId,
+            threadId: input.threadId,
+            commandType: input.commandType,
+            acceptedAt: input.rejectedAt,
+            resultSequence: sequence,
+            status: "rejected",
+            error: input.error,
+          };
+          const inserted = yield* commandReceipts.insertIfAbsent(receipt);
+          if (inserted) {
+            return receipt;
+          }
+          const existing = yield* commandReceipts.getByCommandId(input.commandId);
+          return Option.getOrElse(existing, () => receipt);
+        }),
+      );
+    });
+
+    const catchUp = (input: {
+      readonly afterSequence: number;
+      readonly throughSequence: number;
+      readonly threadId?: ThreadId;
+    }): Stream.Stream<OrchestrationV2StoredEvent, unknown> => {
+      const pageSize = 256;
+      const loop = (afterSequence: number): Stream.Stream<OrchestrationV2StoredEvent, unknown> =>
+        Stream.unwrap(
+          eventStore
+            .read({
+              afterSequence,
+              throughSequence: input.throughSequence,
+              ...(input.threadId === undefined ? {} : { threadId: input.threadId }),
+              limit: pageSize,
+            })
+            .pipe(
+              Stream.runCollect,
+              Effect.map((chunk) => Array.from(chunk)),
+              Effect.map((events) => {
+                if (events.length === 0) {
+                  return Stream.empty;
+                }
+                const current = Stream.fromIterable(events);
+                const last = events.at(-1)?.sequence ?? input.throughSequence;
+                return events.length < pageSize || last >= input.throughSequence
+                  ? current
+                  : Stream.concat(current, loop(last));
+              }),
+            ),
+        );
+      return loop(input.afterSequence);
+    };
+
+    const stream = (input?: { readonly threadId?: ThreadId; readonly afterSequence?: number }) =>
+      Stream.unwrap(
+        Effect.gen(function* () {
+          // Subscribe first, then capture the database high-water mark. Events
+          // committed between those operations are buffered by the subscription.
+          const subscription = yield* PubSub.subscribe(liveEvents);
+          const highWater = yield* eventStore.latestSequence();
+          const afterSequence = input?.afterSequence ?? 0;
+          const replay = catchUp({
+            afterSequence,
+            throughSequence: highWater,
+            ...(input?.threadId === undefined ? {} : { threadId: input.threadId }),
+          });
+          const live = Stream.fromSubscription(subscription).pipe(
+            Stream.filter((stored) => stored.sequence > Math.max(highWater, afterSequence)),
+            Stream.filter(
+              (stored) => input?.threadId === undefined || stored.event.threadId === input.threadId,
+            ),
+          );
+          return Stream.concat(replay, live);
+        }),
+      );
+
+    return EventSinkV2.of({
+      write: (input) =>
+        writeEffect({ ...input, effects: [] }).pipe(
+          Effect.mapError(
+            (cause) =>
+              new EventSinkWriteError({
+                eventCount: input.events.length,
+                ...(input.commandId === undefined ? {} : { commandId: input.commandId }),
+                cause,
+              }),
+          ),
+        ),
+      writeWithEffects: (input) =>
+        writeEffect(input).pipe(
+          Effect.mapError(
+            (cause) =>
+              new EventSinkWriteError({
+                eventCount: input.events.length,
+                ...(input.commandId === undefined ? {} : { commandId: input.commandId }),
+                cause,
+              }),
+          ),
+        ),
+      writeIfRunCurrent: (input) =>
+        writeIfRunCurrentEffect(input).pipe(
+          Effect.mapError(
+            (cause) =>
+              new EventSinkWriteError({
+                eventCount: input.events.length,
+                ...(input.commandId === undefined ? {} : { commandId: input.commandId }),
+                cause,
+              }),
+          ),
+        ),
+      writeIfProviderThreadOwner: (input) =>
+        writeIfProviderThreadOwnerEffect(input).pipe(
+          Effect.mapError(
+            (cause) =>
+              new EventSinkWriteError({
+                eventCount: input.events.length,
+                ...(input.commandId === undefined ? {} : { commandId: input.commandId }),
+                cause,
+              }),
+          ),
+        ),
+      commitCommand: (input) =>
+        commitCommandEffect(input).pipe(
+          Effect.mapError(
+            (cause) =>
+              new EventSinkWriteError({
+                commandId: input.commandId,
+                eventCount: input.events.length,
+                cause,
+              }),
+          ),
+        ),
+      commitRejectedCommand: (input) =>
+        commitRejectedCommandEffect(input).pipe(
+          Effect.mapError(
+            (cause) =>
+              new EventSinkWriteError({
+                commandId: input.commandId,
+                eventCount: 0,
+                cause,
+              }),
+          ),
+        ),
+      stream: (input) =>
+        stream(input).pipe(
+          Stream.mapError(
+            (cause) =>
+              new EventSinkStreamError({
+                ...(input?.threadId === undefined ? {} : { threadId: input.threadId }),
+                ...(input?.afterSequence === undefined
+                  ? {}
+                  : { afterSequence: input.afterSequence }),
+                cause,
+              }),
+          ),
+        ),
+      latestSequence: (input) =>
+        eventStore.latestSequence(input).pipe(
+          Effect.mapError(
+            (cause) =>
+              new EventSinkStreamError({
+                ...(input?.threadId === undefined ? {} : { threadId: input.threadId }),
+                cause,
+              }),
+          ),
+        ),
+      readByCommandId: (input) =>
+        eventStore.readByCommandId(input).pipe(
+          Stream.mapError(
+            (cause) =>
+              new EventSinkStreamError({
+                cause,
+              }),
+          ),
+        ),
+    } satisfies EventSinkV2Shape);
+  }),
+);
+
+/**
+ * Event sink layer for application compositions that already own the
+ * persistence services. Keeping the outbox instance shared with the worker is
+ * important because enqueue notifications are in-memory wakeups backed by the
+ * durable SQL queue.
+ */
+export const layerFromStores = baseLayer;
+
+export const layer: Layer.Layer<
+  EventSinkV2,
+  never,
+  EventStoreV2 | ProjectionStoreV2 | SqlClient.SqlClient
+> = baseLayer.pipe(
+  Layer.provide(
+    Layer.mergeAll(commandReceiptStoreLayer, effectOutboxLayer, turnItemPositionStoreLayer),
+  ),
+);
diff --git a/apps/server/src/orchestration-v2/EventStore.ts b/apps/server/src/orchestration-v2/EventStore.ts
new file mode 100644
index 000000000000..495fa4cbaec2
--- /dev/null
+++ b/apps/server/src/orchestration-v2/EventStore.ts
@@ -0,0 +1,139 @@
+import {
+  CommandId,
+  OrchestrationV2DomainEvent,
+  OrchestrationV2StoredEvent,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Schema from "effect/Schema";
+import * as Stream from "effect/Stream";
+import type * as SqlClient from "effect/unstable/sql/SqlClient";
+
+import { OrchestrationEventStoreLive } from "../persistence/Layers/OrchestrationEventStore.ts";
+import { OrchestrationEventStore } from "../persistence/Services/OrchestrationEventStore.ts";
+
+export class EventStoreAppendEventsError extends Schema.TaggedErrorClass<EventStoreAppendEventsError>()(
+  "EventStoreAppendEventsError",
+  {
+    eventCount: Schema.Number,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to append ${this.eventCount} agent orchestration event(s).`;
+  }
+}
+
+export class EventStoreReadEventsError extends Schema.TaggedErrorClass<EventStoreReadEventsError>()(
+  "EventStoreReadEventsError",
+  {
+    afterSequence: Schema.optional(Schema.Number),
+    threadId: Schema.optional(ThreadId),
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return this.threadId === undefined
+      ? "Failed to read agent orchestration events."
+      : `Failed to read agent orchestration events for thread ${this.threadId}.`;
+  }
+}
+
+export const EventStoreV2Error = Schema.Union([
+  EventStoreAppendEventsError,
+  EventStoreReadEventsError,
+]);
+export type EventStoreV2Error = typeof EventStoreV2Error.Type;
+
+export interface EventStoreV2Shape {
+  readonly append: (input: {
+    readonly commandId?: CommandId;
+    readonly events: ReadonlyArray<OrchestrationV2DomainEvent>;
+  }) => Effect.Effect<ReadonlyArray<OrchestrationV2StoredEvent>, EventStoreV2Error>;
+  readonly read: (input?: {
+    readonly afterSequence?: number;
+    readonly throughSequence?: number;
+    readonly threadId?: ThreadId;
+    readonly limit?: number;
+  }) => Stream.Stream<OrchestrationV2StoredEvent, EventStoreV2Error>;
+  readonly readByCommandId: (input: {
+    readonly commandId: CommandId;
+  }) => Stream.Stream<OrchestrationV2StoredEvent, EventStoreV2Error>;
+  readonly latestSequence: (input?: {
+    readonly threadId?: ThreadId;
+  }) => Effect.Effect<number, EventStoreV2Error>;
+  readonly publishCommitted: (
+    events: ReadonlyArray<OrchestrationV2StoredEvent>,
+  ) => Effect.Effect<void>;
+}
+
+export class EventStoreV2 extends Context.Service<EventStoreV2, EventStoreV2Shape>()(
+  "t3/orchestration-v2/EventStore/EventStoreV2",
+) {}
+
+const baseLayer: Layer.Layer<EventStoreV2, never, OrchestrationEventStore> = Layer.effect(
+  EventStoreV2,
+  Effect.gen(function* () {
+    const applicationEvents = yield* OrchestrationEventStore;
+
+    const read: EventStoreV2Shape["read"] = (input) =>
+      applicationEvents
+        .readAgentEvents({
+          ...(input?.afterSequence === undefined ? {} : { afterSequence: input.afterSequence }),
+          ...(input?.throughSequence === undefined
+            ? {}
+            : { throughSequence: input.throughSequence }),
+          ...(input?.threadId === undefined ? {} : { threadId: input.threadId }),
+          ...(input?.limit === undefined ? {} : { limit: input.limit }),
+        })
+        .pipe(
+          Stream.mapError(
+            (cause) =>
+              new EventStoreReadEventsError({
+                ...(input?.afterSequence === undefined
+                  ? {}
+                  : { afterSequence: input.afterSequence }),
+                ...(input?.threadId === undefined ? {} : { threadId: input.threadId }),
+                cause,
+              }),
+          ),
+        );
+
+    return EventStoreV2.of({
+      append: (input) =>
+        applicationEvents.appendAgentEvents(input).pipe(
+          Effect.mapError(
+            (cause) =>
+              new EventStoreAppendEventsError({
+                eventCount: input.events.length,
+                cause,
+              }),
+          ),
+        ),
+      read,
+      readByCommandId: ({ commandId }) =>
+        applicationEvents
+          .readAgentEvents({ commandId })
+          .pipe(Stream.mapError((cause) => new EventStoreReadEventsError({ cause }))),
+      latestSequence: (input) =>
+        applicationEvents.latestAgentSequence(input?.threadId).pipe(
+          Effect.mapError(
+            (cause) =>
+              new EventStoreReadEventsError({
+                ...(input?.threadId === undefined ? {} : { threadId: input.threadId }),
+                cause,
+              }),
+          ),
+        ),
+      publishCommitted: applicationEvents.publishCommitted,
+    });
+  }),
+);
+
+export const layer: Layer.Layer<EventStoreV2, never, SqlClient.SqlClient> = baseLayer.pipe(
+  Layer.provide(OrchestrationEventStoreLive),
+);
+
+export const layerFromOrchestrationEventStore = baseLayer;
diff --git a/apps/server/src/orchestration-v2/FoundationPersistence.test.ts b/apps/server/src/orchestration-v2/FoundationPersistence.test.ts
new file mode 100644
index 000000000000..fdb244174846
--- /dev/null
+++ b/apps/server/src/orchestration-v2/FoundationPersistence.test.ts
@@ -0,0 +1,2100 @@
+import { assert, it } from "@effect/vitest";
+import {
+  CheckpointId,
+  CheckpointRef,
+  CheckpointScopeId,
+  CommandId,
+  ContextTransferId,
+  EventId,
+  MessageId,
+  type ModelSelection,
+  NodeId,
+  type OrchestrationV2AppThread,
+  type OrchestrationV2DomainEvent,
+  type OrchestrationV2Run,
+  ProjectId,
+  ProviderDriverKind,
+  ProviderInstanceId,
+  ProviderSessionId,
+  ProviderThreadId,
+  RunAttemptId,
+  RunId,
+  ThreadId,
+  TurnItemId,
+} from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+import * as Fiber from "effect/Fiber";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Ref from "effect/Ref";
+import * as Stream from "effect/Stream";
+import * as TestClock from "effect/testing/TestClock";
+import * as Tracer from "effect/Tracer";
+import * as SqlClient from "effect/unstable/sql/SqlClient";
+
+import { SqlitePersistenceMemory } from "../persistence/Layers/Sqlite.ts";
+import { CodexProviderCapabilitiesV2 } from "./Adapters/CodexAdapterV2.ts";
+import { CommandReceiptStoreV2, layer as commandReceiptStoreLayer } from "./CommandReceiptStore.ts";
+import { EffectOutboxV2, layer as effectOutboxLayer } from "./EffectOutbox.ts";
+import {
+  layerWithOptions as effectWorkerLayerWithOptions,
+  OrchestrationEffectExecutionError,
+  OrchestrationEffectExecutorV2,
+  OrchestrationEffectWorkerV2,
+  runDaemonWithOptions as runEffectWorkerDaemonWithOptions,
+} from "./EffectWorker.ts";
+import { EventSinkV2, layer as eventSinkLayer } from "./EventSink.ts";
+import { EventStoreV2, layer as eventStoreLayer } from "./EventStore.ts";
+import { layer as idAllocatorLayer } from "./IdAllocator.ts";
+import {
+  ProjectionMaintenanceV2,
+  layer as projectionMaintenanceLayer,
+} from "./ProjectionMaintenance.ts";
+import { ProjectionStoreV2, layer as projectionStoreLayer } from "./ProjectionStore.ts";
+import * as ProviderRuntimeRecovery from "./ProviderRuntimeRecoveryService.ts";
+
+const databaseLayer = SqlitePersistenceMemory;
+const eventStoreProvided = eventStoreLayer.pipe(Layer.provideMerge(databaseLayer));
+const projectionStoreProvided = projectionStoreLayer.pipe(Layer.provideMerge(databaseLayer));
+const storesProvided = Layer.mergeAll(databaseLayer, eventStoreProvided, projectionStoreProvided);
+const eventSinkProvided = eventSinkLayer.pipe(Layer.provide(storesProvided));
+const effectOutboxProvided = effectOutboxLayer.pipe(Layer.provide(databaseLayer));
+const commandReceiptStoreProvided = commandReceiptStoreLayer.pipe(Layer.provide(databaseLayer));
+const projectionMaintenanceProvided = projectionMaintenanceLayer.pipe(
+  Layer.provide(storesProvided),
+);
+const TestLayer = Layer.mergeAll(
+  storesProvided,
+  eventSinkProvided,
+  effectOutboxProvided,
+  commandReceiptStoreProvided,
+  idAllocatorLayer,
+  projectionMaintenanceProvided,
+);
+
+const providerInstanceId = ProviderInstanceId.make("codex");
+const providerDriver = ProviderDriverKind.make("codex");
+const modelSelection = {
+  instanceId: providerInstanceId,
+  model: "gpt-5.4",
+} satisfies ModelSelection;
+
+function makeThread(threadId: ThreadId, now: DateTime.Utc): OrchestrationV2AppThread {
+  return {
+    createdBy: "user",
+    creationSource: "web",
+    id: threadId,
+    projectId: ProjectId.make(`project:${threadId}`),
+    title: `Thread ${threadId}`,
+    providerInstanceId,
+    modelSelection,
+    runtimeMode: "full-access",
+    interactionMode: "default",
+    branch: null,
+    worktreePath: null,
+    activeProviderThreadId: null,
+    lineage: {
+      parentThreadId: null,
+      relationshipToParent: null,
+      rootThreadId: threadId,
+    },
+    forkedFrom: null,
+    createdAt: now,
+    updatedAt: now,
+    archivedAt: null,
+    settledOverride: null,
+    settledAt: null,
+    lastVisitedAt: null,
+    deletedAt: null,
+  };
+}
+
+function threadCreatedEvent(input: {
+  readonly id: string;
+  readonly thread: OrchestrationV2AppThread;
+  readonly now: DateTime.Utc;
+}): OrchestrationV2DomainEvent {
+  return {
+    id: EventId.make(input.id),
+    type: "thread.created",
+    threadId: input.thread.id,
+    providerInstanceId,
+    occurredAt: input.now,
+    payload: input.thread,
+  };
+}
+
+it.layer(TestLayer)("orchestration V2 foundation persistence", (it) => {
+  it.effect("paginates catch-up beyond the event-store read limit", () =>
+    Effect.gen(function* () {
+      const eventSink = yield* EventSinkV2;
+      const now = yield* DateTime.now;
+      const threadId = ThreadId.make("thread:foundation-large-catch-up");
+      const thread = makeThread(threadId, now);
+      const eventCount = 1_005;
+      const events: Array<OrchestrationV2DomainEvent> = [
+        threadCreatedEvent({ id: "event:foundation-catch-up:0", thread, now }),
+        ...Array.from({ length: eventCount - 1 }, (_, index) => ({
+          id: EventId.make(`event:foundation-catch-up:${index + 1}`),
+          type: "thread.metadata-updated" as const,
+          threadId,
+          providerInstanceId,
+          occurredAt: now,
+          payload: {
+            ...thread,
+            title: `Catch-up update ${index + 1}`,
+          },
+        })),
+      ];
+
+      yield* eventSink.write({ events });
+      const replayed = yield* eventSink.stream({ afterSequence: 0 }).pipe(
+        Stream.take(eventCount),
+        Stream.runCollect,
+        Effect.map((events) => Array.from(events)),
+      );
+
+      assert.lengthOf(replayed, eventCount);
+      assert.deepEqual(
+        replayed.map((stored) => stored.sequence),
+        Array.from({ length: eventCount }, (_, index) => index + 1),
+      );
+    }),
+  );
+
+  it.effect("does not lose or duplicate events while transitioning from catch-up to live", () =>
+    Effect.gen(function* () {
+      const eventSink = yield* EventSinkV2;
+      const now = yield* DateTime.now;
+      const threadId = ThreadId.make("thread:foundation-stream-race");
+      const thread = makeThread(threadId, now);
+      const created = yield* eventSink.write({
+        events: [threadCreatedEvent({ id: "event:foundation-stream-race:0", thread, now })],
+      });
+
+      let afterSequence = created[0]!.sequence;
+      for (let index = 1; index <= 32; index += 1) {
+        const nextEvent = {
+          id: EventId.make(`event:foundation-stream-race:${index}`),
+          type: "thread.metadata-updated" as const,
+          threadId,
+          providerInstanceId,
+          occurredAt: now,
+          payload: { ...thread, title: `Race update ${index}` },
+        } satisfies OrchestrationV2DomainEvent;
+        const reader = yield* eventSink
+          .stream({ threadId, afterSequence })
+          .pipe(Stream.runHead, Effect.forkChild);
+        yield* Effect.yieldNow;
+        const written = yield* eventSink.write({ events: [nextEvent] });
+        const received = yield* Fiber.join(reader);
+        if (Option.isNone(received)) {
+          return yield* Effect.die("The event stream ended before delivering the live event.");
+        }
+        assert.equal(received.value.sequence, written[0]?.sequence);
+        assert.equal(received.value.event.id, nextEvent.id);
+        afterSequence = received.value.sequence;
+      }
+    }),
+  );
+
+  it.effect("replays shared provider-session payloads across every bound thread", () =>
+    Effect.gen(function* () {
+      const eventSink = yield* EventSinkV2;
+      const projectionStore = yield* ProjectionStoreV2;
+      const maintenance = yield* ProjectionMaintenanceV2;
+      const now = yield* DateTime.now;
+      const firstThreadId = ThreadId.make("thread:foundation-shared-session:first");
+      const secondThreadId = ThreadId.make("thread:foundation-shared-session:second");
+      const providerSessionId = ProviderSessionId.make("provider-session:foundation:shared");
+      const firstSession = {
+        id: providerSessionId,
+        driver: providerDriver,
+        providerInstanceId,
+        status: "ready" as const,
+        cwd: "/workspace/first",
+        model: modelSelection.model,
+        capabilities: CodexProviderCapabilitiesV2,
+        createdAt: now,
+        updatedAt: now,
+        lastError: null,
+      };
+      const secondSession = { ...firstSession, cwd: "/workspace/second" };
+
+      yield* eventSink.write({
+        events: [
+          threadCreatedEvent({
+            id: "event:foundation-shared-session:first-thread",
+            thread: makeThread(firstThreadId, now),
+            now,
+          }),
+          {
+            id: EventId.make("event:foundation-shared-session:first-attachment"),
+            type: "provider-session.attached",
+            threadId: firstThreadId,
+            driver: providerDriver,
+            providerInstanceId,
+            occurredAt: now,
+            payload: firstSession,
+          },
+          threadCreatedEvent({
+            id: "event:foundation-shared-session:second-thread",
+            thread: makeThread(secondThreadId, now),
+            now,
+          }),
+          {
+            id: EventId.make("event:foundation-shared-session:second-attachment"),
+            type: "provider-session.attached",
+            threadId: secondThreadId,
+            driver: providerDriver,
+            providerInstanceId,
+            occurredAt: now,
+            payload: secondSession,
+          },
+        ],
+      });
+
+      assert.equal(
+        (yield* projectionStore.getThreadProjection(firstThreadId)).providerSessions[0]?.cwd,
+        secondSession.cwd,
+      );
+      assert.isTrue((yield* maintenance.verify).valid);
+      assert.isTrue((yield* maintenance.rebuild).valid);
+    }),
+  );
+
+  it.effect("compacts superseded state events, imported v1 events, and legacy receipts", () =>
+    Effect.gen(function* () {
+      const eventSink = yield* EventSinkV2;
+      const maintenance = yield* ProjectionMaintenanceV2;
+      const sql = yield* SqlClient.SqlClient;
+      const now = yield* DateTime.now;
+      const nowIso = DateTime.formatIso(now);
+      const threadId = ThreadId.make("thread:foundation-compact");
+      const thread = makeThread(threadId, now);
+      const messageId = MessageId.make("message:foundation-compact");
+      const threadStateEvent = (
+        suffix: string,
+        type: "thread.visited" | "thread.metadata-updated",
+      ): OrchestrationV2DomainEvent => ({
+        id: EventId.make(`event:foundation-compact:${suffix}`),
+        type,
+        threadId,
+        providerInstanceId,
+        occurredAt: now,
+        payload: { ...thread, lastVisitedAt: now },
+      });
+      const messageEvent = (suffix: string, text: string): OrchestrationV2DomainEvent => ({
+        id: EventId.make(`event:foundation-compact:${suffix}`),
+        type: "message.updated",
+        threadId,
+        occurredAt: now,
+        payload: {
+          createdBy: "user",
+          creationSource: "web",
+          id: messageId,
+          threadId,
+          runId: null,
+          nodeId: null,
+          role: "user",
+          text,
+          attachments: [],
+          streaming: false,
+          createdAt: now,
+          updatedAt: now,
+        },
+      });
+
+      yield* eventSink.write({
+        events: [
+          threadCreatedEvent({ id: "event:foundation-compact:create", thread, now }),
+          threadStateEvent("meta", "thread.metadata-updated"),
+          threadStateEvent("visit-1", "thread.visited"),
+          threadStateEvent("visit-2", "thread.visited"),
+          messageEvent("message-1", "streaming"),
+          messageEvent("message-2", "final"),
+        ],
+      });
+
+      // A fully imported legacy thread: its v1 events and pre-migration
+      // receipts are dead weight; a still-pending import keeps its rows.
+      const importedV1ThreadId = "thread:foundation-compact-v1-imported";
+      const pendingV1ThreadId = "thread:foundation-compact-v1-pending";
+      const insertV1Event = (threadIdValue: string, version: number) => sql`
+        INSERT INTO orchestration_events (
+          event_id, aggregate_kind, stream_id, stream_version, event_type,
+          occurred_at, actor_kind, payload_json, metadata_json, application_event_version
+        )
+        VALUES (
+          ${`event:v1:${threadIdValue}:${version}`}, 'thread', ${threadIdValue}, ${version},
+          'thread.message-appended', ${nowIso}, 'user', '{}', '{}', 1
+        )
+      `;
+      yield* insertV1Event(importedV1ThreadId, 1);
+      yield* insertV1Event(importedV1ThreadId, 2);
+      yield* insertV1Event(pendingV1ThreadId, 1);
+      yield* sql`
+        INSERT INTO orchestration_v2_legacy_imports (
+          thread_id, source_updated_at, shell_imported_at, transcript_imported_at,
+          imported_message_count, last_error
+        )
+        VALUES
+          (${importedV1ThreadId}, ${nowIso}, ${nowIso}, ${nowIso}, 2, NULL),
+          (${pendingV1ThreadId}, ${nowIso}, ${nowIso}, NULL, 0, NULL)
+        ON CONFLICT(thread_id) DO NOTHING
+      `;
+      yield* sql`
+        INSERT INTO orchestration_command_receipts (
+          command_id, aggregate_kind, aggregate_id, accepted_at, result_sequence, status, command_type
+        )
+        VALUES
+          ('command:foundation-compact:legacy', 'thread', ${importedV1ThreadId}, ${nowIso}, 1, 'accepted', 'legacy'),
+          ('command:foundation-compact:pending', 'thread', ${pendingV1ThreadId}, ${nowIso}, 1, 'accepted', 'legacy')
+        ON CONFLICT(command_id) DO NOTHING
+      `;
+
+      const summary = yield* maintenance.compactEventStore;
+      // meta + visit-1 (superseded thread state), message-1, and the two
+      // imported v1 events.
+      assert.isAtLeast(summary.deletedEventCount, 5);
+      assert.isAtLeast(summary.deletedReceiptCount, 1);
+
+      const remaining = yield* sql<{ readonly event_id: string }>`
+        SELECT event_id
+        FROM orchestration_events
+        WHERE aggregate_kind = 'thread'
+          AND stream_id = ${threadId}
+        ORDER BY sequence ASC
+      `;
+      assert.deepEqual(
+        remaining.map((row) => row.event_id),
+        [
+          "event:foundation-compact:create",
+          "event:foundation-compact:visit-2",
+          "event:foundation-compact:message-2",
+        ],
+      );
+
+      const remainingV1 = yield* sql<{ readonly stream_id: string }>`
+        SELECT stream_id
+        FROM orchestration_events
+        WHERE application_event_version = 1
+          AND stream_id IN (${importedV1ThreadId}, ${pendingV1ThreadId})
+      `;
+      assert.deepEqual(
+        remainingV1.map((row) => row.stream_id),
+        [pendingV1ThreadId],
+      );
+
+      const remainingReceipts = yield* sql<{ readonly command_id: string }>`
+        SELECT command_id
+        FROM orchestration_command_receipts
+        WHERE command_id IN ('command:foundation-compact:legacy', 'command:foundation-compact:pending')
+      `;
+      assert.deepEqual(
+        remainingReceipts.map((row) => row.command_id),
+        ["command:foundation-compact:pending"],
+      );
+
+      // Replay across the deletion gaps must still produce a valid projection.
+      assert.isTrue((yield* maintenance.verify).valid);
+      assert.isTrue((yield* maintenance.rebuild).valid);
+    }),
+  );
+
+  it.effect("verifies and rebuilds projections with cross-thread subagent relations", () =>
+    Effect.gen(function* () {
+      const eventSink = yield* EventSinkV2;
+      const projectionStore = yield* ProjectionStoreV2;
+      const maintenance = yield* ProjectionMaintenanceV2;
+      const now = yield* DateTime.now;
+      const parentThreadId = ThreadId.make("thread:foundation-cross-thread:parent");
+      const childThreadId = ThreadId.make("thread:foundation-cross-thread:child");
+      const childProviderThreadId = ProviderThreadId.make(
+        "provider-thread:foundation-cross-thread:child",
+      );
+      const subagentId = NodeId.make("subagent:foundation-cross-thread");
+      const spawnTransferId = ContextTransferId.make("transfer:foundation-cross-thread:spawn");
+      const resultTransferId = ContextTransferId.make("transfer:foundation-cross-thread:result");
+      const parentThread = makeThread(parentThreadId, now);
+      const childThread = {
+        ...makeThread(childThreadId, now),
+        createdBy: "agent" as const,
+        creationSource: "provider" as const,
+        lineage: {
+          parentThreadId,
+          relationshipToParent: "subagent" as const,
+          rootThreadId: parentThreadId,
+        },
+      };
+
+      yield* eventSink.write({
+        events: [
+          threadCreatedEvent({
+            id: "event:foundation-cross-thread:parent",
+            thread: parentThread,
+            now,
+          }),
+          threadCreatedEvent({
+            id: "event:foundation-cross-thread:child",
+            thread: childThread,
+            now,
+          }),
+          {
+            id: EventId.make("event:foundation-cross-thread:subagent"),
+            type: "subagent.updated",
+            threadId: parentThreadId,
+            nodeId: subagentId,
+            providerInstanceId,
+            occurredAt: now,
+            payload: {
+              id: subagentId,
+              threadId: parentThreadId,
+              runId: null,
+              parentNodeId: NodeId.make("node:foundation-cross-thread:parent"),
+              origin: "app_owned",
+              createdBy: "agent",
+              driver: providerDriver,
+              providerInstanceId,
+              providerThreadId: childProviderThreadId,
+              childThreadId,
+              nativeTaskRef: null,
+              prompt: "Inspect the child flow",
+              title: "Cross-thread child",
+              model: modelSelection.model,
+              status: "completed",
+              result: "done",
+              startedAt: now,
+              completedAt: now,
+              updatedAt: now,
+            },
+          },
+          {
+            id: EventId.make("event:foundation-cross-thread:spawn-transfer"),
+            type: "context-transfer.created",
+            threadId: childThreadId,
+            providerInstanceId,
+            occurredAt: now,
+            payload: {
+              id: spawnTransferId,
+              type: "subagent_spawn",
+              sourceThreadId: parentThreadId,
+              targetThreadId: childThreadId,
+              sourcePoint: { threadId: parentThreadId },
+              basePoint: null,
+              sourceProviderInstanceId: providerInstanceId,
+              targetProviderInstanceId: providerInstanceId,
+              targetRunId: null,
+              status: "consumed",
+              resolution: null,
+              createdBy: "agent",
+              error: null,
+              createdAt: now,
+              updatedAt: now,
+              consumedAt: now,
+            },
+          },
+          {
+            id: EventId.make("event:foundation-cross-thread:provider-thread"),
+            type: "provider-thread.updated",
+            threadId: parentThreadId,
+            driver: providerDriver,
+            providerInstanceId,
+            occurredAt: now,
+            payload: {
+              id: childProviderThreadId,
+              driver: providerDriver,
+              providerInstanceId,
+              providerSessionId: null,
+              appThreadId: childThreadId,
+              ownerNodeId: null,
+              nativeThreadRef: null,
+              nativeConversationHeadRef: null,
+              status: "idle",
+              firstRunOrdinal: 1,
+              lastRunOrdinal: 1,
+              handoffIds: [],
+              forkedFrom: null,
+              createdAt: now,
+              updatedAt: now,
+            },
+          },
+          {
+            id: EventId.make("event:foundation-cross-thread:result-transfer"),
+            type: "context-transfer.created",
+            threadId: parentThreadId,
+            providerInstanceId,
+            occurredAt: now,
+            payload: {
+              id: resultTransferId,
+              type: "subagent_result",
+              sourceThreadId: childThreadId,
+              targetThreadId: parentThreadId,
+              sourcePoint: { threadId: childThreadId },
+              basePoint: null,
+              sourceProviderInstanceId: providerInstanceId,
+              targetProviderInstanceId: providerInstanceId,
+              targetRunId: null,
+              status: "consumed",
+              resolution: null,
+              createdBy: "system",
+              error: null,
+              createdAt: now,
+              updatedAt: now,
+              consumedAt: now,
+            },
+          },
+        ],
+      });
+
+      const assertCrossThreadProjection = Effect.gen(function* () {
+        const parent = yield* projectionStore.getThreadProjection(parentThreadId);
+        const child = yield* projectionStore.getThreadProjection(childThreadId);
+        const expectedTransferIds = [spawnTransferId, resultTransferId].toSorted();
+        assert.deepEqual(
+          parent.contextTransfers.map((transfer) => transfer.id).toSorted(),
+          expectedTransferIds,
+        );
+        assert.deepEqual(
+          child.contextTransfers.map((transfer) => transfer.id).toSorted(),
+          expectedTransferIds,
+        );
+        assert.deepEqual(
+          parent.providerThreads.map((providerThread) => providerThread.id),
+          [childProviderThreadId],
+        );
+        assert.equal(child.thread.activeProviderThreadId, childProviderThreadId);
+      });
+
+      yield* assertCrossThreadProjection;
+      assert.isTrue((yield* maintenance.verify).valid);
+      assert.isTrue((yield* maintenance.rebuild).valid);
+      yield* assertCrossThreadProjection;
+    }),
+  );
+
+  it.effect(
+    "rolls back events, projections, receipts, and effects after a projection failure",
+    () =>
+      Effect.gen(function* () {
+        const eventSink = yield* EventSinkV2;
+        const eventStore = yield* EventStoreV2;
+        const receipts = yield* CommandReceiptStoreV2;
+        const outbox = yield* EffectOutboxV2;
+        const sql = yield* SqlClient.SqlClient;
+        const now = yield* DateTime.now;
+        const commandId = CommandId.make("command:foundation-atomic-failure");
+        const threadId = ThreadId.make("thread:foundation-atomic-failure");
+        const scopeId = CheckpointScopeId.make("scope:foundation-atomic-failure");
+        const checkpoint = (index: number) => ({
+          id: CheckpointId.make(`checkpoint:foundation-atomic-failure:${index}`),
+          threadId,
+          scopeId,
+          runId: null,
+          nodeId: NodeId.make("node:foundation-atomic-failure"),
+          parentCheckpointId: null,
+          ordinalWithinScope: 1,
+          appRunOrdinal: null,
+          ref: CheckpointRef.make(`checkpoint-ref:foundation-atomic-failure:${index}`),
+          status: "ready" as const,
+          files: [],
+          capturedAt: now,
+        });
+        const events = [1, 2].map(
+          (index) =>
+            ({
+              id: EventId.make(`event:foundation-atomic-failure:${index}`),
+              type: "checkpoint.captured",
+              threadId,
+              occurredAt: now,
+              payload: checkpoint(index),
+            }) satisfies OrchestrationV2DomainEvent,
+        );
+
+        const exit = yield* Effect.exit(
+          eventSink.commitCommand({
+            commandId,
+            threadId,
+            commandType: "checkpoint.atomicity-test",
+            acceptedAt: now,
+            events,
+            effects: [
+              {
+                id: "effect:foundation-atomic-failure",
+                commandId,
+                threadId,
+                request: {
+                  type: "provider-turn.start",
+                  runId: RunId.make("run:foundation-atomic-failure"),
+                },
+              },
+            ],
+          }),
+        );
+        assert.equal(exit._tag, "Failure");
+        assert.isTrue(Option.isNone(yield* receipts.getByCommandId(commandId)));
+        assert.deepEqual(yield* outbox.listByCommandId(commandId), []);
+        assert.deepEqual(
+          yield* eventStore.readByCommandId({ commandId }).pipe(
+            Stream.runCollect,
+            Effect.map((events) => Array.from(events)),
+          ),
+          [],
+        );
+        const checkpointRows = yield* sql<{ readonly count: number }>`
+        SELECT COUNT(*) AS count
+        FROM orchestration_v2_projection_checkpoints
+        WHERE thread_id = ${threadId}
+      `;
+        assert.equal(checkpointRows[0]?.count, 0);
+      }),
+  );
+
+  it.effect("keeps one durable effect across command retries and executes it after recovery", () =>
+    Effect.gen(function* () {
+      const eventSink = yield* EventSinkV2;
+      const outbox = yield* EffectOutboxV2;
+      const now = yield* DateTime.now;
+      const commandId = CommandId.make("command:foundation-effect-recovery");
+      const threadId = ThreadId.make("thread:foundation-effect-recovery");
+      const thread = makeThread(threadId, now);
+      const event = threadCreatedEvent({
+        id: "event:foundation-effect-recovery",
+        thread,
+        now,
+      });
+      const effect = {
+        id: "effect:foundation-effect-recovery",
+        commandId,
+        threadId,
+        request: {
+          type: "provider-turn.start" as const,
+          runId: RunId.make("run:foundation-effect-recovery"),
+        },
+      };
+
+      const first = yield* eventSink.commitCommand({
+        commandId,
+        threadId,
+        commandType: "foundation.effect-recovery",
+        acceptedAt: now,
+        events: [event],
+        effects: [effect],
+      });
+      const retry = yield* eventSink.commitCommand({
+        commandId,
+        threadId,
+        commandType: "foundation.effect-recovery",
+        acceptedAt: now,
+        events: [event],
+        effects: [effect],
+      });
+
+      assert.isTrue(first.committed);
+      assert.isFalse(retry.committed);
+      assert.equal(retry.receipt.resultSequence, first.receipt.resultSequence);
+      assert.lengthOf(retry.storedEvents, 1);
+      assert.lengthOf(yield* outbox.listByCommandId(commandId), 1);
+
+      const executionCount = yield* Ref.make(0);
+      const executorLayer = Layer.succeed(
+        OrchestrationEffectExecutorV2,
+        OrchestrationEffectExecutorV2.of({
+          execute: () => Ref.update(executionCount, (count) => count + 1),
+        }),
+      );
+      const workerLayer = effectWorkerLayerWithOptions({ workerId: "recovery-worker" }).pipe(
+        Layer.provide(Layer.merge(Layer.succeed(EffectOutboxV2, outbox), executorLayer)),
+      );
+      yield* Effect.gen(function* () {
+        const worker = yield* OrchestrationEffectWorkerV2;
+        assert.isTrue(yield* worker.runOnce);
+        assert.isFalse(yield* worker.runOnce);
+      }).pipe(Effect.provide(workerLayer));
+
+      assert.equal(yield* Ref.get(executionCount), 1);
+      const storedEffect = yield* outbox.get(effect.id);
+      assert.isTrue(Option.isSome(storedEffect));
+      if (Option.isSome(storedEffect)) {
+        assert.equal(storedEffect.value.status, "succeeded");
+      }
+    }),
+  );
+
+  it.effect("does not wake claimers for effects from an idempotent command retry", () =>
+    Effect.gen(function* () {
+      const eventSink = yield* EventSinkV2;
+      const outbox = yield* EffectOutboxV2;
+      const now = yield* DateTime.now;
+      const commandId = CommandId.make("command:foundation-idempotent-wakeup");
+      const threadId = ThreadId.make("thread:foundation-idempotent-wakeup");
+      const input = {
+        commandId,
+        threadId,
+        commandType: "foundation.idempotent-wakeup",
+        acceptedAt: now,
+        events: [
+          threadCreatedEvent({
+            id: "event:foundation-idempotent-wakeup",
+            thread: makeThread(threadId, now),
+            now,
+          }),
+        ],
+        effects: [
+          {
+            id: "effect:foundation-idempotent-wakeup",
+            commandId,
+            threadId,
+            request: { type: "terminal.cleanup" as const },
+          },
+        ],
+      };
+
+      assert.isTrue((yield* eventSink.commitCommand(input)).committed);
+      yield* outbox.awaitAvailable;
+      assert.isFalse((yield* eventSink.commitCommand(input)).committed);
+
+      const unexpectedWake = yield* outbox.awaitAvailable.pipe(Effect.forkChild);
+      yield* Effect.yieldNow;
+      assert.isUndefined(unexpectedWake.pollUnsafe());
+    }).pipe(Effect.provide(Layer.fresh(TestLayer))),
+  );
+
+  it.effect("does not publish a stale provider start after an interrupt wins", () =>
+    Effect.gen(function* () {
+      const eventSink = yield* EventSinkV2;
+      const projectionStore = yield* ProjectionStoreV2;
+      const now = yield* DateTime.now;
+      const threadId = ThreadId.make("thread:foundation-stale-provider-start");
+      const runId = RunId.make("run:foundation-stale-provider-start");
+      const attemptId = RunAttemptId.make("run-attempt:foundation-stale-provider-start");
+      const thread = makeThread(threadId, now);
+      const startingRun: OrchestrationV2Run = {
+        id: runId,
+        threadId,
+        ordinal: 1,
+        providerInstanceId,
+        modelSelection,
+        providerThreadId: null,
+        userMessageId: MessageId.make("message:foundation-stale-provider-start"),
+        rootNodeId: null,
+        activeAttemptId: attemptId,
+        status: "starting",
+        queuePosition: null,
+        requestedAt: now,
+        startedAt: null,
+        completedAt: null,
+        checkpointId: null,
+        contextHandoffId: null,
+      };
+      yield* eventSink.write({
+        events: [
+          threadCreatedEvent({
+            id: "event:foundation-stale-provider-start:thread",
+            thread,
+            now,
+          }),
+          {
+            id: EventId.make("event:foundation-stale-provider-start:run"),
+            type: "run.created",
+            threadId,
+            runId,
+            providerInstanceId,
+            occurredAt: now,
+            payload: startingRun,
+          },
+        ],
+      });
+
+      const reachedPrecommitGap = yield* Deferred.make<void>();
+      const releaseStaleStart = yield* Deferred.make<void>();
+      const providerStartCount = yield* Ref.make(0);
+      const staleStartFiber = yield* Effect.gen(function* () {
+        yield* Deferred.succeed(reachedPrecommitGap, undefined);
+        yield* Deferred.await(releaseStaleStart);
+        const result = yield* eventSink.writeIfRunCurrent({
+          threadId,
+          runId,
+          activeAttemptId: attemptId,
+          expectedStatus: "starting",
+          events: [
+            {
+              id: EventId.make("event:foundation-stale-provider-start:running"),
+              type: "run.updated",
+              threadId,
+              runId,
+              providerInstanceId,
+              occurredAt: now,
+              payload: { ...startingRun, status: "running", startedAt: now },
+            },
+          ],
+        });
+        if (result.committed) {
+          yield* Ref.update(providerStartCount, (count) => count + 1);
+        }
+        return result;
+      }).pipe(Effect.forkChild);
+
+      yield* Deferred.await(reachedPrecommitGap);
+      const interruptedAt = yield* DateTime.now;
+      yield* eventSink.write({
+        events: [
+          {
+            id: EventId.make("event:foundation-stale-provider-start:cancelled"),
+            type: "run.updated",
+            threadId,
+            runId,
+            providerInstanceId,
+            occurredAt: interruptedAt,
+            payload: {
+              ...startingRun,
+              status: "cancelled",
+              completedAt: interruptedAt,
+            },
+          },
+        ],
+      });
+      yield* Deferred.succeed(releaseStaleStart, undefined);
+
+      const staleResult = yield* Fiber.join(staleStartFiber);
+      assert.isFalse(staleResult.committed);
+      assert.deepEqual(staleResult.storedEvents, []);
+      assert.equal(yield* Ref.get(providerStartCount), 0);
+      const projection = yield* projectionStore.getThreadProjection(threadId);
+      assert.equal(projection.runs[0]?.status, "cancelled");
+    }),
+  );
+
+  it.effect("guards post-terminal provider-thread writes by attempt and run ordinal", () =>
+    Effect.gen(function* () {
+      const eventSink = yield* EventSinkV2;
+      const projectionStore = yield* ProjectionStoreV2;
+      const now = yield* DateTime.now;
+      const threadId = ThreadId.make("thread:foundation-provider-thread-owner");
+      const runId = RunId.make("run:foundation-provider-thread-owner");
+      const attemptId = RunAttemptId.make("attempt:foundation-provider-thread-owner");
+      const replacementAttemptId = RunAttemptId.make(
+        "attempt:foundation-provider-thread-owner:replacement",
+      );
+      const rootNodeId = NodeId.make("node:foundation-provider-thread-owner");
+      const providerThreadId = ProviderThreadId.make(
+        "provider-thread:foundation-provider-thread-owner",
+      );
+      const thread = makeThread(threadId, now);
+      const run: OrchestrationV2Run = {
+        id: runId,
+        threadId,
+        ordinal: 1,
+        providerInstanceId,
+        modelSelection,
+        providerThreadId,
+        userMessageId: MessageId.make("message:foundation-provider-thread-owner"),
+        rootNodeId,
+        activeAttemptId: attemptId,
+        status: "completed",
+        queuePosition: null,
+        requestedAt: now,
+        startedAt: now,
+        completedAt: now,
+        checkpointId: null,
+        contextHandoffId: null,
+      };
+      const baseProviderThread = {
+        id: providerThreadId,
+        driver: providerDriver,
+        providerInstanceId,
+        providerSessionId: null,
+        appThreadId: threadId,
+        ownerNodeId: null,
+        nativeThreadRef: null,
+        nativeConversationHeadRef: null,
+        status: "idle" as const,
+        firstRunOrdinal: 1,
+        lastRunOrdinal: 1,
+        handoffIds: [] as const,
+        forkedFrom: null,
+        pendingBackgroundTasks: [
+          { taskId: "bg-owner", description: "sleep 20", taskType: "local_bash" },
+        ],
+        createdAt: now,
+        updatedAt: now,
+      };
+
+      yield* eventSink.write({
+        events: [
+          threadCreatedEvent({
+            id: "event:foundation-provider-thread-owner:thread",
+            thread,
+            now,
+          }),
+          {
+            id: EventId.make("event:foundation-provider-thread-owner:run"),
+            type: "run.created",
+            threadId,
+            runId,
+            nodeId: rootNodeId,
+            providerInstanceId,
+            occurredAt: now,
+            payload: run,
+          },
+          {
+            id: EventId.make("event:foundation-provider-thread-owner:provider-thread"),
+            type: "provider-thread.updated",
+            threadId,
+            driver: providerDriver,
+            providerInstanceId,
+            occurredAt: now,
+            payload: baseProviderThread,
+          },
+        ],
+      });
+
+      const ownedClear = yield* eventSink.writeIfProviderThreadOwner({
+        providerThreadId,
+        runId,
+        activeAttemptId: attemptId,
+        expectedLastRunOrdinal: 1,
+        events: [
+          {
+            id: EventId.make("event:foundation-provider-thread-owner:clear"),
+            type: "provider-thread.updated",
+            threadId,
+            driver: providerDriver,
+            providerInstanceId,
+            occurredAt: now,
+            payload: {
+              ...baseProviderThread,
+              pendingBackgroundTasks: [],
+              updatedAt: now,
+            },
+          },
+        ],
+      });
+      assert.isTrue(ownedClear.committed);
+      assert.equal(ownedClear.storedEvents.length, 1);
+
+      const afterReplacement = yield* DateTime.now;
+      yield* eventSink.write({
+        events: [
+          {
+            id: EventId.make("event:foundation-provider-thread-owner:replacement-attempt"),
+            type: "run.updated",
+            threadId,
+            runId,
+            nodeId: rootNodeId,
+            providerInstanceId,
+            occurredAt: afterReplacement,
+            payload: {
+              ...run,
+              activeAttemptId: replacementAttemptId,
+              status: "running",
+            },
+          },
+        ],
+      });
+
+      const supersededAttemptWrite = yield* eventSink.writeIfProviderThreadOwner({
+        providerThreadId,
+        runId,
+        activeAttemptId: attemptId,
+        expectedLastRunOrdinal: 1,
+        events: [
+          {
+            id: EventId.make("event:foundation-provider-thread-owner:superseded-attempt"),
+            type: "provider-thread.updated",
+            threadId,
+            driver: providerDriver,
+            providerInstanceId,
+            occurredAt: afterReplacement,
+            payload: {
+              ...baseProviderThread,
+              status: "active",
+              pendingBackgroundTasks: [
+                {
+                  taskId: "bg-superseded",
+                  description: "should not land",
+                  taskType: "local_bash",
+                },
+              ],
+              updatedAt: afterReplacement,
+            },
+          },
+        ],
+      });
+      assert.isFalse(supersededAttemptWrite.committed);
+      assert.deepEqual(supersededAttemptWrite.storedEvents, []);
+
+      yield* eventSink.write({
+        events: [
+          {
+            id: EventId.make("event:foundation-provider-thread-owner:replacement-completed"),
+            type: "run.updated",
+            threadId,
+            runId,
+            nodeId: rootNodeId,
+            providerInstanceId,
+            occurredAt: afterReplacement,
+            payload: {
+              ...run,
+              activeAttemptId: replacementAttemptId,
+            },
+          },
+          {
+            id: EventId.make("event:foundation-provider-thread-owner:newer-run"),
+            type: "provider-thread.updated",
+            threadId,
+            driver: providerDriver,
+            providerInstanceId,
+            occurredAt: afterReplacement,
+            payload: {
+              ...baseProviderThread,
+              lastRunOrdinal: 2,
+              status: "active",
+              pendingBackgroundTasks: [],
+              updatedAt: afterReplacement,
+            },
+          },
+        ],
+      });
+
+      const staleOrdinalWrite = yield* eventSink.writeIfProviderThreadOwner({
+        providerThreadId,
+        runId,
+        activeAttemptId: replacementAttemptId,
+        expectedLastRunOrdinal: 1,
+        events: [
+          {
+            id: EventId.make("event:foundation-provider-thread-owner:stale-ordinal"),
+            type: "provider-thread.updated",
+            threadId,
+            driver: providerDriver,
+            providerInstanceId,
+            occurredAt: afterReplacement,
+            payload: baseProviderThread,
+          },
+        ],
+      });
+      assert.isFalse(staleOrdinalWrite.committed);
+      assert.deepEqual(staleOrdinalWrite.storedEvents, []);
+
+      const projection = yield* projectionStore.getThreadProjection(threadId);
+      const providerThread = projection.providerThreads.find(
+        (candidate) => candidate.id === providerThreadId,
+      );
+      assert.isDefined(providerThread);
+      assert.equal(providerThread?.lastRunOrdinal, 2);
+      assert.equal(providerThread?.status, "active");
+      assert.deepEqual(providerThread?.pendingBackgroundTasks ?? [], []);
+    }),
+  );
+
+  it.effect("interrupts a running process-bound effect when it is cancelled", () =>
+    Effect.gen(function* () {
+      const outbox = yield* EffectOutboxV2;
+      const commandId = CommandId.make("command:foundation-cancel-running-effect");
+      const threadId = ThreadId.make("thread:foundation-cancel-running-effect");
+      const effectId = "effect:foundation-cancel-running-effect";
+      const started = yield* Deferred.make<void>();
+      const interrupted = yield* Deferred.make<void>();
+      yield* outbox.enqueue([
+        {
+          id: effectId,
+          commandId,
+          threadId,
+          request: {
+            type: "provider-turn.start",
+            runId: RunId.make("run:foundation-cancel-running-effect"),
+          },
+        },
+      ]);
+
+      const executorLayer = Layer.succeed(
+        OrchestrationEffectExecutorV2,
+        OrchestrationEffectExecutorV2.of({
+          execute: () =>
+            Deferred.succeed(started, undefined).pipe(
+              Effect.andThen(Effect.never),
+              Effect.onInterrupt(() =>
+                Deferred.succeed(interrupted, undefined).pipe(Effect.ignore),
+              ),
+            ),
+        }),
+      );
+      const workerLayer = effectWorkerLayerWithOptions({
+        workerId: "cancellation-worker",
+      }).pipe(Layer.provide(Layer.merge(Layer.succeed(EffectOutboxV2, outbox), executorLayer)));
+
+      yield* Effect.gen(function* () {
+        const worker = yield* OrchestrationEffectWorkerV2;
+        const workerFiber = yield* worker.runOnce.pipe(Effect.forkChild);
+        yield* Deferred.await(started);
+        const cancelledEffectIds = yield* outbox.cancelUnsettled({
+          threadId,
+          effectTypes: ["provider-turn.start"],
+          reason: "The owning run was interrupted.",
+        });
+        assert.deepEqual(cancelledEffectIds, [effectId]);
+        yield* outbox.signalCancellations(cancelledEffectIds);
+        assert.isTrue(yield* Fiber.join(workerFiber));
+        yield* Deferred.await(interrupted);
+      }).pipe(Effect.provide(workerLayer));
+
+      const cancelled = yield* outbox.get(effectId);
+      assert.isTrue(Option.isSome(cancelled));
+      if (Option.isSome(cancelled)) assert.equal(cancelled.value.status, "cancelled");
+    }),
+  );
+
+  it.effect("treats cancellation between execution and settlement as a normal outcome", () =>
+    Effect.gen(function* () {
+      const effectId = "effect:foundation-cancel-before-settlement";
+      const threadId = ThreadId.make("thread:foundation-cancel-before-settlement");
+      const commandId = CommandId.make("command:foundation-cancel-before-settlement");
+      const now = DateTime.formatIso(yield* DateTime.now);
+      const claimedEffect = {
+        id: effectId,
+        commandId,
+        threadId,
+        request: { type: "terminal.cleanup" as const },
+        status: "running" as const,
+        attemptCount: 1,
+        availableAt: now,
+        leaseOwner: "settlement-race-worker",
+        leaseExpiresAt: now,
+        createdAt: now,
+        updatedAt: now,
+        completedAt: null,
+        lastError: null,
+      };
+      const outboxLayer = Layer.mock(EffectOutboxV2)({
+        claimNext: () => Effect.succeed(Option.some(claimedEffect)),
+        awaitCancellation: () => Effect.never,
+        clearCancellation: () => Effect.void,
+        succeed: () => Effect.succeed(false),
+        get: () =>
+          Effect.succeed(
+            Option.some({
+              ...claimedEffect,
+              status: "cancelled" as const,
+              leaseOwner: null,
+              leaseExpiresAt: null,
+              completedAt: now,
+            }),
+          ),
+      });
+      const executorLayer = Layer.succeed(
+        OrchestrationEffectExecutorV2,
+        OrchestrationEffectExecutorV2.of({ execute: () => Effect.void }),
+      );
+      const workerLayer = effectWorkerLayerWithOptions({
+        workerId: "settlement-race-worker",
+      }).pipe(Layer.provide(Layer.merge(outboxLayer, executorLayer)));
+
+      assert.isTrue(
+        yield* OrchestrationEffectWorkerV2.pipe(
+          Effect.flatMap((worker) => worker.runOnce),
+          Effect.provide(workerLayer),
+        ),
+      );
+    }),
+  );
+
+  it.effect("does not start an effect that was cancelled during claim registration", () =>
+    Effect.gen(function* () {
+      const effectId = "effect:foundation-cancelled-during-claim";
+      const threadId = ThreadId.make("thread:foundation-cancelled-during-claim");
+      const commandId = CommandId.make("command:foundation-cancelled-during-claim");
+      const now = DateTime.formatIso(yield* DateTime.now);
+      const claimedEffect = {
+        id: effectId,
+        commandId,
+        threadId,
+        request: { type: "terminal.cleanup" as const },
+        status: "running" as const,
+        attemptCount: 1,
+        availableAt: now,
+        leaseOwner: "claim-cancellation-worker",
+        leaseExpiresAt: now,
+        createdAt: now,
+        updatedAt: now,
+        completedAt: null,
+        lastError: null,
+      };
+      const executionCount = yield* Ref.make(0);
+      const outboxLayer = Layer.mock(EffectOutboxV2)({
+        claimNext: () => Effect.succeed(Option.some(claimedEffect)),
+        get: () =>
+          Effect.succeed(
+            Option.some({
+              ...claimedEffect,
+              status: "cancelled" as const,
+              leaseOwner: null,
+              leaseExpiresAt: null,
+              completedAt: now,
+            }),
+          ),
+        clearCancellation: () => Effect.void,
+        awaitCancellation: () => Effect.never,
+      });
+      const executorLayer = Layer.succeed(
+        OrchestrationEffectExecutorV2,
+        OrchestrationEffectExecutorV2.of({
+          execute: () => Ref.update(executionCount, (count) => count + 1),
+        }),
+      );
+      const workerLayer = effectWorkerLayerWithOptions({
+        workerId: "claim-cancellation-worker",
+      }).pipe(Layer.provide(Layer.merge(outboxLayer, executorLayer)));
+
+      assert.isTrue(
+        yield* OrchestrationEffectWorkerV2.pipe(
+          Effect.flatMap((worker) => worker.runOnce),
+          Effect.provide(workerLayer),
+        ),
+      );
+      assert.equal(yield* Ref.get(executionCount), 0);
+    }),
+  );
+
+  it.effect("allows only one worker to claim an available effect", () =>
+    Effect.gen(function* () {
+      const outbox = yield* EffectOutboxV2;
+      const commandId = CommandId.make("command:foundation-exclusive-claim");
+      yield* outbox.enqueue([
+        {
+          id: "effect:foundation-exclusive-claim",
+          commandId,
+          threadId: ThreadId.make("thread:foundation-exclusive-claim"),
+          request: {
+            type: "provider-turn.start",
+            runId: RunId.make("run:foundation-exclusive-claim"),
+          },
+        },
+      ]);
+
+      const claims = yield* Effect.all(
+        [
+          outbox.claimNext({ workerId: "worker-a", leaseDurationMs: 30_000 }),
+          outbox.claimNext({ workerId: "worker-b", leaseDurationMs: 30_000 }),
+        ],
+        { concurrency: "unbounded" },
+      );
+      assert.equal(claims.filter(Option.isSome).length, 1);
+      assert.equal(claims.filter(Option.isNone).length, 1);
+      const claimedByA = claims[0];
+      const claimedByB = claims[1];
+      if (Option.isSome(claimedByA)) {
+        yield* outbox.succeed({ effectId: claimedByA.value.id, workerId: "worker-a" });
+      }
+      if (Option.isSome(claimedByB)) {
+        yield* outbox.succeed({ effectId: claimedByB.value.id, workerId: "worker-b" });
+      }
+    }),
+  );
+
+  it.effect("runs title generation beside critical work while serializing each lane", () =>
+    Effect.gen(function* () {
+      const outbox = yield* EffectOutboxV2;
+      const commandId = CommandId.make("command:foundation-title-effect-lane");
+      const threadId = ThreadId.make("thread:foundation-title-effect-lane");
+      const titleEffectId = "effect:foundation-title-effect-lane:a-title";
+      const providerEffectId = "effect:foundation-title-effect-lane:b-provider";
+      const nextTitleEffectId = "effect:foundation-title-effect-lane:c-title";
+      const nextCriticalEffectId = "effect:foundation-title-effect-lane:d-critical";
+      yield* outbox.enqueue([
+        {
+          id: titleEffectId,
+          commandId,
+          threadId,
+          request: {
+            type: "thread-title.generate",
+            kind: {
+              type: "initial",
+              messageId: MessageId.make("message:foundation-title-effect-lane"),
+            },
+          },
+        },
+        {
+          id: providerEffectId,
+          commandId,
+          threadId,
+          request: {
+            type: "provider-turn.start",
+            runId: RunId.make("run:foundation-title-effect-lane"),
+          },
+        },
+        {
+          id: nextTitleEffectId,
+          commandId,
+          threadId,
+          request: { type: "thread-title.generate", kind: { type: "regenerate" } },
+        },
+        {
+          id: nextCriticalEffectId,
+          commandId,
+          threadId,
+          request: { type: "terminal.cleanup" },
+        },
+      ]);
+
+      const title = yield* outbox.claimNext({
+        workerId: "title-lane-worker",
+        leaseDurationMs: 30_000,
+      });
+      assert.isTrue(Option.isSome(title));
+      if (Option.isNone(title)) return;
+      assert.equal(title.value.id, titleEffectId);
+
+      const provider = yield* outbox.claimNext({
+        workerId: "critical-lane-worker",
+        leaseDurationMs: 30_000,
+      });
+      assert.isTrue(Option.isSome(provider));
+      if (Option.isNone(provider)) return;
+      assert.equal(provider.value.id, providerEffectId);
+
+      assert.isTrue(
+        Option.isNone(
+          yield* outbox.claimNext({
+            workerId: "blocked-lanes-worker",
+            leaseDurationMs: 30_000,
+          }),
+        ),
+      );
+
+      yield* outbox.succeed({
+        effectId: provider.value.id,
+        workerId: "critical-lane-worker",
+      });
+      const nextCritical = yield* outbox.claimNext({
+        workerId: "critical-lane-worker",
+        leaseDurationMs: 30_000,
+      });
+      assert.isTrue(Option.isSome(nextCritical));
+      if (Option.isNone(nextCritical)) return;
+      assert.equal(nextCritical.value.id, nextCriticalEffectId);
+      yield* outbox.succeed({
+        effectId: nextCritical.value.id,
+        workerId: "critical-lane-worker",
+      });
+
+      yield* outbox.succeed({
+        effectId: title.value.id,
+        workerId: "title-lane-worker",
+      });
+      const nextTitle = yield* outbox.claimNext({
+        workerId: "title-lane-worker",
+        leaseDurationMs: 30_000,
+      });
+      assert.isTrue(Option.isSome(nextTitle));
+      if (Option.isSome(nextTitle)) {
+        assert.equal(nextTitle.value.id, nextTitleEffectId);
+        yield* outbox.succeed({
+          effectId: nextTitle.value.id,
+          workerId: "title-lane-worker",
+        });
+      }
+    }),
+  );
+
+  it.effect("ignores deadlines blocked by a running effect on the same thread", () =>
+    Effect.gen(function* () {
+      const outbox = yield* EffectOutboxV2;
+      const now = yield* DateTime.now;
+      const future = DateTime.add(now, { seconds: 10 });
+      const commandId = CommandId.make("command:foundation-next-claimable");
+      const blockedThreadId = ThreadId.make("thread:foundation-next-claimable:blocked");
+      yield* outbox.enqueue([
+        {
+          id: "effect:foundation-next-claimable:a1",
+          commandId,
+          threadId: blockedThreadId,
+          request: { type: "terminal.cleanup" },
+        },
+        {
+          id: "effect:foundation-next-claimable:a2",
+          commandId,
+          threadId: blockedThreadId,
+          request: { type: "terminal.cleanup" },
+        },
+        {
+          id: "effect:foundation-next-claimable:b1",
+          commandId,
+          threadId: ThreadId.make("thread:foundation-next-claimable:future"),
+          request: { type: "terminal.cleanup" },
+          availableAt: future,
+        },
+      ]);
+
+      const claimed = yield* outbox.claimNext({
+        workerId: "next-claimable-worker",
+        leaseDurationMs: 30_000,
+      });
+      assert.isTrue(Option.isSome(claimed));
+      if (Option.isNone(claimed)) return;
+      assert.equal(claimed.value.id, "effect:foundation-next-claimable:a1");
+
+      const whileBlocked = yield* outbox.nextClaimableAt;
+      assert.isTrue(Option.isSome(whileBlocked));
+      if (Option.isSome(whileBlocked)) {
+        assert.equal(DateTime.toEpochMillis(whileBlocked.value), DateTime.toEpochMillis(future));
+      }
+
+      yield* outbox.succeed({
+        effectId: claimed.value.id,
+        workerId: "next-claimable-worker",
+      });
+      const afterCompletion = yield* outbox.nextClaimableAt;
+      assert.isTrue(Option.isSome(afterCompletion));
+      if (Option.isSome(afterCompletion)) {
+        assert.isAtMost(DateTime.toEpochMillis(afterCompletion.value), DateTime.toEpochMillis(now));
+      }
+
+      const unblocked = yield* outbox.claimNext({
+        workerId: "next-claimable-worker",
+        leaseDurationMs: 30_000,
+      });
+      assert.isTrue(Option.isSome(unblocked));
+      if (Option.isSome(unblocked)) {
+        assert.equal(unblocked.value.id, "effect:foundation-next-claimable:a2");
+        yield* outbox.succeed({
+          effectId: unblocked.value.id,
+          workerId: "next-claimable-worker",
+        });
+      }
+      yield* outbox.cancelUnsettled({
+        threadId: ThreadId.make("thread:foundation-next-claimable:future"),
+        effectTypes: ["terminal.cleanup"],
+        reason: "Test cleanup.",
+      });
+    }),
+  );
+
+  it.effect("does not emit a SQL span for an empty safety claim", () =>
+    Effect.gen(function* () {
+      const outbox = yield* EffectOutboxV2;
+      const spans: Array<string> = [];
+      const tracer = Tracer.make({
+        span: (options) => {
+          const span = new Tracer.NativeSpan(options);
+          const end = span.end.bind(span);
+          span.end = (endTime, exit) => {
+            end(endTime, exit);
+            spans.push(span.name);
+          };
+          return span;
+        },
+      });
+
+      const claim = yield* outbox
+        .claimNext({ workerId: "idle-safety-worker", leaseDurationMs: 30_000 })
+        .pipe(Effect.withTracer(tracer));
+
+      assert.isTrue(Option.isNone(claim));
+      assert.notInclude(spans, "sql.execute");
+    }).pipe(Effect.provide(Layer.fresh(effectOutboxProvided))),
+  );
+
+  it.effect("wakes claimers when cancellation unblocks same-thread work", () =>
+    Effect.gen(function* () {
+      const outbox = yield* EffectOutboxV2;
+      const commandId = CommandId.make("command:foundation-cancellation-wakeup");
+      const threadId = ThreadId.make("thread:foundation-cancellation-wakeup");
+      yield* outbox.enqueue([
+        {
+          id: "effect:foundation-cancellation-wakeup:a-running",
+          commandId,
+          threadId,
+          request: {
+            type: "provider-turn.start",
+            runId: RunId.make("run:foundation-cancellation-wakeup"),
+          },
+        },
+        {
+          id: "effect:foundation-cancellation-wakeup:b-pending",
+          commandId,
+          threadId,
+          request: { type: "terminal.cleanup" },
+        },
+      ]);
+
+      const running = yield* outbox.claimNext({
+        workerId: "cancellation-wakeup-worker",
+        leaseDurationMs: 30_000,
+      });
+      assert.isTrue(Option.isSome(running));
+      if (Option.isNone(running)) return;
+      assert.equal(running.value.request.type, "provider-turn.start");
+
+      const cancelledEffectIds = yield* outbox.cancelUnsettled({
+        threadId,
+        effectTypes: ["provider-turn.start"],
+        reason: "Test cancellation wakeup.",
+      });
+      yield* outbox.signalCancellations(cancelledEffectIds);
+
+      const wake = yield* outbox.awaitAvailable.pipe(Effect.forkChild);
+      yield* Effect.yieldNow;
+      assert.isDefined(wake.pollUnsafe());
+
+      const unblocked = yield* outbox.claimNext({
+        workerId: "cancellation-wakeup-worker",
+        leaseDurationMs: 30_000,
+      });
+      assert.isTrue(Option.isSome(unblocked));
+      if (Option.isSome(unblocked)) {
+        assert.equal(unblocked.value.request.type, "terminal.cleanup");
+        yield* outbox.succeed({
+          effectId: unblocked.value.id,
+          workerId: "cancellation-wakeup-worker",
+        });
+      }
+    }).pipe(Effect.provide(Layer.fresh(effectOutboxProvided))),
+  );
+
+  it.effect("executes a retry at its durable deadline instead of the liveness interval", () =>
+    Effect.gen(function* () {
+      const outbox = yield* EffectOutboxV2;
+      const effectId = "effect:foundation-durable-retry-deadline";
+      const commandId = CommandId.make("command:foundation-durable-retry-deadline");
+      const threadId = ThreadId.make("thread:foundation-durable-retry-deadline");
+      const executions = yield* Ref.make(0);
+      const completed = yield* Deferred.make<void>();
+      const executorLayer = Layer.succeed(
+        OrchestrationEffectExecutorV2,
+        OrchestrationEffectExecutorV2.of({
+          execute: () =>
+            Effect.gen(function* () {
+              const attempt = yield* Ref.updateAndGet(executions, (count) => count + 1);
+              if (attempt === 1) {
+                return yield* new OrchestrationEffectExecutionError({
+                  effectId,
+                  effectType: "terminal.cleanup",
+                  cause: "simulated retry",
+                });
+              }
+              yield* Deferred.succeed(completed, undefined);
+            }),
+        }),
+      );
+      const workerLayer = effectWorkerLayerWithOptions({
+        workerId: "durable-retry-deadline-worker",
+      }).pipe(Layer.provide(Layer.merge(Layer.succeed(EffectOutboxV2, outbox), executorLayer)));
+
+      yield* Effect.gen(function* () {
+        yield* runEffectWorkerDaemonWithOptions({
+          concurrency: 1,
+          livenessPollIntervalMs: 30_000,
+        }).pipe(Effect.forkScoped);
+        yield* outbox.enqueue([
+          {
+            id: effectId,
+            commandId,
+            threadId,
+            request: { type: "terminal.cleanup" },
+          },
+        ]);
+        yield* outbox.notifyAvailable();
+
+        let retryScheduled = false;
+        while (!retryScheduled) {
+          const effect = yield* outbox.get(effectId);
+          retryScheduled =
+            Option.isSome(effect) &&
+            effect.value.status === "pending" &&
+            effect.value.attemptCount === 1;
+          if (!retryScheduled) yield* Effect.yieldNow;
+        }
+
+        yield* TestClock.adjust("99 millis");
+        assert.equal(yield* Ref.get(executions), 1);
+        yield* TestClock.adjust("1 millis");
+        yield* Deferred.await(completed);
+        assert.equal(yield* Ref.get(executions), 2);
+      }).pipe(Effect.provide(workerLayer), Effect.scoped);
+    }).pipe(Effect.provide(TestClock.layer())),
+  );
+
+  it.effect("runs distinct threads concurrently while serializing effects within a thread", () =>
+    Effect.gen(function* () {
+      const outbox = yield* EffectOutboxV2;
+      const commandId = CommandId.make("command:foundation-concurrent-effects");
+      const threadA = ThreadId.make("thread:foundation-concurrent-effects:a");
+      const threadB = ThreadId.make("thread:foundation-concurrent-effects:b");
+      const effectA1 = "effect:foundation-concurrent-effects:a1";
+      const effectA2 = "effect:foundation-concurrent-effects:a2";
+      const effectB1 = "effect:foundation-concurrent-effects:b1";
+      const startedA1 = yield* Deferred.make<void>();
+      const startedA2 = yield* Deferred.make<void>();
+      const startedB1 = yield* Deferred.make<void>();
+      const releaseA1 = yield* Deferred.make<void>();
+      const releaseA2 = yield* Deferred.make<void>();
+      const releaseB1 = yield* Deferred.make<void>();
+      const gates = new Map([
+        [effectA1, { started: startedA1, release: releaseA1 }],
+        [effectA2, { started: startedA2, release: releaseA2 }],
+        [effectB1, { started: startedB1, release: releaseB1 }],
+      ]);
+      const executorLayer = Layer.succeed(
+        OrchestrationEffectExecutorV2,
+        OrchestrationEffectExecutorV2.of({
+          execute: (effect) => {
+            const gate = gates.get(effect.id);
+            if (gate === undefined) return Effect.die(`Missing gate for ${effect.id}`);
+            return Deferred.succeed(gate.started, undefined).pipe(
+              Effect.andThen(Deferred.await(gate.release)),
+            );
+          },
+        }),
+      );
+      const workerLayer = effectWorkerLayerWithOptions({
+        workerId: "concurrency-worker",
+      }).pipe(Layer.provide(Layer.merge(Layer.succeed(EffectOutboxV2, outbox), executorLayer)));
+
+      yield* Effect.gen(function* () {
+        yield* runEffectWorkerDaemonWithOptions({ concurrency: 2 }).pipe(Effect.forkScoped);
+        // Let both slots reach the idle wait before work becomes available.
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+        yield* outbox.enqueue([
+          {
+            id: effectA1,
+            commandId,
+            threadId: threadA,
+            request: {
+              type: "provider-turn.start",
+              runId: RunId.make("run:foundation-concurrent-effects:a1"),
+            },
+          },
+          {
+            id: effectA2,
+            commandId,
+            threadId: threadA,
+            request: {
+              type: "provider-turn.start",
+              runId: RunId.make("run:foundation-concurrent-effects:a2"),
+            },
+          },
+          {
+            id: effectB1,
+            commandId,
+            threadId: threadB,
+            request: {
+              type: "provider-turn.start",
+              runId: RunId.make("run:foundation-concurrent-effects:b1"),
+            },
+          },
+        ]);
+        yield* outbox.notifyAvailable(3);
+
+        yield* Effect.all([Deferred.await(startedA1), Deferred.await(startedB1)]);
+        assert.isFalse(yield* Deferred.isDone(startedA2));
+
+        yield* Deferred.succeed(releaseA1, undefined);
+        yield* Deferred.succeed(releaseB1, undefined);
+        yield* Deferred.await(startedA2);
+        yield* Deferred.succeed(releaseA2, undefined);
+        let settled = false;
+        while (!settled) {
+          settled = (yield* outbox.listByCommandId(commandId)).every(
+            (effect) => effect.status === "succeeded",
+          );
+          if (!settled) yield* Effect.yieldNow;
+        }
+      }).pipe(Effect.provide(workerLayer), Effect.scoped);
+    }),
+  );
+
+  it.effect("does not reclaim a running effect after its process-local lease expires", () =>
+    Effect.gen(function* () {
+      const outbox = yield* EffectOutboxV2;
+      const sql = yield* SqlClient.SqlClient;
+      const commandId = CommandId.make("command:foundation-no-live-reclaim");
+      const threadId = ThreadId.make("thread:foundation-no-live-reclaim");
+      const firstEffectId = "effect:foundation-no-live-reclaim:first";
+      const secondEffectId = "effect:foundation-no-live-reclaim:second";
+      const firstStarted = yield* Deferred.make<void>();
+      const releaseFirst = yield* Deferred.make<void>();
+      const executions = yield* Ref.make<ReadonlyArray<string>>([]);
+      yield* outbox.enqueue([
+        {
+          id: firstEffectId,
+          commandId,
+          threadId,
+          request: { type: "terminal.cleanup" },
+        },
+        {
+          id: secondEffectId,
+          commandId,
+          threadId,
+          request: { type: "terminal.cleanup" },
+        },
+      ]);
+
+      const executorLayer = Layer.succeed(
+        OrchestrationEffectExecutorV2,
+        OrchestrationEffectExecutorV2.of({
+          execute: (effect) =>
+            Ref.update(executions, (current) => [...current, effect.id]).pipe(
+              Effect.andThen(
+                effect.id === firstEffectId
+                  ? Deferred.succeed(firstStarted, undefined).pipe(
+                      Effect.andThen(Deferred.await(releaseFirst)),
+                    )
+                  : Effect.void,
+              ),
+            ),
+        }),
+      );
+      const workerLayer = effectWorkerLayerWithOptions({
+        workerId: "no-live-reclaim-worker",
+        leaseDurationMs: 1,
+      }).pipe(Layer.provide(Layer.merge(Layer.succeed(EffectOutboxV2, outbox), executorLayer)));
+
+      yield* Effect.gen(function* () {
+        const worker = yield* OrchestrationEffectWorkerV2;
+        const firstFiber = yield* worker.runOnce.pipe(Effect.forkChild);
+        yield* Deferred.await(firstStarted);
+        yield* sql`
+          UPDATE orchestration_v2_effect_outbox
+          SET lease_expires_at = '1970-01-01T00:00:00.000Z'
+          WHERE effect_id = ${firstEffectId}
+        `;
+
+        assert.isFalse(yield* worker.runOnce);
+        assert.deepEqual(yield* Ref.get(executions), [firstEffectId]);
+
+        yield* Deferred.succeed(releaseFirst, undefined);
+        assert.isTrue(yield* Fiber.join(firstFiber));
+        assert.isTrue(yield* worker.runOnce);
+        assert.deepEqual(yield* Ref.get(executions), [firstEffectId, secondEffectId]);
+      }).pipe(Effect.provide(workerLayer));
+    }),
+  );
+
+  it.effect(
+    "retires live provider effects and requeues replay-safe effects after process loss",
+    () =>
+      Effect.gen(function* () {
+        const outbox = yield* EffectOutboxV2;
+        const commandId = CommandId.make("command:foundation-reclaim-running");
+        yield* outbox.enqueue([
+          {
+            id: "effect:a-foundation-cancel-provider-turn",
+            commandId,
+            threadId: ThreadId.make("thread:foundation-reclaim-running"),
+            request: {
+              type: "provider-turn.start",
+              runId: RunId.make("run:foundation-reclaim-running"),
+            },
+          },
+          {
+            id: "effect:b-foundation-requeue-cleanup",
+            commandId,
+            threadId: ThreadId.make("thread:foundation-reclaim-cleanup"),
+            request: { type: "terminal.cleanup" },
+          },
+        ]);
+        assert.isTrue(
+          Option.isSome(
+            yield* outbox.claimNext({ workerId: "crashed-worker", leaseDurationMs: 30_000 }),
+          ),
+        );
+        assert.isTrue(
+          Option.isSome(
+            yield* outbox.claimNext({ workerId: "crashed-worker", leaseDurationMs: 30_000 }),
+          ),
+        );
+        assert.deepEqual(yield* outbox.reconcileAfterProcessLoss, {
+          cancelled: 1,
+          requeued: 1,
+        });
+        const cancelled = yield* outbox.get("effect:a-foundation-cancel-provider-turn");
+        assert.isTrue(Option.isSome(cancelled));
+        if (Option.isSome(cancelled)) assert.equal(cancelled.value.status, "cancelled");
+
+        const reclaimed = yield* outbox.claimNext({
+          workerId: "recovery-worker",
+          leaseDurationMs: 30_000,
+        });
+        assert.isTrue(Option.isSome(reclaimed));
+        if (Option.isSome(reclaimed)) {
+          assert.equal(reclaimed.value.request.type, "terminal.cleanup");
+          assert.equal(reclaimed.value.attemptCount, 2);
+        }
+      }),
+  );
+
+  it.effect("atomically cancels stale runs and their process-bound effects", () =>
+    Effect.gen(function* () {
+      const eventSink = yield* EventSinkV2;
+      const outbox = yield* EffectOutboxV2;
+      const projectionStore = yield* ProjectionStoreV2;
+      const now = yield* DateTime.now;
+      const threadId = ThreadId.make("thread:foundation-process-loss");
+      const runId = RunId.make("run:foundation-process-loss");
+      const commandId = CommandId.make("command:foundation-process-loss");
+      const thread = makeThread(threadId, now);
+      yield* eventSink.commitCommand({
+        commandId,
+        threadId,
+        commandType: "foundation.process-loss",
+        acceptedAt: now,
+        events: [
+          threadCreatedEvent({ id: "event:foundation-process-loss:thread", thread, now }),
+          {
+            id: EventId.make("event:foundation-process-loss:run"),
+            type: "run.created",
+            threadId,
+            runId,
+            providerInstanceId,
+            occurredAt: now,
+            payload: {
+              id: runId,
+              threadId,
+              ordinal: 1,
+              providerInstanceId,
+              modelSelection,
+              providerThreadId: null,
+              userMessageId: MessageId.make("message:foundation-process-loss"),
+              rootNodeId: null,
+              activeAttemptId: null,
+              status: "starting",
+              queuePosition: null,
+              requestedAt: now,
+              startedAt: null,
+              completedAt: null,
+              checkpointId: null,
+              contextHandoffId: null,
+            },
+          },
+        ],
+        effects: [
+          {
+            id: "effect:foundation-process-loss",
+            commandId,
+            threadId,
+            request: { type: "provider-turn.start", runId },
+          },
+        ],
+      });
+      assert.isTrue(
+        Option.isSome(
+          yield* outbox.claimNext({ workerId: "crashed-worker", leaseDurationMs: 30_000 }),
+        ),
+      );
+
+      const recovery = yield* ProviderRuntimeRecovery.make.pipe(
+        Effect.provideService(
+          OrchestrationEffectWorkerV2,
+          OrchestrationEffectWorkerV2.of({
+            awaitWork: Effect.void,
+            runOnce: Effect.succeed(false),
+            nextClaimableAt: Effect.succeed(Option.none()),
+            drain: () => Effect.succeed(0),
+          }),
+        ),
+      );
+      const first = yield* recovery.recover;
+      assert.equal(first.terminalizedRuns, 1);
+      assert.equal(first.retiredEffects, 1);
+      const projection = yield* projectionStore.getThreadProjection(threadId);
+      assert.equal(projection.runs[0]?.status, "cancelled");
+      const effect = yield* outbox.get("effect:foundation-process-loss");
+      assert.isTrue(Option.isSome(effect));
+      if (Option.isSome(effect)) assert.equal(effect.value.status, "cancelled");
+
+      const second = yield* recovery.recover;
+      assert.equal(second.terminalizedRuns, 0);
+      assert.equal(second.retiredEffects, 0);
+    }),
+  );
+
+  it.effect("allocates collision-free positions beyond 100 items and rebuilds equivalently", () =>
+    Effect.gen(function* () {
+      const eventSink = yield* EventSinkV2;
+      const projectionStore = yield* ProjectionStoreV2;
+      const maintenance = yield* ProjectionMaintenanceV2;
+      const sql = yield* SqlClient.SqlClient;
+      const now = yield* DateTime.now;
+      const threadId = ThreadId.make("thread:foundation-many-items");
+      const runId = RunId.make("run:foundation-many-items");
+      const providerThreadId = ProviderThreadId.make("provider-thread:foundation-many-items");
+      const thread = makeThread(threadId, now);
+      const providerThreadEvent = {
+        id: EventId.make("event:foundation-many-items:provider-thread"),
+        type: "provider-thread.updated" as const,
+        threadId,
+        providerInstanceId,
+        occurredAt: now,
+        payload: {
+          id: providerThreadId,
+          driver: providerDriver,
+          providerInstanceId,
+          providerSessionId: null,
+          appThreadId: threadId,
+          ownerNodeId: null,
+          nativeThreadRef: null,
+          nativeConversationHeadRef: null,
+          status: "active" as const,
+          firstRunOrdinal: 1,
+          lastRunOrdinal: 1,
+          handoffIds: [],
+          forkedFrom: null,
+          createdAt: now,
+          updatedAt: now,
+        },
+      } satisfies OrchestrationV2DomainEvent;
+      const runEvent = {
+        id: EventId.make("event:foundation-many-items:run"),
+        type: "run.created" as const,
+        threadId,
+        runId,
+        providerInstanceId,
+        occurredAt: now,
+        payload: {
+          id: runId,
+          threadId,
+          ordinal: 1,
+          providerInstanceId,
+          modelSelection,
+          providerThreadId: null,
+          userMessageId: MessageId.make("message:foundation-many-items"),
+          rootNodeId: null,
+          activeAttemptId: null,
+          status: "completed" as const,
+          queuePosition: null,
+          requestedAt: now,
+          startedAt: now,
+          completedAt: now,
+          checkpointId: null,
+          contextHandoffId: null,
+        },
+      } satisfies OrchestrationV2DomainEvent;
+      const items = Array.from({ length: 151 }, (_, index) => ({
+        id: TurnItemId.make(`turn-item:foundation-many-items:${index}`),
+        threadId,
+        runId,
+        nodeId: null,
+        providerThreadId: null,
+        providerTurnId: null,
+        nativeItemRef: null,
+        parentItemId: null,
+        ordinal: index % 3,
+        status: "completed" as const,
+        title: null,
+        startedAt: now,
+        completedAt: now,
+        updatedAt: now,
+        type: "dynamic_tool" as const,
+        toolName: `tool-${index}`,
+        input: { index },
+        output: { completed: true },
+      }));
+      const itemEvents = items.map(
+        (item, index) =>
+          ({
+            id: EventId.make(`event:foundation-many-items:item:${index}`),
+            type: "turn-item.updated",
+            threadId,
+            runId,
+            providerInstanceId,
+            occurredAt: now,
+            payload: item,
+          }) satisfies OrchestrationV2DomainEvent,
+      );
+
+      yield* eventSink.write({
+        events: [
+          threadCreatedEvent({ id: "event:foundation-many-items:thread", thread, now }),
+          providerThreadEvent,
+          runEvent,
+          ...itemEvents,
+        ],
+      });
+      const beforeUpdate = yield* projectionStore.getThreadProjection(threadId);
+      assert.equal(beforeUpdate.thread.activeProviderThreadId, providerThreadId);
+      const ordinals = beforeUpdate.turnItems.map((item) => item.ordinal);
+      assert.lengthOf(ordinals, 151);
+      assert.equal(new Set(ordinals).size, 151);
+      assert.isTrue(ordinals.every((ordinal) => ordinal > 1_000_000));
+      assert.isTrue(
+        ordinals.every((ordinal, index) => index === 0 || ordinal > ordinals[index - 1]!),
+      );
+
+      yield* eventSink.write({
+        events: [
+          {
+            id: EventId.make("event:foundation-many-items:update"),
+            type: "turn-item.updated",
+            threadId,
+            runId,
+            providerInstanceId,
+            occurredAt: now,
+            payload: { ...items[0]!, ordinal: 99_999_999, title: "Updated" },
+          },
+        ],
+      });
+      const afterUpdate = yield* projectionStore.getThreadProjection(threadId);
+      assert.equal(afterUpdate.turnItems[0]?.ordinal, ordinals[0]);
+      assert.equal((yield* maintenance.verify).valid, true);
+
+      yield* sql`
+        UPDATE orchestration_v2_projection_turn_items
+        SET payload_json = '{}'
+        WHERE turn_item_id = ${items[75]!.id}
+      `;
+      const broken = yield* maintenance.verify;
+      assert.isFalse(broken.valid);
+      assert.deepEqual(broken.unreadableThreadIds, [threadId]);
+
+      const rebuilt = yield* maintenance.rebuild;
+      assert.isTrue(rebuilt.valid);
+      assert.lengthOf((yield* projectionStore.getThreadProjection(threadId)).turnItems, 151);
+    }),
+  );
+});
+
+it.live("keeps claiming new work after repeated idle periods", () =>
+  Effect.gen(function* () {
+    const outbox = yield* EffectOutboxV2;
+    const completed = new Map<string, Deferred.Deferred<void>>();
+    const executorLayer = Layer.succeed(
+      OrchestrationEffectExecutorV2,
+      OrchestrationEffectExecutorV2.of({
+        execute: (effect) => {
+          const completion = completed.get(effect.id);
+          return completion === undefined
+            ? Effect.die(`Missing completion signal for ${effect.id}`)
+            : Deferred.succeed(completion, undefined).pipe(Effect.asVoid);
+        },
+      }),
+    );
+    const workerLayer = effectWorkerLayerWithOptions({
+      workerId: "idle-wave-worker",
+    }).pipe(Layer.provide(Layer.merge(Layer.succeed(EffectOutboxV2, outbox), executorLayer)));
+
+    yield* Effect.gen(function* () {
+      yield* runEffectWorkerDaemonWithOptions({ concurrency: 2 }).pipe(Effect.forkScoped);
+      for (let wave = 1; wave <= 6; wave += 1) {
+        yield* Effect.sleep("125 millis");
+        const effectId = `effect:foundation-idle-wave:${wave}`;
+        const completion = yield* Deferred.make<void>();
+        completed.set(effectId, completion);
+        yield* outbox.enqueue([
+          {
+            id: effectId,
+            commandId: CommandId.make(`command:foundation-idle-wave:${wave}`),
+            threadId: ThreadId.make(`thread:foundation-idle-wave:${wave}`),
+            request: { type: "terminal.cleanup" },
+          },
+        ]);
+        yield* outbox.notifyAvailable();
+        const observed = yield* Deferred.await(completion).pipe(Effect.timeoutOption("2 seconds"));
+        assert.isTrue(Option.isSome(observed), `worker stopped before idle wave ${wave}`);
+      }
+    }).pipe(Effect.provide(workerLayer), Effect.scoped);
+  }).pipe(Effect.provide(TestLayer)),
+);
diff --git a/apps/server/src/orchestration-v2/GrokOrchestratorV2.live.test.ts b/apps/server/src/orchestration-v2/GrokOrchestratorV2.live.test.ts
new file mode 100644
index 000000000000..16624ff38efb
--- /dev/null
+++ b/apps/server/src/orchestration-v2/GrokOrchestratorV2.live.test.ts
@@ -0,0 +1,199 @@
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import { assert, it } from "@effect/vitest";
+import {
+  CommandId,
+  MessageId,
+  type OrchestrationV2ThreadProjection,
+  ProjectId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as Console from "effect/Console";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { FetchHttpClient } from "effect/unstable/http";
+import { describe } from "vite-plus/test";
+
+import * as CheckpointStore from "../checkpointing/CheckpointStore.ts";
+import * as BackgroundPolicy from "../background/BackgroundPolicy.ts";
+import * as HostPowerMonitor from "../background/HostPowerMonitor.ts";
+import { ServerConfig } from "../config.ts";
+import { SqlitePersistenceMemory } from "../persistence/Layers/Sqlite.ts";
+import * as ModelManifest from "../provider/ModelManifest.ts";
+import { ProviderInstanceRegistryHydrationLive } from "../provider/Layers/ProviderInstanceRegistryHydration.ts";
+import {
+  NoOpProviderEventLoggers,
+  ProviderEventLoggers,
+} from "../provider/Layers/ProviderEventLoggers.ts";
+import { OpenCodeRuntimeLive } from "../provider/opencodeRuntime.ts";
+import { ServerSettingsService } from "../serverSettings.ts";
+import * as VcsDriverRegistry from "../vcs/VcsDriverRegistry.ts";
+import * as VcsProcess from "../vcs/VcsProcess.ts";
+import { OrchestratorV2 } from "./Orchestrator.ts";
+import { worktreeRepairDependenciesTestLayer } from "./ProviderTurnStartService.testkit.ts";
+import { OrchestrationV2LayerLive } from "./runtimeLayer.ts";
+import { layer as mcpSessionRegistryTestLayer } from "../mcp/McpSessionRegistry.testkit.ts";
+import { GROK_MODEL_SELECTION } from "./testkit/fixtures/shared.ts";
+
+const serverConfigLayer = ServerConfig.layerTest(process.cwd(), {
+  prefix: "t3-grok-v2-live-",
+});
+
+const vcsDriverRegistryLayer = VcsDriverRegistry.layer.pipe(
+  Layer.provide(VcsProcess.layer),
+  Layer.provide(serverConfigLayer),
+  Layer.provide(NodeServices.layer),
+);
+
+const checkpointStoreLayer = CheckpointStore.layer.pipe(Layer.provide(vcsDriverRegistryLayer));
+
+const serverSettingsLayer = ServerSettingsService.layerTest({
+  providers: {
+    grok: { enabled: true },
+  },
+});
+const backgroundPolicyLayer = BackgroundPolicy.layer.pipe(
+  Layer.provide(Layer.effect(HostPowerMonitor.HostPowerMonitor, HostPowerMonitor.make())),
+  Layer.provide(serverSettingsLayer),
+);
+const providerInstanceRegistryLayer = ProviderInstanceRegistryHydrationLive.pipe(
+  Layer.provide(
+    Layer.mergeAll(
+      serverConfigLayer.pipe(Layer.provide(NodeServices.layer)),
+      serverSettingsLayer,
+      NodeServices.layer,
+      FetchHttpClient.layer,
+      OpenCodeRuntimeLive.pipe(Layer.provide(NodeServices.layer)),
+      Layer.succeed(ProviderEventLoggers, NoOpProviderEventLoggers),
+      ModelManifest.layerTest,
+    ),
+  ),
+);
+
+const liveLayer = OrchestrationV2LayerLive.pipe(
+  Layer.provide(worktreeRepairDependenciesTestLayer),
+  Layer.provide(mcpSessionRegistryTestLayer),
+  Layer.provide(SqlitePersistenceMemory),
+  Layer.provide(checkpointStoreLayer),
+  Layer.provide(serverConfigLayer),
+  Layer.provide(serverSettingsLayer),
+  Layer.provide(providerInstanceRegistryLayer),
+  Layer.provide(backgroundPolicyLayer),
+  Layer.provide(NodeServices.layer),
+);
+
+const waitForIdle = Effect.fn("GrokOrchestratorV2Live.waitForIdle")(function* (threadId: ThreadId) {
+  const orchestrator = yield* OrchestratorV2;
+  for (let attempt = 0; attempt < 600; attempt += 1) {
+    const projection = yield* orchestrator.getThreadProjection(threadId);
+    if (
+      projection.runs.length > 0 &&
+      projection.runs.every(
+        (run) => !["queued", "starting", "running", "waiting"].includes(run.status),
+      )
+    ) {
+      return projection;
+    }
+    yield* Effect.sleep("500 millis");
+  }
+  return yield* Effect.die(new Error(`Timed out waiting for Grok thread ${threadId}.`));
+});
+
+describe.runIf(process.env.T3_GROK_LIVE_ORCHESTRATOR === "1")("Grok V2 live orchestrator", () => {
+  it.live(
+    "forks through portable context using real Grok ACP agents",
+    () =>
+      Effect.gen(function* () {
+        const orchestrator = yield* OrchestratorV2;
+        const projectId = ProjectId.make("project:grok-live-portable-fork");
+        const sourceThreadId = ThreadId.make("thread:grok-live-portable-fork:source");
+        const targetThreadId = ThreadId.make("thread:grok-live-portable-fork:target");
+        const marker = "GROK_LIVE_PORTABLE_FORK_7H3Q";
+
+        yield* orchestrator.dispatch({
+          type: "thread.create",
+          createdBy: "user",
+          creationSource: "web",
+          commandId: CommandId.make("command:grok-live-portable-fork:create"),
+          threadId: sourceThreadId,
+          projectId,
+          title: "Grok live portable fork source",
+          modelSelection: GROK_MODEL_SELECTION,
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          branch: null,
+          worktreePath: null,
+        });
+        yield* Console.log("Grok live source thread created; dispatching source prompt.");
+        yield* orchestrator.dispatch({
+          type: "message.dispatch",
+          createdBy: "user",
+          creationSource: "web",
+          commandId: CommandId.make("command:grok-live-portable-fork:source"),
+          threadId: sourceThreadId,
+          messageId: MessageId.make("message:grok-live-portable-fork:source"),
+          text: `Remember this opaque marker. Respond with exactly: ${marker}`,
+          attachments: [],
+          modelSelection: GROK_MODEL_SELECTION,
+          dispatchMode: { type: "start_immediately" },
+        });
+        yield* Console.log("Grok live source prompt dispatched; waiting for completion.");
+        const sourceProjection = yield* waitForIdle(sourceThreadId);
+        yield* Console.log("Grok live source turn completed; dispatching portable fork.");
+
+        yield* orchestrator.dispatch({
+          type: "thread.fork",
+          createdBy: "user",
+          creationSource: "web",
+          commandId: CommandId.make("command:grok-live-portable-fork:fork"),
+          sourceThreadId,
+          targetThreadId,
+          sourcePoint: { type: "latest_stable" },
+          title: "Grok live portable fork target",
+        });
+        yield* orchestrator.dispatch({
+          type: "message.dispatch",
+          createdBy: "user",
+          creationSource: "web",
+          commandId: CommandId.make("command:grok-live-portable-fork:target"),
+          threadId: targetThreadId,
+          messageId: MessageId.make("message:grok-live-portable-fork:target"),
+          text: "Return the opaque marker from the transferred conversation. Respond with only the marker.",
+          attachments: [],
+          modelSelection: GROK_MODEL_SELECTION,
+          dispatchMode: { type: "start_immediately" },
+        });
+        const targetProjection = yield* waitForIdle(targetThreadId);
+        yield* Console.log("Grok live portable fork target completed.");
+
+        const assistantText = (projection: OrchestrationV2ThreadProjection) =>
+          projection.messages
+            .filter((message) => message.role === "assistant")
+            .map((message) => message.text)
+            .join("\n");
+
+        assert.deepEqual(
+          sourceProjection.runs.map((run) => [run.providerInstanceId, run.status]),
+          [["grok", "completed"]],
+        );
+        assert.deepEqual(
+          targetProjection.runs.map((run) => [run.providerInstanceId, run.status]),
+          [["grok", "completed"]],
+        );
+        assert.deepEqual(
+          targetProjection.contextTransfers.map((transfer) => [
+            transfer.type,
+            transfer.status,
+            transfer.resolution?.strategy,
+          ]),
+          [["fork", "consumed", "portable_context"]],
+        );
+        assert.deepEqual(
+          targetProjection.contextHandoffs.map((handoff) => handoff.strategy),
+          ["full_thread_summary"],
+        );
+        assert.include(targetProjection.contextHandoffs[0]?.summaryText ?? "", marker);
+        assert.include(assistantText(targetProjection), marker);
+      }).pipe(Effect.provide(liveLayer), Effect.scoped),
+    360_000,
+  );
+});
diff --git a/apps/server/src/orchestration-v2/IdAllocator.ts b/apps/server/src/orchestration-v2/IdAllocator.ts
new file mode 100644
index 000000000000..a3369b04f580
--- /dev/null
+++ b/apps/server/src/orchestration-v2/IdAllocator.ts
@@ -0,0 +1,407 @@
+import {
+  CheckpointId,
+  CheckpointScopeId,
+  CommandId,
+  ContextHandoffId,
+  ContextTransferId,
+  EventId,
+  MessageId,
+  NodeId,
+  PlanId,
+  ProjectId,
+  ProviderDriverKind,
+  ProviderInstanceId,
+  ProviderSessionId,
+  ProviderThreadId,
+  ProviderTurnId,
+  RawEventId,
+  RunAttemptId,
+  RunId,
+  RuntimeRequestId,
+  ThreadId,
+  TurnItemId,
+} from "@t3tools/contracts";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Schema from "effect/Schema";
+
+import { randomUuidV4 } from "./RandomUuid.ts";
+
+export const IdAllocatorV2Kind = Schema.Literals([
+  "command",
+  "event",
+  "raw_event",
+  "project",
+  "thread",
+  "message",
+  "run",
+  "run_attempt",
+  "node",
+  "provider_session",
+  "provider_thread",
+  "provider_turn",
+  "runtime_request",
+  "turn_item",
+  "checkpoint_scope",
+  "checkpoint",
+  "context_handoff",
+  "context_transfer",
+  "plan",
+]);
+export type IdAllocatorV2Kind = typeof IdAllocatorV2Kind.Type;
+
+export class IdAllocatorV2AllocationError extends Schema.TaggedErrorClass<IdAllocatorV2AllocationError>()(
+  "IdAllocatorV2AllocationError",
+  {
+    kind: IdAllocatorV2Kind,
+    input: Schema.optional(Schema.Unknown),
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to allocate orchestration ${this.kind} id.`;
+  }
+}
+
+export const IdAllocatorV2Error = Schema.Union([IdAllocatorV2AllocationError]);
+export type IdAllocatorV2Error = typeof IdAllocatorV2Error.Type;
+
+export interface IdAllocatorV2AllocateShape {
+  readonly command: (input: {
+    readonly fixtureName: string;
+    readonly commandName: string;
+  }) => Effect.Effect<CommandId, IdAllocatorV2Error>;
+  readonly event: (input: {
+    readonly threadId?: ThreadId;
+    readonly commandId?: CommandId;
+    readonly providerSessionId?: ProviderSessionId;
+  }) => Effect.Effect<EventId, IdAllocatorV2Error>;
+  readonly rawEvent: (input: {
+    readonly providerSessionId: ProviderSessionId;
+    readonly method: string | null;
+  }) => Effect.Effect<RawEventId, IdAllocatorV2Error>;
+  readonly project: (input: {
+    readonly fixtureName: string;
+  }) => Effect.Effect<ProjectId, IdAllocatorV2Error>;
+  readonly thread: (input: {
+    readonly fixtureName?: string;
+    readonly projectId?: ProjectId;
+  }) => Effect.Effect<ThreadId, IdAllocatorV2Error>;
+  readonly message: (input: {
+    readonly threadId: ThreadId;
+    readonly ordinal: number;
+  }) => Effect.Effect<MessageId, IdAllocatorV2Error>;
+  readonly providerSession: (input: {
+    readonly providerInstanceId: ProviderInstanceId;
+    readonly threadId: ThreadId;
+  }) => Effect.Effect<ProviderSessionId, IdAllocatorV2Error>;
+  readonly runtimeRequest: (input: {
+    readonly driver: ProviderDriverKind;
+    readonly providerTurnId?: ProviderTurnId;
+    readonly nativeRequestId?: string;
+  }) => Effect.Effect<RuntimeRequestId, IdAllocatorV2Error>;
+  readonly checkpointScope: (input: {
+    readonly threadId: ThreadId;
+    readonly name: string;
+  }) => Effect.Effect<CheckpointScopeId, IdAllocatorV2Error>;
+  readonly checkpoint: (input: {
+    readonly checkpointScopeId: CheckpointScopeId;
+    readonly name: string;
+  }) => Effect.Effect<CheckpointId, IdAllocatorV2Error>;
+  readonly contextHandoff: (input: {
+    readonly threadId: ThreadId;
+    readonly fromProviderInstanceId: ProviderInstanceId;
+    readonly toProviderInstanceId: ProviderInstanceId;
+  }) => Effect.Effect<ContextHandoffId, IdAllocatorV2Error>;
+  readonly contextTransfer: (input: {
+    readonly sourceThreadId: ThreadId;
+    readonly targetThreadId: ThreadId;
+    readonly type: string;
+  }) => Effect.Effect<ContextTransferId, IdAllocatorV2Error>;
+  readonly plan: (input: {
+    readonly threadId: ThreadId;
+    readonly runId?: RunId;
+    readonly driver: ProviderDriverKind;
+  }) => Effect.Effect<PlanId, IdAllocatorV2Error>;
+}
+
+export interface IdAllocatorV2DeriveShape {
+  readonly providerSession: (input: {
+    readonly providerInstanceId: ProviderInstanceId;
+  }) => ProviderSessionId;
+  readonly delegatedTaskNode: (input: { readonly commandId: CommandId }) => NodeId;
+  readonly delegatedTaskThread: (input: { readonly commandId: CommandId }) => ThreadId;
+  readonly delegatedTaskMessage: (input: { readonly commandId: CommandId }) => MessageId;
+  readonly delegatedTaskTurnItem: (input: { readonly commandId: CommandId }) => TurnItemId;
+  readonly createdThreadTurnItem: (input: { readonly commandId: CommandId }) => TurnItemId;
+  readonly threadFromProviderThread: (input: {
+    readonly driver: ProviderDriverKind;
+    readonly nativeThreadId: string;
+  }) => ThreadId;
+  readonly run: (input: { readonly threadId: ThreadId; readonly ordinal: number }) => RunId;
+  readonly runAttempt: (input: {
+    readonly runId: RunId;
+    readonly attemptOrdinal: number;
+  }) => RunAttemptId;
+  readonly rootNode: (input: { readonly runId: RunId }) => NodeId;
+  readonly rootNodeAttempt: (input: {
+    readonly runId: RunId;
+    readonly attemptOrdinal: number;
+  }) => NodeId;
+  readonly userTurnItem: (input: { readonly messageId: MessageId }) => TurnItemId;
+  readonly runSignalTurnItem: (input: {
+    readonly runId: RunId;
+    readonly signal: string;
+  }) => TurnItemId;
+  readonly providerThread: (input: {
+    readonly driver: ProviderDriverKind;
+    readonly nativeThreadId: string;
+  }) => ProviderThreadId;
+  readonly providerTurn: (input: {
+    readonly driver: ProviderDriverKind;
+    readonly nativeTurnId: string;
+  }) => ProviderTurnId;
+  readonly nodeFromProviderItem: (input: {
+    readonly driver: ProviderDriverKind;
+    readonly nativeItemId: string;
+  }) => NodeId;
+  readonly messageFromProviderItem: (input: {
+    readonly driver: ProviderDriverKind;
+    readonly nativeItemId: string;
+  }) => MessageId;
+  readonly turnItemFromProviderItem: (input: {
+    readonly driver: ProviderDriverKind;
+    readonly nativeItemId: string;
+  }) => TurnItemId;
+  readonly approvalNode: (input: { readonly requestId: RuntimeRequestId }) => NodeId;
+  readonly approvalTurnItem: (input: { readonly requestId: RuntimeRequestId }) => TurnItemId;
+}
+
+export interface IdAllocatorV2Shape {
+  readonly allocate: IdAllocatorV2AllocateShape;
+  readonly derive: IdAllocatorV2DeriveShape;
+}
+
+export class IdAllocatorV2 extends Context.Service<IdAllocatorV2, IdAllocatorV2Shape>()(
+  "t3/orchestration-v2/IdAllocator/IdAllocatorV2",
+) {}
+
+const encodePart = (part: string | number): string => encodeURIComponent(String(part));
+
+const joinId = (prefix: string, ...parts: ReadonlyArray<string | number>): string =>
+  [prefix, ...parts.map(encodePart)].join(":");
+
+const randomId =
+  <Id, Input>(input: {
+    readonly kind: IdAllocatorV2Kind;
+    readonly prefix: string;
+    readonly parts: ReadonlyArray<string | number>;
+    readonly make: (value: string) => Id;
+  }) =>
+  (allocationInput: Input): Effect.Effect<Id, IdAllocatorV2Error> =>
+    randomUuidV4.pipe(
+      Effect.map((uuid) => input.make(joinId(input.prefix, ...input.parts, uuid))),
+      Effect.mapError(
+        (cause) =>
+          new IdAllocatorV2AllocationError({
+            kind: input.kind,
+            input: allocationInput,
+            cause,
+          }),
+      ),
+    );
+
+export const layer: Layer.Layer<IdAllocatorV2> = Layer.succeed(
+  IdAllocatorV2,
+  IdAllocatorV2.of({
+    allocate: {
+      command: (input) =>
+        randomId<CommandId, typeof input>({
+          kind: "command",
+          prefix: "command",
+          parts: ["fixture", input.fixtureName, input.commandName],
+          make: CommandId.make,
+        })(input),
+      event: (input) =>
+        randomId<EventId, typeof input>({
+          kind: "event",
+          prefix: "event",
+          parts: [
+            ...(input.threadId === undefined ? [] : ["thread", input.threadId]),
+            ...(input.commandId === undefined ? [] : ["command", input.commandId]),
+            ...(input.providerSessionId === undefined
+              ? []
+              : ["provider-session", input.providerSessionId]),
+          ],
+          make: EventId.make,
+        })(input),
+      rawEvent: (input) =>
+        randomId<RawEventId, typeof input>({
+          kind: "raw_event",
+          prefix: "raw-event",
+          parts: [
+            "provider-session",
+            input.providerSessionId,
+            ...(input.method === null ? [] : ["method", input.method]),
+          ],
+          make: RawEventId.make,
+        })(input),
+      project: (input) =>
+        randomId<ProjectId, typeof input>({
+          kind: "project",
+          prefix: "project",
+          parts: ["fixture", input.fixtureName],
+          make: ProjectId.make,
+        })(input),
+      thread: (input) =>
+        randomId<ThreadId, typeof input>({
+          kind: "thread",
+          prefix: "thread",
+          parts: [
+            ...(input.fixtureName === undefined ? [] : ["fixture", input.fixtureName]),
+            ...(input.projectId === undefined ? [] : ["project", input.projectId]),
+          ],
+          make: ThreadId.make,
+        })(input),
+      message: (input) =>
+        randomId<MessageId, typeof input>({
+          kind: "message",
+          prefix: "message",
+          parts: ["thread", input.threadId, "ordinal", input.ordinal],
+          make: MessageId.make,
+        })(input),
+      providerSession: (input) =>
+        randomId<ProviderSessionId, typeof input>({
+          kind: "provider_session",
+          prefix: "provider-session",
+          parts: ["provider-instance", input.providerInstanceId, "thread", input.threadId],
+          make: ProviderSessionId.make,
+        })(input),
+      runtimeRequest: (input) =>
+        randomId<RuntimeRequestId, typeof input>({
+          kind: "runtime_request",
+          prefix: "runtime-request",
+          parts: [
+            "provider",
+            input.driver,
+            ...(input.providerTurnId === undefined ? [] : ["provider-turn", input.providerTurnId]),
+            ...(input.nativeRequestId === undefined
+              ? []
+              : ["native-request", input.nativeRequestId]),
+          ],
+          make: RuntimeRequestId.make,
+        })(input),
+      checkpointScope: (input) =>
+        Effect.succeed(
+          CheckpointScopeId.make(
+            joinId("checkpoint-scope", "thread", input.threadId, "name", input.name),
+          ),
+        ),
+      checkpoint: (input) =>
+        Effect.succeed(
+          CheckpointId.make(
+            joinId("checkpoint", "scope", input.checkpointScopeId, "name", input.name),
+          ),
+        ),
+      contextHandoff: (input) =>
+        randomId<ContextHandoffId, typeof input>({
+          kind: "context_handoff",
+          prefix: "context-handoff",
+          parts: [
+            "thread",
+            input.threadId,
+            "from-provider-instance",
+            input.fromProviderInstanceId,
+            "to-provider-instance",
+            input.toProviderInstanceId,
+          ],
+          make: ContextHandoffId.make,
+        })(input),
+      contextTransfer: (input) =>
+        randomId<ContextTransferId, typeof input>({
+          kind: "context_transfer",
+          prefix: "context-transfer",
+          parts: [
+            "type",
+            input.type,
+            "source-thread",
+            input.sourceThreadId,
+            "target-thread",
+            input.targetThreadId,
+          ],
+          make: ContextTransferId.make,
+        })(input),
+      plan: (input) =>
+        randomId<PlanId, typeof input>({
+          kind: "plan",
+          prefix: "plan",
+          parts: [
+            "thread",
+            input.threadId,
+            "provider",
+            input.driver,
+            ...(input.runId === undefined ? [] : ["run", input.runId]),
+          ],
+          make: PlanId.make,
+        })(input),
+    },
+    derive: {
+      providerSession: (input) =>
+        ProviderSessionId.make(
+          joinId("provider-session", "provider-instance", input.providerInstanceId, "shared"),
+        ),
+      delegatedTaskNode: (input) => NodeId.make(joinId("node", "delegated-task", input.commandId)),
+      delegatedTaskThread: (input) =>
+        ThreadId.make(joinId("thread", "delegated-task", input.commandId)),
+      delegatedTaskMessage: (input) =>
+        MessageId.make(joinId("message", "delegated-task", input.commandId)),
+      delegatedTaskTurnItem: (input) =>
+        TurnItemId.make(joinId("turn-item", "delegated-task", input.commandId)),
+      createdThreadTurnItem: (input) =>
+        TurnItemId.make(joinId("turn-item", "created-thread", input.commandId)),
+      threadFromProviderThread: (input) =>
+        ThreadId.make(
+          joinId("thread", "provider", input.driver, "native-thread", input.nativeThreadId),
+        ),
+      run: (input) => RunId.make(joinId("run", "thread", input.threadId, "ordinal", input.ordinal)),
+      runAttempt: (input) =>
+        RunAttemptId.make(
+          joinId("run-attempt", "run", input.runId, "attempt", input.attemptOrdinal),
+        ),
+      rootNode: (input) => NodeId.make(joinId("node", "run", input.runId, "root")),
+      rootNodeAttempt: (input) =>
+        NodeId.make(joinId("node", "run", input.runId, "attempt", input.attemptOrdinal, "root")),
+      userTurnItem: (input) => TurnItemId.make(joinId("turn-item", "message", input.messageId)),
+      runSignalTurnItem: (input) =>
+        TurnItemId.make(joinId("turn-item", "run", input.runId, "signal", input.signal)),
+      providerThread: (input) =>
+        ProviderThreadId.make(
+          joinId(
+            "provider-thread",
+            "provider",
+            input.driver,
+            "native-thread",
+            input.nativeThreadId,
+          ),
+        ),
+      providerTurn: (input) =>
+        ProviderTurnId.make(
+          joinId("provider-turn", "provider", input.driver, "native-turn", input.nativeTurnId),
+        ),
+      nodeFromProviderItem: (input) =>
+        NodeId.make(joinId("node", "provider", input.driver, "native-item", input.nativeItemId)),
+      messageFromProviderItem: (input) =>
+        MessageId.make(
+          joinId("message", "provider", input.driver, "native-item", input.nativeItemId),
+        ),
+      turnItemFromProviderItem: (input) =>
+        TurnItemId.make(
+          joinId("turn-item", "provider", input.driver, "native-item", input.nativeItemId),
+        ),
+      approvalNode: (input) => NodeId.make(joinId("node", "runtime-request", input.requestId)),
+      approvalTurnItem: (input) =>
+        TurnItemId.make(joinId("turn-item", "runtime-request", input.requestId)),
+    },
+  }),
+);
diff --git a/apps/server/src/orchestration-v2/KeyedSerialExecutor.test.ts b/apps/server/src/orchestration-v2/KeyedSerialExecutor.test.ts
new file mode 100644
index 000000000000..6f376b9f330e
--- /dev/null
+++ b/apps/server/src/orchestration-v2/KeyedSerialExecutor.test.ts
@@ -0,0 +1,67 @@
+import { describe, expect, it } from "@effect/vitest";
+
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+import * as Fiber from "effect/Fiber";
+import * as Queue from "effect/Queue";
+import * as Ref from "effect/Ref";
+
+import { makeKeyedSerialExecutor } from "./KeyedSerialExecutor.ts";
+
+describe("makeKeyedSerialExecutor", () => {
+  it.effect("allows unrelated keys to run concurrently", () =>
+    Effect.gen(function* () {
+      const executor = yield* makeKeyedSerialExecutor<string>();
+      const arrivals = yield* Queue.unbounded<string>();
+      const release = yield* Deferred.make<void>();
+      const run = (key: string) =>
+        executor.withLock(
+          key,
+          Queue.offer(arrivals, key).pipe(Effect.andThen(Deferred.await(release))),
+        );
+
+      const fibers = yield* Effect.forEach(["a", "b"], run, {
+        concurrency: "unbounded",
+        discard: false,
+      }).pipe(Effect.forkChild);
+      const observed = [yield* Queue.take(arrivals), yield* Queue.take(arrivals)];
+      yield* Deferred.succeed(release, undefined);
+      yield* Fiber.join(fibers);
+      expect(new Set(observed)).toEqual(new Set(["a", "b"]));
+    }).pipe(Effect.timeout("1 second")),
+  );
+
+  it.effect("serializes work for the same key", () =>
+    Effect.gen(function* () {
+      const executor = yield* makeKeyedSerialExecutor<string>();
+      const firstEntered = yield* Deferred.make<void>();
+      const releaseFirst = yield* Deferred.make<void>();
+      const events = yield* Ref.make<Array<string>>([]);
+
+      const first = yield* executor
+        .withLock(
+          "thread",
+          Ref.update(events, (current) => [...current, "first:start"]).pipe(
+            Effect.andThen(Deferred.succeed(firstEntered, undefined)),
+            Effect.andThen(Deferred.await(releaseFirst)),
+            Effect.andThen(Ref.update(events, (current) => [...current, "first:end"])),
+          ),
+        )
+        .pipe(Effect.forkChild);
+      yield* Deferred.await(firstEntered);
+      const second = yield* executor
+        .withLock(
+          "thread",
+          Ref.update(events, (current) => [...current, "second:start"]),
+        )
+        .pipe(Effect.forkChild);
+
+      yield* Effect.yieldNow;
+      expect(yield* Ref.get(events)).toEqual(["first:start"]);
+      yield* Deferred.succeed(releaseFirst, undefined);
+      yield* Fiber.join(first);
+      yield* Fiber.join(second);
+      expect(yield* Ref.get(events)).toEqual(["first:start", "first:end", "second:start"]);
+    }).pipe(Effect.timeout("1 second")),
+  );
+});
diff --git a/apps/server/src/orchestration-v2/KeyedSerialExecutor.ts b/apps/server/src/orchestration-v2/KeyedSerialExecutor.ts
new file mode 100644
index 000000000000..93dbe04bbbfd
--- /dev/null
+++ b/apps/server/src/orchestration-v2/KeyedSerialExecutor.ts
@@ -0,0 +1,55 @@
+import * as Effect from "effect/Effect";
+import * as Ref from "effect/Ref";
+import * as Semaphore from "effect/Semaphore";
+
+interface LockEntry {
+  readonly semaphore: Semaphore.Semaphore;
+  readonly users: number;
+}
+
+export interface KeyedSerialExecutor<Key> {
+  readonly withLock: <A, E, R>(key: Key, effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
+}
+
+/**
+ * Serializes work that targets the same domain identity without coupling
+ * unrelated identities to a process-wide mutex.
+ */
+export const makeKeyedSerialExecutor = <Key>(): Effect.Effect<KeyedSerialExecutor<Key>> =>
+  Effect.gen(function* () {
+    const locks = yield* Ref.make(new Map<Key, LockEntry>());
+
+    const acquireLock = (key: Key) =>
+      Effect.gen(function* () {
+        const candidate = yield* Semaphore.make(1);
+        return yield* Ref.modify(locks, (current) => {
+          const existing = current.get(key);
+          const semaphore = existing?.semaphore ?? candidate;
+          const next = new Map(current);
+          next.set(key, { semaphore, users: (existing?.users ?? 0) + 1 });
+          return [semaphore, next] as const;
+        });
+      });
+
+    const releaseLock = (key: Key) =>
+      Ref.update(locks, (current) => {
+        const existing = current.get(key);
+        if (existing === undefined) return current;
+        const next = new Map(current);
+        if (existing.users === 1) {
+          next.delete(key);
+        } else {
+          next.set(key, { ...existing, users: existing.users - 1 });
+        }
+        return next;
+      });
+
+    return {
+      withLock: (key, effect) =>
+        Effect.acquireUseRelease(
+          acquireLock(key),
+          (semaphore) => semaphore.withPermit(effect),
+          () => releaseLock(key),
+        ),
+    } satisfies KeyedSerialExecutor<Key>;
+  });
diff --git a/apps/server/src/orchestration-v2/LegacyV1ThreadImporter.test.ts b/apps/server/src/orchestration-v2/LegacyV1ThreadImporter.test.ts
new file mode 100644
index 000000000000..9565e6de4ee5
--- /dev/null
+++ b/apps/server/src/orchestration-v2/LegacyV1ThreadImporter.test.ts
@@ -0,0 +1,344 @@
+import { assert, it } from "@effect/vitest";
+import { EventId, ThreadId } from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as SqlClient from "effect/unstable/sql/SqlClient";
+
+import { SqlitePersistenceMemory } from "../persistence/Layers/Sqlite.ts";
+import { EventSinkV2, layer as eventSinkLayer } from "./EventSink.ts";
+import { layer as eventStoreLayer } from "./EventStore.ts";
+import {
+  LegacyV1ThreadImporter,
+  layer as legacyV1ThreadImporterLayer,
+} from "./LegacyV1ThreadImporter.ts";
+import {
+  ProjectionMaintenanceV2,
+  layer as projectionMaintenanceLayer,
+} from "./ProjectionMaintenance.ts";
+import { ProjectionStoreV2, layer as projectionStoreLayer } from "./ProjectionStore.ts";
+
+const databaseLayer = SqlitePersistenceMemory;
+const eventStoreProvided = eventStoreLayer.pipe(Layer.provideMerge(databaseLayer));
+const projectionStoreProvided = projectionStoreLayer.pipe(Layer.provideMerge(databaseLayer));
+const storesProvided = Layer.mergeAll(databaseLayer, eventStoreProvided, projectionStoreProvided);
+const eventSinkProvided = eventSinkLayer.pipe(Layer.provide(storesProvided));
+const importerProvided = legacyV1ThreadImporterLayer.pipe(
+  Layer.provide(Layer.mergeAll(storesProvided, eventSinkProvided)),
+);
+const projectionMaintenanceProvided = projectionMaintenanceLayer.pipe(
+  Layer.provide(storesProvided),
+);
+const TestLayer = Layer.mergeAll(
+  storesProvided,
+  eventSinkProvided,
+  importerProvided,
+  projectionMaintenanceProvided,
+);
+
+it.layer(TestLayer)("LegacyV1ThreadImporter", (it) => {
+  it.effect("imports lightweight shells, hydrates transcripts, and remains idempotent", () =>
+    Effect.gen(function* () {
+      const sql = yield* SqlClient.SqlClient;
+      const importer = yield* LegacyV1ThreadImporter;
+      const maintenance = yield* ProjectionMaintenanceV2;
+      const projections = yield* ProjectionStoreV2;
+      const eventSink = yield* EventSinkV2;
+      const threadId = ThreadId.make("thread:legacy-import");
+
+      yield* sql`
+        INSERT INTO projection_projects (
+          project_id,
+          title,
+          workspace_root,
+          default_model_selection_json,
+          scripts_json,
+          created_at,
+          updated_at,
+          deleted_at
+        ) VALUES (
+          'project:legacy-import',
+          'Legacy project',
+          '/tmp/legacy-project',
+          '{"instanceId":"codex","model":"gpt-5.4"}',
+          '[]',
+          '2026-01-01T00:00:00.000Z',
+          '2026-01-04T00:00:00.000Z',
+          NULL
+        )
+      `;
+      yield* sql`
+        INSERT INTO projection_threads (
+          thread_id,
+          project_id,
+          title,
+          model_selection_json,
+          runtime_mode,
+          interaction_mode,
+          branch,
+          worktree_path,
+          latest_turn_id,
+          created_at,
+          updated_at,
+          archived_at,
+          settled_override,
+          settled_at,
+          unsettled_at,
+          snoozed_until,
+          snoozed_at,
+          pinned_at,
+          pin_order_key,
+          linked_pull_request_json,
+          deleted_at
+        ) VALUES (
+          ${threadId},
+          'project:legacy-import',
+          'Migrated conversation',
+          '{"instanceId":"codex","model":"gpt-5.4"}',
+          'full-access',
+          'default',
+          ' main ',
+          ' /tmp/legacy-project ',
+          NULL,
+          '2026-01-01T00:00:00.000Z',
+          '2026-01-04T00:00:00.000Z',
+          NULL,
+          NULL,
+          NULL,
+          '2026-01-03T12:00:00.000Z',
+          '2026-02-01T00:00:00.000Z',
+          '2026-01-04T00:00:00.000Z',
+          '2026-01-02T00:00:00.000Z',
+          'm',
+          '{"projectId":"project:legacy-import","repository":"pingdotgg/t3code","number":9000,"url":"https://github.com/pingdotgg/t3code/pull/9000"}',
+          NULL
+        )
+      `;
+      yield* sql`
+        INSERT INTO projection_thread_messages (
+          message_id,
+          thread_id,
+          turn_id,
+          role,
+          text,
+          attachments_json,
+          is_streaming,
+          created_at,
+          updated_at
+        ) VALUES
+          (
+            'message:legacy:1',
+            ${threadId},
+            NULL,
+            'user',
+            'First question',
+            '[]',
+            0,
+            '2026-01-01T01:00:00.000Z',
+            '2026-01-01T01:00:00.000Z'
+          ),
+          (
+            'message:legacy:2',
+            ${threadId},
+            NULL,
+            'assistant',
+            'First answer',
+            '[]',
+            0,
+            '2026-01-02T01:00:00.000Z',
+            '2026-01-02T01:00:00.000Z'
+          ),
+          (
+            'message:legacy:3',
+            ${threadId},
+            NULL,
+            'user',
+            'Follow-up question',
+            '[]',
+            0,
+            '2026-01-03T01:00:00.000Z',
+            '2026-01-03T01:00:00.000Z'
+          ),
+          (
+            'message:legacy:4',
+            ${threadId},
+            NULL,
+            'assistant',
+            'Partial answer',
+            '[]',
+            1,
+            '2026-01-04T01:00:00.000Z',
+            '2026-01-04T01:00:00.000Z'
+        )
+      `;
+
+      assert.equal(yield* importer.pendingThreadCount, 1);
+      const shellImport = yield* importer.reconcileShells;
+      assert.equal(yield* importer.pendingThreadCount, 1);
+      assert.deepStrictEqual(shellImport, {
+        importedThreadCount: 1,
+        importedMessageCount: 2,
+      });
+      const shellEventCount = yield* sql<{ readonly count: number }>`
+        SELECT COUNT(*) AS count
+        FROM orchestration_events
+        WHERE application_event_version = 2
+          AND aggregate_kind = 'thread'
+          AND stream_id = ${threadId}
+      `;
+      assert.equal(shellEventCount[0]?.count, 6);
+
+      const rebuilt = yield* maintenance.rebuild;
+      assert.isTrue(rebuilt.valid);
+      const shellProjection = yield* projections.getThreadProjection(threadId);
+      assert.equal(shellProjection.thread.historyOrigin, "v1_import");
+      assert.equal(shellProjection.thread.branch, "main");
+      assert.equal(shellProjection.thread.worktreePath, "/tmp/legacy-project");
+      assert.deepEqual(
+        shellProjection.thread.pinnedAt,
+        DateTime.makeUnsafe("2026-01-02T00:00:00.000Z"),
+      );
+      assert.equal(shellProjection.thread.pinOrderKey, "m");
+      assert.deepEqual(
+        shellProjection.thread.snoozedUntil,
+        DateTime.makeUnsafe("2026-02-01T00:00:00.000Z"),
+      );
+      assert.deepEqual(
+        shellProjection.thread.unsettledAt,
+        DateTime.makeUnsafe("2026-01-03T12:00:00.000Z"),
+      );
+      assert.equal(shellProjection.thread.linkedPullRequest?.number, 9000);
+      const shellSnapshot = yield* projections.getShellSnapshot();
+      assert.equal(
+        shellSnapshot.threads.find((thread) => thread.id === threadId)?.historyOrigin,
+        "v1_import",
+      );
+      assert.deepStrictEqual(
+        shellProjection.messages.map((message) => message.id),
+        ["message:legacy:3", "message:legacy:4"],
+      );
+
+      const renamedAt = DateTime.makeUnsafe("2026-01-05T00:00:00.000Z");
+      yield* eventSink.write({
+        events: [
+          {
+            id: EventId.make("event:legacy-import:metadata-after-shell"),
+            type: "thread.metadata-updated",
+            threadId,
+            providerInstanceId: shellProjection.thread.providerInstanceId,
+            occurredAt: renamedAt,
+            payload: {
+              ...shellProjection.thread,
+              title: "Renamed after shell import",
+              runtimeMode: "approval-required",
+              interactionMode: "plan",
+              archivedAt: renamedAt,
+              settledOverride: "settled",
+              settledAt: renamedAt,
+              updatedAt: renamedAt,
+            },
+          },
+        ],
+      });
+
+      const transcriptImport = yield* importer.ensureTranscript(threadId);
+      assert.equal(yield* importer.pendingThreadCount, 0);
+      assert.deepStrictEqual(transcriptImport, {
+        importedThreadCount: 1,
+        importedMessageCount: 2,
+      });
+      const projection = yield* projections.getThreadProjection(threadId);
+      assert.equal(projection.thread.title, "Renamed after shell import");
+      assert.equal(projection.thread.runtimeMode, "approval-required");
+      assert.equal(projection.thread.interactionMode, "plan");
+      assert.deepEqual(projection.thread.archivedAt, renamedAt);
+      assert.equal(projection.thread.settledOverride, "settled");
+      assert.deepEqual(projection.thread.settledAt, renamedAt);
+      assert.deepStrictEqual(
+        projection.messages.map((message) => message.id),
+        ["message:legacy:1", "message:legacy:2", "message:legacy:3", "message:legacy:4"],
+      );
+      assert.deepStrictEqual(
+        projection.turnItems
+          .filter(
+            (
+              item,
+            ): item is Extract<
+              (typeof projection.turnItems)[number],
+              { readonly type: "user_message" | "assistant_message" }
+            > => item.type === "user_message" || item.type === "assistant_message",
+          )
+          .map((item) => [item.messageId, item.ordinal, item.status]),
+        [
+          ["message:legacy:1", 1, "completed"],
+          ["message:legacy:2", 2, "completed"],
+          ["message:legacy:3", 3, "completed"],
+          ["message:legacy:4", 4, "interrupted"],
+        ],
+      );
+
+      yield* eventSink.write({
+        events: [
+          {
+            id: EventId.make("event:legacy-import:explicit-unpin"),
+            type: "thread.unpinned",
+            threadId,
+            providerInstanceId: projection.thread.providerInstanceId,
+            occurredAt: renamedAt,
+            payload: { ...projection.thread, pinnedAt: null, pinOrderKey: null },
+          },
+        ],
+      });
+      yield* sql`
+        UPDATE orchestration_v2_projection_threads
+        SET payload_json = json_remove(
+          payload_json,
+          '$.snoozedUntil',
+          '$.snoozedAt',
+          '$.unsettledAt',
+          '$.linkedPullRequest'
+        )
+        WHERE thread_id = ${threadId}
+      `;
+      assert.deepStrictEqual(yield* importer.reconcileShells, {
+        importedThreadCount: 1,
+        importedMessageCount: 0,
+      });
+      const repaired = yield* projections.getThreadProjection(threadId);
+      assert.isNull(repaired.thread.pinnedAt);
+      assert.isNull(repaired.thread.pinOrderKey);
+      assert.deepEqual(
+        repaired.thread.snoozedUntil,
+        DateTime.makeUnsafe("2026-02-01T00:00:00.000Z"),
+      );
+      assert.deepEqual(
+        repaired.thread.unsettledAt,
+        DateTime.makeUnsafe("2026-01-03T12:00:00.000Z"),
+      );
+      assert.equal(repaired.thread.linkedPullRequest?.number, 9000);
+      const eventCountBeforeRetry = yield* sql<{ readonly count: number }>`
+        SELECT COUNT(*) AS count
+        FROM orchestration_events
+        WHERE application_event_version = 2
+          AND aggregate_kind = 'thread'
+          AND stream_id = ${threadId}
+      `;
+      assert.deepStrictEqual(yield* importer.reconcileShells, {
+        importedThreadCount: 0,
+        importedMessageCount: 0,
+      });
+      assert.deepStrictEqual(yield* importer.ensureTranscript(threadId), {
+        importedThreadCount: 0,
+        importedMessageCount: 0,
+      });
+      const eventCountAfterRetry = yield* sql<{ readonly count: number }>`
+        SELECT COUNT(*) AS count
+        FROM orchestration_events
+        WHERE application_event_version = 2
+          AND aggregate_kind = 'thread'
+          AND stream_id = ${threadId}
+      `;
+      assert.equal(eventCountAfterRetry[0]?.count, eventCountBeforeRetry[0]?.count);
+    }),
+  );
+});
diff --git a/apps/server/src/orchestration-v2/LegacyV1ThreadImporter.ts b/apps/server/src/orchestration-v2/LegacyV1ThreadImporter.ts
new file mode 100644
index 000000000000..554358cd3bce
--- /dev/null
+++ b/apps/server/src/orchestration-v2/LegacyV1ThreadImporter.ts
@@ -0,0 +1,739 @@
+import {
+  ChatAttachment,
+  DEFAULT_MODEL,
+  EventId,
+  MessageId,
+  ModelSelection,
+  type OrchestrationV2AppThread,
+  OrchestrationV2AppThreadJson,
+  type OrchestrationV2ConversationMessage,
+  type OrchestrationV2DomainEvent,
+  type OrchestrationV2TurnItem,
+  ProjectId,
+  ProviderInstanceId,
+  ThreadId,
+  ThreadLinkedPullRequest,
+  TurnItemId,
+} from "@t3tools/contracts";
+import * as Context from "effect/Context";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Schema from "effect/Schema";
+import * as SqlClient from "effect/unstable/sql/SqlClient";
+
+import { EventSinkV2 } from "./EventSink.ts";
+import { EventStoreV2 } from "./EventStore.ts";
+import { makeKeyedSerialExecutor } from "./KeyedSerialExecutor.ts";
+
+const IMPORT_EVENT_PREFIX = "migration:v1";
+const TRANSCRIPT_EVENT_BATCH_SIZE = 100;
+
+interface LegacyThreadRow {
+  readonly thread_id: string;
+  readonly project_id: string;
+  readonly title: string;
+  readonly model_selection_json: string | null;
+  readonly runtime_mode: string;
+  readonly interaction_mode: string;
+  readonly branch: string | null;
+  readonly worktree_path: string | null;
+  readonly created_at: string;
+  readonly updated_at: string;
+  readonly archived_at: string | null;
+  readonly settled_override: string | null;
+  readonly settled_at: string | null;
+  readonly unsettled_at: string | null;
+  readonly snoozed_until: string | null;
+  readonly snoozed_at: string | null;
+  readonly pinned_at: string | null;
+  readonly pin_order_key: string | null;
+  readonly linked_pull_request_json: string | null;
+  readonly deleted_at: string | null;
+}
+
+interface LegacyRepairRow extends LegacyThreadRow {
+  readonly payload_json: string;
+}
+
+interface LegacyMessageRow {
+  readonly message_id: string;
+  readonly thread_id: string;
+  readonly role: "user" | "assistant";
+  readonly text: string;
+  readonly attachments_json: string | null;
+  readonly is_streaming: number;
+  readonly created_at: string;
+  readonly updated_at: string;
+  readonly ordinal: number;
+}
+
+interface LegacyImportRow {
+  readonly thread_id: string;
+  readonly transcript_imported_at: string | null;
+}
+
+export interface LegacyV1ImportSummary {
+  readonly importedThreadCount: number;
+  readonly importedMessageCount: number;
+}
+
+export class LegacyV1ThreadImportError extends Schema.TaggedErrorClass<LegacyV1ThreadImportError>()(
+  "LegacyV1ThreadImportError",
+  {
+    operation: Schema.String,
+    threadId: Schema.optional(ThreadId),
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return this.threadId === undefined
+      ? `Failed to ${this.operation} legacy v1 threads.`
+      : `Failed to ${this.operation} legacy v1 thread ${this.threadId}.`;
+  }
+}
+
+export interface LegacyV1ThreadImporterShape {
+  readonly pendingThreadCount: Effect.Effect<number, LegacyV1ThreadImportError>;
+  readonly reconcileShells: Effect.Effect<LegacyV1ImportSummary, LegacyV1ThreadImportError>;
+  readonly ensureTranscript: (
+    threadId: ThreadId,
+  ) => Effect.Effect<LegacyV1ImportSummary, LegacyV1ThreadImportError>;
+  readonly importPendingTranscripts: Effect.Effect<LegacyV1ImportSummary, never>;
+}
+
+export class LegacyV1ThreadImporter extends Context.Service<
+  LegacyV1ThreadImporter,
+  LegacyV1ThreadImporterShape
+>()("t3/orchestration-v2/LegacyV1ThreadImporter") {}
+
+const decodeModelSelection = Schema.decodeUnknownOption(ModelSelection);
+const decodeAttachments = Schema.decodeUnknownOption(Schema.Array(ChatAttachment));
+const decodeLinkedPullRequest = Schema.decodeUnknownOption(ThreadLinkedPullRequest);
+const decodeStoredThread = Schema.decodeUnknownOption(
+  Schema.fromJsonString(OrchestrationV2AppThreadJson),
+);
+
+function parseJson(json: string): unknown {
+  try {
+    return JSON.parse(json);
+  } catch {
+    return undefined;
+  }
+}
+
+function modelSelectionFor(row: LegacyThreadRow) {
+  const decoded =
+    row.model_selection_json === null
+      ? Option.none()
+      : decodeModelSelection(parseJson(row.model_selection_json));
+  return Option.getOrElse(decoded, () => ({
+    instanceId: ProviderInstanceId.make("codex"),
+    model: DEFAULT_MODEL,
+  }));
+}
+
+function attachmentsFor(row: LegacyMessageRow) {
+  if (row.attachments_json === null) return [];
+  return Option.getOrElse(decodeAttachments(parseJson(row.attachments_json)), () => []);
+}
+
+function linkedPullRequestFor(row: LegacyThreadRow) {
+  if (row.linked_pull_request_json === null) return null;
+  return Option.getOrNull(decodeLinkedPullRequest(parseJson(row.linked_pull_request_json)));
+}
+
+function runtimeModeFor(value: string): OrchestrationV2AppThread["runtimeMode"] {
+  return value === "approval-required" ||
+    value === "auto-accept-edits" ||
+    value === "auto" ||
+    value === "full-access"
+    ? value
+    : "full-access";
+}
+
+function interactionModeFor(value: string): OrchestrationV2AppThread["interactionMode"] {
+  return value === "plan" ? "plan" : "default";
+}
+
+function settledOverrideFor(value: string | null): OrchestrationV2AppThread["settledOverride"] {
+  return value === "settled" || value === "active" ? value : null;
+}
+
+function dateTime(value: string): DateTime.Utc {
+  return DateTime.makeUnsafe(value);
+}
+
+function nullableDateTime(value: string | null): DateTime.Utc | null {
+  return value === null ? null : dateTime(value);
+}
+
+function importedThread(row: LegacyThreadRow): OrchestrationV2AppThread {
+  const threadId = ThreadId.make(row.thread_id);
+  const modelSelection = modelSelectionFor(row);
+  const branch = row.branch?.trim() || null;
+  const worktreePath = row.worktree_path?.trim() || null;
+  return {
+    createdBy: "system",
+    creationSource: "server",
+    id: threadId,
+    projectId: ProjectId.make(row.project_id),
+    title: row.title.trim() === "" ? "Untitled thread" : row.title,
+    providerInstanceId: modelSelection.instanceId,
+    modelSelection,
+    runtimeMode: runtimeModeFor(row.runtime_mode),
+    interactionMode: interactionModeFor(row.interaction_mode),
+    branch,
+    worktreePath,
+    linkedPullRequest: linkedPullRequestFor(row),
+    activeProviderThreadId: null,
+    historyOrigin: "v1_import",
+    lineage: {
+      parentThreadId: null,
+      relationshipToParent: null,
+      rootThreadId: threadId,
+    },
+    forkedFrom: null,
+    createdAt: dateTime(row.created_at),
+    updatedAt: dateTime(row.updated_at),
+    archivedAt: nullableDateTime(row.archived_at),
+    settledOverride: settledOverrideFor(row.settled_override),
+    settledAt: nullableDateTime(row.settled_at),
+    unsettledAt: nullableDateTime(row.unsettled_at),
+    snoozedUntil: nullableDateTime(row.snoozed_until),
+    snoozedAt: nullableDateTime(row.snoozed_at),
+    pinnedAt: nullableDateTime(row.pinned_at),
+    pinOrderKey: row.pin_order_key?.trim() || null,
+    lastVisitedAt: null,
+    deletedAt: nullableDateTime(row.deleted_at),
+  };
+}
+
+function messageEvents(row: LegacyMessageRow): ReadonlyArray<OrchestrationV2DomainEvent> {
+  const threadId = ThreadId.make(row.thread_id);
+  const messageId = MessageId.make(row.message_id);
+  const createdAt = dateTime(row.created_at);
+  const updatedAt = dateTime(row.updated_at);
+  const attachments = attachmentsFor(row);
+  const message: OrchestrationV2ConversationMessage = {
+    createdBy: row.role === "user" ? "user" : "agent",
+    creationSource: "server",
+    id: messageId,
+    threadId,
+    runId: null,
+    nodeId: null,
+    role: row.role,
+    text: row.text,
+    attachments,
+    streaming: false,
+    createdAt,
+    updatedAt,
+  };
+  const baseTurnItem = {
+    id: TurnItemId.make(`${IMPORT_EVENT_PREFIX}:turn-item:${row.message_id}`),
+    threadId,
+    runId: null,
+    nodeId: null,
+    providerThreadId: null,
+    providerTurnId: null,
+    nativeItemRef: null,
+    parentItemId: null,
+    ordinal: row.ordinal,
+    status: row.is_streaming === 1 ? ("interrupted" as const) : ("completed" as const),
+    title: null,
+    startedAt: createdAt,
+    completedAt: updatedAt,
+    updatedAt,
+  };
+  const turnItem: OrchestrationV2TurnItem =
+    row.role === "user"
+      ? {
+          ...baseTurnItem,
+          createdBy: "user",
+          creationSource: "server",
+          type: "user_message",
+          messageId,
+          inputIntent: "turn_start",
+          text: row.text,
+          attachments,
+        }
+      : {
+          ...baseTurnItem,
+          type: "assistant_message",
+          messageId,
+          text: row.text,
+          streaming: false,
+        };
+  return [
+    {
+      id: EventId.make(`${IMPORT_EVENT_PREFIX}:message:${row.message_id}`),
+      type: "message.updated",
+      threadId,
+      occurredAt: updatedAt,
+      payload: message,
+    },
+    {
+      id: EventId.make(`${IMPORT_EVENT_PREFIX}:turn-item:${row.message_id}`),
+      type: "turn-item.updated",
+      threadId,
+      occurredAt: updatedAt,
+      payload: turnItem,
+    },
+  ];
+}
+
+function chunks<A>(items: ReadonlyArray<A>, size: number): Array<ReadonlyArray<A>> {
+  const result: Array<ReadonlyArray<A>> = [];
+  for (let index = 0; index < items.length; index += size) {
+    result.push(items.slice(index, index + size));
+  }
+  return result;
+}
+
+const make = Effect.gen(function* () {
+  const sql = yield* SqlClient.SqlClient;
+  const eventStore = yield* EventStoreV2;
+  const eventSink = yield* EventSinkV2;
+  const transcriptImports = yield* makeKeyedSerialExecutor<ThreadId>();
+
+  const listMessages = (threadId: ThreadId) =>
+    sql<LegacyMessageRow>`
+      SELECT
+        message_id,
+        thread_id,
+        role,
+        text,
+        attachments_json,
+        is_streaming,
+        created_at,
+        updated_at,
+        ROW_NUMBER() OVER (
+          PARTITION BY thread_id
+          ORDER BY created_at ASC, message_id ASC
+        ) AS ordinal
+      FROM projection_thread_messages
+      WHERE thread_id = ${threadId}
+        AND role IN ('user', 'assistant')
+      ORDER BY created_at ASC, message_id ASC
+    `;
+
+  const listShellMessages = (threadId: ThreadId) =>
+    Effect.gen(function* () {
+      const latest = yield* sql<LegacyMessageRow>`
+        SELECT
+          message.message_id,
+          message.thread_id,
+          message.role,
+          message.text,
+          message.attachments_json,
+          message.is_streaming,
+          message.created_at,
+          message.updated_at,
+          (
+            SELECT COUNT(*)
+            FROM projection_thread_messages AS earlier
+            WHERE earlier.thread_id = message.thread_id
+              AND earlier.role IN ('user', 'assistant')
+              AND (
+                earlier.created_at < message.created_at
+                OR (
+                  earlier.created_at = message.created_at
+                  AND earlier.message_id <= message.message_id
+                )
+              )
+          ) AS ordinal
+        FROM projection_thread_messages AS message
+        WHERE message.thread_id = ${threadId}
+          AND message.role IN ('user', 'assistant')
+        ORDER BY message.created_at DESC, message.message_id DESC
+        LIMIT 1
+      `;
+      const latestUser = yield* sql<LegacyMessageRow>`
+        SELECT
+          message.message_id,
+          message.thread_id,
+          message.role,
+          message.text,
+          message.attachments_json,
+          message.is_streaming,
+          message.created_at,
+          message.updated_at,
+          (
+            SELECT COUNT(*)
+            FROM projection_thread_messages AS earlier
+            WHERE earlier.thread_id = message.thread_id
+              AND earlier.role IN ('user', 'assistant')
+              AND (
+                earlier.created_at < message.created_at
+                OR (
+                  earlier.created_at = message.created_at
+                  AND earlier.message_id <= message.message_id
+                )
+              )
+          ) AS ordinal
+        FROM projection_thread_messages AS message
+        WHERE message.thread_id = ${threadId}
+          AND message.role = 'user'
+        ORDER BY message.created_at DESC, message.message_id DESC
+        LIMIT 1
+      `;
+      return [latestUser[0], latest[0]].filter(
+        (message, index, selected): message is LegacyMessageRow =>
+          message !== undefined &&
+          selected.findIndex((candidate) => candidate?.message_id === message.message_id) === index,
+      );
+    });
+
+  const reconcileShellsBase = Effect.gen(function* () {
+    const now = DateTime.formatIso(yield* DateTime.now);
+    const repairRows = yield* sql<LegacyRepairRow>`
+      SELECT
+        thread.thread_id,
+        thread.project_id,
+        thread.title,
+        thread.model_selection_json,
+        thread.runtime_mode,
+        thread.interaction_mode,
+        thread.branch,
+        thread.worktree_path,
+        thread.created_at,
+        thread.updated_at,
+        thread.archived_at,
+        thread.settled_override,
+        thread.settled_at,
+        thread.unsettled_at,
+        thread.snoozed_until,
+        thread.snoozed_at,
+        thread.pinned_at,
+        thread.pin_order_key,
+        thread.linked_pull_request_json,
+        thread.deleted_at,
+        projection.payload_json
+      FROM orchestration_v2_legacy_imports AS legacy_import
+      INNER JOIN projection_threads AS thread
+        ON thread.thread_id = legacy_import.thread_id
+      INNER JOIN orchestration_v2_projection_threads AS projection
+        ON projection.thread_id = legacy_import.thread_id
+      WHERE json_type(projection.payload_json, '$.pinnedAt') IS NULL
+         OR json_type(projection.payload_json, '$.pinOrderKey') IS NULL
+         OR json_type(projection.payload_json, '$.snoozedUntil') IS NULL
+         OR json_type(projection.payload_json, '$.snoozedAt') IS NULL
+         OR json_type(projection.payload_json, '$.unsettledAt') IS NULL
+         OR json_type(projection.payload_json, '$.linkedPullRequest') IS NULL
+      ORDER BY thread.created_at ASC, thread.thread_id ASC
+    `;
+    let repairedThreadCount = 0;
+    for (const row of repairRows) {
+      const decoded = decodeStoredThread(row.payload_json);
+      if (Option.isNone(decoded)) continue;
+      const current = decoded.value;
+      const legacy = importedThread(row);
+      const repaired: OrchestrationV2AppThread = {
+        ...current,
+        pinnedAt: current.pinnedAt === undefined ? legacy.pinnedAt : current.pinnedAt,
+        pinOrderKey: current.pinOrderKey === undefined ? legacy.pinOrderKey : current.pinOrderKey,
+        snoozedUntil:
+          current.snoozedUntil === undefined ? legacy.snoozedUntil : current.snoozedUntil,
+        snoozedAt: current.snoozedAt === undefined ? legacy.snoozedAt : current.snoozedAt,
+        unsettledAt: current.unsettledAt === undefined ? legacy.unsettledAt : current.unsettledAt,
+        linkedPullRequest:
+          current.linkedPullRequest === undefined
+            ? legacy.linkedPullRequest
+            : current.linkedPullRequest,
+      };
+      yield* eventSink.write({
+        events: [
+          {
+            id: EventId.make(`${IMPORT_EVENT_PREFIX}:thread:${row.thread_id}:metadata-repair`),
+            type: "thread.metadata-updated",
+            threadId: repaired.id,
+            providerInstanceId: repaired.providerInstanceId,
+            occurredAt: dateTime(now),
+            payload: repaired,
+          },
+        ],
+      });
+      repairedThreadCount += 1;
+    }
+    const rows = yield* sql<LegacyThreadRow>`
+      SELECT
+        thread.thread_id,
+        thread.project_id,
+        thread.title,
+        thread.model_selection_json,
+        thread.runtime_mode,
+        thread.interaction_mode,
+        thread.branch,
+        thread.worktree_path,
+        thread.created_at,
+        thread.updated_at,
+        thread.archived_at,
+        thread.settled_override,
+        thread.settled_at,
+        thread.unsettled_at,
+        thread.snoozed_until,
+        thread.snoozed_at,
+        thread.pinned_at,
+        thread.pin_order_key,
+        thread.linked_pull_request_json,
+        thread.deleted_at
+      FROM projection_threads AS thread
+      WHERE NOT EXISTS (
+        SELECT 1
+        FROM orchestration_events AS event
+        WHERE event.application_event_version = 2
+          AND event.aggregate_kind = 'thread'
+          AND event.stream_id = thread.thread_id
+          AND event.event_type = 'thread.created'
+      )
+      ORDER BY thread.created_at ASC, thread.thread_id ASC
+    `;
+    let importedThreadCount = repairedThreadCount;
+    let importedMessageCount = 0;
+    for (const row of rows) {
+      const thread = importedThread(row);
+      const previews = yield* listShellMessages(thread.id);
+      const events: Array<OrchestrationV2DomainEvent> = [
+        {
+          id: EventId.make(`${IMPORT_EVENT_PREFIX}:thread:${row.thread_id}:created`),
+          type: "thread.created",
+          threadId: thread.id,
+          providerInstanceId: thread.providerInstanceId,
+          occurredAt: thread.createdAt,
+          payload: thread,
+        },
+        ...previews.flatMap(messageEvents),
+        {
+          id: EventId.make(`${IMPORT_EVENT_PREFIX}:thread:${row.thread_id}:shell`),
+          type: "thread.metadata-updated",
+          threadId: thread.id,
+          providerInstanceId: thread.providerInstanceId,
+          occurredAt: thread.updatedAt,
+          payload: thread,
+        },
+      ];
+      yield* sql.withTransaction(
+        Effect.gen(function* () {
+          yield* eventStore.append({ events });
+          yield* Effect.forEach(
+            previews,
+            (message) =>
+              sql`
+                INSERT INTO orchestration_v2_turn_item_positions (
+                  thread_id,
+                  turn_item_id,
+                  ordinal
+                )
+                VALUES (
+                  ${thread.id},
+                  ${TurnItemId.make(`${IMPORT_EVENT_PREFIX}:turn-item:${message.message_id}`)},
+                  ${message.ordinal}
+                )
+                ON CONFLICT(thread_id, turn_item_id) DO NOTHING
+              `,
+            { discard: true },
+          );
+          yield* sql`
+            INSERT INTO orchestration_v2_legacy_imports (
+              thread_id,
+              source_updated_at,
+              shell_imported_at,
+              transcript_imported_at,
+              imported_message_count,
+              last_error
+            )
+            VALUES (
+              ${thread.id},
+              ${row.updated_at},
+              ${now},
+              NULL,
+              ${previews.length},
+              NULL
+            )
+            ON CONFLICT(thread_id) DO NOTHING
+          `;
+        }),
+      );
+      importedThreadCount += 1;
+      importedMessageCount += previews.length;
+    }
+    return { importedThreadCount, importedMessageCount };
+  });
+
+  const reconcileShells = reconcileShellsBase.pipe(
+    Effect.mapError((cause) => new LegacyV1ThreadImportError({ operation: "import", cause })),
+  );
+
+  const pendingThreadCount = sql<{ readonly count: number }>`
+    SELECT COUNT(*) AS count
+    FROM (
+      SELECT thread.thread_id
+      FROM projection_threads AS thread
+      WHERE NOT EXISTS (
+        SELECT 1
+        FROM orchestration_events AS event
+        WHERE event.application_event_version = 2
+          AND event.aggregate_kind = 'thread'
+          AND event.stream_id = thread.thread_id
+          AND event.event_type = 'thread.created'
+      )
+      UNION
+      SELECT legacy_import.thread_id
+      FROM orchestration_v2_legacy_imports AS legacy_import
+      WHERE legacy_import.transcript_imported_at IS NULL
+    )
+  `.pipe(
+    Effect.map((rows) => rows[0]?.count ?? 0),
+    Effect.mapError(
+      (cause) => new LegacyV1ThreadImportError({ operation: "inspect pending", cause }),
+    ),
+  );
+
+  // Threads whose transcript import this process has already confirmed.
+  // `transcript_imported_at` is never reset to NULL, so a positive answer
+  // stays valid for the process lifetime; ensureTranscript runs on most
+  // thread reads and command dispatches, so skipping the lock + lookup here
+  // keeps that path off the database entirely after first confirmation.
+  const confirmedTranscriptThreadIds = new Set<ThreadId>();
+
+  const ensureTranscriptBase = (threadId: ThreadId) =>
+    transcriptImports.withLock(
+      threadId,
+      Effect.gen(function* () {
+        const imports = yield* sql<LegacyImportRow>`
+          SELECT thread_id, transcript_imported_at
+          FROM orchestration_v2_legacy_imports
+          WHERE thread_id = ${threadId}
+          LIMIT 1
+        `;
+        const imported = imports[0];
+        if (imported === undefined || imported.transcript_imported_at !== null) {
+          if (imported !== undefined) {
+            confirmedTranscriptThreadIds.add(threadId);
+          }
+          return { importedThreadCount: 0, importedMessageCount: 0 };
+        }
+        const messages = yield* listMessages(threadId);
+        const existingRows = yield* sql<{ readonly event_id: string }>`
+          SELECT event_id
+          FROM orchestration_events
+          WHERE application_event_version = 2
+            AND aggregate_kind = 'thread'
+            AND stream_id = ${threadId}
+            AND event_id LIKE ${`${IMPORT_EVENT_PREFIX}:message:%`}
+        `;
+        const existing = new Set(existingRows.map((row) => row.event_id));
+        const missing = messages.filter(
+          (message) => !existing.has(`${IMPORT_EVENT_PREFIX}:message:${message.message_id}`),
+        );
+        for (const batch of chunks(missing, TRANSCRIPT_EVENT_BATCH_SIZE / 2)) {
+          yield* Effect.forEach(
+            batch,
+            (message) =>
+              sql`
+                INSERT INTO orchestration_v2_turn_item_positions (
+                  thread_id,
+                  turn_item_id,
+                  ordinal
+                )
+                VALUES (
+                  ${threadId},
+                  ${TurnItemId.make(`${IMPORT_EVENT_PREFIX}:turn-item:${message.message_id}`)},
+                  ${message.ordinal}
+                )
+                ON CONFLICT(thread_id, turn_item_id) DO NOTHING
+              `,
+            { discard: true },
+          );
+          yield* eventSink.write({ events: batch.flatMap(messageEvents) });
+          yield* Effect.yieldNow;
+        }
+        const now = DateTime.formatIso(yield* DateTime.now);
+        yield* sql`
+          UPDATE orchestration_v2_legacy_imports
+          SET
+            transcript_imported_at = ${now},
+            imported_message_count = ${messages.length},
+            last_error = NULL
+          WHERE thread_id = ${threadId}
+        `;
+        confirmedTranscriptThreadIds.add(threadId);
+        return {
+          importedThreadCount: 1,
+          importedMessageCount: missing.length,
+        };
+      }),
+    );
+
+  const ensureTranscript = (threadId: ThreadId) =>
+    confirmedTranscriptThreadIds.has(threadId)
+      ? Effect.succeed({ importedThreadCount: 0, importedMessageCount: 0 })
+      : ensureTranscriptBase(threadId).pipe(
+          Effect.mapError(
+            (cause) =>
+              new LegacyV1ThreadImportError({
+                operation: "hydrate transcript for",
+                threadId,
+                cause,
+              }),
+          ),
+        );
+
+  const importPendingTranscripts = Effect.gen(function* () {
+    const rows = yield* sql<LegacyImportRow>`
+      SELECT thread_id, transcript_imported_at
+      FROM orchestration_v2_legacy_imports
+      WHERE transcript_imported_at IS NULL
+      ORDER BY shell_imported_at ASC, thread_id ASC
+    `;
+    let importedThreadCount = 0;
+    let importedMessageCount = 0;
+    for (const row of rows) {
+      const result = yield* ensureTranscript(ThreadId.make(row.thread_id)).pipe(
+        Effect.tapError((error) =>
+          Effect.logWarning("Failed to hydrate migrated v1 thread transcript", {
+            threadId: row.thread_id,
+            cause: error,
+          }),
+        ),
+        Effect.catch(() =>
+          sql`
+            UPDATE orchestration_v2_legacy_imports
+            SET last_error = 'Transcript hydration failed; retry on next open.'
+            WHERE thread_id = ${row.thread_id}
+          `.pipe(
+            Effect.as({ importedThreadCount: 0, importedMessageCount: 0 }),
+            Effect.orElseSucceed(() => ({
+              importedThreadCount: 0,
+              importedMessageCount: 0,
+            })),
+          ),
+        ),
+      );
+      importedThreadCount += result.importedThreadCount;
+      importedMessageCount += result.importedMessageCount;
+      yield* Effect.yieldNow;
+    }
+    return { importedThreadCount, importedMessageCount };
+  }).pipe(
+    Effect.catchCause((cause) =>
+      Effect.logWarning("Legacy v1 transcript background import stopped", { cause }).pipe(
+        Effect.as({ importedThreadCount: 0, importedMessageCount: 0 }),
+      ),
+    ),
+  );
+
+  return LegacyV1ThreadImporter.of({
+    pendingThreadCount,
+    reconcileShells,
+    ensureTranscript,
+    importPendingTranscripts,
+  });
+});
+
+export const layer: Layer.Layer<
+  LegacyV1ThreadImporter,
+  never,
+  EventSinkV2 | EventStoreV2 | SqlClient.SqlClient
+> = Layer.effect(LegacyV1ThreadImporter, make);
diff --git a/apps/server/src/orchestration-v2/Orchestrator.migration.test.ts b/apps/server/src/orchestration-v2/Orchestrator.migration.test.ts
new file mode 100644
index 000000000000..3fa5acfdc5cb
--- /dev/null
+++ b/apps/server/src/orchestration-v2/Orchestrator.migration.test.ts
@@ -0,0 +1,100 @@
+import { assert, it } from "@effect/vitest";
+import * as Schema from "effect/Schema";
+import { ContextHandoffId, OrchestrationV2Command, ThreadId } from "@t3tools/contracts";
+
+import {
+  appendContextHandoffId,
+  canReplayCommandReceipt,
+  shouldPrepareLegacyImportHandoff,
+} from "./Orchestrator.ts";
+
+it("reissues imported context until a V2 run completes", () => {
+  assert.isTrue(
+    shouldPrepareLegacyImportHandoff({
+      historyOrigin: "v1_import",
+      hasCompletedRun: false,
+      legacyImportItemCount: 2,
+    }),
+  );
+  assert.isFalse(
+    shouldPrepareLegacyImportHandoff({
+      historyOrigin: "v1_import",
+      hasCompletedRun: true,
+      legacyImportItemCount: 2,
+    }),
+  );
+  assert.isFalse(
+    shouldPrepareLegacyImportHandoff({
+      historyOrigin: undefined,
+      hasCompletedRun: false,
+      legacyImportItemCount: 2,
+    }),
+  );
+  assert.isFalse(
+    shouldPrepareLegacyImportHandoff({
+      historyOrigin: "v1_import",
+      hasCompletedRun: false,
+      legacyImportItemCount: 0,
+    }),
+  );
+});
+
+it("records a reissued legacy handoff on an existing provider thread", () => {
+  const existingHandoffId = ContextHandoffId.make("handoff:legacy-import:existing");
+  const retryHandoffId = ContextHandoffId.make("handoff:legacy-import:retry");
+
+  assert.deepEqual(appendContextHandoffId([existingHandoffId], retryHandoffId), [
+    existingHandoffId,
+    retryHandoffId,
+  ]);
+  assert.deepEqual(appendContextHandoffId([existingHandoffId], existingHandoffId), [
+    existingHandoffId,
+  ]);
+  assert.deepEqual(appendContextHandoffId([existingHandoffId], null), [existingHandoffId]);
+});
+
+it("only replays a command receipt for the thread it was recorded against", () => {
+  const threadA = ThreadId.make("thread-a");
+  const threadB = ThreadId.make("thread-b");
+
+  assert.strictEqual(canReplayCommandReceipt(threadA, threadA), true);
+  // A reused command id aimed at another thread must not report the first
+  // thread's success as this thread's (v1 #5246).
+  assert.strictEqual(canReplayCommandReceipt(threadA, threadB), false);
+});
+
+it("links and unlinks a pull request through thread.metadata.update (#8160)", () => {
+  // The fold is exercised through the schema: a command carrying the link
+  // must round-trip, and one without it must leave the field untouched.
+  const decode = Schema.decodeUnknownSync(OrchestrationV2Command);
+  const linked = decode({
+    type: "thread.metadata.update",
+    commandId: "command-link",
+    threadId: "thread-1",
+    linkedPullRequest: {
+      projectId: "project-1",
+      repository: "pingdotgg/t3code",
+      number: 8160,
+      url: "https://github.com/pingdotgg/t3code/pull/8160",
+    },
+  });
+  assert.deepStrictEqual(
+    (linked as Extract<typeof linked, { type: "thread.metadata.update" }>).linkedPullRequest,
+    {
+      projectId: "project-1",
+      repository: "pingdotgg/t3code",
+      number: 8160,
+      url: "https://github.com/pingdotgg/t3code/pull/8160",
+    },
+  );
+  const unlinked = decode({
+    type: "thread.metadata.update",
+    commandId: "command-unlink",
+    threadId: "thread-1",
+    linkedPullRequest: null,
+  });
+  assert.strictEqual(
+    (unlinked as Extract<typeof unlinked, { type: "thread.metadata.update" }>).linkedPullRequest,
+    null,
+  );
+});
diff --git a/apps/server/src/orchestration-v2/Orchestrator.ts b/apps/server/src/orchestration-v2/Orchestrator.ts
new file mode 100644
index 000000000000..66378584fd21
--- /dev/null
+++ b/apps/server/src/orchestration-v2/Orchestrator.ts
@@ -0,0 +1,7324 @@
+import {
+  type ChatAttachment,
+  CommandId,
+  type MessageId,
+  type ModelSelection,
+  OrchestrationV2Command,
+  type OrchestrationV2AppThread,
+  type OrchestrationV2ContextHandoff,
+  type OrchestrationV2ContextSourcePoint,
+  type OrchestrationV2ContextTransfer,
+  type OrchestrationV2ContextTransferResolution,
+  type OrchestrationV2ConversationMessage,
+  type OrchestrationV2DelegatedCompletionCohort,
+  type OrchestrationV2DelegatedCompletionDelivery,
+  type OrchestrationV2DomainEvent,
+  type OrchestrationV2ExecutionNode,
+  type OrchestrationV2ProviderThread,
+  type OrchestrationV2ProviderTurn,
+  type OrchestrationV2Run,
+  type OrchestrationV2RunAttempt,
+  type OrchestrationV2ThreadShell,
+  type OrchestrationV2ThreadShellSnapshot,
+  type OrchestrationV2StoredEvent,
+  type OrchestrationV2Subagent,
+  type OrchestrationV2ThreadProjection,
+  type OrchestrationV2TurnItem,
+  ProviderInstanceId,
+  type ProviderSessionId,
+  RunId,
+  ThreadId,
+} from "@t3tools/contracts";
+import { modelSelectionsEqual } from "@t3tools/shared/model";
+import * as Context from "effect/Context";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Ref from "effect/Ref";
+import * as Schema from "effect/Schema";
+import * as Stream from "effect/Stream";
+
+import { CheckpointServiceV2 } from "./CheckpointService.ts";
+import { CommandPolicyV2 } from "./CommandPolicy.ts";
+import { CommandReceiptStoreV2 } from "./CommandReceiptStore.ts";
+import { ContextHandoffServiceV2 } from "./ContextHandoffService.ts";
+import { EventSinkV2 } from "./EventSink.ts";
+import type { OrchestrationEffectRequestV2, PendingOrchestrationEffectV2 } from "./EffectOutbox.ts";
+import { IdAllocatorV2 } from "./IdAllocator.ts";
+import { makeKeyedSerialExecutor } from "./KeyedSerialExecutor.ts";
+import {
+  applyToProjection,
+  emptyProjection,
+  isTurnItemAtOrBeforeRun,
+  ProjectionStoreV2,
+} from "./ProjectionStore.ts";
+import type { ProviderAdapterV2Shape } from "./ProviderAdapter.ts";
+import { ProviderAdapterRegistryV2 } from "./ProviderAdapterRegistry.ts";
+import { ProviderContinuationRequests } from "./ProviderContinuationRequests.ts";
+import { ProviderSessionManagerV2 } from "./ProviderSessionManager.ts";
+import { ProviderSwitchServiceV2 } from "./ProviderSwitchService.ts";
+import { isAutomaticCompletionRun, queuedRunsInDeliveryOrder } from "./QueuedRunOrder.ts";
+import { RuntimePolicyV2 } from "./RuntimePolicy.ts";
+import {
+  makeSubagentChildThread,
+  subagentResultForRun,
+  subagentThreadTitle,
+} from "./SubagentProjection.ts";
+import { ThreadForkServiceV2 } from "./ThreadForkService.ts";
+
+export class OrchestratorDispatchError extends Schema.TaggedErrorClass<OrchestratorDispatchError>()(
+  "OrchestratorDispatchError",
+  {
+    commandId: CommandId,
+    commandType: Schema.String,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to dispatch orchestration command ${this.commandType} (${this.commandId}).`;
+  }
+}
+
+export class OrchestratorProjectionError extends Schema.TaggedErrorClass<OrchestratorProjectionError>()(
+  "OrchestratorProjectionError",
+  {
+    threadId: ThreadId,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to load orchestration projection for thread ${this.threadId}.`;
+  }
+}
+
+export class OrchestratorDomainEventStreamError extends Schema.TaggedErrorClass<OrchestratorDomainEventStreamError>()(
+  "OrchestratorDomainEventStreamError",
+  {
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return "Failed while streaming orchestration domain events.";
+  }
+}
+
+export class OrchestratorProviderAdapterError extends Schema.TaggedErrorClass<OrchestratorProviderAdapterError>()(
+  "OrchestratorProviderAdapterError",
+  {
+    commandId: CommandId,
+    providerInstanceId: ProviderInstanceId,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Provider adapter failed while dispatching orchestration command ${this.commandId}.`;
+  }
+}
+
+export class OrchestratorCommandPreviouslyRejectedError extends Schema.TaggedErrorClass<OrchestratorCommandPreviouslyRejectedError>()(
+  "OrchestratorCommandPreviouslyRejectedError",
+  {
+    commandId: CommandId,
+    commandType: Schema.String,
+    detail: Schema.String,
+  },
+) {
+  override get message(): string {
+    return `Command ${this.commandId} was previously rejected: ${this.detail}`;
+  }
+}
+
+export class OrchestratorCommandIdConflictError extends Schema.TaggedErrorClass<OrchestratorCommandIdConflictError>()(
+  "OrchestratorCommandIdConflictError",
+  {
+    commandId: CommandId,
+    commandType: Schema.String,
+    receiptThreadId: ThreadId,
+    commandThreadId: ThreadId,
+  },
+) {
+  override get message(): string {
+    return `Command ${this.commandId} was already handled for thread ${this.receiptThreadId} and cannot be replayed for ${this.commandThreadId}.`;
+  }
+}
+
+/**
+ * A command receipt only proves that this exact command already ran for the
+ * thread it was recorded against. Replaying it for a command aimed at another
+ * thread would report success for work that never happened there, so the
+ * dispatcher rejects the reuse instead (mirrors v1's command-id conflict).
+ */
+export function canReplayCommandReceipt(
+  receiptThreadId: ThreadId,
+  commandThreadId: ThreadId,
+): boolean {
+  return receiptThreadId === commandThreadId;
+}
+
+export const OrchestratorV2Error = Schema.Union([
+  OrchestratorDispatchError,
+  OrchestratorProjectionError,
+  OrchestratorDomainEventStreamError,
+  OrchestratorProviderAdapterError,
+  OrchestratorCommandPreviouslyRejectedError,
+  OrchestratorCommandIdConflictError,
+]);
+export type OrchestratorV2Error = typeof OrchestratorV2Error.Type;
+
+export interface OrchestratorV2DispatchResult {
+  readonly sequence: number;
+  readonly storedEvents: ReadonlyArray<OrchestrationV2StoredEvent>;
+}
+
+export interface OrchestratorV2Shape {
+  readonly resumeQueuedRuns: Effect.Effect<number, OrchestratorV2Error>;
+  readonly dispatch: (
+    command: OrchestrationV2Command,
+  ) => Effect.Effect<OrchestratorV2DispatchResult, OrchestratorV2Error>;
+  readonly getThreadProjection: (
+    threadId: ThreadId,
+  ) => Effect.Effect<OrchestrationV2ThreadProjection, OrchestratorV2Error>;
+  readonly getThreadSnapshot: (threadId: ThreadId) => Effect.Effect<
+    {
+      readonly schemaVersion: number;
+      readonly snapshotSequence: number;
+      readonly projection: OrchestrationV2ThreadProjection;
+    },
+    OrchestratorV2Error
+  >;
+  readonly getThreadSnapshotWindow: (
+    threadId: ThreadId,
+    options: Parameters<ProjectionStoreV2["Service"]["getThreadSnapshotWindow"]>[1],
+  ) => Effect.Effect<
+    {
+      readonly schemaVersion: number;
+      readonly snapshotSequence: number;
+      readonly projection: OrchestrationV2ThreadProjection;
+    },
+    OrchestratorV2Error
+  >;
+  readonly getShellSnapshot: (options?: {
+    readonly location?: "active" | "archive";
+  }) => Effect.Effect<OrchestrationV2ThreadShellSnapshot, OrchestratorV2Error>;
+  readonly getThreadShell: (
+    threadId: ThreadId,
+  ) => Effect.Effect<OrchestrationV2ThreadShell | null, OrchestratorV2Error>;
+  readonly getThreadEventSequence: (
+    threadId: ThreadId,
+  ) => Effect.Effect<number, OrchestratorV2Error>;
+  readonly streamStoredEvents: Stream.Stream<OrchestrationV2StoredEvent, OrchestratorV2Error>;
+  readonly streamStoredEventsFrom: (input?: {
+    readonly threadId?: ThreadId;
+    readonly afterSequence?: number;
+  }) => Stream.Stream<OrchestrationV2StoredEvent, OrchestratorV2Error>;
+  readonly streamDomainEvents: Stream.Stream<OrchestrationV2DomainEvent, OrchestratorV2Error>;
+}
+
+export class OrchestratorV2 extends Context.Service<OrchestratorV2, OrchestratorV2Shape>()(
+  "t3/orchestration-v2/Orchestrator/OrchestratorV2",
+) {}
+
+function nextRunOrdinal(projection: OrchestrationV2ThreadProjection): number {
+  return projection.runs.length + 1;
+}
+
+function commandThreadId(command: OrchestrationV2Command): ThreadId {
+  switch (command.type) {
+    case "thread.create":
+    case "thread.archive":
+    case "thread.unarchive":
+    case "thread.delete":
+    case "thread.settle":
+    case "thread.unsettle":
+    case "thread.snooze":
+    case "thread.unsnooze":
+    case "thread.pin":
+    case "thread.unpin":
+    case "thread.pin.reorder":
+    case "thread.visit":
+    case "thread.mark-unread":
+    case "thread.metadata.update":
+    case "thread.title.regeneration.complete":
+    case "thread.runtime-mode.set":
+    case "thread.interaction-mode.set":
+    case "thread.model-selection.set":
+    case "provider-session.detach":
+    case "message.dispatch":
+    case "prepared-run.release":
+    case "prepared-run.progress":
+    case "prepared-run.fail":
+    case "run.interrupt":
+    case "queued-message.promote-to-steer":
+    case "queued-run.reorder":
+    case "queued-run.cancel":
+    case "queued-run.edit":
+    case "runtime-request.respond":
+    case "checkpoint.rollback":
+    case "provider.switch":
+      return command.threadId;
+    case "delegated_task.request":
+    case "delegated_task.wake-policy":
+    case "delegated_task.completion-delivery.acknowledge":
+    case "delegated_task.completion-delivery.dispose":
+    case "thread.created.record":
+      return command.parentThreadId;
+    case "thread.fork":
+    case "thread.merge_back":
+      return command.targetThreadId;
+  }
+}
+
+function pendingThreadTitleGenerationEffect(
+  commandId: CommandId,
+  threadId: ThreadId,
+  kind:
+    | { readonly type: "initial"; readonly messageId: MessageId }
+    | { readonly type: "regenerate" },
+): PendingOrchestrationEffectV2 {
+  return {
+    id: `effect:${commandId}:thread-title.generate`,
+    commandId,
+    threadId,
+    request: { type: "thread-title.generate", kind },
+  };
+}
+
+function nextTurnItemOrdinal(projection: OrchestrationV2ThreadProjection): number {
+  return Math.max(0, ...projection.turnItems.map((item) => item.ordinal)) + 1;
+}
+
+const WORKSPACE_PREPARATION_INPUT = "Preparing workspace";
+
+function isBlockingRun(run: OrchestrationV2Run): boolean {
+  return (
+    run.status === "preparing" ||
+    run.status === "starting" ||
+    run.status === "running" ||
+    run.status === "waiting"
+  );
+}
+
+/**
+ * A parent thread is "live" for wake purposes while a run is still producing
+ * agent output. A run parked at "waiting" is post-terminal drain, so its agent
+ * turn is over and a wake is still needed.
+ */
+function hasLiveRun(projection: OrchestrationV2ThreadProjection): boolean {
+  return projection.runs.some(
+    (run) => run.status === "preparing" || run.status === "starting" || run.status === "running",
+  );
+}
+
+function delegatedCompletionWakeDetail(taskIds: ReadonlyArray<string>): string {
+  const taskList = taskIds.join(", ");
+  return taskIds.length === 1
+    ? `Delegated task ${taskList} reached a terminal state. Use task_status with taskId ${taskList} to read the result.`
+    : `Delegated tasks ${taskList} reached terminal states. Use task_status with each taskId to read the results.`;
+}
+
+function isTerminalDelegatedTaskStatus(status: OrchestrationV2Subagent["status"]): boolean {
+  return (
+    status === "completed" ||
+    status === "failed" ||
+    status === "cancelled" ||
+    status === "interrupted"
+  );
+}
+
+function delegatedTaskTerminalStatus(
+  status: OrchestrationV2Run["status"],
+): OrchestrationV2Subagent["status"] | null {
+  switch (status) {
+    case "completed":
+    case "failed":
+    case "cancelled":
+    case "interrupted":
+      return status;
+    case "rolled_back":
+      return "cancelled";
+    case "preparing":
+    case "queued":
+    case "starting":
+    case "running":
+    case "waiting":
+      return null;
+  }
+}
+
+function nextQueuedRun(
+  projection: OrchestrationV2ThreadProjection,
+): OrchestrationV2Run | undefined {
+  return queuedRunsInDeliveryOrder(projection)[0];
+}
+
+function latestStableRun(projection: OrchestrationV2ThreadProjection): OrchestrationV2Run | null {
+  return (
+    projection.runs
+      .filter((run) => run.status === "completed" && run.checkpointId !== null)
+      .toSorted((left, right) => right.ordinal - left.ordinal)[0] ?? null
+  );
+}
+
+function runForSourcePoint(
+  projection: OrchestrationV2ThreadProjection,
+  sourcePoint: Extract<
+    OrchestrationV2Command,
+    { readonly type: "thread.fork" | "thread.merge_back" }
+  >["sourcePoint"],
+): OrchestrationV2Run | null {
+  switch (sourcePoint.type) {
+    case "latest_stable":
+      return latestStableRun(projection);
+    case "run":
+      return projection.runs.find((run) => run.id === sourcePoint.runId) ?? null;
+    case "checkpoint": {
+      const checkpoint = projection.checkpoints.find(
+        (candidate) => candidate.id === sourcePoint.checkpointId,
+      );
+      return checkpoint?.runId === null || checkpoint === undefined
+        ? null
+        : (projection.runs.find((run) => run.id === checkpoint.runId) ?? null);
+    }
+  }
+}
+
+function providerThreadForRun(
+  projection: OrchestrationV2ThreadProjection,
+  run: OrchestrationV2Run,
+): OrchestrationV2ProviderThread | undefined {
+  return run.providerThreadId === null
+    ? undefined
+    : projection.providerThreads.find((candidate) => candidate.id === run.providerThreadId);
+}
+
+function providerTurnForRun(
+  projection: OrchestrationV2ThreadProjection,
+  run: OrchestrationV2Run,
+): OrchestrationV2ProviderTurn | undefined {
+  if (run.activeAttemptId === null) {
+    return undefined;
+  }
+
+  return (
+    projection.providerTurns.find((turn) => turn.runAttemptId === run.activeAttemptId) ??
+    projection.providerTurns.find((turn) => {
+      const attempt = projection.attempts.find((candidate) => candidate.id === run.activeAttemptId);
+      return attempt?.providerTurnId === turn.id;
+    })
+  );
+}
+
+function contextSourcePointForRun(
+  projection: OrchestrationV2ThreadProjection,
+  run: OrchestrationV2Run,
+): OrchestrationV2ContextSourcePoint {
+  const providerThread = providerThreadForRun(projection, run);
+  const providerTurn = providerTurnForRun(projection, run);
+  return {
+    threadId: projection.thread.id,
+    runId: run.id,
+    ...(run.checkpointId === null ? {} : { checkpointId: run.checkpointId }),
+    ...(providerThread?.nativeThreadRef === null || providerThread?.nativeThreadRef === undefined
+      ? {}
+      : { providerThreadRef: providerThread.nativeThreadRef }),
+    ...(providerTurn?.nativeTurnRef === null || providerTurn?.nativeTurnRef === undefined
+      ? {}
+      : { providerTurnRef: providerTurn.nativeTurnRef }),
+  };
+}
+
+function pendingForkTransferForThread(
+  projection: OrchestrationV2ThreadProjection,
+): OrchestrationV2ContextTransfer | undefined {
+  return projection.contextTransfers.find(
+    (transfer) =>
+      transfer.type === "fork" &&
+      transfer.targetThreadId === projection.thread.id &&
+      transfer.status === "pending",
+  );
+}
+
+function pendingMergeBackTransfersForThread(
+  projection: OrchestrationV2ThreadProjection,
+): ReadonlyArray<OrchestrationV2ContextTransfer> {
+  return projection.contextTransfers.filter(
+    (transfer) =>
+      transfer.type === "merge_back" &&
+      transfer.targetThreadId === projection.thread.id &&
+      transfer.status === "pending",
+  );
+}
+
+function latestContextTransfer(
+  transfers: ReadonlyArray<OrchestrationV2ContextTransfer>,
+): OrchestrationV2ContextTransfer | undefined {
+  return transfers.reduce<OrchestrationV2ContextTransfer | undefined>((latest, transfer) => {
+    if (latest === undefined) {
+      return transfer;
+    }
+    return DateTime.toEpochMillis(transfer.updatedAt) >= DateTime.toEpochMillis(latest.updatedAt)
+      ? transfer
+      : latest;
+  }, undefined);
+}
+
+function visibleDeltaRunOrdinals(
+  projection: OrchestrationV2ThreadProjection,
+  items: ReadonlyArray<OrchestrationV2TurnItem>,
+): OrchestrationV2ContextHandoff["coveredRunOrdinals"] {
+  const ordinals = items.flatMap((item) => {
+    if (item.runId === null) {
+      return [];
+    }
+    const run = projection.runs.find((candidate) => candidate.id === item.runId);
+    return run === undefined ? [] : [run.ordinal];
+  });
+  if (ordinals.length === 0) {
+    return { from: 1, to: 1 };
+  }
+  return {
+    from: Math.min(...ordinals),
+    to: Math.max(...ordinals),
+  };
+}
+
+export function shouldPrepareLegacyImportHandoff(input: {
+  readonly hasCompletedRun: boolean;
+  readonly historyOrigin: OrchestrationV2AppThread["historyOrigin"];
+  readonly legacyImportItemCount: number;
+}): boolean {
+  return (
+    input.historyOrigin === "v1_import" && !input.hasCompletedRun && input.legacyImportItemCount > 0
+  );
+}
+
+export function appendContextHandoffId(
+  handoffIds: OrchestrationV2ProviderThread["handoffIds"],
+  handoffId: OrchestrationV2ContextHandoff["id"] | null,
+): OrchestrationV2ProviderThread["handoffIds"] {
+  return handoffId === null ? handoffIds : Array.from(new Set([...handoffIds, handoffId]));
+}
+
+function rootProviderThreadsForProvider(
+  projection: OrchestrationV2ThreadProjection,
+  providerInstanceId: ModelSelection["instanceId"],
+): ReadonlyArray<OrchestrationV2ProviderThread> {
+  return projection.providerThreads
+    .filter(
+      (providerThread) =>
+        providerThread.providerInstanceId === providerInstanceId &&
+        providerThread.appThreadId === projection.thread.id &&
+        providerThread.ownerNodeId === null,
+    )
+    .toSorted(
+      (left, right) =>
+        (right.lastRunOrdinal ?? 0) - (left.lastRunOrdinal ?? 0) ||
+        DateTime.toEpochMillis(right.updatedAt) - DateTime.toEpochMillis(left.updatedAt),
+    );
+}
+
+const makeOrchestrator = Effect.fn("orchestrationV2.Orchestrator.layer")(function* () {
+  const checkpointService = yield* CheckpointServiceV2;
+  const commandPolicy = yield* CommandPolicyV2;
+  const contextHandoffService = yield* ContextHandoffServiceV2;
+  const eventSink = yield* EventSinkV2;
+  const commandReceipts = yield* CommandReceiptStoreV2;
+  const idAllocator = yield* IdAllocatorV2;
+  const projectionStore = yield* ProjectionStoreV2;
+  const providerAdapters = yield* ProviderAdapterRegistryV2;
+  const continuationRequests = yield* ProviderContinuationRequests;
+  const providerSessions = yield* ProviderSessionManagerV2;
+  const providerSwitchService = yield* ProviderSwitchServiceV2;
+  const runtimePolicy = yield* RuntimePolicyV2;
+  const threadForkService = yield* ThreadForkServiceV2;
+  const threadDispatch = yield* makeKeyedSerialExecutor<ThreadId>();
+
+  const mapDispatchError =
+    (command: OrchestrationV2Command) =>
+    <A, E, R>(effect: Effect.Effect<A, E, R>): Effect.Effect<A, OrchestratorDispatchError, R> =>
+      effect.pipe(
+        Effect.mapError(
+          (cause) =>
+            new OrchestratorDispatchError({
+              commandId: command.commandId,
+              commandType: command.type,
+              cause,
+            }),
+        ),
+      );
+
+  const mapDelegatedCompletionError = <A, E, R>(effect: Effect.Effect<A, E, R>) =>
+    effect.pipe(
+      Effect.mapError(
+        (cause) =>
+          new OrchestratorDispatchError({
+            commandId: CommandId.make("command:system:delegated-completion-delivery"),
+            commandType: "delegated_task.completion-delivery",
+            cause,
+          }),
+      ),
+    );
+
+  const providerSessionIdFor = (input: {
+    readonly adapter: ProviderAdapterV2Shape;
+    readonly providerInstanceId: ProviderInstanceId;
+    readonly threadId: ThreadId;
+  }) =>
+    input.adapter.getCapabilities().pipe(
+      Effect.flatMap((capabilities) =>
+        capabilities.sessions.supportsMultipleProviderThreadsPerSession
+          ? Effect.succeed(
+              idAllocator.derive.providerSession({
+                providerInstanceId: input.providerInstanceId,
+              }),
+            )
+          : idAllocator.allocate.providerSession({
+              providerInstanceId: input.providerInstanceId,
+              threadId: input.threadId,
+            }),
+      ),
+    );
+
+  const enforceCommandPolicy =
+    (command: OrchestrationV2Command) =>
+    <A, E, R>(effect: Effect.Effect<A, E, R>): Effect.Effect<A, OrchestratorDispatchError, R> =>
+      effect.pipe(
+        Effect.mapError(
+          (cause) =>
+            new OrchestratorDispatchError({
+              commandId: command.commandId,
+              commandType: command.type,
+              cause,
+            }),
+        ),
+      );
+
+  const makeEvent = <Event extends OrchestrationV2DomainEvent>(
+    command: OrchestrationV2Command,
+    event: Omit<Event, "id">,
+  ) =>
+    Effect.gen(function* () {
+      const eventId = yield* mapDispatchError(command)(
+        idAllocator.allocate.event({
+          threadId: event.threadId,
+          commandId: command.commandId,
+        }),
+      );
+      return {
+        ...event,
+        id: eventId,
+      } as Event;
+    });
+
+  const emit =
+    (events: Ref.Ref<Array<OrchestrationV2DomainEvent>>, command: OrchestrationV2Command) =>
+    <Event extends OrchestrationV2DomainEvent>(event: Omit<Event, "id">) =>
+      Effect.gen(function* () {
+        const withId = yield* makeEvent(command, event);
+        yield* Ref.update(events, (existing) => [...existing, withId]);
+        return withId;
+      });
+
+  const getProjectionWithPendingEvents = (
+    threadId: ThreadId,
+    events: Ref.Ref<Array<OrchestrationV2DomainEvent>>,
+  ) =>
+    Effect.gen(function* () {
+      const pending = (yield* Ref.get(events)).filter((event) => event.threadId === threadId);
+      const stored = yield* Effect.option(projectionStore.getThreadProjection(threadId));
+      let projection: OrchestrationV2ThreadProjection;
+      if (Option.isSome(stored)) {
+        projection = stored.value;
+      } else {
+        const created = pending.find(
+          (
+            event,
+          ): event is Extract<OrchestrationV2DomainEvent, { readonly type: "thread.created" }> =>
+            event.type === "thread.created",
+        );
+        if (created === undefined) {
+          return yield* new OrchestratorProjectionError({ threadId });
+        }
+        projection = emptyProjection(created);
+      }
+
+      for (const event of pending) {
+        if (event.type === "thread.created" && projection.thread.id === event.payload.id) {
+          projection = { ...projection, thread: event.payload, updatedAt: event.occurredAt };
+          continue;
+        }
+        projection = applyToProjection(projection, event);
+      }
+      return projection;
+    });
+
+  const makeSystemEvent = <Event extends OrchestrationV2DomainEvent>(event: Omit<Event, "id">) =>
+    Effect.gen(function* () {
+      const eventId = yield* idAllocator.allocate.event({
+        threadId: event.threadId,
+      });
+      return {
+        ...event,
+        id: eventId,
+      } as Event;
+    });
+
+  const writeSystemEvents = (
+    events: ReadonlyArray<Omit<OrchestrationV2DomainEvent, "id">>,
+    effects: ReadonlyArray<PendingOrchestrationEffectV2> = [],
+  ) =>
+    Effect.gen(function* () {
+      const withIds = yield* Effect.forEach(events, (event) =>
+        makeSystemEvent(event as Omit<OrchestrationV2DomainEvent, "id">),
+      );
+      yield* eventSink.writeWithEffects({ events: withIds, effects });
+    });
+
+  const completionDeliveryRun = (
+    projection: OrchestrationV2ThreadProjection,
+    delivery: OrchestrationV2DelegatedCompletionDelivery | null | undefined,
+  ) =>
+    delivery === null || delivery === undefined
+      ? undefined
+      : projection.runs.find((candidate) => candidate.userMessageId === delivery.messageId);
+
+  const completionDeliveryMessage = (
+    projection: OrchestrationV2ThreadProjection,
+    delivery: OrchestrationV2DelegatedCompletionDelivery | null | undefined,
+  ) =>
+    delivery === null || delivery === undefined
+      ? undefined
+      : projection.messages.find((candidate) => candidate.id === delivery.messageId);
+
+  const offerDelegatedCompletionDelivery = (threadId: ThreadId, parentRunId: RunId) =>
+    Effect.gen(function* () {
+      const projection = yield* projectionStore.getThreadProjection(threadId);
+      const parentRun = projection.runs.find((candidate) => candidate.id === parentRunId);
+      const cohort = parentRun?.delegatedCompletion;
+      const delivery = cohort?.delivery;
+      if (
+        parentRun === undefined ||
+        cohort?.disposition !== "open" ||
+        delivery === null ||
+        delivery === undefined ||
+        delivery.taskIds.length === 0 ||
+        projection.thread.archivedAt !== null ||
+        projection.thread.deletedAt !== null ||
+        completionDeliveryMessage(projection, delivery) !== undefined
+      ) {
+        return;
+      }
+      const providerThread =
+        parentRun.providerThreadId === null
+          ? undefined
+          : projection.providerThreads.find(
+              (candidate) => candidate.id === parentRun.providerThreadId,
+            );
+      if (providerThread === undefined) {
+        return;
+      }
+      yield* continuationRequests.offer({
+        threadId,
+        providerThreadId: providerThread.id,
+        driver: providerThread.driver,
+        detail: null,
+        delivery: "message_text",
+        delegatedCompletion: {
+          parentRunId,
+          generation: delivery.generation,
+          messageId: delivery.messageId,
+        },
+      });
+    });
+
+  const offerDelegatedCompletionDeliveries = (threadId: ThreadId) =>
+    Effect.gen(function* () {
+      const projection = yield* projectionStore.getThreadProjection(threadId);
+      for (const run of projection.runs) {
+        if (
+          run.delegatedCompletion?.delivery !== undefined &&
+          run.delegatedCompletion.delivery !== null
+        ) {
+          yield* offerDelegatedCompletionDelivery(threadId, run.id);
+        }
+      }
+    });
+
+  const emitQueuedRunCancellation = (input: {
+    readonly command: OrchestrationV2Command;
+    readonly events: Ref.Ref<Array<OrchestrationV2DomainEvent>>;
+    readonly projection: OrchestrationV2ThreadProjection;
+    readonly run: OrchestrationV2Run;
+    readonly now: DateTime.Utc;
+  }) =>
+    Effect.gen(function* () {
+      const rootNode =
+        input.run.rootNodeId === null
+          ? undefined
+          : input.projection.nodes.find((candidate) => candidate.id === input.run.rootNodeId);
+      const attempt =
+        input.run.activeAttemptId === null
+          ? undefined
+          : input.projection.attempts.find(
+              (candidate) => candidate.id === input.run.activeAttemptId,
+            );
+      const emitEvent = emit(input.events, input.command);
+      yield* emitEvent({
+        type: "run.updated",
+        threadId: input.run.threadId,
+        runId: input.run.id,
+        ...(input.run.rootNodeId === null ? {} : { nodeId: input.run.rootNodeId }),
+        providerInstanceId: input.run.providerInstanceId,
+        occurredAt: input.now,
+        payload: {
+          ...input.run,
+          status: "cancelled",
+          queuePosition: null,
+          completedAt: input.now,
+        },
+      });
+      if (attempt !== undefined && rootNode !== undefined) {
+        yield* emitEvent({
+          type: "run-attempt.updated",
+          threadId: input.run.threadId,
+          runId: input.run.id,
+          nodeId: rootNode.id,
+          providerInstanceId: input.run.providerInstanceId,
+          occurredAt: input.now,
+          payload: {
+            ...attempt,
+            status: "cancelled",
+            completedAt: input.now,
+          },
+        });
+      }
+      if (rootNode !== undefined) {
+        yield* emitEvent({
+          type: "node.updated",
+          threadId: input.run.threadId,
+          runId: input.run.id,
+          nodeId: rootNode.id,
+          providerInstanceId: input.run.providerInstanceId,
+          occurredAt: input.now,
+          payload: {
+            ...rootNode,
+            status: "cancelled",
+            completedAt: input.now,
+          },
+        });
+      }
+    });
+
+  const startNextQueuedRun = (threadId: ThreadId) =>
+    Effect.gen(function* () {
+      const projection = yield* projectionStore.getThreadProjection(threadId);
+      if (
+        projection.thread.archivedAt !== null ||
+        projection.thread.deletedAt !== null ||
+        projection.runs.some(isBlockingRun)
+      ) {
+        return;
+      }
+
+      const queuedRun = nextQueuedRun(projection);
+      if (queuedRun === undefined) {
+        return;
+      }
+      const rootNodeId = queuedRun.rootNodeId;
+      const attemptId = queuedRun.activeAttemptId;
+      const providerThreadId = queuedRun.providerThreadId;
+      if (rootNodeId === null || attemptId === null || providerThreadId === null) {
+        return yield* new OrchestratorDispatchError({
+          commandId: CommandId.make(`command:system:start-queued:${queuedRun.id}`),
+          commandType: "message.dispatch",
+          cause: `Queued run ${queuedRun.id} is missing execution identity.`,
+        });
+      }
+
+      const rootNode = projection.nodes.find((candidate) => candidate.id === rootNodeId);
+      const attempt = projection.attempts.find((candidate) => candidate.id === attemptId);
+      const queuedMessage = projection.messages.find(
+        (candidate) => candidate.id === queuedRun.userMessageId,
+      );
+      const legacyQueuedTurnItem = projection.turnItems.find(
+        (
+          candidate,
+        ): candidate is Extract<OrchestrationV2TurnItem, { readonly type: "user_message" }> =>
+          candidate.type === "user_message" &&
+          candidate.runId === queuedRun.id &&
+          candidate.messageId === queuedRun.userMessageId,
+      );
+      const queuedProviderThread = projection.providerThreads.find(
+        (candidate) => candidate.id === providerThreadId,
+      );
+      const storedCheckpointScope = projection.checkpointScopes.find(
+        (scope) => scope.id === rootNode?.checkpointScopeId,
+      );
+      if (
+        rootNode === undefined ||
+        attempt === undefined ||
+        queuedMessage === undefined ||
+        queuedProviderThread === undefined ||
+        (rootNode.checkpointScopeId !== null && storedCheckpointScope === undefined)
+      ) {
+        return yield* new OrchestratorDispatchError({
+          commandId: CommandId.make(`command:system:start-queued:${queuedRun.id}`),
+          commandType: "message.dispatch",
+          cause: `Queued run ${queuedRun.id} is missing projection state.`,
+        });
+      }
+
+      const commandId = CommandId.make(`command:system:start-queued:${queuedRun.id}`);
+      const now = yield* DateTime.now;
+      const checkpointScope =
+        storedCheckpointScope ??
+        (yield* runtimePolicy
+          .resolve({ thread: projection.thread, modelSelection: queuedRun.modelSelection })
+          .pipe(
+            Effect.flatMap((resolvedRuntimePolicy) =>
+              checkpointService.prepareRootRunScope({
+                threadId,
+                runId: queuedRun.id,
+                rootNodeId: rootNode.id,
+                providerThreadId: queuedProviderThread.id,
+                cwd: resolvedRuntimePolicy.cwd ?? projection.thread.worktreePath ?? process.cwd(),
+                createdAt: now,
+              }),
+            ),
+            Effect.mapError(
+              (cause) =>
+                new OrchestratorDispatchError({
+                  commandId,
+                  commandType: "message.dispatch",
+                  cause,
+                }),
+            ),
+          ));
+      const providerSessionId =
+        queuedProviderThread.providerSessionId ??
+        (yield* providerAdapters.get(queuedRun.providerInstanceId).pipe(
+          Effect.flatMap((adapter) =>
+            providerSessionIdFor({
+              adapter,
+              providerInstanceId: queuedRun.providerInstanceId,
+              threadId,
+            }),
+          ),
+          Effect.mapError(
+            (cause) =>
+              new OrchestratorDispatchError({
+                commandId,
+                commandType: "message.dispatch",
+                cause,
+              }),
+          ),
+        ));
+      const providerThread: OrchestrationV2ProviderThread = {
+        ...queuedProviderThread,
+        providerSessionId,
+        status: "not_loaded",
+        firstRunOrdinal: queuedProviderThread.firstRunOrdinal ?? queuedRun.ordinal,
+        lastRunOrdinal: queuedRun.ordinal,
+        updatedAt: now,
+      };
+      const startingRun: OrchestrationV2Run = {
+        ...queuedRun,
+        status: "starting",
+        queuePosition: null,
+        startedAt: null,
+      };
+      const userTurnItem: OrchestrationV2TurnItem = {
+        ...(legacyQueuedTurnItem ?? {
+          id: idAllocator.derive.userTurnItem({ messageId: queuedMessage.id }),
+          threadId,
+          runId: queuedRun.id,
+          nodeId: rootNodeId,
+          providerThreadId: queuedProviderThread.id,
+          providerTurnId: null,
+          nativeItemRef: null,
+          parentItemId: null,
+          ordinal: queuedRun.ordinal * 100,
+          status: "completed",
+          title: null,
+          type: "user_message",
+          messageId: queuedMessage.id,
+          text: queuedMessage.text,
+          attachments: queuedMessage.attachments,
+          createdBy: queuedMessage.createdBy,
+          creationSource: queuedMessage.creationSource,
+        }),
+        inputIntent: "queued_turn",
+        startedAt: now,
+        completedAt: now,
+        updatedAt: now,
+      };
+      const checkpointEvents: ReadonlyArray<Omit<OrchestrationV2DomainEvent, "id">> =
+        storedCheckpointScope === undefined
+          ? [
+              {
+                type: "checkpoint-scope.created",
+                threadId,
+                runId: queuedRun.id,
+                nodeId: rootNode.id,
+                providerInstanceId: queuedRun.providerInstanceId,
+                occurredAt: now,
+                payload: checkpointScope,
+              },
+              {
+                type: "node.updated",
+                threadId,
+                runId: queuedRun.id,
+                nodeId: rootNode.id,
+                providerInstanceId: queuedRun.providerInstanceId,
+                occurredAt: now,
+                payload: { ...rootNode, checkpointScopeId: checkpointScope.id },
+              },
+            ]
+          : [];
+      yield* writeSystemEvents(
+        [
+          ...checkpointEvents,
+          {
+            type: "provider-thread.updated",
+            threadId,
+            providerInstanceId: queuedRun.providerInstanceId,
+            occurredAt: now,
+            payload: providerThread,
+          },
+          {
+            type: "turn-item.updated",
+            threadId,
+            runId: queuedRun.id,
+            nodeId: rootNodeId,
+            providerInstanceId: queuedRun.providerInstanceId,
+            occurredAt: now,
+            payload: userTurnItem,
+          },
+          {
+            type: "run.updated",
+            threadId,
+            runId: queuedRun.id,
+            nodeId: rootNodeId,
+            providerInstanceId: queuedRun.providerInstanceId,
+            occurredAt: now,
+            payload: startingRun,
+          },
+        ],
+        [
+          {
+            id: `effect:${commandId}:provider-turn.start:${queuedRun.id}`,
+            commandId,
+            threadId,
+            request: { type: "provider-turn.start", runId: queuedRun.id },
+          },
+        ],
+      );
+    });
+
+  const resumeQueuedRuns = Effect.gen(function* () {
+    const shell = yield* projectionStore.getShellSnapshot();
+    let resumed = 0;
+    for (const thread of shell.threads) {
+      const resumedThread = yield* Effect.gen(function* () {
+        const projection = yield* projectionStore.getThreadProjection(thread.id);
+        if (projection.runs.some(isBlockingRun) || nextQueuedRun(projection) === undefined) {
+          return false;
+        }
+        yield* threadDispatch.withLock(thread.id, startNextQueuedRun(thread.id));
+        return true;
+      }).pipe(
+        Effect.catch((cause) =>
+          Effect.logWarning("Failed to resume queued V2 run after recovery", {
+            threadId: thread.id,
+            cause,
+          }).pipe(Effect.as(false)),
+        ),
+      );
+      if (resumedThread) {
+        resumed += 1;
+      }
+    }
+    return resumed;
+  }).pipe(
+    Effect.mapError(
+      (cause) =>
+        new OrchestratorDispatchError({
+          commandId: CommandId.make("command:system:resume-queued-runs"),
+          commandType: "message.dispatch",
+          cause,
+        }),
+    ),
+  );
+
+  const dispatchDelegatedTaskCompletionDeliveryResolution = (
+    command: Extract<
+      OrchestrationV2Command,
+      {
+        readonly type:
+          | "delegated_task.completion-delivery.acknowledge"
+          | "delegated_task.completion-delivery.dispose";
+      }
+    >,
+    events: Ref.Ref<Array<OrchestrationV2DomainEvent>>,
+  ) =>
+    Effect.gen(function* () {
+      const projection = yield* projectionStore.getThreadProjection(command.parentThreadId).pipe(
+        Effect.mapError(
+          (cause) =>
+            new OrchestratorProjectionError({
+              threadId: command.parentThreadId,
+              cause,
+            }),
+        ),
+      );
+      const task = projection.subagents.find(
+        (candidate) => candidate.id === command.taskId && candidate.origin === "app_owned",
+      );
+      if (task === undefined) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Delegated task ${command.taskId} is not an app-owned task of thread ${command.parentThreadId}.`,
+        });
+      }
+      const state =
+        command.type === "delegated_task.completion-delivery.acknowledge"
+          ? "acknowledged"
+          : "disposed";
+      const now = yield* DateTime.now;
+      const emitEvent = emit(events, command);
+      // task_status and t3_thread_read use distinct command IDs, so two
+      // valid observations can race after their read preflight. Re-emit the
+      // existing task row so the second dispatch is a successful idempotent
+      // no-op rather than "already acknowledged/disposed" or empty-events.
+      if (
+        task.completionDelivery?.state === state ||
+        (command.type === "delegated_task.completion-delivery.acknowledge" &&
+          task.completionDelivery?.state === "disposed")
+      ) {
+        yield* emitEvent({
+          type: "subagent.updated",
+          threadId: command.parentThreadId,
+          ...(task.runId === null ? {} : { runId: task.runId }),
+          nodeId: task.id,
+          driver: task.driver,
+          providerInstanceId: task.providerInstanceId,
+          occurredAt: now,
+          payload: task,
+        });
+        return;
+      }
+      const updatedTask: OrchestrationV2Subagent = {
+        ...task,
+        completionDelivery: {
+          state,
+          observedByRunId:
+            command.type === "delegated_task.completion-delivery.acknowledge"
+              ? command.observedByRunId
+              : null,
+        },
+        updatedAt: now,
+      };
+      yield* emitEvent({
+        type: "subagent.updated",
+        threadId: command.parentThreadId,
+        ...(task.runId === null ? {} : { runId: task.runId }),
+        nodeId: task.id,
+        driver: task.driver,
+        providerInstanceId: task.providerInstanceId,
+        occurredAt: now,
+        payload: updatedTask,
+      });
+
+      const parentRun =
+        task.runId === null
+          ? undefined
+          : projection.runs.find((candidate) => candidate.id === task.runId);
+      const cohort = parentRun?.delegatedCompletion;
+      const delivery = cohort?.delivery;
+      if (
+        parentRun === undefined ||
+        cohort === undefined ||
+        delivery === null ||
+        delivery === undefined
+      ) {
+        return;
+      }
+      if (!delivery.taskIds.includes(task.id)) {
+        return;
+      }
+
+      const remainingTaskIds = delivery.taskIds.filter((taskId) => taskId !== task.id);
+      const deliveryRun = completionDeliveryRun(projection, delivery);
+      const clearDelivery =
+        remainingTaskIds.length === 0 &&
+        (deliveryRun === undefined || deliveryRun.status === "queued");
+      const updatedCohort: OrchestrationV2DelegatedCompletionCohort = {
+        ...cohort,
+        delivery: clearDelivery
+          ? null
+          : {
+              ...delivery,
+              taskIds: remainingTaskIds,
+            },
+      };
+      yield* emitEvent({
+        type: "run.updated",
+        threadId: command.parentThreadId,
+        runId: parentRun.id,
+        ...(parentRun.rootNodeId === null ? {} : { nodeId: parentRun.rootNodeId }),
+        providerInstanceId: parentRun.providerInstanceId,
+        occurredAt: now,
+        payload: {
+          ...parentRun,
+          delegatedCompletion: updatedCohort,
+        },
+      });
+
+      if (deliveryRun?.status === "queued") {
+        if (remainingTaskIds.length === 0) {
+          yield* emitQueuedRunCancellation({
+            command,
+            events,
+            projection,
+            run: deliveryRun,
+            now,
+          });
+          return;
+        }
+        const message = completionDeliveryMessage(projection, delivery);
+        if (message !== undefined) {
+          yield* emitEvent({
+            type: "message.updated",
+            threadId: command.parentThreadId,
+            runId: deliveryRun.id,
+            ...(deliveryRun.rootNodeId === null ? {} : { nodeId: deliveryRun.rootNodeId }),
+            providerInstanceId: deliveryRun.providerInstanceId,
+            occurredAt: now,
+            payload: {
+              ...message,
+              text: delegatedCompletionWakeDetail(remainingTaskIds),
+              delegatedCompletion: {
+                parentRunId: parentRun.id,
+                generation: delivery.generation,
+                taskIds: remainingTaskIds,
+              },
+              updatedAt: now,
+            },
+          });
+        }
+      }
+    });
+
+  const disposeDelegatedCompletionCohort = (input: {
+    readonly command: OrchestrationV2Command;
+    readonly events: Ref.Ref<Array<OrchestrationV2DomainEvent>>;
+    readonly projection: OrchestrationV2ThreadProjection;
+    readonly parentRunId: RunId;
+    readonly disposition: "stopped" | "disposed";
+    readonly now: DateTime.Utc;
+    readonly cancelQueuedDelivery?: boolean;
+  }) =>
+    Effect.gen(function* () {
+      const parentRun = input.projection.runs.find(
+        (candidate) => candidate.id === input.parentRunId,
+      );
+      if (parentRun === undefined) {
+        return;
+      }
+      const cohort = parentRun.delegatedCompletion;
+      const tasks = input.projection.subagents.filter(
+        (candidate) => candidate.origin === "app_owned" && candidate.runId === input.parentRunId,
+      );
+      if (cohort === undefined && tasks.length === 0) {
+        return;
+      }
+      const emitEvent = emit(input.events, input.command);
+      const nextDisposition = cohort?.disposition === "disposed" ? "disposed" : input.disposition;
+      const nextCohort = {
+        disposition: nextDisposition,
+        nextGeneration: cohort?.nextGeneration ?? 1,
+        settledDeliveryCount: cohort?.settledDeliveryCount ?? 0,
+        delivery: null,
+      } as const;
+      yield* emitEvent({
+        type: "run.updated",
+        threadId: parentRun.threadId,
+        runId: parentRun.id,
+        ...(parentRun.rootNodeId === null ? {} : { nodeId: parentRun.rootNodeId }),
+        providerInstanceId: parentRun.providerInstanceId,
+        occurredAt: input.now,
+        payload: {
+          ...parentRun,
+          delegatedCompletion: nextCohort,
+        },
+      });
+      for (const task of tasks) {
+        if (
+          task.completionDelivery?.state === "acknowledged" ||
+          task.completionDelivery?.state === "delivered" ||
+          task.completionDelivery?.state === "disposed"
+        ) {
+          continue;
+        }
+        yield* emitEvent({
+          type: "subagent.updated",
+          threadId: parentRun.threadId,
+          ...(task.runId === null ? {} : { runId: task.runId }),
+          nodeId: task.id,
+          driver: task.driver,
+          providerInstanceId: task.providerInstanceId,
+          occurredAt: input.now,
+          payload: {
+            ...task,
+            completionDelivery: {
+              state: "disposed",
+              observedByRunId: null,
+            },
+            updatedAt: input.now,
+          },
+        });
+      }
+      const deliveryRun = completionDeliveryRun(input.projection, cohort?.delivery ?? null);
+      if (input.cancelQueuedDelivery !== false && deliveryRun?.status === "queued") {
+        yield* emitQueuedRunCancellation({
+          command: input.command,
+          events: input.events,
+          projection: input.projection,
+          run: deliveryRun,
+          now: input.now,
+        });
+      }
+    });
+
+  const disposeAllDelegatedCompletionCohorts = (input: {
+    readonly command: OrchestrationV2Command;
+    readonly events: Ref.Ref<Array<OrchestrationV2DomainEvent>>;
+    readonly projection: OrchestrationV2ThreadProjection;
+    readonly now: DateTime.Utc;
+    readonly cancelQueuedDelivery?: boolean;
+  }) =>
+    Effect.forEach(
+      Array.from(
+        new Set([
+          ...input.projection.runs
+            .filter((run) => run.delegatedCompletion !== undefined)
+            .map((run) => run.id),
+          ...input.projection.subagents
+            .filter((task) => task.origin === "app_owned" && task.runId !== null)
+            .map((task) => task.runId!),
+        ]),
+      ),
+      (parentRunId) =>
+        disposeDelegatedCompletionCohort({
+          ...input,
+          parentRunId,
+          disposition: "disposed",
+        }),
+      { concurrency: 1, discard: true },
+    );
+
+  const dispatchThreadCreate = Effect.fn("orchestrationV2.dispatch.threadCreate")(function* (
+    command: Extract<OrchestrationV2Command, { readonly type: "thread.create" }>,
+    events: Ref.Ref<Array<OrchestrationV2DomainEvent>>,
+  ) {
+    yield* Effect.annotateCurrentSpan({
+      "orchestration_v2.command_id": command.commandId,
+      "orchestration_v2.command_type": command.type,
+      "orchestration_v2.thread_id": command.threadId,
+      "orchestration_v2.driver": command.modelSelection.instanceId,
+    });
+
+    const now = yield* DateTime.now;
+    const emitEvent = emit(events, command);
+    const thread: OrchestrationV2AppThread = {
+      createdBy: command.createdBy,
+      creationSource: command.creationSource,
+      id: command.threadId,
+      projectId: command.projectId,
+      title: command.title,
+      providerInstanceId: command.modelSelection.instanceId,
+      modelSelection: command.modelSelection,
+      runtimeMode: command.runtimeMode,
+      interactionMode: command.interactionMode,
+      branch: command.branch,
+      worktreePath: command.worktreePath,
+      activeProviderThreadId: null,
+      lineage: {
+        parentThreadId: null,
+        relationshipToParent: null,
+        rootThreadId: command.threadId,
+      },
+      forkedFrom: null,
+      createdAt: now,
+      updatedAt: now,
+      archivedAt: null,
+      settledOverride: null,
+      settledAt: null,
+      snoozedUntil: null,
+      snoozedAt: null,
+      lastVisitedAt: null,
+      deletedAt: null,
+    };
+
+    yield* emitEvent({
+      type: "thread.created",
+      threadId: command.threadId,
+      providerInstanceId: command.modelSelection.instanceId,
+      occurredAt: now,
+      payload: thread,
+    });
+  });
+
+  const dispatchThreadMutation = Effect.fn("orchestrationV2.dispatch.threadMutation")(function* (
+    command: Extract<
+      OrchestrationV2Command,
+      {
+        readonly type:
+          | "thread.archive"
+          | "thread.unarchive"
+          | "thread.delete"
+          | "thread.settle"
+          | "thread.unsettle"
+          | "thread.snooze"
+          | "thread.unsnooze"
+          | "thread.pin"
+          | "thread.unpin"
+          | "thread.pin.reorder"
+          | "thread.visit"
+          | "thread.mark-unread"
+          | "thread.metadata.update"
+          | "thread.title.regeneration.complete"
+          | "thread.runtime-mode.set"
+          | "thread.interaction-mode.set"
+          | "thread.model-selection.set"
+          | "provider.switch";
+      }
+    >,
+    events: Ref.Ref<Array<OrchestrationV2DomainEvent>>,
+    effects: Ref.Ref<Array<PendingOrchestrationEffectV2>>,
+  ) {
+    const projection = yield* projectionStore.getThreadProjection(command.threadId).pipe(
+      Effect.mapError(
+        (cause) =>
+          new OrchestratorProjectionError({
+            threadId: command.threadId,
+            cause,
+          }),
+      ),
+    );
+    const thread = projection.thread;
+    if (thread.deletedAt !== null && command.type !== "thread.delete") {
+      return yield* new OrchestratorDispatchError({
+        commandId: command.commandId,
+        commandType: command.type,
+        cause: `Thread ${command.threadId} is deleted.`,
+      });
+    }
+    if (
+      command.type === "thread.metadata.update" &&
+      command.expectedWorktreePath !== undefined &&
+      command.expectedWorktreePath !== thread.worktreePath
+    ) {
+      return yield* new OrchestratorDispatchError({
+        commandId: command.commandId,
+        commandType: command.type,
+        cause: `Thread ${command.threadId} worktree changed before the metadata update could be applied.`,
+      });
+    }
+    if (command.type === "thread.archive" && thread.archivedAt !== null) {
+      return yield* new OrchestratorDispatchError({
+        commandId: command.commandId,
+        commandType: command.type,
+        cause: `Thread ${command.threadId} is already archived.`,
+      });
+    }
+    if (command.type === "thread.unarchive" && thread.archivedAt === null) {
+      return yield* new OrchestratorDispatchError({
+        commandId: command.commandId,
+        commandType: command.type,
+        cause: `Thread ${command.threadId} is not archived.`,
+      });
+    }
+    if (
+      (command.type === "thread.settle" ||
+        command.type === "thread.unsettle" ||
+        command.type === "thread.snooze" ||
+        command.type === "thread.unsnooze" ||
+        command.type === "thread.pin" ||
+        command.type === "thread.unpin" ||
+        command.type === "thread.pin.reorder") &&
+      thread.archivedAt !== null
+    ) {
+      return yield* new OrchestratorDispatchError({
+        commandId: command.commandId,
+        commandType: command.type,
+        cause: `Thread ${command.threadId} is archived.`,
+      });
+    }
+    // Only pinned threads have a slot in the arranged order. Rejecting
+    // (rather than silently pinning) keeps a raced reorder-after-unpin from
+    // resurrecting a pin the user just cleared.
+    if (command.type === "thread.pin.reorder" && thread.pinnedAt == null) {
+      return yield* new OrchestratorDispatchError({
+        commandId: command.commandId,
+        commandType: command.type,
+        cause: `Thread ${command.threadId} is not pinned and cannot be reordered.`,
+      });
+    }
+    if (
+      command.type === "thread.settle" &&
+      (projection.runs.some((run) =>
+        ["preparing", "queued", "starting", "running", "waiting"].includes(run.status),
+      ) ||
+        projection.runtimeRequests.some((request) => request.status === "pending"))
+    ) {
+      return yield* new OrchestratorDispatchError({
+        commandId: command.commandId,
+        commandType: command.type,
+        cause: `Thread ${command.threadId} has active or blocked work and cannot be settled.`,
+      });
+    }
+
+    const providerSwitchPlan =
+      command.type === "thread.model-selection.set" || command.type === "provider.switch"
+        ? yield* Effect.gen(function* () {
+            yield* providerAdapters.get(command.modelSelection.instanceId).pipe(
+              Effect.mapError(
+                (cause) =>
+                  new OrchestratorProviderAdapterError({
+                    commandId: command.commandId,
+                    providerInstanceId: command.modelSelection.instanceId,
+                    cause,
+                  }),
+              ),
+            );
+            return yield* providerSwitchService
+              .plan({
+                projection,
+                targetModelSelection: command.modelSelection,
+              })
+              .pipe(mapDispatchError(command));
+          })
+        : null;
+
+    const now = yield* DateTime.now;
+    let snoozedUntil: DateTime.Utc | null = null;
+    if (command.type === "thread.snooze") {
+      const parsedSnoozedUntil = DateTime.make(command.snoozedUntil);
+      if (
+        Option.isNone(parsedSnoozedUntil) ||
+        DateTime.toEpochMillis(parsedSnoozedUntil.value) <= DateTime.toEpochMillis(now)
+      ) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Thread ${command.threadId} snooze wake time ${command.snoozedUntil} is not in the future.`,
+        });
+      }
+      if (projection.runtimeRequests.some((request) => request.status === "pending")) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Thread ${command.threadId} has a pending approval or user-input request and cannot be snoozed.`,
+        });
+      }
+      if (projection.runs.some((run) => run.status === "queued")) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Thread ${command.threadId} has a queued run and cannot be snoozed.`,
+        });
+      }
+      snoozedUntil = parsedSnoozedUntil.value;
+    }
+    let visitedAt: DateTime.Utc | null = null;
+    if (command.type === "thread.visit") {
+      const parsedVisitedAt = DateTime.make(command.visitedAt);
+      if (Option.isNone(parsedVisitedAt)) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Thread ${command.threadId} visit time ${command.visitedAt} is not a valid timestamp.`,
+        });
+      }
+      visitedAt = parsedVisitedAt.value;
+    }
+    let markUnreadVisitedAt: DateTime.Utc | null = null;
+    if (command.type === "thread.mark-unread") {
+      const latestRunCompletedAt = projection.runs.at(-1)?.completedAt ?? null;
+      if (latestRunCompletedAt === null) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Thread ${command.threadId} has no completed run to mark unread.`,
+        });
+      }
+      markUnreadVisitedAt = DateTime.subtract(latestRunCompletedAt, { milliseconds: 1 });
+    }
+    const updatedThread: OrchestrationV2AppThread = (() => {
+      switch (command.type) {
+        case "thread.archive":
+          return { ...thread, archivedAt: now, titleRegeneration: null, updatedAt: now };
+        case "thread.unarchive":
+          return { ...thread, archivedAt: null, updatedAt: now };
+        case "thread.delete":
+          return {
+            ...thread,
+            deletedAt: thread.deletedAt ?? now,
+            titleRegeneration: null,
+            updatedAt: now,
+          };
+        case "thread.settle": {
+          // Settling is "I'm done with this": it clears a pin the same way it
+          // parks the thread (mirrors the v1 decider's settle/pin exclusion).
+          const wasPinned = thread.pinnedAt != null;
+          const alreadySettled =
+            thread.settledOverride === "settled" && thread.settledAt !== null && !wasPinned;
+          return {
+            ...thread,
+            settledOverride: "settled",
+            settledAt: alreadySettled ? thread.settledAt : now,
+            unsettledAt: null,
+            pinnedAt: null,
+            pinOrderKey: null,
+            updatedAt: alreadySettled ? thread.updatedAt : now,
+          };
+        }
+        case "thread.unsettle": {
+          const alreadyPinnedActive = thread.settledOverride === "active";
+          return {
+            ...thread,
+            settledOverride: "active",
+            settledAt: null,
+            unsettledAt: alreadyPinnedActive ? (thread.unsettledAt ?? null) : now,
+            updatedAt: alreadyPinnedActive ? thread.updatedAt : now,
+          };
+        }
+        case "thread.snooze": {
+          const sameWakeTime =
+            thread.snoozedUntil != null &&
+            snoozedUntil !== null &&
+            DateTime.toEpochMillis(thread.snoozedUntil) === DateTime.toEpochMillis(snoozedUntil);
+          const existingSnoozedAt = sameWakeTime ? (thread.snoozedAt ?? null) : null;
+          return {
+            ...thread,
+            snoozedUntil,
+            snoozedAt: existingSnoozedAt ?? now,
+            updatedAt: existingSnoozedAt === null ? now : thread.updatedAt,
+          };
+        }
+        case "thread.unsnooze": {
+          const alreadyAwake = thread.snoozedUntil == null;
+          return {
+            ...thread,
+            snoozedUntil: null,
+            snoozedAt: null,
+            updatedAt: alreadyAwake ? thread.updatedAt : now,
+          };
+        }
+        case "thread.pin": {
+          // Pinning is a promotion: it clears the parked states rather than
+          // silently outranking them — an explicit settle is un-settled and a
+          // snooze's return ticket is spent (the thread is on top NOW).
+          const alreadyPinned = thread.pinnedAt != null;
+          const promotes = thread.settledOverride === "settled" || thread.snoozedUntil != null;
+          return {
+            ...thread,
+            pinnedAt: alreadyPinned ? thread.pinnedAt : now,
+            // A fresh pin takes the client's slot in the arranged order; on a
+            // re-pin the existing key wins so raced duplicates cannot move a
+            // thread the user already placed.
+            ...(alreadyPinned || command.orderKey === undefined
+              ? {}
+              : { pinOrderKey: command.orderKey }),
+            settledOverride:
+              thread.settledOverride === "settled" ? "active" : thread.settledOverride,
+            settledAt: thread.settledOverride === "settled" ? null : thread.settledAt,
+            snoozedUntil: null,
+            snoozedAt: null,
+            updatedAt: alreadyPinned && !promotes ? thread.updatedAt : now,
+          };
+        }
+        case "thread.unpin": {
+          const alreadyUnpinned = thread.pinnedAt == null;
+          return {
+            ...thread,
+            pinnedAt: null,
+            // Unpin clears the slot: re-pinning is "pin again", not "restore
+            // an ancient position".
+            pinOrderKey: null,
+            updatedAt: alreadyUnpinned ? thread.updatedAt : now,
+          };
+        }
+        case "thread.pin.reorder": {
+          // Idempotent by re-emission (see thread.settle): a duplicate drop on
+          // the same slot keeps the existing updatedAt so it projects as a
+          // no-op.
+          const keyUnchanged = thread.pinOrderKey === command.orderKey;
+          return {
+            ...thread,
+            pinOrderKey: command.orderKey,
+            updatedAt: keyUnchanged ? thread.updatedAt : now,
+          };
+        }
+        // Visited tracking records read state only; it must not bump updatedAt,
+        // otherwise viewing a thread would count as activity (and re-trigger the
+        // clients that dispatch thread.visit whenever updatedAt advances).
+        case "thread.visit": {
+          const previousVisitedAt = thread.lastVisitedAt;
+          const movesForward =
+            visitedAt !== null &&
+            (previousVisitedAt === null ||
+              DateTime.toEpochMillis(visitedAt) > DateTime.toEpochMillis(previousVisitedAt));
+          return movesForward ? { ...thread, lastVisitedAt: visitedAt } : thread;
+        }
+        case "thread.mark-unread":
+          return { ...thread, lastVisitedAt: markUnreadVisitedAt };
+        case "thread.metadata.update":
+          return {
+            ...thread,
+            ...(command.title === undefined ? {} : { title: command.title }),
+            ...(command.branch === undefined ? {} : { branch: command.branch }),
+            ...(command.worktreePath === undefined ? {} : { worktreePath: command.worktreePath }),
+            // regenerateTitle: true arms the in-flight marker; a landing title
+            // or an explicit false (generation failed/abandoned) clears it.
+            ...(command.regenerateTitle === true
+              ? { titleRegeneration: { requestId: command.commandId, startedAt: now } }
+              : command.regenerateTitle === false || command.title !== undefined
+                ? { titleRegeneration: null }
+                : {}),
+            updatedAt: now,
+          };
+        case "thread.title.regeneration.complete":
+          return thread.titleRegeneration?.requestId === command.requestId
+            ? {
+                ...thread,
+                ...(command.title === undefined ? {} : { title: command.title }),
+                titleRegeneration: null,
+                updatedAt: now,
+              }
+            : thread;
+        case "thread.runtime-mode.set":
+          return { ...thread, runtimeMode: command.runtimeMode, updatedAt: now };
+        case "thread.interaction-mode.set":
+          return { ...thread, interactionMode: command.interactionMode, updatedAt: now };
+        case "thread.model-selection.set":
+        case "provider.switch":
+          return {
+            ...thread,
+            providerInstanceId: command.modelSelection.instanceId,
+            modelSelection: command.modelSelection,
+            updatedAt: now,
+          };
+      }
+    })();
+    const eventType = (() => {
+      switch (command.type) {
+        case "thread.archive":
+          return "thread.archived" as const;
+        case "thread.unarchive":
+          return "thread.unarchived" as const;
+        case "thread.delete":
+          return "thread.deleted" as const;
+        case "thread.settle":
+          return "thread.settled" as const;
+        case "thread.unsettle":
+          return "thread.unsettled" as const;
+        case "thread.snooze":
+          return "thread.snoozed" as const;
+        case "thread.unsnooze":
+          return "thread.unsnoozed" as const;
+        case "thread.pin":
+          return "thread.pinned" as const;
+        case "thread.unpin":
+          return "thread.unpinned" as const;
+        case "thread.pin.reorder":
+          return "thread.pin-reordered" as const;
+        case "thread.visit":
+          return "thread.visited" as const;
+        case "thread.mark-unread":
+          return "thread.marked-unread" as const;
+        case "thread.metadata.update":
+        case "thread.title.regeneration.complete":
+          return "thread.metadata-updated" as const;
+        case "thread.runtime-mode.set":
+          return "thread.runtime-mode-updated" as const;
+        case "thread.interaction-mode.set":
+          return "thread.interaction-mode-updated" as const;
+        case "thread.model-selection.set":
+          return "thread.model-selection-updated" as const;
+        case "provider.switch":
+          return "thread.provider-switched" as const;
+      }
+    })();
+    yield* emit(
+      events,
+      command,
+    )({
+      type: eventType,
+      threadId: command.threadId,
+      providerInstanceId: updatedThread.providerInstanceId,
+      occurredAt: now,
+      payload: updatedThread,
+    });
+
+    if (command.type === "thread.metadata.update" && command.regenerateTitle === true) {
+      yield* Ref.update(effects, (existing) => [
+        ...existing,
+        pendingThreadTitleGenerationEffect(command.commandId, command.threadId, {
+          type: "regenerate",
+        }),
+      ]);
+    }
+
+    if (command.type === "thread.archive" || command.type === "thread.delete") {
+      const emitEvent = emit(events, command);
+      const activeRunIds = new Set(
+        projection.runs
+          .filter((run) => {
+            if (command.type === "thread.archive") {
+              return run.status === "queued";
+            }
+            return ["preparing", "queued", "starting", "running", "waiting"].includes(run.status);
+          })
+          .map((run) => run.id),
+      );
+      for (const run of projection.runs.filter((candidate) => activeRunIds.has(candidate.id))) {
+        yield* emitEvent({
+          type: "run.updated",
+          threadId: command.threadId,
+          runId: run.id,
+          providerInstanceId: run.providerInstanceId,
+          occurredAt: now,
+          payload: { ...run, status: "cancelled", queuePosition: null, completedAt: now },
+        });
+      }
+      for (const attempt of projection.attempts.filter(
+        (candidate) =>
+          activeRunIds.has(candidate.runId) &&
+          (candidate.status === "pending" || candidate.status === "running"),
+      )) {
+        const run = projection.runs.find((candidate) => candidate.id === attempt.runId)!;
+        yield* emitEvent({
+          type: "run-attempt.updated",
+          threadId: command.threadId,
+          runId: attempt.runId,
+          nodeId: attempt.rootNodeId,
+          providerInstanceId: run.providerInstanceId,
+          occurredAt: now,
+          payload: { ...attempt, status: "cancelled", completedAt: now },
+        });
+      }
+      for (const node of projection.nodes.filter(
+        (candidate) =>
+          candidate.runId !== null &&
+          activeRunIds.has(candidate.runId) &&
+          ["pending", "running", "waiting"].includes(candidate.status),
+      )) {
+        const run = projection.runs.find((candidate) => candidate.id === node.runId)!;
+        yield* emitEvent({
+          type: "node.updated",
+          threadId: command.threadId,
+          runId: run.id,
+          nodeId: node.id,
+          providerInstanceId: run.providerInstanceId,
+          occurredAt: now,
+          payload: { ...node, status: "cancelled", completedAt: now },
+        });
+      }
+      if (command.type === "thread.delete") {
+        for (const request of projection.runtimeRequests.filter(
+          (candidate) => candidate.status === "pending",
+        )) {
+          yield* emitEvent({
+            type: "runtime-request.updated",
+            threadId: command.threadId,
+            nodeId: request.nodeId,
+            occurredAt: now,
+            payload: {
+              ...request,
+              status: "cancelled",
+              responseCapability: {
+                type: "not_resumable",
+                reason: "The thread was deleted.",
+              },
+              resolvedAt: now,
+            },
+          });
+        }
+      }
+
+      yield* disposeAllDelegatedCompletionCohorts({
+        command,
+        events,
+        projection: yield* getProjectionWithPendingEvents(command.threadId, events),
+        now,
+        cancelQueuedDelivery: false,
+      });
+    }
+
+    // Settle joins archive/delete here: all three mean "done with this
+    // thread", so a live provider session must not keep running background
+    // work (PR monitors, dev servers, subagent fleets) after any of them
+    // lands. The settle guard above already rejects active or blocked runs,
+    // so for settle this only ever stops an idle session; commands are
+    // decided serially against the projection, so a turn start that
+    // re-engages the thread cannot race this detach.
+    const detachSessionIds = new Set(
+      command.type === "thread.archive" ||
+        command.type === "thread.delete" ||
+        command.type === "thread.settle"
+        ? projection.providerSessions.map((session) => session.id)
+        : command.type === "thread.metadata.update" &&
+            command.worktreePath !== undefined &&
+            command.worktreePath !== thread.worktreePath
+          ? projection.providerSessions.map((session) => session.id)
+          : command.type === "thread.runtime-mode.set"
+            ? projection.providerSessions
+                .filter(
+                  (session) => !session.capabilities.sessions.supportsRuntimeModeSwitchInSession,
+                )
+                .map((session) => session.id)
+            : (providerSwitchPlan?.releaseProviderSessionIds ?? []),
+    );
+    if (detachSessionIds.size > 0) {
+      const liveSessions = projection.providerSessions.filter(
+        (session) =>
+          detachSessionIds.has(session.id) &&
+          session.status !== "stopped" &&
+          session.status !== "error",
+      );
+      yield* Effect.forEach(
+        liveSessions,
+        (session) =>
+          Effect.gen(function* () {
+            yield* emit(
+              events,
+              command,
+            )({
+              type: "provider-session.detached",
+              threadId: command.threadId,
+              driver: session.driver,
+              providerInstanceId: session.providerInstanceId,
+              occurredAt: now,
+              payload: {
+                providerSessionId: session.id,
+                detachedAt: now,
+                reason:
+                  command.type === "thread.archive"
+                    ? "Thread archived."
+                    : command.type === "thread.settle"
+                      ? "Thread settled."
+                      : command.type === "thread.delete"
+                        ? "Thread deleted."
+                        : command.type === "thread.metadata.update"
+                          ? "Workspace changed."
+                          : command.type === "thread.runtime-mode.set"
+                            ? "Runtime mode changed."
+                            : "Provider or model selection changed.",
+              },
+            });
+            const pendingEffect = {
+              id: `effect:${command.commandId}:provider-session.detach:${session.id}`,
+              commandId: command.commandId,
+              threadId: command.threadId,
+              request: {
+                type: "provider-session.detach",
+                providerSessionId: session.id,
+                detail:
+                  command.type === "thread.archive"
+                    ? "Thread archived."
+                    : command.type === "thread.settle"
+                      ? "Thread settled."
+                      : command.type === "thread.delete"
+                        ? "Thread deleted."
+                        : command.type === "thread.metadata.update"
+                          ? "Workspace changed."
+                          : command.type === "thread.runtime-mode.set"
+                            ? "Runtime mode changed."
+                            : "Provider or model selection changed.",
+                // Terminal detaches revoke the thread's MCP credentials; other
+                // detach reasons keep them so a re-attaching provider process
+                // stays authorized.
+                ...(command.type === "thread.archive" || command.type === "thread.delete"
+                  ? { revokeMcpCredential: true }
+                  : {}),
+              },
+            } satisfies PendingOrchestrationEffectV2;
+            yield* Ref.update(effects, (existing) => [...existing, pendingEffect]);
+          }),
+        { concurrency: 1, discard: true },
+      );
+    }
+
+    if (command.type === "thread.archive" || command.type === "thread.delete") {
+      yield* Ref.update(effects, (existing) => [
+        ...existing,
+        {
+          id: `effect:${command.commandId}:terminal.cleanup`,
+          commandId: command.commandId,
+          threadId: command.threadId,
+          request: { type: "terminal.cleanup" },
+        } satisfies PendingOrchestrationEffectV2,
+      ]);
+    }
+
+    if (command.type === "thread.delete") {
+      const attachmentIds = Array.from(
+        new Set(
+          projection.messages.flatMap((message) => message.attachments.map((item) => item.id)),
+        ),
+      );
+      if (attachmentIds.length > 0) {
+        yield* Ref.update(effects, (existing) => [
+          ...existing,
+          {
+            id: `effect:${command.commandId}:attachment.cleanup`,
+            commandId: command.commandId,
+            threadId: command.threadId,
+            request: { type: "attachment.cleanup", attachmentIds },
+          } satisfies PendingOrchestrationEffectV2,
+        ]);
+      }
+    }
+  });
+
+  const dispatchProviderSessionDetach = Effect.fn("orchestrationV2.dispatch.providerSessionDetach")(
+    function* (
+      command: Extract<OrchestrationV2Command, { readonly type: "provider-session.detach" }>,
+      events: Ref.Ref<Array<OrchestrationV2DomainEvent>>,
+      effects: Ref.Ref<Array<PendingOrchestrationEffectV2>>,
+    ) {
+      const projection = yield* projectionStore
+        .getThreadProjection(command.threadId)
+        .pipe(
+          Effect.mapError(
+            (cause) => new OrchestratorProjectionError({ threadId: command.threadId, cause }),
+          ),
+        );
+      const session = projection.providerSessions.find(
+        (candidate) => candidate.id === command.providerSessionId,
+      );
+      if (session === undefined) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Provider session ${command.providerSessionId} does not belong to thread ${command.threadId}.`,
+        });
+      }
+      const now = yield* DateTime.now;
+      yield* emit(
+        events,
+        command,
+      )({
+        type: "provider-session.detached",
+        threadId: command.threadId,
+        driver: session.driver,
+        providerInstanceId: session.providerInstanceId,
+        occurredAt: now,
+        payload: {
+          providerSessionId: session.id,
+          detachedAt: now,
+          ...(command.reason === undefined ? {} : { reason: command.reason }),
+        },
+      });
+      const pendingEffect = {
+        id: `effect:${command.commandId}:provider-session.detach:${command.providerSessionId}`,
+        commandId: command.commandId,
+        threadId: command.threadId,
+        request: {
+          type: "provider-session.detach",
+          providerSessionId: command.providerSessionId,
+          ...(command.reason === undefined ? {} : { detail: command.reason }),
+        },
+      } satisfies PendingOrchestrationEffectV2;
+      yield* Ref.update(effects, (existing) => [...existing, pendingEffect]);
+    },
+  );
+
+  const dispatchThreadFork = Effect.fn("orchestrationV2.dispatch.threadFork")(function* (
+    command: Extract<OrchestrationV2Command, { readonly type: "thread.fork" }>,
+    events: Ref.Ref<Array<OrchestrationV2DomainEvent>>,
+  ) {
+    yield* Effect.annotateCurrentSpan({
+      "orchestration_v2.command_id": command.commandId,
+      "orchestration_v2.command_type": command.type,
+      "orchestration_v2.source_thread_id": command.sourceThreadId,
+      "orchestration_v2.target_thread_id": command.targetThreadId,
+      "orchestration_v2.source_point_type": command.sourcePoint.type,
+    });
+
+    const sourceProjection = yield* projectionStore
+      .getThreadProjection(command.sourceThreadId)
+      .pipe(
+        Effect.mapError(
+          (cause) =>
+            new OrchestratorProjectionError({
+              threadId: command.sourceThreadId,
+              cause,
+            }),
+        ),
+      );
+
+    const sourceRun = runForSourcePoint(sourceProjection, command.sourcePoint);
+
+    if (sourceRun === null) {
+      return yield* new OrchestratorDispatchError({
+        commandId: command.commandId,
+        commandType: command.type,
+        cause: `No stable source run was found for fork source ${command.sourcePoint.type}.`,
+      });
+    }
+    if (sourceRun.status !== "completed") {
+      return yield* new OrchestratorDispatchError({
+        commandId: command.commandId,
+        commandType: command.type,
+        cause: `Fork source run ${sourceRun.id} is ${sourceRun.status}; only completed runs are supported.`,
+      });
+    }
+    const sourceProviderThread = providerThreadForRun(sourceProjection, sourceRun);
+    const now = command.createdAt ?? (yield* DateTime.now);
+    const emitEvent = emit(events, command);
+    const transferId = yield* mapDispatchError(command)(
+      idAllocator.allocate.contextTransfer({
+        sourceThreadId: sourceProjection.thread.id,
+        targetThreadId: command.targetThreadId,
+        type: "fork",
+      }),
+    );
+    const { targetThread, transfer } = yield* threadForkService
+      .plan({
+        sourceProjection,
+        sourceRun,
+        sourceProviderThread,
+        canonicalSourcePoint: contextSourcePointForRun(sourceProjection, sourceRun),
+        transferId,
+        targetThreadId: command.targetThreadId,
+        ...(command.title === undefined ? {} : { title: command.title }),
+        createdBy: command.createdBy,
+        creationSource: command.creationSource,
+        createdAt: now,
+      })
+      .pipe(mapDispatchError(command));
+
+    yield* emitEvent({
+      type: "thread.created",
+      threadId: command.targetThreadId,
+      providerInstanceId: targetThread.providerInstanceId,
+      occurredAt: now,
+      payload: targetThread,
+    });
+    yield* emitEvent({
+      type: "context-transfer.created",
+      threadId: command.targetThreadId,
+      providerInstanceId: sourceRun.providerInstanceId,
+      occurredAt: now,
+      payload: transfer,
+    });
+  });
+
+  const dispatchThreadMergeBack = Effect.fn("orchestrationV2.dispatch.threadMergeBack")(function* (
+    command: Extract<OrchestrationV2Command, { readonly type: "thread.merge_back" }>,
+    events: Ref.Ref<Array<OrchestrationV2DomainEvent>>,
+  ) {
+    yield* Effect.annotateCurrentSpan({
+      "orchestration_v2.command_id": command.commandId,
+      "orchestration_v2.command_type": command.type,
+      "orchestration_v2.source_thread_id": command.sourceThreadId,
+      "orchestration_v2.target_thread_id": command.targetThreadId,
+      "orchestration_v2.source_point_type": command.sourcePoint.type,
+    });
+
+    const sourceProjection = yield* projectionStore
+      .getThreadProjection(command.sourceThreadId)
+      .pipe(
+        Effect.mapError(
+          (cause) =>
+            new OrchestratorProjectionError({
+              threadId: command.sourceThreadId,
+              cause,
+            }),
+        ),
+      );
+    const targetProjection = yield* projectionStore
+      .getThreadProjection(command.targetThreadId)
+      .pipe(
+        Effect.mapError(
+          (cause) =>
+            new OrchestratorProjectionError({
+              threadId: command.targetThreadId,
+              cause,
+            }),
+        ),
+      );
+
+    if (
+      sourceProjection.thread.lineage.relationshipToParent !== "fork" ||
+      sourceProjection.thread.lineage.parentThreadId !== command.targetThreadId
+    ) {
+      return yield* new OrchestratorDispatchError({
+        commandId: command.commandId,
+        commandType: command.type,
+        cause: `Thread ${command.sourceThreadId} is not a fork of ${command.targetThreadId}.`,
+      });
+    }
+
+    const sourceRun = runForSourcePoint(sourceProjection, command.sourcePoint);
+    if (sourceRun === null) {
+      return yield* new OrchestratorDispatchError({
+        commandId: command.commandId,
+        commandType: command.type,
+        cause: `No stable source run was found for merge-back source ${command.sourcePoint.type}.`,
+      });
+    }
+    if (sourceRun.status !== "completed" && sourceRun.status !== "waiting") {
+      return yield* new OrchestratorDispatchError({
+        commandId: command.commandId,
+        commandType: command.type,
+        cause: `Merge-back source run ${sourceRun.id} is ${sourceRun.status}; only provider-finished runs are supported.`,
+      });
+    }
+
+    const forkTransfer = sourceProjection.contextTransfers.findLast(
+      (transfer) =>
+        transfer.type === "fork" &&
+        transfer.sourceThreadId === command.targetThreadId &&
+        transfer.targetThreadId === command.sourceThreadId,
+    );
+    if (forkTransfer === undefined) {
+      return yield* new OrchestratorDispatchError({
+        commandId: command.commandId,
+        commandType: command.type,
+        cause: `No fork transfer exists between ${command.targetThreadId} and ${command.sourceThreadId}.`,
+      });
+    }
+
+    const sourceProviderThread = providerThreadForRun(sourceProjection, sourceRun);
+    const now = command.createdAt ?? (yield* DateTime.now);
+    const emitEvent = emit(events, command);
+    const transferId = yield* mapDispatchError(command)(
+      idAllocator.allocate.contextTransfer({
+        sourceThreadId: command.sourceThreadId,
+        targetThreadId: command.targetThreadId,
+        type: "merge_back",
+      }),
+    );
+    const pendingMergeBackTransfersForPair = targetProjection.contextTransfers.filter(
+      (transfer) =>
+        transfer.type === "merge_back" &&
+        transfer.status === "pending" &&
+        transfer.sourceThreadId === command.sourceThreadId &&
+        transfer.targetThreadId === command.targetThreadId,
+    );
+    const transfer: OrchestrationV2ContextTransfer = {
+      id: transferId,
+      type: "merge_back",
+      sourceThreadId: command.sourceThreadId,
+      targetThreadId: command.targetThreadId,
+      sourcePoint: contextSourcePointForRun(sourceProjection, sourceRun),
+      basePoint: forkTransfer.sourcePoint,
+      sourceProviderInstanceId: sourceRun.providerInstanceId,
+      targetProviderInstanceId: targetProjection.thread.modelSelection.instanceId,
+      targetRunId: null,
+      status: "pending",
+      resolution: null,
+      createdBy: command.createdBy,
+      error:
+        sourceProviderThread === undefined ? "Source merge-back run has no provider thread." : null,
+      createdAt: now,
+      updatedAt: now,
+      consumedAt: null,
+    };
+
+    for (const pendingTransfer of pendingMergeBackTransfersForPair) {
+      yield* emitEvent({
+        type: "context-transfer.updated",
+        threadId: command.targetThreadId,
+        providerInstanceId: sourceRun.providerInstanceId,
+        occurredAt: now,
+        payload: {
+          ...pendingTransfer,
+          status: "superseded",
+          error: `Superseded by merge-back transfer ${transferId}.`,
+          updatedAt: now,
+        },
+      });
+    }
+    yield* emitEvent({
+      type: "context-transfer.created",
+      threadId: command.targetThreadId,
+      providerInstanceId: sourceRun.providerInstanceId,
+      occurredAt: now,
+      payload: transfer,
+    });
+  });
+
+  const dispatchSteerIntoRun = (input: {
+    readonly command: Extract<
+      OrchestrationV2Command,
+      { readonly type: "message.dispatch" | "queued-message.promote-to-steer" }
+    >;
+    readonly events: Ref.Ref<Array<OrchestrationV2DomainEvent>>;
+    readonly effects: Ref.Ref<Array<PendingOrchestrationEffectV2>>;
+    readonly projection: OrchestrationV2ThreadProjection;
+    readonly modelSelection: ModelSelection;
+    readonly targetRunId: OrchestrationV2Run["id"];
+    readonly messageId: OrchestrationV2ConversationMessage["id"];
+    readonly text: string;
+    readonly attachments: ReadonlyArray<ChatAttachment>;
+    readonly createdBy: OrchestrationV2ConversationMessage["createdBy"];
+    readonly creationSource: OrchestrationV2ConversationMessage["creationSource"];
+    readonly forceRestart: boolean;
+  }) =>
+    Effect.gen(function* () {
+      const targetRun = input.projection.runs.find(
+        (candidate) => candidate.id === input.targetRunId,
+      );
+      if (targetRun === undefined) {
+        return yield* new OrchestratorDispatchError({
+          commandId: input.command.commandId,
+          commandType: input.command.type,
+          cause: `Target run ${input.targetRunId} was not found.`,
+        });
+      }
+      const rootNodeId = targetRun.rootNodeId;
+      if (rootNodeId === null) {
+        return yield* new OrchestratorDispatchError({
+          commandId: input.command.commandId,
+          commandType: input.command.type,
+          cause: `Target run ${targetRun.id} has no root node.`,
+        });
+      }
+      if (targetRun.status !== "running") {
+        return yield* new OrchestratorDispatchError({
+          commandId: input.command.commandId,
+          commandType: input.command.type,
+          cause: `Target run ${targetRun.id} is ${targetRun.status} and cannot be steered.`,
+        });
+      }
+      const providerThread = input.projection.providerThreads.find(
+        (candidate) => candidate.id === targetRun.providerThreadId,
+      );
+      if (providerThread === undefined || providerThread.providerSessionId === null) {
+        return yield* new OrchestratorDispatchError({
+          commandId: input.command.commandId,
+          commandType: input.command.type,
+          cause: `Provider thread ${targetRun.providerThreadId} has no active provider session for steering.`,
+        });
+      }
+      const providerSessionId = providerThread.providerSessionId;
+      const providerTurn = input.projection.providerTurns.find(
+        (candidate) =>
+          candidate.runAttemptId === targetRun.activeAttemptId && candidate.status === "running",
+      );
+      if (providerTurn === undefined) {
+        return yield* new OrchestratorDispatchError({
+          commandId: input.command.commandId,
+          commandType: input.command.type,
+          cause: `No running provider turn found for active run ${targetRun.id}.`,
+        });
+      }
+      const sessionOption = yield* providerSessions.get(providerSessionId).pipe(
+        Effect.mapError(
+          (cause) =>
+            new OrchestratorDispatchError({
+              commandId: input.command.commandId,
+              commandType: input.command.type,
+              cause,
+            }),
+        ),
+      );
+      if (Option.isNone(sessionOption)) {
+        return yield* new OrchestratorDispatchError({
+          commandId: input.command.commandId,
+          commandType: input.command.type,
+          cause: `Provider session ${providerThread.providerSessionId} is not active.`,
+        });
+      }
+
+      const session = sessionOption.value;
+      const now = yield* DateTime.now;
+      const emitEvent = emit(input.events, input.command);
+      const selectionChanged = !modelSelectionsEqual(
+        targetRun.modelSelection,
+        input.modelSelection,
+      );
+      const providerInstanceChanged =
+        targetRun.providerInstanceId !== input.modelSelection.instanceId;
+      const selectionTransition =
+        selectionChanged && !providerInstanceChanged
+          ? yield* providerAdapters.get(targetRun.providerInstanceId).pipe(
+              Effect.flatMap((adapter) =>
+                adapter.planSelectionTransition({
+                  current: targetRun.modelSelection,
+                  target: input.modelSelection,
+                  sessionCapabilities: session.providerSession.capabilities,
+                }),
+              ),
+              Effect.mapError(
+                (cause) =>
+                  new OrchestratorProviderAdapterError({
+                    commandId: input.command.commandId,
+                    providerInstanceId: targetRun.providerInstanceId,
+                    cause,
+                  }),
+              ),
+            )
+          : null;
+      if (selectionTransition?.type === "reject") {
+        return yield* new OrchestratorDispatchError({
+          commandId: input.command.commandId,
+          commandType: input.command.type,
+          cause: selectionTransition.reason,
+        });
+      }
+      const appendSteeringMessage = (messageInput: {
+        readonly runId: OrchestrationV2Run["id"];
+        readonly nodeId: OrchestrationV2ExecutionNode["id"];
+        readonly providerTurnId: typeof providerTurn.id | null;
+        readonly providerThreadId: OrchestrationV2ProviderThread["id"];
+        readonly providerInstanceId: ProviderInstanceId;
+      }) =>
+        Effect.gen(function* () {
+          const message: OrchestrationV2ConversationMessage = {
+            createdBy: input.createdBy,
+            creationSource: input.creationSource,
+            id: input.messageId,
+            threadId: input.command.threadId,
+            runId: messageInput.runId,
+            nodeId: messageInput.nodeId,
+            role: "user",
+            text: input.text,
+            attachments: input.attachments,
+            streaming: false,
+            createdAt: now,
+            updatedAt: now,
+          };
+          const turnItem: OrchestrationV2TurnItem = {
+            createdBy: input.createdBy,
+            creationSource: input.creationSource,
+            id: idAllocator.derive.userTurnItem({ messageId: input.messageId }),
+            threadId: input.command.threadId,
+            runId: messageInput.runId,
+            nodeId: messageInput.nodeId,
+            providerThreadId: messageInput.providerThreadId,
+            providerTurnId: messageInput.providerTurnId,
+            nativeItemRef: null,
+            parentItemId: null,
+            ordinal: nextTurnItemOrdinal(input.projection),
+            status: "completed",
+            title: null,
+            startedAt: now,
+            completedAt: now,
+            updatedAt: now,
+            type: "user_message",
+            messageId: input.messageId,
+            inputIntent:
+              input.command.type === "queued-message.promote-to-steer"
+                ? "promoted_queued_to_steer"
+                : "steer",
+            text: input.text,
+            attachments: input.attachments,
+          };
+          yield* emitEvent({
+            type: "message.updated",
+            threadId: input.command.threadId,
+            runId: messageInput.runId,
+            nodeId: messageInput.nodeId,
+            providerInstanceId: messageInput.providerInstanceId,
+            occurredAt: now,
+            payload: message,
+          });
+          yield* emitEvent({
+            type: "turn-item.updated",
+            threadId: input.command.threadId,
+            runId: messageInput.runId,
+            nodeId: messageInput.nodeId,
+            providerInstanceId: messageInput.providerInstanceId,
+            occurredAt: now,
+            payload: turnItem,
+          });
+        });
+
+      const steeringPolicy = yield* enforceCommandPolicy(input.command)(
+        commandPolicy.decideSteeringExecution({
+          commandId: input.command.commandId,
+          threadId: input.command.threadId,
+          providerInstanceId: targetRun.providerInstanceId,
+          capabilities: session.providerSession.capabilities,
+          forceRestart: input.forceRestart || selectionChanged,
+        }),
+      );
+
+      if (steeringPolicy === "active_steering") {
+        yield* appendSteeringMessage({
+          runId: targetRun.id,
+          nodeId: rootNodeId,
+          providerTurnId: providerTurn.id,
+          providerThreadId: providerThread.id,
+          providerInstanceId: targetRun.providerInstanceId,
+        });
+        yield* Ref.update(input.effects, (existing) => [
+          ...existing,
+          {
+            id: `effect:${input.command.commandId}:provider-turn.steer:${providerTurn.id}`,
+            commandId: input.command.commandId,
+            threadId: input.command.threadId,
+            request: {
+              type: "provider-turn.steer",
+              providerSessionId,
+              providerThreadId: providerThread.id,
+              providerTurnId: providerTurn.id,
+              messageId: input.messageId,
+            },
+          } satisfies PendingOrchestrationEffectV2,
+        ]);
+        return;
+      }
+
+      const currentAttempt = input.projection.attempts.find(
+        (candidate) => candidate.id === targetRun.activeAttemptId,
+      );
+      const currentRootNode = input.projection.nodes.find(
+        (candidate) => candidate.id === rootNodeId,
+      );
+      const attemptOrdinal =
+        Math.max(
+          0,
+          ...input.projection.attempts
+            .filter((candidate) => candidate.runId === targetRun.id)
+            .map((candidate) => candidate.attemptOrdinal),
+        ) + 1;
+      const nextAttemptId = idAllocator.derive.runAttempt({
+        runId: targetRun.id,
+        attemptOrdinal,
+      });
+      const nextRootNodeId = idAllocator.derive.rootNodeAttempt({
+        runId: targetRun.id,
+        attemptOrdinal,
+      });
+      let restartProviderThread = providerThread;
+      let restartSessionTransition:
+        | {
+            readonly type: "replace";
+            readonly replacementProviderSessionId: ProviderSessionId;
+          }
+        | { readonly type: "detach" }
+        | null = null;
+      let restartHandoff: OrchestrationV2ContextHandoff | null = null;
+      let restartTransfer: OrchestrationV2ContextTransfer | null = null;
+      const requiresProviderThreadHandoff =
+        providerInstanceChanged || selectionTransition?.type === "create_with_handoff";
+      const requiresProviderSessionRestart = selectionTransition?.type === "restart_session";
+      if (requiresProviderThreadHandoff) {
+        const targetAdapter = yield* providerAdapters.get(input.modelSelection.instanceId).pipe(
+          Effect.mapError(
+            (cause) =>
+              new OrchestratorProviderAdapterError({
+                commandId: input.command.commandId,
+                providerInstanceId: input.modelSelection.instanceId,
+                cause,
+              }),
+          ),
+        );
+        const targetCapabilities = yield* targetAdapter.getCapabilities().pipe(
+          Effect.mapError(
+            (cause) =>
+              new OrchestratorProviderAdapterError({
+                commandId: input.command.commandId,
+                providerInstanceId: input.modelSelection.instanceId,
+                cause,
+              }),
+          ),
+        );
+        yield* enforceCommandPolicy(input.command)(
+          commandPolicy.ensureContextHandoff({
+            commandId: input.command.commandId,
+            threadId: input.command.threadId,
+            providerInstanceId: input.modelSelection.instanceId,
+            capabilities: targetCapabilities,
+            strategy: "full_thread_summary",
+          }),
+        );
+        const existingTargetProviderThread = rootProviderThreadsForProvider(
+          input.projection,
+          input.modelSelection.instanceId,
+        ).find((candidate) => candidate.id !== providerThread.id);
+        const targetProviderSessionId =
+          existingTargetProviderThread?.providerSessionId ??
+          (yield* mapDispatchError(input.command)(
+            providerSessionIdFor({
+              adapter: targetAdapter,
+              providerInstanceId: input.modelSelection.instanceId,
+              threadId: input.command.threadId,
+            }),
+          ));
+        const targetProviderThreadBase: OrchestrationV2ProviderThread =
+          existingTargetProviderThread === undefined
+            ? {
+                id: idAllocator.derive.providerThread({
+                  driver: targetAdapter.driver,
+                  nativeThreadId: `pending:${targetRun.id}:attempt:${attemptOrdinal}`,
+                }),
+                driver: targetAdapter.driver,
+                providerInstanceId: input.modelSelection.instanceId,
+                providerSessionId: targetProviderSessionId,
+                appThreadId: input.command.threadId,
+                ownerNodeId: null,
+                nativeThreadRef: null,
+                nativeConversationHeadRef: null,
+                status: "not_loaded",
+                firstRunOrdinal: targetRun.ordinal,
+                lastRunOrdinal: targetRun.ordinal,
+                handoffIds: [],
+                forkedFrom: null,
+                createdAt: now,
+                updatedAt: now,
+              }
+            : {
+                ...existingTargetProviderThread,
+                providerSessionId: targetProviderSessionId,
+                lastRunOrdinal: targetRun.ordinal,
+                updatedAt: now,
+              };
+        const transferId = yield* mapDispatchError(input.command)(
+          idAllocator.allocate.contextTransfer({
+            sourceThreadId: input.command.threadId,
+            targetThreadId: input.command.threadId,
+            type: "provider_handoff",
+          }),
+        );
+        restartHandoff = yield* contextHandoffService
+          .prepareProviderHandoff({
+            threadId: input.command.threadId,
+            targetRunId: targetRun.id,
+            transferId,
+            fromProviderThreadIds: [providerThread.id],
+            toProviderThreadId: targetProviderThreadBase.id,
+            fromProviderInstanceId: targetRun.providerInstanceId,
+            toProviderInstanceId: input.modelSelection.instanceId,
+            coveredRunOrdinals: { from: 1, to: targetRun.ordinal },
+            strategy: "full_thread_summary",
+            items: input.projection.turnItems,
+            createdAt: now,
+          })
+          .pipe(mapDispatchError(input.command));
+        restartProviderThread = {
+          ...targetProviderThreadBase,
+          handoffIds: Array.from(
+            new Set([...targetProviderThreadBase.handoffIds, restartHandoff.id]),
+          ),
+        };
+        restartTransfer = {
+          id: transferId,
+          type: "provider_handoff",
+          sourceThreadId: input.command.threadId,
+          targetThreadId: input.command.threadId,
+          sourcePoint: contextSourcePointForRun(input.projection, targetRun),
+          basePoint: null,
+          sourceProviderInstanceId: targetRun.providerInstanceId,
+          targetProviderInstanceId: input.modelSelection.instanceId,
+          targetRunId: targetRun.id,
+          status: "consumed",
+          resolution: {
+            strategy: "portable_context",
+            contextHandoffId: restartHandoff.id,
+          },
+          createdBy: input.createdBy,
+          error: null,
+          createdAt: now,
+          updatedAt: now,
+          consumedAt: now,
+        };
+        restartSessionTransition = { type: "detach" };
+      } else if (requiresProviderSessionRestart) {
+        const nextProviderSessionId = yield* mapDispatchError(input.command)(
+          idAllocator.allocate.providerSession({
+            providerInstanceId: input.modelSelection.instanceId,
+            threadId: input.command.threadId,
+          }),
+        );
+        restartProviderThread = {
+          ...providerThread,
+          providerSessionId: nextProviderSessionId,
+          status: "not_loaded",
+          updatedAt: now,
+        };
+        restartSessionTransition = {
+          type: "replace",
+          replacementProviderSessionId: nextProviderSessionId,
+        };
+      }
+      const resolvedRuntimePolicy = yield* runtimePolicy
+        .resolve({ thread: input.projection.thread, modelSelection: input.modelSelection })
+        .pipe(
+          Effect.mapError(
+            (cause) =>
+              new OrchestratorDispatchError({
+                commandId: input.command.commandId,
+                commandType: input.command.type,
+                cause,
+              }),
+          ),
+        );
+      const checkpointScope = yield* checkpointService
+        .prepareRootRunScope({
+          threadId: input.command.threadId,
+          runId: targetRun.id,
+          rootNodeId: nextRootNodeId,
+          providerThreadId: restartProviderThread.id,
+          cwd:
+            resolvedRuntimePolicy.cwd ??
+            input.projection.thread.worktreePath ??
+            session.providerSession.cwd,
+          createdAt: now,
+        })
+        .pipe(
+          Effect.mapError(
+            (cause) =>
+              new OrchestratorDispatchError({
+                commandId: input.command.commandId,
+                commandType: input.command.type,
+                cause,
+              }),
+          ),
+        );
+      const ensuredCheckpointScope = yield* checkpointService.ensureScope(checkpointScope).pipe(
+        Effect.mapError(
+          (cause) =>
+            new OrchestratorDispatchError({
+              commandId: input.command.commandId,
+              commandType: input.command.type,
+              cause,
+            }),
+        ),
+      );
+      const restartedRun: OrchestrationV2Run = {
+        ...targetRun,
+        providerInstanceId: input.modelSelection.instanceId,
+        modelSelection: input.modelSelection,
+        providerThreadId: restartProviderThread.id,
+        rootNodeId: nextRootNodeId,
+        activeAttemptId: nextAttemptId,
+        userMessageId: input.messageId,
+        status: "starting",
+        contextHandoffId: restartHandoff?.id ?? targetRun.contextHandoffId,
+      };
+      const nextAttempt: OrchestrationV2RunAttempt = {
+        id: nextAttemptId,
+        runId: targetRun.id,
+        attemptOrdinal,
+        rootNodeId: nextRootNodeId,
+        providerInstanceId: input.modelSelection.instanceId,
+        providerThreadId: restartProviderThread.id,
+        providerTurnId: null,
+        reason: "steering_restart",
+        status: "pending",
+        startedAt: null,
+        completedAt: null,
+      };
+      const nextRootNode: OrchestrationV2ExecutionNode = {
+        id: nextRootNodeId,
+        threadId: input.command.threadId,
+        runId: targetRun.id,
+        parentNodeId: null,
+        rootNodeId: nextRootNodeId,
+        kind: "root_turn",
+        status: "pending",
+        countsForRun: true,
+        providerThreadId: restartProviderThread.id,
+        providerTurnId: null,
+        nativeItemRef: null,
+        runtimeRequestId: null,
+        checkpointScopeId: ensuredCheckpointScope.id,
+        startedAt: null,
+        completedAt: null,
+      };
+      if (currentAttempt !== undefined) {
+        yield* emitEvent({
+          type: "run-attempt.updated",
+          threadId: input.command.threadId,
+          runId: targetRun.id,
+          nodeId: rootNodeId,
+          providerInstanceId: targetRun.providerInstanceId,
+          occurredAt: now,
+          payload: { ...currentAttempt, status: "superseded", completedAt: now },
+        });
+      }
+      if (currentRootNode !== undefined) {
+        yield* emitEvent({
+          type: "node.updated",
+          threadId: input.command.threadId,
+          runId: targetRun.id,
+          nodeId: rootNodeId,
+          providerInstanceId: targetRun.providerInstanceId,
+          occurredAt: now,
+          payload: { ...currentRootNode, status: "interrupted", completedAt: now },
+        });
+      }
+      if (requiresProviderThreadHandoff || requiresProviderSessionRestart) {
+        yield* emitEvent({
+          type: "provider-thread.updated",
+          threadId: input.command.threadId,
+          driver: restartProviderThread.driver,
+          providerInstanceId: input.modelSelection.instanceId,
+          occurredAt: now,
+          payload: restartProviderThread,
+        });
+      }
+      if (restartHandoff !== null) {
+        yield* emitEvent({
+          type: "context-handoff.updated",
+          threadId: input.command.threadId,
+          runId: targetRun.id,
+          providerInstanceId: input.modelSelection.instanceId,
+          occurredAt: now,
+          payload: restartHandoff,
+        });
+      }
+      if (restartTransfer !== null) {
+        yield* emitEvent({
+          type: "context-transfer.created",
+          threadId: input.command.threadId,
+          runId: targetRun.id,
+          providerInstanceId: input.modelSelection.instanceId,
+          occurredAt: now,
+          payload: restartTransfer,
+        });
+      }
+      yield* emitEvent({
+        type: "run.updated",
+        threadId: input.command.threadId,
+        runId: targetRun.id,
+        nodeId: nextRootNodeId,
+        providerInstanceId: input.modelSelection.instanceId,
+        occurredAt: now,
+        payload: restartedRun,
+      });
+      yield* emitEvent({
+        type: "run-attempt.created",
+        threadId: input.command.threadId,
+        runId: targetRun.id,
+        nodeId: nextRootNodeId,
+        providerInstanceId: input.modelSelection.instanceId,
+        occurredAt: now,
+        payload: nextAttempt,
+      });
+      yield* emitEvent({
+        type: "node.updated",
+        threadId: input.command.threadId,
+        runId: targetRun.id,
+        nodeId: nextRootNodeId,
+        providerInstanceId: input.modelSelection.instanceId,
+        occurredAt: now,
+        payload: nextRootNode,
+      });
+      yield* emitEvent({
+        type: "checkpoint-scope.created",
+        threadId: input.command.threadId,
+        runId: targetRun.id,
+        nodeId: nextRootNodeId,
+        providerInstanceId: input.modelSelection.instanceId,
+        occurredAt: now,
+        payload: ensuredCheckpointScope,
+      });
+      yield* appendSteeringMessage({
+        runId: targetRun.id,
+        nodeId: nextRootNodeId,
+        providerTurnId: null,
+        providerThreadId: restartProviderThread.id,
+        providerInstanceId: input.modelSelection.instanceId,
+      });
+      const interruptedAttemptId = targetRun.activeAttemptId;
+      if (interruptedAttemptId === null) {
+        return yield* new OrchestratorDispatchError({
+          commandId: input.command.commandId,
+          commandType: input.command.type,
+          cause: `Active run ${targetRun.id} has no attempt to interrupt.`,
+        });
+      }
+      yield* Ref.update(input.effects, (existing) => [
+        ...existing,
+        {
+          id: `effect:${input.command.commandId}:provider-turn.restart:${providerTurn.id}`,
+          commandId: input.command.commandId,
+          threadId: input.command.threadId,
+          request: {
+            type: "provider-turn.restart",
+            providerSessionId,
+            providerThreadId: providerThread.id,
+            providerTurnId: providerTurn.id,
+            interruptedAttemptId,
+            runId: targetRun.id,
+            ...(restartSessionTransition === null
+              ? {}
+              : { sessionTransition: restartSessionTransition }),
+          },
+        } satisfies PendingOrchestrationEffectV2,
+      ]);
+    });
+
+  const dispatchMessage = (
+    command: Extract<OrchestrationV2Command, { readonly type: "message.dispatch" }>,
+    events: Ref.Ref<Array<OrchestrationV2DomainEvent>>,
+    effects: Ref.Ref<Array<PendingOrchestrationEffectV2>>,
+  ) =>
+    Effect.gen(function* () {
+      let projection = yield* getProjectionWithPendingEvents(command.threadId, events);
+      if (projection.thread.settledOverride !== null) {
+        const now = yield* DateTime.now;
+        const thread: OrchestrationV2AppThread = {
+          ...projection.thread,
+          settledOverride: null,
+          settledAt: null,
+          unsettledAt:
+            projection.thread.settledOverride === "active"
+              ? (projection.thread.unsettledAt ?? null)
+              : now,
+          updatedAt: now,
+        };
+        yield* emit(
+          events,
+          command,
+        )({
+          type: "thread.unsettled",
+          threadId: command.threadId,
+          providerInstanceId: thread.providerInstanceId,
+          occurredAt: now,
+          payload: thread,
+        });
+        projection = yield* getProjectionWithPendingEvents(command.threadId, events);
+      }
+      if (projection.thread.snoozedUntil != null) {
+        const now = yield* DateTime.now;
+        const thread: OrchestrationV2AppThread = {
+          ...projection.thread,
+          snoozedUntil: null,
+          snoozedAt: null,
+          updatedAt: now,
+        };
+        yield* emit(
+          events,
+          command,
+        )({
+          type: "thread.unsnoozed",
+          threadId: command.threadId,
+          providerInstanceId: thread.providerInstanceId,
+          occurredAt: now,
+          payload: thread,
+        });
+        projection = yield* getProjectionWithPendingEvents(command.threadId, events);
+      }
+      if (command.titleSeed !== undefined && projection.messages.length === 0) {
+        const now = yield* DateTime.now;
+        const thread: OrchestrationV2AppThread = {
+          ...projection.thread,
+          title: command.titleSeed,
+          titleRegeneration: { requestId: command.commandId, startedAt: now },
+          updatedAt: now,
+        };
+        yield* emit(
+          events,
+          command,
+        )({
+          type: "thread.metadata-updated",
+          threadId: command.threadId,
+          providerInstanceId: thread.providerInstanceId,
+          occurredAt: now,
+          payload: thread,
+        });
+        yield* Ref.update(effects, (existing) => [
+          ...existing,
+          pendingThreadTitleGenerationEffect(command.commandId, command.threadId, {
+            type: "initial",
+            messageId: command.messageId,
+          }),
+        ]);
+        projection = yield* getProjectionWithPendingEvents(command.threadId, events);
+      }
+      const modelSelection = command.modelSelection ?? projection.thread.modelSelection;
+      const dispatchMode = command.dispatchMode;
+      let delegatedCompletion:
+        | OrchestrationV2ConversationMessage["delegatedCompletion"]
+        | undefined;
+      if (command.delegatedCompletion !== undefined) {
+        const requestedCompletion = command.delegatedCompletion;
+        if (
+          command.createdBy !== "agent" ||
+          command.creationSource !== "server" ||
+          dispatchMode.type !== "queue_after_active"
+        ) {
+          return yield* new OrchestratorDispatchError({
+            commandId: command.commandId,
+            commandType: command.type,
+            cause: "Delegated completion delivery must be a server-created queued message.",
+          });
+        }
+        const parentRun = projection.runs.find(
+          (candidate) => candidate.id === requestedCompletion.parentRunId,
+        );
+        const delivery = parentRun?.delegatedCompletion?.delivery;
+        if (
+          parentRun?.delegatedCompletion?.disposition !== "open" ||
+          delivery === null ||
+          delivery === undefined ||
+          delivery.generation !== requestedCompletion.generation ||
+          delivery.messageId !== command.messageId ||
+          projection.messages.some((candidate) => candidate.id === command.messageId)
+        ) {
+          return yield* new OrchestratorDispatchError({
+            commandId: command.commandId,
+            commandType: command.type,
+            cause: "Delegated completion delivery is no longer dispatchable.",
+          });
+        }
+        delegatedCompletion = {
+          parentRunId: requestedCompletion.parentRunId,
+          generation: delivery.generation,
+          taskIds: delivery.taskIds,
+        };
+      }
+      const dispatchText =
+        delegatedCompletion === undefined
+          ? command.text
+          : delegatedCompletionWakeDetail(delegatedCompletion.taskIds);
+      const sourcePlanProjection =
+        command.sourcePlanRef === undefined
+          ? null
+          : yield* getProjectionWithPendingEvents(command.sourcePlanRef.threadId, events);
+      const sourcePlan =
+        command.sourcePlanRef === undefined
+          ? null
+          : (sourcePlanProjection?.plans.find(
+              (plan) => plan.id === command.sourcePlanRef?.planId && plan.kind === "proposed_plan",
+            ) ?? null);
+      if (command.sourcePlanRef !== undefined && sourcePlan === null) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Proposed plan ${command.sourcePlanRef.planId} does not exist on thread ${command.sourcePlanRef.threadId}.`,
+        });
+      }
+      if (
+        sourcePlanProjection !== null &&
+        sourcePlanProjection.thread.projectId !== projection.thread.projectId
+      ) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Proposed plan ${command.sourcePlanRef?.planId} belongs to a different project.`,
+        });
+      }
+      if (sourcePlan !== null && sourcePlan.status !== "active") {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Proposed plan ${sourcePlan.id} is not active.`,
+        });
+      }
+      const completeSourcePlan = (occurredAt: DateTime.Utc) =>
+        sourcePlan === null
+          ? Effect.void
+          : emit(
+              events,
+              command,
+            )({
+              type: "plan.updated",
+              threadId: sourcePlan.threadId,
+              ...(sourcePlan.runId === null ? {} : { runId: sourcePlan.runId }),
+              nodeId: sourcePlan.nodeId,
+              occurredAt,
+              payload: { ...sourcePlan, status: "completed" },
+            });
+
+      if (dispatchMode.type === "steer_active" || dispatchMode.type === "restart_active") {
+        yield* dispatchSteerIntoRun({
+          command,
+          events,
+          effects,
+          projection,
+          modelSelection,
+          targetRunId: dispatchMode.targetRunId,
+          messageId: command.messageId,
+          text: dispatchText,
+          attachments: command.attachments,
+          createdBy: command.createdBy,
+          creationSource: command.creationSource,
+          forceRestart: dispatchMode.type === "restart_active",
+        });
+        return;
+      }
+
+      const activeProviderThread = projection.providerThreads.find(
+        (candidate) => candidate.id === projection.thread.activeProviderThreadId,
+      );
+      const activeRun = projection.runs.find(isBlockingRun);
+      const pendingMergeBackTransfers = pendingMergeBackTransfersForThread(projection);
+      const shouldQueue =
+        activeRun !== undefined &&
+        (dispatchMode.type === "defer_start" ||
+          dispatchMode.type === "start_immediately" ||
+          dispatchMode.type === "queue_after_active");
+      if (shouldQueue) {
+        if (pendingMergeBackTransfers.length > 0) {
+          return yield* new OrchestratorDispatchError({
+            commandId: command.commandId,
+            commandType: command.type,
+            cause: `Thread ${command.threadId} has a pending merge-back transfer; queued merge-back consumption is not implemented yet.`,
+          });
+        }
+        const queueProviderThread =
+          activeProviderThread ??
+          projection.providerThreads.find(
+            (candidate) => candidate.id === activeRun.providerThreadId,
+          );
+        if (queueProviderThread === undefined) {
+          return yield* new OrchestratorDispatchError({
+            commandId: command.commandId,
+            commandType: command.type,
+            cause: `Active run ${activeRun.id} has no provider thread for queued dispatch.`,
+          });
+        }
+        if (modelSelection.instanceId !== queueProviderThread.providerInstanceId) {
+          return yield* new OrchestratorDispatchError({
+            commandId: command.commandId,
+            commandType: command.type,
+            cause: `Queued dispatch for provider instance ${modelSelection.instanceId} cannot run behind active provider instance ${queueProviderThread.providerInstanceId}.`,
+          });
+        }
+        const existingProviderSession =
+          queueProviderThread.providerSessionId === null
+            ? undefined
+            : projection.providerSessions.find(
+                (candidate) => candidate.id === queueProviderThread.providerSessionId,
+              );
+        if (existingProviderSession !== undefined) {
+          yield* enforceCommandPolicy(command)(
+            commandPolicy.ensureQueuedMessages({
+              commandId: command.commandId,
+              threadId: command.threadId,
+              providerInstanceId: modelSelection.instanceId,
+              capabilities: existingProviderSession.capabilities,
+            }),
+          );
+        }
+
+        const now = yield* DateTime.now;
+        const ordinal = nextRunOrdinal(projection);
+        const runId = idAllocator.derive.run({ threadId: command.threadId, ordinal });
+        const attemptId = idAllocator.derive.runAttempt({ runId, attemptOrdinal: 1 });
+        const rootNodeId = idAllocator.derive.rootNode({ runId });
+        const checkpointScope =
+          activeRun.status === "preparing"
+            ? null
+            : yield* runtimePolicy.resolve({ thread: projection.thread, modelSelection }).pipe(
+                Effect.flatMap((resolvedRuntimePolicy) =>
+                  checkpointService.prepareRootRunScope({
+                    threadId: command.threadId,
+                    runId,
+                    rootNodeId,
+                    providerThreadId: queueProviderThread.id,
+                    cwd:
+                      resolvedRuntimePolicy.cwd ??
+                      existingProviderSession?.cwd ??
+                      projection.thread.worktreePath ??
+                      process.cwd(),
+                    createdAt: now,
+                  }),
+                ),
+                Effect.mapError(
+                  (cause) =>
+                    new OrchestratorDispatchError({
+                      commandId: command.commandId,
+                      commandType: command.type,
+                      cause,
+                    }),
+                ),
+              );
+        const run: OrchestrationV2Run = {
+          id: runId,
+          threadId: command.threadId,
+          ordinal,
+          providerInstanceId: modelSelection.instanceId,
+          modelSelection,
+          providerThreadId: queueProviderThread.id,
+          userMessageId: command.messageId,
+          rootNodeId,
+          activeAttemptId: attemptId,
+          status: "queued",
+          queuePosition:
+            Math.max(
+              0,
+              ...projection.runs
+                .filter((candidate) => candidate.status === "queued")
+                .map((candidate) => candidate.queuePosition ?? candidate.ordinal),
+            ) + 1,
+          requestedAt: now,
+          startedAt: null,
+          completedAt: null,
+          checkpointId: null,
+          contextHandoffId: null,
+          ...(command.sourcePlanRef === undefined ? {} : { sourcePlanRef: command.sourcePlanRef }),
+        };
+        const attempt: OrchestrationV2RunAttempt = {
+          id: attemptId,
+          runId,
+          attemptOrdinal: 1,
+          rootNodeId,
+          providerInstanceId: modelSelection.instanceId,
+          providerThreadId: queueProviderThread.id,
+          providerTurnId: null,
+          reason: "initial",
+          status: "pending",
+          startedAt: null,
+          completedAt: null,
+        };
+        const rootNode: OrchestrationV2ExecutionNode = {
+          id: rootNodeId,
+          threadId: command.threadId,
+          runId,
+          parentNodeId: null,
+          rootNodeId,
+          kind: "root_turn",
+          status: "pending",
+          countsForRun: true,
+          providerThreadId: queueProviderThread.id,
+          providerTurnId: null,
+          nativeItemRef: null,
+          runtimeRequestId: null,
+          checkpointScopeId: checkpointScope?.id ?? null,
+          startedAt: null,
+          completedAt: null,
+        };
+        const message: OrchestrationV2ConversationMessage = {
+          createdBy: command.createdBy,
+          creationSource: command.creationSource,
+          id: command.messageId,
+          threadId: command.threadId,
+          runId,
+          nodeId: rootNodeId,
+          role: "user",
+          text: dispatchText,
+          attachments: command.attachments,
+          streaming: false,
+          createdAt: now,
+          updatedAt: now,
+          ...(delegatedCompletion === undefined ? {} : { delegatedCompletion }),
+        };
+        const emitEvent = emit(events, command);
+        yield* emitEvent({
+          type: "run.created",
+          threadId: command.threadId,
+          runId,
+          nodeId: rootNodeId,
+          providerInstanceId: modelSelection.instanceId,
+          occurredAt: now,
+          payload: run,
+        });
+        yield* completeSourcePlan(now);
+        yield* emitEvent({
+          type: "run-attempt.created",
+          threadId: command.threadId,
+          runId,
+          nodeId: rootNodeId,
+          providerInstanceId: modelSelection.instanceId,
+          occurredAt: now,
+          payload: attempt,
+        });
+        yield* emitEvent({
+          type: "node.updated",
+          threadId: command.threadId,
+          runId,
+          nodeId: rootNodeId,
+          providerInstanceId: modelSelection.instanceId,
+          occurredAt: now,
+          payload: rootNode,
+        });
+        if (checkpointScope !== null) {
+          yield* emitEvent({
+            type: "checkpoint-scope.created",
+            threadId: command.threadId,
+            runId,
+            nodeId: rootNodeId,
+            providerInstanceId: modelSelection.instanceId,
+            occurredAt: now,
+            payload: yield* checkpointService.ensureScope(checkpointScope).pipe(
+              Effect.mapError(
+                (cause) =>
+                  new OrchestratorDispatchError({
+                    commandId: command.commandId,
+                    commandType: command.type,
+                    cause,
+                  }),
+              ),
+            ),
+          });
+        }
+        yield* emitEvent({
+          type: "message.updated",
+          threadId: command.threadId,
+          runId,
+          nodeId: rootNodeId,
+          providerInstanceId: modelSelection.instanceId,
+          occurredAt: now,
+          payload: message,
+        });
+        return;
+      }
+      const pendingForkTransfer = pendingForkTransferForThread(projection);
+      const pendingMergeBackSourceThreadIds = new Set(
+        pendingMergeBackTransfers.map((transfer) => transfer.sourceThreadId),
+      );
+      if (pendingMergeBackSourceThreadIds.size > 1) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Thread ${command.threadId} has pending merge-back transfers from multiple forks.`,
+        });
+      }
+      const pendingMergeBackTransfer = latestContextTransfer(pendingMergeBackTransfers);
+      const supersededMergeBackTransfers = pendingMergeBackTransfers.filter(
+        (transfer) => transfer.id !== pendingMergeBackTransfer?.id,
+      );
+      const now = yield* DateTime.now;
+      const ordinal = nextRunOrdinal(projection);
+      const runId = idAllocator.derive.run({ threadId: command.threadId, ordinal });
+      const latestCompletedRun = projection.runs.findLast((run) => run.status === "completed");
+      const legacyImportItems =
+        projection.thread.historyOrigin === "v1_import"
+          ? projection.turnItems.filter((item) => item.runId === null)
+          : [];
+      const isProviderSwitch =
+        activeProviderThread !== undefined &&
+        activeProviderThread.providerInstanceId !== modelSelection.instanceId;
+
+      if (
+        pendingForkTransfer === undefined &&
+        pendingMergeBackTransfer === undefined &&
+        !isProviderSwitch
+      ) {
+        const adapter = yield* providerAdapters.get(modelSelection.instanceId).pipe(
+          Effect.mapError(
+            (cause) =>
+              new OrchestratorProviderAdapterError({
+                commandId: command.commandId,
+                providerInstanceId: modelSelection.instanceId,
+                cause,
+              }),
+          ),
+        );
+        const providerSessionId =
+          activeProviderThread?.providerSessionId ??
+          (yield* mapDispatchError(command)(
+            providerSessionIdFor({
+              adapter,
+              providerInstanceId: modelSelection.instanceId,
+              threadId: command.threadId,
+            }),
+          ));
+        const providerThreadId =
+          activeProviderThread?.id ??
+          idAllocator.derive.providerThread({
+            driver: adapter.driver,
+            nativeThreadId: `pending:${runId}`,
+          });
+        const legacyImportHandoff = shouldPrepareLegacyImportHandoff({
+          historyOrigin: projection.thread.historyOrigin,
+          hasCompletedRun: latestCompletedRun !== undefined,
+          legacyImportItemCount: legacyImportItems.length,
+        })
+          ? yield* contextHandoffService
+              .prepareLegacyImport({
+                threadId: command.threadId,
+                targetRunId: runId,
+                toProviderThreadId: providerThreadId,
+                toProviderInstanceId: modelSelection.instanceId,
+                items: legacyImportItems,
+                createdAt: now,
+              })
+              .pipe(mapDispatchError(command))
+          : null;
+        const providerThread: OrchestrationV2ProviderThread =
+          activeProviderThread === undefined
+            ? {
+                id: providerThreadId,
+                driver: adapter.driver,
+                providerInstanceId: modelSelection.instanceId,
+                providerSessionId,
+                appThreadId: command.threadId,
+                ownerNodeId: null,
+                nativeThreadRef: null,
+                nativeConversationHeadRef: null,
+                status: "not_loaded",
+                firstRunOrdinal: ordinal,
+                lastRunOrdinal: ordinal,
+                handoffIds: legacyImportHandoff === null ? [] : [legacyImportHandoff.id],
+                forkedFrom: null,
+                createdAt: now,
+                updatedAt: now,
+              }
+            : {
+                ...activeProviderThread,
+                providerSessionId,
+                lastRunOrdinal: ordinal,
+                handoffIds: appendContextHandoffId(
+                  activeProviderThread.handoffIds,
+                  legacyImportHandoff?.id ?? null,
+                ),
+                updatedAt: now,
+              };
+        const attemptId = idAllocator.derive.runAttempt({ runId, attemptOrdinal: 1 });
+        const rootNodeId = idAllocator.derive.rootNode({ runId });
+        const checkpointScope =
+          dispatchMode.type === "defer_start"
+            ? null
+            : yield* runtimePolicy
+                .resolve({
+                  thread: projection.thread,
+                  modelSelection,
+                })
+                .pipe(
+                  mapDispatchError(command),
+                  Effect.flatMap((resolvedRuntimePolicy) =>
+                    checkpointService.prepareRootRunScope({
+                      threadId: command.threadId,
+                      runId,
+                      rootNodeId,
+                      providerThreadId,
+                      cwd:
+                        resolvedRuntimePolicy.cwd ??
+                        projection.thread.worktreePath ??
+                        process.cwd(),
+                      createdAt: now,
+                    }),
+                  ),
+                  mapDispatchError(command),
+                );
+        const run: OrchestrationV2Run = {
+          id: runId,
+          threadId: command.threadId,
+          ordinal,
+          providerInstanceId: modelSelection.instanceId,
+          modelSelection,
+          providerThreadId,
+          userMessageId: command.messageId,
+          rootNodeId,
+          activeAttemptId: attemptId,
+          status: dispatchMode.type === "defer_start" ? "preparing" : "starting",
+          queuePosition: null,
+          requestedAt: now,
+          startedAt: null,
+          completedAt: null,
+          checkpointId: null,
+          contextHandoffId: legacyImportHandoff?.id ?? null,
+          ...(command.sourcePlanRef === undefined ? {} : { sourcePlanRef: command.sourcePlanRef }),
+        };
+        const attempt: OrchestrationV2RunAttempt = {
+          id: attemptId,
+          runId,
+          attemptOrdinal: 1,
+          rootNodeId,
+          providerInstanceId: modelSelection.instanceId,
+          providerThreadId,
+          providerTurnId: null,
+          reason: "initial",
+          status: "pending",
+          startedAt: null,
+          completedAt: null,
+        };
+        const rootNode: OrchestrationV2ExecutionNode = {
+          id: rootNodeId,
+          threadId: command.threadId,
+          runId,
+          parentNodeId: null,
+          rootNodeId,
+          kind: "root_turn",
+          status: "pending",
+          countsForRun: true,
+          providerThreadId,
+          providerTurnId: null,
+          nativeItemRef: null,
+          runtimeRequestId: null,
+          checkpointScopeId: checkpointScope?.id ?? null,
+          startedAt: null,
+          completedAt: null,
+        };
+        const message: OrchestrationV2ConversationMessage = {
+          createdBy: command.createdBy,
+          creationSource: command.creationSource,
+          id: command.messageId,
+          threadId: command.threadId,
+          runId,
+          nodeId: rootNodeId,
+          role: "user",
+          text: dispatchText,
+          attachments: command.attachments,
+          streaming: false,
+          createdAt: now,
+          updatedAt: now,
+          ...(delegatedCompletion === undefined ? {} : { delegatedCompletion }),
+        };
+        const turnItem: OrchestrationV2TurnItem = {
+          createdBy: command.createdBy,
+          creationSource: command.creationSource,
+          id: idAllocator.derive.userTurnItem({ messageId: command.messageId }),
+          threadId: command.threadId,
+          runId,
+          nodeId: rootNodeId,
+          providerThreadId,
+          providerTurnId: null,
+          nativeItemRef: null,
+          parentItemId: null,
+          ordinal: nextTurnItemOrdinal(projection),
+          status: "completed",
+          title: null,
+          startedAt: now,
+          completedAt: now,
+          updatedAt: now,
+          type: "user_message",
+          messageId: command.messageId,
+          inputIntent: "turn_start",
+          text: dispatchText,
+          attachments: command.attachments,
+        };
+        const preparationTurnItem: OrchestrationV2TurnItem | null =
+          dispatchMode.type === "defer_start"
+            ? {
+                id: idAllocator.derive.turnItemFromProviderItem({
+                  driver: adapter.driver,
+                  nativeItemId: `workspace-preparation:${runId}`,
+                }),
+                threadId: command.threadId,
+                runId,
+                nodeId: rootNodeId,
+                providerThreadId,
+                providerTurnId: null,
+                nativeItemRef: null,
+                parentItemId: null,
+                ordinal: turnItem.ordinal + 1,
+                status: "running",
+                title: WORKSPACE_PREPARATION_INPUT,
+                startedAt: now,
+                completedAt: null,
+                updatedAt: now,
+                type: "command_execution",
+                input: WORKSPACE_PREPARATION_INPUT,
+              }
+            : null;
+        const emitEvent = emit(events, command);
+        yield* emitEvent({
+          type: "provider-thread.updated",
+          threadId: command.threadId,
+          driver: adapter.driver,
+          providerInstanceId: modelSelection.instanceId,
+          occurredAt: now,
+          payload: providerThread,
+        });
+        if (legacyImportHandoff !== null) {
+          yield* emitEvent({
+            type: "context-handoff.updated",
+            threadId: command.threadId,
+            runId,
+            providerInstanceId: modelSelection.instanceId,
+            occurredAt: now,
+            payload: legacyImportHandoff,
+          });
+        }
+        yield* emitEvent({
+          type: "run.created",
+          threadId: command.threadId,
+          runId,
+          nodeId: rootNodeId,
+          providerInstanceId: modelSelection.instanceId,
+          occurredAt: now,
+          payload: run,
+        });
+        yield* completeSourcePlan(now);
+        yield* emitEvent({
+          type: "run-attempt.created",
+          threadId: command.threadId,
+          runId,
+          nodeId: rootNodeId,
+          providerInstanceId: modelSelection.instanceId,
+          occurredAt: now,
+          payload: attempt,
+        });
+        yield* emitEvent({
+          type: "node.updated",
+          threadId: command.threadId,
+          runId,
+          nodeId: rootNodeId,
+          providerInstanceId: modelSelection.instanceId,
+          occurredAt: now,
+          payload: rootNode,
+        });
+        if (checkpointScope !== null) {
+          yield* emitEvent({
+            type: "checkpoint-scope.created",
+            threadId: command.threadId,
+            runId,
+            nodeId: rootNodeId,
+            providerInstanceId: modelSelection.instanceId,
+            occurredAt: now,
+            payload: checkpointScope,
+          });
+        }
+        yield* emitEvent({
+          type: "message.updated",
+          threadId: command.threadId,
+          runId,
+          nodeId: rootNodeId,
+          providerInstanceId: modelSelection.instanceId,
+          occurredAt: now,
+          payload: message,
+        });
+        yield* emitEvent({
+          type: "turn-item.updated",
+          threadId: command.threadId,
+          runId,
+          nodeId: rootNodeId,
+          providerInstanceId: modelSelection.instanceId,
+          occurredAt: now,
+          payload: turnItem,
+        });
+        if (preparationTurnItem !== null) {
+          yield* emitEvent({
+            type: "turn-item.updated",
+            threadId: command.threadId,
+            runId,
+            nodeId: rootNodeId,
+            providerInstanceId: modelSelection.instanceId,
+            occurredAt: now,
+            payload: preparationTurnItem,
+          });
+        }
+        const pendingEffect = {
+          id: `effect:${command.commandId}:provider-turn.start:${runId}`,
+          commandId: command.commandId,
+          threadId: command.threadId,
+          request: { type: "provider-turn.start", runId },
+        } satisfies PendingOrchestrationEffectV2;
+        if (dispatchMode.type !== "defer_start") {
+          yield* Ref.update(effects, (existing) => [...existing, pendingEffect]);
+        }
+        return;
+      }
+      const sourceProjection =
+        pendingForkTransfer === undefined
+          ? null
+          : yield* projectionStore.getThreadProjection(pendingForkTransfer.sourceThreadId).pipe(
+              Effect.mapError(
+                (cause) =>
+                  new OrchestratorProjectionError({
+                    threadId: pendingForkTransfer.sourceThreadId,
+                    cause,
+                  }),
+              ),
+            );
+      const sourceRun =
+        pendingForkTransfer?.sourcePoint.runId === undefined || sourceProjection === null
+          ? null
+          : (sourceProjection.runs.find(
+              (candidate) => candidate.id === pendingForkTransfer.sourcePoint.runId,
+            ) ?? null);
+      const sourceProviderThread =
+        sourceProjection === null || sourceRun === null
+          ? undefined
+          : providerThreadForRun(sourceProjection, sourceRun);
+      const sourceProviderTurnId =
+        sourceProjection === null || sourceRun === null || sourceRun.activeAttemptId === null
+          ? undefined
+          : (sourceProjection.providerTurns.find(
+              (candidate) => candidate.runAttemptId === sourceRun.activeAttemptId,
+            )?.id ??
+            sourceProjection.attempts.find(
+              (candidate) => candidate.id === sourceRun.activeAttemptId,
+            )?.providerTurnId ??
+            undefined);
+      if (pendingForkTransfer !== undefined) {
+        if (sourceRun === null || sourceProviderThread === undefined) {
+          return yield* new OrchestratorDispatchError({
+            commandId: command.commandId,
+            commandType: command.type,
+            cause: `Pending fork transfer ${pendingForkTransfer.id} has no resolvable source provider thread.`,
+          });
+        }
+        if (pendingForkTransfer.sourceProviderInstanceId === null) {
+          return yield* new OrchestratorDispatchError({
+            commandId: command.commandId,
+            commandType: command.type,
+            cause: `Pending fork transfer ${pendingForkTransfer.id} has no source provider.`,
+          });
+        }
+      }
+
+      const adapter = yield* providerAdapters.get(modelSelection.instanceId).pipe(
+        Effect.mapError(
+          (cause) =>
+            new OrchestratorProviderAdapterError({
+              commandId: command.commandId,
+              providerInstanceId: modelSelection.instanceId,
+              cause,
+            }),
+        ),
+      );
+      const targetProviderThread = isProviderSwitch
+        ? rootProviderThreadsForProvider(projection, modelSelection.instanceId)[0]
+        : activeProviderThread;
+      const providerSessionId =
+        targetProviderThread?.providerSessionId ??
+        (yield* mapDispatchError(command)(
+          providerSessionIdFor({
+            adapter,
+            providerInstanceId: modelSelection.instanceId,
+            threadId: command.threadId,
+          }),
+        ));
+      const existingProviderSession = projection.providerSessions.find(
+        (candidate) => candidate.id === providerSessionId,
+      );
+      const resolvedRuntimePolicy = yield* runtimePolicy
+        .resolve({ thread: projection.thread, modelSelection })
+        .pipe(
+          Effect.mapError(
+            (cause) =>
+              new OrchestratorDispatchError({
+                commandId: command.commandId,
+                commandType: command.type,
+                cause,
+              }),
+          ),
+        );
+
+      const capabilities = yield* adapter.getCapabilities().pipe(
+        Effect.mapError(
+          (cause) =>
+            new OrchestratorProviderAdapterError({
+              commandId: command.commandId,
+              providerInstanceId: modelSelection.instanceId,
+              cause,
+            }),
+        ),
+      );
+      const forkExecution =
+        pendingForkTransfer === undefined
+          ? null
+          : yield* enforceCommandPolicy(command)(
+              commandPolicy.decideForkExecution({
+                commandId: command.commandId,
+                threadId: command.threadId,
+                providerInstanceId: modelSelection.instanceId,
+                capabilities,
+                sameProvider:
+                  pendingForkTransfer.sourceProviderInstanceId === modelSelection.instanceId,
+                hasStrongNativeSource: sourceProviderThread?.nativeThreadRef?.strength === "strong",
+                fromSpecificTurn: sourceRun !== null,
+              }),
+            );
+      const canResolveForkNatively = forkExecution === "native_fork";
+      const requiresPortableFork = forkExecution === "portable_context";
+
+      if (canResolveForkNatively) {
+        yield* enforceCommandPolicy(command)(
+          commandPolicy.ensureNativeFork({
+            commandId: command.commandId,
+            threadId: command.threadId,
+            providerInstanceId: modelSelection.instanceId,
+            capabilities,
+            fromSpecificTurn: sourceRun !== null,
+          }),
+        );
+      }
+
+      const ensuredProviderThread: OrchestrationV2ProviderThread =
+        targetProviderThread === undefined
+          ? {
+              id: idAllocator.derive.providerThread({
+                driver: adapter.driver,
+                nativeThreadId: `pending:${runId}`,
+              }),
+              driver: adapter.driver,
+              providerInstanceId: modelSelection.instanceId,
+              providerSessionId,
+              appThreadId: command.threadId,
+              ownerNodeId: null,
+              nativeThreadRef: null,
+              nativeConversationHeadRef: null,
+              status: "not_loaded",
+              firstRunOrdinal: ordinal,
+              lastRunOrdinal: ordinal,
+              handoffIds: [],
+              forkedFrom:
+                canResolveForkNatively && sourceProviderThread !== undefined
+                  ? {
+                      providerThreadId: sourceProviderThread.id,
+                      ...(sourceProviderTurnId === undefined
+                        ? {}
+                        : { providerTurnId: sourceProviderTurnId }),
+                    }
+                  : null,
+              createdAt: now,
+              updatedAt: now,
+            }
+          : {
+              ...targetProviderThread,
+              providerSessionId,
+              updatedAt: now,
+            };
+      const sourceRunOrdinalById = new Map(
+        (sourceProjection?.runs ?? []).map((run) => [run.id, run.ordinal]),
+      );
+      const portableForkItems =
+        !requiresPortableFork || sourceProjection === null || sourceRun === null
+          ? []
+          : sourceProjection.turnItems.filter((item) =>
+              isTurnItemAtOrBeforeRun({
+                historyOrigin: sourceProjection.thread.historyOrigin,
+                itemRunId: item.runId,
+                runOrdinalById: sourceRunOrdinalById,
+                sourceRunOrdinal: sourceRun.ordinal,
+              }),
+            );
+      const portableForkHandoff =
+        !requiresPortableFork ||
+        pendingForkTransfer === undefined ||
+        sourceProjection === null ||
+        sourceRun === null
+          ? null
+          : yield* contextHandoffService
+              .prepareProviderHandoff({
+                threadId: command.threadId,
+                targetRunId: runId,
+                transferId: pendingForkTransfer.id,
+                fromProviderThreadIds:
+                  sourceProviderThread === undefined ? [] : [sourceProviderThread.id],
+                toProviderThreadId: ensuredProviderThread.id,
+                fromProviderInstanceId: sourceRun.providerInstanceId,
+                toProviderInstanceId: modelSelection.instanceId,
+                coveredRunOrdinals: visibleDeltaRunOrdinals(sourceProjection, portableForkItems),
+                strategy: "full_thread_summary",
+                items: portableForkItems,
+                createdAt: now,
+              })
+              .pipe(
+                Effect.mapError(
+                  (cause) =>
+                    new OrchestratorDispatchError({
+                      commandId: command.commandId,
+                      commandType: command.type,
+                      cause,
+                    }),
+                ),
+              );
+      const requiresFullProviderSwitchContext =
+        isProviderSwitch && pendingMergeBackTransfer !== undefined;
+      const providerSwitchCoveredRuns =
+        !isProviderSwitch || latestCompletedRun === undefined
+          ? []
+          : projection.runs.filter(
+              (run) =>
+                run.status === "completed" &&
+                run.ordinal >
+                  (requiresFullProviderSwitchContext
+                    ? 0
+                    : (targetProviderThread?.lastRunOrdinal ?? 0)) &&
+                run.ordinal <= latestCompletedRun.ordinal,
+            );
+      const providerSwitchItems =
+        providerSwitchCoveredRuns.length === 0
+          ? []
+          : [
+              ...(targetProviderThread === undefined || requiresFullProviderSwitchContext
+                ? legacyImportItems
+                : []),
+              ...projection.turnItems.filter(
+                (item) =>
+                  item.runId !== null &&
+                  providerSwitchCoveredRuns.some((run) => run.id === item.runId),
+              ),
+            ];
+      const providerSwitchTransferId =
+        providerSwitchCoveredRuns.length === 0 || latestCompletedRun === undefined
+          ? null
+          : yield* mapDispatchError(command)(
+              idAllocator.allocate.contextTransfer({
+                sourceThreadId: command.threadId,
+                targetThreadId: command.threadId,
+                type: "provider_handoff",
+              }),
+            );
+      if (providerSwitchTransferId !== null) {
+        yield* enforceCommandPolicy(command)(
+          commandPolicy.ensureContextHandoff({
+            commandId: command.commandId,
+            threadId: command.threadId,
+            providerInstanceId: modelSelection.instanceId,
+            capabilities,
+            strategy:
+              targetProviderThread === undefined || requiresFullProviderSwitchContext
+                ? "full_thread_summary"
+                : "delta_context",
+          }),
+        );
+      }
+      const providerSwitchHandoff =
+        providerSwitchTransferId === null || latestCompletedRun === undefined
+          ? null
+          : yield* contextHandoffService
+              .prepareProviderHandoff({
+                threadId: command.threadId,
+                targetRunId: runId,
+                transferId: providerSwitchTransferId,
+                fromProviderThreadIds: Array.from(
+                  new Set(
+                    providerSwitchCoveredRuns.flatMap((run) =>
+                      run.providerThreadId === null ? [] : [run.providerThreadId],
+                    ),
+                  ),
+                ),
+                toProviderThreadId: ensuredProviderThread.id,
+                fromProviderInstanceId: latestCompletedRun.providerInstanceId,
+                toProviderInstanceId: modelSelection.instanceId,
+                coveredRunOrdinals: {
+                  from: providerSwitchCoveredRuns[0]!.ordinal,
+                  to: providerSwitchCoveredRuns.at(-1)!.ordinal,
+                },
+                strategy:
+                  targetProviderThread === undefined || requiresFullProviderSwitchContext
+                    ? "full_thread_summary"
+                    : "delta_since_target_last_seen",
+                items: providerSwitchItems,
+                createdAt: now,
+              })
+              .pipe(
+                Effect.mapError(
+                  (cause) =>
+                    new OrchestratorDispatchError({
+                      commandId: command.commandId,
+                      commandType: command.type,
+                      cause,
+                    }),
+                ),
+              );
+      const legacyImportRecoveryHandoff =
+        isProviderSwitch && latestCompletedRun === undefined && legacyImportItems.length > 0
+          ? yield* contextHandoffService
+              .prepareLegacyImport({
+                threadId: command.threadId,
+                targetRunId: runId,
+                toProviderThreadId: ensuredProviderThread.id,
+                toProviderInstanceId: modelSelection.instanceId,
+                items: legacyImportItems,
+                createdAt: now,
+              })
+              .pipe(mapDispatchError(command))
+          : null;
+      const providerThread: OrchestrationV2ProviderThread = {
+        ...ensuredProviderThread,
+        status: "active",
+        firstRunOrdinal: ensuredProviderThread.firstRunOrdinal ?? ordinal,
+        lastRunOrdinal: ordinal,
+        handoffIds: [
+          ...ensuredProviderThread.handoffIds,
+          ...[portableForkHandoff, providerSwitchHandoff, legacyImportRecoveryHandoff].flatMap(
+            (handoff) => (handoff === null ? [] : [handoff.id]),
+          ),
+        ],
+        updatedAt: now,
+      };
+
+      const attemptId = idAllocator.derive.runAttempt({ runId, attemptOrdinal: 1 });
+      const rootNodeId = idAllocator.derive.rootNode({ runId });
+      const emitEvent = emit(events, command);
+      const mergeBackSourceProjection =
+        pendingMergeBackTransfer === undefined
+          ? null
+          : yield* projectionStore
+              .getThreadProjection(pendingMergeBackTransfer.sourceThreadId)
+              .pipe(
+                Effect.mapError(
+                  (cause) =>
+                    new OrchestratorProjectionError({
+                      threadId: pendingMergeBackTransfer.sourceThreadId,
+                      cause,
+                    }),
+                ),
+              );
+      const mergeBackSourceRun =
+        pendingMergeBackTransfer?.sourcePoint.runId === undefined ||
+        mergeBackSourceProjection === null
+          ? null
+          : (mergeBackSourceProjection.runs.find(
+              (candidate) => candidate.id === pendingMergeBackTransfer.sourcePoint.runId,
+            ) ?? null);
+      if (pendingMergeBackTransfer !== undefined && mergeBackSourceRun === null) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Pending merge-back transfer ${pendingMergeBackTransfer.id} has no resolvable source run.`,
+        });
+      }
+      const mergeBackSourceProviderThread =
+        mergeBackSourceProjection === null || mergeBackSourceRun === null
+          ? undefined
+          : providerThreadForRun(mergeBackSourceProjection, mergeBackSourceRun);
+      if (pendingMergeBackTransfer !== undefined && mergeBackSourceProviderThread === undefined) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Pending merge-back transfer ${pendingMergeBackTransfer.id} has no resolvable source provider thread.`,
+        });
+      }
+      if (pendingMergeBackTransfer !== undefined) {
+        yield* enforceCommandPolicy(command)(
+          commandPolicy.ensureContextHandoff({
+            commandId: command.commandId,
+            threadId: command.threadId,
+            providerInstanceId: modelSelection.instanceId,
+            capabilities,
+            strategy: "fork_delta_context",
+          }),
+        );
+      }
+      const mergeBackDeltaItems =
+        mergeBackSourceProjection === null || mergeBackSourceRun === null
+          ? []
+          : mergeBackSourceProjection.turnItems.filter((item) => {
+              if (item.runId === null) {
+                return false;
+              }
+              const itemRun = mergeBackSourceProjection.runs.find(
+                (candidate) => candidate.id === item.runId,
+              );
+              return itemRun !== undefined && itemRun.ordinal <= mergeBackSourceRun.ordinal;
+            });
+      const mergeBackHandoff =
+        pendingMergeBackTransfer === undefined ||
+        mergeBackSourceProjection === null ||
+        mergeBackSourceRun === null ||
+        mergeBackSourceProviderThread === undefined
+          ? null
+          : yield* contextHandoffService
+              .prepareForkDelta({
+                sourceThreadId: pendingMergeBackTransfer.sourceThreadId,
+                targetThreadId: command.threadId,
+                targetRunId: runId,
+                transferId: pendingMergeBackTransfer.id,
+                fromProviderThreadIds: [mergeBackSourceProviderThread.id],
+                toProviderThreadId: providerThread.id,
+                fromProviderInstanceId: mergeBackSourceRun.providerInstanceId,
+                toProviderInstanceId: modelSelection.instanceId,
+                coveredRunOrdinals: visibleDeltaRunOrdinals(
+                  mergeBackSourceProjection,
+                  mergeBackDeltaItems,
+                ),
+                deltaItems: mergeBackDeltaItems,
+                createdAt: now,
+              })
+              .pipe(
+                Effect.mapError(
+                  (cause) =>
+                    new OrchestratorDispatchError({
+                      commandId: command.commandId,
+                      commandType: command.type,
+                      cause,
+                    }),
+                ),
+              );
+      const checkpointScope = yield* checkpointService
+        .prepareRootRunScope({
+          threadId: command.threadId,
+          runId,
+          rootNodeId,
+          providerThreadId: providerThread.id,
+          cwd:
+            resolvedRuntimePolicy.cwd ??
+            existingProviderSession?.cwd ??
+            projection.thread.worktreePath ??
+            process.cwd(),
+          createdAt: now,
+        })
+        .pipe(
+          Effect.mapError(
+            (cause) =>
+              new OrchestratorDispatchError({
+                commandId: command.commandId,
+                commandType: command.type,
+                cause,
+              }),
+          ),
+        );
+      const run: OrchestrationV2Run = {
+        id: runId,
+        threadId: command.threadId,
+        ordinal,
+        providerInstanceId: modelSelection.instanceId,
+        modelSelection,
+        providerThreadId: providerThread.id,
+        userMessageId: command.messageId,
+        rootNodeId,
+        activeAttemptId: attemptId,
+        status: "starting",
+        queuePosition: null,
+        requestedAt: now,
+        startedAt: null,
+        completedAt: null,
+        checkpointId: null,
+        contextHandoffId:
+          portableForkHandoff?.id ??
+          providerSwitchHandoff?.id ??
+          mergeBackHandoff?.id ??
+          legacyImportRecoveryHandoff?.id ??
+          null,
+        ...(command.sourcePlanRef === undefined ? {} : { sourcePlanRef: command.sourcePlanRef }),
+      };
+      const attempt: OrchestrationV2RunAttempt = {
+        id: attemptId,
+        runId,
+        attemptOrdinal: 1,
+        rootNodeId,
+        providerInstanceId: modelSelection.instanceId,
+        providerThreadId: providerThread.id,
+        providerTurnId: null,
+        reason: "initial",
+        status: "pending",
+        startedAt: null,
+        completedAt: null,
+      };
+      const rootNode: OrchestrationV2ExecutionNode = {
+        id: rootNodeId,
+        threadId: command.threadId,
+        runId,
+        parentNodeId: null,
+        rootNodeId,
+        kind: "root_turn",
+        status: "pending",
+        countsForRun: true,
+        providerThreadId: providerThread.id,
+        providerTurnId: null,
+        nativeItemRef: null,
+        runtimeRequestId: null,
+        checkpointScopeId: checkpointScope.id,
+        startedAt: null,
+        completedAt: null,
+      };
+      const message: OrchestrationV2ConversationMessage = {
+        createdBy: command.createdBy,
+        creationSource: command.creationSource,
+        id: command.messageId,
+        threadId: command.threadId,
+        runId,
+        nodeId: rootNodeId,
+        role: "user",
+        text: dispatchText,
+        attachments: command.attachments,
+        streaming: false,
+        createdAt: now,
+        updatedAt: now,
+        ...(delegatedCompletion === undefined ? {} : { delegatedCompletion }),
+      };
+      const turnItem: OrchestrationV2TurnItem = {
+        createdBy: command.createdBy,
+        creationSource: command.creationSource,
+        id: idAllocator.derive.userTurnItem({ messageId: command.messageId }),
+        threadId: command.threadId,
+        runId,
+        nodeId: rootNodeId,
+        providerThreadId: providerThread.id,
+        providerTurnId: null,
+        nativeItemRef: null,
+        parentItemId: null,
+        ordinal: ordinal * 100,
+        status: "completed",
+        title: null,
+        startedAt: now,
+        completedAt: now,
+        updatedAt: now,
+        type: "user_message",
+        messageId: command.messageId,
+        inputIntent: "turn_start",
+        text: dispatchText,
+        attachments: command.attachments,
+      };
+      const activeHandoff = portableForkHandoff ?? mergeBackHandoff ?? providerSwitchHandoff;
+      const handoffSourceRuns =
+        portableForkHandoff !== null
+          ? sourceRun === null
+            ? []
+            : [sourceRun]
+          : providerSwitchHandoff === null
+            ? mergeBackSourceRun === null
+              ? []
+              : [mergeBackSourceRun]
+            : providerSwitchCoveredRuns;
+      const handoffFromModelSelections = Array.from(
+        new Map(
+          handoffSourceRuns.map((run) => [
+            `${run.modelSelection.instanceId}${run.modelSelection.model}`,
+            run.modelSelection,
+          ]),
+        ).values(),
+      );
+      const handoffTurnItem: OrchestrationV2TurnItem | null =
+        activeHandoff === null
+          ? null
+          : {
+              id: idAllocator.derive.runSignalTurnItem({
+                runId,
+                signal: `context-handoff:${activeHandoff.id}`,
+              }),
+              threadId: command.threadId,
+              runId,
+              nodeId: rootNodeId,
+              providerThreadId: providerThread.id,
+              providerTurnId: null,
+              nativeItemRef: null,
+              parentItemId: null,
+              ordinal: ordinal * 100 - 1,
+              status: "completed",
+              title:
+                portableForkHandoff !== null
+                  ? "Fork context"
+                  : providerSwitchHandoff !== null
+                    ? "Provider handoff"
+                    : "Merge-back context",
+              startedAt: now,
+              completedAt: now,
+              updatedAt: now,
+              type: "handoff",
+              contextHandoffId: activeHandoff.id,
+              fromProviderThreadIds: activeHandoff.fromProviderThreadIds,
+              toProviderThreadId: activeHandoff.toProviderThreadId,
+              fromProviderInstanceIds: Array.from(
+                new Set(handoffSourceRuns.map((run) => run.providerInstanceId)),
+              ),
+              toProviderInstanceId: modelSelection.instanceId,
+              fromModelSelections: handoffFromModelSelections,
+              toModel: modelSelection.model,
+              strategy: activeHandoff.strategy,
+              summary: activeHandoff.summaryText,
+            };
+      const nativeForkResolution: OrchestrationV2ContextTransferResolution | null =
+        !canResolveForkNatively || providerThread.nativeThreadRef === null
+          ? null
+          : {
+              strategy: "native_fork",
+              providerThreadRef: providerThread.nativeThreadRef,
+            };
+      const portableForkResolution: OrchestrationV2ContextTransferResolution | null =
+        pendingForkTransfer === undefined || portableForkHandoff === null
+          ? null
+          : {
+              strategy: "portable_context",
+              contextHandoffId: portableForkHandoff.id,
+            };
+      const mergeBackResolution: OrchestrationV2ContextTransferResolution | null =
+        pendingMergeBackTransfer === undefined || mergeBackHandoff === null
+          ? null
+          : {
+              strategy: "fork_delta_context",
+              contextHandoffId: mergeBackHandoff.id,
+            };
+
+      if (pendingForkTransfer !== undefined && canResolveForkNatively) {
+        yield* emitEvent({
+          type: "context-transfer.updated",
+          threadId: command.threadId,
+          runId,
+          providerInstanceId: modelSelection.instanceId,
+          occurredAt: now,
+          payload: {
+            ...pendingForkTransfer,
+            targetProviderInstanceId: modelSelection.instanceId,
+            targetRunId: runId,
+            status: "pending",
+            resolution: null,
+            error: null,
+            updatedAt: now,
+          },
+        });
+      }
+      if (pendingForkTransfer !== undefined && portableForkResolution !== null) {
+        yield* emitEvent({
+          type: "context-transfer.updated",
+          threadId: command.threadId,
+          runId,
+          providerInstanceId: modelSelection.instanceId,
+          occurredAt: now,
+          payload: {
+            ...pendingForkTransfer,
+            targetProviderInstanceId: modelSelection.instanceId,
+            targetRunId: runId,
+            status: "resolved_portable",
+            resolution: portableForkResolution,
+            error: null,
+            updatedAt: now,
+          },
+        });
+      }
+      yield* emitEvent({
+        type: "provider-thread.updated",
+        threadId: command.threadId,
+        providerInstanceId: modelSelection.instanceId,
+        occurredAt: now,
+        payload: providerThread,
+      });
+      if (portableForkHandoff !== null) {
+        yield* emitEvent({
+          type: "context-handoff.updated",
+          threadId: command.threadId,
+          runId,
+          providerInstanceId: modelSelection.instanceId,
+          occurredAt: now,
+          payload: portableForkHandoff,
+        });
+      }
+      if (legacyImportRecoveryHandoff !== null) {
+        yield* emitEvent({
+          type: "context-handoff.updated",
+          threadId: command.threadId,
+          runId,
+          providerInstanceId: modelSelection.instanceId,
+          occurredAt: now,
+          payload: legacyImportRecoveryHandoff,
+        });
+      }
+      if (
+        providerSwitchTransferId !== null &&
+        providerSwitchHandoff !== null &&
+        latestCompletedRun !== undefined
+      ) {
+        const transfer: OrchestrationV2ContextTransfer = {
+          id: providerSwitchTransferId,
+          type: "provider_handoff",
+          sourceThreadId: command.threadId,
+          targetThreadId: command.threadId,
+          sourcePoint: contextSourcePointForRun(projection, latestCompletedRun),
+          basePoint:
+            requiresFullProviderSwitchContext ||
+            targetProviderThread?.lastRunOrdinal === null ||
+            targetProviderThread?.lastRunOrdinal === undefined
+              ? null
+              : (() => {
+                  const baseRun = projection.runs.find(
+                    (run) => run.ordinal === targetProviderThread.lastRunOrdinal,
+                  );
+                  return baseRun === undefined
+                    ? null
+                    : contextSourcePointForRun(projection, baseRun);
+                })(),
+          sourceProviderInstanceId: latestCompletedRun.providerInstanceId,
+          targetProviderInstanceId: modelSelection.instanceId,
+          targetRunId: runId,
+          status: "consumed",
+          resolution: {
+            strategy:
+              providerSwitchHandoff.strategy === "full_thread_summary"
+                ? "portable_context"
+                : "delta_context",
+            contextHandoffId: providerSwitchHandoff.id,
+          },
+          createdBy: command.createdBy,
+          error: null,
+          createdAt: now,
+          updatedAt: now,
+          consumedAt: now,
+        };
+        yield* emitEvent({
+          type: "context-transfer.created",
+          threadId: command.threadId,
+          runId,
+          providerInstanceId: modelSelection.instanceId,
+          occurredAt: now,
+          payload: transfer,
+        });
+        yield* emitEvent({
+          type: "context-handoff.updated",
+          threadId: command.threadId,
+          runId,
+          providerInstanceId: modelSelection.instanceId,
+          occurredAt: now,
+          payload: providerSwitchHandoff,
+        });
+      }
+      if (mergeBackHandoff !== null) {
+        yield* emitEvent({
+          type: "context-handoff.updated",
+          threadId: command.threadId,
+          runId,
+          providerInstanceId: modelSelection.instanceId,
+          occurredAt: now,
+          payload: mergeBackHandoff,
+        });
+      }
+      for (const supersededTransfer of supersededMergeBackTransfers) {
+        yield* emitEvent({
+          type: "context-transfer.updated",
+          threadId: command.threadId,
+          runId,
+          providerInstanceId: modelSelection.instanceId,
+          occurredAt: now,
+          payload: {
+            ...supersededTransfer,
+            status: "superseded",
+            error:
+              pendingMergeBackTransfer === undefined
+                ? "Superseded while consuming merge-back transfer."
+                : `Superseded by merge-back transfer ${pendingMergeBackTransfer.id}.`,
+            updatedAt: now,
+          },
+        });
+      }
+      if (pendingMergeBackTransfer !== undefined && mergeBackResolution !== null) {
+        yield* emitEvent({
+          type: "context-transfer.updated",
+          threadId: command.threadId,
+          runId,
+          providerInstanceId: modelSelection.instanceId,
+          occurredAt: now,
+          payload: {
+            ...pendingMergeBackTransfer,
+            targetProviderInstanceId: modelSelection.instanceId,
+            targetRunId: runId,
+            status: "consumed",
+            resolution: mergeBackResolution,
+            error: null,
+            updatedAt: now,
+            consumedAt: now,
+          },
+        });
+      }
+      yield* emitEvent({
+        type: "run.created",
+        threadId: command.threadId,
+        runId,
+        nodeId: rootNodeId,
+        providerInstanceId: modelSelection.instanceId,
+        occurredAt: now,
+        payload: run,
+      });
+      yield* completeSourcePlan(now);
+      yield* emitEvent({
+        type: "run-attempt.created",
+        threadId: command.threadId,
+        runId,
+        nodeId: rootNodeId,
+        providerInstanceId: modelSelection.instanceId,
+        occurredAt: now,
+        payload: attempt,
+      });
+      yield* emitEvent({
+        type: "node.updated",
+        threadId: command.threadId,
+        runId,
+        nodeId: rootNodeId,
+        providerInstanceId: modelSelection.instanceId,
+        occurredAt: now,
+        payload: rootNode,
+      });
+      yield* emitEvent({
+        type: "checkpoint-scope.created",
+        threadId: command.threadId,
+        runId,
+        nodeId: rootNodeId,
+        providerInstanceId: modelSelection.instanceId,
+        occurredAt: now,
+        payload: yield* checkpointService.ensureScope(checkpointScope).pipe(
+          Effect.mapError(
+            (cause) =>
+              new OrchestratorDispatchError({
+                commandId: command.commandId,
+                commandType: command.type,
+                cause,
+              }),
+          ),
+        ),
+      });
+      if (handoffTurnItem !== null) {
+        yield* emitEvent({
+          type: "turn-item.updated",
+          threadId: command.threadId,
+          runId,
+          nodeId: rootNodeId,
+          providerInstanceId: modelSelection.instanceId,
+          occurredAt: now,
+          payload: handoffTurnItem,
+        });
+      }
+      yield* emitEvent({
+        type: "message.updated",
+        threadId: command.threadId,
+        runId,
+        nodeId: rootNodeId,
+        providerInstanceId: modelSelection.instanceId,
+        occurredAt: now,
+        payload: message,
+      });
+      yield* emitEvent({
+        type: "turn-item.updated",
+        threadId: command.threadId,
+        runId,
+        nodeId: rootNodeId,
+        providerInstanceId: modelSelection.instanceId,
+        occurredAt: now,
+        payload: turnItem,
+      });
+      const forkResolution = nativeForkResolution ?? portableForkResolution;
+      if (pendingForkTransfer !== undefined && forkResolution !== null) {
+        yield* emitEvent({
+          type: "context-transfer.updated",
+          threadId: command.threadId,
+          runId,
+          providerInstanceId: modelSelection.instanceId,
+          occurredAt: now,
+          payload: {
+            ...pendingForkTransfer,
+            targetProviderInstanceId: modelSelection.instanceId,
+            targetRunId: runId,
+            status: "consumed",
+            resolution: forkResolution,
+            error: null,
+            updatedAt: now,
+            consumedAt: now,
+          },
+        });
+      }
+
+      const pendingEffect = {
+        id: `effect:${command.commandId}:provider-turn.start:${runId}`,
+        commandId: command.commandId,
+        threadId: command.threadId,
+        request: { type: "provider-turn.start", runId },
+      } satisfies PendingOrchestrationEffectV2;
+      yield* Ref.update(effects, (existing) => [...existing, pendingEffect]);
+    });
+
+  const dispatchDelegatedTaskRequest = Effect.fn("orchestrationV2.dispatch.delegatedTaskRequest")(
+    function* (
+      command: Extract<OrchestrationV2Command, { readonly type: "delegated_task.request" }>,
+      events: Ref.Ref<Array<OrchestrationV2DomainEvent>>,
+      effects: Ref.Ref<Array<PendingOrchestrationEffectV2>>,
+    ) {
+      const parentProjection = yield* projectionStore
+        .getThreadProjection(command.parentThreadId)
+        .pipe(
+          Effect.mapError(
+            (cause) =>
+              new OrchestratorProjectionError({
+                threadId: command.parentThreadId,
+                cause,
+              }),
+          ),
+        );
+      const parentRun = parentProjection.runs.find(
+        (candidate) => candidate.id === command.parentRunId,
+      );
+      if (parentRun === undefined || !isBlockingRun(parentRun)) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Parent run ${command.parentRunId} is not active.`,
+        });
+      }
+      const parentNode = parentProjection.nodes.find(
+        (candidate) => candidate.id === command.parentNodeId,
+      );
+      if (
+        parentNode === undefined ||
+        parentNode.runId !== parentRun.id ||
+        parentRun.rootNodeId === null
+      ) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Parent node ${command.parentNodeId} is not part of active run ${parentRun.id}.`,
+        });
+      }
+
+      const targetAdapter = yield* providerAdapters.get(command.modelSelection.instanceId).pipe(
+        Effect.mapError(
+          (cause) =>
+            new OrchestratorProviderAdapterError({
+              commandId: command.commandId,
+              providerInstanceId: command.modelSelection.instanceId,
+              cause,
+            }),
+        ),
+      );
+
+      const now = command.createdAt ?? (yield* DateTime.now);
+      const taskNodeId = idAllocator.derive.delegatedTaskNode({
+        commandId: command.commandId,
+      });
+      const childThreadId = idAllocator.derive.delegatedTaskThread({
+        commandId: command.commandId,
+      });
+      const childMessageId = idAllocator.derive.delegatedTaskMessage({
+        commandId: command.commandId,
+      });
+      const taskTurnItemId = idAllocator.derive.delegatedTaskTurnItem({
+        commandId: command.commandId,
+      });
+      const taskTitle = subagentThreadTitle({
+        parentTitle: parentProjection.thread.title,
+        prompt: command.task,
+        ...(command.title === undefined ? {} : { title: command.title }),
+        ordinal: parentProjection.subagents.length + 1,
+      });
+      const childThread: OrchestrationV2AppThread = {
+        ...makeSubagentChildThread({
+          parentThread: parentProjection.thread,
+          childThreadId,
+          parentNodeId: taskNodeId,
+          activeProviderThreadId: null,
+          providerInstanceId: command.modelSelection.instanceId,
+          modelSelection: command.modelSelection,
+          title: taskTitle,
+          now,
+          createdBy: command.createdBy,
+          creationSource: command.creationSource,
+        }),
+        runtimeMode: command.runtimeMode,
+        interactionMode: command.interactionMode,
+      };
+      const task: OrchestrationV2Subagent = {
+        id: taskNodeId,
+        threadId: command.parentThreadId,
+        runId: parentRun.id,
+        parentNodeId: command.parentNodeId,
+        origin: "app_owned",
+        createdBy: command.createdBy,
+        driver: targetAdapter.driver,
+        providerInstanceId: command.modelSelection.instanceId,
+        providerThreadId: null,
+        childThreadId,
+        nativeTaskRef: null,
+        prompt: command.task,
+        title: command.title ?? null,
+        model: command.modelSelection.model,
+        ...(command.completionWake === undefined ? {} : { completionWake: command.completionWake }),
+        status: "running",
+        result: null,
+        startedAt: now,
+        completedAt: null,
+        updatedAt: now,
+      };
+      const taskNode: OrchestrationV2ExecutionNode = {
+        id: taskNodeId,
+        threadId: command.parentThreadId,
+        runId: parentRun.id,
+        parentNodeId: command.parentNodeId,
+        rootNodeId: parentRun.rootNodeId,
+        kind: "subagent",
+        status: "running",
+        countsForRun: false,
+        providerThreadId: null,
+        providerTurnId: null,
+        nativeItemRef: null,
+        runtimeRequestId: null,
+        checkpointScopeId: null,
+        startedAt: now,
+        completedAt: null,
+      };
+      const parentProviderTurn = providerTurnForRun(parentProjection, parentRun);
+      const taskTurnItem: OrchestrationV2TurnItem = {
+        id: taskTurnItemId,
+        threadId: command.parentThreadId,
+        runId: parentRun.id,
+        nodeId: taskNodeId,
+        providerThreadId: parentRun.providerThreadId,
+        providerTurnId: parentProviderTurn?.id ?? null,
+        nativeItemRef: null,
+        parentItemId: null,
+        ordinal: nextTurnItemOrdinal(parentProjection),
+        status: "running",
+        title: command.title ?? taskTitle,
+        startedAt: now,
+        completedAt: null,
+        updatedAt: now,
+        type: "subagent",
+        subagentId: taskNodeId,
+        origin: "app_owned",
+        driver: targetAdapter.driver,
+        providerInstanceId: command.modelSelection.instanceId,
+        childThreadId,
+        prompt: command.task,
+        result: null,
+      };
+      const emitEvent = emit(events, command);
+
+      yield* emitEvent({
+        type: "thread.created",
+        threadId: childThreadId,
+        driver: targetAdapter.driver,
+        providerInstanceId: command.modelSelection.instanceId,
+        occurredAt: now,
+        payload: childThread,
+      });
+      yield* emitEvent({
+        type: "node.updated",
+        threadId: command.parentThreadId,
+        runId: parentRun.id,
+        nodeId: taskNodeId,
+        driver: targetAdapter.driver,
+        providerInstanceId: command.modelSelection.instanceId,
+        occurredAt: now,
+        payload: taskNode,
+      });
+      yield* emitEvent({
+        type: "subagent.updated",
+        threadId: command.parentThreadId,
+        runId: parentRun.id,
+        nodeId: taskNodeId,
+        driver: targetAdapter.driver,
+        providerInstanceId: command.modelSelection.instanceId,
+        occurredAt: now,
+        payload: task,
+      });
+      yield* emitEvent({
+        type: "turn-item.updated",
+        threadId: command.parentThreadId,
+        runId: parentRun.id,
+        nodeId: taskNodeId,
+        driver: targetAdapter.driver,
+        providerInstanceId: command.modelSelection.instanceId,
+        occurredAt: now,
+        payload: taskTurnItem,
+      });
+
+      const childMessageCommand = {
+        type: "message.dispatch",
+        createdBy: command.createdBy,
+        creationSource: command.creationSource,
+        commandId: command.commandId,
+        threadId: childThreadId,
+        messageId: childMessageId,
+        text: command.task,
+        attachments: [],
+        modelSelection: command.modelSelection,
+        dispatchMode: { type: "start_immediately" },
+      } satisfies Extract<OrchestrationV2Command, { readonly type: "message.dispatch" }>;
+      yield* dispatchMessage(childMessageCommand, events, effects);
+
+      const childProjection = yield* getProjectionWithPendingEvents(childThreadId, events);
+      const childRun = childProjection.runs[0];
+      if (childRun === undefined) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Delegated child thread ${childThreadId} did not create a run.`,
+        });
+      }
+      const spawnTransferId = yield* mapDispatchError(command)(
+        idAllocator.allocate.contextTransfer({
+          sourceThreadId: command.parentThreadId,
+          targetThreadId: childThreadId,
+          type: "subagent_spawn",
+        }),
+      );
+      const spawnTransfer: OrchestrationV2ContextTransfer = {
+        id: spawnTransferId,
+        type: "subagent_spawn",
+        sourceThreadId: command.parentThreadId,
+        targetThreadId: childThreadId,
+        sourcePoint: {
+          ...contextSourcePointForRun(parentProjection, parentRun),
+          turnItemId: taskTurnItemId,
+        },
+        basePoint: null,
+        sourceProviderInstanceId: parentRun.providerInstanceId,
+        targetProviderInstanceId: command.modelSelection.instanceId,
+        targetRunId: childRun.id,
+        status: "consumed",
+        resolution: null,
+        createdBy: command.createdBy,
+        error: null,
+        createdAt: now,
+        updatedAt: now,
+        consumedAt: now,
+      };
+      yield* emitEvent({
+        type: "context-transfer.created",
+        threadId: childThreadId,
+        runId: childRun.id,
+        providerInstanceId: command.modelSelection.instanceId,
+        occurredAt: now,
+        payload: spawnTransfer,
+      });
+    },
+  );
+
+  // Rewrites a delegated task's completionWake after creation. The wait path
+  // uses this when its blocking window ends without a terminal (timeout), so
+  // a child that later terminalizes mid-parent-turn still wakes the parent.
+  // Runs under the parent thread's dispatch lock, which is also what finalize
+  // takes for its parent-side writes, so the two never interleave on this row.
+  const dispatchDelegatedTaskWakePolicy = Effect.fn(
+    "orchestrationV2.dispatch.delegatedTaskWakePolicy",
+  )(function* (
+    command: Extract<OrchestrationV2Command, { readonly type: "delegated_task.wake-policy" }>,
+    events: Ref.Ref<Array<OrchestrationV2DomainEvent>>,
+  ) {
+    const parentProjection = yield* projectionStore
+      .getThreadProjection(command.parentThreadId)
+      .pipe(
+        Effect.mapError(
+          (cause) =>
+            new OrchestratorProjectionError({
+              threadId: command.parentThreadId,
+              cause,
+            }),
+        ),
+      );
+    const task = parentProjection.subagents.find(
+      (candidate) => candidate.id === command.taskId && candidate.origin === "app_owned",
+    );
+    // No-op commands reject with a descriptive cause, matching the thread
+    // mutation handlers ("already archived", "not archived").
+    if (task === undefined) {
+      return yield* new OrchestratorDispatchError({
+        commandId: command.commandId,
+        commandType: command.type,
+        cause: `Delegated task ${command.taskId} is not an app-owned task of thread ${command.parentThreadId}.`,
+      });
+    }
+    if (task.completionWake === command.completionWake) {
+      return yield* new OrchestratorDispatchError({
+        commandId: command.commandId,
+        commandType: command.type,
+        cause: `Delegated task ${command.taskId} already wakes the parent with completionWake ${command.completionWake}.`,
+      });
+    }
+    const now = yield* DateTime.now;
+    const emitEvent = emit(events, command);
+    const updatedTask: OrchestrationV2Subagent = {
+      ...task,
+      completionWake: command.completionWake,
+      updatedAt: now,
+    };
+    // A non-terminal task needs no offer here: finalize reads the upgraded
+    // policy when the child terminalizes. Both writers hold this parent lock,
+    // so a terminal task means finalize already committed the terminal row and
+    // already made its offer decision under the pre-upgrade policy: under
+    // settled_only it offered iff the parent had no live run. Plan a delivery
+    // only when the parent has a live run now, which is precisely the case
+    // where finalize skipped. Queue-after-active then sequences it behind that
+    // run. When the parent is not live, finalize already offered and a second
+    // offer would wake the parent twice. (If the parent settled in between,
+    // this skips a wake that finalize also skipped; a missed wake is cheaper
+    // than a duplicate one, and the result is already in the projection.)
+    const parentRun =
+      task.runId === null
+        ? undefined
+        : parentProjection.runs.find((candidate) => candidate.id === task.runId);
+    const completionPlan =
+      command.completionWake === "always" &&
+      isTerminalDelegatedTaskStatus(task.status) &&
+      hasLiveRun(parentProjection)
+        ? yield* planDelegatedCompletionDelivery({
+            parentProjection,
+            parentRun,
+            task: updatedTask,
+            updatedTask,
+            now,
+          })
+        : undefined;
+    yield* emitEvent({
+      type: "subagent.updated",
+      threadId: command.parentThreadId,
+      ...(task.runId === null ? {} : { runId: task.runId }),
+      nodeId: task.id,
+      driver: task.driver,
+      providerInstanceId: task.providerInstanceId,
+      occurredAt: now,
+      payload: completionPlan?.task ?? updatedTask,
+    });
+    if (completionPlan === undefined) {
+      return;
+    }
+    if (completionPlan.parentRun !== undefined) {
+      yield* emitEvent({
+        type: "run.updated",
+        threadId: command.parentThreadId,
+        runId: completionPlan.parentRun.id,
+        ...(completionPlan.parentRun.rootNodeId === null
+          ? {}
+          : { nodeId: completionPlan.parentRun.rootNodeId }),
+        providerInstanceId: completionPlan.parentRun.providerInstanceId,
+        occurredAt: now,
+        payload: completionPlan.parentRun,
+      });
+    }
+    if (completionPlan.message !== undefined) {
+      yield* emitEvent({
+        type: "message.updated",
+        threadId: command.parentThreadId,
+        ...(completionPlan.message.runId === null ? {} : { runId: completionPlan.message.runId }),
+        ...(completionPlan.message.nodeId === null
+          ? {}
+          : { nodeId: completionPlan.message.nodeId }),
+        providerInstanceId:
+          completionPlan.parentRun?.providerInstanceId ??
+          parentProjection.thread.providerInstanceId,
+        occurredAt: now,
+        payload: completionPlan.message,
+      });
+    }
+  });
+
+  const dispatchCreatedThreadRecord = Effect.fn("orchestrationV2.dispatch.createdThreadRecord")(
+    function* (
+      command: Extract<OrchestrationV2Command, { readonly type: "thread.created.record" }>,
+      events: Ref.Ref<Array<OrchestrationV2DomainEvent>>,
+    ) {
+      const parentProjection = yield* projectionStore
+        .getThreadProjection(command.parentThreadId)
+        .pipe(
+          Effect.mapError(
+            (cause) =>
+              new OrchestratorProjectionError({
+                threadId: command.parentThreadId,
+                cause,
+              }),
+          ),
+        );
+      const targetProjection = yield* projectionStore
+        .getThreadProjection(command.targetThreadId)
+        .pipe(
+          Effect.mapError(
+            (cause) =>
+              new OrchestratorProjectionError({
+                threadId: command.targetThreadId,
+                cause,
+              }),
+          ),
+        );
+      const parentRun = parentProjection.runs.find(
+        (candidate) => candidate.id === command.parentRunId,
+      );
+      const parentNode = parentProjection.nodes.find(
+        (candidate) => candidate.id === command.parentNodeId,
+      );
+      if (
+        parentRun === undefined ||
+        parentNode === undefined ||
+        parentNode.runId !== command.parentRunId ||
+        parentRun.rootNodeId !== command.parentNodeId
+      ) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Parent node ${command.parentNodeId} is not the root of run ${command.parentRunId}.`,
+        });
+      }
+      if (parentProjection.thread.projectId !== targetProjection.thread.projectId) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Target thread ${command.targetThreadId} belongs to another project.`,
+        });
+      }
+      if (
+        command.targetRunId !== null &&
+        !targetProjection.runs.some((candidate) => candidate.id === command.targetRunId)
+      ) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Target run ${command.targetRunId} does not belong to thread ${command.targetThreadId}.`,
+        });
+      }
+
+      const now = yield* DateTime.now;
+      const parentProviderTurn = providerTurnForRun(parentProjection, parentRun);
+      const turnItem: OrchestrationV2TurnItem = {
+        id: idAllocator.derive.createdThreadTurnItem({ commandId: command.commandId }),
+        threadId: command.parentThreadId,
+        runId: command.parentRunId,
+        nodeId: command.parentNodeId,
+        providerThreadId: parentRun.providerThreadId,
+        providerTurnId: parentProviderTurn?.id ?? null,
+        nativeItemRef: null,
+        parentItemId: null,
+        ordinal: nextTurnItemOrdinal(parentProjection),
+        status: "completed",
+        title: targetProjection.thread.title,
+        startedAt: now,
+        completedAt: now,
+        updatedAt: now,
+        type: "thread_created",
+        targetThreadId: command.targetThreadId,
+        targetRunId: command.targetRunId,
+        targetProviderInstanceId: targetProjection.thread.modelSelection.instanceId,
+        targetModel: targetProjection.thread.modelSelection.model,
+      };
+
+      yield* emit(
+        events,
+        command,
+      )({
+        type: "turn-item.updated",
+        threadId: command.parentThreadId,
+        runId: command.parentRunId,
+        nodeId: command.parentNodeId,
+        providerInstanceId: parentRun.providerInstanceId,
+        occurredAt: now,
+        payload: turnItem,
+      });
+    },
+  );
+
+  const dispatchRuntimeRequestRespond = (
+    command: Extract<OrchestrationV2Command, { readonly type: "runtime-request.respond" }>,
+    events: Ref.Ref<Array<OrchestrationV2DomainEvent>>,
+    effects: Ref.Ref<Array<PendingOrchestrationEffectV2>>,
+  ) =>
+    Effect.gen(function* () {
+      const projection = yield* projectionStore
+        .getThreadProjection(command.threadId)
+        .pipe(
+          Effect.mapError(() => new OrchestratorProjectionError({ threadId: command.threadId })),
+        );
+      const runtimeRequest = projection.runtimeRequests.find(
+        (candidate) => candidate.id === command.requestId,
+      );
+      if (runtimeRequest === undefined) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Runtime request ${command.requestId} was not found.`,
+        });
+      }
+      if (runtimeRequest.status !== "pending") {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Runtime request ${command.requestId} is ${runtimeRequest.status}.`,
+        });
+      }
+      if (runtimeRequest.responseCapability.type !== "live") {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: runtimeRequest.responseCapability.reason,
+        });
+      }
+      const providerSessionId = runtimeRequest.responseCapability.providerSessionId;
+
+      const providerSession = projection.providerSessions.find(
+        (candidate) => candidate.id === providerSessionId,
+      );
+      if (providerSession === undefined) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Provider session ${providerSessionId} was not found.`,
+        });
+      }
+
+      const now = yield* DateTime.now;
+      const resolvedRequest = {
+        ...runtimeRequest,
+        status: "resolved" as const,
+        resolvedAt: now,
+      };
+      const emitEvent = emit(events, command);
+      const requestNode = projection.nodes.find((node) => node.id === runtimeRequest.nodeId);
+      const resolvedNodeStatus =
+        command.decision === "decline" || command.decision === "cancel"
+          ? ("cancelled" as const)
+          : ("completed" as const);
+      yield* emitEvent({
+        type: "runtime-request.updated",
+        threadId: command.threadId,
+        ...(requestNode?.runId == null ? {} : { runId: requestNode.runId }),
+        nodeId: runtimeRequest.nodeId,
+        driver: providerSession.driver,
+        providerInstanceId: providerSession.providerInstanceId,
+        occurredAt: now,
+        payload: resolvedRequest,
+      });
+      if (requestNode !== undefined) {
+        yield* emitEvent({
+          type: "node.updated",
+          threadId: command.threadId,
+          ...(requestNode.runId === null ? {} : { runId: requestNode.runId }),
+          nodeId: requestNode.id,
+          driver: providerSession.driver,
+          providerInstanceId: providerSession.providerInstanceId,
+          occurredAt: now,
+          payload: {
+            ...requestNode,
+            status: resolvedNodeStatus,
+            completedAt: now,
+          },
+        });
+      }
+
+      const approvalTurnItem = projection.turnItems.find(
+        (item) =>
+          (item.type === "approval_request" || item.type === "user_input_request") &&
+          item.requestId === command.requestId,
+      );
+      if (approvalTurnItem !== undefined) {
+        yield* emitEvent({
+          type: "turn-item.updated",
+          threadId: command.threadId,
+          ...(approvalTurnItem.runId === null ? {} : { runId: approvalTurnItem.runId }),
+          ...(approvalTurnItem.nodeId === null ? {} : { nodeId: approvalTurnItem.nodeId }),
+          driver: providerSession.driver,
+          providerInstanceId: providerSession.providerInstanceId,
+          occurredAt: now,
+          payload: {
+            ...approvalTurnItem,
+            status: resolvedNodeStatus,
+            completedAt: now,
+            updatedAt: now,
+          },
+        });
+      }
+      yield* Ref.update(effects, (existing) => [
+        ...existing,
+        {
+          id: `effect:${command.commandId}:runtime-request.respond:${command.requestId}`,
+          commandId: command.commandId,
+          threadId: command.threadId,
+          request: {
+            type: "runtime-request.respond",
+            providerSessionId,
+            requestId: command.requestId,
+            ...(command.decision === undefined ? {} : { decision: command.decision }),
+            ...(command.answers === undefined ? {} : { answers: command.answers }),
+          },
+        } satisfies PendingOrchestrationEffectV2,
+      ]);
+    });
+
+  const dispatchQueuedMessagePromoteToSteer = (
+    command: Extract<OrchestrationV2Command, { readonly type: "queued-message.promote-to-steer" }>,
+    events: Ref.Ref<Array<OrchestrationV2DomainEvent>>,
+    effects: Ref.Ref<Array<PendingOrchestrationEffectV2>>,
+  ) =>
+    Effect.gen(function* () {
+      const projection = yield* projectionStore
+        .getThreadProjection(command.threadId)
+        .pipe(
+          Effect.mapError(() => new OrchestratorProjectionError({ threadId: command.threadId })),
+        );
+      if (projection.thread.archivedAt !== null || projection.thread.deletedAt !== null) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Thread ${command.threadId} is not active.`,
+        });
+      }
+      const queuedRun = projection.runs.find((candidate) => candidate.id === command.queuedRunId);
+      if (queuedRun === undefined || queuedRun.status !== "queued") {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Queued run ${command.queuedRunId} is not queued.`,
+        });
+      }
+      const queuedRootNode =
+        queuedRun.rootNodeId === null
+          ? undefined
+          : projection.nodes.find((candidate) => candidate.id === queuedRun.rootNodeId);
+      const queuedAttempt =
+        queuedRun.activeAttemptId === null
+          ? undefined
+          : projection.attempts.find((candidate) => candidate.id === queuedRun.activeAttemptId);
+      const queuedMessage = projection.messages.find(
+        (candidate) => candidate.id === queuedRun.userMessageId,
+      );
+      if (
+        queuedRootNode === undefined ||
+        queuedAttempt === undefined ||
+        queuedMessage === undefined
+      ) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Queued run ${queuedRun.id} is missing message or execution state.`,
+        });
+      }
+      if (queuedMessage.delegatedCompletion !== undefined) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: "Automatic completion deliveries cannot be promoted to Steer.",
+        });
+      }
+
+      const now = yield* DateTime.now;
+      const emitEvent = emit(events, command);
+      yield* emitEvent({
+        type: "run.updated",
+        threadId: command.threadId,
+        runId: queuedRun.id,
+        nodeId: queuedRootNode.id,
+        providerInstanceId: queuedRun.providerInstanceId,
+        occurredAt: now,
+        payload: {
+          ...queuedRun,
+          status: "cancelled",
+          queuePosition: null,
+          completedAt: now,
+        },
+      });
+      yield* emitEvent({
+        type: "run-attempt.updated",
+        threadId: command.threadId,
+        runId: queuedRun.id,
+        nodeId: queuedRootNode.id,
+        providerInstanceId: queuedRun.providerInstanceId,
+        occurredAt: now,
+        payload: {
+          ...queuedAttempt,
+          status: "cancelled",
+          completedAt: now,
+        },
+      });
+      yield* emitEvent({
+        type: "node.updated",
+        threadId: command.threadId,
+        runId: queuedRun.id,
+        nodeId: queuedRootNode.id,
+        providerInstanceId: queuedRun.providerInstanceId,
+        occurredAt: now,
+        payload: {
+          ...queuedRootNode,
+          status: "cancelled",
+          completedAt: now,
+        },
+      });
+
+      yield* dispatchSteerIntoRun({
+        command,
+        events,
+        effects,
+        projection,
+        modelSelection: projection.thread.modelSelection,
+        targetRunId: command.targetRunId,
+        messageId: queuedMessage.id,
+        text: queuedMessage.text,
+        attachments: queuedMessage.attachments,
+        createdBy: queuedMessage.createdBy,
+        creationSource: queuedMessage.creationSource,
+        forceRestart: false,
+      });
+    });
+
+  const dispatchQueuedRunReorder = (
+    command: Extract<OrchestrationV2Command, { readonly type: "queued-run.reorder" }>,
+    events: Ref.Ref<Array<OrchestrationV2DomainEvent>>,
+  ) =>
+    Effect.gen(function* () {
+      const projection = yield* projectionStore
+        .getThreadProjection(command.threadId)
+        .pipe(
+          Effect.mapError(() => new OrchestratorProjectionError({ threadId: command.threadId })),
+        );
+      const queuedRuns = queuedRunsInDeliveryOrder(projection);
+      const moving = queuedRuns.find((run) => run.id === command.runId);
+      if (moving === undefined) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Run ${command.runId} is not queued.`,
+        });
+      }
+      const movingMessage = projection.messages.find(
+        (candidate) => candidate.id === moving.userMessageId,
+      );
+      if (movingMessage?.delegatedCompletion !== undefined) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: "Automatic completion deliveries cannot be reordered.",
+        });
+      }
+      const automaticRuns = queuedRuns.filter((run) => isAutomaticCompletionRun(projection, run));
+      if (
+        command.beforeRunId !== null &&
+        automaticRuns.some((run) => run.id === command.beforeRunId)
+      ) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: "Queued messages cannot be reordered ahead of automatic completion delivery.",
+        });
+      }
+      const reorderableRuns = queuedRuns.filter(
+        (run) => !isAutomaticCompletionRun(projection, run),
+      );
+      const withoutMoving = reorderableRuns.filter((run) => run.id !== command.runId);
+      const beforeIndex =
+        command.beforeRunId === null
+          ? withoutMoving.length
+          : withoutMoving.findIndex((run) => run.id === command.beforeRunId);
+      if (beforeIndex === -1) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Queue target ${command.beforeRunId} is not queued.`,
+        });
+      }
+      const reordered = [
+        ...automaticRuns,
+        ...withoutMoving.slice(0, beforeIndex),
+        moving,
+        ...withoutMoving.slice(beforeIndex),
+      ];
+      const now = yield* DateTime.now;
+      const emitEvent = emit(events, command);
+      yield* Effect.forEach(
+        reordered,
+        (run, index) =>
+          Effect.gen(function* () {
+            const queuePosition = index + 1;
+            if (run.queuePosition === queuePosition) {
+              return;
+            }
+            yield* emitEvent({
+              type: "run.updated",
+              threadId: command.threadId,
+              runId: run.id,
+              ...(run.rootNodeId === null ? {} : { nodeId: run.rootNodeId }),
+              providerInstanceId: run.providerInstanceId,
+              occurredAt: now,
+              payload: {
+                ...run,
+                queuePosition,
+              },
+            });
+          }),
+        { concurrency: 1 },
+      );
+    });
+
+  const dispatchQueuedRunCancel = (
+    command: Extract<OrchestrationV2Command, { readonly type: "queued-run.cancel" }>,
+    events: Ref.Ref<Array<OrchestrationV2DomainEvent>>,
+  ) =>
+    Effect.gen(function* () {
+      const projection = yield* projectionStore
+        .getThreadProjection(command.threadId)
+        .pipe(
+          Effect.mapError(() => new OrchestratorProjectionError({ threadId: command.threadId })),
+        );
+      const queuedRun = projection.runs.find((candidate) => candidate.id === command.runId);
+      if (queuedRun === undefined || queuedRun.status !== "queued") {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Run ${command.runId} is not queued.`,
+        });
+      }
+      const queuedMessage = projection.messages.find(
+        (candidate) => candidate.id === queuedRun.userMessageId,
+      );
+      if (queuedMessage?.delegatedCompletion !== undefined) {
+        const now = yield* DateTime.now;
+        yield* disposeDelegatedCompletionCohort({
+          command,
+          events,
+          projection,
+          parentRunId: queuedMessage.delegatedCompletion.parentRunId,
+          disposition: "disposed",
+          now,
+        });
+        return;
+      }
+      const queuedRootNode =
+        queuedRun.rootNodeId === null
+          ? undefined
+          : projection.nodes.find((candidate) => candidate.id === queuedRun.rootNodeId);
+      const queuedAttempt =
+        queuedRun.activeAttemptId === null
+          ? undefined
+          : projection.attempts.find((candidate) => candidate.id === queuedRun.activeAttemptId);
+
+      const now = yield* DateTime.now;
+      const emitEvent = emit(events, command);
+      yield* emitEvent({
+        type: "run.updated",
+        threadId: command.threadId,
+        runId: queuedRun.id,
+        ...(queuedRun.rootNodeId === null ? {} : { nodeId: queuedRun.rootNodeId }),
+        providerInstanceId: queuedRun.providerInstanceId,
+        occurredAt: now,
+        payload: {
+          ...queuedRun,
+          status: "cancelled",
+          queuePosition: null,
+          completedAt: now,
+        },
+      });
+      if (queuedAttempt !== undefined && queuedRootNode !== undefined) {
+        yield* emitEvent({
+          type: "run-attempt.updated",
+          threadId: command.threadId,
+          runId: queuedRun.id,
+          nodeId: queuedRootNode.id,
+          providerInstanceId: queuedRun.providerInstanceId,
+          occurredAt: now,
+          payload: {
+            ...queuedAttempt,
+            status: "cancelled",
+            completedAt: now,
+          },
+        });
+      }
+      if (queuedRootNode !== undefined) {
+        yield* emitEvent({
+          type: "node.updated",
+          threadId: command.threadId,
+          runId: queuedRun.id,
+          nodeId: queuedRootNode.id,
+          providerInstanceId: queuedRun.providerInstanceId,
+          occurredAt: now,
+          payload: {
+            ...queuedRootNode,
+            status: "cancelled",
+            completedAt: now,
+          },
+        });
+      }
+    });
+
+  const dispatchQueuedRunEdit = (
+    command: Extract<OrchestrationV2Command, { readonly type: "queued-run.edit" }>,
+    events: Ref.Ref<Array<OrchestrationV2DomainEvent>>,
+  ) =>
+    Effect.gen(function* () {
+      if (command.text.trim().length === 0) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Queued run ${command.runId} cannot be edited to an empty message.`,
+        });
+      }
+      const projection = yield* projectionStore
+        .getThreadProjection(command.threadId)
+        .pipe(
+          Effect.mapError(() => new OrchestratorProjectionError({ threadId: command.threadId })),
+        );
+      const queuedRun = projection.runs.find((candidate) => candidate.id === command.runId);
+      if (queuedRun === undefined || queuedRun.status !== "queued") {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Run ${command.runId} is not queued.`,
+        });
+      }
+      const queuedMessage = projection.messages.find(
+        (candidate) => candidate.id === queuedRun.userMessageId,
+      );
+      if (queuedMessage === undefined) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Queued run ${queuedRun.id} has no user message.`,
+        });
+      }
+      if (queuedMessage.delegatedCompletion !== undefined) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: "Automatic completion deliveries cannot be edited.",
+        });
+      }
+      const queuedTurnItem = projection.turnItems.find(
+        (candidate) =>
+          candidate.type === "user_message" && candidate.messageId === queuedMessage.id,
+      );
+
+      const now = yield* DateTime.now;
+      const emitEvent = emit(events, command);
+      const editedAttachments =
+        command.attachments === undefined ? {} : { attachments: command.attachments };
+      yield* emitEvent({
+        type: "message.updated",
+        threadId: command.threadId,
+        runId: queuedRun.id,
+        ...(queuedRun.rootNodeId === null ? {} : { nodeId: queuedRun.rootNodeId }),
+        providerInstanceId: queuedRun.providerInstanceId,
+        occurredAt: now,
+        payload: {
+          ...queuedMessage,
+          text: command.text,
+          ...editedAttachments,
+          updatedAt: now,
+        },
+      });
+      if (queuedTurnItem !== undefined && queuedTurnItem.type === "user_message") {
+        yield* emitEvent({
+          type: "turn-item.updated",
+          threadId: command.threadId,
+          runId: queuedRun.id,
+          ...(queuedRun.rootNodeId === null ? {} : { nodeId: queuedRun.rootNodeId }),
+          providerInstanceId: queuedRun.providerInstanceId,
+          occurredAt: now,
+          payload: {
+            ...queuedTurnItem,
+            text: command.text,
+            ...editedAttachments,
+            updatedAt: now,
+          },
+        });
+      }
+    });
+
+  const loadProjectionForCommand = (command: OrchestrationV2Command) =>
+    projectionStore
+      .getThreadProjection(commandThreadId(command))
+      .pipe(
+        Effect.mapError(
+          () => new OrchestratorProjectionError({ threadId: commandThreadId(command) }),
+        ),
+      );
+
+  const preparedRunState = (
+    command: Extract<
+      OrchestrationV2Command,
+      {
+        readonly type: "prepared-run.release" | "prepared-run.progress" | "prepared-run.fail";
+      }
+    >,
+    projection: OrchestrationV2ThreadProjection,
+  ) => {
+    const run = projection.runs.find((candidate) => candidate.id === command.runId);
+    const attempt = projection.attempts.find((candidate) => candidate.id === run?.activeAttemptId);
+    const rootNode = projection.nodes.find((candidate) => candidate.id === run?.rootNodeId);
+    const providerThread = projection.providerThreads.find(
+      (candidate) => candidate.id === run?.providerThreadId,
+    );
+    const preparationItem = projection.turnItems.find(
+      (
+        candidate,
+      ): candidate is Extract<OrchestrationV2TurnItem, { readonly type: "command_execution" }> =>
+        candidate.runId === command.runId &&
+        candidate.type === "command_execution" &&
+        candidate.input === WORKSPACE_PREPARATION_INPUT,
+    );
+    if (
+      run?.status !== "preparing" ||
+      attempt === undefined ||
+      rootNode === undefined ||
+      providerThread === undefined ||
+      preparationItem === undefined
+    ) {
+      return null;
+    }
+    return { run, attempt, rootNode, providerThread, preparationItem } as const;
+  };
+
+  const dispatchPreparedRunProgress = (
+    command: Extract<OrchestrationV2Command, { readonly type: "prepared-run.progress" }>,
+    events: Ref.Ref<Array<OrchestrationV2DomainEvent>>,
+  ) =>
+    Effect.gen(function* () {
+      const projection = yield* loadProjectionForCommand(command);
+      const state = preparedRunState(command, projection);
+      if (state === null) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Run ${command.runId} is not awaiting workspace preparation.`,
+        });
+      }
+      const now = yield* DateTime.now;
+      yield* emit(
+        events,
+        command,
+      )({
+        type: "turn-item.updated",
+        threadId: command.threadId,
+        runId: state.run.id,
+        nodeId: state.rootNode.id,
+        providerInstanceId: state.run.providerInstanceId,
+        occurredAt: now,
+        payload: {
+          ...state.preparationItem,
+          title: command.phase === "worktree" ? "Preparing worktree" : "Starting setup script",
+          updatedAt: now,
+        },
+      });
+    });
+
+  const dispatchPreparedRunRelease = (
+    command: Extract<OrchestrationV2Command, { readonly type: "prepared-run.release" }>,
+    events: Ref.Ref<Array<OrchestrationV2DomainEvent>>,
+    effects: Ref.Ref<Array<PendingOrchestrationEffectV2>>,
+  ) =>
+    Effect.gen(function* () {
+      const projection = yield* loadProjectionForCommand(command);
+      const state = preparedRunState(command, projection);
+      if (state === null) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Run ${command.runId} is not awaiting workspace preparation.`,
+        });
+      }
+      const now = yield* DateTime.now;
+      const resolvedRuntimePolicy = yield* runtimePolicy
+        .resolve({ thread: projection.thread, modelSelection: state.run.modelSelection })
+        .pipe(mapDispatchError(command));
+      const checkpointScope = yield* checkpointService
+        .prepareRootRunScope({
+          threadId: command.threadId,
+          runId: state.run.id,
+          rootNodeId: state.rootNode.id,
+          providerThreadId: state.providerThread.id,
+          cwd: resolvedRuntimePolicy.cwd ?? projection.thread.worktreePath ?? process.cwd(),
+          createdAt: now,
+        })
+        .pipe(mapDispatchError(command));
+      const emitEvent = emit(events, command);
+      yield* emitEvent({
+        type: "checkpoint-scope.created",
+        threadId: command.threadId,
+        runId: state.run.id,
+        nodeId: state.rootNode.id,
+        providerInstanceId: state.run.providerInstanceId,
+        occurredAt: now,
+        payload: checkpointScope,
+      });
+      yield* emitEvent({
+        type: "node.updated",
+        threadId: command.threadId,
+        runId: state.run.id,
+        nodeId: state.rootNode.id,
+        providerInstanceId: state.run.providerInstanceId,
+        occurredAt: now,
+        payload: { ...state.rootNode, checkpointScopeId: checkpointScope.id },
+      });
+      yield* emitEvent({
+        type: "turn-item.updated",
+        threadId: command.threadId,
+        runId: state.run.id,
+        nodeId: state.rootNode.id,
+        providerInstanceId: state.run.providerInstanceId,
+        occurredAt: now,
+        payload: {
+          ...state.preparationItem,
+          status: "completed",
+          title: "Workspace ready",
+          output: "Workspace preparation completed.",
+          exitCode: 0,
+          completedAt: now,
+          updatedAt: now,
+        },
+      });
+      yield* emitEvent({
+        type: "run.updated",
+        threadId: command.threadId,
+        runId: state.run.id,
+        nodeId: state.rootNode.id,
+        providerInstanceId: state.run.providerInstanceId,
+        occurredAt: now,
+        payload: { ...state.run, status: "starting" },
+      });
+      yield* Ref.update(effects, (existing) => [
+        ...existing,
+        {
+          id: `effect:${command.commandId}:provider-turn.start:${state.run.id}`,
+          commandId: command.commandId,
+          threadId: command.threadId,
+          request: { type: "provider-turn.start", runId: state.run.id },
+        } satisfies PendingOrchestrationEffectV2,
+      ]);
+    });
+
+  const dispatchPreparedRunFail = (
+    command: Extract<OrchestrationV2Command, { readonly type: "prepared-run.fail" }>,
+    events: Ref.Ref<Array<OrchestrationV2DomainEvent>>,
+  ) =>
+    Effect.gen(function* () {
+      const projection = yield* loadProjectionForCommand(command);
+      const state = preparedRunState(command, projection);
+      if (state === null) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Run ${command.runId} is not awaiting workspace preparation.`,
+        });
+      }
+      const now = yield* DateTime.now;
+      const emitEvent = emit(events, command);
+      yield* emitEvent({
+        type: "run-attempt.updated",
+        threadId: command.threadId,
+        runId: state.run.id,
+        nodeId: state.rootNode.id,
+        providerInstanceId: state.run.providerInstanceId,
+        occurredAt: now,
+        payload: { ...state.attempt, status: "failed", completedAt: now },
+      });
+      yield* emitEvent({
+        type: "node.updated",
+        threadId: command.threadId,
+        runId: state.run.id,
+        nodeId: state.rootNode.id,
+        providerInstanceId: state.run.providerInstanceId,
+        occurredAt: now,
+        payload: { ...state.rootNode, status: "failed", completedAt: now },
+      });
+      yield* emitEvent({
+        type: "turn-item.updated",
+        threadId: command.threadId,
+        runId: state.run.id,
+        nodeId: state.rootNode.id,
+        providerInstanceId: state.run.providerInstanceId,
+        occurredAt: now,
+        payload: {
+          ...state.preparationItem,
+          status: "failed",
+          title: "Workspace preparation failed",
+          output: command.failure.message,
+          exitCode: 1,
+          completedAt: now,
+          updatedAt: now,
+        },
+      });
+      yield* emitEvent({
+        type: "turn-item.updated",
+        threadId: command.threadId,
+        runId: state.run.id,
+        nodeId: state.rootNode.id,
+        providerInstanceId: state.run.providerInstanceId,
+        occurredAt: now,
+        payload: {
+          id: idAllocator.derive.turnItemFromProviderItem({
+            driver: state.providerThread.driver,
+            nativeItemId: `workspace-preparation-failure:${state.run.id}`,
+          }),
+          threadId: command.threadId,
+          runId: state.run.id,
+          nodeId: state.rootNode.id,
+          providerThreadId: state.providerThread.id,
+          providerTurnId: null,
+          nativeItemRef: null,
+          parentItemId: null,
+          ordinal: nextTurnItemOrdinal(projection),
+          status: "failed",
+          title: "Workspace preparation failed",
+          startedAt: now,
+          completedAt: now,
+          updatedAt: now,
+          type: "error",
+          failure: command.failure,
+        },
+      });
+      yield* emitEvent({
+        type: "run.updated",
+        threadId: command.threadId,
+        runId: state.run.id,
+        nodeId: state.rootNode.id,
+        providerInstanceId: state.run.providerInstanceId,
+        occurredAt: now,
+        payload: { ...state.run, status: "failed", completedAt: now },
+      });
+    });
+
+  const dispatchRunInterrupt = (
+    command: Extract<OrchestrationV2Command, { readonly type: "run.interrupt" }>,
+    events: Ref.Ref<Array<OrchestrationV2DomainEvent>>,
+    effects: Ref.Ref<Array<PendingOrchestrationEffectV2>>,
+  ) =>
+    Effect.gen(function* () {
+      const projection = yield* loadProjectionForCommand(command);
+      const run = projection.runs.find((candidate) => candidate.id === command.runId);
+      const rootNode =
+        run?.rootNodeId === null
+          ? undefined
+          : projection.nodes.find((candidate) => candidate.id === run?.rootNodeId);
+      const providerThread =
+        run?.providerThreadId === null
+          ? undefined
+          : projection.providerThreads.find((candidate) => candidate.id === run?.providerThreadId);
+      const providerTurn = projection.providerTurns.find(
+        (candidate) =>
+          candidate.runAttemptId === run?.activeAttemptId && candidate.status === "running",
+      );
+      if (run === undefined || rootNode === undefined || providerThread === undefined) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Run ${command.runId} is not interruptible.`,
+        });
+      }
+      const now = yield* DateTime.now;
+      const completionMessage = projection.messages.find(
+        (candidate) => candidate.id === run.userMessageId,
+      );
+      const completionCohortRunId = completionMessage?.delegatedCompletion?.parentRunId ?? run.id;
+      const stopCompletionCohort = () =>
+        Effect.gen(function* () {
+          yield* disposeDelegatedCompletionCohort({
+            command,
+            events,
+            projection: yield* getProjectionWithPendingEvents(command.threadId, events),
+            parentRunId: completionCohortRunId,
+            disposition: "stopped",
+            now,
+          });
+        });
+
+      const emitEvent = emit(events, command);
+      const interruptRequestItem: OrchestrationV2TurnItem = {
+        id: idAllocator.derive.runSignalTurnItem({
+          runId: run.id,
+          signal: "interrupt-request",
+        }),
+        threadId: command.threadId,
+        runId: run.id,
+        nodeId: rootNode.id,
+        providerThreadId: providerThread.id,
+        providerTurnId: providerTurn?.id ?? null,
+        nativeItemRef: null,
+        parentItemId: null,
+        ordinal: nextTurnItemOrdinal(projection),
+        status: "completed",
+        title: "Interrupt requested",
+        startedAt: now,
+        completedAt: now,
+        updatedAt: now,
+        type: "run_interrupt_request",
+        message: command.reason ?? "Interrupt requested",
+      };
+
+      if (
+        providerTurn === undefined &&
+        (run.status === "preparing" || run.status === "starting" || run.status === "running")
+      ) {
+        const attempt = projection.attempts.find(
+          (candidate) => candidate.id === run.activeAttemptId,
+        );
+        if (attempt === undefined) {
+          return yield* new OrchestratorDispatchError({
+            commandId: command.commandId,
+            commandType: command.type,
+            cause: `Run ${command.runId} has no active attempt to interrupt.`,
+          });
+        }
+        const interruptResultItem: OrchestrationV2TurnItem = {
+          id: idAllocator.derive.runSignalTurnItem({
+            runId: run.id,
+            signal: "interrupt-result",
+          }),
+          threadId: command.threadId,
+          runId: run.id,
+          nodeId: rootNode.id,
+          providerThreadId: providerThread.id,
+          providerTurnId: null,
+          nativeItemRef: null,
+          parentItemId: interruptRequestItem.id,
+          ordinal: interruptRequestItem.ordinal + 1,
+          status: "interrupted",
+          title: "Interrupted",
+          startedAt: now,
+          completedAt: now,
+          updatedAt: now,
+          type: "run_interrupt_result",
+          message: "Run interrupted before provider start",
+        };
+        yield* emitEvent({
+          type: "turn-item.updated",
+          threadId: command.threadId,
+          runId: run.id,
+          nodeId: rootNode.id,
+          providerInstanceId: run.providerInstanceId,
+          occurredAt: now,
+          payload: interruptRequestItem,
+        });
+        yield* emitEvent({
+          type: "turn-item.updated",
+          threadId: command.threadId,
+          runId: run.id,
+          nodeId: rootNode.id,
+          providerInstanceId: run.providerInstanceId,
+          occurredAt: now,
+          payload: interruptResultItem,
+        });
+        const preparationItem = projection.turnItems.find(
+          (
+            candidate,
+          ): candidate is Extract<
+            OrchestrationV2TurnItem,
+            { readonly type: "command_execution" }
+          > =>
+            candidate.runId === run.id &&
+            candidate.type === "command_execution" &&
+            candidate.input === WORKSPACE_PREPARATION_INPUT &&
+            candidate.status === "running",
+        );
+        if (preparationItem !== undefined) {
+          yield* emitEvent({
+            type: "turn-item.updated",
+            threadId: command.threadId,
+            runId: run.id,
+            nodeId: rootNode.id,
+            providerInstanceId: run.providerInstanceId,
+            occurredAt: now,
+            payload: {
+              ...preparationItem,
+              status: "interrupted",
+              title: "Workspace preparation interrupted",
+              output: command.reason ?? "Interrupted before provider start",
+              completedAt: now,
+              updatedAt: now,
+            },
+          });
+        }
+        yield* emitEvent({
+          type: "run-attempt.updated",
+          threadId: command.threadId,
+          runId: run.id,
+          nodeId: rootNode.id,
+          providerInstanceId: run.providerInstanceId,
+          occurredAt: now,
+          payload: { ...attempt, status: "interrupted", completedAt: now },
+        });
+        yield* emitEvent({
+          type: "node.updated",
+          threadId: command.threadId,
+          runId: run.id,
+          nodeId: rootNode.id,
+          providerInstanceId: run.providerInstanceId,
+          occurredAt: now,
+          payload: { ...rootNode, status: "interrupted", completedAt: now },
+        });
+        yield* emitEvent({
+          type: "run.updated",
+          threadId: command.threadId,
+          runId: run.id,
+          nodeId: rootNode.id,
+          providerInstanceId: run.providerInstanceId,
+          occurredAt: now,
+          payload: { ...run, status: "interrupted", completedAt: now },
+        });
+        yield* stopCompletionCohort();
+        return {
+          effectTypes: ["provider-turn.start", "provider-turn.restart"],
+          reason: `Run ${run.id} was interrupted before its provider turn started.`,
+        } satisfies {
+          readonly effectTypes: ReadonlyArray<OrchestrationEffectRequestV2["type"]>;
+          readonly reason: string;
+        };
+      }
+
+      if (providerTurn === undefined) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Run ${command.runId} is not interruptible.`,
+        });
+      }
+      if (providerThread.providerSessionId === null) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Provider thread ${providerThread.id} has no active provider session.`,
+        });
+      }
+      const providerSessionId = providerThread.providerSessionId;
+      const sessionOption = yield* providerSessions.get(providerSessionId).pipe(
+        Effect.mapError(
+          (cause) =>
+            new OrchestratorProviderAdapterError({
+              commandId: command.commandId,
+              providerInstanceId: run.providerInstanceId,
+              cause,
+            }),
+        ),
+      );
+      if (Option.isNone(sessionOption)) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Provider session ${providerThread.providerSessionId} is not active.`,
+        });
+      }
+      yield* enforceCommandPolicy(command)(
+        commandPolicy.ensureInterrupt({
+          commandId: command.commandId,
+          threadId: command.threadId,
+          providerInstanceId: run.providerInstanceId,
+          capabilities: sessionOption.value.providerSession.capabilities,
+        }),
+      );
+
+      /*
+       * TODO(interrupt-hardening): before shipping, make these interrupt
+       * semantics explicit in tests and policy.
+       *
+       * Current behavior:
+       * - emit a `run_interrupt_request` item as user intent;
+       * - call the provider interrupt RPC;
+       * - keep the run active and continue ingesting provider chunks;
+       * - let RunExecutionService emit `run_interrupt_result` only if the
+       *   provider later reports terminal status `interrupted`.
+       *
+       * Known scenarios we do not fully harden yet:
+       * - provider accepts interrupt, then emits more chunks before terminal;
+       * - provider accepts interrupt, then completes normally instead;
+       * - provider accepts interrupt but never terminalizes;
+       * - user queues, steers, or starts another message while the interrupted
+       *   provider turn is still active.
+       *
+       * Likely policy:
+       * - queue should wait behind the still-active provider turn;
+       * - explicit steer may target the active turn if provider steering is
+       *   supported;
+       * - starting a new root turn before provider terminalization should be
+       *   an explicit policy decision because it can weaken native-item
+       *   correlation.
+       */
+      yield* emitEvent({
+        type: "turn-item.updated",
+        threadId: command.threadId,
+        runId: run.id,
+        nodeId: rootNode.id,
+        providerInstanceId: run.providerInstanceId,
+        occurredAt: now,
+        payload: interruptRequestItem,
+      });
+      yield* stopCompletionCohort();
+      yield* Ref.update(effects, (existing) => [
+        ...existing,
+        {
+          id: `effect:${command.commandId}:provider-turn.interrupt:${providerTurn.id}`,
+          commandId: command.commandId,
+          threadId: command.threadId,
+          request: {
+            type: "provider-turn.interrupt",
+            providerSessionId,
+            providerThreadId: providerThread.id,
+            providerTurnId: providerTurn.id,
+          },
+        } satisfies PendingOrchestrationEffectV2,
+      ]);
+      return undefined;
+    });
+
+  const dispatchCheckpointRollback = (
+    command: Extract<OrchestrationV2Command, { readonly type: "checkpoint.rollback" }>,
+    events: Ref.Ref<Array<OrchestrationV2DomainEvent>>,
+    effects: Ref.Ref<Array<PendingOrchestrationEffectV2>>,
+  ) =>
+    Effect.gen(function* () {
+      const projection = yield* loadProjectionForCommand(command);
+      const providerThread = projection.providerThreads.find(
+        (candidate) => candidate.id === projection.thread.activeProviderThreadId,
+      );
+      if (providerThread === undefined) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: "No active provider thread exists for rollback.",
+        });
+      }
+      if (providerThread.providerSessionId === null) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Provider thread ${providerThread.id} has no provider session.`,
+        });
+      }
+
+      const modelSelection = projection.thread.modelSelection;
+      const capabilities = yield* providerAdapters.get(modelSelection.instanceId).pipe(
+        Effect.flatMap((adapter) => adapter.getCapabilities()),
+        Effect.mapError(
+          (cause) =>
+            new OrchestratorProviderAdapterError({
+              commandId: command.commandId,
+              providerInstanceId: modelSelection.instanceId,
+              cause,
+            }),
+        ),
+      );
+      yield* enforceCommandPolicy(command)(
+        commandPolicy.ensureRollback({
+          commandId: command.commandId,
+          threadId: command.threadId,
+          providerInstanceId: modelSelection.instanceId,
+          capabilities,
+        }),
+      );
+
+      const targetCheckpoint = projection.checkpoints.find(
+        (candidate) => candidate.id === command.checkpointId,
+      );
+      if (targetCheckpoint === undefined) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Checkpoint ${command.checkpointId} was not found.`,
+        });
+      }
+      const targetScope = projection.checkpointScopes.find(
+        (candidate) => candidate.id === targetCheckpoint.scopeId,
+      );
+      if (targetScope === undefined) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Checkpoint scope ${targetCheckpoint.scopeId} was not found.`,
+        });
+      }
+      if (targetScope.id !== command.scopeId) {
+        return yield* new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: `Checkpoint ${command.checkpointId} belongs to scope ${targetScope.id}, not ${command.scopeId}.`,
+        });
+      }
+      const targetOrdinal = targetCheckpoint.appRunOrdinal ?? 0;
+      if (targetOrdinal > 0) {
+        const targetRun = projection.runs.find((run) => run.ordinal === targetOrdinal);
+        const targetProviderTurn =
+          targetRun === undefined ? undefined : providerTurnForRun(projection, targetRun);
+        if (targetRun === undefined || targetProviderTurn === undefined) {
+          return yield* new OrchestratorDispatchError({
+            commandId: command.commandId,
+            commandType: command.type,
+            cause: `Cannot roll back to checkpoint ${targetCheckpoint.id}: its provider turn is unavailable.`,
+          });
+        }
+        if (targetProviderTurn.providerThreadId !== providerThread.id) {
+          return yield* new OrchestratorDispatchError({
+            commandId: command.commandId,
+            commandType: command.type,
+            cause: `Cannot roll back provider thread ${providerThread.id} to checkpoint ${targetCheckpoint.id}: target provider turn ${targetProviderTurn.id} belongs to provider thread ${targetProviderTurn.providerThreadId}.`,
+          });
+        }
+      }
+
+      const now = yield* DateTime.now;
+      yield* emit(
+        events,
+        command,
+      )({
+        type: "checkpoint.rollback-requested",
+        threadId: command.threadId,
+        providerInstanceId: modelSelection.instanceId,
+        occurredAt: now,
+        payload: {
+          scopeId: targetScope.id,
+          checkpointId: targetCheckpoint.id,
+          requestedAt: now,
+        },
+      });
+      yield* Ref.update(effects, (existing) => [
+        ...existing,
+        {
+          id: `effect:${command.commandId}:provider-thread.rollback:${providerThread.id}:${targetCheckpoint.id}`,
+          commandId: command.commandId,
+          threadId: command.threadId,
+          request: {
+            type: "provider-thread.rollback",
+            providerThreadId: providerThread.id,
+            checkpointId: targetCheckpoint.id,
+            scopeId: targetScope.id,
+          },
+        } satisfies PendingOrchestrationEffectV2,
+      ]);
+    });
+
+  /**
+   * Parent thread of an app-owned delegated child, or undefined when the
+   * thread is not one. Thread lineage and fork origin are immutable, so this
+   * is safe to read without holding either thread's dispatch lock.
+   */
+  const appOwnedSubagentParentThreadId = (childThreadId: ThreadId) =>
+    Effect.gen(function* () {
+      const childProjection = yield* projectionStore.getThreadProjection(childThreadId);
+      const lineage = childProjection.thread.lineage;
+      return lineage.relationshipToParent === "subagent" &&
+        lineage.parentThreadId !== null &&
+        childProjection.thread.forkedFrom?.type === "node"
+        ? lineage.parentThreadId
+        : undefined;
+    });
+
+  const planDelegatedCompletionDelivery = Effect.fn(
+    "orchestrationV2.planDelegatedCompletionDelivery",
+  )(function* (input: {
+    readonly parentProjection: OrchestrationV2ThreadProjection;
+    readonly parentRun: OrchestrationV2Run | undefined;
+    readonly task: OrchestrationV2Subagent;
+    readonly updatedTask: OrchestrationV2Subagent;
+    readonly now: DateTime.Utc;
+  }) {
+    const taskDelivery = input.updatedTask.completionDelivery;
+    // delivered ownership has already settled through a completed wake run.
+    // A later wake-policy upgrade must not re-claim the task or offer again.
+    if (
+      taskDelivery?.state === "acknowledged" ||
+      taskDelivery?.state === "delivered" ||
+      taskDelivery?.state === "disposed"
+    ) {
+      return {
+        task: input.updatedTask,
+        parentRun: undefined,
+        message: undefined,
+        offer: false,
+      };
+    }
+    const cohort = input.parentRun?.delegatedCompletion;
+    if (
+      input.parentRun === undefined ||
+      input.parentProjection.thread.archivedAt !== null ||
+      input.parentProjection.thread.deletedAt !== null ||
+      (cohort !== undefined && cohort.disposition !== "open")
+    ) {
+      return {
+        task: {
+          ...input.updatedTask,
+          completionDelivery: {
+            state: "disposed" as const,
+            observedByRunId: null,
+          },
+        },
+        parentRun: undefined,
+        message: undefined,
+        offer: false,
+      };
+    }
+    if (
+      (input.task.completionWake ?? "settled_only") === "settled_only" &&
+      hasLiveRun(input.parentProjection)
+    ) {
+      return {
+        task: input.updatedTask,
+        parentRun: undefined,
+        message: undefined,
+        offer: false,
+      };
+    }
+
+    const delivery = cohort?.delivery ?? null;
+    const deliveryRun = completionDeliveryRun(input.parentProjection, delivery);
+    if (delivery !== null) {
+      if (deliveryRun?.status === "queued") {
+        const taskIds = Array.from(new Set([...delivery.taskIds, input.task.id]));
+        const message = completionDeliveryMessage(input.parentProjection, delivery);
+        const nextCohort = {
+          ...cohort!,
+          delivery: {
+            ...delivery,
+            taskIds,
+          },
+        };
+        return {
+          task: {
+            ...input.updatedTask,
+            completionDelivery: {
+              state: "claimed" as const,
+              observedByRunId: null,
+            },
+          },
+          parentRun: {
+            ...input.parentRun,
+            delegatedCompletion: nextCohort,
+          },
+          message:
+            message === undefined
+              ? undefined
+              : {
+                  ...message,
+                  text: delegatedCompletionWakeDetail(taskIds),
+                  delegatedCompletion: {
+                    parentRunId: input.parentRun.id,
+                    generation: delivery.generation,
+                    taskIds,
+                  },
+                  updatedAt: input.now,
+                },
+          offer: false,
+        };
+      }
+      if (deliveryRun !== undefined && isBlockingRun(deliveryRun)) {
+        return {
+          task: {
+            ...input.updatedTask,
+            completionDelivery: {
+              state: "pending" as const,
+              observedByRunId: null,
+            },
+          },
+          parentRun: undefined,
+          message: undefined,
+          offer: false,
+        };
+      }
+      if (deliveryRun !== undefined) {
+        // The terminal-run listener owns reconciliation of a completed wake.
+        // A sibling that wins the parent lock first remains pending for its
+        // one successor rather than creating a competing delivery.
+        return {
+          task: {
+            ...input.updatedTask,
+            completionDelivery: {
+              state: "pending" as const,
+              observedByRunId: null,
+            },
+          },
+          parentRun: undefined,
+          message: undefined,
+          offer: false,
+        };
+      }
+      const taskIds = Array.from(new Set([...delivery.taskIds, input.task.id]));
+      const nextCohort = {
+        ...cohort!,
+        delivery: {
+          ...delivery,
+          taskIds,
+        },
+      };
+      return {
+        task: {
+          ...input.updatedTask,
+          completionDelivery: {
+            state: "claimed" as const,
+            observedByRunId: null,
+          },
+        },
+        parentRun: {
+          ...input.parentRun,
+          delegatedCompletion: nextCohort,
+        },
+        message: undefined,
+        offer: true,
+      };
+    }
+
+    const settledDeliveryCount = cohort?.settledDeliveryCount ?? 0;
+    if (settledDeliveryCount >= 2) {
+      // A cohort permits one initial delivery and one successor. Keep the
+      // result pending and inspectable instead of recursively re-arming the
+      // parent for every child that finishes after that bounded handoff.
+      return {
+        task: {
+          ...input.updatedTask,
+          completionDelivery: {
+            state: "pending" as const,
+            observedByRunId: null,
+          },
+        },
+        parentRun: undefined,
+        message: undefined,
+        offer: false,
+      };
+    }
+    const generation = cohort?.nextGeneration ?? 1;
+    const messageId = yield* mapDelegatedCompletionError(
+      idAllocator.allocate.message({
+        threadId: input.parentRun.threadId,
+        ordinal: input.parentProjection.messages.length + 1,
+      }),
+    );
+    const nextCohort = {
+      disposition: "open" as const,
+      nextGeneration: generation + 1,
+      settledDeliveryCount,
+      delivery: {
+        generation,
+        messageId,
+        taskIds: [input.task.id],
+      },
+    };
+    return {
+      task: {
+        ...input.updatedTask,
+        completionDelivery: {
+          state: "claimed" as const,
+          observedByRunId: null,
+        },
+      },
+      parentRun: {
+        ...input.parentRun,
+        delegatedCompletion: nextCohort,
+      },
+      message: undefined,
+      offer: true,
+    };
+  });
+
+  /**
+   * Transfers a terminal child's result into its parent and offers the parent
+   * wake. Every mutation here targets the PARENT thread, so callers must hold
+   * the parent thread's dispatch lock rather than the child's: the
+   * delegated_task.wake-policy handler rewrites the same subagent row under
+   * that lock with a full-row payload, and unserialized writers clobber each
+   * other (stale policy on the terminal row, or a terminal row regressed to
+   * running).
+   */
+  const finalizeAppOwnedSubagent = (childThreadId: ThreadId) =>
+    Effect.gen(function* () {
+      const childProjection = yield* projectionStore.getThreadProjection(childThreadId);
+      const forkedFrom = childProjection.thread.forkedFrom;
+      if (
+        childProjection.thread.lineage.relationshipToParent !== "subagent" ||
+        childProjection.thread.lineage.parentThreadId === null ||
+        forkedFrom?.type !== "node"
+      ) {
+        return;
+      }
+      const childRun = childProjection.runs[0];
+      if (childRun === undefined) {
+        return;
+      }
+      const terminalStatus = delegatedTaskTerminalStatus(childRun.status);
+      if (terminalStatus === null) {
+        return;
+      }
+
+      const parentThreadId = childProjection.thread.lineage.parentThreadId;
+      const parentProjection = yield* projectionStore.getThreadProjection(parentThreadId);
+      const task = parentProjection.subagents.find(
+        (candidate) =>
+          candidate.id === forkedFrom.nodeId &&
+          candidate.origin === "app_owned" &&
+          candidate.childThreadId === childThreadId,
+      );
+      if (task === undefined) {
+        return;
+      }
+      const existingResultTransfer = parentProjection.contextTransfers.find(
+        (transfer) =>
+          transfer.type === "subagent_result" &&
+          transfer.sourceThreadId === childThreadId &&
+          transfer.targetThreadId === parentThreadId,
+      );
+      if (existingResultTransfer !== undefined) {
+        return;
+      }
+
+      const now = yield* DateTime.now;
+      const result = subagentResultForRun(childProjection, childRun);
+      const parentRun =
+        task.runId === null
+          ? undefined
+          : parentProjection.runs.find((candidate) => candidate.id === task.runId);
+      const parentNode = parentProjection.nodes.find((candidate) => candidate.id === task.id);
+      const parentTurnItem = parentProjection.turnItems.find(
+        (candidate) => candidate.type === "subagent" && candidate.subagentId === task.id,
+      );
+      const updatedTask: OrchestrationV2Subagent = {
+        ...task,
+        providerThreadId: childRun.providerThreadId,
+        status: terminalStatus,
+        result: result.text,
+        completedAt: now,
+        updatedAt: now,
+      };
+      const completionPlan = yield* planDelegatedCompletionDelivery({
+        parentProjection,
+        parentRun,
+        task,
+        updatedTask,
+        now,
+      });
+      const resultTransferId = yield* idAllocator.allocate.contextTransfer({
+        sourceThreadId: childThreadId,
+        targetThreadId: parentThreadId,
+        type: "subagent_result",
+      });
+      const childProviderThread =
+        childRun.providerThreadId === null
+          ? undefined
+          : childProjection.providerThreads.find(
+              (candidate) => candidate.id === childRun.providerThreadId,
+            );
+      const parentProviderThread =
+        parentRun?.providerThreadId === null || parentRun?.providerThreadId === undefined
+          ? undefined
+          : parentProjection.providerThreads.find(
+              (candidate) => candidate.id === parentRun.providerThreadId,
+            );
+      const resultHandoff: OrchestrationV2ContextHandoff | null =
+        parentRun === undefined ||
+        childProviderThread === undefined ||
+        parentProviderThread === undefined
+          ? null
+          : {
+              id: yield* idAllocator.allocate.contextHandoff({
+                threadId: parentThreadId,
+                fromProviderInstanceId: childRun.providerInstanceId,
+                toProviderInstanceId: parentRun.providerInstanceId,
+              }),
+              transferId: resultTransferId,
+              threadId: parentThreadId,
+              targetRunId: parentRun.id,
+              fromProviderThreadIds: [childProviderThread.id],
+              toProviderThreadId: parentProviderThread.id,
+              coveredRunOrdinals: {
+                from: childRun.ordinal,
+                to: childRun.ordinal,
+              },
+              strategy: "manual_context",
+              status: "ready",
+              summaryMessageId: result.messageId,
+              summaryText: result.text,
+              createdByProviderInstanceId: childRun.providerInstanceId,
+              createdAt: now,
+              updatedAt: now,
+            };
+      const resultTransfer: OrchestrationV2ContextTransfer = {
+        id: resultTransferId,
+        type: "subagent_result",
+        sourceThreadId: childThreadId,
+        targetThreadId: parentThreadId,
+        sourcePoint: {
+          ...contextSourcePointForRun(childProjection, childRun),
+          ...(result.turnItemId === null ? {} : { turnItemId: result.turnItemId }),
+        },
+        basePoint: null,
+        sourceProviderInstanceId: childRun.providerInstanceId,
+        targetProviderInstanceId:
+          parentRun?.providerInstanceId ?? parentProjection.thread.providerInstanceId,
+        targetRunId: parentRun?.id ?? null,
+        status: "consumed",
+        resolution:
+          resultHandoff === null
+            ? null
+            : {
+                strategy: "portable_context",
+                contextHandoffId: resultHandoff.id,
+              },
+        createdBy: "system",
+        error: null,
+        createdAt: now,
+        updatedAt: now,
+        consumedAt: now,
+      };
+
+      yield* writeSystemEvents([
+        {
+          type: "subagent.updated",
+          threadId: parentThreadId,
+          ...(task.runId === null ? {} : { runId: task.runId }),
+          nodeId: task.id,
+          driver: task.driver,
+          occurredAt: now,
+          payload: completionPlan.task,
+        },
+        ...(completionPlan.parentRun === undefined
+          ? []
+          : [
+              {
+                type: "run.updated" as const,
+                threadId: parentThreadId,
+                runId: completionPlan.parentRun.id,
+                ...(completionPlan.parentRun.rootNodeId === null
+                  ? {}
+                  : { nodeId: completionPlan.parentRun.rootNodeId }),
+                providerInstanceId: completionPlan.parentRun.providerInstanceId,
+                occurredAt: now,
+                payload: completionPlan.parentRun,
+              },
+            ]),
+        ...(completionPlan.message === undefined
+          ? []
+          : [
+              {
+                type: "message.updated" as const,
+                threadId: parentThreadId,
+                ...(completionPlan.message.runId === null
+                  ? {}
+                  : { runId: completionPlan.message.runId }),
+                ...(completionPlan.message.nodeId === null
+                  ? {}
+                  : { nodeId: completionPlan.message.nodeId }),
+                providerInstanceId:
+                  completionPlan.parentRun?.providerInstanceId ??
+                  parentProjection.thread.providerInstanceId,
+                occurredAt: now,
+                payload: completionPlan.message,
+              },
+            ]),
+        ...(parentNode === undefined
+          ? []
+          : [
+              {
+                type: "node.updated" as const,
+                threadId: parentThreadId,
+                ...(parentNode.runId === null ? {} : { runId: parentNode.runId }),
+                nodeId: parentNode.id,
+                driver: task.driver,
+                occurredAt: now,
+                payload: {
+                  ...parentNode,
+                  status: terminalStatus,
+                  providerThreadId: childRun.providerThreadId,
+                  completedAt: now,
+                },
+              },
+            ]),
+        ...(parentTurnItem === undefined
+          ? []
+          : [
+              {
+                type: "turn-item.updated" as const,
+                threadId: parentThreadId,
+                ...(parentTurnItem.runId === null ? {} : { runId: parentTurnItem.runId }),
+                ...(parentTurnItem.nodeId === null ? {} : { nodeId: parentTurnItem.nodeId }),
+                driver: task.driver,
+                occurredAt: now,
+                payload: {
+                  ...parentTurnItem,
+                  status: terminalStatus,
+                  result: result.text,
+                  completedAt: now,
+                  updatedAt: now,
+                },
+              },
+            ]),
+        ...(resultHandoff === null
+          ? []
+          : [
+              {
+                type: "context-handoff.updated" as const,
+                threadId: parentThreadId,
+                ...(parentRun === undefined ? {} : { runId: parentRun.id }),
+                providerInstanceId: childRun.providerInstanceId,
+                occurredAt: now,
+                payload: resultHandoff,
+              },
+            ]),
+        {
+          type: "context-transfer.created",
+          threadId: parentThreadId,
+          ...(parentRun === undefined ? {} : { runId: parentRun.id }),
+          providerInstanceId: childRun.providerInstanceId,
+          occurredAt: now,
+          payload: resultTransfer,
+        },
+      ]);
+
+      if (completionPlan.offer && completionPlan.parentRun !== undefined) {
+        yield* offerDelegatedCompletionDelivery(parentThreadId, completionPlan.parentRun.id);
+      }
+    });
+
+  const finalizeDelegatedCompletionDelivery = (threadId: ThreadId, runId: RunId) =>
+    Effect.gen(function* () {
+      const projection = yield* projectionStore.getThreadProjection(threadId);
+      const deliveryRun = projection.runs.find((candidate) => candidate.id === runId);
+      const deliveryMessage =
+        deliveryRun === undefined
+          ? undefined
+          : projection.messages.find((candidate) => candidate.id === deliveryRun.userMessageId);
+      const messageOwnership = deliveryMessage?.delegatedCompletion;
+      if (deliveryRun === undefined || messageOwnership === undefined) {
+        return;
+      }
+      const parentRun = projection.runs.find(
+        (candidate) => candidate.id === messageOwnership.parentRunId,
+      );
+      const cohort = parentRun?.delegatedCompletion;
+      const delivery = cohort?.delivery;
+      if (
+        parentRun === undefined ||
+        cohort === undefined ||
+        delivery === null ||
+        delivery === undefined ||
+        delivery.messageId !== deliveryRun.userMessageId ||
+        delivery.generation !== messageOwnership.generation
+      ) {
+        return;
+      }
+
+      const now = yield* DateTime.now;
+      const nextTaskStates = new Map<
+        OrchestrationV2Subagent["id"],
+        OrchestrationV2Subagent["completionDelivery"]
+      >();
+      for (const task of projection.subagents) {
+        if (
+          task.origin !== "app_owned" ||
+          task.runId !== parentRun.id ||
+          !delivery.taskIds.includes(task.id) ||
+          task.completionDelivery?.state !== "claimed"
+        ) {
+          continue;
+        }
+        nextTaskStates.set(task.id, {
+          state: deliveryRun.status === "cancelled" ? "pending" : "delivered",
+          observedByRunId: null,
+        });
+      }
+      const pendingTaskIds = projection.subagents
+        .filter(
+          (task) =>
+            task.origin === "app_owned" &&
+            task.runId === parentRun.id &&
+            isTerminalDelegatedTaskStatus(task.status) &&
+            (task.completionDelivery?.state === "pending" ||
+              nextTaskStates.get(task.id)?.state === "pending"),
+        )
+        .map((task) => task.id);
+      const settledDeliveryCount = (cohort.settledDeliveryCount ?? 0) + 1;
+      const canReserveFollowUp =
+        cohort.disposition === "open" &&
+        projection.thread.archivedAt === null &&
+        projection.thread.deletedAt === null &&
+        settledDeliveryCount < 2 &&
+        pendingTaskIds.length > 0;
+      const nextDelivery = canReserveFollowUp
+        ? {
+            generation: cohort.nextGeneration,
+            messageId: yield* mapDelegatedCompletionError(
+              idAllocator.allocate.message({
+                threadId,
+                ordinal: projection.messages.length + 1,
+              }),
+            ),
+            taskIds: pendingTaskIds,
+          }
+        : null;
+      if (nextDelivery !== null) {
+        for (const taskId of pendingTaskIds) {
+          nextTaskStates.set(taskId, {
+            state: "claimed",
+            observedByRunId: null,
+          });
+        }
+      }
+      const updatedParentRun: OrchestrationV2Run = {
+        ...parentRun,
+        delegatedCompletion: {
+          ...cohort,
+          settledDeliveryCount,
+          nextGeneration: nextDelivery === null ? cohort.nextGeneration : cohort.nextGeneration + 1,
+          delivery: nextDelivery,
+        },
+      };
+      const taskEvents = projection.subagents.flatMap((task) => {
+        const completionDelivery = nextTaskStates.get(task.id);
+        if (completionDelivery === undefined) {
+          return [];
+        }
+        return [
+          {
+            type: "subagent.updated" as const,
+            threadId,
+            ...(task.runId === null ? {} : { runId: task.runId }),
+            nodeId: task.id,
+            driver: task.driver,
+            providerInstanceId: task.providerInstanceId,
+            occurredAt: now,
+            payload: {
+              ...task,
+              completionDelivery,
+              updatedAt: now,
+            },
+          },
+        ];
+      });
+      yield* writeSystemEvents([
+        ...taskEvents,
+        {
+          type: "run.updated",
+          threadId,
+          runId: updatedParentRun.id,
+          ...(updatedParentRun.rootNodeId === null ? {} : { nodeId: updatedParentRun.rootNodeId }),
+          providerInstanceId: updatedParentRun.providerInstanceId,
+          occurredAt: now,
+          payload: updatedParentRun,
+        },
+      ]);
+      if (nextDelivery !== null) {
+        yield* offerDelegatedCompletionDelivery(threadId, parentRun.id);
+      }
+    });
+
+  const dispatchUnsupported = (command: OrchestrationV2Command) =>
+    Effect.fail(
+      new OrchestratorDispatchError({
+        commandId: command.commandId,
+        commandType: command.type,
+      }),
+    );
+
+  const dispatchOnce = Effect.fn("orchestrationV2.dispatch.once")(function* (
+    command: OrchestrationV2Command,
+  ): Effect.fn.Return<
+    {
+      readonly events: ReadonlyArray<OrchestrationV2DomainEvent>;
+      readonly effects: ReadonlyArray<PendingOrchestrationEffectV2>;
+      readonly cancelUnsettledEffects?: {
+        readonly effectTypes: ReadonlyArray<OrchestrationEffectRequestV2["type"]>;
+        readonly reason: string;
+      };
+    },
+    OrchestratorV2Error
+  > {
+    yield* Effect.annotateCurrentSpan({
+      "orchestration_v2.command_id": command.commandId,
+      "orchestration_v2.command_type": command.type,
+      "orchestration_v2.thread_id": commandThreadId(command),
+    });
+
+    const events = yield* Ref.make<Array<OrchestrationV2DomainEvent>>([]);
+    const effects = yield* Ref.make<Array<PendingOrchestrationEffectV2>>([]);
+    let cancelUnsettledEffects:
+      | {
+          readonly effectTypes: ReadonlyArray<OrchestrationEffectRequestV2["type"]>;
+          readonly reason: string;
+        }
+      | undefined;
+    switch (command.type) {
+      case "thread.create":
+        yield* dispatchThreadCreate(command, events);
+        break;
+      case "thread.archive":
+      case "thread.unarchive":
+      case "thread.delete":
+      case "thread.settle":
+      case "thread.unsettle":
+      case "thread.snooze":
+      case "thread.unsnooze":
+      case "thread.pin":
+      case "thread.unpin":
+      case "thread.pin.reorder":
+      case "thread.visit":
+      case "thread.mark-unread":
+      case "thread.metadata.update":
+      case "thread.title.regeneration.complete":
+      case "thread.runtime-mode.set":
+      case "thread.interaction-mode.set":
+      case "thread.model-selection.set":
+      case "provider.switch":
+        yield* dispatchThreadMutation(command, events, effects);
+        break;
+      case "provider-session.detach":
+        yield* dispatchProviderSessionDetach(command, events, effects);
+        break;
+      case "message.dispatch":
+        yield* dispatchMessage(command, events, effects);
+        break;
+      case "prepared-run.release":
+        yield* dispatchPreparedRunRelease(command, events, effects);
+        break;
+      case "prepared-run.progress":
+        yield* dispatchPreparedRunProgress(command, events);
+        break;
+      case "prepared-run.fail":
+        yield* dispatchPreparedRunFail(command, events);
+        break;
+      case "runtime-request.respond":
+        yield* dispatchRuntimeRequestRespond(command, events, effects);
+        break;
+      case "run.interrupt":
+        cancelUnsettledEffects = yield* dispatchRunInterrupt(command, events, effects);
+        break;
+      case "queued-message.promote-to-steer":
+        yield* dispatchQueuedMessagePromoteToSteer(command, events, effects);
+        break;
+      case "queued-run.reorder":
+        yield* dispatchQueuedRunReorder(command, events);
+        break;
+      case "queued-run.cancel":
+        yield* dispatchQueuedRunCancel(command, events);
+        break;
+      case "queued-run.edit":
+        yield* dispatchQueuedRunEdit(command, events);
+        break;
+      case "checkpoint.rollback":
+        yield* dispatchCheckpointRollback(command, events, effects);
+        break;
+      case "thread.fork":
+        yield* dispatchThreadFork(command, events);
+        break;
+      case "thread.merge_back":
+        yield* dispatchThreadMergeBack(command, events);
+        break;
+      case "delegated_task.request":
+        yield* dispatchDelegatedTaskRequest(command, events, effects);
+        break;
+      case "delegated_task.wake-policy":
+        yield* dispatchDelegatedTaskWakePolicy(command, events);
+        break;
+      case "delegated_task.completion-delivery.acknowledge":
+      case "delegated_task.completion-delivery.dispose":
+        yield* dispatchDelegatedTaskCompletionDeliveryResolution(command, events);
+        break;
+      case "thread.created.record":
+        yield* dispatchCreatedThreadRecord(command, events);
+        break;
+      default:
+        return yield* dispatchUnsupported(command);
+    }
+    return {
+      events: yield* Ref.get(events),
+      effects: yield* Ref.get(effects),
+      ...(cancelUnsettledEffects === undefined ? {} : { cancelUnsettledEffects }),
+    };
+  });
+
+  const dispatchWithReceiptEffect = Effect.fn("orchestrationV2.dispatch.withReceipt")(function* (
+    command: OrchestrationV2Command,
+  ): Effect.fn.Return<OrchestratorV2DispatchResult, OrchestratorV2Error> {
+    yield* Effect.annotateCurrentSpan({
+      "orchestration_v2.command_id": command.commandId,
+      "orchestration_v2.command_type": command.type,
+      "orchestration_v2.thread_id": commandThreadId(command),
+    });
+
+    const existingReceipt = yield* commandReceipts.getByCommandId(command.commandId).pipe(
+      Effect.mapError(
+        (cause) =>
+          new OrchestratorDispatchError({
+            commandId: command.commandId,
+            commandType: command.type,
+            cause,
+          }),
+      ),
+    );
+
+    if (Option.isSome(existingReceipt)) {
+      const receipt = existingReceipt.value;
+      if (receipt.status === "rejected") {
+        return yield* new OrchestratorCommandPreviouslyRejectedError({
+          commandId: command.commandId,
+          commandType: command.type,
+          detail: receipt.error ?? "Previously rejected.",
+        });
+      }
+      // A receipt only proves this exact command was handled for its own
+      // thread. Replaying it for a command aimed at another thread would
+      // report success for work that never happened.
+      const dispatchThreadId = commandThreadId(command);
+      if (!canReplayCommandReceipt(receipt.threadId, dispatchThreadId)) {
+        return yield* new OrchestratorCommandIdConflictError({
+          commandId: command.commandId,
+          commandType: command.type,
+          receiptThreadId: receipt.threadId,
+          commandThreadId: dispatchThreadId,
+        });
+      }
+      const storedEvents = yield* eventSink.readByCommandId({ commandId: command.commandId }).pipe(
+        Stream.runCollect,
+        Effect.map((events): ReadonlyArray<OrchestrationV2StoredEvent> => Array.from(events)),
+        Effect.mapError(
+          (cause) =>
+            new OrchestratorDispatchError({
+              commandId: command.commandId,
+              commandType: command.type,
+              cause,
+            }),
+        ),
+      );
+      return {
+        sequence: receipt.resultSequence,
+        storedEvents,
+      } satisfies OrchestratorV2DispatchResult;
+    }
+
+    const plan = yield* dispatchOnce(command).pipe(
+      Effect.flatMap((planned) =>
+        planned.events.length > 0
+          ? Effect.succeed(planned)
+          : Effect.fail(
+              new OrchestratorDispatchError({
+                commandId: command.commandId,
+                commandType: command.type,
+                cause: "Command produced no domain events.",
+              }),
+            ),
+      ),
+      Effect.catch((cause) =>
+        Effect.gen(function* () {
+          const rejectedAt = yield* DateTime.now;
+          yield* eventSink
+            .commitRejectedCommand({
+              commandId: command.commandId,
+              threadId: commandThreadId(command),
+              commandType: command.type,
+              rejectedAt,
+              error: cause instanceof Error ? cause.message : String(cause),
+            })
+            .pipe(
+              Effect.mapError(
+                (receiptCause) =>
+                  new OrchestratorDispatchError({
+                    commandId: command.commandId,
+                    commandType: command.type,
+                    cause: receiptCause,
+                  }),
+              ),
+            );
+          return yield* cause;
+        }),
+      ),
+    );
+
+    const acceptedAt = plan.events.at(-1)?.occurredAt ?? (yield* DateTime.now);
+    const committed = yield* eventSink
+      .commitCommand({
+        commandId: command.commandId,
+        threadId: commandThreadId(command),
+        commandType: command.type,
+        acceptedAt,
+        events: plan.events,
+        effects: plan.effects,
+        ...(plan.cancelUnsettledEffects === undefined
+          ? {}
+          : { cancelUnsettledEffects: plan.cancelUnsettledEffects }),
+      })
+      .pipe(
+        Effect.mapError(
+          (cause) =>
+            new OrchestratorDispatchError({
+              commandId: command.commandId,
+              commandType: command.type,
+              cause,
+            }),
+        ),
+      );
+
+    if (committed.receipt.status === "rejected") {
+      return yield* new OrchestratorCommandPreviouslyRejectedError({
+        commandId: command.commandId,
+        commandType: command.type,
+        detail: committed.receipt.error ?? "Previously rejected.",
+      });
+    }
+    if (command.type === "delegated_task.wake-policy") {
+      yield* mapDispatchError(command)(offerDelegatedCompletionDeliveries(command.parentThreadId));
+    }
+
+    return {
+      sequence: committed.receipt.resultSequence,
+      storedEvents: committed.storedEvents,
+    } satisfies OrchestratorV2DispatchResult;
+  });
+
+  const dispatchWithReceipt = (command: OrchestrationV2Command) =>
+    threadDispatch.withLock(commandThreadId(command), dispatchWithReceiptEffect(command));
+
+  const handleTerminalRun = (stored: OrchestrationV2StoredEvent) =>
+    Effect.gen(function* () {
+      const threadId = stored.event.threadId;
+      // finalize writes the parent thread and startNextQueuedRun writes this
+      // thread, so each takes its own thread's lock, sequentially and never
+      // nested: dispatchDelegatedTaskRequest already writes child events
+      // while holding the parent lock, so nesting the parent lock inside the
+      // child lock here would invert that order, and the keyed executor's
+      // semaphores are neither reentrant nor deadlock-aware.
+      const parentThreadId = yield* appOwnedSubagentParentThreadId(threadId);
+      if (parentThreadId !== undefined) {
+        yield* threadDispatch.withLock(parentThreadId, finalizeAppOwnedSubagent(threadId));
+      }
+      if (stored.event.type === "run.updated") {
+        yield* threadDispatch.withLock(
+          threadId,
+          finalizeDelegatedCompletionDelivery(threadId, stored.event.payload.id),
+        );
+      }
+      yield* threadDispatch.withLock(threadId, startNextQueuedRun(threadId));
+    }).pipe(
+      Effect.catchCause((cause) =>
+        Effect.logWarning("Failed to react to terminal V2 run", {
+          threadId: stored.event.threadId,
+          sequence: stored.sequence,
+          cause,
+        }),
+      ),
+    );
+
+  // Historical terminal events are already represented by the projections
+  // below. Replaying the full event table on every server start delays live
+  // queue promotion in proportion to the lifetime size of the database.
+  const terminalEventsAfterSequence = yield* eventSink.latestSequence().pipe(Effect.orDie);
+  yield* eventSink.stream({ afterSequence: terminalEventsAfterSequence }).pipe(
+    Stream.filter(
+      (stored) =>
+        stored.event.type === "run.updated" &&
+        !String(stored.commandId).startsWith("command:runtime-reconcile:") &&
+        (stored.event.payload.status === "completed" ||
+          stored.event.payload.status === "interrupted" ||
+          stored.event.payload.status === "failed" ||
+          stored.event.payload.status === "cancelled" ||
+          stored.event.payload.status === "rolled_back"),
+    ),
+    Stream.runForEach(handleTerminalRun),
+    Effect.forkDetach,
+  );
+
+  // The high-water subscription deliberately skips history, so recover the
+  // two terminal side effects from current projections instead: one queued
+  // run per idle thread, plus any app-owned child result not yet transferred.
+  yield* resumeQueuedRuns.pipe(
+    Effect.tap((resumed) =>
+      resumed === 0
+        ? Effect.void
+        : Effect.logInfo("Resumed queued V2 runs after recovery", { resumed }),
+    ),
+    Effect.catchCause((cause) =>
+      Effect.logWarning("Failed to recover queued V2 runs", {
+        cause,
+      }),
+    ),
+  );
+  yield* projectionStore.getShellSnapshot().pipe(
+    Effect.flatMap((shell) =>
+      Effect.forEach(
+        [...shell.threads, ...shell.archivedThreads].filter(
+          (thread) =>
+            thread.lineage.relationshipToParent === "subagent" &&
+            thread.lineage.parentThreadId !== null &&
+            thread.forkedFrom?.type === "node" &&
+            (thread.status === "completed" ||
+              thread.status === "interrupted" ||
+              thread.status === "failed" ||
+              thread.status === "cancelled" ||
+              thread.status === "rolled_back"),
+        ),
+        (thread) =>
+          threadDispatch
+            .withLock(thread.lineage.parentThreadId!, finalizeAppOwnedSubagent(thread.id))
+            .pipe(
+              Effect.catchCause((cause) =>
+                Effect.logWarning("Failed to recover terminal app-owned subagent", {
+                  childThreadId: thread.id,
+                  parentThreadId: thread.lineage.parentThreadId,
+                  cause,
+                }),
+              ),
+            ),
+        { concurrency: 8, discard: true },
+      ),
+    ),
+    Effect.catchCause((cause) =>
+      Effect.logWarning("Failed to inspect app-owned subagents during recovery", {
+        cause,
+      }),
+    ),
+  );
+  yield* projectionStore.getShellSnapshot().pipe(
+    Effect.flatMap((shell) =>
+      Effect.forEach(
+        [...shell.threads, ...shell.archivedThreads],
+        (thread) =>
+          threadDispatch
+            .withLock(
+              thread.id,
+              Effect.gen(function* () {
+                const projection = yield* projectionStore.getThreadProjection(thread.id);
+                const terminalDeliveryRunIds = projection.runs
+                  .filter((run) => delegatedTaskTerminalStatus(run.status) !== null)
+                  .filter((run) =>
+                    projection.messages.some(
+                      (message) =>
+                        message.id === run.userMessageId &&
+                        message.delegatedCompletion !== undefined,
+                    ),
+                  )
+                  .map((run) => run.id);
+                for (const runId of terminalDeliveryRunIds) {
+                  yield* finalizeDelegatedCompletionDelivery(thread.id, runId);
+                }
+                const refreshed = yield* projectionStore.getThreadProjection(thread.id);
+                for (const run of refreshed.runs) {
+                  if (
+                    run.delegatedCompletion?.delivery !== null &&
+                    run.delegatedCompletion !== undefined
+                  ) {
+                    yield* offerDelegatedCompletionDelivery(thread.id, run.id);
+                  }
+                }
+              }),
+            )
+            .pipe(
+              Effect.catchCause((cause) =>
+                Effect.logWarning("Failed to recover delegated completion delivery", {
+                  threadId: thread.id,
+                  cause,
+                }),
+              ),
+            ),
+        { concurrency: 8, discard: true },
+      ),
+    ),
+    Effect.catchCause((cause) =>
+      Effect.logWarning("Failed to inspect delegated completion delivery during recovery", {
+        cause,
+      }),
+    ),
+  );
+
+  return OrchestratorV2.of({
+    resumeQueuedRuns,
+    dispatch: dispatchWithReceipt,
+    getThreadProjection: (threadId) =>
+      projectionStore
+        .getThreadProjection(threadId)
+        .pipe(Effect.mapError((cause) => new OrchestratorProjectionError({ threadId, cause }))),
+    getThreadSnapshot: (threadId) =>
+      projectionStore
+        .getThreadSnapshot(threadId)
+        .pipe(Effect.mapError((cause) => new OrchestratorProjectionError({ threadId, cause }))),
+    getThreadSnapshotWindow: (threadId, options) =>
+      projectionStore
+        .getThreadSnapshotWindow(threadId, options)
+        .pipe(Effect.mapError((cause) => new OrchestratorProjectionError({ threadId, cause }))),
+    getShellSnapshot: (options) =>
+      projectionStore.getShellSnapshot(options).pipe(
+        Effect.mapError(
+          (cause) =>
+            new OrchestratorProjectionError({
+              threadId: ThreadId.make("thread:shell"),
+              cause,
+            }),
+        ),
+      ),
+    getThreadShell: (threadId) =>
+      projectionStore
+        .getThreadShell(threadId)
+        .pipe(Effect.mapError((cause) => new OrchestratorProjectionError({ threadId, cause }))),
+    getThreadEventSequence: (threadId) =>
+      eventSink
+        .latestSequence({ threadId })
+        .pipe(Effect.mapError((cause) => new OrchestratorProjectionError({ threadId, cause }))),
+    streamStoredEvents: eventSink.stream().pipe(
+      Stream.mapError(
+        (cause) =>
+          new OrchestratorDomainEventStreamError({
+            cause,
+          }),
+      ),
+    ),
+    streamStoredEventsFrom: (input) =>
+      eventSink.stream(input).pipe(
+        Stream.mapError(
+          (cause) =>
+            new OrchestratorDomainEventStreamError({
+              cause,
+            }),
+        ),
+      ),
+    // Live tail only. eventSink.stream() with no cursor replays the whole
+    // store from genesis first; domain-event subscribers (the awareness relay)
+    // react to new activity, and startup replay made them grind through the
+    // entire event history doing per-event work after every boot.
+    streamDomainEvents: Stream.unwrap(
+      eventSink
+        .latestSequence()
+        .pipe(Effect.map((latest) => eventSink.stream({ afterSequence: latest }))),
+    ).pipe(
+      Stream.map((stored) => stored.event),
+      Stream.mapError(
+        (cause) =>
+          new OrchestratorDomainEventStreamError({
+            cause,
+          }),
+      ),
+    ),
+  });
+});
+
+export const layer: Layer.Layer<
+  OrchestratorV2,
+  never,
+  | CheckpointServiceV2
+  | CommandPolicyV2
+  | CommandReceiptStoreV2
+  | ContextHandoffServiceV2
+  | EventSinkV2
+  | IdAllocatorV2
+  | ProviderAdapterRegistryV2
+  | ProviderSessionManagerV2
+  | ProviderSwitchServiceV2
+  | ProjectionStoreV2
+  | RuntimePolicyV2
+  | ThreadForkServiceV2
+> = Layer.effect(OrchestratorV2, makeOrchestrator());
+
+export const layerUnavailable: Layer.Layer<OrchestratorV2> = Layer.succeed(
+  OrchestratorV2,
+  OrchestratorV2.of({
+    resumeQueuedRuns: Effect.fail(
+      new OrchestratorDispatchError({
+        commandId: CommandId.make("command:system:resume-queued-runs"),
+        commandType: "message.dispatch",
+        cause: "Orchestration V2 live runtime is not configured.",
+      }),
+    ),
+    dispatch: (command) =>
+      Effect.fail(
+        new OrchestratorDispatchError({
+          commandId: command.commandId,
+          commandType: command.type,
+          cause: "Orchestration V2 live runtime is not configured.",
+        }),
+      ),
+    getThreadProjection: (threadId) =>
+      Effect.fail(
+        new OrchestratorProjectionError({
+          threadId,
+          cause: "Orchestration V2 live runtime is not configured.",
+        }),
+      ),
+    getThreadSnapshot: (threadId) =>
+      Effect.fail(
+        new OrchestratorProjectionError({
+          threadId,
+          cause: "Orchestration V2 live runtime is not configured.",
+        }),
+      ),
+    getThreadSnapshotWindow: (threadId) =>
+      Effect.fail(
+        new OrchestratorProjectionError({
+          threadId,
+          cause: "Orchestration V2 live runtime is not configured.",
+        }),
+      ),
+    getShellSnapshot: () =>
+      Effect.fail(
+        new OrchestratorProjectionError({
+          threadId: ThreadId.make("thread:shell"),
+          cause: "Orchestration V2 live runtime is not configured.",
+        }),
+      ),
+    getThreadShell: (threadId) =>
+      Effect.fail(
+        new OrchestratorProjectionError({
+          threadId,
+          cause: "Orchestration V2 live runtime is not configured.",
+        }),
+      ),
+    getThreadEventSequence: (threadId) =>
+      Effect.fail(
+        new OrchestratorProjectionError({
+          threadId,
+          cause: "Orchestration V2 live runtime is not configured.",
+        }),
+      ),
+    streamStoredEvents: Stream.fail(
+      new OrchestratorDomainEventStreamError({
+        cause: "Orchestration V2 live runtime is not configured.",
+      }),
+    ),
+    streamStoredEventsFrom: () =>
+      Stream.fail(
+        new OrchestratorDomainEventStreamError({
+          cause: "Orchestration V2 live runtime is not configured.",
+        }),
+      ),
+    streamDomainEvents: Stream.fail(
+      new OrchestratorDomainEventStreamError({
+        cause: "Orchestration V2 live runtime is not configured.",
+      }),
+    ),
+  } satisfies OrchestratorV2Shape),
+);
diff --git a/apps/server/src/orchestration-v2/ProjectionMaintenance.ts b/apps/server/src/orchestration-v2/ProjectionMaintenance.ts
new file mode 100644
index 000000000000..4a5f6b4df447
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ProjectionMaintenance.ts
@@ -0,0 +1,391 @@
+import { type OrchestrationV2StoredEvent, ThreadId } from "@t3tools/contracts";
+import * as Context from "effect/Context";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Schema from "effect/Schema";
+import * as Stream from "effect/Stream";
+import * as SqlClient from "effect/unstable/sql/SqlClient";
+
+import { EventStoreV2 } from "./EventStore.ts";
+import {
+  ORCHESTRATION_V2_PROJECTION_SCHEMA_VERSION,
+  ProjectionStoreV2,
+} from "./ProjectionStore.ts";
+
+export interface ProjectionVerificationV2 {
+  readonly valid: boolean;
+  readonly schemaVersion: number;
+  readonly expectedSequence: number;
+  readonly projectionSequence: number;
+  readonly unreadableThreadIds: ReadonlyArray<ThreadId>;
+  readonly missingThreadIds: ReadonlyArray<ThreadId>;
+  readonly unexpectedThreadIds: ReadonlyArray<ThreadId>;
+}
+
+export class ProjectionMaintenanceError extends Schema.TaggedErrorClass<ProjectionMaintenanceError>()(
+  "ProjectionMaintenanceError",
+  {
+    operation: Schema.String,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {}
+
+export interface ProjectionMaintenanceV2Shape {
+  readonly verify: Effect.Effect<ProjectionVerificationV2, ProjectionMaintenanceError>;
+  readonly rebuild: Effect.Effect<ProjectionVerificationV2, ProjectionMaintenanceError>;
+  readonly compactEventStore: Effect.Effect<
+    {
+      readonly deletedEventCount: number;
+      readonly deletedReceiptCount: number;
+      readonly reclaimableBytes: number;
+    },
+    ProjectionMaintenanceError
+  >;
+}
+
+export class ProjectionMaintenanceV2 extends Context.Service<
+  ProjectionMaintenanceV2,
+  ProjectionMaintenanceV2Shape
+>()("t3/orchestration-v2/ProjectionMaintenance/ProjectionMaintenanceV2") {}
+
+type ProjectionMetadataRow = {
+  readonly schema_version: number;
+  readonly last_sequence: number;
+};
+
+export const layer: Layer.Layer<
+  ProjectionMaintenanceV2,
+  never,
+  EventStoreV2 | ProjectionStoreV2 | SqlClient.SqlClient
+> = Layer.effect(
+  ProjectionMaintenanceV2,
+  Effect.gen(function* () {
+    const sql = yield* SqlClient.SqlClient;
+    const eventStore = yield* EventStoreV2;
+    const projectionStore = yield* ProjectionStoreV2;
+
+    const readAllEvents = Effect.gen(function* () {
+      const events: Array<OrchestrationV2StoredEvent> = [];
+      const pageSize = 500;
+      let afterSequence = 0;
+      while (true) {
+        const page = yield* eventStore.read({ afterSequence, limit: pageSize }).pipe(
+          Stream.runCollect,
+          Effect.map((chunk) => Array.from(chunk)),
+        );
+        events.push(...page);
+        if (page.length < pageSize) {
+          break;
+        }
+        afterSequence = page.at(-1)?.sequence ?? afterSequence;
+      }
+      return events;
+    });
+
+    /**
+     * EventSink commits the event, its projection updates, and projection metadata in one SQL
+     * transaction. Startup verification therefore checks that transaction boundary and that every
+     * stored projection can be decoded. It intentionally does not replay domain events through a
+     * second projector: doing so creates another implementation of projection semantics that must
+     * evolve in lockstep with ProjectionStore.
+     */
+    const verify = Effect.gen(function* () {
+      const expectedThreadRows = yield* sql<{ readonly thread_id: string }>`
+        SELECT DISTINCT stream_id AS thread_id
+        FROM orchestration_events
+        WHERE application_event_version = 2
+          AND aggregate_kind = 'thread'
+          AND event_type = 'thread.created'
+        ORDER BY stream_id ASC
+      `;
+      const projectionRows = yield* sql<{ readonly thread_id: string }>`
+        SELECT thread_id
+        FROM orchestration_v2_projection_threads
+        ORDER BY thread_id ASC
+      `;
+      const actualIds = projectionRows.map((row) => ThreadId.make(row.thread_id));
+      const expectedIds = expectedThreadRows.map((row) => ThreadId.make(row.thread_id));
+      const actualSet = new Set(actualIds);
+      const expectedSet = new Set(expectedIds);
+      const missingThreadIds = expectedIds.filter((threadId) => !actualSet.has(threadId));
+      const unexpectedThreadIds = actualIds.filter((threadId) => !expectedSet.has(threadId));
+      const unreadableThreadIds = (yield* Effect.forEach(
+        actualIds,
+        (threadId) =>
+          projectionStore.getThreadProjection(threadId).pipe(
+            Effect.as<ThreadId | null>(null),
+            Effect.orElseSucceed((): ThreadId | null => threadId),
+          ),
+        { concurrency: 8 },
+      )).filter((threadId): threadId is ThreadId => threadId !== null);
+      const metadata = yield* sql<ProjectionMetadataRow>`
+        SELECT schema_version, last_sequence
+        FROM orchestration_v2_projection_metadata
+        WHERE projection_name = 'thread-projections'
+        LIMIT 1
+      `;
+      const expectedSequence = yield* eventStore.latestSequence();
+      const schemaVersion = metadata[0]?.schema_version ?? 0;
+      const projectionSequence = metadata[0]?.last_sequence ?? 0;
+      return {
+        valid:
+          schemaVersion === ORCHESTRATION_V2_PROJECTION_SCHEMA_VERSION &&
+          projectionSequence === expectedSequence &&
+          missingThreadIds.length === 0 &&
+          unexpectedThreadIds.length === 0 &&
+          unreadableThreadIds.length === 0,
+        schemaVersion,
+        expectedSequence,
+        projectionSequence,
+        unreadableThreadIds,
+        missingThreadIds,
+        unexpectedThreadIds,
+      } satisfies ProjectionVerificationV2;
+    });
+
+    const rebuild = Effect.gen(function* () {
+      const events = yield* readAllEvents;
+      yield* sql.withTransaction(
+        Effect.gen(function* () {
+          yield* sql`DELETE FROM orchestration_v2_projection_context_transfers`;
+          yield* sql`DELETE FROM orchestration_v2_projection_context_handoffs`;
+          yield* sql`DELETE FROM orchestration_v2_projection_checkpoints`;
+          yield* sql`DELETE FROM orchestration_v2_projection_checkpoint_scopes`;
+          yield* sql`DELETE FROM orchestration_v2_projection_turn_items`;
+          yield* sql`DELETE FROM orchestration_v2_projection_plans`;
+          yield* sql`DELETE FROM orchestration_v2_projection_messages`;
+          yield* sql`DELETE FROM orchestration_v2_projection_runtime_requests`;
+          yield* sql`DELETE FROM orchestration_v2_projection_provider_turns`;
+          yield* sql`DELETE FROM orchestration_v2_projection_provider_threads`;
+          yield* sql`DELETE FROM orchestration_v2_projection_provider_session_bindings`;
+          yield* sql`DELETE FROM orchestration_v2_projection_provider_sessions`;
+          yield* sql`DELETE FROM orchestration_v2_projection_subagents`;
+          yield* sql`DELETE FROM orchestration_v2_projection_nodes`;
+          yield* sql`DELETE FROM orchestration_v2_projection_run_attempts`;
+          yield* sql`DELETE FROM orchestration_v2_projection_runs`;
+          yield* sql`DELETE FROM orchestration_v2_projection_threads`;
+          yield* sql`DELETE FROM orchestration_v2_turn_item_positions`;
+
+          for (const stored of events) {
+            yield* projectionStore.apply(stored.event);
+            if (stored.event.type === "turn-item.updated") {
+              yield* sql`
+                INSERT INTO orchestration_v2_turn_item_positions (
+                  thread_id,
+                  turn_item_id,
+                  ordinal
+                )
+                VALUES (
+                  ${stored.event.threadId},
+                  ${stored.event.payload.id},
+                  ${stored.event.payload.ordinal}
+                )
+                ON CONFLICT(thread_id, turn_item_id) DO UPDATE SET
+                  ordinal = excluded.ordinal
+              `;
+            }
+          }
+          const now = DateTime.formatIso(yield* DateTime.now);
+          const lastSequence = events.at(-1)?.sequence ?? 0;
+          yield* sql`
+            INSERT INTO orchestration_v2_projection_metadata (
+              projection_name,
+              schema_version,
+              last_sequence,
+              updated_at
+            )
+            VALUES (
+              'thread-projections',
+              ${ORCHESTRATION_V2_PROJECTION_SCHEMA_VERSION},
+              ${lastSequence},
+              ${now}
+            )
+            ON CONFLICT(projection_name) DO UPDATE SET
+              schema_version = excluded.schema_version,
+              last_sequence = excluded.last_sequence,
+              updated_at = excluded.updated_at
+          `;
+        }),
+      );
+      return yield* verify;
+    });
+
+    const mapError =
+      (operation: string) =>
+      <A, E, R>(effect: Effect.Effect<A, E, R>) =>
+        effect.pipe(
+          Effect.mapError((cause) => new ProjectionMaintenanceError({ operation, cause })),
+        );
+
+    // Thread-state events whose payload is the complete thread: only the
+    // newest per thread can influence a replay or an afterSequence catch-up.
+    // thread.created stays out — verify derives the expected thread set from
+    // it, and it anchors replay ordering.
+    const SUPERSEDABLE_THREAD_EVENT_TYPES = [
+      "thread.archived",
+      "thread.unarchived",
+      "thread.deleted",
+      "thread.settled",
+      "thread.unsettled",
+      "thread.snoozed",
+      "thread.unsnoozed",
+      "thread.pinned",
+      "thread.unpinned",
+      "thread.pin-reordered",
+      "thread.metadata-updated",
+      "thread.runtime-mode-updated",
+      "thread.interaction-mode-updated",
+      "thread.model-selection-updated",
+      "thread.provider-switched",
+      "thread.visited",
+      "thread.marked-unread",
+    ];
+
+    const chunksOf = <A>(items: ReadonlyArray<A>, size: number): Array<ReadonlyArray<A>> => {
+      const out: Array<ReadonlyArray<A>> = [];
+      for (let index = 0; index < items.length; index += size) {
+        out.push(items.slice(index, index + size));
+      }
+      return out;
+    };
+
+    // The sqlite driver is synchronous: one statement over millions of rows
+    // would pin the event loop for its whole duration. Small auto-committed
+    // batches with a yield between them keep the server responsive and bound
+    // WAL growth; each batch is independently durable, so a crash mid-way
+    // just leaves less garbage for the next run.
+    const COMPACTION_DELETE_BATCH_SIZE = 2_000;
+    const deleteRowsBatched = (input: {
+      readonly table: "orchestration_events" | "orchestration_command_receipts";
+      readonly keys: ReadonlyArray<number | string>;
+    }) =>
+      Effect.gen(function* () {
+        let deleted = 0;
+        for (const batch of chunksOf(input.keys, COMPACTION_DELETE_BATCH_SIZE)) {
+          if (input.table === "orchestration_events") {
+            yield* sql`DELETE FROM orchestration_events WHERE sequence IN ${sql.in(batch)}`;
+          } else {
+            yield* sql`DELETE FROM orchestration_command_receipts WHERE command_id IN ${sql.in(batch)}`;
+          }
+          deleted += batch.length;
+          yield* Effect.yieldNow;
+        }
+        return deleted;
+      });
+
+    /**
+     * Full event-store compaction. Projections are the working state (startup
+     * verifies rather than replays), so events only serve afterSequence
+     * catch-up and disaster-recovery rebuild — and for full-payload "state of
+     * the entity" events, anything but the newest per entity is dead weight
+     * in both. Three passes:
+     *
+     * 1. Superseded thread-state events (visits alone accumulate at multiple
+     *    per minute while a thread is open).
+     * 2. Superseded message.updated / node.updated events per entity id —
+     *    streaming rewrites the same message many times. turn-item.updated is
+     *    deliberately NOT compacted: rebuild derives turn_item_positions from
+     *    those events with first-write-wins semantics, so keep-latest would
+     *    change replay outcomes for reordered items.
+     * 3. Legacy v1 thread events and their pre-migration command receipts for
+     *    threads whose v2 import completed — the v1 store is only read to
+     *    import from, and imports never re-run once transcript_imported_at is
+     *    set.
+     *
+     * VACUUM is deliberately not run here: on the synchronous driver it would
+     * block every query for minutes on a multi-GB file. The reclaimable page
+     * count is reported so the caller can surface a hint instead; freed pages
+     * are reused, so the file stops growing either way.
+     */
+    const compactEventStore = Effect.gen(function* () {
+      const supersededThreadStateRows = yield* sql<{ readonly sequence: number }>`
+        SELECT sequence
+        FROM orchestration_events
+        WHERE application_event_version = 2
+          AND aggregate_kind = 'thread'
+          AND event_type IN ${sql.in(SUPERSEDABLE_THREAD_EVENT_TYPES)}
+          AND sequence NOT IN (
+            SELECT MAX(sequence)
+            FROM orchestration_events
+            WHERE application_event_version = 2
+              AND aggregate_kind = 'thread'
+              AND event_type IN ${sql.in(SUPERSEDABLE_THREAD_EVENT_TYPES)}
+            GROUP BY stream_id
+          )
+      `;
+
+      const supersededEntityRows = (eventType: "message.updated" | "node.updated") => sql<{
+        readonly sequence: number;
+      }>`
+        SELECT sequence
+        FROM orchestration_events
+        WHERE application_event_version = 2
+          AND event_type = ${eventType}
+          AND sequence NOT IN (
+            SELECT MAX(sequence)
+            FROM orchestration_events
+            WHERE application_event_version = 2
+              AND event_type = ${eventType}
+            GROUP BY stream_id, json_extract(payload_json, '$.id')
+          )
+      `;
+      const supersededMessageRows = yield* supersededEntityRows("message.updated");
+      const supersededNodeRows = yield* supersededEntityRows("node.updated");
+
+      const importedLegacyEventRows = yield* sql<{ readonly sequence: number }>`
+        SELECT sequence
+        FROM orchestration_events
+        WHERE application_event_version = 1
+          AND aggregate_kind = 'thread'
+          AND stream_id IN (
+            SELECT thread_id
+            FROM orchestration_v2_legacy_imports
+            WHERE transcript_imported_at IS NOT NULL
+          )
+      `;
+
+      const deletedEventCount = yield* deleteRowsBatched({
+        table: "orchestration_events",
+        keys: [
+          ...supersededThreadStateRows,
+          ...supersededMessageRows,
+          ...supersededNodeRows,
+          ...importedLegacyEventRows,
+        ].map((row) => row.sequence),
+      });
+
+      // Receipts written before the command_type column existed default to
+      // 'legacy'; for fully imported v1 threads they guard idempotency of
+      // commands that can no longer be re-sent.
+      const legacyReceiptRows = yield* sql<{ readonly command_id: string }>`
+        SELECT command_id
+        FROM orchestration_command_receipts
+        WHERE command_type = 'legacy'
+          AND aggregate_kind = 'thread'
+          AND aggregate_id IN (
+            SELECT thread_id
+            FROM orchestration_v2_legacy_imports
+            WHERE transcript_imported_at IS NOT NULL
+          )
+      `;
+      const deletedReceiptCount = yield* deleteRowsBatched({
+        table: "orchestration_command_receipts",
+        keys: legacyReceiptRows.map((row) => row.command_id),
+      });
+
+      const freelistRows = yield* sql<{ readonly freelist_count: number }>`PRAGMA freelist_count`;
+      const pageSizeRows = yield* sql<{ readonly page_size: number }>`PRAGMA page_size`;
+      const reclaimableBytes =
+        (freelistRows[0]?.freelist_count ?? 0) * (pageSizeRows[0]?.page_size ?? 0);
+
+      return { deletedEventCount, deletedReceiptCount, reclaimableBytes };
+    });
+
+    return ProjectionMaintenanceV2.of({
+      verify: mapError("verify")(verify),
+      rebuild: mapError("rebuild")(rebuild),
+      compactEventStore: mapError("compact event store")(compactEventStore),
+    });
+  }),
+);
diff --git a/apps/server/src/orchestration-v2/ProjectionStore.test.ts b/apps/server/src/orchestration-v2/ProjectionStore.test.ts
new file mode 100644
index 000000000000..edab1c07dc83
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ProjectionStore.test.ts
@@ -0,0 +1,2785 @@
+import { assert, it } from "@effect/vitest";
+import {
+  EventId,
+  MessageId,
+  type ModelSelection,
+  NodeId,
+  ProjectId,
+  ProviderDriverKind,
+  ProviderInstanceId,
+  ProviderSessionId,
+  ProviderThreadId,
+  ProviderTurnId,
+  RunAttemptId,
+  RunId,
+  ThreadId,
+  TurnItemId,
+} from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Schema from "effect/Schema";
+import * as SqlClient from "effect/unstable/sql/SqlClient";
+
+import { SqlitePersistenceMemory } from "../persistence/Layers/Sqlite.ts";
+import { CodexProviderCapabilitiesV2 } from "./Adapters/CodexAdapterV2.ts";
+import {
+  isTurnItemAtOrBeforeRun,
+  ProjectionStoreV2,
+  layer as projectionStoreLayer,
+} from "./ProjectionStore.ts";
+import {
+  buildBoundedThreadProjection,
+  decodeThreadHistoryCursor,
+  selectHistoryPageFromCursor,
+  THREAD_HISTORY_PAGE_POLICY,
+} from "./threadHistoryPaging.ts";
+
+const TestLayer = Layer.mergeAll(
+  projectionStoreLayer.pipe(Layer.provideMerge(SqlitePersistenceMemory)),
+  SqlitePersistenceMemory,
+);
+const modelSelection = {
+  instanceId: ProviderInstanceId.make("codex"),
+  model: "gpt-5.4",
+} satisfies ModelSelection;
+const driver = ProviderDriverKind.make("codex");
+const providerInstanceId = modelSelection.instanceId;
+const encodeUnknownJsonString = Schema.encodeSync(Schema.fromJsonString(Schema.Unknown));
+
+it("includes imported runless history when selecting fork context through a run", () => {
+  const firstRunId = RunId.make("run:projection-imported-fork:1");
+  const secondRunId = RunId.make("run:projection-imported-fork:2");
+  const runOrdinalById = new Map([
+    [firstRunId, 1],
+    [secondRunId, 2],
+  ]);
+
+  assert.isTrue(
+    isTurnItemAtOrBeforeRun({
+      historyOrigin: "v1_import",
+      itemRunId: null,
+      runOrdinalById,
+      sourceRunOrdinal: 1,
+    }),
+  );
+  assert.isFalse(
+    isTurnItemAtOrBeforeRun({
+      historyOrigin: undefined,
+      itemRunId: null,
+      runOrdinalById,
+      sourceRunOrdinal: 1,
+    }),
+  );
+  assert.isTrue(
+    isTurnItemAtOrBeforeRun({
+      historyOrigin: "v1_import",
+      itemRunId: firstRunId,
+      runOrdinalById,
+      sourceRunOrdinal: 1,
+    }),
+  );
+  assert.isFalse(
+    isTurnItemAtOrBeforeRun({
+      historyOrigin: "v1_import",
+      itemRunId: secondRunId,
+      runOrdinalById,
+      sourceRunOrdinal: 1,
+    }),
+  );
+});
+
+it.layer(TestLayer)("ProjectionStoreV2", (it) => {
+  it.effect("preserves stored provider usage when a terminal update omits it", () =>
+    Effect.gen(function* () {
+      const projectionStore = yield* ProjectionStoreV2;
+      const now = yield* DateTime.now;
+      const threadId = ThreadId.make("thread:provider-usage-reload");
+      const providerThreadId = ProviderThreadId.make("provider-thread:provider-usage-reload");
+      const providerTurnId = ProviderTurnId.make("provider-turn:provider-usage-reload");
+      const nodeId = NodeId.make("node:provider-usage-reload");
+      const initialUsage = {
+        usedTokens: 12_000,
+        maxTokens: 200_000,
+        inputTokens: 11_000,
+        outputTokens: 1_000,
+        updatedAt: "2026-08-29T12:00:00.000Z",
+      } as const;
+      const replacementUsage = {
+        usedTokens: 18_000,
+        maxTokens: 200_000,
+        inputTokens: 16_000,
+        outputTokens: 2_000,
+        updatedAt: "2026-08-29T12:00:01.000Z",
+      } as const;
+
+      yield* projectionStore.apply({
+        id: EventId.make("event:provider-usage-reload:thread"),
+        type: "thread.created",
+        threadId,
+        occurredAt: now,
+        payload: {
+          createdBy: "user",
+          creationSource: "web",
+          id: threadId,
+          projectId: ProjectId.make("project:provider-usage-reload"),
+          title: "Provider usage reload",
+          providerInstanceId,
+          modelSelection,
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          branch: null,
+          worktreePath: null,
+          activeProviderThreadId: null,
+          lineage: { parentThreadId: null, relationshipToParent: null, rootThreadId: threadId },
+          forkedFrom: null,
+          createdAt: now,
+          updatedAt: now,
+          archivedAt: null,
+          settledOverride: null,
+          settledAt: null,
+          lastVisitedAt: null,
+          deletedAt: null,
+        },
+      });
+
+      const providerTurn = {
+        id: providerTurnId,
+        providerThreadId,
+        nodeId,
+        runAttemptId: null,
+        nativeTurnRef: null,
+        ordinal: 1,
+        status: "running" as const,
+        startedAt: now,
+        completedAt: null,
+      };
+      yield* projectionStore.apply({
+        id: EventId.make("event:provider-usage-reload:running"),
+        type: "provider-turn.updated",
+        threadId,
+        nodeId,
+        driver,
+        occurredAt: now,
+        payload: { ...providerTurn, tokenUsage: initialUsage },
+      });
+      yield* projectionStore.apply({
+        id: EventId.make("event:provider-usage-reload:completed"),
+        type: "provider-turn.updated",
+        threadId,
+        nodeId,
+        driver,
+        occurredAt: now,
+        payload: { ...providerTurn, status: "completed", completedAt: now },
+      });
+
+      const reloaded = yield* projectionStore.getThreadProjection(threadId);
+      assert.deepEqual(reloaded.providerTurns[0]?.tokenUsage, initialUsage);
+      assert.strictEqual(reloaded.providerTurns[0]?.status, "completed");
+
+      yield* projectionStore.apply({
+        id: EventId.make("event:provider-usage-reload:replacement"),
+        type: "provider-turn.updated",
+        threadId,
+        nodeId,
+        driver,
+        occurredAt: now,
+        payload: {
+          ...providerTurn,
+          status: "completed",
+          completedAt: now,
+          tokenUsage: replacementUsage,
+        },
+      });
+
+      const replaced = yield* projectionStore.getThreadProjection(threadId);
+      assert.deepEqual(replaced.providerTurns[0]?.tokenUsage, replacementUsage);
+    }),
+  );
+
+  it.effect("reads a fixed SQL turn-item window for long histories and repeated clients", () =>
+    Effect.gen(function* () {
+      const projectionStore = yield* ProjectionStoreV2;
+      const sql = yield* SqlClient.SqlClient;
+      const now = yield* DateTime.now;
+      const nowIso = DateTime.formatIso(now);
+      const threadId = ThreadId.make("thread:bounded-sql-history");
+      yield* projectionStore.apply({
+        id: EventId.make("event:bounded-sql-history:thread"),
+        type: "thread.created",
+        threadId,
+        occurredAt: now,
+        payload: {
+          createdBy: "user",
+          creationSource: "web",
+          id: threadId,
+          projectId: ProjectId.make("project:bounded-sql-history"),
+          title: "Bounded SQL history",
+          providerInstanceId,
+          modelSelection,
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          branch: null,
+          worktreePath: null,
+          activeProviderThreadId: null,
+          lineage: { parentThreadId: null, relationshipToParent: null, rootThreadId: threadId },
+          forkedFrom: null,
+          createdAt: now,
+          updatedAt: now,
+          archivedAt: null,
+          settledOverride: null,
+          settledAt: null,
+          lastVisitedAt: null,
+          deletedAt: null,
+        },
+      });
+
+      for (let ordinal = 1; ordinal <= 1_000; ordinal += 1) {
+        const id = `turn-item:bounded-sql-history:${ordinal}`;
+        const runId = `run:bounded-sql-history:${ordinal}`;
+        yield* sql`
+          INSERT INTO orchestration_v2_projection_runs (
+            run_id, thread_id, ordinal, provider, provider_thread_id, status,
+            requested_at, completed_at, payload_json
+          ) VALUES (
+            ${runId}, ${threadId}, ${ordinal}, 'codex', NULL, 'completed', ${nowIso}, ${nowIso},
+            ${encodeUnknownJsonString({
+              id: runId,
+              threadId,
+              ordinal,
+              providerInstanceId,
+              modelSelection,
+              providerThreadId: null,
+              userMessageId: `message:bounded-sql-history:${ordinal}`,
+              rootNodeId: `node:bounded-sql-history:${ordinal}`,
+              activeAttemptId: null,
+              status: "completed",
+              requestedAt: nowIso,
+              startedAt: nowIso,
+              completedAt: nowIso,
+              checkpointId: null,
+              contextHandoffId: null,
+            })}
+          )
+        `;
+        yield* sql`
+          INSERT INTO orchestration_v2_projection_turn_items (
+            turn_item_id, thread_id, run_id, node_id, provider_thread_id, provider_turn_id,
+            parent_item_id, ordinal, type, status, updated_at, payload_json
+          ) VALUES (
+            ${id}, ${threadId}, ${runId}, NULL, NULL, NULL, NULL, ${ordinal},
+            'command_execution', 'completed', ${nowIso},
+            ${encodeUnknownJsonString({
+              id,
+              threadId,
+              runId,
+              nodeId: null,
+              providerThreadId: null,
+              providerTurnId: null,
+              nativeItemRef: null,
+              parentItemId: null,
+              ordinal,
+              status: "completed",
+              title: `command ${ordinal}`,
+              input: `echo ${ordinal}`,
+              output: "ok",
+              exitCode: 0,
+              startedAt: nowIso,
+              completedAt: nowIso,
+              updatedAt: nowIso,
+              type: "command_execution",
+            })}
+          )
+        `;
+      }
+
+      const snapshots = yield* Effect.all(
+        Array.from({ length: 4 }, () =>
+          projectionStore.getThreadSnapshotWindow(threadId, { rowLimit: 76 }),
+        ),
+        { concurrency: 4 },
+      );
+      for (const snapshot of snapshots) {
+        assert.lengthOf(snapshot.projection.turnItems, 76);
+        assert.lengthOf(snapshot.projection.runs, 76);
+        assert.lengthOf(snapshot.projection.visibleTurnItems, 76);
+        assert.strictEqual(snapshot.projection.turnItems[0]?.ordinal, 925);
+        assert.strictEqual(snapshot.projection.turnItems.at(-1)?.ordinal, 1_000);
+      }
+      const retainedRequestPlan = yield* sql<{ readonly detail: string }>`
+        EXPLAIN QUERY PLAN
+        WITH selected AS (
+          SELECT run_id, type
+          FROM orchestration_v2_projection_turn_items
+          WHERE thread_id = ${threadId}
+          ORDER BY ordinal DESC, turn_item_id DESC
+          LIMIT 77
+        )
+        SELECT request.payload_json
+        FROM orchestration_v2_projection_turn_items AS request
+        WHERE request.run_id IN (
+            SELECT run_id FROM selected
+            WHERE type = 'run_interrupt_result' AND run_id IS NOT NULL
+          )
+          AND request.type = 'run_interrupt_request'
+      `;
+      assert.isTrue(
+        retainedRequestPlan.some((row) =>
+          row.detail.includes("orchestration_v2_projection_turn_items_run_ordinal_idx"),
+        ),
+      );
+
+      const older = yield* projectionStore.getThreadSnapshotWindow(threadId, {
+        rowLimit: 76,
+        anchorItemId: TurnItemId.make("turn-item:bounded-sql-history:925"),
+      });
+      assert.lengthOf(older.projection.turnItems, 76);
+      assert.lengthOf(older.projection.runs, 76);
+      assert.strictEqual(older.projection.turnItems[0]?.ordinal, 850);
+      assert.strictEqual(older.projection.turnItems.at(-1)?.ordinal, 925);
+
+      const sqlPageLimit = THREAD_HISTORY_PAGE_POLICY.maxItems + 2;
+      const initialSnapshot = yield* projectionStore.getThreadSnapshotWindow(threadId, {
+        rowLimit: sqlPageLimit,
+      });
+      const initialPage = buildBoundedThreadProjection({
+        projection: initialSnapshot.projection,
+        snapshotSequence: initialSnapshot.snapshotSequence,
+      });
+      const loadedIds = initialPage.projection.visibleTurnItems.map((row) =>
+        String(row.sourceItemId),
+      );
+      let cursor = initialPage.historyCursor;
+      let pageCount = 1;
+      while (cursor !== null) {
+        const anchorItemId = TurnItemId.make(decodeThreadHistoryCursor(cursor).si);
+        const snapshot = yield* projectionStore.getThreadSnapshotWindow(threadId, {
+          rowLimit: sqlPageLimit,
+          anchorItemId,
+        });
+        const page = selectHistoryPageFromCursor({
+          items: snapshot.projection.visibleTurnItems,
+          cursor,
+          snapshotSequence: snapshot.snapshotSequence,
+        });
+        loadedIds.push(...page.items.map((row) => String(row.sourceItemId)));
+        pageCount += 1;
+        cursor = page.nextCursor;
+      }
+
+      assert.isAtLeast(pageCount, 4);
+      assert.lengthOf(loadedIds, 1_000);
+      assert.strictEqual(new Set(loadedIds).size, 1_000);
+      assert.deepEqual(
+        loadedIds.toSorted(
+          (left, right) => Number(left.split(":").at(-1)) - Number(right.split(":").at(-1)),
+        ),
+        Array.from({ length: 1_000 }, (_, index) => `turn-item:bounded-sql-history:${index + 1}`),
+      );
+
+      const hiddenRunId = RunId.make("run:bounded-sql-history:hidden-suffix");
+      yield* sql`
+        INSERT INTO orchestration_v2_projection_runs (
+          run_id, thread_id, ordinal, provider, provider_thread_id, status,
+          requested_at, completed_at, payload_json
+        ) VALUES (
+          ${hiddenRunId}, ${threadId}, 1001, 'codex', NULL, 'rolled_back', ${nowIso}, ${nowIso},
+          ${encodeUnknownJsonString({
+            id: hiddenRunId,
+            threadId,
+            ordinal: 1001,
+            providerInstanceId,
+            modelSelection,
+            providerThreadId: null,
+            userMessageId: "message:bounded-sql-history:hidden-suffix",
+            rootNodeId: "node:bounded-sql-history:hidden-suffix",
+            activeAttemptId: null,
+            status: "rolled_back",
+            requestedAt: nowIso,
+            startedAt: nowIso,
+            completedAt: nowIso,
+            checkpointId: null,
+            contextHandoffId: null,
+          })}
+        )
+      `;
+      for (let ordinal = 1_001; ordinal <= 1_100; ordinal += 1) {
+        const id = `turn-item:bounded-sql-history:hidden:${ordinal}`;
+        yield* sql`
+          INSERT INTO orchestration_v2_projection_turn_items (
+            turn_item_id, thread_id, run_id, node_id, provider_thread_id, provider_turn_id,
+            parent_item_id, ordinal, type, status, updated_at, payload_json
+          ) VALUES (
+            ${id}, ${threadId}, ${hiddenRunId}, NULL, NULL, NULL, NULL, ${ordinal},
+            'command_execution', 'completed', ${nowIso},
+            ${encodeUnknownJsonString({
+              id,
+              threadId,
+              runId: hiddenRunId,
+              nodeId: null,
+              providerThreadId: null,
+              providerTurnId: null,
+              nativeItemRef: null,
+              parentItemId: null,
+              ordinal,
+              status: "completed",
+              title: "rolled back",
+              input: "echo hidden",
+              output: "hidden",
+              exitCode: 0,
+              startedAt: nowIso,
+              completedAt: nowIso,
+              updatedAt: nowIso,
+              type: "command_execution",
+            })}
+          )
+        `;
+      }
+
+      const hiddenSuffixSnapshot = yield* projectionStore.getThreadSnapshotWindow(threadId, {
+        rowLimit: sqlPageLimit,
+      });
+      const hiddenSuffixPage = buildBoundedThreadProjection({
+        projection: hiddenSuffixSnapshot.projection,
+        snapshotSequence: hiddenSuffixSnapshot.snapshotSequence,
+      });
+      assert.lengthOf(hiddenSuffixPage.projection.visibleTurnItems, 75);
+      assert.strictEqual(hiddenSuffixPage.latestLocalTurnOrdinal, 1_100);
+      assert.isTrue(hiddenSuffixPage.hasMoreHistory);
+      assert.isFalse(
+        hiddenSuffixPage.projection.visibleTurnItems.some((row) =>
+          String(row.sourceItemId).includes(":hidden:"),
+        ),
+      );
+      const hiddenSuffixCursor = hiddenSuffixPage.historyCursor;
+      assert.isNotNull(hiddenSuffixCursor);
+      const hiddenSuffixAnchor = TurnItemId.make(decodeThreadHistoryCursor(hiddenSuffixCursor!).si);
+      const hiddenSuffixOlderSnapshot = yield* projectionStore.getThreadSnapshotWindow(threadId, {
+        rowLimit: sqlPageLimit,
+        anchorItemId: hiddenSuffixAnchor,
+      });
+      const hiddenSuffixOlderPage = selectHistoryPageFromCursor({
+        items: hiddenSuffixOlderSnapshot.projection.visibleTurnItems,
+        cursor: hiddenSuffixCursor!,
+        snapshotSequence: hiddenSuffixOlderSnapshot.snapshotSequence,
+      });
+      assert.lengthOf(hiddenSuffixOlderPage.items, 75);
+      assert.isTrue(hiddenSuffixOlderPage.hasMoreHistory);
+
+      const cancelledRunId = RunId.make("run:bounded-sql-history:cancelled-suffix");
+      yield* sql`
+        INSERT INTO orchestration_v2_projection_runs (
+          run_id, thread_id, ordinal, provider, provider_thread_id, status,
+          requested_at, completed_at, payload_json
+        ) VALUES (
+          ${cancelledRunId}, ${threadId}, 1002, 'codex', NULL, 'cancelled', ${nowIso}, ${nowIso},
+          ${encodeUnknownJsonString({
+            id: cancelledRunId,
+            threadId,
+            ordinal: 1002,
+            providerInstanceId,
+            modelSelection,
+            providerThreadId: null,
+            userMessageId: "message:bounded-sql-history:cancelled-suffix",
+            rootNodeId: "node:bounded-sql-history:cancelled-suffix",
+            activeAttemptId: null,
+            status: "cancelled",
+            requestedAt: nowIso,
+            startedAt: nowIso,
+            completedAt: nowIso,
+            checkpointId: null,
+            contextHandoffId: null,
+          })}
+        )
+      `;
+      for (let ordinal = 1_101; ordinal <= 1_200; ordinal += 1) {
+        const id = `turn-item:bounded-sql-history:cancelled:${ordinal}`;
+        yield* sql`
+          INSERT INTO orchestration_v2_projection_turn_items (
+            turn_item_id, thread_id, run_id, node_id, provider_thread_id, provider_turn_id,
+            parent_item_id, ordinal, type, status, updated_at, payload_json
+          ) VALUES (
+            ${id}, ${threadId}, ${cancelledRunId}, NULL, NULL, NULL, NULL, ${ordinal},
+            'user_message', 'completed', ${nowIso},
+            ${encodeUnknownJsonString({
+              createdBy: "user",
+              creationSource: "web",
+              id,
+              threadId,
+              runId: cancelledRunId,
+              nodeId: null,
+              providerThreadId: null,
+              providerTurnId: null,
+              nativeItemRef: null,
+              parentItemId: null,
+              ordinal,
+              status: "completed",
+              title: "cancelled queued message",
+              startedAt: nowIso,
+              completedAt: nowIso,
+              updatedAt: nowIso,
+              type: "user_message",
+              messageId: `message:bounded-sql-history:cancelled:${ordinal}`,
+              inputIntent: "queued_turn",
+              text: "cancelled",
+              attachments: [],
+            })}
+          )
+        `;
+      }
+      const runlessQueuedId = "turn-item:bounded-sql-history:runless-queued";
+      yield* sql`
+        INSERT INTO orchestration_v2_projection_turn_items (
+          turn_item_id, thread_id, run_id, node_id, provider_thread_id, provider_turn_id,
+          parent_item_id, ordinal, type, status, updated_at, payload_json
+        ) VALUES (
+          ${runlessQueuedId}, ${threadId}, NULL, NULL, NULL, NULL, NULL, 1201,
+          'user_message', 'completed', ${nowIso},
+          ${encodeUnknownJsonString({
+            createdBy: "user",
+            creationSource: "web",
+            id: runlessQueuedId,
+            threadId,
+            runId: null,
+            nodeId: null,
+            providerThreadId: null,
+            providerTurnId: null,
+            nativeItemRef: null,
+            parentItemId: null,
+            ordinal: 1201,
+            status: "completed",
+            title: "runless queued message",
+            startedAt: nowIso,
+            completedAt: nowIso,
+            updatedAt: nowIso,
+            type: "user_message",
+            messageId: "message:bounded-sql-history:runless-queued",
+            inputIntent: "queued_turn",
+            text: "still visible",
+            attachments: [],
+          })}
+        )
+      `;
+      const laterCancelledId = "turn-item:bounded-sql-history:cancelled:1202";
+      yield* sql`
+        INSERT INTO orchestration_v2_projection_turn_items (
+          turn_item_id, thread_id, run_id, node_id, provider_thread_id, provider_turn_id,
+          parent_item_id, ordinal, type, status, updated_at, payload_json
+        ) VALUES (
+          ${laterCancelledId}, ${threadId}, ${cancelledRunId}, NULL, NULL, NULL, NULL, 1202,
+          'user_message', 'completed', ${nowIso},
+          ${encodeUnknownJsonString({
+            createdBy: "user",
+            creationSource: "web",
+            id: laterCancelledId,
+            threadId,
+            runId: cancelledRunId,
+            nodeId: null,
+            providerThreadId: null,
+            providerTurnId: null,
+            nativeItemRef: null,
+            parentItemId: null,
+            ordinal: 1202,
+            status: "completed",
+            title: "later cancelled queued message",
+            startedAt: nowIso,
+            completedAt: nowIso,
+            updatedAt: nowIso,
+            type: "user_message",
+            messageId: "message:bounded-sql-history:cancelled:1202",
+            inputIntent: "queued_turn",
+            text: "cancelled",
+            attachments: [],
+          })}
+        )
+      `;
+      const cancelledSuffixSnapshot = yield* projectionStore.getThreadSnapshotWindow(threadId, {
+        rowLimit: sqlPageLimit,
+      });
+      const cancelledSuffixPage = buildBoundedThreadProjection({
+        projection: cancelledSuffixSnapshot.projection,
+        snapshotSequence: cancelledSuffixSnapshot.snapshotSequence,
+      });
+      assert.strictEqual(cancelledSuffixPage.latestLocalTurnOrdinal, 1_202);
+      assert.lengthOf(cancelledSuffixPage.projection.visibleTurnItems, 75);
+      assert.isFalse(
+        cancelledSuffixPage.projection.visibleTurnItems.some((row) =>
+          String(row.sourceItemId).includes(":cancelled:"),
+        ),
+      );
+      assert.isTrue(
+        cancelledSuffixPage.projection.visibleTurnItems.some(
+          (row) => row.sourceItemId === runlessQueuedId,
+        ),
+      );
+
+      const interruptRunId = RunId.make("run:bounded-sql-history:interrupt");
+      const interruptNodeId = NodeId.make("node:bounded-sql-history:interrupt");
+      const interruptRequestId = TurnItemId.make("turn-item:bounded-sql-history:interrupt-request");
+      const interruptResultId = TurnItemId.make("turn-item:bounded-sql-history:interrupt-result");
+      yield* sql`
+        INSERT INTO orchestration_v2_projection_runs (
+          run_id, thread_id, ordinal, provider, provider_thread_id, status,
+          requested_at, completed_at, payload_json
+        ) VALUES (
+          ${interruptRunId}, ${threadId}, 1003, 'codex', 'provider-thread:interrupt', 'completed',
+          ${nowIso}, ${nowIso},
+          ${encodeUnknownJsonString({
+            id: interruptRunId,
+            threadId,
+            ordinal: 1003,
+            providerInstanceId,
+            modelSelection,
+            providerThreadId: "provider-thread:interrupt",
+            userMessageId: "message:interrupt",
+            rootNodeId: interruptNodeId,
+            activeAttemptId: "attempt:bounded-sql-history:interrupt",
+            status: "completed",
+            requestedAt: nowIso,
+            startedAt: nowIso,
+            completedAt: nowIso,
+            checkpointId: null,
+            contextHandoffId: null,
+          })}
+        )
+      `;
+      yield* sql`
+        INSERT INTO orchestration_v2_projection_run_attempts (
+          attempt_id, thread_id, run_id, attempt_ordinal, root_node_id, provider,
+          provider_instance_id, provider_thread_id, provider_turn_id, status, payload_json
+        ) VALUES (
+          'attempt:bounded-sql-history:interrupt', ${threadId}, ${interruptRunId}, 1,
+          ${interruptNodeId}, 'codex', ${providerInstanceId}, 'provider-thread:interrupt', NULL,
+          'superseded',
+          ${encodeUnknownJsonString({
+            id: "attempt:bounded-sql-history:interrupt",
+            runId: interruptRunId,
+            attemptOrdinal: 1,
+            rootNodeId: interruptNodeId,
+            providerInstanceId,
+            providerThreadId: "provider-thread:interrupt",
+            providerTurnId: null,
+            reason: "initial",
+            status: "superseded",
+            startedAt: nowIso,
+            completedAt: nowIso,
+          })}
+        )
+      `;
+      const insertInterruptItem = (input: {
+        id: TurnItemId;
+        ordinal: number;
+        type: "run_interrupt_request" | "run_interrupt_result";
+      }) => sql`
+        INSERT INTO orchestration_v2_projection_turn_items (
+          turn_item_id, thread_id, run_id, node_id, provider_thread_id, provider_turn_id,
+          parent_item_id, ordinal, type, status, updated_at, payload_json
+        ) VALUES (
+          ${input.id}, ${threadId}, ${interruptRunId}, ${interruptNodeId}, NULL, NULL, NULL,
+          ${input.ordinal}, ${input.type}, 'completed', ${nowIso},
+          ${encodeUnknownJsonString({
+            id: input.id,
+            threadId,
+            runId: interruptRunId,
+            nodeId: interruptNodeId,
+            providerThreadId: null,
+            providerTurnId: null,
+            nativeItemRef: null,
+            parentItemId: null,
+            ordinal: input.ordinal,
+            status: "completed",
+            title: input.type,
+            message: input.type === "run_interrupt_request" ? "Stopping" : "Stopped",
+            startedAt: nowIso,
+            completedAt: nowIso,
+            updatedAt: nowIso,
+            type: input.type,
+          })}
+        )
+      `;
+      yield* insertInterruptItem({
+        id: interruptRequestId,
+        ordinal: 1_201,
+        type: "run_interrupt_request",
+      });
+      for (let ordinal = 1_202; ordinal <= 1_281; ordinal += 1) {
+        const id = `turn-item:bounded-sql-history:interrupt-filler:${ordinal}`;
+        yield* sql`
+          INSERT INTO orchestration_v2_projection_turn_items (
+            turn_item_id, thread_id, run_id, node_id, provider_thread_id, provider_turn_id,
+            parent_item_id, ordinal, type, status, updated_at, payload_json
+          ) VALUES (
+            ${id}, ${threadId}, NULL, NULL, NULL, NULL, NULL, ${ordinal},
+            'command_execution', 'completed', ${nowIso},
+            ${encodeUnknownJsonString({
+              id,
+              threadId,
+              runId: null,
+              nodeId: null,
+              providerThreadId: null,
+              providerTurnId: null,
+              nativeItemRef: null,
+              parentItemId: null,
+              ordinal,
+              status: "completed",
+              title: "filler",
+              input: "echo filler",
+              output: "ok",
+              exitCode: 0,
+              startedAt: nowIso,
+              completedAt: nowIso,
+              updatedAt: nowIso,
+              type: "command_execution",
+            })}
+          )
+        `;
+      }
+      yield* insertInterruptItem({
+        id: interruptResultId,
+        ordinal: 1_282,
+        type: "run_interrupt_result",
+      });
+
+      const interruptSnapshot = yield* projectionStore.getThreadSnapshotWindow(threadId, {
+        rowLimit: sqlPageLimit,
+      });
+      assert.isTrue(
+        interruptSnapshot.projection.turnItems.some((item) => item.id === interruptRequestId),
+      );
+      assert.isTrue(
+        interruptSnapshot.projection.visibleTurnItems.some(
+          (row) => row.sourceItemId === interruptResultId,
+        ),
+      );
+    }),
+  );
+
+  it.effect("scopes actionable provider state to the requested bounded thread", () =>
+    Effect.gen(function* () {
+      const projectionStore = yield* ProjectionStoreV2;
+      const now = yield* DateTime.now;
+      const projectId = ProjectId.make("project:bounded-provider-scope");
+      const targetThreadId = ThreadId.make("thread:bounded-provider-scope:target");
+      const unrelatedThreadId = ThreadId.make("thread:bounded-provider-scope:unrelated");
+      const makeThread = (threadId: ThreadId) => ({
+        createdBy: "user" as const,
+        creationSource: "web" as const,
+        id: threadId,
+        projectId,
+        title: String(threadId),
+        providerInstanceId,
+        modelSelection,
+        runtimeMode: "full-access" as const,
+        interactionMode: "default" as const,
+        branch: null,
+        worktreePath: null,
+        activeProviderThreadId: null,
+        lineage: { parentThreadId: null, relationshipToParent: null, rootThreadId: threadId },
+        forkedFrom: null,
+        createdAt: now,
+        updatedAt: now,
+        archivedAt: null,
+        settledOverride: null,
+        settledAt: null,
+        lastVisitedAt: null,
+        deletedAt: null,
+      });
+      for (const threadId of [targetThreadId, unrelatedThreadId]) {
+        yield* projectionStore.apply({
+          id: EventId.make(`event:bounded-provider-scope:thread:${threadId}`),
+          type: "thread.created",
+          threadId,
+          occurredAt: now,
+          payload: makeThread(threadId),
+        });
+        const sessionId = ProviderSessionId.make(`provider-session:${threadId}`);
+        const providerThreadId = ProviderThreadId.make(`provider-thread:${threadId}`);
+        yield* projectionStore.apply({
+          id: EventId.make(`event:bounded-provider-scope:session:${threadId}`),
+          type: "provider-session.attached",
+          threadId,
+          driver,
+          occurredAt: now,
+          payload: {
+            id: sessionId,
+            driver,
+            providerInstanceId,
+            status: "running",
+            cwd: "/workspace",
+            model: modelSelection.model,
+            capabilities: CodexProviderCapabilitiesV2,
+            createdAt: now,
+            updatedAt: now,
+            lastError: null,
+          },
+        });
+        yield* projectionStore.apply({
+          id: EventId.make(`event:bounded-provider-scope:provider-thread:${threadId}`),
+          type: "provider-thread.updated",
+          threadId,
+          driver,
+          occurredAt: now,
+          payload: {
+            id: providerThreadId,
+            driver,
+            providerInstanceId,
+            providerSessionId: sessionId,
+            appThreadId: threadId,
+            ownerNodeId: null,
+            nativeThreadRef: null,
+            nativeConversationHeadRef: null,
+            status: "active",
+            firstRunOrdinal: null,
+            lastRunOrdinal: null,
+            handoffIds: [],
+            forkedFrom: null,
+            createdAt: now,
+            updatedAt: now,
+          },
+        });
+      }
+
+      const snapshot = yield* projectionStore.getThreadSnapshotWindow(targetThreadId, {
+        rowLimit: 10,
+      });
+
+      assert.deepEqual(
+        snapshot.projection.providerSessions.map((session) => session.id),
+        [ProviderSessionId.make(`provider-session:${targetThreadId}`)],
+      );
+      assert.deepEqual(
+        snapshot.projection.providerThreads.map((thread) => thread.id),
+        [ProviderThreadId.make(`provider-thread:${targetThreadId}`)],
+      );
+    }),
+  );
+
+  it.effect("does not treat visited or marked-unread state as thread activity", () =>
+    Effect.gen(function* () {
+      const projectionStore = yield* ProjectionStoreV2;
+      const createdAt = yield* DateTime.now;
+      const visitedOccurredAt = DateTime.add(createdAt, { seconds: 1 });
+      const markedUnreadOccurredAt = DateTime.add(createdAt, { seconds: 2 });
+      const threadId = ThreadId.make("thread:projection-read-state");
+      const projectId = ProjectId.make("project:projection-read-state");
+      const thread = {
+        createdBy: "user" as const,
+        creationSource: "web" as const,
+        id: threadId,
+        projectId,
+        title: "Projection read state",
+        providerInstanceId,
+        modelSelection,
+        runtimeMode: "full-access" as const,
+        interactionMode: "default" as const,
+        branch: null,
+        worktreePath: null,
+        activeProviderThreadId: null,
+        lineage: {
+          parentThreadId: null,
+          relationshipToParent: null,
+          rootThreadId: threadId,
+        },
+        forkedFrom: null,
+        createdAt,
+        updatedAt: createdAt,
+        archivedAt: null,
+        settledOverride: null,
+        settledAt: null,
+        lastVisitedAt: null,
+        deletedAt: null,
+      };
+
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-read-state:created"),
+        type: "thread.created",
+        threadId,
+        occurredAt: createdAt,
+        payload: thread,
+      });
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-read-state:visited"),
+        type: "thread.visited",
+        threadId,
+        occurredAt: visitedOccurredAt,
+        payload: { ...thread, lastVisitedAt: createdAt },
+      });
+
+      const visited = yield* projectionStore.getThreadProjection(threadId);
+      assert.deepEqual(visited.thread.lastVisitedAt, createdAt);
+      assert.deepEqual(visited.thread.updatedAt, createdAt);
+
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-read-state:marked-unread"),
+        type: "thread.marked-unread",
+        threadId,
+        occurredAt: markedUnreadOccurredAt,
+        payload: thread,
+      });
+
+      const markedUnread = yield* projectionStore.getThreadProjection(threadId);
+      assert.isNull(markedUnread.thread.lastVisitedAt);
+      assert.deepEqual(markedUnread.thread.updatedAt, createdAt);
+    }),
+  );
+
+  it.effect("preserves delegated completion ownership across stale run and task updates", () =>
+    Effect.gen(function* () {
+      const projectionStore = yield* ProjectionStoreV2;
+      const now = yield* DateTime.now;
+      const later = DateTime.add(now, { seconds: 1 });
+      const threadId = ThreadId.make("thread:projection-delegated-completion");
+      const projectId = ProjectId.make("project:projection-delegated-completion");
+      const runId = RunId.make("run:projection-delegated-completion");
+      const rootNodeId = NodeId.make("node:projection-delegated-completion-root");
+      const taskId = NodeId.make("node:projection-delegated-completion-task");
+      const thread = {
+        createdBy: "user" as const,
+        creationSource: "web" as const,
+        id: threadId,
+        projectId,
+        title: "Delegated completion projection",
+        providerInstanceId,
+        modelSelection,
+        runtimeMode: "full-access" as const,
+        interactionMode: "default" as const,
+        branch: null,
+        worktreePath: null,
+        activeProviderThreadId: null,
+        lineage: {
+          parentThreadId: null,
+          relationshipToParent: null,
+          rootThreadId: threadId,
+        },
+        forkedFrom: null,
+        createdAt: now,
+        updatedAt: now,
+        archivedAt: null,
+        settledOverride: null,
+        settledAt: null,
+        lastVisitedAt: null,
+        deletedAt: null,
+      };
+      const run = {
+        id: runId,
+        threadId,
+        ordinal: 1,
+        providerInstanceId,
+        modelSelection,
+        providerThreadId: null,
+        userMessageId: MessageId.make("message:projection-delegated-completion"),
+        rootNodeId,
+        activeAttemptId: null,
+        status: "running" as const,
+        requestedAt: now,
+        startedAt: now,
+        completedAt: null,
+        checkpointId: null,
+        contextHandoffId: null,
+        delegatedCompletion: {
+          disposition: "stopped" as const,
+          nextGeneration: 2,
+          delivery: null,
+        },
+      };
+      const task = {
+        id: taskId,
+        threadId,
+        runId,
+        parentNodeId: rootNodeId,
+        origin: "app_owned" as const,
+        createdBy: "agent" as const,
+        driver,
+        providerInstanceId,
+        providerThreadId: null,
+        childThreadId: null,
+        nativeTaskRef: null,
+        prompt: "Inspect the stop barrier.",
+        title: null,
+        model: null,
+        completionWake: "always" as const,
+        completionDelivery: {
+          state: "disposed" as const,
+          observedByRunId: null,
+        },
+        status: "running" as const,
+        result: null,
+        startedAt: now,
+        completedAt: null,
+        updatedAt: now,
+      };
+
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-delegated-completion:thread"),
+        type: "thread.created",
+        threadId,
+        occurredAt: now,
+        payload: thread,
+      });
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-delegated-completion:run"),
+        type: "run.updated",
+        threadId,
+        runId,
+        nodeId: rootNodeId,
+        providerInstanceId,
+        occurredAt: now,
+        payload: run,
+      });
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-delegated-completion:task"),
+        type: "subagent.updated",
+        threadId,
+        runId,
+        nodeId: taskId,
+        driver,
+        providerInstanceId,
+        occurredAt: now,
+        payload: task,
+      });
+
+      const { delegatedCompletion: _delegatedCompletion, ...staleRun } = run;
+      const { completionDelivery: _completionDelivery, ...staleTask } = task;
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-delegated-completion:stale-run"),
+        type: "run.updated",
+        threadId,
+        runId,
+        nodeId: rootNodeId,
+        providerInstanceId,
+        occurredAt: later,
+        payload: { ...staleRun, status: "interrupted", completedAt: later },
+      });
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-delegated-completion:stale-task"),
+        type: "subagent.updated",
+        threadId,
+        runId,
+        nodeId: taskId,
+        driver,
+        providerInstanceId,
+        occurredAt: later,
+        payload: {
+          ...staleTask,
+          status: "interrupted",
+          completedAt: later,
+          updatedAt: later,
+        },
+      });
+
+      const projection = yield* projectionStore.getThreadProjection(threadId);
+      assert.deepEqual(projection.runs[0]?.delegatedCompletion, run.delegatedCompletion);
+      assert.deepEqual(projection.subagents[0]?.completionDelivery, task.completionDelivery);
+    }),
+  );
+
+  it.effect("only exposes interruptible runs through the shell activeRunId", () =>
+    Effect.gen(function* () {
+      const projectionStore = yield* ProjectionStoreV2;
+      const now = yield* DateTime.now;
+      const threadId = ThreadId.make("thread:projection-shell-interruptible");
+      const projectId = ProjectId.make("project:projection-shell-interruptible");
+      const runId = RunId.make("run:projection-shell-interruptible");
+      const rootNodeId = NodeId.make("node:projection-shell-interruptible");
+      const run = {
+        id: runId,
+        threadId,
+        ordinal: 1,
+        providerInstanceId,
+        modelSelection,
+        providerThreadId: null,
+        userMessageId: MessageId.make("message:projection-shell-interruptible"),
+        rootNodeId,
+        activeAttemptId: null,
+        status: "running" as const,
+        requestedAt: now,
+        startedAt: now,
+        completedAt: null,
+        checkpointId: null,
+        contextHandoffId: null,
+      };
+
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-shell-interruptible:thread"),
+        type: "thread.created",
+        threadId,
+        occurredAt: now,
+        payload: {
+          createdBy: "user",
+          creationSource: "web",
+          id: threadId,
+          projectId,
+          title: "Interruptible shell run",
+          providerInstanceId,
+          modelSelection,
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          branch: null,
+          worktreePath: null,
+          activeProviderThreadId: null,
+          lineage: {
+            parentThreadId: null,
+            relationshipToParent: null,
+            rootThreadId: threadId,
+          },
+          forkedFrom: null,
+          createdAt: now,
+          updatedAt: now,
+          archivedAt: null,
+          settledOverride: null,
+          settledAt: null,
+          lastVisitedAt: null,
+          deletedAt: null,
+        },
+      });
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-shell-interruptible:running"),
+        type: "run.created",
+        threadId,
+        runId,
+        nodeId: rootNodeId,
+        driver,
+        occurredAt: now,
+        payload: run,
+      });
+
+      let shell = (yield* projectionStore.getShellSnapshot()).threads.find(
+        (thread) => thread.id === threadId,
+      );
+      assert.equal(shell?.status, "running");
+      assert.equal(shell?.activeRunId, runId);
+      assert.equal(
+        shell?.latestRunRequestedAt && DateTime.toEpochMillis(shell.latestRunRequestedAt),
+        DateTime.toEpochMillis(now),
+      );
+      assert.equal(
+        shell?.latestRunStartedAt && DateTime.toEpochMillis(shell.latestRunStartedAt),
+        DateTime.toEpochMillis(now),
+      );
+      assert.isNull(shell?.latestRunCompletedAt);
+
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-shell-interruptible:waiting"),
+        type: "run.updated",
+        threadId,
+        runId,
+        nodeId: rootNodeId,
+        driver,
+        occurredAt: now,
+        payload: { ...run, status: "waiting" },
+      });
+
+      shell = (yield* projectionStore.getShellSnapshot()).threads.find(
+        (thread) => thread.id === threadId,
+      );
+      assert.equal(shell?.status, "waiting");
+      assert.isNull(shell?.activeRunId);
+    }),
+  );
+
+  it.effect("projects one shared provider session into multiple thread bindings", () =>
+    Effect.gen(function* () {
+      const projectionStore = yield* ProjectionStoreV2;
+      const now = yield* DateTime.now;
+      const projectId = ProjectId.make("project:projection-shared-provider-session");
+      const firstThreadId = ThreadId.make("thread:projection-shared-provider-session:first");
+      const secondThreadId = ThreadId.make("thread:projection-shared-provider-session:second");
+      const providerSessionId = ProviderSessionId.make(
+        "provider-session:projection-shared-provider-session",
+      );
+      const makeThread = (threadId: ThreadId) => ({
+        createdBy: "user" as const,
+        creationSource: "web" as const,
+        id: threadId,
+        projectId,
+        title: "Shared provider session",
+        providerInstanceId,
+        modelSelection,
+        runtimeMode: "full-access" as const,
+        interactionMode: "default" as const,
+        branch: null,
+        worktreePath: null,
+        activeProviderThreadId: null,
+        lineage: {
+          parentThreadId: null,
+          relationshipToParent: null,
+          rootThreadId: threadId,
+        },
+        forkedFrom: null,
+        createdAt: now,
+        updatedAt: now,
+        archivedAt: null,
+        settledOverride: null,
+        settledAt: null,
+        lastVisitedAt: null,
+        deletedAt: null,
+      });
+      const session = {
+        id: providerSessionId,
+        driver,
+        providerInstanceId,
+        status: "error" as const,
+        cwd: "/workspace",
+        model: modelSelection.model,
+        capabilities: CodexProviderCapabilitiesV2,
+        createdAt: now,
+        updatedAt: now,
+        lastError: "provider process exited",
+      };
+
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-shared-provider-session:first-thread"),
+        type: "thread.created",
+        threadId: firstThreadId,
+        occurredAt: now,
+        payload: makeThread(firstThreadId),
+      });
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-shared-provider-session:second-thread"),
+        type: "thread.created",
+        threadId: secondThreadId,
+        occurredAt: now,
+        payload: makeThread(secondThreadId),
+      });
+      for (const [threadId, suffix] of [
+        [firstThreadId, "first"],
+        [secondThreadId, "second"],
+      ] as const) {
+        yield* projectionStore.apply({
+          id: EventId.make(`event:projection-shared-provider-session:${suffix}-binding`),
+          type: "provider-session.attached",
+          threadId,
+          driver,
+          providerInstanceId,
+          occurredAt: now,
+          payload: session,
+        });
+      }
+
+      assert.deepEqual(
+        (yield* projectionStore.getThreadProjection(firstThreadId)).providerSessions.map(
+          (value) => value.id,
+        ),
+        [providerSessionId],
+      );
+      assert.deepEqual(
+        (yield* projectionStore.getThreadProjection(secondThreadId)).providerSessions.map(
+          (value) => value.id,
+        ),
+        [providerSessionId],
+      );
+      assert.deepEqual(
+        (yield* projectionStore.getShellSnapshot()).threads
+          .filter((thread) => thread.id === firstThreadId || thread.id === secondThreadId)
+          .map((thread) => ({
+            id: thread.id,
+            lastError: thread.lastError,
+          })),
+        [
+          { id: firstThreadId, lastError: "provider process exited" },
+          { id: secondThreadId, lastError: "provider process exited" },
+        ],
+      );
+
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-shared-provider-session:first-detached"),
+        type: "provider-session.detached",
+        threadId: firstThreadId,
+        driver,
+        providerInstanceId,
+        occurredAt: now,
+        payload: { providerSessionId, detachedAt: now },
+      });
+
+      assert.lengthOf(
+        (yield* projectionStore.getThreadProjection(firstThreadId)).providerSessions,
+        0,
+      );
+      assert.lengthOf(
+        (yield* projectionStore.getThreadProjection(secondThreadId)).providerSessions,
+        1,
+      );
+    }),
+  );
+
+  it.effect("builds shell snapshots without decoding full turn item payloads", () =>
+    Effect.gen(function* () {
+      const projectionStore = yield* ProjectionStoreV2;
+      const sql = yield* SqlClient.SqlClient;
+      const now = yield* DateTime.now;
+      const nowIso = DateTime.formatIso(now);
+      const threadId = ThreadId.make("thread:projection-shell-stale-item");
+      const projectId = ProjectId.make("project:projection-shell");
+
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-shell-thread-created"),
+        type: "thread.created",
+        threadId,
+        occurredAt: now,
+        payload: {
+          createdBy: "user",
+          creationSource: "web",
+          id: threadId,
+          projectId,
+          title: "Projection shell",
+          providerInstanceId,
+          modelSelection: modelSelection,
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          branch: null,
+          worktreePath: null,
+          activeProviderThreadId: null,
+          lineage: {
+            parentThreadId: null,
+            relationshipToParent: null,
+            rootThreadId: threadId,
+          },
+          forkedFrom: null,
+          createdAt: now,
+          updatedAt: now,
+          archivedAt: null,
+          settledOverride: null,
+          settledAt: null,
+          lastVisitedAt: null,
+          deletedAt: null,
+        },
+      });
+
+      yield* sql`
+        INSERT INTO orchestration_v2_projection_turn_items (
+          turn_item_id,
+          thread_id,
+          run_id,
+          node_id,
+          provider_thread_id,
+          provider_turn_id,
+          parent_item_id,
+          ordinal,
+          type,
+          status,
+          updated_at,
+          payload_json
+        )
+        VALUES (
+          ${"turn-item:stale-user-message"},
+          ${threadId},
+          ${null},
+          ${null},
+          ${null},
+          ${null},
+          ${null},
+          ${0},
+          ${"user_message"},
+          ${"completed"},
+          ${nowIso},
+          ${encodeUnknownJsonString({
+            id: "turn-item:stale-user-message",
+            threadId,
+            runId: null,
+            nodeId: null,
+            providerThreadId: null,
+            providerTurnId: null,
+            nativeItemRef: null,
+            parentItemId: null,
+            ordinal: 0,
+            status: "completed",
+            title: null,
+            startedAt: nowIso,
+            completedAt: nowIso,
+            updatedAt: nowIso,
+            type: "user_message",
+            messageId: "message:stale-user-message",
+            text: "stale user message",
+            attachments: [],
+          })}
+        )
+      `;
+
+      const shell = yield* projectionStore.getShellSnapshot();
+      const fullProjectionExit = yield* Effect.exit(projectionStore.getThreadProjection(threadId));
+
+      assert.deepEqual(
+        shell.threads
+          .filter((thread) => thread.id === threadId)
+          .map((thread) => ({
+            id: thread.id,
+            itemCount: thread.itemCount,
+            visibleItemCount: thread.visibleItemCount,
+            status: thread.status,
+          })),
+        [
+          {
+            id: threadId,
+            itemCount: 1,
+            visibleItemCount: 1,
+            status: "idle",
+          },
+        ],
+      );
+      assert.equal(fullProjectionExit._tag, "Failure");
+    }),
+  );
+
+  it.effect("counts imported runless history inherited by fork shells", () =>
+    Effect.gen(function* () {
+      const projectionStore = yield* ProjectionStoreV2;
+      const now = yield* DateTime.now;
+      const projectId = ProjectId.make("project:projection-imported-fork-shell");
+      const sourceThreadId = ThreadId.make("thread:projection-imported-fork-shell:source");
+      const targetThreadId = ThreadId.make("thread:projection-imported-fork-shell:target");
+      const sourceRunId = RunId.make("run:projection-imported-fork-shell:source");
+      const rootNodeId = NodeId.make("node:projection-imported-fork-shell:source");
+
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-imported-fork-shell:source-thread"),
+        type: "thread.created",
+        threadId: sourceThreadId,
+        occurredAt: now,
+        payload: {
+          createdBy: "system",
+          creationSource: "server",
+          id: sourceThreadId,
+          projectId,
+          title: "Imported fork source",
+          providerInstanceId,
+          modelSelection,
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          branch: null,
+          worktreePath: null,
+          activeProviderThreadId: null,
+          historyOrigin: "v1_import",
+          lineage: {
+            parentThreadId: null,
+            relationshipToParent: null,
+            rootThreadId: sourceThreadId,
+          },
+          forkedFrom: null,
+          createdAt: now,
+          updatedAt: now,
+          archivedAt: null,
+          settledOverride: null,
+          settledAt: null,
+          lastVisitedAt: null,
+          deletedAt: null,
+        },
+      });
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-imported-fork-shell:target-thread"),
+        type: "thread.created",
+        threadId: targetThreadId,
+        occurredAt: now,
+        payload: {
+          createdBy: "user",
+          creationSource: "web",
+          id: targetThreadId,
+          projectId,
+          title: "Imported fork target",
+          providerInstanceId,
+          modelSelection,
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          branch: null,
+          worktreePath: null,
+          activeProviderThreadId: null,
+          lineage: {
+            parentThreadId: sourceThreadId,
+            relationshipToParent: "fork",
+            rootThreadId: sourceThreadId,
+          },
+          forkedFrom: {
+            type: "run",
+            threadId: sourceThreadId,
+            runId: sourceRunId,
+          },
+          createdAt: now,
+          updatedAt: now,
+          archivedAt: null,
+          settledOverride: null,
+          settledAt: null,
+          lastVisitedAt: null,
+          deletedAt: null,
+        },
+      });
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-imported-fork-shell:source-run"),
+        type: "run.created",
+        threadId: sourceThreadId,
+        runId: sourceRunId,
+        nodeId: rootNodeId,
+        driver,
+        occurredAt: now,
+        payload: {
+          id: sourceRunId,
+          threadId: sourceThreadId,
+          ordinal: 1,
+          providerInstanceId,
+          modelSelection,
+          providerThreadId: null,
+          userMessageId: MessageId.make("message:projection-imported-fork-shell:run"),
+          rootNodeId,
+          activeAttemptId: null,
+          status: "completed",
+          requestedAt: now,
+          startedAt: now,
+          completedAt: now,
+          checkpointId: null,
+          contextHandoffId: null,
+        },
+      });
+
+      const applyAssistantItem = (suffix: string, runId: RunId | null, ordinal: number) =>
+        projectionStore.apply({
+          id: EventId.make(`event:projection-imported-fork-shell:item:${suffix}`),
+          type: "turn-item.updated",
+          threadId: sourceThreadId,
+          ...(runId === null ? {} : { runId }),
+          occurredAt: now,
+          payload: {
+            id: TurnItemId.make(`turn-item:projection-imported-fork-shell:${suffix}`),
+            threadId: sourceThreadId,
+            runId,
+            nodeId: null,
+            providerThreadId: null,
+            providerTurnId: null,
+            nativeItemRef: null,
+            parentItemId: null,
+            ordinal,
+            status: "completed",
+            title: null,
+            startedAt: now,
+            completedAt: now,
+            updatedAt: now,
+            type: "assistant_message",
+            messageId: MessageId.make(`message:projection-imported-fork-shell:${suffix}`),
+            text: suffix,
+            streaming: false,
+          },
+        });
+
+      yield* applyAssistantItem("imported-one", null, 1);
+      yield* applyAssistantItem("imported-two", null, 2);
+      yield* applyAssistantItem("native-run", sourceRunId, 3);
+
+      const shell = yield* projectionStore.getShellSnapshot();
+      const targetShell = shell.threads.find((thread) => thread.id === targetThreadId);
+      const targetProjection = yield* projectionStore.getThreadProjection(targetThreadId);
+
+      assert.isDefined(targetShell);
+      assert.equal(targetShell.itemCount, 0);
+      assert.equal(targetShell.visibleItemCount, 4);
+      assert.equal(targetProjection.visibleTurnItems.length, 4);
+    }),
+  );
+
+  it.effect("removes rolled back runs from the active visible projection", () =>
+    Effect.gen(function* () {
+      const projectionStore = yield* ProjectionStoreV2;
+      const now = yield* DateTime.now;
+      const threadId = ThreadId.make("thread:projection-rollback-prune");
+      const projectId = ProjectId.make("project:projection-rollback-prune");
+      const runId = RunId.make("run:projection-rollback-prune");
+      const attemptId = RunAttemptId.make("attempt:projection-rollback-prune");
+      const rootNodeId = NodeId.make("node:projection-rollback-prune:root");
+      const assistantNodeId = NodeId.make("node:projection-rollback-prune:assistant");
+      const providerThreadId = ProviderThreadId.make("provider-thread:projection-rollback-prune");
+      const providerTurnId = ProviderTurnId.make("provider-turn:projection-rollback-prune");
+      const userMessageId = MessageId.make("message:projection-rollback-prune:user");
+      const assistantMessageId = MessageId.make("message:projection-rollback-prune:assistant");
+      const userTurnItemId = TurnItemId.make("turn-item:projection-rollback-prune:user");
+      const assistantTurnItemId = TurnItemId.make("turn-item:projection-rollback-prune:assistant");
+      const backgroundTurnItemId = TurnItemId.make(
+        "turn-item:projection-rollback-prune:background",
+      );
+
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-rollback-prune:thread-created"),
+        type: "thread.created",
+        threadId,
+        occurredAt: now,
+        payload: {
+          createdBy: "user",
+          creationSource: "web",
+          id: threadId,
+          projectId,
+          title: "Projection rollback prune",
+          providerInstanceId,
+          modelSelection,
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          branch: null,
+          worktreePath: null,
+          activeProviderThreadId: providerThreadId,
+          lineage: {
+            parentThreadId: null,
+            relationshipToParent: null,
+            rootThreadId: threadId,
+          },
+          forkedFrom: null,
+          createdAt: now,
+          updatedAt: now,
+          archivedAt: null,
+          settledOverride: null,
+          settledAt: null,
+          lastVisitedAt: null,
+          deletedAt: null,
+        },
+      });
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-rollback-prune:provider-thread"),
+        type: "provider-thread.updated",
+        threadId,
+        driver,
+        occurredAt: now,
+        payload: {
+          id: providerThreadId,
+          driver,
+          providerInstanceId,
+          providerSessionId: null,
+          appThreadId: threadId,
+          ownerNodeId: null,
+          nativeThreadRef: null,
+          nativeConversationHeadRef: null,
+          status: "active",
+          firstRunOrdinal: 1,
+          lastRunOrdinal: 1,
+          handoffIds: [],
+          forkedFrom: null,
+          createdAt: now,
+          updatedAt: now,
+        },
+      });
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-rollback-prune:run-created"),
+        type: "run.created",
+        threadId,
+        runId,
+        nodeId: rootNodeId,
+        driver,
+        occurredAt: now,
+        payload: {
+          id: runId,
+          threadId,
+          ordinal: 1,
+          providerInstanceId,
+          modelSelection,
+          providerThreadId,
+          userMessageId,
+          rootNodeId,
+          activeAttemptId: attemptId,
+          status: "completed",
+          requestedAt: now,
+          startedAt: now,
+          completedAt: now,
+          checkpointId: null,
+          contextHandoffId: null,
+        },
+      });
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-rollback-prune:attempt-created"),
+        type: "run-attempt.created",
+        threadId,
+        runId,
+        nodeId: rootNodeId,
+        driver,
+        occurredAt: now,
+        payload: {
+          id: attemptId,
+          runId,
+          attemptOrdinal: 1,
+          rootNodeId,
+          providerInstanceId,
+          providerThreadId,
+          providerTurnId,
+          reason: "initial",
+          status: "completed",
+          startedAt: now,
+          completedAt: now,
+        },
+      });
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-rollback-prune:root-node"),
+        type: "node.updated",
+        threadId,
+        runId,
+        nodeId: rootNodeId,
+        driver,
+        occurredAt: now,
+        payload: {
+          id: rootNodeId,
+          threadId,
+          runId,
+          parentNodeId: null,
+          rootNodeId,
+          kind: "root_turn",
+          status: "completed",
+          countsForRun: true,
+          providerThreadId,
+          providerTurnId: null,
+          nativeItemRef: null,
+          runtimeRequestId: null,
+          checkpointScopeId: null,
+          startedAt: now,
+          completedAt: now,
+        },
+      });
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-rollback-prune:assistant-node"),
+        type: "node.updated",
+        threadId,
+        runId,
+        nodeId: assistantNodeId,
+        driver,
+        occurredAt: now,
+        payload: {
+          id: assistantNodeId,
+          threadId,
+          runId,
+          parentNodeId: rootNodeId,
+          rootNodeId,
+          kind: "assistant_message",
+          status: "completed",
+          countsForRun: false,
+          providerThreadId,
+          providerTurnId,
+          nativeItemRef: null,
+          runtimeRequestId: null,
+          checkpointScopeId: null,
+          startedAt: now,
+          completedAt: now,
+        },
+      });
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-rollback-prune:provider-turn"),
+        type: "provider-turn.updated",
+        threadId,
+        runId,
+        nodeId: rootNodeId,
+        driver,
+        occurredAt: now,
+        payload: {
+          id: providerTurnId,
+          providerThreadId,
+          nodeId: rootNodeId,
+          runAttemptId: attemptId,
+          nativeTurnRef: null,
+          ordinal: 1,
+          status: "completed",
+          startedAt: now,
+          completedAt: now,
+        },
+      });
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-rollback-prune:user-message"),
+        type: "message.updated",
+        threadId,
+        runId,
+        nodeId: rootNodeId,
+        driver,
+        occurredAt: now,
+        payload: {
+          createdBy: "user",
+          creationSource: "web",
+          id: userMessageId,
+          threadId,
+          runId,
+          nodeId: rootNodeId,
+          role: "user",
+          text: "rolled back user",
+          attachments: [],
+          streaming: false,
+          createdAt: now,
+          updatedAt: now,
+        },
+      });
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-rollback-prune:assistant-message"),
+        type: "message.updated",
+        threadId,
+        runId,
+        nodeId: assistantNodeId,
+        driver,
+        occurredAt: now,
+        payload: {
+          createdBy: "agent",
+          creationSource: "provider",
+          id: assistantMessageId,
+          threadId,
+          runId,
+          nodeId: assistantNodeId,
+          role: "assistant",
+          text: "rolled back assistant",
+          attachments: [],
+          streaming: false,
+          createdAt: now,
+          updatedAt: now,
+        },
+      });
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-rollback-prune:user-item"),
+        type: "turn-item.updated",
+        threadId,
+        runId,
+        nodeId: rootNodeId,
+        driver,
+        occurredAt: now,
+        payload: {
+          createdBy: "user",
+          creationSource: "web",
+          id: userTurnItemId,
+          threadId,
+          runId,
+          nodeId: rootNodeId,
+          providerThreadId,
+          providerTurnId: null,
+          nativeItemRef: null,
+          parentItemId: null,
+          ordinal: 100,
+          status: "completed",
+          title: null,
+          startedAt: now,
+          completedAt: now,
+          updatedAt: now,
+          type: "user_message",
+          messageId: userMessageId,
+          inputIntent: "turn_start",
+          text: "rolled back user",
+          attachments: [],
+        },
+      });
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-rollback-prune:assistant-item"),
+        type: "turn-item.updated",
+        threadId,
+        runId,
+        nodeId: assistantNodeId,
+        driver,
+        occurredAt: now,
+        payload: {
+          id: assistantTurnItemId,
+          threadId,
+          runId,
+          nodeId: assistantNodeId,
+          providerThreadId,
+          providerTurnId,
+          nativeItemRef: null,
+          parentItemId: null,
+          ordinal: 101,
+          status: "completed",
+          title: null,
+          startedAt: now,
+          completedAt: now,
+          updatedAt: now,
+          type: "assistant_message",
+          messageId: assistantMessageId,
+          text: "rolled back assistant",
+          streaming: false,
+        },
+      });
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-rollback-prune:background-item"),
+        type: "turn-item.updated",
+        threadId,
+        runId,
+        nodeId: rootNodeId,
+        driver,
+        occurredAt: now,
+        payload: {
+          id: backgroundTurnItemId,
+          threadId,
+          runId,
+          nodeId: rootNodeId,
+          providerThreadId,
+          providerTurnId: null,
+          nativeItemRef: null,
+          parentItemId: null,
+          ordinal: 300,
+          status: "running",
+          title: "rolled back background command",
+          startedAt: now,
+          completedAt: null,
+          updatedAt: now,
+          type: "command_execution",
+          input: "sleep 60",
+        },
+      });
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-rollback-prune:run-rolled-back"),
+        type: "run.updated",
+        threadId,
+        runId,
+        nodeId: rootNodeId,
+        driver,
+        occurredAt: now,
+        payload: {
+          id: runId,
+          threadId,
+          ordinal: 1,
+          providerInstanceId,
+          modelSelection,
+          providerThreadId,
+          userMessageId,
+          rootNodeId,
+          activeAttemptId: attemptId,
+          status: "rolled_back",
+          requestedAt: now,
+          startedAt: now,
+          completedAt: now,
+          checkpointId: null,
+          contextHandoffId: null,
+        },
+      });
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-rollback-prune:root-rolled-back"),
+        type: "node.updated",
+        threadId,
+        runId,
+        nodeId: rootNodeId,
+        driver,
+        occurredAt: now,
+        payload: {
+          id: rootNodeId,
+          threadId,
+          runId,
+          parentNodeId: null,
+          rootNodeId,
+          kind: "root_turn",
+          status: "rolled_back",
+          countsForRun: true,
+          providerThreadId,
+          providerTurnId: null,
+          nativeItemRef: null,
+          runtimeRequestId: null,
+          checkpointScopeId: null,
+          startedAt: now,
+          completedAt: now,
+        },
+      });
+
+      const projection = yield* projectionStore.getThreadProjection(threadId);
+
+      assert.deepEqual(
+        projection.runs.map((run) => run.status),
+        ["rolled_back"],
+      );
+      assert.deepEqual(
+        projection.nodes.map((node) => [node.id, node.status]),
+        [
+          [assistantNodeId, "completed"],
+          [rootNodeId, "rolled_back"],
+        ],
+      );
+      assert.lengthOf(projection.providerTurns, 1);
+      assert.lengthOf(projection.messages, 2);
+      assert.lengthOf(projection.turnItems, 3);
+      assert.lengthOf(projection.visibleTurnItems, 0);
+
+      // A rolled-back run's background item is abandoned, not pending. The
+      // shell must not report it as Waiting, or the sidebar shows Waiting for
+      // work nothing will ever finish.
+      const shell = yield* projectionStore.getShellSnapshot();
+      const rolledBackShellThread = shell.threads.find((entry) => entry.id === threadId);
+      assert.isDefined(rolledBackShellThread);
+      assert.isNull(rolledBackShellThread.latestVisibleMessage);
+      assert.deepEqual(rolledBackShellThread?.pendingBackgroundTasks ?? [], []);
+    }),
+  );
+
+  it.effect("keeps fork visible items stable after a source run is rolled back", () =>
+    Effect.gen(function* () {
+      const projectionStore = yield* ProjectionStoreV2;
+      const sql = yield* SqlClient.SqlClient;
+      const now = yield* DateTime.now;
+      const projectId = ProjectId.make("project:projection-fork-source-rollback");
+      const sourceThreadId = ThreadId.make("thread:projection-fork-source-rollback:source");
+      const targetThreadId = ThreadId.make("thread:projection-fork-source-rollback:target");
+      const sourceProviderThreadId = ProviderThreadId.make(
+        "provider-thread:projection-fork-source-rollback:source",
+      );
+      const targetProviderThreadId = ProviderThreadId.make(
+        "provider-thread:projection-fork-source-rollback:target",
+      );
+      const sourceRun1Id = RunId.make("run:projection-fork-source-rollback:source:1");
+      const sourceRun2Id = RunId.make("run:projection-fork-source-rollback:source:2");
+      const sourceRun3Id = RunId.make("run:projection-fork-source-rollback:source:3");
+      const sourceRun1NodeId = NodeId.make("node:projection-fork-source-rollback:source:1");
+      const sourceRun2NodeId = NodeId.make("node:projection-fork-source-rollback:source:2");
+      const sourceRun3NodeId = NodeId.make("node:projection-fork-source-rollback:source:3");
+
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-fork-source-rollback:source-thread"),
+        type: "thread.created",
+        threadId: sourceThreadId,
+        occurredAt: now,
+        payload: {
+          createdBy: "user",
+          creationSource: "web",
+          id: sourceThreadId,
+          projectId,
+          title: "Projection fork source rollback source",
+          providerInstanceId,
+          modelSelection,
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          branch: null,
+          worktreePath: null,
+          activeProviderThreadId: sourceProviderThreadId,
+          lineage: {
+            parentThreadId: null,
+            relationshipToParent: null,
+            rootThreadId: sourceThreadId,
+          },
+          forkedFrom: null,
+          createdAt: now,
+          updatedAt: now,
+          archivedAt: null,
+          settledOverride: null,
+          settledAt: null,
+          lastVisitedAt: null,
+          deletedAt: null,
+        },
+      });
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-fork-source-rollback:target-thread"),
+        type: "thread.created",
+        threadId: targetThreadId,
+        occurredAt: now,
+        payload: {
+          createdBy: "user",
+          creationSource: "web",
+          id: targetThreadId,
+          projectId,
+          title: "Projection fork source rollback target",
+          providerInstanceId,
+          modelSelection,
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          branch: null,
+          worktreePath: null,
+          activeProviderThreadId: targetProviderThreadId,
+          lineage: {
+            parentThreadId: sourceThreadId,
+            relationshipToParent: "fork",
+            rootThreadId: sourceThreadId,
+          },
+          forkedFrom: {
+            type: "run",
+            threadId: sourceThreadId,
+            runId: sourceRun2Id,
+          },
+          createdAt: now,
+          updatedAt: now,
+          archivedAt: null,
+          settledOverride: null,
+          settledAt: null,
+          lastVisitedAt: null,
+          deletedAt: null,
+        },
+      });
+
+      for (const [ordinal, runId, nodeId, promptText, responseText] of [
+        [1, sourceRun1Id, sourceRun1NodeId, "source one", "one"],
+        [2, sourceRun2Id, sourceRun2NodeId, "source two", "two"],
+      ] as const) {
+        yield* projectionStore.apply({
+          id: EventId.make(`event:projection-fork-source-rollback:run-${ordinal}`),
+          type: "run.created",
+          threadId: sourceThreadId,
+          runId,
+          nodeId,
+          driver,
+          occurredAt: now,
+          payload: {
+            id: runId,
+            threadId: sourceThreadId,
+            ordinal,
+            providerInstanceId,
+            modelSelection,
+            providerThreadId: sourceProviderThreadId,
+            userMessageId: MessageId.make(
+              `message:projection-fork-source-rollback:user:${ordinal}`,
+            ),
+            rootNodeId: nodeId,
+            activeAttemptId: null,
+            status: "completed",
+            requestedAt: now,
+            startedAt: now,
+            completedAt: now,
+            checkpointId: null,
+            contextHandoffId: null,
+          },
+        });
+        yield* projectionStore.apply({
+          id: EventId.make(`event:projection-fork-source-rollback:user-item-${ordinal}`),
+          type: "turn-item.updated",
+          threadId: sourceThreadId,
+          runId,
+          nodeId,
+          driver,
+          occurredAt: now,
+          payload: {
+            createdBy: "user",
+            creationSource: "web",
+            id: TurnItemId.make(`turn-item:projection-fork-source-rollback:user:${ordinal}`),
+            threadId: sourceThreadId,
+            runId,
+            nodeId,
+            providerThreadId: sourceProviderThreadId,
+            providerTurnId: null,
+            nativeItemRef: null,
+            parentItemId: null,
+            ordinal: ordinal * 100,
+            status: "completed",
+            title: null,
+            startedAt: now,
+            completedAt: now,
+            updatedAt: now,
+            type: "user_message",
+            messageId: MessageId.make(`message:projection-fork-source-rollback:user:${ordinal}`),
+            inputIntent: "turn_start",
+            text: promptText,
+            attachments: [],
+          },
+        });
+        yield* projectionStore.apply({
+          id: EventId.make(`event:projection-fork-source-rollback:assistant-item-${ordinal}`),
+          type: "turn-item.updated",
+          threadId: sourceThreadId,
+          runId,
+          nodeId,
+          driver,
+          occurredAt: now,
+          payload: {
+            id: TurnItemId.make(`turn-item:projection-fork-source-rollback:assistant:${ordinal}`),
+            threadId: sourceThreadId,
+            runId,
+            nodeId,
+            providerThreadId: sourceProviderThreadId,
+            providerTurnId: null,
+            nativeItemRef: null,
+            parentItemId: null,
+            ordinal: ordinal * 100 + 1,
+            status: "completed",
+            title: null,
+            startedAt: now,
+            completedAt: now,
+            updatedAt: now,
+            type: "assistant_message",
+            messageId: MessageId.make(
+              `message:projection-fork-source-rollback:assistant:${ordinal}`,
+            ),
+            text: responseText,
+            streaming: false,
+          },
+        });
+      }
+
+      const targetBeforeRollback = yield* projectionStore.getThreadProjection(targetThreadId);
+      assert.deepEqual(
+        targetBeforeRollback.visibleTurnItems.map((row) => row.item.type),
+        ["user_message", "assistant_message", "user_message", "assistant_message", "fork"],
+      );
+
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-fork-source-rollback:run-2-rolled-back"),
+        type: "run.updated",
+        threadId: sourceThreadId,
+        runId: sourceRun2Id,
+        nodeId: sourceRun2NodeId,
+        driver,
+        occurredAt: now,
+        payload: {
+          id: sourceRun2Id,
+          threadId: sourceThreadId,
+          ordinal: 2,
+          providerInstanceId,
+          modelSelection,
+          providerThreadId: sourceProviderThreadId,
+          userMessageId: MessageId.make("message:projection-fork-source-rollback:user:2"),
+          rootNodeId: sourceRun2NodeId,
+          activeAttemptId: null,
+          status: "rolled_back",
+          requestedAt: now,
+          startedAt: now,
+          completedAt: now,
+          checkpointId: null,
+          contextHandoffId: null,
+        },
+      });
+
+      const targetAfterRollback = yield* projectionStore.getThreadProjection(targetThreadId);
+      assert.deepEqual(
+        targetAfterRollback.visibleTurnItems.map((row) => [
+          row.visibility,
+          row.item.type,
+          row.item.type === "user_message" || row.item.type === "assistant_message"
+            ? row.item.text
+            : row.item.title,
+        ]),
+        [
+          ["inherited", "user_message", "source one"],
+          ["inherited", "assistant_message", "one"],
+          ["inherited", "user_message", "source two"],
+          ["inherited", "assistant_message", "two"],
+          ["synthetic", "fork", "Forked from conversation"],
+        ],
+      );
+
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-fork-source-rollback:run-3"),
+        type: "run.updated",
+        threadId: sourceThreadId,
+        runId: sourceRun3Id,
+        nodeId: sourceRun3NodeId,
+        driver,
+        occurredAt: now,
+        payload: {
+          id: sourceRun3Id,
+          threadId: sourceThreadId,
+          ordinal: 4,
+          providerInstanceId,
+          modelSelection,
+          providerThreadId: sourceProviderThreadId,
+          userMessageId: MessageId.make("message:projection-fork-source-rollback:user:3"),
+          rootNodeId: sourceRun3NodeId,
+          activeAttemptId: null,
+          status: "completed",
+          requestedAt: now,
+          startedAt: now,
+          completedAt: now,
+          checkpointId: null,
+          contextHandoffId: null,
+        },
+      });
+      const nowIso = DateTime.formatIso(now);
+      for (let index = 0; index < 300; index += 1) {
+        const id = `turn-item:projection-fork-source-rollback:post-fork:${index}`;
+        const ordinal = index < 10 ? 190 + index : 300 + index;
+        yield* sql`
+          INSERT INTO orchestration_v2_projection_turn_items (
+            turn_item_id, thread_id, run_id, node_id, provider_thread_id, provider_turn_id,
+            parent_item_id, ordinal, type, status, updated_at, payload_json
+          ) VALUES (
+            ${id}, ${sourceThreadId}, ${sourceRun3Id}, ${sourceRun3NodeId},
+            ${sourceProviderThreadId}, NULL, NULL, ${ordinal}, 'command_execution',
+            'completed', ${nowIso}, ${encodeUnknownJsonString({
+              id,
+              threadId: sourceThreadId,
+              runId: sourceRun3Id,
+              nodeId: sourceRun3NodeId,
+              providerThreadId: sourceProviderThreadId,
+              providerTurnId: null,
+              nativeItemRef: null,
+              parentItemId: null,
+              ordinal,
+              status: "completed",
+              title: "post fork",
+              input: "echo later",
+              output: "later",
+              exitCode: 0,
+              startedAt: nowIso,
+              completedAt: nowIso,
+              updatedAt: nowIso,
+              type: "command_execution",
+            })}
+          )
+        `;
+      }
+
+      const boundedFork = yield* projectionStore.getThreadSnapshotWindow(targetThreadId, {
+        rowLimit: 2,
+      });
+      assert.lengthOf(boundedFork.projection.turnItems, 0);
+      assert.deepEqual(
+        boundedFork.projection.visibleTurnItems.map((row) => [row.visibility, row.item.type]),
+        [
+          ["inherited", "user_message"],
+          ["inherited", "assistant_message"],
+          ["synthetic", "fork"],
+        ],
+      );
+      const parentPage = yield* projectionStore.getThreadSnapshotWindow(targetThreadId, {
+        rowLimit: 2,
+        anchorItemId: TurnItemId.make("turn-item:projection-fork-source-rollback:assistant:1"),
+      });
+      assert.deepEqual(
+        parentPage.projection.visibleTurnItems.map((row) =>
+          row.item.type === "user_message" || row.item.type === "assistant_message"
+            ? row.item.text
+            : row.item.type,
+        ),
+        ["source one", "one", "fork"],
+      );
+
+      const emptyBoundaryRunId = RunId.make(
+        "run:projection-fork-source-rollback:source:empty-boundary",
+      );
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-fork-source-rollback:empty-boundary-run"),
+        type: "run.updated",
+        threadId: sourceThreadId,
+        runId: emptyBoundaryRunId,
+        nodeId: NodeId.make("node:projection-fork-source-rollback:source:empty-boundary"),
+        driver,
+        occurredAt: now,
+        payload: {
+          id: emptyBoundaryRunId,
+          threadId: sourceThreadId,
+          ordinal: 3,
+          providerInstanceId,
+          modelSelection,
+          providerThreadId: sourceProviderThreadId,
+          userMessageId: MessageId.make(
+            "message:projection-fork-source-rollback:user:empty-boundary",
+          ),
+          rootNodeId: NodeId.make("node:projection-fork-source-rollback:source:empty-boundary"),
+          activeAttemptId: null,
+          status: "completed",
+          requestedAt: now,
+          startedAt: now,
+          completedAt: now,
+          checkpointId: null,
+          contextHandoffId: null,
+        },
+      });
+      yield* sql`
+        UPDATE orchestration_v2_projection_threads
+        SET payload_json = json_set(payload_json, '$.forkedFrom.runId', ${emptyBoundaryRunId})
+        WHERE thread_id = ${targetThreadId}
+      `;
+      const emptyBoundaryFork = yield* projectionStore.getThreadSnapshotWindow(targetThreadId, {
+        rowLimit: 2,
+      });
+      assert.deepEqual(
+        emptyBoundaryFork.projection.visibleTurnItems.map((row) =>
+          row.item.type === "user_message" || row.item.type === "assistant_message"
+            ? row.item.text
+            : row.item.type,
+        ),
+        ["source two", "two", "fork"],
+      );
+      yield* sql`
+        UPDATE orchestration_v2_projection_threads
+        SET payload_json = json_set(payload_json, '$.forkedFrom.runId', ${sourceRun2Id})
+        WHERE thread_id = ${targetThreadId}
+      `;
+
+      const targetRunId = RunId.make("run:projection-fork-source-rollback:target:1");
+      const targetNodeId = NodeId.make("node:projection-fork-source-rollback:target:1");
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-fork-source-rollback:target-run"),
+        type: "run.updated",
+        threadId: targetThreadId,
+        runId: targetRunId,
+        nodeId: targetNodeId,
+        driver,
+        occurredAt: now,
+        payload: {
+          id: targetRunId,
+          threadId: targetThreadId,
+          ordinal: 1,
+          providerInstanceId,
+          modelSelection,
+          providerThreadId: targetProviderThreadId,
+          userMessageId: MessageId.make("message:projection-fork-source-rollback:target:1"),
+          rootNodeId: targetNodeId,
+          activeAttemptId: null,
+          status: "completed",
+          requestedAt: now,
+          startedAt: now,
+          completedAt: now,
+          checkpointId: null,
+          contextHandoffId: null,
+        },
+      });
+      for (let ordinal = 1; ordinal <= 2; ordinal += 1) {
+        const id = `turn-item:projection-fork-source-rollback:target:${ordinal}`;
+        yield* sql`
+          INSERT INTO orchestration_v2_projection_turn_items (
+            turn_item_id, thread_id, run_id, node_id, provider_thread_id, provider_turn_id,
+            parent_item_id, ordinal, type, status, updated_at, payload_json
+          ) VALUES (
+            ${id}, ${targetThreadId}, ${targetRunId}, ${targetNodeId}, ${targetProviderThreadId},
+            NULL, NULL, ${ordinal}, 'command_execution', 'completed', ${nowIso},
+            ${encodeUnknownJsonString({
+              id,
+              threadId: targetThreadId,
+              runId: targetRunId,
+              nodeId: targetNodeId,
+              providerThreadId: targetProviderThreadId,
+              providerTurnId: null,
+              nativeItemRef: null,
+              parentItemId: null,
+              ordinal,
+              status: "completed",
+              title: `target ${ordinal}`,
+              input: `echo target ${ordinal}`,
+              output: "target",
+              exitCode: 0,
+              startedAt: nowIso,
+              completedAt: nowIso,
+              updatedAt: nowIso,
+              type: "command_execution",
+            })}
+          )
+        `;
+      }
+      const nestedThreadId = ThreadId.make("thread:projection-fork-source-rollback:nested");
+      for (const ordinal of [
+        ...Array.from({ length: 99 }, (_, index) => index + 1),
+        ...Array.from({ length: 99 }, (_, index) => index + 101),
+      ]) {
+        const runId = ordinal < 100 ? sourceRun1Id : sourceRun2Id;
+        const id = `turn-item:projection-fork-source-rollback:lineage:${ordinal}`;
+        yield* sql`
+          INSERT INTO orchestration_v2_projection_turn_items (
+            turn_item_id, thread_id, run_id, node_id, provider_thread_id, provider_turn_id,
+            parent_item_id, ordinal, type, status, updated_at, payload_json
+          ) VALUES (
+            ${id}, ${sourceThreadId}, ${runId}, NULL, NULL, NULL, NULL, ${ordinal},
+            'command_execution', 'completed', ${nowIso},
+            ${encodeUnknownJsonString({
+              id,
+              threadId: sourceThreadId,
+              runId,
+              nodeId: null,
+              providerThreadId: null,
+              providerTurnId: null,
+              nativeItemRef: null,
+              parentItemId: null,
+              ordinal,
+              status: "completed",
+              title: `lineage ${ordinal}`,
+              input: "echo lineage",
+              output: "lineage",
+              exitCode: 0,
+              startedAt: nowIso,
+              completedAt: nowIso,
+              updatedAt: nowIso,
+              type: "command_execution",
+            })}
+          )
+        `;
+      }
+      const inheritedSupersededNodeId = NodeId.make(
+        "node:projection-fork-source-rollback:inherited-superseded",
+      );
+      yield* sql`
+        INSERT INTO orchestration_v2_projection_run_attempts (
+          attempt_id, thread_id, run_id, attempt_ordinal, root_node_id, provider,
+          provider_instance_id, provider_thread_id, provider_turn_id, status, payload_json
+        ) VALUES (
+          'attempt:projection-fork-source-rollback:inherited-superseded',
+          ${sourceThreadId}, ${sourceRun2Id}, 2, ${inheritedSupersededNodeId}, 'codex',
+          ${providerInstanceId}, ${sourceProviderThreadId}, NULL, 'superseded',
+          ${encodeUnknownJsonString({
+            id: "attempt:projection-fork-source-rollback:inherited-superseded",
+            runId: sourceRun2Id,
+            attemptOrdinal: 2,
+            rootNodeId: inheritedSupersededNodeId,
+            providerInstanceId,
+            providerThreadId: sourceProviderThreadId,
+            providerTurnId: null,
+            reason: "retry",
+            status: "superseded",
+            startedAt: nowIso,
+            completedAt: nowIso,
+          })}
+        )
+      `;
+      for (let ordinal = 201; ordinal <= 300; ordinal += 1) {
+        const id = `turn-item:projection-fork-source-rollback:hidden-interrupt:${ordinal}`;
+        yield* sql`
+          INSERT INTO orchestration_v2_projection_turn_items (
+            turn_item_id, thread_id, run_id, node_id, provider_thread_id, provider_turn_id,
+            parent_item_id, ordinal, type, status, updated_at, payload_json
+          ) VALUES (
+            ${id}, ${sourceThreadId}, ${sourceRun2Id}, ${inheritedSupersededNodeId},
+            ${sourceProviderThreadId}, NULL, NULL, ${ordinal}, 'run_interrupt_result',
+            'completed', ${nowIso},
+            ${encodeUnknownJsonString({
+              id,
+              threadId: sourceThreadId,
+              runId: sourceRun2Id,
+              nodeId: inheritedSupersededNodeId,
+              providerThreadId: sourceProviderThreadId,
+              providerTurnId: null,
+              nativeItemRef: null,
+              parentItemId: null,
+              ordinal,
+              status: "completed",
+              title: "Stopped",
+              message: "Stopped",
+              startedAt: nowIso,
+              completedAt: nowIso,
+              updatedAt: nowIso,
+              type: "run_interrupt_result",
+            })}
+          )
+        `;
+      }
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-fork-source-rollback:nested-thread"),
+        type: "thread.created",
+        threadId: nestedThreadId,
+        occurredAt: now,
+        payload: {
+          createdBy: "user",
+          creationSource: "web",
+          id: nestedThreadId,
+          projectId,
+          title: "Nested bounded fork",
+          providerInstanceId,
+          modelSelection,
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          branch: null,
+          worktreePath: null,
+          activeProviderThreadId: null,
+          lineage: {
+            parentThreadId: targetThreadId,
+            relationshipToParent: "fork",
+            rootThreadId: sourceThreadId,
+          },
+          forkedFrom: { type: "run", threadId: targetThreadId, runId: targetRunId },
+          createdAt: now,
+          updatedAt: now,
+          archivedAt: null,
+          settledOverride: null,
+          settledAt: null,
+          lastVisitedAt: null,
+          deletedAt: null,
+        },
+      });
+      const boundedNested = yield* projectionStore.getThreadSnapshotWindow(nestedThreadId, {
+        rowLimit: 2,
+      });
+      assert.deepEqual(
+        boundedNested.projection.visibleTurnItems.map((row) => row.item.type),
+        [
+          "user_message",
+          "assistant_message",
+          "fork",
+          "command_execution",
+          "command_execution",
+          "fork",
+        ],
+      );
+
+      const nestedInitial = buildBoundedThreadProjection({
+        projection: yield* projectionStore
+          .getThreadSnapshotWindow(nestedThreadId, {
+            rowLimit: THREAD_HISTORY_PAGE_POLICY.maxItems + 2,
+          })
+          .pipe(Effect.map((snapshot) => snapshot.projection)),
+        snapshotSequence: 1,
+      });
+      const expectedNestedIds = (yield* projectionStore.getThreadProjection(
+        nestedThreadId,
+      )).visibleTurnItems.map((row) => String(row.sourceItemId));
+      const nestedIds = nestedInitial.projection.visibleTurnItems.map((row) =>
+        String(row.sourceItemId),
+      );
+      let nestedCursor = nestedInitial.historyCursor;
+      let nestedPages = 1;
+      while (nestedCursor !== null) {
+        const decoded = decodeThreadHistoryCursor(nestedCursor);
+        const snapshot = yield* projectionStore.getThreadSnapshotWindow(nestedThreadId, {
+          rowLimit: THREAD_HISTORY_PAGE_POLICY.maxItems + 2,
+          anchorItemId: TurnItemId.make(decoded.si),
+          anchorThreadId: ThreadId.make(decoded.st),
+        });
+        const page = selectHistoryPageFromCursor({
+          items: snapshot.projection.visibleTurnItems,
+          cursor: nestedCursor,
+          snapshotSequence: snapshot.snapshotSequence,
+        });
+        nestedIds.unshift(...page.items.map((row) => String(row.sourceItemId)));
+        nestedCursor = page.nextCursor;
+        nestedPages += 1;
+      }
+      assert.isAtLeast(nestedPages, 3);
+      assert.lengthOf(nestedIds, expectedNestedIds.length);
+      assert.deepEqual(nestedIds, expectedNestedIds);
+
+      const emptyMiddleThreadId = ThreadId.make(
+        "thread:projection-fork-source-rollback:empty-middle",
+      );
+      const emptyMiddleRunId = RunId.make("run:projection-fork-source-rollback:empty-middle");
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-fork-source-rollback:empty-middle-thread"),
+        type: "thread.created",
+        threadId: emptyMiddleThreadId,
+        occurredAt: now,
+        payload: {
+          createdBy: "user",
+          creationSource: "web",
+          id: emptyMiddleThreadId,
+          projectId,
+          title: "Empty middle fork",
+          providerInstanceId,
+          modelSelection,
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          branch: null,
+          worktreePath: null,
+          activeProviderThreadId: null,
+          lineage: {
+            parentThreadId: sourceThreadId,
+            relationshipToParent: "fork",
+            rootThreadId: sourceThreadId,
+          },
+          forkedFrom: { type: "run", threadId: sourceThreadId, runId: sourceRun2Id },
+          createdAt: now,
+          updatedAt: now,
+          archivedAt: null,
+          settledOverride: null,
+          settledAt: null,
+          lastVisitedAt: null,
+          deletedAt: null,
+        },
+      });
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-fork-source-rollback:empty-middle-run"),
+        type: "run.updated",
+        threadId: emptyMiddleThreadId,
+        runId: emptyMiddleRunId,
+        nodeId: NodeId.make("node:projection-fork-source-rollback:empty-middle"),
+        driver,
+        occurredAt: now,
+        payload: {
+          id: emptyMiddleRunId,
+          threadId: emptyMiddleThreadId,
+          ordinal: 1,
+          providerInstanceId,
+          modelSelection,
+          providerThreadId: null,
+          userMessageId: MessageId.make("message:projection-fork-source-rollback:empty-middle"),
+          rootNodeId: NodeId.make("node:projection-fork-source-rollback:empty-middle"),
+          activeAttemptId: null,
+          status: "completed",
+          requestedAt: now,
+          startedAt: now,
+          completedAt: now,
+          checkpointId: null,
+          contextHandoffId: null,
+        },
+      });
+      const emptyLeafThreadId = ThreadId.make("thread:projection-fork-source-rollback:empty-leaf");
+      yield* projectionStore.apply({
+        id: EventId.make("event:projection-fork-source-rollback:empty-leaf-thread"),
+        type: "thread.created",
+        threadId: emptyLeafThreadId,
+        occurredAt: now,
+        payload: {
+          createdBy: "user",
+          creationSource: "web",
+          id: emptyLeafThreadId,
+          projectId,
+          title: "Leaf after empty fork",
+          providerInstanceId,
+          modelSelection,
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          branch: null,
+          worktreePath: null,
+          activeProviderThreadId: null,
+          lineage: {
+            parentThreadId: emptyMiddleThreadId,
+            relationshipToParent: "fork",
+            rootThreadId: sourceThreadId,
+          },
+          forkedFrom: {
+            type: "run",
+            threadId: emptyMiddleThreadId,
+            runId: emptyMiddleRunId,
+          },
+          createdAt: now,
+          updatedAt: now,
+          archivedAt: null,
+          settledOverride: null,
+          settledAt: null,
+          lastVisitedAt: null,
+          deletedAt: null,
+        },
+      });
+      const emptyMiddleSnapshot = yield* projectionStore.getThreadSnapshotWindow(
+        emptyLeafThreadId,
+        { rowLimit: 2 },
+      );
+      assert.deepEqual(
+        emptyMiddleSnapshot.projection.visibleTurnItems.map((row) => [
+          row.sourceThreadId,
+          row.item.type,
+        ]),
+        [
+          [sourceThreadId, "user_message"],
+          [sourceThreadId, "assistant_message"],
+          [sourceThreadId, "fork"],
+          [emptyMiddleThreadId, "fork"],
+        ],
+      );
+
+      yield* sql`
+        DELETE FROM orchestration_v2_projection_turn_items
+        WHERE run_id IN (${sourceRun1Id}, ${sourceRun2Id})
+      `;
+      const importedItemId = "turn-item:projection-fork-source-rollback:legacy-import";
+      yield* sql`
+        INSERT INTO orchestration_v2_projection_turn_items (
+          turn_item_id, thread_id, run_id, node_id, provider_thread_id, provider_turn_id,
+          parent_item_id, ordinal, type, status, updated_at, payload_json
+        ) VALUES (
+          ${importedItemId}, ${sourceThreadId}, NULL, NULL, NULL, NULL, NULL, 50,
+          'assistant_message', 'completed', ${nowIso}, ${encodeUnknownJsonString({
+            id: importedItemId,
+            threadId: sourceThreadId,
+            runId: null,
+            nodeId: null,
+            providerThreadId: null,
+            providerTurnId: null,
+            nativeItemRef: null,
+            parentItemId: null,
+            ordinal: 50,
+            status: "completed",
+            title: null,
+            startedAt: nowIso,
+            completedAt: nowIso,
+            updatedAt: nowIso,
+            type: "assistant_message",
+            messageId: MessageId.make("message:projection-fork-source-rollback:legacy-import"),
+            text: "legacy import before empty fork",
+            streaming: false,
+            historyOrigin: "v1_import",
+          })}
+        )
+      `;
+      yield* sql`
+        UPDATE orchestration_v2_projection_threads
+        SET payload_json = json_set(payload_json, '$.historyOrigin', 'v1_import')
+        WHERE thread_id = ${sourceThreadId}
+      `;
+      yield* sql`
+        UPDATE orchestration_v2_projection_threads
+        SET payload_json = json_set(payload_json, '$.forkedFrom.runId', ${emptyBoundaryRunId})
+        WHERE thread_id = ${targetThreadId}
+      `;
+      const importedEmptyBoundary = yield* projectionStore.getThreadSnapshotWindow(targetThreadId, {
+        rowLimit: 2,
+      });
+      assert.deepEqual(
+        importedEmptyBoundary.projection.visibleTurnItems.map((row) => [
+          row.visibility,
+          row.sourceThreadId,
+          row.item.type === "assistant_message" ? row.item.text : row.item.type,
+        ]),
+        [
+          ["inherited", sourceThreadId, "legacy import before empty fork"],
+          ["synthetic", sourceThreadId, "fork"],
+          ["local", targetThreadId, "command_execution"],
+          ["local", targetThreadId, "command_execution"],
+        ],
+      );
+    }),
+  );
+});
diff --git a/apps/server/src/orchestration-v2/ProjectionStore.ts b/apps/server/src/orchestration-v2/ProjectionStore.ts
new file mode 100644
index 000000000000..6e41af464445
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ProjectionStore.ts
@@ -0,0 +1,3303 @@
+import type {
+  OrchestrationV2ConversationMessage,
+  OrchestrationV2DomainEvent,
+  OrchestrationV2ProjectedTurnItem,
+  OrchestrationV2ProviderTurn,
+  OrchestrationV2Run,
+  OrchestrationV2Subagent,
+  OrchestrationV2ThreadShellSnapshot,
+  OrchestrationV2ShellThreadStatus,
+  OrchestrationV2ThreadShell,
+  OrchestrationV2ThreadProjection,
+  OrchestrationV2TurnItem,
+  ProviderSessionId,
+} from "@t3tools/contracts";
+import {
+  OrchestrationV2AppThreadJson as OrchestrationV2AppThreadJsonSchema,
+  OrchestrationV2CheckpointJson as OrchestrationV2CheckpointJsonSchema,
+  OrchestrationV2CheckpointScopeJson as OrchestrationV2CheckpointScopeJsonSchema,
+  OrchestrationV2ContextHandoffJson as OrchestrationV2ContextHandoffJsonSchema,
+  OrchestrationV2ContextTransferJson as OrchestrationV2ContextTransferJsonSchema,
+  OrchestrationV2ConversationMessageJson as OrchestrationV2ConversationMessageJsonSchema,
+  OrchestrationV2ExecutionNodeJson as OrchestrationV2ExecutionNodeJsonSchema,
+  OrchestrationV2PlanArtifact as OrchestrationV2PlanArtifactSchema,
+  OrchestrationV2ProviderSessionJson as OrchestrationV2ProviderSessionJsonSchema,
+  OrchestrationV2ProviderThreadJson as OrchestrationV2ProviderThreadJsonSchema,
+  OrchestrationV2ProviderTurnJson as OrchestrationV2ProviderTurnJsonSchema,
+  OrchestrationV2RunAttemptJson as OrchestrationV2RunAttemptJsonSchema,
+  OrchestrationV2RunJson as OrchestrationV2RunJsonSchema,
+  OrchestrationV2RuntimeRequestJson as OrchestrationV2RuntimeRequestJsonSchema,
+  OrchestrationV2SubagentJson as OrchestrationV2SubagentJsonSchema,
+  OrchestrationV2TurnItemJson as OrchestrationV2TurnItemJsonSchema,
+  RunId,
+  ThreadId,
+  TurnItemId,
+} from "@t3tools/contracts";
+import {
+  isOrchestrationV2SupersededInterrupt,
+  isOrchestrationV2TurnItemVisible,
+} from "@t3tools/shared/orchestrationV2Timeline";
+import { derivePendingBackgroundWork } from "@t3tools/shared/orchestrationV2PendingBackgroundWork";
+import * as Context from "effect/Context";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Ref from "effect/Ref";
+import * as Schema from "effect/Schema";
+import * as SqlClient from "effect/unstable/sql/SqlClient";
+
+export class ProjectionStoreApplyEventError extends Schema.TaggedErrorClass<ProjectionStoreApplyEventError>()(
+  "ProjectionStoreApplyEventError",
+  {
+    eventType: Schema.String,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to apply orchestration projection event ${this.eventType}.`;
+  }
+}
+
+export class ProjectionStoreSetupError extends Schema.TaggedErrorClass<ProjectionStoreSetupError>()(
+  "ProjectionStoreSetupError",
+  {
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return "Failed to initialize orchestration projection store.";
+  }
+}
+
+export class ProjectionStoreThreadNotFoundError extends Schema.TaggedErrorClass<ProjectionStoreThreadNotFoundError>()(
+  "ProjectionStoreThreadNotFoundError",
+  {
+    threadId: ThreadId,
+  },
+) {
+  override get message(): string {
+    return `No orchestration projection exists for thread ${this.threadId}.`;
+  }
+}
+
+export class ProjectionStoreReadError extends Schema.TaggedErrorClass<ProjectionStoreReadError>()(
+  "ProjectionStoreReadError",
+  {
+    threadId: ThreadId,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to read orchestration projection for thread ${this.threadId}.`;
+  }
+}
+
+export const ProjectionStoreV2Error = Schema.Union([
+  ProjectionStoreSetupError,
+  ProjectionStoreApplyEventError,
+  ProjectionStoreThreadNotFoundError,
+  ProjectionStoreReadError,
+]);
+export type ProjectionStoreV2Error = typeof ProjectionStoreV2Error.Type;
+
+export interface ProjectionStoreV2Shape {
+  readonly apply: (
+    event: OrchestrationV2DomainEvent,
+  ) => Effect.Effect<void, ProjectionStoreV2Error>;
+  readonly getShellSnapshot: (options?: {
+    readonly location?: "active" | "archive";
+  }) => Effect.Effect<OrchestrationV2ThreadShellSnapshot, ProjectionStoreV2Error>;
+  readonly getThreadShell: (
+    threadId: ThreadId,
+  ) => Effect.Effect<OrchestrationV2ThreadShell | null, ProjectionStoreV2Error>;
+  readonly getThreadProjection: (
+    threadId: ThreadId,
+  ) => Effect.Effect<OrchestrationV2ThreadProjection, ProjectionStoreV2Error>;
+  readonly getThreadSnapshot: (threadId: ThreadId) => Effect.Effect<
+    {
+      readonly schemaVersion: number;
+      readonly snapshotSequence: number;
+      readonly projection: OrchestrationV2ThreadProjection;
+    },
+    ProjectionStoreV2Error
+  >;
+  readonly getThreadSnapshotWindow: (
+    threadId: ThreadId,
+    options: {
+      readonly rowLimit: number;
+      readonly anchorItemId?: TurnItemId | undefined;
+      readonly anchorThreadId?: ThreadId | undefined;
+      readonly requiredRunId?: RunId | undefined;
+    },
+  ) => Effect.Effect<
+    {
+      readonly schemaVersion: number;
+      readonly snapshotSequence: number;
+      readonly projection: OrchestrationV2ThreadProjection;
+    },
+    ProjectionStoreV2Error
+  >;
+}
+
+export class ProjectionStoreV2 extends Context.Service<ProjectionStoreV2, ProjectionStoreV2Shape>()(
+  "t3/orchestration-v2/ProjectionStore/ProjectionStoreV2",
+) {}
+
+export const ORCHESTRATION_V2_PROJECTION_SCHEMA_VERSION = 2;
+
+function upsertById<T extends { readonly id: string }>(items: ReadonlyArray<T>, next: T): Array<T> {
+  const index = items.findIndex((item) => item.id === next.id);
+  if (index === -1) {
+    return [...items, next];
+  }
+
+  const updated = [...items];
+  updated[index] = next;
+  return updated;
+}
+
+export function upsertProviderTurn(
+  turns: ReadonlyArray<OrchestrationV2ProviderTurn>,
+  next: OrchestrationV2ProviderTurn,
+): Array<OrchestrationV2ProviderTurn> {
+  const current = turns.find((turn) => turn.id === next.id);
+  return upsertById(turns, {
+    ...next,
+    ...((next.tokenUsage ?? current?.tokenUsage) === undefined
+      ? {}
+      : { tokenUsage: next.tokenUsage ?? current?.tokenUsage }),
+  });
+}
+
+function preserveDelegatedCompletion(
+  current: OrchestrationV2Run | undefined,
+  next: OrchestrationV2Run,
+): OrchestrationV2Run {
+  if (next.delegatedCompletion !== undefined || current?.delegatedCompletion === undefined) {
+    return next;
+  }
+  return { ...next, delegatedCompletion: current.delegatedCompletion };
+}
+
+function preserveCompletionDelivery(
+  current: OrchestrationV2Subagent | undefined,
+  next: OrchestrationV2Subagent,
+): OrchestrationV2Subagent {
+  if (next.completionDelivery !== undefined || current?.completionDelivery === undefined) {
+    return next;
+  }
+  return { ...next, completionDelivery: current.completionDelivery };
+}
+
+export function emptyProjection(
+  event: Extract<OrchestrationV2DomainEvent, { readonly type: "thread.created" }>,
+): OrchestrationV2ThreadProjection {
+  return {
+    thread: event.payload,
+    runs: [],
+    attempts: [],
+    nodes: [],
+    subagents: [],
+    providerSessions: [],
+    providerThreads: [],
+    providerTurns: [],
+    runtimeRequests: [],
+    messages: [],
+    plans: [],
+    turnItems: [],
+    checkpointScopes: [],
+    checkpoints: [],
+    contextHandoffs: [],
+    contextTransfers: [],
+    visibleTurnItems: [],
+    updatedAt: event.occurredAt,
+  };
+}
+
+export function applyToProjection(
+  projection: OrchestrationV2ThreadProjection,
+  event: OrchestrationV2DomainEvent,
+): OrchestrationV2ThreadProjection {
+  const base = {
+    ...projection,
+    thread: {
+      ...projection.thread,
+      updatedAt: event.occurredAt,
+    },
+    updatedAt: event.occurredAt,
+  };
+
+  switch (event.type) {
+    case "thread.created":
+    case "thread.archived":
+    case "thread.unarchived":
+    case "thread.deleted":
+    case "thread.settled":
+    case "thread.unsettled":
+    case "thread.snoozed":
+    case "thread.unsnoozed":
+    case "thread.pinned":
+    case "thread.unpinned":
+    case "thread.pin-reordered":
+    case "thread.metadata-updated":
+    case "thread.runtime-mode-updated":
+    case "thread.interaction-mode-updated":
+    case "thread.model-selection-updated":
+    case "thread.provider-switched":
+      return {
+        ...base,
+        thread: event.payload,
+      };
+    // Visited tracking is read state, not activity: skip the updatedAt bump so
+    // viewing a thread does not surface it as recently active.
+    case "thread.visited":
+    case "thread.marked-unread":
+      return {
+        ...projection,
+        thread: event.payload,
+      };
+    case "run.created":
+    case "run.updated":
+      return withLocalVisibleTurnItems({
+        ...base,
+        runs: upsertById(
+          base.runs,
+          preserveDelegatedCompletion(
+            base.runs.find((run) => run.id === event.payload.id),
+            event.payload,
+          ),
+        ),
+      });
+    case "run-attempt.created":
+    case "run-attempt.updated":
+      return withLocalVisibleTurnItems({
+        ...base,
+        attempts: upsertById(base.attempts, event.payload),
+      });
+    case "node.updated":
+      return {
+        ...base,
+        nodes: upsertById(base.nodes, event.payload),
+      };
+    case "subagent.updated":
+      return {
+        ...base,
+        subagents: upsertById(
+          base.subagents,
+          preserveCompletionDelivery(
+            base.subagents.find((task) => task.id === event.payload.id),
+            event.payload,
+          ),
+        ),
+      };
+    case "provider-session.attached":
+    case "provider-session.updated":
+      return {
+        ...base,
+        providerSessions: upsertById(base.providerSessions, event.payload),
+      };
+    case "provider-session.detached":
+      return {
+        ...base,
+        providerSessions: base.providerSessions.filter(
+          (session) => session.id !== event.payload.providerSessionId,
+        ),
+      };
+    case "provider-thread.updated":
+      return {
+        ...base,
+        thread:
+          event.payload.appThreadId === base.thread.id
+            ? {
+                ...base.thread,
+                activeProviderThreadId: event.payload.id,
+              }
+            : base.thread,
+        providerThreads: upsertById(base.providerThreads, event.payload),
+      };
+    case "provider-turn.updated":
+      return {
+        ...base,
+        providerTurns: upsertProviderTurn(base.providerTurns, event.payload),
+      };
+    case "runtime-request.updated":
+      return {
+        ...base,
+        runtimeRequests: upsertById(base.runtimeRequests, event.payload),
+      };
+    case "message.updated":
+      return {
+        ...base,
+        messages: upsertById(base.messages, event.payload),
+      };
+    case "turn-item.updated":
+      return withLocalVisibleTurnItems({
+        ...base,
+        turnItems: upsertById(base.turnItems, event.payload),
+      });
+    case "plan.updated":
+      return {
+        ...base,
+        plans: upsertById(base.plans, event.payload),
+      };
+    case "checkpoint-scope.created":
+      return {
+        ...base,
+        checkpointScopes: upsertById(base.checkpointScopes, event.payload),
+      };
+    case "checkpoint.captured":
+      return {
+        ...base,
+        checkpoints: upsertById(base.checkpoints, event.payload),
+      };
+    case "checkpoint.rollback-requested":
+      return base;
+    case "context-handoff.updated":
+      return {
+        ...base,
+        contextHandoffs: upsertById(base.contextHandoffs, event.payload),
+      };
+    case "context-transfer.created":
+    case "context-transfer.updated":
+      return {
+        ...base,
+        contextTransfers: upsertById(base.contextTransfers, event.payload),
+      };
+  }
+}
+
+/**
+ * Replay state for entities whose persisted projection is shared across thread bindings.
+ *
+ * Provider sessions are process-scoped: one session row can be bound to several app
+ * threads. Updating that row changes what every bound thread reads, even though the
+ * application event itself belongs to one thread stream. Keeping the binding index here
+ * makes in-memory replay match the normalized SQL projection without scanning every
+ * thread for every session event.
+ */
+export interface ProjectionReplayState {
+  readonly projections: Map<ThreadId, OrchestrationV2ThreadProjection>;
+  readonly providerSessionThreadIds: Map<ProviderSessionId, ReadonlySet<ThreadId>>;
+}
+
+export function makeProjectionReplayState(): ProjectionReplayState {
+  return {
+    projections: new Map(),
+    providerSessionThreadIds: new Map(),
+  };
+}
+
+export function applyToProjectionReplayState(
+  state: ProjectionReplayState,
+  event: OrchestrationV2DomainEvent,
+): boolean {
+  if (event.type === "thread.created" && !state.projections.has(event.threadId)) {
+    state.projections.set(event.threadId, emptyProjection(event));
+    return true;
+  }
+
+  const current = state.projections.get(event.threadId);
+  if (current === undefined) {
+    return false;
+  }
+
+  let next = applyToProjection(current, event);
+  if (event.type === "provider-session.updated") {
+    const boundThreadIds = state.providerSessionThreadIds.get(event.payload.id);
+    if (boundThreadIds?.has(event.threadId) !== true) {
+      // The SQL projection updates the global session row but does not implicitly
+      // create a thread binding for an update event.
+      next = { ...next, providerSessions: current.providerSessions };
+    }
+  }
+  state.projections.set(event.threadId, next);
+
+  switch (event.type) {
+    case "provider-session.attached": {
+      const boundThreadIds = new Set(state.providerSessionThreadIds.get(event.payload.id) ?? []);
+      boundThreadIds.add(event.threadId);
+      state.providerSessionThreadIds.set(event.payload.id, boundThreadIds);
+      for (const threadId of boundThreadIds) {
+        if (threadId === event.threadId) continue;
+        const projection = state.projections.get(threadId);
+        if (projection === undefined) continue;
+        state.projections.set(threadId, {
+          ...projection,
+          providerSessions: upsertById(projection.providerSessions, event.payload),
+        });
+      }
+      break;
+    }
+    case "provider-session.updated": {
+      const boundThreadIds = state.providerSessionThreadIds.get(event.payload.id) ?? [];
+      for (const threadId of boundThreadIds) {
+        if (threadId === event.threadId) continue;
+        const projection = state.projections.get(threadId);
+        if (projection === undefined) continue;
+        state.projections.set(threadId, {
+          ...projection,
+          providerSessions: upsertById(projection.providerSessions, event.payload),
+        });
+      }
+      break;
+    }
+    case "provider-session.detached": {
+      const boundThreadIds = new Set(
+        state.providerSessionThreadIds.get(event.payload.providerSessionId) ?? [],
+      );
+      boundThreadIds.delete(event.threadId);
+      if (boundThreadIds.size === 0) {
+        state.providerSessionThreadIds.delete(event.payload.providerSessionId);
+      } else {
+        state.providerSessionThreadIds.set(event.payload.providerSessionId, boundThreadIds);
+      }
+      break;
+    }
+  }
+
+  return true;
+}
+
+type PayloadRow = {
+  readonly payload_json: string;
+};
+
+type ShellThreadRow = {
+  readonly thread_id: string;
+  readonly payload_json: string;
+  readonly forked_from_run_source_thread_id: string | null;
+  readonly latest_run_id: string | null;
+  readonly latest_run_status: string | null;
+  readonly latest_run_requested_at: string | null;
+  readonly latest_run_started_at: string | null;
+  readonly latest_run_completed_at: string | null;
+  readonly active_run_id: string | null;
+  readonly activity_run_status: string | null;
+  readonly last_error: string | null;
+  readonly pending_request_payload_json: string | null;
+  readonly latest_user_message_at: string | null;
+  readonly has_actionable_proposed_plan: number;
+  readonly item_count: number;
+  readonly runless_item_count: number;
+};
+
+type ShellRunRow = {
+  readonly thread_id: string;
+  readonly run_id: string;
+  readonly ordinal: number;
+};
+
+type ShellRunItemCountRow = {
+  readonly thread_id: string;
+  readonly run_id: string;
+  readonly item_count: number;
+};
+
+const encodeThreadPayload = Schema.encodeEffect(
+  Schema.fromJsonString(OrchestrationV2AppThreadJsonSchema),
+);
+const encodeRunPayload = Schema.encodeEffect(Schema.fromJsonString(OrchestrationV2RunJsonSchema));
+const encodeRunAttemptPayload = Schema.encodeEffect(
+  Schema.fromJsonString(OrchestrationV2RunAttemptJsonSchema),
+);
+const encodeNodePayload = Schema.encodeEffect(
+  Schema.fromJsonString(OrchestrationV2ExecutionNodeJsonSchema),
+);
+const encodeSubagentPayload = Schema.encodeEffect(
+  Schema.fromJsonString(OrchestrationV2SubagentJsonSchema),
+);
+const encodeProviderSessionPayload = Schema.encodeEffect(
+  Schema.fromJsonString(OrchestrationV2ProviderSessionJsonSchema),
+);
+const encodeProviderThreadPayload = Schema.encodeEffect(
+  Schema.fromJsonString(OrchestrationV2ProviderThreadJsonSchema),
+);
+const encodeProviderTurnPayload = Schema.encodeEffect(
+  Schema.fromJsonString(OrchestrationV2ProviderTurnJsonSchema),
+);
+const encodeRuntimeRequestPayload = Schema.encodeEffect(
+  Schema.fromJsonString(OrchestrationV2RuntimeRequestJsonSchema),
+);
+const encodeMessagePayload = Schema.encodeEffect(
+  Schema.fromJsonString(OrchestrationV2ConversationMessageJsonSchema),
+);
+const encodePlanPayload = Schema.encodeEffect(
+  Schema.fromJsonString(OrchestrationV2PlanArtifactSchema),
+);
+const encodeTurnItemPayload = Schema.encodeEffect(
+  Schema.fromJsonString(OrchestrationV2TurnItemJsonSchema),
+);
+const encodeCheckpointScopePayload = Schema.encodeEffect(
+  Schema.fromJsonString(OrchestrationV2CheckpointScopeJsonSchema),
+);
+const encodeCheckpointPayload = Schema.encodeEffect(
+  Schema.fromJsonString(OrchestrationV2CheckpointJsonSchema),
+);
+const encodeContextHandoffPayload = Schema.encodeEffect(
+  Schema.fromJsonString(OrchestrationV2ContextHandoffJsonSchema),
+);
+const encodeContextTransferPayload = Schema.encodeEffect(
+  Schema.fromJsonString(OrchestrationV2ContextTransferJsonSchema),
+);
+
+const decodeThreadPayload = Schema.decodeUnknownEffect(
+  Schema.fromJsonString(OrchestrationV2AppThreadJsonSchema),
+);
+const decodeRunPayload = Schema.decodeUnknownEffect(
+  Schema.fromJsonString(OrchestrationV2RunJsonSchema),
+);
+const decodeRunAttemptPayload = Schema.decodeUnknownEffect(
+  Schema.fromJsonString(OrchestrationV2RunAttemptJsonSchema),
+);
+const decodeNodePayload = Schema.decodeUnknownEffect(
+  Schema.fromJsonString(OrchestrationV2ExecutionNodeJsonSchema),
+);
+const decodeSubagentPayload = Schema.decodeUnknownEffect(
+  Schema.fromJsonString(OrchestrationV2SubagentJsonSchema),
+);
+const decodeProviderSessionPayload = Schema.decodeUnknownEffect(
+  Schema.fromJsonString(OrchestrationV2ProviderSessionJsonSchema),
+);
+const decodeProviderThreadPayload = Schema.decodeUnknownEffect(
+  Schema.fromJsonString(OrchestrationV2ProviderThreadJsonSchema),
+);
+const decodeProviderTurnPayload = Schema.decodeUnknownEffect(
+  Schema.fromJsonString(OrchestrationV2ProviderTurnJsonSchema),
+);
+const decodeRuntimeRequestPayload = Schema.decodeUnknownEffect(
+  Schema.fromJsonString(OrchestrationV2RuntimeRequestJsonSchema),
+);
+const decodeMessagePayload = Schema.decodeUnknownEffect(
+  Schema.fromJsonString(OrchestrationV2ConversationMessageJsonSchema),
+);
+const decodePlanArtifact = Schema.decodeUnknownEffect(OrchestrationV2PlanArtifactSchema);
+const decodePlanPayload = (json: string) => decodePlanArtifact(parseEncodedPayload(json));
+const decodeTurnItemPayload = Schema.decodeUnknownEffect(
+  Schema.fromJsonString(OrchestrationV2TurnItemJsonSchema),
+);
+const decodeCheckpointScopePayload = Schema.decodeUnknownEffect(
+  Schema.fromJsonString(OrchestrationV2CheckpointScopeJsonSchema),
+);
+const decodeCheckpointPayload = Schema.decodeUnknownEffect(
+  Schema.fromJsonString(OrchestrationV2CheckpointJsonSchema),
+);
+const decodeContextHandoffPayload = Schema.decodeUnknownEffect(
+  Schema.fromJsonString(OrchestrationV2ContextHandoffJsonSchema),
+);
+const decodeContextTransferPayload = Schema.decodeUnknownEffect(
+  Schema.fromJsonString(OrchestrationV2ContextTransferJsonSchema),
+);
+
+const isProjectionStoreThreadNotFoundError = Schema.is(ProjectionStoreThreadNotFoundError);
+const isProjectionStoreReadError = Schema.is(ProjectionStoreReadError);
+
+function parseEncodedPayload(json: string): Record<string, unknown> {
+  return JSON.parse(json) as Record<string, unknown>;
+}
+
+function stringField(payload: Record<string, unknown>, field: string): string {
+  const value = payload[field];
+  return typeof value === "string" ? value : String(value);
+}
+
+function nullableStringField(payload: Record<string, unknown>, field: string): string | null {
+  const value = payload[field];
+  if (value === null || value === undefined) {
+    return null;
+  }
+  return typeof value === "string" ? value : String(value);
+}
+
+function booleanInt(value: boolean): 0 | 1 {
+  return value ? 1 : 0;
+}
+
+const decodeRows =
+  <A, E>(decode: (json: string) => Effect.Effect<A, E>, threadId: ThreadId) =>
+  (rows: ReadonlyArray<PayloadRow>): Effect.Effect<Array<A>, ProjectionStoreReadError> =>
+    Effect.forEach(rows, (row) => decode(row.payload_json)).pipe(
+      Effect.mapError(
+        (cause) =>
+          new ProjectionStoreReadError({
+            threadId,
+            cause,
+          }),
+      ),
+    );
+
+function messageIdForTurnItem(item: OrchestrationV2TurnItem): string | null {
+  switch (item.type) {
+    case "user_message":
+    case "assistant_message":
+      return item.messageId;
+    default:
+      return null;
+  }
+}
+
+function sortMessagesByTurnItemOrder(
+  messages: ReadonlyArray<OrchestrationV2ConversationMessage>,
+  turnItems: ReadonlyArray<OrchestrationV2TurnItem>,
+): Array<OrchestrationV2ConversationMessage> {
+  const messageOrdinals = new Map<string, number>();
+  for (const turnItem of turnItems) {
+    const messageId = messageIdForTurnItem(turnItem);
+    if (messageId === null) {
+      continue;
+    }
+    const existing = messageOrdinals.get(messageId);
+    if (existing === undefined || turnItem.ordinal < existing) {
+      messageOrdinals.set(messageId, turnItem.ordinal);
+    }
+  }
+
+  return messages.toSorted((left, right) => {
+    const leftOrdinal = messageOrdinals.get(left.id) ?? Number.MAX_SAFE_INTEGER;
+    const rightOrdinal = messageOrdinals.get(right.id) ?? Number.MAX_SAFE_INTEGER;
+    if (leftOrdinal !== rightOrdinal) {
+      return leftOrdinal - rightOrdinal;
+    }
+
+    const leftCreatedAt = DateTime.toEpochMillis(left.createdAt);
+    const rightCreatedAt = DateTime.toEpochMillis(right.createdAt);
+    if (leftCreatedAt !== rightCreatedAt) {
+      return leftCreatedAt - rightCreatedAt;
+    }
+
+    return left.id.localeCompare(right.id);
+  });
+}
+
+function activeLocalTurnItems(
+  projection: OrchestrationV2ThreadProjection,
+): Array<OrchestrationV2ProjectedTurnItem> {
+  return projection.turnItems
+    .filter((item) =>
+      isOrchestrationV2TurnItemVisible({
+        item,
+        runs: projection.runs,
+        attempts: projection.attempts,
+        items: projection.turnItems,
+      }),
+    )
+    .map((item, position) => ({
+      position,
+      visibility: "local" as const,
+      sourceThreadId: item.threadId,
+      sourceItemId: item.id,
+      item,
+    }));
+}
+
+function localVisibleTurnItems(
+  projection: OrchestrationV2ThreadProjection,
+): Array<OrchestrationV2ProjectedTurnItem> {
+  return activeLocalTurnItems(projection);
+}
+
+function inheritedVisibleTurnItemsFromLocalItems(
+  items: ReadonlyArray<OrchestrationV2TurnItem>,
+): Array<Omit<OrchestrationV2ProjectedTurnItem, "position">> {
+  return items.map((item) => ({
+    visibility: "inherited" as const,
+    sourceThreadId: item.threadId,
+    sourceItemId: item.id,
+    item,
+  }));
+}
+
+function withLocalVisibleTurnItems(
+  projection: OrchestrationV2ThreadProjection,
+): OrchestrationV2ThreadProjection {
+  return {
+    ...projection,
+    visibleTurnItems: localVisibleTurnItems(projection),
+  };
+}
+
+function renumberVisibleTurnItems(
+  rows: ReadonlyArray<Omit<OrchestrationV2ProjectedTurnItem, "position">>,
+): Array<OrchestrationV2ProjectedTurnItem> {
+  return rows.map((row, position) => ({ ...row, position }));
+}
+
+function makeForkMarkerTurnItem(input: {
+  readonly targetProjection: OrchestrationV2ThreadProjection;
+  readonly sourceThreadId: ThreadId;
+  readonly sourceRunId: NonNullable<OrchestrationV2TurnItem["runId"]>;
+}): OrchestrationV2TurnItem {
+  const createdAt = input.targetProjection.thread.createdAt;
+  return {
+    id: TurnItemId.make(`turn-item:fork:${input.targetProjection.thread.id}`),
+    threadId: input.targetProjection.thread.id,
+    runId: null,
+    nodeId: null,
+    providerTurnId: null,
+    nativeItemRef: null,
+    parentItemId: null,
+    ordinal: 0,
+    status: "completed",
+    title: "Forked from conversation",
+    startedAt: null,
+    completedAt: createdAt,
+    updatedAt: createdAt,
+    type: "fork",
+    source: { type: "run", threadId: input.sourceThreadId, runId: input.sourceRunId },
+    targetThreadId: input.targetProjection.thread.id,
+  };
+}
+
+export function isTurnItemAtOrBeforeRun(input: {
+  readonly historyOrigin: OrchestrationV2ThreadProjection["thread"]["historyOrigin"];
+  readonly itemRunId: OrchestrationV2TurnItem["runId"];
+  readonly runOrdinalById: ReadonlyMap<NonNullable<OrchestrationV2TurnItem["runId"]>, number>;
+  readonly sourceRunOrdinal: number;
+}): boolean {
+  if (input.itemRunId === null) {
+    return input.historyOrigin === "v1_import";
+  }
+  const ordinal = input.runOrdinalById.get(input.itemRunId);
+  return ordinal !== undefined && ordinal <= input.sourceRunOrdinal;
+}
+
+function visibleTurnItemsThroughRun(input: {
+  readonly sourceProjection: OrchestrationV2ThreadProjection;
+  readonly sourceRunId: NonNullable<OrchestrationV2TurnItem["runId"]>;
+}): Array<Omit<OrchestrationV2ProjectedTurnItem, "position">> {
+  const sourceRun = input.sourceProjection.runs.find((run) => run.id === input.sourceRunId);
+  if (sourceRun === undefined) {
+    return [];
+  }
+
+  const runOrdinalById = new Map(input.sourceProjection.runs.map((run) => [run.id, run.ordinal]));
+  const inheritedPrefix = input.sourceProjection.visibleTurnItems
+    .filter(
+      (row) => row.item.threadId !== input.sourceProjection.thread.id || row.item.type === "fork",
+    )
+    .map((row) => ({
+      visibility: "inherited" as const,
+      sourceThreadId: row.sourceThreadId,
+      sourceItemId: row.sourceItemId,
+      item: row.item,
+    }));
+  const localPrefix = inheritedVisibleTurnItemsFromLocalItems(
+    input.sourceProjection.turnItems.filter((item) => {
+      if (
+        isOrchestrationV2SupersededInterrupt({
+          item,
+          attempts: input.sourceProjection.attempts,
+          items: input.sourceProjection.turnItems,
+        })
+      ) {
+        return false;
+      }
+      return isTurnItemAtOrBeforeRun({
+        historyOrigin: input.sourceProjection.thread.historyOrigin,
+        itemRunId: item.runId,
+        runOrdinalById,
+        sourceRunOrdinal: sourceRun.ordinal,
+      });
+    }),
+  );
+
+  return [...inheritedPrefix, ...localPrefix];
+}
+
+function buildVisibleTurnItems(input: {
+  readonly projection: OrchestrationV2ThreadProjection;
+  readonly sourceProjection: OrchestrationV2ThreadProjection | null;
+}): Array<OrchestrationV2ProjectedTurnItem> {
+  const forkedFrom = input.projection.thread.forkedFrom;
+  if (forkedFrom?.type !== "run" || input.sourceProjection === null) {
+    return localVisibleTurnItems(input.projection);
+  }
+
+  const inherited = visibleTurnItemsThroughRun({
+    sourceProjection: input.sourceProjection,
+    sourceRunId: forkedFrom.runId,
+  });
+  const markerItem = makeForkMarkerTurnItem({
+    targetProjection: input.projection,
+    sourceThreadId: forkedFrom.threadId,
+    sourceRunId: forkedFrom.runId,
+  });
+  const local = activeLocalTurnItems(input.projection).map((row) => ({
+    visibility: "local" as const,
+    sourceThreadId: row.sourceThreadId,
+    sourceItemId: row.sourceItemId,
+    item: row.item,
+  }));
+
+  return renumberVisibleTurnItems([
+    ...inherited,
+    {
+      visibility: "synthetic",
+      sourceThreadId: forkedFrom.threadId,
+      sourceItemId: markerItem.id,
+      item: markerItem,
+    },
+    ...local,
+  ]);
+}
+
+export function threadShellFromProjection(
+  projection: OrchestrationV2ThreadProjection,
+): OrchestrationV2ThreadShell {
+  const latestRun = projection.runs.at(-1) ?? null;
+  const activeRun =
+    projection.runs
+      .filter(isInterruptibleRunForShell)
+      .toSorted((left, right) => right.ordinal - left.ordinal)[0] ?? null;
+  const activityRun =
+    projection.runs
+      .filter(isActivityRunForShell)
+      .toSorted((left, right) => right.ordinal - left.ordinal)[0] ?? null;
+  const pendingRuntimeRequest =
+    projection.runtimeRequests
+      .filter((request) => request.status === "pending")
+      .toSorted(
+        (left, right) =>
+          DateTime.toEpochMillis(right.createdAt) - DateTime.toEpochMillis(left.createdAt),
+      )[0] ?? null;
+  const latestUserMessage =
+    projection.messages
+      .filter((message) => message.role === "user")
+      .toSorted(
+        (left, right) =>
+          DateTime.toEpochMillis(right.updatedAt) - DateTime.toEpochMillis(left.updatedAt),
+      )[0] ?? null;
+  const providerSession =
+    projection.providerSessions
+      .filter((session) => session.providerInstanceId === projection.thread.providerInstanceId)
+      .toSorted(
+        (left, right) =>
+          DateTime.toEpochMillis(right.updatedAt) - DateTime.toEpochMillis(left.updatedAt),
+      )[0] ?? null;
+  const pendingBackgroundTasks = derivePendingBackgroundWork({
+    latestRun,
+    providerThreads: projection.providerThreads,
+    turnItems: projection.turnItems,
+    activeProviderThreadId: projection.thread.activeProviderThreadId,
+    runs: projection.runs,
+  });
+  return {
+    createdBy: projection.thread.createdBy,
+    creationSource: projection.thread.creationSource,
+    id: projection.thread.id,
+    projectId: projection.thread.projectId,
+    title: projection.thread.title,
+    providerInstanceId: projection.thread.providerInstanceId,
+    modelSelection: projection.thread.modelSelection,
+    runtimeMode: projection.thread.runtimeMode,
+    interactionMode: projection.thread.interactionMode,
+    branch: projection.thread.branch,
+    worktreePath: projection.thread.worktreePath,
+    ...(projection.thread.linkedPullRequest === undefined
+      ? {}
+      : { linkedPullRequest: projection.thread.linkedPullRequest }),
+    lineage: projection.thread.lineage,
+    forkedFrom: projection.thread.forkedFrom,
+    activeProviderThreadId: projection.thread.activeProviderThreadId,
+    ...(projection.thread.historyOrigin === undefined
+      ? {}
+      : { historyOrigin: projection.thread.historyOrigin }),
+    latestRunId: latestRun?.id ?? null,
+    latestRunRequestedAt: latestRun?.requestedAt ?? null,
+    latestRunStartedAt: latestRun?.startedAt ?? null,
+    latestRunCompletedAt: latestRun?.completedAt ?? null,
+    activeRunId: activeRun?.id ?? null,
+    activityRunStatus: activityRun?.status ?? null,
+    status: latestRun?.status ?? "idle",
+    lastError: providerSession?.lastError ?? null,
+    pendingRuntimeRequest:
+      pendingRuntimeRequest === null
+        ? null
+        : {
+            id: pendingRuntimeRequest.id,
+            kind: pendingRuntimeRequest.kind,
+            createdAt: pendingRuntimeRequest.createdAt,
+          },
+    // Thread detail owns message bodies. Keeping them out of shell rows makes
+    // initial hydration and streaming updates independent of transcript size.
+    latestVisibleMessage: null,
+    latestUserMessageAt: latestUserMessage?.updatedAt ?? null,
+    hasActionableProposedPlan: projection.plans.some(
+      (plan) => plan.kind === "proposed_plan" && plan.status === "active",
+    ),
+    pendingBackgroundTasks: [...pendingBackgroundTasks],
+    itemCount: activeLocalTurnItems(projection).length,
+    visibleItemCount: projection.visibleTurnItems.length,
+    createdAt: projection.thread.createdAt,
+    updatedAt: projection.updatedAt,
+    archivedAt: projection.thread.archivedAt,
+    settledOverride: projection.thread.settledOverride,
+    settledAt: projection.thread.settledAt,
+    unsettledAt: projection.thread.unsettledAt ?? null,
+    snoozedUntil: projection.thread.snoozedUntil ?? null,
+    snoozedAt: projection.thread.snoozedAt ?? null,
+    pinnedAt: projection.thread.pinnedAt ?? null,
+    pinOrderKey: projection.thread.pinOrderKey ?? null,
+    lastVisitedAt: projection.thread.lastVisitedAt,
+    titleRegeneration: projection.thread.titleRegeneration ?? null,
+    deletedAt: projection.thread.deletedAt,
+  };
+}
+
+function isInterruptibleRunForShell(run: OrchestrationV2ThreadProjection["runs"][number]): boolean {
+  return run.status === "preparing" || run.status === "starting" || run.status === "running";
+}
+
+type ShellActivityRunStatus = "preparing" | "running" | "starting" | "waiting";
+
+function isActivityRunForShell(
+  run: OrchestrationV2ThreadProjection["runs"][number],
+): run is OrchestrationV2ThreadProjection["runs"][number] & {
+  readonly status: ShellActivityRunStatus;
+} {
+  return isInterruptibleRunForShell(run) || run.status === "waiting";
+}
+
+type ShellThreadState = {
+  readonly thread: OrchestrationV2ThreadProjection["thread"];
+  readonly latestRunId: RunId | null;
+  readonly latestRunStatus: OrchestrationV2ShellThreadStatus;
+  readonly latestRunRequestedAt: DateTime.Utc | null;
+  readonly latestRunStartedAt: DateTime.Utc | null;
+  readonly latestRunCompletedAt: DateTime.Utc | null;
+  readonly activeRunId: RunId | null;
+  readonly activityRunStatus: ShellActivityRunStatus | null;
+  readonly lastError: string | null;
+  readonly pendingRuntimeRequest: OrchestrationV2ThreadProjection["runtimeRequests"][number] | null;
+  readonly latestUserMessageAt: DateTime.Utc | null;
+  readonly hasActionableProposedPlan: boolean;
+  readonly pendingBackgroundTasks: OrchestrationV2ThreadShell["pendingBackgroundTasks"];
+  readonly itemCount: number;
+  readonly runlessItemCount: number;
+  readonly updatedAt: OrchestrationV2ThreadProjection["updatedAt"];
+  readonly runOrdinalById: ReadonlyMap<RunId, number>;
+  readonly itemCountByRunId: ReadonlyMap<RunId, number>;
+};
+
+function shellStatusFromStoredRunStatus(status: string | null): OrchestrationV2ShellThreadStatus {
+  switch (status) {
+    case null:
+      return "idle";
+    case "preparing":
+    case "queued":
+    case "starting":
+    case "running":
+    case "waiting":
+    case "completed":
+    case "interrupted":
+    case "failed":
+    case "cancelled":
+    case "rolled_back":
+      return status;
+    default:
+      return "failed";
+  }
+}
+
+function itemCountThroughRun(input: {
+  readonly state: ShellThreadState;
+  readonly runId: RunId;
+}): number {
+  const runOrdinal = input.state.runOrdinalById.get(input.runId);
+  if (runOrdinal === undefined) {
+    return 0;
+  }
+
+  let count = input.state.thread.historyOrigin === "v1_import" ? input.state.runlessItemCount : 0;
+  for (const [runId, itemCount] of input.state.itemCountByRunId) {
+    const itemRunOrdinal = input.state.runOrdinalById.get(runId);
+    if (itemRunOrdinal !== undefined && itemRunOrdinal <= runOrdinal) {
+      count += itemCount;
+    }
+  }
+  return count;
+}
+
+function visibleItemCountForShell(input: {
+  readonly threadId: ThreadId;
+  readonly statesByThreadId: ReadonlyMap<ThreadId, ShellThreadState>;
+  readonly seenThreadIds?: ReadonlySet<ThreadId>;
+}): number {
+  const state = input.statesByThreadId.get(input.threadId);
+  if (state === undefined) {
+    return 0;
+  }
+
+  const forkedFrom = state.thread.forkedFrom;
+  if (forkedFrom?.type !== "run") {
+    return state.itemCount;
+  }
+
+  const seenThreadIds = input.seenThreadIds ?? new Set<ThreadId>();
+  if (seenThreadIds.has(state.thread.id)) {
+    return state.itemCount;
+  }
+
+  const sourceState = input.statesByThreadId.get(forkedFrom.threadId);
+  if (sourceState === undefined) {
+    return state.itemCount;
+  }
+
+  const sourceForkedFrom = sourceState.thread.forkedFrom;
+  const inheritedPrefixCount =
+    sourceForkedFrom?.type === "run"
+      ? visibleItemCountForShell({
+          threadId: sourceState.thread.id,
+          statesByThreadId: input.statesByThreadId,
+          seenThreadIds: new Set([...seenThreadIds, state.thread.id]),
+        }) - sourceState.itemCount
+      : 0;
+
+  return (
+    inheritedPrefixCount +
+    itemCountThroughRun({ state: sourceState, runId: forkedFrom.runId }) +
+    1 +
+    state.itemCount
+  );
+}
+
+function shellFromState(input: {
+  readonly state: ShellThreadState;
+  readonly visibleItemCount: number;
+}): OrchestrationV2ThreadShell {
+  return {
+    createdBy: input.state.thread.createdBy,
+    creationSource: input.state.thread.creationSource,
+    id: input.state.thread.id,
+    projectId: input.state.thread.projectId,
+    title: input.state.thread.title,
+    providerInstanceId: input.state.thread.providerInstanceId,
+    modelSelection: input.state.thread.modelSelection,
+    runtimeMode: input.state.thread.runtimeMode,
+    interactionMode: input.state.thread.interactionMode,
+    branch: input.state.thread.branch,
+    worktreePath: input.state.thread.worktreePath,
+    ...(input.state.thread.linkedPullRequest === undefined
+      ? {}
+      : { linkedPullRequest: input.state.thread.linkedPullRequest }),
+    lineage: input.state.thread.lineage,
+    forkedFrom: input.state.thread.forkedFrom,
+    activeProviderThreadId: input.state.thread.activeProviderThreadId,
+    ...(input.state.thread.historyOrigin === undefined
+      ? {}
+      : { historyOrigin: input.state.thread.historyOrigin }),
+    latestRunId: input.state.latestRunId,
+    latestRunRequestedAt: input.state.latestRunRequestedAt,
+    latestRunStartedAt: input.state.latestRunStartedAt,
+    latestRunCompletedAt: input.state.latestRunCompletedAt,
+    activeRunId: input.state.activeRunId,
+    activityRunStatus: input.state.activityRunStatus,
+    status: input.state.latestRunStatus,
+    lastError: input.state.lastError,
+    pendingRuntimeRequest:
+      input.state.pendingRuntimeRequest === null
+        ? null
+        : {
+            id: input.state.pendingRuntimeRequest.id,
+            kind: input.state.pendingRuntimeRequest.kind,
+            createdAt: input.state.pendingRuntimeRequest.createdAt,
+          },
+    latestVisibleMessage: null,
+    latestUserMessageAt: input.state.latestUserMessageAt,
+    hasActionableProposedPlan: input.state.hasActionableProposedPlan,
+    pendingBackgroundTasks: input.state.pendingBackgroundTasks,
+    itemCount: input.state.itemCount,
+    visibleItemCount: input.visibleItemCount,
+    createdAt: input.state.thread.createdAt,
+    updatedAt: input.state.updatedAt,
+    archivedAt: input.state.thread.archivedAt,
+    settledOverride: input.state.thread.settledOverride,
+    settledAt: input.state.thread.settledAt,
+    unsettledAt: input.state.thread.unsettledAt ?? null,
+    snoozedUntil: input.state.thread.snoozedUntil ?? null,
+    snoozedAt: input.state.thread.snoozedAt ?? null,
+    pinnedAt: input.state.thread.pinnedAt ?? null,
+    pinOrderKey: input.state.thread.pinOrderKey ?? null,
+    lastVisitedAt: input.state.thread.lastVisitedAt,
+    titleRegeneration: input.state.thread.titleRegeneration ?? null,
+    deletedAt: input.state.thread.deletedAt,
+  };
+}
+
+export const layer: Layer.Layer<ProjectionStoreV2, never, SqlClient.SqlClient> = Layer.effect(
+  ProjectionStoreV2,
+  Effect.gen(function* () {
+    const sql = yield* SqlClient.SqlClient;
+
+    const apply: ProjectionStoreV2Shape["apply"] = (event) =>
+      Effect.gen(function* () {
+        switch (event.type) {
+          case "thread.created":
+          case "thread.archived":
+          case "thread.unarchived":
+          case "thread.deleted":
+          case "thread.settled":
+          case "thread.unsettled":
+          case "thread.snoozed":
+          case "thread.unsnoozed":
+          case "thread.pinned":
+          case "thread.unpinned":
+          case "thread.pin-reordered":
+          case "thread.visited":
+          case "thread.marked-unread":
+          case "thread.metadata-updated":
+          case "thread.runtime-mode-updated":
+          case "thread.interaction-mode-updated":
+          case "thread.model-selection-updated":
+          case "thread.provider-switched": {
+            const payloadJson = yield* encodeThreadPayload(event.payload);
+            const payload = parseEncodedPayload(payloadJson);
+            yield* sql`
+              INSERT INTO orchestration_v2_projection_threads (
+                thread_id,
+                project_id,
+                title,
+                default_provider,
+                provider_instance_id,
+                runtime_mode,
+                interaction_mode,
+                active_provider_thread_id,
+                created_at,
+                updated_at,
+                archived_at,
+                deleted_at,
+                payload_json
+              )
+              VALUES (
+                ${event.payload.id},
+                ${event.payload.projectId},
+                ${event.payload.title},
+                ${event.payload.providerInstanceId},
+                ${event.payload.providerInstanceId},
+                ${event.payload.runtimeMode},
+                ${event.payload.interactionMode},
+                ${event.payload.activeProviderThreadId},
+                ${stringField(payload, "createdAt")},
+                ${stringField(payload, "updatedAt")},
+                ${nullableStringField(payload, "archivedAt")},
+                ${nullableStringField(payload, "deletedAt")},
+                ${payloadJson}
+              )
+              ON CONFLICT(thread_id)
+              DO UPDATE SET
+                project_id = excluded.project_id,
+                title = excluded.title,
+                default_provider = excluded.default_provider,
+                provider_instance_id = excluded.provider_instance_id,
+                runtime_mode = excluded.runtime_mode,
+                interaction_mode = excluded.interaction_mode,
+                active_provider_thread_id = excluded.active_provider_thread_id,
+                created_at = excluded.created_at,
+                updated_at = excluded.updated_at,
+                archived_at = excluded.archived_at,
+                deleted_at = excluded.deleted_at,
+                payload_json = excluded.payload_json
+            `;
+            break;
+          }
+          case "run.created":
+          case "run.updated": {
+            const payloadJson = yield* encodeRunPayload(event.payload);
+            const payload = parseEncodedPayload(payloadJson);
+            yield* sql`
+              INSERT INTO orchestration_v2_projection_runs (
+                run_id,
+                thread_id,
+                ordinal,
+                provider,
+                provider_instance_id,
+                provider_thread_id,
+                status,
+                requested_at,
+                completed_at,
+                payload_json
+              )
+              VALUES (
+                ${event.payload.id},
+                ${event.payload.threadId},
+                ${event.payload.ordinal},
+                ${event.payload.providerInstanceId},
+                ${event.payload.providerInstanceId},
+                ${event.payload.providerThreadId},
+                ${event.payload.status},
+                ${stringField(payload, "requestedAt")},
+                ${nullableStringField(payload, "completedAt")},
+                ${payloadJson}
+              )
+              ON CONFLICT(run_id)
+              DO UPDATE SET
+                thread_id = excluded.thread_id,
+                ordinal = excluded.ordinal,
+                provider = excluded.provider,
+                provider_instance_id = excluded.provider_instance_id,
+                provider_thread_id = excluded.provider_thread_id,
+                status = excluded.status,
+                requested_at = excluded.requested_at,
+                completed_at = excluded.completed_at,
+                payload_json = CASE
+                  WHEN json_type(excluded.payload_json, '$.delegatedCompletion') IS NULL
+                    AND json_type(orchestration_v2_projection_runs.payload_json, '$.delegatedCompletion') IS NOT NULL
+                  THEN json_set(
+                    excluded.payload_json,
+                    '$.delegatedCompletion',
+                    json_extract(
+                      orchestration_v2_projection_runs.payload_json,
+                      '$.delegatedCompletion'
+                    )
+                  )
+                  ELSE excluded.payload_json
+                END
+            `;
+            break;
+          }
+          case "run-attempt.created":
+          case "run-attempt.updated": {
+            const payloadJson = yield* encodeRunAttemptPayload(event.payload);
+            yield* sql`
+              INSERT INTO orchestration_v2_projection_run_attempts (
+                attempt_id,
+                thread_id,
+                run_id,
+                attempt_ordinal,
+                root_node_id,
+                provider,
+                provider_instance_id,
+                provider_thread_id,
+                provider_turn_id,
+                status,
+                payload_json
+              )
+              VALUES (
+                ${event.payload.id},
+                ${event.threadId},
+                ${event.payload.runId},
+                ${event.payload.attemptOrdinal},
+                ${event.payload.rootNodeId},
+                ${event.payload.providerInstanceId},
+                ${event.payload.providerInstanceId},
+                ${event.payload.providerThreadId},
+                ${event.payload.providerTurnId},
+                ${event.payload.status},
+                ${payloadJson}
+              )
+              ON CONFLICT(attempt_id)
+              DO UPDATE SET
+                thread_id = excluded.thread_id,
+                run_id = excluded.run_id,
+                attempt_ordinal = excluded.attempt_ordinal,
+                root_node_id = excluded.root_node_id,
+                provider = excluded.provider,
+                provider_instance_id = excluded.provider_instance_id,
+                provider_thread_id = excluded.provider_thread_id,
+                provider_turn_id = excluded.provider_turn_id,
+                status = excluded.status,
+                payload_json = excluded.payload_json
+            `;
+            break;
+          }
+          case "node.updated": {
+            const payloadJson = yield* encodeNodePayload(event.payload);
+            const payload = parseEncodedPayload(payloadJson);
+            yield* sql`
+              INSERT INTO orchestration_v2_projection_nodes (
+                node_id,
+                thread_id,
+                run_id,
+                parent_node_id,
+                root_node_id,
+                kind,
+                status,
+                provider_thread_id,
+                provider_turn_id,
+                runtime_request_id,
+                checkpoint_scope_id,
+                started_at,
+                completed_at,
+                payload_json
+              )
+              VALUES (
+                ${event.payload.id},
+                ${event.payload.threadId},
+                ${event.payload.runId},
+                ${event.payload.parentNodeId},
+                ${event.payload.rootNodeId},
+                ${event.payload.kind},
+                ${event.payload.status},
+                ${event.payload.providerThreadId},
+                ${event.payload.providerTurnId},
+                ${event.payload.runtimeRequestId},
+                ${event.payload.checkpointScopeId},
+                ${nullableStringField(payload, "startedAt")},
+                ${nullableStringField(payload, "completedAt")},
+                ${payloadJson}
+              )
+              ON CONFLICT(node_id)
+              DO UPDATE SET
+                thread_id = excluded.thread_id,
+                run_id = excluded.run_id,
+                parent_node_id = excluded.parent_node_id,
+                root_node_id = excluded.root_node_id,
+                kind = excluded.kind,
+                status = excluded.status,
+                provider_thread_id = excluded.provider_thread_id,
+                provider_turn_id = excluded.provider_turn_id,
+                runtime_request_id = excluded.runtime_request_id,
+                checkpoint_scope_id = excluded.checkpoint_scope_id,
+                started_at = excluded.started_at,
+                completed_at = excluded.completed_at,
+                payload_json = excluded.payload_json
+            `;
+            break;
+          }
+          case "subagent.updated": {
+            const payloadJson = yield* encodeSubagentPayload(event.payload);
+            const payload = parseEncodedPayload(payloadJson);
+            yield* sql`
+              INSERT INTO orchestration_v2_projection_subagents (
+                subagent_id,
+                thread_id,
+                run_id,
+                parent_node_id,
+                provider,
+                driver,
+                provider_instance_id,
+                provider_thread_id,
+                child_thread_id,
+                origin,
+                status,
+                started_at,
+                completed_at,
+                updated_at,
+                payload_json
+              )
+              VALUES (
+                ${event.payload.id},
+                ${event.payload.threadId},
+                ${event.payload.runId},
+                ${event.payload.parentNodeId},
+                ${event.payload.providerInstanceId},
+                ${event.payload.driver},
+                ${event.payload.providerInstanceId},
+                ${event.payload.providerThreadId},
+                ${event.payload.childThreadId},
+                ${event.payload.origin},
+                ${event.payload.status},
+                ${nullableStringField(payload, "startedAt")},
+                ${nullableStringField(payload, "completedAt")},
+                ${stringField(payload, "updatedAt")},
+                ${payloadJson}
+              )
+              ON CONFLICT(subagent_id)
+              DO UPDATE SET
+                thread_id = excluded.thread_id,
+                run_id = excluded.run_id,
+                parent_node_id = excluded.parent_node_id,
+                provider = excluded.provider,
+                driver = excluded.driver,
+                provider_instance_id = excluded.provider_instance_id,
+                provider_thread_id = excluded.provider_thread_id,
+                child_thread_id = excluded.child_thread_id,
+                origin = excluded.origin,
+                status = excluded.status,
+                started_at = excluded.started_at,
+                completed_at = excluded.completed_at,
+                updated_at = excluded.updated_at,
+                payload_json = CASE
+                  WHEN json_type(excluded.payload_json, '$.completionDelivery') IS NULL
+                    AND json_type(orchestration_v2_projection_subagents.payload_json, '$.completionDelivery') IS NOT NULL
+                  THEN json_set(
+                    excluded.payload_json,
+                    '$.completionDelivery',
+                    json_extract(
+                      orchestration_v2_projection_subagents.payload_json,
+                      '$.completionDelivery'
+                    )
+                  )
+                  ELSE excluded.payload_json
+                END
+            `;
+            break;
+          }
+          case "provider-session.attached":
+          case "provider-session.updated": {
+            const payloadJson = yield* encodeProviderSessionPayload(event.payload);
+            const payload = parseEncodedPayload(payloadJson);
+            yield* sql`
+              INSERT INTO orchestration_v2_projection_provider_sessions (
+                provider_session_id,
+                thread_id,
+                provider,
+                driver,
+                provider_instance_id,
+                status,
+                model,
+                updated_at,
+                payload_json
+              )
+              VALUES (
+                ${event.payload.id},
+                ${event.threadId},
+                ${event.payload.providerInstanceId},
+                ${event.payload.driver},
+                ${event.payload.providerInstanceId},
+                ${event.payload.status},
+                ${event.payload.model},
+                ${stringField(payload, "updatedAt")},
+                ${payloadJson}
+              )
+              ON CONFLICT(provider_session_id)
+              DO UPDATE SET
+                thread_id = excluded.thread_id,
+                provider = excluded.provider,
+                driver = excluded.driver,
+                provider_instance_id = excluded.provider_instance_id,
+                status = excluded.status,
+                model = excluded.model,
+                updated_at = excluded.updated_at,
+                payload_json = excluded.payload_json
+            `;
+            if (event.type === "provider-session.attached") {
+              yield* sql`
+                INSERT OR IGNORE INTO orchestration_v2_projection_provider_session_bindings (
+                  provider_session_id,
+                  thread_id
+                )
+                VALUES (${event.payload.id}, ${event.threadId})
+              `;
+            }
+            break;
+          }
+          case "provider-session.detached": {
+            yield* sql`
+              DELETE FROM orchestration_v2_projection_provider_session_bindings
+              WHERE provider_session_id = ${event.payload.providerSessionId}
+                AND thread_id = ${event.threadId}
+            `;
+            break;
+          }
+          case "provider-thread.updated": {
+            const payloadJson = yield* encodeProviderThreadPayload(event.payload);
+            const payload = parseEncodedPayload(payloadJson);
+            yield* sql`
+              INSERT INTO orchestration_v2_projection_provider_threads (
+                provider_thread_id,
+                thread_id,
+                owner_node_id,
+                provider,
+                driver,
+                provider_instance_id,
+                provider_session_id,
+                status,
+                first_run_ordinal,
+                last_run_ordinal,
+                updated_at,
+                payload_json
+              )
+              VALUES (
+                ${event.payload.id},
+                ${event.payload.appThreadId},
+                ${event.payload.ownerNodeId},
+                ${event.payload.providerInstanceId},
+                ${event.payload.driver},
+                ${event.payload.providerInstanceId},
+                ${event.payload.providerSessionId},
+                ${event.payload.status},
+                ${event.payload.firstRunOrdinal},
+                ${event.payload.lastRunOrdinal},
+                ${stringField(payload, "updatedAt")},
+                ${payloadJson}
+              )
+              ON CONFLICT(provider_thread_id)
+              DO UPDATE SET
+                thread_id = excluded.thread_id,
+                owner_node_id = excluded.owner_node_id,
+                provider = excluded.provider,
+                driver = excluded.driver,
+                provider_instance_id = excluded.provider_instance_id,
+                provider_session_id = excluded.provider_session_id,
+                status = excluded.status,
+                first_run_ordinal = excluded.first_run_ordinal,
+                last_run_ordinal = excluded.last_run_ordinal,
+                updated_at = excluded.updated_at,
+                payload_json = excluded.payload_json
+            `;
+            if (event.payload.appThreadId !== null) {
+              const threadRows = yield* sql<PayloadRow>`
+                SELECT payload_json
+                FROM orchestration_v2_projection_threads
+                WHERE thread_id = ${event.payload.appThreadId}
+                LIMIT 1
+              `;
+              const threadRow = threadRows[0];
+              if (threadRow !== undefined) {
+                const thread = yield* decodeThreadPayload(threadRow.payload_json);
+                const updatedThread = {
+                  ...thread,
+                  activeProviderThreadId: event.payload.id,
+                  updatedAt: event.payload.updatedAt,
+                };
+                const updatedThreadPayloadJson = yield* encodeThreadPayload(updatedThread);
+                yield* sql`
+                  UPDATE orchestration_v2_projection_threads
+                  SET
+                    active_provider_thread_id = ${event.payload.id},
+                    updated_at = ${stringField(parseEncodedPayload(updatedThreadPayloadJson), "updatedAt")},
+                    payload_json = ${updatedThreadPayloadJson}
+                  WHERE thread_id = ${event.payload.appThreadId}
+                `;
+              }
+            }
+            break;
+          }
+          case "provider-turn.updated": {
+            const existingRows =
+              event.payload.tokenUsage === undefined
+                ? yield* sql<PayloadRow>`
+                    SELECT payload_json
+                    FROM orchestration_v2_projection_provider_turns
+                    WHERE provider_turn_id = ${event.payload.id}
+                    LIMIT 1
+                  `
+                : [];
+            const existing = existingRows[0];
+            const providerTurn =
+              existing === undefined
+                ? event.payload
+                : upsertProviderTurn(
+                    [yield* decodeProviderTurnPayload(existing.payload_json)],
+                    event.payload,
+                  )[0]!;
+            const payloadJson = yield* encodeProviderTurnPayload(providerTurn);
+            const payload = parseEncodedPayload(payloadJson);
+            yield* sql`
+              INSERT INTO orchestration_v2_projection_provider_turns (
+                provider_turn_id,
+                thread_id,
+                provider_thread_id,
+                node_id,
+                run_attempt_id,
+                ordinal,
+                status,
+                started_at,
+                completed_at,
+                payload_json
+              )
+              VALUES (
+                ${event.payload.id},
+                ${event.threadId},
+                ${providerTurn.providerThreadId},
+                ${providerTurn.nodeId},
+                ${providerTurn.runAttemptId},
+                ${providerTurn.ordinal},
+                ${providerTurn.status},
+                ${nullableStringField(payload, "startedAt")},
+                ${nullableStringField(payload, "completedAt")},
+                ${payloadJson}
+              )
+              ON CONFLICT(provider_turn_id)
+              DO UPDATE SET
+                thread_id = excluded.thread_id,
+                provider_thread_id = excluded.provider_thread_id,
+                node_id = excluded.node_id,
+                run_attempt_id = excluded.run_attempt_id,
+                ordinal = excluded.ordinal,
+                status = excluded.status,
+                started_at = excluded.started_at,
+                completed_at = excluded.completed_at,
+                payload_json = excluded.payload_json
+            `;
+            break;
+          }
+          case "runtime-request.updated": {
+            const payloadJson = yield* encodeRuntimeRequestPayload(event.payload);
+            const payload = parseEncodedPayload(payloadJson);
+            yield* sql`
+              INSERT INTO orchestration_v2_projection_runtime_requests (
+                runtime_request_id,
+                thread_id,
+                node_id,
+                provider_turn_id,
+                kind,
+                status,
+                created_at,
+                resolved_at,
+                payload_json
+              )
+              VALUES (
+                ${event.payload.id},
+                ${event.threadId},
+                ${event.payload.nodeId},
+                ${event.payload.providerTurnId},
+                ${event.payload.kind},
+                ${event.payload.status},
+                ${stringField(payload, "createdAt")},
+                ${nullableStringField(payload, "resolvedAt")},
+                ${payloadJson}
+              )
+              ON CONFLICT(runtime_request_id)
+              DO UPDATE SET
+                thread_id = excluded.thread_id,
+                node_id = excluded.node_id,
+                provider_turn_id = excluded.provider_turn_id,
+                kind = excluded.kind,
+                status = excluded.status,
+                created_at = excluded.created_at,
+                resolved_at = excluded.resolved_at,
+                payload_json = excluded.payload_json
+            `;
+            break;
+          }
+          case "message.updated": {
+            const payloadJson = yield* encodeMessagePayload(event.payload);
+            const payload = parseEncodedPayload(payloadJson);
+            yield* sql`
+              INSERT INTO orchestration_v2_projection_messages (
+                message_id,
+                thread_id,
+                run_id,
+                node_id,
+                role,
+                streaming,
+                created_at,
+                updated_at,
+                payload_json
+              )
+              VALUES (
+                ${event.payload.id},
+                ${event.payload.threadId},
+                ${event.payload.runId},
+                ${event.payload.nodeId},
+                ${event.payload.role},
+                ${booleanInt(event.payload.streaming)},
+                ${stringField(payload, "createdAt")},
+                ${stringField(payload, "updatedAt")},
+                ${payloadJson}
+              )
+              ON CONFLICT(message_id)
+              DO UPDATE SET
+                thread_id = excluded.thread_id,
+                run_id = excluded.run_id,
+                node_id = excluded.node_id,
+                role = excluded.role,
+                streaming = excluded.streaming,
+                created_at = excluded.created_at,
+                updated_at = excluded.updated_at,
+                payload_json = excluded.payload_json
+            `;
+            break;
+          }
+          case "plan.updated": {
+            const payloadJson = yield* encodePlanPayload(event.payload);
+            yield* sql`
+              INSERT INTO orchestration_v2_projection_plans (
+                plan_id,
+                thread_id,
+                run_id,
+                node_id,
+                kind,
+                status,
+                payload_json
+              )
+              VALUES (
+                ${event.payload.id},
+                ${event.payload.threadId},
+                ${event.payload.runId},
+                ${event.payload.nodeId},
+                ${event.payload.kind},
+                ${event.payload.status},
+                ${payloadJson}
+              )
+              ON CONFLICT(plan_id)
+              DO UPDATE SET
+                thread_id = excluded.thread_id,
+                run_id = excluded.run_id,
+                node_id = excluded.node_id,
+                kind = excluded.kind,
+                status = excluded.status,
+                payload_json = excluded.payload_json
+            `;
+            break;
+          }
+          case "turn-item.updated": {
+            const payloadJson = yield* encodeTurnItemPayload(event.payload);
+            const payload = parseEncodedPayload(payloadJson);
+            yield* sql`
+              INSERT INTO orchestration_v2_projection_turn_items (
+                turn_item_id,
+                thread_id,
+                run_id,
+                node_id,
+                provider_thread_id,
+                provider_turn_id,
+                parent_item_id,
+                ordinal,
+                type,
+                status,
+                updated_at,
+                payload_json
+              )
+              VALUES (
+                ${event.payload.id},
+                ${event.payload.threadId},
+                ${event.payload.runId},
+                ${event.payload.nodeId},
+                ${event.payload.providerThreadId},
+                ${event.payload.providerTurnId},
+                ${event.payload.parentItemId},
+                ${event.payload.ordinal},
+                ${event.payload.type},
+                ${event.payload.status},
+                ${stringField(payload, "updatedAt")},
+                ${payloadJson}
+              )
+              ON CONFLICT(turn_item_id)
+              DO UPDATE SET
+                thread_id = excluded.thread_id,
+                run_id = excluded.run_id,
+                node_id = excluded.node_id,
+                provider_thread_id = excluded.provider_thread_id,
+                provider_turn_id = excluded.provider_turn_id,
+                parent_item_id = excluded.parent_item_id,
+                ordinal = excluded.ordinal,
+                type = excluded.type,
+                status = excluded.status,
+                updated_at = excluded.updated_at,
+                payload_json = excluded.payload_json
+            `;
+            break;
+          }
+          case "checkpoint-scope.created": {
+            const payloadJson = yield* encodeCheckpointScopePayload(event.payload);
+            const payload = parseEncodedPayload(payloadJson);
+            yield* sql`
+              INSERT INTO orchestration_v2_projection_checkpoint_scopes (
+                scope_id,
+                thread_id,
+                run_id,
+                node_id,
+                parent_scope_id,
+                provider_thread_id,
+                kind,
+                ordinal_within_parent,
+                advances_app_run_count,
+                created_at,
+                payload_json
+              )
+              VALUES (
+                ${event.payload.id},
+                ${event.payload.threadId},
+                ${event.payload.runId},
+                ${event.payload.nodeId},
+                ${event.payload.parentScopeId},
+                ${event.payload.providerThreadId},
+                ${event.payload.kind},
+                ${event.payload.ordinalWithinParent},
+                ${booleanInt(event.payload.advancesAppRunCount)},
+                ${stringField(payload, "createdAt")},
+                ${payloadJson}
+              )
+              ON CONFLICT(scope_id)
+              DO UPDATE SET
+                thread_id = excluded.thread_id,
+                run_id = excluded.run_id,
+                node_id = excluded.node_id,
+                parent_scope_id = excluded.parent_scope_id,
+                provider_thread_id = excluded.provider_thread_id,
+                kind = excluded.kind,
+                ordinal_within_parent = excluded.ordinal_within_parent,
+                advances_app_run_count = excluded.advances_app_run_count,
+                created_at = excluded.created_at,
+                payload_json = excluded.payload_json
+            `;
+            break;
+          }
+          case "checkpoint.captured": {
+            const payloadJson = yield* encodeCheckpointPayload(event.payload);
+            const payload = parseEncodedPayload(payloadJson);
+            yield* sql`
+              INSERT INTO orchestration_v2_projection_checkpoints (
+                checkpoint_id,
+                thread_id,
+                scope_id,
+                run_id,
+                node_id,
+                parent_checkpoint_id,
+                ordinal_within_scope,
+                app_run_ordinal,
+                status,
+                captured_at,
+                payload_json
+              )
+              VALUES (
+                ${event.payload.id},
+                ${event.payload.threadId},
+                ${event.payload.scopeId},
+                ${event.payload.runId},
+                ${event.payload.nodeId},
+                ${event.payload.parentCheckpointId},
+                ${event.payload.ordinalWithinScope},
+                ${event.payload.appRunOrdinal},
+                ${event.payload.status},
+                ${stringField(payload, "capturedAt")},
+                ${payloadJson}
+              )
+              ON CONFLICT(checkpoint_id)
+              DO UPDATE SET
+                thread_id = excluded.thread_id,
+                scope_id = excluded.scope_id,
+                run_id = excluded.run_id,
+                node_id = excluded.node_id,
+                parent_checkpoint_id = excluded.parent_checkpoint_id,
+                ordinal_within_scope = excluded.ordinal_within_scope,
+                app_run_ordinal = excluded.app_run_ordinal,
+                status = excluded.status,
+                captured_at = excluded.captured_at,
+                payload_json = excluded.payload_json
+            `;
+            break;
+          }
+          case "checkpoint.rollback-requested":
+            break;
+          case "context-handoff.updated": {
+            const payloadJson = yield* encodeContextHandoffPayload(event.payload);
+            const payload = parseEncodedPayload(payloadJson);
+            yield* sql`
+              INSERT INTO orchestration_v2_projection_context_handoffs (
+                context_handoff_id,
+                thread_id,
+                target_run_id,
+                to_provider_thread_id,
+                strategy,
+                status,
+                updated_at,
+                payload_json
+              )
+              VALUES (
+                ${event.payload.id},
+                ${event.payload.threadId},
+                ${event.payload.targetRunId},
+                ${event.payload.toProviderThreadId},
+                ${event.payload.strategy},
+                ${event.payload.status},
+                ${stringField(payload, "updatedAt")},
+                ${payloadJson}
+              )
+              ON CONFLICT(context_handoff_id)
+              DO UPDATE SET
+                thread_id = excluded.thread_id,
+                target_run_id = excluded.target_run_id,
+                to_provider_thread_id = excluded.to_provider_thread_id,
+                strategy = excluded.strategy,
+                status = excluded.status,
+                updated_at = excluded.updated_at,
+                payload_json = excluded.payload_json
+            `;
+            break;
+          }
+          case "context-transfer.created":
+          case "context-transfer.updated": {
+            const payloadJson = yield* encodeContextTransferPayload(event.payload);
+            const payload = parseEncodedPayload(payloadJson);
+            yield* sql`
+              INSERT INTO orchestration_v2_projection_context_transfers (
+                context_transfer_id,
+                source_thread_id,
+                target_thread_id,
+                target_run_id,
+                type,
+                status,
+                source_provider,
+                target_provider,
+                source_provider_instance_id,
+                target_provider_instance_id,
+                updated_at,
+                payload_json
+              )
+              VALUES (
+                ${event.payload.id},
+                ${event.payload.sourceThreadId},
+                ${event.payload.targetThreadId},
+                ${event.payload.targetRunId},
+                ${event.payload.type},
+                ${event.payload.status},
+                ${event.payload.sourceProviderInstanceId},
+                ${event.payload.targetProviderInstanceId},
+                ${event.payload.sourceProviderInstanceId},
+                ${event.payload.targetProviderInstanceId},
+                ${stringField(payload, "updatedAt")},
+                ${payloadJson}
+              )
+              ON CONFLICT(context_transfer_id)
+              DO UPDATE SET
+                source_thread_id = excluded.source_thread_id,
+                target_thread_id = excluded.target_thread_id,
+                target_run_id = excluded.target_run_id,
+                type = excluded.type,
+                status = excluded.status,
+                source_provider = excluded.source_provider,
+                target_provider = excluded.target_provider,
+                source_provider_instance_id = excluded.source_provider_instance_id,
+                target_provider_instance_id = excluded.target_provider_instance_id,
+                updated_at = excluded.updated_at,
+                payload_json = excluded.payload_json
+            `;
+            break;
+          }
+        }
+
+        if (
+          event.type !== "thread.created" &&
+          event.type !== "thread.archived" &&
+          event.type !== "thread.unarchived" &&
+          event.type !== "thread.deleted" &&
+          event.type !== "thread.settled" &&
+          event.type !== "thread.unsettled" &&
+          event.type !== "thread.snoozed" &&
+          event.type !== "thread.unsnoozed" &&
+          event.type !== "thread.pinned" &&
+          event.type !== "thread.unpinned" &&
+          event.type !== "thread.pin-reordered" &&
+          event.type !== "thread.visited" &&
+          event.type !== "thread.marked-unread" &&
+          event.type !== "thread.metadata-updated" &&
+          event.type !== "thread.runtime-mode-updated" &&
+          event.type !== "thread.interaction-mode-updated" &&
+          event.type !== "thread.model-selection-updated" &&
+          event.type !== "thread.provider-switched"
+        ) {
+          const rows = yield* sql<PayloadRow>`
+            SELECT payload_json
+            FROM orchestration_v2_projection_threads
+            WHERE thread_id = ${event.threadId}
+            LIMIT 1
+          `;
+          const row = rows[0];
+          if (row !== undefined) {
+            const thread = yield* decodeThreadPayload(row.payload_json);
+            const updatedThread = { ...thread, updatedAt: event.occurredAt };
+            const payloadJson = yield* encodeThreadPayload(updatedThread);
+            yield* sql`
+              UPDATE orchestration_v2_projection_threads
+              SET
+                updated_at = ${stringField(parseEncodedPayload(payloadJson), "updatedAt")},
+                payload_json = ${payloadJson}
+              WHERE thread_id = ${event.threadId}
+            `;
+          }
+        }
+      }).pipe(
+        Effect.mapError(
+          (cause) =>
+            new ProjectionStoreApplyEventError({
+              eventType: event.type,
+              cause,
+            }),
+        ),
+      );
+
+    const readCanonicalProjection = (
+      threadId: ThreadId,
+      window?: {
+        readonly rowLimit: number;
+        readonly anchorItemId?: TurnItemId | undefined;
+        readonly requiredRunId?: RunId | undefined;
+        readonly suppressLocal?: boolean | undefined;
+      },
+    ) =>
+      Effect.gen(function* () {
+        const threadRows = yield* sql<PayloadRow>`
+          SELECT payload_json
+          FROM orchestration_v2_projection_threads
+          WHERE thread_id = ${threadId}
+          LIMIT 1
+        `;
+        const threadRow = threadRows[0];
+        if (!threadRow) {
+          return yield* new ProjectionStoreThreadNotFoundError({ threadId });
+        }
+
+        const boundedTurnItemRows =
+          window === undefined
+            ? yield* sql<PayloadRow>`
+                SELECT payload_json
+                FROM orchestration_v2_projection_turn_items
+                WHERE thread_id = ${threadId}
+                ORDER BY ordinal ASC, turn_item_id ASC
+              `
+            : yield* sql<PayloadRow>`
+                WITH eligible AS (
+                  SELECT item.payload_json, item.ordinal, item.turn_item_id,
+                    item.run_id, item.node_id, item.type
+                  FROM orchestration_v2_projection_turn_items AS item
+                  LEFT JOIN orchestration_v2_projection_runs AS run
+                    ON run.run_id = item.run_id
+                  WHERE item.thread_id = ${threadId}
+                    AND item.ordinal <= COALESCE(
+                      (
+                        SELECT ordinal
+                        FROM orchestration_v2_projection_turn_items
+                        WHERE thread_id = ${threadId}
+                          AND turn_item_id = ${window.anchorItemId ?? null}
+                        LIMIT 1
+                      ),
+                      9223372036854775807
+                    )
+                    AND (
+                      ${window.requiredRunId ?? null} IS NOT NULL
+                      OR (
+                        (run.status IS NULL OR run.status <> 'rolled_back')
+                        AND NOT (
+                          item.type = 'user_message'
+                          AND json_extract(item.payload_json, '$.inputIntent') = 'queued_turn'
+                          AND run.status IS 'cancelled'
+                        )
+                      )
+                    )
+                    AND (
+                      ${window.requiredRunId ?? null} IS NULL
+                      OR (
+                        item.run_id IS NULL
+                        AND EXISTS (
+                          SELECT 1
+                          FROM orchestration_v2_projection_threads AS source_thread
+                          WHERE source_thread.thread_id = item.thread_id
+                            AND json_extract(source_thread.payload_json, '$.historyOrigin') = 'v1_import'
+                        )
+                      )
+                      OR run.ordinal <= (
+                        SELECT required_run.ordinal
+                        FROM orchestration_v2_projection_runs AS required_run
+                        WHERE required_run.thread_id = item.thread_id
+                          AND required_run.run_id = ${window.requiredRunId ?? null}
+                        LIMIT 1
+                      )
+                    )
+                    AND NOT (
+                      item.type = 'run_interrupt_result'
+                      AND EXISTS (
+                        SELECT 1
+                        FROM orchestration_v2_projection_run_attempts AS attempt
+                        WHERE attempt.run_id = item.run_id
+                          AND attempt.root_node_id = item.node_id
+                          AND attempt.status = 'superseded'
+                      )
+                      AND NOT EXISTS (
+                        SELECT 1
+                        FROM orchestration_v2_projection_turn_items AS request
+                        WHERE request.thread_id = item.thread_id
+                          AND request.run_id = item.run_id
+                          AND request.type = 'run_interrupt_request'
+                      )
+                    )
+                ), selected AS (
+                  SELECT payload_json, ordinal, turn_item_id, run_id, type
+                  FROM eligible
+                  ORDER BY ordinal DESC, turn_item_id DESC
+                  LIMIT ${window.rowLimit}
+                ), retained AS (
+                  SELECT payload_json, ordinal, turn_item_id FROM selected
+                  UNION
+                  SELECT request.payload_json, request.ordinal, request.turn_item_id
+                  FROM orchestration_v2_projection_turn_items AS request
+                  WHERE request.run_id IN (
+                      SELECT run_id FROM selected
+                      WHERE type = 'run_interrupt_result' AND run_id IS NOT NULL
+                    )
+                    AND request.type = 'run_interrupt_request'
+                  UNION
+                  SELECT latest.payload_json, latest.ordinal, latest.turn_item_id
+                  FROM (
+                    SELECT payload_json, ordinal, turn_item_id
+                    FROM orchestration_v2_projection_turn_items
+                    WHERE thread_id = ${threadId}
+                      AND ${window.anchorItemId ?? null} IS NULL
+                      AND ${window.requiredRunId ?? null} IS NULL
+                    ORDER BY ordinal DESC, turn_item_id DESC
+                    LIMIT 1
+                  ) AS latest
+                )
+                SELECT payload_json
+                FROM retained
+                ORDER BY ordinal ASC, turn_item_id ASC
+              `;
+        const cohortPayloads = boundedTurnItemRows.map((row) =>
+          parseEncodedPayload(row.payload_json),
+        );
+        const cohortJson = (field: string) =>
+          JSON.stringify(
+            cohortPayloads.flatMap((payload) => {
+              const value = nullableStringField(payload, field);
+              return value === null ? [] : [value];
+            }),
+          );
+        const cohortRunIds = cohortJson("runId");
+        const cohortNodeIds = cohortJson("nodeId");
+        const cohortProviderThreadIds = cohortJson("providerThreadId");
+        const cohortProviderTurnIds = cohortJson("providerTurnId");
+        const cohortMessageIds = cohortJson("messageId");
+        const cohortPlanIds = cohortJson("planId");
+        const cohortCheckpointIds = cohortJson("checkpointId");
+        const cohortHandoffIds = cohortJson("contextHandoffId");
+
+        const [
+          thread,
+          runRows,
+          attemptRows,
+          nodeRows,
+          subagentRows,
+          providerSessionRows,
+          providerThreadRows,
+          providerTurnRows,
+          runtimeRequestRows,
+          messageRows,
+          planRows,
+          turnItemRows,
+          checkpointScopeRows,
+          checkpointRows,
+          contextHandoffRows,
+          contextTransferRows,
+        ] = yield* Effect.all([
+          decodeThreadPayload(threadRow.payload_json),
+          window === undefined
+            ? sql<PayloadRow>`
+            SELECT payload_json
+            FROM orchestration_v2_projection_runs
+            WHERE thread_id = ${threadId}
+            ORDER BY ordinal ASC
+          `
+            : sql<PayloadRow>`
+            SELECT payload_json FROM orchestration_v2_projection_runs
+            WHERE thread_id = ${threadId}
+              AND (status IN ('queued','preparing','starting','running','waiting')
+                OR run_id IN (SELECT value FROM json_each(${cohortRunIds}))
+                OR run_id = ${window.requiredRunId ?? null})
+            ORDER BY ordinal ASC
+          `,
+          window === undefined
+            ? sql<PayloadRow>`
+            SELECT payload_json
+            FROM orchestration_v2_projection_run_attempts
+            WHERE thread_id = ${threadId}
+            ORDER BY run_id ASC, attempt_ordinal ASC
+          `
+            : sql<PayloadRow>`
+            SELECT payload_json FROM orchestration_v2_projection_run_attempts
+            WHERE thread_id = ${threadId}
+              AND (status IN ('pending','starting','running','waiting')
+                OR run_id IN (SELECT value FROM json_each(${cohortRunIds})))
+            ORDER BY run_id ASC, attempt_ordinal ASC
+          `,
+          window === undefined
+            ? sql<PayloadRow>`
+            SELECT payload_json
+            FROM orchestration_v2_projection_nodes
+            WHERE thread_id = ${threadId}
+            ORDER BY COALESCE(started_at, ''), node_id ASC
+          `
+            : sql<PayloadRow>`
+            SELECT payload_json FROM orchestration_v2_projection_nodes
+            WHERE thread_id = ${threadId}
+              AND (status IN ('pending','starting','running','waiting')
+                OR run_id IN (SELECT value FROM json_each(${cohortRunIds}))
+                OR node_id IN (SELECT value FROM json_each(${cohortNodeIds})))
+            ORDER BY COALESCE(started_at, ''), node_id ASC
+          `,
+          window === undefined
+            ? sql<PayloadRow>`
+            SELECT payload_json
+            FROM orchestration_v2_projection_subagents
+            WHERE thread_id = ${threadId}
+            ORDER BY COALESCE(started_at, ''), subagent_id ASC
+          `
+            : sql<PayloadRow>`
+            SELECT payload_json FROM orchestration_v2_projection_subagents
+            WHERE thread_id = ${threadId}
+              AND (status IN ('pending','starting','running','waiting')
+                OR run_id IN (SELECT value FROM json_each(${cohortRunIds}))
+                OR parent_node_id IN (SELECT value FROM json_each(${cohortNodeIds})))
+            ORDER BY COALESCE(started_at, ''), subagent_id ASC
+          `,
+          window === undefined
+            ? sql<PayloadRow>`
+            SELECT sessions.payload_json
+            FROM orchestration_v2_projection_provider_sessions AS sessions
+            INNER JOIN orchestration_v2_projection_provider_session_bindings AS bindings
+              ON bindings.provider_session_id = sessions.provider_session_id
+            WHERE bindings.thread_id = ${threadId}
+            ORDER BY sessions.updated_at ASC, sessions.provider_session_id ASC
+          `
+            : sql<PayloadRow>`
+            SELECT DISTINCT sessions.payload_json
+            FROM orchestration_v2_projection_provider_sessions AS sessions
+            INNER JOIN orchestration_v2_projection_provider_session_bindings AS bindings
+              ON bindings.provider_session_id = sessions.provider_session_id
+            LEFT JOIN orchestration_v2_projection_provider_threads AS threads
+              ON threads.provider_session_id = sessions.provider_session_id
+            WHERE bindings.thread_id = ${threadId}
+              AND (sessions.status IN ('starting','running','waiting')
+                OR threads.provider_thread_id IN (SELECT value FROM json_each(${cohortProviderThreadIds})))
+            ORDER BY sessions.updated_at ASC, sessions.provider_session_id ASC
+          `,
+          window === undefined
+            ? sql<PayloadRow>`
+            SELECT payload_json
+            FROM orchestration_v2_projection_provider_threads
+            WHERE thread_id = ${threadId}
+               OR owner_node_id IN (
+                 SELECT node_id
+                 FROM orchestration_v2_projection_nodes
+                 WHERE thread_id = ${threadId}
+               )
+               OR provider_thread_id IN (
+                 SELECT provider_thread_id
+                 FROM orchestration_v2_projection_subagents
+                 WHERE thread_id = ${threadId}
+                   AND provider_thread_id IS NOT NULL
+               )
+            ORDER BY COALESCE(first_run_ordinal, 0), provider_thread_id ASC
+          `
+            : sql<PayloadRow>`
+            SELECT payload_json FROM orchestration_v2_projection_provider_threads
+            WHERE (thread_id = ${threadId} AND status = 'active')
+              OR provider_thread_id IN (SELECT value FROM json_each(${cohortProviderThreadIds}))
+              OR owner_node_id IN (SELECT value FROM json_each(${cohortNodeIds}))
+            ORDER BY COALESCE(first_run_ordinal, 0), provider_thread_id ASC
+          `,
+          window === undefined
+            ? sql<PayloadRow>`
+            SELECT payload_json
+            FROM orchestration_v2_projection_provider_turns
+            WHERE thread_id = ${threadId}
+            ORDER BY provider_thread_id ASC, ordinal ASC
+          `
+            : sql<PayloadRow>`
+            SELECT payload_json FROM orchestration_v2_projection_provider_turns
+            WHERE thread_id = ${threadId}
+              AND (status IN ('starting','running','waiting')
+                OR provider_turn_id IN (SELECT value FROM json_each(${cohortProviderTurnIds}))
+                OR node_id IN (SELECT value FROM json_each(${cohortNodeIds})))
+            ORDER BY provider_thread_id ASC, ordinal ASC
+          `,
+          window === undefined
+            ? sql<PayloadRow>`
+            SELECT payload_json
+            FROM orchestration_v2_projection_runtime_requests
+            WHERE thread_id = ${threadId}
+            ORDER BY created_at ASC, runtime_request_id ASC
+          `
+            : sql<PayloadRow>`
+            SELECT payload_json FROM orchestration_v2_projection_runtime_requests
+            WHERE thread_id = ${threadId}
+              AND (status IN ('pending','waiting')
+                OR node_id IN (SELECT value FROM json_each(${cohortNodeIds}))
+                OR provider_turn_id IN (SELECT value FROM json_each(${cohortProviderTurnIds})))
+            ORDER BY created_at ASC, runtime_request_id ASC
+          `,
+          window === undefined
+            ? sql<PayloadRow>`
+                SELECT payload_json FROM orchestration_v2_projection_messages
+                WHERE thread_id = ${threadId} ORDER BY created_at ASC, message_id ASC
+              `
+            : sql<PayloadRow>`
+                SELECT payload_json FROM orchestration_v2_projection_messages AS message
+                WHERE message.thread_id = ${threadId}
+                  AND (
+                    message.message_id IN (
+                      SELECT value FROM json_each(${cohortMessageIds})
+                    )
+                    OR message.run_id IN (
+                      SELECT run_id FROM orchestration_v2_projection_runs
+                      WHERE thread_id = ${threadId}
+                        AND status IN ('queued', 'preparing', 'starting', 'running', 'waiting')
+                    )
+                  )
+                ORDER BY created_at ASC, message_id ASC
+              `,
+          window === undefined
+            ? sql<PayloadRow>`
+                SELECT payload_json FROM orchestration_v2_projection_plans
+                WHERE thread_id = ${threadId} ORDER BY plan_id ASC
+              `
+            : sql<PayloadRow>`
+                SELECT payload_json FROM orchestration_v2_projection_plans AS plan
+                WHERE plan.thread_id = ${threadId}
+                  AND (
+                    plan.status = 'active'
+                    OR plan.plan_id IN (
+                      SELECT value FROM json_each(${cohortPlanIds})
+                    )
+                  )
+                ORDER BY plan_id ASC
+              `,
+          Effect.succeed(boundedTurnItemRows),
+          window === undefined
+            ? sql<PayloadRow>`
+            SELECT payload_json
+            FROM orchestration_v2_projection_checkpoint_scopes
+            WHERE thread_id = ${threadId}
+            ORDER BY ordinal_within_parent ASC, scope_id ASC
+          `
+            : sql<PayloadRow>`
+            SELECT payload_json FROM orchestration_v2_projection_checkpoint_scopes
+            WHERE thread_id = ${threadId}
+              AND (run_id IN (SELECT value FROM json_each(${cohortRunIds}))
+                OR node_id IN (SELECT value FROM json_each(${cohortNodeIds})))
+            ORDER BY ordinal_within_parent ASC, scope_id ASC
+          `,
+          window === undefined
+            ? sql<PayloadRow>`
+            SELECT payload_json
+            FROM orchestration_v2_projection_checkpoints
+            WHERE thread_id = ${threadId}
+            ORDER BY scope_id ASC, ordinal_within_scope ASC
+          `
+            : sql<PayloadRow>`
+            SELECT payload_json FROM orchestration_v2_projection_checkpoints
+            WHERE thread_id = ${threadId}
+              AND (status IN ('pending','capturing')
+                OR checkpoint_id IN (SELECT value FROM json_each(${cohortCheckpointIds}))
+                OR run_id IN (SELECT value FROM json_each(${cohortRunIds}))
+                OR node_id IN (SELECT value FROM json_each(${cohortNodeIds})))
+            ORDER BY scope_id ASC, ordinal_within_scope ASC
+          `,
+          window === undefined
+            ? sql<PayloadRow>`
+                SELECT payload_json FROM orchestration_v2_projection_context_handoffs
+                WHERE thread_id = ${threadId} ORDER BY rowid ASC
+              `
+            : sql<PayloadRow>`
+                SELECT payload_json FROM orchestration_v2_projection_context_handoffs AS handoff
+                WHERE handoff.thread_id = ${threadId}
+                  AND (
+                    handoff.status IN ('pending', 'ready')
+                    OR handoff.context_handoff_id IN (
+                      SELECT value FROM json_each(${cohortHandoffIds})
+                    )
+                  )
+                ORDER BY rowid ASC
+              `,
+          window === undefined
+            ? sql<PayloadRow>`
+            SELECT payload_json
+            FROM orchestration_v2_projection_context_transfers
+            WHERE source_thread_id = ${threadId} OR target_thread_id = ${threadId}
+            ORDER BY rowid ASC
+          `
+            : sql<PayloadRow>`
+            SELECT payload_json FROM orchestration_v2_projection_context_transfers
+            WHERE (source_thread_id = ${threadId} OR target_thread_id = ${threadId})
+              AND (status IN ('pending','running','waiting')
+                OR target_run_id IN (SELECT value FROM json_each(${cohortRunIds}))
+                OR json_extract(payload_json, '$.contextHandoffId') IN
+                  (SELECT value FROM json_each(${cohortHandoffIds})))
+            ORDER BY rowid ASC
+          `,
+        ]);
+
+        const [
+          runs,
+          attempts,
+          nodes,
+          subagents,
+          providerSessions,
+          providerThreads,
+          providerTurns,
+          runtimeRequests,
+          messages,
+          plans,
+          turnItems,
+          checkpointScopes,
+          checkpoints,
+          contextHandoffs,
+          contextTransfers,
+        ] = yield* Effect.all([
+          decodeRows(decodeRunPayload, threadId)(runRows),
+          decodeRows(decodeRunAttemptPayload, threadId)(attemptRows),
+          decodeRows(decodeNodePayload, threadId)(nodeRows),
+          decodeRows(decodeSubagentPayload, threadId)(subagentRows),
+          decodeRows(decodeProviderSessionPayload, threadId)(providerSessionRows),
+          decodeRows(decodeProviderThreadPayload, threadId)(providerThreadRows),
+          decodeRows(decodeProviderTurnPayload, threadId)(providerTurnRows),
+          decodeRows(decodeRuntimeRequestPayload, threadId)(runtimeRequestRows),
+          decodeRows(decodeMessagePayload, threadId)(messageRows),
+          decodeRows(decodePlanPayload, threadId)(planRows),
+          decodeRows(decodeTurnItemPayload, threadId)(turnItemRows),
+          decodeRows(decodeCheckpointScopePayload, threadId)(checkpointScopeRows),
+          decodeRows(decodeCheckpointPayload, threadId)(checkpointRows),
+          decodeRows(decodeContextHandoffPayload, threadId)(contextHandoffRows),
+          decodeRows(decodeContextTransferPayload, threadId)(contextTransferRows),
+        ]);
+        const orderedMessages = sortMessagesByTurnItemOrder(messages, turnItems);
+        const projection = {
+          thread,
+          runs,
+          attempts,
+          nodes,
+          subagents,
+          providerSessions,
+          providerThreads,
+          providerTurns,
+          runtimeRequests,
+          messages: orderedMessages,
+          plans,
+          turnItems,
+          checkpointScopes,
+          checkpoints,
+          contextHandoffs,
+          contextTransfers,
+          visibleTurnItems: [],
+          updatedAt: thread.updatedAt,
+        } satisfies OrchestrationV2ThreadProjection;
+        return withLocalVisibleTurnItems(projection);
+      }).pipe(
+        Effect.mapError((cause) =>
+          isProjectionStoreThreadNotFoundError(cause)
+            ? cause
+            : new ProjectionStoreReadError({
+                threadId,
+                cause,
+              }),
+        ),
+      );
+
+    const readProjection = (
+      threadId: ThreadId,
+      seenThreadIds: ReadonlySet<ThreadId>,
+      window?: {
+        readonly rowLimit: number;
+        readonly anchorItemId?: TurnItemId | undefined;
+        readonly requiredRunId?: RunId | undefined;
+        readonly suppressLocal?: boolean | undefined;
+        readonly historyAnchor?:
+          | { readonly threadId: ThreadId; readonly itemId: TurnItemId }
+          | undefined;
+      },
+    ): Effect.Effect<OrchestrationV2ThreadProjection, ProjectionStoreV2Error> =>
+      Effect.gen(function* () {
+        const localWindow =
+          window?.suppressLocal === true ||
+          (window?.historyAnchor !== undefined && window.historyAnchor.threadId !== threadId)
+            ? { ...window, rowLimit: 0, anchorItemId: undefined }
+            : window;
+        const projection = yield* readCanonicalProjection(threadId, localWindow);
+        const forkedFrom = projection.thread.forkedFrom;
+        if (forkedFrom?.type !== "run" || seenThreadIds.has(forkedFrom.threadId)) {
+          return withLocalVisibleTurnItems(projection);
+        }
+
+        const sourceWindow =
+          window === undefined
+            ? undefined
+            : yield* Effect.gen(function* () {
+                const historyAnchor = window.historyAnchor;
+                const anchorBelongsToSource = historyAnchor?.threadId === forkedFrom.threadId;
+                const rows = yield* sql<{ readonly turn_item_id: string }>`
+                  WITH fork_run AS (
+                    SELECT ordinal
+                    FROM orchestration_v2_projection_runs
+                    WHERE thread_id = ${forkedFrom.threadId}
+                      AND run_id = ${forkedFrom.runId}
+                    LIMIT 1
+                  ), fork_boundary AS (
+                    SELECT (
+                      SELECT item.ordinal
+                      FROM orchestration_v2_projection_turn_items AS item
+                      WHERE item.run_id = run.run_id
+                      ORDER BY item.ordinal DESC
+                      LIMIT 1
+                    ) AS ordinal
+                    FROM orchestration_v2_projection_runs AS run
+                    WHERE run.thread_id = ${forkedFrom.threadId}
+                      AND run.ordinal <= (SELECT ordinal FROM fork_run)
+                      AND EXISTS (
+                        SELECT 1
+                        FROM orchestration_v2_projection_turn_items AS item
+                        WHERE item.run_id = run.run_id
+                        LIMIT 1
+                      )
+                    ORDER BY run.ordinal DESC
+                    LIMIT 1
+                  ), effective_boundary AS (
+                    SELECT COALESCE(
+                      (SELECT ordinal FROM fork_boundary),
+                      (
+                        SELECT ordinal
+                        FROM orchestration_v2_projection_turn_items
+                        WHERE thread_id = ${forkedFrom.threadId}
+                          AND run_id IS NULL
+                          AND json_extract(payload_json, '$.historyOrigin') = 'v1_import'
+                        ORDER BY ordinal DESC, turn_item_id DESC
+                        LIMIT 1
+                      ),
+                      -1
+                    ) AS ordinal
+                  )
+                  SELECT turn_item_id
+                  FROM orchestration_v2_projection_turn_items
+                  WHERE thread_id = ${forkedFrom.threadId}
+                    AND ordinal <= COALESCE(
+                      (SELECT ordinal FROM effective_boundary),
+                      -1
+                    )
+                    AND (
+                      ${anchorBelongsToSource ? 1 : 0} = 0
+                      OR ordinal <= COALESCE(
+                        (SELECT ordinal FROM orchestration_v2_projection_turn_items
+                         WHERE thread_id = ${forkedFrom.threadId}
+                           AND turn_item_id = ${historyAnchor?.itemId ?? null}
+                         LIMIT 1),
+                        (SELECT ordinal FROM effective_boundary),
+                        -1
+                      )
+                    )
+                  ORDER BY ordinal DESC, turn_item_id DESC
+                  LIMIT 1
+                `;
+                const anchor = rows[0]?.turn_item_id;
+                const anchorIsInDescendant =
+                  historyAnchor !== undefined &&
+                  historyAnchor.threadId !== threadId &&
+                  historyAnchor.threadId !== forkedFrom.threadId;
+                return {
+                  rowLimit: window.rowLimit,
+                  requiredRunId: forkedFrom.runId,
+                  suppressLocal: anchor === undefined || anchorIsInDescendant,
+                  ...(anchor === undefined || anchorIsInDescendant
+                    ? {}
+                    : { anchorItemId: TurnItemId.make(anchor) }),
+                  ...(historyAnchor === undefined || historyAnchor.threadId === threadId
+                    ? {}
+                    : { historyAnchor }),
+                };
+              });
+
+        const sourceProjection = yield* readProjection(
+          forkedFrom.threadId,
+          new Set([...seenThreadIds, threadId]),
+          sourceWindow,
+        );
+        return {
+          ...projection,
+          visibleTurnItems: buildVisibleTurnItems({
+            projection,
+            sourceProjection,
+          }),
+        };
+      }).pipe(
+        Effect.mapError((cause) =>
+          isProjectionStoreThreadNotFoundError(cause) || isProjectionStoreReadError(cause)
+            ? cause
+            : new ProjectionStoreReadError({ threadId, cause }),
+        ),
+      );
+
+    const getThreadProjection: ProjectionStoreV2Shape["getThreadProjection"] = (threadId) =>
+      readProjection(threadId, new Set());
+
+    const getThreadSnapshot: ProjectionStoreV2Shape["getThreadSnapshot"] = (threadId) =>
+      sql
+        .withTransaction(
+          Effect.gen(function* () {
+            const projection = yield* getThreadProjection(threadId);
+            const rows = yield* sql<{ readonly snapshot_sequence: number | null }>`
+            SELECT MAX(sequence) AS snapshot_sequence
+            FROM orchestration_events
+            WHERE application_event_version = 2
+              AND aggregate_kind = 'thread'
+              AND stream_id = ${threadId}
+          `;
+            return {
+              schemaVersion: ORCHESTRATION_V2_PROJECTION_SCHEMA_VERSION,
+              snapshotSequence: rows[0]?.snapshot_sequence ?? 0,
+              projection,
+            };
+          }),
+        )
+        .pipe(
+          Effect.mapError((cause) =>
+            isProjectionStoreThreadNotFoundError(cause) || isProjectionStoreReadError(cause)
+              ? cause
+              : new ProjectionStoreReadError({ threadId, cause }),
+          ),
+        );
+
+    const getThreadSnapshotWindow: ProjectionStoreV2Shape["getThreadSnapshotWindow"] = (
+      threadId,
+      options,
+    ) =>
+      sql
+        .withTransaction(
+          Effect.gen(function* () {
+            const historyAnchor =
+              options.anchorItemId === undefined
+                ? undefined
+                : {
+                    itemId: options.anchorItemId,
+                    threadId:
+                      options.anchorThreadId ??
+                      (yield* sql<{ readonly thread_id: string }>`
+                        SELECT thread_id
+                        FROM orchestration_v2_projection_turn_items
+                        WHERE turn_item_id = ${options.anchorItemId}
+                        LIMIT 1
+                      `).map((row) => ThreadId.make(row.thread_id))[0] ??
+                      threadId,
+                  };
+            const projection = yield* readProjection(threadId, new Set(), {
+              rowLimit: options.rowLimit,
+              ...(historyAnchor?.threadId === threadId
+                ? { anchorItemId: historyAnchor.itemId }
+                : {}),
+              ...(historyAnchor === undefined ? {} : { historyAnchor }),
+            });
+            const rows = yield* sql<{ readonly snapshot_sequence: number | null }>`
+              SELECT MAX(sequence) AS snapshot_sequence
+              FROM orchestration_events
+              WHERE application_event_version = 2
+                AND aggregate_kind = 'thread'
+                AND stream_id = ${threadId}
+            `;
+            return {
+              schemaVersion: ORCHESTRATION_V2_PROJECTION_SCHEMA_VERSION,
+              snapshotSequence: rows[0]?.snapshot_sequence ?? 0,
+              projection,
+            };
+          }),
+        )
+        .pipe(
+          Effect.mapError((cause) =>
+            isProjectionStoreThreadNotFoundError(cause) || isProjectionStoreReadError(cause)
+              ? cause
+              : new ProjectionStoreReadError({ threadId, cause }),
+          ),
+        );
+
+    const selectShellThreadRows = (threadId?: ThreadId, location?: "active" | "archive") =>
+      sql<ShellThreadRow>`
+            SELECT
+              t.thread_id,
+              t.payload_json,
+              CASE
+                WHEN json_extract(t.payload_json, '$.forkedFrom.type') = 'run'
+                  THEN json_extract(t.payload_json, '$.forkedFrom.threadId')
+                ELSE NULL
+              END AS forked_from_run_source_thread_id,
+              (
+                SELECT r.run_id
+                FROM orchestration_v2_projection_runs r
+                WHERE r.thread_id = t.thread_id
+                ORDER BY r.ordinal DESC, r.run_id DESC
+                LIMIT 1
+              ) AS latest_run_id,
+              (
+                SELECT r.status
+                FROM orchestration_v2_projection_runs r
+                WHERE r.thread_id = t.thread_id
+                ORDER BY r.ordinal DESC, r.run_id DESC
+                LIMIT 1
+              ) AS latest_run_status,
+              (
+                SELECT r.requested_at
+                FROM orchestration_v2_projection_runs r
+                WHERE r.thread_id = t.thread_id
+                ORDER BY r.ordinal DESC, r.run_id DESC
+                LIMIT 1
+              ) AS latest_run_requested_at,
+              (
+                SELECT json_extract(r.payload_json, '$.startedAt')
+                FROM orchestration_v2_projection_runs r
+                WHERE r.thread_id = t.thread_id
+                ORDER BY r.ordinal DESC, r.run_id DESC
+                LIMIT 1
+              ) AS latest_run_started_at,
+              (
+                SELECT r.completed_at
+                FROM orchestration_v2_projection_runs r
+                WHERE r.thread_id = t.thread_id
+                ORDER BY r.ordinal DESC, r.run_id DESC
+                LIMIT 1
+              ) AS latest_run_completed_at,
+              (
+                SELECT r.run_id
+                FROM orchestration_v2_projection_runs r
+                WHERE r.thread_id = t.thread_id
+                  AND r.status IN ('preparing', 'starting', 'running')
+                ORDER BY r.ordinal DESC, r.run_id DESC
+                LIMIT 1
+              ) AS active_run_id,
+              (
+                SELECT r.status
+                FROM orchestration_v2_projection_runs r
+                WHERE r.thread_id = t.thread_id
+                  AND r.status IN ('preparing', 'starting', 'running', 'waiting')
+                ORDER BY r.ordinal DESC, r.run_id DESC
+                LIMIT 1
+              ) AS activity_run_status,
+              (
+                SELECT json_extract(session.payload_json, '$.lastError')
+                FROM orchestration_v2_projection_provider_sessions session
+                INNER JOIN orchestration_v2_projection_provider_session_bindings binding
+                  ON binding.provider_session_id = session.provider_session_id
+                WHERE binding.thread_id = t.thread_id
+                  AND session.provider_instance_id = t.provider_instance_id
+                ORDER BY session.updated_at DESC, session.provider_session_id DESC
+                LIMIT 1
+              ) AS last_error,
+              (
+                SELECT request.payload_json
+                FROM orchestration_v2_projection_runtime_requests request
+                WHERE request.thread_id = t.thread_id
+                  AND request.status = 'pending'
+                ORDER BY request.created_at DESC, request.runtime_request_id DESC
+                LIMIT 1
+              ) AS pending_request_payload_json,
+              (
+                SELECT message.updated_at
+                FROM orchestration_v2_projection_messages message
+                WHERE message.thread_id = t.thread_id
+                  AND message.role = 'user'
+                ORDER BY message.updated_at DESC, message.message_id DESC
+                LIMIT 1
+              ) AS latest_user_message_at,
+              EXISTS (
+                SELECT 1
+                FROM orchestration_v2_projection_plans plan
+                WHERE plan.thread_id = t.thread_id
+                  AND plan.kind = 'proposed_plan'
+                  AND plan.status = 'active'
+              ) AS has_actionable_proposed_plan,
+              (
+                SELECT COUNT(*)
+                FROM orchestration_v2_projection_turn_items i
+                LEFT JOIN orchestration_v2_projection_runs r
+                  ON r.run_id = i.run_id
+                WHERE i.thread_id = t.thread_id
+                  AND (i.run_id IS NULL OR r.status <> 'rolled_back')
+              ) AS item_count,
+              (
+                SELECT COUNT(*)
+                FROM orchestration_v2_projection_turn_items i
+                WHERE i.thread_id = t.thread_id
+                  AND i.run_id IS NULL
+              ) AS runless_item_count
+            FROM orchestration_v2_projection_threads t
+            WHERE t.deleted_at IS NULL${threadId === undefined ? sql`` : sql` AND t.thread_id = ${threadId}`}${
+              location === "active"
+                ? sql` AND json_extract(t.payload_json, '$.archivedAt') IS NULL`
+                : location === "archive"
+                  ? sql` AND json_extract(t.payload_json, '$.archivedAt') IS NOT NULL`
+                  : sql``
+            }
+            ORDER BY t.updated_at ASC, t.thread_id ASC
+          `;
+
+    const selectShellRunRows = (threadIds?: ReadonlyArray<ThreadId>) =>
+      threadIds === undefined
+        ? sql<ShellRunRow>`
+            SELECT thread_id, run_id, ordinal
+            FROM orchestration_v2_projection_runs
+          `
+        : sql<ShellRunRow>`
+            SELECT thread_id, run_id, ordinal
+            FROM orchestration_v2_projection_runs
+            WHERE thread_id IN ${sql.in(threadIds)}
+          `;
+
+    const selectShellRunItemCounts = (threadIds?: ReadonlyArray<ThreadId>) =>
+      threadIds === undefined
+        ? sql<ShellRunItemCountRow>`
+            SELECT thread_id, run_id, COUNT(*) AS item_count
+            FROM orchestration_v2_projection_turn_items
+            WHERE run_id IS NOT NULL
+            GROUP BY thread_id, run_id
+          `
+        : sql<ShellRunItemCountRow>`
+            SELECT thread_id, run_id, COUNT(*) AS item_count
+            FROM orchestration_v2_projection_turn_items
+            WHERE run_id IS NOT NULL
+              AND thread_id IN ${sql.in(threadIds)}
+            GROUP BY thread_id, run_id
+          `;
+
+    const selectShellProviderThreadRows = (threadIds?: ReadonlyArray<ThreadId>) =>
+      threadIds === undefined
+        ? sql<PayloadRow & { readonly thread_id: string }>`
+            SELECT thread_id, payload_json
+            FROM orchestration_v2_projection_provider_threads
+            WHERE thread_id IS NOT NULL
+          `
+        : sql<PayloadRow & { readonly thread_id: string }>`
+            SELECT thread_id, payload_json
+            FROM orchestration_v2_projection_provider_threads
+            WHERE thread_id IN ${sql.in(threadIds)}
+          `;
+
+    const selectShellPendingTurnItemRows = (threadIds?: ReadonlyArray<ThreadId>) =>
+      threadIds === undefined
+        ? sql<PayloadRow & { readonly thread_id: string }>`
+            SELECT i.thread_id, i.payload_json
+            FROM orchestration_v2_projection_turn_items i
+            LEFT JOIN orchestration_v2_projection_runs r
+              ON r.run_id = i.run_id
+            WHERE i.type IN ('command_execution', 'dynamic_tool', 'subagent')
+              AND i.status NOT IN ('completed', 'interrupted', 'failed', 'cancelled')
+              -- A rolled-back run's items are abandoned, not pending. Without
+              -- this the shell reports Waiting for work no one will finish,
+              -- matching the item_count query's exclusion above.
+              AND (i.run_id IS NULL OR r.status <> 'rolled_back')
+          `
+        : sql<PayloadRow & { readonly thread_id: string }>`
+            SELECT i.thread_id, i.payload_json
+            FROM orchestration_v2_projection_turn_items i
+            LEFT JOIN orchestration_v2_projection_runs r
+              ON r.run_id = i.run_id
+            WHERE i.type IN ('command_execution', 'dynamic_tool', 'subagent')
+              AND i.status NOT IN ('completed', 'interrupted', 'failed', 'cancelled')
+              AND (i.run_id IS NULL OR r.status <> 'rolled_back')
+              AND i.thread_id IN ${sql.in(threadIds)}
+          `;
+
+    const runMapsByThreadId = (input: {
+      readonly runRows: ReadonlyArray<ShellRunRow>;
+      readonly itemCountRows: ReadonlyArray<ShellRunItemCountRow>;
+    }) => {
+      const runOrdinalsByThreadId = new Map<ThreadId, Map<RunId, number>>();
+      for (const row of input.runRows) {
+        const threadId = ThreadId.make(row.thread_id);
+        const runId = RunId.make(row.run_id);
+        const existing = runOrdinalsByThreadId.get(threadId) ?? new Map<RunId, number>();
+        existing.set(runId, row.ordinal);
+        runOrdinalsByThreadId.set(threadId, existing);
+      }
+      const itemCountsByThreadId = new Map<ThreadId, Map<RunId, number>>();
+      for (const row of input.itemCountRows) {
+        const threadId = ThreadId.make(row.thread_id);
+        const runId = RunId.make(row.run_id);
+        const existing = itemCountsByThreadId.get(threadId) ?? new Map<RunId, number>();
+        existing.set(runId, row.item_count);
+        itemCountsByThreadId.set(threadId, existing);
+      }
+      return { runOrdinalsByThreadId, itemCountsByThreadId };
+    };
+
+    const pendingBackgroundDataByThreadId = (input: {
+      readonly providerThreadRows: ReadonlyArray<PayloadRow & { readonly thread_id: string }>;
+      readonly pendingTurnItemRows: ReadonlyArray<PayloadRow & { readonly thread_id: string }>;
+    }) =>
+      Effect.gen(function* () {
+        const providerThreadsByThreadId = new Map<
+          ThreadId,
+          Array<OrchestrationV2ThreadProjection["providerThreads"][number]>
+        >();
+        for (const row of input.providerThreadRows) {
+          const providerThread = yield* decodeProviderThreadPayload(row.payload_json);
+          const threadId =
+            row.thread_id.length > 0 ? ThreadId.make(row.thread_id) : providerThread.appThreadId;
+          if (threadId === null) {
+            continue;
+          }
+          const existing = providerThreadsByThreadId.get(threadId) ?? [];
+          existing.push(providerThread);
+          providerThreadsByThreadId.set(threadId, existing);
+        }
+
+        const pendingTurnItemsByThreadId = new Map<ThreadId, Array<OrchestrationV2TurnItem>>();
+        for (const row of input.pendingTurnItemRows) {
+          const turnItem = yield* decodeTurnItemPayload(row.payload_json);
+          const threadId = ThreadId.make(row.thread_id);
+          const existing = pendingTurnItemsByThreadId.get(threadId) ?? [];
+          existing.push(turnItem);
+          pendingTurnItemsByThreadId.set(threadId, existing);
+        }
+
+        return { providerThreadsByThreadId, pendingTurnItemsByThreadId };
+      });
+
+    const shellThreadStateFromRow = (input: {
+      readonly row: ShellThreadRow;
+      readonly runOrdinalsByThreadId: ReadonlyMap<ThreadId, Map<RunId, number>>;
+      readonly itemCountsByThreadId: ReadonlyMap<ThreadId, Map<RunId, number>>;
+      readonly providerThreadsByThreadId: ReadonlyMap<
+        ThreadId,
+        ReadonlyArray<OrchestrationV2ThreadProjection["providerThreads"][number]>
+      >;
+      readonly pendingTurnItemsByThreadId: ReadonlyMap<
+        ThreadId,
+        ReadonlyArray<OrchestrationV2TurnItem>
+      >;
+    }) =>
+      Effect.gen(function* () {
+        const {
+          row,
+          runOrdinalsByThreadId,
+          itemCountsByThreadId,
+          providerThreadsByThreadId,
+          pendingTurnItemsByThreadId,
+        } = input;
+        const thread = yield* decodeThreadPayload(row.payload_json);
+        const pendingRuntimeRequest =
+          row.pending_request_payload_json === null
+            ? null
+            : yield* decodeRuntimeRequestPayload(row.pending_request_payload_json);
+        const latestRunId = row.latest_run_id === null ? null : RunId.make(row.latest_run_id);
+        const latestRunStatus = shellStatusFromStoredRunStatus(row.latest_run_status);
+        const pendingBackgroundTasks = [
+          ...derivePendingBackgroundWork({
+            latestRun:
+              latestRunId === null || latestRunStatus === "idle"
+                ? null
+                : {
+                    id: latestRunId,
+                    ordinal: 0,
+                    status: latestRunStatus,
+                  },
+            providerThreads: providerThreadsByThreadId.get(thread.id) ?? [],
+            turnItems: pendingTurnItemsByThreadId.get(thread.id) ?? [],
+            activeProviderThreadId: thread.activeProviderThreadId,
+            hasActiveRun: row.active_run_id !== null,
+          }),
+        ];
+        return {
+          thread,
+          latestRunId,
+          latestRunStatus,
+          latestRunRequestedAt:
+            row.latest_run_requested_at === null
+              ? null
+              : DateTime.makeUnsafe(row.latest_run_requested_at),
+          latestRunStartedAt:
+            row.latest_run_started_at === null
+              ? null
+              : DateTime.makeUnsafe(row.latest_run_started_at),
+          latestRunCompletedAt:
+            row.latest_run_completed_at === null
+              ? null
+              : DateTime.makeUnsafe(row.latest_run_completed_at),
+          activeRunId: row.active_run_id === null ? null : RunId.make(row.active_run_id),
+          activityRunStatus:
+            row.activity_run_status === "preparing" ||
+            row.activity_run_status === "starting" ||
+            row.activity_run_status === "running" ||
+            row.activity_run_status === "waiting"
+              ? row.activity_run_status
+              : null,
+          lastError: row.last_error,
+          pendingRuntimeRequest,
+          latestUserMessageAt:
+            row.latest_user_message_at === null
+              ? null
+              : DateTime.makeUnsafe(row.latest_user_message_at),
+          hasActionableProposedPlan: row.has_actionable_proposed_plan === 1,
+          pendingBackgroundTasks,
+          itemCount: row.item_count,
+          runlessItemCount: row.runless_item_count,
+          updatedAt: thread.updatedAt,
+          runOrdinalById: runOrdinalsByThreadId.get(ThreadId.make(row.thread_id)) ?? new Map(),
+          itemCountByRunId: itemCountsByThreadId.get(ThreadId.make(row.thread_id)) ?? new Map(),
+        } satisfies ShellThreadState;
+      });
+
+    const getShellSnapshot: ProjectionStoreV2Shape["getShellSnapshot"] = (options) =>
+      sql
+        .withTransaction(
+          Effect.gen(function* () {
+            const targetThreadRows = yield* selectShellThreadRows(undefined, options?.location);
+            const targetThreadIds = new Set(
+              targetThreadRows.map((row) => ThreadId.make(row.thread_id)),
+            );
+            const rowsByThreadId = new Map(
+              targetThreadRows.map((row) => [ThreadId.make(row.thread_id), row] as const),
+            );
+            const pendingSourceIds = targetThreadRows.flatMap((row) =>
+              row.forked_from_run_source_thread_id === null
+                ? []
+                : [ThreadId.make(row.forked_from_run_source_thread_id)],
+            );
+            while (pendingSourceIds.length > 0) {
+              const sourceId = pendingSourceIds.pop();
+              if (sourceId === undefined || rowsByThreadId.has(sourceId)) continue;
+              const source = (yield* selectShellThreadRows(sourceId))[0];
+              if (source === undefined) continue;
+              rowsByThreadId.set(sourceId, source);
+              if (source.forked_from_run_source_thread_id !== null) {
+                pendingSourceIds.push(ThreadId.make(source.forked_from_run_source_thread_id));
+              }
+            }
+            const threadRows = [...rowsByThreadId.values()];
+            const threadIds = [...rowsByThreadId.keys()];
+            const readForThreadIds = <A>(
+              read: (ids: ReadonlyArray<ThreadId>) => Effect.Effect<ReadonlyArray<A>, unknown>,
+            ) =>
+              threadIds.length === 0 ? Effect.succeed([] as ReadonlyArray<A>) : read(threadIds);
+            const [runRows, itemCountRows, sequenceRows, providerThreadRows, pendingTurnItemRows] =
+              yield* Effect.all([
+                readForThreadIds(selectShellRunRows),
+                readForThreadIds(selectShellRunItemCounts),
+                sql<{ readonly snapshot_sequence: number | null }>`
+            SELECT MAX(sequence) AS snapshot_sequence
+            FROM orchestration_events
+            WHERE application_event_version = 2
+              AND aggregate_kind = 'thread'
+          `,
+                readForThreadIds(selectShellProviderThreadRows),
+                readForThreadIds(selectShellPendingTurnItemRows),
+              ]);
+
+            const { runOrdinalsByThreadId, itemCountsByThreadId } = runMapsByThreadId({
+              runRows,
+              itemCountRows,
+            });
+            const { providerThreadsByThreadId, pendingTurnItemsByThreadId } =
+              yield* pendingBackgroundDataByThreadId({ providerThreadRows, pendingTurnItemRows });
+            const states = yield* Effect.forEach(threadRows, (row) =>
+              shellThreadStateFromRow({
+                row,
+                runOrdinalsByThreadId,
+                itemCountsByThreadId,
+                providerThreadsByThreadId,
+                pendingTurnItemsByThreadId,
+              }),
+            );
+            const statesByThreadId = new Map(states.map((state) => [state.thread.id, state]));
+
+            const shells = states
+              .filter((state) => targetThreadIds.has(state.thread.id))
+              .map((state) =>
+                shellFromState({
+                  state,
+                  visibleItemCount: visibleItemCountForShell({
+                    threadId: state.thread.id,
+                    statesByThreadId,
+                  }),
+                }),
+              );
+
+            return {
+              schemaVersion: ORCHESTRATION_V2_PROJECTION_SCHEMA_VERSION,
+              snapshotSequence: sequenceRows[0]?.snapshot_sequence ?? 0,
+              threads: shells.filter((thread) => thread.archivedAt === null),
+              archivedThreads: shells.filter((thread) => thread.archivedAt !== null),
+            };
+          }),
+        )
+        .pipe(
+          Effect.mapError(
+            (cause) =>
+              new ProjectionStoreReadError({
+                threadId: ThreadId.make("thread:shell"),
+                cause,
+              }),
+          ),
+        );
+
+    // Per-thread shell for the live shell streams: reads only the target thread
+    // plus its fork-source chain instead of materializing every thread. Returns
+    // null when the thread is deleted or unknown.
+    const getThreadShell: ProjectionStoreV2Shape["getThreadShell"] = (threadId) =>
+      sql
+        .withTransaction(
+          Effect.gen(function* () {
+            const rowsByThreadId = new Map<ThreadId, ShellThreadRow>();
+            const pending: Array<ThreadId> = [threadId];
+            while (pending.length > 0) {
+              const nextId = pending.pop();
+              if (nextId === undefined || rowsByThreadId.has(nextId)) {
+                continue;
+              }
+              const rows = yield* selectShellThreadRows(nextId);
+              const row = rows[0];
+              if (row === undefined) {
+                continue;
+              }
+              rowsByThreadId.set(nextId, row);
+              if (row.forked_from_run_source_thread_id !== null) {
+                pending.push(ThreadId.make(row.forked_from_run_source_thread_id));
+              }
+            }
+            if (!rowsByThreadId.has(threadId)) {
+              return null;
+            }
+
+            const threadIds = [...rowsByThreadId.keys()];
+            const [runRows, itemCountRows, providerThreadRows, pendingTurnItemRows] =
+              yield* Effect.all([
+                selectShellRunRows(threadIds),
+                selectShellRunItemCounts(threadIds),
+                selectShellProviderThreadRows(threadIds),
+                selectShellPendingTurnItemRows(threadIds),
+              ]);
+            const { runOrdinalsByThreadId, itemCountsByThreadId } = runMapsByThreadId({
+              runRows,
+              itemCountRows,
+            });
+            const { providerThreadsByThreadId, pendingTurnItemsByThreadId } =
+              yield* pendingBackgroundDataByThreadId({ providerThreadRows, pendingTurnItemRows });
+
+            const states = yield* Effect.forEach([...rowsByThreadId.values()], (row) =>
+              shellThreadStateFromRow({
+                row,
+                runOrdinalsByThreadId,
+                itemCountsByThreadId,
+                providerThreadsByThreadId,
+                pendingTurnItemsByThreadId,
+              }),
+            );
+            const statesByThreadId = new Map(states.map((state) => [state.thread.id, state]));
+            const state = statesByThreadId.get(threadId);
+            if (state === undefined) {
+              return null;
+            }
+            return shellFromState({
+              state,
+              visibleItemCount: visibleItemCountForShell({ threadId, statesByThreadId }),
+            });
+          }),
+        )
+        .pipe(Effect.mapError((cause) => new ProjectionStoreReadError({ threadId, cause })));
+
+    return {
+      apply,
+      getShellSnapshot,
+      getThreadShell,
+      getThreadProjection,
+      getThreadSnapshot,
+      getThreadSnapshotWindow,
+    } satisfies ProjectionStoreV2Shape;
+  }),
+);
+
+export const layerMemory: Layer.Layer<ProjectionStoreV2> = Layer.effect(
+  ProjectionStoreV2,
+  Effect.gen(function* () {
+    const replayState = yield* Ref.make(makeProjectionReplayState());
+    const sequence = yield* Ref.make(0);
+
+    const service: ProjectionStoreV2Shape = {
+      apply: (event) =>
+        Effect.gen(function* () {
+          const result = yield* Ref.modify(replayState, (existing) => {
+            const next: ProjectionReplayState = {
+              projections: new Map(existing.projections),
+              providerSessionThreadIds: new Map(existing.providerSessionThreadIds),
+            };
+            if (!applyToProjectionReplayState(next, event)) {
+              return [
+                new ProjectionStoreThreadNotFoundError({ threadId: event.threadId }),
+                existing,
+              ] as const;
+            }
+            return [undefined, next] as const;
+          });
+
+          if (result) {
+            return yield* result;
+          }
+          yield* Ref.update(sequence, (current) => current + 1);
+        }),
+      getShellSnapshot: (options) =>
+        Effect.gen(function* () {
+          const existing = (yield* Ref.get(replayState)).projections;
+          const selectedThreadIds = [...existing.entries()]
+            .filter(([, projection]) => {
+              if (options?.location === "active") return projection.thread.archivedAt === null;
+              if (options?.location === "archive") return projection.thread.archivedAt !== null;
+              return true;
+            })
+            .map(([threadId]) => threadId);
+          const shells = yield* Effect.forEach(
+            selectedThreadIds.toSorted((left, right) => String(left).localeCompare(String(right))),
+            (threadId) =>
+              service.getThreadProjection(threadId).pipe(Effect.map(threadShellFromProjection)),
+          );
+          const visible = shells.filter((thread) => thread.deletedAt === null);
+          return {
+            schemaVersion: ORCHESTRATION_V2_PROJECTION_SCHEMA_VERSION,
+            snapshotSequence: yield* Ref.get(sequence),
+            threads: visible.filter((thread) => thread.archivedAt === null),
+            archivedThreads: visible.filter((thread) => thread.archivedAt !== null),
+          };
+        }),
+      getThreadShell: (threadId) =>
+        Effect.gen(function* () {
+          const existing = (yield* Ref.get(replayState)).projections;
+          if (!existing.has(threadId)) {
+            return null;
+          }
+          const shell = yield* service
+            .getThreadProjection(threadId)
+            .pipe(Effect.map(threadShellFromProjection));
+          return shell.deletedAt === null ? shell : null;
+        }),
+      getThreadProjection: (threadId) =>
+        Effect.gen(function* () {
+          const existing = (yield* Ref.get(replayState)).projections;
+          const readProjection = (
+            targetThreadId: ThreadId,
+            seenThreadIds: ReadonlySet<ThreadId>,
+          ): OrchestrationV2ThreadProjection | null => {
+            const projection = existing.get(targetThreadId);
+            if (!projection) {
+              return null;
+            }
+            const forkedFrom = projection.thread.forkedFrom;
+            if (forkedFrom?.type !== "run" || seenThreadIds.has(forkedFrom.threadId)) {
+              return withLocalVisibleTurnItems(projection);
+            }
+            const sourceProjection = readProjection(
+              forkedFrom.threadId,
+              new Set([...seenThreadIds, targetThreadId]),
+            );
+            return {
+              ...projection,
+              visibleTurnItems: buildVisibleTurnItems({
+                projection,
+                sourceProjection,
+              }),
+            };
+          };
+          const projection = readProjection(threadId, new Set());
+          if (!projection) {
+            return yield* new ProjectionStoreThreadNotFoundError({ threadId });
+          }
+          return projection;
+        }),
+      getThreadSnapshot: (threadId) =>
+        service.getThreadProjection(threadId).pipe(
+          Effect.flatMap((projection) =>
+            Ref.get(sequence).pipe(
+              Effect.map((snapshotSequence) => ({
+                schemaVersion: ORCHESTRATION_V2_PROJECTION_SCHEMA_VERSION,
+                snapshotSequence,
+                projection,
+              })),
+            ),
+          ),
+        ),
+      getThreadSnapshotWindow: (threadId, options) =>
+        service.getThreadSnapshot(threadId).pipe(
+          Effect.map((snapshot) => {
+            const anchorIndex =
+              options.anchorItemId === undefined
+                ? snapshot.projection.visibleTurnItems.length
+                : snapshot.projection.visibleTurnItems.findIndex(
+                    (row) => row.sourceItemId === options.anchorItemId,
+                  ) + 1;
+            const visibleTurnItems = snapshot.projection.visibleTurnItems.slice(
+              Math.max(0, anchorIndex - options.rowLimit),
+              anchorIndex,
+            );
+            return {
+              ...snapshot,
+              projection: { ...snapshot.projection, visibleTurnItems },
+            };
+          }),
+        ),
+    };
+
+    return service;
+  }),
+);
diff --git a/apps/server/src/orchestration-v2/ProviderAdapter.ts b/apps/server/src/orchestration-v2/ProviderAdapter.ts
new file mode 100644
index 000000000000..79beb8e728a7
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ProviderAdapter.ts
@@ -0,0 +1,554 @@
+import {
+  ChatAttachment,
+  CheckpointId,
+  MessageId,
+  ModelSelection,
+  NodeId,
+  OrchestrationV2AppThread,
+  OrchestrationV2ConversationMessage,
+  OrchestrationV2ExecutionNode,
+  OrchestrationV2ProviderSession,
+  OrchestrationV2PlanArtifact,
+  OrchestrationV2ProviderCapabilities,
+  OrchestrationV2ProviderFailure,
+  OrchestrationV2ProviderRetry,
+  OrchestrationV2ProviderThread,
+  OrchestrationV2ProviderTurn,
+  OrchestrationV2RuntimeRequest,
+  OrchestrationV2Subagent,
+  OrchestrationV2TurnItem,
+  ProviderApprovalDecision,
+  ProviderInteractionMode,
+  ProviderDriverKind,
+  ProviderInstanceId,
+  PositiveInt,
+  ProviderUserInputAnswers,
+  ProviderSessionId,
+  ProviderThreadId,
+  ProviderTurnId,
+  RuntimeMode,
+  RuntimeRequestId,
+  RunAttemptId,
+  RunId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as Context from "effect/Context";
+import * as Schema from "effect/Schema";
+import type * as Effect from "effect/Effect";
+import type * as Scope from "effect/Scope";
+import type * as Stream from "effect/Stream";
+
+import type {
+  ProviderSelectionTransitionInput,
+  ProviderSelectionTransitionPlan,
+} from "./ProviderSelectionTransition.ts";
+
+export const ProviderAdapterV2RuntimePolicy = Schema.Struct({
+  runtimeMode: RuntimeMode,
+  interactionMode: ProviderInteractionMode,
+  cwd: Schema.NullOr(Schema.String),
+  approvalPolicy: Schema.optional(Schema.Unknown),
+  sandboxPolicy: Schema.optional(Schema.Unknown),
+  reasoningEffort: Schema.optional(Schema.String),
+});
+export type ProviderAdapterV2RuntimePolicy = typeof ProviderAdapterV2RuntimePolicy.Type;
+
+export const ProviderAdapterV2TurnMessage = Schema.Struct({
+  messageId: MessageId,
+  text: Schema.String,
+  attachments: Schema.Array(ChatAttachment),
+  createdBy: OrchestrationV2ConversationMessage.fields.createdBy,
+  creationSource: OrchestrationV2ConversationMessage.fields.creationSource,
+});
+export type ProviderAdapterV2TurnMessage = typeof ProviderAdapterV2TurnMessage.Type;
+
+export const ProviderAdapterV2SessionStatus = Schema.Literals([
+  "starting",
+  "ready",
+  "running",
+  "waiting",
+  "stopped",
+  "error",
+]);
+export type ProviderAdapterV2SessionStatus = typeof ProviderAdapterV2SessionStatus.Type;
+
+export const ProviderAdapterV2Event = Schema.Union([
+  Schema.Struct({
+    type: Schema.Literal("app_thread.created"),
+    driver: ProviderDriverKind,
+    appThread: OrchestrationV2AppThread,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("provider_session.updated"),
+    driver: ProviderDriverKind,
+    providerSession: OrchestrationV2ProviderSession,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("provider_thread.updated"),
+    driver: ProviderDriverKind,
+    providerThread: OrchestrationV2ProviderThread,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("provider_turn.updated"),
+    driver: ProviderDriverKind,
+    threadId: Schema.optional(ThreadId),
+    providerTurn: OrchestrationV2ProviderTurn,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("node.updated"),
+    driver: ProviderDriverKind,
+    node: OrchestrationV2ExecutionNode,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("subagent.updated"),
+    driver: ProviderDriverKind,
+    subagent: OrchestrationV2Subagent,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("message.updated"),
+    driver: ProviderDriverKind,
+    message: OrchestrationV2ConversationMessage,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("turn_item.updated"),
+    driver: ProviderDriverKind,
+    turnItem: OrchestrationV2TurnItem,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("runtime_request.updated"),
+    driver: ProviderDriverKind,
+    threadId: Schema.optional(ThreadId),
+    runtimeRequest: OrchestrationV2RuntimeRequest,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("plan.updated"),
+    driver: ProviderDriverKind,
+    plan: OrchestrationV2PlanArtifact,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("turn.terminal"),
+    driver: ProviderDriverKind,
+    providerThreadId: ProviderThreadId,
+    providerTurnId: ProviderTurnId,
+    runOrdinal: PositiveInt,
+    status: Schema.Literals(["completed", "interrupted", "cancelled"]),
+    failure: Schema.Null,
+    threadDisposition: Schema.Literals(["reusable", "broken"]),
+  }),
+  Schema.Struct({
+    type: Schema.Literal("turn.terminal"),
+    driver: ProviderDriverKind,
+    providerThreadId: ProviderThreadId,
+    providerTurnId: ProviderTurnId,
+    runOrdinal: PositiveInt,
+    failureItemOrdinal: PositiveInt,
+    status: Schema.Literal("failed"),
+    failure: OrchestrationV2ProviderFailure,
+    retry: Schema.optional(OrchestrationV2ProviderRetry),
+    retryStartedAt: Schema.optional(Schema.DateTimeUtc),
+    threadDisposition: Schema.Literals(["reusable", "broken"]),
+  }),
+]);
+export type ProviderAdapterV2Event = typeof ProviderAdapterV2Event.Type;
+
+export class ProviderAdapterCapabilitiesError extends Schema.TaggedErrorClass<ProviderAdapterCapabilitiesError>()(
+  "ProviderAdapterCapabilitiesError",
+  {
+    driver: ProviderDriverKind,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to read ${this.driver} provider capabilities.`;
+  }
+}
+
+export class ProviderAdapterOpenSessionError extends Schema.TaggedErrorClass<ProviderAdapterOpenSessionError>()(
+  "ProviderAdapterOpenSessionError",
+  {
+    driver: ProviderDriverKind,
+    providerSessionId: ProviderSessionId,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to open ${this.driver} provider session ${this.providerSessionId}.`;
+  }
+}
+
+export class ProviderAdapterCloseSessionError extends Schema.TaggedErrorClass<ProviderAdapterCloseSessionError>()(
+  "ProviderAdapterCloseSessionError",
+  {
+    driver: ProviderDriverKind,
+    providerSessionId: ProviderSessionId,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to close ${this.driver} provider session ${this.providerSessionId}.`;
+  }
+}
+
+export class ProviderAdapterResumeThreadError extends Schema.TaggedErrorClass<ProviderAdapterResumeThreadError>()(
+  "ProviderAdapterResumeThreadError",
+  {
+    driver: ProviderDriverKind,
+    providerSessionId: ProviderSessionId,
+    providerThreadId: ProviderThreadId,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to resume ${this.driver} provider thread ${this.providerThreadId}.`;
+  }
+}
+
+export class ProviderAdapterEnsureThreadError extends Schema.TaggedErrorClass<ProviderAdapterEnsureThreadError>()(
+  "ProviderAdapterEnsureThreadError",
+  {
+    driver: ProviderDriverKind,
+    threadId: ThreadId,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to ensure ${this.driver} provider thread for app thread ${this.threadId}.`;
+  }
+}
+
+export class ProviderAdapterReadThreadSnapshotError extends Schema.TaggedErrorClass<ProviderAdapterReadThreadSnapshotError>()(
+  "ProviderAdapterReadThreadSnapshotError",
+  {
+    driver: ProviderDriverKind,
+    providerThreadId: ProviderThreadId,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to read ${this.driver} provider thread snapshot ${this.providerThreadId}.`;
+  }
+}
+
+export class ProviderAdapterRollbackThreadError extends Schema.TaggedErrorClass<ProviderAdapterRollbackThreadError>()(
+  "ProviderAdapterRollbackThreadError",
+  {
+    driver: ProviderDriverKind,
+    providerThreadId: ProviderThreadId,
+    checkpointId: Schema.optional(CheckpointId),
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to roll back ${this.driver} provider thread ${this.providerThreadId}.`;
+  }
+}
+
+export class ProviderAdapterForkThreadError extends Schema.TaggedErrorClass<ProviderAdapterForkThreadError>()(
+  "ProviderAdapterForkThreadError",
+  {
+    driver: ProviderDriverKind,
+    providerThreadId: ProviderThreadId,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to fork ${this.driver} provider thread ${this.providerThreadId}.`;
+  }
+}
+
+export class ProviderAdapterTurnStartError extends Schema.TaggedErrorClass<ProviderAdapterTurnStartError>()(
+  "ProviderAdapterTurnStartError",
+  {
+    driver: ProviderDriverKind,
+    threadId: ThreadId,
+    providerThreadId: ProviderThreadId,
+    runId: RunId,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to start run ${this.runId} on ${this.driver} provider thread ${this.providerThreadId}.`;
+  }
+}
+
+export class ProviderAdapterSteerRunUnsupportedError extends Schema.TaggedErrorClass<ProviderAdapterSteerRunUnsupportedError>()(
+  "ProviderAdapterSteerRunUnsupportedError",
+  {
+    driver: ProviderDriverKind,
+    providerThreadId: ProviderThreadId,
+  },
+) {
+  override get message(): string {
+    return `${this.driver} provider thread ${this.providerThreadId} does not support active-run steering.`;
+  }
+}
+
+export class ProviderAdapterSteerRunError extends Schema.TaggedErrorClass<ProviderAdapterSteerRunError>()(
+  "ProviderAdapterSteerRunError",
+  {
+    driver: ProviderDriverKind,
+    providerThreadId: ProviderThreadId,
+    providerTurnId: ProviderTurnId,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to steer active run ${this.providerTurnId} on ${this.driver} provider thread ${this.providerThreadId}.`;
+  }
+}
+
+export class ProviderAdapterInterruptError extends Schema.TaggedErrorClass<ProviderAdapterInterruptError>()(
+  "ProviderAdapterInterruptError",
+  {
+    driver: ProviderDriverKind,
+    providerThreadId: ProviderThreadId,
+    providerTurnId: ProviderTurnId,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to interrupt ${this.driver} provider turn ${this.providerTurnId}.`;
+  }
+}
+
+export class ProviderAdapterRuntimeRequestResponseError extends Schema.TaggedErrorClass<ProviderAdapterRuntimeRequestResponseError>()(
+  "ProviderAdapterRuntimeRequestResponseError",
+  {
+    driver: ProviderDriverKind,
+    requestId: RuntimeRequestId,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to respond to ${this.driver} runtime request ${this.requestId}.`;
+  }
+}
+
+export class ProviderAdapterEventStreamError extends Schema.TaggedErrorClass<ProviderAdapterEventStreamError>()(
+  "ProviderAdapterEventStreamError",
+  {
+    driver: ProviderDriverKind,
+    providerSessionId: ProviderSessionId,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed while streaming ${this.driver} provider session ${this.providerSessionId} events.`;
+  }
+}
+
+export class ProviderAdapterProtocolError extends Schema.TaggedErrorClass<ProviderAdapterProtocolError>()(
+  "ProviderAdapterProtocolError",
+  {
+    driver: ProviderDriverKind,
+    detail: Schema.String,
+    payload: Schema.optional(Schema.Unknown),
+  },
+) {
+  override get message(): string {
+    return `${this.driver} provider protocol error: ${this.detail}.`;
+  }
+}
+
+export const ProviderAdapterV2Error = Schema.Union([
+  ProviderAdapterCapabilitiesError,
+  ProviderAdapterOpenSessionError,
+  ProviderAdapterCloseSessionError,
+  ProviderAdapterResumeThreadError,
+  ProviderAdapterEnsureThreadError,
+  ProviderAdapterReadThreadSnapshotError,
+  ProviderAdapterRollbackThreadError,
+  ProviderAdapterForkThreadError,
+  ProviderAdapterTurnStartError,
+  ProviderAdapterSteerRunUnsupportedError,
+  ProviderAdapterSteerRunError,
+  ProviderAdapterInterruptError,
+  ProviderAdapterRuntimeRequestResponseError,
+  ProviderAdapterEventStreamError,
+  ProviderAdapterProtocolError,
+]);
+export type ProviderAdapterV2Error = typeof ProviderAdapterV2Error.Type;
+
+export interface ProviderAdapterV2OpenSessionInput {
+  readonly threadId: ThreadId;
+  readonly providerSessionId: ProviderSessionId;
+  readonly modelSelection: ModelSelection;
+  readonly runtimePolicy: ProviderAdapterV2RuntimePolicy;
+  readonly resumeFromSession?: OrchestrationV2ProviderSession;
+}
+
+export interface ProviderAdapterV2EnsureThreadInput {
+  readonly threadId: ThreadId;
+  readonly modelSelection: ModelSelection;
+  readonly runtimePolicy: ProviderAdapterV2RuntimePolicy;
+  readonly providerSessionId?: ProviderSessionId;
+  readonly existingProviderThread?: OrchestrationV2ProviderThread;
+}
+
+export interface ProviderAdapterV2TurnInput {
+  readonly appThread: OrchestrationV2AppThread;
+  readonly threadId: ThreadId;
+  readonly runId: RunId;
+  readonly runOrdinal: number;
+  readonly providerTurnOrdinal: number;
+  readonly attemptId: RunAttemptId;
+  readonly rootNodeId: NodeId;
+  readonly providerThread: OrchestrationV2ProviderThread;
+  readonly message: ProviderAdapterV2TurnMessage;
+  readonly modelSelection: ModelSelection;
+  readonly runtimePolicy: ProviderAdapterV2RuntimePolicy;
+}
+
+export interface ProviderAdapterV2SteerInput {
+  readonly threadId: ThreadId;
+  readonly runId: RunId;
+  readonly providerThread: OrchestrationV2ProviderThread;
+  readonly providerTurnId: ProviderTurnId;
+  readonly message: ProviderAdapterV2TurnMessage;
+}
+
+export interface ProviderAdapterV2InterruptInput {
+  readonly providerThread: OrchestrationV2ProviderThread;
+  readonly providerTurnId: ProviderTurnId;
+  /** When true, the next `startTurn` may respawn the provider runtime (Grok Stop recovery). */
+  readonly requestRuntimeRestart?: boolean;
+}
+
+export interface ProviderAdapterV2RuntimeRequestResponseInput {
+  readonly requestId: RuntimeRequestId;
+  readonly decision?: ProviderApprovalDecision;
+  readonly answers?: ProviderUserInputAnswers;
+  readonly response?: unknown;
+}
+
+export interface ProviderAdapterV2ThreadSnapshot {
+  readonly providerThread: OrchestrationV2ProviderThread;
+  readonly providerTurns: ReadonlyArray<OrchestrationV2ProviderTurn>;
+  readonly messages: ReadonlyArray<OrchestrationV2ConversationMessage>;
+  readonly runtimeRequests: ReadonlyArray<OrchestrationV2RuntimeRequest>;
+  readonly providerPayload?: unknown;
+}
+
+export interface ProviderAdapterV2ReadThreadSnapshotInput {
+  readonly providerThread: OrchestrationV2ProviderThread;
+}
+
+export type ProviderAdapterV2RollbackTarget =
+  | {
+      readonly type: "thread_start";
+      readonly checkpointId: CheckpointId;
+      readonly appRunOrdinal: 0;
+    }
+  | {
+      readonly type: "provider_turn";
+      readonly checkpointId: CheckpointId;
+      readonly appRunOrdinal: number;
+      readonly providerTurn: OrchestrationV2ProviderTurn;
+    };
+
+export interface ProviderAdapterV2RollbackThreadInput {
+  readonly providerThread: OrchestrationV2ProviderThread;
+  readonly target: ProviderAdapterV2RollbackTarget;
+  readonly providerThreadTurns: ReadonlyArray<OrchestrationV2ProviderTurn>;
+}
+
+export interface ProviderAdapterV2ForkThreadInput {
+  readonly sourceProviderThread: OrchestrationV2ProviderThread;
+  readonly sourceProviderTurns?: ReadonlyArray<OrchestrationV2ProviderTurn>;
+  readonly providerTurnId?: ProviderTurnId;
+  readonly targetThreadId: ThreadId;
+  readonly ownerNodeId?: NodeId;
+  readonly modelSelection?: ModelSelection;
+  readonly runtimePolicy?: ProviderAdapterV2RuntimePolicy;
+}
+
+export interface ProviderAdapterV2EventSubscription {
+  readonly events: Stream.Stream<ProviderAdapterV2Event, ProviderAdapterV2Error>;
+  readonly close: Effect.Effect<void>;
+}
+
+export interface ProviderAdapterV2SessionRuntime {
+  readonly instanceId: ProviderInstanceId;
+  readonly driver: ProviderDriverKind;
+  readonly providerSessionId: ProviderSessionId;
+  readonly providerSession: OrchestrationV2ProviderSession;
+  readonly events: Stream.Stream<ProviderAdapterV2Event, ProviderAdapterV2Error>;
+  /**
+   * Manager-owned runtimes expose a synchronous subscription so concurrent
+   * provider threads receive independent copies of the process event stream.
+   * Adapter runtimes may omit this and expose only their single-consumer event stream.
+   */
+  readonly subscribeEvents?: Effect.Effect<ProviderAdapterV2EventSubscription>;
+  /**
+   * Adapters whose native runtime can hold pending work outside an active
+   * turn (for example Claude background tasks and their wake turns) report it
+   * here so the session manager defers idle release while it is pending.
+   */
+  readonly hasPendingBackgroundWork?: Effect.Effect<boolean>;
+  /**
+   * Per-provider-thread pending work for root-run ingestion stop gates. When
+   * present, RunExecutionService uses only this probe (never the session-wide
+   * hasPendingBackgroundWork) so sibling native threads cannot pin an
+   * unrelated root subscription open.
+   */
+  readonly hasPendingBackgroundWorkForThread?: (
+    providerThread: OrchestrationV2ProviderThread,
+  ) => Effect.Effect<boolean>;
+  readonly ensureThread: (
+    input: ProviderAdapterV2EnsureThreadInput,
+  ) => Effect.Effect<OrchestrationV2ProviderThread, ProviderAdapterV2Error>;
+  readonly resumeThread: (input: {
+    readonly providerThread: OrchestrationV2ProviderThread;
+    readonly threadId?: ThreadId;
+    readonly modelSelection?: ModelSelection;
+    readonly runtimePolicy?: ProviderAdapterV2RuntimePolicy;
+  }) => Effect.Effect<OrchestrationV2ProviderThread, ProviderAdapterV2Error>;
+  readonly startTurn: (
+    input: ProviderAdapterV2TurnInput,
+  ) => Effect.Effect<void, ProviderAdapterV2Error>;
+  readonly steerTurn: (
+    input: ProviderAdapterV2SteerInput,
+  ) => Effect.Effect<void, ProviderAdapterV2Error>;
+  readonly interruptTurn: (
+    input: ProviderAdapterV2InterruptInput,
+  ) => Effect.Effect<void, ProviderAdapterV2Error>;
+  readonly respondToRuntimeRequest: (
+    input: ProviderAdapterV2RuntimeRequestResponseInput,
+  ) => Effect.Effect<void, ProviderAdapterV2Error>;
+  readonly readThreadSnapshot: (
+    input: ProviderAdapterV2ReadThreadSnapshotInput,
+  ) => Effect.Effect<ProviderAdapterV2ThreadSnapshot, ProviderAdapterV2Error>;
+  /**
+   * Providers that accept product feedback for a thread (#7949, Codex → OpenAI)
+   * expose it here; absent means the driver has no feedback channel.
+   */
+  readonly uploadFeedback?: (input: {
+    readonly providerThread: OrchestrationV2ProviderThread;
+    readonly reason?: string;
+  }) => Effect.Effect<{ readonly feedbackId: string }, ProviderAdapterV2Error>;
+  readonly rollbackThread: (
+    input: ProviderAdapterV2RollbackThreadInput,
+  ) => Effect.Effect<ProviderAdapterV2ThreadSnapshot, ProviderAdapterV2Error>;
+  readonly forkThread: (
+    input: ProviderAdapterV2ForkThreadInput,
+  ) => Effect.Effect<OrchestrationV2ProviderThread, ProviderAdapterV2Error>;
+}
+
+export interface ProviderAdapterV2Shape {
+  readonly instanceId: ProviderInstanceId;
+  readonly driver: ProviderDriverKind;
+  readonly getCapabilities: () => Effect.Effect<
+    OrchestrationV2ProviderCapabilities,
+    ProviderAdapterV2Error
+  >;
+  readonly planSelectionTransition: (
+    input: ProviderSelectionTransitionInput,
+  ) => Effect.Effect<ProviderSelectionTransitionPlan, ProviderAdapterV2Error>;
+  readonly openSession: (
+    input: ProviderAdapterV2OpenSessionInput,
+  ) => Effect.Effect<ProviderAdapterV2SessionRuntime, ProviderAdapterV2Error, Scope.Scope>;
+}
+
+export class ProviderAdapterV2 extends Context.Service<ProviderAdapterV2, ProviderAdapterV2Shape>()(
+  "t3/orchestration-v2/ProviderAdapter/ProviderAdapterV2",
+) {}
diff --git a/apps/server/src/orchestration-v2/ProviderAdapterDriver.ts b/apps/server/src/orchestration-v2/ProviderAdapterDriver.ts
new file mode 100644
index 000000000000..6534386c2742
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ProviderAdapterDriver.ts
@@ -0,0 +1,44 @@
+import {
+  ProviderDriverKind,
+  ProviderInstanceId,
+  type ProviderInstanceEnvironment,
+} from "@t3tools/contracts";
+import * as Schema from "effect/Schema";
+import type * as Effect from "effect/Effect";
+import type * as Scope from "effect/Scope";
+
+import type { ProviderAdapterV2Shape } from "./ProviderAdapter.ts";
+
+export class ProviderAdapterDriverCreateError extends Schema.TaggedErrorClass<ProviderAdapterDriverCreateError>()(
+  "ProviderAdapterDriverCreateError",
+  {
+    driver: ProviderDriverKind,
+    instanceId: ProviderInstanceId,
+    detail: Schema.String,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to create orchestration-v2 provider adapter ${this.instanceId} (${this.driver}): ${this.detail}`;
+  }
+}
+
+export interface ProviderAdapterDriverCreateInput<Config> {
+  readonly instanceId: ProviderInstanceId;
+  readonly displayName: string | undefined;
+  readonly accentColor?: string | undefined;
+  readonly environment: ProviderInstanceEnvironment;
+  readonly enabled: boolean;
+  readonly config: Config;
+}
+
+export interface ProviderAdapterDriver<Config, R = never> {
+  readonly driverKind: ProviderDriverKind;
+  readonly configSchema: Schema.Codec<Config, unknown>;
+  readonly defaultConfig: () => Config;
+  readonly create: (
+    input: ProviderAdapterDriverCreateInput<Config>,
+  ) => Effect.Effect<ProviderAdapterV2Shape, ProviderAdapterDriverCreateError, R | Scope.Scope>;
+}
+
+export type AnyProviderAdapterDriver<R = never> = ProviderAdapterDriver<any, R>;
diff --git a/apps/server/src/orchestration-v2/ProviderAdapterRegistry.test.ts b/apps/server/src/orchestration-v2/ProviderAdapterRegistry.test.ts
new file mode 100644
index 000000000000..33a58480a6f8
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ProviderAdapterRegistry.test.ts
@@ -0,0 +1,211 @@
+import { assert, it } from "@effect/vitest";
+import {
+  ProviderDriverKind,
+  ProviderInstanceId,
+  type ProviderInstanceConfigMap,
+} from "@t3tools/contracts";
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as Fiber from "effect/Fiber";
+import * as Layer from "effect/Layer";
+import * as Ref from "effect/Ref";
+import * as Schema from "effect/Schema";
+import type * as Scope from "effect/Scope";
+import * as Stream from "effect/Stream";
+
+import type { ProviderInstance } from "../provider/ProviderDriver.ts";
+import { ProviderInstanceRegistry } from "../provider/Services/ProviderInstanceRegistry.ts";
+import type { ProviderAdapterV2Shape } from "./ProviderAdapter.ts";
+import {
+  ProviderAdapterDriverCreateError,
+  type ProviderAdapterDriver,
+} from "./ProviderAdapterDriver.ts";
+import {
+  layerFromProviderInstanceRegistry,
+  makeRegistryFromConfigMap,
+  ProviderAdapterRegistryV2,
+} from "./ProviderAdapterRegistry.ts";
+
+const driver = ProviderDriverKind.make("codex");
+const personalId = ProviderInstanceId.make("codex_personal");
+const workId = ProviderInstanceId.make("codex_work");
+
+const makeAdapter = (instanceId: ProviderInstanceId): ProviderAdapterV2Shape =>
+  ({
+    instanceId,
+    driver,
+    getCapabilities: () => Effect.die("capabilities are not used by this registry test"),
+    planSelectionTransition: () => Effect.succeed({ type: "apply_on_next_turn" }),
+    openSession: () => Effect.die("sessions are not used by this registry test"),
+  }) as ProviderAdapterV2Shape;
+
+const makeInstance = (
+  instanceId: ProviderInstanceId,
+  orchestrationAdapter: ProviderAdapterV2Shape,
+): ProviderInstance => ({
+  instanceId,
+  driverKind: driver,
+  continuationIdentity: {
+    driverKind: driver,
+    continuationKey: `codex:test:${instanceId}`,
+  },
+  displayName: String(instanceId),
+  enabled: true,
+  snapshot: {} as ProviderInstance["snapshot"],
+  orchestrationAdapter,
+  textGeneration: {} as ProviderInstance["textGeneration"],
+});
+
+const personalAdapter = makeAdapter(personalId);
+const workAdapter = makeAdapter(workId);
+const instances = [
+  makeInstance(personalId, personalAdapter),
+  makeInstance(workId, workAdapter),
+] as const;
+const instanceRegistryLayer = Layer.succeed(ProviderInstanceRegistry, {
+  getInstance: (instanceId) =>
+    Effect.succeed(instances.find((instance) => instance.instanceId === instanceId)),
+  listInstances: Effect.succeed(instances),
+  listUnavailable: Effect.succeed([]),
+  streamChanges: Stream.empty,
+  subscribeChanges: Effect.never,
+});
+const TestLayer = layerFromProviderInstanceRegistry.pipe(Layer.provide(instanceRegistryLayer));
+
+it.effect("routes two configured instances of the same driver independently", () =>
+  Effect.gen(function* () {
+    const registry = yield* ProviderAdapterRegistryV2;
+
+    assert.strictEqual(yield* registry.get(personalId), personalAdapter);
+    assert.strictEqual(yield* registry.get(workId), workAdapter);
+    assert.deepEqual(yield* registry.list(), [personalId, workId]);
+  }).pipe(Effect.provide(TestLayer)),
+);
+
+const lifecycleDriver = ProviderDriverKind.make("lifecycle-test");
+const lifecycleInstanceId = ProviderInstanceId.make("lifecycle-test");
+const lifecycleConfigMap: ProviderInstanceConfigMap = {
+  [lifecycleInstanceId]: {
+    driver: lifecycleDriver,
+    config: {},
+  },
+};
+const lifecycleAdapter = makeAdapter(lifecycleInstanceId);
+
+const makeLifecycleDriver = (
+  create: Effect.Effect<ProviderAdapterV2Shape, ProviderAdapterDriverCreateError, Scope.Scope>,
+): ProviderAdapterDriver<Record<string, never>> => ({
+  driverKind: lifecycleDriver,
+  configSchema: Schema.Struct({}),
+  defaultConfig: () => ({}),
+  create: () => create,
+});
+
+const trackedCreate = <A, E, R>(
+  releases: Ref.Ref<number>,
+  effect: Effect.Effect<A, E, R>,
+): Effect.Effect<A, E, R | Scope.Scope> =>
+  Effect.gen(function* () {
+    yield* Effect.addFinalizer(() => Ref.update(releases, (count) => count + 1));
+    return yield* effect;
+  });
+
+it.effect("closes a partially-created adapter scope immediately on typed failure", () =>
+  Effect.gen(function* () {
+    const releases = yield* Ref.make(0);
+    const createError = new ProviderAdapterDriverCreateError({
+      driver: lifecycleDriver,
+      instanceId: lifecycleInstanceId,
+      detail: "expected test failure",
+    });
+
+    yield* Effect.scoped(
+      Effect.gen(function* () {
+        const exit = yield* makeRegistryFromConfigMap({
+          drivers: [makeLifecycleDriver(trackedCreate(releases, Effect.fail(createError)))],
+          configMap: lifecycleConfigMap,
+        }).pipe(Effect.exit);
+
+        assert.isTrue(Exit.isFailure(exit));
+        assert.strictEqual(yield* Ref.get(releases), 1);
+      }),
+    );
+
+    assert.strictEqual(yield* Ref.get(releases), 1);
+  }),
+);
+
+it.effect("closes a partially-created adapter scope immediately on defect", () =>
+  Effect.gen(function* () {
+    const releases = yield* Ref.make(0);
+
+    yield* Effect.scoped(
+      Effect.gen(function* () {
+        const exit = yield* makeRegistryFromConfigMap({
+          drivers: [
+            makeLifecycleDriver(trackedCreate(releases, Effect.die("expected test defect"))),
+          ],
+          configMap: lifecycleConfigMap,
+        }).pipe(Effect.exit);
+
+        assert.isTrue(Exit.hasDies(exit));
+        assert.strictEqual(yield* Ref.get(releases), 1);
+      }),
+    );
+
+    assert.strictEqual(yield* Ref.get(releases), 1);
+  }),
+);
+
+it.effect("closes a partially-created adapter scope immediately on interruption", () =>
+  Effect.gen(function* () {
+    const releases = yield* Ref.make(0);
+    const createStarted = yield* Deferred.make<void>();
+
+    yield* Effect.scoped(
+      Effect.gen(function* () {
+        const fiber = yield* makeRegistryFromConfigMap({
+          drivers: [
+            makeLifecycleDriver(
+              trackedCreate(
+                releases,
+                Deferred.succeed(createStarted, undefined).pipe(Effect.andThen(Effect.never)),
+              ),
+            ),
+          ],
+          configMap: lifecycleConfigMap,
+        }).pipe(Effect.forkChild({ startImmediately: true }));
+
+        yield* Deferred.await(createStarted);
+        yield* Fiber.interrupt(fiber);
+        const exit = yield* Fiber.await(fiber);
+
+        assert.isTrue(Exit.hasInterrupts(exit));
+        assert.strictEqual(yield* Ref.get(releases), 1);
+      }),
+    );
+
+    assert.strictEqual(yield* Ref.get(releases), 1);
+  }),
+);
+
+it.effect("keeps a successfully-created adapter scope open until normal release", () =>
+  Effect.gen(function* () {
+    const releases = yield* Ref.make(0);
+
+    yield* Effect.scoped(
+      Effect.gen(function* () {
+        const registry = yield* makeRegistryFromConfigMap({
+          drivers: [makeLifecycleDriver(trackedCreate(releases, Effect.succeed(lifecycleAdapter)))],
+          configMap: lifecycleConfigMap,
+        });
+
+        assert.strictEqual(yield* registry.get(lifecycleInstanceId), lifecycleAdapter);
+        assert.strictEqual(yield* Ref.get(releases), 0);
+      }),
+    );
+
+    assert.strictEqual(yield* Ref.get(releases), 1);
+  }),
+);
diff --git a/apps/server/src/orchestration-v2/ProviderAdapterRegistry.ts b/apps/server/src/orchestration-v2/ProviderAdapterRegistry.ts
new file mode 100644
index 000000000000..bcc135140e9c
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ProviderAdapterRegistry.ts
@@ -0,0 +1,319 @@
+import {
+  ProviderInstanceId,
+  type OrchestrationV2ProviderCapabilities,
+  type ProviderDriverKind,
+  type ProviderInstanceConfig,
+  type ProviderInstanceConfigMap,
+} from "@t3tools/contracts";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as Layer from "effect/Layer";
+import * as Schema from "effect/Schema";
+import * as Scope from "effect/Scope";
+
+import { ProviderInstanceRegistry } from "../provider/Services/ProviderInstanceRegistry.ts";
+import {
+  ProviderAdapterDriverCreateError,
+  type AnyProviderAdapterDriver,
+} from "./ProviderAdapterDriver.ts";
+import { ProviderAdapterV2, type ProviderAdapterV2Shape } from "./ProviderAdapter.ts";
+
+export class ProviderAdapterRegistryLookupError extends Schema.TaggedErrorClass<ProviderAdapterRegistryLookupError>()(
+  "ProviderAdapterRegistryLookupError",
+  {
+    instanceId: ProviderInstanceId,
+  },
+) {
+  override get message(): string {
+    return `No orchestration provider adapter is registered for ${this.instanceId}.`;
+  }
+}
+
+export class ProviderAdapterRegistryMetadataError extends Schema.TaggedErrorClass<ProviderAdapterRegistryMetadataError>()(
+  "ProviderAdapterRegistryMetadataError",
+  { instanceId: ProviderInstanceId, cause: Schema.Defect() },
+) {}
+
+export const ProviderAdapterRegistryV2Error = Schema.Union([
+  ProviderAdapterRegistryLookupError,
+  ProviderAdapterRegistryMetadataError,
+  ProviderAdapterDriverCreateError,
+]);
+export type ProviderAdapterRegistryV2Error = typeof ProviderAdapterRegistryV2Error.Type;
+
+export interface ProviderAdapterRegistryV2Shape {
+  readonly get: (
+    instanceId: ProviderInstanceId,
+  ) => Effect.Effect<ProviderAdapterV2Shape, ProviderAdapterRegistryV2Error>;
+  readonly list: () => Effect.Effect<ReadonlyArray<ProviderInstanceId>>;
+  readonly getMetadata?: (instanceId: ProviderInstanceId) => Effect.Effect<
+    {
+      readonly driver: ProviderAdapterV2Shape["driver"];
+      readonly continuationKey: string;
+      readonly enabled: boolean;
+      readonly capabilities: OrchestrationV2ProviderCapabilities;
+    },
+    ProviderAdapterRegistryV2Error
+  >;
+}
+
+export class ProviderAdapterRegistryV2 extends Context.Service<
+  ProviderAdapterRegistryV2,
+  ProviderAdapterRegistryV2Shape
+>()("t3/orchestration-v2/ProviderAdapterRegistry/ProviderAdapterRegistryV2") {}
+
+/**
+ * Production facade over the canonical provider-instance registry. Adapter
+ * lookup stays dynamic so instance hot reloads and removals are visible
+ * without maintaining a second settings watcher or instance map.
+ */
+export const layerFromProviderInstanceRegistry: Layer.Layer<
+  ProviderAdapterRegistryV2,
+  never,
+  ProviderInstanceRegistry
+> = Layer.effect(
+  ProviderAdapterRegistryV2,
+  Effect.gen(function* () {
+    const instances = yield* ProviderInstanceRegistry;
+    return ProviderAdapterRegistryV2.of({
+      get: (instanceId) =>
+        instances
+          .getInstance(instanceId)
+          .pipe(
+            Effect.flatMap((instance) =>
+              instance === undefined
+                ? new ProviderAdapterRegistryLookupError({ instanceId })
+                : Effect.succeed(instance.orchestrationAdapter),
+            ),
+          ),
+      list: () =>
+        instances.listInstances.pipe(
+          Effect.map((available) => available.map((instance) => instance.instanceId)),
+        ),
+      getMetadata: (instanceId) =>
+        Effect.gen(function* () {
+          const instance = yield* instances.getInstance(instanceId);
+          if (instance === undefined) {
+            return yield* new ProviderAdapterRegistryLookupError({ instanceId });
+          }
+          const capabilities = yield* instance.orchestrationAdapter
+            .getCapabilities()
+            .pipe(
+              Effect.mapError(
+                (cause) => new ProviderAdapterRegistryMetadataError({ instanceId, cause }),
+              ),
+            );
+          return {
+            driver: instance.driverKind,
+            continuationKey: instance.continuationIdentity.continuationKey,
+            enabled: instance.enabled,
+            capabilities,
+          };
+        }),
+    });
+  }),
+);
+
+export const ProviderAdapterRegistryBuildError = Schema.Union([ProviderAdapterDriverCreateError]);
+export type ProviderAdapterRegistryBuildError = typeof ProviderAdapterRegistryBuildError.Type;
+
+function makeRegistry(
+  adapters: ReadonlyArray<ProviderAdapterV2Shape>,
+): ProviderAdapterRegistryV2Shape {
+  return {
+    get: (instanceId) =>
+      Effect.gen(function* () {
+        const adapter = adapters.find((candidate) => candidate.instanceId === instanceId);
+        if (!adapter) {
+          return yield* new ProviderAdapterRegistryLookupError({ instanceId });
+        }
+        return adapter;
+      }),
+    list: () => Effect.succeed(adapters.map((adapter) => adapter.instanceId)),
+  };
+}
+
+export function makeLayer(
+  adapters: ReadonlyArray<ProviderAdapterV2Shape>,
+): Layer.Layer<ProviderAdapterRegistryV2> {
+  return Layer.succeed(
+    ProviderAdapterRegistryV2,
+    ProviderAdapterRegistryV2.of(makeRegistry(adapters)),
+  );
+}
+
+export function makeLayerEffect<R, E>(
+  adapters: Effect.Effect<ReadonlyArray<ProviderAdapterV2Shape>, E, R>,
+): Layer.Layer<ProviderAdapterRegistryV2, E, R> {
+  return Layer.effect(
+    ProviderAdapterRegistryV2,
+    adapters.pipe(Effect.map((entries) => ProviderAdapterRegistryV2.of(makeRegistry(entries)))),
+  );
+}
+
+export function makeSingleLayer(
+  adapter: ProviderAdapterV2Shape,
+): Layer.Layer<ProviderAdapterRegistryV2> {
+  return makeLayer([adapter]);
+}
+
+const decodedConfigEnabled = (config: unknown): boolean | undefined => {
+  if (!config || typeof config !== "object" || globalThis.Array.isArray(config)) {
+    return undefined;
+  }
+  const enabled = (config as { readonly enabled?: unknown }).enabled;
+  return typeof enabled === "boolean" ? enabled : undefined;
+};
+
+interface LiveAdapterEntry {
+  readonly adapter: ProviderAdapterV2Shape;
+  readonly scope: Scope.Closeable;
+  readonly entry: ProviderInstanceConfig;
+}
+
+function makeDriversById<R>(
+  drivers: ReadonlyArray<AnyProviderAdapterDriver<R>>,
+): ReadonlyMap<ProviderDriverKind, AnyProviderAdapterDriver<R>> {
+  return new Map<ProviderDriverKind, AnyProviderAdapterDriver<R>>(
+    drivers.map((driver) => [driver.driverKind, driver]),
+  );
+}
+
+const createAdapterEntryFromConfigEntry = Effect.fn(
+  "ProviderAdapterRegistry.createAdapterEntryFromConfigEntry",
+)(function* <R>(input: {
+  readonly driversById: ReadonlyMap<ProviderDriverKind, AnyProviderAdapterDriver<R>>;
+  readonly parentScope: Scope.Scope;
+  readonly instanceId: ProviderInstanceId;
+  readonly entry: ProviderInstanceConfig;
+}): Effect.fn.Return<LiveAdapterEntry, ProviderAdapterDriverCreateError, R> {
+  const driver = input.driversById.get(input.entry.driver);
+  if (driver === undefined) {
+    return yield* new ProviderAdapterDriverCreateError({
+      driver: input.entry.driver,
+      instanceId: input.instanceId,
+      detail: "Unknown provider driver.",
+    });
+  }
+
+  const decodeConfig = Schema.decodeUnknownEffect(driver.configSchema);
+  const typedConfig = yield* decodeConfig(input.entry.config ?? driver.defaultConfig()).pipe(
+    Effect.mapError(
+      (cause) =>
+        new ProviderAdapterDriverCreateError({
+          driver: input.entry.driver,
+          instanceId: input.instanceId,
+          detail: "Invalid provider instance config.",
+          cause,
+        }),
+    ),
+  );
+
+  const childScope = yield* Scope.make();
+  yield* Scope.addFinalizer(
+    input.parentScope,
+    Scope.close(childScope, Exit.void).pipe(Effect.ignore),
+  );
+
+  const adapter = yield* driver
+    .create({
+      instanceId: input.instanceId,
+      displayName: input.entry.displayName,
+      accentColor: input.entry.accentColor,
+      environment: input.entry.environment ?? [],
+      enabled: input.entry.enabled ?? decodedConfigEnabled(typedConfig) ?? true,
+      config: typedConfig,
+    })
+    .pipe(
+      Effect.provideService(Scope.Scope, childScope),
+      Effect.onError((cause) => Scope.close(childScope, Exit.failCause(cause))),
+    );
+
+  return {
+    adapter,
+    scope: childScope,
+    entry: input.entry,
+  };
+});
+
+const buildAdaptersFromConfigMap = Effect.fn("ProviderAdapterRegistry.buildAdaptersFromConfigMap")(
+  function* <R>(input: {
+    readonly drivers: ReadonlyArray<AnyProviderAdapterDriver<R>>;
+    readonly configMap: ProviderInstanceConfigMap;
+    readonly parentScope: Scope.Scope;
+  }): Effect.fn.Return<
+    ReadonlyMap<ProviderInstanceId, LiveAdapterEntry>,
+    ProviderAdapterRegistryBuildError,
+    R
+  > {
+    const driversById = makeDriversById(input.drivers);
+    const adapters = new Map<ProviderInstanceId, LiveAdapterEntry>();
+
+    for (const [rawInstanceId, entry] of Object.entries(input.configMap)) {
+      const instanceId = ProviderInstanceId.make(rawInstanceId);
+      if (!driversById.has(entry.driver)) {
+        yield* Effect.logWarning("Skipping orchestration-v2 provider adapter with unknown driver", {
+          instanceId,
+          driver: entry.driver,
+        });
+        continue;
+      }
+
+      const adapter = yield* createAdapterEntryFromConfigEntry({
+        driversById,
+        parentScope: input.parentScope,
+        instanceId,
+        entry,
+      });
+      adapters.set(instanceId, adapter);
+    }
+
+    return adapters;
+  },
+);
+
+export function makeRegistryFromConfigMap<R>(input: {
+  readonly drivers: ReadonlyArray<AnyProviderAdapterDriver<R>>;
+  readonly configMap: ProviderInstanceConfigMap;
+}): Effect.Effect<
+  ProviderAdapterRegistryV2Shape,
+  ProviderAdapterRegistryBuildError,
+  R | Scope.Scope
+> {
+  return Effect.gen(function* () {
+    const parentScope = yield* Effect.scope;
+    const entries = yield* buildAdaptersFromConfigMap({ ...input, parentScope });
+    return makeRegistry(Array.from(entries.values()).map((entry) => entry.adapter));
+  });
+}
+
+export function makeDriverLayer<R>(input: {
+  readonly drivers: ReadonlyArray<AnyProviderAdapterDriver<R>>;
+  readonly configMap: ProviderInstanceConfigMap;
+}): Layer.Layer<ProviderAdapterRegistryV2, ProviderAdapterRegistryBuildError, R> {
+  return Layer.effect(
+    ProviderAdapterRegistryV2,
+    makeRegistryFromConfigMap(input).pipe(
+      Effect.map((registry) => ProviderAdapterRegistryV2.of(registry)),
+    ),
+  ) as Layer.Layer<ProviderAdapterRegistryV2, ProviderAdapterRegistryBuildError, R>;
+}
+
+export const layerFromProviderAdapter: Layer.Layer<
+  ProviderAdapterRegistryV2,
+  never,
+  ProviderAdapterV2
+> = Layer.effect(
+  ProviderAdapterRegistryV2,
+  Effect.gen(function* () {
+    const adapter = yield* ProviderAdapterV2;
+    return ProviderAdapterRegistryV2.of({
+      get: (instanceId) =>
+        adapter.instanceId === instanceId
+          ? Effect.succeed(adapter)
+          : Effect.fail(new ProviderAdapterRegistryLookupError({ instanceId })),
+      list: () => Effect.succeed([adapter.instanceId]),
+    } satisfies ProviderAdapterRegistryV2Shape);
+  }),
+);
diff --git a/apps/server/src/orchestration-v2/ProviderContinuationRequests.ts b/apps/server/src/orchestration-v2/ProviderContinuationRequests.ts
new file mode 100644
index 000000000000..0e892ee666b5
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ProviderContinuationRequests.ts
@@ -0,0 +1,74 @@
+import {
+  MessageId,
+  ProviderDriverKind,
+  ProviderThreadId,
+  RunId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Queue from "effect/Queue";
+
+export interface ProviderContinuationRequest {
+  readonly threadId: ThreadId;
+  readonly providerThreadId: ProviderThreadId;
+  readonly driver: ProviderDriverKind;
+  readonly detail: string | null;
+  /**
+   * Durable ownership for an app-owned delegated-task completion delivery.
+   * The continuation worker re-reads the cohort before dispatching so a later
+   * task can join a queued wake and a stopped or acknowledged cohort is dropped.
+   */
+  readonly delegatedCompletion?: {
+    readonly parentRunId: RunId;
+    readonly generation: number;
+    readonly messageId: MessageId;
+  };
+  /**
+   * How the continuation turn gets its content.
+   *
+   * `adapter_buffered` (default) is the provider-native wake: the adapter has
+   * already buffered the CLI's wake output, and the dispatched message only
+   * triggers ingestion. `ClaudeAdapterV2` deliberately discards the message
+   * text on that path.
+   *
+   * `message_text` is for app-owned work with no buffered provider output, such
+   * as a delegated child finishing. The text is the entire wake, so it must
+   * reach the provider as a real prompt.
+   */
+  readonly delivery?: "adapter_buffered" | "message_text";
+  readonly dispatchIfCurrent?: <A, E, R>(
+    effect: Effect.Effect<A, E, R>,
+  ) => Effect.Effect<Option.Option<A>, E, R>;
+  /** Clears a pending offer that the continuation worker intentionally drops. */
+  readonly clearIfCurrent?: () => Effect.Effect<void>;
+}
+
+/**
+ * Adapters offer a continuation request when provider-native work completes
+ * outside an active turn (for example a Claude background task wake turn) so
+ * the orchestrator can start a run that ingests it. The default reference
+ * drops requests, keeping adapter construction dependency-free in tests; the
+ * live layer must be shared with the ProviderContinuationService worker that
+ * drains it.
+ */
+export class ProviderContinuationRequests extends Context.Reference<{
+  readonly offer: (request: ProviderContinuationRequest) => Effect.Effect<void>;
+  readonly take: Effect.Effect<ProviderContinuationRequest>;
+}>("t3/orchestration-v2/ProviderContinuationRequests", {
+  defaultValue: () => ({ offer: () => Effect.void, take: Effect.never }),
+}) {}
+
+export const layer = Layer.effect(
+  ProviderContinuationRequests,
+  Effect.gen(function* () {
+    const queue = yield* Queue.unbounded<ProviderContinuationRequest>();
+    return {
+      offer: (request: ProviderContinuationRequest) =>
+        Queue.offer(queue, request).pipe(Effect.asVoid),
+      take: Queue.take(queue),
+    };
+  }),
+);
diff --git a/apps/server/src/orchestration-v2/ProviderContinuationService.test.ts b/apps/server/src/orchestration-v2/ProviderContinuationService.test.ts
new file mode 100644
index 000000000000..03d218289502
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ProviderContinuationService.test.ts
@@ -0,0 +1,735 @@
+import { assert, describe, it } from "@effect/vitest";
+import {
+  MessageId,
+  ProviderDriverKind,
+  ProviderThreadId,
+  RunId,
+  ThreadId,
+  type OrchestrationV2ThreadProjection,
+} from "@t3tools/contracts";
+import * as Deferred from "effect/Deferred";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Queue from "effect/Queue";
+import * as Ref from "effect/Ref";
+import * as Semaphore from "effect/Semaphore";
+import * as TestClock from "effect/testing/TestClock";
+
+import { layer as idAllocatorLayer } from "./IdAllocator.ts";
+import {
+  type ProviderContinuationRequest,
+  ProviderContinuationRequests,
+  layer as continuationRequestsLayer,
+} from "./ProviderContinuationRequests.ts";
+import { workerLive } from "./ProviderContinuationService.ts";
+import { ThreadManagementService } from "./ThreadManagementService.ts";
+
+const threadId = ThreadId.make("thread-provider-continuation");
+const providerThreadId = ProviderThreadId.make("provider-thread-continuation");
+const driver = ProviderDriverKind.make("continuation-test");
+const parentRunId = RunId.make("run-provider-continuation-parent");
+const delegatedMessageId = MessageId.make("message-provider-continuation-delegated");
+const projection = {
+  thread: { archivedAt: null, deletedAt: null },
+  messages: [],
+} as unknown as OrchestrationV2ThreadProjection;
+
+const request = (
+  dispatchIfCurrent?: ProviderContinuationRequest["dispatchIfCurrent"],
+  detail: string | null = null,
+): ProviderContinuationRequest => ({
+  threadId,
+  providerThreadId,
+  driver,
+  detail,
+  ...(dispatchIfCurrent === undefined ? {} : { dispatchIfCurrent }),
+});
+
+const delegatedProjection = (disposition: "open" | "stopped" | "disposed" = "open") =>
+  ({
+    ...projection,
+    runs: [
+      {
+        id: parentRunId,
+        delegatedCompletion: {
+          disposition,
+          nextGeneration: 2,
+          delivery: {
+            generation: 1,
+            messageId: delegatedMessageId,
+            taskIds: ["node-provider-continuation-first", "node-provider-continuation-second"],
+          },
+        },
+      },
+    ],
+  }) as unknown as OrchestrationV2ThreadProjection;
+
+const makeGuard = Effect.fnUntraced(function* (completed?: Deferred.Deferred<void>) {
+  const generation = yield* Ref.make(0);
+  const permit = yield* Semaphore.make(1);
+  const capture = Effect.gen(function* () {
+    const captured = yield* Ref.updateAndGet(generation, (value) => value + 1);
+    return <A, E, R>(effect: Effect.Effect<A, E, R>) =>
+      permit
+        .withPermit(
+          Effect.gen(function* () {
+            if ((yield* Ref.get(generation)) !== captured) return Option.none();
+            return Option.some(yield* effect);
+          }),
+        )
+        .pipe(
+          completed === undefined
+            ? (effect) => effect
+            : Effect.ensuring(Deferred.succeed(completed, undefined)),
+        );
+  });
+  return {
+    capture,
+    invalidate: permit.withPermit(Ref.update(generation, (value) => value + 1)),
+  };
+});
+
+function testLayer(input: {
+  readonly dispatched: Queue.Queue<unknown>;
+  readonly getThreadProjection: () => Effect.Effect<OrchestrationV2ThreadProjection>;
+}) {
+  const threads = Layer.mock(ThreadManagementService)({
+    getThreadProjection: input.getThreadProjection,
+    dispatch: (command) => Queue.offer(input.dispatched, command).pipe(Effect.as({} as never)),
+  });
+  const worker = workerLive.pipe(
+    Layer.provide(Layer.mergeAll(idAllocatorLayer, continuationRequestsLayer, threads)),
+  );
+  return Layer.merge(continuationRequestsLayer, worker);
+}
+
+describe("ProviderContinuationService", () => {
+  it.effect("marks an adapter-buffered wake with the provider creation source", () => {
+    return Effect.gen(function* () {
+      const dispatched = yield* Queue.unbounded<unknown>();
+      yield* Effect.gen(function* () {
+        const requests = yield* ProviderContinuationRequests;
+        yield* requests.offer(request());
+        const command = (yield* Queue.take(dispatched)) as { readonly creationSource: string };
+        // ClaudeAdapterV2 keys on this to attach buffered CLI output.
+        assert.equal(command.creationSource, "provider");
+      }).pipe(
+        Effect.provide(
+          testLayer({ dispatched, getThreadProjection: () => Effect.succeed(projection) }),
+        ),
+        Effect.scoped,
+      );
+    });
+  });
+
+  it.effect("delivers a message_text wake as a real prompt, not a buffered wake", () => {
+    return Effect.gen(function* () {
+      const dispatched = yield* Queue.unbounded<unknown>();
+      yield* Effect.gen(function* () {
+        const requests = yield* ProviderContinuationRequests;
+        yield* requests.offer({
+          threadId,
+          providerThreadId,
+          driver,
+          detail: "Delegated task completed.",
+          delivery: "message_text",
+        });
+        const command = (yield* Queue.take(dispatched)) as {
+          readonly creationSource: string;
+          readonly text: string;
+        };
+        // An app-owned child buffers nothing in the adapter, so this text is
+        // the whole wake. Marking it "provider" would make ClaudeAdapterV2
+        // drop it and settle the turn having prompted nothing.
+        assert.notEqual(command.creationSource, "provider");
+        assert.equal(command.creationSource, "server");
+        assert.equal(command.text, "Delegated task completed.");
+      }).pipe(
+        Effect.provide(
+          testLayer({ dispatched, getThreadProjection: () => Effect.succeed(projection) }),
+        ),
+        Effect.scoped,
+      );
+    });
+  });
+
+  it.effect("dispatches a current delegated completion as one server-owned queued message", () => {
+    return Effect.gen(function* () {
+      const dispatched = yield* Queue.unbounded<unknown>();
+      yield* Effect.gen(function* () {
+        const requests = yield* ProviderContinuationRequests;
+        yield* requests.offer({
+          threadId,
+          providerThreadId,
+          driver,
+          detail: null,
+          delivery: "message_text",
+          delegatedCompletion: {
+            parentRunId,
+            generation: 1,
+            messageId: delegatedMessageId,
+          },
+        });
+        const command = (yield* Queue.take(dispatched)) as {
+          readonly createdBy: string;
+          readonly creationSource: string;
+          readonly delegatedCompletion: {
+            readonly generation: number;
+            readonly parentRunId: RunId;
+            readonly taskIds: ReadonlyArray<string>;
+          };
+          readonly dispatchMode: { readonly type: string };
+          readonly messageId: MessageId;
+          readonly text: string;
+        };
+        assert.equal(command.createdBy, "agent");
+        assert.equal(command.creationSource, "server");
+        assert.deepEqual(command.dispatchMode, { type: "queue_after_active" });
+        assert.equal(command.messageId, delegatedMessageId);
+        assert.equal(command.delegatedCompletion.parentRunId, parentRunId);
+        assert.equal(command.delegatedCompletion.generation, 1);
+        assert.deepEqual(command.delegatedCompletion.taskIds, [
+          "node-provider-continuation-first",
+          "node-provider-continuation-second",
+        ]);
+        assert.include(command.text, "task_status");
+      }).pipe(
+        Effect.provide(
+          testLayer({
+            dispatched,
+            getThreadProjection: () => Effect.succeed(delegatedProjection()),
+          }),
+        ),
+        Effect.scoped,
+      );
+    });
+  });
+
+  it.effect("retries a delegated completion after a transient dispatch failure", () => {
+    return Effect.gen(function* () {
+      const attempts = yield* Ref.make(0);
+      const dispatched = yield* Queue.unbounded<unknown>();
+      const threads = Layer.mock(ThreadManagementService)({
+        getThreadProjection: () => Effect.succeed(delegatedProjection()),
+        dispatch: (command) =>
+          Ref.getAndUpdate(attempts, (count) => count + 1).pipe(
+            Effect.flatMap((attempt) =>
+              attempt === 0
+                ? Effect.fail(new Error("simulated transient dispatch failure") as never)
+                : Queue.offer(dispatched, command).pipe(Effect.as({} as never)),
+            ),
+          ),
+      });
+      const worker = workerLive.pipe(
+        Layer.provide(Layer.mergeAll(idAllocatorLayer, continuationRequestsLayer, threads)),
+      );
+
+      yield* Effect.gen(function* () {
+        const requests = yield* ProviderContinuationRequests;
+        yield* requests.offer({
+          threadId,
+          providerThreadId,
+          driver,
+          detail: null,
+          delivery: "message_text",
+          delegatedCompletion: {
+            parentRunId,
+            generation: 1,
+            messageId: delegatedMessageId,
+          },
+        });
+        yield* Effect.yieldNow;
+        assert.equal(yield* Ref.get(attempts), 1);
+        assert.isTrue(Option.isNone(yield* Queue.poll(dispatched)));
+
+        yield* TestClock.adjust("100 millis");
+        const command = (yield* Queue.take(dispatched)) as {
+          readonly messageId: MessageId;
+        };
+        assert.equal(command.messageId, delegatedMessageId);
+        assert.equal(yield* Ref.get(attempts), 2);
+      }).pipe(Effect.provide(Layer.merge(continuationRequestsLayer, worker)), Effect.scoped);
+    });
+  });
+
+  it.effect("backs off repeated delegated completion dispatch failures", () => {
+    return Effect.gen(function* () {
+      const attempts = yield* Ref.make(0);
+      const disposition = yield* Ref.make<"open" | "disposed">("open");
+      const threads = Layer.mock(ThreadManagementService)({
+        getThreadProjection: () =>
+          Ref.get(disposition).pipe(Effect.map((state) => delegatedProjection(state))),
+        dispatch: () =>
+          Ref.update(attempts, (count) => count + 1).pipe(
+            Effect.andThen(Effect.fail(new Error("simulated persistent failure") as never)),
+          ),
+      });
+      const worker = workerLive.pipe(
+        Layer.provide(Layer.mergeAll(idAllocatorLayer, continuationRequestsLayer, threads)),
+      );
+
+      yield* Effect.gen(function* () {
+        const requests = yield* ProviderContinuationRequests;
+        yield* requests.offer({
+          threadId,
+          providerThreadId,
+          driver,
+          detail: null,
+          delivery: "message_text",
+          delegatedCompletion: {
+            parentRunId,
+            generation: 1,
+            messageId: delegatedMessageId,
+          },
+        });
+        yield* Effect.yieldNow;
+        assert.equal(yield* Ref.get(attempts), 1);
+
+        yield* TestClock.adjust("100 millis");
+        yield* Effect.yieldNow;
+        assert.equal(yield* Ref.get(attempts), 2);
+        yield* TestClock.adjust("199 millis");
+        yield* Effect.yieldNow;
+        assert.equal(yield* Ref.get(attempts), 2);
+        yield* TestClock.adjust("1 millis");
+        yield* Effect.yieldNow;
+        assert.equal(yield* Ref.get(attempts), 3);
+
+        yield* Ref.set(disposition, "disposed");
+        yield* TestClock.adjust("400 millis");
+      }).pipe(Effect.provide(Layer.merge(continuationRequestsLayer, worker)), Effect.scoped);
+    });
+  });
+
+  it.effect("resets delegated completion retry backoff after archive or deletion", () => {
+    return Effect.gen(function* () {
+      for (const barrier of ["archivedAt", "deletedAt"] as const) {
+        const attempts = yield* Ref.make(0);
+        const blockedProjectionReads = yield* Ref.make(0);
+        const blockedRequestDropped = yield* Deferred.make<void>();
+        const state = yield* Ref.make<"open" | "blocked" | "disposed">("open");
+        const threads = Layer.mock(ThreadManagementService)({
+          getThreadProjection: () =>
+            Effect.gen(function* () {
+              const currentState = yield* Ref.get(state);
+              if (currentState === "blocked") {
+                const reads = yield* Ref.updateAndGet(blockedProjectionReads, (count) => count + 1);
+                if (reads === 2) {
+                  yield* Deferred.succeed(blockedRequestDropped, undefined);
+                }
+              }
+              return {
+                ...delegatedProjection(currentState === "disposed" ? "disposed" : "open"),
+                thread: {
+                  ...projection.thread,
+                  [barrier]:
+                    currentState === "blocked"
+                      ? DateTime.makeUnsafe("2026-08-05T00:00:00.000Z")
+                      : null,
+                },
+              };
+            }),
+          dispatch: () =>
+            Ref.update(attempts, (count) => count + 1).pipe(
+              Effect.andThen(Effect.fail(new Error("simulated persistent failure") as never)),
+            ),
+        });
+        const worker = workerLive.pipe(
+          Layer.provide(Layer.mergeAll(idAllocatorLayer, continuationRequestsLayer, threads)),
+        );
+        const completionRequest = {
+          threadId,
+          providerThreadId,
+          driver,
+          detail: null,
+          delivery: "message_text" as const,
+          delegatedCompletion: {
+            parentRunId,
+            generation: 1,
+            messageId: delegatedMessageId,
+          },
+        };
+
+        yield* Effect.gen(function* () {
+          const requests = yield* ProviderContinuationRequests;
+          yield* requests.offer(completionRequest);
+          yield* Effect.yieldNow;
+          assert.equal(yield* Ref.get(attempts), 1);
+
+          yield* Ref.set(state, "blocked");
+          yield* TestClock.adjust("100 millis");
+          yield* Deferred.await(blockedRequestDropped);
+          yield* Effect.yieldNow;
+          assert.equal(yield* Ref.get(attempts), 1);
+
+          yield* Ref.set(state, "open");
+          yield* requests.offer(completionRequest);
+          yield* Effect.yieldNow;
+          assert.equal(yield* Ref.get(attempts), 2);
+          yield* TestClock.adjust("99 millis");
+          yield* Effect.yieldNow;
+          assert.equal(yield* Ref.get(attempts), 2);
+          yield* TestClock.adjust("1 millis");
+          yield* Effect.yieldNow;
+          assert.equal(yield* Ref.get(attempts), 3);
+
+          yield* Ref.set(state, "disposed");
+          yield* TestClock.adjust("200 millis");
+        }).pipe(Effect.provide(Layer.merge(continuationRequestsLayer, worker)), Effect.scoped);
+      }
+    });
+  });
+
+  it.effect("drops a delegated completion retry after its delivery closes", () => {
+    return Effect.gen(function* () {
+      const attempts = yield* Ref.make(0);
+      const disposition = yield* Ref.make<"open" | "disposed">("open");
+      const threads = Layer.mock(ThreadManagementService)({
+        getThreadProjection: () =>
+          Ref.get(disposition).pipe(Effect.map((state) => delegatedProjection(state))),
+        dispatch: () =>
+          Ref.update(attempts, (count) => count + 1).pipe(
+            Effect.andThen(Effect.fail(new Error("simulated dispatch failure") as never)),
+          ),
+      });
+      const worker = workerLive.pipe(
+        Layer.provide(Layer.mergeAll(idAllocatorLayer, continuationRequestsLayer, threads)),
+      );
+
+      yield* Effect.gen(function* () {
+        const requests = yield* ProviderContinuationRequests;
+        yield* requests.offer({
+          threadId,
+          providerThreadId,
+          driver,
+          detail: null,
+          delivery: "message_text",
+          delegatedCompletion: {
+            parentRunId,
+            generation: 1,
+            messageId: delegatedMessageId,
+          },
+        });
+        yield* Effect.yieldNow;
+        assert.equal(yield* Ref.get(attempts), 1);
+
+        yield* Ref.set(disposition, "disposed");
+        yield* TestClock.adjust("100 millis");
+        yield* Effect.yieldNow;
+        assert.equal(yield* Ref.get(attempts), 1);
+      }).pipe(Effect.provide(Layer.merge(continuationRequestsLayer, worker)), Effect.scoped);
+    });
+  });
+
+  it.effect("keeps a Grok delegated completion queued instead of restarting active work", () => {
+    return Effect.gen(function* () {
+      const dispatched = yield* Queue.unbounded<unknown>();
+      yield* Effect.gen(function* () {
+        const requests = yield* ProviderContinuationRequests;
+        yield* requests.offer({
+          threadId,
+          providerThreadId,
+          driver: ProviderDriverKind.make("grok"),
+          detail: null,
+          delivery: "message_text",
+          delegatedCompletion: {
+            parentRunId,
+            generation: 1,
+            messageId: delegatedMessageId,
+          },
+        });
+        const command = (yield* Queue.take(dispatched)) as {
+          readonly dispatchMode: { readonly type: string };
+        };
+        assert.deepEqual(command.dispatchMode, { type: "queue_after_active" });
+      }).pipe(
+        Effect.provide(
+          testLayer({
+            dispatched,
+            getThreadProjection: () => Effect.succeed(delegatedProjection()),
+          }),
+        ),
+        Effect.scoped,
+      );
+    });
+  });
+
+  it.effect(
+    "drops stopped and disposed delegated completions instead of reviving them after recovery",
+    () => {
+      return Effect.gen(function* () {
+        for (const disposition of ["stopped", "disposed"] as const) {
+          const dispatched = yield* Queue.unbounded<unknown>();
+          yield* Effect.gen(function* () {
+            const requests = yield* ProviderContinuationRequests;
+            yield* requests.offer({
+              threadId,
+              providerThreadId,
+              driver,
+              detail: null,
+              delivery: "message_text",
+              delegatedCompletion: {
+                parentRunId,
+                generation: 1,
+                messageId: delegatedMessageId,
+              },
+            });
+            yield* Effect.yieldNow;
+            yield* Effect.yieldNow;
+            assert.isTrue(Option.isNone(yield* Queue.poll(dispatched)));
+          }).pipe(
+            Effect.provide(
+              testLayer({
+                dispatched,
+                getThreadProjection: () => Effect.succeed(delegatedProjection(disposition)),
+              }),
+            ),
+            Effect.scoped,
+          );
+        }
+      });
+    },
+  );
+
+  it.effect("does not redispatch a persisted delegated completion message during recovery", () => {
+    return Effect.gen(function* () {
+      const dispatched = yield* Queue.unbounded<unknown>();
+      yield* Effect.gen(function* () {
+        const requests = yield* ProviderContinuationRequests;
+        yield* requests.offer({
+          threadId,
+          providerThreadId,
+          driver,
+          detail: null,
+          delivery: "message_text",
+          delegatedCompletion: {
+            parentRunId,
+            generation: 1,
+            messageId: delegatedMessageId,
+          },
+        });
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+        assert.isTrue(Option.isNone(yield* Queue.poll(dispatched)));
+      }).pipe(
+        Effect.provide(
+          testLayer({
+            dispatched,
+            getThreadProjection: () =>
+              Effect.succeed({
+                ...delegatedProjection(),
+                messages: [{ id: delegatedMessageId }],
+              } as unknown as OrchestrationV2ThreadProjection),
+          }),
+        ),
+        Effect.scoped,
+      );
+    });
+  });
+
+  it.effect("drops archived and deleted delegated completions during recovery", () => {
+    return Effect.gen(function* () {
+      for (const barrier of ["archivedAt", "deletedAt"] as const) {
+        const dispatched = yield* Queue.unbounded<unknown>();
+        yield* Effect.gen(function* () {
+          const requests = yield* ProviderContinuationRequests;
+          yield* requests.offer({
+            threadId,
+            providerThreadId,
+            driver,
+            detail: null,
+            delivery: "message_text",
+            delegatedCompletion: {
+              parentRunId,
+              generation: 1,
+              messageId: delegatedMessageId,
+            },
+          });
+          yield* Effect.yieldNow;
+          yield* Effect.yieldNow;
+          assert.isTrue(Option.isNone(yield* Queue.poll(dispatched)));
+        }).pipe(
+          Effect.provide(
+            testLayer({
+              dispatched,
+              getThreadProjection: () =>
+                Effect.succeed({
+                  ...delegatedProjection(),
+                  thread: {
+                    ...projection.thread,
+                    [barrier]: DateTime.makeUnsafe("2026-08-03T00:00:00.000Z"),
+                  },
+                } as unknown as OrchestrationV2ThreadProjection),
+            }),
+          ),
+          Effect.scoped,
+        );
+      }
+    });
+  });
+
+  it.effect("dispatches a current request exactly once", () => {
+    return Effect.gen(function* () {
+      const dispatched = yield* Queue.unbounded<unknown>();
+      yield* Effect.gen(function* () {
+        const requests = yield* ProviderContinuationRequests;
+        yield* requests.offer(request());
+        yield* Queue.take(dispatched);
+        yield* Effect.yieldNow;
+        assert.isTrue(Option.isNone(yield* Queue.poll(dispatched)));
+      }).pipe(
+        Effect.provide(
+          testLayer({ dispatched, getThreadProjection: () => Effect.succeed(projection) }),
+        ),
+        Effect.scoped,
+      );
+    });
+  });
+
+  it.effect("queues a continuation behind an active user run", () => {
+    return Effect.gen(function* () {
+      const dispatched = yield* Queue.unbounded<unknown>();
+      yield* Effect.gen(function* () {
+        const requests = yield* ProviderContinuationRequests;
+        yield* requests.offer(request());
+        const command = yield* Queue.take(dispatched);
+        assert.deepEqual((command as { readonly dispatchMode?: unknown }).dispatchMode, {
+          type: "queue_after_active",
+        });
+      }).pipe(
+        Effect.provide(
+          testLayer({ dispatched, getThreadProjection: () => Effect.succeed(projection) }),
+        ),
+        Effect.scoped,
+      );
+    });
+  });
+
+  it.effect("drops a request invalidated before dispatch", () => {
+    return Effect.gen(function* () {
+      const dispatched = yield* Queue.unbounded<unknown>();
+      yield* Effect.gen(function* () {
+        const requests = yield* ProviderContinuationRequests;
+        const guard = yield* makeGuard();
+        const dispatchIfCurrent = yield* guard.capture;
+        yield* guard.invalidate;
+        yield* requests.offer(request(dispatchIfCurrent));
+        yield* Effect.yieldNow;
+        yield* Effect.yieldNow;
+        assert.isTrue(Option.isNone(yield* Queue.poll(dispatched)));
+      }).pipe(
+        Effect.provide(
+          testLayer({ dispatched, getThreadProjection: () => Effect.succeed(projection) }),
+        ),
+        Effect.scoped,
+      );
+    });
+  });
+
+  it.effect("drops a request invalidated while projection is blocked", () => {
+    return Effect.gen(function* () {
+      const dispatched = yield* Queue.unbounded<unknown>();
+      const projectionEntered = yield* Deferred.make<void>();
+      const releaseProjection = yield* Deferred.make<void>();
+      const guardCompleted = yield* Deferred.make<void>();
+      yield* Effect.gen(function* () {
+        const requests = yield* ProviderContinuationRequests;
+        const guard = yield* makeGuard(guardCompleted);
+        const dispatchIfCurrent = yield* guard.capture;
+        yield* requests.offer(request(dispatchIfCurrent));
+        yield* Deferred.await(projectionEntered);
+        yield* guard.invalidate;
+        yield* Deferred.succeed(releaseProjection, undefined);
+        yield* Deferred.await(guardCompleted);
+        assert.isTrue(Option.isNone(yield* Queue.poll(dispatched)));
+      }).pipe(
+        Effect.provide(
+          testLayer({
+            dispatched,
+            getThreadProjection: () =>
+              Deferred.succeed(projectionEntered, undefined).pipe(
+                Effect.andThen(Deferred.await(releaseProjection)),
+                Effect.as(projection),
+              ),
+          }),
+        ),
+        Effect.scoped,
+      );
+    });
+  });
+
+  it.effect("does not revive an old request when a later generation is current", () => {
+    return Effect.gen(function* () {
+      const dispatched = yield* Queue.unbounded<unknown>();
+      const firstProjectionEntered = yield* Deferred.make<void>();
+      const releaseFirstProjection = yield* Deferred.make<void>();
+      let projectionCalls = 0;
+      yield* Effect.gen(function* () {
+        const requests = yield* ProviderContinuationRequests;
+        const guard = yield* makeGuard();
+        const first = yield* guard.capture;
+        yield* requests.offer(request(first, "A"));
+        yield* Deferred.await(firstProjectionEntered);
+        const second = yield* guard.capture;
+        yield* requests.offer(request(second, "B"));
+        yield* Deferred.succeed(releaseFirstProjection, undefined);
+        const command = yield* Queue.take(dispatched);
+        assert.equal((command as { readonly text?: unknown }).text, "B");
+        yield* Effect.yieldNow;
+        assert.isTrue(Option.isNone(yield* Queue.poll(dispatched)));
+      }).pipe(
+        Effect.provide(
+          testLayer({
+            dispatched,
+            getThreadProjection: () => {
+              projectionCalls += 1;
+              return projectionCalls === 1
+                ? Deferred.succeed(firstProjectionEntered, undefined).pipe(
+                    Effect.andThen(Deferred.await(releaseFirstProjection)),
+                    Effect.as(projection),
+                  )
+                : Effect.succeed(projection);
+            },
+          }),
+        ),
+        Effect.scoped,
+      );
+    });
+  });
+
+  it.effect("clears a sticky continuation offer when its thread is archived", () => {
+    return Effect.gen(function* () {
+      const dispatched = yield* Queue.unbounded<unknown>();
+      const cleared = yield* Ref.make(false);
+      yield* Effect.gen(function* () {
+        const requests = yield* ProviderContinuationRequests;
+        yield* requests.offer({
+          ...request(),
+          clearIfCurrent: () => Ref.set(cleared, true),
+        });
+        for (let attempt = 0; attempt < 20 && !(yield* Ref.get(cleared)); attempt += 1) {
+          yield* Effect.yieldNow;
+        }
+        assert.isTrue(yield* Ref.get(cleared));
+        assert.isTrue(Option.isNone(yield* Queue.poll(dispatched)));
+      }).pipe(
+        Effect.provide(
+          testLayer({
+            dispatched,
+            getThreadProjection: () =>
+              Effect.succeed({
+                ...projection,
+                thread: {
+                  ...projection.thread,
+                  archivedAt: DateTime.makeUnsafe("2026-07-20T00:00:00.000Z"),
+                },
+              }),
+          }),
+        ),
+        Effect.scoped,
+      );
+    });
+  });
+});
diff --git a/apps/server/src/orchestration-v2/ProviderContinuationService.ts b/apps/server/src/orchestration-v2/ProviderContinuationService.ts
new file mode 100644
index 000000000000..2ea80a34db32
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ProviderContinuationService.ts
@@ -0,0 +1,208 @@
+import { CommandId, type OrchestrationV2ThreadProjection } from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Ref from "effect/Ref";
+
+import { IdAllocatorV2 } from "./IdAllocator.ts";
+import {
+  type ProviderContinuationRequest,
+  ProviderContinuationRequests,
+} from "./ProviderContinuationRequests.ts";
+import { ThreadManagementService } from "./ThreadManagementService.ts";
+
+const CONTINUATION_MESSAGE_TEXT = "Background task completed.";
+
+function delegatedCompletionText(taskIds: ReadonlyArray<string>): string {
+  const taskList = taskIds.join(", ");
+  return taskIds.length === 1
+    ? `Delegated task ${taskList} reached a terminal state. Use task_status with taskId ${taskList} to read the result.`
+    : `Delegated tasks ${taskList} reached terminal states. Use task_status with each taskId to read the results.`;
+}
+
+function currentDelegatedCompletionDelivery(
+  projection: OrchestrationV2ThreadProjection,
+  completion: NonNullable<ProviderContinuationRequest["delegatedCompletion"]>,
+) {
+  const sourceRun = projection.runs.find((candidate) => candidate.id === completion.parentRunId);
+  const delivery = sourceRun?.delegatedCompletion?.delivery;
+  const alreadyDispatched = projection.messages.some(
+    (message) => message.id === completion.messageId,
+  );
+  if (
+    sourceRun?.delegatedCompletion?.disposition !== "open" ||
+    delivery === null ||
+    delivery === undefined ||
+    delivery.generation !== completion.generation ||
+    delivery.messageId !== completion.messageId ||
+    alreadyDispatched
+  ) {
+    return undefined;
+  }
+  return delivery;
+}
+
+function delegatedCompletionRetryKey(
+  request: ProviderContinuationRequest,
+  completion: NonNullable<ProviderContinuationRequest["delegatedCompletion"]>,
+): string {
+  return `${request.threadId}:${completion.parentRunId}:${completion.generation}:${completion.messageId}`;
+}
+
+/**
+ * Drains ProviderContinuationRequests and dispatches an internal
+ * message.dispatch per request so the wake turn buffered by the adapter is
+ * ingested as a normal run. Dispatches queue_after_active, so a continuation
+ * racing a user run simply queues behind it and drains the wake buffer once
+ * that run finishes.
+ */
+export const workerLive = Layer.effectDiscard(
+  Effect.gen(function* () {
+    const ids = yield* IdAllocatorV2;
+    const requests = yield* ProviderContinuationRequests;
+    const threads = yield* ThreadManagementService;
+    const retryAttempts = yield* Ref.make(new Map<string, number>());
+
+    const clearRetryAttempt = (key: string) =>
+      Ref.update(retryAttempts, (current) => {
+        if (!current.has(key)) return current;
+        const updated = new Map(current);
+        updated.delete(key);
+        return updated;
+      });
+
+    const nextRetryDelay = (key: string) =>
+      Ref.modify(retryAttempts, (current) => {
+        const attempt = current.get(key) ?? 0;
+        const updated = new Map(current);
+        updated.set(key, attempt + 1);
+        return [Math.min(100 * 2 ** Math.min(attempt, 6), 5_000), updated] as const;
+      });
+
+    const dispatchContinuation = Effect.fn("ProviderContinuationService.dispatchContinuation")(
+      function* (request: ProviderContinuationRequest) {
+        const projection = yield* threads.getThreadProjection(request.threadId);
+        if (projection.thread.archivedAt !== null || projection.thread.deletedAt !== null) {
+          yield* Effect.logInfo("orchestration-v2.provider-continuation.thread-archived", {
+            threadId: request.threadId,
+            providerThreadId: request.providerThreadId,
+          });
+          if (request.delegatedCompletion !== undefined) {
+            yield* clearRetryAttempt(
+              delegatedCompletionRetryKey(request, request.delegatedCompletion),
+            );
+          }
+          // No continuation turn will start to clear the adapter's sticky offer.
+          if (request.clearIfCurrent !== undefined) {
+            yield* request.clearIfCurrent();
+          } else if (request.dispatchIfCurrent !== undefined) {
+            // Backward compatibility for request producers without an explicit
+            // drop callback.
+            yield* request.dispatchIfCurrent(Effect.void);
+          }
+          return;
+        }
+        if (request.delegatedCompletion !== undefined) {
+          const retryKey = delegatedCompletionRetryKey(request, request.delegatedCompletion);
+          const delivery = currentDelegatedCompletionDelivery(
+            projection,
+            request.delegatedCompletion,
+          );
+          if (delivery === undefined) {
+            yield* clearRetryAttempt(retryKey);
+            return;
+          }
+          const commandId = yield* ids.allocate.command({
+            fixtureName: "delegated-completion",
+            commandName: "dispatch",
+          });
+          yield* threads.dispatch({
+            type: "message.dispatch",
+            commandId,
+            threadId: request.threadId,
+            messageId: delivery.messageId,
+            text: delegatedCompletionText(delivery.taskIds),
+            attachments: [],
+            dispatchMode: { type: "queue_after_active" },
+            createdBy: "agent",
+            creationSource: "server",
+            delegatedCompletion: {
+              parentRunId: request.delegatedCompletion.parentRunId,
+              generation: delivery.generation,
+              taskIds: delivery.taskIds,
+            },
+          });
+          yield* clearRetryAttempt(retryKey);
+          return;
+        }
+        // The ordinal is display metadata only: allocate.message appends a
+        // random UUID, so a stale projection read here cannot collide ids.
+        const messageId = yield* ids.allocate.message({
+          threadId: request.threadId,
+          ordinal: projection.messages.length + 1,
+        });
+        const commandId = CommandId.make(`provider-continuation:${messageId}`);
+        const dispatch = threads.dispatch({
+          type: "message.dispatch",
+          commandId,
+          threadId: request.threadId,
+          messageId,
+          text: request.detail ?? CONTINUATION_MESSAGE_TEXT,
+          attachments: [],
+          dispatchMode: { type: "queue_after_active" },
+          createdBy: "agent",
+          // "provider" marks an adapter-buffered wake, which ClaudeAdapterV2
+          // detects to attach the buffered CLI output and drop this text. A
+          // message_text wake has no buffered output, so it must not carry that
+          // marker or the turn settles immediately having prompted nothing.
+          creationSource: request.delivery === "message_text" ? "server" : "provider",
+        });
+        if (request.dispatchIfCurrent === undefined) {
+          yield* dispatch;
+          return;
+        }
+        yield* request.dispatchIfCurrent(dispatch);
+      },
+    );
+
+    yield* requests.take.pipe(
+      Effect.flatMap((request) =>
+        dispatchContinuation(request).pipe(
+          Effect.catchCause((cause) =>
+            Effect.gen(function* () {
+              yield* Effect.logWarning("orchestration-v2.provider-continuation.dispatch-failed", {
+                threadId: request.threadId,
+                providerThreadId: request.providerThreadId,
+                cause,
+              });
+              if (request.delegatedCompletion !== undefined) {
+                const completion = request.delegatedCompletion;
+                const retryKey = delegatedCompletionRetryKey(request, completion);
+                const retryDelay = yield* nextRetryDelay(retryKey);
+                yield* Effect.gen(function* () {
+                  yield* Effect.sleep(`${retryDelay} millis`);
+                  const projection = yield* threads.getThreadProjection(request.threadId);
+                  if (currentDelegatedCompletionDelivery(projection, completion) !== undefined) {
+                    yield* requests.offer(request);
+                  } else {
+                    yield* clearRetryAttempt(retryKey);
+                  }
+                }).pipe(
+                  Effect.catchCause((retryCause) =>
+                    Effect.logWarning("orchestration-v2.provider-continuation.retry-check-failed", {
+                      threadId: request.threadId,
+                      providerThreadId: request.providerThreadId,
+                      cause: retryCause,
+                    }).pipe(Effect.andThen(requests.offer(request))),
+                  ),
+                  Effect.forkScoped,
+                );
+              }
+            }),
+          ),
+        ),
+      ),
+      Effect.forever,
+      Effect.forkScoped,
+    );
+  }),
+);
diff --git a/apps/server/src/orchestration-v2/ProviderEventIngestor.test.ts b/apps/server/src/orchestration-v2/ProviderEventIngestor.test.ts
new file mode 100644
index 000000000000..463dd01d1d2a
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ProviderEventIngestor.test.ts
@@ -0,0 +1,654 @@
+import { assert, it } from "@effect/vitest";
+import {
+  MessageId,
+  type ModelSelection,
+  NodeId,
+  type OrchestrationV2AppThread,
+  type OrchestrationV2DomainEvent,
+  type OrchestrationV2ProviderThread,
+  type OrchestrationV2Run,
+  type OrchestrationV2TurnItem,
+  ProviderDriverKind,
+  ProviderInstanceId,
+  RunAttemptId,
+  RunId,
+  TurnItemId,
+} from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Stream from "effect/Stream";
+
+import { SqlitePersistenceMemory } from "../persistence/Layers/Sqlite.ts";
+import { EventSinkV2, layer as eventSinkLayer } from "./EventSink.ts";
+import { EventStoreV2, layer as eventStoreLayer } from "./EventStore.ts";
+import {
+  IdAllocatorV2,
+  type IdAllocatorV2Error,
+  layer as idAllocatorLayer,
+} from "./IdAllocator.ts";
+import { ProjectionStoreV2, layer as projectionStoreLayer } from "./ProjectionStore.ts";
+import {
+  ProviderEventIngestorV2,
+  layer as providerEventIngestorLayer,
+} from "./ProviderEventIngestor.ts";
+import { makeProviderFailure } from "./ProviderFailure.ts";
+import {
+  makeProviderEventRoutingState,
+  type ProviderEventRouteIdentity,
+  routeProviderEvent,
+  selectInheritedBackgroundTurnItems,
+} from "./RunExecutionService.ts";
+
+const TestDatabaseLayer = SqlitePersistenceMemory;
+const TestStoresLayer = Layer.merge(eventStoreLayer, projectionStoreLayer).pipe(
+  Layer.provide(TestDatabaseLayer),
+);
+
+const TestEventSinkLayer = eventSinkLayer.pipe(
+  Layer.provide(Layer.mergeAll(TestStoresLayer, TestDatabaseLayer)),
+);
+
+const TestLayer = Layer.mergeAll(
+  TestStoresLayer,
+  TestEventSinkLayer,
+  idAllocatorLayer,
+  providerEventIngestorLayer.pipe(
+    Layer.provide(Layer.mergeAll(TestStoresLayer, TestEventSinkLayer, idAllocatorLayer)),
+  ),
+);
+const modelSelection = {
+  instanceId: ProviderInstanceId.make("codex"),
+  model: "gpt-5.4",
+} satisfies ModelSelection;
+const CODEX_DRIVER = ProviderDriverKind.make("codex");
+
+function threadCreatedEvent(
+  now: DateTime.Utc,
+): Effect.Effect<OrchestrationV2DomainEvent, IdAllocatorV2Error, IdAllocatorV2> {
+  return Effect.gen(function* () {
+    const idAllocator = yield* IdAllocatorV2;
+    const projectId = yield* idAllocator.allocate.project({
+      fixtureName: "provider-event-ingestor",
+    });
+    const threadId = yield* idAllocator.allocate.thread({
+      fixtureName: "provider-event-ingestor",
+      projectId,
+    });
+    const providerThreadId = idAllocator.derive.providerThread({
+      driver: CODEX_DRIVER,
+      nativeThreadId: "native-thread",
+    });
+    const thread: OrchestrationV2AppThread = {
+      createdBy: "user",
+      creationSource: "web",
+      id: threadId,
+      projectId,
+      title: "Provider event ingestor",
+      providerInstanceId: modelSelection.instanceId,
+      modelSelection: modelSelection,
+      runtimeMode: "full-access",
+      interactionMode: "default",
+      branch: null,
+      worktreePath: null,
+      activeProviderThreadId: providerThreadId,
+      lineage: {
+        parentThreadId: null,
+        relationshipToParent: null,
+        rootThreadId: threadId,
+      },
+      forkedFrom: null,
+      createdAt: now,
+      updatedAt: now,
+      archivedAt: null,
+      settledOverride: null,
+      settledAt: null,
+      lastVisitedAt: null,
+      deletedAt: null,
+    };
+
+    return {
+      id: yield* idAllocator.allocate.event({ threadId }),
+      type: "thread.created",
+      threadId,
+      occurredAt: now,
+      payload: thread,
+    };
+  });
+}
+
+const layer = it.layer(TestLayer);
+
+layer("ProviderEventIngestorV2", (it) => {
+  it.effect("normalizes provider events through the real event log and projection store", () =>
+    Effect.gen(function* () {
+      const now = yield* DateTime.now;
+      const eventSink = yield* EventSinkV2;
+      const eventStore = yield* EventStoreV2;
+      const projectionStore = yield* ProjectionStoreV2;
+      const ingestor = yield* ProviderEventIngestorV2;
+      const idAllocator = yield* IdAllocatorV2;
+      const threadEvent = yield* threadCreatedEvent(now);
+      const providerSessionId = yield* idAllocator.allocate.providerSession({
+        providerInstanceId: modelSelection.instanceId,
+        threadId: threadEvent.threadId,
+      });
+      const providerThread: OrchestrationV2ProviderThread = {
+        id: idAllocator.derive.providerThread({
+          driver: CODEX_DRIVER,
+          nativeThreadId: "native-thread",
+        }),
+        driver: CODEX_DRIVER,
+        providerInstanceId: modelSelection.instanceId,
+        providerSessionId,
+        appThreadId: threadEvent.threadId,
+        ownerNodeId: null,
+        nativeThreadRef: {
+          driver: CODEX_DRIVER,
+          nativeId: "native-thread",
+          strength: "strong",
+        },
+        nativeConversationHeadRef: null,
+        status: "idle",
+        firstRunOrdinal: null,
+        lastRunOrdinal: null,
+        handoffIds: [],
+        forkedFrom: null,
+        createdAt: now,
+        updatedAt: now,
+      };
+
+      yield* eventSink.write({ events: [threadEvent] });
+      const storedEvents = yield* ingestor.ingestNormalized({
+        providerSessionId,
+        providerInstanceId: modelSelection.instanceId,
+        threadId: threadEvent.threadId,
+        event: {
+          type: "provider_thread.updated",
+          driver: CODEX_DRIVER,
+          providerThread,
+        },
+      });
+
+      const projection = yield* projectionStore.getThreadProjection(threadEvent.threadId);
+      const storedDomainEvents = yield* eventStore.read({}).pipe(Stream.runCollect);
+      const afterFirstEvent = yield* eventStore
+        .read({ afterSequence: 1, threadId: threadEvent.threadId })
+        .pipe(Stream.runCollect);
+      const latestThreadSequence = yield* eventStore.latestSequence({
+        threadId: threadEvent.threadId,
+      });
+
+      assert.equal(storedEvents.length, 1);
+      assert.equal(storedEvents[0]?.event.type, "provider-thread.updated");
+      assert.deepEqual(
+        projection.providerThreads.map((thread) => thread.id),
+        [providerThread.id],
+      );
+      assert.deepEqual(
+        Array.from(storedDomainEvents).map((stored) => stored.event.type),
+        ["thread.created", "provider-thread.updated"],
+      );
+      assert.deepEqual(
+        Array.from(storedDomainEvents).map((stored) => stored.sequence),
+        [1, 2],
+      );
+      assert.deepEqual(
+        Array.from(afterFirstEvent).map((stored) => stored.event.type),
+        ["provider-thread.updated"],
+      );
+      assert.equal(latestThreadSequence, 2);
+    }),
+  );
+
+  it.effect(
+    "treats successful provider terminal markers as non-persisted orchestration control signals",
+    () =>
+      Effect.gen(function* () {
+        const ingestor = yield* ProviderEventIngestorV2;
+        const idAllocator = yield* IdAllocatorV2;
+        const projectId = yield* idAllocator.allocate.project({
+          fixtureName: "provider-event-terminal",
+        });
+        const threadId = yield* idAllocator.allocate.thread({
+          fixtureName: "provider-event-terminal",
+          projectId,
+        });
+        const providerSessionId = yield* idAllocator.allocate.providerSession({
+          providerInstanceId: modelSelection.instanceId,
+          threadId,
+        });
+        const normalized = yield* ingestor.normalize({
+          providerSessionId,
+          providerInstanceId: modelSelection.instanceId,
+          threadId,
+          event: {
+            type: "turn.terminal",
+            driver: CODEX_DRIVER,
+            providerThreadId: idAllocator.derive.providerThread({
+              driver: CODEX_DRIVER,
+              nativeThreadId: "native-thread",
+            }),
+            providerTurnId: idAllocator.derive.providerTurn({
+              driver: CODEX_DRIVER,
+              nativeTurnId: "native-turn",
+            }),
+            runOrdinal: 1,
+            status: "completed",
+            failure: null,
+            threadDisposition: "reusable",
+          },
+        });
+
+        assert.deepEqual(normalized, []);
+      }),
+  );
+
+  it.effect("persists an interrupted run's inherited terminal through the live run router", () =>
+    Effect.gen(function* () {
+      const now = yield* DateTime.now;
+      const eventSink = yield* EventSinkV2;
+      const projectionStore = yield* ProjectionStoreV2;
+      const ingestor = yield* ProviderEventIngestorV2;
+      const idAllocator = yield* IdAllocatorV2;
+      const threadEvent = yield* threadCreatedEvent(now);
+      const priorRunId = RunId.make("run:provider-event-inherited:prior");
+      const currentRunId = RunId.make("run:provider-event-inherited:current");
+      const itemId = TurnItemId.make("turn-item:provider-event-inherited");
+      const providerSessionId = yield* idAllocator.allocate.providerSession({
+        providerInstanceId: modelSelection.instanceId,
+        threadId: threadEvent.threadId,
+      });
+      const providerThreadId = idAllocator.derive.providerThread({
+        driver: CODEX_DRIVER,
+        nativeThreadId: "native-thread-inherited",
+      });
+      const providerTurnId = idAllocator.derive.providerTurn({
+        driver: CODEX_DRIVER,
+        nativeTurnId: "native-turn-inherited",
+      });
+      const runningItem = {
+        id: itemId,
+        threadId: threadEvent.threadId,
+        runId: priorRunId,
+        nodeId: NodeId.make("node:provider-event-inherited"),
+        providerThreadId,
+        providerTurnId,
+        nativeItemRef: null,
+        parentItemId: null,
+        ordinal: 101,
+        status: "running",
+        title: "Inherited background command",
+        startedAt: now,
+        completedAt: null,
+        updatedAt: now,
+        type: "command_execution",
+        input: "sleep 60",
+      } satisfies OrchestrationV2TurnItem;
+      const terminalItem = {
+        ...runningItem,
+        status: "completed" as const,
+        completedAt: now,
+        updatedAt: now,
+      };
+
+      yield* eventSink.write({ events: [threadEvent] });
+      yield* ingestor.ingestNormalized({
+        providerSessionId,
+        providerInstanceId: modelSelection.instanceId,
+        threadId: threadEvent.threadId,
+        runId: priorRunId,
+        event: { type: "turn_item.updated", driver: CODEX_DRIVER, turnItem: runningItem },
+      });
+
+      const identity: ProviderEventRouteIdentity = {
+        threadId: threadEvent.threadId,
+        runId: currentRunId,
+        attemptId: RunAttemptId.make("attempt:provider-event-inherited:current"),
+        providerThreadId,
+      };
+      const inheritedBackgroundTurnItems = selectInheritedBackgroundTurnItems({
+        threadId: threadEvent.threadId,
+        currentProviderThreadId: providerThreadId,
+        currentRunOrdinal: 2,
+        runs: [
+          {
+            id: priorRunId,
+            threadId: threadEvent.threadId,
+            ordinal: 1,
+            status: "interrupted",
+          } as OrchestrationV2Run,
+          {
+            id: currentRunId,
+            threadId: threadEvent.threadId,
+            ordinal: 2,
+            status: "running",
+          } as OrchestrationV2Run,
+        ],
+        turnItems: [runningItem],
+      });
+      const routeState = makeProviderEventRoutingState({
+        identity,
+        inheritedBackgroundTurnItems,
+        providerTurnId: null,
+      });
+      const terminalEvent = {
+        type: "turn_item.updated",
+        driver: CODEX_DRIVER,
+        turnItem: terminalItem,
+      } as const;
+      const [accepted] = routeProviderEvent(terminalEvent, identity, routeState);
+      assert.isTrue(accepted);
+
+      const stored = yield* ingestor.ingestNormalized({
+        providerSessionId,
+        providerInstanceId: modelSelection.instanceId,
+        threadId: threadEvent.threadId,
+        runId: currentRunId,
+        event: terminalEvent,
+      });
+      const projection = yield* projectionStore.getThreadProjection(threadEvent.threadId);
+      const persisted = projection.turnItems.find((item) => item.id === itemId);
+
+      assert.equal(stored.length, 1);
+      assert.equal(stored[0]?.event.type, "turn-item.updated");
+      assert.equal(persisted?.runId, priorRunId);
+      assert.equal(persisted?.threadId, threadEvent.threadId);
+      assert.equal(persisted?.status, "completed");
+    }),
+  );
+
+  it.effect("persists a completed run's late background terminal exactly once", () =>
+    Effect.gen(function* () {
+      const now = yield* DateTime.now;
+      const eventSink = yield* EventSinkV2;
+      const eventStore = yield* EventStoreV2;
+      const ingestor = yield* ProviderEventIngestorV2;
+      const idAllocator = yield* IdAllocatorV2;
+      const threadEvent = yield* threadCreatedEvent(now);
+      const priorRunId = RunId.make("run:provider-event-completed:prior");
+      const currentRunId = RunId.make("run:provider-event-completed:current");
+      const itemId = TurnItemId.make("turn-item:provider-event-completed");
+      const providerSessionId = yield* idAllocator.allocate.providerSession({
+        providerInstanceId: modelSelection.instanceId,
+        threadId: threadEvent.threadId,
+      });
+      const providerThreadId = idAllocator.derive.providerThread({
+        driver: CODEX_DRIVER,
+        nativeThreadId: "native-thread-completed",
+      });
+      const providerTurnId = idAllocator.derive.providerTurn({
+        driver: CODEX_DRIVER,
+        nativeTurnId: "native-turn-completed",
+      });
+      const runningItem = {
+        id: itemId,
+        threadId: threadEvent.threadId,
+        runId: priorRunId,
+        nodeId: NodeId.make("node:provider-event-completed"),
+        providerThreadId,
+        providerTurnId,
+        nativeItemRef: null,
+        parentItemId: null,
+        ordinal: 101,
+        status: "running",
+        title: "Completed run background command",
+        startedAt: now,
+        completedAt: null,
+        updatedAt: now,
+        type: "command_execution",
+        input: "sleep 60",
+      } satisfies OrchestrationV2TurnItem;
+      const terminalEvent = {
+        type: "turn_item.updated",
+        driver: CODEX_DRIVER,
+        turnItem: {
+          ...runningItem,
+          status: "completed" as const,
+          completedAt: now,
+          updatedAt: now,
+        },
+      } as const;
+
+      yield* eventSink.write({ events: [threadEvent] });
+      yield* ingestor.ingestNormalized({
+        providerSessionId,
+        providerInstanceId: modelSelection.instanceId,
+        threadId: threadEvent.threadId,
+        runId: priorRunId,
+        event: { type: "turn_item.updated", driver: CODEX_DRIVER, turnItem: runningItem },
+      });
+
+      const priorIdentity: ProviderEventRouteIdentity = {
+        threadId: threadEvent.threadId,
+        runId: priorRunId,
+        attemptId: RunAttemptId.make("attempt:provider-event-completed:prior"),
+        providerThreadId,
+      };
+      const currentIdentity: ProviderEventRouteIdentity = {
+        threadId: threadEvent.threadId,
+        runId: currentRunId,
+        attemptId: RunAttemptId.make("attempt:provider-event-completed:current"),
+        providerThreadId,
+      };
+      const inheritedBackgroundTurnItems = selectInheritedBackgroundTurnItems({
+        threadId: threadEvent.threadId,
+        currentProviderThreadId: providerThreadId,
+        currentRunOrdinal: 2,
+        runs: [
+          {
+            id: priorRunId,
+            threadId: threadEvent.threadId,
+            ordinal: 1,
+            status: "completed",
+          } as OrchestrationV2Run,
+          {
+            id: currentRunId,
+            threadId: threadEvent.threadId,
+            ordinal: 2,
+            status: "running",
+          } as OrchestrationV2Run,
+        ],
+        turnItems: [runningItem],
+      });
+      const routers = [
+        {
+          identity: priorIdentity,
+          state: makeProviderEventRoutingState({
+            identity: priorIdentity,
+            providerTurnId: providerTurnId,
+          }),
+        },
+        {
+          identity: currentIdentity,
+          state: makeProviderEventRoutingState({
+            identity: currentIdentity,
+            inheritedBackgroundTurnItems,
+            providerTurnId: null,
+          }),
+        },
+      ];
+      const acceptedRouters = routers.filter(
+        ({ identity, state }) => routeProviderEvent(terminalEvent, identity, state)[0],
+      );
+
+      yield* Effect.forEach(
+        acceptedRouters,
+        ({ identity }) =>
+          ingestor.ingestNormalized({
+            providerSessionId,
+            providerInstanceId: modelSelection.instanceId,
+            threadId: threadEvent.threadId,
+            runId: identity.runId,
+            event: terminalEvent,
+          }),
+        { concurrency: 1 },
+      );
+
+      const storedEvents = yield* eventStore
+        .read({ threadId: threadEvent.threadId })
+        .pipe(Stream.runCollect);
+      const storedTerminals = Array.from(storedEvents).filter(
+        (stored) =>
+          stored.event.type === "turn-item.updated" &&
+          stored.event.payload.id === itemId &&
+          stored.event.payload.status === "completed",
+      );
+
+      assert.equal(storedTerminals.length, 1);
+      assert.equal(acceptedRouters.length, 1);
+      assert.equal(acceptedRouters[0]?.identity.runId, priorRunId);
+    }),
+  );
+
+  it.effect("persists a failed provider terminal as one expected error item", () =>
+    Effect.gen(function* () {
+      const now = yield* DateTime.now;
+      const retryStartedAt = DateTime.makeUnsafe(DateTime.toEpochMillis(now) - 5_000);
+      const eventSink = yield* EventSinkV2;
+      const projectionStore = yield* ProjectionStoreV2;
+      const ingestor = yield* ProviderEventIngestorV2;
+      const idAllocator = yield* IdAllocatorV2;
+      const threadEvent = yield* threadCreatedEvent(now);
+      const providerSessionId = yield* idAllocator.allocate.providerSession({
+        providerInstanceId: modelSelection.instanceId,
+        threadId: threadEvent.threadId,
+      });
+      const providerThreadId = idAllocator.derive.providerThread({
+        driver: CODEX_DRIVER,
+        nativeThreadId: "native-thread-failed",
+      });
+      const providerTurnId = idAllocator.derive.providerTurn({
+        driver: CODEX_DRIVER,
+        nativeTurnId: "native-turn-failed",
+      });
+
+      yield* eventSink.write({ events: [threadEvent] });
+      const stored = yield* ingestor.ingestNormalized({
+        providerSessionId,
+        providerInstanceId: modelSelection.instanceId,
+        threadId: threadEvent.threadId,
+        event: {
+          type: "turn.terminal",
+          driver: CODEX_DRIVER,
+          providerThreadId,
+          providerTurnId,
+          runOrdinal: 1,
+          failureItemOrdinal: 102,
+          status: "failed",
+          failure: makeProviderFailure({
+            message: "Invalid reasoning effort.",
+            code: "invalid_request",
+            class: "validation_error",
+          }),
+          retry: {
+            attempt: 3,
+            maxAttempts: 3,
+            retryDelayMs: 2_000,
+          },
+          retryStartedAt,
+          threadDisposition: "reusable",
+        },
+      });
+
+      const projection = yield* projectionStore.getThreadProjection(threadEvent.threadId);
+      const errorItems = projection.visibleTurnItems.filter(
+        (candidate) => candidate.item.type === "error",
+      );
+
+      assert.equal(stored.length, 1);
+      assert.equal(stored[0]?.event.type, "turn-item.updated");
+      assert.equal(errorItems.length, 1);
+      const errorItem = errorItems[0]?.item;
+      assert.equal(errorItem?.type, "error");
+      if (errorItem?.type !== "error") return;
+      assert.equal(errorItem.failure.message, "Invalid reasoning effort.");
+      assert.equal(errorItem.failure.code, "invalid_request");
+      assert.deepEqual(errorItem.retry, {
+        attempt: 3,
+        maxAttempts: 3,
+        retryDelayMs: 2_000,
+      });
+      const errorStartedAt = errorItem.startedAt;
+      assert.ok(errorStartedAt);
+      assert.equal(DateTime.toEpochMillis(errorStartedAt), DateTime.toEpochMillis(retryStartedAt));
+      assert.equal(errorItem.providerThreadId, providerThreadId);
+      assert.equal(errorItem.providerTurnId, providerTurnId);
+    }),
+  );
+
+  it.effect("routes provider-owned child artifacts to their child app thread", () =>
+    Effect.gen(function* () {
+      const now = yield* DateTime.now;
+      const ingestor = yield* ProviderEventIngestorV2;
+      const idAllocator = yield* IdAllocatorV2;
+      const rootEvent = yield* threadCreatedEvent(now);
+      if (rootEvent.type !== "thread.created") {
+        throw new Error("Expected a thread.created fixture event");
+      }
+      const childThreadId = idAllocator.derive.threadFromProviderThread({
+        driver: CODEX_DRIVER,
+        nativeThreadId: "native-subagent-thread",
+      });
+      const childRootNodeId = NodeId.make("node:subagent-root");
+      const childThread: OrchestrationV2AppThread = {
+        ...rootEvent.payload,
+        id: childThreadId,
+        title: "inspect package",
+        activeProviderThreadId: null,
+        lineage: {
+          parentThreadId: rootEvent.threadId,
+          relationshipToParent: "subagent",
+          rootThreadId: rootEvent.threadId,
+        },
+        forkedFrom: {
+          type: "node",
+          nodeId: NodeId.make("node:parent-subagent"),
+        },
+      };
+      const providerSessionId = yield* idAllocator.allocate.providerSession({
+        providerInstanceId: modelSelection.instanceId,
+        threadId: rootEvent.threadId,
+      });
+
+      const threadEvents = yield* ingestor.normalize({
+        providerSessionId,
+        providerInstanceId: modelSelection.instanceId,
+        threadId: rootEvent.threadId,
+        event: {
+          type: "app_thread.created",
+          driver: CODEX_DRIVER,
+          appThread: childThread,
+        },
+      });
+      const messageEvents = yield* ingestor.normalize({
+        providerSessionId,
+        providerInstanceId: modelSelection.instanceId,
+        threadId: rootEvent.threadId,
+        event: {
+          type: "message.updated",
+          driver: CODEX_DRIVER,
+          message: {
+            createdBy: "agent",
+            creationSource: "provider",
+            id: MessageId.make("message:subagent-response"),
+            threadId: childThreadId,
+            runId: null,
+            nodeId: childRootNodeId,
+            role: "assistant",
+            text: "Subagent result",
+            attachments: [],
+            streaming: false,
+            createdAt: now,
+            updatedAt: now,
+          },
+        },
+      });
+
+      assert.equal(threadEvents[0]?.type, "thread.created");
+      assert.equal(threadEvents[0]?.threadId, childThreadId);
+      assert.equal(messageEvents[0]?.type, "message.updated");
+      assert.equal(messageEvents[0]?.threadId, childThreadId);
+    }),
+  );
+});
diff --git a/apps/server/src/orchestration-v2/ProviderEventIngestor.ts b/apps/server/src/orchestration-v2/ProviderEventIngestor.ts
new file mode 100644
index 000000000000..46bd6174af2a
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ProviderEventIngestor.ts
@@ -0,0 +1,327 @@
+import {
+  NodeId,
+  CommandId,
+  OrchestrationV2DomainEvent,
+  OrchestrationV2StoredEvent,
+  type OrchestrationV2Run,
+  ProviderInstanceId,
+  ProviderSessionId,
+  ProviderThreadId,
+  RawEventId,
+  RunAttemptId,
+  RunId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as Context from "effect/Context";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Schema from "effect/Schema";
+
+import { EventSinkV2 } from "./EventSink.ts";
+import { IdAllocatorV2 } from "./IdAllocator.ts";
+import { ProviderAdapterV2Event } from "./ProviderAdapter.ts";
+import { makeProviderFailureTurnItem } from "./ProviderFailure.ts";
+
+export class ProviderEventNormalizeError extends Schema.TaggedErrorClass<ProviderEventNormalizeError>()(
+  "ProviderEventNormalizeError",
+  {
+    providerSessionId: ProviderSessionId,
+    threadId: ThreadId,
+    providerEvent: ProviderAdapterV2Event,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to normalize provider event ${this.providerEvent.type} for thread ${this.threadId}.`;
+  }
+}
+
+export class ProviderEventPublishError extends Schema.TaggedErrorClass<ProviderEventPublishError>()(
+  "ProviderEventPublishError",
+  {
+    providerSessionId: ProviderSessionId,
+    eventCount: Schema.Number,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to publish ${this.eventCount} normalized provider event(s).`;
+  }
+}
+
+export const ProviderEventIngestorV2Error = Schema.Union([
+  ProviderEventNormalizeError,
+  ProviderEventPublishError,
+]);
+export type ProviderEventIngestorV2Error = typeof ProviderEventIngestorV2Error.Type;
+
+export interface ProviderEventIngestInput {
+  readonly providerSessionId: ProviderSessionId;
+  readonly providerInstanceId: ProviderInstanceId;
+  readonly commandId?: CommandId;
+  readonly threadId: ThreadId;
+  readonly runId?: RunId;
+  readonly nodeId?: NodeId;
+  readonly rawEventId?: RawEventId;
+  readonly event: ProviderAdapterV2Event;
+}
+
+export interface ProviderEventIngestorV2Shape {
+  readonly normalize: (
+    input: ProviderEventIngestInput,
+  ) => Effect.Effect<ReadonlyArray<OrchestrationV2DomainEvent>, ProviderEventIngestorV2Error>;
+  readonly ingestNormalized: (
+    input: ProviderEventIngestInput & {
+      /**
+       * Atomically reject mutable provider state emitted by an attempt that
+       * lost ownership while the adapter event was in flight.
+       */
+      readonly writeIfRunCurrent?: {
+        readonly runId: RunId;
+        readonly activeAttemptId: RunAttemptId;
+        readonly expectedStatus: OrchestrationV2Run["status"];
+      };
+      /**
+       * Atomically reject provider-thread snapshots from an attempt that no
+       * longer owns the run or from a run that no longer owns the thread.
+       */
+      readonly writeIfProviderThreadOwner?: {
+        readonly providerThreadId: ProviderThreadId;
+        readonly runId: RunId;
+        readonly activeAttemptId: RunAttemptId;
+        readonly expectedLastRunOrdinal: number;
+      };
+    },
+  ) => Effect.Effect<ReadonlyArray<OrchestrationV2StoredEvent>, ProviderEventIngestorV2Error>;
+}
+
+export class ProviderEventIngestorV2 extends Context.Service<
+  ProviderEventIngestorV2,
+  ProviderEventIngestorV2Shape
+>()("t3/orchestration-v2/ProviderEventIngestor/ProviderEventIngestorV2") {}
+
+function compactUndefined<T extends Record<string, unknown>>(record: T): T {
+  return Object.fromEntries(Object.entries(record).filter(([, value]) => value !== undefined)) as T;
+}
+
+const decodeDomainEvent = Schema.decodeUnknownEffect(OrchestrationV2DomainEvent);
+
+export const layer: Layer.Layer<ProviderEventIngestorV2, never, EventSinkV2 | IdAllocatorV2> =
+  Layer.effect(
+    ProviderEventIngestorV2,
+    Effect.gen(function* () {
+      const eventSink = yield* EventSinkV2;
+      const idAllocator = yield* IdAllocatorV2;
+
+      const makeDomainEvent = (
+        input: ProviderEventIngestInput,
+        payloadInput: {
+          readonly type: OrchestrationV2DomainEvent["type"];
+          readonly payload: OrchestrationV2DomainEvent["payload"];
+          readonly threadId?: ThreadId;
+          readonly runId?: RunId | null;
+          readonly nodeId?: NodeId | null;
+        },
+      ) =>
+        Effect.gen(function* () {
+          const threadId = payloadInput.threadId ?? input.threadId;
+          const eventId = yield* idAllocator.allocate.event({
+            threadId,
+            providerSessionId: input.providerSessionId,
+          });
+          const occurredAt = yield* DateTime.now;
+          return yield* decodeDomainEvent(
+            compactUndefined({
+              id: eventId,
+              type: payloadInput.type,
+              threadId,
+              runId: payloadInput.runId ?? input.runId,
+              nodeId: payloadInput.nodeId ?? input.nodeId,
+              driver: input.event.driver,
+              providerInstanceId: input.providerInstanceId,
+              rawEventId: input.rawEventId,
+              occurredAt,
+              payload: payloadInput.payload,
+            }),
+          );
+        });
+
+      const normalize: ProviderEventIngestorV2Shape["normalize"] = (input) =>
+        Effect.gen(function* () {
+          switch (input.event.type) {
+            case "app_thread.created":
+              return [
+                yield* makeDomainEvent(input, {
+                  type: "thread.created",
+                  threadId: input.event.appThread.id,
+                  payload: input.event.appThread,
+                }),
+              ];
+            case "provider_session.updated":
+              return [
+                yield* makeDomainEvent(input, {
+                  type: "provider-session.updated",
+                  payload: input.event.providerSession,
+                }),
+              ];
+            case "provider_thread.updated":
+              return [
+                yield* makeDomainEvent(input, {
+                  type: "provider-thread.updated",
+                  threadId: input.event.providerThread.appThreadId ?? input.threadId,
+                  payload: input.event.providerThread,
+                }),
+              ];
+            case "provider_turn.updated":
+              return [
+                yield* makeDomainEvent(input, {
+                  type: "provider-turn.updated",
+                  ...(input.event.threadId === undefined ? {} : { threadId: input.event.threadId }),
+                  payload: input.event.providerTurn,
+                  nodeId: input.event.providerTurn.nodeId,
+                }),
+              ];
+            case "node.updated":
+              return [
+                yield* makeDomainEvent(input, {
+                  type: "node.updated",
+                  threadId: input.event.node.threadId,
+                  payload: input.event.node,
+                  runId: input.event.node.runId,
+                  nodeId: input.event.node.id,
+                }),
+              ];
+            case "subagent.updated":
+              return [
+                yield* makeDomainEvent(input, {
+                  type: "subagent.updated",
+                  threadId: input.event.subagent.threadId,
+                  payload: input.event.subagent,
+                  runId: input.event.subagent.runId,
+                  nodeId: input.event.subagent.id,
+                }),
+              ];
+            case "message.updated":
+              return [
+                yield* makeDomainEvent(input, {
+                  type: "message.updated",
+                  threadId: input.event.message.threadId,
+                  payload: input.event.message,
+                  runId: input.event.message.runId,
+                  nodeId: input.event.message.nodeId,
+                }),
+              ];
+            case "turn_item.updated":
+              return [
+                yield* makeDomainEvent(input, {
+                  type: "turn-item.updated",
+                  threadId: input.event.turnItem.threadId,
+                  payload: input.event.turnItem,
+                  runId: input.event.turnItem.runId,
+                  nodeId: input.event.turnItem.nodeId,
+                }),
+              ];
+            case "runtime_request.updated":
+              return [
+                yield* makeDomainEvent(input, {
+                  type: "runtime-request.updated",
+                  ...(input.event.threadId === undefined ? {} : { threadId: input.event.threadId }),
+                  payload: input.event.runtimeRequest,
+                  nodeId: input.event.runtimeRequest.nodeId,
+                }),
+              ];
+            case "plan.updated":
+              return [
+                yield* makeDomainEvent(input, {
+                  type: "plan.updated",
+                  threadId: input.event.plan.threadId,
+                  payload: input.event.plan,
+                  runId: input.event.plan.runId,
+                  nodeId: input.event.plan.nodeId,
+                }),
+              ];
+            case "turn.terminal":
+              if (input.event.status !== "failed") {
+                return [];
+              }
+              const occurredAt = yield* DateTime.now;
+              return [
+                yield* makeDomainEvent(input, {
+                  type: "turn-item.updated",
+                  payload: makeProviderFailureTurnItem({
+                    idAllocator,
+                    driver: input.event.driver,
+                    threadId: input.threadId,
+                    runId: input.runId ?? null,
+                    nodeId: input.nodeId ?? null,
+                    providerThreadId: input.event.providerThreadId,
+                    providerTurnId: input.event.providerTurnId,
+                    itemOrdinal: input.event.failureItemOrdinal,
+                    failure: input.event.failure,
+                    ...(input.event.retry === undefined ? {} : { retry: input.event.retry }),
+                    ...(input.event.retryStartedAt === undefined
+                      ? {}
+                      : { retryStartedAt: input.event.retryStartedAt }),
+                    occurredAt,
+                  }),
+                }),
+              ];
+          }
+        }).pipe(
+          Effect.mapError(
+            (cause) =>
+              new ProviderEventNormalizeError({
+                providerSessionId: input.providerSessionId,
+                threadId: input.threadId,
+                providerEvent: input.event,
+                cause,
+              }),
+          ),
+        );
+
+      return ProviderEventIngestorV2.of({
+        normalize,
+        ingestNormalized: (input) =>
+          Effect.gen(function* () {
+            const events = yield* normalize(input);
+            if (events.length === 0) {
+              return [];
+            }
+            const mapWriteError = (cause: unknown) =>
+              new ProviderEventPublishError({
+                providerSessionId: input.providerSessionId,
+                eventCount: events.length,
+                cause,
+              });
+            if (input.writeIfProviderThreadOwner !== undefined) {
+              const ownerResult = yield* eventSink
+                .writeIfProviderThreadOwner({
+                  ...(input.commandId === undefined ? {} : { commandId: input.commandId }),
+                  ...input.writeIfProviderThreadOwner,
+                  events,
+                })
+                .pipe(Effect.mapError(mapWriteError));
+              return ownerResult.storedEvents;
+            }
+            if (input.writeIfRunCurrent === undefined) {
+              return yield* eventSink
+                .write({
+                  ...(input.commandId === undefined ? {} : { commandId: input.commandId }),
+                  events,
+                })
+                .pipe(Effect.mapError(mapWriteError));
+            }
+            const result = yield* eventSink
+              .writeIfRunCurrent({
+                ...(input.commandId === undefined ? {} : { commandId: input.commandId }),
+                threadId: input.threadId,
+                ...input.writeIfRunCurrent,
+                events,
+              })
+              .pipe(Effect.mapError(mapWriteError));
+            return result.storedEvents;
+          }),
+      });
+    }),
+  );
diff --git a/apps/server/src/orchestration-v2/ProviderFailure.test.ts b/apps/server/src/orchestration-v2/ProviderFailure.test.ts
new file mode 100644
index 000000000000..68cd5e2d227c
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ProviderFailure.test.ts
@@ -0,0 +1,124 @@
+import { assert, it } from "@effect/vitest";
+import {
+  NodeId,
+  ProviderDriverKind,
+  ProviderThreadId,
+  ProviderTurnId,
+  RunId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+
+import {
+  makeProviderFailure,
+  makeProviderFailureTurnItem,
+  MAX_PROVIDER_FAILURE_CODE_LENGTH,
+  MAX_PROVIDER_FAILURE_MESSAGE_LENGTH,
+} from "./ProviderFailure.ts";
+import { IdAllocatorV2, layer as idAllocatorLayer } from "./IdAllocator.ts";
+
+it("redacts credentials and URL secrets from provider failures", () => {
+  const failure = makeProviderFailure({
+    message:
+      'request failed: Authorization: Bearer bearer-secret https://user:pass@example.test/path?access_token=url-secret#fragment {"token":"json-secret"} api_key=key-secret sk-abcdefghijklmnop',
+    code: "provider_rejected",
+    class: "provider_error",
+  });
+
+  assert.equal(failure.class, "provider_error");
+  assert.equal(failure.code, "provider_rejected");
+  assert.include(failure.message, "[REDACTED]");
+  assert.include(failure.message, "https://example.test/path");
+  assert.notInclude(failure.message, "bearer-secret");
+  assert.notInclude(failure.message, "user:pass");
+  assert.notInclude(failure.message, "url-secret");
+  assert.notInclude(failure.message, "json-secret");
+  assert.notInclude(failure.message, "key-secret");
+  assert.notInclude(failure.message, "sk-abcdefghijklmnop");
+});
+
+it("replaces unsafe control characters without stripping whitespace", () => {
+  const failure = makeProviderFailure({ message: "before\u0000\u0007\t\nafter\u007f" });
+
+  assert.equal(failure.message, "before  \t\nafter");
+});
+
+it("bounds provider-controlled failure strings", () => {
+  const failure = makeProviderFailure({
+    message: "m".repeat(MAX_PROVIDER_FAILURE_MESSAGE_LENGTH + 500),
+    code: "c".repeat(MAX_PROVIDER_FAILURE_CODE_LENGTH + 50),
+  });
+
+  assert.equal(failure.message.length, MAX_PROVIDER_FAILURE_MESSAGE_LENGTH);
+  assert.equal(failure.code?.length, MAX_PROVIDER_FAILURE_CODE_LENGTH);
+  assert.match(failure.message, /…$/u);
+  assert.match(failure.code ?? "", /…$/u);
+});
+
+it("does not split a surrogate pair at the truncation boundary", () => {
+  const failure = makeProviderFailure({
+    message: `${"a".repeat(MAX_PROVIDER_FAILURE_MESSAGE_LENGTH - 2)}🚀tail`,
+  });
+
+  assert.equal(failure.message.length, MAX_PROVIDER_FAILURE_MESSAGE_LENGTH - 1);
+  assert.equal(failure.message.at(-1), "…");
+  assert.notMatch(failure.message.slice(0, -1), /[\uD800-\uDBFF]$/u);
+});
+
+it("does not serialize arbitrary provider causes", () => {
+  const failure = makeProviderFailure({
+    cause: {
+      payload: { authorization: "Bearer nested-secret" },
+      stack: "private provider stack",
+    },
+    class: "transport_error",
+  });
+
+  assert.deepEqual(failure, {
+    class: "transport_error",
+    message: "Provider turn failed.",
+    code: null,
+    retryable: null,
+  });
+});
+
+it.effect("keys terminal failure items by provider turn across retries and fallback paths", () =>
+  Effect.gen(function* () {
+    const idAllocator = yield* IdAllocatorV2;
+    const driver = ProviderDriverKind.make("codex");
+    const runId = RunId.make("run:provider-failure-id");
+    const base = {
+      idAllocator,
+      driver,
+      threadId: ThreadId.make("thread:provider-failure-id"),
+      runId,
+      nodeId: NodeId.make("node:provider-failure-id"),
+      providerThreadId: ProviderThreadId.make("provider-thread:provider-failure-id"),
+      itemOrdinal: 101,
+      failure: makeProviderFailure({ message: "Provider failed" }),
+      occurredAt: DateTime.makeUnsafe("2026-06-22T12:00:00.000Z"),
+    } as const;
+    const firstTurnId = ProviderTurnId.make("provider-turn:provider-failure-id:first");
+    const secondTurnId = ProviderTurnId.make("provider-turn:provider-failure-id:second");
+
+    const firstAttempt = makeProviderFailureTurnItem({
+      ...base,
+      providerTurnId: firstTurnId,
+    });
+    const retriedAttempt = makeProviderFailureTurnItem({
+      ...base,
+      providerTurnId: secondTurnId,
+    });
+    const ingestorFallback = makeProviderFailureTurnItem({
+      ...base,
+      runId: null,
+      nodeId: null,
+      providerTurnId: firstTurnId,
+    });
+
+    assert.notEqual(firstAttempt.id, retriedAttempt.id);
+    assert.equal(firstAttempt.id, ingestorFallback.id);
+    assert.equal(firstAttempt.ordinal, 101);
+  }).pipe(Effect.provide(idAllocatorLayer)),
+);
diff --git a/apps/server/src/orchestration-v2/ProviderFailure.ts b/apps/server/src/orchestration-v2/ProviderFailure.ts
new file mode 100644
index 000000000000..9c60c72a7e13
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ProviderFailure.ts
@@ -0,0 +1,202 @@
+import type {
+  NodeId,
+  OrchestrationV2ProviderFailure,
+  OrchestrationV2ProviderFailureClass,
+  OrchestrationV2ProviderRetry,
+  OrchestrationV2TurnItem,
+  ProviderDriverKind,
+  ProviderThreadId,
+  ProviderTurnId,
+  RunId,
+  ThreadId,
+} from "@t3tools/contracts";
+import type * as DateTime from "effect/DateTime";
+
+import type { IdAllocatorV2Shape } from "./IdAllocator.ts";
+
+export const MAX_PROVIDER_FAILURE_MESSAGE_LENGTH = 4_096;
+export const MAX_PROVIDER_FAILURE_CODE_LENGTH = 128;
+
+const DEFAULT_PROVIDER_FAILURE_MESSAGE = "Provider turn failed.";
+
+function stringField(value: unknown, key: "message" | "code"): string | undefined {
+  if (typeof value !== "object" || value === null) return undefined;
+  try {
+    const candidate = (value as Record<string, unknown>)[key];
+    return typeof candidate === "string" ? candidate : undefined;
+  } catch {
+    return undefined;
+  }
+}
+
+function redactUrl(match: string): string {
+  const trailing = /[),.;!?]+$/u.exec(match)?.[0] ?? "";
+  const candidate = trailing.length === 0 ? match : match.slice(0, -trailing.length);
+  try {
+    const url = new URL(candidate);
+    url.username = "";
+    url.password = "";
+    url.search = "";
+    url.hash = "";
+    return `${url.toString()}${trailing}`;
+  } catch {
+    return "[REDACTED_URL]";
+  }
+}
+
+function replaceUnsafeControlCharacters(value: string): string {
+  const sanitized: Array<string> = [];
+  for (const character of value) {
+    const codePoint = character.codePointAt(0) ?? 0;
+    sanitized.push(
+      codePoint <= 0x08 ||
+        (codePoint >= 0x0b && codePoint <= 0x0c) ||
+        (codePoint >= 0x0e && codePoint <= 0x1f) ||
+        codePoint === 0x7f
+        ? " "
+        : character,
+    );
+  }
+  return sanitized.join("");
+}
+
+/** Removes common credential forms before provider text crosses a transport boundary. */
+export function redactProviderFailureText(value: string): string {
+  return replaceUnsafeControlCharacters(value)
+    .replace(/\bhttps?:\/\/[^\s<>"']+/giu, redactUrl)
+    .replace(/\b(Bearer|Basic)\s+[^\s,;]+/giu, "$1 [REDACTED]")
+    .replace(
+      /(["'](?:access[_-]?token|api[_-]?key|authorization|credential|password|secret|token)["']\s*:\s*["'])[^"']*(["'])/giu,
+      "$1[REDACTED]$2",
+    )
+    .replace(
+      /(\b(?:access[_-]?token|api[_-]?key|authorization|credential|password|secret|token)\b\s*[:=]\s*)(?:"[^"]*"|'[^']*'|[^\s,;]+)/giu,
+      "$1[REDACTED]",
+    )
+    .replace(/\bsk-[A-Za-z0-9_-]{16,}\b/gu, "[REDACTED]")
+    .trim();
+}
+
+function boundedText(value: string, maxLength: number): string {
+  const redacted = redactProviderFailureText(value);
+  if (redacted.length <= maxLength) return redacted;
+  let end = Math.max(0, maxLength - 1);
+  const finalCodeUnit = redacted.charCodeAt(end - 1);
+  if (finalCodeUnit >= 0xd800 && finalCodeUnit <= 0xdbff) {
+    end -= 1;
+  }
+  return `${redacted.slice(0, end)}…`;
+}
+
+export function makeProviderFailure(input: {
+  readonly cause?: unknown;
+  readonly message?: string | undefined;
+  readonly code?: string | null | undefined;
+  readonly class?: OrchestrationV2ProviderFailureClass;
+  readonly retryable?: boolean | null;
+}): OrchestrationV2ProviderFailure {
+  const rawMessage =
+    input.message ??
+    (input.cause instanceof Error ? input.cause.message : stringField(input.cause, "message")) ??
+    DEFAULT_PROVIDER_FAILURE_MESSAGE;
+  const message = boundedText(rawMessage, MAX_PROVIDER_FAILURE_MESSAGE_LENGTH);
+  const rawCode = input.code ?? stringField(input.cause, "code") ?? null;
+  const code =
+    rawCode === null ? null : boundedText(rawCode, MAX_PROVIDER_FAILURE_CODE_LENGTH) || null;
+
+  return {
+    class: input.class ?? "unknown",
+    message: message || DEFAULT_PROVIDER_FAILURE_MESSAGE,
+    code,
+    retryable: input.retryable ?? null,
+  };
+}
+
+export function makeProviderFailureTurnItem(input: {
+  readonly idAllocator: IdAllocatorV2Shape;
+  readonly driver: ProviderDriverKind;
+  readonly threadId: ThreadId;
+  readonly runId: RunId | null;
+  readonly nodeId: NodeId | null;
+  readonly providerThreadId: ProviderThreadId;
+  readonly providerTurnId: ProviderTurnId;
+  readonly itemOrdinal: number;
+  readonly failure: OrchestrationV2ProviderFailure;
+  readonly retry?: OrchestrationV2ProviderRetry;
+  readonly retryStartedAt?: DateTime.Utc;
+  readonly occurredAt: DateTime.Utc;
+}): Extract<OrchestrationV2TurnItem, { readonly type: "error" }> {
+  return {
+    id: input.idAllocator.derive.turnItemFromProviderItem({
+      driver: input.driver,
+      nativeItemId: `terminal-failure:${input.providerTurnId}`,
+    }),
+    threadId: input.threadId,
+    runId: input.runId,
+    nodeId: input.nodeId,
+    providerThreadId: input.providerThreadId,
+    providerTurnId: input.providerTurnId,
+    nativeItemRef: null,
+    parentItemId: null,
+    ordinal: input.itemOrdinal,
+    status: "failed",
+    title: "Provider error",
+    startedAt: input.retryStartedAt ?? input.occurredAt,
+    completedAt: input.occurredAt,
+    updatedAt: input.occurredAt,
+    type: "error",
+    failure: input.failure,
+    ...(input.retry === undefined ? {} : { retry: input.retry }),
+  };
+}
+
+export function makeProviderRetryTurnItem(input: {
+  readonly idAllocator: IdAllocatorV2Shape;
+  readonly driver: ProviderDriverKind;
+  readonly threadId: ThreadId;
+  readonly runId: RunId | null;
+  readonly nodeId: NodeId | null;
+  readonly providerThreadId: ProviderThreadId;
+  readonly providerTurnId: ProviderTurnId;
+  readonly itemOrdinal: number;
+  readonly failure: OrchestrationV2ProviderFailure;
+  readonly retry: OrchestrationV2ProviderRetry;
+  readonly status: Extract<
+    OrchestrationV2TurnItem["status"],
+    "running" | "completed" | "failed" | "interrupted" | "cancelled"
+  >;
+  readonly startedAt: DateTime.Utc;
+  readonly updatedAt: DateTime.Utc;
+}): Extract<OrchestrationV2TurnItem, { readonly type: "error" }> {
+  const completed = input.status !== "running";
+  let title = "Provider retry";
+  if (input.status === "completed") {
+    title = "Provider recovered";
+  } else if (input.status === "failed") {
+    title = "Provider error";
+  } else if (input.status === "interrupted" || input.status === "cancelled") {
+    title = "Provider retry stopped";
+  }
+  return {
+    id: input.idAllocator.derive.turnItemFromProviderItem({
+      driver: input.driver,
+      nativeItemId: `terminal-failure:${input.providerTurnId}`,
+    }),
+    threadId: input.threadId,
+    runId: input.runId,
+    nodeId: input.nodeId,
+    providerThreadId: input.providerThreadId,
+    providerTurnId: input.providerTurnId,
+    nativeItemRef: null,
+    parentItemId: null,
+    ordinal: input.itemOrdinal,
+    status: input.status,
+    title,
+    startedAt: input.startedAt,
+    completedAt: completed ? input.updatedAt : null,
+    updatedAt: input.updatedAt,
+    type: "error",
+    failure: input.failure,
+    retry: input.retry,
+  };
+}
diff --git a/apps/server/src/orchestration-v2/ProviderRuntimeRecoveryService.regression.test.ts b/apps/server/src/orchestration-v2/ProviderRuntimeRecoveryService.regression.test.ts
new file mode 100644
index 000000000000..e0df224ebb54
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ProviderRuntimeRecoveryService.regression.test.ts
@@ -0,0 +1,84 @@
+import {
+  ProviderInstanceId,
+  RunId,
+  ThreadId,
+  TurnItemId,
+  type OrchestrationV2ThreadProjection,
+} from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { expect, it } from "vite-plus/test";
+
+import * as EffectWorker from "./EffectWorker.ts";
+import * as EffectOutbox from "./EffectOutbox.ts";
+import * as EventSink from "./EventSink.ts";
+import * as IdAllocator from "./IdAllocator.ts";
+import * as ProjectionStore from "./ProjectionStore.ts";
+import * as ProviderRuntimeRecovery from "./ProviderRuntimeRecoveryService.ts";
+
+it("uses the thread provider for stale background work without provider threads", async () => {
+  const threadId = ThreadId.make("thread_recovery_background_no_provider_threads");
+  const runId = RunId.make("run_recovery_background_no_provider_threads");
+  const itemId = TurnItemId.make("turn_item_recovery_background_no_provider_threads");
+  const providerInstanceId = ProviderInstanceId.make("codex");
+  let committedInput: Parameters<EventSink.EventSinkV2["Service"]["commitCommand"]>[0] | null =
+    null;
+  const projection = {
+    thread: { id: threadId, providerInstanceId },
+    runtimeRequests: [],
+    providerSessions: [],
+    providerThreads: [],
+    providerTurns: [],
+    runs: [{ id: runId, status: "completed", providerInstanceId }],
+    attempts: [],
+    nodes: [],
+    subagents: [],
+    messages: [],
+    turnItems: [
+      {
+        id: itemId,
+        runId: null,
+        nodeId: null,
+        providerThreadId: null,
+        type: "command_execution",
+        status: "running",
+      },
+    ],
+  } as unknown as OrchestrationV2ThreadProjection;
+  const layer = ProviderRuntimeRecovery.layer.pipe(
+    Layer.provide(
+      Layer.mergeAll(
+        Layer.mock(ProjectionStore.ProjectionStoreV2)({
+          getShellSnapshot: () =>
+            Effect.succeed({
+              schemaVersion: 2,
+              snapshotSequence: 0,
+              threads: [{ id: threadId }],
+              archivedThreads: [],
+            } as never),
+          getThreadProjection: () => Effect.succeed(projection),
+        }),
+        Layer.mock(EventSink.EventSinkV2)({
+          commitCommand: (input) => {
+            committedInput = input;
+            return Effect.succeed({ committed: true, cancelledEffectCount: 0 } as never);
+          },
+        }),
+        IdAllocator.layer,
+        Layer.mock(EffectWorker.OrchestrationEffectWorkerV2)({ runOnce: Effect.succeed(false) }),
+        Layer.mock(EffectOutbox.EffectOutboxV2)({
+          reconcileAfterProcessLoss: Effect.succeed({ requeued: 0, cancelled: 0 }),
+        }),
+      ),
+    ),
+  );
+
+  await Effect.gen(function* () {
+    yield* (yield* ProviderRuntimeRecovery.ProviderRuntimeRecoveryService).reconcile("startup");
+    const event = committedInput?.events.find(
+      (candidate) => candidate.type === "turn-item.updated",
+    );
+    expect(event?.providerInstanceId).toBe(providerInstanceId);
+    expect(event?.type === "turn-item.updated" ? event.payload.status : null).toBe("cancelled");
+  }).pipe(Effect.provide(layer), Effect.runPromise);
+});
diff --git a/apps/server/src/orchestration-v2/ProviderRuntimeRecoveryService.test.ts b/apps/server/src/orchestration-v2/ProviderRuntimeRecoveryService.test.ts
new file mode 100644
index 000000000000..8e8fe66253a9
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ProviderRuntimeRecoveryService.test.ts
@@ -0,0 +1,948 @@
+import { assert, it, vi } from "@effect/vitest";
+import {
+  MessageId,
+  NodeId,
+  ProviderDriverKind,
+  ProviderInstanceId,
+  ProviderSessionId,
+  ProviderThreadId,
+  ProviderTurnId,
+  RunAttemptId,
+  RunId,
+  RuntimeRequestId,
+  ThreadId,
+  TurnItemId,
+  type OrchestrationV2ThreadProjection,
+} from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Ref from "effect/Ref";
+
+import * as EffectWorker from "./EffectWorker.ts";
+import * as EffectOutbox from "./EffectOutbox.ts";
+import * as EventSink from "./EventSink.ts";
+import * as IdAllocator from "./IdAllocator.ts";
+import * as ProjectionStore from "./ProjectionStore.ts";
+import * as ProviderRuntimeRecovery from "./ProviderRuntimeRecoveryService.ts";
+
+it.effect("drains durable effects before reporting recovery complete", () =>
+  Effect.gen(function* () {
+    const runs = yield* Ref.make(0);
+    const layer = ProviderRuntimeRecovery.layer.pipe(
+      Layer.provide(
+        Layer.mergeAll(
+          Layer.mock(ProjectionStore.ProjectionStoreV2)({
+            getShellSnapshot: () =>
+              Effect.succeed({
+                schemaVersion: 2,
+                snapshotSequence: 0,
+                threads: [],
+                archivedThreads: [],
+              }),
+          }),
+          Layer.mock(EventSink.EventSinkV2)({}),
+          IdAllocator.layer,
+          Layer.mock(EffectWorker.OrchestrationEffectWorkerV2)({
+            runOnce: Ref.getAndUpdate(runs, (count) => count + 1).pipe(
+              Effect.map((count) => count < 2),
+            ),
+          }),
+          Layer.mock(EffectOutbox.EffectOutboxV2)({
+            reconcileAfterProcessLoss: Effect.succeed({ requeued: 0, cancelled: 0 }),
+          }),
+        ),
+      ),
+    );
+    const summary = yield* ProviderRuntimeRecovery.ProviderRuntimeRecoveryService.pipe(
+      Effect.flatMap((recovery) => recovery.recover),
+      Effect.provide(layer),
+    );
+    assert.deepEqual(summary, {
+      terminalizedRuns: 0,
+      stoppedSessions: 0,
+      closedRequests: 0,
+      retiredEffects: 0,
+      requeuedEffects: 0,
+      executedEffects: 2,
+    });
+  }),
+);
+
+it.effect("expires orphaned runtime requests before command readiness", () => {
+  const threadId = ThreadId.make("thread_recovery_requests");
+  let committedInput: Parameters<EventSink.EventSinkV2["Service"]["commitCommand"]>[0] | null =
+    null;
+  const committed = vi.fn(
+    (input: Parameters<EventSink.EventSinkV2["Service"]["commitCommand"]>[0]) => {
+      committedInput = input;
+      return Effect.succeed({ committed: true, cancelledEffectCount: 0 } as never);
+    },
+  );
+  const projection = {
+    thread: { id: threadId },
+    runtimeRequests: [
+      {
+        id: RuntimeRequestId.make("request_orphaned"),
+        nodeId: NodeId.make("node_orphaned"),
+        status: "pending",
+        responseCapability: { type: "not_resumable", reason: "old process" },
+      },
+    ],
+    providerSessions: [],
+    providerThreads: [],
+    runs: [],
+    nodes: [],
+  } as unknown as OrchestrationV2ThreadProjection;
+  const layer = ProviderRuntimeRecovery.layer.pipe(
+    Layer.provide(
+      Layer.mergeAll(
+        Layer.mock(ProjectionStore.ProjectionStoreV2)({
+          getShellSnapshot: () =>
+            Effect.succeed({
+              schemaVersion: 2,
+              snapshotSequence: 0,
+              threads: [{ id: threadId }],
+              archivedThreads: [],
+            } as never),
+          getThreadProjection: () => Effect.succeed(projection),
+        }),
+        Layer.mock(EventSink.EventSinkV2)({ commitCommand: committed }),
+        IdAllocator.layer,
+        Layer.mock(EffectWorker.OrchestrationEffectWorkerV2)({ runOnce: Effect.succeed(false) }),
+        Layer.mock(EffectOutbox.EffectOutboxV2)({
+          reconcileAfterProcessLoss: Effect.succeed({ requeued: 0, cancelled: 0 }),
+        }),
+      ),
+    ),
+  );
+  return Effect.gen(function* () {
+    yield* (yield* ProviderRuntimeRecovery.ProviderRuntimeRecoveryService).recover;
+    const command = committedInput;
+    assert.isNotNull(command);
+    if (command === null) return;
+    assert.equal(command?.events[0]?.type, "runtime-request.updated");
+    if (command?.events[0]?.type === "runtime-request.updated") {
+      assert.equal(command.events[0].payload.status, "expired");
+      assert.equal(command.events[0].payload.responseCapability.type, "not_resumable");
+    }
+  }).pipe(Effect.provide(layer));
+});
+
+it.effect("uses the same reconciliation path to cancel runtime requests during shutdown", () => {
+  const threadId = ThreadId.make("thread_shutdown_requests");
+  let committedInput: Parameters<EventSink.EventSinkV2["Service"]["commitCommand"]>[0] | null =
+    null;
+  const projection = {
+    thread: { id: threadId },
+    runtimeRequests: [
+      {
+        id: RuntimeRequestId.make("request_shutdown"),
+        nodeId: NodeId.make("node_shutdown"),
+        status: "pending",
+        responseCapability: { type: "live" },
+      },
+    ],
+    providerSessions: [],
+    providerThreads: [],
+    runs: [],
+    nodes: [],
+  } as unknown as OrchestrationV2ThreadProjection;
+  const layer = ProviderRuntimeRecovery.layer.pipe(
+    Layer.provide(
+      Layer.mergeAll(
+        Layer.mock(ProjectionStore.ProjectionStoreV2)({
+          getShellSnapshot: () =>
+            Effect.succeed({
+              schemaVersion: 2,
+              snapshotSequence: 0,
+              threads: [{ id: threadId }],
+              archivedThreads: [],
+            } as never),
+          getThreadProjection: () => Effect.succeed(projection),
+        }),
+        Layer.mock(EventSink.EventSinkV2)({
+          commitCommand: (input) => {
+            committedInput = input;
+            return Effect.succeed({ committed: true, cancelledEffectCount: 1 } as never);
+          },
+        }),
+        IdAllocator.layer,
+        Layer.mock(EffectWorker.OrchestrationEffectWorkerV2)({ runOnce: Effect.succeed(false) }),
+        Layer.mock(EffectOutbox.EffectOutboxV2)({
+          reconcileAfterProcessLoss: Effect.succeed({ requeued: 0, cancelled: 0 }),
+        }),
+      ),
+    ),
+  );
+
+  return Effect.gen(function* () {
+    const summary =
+      yield* (yield* ProviderRuntimeRecovery.ProviderRuntimeRecoveryService).reconcile("shutdown");
+    assert.equal(summary.closedRequests, 1);
+    assert.equal(summary.retiredEffects, 1);
+    const requestEvent = committedInput?.events[0];
+    assert.equal(requestEvent?.type, "runtime-request.updated");
+    if (requestEvent?.type === "runtime-request.updated") {
+      assert.equal(requestEvent.payload.status, "cancelled");
+      assert.equal(requestEvent.payload.responseCapability.type, "not_resumable");
+      if (requestEvent.payload.responseCapability.type === "not_resumable") {
+        assert.match(requestEvent.payload.responseCapability.reason, /shut down/);
+      }
+    }
+  }).pipe(Effect.provide(layer));
+});
+
+it.effect(
+  "preserves a replayable waiting run while cancelling its process-bound background work",
+  () => {
+    const threadId = ThreadId.make("thread_waiting_checkpoint");
+    const runId = RunId.make("run_waiting_checkpoint");
+    const providerThreadId = ProviderThreadId.make("provider_thread_waiting_checkpoint");
+    const providerInstanceId = ProviderInstanceId.make("claude");
+    const backgroundItemId = TurnItemId.make("turn_item_waiting_checkpoint");
+    let committedInput: Parameters<EventSink.EventSinkV2["Service"]["commitCommand"]>[0] | null =
+      null;
+    const projection = {
+      thread: { id: threadId },
+      runtimeRequests: [],
+      providerSessions: [],
+      providerThreads: [
+        {
+          id: providerThreadId,
+          driver: ProviderDriverKind.make("claude"),
+          providerInstanceId,
+          status: "idle",
+          pendingBackgroundTasks: [
+            { taskId: String(backgroundItemId), description: "Finish background task" },
+          ],
+        },
+      ],
+      runs: [{ id: runId, status: "waiting", providerInstanceId }],
+      attempts: [],
+      nodes: [],
+      subagents: [],
+      messages: [],
+      turnItems: [
+        {
+          id: backgroundItemId,
+          runId,
+          nodeId: null,
+          providerThreadId,
+          type: "command_execution",
+          status: "running",
+        },
+      ],
+    } as unknown as OrchestrationV2ThreadProjection;
+    const layer = ProviderRuntimeRecovery.layer.pipe(
+      Layer.provide(
+        Layer.mergeAll(
+          Layer.mock(ProjectionStore.ProjectionStoreV2)({
+            getShellSnapshot: () =>
+              Effect.succeed({
+                schemaVersion: 2,
+                snapshotSequence: 0,
+                threads: [{ id: threadId }],
+                archivedThreads: [],
+              } as never),
+            getThreadProjection: () => Effect.succeed(projection),
+          }),
+          Layer.mock(EventSink.EventSinkV2)({
+            commitCommand: (input) => {
+              committedInput = input;
+              return Effect.succeed({
+                committed: true,
+                cancelledEffectCount: 0,
+              } as never);
+            },
+          }),
+          IdAllocator.layer,
+          Layer.mock(EffectWorker.OrchestrationEffectWorkerV2)({ runOnce: Effect.succeed(false) }),
+          Layer.mock(EffectOutbox.EffectOutboxV2)({
+            listByCommandId: () =>
+              Effect.succeed([
+                {
+                  request: { type: "checkpoint.capture", runId },
+                  status: "running",
+                },
+              ] as never),
+            reconcileAfterProcessLoss: Effect.succeed({ requeued: 1, cancelled: 0 }),
+          }),
+        ),
+      ),
+    );
+
+    return Effect.gen(function* () {
+      const summary =
+        yield* (yield* ProviderRuntimeRecovery.ProviderRuntimeRecoveryService).reconcile("startup");
+      assert.equal(summary.terminalizedRuns, 0);
+      assert.equal(summary.requeuedEffects, 1);
+
+      const command = committedInput;
+      assert.isNotNull(command);
+      if (command === null) return;
+      assert.isFalse(command.events.some((event) => event.type === "run.updated"));
+      assert.isTrue(
+        command.events.some(
+          (event) =>
+            event.type === "turn-item.updated" &&
+            event.payload.id === backgroundItemId &&
+            event.payload.status === "cancelled",
+        ),
+      );
+      assert.isTrue(
+        command.events.some(
+          (event) =>
+            event.type === "provider-thread.updated" &&
+            event.payload.id === providerThreadId &&
+            event.payload.pendingBackgroundTasks?.length === 0,
+        ),
+      );
+    }).pipe(Effect.provide(layer));
+  },
+);
+
+it.effect("cancels a stale waiting run when no checkpoint capture can finish it", () => {
+  const threadId = ThreadId.make("thread_stale_waiting");
+  const runId = RunId.make("run_stale_waiting");
+  let committedInput: Parameters<EventSink.EventSinkV2["Service"]["commitCommand"]>[0] | null =
+    null;
+  const projection = {
+    thread: { id: threadId },
+    runtimeRequests: [],
+    providerSessions: [],
+    providerThreads: [],
+    providerTurns: [],
+    runs: [
+      {
+        id: runId,
+        status: "waiting",
+        providerInstanceId: ProviderInstanceId.make("codex"),
+      },
+    ],
+    attempts: [],
+    nodes: [],
+    subagents: [],
+    messages: [],
+    turnItems: [],
+  } as unknown as OrchestrationV2ThreadProjection;
+  const layer = ProviderRuntimeRecovery.layer.pipe(
+    Layer.provide(
+      Layer.mergeAll(
+        Layer.mock(ProjectionStore.ProjectionStoreV2)({
+          getShellSnapshot: () =>
+            Effect.succeed({
+              schemaVersion: 2,
+              snapshotSequence: 0,
+              threads: [{ id: threadId }],
+              archivedThreads: [],
+            } as never),
+          getThreadProjection: () => Effect.succeed(projection),
+        }),
+        Layer.mock(EventSink.EventSinkV2)({
+          commitCommand: (input) => {
+            committedInput = input;
+            return Effect.succeed({ committed: true, cancelledEffectCount: 0 } as never);
+          },
+        }),
+        IdAllocator.layer,
+        Layer.mock(EffectWorker.OrchestrationEffectWorkerV2)({ runOnce: Effect.succeed(false) }),
+        Layer.mock(EffectOutbox.EffectOutboxV2)({
+          listByCommandId: () => Effect.succeed([]),
+          reconcileAfterProcessLoss: Effect.succeed({ requeued: 0, cancelled: 0 }),
+        }),
+      ),
+    ),
+  );
+
+  return Effect.gen(function* () {
+    const summary =
+      yield* (yield* ProviderRuntimeRecovery.ProviderRuntimeRecoveryService).reconcile("startup");
+    assert.equal(summary.terminalizedRuns, 1);
+    const runEvent = committedInput?.events.find((event) => event.type === "run.updated");
+    assert.equal(runEvent?.type === "run.updated" ? runEvent.payload.status : null, "cancelled");
+  }).pipe(Effect.provide(layer));
+});
+
+it.effect("cancels accepted queued work instead of replaying it after restart", () => {
+  const threadId = ThreadId.make("thread_queued_restart");
+  const runId = RunId.make("run_queued_restart");
+  const attemptId = RunAttemptId.make("attempt_queued_restart");
+  const rootNodeId = NodeId.make("node_queued_restart");
+  let committedInput: Parameters<EventSink.EventSinkV2["Service"]["commitCommand"]>[0] | null =
+    null;
+  const projection = {
+    thread: { id: threadId },
+    runtimeRequests: [],
+    providerSessions: [],
+    providerThreads: [],
+    providerTurns: [],
+    runs: [
+      {
+        id: runId,
+        status: "queued",
+        queuePosition: 1,
+        providerInstanceId: ProviderInstanceId.make("codex"),
+      },
+    ],
+    attempts: [
+      {
+        id: attemptId,
+        runId,
+        rootNodeId,
+        status: "pending",
+      },
+    ],
+    nodes: [
+      {
+        id: rootNodeId,
+        runId,
+        status: "pending",
+      },
+    ],
+    subagents: [],
+    messages: [],
+    turnItems: [],
+  } as unknown as OrchestrationV2ThreadProjection;
+  const layer = ProviderRuntimeRecovery.layer.pipe(
+    Layer.provide(
+      Layer.mergeAll(
+        Layer.mock(ProjectionStore.ProjectionStoreV2)({
+          getShellSnapshot: () =>
+            Effect.succeed({
+              schemaVersion: 2,
+              snapshotSequence: 0,
+              threads: [{ id: threadId }],
+              archivedThreads: [],
+            } as never),
+          getThreadProjection: () => Effect.succeed(projection),
+        }),
+        Layer.mock(EventSink.EventSinkV2)({
+          commitCommand: (input) => {
+            committedInput = input;
+            return Effect.succeed({ committed: true, cancelledEffectCount: 0 } as never);
+          },
+        }),
+        IdAllocator.layer,
+        Layer.mock(EffectWorker.OrchestrationEffectWorkerV2)({ runOnce: Effect.succeed(false) }),
+        Layer.mock(EffectOutbox.EffectOutboxV2)({
+          reconcileAfterProcessLoss: Effect.succeed({ requeued: 0, cancelled: 0 }),
+        }),
+      ),
+    ),
+  );
+
+  return Effect.gen(function* () {
+    const summary =
+      yield* (yield* ProviderRuntimeRecovery.ProviderRuntimeRecoveryService).reconcile("startup");
+    assert.equal(summary.terminalizedRuns, 1);
+    const command = committedInput;
+    assert.isNotNull(command);
+    if (command === null) return;
+    const runEvent = command.events.find((event) => event.type === "run.updated");
+    const attemptEvent = command.events.find((event) => event.type === "run-attempt.updated");
+    const nodeEvent = command.events.find((event) => event.type === "node.updated");
+    assert.equal(runEvent?.type === "run.updated" ? runEvent.payload.status : null, "cancelled");
+    assert.equal(runEvent?.type === "run.updated" ? runEvent.payload.queuePosition : 1, null);
+    assert.equal(
+      attemptEvent?.type === "run-attempt.updated" ? attemptEvent.payload.status : null,
+      "cancelled",
+    );
+    assert.equal(nodeEvent?.type === "node.updated" ? nodeEvent.payload.status : null, "cancelled");
+  }).pipe(Effect.provide(layer));
+});
+
+it.effect(
+  "cancels the complete in-flight subtree and stops its persisted session without reopening it",
+  () => {
+    const threadId = ThreadId.make("thread_recovery_cancel");
+    const runId = RunId.make("run_recovery_cancel");
+    const attemptId = RunAttemptId.make("attempt_recovery_cancel");
+    const rootNodeId = NodeId.make("node_recovery_cancel");
+    const providerThreadId = ProviderThreadId.make("provider_thread_recovery_cancel");
+    const providerTurnId = ProviderTurnId.make("provider_turn_recovery_cancel");
+    const providerSessionId = ProviderSessionId.make("provider_session_recovery_cancel");
+    let committedInput: Parameters<EventSink.EventSinkV2["Service"]["commitCommand"]>[0] | null =
+      null;
+    const projection = {
+      thread: { id: threadId },
+      runtimeRequests: [],
+      providerSessions: [
+        {
+          id: providerSessionId,
+          driver: ProviderDriverKind.make("codex"),
+          providerInstanceId: ProviderInstanceId.make("codex"),
+          status: "ready",
+        },
+      ],
+      providerThreads: [
+        {
+          id: providerThreadId,
+          driver: ProviderDriverKind.make("codex"),
+          providerInstanceId: ProviderInstanceId.make("codex"),
+          status: "active",
+        },
+      ],
+      providerTurns: [
+        {
+          id: providerTurnId,
+          runAttemptId: attemptId,
+          nodeId: rootNodeId,
+          status: "running",
+        },
+      ],
+      runs: [
+        {
+          id: runId,
+          status: "starting",
+          providerThreadId,
+          providerInstanceId: ProviderInstanceId.make("codex"),
+        },
+      ],
+      attempts: [
+        {
+          id: attemptId,
+          runId,
+          rootNodeId,
+          status: "running",
+        },
+      ],
+      nodes: [{ id: rootNodeId, runId, status: "running" }],
+      subagents: [],
+      messages: [{ id: MessageId.make("message_recovery_cancel"), runId, streaming: true }],
+      turnItems: [
+        {
+          id: TurnItemId.make("turn_item_recovery_cancel"),
+          runId,
+          nodeId: rootNodeId,
+          status: "running",
+        },
+      ],
+    } as unknown as OrchestrationV2ThreadProjection;
+    const layer = ProviderRuntimeRecovery.layer.pipe(
+      Layer.provide(
+        Layer.mergeAll(
+          Layer.mock(ProjectionStore.ProjectionStoreV2)({
+            getShellSnapshot: () =>
+              Effect.succeed({
+                schemaVersion: 2,
+                snapshotSequence: 0,
+                threads: [{ id: threadId }],
+                archivedThreads: [],
+              } as never),
+            getThreadProjection: () => Effect.succeed(projection),
+          }),
+          Layer.mock(EventSink.EventSinkV2)({
+            commitCommand: (input) => {
+              committedInput = input;
+              return Effect.succeed({ committed: true, cancelledEffectCount: 2 } as never);
+            },
+          }),
+          IdAllocator.layer,
+          Layer.mock(EffectWorker.OrchestrationEffectWorkerV2)({ runOnce: Effect.succeed(false) }),
+          Layer.mock(EffectOutbox.EffectOutboxV2)({
+            reconcileAfterProcessLoss: Effect.succeed({ requeued: 0, cancelled: 0 }),
+          }),
+        ),
+      ),
+    );
+
+    return Effect.gen(function* () {
+      const summary = yield* (yield* ProviderRuntimeRecovery.ProviderRuntimeRecoveryService)
+        .recover;
+      assert.equal(summary.terminalizedRuns, 1);
+      assert.equal(summary.stoppedSessions, 1);
+      assert.equal(summary.retiredEffects, 2);
+      assert.deepEqual(committedInput?.cancelUnsettledEffects?.effectTypes, [
+        "provider-turn.start",
+        "provider-turn.interrupt",
+        "provider-turn.steer",
+        "provider-turn.restart",
+        "runtime-request.respond",
+      ]);
+      const events = committedInput?.events ?? [];
+      assert.deepEqual(
+        events.map((event) => [
+          event.type,
+          "status" in event.payload ? event.payload.status : null,
+        ]),
+        [
+          ["run.updated", "cancelled"],
+          ["run-attempt.updated", "cancelled"],
+          ["node.updated", "cancelled"],
+          ["provider-turn.updated", "cancelled"],
+          ["message.updated", null],
+          ["turn-item.updated", "cancelled"],
+          ["provider-thread.updated", "idle"],
+          ["provider-session.updated", "stopped"],
+        ],
+      );
+      const messageEvent = events.find((event) => event.type === "message.updated");
+      assert.isFalse(messageEvent?.type === "message.updated" && messageEvent.payload.streaming);
+    }).pipe(Effect.provide(layer));
+  },
+);
+
+it.effect(
+  "clears persisted pendingBackgroundTasks and terminalizes stale background items on settled runs",
+  () => {
+    const threadId = ThreadId.make("thread_recovery_background");
+    const settledRunId = RunId.make("run_recovery_background_settled");
+    const activeRunId = RunId.make("run_recovery_background_active");
+    const activeAttemptId = RunAttemptId.make("attempt_recovery_background_active");
+    const activeRootNodeId = NodeId.make("node_recovery_background_active");
+    const idleProviderThreadId = ProviderThreadId.make("provider_thread_recovery_background_idle");
+    const activeProviderThreadId = ProviderThreadId.make(
+      "provider_thread_recovery_background_active",
+    );
+    const secondaryProviderThreadId = ProviderThreadId.make(
+      "provider_thread_recovery_background_secondary",
+    );
+    const providerSessionId = ProviderSessionId.make("provider_session_recovery_background");
+    const settledStaleItemId = TurnItemId.make("turn_item_recovery_background_stale");
+    const activeRunItemId = TurnItemId.make("turn_item_recovery_background_active");
+    const nullRunCommandItemId = TurnItemId.make("turn_item_recovery_background_null_run");
+    const nullRunSubagentItemId = TurnItemId.make("turn_item_recovery_background_null_subagent");
+    const claudeInstanceId = ProviderInstanceId.make("claude");
+    const secondaryInstanceId = ProviderInstanceId.make("claude-secondary");
+    const subagentInstanceId = ProviderInstanceId.make("claude-subagent");
+    let committedInput: Parameters<EventSink.EventSinkV2["Service"]["commitCommand"]>[0] | null =
+      null;
+    const projection = {
+      thread: { id: threadId },
+      runtimeRequests: [],
+      providerSessions: [
+        {
+          id: providerSessionId,
+          driver: ProviderDriverKind.make("claude"),
+          providerInstanceId: claudeInstanceId,
+          status: "ready",
+        },
+      ],
+      providerThreads: [
+        {
+          id: idleProviderThreadId,
+          driver: ProviderDriverKind.make("claude"),
+          // Index-0 is intentionally a different instance so misattribution
+          // to providerThreads[0] fails the assertions below.
+          providerInstanceId: claudeInstanceId,
+          status: "idle",
+          pendingBackgroundTasks: [{ taskId: "bg-settled", description: "sleep 30" }],
+        },
+        {
+          id: activeProviderThreadId,
+          driver: ProviderDriverKind.make("claude"),
+          providerInstanceId: claudeInstanceId,
+          status: "active",
+          pendingBackgroundTasks: [{ taskId: "bg-active", description: "npm test" }],
+        },
+        {
+          id: secondaryProviderThreadId,
+          driver: ProviderDriverKind.make("claude"),
+          providerInstanceId: secondaryInstanceId,
+          status: "idle",
+          pendingBackgroundTasks: [],
+        },
+      ],
+      providerTurns: [],
+      runs: [
+        {
+          id: settledRunId,
+          status: "completed",
+          providerInstanceId: claudeInstanceId,
+        },
+        {
+          id: activeRunId,
+          status: "running",
+          providerInstanceId: claudeInstanceId,
+        },
+      ],
+      attempts: [
+        {
+          id: activeAttemptId,
+          runId: activeRunId,
+          rootNodeId: activeRootNodeId,
+          status: "running",
+        },
+      ],
+      nodes: [{ id: activeRootNodeId, runId: activeRunId, status: "running" }],
+      subagents: [],
+      messages: [],
+      turnItems: [
+        {
+          id: settledStaleItemId,
+          runId: settledRunId,
+          nodeId: null,
+          providerThreadId: idleProviderThreadId,
+          type: "command_execution",
+          status: "running",
+        },
+        {
+          id: activeRunItemId,
+          runId: activeRunId,
+          nodeId: activeRootNodeId,
+          providerThreadId: activeProviderThreadId,
+          type: "dynamic_tool",
+          status: "running",
+        },
+        {
+          // Missing run: must attribute via providerThreadId, not index 0.
+          id: nullRunCommandItemId,
+          runId: null,
+          nodeId: null,
+          providerThreadId: secondaryProviderThreadId,
+          type: "command_execution",
+          status: "running",
+        },
+        {
+          // Missing run with a real matching provider thread whose instance
+          // differs from the subagent's own: own providerInstanceId must win.
+          id: nullRunSubagentItemId,
+          runId: null,
+          nodeId: null,
+          providerThreadId: secondaryProviderThreadId,
+          type: "subagent",
+          status: "running",
+          providerInstanceId: subagentInstanceId,
+        },
+      ],
+    } as unknown as OrchestrationV2ThreadProjection;
+    const layer = ProviderRuntimeRecovery.layer.pipe(
+      Layer.provide(
+        Layer.mergeAll(
+          Layer.mock(ProjectionStore.ProjectionStoreV2)({
+            getShellSnapshot: () =>
+              Effect.succeed({
+                schemaVersion: 2,
+                snapshotSequence: 0,
+                threads: [{ id: threadId }],
+                archivedThreads: [],
+              } as never),
+            getThreadProjection: () => Effect.succeed(projection),
+          }),
+          Layer.mock(EventSink.EventSinkV2)({
+            commitCommand: (input) => {
+              committedInput = input;
+              return Effect.succeed({ committed: true, cancelledEffectCount: 0 } as never);
+            },
+          }),
+          IdAllocator.layer,
+          Layer.mock(EffectWorker.OrchestrationEffectWorkerV2)({ runOnce: Effect.succeed(false) }),
+          Layer.mock(EffectOutbox.EffectOutboxV2)({
+            listByCommandId: () => Effect.succeed([]),
+            reconcileAfterProcessLoss: Effect.succeed({ requeued: 0, cancelled: 0 }),
+          }),
+        ),
+      ),
+    );
+
+    return Effect.gen(function* () {
+      const summary =
+        yield* (yield* ProviderRuntimeRecovery.ProviderRuntimeRecoveryService).reconcile("startup");
+      assert.equal(summary.terminalizedRuns, 1);
+      const events = committedInput?.events ?? [];
+
+      const turnItemCancels = events.filter(
+        (event) => event.type === "turn-item.updated" && event.payload.status === "cancelled",
+      );
+      // Active-run item + settled-run stale + null-run command + null-run subagent.
+      assert.equal(turnItemCancels.length, 4);
+      assert.deepEqual(
+        turnItemCancels
+          .map((event) => event.type === "turn-item.updated" && event.payload.id)
+          .sort(),
+        [activeRunItemId, nullRunCommandItemId, nullRunSubagentItemId, settledStaleItemId].sort(),
+      );
+
+      const cancelById = (id: TurnItemId) =>
+        turnItemCancels.find(
+          (event) => event.type === "turn-item.updated" && event.payload.id === id,
+        );
+      assert.equal(cancelById(nullRunCommandItemId)?.providerInstanceId, secondaryInstanceId);
+      // Subagent own instance wins over the matching thread's secondary instance.
+      assert.notEqual(subagentInstanceId, secondaryInstanceId);
+      assert.equal(cancelById(nullRunSubagentItemId)?.providerInstanceId, subagentInstanceId);
+      // Settled-run item still prefers the run's provider instance when present.
+      assert.equal(cancelById(settledStaleItemId)?.providerInstanceId, claudeInstanceId);
+
+      const providerThreadEvents = events.filter(
+        (event) => event.type === "provider-thread.updated",
+      );
+      // Only threads with active status or nonempty rosters are rewritten.
+      assert.equal(providerThreadEvents.length, 2);
+      for (const event of providerThreadEvents) {
+        if (event.type !== "provider-thread.updated") continue;
+        assert.deepEqual(event.payload.pendingBackgroundTasks ?? [], []);
+      }
+      const idleThreadEvent = providerThreadEvents.find(
+        (event) =>
+          event.type === "provider-thread.updated" && event.payload.id === idleProviderThreadId,
+      );
+      assert.equal(
+        idleThreadEvent?.type === "provider-thread.updated" ? idleThreadEvent.payload.status : null,
+        "idle",
+      );
+      const activeThreadEvent = providerThreadEvents.find(
+        (event) =>
+          event.type === "provider-thread.updated" && event.payload.id === activeProviderThreadId,
+      );
+      assert.equal(
+        activeThreadEvent?.type === "provider-thread.updated"
+          ? activeThreadEvent.payload.status
+          : null,
+        "idle",
+      );
+    }).pipe(Effect.provide(layer));
+  },
+);
+
+it.effect(
+  "terminalizes the linked subagent and node for a stale subagent item on a settled run",
+  () => {
+    const threadId = ThreadId.make("thread_recovery_subagent");
+    const settledRunId = RunId.make("run_recovery_subagent_settled");
+    const providerThreadId = ProviderThreadId.make("provider_thread_recovery_subagent");
+    const staleSubagentNodeId = NodeId.make("node_recovery_subagent_stale");
+    const doneSubagentNodeId = NodeId.make("node_recovery_subagent_done");
+    const staleItemId = TurnItemId.make("turn_item_recovery_subagent_stale");
+    const doneItemId = TurnItemId.make("turn_item_recovery_subagent_done");
+    const claudeInstanceId = ProviderInstanceId.make("claude");
+    let committedInput: Parameters<EventSink.EventSinkV2["Service"]["commitCommand"]>[0] | null =
+      null;
+    const projection = {
+      thread: { id: threadId },
+      runtimeRequests: [],
+      providerSessions: [],
+      providerThreads: [
+        {
+          id: providerThreadId,
+          driver: ProviderDriverKind.make("claude"),
+          providerInstanceId: claudeInstanceId,
+          status: "idle",
+          pendingBackgroundTasks: [],
+        },
+      ],
+      providerTurns: [],
+      // Settled run: the stale-item loop owns it, not the nonterminal loop.
+      runs: [{ id: settledRunId, status: "completed", providerInstanceId: claudeInstanceId }],
+      attempts: [],
+      nodes: [
+        { id: staleSubagentNodeId, runId: settledRunId, status: "running" },
+        { id: doneSubagentNodeId, runId: settledRunId, status: "completed" },
+      ],
+      subagents: [
+        {
+          id: staleSubagentNodeId,
+          runId: settledRunId,
+          driver: ProviderDriverKind.make("claude"),
+          providerInstanceId: claudeInstanceId,
+          status: "running",
+        },
+        {
+          // Already finished with a real result: must never be overwritten.
+          id: doneSubagentNodeId,
+          runId: settledRunId,
+          driver: ProviderDriverKind.make("claude"),
+          providerInstanceId: claudeInstanceId,
+          status: "completed",
+          result: "done",
+        },
+      ],
+      messages: [],
+      turnItems: [
+        {
+          id: staleItemId,
+          runId: settledRunId,
+          nodeId: staleSubagentNodeId,
+          providerThreadId,
+          type: "subagent",
+          status: "running",
+          subagentId: staleSubagentNodeId,
+          providerInstanceId: claudeInstanceId,
+        },
+        {
+          id: doneItemId,
+          runId: settledRunId,
+          nodeId: doneSubagentNodeId,
+          providerThreadId,
+          type: "subagent",
+          status: "completed",
+          subagentId: doneSubagentNodeId,
+          providerInstanceId: claudeInstanceId,
+        },
+      ],
+    } as unknown as OrchestrationV2ThreadProjection;
+    const layer = ProviderRuntimeRecovery.layer.pipe(
+      Layer.provide(
+        Layer.mergeAll(
+          Layer.mock(ProjectionStore.ProjectionStoreV2)({
+            getShellSnapshot: () =>
+              Effect.succeed({
+                schemaVersion: 2,
+                snapshotSequence: 0,
+                threads: [{ id: threadId }],
+                archivedThreads: [],
+              } as never),
+            getThreadProjection: () => Effect.succeed(projection),
+          }),
+          Layer.mock(EventSink.EventSinkV2)({
+            commitCommand: (input) => {
+              committedInput = input;
+              return Effect.succeed({ committed: true, cancelledEffectCount: 0 } as never);
+            },
+          }),
+          IdAllocator.layer,
+          Layer.mock(EffectWorker.OrchestrationEffectWorkerV2)({ runOnce: Effect.succeed(false) }),
+          Layer.mock(EffectOutbox.EffectOutboxV2)({
+            listByCommandId: () => Effect.succeed([]),
+            reconcileAfterProcessLoss: Effect.succeed({ requeued: 0, cancelled: 0 }),
+          }),
+        ),
+      ),
+    );
+
+    return Effect.gen(function* () {
+      yield* (yield* ProviderRuntimeRecovery.ProviderRuntimeRecoveryService).reconcile("startup");
+      const events = committedInput?.events ?? [];
+
+      // Only the nonterminal subagent item is cancelled.
+      const turnItemCancels = events.filter(
+        (event) => event.type === "turn-item.updated" && event.payload.status === "cancelled",
+      );
+      assert.equal(turnItemCancels.length, 1);
+
+      // The linked subagent entity is terminalized alongside its turn item.
+      const subagentCancels = events.filter((event) => event.type === "subagent.updated");
+      assert.equal(subagentCancels.length, 1);
+      const subagentCancel = subagentCancels[0];
+      assert.equal(
+        subagentCancel?.type === "subagent.updated" ? subagentCancel.payload.id : null,
+        staleSubagentNodeId,
+      );
+      assert.equal(
+        subagentCancel?.type === "subagent.updated" ? subagentCancel.payload.status : null,
+        "cancelled",
+      );
+
+      // So is its execution node, which no live process can terminalize.
+      const nodeCancels = events.filter((event) => event.type === "node.updated");
+      assert.equal(nodeCancels.length, 1);
+      const nodeCancel = nodeCancels[0];
+      assert.equal(
+        nodeCancel?.type === "node.updated" ? nodeCancel.payload.id : null,
+        staleSubagentNodeId,
+      );
+
+      // The already-completed subagent and node are left untouched.
+      assert.isFalse(
+        events.some(
+          (event) => event.type === "subagent.updated" && event.payload.id === doneSubagentNodeId,
+        ),
+      );
+      assert.isFalse(
+        events.some(
+          (event) => event.type === "node.updated" && event.payload.id === doneSubagentNodeId,
+        ),
+      );
+    }).pipe(Effect.provide(layer));
+  },
+);
diff --git a/apps/server/src/orchestration-v2/ProviderRuntimeRecoveryService.ts b/apps/server/src/orchestration-v2/ProviderRuntimeRecoveryService.ts
new file mode 100644
index 000000000000..b9a851980568
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ProviderRuntimeRecoveryService.ts
@@ -0,0 +1,532 @@
+import {
+  CommandId,
+  type OrchestrationV2DomainEvent,
+  type OrchestrationV2ThreadProjection,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as Context from "effect/Context";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Schema from "effect/Schema";
+
+import * as EffectWorker from "./EffectWorker.ts";
+import * as EffectOutbox from "./EffectOutbox.ts";
+import * as EventSink from "./EventSink.ts";
+import * as IdAllocator from "./IdAllocator.ts";
+import * as ProjectionStore from "./ProjectionStore.ts";
+
+export class ProviderRuntimeRecoveryError extends Schema.TaggedErrorClass<ProviderRuntimeRecoveryError>()(
+  "ProviderRuntimeRecoveryError",
+  {
+    operation: Schema.Literals(["read-projections", "reconcile", "drain-outbox"]),
+    threadId: Schema.optional(ThreadId),
+    cause: Schema.Defect(),
+  },
+) {
+  override get message(): string {
+    return `Provider runtime recovery failed during ${this.operation}.`;
+  }
+}
+
+export interface ProviderRuntimeRecoverySummary {
+  readonly terminalizedRuns: number;
+  readonly stoppedSessions: number;
+  readonly closedRequests: number;
+  readonly retiredEffects: number;
+  readonly requeuedEffects: number;
+  readonly executedEffects: number;
+}
+
+export interface ProviderRuntimeReconciliationSummary {
+  readonly terminalizedRuns: number;
+  readonly stoppedSessions: number;
+  readonly closedRequests: number;
+  readonly retiredEffects: number;
+  readonly requeuedEffects: number;
+}
+
+export class ProviderRuntimeRecoveryService extends Context.Service<
+  ProviderRuntimeRecoveryService,
+  {
+    readonly reconcile: (
+      trigger: "startup" | "shutdown",
+    ) => Effect.Effect<ProviderRuntimeReconciliationSummary, ProviderRuntimeRecoveryError>;
+    readonly recover: Effect.Effect<ProviderRuntimeRecoverySummary, ProviderRuntimeRecoveryError>;
+  }
+>()("t3/orchestration-v2/ProviderRuntimeRecoveryService") {}
+
+function nonterminalRuns(projection: OrchestrationV2ThreadProjection) {
+  return projection.runs.filter((run) => {
+    const status: string = run.status;
+    return (
+      run.status === "queued" ||
+      status === "preparing" ||
+      run.status === "starting" ||
+      run.status === "running" ||
+      run.status === "waiting"
+    );
+  });
+}
+
+function isBackgroundCapableTurnItemType(type: string): boolean {
+  return type === "command_execution" || type === "dynamic_tool" || type === "subagent";
+}
+
+function isNonterminalTurnItemStatus(status: string): boolean {
+  return status === "pending" || status === "running" || status === "waiting";
+}
+
+function isNonterminalSubagentStatus(status: string): boolean {
+  return status === "pending" || status === "running" || status === "waiting";
+}
+
+function isNonterminalNodeStatus(status: string): boolean {
+  return status === "pending" || status === "running" || status === "waiting";
+}
+
+function providerThreadHasPendingBackgroundTasks(
+  providerThread: OrchestrationV2ThreadProjection["providerThreads"][number],
+): boolean {
+  return (providerThread.pendingBackgroundTasks?.length ?? 0) > 0;
+}
+
+/**
+ * Resolve providerInstanceId for a stale background-capable turn item whose
+ * run is missing/null (or not found). Prefer an existing run, then a subagent
+ * item's own instance id, then the item's provider thread, then a last-resort
+ * first provider thread, then the thread's selected provider.
+ */
+function resolveStaleBackgroundItemProviderInstanceId(
+  item: OrchestrationV2ThreadProjection["turnItems"][number],
+  projection: OrchestrationV2ThreadProjection,
+): OrchestrationV2ThreadProjection["thread"]["providerInstanceId"] {
+  if (item.runId !== null) {
+    const run = projection.runs.find((candidate) => candidate.id === item.runId);
+    if (run !== undefined) {
+      return run.providerInstanceId;
+    }
+  }
+  if (item.type === "subagent") {
+    return item.providerInstanceId;
+  }
+  if (item.providerThreadId !== null && item.providerThreadId !== undefined) {
+    const providerThread = projection.providerThreads.find(
+      (candidate) => candidate.id === item.providerThreadId,
+    );
+    if (providerThread !== undefined) {
+      return providerThread.providerInstanceId;
+    }
+  }
+  return projection.providerThreads[0]?.providerInstanceId ?? projection.thread.providerInstanceId;
+}
+
+export const make = Effect.gen(function* () {
+  const projections = yield* ProjectionStore.ProjectionStoreV2;
+  const eventSink = yield* EventSink.EventSinkV2;
+  const ids = yield* IdAllocator.IdAllocatorV2;
+  const worker = yield* EffectWorker.OrchestrationEffectWorkerV2;
+  const outbox = yield* EffectOutbox.EffectOutboxV2;
+  const reconcileProjection = Effect.fn("ProviderRuntimeRecoveryService.reconcileProjection")(
+    function* (projection: OrchestrationV2ThreadProjection, trigger: "startup" | "shutdown") {
+      const now = yield* DateTime.now;
+      const runs = [] as Array<OrchestrationV2ThreadProjection["runs"][number]>;
+      for (const run of nonterminalRuns(projection)) {
+        if (run.status === "waiting") {
+          const checkpointEffects = yield* outbox
+            .listByCommandId(CommandId.make(`command:effect:checkpoint.capture:${run.id}`))
+            .pipe(
+              Effect.mapError(
+                (cause) =>
+                  new ProviderRuntimeRecoveryError({
+                    operation: "reconcile",
+                    threadId: projection.thread.id,
+                    cause,
+                  }),
+              ),
+            );
+          const hasReplayableCheckpoint = checkpointEffects.some(
+            (effect) =>
+              effect.request.type === "checkpoint.capture" &&
+              effect.request.runId === run.id &&
+              (effect.status === "pending" || effect.status === "running"),
+          );
+          if (hasReplayableCheckpoint) continue;
+        }
+        runs.push(run);
+      }
+      const requests = projection.runtimeRequests.filter((request) => request.status === "pending");
+      const detail = `Cancelled because the server ${trigger === "startup" ? "restarted" : "shut down"} before the provider work completed.`;
+      const commandId = CommandId.make(
+        `command:runtime-reconcile:${trigger}:${projection.thread.id}:${DateTime.formatIso(now)}`,
+      );
+      const allocateEventId = () =>
+        ids.allocate.event({ threadId: projection.thread.id, commandId }).pipe(
+          Effect.mapError(
+            (cause) =>
+              new ProviderRuntimeRecoveryError({
+                operation: "reconcile",
+                threadId: projection.thread.id,
+                cause,
+              }),
+          ),
+        );
+      const events: Array<OrchestrationV2DomainEvent> = [];
+      for (const request of requests) {
+        events.push({
+          id: yield* allocateEventId(),
+          type: "runtime-request.updated",
+          threadId: projection.thread.id,
+          nodeId: request.nodeId,
+          occurredAt: now,
+          payload: {
+            ...request,
+            status: trigger === "startup" ? "expired" : "cancelled",
+            responseCapability: {
+              type: "not_resumable",
+              reason: `The server ${trigger === "startup" ? "restarted" : "shut down"} before this runtime request was resolved.`,
+            },
+            resolvedAt: now,
+          },
+        });
+      }
+      for (const run of runs) {
+        events.push({
+          id: yield* allocateEventId(),
+          type: "run.updated",
+          threadId: projection.thread.id,
+          runId: run.id,
+          providerInstanceId: run.providerInstanceId,
+          occurredAt: now,
+          payload: { ...run, status: "cancelled", queuePosition: null, completedAt: now },
+        });
+        for (const attempt of projection.attempts.filter(
+          (candidate) =>
+            candidate.runId === run.id &&
+            (candidate.status === "pending" || candidate.status === "running"),
+        )) {
+          events.push({
+            id: yield* allocateEventId(),
+            type: "run-attempt.updated",
+            threadId: projection.thread.id,
+            runId: run.id,
+            nodeId: attempt.rootNodeId,
+            providerInstanceId: run.providerInstanceId,
+            occurredAt: now,
+            payload: { ...attempt, status: "cancelled", completedAt: now },
+          });
+        }
+        for (const node of projection.nodes.filter(
+          (candidate) =>
+            candidate.runId === run.id &&
+            (candidate.status === "pending" ||
+              candidate.status === "running" ||
+              candidate.status === "waiting"),
+        )) {
+          events.push({
+            id: yield* allocateEventId(),
+            type: "node.updated",
+            threadId: projection.thread.id,
+            runId: run.id,
+            nodeId: node.id,
+            providerInstanceId: run.providerInstanceId,
+            occurredAt: now,
+            payload: { ...node, status: "cancelled", completedAt: now },
+          });
+        }
+        for (const subagent of projection.subagents.filter(
+          (candidate) =>
+            candidate.runId === run.id &&
+            (candidate.status === "pending" ||
+              candidate.status === "running" ||
+              candidate.status === "waiting"),
+        )) {
+          events.push({
+            id: yield* allocateEventId(),
+            type: "subagent.updated",
+            threadId: projection.thread.id,
+            runId: run.id,
+            nodeId: subagent.id,
+            driver: subagent.driver,
+            providerInstanceId: subagent.providerInstanceId,
+            occurredAt: now,
+            payload: { ...subagent, status: "cancelled", completedAt: now, updatedAt: now },
+          });
+        }
+        for (const providerTurn of projection.providerTurns.filter(
+          (candidate) =>
+            candidate.runAttemptId !== null &&
+            projection.attempts.some(
+              (attempt) => attempt.id === candidate.runAttemptId && attempt.runId === run.id,
+            ) &&
+            (candidate.status === "pending" || candidate.status === "running"),
+        )) {
+          events.push({
+            id: yield* allocateEventId(),
+            type: "provider-turn.updated",
+            threadId: projection.thread.id,
+            runId: run.id,
+            nodeId: providerTurn.nodeId,
+            providerInstanceId: run.providerInstanceId,
+            occurredAt: now,
+            payload: { ...providerTurn, status: "cancelled", completedAt: now },
+          });
+        }
+        for (const message of projection.messages.filter(
+          (candidate) => candidate.runId === run.id && candidate.streaming,
+        )) {
+          events.push({
+            id: yield* allocateEventId(),
+            type: "message.updated",
+            threadId: projection.thread.id,
+            runId: run.id,
+            ...(message.nodeId === null ? {} : { nodeId: message.nodeId }),
+            providerInstanceId: run.providerInstanceId,
+            occurredAt: now,
+            payload: { ...message, streaming: false, updatedAt: now },
+          });
+        }
+        for (const item of projection.turnItems.filter(
+          (candidate) =>
+            candidate.runId === run.id &&
+            (candidate.status === "pending" ||
+              candidate.status === "running" ||
+              candidate.status === "waiting"),
+        )) {
+          events.push({
+            id: yield* allocateEventId(),
+            type: "turn-item.updated",
+            threadId: projection.thread.id,
+            runId: run.id,
+            ...(item.nodeId === null ? {} : { nodeId: item.nodeId }),
+            providerInstanceId: run.providerInstanceId,
+            occurredAt: now,
+            payload: { ...item, status: "cancelled", completedAt: now, updatedAt: now },
+          });
+        }
+      }
+      // Process loss also orphans background-capable turn items on already-
+      // settled runs (e.g. post-settle Waiting work). Skip items already
+      // cancelled above for recovered nonterminal runs to avoid duplicate
+      // cancellation events.
+      const recoveredNonterminalRunIds = new Set(runs.map((run) => run.id));
+      for (const item of projection.turnItems ?? []) {
+        if (item.runId !== null && recoveredNonterminalRunIds.has(item.runId)) {
+          continue;
+        }
+        if (!isBackgroundCapableTurnItemType(item.type)) {
+          continue;
+        }
+        if (!isNonterminalTurnItemStatus(item.status)) {
+          continue;
+        }
+        const providerInstanceId = resolveStaleBackgroundItemProviderInstanceId(item, projection);
+        events.push({
+          id: yield* allocateEventId(),
+          type: "turn-item.updated",
+          threadId: projection.thread.id,
+          ...(item.runId === null ? {} : { runId: item.runId }),
+          ...(item.nodeId === null || item.nodeId === undefined ? {} : { nodeId: item.nodeId }),
+          providerInstanceId,
+          occurredAt: now,
+          payload: { ...item, status: "cancelled", completedAt: now, updatedAt: now },
+        });
+        if (item.type !== "subagent") {
+          continue;
+        }
+        // Cancelling only the turn item would leave the linked subagent entity
+        // and its execution node non-terminal forever, since the dead provider
+        // process can no longer emit their terminal events. Match the exact
+        // linked ids so a subagent that already finished is never overwritten.
+        const staleSubagent = projection.subagents.find(
+          (candidate) =>
+            candidate.id === item.subagentId && isNonterminalSubagentStatus(candidate.status),
+        );
+        if (staleSubagent !== undefined) {
+          events.push({
+            id: yield* allocateEventId(),
+            type: "subagent.updated",
+            threadId: projection.thread.id,
+            ...(item.runId === null ? {} : { runId: item.runId }),
+            nodeId: staleSubagent.id,
+            driver: staleSubagent.driver,
+            providerInstanceId: staleSubagent.providerInstanceId,
+            occurredAt: now,
+            payload: { ...staleSubagent, status: "cancelled", completedAt: now, updatedAt: now },
+          });
+        }
+        const staleSubagentNode = projection.nodes.find(
+          (candidate) =>
+            candidate.id === item.subagentId && isNonterminalNodeStatus(candidate.status),
+        );
+        if (staleSubagentNode !== undefined) {
+          events.push({
+            id: yield* allocateEventId(),
+            type: "node.updated",
+            threadId: projection.thread.id,
+            ...(item.runId === null ? {} : { runId: item.runId }),
+            nodeId: staleSubagentNode.id,
+            providerInstanceId,
+            occurredAt: now,
+            payload: { ...staleSubagentNode, status: "cancelled", completedAt: now },
+          });
+        }
+      }
+      // All provider processes are gone on startup/shutdown: clear any
+      // persisted Waiting roster (including idle threads from settled roots)
+      // and idle active threads without resurrecting active status.
+      for (const providerThread of projection.providerThreads ?? []) {
+        const needsIdle = providerThread.status === "active";
+        const needsRosterClear = providerThreadHasPendingBackgroundTasks(providerThread);
+        if (!needsIdle && !needsRosterClear) {
+          continue;
+        }
+        events.push({
+          id: yield* allocateEventId(),
+          type: "provider-thread.updated",
+          threadId: projection.thread.id,
+          driver: providerThread.driver,
+          providerInstanceId: providerThread.providerInstanceId,
+          occurredAt: now,
+          payload: {
+            ...providerThread,
+            status: needsIdle ? "idle" : providerThread.status,
+            pendingBackgroundTasks: [],
+            updatedAt: now,
+          },
+        });
+      }
+      for (const session of projection.providerSessions.filter(
+        (candidate) => candidate.status !== "stopped" && candidate.status !== "error",
+      )) {
+        events.push({
+          id: yield* allocateEventId(),
+          type: "provider-session.updated",
+          threadId: projection.thread.id,
+          driver: session.driver,
+          providerInstanceId: session.providerInstanceId,
+          occurredAt: now,
+          payload: { ...session, status: "stopped", updatedAt: now, lastError: null },
+        });
+      }
+      const stoppedSessions = projection.providerSessions.filter(
+        (candidate) => candidate.status !== "stopped" && candidate.status !== "error",
+      ).length;
+      let retiredEffects: number;
+      if (events.length === 0) {
+        const retiredEffectIds = yield* outbox
+          .cancelUnsettled({
+            threadId: projection.thread.id,
+            effectTypes: EffectOutbox.PROCESS_BOUND_EFFECT_TYPES,
+            reason: detail,
+          })
+          .pipe(
+            Effect.mapError(
+              (cause) =>
+                new ProviderRuntimeRecoveryError({
+                  operation: "reconcile",
+                  threadId: projection.thread.id,
+                  cause: { detail, cause },
+                }),
+            ),
+          );
+        yield* outbox.signalCancellations(retiredEffectIds);
+        retiredEffects = retiredEffectIds.length;
+      } else {
+        const result = yield* eventSink
+          .commitCommand({
+            commandId,
+            threadId: projection.thread.id,
+            commandType: "provider-runtime.reconcile",
+            acceptedAt: now,
+            events,
+            effects: [],
+            cancelUnsettledEffects: {
+              effectTypes: EffectOutbox.PROCESS_BOUND_EFFECT_TYPES,
+              reason: detail,
+            },
+          })
+          .pipe(
+            Effect.mapError(
+              (cause) =>
+                new ProviderRuntimeRecoveryError({
+                  operation: "reconcile",
+                  threadId: projection.thread.id,
+                  cause,
+                }),
+            ),
+          );
+        retiredEffects = result.cancelledEffectCount;
+      }
+      return {
+        terminalizedRuns: runs.length,
+        stoppedSessions,
+        closedRequests: requests.length,
+        retiredEffects,
+      };
+    },
+  );
+
+  const reconcile = (trigger: "startup" | "shutdown") =>
+    Effect.gen(function* () {
+      const shell = yield* projections
+        .getShellSnapshot()
+        .pipe(
+          Effect.mapError(
+            (cause) => new ProviderRuntimeRecoveryError({ operation: "read-projections", cause }),
+          ),
+        );
+      let terminalizedRuns = 0;
+      let stoppedSessions = 0;
+      let closedRequests = 0;
+      let retiredEffects = 0;
+      for (const thread of [...shell.threads, ...shell.archivedThreads]) {
+        const projection = yield* projections.getThreadProjection(thread.id).pipe(
+          Effect.mapError(
+            (cause) =>
+              new ProviderRuntimeRecoveryError({
+                operation: "read-projections",
+                threadId: thread.id,
+                cause,
+              }),
+          ),
+        );
+        const result = yield* reconcileProjection(projection, trigger);
+        terminalizedRuns += result.terminalizedRuns;
+        stoppedSessions += result.stoppedSessions;
+        closedRequests += result.closedRequests;
+        retiredEffects += result.retiredEffects;
+      }
+      const outboxReconciliation = yield* outbox.reconcileAfterProcessLoss.pipe(
+        Effect.mapError(
+          (cause) => new ProviderRuntimeRecoveryError({ operation: "drain-outbox", cause }),
+        ),
+      );
+      return {
+        terminalizedRuns,
+        stoppedSessions,
+        closedRequests,
+        retiredEffects: retiredEffects + outboxReconciliation.cancelled,
+        requeuedEffects: outboxReconciliation.requeued,
+      } satisfies ProviderRuntimeReconciliationSummary;
+    });
+
+  const recover = Effect.gen(function* () {
+    const reconciliation = yield* reconcile("startup");
+    let executedEffects = 0;
+    while (
+      yield* worker.runOnce.pipe(
+        Effect.mapError(
+          (cause) => new ProviderRuntimeRecoveryError({ operation: "drain-outbox", cause }),
+        ),
+      )
+    ) {
+      executedEffects += 1;
+    }
+    return { ...reconciliation, executedEffects } satisfies ProviderRuntimeRecoverySummary;
+  });
+
+  return ProviderRuntimeRecoveryService.of({ reconcile, recover });
+});
+
+export const layer = Layer.effect(ProviderRuntimeRecoveryService, make);
diff --git a/apps/server/src/orchestration-v2/ProviderSelectionTransition.test.ts b/apps/server/src/orchestration-v2/ProviderSelectionTransition.test.ts
new file mode 100644
index 000000000000..2e1911bceb8e
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ProviderSelectionTransition.test.ts
@@ -0,0 +1,55 @@
+import { describe, expect, it } from "@effect/vitest";
+
+import {
+  type ModelSelection,
+  type OrchestrationV2ProviderCapabilities,
+  ProviderInstanceId,
+} from "@t3tools/contracts";
+
+import { AcpProviderCapabilitiesV2 } from "./Adapters/AcpAdapterV2.ts";
+import { acpSelectionTransition } from "./ProviderSelectionTransition.ts";
+
+const selection = (model: string, effort = "medium"): ModelSelection => ({
+  instanceId: ProviderInstanceId.make("acp_test"),
+  model,
+  options: [{ id: "effort", value: effort }],
+});
+
+describe("acpSelectionTransition", () => {
+  it("rejects model changes when the negotiated session cannot apply them", () => {
+    expect(
+      acpSelectionTransition({
+        current: selection("old"),
+        target: selection("new"),
+        sessionCapabilities: AcpProviderCapabilitiesV2,
+      }).type,
+    ).toBe("reject");
+  });
+
+  it("allows model changes when the negotiated session can apply them", () => {
+    const sessionCapabilities: OrchestrationV2ProviderCapabilities = {
+      ...AcpProviderCapabilitiesV2,
+      sessions: {
+        ...AcpProviderCapabilitiesV2.sessions,
+        supportsModelSwitchInSession: true,
+      },
+    };
+    expect(
+      acpSelectionTransition({
+        current: selection("old"),
+        target: selection("new"),
+        sessionCapabilities,
+      }),
+    ).toEqual({ type: "apply_on_next_turn" });
+  });
+
+  it("allows option-only changes to be applied through ACP config options", () => {
+    expect(
+      acpSelectionTransition({
+        current: selection("same", "medium"),
+        target: selection("same", "high"),
+        sessionCapabilities: AcpProviderCapabilitiesV2,
+      }),
+    ).toEqual({ type: "apply_on_next_turn" });
+  });
+});
diff --git a/apps/server/src/orchestration-v2/ProviderSelectionTransition.ts b/apps/server/src/orchestration-v2/ProviderSelectionTransition.ts
new file mode 100644
index 000000000000..d4ca82d314a4
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ProviderSelectionTransition.ts
@@ -0,0 +1,37 @@
+import type { ModelSelection, OrchestrationV2ProviderCapabilities } from "@t3tools/contracts";
+
+export interface ProviderSelectionTransitionInput {
+  readonly current: ModelSelection;
+  readonly target: ModelSelection;
+  readonly sessionCapabilities: OrchestrationV2ProviderCapabilities;
+}
+
+/**
+ * Provider-owned classification of how a complete selection can be applied.
+ * The orchestrator remains responsible for attempts and resource lifecycle.
+ */
+export type ProviderSelectionTransitionPlan =
+  | { readonly type: "apply_on_next_turn" }
+  | { readonly type: "restart_session" }
+  | { readonly type: "create_with_handoff" }
+  | { readonly type: "reject"; readonly reason: string };
+
+export function turnScopedSelectionTransition(): ProviderSelectionTransitionPlan {
+  return { type: "apply_on_next_turn" };
+}
+
+/** ACP models require a negotiated model/config mutation capability. */
+export function acpSelectionTransition(
+  input: ProviderSelectionTransitionInput,
+): ProviderSelectionTransitionPlan {
+  if (
+    input.current.model !== input.target.model &&
+    !input.sessionCapabilities.sessions.supportsModelSwitchInSession
+  ) {
+    return {
+      type: "reject",
+      reason: "The active ACP session does not expose a model-switch capability.",
+    };
+  }
+  return { type: "apply_on_next_turn" };
+}
diff --git a/apps/server/src/orchestration-v2/ProviderSessionManager.test.ts b/apps/server/src/orchestration-v2/ProviderSessionManager.test.ts
new file mode 100644
index 000000000000..0e048471da9e
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ProviderSessionManager.test.ts
@@ -0,0 +1,2347 @@
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import { assert, it } from "@effect/vitest";
+import {
+  EnvironmentId,
+  type ModelSelection,
+  type OrchestrationV2AppThread,
+  type OrchestrationV2DomainEvent,
+  type OrchestrationV2ProviderCapabilities,
+  type OrchestrationV2ProviderSession,
+  type OrchestrationV2ProviderThread,
+  ProviderDriverKind,
+  ProviderInstanceId,
+  type ProviderSessionId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+import * as Fiber from "effect/Fiber";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Queue from "effect/Queue";
+import * as Ref from "effect/Ref";
+import * as Stream from "effect/Stream";
+import { TestClock } from "effect/testing";
+import { HttpServer } from "effect/unstable/http";
+
+import { ServerEnvironment } from "../environment/ServerEnvironment.ts";
+import * as McpProviderSession from "../mcp/McpProviderSession.ts";
+import * as McpSessionRegistry from "../mcp/McpSessionRegistry.ts";
+import { SqlitePersistenceMemory } from "../persistence/Layers/Sqlite.ts";
+import * as ServerSettings from "../serverSettings.ts";
+import { CodexProviderCapabilitiesV2 } from "./Adapters/CodexAdapterV2.ts";
+import { EventSinkV2, EventSinkWriteError, layer as eventSinkLayer } from "./EventSink.ts";
+import { layer as eventStoreLayer } from "./EventStore.ts";
+import {
+  IdAllocatorV2,
+  type IdAllocatorV2Shape,
+  layer as idAllocatorLayer,
+} from "./IdAllocator.ts";
+import { ProjectionStoreV2, layer as projectionStoreLayer } from "./ProjectionStore.ts";
+import {
+  ProviderAdapterEventStreamError,
+  type ProviderAdapterV2Event,
+  ProviderAdapterProtocolError,
+  type ProviderAdapterV2RuntimePolicy,
+  type ProviderAdapterV2SessionRuntime,
+  type ProviderAdapterV2Shape,
+} from "./ProviderAdapter.ts";
+import { makeSingleLayer as makeProviderAdapterRegistryLayer } from "./ProviderAdapterRegistry.ts";
+import {
+  ProviderSessionManagerV2,
+  layerWithOptions as providerSessionManagerLayerWithOptions,
+} from "./ProviderSessionManager.ts";
+
+const TestDatabaseLayer = SqlitePersistenceMemory;
+const TestStoresLayer = Layer.merge(eventStoreLayer, projectionStoreLayer).pipe(
+  Layer.provide(TestDatabaseLayer),
+);
+const TestEventSinkLayer = eventSinkLayer.pipe(
+  Layer.provide(Layer.mergeAll(TestStoresLayer, TestDatabaseLayer)),
+);
+const FailingReleaseEventSinkLayer = Layer.effect(
+  EventSinkV2,
+  Effect.gen(function* () {
+    const delegate = yield* EventSinkV2;
+    return EventSinkV2.of({
+      ...delegate,
+      write: (input) =>
+        input.events.some(
+          (event) =>
+            event.type === "provider-session.updated" &&
+            (event.payload.status === "stopped" || event.payload.status === "error"),
+        )
+          ? Effect.fail(new EventSinkWriteError({ eventCount: input.events.length }))
+          : delegate.write(input),
+    });
+  }),
+).pipe(Layer.provide(TestEventSinkLayer));
+
+const CodexCapabilities: OrchestrationV2ProviderCapabilities = CodexProviderCapabilitiesV2;
+const ExclusiveCapabilities: OrchestrationV2ProviderCapabilities = {
+  ...CodexCapabilities,
+  sessions: {
+    ...CodexCapabilities.sessions,
+    supportsMultipleProviderThreadsPerSession: false,
+  },
+};
+
+interface TestProviderRuntimeState {
+  readonly openCount: number;
+  readonly closeCount: number;
+  readonly interruptCount: number;
+  readonly resumeCount: number;
+  readonly eventQueues: ReadonlyMap<string, Queue.Queue<ProviderAdapterV2Event>>;
+}
+
+const emptyState: TestProviderRuntimeState = {
+  openCount: 0,
+  closeCount: 0,
+  interruptCount: 0,
+  resumeCount: 0,
+  eventQueues: new Map(),
+};
+
+const modelSelection = {
+  instanceId: ProviderInstanceId.make("codex"),
+  model: "gpt-5.4",
+} satisfies ModelSelection;
+const CODEX_DRIVER = ProviderDriverKind.make("codex");
+
+const runtimePolicy = {
+  runtimeMode: "full-access",
+  interactionMode: "default",
+  cwd: process.cwd(),
+} satisfies ProviderAdapterV2RuntimePolicy;
+
+function makeProviderSession(input: {
+  readonly providerSessionId: ProviderSessionId;
+  readonly now: DateTime.Utc;
+  readonly capabilities?: OrchestrationV2ProviderCapabilities;
+}): OrchestrationV2ProviderSession {
+  return {
+    id: input.providerSessionId,
+    driver: CODEX_DRIVER,
+    providerInstanceId: modelSelection.instanceId,
+    status: "ready",
+    cwd: process.cwd(),
+    model: "gpt-5.4",
+    capabilities: input.capabilities ?? CodexCapabilities,
+    createdAt: input.now,
+    updatedAt: input.now,
+    lastError: null,
+  };
+}
+
+function makeThreadCreatedEvent(input: {
+  readonly idAllocator: IdAllocatorV2Shape;
+  readonly threadId: ThreadId;
+  readonly now: DateTime.Utc;
+}) {
+  return Effect.gen(function* () {
+    const projectId = yield* input.idAllocator.allocate.project({
+      fixtureName: "provider-session-manager",
+    });
+    const providerThreadId = input.idAllocator.derive.providerThread({
+      driver: CODEX_DRIVER,
+      nativeThreadId: "native-thread",
+    });
+    const thread: OrchestrationV2AppThread = {
+      createdBy: "user",
+      creationSource: "web",
+      id: input.threadId,
+      projectId,
+      title: "Provider session manager",
+      providerInstanceId: modelSelection.instanceId,
+      modelSelection,
+      runtimeMode: "full-access",
+      interactionMode: "default",
+      branch: null,
+      worktreePath: null,
+      activeProviderThreadId: providerThreadId,
+      lineage: {
+        parentThreadId: null,
+        relationshipToParent: null,
+        rootThreadId: input.threadId,
+      },
+      forkedFrom: null,
+      createdAt: input.now,
+      updatedAt: input.now,
+      archivedAt: null,
+      settledOverride: null,
+      settledAt: null,
+      lastVisitedAt: null,
+      deletedAt: null,
+    };
+    return {
+      id: yield* input.idAllocator.allocate.event({ threadId: input.threadId }),
+      type: "thread.created" as const,
+      threadId: input.threadId,
+      occurredAt: input.now,
+      payload: thread,
+    };
+  });
+}
+
+function makeProviderThread(input: {
+  readonly idAllocator: IdAllocatorV2Shape;
+  readonly threadId: ThreadId;
+  readonly providerSessionId: ProviderSessionId;
+  readonly now: DateTime.Utc;
+}): OrchestrationV2ProviderThread {
+  return {
+    id: input.idAllocator.derive.providerThread({
+      driver: CODEX_DRIVER,
+      nativeThreadId: "native-thread",
+    }),
+    driver: CODEX_DRIVER,
+    providerInstanceId: modelSelection.instanceId,
+    providerSessionId: input.providerSessionId,
+    appThreadId: input.threadId,
+    ownerNodeId: null,
+    nativeThreadRef: {
+      driver: CODEX_DRIVER,
+      nativeId: "native-thread",
+      strength: "strong",
+    },
+    nativeConversationHeadRef: null,
+    status: "idle",
+    firstRunOrdinal: null,
+    lastRunOrdinal: null,
+    handoffIds: [],
+    forkedFrom: null,
+    createdAt: input.now,
+    updatedAt: input.now,
+  };
+}
+
+function unimplemented(detail: string) {
+  return Effect.fail(
+    new ProviderAdapterProtocolError({
+      driver: CODEX_DRIVER,
+      detail,
+    }),
+  );
+}
+
+function makeProviderAdapter(
+  state: Ref.Ref<TestProviderRuntimeState>,
+  options: {
+    readonly failEventStream?: boolean;
+    readonly capabilities?: OrchestrationV2ProviderCapabilities;
+    readonly mcpConfigs?: Ref.Ref<
+      ReadonlyArray<McpProviderSession.McpProviderSessionConfig | undefined>
+    >;
+    readonly beforeOpen?: (input: {
+      readonly providerSessionId: ProviderSessionId;
+    }) => Effect.Effect<void>;
+    readonly hasPendingBackgroundWork?: Effect.Effect<boolean>;
+    readonly hangSessionScopeClose?: boolean;
+  } = {},
+): ProviderAdapterV2Shape {
+  return {
+    instanceId: ProviderInstanceId.make("codex"),
+    driver: CODEX_DRIVER,
+    getCapabilities: () => Effect.succeed(options.capabilities ?? CodexCapabilities),
+    planSelectionTransition: () => Effect.succeed({ type: "apply_on_next_turn" }),
+    openSession: (input) =>
+      Effect.gen(function* () {
+        if (options.beforeOpen !== undefined) {
+          yield* options.beforeOpen({ providerSessionId: input.providerSessionId });
+        }
+        if (options.mcpConfigs !== undefined) {
+          yield* Ref.update(options.mcpConfigs, (configs) => [
+            ...configs,
+            McpProviderSession.readMcpProviderSession(input.threadId),
+          ]);
+        }
+        const now = yield* DateTime.now;
+        const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+        const session = makeProviderSession({
+          providerSessionId: input.providerSessionId,
+          now,
+          ...(options.capabilities === undefined ? {} : { capabilities: options.capabilities }),
+        });
+        yield* Ref.update(state, (current) => {
+          const eventQueues = new Map(current.eventQueues);
+          eventQueues.set(String(input.providerSessionId), events);
+          return {
+            ...current,
+            openCount: current.openCount + 1,
+            eventQueues,
+          };
+        });
+        yield* Effect.addFinalizer(() =>
+          Ref.update(state, (current) => ({
+            ...current,
+            closeCount: current.closeCount + 1,
+          })),
+        );
+        if (options.hangSessionScopeClose === true) {
+          // Registered last so it runs first on scope close, wedging the
+          // close before the closeCount finalizer, like a provider process
+          // that never yields its message stream.
+          yield* Effect.addFinalizer(() => Effect.never);
+        }
+
+        return {
+          instanceId: ProviderInstanceId.make("codex"),
+          driver: CODEX_DRIVER,
+          providerSessionId: input.providerSessionId,
+          providerSession: session,
+          events: options.failEventStream
+            ? Stream.fail(
+                new ProviderAdapterEventStreamError({
+                  driver: CODEX_DRIVER,
+                  providerSessionId: input.providerSessionId,
+                  cause: "process exited",
+                }),
+              )
+            : Stream.fromQueue(events),
+          ...(options.hasPendingBackgroundWork === undefined
+            ? {}
+            : { hasPendingBackgroundWork: options.hasPendingBackgroundWork }),
+          ensureThread: () => unimplemented("ensureThread unused in test"),
+          resumeThread: (threadInput) =>
+            Ref.update(state, (current) => ({
+              ...current,
+              resumeCount: current.resumeCount + 1,
+            })).pipe(Effect.as(threadInput.providerThread)),
+          startTurn: () => Effect.void,
+          steerTurn: () => Effect.void,
+          interruptTurn: () =>
+            Ref.update(state, (current) => ({
+              ...current,
+              interruptCount: current.interruptCount + 1,
+            })),
+          respondToRuntimeRequest: () => Effect.void,
+          readThreadSnapshot: () => unimplemented("readThreadSnapshot unused in test"),
+          rollbackThread: () => unimplemented("rollbackThread unused in test"),
+          forkThread: () => unimplemented("forkThread unused in test"),
+        } satisfies ProviderAdapterV2SessionRuntime;
+      }),
+  };
+}
+
+function makeTestLayer(input: {
+  readonly state: Ref.Ref<TestProviderRuntimeState>;
+  readonly idleTimeoutMs: number;
+  readonly maxIdlePinMs?: number;
+  readonly failEventStream?: boolean;
+  readonly capabilities?: OrchestrationV2ProviderCapabilities;
+  readonly mcpConfigs?: Ref.Ref<
+    ReadonlyArray<McpProviderSession.McpProviderSessionConfig | undefined>
+  >;
+  readonly beforeOpen?: (input: {
+    readonly providerSessionId: ProviderSessionId;
+  }) => Effect.Effect<void>;
+  readonly failReleaseEventWrites?: boolean;
+  readonly hasPendingBackgroundWork?: Effect.Effect<boolean>;
+  readonly hangSessionScopeClose?: boolean;
+  readonly serverSettingsLayer?: ReturnType<typeof ServerSettings.layerTest>;
+}) {
+  const configuredEventSinkLayer = input.failReleaseEventWrites
+    ? FailingReleaseEventSinkLayer
+    : TestEventSinkLayer;
+  const registryLayer = makeProviderAdapterRegistryLayer(
+    makeProviderAdapter(input.state, {
+      failEventStream: input.failEventStream ?? false,
+      ...(input.capabilities === undefined ? {} : { capabilities: input.capabilities }),
+      ...(input.mcpConfigs === undefined ? {} : { mcpConfigs: input.mcpConfigs }),
+      ...(input.beforeOpen === undefined ? {} : { beforeOpen: input.beforeOpen }),
+      ...(input.hasPendingBackgroundWork === undefined
+        ? {}
+        : { hasPendingBackgroundWork: input.hasPendingBackgroundWork }),
+      ...(input.hangSessionScopeClose === undefined
+        ? {}
+        : { hangSessionScopeClose: input.hangSessionScopeClose }),
+    }),
+  );
+  return Layer.mergeAll(
+    TestStoresLayer,
+    configuredEventSinkLayer,
+    idAllocatorLayer,
+    TestMcpRegistryLayer,
+    providerSessionManagerLayerWithOptions({
+      idleTimeoutMs: input.idleTimeoutMs,
+      ...(input.maxIdlePinMs === undefined ? {} : { maxIdlePinMs: input.maxIdlePinMs }),
+    }).pipe(
+      Layer.provide(
+        Layer.mergeAll(
+          registryLayer,
+          configuredEventSinkLayer,
+          idAllocatorLayer,
+          TestMcpRegistryLayer,
+          TestStoresLayer,
+          ...(input.serverSettingsLayer === undefined ? [] : [input.serverSettingsLayer]),
+        ),
+      ),
+    ),
+  );
+}
+
+const fakeHttpServer = HttpServer.HttpServer.of({
+  address: { _tag: "TcpAddress", hostname: "127.0.0.1", port: 43123 },
+  serve: (() => Effect.void) as HttpServer.HttpServer["Service"]["serve"],
+});
+
+const fakeEnvironment = ServerEnvironment.of({
+  getEnvironmentId: Effect.succeed(EnvironmentId.make("environment-provider-session-manager")),
+  getDescriptor: Effect.die("unused"),
+});
+
+const TestMcpRegistryLayer = Layer.effect(
+  McpSessionRegistry.McpSessionRegistry,
+  McpSessionRegistry.__testing.make(),
+).pipe(
+  Layer.provide(Layer.succeed(HttpServer.HttpServer, fakeHttpServer)),
+  Layer.provide(Layer.succeed(ServerEnvironment, fakeEnvironment)),
+  Layer.provide(NodeServices.layer),
+);
+
+function makePendingRuntimeRequestEvents(input: {
+  readonly idAllocator: IdAllocatorV2Shape;
+  readonly threadId: ThreadId;
+  readonly providerSessionId: ProviderSessionId;
+  readonly providerThread: OrchestrationV2ProviderThread;
+  readonly now: DateTime.Utc;
+}) {
+  return Effect.gen(function* () {
+    const requestId = yield* input.idAllocator.allocate.runtimeRequest({
+      driver: CODEX_DRIVER,
+      nativeRequestId: "pending-approval",
+    });
+    const nodeId = input.idAllocator.derive.approvalNode({ requestId });
+    const node = {
+      id: nodeId,
+      threadId: input.threadId,
+      runId: null,
+      parentNodeId: null,
+      rootNodeId: nodeId,
+      kind: "approval_request" as const,
+      status: "waiting" as const,
+      countsForRun: false,
+      providerThreadId: input.providerThread.id,
+      providerTurnId: null,
+      nativeItemRef: null,
+      runtimeRequestId: requestId,
+      checkpointScopeId: null,
+      startedAt: input.now,
+      completedAt: null,
+    };
+    const request = {
+      id: requestId,
+      nodeId,
+      providerTurnId: null,
+      nativeRequestRef: {
+        driver: CODEX_DRIVER,
+        nativeId: "pending-approval",
+        strength: "strong" as const,
+      },
+      kind: "command" as const,
+      status: "pending" as const,
+      responseCapability: {
+        type: "live" as const,
+        providerSessionId: input.providerSessionId,
+      },
+      createdAt: input.now,
+      resolvedAt: null,
+    };
+    const turnItem = {
+      id: input.idAllocator.derive.approvalTurnItem({ requestId }),
+      threadId: input.threadId,
+      runId: null,
+      nodeId,
+      providerThreadId: input.providerThread.id,
+      providerTurnId: null,
+      nativeItemRef: null,
+      parentItemId: null,
+      ordinal: 1,
+      status: "waiting" as const,
+      title: null,
+      startedAt: input.now,
+      completedAt: null,
+      updatedAt: input.now,
+      type: "approval_request" as const,
+      requestId,
+      requestKind: "command" as const,
+    };
+    return [
+      {
+        id: yield* input.idAllocator.allocate.event({
+          threadId: input.threadId,
+          providerSessionId: input.providerSessionId,
+        }),
+        type: "node.updated" as const,
+        threadId: input.threadId,
+        nodeId,
+        driver: CODEX_DRIVER,
+        occurredAt: input.now,
+        payload: node,
+      },
+      {
+        id: yield* input.idAllocator.allocate.event({
+          threadId: input.threadId,
+          providerSessionId: input.providerSessionId,
+        }),
+        type: "runtime-request.updated" as const,
+        threadId: input.threadId,
+        nodeId,
+        driver: CODEX_DRIVER,
+        occurredAt: input.now,
+        payload: request,
+      },
+      {
+        id: yield* input.idAllocator.allocate.event({
+          threadId: input.threadId,
+          providerSessionId: input.providerSessionId,
+        }),
+        type: "turn-item.updated" as const,
+        threadId: input.threadId,
+        nodeId,
+        driver: CODEX_DRIVER,
+        occurredAt: input.now,
+        payload: turnItem,
+      },
+    ] satisfies ReadonlyArray<OrchestrationV2DomainEvent>;
+  });
+}
+
+it.effect("ProviderSessionManagerV2 opens independent sessions concurrently", () =>
+  Effect.gen(function* () {
+    const state = yield* Ref.make(emptyState);
+    const openStartedCount = yield* Ref.make(0);
+    const firstOpenStarted = yield* Deferred.make<void>();
+    const secondOpenStarted = yield* Deferred.make<void>();
+    const releaseOpens = yield* Deferred.make<void>();
+    const beforeOpen = () =>
+      Effect.gen(function* () {
+        const openNumber = yield* Ref.modify(openStartedCount, (count) => [count + 1, count + 1]);
+        yield* Deferred.succeed(openNumber === 1 ? firstOpenStarted : secondOpenStarted, undefined);
+        yield* Deferred.await(releaseOpens);
+      });
+
+    const effect = Effect.gen(function* () {
+      const eventSink = yield* EventSinkV2;
+      const idAllocator = yield* IdAllocatorV2;
+      const manager = yield* ProviderSessionManagerV2;
+      const now = yield* DateTime.now;
+      const firstThreadId = ThreadId.make("thread-provider-session-manager-concurrent-a");
+      const secondThreadId = ThreadId.make("thread-provider-session-manager-concurrent-b");
+      const firstProviderSessionId = yield* idAllocator.allocate.providerSession({
+        providerInstanceId: modelSelection.instanceId,
+        threadId: firstThreadId,
+      });
+      const secondProviderSessionId = yield* idAllocator.allocate.providerSession({
+        providerInstanceId: modelSelection.instanceId,
+        threadId: secondThreadId,
+      });
+
+      yield* eventSink.write({
+        events: [
+          yield* makeThreadCreatedEvent({ idAllocator, threadId: firstThreadId, now }),
+          yield* makeThreadCreatedEvent({ idAllocator, threadId: secondThreadId, now }),
+        ],
+      });
+      const firstFiber = yield* manager
+        .open({
+          threadId: firstThreadId,
+          providerSessionId: firstProviderSessionId,
+          modelSelection,
+          runtimePolicy,
+        })
+        .pipe(Effect.forkScoped);
+      yield* Deferred.await(firstOpenStarted);
+      const secondFiber = yield* manager
+        .open({
+          threadId: secondThreadId,
+          providerSessionId: secondProviderSessionId,
+          modelSelection,
+          runtimePolicy,
+        })
+        .pipe(Effect.forkScoped);
+
+      yield* Deferred.await(secondOpenStarted);
+      assert.equal(yield* Ref.get(openStartedCount), 2);
+      yield* Deferred.succeed(releaseOpens, undefined);
+      const [firstRuntime, secondRuntime] = yield* Effect.all([
+        Fiber.join(firstFiber),
+        Fiber.join(secondFiber),
+      ]);
+      assert.notStrictEqual(firstRuntime, secondRuntime);
+      assert.equal((yield* Ref.get(state)).openCount, 2);
+    });
+
+    yield* effect.pipe(
+      Effect.provide(
+        makeTestLayer({
+          state,
+          idleTimeoutMs: 60_000,
+          beforeOpen,
+        }),
+      ),
+    );
+  }),
+);
+
+it.effect("ProviderSessionManagerV2 opens a duplicate session only once", () =>
+  Effect.gen(function* () {
+    const state = yield* Ref.make(emptyState);
+    const openStartedCount = yield* Ref.make(0);
+    const firstOpenStarted = yield* Deferred.make<void>();
+    const releaseOpen = yield* Deferred.make<void>();
+    const beforeOpen = () =>
+      Ref.updateAndGet(openStartedCount, (count) => count + 1).pipe(
+        Effect.tap(() => Deferred.succeed(firstOpenStarted, undefined)),
+        Effect.andThen(Deferred.await(releaseOpen)),
+      );
+
+    const effect = Effect.gen(function* () {
+      const eventSink = yield* EventSinkV2;
+      const idAllocator = yield* IdAllocatorV2;
+      const manager = yield* ProviderSessionManagerV2;
+      const now = yield* DateTime.now;
+      const threadId = ThreadId.make("thread-provider-session-manager-single-flight");
+      const providerSessionId = yield* idAllocator.allocate.providerSession({
+        providerInstanceId: modelSelection.instanceId,
+        threadId,
+      });
+      const open = manager.open({
+        threadId,
+        providerSessionId,
+        modelSelection,
+        runtimePolicy,
+      });
+
+      yield* eventSink.write({
+        events: [yield* makeThreadCreatedEvent({ idAllocator, threadId, now })],
+      });
+      const firstFiber = yield* open.pipe(Effect.forkScoped);
+      yield* Deferred.await(firstOpenStarted);
+      const secondFiber = yield* open.pipe(Effect.forkScoped);
+      yield* Effect.yieldNow;
+      yield* Effect.yieldNow;
+      assert.equal(yield* Ref.get(openStartedCount), 1);
+
+      yield* Deferred.succeed(releaseOpen, undefined);
+      const [firstRuntime, secondRuntime] = yield* Effect.all([
+        Fiber.join(firstFiber),
+        Fiber.join(secondFiber),
+      ]);
+      assert.strictEqual(firstRuntime, secondRuntime);
+      assert.equal((yield* Ref.get(state)).openCount, 1);
+    });
+
+    yield* effect.pipe(
+      Effect.provide(
+        makeTestLayer({
+          state,
+          idleTimeoutMs: 60_000,
+          beforeOpen,
+        }),
+      ),
+    );
+  }),
+);
+
+it.effect("ProviderSessionManagerV2 releases live sessions when its layer shuts down", () =>
+  Effect.gen(function* () {
+    const state = yield* Ref.make(emptyState);
+    const effect = Effect.gen(function* () {
+      const eventSink = yield* EventSinkV2;
+      const idAllocator = yield* IdAllocatorV2;
+      const manager = yield* ProviderSessionManagerV2;
+      const now = yield* DateTime.now;
+      const threadId = ThreadId.make("thread-provider-session-manager-shutdown");
+      const providerSessionId = yield* idAllocator.allocate.providerSession({
+        providerInstanceId: modelSelection.instanceId,
+        threadId,
+      });
+
+      yield* eventSink.write({
+        events: [yield* makeThreadCreatedEvent({ idAllocator, threadId, now })],
+      });
+      yield* manager.open({
+        threadId,
+        providerSessionId,
+        modelSelection,
+        runtimePolicy,
+      });
+
+      const liveState = yield* Ref.get(state);
+      assert.equal(liveState.openCount, 1);
+      assert.equal(liveState.closeCount, 0);
+    });
+
+    yield* effect.pipe(
+      Effect.provide(
+        makeTestLayer({
+          state,
+          idleTimeoutMs: 60_000,
+        }),
+      ),
+    );
+
+    assert.equal((yield* Ref.get(state)).closeCount, 1);
+  }),
+);
+
+it.effect("ProviderSessionManagerV2 closes event subscriptions normally on server shutdown", () =>
+  Effect.gen(function* () {
+    const state = yield* Ref.make(emptyState);
+    const effect = Effect.gen(function* () {
+      const eventSink = yield* EventSinkV2;
+      const idAllocator = yield* IdAllocatorV2;
+      const manager = yield* ProviderSessionManagerV2;
+      const now = yield* DateTime.now;
+      const threadId = ThreadId.make("thread-provider-session-manager-shutdown-subscription");
+      const providerSessionId = yield* idAllocator.allocate.providerSession({
+        providerInstanceId: modelSelection.instanceId,
+        threadId,
+      });
+      yield* eventSink.write({
+        events: [yield* makeThreadCreatedEvent({ idAllocator, threadId, now })],
+      });
+      const runtime = yield* manager.open({
+        threadId,
+        providerSessionId,
+        modelSelection,
+        runtimePolicy,
+      });
+      const bufferedSubscription = yield* runtime.subscribeEvents!;
+      const activeSubscription = yield* runtime.subscribeEvents!;
+      const adapterQueue = (yield* Ref.get(state)).eventQueues.get(String(providerSessionId));
+      assert.isDefined(adapterQueue);
+      yield* Queue.offer(adapterQueue!, {
+        type: "provider_session.updated",
+        driver: CODEX_DRIVER,
+        providerSession: runtime.providerSession,
+      });
+      assert.isTrue(Option.isSome(yield* activeSubscription.events.pipe(Stream.runHead)));
+
+      yield* manager.shutdown;
+
+      assert.isEmpty(yield* bufferedSubscription.events.pipe(Stream.runCollect));
+    });
+
+    yield* effect.pipe(Effect.provide(makeTestLayer({ state, idleTimeoutMs: 60_000 })));
+  }),
+);
+
+it.effect(
+  "ProviderSessionManagerV2 issues MCP credentials before opening and revokes them on close",
+  () =>
+    Effect.gen(function* () {
+      const state = yield* Ref.make(emptyState);
+      const mcpConfigs = yield* Ref.make<
+        ReadonlyArray<McpProviderSession.McpProviderSessionConfig | undefined>
+      >([]);
+      const effect = Effect.gen(function* () {
+        const eventSink = yield* EventSinkV2;
+        const idAllocator = yield* IdAllocatorV2;
+        const manager = yield* ProviderSessionManagerV2;
+        const registry = yield* McpSessionRegistry.McpSessionRegistry;
+        const now = yield* DateTime.now;
+        const threadId = ThreadId.make("thread-provider-session-manager-mcp");
+        const providerSessionId = yield* idAllocator.allocate.providerSession({
+          providerInstanceId: modelSelection.instanceId,
+          threadId,
+        });
+
+        yield* eventSink.write({
+          events: [yield* makeThreadCreatedEvent({ idAllocator, threadId, now })],
+        });
+        yield* manager.open({
+          threadId,
+          providerSessionId,
+          modelSelection,
+          runtimePolicy,
+        });
+
+        const captured = (yield* Ref.get(mcpConfigs))[0];
+        assert.isDefined(captured);
+        assert.equal(captured?.threadId, threadId);
+        assert.equal(captured?.providerInstanceId, modelSelection.instanceId);
+        assert.equal(captured?.endpoint, "http://127.0.0.1:43123/mcp");
+        const token = captured?.authorizationHeader.replace(/^Bearer\s+/, "");
+        assert.isDefined(token);
+        const resolved = yield* registry.resolve(token!);
+        assert.equal(resolved?.threadId, threadId);
+        assert.deepEqual(resolved?.capabilities, new Set(["preview", "orchestration", "worktree"]));
+
+        yield* manager.close(providerSessionId);
+        assert.isUndefined(McpProviderSession.readMcpProviderSession(threadId));
+        assert.isUndefined(yield* registry.resolve(token!));
+      });
+
+      yield* effect.pipe(
+        Effect.provide(
+          makeTestLayer({
+            state,
+            idleTimeoutMs: 1_000,
+            mcpConfigs,
+          }),
+        ),
+      );
+    }),
+);
+
+it.effect(
+  "ProviderSessionManagerV2 withholds the preview capability when agent browser access is off",
+  () =>
+    Effect.gen(function* () {
+      const state = yield* Ref.make(emptyState);
+      const mcpConfigs = yield* Ref.make<
+        ReadonlyArray<McpProviderSession.McpProviderSessionConfig | undefined>
+      >([]);
+      const effect = Effect.gen(function* () {
+        const eventSink = yield* EventSinkV2;
+        const idAllocator = yield* IdAllocatorV2;
+        const manager = yield* ProviderSessionManagerV2;
+        const registry = yield* McpSessionRegistry.McpSessionRegistry;
+        const now = yield* DateTime.now;
+        const threadId = ThreadId.make("thread-provider-session-manager-no-browser");
+        const providerSessionId = yield* idAllocator.allocate.providerSession({
+          providerInstanceId: modelSelection.instanceId,
+          threadId,
+        });
+
+        yield* eventSink.write({
+          events: [yield* makeThreadCreatedEvent({ idAllocator, threadId, now })],
+        });
+        yield* manager.open({
+          threadId,
+          providerSessionId,
+          modelSelection,
+          runtimePolicy,
+        });
+
+        const captured = (yield* Ref.get(mcpConfigs))[0];
+        assert.isDefined(captured);
+        assert.equal(captured?.browserToolsAvailable, false);
+        const token = captured?.authorizationHeader.replace(/^Bearer\s+/, "");
+        const resolved = yield* registry.resolve(token!);
+        assert.deepEqual(resolved?.capabilities, new Set(["orchestration", "worktree"]));
+
+        yield* manager.close(providerSessionId);
+      });
+
+      yield* effect.pipe(
+        Effect.provide(
+          makeTestLayer({
+            state,
+            idleTimeoutMs: 1_000,
+            mcpConfigs,
+            serverSettingsLayer: ServerSettings.layerTest({ enableAgentBrowserAccess: false }),
+          }),
+        ),
+      );
+    }),
+);
+
+it.effect("ProviderSessionManagerV2 revokes MCP credentials when release persistence fails", () =>
+  Effect.gen(function* () {
+    const state = yield* Ref.make(emptyState);
+    const mcpConfigs = yield* Ref.make<
+      ReadonlyArray<McpProviderSession.McpProviderSessionConfig | undefined>
+    >([]);
+    const effect = Effect.gen(function* () {
+      const eventSink = yield* EventSinkV2;
+      const idAllocator = yield* IdAllocatorV2;
+      const manager = yield* ProviderSessionManagerV2;
+      const registry = yield* McpSessionRegistry.McpSessionRegistry;
+      const now = yield* DateTime.now;
+      const threadId = ThreadId.make("thread-provider-session-manager-mcp-release-failure");
+      const providerSessionId = yield* idAllocator.allocate.providerSession({
+        providerInstanceId: modelSelection.instanceId,
+        threadId,
+      });
+
+      yield* eventSink.write({
+        events: [yield* makeThreadCreatedEvent({ idAllocator, threadId, now })],
+      });
+      yield* manager.open({
+        threadId,
+        providerSessionId,
+        modelSelection,
+        runtimePolicy,
+      });
+
+      const captured = (yield* Ref.get(mcpConfigs))[0];
+      const token = captured?.authorizationHeader.replace(/^Bearer\s+/, "");
+      assert.isDefined(token);
+      assert.isDefined(yield* registry.resolve(token!));
+
+      const closeError = yield* manager.close(providerSessionId).pipe(Effect.flip);
+      assert.equal(closeError._tag, "ProviderSessionCloseError");
+      assert.isUndefined(McpProviderSession.readMcpProviderSession(threadId));
+      assert.isUndefined(yield* registry.resolve(token!));
+    });
+
+    yield* effect.pipe(
+      Effect.provide(
+        makeTestLayer({
+          state,
+          idleTimeoutMs: 1_000,
+          mcpConfigs,
+          failReleaseEventWrites: true,
+        }),
+      ),
+    );
+  }),
+);
+
+it.effect("ProviderSessionManagerV2 duplicate detach preserves replacement MCP credentials", () =>
+  Effect.gen(function* () {
+    const state = yield* Ref.make(emptyState);
+    const mcpConfigs = yield* Ref.make<
+      ReadonlyArray<McpProviderSession.McpProviderSessionConfig | undefined>
+    >([]);
+    const effect = Effect.gen(function* () {
+      const eventSink = yield* EventSinkV2;
+      const idAllocator = yield* IdAllocatorV2;
+      const manager = yield* ProviderSessionManagerV2;
+      const registry = yield* McpSessionRegistry.McpSessionRegistry;
+      const now = yield* DateTime.now;
+      const threadId = ThreadId.make("thread-provider-session-manager-replacement-mcp");
+      const oldSessionId = yield* idAllocator.allocate.providerSession({
+        providerInstanceId: modelSelection.instanceId,
+        threadId,
+      });
+      const replacementSessionId = yield* idAllocator.allocate.providerSession({
+        providerInstanceId: modelSelection.instanceId,
+        threadId,
+      });
+
+      yield* eventSink.write({
+        events: [yield* makeThreadCreatedEvent({ idAllocator, threadId, now })],
+      });
+      yield* manager.open({
+        threadId,
+        providerSessionId: oldSessionId,
+        modelSelection,
+        runtimePolicy,
+      });
+      yield* manager.detach({ providerSessionId: oldSessionId, threadId });
+      yield* manager.open({
+        threadId,
+        providerSessionId: replacementSessionId,
+        modelSelection,
+        runtimePolicy,
+      });
+
+      const replacement = (yield* Ref.get(mcpConfigs)).at(-1);
+      assert.isDefined(replacement);
+      const replacementToken = replacement?.authorizationHeader.replace(/^Bearer\s+/, "");
+      assert.isDefined(replacementToken);
+      assert.equal(
+        McpProviderSession.readMcpProviderSession(threadId)?.providerSessionId,
+        replacement?.providerSessionId,
+      );
+
+      yield* manager.detach({ providerSessionId: oldSessionId, threadId });
+
+      assert.equal(
+        McpProviderSession.readMcpProviderSession(threadId)?.providerSessionId,
+        replacement?.providerSessionId,
+      );
+      assert.equal((yield* registry.resolve(replacementToken!))?.threadId, threadId);
+    });
+
+    yield* effect.pipe(
+      Effect.provide(
+        makeTestLayer({
+          state,
+          idleTimeoutMs: 1_000,
+          capabilities: ExclusiveCapabilities,
+          mcpConfigs,
+        }),
+      ),
+    );
+  }),
+);
+
+it.effect(
+  "ProviderSessionManagerV2 detach of a superseded live session preserves replacement MCP credentials",
+  () =>
+    Effect.gen(function* () {
+      const state = yield* Ref.make(emptyState);
+      const mcpConfigs = yield* Ref.make<
+        ReadonlyArray<McpProviderSession.McpProviderSessionConfig | undefined>
+      >([]);
+      const effect = Effect.gen(function* () {
+        const eventSink = yield* EventSinkV2;
+        const idAllocator = yield* IdAllocatorV2;
+        const manager = yield* ProviderSessionManagerV2;
+        const registry = yield* McpSessionRegistry.McpSessionRegistry;
+        const now = yield* DateTime.now;
+        const threadId = ThreadId.make("thread-provider-session-manager-superseded-mcp");
+        const oldSessionId = yield* idAllocator.allocate.providerSession({
+          providerInstanceId: modelSelection.instanceId,
+          threadId,
+        });
+        const replacementSessionId = yield* idAllocator.allocate.providerSession({
+          providerInstanceId: modelSelection.instanceId,
+          threadId,
+        });
+
+        yield* eventSink.write({
+          events: [yield* makeThreadCreatedEvent({ idAllocator, threadId, now })],
+        });
+        yield* manager.open({
+          threadId,
+          providerSessionId: oldSessionId,
+          modelSelection,
+          runtimePolicy,
+        });
+        // The replacement opens while the old session is still attached: this is
+        // the workspace-handoff sequence, where the queued continuation run can
+        // start its session before the outbox executes the old session's detach.
+        yield* manager.open({
+          threadId,
+          providerSessionId: replacementSessionId,
+          modelSelection,
+          runtimePolicy,
+        });
+
+        const replacement = (yield* Ref.get(mcpConfigs)).at(-1);
+        assert.isDefined(replacement);
+        const replacementToken = replacement?.authorizationHeader.replace(/^Bearer\s+/, "");
+        assert.isDefined(replacementToken);
+        assert.equal(
+          McpProviderSession.readMcpProviderSession(threadId)?.providerSessionId,
+          replacement?.providerSessionId,
+        );
+
+        // First (non-duplicate) detach of the superseded session must not revoke
+        // the replacement's credential or clear its config slot.
+        yield* manager.detach({ providerSessionId: oldSessionId, threadId });
+
+        assert.equal(
+          McpProviderSession.readMcpProviderSession(threadId)?.providerSessionId,
+          replacement?.providerSessionId,
+        );
+        assert.equal((yield* registry.resolve(replacementToken!))?.threadId, threadId);
+      });
+
+      yield* effect.pipe(
+        Effect.provide(
+          makeTestLayer({
+            state,
+            idleTimeoutMs: 1_000,
+            capabilities: ExclusiveCapabilities,
+            mcpConfigs,
+          }),
+        ),
+      );
+    }),
+);
+
+it.effect(
+  "ProviderSessionManagerV2 keeps a thread's MCP credential stable across detach and re-attach on a shared session",
+  () =>
+    Effect.gen(function* () {
+      const state = yield* Ref.make(emptyState);
+      const mcpConfigs = yield* Ref.make<
+        ReadonlyArray<McpProviderSession.McpProviderSessionConfig | undefined>
+      >([]);
+      const effect = Effect.gen(function* () {
+        const eventSink = yield* EventSinkV2;
+        const idAllocator = yield* IdAllocatorV2;
+        const manager = yield* ProviderSessionManagerV2;
+        const registry = yield* McpSessionRegistry.McpSessionRegistry;
+        const now = yield* DateTime.now;
+        const threadId = ThreadId.make("thread-provider-session-manager-stable-mcp");
+        const providerSessionId = yield* idAllocator.allocate.providerSession({
+          providerInstanceId: modelSelection.instanceId,
+          threadId,
+        });
+
+        yield* eventSink.write({
+          events: [yield* makeThreadCreatedEvent({ idAllocator, threadId, now })],
+        });
+        yield* manager.open({
+          threadId,
+          providerSessionId,
+          modelSelection,
+          runtimePolicy,
+        });
+
+        const original = (yield* Ref.get(mcpConfigs)).at(-1);
+        assert.isDefined(original);
+        const originalToken = original?.authorizationHeader.replace(/^Bearer\s+/, "");
+        assert.isDefined(originalToken);
+
+        // Workspace-change handoff on a shared multi-thread session (codex):
+        // the thread detaches while the provider process keeps running, and the
+        // process's MCP client keeps using the credential it was started with.
+        yield* manager.detach({ providerSessionId, threadId, detail: "Workspace changed." });
+        assert.equal(
+          (yield* registry.resolve(originalToken!))?.threadId,
+          threadId,
+          "detach must not revoke the credential the live provider process still holds",
+        );
+
+        // The continuation run re-attaches the same thread to the same session;
+        // the credential must be reused, not rotated, so the provider process's
+        // long-lived MCP client stays authorized.
+        yield* manager.open({
+          threadId,
+          providerSessionId,
+          modelSelection,
+          runtimePolicy,
+        });
+        assert.equal(
+          McpProviderSession.readMcpProviderSession(threadId)?.providerSessionId,
+          original?.providerSessionId,
+          "re-attach must reuse the existing credential, not rotate it",
+        );
+        assert.equal((yield* registry.resolve(originalToken!))?.threadId, threadId);
+
+        // Releasing the session (provider process gone) still revokes.
+        yield* manager.close(providerSessionId);
+        assert.isUndefined(yield* registry.resolve(originalToken!));
+      });
+
+      yield* effect.pipe(
+        Effect.provide(
+          makeTestLayer({
+            state,
+            idleTimeoutMs: 1_000,
+            mcpConfigs,
+          }),
+        ),
+      );
+    }),
+);
+
+it.effect(
+  "ProviderSessionManagerV2 revokes a rotated credential despite a stale record on another live session",
+  () =>
+    Effect.gen(function* () {
+      const state = yield* Ref.make(emptyState);
+      const mcpConfigs = yield* Ref.make<
+        ReadonlyArray<McpProviderSession.McpProviderSessionConfig | undefined>
+      >([]);
+      const effect = Effect.gen(function* () {
+        const eventSink = yield* EventSinkV2;
+        const idAllocator = yield* IdAllocatorV2;
+        const manager = yield* ProviderSessionManagerV2;
+        const registry = yield* McpSessionRegistry.McpSessionRegistry;
+        const now = yield* DateTime.now;
+        const threadId = ThreadId.make("thread-provider-session-manager-stale-record");
+        const s1 = yield* idAllocator.allocate.providerSession({
+          providerInstanceId: modelSelection.instanceId,
+          threadId,
+        });
+        const s2 = yield* idAllocator.allocate.providerSession({
+          providerInstanceId: modelSelection.instanceId,
+          threadId,
+        });
+
+        yield* eventSink.write({
+          events: [yield* makeThreadCreatedEvent({ idAllocator, threadId, now })],
+        });
+        // S1 (shared session) records credential C1 for the thread, then the
+        // thread detaches; S1 stays alive with the stale record.
+        yield* manager.open({ threadId, providerSessionId: s1, modelSelection, runtimePolicy });
+        yield* manager.detach({ providerSessionId: s1, threadId });
+
+        // The credential dies externally, so S2's attach must rotate to C2.
+        yield* registry.revokeThread(threadId);
+        yield* manager.open({ threadId, providerSessionId: s2, modelSelection, runtimePolicy });
+        const rotated = McpProviderSession.readMcpProviderSession(threadId);
+        assert.isDefined(rotated);
+        const rotatedToken = rotated?.authorizationHeader.replace(/^Bearer\s+/, "");
+        assert.isDefined(yield* registry.resolve(rotatedToken!));
+
+        // Releasing S2 must revoke C2 even though S1 still carries a stale
+        // record (of dead C1) for the same thread.
+        yield* manager.close(s2);
+        assert.isUndefined(
+          yield* registry.resolve(rotatedToken!),
+          "stale record on S1 must not veto revoking S2's rotated credential",
+        );
+        yield* manager.close(s1);
+      });
+
+      yield* effect.pipe(
+        Effect.provide(makeTestLayer({ state, idleTimeoutMs: 1_000, mcpConfigs })),
+      );
+    }),
+);
+
+it.effect(
+  "ProviderSessionManagerV2 protects a reused credential from a predecessor release during open",
+  () =>
+    Effect.gen(function* () {
+      const state = yield* Ref.make(emptyState);
+      const mcpConfigs = yield* Ref.make<
+        ReadonlyArray<McpProviderSession.McpProviderSessionConfig | undefined>
+      >([]);
+      const duringOpen = yield* Ref.make<Effect.Effect<void>>(Effect.void);
+      const effect = Effect.gen(function* () {
+        const eventSink = yield* EventSinkV2;
+        const idAllocator = yield* IdAllocatorV2;
+        const manager = yield* ProviderSessionManagerV2;
+        const registry = yield* McpSessionRegistry.McpSessionRegistry;
+        const now = yield* DateTime.now;
+        const threadId = ThreadId.make("thread-provider-session-manager-open-race");
+        const s1 = yield* idAllocator.allocate.providerSession({
+          providerInstanceId: modelSelection.instanceId,
+          threadId,
+        });
+        const s2 = yield* idAllocator.allocate.providerSession({
+          providerInstanceId: modelSelection.instanceId,
+          threadId,
+        });
+
+        yield* eventSink.write({
+          events: [yield* makeThreadCreatedEvent({ idAllocator, threadId, now })],
+        });
+        yield* manager.open({ threadId, providerSessionId: s1, modelSelection, runtimePolicy });
+        const original = (yield* Ref.get(mcpConfigs)).at(-1);
+        const originalToken = original?.authorizationHeader.replace(/^Bearer\s+/, "");
+        assert.isDefined(originalToken);
+        yield* manager.detach({ providerSessionId: s1, threadId });
+
+        // While S2's provider process is spawning (after prepare reused the
+        // credential, before the entry is visible), the predecessor session
+        // releases. Eager adapters (ACP, OpenCode) bake the credential into
+        // the process during openSession, so the release must not revoke it;
+        // rotating afterwards cannot repair those adapters.
+        yield* Ref.set(duringOpen, manager.close(s1).pipe(Effect.orDie));
+        yield* manager.open({ threadId, providerSessionId: s2, modelSelection, runtimePolicy });
+
+        const slot = McpProviderSession.readMcpProviderSession(threadId);
+        assert.equal(
+          slot?.providerSessionId,
+          original?.providerSessionId,
+          "the credential the adapter was configured with must remain current",
+        );
+        assert.equal(
+          (yield* registry.resolve(originalToken!))?.threadId,
+          threadId,
+          "the predecessor release must not revoke a credential reserved by an in-flight open",
+        );
+        yield* manager.close(s2);
+      });
+
+      yield* effect.pipe(
+        Effect.provide(
+          makeTestLayer({
+            state,
+            idleTimeoutMs: 1_000,
+            mcpConfigs,
+            beforeOpen: (input) =>
+              input.providerSessionId === undefined
+                ? Effect.void
+                : Ref.get(duringOpen).pipe(
+                    Effect.flatten,
+                    Effect.tap(() => Ref.set(duringOpen, Effect.void)),
+                  ),
+          }),
+        ),
+      );
+    }),
+);
+
+it.effect("ProviderSessionManagerV2 terminal detach revokes the thread's MCP credential", () =>
+  Effect.gen(function* () {
+    const state = yield* Ref.make(emptyState);
+    const mcpConfigs = yield* Ref.make<
+      ReadonlyArray<McpProviderSession.McpProviderSessionConfig | undefined>
+    >([]);
+    const effect = Effect.gen(function* () {
+      const eventSink = yield* EventSinkV2;
+      const idAllocator = yield* IdAllocatorV2;
+      const manager = yield* ProviderSessionManagerV2;
+      const registry = yield* McpSessionRegistry.McpSessionRegistry;
+      const now = yield* DateTime.now;
+      const threadId = ThreadId.make("thread-provider-session-manager-terminal-detach");
+      const providerSessionId = yield* idAllocator.allocate.providerSession({
+        providerInstanceId: modelSelection.instanceId,
+        threadId,
+      });
+
+      yield* eventSink.write({
+        events: [yield* makeThreadCreatedEvent({ idAllocator, threadId, now })],
+      });
+      yield* manager.open({ threadId, providerSessionId, modelSelection, runtimePolicy });
+      const issued = (yield* Ref.get(mcpConfigs)).at(-1);
+      const token = issued?.authorizationHeader.replace(/^Bearer\s+/, "");
+      assert.isDefined(yield* registry.resolve(token!));
+
+      // Archive/delete detaches carry revokeMcpCredential: the token must die
+      // with the thread even though the shared provider process lives on.
+      yield* manager.detach({
+        providerSessionId,
+        threadId,
+        detail: "Thread deleted.",
+        revokeMcpCredential: true,
+      });
+      assert.isUndefined(yield* registry.resolve(token!));
+      assert.isUndefined(McpProviderSession.readMcpProviderSession(threadId));
+    });
+
+    yield* effect.pipe(Effect.provide(makeTestLayer({ state, idleTimeoutMs: 1_000, mcpConfigs })));
+  }),
+);
+
+it.effect("ProviderSessionManagerV2 releases idle sessions without sweeping all sessions", () =>
+  Effect.gen(function* () {
+    const state = yield* Ref.make(emptyState);
+    const effect = Effect.gen(function* () {
+      const eventSink = yield* EventSinkV2;
+      const idAllocator = yield* IdAllocatorV2;
+      const manager = yield* ProviderSessionManagerV2;
+      const projectionStore = yield* ProjectionStoreV2;
+      const now = yield* DateTime.now;
+      const projectId = yield* idAllocator.allocate.project({
+        fixtureName: "provider-session-manager-idle",
+      });
+      const threadId = yield* idAllocator.allocate.thread({
+        fixtureName: "provider-session-manager-idle",
+        projectId,
+      });
+      const providerSessionId = yield* idAllocator.allocate.providerSession({
+        providerInstanceId: modelSelection.instanceId,
+        threadId,
+      });
+
+      yield* eventSink.write({
+        events: [yield* makeThreadCreatedEvent({ idAllocator, threadId, now })],
+      });
+      yield* manager.open({
+        threadId,
+        providerSessionId,
+        modelSelection,
+        runtimePolicy,
+      });
+
+      yield* TestClock.adjust("1 second");
+      yield* Effect.yieldNow;
+
+      const liveSession = yield* manager.get(providerSessionId);
+      const runtimeState = yield* Ref.get(state);
+      const projection = yield* projectionStore.getThreadProjection(threadId);
+
+      assert.isTrue(Option.isNone(liveSession));
+      assert.equal(runtimeState.openCount, 1);
+      assert.equal(runtimeState.closeCount, 1);
+      assert.equal(projection.providerSessions.at(-1)?.status, "stopped");
+    });
+
+    yield* effect.pipe(Effect.provide(makeTestLayer({ state, idleTimeoutMs: 1000 })));
+  }),
+);
+
+it.effect("ProviderSessionManagerV2 persists release when session scope close hangs", () =>
+  Effect.gen(function* () {
+    const state = yield* Ref.make(emptyState);
+    const effect = Effect.gen(function* () {
+      const eventSink = yield* EventSinkV2;
+      const idAllocator = yield* IdAllocatorV2;
+      const manager = yield* ProviderSessionManagerV2;
+      const projectionStore = yield* ProjectionStoreV2;
+      const now = yield* DateTime.now;
+      const threadId = yield* idAllocator.allocate.thread({
+        fixtureName: "provider-session-manager-hung-close",
+        projectId: yield* idAllocator.allocate.project({
+          fixtureName: "provider-session-manager-hung-close",
+        }),
+      });
+      const providerSessionId = yield* idAllocator.allocate.providerSession({
+        providerInstanceId: modelSelection.instanceId,
+        threadId,
+      });
+
+      yield* eventSink.write({
+        events: [yield* makeThreadCreatedEvent({ idAllocator, threadId, now })],
+      });
+      yield* manager.open({
+        threadId,
+        providerSessionId,
+        modelSelection,
+        runtimePolicy,
+      });
+
+      yield* TestClock.adjust("1 second");
+      yield* Effect.yieldNow;
+      assert.isTrue(Option.isNone(yield* manager.get(providerSessionId)));
+
+      yield* TestClock.adjust("30 seconds");
+      yield* Effect.yieldNow;
+      const projection = yield* projectionStore.getThreadProjection(threadId);
+      assert.equal(projection.providerSessions.at(-1)?.status, "stopped");
+      assert.equal((yield* Ref.get(state)).closeCount, 0);
+    });
+
+    yield* effect.pipe(
+      Effect.provide(makeTestLayer({ state, idleTimeoutMs: 1000, hangSessionScopeClose: true })),
+    );
+  }),
+);
+
+it.effect("ProviderSessionManagerV2 defers idle release while background work is pending", () =>
+  Effect.gen(function* () {
+    const state = yield* Ref.make(emptyState);
+    const pendingWork = yield* Ref.make(true);
+    const effect = Effect.gen(function* () {
+      const eventSink = yield* EventSinkV2;
+      const idAllocator = yield* IdAllocatorV2;
+      const manager = yield* ProviderSessionManagerV2;
+      const now = yield* DateTime.now;
+      const threadId = yield* idAllocator.allocate.thread({
+        fixtureName: "provider-session-manager-idle-pin",
+        projectId: yield* idAllocator.allocate.project({
+          fixtureName: "provider-session-manager-idle-pin",
+        }),
+      });
+      const providerSessionId = yield* idAllocator.allocate.providerSession({
+        providerInstanceId: modelSelection.instanceId,
+        threadId,
+      });
+
+      yield* eventSink.write({
+        events: [yield* makeThreadCreatedEvent({ idAllocator, threadId, now })],
+      });
+      yield* manager.open({
+        threadId,
+        providerSessionId,
+        modelSelection,
+        runtimePolicy,
+      });
+
+      yield* TestClock.adjust("3 seconds");
+      yield* Effect.yieldNow;
+      assert.isTrue(Option.isSome(yield* manager.get(providerSessionId)));
+      assert.equal((yield* Ref.get(state)).closeCount, 0);
+
+      yield* Ref.set(pendingWork, false);
+      yield* TestClock.adjust("1 second");
+      yield* Effect.yieldNow;
+      assert.isTrue(Option.isNone(yield* manager.get(providerSessionId)));
+      assert.equal((yield* Ref.get(state)).closeCount, 1);
+    });
+
+    yield* effect.pipe(
+      Effect.provide(
+        makeTestLayer({
+          state,
+          idleTimeoutMs: 1000,
+          hasPendingBackgroundWork: Ref.get(pendingWork),
+        }),
+      ),
+    );
+  }),
+);
+
+it.effect("ProviderSessionManagerV2 releases pinned idle sessions once the pin cap expires", () =>
+  Effect.gen(function* () {
+    const state = yield* Ref.make(emptyState);
+    const effect = Effect.gen(function* () {
+      const eventSink = yield* EventSinkV2;
+      const idAllocator = yield* IdAllocatorV2;
+      const manager = yield* ProviderSessionManagerV2;
+      const now = yield* DateTime.now;
+      const threadId = yield* idAllocator.allocate.thread({
+        fixtureName: "provider-session-manager-pin-cap",
+        projectId: yield* idAllocator.allocate.project({
+          fixtureName: "provider-session-manager-pin-cap",
+        }),
+      });
+      const providerSessionId = yield* idAllocator.allocate.providerSession({
+        providerInstanceId: modelSelection.instanceId,
+        threadId,
+      });
+
+      yield* eventSink.write({
+        events: [yield* makeThreadCreatedEvent({ idAllocator, threadId, now })],
+      });
+      yield* manager.open({
+        threadId,
+        providerSessionId,
+        modelSelection,
+        runtimePolicy,
+      });
+
+      yield* TestClock.adjust("3 seconds");
+      yield* Effect.yieldNow;
+      assert.isTrue(Option.isSome(yield* manager.get(providerSessionId)));
+
+      yield* TestClock.adjust("1 second");
+      yield* Effect.yieldNow;
+      assert.isTrue(Option.isNone(yield* manager.get(providerSessionId)));
+      assert.equal((yield* Ref.get(state)).closeCount, 1);
+    });
+
+    yield* effect.pipe(
+      Effect.provide(
+        makeTestLayer({
+          state,
+          idleTimeoutMs: 1000,
+          maxIdlePinMs: 3000,
+          hasPendingBackgroundWork: Effect.succeed(true),
+        }),
+      ),
+    );
+  }),
+);
+
+it.effect(
+  "ProviderSessionManagerV2 does not idle-release a session that turns busy during the pending-work check",
+  () =>
+    Effect.gen(function* () {
+      const state = yield* Ref.make(emptyState);
+      const firstCheck = yield* Ref.make(true);
+      const checkEntered = yield* Deferred.make<void>();
+      const checkGate = yield* Deferred.make<void>();
+      const effect = Effect.gen(function* () {
+        const eventSink = yield* EventSinkV2;
+        const idAllocator = yield* IdAllocatorV2;
+        const manager = yield* ProviderSessionManagerV2;
+        const projectionStore = yield* ProjectionStoreV2;
+        const now = yield* DateTime.now;
+        const projectId = yield* idAllocator.allocate.project({
+          fixtureName: "provider-session-manager-busy-during-check",
+        });
+        const threadId = yield* idAllocator.allocate.thread({
+          fixtureName: "provider-session-manager-busy-during-check",
+          projectId,
+        });
+        const providerSessionId = yield* idAllocator.allocate.providerSession({
+          providerInstanceId: modelSelection.instanceId,
+          threadId,
+        });
+        const providerThread = makeProviderThread({
+          idAllocator,
+          threadId,
+          providerSessionId,
+          now,
+        });
+        const runId = idAllocator.derive.run({ threadId, ordinal: 1 });
+        const attemptId = idAllocator.derive.runAttempt({ runId, attemptOrdinal: 1 });
+        const rootNodeId = idAllocator.derive.rootNode({ runId });
+        const providerTurnId = idAllocator.derive.providerTurn({
+          driver: CODEX_DRIVER,
+          nativeTurnId: "native-turn-busy-during-check",
+        });
+
+        yield* eventSink.write({
+          events: [yield* makeThreadCreatedEvent({ idAllocator, threadId, now })],
+        });
+        const runtime = yield* manager.open({
+          threadId,
+          providerSessionId,
+          modelSelection,
+          runtimePolicy,
+        });
+        yield* runtime.events.pipe(Stream.runDrain, Effect.forkScoped);
+        const appThread = (yield* projectionStore.getThreadProjection(threadId)).thread;
+
+        yield* TestClock.adjust("1 second");
+        yield* Deferred.await(checkEntered);
+
+        // The release fiber is parked inside the pending-work check, so the
+        // idle decision it already made is stale once this turn marks the
+        // session busy.
+        const turnFiber = yield* runtime
+          .startTurn({
+            appThread,
+            threadId,
+            runId,
+            runOrdinal: 1,
+            providerTurnOrdinal: 1,
+            attemptId,
+            rootNodeId,
+            providerThread,
+            message: {
+              createdBy: "user",
+              creationSource: "web",
+              messageId: yield* idAllocator.allocate.message({ threadId, ordinal: 1 }),
+              text: "hello",
+              attachments: [],
+            },
+            modelSelection,
+            runtimePolicy,
+          })
+          .pipe(Effect.forkDetach);
+        for (let i = 0; i < 10; i += 1) {
+          yield* Effect.yieldNow;
+        }
+        yield* Deferred.succeed(checkGate, undefined);
+        yield* Fiber.join(turnFiber);
+        yield* Effect.yieldNow;
+
+        assert.isTrue(Option.isSome(yield* manager.get(providerSessionId)));
+        assert.equal((yield* Ref.get(state)).closeCount, 0);
+
+        const queue = (yield* Ref.get(state)).eventQueues.get(String(providerSessionId));
+        assert.isDefined(queue);
+        yield* Queue.offer(queue!, {
+          type: "turn.terminal",
+          driver: CODEX_DRIVER,
+          providerThreadId: providerThread.id,
+          providerTurnId,
+          runOrdinal: 1,
+          status: "completed",
+          failure: null,
+          threadDisposition: "reusable",
+        });
+        yield* TestClock.adjust("1 second");
+        yield* Effect.yieldNow;
+        assert.isTrue(Option.isNone(yield* manager.get(providerSessionId)));
+        assert.equal((yield* Ref.get(state)).closeCount, 1);
+      });
+
+      yield* effect.pipe(
+        Effect.provide(
+          makeTestLayer({
+            state,
+            idleTimeoutMs: 1000,
+            // Uninterruptible so the markBusy-triggered interrupt cannot land
+            // inside the check, mirroring an adapter that masks interruption
+            // while inspecting its own state.
+            hasPendingBackgroundWork: Effect.uninterruptible(
+              Effect.gen(function* () {
+                if (yield* Ref.getAndSet(firstCheck, false)) {
+                  yield* Deferred.succeed(checkEntered, undefined);
+                  yield* Deferred.await(checkGate);
+                }
+                return false;
+              }),
+            ),
+          }),
+        ),
+      );
+    }),
+);
+
+it.effect("ProviderSessionManagerV2 does not apply a stale idle pin to a replacement session", () =>
+  Effect.gen(function* () {
+    const state = yield* Ref.make(emptyState);
+    const firstCheck = yield* Ref.make(true);
+    const checkEntered = yield* Deferred.make<void>();
+    const checkGate = yield* Deferred.make<void>();
+    const effect = Effect.gen(function* () {
+      const eventSink = yield* EventSinkV2;
+      const idAllocator = yield* IdAllocatorV2;
+      const manager = yield* ProviderSessionManagerV2;
+      const now = yield* DateTime.now;
+      const threadId = yield* idAllocator.allocate.thread({
+        fixtureName: "provider-session-manager-stale-pin",
+        projectId: yield* idAllocator.allocate.project({
+          fixtureName: "provider-session-manager-stale-pin",
+        }),
+      });
+      const providerSessionId = yield* idAllocator.allocate.providerSession({
+        providerInstanceId: modelSelection.instanceId,
+        threadId,
+      });
+
+      yield* eventSink.write({
+        events: [yield* makeThreadCreatedEvent({ idAllocator, threadId, now })],
+      });
+      yield* manager.open({
+        threadId,
+        providerSessionId,
+        modelSelection,
+        runtimePolicy,
+      });
+
+      // Park the first idle fiber inside an uninterruptible pending-work probe.
+      yield* TestClock.adjust("1 second");
+      yield* Deferred.await(checkEntered);
+
+      // close removes the map entry first, then waits to interrupt the idle
+      // fiber (still uninterruptible). That window lets a replacement open
+      // under the same providerSessionId before the stale probe finishes.
+      const closeFiber = yield* manager.close(providerSessionId).pipe(Effect.forkDetach);
+      for (let i = 0; i < 20; i += 1) {
+        yield* Effect.yieldNow;
+      }
+      yield* manager.open({
+        threadId,
+        providerSessionId,
+        modelSelection,
+        runtimePolicy,
+      });
+      assert.equal((yield* Ref.get(state)).openCount, 2);
+
+      // Stale probe reports pending work against the old runtime; the pin
+      // stamp must no-op on the replacement (runtime / generation mismatch).
+      yield* Deferred.succeed(checkGate, undefined);
+      yield* Fiber.join(closeFiber);
+      for (let i = 0; i < 10; i += 1) {
+        yield* Effect.yieldNow;
+      }
+
+      assert.isTrue(Option.isSome(yield* manager.get(providerSessionId)));
+      assert.equal((yield* Ref.get(state)).closeCount, 1);
+
+      // Replacement has no pending background work. After one idle window it
+      // must release. A stale pin stamp would have deferred release until
+      // maxIdlePinMs.
+      yield* TestClock.adjust("1 second");
+      yield* Effect.yieldNow;
+      assert.isTrue(Option.isNone(yield* manager.get(providerSessionId)));
+      assert.equal((yield* Ref.get(state)).closeCount, 2);
+    });
+
+    yield* effect.pipe(
+      Effect.provide(
+        makeTestLayer({
+          state,
+          idleTimeoutMs: 1000,
+          maxIdlePinMs: 60_000,
+          hasPendingBackgroundWork: Effect.uninterruptible(
+            Effect.gen(function* () {
+              if (yield* Ref.getAndSet(firstCheck, false)) {
+                yield* Deferred.succeed(checkEntered, undefined);
+                yield* Deferred.await(checkGate);
+                return true;
+              }
+              return false;
+            }),
+          ),
+        }),
+      ),
+    );
+  }),
+);
+
+it.effect(
+  "ProviderSessionManagerV2 keeps active sessions alive until the provider turn terminates",
+  () =>
+    Effect.gen(function* () {
+      const state = yield* Ref.make(emptyState);
+      const effect = Effect.gen(function* () {
+        const eventSink = yield* EventSinkV2;
+        const idAllocator = yield* IdAllocatorV2;
+        const manager = yield* ProviderSessionManagerV2;
+        const projectionStore = yield* ProjectionStoreV2;
+        const now = yield* DateTime.now;
+        const projectId = yield* idAllocator.allocate.project({
+          fixtureName: "provider-session-manager-active",
+        });
+        const threadId = yield* idAllocator.allocate.thread({
+          fixtureName: "provider-session-manager-active",
+          projectId,
+        });
+        const providerSessionId = yield* idAllocator.allocate.providerSession({
+          providerInstanceId: modelSelection.instanceId,
+          threadId,
+        });
+        const providerThread = makeProviderThread({
+          idAllocator,
+          threadId,
+          providerSessionId,
+          now,
+        });
+        const runId = idAllocator.derive.run({ threadId, ordinal: 1 });
+        const attemptId = idAllocator.derive.runAttempt({ runId, attemptOrdinal: 1 });
+        const rootNodeId = idAllocator.derive.rootNode({ runId });
+        const providerTurnId = idAllocator.derive.providerTurn({
+          driver: CODEX_DRIVER,
+          nativeTurnId: "native-turn",
+        });
+
+        yield* eventSink.write({
+          events: [yield* makeThreadCreatedEvent({ idAllocator, threadId, now })],
+        });
+        const runtime = yield* manager.open({
+          threadId,
+          providerSessionId,
+          modelSelection,
+          runtimePolicy,
+        });
+        yield* runtime.events.pipe(Stream.runDrain, Effect.forkScoped);
+        const appThread = (yield* projectionStore.getThreadProjection(threadId)).thread;
+        yield* runtime.startTurn({
+          appThread,
+          threadId,
+          runId,
+          runOrdinal: 1,
+          providerTurnOrdinal: 1,
+          attemptId,
+          rootNodeId,
+          providerThread,
+          message: {
+            createdBy: "user",
+            creationSource: "web",
+            messageId: yield* idAllocator.allocate.message({ threadId, ordinal: 1 }),
+            text: "hello",
+            attachments: [],
+          },
+          modelSelection,
+          runtimePolicy,
+        });
+
+        yield* TestClock.adjust("2 seconds");
+        yield* Effect.yieldNow;
+        assert.equal((yield* Ref.get(state)).closeCount, 0);
+
+        const queue = (yield* Ref.get(state)).eventQueues.get(String(providerSessionId));
+        assert.isDefined(queue);
+        yield* Queue.offer(queue!, {
+          type: "turn.terminal",
+          driver: CODEX_DRIVER,
+          providerThreadId: providerThread.id,
+          providerTurnId,
+          runOrdinal: 1,
+          status: "completed",
+          failure: null,
+          threadDisposition: "reusable",
+        });
+        yield* TestClock.adjust("1 second");
+        yield* Effect.yieldNow;
+
+        const liveSession = yield* manager.get(providerSessionId);
+        const projection = yield* projectionStore.getThreadProjection(threadId);
+        assert.isTrue(Option.isNone(liveSession));
+        assert.equal((yield* Ref.get(state)).closeCount, 1);
+        assert.equal(projection.providerSessions.at(-1)?.status, "stopped");
+      });
+
+      yield* effect.pipe(Effect.provide(makeTestLayer({ state, idleTimeoutMs: 1000 })));
+    }),
+);
+
+it.effect("ProviderSessionManagerV2 uses the same release path for runtime failures", () =>
+  Effect.gen(function* () {
+    const state = yield* Ref.make(emptyState);
+    const effect = Effect.gen(function* () {
+      const eventSink = yield* EventSinkV2;
+      const idAllocator = yield* IdAllocatorV2;
+      const manager = yield* ProviderSessionManagerV2;
+      const projectionStore = yield* ProjectionStoreV2;
+      const now = yield* DateTime.now;
+      const projectId = yield* idAllocator.allocate.project({
+        fixtureName: "provider-session-manager-runtime-error",
+      });
+      const threadId = yield* idAllocator.allocate.thread({
+        fixtureName: "provider-session-manager-runtime-error",
+        projectId,
+      });
+      const providerSessionId = yield* idAllocator.allocate.providerSession({
+        providerInstanceId: modelSelection.instanceId,
+        threadId,
+      });
+
+      yield* eventSink.write({
+        events: [yield* makeThreadCreatedEvent({ idAllocator, threadId, now })],
+      });
+      yield* manager.open({
+        threadId,
+        providerSessionId,
+        modelSelection,
+        runtimePolicy,
+      });
+      yield* manager.release({
+        providerSessionId,
+        reason: "runtime_error",
+        detail: "process exited",
+      });
+
+      const liveSession = yield* manager.get(providerSessionId);
+      const runtimeState = yield* Ref.get(state);
+      const projection = yield* projectionStore.getThreadProjection(threadId);
+
+      assert.isTrue(Option.isNone(liveSession));
+      assert.equal(runtimeState.closeCount, 1);
+      assert.equal(projection.providerSessions.at(-1)?.status, "error");
+      assert.equal(projection.providerSessions.at(-1)?.lastError, "process exited");
+    });
+
+    yield* effect.pipe(Effect.provide(makeTestLayer({ state, idleTimeoutMs: 1000 })));
+  }),
+);
+
+it.effect("ProviderSessionManagerV2 releases sessions when provider event streams fail", () =>
+  Effect.gen(function* () {
+    const state = yield* Ref.make(emptyState);
+    const effect = Effect.gen(function* () {
+      const eventSink = yield* EventSinkV2;
+      const idAllocator = yield* IdAllocatorV2;
+      const manager = yield* ProviderSessionManagerV2;
+      const projectionStore = yield* ProjectionStoreV2;
+      const now = yield* DateTime.now;
+      const projectId = yield* idAllocator.allocate.project({
+        fixtureName: "provider-session-manager-stream-error",
+      });
+      const threadId = yield* idAllocator.allocate.thread({
+        fixtureName: "provider-session-manager-stream-error",
+        projectId,
+      });
+      const providerSessionId = yield* idAllocator.allocate.providerSession({
+        providerInstanceId: modelSelection.instanceId,
+        threadId,
+      });
+
+      yield* eventSink.write({
+        events: [yield* makeThreadCreatedEvent({ idAllocator, threadId, now })],
+      });
+      const runtime = yield* manager.open({
+        threadId,
+        providerSessionId,
+        modelSelection,
+        runtimePolicy,
+      });
+      yield* runtime.events.pipe(Stream.runDrain, Effect.ignore, Effect.forkScoped);
+      yield* Effect.yieldNow;
+
+      const liveSession = yield* manager.get(providerSessionId);
+      const runtimeState = yield* Ref.get(state);
+      const projection = yield* projectionStore.getThreadProjection(threadId);
+
+      assert.isTrue(Option.isNone(liveSession));
+      assert.equal(runtimeState.closeCount, 1);
+      assert.equal(projection.providerSessions.at(-1)?.status, "error");
+    });
+
+    yield* effect.pipe(
+      Effect.provide(
+        makeTestLayer({
+          state,
+          idleTimeoutMs: 1000,
+          failEventStream: true,
+        }),
+      ),
+    );
+  }),
+);
+
+it.effect("ProviderSessionManagerV2 marks pending runtime requests non-live on release", () =>
+  Effect.gen(function* () {
+    const state = yield* Ref.make(emptyState);
+    const effect = Effect.gen(function* () {
+      const eventSink = yield* EventSinkV2;
+      const idAllocator = yield* IdAllocatorV2;
+      const manager = yield* ProviderSessionManagerV2;
+      const projectionStore = yield* ProjectionStoreV2;
+      const now = yield* DateTime.now;
+      const projectId = yield* idAllocator.allocate.project({
+        fixtureName: "provider-session-manager-request-expire",
+      });
+      const threadId = yield* idAllocator.allocate.thread({
+        fixtureName: "provider-session-manager-request-expire",
+        projectId,
+      });
+      const providerSessionId = yield* idAllocator.allocate.providerSession({
+        providerInstanceId: modelSelection.instanceId,
+        threadId,
+      });
+      const providerThread = makeProviderThread({
+        idAllocator,
+        threadId,
+        providerSessionId,
+        now,
+      });
+
+      yield* eventSink.write({
+        events: [yield* makeThreadCreatedEvent({ idAllocator, threadId, now })],
+      });
+      yield* eventSink.write({
+        events: yield* makePendingRuntimeRequestEvents({
+          idAllocator,
+          threadId,
+          providerSessionId,
+          providerThread,
+          now,
+        }),
+      });
+      yield* manager.open({
+        threadId,
+        providerSessionId,
+        modelSelection,
+        runtimePolicy,
+      });
+      yield* manager.release({
+        providerSessionId,
+        reason: "runtime_error",
+        detail: "process exited",
+      });
+
+      const projection = yield* projectionStore.getThreadProjection(threadId);
+      const request = projection.runtimeRequests.at(-1);
+      const requestNode = projection.nodes.find((node) => node.id === request?.nodeId);
+      const requestTurnItem = projection.turnItems.find(
+        (item) => item.type === "approval_request" && item.requestId === request?.id,
+      );
+
+      assert.equal(request?.status, "expired");
+      assert.equal(request?.responseCapability.type, "not_resumable");
+      assert.equal(requestNode?.status, "failed");
+      assert.equal(requestTurnItem?.status, "failed");
+    });
+
+    yield* effect.pipe(Effect.provide(makeTestLayer({ state, idleTimeoutMs: 1000 })));
+  }),
+);
+
+it.effect(
+  "ProviderSessionManagerV2 keeps a multi-thread session alive until all turns finish",
+  () =>
+    Effect.gen(function* () {
+      const state = yield* Ref.make(emptyState);
+      const effect = Effect.gen(function* () {
+        const eventSink = yield* EventSinkV2;
+        const idAllocator = yield* IdAllocatorV2;
+        const manager = yield* ProviderSessionManagerV2;
+        const projectionStore = yield* ProjectionStoreV2;
+        const now = yield* DateTime.now;
+        const projectId = yield* idAllocator.allocate.project({
+          fixtureName: "provider-session-manager-multi-thread-active",
+        });
+        const firstThreadId = yield* idAllocator.allocate.thread({
+          fixtureName: "provider-session-manager-multi-thread-active-a",
+          projectId,
+        });
+        const secondThreadId = yield* idAllocator.allocate.thread({
+          fixtureName: "provider-session-manager-multi-thread-active-b",
+          projectId,
+        });
+        const providerSessionId = yield* idAllocator.allocate.providerSession({
+          providerInstanceId: modelSelection.instanceId,
+          threadId: firstThreadId,
+        });
+        const firstProviderThread = makeProviderThread({
+          idAllocator,
+          threadId: firstThreadId,
+          providerSessionId,
+          now,
+        });
+        const secondProviderThread = makeProviderThread({
+          idAllocator,
+          threadId: secondThreadId,
+          providerSessionId,
+          now,
+        });
+        const firstRunId = idAllocator.derive.run({ threadId: firstThreadId, ordinal: 1 });
+        const secondRunId = idAllocator.derive.run({ threadId: secondThreadId, ordinal: 1 });
+        const firstProviderTurnId = idAllocator.derive.providerTurn({
+          driver: CODEX_DRIVER,
+          nativeTurnId: "native-turn-a",
+        });
+        const secondProviderTurnId = idAllocator.derive.providerTurn({
+          driver: CODEX_DRIVER,
+          nativeTurnId: "native-turn-b",
+        });
+
+        yield* eventSink.write({
+          events: [
+            yield* makeThreadCreatedEvent({ idAllocator, threadId: firstThreadId, now }),
+            yield* makeThreadCreatedEvent({ idAllocator, threadId: secondThreadId, now }),
+          ],
+        });
+        const runtime = yield* manager.open({
+          threadId: firstThreadId,
+          providerSessionId,
+          modelSelection,
+          runtimePolicy,
+        });
+        yield* manager.open({
+          threadId: secondThreadId,
+          providerSessionId,
+          modelSelection,
+          runtimePolicy,
+        });
+        yield* runtime.events.pipe(Stream.runDrain, Effect.forkScoped);
+        const firstAppThread = (yield* projectionStore.getThreadProjection(firstThreadId)).thread;
+        const secondAppThread = (yield* projectionStore.getThreadProjection(secondThreadId)).thread;
+        yield* runtime.startTurn({
+          appThread: firstAppThread,
+          threadId: firstThreadId,
+          runId: firstRunId,
+          runOrdinal: 1,
+          providerTurnOrdinal: 1,
+          attemptId: idAllocator.derive.runAttempt({ runId: firstRunId, attemptOrdinal: 1 }),
+          rootNodeId: idAllocator.derive.rootNode({ runId: firstRunId }),
+          providerThread: firstProviderThread,
+          message: {
+            createdBy: "user",
+            creationSource: "web",
+            messageId: yield* idAllocator.allocate.message({ threadId: firstThreadId, ordinal: 1 }),
+            text: "first",
+            attachments: [],
+          },
+          modelSelection,
+          runtimePolicy,
+        });
+        yield* runtime.startTurn({
+          appThread: secondAppThread,
+          threadId: secondThreadId,
+          runId: secondRunId,
+          runOrdinal: 1,
+          providerTurnOrdinal: 1,
+          attemptId: idAllocator.derive.runAttempt({ runId: secondRunId, attemptOrdinal: 1 }),
+          rootNodeId: idAllocator.derive.rootNode({ runId: secondRunId }),
+          providerThread: secondProviderThread,
+          message: {
+            createdBy: "user",
+            creationSource: "web",
+            messageId: yield* idAllocator.allocate.message({
+              threadId: secondThreadId,
+              ordinal: 1,
+            }),
+            text: "second",
+            attachments: [],
+          },
+          modelSelection,
+          runtimePolicy,
+        });
+
+        const queue = (yield* Ref.get(state)).eventQueues.get(String(providerSessionId));
+        assert.isDefined(queue);
+        yield* Queue.offer(queue!, {
+          type: "turn.terminal",
+          driver: CODEX_DRIVER,
+          providerThreadId: firstProviderThread.id,
+          providerTurnId: firstProviderTurnId,
+          runOrdinal: 1,
+          status: "completed",
+          failure: null,
+          threadDisposition: "reusable",
+        });
+        yield* TestClock.adjust("2 seconds");
+        yield* Effect.yieldNow;
+        assert.equal((yield* Ref.get(state)).closeCount, 0);
+
+        yield* Queue.offer(queue!, {
+          type: "turn.terminal",
+          driver: CODEX_DRIVER,
+          providerThreadId: secondProviderThread.id,
+          providerTurnId: secondProviderTurnId,
+          runOrdinal: 1,
+          status: "completed",
+          failure: null,
+          threadDisposition: "reusable",
+        });
+        yield* TestClock.adjust("1 second");
+        yield* Effect.yieldNow;
+        assert.equal((yield* Ref.get(state)).closeCount, 1);
+      });
+
+      yield* effect.pipe(Effect.provide(makeTestLayer({ state, idleTimeoutMs: 1000 })));
+    }),
+);
+
+it.effect(
+  "ProviderSessionManagerV2 opens one shared runtime, broadcasts events, and detaches threads independently",
+  () =>
+    Effect.gen(function* () {
+      const state = yield* Ref.make(emptyState);
+      const effect = Effect.gen(function* () {
+        const eventSink = yield* EventSinkV2;
+        const idAllocator = yield* IdAllocatorV2;
+        const manager = yield* ProviderSessionManagerV2;
+        const now = yield* DateTime.now;
+        const projectId = yield* idAllocator.allocate.project({
+          fixtureName: "provider-session-manager-shared-runtime",
+        });
+        const firstThreadId = yield* idAllocator.allocate.thread({
+          fixtureName: "provider-session-manager-shared-runtime-a",
+          projectId,
+        });
+        const secondThreadId = yield* idAllocator.allocate.thread({
+          fixtureName: "provider-session-manager-shared-runtime-b",
+          projectId,
+        });
+        const providerSessionId = idAllocator.derive.providerSession({
+          providerInstanceId: modelSelection.instanceId,
+        });
+
+        yield* eventSink.write({
+          events: [
+            yield* makeThreadCreatedEvent({ idAllocator, threadId: firstThreadId, now }),
+            yield* makeThreadCreatedEvent({ idAllocator, threadId: secondThreadId, now }),
+          ],
+        });
+        const firstProviderThread = makeProviderThread({
+          idAllocator,
+          threadId: firstThreadId,
+          providerSessionId,
+          now,
+        });
+        const secondProviderThread = makeProviderThread({
+          idAllocator,
+          threadId: secondThreadId,
+          providerSessionId,
+          now,
+        });
+        const firstRunId = idAllocator.derive.run({ threadId: firstThreadId, ordinal: 1 });
+        yield* eventSink.write({
+          events: [
+            {
+              id: yield* idAllocator.allocate.event({ threadId: firstThreadId }),
+              type: "provider-thread.updated",
+              threadId: firstThreadId,
+              driver: CODEX_DRIVER,
+              occurredAt: now,
+              payload: firstProviderThread,
+            },
+            {
+              id: yield* idAllocator.allocate.event({ threadId: firstThreadId }),
+              type: "provider-turn.updated",
+              threadId: firstThreadId,
+              runId: firstRunId,
+              driver: CODEX_DRIVER,
+              occurredAt: now,
+              payload: {
+                id: idAllocator.derive.providerTurn({
+                  driver: CODEX_DRIVER,
+                  nativeTurnId: "native-turn-shared-runtime-a",
+                }),
+                providerThreadId: firstProviderThread.id,
+                nodeId: idAllocator.derive.rootNode({ runId: firstRunId }),
+                runAttemptId: null,
+                nativeTurnRef: null,
+                ordinal: 1,
+                status: "running",
+                startedAt: now,
+                completedAt: null,
+              },
+            },
+          ],
+        });
+        const firstRuntime = yield* manager.open({
+          threadId: firstThreadId,
+          providerSessionId,
+          modelSelection,
+          runtimePolicy,
+        });
+        const secondRuntime = yield* manager.open({
+          threadId: secondThreadId,
+          providerSessionId,
+          modelSelection,
+          runtimePolicy,
+        });
+
+        assert.strictEqual(firstRuntime, secondRuntime);
+        assert.equal((yield* Ref.get(state)).openCount, 1);
+        const resumeSecondThread = secondRuntime.resumeThread({
+          providerThread: secondProviderThread,
+          threadId: secondThreadId,
+          modelSelection,
+          runtimePolicy,
+        });
+        yield* resumeSecondThread;
+        yield* resumeSecondThread;
+        assert.equal((yield* Ref.get(state)).resumeCount, 1);
+        yield* secondRuntime.resumeThread({
+          providerThread: secondProviderThread,
+          threadId: secondThreadId,
+          modelSelection: { ...modelSelection, model: "gpt-5.4-mini" },
+          runtimePolicy,
+        });
+        assert.equal((yield* Ref.get(state)).resumeCount, 2);
+        yield* resumeSecondThread;
+        assert.equal((yield* Ref.get(state)).resumeCount, 3);
+        const subscribe = firstRuntime.subscribeEvents;
+        assert.isDefined(subscribe);
+        if (subscribe === undefined) return;
+        const firstSubscription = yield* subscribe;
+        const secondSubscription = yield* subscribe;
+        const queue = (yield* Ref.get(state)).eventQueues.get(String(providerSessionId));
+        assert.isDefined(queue);
+        yield* Queue.offer(queue!, {
+          type: "provider_session.updated",
+          driver: CODEX_DRIVER,
+          providerSession: firstRuntime.providerSession,
+        });
+        const received = yield* Effect.all([
+          firstSubscription.events.pipe(Stream.runHead),
+          secondSubscription.events.pipe(Stream.runHead),
+        ]);
+        assert.isTrue(received.every(Option.isSome));
+        assert.isTrue(
+          received.every(
+            (event) => Option.isSome(event) && event.value.type === "provider_session.updated",
+          ),
+        );
+
+        yield* manager.detach({ providerSessionId, threadId: secondThreadId });
+        yield* manager.open({
+          threadId: secondThreadId,
+          providerSessionId,
+          modelSelection,
+          runtimePolicy,
+        });
+        yield* resumeSecondThread;
+        assert.equal((yield* Ref.get(state)).resumeCount, 4);
+
+        yield* manager.detach({ providerSessionId, threadId: firstThreadId });
+        assert.isTrue(Option.isSome(yield* manager.get(providerSessionId)));
+        assert.equal((yield* Ref.get(state)).closeCount, 0);
+        assert.equal((yield* Ref.get(state)).interruptCount, 1);
+
+        yield* manager.detach({ providerSessionId, threadId: secondThreadId });
+        yield* TestClock.adjust("1 second");
+        yield* Effect.yieldNow;
+        assert.equal((yield* Ref.get(state)).closeCount, 1);
+      });
+
+      yield* effect.pipe(Effect.provide(makeTestLayer({ state, idleTimeoutMs: 1000 })));
+    }),
+);
+
+it.effect(
+  "ProviderSessionManagerV2 rejects a second thread when the provider runtime is exclusive",
+  () =>
+    Effect.gen(function* () {
+      const state = yield* Ref.make(emptyState);
+      const effect = Effect.gen(function* () {
+        const eventSink = yield* EventSinkV2;
+        const idAllocator = yield* IdAllocatorV2;
+        const manager = yield* ProviderSessionManagerV2;
+        const now = yield* DateTime.now;
+        const projectId = yield* idAllocator.allocate.project({
+          fixtureName: "provider-session-manager-exclusive-runtime",
+        });
+        const firstThreadId = yield* idAllocator.allocate.thread({
+          fixtureName: "provider-session-manager-exclusive-runtime-a",
+          projectId,
+        });
+        const secondThreadId = yield* idAllocator.allocate.thread({
+          fixtureName: "provider-session-manager-exclusive-runtime-b",
+          projectId,
+        });
+        const providerSessionId = yield* idAllocator.allocate.providerSession({
+          providerInstanceId: modelSelection.instanceId,
+          threadId: firstThreadId,
+        });
+        yield* eventSink.write({
+          events: [
+            yield* makeThreadCreatedEvent({ idAllocator, threadId: firstThreadId, now }),
+            yield* makeThreadCreatedEvent({ idAllocator, threadId: secondThreadId, now }),
+          ],
+        });
+
+        yield* manager.open({
+          threadId: firstThreadId,
+          providerSessionId,
+          modelSelection,
+          runtimePolicy,
+        });
+        const error = yield* manager
+          .open({
+            threadId: secondThreadId,
+            providerSessionId,
+            modelSelection,
+            runtimePolicy,
+          })
+          .pipe(Effect.flip);
+
+        assert.equal(error._tag, "ProviderSessionOpenError");
+        assert.equal((yield* Ref.get(state)).openCount, 1);
+      });
+
+      yield* effect.pipe(
+        Effect.provide(
+          makeTestLayer({ state, idleTimeoutMs: 1000, capabilities: ExclusiveCapabilities }),
+        ),
+      );
+    }),
+);
diff --git a/apps/server/src/orchestration-v2/ProviderSessionManager.ts b/apps/server/src/orchestration-v2/ProviderSessionManager.ts
new file mode 100644
index 000000000000..7b3c93169bf9
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ProviderSessionManager.ts
@@ -0,0 +1,1685 @@
+import {
+  ModelSelection,
+  OrchestrationV2DomainEvent,
+  OrchestrationV2ProviderSession,
+  OrchestrationV2RuntimeRequest,
+  ProviderInstanceId,
+  ProviderSessionId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as Cause from "effect/Cause";
+import * as Clock from "effect/Clock";
+import * as Context from "effect/Context";
+import * as DateTime from "effect/DateTime";
+import * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as Fiber from "effect/Fiber";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Queue from "effect/Queue";
+import * as Ref from "effect/Ref";
+import * as Schema from "effect/Schema";
+import * as Scope from "effect/Scope";
+import * as Stream from "effect/Stream";
+
+import * as McpProviderSession from "../mcp/McpProviderSession.ts";
+import * as ServerSettings from "../serverSettings.ts";
+import * as McpSessionRegistry from "../mcp/McpSessionRegistry.ts";
+import { EventSinkV2 } from "./EventSink.ts";
+import { IdAllocatorV2 } from "./IdAllocator.ts";
+import { makeKeyedSerialExecutor } from "./KeyedSerialExecutor.ts";
+import {
+  ProviderAdapterEventStreamError,
+  ProviderAdapterV2RuntimePolicy,
+  type ProviderAdapterV2Error,
+  type ProviderAdapterV2Event,
+  type ProviderAdapterV2EventSubscription,
+  type ProviderAdapterV2SessionRuntime,
+} from "./ProviderAdapter.ts";
+import { ProviderAdapterRegistryV2 } from "./ProviderAdapterRegistry.ts";
+import { ProjectionStoreV2 } from "./ProjectionStore.ts";
+
+const DEFAULT_IDLE_TIMEOUT_MS = 30 * 60 * 1000;
+const DEFAULT_MAX_IDLE_PIN_MS = 4 * 60 * 60 * 1000;
+const RELEASE_SCOPE_CLOSE_TIMEOUT_MS = 30 * 1000;
+
+export const ProviderSessionReleaseReason = Schema.Literals([
+  "idle_timeout",
+  "runtime_error",
+  "manual_shutdown",
+  "server_shutdown",
+]);
+export type ProviderSessionReleaseReason = typeof ProviderSessionReleaseReason.Type;
+
+/**
+ * ProviderSessionManager owns live session residency: open sessions, idle release,
+ * explicit shutdown, and release-on-runtime-failure.
+ *
+ * It intentionally does not resurrect persisted sessions. Process-loss recovery
+ * terminalizes provider-bound work and retires non-replayable effects; a later
+ * user command or durable replay-safe operation opens a session lazily.
+ */
+export class ProviderSessionOpenError extends Schema.TaggedErrorClass<ProviderSessionOpenError>()(
+  "ProviderSessionOpenError",
+  {
+    instanceId: ProviderInstanceId,
+    providerSessionId: ProviderSessionId,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to open provider instance ${this.instanceId} session ${this.providerSessionId}.`;
+  }
+}
+
+export class ProviderSessionLookupError extends Schema.TaggedErrorClass<ProviderSessionLookupError>()(
+  "ProviderSessionLookupError",
+  {
+    providerSessionId: ProviderSessionId,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to look up provider session ${this.providerSessionId}.`;
+  }
+}
+
+export class ProviderSessionCloseError extends Schema.TaggedErrorClass<ProviderSessionCloseError>()(
+  "ProviderSessionCloseError",
+  {
+    providerSessionId: ProviderSessionId,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to close provider session ${this.providerSessionId}.`;
+  }
+}
+
+export class ProviderSessionReleaseError extends Schema.TaggedErrorClass<ProviderSessionReleaseError>()(
+  "ProviderSessionReleaseError",
+  {
+    providerSessionId: ProviderSessionId,
+    reason: ProviderSessionReleaseReason,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to release provider session ${this.providerSessionId}.`;
+  }
+}
+
+export class ProviderSessionActivityError extends Schema.TaggedErrorClass<ProviderSessionActivityError>()(
+  "ProviderSessionActivityError",
+  {
+    providerSessionId: ProviderSessionId,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to update provider session activity for ${this.providerSessionId}.`;
+  }
+}
+
+export const ProviderSessionManagerV2Error = Schema.Union([
+  ProviderSessionOpenError,
+  ProviderSessionLookupError,
+  ProviderSessionCloseError,
+  ProviderSessionReleaseError,
+  ProviderSessionActivityError,
+]);
+export type ProviderSessionManagerV2Error = typeof ProviderSessionManagerV2Error.Type;
+
+export interface ProviderSessionManagerV2Shape {
+  readonly shutdown: Effect.Effect<void>;
+  readonly open: (input: {
+    readonly threadId: ThreadId;
+    readonly providerSessionId: ProviderSessionId;
+    readonly modelSelection: ModelSelection;
+    readonly runtimePolicy: ProviderAdapterV2RuntimePolicy;
+    readonly resumeFromSession?: OrchestrationV2ProviderSession;
+  }) => Effect.Effect<ProviderAdapterV2SessionRuntime, ProviderSessionManagerV2Error>;
+  readonly get: (
+    providerSessionId: ProviderSessionId,
+  ) => Effect.Effect<Option.Option<ProviderAdapterV2SessionRuntime>, ProviderSessionManagerV2Error>;
+  readonly close: (
+    providerSessionId: ProviderSessionId,
+  ) => Effect.Effect<void, ProviderSessionManagerV2Error>;
+  readonly release: (input: {
+    readonly providerSessionId: ProviderSessionId;
+    readonly reason: ProviderSessionReleaseReason;
+    readonly detail?: string;
+  }) => Effect.Effect<void, ProviderSessionManagerV2Error>;
+  readonly detach: (input: {
+    readonly providerSessionId: ProviderSessionId;
+    readonly threadId: ThreadId;
+    readonly detail?: string;
+    /**
+     * True for terminal detaches (thread archived or deleted): the thread's
+     * MCP credentials are revoked immediately instead of surviving for a
+     * potential re-attach.
+     */
+    readonly revokeMcpCredential?: boolean;
+  }) => Effect.Effect<void, ProviderSessionManagerV2Error>;
+}
+
+export class ProviderSessionManagerV2 extends Context.Service<
+  ProviderSessionManagerV2,
+  ProviderSessionManagerV2Shape
+>()("t3/orchestration-v2/ProviderSessionManager/ProviderSessionManagerV2") {}
+
+interface LiveSessionEntry {
+  readonly attachedThreadIds: ReadonlySet<ThreadId>;
+  readonly loadedProviderThreadKeyByThread: ReadonlyMap<ThreadId, string>;
+  /**
+   * MCP credential session id issued for each attached thread. Revocation on
+   * detach/release is scoped to these ids so tearing down a superseded
+   * session cannot revoke a replacement session's credential for the same
+   * thread (the workspace-handoff sequence opens the replacement before the
+   * outbox executes the old session's detach).
+   */
+  readonly mcpCredentialIdByThread: ReadonlyMap<ThreadId, string>;
+  readonly supportsMultipleProviderThreads: boolean;
+  readonly runtime: ProviderAdapterV2SessionRuntime;
+  readonly exposedRuntime: ProviderAdapterV2SessionRuntime;
+  readonly eventSubscribers: Ref.Ref<
+    ReadonlyMap<number, Queue.Queue<ProviderSessionEventSignal, Cause.Done>>
+  >;
+  readonly scope: Scope.Closeable;
+  readonly idleGeneration: number;
+  readonly busyCount: number;
+  readonly lastActivityAtMs: number;
+  readonly idleFiber: Fiber.Fiber<void, never> | null;
+  /** Set when idle release is deferred for pending background work; bounds total deferral. */
+  readonly pinnedSinceMs: number | null;
+}
+
+type ProviderSessionEventSignal =
+  | { readonly type: "event"; readonly event: ProviderAdapterV2Event }
+  | {
+      readonly type: "failure";
+      readonly cause: Cause.Cause<ProviderAdapterV2Error>;
+    };
+
+export interface ProviderSessionManagerV2LayerOptions {
+  readonly idleTimeoutMs?: number;
+  /** Cap on how long idle release may be deferred for pending background work. */
+  readonly maxIdlePinMs?: number;
+  /** Test replay harnesses can omit T3's MCP server from provider protocol fixtures. */
+  readonly configureMcp?: boolean;
+}
+
+function releaseStatusFor(
+  reason: ProviderSessionReleaseReason,
+): OrchestrationV2ProviderSession["status"] {
+  return reason === "runtime_error" ? "error" : "stopped";
+}
+
+function releasedRuntimeRequestStatusFor(
+  reason: ProviderSessionReleaseReason,
+): OrchestrationV2RuntimeRequest["status"] {
+  return reason === "manual_shutdown" || reason === "server_shutdown" ? "cancelled" : "expired";
+}
+
+function sessionKey(providerSessionId: ProviderSessionId): string {
+  return String(providerSessionId);
+}
+
+function providerThreadRuntimeKey(
+  providerThread: Parameters<ProviderAdapterV2SessionRuntime["resumeThread"]>[0]["providerThread"],
+): string {
+  const nativeThreadRef = providerThread.nativeThreadRef;
+  return nativeThreadRef === null
+    ? String(providerThread.id)
+    : `${nativeThreadRef.driver}:${nativeThreadRef.nativeId}`;
+}
+
+function providerThreadLoadKey(input: {
+  readonly providerThread: Parameters<
+    ProviderAdapterV2SessionRuntime["resumeThread"]
+  >[0]["providerThread"];
+  readonly modelSelection?: ModelSelection;
+  readonly runtimePolicy?: ProviderAdapterV2RuntimePolicy;
+}): string {
+  return JSON.stringify({
+    providerThread: providerThreadRuntimeKey(input.providerThread),
+    modelSelection: input.modelSelection ?? null,
+    runtimePolicy: input.runtimePolicy ?? null,
+  });
+}
+
+export const layerWithOptions = (
+  options: ProviderSessionManagerV2LayerOptions = {},
+): Layer.Layer<
+  ProviderSessionManagerV2,
+  never,
+  | EventSinkV2
+  | IdAllocatorV2
+  | McpSessionRegistry.McpSessionRegistry
+  | ProjectionStoreV2
+  | ProviderAdapterRegistryV2
+> =>
+  Layer.effect(
+    ProviderSessionManagerV2,
+    Effect.gen(function* () {
+      const registry = yield* ProviderAdapterRegistryV2;
+      const mcpSessionRegistry = yield* McpSessionRegistry.McpSessionRegistry;
+      /**
+       * Optional so the many focused tests that assemble this layer by hand do
+       * not each need a settings stub; the production composition always
+       * provides it. When present, an unreadable settings file withholds
+       * browser access rather than granting it — an explicit "off" silently
+       * becoming "on" would violate the user's stated choice, whereas the
+       * reverse costs an agent one toolset and is visible immediately (#7083).
+       */
+      const serverSettings = yield* Effect.serviceOption(ServerSettings.ServerSettingsService);
+      const agentBrowserAccessEnabled = Option.match(serverSettings, {
+        onNone: () => Effect.succeed(true),
+        onSome: (settings) =>
+          settings.getSettings.pipe(
+            Effect.map((resolved) => resolved.enableAgentBrowserAccess),
+            Effect.catch((cause) =>
+              Effect.logWarning(
+                "Could not read server settings; withholding agent browser access for this session.",
+                { cause },
+              ).pipe(Effect.as(false)),
+            ),
+          ),
+      });
+      const eventSink = yield* EventSinkV2;
+      const idAllocator = yield* IdAllocatorV2;
+      const projectionStore = yield* ProjectionStoreV2;
+      const layerScope = yield* Effect.scope;
+      const sessions = yield* Ref.make(new Map<string, LiveSessionEntry>());
+      const nextSubscriberId = yield* Ref.make(0);
+      const sessionOpen = yield* makeKeyedSerialExecutor<ProviderSessionId>();
+      const idleTimeoutMs = Math.max(1, options.idleTimeoutMs ?? DEFAULT_IDLE_TIMEOUT_MS);
+      const maxIdlePinMs = Math.max(0, options.maxIdlePinMs ?? DEFAULT_MAX_IDLE_PIN_MS);
+      interface PreparedMcpCredential {
+        readonly mcpCredentialId: string | undefined;
+        /** True when this call minted the credential (vs reusing a live one). */
+        readonly issued: boolean;
+      }
+      /**
+       * Reservations protect a credential between prepareMcpSession handing it
+       * out and the owning session entry becoming visible in `sessions`.
+       * Adapters like ACP and OpenCode consume the credential eagerly during
+       * openSession, so a racing release must not revoke it in that window
+       * (rotating afterwards cannot repair an already-configured process).
+       * The holder MUST drop the reservation once the entry is recorded or the
+       * open fails.
+       */
+      const mcpCredentialReservations = new Map<string, number>();
+      const mcpReservationKey = (threadId: ThreadId, mcpCredentialId: string) =>
+        `${threadId}${mcpCredentialId}`;
+      const reserveMcpCredential = (threadId: ThreadId, mcpCredentialId: string) => {
+        const key = mcpReservationKey(threadId, mcpCredentialId);
+        mcpCredentialReservations.set(key, (mcpCredentialReservations.get(key) ?? 0) + 1);
+      };
+      const dropMcpCredentialReservation = (threadId: ThreadId, mcpCredentialId: string) => {
+        const key = mcpReservationKey(threadId, mcpCredentialId);
+        const count = mcpCredentialReservations.get(key) ?? 0;
+        if (count <= 1) {
+          mcpCredentialReservations.delete(key);
+        } else {
+          mcpCredentialReservations.set(key, count - 1);
+        }
+      };
+      const isMcpCredentialReserved = (threadId: ThreadId, mcpCredentialId: string) =>
+        (mcpCredentialReservations.get(mcpReservationKey(threadId, mcpCredentialId)) ?? 0) > 0;
+      const mcpPrepareLock = yield* makeKeyedSerialExecutor<ThreadId>();
+      /**
+       * Resolves (or mints) the thread's MCP credential and returns it with a
+       * reservation held; the caller must drop the reservation exactly once.
+       * Serialized per thread so two concurrent prepares cannot interleave
+       * their rotate steps and revoke each other's freshly minted credential.
+       */
+      const prepareMcpSession = (
+        threadId: ThreadId,
+        providerInstanceId: ProviderInstanceId,
+      ): Effect.Effect<PreparedMcpCredential> =>
+        options.configureMcp === false
+          ? Effect.sync((): PreparedMcpCredential => {
+              McpProviderSession.clearMcpProviderSession(threadId);
+              return { mcpCredentialId: undefined, issued: false };
+            })
+          : mcpPrepareLock.withLock(
+              threadId,
+              Effect.gen(function* () {
+                // Reuse a still-valid credential for this thread instead of
+                // rotating: long-lived provider processes (codex app-server)
+                // build their MCP client once per conversation and keep using
+                // the credential it started with, so a thread that detaches and
+                // re-attaches across a workspace handoff must come back to the
+                // same token or the process's tool calls fail auth.
+                const browserToolsAvailable = yield* agentBrowserAccessEnabled;
+                const existing = McpProviderSession.readMcpProviderSession(threadId);
+                if (existing !== undefined) {
+                  // Reserve before the async resolve so a release cannot
+                  // revoke the credential between validation and reservation.
+                  reserveMcpCredential(threadId, existing.providerSessionId);
+                  const rawToken = existing.authorizationHeader.replace(/^Bearer\s+/, "");
+                  const resolved = yield* mcpSessionRegistry.resolve(rawToken);
+                  if (
+                    resolved !== undefined &&
+                    resolved.threadId === threadId &&
+                    resolved.providerInstanceId === providerInstanceId &&
+                    // A flipped browser-access setting must not survive through
+                    // credential reuse: rotate so the new scope reflects it.
+                    resolved.capabilities.has("preview") === browserToolsAvailable
+                  ) {
+                    return { mcpCredentialId: existing.providerSessionId, issued: false };
+                  }
+                  dropMcpCredentialReservation(threadId, existing.providerSessionId);
+                }
+                yield* mcpSessionRegistry.revokeThread(threadId);
+                const credential = yield* mcpSessionRegistry.issue({
+                  threadId,
+                  providerInstanceId,
+                  browserToolsAvailable,
+                });
+                McpProviderSession.setMcpProviderSession(credential.config);
+                reserveMcpCredential(threadId, credential.config.providerSessionId);
+                return { mcpCredentialId: credential.config.providerSessionId, issued: true };
+              }),
+            );
+      /**
+       * With a credential id, revocation is scoped to that credential and the
+       * config slot is cleared only while it still holds it; a replacement
+       * session's newer credential survives. Without one (attach failed before
+       * a credential was recorded), fall back to thread-wide revocation.
+       */
+      const clearMcpSession = (threadId: ThreadId, mcpCredentialId?: string) =>
+        mcpCredentialId === undefined
+          ? mcpSessionRegistry
+              .revokeThread(threadId)
+              .pipe(
+                Effect.tap(() =>
+                  Effect.sync(() => McpProviderSession.clearMcpProviderSession(threadId)),
+                ),
+              )
+          : mcpSessionRegistry.revokeProviderSession(mcpCredentialId).pipe(
+              Effect.tap(() =>
+                Effect.sync(() => {
+                  if (
+                    McpProviderSession.readMcpProviderSession(threadId)?.providerSessionId ===
+                    mcpCredentialId
+                  ) {
+                    McpProviderSession.clearMcpProviderSession(threadId);
+                  }
+                }),
+              ),
+            );
+
+      const publishToSubscribers = (
+        subscribers: Ref.Ref<
+          ReadonlyMap<number, Queue.Queue<ProviderSessionEventSignal, Cause.Done>>
+        >,
+        signal: ProviderSessionEventSignal,
+      ) =>
+        Ref.get(subscribers).pipe(
+          Effect.flatMap((current) =>
+            Effect.forEach(current.values(), (queue) => Queue.offer(queue, signal), {
+              discard: true,
+            }),
+          ),
+        );
+
+      const failSubscribers = (entry: LiveSessionEntry, detail: string) =>
+        Effect.gen(function* () {
+          const error = new ProviderAdapterEventStreamError({
+            driver: entry.runtime.driver,
+            providerSessionId: entry.runtime.providerSessionId,
+            cause: detail,
+          });
+          const subscribers = yield* Ref.getAndSet(entry.eventSubscribers, new Map());
+          yield* Effect.forEach(
+            subscribers.values(),
+            (queue) =>
+              Queue.offer(queue, {
+                type: "failure",
+                cause: Cause.fail(error),
+              }),
+            { discard: true },
+          );
+        });
+
+      const closeSubscribers = (entry: LiveSessionEntry) =>
+        Effect.gen(function* () {
+          const subscribers = yield* Ref.getAndSet(entry.eventSubscribers, new Map());
+          yield* Effect.forEach(
+            subscribers.values(),
+            (queue) => Queue.clear(queue).pipe(Effect.andThen(Queue.end(queue))),
+            { discard: true },
+          );
+        });
+
+      const cancelIdleFiber = (fiber: Fiber.Fiber<void, never> | null) =>
+        fiber === null ? Effect.void : Fiber.interrupt(fiber).pipe(Effect.ignore);
+
+      const writeProviderSessionEvents = (input: {
+        readonly runtime: ProviderAdapterV2SessionRuntime;
+        readonly threadIds: Iterable<ThreadId>;
+        readonly type: "provider-session.attached" | "provider-session.updated";
+        readonly payload: OrchestrationV2ProviderSession;
+      }) =>
+        Effect.gen(function* () {
+          const now = yield* DateTime.now;
+          const events = yield* Effect.forEach(input.threadIds, (threadId) =>
+            Effect.gen(function* () {
+              return {
+                id: yield* idAllocator.allocate.event({
+                  threadId,
+                  providerSessionId: input.runtime.providerSessionId,
+                }),
+                type: input.type,
+                threadId,
+                driver: input.runtime.driver,
+                providerInstanceId: input.runtime.instanceId,
+                occurredAt: now,
+                payload: input.payload,
+              } satisfies OrchestrationV2DomainEvent;
+            }),
+          );
+          if (events.length > 0) {
+            yield* eventSink.write({ events });
+          }
+        });
+
+      const writeReleasedSessionEvents = (input: {
+        readonly entry: LiveSessionEntry;
+        readonly reason: ProviderSessionReleaseReason;
+        readonly detail?: string;
+      }) =>
+        Effect.gen(function* () {
+          const now = yield* DateTime.now;
+          const payload: OrchestrationV2ProviderSession = {
+            ...input.entry.runtime.providerSession,
+            status: releaseStatusFor(input.reason),
+            updatedAt: now,
+            lastError:
+              input.reason === "runtime_error"
+                ? (input.detail ?? "Provider runtime failed.")
+                : null,
+          };
+          yield* writeProviderSessionEvents({
+            runtime: input.entry.runtime,
+            threadIds: input.entry.attachedThreadIds,
+            type: "provider-session.updated",
+            payload,
+          });
+        });
+
+      const writeReleasedRuntimeRequestEvents = (input: {
+        readonly entry: LiveSessionEntry;
+        readonly reason: ProviderSessionReleaseReason;
+      }) =>
+        Effect.gen(function* () {
+          const providerSessionId = input.entry.runtime.providerSessionId;
+          const now = yield* DateTime.now;
+          const status = releasedRuntimeRequestStatusFor(input.reason);
+          const reason =
+            input.reason === "runtime_error"
+              ? "Provider session failed before this runtime request was resolved."
+              : "Provider session was closed before this runtime request was resolved.";
+
+          const events: Array<OrchestrationV2DomainEvent> = [];
+          for (const threadId of input.entry.attachedThreadIds) {
+            const projection = yield* projectionStore.getThreadProjection(threadId);
+            const releasedRequests = projection.runtimeRequests.filter(
+              (request) =>
+                request.status === "pending" &&
+                request.responseCapability.type === "live" &&
+                request.responseCapability.providerSessionId === providerSessionId,
+            );
+
+            for (const request of releasedRequests) {
+              events.push({
+                id: yield* idAllocator.allocate.event({
+                  threadId,
+                  providerSessionId,
+                }),
+                type: "runtime-request.updated",
+                threadId,
+                nodeId: request.nodeId,
+                driver: input.entry.runtime.driver,
+                occurredAt: now,
+                payload: {
+                  ...request,
+                  status,
+                  responseCapability: {
+                    type: "not_resumable",
+                    reason,
+                  },
+                  resolvedAt: now,
+                },
+              });
+
+              const requestNode = projection.nodes.find((node) => node.id === request.nodeId);
+              if (requestNode !== undefined) {
+                events.push({
+                  id: yield* idAllocator.allocate.event({
+                    threadId,
+                    providerSessionId,
+                  }),
+                  type: "node.updated",
+                  threadId,
+                  ...(requestNode.runId === null ? {} : { runId: requestNode.runId }),
+                  nodeId: requestNode.id,
+                  driver: input.entry.runtime.driver,
+                  occurredAt: now,
+                  payload: {
+                    ...requestNode,
+                    status: input.reason === "runtime_error" ? "failed" : "cancelled",
+                    completedAt: now,
+                  },
+                });
+              }
+
+              const turnItem = projection.turnItems.find(
+                (item) => item.type === "approval_request" && item.requestId === request.id,
+              );
+              if (turnItem !== undefined) {
+                events.push({
+                  id: yield* idAllocator.allocate.event({
+                    threadId,
+                    providerSessionId,
+                  }),
+                  type: "turn-item.updated",
+                  threadId,
+                  ...(turnItem.runId === null ? {} : { runId: turnItem.runId }),
+                  ...(turnItem.nodeId === null ? {} : { nodeId: turnItem.nodeId }),
+                  driver: input.entry.runtime.driver,
+                  occurredAt: now,
+                  payload: {
+                    ...turnItem,
+                    status: input.reason === "runtime_error" ? "failed" : "cancelled",
+                    completedAt: now,
+                    updatedAt: now,
+                  },
+                });
+              }
+            }
+          }
+
+          if (events.length > 0) {
+            yield* eventSink.write({ events });
+          }
+        });
+
+      const releaseEntry = (input: {
+        readonly providerSessionId: ProviderSessionId;
+        readonly reason: ProviderSessionReleaseReason;
+        readonly detail?: string;
+        readonly cancelIdleFiber?: boolean;
+        readonly onlyIfIdleGeneration?: number;
+      }) =>
+        Effect.acquireUseRelease(
+          Ref.modify(sessions, (current) => {
+            const key = sessionKey(input.providerSessionId);
+            const existing = current.get(key);
+            if (existing === undefined) {
+              return [Option.none<LiveSessionEntry>(), current] as const;
+            }
+            if (
+              input.onlyIfIdleGeneration !== undefined &&
+              (existing.busyCount > 0 || existing.idleGeneration !== input.onlyIfIdleGeneration)
+            ) {
+              return [Option.none<LiveSessionEntry>(), current] as const;
+            }
+            const updated = new Map(current);
+            updated.delete(key);
+            return [Option.some(existing), updated] as const;
+          }),
+          (entry) =>
+            Option.match(entry, {
+              onNone: () => Effect.void,
+              onSome: (entry) =>
+                Effect.gen(function* () {
+                  if (input.cancelIdleFiber !== false) {
+                    yield* cancelIdleFiber(entry.idleFiber);
+                  }
+                  if (input.reason === "server_shutdown") {
+                    yield* closeSubscribers(entry);
+                  } else {
+                    yield* failSubscribers(
+                      entry,
+                      input.detail ?? `Provider session released: ${input.reason}.`,
+                    );
+                  }
+                  // Scope close can wedge on a misbehaving adapter finalizer
+                  // (e.g. a provider process that never yields its message
+                  // stream). Time-box it so release still persists released
+                  // events and leaves a diagnosable trail instead of silently
+                  // parking the session as "ready" forever.
+                  const closeFiber = yield* Scope.close(entry.scope, Exit.void).pipe(
+                    Effect.exit,
+                    Effect.forkDetach({ startImmediately: true }),
+                  );
+                  const closeExit = yield* Fiber.join(closeFiber).pipe(
+                    Effect.timeoutOption(RELEASE_SCOPE_CLOSE_TIMEOUT_MS),
+                  );
+                  if (Option.isNone(closeExit)) {
+                    yield* Effect.logWarning(
+                      "orchestration-v2.provider-session-scope-close-timeout",
+                      {
+                        providerSessionId: input.providerSessionId,
+                        reason: input.reason,
+                        timeoutMs: RELEASE_SCOPE_CLOSE_TIMEOUT_MS,
+                      },
+                    );
+                    yield* Fiber.join(closeFiber).pipe(
+                      Effect.flatMap((exit) =>
+                        Exit.isFailure(exit)
+                          ? Effect.logWarning(
+                              "orchestration-v2.provider-session-scope-close-failed",
+                              {
+                                providerSessionId: input.providerSessionId,
+                                reason: input.reason,
+                                cause: exit.cause,
+                              },
+                            )
+                          : Effect.logInfo(
+                              "orchestration-v2.provider-session-scope-close-completed-late",
+                              {
+                                providerSessionId: input.providerSessionId,
+                                reason: input.reason,
+                              },
+                            ),
+                      ),
+                      Effect.forkDetach,
+                    );
+                  }
+                  yield* writeReleasedSessionEvents({
+                    entry,
+                    reason: input.reason,
+                    ...(input.detail === undefined ? {} : { detail: input.detail }),
+                  });
+                  yield* writeReleasedRuntimeRequestEvents({
+                    entry,
+                    reason: input.reason,
+                  });
+                  if (Option.isSome(closeExit) && Exit.isFailure(closeExit.value)) {
+                    return yield* Effect.failCause(closeExit.value.cause);
+                  }
+                }),
+            }),
+          (entry) =>
+            Option.match(entry, {
+              onNone: () => Effect.void,
+              onSome: (entry) =>
+                // Revoke every credential this session recorded, including for
+                // threads that detached without re-attaching: the provider
+                // process is gone, so nothing holds them anymore. Skip threads
+                // a live replacement session took over, since credential reuse
+                // means the replacement may hold this very credential.
+                Ref.get(sessions).pipe(
+                  Effect.flatMap((current) =>
+                    Effect.forEach(
+                      entry.mcpCredentialIdByThread,
+                      ([threadId, mcpCredentialId]) => {
+                        // Id-sensitive: a stale record for the same thread but
+                        // a DIFFERENT credential (left behind by an old session
+                        // the thread rotated away from) must not veto revoking
+                        // this session's own credential, or it leaks forever.
+                        // A reservation means an in-flight open is configuring
+                        // a provider process with this credential right now;
+                        // revoking it here would strand that process (eager
+                        // adapters cannot pick up a rotated token).
+                        const heldElsewhere =
+                          isMcpCredentialReserved(threadId, mcpCredentialId) ||
+                          Array.from(current.values()).some(
+                            (other) =>
+                              other !== entry &&
+                              (other.attachedThreadIds.has(threadId) ||
+                                other.mcpCredentialIdByThread.get(threadId) === mcpCredentialId),
+                          );
+                        return heldElsewhere
+                          ? Effect.void
+                          : clearMcpSession(threadId, mcpCredentialId);
+                      },
+                      { discard: true },
+                    ),
+                  ),
+                ),
+            }),
+        ).pipe(
+          Effect.catchCause((cause) =>
+            Effect.fail(
+              new ProviderSessionReleaseError({
+                providerSessionId: input.providerSessionId,
+                reason: input.reason,
+                cause,
+              }),
+            ),
+          ),
+        );
+
+      // Annotated to break the releaseIfStillIdle <-> scheduleIdleReleaseInternal
+      // inference cycle introduced by the pin re-arm below.
+      const releaseIfStillIdle = (input: {
+        readonly providerSessionId: ProviderSessionId;
+        readonly generation: number;
+      }): Effect.Effect<void> =>
+        Effect.gen(function* () {
+          const current = yield* Ref.get(sessions);
+          const key = sessionKey(input.providerSessionId);
+          const entry = current.get(key);
+          if (
+            entry === undefined ||
+            entry.busyCount > 0 ||
+            entry.idleGeneration !== input.generation
+          ) {
+            return;
+          }
+          // Capture runtime identity before yielding: a replacement session
+          // can reuse the same providerSessionId while this fiber is parked.
+          const probedRuntime = entry.runtime;
+          const hasPendingWork =
+            probedRuntime.hasPendingBackgroundWork === undefined
+              ? false
+              : yield* probedRuntime.hasPendingBackgroundWork.pipe(
+                  Effect.catchCause(() => Effect.succeed(false)),
+                );
+          if (hasPendingWork) {
+            const now = yield* Clock.currentTimeMillis;
+            const pinnedSinceMs = entry.pinnedSinceMs ?? now;
+            if (now - pinnedSinceMs < maxIdlePinMs) {
+              const shouldContinuePin = yield* Ref.modify(sessions, (latest) => {
+                const latestEntry = latest.get(key);
+                if (
+                  latestEntry === undefined ||
+                  latestEntry.busyCount > 0 ||
+                  latestEntry.idleGeneration !== input.generation ||
+                  latestEntry.runtime !== probedRuntime
+                ) {
+                  return [false, latest] as const;
+                }
+                const updated = new Map(latest);
+                updated.set(key, { ...latestEntry, pinnedSinceMs });
+                return [true, updated] as const;
+              });
+              if (!shouldContinuePin) {
+                // Generation or runtime advanced while we probed pending work;
+                // the current owner of the entry owns idle release.
+                return;
+              }
+              yield* Effect.logInfo("orchestration-v2.driver-session.idle-release-deferred", {
+                providerSessionId: input.providerSessionId,
+                pinnedForMs: now - pinnedSinceMs,
+              });
+              // Re-check on this fiber after another idle window. Do not call
+              // scheduleIdleReleaseInternal: that cancels entry.idleFiber, which
+              // is this fiber, and can self-deadlock on Fiber.interrupt.
+              yield* Effect.sleep(Duration.millis(idleTimeoutMs));
+              return yield* releaseIfStillIdle(input);
+            }
+            yield* Effect.logWarning("orchestration-v2.driver-session.idle-release-pin-expired", {
+              providerSessionId: input.providerSessionId,
+              pinnedForMs: now - pinnedSinceMs,
+            });
+          }
+          // hasPendingBackgroundWork yields to the adapter, so the idle
+          // decision above can go stale; the generation guard revalidates
+          // busyCount and idleGeneration inside releaseEntry's atomic
+          // entry removal.
+          yield* releaseEntry({
+            providerSessionId: input.providerSessionId,
+            reason: "idle_timeout",
+            cancelIdleFiber: false,
+            onlyIfIdleGeneration: input.generation,
+          }).pipe(
+            Effect.catchCause((cause) =>
+              Effect.logWarning("orchestration-v2.driver-session.idle-release-failed", {
+                providerSessionId: input.providerSessionId,
+                cause,
+              }),
+            ),
+          );
+        });
+
+      const withActivityError = <A, E, R>(
+        providerSessionId: ProviderSessionId,
+        effect: Effect.Effect<A, E, R>,
+      ): Effect.Effect<A, ProviderSessionActivityError, R> =>
+        effect.pipe(
+          Effect.catchCause((cause) =>
+            Effect.fail(
+              new ProviderSessionActivityError({
+                providerSessionId,
+                cause,
+              }),
+            ),
+          ),
+        );
+
+      const scheduleIdleReleaseInternal = (providerSessionId: ProviderSessionId) =>
+        Effect.gen(function* () {
+          const key = sessionKey(providerSessionId);
+          const current = yield* Ref.get(sessions);
+          const entry = current.get(key);
+          if (entry === undefined || entry.busyCount > 0) {
+            return;
+          }
+
+          yield* cancelIdleFiber(entry.idleFiber);
+          const generation = entry.idleGeneration + 1;
+          const idleFiber = yield* Effect.sleep(Duration.millis(idleTimeoutMs)).pipe(
+            Effect.andThen(releaseIfStillIdle({ providerSessionId, generation })),
+            Effect.forkIn(layerScope),
+          );
+          const lastActivityAtMs = yield* Clock.currentTimeMillis;
+          yield* Ref.update(sessions, (latest) => {
+            const latestEntry = latest.get(key);
+            if (latestEntry === undefined || latestEntry.busyCount > 0) {
+              return latest;
+            }
+            const updated = new Map(latest);
+            updated.set(key, {
+              ...latestEntry,
+              idleGeneration: generation,
+              idleFiber,
+              lastActivityAtMs,
+            });
+            return updated;
+          });
+        });
+
+      const scheduleIdleRelease = (providerSessionId: ProviderSessionId) =>
+        withActivityError(providerSessionId, scheduleIdleReleaseInternal(providerSessionId));
+
+      const touchActivity = (providerSessionId: ProviderSessionId) =>
+        withActivityError(
+          providerSessionId,
+          Effect.gen(function* () {
+            const lastActivityAtMs = yield* Clock.currentTimeMillis;
+            yield* Ref.update(sessions, (current) => {
+              const entry = current.get(sessionKey(providerSessionId));
+              if (entry === undefined) {
+                return current;
+              }
+              const updated = new Map(current);
+              updated.set(sessionKey(providerSessionId), {
+                ...entry,
+                lastActivityAtMs,
+              });
+              return updated;
+            });
+            yield* scheduleIdleReleaseInternal(providerSessionId);
+          }),
+        );
+
+      const attachThread = (input: {
+        readonly providerSessionId: ProviderSessionId;
+        readonly threadId: ThreadId;
+      }) =>
+        withActivityError(
+          input.providerSessionId,
+          Ref.modify(sessions, (current) => {
+            const entry = current.get(sessionKey(input.providerSessionId));
+            if (entry === undefined || entry.attachedThreadIds.has(input.threadId)) {
+              return [false, current] as const;
+            }
+            const updated = new Map(current);
+            updated.set(sessionKey(input.providerSessionId), {
+              ...entry,
+              attachedThreadIds: new Set([...entry.attachedThreadIds, input.threadId]),
+            });
+            return [true, updated] as const;
+          }),
+        );
+
+      const removeThreadAttachment = (input: {
+        readonly providerSessionId: ProviderSessionId;
+        readonly threadId: ThreadId;
+      }) =>
+        Ref.update(sessions, (current) => {
+          const key = sessionKey(input.providerSessionId);
+          const entry = current.get(key);
+          if (entry === undefined || !entry.attachedThreadIds.has(input.threadId)) {
+            return current;
+          }
+          const attachedThreadIds = new Set(entry.attachedThreadIds);
+          attachedThreadIds.delete(input.threadId);
+          const loadedProviderThreadKeyByThread = new Map(entry.loadedProviderThreadKeyByThread);
+          loadedProviderThreadKeyByThread.delete(input.threadId);
+          const updated = new Map(current);
+          updated.set(key, {
+            ...entry,
+            attachedThreadIds,
+            loadedProviderThreadKeyByThread,
+          });
+          return updated;
+        });
+
+      const isProviderThreadLoaded = (input: {
+        readonly providerSessionId: ProviderSessionId;
+        readonly threadId: ThreadId;
+        readonly providerThreadKey: string;
+      }) =>
+        Ref.get(sessions).pipe(
+          Effect.map(
+            (current) =>
+              current
+                .get(sessionKey(input.providerSessionId))
+                ?.loadedProviderThreadKeyByThread.get(input.threadId) === input.providerThreadKey,
+          ),
+        );
+
+      const markProviderThreadLoaded = (input: {
+        readonly providerSessionId: ProviderSessionId;
+        readonly threadId: ThreadId;
+        readonly providerThreadKey: string;
+      }) =>
+        Ref.update(sessions, (current) => {
+          const key = sessionKey(input.providerSessionId);
+          const entry = current.get(key);
+          if (entry === undefined) {
+            return current;
+          }
+          const loadedProviderThreadKeyByThread = new Map(entry.loadedProviderThreadKeyByThread);
+          loadedProviderThreadKeyByThread.set(input.threadId, input.providerThreadKey);
+          const updated = new Map(current);
+          updated.set(key, { ...entry, loadedProviderThreadKeyByThread });
+          return updated;
+        });
+
+      const ensureThreadAttached = (input: {
+        readonly providerSessionId: ProviderSessionId;
+        readonly threadId: ThreadId;
+        readonly providerInstanceId: ProviderInstanceId;
+      }) =>
+        Effect.suspend(() => {
+          let preparedForCleanup: PreparedMcpCredential | undefined;
+          let reservationDropped = false;
+          const dropReservation = () => {
+            if (!reservationDropped && preparedForCleanup?.mcpCredentialId !== undefined) {
+              reservationDropped = true;
+              dropMcpCredentialReservation(input.threadId, preparedForCleanup.mcpCredentialId);
+            }
+          };
+          return Effect.gen(function* () {
+            const attached = yield* attachThread(input);
+            if (attached) {
+              const prepared = yield* prepareMcpSession(input.threadId, input.providerInstanceId);
+              preparedForCleanup = prepared;
+              if (prepared.mcpCredentialId !== undefined) {
+                const mcpCredentialId = prepared.mcpCredentialId;
+                yield* Ref.update(sessions, (current) => {
+                  const key = sessionKey(input.providerSessionId);
+                  const entry = current.get(key);
+                  if (entry === undefined) return current;
+                  const mcpCredentialIdByThread = new Map(entry.mcpCredentialIdByThread);
+                  mcpCredentialIdByThread.set(input.threadId, mcpCredentialId);
+                  const updated = new Map(current);
+                  updated.set(key, { ...entry, mcpCredentialIdByThread });
+                  return updated;
+                });
+              }
+              const entry = (yield* Ref.get(sessions)).get(sessionKey(input.providerSessionId));
+              if (entry !== undefined) {
+                yield* withActivityError(
+                  input.providerSessionId,
+                  writeProviderSessionEvents({
+                    runtime: entry.runtime,
+                    threadIds: [input.threadId],
+                    type: "provider-session.attached",
+                    payload: entry.runtime.providerSession,
+                  }),
+                );
+              }
+            }
+          }).pipe(
+            Effect.tapError(() =>
+              removeThreadAttachment(input).pipe(
+                // Revoke only a credential this attach freshly minted: a REUSED
+                // credential is by definition held by another live provider
+                // process, and revoking it thread-wide would break that
+                // process's MCP client mid-conversation.
+                Effect.andThen(
+                  Effect.suspend(() => {
+                    dropReservation();
+                    return preparedForCleanup?.issued === true
+                      ? clearMcpSession(input.threadId, preparedForCleanup.mcpCredentialId)
+                      : Effect.void;
+                  }),
+                ),
+              ),
+            ),
+            // The entry's own record (written above while the thread is
+            // attached) guards the credential from here on; the reservation
+            // is only needed until then. Ensuring covers defects/interrupts.
+            Effect.ensuring(Effect.sync(dropReservation)),
+          );
+        });
+
+      const markBusy = (providerSessionId: ProviderSessionId) =>
+        withActivityError(
+          providerSessionId,
+          Effect.gen(function* () {
+            const key = sessionKey(providerSessionId);
+            const now = yield* Clock.currentTimeMillis;
+            const idleFiber = yield* Ref.modify(sessions, (current) => {
+              const entry = current.get(key);
+              if (entry === undefined) {
+                return [null, current] as const;
+              }
+              const updated = new Map(current);
+              updated.set(key, {
+                ...entry,
+                busyCount: entry.busyCount + 1,
+                idleFiber: null,
+                lastActivityAtMs: now,
+                pinnedSinceMs: null,
+              });
+              return [entry.idleFiber, updated] as const;
+            });
+            yield* cancelIdleFiber(idleFiber);
+          }),
+        );
+
+      const markIdle = (providerSessionId: ProviderSessionId) =>
+        withActivityError(
+          providerSessionId,
+          Effect.gen(function* () {
+            const key = sessionKey(providerSessionId);
+            const now = yield* Clock.currentTimeMillis;
+            yield* Ref.update(sessions, (current) => {
+              const entry = current.get(key);
+              if (entry === undefined) {
+                return current;
+              }
+              const updated = new Map(current);
+              updated.set(key, {
+                ...entry,
+                busyCount: Math.max(0, entry.busyCount - 1),
+                lastActivityAtMs: now,
+              });
+              return updated;
+            });
+            yield* scheduleIdleReleaseInternal(providerSessionId);
+          }),
+        );
+
+      const observeActivity = (
+        providerSessionId: ProviderSessionId,
+        activity: Effect.Effect<void, ProviderSessionActivityError>,
+      ) =>
+        activity.pipe(
+          Effect.catchCause((cause) =>
+            Effect.logWarning("orchestration-v2.driver-session.activity-failed", {
+              providerSessionId,
+              cause,
+            }),
+          ),
+        );
+
+      const makeEventSubscription = (
+        subscribers: Ref.Ref<
+          ReadonlyMap<number, Queue.Queue<ProviderSessionEventSignal, Cause.Done>>
+        >,
+      ): Effect.Effect<ProviderAdapterV2EventSubscription> =>
+        Effect.gen(function* () {
+          const queue = yield* Queue.unbounded<ProviderSessionEventSignal, Cause.Done>();
+          const subscriberId = yield* Ref.getAndUpdate(nextSubscriberId, (value) => value + 1);
+          yield* Ref.update(subscribers, (current) => {
+            const updated = new Map(current);
+            updated.set(subscriberId, queue);
+            return updated;
+          });
+          const close = Ref.modify(subscribers, (current) => {
+            if (!current.has(subscriberId)) {
+              return [false, current] as const;
+            }
+            const updated = new Map(current);
+            updated.delete(subscriberId);
+            return [true, updated] as const;
+          }).pipe(
+            Effect.flatMap((removed) =>
+              removed
+                ? Queue.clear(queue).pipe(Effect.andThen(Queue.end(queue)), Effect.asVoid)
+                : Effect.void,
+            ),
+          );
+          const events = Stream.fromQueue(queue).pipe(
+            Stream.mapEffect((signal) =>
+              signal.type === "event"
+                ? Effect.succeed(signal.event)
+                : Effect.failCause(signal.cause),
+            ),
+            Stream.ensuring(close),
+          );
+          return { events, close } satisfies ProviderAdapterV2EventSubscription;
+        });
+
+      const decorateRuntime = (
+        runtime: ProviderAdapterV2SessionRuntime,
+        eventSubscribers: Ref.Ref<
+          ReadonlyMap<number, Queue.Queue<ProviderSessionEventSignal, Cause.Done>>
+        >,
+      ): ProviderAdapterV2SessionRuntime => {
+        const providerSessionId = runtime.providerSessionId;
+        const subscribeEvents = makeEventSubscription(eventSubscribers);
+        return {
+          ...runtime,
+          subscribeEvents,
+          events: Stream.unwrap(
+            subscribeEvents.pipe(Effect.map((subscription) => subscription.events)),
+          ),
+          ensureThread: (input) =>
+            observeActivity(
+              providerSessionId,
+              ensureThreadAttached({
+                providerSessionId,
+                threadId: input.threadId,
+                providerInstanceId: runtime.instanceId,
+              }),
+            ).pipe(
+              Effect.andThen(runtime.ensureThread(input)),
+              Effect.tap((providerThread) =>
+                markProviderThreadLoaded({
+                  providerSessionId,
+                  threadId: input.threadId,
+                  providerThreadKey: providerThreadLoadKey({
+                    providerThread,
+                    modelSelection: input.modelSelection,
+                    runtimePolicy: input.runtimePolicy,
+                  }),
+                }),
+              ),
+            ),
+          resumeThread: (input) => {
+            const threadId = input.threadId ?? input.providerThread.appThreadId;
+            if (threadId === null || threadId === undefined) {
+              return runtime.resumeThread(input);
+            }
+            const providerThreadKey = providerThreadLoadKey({
+              providerThread: input.providerThread,
+              ...(input.modelSelection === undefined
+                ? {}
+                : { modelSelection: input.modelSelection }),
+              ...(input.runtimePolicy === undefined ? {} : { runtimePolicy: input.runtimePolicy }),
+            });
+            return observeActivity(
+              providerSessionId,
+              ensureThreadAttached({
+                providerSessionId,
+                threadId,
+                providerInstanceId: runtime.instanceId,
+              }),
+            ).pipe(
+              Effect.andThen(
+                isProviderThreadLoaded({ providerSessionId, threadId, providerThreadKey }),
+              ),
+              Effect.flatMap((loaded) =>
+                loaded ? Effect.succeed(input.providerThread) : runtime.resumeThread(input),
+              ),
+              Effect.tap((providerThread) =>
+                markProviderThreadLoaded({
+                  providerSessionId,
+                  threadId,
+                  providerThreadKey: providerThreadLoadKey({
+                    providerThread,
+                    ...(input.modelSelection === undefined
+                      ? {}
+                      : { modelSelection: input.modelSelection }),
+                    ...(input.runtimePolicy === undefined
+                      ? {}
+                      : { runtimePolicy: input.runtimePolicy }),
+                  }),
+                }),
+              ),
+            );
+          },
+          forkThread: (input) =>
+            observeActivity(
+              providerSessionId,
+              ensureThreadAttached({
+                providerSessionId,
+                threadId: input.targetThreadId,
+                providerInstanceId: runtime.instanceId,
+              }),
+            ).pipe(
+              Effect.andThen(runtime.forkThread(input)),
+              Effect.tap((providerThread) =>
+                markProviderThreadLoaded({
+                  providerSessionId,
+                  threadId: input.targetThreadId,
+                  providerThreadKey: providerThreadLoadKey({
+                    providerThread,
+                    ...(input.modelSelection === undefined
+                      ? {}
+                      : { modelSelection: input.modelSelection }),
+                    ...(input.runtimePolicy === undefined
+                      ? {}
+                      : { runtimePolicy: input.runtimePolicy }),
+                  }),
+                }),
+              ),
+            ),
+          startTurn: (input) =>
+            observeActivity(
+              providerSessionId,
+              ensureThreadAttached({
+                providerSessionId,
+                threadId: input.threadId,
+                providerInstanceId: runtime.instanceId,
+              }),
+            ).pipe(
+              Effect.andThen(observeActivity(providerSessionId, markBusy(providerSessionId))),
+              Effect.andThen(runtime.startTurn(input)),
+              Effect.catch((error) =>
+                observeActivity(providerSessionId, markIdle(providerSessionId)).pipe(
+                  Effect.andThen(Effect.fail(error)),
+                ),
+              ),
+            ),
+          steerTurn: (input) =>
+            observeActivity(providerSessionId, touchActivity(providerSessionId)).pipe(
+              Effect.andThen(runtime.steerTurn(input)),
+            ),
+          interruptTurn: (input) =>
+            observeActivity(providerSessionId, touchActivity(providerSessionId)).pipe(
+              Effect.andThen(runtime.interruptTurn(input)),
+            ),
+          respondToRuntimeRequest: (input) =>
+            observeActivity(providerSessionId, touchActivity(providerSessionId)).pipe(
+              Effect.andThen(runtime.respondToRuntimeRequest(input)),
+            ),
+        };
+      };
+
+      const persistProviderSessionUpdate = (
+        entry: LiveSessionEntry,
+        event: Extract<ProviderAdapterV2Event, { readonly type: "provider_session.updated" }>,
+      ) =>
+        Effect.gen(function* () {
+          const current = (yield* Ref.get(sessions)).get(
+            sessionKey(entry.runtime.providerSessionId),
+          );
+          if (current?.runtime !== entry.runtime) {
+            return;
+          }
+          yield* writeProviderSessionEvents({
+            runtime: entry.runtime,
+            threadIds: current.attachedThreadIds,
+            type: "provider-session.updated",
+            payload: event.providerSession,
+          });
+        }).pipe(
+          Effect.catchCause((cause) =>
+            Effect.logWarning("orchestration-v2.driver-session.status-persist-failed", {
+              providerSessionId: entry.runtime.providerSessionId,
+              cause,
+            }),
+          ),
+        );
+
+      const startEventPump = (entry: LiveSessionEntry) =>
+        entry.runtime.events.pipe(
+          Stream.runForEach((event) =>
+            observeActivity(
+              entry.runtime.providerSessionId,
+              event.type === "turn.terminal"
+                ? markIdle(entry.runtime.providerSessionId)
+                : touchActivity(entry.runtime.providerSessionId),
+            ).pipe(
+              Effect.andThen(
+                event.type === "provider_session.updated"
+                  ? persistProviderSessionUpdate(entry, event)
+                  : Effect.void,
+              ),
+              Effect.andThen(
+                publishToSubscribers(entry.eventSubscribers, { type: "event", event }),
+              ),
+            ),
+          ),
+          Effect.exit,
+          Effect.flatMap((exit) =>
+            Effect.gen(function* () {
+              const current = (yield* Ref.get(sessions)).get(
+                sessionKey(entry.runtime.providerSessionId),
+              );
+              if (current?.runtime !== entry.runtime) {
+                return;
+              }
+              const cause = Exit.isFailure(exit)
+                ? exit.cause
+                : Cause.fail(
+                    new ProviderAdapterEventStreamError({
+                      driver: entry.runtime.driver,
+                      providerSessionId: entry.runtime.providerSessionId,
+                      cause: "Provider event stream ended unexpectedly.",
+                    }),
+                  );
+              yield* publishToSubscribers(entry.eventSubscribers, {
+                type: "failure",
+                cause,
+              });
+              yield* Ref.set(entry.eventSubscribers, new Map());
+              yield* releaseEntry({
+                providerSessionId: entry.runtime.providerSessionId,
+                reason: "runtime_error",
+                detail: Cause.pretty(cause),
+              }).pipe(Effect.ignore);
+            }),
+          ),
+          Effect.forkIn(layerScope),
+        );
+
+      const shutdown = Effect.gen(function* () {
+        const activeSessions = [...(yield* Ref.get(sessions)).values()];
+        yield* Effect.forEach(
+          activeSessions,
+          (entry) =>
+            releaseEntry({
+              providerSessionId: entry.runtime.providerSessionId,
+              reason: "server_shutdown",
+            }).pipe(
+              Effect.catchCause((cause) =>
+                Effect.logWarning("orchestration-v2.driver-session.shutdown-release-failed", {
+                  providerSessionId: entry.runtime.providerSessionId,
+                  cause,
+                }),
+              ),
+            ),
+          { discard: true },
+        );
+      });
+      yield* Effect.addFinalizer(() => shutdown);
+
+      return ProviderSessionManagerV2.of({
+        shutdown,
+        open: (input) =>
+          sessionOpen.withLock(
+            input.providerSessionId,
+            Effect.gen(function* () {
+              const key = sessionKey(input.providerSessionId);
+              const existing = (yield* Ref.get(sessions)).get(key);
+              if (existing !== undefined) {
+                if (
+                  !existing.attachedThreadIds.has(input.threadId) &&
+                  !existing.supportsMultipleProviderThreads
+                ) {
+                  return yield* new ProviderSessionOpenError({
+                    instanceId: input.modelSelection.instanceId,
+                    providerSessionId: input.providerSessionId,
+                    cause: `Provider ${existing.runtime.driver} does not support attaching multiple app threads to one session.`,
+                  });
+                }
+                yield* ensureThreadAttached({
+                  providerSessionId: input.providerSessionId,
+                  threadId: input.threadId,
+                  providerInstanceId: existing.runtime.instanceId,
+                });
+                yield* touchActivity(input.providerSessionId);
+                return existing.exposedRuntime;
+              }
+
+              const adapter = yield* registry.get(input.modelSelection.instanceId).pipe(
+                Effect.mapError(
+                  (cause) =>
+                    new ProviderSessionOpenError({
+                      instanceId: input.modelSelection.instanceId,
+                      providerSessionId: input.providerSessionId,
+                      cause,
+                    }),
+                ),
+              );
+              const prepared = yield* prepareMcpSession(
+                input.threadId,
+                input.modelSelection.instanceId,
+              );
+              const mcpCredentialId = prepared.mcpCredentialId;
+              // The reservation from prepare protects the credential (which
+              // eager adapters bake into the provider process during
+              // openSession) from racing releases until this session's entry
+              // is recorded below. Dropped exactly once on every path.
+              let reservationDropped = mcpCredentialId === undefined;
+              const dropReservation = Effect.sync(() => {
+                if (!reservationDropped && mcpCredentialId !== undefined) {
+                  reservationDropped = true;
+                  dropMcpCredentialReservation(input.threadId, mcpCredentialId);
+                }
+              });
+              const sessionScope = yield* Scope.make();
+              const runtime = yield* adapter
+                .openSession({
+                  threadId: input.threadId,
+                  providerSessionId: input.providerSessionId,
+                  modelSelection: input.modelSelection,
+                  runtimePolicy: input.runtimePolicy,
+                  ...(input.resumeFromSession === undefined
+                    ? {}
+                    : { resumeFromSession: input.resumeFromSession }),
+                })
+                .pipe(
+                  Effect.provideService(Scope.Scope, sessionScope),
+                  Effect.tapError(() =>
+                    Scope.close(sessionScope, Exit.void).pipe(
+                      Effect.ignore,
+                      Effect.andThen(dropReservation),
+                      // Revoke only a credential this open freshly minted: a
+                      // reused credential is held by another live provider
+                      // process and must survive this open's failure.
+                      Effect.andThen(
+                        prepared.issued
+                          ? clearMcpSession(input.threadId, mcpCredentialId)
+                          : Effect.void,
+                      ),
+                    ),
+                  ),
+                  Effect.onInterrupt(() => dropReservation),
+                  Effect.mapError(
+                    (cause) =>
+                      new ProviderSessionOpenError({
+                        instanceId: input.modelSelection.instanceId,
+                        providerSessionId: input.providerSessionId,
+                        cause,
+                      }),
+                  ),
+                );
+              const eventSubscribers = yield* Ref.make<
+                ReadonlyMap<number, Queue.Queue<ProviderSessionEventSignal, Cause.Done>>
+              >(new Map());
+              const exposedRuntime = decorateRuntime(runtime, eventSubscribers);
+              const now = yield* Clock.currentTimeMillis;
+              const entry: LiveSessionEntry = {
+                attachedThreadIds: new Set([input.threadId]),
+                loadedProviderThreadKeyByThread: new Map(),
+                mcpCredentialIdByThread:
+                  mcpCredentialId === undefined
+                    ? new Map()
+                    : new Map([[input.threadId, mcpCredentialId]]),
+                supportsMultipleProviderThreads:
+                  runtime.providerSession.capabilities.sessions
+                    .supportsMultipleProviderThreadsPerSession,
+                runtime,
+                exposedRuntime,
+                eventSubscribers,
+                scope: sessionScope,
+                idleGeneration: 0,
+                busyCount: 0,
+                lastActivityAtMs: now,
+                idleFiber: null,
+                pinnedSinceMs: null,
+              };
+              yield* Ref.update(sessions, (current) => {
+                const updated = new Map(current);
+                updated.set(key, entry);
+                return updated;
+              });
+              // The entry now guards the credential via its recorded id, so
+              // the pre-open reservation can be dropped.
+              yield* dropReservation;
+              yield* withActivityError(
+                input.providerSessionId,
+                writeProviderSessionEvents({
+                  runtime,
+                  threadIds: [input.threadId],
+                  type: "provider-session.attached",
+                  payload: runtime.providerSession,
+                }),
+              ).pipe(
+                Effect.tapError(() =>
+                  releaseEntry({
+                    providerSessionId: input.providerSessionId,
+                    reason: "runtime_error",
+                    detail: "Failed to persist the provider-session attachment.",
+                  }).pipe(Effect.ignore),
+                ),
+              );
+              yield* startEventPump(entry);
+              yield* scheduleIdleRelease(input.providerSessionId);
+              return exposedRuntime;
+            }),
+          ),
+        get: (providerSessionId) =>
+          Effect.gen(function* () {
+            const entry = (yield* Ref.get(sessions)).get(sessionKey(providerSessionId));
+            if (entry === undefined) {
+              return Option.none<ProviderAdapterV2SessionRuntime>();
+            }
+            yield* touchActivity(providerSessionId);
+            return Option.some(entry.exposedRuntime);
+          }).pipe(
+            Effect.mapError(
+              (cause) =>
+                new ProviderSessionLookupError({
+                  providerSessionId,
+                  cause,
+                }),
+            ),
+          ),
+        close: (providerSessionId) =>
+          releaseEntry({ providerSessionId, reason: "manual_shutdown" }).pipe(
+            Effect.mapError(
+              (cause) =>
+                new ProviderSessionCloseError({
+                  providerSessionId,
+                  cause,
+                }),
+            ),
+          ),
+        release: releaseEntry,
+        detach: (input) =>
+          Effect.gen(function* () {
+            const key = sessionKey(input.providerSessionId);
+            const currentEntry = (yield* Ref.get(sessions)).get(key);
+            if (currentEntry?.supportsMultipleProviderThreads === true) {
+              const projection = yield* Effect.option(
+                projectionStore.getThreadProjection(input.threadId),
+              );
+              if (Option.isSome(projection)) {
+                const providerThreads = new Map(
+                  projection.value.providerThreads
+                    .filter((thread) => thread.providerSessionId === input.providerSessionId)
+                    .map((thread) => [thread.id, thread] as const),
+                );
+                const activeTurns = projection.value.providerTurns.filter(
+                  (turn) => turn.status === "running" && providerThreads.has(turn.providerThreadId),
+                );
+                yield* Effect.forEach(
+                  activeTurns,
+                  (turn) =>
+                    currentEntry.exposedRuntime
+                      .interruptTurn({
+                        providerThread: providerThreads.get(turn.providerThreadId)!,
+                        providerTurnId: turn.id,
+                      })
+                      .pipe(
+                        Effect.catchCause((cause) =>
+                          Effect.logWarning(
+                            "orchestration-v2.driver-session.detach-interrupt-failed",
+                            {
+                              providerSessionId: input.providerSessionId,
+                              threadId: input.threadId,
+                              providerTurnId: turn.id,
+                              cause,
+                            },
+                          ),
+                        ),
+                      ),
+                  { concurrency: 1, discard: true },
+                );
+              }
+            }
+            const detached = yield* Ref.modify(sessions, (current) => {
+              const entry = current.get(key);
+              if (entry === undefined || !entry.attachedThreadIds.has(input.threadId)) {
+                return [Option.none<LiveSessionEntry>(), current] as const;
+              }
+              const attachedThreadIds = new Set(entry.attachedThreadIds);
+              attachedThreadIds.delete(input.threadId);
+              const loadedProviderThreadKeyByThread = new Map(
+                entry.loadedProviderThreadKeyByThread,
+              );
+              loadedProviderThreadKeyByThread.delete(input.threadId);
+              // For a plain (workspace-change) detach, the credential id stays
+              // recorded: the thread may re-attach and reuse it, and
+              // releaseEntry revokes it when the provider process finally goes
+              // away. A terminal detach (archive/delete) prunes the record so
+              // nothing vetoes the revocation below.
+              const mcpCredentialIdByThread =
+                input.revokeMcpCredential === true
+                  ? (() => {
+                      const pruned = new Map(entry.mcpCredentialIdByThread);
+                      pruned.delete(input.threadId);
+                      return pruned;
+                    })()
+                  : entry.mcpCredentialIdByThread;
+              const updatedEntry = {
+                ...entry,
+                attachedThreadIds,
+                loadedProviderThreadKeyByThread,
+                mcpCredentialIdByThread,
+              };
+              const updated = new Map(current);
+              updated.set(key, updatedEntry);
+              return [Option.some(updatedEntry), updated] as const;
+            });
+            // Plain detaches deliberately do not revoke: a detached thread's
+            // provider process may still be alive (shared multi-thread codex
+            // session across a workspace handoff) and holds its MCP client's
+            // credential for the thread it will re-attach with. Credentials
+            // are revoked when the session entry is released (process gone)
+            // or rotated on the next attach if they stopped resolving.
+            // Terminal detaches (thread archived or deleted) revoke the
+            // thread's credentials immediately, even on a retry where the
+            // entry is already gone: there is no legitimate future re-attach,
+            // and the token must not outlive the thread.
+            if (input.revokeMcpCredential === true) {
+              yield* clearMcpSession(input.threadId);
+            }
+            if (Option.isNone(detached)) {
+              return;
+            }
+            if (
+              detached.value.attachedThreadIds.size === 0 &&
+              !detached.value.supportsMultipleProviderThreads
+            ) {
+              yield* releaseEntry({
+                providerSessionId: input.providerSessionId,
+                reason: "manual_shutdown",
+                ...(input.detail === undefined ? {} : { detail: input.detail }),
+              });
+              return;
+            }
+            yield* scheduleIdleRelease(input.providerSessionId);
+          }).pipe(
+            Effect.catchCause((cause) =>
+              Effect.fail(
+                new ProviderSessionReleaseError({
+                  providerSessionId: input.providerSessionId,
+                  reason: "manual_shutdown",
+                  cause,
+                }),
+              ),
+            ),
+          ),
+      } satisfies ProviderSessionManagerV2Shape);
+    }),
+  );
+
+export const layer = layerWithOptions();
diff --git a/apps/server/src/orchestration-v2/ProviderSessionTransitionPolicy.test.ts b/apps/server/src/orchestration-v2/ProviderSessionTransitionPolicy.test.ts
new file mode 100644
index 000000000000..80071a8cd2a7
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ProviderSessionTransitionPolicy.test.ts
@@ -0,0 +1,176 @@
+import { assert, it } from "@effect/vitest";
+import { ProviderDriverKind, ProviderInstanceId } from "@t3tools/contracts";
+
+import { CodexProviderCapabilitiesV2 } from "./Adapters/CodexAdapterV2.ts";
+import { decideProviderSessionTransition } from "./ProviderSessionTransitionPolicy.ts";
+
+const driver = ProviderDriverKind.make("codex");
+const instanceId = ProviderInstanceId.make("codex");
+const base = {
+  driver,
+  continuationIdentity: { driverKind: driver, continuationKey: "codex:account:one" },
+  modelSelection: { instanceId, model: "gpt-5.1-codex" },
+  runtimeMode: "full-access" as const,
+  interactionMode: "default" as const,
+  workspace: "/repo",
+  capabilities: CodexProviderCapabilitiesV2,
+};
+
+it("reuses compatible sessions and treats interaction mode as turn-scoped", () => {
+  assert.deepEqual(
+    decideProviderSessionTransition({
+      current: base,
+      target: { ...base, interactionMode: "plan", available: true },
+    }),
+    { type: "reuse" },
+  );
+});
+
+it("uses the adapter's selection transition classification", () => {
+  assert.deepEqual(
+    decideProviderSessionTransition({
+      current: base,
+      target: {
+        ...base,
+        modelSelection: { ...base.modelSelection, model: "gpt-5.2-codex" },
+        available: true,
+      },
+      selectionTransition: { type: "apply_on_next_turn" },
+    }),
+    { type: "switch_model_in_session" },
+  );
+  assert.deepEqual(
+    decideProviderSessionTransition({
+      current: {
+        ...base,
+        capabilities: {
+          ...base.capabilities,
+          sessions: { ...base.capabilities.sessions, supportsModelSwitchInSession: false },
+        },
+      },
+      target: {
+        ...base,
+        capabilities: {
+          ...base.capabilities,
+          sessions: { ...base.capabilities.sessions, supportsModelSwitchInSession: false },
+        },
+        modelSelection: { ...base.modelSelection, model: "gpt-5.2-codex" },
+        available: true,
+      },
+      selectionTransition: { type: "restart_session" },
+    }),
+    { type: "restart_and_resume" },
+  );
+});
+
+it("treats provider option changes as selection changes", () => {
+  assert.deepEqual(
+    decideProviderSessionTransition({
+      current: {
+        ...base,
+        modelSelection: {
+          ...base.modelSelection,
+          options: [{ id: "reasoningEffort", value: "medium" }],
+        },
+      },
+      target: {
+        ...base,
+        modelSelection: {
+          ...base.modelSelection,
+          options: [{ id: "reasoningEffort", value: "high" }],
+        },
+        available: true,
+      },
+      selectionTransition: { type: "apply_on_next_turn" },
+    }),
+    { type: "switch_model_in_session" },
+  );
+});
+
+it("restarts compatible instances for workspace or runtime changes", () => {
+  assert.deepEqual(
+    decideProviderSessionTransition({
+      current: base,
+      target: { ...base, workspace: "/other", available: true },
+    }),
+    { type: "restart_and_resume" },
+  );
+});
+
+it("preserves a rejected selection when the workspace also changes", () => {
+  assert.deepEqual(
+    decideProviderSessionTransition({
+      current: base,
+      target: {
+        ...base,
+        modelSelection: { ...base.modelSelection, model: "gpt-5.2-codex" },
+        workspace: "/other",
+        available: true,
+      },
+      selectionTransition: {
+        type: "reject",
+        reason: "The active session cannot apply that model.",
+      },
+    }),
+    { type: "reject", reason: "The active session cannot apply that model." },
+  );
+});
+
+it("preserves handoff and missing-classification outcomes across workspace changes", () => {
+  const target = {
+    ...base,
+    modelSelection: { ...base.modelSelection, model: "gpt-5.2-codex" },
+    workspace: "/other",
+    available: true,
+  };
+  assert.deepEqual(
+    decideProviderSessionTransition({
+      current: base,
+      target,
+      selectionTransition: { type: "create_with_handoff" },
+    }),
+    { type: "create_with_handoff" },
+  );
+  assert.deepEqual(decideProviderSessionTransition({ current: base, target }), {
+    type: "reject",
+    reason: "The provider adapter did not classify the selection change.",
+  });
+});
+
+it("uses portable handoff for incompatible continuation identities", () => {
+  assert.deepEqual(
+    decideProviderSessionTransition({
+      current: base,
+      target: {
+        ...base,
+        modelSelection: {
+          ...base.modelSelection,
+          instanceId: ProviderInstanceId.make("codex_other"),
+        },
+        continuationIdentity: { driverKind: driver, continuationKey: "codex:account:other" },
+        available: true,
+      },
+    }),
+    { type: "create_with_handoff" },
+  );
+});
+
+it("uses portable handoff for cross-driver transitions", () => {
+  const claudeDriver = ProviderDriverKind.make("claude");
+  assert.deepEqual(
+    decideProviderSessionTransition({
+      current: base,
+      target: {
+        ...base,
+        driver: claudeDriver,
+        continuationIdentity: { driverKind: claudeDriver, continuationKey: "claude:account:one" },
+        modelSelection: {
+          instanceId: ProviderInstanceId.make("claude"),
+          model: "claude-opus-4-1",
+        },
+        available: true,
+      },
+    }),
+    { type: "create_with_handoff" },
+  );
+});
diff --git a/apps/server/src/orchestration-v2/ProviderSessionTransitionPolicy.ts b/apps/server/src/orchestration-v2/ProviderSessionTransitionPolicy.ts
new file mode 100644
index 000000000000..50c7e561de63
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ProviderSessionTransitionPolicy.ts
@@ -0,0 +1,96 @@
+import type {
+  ModelSelection,
+  OrchestrationV2ProviderCapabilities,
+  ProviderDriverKind,
+  ProviderInteractionMode,
+  RuntimeMode,
+} from "@t3tools/contracts";
+import { modelSelectionsEqual } from "@t3tools/shared/model";
+
+import type { ProviderContinuationIdentity } from "../provider/ProviderDriver.ts";
+import type { ProviderSelectionTransitionPlan } from "./ProviderSelectionTransition.ts";
+
+export type ProviderSessionTransition =
+  | { readonly type: "reuse" }
+  | { readonly type: "switch_model_in_session" }
+  | { readonly type: "restart_and_resume" }
+  | { readonly type: "create_with_handoff" }
+  | { readonly type: "reject"; readonly reason: string };
+
+export interface ProviderSessionTransitionState {
+  readonly driver: ProviderDriverKind;
+  readonly continuationIdentity: ProviderContinuationIdentity;
+  readonly modelSelection: ModelSelection;
+  readonly runtimeMode: RuntimeMode;
+  readonly interactionMode: ProviderInteractionMode;
+  readonly workspace: string;
+  readonly capabilities: OrchestrationV2ProviderCapabilities;
+}
+
+export interface ProviderSessionTransitionTarget extends ProviderSessionTransitionState {
+  readonly available: boolean;
+}
+
+export function decideProviderSessionTransition(input: {
+  readonly current: ProviderSessionTransitionState | null;
+  readonly target: ProviderSessionTransitionTarget;
+  readonly selectionTransition?: ProviderSelectionTransitionPlan;
+}): ProviderSessionTransition {
+  if (!input.target.available) {
+    return { type: "reject", reason: "The target provider instance is unavailable." };
+  }
+  if (input.current === null) {
+    return { type: "create_with_handoff" };
+  }
+
+  const current = input.current;
+  const target = input.target;
+  const continuationCompatible =
+    current.continuationIdentity.driverKind === target.continuationIdentity.driverKind &&
+    current.continuationIdentity.continuationKey === target.continuationIdentity.continuationKey;
+  if (!continuationCompatible || current.driver !== target.driver) {
+    return { type: "create_with_handoff" };
+  }
+
+  const instanceChanged = current.modelSelection.instanceId !== target.modelSelection.instanceId;
+  const runtimeChanged = current.runtimeMode !== target.runtimeMode;
+  const workspaceChanged = current.workspace !== target.workspace;
+  const selectionChanged = !modelSelectionsEqual(current.modelSelection, target.modelSelection);
+  if (selectionChanged && !instanceChanged) {
+    switch (input.selectionTransition?.type) {
+      case "create_with_handoff":
+        return { type: "create_with_handoff" };
+      case "reject":
+        return { type: "reject", reason: input.selectionTransition.reason };
+      case undefined:
+        return {
+          type: "reject",
+          reason: "The provider adapter did not classify the selection change.",
+        };
+      case "apply_on_next_turn":
+      case "restart_session":
+        break;
+    }
+  }
+  if (instanceChanged || runtimeChanged || workspaceChanged) {
+    return { type: "restart_and_resume" };
+  }
+
+  if (selectionChanged) {
+    switch (input.selectionTransition?.type) {
+      case "apply_on_next_turn":
+        return { type: "switch_model_in_session" };
+      case "restart_session":
+        return { type: "restart_and_resume" };
+      case "create_with_handoff":
+        return { type: "create_with_handoff" };
+      case "reject":
+        return { type: "reject", reason: input.selectionTransition.reason };
+      case undefined:
+        return { type: "restart_and_resume" };
+    }
+  }
+
+  // Interaction mode is turn-scoped and is applied when the next turn starts.
+  return { type: "reuse" };
+}
diff --git a/apps/server/src/orchestration-v2/ProviderSwitchService.test.ts b/apps/server/src/orchestration-v2/ProviderSwitchService.test.ts
new file mode 100644
index 000000000000..35bc1b803627
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ProviderSwitchService.test.ts
@@ -0,0 +1,128 @@
+import { assert, it } from "@effect/vitest";
+import {
+  ProviderDriverKind,
+  ProviderInstanceId,
+  ProviderSessionId,
+  ThreadId,
+  type OrchestrationV2ThreadProjection,
+} from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+
+import { CodexProviderCapabilitiesV2 } from "./Adapters/CodexAdapterV2.ts";
+import type { ProviderAdapterV2Shape } from "./ProviderAdapter.ts";
+import * as ProviderAdapterRegistry from "./ProviderAdapterRegistry.ts";
+import * as ProviderSwitch from "./ProviderSwitchService.ts";
+
+const driver = ProviderDriverKind.make("codex");
+const currentInstanceId = ProviderInstanceId.make("codex_primary");
+const currentSessionId = ProviderSessionId.make("session_primary");
+const now = DateTime.makeUnsafe("2026-06-20T00:00:00.000Z");
+const capabilitiesWithoutModelSwitch = {
+  ...CodexProviderCapabilitiesV2,
+  sessions: {
+    ...CodexProviderCapabilitiesV2.sessions,
+    supportsModelSwitchInSession: false,
+  },
+};
+
+function projection(): OrchestrationV2ThreadProjection {
+  return {
+    thread: {
+      id: ThreadId.make("thread_switch_service"),
+      modelSelection: { instanceId: currentInstanceId, model: "gpt-5.1-codex" },
+      runtimeMode: "full-access",
+      interactionMode: "default",
+      worktreePath: "/repo",
+    },
+    providerSessions: [
+      {
+        id: currentSessionId,
+        providerInstanceId: currentInstanceId,
+        status: "ready",
+        cwd: "/repo",
+        capabilities: capabilitiesWithoutModelSwitch,
+        updatedAt: now,
+      },
+    ],
+    providerThreads: [],
+  } as unknown as OrchestrationV2ThreadProjection;
+}
+
+function testLayer(metadata: Readonly<Record<string, { continuationKey: string }>>) {
+  const adapter = (instanceId: ProviderInstanceId): ProviderAdapterV2Shape => ({
+    instanceId,
+    driver,
+    getCapabilities: () => Effect.succeed(capabilitiesWithoutModelSwitch),
+    planSelectionTransition: () => Effect.succeed({ type: "restart_session" }),
+    openSession: () => Effect.die("ProviderSwitchService tests do not open sessions."),
+  });
+  const registry = Layer.mock(ProviderAdapterRegistry.ProviderAdapterRegistryV2)({
+    get: (instanceId) =>
+      metadata[instanceId] === undefined
+        ? Effect.fail(
+            new ProviderAdapterRegistry.ProviderAdapterRegistryLookupError({ instanceId }),
+          )
+        : Effect.succeed(adapter(instanceId)),
+    list: () => Effect.succeed(Object.keys(metadata).map((id) => ProviderInstanceId.make(id))),
+    getMetadata: (instanceId) => {
+      const value = metadata[instanceId];
+      return value === undefined
+        ? Effect.fail(
+            new ProviderAdapterRegistry.ProviderAdapterRegistryLookupError({ instanceId }),
+          )
+        : Effect.succeed({
+            driver,
+            continuationKey: value.continuationKey,
+            enabled: true,
+            capabilities: capabilitiesWithoutModelSwitch,
+          });
+    },
+  });
+  return ProviderSwitch.layer.pipe(Layer.provide(registry));
+}
+
+it.effect(
+  "restarts and releases the current session for unsupported in-session model changes",
+  () =>
+    Effect.gen(function* () {
+      const service = yield* ProviderSwitch.ProviderSwitchServiceV2;
+      const result = yield* service.plan({
+        projection: projection(),
+        targetModelSelection: { instanceId: currentInstanceId, model: "gpt-5.2-codex" },
+      });
+      assert.equal(result.transition.type, "restart_and_resume");
+      assert.deepEqual(result.releaseProviderSessionIds, [currentSessionId]);
+    }).pipe(
+      Effect.provide(
+        testLayer({ [currentInstanceId]: { continuationKey: "codex:account:primary" } }),
+      ),
+    ),
+);
+
+it.effect("distinguishes compatible and incompatible instances of the same driver", () =>
+  Effect.gen(function* () {
+    const service = yield* ProviderSwitch.ProviderSwitchServiceV2;
+    const compatibleId = ProviderInstanceId.make("codex_compatible");
+    const incompatibleId = ProviderInstanceId.make("codex_incompatible");
+    const compatible = yield* service.plan({
+      projection: projection(),
+      targetModelSelection: { instanceId: compatibleId, model: "gpt-5.1-codex" },
+    });
+    const incompatible = yield* service.plan({
+      projection: projection(),
+      targetModelSelection: { instanceId: incompatibleId, model: "gpt-5.1-codex" },
+    });
+    assert.equal(compatible.transition.type, "restart_and_resume");
+    assert.equal(incompatible.transition.type, "create_with_handoff");
+  }).pipe(
+    Effect.provide(
+      testLayer({
+        [currentInstanceId]: { continuationKey: "codex:account:primary" },
+        codex_compatible: { continuationKey: "codex:account:primary" },
+        codex_incompatible: { continuationKey: "codex:account:other" },
+      }),
+    ),
+  ),
+);
diff --git a/apps/server/src/orchestration-v2/ProviderSwitchService.ts b/apps/server/src/orchestration-v2/ProviderSwitchService.ts
new file mode 100644
index 000000000000..669c4b3728cf
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ProviderSwitchService.ts
@@ -0,0 +1,189 @@
+import {
+  ModelSelection,
+  OrchestrationV2ThreadProjection,
+  ProviderSessionId,
+  ProviderThreadId,
+  ThreadId,
+} from "@t3tools/contracts";
+import { modelSelectionsEqual } from "@t3tools/shared/model";
+import * as Context from "effect/Context";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Schema from "effect/Schema";
+
+import * as ProviderAdapterRegistry from "./ProviderAdapterRegistry.ts";
+import {
+  decideProviderSessionTransition,
+  type ProviderSessionTransition,
+} from "./ProviderSessionTransitionPolicy.ts";
+
+export interface ProviderSwitchPlanV2 {
+  readonly instanceChanged: boolean;
+  readonly modelChanged: boolean;
+  readonly targetProviderThreadId: ProviderThreadId | null;
+  readonly releaseProviderSessionIds: ReadonlyArray<ProviderSessionId>;
+  readonly transition: ProviderSessionTransition;
+}
+
+export class ProviderSwitchPlanError extends Schema.TaggedErrorClass<ProviderSwitchPlanError>()(
+  "ProviderSwitchPlanError",
+  {
+    threadId: ThreadId,
+    targetProviderInstanceId: Schema.String,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {}
+
+export interface ProviderSwitchServiceV2Shape {
+  readonly plan: (input: {
+    readonly projection: OrchestrationV2ThreadProjection;
+    readonly targetModelSelection: ModelSelection;
+  }) => Effect.Effect<ProviderSwitchPlanV2, ProviderSwitchPlanError>;
+}
+
+export class ProviderSwitchServiceV2 extends Context.Service<
+  ProviderSwitchServiceV2,
+  ProviderSwitchServiceV2Shape
+>()("t3/orchestration-v2/ProviderSwitchService/ProviderSwitchServiceV2") {}
+
+export const layer: Layer.Layer<
+  ProviderSwitchServiceV2,
+  never,
+  ProviderAdapterRegistry.ProviderAdapterRegistryV2
+> = Layer.effect(
+  ProviderSwitchServiceV2,
+  Effect.gen(function* () {
+    const adapters = yield* ProviderAdapterRegistry.ProviderAdapterRegistryV2;
+    return ProviderSwitchServiceV2.of({
+      plan: ({ projection, targetModelSelection }) =>
+        Effect.gen(function* () {
+          const current = projection.thread.modelSelection;
+          const instanceChanged = current.instanceId !== targetModelSelection.instanceId;
+          const modelChanged = current.model !== targetModelSelection.model;
+          const getMetadata = (instanceId: typeof current.instanceId) =>
+            adapters.getMetadata !== undefined
+              ? adapters.getMetadata(instanceId)
+              : adapters.get(instanceId).pipe(
+                  Effect.flatMap((adapter) =>
+                    adapter.getCapabilities().pipe(
+                      Effect.map((capabilities) => ({
+                        driver: adapter.driver,
+                        continuationKey: `${adapter.driver}:instance:${instanceId}`,
+                        enabled: true,
+                        capabilities,
+                      })),
+                    ),
+                  ),
+                );
+          const currentInstance = yield* Effect.option(getMetadata(current.instanceId));
+          const targetInstance = yield* Effect.option(getMetadata(targetModelSelection.instanceId));
+          const targetAdapter = yield* Effect.option(adapters.get(targetModelSelection.instanceId));
+          const currentSession = projection.providerSessions
+            .filter((session) => session.providerInstanceId === current.instanceId)
+            .toSorted(
+              (left, right) =>
+                DateTime.toEpochMillis(right.updatedAt) - DateTime.toEpochMillis(left.updatedAt),
+            )[0];
+          const selectionTransition =
+            current.instanceId === targetModelSelection.instanceId &&
+            !modelSelectionsEqual(current, targetModelSelection) &&
+            Option.isSome(targetAdapter) &&
+            currentSession !== undefined
+              ? yield* targetAdapter.value.planSelectionTransition({
+                  current,
+                  target: targetModelSelection,
+                  sessionCapabilities: currentSession.capabilities,
+                })
+              : undefined;
+          const transition =
+            Option.isNone(targetInstance) || Option.isNone(targetAdapter)
+              ? ({
+                  type: "reject",
+                  reason: "The target provider instance is unavailable.",
+                } as const)
+              : decideProviderSessionTransition({
+                  current:
+                    Option.isNone(currentInstance) || currentSession === undefined
+                      ? null
+                      : {
+                          driver: currentInstance.value.driver,
+                          continuationIdentity: {
+                            driverKind: currentInstance.value.driver,
+                            continuationKey: currentInstance.value.continuationKey,
+                          },
+                          modelSelection: current,
+                          runtimeMode: projection.thread.runtimeMode,
+                          interactionMode: projection.thread.interactionMode,
+                          workspace: currentSession.cwd,
+                          capabilities: currentSession.capabilities,
+                        },
+                  target: {
+                    driver: targetInstance.value.driver,
+                    continuationIdentity: {
+                      driverKind: targetInstance.value.driver,
+                      continuationKey: targetInstance.value.continuationKey,
+                    },
+                    modelSelection: targetModelSelection,
+                    runtimeMode: projection.thread.runtimeMode,
+                    interactionMode: projection.thread.interactionMode,
+                    workspace:
+                      projection.thread.worktreePath ??
+                      currentSession?.cwd ??
+                      "<unresolved-workspace>",
+                    capabilities: targetInstance.value.capabilities,
+                    available: targetInstance.value.enabled,
+                  },
+                  ...(selectionTransition === undefined ? {} : { selectionTransition }),
+                });
+          if (transition.type === "reject") {
+            return yield* new ProviderSwitchPlanError({
+              threadId: projection.thread.id,
+              targetProviderInstanceId: targetModelSelection.instanceId,
+              cause: transition.reason,
+            });
+          }
+          const targetProviderThread = projection.providerThreads
+            .filter(
+              (thread) =>
+                thread.appThreadId === projection.thread.id &&
+                thread.ownerNodeId === null &&
+                thread.providerInstanceId === targetModelSelection.instanceId,
+            )
+            .toSorted(
+              (left, right) =>
+                DateTime.toEpochMillis(right.updatedAt) - DateTime.toEpochMillis(left.updatedAt),
+            )[0];
+          const releaseProviderSessionIds = projection.providerSessions
+            .filter((session) => {
+              if (session.status === "stopped" || session.status === "error") return false;
+              if (transition.type === "restart_and_resume") {
+                return session.id === currentSession?.id;
+              }
+              if (transition.type === "create_with_handoff") {
+                return session.providerInstanceId !== targetModelSelection.instanceId;
+              }
+              return false;
+            })
+            .map((session) => session.id);
+          return {
+            instanceChanged,
+            modelChanged,
+            targetProviderThreadId: targetProviderThread?.id ?? null,
+            releaseProviderSessionIds,
+            transition,
+          };
+        }).pipe(
+          Effect.mapError(
+            (cause) =>
+              new ProviderSwitchPlanError({
+                threadId: projection.thread.id,
+                targetProviderInstanceId: targetModelSelection.instanceId,
+                cause,
+              }),
+          ),
+        ),
+    });
+  }),
+);
diff --git a/apps/server/src/orchestration-v2/ProviderTurnControlService.test.ts b/apps/server/src/orchestration-v2/ProviderTurnControlService.test.ts
new file mode 100644
index 000000000000..4c7f77c82938
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ProviderTurnControlService.test.ts
@@ -0,0 +1,287 @@
+import { assert, it } from "@effect/vitest";
+import {
+  type ModelSelection,
+  NodeId,
+  type OrchestrationV2ProviderThread,
+  type OrchestrationV2ThreadProjection,
+  ProjectId,
+  ProviderDriverKind,
+  ProviderInstanceId,
+  ProviderSessionId,
+  ProviderThreadId,
+  ProviderTurnId,
+  RunAttemptId,
+  RunId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Ref from "effect/Ref";
+import * as Stream from "effect/Stream";
+
+import { CodexProviderCapabilitiesV2 } from "./Adapters/CodexAdapterV2.ts";
+import { ProjectionStoreV2 } from "./ProjectionStore.ts";
+import type { ProviderAdapterV2SessionRuntime } from "./ProviderAdapter.ts";
+import { ProviderSessionManagerV2 } from "./ProviderSessionManager.ts";
+import {
+  layer as providerTurnControlLayer,
+  ProviderTurnControlServiceV2,
+} from "./ProviderTurnControlService.ts";
+
+const driver = ProviderDriverKind.make("codex");
+const providerInstanceId = ProviderInstanceId.make("codex");
+const modelSelection = {
+  instanceId: providerInstanceId,
+  model: "gpt-5.4",
+} satisfies ModelSelection;
+
+function makeProjection(input: {
+  readonly now: DateTime.Utc;
+  readonly threadId: ThreadId;
+  readonly providerThread: OrchestrationV2ProviderThread;
+  readonly providerTurnId: ProviderTurnId;
+  readonly attemptId: RunAttemptId;
+}): OrchestrationV2ThreadProjection {
+  const runId = RunId.make("run:restart-session");
+  const nodeId = NodeId.make("node:restart-session");
+  return {
+    thread: {
+      createdBy: "user",
+      creationSource: "web",
+      id: input.threadId,
+      projectId: ProjectId.make("project:restart-session"),
+      title: "Restart session",
+      providerInstanceId,
+      modelSelection,
+      runtimeMode: "full-access",
+      interactionMode: "default",
+      branch: null,
+      worktreePath: "/workspace",
+      activeProviderThreadId: input.providerThread.id,
+      lineage: {
+        parentThreadId: null,
+        relationshipToParent: null,
+        rootThreadId: input.threadId,
+      },
+      forkedFrom: null,
+      createdAt: input.now,
+      updatedAt: input.now,
+      archivedAt: null,
+      settledOverride: null,
+      settledAt: null,
+      lastVisitedAt: null,
+      deletedAt: null,
+    },
+    runs: [],
+    attempts: [
+      {
+        id: input.attemptId,
+        runId,
+        attemptOrdinal: 1,
+        rootNodeId: nodeId,
+        providerInstanceId,
+        providerThreadId: input.providerThread.id,
+        providerTurnId: input.providerTurnId,
+        reason: "initial",
+        status: "superseded",
+        startedAt: input.now,
+        completedAt: input.now,
+      },
+    ],
+    nodes: [],
+    subagents: [],
+    providerSessions: [],
+    providerThreads: [input.providerThread],
+    providerTurns: [
+      {
+        id: input.providerTurnId,
+        providerThreadId: input.providerThread.id,
+        nodeId,
+        runAttemptId: input.attemptId,
+        nativeTurnRef: {
+          driver,
+          nativeId: "native-turn:restart-session",
+          strength: "strong",
+        },
+        ordinal: 1,
+        status: "running",
+        startedAt: input.now,
+        completedAt: null,
+      },
+    ],
+    runtimeRequests: [],
+    messages: [],
+    plans: [],
+    turnItems: [],
+    checkpointScopes: [],
+    checkpoints: [],
+    contextHandoffs: [],
+    contextTransfers: [],
+    visibleTurnItems: [],
+    updatedAt: input.now,
+  };
+}
+
+it.effect(
+  "interrupts the historical session only for the exact committed restart replacement",
+  () =>
+    Effect.gen(function* () {
+      const now = yield* DateTime.now;
+      const threadId = ThreadId.make("thread:restart-session");
+      const oldSessionId = ProviderSessionId.make("provider-session:restart-session:old");
+      const replacementSessionId = ProviderSessionId.make(
+        "provider-session:restart-session:replacement",
+      );
+      const unrelatedSessionId = ProviderSessionId.make(
+        "provider-session:restart-session:unrelated",
+      );
+      const providerThreadId = ProviderThreadId.make("provider-thread:restart-session");
+      const providerTurnId = ProviderTurnId.make("provider-turn:restart-session");
+      const attemptId = RunAttemptId.make("run-attempt:restart-session");
+      const providerThread: OrchestrationV2ProviderThread = {
+        id: providerThreadId,
+        driver,
+        providerInstanceId,
+        // The restart command has already projected this replacement binding
+        // before the process-bound restart effect executes.
+        providerSessionId: replacementSessionId,
+        appThreadId: threadId,
+        ownerNodeId: null,
+        nativeThreadRef: {
+          driver,
+          nativeId: "native-thread:restart-session",
+          strength: "strong",
+        },
+        nativeConversationHeadRef: null,
+        status: "not_loaded",
+        firstRunOrdinal: 1,
+        lastRunOrdinal: 1,
+        handoffIds: [],
+        forkedFrom: null,
+        createdAt: now,
+        updatedAt: now,
+      };
+      const projection = yield* Ref.make(
+        makeProjection({ now, threadId, providerThread, providerTurnId, attemptId }),
+      );
+      const interruptedThread = yield* Ref.make<OrchestrationV2ProviderThread | null>(null);
+      const providerSession = {
+        id: oldSessionId,
+        driver,
+        providerInstanceId,
+        status: "running" as const,
+        cwd: "/workspace",
+        model: modelSelection.model,
+        capabilities: CodexProviderCapabilitiesV2,
+        createdAt: now,
+        updatedAt: now,
+        lastError: null,
+      };
+      const runtime: ProviderAdapterV2SessionRuntime = {
+        instanceId: providerInstanceId,
+        driver,
+        providerSessionId: oldSessionId,
+        providerSession,
+        events: Stream.empty,
+        ensureThread: () => Effect.die("unused ensureThread"),
+        resumeThread: () => Effect.die("unused resumeThread"),
+        startTurn: () => Effect.die("unused startTurn"),
+        steerTurn: () => Effect.die("unused steerTurn"),
+        interruptTurn: ({ providerThread: target }) =>
+          Effect.all(
+            [
+              Ref.set(interruptedThread, target),
+              Ref.update(projection, (current) => ({
+                ...current,
+                providerTurns: current.providerTurns.map((turn) =>
+                  turn.id === providerTurnId
+                    ? { ...turn, status: "interrupted" as const, completedAt: now }
+                    : turn,
+                ),
+              })),
+            ],
+            { discard: true },
+          ),
+        respondToRuntimeRequest: () => Effect.die("unused respondToRuntimeRequest"),
+        readThreadSnapshot: () => Effect.die("unused readThreadSnapshot"),
+        rollbackThread: () => Effect.die("unused rollbackThread"),
+        forkThread: () => Effect.die("unused forkThread"),
+      };
+      const projectionLayer = Layer.succeed(
+        ProjectionStoreV2,
+        ProjectionStoreV2.of({
+          apply: () => Effect.void,
+          getShellSnapshot: () => Effect.die("unused getShellSnapshot"),
+          getThreadShell: () => Effect.die("unused getThreadShell"),
+          getThreadProjection: () => Ref.get(projection),
+          getThreadSnapshot: () => Effect.die("unused getThreadSnapshot"),
+          getThreadSnapshotWindow: () => Effect.die("unused getThreadSnapshotWindow"),
+        }),
+      );
+      const sessionManagerLayer = Layer.succeed(
+        ProviderSessionManagerV2,
+        ProviderSessionManagerV2.of({
+          shutdown: Effect.void,
+          open: () => Effect.die("unused open"),
+          get: (providerSessionId) =>
+            Effect.succeed(
+              providerSessionId === oldSessionId ? Option.some(runtime) : Option.none(),
+            ),
+          close: () => Effect.void,
+          release: () => Effect.void,
+          detach: () => Effect.void,
+        }),
+      );
+      const controlLayer = providerTurnControlLayer.pipe(
+        Layer.provide(Layer.merge(projectionLayer, sessionManagerLayer)),
+      );
+
+      const [ordinaryInterrupt, unrelatedRestart] = yield* Effect.gen(function* () {
+        const control = yield* ProviderTurnControlServiceV2;
+        const ordinary = yield* Effect.exit(
+          control.interrupt({
+            threadId,
+            providerSessionId: oldSessionId,
+            providerThreadId,
+            providerTurnId,
+          }),
+        );
+        const unrelated = yield* Effect.exit(
+          control.interruptAndAwaitTerminal({
+            threadId,
+            providerSessionId: oldSessionId,
+            replacementProviderSessionId: unrelatedSessionId,
+            providerThreadId,
+            providerTurnId,
+            interruptedAttemptId: attemptId,
+          }),
+        );
+        return [ordinary, unrelated] as const;
+      }).pipe(Effect.provide(controlLayer));
+
+      assert.isTrue(Exit.isFailure(ordinaryInterrupt));
+      assert.isTrue(Exit.isFailure(unrelatedRestart));
+      assert.isNull(yield* Ref.get(interruptedThread));
+
+      yield* Effect.gen(function* () {
+        const control = yield* ProviderTurnControlServiceV2;
+        yield* control.interruptAndAwaitTerminal({
+          threadId,
+          providerSessionId: oldSessionId,
+          replacementProviderSessionId: replacementSessionId,
+          providerThreadId,
+          providerTurnId,
+          interruptedAttemptId: attemptId,
+        });
+      }).pipe(Effect.provide(controlLayer));
+
+      const interrupted = yield* Ref.get(interruptedThread);
+      assert.isNotNull(interrupted);
+      assert.equal(interrupted?.providerSessionId, oldSessionId);
+      assert.equal(interrupted?.id, providerThreadId);
+      assert.equal(interrupted?.nativeThreadRef?.nativeId, "native-thread:restart-session");
+    }),
+);
diff --git a/apps/server/src/orchestration-v2/ProviderTurnControlService.ts b/apps/server/src/orchestration-v2/ProviderTurnControlService.ts
new file mode 100644
index 000000000000..0ce3ce30fb79
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ProviderTurnControlService.ts
@@ -0,0 +1,296 @@
+import {
+  MessageId,
+  ProviderSessionId,
+  ProviderThreadId,
+  ProviderTurnId,
+  RunAttemptId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Schema from "effect/Schema";
+
+import { ProjectionStoreV2 } from "./ProjectionStore.ts";
+import { ProviderSessionManagerV2 } from "./ProviderSessionManager.ts";
+
+const yieldToRuntime = Effect.yieldNow.pipe(
+  Effect.andThen(
+    Effect.promise(
+      () =>
+        new Promise<void>((resolve) => {
+          setImmediate(resolve);
+        }),
+    ),
+  ),
+);
+
+export class ProviderTurnControlError extends Schema.TaggedErrorClass<ProviderTurnControlError>()(
+  "ProviderTurnControlError",
+  {
+    threadId: ThreadId,
+    operation: Schema.Literals(["interrupt", "restart", "steer"]),
+    providerTurnId: ProviderTurnId,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {}
+
+const isProviderTurnControlError = Schema.is(ProviderTurnControlError);
+
+export interface ProviderTurnControlServiceV2Shape {
+  readonly interrupt: (input: {
+    readonly threadId: ThreadId;
+    readonly providerSessionId: ProviderSessionId;
+    readonly providerThreadId: ProviderThreadId;
+    readonly providerTurnId: ProviderTurnId;
+  }) => Effect.Effect<void, ProviderTurnControlError>;
+  readonly steer: (input: {
+    readonly threadId: ThreadId;
+    readonly providerSessionId: ProviderSessionId;
+    readonly providerThreadId: ProviderThreadId;
+    readonly providerTurnId: ProviderTurnId;
+    readonly messageId: MessageId;
+  }) => Effect.Effect<void, ProviderTurnControlError>;
+  readonly interruptAndAwaitTerminal: (input: {
+    readonly threadId: ThreadId;
+    readonly providerSessionId: ProviderSessionId;
+    readonly replacementProviderSessionId?: ProviderSessionId;
+    readonly providerThreadId: ProviderThreadId;
+    readonly providerTurnId: ProviderTurnId;
+    readonly interruptedAttemptId: RunAttemptId;
+  }) => Effect.Effect<void, ProviderTurnControlError>;
+}
+
+export class ProviderTurnControlServiceV2 extends Context.Service<
+  ProviderTurnControlServiceV2,
+  ProviderTurnControlServiceV2Shape
+>()("t3/orchestration-v2/ProviderTurnControlService/ProviderTurnControlServiceV2") {}
+
+export const layer: Layer.Layer<
+  ProviderTurnControlServiceV2,
+  never,
+  ProjectionStoreV2 | ProviderSessionManagerV2
+> = Layer.effect(
+  ProviderTurnControlServiceV2,
+  Effect.gen(function* () {
+    const projections = yield* ProjectionStoreV2;
+    const sessions = yield* ProviderSessionManagerV2;
+
+    const load = (input: {
+      readonly threadId: ThreadId;
+      readonly providerSessionId: ProviderSessionId;
+      readonly replacementProviderSessionId?: ProviderSessionId;
+      readonly providerThreadId: ProviderThreadId;
+      readonly providerTurnId: ProviderTurnId;
+      readonly operation: "interrupt" | "restart" | "steer";
+    }) =>
+      Effect.gen(function* () {
+        const projection = yield* projections.getThreadProjection(input.threadId);
+        const providerThread = projection.providerThreads.find(
+          (candidate) => candidate.id === input.providerThreadId,
+        );
+        const providerTurn = projection.providerTurns.find(
+          (candidate) => candidate.id === input.providerTurnId,
+        );
+        const targetsRecordedSession =
+          providerThread?.providerSessionId === input.providerSessionId;
+        const targetsCommittedReplacement =
+          input.operation === "restart" &&
+          input.replacementProviderSessionId !== undefined &&
+          providerThread?.providerSessionId === input.replacementProviderSessionId;
+        if (
+          providerThread === undefined ||
+          providerTurn === undefined ||
+          (!targetsRecordedSession && !targetsCommittedReplacement) ||
+          providerTurn.providerThreadId !== providerThread.id
+        ) {
+          return yield* new ProviderTurnControlError({
+            threadId: input.threadId,
+            operation: input.operation,
+            providerTurnId: input.providerTurnId,
+            cause: "The recorded provider execution target is no longer valid.",
+          });
+        }
+        // A restart-session command commits the replacement binding before its
+        // process-bound effect runs. The old live runtime must still receive
+        // the interrupt, but only when the projection matches the exact
+        // replacement captured by that same durable effect.
+        const interruptProviderThread = targetsRecordedSession
+          ? providerThread
+          : { ...providerThread, providerSessionId: input.providerSessionId };
+        if (providerTurn.status !== "running") {
+          return {
+            projection,
+            providerThread: interruptProviderThread,
+            providerTurn,
+            session: Option.none(),
+          };
+        }
+        const session = yield* sessions.get(input.providerSessionId);
+        if (Option.isNone(session)) {
+          // Interrupt/restart against a already-released session must not fail
+          // the durable effect (and retry 5x). The turn may still look running
+          // in projection until recovery/finalization; there is no live adapter
+          // to interrupt.
+          if (input.operation === "interrupt" || input.operation === "restart") {
+            yield* Effect.logWarning(
+              "Provider interrupt/restart found no live session; treating as already stopped",
+              {
+                threadId: input.threadId,
+                operation: input.operation,
+                providerSessionId: input.providerSessionId,
+                providerTurnId: input.providerTurnId,
+                providerTurnStatus: providerTurn.status,
+              },
+            );
+            return {
+              projection,
+              providerThread: interruptProviderThread,
+              providerTurn,
+              session: Option.none(),
+            };
+          }
+          return yield* new ProviderTurnControlError({
+            threadId: input.threadId,
+            operation: input.operation,
+            providerTurnId: input.providerTurnId,
+            cause: `Provider session ${input.providerSessionId} is not active.`,
+          });
+        }
+        return { projection, providerThread: interruptProviderThread, providerTurn, session };
+      });
+
+    return ProviderTurnControlServiceV2.of({
+      interrupt: (input) =>
+        Effect.gen(function* () {
+          const loaded = yield* load({ ...input, operation: "interrupt" });
+          if (Option.isNone(loaded.session)) return;
+          yield* loaded.session.value.interruptTurn({
+            providerThread: loaded.providerThread,
+            providerTurnId: loaded.providerTurn.id,
+            requestRuntimeRestart: true,
+          });
+        }).pipe(
+          Effect.mapError((cause) =>
+            isProviderTurnControlError(cause)
+              ? cause
+              : new ProviderTurnControlError({
+                  threadId: input.threadId,
+                  operation: "interrupt",
+                  providerTurnId: input.providerTurnId,
+                  cause,
+                }),
+          ),
+        ),
+      interruptAndAwaitTerminal: (input) =>
+        Effect.gen(function* () {
+          const loaded = yield* load({ ...input, operation: "restart" });
+          if (Option.isNone(loaded.session)) {
+            // No live adapter: nothing can emit a terminal provider-turn update
+            // from interrupt. Do not poll for projection terminalization or the
+            // restart effect stalls; let detach/start proceed.
+            if (loaded.providerTurn.status === "running") {
+              yield* Effect.logWarning(
+                "Provider restart interrupt skipped; no live session for a still-projected running turn",
+                {
+                  threadId: input.threadId,
+                  providerSessionId: input.providerSessionId,
+                  providerTurnId: input.providerTurnId,
+                },
+              );
+            }
+            return;
+          }
+
+          yield* loaded.session.value.interruptTurn({
+            providerThread: loaded.providerThread,
+            providerTurnId: loaded.providerTurn.id,
+          });
+
+          for (let remaining = 1_000; remaining > 0; remaining -= 1) {
+            const projection = yield* projections.getThreadProjection(input.threadId);
+            const providerTurn = projection.providerTurns.find(
+              (candidate) => candidate.id === input.providerTurnId,
+            );
+            const attempt = projection.attempts.find(
+              (candidate) => candidate.id === input.interruptedAttemptId,
+            );
+            if (
+              providerTurn !== undefined &&
+              providerTurn.status !== "running" &&
+              attempt !== undefined &&
+              attempt.status !== "running"
+            ) {
+              return;
+            }
+            // Provider terminal events are projected on a detached ingestion
+            // fiber. Yield through the Node event loop instead of sleeping on
+            // Effect's clock so deterministic runtimes cannot deadlock a
+            // command that is waiting for that projection.
+            yield* yieldToRuntime;
+          }
+          return yield* new ProviderTurnControlError({
+            threadId: input.threadId,
+            operation: "restart",
+            providerTurnId: input.providerTurnId,
+            cause: `Provider turn ${input.providerTurnId} did not terminalize before restart.`,
+          });
+        }).pipe(
+          Effect.mapError((cause) =>
+            isProviderTurnControlError(cause)
+              ? cause
+              : new ProviderTurnControlError({
+                  threadId: input.threadId,
+                  operation: "restart",
+                  providerTurnId: input.providerTurnId,
+                  cause,
+                }),
+          ),
+        ),
+      steer: (input) =>
+        Effect.gen(function* () {
+          const loaded = yield* load({ ...input, operation: "steer" });
+          if (Option.isNone(loaded.session)) return;
+          const message = loaded.projection.messages.find(
+            (candidate) => candidate.id === input.messageId,
+          );
+          const run = loaded.projection.runs.find(
+            (candidate) => candidate.activeAttemptId === loaded.providerTurn.runAttemptId,
+          );
+          if (message === undefined || run === undefined) {
+            return yield* new ProviderTurnControlError({
+              threadId: input.threadId,
+              operation: "steer",
+              providerTurnId: input.providerTurnId,
+              cause: "The persisted steering message or target run is missing.",
+            });
+          }
+          yield* loaded.session.value.steerTurn({
+            threadId: input.threadId,
+            runId: run.id,
+            providerThread: loaded.providerThread,
+            providerTurnId: loaded.providerTurn.id,
+            message: {
+              messageId: message.id,
+              text: message.text,
+              attachments: message.attachments,
+              createdBy: message.createdBy,
+              creationSource: message.creationSource,
+            },
+          });
+        }).pipe(
+          Effect.mapError((cause) =>
+            isProviderTurnControlError(cause)
+              ? cause
+              : new ProviderTurnControlError({
+                  threadId: input.threadId,
+                  operation: "steer",
+                  providerTurnId: input.providerTurnId,
+                  cause,
+                }),
+          ),
+        ),
+    });
+  }),
+);
diff --git a/apps/server/src/orchestration-v2/ProviderTurnStartService.test.ts b/apps/server/src/orchestration-v2/ProviderTurnStartService.test.ts
new file mode 100644
index 000000000000..0e028722da5d
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ProviderTurnStartService.test.ts
@@ -0,0 +1,129 @@
+import { expect, it, vi } from "vite-plus/test";
+import {
+  CheckpointScopeId,
+  MessageId,
+  NodeId,
+  ProviderSessionId,
+  ProviderThreadId,
+  RunAttemptId,
+  RunId,
+  ThreadId,
+  ProjectId,
+  type OrchestrationV2ThreadProjection,
+} from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+
+import * as GitWorkflow from "../git/GitWorkflowService.ts";
+import * as ProjectService from "../project/ProjectService.ts";
+import * as ContextHandoffService from "./ContextHandoffService.ts";
+import * as EventSink from "./EventSink.ts";
+import * as IdAllocator from "./IdAllocator.ts";
+import * as ProjectionStore from "./ProjectionStore.ts";
+import * as ProviderSessionManager from "./ProviderSessionManager.ts";
+import * as ProviderTurnStart from "./ProviderTurnStartService.ts";
+import * as RunExecutionService from "./RunExecutionService.ts";
+import * as RuntimePolicy from "./RuntimePolicy.ts";
+
+it("does not commit running state when inherited background routing cannot be read", async () => {
+  const threadId = ThreadId.make("thread_provider_turn_start_projection_failure");
+  const runId = RunId.make("run_provider_turn_start_projection_failure");
+  const attemptId = RunAttemptId.make("attempt_provider_turn_start_projection_failure");
+  const rootNodeId = NodeId.make("node_provider_turn_start_projection_failure");
+  const providerThreadId = ProviderThreadId.make(
+    "provider_thread_provider_turn_start_projection_failure",
+  );
+  const providerSessionId = ProviderSessionId.make(
+    "provider_session_provider_turn_start_projection_failure",
+  );
+  const messageId = MessageId.make("message_provider_turn_start_projection_failure");
+  const checkpointScopeId = CheckpointScopeId.make(
+    "checkpoint_scope_provider_turn_start_projection_failure",
+  );
+  const projection = {
+    thread: {
+      id: threadId,
+      projectId: ProjectId.make("project_provider_turn_start_projection_failure"),
+      branch: "feature/restore",
+      worktreePath: "/tmp/missing-provider-turn-start-worktree",
+    },
+    runs: [
+      {
+        id: runId,
+        status: "starting",
+        rootNodeId,
+        activeAttemptId: attemptId,
+        providerThreadId,
+        userMessageId: messageId,
+        ordinal: 2,
+      },
+    ],
+    nodes: [{ id: rootNodeId, checkpointScopeId }],
+    attempts: [{ id: attemptId }],
+    providerThreads: [{ id: providerThreadId, providerSessionId }],
+    messages: [{ id: messageId }],
+    checkpointScopes: [{ id: checkpointScopeId }],
+    contextHandoffs: [],
+    contextTransfers: [],
+    turnItems: [],
+  } as unknown as OrchestrationV2ThreadProjection;
+  let projectionReadCount = 0;
+  const writeIfRunCurrent = vi.fn(() =>
+    Effect.succeed({ committed: true, storedEvents: [] } as never),
+  );
+  const startRootRun = vi.fn(() => Effect.void);
+  const pruneWorktrees = vi.fn(() => Effect.void);
+  const createWorktree = vi.fn(() => Effect.succeed({} as never));
+  const layer = ProviderTurnStart.layer.pipe(
+    Layer.provide(
+      Layer.mergeAll(
+        Layer.mock(ContextHandoffService.ContextHandoffServiceV2)({}),
+        Layer.mock(EventSink.EventSinkV2)({ writeIfRunCurrent }),
+        IdAllocator.layer,
+        Layer.succeed(FileSystem.FileSystem, { exists: () => Effect.succeed(false) } as never),
+        Layer.mock(GitWorkflow.GitWorkflowService)({ pruneWorktrees, createWorktree }),
+        Layer.mock(ProjectService.ProjectService)({
+          getById: () =>
+            Effect.succeed(
+              Option.some({ workspaceRoot: "/tmp/provider-turn-start-project" } as never),
+            ),
+        }),
+        Layer.mock(ProjectionStore.ProjectionStoreV2)({
+          getThreadProjection: () => {
+            projectionReadCount += 1;
+            return projectionReadCount === 1
+              ? Effect.succeed(projection)
+              : Effect.fail(
+                  new ProjectionStore.ProjectionStoreReadError({
+                    threadId,
+                    cause: "simulated inherited-background projection failure",
+                  }),
+                );
+          },
+        }),
+        Layer.mock(ProviderSessionManager.ProviderSessionManagerV2)({}),
+        Layer.mock(RunExecutionService.RunExecutionServiceV2)({ startRootRun }),
+        Layer.mock(RuntimePolicy.RuntimePolicyV2)({}),
+      ),
+    ),
+  );
+
+  await Effect.gen(function* () {
+    const error = yield* (yield* ProviderTurnStart.ProviderTurnStartServiceV2)
+      .start({ threadId, runId })
+      .pipe(Effect.flip);
+
+    expect(error._tag).toBe("ProviderTurnStartError");
+    expect(projectionReadCount).toBe(2);
+    expect(pruneWorktrees).toHaveBeenCalledWith({ cwd: "/tmp/provider-turn-start-project" });
+    expect(createWorktree).toHaveBeenCalledWith({
+      cwd: "/tmp/provider-turn-start-project",
+      refName: "feature/restore",
+      path: "/tmp/missing-provider-turn-start-worktree",
+    });
+    expect(writeIfRunCurrent).not.toHaveBeenCalled();
+    expect(startRootRun).not.toHaveBeenCalled();
+  }).pipe(Effect.provide(layer), Effect.runPromise);
+});
diff --git a/apps/server/src/orchestration-v2/ProviderTurnStartService.testkit.ts b/apps/server/src/orchestration-v2/ProviderTurnStartService.testkit.ts
new file mode 100644
index 000000000000..6517d05b4b85
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ProviderTurnStartService.testkit.ts
@@ -0,0 +1,16 @@
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+
+import * as GitWorkflow from "../git/GitWorkflowService.ts";
+import * as ProjectService from "../project/ProjectService.ts";
+
+export const worktreeRepairDependenciesTestLayer = Layer.merge(
+  Layer.mock(GitWorkflow.GitWorkflowService)({
+    pruneWorktrees: () => Effect.void,
+    createWorktree: () => Effect.succeed({} as never),
+  }),
+  Layer.mock(ProjectService.ProjectService)({
+    getById: () => Effect.succeed(Option.none()),
+  }),
+);
diff --git a/apps/server/src/orchestration-v2/ProviderTurnStartService.ts b/apps/server/src/orchestration-v2/ProviderTurnStartService.ts
new file mode 100644
index 000000000000..fa448480d1e8
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ProviderTurnStartService.ts
@@ -0,0 +1,561 @@
+import {
+  CommandId,
+  type OrchestrationV2DomainEvent,
+  type OrchestrationV2ExecutionNode,
+  type OrchestrationV2ProviderThread,
+  type OrchestrationV2Run,
+  type OrchestrationV2RunAttempt,
+  RunId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as Context from "effect/Context";
+import * as Cause from "effect/Cause";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Schema from "effect/Schema";
+
+import { GitWorkflowService } from "../git/GitWorkflowService.ts";
+import { ProjectService } from "../project/ProjectService.ts";
+import { EventSinkV2 } from "./EventSink.ts";
+import {
+  ContextHandoffServiceV2,
+  providerMessageWithContextHandoffs,
+} from "./ContextHandoffService.ts";
+import { IdAllocatorV2 } from "./IdAllocator.ts";
+import { ProjectionStoreV2 } from "./ProjectionStore.ts";
+import { ProviderSessionManagerV2 } from "./ProviderSessionManager.ts";
+import {
+  canRouteRelatedSubagent,
+  RunExecutionServiceV2,
+  selectInheritedBackgroundTurnItems,
+} from "./RunExecutionService.ts";
+import { RuntimePolicyV2 } from "./RuntimePolicy.ts";
+
+export class ProviderTurnStartError extends Schema.TaggedErrorClass<ProviderTurnStartError>()(
+  "ProviderTurnStartError",
+  {
+    runId: RunId,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {}
+
+const isProviderTurnStartError = Schema.is(ProviderTurnStartError);
+
+export interface ProviderTurnStartServiceV2Shape {
+  readonly start: (input: {
+    readonly threadId: ThreadId;
+    readonly runId: RunId;
+  }) => Effect.Effect<void, ProviderTurnStartError>;
+}
+
+export class ProviderTurnStartServiceV2 extends Context.Service<
+  ProviderTurnStartServiceV2,
+  ProviderTurnStartServiceV2Shape
+>()("t3/orchestration-v2/ProviderTurnStartService/ProviderTurnStartServiceV2") {}
+
+export const layer: Layer.Layer<
+  ProviderTurnStartServiceV2,
+  never,
+  | EventSinkV2
+  | ContextHandoffServiceV2
+  | IdAllocatorV2
+  | FileSystem.FileSystem
+  | GitWorkflowService
+  | ProjectService
+  | ProjectionStoreV2
+  | ProviderSessionManagerV2
+  | RunExecutionServiceV2
+  | RuntimePolicyV2
+> = Layer.effect(
+  ProviderTurnStartServiceV2,
+  Effect.gen(function* () {
+    const eventSink = yield* EventSinkV2;
+    const contextHandoffService = yield* ContextHandoffServiceV2;
+    const idAllocator = yield* IdAllocatorV2;
+    const fileSystem = yield* FileSystem.FileSystem;
+    const gitWorkflow = yield* GitWorkflowService;
+    const projects = yield* ProjectService;
+    const projectionStore = yield* ProjectionStoreV2;
+    const providerSessions = yield* ProviderSessionManagerV2;
+    const runExecution = yield* RunExecutionServiceV2;
+    const runtimePolicy = yield* RuntimePolicyV2;
+
+    const start = Effect.fn("orchestrationV2.providerTurnStart.start")(function* (input: {
+      readonly threadId: ThreadId;
+      readonly runId: RunId;
+    }) {
+      const { runId } = input;
+      const projection = yield* projectionStore.getThreadProjection(input.threadId);
+      const run = projection.runs.find((candidate) => candidate.id === runId);
+      if (run === undefined) {
+        return yield* new ProviderTurnStartError({ runId, cause: `Run ${runId} was not found.` });
+      }
+      if (run.status !== "starting") {
+        // The effect is idempotent once the run has advanced or terminalized.
+        return;
+      }
+      const rootNode = projection.nodes.find((candidate) => candidate.id === run.rootNodeId);
+      const attempt = projection.attempts.find((candidate) => candidate.id === run.activeAttemptId);
+      const providerThread = projection.providerThreads.find(
+        (candidate) => candidate.id === run.providerThreadId,
+      );
+      const message = projection.messages.find((candidate) => candidate.id === run.userMessageId);
+      const checkpointScope = projection.checkpointScopes.find(
+        (candidate) => candidate.id === rootNode?.checkpointScopeId,
+      );
+      const handoffs = projection.contextHandoffs.filter(
+        (handoff) => handoff.targetRunId === run.id && handoff.status === "ready",
+      );
+      const nativeForkTransfer = projection.contextTransfers.find(
+        (transfer) =>
+          transfer.type === "fork" &&
+          transfer.targetThreadId === input.threadId &&
+          transfer.targetRunId === run.id &&
+          transfer.status === "pending" &&
+          transfer.resolution === null,
+      );
+      const existingResumeFallback = projection.contextTransfers.find(
+        (transfer) =>
+          transfer.type === "provider_handoff" &&
+          transfer.sourceThreadId === projection.thread.id &&
+          transfer.targetThreadId === projection.thread.id &&
+          transfer.targetRunId === run.id &&
+          transfer.status === "resolved_portable" &&
+          transfer.resolution?.strategy === "portable_context",
+      );
+      if (
+        rootNode === undefined ||
+        attempt === undefined ||
+        providerThread === undefined ||
+        providerThread.providerSessionId === null ||
+        message === undefined ||
+        checkpointScope === undefined
+      ) {
+        return yield* new ProviderTurnStartError({
+          runId,
+          cause: `Run ${runId} is missing its execution projection state.`,
+        });
+      }
+      const { worktreePath, branch } = projection.thread;
+      if (worktreePath !== null && branch !== null) {
+        const exists = yield* fileSystem
+          .exists(worktreePath)
+          .pipe(Effect.orElseSucceed(() => true));
+        if (!exists) {
+          const project = yield* projects.getById(projection.thread.projectId).pipe(
+            Effect.map(Option.getOrUndefined),
+            Effect.orElseSucceed(() => undefined),
+          );
+          if (project !== undefined) {
+            yield* Effect.logWarning("provider turn start recreating missing worktree", {
+              threadId: projection.thread.id,
+              worktreePath,
+              branch,
+            });
+            yield* gitWorkflow.pruneWorktrees({ cwd: project.workspaceRoot }).pipe(
+              Effect.andThen(
+                gitWorkflow.createWorktree({
+                  cwd: project.workspaceRoot,
+                  refName: branch,
+                  path: worktreePath,
+                }),
+              ),
+              Effect.catchCause((cause) =>
+                Cause.hasInterruptsOnly(cause)
+                  ? Effect.failCause(cause)
+                  : Effect.logWarning("provider turn start failed to recreate worktree", {
+                      threadId: projection.thread.id,
+                      worktreePath,
+                      cause: Cause.pretty(cause),
+                    }),
+              ),
+            );
+          }
+        }
+      }
+      const selectInheritedBackgroundItems = (
+        current: typeof projection,
+      ): ReturnType<typeof selectInheritedBackgroundTurnItems> =>
+        selectInheritedBackgroundTurnItems({
+          threadId: current.thread.id,
+          currentProviderThreadId: providerThread.id,
+          currentRunOrdinal: run.ordinal,
+          runs: current.runs,
+          turnItems: current.turnItems,
+        });
+      const inheritedBackgroundTurnItems = yield* projectionStore
+        .getThreadProjection(projection.thread.id)
+        .pipe(Effect.map(selectInheritedBackgroundItems));
+      const providerSessionId = providerThread.providerSessionId;
+      const isCurrentAttemptInStatus = (
+        expectedStatus: OrchestrationV2Run["status"],
+      ): Effect.Effect<boolean, never> =>
+        projectionStore.getThreadProjection(projection.thread.id).pipe(
+          Effect.map((current) => {
+            const currentRun = current.runs.find((candidate) => candidate.id === run.id);
+            return (
+              currentRun?.activeAttemptId === attempt.id && currentRun.status === expectedStatus
+            );
+          }),
+          Effect.catchCause(() => Effect.succeed(false)),
+        );
+
+      const resolvedRuntimePolicy = yield* runtimePolicy.resolve({
+        thread: projection.thread,
+        modelSelection: run.modelSelection,
+      });
+      const existingSessionProjection = projection.providerSessions.find(
+        (candidate) => candidate.id === providerSessionId,
+      );
+      const session = yield* providerSessions.open({
+        threadId: projection.thread.id,
+        providerSessionId,
+        modelSelection: run.modelSelection,
+        runtimePolicy: resolvedRuntimePolicy,
+        ...(existingSessionProjection === undefined
+          ? {}
+          : { resumeFromSession: existingSessionProjection }),
+      });
+      let effectiveHandoffs = handoffs;
+      const loadedProviderThread = yield* Effect.gen(function* () {
+        if (nativeForkTransfer !== undefined) {
+          const sourceProjection = yield* projectionStore.getThreadProjection(
+            nativeForkTransfer.sourceThreadId,
+          );
+          const sourceRun = sourceProjection.runs.find(
+            (candidate) => candidate.id === nativeForkTransfer.sourcePoint.runId,
+          );
+          const sourceProviderThread = sourceProjection.providerThreads.find(
+            (candidate) => candidate.id === sourceRun?.providerThreadId,
+          );
+          const sourceAttempt = sourceProjection.attempts.find(
+            (candidate) => candidate.id === sourceRun?.activeAttemptId,
+          );
+          const sourceProviderTurn = sourceProjection.providerTurns.find(
+            (candidate) =>
+              candidate.id === sourceAttempt?.providerTurnId ||
+              candidate.runAttemptId === sourceAttempt?.id,
+          );
+          if (sourceRun === undefined || sourceProviderThread === undefined) {
+            return yield* new ProviderTurnStartError({
+              runId,
+              cause: `Native fork transfer ${nativeForkTransfer.id} has no source provider execution.`,
+            });
+          }
+          return yield* session.forkThread({
+            sourceProviderThread,
+            sourceProviderTurns: sourceProjection.providerTurns,
+            targetThreadId: projection.thread.id,
+            modelSelection: run.modelSelection,
+            runtimePolicy: resolvedRuntimePolicy,
+            ...(sourceProviderTurn === undefined ? {} : { providerTurnId: sourceProviderTurn.id }),
+          });
+        }
+        if (providerThread.nativeThreadRef === null) {
+          return yield* session.ensureThread({
+            threadId: projection.thread.id,
+            modelSelection: run.modelSelection,
+            runtimePolicy: resolvedRuntimePolicy,
+            providerSessionId,
+          });
+        }
+        const resumed = yield* Effect.result(
+          session.resumeThread({
+            providerThread,
+            threadId: projection.thread.id,
+            modelSelection: run.modelSelection,
+            runtimePolicy: resolvedRuntimePolicy,
+          }),
+        );
+        if (resumed._tag === "Success") {
+          return resumed.success;
+        }
+
+        const replacement = yield* session.ensureThread({
+          threadId: projection.thread.id,
+          modelSelection: run.modelSelection,
+          runtimePolicy: resolvedRuntimePolicy,
+          providerSessionId,
+        });
+        if (existingResumeFallback !== undefined) {
+          return replacement;
+        }
+        const transferId = yield* idAllocator.allocate.contextTransfer({
+          sourceThreadId: projection.thread.id,
+          targetThreadId: projection.thread.id,
+          type: "provider_resume_fallback",
+        });
+        const createdAt = yield* DateTime.now;
+        const handoff = yield* contextHandoffService.prepareProviderHandoff({
+          threadId: projection.thread.id,
+          targetRunId: run.id,
+          transferId,
+          fromProviderThreadIds: [providerThread.id],
+          toProviderThreadId: providerThread.id,
+          fromProviderInstanceId: providerThread.providerInstanceId,
+          toProviderInstanceId: run.providerInstanceId,
+          coveredRunOrdinals: { from: 1, to: Math.max(1, run.ordinal - 1) },
+          strategy: "full_thread_summary",
+          items: projection.turnItems,
+          createdAt,
+        });
+        effectiveHandoffs = [...handoffs, handoff];
+        yield* eventSink.write({
+          events: [
+            {
+              id: yield* idAllocator.allocate.event({ threadId: projection.thread.id }),
+              type: "context-handoff.updated",
+              threadId: projection.thread.id,
+              runId: run.id,
+              providerInstanceId: run.providerInstanceId,
+              occurredAt: createdAt,
+              payload: handoff,
+            },
+            {
+              id: yield* idAllocator.allocate.event({ threadId: projection.thread.id }),
+              type: "context-transfer.updated",
+              threadId: projection.thread.id,
+              runId: run.id,
+              providerInstanceId: run.providerInstanceId,
+              occurredAt: createdAt,
+              payload: {
+                id: transferId,
+                type: "provider_handoff",
+                sourceThreadId: projection.thread.id,
+                targetThreadId: projection.thread.id,
+                sourcePoint: { threadId: projection.thread.id },
+                basePoint: null,
+                sourceProviderInstanceId: providerThread.providerInstanceId,
+                targetProviderInstanceId: run.providerInstanceId,
+                targetRunId: run.id,
+                status: "resolved_portable",
+                resolution: { strategy: "portable_context", contextHandoffId: handoff.id },
+                createdBy: "system",
+                error: null,
+                createdAt,
+                updatedAt: createdAt,
+                consumedAt: null,
+              },
+            },
+          ],
+        });
+        return replacement;
+      });
+      if (!(yield* isCurrentAttemptInStatus("starting"))) {
+        return;
+      }
+      const now = yield* DateTime.now;
+      const runningProviderThread: OrchestrationV2ProviderThread = {
+        ...loadedProviderThread,
+        id: providerThread.id,
+        driver: session.driver,
+        providerInstanceId: run.providerInstanceId,
+        providerSessionId,
+        appThreadId: projection.thread.id,
+        ownerNodeId: providerThread.ownerNodeId,
+        firstRunOrdinal: providerThread.firstRunOrdinal ?? run.ordinal,
+        lastRunOrdinal: run.ordinal,
+        handoffIds: providerThread.handoffIds,
+        forkedFrom: providerThread.forkedFrom,
+        status: "active",
+        createdAt: providerThread.createdAt,
+        updatedAt: now,
+      };
+      const runningRun: OrchestrationV2Run = {
+        ...run,
+        status: "running",
+        startedAt: now,
+      };
+      const runningAttempt: OrchestrationV2RunAttempt = {
+        ...attempt,
+        status: "running",
+        startedAt: now,
+      };
+      const runningRootNode: OrchestrationV2ExecutionNode = {
+        ...rootNode,
+        status: "running",
+        startedAt: now,
+      };
+      const events: Array<OrchestrationV2DomainEvent> = [
+        {
+          id: yield* idAllocator.allocate.event({
+            threadId: projection.thread.id,
+            providerSessionId,
+          }),
+          type: "provider-session.updated",
+          threadId: projection.thread.id,
+          driver: session.driver,
+          providerInstanceId: run.providerInstanceId,
+          occurredAt: now,
+          payload: session.providerSession,
+        },
+        {
+          id: yield* idAllocator.allocate.event({ threadId: projection.thread.id }),
+          type: "provider-thread.updated",
+          threadId: projection.thread.id,
+          driver: session.driver,
+          providerInstanceId: run.providerInstanceId,
+          occurredAt: now,
+          payload: runningProviderThread,
+        },
+        ...(nativeForkTransfer === undefined || runningProviderThread.nativeThreadRef === null
+          ? []
+          : [
+              {
+                id: yield* idAllocator.allocate.event({ threadId: projection.thread.id }),
+                type: "context-transfer.updated" as const,
+                threadId: projection.thread.id,
+                runId: run.id,
+                driver: session.driver,
+                providerInstanceId: run.providerInstanceId,
+                occurredAt: now,
+                payload: {
+                  ...nativeForkTransfer,
+                  targetProviderInstanceId: run.providerInstanceId,
+                  targetRunId: run.id,
+                  status: "consumed" as const,
+                  resolution: {
+                    strategy: "native_fork" as const,
+                    providerThreadRef: runningProviderThread.nativeThreadRef,
+                  },
+                  error: null,
+                  updatedAt: now,
+                  consumedAt: now,
+                },
+              },
+            ]),
+        {
+          id: yield* idAllocator.allocate.event({ threadId: projection.thread.id }),
+          type: "run.updated",
+          threadId: projection.thread.id,
+          runId: run.id,
+          nodeId: rootNode.id,
+          providerInstanceId: run.providerInstanceId,
+          occurredAt: now,
+          payload: runningRun,
+        },
+        {
+          id: yield* idAllocator.allocate.event({ threadId: projection.thread.id }),
+          type: "run-attempt.updated",
+          threadId: projection.thread.id,
+          runId: run.id,
+          nodeId: rootNode.id,
+          providerInstanceId: run.providerInstanceId,
+          occurredAt: now,
+          payload: runningAttempt,
+        },
+        {
+          id: yield* idAllocator.allocate.event({ threadId: projection.thread.id }),
+          type: "node.updated",
+          threadId: projection.thread.id,
+          runId: run.id,
+          nodeId: rootNode.id,
+          providerInstanceId: run.providerInstanceId,
+          occurredAt: now,
+          payload: runningRootNode,
+        },
+      ];
+      const runningWrite = yield* eventSink.writeIfRunCurrent({
+        threadId: projection.thread.id,
+        runId: run.id,
+        activeAttemptId: attempt.id,
+        expectedStatus: "starting",
+        events,
+      });
+      if (!runningWrite.committed) {
+        return;
+      }
+      const routableSubagents = projection.subagents.filter((subagent) =>
+        canRouteRelatedSubagent(subagent.status),
+      );
+      yield* runExecution.startRootRun({
+        commandId: CommandId.make(`command:effect:provider-turn.start:${run.id}`),
+        appThread: projection.thread,
+        providerSessionId,
+        session,
+        run: runningRun,
+        rootNode: runningRootNode,
+        checkpointScope,
+        providerThread: runningProviderThread,
+        attempt: runningAttempt,
+        attemptId: attempt.id,
+        loadInheritedBackgroundTurnItems: () =>
+          projectionStore.getThreadProjection(projection.thread.id).pipe(
+            Effect.map(selectInheritedBackgroundItems),
+            Effect.catchCause(() => Effect.succeed(inheritedBackgroundTurnItems)),
+          ),
+        relatedThreadIds: routableSubagents.flatMap((subagent) =>
+          subagent.childThreadId === null ? [] : [subagent.childThreadId],
+        ),
+        relatedProviderThreadIds: routableSubagents.flatMap((subagent) =>
+          subagent.providerThreadId === null ? [] : [subagent.providerThreadId],
+        ),
+        providerTurnOrdinal:
+          Math.max(
+            0,
+            ...projection.providerTurns
+              .filter((turn) => turn.providerThreadId === providerThread.id)
+              .map((turn) => turn.ordinal),
+          ) + 1,
+        shouldStartProviderTurn: () => isCurrentAttemptInStatus("running"),
+        shouldFinalizeRun: () =>
+          projectionStore.getThreadProjection(projection.thread.id).pipe(
+            Effect.map((current) => {
+              const currentRun = current.runs.find((candidate) => candidate.id === run.id);
+              return (
+                currentRun?.activeAttemptId === attempt.id &&
+                (currentRun.status === "starting" || currentRun.status === "running")
+              );
+            }),
+            Effect.catchCause(() => Effect.succeed(false)),
+          ),
+        hasUnpairedRunInterruptRequest: () =>
+          projectionStore.getThreadProjection(projection.thread.id).pipe(
+            Effect.map((current) => {
+              const requestId = idAllocator.derive.runSignalTurnItem({
+                runId: run.id,
+                signal: "interrupt-request",
+              });
+              const resultId = idAllocator.derive.runSignalTurnItem({
+                runId: run.id,
+                signal: "interrupt-result",
+              });
+              const hasRequest = current.turnItems.some((item) => item.id === requestId);
+              const hasResult = current.turnItems.some((item) => item.id === resultId);
+              return hasRequest && !hasResult;
+            }),
+            Effect.catchCause(() => Effect.succeed(false)),
+          ),
+        message: {
+          messageId: message.id,
+          text:
+            effectiveHandoffs.length === 0
+              ? message.text
+              : providerMessageWithContextHandoffs({
+                  handoffs: effectiveHandoffs,
+                  userText: message.text,
+                }),
+          attachments: message.attachments,
+          createdBy: message.createdBy,
+          creationSource: message.creationSource,
+        },
+        modelSelection: run.modelSelection,
+        runtimePolicy: resolvedRuntimePolicy,
+      });
+    });
+
+    return ProviderTurnStartServiceV2.of({
+      start: (input) =>
+        start(input).pipe(
+          Effect.mapError((cause) =>
+            isProviderTurnStartError(cause)
+              ? cause
+              : new ProviderTurnStartError({ runId: input.runId, cause }),
+          ),
+        ),
+    });
+  }),
+);
diff --git a/apps/server/src/orchestration-v2/ProviderTurnTokenUsage.test.ts b/apps/server/src/orchestration-v2/ProviderTurnTokenUsage.test.ts
new file mode 100644
index 000000000000..c8fd51902fda
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ProviderTurnTokenUsage.test.ts
@@ -0,0 +1,43 @@
+import {
+  NodeId,
+  type OrchestrationV2ProviderTurn,
+  ProviderThreadId,
+  ProviderTurnId,
+} from "@t3tools/contracts";
+import { assert, describe, it } from "@effect/vitest";
+import * as DateTime from "effect/DateTime";
+
+import { upsertProviderTurn } from "./ProjectionStore.ts";
+
+describe("provider turn token usage projection", () => {
+  it("keeps live usage when a terminal update omits it", () => {
+    const now = DateTime.makeUnsafe("2026-08-29T00:00:00.000Z");
+    const running = {
+      id: ProviderTurnId.make("provider-turn-usage"),
+      providerThreadId: ProviderThreadId.make("provider-thread-usage"),
+      nodeId: NodeId.make("node-usage"),
+      runAttemptId: null,
+      nativeTurnRef: null,
+      ordinal: 1,
+      status: "running",
+      startedAt: now,
+      completedAt: null,
+      tokenUsage: {
+        usedTokens: 50_000,
+        maxTokens: 200_000,
+        updatedAt: "2026-08-29T00:00:00.000Z",
+      },
+    } satisfies OrchestrationV2ProviderTurn;
+    const completed = {
+      ...running,
+      status: "completed",
+      completedAt: now,
+      tokenUsage: undefined,
+    } satisfies OrchestrationV2ProviderTurn;
+
+    const projected = upsertProviderTurn([running], completed);
+
+    assert.deepEqual(projected[0]?.tokenUsage, running.tokenUsage);
+    assert.equal(projected[0]?.status, "completed");
+  });
+});
diff --git a/apps/server/src/orchestration-v2/QueuedRunOrder.test.ts b/apps/server/src/orchestration-v2/QueuedRunOrder.test.ts
new file mode 100644
index 000000000000..838ec141a4b5
--- /dev/null
+++ b/apps/server/src/orchestration-v2/QueuedRunOrder.test.ts
@@ -0,0 +1,51 @@
+import { describe, expect, it } from "vite-plus/test";
+
+import { queuedRunsInDeliveryOrder } from "./QueuedRunOrder.ts";
+
+describe("queued run delivery order", () => {
+  it("keeps automatic completion delivery ahead of visible queued messages", () => {
+    const projection = {
+      messages: [
+        { id: "message:visible-first" },
+        {
+          id: "message:automatic",
+          delegatedCompletion: {
+            generation: 1,
+            parentRunId: "run:parent",
+            taskIds: ["task:child"],
+          },
+        },
+        { id: "message:visible-second" },
+      ],
+      runs: [
+        {
+          id: "run:visible-first",
+          ordinal: 2,
+          queuePosition: 1,
+          status: "queued",
+          userMessageId: "message:visible-first",
+        },
+        {
+          id: "run:automatic",
+          ordinal: 4,
+          queuePosition: 3,
+          status: "queued",
+          userMessageId: "message:automatic",
+        },
+        {
+          id: "run:visible-second",
+          ordinal: 3,
+          queuePosition: 2,
+          status: "queued",
+          userMessageId: "message:visible-second",
+        },
+      ],
+    } as never;
+
+    expect(queuedRunsInDeliveryOrder(projection).map((run) => run.id)).toEqual([
+      "run:automatic",
+      "run:visible-first",
+      "run:visible-second",
+    ]);
+  });
+});
diff --git a/apps/server/src/orchestration-v2/QueuedRunOrder.ts b/apps/server/src/orchestration-v2/QueuedRunOrder.ts
new file mode 100644
index 000000000000..f9a1163d5e78
--- /dev/null
+++ b/apps/server/src/orchestration-v2/QueuedRunOrder.ts
@@ -0,0 +1,32 @@
+import type { OrchestrationV2Run, OrchestrationV2ThreadProjection } from "@t3tools/contracts";
+
+export function isAutomaticCompletionRun(
+  projection: OrchestrationV2ThreadProjection,
+  run: OrchestrationV2Run,
+): boolean {
+  return projection.messages.some(
+    (message) => message.id === run.userMessageId && message.delegatedCompletion !== undefined,
+  );
+}
+
+export function queuedRunsInDeliveryOrder(
+  projection: OrchestrationV2ThreadProjection,
+): ReadonlyArray<OrchestrationV2Run> {
+  const automaticCompletionMessageIds = new Set(
+    projection.messages
+      .filter((message) => message.delegatedCompletion !== undefined)
+      .map((message) => message.id),
+  );
+  return projection.runs
+    .filter((run) => run.status === "queued")
+    .toSorted((left, right) => {
+      const deliveryPriority =
+        Number(automaticCompletionMessageIds.has(right.userMessageId)) -
+        Number(automaticCompletionMessageIds.has(left.userMessageId));
+      return (
+        deliveryPriority ||
+        (left.queuePosition ?? left.ordinal) - (right.queuePosition ?? right.ordinal) ||
+        left.ordinal - right.ordinal
+      );
+    });
+}
diff --git a/apps/server/src/orchestration-v2/RandomUuid.ts b/apps/server/src/orchestration-v2/RandomUuid.ts
new file mode 100644
index 000000000000..2f29fc5e399d
--- /dev/null
+++ b/apps/server/src/orchestration-v2/RandomUuid.ts
@@ -0,0 +1,13 @@
+import * as Effect from "effect/Effect";
+import * as Random from "effect/Random";
+
+export const randomUuidV4 = Effect.all(
+  Array.from({ length: 16 }, () => Random.nextIntBetween(0, 256, { halfOpen: true })),
+).pipe(
+  Effect.map((bytes) => {
+    bytes[6] = (bytes[6]! & 0x0f) | 0x40;
+    bytes[8] = (bytes[8]! & 0x3f) | 0x80;
+    const hex = bytes.map((byte) => byte.toString(16).padStart(2, "0")).join("");
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+  }),
+);
diff --git a/apps/server/src/orchestration-v2/ResourceCleanupService.ts b/apps/server/src/orchestration-v2/ResourceCleanupService.ts
new file mode 100644
index 000000000000..45c47498ae68
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ResourceCleanupService.ts
@@ -0,0 +1,71 @@
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Layer from "effect/Layer";
+import * as Schema from "effect/Schema";
+
+import { resolveAttachmentPathById } from "../attachmentStore.ts";
+import * as ServerConfig from "../config.ts";
+import * as TerminalManager from "../terminal/Manager.ts";
+
+export class ResourceCleanupError extends Schema.TaggedErrorClass<ResourceCleanupError>()(
+  "ResourceCleanupError",
+  {
+    operation: Schema.Literals(["terminal", "attachment"]),
+    threadId: Schema.optional(Schema.String),
+    attachmentId: Schema.optional(Schema.String),
+    cause: Schema.Defect(),
+  },
+) {}
+
+export class ResourceCleanupService extends Context.Reference<{
+  readonly cleanupTerminals: (threadId: string) => Effect.Effect<void, ResourceCleanupError>;
+  readonly cleanupAttachments: (
+    attachmentIds: ReadonlyArray<string>,
+  ) => Effect.Effect<void, ResourceCleanupError>;
+}>("t3/orchestration-v2/ResourceCleanupService", {
+  defaultValue: () => ({
+    cleanupTerminals: () => Effect.void,
+    cleanupAttachments: () => Effect.void,
+  }),
+}) {}
+
+export const live = Layer.effect(
+  ResourceCleanupService,
+  Effect.gen(function* () {
+    const terminals = yield* TerminalManager.TerminalManager;
+    const fileSystem = yield* FileSystem.FileSystem;
+    const config = yield* ServerConfig.ServerConfig;
+    return {
+      cleanupTerminals: (threadId: string) =>
+        terminals
+          .close({ threadId, deleteHistory: true })
+          .pipe(
+            Effect.mapError(
+              (cause) => new ResourceCleanupError({ operation: "terminal", threadId, cause }),
+            ),
+          ),
+      cleanupAttachments: (attachmentIds: ReadonlyArray<string>) =>
+        Effect.forEach(
+          attachmentIds,
+          (attachmentId) => {
+            const path = resolveAttachmentPathById({
+              attachmentsDir: config.attachmentsDir,
+              attachmentId,
+            });
+            return path === null
+              ? Effect.void
+              : fileSystem
+                  .remove(path, { force: true })
+                  .pipe(
+                    Effect.mapError(
+                      (cause) =>
+                        new ResourceCleanupError({ operation: "attachment", attachmentId, cause }),
+                    ),
+                  );
+          },
+          { discard: true, concurrency: 4 },
+        ),
+    };
+  }),
+);
diff --git a/apps/server/src/orchestration-v2/RunExecutionService.test.ts b/apps/server/src/orchestration-v2/RunExecutionService.test.ts
new file mode 100644
index 000000000000..56fb8ce1a039
--- /dev/null
+++ b/apps/server/src/orchestration-v2/RunExecutionService.test.ts
@@ -0,0 +1,3263 @@
+import { assert, it, vi } from "@effect/vitest";
+import {
+  CheckpointScopeId,
+  CommandId,
+  EventId,
+  MessageId,
+  NodeId,
+  type OrchestrationV2AppThread,
+  type OrchestrationV2CheckpointScope,
+  type OrchestrationV2DomainEvent,
+  type OrchestrationV2ExecutionNode,
+  type OrchestrationV2ProviderThread,
+  type OrchestrationV2Run,
+  type OrchestrationV2RunAttempt,
+  type OrchestrationV2Subagent,
+  type OrchestrationV2TurnItem,
+  ProviderDriverKind,
+  ProviderInstanceId,
+  ProviderSessionId,
+  ProviderThreadId,
+  ProviderTurnId,
+  RunAttemptId,
+  RunId,
+  ThreadId,
+  TurnItemId,
+} from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Ref from "effect/Ref";
+import * as Stream from "effect/Stream";
+
+import * as McpSessionRegistry from "../mcp/McpSessionRegistry.ts";
+import { ServerSettingsService } from "../serverSettings.ts";
+import { CheckpointServiceV2 } from "./CheckpointService.ts";
+import { EventSinkV2 } from "./EventSink.ts";
+import { IdAllocatorV2, layer as idAllocatorLayer } from "./IdAllocator.ts";
+import type { ProviderAdapterV2Event, ProviderAdapterV2SessionRuntime } from "./ProviderAdapter.ts";
+import { ProviderEventIngestorV2 } from "./ProviderEventIngestor.ts";
+import {
+  canRouteRelatedSubagent,
+  cascadeTerminalizeRunOwnedSubagents,
+  finalProviderThreadStatus,
+  layer as runExecutionServiceLayer,
+  makeProviderEventRoutingState,
+  type ProviderEventRouteIdentity,
+  routeProviderEvent,
+  RunExecutionServiceV2,
+  selectInheritedBackgroundTurnItems,
+} from "./RunExecutionService.ts";
+
+const driver = ProviderDriverKind.make("codex");
+
+const RunExecutionTestLayer = runExecutionServiceLayer.pipe(
+  Layer.provide(
+    Layer.mergeAll(
+      Layer.mock(CheckpointServiceV2)({ captureBaseline: () => Effect.void }),
+      Layer.mock(EventSinkV2)({}),
+      idAllocatorLayer,
+      Layer.mock(ProviderEventIngestorV2)({ ingestNormalized: () => Effect.succeed([]) }),
+      ServerSettingsService.layerTest(),
+    ),
+  ),
+);
+
+it("keeps recoverable turn failures reusable and reserves error for broken threads", () => {
+  assert.equal(finalProviderThreadStatus("reusable"), "idle");
+  assert.equal(finalProviderThreadStatus("broken"), "error");
+});
+
+it.effect("routes shared-runtime events only to their owning root run", () =>
+  Effect.gen(function* () {
+    const now = yield* DateTime.now;
+    const first: ProviderEventRouteIdentity = {
+      threadId: ThreadId.make("thread:shared-runtime:first"),
+      runId: RunId.make("run:shared-runtime:first"),
+      attemptId: RunAttemptId.make("attempt:shared-runtime:first"),
+      providerThreadId: ProviderThreadId.make("provider-thread:shared-runtime:first"),
+    };
+    const second: ProviderEventRouteIdentity = {
+      threadId: ThreadId.make("thread:shared-runtime:second"),
+      runId: RunId.make("run:shared-runtime:second"),
+      attemptId: RunAttemptId.make("attempt:shared-runtime:second"),
+      providerThreadId: ProviderThreadId.make("provider-thread:shared-runtime:second"),
+    };
+    const firstTurnId = ProviderTurnId.make("provider-turn:shared-runtime:first");
+    const turnEvent: ProviderAdapterV2Event = {
+      type: "provider_turn.updated",
+      driver,
+      threadId: first.threadId,
+      providerTurn: {
+        id: firstTurnId,
+        providerThreadId: first.providerThreadId,
+        nodeId: NodeId.make("node:shared-runtime:first"),
+        runAttemptId: first.attemptId,
+        nativeTurnRef: null,
+        ordinal: 1,
+        status: "running",
+        startedAt: now,
+        completedAt: null,
+      },
+    };
+    const messageEvent: ProviderAdapterV2Event = {
+      type: "message.updated",
+      driver,
+      message: {
+        createdBy: "agent",
+        creationSource: "provider",
+        id: MessageId.make("message:shared-runtime:first"),
+        threadId: first.threadId,
+        runId: first.runId,
+        nodeId: NodeId.make("node:shared-runtime:first"),
+        role: "assistant",
+        text: "first only",
+        attachments: [],
+        streaming: false,
+        createdAt: now,
+        updatedAt: now,
+      },
+    };
+    const terminalEvent: ProviderAdapterV2Event = {
+      type: "turn.terminal",
+      driver,
+      providerThreadId: first.providerThreadId,
+      providerTurnId: firstTurnId,
+      runOrdinal: 1,
+      status: "completed",
+      failure: null,
+      threadDisposition: "reusable",
+    };
+
+    const firstInitial = makeProviderEventRoutingState({
+      identity: first,
+      providerTurnId: null,
+    });
+    const secondInitial = makeProviderEventRoutingState({
+      identity: second,
+      providerTurnId: null,
+    });
+    const [firstTurnAccepted, firstAfterTurn] = routeProviderEvent(turnEvent, first, firstInitial);
+    const [secondTurnAccepted, secondAfterTurn] = routeProviderEvent(
+      turnEvent,
+      second,
+      secondInitial,
+    );
+
+    assert.isTrue(firstTurnAccepted);
+    assert.isFalse(secondTurnAccepted);
+    assert.isTrue(routeProviderEvent(messageEvent, first, firstAfterTurn)[0]);
+    assert.isFalse(routeProviderEvent(messageEvent, second, secondAfterTurn)[0]);
+    assert.isTrue(routeProviderEvent(terminalEvent, first, firstAfterTurn)[0]);
+    assert.isFalse(routeProviderEvent(terminalEvent, second, secondAfterTurn)[0]);
+  }),
+);
+
+it("does not route a superseded attempt through a reused provider thread", () => {
+  const threadId = ThreadId.make("thread:shared-runtime:restart");
+  const providerThreadId = ProviderThreadId.make("provider-thread:shared-runtime:restart");
+  const oldAttempt: ProviderEventRouteIdentity = {
+    threadId,
+    runId: RunId.make("run:shared-runtime:restart"),
+    attemptId: RunAttemptId.make("attempt:shared-runtime:restart:old"),
+    providerThreadId,
+  };
+  const newAttempt: ProviderEventRouteIdentity = {
+    ...oldAttempt,
+    attemptId: RunAttemptId.make("attempt:shared-runtime:restart:new"),
+  };
+  const oldTurnEvent: ProviderAdapterV2Event = {
+    type: "provider_turn.updated",
+    driver,
+    threadId,
+    providerTurn: {
+      id: ProviderTurnId.make("provider-turn:shared-runtime:restart:old"),
+      providerThreadId,
+      nodeId: NodeId.make("node:shared-runtime:restart:old"),
+      runAttemptId: oldAttempt.attemptId,
+      nativeTurnRef: null,
+      ordinal: 1,
+      status: "interrupted",
+      startedAt: null,
+      completedAt: null,
+    },
+  };
+
+  const newState = makeProviderEventRoutingState({ identity: newAttempt, providerTurnId: null });
+  assert.isFalse(routeProviderEvent(oldTurnEvent, newAttempt, newState)[0]);
+});
+
+it("routes only exact same-thread background items inherited from settled runs", () => {
+  const threadId = ThreadId.make("thread:inherited-background-routing");
+  const otherThreadId = ThreadId.make("thread:inherited-background-routing:other");
+  const priorRunId = RunId.make("run:inherited-background-routing:prior");
+  const currentRunId = RunId.make("run:inherited-background-routing:current");
+  const itemId = TurnItemId.make("turn-item:inherited-background-routing");
+  const identity: ProviderEventRouteIdentity = {
+    threadId,
+    runId: currentRunId,
+    attemptId: RunAttemptId.make("attempt:inherited-background-routing:current"),
+    providerThreadId: ProviderThreadId.make("provider-thread:inherited-background-routing:current"),
+  };
+  const initial = makeProviderEventRoutingState({
+    identity,
+    inheritedBackgroundTurnItems: [{ id: itemId, runId: priorRunId }],
+    providerTurnId: null,
+  });
+  const inheritedRunning = {
+    type: "turn_item.updated",
+    driver,
+    turnItem: {
+      id: itemId,
+      threadId,
+      runId: priorRunId,
+      providerTurnId: null,
+      ordinal: 1,
+      type: "subagent",
+      status: "running",
+    },
+  } as Extract<ProviderAdapterV2Event, { type: "turn_item.updated" }>;
+  const unrelatedRunItem = {
+    ...inheritedRunning,
+    turnItem: {
+      ...inheritedRunning.turnItem,
+      runId: RunId.make("run:inherited-background-routing:unrelated"),
+    },
+  } as ProviderAdapterV2Event;
+  const unlistedPriorItem = {
+    ...inheritedRunning,
+    turnItem: {
+      ...inheritedRunning.turnItem,
+      id: TurnItemId.make("turn-item:inherited-background-routing:unrelated"),
+    },
+  } as ProviderAdapterV2Event;
+  const unrelatedThreadItem = {
+    ...inheritedRunning,
+    turnItem: { ...inheritedRunning.turnItem, threadId: otherThreadId },
+  } as ProviderAdapterV2Event;
+  const ordinaryItem = {
+    ...inheritedRunning,
+    turnItem: { ...inheritedRunning.turnItem, type: "reasoning" as const },
+  } as ProviderAdapterV2Event;
+  const inheritedTerminal = {
+    ...inheritedRunning,
+    turnItem: { ...inheritedRunning.turnItem, status: "completed" as const },
+  } as ProviderAdapterV2Event;
+
+  const [runningAccepted, afterRunning] = routeProviderEvent(inheritedRunning, identity, initial);
+  assert.isTrue(runningAccepted);
+  assert.isFalse(routeProviderEvent(unrelatedRunItem, identity, afterRunning)[0]);
+  assert.isFalse(routeProviderEvent(unlistedPriorItem, identity, afterRunning)[0]);
+  assert.isFalse(routeProviderEvent(unrelatedThreadItem, identity, afterRunning)[0]);
+  assert.isFalse(routeProviderEvent(ordinaryItem, identity, afterRunning)[0]);
+
+  const [terminalAccepted, afterTerminal] = routeProviderEvent(
+    inheritedTerminal,
+    identity,
+    afterRunning,
+  );
+  assert.isTrue(terminalAccepted);
+  assert.isFalse(
+    routeProviderEvent(inheritedRunning, identity, afterTerminal)[0],
+    "a nonterminal replay must not resurrect an inherited terminal",
+  );
+});
+
+it("selects only live background items from non-completed settled prior runs", () => {
+  const threadId = ThreadId.make("thread:inherited-background-selection");
+  const otherThreadId = ThreadId.make("thread:inherited-background-selection:other");
+  const currentProviderThreadId = ProviderThreadId.make(
+    "provider-thread:inherited-background-selection:current",
+  );
+  const foreignProviderThreadId = ProviderThreadId.make(
+    "provider-thread:inherited-background-selection:foreign-session",
+  );
+  const interruptedRunId = RunId.make("run:inherited-background-selection:interrupted");
+  const failedRunId = RunId.make("run:inherited-background-selection:failed");
+  const cancelledRunId = RunId.make("run:inherited-background-selection:cancelled");
+  const completedRunId = RunId.make("run:inherited-background-selection:completed");
+  const rolledBackRunId = RunId.make("run:inherited-background-selection:rolled-back");
+  const currentRunId = RunId.make("run:inherited-background-selection:current");
+  const inheritedItemId = TurnItemId.make("turn-item:inherited-background-selection:live");
+  const failedItemId = TurnItemId.make("turn-item:inherited-background-selection:failed");
+  const cancelledItemId = TurnItemId.make("turn-item:inherited-background-selection:cancelled");
+  const makeRun = (
+    id: RunId,
+    ordinal: number,
+    status: OrchestrationV2Run["status"],
+    runThreadId = threadId,
+  ) =>
+    ({
+      id,
+      threadId: runThreadId,
+      ordinal,
+      status,
+    }) as OrchestrationV2Run;
+  const makeItem = (
+    id: TurnItemId,
+    runId: RunId,
+    status: OrchestrationV2TurnItem["status"],
+    type: OrchestrationV2TurnItem["type"] = "subagent",
+    itemThreadId = threadId,
+    providerThreadId = currentProviderThreadId,
+  ) =>
+    ({
+      id,
+      threadId: itemThreadId,
+      runId,
+      providerThreadId,
+      type,
+      status,
+    }) as OrchestrationV2TurnItem;
+
+  const selected = selectInheritedBackgroundTurnItems({
+    threadId,
+    currentProviderThreadId,
+    currentRunOrdinal: 6,
+    runs: [
+      makeRun(interruptedRunId, 1, "interrupted"),
+      makeRun(failedRunId, 2, "failed"),
+      makeRun(cancelledRunId, 3, "cancelled"),
+      makeRun(completedRunId, 4, "completed"),
+      makeRun(rolledBackRunId, 5, "rolled_back"),
+      makeRun(currentRunId, 6, "running"),
+      makeRun(
+        RunId.make("run:inherited-background-selection:other"),
+        1,
+        "interrupted",
+        otherThreadId,
+      ),
+    ],
+    turnItems: [
+      makeItem(inheritedItemId, interruptedRunId, "running"),
+      makeItem(failedItemId, failedRunId, "running"),
+      makeItem(cancelledItemId, cancelledRunId, "running"),
+      makeItem(
+        TurnItemId.make("turn-item:inherited-background-selection:completed-run"),
+        completedRunId,
+        "running",
+      ),
+      makeItem(
+        TurnItemId.make("turn-item:inherited-background-selection:terminal"),
+        interruptedRunId,
+        "completed",
+      ),
+      makeItem(
+        TurnItemId.make("turn-item:inherited-background-selection:ordinary"),
+        interruptedRunId,
+        "running",
+        "reasoning",
+      ),
+      makeItem(
+        TurnItemId.make("turn-item:inherited-background-selection:rolled-back"),
+        rolledBackRunId,
+        "running",
+      ),
+      makeItem(
+        TurnItemId.make("turn-item:inherited-background-selection:other-thread"),
+        interruptedRunId,
+        "running",
+        "subagent",
+        otherThreadId,
+      ),
+      makeItem(
+        TurnItemId.make("turn-item:inherited-background-selection:foreign-provider"),
+        interruptedRunId,
+        "running",
+        "subagent",
+        threadId,
+        foreignProviderThreadId,
+      ),
+    ],
+  });
+
+  assert.deepEqual(selected, [
+    { id: inheritedItemId, runId: interruptedRunId },
+    { id: failedItemId, runId: failedRunId },
+    { id: cancelledItemId, runId: cancelledRunId },
+  ]);
+});
+
+it("does not carry interrupted child ownership into later attempts", () => {
+  assert.isFalse(canRouteRelatedSubagent("interrupted"));
+  assert.isFalse(canRouteRelatedSubagent("failed"));
+  assert.isFalse(canRouteRelatedSubagent("cancelled"));
+  assert.isTrue(canRouteRelatedSubagent("completed"));
+  assert.isTrue(canRouteRelatedSubagent("running"));
+
+  const threadId = ThreadId.make("thread:related-child:next-attempt");
+  const childThreadId = ThreadId.make("thread:related-child:interrupted");
+  const identity: ProviderEventRouteIdentity = {
+    threadId,
+    runId: RunId.make("run:related-child:next-attempt"),
+    attemptId: RunAttemptId.make("attempt:related-child:next-attempt"),
+    providerThreadId: ProviderThreadId.make("provider-thread:related-child:next-attempt"),
+  };
+  const state = makeProviderEventRoutingState({
+    identity,
+    providerTurnId: null,
+    relatedThreadIds: canRouteRelatedSubagent("interrupted") ? [childThreadId] : [],
+  });
+  const childNodeId = NodeId.make("node:related-child:interrupted");
+  const lateChildNode = {
+    type: "node.updated",
+    driver,
+    node: {
+      id: childNodeId,
+      threadId: childThreadId,
+      runId: null,
+      parentNodeId: null,
+      rootNodeId: childNodeId,
+      kind: "root_turn",
+      status: "completed",
+      countsForRun: false,
+      providerThreadId: null,
+      providerTurnId: null,
+      nativeItemRef: null,
+      runtimeRequestId: null,
+      checkpointScopeId: null,
+      startedAt: null,
+      completedAt: null,
+    },
+  } satisfies ProviderAdapterV2Event;
+
+  assert.isFalse(routeProviderEvent(lateChildNode, identity, state)[0]);
+});
+
+it.effect("rechecks run ownership immediately before calling the provider", () =>
+  Effect.gen(function* () {
+    const runExecution = yield* RunExecutionServiceV2;
+    const guardCalls = yield* Ref.make(0);
+    const providerStarts = yield* Ref.make(0);
+    const threadId = ThreadId.make("thread:run-execution-start-guard");
+    const runId = RunId.make("run:run-execution-start-guard");
+    const attemptId = RunAttemptId.make("attempt:run-execution-start-guard");
+    const providerThreadId = ProviderThreadId.make("provider-thread:run-execution-start-guard");
+    const providerInstanceId = ProviderInstanceId.make("codex");
+    const providerSessionId = ProviderSessionId.make("session:run-execution-start-guard");
+    const rootNodeId = NodeId.make("node:run-execution-start-guard");
+    const run = {
+      id: runId,
+      threadId,
+      ordinal: 1,
+      providerInstanceId,
+    } as OrchestrationV2Run;
+    const rootNode = { id: rootNodeId } as OrchestrationV2ExecutionNode;
+    const providerThread = {
+      id: providerThreadId,
+      driver,
+    } as OrchestrationV2ProviderThread;
+    const attempt = {
+      id: attemptId,
+      providerTurnId: null,
+    } as OrchestrationV2RunAttempt;
+    const session = {
+      events: Stream.never,
+      startTurn: () => Ref.update(providerStarts, (count) => count + 1),
+    } as unknown as ProviderAdapterV2SessionRuntime;
+
+    yield* runExecution.startRootRun({
+      commandId: CommandId.make("command:run-execution-start-guard"),
+      appThread: { id: threadId } as OrchestrationV2AppThread,
+      providerSessionId,
+      session,
+      run,
+      rootNode,
+      checkpointScope: {
+        id: CheckpointScopeId.make("checkpoint-scope:run-execution-start-guard"),
+      } as OrchestrationV2CheckpointScope,
+      providerThread,
+      attempt,
+      attemptId,
+      providerTurnOrdinal: 1,
+      shouldStartProviderTurn: () =>
+        Ref.modify(guardCalls, (calls) => [calls === 0, calls + 1] as const),
+      message: {
+        messageId: MessageId.make("message:run-execution-start-guard"),
+        text: "Do not start after ownership changes.",
+        attachments: [],
+        createdBy: "user",
+        creationSource: "web",
+      },
+      modelSelection: { instanceId: providerInstanceId, model: "gpt-5.4" },
+      runtimePolicy: {
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        cwd: process.cwd(),
+        approvalPolicy: "never",
+        sandboxPolicy: {
+          type: "readOnly",
+          access: { type: "fullAccess" },
+          networkAccess: false,
+        },
+      },
+    });
+
+    assert.equal(yield* Ref.get(guardCalls), 2);
+    assert.equal(yield* Ref.get(providerStarts), 0);
+  }).pipe(Effect.provide(RunExecutionTestLayer)),
+);
+
+it.effect("refreshes MCP credential liveness before calling the provider", () =>
+  Effect.gen(function* () {
+    const runExecution = yield* RunExecutionServiceV2;
+    const order = yield* Ref.make<ReadonlyArray<string>>([]);
+    const threadId = ThreadId.make("thread:run-execution-mcp-liveness");
+    const touchActiveMcpThread = vi
+      .spyOn(McpSessionRegistry, "touchActiveMcpThread")
+      .mockImplementation((touchedThreadId) =>
+        Ref.update(order, (entries) => [...entries, `touch:${touchedThreadId}`]),
+      );
+
+    yield* runExecution
+      .startRootRun({
+        commandId: CommandId.make("command:run-execution-mcp-liveness"),
+        appThread: { id: threadId } as OrchestrationV2AppThread,
+        providerSessionId: ProviderSessionId.make("session:run-execution-mcp-liveness"),
+        session: {
+          events: Stream.never,
+          startTurn: () => Ref.update(order, (entries) => [...entries, "start-turn"]),
+        } as unknown as ProviderAdapterV2SessionRuntime,
+        run: {
+          id: RunId.make("run:run-execution-mcp-liveness"),
+          threadId,
+          ordinal: 1,
+          providerInstanceId: ProviderInstanceId.make("codex"),
+        } as OrchestrationV2Run,
+        rootNode: {
+          id: NodeId.make("node:run-execution-mcp-liveness"),
+        } as OrchestrationV2ExecutionNode,
+        checkpointScope: {
+          id: CheckpointScopeId.make("checkpoint-scope:run-execution-mcp-liveness"),
+        } as OrchestrationV2CheckpointScope,
+        providerThread: {
+          id: ProviderThreadId.make("provider-thread:run-execution-mcp-liveness"),
+          driver,
+        } as OrchestrationV2ProviderThread,
+        attempt: {
+          id: RunAttemptId.make("attempt:run-execution-mcp-liveness"),
+          providerTurnId: null,
+        } as OrchestrationV2RunAttempt,
+        attemptId: RunAttemptId.make("attempt:run-execution-mcp-liveness"),
+        providerTurnOrdinal: 1,
+        message: {
+          messageId: MessageId.make("message:run-execution-mcp-liveness"),
+          text: "Keep the MCP credential alive.",
+          attachments: [],
+          createdBy: "user",
+          creationSource: "web",
+        },
+        modelSelection: {
+          instanceId: ProviderInstanceId.make("codex"),
+          model: "gpt-5.4",
+        },
+        runtimePolicy: {
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          cwd: process.cwd(),
+          approvalPolicy: "never",
+          sandboxPolicy: {
+            type: "readOnly",
+            access: { type: "fullAccess" },
+            networkAccess: false,
+          },
+        },
+      })
+      .pipe(Effect.ensuring(Effect.sync(() => touchActiveMcpThread.mockRestore())));
+
+    assert.deepEqual(yield* Ref.get(order), [`touch:${threadId}`, "start-turn"]);
+  }).pipe(Effect.provide(RunExecutionTestLayer)),
+);
+
+it.effect("keeps ingesting owned child events after the root turn terminalizes", () =>
+  Effect.gen(function* () {
+    const threadId = ThreadId.make("thread:run-execution-late-child");
+    const childThreadId = ThreadId.make("thread:run-execution-late-child:child");
+    const runId = RunId.make("run:run-execution-late-child");
+    const attemptId = RunAttemptId.make("attempt:run-execution-late-child");
+    const providerInstanceId = ProviderInstanceId.make("codex");
+    const providerSessionId = ProviderSessionId.make("session:run-execution-late-child");
+    const providerThreadId = ProviderThreadId.make("provider-thread:run-execution-late-child");
+    const childProviderThreadId = ProviderThreadId.make(
+      "provider-thread:run-execution-late-child:child",
+    );
+    const rootProviderTurnId = ProviderTurnId.make("provider-turn:run-execution-late-child");
+    const childProviderTurnId = ProviderTurnId.make("provider-turn:run-execution-late-child:child");
+    const rootNodeId = NodeId.make("node:run-execution-late-child");
+    const childNodeId = NodeId.make("node:run-execution-late-child:child");
+    const subagentNodeId = NodeId.make("node:run-execution-late-child:subagent");
+    const childMessageIngested = yield* Deferred.make<void>();
+    const order = yield* Ref.make<ReadonlyArray<string>>([]);
+    const testLayer = runExecutionServiceLayer.pipe(
+      Layer.provide(
+        Layer.mergeAll(
+          Layer.mock(CheckpointServiceV2)({ captureBaseline: () => Effect.void }),
+          Layer.mock(EventSinkV2)({
+            write: () => Effect.succeed([]),
+            writeWithEffects: (input) =>
+              Effect.gen(function* () {
+                if (
+                  input.events.some(
+                    (event) => event.type === "run.updated" && event.runId === runId,
+                  )
+                ) {
+                  yield* Ref.update(order, (current) => [...current, "root-finalized"]);
+                }
+                return [];
+              }),
+            writeIfRunCurrent: () => Effect.succeed({ committed: true, storedEvents: [] }),
+          }),
+          idAllocatorLayer,
+          Layer.mock(ProviderEventIngestorV2)({
+            ingestNormalized: (input) =>
+              Effect.gen(function* () {
+                if (
+                  input.event.type === "message.updated" &&
+                  input.event.message.threadId === childThreadId
+                ) {
+                  yield* Ref.update(order, (current) => [...current, "child-message"]);
+                  yield* Deferred.succeed(childMessageIngested, undefined).pipe(Effect.ignore);
+                }
+                return [];
+              }),
+          }),
+          ServerSettingsService.layerTest(),
+        ),
+      ),
+    );
+    const events: ReadonlyArray<ProviderAdapterV2Event> = [
+      {
+        type: "app_thread.created",
+        driver,
+        appThread: {
+          id: childThreadId,
+          lineage: {
+            parentThreadId: threadId,
+            relationshipToParent: "subagent",
+            rootThreadId: threadId,
+          },
+        },
+      } as ProviderAdapterV2Event,
+      {
+        type: "provider_thread.updated",
+        driver,
+        providerThread: {
+          id: childProviderThreadId,
+          appThreadId: childThreadId,
+        },
+      } as ProviderAdapterV2Event,
+      {
+        type: "subagent.updated",
+        driver,
+        subagent: {
+          id: subagentNodeId,
+          threadId,
+          runId,
+          status: "running",
+        },
+      } as ProviderAdapterV2Event,
+      {
+        type: "provider_turn.updated",
+        driver,
+        threadId: childThreadId,
+        providerTurn: {
+          id: childProviderTurnId,
+          providerThreadId: childProviderThreadId,
+          nodeId: childNodeId,
+          runAttemptId: null,
+          status: "running",
+        },
+      } as ProviderAdapterV2Event,
+      {
+        type: "turn.terminal",
+        driver,
+        providerThreadId,
+        providerTurnId: rootProviderTurnId,
+        runOrdinal: 1,
+        status: "completed",
+        failure: null,
+        threadDisposition: "reusable",
+      },
+      {
+        type: "message.updated",
+        driver,
+        message: {
+          id: MessageId.make("message:run-execution-late-child:child"),
+          threadId: childThreadId,
+          runId: null,
+          nodeId: childNodeId,
+          role: "assistant",
+          text: "Hello.",
+          streaming: false,
+        },
+      } as ProviderAdapterV2Event,
+      {
+        type: "provider_turn.updated",
+        driver,
+        threadId: childThreadId,
+        providerTurn: {
+          id: childProviderTurnId,
+          providerThreadId: childProviderThreadId,
+          nodeId: childNodeId,
+          runAttemptId: null,
+          status: "completed",
+        },
+      } as ProviderAdapterV2Event,
+      {
+        type: "subagent.updated",
+        driver,
+        subagent: {
+          id: subagentNodeId,
+          threadId,
+          runId,
+          status: "completed",
+        },
+      } as ProviderAdapterV2Event,
+    ];
+
+    yield* Effect.gen(function* () {
+      const runExecution = yield* RunExecutionServiceV2;
+      yield* runExecution.startRootRun({
+        commandId: CommandId.make("command:run-execution-late-child"),
+        appThread: { id: threadId } as OrchestrationV2AppThread,
+        providerSessionId,
+        session: {
+          events: Stream.fromIterable(events),
+          startTurn: () => Effect.void,
+        } as unknown as ProviderAdapterV2SessionRuntime,
+        run: {
+          id: runId,
+          threadId,
+          ordinal: 1,
+          providerInstanceId,
+        } as OrchestrationV2Run,
+        rootNode: { id: rootNodeId } as OrchestrationV2ExecutionNode,
+        checkpointScope: {
+          id: CheckpointScopeId.make("checkpoint-scope:run-execution-late-child"),
+        } as OrchestrationV2CheckpointScope,
+        providerThread: {
+          id: providerThreadId,
+          driver,
+        } as OrchestrationV2ProviderThread,
+        attempt: {
+          id: attemptId,
+          providerTurnId: rootProviderTurnId,
+        } as OrchestrationV2RunAttempt,
+        attemptId,
+        providerTurnOrdinal: 1,
+        message: {
+          messageId: MessageId.make("message:run-execution-late-child:user"),
+          text: "Spawn a child and finish.",
+          attachments: [],
+          createdBy: "user",
+          creationSource: "web",
+        },
+        modelSelection: { instanceId: providerInstanceId, model: "gpt-5.4" },
+        runtimePolicy: {
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          cwd: process.cwd(),
+          approvalPolicy: "never",
+          sandboxPolicy: {
+            type: "readOnly",
+            access: { type: "fullAccess" },
+            networkAccess: false,
+          },
+        },
+      });
+    }).pipe(Effect.provide(testLayer));
+
+    const observed = yield* Deferred.await(childMessageIngested).pipe(
+      Effect.timeoutOption("2 seconds"),
+    );
+    assert.isTrue(Option.isSome(observed), "child message was not ingested after root terminal");
+    assert.deepEqual(yield* Ref.get(order), ["root-finalized", "child-message"]);
+  }),
+);
+
+it.effect("keeps ingesting a late background command item completion after root terminal", () =>
+  Effect.gen(function* () {
+    const observed = yield* runBackgroundItemScenario("bg-command", (ids) => [
+      backgroundTurnItemEvent(ids, "command_execution", "running", 1),
+      rootTerminalEvent(ids, "completed"),
+      backgroundTurnItemEvent(ids, "command_execution", "completed", 2),
+    ]);
+    assert.deepEqual(observed, ["turn_item:running", "root-finalized", "turn_item:completed"]);
+  }),
+);
+
+it.effect("ingests the trailing subagent item completion after the subagent row completes", () =>
+  Effect.gen(function* () {
+    const observed = yield* runBackgroundItemScenario("subagent-trailing-item", (ids) => [
+      subagentEvent(ids, "running"),
+      backgroundTurnItemEvent(ids, "subagent", "running", 1),
+      rootTerminalEvent(ids, "completed"),
+      subagentEvent(ids, "completed"),
+      backgroundTurnItemEvent(ids, "subagent", "completed", 2),
+    ]);
+    assert.deepEqual(observed, [
+      "subagent:running",
+      "turn_item:running",
+      "root-finalized",
+      "subagent:completed",
+      "turn_item:completed",
+    ]);
+  }),
+);
+
+it.effect("keeps ingesting a child thread's late background item completion", () =>
+  Effect.gen(function* () {
+    const observed = yield* runBackgroundItemScenario("bg-child-item", (ids) => [
+      childThreadCreatedEvent(ids),
+      subagentEvent(ids, "running"),
+      childBackgroundTurnItemEvent(ids, "running", 1),
+      rootTerminalEvent(ids, "completed"),
+      subagentEvent(ids, "completed"),
+      childBackgroundTurnItemEvent(ids, "completed", 2),
+    ]);
+    assert.deepEqual(observed, [
+      "subagent:running",
+      "turn_item:running",
+      "root-finalized",
+      "subagent:completed",
+      "turn_item:completed",
+    ]);
+  }),
+);
+
+it.effect("keeps ingesting until the last of several background items terminalizes", () =>
+  Effect.gen(function* () {
+    const secondItemId = TurnItemId.make("turn-item:bg-multi:second");
+    const observed = yield* runBackgroundItemScenario("bg-multi", (ids) => [
+      backgroundTurnItemEvent(ids, "command_execution", "running", 1),
+      backgroundTurnItemEvent(ids, "dynamic_tool", "running", 2, secondItemId),
+      rootTerminalEvent(ids, "completed"),
+      backgroundTurnItemEvent(ids, "command_execution", "completed", 3),
+      backgroundTurnItemEvent(ids, "dynamic_tool", "completed", 4, secondItemId),
+    ]);
+    assert.deepEqual(observed, [
+      "turn_item:running",
+      "turn_item:running",
+      "root-finalized",
+      "turn_item:completed",
+      "turn_item:completed",
+    ]);
+  }),
+);
+
+it.effect("does not pin ingestion on background items when the root turn is interrupted", () =>
+  Effect.gen(function* () {
+    const observed = yield* runBackgroundItemScenario("bg-interrupted", (ids) => [
+      backgroundTurnItemEvent(ids, "command_execution", "running", 1),
+      rootTerminalEvent(ids, "interrupted"),
+      backgroundTurnItemEvent(ids, "command_execution", "completed", 2),
+    ]);
+    assert.deepEqual(observed, ["turn_item:running", "root-finalized"]);
+  }),
+);
+
+it.effect("seeds inherited background items before their next update", () =>
+  Effect.gen(function* () {
+    const key = "inherited-background-seeded";
+    const priorRunId = RunId.make(`run:${key}:prior`);
+    const observed = yield* runBackgroundItemScenario(
+      key,
+      (ids) => [
+        rootTerminalEvent(ids, "completed"),
+        backgroundTurnItemEventForRun(ids, priorRunId, "subagent", "completed", 1),
+      ],
+      {
+        loadInheritedBackgroundTurnItems: () =>
+          Effect.succeed([{ id: TurnItemId.make(`turn-item:${key}`), runId: priorRunId }]),
+      },
+    );
+
+    assert.deepEqual(observed, ["root-finalized", "turn_item:completed"]);
+  }),
+);
+
+it.effect("releases the live run after an inherited background item terminalizes", () =>
+  Effect.gen(function* () {
+    const key = "inherited-background-terminal";
+    const priorRunId = RunId.make(`run:${key}:prior`);
+    const observed = yield* runBackgroundItemScenario(
+      key,
+      (ids) => [
+        backgroundTurnItemEventForRun(ids, priorRunId, "subagent", "running", 1),
+        rootTerminalEvent(ids, "completed"),
+        backgroundTurnItemEventForRun(ids, priorRunId, "subagent", "completed", 2),
+      ],
+      {
+        loadInheritedBackgroundTurnItems: () =>
+          Effect.succeed([{ id: TurnItemId.make(`turn-item:${key}`), runId: priorRunId }]),
+      },
+    );
+
+    assert.deepEqual(observed, ["turn_item:running", "root-finalized", "turn_item:completed"]);
+  }),
+);
+
+it.effect("does not hold the live stream open for a foreign provider's background item", () =>
+  Effect.gen(function* () {
+    const key = "inherited-background-foreign-provider";
+    const ids = backgroundScenarioIds(key);
+    const priorRunId = RunId.make(`run:${key}:prior`);
+    const foreignProviderThreadId = ProviderThreadId.make(`provider-thread:${key}:foreign-session`);
+    const foreignItem = {
+      id: ids.itemId,
+      threadId: ids.threadId,
+      runId: priorRunId,
+      providerThreadId: foreignProviderThreadId,
+      type: "subagent",
+      status: "running",
+    } as OrchestrationV2TurnItem;
+    const inherited = selectInheritedBackgroundTurnItems({
+      threadId: ids.threadId,
+      currentProviderThreadId: ids.providerThreadId,
+      currentRunOrdinal: 2,
+      runs: [
+        {
+          id: priorRunId,
+          threadId: ids.threadId,
+          ordinal: 1,
+          status: "interrupted",
+        } as OrchestrationV2Run,
+      ],
+      turnItems: [foreignItem],
+    });
+
+    const observed = yield* runBackgroundItemScenario(
+      key,
+      (scenarioIds) => [rootTerminalEvent(scenarioIds, "completed")],
+      {
+        keepEventStreamOpen: true,
+        loadInheritedBackgroundTurnItems: () => Effect.succeed(inherited),
+      },
+    );
+
+    assert.deepEqual(inherited, []);
+    assert.deepEqual(observed, ["root-finalized"]);
+  }),
+);
+
+it.effect("refreshes inherited background items after event subscription", () =>
+  Effect.gen(function* () {
+    const key = "inherited-background-subscription-refresh";
+    const ids = backgroundScenarioIds(key);
+    const priorRunId = RunId.make(`run:${key}:prior`);
+    const itemStatus = yield* Ref.make<OrchestrationV2TurnItem["status"]>("running");
+    const loadInheritedBackgroundTurnItems = () =>
+      Ref.get(itemStatus).pipe(
+        Effect.map((status) =>
+          selectInheritedBackgroundTurnItems({
+            threadId: ids.threadId,
+            currentProviderThreadId: ids.providerThreadId,
+            currentRunOrdinal: 2,
+            runs: [
+              {
+                id: priorRunId,
+                threadId: ids.threadId,
+                ordinal: 1,
+                status: "interrupted",
+              } as OrchestrationV2Run,
+            ],
+            turnItems: [
+              {
+                id: ids.itemId,
+                threadId: ids.threadId,
+                runId: priorRunId,
+                providerThreadId: ids.providerThreadId,
+                type: "subagent",
+                status,
+              } as OrchestrationV2TurnItem,
+            ],
+          }),
+        ),
+      );
+
+    const observed = yield* runBackgroundItemScenario(
+      key,
+      (scenarioIds) => [rootTerminalEvent(scenarioIds, "completed")],
+      {
+        keepEventStreamOpen: true,
+        loadInheritedBackgroundTurnItems,
+        onSubscribe: Ref.set(itemStatus, "completed"),
+      },
+    );
+
+    assert.deepEqual(yield* loadInheritedBackgroundTurnItems(), []);
+    assert.deepEqual(observed, ["root-finalized"]);
+  }),
+);
+
+it.effect(
+  "keeps ingesting a late empty provider-thread roster while thread-scoped pending work is true",
+  () =>
+    Effect.gen(function* () {
+      const key = "bg-roster-pending-work";
+      const ids = backgroundScenarioIds(key);
+      const providerInstanceId = ProviderInstanceId.make("codex");
+      const now = yield* DateTime.now;
+      const observed = yield* Ref.make<ReadonlyArray<string>>([]);
+      const pendingByProviderThreadId = yield* Ref.make(new Map([[ids.providerThreadId, true]]));
+      const scopedProbeArgs = yield* Ref.make<ReadonlyArray<ProviderThreadId>>([]);
+      const ingestCalls = yield* Ref.make<
+        ReadonlyArray<{
+          readonly activeAttemptId: RunAttemptId | null;
+          readonly eventType: string;
+          readonly hasWriteIfRunCurrent: boolean;
+          readonly hasWriteIfProviderThreadOwner: boolean;
+          readonly expectedLastRunOrdinal: number | null;
+          readonly runId: RunId | null;
+          readonly rosterLength: number | null;
+        }>
+      >([]);
+      const ingestionDone = yield* Deferred.make<void>();
+      const testLayer = runExecutionServiceLayer.pipe(
+        Layer.provide(
+          Layer.mergeAll(
+            Layer.mock(CheckpointServiceV2)({ captureBaseline: () => Effect.void }),
+            Layer.mock(EventSinkV2)({
+              write: () => Effect.succeed([]),
+              writeWithEffects: (input) =>
+                Effect.gen(function* () {
+                  if (
+                    input.events.some(
+                      (event) => event.type === "run.updated" && event.runId === ids.runId,
+                    )
+                  ) {
+                    yield* Ref.update(observed, (current) => [...current, "root-finalized"]);
+                  }
+                  return [];
+                }),
+              writeIfRunCurrent: () => Effect.succeed({ committed: true, storedEvents: [] }),
+              writeIfProviderThreadOwner: () =>
+                Effect.succeed({ committed: true, storedEvents: [] }),
+            }),
+            idAllocatorLayer,
+            Layer.mock(ProviderEventIngestorV2)({
+              ingestNormalized: (input) =>
+                Effect.gen(function* () {
+                  const event = input.event;
+                  const rosterLength =
+                    event.type === "provider_thread.updated"
+                      ? (event.providerThread.pendingBackgroundTasks?.length ?? 0)
+                      : null;
+                  yield* Ref.update(ingestCalls, (current) => [
+                    ...current,
+                    {
+                      activeAttemptId: input.writeIfProviderThreadOwner?.activeAttemptId ?? null,
+                      eventType: event.type,
+                      hasWriteIfRunCurrent: input.writeIfRunCurrent !== undefined,
+                      hasWriteIfProviderThreadOwner: input.writeIfProviderThreadOwner !== undefined,
+                      expectedLastRunOrdinal:
+                        input.writeIfProviderThreadOwner?.expectedLastRunOrdinal ?? null,
+                      runId: input.writeIfProviderThreadOwner?.runId ?? null,
+                      rosterLength,
+                    },
+                  ]);
+                  if (event.type === "provider_thread.updated" && rosterLength === 0) {
+                    yield* Ref.update(pendingByProviderThreadId, (current) => {
+                      const next = new Map(current);
+                      next.set(event.providerThread.id, false);
+                      return next;
+                    });
+                    yield* Ref.update(observed, (current) => [...current, "roster-cleared"]);
+                  }
+                  if (event.type === "turn.terminal") {
+                    yield* Ref.update(observed, (current) => [...current, "terminal"]);
+                  }
+                  return [];
+                }),
+            }),
+            ServerSettingsService.layerTest(),
+          ),
+        ),
+      );
+
+      const providerThreadBase = {
+        id: ids.providerThreadId,
+        driver,
+        providerInstanceId,
+        providerSessionId: ProviderSessionId.make(`session:${key}`),
+        appThreadId: ids.threadId,
+        ownerNodeId: null,
+        nativeThreadRef: null,
+        nativeConversationHeadRef: null,
+        status: "idle" as const,
+        firstRunOrdinal: 1,
+        lastRunOrdinal: 1,
+        handoffIds: [],
+        forkedFrom: null,
+        createdAt: now,
+        updatedAt: now,
+      };
+
+      yield* Effect.gen(function* () {
+        const runExecution = yield* RunExecutionServiceV2;
+        yield* runExecution.startRootRun({
+          commandId: CommandId.make(`command:${key}`),
+          appThread: { id: ids.threadId } as OrchestrationV2AppThread,
+          providerSessionId: ProviderSessionId.make(`session:${key}`),
+          session: {
+            events: Stream.empty,
+            // Session-wide stays true forever; the root must consult the
+            // thread-scoped probe instead of being pinned by siblings.
+            hasPendingBackgroundWork: Effect.succeed(true),
+            hasPendingBackgroundWorkForThread: (providerThread: OrchestrationV2ProviderThread) =>
+              Effect.gen(function* () {
+                yield* Ref.update(scopedProbeArgs, (current) => [...current, providerThread.id]);
+                return (yield* Ref.get(pendingByProviderThreadId)).get(providerThread.id) === true;
+              }),
+            subscribeEvents: Effect.succeed({
+              events: Stream.fromIterable([
+                {
+                  type: "provider_thread.updated",
+                  driver,
+                  providerThread: {
+                    ...providerThreadBase,
+                    status: "active" as const,
+                    pendingBackgroundTasks: [
+                      { taskId: "bg-1", description: "sleep 20", taskType: "local_bash" },
+                    ],
+                    updatedAt: now,
+                  },
+                } as ProviderAdapterV2Event,
+                rootTerminalEvent(ids, "completed"),
+                {
+                  type: "provider_thread.updated",
+                  driver,
+                  providerThread: {
+                    ...providerThreadBase,
+                    status: "idle" as const,
+                    pendingBackgroundTasks: [],
+                    updatedAt: now,
+                  },
+                } as ProviderAdapterV2Event,
+              ]),
+              close: Deferred.succeed(ingestionDone, undefined),
+            }),
+            startTurn: () => Effect.void,
+          } as unknown as ProviderAdapterV2SessionRuntime,
+          run: {
+            id: ids.runId,
+            threadId: ids.threadId,
+            ordinal: 1,
+            providerInstanceId,
+          } as OrchestrationV2Run,
+          rootNode: { id: ids.rootNodeId } as OrchestrationV2ExecutionNode,
+          checkpointScope: {
+            id: CheckpointScopeId.make(`checkpoint-scope:${key}`),
+          } as OrchestrationV2CheckpointScope,
+          providerThread: providerThreadBase as OrchestrationV2ProviderThread,
+          attempt: {
+            id: ids.attemptId,
+            providerTurnId: ids.rootProviderTurnId,
+          } as OrchestrationV2RunAttempt,
+          attemptId: ids.attemptId,
+          providerTurnOrdinal: 1,
+          message: {
+            messageId: MessageId.make(`message:${key}:user`),
+            text: "Start background work and settle.",
+            attachments: [],
+            createdBy: "user",
+            creationSource: "web",
+          },
+          modelSelection: { instanceId: providerInstanceId, model: "gpt-5.4" },
+          runtimePolicy: {
+            runtimeMode: "full-access",
+            interactionMode: "default",
+            cwd: process.cwd(),
+            approvalPolicy: "never",
+            sandboxPolicy: {
+              type: "readOnly",
+              access: { type: "fullAccess" },
+              networkAccess: false,
+            },
+          },
+        });
+      }).pipe(Effect.provide(testLayer));
+
+      const closed = yield* Deferred.await(ingestionDone).pipe(Effect.timeoutOption("2 seconds"));
+      assert.isTrue(Option.isSome(closed), "event subscription did not release");
+      assert.deepEqual(yield* Ref.get(observed), ["terminal", "root-finalized", "roster-cleared"]);
+      assert.isTrue((yield* Ref.get(scopedProbeArgs)).includes(ids.providerThreadId));
+
+      const calls = yield* Ref.get(ingestCalls);
+      const preTerminalRoster = calls.find(
+        (call) => call.eventType === "provider_thread.updated" && call.rosterLength === 1,
+      );
+      const lateClear = calls.find(
+        (call) => call.eventType === "provider_thread.updated" && call.rosterLength === 0,
+      );
+      assert.isDefined(preTerminalRoster);
+      assert.isTrue(preTerminalRoster?.hasWriteIfRunCurrent);
+      assert.isFalse(preTerminalRoster?.hasWriteIfProviderThreadOwner);
+      assert.isDefined(lateClear);
+      assert.isFalse(
+        lateClear?.hasWriteIfRunCurrent,
+        "late empty roster must not use stale writeIfRunCurrent running-gate",
+      );
+      assert.isTrue(
+        lateClear?.hasWriteIfProviderThreadOwner,
+        "late empty roster must gate on provider-thread ownership",
+      );
+      assert.equal(lateClear?.expectedLastRunOrdinal, 1);
+      assert.equal(lateClear?.runId, ids.runId);
+      assert.equal(lateClear?.activeAttemptId, ids.attemptId);
+    }),
+);
+
+it.effect("drops late root provider-thread writes from a superseded attempt", () =>
+  Effect.gen(function* () {
+    const key = "bg-roster-attempt-owner-lost";
+    const ids = backgroundScenarioIds(key);
+    const replacementAttemptId = RunAttemptId.make(`attempt:${key}:replacement`);
+    const providerInstanceId = ProviderInstanceId.make("codex");
+    const now = yield* DateTime.now;
+    const observed = yield* Ref.make<ReadonlyArray<string>>([]);
+    // Probe stays true forever so only ownership-loss can release the stream.
+    const ingestionDone = yield* Deferred.make<void>();
+    const ingestCalls = yield* Ref.make<
+      ReadonlyArray<{
+        readonly activeAttemptId: RunAttemptId | null;
+        readonly eventType: string;
+        readonly hasWriteIfProviderThreadOwner: boolean;
+        readonly expectedLastRunOrdinal: number | null;
+        readonly rosterLength: number | null;
+        readonly committed: boolean;
+      }>
+    >([]);
+    const testLayer = runExecutionServiceLayer.pipe(
+      Layer.provide(
+        Layer.mergeAll(
+          Layer.mock(CheckpointServiceV2)({ captureBaseline: () => Effect.void }),
+          Layer.mock(EventSinkV2)({
+            write: () => Effect.succeed([]),
+            writeWithEffects: (input) =>
+              Effect.gen(function* () {
+                if (
+                  input.events.some(
+                    (event) => event.type === "run.updated" && event.runId === ids.runId,
+                  )
+                ) {
+                  yield* Ref.update(observed, (current) => [...current, "root-finalized"]);
+                }
+                return [];
+              }),
+            writeIfRunCurrent: () => Effect.succeed({ committed: true, storedEvents: [] }),
+            writeIfProviderThreadOwner: () =>
+              Effect.succeed({ committed: false, storedEvents: [] }),
+          }),
+          idAllocatorLayer,
+          Layer.mock(ProviderEventIngestorV2)({
+            ingestNormalized: (input) =>
+              Effect.gen(function* () {
+                const event = input.event;
+                const rosterLength =
+                  event.type === "provider_thread.updated"
+                    ? (event.providerThread.pendingBackgroundTasks?.length ?? 0)
+                    : null;
+                const ownerGate = input.writeIfProviderThreadOwner;
+                // Simulate the EventSink reject after a same-run replacement
+                // changes activeAttemptId without advancing lastRunOrdinal.
+                const rejectAsStaleOwner =
+                  ownerGate !== undefined && ownerGate.activeAttemptId !== replacementAttemptId;
+                yield* Ref.update(ingestCalls, (current) => [
+                  ...current,
+                  {
+                    activeAttemptId: ownerGate?.activeAttemptId ?? null,
+                    eventType: event.type,
+                    hasWriteIfProviderThreadOwner: ownerGate !== undefined,
+                    expectedLastRunOrdinal: ownerGate?.expectedLastRunOrdinal ?? null,
+                    rosterLength,
+                    committed: !rejectAsStaleOwner,
+                  },
+                ]);
+                if (event.type === "turn.terminal") {
+                  yield* Ref.update(observed, (current) => [...current, "terminal"]);
+                }
+                if (event.type === "provider_thread.updated" && rejectAsStaleOwner) {
+                  yield* Ref.update(observed, (current) => [...current, "stale-owner-rejected"]);
+                  return [];
+                }
+                if (event.type === "provider_thread.updated") {
+                  yield* Ref.update(observed, (current) => [...current, "roster-written"]);
+                }
+                return [];
+              }),
+          }),
+          ServerSettingsService.layerTest(),
+        ),
+      ),
+    );
+
+    const providerThreadBase = {
+      id: ids.providerThreadId,
+      driver,
+      providerInstanceId,
+      providerSessionId: ProviderSessionId.make(`session:${key}`),
+      appThreadId: ids.threadId,
+      ownerNodeId: null,
+      nativeThreadRef: null,
+      nativeConversationHeadRef: null,
+      status: "idle" as const,
+      firstRunOrdinal: 1,
+      lastRunOrdinal: 1,
+      handoffIds: [],
+      forkedFrom: null,
+      createdAt: now,
+      updatedAt: now,
+    };
+
+    yield* Effect.gen(function* () {
+      const runExecution = yield* RunExecutionServiceV2;
+      yield* runExecution.startRootRun({
+        commandId: CommandId.make(`command:${key}`),
+        appThread: { id: ids.threadId } as OrchestrationV2AppThread,
+        providerSessionId: ProviderSessionId.make(`session:${key}`),
+        session: {
+          events: Stream.empty,
+          hasPendingBackgroundWork: Effect.succeed(true),
+          hasPendingBackgroundWorkForThread: () => Effect.succeed(true),
+          subscribeEvents: Effect.succeed({
+            events: Stream.fromIterable([
+              {
+                type: "provider_thread.updated",
+                driver,
+                providerThread: {
+                  ...providerThreadBase,
+                  status: "active" as const,
+                  pendingBackgroundTasks: [
+                    { taskId: "bg-stale", description: "sleep 20", taskType: "local_bash" },
+                  ],
+                  updatedAt: now,
+                },
+              } as ProviderAdapterV2Event,
+              rootTerminalEvent(ids, "completed"),
+              // Late snapshot after a replacement attempt claimed the same
+              // run ordinal. Without attempt gating this would clobber it.
+              {
+                type: "provider_thread.updated",
+                driver,
+                providerThread: {
+                  ...providerThreadBase,
+                  status: "idle" as const,
+                  lastRunOrdinal: 1,
+                  pendingBackgroundTasks: [
+                    { taskId: "bg-stale", description: "sleep 20", taskType: "local_bash" },
+                  ],
+                  updatedAt: now,
+                },
+              } as ProviderAdapterV2Event,
+            ]),
+            close: Deferred.succeed(ingestionDone, undefined),
+          }),
+          startTurn: () => Effect.void,
+        } as unknown as ProviderAdapterV2SessionRuntime,
+        run: {
+          id: ids.runId,
+          threadId: ids.threadId,
+          ordinal: 1,
+          providerInstanceId,
+        } as OrchestrationV2Run,
+        rootNode: { id: ids.rootNodeId } as OrchestrationV2ExecutionNode,
+        checkpointScope: {
+          id: CheckpointScopeId.make(`checkpoint-scope:${key}`),
+        } as OrchestrationV2CheckpointScope,
+        providerThread: providerThreadBase as OrchestrationV2ProviderThread,
+        attempt: {
+          id: ids.attemptId,
+          providerTurnId: ids.rootProviderTurnId,
+        } as OrchestrationV2RunAttempt,
+        attemptId: ids.attemptId,
+        providerTurnOrdinal: 1,
+        message: {
+          messageId: MessageId.make(`message:${key}:user`),
+          text: "Background work that loses ownership.",
+          attachments: [],
+          createdBy: "user",
+          creationSource: "web",
+        },
+        modelSelection: { instanceId: providerInstanceId, model: "gpt-5.4" },
+        runtimePolicy: {
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          cwd: process.cwd(),
+          approvalPolicy: "never",
+          sandboxPolicy: {
+            type: "readOnly",
+            access: { type: "fullAccess" },
+            networkAccess: false,
+          },
+        },
+      });
+    }).pipe(Effect.provide(testLayer));
+
+    const closed = yield* Deferred.await(ingestionDone).pipe(Effect.timeoutOption("2 seconds"));
+    assert.isTrue(
+      Option.isSome(closed),
+      "subscription must release after ownership-loss reject even when probe stays true",
+    );
+    assert.deepEqual(yield* Ref.get(observed), [
+      "roster-written",
+      "terminal",
+      "root-finalized",
+      "stale-owner-rejected",
+    ]);
+
+    const calls = yield* Ref.get(ingestCalls);
+    const lateStale = calls.find(
+      (call) =>
+        call.eventType === "provider_thread.updated" &&
+        call.hasWriteIfProviderThreadOwner &&
+        call.rosterLength === 1,
+    );
+    assert.isDefined(lateStale);
+    assert.equal(lateStale?.expectedLastRunOrdinal, 1);
+    assert.equal(lateStale?.activeAttemptId, ids.attemptId);
+    assert.isFalse(lateStale?.committed);
+  }),
+);
+
+it.effect(
+  "keeps ingesting a late background turn-item completion after ownership-loss rejects roster writes",
+  () =>
+    Effect.gen(function* () {
+      const key = "bg-item-after-owner-lost";
+      const ids = backgroundScenarioIds(key);
+      const providerInstanceId = ProviderInstanceId.make("codex");
+      const now = yield* DateTime.now;
+      const observed = yield* Ref.make<ReadonlyArray<string>>([]);
+      // Probe stays true forever; open background items must pin the stream
+      // past ownership-loss so late turn_item completions still land.
+      const ingestionDone = yield* Deferred.make<void>();
+      const testLayer = runExecutionServiceLayer.pipe(
+        Layer.provide(
+          Layer.mergeAll(
+            Layer.mock(CheckpointServiceV2)({ captureBaseline: () => Effect.void }),
+            Layer.mock(EventSinkV2)({
+              write: () => Effect.succeed([]),
+              writeWithEffects: (input) =>
+                Effect.gen(function* () {
+                  if (
+                    input.events.some(
+                      (event) => event.type === "run.updated" && event.runId === ids.runId,
+                    )
+                  ) {
+                    yield* Ref.update(observed, (current) => [...current, "root-finalized"]);
+                  }
+                  return [];
+                }),
+              writeIfRunCurrent: () => Effect.succeed({ committed: true, storedEvents: [] }),
+              writeIfProviderThreadOwner: () =>
+                Effect.succeed({ committed: false, storedEvents: [] }),
+            }),
+            idAllocatorLayer,
+            Layer.mock(ProviderEventIngestorV2)({
+              ingestNormalized: (input) =>
+                Effect.gen(function* () {
+                  const event = input.event;
+                  if (event.type === "turn.terminal") {
+                    yield* Ref.update(observed, (current) => [...current, "terminal"]);
+                  }
+                  if (
+                    event.type === "provider_thread.updated" &&
+                    input.writeIfProviderThreadOwner !== undefined
+                  ) {
+                    yield* Ref.update(observed, (current) => [...current, "stale-owner-rejected"]);
+                    return [];
+                  }
+                  if (event.type === "turn_item.updated") {
+                    yield* Ref.update(observed, (current) => [
+                      ...current,
+                      `turn_item:${event.turnItem.status}`,
+                    ]);
+                  }
+                  return [];
+                }),
+            }),
+            ServerSettingsService.layerTest(),
+          ),
+        ),
+      );
+
+      const providerThreadBase = {
+        id: ids.providerThreadId,
+        driver,
+        providerInstanceId,
+        providerSessionId: ProviderSessionId.make(`session:${key}`),
+        appThreadId: ids.threadId,
+        ownerNodeId: null,
+        nativeThreadRef: null,
+        nativeConversationHeadRef: null,
+        status: "idle" as const,
+        firstRunOrdinal: 1,
+        lastRunOrdinal: 1,
+        handoffIds: [],
+        forkedFrom: null,
+        createdAt: now,
+        updatedAt: now,
+      };
+
+      yield* Effect.gen(function* () {
+        const runExecution = yield* RunExecutionServiceV2;
+        yield* runExecution.startRootRun({
+          commandId: CommandId.make(`command:${key}`),
+          appThread: { id: ids.threadId } as OrchestrationV2AppThread,
+          providerSessionId: ProviderSessionId.make(`session:${key}`),
+          session: {
+            events: Stream.empty,
+            hasPendingBackgroundWork: Effect.succeed(true),
+            hasPendingBackgroundWorkForThread: () => Effect.succeed(true),
+            subscribeEvents: Effect.succeed({
+              events: Stream.fromIterable([
+                backgroundTurnItemEvent(ids, "command_execution", "running", 1),
+                rootTerminalEvent(ids, "completed"),
+                // Ownership reject after a newer run claimed lastRunOrdinal.
+                {
+                  type: "provider_thread.updated",
+                  driver,
+                  providerThread: {
+                    ...providerThreadBase,
+                    status: "idle" as const,
+                    lastRunOrdinal: 1,
+                    pendingBackgroundTasks: [
+                      { taskId: "bg-stale", description: "sleep 20", taskType: "local_bash" },
+                    ],
+                    updatedAt: now,
+                  },
+                } as ProviderAdapterV2Event,
+                // Late completion still writable (turn_item writes are not
+                // ownership-gated); stream must stay open for it.
+                backgroundTurnItemEvent(ids, "command_execution", "completed", 2),
+              ]),
+              close: Deferred.succeed(ingestionDone, undefined),
+            }),
+            startTurn: () => Effect.void,
+          } as unknown as ProviderAdapterV2SessionRuntime,
+          run: {
+            id: ids.runId,
+            threadId: ids.threadId,
+            ordinal: 1,
+            providerInstanceId,
+          } as OrchestrationV2Run,
+          rootNode: { id: ids.rootNodeId } as OrchestrationV2ExecutionNode,
+          checkpointScope: {
+            id: CheckpointScopeId.make(`checkpoint-scope:${key}`),
+          } as OrchestrationV2CheckpointScope,
+          providerThread: providerThreadBase as OrchestrationV2ProviderThread,
+          attempt: {
+            id: ids.attemptId,
+            providerTurnId: ids.rootProviderTurnId,
+          } as OrchestrationV2RunAttempt,
+          attemptId: ids.attemptId,
+          providerTurnOrdinal: 1,
+          message: {
+            messageId: MessageId.make(`message:${key}:user`),
+            text: "Background item after ownership loss.",
+            attachments: [],
+            createdBy: "user",
+            creationSource: "web",
+          },
+          modelSelection: { instanceId: providerInstanceId, model: "gpt-5.4" },
+          runtimePolicy: {
+            runtimeMode: "full-access",
+            interactionMode: "default",
+            cwd: process.cwd(),
+            approvalPolicy: "never",
+            sandboxPolicy: {
+              type: "readOnly",
+              access: { type: "fullAccess" },
+              networkAccess: false,
+            },
+          },
+        });
+      }).pipe(Effect.provide(testLayer));
+
+      const closed = yield* Deferred.await(ingestionDone).pipe(Effect.timeoutOption("2 seconds"));
+      assert.isTrue(
+        Option.isSome(closed),
+        "subscription must release after background item completes past ownership loss",
+      );
+      assert.deepEqual(yield* Ref.get(observed), [
+        "turn_item:running",
+        "terminal",
+        "root-finalized",
+        "stale-owner-rejected",
+        "turn_item:completed",
+      ]);
+    }),
+);
+
+it.effect(
+  "does not pin ingestion on a sibling session-wide pending state when this thread has no roster",
+  () =>
+    Effect.gen(function* () {
+      const key = "bg-roster-sibling-not-pin";
+      const ids = backgroundScenarioIds(key);
+      const providerInstanceId = ProviderInstanceId.make("codex");
+      const now = yield* DateTime.now;
+      const observed = yield* Ref.make<ReadonlyArray<string>>([]);
+      const ingestionDone = yield* Deferred.make<void>();
+      const scopedProbeArgs = yield* Ref.make<ReadonlyArray<ProviderThreadId>>([]);
+      const testLayer = runExecutionServiceLayer.pipe(
+        Layer.provide(
+          Layer.mergeAll(
+            Layer.mock(CheckpointServiceV2)({ captureBaseline: () => Effect.void }),
+            Layer.mock(EventSinkV2)({
+              write: () => Effect.succeed([]),
+              writeWithEffects: (input) =>
+                Effect.gen(function* () {
+                  if (
+                    input.events.some(
+                      (event) => event.type === "run.updated" && event.runId === ids.runId,
+                    )
+                  ) {
+                    yield* Ref.update(observed, (current) => [...current, "root-finalized"]);
+                  }
+                  return [];
+                }),
+              writeIfRunCurrent: () => Effect.succeed({ committed: true, storedEvents: [] }),
+            }),
+            idAllocatorLayer,
+            Layer.mock(ProviderEventIngestorV2)({
+              ingestNormalized: (input) =>
+                Effect.gen(function* () {
+                  if (input.event.type === "turn.terminal") {
+                    yield* Ref.update(observed, (current) => [...current, "terminal"]);
+                  }
+                  return [];
+                }),
+            }),
+            ServerSettingsService.layerTest(),
+          ),
+        ),
+      );
+
+      const providerThreadBase = {
+        id: ids.providerThreadId,
+        driver,
+        providerInstanceId,
+        providerSessionId: ProviderSessionId.make(`session:${key}`),
+        appThreadId: ids.threadId,
+        ownerNodeId: null,
+        nativeThreadRef: {
+          driver,
+          nativeId: "native-self",
+          strength: "strong" as const,
+        },
+        nativeConversationHeadRef: null,
+        status: "idle" as const,
+        firstRunOrdinal: 1,
+        lastRunOrdinal: 1,
+        handoffIds: [],
+        forkedFrom: null,
+        createdAt: now,
+        updatedAt: now,
+      };
+      const siblingProviderThreadId = ProviderThreadId.make(`provider-thread:${key}:sibling`);
+
+      yield* Effect.gen(function* () {
+        const runExecution = yield* RunExecutionServiceV2;
+        yield* runExecution.startRootRun({
+          commandId: CommandId.make(`command:${key}`),
+          appThread: { id: ids.threadId } as OrchestrationV2AppThread,
+          providerSessionId: ProviderSessionId.make(`session:${key}`),
+          session: {
+            events: Stream.empty,
+            // Session-wide stays true (sibling has work). Stop must use only
+            // the scoped probe for this root's provider thread.
+            hasPendingBackgroundWork: Effect.succeed(true),
+            hasPendingBackgroundWorkForThread: (providerThread: OrchestrationV2ProviderThread) =>
+              Effect.gen(function* () {
+                yield* Ref.update(scopedProbeArgs, (current) => [...current, providerThread.id]);
+                // Own thread has no roster; sibling would report true if probed.
+                return providerThread.id !== ids.providerThreadId;
+              }),
+            subscribeEvents: Effect.succeed({
+              events: Stream.fromIterable([
+                rootTerminalEvent(ids, "completed"),
+                // Sibling thread update after terminal. Own-thread scoped
+                // pending is false, so this root must release without waiting
+                // for sibling-driven session-wide pending work.
+                {
+                  type: "provider_thread.updated",
+                  driver,
+                  providerThread: {
+                    ...providerThreadBase,
+                    id: siblingProviderThreadId,
+                    appThreadId: ThreadId.make(`thread:${key}:sibling`),
+                    nativeThreadRef: {
+                      driver,
+                      nativeId: "native-sibling",
+                      strength: "strong" as const,
+                    },
+                    pendingBackgroundTasks: [{ taskId: "sibling-bg", description: "other thread" }],
+                    updatedAt: now,
+                  },
+                } as ProviderAdapterV2Event,
+              ]),
+              close: Deferred.succeed(ingestionDone, undefined),
+            }),
+            startTurn: () => Effect.void,
+          } as unknown as ProviderAdapterV2SessionRuntime,
+          run: {
+            id: ids.runId,
+            threadId: ids.threadId,
+            ordinal: 1,
+            providerInstanceId,
+          } as OrchestrationV2Run,
+          rootNode: { id: ids.rootNodeId } as OrchestrationV2ExecutionNode,
+          checkpointScope: {
+            id: CheckpointScopeId.make(`checkpoint-scope:${key}`),
+          } as OrchestrationV2CheckpointScope,
+          providerThread: providerThreadBase as OrchestrationV2ProviderThread,
+          attempt: {
+            id: ids.attemptId,
+            providerTurnId: ids.rootProviderTurnId,
+          } as OrchestrationV2RunAttempt,
+          attemptId: ids.attemptId,
+          providerTurnOrdinal: 1,
+          message: {
+            messageId: MessageId.make(`message:${key}:user`),
+            text: "Settle without local pending work.",
+            attachments: [],
+            createdBy: "user",
+            creationSource: "web",
+          },
+          modelSelection: { instanceId: providerInstanceId, model: "gpt-5.4" },
+          runtimePolicy: {
+            runtimeMode: "full-access",
+            interactionMode: "default",
+            cwd: process.cwd(),
+            approvalPolicy: "never",
+            sandboxPolicy: {
+              type: "readOnly",
+              access: { type: "fullAccess" },
+              networkAccess: false,
+            },
+          },
+        });
+      }).pipe(Effect.provide(testLayer));
+
+      const closed = yield* Deferred.await(ingestionDone).pipe(Effect.timeoutOption("2 seconds"));
+      assert.isTrue(Option.isSome(closed), "event subscription did not release");
+      // Critical: release while session-wide hasPendingBackgroundWork stays true
+      // and the scoped probe reports false for this root's provider thread.
+      const observedEvents = [...(yield* Ref.get(observed))];
+      assert.includeMembers(observedEvents, ["terminal", "root-finalized"]);
+      const probedIds = yield* Ref.get(scopedProbeArgs);
+      assert.isTrue(probedIds.includes(ids.providerThreadId));
+      assert.isFalse(probedIds.includes(siblingProviderThreadId));
+    }),
+);
+
+it.effect(
+  "cascade-terminalizes run-owned subagent rows on interrupt before root finalization",
+  () =>
+    Effect.gen(function* () {
+      const ids = backgroundScenarioIds("subagent-interrupt-cascade");
+      const childThreadId = ids.childThreadId;
+      const unrelatedChildThreadId = ThreadId.make(
+        "thread:subagent-interrupt-cascade:unrelated-child",
+      );
+      const providerInstanceId = ProviderInstanceId.make("codex");
+      const written = yield* Ref.make<ReadonlyArray<OrchestrationV2DomainEvent>>([]);
+      const ingested = yield* Ref.make<ReadonlyArray<ProviderAdapterV2Event>>([]);
+      const ingestionDone = yield* Deferred.make<void>();
+      const testLayer = runExecutionServiceLayer.pipe(
+        Layer.provide(
+          Layer.mergeAll(
+            Layer.mock(CheckpointServiceV2)({ captureBaseline: () => Effect.void }),
+            Layer.mock(EventSinkV2)({
+              write: () => Effect.succeed([]),
+              writeWithEffects: (input) =>
+                Effect.gen(function* () {
+                  yield* Ref.update(written, (current) => [...current, ...input.events]);
+                  return [];
+                }),
+              writeIfRunCurrent: () => Effect.succeed({ committed: true, storedEvents: [] }),
+            }),
+            idAllocatorLayer,
+            Layer.mock(ProviderEventIngestorV2)({
+              ingestNormalized: (input) =>
+                Ref.update(ingested, (current) => [...current, input.event]).pipe(Effect.as([])),
+            }),
+            ServerSettingsService.layerTest(),
+          ),
+        ),
+      );
+
+      const runningSubagent = makeRunOwnedSubagentFixture({
+        ids,
+        providerInstanceId,
+        childThreadId,
+        driver,
+        status: "running",
+      });
+      const runningTurnItem = makeRunOwnedSubagentTurnItemFixture({
+        ids,
+        providerInstanceId,
+        childThreadId,
+        driver,
+        status: "running",
+      });
+      const runningNode = makeRunOwnedSubagentNodeFixture({
+        ids,
+        status: "running",
+      });
+      const runningChildNode = makeRunOwnedSubagentChildNodeFixture({
+        ids,
+        status: "running",
+      });
+      const runningChildTurnItem = makeLinkedChildTurnItemFixture({
+        ids,
+        driver,
+        type: "command_execution",
+      });
+      const suppressedChildAssistantTurnItem = makeLinkedChildTurnItemFixture({
+        ids: {
+          ...ids,
+          childItemId: TurnItemId.make("turn-item:subagent-interrupt-cascade:suppressed-assistant"),
+        },
+        driver,
+        type: "assistant_message",
+      });
+      const unrelatedChildNode = {
+        ...runningChildNode,
+        id: NodeId.make("node:subagent-interrupt-cascade:unrelated-child"),
+        threadId: unrelatedChildThreadId,
+        runId: ids.runId,
+        rootNodeId: NodeId.make("node:subagent-interrupt-cascade:unrelated-child"),
+      };
+      const unrelatedChildTurnItem = {
+        ...runningChildTurnItem,
+        id: TurnItemId.make("turn-item:subagent-interrupt-cascade:unrelated-child"),
+        threadId: unrelatedChildThreadId,
+        nodeId: unrelatedChildNode.id,
+      };
+
+      yield* Effect.gen(function* () {
+        const runExecution = yield* RunExecutionServiceV2;
+        yield* runExecution.startRootRun({
+          commandId: CommandId.make("command:subagent-interrupt-cascade"),
+          appThread: { id: ids.threadId } as OrchestrationV2AppThread,
+          providerSessionId: ProviderSessionId.make("session:subagent-interrupt-cascade"),
+          session: {
+            events: Stream.empty,
+            subscribeEvents: Effect.succeed({
+              events: Stream.fromIterable([
+                childThreadCreatedEvent(ids),
+                {
+                  type: "subagent.updated",
+                  driver,
+                  subagent: runningSubagent,
+                },
+                {
+                  type: "node.updated",
+                  driver,
+                  node: runningNode,
+                },
+                {
+                  type: "node.updated",
+                  driver,
+                  node: runningChildNode,
+                },
+                {
+                  type: "node.updated",
+                  driver,
+                  node: unrelatedChildNode,
+                },
+                {
+                  type: "turn_item.updated",
+                  driver,
+                  turnItem: runningTurnItem,
+                },
+                {
+                  type: "turn_item.updated",
+                  driver,
+                  turnItem: runningChildTurnItem,
+                },
+                {
+                  type: "turn_item.updated",
+                  driver,
+                  turnItem: suppressedChildAssistantTurnItem,
+                },
+                {
+                  type: "turn_item.updated",
+                  driver,
+                  turnItem: unrelatedChildTurnItem,
+                },
+                rootTerminalEvent(ids, "interrupted"),
+                // Late provider completion after interrupt must not be ingested.
+                {
+                  type: "subagent.updated",
+                  driver,
+                  subagent: {
+                    ...runningSubagent,
+                    status: "completed" as const,
+                    result: "should-not-apply",
+                    completedAt: runningSubagent.updatedAt,
+                  },
+                },
+                {
+                  type: "turn_item.updated",
+                  driver,
+                  turnItem: {
+                    ...runningTurnItem,
+                    status: "completed" as const,
+                    result: "should-not-apply",
+                    completedAt: runningTurnItem.updatedAt,
+                    updatedAt: runningTurnItem.updatedAt,
+                  },
+                },
+                {
+                  type: "turn_item.updated",
+                  driver,
+                  turnItem: {
+                    ...runningChildTurnItem,
+                    status: "completed" as const,
+                    completedAt: runningChildTurnItem.updatedAt,
+                    updatedAt: runningChildTurnItem.updatedAt,
+                  },
+                },
+                {
+                  type: "node.updated",
+                  driver,
+                  node: {
+                    ...runningChildNode,
+                    status: "completed" as const,
+                    completedAt: runningChildNode.startedAt,
+                  },
+                },
+              ] satisfies ReadonlyArray<ProviderAdapterV2Event>),
+              close: Deferred.succeed(ingestionDone, undefined),
+            }),
+            startTurn: () => Effect.void,
+          } as unknown as ProviderAdapterV2SessionRuntime,
+          run: {
+            id: ids.runId,
+            threadId: ids.threadId,
+            ordinal: 1,
+            providerInstanceId,
+          } as OrchestrationV2Run,
+          rootNode: { id: ids.rootNodeId } as OrchestrationV2ExecutionNode,
+          checkpointScope: {
+            id: CheckpointScopeId.make("checkpoint-scope:subagent-interrupt-cascade"),
+          } as OrchestrationV2CheckpointScope,
+          providerThread: {
+            id: ids.providerThreadId,
+            driver,
+          } as OrchestrationV2ProviderThread,
+          attempt: {
+            id: ids.attemptId,
+            providerTurnId: ids.rootProviderTurnId,
+          } as OrchestrationV2RunAttempt,
+          attemptId: ids.attemptId,
+          relatedThreadIds: [unrelatedChildThreadId],
+          providerTurnOrdinal: 1,
+          message: {
+            messageId: MessageId.make("message:subagent-interrupt-cascade:user"),
+            text: "Spawn a subagent then stop.",
+            attachments: [],
+            createdBy: "user",
+            creationSource: "web",
+          },
+          modelSelection: { instanceId: providerInstanceId, model: "gpt-5.4" },
+          runtimePolicy: {
+            runtimeMode: "full-access",
+            interactionMode: "default",
+            cwd: process.cwd(),
+            approvalPolicy: "never",
+            sandboxPolicy: {
+              type: "readOnly",
+              access: { type: "fullAccess" },
+              networkAccess: false,
+            },
+          },
+        });
+      }).pipe(Effect.provide(testLayer));
+
+      const closed = yield* Deferred.await(ingestionDone).pipe(Effect.timeoutOption("2 seconds"));
+      assert.isTrue(Option.isSome(closed), "event ingestion fiber did not finish");
+
+      const events = yield* Ref.get(written);
+      const subagentEvents = events.flatMap((event) =>
+        event.type === "subagent.updated" ? [event] : [],
+      );
+      const turnItemEvents = events.flatMap((event) => {
+        if (event.type !== "turn-item.updated" || event.payload.type !== "subagent") {
+          return [];
+        }
+        return [
+          {
+            ...event,
+            payload: event.payload,
+          },
+        ];
+      });
+      const nodeEvents = events.flatMap((event) =>
+        event.type === "node.updated" &&
+        event.payload.status === "interrupted" &&
+        (event.payload.id === runningNode.id || event.payload.id === runningChildNode.id)
+          ? [event]
+          : [],
+      );
+      const runUpdatedIndex = events.findIndex((event) => event.type === "run.updated");
+      assert.isAtLeast(runUpdatedIndex, 0, "root run.updated must be written");
+
+      assert.lengthOf(subagentEvents, 1);
+      const terminalSubagent = subagentEvents[0];
+      assert.isDefined(terminalSubagent);
+      assert.equal(terminalSubagent.payload.status, "interrupted");
+      assert.equal(terminalSubagent.payload.childThreadId, childThreadId);
+      assert.equal(terminalSubagent.payload.result, null);
+      assert.isNotNull(terminalSubagent.payload.completedAt);
+
+      assert.lengthOf(turnItemEvents, 1);
+      const terminalTurnItem = turnItemEvents[0];
+      assert.isDefined(terminalTurnItem);
+      assert.equal(terminalTurnItem.payload.status, "interrupted");
+      assert.equal(terminalTurnItem.payload.childThreadId, childThreadId);
+      assert.equal(terminalTurnItem.payload.result, null);
+
+      const terminalChildTurnItems = events.flatMap((event) =>
+        event.type === "turn-item.updated" &&
+        event.payload.id === runningChildTurnItem.id &&
+        event.payload.status === "interrupted"
+          ? [event]
+          : [],
+      );
+      assert.lengthOf(terminalChildTurnItems, 1);
+      const terminalChildTurnItem = terminalChildTurnItems[0];
+      assert.isDefined(terminalChildTurnItem);
+      assert.equal(terminalChildTurnItem.threadId, childThreadId);
+      assert.equal(terminalChildTurnItem.payload.threadId, childThreadId);
+      assert.equal(terminalChildTurnItem.payload.runId, null);
+      assert.equal(terminalChildTurnItem.payload.type, "command_execution");
+      assert.isFalse(
+        events.some(
+          (event) =>
+            event.type === "turn-item.updated" &&
+            event.payload.id === unrelatedChildTurnItem.id &&
+            event.payload.status === "interrupted",
+        ),
+        "related but unlinked child turn items must not cascade",
+      );
+      assert.isFalse(
+        events.some(
+          (event) =>
+            event.type === "turn-item.updated" &&
+            event.payload.id === suppressedChildAssistantTurnItem.id,
+        ),
+        "suppressed streaming child items must not be created by the cascade",
+      );
+
+      assert.lengthOf(nodeEvents, 2);
+      assert.isTrue(
+        nodeEvents.some(
+          (event) => event.payload.id === runningNode.id && event.payload.kind === "subagent",
+        ),
+      );
+      assert.isFalse(
+        events.some(
+          (event) =>
+            event.type === "node.updated" &&
+            event.payload.id === unrelatedChildNode.id &&
+            event.payload.status === "interrupted",
+        ),
+        "owned child threads without a live run-owned subagent link must not cascade",
+      );
+      assert.isTrue(
+        nodeEvents.some(
+          (event) =>
+            event.payload.id === runningChildNode.id &&
+            event.runId === (runningChildNode.runId ?? ids.runId) &&
+            event.payload.threadId === childThreadId &&
+            event.payload.kind === "root_turn",
+        ),
+      );
+
+      const cascadeIndexes = events.flatMap((event, index) => {
+        if (event.type === "subagent.updated" && event.payload.status === "interrupted") {
+          return [index];
+        }
+        if (
+          event.type === "turn-item.updated" &&
+          event.payload.status === "interrupted" &&
+          (event.payload.type === "subagent" || event.payload.id === runningChildTurnItem.id)
+        ) {
+          return [index];
+        }
+        if (event.type === "node.updated" && event.payload.status === "interrupted") {
+          return event.payload.id === runningNode.id || event.payload.id === runningChildNode.id
+            ? [index]
+            : [];
+        }
+        return [];
+      });
+      assert.isTrue(
+        cascadeIndexes.every((index) => index < runUpdatedIndex),
+        "subagent cascade must precede run.updated",
+      );
+      assert.isFalse(
+        events.some((event) => {
+          if (event.type === "subagent.updated") {
+            return event.payload.status === "completed";
+          }
+          if (event.type === "turn-item.updated" && event.payload.type === "subagent") {
+            return event.payload.status === "completed";
+          }
+          return false;
+        }),
+        "late provider completion must not reopen cascaded subagent rows",
+      );
+      assert.isFalse(
+        (yield* Ref.get(ingested)).some(
+          (event) =>
+            (event.type === "subagent.updated" && event.subagent.status === "completed") ||
+            (event.type === "turn_item.updated" && event.turnItem.status === "completed") ||
+            (event.type === "node.updated" && event.node.status === "completed"),
+        ),
+        "late provider completion must not be ingested after interrupt",
+      );
+    }),
+);
+
+it.effect(
+  "cascades linked child-thread nodes after run-owned subagent and turn-item terminalize",
+  () =>
+    Effect.gen(function* () {
+      const ids = backgroundScenarioIds("subagent-link-survives-terminal");
+      const childThreadId = ids.childThreadId;
+      const unrelatedChildThreadId = ThreadId.make(
+        "thread:subagent-link-survives-terminal:unrelated-child",
+      );
+      const providerInstanceId = ProviderInstanceId.make("codex");
+      const written = yield* Ref.make<ReadonlyArray<OrchestrationV2DomainEvent>>([]);
+      const ingestionDone = yield* Deferred.make<void>();
+      const testLayer = runExecutionServiceLayer.pipe(
+        Layer.provide(
+          Layer.mergeAll(
+            Layer.mock(CheckpointServiceV2)({ captureBaseline: () => Effect.void }),
+            Layer.mock(EventSinkV2)({
+              write: () => Effect.succeed([]),
+              writeWithEffects: (input) =>
+                Effect.gen(function* () {
+                  yield* Ref.update(written, (current) => [...current, ...input.events]);
+                  return [];
+                }),
+              writeIfRunCurrent: () => Effect.succeed({ committed: true, storedEvents: [] }),
+            }),
+            idAllocatorLayer,
+            Layer.mock(ProviderEventIngestorV2)({
+              ingestNormalized: () => Effect.succeed([]),
+            }),
+            ServerSettingsService.layerTest(),
+          ),
+        ),
+      );
+
+      const runningSubagent = makeRunOwnedSubagentFixture({
+        ids,
+        providerInstanceId,
+        childThreadId,
+        driver,
+        status: "running",
+      });
+      const runningTurnItem = makeRunOwnedSubagentTurnItemFixture({
+        ids,
+        providerInstanceId,
+        childThreadId,
+        driver,
+        status: "running",
+      });
+      const runningNode = makeRunOwnedSubagentNodeFixture({
+        ids,
+        status: "running",
+      });
+      const runningChildNode = makeRunOwnedSubagentChildNodeFixture({
+        ids,
+        status: "running",
+      });
+      const unrelatedChildNode = {
+        ...runningChildNode,
+        id: NodeId.make("node:subagent-link-survives-terminal:unrelated-child"),
+        threadId: unrelatedChildThreadId,
+        runId: ids.runId,
+        rootNodeId: NodeId.make("node:subagent-link-survives-terminal:unrelated-child"),
+      };
+      const completedAt = runningSubagent.updatedAt;
+
+      yield* Effect.gen(function* () {
+        const runExecution = yield* RunExecutionServiceV2;
+        yield* runExecution.startRootRun({
+          commandId: CommandId.make("command:subagent-link-survives-terminal"),
+          appThread: { id: ids.threadId } as OrchestrationV2AppThread,
+          providerSessionId: ProviderSessionId.make("session:subagent-link-survives-terminal"),
+          session: {
+            events: Stream.empty,
+            subscribeEvents: Effect.succeed({
+              events: Stream.fromIterable([
+                childThreadCreatedEvent(ids),
+                {
+                  type: "subagent.updated",
+                  driver,
+                  subagent: runningSubagent,
+                },
+                {
+                  type: "node.updated",
+                  driver,
+                  node: runningNode,
+                },
+                {
+                  type: "node.updated",
+                  driver,
+                  node: runningChildNode,
+                },
+                {
+                  type: "node.updated",
+                  driver,
+                  node: unrelatedChildNode,
+                },
+                {
+                  type: "turn_item.updated",
+                  driver,
+                  turnItem: runningTurnItem,
+                },
+                // Subagent + turn-item settle before root interrupt; linkage
+                // must still prove the open child-thread node is cascadeable.
+                {
+                  type: "subagent.updated",
+                  driver,
+                  subagent: {
+                    ...runningSubagent,
+                    status: "completed" as const,
+                    result: "subagent finished first",
+                    completedAt,
+                  },
+                },
+                {
+                  type: "turn_item.updated",
+                  driver,
+                  turnItem: {
+                    ...runningTurnItem,
+                    status: "completed" as const,
+                    result: "turn item finished first",
+                    completedAt,
+                    updatedAt: completedAt,
+                  },
+                },
+                {
+                  type: "node.updated",
+                  driver,
+                  node: {
+                    ...runningNode,
+                    status: "completed" as const,
+                    completedAt,
+                  },
+                },
+                rootTerminalEvent(ids, "interrupted"),
+              ] satisfies ReadonlyArray<ProviderAdapterV2Event>),
+              close: Deferred.succeed(ingestionDone, undefined),
+            }),
+            startTurn: () => Effect.void,
+          } as unknown as ProviderAdapterV2SessionRuntime,
+          run: {
+            id: ids.runId,
+            threadId: ids.threadId,
+            ordinal: 1,
+            providerInstanceId,
+          } as OrchestrationV2Run,
+          rootNode: { id: ids.rootNodeId } as OrchestrationV2ExecutionNode,
+          checkpointScope: {
+            id: CheckpointScopeId.make("checkpoint-scope:subagent-link-survives-terminal"),
+          } as OrchestrationV2CheckpointScope,
+          providerThread: {
+            id: ids.providerThreadId,
+            driver,
+          } as OrchestrationV2ProviderThread,
+          attempt: {
+            id: ids.attemptId,
+            providerTurnId: ids.rootProviderTurnId,
+          } as OrchestrationV2RunAttempt,
+          attemptId: ids.attemptId,
+          relatedThreadIds: [unrelatedChildThreadId],
+          providerTurnOrdinal: 1,
+          message: {
+            messageId: MessageId.make("message:subagent-link-survives-terminal:user"),
+            text: "Subagent settles before root interrupt.",
+            attachments: [],
+            createdBy: "user",
+            creationSource: "web",
+          },
+          modelSelection: { instanceId: providerInstanceId, model: "gpt-5.4" },
+          runtimePolicy: {
+            runtimeMode: "full-access",
+            interactionMode: "default",
+            cwd: process.cwd(),
+            approvalPolicy: "never",
+            sandboxPolicy: {
+              type: "readOnly",
+              access: { type: "fullAccess" },
+              networkAccess: false,
+            },
+          },
+        });
+      }).pipe(Effect.provide(testLayer));
+
+      const closed = yield* Deferred.await(ingestionDone).pipe(Effect.timeoutOption("2 seconds"));
+      assert.isTrue(Option.isSome(closed), "event ingestion fiber did not finish");
+
+      const events = yield* Ref.get(written);
+      const runUpdatedIndex = events.findIndex((event) => event.type === "run.updated");
+      assert.isAtLeast(runUpdatedIndex, 0, "root run.updated must be written");
+
+      const cascadedChildNodeEvents = events.flatMap((event, index) =>
+        event.type === "node.updated" &&
+        event.payload.id === runningChildNode.id &&
+        event.payload.status === "interrupted"
+          ? [{ event, index }]
+          : [],
+      );
+      assert.lengthOf(
+        cascadedChildNodeEvents,
+        1,
+        "open linked child-thread node must cascade after subagent/turn-item terminalize",
+      );
+      const cascadedChild = cascadedChildNodeEvents[0];
+      assert.isDefined(cascadedChild);
+      assert.isTrue(
+        cascadedChild.index < runUpdatedIndex,
+        "child-thread cascade must precede run.updated",
+      );
+      assert.equal(cascadedChild.event.payload.threadId, childThreadId);
+      assert.equal(cascadedChild.event.payload.kind, "root_turn");
+      assert.isFalse(
+        events.some(
+          (event) =>
+            event.type === "node.updated" &&
+            event.payload.id === unrelatedChildNode.id &&
+            event.payload.status === "interrupted",
+        ),
+        "related but unlinked child threads must not cascade",
+      );
+      assert.isFalse(
+        events.some(
+          (event) => event.type === "subagent.updated" && event.payload.status === "interrupted",
+        ),
+        "already-terminal subagent rows must not be re-cascaded",
+      );
+      assert.isFalse(
+        events.some(
+          (event) =>
+            event.type === "turn-item.updated" &&
+            event.payload.type === "subagent" &&
+            event.payload.status === "interrupted",
+        ),
+        "already-terminal subagent turn items must not be re-cascaded",
+      );
+    }),
+);
+
+it.effect("cascade helper is provider-neutral for Claude and Codex-shaped child projections", () =>
+  Effect.gen(function* () {
+    const now = yield* DateTime.now;
+    let nextId = 0;
+    const allocateEventId = () =>
+      Effect.sync(() => EventId.make(`event:cascade-helper:${nextId++}`));
+
+    for (const driverKind of [
+      ProviderDriverKind.make("claudeAgent"),
+      ProviderDriverKind.make("codex"),
+    ] as const) {
+      const runId = RunId.make(`run:cascade-helper:${driverKind}`);
+      const threadId = ThreadId.make(`thread:cascade-helper:${driverKind}`);
+      const childThreadId = ThreadId.make(`thread:cascade-helper:${driverKind}:child`);
+      const subagentId = NodeId.make(`node:cascade-helper:${driverKind}:subagent`);
+      const childNodeId = NodeId.make(`node:cascade-helper:${driverKind}:child-root`);
+      const providerInstanceId = ProviderInstanceId.make(String(driverKind));
+      const terminalStatus = driverKind === "claudeAgent" ? "failed" : "cancelled";
+      const subagent: OrchestrationV2Subagent = {
+        id: subagentId,
+        threadId,
+        runId,
+        parentNodeId: NodeId.make(`node:cascade-helper:${driverKind}:root`),
+        origin: "provider_native",
+        createdBy: "agent",
+        driver: driverKind,
+        providerInstanceId,
+        providerThreadId: null,
+        childThreadId,
+        nativeTaskRef: {
+          driver: driverKind,
+          nativeId: `native-${driverKind}`,
+          strength: "strong",
+        },
+        prompt: "hold",
+        title: "hold",
+        model: null,
+        status: "running",
+        progress: "partial progress",
+        result: "partial result",
+        startedAt: now,
+        completedAt: null,
+        updatedAt: now,
+      };
+      const turnItem = {
+        id: TurnItemId.make(`turn-item:cascade-helper:${driverKind}`),
+        threadId,
+        runId,
+        nodeId: subagentId,
+        providerThreadId: null,
+        providerTurnId: null,
+        nativeItemRef: subagent.nativeTaskRef,
+        parentItemId: null,
+        ordinal: 3,
+        status: "running" as const,
+        title: "hold",
+        startedAt: now,
+        completedAt: null,
+        updatedAt: now,
+        type: "subagent" as const,
+        subagentId,
+        origin: "provider_native" as const,
+        driver: driverKind,
+        providerInstanceId,
+        childThreadId,
+        prompt: "hold",
+        progress: "partial progress",
+        result: "partial result",
+      } satisfies Extract<OrchestrationV2TurnItem, { type: "subagent" }>;
+      const node: OrchestrationV2ExecutionNode = {
+        id: subagentId,
+        threadId,
+        runId,
+        parentNodeId: NodeId.make(`node:cascade-helper:${driverKind}:root`),
+        rootNodeId: NodeId.make(`node:cascade-helper:${driverKind}:root`),
+        kind: "subagent",
+        status: "running",
+        countsForRun: false,
+        providerThreadId: null,
+        providerTurnId: null,
+        nativeItemRef: subagent.nativeTaskRef,
+        runtimeRequestId: null,
+        checkpointScopeId: null,
+        startedAt: now,
+        completedAt: null,
+      };
+      const openChildNode: OrchestrationV2ExecutionNode = {
+        id: childNodeId,
+        threadId: childThreadId,
+        runId: null,
+        parentNodeId: null,
+        rootNodeId: childNodeId,
+        kind: "root_turn",
+        status: "running",
+        countsForRun: false,
+        providerThreadId: null,
+        providerTurnId: null,
+        nativeItemRef: null,
+        runtimeRequestId: null,
+        checkpointScopeId: null,
+        startedAt: now,
+        completedAt: null,
+      };
+      const childTurnItem: OrchestrationV2TurnItem =
+        driverKind === "claudeAgent"
+          ? {
+              id: TurnItemId.make(`turn-item:cascade-helper:${driverKind}:child-reasoning`),
+              threadId: childThreadId,
+              runId: null,
+              nodeId: childNodeId,
+              providerThreadId: null,
+              providerTurnId: null,
+              nativeItemRef: null,
+              parentItemId: null,
+              ordinal: 1,
+              status: "running",
+              title: "Working",
+              startedAt: now,
+              completedAt: null,
+              updatedAt: now,
+              type: "reasoning",
+              text: "partial progress",
+              streaming: true,
+            }
+          : {
+              id: TurnItemId.make(`turn-item:cascade-helper:${driverKind}:child-command`),
+              threadId: childThreadId,
+              runId: null,
+              nodeId: childNodeId,
+              providerThreadId: null,
+              providerTurnId: null,
+              nativeItemRef: null,
+              parentItemId: null,
+              ordinal: 1,
+              status: "running",
+              title: "sleep 300",
+              startedAt: now,
+              completedAt: null,
+              updatedAt: now,
+              type: "command_execution",
+              input: "sleep 300",
+            };
+
+      const events = yield* cascadeTerminalizeRunOwnedSubagents({
+        run: {
+          id: runId,
+          threadId,
+          ordinal: 1,
+          providerInstanceId,
+        } as OrchestrationV2Run,
+        open: {
+          subagents: new Map([[subagentId, subagent]]),
+          turnItems: new Map([[subagentId, turnItem]]),
+          childTurnItems: new Map(),
+          nodes: new Map([[subagentId, node]]),
+          linkedChildThreadIds: new Set([childThreadId]),
+        },
+        status: terminalStatus,
+        completedAt: now,
+        allocateEventId,
+      });
+
+      assert.equal(events.length, 3, `${driverKind}: subagent + node + turn item`);
+      const terminalSubagent = events.find((event) => event.type === "subagent.updated");
+      assert.isDefined(terminalSubagent);
+      if (terminalSubagent?.type !== "subagent.updated") {
+        assert.fail("expected subagent.updated event");
+        return;
+      }
+      assert.equal(terminalSubagent.payload.status, terminalStatus);
+      assert.equal(terminalSubagent.payload.childThreadId, childThreadId);
+      assert.equal(terminalSubagent.payload.progress, "partial progress");
+      assert.equal(terminalSubagent.payload.result, "partial result");
+      assert.equal(terminalSubagent.payload.driver, driverKind);
+
+      const terminalItem = events.find(
+        (event) => event.type === "turn-item.updated" && event.payload.type === "subagent",
+      );
+      assert.isDefined(terminalItem);
+      if (terminalItem?.type !== "turn-item.updated" || terminalItem.payload.type !== "subagent") {
+        assert.fail("expected subagent turn-item.updated event");
+        return;
+      }
+      assert.equal(terminalItem.payload.status, terminalStatus);
+      assert.equal(terminalItem.payload.childThreadId, childThreadId);
+      assert.equal(terminalItem.payload.progress, "partial progress");
+      assert.equal(terminalItem.payload.result, "partial result");
+
+      // Shared cascade path: after subagent/turn-item rows are gone, only the
+      // preserved linkage may prove an open child-thread node is cascadeable.
+      const afterTerminalLinkEvents = yield* cascadeTerminalizeRunOwnedSubagents({
+        run: {
+          id: runId,
+          threadId,
+          ordinal: 1,
+          providerInstanceId,
+        } as OrchestrationV2Run,
+        open: {
+          subagents: new Map(),
+          turnItems: new Map(),
+          childTurnItems: new Map([[childTurnItem.id, childTurnItem]]),
+          nodes: new Map([[childNodeId, openChildNode]]),
+          linkedChildThreadIds: new Set([childThreadId]),
+        },
+        status: terminalStatus,
+        completedAt: now,
+        allocateEventId,
+      });
+      assert.equal(
+        afterTerminalLinkEvents.length,
+        2,
+        `${driverKind}: linked child node and turn item cascade after link rows terminalize`,
+      );
+      const cascadedChild = afterTerminalLinkEvents.find((event) => event.type === "node.updated");
+      assert.isDefined(cascadedChild);
+      if (cascadedChild?.type !== "node.updated") {
+        assert.fail("expected node.updated for linked child thread");
+        return;
+      }
+      assert.equal(cascadedChild.payload.id, childNodeId);
+      assert.equal(cascadedChild.payload.threadId, childThreadId);
+      assert.equal(cascadedChild.payload.status, terminalStatus);
+      assert.equal(cascadedChild.payload.kind, "root_turn");
+      const cascadedChildTurnItem = afterTerminalLinkEvents.find(
+        (event) => event.type === "turn-item.updated",
+      );
+      assert.isDefined(cascadedChildTurnItem);
+      if (cascadedChildTurnItem?.type !== "turn-item.updated") {
+        assert.fail("expected turn-item.updated for linked child thread");
+        return;
+      }
+      assert.equal(cascadedChildTurnItem.threadId, childThreadId);
+      assert.equal(cascadedChildTurnItem.payload.id, childTurnItem.id);
+      assert.equal(cascadedChildTurnItem.payload.status, terminalStatus);
+      assert.equal(cascadedChildTurnItem.payload.runId, null);
+      assert.equal(cascadedChildTurnItem.payload.type, childTurnItem.type);
+      if (cascadedChildTurnItem.payload.type === "reasoning") {
+        assert.isFalse(cascadedChildTurnItem.payload.streaming);
+      }
+    }
+  }),
+);
+
+it.effect("omits interrupt results and subagent cascade for a superseded attempt", () =>
+  Effect.gen(function* () {
+    const written = yield* captureInterruptTerminalTurnItems({
+      key: "steer-supersede",
+      shouldFinalizeRun: () => Effect.succeed(false),
+      seedOpenSubagent: true,
+    });
+    assert.deepEqual(
+      written.map((item) => item.type),
+      [],
+    );
+  }),
+);
+
+it.effect("emits run_interrupt_result when superseded attempt still has a hard-stop request", () =>
+  Effect.gen(function* () {
+    const written = yield* captureInterruptTerminalTurnItems({
+      key: "stop-then-steer-supersede",
+      shouldFinalizeRun: () => Effect.succeed(false),
+      hasUnpairedRunInterruptRequest: () => Effect.succeed(true),
+    });
+    assert.deepEqual(
+      written.map((item) => item.type),
+      ["run_interrupt_result"],
+    );
+    const ids = backgroundScenarioIds("stop-then-steer-supersede");
+    const expectedRequestId = yield* Effect.gen(function* () {
+      const idAllocator = yield* IdAllocatorV2;
+      return idAllocator.derive.runSignalTurnItem({
+        runId: ids.runId,
+        signal: "interrupt-request",
+      });
+    }).pipe(Effect.provide(idAllocatorLayer));
+    assert.equal(written[0]?.parentItemId, expectedRequestId);
+  }),
+);
+
+it.effect("omits run_interrupt_result when superseded attempt request is already paired", () =>
+  Effect.gen(function* () {
+    const written = yield* captureInterruptTerminalTurnItems({
+      key: "stop-then-steer-already-paired",
+      shouldFinalizeRun: () => Effect.succeed(false),
+      hasUnpairedRunInterruptRequest: () => Effect.succeed(false),
+    });
+    assert.deepEqual(
+      written.map((item) => item.type),
+      [],
+    );
+  }),
+);
+
+it.effect("emits run_interrupt_result when hard-stop finalizes the active attempt", () =>
+  Effect.gen(function* () {
+    const written = yield* captureInterruptTerminalTurnItems({
+      key: "hard-stop",
+      shouldFinalizeRun: () => Effect.succeed(true),
+    });
+    assert.deepEqual(
+      written.map((item) => item.type),
+      ["run_interrupt_result"],
+    );
+  }),
+);
+
+function captureInterruptTerminalTurnItems(input: {
+  readonly key: string;
+  readonly shouldFinalizeRun: () => Effect.Effect<boolean, never>;
+  readonly hasUnpairedRunInterruptRequest?: () => Effect.Effect<boolean, never>;
+  readonly seedOpenSubagent?: boolean;
+}) {
+  return Effect.gen(function* () {
+    const ids = backgroundScenarioIds(input.key);
+    const providerInstanceId = ProviderInstanceId.make("codex");
+    const runningSubagent = makeRunOwnedSubagentFixture({
+      ids,
+      providerInstanceId,
+      childThreadId: ids.childThreadId,
+      driver,
+      status: "running",
+    });
+    const writtenItems = yield* Ref.make<
+      ReadonlyArray<{ readonly type: string; readonly parentItemId: string | null }>
+    >([]);
+    const ingestionDone = yield* Deferred.make<void>();
+    const captureTurnItem = (payload: {
+      readonly type: string;
+      readonly parentItemId: string | null;
+    }) =>
+      Ref.update(writtenItems, (current) => [
+        ...current,
+        { type: payload.type, parentItemId: payload.parentItemId },
+      ]);
+    const testLayer = runExecutionServiceLayer.pipe(
+      Layer.provide(
+        Layer.mergeAll(
+          Layer.mock(CheckpointServiceV2)({ captureBaseline: () => Effect.void }),
+          Layer.mock(EventSinkV2)({
+            write: (payload) =>
+              Effect.gen(function* () {
+                for (const event of payload.events) {
+                  if (event.type === "turn-item.updated") {
+                    yield* captureTurnItem(event.payload);
+                  }
+                }
+                return [];
+              }),
+            writeWithEffects: (payload) =>
+              Effect.gen(function* () {
+                for (const event of payload.events) {
+                  if (event.type === "turn-item.updated") {
+                    yield* captureTurnItem(event.payload);
+                  }
+                }
+                return [];
+              }),
+            writeIfRunCurrent: () => Effect.succeed({ committed: true, storedEvents: [] }),
+          }),
+          idAllocatorLayer,
+          Layer.mock(ProviderEventIngestorV2)({
+            ingestNormalized: () => Effect.succeed([]),
+          }),
+          ServerSettingsService.layerTest(),
+        ),
+      ),
+    );
+
+    yield* Effect.gen(function* () {
+      const runExecution = yield* RunExecutionServiceV2;
+      yield* runExecution.startRootRun({
+        commandId: CommandId.make(`command:${input.key}`),
+        appThread: { id: ids.threadId } as OrchestrationV2AppThread,
+        providerSessionId: ProviderSessionId.make(`session:${input.key}`),
+        session: {
+          events: Stream.empty,
+          subscribeEvents: Effect.succeed({
+            events: Stream.fromIterable([
+              ...(input.seedOpenSubagent
+                ? [
+                    { type: "subagent.updated", driver, subagent: runningSubagent } as const,
+                    {
+                      type: "node.updated",
+                      driver,
+                      node: makeRunOwnedSubagentNodeFixture({ ids, status: "running" }),
+                    } as const,
+                    {
+                      type: "turn_item.updated",
+                      driver,
+                      turnItem: makeRunOwnedSubagentTurnItemFixture({
+                        ids,
+                        providerInstanceId,
+                        childThreadId: ids.childThreadId,
+                        driver,
+                        status: "running",
+                      }),
+                    } as const,
+                  ]
+                : []),
+              rootTerminalEvent(ids, "interrupted"),
+            ] satisfies ReadonlyArray<ProviderAdapterV2Event>),
+            close: Deferred.succeed(ingestionDone, undefined),
+          }),
+          startTurn: () => Effect.void,
+        } as unknown as ProviderAdapterV2SessionRuntime,
+        run: {
+          id: ids.runId,
+          threadId: ids.threadId,
+          ordinal: 1,
+          providerInstanceId,
+        } as OrchestrationV2Run,
+        rootNode: {
+          id: ids.rootNodeId,
+          providerTurnId: ids.rootProviderTurnId,
+        } as OrchestrationV2ExecutionNode,
+        checkpointScope: {
+          id: CheckpointScopeId.make(`checkpoint-scope:${input.key}`),
+        } as OrchestrationV2CheckpointScope,
+        providerThread: {
+          id: ids.providerThreadId,
+          driver,
+        } as OrchestrationV2ProviderThread,
+        attempt: {
+          id: ids.attemptId,
+          providerTurnId: ids.rootProviderTurnId,
+        } as OrchestrationV2RunAttempt,
+        attemptId: ids.attemptId,
+        providerTurnOrdinal: 1,
+        shouldFinalizeRun: input.shouldFinalizeRun,
+        ...(input.hasUnpairedRunInterruptRequest === undefined
+          ? {}
+          : {
+              hasUnpairedRunInterruptRequest: input.hasUnpairedRunInterruptRequest,
+            }),
+        message: {
+          messageId: MessageId.make(`message:${input.key}`),
+          text: "interrupt projection",
+          attachments: [],
+          createdBy: "user",
+          creationSource: "web",
+        },
+        modelSelection: { instanceId: providerInstanceId, model: "gpt-5.4" },
+        runtimePolicy: {
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          cwd: process.cwd(),
+          approvalPolicy: "never",
+          sandboxPolicy: {
+            type: "readOnly",
+            access: { type: "fullAccess" },
+            networkAccess: false,
+          },
+        },
+      });
+    }).pipe(Effect.provide(testLayer));
+
+    const closed = yield* Deferred.await(ingestionDone).pipe(Effect.timeoutOption("2 seconds"));
+    assert.isTrue(Option.isSome(closed), "event ingestion fiber did not finish");
+    return yield* Ref.get(writtenItems);
+  });
+}
+
+interface BackgroundScenarioIds {
+  readonly threadId: ThreadId;
+  readonly childThreadId: ThreadId;
+  readonly runId: RunId;
+  readonly attemptId: RunAttemptId;
+  readonly providerThreadId: ProviderThreadId;
+  readonly rootProviderTurnId: ProviderTurnId;
+  readonly rootNodeId: NodeId;
+  readonly itemId: TurnItemId;
+  readonly childItemId: TurnItemId;
+  readonly subagentNodeId: NodeId;
+}
+
+function backgroundScenarioIds(key: string): BackgroundScenarioIds {
+  return {
+    threadId: ThreadId.make(`thread:${key}`),
+    childThreadId: ThreadId.make(`thread:${key}:child`),
+    runId: RunId.make(`run:${key}`),
+    attemptId: RunAttemptId.make(`attempt:${key}`),
+    providerThreadId: ProviderThreadId.make(`provider-thread:${key}`),
+    rootProviderTurnId: ProviderTurnId.make(`provider-turn:${key}`),
+    rootNodeId: NodeId.make(`node:${key}`),
+    itemId: TurnItemId.make(`turn-item:${key}`),
+    childItemId: TurnItemId.make(`turn-item:${key}:child`),
+    subagentNodeId: NodeId.make(`node:${key}:subagent`),
+  };
+}
+
+function childThreadCreatedEvent(ids: BackgroundScenarioIds): ProviderAdapterV2Event {
+  return {
+    type: "app_thread.created",
+    driver,
+    appThread: {
+      id: ids.childThreadId,
+      lineage: {
+        parentThreadId: ids.threadId,
+        relationshipToParent: "subagent",
+        rootThreadId: ids.threadId,
+      },
+    },
+  } as ProviderAdapterV2Event;
+}
+
+function childBackgroundTurnItemEvent(
+  ids: BackgroundScenarioIds,
+  status: "running" | "completed",
+  ordinal: number,
+): ProviderAdapterV2Event {
+  return {
+    type: "turn_item.updated",
+    driver,
+    turnItem: {
+      id: ids.childItemId,
+      threadId: ids.childThreadId,
+      runId: null,
+      providerTurnId: null,
+      ordinal,
+      type: "command_execution",
+      status,
+    },
+  } as ProviderAdapterV2Event;
+}
+
+function backgroundTurnItemEvent(
+  ids: BackgroundScenarioIds,
+  type: "command_execution" | "dynamic_tool" | "subagent",
+  status: "running" | "completed",
+  ordinal: number,
+  itemId?: TurnItemId,
+): ProviderAdapterV2Event {
+  return {
+    type: "turn_item.updated",
+    driver,
+    turnItem: {
+      id: itemId ?? ids.itemId,
+      threadId: ids.threadId,
+      runId: ids.runId,
+      providerTurnId: ids.rootProviderTurnId,
+      ordinal,
+      type,
+      status,
+    },
+  } as ProviderAdapterV2Event;
+}
+
+function backgroundTurnItemEventForRun(
+  ids: BackgroundScenarioIds,
+  runId: RunId,
+  type: "command_execution" | "dynamic_tool" | "subagent",
+  status: "running" | "completed",
+  ordinal: number,
+): ProviderAdapterV2Event {
+  const event = backgroundTurnItemEvent(ids, type, status, ordinal);
+  if (event.type !== "turn_item.updated") {
+    return event;
+  }
+  return { ...event, turnItem: { ...event.turnItem, runId } };
+}
+
+function subagentEvent(
+  ids: BackgroundScenarioIds,
+  status: "running" | "completed",
+): ProviderAdapterV2Event {
+  return {
+    type: "subagent.updated",
+    driver,
+    subagent: {
+      id: ids.subagentNodeId,
+      threadId: ids.threadId,
+      runId: ids.runId,
+      status,
+    },
+  } as ProviderAdapterV2Event;
+}
+
+function makeRunOwnedSubagentFixture(input: {
+  readonly ids: BackgroundScenarioIds;
+  readonly providerInstanceId: ProviderInstanceId;
+  readonly childThreadId: ThreadId;
+  readonly driver: typeof driver;
+  readonly status: "running" | "interrupted";
+}): OrchestrationV2Subagent {
+  const now = DateTime.makeUnsafe("2026-07-21T12:00:00.000Z");
+  return {
+    id: input.ids.subagentNodeId,
+    threadId: input.ids.threadId,
+    runId: input.ids.runId,
+    parentNodeId: input.ids.rootNodeId,
+    origin: "provider_native",
+    createdBy: "agent",
+    driver: input.driver,
+    providerInstanceId: input.providerInstanceId,
+    providerThreadId: null,
+    childThreadId: input.childThreadId,
+    nativeTaskRef: {
+      driver: input.driver,
+      nativeId: `task:${input.ids.subagentNodeId}`,
+      strength: "strong",
+    },
+    prompt: "hold",
+    title: "Live-test subagent hold",
+    model: null,
+    status: input.status,
+    result: null,
+    startedAt: now,
+    completedAt: null,
+    updatedAt: now,
+  };
+}
+
+function makeRunOwnedSubagentTurnItemFixture(input: {
+  readonly ids: BackgroundScenarioIds;
+  readonly providerInstanceId: ProviderInstanceId;
+  readonly childThreadId: ThreadId;
+  readonly driver: typeof driver;
+  readonly status: "running" | "interrupted";
+}): Extract<OrchestrationV2TurnItem, { type: "subagent" }> {
+  const now = DateTime.makeUnsafe("2026-07-21T12:00:00.000Z");
+  return {
+    id: input.ids.itemId,
+    threadId: input.ids.threadId,
+    runId: input.ids.runId,
+    nodeId: input.ids.subagentNodeId,
+    providerThreadId: input.ids.providerThreadId,
+    providerTurnId: input.ids.rootProviderTurnId,
+    nativeItemRef: {
+      driver: input.driver,
+      nativeId: `task:${input.ids.subagentNodeId}`,
+      strength: "strong",
+    },
+    parentItemId: null,
+    ordinal: 3,
+    status: input.status,
+    title: "Live-test subagent hold",
+    startedAt: now,
+    completedAt: null,
+    updatedAt: now,
+    type: "subagent",
+    subagentId: input.ids.subagentNodeId,
+    origin: "provider_native",
+    driver: input.driver,
+    providerInstanceId: input.providerInstanceId,
+    childThreadId: input.childThreadId,
+    prompt: "hold",
+    result: null,
+  };
+}
+
+function makeLinkedChildTurnItemFixture(input: {
+  readonly ids: BackgroundScenarioIds;
+  readonly driver: typeof driver;
+  readonly type: "assistant_message" | "command_execution" | "reasoning";
+}): OrchestrationV2TurnItem {
+  const now = DateTime.makeUnsafe("2026-07-21T12:00:00.000Z");
+  const base = {
+    id: input.ids.childItemId,
+    threadId: input.ids.childThreadId,
+    runId: null,
+    nodeId: NodeId.make(`${input.ids.subagentNodeId}:child-root`),
+    providerThreadId: null,
+    providerTurnId: null,
+    nativeItemRef: null,
+    parentItemId: null,
+    ordinal: 1,
+    status: "running" as const,
+    title: "Working",
+    startedAt: now,
+    completedAt: null,
+    updatedAt: now,
+  };
+  if (input.type === "assistant_message") {
+    return {
+      ...base,
+      type: "assistant_message",
+      messageId: MessageId.make(`${input.ids.childItemId}:message`),
+      text: "partial response",
+      streaming: true,
+    };
+  }
+  if (input.type === "reasoning") {
+    return {
+      ...base,
+      type: "reasoning",
+      text: "partial progress",
+      streaming: true,
+    };
+  }
+  return {
+    ...base,
+    type: "command_execution",
+    input: "sleep 300",
+  };
+}
+
+function makeRunOwnedSubagentNodeFixture(input: {
+  readonly ids: BackgroundScenarioIds;
+  readonly status: "running" | "interrupted";
+}): OrchestrationV2ExecutionNode {
+  const now = DateTime.makeUnsafe("2026-07-21T12:00:00.000Z");
+  return {
+    id: input.ids.subagentNodeId,
+    threadId: input.ids.threadId,
+    runId: input.ids.runId,
+    parentNodeId: input.ids.rootNodeId,
+    rootNodeId: input.ids.rootNodeId,
+    kind: "subagent",
+    status: input.status,
+    countsForRun: false,
+    providerThreadId: input.ids.providerThreadId,
+    providerTurnId: input.ids.rootProviderTurnId,
+    nativeItemRef: {
+      driver,
+      nativeId: `task:${input.ids.subagentNodeId}`,
+      strength: "strong",
+    },
+    runtimeRequestId: null,
+    checkpointScopeId: null,
+    startedAt: now,
+    completedAt: null,
+  };
+}
+
+function makeRunOwnedSubagentChildNodeFixture(input: {
+  readonly ids: BackgroundScenarioIds;
+  readonly status: "running" | "interrupted";
+}): OrchestrationV2ExecutionNode {
+  const now = DateTime.makeUnsafe("2026-07-21T12:00:00.000Z");
+  return {
+    id: NodeId.make(`${input.ids.subagentNodeId}:child-root`),
+    threadId: input.ids.childThreadId,
+    runId: null,
+    parentNodeId: null,
+    rootNodeId: NodeId.make(`${input.ids.subagentNodeId}:child-root`),
+    kind: "root_turn",
+    status: input.status,
+    countsForRun: false,
+    providerThreadId: null,
+    providerTurnId: null,
+    nativeItemRef: null,
+    runtimeRequestId: null,
+    checkpointScopeId: null,
+    startedAt: now,
+    completedAt: null,
+  };
+}
+
+function rootTerminalEvent(
+  ids: BackgroundScenarioIds,
+  status: "completed" | "interrupted",
+): ProviderAdapterV2Event {
+  return {
+    type: "turn.terminal",
+    driver,
+    providerThreadId: ids.providerThreadId,
+    providerTurnId: ids.rootProviderTurnId,
+    runOrdinal: 1,
+    status,
+    failure: null,
+    threadDisposition: "reusable",
+  } as ProviderAdapterV2Event;
+}
+
+function runBackgroundItemScenario(
+  key: string,
+  makeEvents: (ids: BackgroundScenarioIds) => ReadonlyArray<ProviderAdapterV2Event>,
+  options?: {
+    readonly keepEventStreamOpen?: boolean;
+    readonly loadInheritedBackgroundTurnItems?: () => Effect.Effect<
+      ReadonlyArray<{ readonly id: TurnItemId; readonly runId: RunId }>
+    >;
+    readonly onSubscribe?: Effect.Effect<void>;
+  },
+) {
+  return Effect.gen(function* () {
+    const ids = backgroundScenarioIds(key);
+    const providerInstanceId = ProviderInstanceId.make("codex");
+    const observed = yield* Ref.make<ReadonlyArray<string>>([]);
+    const ingestionDone = yield* Deferred.make<void>();
+    const testLayer = runExecutionServiceLayer.pipe(
+      Layer.provide(
+        Layer.mergeAll(
+          Layer.mock(CheckpointServiceV2)({ captureBaseline: () => Effect.void }),
+          Layer.mock(EventSinkV2)({
+            write: () => Effect.succeed([]),
+            writeWithEffects: (input) =>
+              Effect.gen(function* () {
+                if (
+                  input.events.some(
+                    (event) => event.type === "run.updated" && event.runId === ids.runId,
+                  )
+                ) {
+                  yield* Ref.update(observed, (current) => [...current, "root-finalized"]);
+                }
+                return [];
+              }),
+            writeIfRunCurrent: () => Effect.succeed({ committed: true, storedEvents: [] }),
+          }),
+          idAllocatorLayer,
+          Layer.mock(ProviderEventIngestorV2)({
+            ingestNormalized: (input) =>
+              Effect.gen(function* () {
+                const event = input.event;
+                if (event.type === "turn_item.updated") {
+                  yield* Ref.update(observed, (current) => [
+                    ...current,
+                    `turn_item:${event.turnItem.status}`,
+                  ]);
+                }
+                if (event.type === "subagent.updated") {
+                  yield* Ref.update(observed, (current) => [
+                    ...current,
+                    `subagent:${event.subagent.status}`,
+                  ]);
+                }
+                return [];
+              }),
+          }),
+          ServerSettingsService.layerTest(),
+        ),
+      ),
+    );
+
+    yield* Effect.gen(function* () {
+      const runExecution = yield* RunExecutionServiceV2;
+      yield* runExecution.startRootRun({
+        commandId: CommandId.make(`command:${key}`),
+        appThread: { id: ids.threadId } as OrchestrationV2AppThread,
+        providerSessionId: ProviderSessionId.make(`session:${key}`),
+        session: {
+          events: Stream.empty,
+          subscribeEvents: Effect.gen(function* () {
+            yield* options?.onSubscribe ?? Effect.void;
+            const events = Stream.fromIterable(makeEvents(ids));
+            return {
+              events:
+                options?.keepEventStreamOpen === true
+                  ? events.pipe(Stream.concat(Stream.never))
+                  : events,
+              close: Deferred.succeed(ingestionDone, undefined),
+            };
+          }),
+          startTurn: () => Effect.void,
+        } as unknown as ProviderAdapterV2SessionRuntime,
+        run: {
+          id: ids.runId,
+          threadId: ids.threadId,
+          ordinal: 1,
+          providerInstanceId,
+        } as OrchestrationV2Run,
+        rootNode: { id: ids.rootNodeId } as OrchestrationV2ExecutionNode,
+        checkpointScope: {
+          id: CheckpointScopeId.make(`checkpoint-scope:${key}`),
+        } as OrchestrationV2CheckpointScope,
+        providerThread: {
+          id: ids.providerThreadId,
+          driver,
+        } as OrchestrationV2ProviderThread,
+        attempt: {
+          id: ids.attemptId,
+          providerTurnId: ids.rootProviderTurnId,
+        } as OrchestrationV2RunAttempt,
+        attemptId: ids.attemptId,
+        ...(options?.loadInheritedBackgroundTurnItems === undefined
+          ? {}
+          : {
+              loadInheritedBackgroundTurnItems: options.loadInheritedBackgroundTurnItems,
+            }),
+        providerTurnOrdinal: 1,
+        message: {
+          messageId: MessageId.make(`message:${key}:user`),
+          text: "Start a background item and finish.",
+          attachments: [],
+          createdBy: "user",
+          creationSource: "web",
+        },
+        modelSelection: { instanceId: providerInstanceId, model: "gpt-5.4" },
+        runtimePolicy: {
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          cwd: process.cwd(),
+          approvalPolicy: "never",
+          sandboxPolicy: {
+            type: "readOnly",
+            access: { type: "fullAccess" },
+            networkAccess: false,
+          },
+        },
+      });
+    }).pipe(Effect.provide(testLayer));
+
+    const closed = yield* Deferred.await(ingestionDone).pipe(Effect.timeoutOption("2 seconds"));
+    assert.isTrue(Option.isSome(closed), "event ingestion fiber did not finish");
+    return yield* Ref.get(observed);
+  });
+}
diff --git a/apps/server/src/orchestration-v2/RunExecutionService.ts b/apps/server/src/orchestration-v2/RunExecutionService.ts
new file mode 100644
index 000000000000..1fa61dcde233
--- /dev/null
+++ b/apps/server/src/orchestration-v2/RunExecutionService.ts
@@ -0,0 +1,1364 @@
+import {
+  CommandId,
+  type EventId,
+  type ModelSelection,
+  type NodeId,
+  type OrchestrationV2AppThread,
+  type OrchestrationV2CheckpointScope,
+  type OrchestrationV2DomainEvent,
+  type OrchestrationV2ExecutionNode,
+  type OrchestrationV2ProviderFailure,
+  type OrchestrationV2ProviderThread,
+  type OrchestrationV2ProviderTurn,
+  type OrchestrationV2Run,
+  type OrchestrationV2RunAttempt,
+  type OrchestrationV2Subagent,
+  type OrchestrationV2TurnItem,
+  type ProviderSessionId,
+  type ProviderThreadId,
+  type ProviderTurnId,
+  type RunAttemptId,
+  type ThreadId,
+  type TurnItemId,
+} from "@t3tools/contracts";
+import * as Context from "effect/Context";
+import * as Cause from "effect/Cause";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+import * as Fiber from "effect/Fiber";
+import * as Layer from "effect/Layer";
+import * as Ref from "effect/Ref";
+import * as Schema from "effect/Schema";
+import * as Stream from "effect/Stream";
+
+import * as McpSessionRegistry from "../mcp/McpSessionRegistry.ts";
+import { ServerSettingsService } from "../serverSettings.ts";
+import { CheckpointServiceV2 } from "./CheckpointService.ts";
+import { EventSinkV2 } from "./EventSink.ts";
+import {
+  IdAllocatorV2,
+  type IdAllocatorV2AllocationError,
+  type IdAllocatorV2Shape,
+} from "./IdAllocator.ts";
+import type {
+  ProviderAdapterV2Event,
+  ProviderAdapterV2RuntimePolicy,
+  ProviderAdapterV2SessionRuntime,
+  ProviderAdapterV2TurnMessage,
+} from "./ProviderAdapter.ts";
+import { ProviderEventIngestorV2 } from "./ProviderEventIngestor.ts";
+import { makeProviderFailure, makeProviderFailureTurnItem } from "./ProviderFailure.ts";
+
+export interface ProviderEventRoutingState {
+  readonly ownedThreadIds: ReadonlySet<ThreadId>;
+  readonly ownedProviderThreadIds: ReadonlySet<ProviderThreadId>;
+  readonly ownedProviderTurnIds: ReadonlySet<ProviderTurnId>;
+  readonly inheritedBackgroundTurnItems: ReadonlyMap<TurnItemId, OrchestrationV2Run["id"]>;
+  readonly rootProviderTurnId: ProviderTurnId | null;
+}
+
+export interface ProviderEventRouteIdentity {
+  readonly threadId: ThreadId;
+  readonly runId: OrchestrationV2Run["id"];
+  readonly attemptId: RunAttemptId;
+  readonly providerThreadId: ProviderThreadId;
+}
+
+export interface InheritedBackgroundTurnItemRoute {
+  readonly id: TurnItemId;
+  readonly runId: OrchestrationV2Run["id"];
+}
+
+type ProviderTerminalEvent = Extract<ProviderAdapterV2Event, { readonly type: "turn.terminal" }>;
+
+function isTerminalProviderTurnStatus(status: OrchestrationV2ProviderTurn["status"]): boolean {
+  return (
+    status === "completed" ||
+    status === "interrupted" ||
+    status === "failed" ||
+    status === "cancelled"
+  );
+}
+
+function isTerminalSubagentStatus(status: OrchestrationV2Subagent["status"]): boolean {
+  return (
+    status === "completed" ||
+    status === "interrupted" ||
+    status === "failed" ||
+    status === "cancelled"
+  );
+}
+
+// Turn item types whose lifecycle can outlive the root turn (background
+// commands, monitors/dynamic tools, subagent rows). Ingestion must not stop
+// while one of these is still non-terminal, or the late completion event is
+// dropped and the item spins forever in the projection.
+const backgroundCapableTurnItemTypes: ReadonlySet<OrchestrationV2TurnItem["type"]> = new Set([
+  "command_execution",
+  "dynamic_tool",
+  "subagent",
+]);
+
+function isTerminalTurnItemStatus(status: OrchestrationV2TurnItem["status"]): boolean {
+  return (
+    status === "completed" ||
+    status === "interrupted" ||
+    status === "failed" ||
+    status === "cancelled"
+  );
+}
+
+function isSettledRunEligibleForInheritedBackground(status: OrchestrationV2Run["status"]): boolean {
+  return status === "interrupted" || status === "failed" || status === "cancelled";
+}
+
+/**
+ * Transfer delivery permission for exact live background items whose original
+ * run no longer has a subscriber. Provider sessions are runtime containers and
+ * can host multiple provider threads, so the durable provider-thread lineage is
+ * the discriminator. Completed, rolled-back, and already-terminal items remain
+ * excluded.
+ */
+export function selectInheritedBackgroundTurnItems(input: {
+  readonly threadId: ThreadId;
+  readonly currentProviderThreadId: ProviderThreadId;
+  readonly currentRunOrdinal: number;
+  readonly runs: ReadonlyArray<OrchestrationV2Run>;
+  readonly turnItems: ReadonlyArray<OrchestrationV2TurnItem>;
+}): ReadonlyArray<InheritedBackgroundTurnItemRoute> {
+  const settledPriorRunIds = new Set(
+    input.runs
+      .filter(
+        (run) =>
+          run.threadId === input.threadId &&
+          run.ordinal < input.currentRunOrdinal &&
+          isSettledRunEligibleForInheritedBackground(run.status),
+      )
+      .map((run) => run.id),
+  );
+  return input.turnItems.flatMap((turnItem) =>
+    turnItem.threadId === input.threadId &&
+    turnItem.providerThreadId === input.currentProviderThreadId &&
+    turnItem.runId !== null &&
+    settledPriorRunIds.has(turnItem.runId) &&
+    backgroundCapableTurnItemTypes.has(turnItem.type) &&
+    !isTerminalTurnItemStatus(turnItem.status)
+      ? [{ id: turnItem.id, runId: turnItem.runId }]
+      : [],
+  );
+}
+
+type SubagentTurnItem = Extract<OrchestrationV2TurnItem, { readonly type: "subagent" }>;
+
+type OpenRunOwnedSubagentProjection = {
+  readonly subagents: ReadonlyMap<NodeId, OrchestrationV2Subagent>;
+  readonly turnItems: ReadonlyMap<NodeId, SubagentTurnItem>;
+  readonly childTurnItems: ReadonlyMap<TurnItemId, OrchestrationV2TurnItem>;
+  readonly nodes: ReadonlyMap<NodeId, OrchestrationV2ExecutionNode>;
+  /** Child threads once linked by a root-run subagent row; kept for cascade. */
+  readonly linkedChildThreadIds: ReadonlySet<ThreadId>;
+};
+
+type RunOwnedSubagentTerminalStatus = Extract<
+  OrchestrationV2Subagent["status"],
+  "interrupted" | "failed" | "cancelled"
+>;
+
+function isOpenExecutionNodeStatus(status: OrchestrationV2ExecutionNode["status"]): boolean {
+  return status === "pending" || status === "running" || status === "waiting";
+}
+
+function isRunOwnedSubagentTerminalStatus(
+  status: ProviderTerminalEvent["status"],
+): status is RunOwnedSubagentTerminalStatus {
+  return status === "interrupted" || status === "failed" || status === "cancelled";
+}
+
+export function canRouteRelatedSubagent(status: OrchestrationV2Subagent["status"]): boolean {
+  return status !== "interrupted" && status !== "failed" && status !== "cancelled";
+}
+
+function emptyOpenRunOwnedSubagentProjection(): OpenRunOwnedSubagentProjection {
+  return {
+    subagents: new Map(),
+    turnItems: new Map(),
+    childTurnItems: new Map(),
+    nodes: new Map(),
+    linkedChildThreadIds: new Set(),
+  };
+}
+
+function withLinkedChildThreadId(
+  current: OpenRunOwnedSubagentProjection,
+  childThreadId: ThreadId | null,
+): OpenRunOwnedSubagentProjection {
+  if (childThreadId === null || current.linkedChildThreadIds.has(childThreadId)) {
+    return current;
+  }
+  const linkedChildThreadIds = new Set(current.linkedChildThreadIds);
+  linkedChildThreadIds.add(childThreadId);
+  return { ...current, linkedChildThreadIds };
+}
+
+export function cascadeTerminalizeRunOwnedSubagents(input: {
+  readonly run: OrchestrationV2Run;
+  readonly open: OpenRunOwnedSubagentProjection;
+  readonly status: RunOwnedSubagentTerminalStatus;
+  readonly completedAt: DateTime.Utc;
+  readonly allocateEventId: () => Effect.Effect<EventId, IdAllocatorV2AllocationError>;
+}): Effect.Effect<ReadonlyArray<OrchestrationV2DomainEvent>, IdAllocatorV2AllocationError> {
+  return Effect.gen(function* () {
+    const events: Array<OrchestrationV2DomainEvent> = [];
+    // Prefer lifetime linkage over currently-open rows: subagent/turn-item
+    // snapshots may terminalize before the linked child-thread node settles.
+    const childThreadIds = new Set(input.open.linkedChildThreadIds);
+    for (const item of [...input.open.subagents.values(), ...input.open.turnItems.values()]) {
+      if (item.childThreadId !== null) {
+        childThreadIds.add(item.childThreadId);
+      }
+    }
+    const keys = new Set<NodeId>([
+      ...input.open.subagents.keys(),
+      ...input.open.turnItems.keys(),
+      ...input.open.nodes.keys(),
+    ]);
+    for (const key of keys) {
+      const subagent = input.open.subagents.get(key);
+      if (subagent !== undefined && !isTerminalSubagentStatus(subagent.status)) {
+        events.push({
+          id: yield* input.allocateEventId(),
+          type: "subagent.updated",
+          threadId: subagent.threadId,
+          runId: input.run.id,
+          nodeId: subagent.id,
+          driver: subagent.driver,
+          providerInstanceId: subagent.providerInstanceId,
+          occurredAt: input.completedAt,
+          payload: {
+            ...subagent,
+            status: input.status,
+            completedAt: input.completedAt,
+            updatedAt: input.completedAt,
+          },
+        });
+      }
+      const node = input.open.nodes.get(key);
+      if (
+        node !== undefined &&
+        ((node.threadId === input.run.threadId && node.runId === input.run.id) ||
+          childThreadIds.has(node.threadId)) &&
+        isOpenExecutionNodeStatus(node.status)
+      ) {
+        events.push({
+          id: yield* input.allocateEventId(),
+          type: "node.updated",
+          threadId: node.threadId,
+          runId: node.runId ?? input.run.id,
+          nodeId: node.id,
+          providerInstanceId: input.run.providerInstanceId,
+          occurredAt: input.completedAt,
+          payload: {
+            ...node,
+            status: input.status,
+            completedAt: input.completedAt,
+          },
+        });
+      }
+      const turnItem = input.open.turnItems.get(key);
+      if (
+        turnItem !== undefined &&
+        turnItem.runId === input.run.id &&
+        !isTerminalTurnItemStatus(turnItem.status)
+      ) {
+        events.push({
+          id: yield* input.allocateEventId(),
+          type: "turn-item.updated",
+          threadId: turnItem.threadId,
+          runId: input.run.id,
+          ...(turnItem.nodeId === null ? {} : { nodeId: turnItem.nodeId }),
+          providerInstanceId: input.run.providerInstanceId,
+          occurredAt: input.completedAt,
+          payload: {
+            ...turnItem,
+            status: input.status,
+            completedAt: input.completedAt,
+            updatedAt: input.completedAt,
+          },
+        });
+      }
+    }
+    for (const turnItem of input.open.childTurnItems.values()) {
+      if (!childThreadIds.has(turnItem.threadId) || isTerminalTurnItemStatus(turnItem.status)) {
+        continue;
+      }
+      events.push({
+        id: yield* input.allocateEventId(),
+        type: "turn-item.updated",
+        threadId: turnItem.threadId,
+        runId: turnItem.runId ?? input.run.id,
+        ...(turnItem.nodeId === null ? {} : { nodeId: turnItem.nodeId }),
+        providerInstanceId: input.run.providerInstanceId,
+        occurredAt: input.completedAt,
+        payload: {
+          ...turnItem,
+          ...("streaming" in turnItem ? { streaming: false } : {}),
+          status: input.status,
+          completedAt: input.completedAt,
+          updatedAt: input.completedAt,
+        },
+      });
+    }
+    return events;
+  });
+}
+
+export function finalProviderThreadStatus(
+  disposition: ProviderTerminalEvent["threadDisposition"],
+): OrchestrationV2ProviderThread["status"] {
+  return disposition === "broken" ? "error" : "idle";
+}
+
+export function makeProviderEventRoutingState(input: {
+  readonly identity: ProviderEventRouteIdentity;
+  readonly inheritedBackgroundTurnItems?: ReadonlyArray<InheritedBackgroundTurnItemRoute>;
+  readonly providerTurnId: ProviderTurnId | null;
+  readonly relatedThreadIds?: ReadonlyArray<ThreadId>;
+  readonly relatedProviderThreadIds?: ReadonlyArray<ProviderThreadId>;
+}): ProviderEventRoutingState {
+  return {
+    ownedThreadIds: new Set([input.identity.threadId, ...(input.relatedThreadIds ?? [])]),
+    ownedProviderThreadIds: new Set([
+      input.identity.providerThreadId,
+      ...(input.relatedProviderThreadIds ?? []),
+    ]),
+    ownedProviderTurnIds:
+      input.providerTurnId === null ? new Set() : new Set([input.providerTurnId]),
+    inheritedBackgroundTurnItems: new Map(
+      (input.inheritedBackgroundTurnItems ?? []).map((item) => [item.id, item.runId]),
+    ),
+    rootProviderTurnId: input.providerTurnId,
+  };
+}
+
+export function routeProviderEvent(
+  event: ProviderAdapterV2Event,
+  input: ProviderEventRouteIdentity,
+  state: ProviderEventRoutingState,
+): readonly [boolean, ProviderEventRoutingState] {
+  const ownsThread = (threadId: ThreadId): boolean => state.ownedThreadIds.has(threadId);
+  const ownsChildThread = (threadId: ThreadId): boolean =>
+    threadId !== input.threadId && ownsThread(threadId);
+  const ownsRun = (runId: string | null): boolean => runId === input.runId;
+  const addProviderThread = (providerThreadId: ProviderThreadId): ProviderEventRoutingState => ({
+    ...state,
+    ownedProviderThreadIds: new Set([...state.ownedProviderThreadIds, providerThreadId]),
+  });
+  const addProviderTurn = (
+    providerTurnId: ProviderTurnId,
+    root: boolean,
+  ): ProviderEventRoutingState => ({
+    ...state,
+    ownedProviderTurnIds: new Set([...state.ownedProviderTurnIds, providerTurnId]),
+    rootProviderTurnId: root ? providerTurnId : state.rootProviderTurnId,
+  });
+
+  switch (event.type) {
+    case "provider_session.updated":
+      // The session manager persists process-wide status once for every
+      // attached app thread before broadcasting the adapter event.
+      return [false, state];
+    case "app_thread.created": {
+      if (event.appThread.id === input.threadId) {
+        return [true, state];
+      }
+      const isOwnedSubagent =
+        event.appThread.lineage.relationshipToParent === "subagent" &&
+        event.appThread.lineage.parentThreadId !== null &&
+        ownsThread(event.appThread.lineage.parentThreadId);
+      if (!isOwnedSubagent) {
+        return [false, state];
+      }
+      return [
+        true,
+        {
+          ...state,
+          ownedThreadIds: new Set([...state.ownedThreadIds, event.appThread.id]),
+        },
+      ];
+    }
+    case "provider_thread.updated": {
+      const belongs =
+        state.ownedProviderThreadIds.has(event.providerThread.id) ||
+        (event.providerThread.appThreadId !== null && ownsThread(event.providerThread.appThreadId));
+      return belongs ? [true, addProviderThread(event.providerThread.id)] : [false, state];
+    }
+    case "provider_turn.updated": {
+      const isRoot = event.providerTurn.runAttemptId === input.attemptId;
+      const belongs =
+        isRoot ||
+        (event.providerTurn.providerThreadId !== input.providerThreadId &&
+          state.ownedProviderThreadIds.has(event.providerTurn.providerThreadId)) ||
+        state.ownedProviderTurnIds.has(event.providerTurn.id) ||
+        (event.threadId !== undefined && ownsChildThread(event.threadId));
+      return belongs ? [true, addProviderTurn(event.providerTurn.id, isRoot)] : [false, state];
+    }
+    case "node.updated": {
+      const belongs = ownsRun(event.node.runId) || ownsChildThread(event.node.threadId);
+      if (!belongs || event.node.providerThreadId === null) {
+        return [belongs, state];
+      }
+      return [true, addProviderThread(event.node.providerThreadId)];
+    }
+    case "subagent.updated":
+      return [ownsRun(event.subagent.runId) || ownsChildThread(event.subagent.threadId), state];
+    case "message.updated":
+      return [ownsRun(event.message.runId) || ownsChildThread(event.message.threadId), state];
+    case "turn_item.updated": {
+      if (ownsRun(event.turnItem.runId) || ownsChildThread(event.turnItem.threadId)) {
+        return [true, state];
+      }
+      const inheritedRunId = state.inheritedBackgroundTurnItems.get(event.turnItem.id);
+      // Preserve the item's original ownership while allowing the one live run
+      // to deliver an exact carryover identity selected from the projection.
+      const isInheritedBackgroundItem =
+        event.turnItem.threadId === input.threadId &&
+        event.turnItem.runId !== null &&
+        event.turnItem.runId === inheritedRunId &&
+        backgroundCapableTurnItemTypes.has(event.turnItem.type);
+      if (!isInheritedBackgroundItem) {
+        return [false, state];
+      }
+      if (!isTerminalTurnItemStatus(event.turnItem.status)) {
+        return [true, state];
+      }
+      const inheritedBackgroundTurnItems = new Map(state.inheritedBackgroundTurnItems);
+      inheritedBackgroundTurnItems.delete(event.turnItem.id);
+      return [true, { ...state, inheritedBackgroundTurnItems }];
+    }
+    case "plan.updated":
+      return [ownsRun(event.plan.runId) || ownsChildThread(event.plan.threadId), state];
+    case "runtime_request.updated":
+      return [
+        (event.threadId !== undefined && ownsChildThread(event.threadId)) ||
+          (event.runtimeRequest.providerTurnId !== null &&
+            state.ownedProviderTurnIds.has(event.runtimeRequest.providerTurnId)),
+        state,
+      ];
+    case "turn.terminal":
+      return [event.providerTurnId === state.rootProviderTurnId, state];
+  }
+}
+
+/**
+ * ERRORS
+ */
+export class RunExecutionStartError extends Schema.TaggedErrorClass<RunExecutionStartError>()(
+  "RunExecutionStartError",
+  {
+    commandId: CommandId,
+    runId: Schema.String,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to start orchestration V2 run execution ${this.runId}.`;
+  }
+}
+
+export class RunExecutionIngestError extends Schema.TaggedErrorClass<RunExecutionIngestError>()(
+  "RunExecutionIngestError",
+  {
+    runId: Schema.String,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed while ingesting orchestration V2 run execution ${this.runId}.`;
+  }
+}
+
+export const RunExecutionServiceV2Error = Schema.Union([
+  RunExecutionStartError,
+  RunExecutionIngestError,
+]);
+export type RunExecutionServiceV2Error = typeof RunExecutionServiceV2Error.Type;
+
+/**
+ * SERVICE DEFINITION
+ */
+export interface RunExecutionServiceV2StartRootRunInput {
+  readonly commandId: CommandId;
+  readonly appThread: OrchestrationV2AppThread;
+  readonly providerSessionId: ProviderSessionId;
+  readonly session: ProviderAdapterV2SessionRuntime;
+  readonly run: OrchestrationV2Run;
+  readonly rootNode: OrchestrationV2ExecutionNode;
+  readonly checkpointScope: OrchestrationV2CheckpointScope;
+  readonly providerThread: OrchestrationV2ProviderThread;
+  readonly attempt: OrchestrationV2RunAttempt;
+  readonly attemptId: RunAttemptId;
+  readonly providerTurnOrdinal: number;
+  readonly loadInheritedBackgroundTurnItems?: () => Effect.Effect<
+    ReadonlyArray<InheritedBackgroundTurnItemRoute>,
+    unknown
+  >;
+  readonly relatedThreadIds?: ReadonlyArray<ThreadId>;
+  readonly relatedProviderThreadIds?: ReadonlyArray<ProviderThreadId>;
+  readonly shouldStartProviderTurn?: () => Effect.Effect<boolean, never>;
+  readonly shouldFinalizeRun?: () => Effect.Effect<boolean, never>;
+  readonly hasUnpairedRunInterruptRequest?: () => Effect.Effect<boolean, never>;
+  readonly message: ProviderAdapterV2TurnMessage;
+  readonly modelSelection: ModelSelection;
+  readonly runtimePolicy: ProviderAdapterV2RuntimePolicy;
+}
+
+export interface RunExecutionServiceV2Shape {
+  readonly startRootRun: (
+    input: RunExecutionServiceV2StartRootRunInput,
+  ) => Effect.Effect<void, RunExecutionServiceV2Error>;
+}
+
+export class RunExecutionServiceV2 extends Context.Service<
+  RunExecutionServiceV2,
+  RunExecutionServiceV2Shape
+>()("t3/orchestration-v2/RunExecutionService/RunExecutionServiceV2") {}
+
+export function shouldDeliverProviderEvent(
+  event: ProviderAdapterV2Event,
+  assistantStreamingEnabled: boolean,
+): boolean {
+  if (assistantStreamingEnabled) {
+    return true;
+  }
+
+  switch (event.type) {
+    case "node.updated":
+      return event.node.kind !== "assistant_message" || event.node.status !== "running";
+    case "message.updated":
+      return event.message.role !== "assistant" || !event.message.streaming;
+    case "turn_item.updated":
+      return event.turnItem.type !== "assistant_message" || !event.turnItem.streaming;
+    default:
+      return true;
+  }
+}
+
+/**
+ * IMPLEMENTATIONS
+ */
+export const layer: Layer.Layer<
+  RunExecutionServiceV2,
+  never,
+  | CheckpointServiceV2
+  | EventSinkV2
+  | IdAllocatorV2
+  | ProviderEventIngestorV2
+  | ServerSettingsService
+> = Layer.effect(
+  RunExecutionServiceV2,
+  Effect.gen(function* () {
+    const checkpointService = yield* CheckpointServiceV2;
+    const eventSink = yield* EventSinkV2;
+    const idAllocator = yield* IdAllocatorV2;
+    const providerEventIngestor = yield* ProviderEventIngestorV2;
+    const serverSettings = yield* ServerSettingsService;
+
+    const writeFinalRunEvents = (input: {
+      readonly run: OrchestrationV2Run;
+      readonly rootNode: OrchestrationV2ExecutionNode;
+      readonly checkpointScope: OrchestrationV2CheckpointScope;
+      readonly providerThread: OrchestrationV2ProviderThread;
+      readonly attempt: OrchestrationV2RunAttempt;
+      readonly shouldFinalizeRun?: () => Effect.Effect<boolean, never>;
+      readonly hasUnpairedRunInterruptRequest?: () => Effect.Effect<boolean, never>;
+      readonly openRunOwnedSubagents?: OpenRunOwnedSubagentProjection;
+      readonly terminal: ProviderTerminalEvent;
+      readonly failureItemPersisted: boolean;
+    }) =>
+      Effect.gen(function* () {
+        const completedAt = yield* DateTime.now;
+        const finalizedAttempt: OrchestrationV2RunAttempt | null = {
+          ...input.attempt,
+          status: input.terminal.status,
+          completedAt,
+        };
+        const shouldFinalizeRun =
+          input.shouldFinalizeRun === undefined ? true : yield* input.shouldFinalizeRun();
+        if (!shouldFinalizeRun) {
+          // Superseded attempt (steer / selection restart). Emit
+          // run_interrupt_result only when hard Stop left an unpaired request
+          // for this run; plain steers and already-paired stops emit nothing.
+          if (input.terminal.status === "interrupted") {
+            const hasUnpairedRequest =
+              input.hasUnpairedRunInterruptRequest === undefined
+                ? false
+                : yield* input.hasUnpairedRunInterruptRequest();
+            if (hasUnpairedRequest) {
+              yield* eventSink.writeWithEffects({
+                effects: [],
+                events: [
+                  {
+                    id: yield* idAllocator.allocate.event({ threadId: input.run.threadId }),
+                    type: "turn-item.updated" as const,
+                    threadId: input.run.threadId,
+                    runId: input.run.id,
+                    nodeId: input.rootNode.id,
+                    providerInstanceId: input.run.providerInstanceId,
+                    occurredAt: completedAt,
+                    payload: makeInterruptResultTurnItem({
+                      idAllocator,
+                      run: input.run,
+                      rootNode: input.rootNode,
+                      providerThread: input.providerThread,
+                      completedAt,
+                    }),
+                  },
+                ],
+              });
+            }
+          }
+          return;
+        }
+        const allocateEventId = () => idAllocator.allocate.event({ threadId: input.run.threadId });
+        const open = input.openRunOwnedSubagents ?? emptyOpenRunOwnedSubagentProjection();
+        const hasOpenSubagentProjection =
+          open.subagents.size > 0 ||
+          open.turnItems.size > 0 ||
+          open.childTurnItems.size > 0 ||
+          open.nodes.size > 0;
+        const cascadedSubagentEvents =
+          isRunOwnedSubagentTerminalStatus(input.terminal.status) && hasOpenSubagentProjection
+            ? yield* cascadeTerminalizeRunOwnedSubagents({
+                run: input.run,
+                open,
+                status: input.terminal.status,
+                completedAt,
+                allocateEventId,
+              })
+            : [];
+        const persistedStatus =
+          input.terminal.status === "completed" ? "waiting" : input.terminal.status;
+        // Completion cohorts are advanced by Orchestrator while a provider
+        // turn is in flight. Do not replay the run snapshot captured at start
+        // over a newer acknowledgement, successor, or Stop barrier.
+        const { delegatedCompletion: _delegatedCompletion, ...runWithoutDelegatedCompletion } =
+          input.run;
+        const finalizedRun: OrchestrationV2Run = {
+          ...runWithoutDelegatedCompletion,
+          status: persistedStatus,
+          completedAt: input.terminal.status === "completed" ? null : completedAt,
+        };
+        const finalizedRootNode: OrchestrationV2ExecutionNode = {
+          ...input.rootNode,
+          status: persistedStatus,
+          completedAt: input.terminal.status === "completed" ? null : completedAt,
+          checkpointScopeId: input.checkpointScope.id,
+        };
+        const finalizedProviderThread: OrchestrationV2ProviderThread = {
+          ...input.providerThread,
+          status: finalProviderThreadStatus(input.terminal.threadDisposition),
+          updatedAt: completedAt,
+        };
+        const runEventId = yield* allocateEventId();
+        const nodeEventId = yield* allocateEventId();
+        const providerThreadEventId = yield* allocateEventId();
+        const checkpointCaptureCommandId = CommandId.make(
+          `command:effect:checkpoint.capture:${input.run.id}`,
+        );
+        yield* eventSink.writeWithEffects({
+          effects:
+            input.terminal.status === "completed"
+              ? [
+                  {
+                    id: `effect:checkpoint.capture:${input.run.id}`,
+                    commandId: checkpointCaptureCommandId,
+                    threadId: input.run.threadId,
+                    request: {
+                      type: "checkpoint.capture" as const,
+                      runId: input.run.id,
+                      scopeId: input.checkpointScope.id,
+                    },
+                  },
+                ]
+              : [],
+          events: [
+            // Terminalize open run-owned subagent rows before the root run
+            // settles so projections never keep a forever-running subagent card.
+            ...cascadedSubagentEvents,
+            ...(finalizedAttempt === null
+              ? []
+              : [
+                  {
+                    id: yield* allocateEventId(),
+                    type: "run-attempt.updated" as const,
+                    threadId: input.run.threadId,
+                    runId: input.run.id,
+                    nodeId: input.rootNode.id,
+                    providerInstanceId: input.run.providerInstanceId,
+                    occurredAt: completedAt,
+                    payload: finalizedAttempt,
+                  },
+                ]),
+            ...(input.terminal.status === "interrupted"
+              ? [
+                  {
+                    id: yield* allocateEventId(),
+                    type: "turn-item.updated" as const,
+                    threadId: input.run.threadId,
+                    runId: input.run.id,
+                    nodeId: input.rootNode.id,
+                    providerInstanceId: input.run.providerInstanceId,
+                    occurredAt: completedAt,
+                    payload: makeInterruptResultTurnItem({
+                      idAllocator,
+                      run: input.run,
+                      rootNode: input.rootNode,
+                      providerThread: input.providerThread,
+                      completedAt,
+                    }),
+                  },
+                ]
+              : []),
+            ...(input.terminal.status === "failed" && !input.failureItemPersisted
+              ? [
+                  {
+                    id: yield* allocateEventId(),
+                    type: "turn-item.updated" as const,
+                    threadId: input.run.threadId,
+                    runId: input.run.id,
+                    nodeId: input.rootNode.id,
+                    providerInstanceId: input.run.providerInstanceId,
+                    occurredAt: completedAt,
+                    payload: makeProviderFailureTurnItem({
+                      idAllocator,
+                      driver: input.terminal.driver,
+                      threadId: input.run.threadId,
+                      runId: input.run.id,
+                      nodeId: input.rootNode.id,
+                      providerThreadId: input.terminal.providerThreadId,
+                      providerTurnId: input.terminal.providerTurnId,
+                      itemOrdinal: input.terminal.failureItemOrdinal,
+                      failure: input.terminal.failure,
+                      occurredAt: completedAt,
+                    }),
+                  },
+                ]
+              : []),
+            {
+              id: runEventId,
+              type: "run.updated",
+              threadId: input.run.threadId,
+              runId: input.run.id,
+              nodeId: input.rootNode.id,
+              providerInstanceId: input.run.providerInstanceId,
+              occurredAt: completedAt,
+              payload: finalizedRun,
+            },
+            {
+              id: nodeEventId,
+              type: "node.updated",
+              threadId: input.run.threadId,
+              runId: input.run.id,
+              nodeId: input.rootNode.id,
+              providerInstanceId: input.run.providerInstanceId,
+              occurredAt: completedAt,
+              payload: finalizedRootNode,
+            },
+            {
+              id: providerThreadEventId,
+              type: "provider-thread.updated",
+              threadId: input.run.threadId,
+              providerInstanceId: input.run.providerInstanceId,
+              occurredAt: completedAt,
+              payload: finalizedProviderThread,
+            },
+          ],
+        });
+      });
+
+    return RunExecutionServiceV2.of({
+      startRootRun: (input) =>
+        Effect.gen(function* () {
+          const assistantStreamingEnabled = yield* serverSettings.getSettings.pipe(
+            Effect.map((settings) => settings.enableLegacyTokenStreaming),
+            Effect.mapError(
+              (cause) =>
+                new RunExecutionStartError({
+                  commandId: input.commandId,
+                  runId: input.run.id,
+                  cause,
+                }),
+            ),
+          );
+          yield* checkpointService
+            .captureBaseline({
+              scope: input.checkpointScope,
+              ordinalWithinScope: Math.max(0, input.run.ordinal - 1),
+            })
+            .pipe(
+              Effect.mapError(
+                (cause) =>
+                  new RunExecutionStartError({
+                    commandId: input.commandId,
+                    runId: input.run.id,
+                    cause,
+                  }),
+              ),
+            );
+          if (
+            input.shouldStartProviderTurn !== undefined &&
+            !(yield* input.shouldStartProviderTurn())
+          ) {
+            return;
+          }
+          const terminalEvent = yield* Ref.make<ProviderTerminalEvent | null>(null);
+          const makeFailedTerminalEvent = (
+            failure: OrchestrationV2ProviderFailure,
+            failureItemOrdinal: number,
+          ): ProviderTerminalEvent => ({
+            type: "turn.terminal",
+            driver: input.providerThread.driver,
+            providerThreadId: input.providerThread.id,
+            providerTurnId:
+              input.attempt.providerTurnId ??
+              idAllocator.derive.providerTurn({
+                driver: input.providerThread.driver,
+                nativeTurnId: `failed:${input.attempt.id}`,
+              }),
+            runOrdinal: input.run.ordinal,
+            failureItemOrdinal,
+            status: "failed",
+            failure,
+            threadDisposition: "reusable",
+          });
+          const latestTurnItemOrdinal = yield* Ref.make(input.providerTurnOrdinal * 100);
+          const latestProviderThread = yield* Ref.make(input.providerThread);
+          const routeIdentity: ProviderEventRouteIdentity = {
+            threadId: input.run.threadId,
+            runId: input.run.id,
+            attemptId: input.attempt.id,
+            providerThreadId: input.providerThread.id,
+          };
+          const eventSubscription =
+            input.session.subscribeEvents === undefined
+              ? { events: input.session.events, close: Effect.void }
+              : yield* input.session.subscribeEvents;
+          const inheritedBackgroundTurnItems = yield* (
+            input.loadInheritedBackgroundTurnItems?.() ?? Effect.succeed([])
+          ).pipe(
+            Effect.onError(() => eventSubscription.close),
+            Effect.mapError(
+              (cause) =>
+                new RunExecutionStartError({
+                  commandId: input.commandId,
+                  runId: input.run.id,
+                  cause,
+                }),
+            ),
+          );
+          const inheritedBackgroundTurnItemsById = new Map(
+            inheritedBackgroundTurnItems.map((item) => [item.id, item.runId]),
+          );
+          const eventRouting = yield* Ref.make<ProviderEventRoutingState>(
+            makeProviderEventRoutingState({
+              identity: routeIdentity,
+              inheritedBackgroundTurnItems,
+              providerTurnId: input.attempt.providerTurnId,
+              ...(input.relatedThreadIds === undefined
+                ? {}
+                : { relatedThreadIds: input.relatedThreadIds }),
+              ...(input.relatedProviderThreadIds === undefined
+                ? {}
+                : { relatedProviderThreadIds: input.relatedProviderThreadIds }),
+            }),
+          );
+          const rootTerminalSeen = yield* Ref.make(false);
+          const rootRunFinalized = yield* Ref.make(false);
+          const providerThreadOwnerLost = yield* Ref.make(false);
+          const activeChildProviderTurns = yield* Ref.make<ReadonlySet<ProviderTurnId>>(new Set());
+          const activeChildSubagents = yield* Ref.make<ReadonlySet<NodeId>>(new Set());
+          const activeBackgroundTurnItems = yield* Ref.make<
+            ReadonlySet<OrchestrationV2TurnItem["id"]>
+          >(new Set(inheritedBackgroundTurnItemsById.keys()));
+          const openRunOwnedSubagents = yield* Ref.make(emptyOpenRunOwnedSubagentProjection());
+          const finalizeRootRun = (terminal: ProviderTerminalEvent) =>
+            Effect.gen(function* () {
+              if (yield* Ref.get(rootRunFinalized)) {
+                return;
+              }
+              const providerThread = yield* Ref.get(latestProviderThread);
+              const openSubagents = yield* Ref.get(openRunOwnedSubagents);
+              yield* writeFinalRunEvents({
+                run: input.run,
+                rootNode: input.rootNode,
+                checkpointScope: input.checkpointScope,
+                providerThread,
+                attempt: input.attempt,
+                ...(input.shouldFinalizeRun === undefined
+                  ? {}
+                  : { shouldFinalizeRun: input.shouldFinalizeRun }),
+                ...(input.hasUnpairedRunInterruptRequest === undefined
+                  ? {}
+                  : {
+                      hasUnpairedRunInterruptRequest: input.hasUnpairedRunInterruptRequest,
+                    }),
+                openRunOwnedSubagents: openSubagents,
+                terminal,
+                failureItemPersisted: terminal.status === "failed",
+              }).pipe(
+                Effect.mapError(
+                  (cause) => new RunExecutionIngestError({ runId: input.run.id, cause }),
+                ),
+              );
+              if (isRunOwnedSubagentTerminalStatus(terminal.status)) {
+                yield* Ref.set(openRunOwnedSubagents, emptyOpenRunOwnedSubagentProjection());
+              }
+              yield* Ref.set(rootRunFinalized, true);
+            });
+          const trackChildLifecycle = (event: ProviderAdapterV2Event, deliverable: boolean) =>
+            Effect.gen(function* () {
+              const routing = yield* Ref.get(eventRouting);
+              if (event.type === "provider_turn.updated") {
+                const isRoot =
+                  event.providerTurn.runAttemptId === input.attempt.id ||
+                  event.providerTurn.id === routing.rootProviderTurnId;
+                if (!isRoot) {
+                  yield* Ref.update(activeChildProviderTurns, (current) => {
+                    const next = new Set(current);
+                    if (isTerminalProviderTurnStatus(event.providerTurn.status)) {
+                      next.delete(event.providerTurn.id);
+                    } else {
+                      next.add(event.providerTurn.id);
+                    }
+                    return next;
+                  });
+                }
+              }
+              if (event.type === "subagent.updated") {
+                const belongsToRootRun = event.subagent.runId === input.run.id;
+                const belongsToOwnedChildThread =
+                  event.subagent.threadId !== input.run.threadId &&
+                  routing.ownedThreadIds.has(event.subagent.threadId);
+                if (belongsToRootRun || belongsToOwnedChildThread) {
+                  yield* Ref.update(activeChildSubagents, (current) => {
+                    const next = new Set(current);
+                    if (isTerminalSubagentStatus(event.subagent.status)) {
+                      next.delete(event.subagent.id);
+                    } else {
+                      next.add(event.subagent.id);
+                    }
+                    return next;
+                  });
+                }
+                // Snapshot run-owned subagents for interrupt cascade.
+                // Preserve childThreadId linkage for the root-run lifetime even
+                // after the subagent row terminalizes, so open child-thread
+                // nodes can still be proven linked on a later root interrupt.
+                if (belongsToRootRun) {
+                  yield* Ref.update(openRunOwnedSubagents, (current) => {
+                    const withLink = withLinkedChildThreadId(current, event.subagent.childThreadId);
+                    const subagents = new Map(withLink.subagents);
+                    if (isTerminalSubagentStatus(event.subagent.status)) {
+                      subagents.delete(event.subagent.id);
+                    } else {
+                      subagents.set(event.subagent.id, event.subagent);
+                    }
+                    return { ...withLink, subagents };
+                  });
+                }
+              }
+              if (event.type === "node.updated") {
+                const belongsToRootSubagent =
+                  event.node.kind === "subagent" && event.node.runId === input.run.id;
+                const belongsToOwnedChildThread =
+                  event.node.threadId !== input.run.threadId &&
+                  routing.ownedThreadIds.has(event.node.threadId);
+                if (!belongsToRootSubagent && !belongsToOwnedChildThread) {
+                  return;
+                }
+                yield* Ref.update(openRunOwnedSubagents, (current) => {
+                  const nodes = new Map(current.nodes);
+                  if (isOpenExecutionNodeStatus(event.node.status)) {
+                    nodes.set(event.node.id, event.node);
+                  } else {
+                    nodes.delete(event.node.id);
+                  }
+                  return { ...current, nodes };
+                });
+              }
+              if (event.type === "turn_item.updated") {
+                const belongsToRootRun = event.turnItem.runId === input.run.id;
+                const belongsToOwnedChildThread =
+                  event.turnItem.threadId !== input.run.threadId &&
+                  routing.ownedThreadIds.has(event.turnItem.threadId);
+                const belongsToInheritedBackgroundItem =
+                  event.turnItem.threadId === input.run.threadId &&
+                  event.turnItem.runId !== null &&
+                  inheritedBackgroundTurnItemsById.get(event.turnItem.id) === event.turnItem.runId;
+                if (
+                  backgroundCapableTurnItemTypes.has(event.turnItem.type) &&
+                  (belongsToRootRun ||
+                    belongsToOwnedChildThread ||
+                    belongsToInheritedBackgroundItem)
+                ) {
+                  yield* Ref.update(activeBackgroundTurnItems, (current) => {
+                    const next = new Set(current);
+                    if (isTerminalTurnItemStatus(event.turnItem.status)) {
+                      next.delete(event.turnItem.id);
+                    } else {
+                      next.add(event.turnItem.id);
+                    }
+                    return next;
+                  });
+                }
+                if (belongsToOwnedChildThread && deliverable) {
+                  yield* Ref.update(openRunOwnedSubagents, (current) => {
+                    const childTurnItems = new Map(current.childTurnItems);
+                    if (isTerminalTurnItemStatus(event.turnItem.status)) {
+                      childTurnItems.delete(event.turnItem.id);
+                    } else {
+                      childTurnItems.set(event.turnItem.id, event.turnItem);
+                    }
+                    return { ...current, childTurnItems };
+                  });
+                }
+                if (belongsToRootRun && event.turnItem.type === "subagent") {
+                  const subagentItem = event.turnItem;
+                  yield* Ref.update(openRunOwnedSubagents, (current) => {
+                    const withLink = withLinkedChildThreadId(current, subagentItem.childThreadId);
+                    const turnItems = new Map(withLink.turnItems);
+                    if (isTerminalTurnItemStatus(subagentItem.status)) {
+                      turnItems.delete(subagentItem.subagentId);
+                    } else {
+                      turnItems.set(subagentItem.subagentId, subagentItem);
+                    }
+                    return { ...withLink, turnItems };
+                  });
+                }
+              }
+            });
+          const shouldStopProviderEventIngestion = Effect.gen(function* () {
+            if (!(yield* Ref.get(rootTerminalSeen))) {
+              return false;
+            }
+            const terminal = yield* Ref.get(terminalEvent);
+            // Non-completed terminals drop background tracking immediately.
+            if (terminal !== null && terminal.status !== "completed") {
+              return true;
+            }
+            const childProviderTurns = yield* Ref.get(activeChildProviderTurns);
+            if (childProviderTurns.size > 0) {
+              return false;
+            }
+            const childSubagents = yield* Ref.get(activeChildSubagents);
+            if (childSubagents.size > 0) {
+              return false;
+            }
+            // Keep ingesting past root settlement while background-capable
+            // items owned by this run (or an owned child thread) are still
+            // non-terminal, so their late completion events reach the
+            // projection (stuck-spinner fix). Only for completed runs:
+            // interrupted/failed turns intentionally drop background tracking
+            // rather than pinning the stream open. Newly owned items depend on
+            // adapters emitting a non-terminal event before the root terminal.
+            // Exact inherited items are seeded from their selected durable rows.
+            //
+            // Owner loss (a newer run claimed lastRunOrdinal) must not close
+            // this stream while these sets are non-empty: turn_item.updated
+            // writes are not ownership-gated, so late completions still land.
+            const backgroundItems = yield* Ref.get(activeBackgroundTurnItems);
+            if (backgroundItems.size > 0) {
+              return false;
+            }
+            // Owner loss means do not hold the stream open solely for the
+            // roster probe; once background sets are empty, release.
+            if (yield* Ref.get(providerThreadOwnerLost)) {
+              return true;
+            }
+            // Claude background Bash has no turn-item projection. Keep the
+            // stream open while this root's provider thread still reports
+            // pending roster work so late empty updates can clear Waiting.
+            // Use only the thread-scoped probe: session-wide pending work
+            // (siblings, wake buffers, session subagents) must not pin this
+            // root subscription. Session idle release still uses
+            // hasPendingBackgroundWork via ProviderSessionManager.
+            const latestProviderThreadSnapshot = yield* Ref.get(latestProviderThread);
+            if (input.session.hasPendingBackgroundWorkForThread !== undefined) {
+              const hasPendingWork = yield* input.session
+                .hasPendingBackgroundWorkForThread(latestProviderThreadSnapshot)
+                .pipe(Effect.catchCause(() => Effect.succeed(false)));
+              if (hasPendingWork) {
+                return false;
+              }
+            }
+            return true;
+          });
+          const providerEventFiber = yield* eventSubscription.events.pipe(
+            Stream.filterEffect((event) =>
+              Ref.modify(eventRouting, (state) => routeProviderEvent(event, routeIdentity, state)),
+            ),
+            Stream.tap((event) =>
+              Effect.gen(function* () {
+                let storedEventCount = 0;
+                const shouldDeliver = shouldDeliverProviderEvent(event, assistantStreamingEnabled);
+                if (shouldDeliver) {
+                  // Root provider_thread.updated always uses an ownership gate:
+                  // pre-terminal writeIfRunCurrent (attempt still running), or
+                  // post-terminal writeIfProviderThreadOwner so late roster
+                  // clears still land while this attempt owns the run and this
+                  // run owns lastRunOrdinal.
+                  const rootTerminalAlreadySeen = yield* Ref.get(rootTerminalSeen);
+                  const isRootProviderThreadUpdate =
+                    event.type === "provider_thread.updated" &&
+                    event.providerThread.id === input.providerThread.id;
+                  const storedEvents = yield* providerEventIngestor.ingestNormalized({
+                    providerSessionId: input.providerSessionId,
+                    providerInstanceId: input.run.providerInstanceId,
+                    threadId: input.run.threadId,
+                    runId: input.run.id,
+                    nodeId: input.rootNode.id,
+                    event,
+                    ...(isRootProviderThreadUpdate
+                      ? rootTerminalAlreadySeen
+                        ? {
+                            writeIfProviderThreadOwner: {
+                              providerThreadId: input.providerThread.id,
+                              runId: input.run.id,
+                              activeAttemptId: input.attempt.id,
+                              expectedLastRunOrdinal: input.run.ordinal,
+                            },
+                          }
+                        : {
+                            writeIfRunCurrent: {
+                              runId: input.run.id,
+                              activeAttemptId: input.attempt.id,
+                              expectedStatus: "running" as const,
+                            },
+                          }
+                      : {}),
+                  });
+                  storedEventCount = storedEvents.length;
+                  if (
+                    isRootProviderThreadUpdate &&
+                    rootTerminalAlreadySeen &&
+                    storedEventCount === 0
+                  ) {
+                    // Ownership lost (or thread row missing). Stop pinning the
+                    // stream on this run's background probe.
+                    yield* Ref.set(providerThreadOwnerLost, true);
+                  }
+                }
+                if (event.type === "provider_thread.updated") {
+                  if (event.providerThread.id === input.providerThread.id && storedEventCount > 0) {
+                    yield* Ref.set(latestProviderThread, event.providerThread);
+                  }
+                }
+                if (
+                  event.type === "turn_item.updated" &&
+                  event.turnItem.providerTurnId ===
+                    (yield* Ref.get(eventRouting)).rootProviderTurnId
+                ) {
+                  yield* Ref.update(latestTurnItemOrdinal, (current) =>
+                    Math.max(current, event.turnItem.ordinal),
+                  );
+                }
+                if (event.type === "turn.terminal") {
+                  yield* Ref.set(terminalEvent, event);
+                  yield* Ref.set(rootTerminalSeen, true);
+                  yield* finalizeRootRun(event);
+                }
+                yield* trackChildLifecycle(event, shouldDeliver);
+              }),
+            ),
+            Stream.takeUntilEffect(() => shouldStopProviderEventIngestion),
+            Stream.runDrain,
+            Effect.mapError((cause) => new RunExecutionIngestError({ runId: input.run.id, cause })),
+            Effect.flatMap(() =>
+              Effect.gen(function* () {
+                const terminal = yield* Ref.get(terminalEvent);
+                if (terminal === null) {
+                  return;
+                }
+                yield* finalizeRootRun(terminal);
+              }),
+            ),
+            Effect.catchCause((cause) =>
+              Ref.get(rootRunFinalized).pipe(
+                Effect.flatMap((finalized) =>
+                  Effect.logWarning("orchestration V2 provider event ingestion failed", {
+                    runId: input.run.id,
+                    cause,
+                  }).pipe(
+                    Effect.andThen(
+                      finalized
+                        ? Effect.void
+                        : Ref.get(latestProviderThread).pipe(
+                            Effect.flatMap((providerThread) =>
+                              Ref.get(latestTurnItemOrdinal).pipe(
+                                Effect.flatMap((latestItemOrdinal) =>
+                                  Ref.get(openRunOwnedSubagents).pipe(
+                                    Effect.flatMap((openSubagents) =>
+                                      writeFinalRunEvents({
+                                        run: input.run,
+                                        rootNode: input.rootNode,
+                                        checkpointScope: input.checkpointScope,
+                                        providerThread,
+                                        attempt: input.attempt,
+                                        ...(input.shouldFinalizeRun === undefined
+                                          ? {}
+                                          : { shouldFinalizeRun: input.shouldFinalizeRun }),
+                                        ...(input.hasUnpairedRunInterruptRequest === undefined
+                                          ? {}
+                                          : {
+                                              hasUnpairedRunInterruptRequest:
+                                                input.hasUnpairedRunInterruptRequest,
+                                            }),
+                                        openRunOwnedSubagents: openSubagents,
+                                        terminal: makeFailedTerminalEvent(
+                                          makeProviderFailure({
+                                            cause: Cause.squash(cause),
+                                            class: "unknown",
+                                          }),
+                                          latestItemOrdinal + 1,
+                                        ),
+                                        failureItemPersisted: false,
+                                      }),
+                                    ),
+                                  ),
+                                ),
+                              ),
+                            ),
+                          ),
+                    ),
+                    Effect.mapError(
+                      (writeCause) =>
+                        new RunExecutionIngestError({
+                          runId: input.run.id,
+                          cause: { ingest: cause, write: writeCause },
+                        }),
+                    ),
+                  ),
+                ),
+              ),
+            ),
+            Effect.ensuring(eventSubscription.close),
+            Effect.forkDetach,
+          );
+
+          if (
+            input.shouldStartProviderTurn !== undefined &&
+            !(yield* input.shouldStartProviderTurn())
+          ) {
+            yield* Fiber.interrupt(providerEventFiber);
+            return;
+          }
+
+          // A provider turn is a sign that the session is still alive. Keep
+          // its already-issued MCP credential valid even when the agent goes
+          // a long time between browser-tool calls.
+          yield* McpSessionRegistry.touchActiveMcpThread(input.run.threadId);
+          yield* input.session
+            .startTurn({
+              appThread: input.appThread,
+              threadId: input.run.threadId,
+              runId: input.run.id,
+              runOrdinal: input.run.ordinal,
+              providerTurnOrdinal: input.providerTurnOrdinal,
+              attemptId: input.attemptId,
+              rootNodeId: input.rootNode.id,
+              providerThread: input.providerThread,
+              message: input.message,
+              modelSelection: input.modelSelection,
+              runtimePolicy: input.runtimePolicy,
+            })
+            .pipe(
+              Effect.catchCause((cause) =>
+                Effect.logError("orchestration V2 provider turn start failed", {
+                  runId: input.run.id,
+                  cause,
+                }).pipe(
+                  Effect.andThen(Fiber.interrupt(providerEventFiber)),
+                  Effect.andThen(Ref.get(latestProviderThread)),
+                  Effect.flatMap((providerThread) =>
+                    Ref.get(latestTurnItemOrdinal).pipe(
+                      Effect.flatMap((latestItemOrdinal) =>
+                        Ref.get(openRunOwnedSubagents).pipe(
+                          Effect.flatMap((openSubagents) =>
+                            writeFinalRunEvents({
+                              run: input.run,
+                              rootNode: input.rootNode,
+                              checkpointScope: input.checkpointScope,
+                              providerThread,
+                              attempt: input.attempt,
+                              ...(input.shouldFinalizeRun === undefined
+                                ? {}
+                                : { shouldFinalizeRun: input.shouldFinalizeRun }),
+                              ...(input.hasUnpairedRunInterruptRequest === undefined
+                                ? {}
+                                : {
+                                    hasUnpairedRunInterruptRequest:
+                                      input.hasUnpairedRunInterruptRequest,
+                                  }),
+                              openRunOwnedSubagents: openSubagents,
+                              terminal: makeFailedTerminalEvent(
+                                makeProviderFailure({
+                                  cause: Cause.squash(cause),
+                                  class: "provider_error",
+                                }),
+                                latestItemOrdinal + 1,
+                              ),
+                              failureItemPersisted: false,
+                            }),
+                          ),
+                        ),
+                      ),
+                    ),
+                  ),
+                  Effect.mapError(
+                    (writeCause) =>
+                      new RunExecutionStartError({
+                        commandId: input.commandId,
+                        runId: input.run.id,
+                        cause: { start: cause, write: writeCause },
+                      }),
+                  ),
+                ),
+              ),
+            );
+        }),
+    } satisfies RunExecutionServiceV2Shape);
+  }),
+);
+
+function makeInterruptResultTurnItem(input: {
+  readonly idAllocator: IdAllocatorV2Shape;
+  readonly run: OrchestrationV2Run;
+  readonly rootNode: OrchestrationV2ExecutionNode;
+  readonly providerThread: OrchestrationV2ProviderThread;
+  readonly completedAt: DateTime.Utc;
+}): OrchestrationV2TurnItem {
+  return {
+    id: input.idAllocator.derive.runSignalTurnItem({
+      runId: input.run.id,
+      signal: "interrupt-result",
+    }),
+    threadId: input.run.threadId,
+    runId: input.run.id,
+    nodeId: input.rootNode.id,
+    providerThreadId: input.providerThread.id,
+    providerTurnId: input.rootNode.providerTurnId,
+    nativeItemRef: null,
+    parentItemId: input.idAllocator.derive.runSignalTurnItem({
+      runId: input.run.id,
+      signal: "interrupt-request",
+    }),
+    ordinal: input.run.ordinal * 100 + 98,
+    status: "interrupted",
+    title: "Interrupted",
+    startedAt: input.completedAt,
+    completedAt: input.completedAt,
+    updatedAt: input.completedAt,
+    type: "run_interrupt_result",
+    message: "Run interrupted by user",
+  };
+}
diff --git a/apps/server/src/orchestration-v2/RunFinalizationService.test.ts b/apps/server/src/orchestration-v2/RunFinalizationService.test.ts
new file mode 100644
index 000000000000..48d2b81c9ede
--- /dev/null
+++ b/apps/server/src/orchestration-v2/RunFinalizationService.test.ts
@@ -0,0 +1,41 @@
+import { assert, it, vi } from "@effect/vitest";
+import {
+  CheckpointScopeId,
+  RunId,
+  ThreadId,
+  type OrchestrationV2ThreadProjection,
+} from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+
+import * as CheckpointCapture from "./CheckpointCaptureService.ts";
+import * as ProjectionStore from "./ProjectionStore.ts";
+import * as RunFinalization from "./RunFinalizationService.ts";
+
+it.effect("captures the root checkpoint and refreshes workspace state", () => {
+  const threadId = ThreadId.make("thread_finalize");
+  const runId = RunId.make("run_finalize");
+  const scopeId = CheckpointScopeId.make("scope_finalize");
+  const capture = vi.fn(() => Effect.void);
+  const refresh = vi.fn(() => Effect.void);
+  const projection = {
+    checkpointScopes: [{ id: scopeId, cwd: "/repo" }],
+  } as unknown as OrchestrationV2ThreadProjection;
+  const layer = RunFinalization.layer.pipe(
+    Layer.provide(
+      Layer.mergeAll(
+        Layer.mock(CheckpointCapture.CheckpointCaptureServiceV2)({ execute: capture }),
+        Layer.mock(ProjectionStore.ProjectionStoreV2)({
+          getThreadProjection: () => Effect.succeed(projection),
+        }),
+        Layer.succeed(RunFinalization.RunFinalizationObserver, { refresh }),
+      ),
+    ),
+  );
+  return Effect.gen(function* () {
+    const service = yield* RunFinalization.RunFinalizationService;
+    yield* service.finalize({ threadId, runId, scopeId });
+    assert.equal(capture.mock.calls.length, 1);
+    assert.deepEqual(refresh.mock.calls[0], ["/repo"]);
+  }).pipe(Effect.provide(layer));
+});
diff --git a/apps/server/src/orchestration-v2/RunFinalizationService.ts b/apps/server/src/orchestration-v2/RunFinalizationService.ts
new file mode 100644
index 000000000000..1d0b8261876a
--- /dev/null
+++ b/apps/server/src/orchestration-v2/RunFinalizationService.ts
@@ -0,0 +1,97 @@
+import { CheckpointScopeId, RunId, ThreadId } from "@t3tools/contracts";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Schema from "effect/Schema";
+
+import * as VcsStatusBroadcaster from "../vcs/VcsStatusBroadcaster.ts";
+import * as WorkspaceEntries from "../workspace/WorkspaceEntries.ts";
+import * as CheckpointCapture from "./CheckpointCaptureService.ts";
+import * as ProjectionStore from "./ProjectionStore.ts";
+
+export class RunFinalizationError extends Schema.TaggedErrorClass<RunFinalizationError>()(
+  "RunFinalizationError",
+  {
+    threadId: ThreadId,
+    runId: RunId,
+    scopeId: CheckpointScopeId,
+    operation: Schema.Literals(["capture-checkpoint", "refresh-workspace"]),
+    cause: Schema.Defect(),
+  },
+) {}
+
+export class RunFinalizationRefreshError extends Schema.TaggedErrorClass<RunFinalizationRefreshError>()(
+  "RunFinalizationRefreshError",
+  { cwd: Schema.String, cause: Schema.Defect() },
+) {}
+
+export class RunFinalizationObserver extends Context.Reference<{
+  readonly refresh: (cwd: string) => Effect.Effect<void, RunFinalizationRefreshError>;
+}>("t3/orchestration-v2/RunFinalizationObserver", {
+  defaultValue: () => ({ refresh: () => Effect.void }),
+}) {}
+
+export class RunFinalizationService extends Context.Service<
+  RunFinalizationService,
+  {
+    readonly finalize: (input: {
+      readonly threadId: ThreadId;
+      readonly runId: RunId;
+      readonly scopeId: CheckpointScopeId;
+    }) => Effect.Effect<void, RunFinalizationError>;
+  }
+>()("t3/orchestration-v2/RunFinalizationService") {}
+
+export const make = Effect.gen(function* () {
+  const checkpointCapture = yield* CheckpointCapture.CheckpointCaptureServiceV2;
+  const projections = yield* ProjectionStore.ProjectionStoreV2;
+  const observer = yield* RunFinalizationObserver;
+
+  const finalize: RunFinalizationService["Service"]["finalize"] = Effect.fn(
+    "RunFinalizationService.finalize",
+  )(function* (input) {
+    yield* checkpointCapture
+      .execute(input)
+      .pipe(
+        Effect.mapError(
+          (cause) => new RunFinalizationError({ ...input, operation: "capture-checkpoint", cause }),
+        ),
+      );
+    const projection = yield* projections
+      .getThreadProjection(input.threadId)
+      .pipe(
+        Effect.mapError(
+          (cause) => new RunFinalizationError({ ...input, operation: "refresh-workspace", cause }),
+        ),
+      );
+    const cwd = projection.checkpointScopes.find((scope) => scope.id === input.scopeId)?.cwd;
+    if (cwd !== undefined) {
+      yield* observer
+        .refresh(cwd)
+        .pipe(
+          Effect.mapError(
+            (cause) =>
+              new RunFinalizationError({ ...input, operation: "refresh-workspace", cause }),
+          ),
+        );
+    }
+  });
+  return RunFinalizationService.of({ finalize });
+});
+
+export const layer = Layer.effect(RunFinalizationService, make);
+
+export const observerLive = Layer.effect(
+  RunFinalizationObserver,
+  Effect.gen(function* () {
+    const workspaceEntries = yield* WorkspaceEntries.WorkspaceEntries;
+    const vcsStatus = yield* VcsStatusBroadcaster.VcsStatusBroadcaster;
+    return {
+      refresh: (cwd: string) =>
+        Effect.all([workspaceEntries.refresh(cwd), vcsStatus.refreshStatus(cwd)], {
+          discard: true,
+          concurrency: "unbounded",
+        }).pipe(Effect.mapError((cause) => new RunFinalizationRefreshError({ cwd, cause }))),
+    };
+  }),
+);
diff --git a/apps/server/src/orchestration-v2/RuntimePolicy.test.ts b/apps/server/src/orchestration-v2/RuntimePolicy.test.ts
new file mode 100644
index 000000000000..349b4492b91a
--- /dev/null
+++ b/apps/server/src/orchestration-v2/RuntimePolicy.test.ts
@@ -0,0 +1,103 @@
+import { assert, it } from "@effect/vitest";
+import {
+  type ModelSelection,
+  type OrchestrationV2AppThread,
+  ProjectId,
+  ProviderInstanceId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+
+import * as ProjectionProjects from "../persistence/Services/ProjectionProjects.ts";
+import { layerFromProjectRepository, RuntimePolicyV2 } from "./RuntimePolicy.ts";
+
+const projectId = ProjectId.make("project:runtime-policy");
+const providerInstanceId = ProviderInstanceId.make("codex");
+const modelSelection = {
+  instanceId: providerInstanceId,
+  model: "gpt-5.5",
+} satisfies ModelSelection;
+
+function makeThread(input: {
+  readonly now: DateTime.Utc;
+  readonly worktreePath: string | null;
+}): OrchestrationV2AppThread {
+  const threadId = ThreadId.make("thread:runtime-policy");
+  return {
+    createdBy: "user",
+    creationSource: "web",
+    id: threadId,
+    projectId,
+    title: "Runtime policy",
+    providerInstanceId,
+    modelSelection,
+    runtimeMode: "full-access",
+    interactionMode: "default",
+    branch: null,
+    worktreePath: input.worktreePath,
+    activeProviderThreadId: null,
+    lineage: {
+      parentThreadId: null,
+      relationshipToParent: null,
+      rootThreadId: threadId,
+    },
+    forkedFrom: null,
+    createdAt: input.now,
+    updatedAt: input.now,
+    archivedAt: null,
+    settledOverride: null,
+    settledAt: null,
+    lastVisitedAt: null,
+    deletedAt: null,
+  };
+}
+
+const TestLayer = layerFromProjectRepository.pipe(
+  Layer.provide(
+    Layer.mock(ProjectionProjects.ProjectionProjectRepository)({
+      getById: () =>
+        Effect.succeed(
+          Option.some({
+            projectId,
+            title: "Project",
+            workspaceRoot: "/project-root",
+            defaultModelSelection: null,
+            defaultThreadEnvMode: null,
+            scripts: [],
+            createdAt: "2026-06-21T00:00:00.000Z",
+            updatedAt: "2026-06-21T00:00:00.000Z",
+            deletedAt: null,
+          }),
+        ),
+    }),
+  ),
+);
+
+it.layer(TestLayer)("RuntimePolicyV2", (it) => {
+  it.effect("uses the project root for local-checkout threads", () =>
+    Effect.gen(function* () {
+      const policy = yield* RuntimePolicyV2;
+      const now = yield* DateTime.now;
+      const resolved = yield* policy.resolve({
+        thread: makeThread({ now, worktreePath: null }),
+        modelSelection,
+      });
+      assert.equal(resolved.cwd, "/project-root");
+    }),
+  );
+
+  it.effect("prefers a provisioned worktree over the project root", () =>
+    Effect.gen(function* () {
+      const policy = yield* RuntimePolicyV2;
+      const now = yield* DateTime.now;
+      const resolved = yield* policy.resolve({
+        thread: makeThread({ now, worktreePath: "/project-worktree" }),
+        modelSelection,
+      });
+      assert.equal(resolved.cwd, "/project-worktree");
+    }),
+  );
+});
diff --git a/apps/server/src/orchestration-v2/RuntimePolicy.ts b/apps/server/src/orchestration-v2/RuntimePolicy.ts
new file mode 100644
index 000000000000..06bbeae6d7a0
--- /dev/null
+++ b/apps/server/src/orchestration-v2/RuntimePolicy.ts
@@ -0,0 +1,146 @@
+import {
+  ModelSelection,
+  OrchestrationV2AppThread,
+  ProjectId,
+  ProviderInstanceId,
+} from "@t3tools/contracts";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Schema from "effect/Schema";
+
+import * as ProjectionProjects from "../persistence/Services/ProjectionProjects.ts";
+import {
+  ProviderAdapterV2RuntimePolicy,
+  type ProviderAdapterV2RuntimePolicy as ProviderAdapterV2RuntimePolicyType,
+} from "./ProviderAdapter.ts";
+
+/**
+ * ERRORS
+ */
+export class RuntimePolicyResolveError extends Schema.TaggedErrorClass<RuntimePolicyResolveError>()(
+  "RuntimePolicyResolveError",
+  {
+    projectId: ProjectId,
+    providerInstanceId: ProviderInstanceId,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to resolve runtime policy for provider instance ${this.providerInstanceId} in project ${this.projectId}.`;
+  }
+}
+
+export const RuntimePolicyV2Error = Schema.Union([RuntimePolicyResolveError]);
+export type RuntimePolicyV2Error = typeof RuntimePolicyV2Error.Type;
+
+export const RuntimePolicyV2Override = Schema.Struct({
+  cwd: Schema.optional(Schema.String),
+  approvalPolicy: Schema.optional(Schema.Unknown),
+  sandboxPolicy: Schema.optional(Schema.Unknown),
+  reasoningEffort: Schema.optional(Schema.String),
+});
+export type RuntimePolicyV2Override = typeof RuntimePolicyV2Override.Type;
+
+/**
+ * SERVICE DEFINITION
+ */
+export interface RuntimePolicyV2Shape {
+  readonly resolve: (input: {
+    readonly thread: OrchestrationV2AppThread;
+    readonly modelSelection: ModelSelection;
+  }) => Effect.Effect<ProviderAdapterV2RuntimePolicyType, RuntimePolicyV2Error>;
+}
+
+export class RuntimePolicyV2 extends Context.Service<RuntimePolicyV2, RuntimePolicyV2Shape>()(
+  "t3/orchestration-v2/RuntimePolicy/RuntimePolicyV2",
+) {}
+
+/**
+ * IMPLEMENTATIONS
+ */
+export const layer: Layer.Layer<RuntimePolicyV2> = Layer.succeed(RuntimePolicyV2, {
+  resolve: (input) =>
+    Effect.succeed({
+      runtimeMode: input.thread.runtimeMode,
+      interactionMode: input.thread.interactionMode,
+      cwd: input.thread.worktreePath,
+    }),
+});
+
+export const layerFromProjectRepository: Layer.Layer<
+  RuntimePolicyV2,
+  never,
+  ProjectionProjects.ProjectionProjectRepository
+> = Layer.effect(
+  RuntimePolicyV2,
+  Effect.gen(function* () {
+    const projects = yield* ProjectionProjects.ProjectionProjectRepository;
+    return RuntimePolicyV2.of({
+      resolve: Effect.fn("RuntimePolicyV2.resolve")(function* (input) {
+        const cwd =
+          input.thread.worktreePath ??
+          (yield* projects.getById({ projectId: input.thread.projectId }).pipe(
+            Effect.mapError(
+              (cause) =>
+                new RuntimePolicyResolveError({
+                  projectId: input.thread.projectId,
+                  providerInstanceId: input.modelSelection.instanceId,
+                  cause,
+                }),
+            ),
+            Effect.flatMap(
+              Option.match({
+                onNone: () =>
+                  Effect.fail(
+                    new RuntimePolicyResolveError({
+                      projectId: input.thread.projectId,
+                      providerInstanceId: input.modelSelection.instanceId,
+                      cause: "Project not found.",
+                    }),
+                  ),
+                onSome: (project) => Effect.succeed(project.workspaceRoot),
+              }),
+            ),
+          ));
+        return ProviderAdapterV2RuntimePolicy.make({
+          runtimeMode: input.thread.runtimeMode,
+          interactionMode: input.thread.interactionMode,
+          cwd,
+        });
+      }),
+    });
+  }),
+);
+
+export function layerWithOverride(
+  override: RuntimePolicyV2Override,
+): Layer.Layer<RuntimePolicyV2, never, RuntimePolicyV2> {
+  return Layer.effect(
+    RuntimePolicyV2,
+    Effect.gen(function* () {
+      const base = yield* RuntimePolicyV2;
+      return {
+        resolve: (input) =>
+          base.resolve(input).pipe(
+            Effect.map((policy) =>
+              ProviderAdapterV2RuntimePolicy.make({
+                ...policy,
+                ...(override.cwd === undefined ? {} : { cwd: override.cwd }),
+                ...(override.approvalPolicy === undefined
+                  ? {}
+                  : { approvalPolicy: override.approvalPolicy }),
+                ...(override.sandboxPolicy === undefined
+                  ? {}
+                  : { sandboxPolicy: override.sandboxPolicy }),
+                ...(override.reasoningEffort === undefined
+                  ? {}
+                  : { reasoningEffort: override.reasoningEffort }),
+              }),
+            ),
+          ),
+      } satisfies RuntimePolicyV2Shape;
+    }),
+  );
+}
diff --git a/apps/server/src/orchestration-v2/RuntimeRequestService.test.ts b/apps/server/src/orchestration-v2/RuntimeRequestService.test.ts
new file mode 100644
index 000000000000..ba5735d8be51
--- /dev/null
+++ b/apps/server/src/orchestration-v2/RuntimeRequestService.test.ts
@@ -0,0 +1,298 @@
+import { assert, it, vi } from "@effect/vitest";
+import {
+  NodeId,
+  ProviderSessionId,
+  RuntimeRequestId,
+  ThreadId,
+  type OrchestrationV2RuntimeRequest,
+  type OrchestrationV2ThreadProjection,
+} from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+
+import type { ProviderAdapterV2RuntimeRequestResponseInput } from "./ProviderAdapter.ts";
+import { ProjectionStoreV2 } from "./ProjectionStore.ts";
+import {
+  ProviderSessionLookupError,
+  ProviderSessionManagerV2,
+  type ProviderSessionManagerV2Shape,
+} from "./ProviderSessionManager.ts";
+import {
+  layer as runtimeRequestServiceLayer,
+  RuntimeRequestResponseExecutionError,
+  RuntimeRequestServiceV2,
+} from "./RuntimeRequestService.ts";
+
+function projectionWithRuntimeRequest(
+  runtimeRequest?: OrchestrationV2RuntimeRequest,
+): OrchestrationV2ThreadProjection {
+  return {
+    runtimeRequests: runtimeRequest === undefined ? [] : [runtimeRequest],
+  } as unknown as OrchestrationV2ThreadProjection;
+}
+
+function resolvedRuntimeRequest(
+  requestId: RuntimeRequestId,
+  providerSessionId: ProviderSessionId,
+): OrchestrationV2RuntimeRequest {
+  return {
+    id: requestId,
+    nodeId: NodeId.make(`node-${requestId}`),
+    providerTurnId: null,
+    nativeRequestRef: null,
+    kind: "command",
+    status: "resolved",
+    responseCapability: {
+      type: "live",
+      providerSessionId,
+    },
+    createdAt: DateTime.makeUnsafe("2026-07-29T00:00:00.000Z"),
+    resolvedAt: DateTime.makeUnsafe("2026-07-29T00:00:01.000Z"),
+  };
+}
+
+function runtimeRequestTestLayer(
+  projection: OrchestrationV2ThreadProjection,
+  getSession: ProviderSessionManagerV2Shape["get"],
+) {
+  return runtimeRequestServiceLayer.pipe(
+    Layer.provide(
+      Layer.mergeAll(
+        Layer.mock(ProjectionStoreV2)({
+          getThreadProjection: () => Effect.succeed(projection),
+        }),
+        Layer.mock(ProviderSessionManagerV2)({
+          get: getSession,
+        }),
+      ),
+    ),
+  );
+}
+
+it.effect("forwards orchestrator-resolved runtime requests to the live adapter", () => {
+  const threadId = ThreadId.make("thread-runtime-request-resolved");
+  const providerSessionId = ProviderSessionId.make("provider-session-runtime-request-resolved");
+  const requestId = RuntimeRequestId.make("request-resolved");
+  const respondToRuntimeRequest = vi.fn(
+    (_input: ProviderAdapterV2RuntimeRequestResponseInput) => Effect.void,
+  );
+  const getSession = vi.fn(() =>
+    Effect.succeed(
+      Option.some({
+        respondToRuntimeRequest,
+      } as never),
+    ),
+  );
+  const projection = {
+    runtimeRequests: [
+      {
+        id: requestId,
+        nodeId: NodeId.make("node-runtime-request-resolved"),
+        providerTurnId: null,
+        nativeRequestRef: null,
+        kind: "command",
+        status: "resolved",
+        responseCapability: {
+          type: "live",
+          providerSessionId,
+        },
+        createdAt: DateTime.makeUnsafe("2026-07-29T00:00:00.000Z"),
+        resolvedAt: DateTime.makeUnsafe("2026-07-29T00:00:01.000Z"),
+      },
+    ],
+  } as unknown as OrchestrationV2ThreadProjection;
+  const testLayer = runtimeRequestServiceLayer.pipe(
+    Layer.provide(
+      Layer.mergeAll(
+        Layer.mock(ProjectionStoreV2)({
+          getThreadProjection: () => Effect.succeed(projection),
+        }),
+        Layer.mock(ProviderSessionManagerV2)({
+          get: getSession,
+        }),
+      ),
+    ),
+  );
+
+  return Effect.gen(function* () {
+    const service = yield* RuntimeRequestServiceV2;
+    yield* service.respond({
+      threadId,
+      providerSessionId,
+      requestId,
+      decision: "accept",
+    });
+
+    assert.equal(getSession.mock.calls.length, 1);
+    assert.equal(respondToRuntimeRequest.mock.calls.length, 1);
+    assert.deepEqual(respondToRuntimeRequest.mock.calls[0]?.[0], {
+      requestId,
+      decision: "accept",
+    });
+  }).pipe(Effect.provide(testLayer));
+});
+
+it.effect("rejects expired runtime requests before invoking the live adapter", () => {
+  const threadId = ThreadId.make("thread-runtime-request-expired");
+  const providerSessionId = ProviderSessionId.make("provider-session-runtime-request-expired");
+  const requestId = RuntimeRequestId.make("request-expired");
+  const respondToRuntimeRequest = vi.fn(
+    (_input: ProviderAdapterV2RuntimeRequestResponseInput) => Effect.void,
+  );
+  const getSession = vi.fn(() =>
+    Effect.succeed(
+      Option.some({
+        respondToRuntimeRequest,
+      } as never),
+    ),
+  );
+  const projection = {
+    runtimeRequests: [
+      {
+        id: requestId,
+        nodeId: NodeId.make("node-runtime-request-expired"),
+        providerTurnId: null,
+        nativeRequestRef: null,
+        kind: "command",
+        status: "expired",
+        responseCapability: {
+          type: "live",
+          providerSessionId,
+        },
+        createdAt: DateTime.makeUnsafe("2026-07-29T00:00:00.000Z"),
+        resolvedAt: DateTime.makeUnsafe("2026-07-29T00:00:01.000Z"),
+      },
+    ],
+  } as unknown as OrchestrationV2ThreadProjection;
+  const testLayer = runtimeRequestServiceLayer.pipe(
+    Layer.provide(
+      Layer.mergeAll(
+        Layer.mock(ProjectionStoreV2)({
+          getThreadProjection: () => Effect.succeed(projection),
+        }),
+        Layer.mock(ProviderSessionManagerV2)({
+          get: getSession,
+        }),
+      ),
+    ),
+  );
+
+  return Effect.gen(function* () {
+    const service = yield* RuntimeRequestServiceV2;
+    const error = yield* service
+      .respond({
+        threadId,
+        providerSessionId,
+        requestId,
+        decision: "accept",
+      })
+      .pipe(Effect.flip);
+
+    assert.equal(error.reason, "request-not-ready");
+    assert.equal(
+      error.message,
+      `Runtime request ${requestId} on thread ${threadId} is not ready for response execution.`,
+    );
+    assert.isUndefined(error.cause);
+    assert.equal(getSession.mock.calls.length, 0);
+    assert.equal(respondToRuntimeRequest.mock.calls.length, 0);
+  }).pipe(Effect.provide(testLayer));
+});
+
+it.effect("classifies runtime request response validation failures", () => {
+  const threadId = ThreadId.make("thread-runtime-request-validation");
+  const providerSessionId = ProviderSessionId.make("provider-session-runtime-request-validation");
+  const otherProviderSessionId = ProviderSessionId.make(
+    "provider-session-runtime-request-validation-other",
+  );
+  const requestId = RuntimeRequestId.make("request-validation");
+  const unexpectedGetSession = vi.fn(() => Effect.succeed(Option.none()));
+  const missingLayer = runtimeRequestTestLayer(
+    projectionWithRuntimeRequest(),
+    unexpectedGetSession,
+  );
+  const notResumableLayer = runtimeRequestTestLayer(
+    projectionWithRuntimeRequest(resolvedRuntimeRequest(requestId, otherProviderSessionId)),
+    unexpectedGetSession,
+  );
+  const inactiveLayer = runtimeRequestTestLayer(
+    projectionWithRuntimeRequest(resolvedRuntimeRequest(requestId, providerSessionId)),
+    () => Effect.succeed(Option.none()),
+  );
+  const respond = Effect.gen(function* () {
+    const service = yield* RuntimeRequestServiceV2;
+    return yield* service
+      .respond({
+        threadId,
+        providerSessionId,
+        requestId,
+        decision: "accept",
+      })
+      .pipe(Effect.flip);
+  });
+
+  return Effect.gen(function* () {
+    const missing = yield* respond.pipe(Effect.provide(missingLayer));
+    assert.equal(missing.reason, "request-missing");
+    assert.equal(
+      missing.message,
+      `Runtime request ${requestId} no longer exists on thread ${threadId}.`,
+    );
+    assert.isUndefined(missing.cause);
+
+    const notResumable = yield* respond.pipe(Effect.provide(notResumableLayer));
+    assert.equal(notResumable.reason, "request-not-resumable");
+    assert.equal(
+      notResumable.message,
+      `Runtime request ${requestId} on thread ${threadId} is not resumable on provider session ${providerSessionId}.`,
+    );
+    assert.isUndefined(notResumable.cause);
+
+    const inactive = yield* respond.pipe(Effect.provide(inactiveLayer));
+    assert.equal(inactive.reason, "provider-session-not-active");
+    assert.equal(
+      inactive.message,
+      `Provider session ${providerSessionId} is not active for runtime request ${requestId} on thread ${threadId}.`,
+    );
+    assert.isUndefined(inactive.cause);
+    assert.equal(unexpectedGetSession.mock.calls.length, 0);
+  });
+});
+
+it.effect("preserves genuine provider session lookup failures as the cause", () => {
+  const threadId = ThreadId.make("thread-runtime-request-lookup-failure");
+  const providerSessionId = ProviderSessionId.make(
+    "provider-session-runtime-request-lookup-failure",
+  );
+  const requestId = RuntimeRequestId.make("request-lookup-failure");
+  const lookupFailure = new ProviderSessionLookupError({
+    providerSessionId,
+    cause: "lookup failed",
+  });
+  const testLayer = runtimeRequestTestLayer(
+    projectionWithRuntimeRequest(resolvedRuntimeRequest(requestId, providerSessionId)),
+    () => Effect.fail(lookupFailure),
+  );
+
+  return Effect.gen(function* () {
+    const service = yield* RuntimeRequestServiceV2;
+    const error = yield* service
+      .respond({
+        threadId,
+        providerSessionId,
+        requestId,
+        decision: "accept",
+      })
+      .pipe(Effect.flip);
+
+    assert.instanceOf(error, RuntimeRequestResponseExecutionError);
+    assert.equal(error.reason, "unexpected-failure");
+    assert.equal(
+      error.message,
+      `Failed to respond to runtime request ${requestId} on thread ${threadId} via provider session ${providerSessionId}.`,
+    );
+    assert.strictEqual(error.cause, lookupFailure);
+  }).pipe(Effect.provide(testLayer));
+});
diff --git a/apps/server/src/orchestration-v2/RuntimeRequestService.ts b/apps/server/src/orchestration-v2/RuntimeRequestService.ts
new file mode 100644
index 000000000000..214db5fd2f2e
--- /dev/null
+++ b/apps/server/src/orchestration-v2/RuntimeRequestService.ts
@@ -0,0 +1,141 @@
+import {
+  ProviderApprovalDecision,
+  ProviderSessionId,
+  ProviderUserInputAnswers,
+  RuntimeRequestId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Schema from "effect/Schema";
+
+import { ProjectionStoreV2 } from "./ProjectionStore.ts";
+import { ProviderSessionManagerV2 } from "./ProviderSessionManager.ts";
+
+export class RuntimeRequestResponseExecutionError extends Schema.TaggedErrorClass<RuntimeRequestResponseExecutionError>()(
+  "RuntimeRequestResponseExecutionError",
+  {
+    reason: Schema.Literals([
+      "request-missing",
+      "request-not-ready",
+      "request-not-resumable",
+      "provider-session-not-active",
+      "unexpected-failure",
+    ]),
+    threadId: ThreadId,
+    providerSessionId: ProviderSessionId,
+    requestId: RuntimeRequestId,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    switch (this.reason) {
+      case "request-missing":
+        return `Runtime request ${this.requestId} no longer exists on thread ${this.threadId}.`;
+      case "request-not-ready":
+        return `Runtime request ${this.requestId} on thread ${this.threadId} is not ready for response execution.`;
+      case "request-not-resumable":
+        return `Runtime request ${this.requestId} on thread ${this.threadId} is not resumable on provider session ${this.providerSessionId}.`;
+      case "provider-session-not-active":
+        return `Provider session ${this.providerSessionId} is not active for runtime request ${this.requestId} on thread ${this.threadId}.`;
+      case "unexpected-failure":
+        return `Failed to respond to runtime request ${this.requestId} on thread ${this.threadId} via provider session ${this.providerSessionId}.`;
+    }
+  }
+}
+
+const isRuntimeRequestResponseExecutionError = Schema.is(RuntimeRequestResponseExecutionError);
+
+export interface RuntimeRequestServiceV2Shape {
+  readonly respond: (input: {
+    readonly threadId: ThreadId;
+    readonly providerSessionId: ProviderSessionId;
+    readonly requestId: RuntimeRequestId;
+    readonly decision?: ProviderApprovalDecision;
+    readonly answers?: ProviderUserInputAnswers;
+  }) => Effect.Effect<void, RuntimeRequestResponseExecutionError>;
+}
+
+export class RuntimeRequestServiceV2 extends Context.Service<
+  RuntimeRequestServiceV2,
+  RuntimeRequestServiceV2Shape
+>()("t3/orchestration-v2/RuntimeRequestService/RuntimeRequestServiceV2") {}
+
+export const layer: Layer.Layer<
+  RuntimeRequestServiceV2,
+  never,
+  ProjectionStoreV2 | ProviderSessionManagerV2
+> = Layer.effect(
+  RuntimeRequestServiceV2,
+  Effect.gen(function* () {
+    const projections = yield* ProjectionStoreV2;
+    const sessions = yield* ProviderSessionManagerV2;
+
+    return RuntimeRequestServiceV2.of({
+      respond: (input) =>
+        Effect.gen(function* () {
+          const projection = yield* projections.getThreadProjection(input.threadId);
+          const request = projection.runtimeRequests.find(
+            (candidate) => candidate.id === input.requestId,
+          );
+          if (request === undefined) {
+            return yield* new RuntimeRequestResponseExecutionError({
+              reason: "request-missing",
+              threadId: input.threadId,
+              providerSessionId: input.providerSessionId,
+              requestId: input.requestId,
+            });
+          }
+          // Dispatch validates the request while it is pending, then persists the
+          // resolved projection before this effect is executed.
+          if (request.status !== "resolved") {
+            return yield* new RuntimeRequestResponseExecutionError({
+              reason: "request-not-ready",
+              threadId: input.threadId,
+              providerSessionId: input.providerSessionId,
+              requestId: input.requestId,
+            });
+          }
+          if (
+            request.responseCapability.type !== "live" ||
+            request.responseCapability.providerSessionId !== input.providerSessionId
+          ) {
+            return yield* new RuntimeRequestResponseExecutionError({
+              reason: "request-not-resumable",
+              threadId: input.threadId,
+              providerSessionId: input.providerSessionId,
+              requestId: input.requestId,
+            });
+          }
+          const session = yield* sessions.get(input.providerSessionId);
+          if (Option.isNone(session)) {
+            return yield* new RuntimeRequestResponseExecutionError({
+              reason: "provider-session-not-active",
+              threadId: input.threadId,
+              providerSessionId: input.providerSessionId,
+              requestId: input.requestId,
+            });
+          }
+          yield* session.value.respondToRuntimeRequest({
+            requestId: input.requestId,
+            ...(input.decision === undefined ? {} : { decision: input.decision }),
+            ...(input.answers === undefined ? {} : { answers: input.answers }),
+          });
+        }).pipe(
+          Effect.mapError((cause) =>
+            isRuntimeRequestResponseExecutionError(cause)
+              ? cause
+              : new RuntimeRequestResponseExecutionError({
+                  reason: "unexpected-failure",
+                  threadId: input.threadId,
+                  providerSessionId: input.providerSessionId,
+                  requestId: input.requestId,
+                  cause,
+                }),
+          ),
+        ),
+    });
+  }),
+);
diff --git a/apps/server/src/orchestration-v2/SelectionRestart.integration.test.ts b/apps/server/src/orchestration-v2/SelectionRestart.integration.test.ts
new file mode 100644
index 000000000000..9d9a5f6a24be
--- /dev/null
+++ b/apps/server/src/orchestration-v2/SelectionRestart.integration.test.ts
@@ -0,0 +1,644 @@
+import { assert, it } from "@effect/vitest";
+import {
+  CommandId,
+  MessageId,
+  type ModelSelection,
+  type OrchestrationV2ProviderCapabilities,
+  type OrchestrationV2ProviderSession,
+  type OrchestrationV2ProviderThread,
+  ProjectId,
+  ProviderDriverKind,
+  ProviderInstanceId,
+  ProviderThreadId,
+  ProviderTurnId,
+  type RunId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+import * as Queue from "effect/Queue";
+import * as Ref from "effect/Ref";
+import * as Stream from "effect/Stream";
+
+import { CodexProviderCapabilitiesV2 } from "./Adapters/CodexAdapterV2.ts";
+import { OrchestratorV2 } from "./Orchestrator.ts";
+import {
+  ProviderAdapterOpenSessionError,
+  type ProviderAdapterV2Event,
+  type ProviderAdapterV2Shape,
+  type ProviderAdapterV2TurnInput,
+} from "./ProviderAdapter.ts";
+import {
+  makeLayer as makeProviderAdapterRegistryLayer,
+  makeSingleLayer as makeSingleProviderAdapterRegistryLayer,
+} from "./ProviderAdapterRegistry.ts";
+import { makeOrchestratorV2ReplayLayerWithRegistry } from "./testkit/ProviderReplayHarness.ts";
+import { checkpointWorkspace } from "./testkit/ReplayFixtureWorkspace.ts";
+
+const driver = ProviderDriverKind.make("codex");
+const providerInstanceId = ProviderInstanceId.make("codex-restart-test");
+const initialSelection = {
+  instanceId: providerInstanceId,
+  model: "restart-model-a",
+} satisfies ModelSelection;
+const replacementSelection = {
+  instanceId: providerInstanceId,
+  model: "restart-model-b",
+} satisfies ModelSelection;
+const handoffDriver = ProviderDriverKind.make("claudeAgent");
+const handoffProviderInstanceId = ProviderInstanceId.make("claude-handoff-test");
+const handoffSelection = {
+  instanceId: handoffProviderInstanceId,
+  model: "handoff-model",
+} satisfies ModelSelection;
+const pooledCapabilities: OrchestrationV2ProviderCapabilities = CodexProviderCapabilitiesV2;
+const exclusiveCapabilities: OrchestrationV2ProviderCapabilities = {
+  ...CodexProviderCapabilitiesV2,
+  sessions: {
+    ...CodexProviderCapabilitiesV2.sessions,
+    supportsMultipleProviderThreadsPerSession: false,
+    supportsModelSwitchInSession: false,
+  },
+};
+
+interface ActiveTurn {
+  readonly input: ProviderAdapterV2TurnInput;
+  readonly providerTurnId: ProviderTurnId;
+}
+
+interface RestartAdapterState {
+  readonly activeTurn: ActiveTurn | null;
+  readonly opened: ReadonlyArray<{
+    readonly model: string | null;
+    readonly cwd: string | null;
+  }>;
+  readonly started: ReadonlyArray<{
+    readonly model: string;
+    readonly cwd: string | null;
+    readonly attemptId: string;
+  }>;
+  readonly closedSessionCount: number;
+  readonly failedReplacementOpen: boolean;
+}
+
+function makeRestartAdapter(
+  state: Ref.Ref<RestartAdapterState>,
+  sessionCapabilities: OrchestrationV2ProviderCapabilities = pooledCapabilities,
+): ProviderAdapterV2Shape {
+  return {
+    instanceId: providerInstanceId,
+    driver,
+    getCapabilities: () => Effect.succeed(sessionCapabilities),
+    planSelectionTransition: ({ current, target }) =>
+      Effect.succeed(
+        current.model === target.model
+          ? ({ type: "apply_on_next_turn" } as const)
+          : ({ type: "restart_session" } as const),
+      ),
+    openSession: (sessionInput) =>
+      Effect.gen(function* () {
+        const failThisOpen = yield* Ref.modify(state, (current) => {
+          const shouldFail =
+            sessionInput.modelSelection.model === replacementSelection.model &&
+            !current.failedReplacementOpen;
+          return [
+            shouldFail,
+            {
+              ...current,
+              failedReplacementOpen: current.failedReplacementOpen || shouldFail,
+              opened: [
+                ...current.opened,
+                {
+                  model: sessionInput.modelSelection.model,
+                  cwd: sessionInput.runtimePolicy.cwd,
+                },
+              ],
+            },
+          ] as const;
+        });
+        if (failThisOpen) {
+          return yield* new ProviderAdapterOpenSessionError({
+            driver,
+            providerSessionId: sessionInput.providerSessionId,
+            cause: "simulated replacement open failure",
+          });
+        }
+
+        const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+        const now = yield* DateTime.now;
+        const providerSession: OrchestrationV2ProviderSession = {
+          id: sessionInput.providerSessionId,
+          driver,
+          providerInstanceId,
+          status: "ready",
+          cwd: sessionInput.runtimePolicy.cwd ?? "/fallback",
+          model: sessionInput.modelSelection.model,
+          capabilities: sessionCapabilities,
+          createdAt: now,
+          updatedAt: now,
+          lastError: null,
+        };
+        yield* Effect.addFinalizer(() =>
+          Ref.update(state, (current) => ({
+            ...current,
+            closedSessionCount: current.closedSessionCount + 1,
+          })),
+        );
+
+        const publishTerminal = (active: ActiveTurn, status: "completed" | "interrupted") =>
+          Effect.gen(function* () {
+            const occurredAt = yield* DateTime.now;
+            yield* Queue.offer(events, {
+              type: "provider_turn.updated",
+              driver,
+              providerTurn: {
+                id: active.providerTurnId,
+                providerThreadId: active.input.providerThread.id,
+                nodeId: active.input.rootNodeId,
+                runAttemptId: active.input.attemptId,
+                nativeTurnRef: {
+                  driver,
+                  nativeId: `native:${active.providerTurnId}`,
+                  strength: "strong",
+                },
+                ordinal: active.input.providerTurnOrdinal,
+                status,
+                startedAt: occurredAt,
+                completedAt: occurredAt,
+              },
+            });
+            yield* Queue.offer(events, {
+              type: "turn.terminal",
+              driver,
+              providerThreadId: active.input.providerThread.id,
+              providerTurnId: active.providerTurnId,
+              runOrdinal: active.input.runOrdinal,
+              status,
+              failure: null,
+              threadDisposition: "reusable",
+            });
+          });
+
+        return {
+          instanceId: providerInstanceId,
+          driver,
+          providerSessionId: sessionInput.providerSessionId,
+          providerSession,
+          events: Stream.fromQueue(events),
+          ensureThread: (threadInput) =>
+            Effect.gen(function* () {
+              const createdAt = yield* DateTime.now;
+              return {
+                id: ProviderThreadId.make(`provider-thread:${threadInput.threadId}`),
+                driver,
+                providerInstanceId,
+                providerSessionId: sessionInput.providerSessionId,
+                appThreadId: threadInput.threadId,
+                ownerNodeId: null,
+                nativeThreadRef: {
+                  driver,
+                  nativeId: `native-thread:${threadInput.threadId}`,
+                  strength: "strong",
+                },
+                nativeConversationHeadRef: null,
+                status: "idle",
+                firstRunOrdinal: null,
+                lastRunOrdinal: null,
+                handoffIds: [],
+                forkedFrom: null,
+                createdAt,
+                updatedAt: createdAt,
+              } satisfies OrchestrationV2ProviderThread;
+            }),
+          resumeThread: ({ providerThread }) => Effect.succeed(providerThread),
+          startTurn: (input) =>
+            Effect.gen(function* () {
+              yield* Ref.update(state, (current) => ({
+                ...current,
+                started: [
+                  ...current.started,
+                  {
+                    model: input.modelSelection.model,
+                    cwd: input.runtimePolicy.cwd,
+                    attemptId: input.attemptId,
+                  },
+                ],
+              }));
+              const active = {
+                input,
+                providerTurnId: ProviderTurnId.make(`provider-turn:${input.attemptId}`),
+              } satisfies ActiveTurn;
+              if (input.modelSelection.model === initialSelection.model) {
+                const occurredAt = yield* DateTime.now;
+                yield* Ref.update(state, (current) => ({ ...current, activeTurn: active }));
+                yield* Queue.offer(events, {
+                  type: "provider_turn.updated",
+                  driver,
+                  providerTurn: {
+                    id: active.providerTurnId,
+                    providerThreadId: input.providerThread.id,
+                    nodeId: input.rootNodeId,
+                    runAttemptId: input.attemptId,
+                    nativeTurnRef: {
+                      driver,
+                      nativeId: `native:${active.providerTurnId}`,
+                      strength: "strong",
+                    },
+                    ordinal: input.providerTurnOrdinal,
+                    status: "running",
+                    startedAt: occurredAt,
+                    completedAt: null,
+                  },
+                });
+                return;
+              }
+              yield* publishTerminal(active, "completed");
+            }),
+          steerTurn: () => Effect.void,
+          interruptTurn: () =>
+            Effect.gen(function* () {
+              const active = (yield* Ref.get(state)).activeTurn;
+              if (active !== null) {
+                const updatedAt = yield* DateTime.now;
+                yield* Queue.offer(events, {
+                  type: "provider_thread.updated",
+                  driver,
+                  providerThread: {
+                    ...active.input.providerThread,
+                    status: "idle",
+                    updatedAt,
+                  },
+                });
+                yield* publishTerminal(active, "interrupted");
+                yield* Ref.update(state, (current) => ({ ...current, activeTurn: null }));
+              }
+            }),
+          respondToRuntimeRequest: () => Effect.void,
+          readThreadSnapshot: () => Effect.die("unused readThreadSnapshot"),
+          rollbackThread: () => Effect.die("unused rollbackThread"),
+          forkThread: () => Effect.die("unused forkThread"),
+        };
+      }),
+  };
+}
+
+function makeCompletingHandoffAdapter(startCount: Ref.Ref<number>): ProviderAdapterV2Shape {
+  return {
+    instanceId: handoffProviderInstanceId,
+    driver: handoffDriver,
+    getCapabilities: () => Effect.succeed(exclusiveCapabilities),
+    planSelectionTransition: () => Effect.succeed({ type: "apply_on_next_turn" }),
+    openSession: (sessionInput) =>
+      Effect.gen(function* () {
+        const events = yield* Queue.unbounded<ProviderAdapterV2Event>();
+        const now = yield* DateTime.now;
+        return {
+          instanceId: handoffProviderInstanceId,
+          driver: handoffDriver,
+          providerSessionId: sessionInput.providerSessionId,
+          providerSession: {
+            id: sessionInput.providerSessionId,
+            driver: handoffDriver,
+            providerInstanceId: handoffProviderInstanceId,
+            status: "ready",
+            cwd: sessionInput.runtimePolicy.cwd ?? "/fallback",
+            model: sessionInput.modelSelection.model,
+            capabilities: exclusiveCapabilities,
+            createdAt: now,
+            updatedAt: now,
+            lastError: null,
+          },
+          events: Stream.fromQueue(events),
+          ensureThread: (threadInput) =>
+            Effect.gen(function* () {
+              const createdAt = yield* DateTime.now;
+              return {
+                id: ProviderThreadId.make(`provider-thread:handoff:${threadInput.threadId}`),
+                driver: handoffDriver,
+                providerInstanceId: handoffProviderInstanceId,
+                providerSessionId: sessionInput.providerSessionId,
+                appThreadId: threadInput.threadId,
+                ownerNodeId: null,
+                nativeThreadRef: {
+                  driver: handoffDriver,
+                  nativeId: `native-thread:handoff:${threadInput.threadId}`,
+                  strength: "strong",
+                },
+                nativeConversationHeadRef: null,
+                status: "idle",
+                firstRunOrdinal: null,
+                lastRunOrdinal: null,
+                handoffIds: [],
+                forkedFrom: null,
+                createdAt,
+                updatedAt: createdAt,
+              } satisfies OrchestrationV2ProviderThread;
+            }),
+          resumeThread: ({ providerThread }) => Effect.succeed(providerThread),
+          startTurn: (input) =>
+            Effect.gen(function* () {
+              yield* Ref.update(startCount, (count) => count + 1);
+              const occurredAt = yield* DateTime.now;
+              const providerTurnId = ProviderTurnId.make(
+                `provider-turn:handoff:${input.attemptId}`,
+              );
+              yield* Queue.offer(events, {
+                type: "provider_turn.updated",
+                driver: handoffDriver,
+                providerTurn: {
+                  id: providerTurnId,
+                  providerThreadId: input.providerThread.id,
+                  nodeId: input.rootNodeId,
+                  runAttemptId: input.attemptId,
+                  nativeTurnRef: {
+                    driver: handoffDriver,
+                    nativeId: `native:${providerTurnId}`,
+                    strength: "strong",
+                  },
+                  ordinal: input.providerTurnOrdinal,
+                  status: "completed",
+                  startedAt: occurredAt,
+                  completedAt: occurredAt,
+                },
+              });
+              yield* Queue.offer(events, {
+                type: "turn.terminal",
+                driver: handoffDriver,
+                providerThreadId: input.providerThread.id,
+                providerTurnId,
+                runOrdinal: input.runOrdinal,
+                status: "completed",
+                failure: null,
+                threadDisposition: "reusable",
+              });
+            }),
+          steerTurn: () => Effect.void,
+          interruptTurn: () => Effect.void,
+          respondToRuntimeRequest: () => Effect.void,
+          readThreadSnapshot: () => Effect.die("unused readThreadSnapshot"),
+          rollbackThread: () => Effect.die("unused rollbackThread"),
+          forkThread: () => Effect.die("unused forkThread"),
+        };
+      }),
+  };
+}
+
+it.live("restarts selection as a new attempt and retries after old-session cleanup", () =>
+  Effect.scoped(
+    Effect.gen(function* () {
+      const cwd = yield* checkpointWorkspace("selection-restart-lifecycle");
+      const threadId = ThreadId.make("thread:selection-restart-lifecycle");
+      const state = yield* Ref.make<RestartAdapterState>({
+        activeTurn: null,
+        opened: [],
+        started: [],
+        closedSessionCount: 0,
+        failedReplacementOpen: false,
+      });
+      const registry = makeSingleProviderAdapterRegistryLayer(makeRestartAdapter(state));
+
+      const result = yield* Effect.gen(function* () {
+        const orchestrator = yield* OrchestratorV2;
+        yield* orchestrator.dispatch({
+          type: "thread.create",
+          createdBy: "user",
+          creationSource: "web",
+          commandId: CommandId.make("command:selection-restart:create"),
+          threadId,
+          projectId: ProjectId.make("project:selection-restart"),
+          title: "Selection restart",
+          modelSelection: initialSelection,
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          branch: null,
+          worktreePath: cwd,
+        });
+        yield* orchestrator.dispatch({
+          type: "message.dispatch",
+          createdBy: "user",
+          creationSource: "web",
+          commandId: CommandId.make("command:selection-restart:first"),
+          threadId,
+          messageId: MessageId.make("message:selection-restart:first"),
+          text: "first",
+          attachments: [],
+          modelSelection: initialSelection,
+          dispatchMode: { type: "start_immediately" },
+        });
+        for (let index = 0; index < 1_000; index += 1) {
+          const current = yield* orchestrator.getThreadProjection(threadId);
+          if (current.providerTurns.some((turn) => turn.status === "running")) break;
+          yield* Effect.sleep("5 millis");
+        }
+        const activeProjection = yield* orchestrator.getThreadProjection(threadId);
+        assert.isTrue(activeProjection.providerTurns.some((turn) => turn.status === "running"));
+        const activeRunId = activeProjection.runs[0]?.id;
+        if (activeRunId === undefined) {
+          return yield* Effect.die("active restart test run is missing");
+        }
+
+        yield* orchestrator.dispatch({
+          type: "message.dispatch",
+          createdBy: "user",
+          creationSource: "web",
+          commandId: CommandId.make("command:selection-restart:second"),
+          threadId,
+          messageId: MessageId.make("message:selection-restart:second"),
+          text: "second",
+          attachments: [],
+          modelSelection: replacementSelection,
+          dispatchMode: { type: "restart_active", targetRunId: activeRunId },
+        });
+        for (let index = 0; index < 1_000; index += 1) {
+          const current = yield* orchestrator.getThreadProjection(threadId);
+          if (current.attempts.length === 2 && current.attempts[1]?.status === "completed") {
+            const captured = yield* Ref.get(state);
+            return { projection: current, captured };
+          }
+          yield* Effect.sleep("5 millis");
+        }
+        const current = yield* orchestrator.getThreadProjection(threadId);
+        const adapterState = yield* Ref.get(state);
+        yield* Effect.logError("selection restart did not complete", {
+          runs: current.runs.map((run) => [run.status, run.activeAttemptId]),
+          attempts: current.attempts.map((attempt) => [attempt.id, attempt.status]),
+          providerTurns: current.providerTurns.map((turn) => [turn.id, turn.status]),
+          providerThreads: current.providerThreads.map((thread) => [
+            thread.providerSessionId,
+            thread.status,
+          ]),
+          adapterState,
+        });
+        return yield* Effect.die("selection restart did not complete");
+      }).pipe(
+        Effect.provide(
+          makeOrchestratorV2ReplayLayerWithRegistry(
+            { name: "selection-restart-lifecycle" },
+            registry,
+          ),
+        ),
+      );
+      const { projection, captured } = result;
+
+      assert.lengthOf(projection.runs, 1);
+      assert.lengthOf(projection.attempts, 2);
+      assert.deepEqual(
+        projection.attempts.map((attempt) => attempt.status),
+        ["superseded", "completed"],
+      );
+      assert.deepEqual(
+        projection.providerTurns.map((turn) => turn.status),
+        ["interrupted", "completed"],
+      );
+      assert.isFalse(
+        projection.turnItems.some(
+          (item) => item.type === "run_interrupt_request" || item.type === "run_interrupt_result",
+        ),
+        "selection restart supersede must not project hard-Stop interrupt items",
+      );
+      assert.equal(projection.runs[0]?.modelSelection.model, replacementSelection.model);
+      assert.isTrue(captured.failedReplacementOpen);
+      // The old pooled process remains available to its other threads; this
+      // thread moved to a freshly allocated replacement session.
+      assert.equal(captured.closedSessionCount, 0);
+      assert.deepEqual(
+        captured.opened.map((open) => [open.model, open.cwd]),
+        [
+          [initialSelection.model, cwd],
+          [replacementSelection.model, cwd],
+          [replacementSelection.model, cwd],
+        ],
+      );
+      assert.deepEqual(
+        captured.started.map((turn) => [turn.model, turn.cwd]),
+        [
+          [initialSelection.model, cwd],
+          [replacementSelection.model, cwd],
+        ],
+      );
+      assert.notEqual(
+        projection.providerSessions[0]?.id,
+        projection.providerThreads[0]?.providerSessionId,
+      );
+      assert.equal(
+        projection.providerThreads[0]?.providerSessionId,
+        projection.providerSessions.find((session) => session.model === replacementSelection.model)
+          ?.id,
+      );
+    }),
+  ),
+);
+
+it.live("detaches the old provider session after an active provider handoff", () =>
+  Effect.scoped(
+    Effect.gen(function* () {
+      const cwd = yield* checkpointWorkspace("selection-provider-handoff-lifecycle");
+      const threadId = ThreadId.make("thread:selection-provider-handoff-lifecycle");
+      const state = yield* Ref.make<RestartAdapterState>({
+        activeTurn: null,
+        opened: [],
+        started: [],
+        closedSessionCount: 0,
+        failedReplacementOpen: false,
+      });
+      const targetStartCount = yield* Ref.make(0);
+      const registry = makeProviderAdapterRegistryLayer([
+        makeRestartAdapter(state, exclusiveCapabilities),
+        makeCompletingHandoffAdapter(targetStartCount),
+      ]);
+
+      const result = yield* Effect.gen(function* () {
+        const orchestrator = yield* OrchestratorV2;
+        yield* orchestrator.dispatch({
+          type: "thread.create",
+          createdBy: "user",
+          creationSource: "web",
+          commandId: CommandId.make("command:selection-handoff:create"),
+          threadId,
+          projectId: ProjectId.make("project:selection-handoff"),
+          title: "Selection provider handoff",
+          modelSelection: initialSelection,
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          branch: null,
+          worktreePath: cwd,
+        });
+        yield* orchestrator.dispatch({
+          type: "message.dispatch",
+          createdBy: "user",
+          creationSource: "web",
+          commandId: CommandId.make("command:selection-handoff:first"),
+          threadId,
+          messageId: MessageId.make("message:selection-handoff:first"),
+          text: "first",
+          attachments: [],
+          modelSelection: initialSelection,
+          dispatchMode: { type: "start_immediately" },
+        });
+        let activeRunId: RunId | null = null;
+        for (let index = 0; index < 1_000; index += 1) {
+          const current = yield* orchestrator.getThreadProjection(threadId);
+          if (current.providerTurns.some((turn) => turn.status === "running")) {
+            activeRunId = current.runs[0]?.id ?? null;
+            break;
+          }
+          yield* Effect.sleep("5 millis");
+        }
+        if (activeRunId === null) {
+          return yield* Effect.die("active provider-handoff run is missing");
+        }
+
+        yield* orchestrator.dispatch({
+          type: "message.dispatch",
+          createdBy: "user",
+          creationSource: "web",
+          commandId: CommandId.make("command:selection-handoff:second"),
+          threadId,
+          messageId: MessageId.make("message:selection-handoff:second"),
+          text: "second",
+          attachments: [],
+          modelSelection: handoffSelection,
+          dispatchMode: { type: "restart_active", targetRunId: activeRunId },
+        });
+        for (let index = 0; index < 1_000; index += 1) {
+          const current = yield* orchestrator.getThreadProjection(threadId);
+          if (current.attempts.length === 2 && current.attempts[1]?.status === "completed") {
+            const captured = yield* Ref.get(state);
+            return { projection: current, captured };
+          }
+          yield* Effect.sleep("5 millis");
+        }
+        const current = yield* orchestrator.getThreadProjection(threadId);
+        const adapterState = yield* Ref.get(state);
+        const capturedTargetStartCount = yield* Ref.get(targetStartCount);
+        yield* Effect.logError("active provider handoff did not complete", {
+          runs: current.runs.map((run) => [run.status, run.activeAttemptId]),
+          attempts: current.attempts.map((attempt) => [attempt.id, attempt.status]),
+          providerTurns: current.providerTurns.map((turn) => [turn.id, turn.status]),
+          providerThreads: current.providerThreads.map((thread) => [
+            thread.providerInstanceId,
+            thread.providerSessionId,
+            thread.status,
+          ]),
+          targetStartCount: capturedTargetStartCount,
+          adapterState,
+        });
+        return yield* Effect.die("active provider handoff did not complete");
+      }).pipe(
+        Effect.provide(
+          makeOrchestratorV2ReplayLayerWithRegistry(
+            { name: "selection-provider-handoff-lifecycle" },
+            registry,
+          ),
+        ),
+      );
+
+      assert.lengthOf(result.projection.runs, 1);
+      assert.lengthOf(result.projection.attempts, 2);
+      assert.equal(result.projection.runs[0]?.providerInstanceId, handoffProviderInstanceId);
+      assert.equal(result.projection.contextHandoffs.length, 1);
+      assert.equal(result.captured.closedSessionCount, 1);
+      assert.equal(yield* Ref.get(targetStartCount), 1);
+    }),
+  ),
+);
diff --git a/apps/server/src/orchestration-v2/ShellStream.test.ts b/apps/server/src/orchestration-v2/ShellStream.test.ts
new file mode 100644
index 000000000000..0b2b7929eb06
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ShellStream.test.ts
@@ -0,0 +1,382 @@
+import { describe, expect, it } from "@effect/vitest";
+import type {
+  ApplicationStoredEvent,
+  OrchestrationV2ShellSnapshot,
+  OrchestrationV2StoredEvent,
+  OrchestrationV2ThreadShell,
+} from "@t3tools/contracts";
+import { ThreadId } from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as Stream from "effect/Stream";
+
+import {
+  archivedShellStreamItemFromThreadShell,
+  buildActiveShellSnapshot,
+  coalesceShellApplicationEvents,
+  coalesceStoredThreadEvents,
+  composeShellStreamWithEnrichment,
+  shellStreamItemFromEnrichmentRefresh,
+  shellStreamItemFromThreadShell,
+  shellStreamItemsFromInitialSnapshot,
+  shellStreamItemsFromResumeSnapshot,
+} from "./ShellStream.ts";
+
+function project(sequence: number, id: string): ApplicationStoredEvent {
+  return {
+    sequence,
+    aggregateKind: "project",
+    aggregateId: id,
+  } as ApplicationStoredEvent;
+}
+
+function thread(sequence: number, id: string): ApplicationStoredEvent {
+  return {
+    sequence,
+    event: { threadId: id },
+  } as ApplicationStoredEvent;
+}
+
+const emptyShellSnapshot = {
+  schemaVersion: 1,
+  snapshotSequence: 0,
+  projects: [],
+  threads: [],
+  archivedThreads: [],
+} as OrchestrationV2ShellSnapshot;
+
+describe("buildActiveShellSnapshot", () => {
+  it("never duplicates archived rows into the regular shell", () => {
+    const active = shellFixture({ archivedAt: null });
+    const archived = shellFixture({
+      id: ThreadId.make("thread-archived"),
+      archivedAt: "2026-07-30T00:00:00.000Z" as never,
+    });
+
+    expect(
+      buildActiveShellSnapshot({
+        projects: [],
+        threads: {
+          schemaVersion: 1,
+          snapshotSequence: 4,
+          threads: [active],
+          archivedThreads: [archived],
+        },
+        snapshotSequence: 7,
+      }),
+    ).toEqual({
+      schemaVersion: 1,
+      snapshotSequence: 7,
+      projects: [],
+      threads: [active],
+      archivedThreads: [],
+    });
+  });
+});
+
+describe("coalesceShellApplicationEvents", () => {
+  it("keeps the newest event per aggregate and preserves sequence order", () => {
+    expect(
+      coalesceShellApplicationEvents([
+        thread(2, "thread-a"),
+        project(3, "project-a"),
+        thread(4, "thread-b"),
+        thread(5, "thread-a"),
+        project(6, "project-a"),
+      ]).map((event) => event.sequence),
+    ).toEqual([4, 5, 6]);
+  });
+});
+
+function storedThreadEvent(
+  sequence: number,
+  threadId: string,
+  event: Record<string, unknown> = {},
+): OrchestrationV2StoredEvent {
+  return { sequence, event: { threadId, ...event } } as OrchestrationV2StoredEvent;
+}
+
+function shellFixture(overrides: Partial<OrchestrationV2ThreadShell>): OrchestrationV2ThreadShell {
+  return { id: "thread-a", archivedAt: null, ...overrides } as OrchestrationV2ThreadShell;
+}
+
+describe("coalesceStoredThreadEvents", () => {
+  it("keeps the newest stored event per thread and preserves sequence order", () => {
+    expect(
+      coalesceStoredThreadEvents([
+        storedThreadEvent(2, "thread-a"),
+        storedThreadEvent(3, "thread-b"),
+        storedThreadEvent(5, "thread-a"),
+      ]).map((stored) => stored.sequence),
+    ).toEqual([3, 5]);
+  });
+});
+
+describe("shellStreamItemFromThreadShell", () => {
+  it("emits an active thread update when the shell is not archived", () => {
+    const shell = shellFixture({ archivedAt: null });
+    expect(
+      shellStreamItemFromThreadShell({ stored: storedThreadEvent(4, "thread-a"), shell }),
+    ).toEqual({
+      kind: "thread.updated",
+      sequence: 4,
+      location: "active",
+      thread: shell,
+    });
+  });
+
+  it("removes archived threads from the active-only shell", () => {
+    const shell = shellFixture({ archivedAt: "2026-07-30T00:00:00.000Z" as never });
+    expect(
+      shellStreamItemFromThreadShell({ stored: storedThreadEvent(4, "thread-a"), shell }),
+    ).toEqual({
+      kind: "thread.removed",
+      sequence: 4,
+      location: "active",
+      threadId: "thread-a",
+    });
+  });
+
+  it("emits an active-shell removal when an archived thread is deleted", () => {
+    expect(
+      shellStreamItemFromThreadShell({
+        stored: storedThreadEvent(6, "thread-a", {
+          type: "thread.deleted",
+          payload: { archivedAt: "2026-07-30T00:00:00.000Z" },
+        }),
+        shell: null,
+      }),
+    ).toEqual({
+      kind: "thread.removed",
+      sequence: 6,
+      location: "active",
+      threadId: "thread-a",
+    });
+  });
+
+  it("emits a removal from the active list for other missing shells", () => {
+    expect(
+      shellStreamItemFromThreadShell({
+        stored: storedThreadEvent(6, "thread-a", {
+          type: "thread.deleted",
+          payload: { archivedAt: null },
+        }),
+        shell: null,
+      }),
+    ).toEqual({
+      kind: "thread.removed",
+      sequence: 6,
+      location: "active",
+      threadId: "thread-a",
+    });
+  });
+});
+
+describe("archivedShellStreamItemFromThreadShell", () => {
+  it("emits an update for an archived shell", () => {
+    const shell = shellFixture({ archivedAt: "2026-07-30T00:00:00.000Z" as never });
+    expect(
+      archivedShellStreamItemFromThreadShell({ stored: storedThreadEvent(4, "thread-a"), shell }),
+    ).toEqual({ kind: "thread.updated", sequence: 4, thread: shell });
+  });
+
+  it("ignores active threads that never touched the archive", () => {
+    expect(
+      archivedShellStreamItemFromThreadShell({
+        stored: storedThreadEvent(4, "thread-a", { type: "thread.settled" }),
+        shell: shellFixture({ archivedAt: null }),
+      }),
+    ).toBeNull();
+  });
+
+  it("emits a removal when a thread leaves the archive", () => {
+    expect(
+      archivedShellStreamItemFromThreadShell({
+        stored: storedThreadEvent(4, "thread-a", { type: "thread.unarchived" }),
+        shell: shellFixture({ archivedAt: null }),
+      }),
+    ).toEqual({ kind: "thread.removed", sequence: 4, threadId: "thread-a" });
+  });
+
+  it("emits a removal when an archived thread is deleted", () => {
+    expect(
+      archivedShellStreamItemFromThreadShell({
+        stored: storedThreadEvent(4, "thread-a", {
+          type: "thread.deleted",
+          payload: { archivedAt: "2026-07-30T00:00:00.000Z" },
+        }),
+        shell: null,
+      }),
+    ).toEqual({ kind: "thread.removed", sequence: 4, threadId: "thread-a" });
+  });
+});
+
+describe("shellStreamItemFromEnrichmentRefresh", () => {
+  it("batches nearby completion roots onto one snapshot item", () => {
+    expect(
+      shellStreamItemFromEnrichmentRefresh({
+        snapshot: emptyShellSnapshot,
+        changes: [
+          { workspaceRoot: "/workspace/a" },
+          { workspaceRoot: "/workspace/b" },
+          { workspaceRoot: "/workspace/a" },
+        ],
+      }),
+    ).toEqual({
+      kind: "snapshot",
+      snapshot: emptyShellSnapshot,
+      resolvedRepositoryIdentityRoots: ["/workspace/a", "/workspace/b"],
+    });
+  });
+});
+
+describe("shellStreamItemsFromInitialSnapshot", () => {
+  it("keeps thread rows out of the metadata-only enrichment frame", () => {
+    const snapshot = {
+      ...emptyShellSnapshot,
+      projects: [
+        { id: "project-a", workspaceRoot: "/workspace/a" },
+        { id: "project-b", workspaceRoot: "/workspace/b" },
+      ],
+      threads: [shellFixture({})],
+      archivedThreads: [shellFixture({ id: ThreadId.make("thread-archived"), archivedAt: null })],
+    } as unknown as OrchestrationV2ShellSnapshot;
+
+    const items = shellStreamItemsFromInitialSnapshot({
+      snapshot,
+      resolvedRepositoryIdentityRoots: ["/workspace/a"],
+    });
+
+    expect(items[0]).toEqual({ kind: "snapshot", snapshot });
+    expect(items[1]).toMatchObject({
+      kind: "snapshot",
+      snapshot: {
+        projects: [{ id: "project-a", workspaceRoot: "/workspace/a" }],
+        threads: [],
+        archivedThreads: [],
+      },
+      resolvedRepositoryIdentityRoots: ["/workspace/a"],
+    });
+    expect(JSON.stringify(items[1]).length).toBeLessThan(JSON.stringify(items[0]).length);
+  });
+
+  it("emits unmarked authoritative then same-sequence marked enrichment when roots resolved", () => {
+    const snapshot = {
+      ...emptyShellSnapshot,
+      snapshotSequence: 7,
+    } as OrchestrationV2ShellSnapshot;
+
+    expect(
+      shellStreamItemsFromInitialSnapshot({
+        snapshot,
+        resolvedRepositoryIdentityRoots: ["/workspace/a", "/workspace/a"],
+      }),
+    ).toEqual([
+      { kind: "snapshot", snapshot },
+      {
+        kind: "snapshot",
+        snapshot,
+        resolvedRepositoryIdentityRoots: ["/workspace/a"],
+      },
+    ]);
+  });
+
+  it("emits only the unmarked authoritative snapshot when no roots resolved", () => {
+    expect(
+      shellStreamItemsFromInitialSnapshot({
+        snapshot: emptyShellSnapshot,
+        resolvedRepositoryIdentityRoots: [],
+      }),
+    ).toEqual([{ kind: "snapshot", snapshot: emptyShellSnapshot }]);
+  });
+});
+
+describe("shellStreamItemsFromResumeSnapshot", () => {
+  it("never repeats the authoritative shell snapshot", () => {
+    expect(
+      shellStreamItemsFromResumeSnapshot({
+        snapshot: {
+          ...emptyShellSnapshot,
+          threads: [shellFixture({})],
+        },
+        resolvedRepositoryIdentityRoots: [],
+      }),
+    ).toEqual([]);
+  });
+});
+
+describe("composeShellStreamWithEnrichment", () => {
+  it.effect(
+    "emits every initial item before enrichment even when enrichment is already ready",
+    () =>
+      Effect.gen(function* () {
+        const initialSnapshot = {
+          ...emptyShellSnapshot,
+          snapshotSequence: 5,
+        } as OrchestrationV2ShellSnapshot;
+        const enrichmentSnapshot = {
+          ...emptyShellSnapshot,
+          snapshotSequence: 10,
+        } as OrchestrationV2ShellSnapshot;
+
+        const initialItems = shellStreamItemsFromInitialSnapshot({
+          snapshot: initialSnapshot,
+          resolvedRepositoryIdentityRoots: ["/workspace/a"],
+        });
+        // Enrichment stream is fully ready before the composed stream is pulled.
+        const enrichment = Stream.make(
+          shellStreamItemFromEnrichmentRefresh({
+            snapshot: enrichmentSnapshot,
+            changes: [{ workspaceRoot: "/workspace/b" }],
+          }),
+        );
+        const tail = Stream.make(
+          { kind: "synchronized" as const },
+          {
+            kind: "project.removed" as const,
+            sequence: 6,
+            projectId: "project-a",
+          },
+        );
+
+        const items = Array.from(
+          yield* composeShellStreamWithEnrichment({
+            initial: Stream.fromIterable(initialItems),
+            tail,
+            enrichment,
+          }).pipe(Stream.runCollect),
+        );
+
+        expect(items.slice(0, initialItems.length)).toEqual(initialItems);
+
+        const enrichmentIndex = items.findIndex(
+          (item) =>
+            item.kind === "snapshot" &&
+            "resolvedRepositoryIdentityRoots" in item &&
+            item.resolvedRepositoryIdentityRoots?.includes("/workspace/b"),
+        );
+        expect(enrichmentIndex).toBeGreaterThanOrEqual(initialItems.length);
+
+        for (let index = 0; index < initialItems.length; index++) {
+          expect(items[index]).toEqual(initialItems[index]);
+        }
+      }),
+  );
+
+  it.effect("still interleaves enrichment with the post-prefix tail after initials drain", () =>
+    Effect.gen(function* () {
+      const items = Array.from(
+        yield* composeShellStreamWithEnrichment({
+          initial: Stream.make("initial-unmarked", "initial-marked"),
+          tail: Stream.make("tail-a", "tail-b"),
+          enrichment: Stream.make("enrichment"),
+        }).pipe(Stream.runCollect),
+      );
+
+      expect(items.slice(0, 2)).toEqual(["initial-unmarked", "initial-marked"]);
+      expect(items).toContain("enrichment");
+      expect(items).toContain("tail-a");
+      expect(items).toContain("tail-b");
+      expect(items.indexOf("enrichment")).toBeGreaterThanOrEqual(2);
+    }),
+  );
+});
diff --git a/apps/server/src/orchestration-v2/ShellStream.ts b/apps/server/src/orchestration-v2/ShellStream.ts
new file mode 100644
index 000000000000..57bb876c2060
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ShellStream.ts
@@ -0,0 +1,191 @@
+import type {
+  ApplicationStoredEvent,
+  OrchestrationProjectShell,
+  OrchestrationV2ArchivedShellStreamItem,
+  OrchestrationV2ShellSnapshot,
+  OrchestrationV2ThreadShell,
+  OrchestrationV2ThreadShellSnapshot,
+  OrchestrationV2ShellStreamItem,
+  OrchestrationV2StoredEvent,
+} from "@t3tools/contracts";
+import * as Stream from "effect/Stream";
+
+/** Build the regular navigation shell without duplicating the archive dataset. */
+export function buildActiveShellSnapshot(input: {
+  readonly projects: ReadonlyArray<OrchestrationProjectShell>;
+  readonly threads: OrchestrationV2ThreadShellSnapshot;
+  readonly snapshotSequence: number;
+}): OrchestrationV2ShellSnapshot {
+  return {
+    schemaVersion: input.threads.schemaVersion,
+    snapshotSequence: input.snapshotSequence,
+    projects: input.projects,
+    threads: input.threads.threads,
+    archivedThreads: [],
+  };
+}
+
+/** Keep only the newest shell-relevant event per project/thread aggregate. */
+export function coalesceShellApplicationEvents(
+  events: ReadonlyArray<ApplicationStoredEvent>,
+): ReadonlyArray<ApplicationStoredEvent> {
+  const latestByAggregate = new Map<string, ApplicationStoredEvent>();
+  for (const stored of events) {
+    const key =
+      "aggregateKind" in stored
+        ? `project:${stored.aggregateId}`
+        : `thread:${stored.event.threadId}`;
+    latestByAggregate.set(key, stored);
+  }
+  return Array.from(latestByAggregate.values()).sort(
+    (left, right) => left.sequence - right.sequence,
+  );
+}
+
+/**
+ * Emit the initial shell prefix strictly first, then merge the post-prefix
+ * tail with enrichment refreshes. Prevents a newer marked enrichment from
+ * landing before the unmarked authoritative initial snapshot.
+ */
+export function composeShellStreamWithEnrichment<A, E, R, A2, E2, R2, A3, E3, R3>(input: {
+  readonly initial: Stream.Stream<A, E, R>;
+  readonly tail: Stream.Stream<A2, E2, R2>;
+  readonly enrichment: Stream.Stream<A3, E3, R3>;
+}): Stream.Stream<A | A2 | A3, E | E2 | E3, R | R2 | R3> {
+  return Stream.concat(input.initial, Stream.merge(input.tail, input.enrichment));
+}
+
+/** Build a shell snapshot stream item for a batched enrichment completion. */
+export function shellStreamItemFromEnrichmentRefresh(input: {
+  readonly snapshot: OrchestrationV2ShellSnapshot;
+  readonly changes: ReadonlyArray<{ readonly workspaceRoot: string }>;
+}): Extract<OrchestrationV2ShellStreamItem, { readonly kind: "snapshot" }> {
+  const resolvedRepositoryIdentityRoots = [
+    ...new Set(input.changes.map((change) => change.workspaceRoot)),
+  ];
+  return {
+    kind: "snapshot",
+    snapshot: {
+      ...input.snapshot,
+      projects: input.snapshot.projects.filter((project) =>
+        resolvedRepositoryIdentityRoots.includes(project.workspaceRoot),
+      ),
+      threads: [],
+      archivedThreads: [],
+    },
+    resolvedRepositoryIdentityRoots,
+  };
+}
+
+/**
+ * Initial subscribe frames: always emit the unmarked authoritative snapshot,
+ * then a same-sequence enrichment frame only when some roots already resolved.
+ */
+export function shellStreamItemsFromInitialSnapshot(input: {
+  readonly snapshot: OrchestrationV2ShellSnapshot;
+  readonly resolvedRepositoryIdentityRoots: ReadonlyArray<string>;
+}): ReadonlyArray<Extract<OrchestrationV2ShellStreamItem, { readonly kind: "snapshot" }>> {
+  const authoritative = {
+    kind: "snapshot" as const,
+    snapshot: input.snapshot,
+  };
+  if (input.resolvedRepositoryIdentityRoots.length === 0) {
+    return [authoritative];
+  }
+  return [
+    authoritative,
+    {
+      kind: "snapshot" as const,
+      snapshot: {
+        ...input.snapshot,
+        projects: input.snapshot.projects.filter((project) =>
+          input.resolvedRepositoryIdentityRoots.includes(project.workspaceRoot),
+        ),
+        threads: [],
+        archivedThreads: [],
+      },
+      resolvedRepositoryIdentityRoots: [...new Set(input.resolvedRepositoryIdentityRoots)],
+    },
+  ];
+}
+
+/** Resume after HTTP/cache hydration with metadata only, never another full shell body. */
+export function shellStreamItemsFromResumeSnapshot(input: {
+  readonly snapshot: OrchestrationV2ShellSnapshot;
+  readonly resolvedRepositoryIdentityRoots: ReadonlyArray<string>;
+}): ReadonlyArray<Extract<OrchestrationV2ShellStreamItem, { readonly kind: "snapshot" }>> {
+  return shellStreamItemsFromInitialSnapshot(input).filter(
+    (item) => item.resolvedRepositoryIdentityRoots !== undefined,
+  );
+}
+
+/** Keep only the newest stored event per thread within a coalescing window. */
+export function coalesceStoredThreadEvents(
+  events: ReadonlyArray<OrchestrationV2StoredEvent>,
+): ReadonlyArray<OrchestrationV2StoredEvent> {
+  const latestByThreadId = new Map<string, OrchestrationV2StoredEvent>();
+  for (const stored of events) {
+    latestByThreadId.set(stored.event.threadId, stored);
+  }
+  return Array.from(latestByThreadId.values()).sort(
+    (left, right) => left.sequence - right.sequence,
+  );
+}
+
+/**
+ * Converts a committed event and the affected thread's current shell into one
+ * delta. `shell` is null when the thread is deleted or unknown.
+ */
+export function shellStreamItemFromThreadShell(input: {
+  readonly stored: OrchestrationV2StoredEvent;
+  readonly shell: OrchestrationV2ThreadShell | null;
+}): Exclude<OrchestrationV2ShellStreamItem, { readonly kind: "snapshot" }> {
+  if (input.shell !== null) {
+    if (input.shell.archivedAt !== null) {
+      return {
+        kind: "thread.removed",
+        sequence: input.stored.sequence,
+        location: "active",
+        threadId: input.shell.id,
+      };
+    }
+    return {
+      kind: "thread.updated",
+      sequence: input.stored.sequence,
+      location: "active",
+      thread: input.shell,
+    };
+  }
+
+  return {
+    kind: "thread.removed",
+    sequence: input.stored.sequence,
+    location: "active",
+    threadId: input.stored.event.threadId,
+  };
+}
+
+/** Converts a committed event into an archive-only delta when it changes archive membership. */
+export function archivedShellStreamItemFromThreadShell(input: {
+  readonly stored: OrchestrationV2StoredEvent;
+  readonly shell: OrchestrationV2ThreadShell | null;
+}): Exclude<OrchestrationV2ArchivedShellStreamItem, { readonly kind: "snapshot" }> | null {
+  if (input.shell !== null && input.shell.archivedAt !== null) {
+    return {
+      kind: "thread.updated",
+      sequence: input.stored.sequence,
+      thread: input.shell,
+    };
+  }
+  if (
+    input.stored.event.type === "thread.unarchived" ||
+    (input.stored.event.type === "thread.deleted" && input.stored.event.payload.archivedAt !== null)
+  ) {
+    return {
+      kind: "thread.removed",
+      sequence: input.stored.sequence,
+      threadId: input.stored.event.threadId,
+    };
+  }
+  return null;
+}
diff --git a/apps/server/src/orchestration-v2/SubagentProjection.test.ts b/apps/server/src/orchestration-v2/SubagentProjection.test.ts
new file mode 100644
index 000000000000..a1ff328d5ed0
--- /dev/null
+++ b/apps/server/src/orchestration-v2/SubagentProjection.test.ts
@@ -0,0 +1,102 @@
+import { assert, it } from "@effect/vitest";
+import {
+  type ModelSelection,
+  NodeId,
+  type OrchestrationV2AppThread,
+  ProjectId,
+  ProviderInstanceId,
+  ProviderThreadId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+
+import { makeSubagentChildThread } from "./SubagentProjection.ts";
+
+const parentThreadId = ThreadId.make("thread:subagent-snoozed-parent");
+const childThreadId = ThreadId.make("thread:subagent-awake-child");
+const parentProviderInstanceId = ProviderInstanceId.make("codex");
+const childProviderInstanceId = ProviderInstanceId.make("claude");
+const parentModelSelection = {
+  instanceId: parentProviderInstanceId,
+  model: "gpt-5.4",
+} satisfies ModelSelection;
+const childModelSelection = {
+  instanceId: childProviderInstanceId,
+  model: "claude-opus-4-1",
+} satisfies ModelSelection;
+const parentCreatedAt = DateTime.makeUnsafe("2026-07-24T09:00:00.000Z");
+const snoozedAt = DateTime.makeUnsafe("2026-07-24T09:05:00.000Z");
+const snoozedUntil = DateTime.makeUnsafe("2026-07-25T09:00:00.000Z");
+const childCreatedAt = DateTime.makeUnsafe("2026-07-24T09:10:00.000Z");
+
+function makeParentThread(): OrchestrationV2AppThread {
+  return {
+    createdBy: "user",
+    creationSource: "web",
+    id: parentThreadId,
+    projectId: ProjectId.make("project:subagent-snooze"),
+    title: "Snoozed parent",
+    providerInstanceId: parentProviderInstanceId,
+    modelSelection: parentModelSelection,
+    runtimeMode: "full-access",
+    interactionMode: "plan",
+    branch: "feature/source",
+    worktreePath: "/tmp/source-worktree",
+    activeProviderThreadId: ProviderThreadId.make("provider-thread:subagent-snoozed-parent"),
+    lineage: {
+      parentThreadId: null,
+      relationshipToParent: null,
+      rootThreadId: parentThreadId,
+    },
+    forkedFrom: null,
+    createdAt: parentCreatedAt,
+    updatedAt: snoozedAt,
+    archivedAt: null,
+    settledOverride: null,
+    settledAt: null,
+    lastVisitedAt: null,
+    snoozedUntil,
+    snoozedAt,
+    deletedAt: null,
+    historyOrigin: "v1_import",
+  };
+}
+
+it("keeps a subagent child awake when its parent thread is snoozed", () => {
+  const parentThread = makeParentThread();
+  const childProviderThreadId = ProviderThreadId.make("provider-thread:subagent-awake-child");
+  const parentNodeId = NodeId.make("node:subagent-parent");
+  const childThread = makeSubagentChildThread({
+    parentThread,
+    childThreadId,
+    parentNodeId,
+    activeProviderThreadId: childProviderThreadId,
+    providerInstanceId: childProviderInstanceId,
+    modelSelection: childModelSelection,
+    title: "Awake child",
+    now: childCreatedAt,
+    createdBy: "agent",
+    creationSource: "provider",
+  });
+
+  assert.isNull(childThread.snoozedUntil);
+  assert.isNull(childThread.snoozedAt);
+  assert.equal(childThread.projectId, parentThread.projectId);
+  assert.equal(childThread.runtimeMode, parentThread.runtimeMode);
+  assert.equal(childThread.interactionMode, parentThread.interactionMode);
+  assert.equal(childThread.branch, parentThread.branch);
+  assert.equal(childThread.worktreePath, parentThread.worktreePath);
+  assert.equal(childThread.providerInstanceId, childProviderInstanceId);
+  assert.deepEqual(childThread.modelSelection, childModelSelection);
+  assert.equal(childThread.activeProviderThreadId, childProviderThreadId);
+  assert.isUndefined(childThread.historyOrigin);
+  assert.deepEqual(childThread.lineage, {
+    parentThreadId,
+    relationshipToParent: "subagent",
+    rootThreadId: parentThreadId,
+  });
+  assert.deepEqual(childThread.forkedFrom, {
+    type: "node",
+    nodeId: parentNodeId,
+  });
+});
diff --git a/apps/server/src/orchestration-v2/SubagentProjection.ts b/apps/server/src/orchestration-v2/SubagentProjection.ts
new file mode 100644
index 000000000000..79c0881d59e1
--- /dev/null
+++ b/apps/server/src/orchestration-v2/SubagentProjection.ts
@@ -0,0 +1,191 @@
+import type {
+  MessageId,
+  ModelSelection,
+  NodeId,
+  OrchestrationV2AppThread,
+  OrchestrationV2Actor,
+  OrchestrationV2ConversationMessage,
+  OrchestrationV2CreationSource,
+  OrchestrationV2ProviderRef,
+  OrchestrationV2Run,
+  OrchestrationV2ThreadProjection,
+  OrchestrationV2TurnItem,
+  ProviderInstanceId,
+  ProviderThreadId,
+  ProviderTurnId,
+  ThreadId,
+  TurnItemId,
+} from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+
+function trimmed(value: string | null | undefined): string | undefined {
+  const result = value?.trim();
+  return result && result.length > 0 ? result : undefined;
+}
+
+export function subagentThreadTitle(input: {
+  readonly parentTitle: string;
+  readonly title?: string | null;
+  readonly prompt: string;
+  readonly ordinal: number;
+}): string {
+  const detail = trimmed(input.title) ?? trimmed(input.prompt);
+  if (detail === undefined) {
+    return `${input.parentTitle} subagent ${input.ordinal}`;
+  }
+  const clipped = detail.length > 72 ? `${detail.slice(0, 69)}...` : detail;
+  return clipped;
+}
+
+export function makeSubagentChildThread(input: {
+  readonly parentThread: OrchestrationV2AppThread;
+  readonly childThreadId: ThreadId;
+  readonly parentNodeId: NodeId;
+  readonly activeProviderThreadId: ProviderThreadId | null;
+  readonly providerInstanceId: ProviderInstanceId;
+  readonly modelSelection: ModelSelection;
+  readonly title: string;
+  readonly now: DateTime.Utc;
+  readonly createdBy: OrchestrationV2Actor;
+  readonly creationSource: OrchestrationV2CreationSource;
+}): OrchestrationV2AppThread {
+  return {
+    ...input.parentThread,
+    createdBy: input.createdBy,
+    creationSource: input.creationSource,
+    id: input.childThreadId,
+    title: input.title,
+    historyOrigin: undefined,
+    providerInstanceId: input.providerInstanceId,
+    modelSelection: input.modelSelection,
+    activeProviderThreadId: input.activeProviderThreadId,
+    lineage: {
+      parentThreadId: input.parentThread.id,
+      relationshipToParent: "subagent",
+      rootThreadId: input.parentThread.lineage.rootThreadId,
+    },
+    forkedFrom: {
+      type: "node",
+      nodeId: input.parentNodeId,
+    },
+    createdAt: input.now,
+    updatedAt: input.now,
+    archivedAt: null,
+    settledOverride: null,
+    settledAt: null,
+    snoozedUntil: null,
+    snoozedAt: null,
+    lastVisitedAt: null,
+    deletedAt: null,
+  };
+}
+
+export function makeSubagentConversationArtifacts(input: {
+  readonly messageId: MessageId;
+  readonly turnItemId: TurnItemId;
+  readonly threadId: ThreadId;
+  readonly rootNodeId: NodeId;
+  readonly providerThreadId: ProviderThreadId | null;
+  readonly providerTurnId: ProviderTurnId | null;
+  readonly nativeItemRef: OrchestrationV2ProviderRef | null;
+  readonly role: "user" | "assistant";
+  readonly text: string;
+  readonly ordinal: number;
+  readonly now: DateTime.Utc;
+}): {
+  readonly message: OrchestrationV2ConversationMessage;
+  readonly turnItem: OrchestrationV2TurnItem;
+} {
+  const message: OrchestrationV2ConversationMessage = {
+    createdBy: "agent",
+    creationSource: "provider",
+    id: input.messageId,
+    threadId: input.threadId,
+    runId: null,
+    nodeId: input.rootNodeId,
+    role: input.role,
+    text: input.text,
+    attachments: [],
+    streaming: false,
+    createdAt: input.now,
+    updatedAt: input.now,
+  };
+  const base = {
+    id: input.turnItemId,
+    threadId: input.threadId,
+    runId: null,
+    nodeId: input.rootNodeId,
+    providerThreadId: input.providerThreadId,
+    providerTurnId: input.providerTurnId,
+    nativeItemRef: input.nativeItemRef,
+    parentItemId: null,
+    ordinal: input.ordinal,
+    status: "completed" as const,
+    title: null,
+    startedAt: input.now,
+    completedAt: input.now,
+    updatedAt: input.now,
+    messageId: input.messageId,
+    text: input.text,
+  };
+  const turnItem: OrchestrationV2TurnItem =
+    input.role === "user"
+      ? {
+          ...base,
+          createdBy: "agent",
+          creationSource: "provider",
+          type: "user_message",
+          inputIntent: "turn_start",
+          attachments: [],
+        }
+      : {
+          ...base,
+          type: "assistant_message",
+          streaming: false,
+        };
+  return { message, turnItem };
+}
+
+export function subagentResultForRun(
+  projection: OrchestrationV2ThreadProjection,
+  run: OrchestrationV2Run,
+): {
+  readonly text: string;
+  readonly messageId: OrchestrationV2ConversationMessage["id"] | null;
+  readonly turnItemId: OrchestrationV2TurnItem["id"] | null;
+} {
+  const message =
+    projection.messages
+      .filter(
+        (candidate) =>
+          candidate.runId === run.id &&
+          candidate.role === "assistant" &&
+          candidate.text.trim().length > 0,
+      )
+      .toSorted(
+        (left, right) =>
+          DateTime.toEpochMillis(right.updatedAt) - DateTime.toEpochMillis(left.updatedAt),
+      )[0] ?? null;
+  const turnItem =
+    projection.turnItems
+      .filter(
+        (
+          candidate,
+        ): candidate is Extract<OrchestrationV2TurnItem, { readonly type: "assistant_message" }> =>
+          candidate.runId === run.id &&
+          candidate.type === "assistant_message" &&
+          candidate.text.trim().length > 0,
+      )
+      .toSorted((left, right) => right.ordinal - left.ordinal)[0] ?? null;
+  const text =
+    message?.text ??
+    turnItem?.text ??
+    (run.status === "completed"
+      ? "Child task completed without an assistant result."
+      : `Child task ended with status ${run.status}.`);
+  return {
+    text,
+    messageId: message?.id ?? turnItem?.messageId ?? null,
+    turnItemId: turnItem?.id ?? null,
+  };
+}
diff --git a/apps/server/src/orchestration-v2/TODO.md b/apps/server/src/orchestration-v2/TODO.md
new file mode 100644
index 000000000000..8b2d93c0bf78
--- /dev/null
+++ b/apps/server/src/orchestration-v2/TODO.md
@@ -0,0 +1,168 @@
+# Orchestration V2 TODO
+
+This file tracks remaining backend-oriented V2 work. Architecture-level intent lives in
+[`docs/orchestration-v2`](../../../../docs/orchestration-v2); this file is the local
+implementation checklist for `apps/server/src/orchestration-v2`.
+
+## Current Baseline
+
+- V2 commands/events/projections are server-owned and replayable.
+- Message dispatch supports start, steer, queue, queue reorder, promote queued message to steer,
+  interrupt, and provider switch command shapes.
+- Checkpoint rollback is currently a full revert: filesystem checkpoint restore, provider thread
+  rollback, stale checkpoint marking, and later run/node `rolled_back` projection state.
+- Codex same-provider fork is lazy: `thread.fork` records lineage and pending transfer, and first
+  dispatch resolves native Codex fork. Earlier source-point forks use native `thread/fork` followed
+  by fork-local `thread/rollback`.
+- Native Codex fork-from-earlier-run has a real replay-backed test fixture:
+  `testkit/fixtures/thread_fork_native_prior_turn`.
+- Merge-back from a fork into its source thread records a `merge_back` context transfer, materializes
+  a `fork_delta_summary` context handoff, and injects that handoff into the next source-thread run.
+
+## Projection Hardening
+
+Target docs:
+
+- [`core-graph-and-data-model.md`](../../../../docs/orchestration-v2/core-graph-and-data-model.md)
+- [`thread-lineage-and-context-transfer.md`](../../../../docs/orchestration-v2/thread-lineage-and-context-transfer.md)
+- [`testing-strategy.md`](../../../../docs/orchestration-v2/testing-strategy.md)
+
+TODO:
+
+- [x] Add end-to-end projection assertions for forked threads, not only provider-context behavior.
+      The fork projection should show inherited user-visible items through the source point plus an
+      explicit fork marker.
+- [x] Decide and implement the projection representation for inherited fork history:
+      referenced lineage overlay vs physically duplicated projection items. Prefer referenced overlay
+      unless product requirements need independent editable history.
+- [x] Add local visible projection assertions to non-fork replay fixtures:
+      `visibleTurnItems` mirrors canonical local `turnItems` for simple, multi-turn, queue,
+      steering, interrupt, rollback, planning, tool, and web-search fixtures.
+- [ ] Ensure projections render rollback state consistently:
+      rolled-back runs/nodes/items, stale checkpoints, and active provider thread cursor.
+- [ ] Add projection tests for interrupt edge cases:
+      provider emits chunks after interrupt requested, provider ignores/delays interrupt, interrupt is
+      immediately followed by queue/steer/start.
+- [ ] Add projection tests for queue/steer flows:
+      queued message visibility, queue reorder, promote queued message to steer, and post-interrupt
+      dispatch visibility.
+
+## Context Transfer And Merge-Back
+
+Target docs:
+
+- [`thread-lineage-and-context-transfer.md`](../../../../docs/orchestration-v2/thread-lineage-and-context-transfer.md)
+- [`provider-switching-and-context.md`](../../../../docs/orchestration-v2/provider-switching-and-context.md)
+
+TODO:
+
+- [x] Implement merge-back from a fork into its source thread:
+      source fork point as `basePoint`, fork latest stable point as `sourcePoint`, and source-thread
+      next user message as the consuming run.
+- [x] Materialize delta context artifacts for merge-back and persist them as auditable
+      `ContextHandoff` records.
+- [x] Add replay-backed integration coverage for merge-back:
+      fork, explore in fork, merge back, then assert source provider receives only the fork delta plus
+      the new user message.
+- [ ] Implement portable context handoff for cross-provider forks and same-thread provider switches.
+- [ ] Define explicit failure states for unresolved context transfers:
+      missing source point, unsupported provider capability, context too large, source projection not
+      stable, and adapter resolution failure.
+
+## Capability And Policy Model
+
+Target docs:
+
+- [`provider-capability-system.md`](../../../../docs/orchestration-v2/provider-capability-system.md)
+- [`feature-lifecycles.md`](../../../../docs/orchestration-v2/feature-lifecycles.md)
+
+TODO:
+
+- [ ] Audit capability use against the documented nested `OrchestrationV2ProviderCapabilities`
+      shape and fill any behavior gaps.
+- [ ] Keep orchestration decisions capability/policy driven. Shared runtime code should not branch on
+      provider name except at adapter registration/resolution boundaries.
+- [ ] Make optional adapter methods impossible to call without going through a policy wrapper or a
+      capability-checked branch.
+- [ ] Add typed capability/policy errors for:
+      native fork unavailable, rollback unavailable, steering unavailable, interrupt unavailable,
+      context handoff unavailable, and weak terminal status.
+- [ ] Add capability-aware tests using real adapter/test layers at provider boundaries only. Do not mock
+      core orchestration policy.
+
+## Checkpoint And Rollback
+
+Target docs:
+
+- [`feature-lifecycles.md`](../../../../docs/orchestration-v2/feature-lifecycles.md)
+- [`core-graph-and-data-model.md`](../../../../docs/orchestration-v2/core-graph-and-data-model.md)
+
+TODO:
+
+- [ ] Document current `checkpoint.rollback` command semantics in contracts/docs as full revert:
+      filesystem restore plus provider conversation rollback.
+- [ ] Decide whether we need separate commands for conversation-only rollback and filesystem-only
+      restore. Do not add them until a real product flow needs them.
+- [ ] Add tests for rollback after fork and rollback inside fork:
+      source rollback should not corrupt child lineage, and fork rollback should not mutate source
+      provider state.
+- [ ] Validate rollback behavior when no active provider thread exists. Current behavior fails; decide
+      whether a filesystem-only rollback fallback is useful or too surprising.
+
+## Provider Switching And Second Adapter
+
+Target docs:
+
+- [`provider-switching-and-context.md`](../../../../docs/orchestration-v2/provider-switching-and-context.md)
+- [`provider-capability-system.md`](../../../../docs/orchestration-v2/provider-capability-system.md)
+- [`testing-strategy.md`](../../../../docs/orchestration-v2/testing-strategy.md)
+
+TODO:
+
+- [x] Add Claude replay fixture definitions for recorded fixtures, with TODO fixture slots that
+      reference the corresponding Codex transcripts and V2 docs.
+- [ ] Promote Claude `simple` from the replay adapter to a real `ClaudeAdapterV2` replay test:
+      live and replay both consume an injected Agent SDK `query()` async iterable.
+- [ ] Record Claude `multi_turn` from real usage and prove native session/thread continuation.
+- [ ] Record Claude `tool_call_read_only` from real usage and prove read-only tool projection without
+      approvals.
+- [ ] Keep unrecorded Claude fixtures out of `testkit/fixtures/index.ts` until each has a real
+      transcript and real adapter assertions.
+- [ ] Add the second adapter once these vv0 Claude slices are stable enough to validate
+      cross-provider behavior.
+- [ ] Use the second adapter to test:
+      cross-provider fork, same-thread provider switch, returning to a previous provider thread with
+      delta handoff, and unsupported capability fallback paths.
+
+## Subagents
+
+Target docs:
+
+- [`thread-lineage-and-context-transfer.md`](../../../../docs/orchestration-v2/thread-lineage-and-context-transfer.md)
+- [`provider-capability-system.md`](../../../../docs/orchestration-v2/provider-capability-system.md)
+
+TODO:
+
+- [x] Add provider-native subagent observation for Codex and Claude replay-backed fixtures.
+- [ ] Model native subagents and app-owned cross-provider subagents as related thread/subthread graph
+      entries with different creator/lifecycle policy.
+- [ ] Preserve native provider subagent refs where available, but do not make the app graph depend on
+      provider-native ids as primary ids.
+- [ ] Add deeper tests for subagent wait, close, result transfer, pending approvals, failed/stopped
+      tasks, and fork-from-subagent behavior.
+
+FOOD FOR THOUGHT:
+
+- Custom t3code tools/mcp_server that lets agents spawn subagents of other providers powered by the T3 Orchestrator
+
+## Debugger-Only Work
+
+- Keep debugger UI useful but temporary. Backend semantics and projections should be the source of
+  truth.
+- [x] Wire the debugger thread tree to persisted V2 shell state through websocket RPC instead of
+      debugger-local thread discovery state.
+- Continue exposing lightweight controls for new backend surfaces:
+  fork from response, new thread, full revert from user message checkpoint, merge-back, and provider
+  switch.
+- Avoid adding mock backend behavior for debugger convenience. In-memory debugger state is fine for
+  layout affordances, but backend behavior must route through V2 commands/projections.
diff --git a/apps/server/src/orchestration-v2/ThreadForkService.test.ts b/apps/server/src/orchestration-v2/ThreadForkService.test.ts
new file mode 100644
index 000000000000..9315783c8541
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ThreadForkService.test.ts
@@ -0,0 +1,148 @@
+import { assert, it } from "@effect/vitest";
+import {
+  ContextTransferId,
+  MessageId,
+  type ModelSelection,
+  type OrchestrationV2AppThread,
+  type OrchestrationV2Run,
+  type OrchestrationV2ThreadProjection,
+  ProjectId,
+  ProviderInstanceId,
+  ProviderThreadId,
+  RunId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+
+import { layer, ThreadForkServiceV2 } from "./ThreadForkService.ts";
+
+const sourceThreadId = ThreadId.make("thread:fork-snoozed-source");
+const targetThreadId = ThreadId.make("thread:fork-awake-target");
+const sourceRunId = RunId.make("run:fork-snoozed-source");
+const providerInstanceId = ProviderInstanceId.make("codex");
+const modelSelection = {
+  instanceId: providerInstanceId,
+  model: "gpt-5.4",
+} satisfies ModelSelection;
+const sourceCreatedAt = DateTime.makeUnsafe("2026-07-24T09:00:00.000Z");
+const snoozedAt = DateTime.makeUnsafe("2026-07-24T09:05:00.000Z");
+const snoozedUntil = DateTime.makeUnsafe("2026-07-25T09:00:00.000Z");
+const forkCreatedAt = DateTime.makeUnsafe("2026-07-24T09:10:00.000Z");
+
+function makeSourceThread(): OrchestrationV2AppThread {
+  return {
+    createdBy: "user",
+    creationSource: "web",
+    id: sourceThreadId,
+    projectId: ProjectId.make("project:fork-snooze"),
+    title: "Snoozed source",
+    providerInstanceId,
+    modelSelection,
+    runtimeMode: "full-access",
+    interactionMode: "plan",
+    branch: "feature/source",
+    worktreePath: "/tmp/source-worktree",
+    activeProviderThreadId: ProviderThreadId.make("provider-thread:fork-snoozed-source"),
+    lineage: {
+      parentThreadId: null,
+      relationshipToParent: null,
+      rootThreadId: sourceThreadId,
+    },
+    forkedFrom: null,
+    createdAt: sourceCreatedAt,
+    updatedAt: snoozedAt,
+    archivedAt: null,
+    settledOverride: null,
+    settledAt: null,
+    lastVisitedAt: null,
+    snoozedUntil,
+    snoozedAt,
+    deletedAt: null,
+  };
+}
+
+function makeCompletedSourceRun(): OrchestrationV2Run {
+  return {
+    id: sourceRunId,
+    threadId: sourceThreadId,
+    ordinal: 1,
+    providerInstanceId,
+    modelSelection,
+    providerThreadId: ProviderThreadId.make("provider-thread:fork-snoozed-source"),
+    userMessageId: MessageId.make("message:fork-snoozed-source"),
+    rootNodeId: null,
+    activeAttemptId: null,
+    status: "completed",
+    queuePosition: null,
+    requestedAt: sourceCreatedAt,
+    startedAt: sourceCreatedAt,
+    completedAt: snoozedAt,
+    checkpointId: null,
+    contextHandoffId: null,
+  };
+}
+
+it.effect("keeps a fork awake when its source thread is snoozed", () =>
+  Effect.gen(function* () {
+    const sourceThread = makeSourceThread();
+    const sourceRun = makeCompletedSourceRun();
+    const sourceProjection: OrchestrationV2ThreadProjection = {
+      thread: sourceThread,
+      runs: [sourceRun],
+      attempts: [],
+      nodes: [],
+      subagents: [],
+      providerSessions: [],
+      providerThreads: [],
+      providerTurns: [],
+      runtimeRequests: [],
+      messages: [],
+      plans: [],
+      turnItems: [],
+      checkpointScopes: [],
+      checkpoints: [],
+      contextHandoffs: [],
+      contextTransfers: [],
+      visibleTurnItems: [],
+      updatedAt: snoozedAt,
+    };
+    const service = yield* ThreadForkServiceV2;
+    const result = yield* service.plan({
+      sourceProjection,
+      sourceRun,
+      sourceProviderThread: undefined,
+      canonicalSourcePoint: {
+        threadId: sourceThreadId,
+        runId: sourceRunId,
+      },
+      transferId: ContextTransferId.make("context-transfer:fork-snoozed-source"),
+      targetThreadId,
+      title: "Awake fork",
+      createdBy: "user",
+      creationSource: "mobile",
+      createdAt: forkCreatedAt,
+    });
+
+    assert.isNull(result.targetThread.snoozedUntil);
+    assert.isNull(result.targetThread.snoozedAt);
+    assert.equal(result.targetThread.projectId, sourceThread.projectId);
+    assert.equal(result.targetThread.providerInstanceId, sourceThread.providerInstanceId);
+    assert.deepEqual(result.targetThread.modelSelection, sourceThread.modelSelection);
+    assert.equal(result.targetThread.runtimeMode, sourceThread.runtimeMode);
+    assert.equal(result.targetThread.interactionMode, sourceThread.interactionMode);
+    assert.equal(result.targetThread.branch, sourceThread.branch);
+    assert.equal(result.targetThread.worktreePath, sourceThread.worktreePath);
+    assert.isNull(result.targetThread.activeProviderThreadId);
+    assert.deepEqual(result.targetThread.lineage, {
+      parentThreadId: sourceThreadId,
+      relationshipToParent: "fork",
+      rootThreadId: sourceThreadId,
+    });
+    assert.deepEqual(result.targetThread.forkedFrom, {
+      type: "run",
+      threadId: sourceThreadId,
+      runId: sourceRunId,
+    });
+  }).pipe(Effect.provide(layer)),
+);
diff --git a/apps/server/src/orchestration-v2/ThreadForkService.ts b/apps/server/src/orchestration-v2/ThreadForkService.ts
new file mode 100644
index 000000000000..f712516b1a08
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ThreadForkService.ts
@@ -0,0 +1,116 @@
+import {
+  ContextTransferId,
+  OrchestrationV2Actor,
+  OrchestrationV2AppThread,
+  OrchestrationV2ContextSourcePoint,
+  OrchestrationV2ContextTransfer,
+  OrchestrationV2CreationSource,
+  OrchestrationV2ProviderThread,
+  OrchestrationV2Run,
+  OrchestrationV2ThreadProjection,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as Context from "effect/Context";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Schema from "effect/Schema";
+
+export interface ThreadForkPlanV2 {
+  readonly targetThread: OrchestrationV2AppThread;
+  readonly transfer: OrchestrationV2ContextTransfer;
+}
+
+export class ThreadForkPlanError extends Schema.TaggedErrorClass<ThreadForkPlanError>()(
+  "ThreadForkPlanError",
+  {
+    sourceThreadId: ThreadId,
+    targetThreadId: ThreadId,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {}
+
+export interface ThreadForkServiceV2Shape {
+  readonly plan: (input: {
+    readonly sourceProjection: OrchestrationV2ThreadProjection;
+    readonly sourceRun: OrchestrationV2Run;
+    readonly sourceProviderThread: OrchestrationV2ProviderThread | undefined;
+    readonly canonicalSourcePoint: OrchestrationV2ContextSourcePoint;
+    readonly transferId: ContextTransferId;
+    readonly targetThreadId: ThreadId;
+    readonly title?: string;
+    readonly createdBy: OrchestrationV2Actor;
+    readonly creationSource: OrchestrationV2CreationSource;
+    readonly createdAt: DateTime.Utc;
+  }) => Effect.Effect<ThreadForkPlanV2, ThreadForkPlanError>;
+}
+
+export class ThreadForkServiceV2 extends Context.Service<
+  ThreadForkServiceV2,
+  ThreadForkServiceV2Shape
+>()("t3/orchestration-v2/ThreadForkService/ThreadForkServiceV2") {}
+
+export const layer: Layer.Layer<ThreadForkServiceV2> = Layer.succeed(
+  ThreadForkServiceV2,
+  ThreadForkServiceV2.of({
+    plan: (input) =>
+      Effect.gen(function* () {
+        if (input.sourceRun.status !== "completed") {
+          return yield* new ThreadForkPlanError({
+            sourceThreadId: input.sourceProjection.thread.id,
+            targetThreadId: input.targetThreadId,
+            cause: `Fork source run ${input.sourceRun.id} is ${input.sourceRun.status}.`,
+          });
+        }
+        const targetThread: OrchestrationV2AppThread = {
+          ...input.sourceProjection.thread,
+          createdBy: input.createdBy,
+          creationSource: input.creationSource,
+          id: input.targetThreadId,
+          title: input.title ?? `${input.sourceProjection.thread.title} fork`,
+          activeProviderThreadId: null,
+          lineage: {
+            parentThreadId: input.sourceProjection.thread.id,
+            relationshipToParent: "fork",
+            rootThreadId: input.sourceProjection.thread.lineage.rootThreadId,
+          },
+          forkedFrom: {
+            type: "run",
+            threadId: input.sourceProjection.thread.id,
+            runId: input.sourceRun.id,
+          },
+          createdAt: input.createdAt,
+          updatedAt: input.createdAt,
+          archivedAt: null,
+          settledOverride: null,
+          settledAt: null,
+          snoozedUntil: null,
+          snoozedAt: null,
+          lastVisitedAt: null,
+          deletedAt: null,
+        };
+        const transfer: OrchestrationV2ContextTransfer = {
+          id: input.transferId,
+          type: "fork",
+          sourceThreadId: input.sourceProjection.thread.id,
+          targetThreadId: input.targetThreadId,
+          sourcePoint: input.canonicalSourcePoint,
+          basePoint: null,
+          sourceProviderInstanceId: input.sourceRun.providerInstanceId,
+          targetProviderInstanceId: null,
+          targetRunId: null,
+          status: "pending",
+          resolution: null,
+          createdBy: input.createdBy,
+          error:
+            input.sourceProviderThread?.nativeThreadRef?.strength === "strong"
+              ? null
+              : "Source provider thread does not expose a strong native thread ref.",
+          createdAt: input.createdAt,
+          updatedAt: input.createdAt,
+          consumedAt: null,
+        };
+        return { targetThread, transfer };
+      }),
+  }),
+);
diff --git a/apps/server/src/orchestration-v2/ThreadLaunchService.test.ts b/apps/server/src/orchestration-v2/ThreadLaunchService.test.ts
new file mode 100644
index 000000000000..7f8b86b80c21
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ThreadLaunchService.test.ts
@@ -0,0 +1,1098 @@
+import { assert, it, vi } from "@effect/vitest";
+import {
+  CommandId,
+  DEFAULT_SERVER_SETTINGS,
+  MessageId,
+  ProjectId,
+  ProviderDriverKind,
+  ProviderInstanceId,
+  type ServerProvider,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as Deferred from "effect/Deferred";
+import * as DateTime from "effect/DateTime";
+import * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Ref from "effect/Ref";
+import * as SqlClient from "effect/unstable/sql/SqlClient";
+import * as TestClock from "effect/testing/TestClock";
+
+import * as GitWorkflow from "../git/GitWorkflowService.ts";
+import { SqlitePersistenceMemory } from "../persistence/Layers/Sqlite.ts";
+import { ProjectionProjectRepository } from "../persistence/Services/ProjectionProjects.ts";
+import * as ProjectService from "../project/ProjectService.ts";
+import * as ProjectSetupScriptRunner from "../project/ProjectSetupScriptRunner.ts";
+import { makeProviderRegistryLayer } from "../provider/testUtils/providerRegistryMock.ts";
+import * as ServerSettings from "../serverSettings.ts";
+import * as TextGeneration from "../textGeneration/TextGeneration.ts";
+import { CodexProviderCapabilitiesV2 } from "./Adapters/CodexAdapterV2.ts";
+import * as CommandReceiptStore from "./CommandReceiptStore.ts";
+import * as EffectOutbox from "./EffectOutbox.ts";
+import * as IdAllocator from "./IdAllocator.ts";
+import type { ProviderAdapterV2Shape } from "./ProviderAdapter.ts";
+import * as ProviderAdapterRegistry from "./ProviderAdapterRegistry.ts";
+import * as ThreadLaunch from "./ThreadLaunchService.ts";
+import * as ThreadManagement from "./ThreadManagementService.ts";
+import * as ThreadTitleRegeneration from "./ThreadTitleRegenerationService.ts";
+import { makeOrchestratorV2ReplayLayerWithRegistry } from "./testkit/ProviderReplayHarness.ts";
+
+const projectId = ProjectId.make("project:launch-test");
+const modelSelection = {
+  instanceId: ProviderInstanceId.make("codex"),
+  model: "gpt-5.1-codex",
+} as const;
+const project = {
+  id: projectId,
+  title: "Project",
+  workspaceRoot: "/repo",
+  repositoryIdentity: null,
+  faviconPath: null,
+  defaultModelSelection: modelSelection,
+  defaultThreadEnvMode: null,
+  scripts: [],
+  createdAt: "2026-06-20T00:00:00.000Z",
+  updatedAt: "2026-06-20T00:00:00.000Z",
+  deletedAt: null,
+} as const;
+
+const adapter = {
+  instanceId: modelSelection.instanceId,
+  driver: ProviderDriverKind.make("codex"),
+  getCapabilities: () => Effect.succeed(CodexProviderCapabilitiesV2),
+  planSelectionTransition: () => Effect.succeed({ type: "apply_on_next_turn" as const }),
+  openSession: () => Effect.die("provider execution is disabled in launch tests"),
+} as ProviderAdapterV2Shape;
+
+interface HarnessOptions {
+  readonly createWorktree?: GitWorkflow.GitWorkflowService["Service"]["createWorktree"];
+  readonly renameBranch?: GitWorkflow.GitWorkflowService["Service"]["renameBranch"];
+  readonly runSetup?: ProjectSetupScriptRunner.ProjectSetupScriptRunner["Service"]["runForThread"];
+  readonly generateTitle?: TextGeneration.TextGeneration["Service"]["generateThreadTitle"];
+  readonly generateBranchName?: TextGeneration.TextGeneration["Service"]["generateBranchName"];
+  readonly serverSettings?: Parameters<typeof ServerSettings.layerTest>[0];
+  readonly providers?: ReadonlyArray<ServerProvider>;
+}
+
+function makeHarness(options: HarnessOptions = {}) {
+  const database = SqlitePersistenceMemory;
+  const registry = ProviderAdapterRegistry.makeLayer([adapter]);
+  const orchestrator = makeOrchestratorV2ReplayLayerWithRegistry(
+    { name: "thread-launch" },
+    registry,
+    { databaseLayer: database, runEffectWorker: false },
+  );
+  const threadManagement = ThreadManagement.layer.pipe(Layer.provide(orchestrator));
+  const receipts = CommandReceiptStore.layer.pipe(Layer.provide(database));
+  const outbox = EffectOutbox.layer.pipe(Layer.provide(database));
+  const createWorktree = vi.fn(
+    options.createWorktree ??
+      ((input) =>
+        Effect.succeed({
+          worktree: { path: "/repo-worktrees/feature", refName: input.newRefName, headSha: "abc" },
+        } as never)),
+  );
+  const renameBranch = vi.fn(
+    options.renameBranch ?? ((input) => Effect.succeed({ branch: input.newBranch })),
+  );
+  const runSetup = vi.fn(
+    options.runSetup ?? (() => Effect.succeed({ status: "no-script" as const })),
+  );
+  const generateBranchName = vi.fn(
+    options.generateBranchName ?? (() => Effect.succeed({ branch: "generated-branch" })),
+  );
+  const generateThreadTitle = vi.fn(
+    options.generateTitle ?? (() => Effect.succeed({ title: "Generated title" })),
+  );
+  const externalServices = Layer.mergeAll(
+    Layer.succeed(ProjectService.ProjectService, {
+      create: () => Effect.die("unused"),
+      bootstrap: () => Effect.die("unused"),
+      update: () => Effect.die("unused"),
+      delete: () => Effect.die("unused"),
+      getById: (id) => Effect.succeed(id === projectId ? Option.some(project) : Option.none()),
+      getByWorkspaceRoot: () => Effect.succeed(Option.some(project)),
+      snapshot: Effect.die("unused"),
+    }),
+    Layer.mock(GitWorkflow.GitWorkflowService)({
+      createWorktree,
+      renameBranch,
+      fetchRemote: () => Effect.void,
+      removeWorktree: () => Effect.void,
+      resolveRemoteTrackingCommit: () =>
+        Effect.succeed({ commitSha: "remote-main-sha", remoteRefName: "origin/main" }),
+    }),
+    Layer.succeed(ProjectSetupScriptRunner.ProjectSetupScriptRunner, {
+      runForThread: runSetup,
+    }),
+    Layer.mock(TextGeneration.TextGeneration)({
+      generateThreadTitle,
+      generateBranchName,
+    }),
+    ServerSettings.layerTest(options.serverSettings),
+    makeProviderRegistryLayer(options.providers),
+  );
+  const launch = ThreadLaunch.layer.pipe(
+    Layer.provide(Layer.mergeAll(externalServices, threadManagement, receipts, IdAllocator.layer)),
+  );
+  const projectedProjects = Layer.mock(ProjectionProjectRepository)({
+    getById: ({ projectId: requestedProjectId }) =>
+      Effect.succeed(
+        requestedProjectId === projectId
+          ? Option.some({
+              projectId,
+              title: project.title,
+              workspaceRoot: project.workspaceRoot,
+              defaultModelSelection: project.defaultModelSelection,
+              defaultThreadEnvMode: null,
+              scripts: project.scripts,
+              createdAt: project.createdAt,
+              updatedAt: project.updatedAt,
+              deletedAt: project.deletedAt,
+            })
+          : Option.none(),
+      ),
+  });
+  const titleRegeneration = ThreadTitleRegeneration.layer.pipe(
+    Layer.provide(Layer.mergeAll(threadManagement, projectedProjects, externalServices)),
+  );
+  return {
+    layer: Layer.mergeAll(launch, threadManagement, titleRegeneration, outbox, database),
+    createWorktree,
+    renameBranch,
+    generateBranchName,
+    generateThreadTitle,
+    runSetup,
+  };
+}
+
+function launchInput(input: {
+  readonly command: string;
+  readonly thread: string;
+  readonly message?: string;
+  readonly workspace?: ThreadLaunch.ThreadLaunchWorkspaceStrategy;
+}) {
+  return {
+    commandId: CommandId.make(input.command),
+    threadId: ThreadId.make(input.thread),
+    projectId,
+    title: "New thread",
+    modelSelection,
+    runtimeMode: "full-access" as const,
+    interactionMode: "default" as const,
+    workspaceStrategy: input.workspace ?? { type: "root" as const },
+    ...(input.message === undefined
+      ? {}
+      : {
+          initialMessage: {
+            messageId: MessageId.make(`${input.message}:id`),
+            text: input.message,
+            attachments: [],
+          },
+        }),
+    createdBy: "user" as const,
+    creationSource: "web" as const,
+  };
+}
+
+function waitUntil<E, R>(predicate: () => Effect.Effect<boolean, E, R>): Effect.Effect<void, E, R> {
+  return Effect.gen(function* () {
+    for (let attempt = 0; attempt < 200; attempt += 1) {
+      if (yield* predicate()) return;
+      yield* Effect.promise(
+        () =>
+          new Promise<void>((resolve) => {
+            setImmediate(resolve);
+          }),
+      );
+    }
+    assert.fail("Condition was not reached before timeout.");
+  });
+}
+
+it.effect("returns a visible preparing message while provisioning is still blocked", () =>
+  Effect.gen(function* () {
+    const worktreeEntered = yield* Deferred.make<void>();
+    const allowWorktree = yield* Deferred.make<void>();
+    const setupEntered = yield* Deferred.make<void>();
+    const allowSetup = yield* Deferred.make<void>();
+    const harness = makeHarness({
+      createWorktree: () =>
+        Deferred.succeed(worktreeEntered, undefined).pipe(
+          Effect.andThen(Deferred.await(allowWorktree)),
+          Effect.as({
+            worktree: { path: "/repo-worktrees/feature", refName: "feature", headSha: "abc" },
+          } as never),
+        ),
+      runSetup: () =>
+        Deferred.succeed(setupEntered, undefined).pipe(
+          Effect.andThen(Deferred.await(allowSetup)),
+          Effect.as({ status: "no-script" as const }),
+        ),
+    });
+    yield* Effect.gen(function* () {
+      const launches = yield* ThreadLaunch.ThreadLaunchService;
+      const outbox = yield* EffectOutbox.EffectOutboxV2;
+      const threads = yield* ThreadManagement.ThreadManagementService;
+      const input = launchInput({
+        command: "command:launch:blocked",
+        thread: "thread:launch:blocked",
+        message: "Build the feature",
+        workspace: { type: "worktree", baseRef: "main" },
+      });
+      const launched = yield* launches.launch(input);
+      assert.equal(launched.projection.messages[0]?.text, "Build the feature");
+      assert.equal(launched.projection.runs[0]?.status, "preparing");
+      assert.equal(
+        launched.projection.turnItems.find((item) => item.type === "command_execution")?.status,
+        "running",
+      );
+      yield* Deferred.await(worktreeEntered);
+      let current = yield* threads.getThreadProjection(launched.threadId);
+      assert.equal(
+        current.turnItems.find((item) => item.type === "command_execution")?.title,
+        "Preparing worktree",
+      );
+      yield* Deferred.succeed(allowWorktree, undefined);
+      const entered = yield* Deferred.await(setupEntered).pipe(
+        Effect.timeoutOption(Duration.seconds(2)),
+      );
+      if (Option.isNone(entered)) {
+        current = yield* threads.getThreadProjection(launched.threadId);
+        assert.fail(
+          `Setup was not reached; run=${current.runs[0]?.status ?? "missing"}, worklog=${current.turnItems.find((item) => item.type === "command_execution")?.title ?? "missing"}.`,
+        );
+      }
+      current = yield* threads.getThreadProjection(launched.threadId);
+      assert.equal(
+        current.turnItems.find((item) => item.type === "command_execution")?.title,
+        "Starting setup script",
+      );
+      const prematureEffects = yield* outbox.listByCommandId(
+        CommandId.make("command:launch:blocked:initial-message"),
+      );
+      assert.isEmpty(prematureEffects);
+      yield* Deferred.succeed(allowSetup, undefined);
+    }).pipe(Effect.provide(harness.layer));
+  }),
+);
+
+it.effect("provisions independent launches concurrently instead of behind a global semaphore", () =>
+  Effect.gen(function* () {
+    const setupCount = yield* Ref.make(0);
+    const bothEntered = yield* Deferred.make<void>();
+    const allowSetup = yield* Deferred.make<void>();
+    const harness = makeHarness({
+      runSetup: () =>
+        Ref.updateAndGet(setupCount, (count) => count + 1).pipe(
+          Effect.tap((count) =>
+            count === 2 ? Deferred.succeed(bothEntered, undefined) : Effect.void,
+          ),
+          Effect.andThen(Deferred.await(allowSetup)),
+          Effect.as({ status: "no-script" as const }),
+        ),
+    });
+    yield* Effect.gen(function* () {
+      const launches = yield* ThreadLaunch.ThreadLaunchService;
+      const results = yield* Effect.all(
+        [
+          launches.launch(
+            launchInput({
+              command: "command:launch:concurrent-a",
+              thread: "thread:launch:concurrent-a",
+              message: "First",
+            }),
+          ),
+          launches.launch(
+            launchInput({
+              command: "command:launch:concurrent-b",
+              thread: "thread:launch:concurrent-b",
+              message: "Second",
+            }),
+          ),
+        ],
+        { concurrency: "unbounded" },
+      );
+      assert.deepEqual(
+        results.map((result) => result.projection.runs[0]?.status),
+        ["preparing", "preparing"],
+      );
+      yield* Deferred.await(bothEntered);
+      assert.equal(yield* Ref.get(setupCount), 2);
+      yield* Deferred.succeed(allowSetup, undefined);
+    }).pipe(Effect.provide(harness.layer));
+  }),
+);
+
+it.effect("enqueues provider work only after setup has been initiated", () =>
+  Effect.gen(function* () {
+    const setupEntered = yield* Deferred.make<void>();
+    const allowSetup = yield* Deferred.make<void>();
+    const harness = makeHarness({
+      runSetup: () =>
+        Deferred.succeed(setupEntered, undefined).pipe(
+          Effect.andThen(Deferred.await(allowSetup)),
+          Effect.as({
+            status: "started" as const,
+            scriptId: "setup",
+            scriptName: "Setup",
+            terminalId: "setup",
+            cwd: "/repo",
+          }),
+        ),
+    });
+    yield* Effect.gen(function* () {
+      const launches = yield* ThreadLaunch.ThreadLaunchService;
+      const outbox = yield* EffectOutbox.EffectOutboxV2;
+      const threads = yield* ThreadManagement.ThreadManagementService;
+      const input = launchInput({
+        command: "command:launch:release",
+        thread: "thread:launch:release",
+        message: "Start after setup",
+        workspace: { type: "worktree", baseRef: "main" },
+      });
+      const launched = yield* launches.launch(input);
+      yield* Deferred.await(setupEntered);
+      assert.isEmpty(
+        yield* outbox.listByCommandId(CommandId.make("command:launch:release:release")),
+      );
+      yield* Deferred.succeed(allowSetup, undefined);
+      yield* waitUntil(() =>
+        outbox
+          .listByCommandId(CommandId.make("command:launch:release:release"))
+          .pipe(Effect.map((effects) => effects.length === 1)),
+      );
+      const projection = yield* threads.getThreadProjection(launched.threadId);
+      assert.equal(projection.runs[0]?.status, "starting");
+      assert.equal(projection.checkpointScopes[0]?.cwd, "/repo-worktrees/feature");
+      assert.equal(
+        projection.turnItems.find((item) => item.type === "command_execution")?.status,
+        "completed",
+      );
+    }).pipe(Effect.provide(harness.layer));
+  }),
+);
+
+it.effect(
+  "queues follow-up messages behind preparation and checkpoints them in the final workspace",
+  () =>
+    Effect.gen(function* () {
+      const setupEntered = yield* Deferred.make<void>();
+      const failSetup = yield* Deferred.make<void>();
+      const harness = makeHarness({
+        runSetup: () =>
+          Deferred.succeed(setupEntered, undefined).pipe(
+            Effect.andThen(Deferred.await(failSetup)),
+            Effect.andThen(Effect.fail(new Error("setup failed") as never)),
+          ),
+      });
+      yield* Effect.gen(function* () {
+        const launches = yield* ThreadLaunch.ThreadLaunchService;
+        const threads = yield* ThreadManagement.ThreadManagementService;
+        const launched = yield* launches.launch(
+          launchInput({
+            command: "command:launch:queued-during-preparation",
+            thread: "thread:launch:queued-during-preparation",
+            message: "Prepare the workspace",
+            workspace: { type: "worktree", baseRef: "main" },
+          }),
+        );
+        yield* Deferred.await(setupEntered);
+
+        const followUp = yield* threads.sendToThread({
+          projectId,
+          commandId: CommandId.make("command:launch:queued-follow-up"),
+          threadId: launched.threadId,
+          messageId: MessageId.make("message:launch:queued-follow-up"),
+          text: "Run after preparation",
+          attachments: [],
+          mode: "auto",
+          createdBy: "user",
+          creationSource: "web",
+        });
+        assert.equal(followUp.delivery, "queued");
+        assert.equal(followUp.run.status, "queued");
+        assert.equal(
+          followUp.projection.nodes.find(
+            (node) => node.runId === followUp.run.id && node.kind === "root_turn",
+          )?.checkpointScopeId,
+          null,
+        );
+
+        yield* Deferred.succeed(failSetup, undefined);
+        yield* waitUntil(() =>
+          threads
+            .getThreadProjection(launched.threadId)
+            .pipe(
+              Effect.map(
+                (projection) =>
+                  projection.runs.find((run) => run.id === followUp.run.id)?.status === "starting",
+              ),
+            ),
+        );
+
+        const projection = yield* threads.getThreadProjection(launched.threadId);
+        const rootNode = projection.nodes.find(
+          (node) => node.runId === followUp.run.id && node.kind === "root_turn",
+        );
+        assert.isNotNull(rootNode?.checkpointScopeId);
+        assert.equal(
+          projection.checkpointScopes.find((scope) => scope.id === rootNode?.checkpointScopeId)
+            ?.cwd,
+          "/repo-worktrees/feature",
+        );
+      }).pipe(Effect.provide(harness.layer));
+    }),
+);
+
+it.effect("arms durable title generation after accepting the first message", () =>
+  Effect.gen(function* () {
+    const harness = makeHarness({
+      generateTitle: (input) =>
+        Effect.succeed({
+          title: input.previousTitle === undefined ? "Generated title" : "Regenerated title",
+        }),
+    });
+    yield* Effect.gen(function* () {
+      const launches = yield* ThreadLaunch.ThreadLaunchService;
+      const threads = yield* ThreadManagement.ThreadManagementService;
+      const outbox = yield* EffectOutbox.EffectOutboxV2;
+      const titleRegeneration = yield* ThreadTitleRegeneration.ThreadTitleRegenerationService;
+      const input = {
+        ...launchInput({
+          command: "command:launch:title-generation",
+          thread: "thread:launch:title-generation",
+          message: "Generate my title",
+        }),
+        title: "Generate my title",
+        generateTitle: true,
+      };
+      const launched = yield* launches.launch(input);
+      const generationCommandId = CommandId.make("command:launch:title-generation:initial-message");
+
+      const projection = yield* threads.getThreadProjection(launched.threadId);
+      assert.equal(projection.thread.title, "Generate my title");
+      assert.equal(projection.thread.titleRegeneration?.requestId, generationCommandId);
+      assert.deepEqual(
+        (yield* outbox.listByCommandId(generationCommandId)).map((effect) => effect.request),
+        [
+          {
+            type: "thread-title.generate",
+            kind: { type: "initial", messageId: MessageId.make("Generate my title:id") },
+          },
+        ],
+      );
+      yield* titleRegeneration.execute({
+        threadId: launched.threadId,
+        requestId: generationCommandId,
+        kind: { type: "initial", messageId: MessageId.make("Generate my title:id") },
+      });
+      const generated = yield* threads.getThreadProjection(launched.threadId);
+      assert.equal(generated.thread.title, "Generated title");
+      assert.deepEqual(
+        harness.generateThreadTitle.mock.calls[0]?.[0].modelSelection,
+        DEFAULT_SERVER_SETTINGS.textGenerationModelSelection,
+      );
+
+      const manualRequestId = CommandId.make("command:title-generation:manual");
+      yield* threads.dispatch({
+        type: "thread.metadata.update",
+        commandId: manualRequestId,
+        threadId: launched.threadId,
+        regenerateTitle: true,
+      });
+      assert.deepEqual(
+        (yield* outbox.listByCommandId(manualRequestId)).map((effect) => effect.request),
+        [{ type: "thread-title.generate", kind: { type: "regenerate" } }],
+      );
+      yield* titleRegeneration.execute({
+        threadId: launched.threadId,
+        requestId: manualRequestId,
+        kind: { type: "regenerate" },
+      });
+      const regenerated = yield* threads.getThreadProjection(launched.threadId);
+      assert.equal(regenerated.thread.title, "Regenerated title");
+      assert.equal(harness.generateThreadTitle.mock.calls[1]?.[0].previousTitle, "Generated title");
+
+      yield* threads.dispatch({
+        type: "thread.metadata.update",
+        commandId: CommandId.make("command:title-generation:user-rename"),
+        threadId: launched.threadId,
+        title: "Keep my title",
+      });
+      const renamed = yield* threads.getThreadProjection(launched.threadId);
+      yield* TestClock.adjust(Duration.seconds(1));
+      yield* threads.dispatch({
+        type: "thread.title.regeneration.complete",
+        commandId: CommandId.make("command:title-generation:stale-completion"),
+        threadId: launched.threadId,
+        requestId: generationCommandId,
+        title: "Stale generated title",
+      });
+      const afterStaleCompletion = yield* threads.getThreadProjection(launched.threadId);
+      assert.equal(afterStaleCompletion.thread.title, "Keep my title");
+      assert.equal(
+        DateTime.toEpochMillis(afterStaleCompletion.thread.updatedAt),
+        DateTime.toEpochMillis(renamed.thread.updatedAt),
+      );
+    }).pipe(Effect.provide(harness.layer));
+  }),
+);
+
+it.effect("does not update a reused thread title when the initial message is rejected", () =>
+  Effect.gen(function* () {
+    const harness = makeHarness();
+    yield* Effect.gen(function* () {
+      const launches = yield* ThreadLaunch.ThreadLaunchService;
+      const threads = yield* ThreadManagement.ThreadManagementService;
+      const outbox = yield* EffectOutbox.EffectOutboxV2;
+      const threadId = ThreadId.make("thread:launch:reused-title-failure");
+      yield* threads.dispatch({
+        type: "thread.create",
+        commandId: CommandId.make("command:launch:reused-title-failure:create"),
+        threadId,
+        projectId,
+        title: "Original title",
+        modelSelection,
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        branch: null,
+        worktreePath: null,
+        createdBy: "user",
+        creationSource: "web",
+      });
+
+      const commandId = CommandId.make("command:launch:reused-title-failure");
+      const failed = yield* launches
+        .launch({
+          ...launchInput({
+            command: commandId,
+            thread: threadId,
+            message: "Generate a provisional title",
+          }),
+          reuseExistingThread: true,
+          title: "Generate a provisional title",
+          generateTitle: true,
+          modelSelection: {
+            instanceId: ProviderInstanceId.make("missing-provider"),
+            model: "missing-model",
+          },
+        })
+        .pipe(Effect.exit);
+
+      assert.isTrue(Exit.isFailure(failed));
+      const projection = yield* threads.getThreadProjection(threadId);
+      assert.equal(projection.thread.title, "Original title");
+      assert.isUndefined(projection.thread.titleRegeneration);
+      assert.isEmpty(projection.messages);
+      assert.isEmpty(yield* outbox.listByCommandId(CommandId.make(`${commandId}:initial-message`)));
+    }).pipe(Effect.provide(harness.layer));
+  }),
+);
+
+it.effect("generates an initial title for an attachment-only message", () =>
+  Effect.gen(function* () {
+    const harness = makeHarness();
+    yield* Effect.gen(function* () {
+      const launches = yield* ThreadLaunch.ThreadLaunchService;
+      const titleRegeneration = yield* ThreadTitleRegeneration.ThreadTitleRegenerationService;
+      const messageId = MessageId.make("message:image-only");
+      const input = {
+        ...launchInput({
+          command: "command:launch:image-only",
+          thread: "thread:launch:image-only",
+        }),
+        title: "Image: screenshot.png",
+        generateTitle: true,
+        initialMessage: {
+          messageId,
+          text: "",
+          attachments: [
+            {
+              type: "image" as const,
+              id: "attachment-image-only",
+              name: "screenshot.png",
+              mimeType: "image/png",
+              sizeBytes: 128,
+            },
+          ],
+        },
+      };
+
+      const launched = yield* launches.launch(input);
+      yield* titleRegeneration.execute({
+        threadId: launched.threadId,
+        requestId: CommandId.make("command:launch:image-only:initial-message"),
+        kind: { type: "initial", messageId },
+      });
+
+      assert.equal(harness.generateThreadTitle.mock.calls[0]?.[0].message, "");
+      assert.equal(
+        harness.generateThreadTitle.mock.calls[0]?.[0].attachments?.[0]?.name,
+        "screenshot.png",
+      );
+    }).pipe(Effect.provide(harness.layer));
+  }),
+);
+
+it.effect("uses the available source control writer for generated worktree branches", () =>
+  Effect.gen(function* () {
+    const writerInstanceId = ProviderInstanceId.make("source-control-writer");
+    const writerModelSelection = {
+      instanceId: writerInstanceId,
+      model: "branch-writer-model",
+    } as const;
+    const harness = makeHarness({
+      serverSettings: {
+        providerInstances: {
+          [writerInstanceId]: {
+            driver: ProviderDriverKind.make("codex"),
+            config: {},
+          },
+        },
+        sourceControlWriterModelSelection: writerModelSelection,
+      },
+      providers: [
+        {
+          instanceId: writerInstanceId,
+          driver: ProviderDriverKind.make("codex"),
+          enabled: true,
+          installed: true,
+          version: null,
+          status: "ready",
+          auth: { status: "authenticated" },
+          checkedAt: "2026-07-28T00:00:00.000Z",
+          availability: "available",
+          models: [],
+          slashCommands: [],
+          skills: [],
+        },
+      ],
+    });
+
+    yield* Effect.gen(function* () {
+      const launches = yield* ThreadLaunch.ThreadLaunchService;
+      yield* launches.launch(
+        launchInput({
+          command: "command:launch:source-control-writer",
+          thread: "thread:launch:source-control-writer",
+          message: "Generate a branch with the configured writer",
+          workspace: { type: "worktree", baseRef: "main" },
+        }),
+      );
+      yield* waitUntil(() => Effect.sync(() => harness.generateBranchName.mock.calls.length === 1));
+      assert.deepEqual(
+        harness.generateBranchName.mock.calls[0]?.[0].modelSelection,
+        writerModelSelection,
+      );
+    }).pipe(Effect.provide(harness.layer));
+  }),
+);
+
+it.effect("falls back when the source control writer is unavailable", () =>
+  Effect.gen(function* () {
+    const writerInstanceId = ProviderInstanceId.make("missing-source-control-writer");
+    const harness = makeHarness({
+      serverSettings: {
+        providerInstances: {
+          [writerInstanceId]: {
+            driver: ProviderDriverKind.make("missing-driver"),
+            config: {},
+          },
+        },
+        sourceControlWriterModelSelection: {
+          instanceId: writerInstanceId,
+          model: "missing-branch-writer-model",
+        },
+      },
+      providers: [],
+    });
+
+    yield* Effect.gen(function* () {
+      const launches = yield* ThreadLaunch.ThreadLaunchService;
+      yield* launches.launch(
+        launchInput({
+          command: "command:launch:source-control-writer-fallback",
+          thread: "thread:launch:source-control-writer-fallback",
+          message: "Generate a branch with the available writer",
+          workspace: { type: "worktree", baseRef: "main" },
+        }),
+      );
+      yield* waitUntil(() => Effect.sync(() => harness.generateBranchName.mock.calls.length === 1));
+      assert.deepEqual(
+        harness.generateBranchName.mock.calls[0]?.[0].modelSelection,
+        DEFAULT_SERVER_SETTINGS.textGenerationModelSelection,
+      );
+    }).pipe(Effect.provide(harness.layer));
+  }),
+);
+
+it.effect("names the worktree itself when the client provides no branch", () =>
+  Effect.gen(function* () {
+    const harness = makeHarness();
+    yield* Effect.gen(function* () {
+      const launches = yield* ThreadLaunch.ThreadLaunchService;
+      const threads = yield* ThreadManagement.ThreadManagementService;
+      const launched = yield* launches.launch(
+        launchInput({
+          command: "command:launch:server-named-branch",
+          thread: "thread:launch:server-named-branch",
+          message: "Build the feature",
+          workspace: { type: "worktree", baseRef: "main" },
+        }),
+      );
+      yield* waitUntil(() => Effect.sync(() => harness.createWorktree.mock.calls.length === 1));
+      assert.match(
+        harness.createWorktree.mock.calls[0]?.[0].newRefName ?? "",
+        /^t3code\/[0-9a-f]{8}$/u,
+      );
+      yield* waitUntil(() =>
+        threads
+          .getThreadProjection(launched.threadId)
+          .pipe(Effect.map((projection) => projection.thread.branch === "generated-branch")),
+      );
+    }).pipe(Effect.provide(harness.layer));
+  }),
+);
+
+it.effect("renames a temporary t3code/<hash> branch off the provisioning critical path", () =>
+  Effect.gen(function* () {
+    const branchNameStarted = yield* Deferred.make<void>();
+    const allowBranchName = yield* Deferred.make<void>();
+    const harness = makeHarness({
+      createWorktree: (input) =>
+        Effect.succeed({
+          worktree: { path: "/repo-worktrees/temp", refName: input.newRefName, headSha: "abc" },
+        } as never),
+      generateBranchName: () =>
+        Deferred.succeed(branchNameStarted, undefined).pipe(
+          Effect.andThen(Deferred.await(allowBranchName)),
+          Effect.as({ branch: "generated-branch" }),
+        ),
+    });
+    yield* Effect.gen(function* () {
+      const launches = yield* ThreadLaunch.ThreadLaunchService;
+      const threads = yield* ThreadManagement.ThreadManagementService;
+      const launched = yield* launches.launch(
+        launchInput({
+          command: "command:launch:temp-branch",
+          thread: "thread:launch:temp-branch",
+          message: "Build the feature",
+          workspace: { type: "worktree", baseRef: "main", branch: "t3code/abcd1234" },
+        }),
+      );
+      yield* Deferred.await(branchNameStarted);
+      assert.equal(harness.createWorktree.mock.calls[0]?.[0].newRefName, "t3code/abcd1234");
+      yield* waitUntil(() =>
+        threads
+          .getThreadProjection(launched.threadId)
+          .pipe(Effect.map((projection) => projection.runs[0]?.status === "starting")),
+      );
+      assert.equal(
+        (yield* threads.getThreadProjection(launched.threadId)).thread.branch,
+        "t3code/abcd1234",
+      );
+      yield* Deferred.succeed(allowBranchName, undefined);
+      yield* waitUntil(() =>
+        threads
+          .getThreadProjection(launched.threadId)
+          .pipe(Effect.map((projection) => projection.thread.branch === "generated-branch")),
+      );
+      assert.deepEqual(harness.renameBranch.mock.calls[0]?.[0], {
+        cwd: "/repo-worktrees/temp",
+        oldBranch: "t3code/abcd1234",
+        newBranch: "generated-branch",
+      });
+    }).pipe(Effect.provide(harness.layer));
+  }),
+);
+
+it.effect("keeps an explicit branch name instead of generating one", () =>
+  Effect.gen(function* () {
+    const harness = makeHarness();
+    yield* Effect.gen(function* () {
+      const launches = yield* ThreadLaunch.ThreadLaunchService;
+      yield* launches.launch(
+        launchInput({
+          command: "command:launch:explicit-branch",
+          thread: "thread:launch:explicit-branch",
+          message: "Build the feature",
+          workspace: { type: "worktree", baseRef: "main", branch: "my-feature" },
+        }),
+      );
+      yield* waitUntil(() => Effect.sync(() => harness.createWorktree.mock.calls.length === 1));
+      assert.equal(harness.generateBranchName.mock.calls.length, 0);
+      assert.equal(harness.createWorktree.mock.calls[0]?.[0].newRefName, "my-feature");
+    }).pipe(Effect.provide(harness.layer));
+  }),
+);
+
+it.effect("keeps the temporary branch when branch generation fails", () =>
+  Effect.gen(function* () {
+    const harness = makeHarness({
+      createWorktree: (input) =>
+        Effect.succeed({
+          worktree: { path: "/repo-worktrees/temp", refName: input.newRefName, headSha: "abc" },
+        } as never),
+      generateBranchName: () => Effect.die("branch generation is down"),
+    });
+    yield* Effect.gen(function* () {
+      const launches = yield* ThreadLaunch.ThreadLaunchService;
+      const threads = yield* ThreadManagement.ThreadManagementService;
+      const launched = yield* launches.launch(
+        launchInput({
+          command: "command:launch:branch-fallback",
+          thread: "thread:launch:branch-fallback",
+          message: "Build the feature",
+          workspace: { type: "worktree", baseRef: "main", branch: "t3code/abcd1234" },
+        }),
+      );
+      yield* waitUntil(() => Effect.sync(() => harness.generateBranchName.mock.calls.length === 1));
+      assert.equal(harness.createWorktree.mock.calls[0]?.[0].newRefName, "t3code/abcd1234");
+      yield* waitUntil(() =>
+        threads
+          .getThreadProjection(launched.threadId)
+          .pipe(Effect.map((projection) => projection.runs[0]?.status === "starting")),
+      );
+      assert.equal(harness.renameBranch.mock.calls.length, 0);
+      assert.equal(
+        (yield* threads.getThreadProjection(launched.threadId)).thread.branch,
+        "t3code/abcd1234",
+      );
+    }).pipe(Effect.provide(harness.layer));
+  }),
+);
+
+it.effect("renames a temporary branch on an existing worktree to a generated name", () =>
+  Effect.gen(function* () {
+    const harness = makeHarness();
+    yield* Effect.gen(function* () {
+      const launches = yield* ThreadLaunch.ThreadLaunchService;
+      const threads = yield* ThreadManagement.ThreadManagementService;
+      const launched = yield* launches.launch(
+        launchInput({
+          command: "command:launch:existing-worktree-rename",
+          thread: "thread:launch:existing-worktree-rename",
+          message: "Build the feature",
+          workspace: {
+            type: "existing_worktree",
+            worktreePath: "/repo-worktrees/t3code-abcd1234",
+            branch: "t3code/abcd1234",
+          },
+        }),
+      );
+      yield* waitUntil(() =>
+        threads
+          .getThreadProjection(launched.threadId)
+          .pipe(Effect.map((projection) => projection.thread.branch === "generated-branch")),
+      );
+      assert.deepEqual(harness.renameBranch.mock.calls[0]?.[0], {
+        cwd: "/repo-worktrees/t3code-abcd1234",
+        oldBranch: "t3code/abcd1234",
+        newBranch: "generated-branch",
+      });
+    }).pipe(Effect.provide(harness.layer));
+  }),
+);
+
+for (const failurePoint of ["worktree", "setup"] as const) {
+  it.effect(
+    `${failurePoint} failure keeps the thread and message visible and emits failure items`,
+    () =>
+      Effect.gen(function* () {
+        const failure = new Error(`${failurePoint} failed`);
+        const harness = makeHarness(
+          failurePoint === "worktree"
+            ? { createWorktree: () => Effect.fail(failure as never) }
+            : { runSetup: () => Effect.fail(failure as never) },
+        );
+        yield* Effect.gen(function* () {
+          const launches = yield* ThreadLaunch.ThreadLaunchService;
+          const threads = yield* ThreadManagement.ThreadManagementService;
+          const input = launchInput({
+            command: `command:launch:${failurePoint}-failure`,
+            thread: `thread:launch:${failurePoint}-failure`,
+            message: `Fail during ${failurePoint}`,
+            workspace: { type: "worktree", baseRef: "main" },
+          });
+          const launched = yield* launches.launch(input);
+          yield* waitUntil(() =>
+            threads
+              .getThreadProjection(launched.threadId)
+              .pipe(Effect.map((projection) => projection.runs[0]?.status === "failed")),
+          );
+          const projection = yield* threads.getThreadProjection(launched.threadId);
+          assert.equal(projection.messages[0]?.text, `Fail during ${failurePoint}`);
+          assert.equal(projection.runs[0]?.status, "failed");
+          assert.equal(
+            projection.turnItems.find((item) => item.type === "command_execution")?.status,
+            "failed",
+          );
+          assert.match(
+            projection.turnItems.find((item) => item.type === "error")?.failure.message ?? "",
+            new RegExp(`${failurePoint} failed`, "u"),
+          );
+        }).pipe(Effect.provide(harness.layer));
+      }),
+  );
+}
+
+it.effect("deduplicates retried launch side effects in-process", () =>
+  Effect.gen(function* () {
+    const setupEntered = yield* Deferred.make<void>();
+    const allowSetup = yield* Deferred.make<void>();
+    const harness = makeHarness({
+      runSetup: () =>
+        Deferred.succeed(setupEntered, undefined).pipe(
+          Effect.andThen(Deferred.await(allowSetup)),
+          Effect.as({ status: "no-script" as const }),
+        ),
+    });
+    yield* Effect.gen(function* () {
+      const launches = yield* ThreadLaunch.ThreadLaunchService;
+      const input = launchInput({
+        command: "command:launch:retry",
+        thread: "thread:launch:retry",
+        message: "Only once",
+      });
+      const [first, retry] = yield* Effect.all([launches.launch(input), launches.launch(input)], {
+        concurrency: "unbounded",
+      });
+      yield* Deferred.await(setupEntered);
+      assert.equal(first.threadId, retry.threadId);
+      assert.isFalse(first.resumed);
+      assert.isTrue(retry.resumed);
+      assert.equal(harness.runSetup.mock.calls.length, 1);
+      yield* Deferred.succeed(allowSetup, undefined);
+    }).pipe(Effect.provide(harness.layer));
+  }),
+);
+
+it.effect("does not let a failing same-command caller strand a concurrent durable launch", () =>
+  Effect.gen(function* () {
+    const setupEntered = yield* Deferred.make<void>();
+    const allowSetup = yield* Deferred.make<void>();
+    const harness = makeHarness({
+      runSetup: () =>
+        Deferred.succeed(setupEntered, undefined).pipe(
+          Effect.andThen(Deferred.await(allowSetup)),
+          Effect.as({ status: "no-script" as const }),
+        ),
+    });
+    yield* Effect.gen(function* () {
+      const launches = yield* ThreadLaunch.ThreadLaunchService;
+      const command = "command:launch:failed-owner-race";
+      const [failed, launched] = yield* Effect.all(
+        [
+          launches
+            .launch({
+              ...launchInput({
+                command,
+                thread: "thread:launch:failed-owner-race",
+                message: "This invalid reuse fails",
+              }),
+              reuseExistingThread: true,
+            })
+            .pipe(Effect.exit),
+          launches.launch(
+            launchInput({
+              command,
+              thread: "thread:launch:successful-peer",
+              message: "This peer persists",
+            }),
+          ),
+        ],
+        { concurrency: "unbounded" },
+      );
+      assert.isTrue(Exit.isFailure(failed));
+      assert.equal(launched.projection.runs[0]?.status, "preparing");
+      const entered = yield* Deferred.await(setupEntered).pipe(
+        Effect.timeoutOption(Duration.seconds(2)),
+      );
+      assert.isTrue(Option.isSome(entered));
+      assert.equal(harness.runSetup.mock.calls.length, 1);
+      yield* Deferred.succeed(allowSetup, undefined);
+    }).pipe(Effect.provide(harness.layer));
+  }),
+);
+
+it.effect("schedules an accepted preparing message exactly once across concurrent retries", () =>
+  Effect.gen(function* () {
+    const setupEntered = yield* Deferred.make<void>();
+    const allowSetup = yield* Deferred.make<void>();
+    const harness = makeHarness({
+      runSetup: () =>
+        Deferred.succeed(setupEntered, undefined).pipe(
+          Effect.andThen(Deferred.await(allowSetup)),
+          Effect.as({ status: "no-script" as const }),
+        ),
+    });
+    yield* Effect.gen(function* () {
+      const launches = yield* ThreadLaunch.ThreadLaunchService;
+      const threads = yield* ThreadManagement.ThreadManagementService;
+      const input = launchInput({
+        command: "command:launch:accepted-before-fork",
+        thread: "thread:launch:accepted-before-fork",
+        message: "Resume preparation",
+      });
+      const messageId = MessageId.make("message:launch:accepted-before-fork");
+
+      yield* threads.dispatch({
+        type: "thread.create",
+        commandId: input.commandId,
+        threadId: input.threadId,
+        projectId: input.projectId,
+        title: input.title,
+        modelSelection: input.modelSelection,
+        runtimeMode: input.runtimeMode,
+        interactionMode: input.interactionMode,
+        branch: null,
+        worktreePath: null,
+        createdBy: input.createdBy,
+        creationSource: input.creationSource,
+      });
+      yield* threads.dispatch({
+        type: "message.dispatch",
+        commandId: CommandId.make(`${input.commandId}:initial-message`),
+        threadId: input.threadId,
+        messageId,
+        text: "Resume preparation",
+        attachments: [],
+        modelSelection: input.modelSelection,
+        dispatchMode: { type: "defer_start" },
+        createdBy: input.createdBy,
+        creationSource: input.creationSource,
+      });
+      const preparing = yield* threads.getThreadProjection(input.threadId);
+      assert.equal(preparing.runs[0]?.status, "preparing");
+
+      const [first, second] = yield* Effect.all([launches.launch(input), launches.launch(input)], {
+        concurrency: "unbounded",
+      });
+      yield* Deferred.await(setupEntered);
+      assert.isTrue(first.resumed);
+      assert.isTrue(second.resumed);
+      assert.equal(harness.runSetup.mock.calls.length, 1);
+      yield* Deferred.succeed(allowSetup, undefined);
+    }).pipe(Effect.provide(harness.layer));
+  }),
+);
+
+it.effect("does not depend on the legacy launch workflow table", () => {
+  const harness = makeHarness();
+  return Effect.gen(function* () {
+    const sql = yield* SqlClient.SqlClient;
+    const launches = yield* ThreadLaunch.ThreadLaunchService;
+    yield* sql`DROP TABLE orchestration_v2_thread_launch_workflows`;
+    const launched = yield* launches.launch(
+      launchInput({
+        command: "command:launch:no-workflow-table",
+        thread: "thread:launch:no-workflow-table",
+        message: "No private workflow state",
+      }),
+    );
+    assert.equal(launched.projection.messages[0]?.text, "No private workflow state");
+  }).pipe(Effect.provide(harness.layer));
+});
diff --git a/apps/server/src/orchestration-v2/ThreadLaunchService.ts b/apps/server/src/orchestration-v2/ThreadLaunchService.ts
new file mode 100644
index 000000000000..97f9daba388c
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ThreadLaunchService.ts
@@ -0,0 +1,573 @@
+import {
+  CommandId,
+  type ChatAttachment,
+  type MessageId,
+  type ModelSelection,
+  type OrchestrationV2Actor,
+  type OrchestrationV2CreationSource,
+  type OrchestrationV2ThreadProjection,
+  type ProviderInteractionMode,
+  ProjectId,
+  type RunId,
+  type RuntimeMode,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as Cause from "effect/Cause";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Ref from "effect/Ref";
+import * as Schema from "effect/Schema";
+import * as Scope from "effect/Scope";
+import { buildTemporaryWorktreeBranchName, isTemporaryWorktreeBranch } from "@t3tools/shared/git";
+
+import * as GitWorkflow from "../git/GitWorkflowService.ts";
+import * as ProjectService from "../project/ProjectService.ts";
+import * as ProjectSetupScriptRunner from "../project/ProjectSetupScriptRunner.ts";
+import * as ProviderRegistry from "../provider/Services/ProviderRegistry.ts";
+import * as ServerSettings from "../serverSettings.ts";
+import * as TextGeneration from "../textGeneration/TextGeneration.ts";
+import * as CommandReceiptStore from "./CommandReceiptStore.ts";
+import * as IdAllocator from "./IdAllocator.ts";
+import { makeProviderFailure } from "./ProviderFailure.ts";
+import { randomUuidV4 } from "./RandomUuid.ts";
+import * as ThreadManagement from "./ThreadManagementService.ts";
+
+export type ThreadLaunchWorkspaceStrategy =
+  | { readonly type: "root"; readonly branch?: string | undefined }
+  | {
+      readonly type: "existing_worktree";
+      readonly worktreePath: string;
+      readonly branch?: string | undefined;
+    }
+  | {
+      readonly type: "worktree";
+      readonly baseRef: string;
+      readonly branch?: string | undefined;
+      readonly startFromOrigin?: boolean | undefined;
+    };
+
+export interface ThreadLaunchInitialMessage {
+  readonly messageId?: MessageId;
+  readonly text: string;
+  readonly attachments: ReadonlyArray<ChatAttachment>;
+}
+
+export interface ThreadLaunchInput {
+  readonly commandId: CommandId;
+  readonly threadId?: ThreadId;
+  readonly reuseExistingThread?: boolean;
+  readonly projectId: ProjectId;
+  readonly title: string;
+  readonly generateTitle?: boolean;
+  readonly modelSelection: ModelSelection;
+  readonly runtimeMode: RuntimeMode;
+  readonly interactionMode: ProviderInteractionMode;
+  readonly workspaceStrategy: ThreadLaunchWorkspaceStrategy;
+  readonly initialMessage?: ThreadLaunchInitialMessage;
+  readonly createdBy: OrchestrationV2Actor;
+  readonly creationSource: OrchestrationV2CreationSource;
+}
+
+export interface ThreadLaunchResult {
+  readonly threadId: ThreadId;
+  readonly projection: OrchestrationV2ThreadProjection;
+  readonly resumed: boolean;
+}
+
+export class ThreadLaunchError extends Schema.TaggedErrorClass<ThreadLaunchError>()(
+  "ThreadLaunchError",
+  {
+    operation: Schema.Literals([
+      "resolve-project",
+      "read-receipt",
+      "generate-metadata",
+      "provision-worktree",
+      "run-setup-script",
+      "create-thread",
+      "update-thread",
+      "dispatch-message",
+      "release-run",
+      "fail-run",
+    ]),
+    commandId: CommandId,
+    projectId: ProjectId,
+    threadId: Schema.optional(ThreadId),
+    cause: Schema.Defect(),
+  },
+) {
+  override get message(): string {
+    return `Thread launch ${this.commandId} failed during ${this.operation}.`;
+  }
+}
+
+export class ThreadLaunchService extends Context.Service<
+  ThreadLaunchService,
+  {
+    readonly launch: (
+      input: ThreadLaunchInput,
+    ) => Effect.Effect<ThreadLaunchResult, ThreadLaunchError>;
+  }
+>()("t3/orchestration-v2/ThreadLaunchService") {}
+
+const isThreadLaunchError = Schema.is(ThreadLaunchError);
+
+function failureDetail(error: unknown): string {
+  if (isThreadLaunchError(error)) {
+    const cause = error.cause;
+    const detail = cause instanceof Error ? cause.message : String(cause);
+    return `Workspace preparation failed during ${error.operation.replaceAll("-", " ")}: ${detail}`;
+  }
+  return `Workspace preparation failed: ${error instanceof Error ? error.message : String(error)}`;
+}
+
+export const make = Effect.gen(function* () {
+  const projects = yield* ProjectService.ProjectService;
+  const git = yield* GitWorkflow.GitWorkflowService;
+  const setupScripts = yield* ProjectSetupScriptRunner.ProjectSetupScriptRunner;
+  const providerRegistry = yield* ProviderRegistry.ProviderRegistry;
+  const serverSettings = yield* ServerSettings.ServerSettingsService;
+  const textGeneration = yield* TextGeneration.TextGeneration;
+  const receipts = yield* CommandReceiptStore.CommandReceiptStoreV2;
+  const ids = yield* IdAllocator.IdAllocatorV2;
+  const threads = yield* ThreadManagement.ThreadManagementService;
+  const preparationScope = yield* Scope.make("sequential");
+  const scheduledLaunches = yield* Ref.make<ReadonlySet<CommandId>>(new Set());
+  yield* Effect.addFinalizer(() => Scope.close(preparationScope, Exit.void));
+
+  const mapError =
+    (input: ThreadLaunchInput, operation: ThreadLaunchError["operation"], threadId?: ThreadId) =>
+    (cause: unknown) =>
+      new ThreadLaunchError({
+        operation,
+        commandId: input.commandId,
+        projectId: input.projectId,
+        ...(threadId === undefined ? {} : { threadId }),
+        cause,
+      });
+
+  const readReceipt = (input: ThreadLaunchInput, commandId: CommandId) =>
+    receipts
+      .getByCommandId(commandId)
+      .pipe(Effect.mapError(mapError(input, "read-receipt", input.threadId)));
+
+  const validateReusableThread = Effect.fn("ThreadLaunchService.validateReusableThread")(function* (
+    input: ThreadLaunchInput,
+    threadId: ThreadId,
+  ) {
+    const projection = yield* threads
+      .getThreadProjection(threadId)
+      .pipe(Effect.mapError(mapError(input, "update-thread", threadId)));
+    if (
+      projection.thread.projectId !== input.projectId ||
+      projection.thread.archivedAt !== null ||
+      projection.thread.deletedAt !== null ||
+      projection.messages.length > 0 ||
+      projection.runs.length > 0
+    ) {
+      return yield* mapError(
+        input,
+        "update-thread",
+        threadId,
+      )("Only an empty active thread in the target project can change workspace during launch.");
+    }
+  });
+
+  const prepareInBackground = Effect.fn("ThreadLaunchService.prepareInBackground")(function* (
+    input: ThreadLaunchInput,
+    threadId: ThreadId,
+    runId: RunId | null,
+  ) {
+    const project = yield* projects.getById(input.projectId).pipe(
+      Effect.mapError(mapError(input, "resolve-project", threadId)),
+      Effect.flatMap(
+        Option.match({
+          onNone: () =>
+            Effect.fail(mapError(input, "resolve-project", threadId)("Project no longer exists.")),
+          onSome: Effect.succeed,
+        }),
+      ),
+    );
+
+    const initialMessage = input.initialMessage;
+    const generateBranchNameFor = (cwd: string, message: ThreadLaunchInitialMessage) =>
+      Effect.gen(function* () {
+        const settings = yield* serverSettings.getSettings;
+        const modelSelection =
+          settings.sourceControlWriterModelSelection === null
+            ? settings.textGenerationModelSelection
+            : ServerSettings.resolveSourceControlWriterModelSelection(
+                settings,
+                yield* providerRegistry.getProviders,
+              );
+        return yield* textGeneration
+          .generateBranchName({
+            cwd,
+            message: message.text,
+            attachments: message.attachments,
+            modelSelection,
+          })
+          .pipe(Effect.map((result) => result.branch));
+      });
+
+    // The server owns worktree naming: without an explicit branch, provision
+    // under a temporary `t3code/<hash>` name so the worktree never waits on
+    // name generation, then rename in the background below.
+    const requestedBranch = input.workspaceStrategy.branch;
+    let branch: string | null;
+    if (input.workspaceStrategy.type === "worktree" && requestedBranch === undefined) {
+      const uuid = yield* randomUuidV4;
+      branch = buildTemporaryWorktreeBranchName(() => uuid.replaceAll("-", ""));
+    } else {
+      branch = requestedBranch ?? null;
+    }
+    let worktreePath =
+      input.workspaceStrategy.type === "existing_worktree"
+        ? input.workspaceStrategy.worktreePath
+        : null;
+    if (input.workspaceStrategy.type === "worktree") {
+      if (runId !== null) {
+        yield* threads
+          .dispatch({
+            type: "prepared-run.progress",
+            commandId: CommandId.make(`${input.commandId}:progress:worktree`),
+            threadId,
+            runId,
+            phase: "worktree",
+          })
+          .pipe(Effect.mapError(mapError(input, "update-thread", threadId)));
+      }
+      let startRef = input.workspaceStrategy.baseRef;
+      if (input.workspaceStrategy.startFromOrigin === true) {
+        yield* git
+          .fetchRemote({ cwd: project.workspaceRoot, remoteName: "origin" })
+          .pipe(Effect.mapError(mapError(input, "provision-worktree", threadId)));
+        startRef = yield* git
+          .resolveRemoteTrackingCommit({
+            cwd: project.workspaceRoot,
+            refName: input.workspaceStrategy.baseRef,
+            fallbackRemoteName: "origin",
+          })
+          .pipe(
+            Effect.map((resolved) => resolved.commitSha),
+            Effect.mapError(mapError(input, "provision-worktree", threadId)),
+          );
+      }
+      const worktree = yield* git
+        .createWorktree({
+          cwd: project.workspaceRoot,
+          refName: startRef,
+          newRefName: branch!,
+          baseRefName: input.workspaceStrategy.baseRef,
+          path: null,
+        })
+        .pipe(Effect.mapError(mapError(input, "provision-worktree", threadId)));
+      worktreePath = worktree.worktree.path;
+      branch = worktree.worktree.refName;
+    }
+
+    yield* threads
+      .dispatch({
+        type: "thread.metadata.update",
+        commandId: CommandId.make(`${input.commandId}:workspace`),
+        threadId,
+        branch,
+        worktreePath,
+      })
+      .pipe(Effect.mapError(mapError(input, "update-thread", threadId)));
+
+    // Rename temporary branches (server-invented above, or sent by clients
+    // that name worktrees themselves) in the background so generation latency
+    // never delays provisioning or the provider turn. The temporary name
+    // simply sticks if generation or the rename fails.
+    if (
+      worktreePath !== null &&
+      branch !== null &&
+      initialMessage !== undefined &&
+      isTemporaryWorktreeBranch(branch)
+    ) {
+      const oldBranch = branch;
+      const worktreeCwd = worktreePath;
+      yield* generateBranchNameFor(worktreeCwd, initialMessage).pipe(
+        Effect.flatMap((newBranch) => git.renameBranch({ cwd: worktreeCwd, oldBranch, newBranch })),
+        Effect.flatMap((renamed) =>
+          threads.dispatch({
+            type: "thread.metadata.update",
+            commandId: CommandId.make(`${input.commandId}:branch-rename`),
+            threadId,
+            branch: renamed.branch,
+            worktreePath: worktreeCwd,
+          }),
+        ),
+        Effect.catchCause((cause) =>
+          Effect.logWarning("Thread worktree branch rename failed", {
+            commandId: input.commandId,
+            threadId,
+            oldBranch,
+            cause,
+          }),
+        ),
+        Effect.forkIn(preparationScope),
+      );
+    }
+
+    const cwd = worktreePath ?? project.workspaceRoot;
+    if (runId !== null) {
+      yield* threads
+        .dispatch({
+          type: "prepared-run.progress",
+          commandId: CommandId.make(`${input.commandId}:progress:setup`),
+          threadId,
+          runId,
+          phase: "setup",
+        })
+        .pipe(Effect.mapError(mapError(input, "update-thread", threadId)));
+    }
+    yield* setupScripts
+      .runForThread({
+        threadId,
+        projectId: input.projectId,
+        projectCwd: project.workspaceRoot,
+        worktreePath: cwd,
+        project: {
+          workspaceRoot: project.workspaceRoot,
+          scripts: project.scripts,
+        },
+      })
+      .pipe(Effect.mapError(mapError(input, "run-setup-script", threadId)));
+
+    if (runId !== null) {
+      yield* threads
+        .dispatch({
+          type: "prepared-run.release",
+          commandId: CommandId.make(`${input.commandId}:release`),
+          threadId,
+          runId,
+        })
+        .pipe(Effect.mapError(mapError(input, "release-run", threadId)));
+    }
+  });
+
+  const failPreparedRun = (
+    input: ThreadLaunchInput,
+    threadId: ThreadId,
+    runId: RunId | null,
+    cause: unknown,
+  ) =>
+    runId === null
+      ? Effect.logWarning("Thread workspace preparation failed", {
+          commandId: input.commandId,
+          threadId,
+          cause,
+        })
+      : threads
+          .dispatch({
+            type: "prepared-run.fail",
+            commandId: CommandId.make(`${input.commandId}:fail`),
+            threadId,
+            runId,
+            failure: makeProviderFailure({
+              cause,
+              message: failureDetail(cause),
+              class: "validation_error",
+              retryable: false,
+            }),
+          })
+          .pipe(
+            Effect.mapError(mapError(input, "fail-run", threadId)),
+            Effect.catchCause((persistCause) =>
+              Effect.logWarning("Failed to persist thread workspace preparation failure", {
+                commandId: input.commandId,
+                threadId,
+                cause,
+                persistCause,
+              }),
+            ),
+          );
+
+  const reservePreparation = (commandId: CommandId) =>
+    Ref.modify(scheduledLaunches, (scheduled) => {
+      if (scheduled.has(commandId)) return [false, scheduled] as const;
+      const next = new Set(scheduled);
+      next.add(commandId);
+      return [true, next] as const;
+    });
+
+  const releasePreparation = (commandId: CommandId) =>
+    Ref.update(scheduledLaunches, (scheduled) => {
+      const next = new Set(scheduled);
+      next.delete(commandId);
+      return next;
+    });
+
+  const schedulePreparation = Effect.fn("ThreadLaunchService.schedulePreparation")(function* (
+    input: ThreadLaunchInput,
+    threadId: ThreadId,
+    runId: RunId | null,
+  ) {
+    yield* prepareInBackground(input, threadId, runId).pipe(
+      Effect.catchCause((cause) =>
+        Cause.hasInterruptsOnly(cause)
+          ? Effect.void
+          : failPreparedRun(input, threadId, runId, Cause.squash(cause)),
+      ),
+      Effect.ensuring(releasePreparation(input.commandId)),
+      Effect.forkIn(preparationScope),
+    );
+  });
+
+  const launch: ThreadLaunchService["Service"]["launch"] = Effect.fn("ThreadLaunchService.launch")(
+    function* (input) {
+      const project = yield* projects.getById(input.projectId).pipe(
+        Effect.mapError(mapError(input, "resolve-project")),
+        Effect.flatMap(
+          Option.match({
+            onNone: () => Effect.fail(mapError(input, "resolve-project")("Project not found.")),
+            onSome: Effect.succeed,
+          }),
+        ),
+      );
+      if (input.reuseExistingThread === true && input.threadId === undefined) {
+        return yield* mapError(
+          input,
+          "update-thread",
+        )("Reusing an existing thread requires a thread id.");
+      }
+
+      const launchReceipt = yield* readReceipt(input, input.commandId);
+      return yield* Effect.gen(function* () {
+        const candidateThreadId =
+          input.threadId ??
+          (yield* ids.allocate
+            .thread({ projectId: input.projectId })
+            .pipe(Effect.mapError(mapError(input, "create-thread"))));
+
+        if (input.reuseExistingThread === true && Option.isNone(launchReceipt)) {
+          yield* validateReusableThread(input, candidateThreadId);
+        }
+
+        const initialBranch = input.workspaceStrategy.branch ?? null;
+        const initialWorktreePath =
+          input.workspaceStrategy.type === "existing_worktree"
+            ? input.workspaceStrategy.worktreePath
+            : null;
+        const claimDispatch =
+          input.reuseExistingThread === true
+            ? threads.dispatch({
+                type: "thread.metadata.update",
+                commandId: input.commandId,
+                threadId: candidateThreadId,
+              })
+            : threads.dispatch({
+                type: "thread.create",
+                commandId: input.commandId,
+                threadId: candidateThreadId,
+                projectId: input.projectId,
+                title: input.title,
+                modelSelection: input.modelSelection,
+                runtimeMode: input.runtimeMode,
+                interactionMode: input.interactionMode,
+                branch: initialBranch,
+                worktreePath: initialWorktreePath,
+                createdBy: input.createdBy,
+                creationSource: input.creationSource,
+              });
+        const claimed = yield* claimDispatch.pipe(
+          Effect.mapError(
+            mapError(
+              input,
+              input.reuseExistingThread === true ? "update-thread" : "create-thread",
+              candidateThreadId,
+            ),
+          ),
+        );
+        const threadId =
+          claimed.storedEvents.find((stored) => stored.event.type.startsWith("thread."))?.event
+            .threadId ?? candidateThreadId;
+        if (project.id !== input.projectId) {
+          return yield* mapError(input, "resolve-project", threadId)("Project identity changed.");
+        }
+
+        let runId: RunId | null = null;
+        let messageWasAlreadyAccepted = false;
+        if (input.initialMessage !== undefined) {
+          const messageCommandId = CommandId.make(`${input.commandId}:initial-message`);
+          const messageReceipt = yield* readReceipt(input, messageCommandId);
+          messageWasAlreadyAccepted = Option.isSome(messageReceipt);
+          const messageId =
+            input.initialMessage.messageId ??
+            (yield* ids.allocate
+              .message({ threadId, ordinal: 1 })
+              .pipe(Effect.mapError(mapError(input, "dispatch-message", threadId))));
+          const dispatched = yield* threads
+            .dispatch({
+              type: "message.dispatch",
+              commandId: messageCommandId,
+              threadId,
+              messageId,
+              text: input.initialMessage.text,
+              attachments: input.initialMessage.attachments,
+              ...(input.generateTitle === true ? { titleSeed: input.title } : {}),
+              modelSelection: input.modelSelection,
+              dispatchMode: { type: "defer_start" },
+              createdBy: input.createdBy,
+              creationSource: input.creationSource,
+            })
+            .pipe(Effect.mapError(mapError(input, "dispatch-message", threadId)));
+          const runCreated = dispatched.storedEvents.find(
+            (stored) => stored.event.type === "run.created",
+          );
+          runId = runCreated?.event.type === "run.created" ? runCreated.event.payload.id : null;
+          if (runId === null) {
+            return yield* mapError(
+              input,
+              "dispatch-message",
+              threadId,
+            )("Initial message was accepted without a durable run.");
+          }
+        }
+
+        const projection = yield* threads
+          .getThreadProjection(threadId)
+          .pipe(Effect.mapError(mapError(input, "create-thread", threadId)));
+        const runIsPreparing =
+          runId !== null &&
+          projection.runs.some((run) => run.id === runId && run.status === "preparing");
+        const shouldSchedule = runId === null ? Option.isNone(launchReceipt) : runIsPreparing;
+        if (shouldSchedule) {
+          const ownsPreparation = yield* reservePreparation(input.commandId);
+          if (ownsPreparation) {
+            yield* Effect.gen(function* () {
+              const preparationStillRequired =
+                runId === null
+                  ? true
+                  : yield* threads.getThreadProjection(threadId).pipe(
+                      Effect.map((current) =>
+                        current.runs.some((run) => run.id === runId && run.status === "preparing"),
+                      ),
+                      Effect.mapError(mapError(input, "update-thread", threadId)),
+                    );
+              if (preparationStillRequired) {
+                yield* schedulePreparation(input, threadId, runId);
+              } else {
+                yield* releasePreparation(input.commandId);
+              }
+            }).pipe(Effect.onError(() => releasePreparation(input.commandId)));
+          }
+        }
+
+        return {
+          threadId,
+          projection,
+          resumed: Option.isSome(launchReceipt) || messageWasAlreadyAccepted,
+        };
+      });
+    },
+  );
+
+  return ThreadLaunchService.of({ launch });
+});
+
+export const layer = Layer.effect(ThreadLaunchService, make);
diff --git a/apps/server/src/orchestration-v2/ThreadLifecycleService.test.ts b/apps/server/src/orchestration-v2/ThreadLifecycleService.test.ts
new file mode 100644
index 000000000000..c55a8c9ccebe
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ThreadLifecycleService.test.ts
@@ -0,0 +1,60 @@
+import { assert, it } from "@effect/vitest";
+import {
+  CommandId,
+  ProviderInstanceId,
+  ThreadId,
+  type OrchestrationV2ThreadProjection,
+} from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+
+import * as ThreadLifecycle from "./ThreadLifecycleService.ts";
+import * as ThreadManagement from "./ThreadManagementService.ts";
+
+it.effect("maps application lifecycle operations to V2-native commands", () => {
+  const threadId = ThreadId.make("thread_lifecycle_service");
+  const commands: Array<string> = [];
+  const projection = { thread: { id: threadId } } as OrchestrationV2ThreadProjection;
+  const layer = ThreadLifecycle.layer.pipe(
+    Layer.provide(
+      Layer.mock(ThreadManagement.ThreadManagementService)({
+        dispatch: (command) => {
+          commands.push(command.type);
+          return Effect.succeed({ sequence: commands.length, storedEvents: [] });
+        },
+        getThreadProjection: () => Effect.succeed(projection),
+      }),
+    ),
+  );
+  return Effect.gen(function* () {
+    const service = yield* ThreadLifecycle.ThreadLifecycleService;
+    yield* service.archive({ commandId: CommandId.make("archive"), threadId });
+    yield* service.unarchive({ commandId: CommandId.make("unarchive"), threadId });
+    yield* service.updateMetadata({ commandId: CommandId.make("metadata"), threadId, title: "T" });
+    yield* service.setRuntimeMode({
+      commandId: CommandId.make("runtime"),
+      threadId,
+      runtimeMode: "approval-required",
+    });
+    yield* service.setInteractionMode({
+      commandId: CommandId.make("interaction"),
+      threadId,
+      interactionMode: "plan",
+    });
+    yield* service.setModelSelection({
+      commandId: CommandId.make("model"),
+      threadId,
+      modelSelection: { instanceId: ProviderInstanceId.make("codex"), model: "gpt-5.2" },
+    });
+    yield* service.delete({ commandId: CommandId.make("delete"), threadId });
+    assert.deepEqual(commands, [
+      "thread.archive",
+      "thread.unarchive",
+      "thread.metadata.update",
+      "thread.runtime-mode.set",
+      "thread.interaction-mode.set",
+      "thread.model-selection.set",
+      "thread.delete",
+    ]);
+  }).pipe(Effect.provide(layer));
+});
diff --git a/apps/server/src/orchestration-v2/ThreadLifecycleService.ts b/apps/server/src/orchestration-v2/ThreadLifecycleService.ts
new file mode 100644
index 000000000000..6fbb56613550
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ThreadLifecycleService.ts
@@ -0,0 +1,142 @@
+import {
+  CommandId,
+  type ModelSelection,
+  type OrchestrationV2ThreadProjection,
+  type ProviderInteractionMode,
+  type RuntimeMode,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Schema from "effect/Schema";
+
+import * as ThreadManagement from "./ThreadManagementService.ts";
+
+export class ThreadLifecycleError extends Schema.TaggedErrorClass<ThreadLifecycleError>()(
+  "ThreadLifecycleError",
+  {
+    operation: Schema.Literals([
+      "archive",
+      "unarchive",
+      "delete",
+      "update-metadata",
+      "set-runtime-mode",
+      "set-interaction-mode",
+      "set-model-selection",
+    ]),
+    threadId: ThreadId,
+    cause: Schema.Defect(),
+  },
+) {
+  override get message(): string {
+    return `Thread lifecycle operation '${this.operation}' failed for ${this.threadId}.`;
+  }
+}
+
+export class ThreadLifecycleService extends Context.Service<
+  ThreadLifecycleService,
+  {
+    readonly archive: (input: {
+      readonly commandId: CommandId;
+      readonly threadId: ThreadId;
+    }) => Effect.Effect<OrchestrationV2ThreadProjection, ThreadLifecycleError>;
+    readonly unarchive: (input: {
+      readonly commandId: CommandId;
+      readonly threadId: ThreadId;
+    }) => Effect.Effect<OrchestrationV2ThreadProjection, ThreadLifecycleError>;
+    readonly delete: (input: {
+      readonly commandId: CommandId;
+      readonly threadId: ThreadId;
+    }) => Effect.Effect<OrchestrationV2ThreadProjection, ThreadLifecycleError>;
+    readonly updateMetadata: (input: {
+      readonly commandId: CommandId;
+      readonly threadId: ThreadId;
+      readonly title?: string;
+      readonly branch?: string | null;
+      readonly worktreePath?: string | null;
+    }) => Effect.Effect<OrchestrationV2ThreadProjection, ThreadLifecycleError>;
+    readonly setRuntimeMode: (input: {
+      readonly commandId: CommandId;
+      readonly threadId: ThreadId;
+      readonly runtimeMode: RuntimeMode;
+    }) => Effect.Effect<OrchestrationV2ThreadProjection, ThreadLifecycleError>;
+    readonly setInteractionMode: (input: {
+      readonly commandId: CommandId;
+      readonly threadId: ThreadId;
+      readonly interactionMode: ProviderInteractionMode;
+    }) => Effect.Effect<OrchestrationV2ThreadProjection, ThreadLifecycleError>;
+    readonly setModelSelection: (input: {
+      readonly commandId: CommandId;
+      readonly threadId: ThreadId;
+      readonly modelSelection: ModelSelection;
+    }) => Effect.Effect<OrchestrationV2ThreadProjection, ThreadLifecycleError>;
+  }
+>()("t3/orchestration-v2/ThreadLifecycleService") {}
+
+export const make = Effect.gen(function* () {
+  const threads = yield* ThreadManagement.ThreadManagementService;
+
+  const dispatch = <Operation extends ThreadLifecycleError["operation"]>(
+    operation: Operation,
+    threadId: ThreadId,
+    command: Parameters<ThreadManagement.ThreadManagementService["Service"]["dispatch"]>[0],
+  ) =>
+    threads.dispatch(command).pipe(
+      Effect.andThen(threads.getThreadProjection(threadId)),
+      Effect.mapError((cause) => new ThreadLifecycleError({ operation, threadId, cause })),
+    );
+
+  return ThreadLifecycleService.of({
+    archive: (input) =>
+      dispatch("archive", input.threadId, {
+        type: "thread.archive",
+        commandId: input.commandId,
+        threadId: input.threadId,
+      }),
+    unarchive: (input) =>
+      dispatch("unarchive", input.threadId, {
+        type: "thread.unarchive",
+        commandId: input.commandId,
+        threadId: input.threadId,
+      }),
+    delete: (input) =>
+      dispatch("delete", input.threadId, {
+        type: "thread.delete",
+        commandId: input.commandId,
+        threadId: input.threadId,
+      }),
+    updateMetadata: (input) =>
+      dispatch("update-metadata", input.threadId, {
+        type: "thread.metadata.update",
+        commandId: input.commandId,
+        threadId: input.threadId,
+        ...(input.title === undefined ? {} : { title: input.title }),
+        ...(input.branch === undefined ? {} : { branch: input.branch }),
+        ...(input.worktreePath === undefined ? {} : { worktreePath: input.worktreePath }),
+      }),
+    setRuntimeMode: (input) =>
+      dispatch("set-runtime-mode", input.threadId, {
+        type: "thread.runtime-mode.set",
+        commandId: input.commandId,
+        threadId: input.threadId,
+        runtimeMode: input.runtimeMode,
+      }),
+    setInteractionMode: (input) =>
+      dispatch("set-interaction-mode", input.threadId, {
+        type: "thread.interaction-mode.set",
+        commandId: input.commandId,
+        threadId: input.threadId,
+        interactionMode: input.interactionMode,
+      }),
+    setModelSelection: (input) =>
+      dispatch("set-model-selection", input.threadId, {
+        type: "thread.model-selection.set",
+        commandId: input.commandId,
+        threadId: input.threadId,
+        modelSelection: input.modelSelection,
+      }),
+  });
+});
+
+export const layer = Layer.effect(ThreadLifecycleService, make);
diff --git a/apps/server/src/orchestration-v2/ThreadManagementService.test.ts b/apps/server/src/orchestration-v2/ThreadManagementService.test.ts
new file mode 100644
index 000000000000..e03d60c00d94
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ThreadManagementService.test.ts
@@ -0,0 +1,320 @@
+import { expect, it } from "@effect/vitest";
+import {
+  CommandId,
+  MessageId,
+  NodeId,
+  type OrchestrationV2Command,
+  type OrchestrationV2ThreadProjection,
+  ProjectId,
+  ProviderInstanceId,
+  RunId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+
+import { OrchestratorProjectionError, OrchestratorV2 } from "./Orchestrator.ts";
+import {
+  existingThreadIdsForCommand,
+  layer,
+  ThreadManagementDurableRunProjectionError,
+  ThreadManagementProjectThreadsListError,
+  ThreadManagementProjectionLoadError,
+  ThreadManagementRunNotFoundError,
+  ThreadManagementService,
+  ThreadManagementThreadNotFoundError,
+  ThreadManagementThreadNotInterruptibleError,
+  ThreadManagementThreadArchivedError,
+  ThreadManagementNoSteerableRunError,
+  withCreationProvenance,
+} from "./ThreadManagementService.ts";
+
+it("stamps authoritative provenance on commands that create threads or messages", () => {
+  const command: OrchestrationV2Command = {
+    type: "thread.create",
+    createdBy: "agent",
+    creationSource: "mcp",
+    commandId: CommandId.make("command:thread-management:create"),
+    threadId: ThreadId.make("thread:thread-management:create"),
+    projectId: ProjectId.make("project:thread-management"),
+    title: "Thread management",
+    modelSelection: {
+      instanceId: ProviderInstanceId.make("codex"),
+      model: "gpt-5-codex",
+    },
+    runtimeMode: "full-access",
+    interactionMode: "default",
+    branch: null,
+    worktreePath: null,
+  };
+
+  expect(
+    withCreationProvenance(command, {
+      createdBy: "user",
+      creationSource: "web",
+    }),
+  ).toMatchObject({
+    createdBy: "user",
+    creationSource: "web",
+  });
+});
+
+it("leaves commands that do not create durable authored content unchanged", () => {
+  const command: OrchestrationV2Command = {
+    type: "run.interrupt",
+    commandId: CommandId.make("command:thread-management:interrupt"),
+    threadId: ThreadId.make("thread:thread-management:interrupt"),
+    runId: RunId.make("run:thread-management:interrupt"),
+  };
+
+  expect(
+    withCreationProvenance(command, {
+      createdBy: "user",
+      creationSource: "web",
+    }),
+  ).toBe(command);
+});
+
+it("identifies every existing thread that must be hydrated before dispatch", () => {
+  const sourceThreadId = ThreadId.make("thread:thread-management:source");
+  const targetThreadId = ThreadId.make("thread:thread-management:target");
+  const parentThreadId = ThreadId.make("thread:thread-management:parent");
+
+  expect(
+    existingThreadIdsForCommand({
+      type: "thread.create",
+      createdBy: "user",
+      creationSource: "web",
+      commandId: CommandId.make("command:thread-management:create"),
+      threadId: targetThreadId,
+      projectId: ProjectId.make("project:thread-management"),
+      title: "Created thread",
+      modelSelection: {
+        instanceId: ProviderInstanceId.make("codex"),
+        model: "gpt-5-codex",
+      },
+      runtimeMode: "full-access",
+      interactionMode: "default",
+      branch: null,
+      worktreePath: null,
+    }),
+  ).toEqual([]);
+
+  expect(
+    existingThreadIdsForCommand({
+      type: "thread.archive",
+      commandId: CommandId.make("command:thread-management:archive"),
+      threadId: targetThreadId,
+    }),
+  ).toEqual([targetThreadId]);
+
+  // Read-state commands skip transcript hydration entirely: they fire on
+  // every activity bump while a thread is open and never touch messages.
+  expect(
+    existingThreadIdsForCommand({
+      type: "thread.visit",
+      commandId: CommandId.make("command:thread-management:visit"),
+      threadId: targetThreadId,
+      visitedAt: "2026-07-30T00:00:00.000Z",
+    }),
+  ).toEqual([]);
+
+  expect(
+    existingThreadIdsForCommand({
+      type: "thread.mark-unread",
+      commandId: CommandId.make("command:thread-management:mark-unread"),
+      threadId: targetThreadId,
+    }),
+  ).toEqual([]);
+
+  expect(
+    existingThreadIdsForCommand({
+      type: "thread.fork",
+      createdBy: "user",
+      creationSource: "web",
+      commandId: CommandId.make("command:thread-management:fork"),
+      sourceThreadId,
+      targetThreadId,
+      sourcePoint: {
+        type: "run",
+        runId: RunId.make("run:thread-management:source"),
+      },
+    }),
+  ).toEqual([sourceThreadId]);
+
+  expect(
+    existingThreadIdsForCommand({
+      type: "thread.merge_back",
+      createdBy: "user",
+      creationSource: "web",
+      commandId: CommandId.make("command:thread-management:merge"),
+      sourceThreadId,
+      targetThreadId,
+      sourcePoint: {
+        type: "run",
+        runId: RunId.make("run:thread-management:source"),
+      },
+    }),
+  ).toEqual([sourceThreadId, targetThreadId]);
+
+  expect(
+    existingThreadIdsForCommand({
+      type: "delegated_task.request",
+      createdBy: "agent",
+      creationSource: "provider",
+      commandId: CommandId.make("command:thread-management:delegate"),
+      parentThreadId,
+      parentRunId: RunId.make("run:thread-management:parent"),
+      parentNodeId: NodeId.make("node:thread-management:parent"),
+      task: "Inspect the migration",
+      modelSelection: {
+        instanceId: ProviderInstanceId.make("codex"),
+        model: "gpt-5-codex",
+      },
+      runtimeMode: "full-access",
+      interactionMode: "default",
+    }),
+  ).toEqual([parentThreadId]);
+
+  expect(
+    existingThreadIdsForCommand({
+      type: "delegated_task.wake-policy",
+      commandId: CommandId.make("command:thread-management:wake-policy"),
+      parentThreadId,
+      taskId: NodeId.make("node:thread-management:delegated"),
+      completionWake: "always",
+    }),
+  ).toEqual([parentThreadId]);
+
+  expect(
+    existingThreadIdsForCommand({
+      type: "thread.created.record",
+      commandId: CommandId.make("command:thread-management:record"),
+      parentThreadId,
+      parentRunId: RunId.make("run:thread-management:parent"),
+      parentNodeId: NodeId.make("node:thread-management:parent"),
+      targetThreadId,
+      targetRunId: null,
+    }),
+  ).toEqual([parentThreadId, targetThreadId]);
+});
+
+it("derives thread management messages from structural error attributes", () => {
+  const projectId = ProjectId.make("project:thread-management:errors");
+  const threadId = ThreadId.make("thread:thread-management:errors");
+  const runId = RunId.make("run:thread-management:errors");
+  const messageId = MessageId.make("message:thread-management:errors");
+  const infrastructureCause = new Error("private sqlite detail");
+
+  const threadNotFound = new ThreadManagementThreadNotFoundError({
+    projectId,
+    threadId,
+  });
+  expect(threadNotFound).toMatchObject({ projectId, threadId });
+  expect(threadNotFound.message).toBe(`Thread ${threadId} was not found in project ${projectId}.`);
+
+  const runNotFound = new ThreadManagementRunNotFoundError({ threadId, runId });
+  expect(runNotFound).toMatchObject({ threadId, runId });
+  expect(runNotFound.message).toBe(`Run ${runId} does not belong to thread ${threadId}.`);
+
+  const archived = new ThreadManagementThreadArchivedError({
+    threadId,
+  });
+  expect(archived).toMatchObject({ threadId });
+  expect(archived.message).toBe(`Thread ${threadId} is archived and cannot receive messages.`);
+
+  const notSteerable = new ThreadManagementNoSteerableRunError({
+    threadId,
+    mode: "restart",
+  });
+  expect(notSteerable).toMatchObject({
+    threadId,
+    mode: "restart",
+  });
+  expect(notSteerable.message).toBe(
+    `Thread ${threadId} has no running turn that can be restarted.`,
+  );
+
+  const notInterruptible = new ThreadManagementThreadNotInterruptibleError({
+    threadId,
+    runId,
+  });
+  expect(notInterruptible).toMatchObject({ threadId, runId });
+  expect(notInterruptible.message).toBe(`Run ${runId} is not currently interruptible.`);
+
+  const listFailure = new ThreadManagementProjectThreadsListError({
+    projectId,
+    cause: infrastructureCause,
+  });
+  expect(listFailure).toMatchObject({ projectId, cause: infrastructureCause });
+  expect(listFailure.message).toBe(`Unable to list threads in project ${projectId}.`);
+  expect(listFailure.message).not.toContain(infrastructureCause.message);
+
+  const durableProjectionFailure = new ThreadManagementDurableRunProjectionError({
+    threadId,
+    messageId,
+  });
+  expect(durableProjectionFailure).toMatchObject({ threadId, messageId });
+  expect(durableProjectionFailure.message).toBe(
+    `Message ${messageId} was accepted on thread ${threadId} without a durable run projection.`,
+  );
+});
+
+it.effect("classifies projection infrastructure failures separately from a missing thread", () => {
+  const projectId = ProjectId.make("project:thread-management:projection-failure");
+  const threadId = ThreadId.make("thread:thread-management:projection-failure");
+  const infrastructureCause = new Error("sqlite read failed");
+  const projectionError = new OrchestratorProjectionError({
+    threadId,
+    cause: infrastructureCause,
+  });
+  const testLayer = layer.pipe(
+    Layer.provide(
+      Layer.mock(OrchestratorV2)({
+        getThreadProjection: () => Effect.fail(projectionError),
+      }),
+    ),
+  );
+
+  return Effect.gen(function* () {
+    const service = yield* ThreadManagementService;
+    const error = yield* Effect.flip(service.getProjectThread({ projectId, threadId }));
+
+    expect(error).toBeInstanceOf(ThreadManagementProjectionLoadError);
+    expect(error).toMatchObject({
+      projectId,
+      threadId,
+      cause: projectionError,
+    });
+    expect(error.message).toBe(`Unable to load thread ${threadId} in project ${projectId}.`);
+  }).pipe(Effect.provide(testLayer));
+});
+
+it.effect("uses thread-not-found only after a projection loads outside the project", () => {
+  const projectId = ProjectId.make("project:thread-management:requested");
+  const otherProjectId = ProjectId.make("project:thread-management:other");
+  const threadId = ThreadId.make("thread:thread-management:wrong-project");
+  const projection = {
+    thread: {
+      id: threadId,
+      projectId: otherProjectId,
+      deletedAt: null,
+    },
+  } as OrchestrationV2ThreadProjection;
+  const testLayer = layer.pipe(
+    Layer.provide(
+      Layer.mock(OrchestratorV2)({
+        getThreadProjection: () => Effect.succeed(projection),
+      }),
+    ),
+  );
+
+  return Effect.gen(function* () {
+    const service = yield* ThreadManagementService;
+    const error = yield* Effect.flip(service.getProjectThread({ projectId, threadId }));
+
+    expect(error).toBeInstanceOf(ThreadManagementThreadNotFoundError);
+    expect(error).toMatchObject({ projectId, threadId });
+    expect("cause" in error).toBe(false);
+  }).pipe(Effect.provide(testLayer));
+});
diff --git a/apps/server/src/orchestration-v2/ThreadManagementService.ts b/apps/server/src/orchestration-v2/ThreadManagementService.ts
new file mode 100644
index 000000000000..22741da769ad
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ThreadManagementService.ts
@@ -0,0 +1,692 @@
+import {
+  type ChatAttachment,
+  type CommandId,
+  MessageId,
+  type ModelSelection,
+  type OrchestrationV2Actor,
+  type OrchestrationV2Command,
+  type OrchestrationV2ConversationMessage,
+  type OrchestrationV2CreationSource,
+  type OrchestrationV2Run,
+  type OrchestrationV2ThreadShellSnapshot,
+  type OrchestrationV2ThreadProjection,
+  type OrchestrationV2ThreadShell,
+  type OrchestrationV2TurnItem,
+  ProjectId,
+  RunId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as Context from "effect/Context";
+import * as DateTime from "effect/DateTime";
+import * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Schema from "effect/Schema";
+
+import {
+  OrchestratorDispatchError,
+  OrchestratorProjectionError,
+  OrchestratorV2,
+  type OrchestratorV2DispatchResult,
+  type OrchestratorV2Error,
+} from "./Orchestrator.ts";
+import {
+  LegacyV1ThreadImporter,
+  type LegacyV1ThreadImportError,
+} from "./LegacyV1ThreadImporter.ts";
+
+export type ThreadManagementSendMode = "auto" | "queue" | "steer" | "restart";
+
+export interface ThreadManagementProvenance {
+  readonly createdBy: OrchestrationV2Actor;
+  readonly creationSource: OrchestrationV2CreationSource;
+}
+
+export function withCreationProvenance(
+  command: OrchestrationV2Command,
+  provenance: ThreadManagementProvenance,
+): OrchestrationV2Command {
+  switch (command.type) {
+    case "thread.create":
+    case "message.dispatch":
+    case "thread.fork":
+    case "thread.merge_back":
+    case "delegated_task.request":
+      return { ...command, ...provenance };
+    default:
+      return command;
+  }
+}
+
+export function existingThreadIdsForCommand(
+  command: OrchestrationV2Command,
+): ReadonlyArray<ThreadId> {
+  switch (command.type) {
+    case "thread.create":
+      return [];
+    // Read-state commands only rewrite the thread payload's visited/unread
+    // watermark; they never touch messages, so they do not need the imported
+    // v1 transcript hydrated first. Visits fire on every thread-activity bump
+    // while a thread is open, so keeping them off the import path matters.
+    case "thread.visit":
+    case "thread.mark-unread":
+      return [];
+    case "thread.fork":
+      return [command.sourceThreadId];
+    case "thread.merge_back":
+      return command.sourceThreadId === command.targetThreadId
+        ? [command.sourceThreadId]
+        : [command.sourceThreadId, command.targetThreadId];
+    case "delegated_task.request":
+    case "delegated_task.wake-policy":
+    case "delegated_task.completion-delivery.acknowledge":
+    case "delegated_task.completion-delivery.dispose":
+      return [command.parentThreadId];
+    case "thread.created.record":
+      return command.parentThreadId === command.targetThreadId
+        ? [command.parentThreadId]
+        : [command.parentThreadId, command.targetThreadId];
+    default:
+      return [command.threadId];
+  }
+}
+
+export type ThreadManagementTerminalRunStatus = Extract<
+  OrchestrationV2Run["status"],
+  "completed" | "failed" | "cancelled" | "interrupted" | "rolled_back"
+>;
+
+export interface ThreadManagementSendInput {
+  readonly projectId: ProjectId;
+  readonly commandId: CommandId;
+  readonly threadId: ThreadId;
+  readonly messageId: MessageId;
+  readonly text: string;
+  readonly attachments: ReadonlyArray<ChatAttachment>;
+  readonly modelSelection?: ModelSelection;
+  readonly mode: ThreadManagementSendMode;
+  readonly createdBy: OrchestrationV2Actor;
+  readonly creationSource: OrchestrationV2CreationSource;
+}
+
+export interface ThreadManagementSendResult {
+  readonly dispatch: OrchestratorV2DispatchResult;
+  readonly projection: OrchestrationV2ThreadProjection;
+  readonly message: OrchestrationV2ConversationMessage;
+  readonly run: OrchestrationV2Run;
+  /** Null for queued sends: the user turn item materializes when the queued turn starts. */
+  readonly turnItem: Extract<OrchestrationV2TurnItem, { readonly type: "user_message" }> | null;
+  readonly delivery: "started" | "queued" | "steered" | "restarted";
+}
+
+export interface ThreadManagementWaitInput {
+  readonly projectId: ProjectId;
+  readonly threadId: ThreadId;
+  readonly runId?: RunId;
+  readonly timeoutMs: number;
+  readonly pollIntervalMs?: number;
+}
+
+export interface ThreadManagementWaitResult {
+  readonly threadId: ThreadId;
+  readonly run: OrchestrationV2Run | null;
+  readonly timedOut: boolean;
+}
+
+export interface ThreadManagementInterruptInput {
+  readonly projectId: ProjectId;
+  readonly commandId: CommandId;
+  readonly threadId: ThreadId;
+  readonly runId?: RunId;
+  readonly reason?: string;
+}
+
+export type ThreadManagementInterruptResult =
+  | {
+      readonly type: "interrupt_requested";
+      readonly run: OrchestrationV2Run;
+      readonly dispatch: OrchestratorV2DispatchResult;
+    }
+  | { readonly type: "no_active_run" }
+  | {
+      readonly type: "already_terminal";
+      readonly run: OrchestrationV2Run & { readonly status: ThreadManagementTerminalRunStatus };
+    };
+
+export class ThreadManagementThreadNotFoundError extends Schema.TaggedErrorClass<ThreadManagementThreadNotFoundError>()(
+  "ThreadManagementThreadNotFoundError",
+  {
+    projectId: ProjectId,
+    threadId: ThreadId,
+  },
+) {
+  override get message(): string {
+    return `Thread ${this.threadId} was not found in project ${this.projectId}.`;
+  }
+}
+
+export class ThreadManagementRunNotFoundError extends Schema.TaggedErrorClass<ThreadManagementRunNotFoundError>()(
+  "ThreadManagementRunNotFoundError",
+  {
+    threadId: ThreadId,
+    runId: RunId,
+  },
+) {
+  override get message(): string {
+    return `Run ${this.runId} does not belong to thread ${this.threadId}.`;
+  }
+}
+
+export class ThreadManagementThreadArchivedError extends Schema.TaggedErrorClass<ThreadManagementThreadArchivedError>()(
+  "ThreadManagementThreadArchivedError",
+  {
+    threadId: ThreadId,
+  },
+) {
+  override get message(): string {
+    return `Thread ${this.threadId} is archived and cannot receive messages.`;
+  }
+}
+
+export class ThreadManagementNoSteerableRunError extends Schema.TaggedErrorClass<ThreadManagementNoSteerableRunError>()(
+  "ThreadManagementNoSteerableRunError",
+  {
+    threadId: ThreadId,
+    mode: Schema.Literals(["steer", "restart"]),
+  },
+) {
+  override get message(): string {
+    return `Thread ${this.threadId} has no running turn that can be ${this.mode === "steer" ? "steered" : "restarted"}.`;
+  }
+}
+
+export class ThreadManagementThreadNotInterruptibleError extends Schema.TaggedErrorClass<ThreadManagementThreadNotInterruptibleError>()(
+  "ThreadManagementThreadNotInterruptibleError",
+  {
+    threadId: ThreadId,
+    runId: RunId,
+  },
+) {
+  override get message(): string {
+    return `Run ${this.runId} is not currently interruptible.`;
+  }
+}
+
+export class ThreadManagementProjectionLoadError extends Schema.TaggedErrorClass<ThreadManagementProjectionLoadError>()(
+  "ThreadManagementProjectionLoadError",
+  {
+    projectId: ProjectId,
+    threadId: ThreadId,
+    cause: Schema.Defect(),
+  },
+) {
+  override get message(): string {
+    return `Unable to load thread ${this.threadId} in project ${this.projectId}.`;
+  }
+}
+
+export class ThreadManagementProjectThreadsListError extends Schema.TaggedErrorClass<ThreadManagementProjectThreadsListError>()(
+  "ThreadManagementProjectThreadsListError",
+  {
+    projectId: ProjectId,
+    cause: Schema.Defect(),
+  },
+) {
+  override get message(): string {
+    return `Unable to list threads in project ${this.projectId}.`;
+  }
+}
+
+export class ThreadManagementDurableRunProjectionError extends Schema.TaggedErrorClass<ThreadManagementDurableRunProjectionError>()(
+  "ThreadManagementDurableRunProjectionError",
+  {
+    threadId: ThreadId,
+    messageId: MessageId,
+  },
+) {
+  override get message(): string {
+    return `Message ${this.messageId} was accepted on thread ${this.threadId} without a durable run projection.`;
+  }
+}
+
+export const ThreadManagementError = Schema.Union([
+  ThreadManagementThreadNotFoundError,
+  ThreadManagementRunNotFoundError,
+  ThreadManagementThreadArchivedError,
+  ThreadManagementNoSteerableRunError,
+  ThreadManagementThreadNotInterruptibleError,
+  ThreadManagementProjectionLoadError,
+  ThreadManagementProjectThreadsListError,
+  ThreadManagementDurableRunProjectionError,
+]);
+export type ThreadManagementError = typeof ThreadManagementError.Type;
+
+type ThreadManagementFailure = ThreadManagementError | OrchestratorV2Error;
+
+export interface ThreadManagementServiceShape {
+  readonly ensureLegacyTranscript: (
+    threadId: ThreadId,
+  ) => Effect.Effect<void, LegacyV1ThreadImportError>;
+  readonly dispatch: (
+    command: OrchestrationV2Command,
+  ) => Effect.Effect<OrchestratorV2DispatchResult, OrchestratorV2Error>;
+  readonly getThreadProjection: (
+    threadId: ThreadId,
+  ) => Effect.Effect<OrchestrationV2ThreadProjection, OrchestratorV2Error>;
+  readonly getThreadSnapshot: OrchestratorV2["Service"]["getThreadSnapshot"];
+  readonly getThreadSnapshotWindow: OrchestratorV2["Service"]["getThreadSnapshotWindow"];
+  readonly getProjectThread: (input: {
+    readonly projectId: ProjectId;
+    readonly threadId: ThreadId;
+  }) => Effect.Effect<OrchestrationV2ThreadProjection, ThreadManagementError>;
+  readonly getShellSnapshot: (options?: {
+    readonly location?: "active" | "archive";
+  }) => Effect.Effect<OrchestrationV2ThreadShellSnapshot, OrchestratorV2Error>;
+  readonly getThreadShell: OrchestratorV2["Service"]["getThreadShell"];
+  readonly listProjectThreads: (input: {
+    readonly projectId: ProjectId;
+    readonly includeSubagents: boolean;
+  }) => Effect.Effect<ReadonlyArray<OrchestrationV2ThreadShell>, ThreadManagementError>;
+  readonly sendToThread: (
+    input: ThreadManagementSendInput,
+  ) => Effect.Effect<ThreadManagementSendResult, ThreadManagementFailure>;
+  readonly waitForThread: (
+    input: ThreadManagementWaitInput,
+  ) => Effect.Effect<ThreadManagementWaitResult, ThreadManagementError>;
+  readonly interruptThread: (
+    input: ThreadManagementInterruptInput,
+  ) => Effect.Effect<ThreadManagementInterruptResult, ThreadManagementFailure>;
+  readonly getThreadEventSequence: OrchestratorV2["Service"]["getThreadEventSequence"];
+  readonly streamStoredEvents: OrchestratorV2["Service"]["streamStoredEvents"];
+  readonly streamStoredEventsFrom: OrchestratorV2["Service"]["streamStoredEventsFrom"];
+  readonly streamDomainEvents: OrchestratorV2["Service"]["streamDomainEvents"];
+}
+
+export class ThreadManagementService extends Context.Service<
+  ThreadManagementService,
+  ThreadManagementServiceShape
+>()("t3/orchestration-v2/ThreadManagementService") {}
+
+export function isActiveRun(run: OrchestrationV2Run): boolean {
+  return (
+    run.status === "preparing" ||
+    run.status === "starting" ||
+    run.status === "running" ||
+    run.status === "waiting"
+  );
+}
+
+export function isTerminalRunStatus(
+  status: OrchestrationV2Run["status"],
+): status is ThreadManagementTerminalRunStatus {
+  return (
+    status === "completed" ||
+    status === "failed" ||
+    status === "cancelled" ||
+    status === "interrupted" ||
+    status === "rolled_back"
+  );
+}
+
+export function latestRun(
+  projection: OrchestrationV2ThreadProjection,
+): OrchestrationV2Run | undefined {
+  return projection.runs.toSorted((left, right) => right.ordinal - left.ordinal)[0];
+}
+
+export function latestActiveRun(
+  projection: OrchestrationV2ThreadProjection,
+): OrchestrationV2Run | undefined {
+  return projection.runs
+    .filter(isActiveRun)
+    .toSorted((left, right) => right.ordinal - left.ordinal)[0];
+}
+
+export function latestSteerableRun(
+  projection: OrchestrationV2ThreadProjection,
+): OrchestrationV2Run | undefined {
+  return projection.runs
+    .filter(
+      (run) =>
+        run.status === "running" &&
+        run.activeAttemptId !== null &&
+        projection.providerTurns.some(
+          (turn) => turn.runAttemptId === run.activeAttemptId && turn.status === "running",
+        ),
+    )
+    .toSorted((left, right) => right.ordinal - left.ordinal)[0];
+}
+
+const make = Effect.gen(function* () {
+  const orchestrator = yield* OrchestratorV2;
+  const legacyImporter = yield* LegacyV1ThreadImporter;
+
+  const ensureLegacyTranscript = Effect.fn(
+    "orchestrationV2.threadManagement.ensureLegacyTranscript",
+  )(function* (threadId: ThreadId) {
+    yield* legacyImporter.ensureTranscript(threadId).pipe(
+      Effect.tapError((cause) =>
+        Effect.logWarning("Unable to hydrate migrated v1 thread transcript", {
+          threadId,
+          cause,
+        }),
+      ),
+    );
+  });
+
+  const ensureProjectionTranscript = (threadId: ThreadId) =>
+    ensureLegacyTranscript(threadId).pipe(
+      Effect.mapError(
+        (cause) =>
+          new OrchestratorProjectionError({
+            threadId,
+            cause,
+          }),
+      ),
+    );
+
+  const ensureCommandTranscripts = Effect.fn(
+    "orchestrationV2.threadManagement.ensureCommandTranscripts",
+  )(function* (command: OrchestrationV2Command) {
+    yield* Effect.forEach(
+      existingThreadIdsForCommand(command),
+      (threadId) => ensureLegacyTranscript(threadId),
+      { discard: true },
+    ).pipe(
+      Effect.mapError(
+        (cause) =>
+          new OrchestratorDispatchError({
+            commandId: command.commandId,
+            commandType: command.type,
+            cause,
+          }),
+      ),
+    );
+  });
+
+  const getThreadProjection: ThreadManagementServiceShape["getThreadProjection"] = (threadId) =>
+    ensureProjectionTranscript(threadId).pipe(
+      Effect.andThen(orchestrator.getThreadProjection(threadId)),
+    );
+
+  const getThreadSnapshot: ThreadManagementServiceShape["getThreadSnapshot"] = (threadId) =>
+    ensureProjectionTranscript(threadId).pipe(
+      Effect.andThen(orchestrator.getThreadSnapshot(threadId)),
+    );
+  const getThreadSnapshotWindow: ThreadManagementServiceShape["getThreadSnapshotWindow"] = (
+    threadId,
+    options,
+  ) =>
+    ensureProjectionTranscript(threadId).pipe(
+      Effect.andThen(orchestrator.getThreadSnapshotWindow(threadId, options)),
+    );
+
+  const dispatch: ThreadManagementServiceShape["dispatch"] = (command) =>
+    ensureCommandTranscripts(command).pipe(Effect.andThen(orchestrator.dispatch(command)));
+
+  const getProjectThread: ThreadManagementServiceShape["getProjectThread"] = (input) =>
+    getThreadProjection(input.threadId).pipe(
+      Effect.mapError(
+        (cause) =>
+          new ThreadManagementProjectionLoadError({
+            projectId: input.projectId,
+            threadId: input.threadId,
+            cause,
+          }),
+      ),
+      Effect.flatMap((projection) =>
+        projection.thread.projectId === input.projectId && projection.thread.deletedAt === null
+          ? Effect.succeed(projection)
+          : Effect.fail(
+              new ThreadManagementThreadNotFoundError({
+                projectId: input.projectId,
+                threadId: input.threadId,
+              }),
+            ),
+      ),
+    );
+
+  const listProjectThreads: ThreadManagementServiceShape["listProjectThreads"] = (input) =>
+    orchestrator.getShellSnapshot().pipe(
+      Effect.mapError(
+        (cause) =>
+          new ThreadManagementProjectThreadsListError({
+            projectId: input.projectId,
+            cause,
+          }),
+      ),
+      Effect.map((snapshot) =>
+        snapshot.threads
+          .filter((thread) => thread.projectId === input.projectId)
+          .filter(
+            (thread) =>
+              input.includeSubagents || thread.lineage.relationshipToParent !== "subagent",
+          )
+          .toSorted(
+            (left, right) =>
+              DateTime.toEpochMillis(right.updatedAt) - DateTime.toEpochMillis(left.updatedAt) ||
+              right.id.localeCompare(left.id),
+          ),
+      ),
+    );
+
+  const sendToThread: ThreadManagementServiceShape["sendToThread"] = (input) =>
+    Effect.gen(function* () {
+      const target = yield* getProjectThread(input);
+      if (target.thread.archivedAt !== null) {
+        return yield* new ThreadManagementThreadArchivedError({
+          threadId: input.threadId,
+        });
+      }
+
+      const steerableRun = latestSteerableRun(target);
+      let dispatchMode: Extract<
+        OrchestrationV2Command,
+        { readonly type: "message.dispatch" }
+      >["dispatchMode"];
+      if (input.mode === "steer" || input.mode === "restart") {
+        if (steerableRun === undefined) {
+          return yield* new ThreadManagementNoSteerableRunError({
+            threadId: input.threadId,
+            mode: input.mode,
+          });
+        }
+        dispatchMode = {
+          type: input.mode === "steer" ? "steer_active" : "restart_active",
+          targetRunId: steerableRun.id,
+        };
+      } else if (input.mode === "auto" && steerableRun !== undefined) {
+        dispatchMode = { type: "steer_active", targetRunId: steerableRun.id };
+      } else {
+        dispatchMode = {
+          type: input.mode === "queue" ? "queue_after_active" : "start_immediately",
+        };
+      }
+
+      const dispatch = yield* orchestrator.dispatch({
+        type: "message.dispatch",
+        commandId: input.commandId,
+        threadId: input.threadId,
+        messageId: input.messageId,
+        text: input.text,
+        attachments: input.attachments,
+        ...(input.modelSelection === undefined ? {} : { modelSelection: input.modelSelection }),
+        dispatchMode,
+        createdBy: input.createdBy,
+        creationSource: input.creationSource,
+      });
+      const projection = yield* getProjectThread(input);
+      const message = projection.messages.find((candidate) => candidate.id === input.messageId);
+      const run =
+        message?.runId === null || message?.runId === undefined
+          ? undefined
+          : projection.runs.find((candidate) => candidate.id === message.runId);
+      const turnItem =
+        projection.turnItems.find(
+          (
+            candidate,
+          ): candidate is Extract<OrchestrationV2TurnItem, { readonly type: "user_message" }> =>
+            candidate.type === "user_message" && candidate.messageId === input.messageId,
+        ) ?? null;
+      // A queued message's user turn item is deliberately not emitted at
+      // dispatch time — it materializes when the queued turn actually starts,
+      // so it can map onto the provider turn. Every other dispatch mode still
+      // produces its turn item transactionally with the run.
+      if (
+        message === undefined ||
+        run === undefined ||
+        (turnItem === null && run.status !== "queued")
+      ) {
+        return yield* new ThreadManagementDurableRunProjectionError({
+          threadId: input.threadId,
+          messageId: input.messageId,
+        });
+      }
+      const delivery: ThreadManagementSendResult["delivery"] =
+        turnItem === null || turnItem.inputIntent === "queued_turn"
+          ? "queued"
+          : turnItem.inputIntent === "turn_start"
+            ? "started"
+            : input.mode === "restart"
+              ? "restarted"
+              : "steered";
+      return { dispatch, projection, message, run, turnItem, delivery };
+    });
+
+  const waitForThread: ThreadManagementServiceShape["waitForThread"] = (input) =>
+    Effect.gen(function* () {
+      const target = yield* getProjectThread(input);
+      const selectedRun =
+        input.runId === undefined
+          ? latestRun(target)
+          : target.runs.find((candidate) => candidate.id === input.runId);
+      if (input.runId !== undefined && selectedRun === undefined) {
+        return yield* new ThreadManagementRunNotFoundError({
+          threadId: input.threadId,
+          runId: input.runId,
+        });
+      }
+      if (selectedRun === undefined) {
+        return { threadId: input.threadId, run: null, timedOut: false };
+      }
+      if (isTerminalRunStatus(selectedRun.status)) {
+        return { threadId: input.threadId, run: selectedRun, timedOut: false };
+      }
+
+      const wait = Effect.gen(function* () {
+        while (true) {
+          const current = yield* getProjectThread(input);
+          const run = current.runs.find((candidate) => candidate.id === selectedRun.id);
+          if (run === undefined) {
+            return yield* new ThreadManagementRunNotFoundError({
+              threadId: input.threadId,
+              runId: selectedRun.id,
+            });
+          }
+          if (isTerminalRunStatus(run.status)) return run;
+          yield* Effect.sleep(Duration.millis(Math.max(1, input.pollIntervalMs ?? 250)));
+        }
+      }).pipe(Effect.timeoutOption(Duration.millis(Math.max(1, input.timeoutMs))));
+      const waited = yield* wait;
+      if (Option.isSome(waited)) {
+        return { threadId: input.threadId, run: waited.value, timedOut: false };
+      }
+      const current = yield* getProjectThread(input);
+      const run = current.runs.find((candidate) => candidate.id === selectedRun.id);
+      if (run === undefined) {
+        return yield* new ThreadManagementRunNotFoundError({
+          threadId: input.threadId,
+          runId: selectedRun.id,
+        });
+      }
+      return { threadId: input.threadId, run, timedOut: true };
+    });
+
+  const interruptThread: ThreadManagementServiceShape["interruptThread"] = (input) =>
+    Effect.gen(function* () {
+      const target = yield* getProjectThread(input);
+      const explicitRun =
+        input.runId === undefined
+          ? undefined
+          : target.runs.find((candidate) => candidate.id === input.runId);
+      if (input.runId !== undefined && explicitRun === undefined) {
+        return yield* new ThreadManagementRunNotFoundError({
+          threadId: input.threadId,
+          runId: input.runId,
+        });
+      }
+      if (explicitRun !== undefined && isTerminalRunStatus(explicitRun.status)) {
+        return {
+          type: "already_terminal",
+          run: explicitRun as OrchestrationV2Run & {
+            readonly status: ThreadManagementTerminalRunStatus;
+          },
+        } as const;
+      }
+      const interruptibleRun = latestActiveRun(target);
+      if (interruptibleRun === undefined) {
+        if (input.runId === undefined) {
+          return { type: "no_active_run" } as const;
+        }
+        return yield* new ThreadManagementThreadNotInterruptibleError({
+          threadId: input.threadId,
+          runId: input.runId,
+        });
+      }
+      if (input.runId !== undefined && interruptibleRun.id !== input.runId) {
+        return yield* new ThreadManagementThreadNotInterruptibleError({
+          threadId: input.threadId,
+          runId: input.runId,
+        });
+      }
+      const dispatch = yield* orchestrator.dispatch({
+        type: "run.interrupt",
+        commandId: input.commandId,
+        threadId: input.threadId,
+        runId: interruptibleRun.id,
+        ...(input.reason === undefined ? {} : { reason: input.reason }),
+      });
+      return { type: "interrupt_requested", run: interruptibleRun, dispatch } as const;
+    });
+
+  return ThreadManagementService.of({
+    ensureLegacyTranscript,
+    dispatch,
+    getThreadProjection,
+    getThreadSnapshot,
+    getThreadSnapshotWindow,
+    getProjectThread,
+    getShellSnapshot: orchestrator.getShellSnapshot,
+    getThreadShell: orchestrator.getThreadShell,
+    listProjectThreads,
+    sendToThread,
+    waitForThread,
+    interruptThread,
+    getThreadEventSequence: orchestrator.getThreadEventSequence,
+    streamStoredEvents: orchestrator.streamStoredEvents,
+    streamStoredEventsFrom: orchestrator.streamStoredEventsFrom,
+    streamDomainEvents: orchestrator.streamDomainEvents,
+  });
+});
+
+const legacyV1ThreadImporterNoopLayer = Layer.succeed(
+  LegacyV1ThreadImporter,
+  LegacyV1ThreadImporter.of({
+    pendingThreadCount: Effect.succeed(0),
+    reconcileShells: Effect.succeed({ importedThreadCount: 0, importedMessageCount: 0 }),
+    ensureTranscript: () => Effect.succeed({ importedThreadCount: 0, importedMessageCount: 0 }),
+    importPendingTranscripts: Effect.succeed({ importedThreadCount: 0, importedMessageCount: 0 }),
+  }),
+);
+
+export const layer: Layer.Layer<ThreadManagementService, never, OrchestratorV2> = Layer.effect(
+  ThreadManagementService,
+  make,
+).pipe(Layer.provide(legacyV1ThreadImporterNoopLayer));
+
+export const layerWithLegacyImporter: Layer.Layer<
+  ThreadManagementService,
+  never,
+  LegacyV1ThreadImporter | OrchestratorV2
+> = Layer.effect(ThreadManagementService, make);
diff --git a/apps/server/src/orchestration-v2/ThreadStream.test.ts b/apps/server/src/orchestration-v2/ThreadStream.test.ts
new file mode 100644
index 000000000000..b5e9b8d58ea4
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ThreadStream.test.ts
@@ -0,0 +1,75 @@
+import { describe, expect, it } from "vite-plus/test";
+
+import {
+  decideThreadResume,
+  threadReplayEncodedBytes,
+  THREAD_RESUME_MAX_REPLAY_ENCODED_BYTES,
+  THREAD_RESUME_MAX_REPLAY_EVENTS,
+} from "./ThreadStream.ts";
+
+describe("decideThreadResume", () => {
+  it("replays when the gap is zero", () => {
+    expect(
+      decideThreadResume({
+        afterSequence: 10,
+        highWater: 10,
+        replayEventCount: 0,
+        replayEncodedBytes: 0,
+      }),
+    ).toEqual({ mode: "replay", afterSequence: 10, throughSequence: 10 });
+  });
+
+  it("replays when the event count is within the bound", () => {
+    expect(
+      decideThreadResume({
+        afterSequence: 10,
+        highWater: 20_000,
+        replayEventCount: THREAD_RESUME_MAX_REPLAY_EVENTS,
+        replayEncodedBytes: THREAD_RESUME_MAX_REPLAY_ENCODED_BYTES,
+      }),
+    ).toEqual({
+      mode: "replay",
+      afterSequence: 10,
+      throughSequence: 20_000,
+    });
+  });
+
+  it("falls back to a snapshot when the event count exceeds the bound", () => {
+    expect(
+      decideThreadResume({
+        afterSequence: 10,
+        highWater: 20_000,
+        replayEventCount: THREAD_RESUME_MAX_REPLAY_EVENTS + 1,
+        replayEncodedBytes: 1,
+      }),
+    ).toEqual({ mode: "snapshot" });
+  });
+
+  it("falls back to a snapshot when encoded replay bytes exceed the bound", () => {
+    expect(
+      decideThreadResume({
+        afterSequence: 10,
+        highWater: 11,
+        replayEventCount: 1,
+        replayEncodedBytes: THREAD_RESUME_MAX_REPLAY_ENCODED_BYTES + 1,
+      }),
+    ).toEqual({ mode: "snapshot" });
+  });
+
+  it("falls back to a snapshot when the client cursor is ahead of the store", () => {
+    expect(
+      decideThreadResume({
+        afterSequence: 50,
+        highWater: 40,
+        replayEventCount: 0,
+        replayEncodedBytes: 0,
+      }),
+    ).toEqual({ mode: "snapshot" });
+  });
+
+  it("counts UTF-8 bytes across projected stream items", () => {
+    expect(threadReplayEncodedBytes([{ value: "a" }, { value: "🦊" }])).toBe(
+      Buffer.byteLength('{"value":"a"}', "utf8") + Buffer.byteLength('{"value":"🦊"}', "utf8"),
+    );
+  });
+});
diff --git a/apps/server/src/orchestration-v2/ThreadStream.ts b/apps/server/src/orchestration-v2/ThreadStream.ts
new file mode 100644
index 000000000000..617289886764
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ThreadStream.ts
@@ -0,0 +1,51 @@
+/** Maximum number of reducer applications allowed during a thread resume. */
+export const THREAD_RESUME_MAX_REPLAY_EVENTS = 128;
+
+/** Maximum encoded event JSON allowed during a thread resume. */
+export const THREAD_RESUME_MAX_REPLAY_ENCODED_BYTES = 1_048_576;
+
+/** Encoded payload cost after events have been projected for the wire. */
+export function threadReplayEncodedBytes(items: ReadonlyArray<unknown>): number {
+  let total = 0;
+  for (const item of items) {
+    const encoded = JSON.stringify(item);
+    total += Buffer.byteLength(encoded ?? "", "utf8");
+  }
+  return total;
+}
+
+export type ThreadResumePlan =
+  | {
+      readonly mode: "replay";
+      readonly afterSequence: number;
+      readonly throughSequence: number;
+    }
+  | { readonly mode: "snapshot" };
+
+/**
+ * Decide whether a thread subscription should replay the event gap after the
+ * client's cursor or send a fresh snapshot instead.
+ *
+ * A client cursor above the high water mark is stale or invalid. Event count
+ * limits reducer churn while encoded bytes limit a small number of large
+ * updates. Either excess is cheaper to replace with one current snapshot.
+ */
+export function decideThreadResume(input: {
+  readonly afterSequence: number;
+  readonly highWater: number;
+  readonly replayEventCount: number;
+  readonly replayEncodedBytes: number;
+}): ThreadResumePlan {
+  if (
+    input.afterSequence > input.highWater ||
+    input.replayEventCount > THREAD_RESUME_MAX_REPLAY_EVENTS ||
+    input.replayEncodedBytes > THREAD_RESUME_MAX_REPLAY_ENCODED_BYTES
+  ) {
+    return { mode: "snapshot" };
+  }
+  return {
+    mode: "replay",
+    afterSequence: input.afterSequence,
+    throughSequence: input.highWater,
+  };
+}
diff --git a/apps/server/src/orchestration-v2/ThreadTitleRegenerationService.test.ts b/apps/server/src/orchestration-v2/ThreadTitleRegenerationService.test.ts
new file mode 100644
index 000000000000..d1b175432c07
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ThreadTitleRegenerationService.test.ts
@@ -0,0 +1,433 @@
+import { assert, describe, it, vi } from "@effect/vitest";
+import {
+  type ChatAttachment,
+  CommandId,
+  MessageId,
+  ProjectId,
+  ProviderDriverKind,
+  ProviderInstanceId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+
+import { SqlitePersistenceMemory } from "../persistence/Layers/Sqlite.ts";
+import { ProjectionProjectRepository } from "../persistence/Services/ProjectionProjects.ts";
+import * as ServerSettings from "../serverSettings.ts";
+import * as TextGeneration from "../textGeneration/TextGeneration.ts";
+import { CodexProviderCapabilitiesV2 } from "./Adapters/CodexAdapterV2.ts";
+import * as EffectOutbox from "./EffectOutbox.ts";
+import type { ProviderAdapterV2Shape } from "./ProviderAdapter.ts";
+import * as ProviderAdapterRegistry from "./ProviderAdapterRegistry.ts";
+import * as ThreadManagement from "./ThreadManagementService.ts";
+import * as ThreadTitleRegeneration from "./ThreadTitleRegenerationService.ts";
+import { formatThreadTitleContext } from "./ThreadTitleRegenerationService.ts";
+import { makeOrchestratorV2ReplayLayerWithRegistry } from "./testkit/ProviderReplayHarness.ts";
+
+const projectId = ProjectId.make("project:title-regeneration");
+const modelSelection = {
+  instanceId: ProviderInstanceId.make("codex"),
+  model: "gpt-5.1-codex",
+} as const;
+
+const adapter = {
+  instanceId: modelSelection.instanceId,
+  driver: ProviderDriverKind.make("codex"),
+  getCapabilities: () => Effect.succeed(CodexProviderCapabilitiesV2),
+  planSelectionTransition: () => Effect.succeed({ type: "apply_on_next_turn" as const }),
+  openSession: () => Effect.die("provider execution is disabled in title regeneration tests"),
+} as ProviderAdapterV2Shape;
+
+function makeHarness(
+  options: {
+    readonly generateTitle?: TextGeneration.TextGeneration["Service"]["generateThreadTitle"];
+  } = {},
+) {
+  const database = SqlitePersistenceMemory;
+  const registry = ProviderAdapterRegistry.makeLayer([adapter]);
+  const orchestrator = makeOrchestratorV2ReplayLayerWithRegistry(
+    { name: "thread-title-regeneration" },
+    registry,
+    { databaseLayer: database, runEffectWorker: false },
+  );
+  const threadManagement = ThreadManagement.layer.pipe(Layer.provide(orchestrator));
+  const outbox = EffectOutbox.layer.pipe(Layer.provide(database));
+  const generateThreadTitle = vi.fn(
+    options.generateTitle ?? (() => Effect.succeed({ title: "Generated title" })),
+  );
+  const projectedProjects = Layer.mock(ProjectionProjectRepository)({
+    getById: ({ projectId: requestedProjectId }) =>
+      Effect.succeed(
+        requestedProjectId === projectId
+          ? Option.some({
+              projectId,
+              title: "Project",
+              workspaceRoot: "/repo",
+              defaultModelSelection: modelSelection,
+              defaultThreadEnvMode: null,
+              scripts: [],
+              createdAt: "2026-06-20T00:00:00.000Z",
+              updatedAt: "2026-06-20T00:00:00.000Z",
+              deletedAt: null,
+            })
+          : Option.none(),
+      ),
+  });
+  const titleRegeneration = ThreadTitleRegeneration.layer.pipe(
+    Layer.provide(
+      Layer.mergeAll(
+        threadManagement,
+        projectedProjects,
+        Layer.mock(TextGeneration.TextGeneration)({ generateThreadTitle }),
+        ServerSettings.layerTest({}),
+      ),
+    ),
+  );
+  return {
+    layer: Layer.mergeAll(threadManagement, titleRegeneration, outbox, database),
+    generateThreadTitle,
+  };
+}
+
+function createThread(input: { readonly command: string; readonly thread: string }) {
+  return Effect.gen(function* () {
+    const threads = yield* ThreadManagement.ThreadManagementService;
+    const threadId = ThreadId.make(input.thread);
+    yield* threads.dispatch({
+      type: "thread.create",
+      commandId: CommandId.make(input.command),
+      threadId,
+      projectId,
+      title: "Seed title",
+      modelSelection,
+      runtimeMode: "full-access",
+      interactionMode: "default",
+      branch: null,
+      worktreePath: null,
+      createdBy: "user",
+      creationSource: "web",
+    });
+    return threadId;
+  });
+}
+
+function dispatchUserMessage(input: {
+  readonly command: string;
+  readonly threadId: ThreadId;
+  readonly text: string;
+}) {
+  return Effect.gen(function* () {
+    const threads = yield* ThreadManagement.ThreadManagementService;
+    yield* threads.dispatch({
+      type: "message.dispatch",
+      commandId: CommandId.make(input.command),
+      threadId: input.threadId,
+      messageId: MessageId.make(`${input.command}:message`),
+      text: input.text,
+      attachments: [],
+      modelSelection,
+      dispatchMode: { type: "defer_start" },
+      createdBy: "user",
+      creationSource: "web",
+    });
+  });
+}
+
+function armRegeneration(input: { readonly command: string; readonly threadId: ThreadId }) {
+  return Effect.gen(function* () {
+    const threads = yield* ThreadManagement.ThreadManagementService;
+    const requestId = CommandId.make(input.command);
+    yield* threads.dispatch({
+      type: "thread.metadata.update",
+      commandId: requestId,
+      threadId: input.threadId,
+      regenerateTitle: true,
+    });
+    return requestId;
+  });
+}
+
+describe("formatThreadTitleContext", () => {
+  const attachment = (id: string): ChatAttachment => ({
+    type: "image",
+    id,
+    name: `${id}.png`,
+    mimeType: "image/png",
+    sizeBytes: 1,
+  });
+
+  it("builds a newest-first digest, skipping system messages and empty sections", () => {
+    const context = formatThreadTitleContext([
+      { role: "user", text: "First question" },
+      { role: "system", text: "Hidden instructions" },
+      { role: "assistant", text: "" },
+      { role: "assistant", text: "Second answer", attachments: [attachment("shot")] },
+    ]);
+    assert.equal(
+      context.message,
+      "USER:\nFirst question\n\nASSISTANT:\nSecond answer\n[Attachments: shot.png]",
+    );
+    assert.deepEqual(
+      context.attachments.map((entry) => entry.name),
+      ["shot.png"],
+    );
+  });
+
+  it("pins the first user message ahead of the retained tail once content stops fitting", () => {
+    const context = formatThreadTitleContext([
+      { role: "user", text: `Ancient context that anchors the topic ${"x".repeat(600)}` },
+      { role: "assistant", text: "y".repeat(6_000) },
+      { role: "user", text: "z".repeat(1_500) },
+    ]);
+    assert.isTrue(context.message.startsWith("USER:\nAncient context that anchors the topic"));
+    assert.isTrue(context.message.includes("[Earlier content truncated]\n\n"));
+    assert.isTrue(context.message.includes("y".repeat(100)));
+  });
+
+  it("truncates an oversized pinned first user message", () => {
+    const context = formatThreadTitleContext([
+      { role: "user", text: `Topic anchor ${"a".repeat(4_000)}` },
+      { role: "assistant", text: "y".repeat(9_000) },
+      { role: "user", text: "z".repeat(1_500) },
+    ]);
+    assert.isTrue(context.message.startsWith("USER:\nTopic anchor"));
+    assert.isTrue(context.message.includes("[First user message truncated]"));
+    assert.isTrue(context.message.includes("[Earlier content truncated]\n\n"));
+  });
+
+  it("retains at most four attachments from the newest messages", () => {
+    const context = formatThreadTitleContext([
+      { role: "user", text: "older", attachments: [attachment("a"), attachment("b")] },
+      {
+        role: "user",
+        text: "newer",
+        attachments: [attachment("c"), attachment("d"), attachment("e")],
+      },
+    ]);
+    assert.deepEqual(
+      context.attachments.map((entry) => entry.name),
+      ["b.png", "c.png", "d.png", "e.png"],
+    );
+  });
+});
+
+describe("ThreadTitleRegenerationService", () => {
+  it.effect("arms and clears the regeneration marker through metadata commands", () =>
+    Effect.gen(function* () {
+      const harness = makeHarness();
+      yield* Effect.gen(function* () {
+        const threads = yield* ThreadManagement.ThreadManagementService;
+        const outbox = yield* EffectOutbox.EffectOutboxV2;
+        const threadId = yield* createThread({
+          command: "command:title:arm:create",
+          thread: "thread:title:arm",
+        });
+
+        const firstRequest = yield* armRegeneration({ command: "command:title:arm:1", threadId });
+        const armed = yield* threads.getThreadProjection(threadId);
+        assert.equal(armed.thread.titleRegeneration?.requestId, firstRequest);
+        assert.deepEqual(
+          (yield* outbox.listByCommandId(firstRequest)).map((effect) => effect.request),
+          [{ type: "thread-title.generate", kind: { type: "regenerate" } }],
+        );
+
+        yield* threads.dispatch({
+          type: "thread.metadata.update",
+          commandId: CommandId.make("command:title:arm:abandon"),
+          threadId,
+          regenerateTitle: false,
+        });
+        const abandoned = yield* threads.getThreadProjection(threadId);
+        assert.isNotOk(abandoned.thread.titleRegeneration);
+
+        yield* armRegeneration({ command: "command:title:arm:2", threadId });
+        yield* threads.dispatch({
+          type: "thread.metadata.update",
+          commandId: CommandId.make("command:title:arm:rename"),
+          threadId,
+          title: "Manual title",
+        });
+        const renamed = yield* threads.getThreadProjection(threadId);
+        assert.equal(renamed.thread.title, "Manual title");
+        assert.isNotOk(renamed.thread.titleRegeneration);
+      }).pipe(Effect.provide(harness.layer));
+    }),
+  );
+
+  it.effect("skips execution when the marker was superseded by a newer request", () =>
+    Effect.gen(function* () {
+      const harness = makeHarness();
+      yield* Effect.gen(function* () {
+        const threads = yield* ThreadManagement.ThreadManagementService;
+        const titleRegeneration = yield* ThreadTitleRegeneration.ThreadTitleRegenerationService;
+        const threadId = yield* createThread({
+          command: "command:title:stale:create",
+          thread: "thread:title:stale",
+        });
+        const staleRequest = yield* armRegeneration({ command: "command:title:stale:1", threadId });
+        const currentRequest = yield* armRegeneration({
+          command: "command:title:stale:2",
+          threadId,
+        });
+
+        yield* titleRegeneration.execute({
+          threadId,
+          requestId: staleRequest,
+          kind: { type: "regenerate" },
+        });
+
+        assert.equal(harness.generateThreadTitle.mock.calls.length, 0);
+        const projection = yield* threads.getThreadProjection(threadId);
+        assert.equal(projection.thread.title, "Seed title");
+        assert.equal(projection.thread.titleRegeneration?.requestId, currentRequest);
+      }).pipe(Effect.provide(harness.layer));
+    }),
+  );
+
+  it.effect("lands the regenerated title from the conversation digest", () =>
+    Effect.gen(function* () {
+      const harness = makeHarness({
+        generateTitle: () => Effect.succeed({ title: "Fresh title" }),
+      });
+      yield* Effect.gen(function* () {
+        const threads = yield* ThreadManagement.ThreadManagementService;
+        const titleRegeneration = yield* ThreadTitleRegeneration.ThreadTitleRegenerationService;
+        const threadId = yield* createThread({
+          command: "command:title:landing:create",
+          thread: "thread:title:landing",
+        });
+        yield* dispatchUserMessage({
+          command: "command:title:landing:message",
+          threadId,
+          text: "Investigate the flaky login test",
+        });
+        const requestId = yield* armRegeneration({ command: "command:title:landing:1", threadId });
+
+        yield* titleRegeneration.execute({ threadId, requestId, kind: { type: "regenerate" } });
+
+        const call = harness.generateThreadTitle.mock.calls[0]?.[0];
+        assert.equal(call?.previousTitle, "Seed title");
+        assert.equal(call?.cwd, "/repo");
+        assert.include(call?.message, "USER:\nInvestigate the flaky login test");
+        const projection = yield* threads.getThreadProjection(threadId);
+        assert.equal(projection.thread.title, "Fresh title");
+        assert.isNotOk(projection.thread.titleRegeneration);
+      }).pipe(Effect.provide(harness.layer));
+    }),
+  );
+
+  it.effect("keeps the current title when generation returns the fallback", () =>
+    Effect.gen(function* () {
+      const harness = makeHarness({
+        generateTitle: () => Effect.succeed({ title: "New thread" }),
+      });
+      yield* Effect.gen(function* () {
+        const threads = yield* ThreadManagement.ThreadManagementService;
+        const titleRegeneration = yield* ThreadTitleRegeneration.ThreadTitleRegenerationService;
+        const threadId = yield* createThread({
+          command: "command:title:fallback:create",
+          thread: "thread:title:fallback",
+        });
+        yield* dispatchUserMessage({
+          command: "command:title:fallback:message",
+          threadId,
+          text: "Some conversation",
+        });
+        const requestId = yield* armRegeneration({ command: "command:title:fallback:1", threadId });
+
+        yield* titleRegeneration.execute({ threadId, requestId, kind: { type: "regenerate" } });
+
+        const projection = yield* threads.getThreadProjection(threadId);
+        assert.equal(projection.thread.title, "Seed title");
+        assert.isNotOk(projection.thread.titleRegeneration);
+      }).pipe(Effect.provide(harness.layer));
+    }),
+  );
+
+  it.effect("keeps the current title when regeneration reproduces it", () =>
+    Effect.gen(function* () {
+      const harness = makeHarness({
+        generateTitle: () => Effect.succeed({ title: "Seed title" }),
+      });
+      yield* Effect.gen(function* () {
+        const threads = yield* ThreadManagement.ThreadManagementService;
+        const titleRegeneration = yield* ThreadTitleRegeneration.ThreadTitleRegenerationService;
+        const threadId = yield* createThread({
+          command: "command:title:unchanged:create",
+          thread: "thread:title:unchanged",
+        });
+        yield* dispatchUserMessage({
+          command: "command:title:unchanged:message",
+          threadId,
+          text: "Some conversation",
+        });
+        const requestId = yield* armRegeneration({
+          command: "command:title:unchanged:1",
+          threadId,
+        });
+
+        yield* titleRegeneration.execute({ threadId, requestId, kind: { type: "regenerate" } });
+
+        const projection = yield* threads.getThreadProjection(threadId);
+        assert.equal(projection.thread.title, "Seed title");
+        assert.isNotOk(projection.thread.titleRegeneration);
+      }).pipe(Effect.provide(harness.layer));
+    }),
+  );
+
+  it.effect("clears the marker and keeps the title when generation fails", () =>
+    Effect.gen(function* () {
+      const harness = makeHarness({
+        generateTitle: () => Effect.die(new Error("model unavailable")),
+      });
+      yield* Effect.gen(function* () {
+        const threads = yield* ThreadManagement.ThreadManagementService;
+        const titleRegeneration = yield* ThreadTitleRegeneration.ThreadTitleRegenerationService;
+        const threadId = yield* createThread({
+          command: "command:title:failure:create",
+          thread: "thread:title:failure",
+        });
+        yield* dispatchUserMessage({
+          command: "command:title:failure:message",
+          threadId,
+          text: "Some conversation",
+        });
+        const requestId = yield* armRegeneration({ command: "command:title:failure:1", threadId });
+
+        yield* titleRegeneration.execute({ threadId, requestId, kind: { type: "regenerate" } });
+
+        assert.equal(harness.generateThreadTitle.mock.calls.length, 1);
+        const projection = yield* threads.getThreadProjection(threadId);
+        assert.equal(projection.thread.title, "Seed title");
+        assert.isNotOk(projection.thread.titleRegeneration);
+      }).pipe(Effect.provide(harness.layer));
+    }),
+  );
+
+  it.effect("completes without generating when the initial message is unavailable", () =>
+    Effect.gen(function* () {
+      const harness = makeHarness();
+      yield* Effect.gen(function* () {
+        const threads = yield* ThreadManagement.ThreadManagementService;
+        const titleRegeneration = yield* ThreadTitleRegeneration.ThreadTitleRegenerationService;
+        const threadId = yield* createThread({
+          command: "command:title:missing:create",
+          thread: "thread:title:missing",
+        });
+        const requestId = yield* armRegeneration({ command: "command:title:missing:1", threadId });
+
+        yield* titleRegeneration.execute({
+          threadId,
+          requestId,
+          kind: { type: "initial", messageId: MessageId.make("message:title:missing") },
+        });
+
+        assert.equal(harness.generateThreadTitle.mock.calls.length, 0);
+        const projection = yield* threads.getThreadProjection(threadId);
+        assert.equal(projection.thread.title, "Seed title");
+        assert.isNotOk(projection.thread.titleRegeneration);
+      }).pipe(Effect.provide(harness.layer));
+    }),
+  );
+});
diff --git a/apps/server/src/orchestration-v2/ThreadTitleRegenerationService.ts b/apps/server/src/orchestration-v2/ThreadTitleRegenerationService.ts
new file mode 100644
index 000000000000..c94f59005433
--- /dev/null
+++ b/apps/server/src/orchestration-v2/ThreadTitleRegenerationService.ts
@@ -0,0 +1,259 @@
+import {
+  type ChatAttachment,
+  CommandId,
+  type MessageId,
+  type ServerSettingsError,
+  type ThreadId,
+} from "@t3tools/contracts";
+import * as Cause from "effect/Cause";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+
+import type { ProjectionRepositoryError } from "../persistence/Errors.ts";
+import { ProjectionProjectRepository } from "../persistence/Services/ProjectionProjects.ts";
+import * as ServerSettings from "../serverSettings.ts";
+import * as TextGeneration from "../textGeneration/TextGeneration.ts";
+import type { OrchestratorV2Error } from "./Orchestrator.ts";
+import { ThreadManagementService } from "./ThreadManagementService.ts";
+
+const MAX_REGENERATION_ATTACHMENTS = 4;
+const MAX_THREAD_TITLE_CONTEXT_CHARS = 8_000;
+const MAX_FIRST_USER_TITLE_CONTEXT_CHARS = 2_000;
+const THREAD_TITLE_CONTEXT_TRUNCATION_MARKER = "[Earlier content truncated]\n\n";
+const FIRST_USER_CONTEXT_TRUNCATION_MARKER = "\n[First user message truncated]";
+
+type ThreadTitleMessage = {
+  readonly role: "user" | "assistant" | "system";
+  readonly text: string;
+  readonly attachments?: ReadonlyArray<ChatAttachment> | undefined;
+};
+
+function formatThreadTitleSection(message: ThreadTitleMessage): string | undefined {
+  if (message.role === "system") {
+    return undefined;
+  }
+  const text = message.text.trim();
+  const attachmentSummary = (message.attachments ?? [])
+    .map((attachment) => attachment.name)
+    .join(", ");
+  const contents = [
+    ...(text.length > 0 ? [text] : []),
+    ...(attachmentSummary.length > 0 ? [`[Attachments: ${attachmentSummary}]`] : []),
+  ].join("\n");
+  return contents.length > 0 ? `${message.role.toUpperCase()}:\n${contents}` : undefined;
+}
+
+function limitFirstUserSection(section: string): string {
+  if (section.length <= MAX_FIRST_USER_TITLE_CONTEXT_CHARS) {
+    return section;
+  }
+  return `${section.slice(
+    0,
+    MAX_FIRST_USER_TITLE_CONTEXT_CHARS - FIRST_USER_CONTEXT_TRUNCATION_MARKER.length,
+  )}${FIRST_USER_CONTEXT_TRUNCATION_MARKER}`;
+}
+
+function collectRecentThreadTitleContext(
+  messages: ReadonlyArray<ThreadTitleMessage>,
+  maxChars: number,
+): {
+  readonly context: string;
+  readonly attachments: ReadonlyArray<ChatAttachment>;
+  readonly truncated: boolean;
+} {
+  let context = "";
+  let truncated = false;
+  const retainedAttachments: Array<ChatAttachment> = [];
+
+  for (const message of messages.toReversed()) {
+    const section = formatThreadTitleSection(message);
+    if (section === undefined) {
+      continue;
+    }
+
+    const separator = context.length > 0 ? "\n\n" : "";
+    const available = maxChars - context.length - separator.length;
+    if (section.length > available) {
+      if (available > 0) {
+        context = `${section.slice(-available)}${separator}${context}`;
+        retainedAttachments.unshift(...(message.attachments ?? []));
+      }
+      truncated = true;
+      break;
+    }
+    context = `${section}${separator}${context}`;
+    retainedAttachments.unshift(...(message.attachments ?? []));
+  }
+
+  return { context, attachments: retainedAttachments, truncated };
+}
+
+/**
+ * Conversation digest for the title prompt. Recent messages fill the budget
+ * newest-first; when the conversation no longer fits, the first user message
+ * is pinned ahead of the recent tail so regenerated titles stay anchored to
+ * what the thread is actually about. Mirrors the v1 reactor's flow (#5365).
+ */
+export function formatThreadTitleContext(messages: ReadonlyArray<ThreadTitleMessage>): {
+  readonly message: string;
+  readonly attachments: ReadonlyArray<ChatAttachment>;
+} {
+  const recent = collectRecentThreadTitleContext(messages, MAX_THREAD_TITLE_CONTEXT_CHARS);
+  if (!recent.truncated) {
+    return {
+      message: recent.context,
+      attachments: recent.attachments.slice(-MAX_REGENERATION_ATTACHMENTS),
+    };
+  }
+
+  const firstUserMessage = messages.find(
+    (message) => message.role === "user" && formatThreadTitleSection(message),
+  );
+  const firstUserSection = firstUserMessage
+    ? formatThreadTitleSection(firstUserMessage)
+    : undefined;
+  if (!firstUserMessage || !firstUserSection) {
+    return {
+      message: `${THREAD_TITLE_CONTEXT_TRUNCATION_MARKER}${recent.context}`,
+      attachments: recent.attachments.slice(-MAX_REGENERATION_ATTACHMENTS),
+    };
+  }
+
+  const pinnedSection = limitFirstUserSection(firstUserSection);
+  const recentContextBudget =
+    MAX_THREAD_TITLE_CONTEXT_CHARS -
+    pinnedSection.length -
+    "\n\n".length -
+    THREAD_TITLE_CONTEXT_TRUNCATION_MARKER.length;
+  const retainedRecent = collectRecentThreadTitleContext(messages, recentContextBudget);
+  const pinnedAttachment = firstUserMessage.attachments?.[0];
+  const recentAttachments = retainedRecent.attachments.filter(
+    (attachment) => attachment.id !== pinnedAttachment?.id,
+  );
+
+  return {
+    message: `${pinnedSection}\n\n${THREAD_TITLE_CONTEXT_TRUNCATION_MARKER}${retainedRecent.context}`,
+    attachments: [
+      ...(pinnedAttachment ? [pinnedAttachment] : []),
+      ...recentAttachments.slice(
+        -(MAX_REGENERATION_ATTACHMENTS - (pinnedAttachment === undefined ? 0 : 1)),
+      ),
+    ],
+  };
+}
+
+export class ThreadTitleRegenerationService extends Context.Service<
+  ThreadTitleRegenerationService,
+  {
+    readonly execute: (input: {
+      readonly threadId: ThreadId;
+      readonly requestId: CommandId;
+      readonly kind:
+        | { readonly type: "initial"; readonly messageId: MessageId }
+        | { readonly type: "regenerate" };
+    }) => Effect.Effect<
+      void,
+      OrchestratorV2Error | ProjectionRepositoryError | ServerSettingsError
+    >;
+  }
+>()("t3/orchestration-v2/ThreadTitleRegenerationService") {}
+
+export const make = Effect.gen(function* () {
+  const threads = yield* ThreadManagementService;
+  const projects = yield* ProjectionProjectRepository;
+  const serverSettings = yield* ServerSettings.ServerSettingsService;
+  const textGeneration = yield* TextGeneration.TextGeneration;
+
+  const complete = (input: {
+    readonly threadId: ThreadId;
+    readonly requestId: CommandId;
+    readonly title?: string;
+  }) =>
+    threads
+      .dispatch({
+        type: "thread.title.regeneration.complete",
+        commandId: CommandId.make(`${input.requestId}:title-complete`),
+        threadId: input.threadId,
+        requestId: input.requestId,
+        ...(input.title === undefined ? {} : { title: input.title }),
+      })
+      .pipe(Effect.asVoid);
+
+  const execute: ThreadTitleRegenerationService["Service"]["execute"] = Effect.fn(
+    "ThreadTitleRegenerationService.execute",
+  )(function* (input) {
+    const outcome:
+      | { readonly type: "stale" }
+      | { readonly type: "complete"; readonly title?: string } = yield* Effect.gen(function* () {
+      const projection = yield* threads.getThreadProjection(input.threadId);
+      if (projection.thread.titleRegeneration?.requestId !== input.requestId) {
+        return { type: "stale" as const };
+      }
+
+      const project = yield* projects.getById({ projectId: projection.thread.projectId });
+      if (Option.isNone(project)) {
+        return { type: "complete" as const };
+      }
+
+      let context: {
+        readonly message: string;
+        readonly attachments: ReadonlyArray<ChatAttachment>;
+      };
+      if (input.kind.type === "initial") {
+        const messageId = input.kind.messageId;
+        const message = projection.messages.find(
+          (candidate) => candidate.id === messageId && !candidate.streaming,
+        );
+        context =
+          message === undefined
+            ? { message: "", attachments: [] }
+            : { message: message.text, attachments: message.attachments };
+      } else {
+        context = formatThreadTitleContext(
+          projection.messages.filter((message) => !message.streaming),
+        );
+      }
+      if (context.message.length === 0 && context.attachments.length === 0) {
+        return { type: "complete" as const };
+      }
+
+      const settings = yield* serverSettings.getSettings;
+      const result = yield* textGeneration.generateThreadTitle({
+        cwd: projection.thread.worktreePath ?? project.value.workspaceRoot,
+        message: context.message,
+        attachments: context.attachments,
+        ...(input.kind.type === "regenerate" ? { previousTitle: projection.thread.title } : {}),
+        modelSelection: settings.textGenerationModelSelection,
+      });
+      const generatedTitle = result.title.trim();
+      return generatedTitle === "New thread" ||
+        (input.kind.type === "regenerate" && generatedTitle === projection.thread.title.trim())
+        ? { type: "complete" as const }
+        : { type: "complete" as const, title: result.title };
+    }).pipe(
+      Effect.catchCause((cause) =>
+        Cause.hasInterruptsOnly(cause)
+          ? Effect.interrupt
+          : Effect.logWarning("Thread title generation failed", {
+              threadId: input.threadId,
+              requestId: input.requestId,
+              cause,
+            }).pipe(Effect.as({ type: "complete" as const })),
+      ),
+    );
+
+    if (outcome.type === "stale") {
+      return;
+    }
+    yield* complete({
+      ...input,
+      ...(outcome.title === undefined ? {} : { title: outcome.title }),
+    });
+  });
+
+  return ThreadTitleRegenerationService.of({ execute });
+});
+
+export const layer = Layer.effect(ThreadTitleRegenerationService, make);
diff --git a/apps/server/src/orchestration-v2/TurnItemPositionStore.ts b/apps/server/src/orchestration-v2/TurnItemPositionStore.ts
new file mode 100644
index 000000000000..7fd420f70e95
--- /dev/null
+++ b/apps/server/src/orchestration-v2/TurnItemPositionStore.ts
@@ -0,0 +1,107 @@
+import { OrchestrationV2TurnItem, RunId, ThreadId, TurnItemId } from "@t3tools/contracts";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Schema from "effect/Schema";
+import * as SqlClient from "effect/unstable/sql/SqlClient";
+
+export class TurnItemPositionStoreError extends Schema.TaggedErrorClass<TurnItemPositionStoreError>()(
+  "TurnItemPositionStoreError",
+  {
+    threadId: ThreadId,
+    turnItemId: TurnItemId,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {}
+
+const isTurnItemPositionStoreError = Schema.is(TurnItemPositionStoreError);
+
+export interface TurnItemPositionStoreV2Shape {
+  readonly allocate: (input: {
+    readonly threadId: ThreadId;
+    readonly turnItemId: TurnItemId;
+    readonly runId: RunId | null;
+    readonly runOrdinal?: number;
+  }) => Effect.Effect<number, TurnItemPositionStoreError>;
+  readonly normalize: (
+    item: OrchestrationV2TurnItem,
+    runOrdinal?: number,
+  ) => Effect.Effect<OrchestrationV2TurnItem, TurnItemPositionStoreError>;
+}
+
+export class TurnItemPositionStoreV2 extends Context.Service<
+  TurnItemPositionStoreV2,
+  TurnItemPositionStoreV2Shape
+>()("t3/orchestration-v2/TurnItemPositionStore/TurnItemPositionStoreV2") {}
+
+export const layer: Layer.Layer<TurnItemPositionStoreV2, never, SqlClient.SqlClient> = Layer.effect(
+  TurnItemPositionStoreV2,
+  Effect.gen(function* () {
+    const sql = yield* SqlClient.SqlClient;
+
+    const allocate: TurnItemPositionStoreV2Shape["allocate"] = ({
+      threadId,
+      turnItemId,
+      runId,
+      runOrdinal: suppliedRunOrdinal,
+    }) =>
+      Effect.gen(function* () {
+        const runRows =
+          runId === null
+            ? []
+            : yield* sql<{ readonly ordinal: number }>`
+                SELECT ordinal
+                FROM orchestration_v2_projection_runs
+                WHERE thread_id = ${threadId} AND run_id = ${runId}
+                LIMIT 1
+              `;
+        const runOrdinal = suppliedRunOrdinal ?? runRows[0]?.ordinal ?? null;
+        const lowerBound = runOrdinal === null ? 0 : runOrdinal * 1_000_000;
+        const upperBound = runOrdinal === null ? 999_999 : lowerBound + 999_999;
+        yield* sql`
+          INSERT INTO orchestration_v2_turn_item_positions (thread_id, turn_item_id, ordinal)
+          SELECT
+            ${threadId},
+            ${turnItemId},
+            COALESCE(MAX(ordinal), ${lowerBound}) + 1
+          FROM orchestration_v2_turn_item_positions
+          WHERE thread_id = ${threadId}
+            AND ordinal >= ${lowerBound}
+            AND ordinal <= ${upperBound}
+          ON CONFLICT(thread_id, turn_item_id) DO NOTHING
+        `;
+        const rows = yield* sql<{ readonly ordinal: number }>`
+          SELECT ordinal
+          FROM orchestration_v2_turn_item_positions
+          WHERE thread_id = ${threadId} AND turn_item_id = ${turnItemId}
+          LIMIT 1
+        `;
+        const ordinal = rows[0]?.ordinal;
+        if (ordinal === undefined) {
+          return yield* new TurnItemPositionStoreError({
+            threadId,
+            turnItemId,
+            cause: "Position allocation returned no row.",
+          });
+        }
+        return ordinal;
+      }).pipe(
+        Effect.mapError((cause) =>
+          isTurnItemPositionStoreError(cause)
+            ? cause
+            : new TurnItemPositionStoreError({ threadId, turnItemId, cause }),
+        ),
+      );
+
+    return TurnItemPositionStoreV2.of({
+      allocate,
+      normalize: (item, runOrdinal) =>
+        allocate({
+          threadId: item.threadId,
+          turnItemId: item.id,
+          runId: item.runId,
+          ...(runOrdinal === undefined ? {} : { runOrdinal }),
+        }).pipe(Effect.map((ordinal) => (item.ordinal === ordinal ? item : { ...item, ordinal }))),
+    });
+  }),
+);
diff --git a/apps/server/src/orchestration-v2/UserFacingErrors.test.ts b/apps/server/src/orchestration-v2/UserFacingErrors.test.ts
new file mode 100644
index 000000000000..63e3a77a5b3f
--- /dev/null
+++ b/apps/server/src/orchestration-v2/UserFacingErrors.test.ts
@@ -0,0 +1,35 @@
+import { assert, describe, it } from "@effect/vitest";
+
+import { userFacingDispatchErrorMessage } from "./UserFacingErrors.ts";
+
+describe("userFacingDispatchErrorMessage", () => {
+  it("returns the deepest actionable domain error instead of generic dispatch wrappers", () => {
+    const message = userFacingDispatchErrorMessage({
+      message: "Failed to dispatch orchestration command checkpoint.rollback (command-1).",
+      cause: {
+        message: "Provider adapter failed while dispatching orchestration command command-1.",
+        cause: {
+          message:
+            "claudeAgent cannot satisfy rollback for command command-1: provider conversation rollback is unavailable",
+        },
+      },
+    });
+
+    assert.equal(
+      message,
+      "claudeAgent cannot satisfy rollback for command command-1: provider conversation rollback is unavailable",
+    );
+  });
+
+  it("uses explicit detail fields as user-facing messages", () => {
+    assert.equal(
+      userFacingDispatchErrorMessage({
+        message: "Failed to dispatch orchestration command message.dispatch (command-1).",
+        cause: {
+          detail: "Claude provider thread provider-thread-1 has no live query.",
+        },
+      }),
+      "Claude provider thread provider-thread-1 has no live query.",
+    );
+  });
+});
diff --git a/apps/server/src/orchestration-v2/UserFacingErrors.ts b/apps/server/src/orchestration-v2/UserFacingErrors.ts
new file mode 100644
index 000000000000..3765312da39b
--- /dev/null
+++ b/apps/server/src/orchestration-v2/UserFacingErrors.ts
@@ -0,0 +1,62 @@
+const GENERIC_ERROR_PREFIXES = [
+  "Failed to dispatch orchestration V2 command",
+  "Failed to dispatch orchestration command ",
+  "Provider adapter failed while dispatching orchestration command ",
+];
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null;
+}
+
+function textValue(value: unknown): string | undefined {
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
+}
+
+function messageFrom(value: unknown): string | undefined {
+  if (typeof value === "string") {
+    return textValue(value);
+  }
+  if (value instanceof Error) {
+    return textValue(value.message);
+  }
+  if (!isRecord(value)) {
+    return undefined;
+  }
+  return textValue(value.detail) ?? textValue(value.message);
+}
+
+function isGenericErrorMessage(message: string): boolean {
+  return GENERIC_ERROR_PREFIXES.some((prefix) => message.startsWith(prefix));
+}
+
+function collectErrorMessages(value: unknown, seen: Set<unknown>): ReadonlyArray<string> {
+  if (value === undefined || value === null || seen.has(value)) {
+    return [];
+  }
+  seen.add(value);
+
+  if (Array.isArray(value)) {
+    return value.flatMap((item) => collectErrorMessages(item, seen));
+  }
+
+  const message = messageFrom(value);
+  if (!isRecord(value)) {
+    return message === undefined ? [] : [message];
+  }
+
+  const nested = [
+    ...collectErrorMessages(value.cause, seen),
+    ...collectErrorMessages(value.error, seen),
+    ...collectErrorMessages(value.errors, seen),
+  ];
+
+  return message === undefined ? nested : [message, ...nested];
+}
+
+export function userFacingDispatchErrorMessage(cause: unknown): string | undefined {
+  const messages = collectErrorMessages(cause, new Set()).filter(
+    (message, index, allMessages) =>
+      !isGenericErrorMessage(message) && allMessages.indexOf(message) === index,
+  );
+  return messages.at(-1);
+}
diff --git a/apps/server/src/orchestration-v2/V1ImportBoundary.test.ts b/apps/server/src/orchestration-v2/V1ImportBoundary.test.ts
new file mode 100644
index 000000000000..9e7e45f00ba7
--- /dev/null
+++ b/apps/server/src/orchestration-v2/V1ImportBoundary.test.ts
@@ -0,0 +1,38 @@
+// @effect-diagnostics nodeBuiltinImport:off - Static architecture test scans source files.
+import * as NodeFS from "node:fs";
+import * as NodePath from "node:path";
+
+import { assert, it } from "@effect/vitest";
+
+const sourceRoot = NodePath.resolve(import.meta.dirname, "..");
+const forbiddenImport =
+  /from\s+["'][^"']*(?:ProviderService|ProviderSessionDirectory|ProviderSessionReaper|ProviderCommandReactor|ProviderRuntimeIngestion)[^"']*["']/;
+const retiredAgentRuntimePaths = [
+  "orchestration/Layers/ProviderCommandReactor.ts",
+  "orchestration/Layers/ProviderRuntimeIngestion.ts",
+  "orchestration/Services/ProviderCommandReactor.ts",
+  "orchestration/Services/ProviderRuntimeIngestion.ts",
+] as const;
+
+function productionTypeScriptFiles(directory: string): ReadonlyArray<string> {
+  return NodeFS.readdirSync(directory, { withFileTypes: true }).flatMap((entry) => {
+    const path = NodePath.join(directory, entry.name);
+    if (entry.isDirectory()) {
+      return entry.name === "legacy" ? [] : productionTypeScriptFiles(path);
+    }
+    return entry.isFile() && entry.name.endsWith(".ts") && !entry.name.includes(".test.")
+      ? [path]
+      : [];
+  });
+}
+
+it("retains the application data plane without restoring the V1 agent runtime", () => {
+  for (const relativePath of retiredAgentRuntimePaths) {
+    assert.isFalse(NodeFS.existsSync(NodePath.join(sourceRoot, relativePath)));
+  }
+  const violations = productionTypeScriptFiles(sourceRoot).flatMap((path) => {
+    const source = NodeFS.readFileSync(path, "utf8");
+    return forbiddenImport.test(source) ? [NodePath.relative(sourceRoot, path)] : [];
+  });
+  assert.deepEqual(violations, []);
+});
diff --git a/apps/server/src/orchestration-v2/WireProjection.test.ts b/apps/server/src/orchestration-v2/WireProjection.test.ts
new file mode 100644
index 000000000000..3694d92ed4cf
--- /dev/null
+++ b/apps/server/src/orchestration-v2/WireProjection.test.ts
@@ -0,0 +1,113 @@
+import {
+  MessageId,
+  ProjectId,
+  ProviderInstanceId,
+  ThreadId,
+  TurnItemId,
+  type OrchestrationV2ThreadProjection,
+  type OrchestrationV2TurnItem,
+} from "@t3tools/contracts";
+import { describe, expect, it } from "@effect/vitest";
+import * as DateTime from "effect/DateTime";
+
+import { projectTurnItemForWire } from "./WireProjection.ts";
+import { threadShellFromProjection } from "./ProjectionStore.ts";
+
+const base = {
+  id: TurnItemId.make("tool-1"),
+  type: "dynamic_tool" as const,
+  threadId: ThreadId.make("thread-1"),
+  runId: null,
+  nodeId: null,
+  providerThreadId: null,
+  providerTurnId: null,
+  nativeItemRef: null,
+  parentItemId: null,
+  ordinal: 1,
+  status: "completed" as const,
+  title: "MCP tool",
+  toolName: "mcp__github__fetch_pr",
+  input: { pr: 42 },
+  startedAt: DateTime.makeUnsafe("2026-08-13T00:00:00.000Z"),
+  completedAt: DateTime.makeUnsafe("2026-08-13T00:00:01.000Z"),
+  updatedAt: DateTime.makeUnsafe("2026-08-13T00:00:01.000Z"),
+};
+
+describe("orchestration V2 wire projection", () => {
+  it("keeps transcript bodies out of shell rows", () => {
+    const now = DateTime.makeUnsafe("2026-08-13T00:00:00.000Z");
+    const threadId = ThreadId.make("thread-shell-budget");
+    const projection = {
+      thread: {
+        createdBy: "user",
+        creationSource: "web",
+        id: threadId,
+        projectId: ProjectId.make("project-shell-budget"),
+        title: "Shell payload budget",
+        providerInstanceId: ProviderInstanceId.make("codex"),
+        modelSelection: null,
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        branch: null,
+        worktreePath: null,
+        lineage: {
+          parentThreadId: null,
+          relationshipToParent: null,
+          rootThreadId: threadId,
+        },
+        forkedFrom: null,
+        activeProviderThreadId: null,
+        createdAt: now,
+        updatedAt: now,
+        archivedAt: null,
+        settledOverride: null,
+        settledAt: null,
+        deletedAt: null,
+      },
+      runs: [],
+      runtimeRequests: [],
+      messages: [
+        {
+          id: MessageId.make("message-shell-budget"),
+          role: "assistant",
+          text: "x".repeat(1_000_000),
+          updatedAt: now,
+        },
+      ],
+      providerSessions: [],
+      providerThreads: [],
+      turnItems: [],
+      visibleTurnItems: [],
+      plans: [],
+      updatedAt: now,
+    } as unknown as OrchestrationV2ThreadProjection;
+
+    const shell = threadShellFromProjection(projection);
+
+    expect(shell.latestVisibleMessage).toBeNull();
+    expect(JSON.stringify(shell).length).toBeLessThan(2_000);
+  });
+
+  it("summarizes oversized dynamic tool results without mutating persistence data", () => {
+    const output = { content: [{ type: "text", text: "first line\n" + "x".repeat(100_000) }] };
+    const item = { ...base, output } satisfies OrchestrationV2TurnItem;
+    const projected = projectTurnItemForWire(item);
+
+    expect(item.output).toBe(output);
+    expect(projected).not.toBe(item);
+    expect(JSON.stringify(projected).length).toBeLessThan(2_000);
+    expect(projected.type === "dynamic_tool" ? projected.output : null).toMatchObject({
+      truncated: true,
+    });
+  });
+
+  it("keeps small dynamic tool values intact", () => {
+    const item = { ...base, output: { ok: true } } satisfies OrchestrationV2TurnItem;
+    expect(projectTurnItemForWire(item)).toEqual(item);
+  });
+
+  it("keeps undefined dynamic input intact", () => {
+    const item = { ...base, input: undefined } satisfies OrchestrationV2TurnItem;
+    expect(projectTurnItemForWire(item)).toEqual(item);
+  });
+});
diff --git a/apps/server/src/orchestration-v2/WireProjection.ts b/apps/server/src/orchestration-v2/WireProjection.ts
new file mode 100644
index 000000000000..eaa0a7898d66
--- /dev/null
+++ b/apps/server/src/orchestration-v2/WireProjection.ts
@@ -0,0 +1,108 @@
+import type {
+  OrchestrationV2DomainEvent,
+  OrchestrationV2ThreadProjection,
+  OrchestrationV2TurnItem,
+} from "@t3tools/contracts";
+
+const MAX_DETAIL_STRING_BYTES = 32_768;
+const MAX_DYNAMIC_VALUE_BYTES = 16_384;
+
+function encodedBytes(value: unknown): number {
+  try {
+    const serialized = JSON.stringify(value);
+    return Buffer.byteLength(serialized ?? String(value), "utf8");
+  } catch {
+    return Number.POSITIVE_INFINITY;
+  }
+}
+
+function truncateDetail(value: string | undefined): string | undefined {
+  if (value === undefined || Buffer.byteLength(value, "utf8") <= MAX_DETAIL_STRING_BYTES) {
+    return value;
+  }
+  const prefix = Buffer.from(value, "utf8")
+    .subarray(0, MAX_DETAIL_STRING_BYTES)
+    .toString("utf8")
+    .replace(/\uFFFD$/u, "");
+  return `${prefix}\n… output truncated for transport`;
+}
+
+function summarizeDynamicValue(value: unknown): unknown {
+  if (encodedBytes(value) <= MAX_DYNAMIC_VALUE_BYTES) {
+    return value;
+  }
+  let serialized: string;
+  try {
+    serialized = typeof value === "string" ? value : (JSON.stringify(value) ?? String(value));
+  } catch {
+    serialized = "Unserializable tool output";
+  }
+  const firstLine =
+    serialized
+      .split(/\r?\n/u)
+      .map((line) => line.replace(/\s+/gu, " ").trim())
+      .find((line) => line.length > 0) ?? "Large tool output";
+  return {
+    summary: firstLine.length <= 160 ? firstLine : `${firstLine.slice(0, 159).trimEnd()}…`,
+    truncated: true,
+  };
+}
+
+export function projectTurnItemForWire(item: OrchestrationV2TurnItem): OrchestrationV2TurnItem {
+  switch (item.type) {
+    case "command_execution":
+      return { ...item, output: truncateDetail(item.output) };
+    case "file_change":
+      return {
+        ...item,
+        diffStr: truncateDetail(item.diffStr),
+        oldStr: truncateDetail(item.oldStr),
+        newStr: truncateDetail(item.newStr),
+      };
+    case "subagent":
+      return {
+        ...item,
+        prompt: truncateDetail(item.prompt) ?? "",
+        progress: truncateDetail(item.progress),
+        result: item.result === null ? null : (truncateDetail(item.result) ?? null),
+      };
+    case "dynamic_tool":
+      return {
+        ...item,
+        input: summarizeDynamicValue(item.input),
+        ...(item.output === undefined ? {} : { output: summarizeDynamicValue(item.output) }),
+      };
+    default:
+      return item;
+  }
+}
+
+export function projectThreadProjectionForWire(
+  projection: OrchestrationV2ThreadProjection,
+): OrchestrationV2ThreadProjection {
+  const projectedById = new Map<string, OrchestrationV2TurnItem>();
+  const project = (item: OrchestrationV2TurnItem) => {
+    const key = `${item.threadId}:${item.id}`;
+    const existing = projectedById.get(key);
+    if (existing !== undefined) return existing;
+    const projected = projectTurnItemForWire(item);
+    projectedById.set(key, projected);
+    return projected;
+  };
+  return {
+    ...projection,
+    turnItems: projection.turnItems.map(project),
+    visibleTurnItems: projection.visibleTurnItems.map((row) => ({
+      ...row,
+      item: project(row.item),
+    })),
+  };
+}
+
+export function projectDomainEventForWire(
+  event: OrchestrationV2DomainEvent,
+): OrchestrationV2DomainEvent {
+  return event.type === "turn-item.updated"
+    ? { ...event, payload: projectTurnItemForWire(event.payload) }
+    : event;
+}
diff --git a/apps/server/src/orchestration-v2/applicationLayer.ts b/apps/server/src/orchestration-v2/applicationLayer.ts
new file mode 100644
index 000000000000..2a174a316f8a
--- /dev/null
+++ b/apps/server/src/orchestration-v2/applicationLayer.ts
@@ -0,0 +1,23 @@
+import * as Layer from "effect/Layer";
+
+import { ProjectionProjectRepositoryLive } from "../persistence/Layers/ProjectionProjects.ts";
+import { layer as projectServiceLayer } from "../project/ProjectService.ts";
+import { layer as threadLaunchServiceLayer } from "./ThreadLaunchService.ts";
+import { layer as threadLifecycleServiceLayer } from "./ThreadLifecycleService.ts";
+import { live as resourceCleanupLive } from "./ResourceCleanupService.ts";
+import { observerLive as runFinalizationObserverLive } from "./RunFinalizationService.ts";
+
+const projectServiceProvided = projectServiceLayer.pipe(
+  Layer.provide(ProjectionProjectRepositoryLive),
+);
+
+const applicationServices = Layer.mergeAll(
+  threadLaunchServiceLayer,
+  threadLifecycleServiceLayer,
+).pipe(Layer.provideMerge(projectServiceProvided));
+
+export const OrchestrationV2ApplicationLayer = Layer.mergeAll(
+  applicationServices,
+  resourceCleanupLive,
+  runFinalizationObserverLive,
+);
diff --git a/apps/server/src/orchestration-v2/builtInProviderAdapterDrivers.ts b/apps/server/src/orchestration-v2/builtInProviderAdapterDrivers.ts
new file mode 100644
index 000000000000..1ef37a2bfa0a
--- /dev/null
+++ b/apps/server/src/orchestration-v2/builtInProviderAdapterDrivers.ts
@@ -0,0 +1,47 @@
+import type { ProviderDriverKind } from "@t3tools/contracts";
+
+import {
+  AcpRegistryAdapterV2Driver,
+  type AcpRegistryAdapterV2DriverEnv,
+} from "./Adapters/AcpRegistryAdapterV2.ts";
+import {
+  ClaudeAdapterV2Driver,
+  type ClaudeAdapterV2DriverEnv,
+} from "./Adapters/ClaudeAdapterV2.ts";
+import { CodexAdapterV2Driver, type CodexAdapterV2DriverEnv } from "./Adapters/CodexAdapterV2.ts";
+import {
+  CursorAdapterV2Driver,
+  type CursorAdapterV2DriverEnv,
+} from "./Adapters/CursorAdapterV2.ts";
+import { GrokAdapterV2Driver, type GrokAdapterV2DriverEnv } from "./Adapters/GrokAdapterV2.ts";
+import {
+  OpenCodeAdapterV2Driver,
+  type OpenCodeAdapterV2DriverEnv,
+} from "./Adapters/OpenCodeAdapterV2.ts";
+import type { AnyProviderAdapterDriver } from "./ProviderAdapterDriver.ts";
+
+export type BuiltInProviderAdapterDriversV2Env =
+  | AcpRegistryAdapterV2DriverEnv
+  | ClaudeAdapterV2DriverEnv
+  | CodexAdapterV2DriverEnv
+  | CursorAdapterV2DriverEnv
+  | GrokAdapterV2DriverEnv
+  | OpenCodeAdapterV2DriverEnv;
+
+export const BUILT_IN_PROVIDER_ADAPTER_DRIVERS_V2: ReadonlyArray<
+  AnyProviderAdapterDriver<BuiltInProviderAdapterDriversV2Env>
+> = [
+  CodexAdapterV2Driver,
+  ClaudeAdapterV2Driver,
+  CursorAdapterV2Driver,
+  OpenCodeAdapterV2Driver,
+  GrokAdapterV2Driver,
+  AcpRegistryAdapterV2Driver,
+];
+
+export const BUILT_IN_PROVIDER_ADAPTER_DRIVER_KINDS_V2: ReadonlySet<ProviderDriverKind> = new Set(
+  BUILT_IN_PROVIDER_ADAPTER_DRIVERS_V2.map((driver) => driver.driverKind),
+);
+
+export const isBuiltInProviderAdapterDriverV2 = (driver: ProviderDriverKind): boolean =>
+  BUILT_IN_PROVIDER_ADAPTER_DRIVER_KINDS_V2.has(driver);
diff --git a/apps/server/src/orchestration-v2/http.ts b/apps/server/src/orchestration-v2/http.ts
new file mode 100644
index 000000000000..420e4f5f5de3
--- /dev/null
+++ b/apps/server/src/orchestration-v2/http.ts
@@ -0,0 +1,258 @@
+import {
+  AuthOrchestrationReadScope,
+  EnvironmentHttpApi,
+  ThreadId,
+  TurnItemId,
+  type OrchestrationProjectShell,
+} from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as Predicate from "effect/Predicate";
+import * as HttpApiBuilder from "effect/unstable/httpapi/HttpApiBuilder";
+import * as SqlClient from "effect/unstable/sql/SqlClient";
+
+import {
+  annotateEnvironmentRequest,
+  failEnvironmentInternal,
+  failEnvironmentInvalidRequest,
+  failEnvironmentNotFound,
+  requireEnvironmentScope,
+} from "../auth/http.ts";
+import * as ProjectionSnapshotQuery from "../orchestration/Services/ProjectionSnapshotQuery.ts";
+import * as OrchestrationEventStore from "../persistence/Services/OrchestrationEventStore.ts";
+import * as ProjectEnrichmentService from "../project/ProjectEnrichmentService.ts";
+import {
+  buildBoundedThreadProjection,
+  decodeThreadHistoryCursor,
+  InvalidThreadHistoryCursorError,
+  selectHistoryPageFromCursor,
+  THREAD_HISTORY_PAGE_POLICY,
+} from "./threadHistoryPaging.ts";
+import * as ThreadManagementService from "./ThreadManagementService.ts";
+import { buildActiveShellSnapshot } from "./ShellStream.ts";
+import { projectThreadProjectionForWire } from "./WireProjection.ts";
+
+function isThreadNotFound(error: unknown): boolean {
+  return (
+    Predicate.hasProperty(error, "cause") &&
+    Predicate.hasProperty(error.cause, "_tag") &&
+    error.cause._tag === "ProjectionStoreThreadNotFoundError"
+  );
+}
+
+function selectHistoryPageFromCursorOrError(
+  input: Parameters<typeof selectHistoryPageFromCursor>[0],
+):
+  | { readonly _tag: "ok"; readonly page: ReturnType<typeof selectHistoryPageFromCursor> }
+  | { readonly _tag: "invalid_cursor" }
+  | { readonly _tag: "error"; readonly cause: unknown } {
+  try {
+    return { _tag: "ok", page: selectHistoryPageFromCursor(input) };
+  } catch (cause) {
+    if (cause instanceof InvalidThreadHistoryCursorError) {
+      return { _tag: "invalid_cursor" };
+    }
+    return { _tag: "error", cause };
+  }
+}
+
+/**
+ * Serves orchestration V2 snapshots over HTTP so clients can load the
+ * (potentially large) shell and thread projections off the socket; gzip
+ * compressible and cacheable — and then resume the WebSocket subscription via
+ * `afterSequence`.
+ */
+export const orchestrationHttpApiLayer = HttpApiBuilder.group(
+  EnvironmentHttpApi,
+  "orchestration",
+  Effect.fnUntraced(function* (handlers) {
+    const sql = yield* SqlClient.SqlClient;
+    const threadManagement = yield* ThreadManagementService.ThreadManagementService;
+    const applicationEvents = yield* OrchestrationEventStore.OrchestrationEventStore;
+    const projectionSnapshotQuery = yield* ProjectionSnapshotQuery.ProjectionSnapshotQuery;
+    const projectEnrichment = yield* ProjectEnrichmentService.ProjectEnrichmentService;
+
+    const enrichProjectShells = Effect.fn("http.orchestration.enrichProjectShells")(
+      (projects: ReadonlyArray<OrchestrationProjectShell>) =>
+        Effect.forEach(
+          projects,
+          (project) =>
+            // Use immediately available enrichment only. Awaiting git-backed
+            // identity resolution can exceed the client shell-snapshot budget
+            // (ProcessRunner allows probes up to one minute). Background workers
+            // plus the WS enrichment subscription fill in repositoryIdentity.
+            projectEnrichment.getAvailable(project.workspaceRoot).pipe(
+              Effect.map((enrichment) => ({
+                ...project,
+                repositoryIdentity: enrichment.repositoryIdentity,
+              })),
+            ),
+          { concurrency: 16 },
+        ),
+    );
+
+    const loadShellSnapshot = Effect.fn("http.orchestration.loadShellSnapshot")(function* () {
+      const base = yield* sql.withTransaction(
+        Effect.gen(function* () {
+          const projects = yield* projectionSnapshotQuery.getProjectShellsWithoutEnrichment();
+          const threads = yield* threadManagement.getShellSnapshot({ location: "active" });
+          return buildActiveShellSnapshot({
+            projects,
+            threads,
+            snapshotSequence: yield* applicationEvents.latestApplicationSequence,
+          });
+        }),
+      );
+      const projects = yield* enrichProjectShells(base.projects);
+      return { ...base, projects };
+    });
+
+    const loadThreadSnapshot = Effect.fn("http.orchestration.loadThreadSnapshot")(function* (
+      threadId: Parameters<typeof threadManagement.getThreadSnapshot>[0],
+      failureReason:
+        | "orchestration_thread_snapshot_failed"
+        | "orchestration_thread_bounded_snapshot_failed"
+        | "orchestration_thread_history_failed",
+    ) {
+      return yield* threadManagement.getThreadSnapshot(threadId).pipe(
+        Effect.map((snapshot) => ({
+          ...snapshot,
+          projection: projectThreadProjectionForWire(snapshot.projection),
+        })),
+        Effect.catch(
+          Effect.fnUntraced(function* (error) {
+            if (isThreadNotFound(error)) {
+              return yield* failEnvironmentNotFound("thread_not_found");
+            }
+            return yield* failEnvironmentInternal(failureReason, error);
+          }),
+        ),
+      );
+    });
+
+    const loadThreadSnapshotWindow = Effect.fn("http.orchestration.loadThreadSnapshotWindow")(
+      function* (
+        threadId: Parameters<typeof threadManagement.getThreadSnapshot>[0],
+        anchorItemId?: Parameters<
+          typeof threadManagement.getThreadSnapshotWindow
+        >[1]["anchorItemId"],
+        anchorThreadId?: Parameters<
+          typeof threadManagement.getThreadSnapshotWindow
+        >[1]["anchorThreadId"],
+      ) {
+        return yield* threadManagement
+          .getThreadSnapshotWindow(threadId, {
+            // The SQL anchor is inclusive. History paging excludes that row,
+            // then needs one more row to prove another page exists.
+            rowLimit: THREAD_HISTORY_PAGE_POLICY.maxItems + 2,
+            ...(anchorItemId === undefined ? {} : { anchorItemId }),
+            ...(anchorThreadId === undefined ? {} : { anchorThreadId }),
+          })
+          .pipe(
+            Effect.map((snapshot) => ({
+              ...snapshot,
+              projection: projectThreadProjectionForWire(snapshot.projection),
+            })),
+            Effect.catch(
+              Effect.fnUntraced(function* (error) {
+                if (isThreadNotFound(error)) {
+                  return yield* failEnvironmentNotFound("thread_not_found");
+                }
+                return yield* failEnvironmentInternal("orchestration_thread_history_failed", error);
+              }),
+            ),
+          );
+      },
+    );
+
+    return handlers
+      .handle(
+        "shellSnapshot",
+        Effect.fn("environment.orchestration.shellSnapshot")(function* (args) {
+          yield* annotateEnvironmentRequest(args.endpoint.name);
+          yield* requireEnvironmentScope(AuthOrchestrationReadScope);
+          return yield* loadShellSnapshot().pipe(
+            Effect.catch((cause) =>
+              failEnvironmentInternal("orchestration_snapshot_failed", cause),
+            ),
+          );
+        }),
+      )
+      .handle(
+        "threadSnapshot",
+        Effect.fn("environment.orchestration.threadSnapshot")(function* (args) {
+          yield* annotateEnvironmentRequest(args.endpoint.name);
+          yield* requireEnvironmentScope(AuthOrchestrationReadScope);
+          const snapshot = yield* loadThreadSnapshot(
+            args.params.threadId,
+            "orchestration_thread_snapshot_failed",
+          );
+          return {
+            snapshotSequence: snapshot.snapshotSequence,
+            projection: snapshot.projection,
+          };
+        }),
+      )
+      .handle(
+        "threadBoundedSnapshot",
+        Effect.fn("environment.orchestration.threadBoundedSnapshot")(function* (args) {
+          yield* annotateEnvironmentRequest(args.endpoint.name);
+          yield* requireEnvironmentScope(AuthOrchestrationReadScope);
+          const snapshot = yield* loadThreadSnapshotWindow(args.params.threadId);
+          const bounded = buildBoundedThreadProjection({
+            projection: snapshot.projection,
+            snapshotSequence: snapshot.snapshotSequence,
+          });
+          return {
+            snapshotSequence: snapshot.snapshotSequence,
+            projection: bounded.projection,
+            historyCursor: bounded.historyCursor,
+            hasMoreHistory: bounded.hasMoreHistory,
+            latestLocalTurnOrdinal: bounded.latestLocalTurnOrdinal,
+            payloadBudgetExceeded: bounded.payloadBudgetExceeded,
+          };
+        }),
+      )
+      .handle(
+        "threadHistoryPage",
+        Effect.fn("environment.orchestration.threadHistoryPage")(function* (args) {
+          yield* annotateEnvironmentRequest(args.endpoint.name);
+          yield* requireEnvironmentScope(AuthOrchestrationReadScope);
+          let anchorItemId;
+          try {
+            anchorItemId = TurnItemId.make(decodeThreadHistoryCursor(args.query.cursor).si);
+          } catch (cause) {
+            if (cause instanceof InvalidThreadHistoryCursorError) {
+              return yield* failEnvironmentInvalidRequest("invalid_history_cursor");
+            }
+            return yield* failEnvironmentInternal("orchestration_thread_history_failed", cause);
+          }
+          const decodedCursor = decodeThreadHistoryCursor(args.query.cursor);
+          const snapshot = yield* loadThreadSnapshotWindow(
+            args.params.threadId,
+            anchorItemId,
+            ThreadId.make(decodedCursor.st),
+          );
+          const pageOrError = selectHistoryPageFromCursorOrError({
+            items: snapshot.projection.visibleTurnItems,
+            cursor: args.query.cursor,
+            snapshotSequence: snapshot.snapshotSequence,
+          });
+          if (pageOrError._tag === "invalid_cursor") {
+            return yield* failEnvironmentInvalidRequest("invalid_history_cursor");
+          }
+          if (pageOrError._tag === "error") {
+            return yield* failEnvironmentInternal(
+              "orchestration_thread_history_failed",
+              pageOrError.cause,
+            );
+          }
+          return {
+            snapshotSequence: snapshot.snapshotSequence,
+            items: pageOrError.page.items,
+            nextCursor: pageOrError.page.nextCursor,
+            hasMoreHistory: pageOrError.page.hasMoreHistory,
+          };
+        }),
+      );
+  }),
+);
diff --git a/apps/server/src/orchestration-v2/runtimeLayer.test.ts b/apps/server/src/orchestration-v2/runtimeLayer.test.ts
new file mode 100644
index 000000000000..009b8dded789
--- /dev/null
+++ b/apps/server/src/orchestration-v2/runtimeLayer.test.ts
@@ -0,0 +1,1534 @@
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import { assert, it } from "@effect/vitest";
+import {
+  type ApplicationStoredEvent,
+  CommandId,
+  ContextTransferId,
+  EventId,
+  MessageId,
+  type ModelSelection,
+  ProjectId,
+  ProviderDriverKind,
+  ProviderInstanceId,
+  ProviderThreadId,
+  RunId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as DateTime from "effect/DateTime";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Queue from "effect/Queue";
+import * as Stream from "effect/Stream";
+import * as TestClock from "effect/testing/TestClock";
+import * as SqlClient from "effect/unstable/sql/SqlClient";
+
+import * as CheckpointStore from "../checkpointing/CheckpointStore.ts";
+import * as GitWorkflow from "../git/GitWorkflowService.ts";
+import { ServerConfig } from "../config.ts";
+import { OrchestrationEngineService } from "../orchestration/Services/OrchestrationEngine.ts";
+import { ProjectionSnapshotQuery } from "../orchestration/Services/ProjectionSnapshotQuery.ts";
+import { OrchestrationLayerLive } from "../orchestration/runtimeLayer.ts";
+import { SqlitePersistenceMemory } from "../persistence/Layers/Sqlite.ts";
+import { OrchestrationEventStore } from "../persistence/Services/OrchestrationEventStore.ts";
+import { ProjectEnrichmentService } from "../project/ProjectEnrichmentService.ts";
+import * as ProjectService from "../project/ProjectService.ts";
+import { ServerSettingsService } from "../serverSettings.ts";
+import { layer as mcpSessionRegistryTestLayer } from "../mcp/McpSessionRegistry.testkit.ts";
+import { ProviderInstanceRegistry } from "../provider/Services/ProviderInstanceRegistry.ts";
+import type { ProviderInstance } from "../provider/ProviderDriver.ts";
+import * as VcsDriverRegistry from "../vcs/VcsDriverRegistry.ts";
+import * as VcsProcess from "../vcs/VcsProcess.ts";
+import { LegacyV1ThreadImporter, LegacyV1ThreadImportError } from "./LegacyV1ThreadImporter.ts";
+import {
+  OrchestratorDispatchError,
+  OrchestratorProjectionError,
+  OrchestratorV2,
+} from "./Orchestrator.ts";
+import { OrchestrationEffectWorkerV2 } from "./EffectWorker.ts";
+import { EventSinkV2 } from "./EventSink.ts";
+import { ProjectionMaintenanceV2 } from "./ProjectionMaintenance.ts";
+import type { ProviderAdapterV2Shape } from "./ProviderAdapter.ts";
+import { OrchestrationV2EventSinkLayerLive, OrchestrationV2LayerLive } from "./runtimeLayer.ts";
+import { shellStreamItemFromThreadShell } from "./ShellStream.ts";
+import { CodexProviderCapabilitiesV2 } from "./Adapters/CodexAdapterV2.ts";
+import { ThreadManagementService } from "./ThreadManagementService.ts";
+
+const ServerConfigLayer = ServerConfig.layerTest(process.cwd(), {
+  prefix: "t3-orchestration-v2-runtime-layer-",
+});
+
+const modelSelection = {
+  instanceId: ProviderInstanceId.make("codex"),
+  model: "gpt-5.4",
+} satisfies ModelSelection;
+
+const VcsDriverRegistryTestLayer = VcsDriverRegistry.layer.pipe(
+  Layer.provide(VcsProcess.layer),
+  Layer.provide(ServerConfigLayer),
+  Layer.provide(NodeServices.layer),
+);
+
+const CheckpointStoreTestLayer = CheckpointStore.layer.pipe(
+  Layer.provide(VcsDriverRegistryTestLayer),
+);
+const GitWorkflowTestLayer = Layer.mock(GitWorkflow.GitWorkflowService)({
+  pruneWorktrees: () => Effect.void,
+  createWorktree: () => Effect.succeed({} as never),
+});
+const ProjectServiceTestLayer = Layer.mock(ProjectService.ProjectService)({
+  getById: () => Effect.succeed(Option.none()),
+});
+
+const driver = ProviderDriverKind.make("codex");
+const orchestrationAdapter = {
+  instanceId: modelSelection.instanceId,
+  driver,
+  getCapabilities: () => Effect.succeed(CodexProviderCapabilitiesV2),
+  planSelectionTransition: () => Effect.succeed({ type: "apply_on_next_turn" }),
+  openSession: () => Effect.die("sessions are not used by lifecycle tests"),
+} as ProviderAdapterV2Shape;
+const providerInstance = {
+  instanceId: modelSelection.instanceId,
+  driverKind: driver,
+  continuationIdentity: {
+    driverKind: driver,
+    continuationKey: "codex:test",
+  },
+  displayName: "Codex test",
+  enabled: true,
+  snapshot: {} as ProviderInstance["snapshot"],
+  orchestrationAdapter,
+  textGeneration: {} as ProviderInstance["textGeneration"],
+} satisfies ProviderInstance;
+
+const TestProviderInstanceRegistry = Layer.succeed(ProviderInstanceRegistry, {
+  getInstance: (instanceId) =>
+    Effect.succeed(instanceId === providerInstance.instanceId ? providerInstance : undefined),
+  listInstances: Effect.succeed([providerInstance]),
+  listUnavailable: Effect.succeed([]),
+  streamChanges: Stream.empty,
+  subscribeChanges: Effect.never,
+});
+
+const TestLayer = Layer.merge(OrchestrationV2LayerLive, OrchestrationV2EventSinkLayerLive).pipe(
+  Layer.provide(mcpSessionRegistryTestLayer),
+  Layer.provide(SqlitePersistenceMemory),
+  Layer.provide(CheckpointStoreTestLayer),
+  Layer.provide(ServerConfigLayer),
+  Layer.provide(ServerSettingsService.layerTest()),
+  Layer.provide(TestProviderInstanceRegistry),
+  Layer.provide(GitWorkflowTestLayer),
+  Layer.provide(ProjectServiceTestLayer),
+  Layer.provide(NodeServices.layer),
+);
+
+const LegacyImportTestLayer = OrchestrationV2LayerLive.pipe(
+  Layer.provide(mcpSessionRegistryTestLayer),
+  Layer.provideMerge(SqlitePersistenceMemory),
+  Layer.provide(CheckpointStoreTestLayer),
+  Layer.provide(ServerConfigLayer),
+  Layer.provide(ServerSettingsService.layerTest()),
+  Layer.provide(TestProviderInstanceRegistry),
+  Layer.provide(GitWorkflowTestLayer),
+  Layer.provide(ProjectServiceTestLayer),
+  Layer.provide(NodeServices.layer),
+);
+
+const SharedApplicationDataPlaneTestLayer = Layer.merge(
+  OrchestrationLayerLive,
+  OrchestrationV2LayerLive,
+).pipe(
+  Layer.provide(
+    Layer.succeed(ProjectEnrichmentService, {
+      peek: () =>
+        Effect.succeed({
+          repositoryIdentity: null,
+          faviconPath: null,
+          repositoryIdentityResolved: false,
+        }),
+      request: () => Effect.void,
+      getAvailable: () =>
+        Effect.succeed({
+          repositoryIdentity: null,
+          faviconPath: null,
+          repositoryIdentityResolved: false,
+        }),
+      invalidate: () => Effect.void,
+      subscribeChanges: Effect.never,
+    }),
+  ),
+  Layer.provide(mcpSessionRegistryTestLayer),
+  Layer.provideMerge(SqlitePersistenceMemory),
+  Layer.provide(CheckpointStoreTestLayer),
+  Layer.provide(ServerConfigLayer),
+  Layer.provide(ServerSettingsService.layerTest()),
+  Layer.provide(TestProviderInstanceRegistry),
+  Layer.provide(GitWorkflowTestLayer),
+  Layer.provide(ProjectServiceTestLayer),
+  Layer.provide(NodeServices.layer),
+);
+
+it.layer(TestLayer)("OrchestrationV2LayerLive", (it) => {
+  it.effect("creates and reads a thread through the production V2 composition", () =>
+    Effect.gen(function* () {
+      const orchestrator = yield* OrchestratorV2;
+      const threadId = ThreadId.make("runtime-layer-thread");
+      const projectId = ProjectId.make("runtime-layer-project");
+
+      const result = yield* orchestrator.dispatch({
+        type: "thread.create",
+        createdBy: "user",
+        creationSource: "web",
+        commandId: CommandId.make("runtime-layer-create"),
+        threadId,
+        projectId,
+        title: "Runtime layer thread",
+        modelSelection: modelSelection,
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        branch: null,
+        worktreePath: null,
+      });
+
+      const projection = yield* orchestrator.getThreadProjection(threadId);
+
+      assert.equal(result.sequence, 1);
+      assert.equal(projection.thread.id, threadId);
+      assert.equal(projection.thread.projectId, projectId);
+      assert.equal(projection.thread.providerInstanceId, "codex");
+      assert.deepEqual(projection.runs, []);
+    }),
+  );
+
+  it.effect("merges an explicit provider-finished run while checkpoint capture is pending", () =>
+    Effect.gen(function* () {
+      const orchestrator = yield* OrchestratorV2;
+      const eventSink = yield* EventSinkV2;
+      const now = yield* DateTime.now;
+      const projectId = ProjectId.make("runtime-layer-waiting-merge-project");
+      const targetThreadId = ThreadId.make("runtime-layer-waiting-merge-target");
+      const sourceThreadId = ThreadId.make("runtime-layer-waiting-merge-source");
+      const baseRunId = RunId.make("runtime-layer-waiting-merge-base-run");
+      const sourceRunId = RunId.make("runtime-layer-waiting-merge-source-run");
+      const sourceProviderThreadId = ProviderThreadId.make(
+        "runtime-layer-waiting-merge-provider-thread",
+      );
+      const forkTransferId = ContextTransferId.make("runtime-layer-waiting-merge-fork-transfer");
+
+      yield* orchestrator.dispatch({
+        type: "thread.create",
+        createdBy: "user",
+        creationSource: "web",
+        commandId: CommandId.make("runtime-layer-waiting-merge-create-target"),
+        threadId: targetThreadId,
+        projectId,
+        title: "Waiting merge target",
+        modelSelection,
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        branch: null,
+        worktreePath: null,
+      });
+      const target = yield* orchestrator.getThreadProjection(targetThreadId);
+
+      yield* eventSink.write({
+        commandId: CommandId.make("runtime-layer-waiting-merge-seed"),
+        events: [
+          {
+            id: EventId.make("runtime-layer-waiting-merge-source-thread-event"),
+            type: "thread.created",
+            threadId: sourceThreadId,
+            providerInstanceId: modelSelection.instanceId,
+            occurredAt: now,
+            payload: {
+              ...target.thread,
+              id: sourceThreadId,
+              title: "Waiting merge source",
+              activeProviderThreadId: null,
+              lineage: {
+                parentThreadId: targetThreadId,
+                relationshipToParent: "fork",
+                rootThreadId: targetThreadId,
+              },
+              forkedFrom: {
+                type: "run",
+                threadId: targetThreadId,
+                runId: baseRunId,
+              },
+              createdAt: now,
+              updatedAt: now,
+            },
+          },
+          {
+            id: EventId.make("runtime-layer-waiting-merge-fork-transfer-event"),
+            type: "context-transfer.created",
+            threadId: sourceThreadId,
+            providerInstanceId: modelSelection.instanceId,
+            occurredAt: now,
+            payload: {
+              id: forkTransferId,
+              type: "fork",
+              sourceThreadId: targetThreadId,
+              targetThreadId: sourceThreadId,
+              sourcePoint: { threadId: targetThreadId, runId: baseRunId },
+              basePoint: null,
+              sourceProviderInstanceId: modelSelection.instanceId,
+              targetProviderInstanceId: modelSelection.instanceId,
+              targetRunId: null,
+              status: "consumed",
+              resolution: null,
+              createdBy: "user",
+              error: null,
+              createdAt: now,
+              updatedAt: now,
+              consumedAt: now,
+            },
+          },
+          {
+            id: EventId.make("runtime-layer-waiting-merge-provider-thread-event"),
+            type: "provider-thread.updated",
+            threadId: sourceThreadId,
+            driver,
+            providerInstanceId: modelSelection.instanceId,
+            occurredAt: now,
+            payload: {
+              id: sourceProviderThreadId,
+              driver,
+              providerInstanceId: modelSelection.instanceId,
+              providerSessionId: null,
+              appThreadId: sourceThreadId,
+              ownerNodeId: null,
+              nativeThreadRef: {
+                driver,
+                nativeId: "native-waiting-merge-source",
+                strength: "strong",
+              },
+              nativeConversationHeadRef: null,
+              status: "idle",
+              firstRunOrdinal: 1,
+              lastRunOrdinal: 1,
+              handoffIds: [],
+              forkedFrom: null,
+              createdAt: now,
+              updatedAt: now,
+            },
+          },
+          {
+            id: EventId.make("runtime-layer-waiting-merge-source-run-event"),
+            type: "run.created",
+            threadId: sourceThreadId,
+            runId: sourceRunId,
+            providerInstanceId: modelSelection.instanceId,
+            occurredAt: now,
+            payload: {
+              id: sourceRunId,
+              threadId: sourceThreadId,
+              ordinal: 1,
+              providerInstanceId: modelSelection.instanceId,
+              modelSelection,
+              providerThreadId: sourceProviderThreadId,
+              userMessageId: MessageId.make("runtime-layer-waiting-merge-message"),
+              rootNodeId: null,
+              activeAttemptId: null,
+              status: "waiting",
+              queuePosition: null,
+              requestedAt: now,
+              startedAt: now,
+              completedAt: null,
+              checkpointId: null,
+              contextHandoffId: null,
+            },
+          },
+        ],
+      });
+
+      yield* orchestrator.dispatch({
+        type: "thread.merge_back",
+        createdBy: "user",
+        creationSource: "mobile",
+        commandId: CommandId.make("runtime-layer-waiting-merge"),
+        sourceThreadId,
+        targetThreadId,
+        sourcePoint: { type: "run", runId: sourceRunId },
+        createdAt: now,
+      });
+
+      const mergedTarget = yield* orchestrator.getThreadProjection(targetThreadId);
+      const transfer = mergedTarget.contextTransfers.find(
+        (candidate) => candidate.type === "merge_back",
+      );
+      assert.isDefined(transfer);
+      assert.equal(transfer.status, "pending");
+      assert.equal(transfer.sourceThreadId, sourceThreadId);
+      assert.equal(transfer.targetThreadId, targetThreadId);
+      assert.equal(transfer.sourcePoint.runId, sourceRunId);
+      assert.isUndefined(transfer.sourcePoint.checkpointId);
+      assert.equal(transfer.sourcePoint.providerThreadRef?.nativeId, "native-waiting-merge-source");
+      assert.equal(transfer.basePoint?.runId, baseRunId);
+      assert.isNull(transfer.error);
+    }),
+  );
+});
+
+it.layer(LegacyImportTestLayer)("OrchestrationV2 legacy import", (it) => {
+  it.effect("hydrates imported transcripts before commands and propagates hydration failures", () =>
+    Effect.gen(function* () {
+      const sql = yield* SqlClient.SqlClient;
+      const importer = yield* LegacyV1ThreadImporter;
+      const maintenance = yield* ProjectionMaintenanceV2;
+      const orchestrator = yield* OrchestratorV2;
+      const threadManagement = yield* ThreadManagementService;
+      const metadataThreadId = ThreadId.make("runtime-layer-legacy-metadata-thread");
+      const failureThreadId = ThreadId.make("runtime-layer-legacy-failure-thread");
+      const projectId = ProjectId.make("runtime-layer-legacy-project");
+
+      yield* sql`
+        INSERT INTO projection_projects (
+          project_id,
+          title,
+          workspace_root,
+          default_model_selection_json,
+          scripts_json,
+          created_at,
+          updated_at,
+          deleted_at
+        ) VALUES (
+          ${projectId},
+          'Legacy project',
+          '/tmp/runtime-layer-legacy-project',
+          '{"instanceId":"codex","model":"gpt-5.4"}',
+          '[]',
+          '2026-01-01T00:00:00.000Z',
+          '2026-01-04T00:00:00.000Z',
+          NULL
+        )
+      `;
+      yield* sql`
+        INSERT INTO projection_threads (
+          thread_id,
+          project_id,
+          title,
+          model_selection_json,
+          runtime_mode,
+          interaction_mode,
+          branch,
+          worktree_path,
+          latest_turn_id,
+          created_at,
+          updated_at,
+          archived_at,
+          settled_override,
+          settled_at,
+          deleted_at
+        ) VALUES
+          (
+            ${metadataThreadId},
+            ${projectId},
+            'Legacy metadata title',
+            '{"instanceId":"codex","model":"gpt-5.4"}',
+            'full-access',
+            'default',
+            'main',
+            '/tmp/runtime-layer-legacy-project',
+            NULL,
+            '2026-01-01T00:00:00.000Z',
+            '2026-01-04T00:00:00.000Z',
+            NULL,
+            NULL,
+            NULL,
+            NULL
+          ),
+          (
+            ${failureThreadId},
+            ${projectId},
+            'Legacy failure title',
+            '{"instanceId":"codex","model":"gpt-5.4"}',
+            'full-access',
+            'default',
+            'main',
+            '/tmp/runtime-layer-legacy-project',
+            NULL,
+            '2026-01-01T00:00:00.000Z',
+            '2026-01-04T00:00:00.000Z',
+            NULL,
+            NULL,
+            NULL,
+            NULL
+          )
+      `;
+      yield* sql`
+        INSERT INTO projection_thread_messages (
+          message_id,
+          thread_id,
+          turn_id,
+          role,
+          text,
+          attachments_json,
+          is_streaming,
+          created_at,
+          updated_at
+        ) VALUES
+          (
+            'message:runtime-layer-legacy:1',
+            ${metadataThreadId},
+            NULL,
+            'user',
+            'First imported question',
+            '[]',
+            0,
+            '2026-01-01T01:00:00.000Z',
+            '2026-01-01T01:00:00.000Z'
+          ),
+          (
+            'message:runtime-layer-legacy:2',
+            ${metadataThreadId},
+            NULL,
+            'assistant',
+            'First imported answer',
+            '[]',
+            0,
+            '2026-01-02T01:00:00.000Z',
+            '2026-01-02T01:00:00.000Z'
+          ),
+          (
+            'message:runtime-layer-legacy:3',
+            ${metadataThreadId},
+            NULL,
+            'user',
+            'Latest imported question',
+            '[]',
+            0,
+            '2026-01-03T01:00:00.000Z',
+            '2026-01-03T01:00:00.000Z'
+          ),
+          (
+            'message:runtime-layer-legacy:failure',
+            ${failureThreadId},
+            NULL,
+            'user',
+            'Imported context must load before archive',
+            '[]',
+            0,
+            '2026-01-03T01:00:00.000Z',
+            '2026-01-03T01:00:00.000Z'
+          )
+      `;
+
+      yield* importer.reconcileShells;
+      const rebuilt = yield* maintenance.rebuild;
+      assert.isTrue(rebuilt.valid);
+
+      yield* threadManagement.dispatch({
+        type: "thread.metadata.update",
+        commandId: CommandId.make("runtime-layer-legacy-metadata-update"),
+        threadId: metadataThreadId,
+        title: "Updated after import",
+      });
+      const updatedProjection = yield* threadManagement.getThreadProjection(metadataThreadId);
+      assert.equal(updatedProjection.thread.title, "Updated after import");
+      assert.deepEqual(
+        updatedProjection.messages.map((message) => message.text),
+        ["First imported question", "First imported answer", "Latest imported question"],
+      );
+
+      yield* sql`
+        ALTER TABLE projection_thread_messages
+        RENAME TO projection_thread_messages_unavailable
+      `;
+      const { projectionFailure, hydrationFailure } = yield* Effect.all({
+        projectionFailure: threadManagement.getThreadProjection(failureThreadId).pipe(Effect.flip),
+        hydrationFailure: threadManagement
+          .dispatch({
+            type: "thread.archive",
+            commandId: CommandId.make("runtime-layer-legacy-failed-archive"),
+            threadId: failureThreadId,
+          })
+          .pipe(Effect.flip),
+      }).pipe(
+        Effect.ensuring(
+          sql`
+            ALTER TABLE projection_thread_messages_unavailable
+            RENAME TO projection_thread_messages
+          `.pipe(Effect.orDie),
+        ),
+      );
+      assert.instanceOf(projectionFailure, OrchestratorProjectionError);
+      assert.instanceOf(projectionFailure.cause, LegacyV1ThreadImportError);
+      assert.instanceOf(hydrationFailure, OrchestratorDispatchError);
+      assert.instanceOf(hydrationFailure.cause, LegacyV1ThreadImportError);
+
+      const projectionAfterFailure = yield* orchestrator.getThreadProjection(failureThreadId);
+      assert.isNull(projectionAfterFailure.thread.archivedAt);
+
+      yield* threadManagement.dispatch({
+        type: "thread.archive",
+        commandId: CommandId.make("runtime-layer-legacy-retried-archive"),
+        threadId: failureThreadId,
+      });
+      const projectionAfterRetry = yield* threadManagement.getThreadProjection(failureThreadId);
+      assert.isNotNull(projectionAfterRetry.thread.archivedAt);
+    }),
+  );
+});
+
+it.layer(TestLayer)("OrchestrationV2LayerLive lifecycle", (it) => {
+  it.effect("applies lifecycle commands idempotently and emits archive/removal shell deltas", () =>
+    Effect.gen(function* () {
+      const orchestrator = yield* OrchestratorV2;
+      const threadId = ThreadId.make("runtime-layer-lifecycle-thread");
+      const create = {
+        type: "thread.create" as const,
+        createdBy: "user" as const,
+        creationSource: "web" as const,
+        commandId: CommandId.make("runtime-layer-lifecycle-create"),
+        threadId,
+        projectId: ProjectId.make("runtime-layer-lifecycle-project"),
+        title: "Lifecycle thread",
+        modelSelection,
+        runtimeMode: "full-access" as const,
+        interactionMode: "default" as const,
+        branch: null,
+        worktreePath: null,
+      };
+
+      const firstCreate = yield* orchestrator.dispatch(create);
+      const retriedCreate = yield* orchestrator.dispatch(create);
+      assert.equal(retriedCreate.sequence, firstCreate.sequence);
+      assert.lengthOf(retriedCreate.storedEvents, 1);
+
+      yield* orchestrator.dispatch({
+        type: "thread.metadata.update",
+        commandId: CommandId.make("runtime-layer-lifecycle-metadata"),
+        threadId,
+        title: "Renamed lifecycle thread",
+        branch: "feature/v2",
+        worktreePath: "/tmp/t3-v2-worktree",
+      });
+      const staleWorkspaceUpdate = yield* orchestrator
+        .dispatch({
+          type: "thread.metadata.update",
+          commandId: CommandId.make("runtime-layer-lifecycle-stale-workspace"),
+          threadId,
+          branch: "feature/stale",
+          worktreePath: "/tmp/stale-worktree",
+          expectedWorktreePath: null,
+        })
+        .pipe(Effect.flip);
+      assert.instanceOf(staleWorkspaceUpdate, OrchestratorDispatchError);
+      const projectionAfterStaleWorkspaceUpdate = yield* orchestrator.getThreadProjection(threadId);
+      assert.equal(projectionAfterStaleWorkspaceUpdate.thread.branch, "feature/v2");
+      assert.equal(projectionAfterStaleWorkspaceUpdate.thread.worktreePath, "/tmp/t3-v2-worktree");
+      yield* orchestrator.dispatch({
+        type: "thread.runtime-mode.set",
+        commandId: CommandId.make("runtime-layer-lifecycle-runtime"),
+        threadId,
+        runtimeMode: "approval-required",
+      });
+      yield* orchestrator.dispatch({
+        type: "thread.interaction-mode.set",
+        commandId: CommandId.make("runtime-layer-lifecycle-interaction"),
+        threadId,
+        interactionMode: "plan",
+      });
+      yield* orchestrator.dispatch({
+        type: "thread.model-selection.set",
+        commandId: CommandId.make("runtime-layer-lifecycle-model"),
+        threadId,
+        modelSelection: { ...modelSelection, model: "gpt-5.5" },
+      });
+
+      yield* orchestrator.dispatch({
+        type: "thread.settle",
+        commandId: CommandId.make("runtime-layer-lifecycle-settle"),
+        threadId,
+      });
+      const settledProjection = yield* orchestrator.getThreadProjection(threadId);
+      assert.equal(settledProjection.thread.settledOverride, "settled");
+      assert.isNotNull(settledProjection.thread.settledAt);
+
+      yield* orchestrator.dispatch({
+        type: "thread.unsettle",
+        commandId: CommandId.make("runtime-layer-lifecycle-unsettle"),
+        threadId,
+        reason: "user",
+      });
+      const activeProjection = yield* orchestrator.getThreadProjection(threadId);
+      assert.equal(activeProjection.thread.settledOverride, "active");
+      assert.isNull(activeProjection.thread.settledAt);
+      assert.isNotNull(activeProjection.thread.unsettledAt);
+      const activeShell = (yield* orchestrator.getShellSnapshot()).threads.find(
+        (thread) => thread.id === threadId,
+      );
+      assert.deepEqual(activeShell?.unsettledAt, activeProjection.thread.unsettledAt);
+
+      const archive = yield* orchestrator.dispatch({
+        type: "thread.archive",
+        commandId: CommandId.make("runtime-layer-lifecycle-archive"),
+        threadId,
+      });
+      const archivedShell = yield* orchestrator.getShellSnapshot();
+      assert.notInclude(
+        archivedShell.threads.map((thread) => thread.id),
+        threadId,
+      );
+      assert.include(
+        archivedShell.archivedThreads.map((thread) => thread.id),
+        threadId,
+      );
+      const activeOnlyShell = yield* orchestrator.getShellSnapshot({ location: "active" });
+      assert.notInclude(
+        activeOnlyShell.threads.map((thread) => thread.id),
+        threadId,
+      );
+      assert.lengthOf(activeOnlyShell.archivedThreads, 0);
+      const archiveOnlyShell = yield* orchestrator.getShellSnapshot({ location: "archive" });
+      assert.lengthOf(archiveOnlyShell.threads, 0);
+      assert.include(
+        archiveOnlyShell.archivedThreads.map((thread) => thread.id),
+        threadId,
+      );
+      assert.deepEqual(
+        shellStreamItemFromThreadShell({
+          stored: archive.storedEvents[0]!,
+          shell: yield* orchestrator.getThreadShell(threadId),
+        }),
+        {
+          kind: "thread.removed",
+          sequence: archive.sequence,
+          location: "active",
+          threadId,
+        },
+      );
+
+      const remove = yield* orchestrator.dispatch({
+        type: "thread.delete",
+        commandId: CommandId.make("runtime-layer-lifecycle-delete"),
+        threadId,
+      });
+      const deletedShell = yield* orchestrator.getShellSnapshot();
+      assert.notInclude(
+        deletedShell.threads.map((thread) => thread.id),
+        threadId,
+      );
+      assert.notInclude(
+        deletedShell.archivedThreads.map((thread) => thread.id),
+        threadId,
+      );
+      assert.deepEqual(
+        shellStreamItemFromThreadShell({
+          stored: remove.storedEvents[0]!,
+          shell: yield* orchestrator.getThreadShell(threadId),
+        }),
+        {
+          kind: "thread.removed",
+          sequence: remove.sequence,
+          location: "active",
+          threadId,
+        },
+      );
+
+      const projection = yield* orchestrator.getThreadProjection(threadId);
+      assert.equal(projection.thread.title, "Renamed lifecycle thread");
+      assert.equal(projection.thread.branch, "feature/v2");
+      assert.equal(projection.thread.worktreePath, "/tmp/t3-v2-worktree");
+      assert.equal(projection.thread.runtimeMode, "approval-required");
+      assert.equal(projection.thread.interactionMode, "plan");
+      assert.equal(projection.thread.modelSelection.model, "gpt-5.5");
+      assert.isNotNull(projection.thread.archivedAt);
+      assert.isNotNull(projection.thread.deletedAt);
+    }),
+  );
+
+  it.effect("persists rejected command receipts across retries", () =>
+    Effect.gen(function* () {
+      const orchestrator = yield* OrchestratorV2;
+      const command = {
+        type: "thread.archive" as const,
+        commandId: CommandId.make("runtime-layer-rejected-command"),
+        threadId: ThreadId.make("runtime-layer-missing-thread"),
+      };
+
+      const first = yield* orchestrator.dispatch(command).pipe(Effect.flip);
+      const retry = yield* orchestrator.dispatch(command).pipe(Effect.flip);
+
+      assert.equal(first._tag, "OrchestratorProjectionError");
+      assert.equal(retry._tag, "OrchestratorCommandPreviouslyRejectedError");
+    }),
+  );
+
+  it.effect("rejects settling a thread while a run is active", () =>
+    Effect.gen(function* () {
+      const orchestrator = yield* OrchestratorV2;
+      const threadId = ThreadId.make("runtime-layer-active-settle-thread");
+
+      yield* orchestrator.dispatch({
+        type: "thread.create",
+        createdBy: "user",
+        creationSource: "web",
+        commandId: CommandId.make("runtime-layer-active-settle-create"),
+        threadId,
+        projectId: ProjectId.make("runtime-layer-active-settle-project"),
+        title: "Active settle",
+        modelSelection,
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        branch: null,
+        worktreePath: "/tmp/runtime-layer-active-settle",
+      });
+      yield* orchestrator.dispatch({
+        type: "thread.settle",
+        commandId: CommandId.make("runtime-layer-active-settle-initial"),
+        threadId,
+      });
+      yield* orchestrator.dispatch({
+        type: "message.dispatch",
+        createdBy: "user",
+        creationSource: "web",
+        commandId: CommandId.make("runtime-layer-active-settle-message"),
+        threadId,
+        messageId: MessageId.make("runtime-layer-active-settle-message"),
+        text: "Keep this run active.",
+        attachments: [],
+        modelSelection,
+        dispatchMode: { type: "start_immediately" },
+      });
+
+      const error = yield* orchestrator
+        .dispatch({
+          type: "thread.settle",
+          commandId: CommandId.make("runtime-layer-active-settle"),
+          threadId,
+        })
+        .pipe(Effect.flip);
+
+      assert.equal(error._tag, "OrchestratorDispatchError");
+      const projection = yield* orchestrator.getThreadProjection(threadId);
+      assert.equal(projection.runs[0]?.status, "starting");
+      assert.isNull(projection.thread.settledOverride);
+      assert.isNull(projection.thread.settledAt);
+      assert.isNotNull(projection.thread.unsettledAt);
+    }),
+  );
+
+  it.effect("cancels queued work when a thread is archived", () =>
+    Effect.gen(function* () {
+      const orchestrator = yield* OrchestratorV2;
+      const threadId = ThreadId.make("runtime-layer-archive-queued-thread");
+
+      yield* orchestrator.dispatch({
+        type: "thread.create",
+        createdBy: "user",
+        creationSource: "web",
+        commandId: CommandId.make("runtime-layer-archive-queued-create"),
+        threadId,
+        projectId: ProjectId.make("runtime-layer-archive-queued-project"),
+        title: "Archive queued work",
+        modelSelection,
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        branch: null,
+        worktreePath: "/tmp/runtime-layer-archive-queued",
+      });
+      yield* orchestrator.dispatch({
+        type: "message.dispatch",
+        createdBy: "user",
+        creationSource: "web",
+        commandId: CommandId.make("runtime-layer-archive-queued-active-message"),
+        threadId,
+        messageId: MessageId.make("runtime-layer-archive-queued-active-message"),
+        text: "Keep the provider occupied.",
+        attachments: [],
+        modelSelection,
+        dispatchMode: { type: "start_immediately" },
+      });
+      yield* orchestrator.dispatch({
+        type: "message.dispatch",
+        createdBy: "user",
+        creationSource: "web",
+        commandId: CommandId.make("runtime-layer-archive-queued-next-message"),
+        threadId,
+        messageId: MessageId.make("runtime-layer-archive-queued-next-message"),
+        text: "Do not run this after archive.",
+        attachments: [],
+        modelSelection,
+        dispatchMode: { type: "queue_after_active" },
+      });
+
+      const beforeArchive = yield* orchestrator.getThreadProjection(threadId);
+      const activeRun = beforeArchive.runs.find((run) => run.status === "starting");
+      const queuedRun = beforeArchive.runs.find((run) => run.status === "queued");
+      assert.isDefined(activeRun);
+      assert.isDefined(queuedRun);
+
+      yield* orchestrator.dispatch({
+        type: "thread.archive",
+        commandId: CommandId.make("runtime-layer-archive-queued-archive"),
+        threadId,
+      });
+
+      const archived = yield* orchestrator.getThreadProjection(threadId);
+      assert.isNotNull(archived.thread.archivedAt);
+      assert.equal(archived.runs.find((run) => run.id === queuedRun.id)?.status, "cancelled");
+      assert.equal(
+        archived.attempts.find((attempt) => attempt.runId === queuedRun.id)?.status,
+        "cancelled",
+      );
+      assert.equal(archived.nodes.find((node) => node.runId === queuedRun.id)?.status, "cancelled");
+      assert.equal(yield* orchestrator.resumeQueuedRuns, 0);
+
+      const promoteError = yield* orchestrator
+        .dispatch({
+          type: "queued-message.promote-to-steer",
+          commandId: CommandId.make("runtime-layer-archive-queued-promote"),
+          threadId,
+          queuedRunId: queuedRun.id,
+          targetRunId: activeRun.id,
+        })
+        .pipe(Effect.flip);
+      assert.equal(promoteError._tag, "OrchestratorDispatchError");
+
+      const afterPromotion = yield* orchestrator.getThreadProjection(threadId);
+      assert.equal(afterPromotion.runs.find((run) => run.id === queuedRun.id)?.status, "cancelled");
+    }),
+  );
+
+  it.effect("promotes only one queued run after each terminal run", () =>
+    Effect.gen(function* () {
+      const orchestrator = yield* OrchestratorV2;
+      const eventSink = yield* EventSinkV2;
+      const threadId = ThreadId.make("runtime-layer-serialized-queue-thread");
+
+      yield* orchestrator.dispatch({
+        type: "thread.create",
+        createdBy: "user",
+        creationSource: "web",
+        commandId: CommandId.make("runtime-layer-serialized-queue-create"),
+        threadId,
+        projectId: ProjectId.make("runtime-layer-serialized-queue-project"),
+        title: "Serialized queue",
+        modelSelection,
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        branch: null,
+        worktreePath: process.cwd(),
+      });
+      yield* orchestrator.dispatch({
+        type: "message.dispatch",
+        createdBy: "user",
+        creationSource: "web",
+        commandId: CommandId.make("runtime-layer-serialized-queue-active"),
+        threadId,
+        messageId: MessageId.make("runtime-layer-serialized-queue-active"),
+        text: "Active",
+        attachments: [],
+        modelSelection,
+        dispatchMode: { type: "start_immediately" },
+      });
+      yield* orchestrator.dispatch({
+        type: "message.dispatch",
+        createdBy: "user",
+        creationSource: "web",
+        commandId: CommandId.make("runtime-layer-serialized-queue-first"),
+        threadId,
+        messageId: MessageId.make("runtime-layer-serialized-queue-first"),
+        text: "First queued",
+        attachments: [],
+        modelSelection,
+        dispatchMode: { type: "queue_after_active" },
+      });
+      yield* orchestrator.dispatch({
+        type: "message.dispatch",
+        createdBy: "user",
+        creationSource: "web",
+        commandId: CommandId.make("runtime-layer-serialized-queue-second"),
+        threadId,
+        messageId: MessageId.make("runtime-layer-serialized-queue-second"),
+        text: "Second queued",
+        attachments: [],
+        modelSelection,
+        dispatchMode: { type: "queue_after_active" },
+      });
+
+      const before = yield* orchestrator.getThreadProjection(threadId);
+      const activeRun = before.runs.find((run) => run.status === "starting");
+      const queuedRuns = before.runs
+        .filter((run) => run.status === "queued")
+        .toSorted((left, right) => left.ordinal - right.ordinal);
+      const firstQueuedRun = queuedRuns[0];
+      const secondQueuedRun = queuedRuns[1];
+      assert.isDefined(activeRun);
+      assert.isDefined(firstQueuedRun);
+      assert.isDefined(secondQueuedRun);
+      assert.isFalse(
+        before.turnItems.some(
+          (item) =>
+            item.type === "user_message" &&
+            (item.messageId === firstQueuedRun.userMessageId ||
+              item.messageId === secondQueuedRun.userMessageId),
+        ),
+        "queued messages must not exist as turn items before dispatch",
+      );
+
+      const promotedRunIds = yield* Queue.unbounded<RunId>();
+      const afterSequence = yield* orchestrator.getThreadEventSequence(threadId);
+      yield* eventSink.stream({ threadId, afterSequence }).pipe(
+        Stream.runForEach((stored) =>
+          stored.event.type === "run.updated" && stored.event.payload.status === "starting"
+            ? Queue.offer(promotedRunIds, stored.event.payload.id)
+            : Effect.void,
+        ),
+        Effect.forkScoped,
+      );
+      yield* Effect.yieldNow;
+
+      const activeCompletedAt = yield* DateTime.now;
+      yield* eventSink.write({
+        events: [
+          {
+            id: EventId.make("runtime-layer-serialized-queue-active-completed"),
+            type: "run.updated",
+            threadId,
+            runId: activeRun.id,
+            ...(activeRun.rootNodeId === null ? {} : { nodeId: activeRun.rootNodeId }),
+            providerInstanceId: activeRun.providerInstanceId,
+            occurredAt: activeCompletedAt,
+            payload: {
+              ...activeRun,
+              status: "completed",
+              completedAt: activeCompletedAt,
+            },
+          },
+        ],
+      });
+
+      assert.equal(yield* Queue.take(promotedRunIds), firstQueuedRun.id);
+      const afterFirstPromotion = yield* orchestrator.getThreadProjection(threadId);
+      assert.equal(
+        afterFirstPromotion.runs.find((run) => run.id === firstQueuedRun.id)?.status,
+        "starting",
+      );
+      assert.equal(
+        afterFirstPromotion.runs.find((run) => run.id === secondQueuedRun.id)?.status,
+        "queued",
+      );
+      const promotedMessageItem = afterFirstPromotion.turnItems.find(
+        (item) => item.type === "user_message" && item.messageId === firstQueuedRun.userMessageId,
+      );
+      assert.isDefined(promotedMessageItem);
+      if (promotedMessageItem.type !== "user_message") {
+        assert.fail("promoted queue item must be a user message");
+      }
+      assert.equal(promotedMessageItem.inputIntent, "queued_turn");
+      assert.isTrue(
+        promotedMessageItem.startedAt !== null &&
+          DateTime.toEpochMillis(promotedMessageItem.startedAt) >=
+            DateTime.toEpochMillis(activeCompletedAt),
+      );
+
+      const promotedFirst = afterFirstPromotion.runs.find((run) => run.id === firstQueuedRun.id);
+      assert.isDefined(promotedFirst);
+      const firstCompletedAt = yield* DateTime.now;
+      yield* eventSink.write({
+        events: [
+          {
+            id: EventId.make("runtime-layer-serialized-queue-first-completed"),
+            type: "run.updated",
+            threadId,
+            runId: promotedFirst.id,
+            ...(promotedFirst.rootNodeId === null ? {} : { nodeId: promotedFirst.rootNodeId }),
+            providerInstanceId: promotedFirst.providerInstanceId,
+            occurredAt: firstCompletedAt,
+            payload: {
+              ...promotedFirst,
+              status: "completed",
+              completedAt: firstCompletedAt,
+            },
+          },
+        ],
+      });
+
+      assert.equal(yield* Queue.take(promotedRunIds), secondQueuedRun.id);
+      const afterSecondPromotion = yield* orchestrator.getThreadProjection(threadId);
+      assert.equal(
+        afterSecondPromotion.runs.find((run) => run.id === firstQueuedRun.id)?.status,
+        "completed",
+      );
+      assert.equal(
+        afterSecondPromotion.runs.find((run) => run.id === secondQueuedRun.id)?.status,
+        "starting",
+      );
+    }),
+  );
+
+  it.effect("edits and removes queued runs", () =>
+    Effect.gen(function* () {
+      const orchestrator = yield* OrchestratorV2;
+      const threadId = ThreadId.make("runtime-layer-queued-edit-thread");
+
+      yield* orchestrator.dispatch({
+        type: "thread.create",
+        createdBy: "user",
+        creationSource: "web",
+        commandId: CommandId.make("runtime-layer-queued-edit-create"),
+        threadId,
+        projectId: ProjectId.make("runtime-layer-queued-edit-project"),
+        title: "Edit queued work",
+        modelSelection,
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        branch: null,
+        worktreePath: "/tmp/runtime-layer-queued-edit",
+      });
+      yield* orchestrator.dispatch({
+        type: "message.dispatch",
+        createdBy: "user",
+        creationSource: "web",
+        commandId: CommandId.make("runtime-layer-queued-edit-active-message"),
+        threadId,
+        messageId: MessageId.make("runtime-layer-queued-edit-active-message"),
+        text: "Keep the provider occupied.",
+        attachments: [],
+        modelSelection,
+        dispatchMode: { type: "start_immediately" },
+      });
+      yield* orchestrator.dispatch({
+        type: "message.dispatch",
+        createdBy: "user",
+        creationSource: "web",
+        commandId: CommandId.make("runtime-layer-queued-edit-queued-message"),
+        threadId,
+        messageId: MessageId.make("runtime-layer-queued-edit-queued-message"),
+        text: "Original queued text.",
+        attachments: [],
+        modelSelection,
+        dispatchMode: { type: "queue_after_active" },
+      });
+
+      const before = yield* orchestrator.getThreadProjection(threadId);
+      const queuedRun = before.runs.find((run) => run.status === "queued");
+      assert.isDefined(queuedRun);
+
+      yield* orchestrator.dispatch({
+        type: "queued-run.edit",
+        commandId: CommandId.make("runtime-layer-queued-edit-edit"),
+        threadId,
+        runId: queuedRun.id,
+        text: "Updated queued text.",
+      });
+
+      const afterEdit = yield* orchestrator.getThreadProjection(threadId);
+      assert.equal(
+        afterEdit.messages.find((message) => message.id === queuedRun.userMessageId)?.text,
+        "Updated queued text.",
+      );
+      const editedItem = afterEdit.turnItems.find(
+        (item) => item.type === "user_message" && item.messageId === queuedRun.userMessageId,
+      );
+      assert.isUndefined(editedItem, "editing queue state must not create a timeline turn item");
+
+      yield* orchestrator.dispatch({
+        type: "queued-run.edit",
+        commandId: CommandId.make("runtime-layer-queued-edit-attachments"),
+        threadId,
+        runId: queuedRun.id,
+        text: "Updated queued text with an attachment.",
+        attachments: [
+          {
+            type: "image",
+            id: "runtime-layer-queued-edit-attachment",
+            name: "screenshot.png",
+            mimeType: "image/png",
+            sizeBytes: 128,
+          },
+        ],
+      });
+      const afterAttachmentEdit = yield* orchestrator.getThreadProjection(threadId);
+      assert.deepEqual(
+        afterAttachmentEdit.messages
+          .find((message) => message.id === queuedRun.userMessageId)
+          ?.attachments.map((attachment) => attachment.id),
+        ["runtime-layer-queued-edit-attachment"],
+      );
+
+      yield* orchestrator.dispatch({
+        type: "queued-run.edit",
+        commandId: CommandId.make("runtime-layer-queued-edit-text-only"),
+        threadId,
+        runId: queuedRun.id,
+        text: "Text-only edit keeps attachments.",
+      });
+      const afterTextOnlyEdit = yield* orchestrator.getThreadProjection(threadId);
+      assert.deepEqual(
+        afterTextOnlyEdit.messages
+          .find((message) => message.id === queuedRun.userMessageId)
+          ?.attachments.map((attachment) => attachment.id),
+        ["runtime-layer-queued-edit-attachment"],
+        "an edit without attachments must leave the stored attachments untouched",
+      );
+
+      const emptyEditError = yield* orchestrator
+        .dispatch({
+          type: "queued-run.edit",
+          commandId: CommandId.make("runtime-layer-queued-edit-empty"),
+          threadId,
+          runId: queuedRun.id,
+          text: "   ",
+        })
+        .pipe(Effect.flip);
+      assert.equal(emptyEditError._tag, "OrchestratorDispatchError");
+
+      yield* orchestrator.dispatch({
+        type: "queued-run.cancel",
+        commandId: CommandId.make("runtime-layer-queued-edit-cancel"),
+        threadId,
+        runId: queuedRun.id,
+      });
+
+      const afterCancel = yield* orchestrator.getThreadProjection(threadId);
+      assert.equal(afterCancel.runs.find((run) => run.id === queuedRun.id)?.status, "cancelled");
+      assert.equal(
+        afterCancel.attempts.find((attempt) => attempt.runId === queuedRun.id)?.status,
+        "cancelled",
+      );
+      assert.equal(
+        afterCancel.nodes.find((node) => node.runId === queuedRun.id)?.status,
+        "cancelled",
+      );
+      assert.isFalse(
+        afterCancel.visibleTurnItems.some(
+          (row) => row.item.type === "user_message" && row.item.runId === queuedRun.id,
+        ),
+        "removed queued message must not surface as a transcript row",
+      );
+      assert.equal(yield* orchestrator.resumeQueuedRuns, 0);
+
+      const cancelAgainError = yield* orchestrator
+        .dispatch({
+          type: "queued-run.cancel",
+          commandId: CommandId.make("runtime-layer-queued-edit-cancel-again"),
+          threadId,
+          runId: queuedRun.id,
+        })
+        .pipe(Effect.flip);
+      assert.equal(cancelAgainError._tag, "OrchestratorDispatchError");
+    }),
+  );
+});
+
+it.layer(SharedApplicationDataPlaneTestLayer)("pending provider interruption", (it) => {
+  it.effect("interrupts a pending provider start without launching provider work", () =>
+    Effect.gen(function* () {
+      const applicationEngine = yield* OrchestrationEngineService;
+      const orchestrator = yield* OrchestratorV2;
+      const threadManagement = yield* ThreadManagementService;
+      const effectWorker = yield* OrchestrationEffectWorkerV2;
+      const projectId = ProjectId.make("runtime-layer-pending-interrupt-project");
+      const threadId = ThreadId.make("runtime-layer-pending-interrupt-thread");
+
+      yield* applicationEngine.dispatch({
+        type: "project.create",
+        commandId: CommandId.make("runtime-layer-pending-interrupt-project-create"),
+        projectId,
+        title: "Pending interrupt project",
+        workspaceRoot: "/tmp/runtime-layer-pending-interrupt-project",
+        defaultModelSelection: modelSelection,
+        scripts: [],
+        createdAt: "2026-06-22T00:00:00.000Z",
+      });
+      yield* orchestrator.dispatch({
+        type: "thread.create",
+        createdBy: "user",
+        creationSource: "web",
+        commandId: CommandId.make("runtime-layer-pending-interrupt-create"),
+        threadId,
+        projectId,
+        title: "Pending interrupt",
+        modelSelection,
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        branch: null,
+        worktreePath: null,
+      });
+      yield* orchestrator.dispatch({
+        type: "message.dispatch",
+        createdBy: "user",
+        creationSource: "web",
+        commandId: CommandId.make("runtime-layer-pending-interrupt-message"),
+        threadId,
+        messageId: MessageId.make("runtime-layer-pending-interrupt-message"),
+        text: "Do not reach the provider.",
+        attachments: [],
+        modelSelection,
+        dispatchMode: { type: "start_immediately" },
+      });
+
+      const starting = yield* orchestrator.getThreadProjection(threadId);
+      const run = starting.runs[0];
+      assert.isDefined(run);
+      assert.equal(run.status, "starting");
+
+      const interrupt = yield* threadManagement.interruptThread({
+        projectId,
+        commandId: CommandId.make("runtime-layer-pending-interrupt-command"),
+        threadId,
+        runId: run.id,
+        reason: "Cancelled before provider start",
+      });
+      assert.equal(interrupt.type, "interrupt_requested");
+
+      const interrupted = yield* orchestrator.getThreadProjection(threadId);
+      assert.equal(interrupted.runs[0]?.status, "interrupted");
+      assert.equal(interrupted.attempts[0]?.status, "interrupted");
+      assert.equal(
+        interrupted.nodes.find((node) => node.kind === "root_turn")?.status,
+        "interrupted",
+      );
+      assert.deepEqual(
+        interrupted.turnItems.filter((item) => item.runId === run.id).map((item) => item.type),
+        ["user_message", "run_interrupt_request", "run_interrupt_result"],
+      );
+      assert.deepEqual(interrupted.providerTurns, []);
+      assert.isFalse(yield* effectWorker.runOnce);
+    }),
+  );
+});
+
+it.layer(SharedApplicationDataPlaneTestLayer)("snooze projection", (it) => {
+  it.effect("carries snooze state through the V2 shell projection", () =>
+    Effect.gen(function* () {
+      const applicationEngine = yield* OrchestrationEngineService;
+      const orchestrator = yield* OrchestratorV2;
+      const projectId = ProjectId.make("runtime-layer-snoozed-project");
+      const threadId = ThreadId.make("runtime-layer-snoozed-thread");
+      const snoozedUntil = "2099-07-25T09:00:00.000Z";
+
+      yield* applicationEngine.dispatch({
+        type: "project.create",
+        commandId: CommandId.make("runtime-layer-snoozed-project-create"),
+        projectId,
+        title: "Snoozed shell projection",
+        workspaceRoot: "/tmp/runtime-layer-snoozed-project",
+        defaultModelSelection: modelSelection,
+        scripts: [],
+        createdAt: "2026-07-24T00:00:00.000Z",
+      });
+      yield* orchestrator.dispatch({
+        type: "thread.create",
+        createdBy: "user",
+        creationSource: "web",
+        commandId: CommandId.make("runtime-layer-snoozed-thread-create"),
+        threadId,
+        projectId,
+        title: "Snoozed thread",
+        modelSelection,
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        branch: null,
+        worktreePath: null,
+      });
+      yield* orchestrator.dispatch({
+        type: "thread.snooze",
+        commandId: CommandId.make("runtime-layer-snoozed-thread-snooze"),
+        threadId,
+        snoozedUntil,
+      });
+
+      const firstProjection = yield* orchestrator.getThreadProjection(threadId);
+      const firstSnoozedAt = firstProjection.thread.snoozedAt;
+      const firstUpdatedAt = firstProjection.thread.updatedAt;
+      assert.isNotNull(firstSnoozedAt);
+
+      yield* orchestrator.dispatch({
+        type: "thread.snooze",
+        commandId: CommandId.make("runtime-layer-snoozed-thread-snooze-again"),
+        threadId,
+        snoozedUntil,
+      });
+
+      const shell = yield* orchestrator.getShellSnapshot();
+      const thread = shell.threads.find((candidate) => candidate.id === threadId);
+      assert.isDefined(thread);
+      assert.equal(DateTime.formatIso(thread.snoozedUntil!), snoozedUntil);
+      assert.deepEqual(thread.snoozedAt, firstSnoozedAt);
+      assert.deepEqual(thread.updatedAt, firstUpdatedAt);
+
+      yield* orchestrator.dispatch({
+        type: "message.dispatch",
+        createdBy: "user",
+        creationSource: "web",
+        commandId: CommandId.make("runtime-layer-snoozed-message"),
+        threadId,
+        messageId: MessageId.make("runtime-layer-snoozed-message"),
+        text: "Wake this thread.",
+        attachments: [],
+        modelSelection,
+        dispatchMode: { type: "start_immediately" },
+      });
+
+      const awakened = yield* orchestrator.getThreadProjection(threadId);
+      assert.isNull(awakened.thread.snoozedUntil);
+      assert.isNull(awakened.thread.snoozedAt);
+    }),
+  );
+});
+
+it.layer(SharedApplicationDataPlaneTestLayer)("visited projection", (it) => {
+  it.effect("carries the visited watermark through the V2 shell projection", () =>
+    Effect.gen(function* () {
+      const applicationEngine = yield* OrchestrationEngineService;
+      const orchestrator = yield* OrchestratorV2;
+      const projectId = ProjectId.make("runtime-layer-visited-project");
+      const threadId = ThreadId.make("runtime-layer-visited-thread");
+      const visitedAt = "2026-07-24T01:00:00.000Z";
+
+      yield* applicationEngine.dispatch({
+        type: "project.create",
+        commandId: CommandId.make("runtime-layer-visited-project-create"),
+        projectId,
+        title: "Visited shell projection",
+        workspaceRoot: "/tmp/runtime-layer-visited-project",
+        defaultModelSelection: modelSelection,
+        scripts: [],
+        createdAt: "2026-07-24T00:00:00.000Z",
+      });
+      yield* orchestrator.dispatch({
+        type: "thread.create",
+        createdBy: "user",
+        creationSource: "web",
+        commandId: CommandId.make("runtime-layer-visited-thread-create"),
+        threadId,
+        projectId,
+        title: "Visited thread",
+        modelSelection,
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        branch: null,
+        worktreePath: null,
+      });
+      const created = yield* orchestrator.getThreadProjection(threadId);
+      assert.isNull(created.thread.lastVisitedAt);
+      const createdUpdatedAt = created.thread.updatedAt;
+
+      yield* TestClock.adjust("1 second");
+      yield* orchestrator.dispatch({
+        type: "thread.visit",
+        commandId: CommandId.make("runtime-layer-visited-thread-visit"),
+        threadId,
+        visitedAt,
+      });
+      const visited = yield* orchestrator.getThreadProjection(threadId);
+      assert.isNotNull(visited.thread.lastVisitedAt);
+      assert.equal(DateTime.formatIso(visited.thread.lastVisitedAt!), visitedAt);
+      // Visiting records read state, not activity: updatedAt must not move.
+      assert.deepEqual(visited.thread.updatedAt, createdUpdatedAt);
+
+      // Monotonic: an older watermark (a replay or a stale device) cannot
+      // rewind the marker.
+      yield* orchestrator.dispatch({
+        type: "thread.visit",
+        commandId: CommandId.make("runtime-layer-visited-thread-visit-stale"),
+        threadId,
+        visitedAt: "2026-07-24T00:30:00.000Z",
+      });
+      const afterStaleVisit = yield* orchestrator.getThreadProjection(threadId);
+      assert.equal(DateTime.formatIso(afterStaleVisit.thread.lastVisitedAt!), visitedAt);
+
+      const shell = yield* orchestrator.getShellSnapshot();
+      const thread = shell.threads.find((candidate) => candidate.id === threadId);
+      assert.isDefined(thread);
+      assert.equal(DateTime.formatIso(thread!.lastVisitedAt!), visitedAt);
+      assert.deepEqual(thread!.updatedAt, createdUpdatedAt);
+
+      // No completed run yet → nothing to mark unread against.
+      const markUnread = yield* orchestrator
+        .dispatch({
+          type: "thread.mark-unread",
+          commandId: CommandId.make("runtime-layer-visited-thread-mark-unread"),
+          threadId,
+        })
+        .pipe(Effect.flip);
+      assert.instanceOf(markUnread, OrchestratorDispatchError);
+    }),
+  );
+});
+
+it.layer(SharedApplicationDataPlaneTestLayer)("shared application data plane", (it) => {
+  it.effect("orders retained project transactions and V2 thread transactions in one source", () =>
+    Effect.gen(function* () {
+      const applicationEngine = yield* OrchestrationEngineService;
+      const applicationEvents = yield* OrchestrationEventStore;
+      const orchestrator = yield* OrchestratorV2;
+      const projectionSnapshot = yield* ProjectionSnapshotQuery;
+      const sql = yield* SqlClient.SqlClient;
+      const projectId = ProjectId.make("runtime-layer-shared-project");
+      const threadId = ThreadId.make("runtime-layer-shared-thread");
+      const projectCommand = {
+        type: "project.create" as const,
+        commandId: CommandId.make("runtime-layer-shared-project-create"),
+        projectId,
+        title: "Shared application source",
+        workspaceRoot: "/tmp/runtime-layer-shared-project",
+        defaultModelSelection: modelSelection,
+        scripts: [],
+        createdAt: "2026-06-20T00:00:00.000Z",
+      };
+
+      const projectResult = yield* applicationEngine.dispatch(projectCommand);
+      const projectRetry = yield* applicationEngine.dispatch(projectCommand);
+      assert.equal(projectRetry.sequence, projectResult.sequence);
+
+      const delivered = yield* Queue.unbounded<ApplicationStoredEvent>();
+      yield* applicationEvents.streamApplicationEvents().pipe(
+        Stream.take(2),
+        Stream.runForEach((event) => Queue.offer(delivered, event)),
+        Effect.forkScoped,
+      );
+
+      const projectEvent = yield* Queue.take(delivered);
+      assert.equal(projectEvent.sequence, projectResult.sequence);
+
+      const threadResult = yield* orchestrator.dispatch({
+        type: "thread.create",
+        createdBy: "user",
+        creationSource: "web",
+        commandId: CommandId.make("runtime-layer-shared-thread-create"),
+        threadId,
+        projectId,
+        title: "Shared thread",
+        modelSelection,
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        branch: null,
+        worktreePath: null,
+      });
+      const threadEvent = yield* Queue.take(delivered);
+
+      assert.equal(threadEvent.sequence, threadResult.sequence);
+      assert.isAbove(threadEvent.sequence, projectEvent.sequence);
+      assert.isTrue("aggregateKind" in projectEvent);
+      assert.isTrue("event" in threadEvent);
+      assert.equal((yield* projectionSnapshot.getProjectShellById(projectId))._tag, "Some");
+
+      const retainedReceipts = yield* sql<{
+        readonly aggregate_kind: string;
+        readonly aggregate_id: string;
+      }>`
+        SELECT aggregate_kind, aggregate_id
+        FROM orchestration_command_receipts
+        ORDER BY result_sequence ASC
+      `;
+      assert.deepEqual(retainedReceipts, [
+        { aggregate_kind: "project", aggregate_id: projectId },
+        { aggregate_kind: "thread", aggregate_id: threadId },
+      ]);
+
+      const retiredWrites = yield* sql<{ readonly count: number }>`
+        SELECT
+          (SELECT COUNT(*) FROM orchestration_v2_events) +
+          (SELECT COUNT(*) FROM orchestration_v2_command_receipts) AS count
+      `;
+      assert.equal(retiredWrites[0]?.count, 0);
+    }),
+  );
+});
diff --git a/apps/server/src/orchestration-v2/runtimeLayer.ts b/apps/server/src/orchestration-v2/runtimeLayer.ts
new file mode 100644
index 000000000000..b6e24a736efe
--- /dev/null
+++ b/apps/server/src/orchestration-v2/runtimeLayer.ts
@@ -0,0 +1,264 @@
+import * as Layer from "effect/Layer";
+import {
+  OrchestrationEventInfrastructureLayerLive,
+  OrchestrationLayerLive,
+} from "../orchestration/runtimeLayer.ts";
+import { ProjectionProjectRepositoryLive } from "../persistence/Layers/ProjectionProjects.ts";
+import * as TextGeneration from "../textGeneration/TextGeneration.ts";
+import { layer as projectServiceLayer } from "../project/ProjectService.ts";
+import { layer as projectSetupScriptRunnerLayer } from "../project/ProjectSetupScriptRunner.ts";
+import { layer as checkpointCaptureServiceLayer } from "./CheckpointCaptureService.ts";
+import { layer as checkpointServiceLayer } from "./CheckpointService.ts";
+import { layer as checkpointRollbackServiceLayer } from "./CheckpointRollbackService.ts";
+import { layer as commandPolicyLayer } from "./CommandPolicy.ts";
+import { layerFromApplicationReceipts as commandReceiptStoreLayer } from "./CommandReceiptStore.ts";
+import { layer as contextHandoffServiceLayer } from "./ContextHandoffService.ts";
+import { layer as effectOutboxLayer } from "./EffectOutbox.ts";
+import {
+  executorLayer as effectExecutorLayer,
+  layer as effectWorkerLayer,
+} from "./EffectWorker.ts";
+import { layerFromStores as eventSinkLayer } from "./EventSink.ts";
+import { layerFromOrchestrationEventStore as eventStoreLayer } from "./EventStore.ts";
+import { layer as idAllocatorLayer } from "./IdAllocator.ts";
+import { layer as legacyV1ThreadImporterLayer } from "./LegacyV1ThreadImporter.ts";
+import { layer as orchestratorLayer } from "./Orchestrator.ts";
+import { layer as projectionStoreLayer } from "./ProjectionStore.ts";
+import { layer as projectionMaintenanceLayer } from "./ProjectionMaintenance.ts";
+import { layerFromProviderInstanceRegistry as providerAdapterRegistryLayerFromProviderInstances } from "./ProviderAdapterRegistry.ts";
+import { layer as providerContinuationRequestsLayer } from "./ProviderContinuationRequests.ts";
+import { workerLive as providerContinuationWorkerLive } from "./ProviderContinuationService.ts";
+import { layer as threadTitleRegenerationServiceLayer } from "./ThreadTitleRegenerationService.ts";
+import { layer as providerEventIngestorLayer } from "./ProviderEventIngestor.ts";
+import { layer as providerSessionManagerLayer } from "./ProviderSessionManager.ts";
+import { layer as providerRuntimeRecoveryLayer } from "./ProviderRuntimeRecoveryService.ts";
+import { layer as providerSwitchServiceLayer } from "./ProviderSwitchService.ts";
+import { layer as providerTurnControlServiceLayer } from "./ProviderTurnControlService.ts";
+import { layer as providerTurnStartServiceLayer } from "./ProviderTurnStartService.ts";
+import { layer as runExecutionServiceLayer } from "./RunExecutionService.ts";
+import { layer as runFinalizationServiceLayer } from "./RunFinalizationService.ts";
+import { layerFromProjectRepository as runtimePolicyLayerFromProjectRepository } from "./RuntimePolicy.ts";
+import { layer as runtimeRequestServiceLayer } from "./RuntimeRequestService.ts";
+import { layerWithLegacyImporter as threadManagementServiceLayer } from "./ThreadManagementService.ts";
+import { layer as threadLaunchServiceLayer } from "./ThreadLaunchService.ts";
+import { layer as threadLifecycleServiceLayer } from "./ThreadLifecycleService.ts";
+import { layer as threadForkServiceLayer } from "./ThreadForkService.ts";
+import { layer as turnItemPositionStoreLayer } from "./TurnItemPositionStore.ts";
+import { layer as scheduledTaskServiceLayer } from "../scheduledTasks/ScheduledTaskService.ts";
+
+export const ProjectServiceLayerLive = projectServiceLayer.pipe(
+  Layer.provide(Layer.merge(ProjectionProjectRepositoryLive, OrchestrationLayerLive)),
+);
+const runtimePolicyProvided = runtimePolicyLayerFromProjectRepository.pipe(
+  Layer.provide(ProjectionProjectRepositoryLive),
+);
+
+const eventStoreProvided = eventStoreLayer.pipe(
+  Layer.provide(OrchestrationEventInfrastructureLayerLive),
+);
+const commandReceiptStoreProvided = commandReceiptStoreLayer.pipe(
+  Layer.provide(OrchestrationEventInfrastructureLayerLive),
+);
+
+const storesLayer = Layer.mergeAll(
+  OrchestrationEventInfrastructureLayerLive,
+  eventStoreProvided,
+  projectionStoreLayer,
+  commandReceiptStoreProvided,
+  effectOutboxLayer,
+  turnItemPositionStoreLayer,
+);
+
+export const OrchestrationV2EventSinkLayerLive = eventSinkLayer.pipe(Layer.provide(storesLayer));
+const eventSinkProvided = OrchestrationV2EventSinkLayerLive;
+const projectionMaintenanceProvided = projectionMaintenanceLayer.pipe(Layer.provide(storesLayer));
+const legacyV1ThreadImporterProvided = legacyV1ThreadImporterLayer.pipe(
+  Layer.provide(Layer.mergeAll(eventSinkProvided, eventStoreProvided)),
+);
+
+const providerEventIngestorProvided = providerEventIngestorLayer.pipe(
+  Layer.provide(Layer.mergeAll(eventSinkProvided, idAllocatorLayer)),
+);
+
+const checkpointServiceProvided = checkpointServiceLayer.pipe(Layer.provide(idAllocatorLayer));
+const contextHandoffServiceProvided = contextHandoffServiceLayer.pipe(
+  Layer.provide(idAllocatorLayer),
+);
+
+const providerAdapterRegistryProvided = providerAdapterRegistryLayerFromProviderInstances;
+const providerSwitchServiceProvided = providerSwitchServiceLayer.pipe(
+  Layer.provide(providerAdapterRegistryProvided),
+);
+
+const providerSessionManagerProvided = providerSessionManagerLayer.pipe(
+  Layer.provide(
+    Layer.mergeAll(
+      providerAdapterRegistryProvided,
+      eventSinkProvided,
+      idAllocatorLayer,
+      projectionStoreLayer,
+    ),
+  ),
+);
+
+const runExecutionServiceProvided = runExecutionServiceLayer.pipe(
+  Layer.provide(
+    Layer.mergeAll(
+      checkpointServiceProvided,
+      eventSinkProvided,
+      idAllocatorLayer,
+      providerEventIngestorProvided,
+    ),
+  ),
+);
+
+const providerTurnStartServiceProvided = providerTurnStartServiceLayer.pipe(
+  Layer.provide(
+    Layer.mergeAll(
+      contextHandoffServiceProvided,
+      eventSinkProvided,
+      idAllocatorLayer,
+      projectionStoreLayer,
+      providerSessionManagerProvided,
+      runExecutionServiceProvided,
+      runtimePolicyProvided,
+    ),
+  ),
+);
+
+const providerTurnControlServiceProvided = providerTurnControlServiceLayer.pipe(
+  Layer.provide(Layer.merge(projectionStoreLayer, providerSessionManagerProvided)),
+);
+const runtimeRequestServiceProvided = runtimeRequestServiceLayer.pipe(
+  Layer.provide(Layer.merge(projectionStoreLayer, providerSessionManagerProvided)),
+);
+const checkpointRollbackServiceProvided = checkpointRollbackServiceLayer.pipe(
+  Layer.provide(
+    Layer.mergeAll(
+      checkpointServiceProvided,
+      eventSinkProvided,
+      idAllocatorLayer,
+      projectionStoreLayer,
+      providerSessionManagerProvided,
+      runtimePolicyProvided,
+    ),
+  ),
+);
+const checkpointCaptureServiceProvided = checkpointCaptureServiceLayer.pipe(
+  Layer.provide(
+    Layer.mergeAll(
+      checkpointServiceProvided,
+      eventSinkProvided,
+      idAllocatorLayer,
+      projectionStoreLayer,
+    ),
+  ),
+);
+const runFinalizationServiceProvided = runFinalizationServiceLayer.pipe(
+  Layer.provide(Layer.merge(checkpointCaptureServiceProvided, projectionStoreLayer)),
+);
+
+const orchestratorProvided = orchestratorLayer.pipe(
+  Layer.provide(
+    Layer.mergeAll(
+      checkpointServiceProvided,
+      commandPolicyLayer,
+      storesLayer,
+      eventSinkProvided,
+      commandReceiptStoreProvided,
+      contextHandoffServiceProvided,
+      idAllocatorLayer,
+      providerAdapterRegistryProvided,
+      // Same layer reference as the continuation worker and the adapter
+      // infrastructure so layer memoization yields one shared request queue.
+      providerContinuationRequestsLayer,
+      providerEventIngestorProvided,
+      runtimePolicyProvided,
+      providerSessionManagerProvided,
+      providerSwitchServiceProvided,
+      runExecutionServiceProvided,
+      threadForkServiceLayer,
+    ),
+  ),
+);
+
+const threadManagementProvided = threadManagementServiceLayer.pipe(
+  Layer.provide(Layer.merge(orchestratorProvided, legacyV1ThreadImporterProvided)),
+);
+export const ProjectSetupScriptRunnerLayerLive = projectSetupScriptRunnerLayer.pipe(
+  Layer.provide(ProjectServiceLayerLive),
+);
+const threadLaunchProvided = threadLaunchServiceLayer.pipe(
+  Layer.provide(
+    Layer.mergeAll(
+      ProjectServiceLayerLive,
+      ProjectSetupScriptRunnerLayerLive,
+      threadManagementProvided,
+      commandReceiptStoreProvided,
+      idAllocatorLayer,
+    ),
+  ),
+);
+const threadLifecycleProvided = threadLifecycleServiceLayer.pipe(
+  Layer.provide(threadManagementProvided),
+);
+const scheduledTaskProvided = scheduledTaskServiceLayer.pipe(
+  Layer.provide(Layer.mergeAll(threadLaunchProvided, threadManagementProvided)),
+);
+const providerContinuationWorkerProvided = providerContinuationWorkerLive.pipe(
+  Layer.provide(
+    Layer.mergeAll(providerContinuationRequestsLayer, threadManagementProvided, idAllocatorLayer),
+  ),
+);
+const threadTitleRegenerationProvided = threadTitleRegenerationServiceLayer.pipe(
+  Layer.provide(
+    Layer.mergeAll(threadManagementProvided, ProjectionProjectRepositoryLive, TextGeneration.layer),
+  ),
+);
+const effectExecutorProvided = effectExecutorLayer.pipe(
+  Layer.provide(
+    Layer.mergeAll(
+      runFinalizationServiceProvided,
+      checkpointRollbackServiceProvided,
+      providerSessionManagerProvided,
+      providerTurnControlServiceProvided,
+      providerTurnStartServiceProvided,
+      runtimeRequestServiceProvided,
+      threadTitleRegenerationProvided,
+    ),
+  ),
+);
+const effectWorkerProvided = effectWorkerLayer.pipe(
+  Layer.provide(Layer.merge(storesLayer, effectExecutorProvided)),
+);
+const providerRuntimeRecoveryProvided = providerRuntimeRecoveryLayer.pipe(
+  Layer.provide(
+    Layer.mergeAll(
+      effectWorkerProvided,
+      storesLayer,
+      eventSinkProvided,
+      idAllocatorLayer,
+      projectionStoreLayer,
+    ),
+  ),
+);
+
+export const OrchestrationV2LayerLive = Layer.mergeAll(
+  orchestratorProvided,
+  threadManagementProvided,
+  effectWorkerProvided,
+  providerSessionManagerProvided,
+  providerRuntimeRecoveryProvided,
+  projectionMaintenanceProvided,
+  legacyV1ThreadImporterProvided,
+);
+
+export const OrchestrationV2ProductionLayerLive = Layer.mergeAll(
+  OrchestrationLayerLive,
+  OrchestrationV2LayerLive.pipe(Layer.provide(ProjectServiceLayerLive)),
+  ProjectServiceLayerLive,
+  threadLaunchProvided,
+  threadLifecycleProvided,
+  scheduledTaskProvided,
+  providerContinuationWorkerProvided,
+);
diff --git a/apps/server/src/orchestration-v2/testkit/ClaudeReplayFixtures.integration.test.ts b/apps/server/src/orchestration-v2/testkit/ClaudeReplayFixtures.integration.test.ts
new file mode 100644
index 000000000000..3f2ea0d8af30
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/ClaudeReplayFixtures.integration.test.ts
@@ -0,0 +1,399 @@
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import { assert, describe, it } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+
+import { classifyClaudeNativeTool } from "../Adapters/ClaudeAdapterV2.ts";
+import {
+  ClaudeOrchestratorReplayHarness,
+  recordClaudeAgentSdkReplayTranscript,
+  replayClaudeAgentSdkTranscript,
+} from "../Adapters/ClaudeAdapterV2.testkit.ts";
+import { ORCHESTRATOR_REPLAY_FIXTURES } from "./fixtures/index.ts";
+import {
+  MULTI_TURN_FIRST_PROMPT,
+  MULTI_TURN_SECOND_PROMPT,
+  SIMPLE_PROMPT,
+  THREAD_FORK_NATIVE_CONTINUE_FORK_MARKER,
+  THREAD_FORK_NATIVE_CONTINUE_RECALL,
+  THREAD_FORK_NATIVE_CONTINUE_SOURCE_MARKER,
+  THREAD_MERGE_BACK_FORK_MARKER,
+  THREAD_MERGE_BACK_RECALL,
+  THREAD_MERGE_BACK_SIBLINGS_FIRST_MARKER,
+  THREAD_MERGE_BACK_SIBLINGS_RECALL,
+  THREAD_MERGE_BACK_SIBLINGS_SECOND_MARKER,
+  THREAD_MERGE_BACK_SIBLINGS_SOURCE_MARKER,
+  THREAD_MERGE_BACK_SOURCE_MARKER,
+} from "./fixtures/shared.ts";
+import { checkpointWorkspace } from "./ReplayFixtureWorkspace.ts";
+import { decodeProviderReplayNdjson } from "./ReplayTranscriptNdjson.ts";
+
+const readTranscript = Effect.fn("readClaudeReplayFixture")(function* (file: URL) {
+  const fs = yield* FileSystem.FileSystem;
+  const text = yield* fs.readFileString(decodeURIComponent(file.pathname));
+  return yield* decodeProviderReplayNdjson(text);
+}, Effect.provide(NodeServices.layer));
+
+function claudeFixture(name: string) {
+  const fixture = ORCHESTRATOR_REPLAY_FIXTURES.find((entry) => entry.name === name);
+  const provider = fixture?.providers.find((entry) => entry.driver === "claudeAgent");
+  if (fixture === undefined || provider === undefined) {
+    throw new Error(`Missing ${name}/claudeAgent replay fixture.`);
+  }
+  return { fixture, provider };
+}
+
+function readClaudeTranscriptFixture(path: string) {
+  return readTranscript(new URL(`./fixtures/${path}/claude_transcript.ndjson`, import.meta.url));
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null;
+}
+
+function metadataString(transcript: ProviderReplayTranscript, key: string): string {
+  const value = transcript.metadata?.[key];
+  if (typeof value !== "string") {
+    throw new Error(`${transcript.scenario} metadata.${key} must be a string.`);
+  }
+  return value;
+}
+
+function metadataStringArray(
+  transcript: ProviderReplayTranscript,
+  key: string,
+): ReadonlyArray<string> {
+  const value = transcript.metadata?.[key];
+  if (!Array.isArray(value) || !value.every((entry) => typeof entry === "string")) {
+    throw new Error(`${transcript.scenario} metadata.${key} must be a string array.`);
+  }
+  return value;
+}
+
+type FramedReplayEntry = Extract<
+  ProviderReplayTranscript["entries"][number],
+  { readonly frame: unknown }
+>;
+
+function frameRecord(entry: FramedReplayEntry): Record<string, unknown> {
+  if (!isRecord(entry.frame)) {
+    throw new Error("Replay entry frame must be an object.");
+  }
+  return entry.frame;
+}
+
+function findEntryFrame(
+  transcript: ProviderReplayTranscript,
+  label: string,
+): Record<string, unknown> {
+  const entry = transcript.entries.find(
+    (candidate): candidate is FramedReplayEntry =>
+      "label" in candidate && candidate.label === label && "frame" in candidate,
+  );
+  assert.isDefined(entry, `${transcript.scenario} must include replay entry ${label}`);
+  return frameRecord(entry);
+}
+
+function successResultTexts(transcript: ProviderReplayTranscript): ReadonlyArray<string> {
+  return transcript.entries.flatMap((entry) => {
+    if (entry.type !== "emit_inbound" || !isRecord(entry.frame)) {
+      return [];
+    }
+    if (entry.frame.type !== "result" || entry.frame.subtype !== "success") {
+      return [];
+    }
+    return typeof entry.frame.result === "string" ? [entry.frame.result] : [];
+  });
+}
+
+function claudeToolUseNamesFromTranscript(
+  transcript: ProviderReplayTranscript,
+): ReadonlyArray<string> {
+  return transcript.entries.flatMap((entry) => {
+    if (
+      entry.type !== "emit_inbound" ||
+      !isRecord(entry.frame) ||
+      entry.frame.type !== "assistant"
+    ) {
+      return [];
+    }
+
+    const message = entry.frame.message;
+    const content = isRecord(message) ? message.content : undefined;
+    if (!Array.isArray(content)) {
+      return [];
+    }
+
+    return content.flatMap((part) =>
+      isRecord(part) &&
+      typeof part.id === "string" &&
+      typeof part.name === "string" &&
+      "input" in part
+        ? [part.name]
+        : [],
+    );
+  });
+}
+
+describe("Claude Agent SDK replay fixtures", () => {
+  it.effect("classifies every Claude fixture tool use through the native tool table", () =>
+    Effect.gen(function* () {
+      const unknownToolNames = new Set<string>();
+      const seenToolNames = new Set<string>();
+
+      for (const fixture of ORCHESTRATOR_REPLAY_FIXTURES) {
+        for (const provider of fixture.providers) {
+          if (provider.driver !== "claudeAgent") {
+            continue;
+          }
+
+          const transcript = yield* readTranscript(provider.transcriptFile);
+          for (const toolName of claudeToolUseNamesFromTranscript(transcript)) {
+            seenToolNames.add(toolName);
+            const classification = classifyClaudeNativeTool(toolName);
+            if (!classification.known) {
+              unknownToolNames.add(`${fixture.name}:${toolName}`);
+            }
+          }
+        }
+      }
+
+      assert.isAtLeast(seenToolNames.size, 1, "expected Claude fixtures to contain tool uses");
+      assert.deepEqual([...unknownToolNames], []);
+    }),
+  );
+
+  it.effect("keeps unregistered native conversation-state transcripts reviewable", () =>
+    Effect.gen(function* () {
+      const rollback = yield* readClaudeTranscriptFixture("thread_rollback");
+      assert.equal(rollback.metadata?.queryMode, "resume_at_cursor");
+      const rollbackCursor = metadataString(rollback, "resumeSessionAt");
+      const rollbackResumeFrame = findEntryFrame(rollback, "query.open:resume_at_cursor");
+      const rollbackResumeOptions = rollbackResumeFrame.options;
+      if (!isRecord(rollbackResumeOptions)) {
+        throw new Error("Rollback resume query.open options must be an object.");
+      }
+      assert.equal(rollbackResumeOptions.resumeSessionAt, rollbackCursor);
+      const rollbackFinalText = successResultTexts(rollback).at(-1) ?? "";
+      assert.include(rollbackFinalText, "rollback fixture first turn complete");
+      assert.notInclude(rollbackFinalText, "rollback fixture second turn complete");
+
+      const latestFork = yield* readClaudeTranscriptFixture("thread_fork_native");
+      assert.equal(latestFork.metadata?.queryMode, "fork_session");
+      const latestForkedSessionId = metadataString(latestFork, "forkedNativeSessionId");
+      const latestForkedFrame = findEntryFrame(latestFork, "session.forked");
+      assert.equal(latestForkedFrame.sessionId, latestForkedSessionId);
+
+      const priorFork = yield* readClaudeTranscriptFixture("thread_fork_native_prior_turn");
+      assert.equal(priorFork.metadata?.queryMode, "fork_session_prior_turn");
+      const priorForkCursor = metadataString(priorFork, "forkUpToMessageId");
+      const priorForkFrame = findEntryFrame(priorFork, "session.fork");
+      const priorForkOptions = priorForkFrame.options;
+      if (!isRecord(priorForkOptions)) {
+        throw new Error("Prior-turn fork options must be an object.");
+      }
+      assert.equal(priorForkOptions.upToMessageId, priorForkCursor);
+      const priorForkFinalText = successResultTexts(priorFork).at(-1) ?? "";
+      assert.include(priorForkFinalText, "fork boundary alpha");
+      assert.notInclude(priorForkFinalText, "fork boundary beta");
+
+      const continuedFork = yield* readClaudeTranscriptFixture("thread_fork_native_continue");
+      assert.equal(continuedFork.metadata?.queryMode, "fork_session_continue");
+      const continuedForkSessionId = metadataString(continuedFork, "forkedNativeSessionId");
+      const continuedForkOpenFrame = findEntryFrame(continuedFork, "query.open:fork");
+      const continuedForkOptions = continuedForkOpenFrame.options;
+      if (!isRecord(continuedForkOptions)) {
+        throw new Error("Continued fork query.open options must be an object.");
+      }
+      assert.equal(continuedForkOptions.resume, continuedForkSessionId);
+      const continuedForkResults = successResultTexts(continuedFork);
+      assert.deepEqual(continuedForkResults.slice(0, 2), [
+        "source marker stored",
+        "fork marker stored",
+      ]);
+      assert.equal(
+        continuedForkResults.at(-1)?.replace(/\s*\|\s*/u, "|"),
+        THREAD_FORK_NATIVE_CONTINUE_RECALL,
+      );
+      const recallPromptFrame = findEntryFrame(continuedFork, "prompt.offer:3");
+      const recallMessage = recallPromptFrame.message;
+      const recallMessageBody = isRecord(recallMessage) ? recallMessage.message : undefined;
+      const recallPrompt =
+        isRecord(recallMessageBody) && typeof recallMessageBody.content === "string"
+          ? recallMessageBody.content
+          : "";
+      assert.notInclude(recallPrompt, THREAD_FORK_NATIVE_CONTINUE_SOURCE_MARKER);
+      assert.notInclude(recallPrompt, THREAD_FORK_NATIVE_CONTINUE_FORK_MARKER);
+
+      const siblingForks = yield* readClaudeTranscriptFixture("thread_fork_native_siblings");
+      assert.equal(siblingForks.metadata?.queryMode, "fork_session_siblings");
+      const siblingSessionIds = metadataStringArray(siblingForks, "forkedNativeSessionIds");
+      assert.lengthOf(siblingSessionIds, 2);
+      assert.notEqual(siblingSessionIds[0], siblingSessionIds[1]);
+      const siblingResults = successResultTexts(siblingForks).map((text) =>
+        text.replace(/\s*\|\s*/u, "|"),
+      );
+      assert.deepEqual(siblingResults, [
+        "sibling source stored",
+        "sibling-source-8R3D|sibling-first-5L2P",
+        "sibling-source-8R3D|sibling-second-9N6C",
+      ]);
+      assert.notInclude(siblingResults[1] ?? "", "sibling-second-9N6C");
+      assert.notInclude(siblingResults[2] ?? "", "sibling-first-5L2P");
+
+      const mergeBack = yield* readClaudeTranscriptFixture("thread_merge_back_continue");
+      assert.equal(mergeBack.metadata?.queryMode, "fork_session_merge_back");
+      const mergeBackSourceSessionId = metadataString(mergeBack, "nativeSessionId");
+      const mergeBackContinuationFrame = findEntryFrame(
+        mergeBack,
+        "query.open:source-continuation",
+      );
+      const mergeBackContinuationOptions = mergeBackContinuationFrame.options;
+      if (!isRecord(mergeBackContinuationOptions)) {
+        throw new Error("Merge-back source continuation options must be an object.");
+      }
+      assert.equal(mergeBackContinuationOptions.resume, mergeBackSourceSessionId);
+      const mergeBackRecallFrame = findEntryFrame(mergeBack, "prompt.offer:4");
+      const mergeBackRecallMessage = mergeBackRecallFrame.message;
+      const mergeBackRecallBody = isRecord(mergeBackRecallMessage)
+        ? mergeBackRecallMessage.message
+        : undefined;
+      const mergeBackRecallPrompt =
+        isRecord(mergeBackRecallBody) && typeof mergeBackRecallBody.content === "string"
+          ? mergeBackRecallBody.content
+          : "";
+      assert.notInclude(mergeBackRecallPrompt, THREAD_MERGE_BACK_SOURCE_MARKER);
+      assert.notInclude(mergeBackRecallPrompt, THREAD_MERGE_BACK_FORK_MARKER);
+      assert.equal(
+        successResultTexts(mergeBack)
+          .at(-1)
+          ?.replace(/\s*\|\s*/gu, "|"),
+        THREAD_MERGE_BACK_RECALL,
+      );
+
+      const siblingMergeBack = yield* readClaudeTranscriptFixture("thread_merge_back_siblings");
+      assert.equal(siblingMergeBack.metadata?.queryMode, "fork_session_merge_back_siblings");
+      const siblingMergeSessionIds = metadataStringArray(
+        siblingMergeBack,
+        "forkedNativeSessionIds",
+      );
+      assert.lengthOf(siblingMergeSessionIds, 2);
+      assert.notEqual(siblingMergeSessionIds[0], siblingMergeSessionIds[1]);
+      const siblingMergeRecallFrame = findEntryFrame(siblingMergeBack, "prompt.offer:6");
+      const siblingMergeRecallMessage = siblingMergeRecallFrame.message;
+      const siblingMergeRecallBody = isRecord(siblingMergeRecallMessage)
+        ? siblingMergeRecallMessage.message
+        : undefined;
+      const siblingMergeRecallPrompt =
+        isRecord(siblingMergeRecallBody) && typeof siblingMergeRecallBody.content === "string"
+          ? siblingMergeRecallBody.content
+          : "";
+      assert.notInclude(siblingMergeRecallPrompt, THREAD_MERGE_BACK_SIBLINGS_SOURCE_MARKER);
+      assert.notInclude(siblingMergeRecallPrompt, THREAD_MERGE_BACK_SIBLINGS_FIRST_MARKER);
+      assert.notInclude(siblingMergeRecallPrompt, THREAD_MERGE_BACK_SIBLINGS_SECOND_MARKER);
+      assert.equal(
+        successResultTexts(siblingMergeBack)
+          .at(-1)
+          ?.replace(/\s*\|\s*/gu, "|"),
+        THREAD_MERGE_BACK_SIBLINGS_RECALL,
+      );
+
+      const forkLocalRollback = yield* readClaudeTranscriptFixture(
+        "thread_fork_native_fork_local_rollback",
+      );
+      assert.equal(forkLocalRollback.metadata?.queryMode, "fork_session_resume_at_fork_cursor");
+      const forkLocalRollbackCursor = metadataString(forkLocalRollback, "resumeSessionAt");
+      const forkLocalRollbackFrame = findEntryFrame(
+        forkLocalRollback,
+        "query.open:fork-resume-at-cursor",
+      );
+      const forkLocalRollbackOptions = forkLocalRollbackFrame.options;
+      if (!isRecord(forkLocalRollbackOptions)) {
+        throw new Error("Fork-local rollback resume query.open options must be an object.");
+      }
+      assert.equal(forkLocalRollbackOptions.resumeSessionAt, forkLocalRollbackCursor);
+      const forkLocalRollbackFinalText = successResultTexts(forkLocalRollback).at(-1) ?? "";
+      assert.include(forkLocalRollbackFinalText, "fork local source alpha");
+      assert.include(forkLocalRollbackFinalText, "fork local first");
+      assert.notInclude(forkLocalRollbackFinalText, "fork local second");
+    }),
+  );
+
+  it.skipIf(process.env.T3_RECORD_CLAUDE_AGENT_SDK_FIXTURE !== "1")(
+    "records simple from real Claude Code query() output",
+    () =>
+      Effect.scoped(
+        Effect.gen(function* () {
+          const { fixture, provider } = claudeFixture("simple");
+
+          const workspace = yield* checkpointWorkspace("claude-simple-record");
+          const transcript = yield* Effect.promise(() =>
+            recordClaudeAgentSdkReplayTranscript({
+              scenario: fixture.name,
+              prompts: [SIMPLE_PROMPT],
+              modelSelection: provider.modelSelection,
+              cwd: workspace,
+            }),
+          );
+
+          assert.equal(transcript.provider, "claudeAgent");
+          assert.equal(transcript.protocol, "claude-agent-sdk.query");
+          assert.isAtLeast(transcript.entries.length, 3);
+        }),
+      ),
+  );
+
+  it.effect("replays simple as typed Claude Agent SDK query messages", () =>
+    Effect.gen(function* () {
+      const { provider } = claudeFixture("simple");
+
+      const rawTranscript = yield* readTranscript(provider.transcriptFile);
+      const transcript = yield* ClaudeOrchestratorReplayHarness.decodeTranscript(rawTranscript);
+
+      const messages = yield* Effect.promise(() =>
+        replayClaudeAgentSdkTranscript({
+          transcript,
+          prompts: [SIMPLE_PROMPT],
+          modelSelection: provider.modelSelection,
+        }),
+      );
+
+      assert.include(
+        messages
+          .filter((message) => message.type === "assistant")
+          .flatMap((message) =>
+            message.message.content.flatMap((part) => (part.type === "text" ? [part.text] : [])),
+          )
+          .join(""),
+        "fixture simple ok",
+      );
+    }),
+  );
+
+  it.effect("replays multi_turn as typed Claude Agent SDK query messages", () =>
+    Effect.gen(function* () {
+      const { provider } = claudeFixture("multi_turn");
+
+      const rawTranscript = yield* readTranscript(provider.transcriptFile);
+      const transcript = yield* ClaudeOrchestratorReplayHarness.decodeTranscript(rawTranscript);
+
+      const messages = yield* Effect.promise(() =>
+        replayClaudeAgentSdkTranscript({
+          transcript,
+          prompts: [MULTI_TURN_FIRST_PROMPT, MULTI_TURN_SECOND_PROMPT],
+          modelSelection: provider.modelSelection,
+        }),
+      );
+
+      const assistantText = messages
+        .filter((message) => message.type === "assistant")
+        .flatMap((message) =>
+          message.message.content.flatMap((part) => (part.type === "text" ? [part.text] : [])),
+        )
+        .join("\n");
+      assert.include(assistantText, "first fixture turn complete");
+      assert.include(assistantText, "second fixture turn complete");
+    }),
+  );
+});
diff --git a/apps/server/src/orchestration-v2/testkit/CodexReplayFixtures.integration.test.ts b/apps/server/src/orchestration-v2/testkit/CodexReplayFixtures.integration.test.ts
new file mode 100644
index 000000000000..ecc7e14aaeda
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/CodexReplayFixtures.integration.test.ts
@@ -0,0 +1,735 @@
+import { assert, describe, it } from "@effect/vitest";
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+import * as CodexReplay from "effect-codex-app-server/replay";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Schema from "effect/Schema";
+
+import { ORCHESTRATOR_REPLAY_FIXTURES } from "./fixtures/index.ts";
+import {
+  THREAD_FORK_NATIVE_CONTINUE_FORK_MARKER,
+  THREAD_FORK_NATIVE_CONTINUE_RECALL,
+  THREAD_FORK_NATIVE_CONTINUE_SOURCE_MARKER,
+  THREAD_MERGE_BACK_FORK_MARKER,
+  THREAD_MERGE_BACK_RECALL,
+  THREAD_MERGE_BACK_SIBLINGS_FIRST_MARKER,
+  THREAD_MERGE_BACK_SIBLINGS_RECALL,
+  THREAD_MERGE_BACK_SIBLINGS_SECOND_MARKER,
+  THREAD_MERGE_BACK_SIBLINGS_SOURCE_MARKER,
+  THREAD_MERGE_BACK_SOURCE_MARKER,
+} from "./fixtures/shared.ts";
+import { decodeProviderReplayNdjson } from "./ReplayTranscriptNdjson.ts";
+
+const PROVIDER_THREAD_RESUME_FIRST_FINAL = "provider thread resume fixture first turn complete";
+const PROVIDER_THREAD_RESUME_SECOND_FINAL = "provider thread resume fixture second turn complete";
+
+type ProtocolReplayEntry = Extract<
+  ProviderReplayTranscript["entries"][number],
+  { readonly type: "expect_outbound" | "emit_inbound" }
+>;
+
+interface CodexReplayFixtureRegistration {
+  readonly registrationScenario: string;
+  readonly recordedScenario: string;
+  readonly transcriptFile: URL;
+}
+
+const CODEX_REPLAY_FIXTURE_REGISTRATIONS = ORCHESTRATOR_REPLAY_FIXTURES.flatMap((fixture) =>
+  fixture.providers
+    .filter((provider) => provider.driver === "codex")
+    .map((provider) => ({
+      registrationScenario: fixture.name,
+      recordedScenario: provider.recordedScenario ?? fixture.name,
+      transcriptFile: provider.transcriptFile,
+    })),
+).concat([
+  {
+    registrationScenario: "provider_thread_resume",
+    recordedScenario: "provider_thread_resume",
+    transcriptFile: new URL(
+      "./fixtures/provider_thread_resume/codex_transcript.ndjson",
+      import.meta.url,
+    ),
+  },
+  {
+    registrationScenario: "thread_fork_native_continue",
+    recordedScenario: "thread_fork_native_continue",
+    transcriptFile: new URL(
+      "./fixtures/thread_fork_native_continue/codex_transcript.ndjson",
+      import.meta.url,
+    ),
+  },
+  {
+    registrationScenario: "thread_fork_native_siblings",
+    recordedScenario: "thread_fork_native_siblings",
+    transcriptFile: new URL(
+      "./fixtures/thread_fork_native_siblings/codex_transcript.ndjson",
+      import.meta.url,
+    ),
+  },
+  {
+    registrationScenario: "thread_merge_back_continue",
+    recordedScenario: "thread_merge_back_continue",
+    transcriptFile: new URL(
+      "./fixtures/thread_merge_back_continue/codex_transcript.ndjson",
+      import.meta.url,
+    ),
+  },
+  {
+    registrationScenario: "thread_merge_back_siblings",
+    recordedScenario: "thread_merge_back_siblings",
+    transcriptFile: new URL(
+      "./fixtures/thread_merge_back_siblings/codex_transcript.ndjson",
+      import.meta.url,
+    ),
+  },
+]);
+
+function uniqueCanonicalTranscripts(
+  registrations: ReadonlyArray<CodexReplayFixtureRegistration>,
+): ReadonlyArray<CodexReplayFixtureRegistration> {
+  const canonicalTranscripts = new Map<string, CodexReplayFixtureRegistration>();
+  for (const registration of registrations) {
+    const canonicalUrl = registration.transcriptFile.href;
+    const existing = canonicalTranscripts.get(canonicalUrl);
+    if (existing !== undefined && existing.recordedScenario !== registration.recordedScenario) {
+      throw new Error(
+        `Codex replay transcript ${canonicalUrl} has conflicting recorded scenarios ${existing.recordedScenario} (${existing.registrationScenario}) and ${registration.recordedScenario} (${registration.registrationScenario}).`,
+      );
+    }
+    canonicalTranscripts.set(canonicalUrl, existing ?? registration);
+  }
+  return Array.from(canonicalTranscripts.values());
+}
+
+const CODEX_REPLAY_TRANSCRIPTS = uniqueCanonicalTranscripts(CODEX_REPLAY_FIXTURE_REGISTRATIONS);
+
+const scenarioExpectations = {
+  simple: {
+    outgoing: ["initialize", "initialized", "thread/start", "turn/start"],
+    incoming: ["thread/started", "turn/started", "turn/completed"],
+    turnStartCount: 1,
+    turnCompletedCount: 1,
+    approvalRequestCount: 0,
+  },
+  tool_call_read_only_on_request: {
+    outgoing: ["initialize", "initialized", "thread/start", "turn/start"],
+    incoming: ["item/commandExecution/requestApproval", "serverRequest/resolved", "turn/completed"],
+    turnStartCount: 1,
+    turnCompletedCount: 1,
+    approvalRequestCount: 1,
+  },
+  tool_call_workspace_never: {
+    outgoing: ["initialize", "initialized", "thread/start", "turn/start"],
+    incoming: ["turn/completed"],
+    turnStartCount: 1,
+    turnCompletedCount: 1,
+    approvalRequestCount: 0,
+  },
+  tool_call_restricted_granular: {
+    outgoing: ["initialize", "initialized", "thread/start", "turn/start"],
+    incoming: [
+      "item/fileChange/requestApproval",
+      "serverRequest/resolved",
+      "item/fileChange/outputDelta",
+      "turn/diff/updated",
+      "turn/completed",
+    ],
+    turnStartCount: 1,
+    turnCompletedCount: 1,
+    approvalRequestCount: 1,
+  },
+  subagent: {
+    outgoing: ["initialize", "initialized", "thread/start", "turn/start"],
+    incoming: ["turn/started", "turn/completed", "item/agentMessage/delta"],
+    turnStartCount: 1,
+    turnCompletedCount: 3,
+    approvalRequestCount: 0,
+  },
+  subagent_continue: {
+    outgoing: [
+      "initialize",
+      "initialized",
+      "thread/start",
+      "turn/start/spawn",
+      "turn/start/continue",
+    ],
+    incoming: [
+      "turn/started/root-1",
+      "turn/completed/child-1",
+      "turn/completed/root-1",
+      "turn/started/root-2",
+      "turn/completed/child-2",
+      "turn/completed/root-2",
+    ],
+    turnStartCount: 0,
+    turnCompletedCount: 0,
+    approvalRequestCount: 0,
+  },
+  subagent_v2: {
+    outgoing: ["initialize", "initialized", "thread/start", "turn/start"],
+    incoming: [
+      "turn/started",
+      "item/completed/subAgentActivity-started",
+      "turn/started/child",
+      "item/completed/child-answer",
+      "turn/completed",
+    ],
+    turnStartCount: 1,
+    turnCompletedCount: 2,
+    approvalRequestCount: 0,
+  },
+  subagent_v2_nested: {
+    outgoing: ["initialize", "initialized", "thread/start", "turn/start"],
+    incoming: [
+      "turn/started",
+      "item/completed/root-subagent",
+      "turn/started/child",
+      "item/completed/child-subagent",
+      "turn/started/grandchild",
+      "item/completed/grandchild-subagent",
+      "turn/started/leaf",
+      "item/completed/leaf-answer",
+      "turn/completed",
+    ],
+    turnStartCount: 1,
+    turnCompletedCount: 4,
+    approvalRequestCount: 0,
+  },
+  multi_turn: {
+    outgoing: ["initialize", "initialized", "thread/start", "turn/start"],
+    incoming: ["turn/started", "turn/completed", "item/agentMessage/delta"],
+    turnStartCount: 2,
+    turnCompletedCount: 2,
+    approvalRequestCount: 0,
+  },
+  plan_questions: {
+    outgoing: [
+      "initialize",
+      "initialized",
+      "thread/start",
+      "turn/start",
+      "item/tool/requestUserInput",
+    ],
+    incoming: [
+      "turn/started",
+      "turn/completed",
+      "item/tool/requestUserInput",
+      "serverRequest/resolved",
+      "item/agentMessage/delta",
+    ],
+    turnStartCount: 1,
+    turnCompletedCount: 1,
+    approvalRequestCount: 0,
+  },
+  proposed_plan: {
+    outgoing: ["initialize", "initialized", "thread/start", "turn/start"],
+    incoming: ["turn/started", "turn/completed", "item/agentMessage/delta"],
+    turnStartCount: 1,
+    turnCompletedCount: 1,
+    approvalRequestCount: 0,
+  },
+  provider_thread_resume: {
+    outgoing: ["initialize", "initialized", "thread/start", "thread/resume", "turn/start"],
+    incoming: ["thread/started", "turn/started", "turn/completed", "item/agentMessage/delta"],
+    turnStartCount: 2,
+    turnCompletedCount: 2,
+    approvalRequestCount: 0,
+  },
+  queued_turn: {
+    outgoing: ["initialize", "initialized", "thread/start", "turn/start"],
+    incoming: ["turn/started", "turn/completed", "item/agentMessage/delta"],
+    turnStartCount: 2,
+    turnCompletedCount: 2,
+    approvalRequestCount: 0,
+  },
+  message_steering: {
+    outgoing: ["initialize", "initialized", "thread/start", "turn/start", "turn/steer"],
+    incoming: ["turn/started", "turn/completed", "item/agentMessage/delta"],
+    turnStartCount: 1,
+    turnCompletedCount: 1,
+    approvalRequestCount: 0,
+  },
+  turn_interrupt: {
+    outgoing: ["initialize", "initialized", "thread/start", "turn/start", "turn/interrupt"],
+    incoming: ["turn/started", "turn/completed"],
+    turnStartCount: 1,
+    turnCompletedCount: 1,
+    approvalRequestCount: 0,
+  },
+  turn_interrupt_mid_tool: {
+    outgoing: [
+      "initialize",
+      "initialized",
+      "thread/start",
+      "turn/start",
+      "turn/interrupt",
+      "thread/backgroundTerminals/terminate",
+    ],
+    incoming: ["turn/started", "item/started", "turn/completed"],
+    turnStartCount: 1,
+    turnCompletedCount: 1,
+    approvalRequestCount: 0,
+  },
+  thread_rollback: {
+    outgoing: ["initialize", "initialized", "thread/start", "turn/start", "thread/rollback"],
+    incoming: ["turn/started", "turn/completed", "item/agentMessage/delta"],
+    turnStartCount: 3,
+    turnCompletedCount: 3,
+    approvalRequestCount: 0,
+  },
+  thread_fork_native_continue: {
+    outgoing: ["initialize", "initialized", "thread/start", "thread/fork", "turn/start"],
+    incoming: ["thread/started", "turn/started", "turn/completed", "item/agentMessage/delta"],
+    turnStartCount: 3,
+    turnCompletedCount: 3,
+    approvalRequestCount: 0,
+  },
+  thread_fork_native_siblings: {
+    outgoing: ["initialize", "initialized", "thread/start", "thread/fork", "turn/start"],
+    incoming: ["thread/started", "turn/started", "turn/completed", "item/agentMessage/delta"],
+    turnStartCount: 3,
+    turnCompletedCount: 3,
+    approvalRequestCount: 0,
+  },
+  thread_merge_back_continue: {
+    outgoing: ["initialize", "initialized", "thread/start", "thread/fork", "turn/start"],
+    incoming: ["thread/started", "turn/started", "turn/completed", "item/agentMessage/delta"],
+    turnStartCount: 4,
+    turnCompletedCount: 4,
+    approvalRequestCount: 0,
+  },
+  thread_merge_back_siblings: {
+    outgoing: ["initialize", "initialized", "thread/start", "thread/fork", "turn/start"],
+    incoming: ["thread/started", "turn/started", "turn/completed", "item/agentMessage/delta"],
+    turnStartCount: 6,
+    turnCompletedCount: 6,
+    approvalRequestCount: 0,
+  },
+  todo_list: {
+    outgoing: ["initialize", "initialized", "thread/start", "turn/start"],
+    incoming: ["turn/started", "turn/completed", "turn/plan/updated", "item/agentMessage/delta"],
+    turnStartCount: 1,
+    turnCompletedCount: 1,
+    approvalRequestCount: 0,
+  },
+  web_search: {
+    outgoing: ["initialize", "initialized", "thread/start", "turn/start"],
+    incoming: ["turn/started", "turn/completed", "item/agentMessage/delta"],
+    turnStartCount: 1,
+    turnCompletedCount: 1,
+    approvalRequestCount: 0,
+  },
+} as const;
+
+const decodeCodexTranscript = Schema.decodeUnknownEffect(
+  CodexReplay.CodexAppServerReplayTranscript,
+);
+const readTranscript = Effect.fn("readCodexReplayFixture")(function* (file: URL) {
+  const fs = yield* FileSystem.FileSystem;
+  const text = yield* fs.readFileString(decodeURIComponent(file.pathname));
+  return yield* decodeProviderReplayNdjson(text);
+}, Effect.provide(NodeServices.layer));
+
+function labels(
+  transcript: ProviderReplayTranscript,
+  type: "expect_outbound" | "emit_inbound",
+): ReadonlyArray<string> {
+  return transcript.entries.flatMap((entry) => {
+    if (entry.type !== type || entry.label === undefined) {
+      return [];
+    }
+    return [entry.label];
+  });
+}
+
+function countLabel(
+  transcript: ProviderReplayTranscript,
+  type: "expect_outbound" | "emit_inbound",
+  label: string,
+) {
+  return labels(transcript, type).filter((entryLabel) => entryLabel === label).length;
+}
+
+function countApprovalRequests(transcript: ProviderReplayTranscript) {
+  return labels(transcript, "emit_inbound").filter((label) => label.endsWith("/requestApproval"))
+    .length;
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+function readPath(value: unknown, path: ReadonlyArray<string | number>): unknown {
+  let current = value;
+  for (const segment of path) {
+    if (typeof segment === "number") {
+      if (!Array.isArray(current)) {
+        throw new Error(`Expected array while reading ${path.join(".")}.`);
+      }
+      current = current[segment];
+      continue;
+    }
+
+    if (!isRecord(current)) {
+      throw new Error(`Expected object while reading ${path.join(".")}.`);
+    }
+    current = current[segment];
+  }
+  return current;
+}
+
+function readString(value: unknown, path: ReadonlyArray<string | number>): string {
+  const current = readPath(value, path);
+  if (typeof current !== "string") {
+    throw new Error(`Expected string at ${path.join(".")}.`);
+  }
+  return current;
+}
+
+function readArray(value: unknown, path: ReadonlyArray<string | number>): ReadonlyArray<unknown> {
+  const current = readPath(value, path);
+  if (!Array.isArray(current)) {
+    throw new Error(`Expected array at ${path.join(".")}.`);
+  }
+  return current;
+}
+
+function findProtocolEntry(
+  transcript: ProviderReplayTranscript,
+  type: "expect_outbound" | "emit_inbound",
+  label: string,
+  occurrence = 0,
+): ProtocolReplayEntry {
+  const matches = transcript.entries.filter(
+    (entry): entry is ProtocolReplayEntry => entry.type === type && entry.label === label,
+  );
+  const entry = matches[occurrence];
+  if (!entry) {
+    throw new Error(`Missing ${type} ${label} occurrence ${occurrence}.`);
+  }
+  return entry;
+}
+
+function agentMessageTexts(transcript: ProviderReplayTranscript): ReadonlyArray<string> {
+  return transcript.entries.flatMap((entry) => {
+    if (entry.type !== "emit_inbound" || entry.label !== "item/completed") {
+      return [];
+    }
+
+    const item = readPath(entry.frame, ["params", "item"]);
+    if (!isRecord(item) || item.type !== "agentMessage" || typeof item.text !== "string") {
+      return [];
+    }
+    return [item.text];
+  });
+}
+
+function assertScenarioExpectations(transcript: ProviderReplayTranscript) {
+  const expectation =
+    scenarioExpectations[transcript.scenario as keyof typeof scenarioExpectations];
+  const outgoingLabels = labels(transcript, "expect_outbound");
+  const incomingLabels = labels(transcript, "emit_inbound");
+
+  assert.isDefined(expectation, `missing scenario expectation for ${transcript.scenario}`);
+  for (const label of expectation.outgoing) {
+    assert.include(outgoingLabels, label, `${transcript.scenario} missing outgoing ${label}`);
+  }
+  for (const label of expectation.incoming) {
+    assert.include(incomingLabels, label, `${transcript.scenario} missing incoming ${label}`);
+  }
+
+  assert.equal(countLabel(transcript, "expect_outbound", "turn/start"), expectation.turnStartCount);
+  assert.equal(
+    countLabel(transcript, "emit_inbound", "turn/completed"),
+    expectation.turnCompletedCount,
+  );
+  assert.equal(countApprovalRequests(transcript), expectation.approvalRequestCount);
+}
+
+function assertProviderThreadResumeSemantics(transcript: ProviderReplayTranscript) {
+  if (transcript.scenario !== "provider_thread_resume") {
+    return;
+  }
+
+  const startThreadId = readString(
+    findProtocolEntry(transcript, "emit_inbound", "thread/start").frame,
+    ["result", "thread", "id"],
+  );
+  const resumeRequestedThreadId = readString(
+    findProtocolEntry(transcript, "expect_outbound", "thread/resume").frame,
+    ["params", "threadId"],
+  );
+  const resumedThreadFrame = findProtocolEntry(transcript, "emit_inbound", "thread/resume").frame;
+  const resumedThreadId = readString(resumedThreadFrame, ["result", "thread", "id"]);
+  const resumedTurns = readArray(resumedThreadFrame, ["result", "thread", "turns"]);
+  const secondTurnThreadId = readString(
+    findProtocolEntry(transcript, "expect_outbound", "turn/start", 1).frame,
+    ["params", "threadId"],
+  );
+  const texts = agentMessageTexts(transcript);
+  const secondFinalText = texts[1] ?? "";
+
+  assert.equal(
+    resumeRequestedThreadId,
+    startThreadId,
+    "thread/resume must request the provider thread created by thread/start",
+  );
+  assert.equal(
+    resumedThreadId,
+    startThreadId,
+    "thread/resume must return the same provider thread id",
+  );
+  assert.equal(
+    secondTurnThreadId,
+    startThreadId,
+    "turn after resume must run on the resumed provider thread",
+  );
+  assert.isAtLeast(resumedTurns.length, 1, "thread/resume response must include prior turns");
+
+  const resumedFirstTurnItems = readArray(resumedTurns[0], ["items"]);
+  const resumedFirstTurnAgentText = resumedFirstTurnItems
+    .filter(isRecord)
+    .filter((item) => item.type === "agentMessage")
+    .map((item) => item.text)
+    .find((text): text is string => typeof text === "string");
+
+  assert.equal(
+    resumedFirstTurnAgentText,
+    PROVIDER_THREAD_RESUME_FIRST_FINAL,
+    "thread/resume response must hydrate the prior assistant answer",
+  );
+  assert.include(
+    secondFinalText,
+    PROVIDER_THREAD_RESUME_FIRST_FINAL,
+    "second turn must demonstrate access to resumed conversation history",
+  );
+  assert.include(
+    secondFinalText,
+    PROVIDER_THREAD_RESUME_SECOND_FINAL,
+    "second turn must include its own completion marker",
+  );
+}
+
+function assertContinuedForkSemantics(transcript: ProviderReplayTranscript) {
+  if (transcript.scenario !== "thread_fork_native_continue") {
+    return;
+  }
+
+  const sourceThreadId = readString(
+    findProtocolEntry(transcript, "emit_inbound", "thread/start").frame,
+    ["result", "thread", "id"],
+  );
+  const forkRequestThreadId = readString(
+    findProtocolEntry(transcript, "expect_outbound", "thread/fork").frame,
+    ["params", "threadId"],
+  );
+  const forkThreadId = readString(
+    findProtocolEntry(transcript, "emit_inbound", "thread/fork").frame,
+    ["result", "thread", "id"],
+  );
+  const firstForkTurnThreadId = readString(
+    findProtocolEntry(transcript, "expect_outbound", "turn/start", 1).frame,
+    ["params", "threadId"],
+  );
+  const secondForkTurnThreadId = readString(
+    findProtocolEntry(transcript, "expect_outbound", "turn/start", 2).frame,
+    ["params", "threadId"],
+  );
+  const recallPrompt = readString(
+    findProtocolEntry(transcript, "expect_outbound", "turn/start", 2).frame,
+    ["params", "input", 0, "text"],
+  );
+
+  assert.equal(forkRequestThreadId, sourceThreadId);
+  assert.notEqual(forkThreadId, sourceThreadId);
+  assert.equal(firstForkTurnThreadId, forkThreadId);
+  assert.equal(secondForkTurnThreadId, forkThreadId);
+  assert.notInclude(recallPrompt, THREAD_FORK_NATIVE_CONTINUE_SOURCE_MARKER);
+  assert.notInclude(recallPrompt, THREAD_FORK_NATIVE_CONTINUE_FORK_MARKER);
+  const texts = agentMessageTexts(transcript);
+  for (const expected of [
+    "source marker stored",
+    "fork marker stored",
+    THREAD_FORK_NATIVE_CONTINUE_RECALL,
+  ]) {
+    assert.include(texts, expected);
+  }
+  assert.equal(
+    texts.at(-1),
+    THREAD_FORK_NATIVE_CONTINUE_RECALL,
+    "the second fork-local turn must recall both the inherited source marker and fork-local marker",
+  );
+}
+
+function assertSiblingForkSemantics(transcript: ProviderReplayTranscript) {
+  if (transcript.scenario !== "thread_fork_native_siblings") {
+    return;
+  }
+
+  const sourceThreadId = readString(
+    findProtocolEntry(transcript, "emit_inbound", "thread/start").frame,
+    ["result", "thread", "id"],
+  );
+  const firstForkFrame = findProtocolEntry(transcript, "emit_inbound", "thread/fork", 0).frame;
+  const secondForkFrame = findProtocolEntry(transcript, "emit_inbound", "thread/fork", 1).frame;
+  const firstForkId = readString(firstForkFrame, ["result", "thread", "id"]);
+  const secondForkId = readString(secondForkFrame, ["result", "thread", "id"]);
+  const firstForkParentId = readString(firstForkFrame, ["result", "thread", "forkedFromId"]);
+  const secondForkParentId = readString(secondForkFrame, ["result", "thread", "forkedFromId"]);
+  const firstForkTurnThreadId = readString(
+    findProtocolEntry(transcript, "expect_outbound", "turn/start", 1).frame,
+    ["params", "threadId"],
+  );
+  const secondForkTurnThreadId = readString(
+    findProtocolEntry(transcript, "expect_outbound", "turn/start", 2).frame,
+    ["params", "threadId"],
+  );
+  const texts = agentMessageTexts(transcript);
+  const firstRecall = texts[1]?.replace(/\s*\|\s*/u, "|") ?? "";
+  const secondRecall = texts[2]?.replace(/\s*\|\s*/u, "|") ?? "";
+
+  assert.equal(firstForkParentId, sourceThreadId);
+  assert.equal(secondForkParentId, sourceThreadId);
+  assert.notEqual(firstForkId, secondForkId);
+  assert.equal(firstForkTurnThreadId, firstForkId);
+  assert.equal(secondForkTurnThreadId, secondForkId);
+  assert.equal(firstRecall, "sibling-source-8R3D|sibling-first-5L2P");
+  assert.notInclude(firstRecall, "sibling-second-9N6C");
+  assert.equal(secondRecall, "sibling-source-8R3D|sibling-second-9N6C");
+  assert.notInclude(secondRecall, "sibling-first-5L2P");
+}
+
+function assertMergeBackSemantics(transcript: ProviderReplayTranscript) {
+  if (transcript.scenario !== "thread_merge_back_continue") {
+    return;
+  }
+
+  const sourceThreadId = readString(
+    findProtocolEntry(transcript, "emit_inbound", "thread/start").frame,
+    ["result", "thread", "id"],
+  );
+  const forkThreadId = readString(
+    findProtocolEntry(transcript, "emit_inbound", "thread/fork").frame,
+    ["result", "thread", "id"],
+  );
+  const mergeThreadId = readString(
+    findProtocolEntry(transcript, "expect_outbound", "turn/start", 2).frame,
+    ["params", "threadId"],
+  );
+  const recallFrame = findProtocolEntry(transcript, "expect_outbound", "turn/start", 3).frame;
+  const recallThreadId = readString(recallFrame, ["params", "threadId"]);
+  const recallPrompt = readString(recallFrame, ["params", "input", 0, "text"]);
+  const texts = agentMessageTexts(transcript);
+
+  assert.notEqual(forkThreadId, sourceThreadId);
+  assert.equal(mergeThreadId, sourceThreadId);
+  assert.equal(recallThreadId, sourceThreadId);
+  assert.notInclude(recallPrompt, THREAD_MERGE_BACK_SOURCE_MARKER);
+  assert.notInclude(recallPrompt, THREAD_MERGE_BACK_FORK_MARKER);
+  assert.equal(texts.at(-1)?.replace(/\s*\|\s*/u, "|"), THREAD_MERGE_BACK_RECALL);
+}
+
+function assertSiblingMergeBackSemantics(transcript: ProviderReplayTranscript) {
+  if (transcript.scenario !== "thread_merge_back_siblings") {
+    return;
+  }
+
+  const sourceThreadId = readString(
+    findProtocolEntry(transcript, "emit_inbound", "thread/start").frame,
+    ["result", "thread", "id"],
+  );
+  const firstForkId = readString(
+    findProtocolEntry(transcript, "emit_inbound", "thread/fork", 0).frame,
+    ["result", "thread", "id"],
+  );
+  const secondForkId = readString(
+    findProtocolEntry(transcript, "emit_inbound", "thread/fork", 1).frame,
+    ["result", "thread", "id"],
+  );
+  const firstMergeThreadId = readString(
+    findProtocolEntry(transcript, "expect_outbound", "turn/start", 3).frame,
+    ["params", "threadId"],
+  );
+  const secondMergeThreadId = readString(
+    findProtocolEntry(transcript, "expect_outbound", "turn/start", 4).frame,
+    ["params", "threadId"],
+  );
+  const recallFrame = findProtocolEntry(transcript, "expect_outbound", "turn/start", 5).frame;
+  const recallPrompt = readString(recallFrame, ["params", "input", 0, "text"]);
+  const finalText = agentMessageTexts(transcript)
+    .at(-1)
+    ?.replace(/\s*\|\s*/gu, "|");
+
+  assert.notEqual(firstForkId, secondForkId);
+  assert.equal(firstMergeThreadId, sourceThreadId);
+  assert.equal(secondMergeThreadId, sourceThreadId);
+  assert.notInclude(recallPrompt, THREAD_MERGE_BACK_SIBLINGS_SOURCE_MARKER);
+  assert.notInclude(recallPrompt, THREAD_MERGE_BACK_SIBLINGS_FIRST_MARKER);
+  assert.notInclude(recallPrompt, THREAD_MERGE_BACK_SIBLINGS_SECOND_MARKER);
+  assert.equal(finalText, THREAD_MERGE_BACK_SIBLINGS_RECALL);
+}
+
+describe("Codex replay fixtures", () => {
+  it.effect("loads each canonical Codex fixture as an app-server replay transcript", () =>
+    Effect.gen(function* () {
+      for (const fixture of CODEX_REPLAY_TRANSCRIPTS) {
+        const transcript = yield* readTranscript(fixture.transcriptFile);
+        const codexTranscript = yield* decodeCodexTranscript(transcript);
+        const first = transcript.entries[0];
+
+        assert.equal(codexTranscript.provider, "codex");
+        assert.equal(codexTranscript.protocol, "codex.app-server");
+        assert.equal(codexTranscript.scenario, fixture.recordedScenario);
+        assert.deepEqual(codexTranscript.entries.at(-1), {
+          type: "runtime_exit",
+          status: "success",
+        });
+        assert.equal(first?.type, "expect_outbound");
+        if (first?.type !== "expect_outbound") {
+          throw new Error(
+            `Expected ${fixture.recordedScenario} to start with initialize outbound frame.`,
+          );
+        }
+        assert.equal(first.label, "initialize");
+
+        assertScenarioExpectations(transcript);
+        assertProviderThreadResumeSemantics(transcript);
+        assertContinuedForkSemantics(transcript);
+        assertSiblingForkSemantics(transcript);
+        assertMergeBackSemantics(transcript);
+        assertSiblingMergeBackSemantics(transcript);
+      }
+    }),
+  );
+
+  it("covers the expected replay suite exactly", () => {
+    assert.deepEqual(
+      CODEX_REPLAY_TRANSCRIPTS.map((fixture) => fixture.recordedScenario).toSorted(),
+      Object.keys(scenarioExpectations).toSorted(),
+    );
+  });
+
+  it("rejects conflicting recorded scenarios for one canonical transcript", () => {
+    const transcriptFile = new URL(
+      "./fixtures/queued_turn/codex_transcript.ndjson",
+      import.meta.url,
+    );
+
+    assert.throws(() =>
+      uniqueCanonicalTranscripts([
+        {
+          registrationScenario: "queued_turn",
+          recordedScenario: "queued_turn",
+          transcriptFile,
+        },
+        {
+          registrationScenario: "conflicting_alias",
+          recordedScenario: "different_recording",
+          transcriptFile,
+        },
+      ]),
+    );
+  });
+});
diff --git a/apps/server/src/orchestration-v2/testkit/DeterministicRuntime.ts b/apps/server/src/orchestration-v2/testkit/DeterministicRuntime.ts
new file mode 100644
index 000000000000..2c2187d64a7a
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/DeterministicRuntime.ts
@@ -0,0 +1,13 @@
+import * as Effect from "effect/Effect";
+import * as Random from "effect/Random";
+import { TestClock } from "effect/testing";
+
+export function provideDeterministicTestRuntime<A, E, R>(
+  effect: Effect.Effect<A, E, R>,
+  options: { readonly randomSeed?: number } = {},
+) {
+  return effect.pipe(
+    Effect.provide(TestClock.layer()),
+    Random.withSeed(options.randomSeed ?? 0x1234_5678),
+  );
+}
diff --git a/apps/server/src/orchestration-v2/testkit/OrchestratorReplayFixtures.contract.test.ts b/apps/server/src/orchestration-v2/testkit/OrchestratorReplayFixtures.contract.test.ts
new file mode 100644
index 000000000000..6021642ee97f
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/OrchestratorReplayFixtures.contract.test.ts
@@ -0,0 +1,417 @@
+import { assert, describe, it } from "@effect/vitest";
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import { OrchestrationV2Command, ProviderDriverKind, ProviderInstanceId } from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Schema from "effect/Schema";
+
+import { IdAllocatorV2, layer as idAllocatorLayer } from "../IdAllocator.ts";
+import { provideDeterministicTestRuntime } from "./DeterministicRuntime.ts";
+import { ORCHESTRATOR_REPLAY_FIXTURES } from "./fixtures/index.ts";
+import {
+  CODEX_MODEL_SELECTION,
+  materializeFixtureInput,
+  type OrchestratorFixtureInput,
+} from "./fixtures/shared.ts";
+import { decodeProviderReplayNdjson } from "./ReplayTranscriptNdjson.ts";
+
+const decodeCommand = Schema.decodeUnknownEffect(OrchestrationV2Command);
+const readTranscript = Effect.fn("readOrchestratorReplayContractTranscript")(function* (file: URL) {
+  const fs = yield* FileSystem.FileSystem;
+  const text = yield* fs.readFileString(decodeURIComponent(file.pathname));
+  return yield* decodeProviderReplayNdjson(text);
+}, Effect.provide(NodeServices.layer));
+
+function assertUnique(values: ReadonlyArray<string>, label: string) {
+  assert.deepEqual(new Set(values).size, values.length, `${label} must be unique`);
+}
+
+describe("orchestrator replay fixture contract", () => {
+  it.effect("materializes queued fixture messages as queue-after-active dispatches", () =>
+    Effect.gen(function* () {
+      const materialized = yield* materializeFixtureInput({
+        scenario: "queued-message-dispatch-mode",
+        fixtureInput: {
+          steps: [
+            { type: "message", text: "active run" },
+            { type: "queue_message", text: "queued run" },
+          ],
+        },
+        driver: ProviderDriverKind.make("codex"),
+        modelSelection: CODEX_MODEL_SELECTION,
+      });
+      const queuedCommand = materialized.commands.find(
+        (command) => command.type === "message.dispatch" && command.text === "queued run",
+      );
+
+      assert.isDefined(queuedCommand);
+      assert.deepInclude(queuedCommand, {
+        dispatchMode: { type: "queue_after_active" },
+      });
+    }).pipe(Effect.provide(idAllocatorLayer), provideDeterministicTestRuntime),
+  );
+
+  it.effect(
+    "keeps consecutive queue_message inputs queued without an intermediate idle barrier",
+    () =>
+      Effect.gen(function* () {
+        const materialized = yield* materializeFixtureInput({
+          scenario: "consecutive-queue-message-ordering",
+          fixtureInput: {
+            steps: [
+              { type: "message", text: "active run" },
+              { type: "queue_message", text: "queued run 1" },
+              { type: "queue_message", text: "queued run 2" },
+            ],
+          },
+          driver: ProviderDriverKind.make("codex"),
+          modelSelection: CODEX_MODEL_SELECTION,
+        });
+        const queueCommands = materialized.commands.filter(
+          (command) =>
+            command.type === "message.dispatch" &&
+            (command.text === "queued run 1" || command.text === "queued run 2"),
+        );
+        assert.lengthOf(queueCommands, 2);
+        for (const command of queueCommands) {
+          assert.deepInclude(command, {
+            dispatchMode: { type: "queue_after_active" },
+          });
+        }
+
+        const firstQueueDispatchIndex = materialized.steps.findIndex(
+          (step) =>
+            step.type === "dispatch" &&
+            step.command.type === "message.dispatch" &&
+            step.command.text === "queued run 1",
+        );
+        const secondQueueDispatchIndex = materialized.steps.findIndex(
+          (step) =>
+            step.type === "dispatch" &&
+            step.command.type === "message.dispatch" &&
+            step.command.text === "queued run 2",
+        );
+        assert.isAtLeast(firstQueueDispatchIndex, 0);
+        assert.isAbove(secondQueueDispatchIndex, firstQueueDispatchIndex);
+
+        const betweenQueueSteps = materialized.steps.slice(
+          firstQueueDispatchIndex + 1,
+          secondQueueDispatchIndex,
+        );
+        assert.isFalse(
+          betweenQueueSteps.some(
+            (step) => step.type === "await" || step.type === "await_thread_idle",
+          ),
+          "consecutive queue_message steps must not await the active run or thread idle between queues",
+        );
+
+        const afterSecondQueue = materialized.steps.slice(secondQueueDispatchIndex + 1);
+        const barrierAwaitIndex = afterSecondQueue.findIndex((step) => step.type === "await");
+        const barrierIdleIndex = afterSecondQueue.findIndex(
+          (step) => step.type === "await_thread_idle",
+        );
+        assert.isAtLeast(
+          barrierAwaitIndex,
+          0,
+          "the final queue_message still inserts the post-queue await barrier",
+        );
+        assert.deepEqual(afterSecondQueue[barrierAwaitIndex], {
+          type: "await",
+          key: "run:1",
+        });
+        assert.isAbove(
+          barrierIdleIndex,
+          barrierAwaitIndex,
+          "the final queue_message still inserts await_thread_idle after its await",
+        );
+      }).pipe(Effect.provide(idAllocatorLayer), provideDeterministicTestRuntime),
+  );
+
+  it.effect(
+    "does not await thread idle between steer/restart and answer_next_user_input_request",
+    () =>
+      Effect.gen(function* () {
+        for (const steeringType of ["steer", "restart"] as const) {
+          const answers = { "question-0": "answer" };
+          const materialized = yield* materializeFixtureInput({
+            scenario: `${steeringType}-then-answer-user-input-ordering`,
+            fixtureInput: {
+              steps: [
+                { type: "message", text: "active run" },
+                {
+                  type: steeringType,
+                  text: `${steeringType} active run`,
+                  targetRunIndex: 1,
+                },
+                {
+                  type: "answer_next_user_input_request",
+                  answers,
+                },
+              ],
+            },
+            driver: ProviderDriverKind.make("codex"),
+            modelSelection: CODEX_MODEL_SELECTION,
+          });
+
+          const steeringDispatchIndex = materialized.steps.findIndex(
+            (step) =>
+              step.type === "dispatch" &&
+              step.command.type === "message.dispatch" &&
+              step.command.text === `${steeringType} active run`,
+          );
+          const answerStepIndex = materialized.steps.findIndex(
+            (step) =>
+              step.type === "respond_to_next_runtime_request" &&
+              step.answers !== undefined &&
+              Object.keys(step.answers).includes("question-0"),
+          );
+          assert.isAtLeast(steeringDispatchIndex, 0, `${steeringType} dispatch must materialize`);
+          assert.isAbove(
+            answerStepIndex,
+            steeringDispatchIndex,
+            `${steeringType} answer must follow the steering dispatch`,
+          );
+
+          const betweenSteps = materialized.steps.slice(steeringDispatchIndex + 1, answerStepIndex);
+          assert.isFalse(
+            betweenSteps.some((step) => step.type === "await" || step.type === "await_thread_idle"),
+            `${steeringType} followed by answer_next_user_input_request must not await idle before answering`,
+          );
+        }
+      }).pipe(Effect.provide(idAllocatorLayer), provideDeterministicTestRuntime),
+  );
+
+  it.effect("keeps the active dispatch barrier through queued-run replacement", () =>
+    Effect.gen(function* () {
+      const materialized = yield* materializeFixtureInput({
+        scenario: "queued-run-replacement-ordering",
+        fixtureInput: {
+          steps: [
+            { type: "message", text: "active run" },
+            { type: "queue_message", text: "queued run" },
+            { type: "cancel_queued_run", targetRunIndex: 2 },
+            { type: "queue_message", text: "replacement queued run" },
+          ],
+        },
+        driver: ProviderDriverKind.make("codex"),
+        modelSelection: CODEX_MODEL_SELECTION,
+      });
+      const replacementQueueDispatchIndex = materialized.steps.findIndex(
+        (step) =>
+          step.type === "dispatch" &&
+          step.command.type === "message.dispatch" &&
+          step.command.text === "replacement queued run",
+      );
+      assert.isAtLeast(replacementQueueDispatchIndex, 0);
+
+      const afterReplacementQueue = materialized.steps.slice(replacementQueueDispatchIndex + 1);
+      const barrierAwait = afterReplacementQueue.find((step) => step.type === "await");
+      assert.deepEqual(barrierAwait, {
+        type: "await",
+        key: "run:1",
+      });
+    }).pipe(Effect.provide(idAllocatorLayer), provideDeterministicTestRuntime),
+  );
+
+  it.effect("materializes fixture run-status waits against derived run IDs", () =>
+    Effect.gen(function* () {
+      const idAllocator = yield* IdAllocatorV2;
+      const materialized = yield* materializeFixtureInput({
+        scenario: "await-fixture-run-status",
+        fixtureInput: {
+          steps: [{ type: "await_run_status", targetRunIndex: 1, status: "running" }],
+        },
+        driver: ProviderDriverKind.make("codex"),
+        modelSelection: CODEX_MODEL_SELECTION,
+      });
+      const threadId = materialized.projectionThreadIds[0];
+      assert.isDefined(threadId);
+      const runStatusWait = materialized.steps.find((step) => step.type === "await_run_status");
+
+      assert.deepEqual(runStatusWait, {
+        type: "await_run_status",
+        threadId,
+        runId: idAllocator.derive.run({ threadId, ordinal: 1 }),
+        status: "running",
+      });
+    }).pipe(Effect.provide(idAllocatorLayer), provideDeterministicTestRuntime),
+  );
+
+  it.effect("keeps message ordinals separate from app run ordinals after steering", () =>
+    Effect.gen(function* () {
+      const idAllocator = yield* IdAllocatorV2;
+      for (const steeringType of ["steer", "restart"] as const) {
+        const fixtureInput: OrchestratorFixtureInput = {
+          steps: [
+            { type: "message", text: "first run" },
+            { type: steeringType, text: "steer first run", targetRunIndex: 1 },
+            { type: "message", text: "second run" },
+            { type: "interrupt", targetRunIndex: 2 },
+          ],
+        };
+        const materialized = yield* materializeFixtureInput({
+          scenario: `run-index-after-${steeringType}`,
+          fixtureInput,
+          driver: ProviderDriverKind.make("codex"),
+          modelSelection: CODEX_MODEL_SELECTION,
+        });
+        const secondRunCommand = materialized.commands.find(
+          (command) => command.type === "message.dispatch" && command.text === "second run",
+        );
+        assert.isDefined(secondRunCommand);
+        const secondRunDispatch = materialized.steps.find(
+          (step) => step.type === "dispatch" && step.command === secondRunCommand,
+        );
+        assert.deepInclude(secondRunDispatch, {
+          type: "dispatch",
+          await: false,
+          key: "run:2",
+        });
+        const expectedSecondRunId = idAllocator.derive.run({
+          threadId: materialized.projectionThreadIds[0]!,
+          ordinal: 2,
+        });
+        assert.isTrue(
+          materialized.steps.some(
+            (step) => step.type === "await_run_steerable" && step.runId === expectedSecondRunId,
+          ),
+        );
+      }
+    }).pipe(Effect.provide(idAllocatorLayer), provideDeterministicTestRuntime),
+  );
+
+  it.effect(
+    "defines one stable input and provider-specific replay/output contracts per scenario",
+    () =>
+      Effect.gen(function* () {
+        assertUnique(
+          ORCHESTRATOR_REPLAY_FIXTURES.map((fixture) => fixture.name),
+          "fixture names",
+        );
+
+        for (const fixture of ORCHESTRATOR_REPLAY_FIXTURES) {
+          assert.isAtLeast(fixture.providers.length, 1, `${fixture.name} must have providers`);
+          assertUnique(
+            fixture.providers.map((provider) => provider.driver),
+            `${fixture.name} provider variants`,
+          );
+
+          for (const provider of fixture.providers) {
+            const transcript = yield* readTranscript(provider.transcriptFile);
+            const replayGateLabels = fixture
+              .buildInput()
+              .steps.flatMap((step) =>
+                step.type === "release_replay_gate" ||
+                step.type === "release_replay_gate_after_waiting"
+                  ? [step.label]
+                  : [],
+              );
+            const materialized = yield* materializeFixtureInput({
+              scenario: fixture.name,
+              fixtureInput: fixture.buildInput(),
+              driver: provider.driver,
+              modelSelection: provider.modelSelection,
+            }).pipe(Effect.provide(idAllocatorLayer), provideDeterministicTestRuntime);
+            const firstCommand = materialized.commands[0];
+
+            assert.equal(transcript.scenario, provider.recordedScenario ?? fixture.name);
+            if (provider.driver === "acpRegistry") {
+              assert.include(
+                ["acpRegistry", "grok"],
+                transcript.provider,
+                "ACP Registry may retarget protocol-standard Grok ACP evidence",
+              );
+            } else {
+              assert.equal(transcript.provider, provider.driver);
+            }
+            assert.equal(
+              provider.modelSelection.instanceId,
+              ProviderInstanceId.make(provider.driver),
+            );
+            assert.isDefined(materialized.projectionThreadIds[0]);
+            assert.equal(firstCommand?.type, "thread.create");
+            if (firstCommand?.type !== "thread.create") {
+              throw new Error(`${fixture.name}/${provider.driver} must start with thread.create`);
+            }
+            assert.equal(firstCommand.threadId, materialized.projectionThreadIds[0]);
+            // These fixture steps coordinate the test runtime; every other
+            // input step dispatches a command.
+            const commandProducingSteps = fixture
+              .buildInput()
+              .steps.filter(
+                (step) =>
+                  step.type !== "advance_clock" &&
+                  step.type !== "await_run_status" &&
+                  step.type !== "capture_shell_snapshot" &&
+                  step.type !== "release_replay_gate" &&
+                  step.type !== "release_replay_gate_after_waiting",
+              );
+            assert.equal(materialized.commands.length, commandProducingSteps.length + 1);
+            assert.isAtLeast(materialized.steps.length, materialized.commands.length);
+            assert.equal(typeof provider.assertOutput, "function");
+            for (const label of replayGateLabels) {
+              assert.isTrue(
+                transcript.entries.some(
+                  (entry) => entry.type === "emit_inbound" && entry.label === label,
+                ),
+                `${fixture.name}/${provider.driver} replay gate ${label} must label an inbound frame`,
+              );
+            }
+            if (provider.transcriptEntriesThroughLabel !== undefined) {
+              assert.isTrue(
+                transcript.entries.some(
+                  (entry) =>
+                    entry.type === "emit_inbound" &&
+                    entry.label === provider.transcriptEntriesThroughLabel,
+                ),
+                `${fixture.name}/${provider.driver} transcript slice must name an inbound frame`,
+              );
+            }
+
+            assertUnique(
+              materialized.commands.map((command) => command.commandId),
+              `${fixture.name}/${provider.driver} command IDs`,
+            );
+
+            for (const command of materialized.commands) {
+              yield* decodeCommand(command);
+            }
+
+            for (const command of materialized.commands) {
+              assert.isTrue(
+                materialized.steps.some(
+                  (step) =>
+                    (step.type === "dispatch" && step.command === command) ||
+                    (step.type === "respond_to_next_runtime_request" &&
+                      step.commandId === command.commandId),
+                ),
+                `${fixture.name}/${provider.driver} command ${command.commandId} must appear in the timeline`,
+              );
+            }
+          }
+        }
+      }),
+  );
+
+  it.effect("keeps Codex fixture transcripts at the codex app-server boundary", () =>
+    Effect.gen(function* () {
+      for (const fixture of ORCHESTRATOR_REPLAY_FIXTURES) {
+        for (const provider of fixture.providers.filter((entry) => entry.driver === "codex")) {
+          const transcript = yield* readTranscript(provider.transcriptFile);
+          const first = transcript.entries[0];
+          const last = transcript.entries.at(-1);
+
+          assert.equal(transcript.protocol, "codex.app-server");
+          assert.equal(first?.type, "expect_outbound");
+          if (first?.type === "expect_outbound") {
+            assert.equal(first.label, "initialize");
+          }
+          assert.deepEqual(last, {
+            type: "runtime_exit",
+            status: "success",
+          });
+        }
+      }
+    }),
+  );
+});
diff --git a/apps/server/src/orchestration-v2/testkit/OrchestratorReplayFixtures.integration.test.ts b/apps/server/src/orchestration-v2/testkit/OrchestratorReplayFixtures.integration.test.ts
new file mode 100644
index 000000000000..72f03b21b0ae
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/OrchestratorReplayFixtures.integration.test.ts
@@ -0,0 +1,242 @@
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import { assert, describe, it } from "@effect/vitest";
+import type { OrchestrationV2DomainEvent, ProviderReplayTranscript } from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+
+import { ClaudeOrchestratorReplayHarness } from "../Adapters/ClaudeAdapterV2.testkit.ts";
+import { CodexOrchestratorReplayHarness } from "../Adapters/CodexAdapterV2.testkit.ts";
+import { CursorOrchestratorReplayHarness } from "../Adapters/CursorAdapterV2.testkit.ts";
+import { AcpRegistryOrchestratorReplayHarness } from "../Adapters/AcpRegistryAdapterV2.testkit.ts";
+import { GrokOrchestratorReplayHarness } from "../Adapters/GrokAdapterV2.testkit.ts";
+import { OpenCodeOrchestratorReplayHarness } from "../Adapters/OpenCodeAdapterV2.testkit.ts";
+import { layer as idAllocatorLayer } from "../IdAllocator.ts";
+import { provideDeterministicTestRuntime } from "./DeterministicRuntime.ts";
+import { ORCHESTRATOR_REPLAY_FIXTURES } from "./fixtures/index.ts";
+import { messageRestartInput } from "./fixtures/message_steering/input.ts";
+import {
+  materializeFixtureInput,
+  type OrchestratorFixtureInput,
+  type ProviderOrchestratorReplayVariant,
+} from "./fixtures/shared.ts";
+import {
+  runOrchestratorV2ProviderReplayScenario,
+  type OrchestratorV2ProviderReplayHarness,
+} from "./ProviderReplayHarness.ts";
+import { checkpointWorkspace } from "./ReplayFixtureWorkspace.ts";
+import {
+  decodeProviderReplayNdjson,
+  materializeReplayTranscriptWorkspace,
+} from "./ReplayTranscriptNdjson.ts";
+
+const readTranscript = Effect.fn("readOrchestratorReplayTranscript")(function* (file: URL) {
+  const fs = yield* FileSystem.FileSystem;
+  const text = yield* fs.readFileString(decodeURIComponent(file.pathname));
+  return yield* decodeProviderReplayNdjson(text);
+}, Effect.provide(NodeServices.layer));
+
+function normalizeTestError(cause: unknown): Error {
+  return cause instanceof Error ? cause : new Error(String(cause));
+}
+
+function transcriptEntriesThroughLabel(
+  transcript: ProviderReplayTranscript,
+  label: string | undefined,
+): ProviderReplayTranscript {
+  if (label === undefined) {
+    return transcript;
+  }
+  const entryIndex = transcript.entries.findIndex(
+    (entry) => entry.type === "emit_inbound" && entry.label === label,
+  );
+  if (entryIndex === -1) {
+    throw new Error(`${transcript.scenario} is missing inbound transcript label ${label}.`);
+  }
+  return {
+    ...transcript,
+    entries: transcript.entries.slice(0, entryIndex + 1),
+  };
+}
+
+function isStreamingAssistantEvent(event: OrchestrationV2DomainEvent): boolean {
+  switch (event.type) {
+    case "node.updated":
+      return event.payload.kind === "assistant_message" && event.payload.status === "running";
+    case "message.updated":
+      return event.payload.role === "assistant" && event.payload.streaming;
+    case "turn-item.updated":
+      return event.payload.type === "assistant_message" && event.payload.streaming;
+    default:
+      return false;
+  }
+}
+
+const runFixtureProvider = Effect.fn("runOrchestratorReplayFixture")(function* <
+  Transcript extends ProviderReplayTranscript,
+  Error,
+>(input: {
+  readonly fixtureName: string;
+  readonly buildInput: () => OrchestratorFixtureInput;
+  readonly driver: ProviderOrchestratorReplayVariant;
+  readonly harness: OrchestratorV2ProviderReplayHarness<Transcript, Error>;
+  readonly enableLegacyTokenStreaming?: boolean;
+}) {
+  const rawTranscript = yield* readTranscript(input.driver.transcriptFile);
+  const replayTranscript = transcriptEntriesThroughLabel(
+    rawTranscript,
+    input.driver.transcriptEntriesThroughLabel,
+  );
+  const workspace = yield* checkpointWorkspace(input.fixtureName);
+  const transcript = yield* input.harness.decodeTranscript(
+    input.driver.driver === "codex"
+      ? materializeReplayTranscriptWorkspace(replayTranscript, workspace)
+      : replayTranscript,
+  );
+  const materialized = yield* materializeFixtureInput({
+    scenario: input.fixtureName,
+    fixtureInput: input.buildInput(),
+    driver: input.driver.driver,
+    modelSelection: input.driver.modelSelection,
+  }).pipe(Effect.provide(idAllocatorLayer), provideDeterministicTestRuntime);
+  const scenario = {
+    name: `${input.fixtureName}/${input.driver.driver}`,
+    transcript,
+    commands: materialized.commands,
+    steps: materialized.steps,
+    projectionThreadIds: materialized.projectionThreadIds,
+    runtimePolicyOverride: {
+      ...input.driver.runtimePolicyOverride,
+      cwd: workspace,
+    },
+  };
+
+  const result = yield* runOrchestratorV2ProviderReplayScenario(scenario, input.harness, {
+    enableLegacyTokenStreaming: input.enableLegacyTokenStreaming ?? false,
+  }).pipe(provideDeterministicTestRuntime);
+  input.driver.assertOutput(result, transcript);
+  if (input.enableLegacyTokenStreaming !== true) {
+    assert.isFalse(
+      result.domainEvents.some(isStreamingAssistantEvent),
+      "buffered delivery must not persist streaming assistant artifacts",
+    );
+  }
+  const projectionThreadId = materialized.projectionThreadIds[0];
+  assert.isDefined(projectionThreadId);
+  const projection = result.projections.get(projectionThreadId);
+  assert.isDefined(projection);
+  const latestRun = projection.runs.at(-1);
+  assert.deepEqual(latestRun?.modelSelection, input.driver.modelSelection);
+  if (projection.runs.some((run) => run.status === "completed")) {
+    const threadStartCheckpoint = projection.checkpoints.find(
+      (checkpoint) => checkpoint.ordinalWithinScope === 0 && checkpoint.appRunOrdinal === null,
+    );
+    assert.isDefined(
+      threadStartCheckpoint,
+      "completed threads must retain an addressable thread-start checkpoint",
+    );
+    assert.equal(threadStartCheckpoint.status, "ready");
+  }
+  return result;
+});
+
+function runFixtureProviderWithRegisteredHarness(input: {
+  readonly fixtureName: string;
+  readonly buildInput: () => OrchestratorFixtureInput;
+  readonly driver: ProviderOrchestratorReplayVariant;
+  readonly enableLegacyTokenStreaming?: boolean;
+}) {
+  switch (input.driver.driver) {
+    case "codex":
+      return runFixtureProvider({
+        ...input,
+        harness: CodexOrchestratorReplayHarness,
+      }).pipe(Effect.mapError(normalizeTestError), Effect.scoped);
+    case "claudeAgent":
+      return runFixtureProvider({
+        ...input,
+        harness: ClaudeOrchestratorReplayHarness,
+      }).pipe(Effect.mapError(normalizeTestError), Effect.scoped);
+    case "cursor":
+      return runFixtureProvider({
+        ...input,
+        harness: CursorOrchestratorReplayHarness,
+      }).pipe(Effect.mapError(normalizeTestError), Effect.scoped);
+    case "grok":
+      return runFixtureProvider({
+        ...input,
+        harness: GrokOrchestratorReplayHarness,
+      }).pipe(Effect.mapError(normalizeTestError), Effect.scoped);
+    case "acpRegistry":
+      return runFixtureProvider({
+        ...input,
+        harness: AcpRegistryOrchestratorReplayHarness,
+      }).pipe(Effect.mapError(normalizeTestError), Effect.scoped);
+    case "opencode":
+      return runFixtureProvider({
+        ...input,
+        harness: OpenCodeOrchestratorReplayHarness,
+      }).pipe(Effect.mapError(normalizeTestError), Effect.scoped);
+    default:
+      return Effect.die(
+        new Error(`No replay harness registered for provider ${input.driver.driver}.`),
+      );
+  }
+}
+
+describe("orchestrator replay fixtures", () => {
+  for (const fixture of ORCHESTRATOR_REPLAY_FIXTURES) {
+    for (const provider of fixture.providers) {
+      it.effect(
+        `runs ${fixture.name}/${provider.driver} through OrchestratorV2 using deterministic replay`,
+        () =>
+          runFixtureProviderWithRegisteredHarness({
+            fixtureName: fixture.name,
+            buildInput: fixture.buildInput,
+            driver: provider,
+          }),
+      );
+    }
+  }
+
+  const steeringFixture = ORCHESTRATOR_REPLAY_FIXTURES.find(
+    (fixture) => fixture.name === "message_steering",
+  );
+  const cursorSteeringProvider = steeringFixture?.providers.find(
+    (provider) => provider.driver === "cursor",
+  );
+  if (cursorSteeringProvider !== undefined) {
+    it.effect("executes explicit Cursor restart_active through the recorded SDK boundary", () =>
+      runFixtureProviderWithRegisteredHarness({
+        fixtureName: "message_steering",
+        buildInput: messageRestartInput,
+        driver: cursorSteeringProvider,
+      }),
+    );
+  }
+
+  const simpleFixture = ORCHESTRATOR_REPLAY_FIXTURES.find((fixture) => fixture.name === "simple");
+  const simpleCursorProvider = simpleFixture?.providers.find(
+    (provider) => provider.driver === "cursor",
+  );
+  if (simpleFixture !== undefined && simpleCursorProvider !== undefined) {
+    it.effect("streams Cursor assistant artifacts only when streaming is enabled", () =>
+      Effect.gen(function* () {
+        const result = yield* runFixtureProviderWithRegisteredHarness({
+          fixtureName: "simple-cursor-streaming",
+          buildInput: simpleFixture.buildInput,
+          driver: simpleCursorProvider,
+          enableLegacyTokenStreaming: true,
+        });
+
+        assert.deepEqual(
+          Array.from(
+            new Set(
+              result.domainEvents.filter(isStreamingAssistantEvent).map((event) => event.type),
+            ),
+          ).toSorted(),
+          ["message.updated", "node.updated", "turn-item.updated"],
+        );
+      }),
+    );
+  }
+});
diff --git a/apps/server/src/orchestration-v2/testkit/OrchestratorReplayRecovery.integration.test.ts b/apps/server/src/orchestration-v2/testkit/OrchestratorReplayRecovery.integration.test.ts
new file mode 100644
index 000000000000..f5c4feea07f3
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/OrchestratorReplayRecovery.integration.test.ts
@@ -0,0 +1,292 @@
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import { assert, describe, it } from "@effect/vitest";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Layer from "effect/Layer";
+import * as Path from "effect/Path";
+import * as Schema from "effect/Schema";
+import * as CodexReplay from "effect-codex-app-server/replay";
+import { ProviderDriverKind } from "@t3tools/contracts";
+
+import {
+  CodexOrchestratorReplayHarness,
+  makeCodexProviderAdapterRegistryReplayLayer,
+} from "../Adapters/CodexAdapterV2.testkit.ts";
+import {
+  type CursorAgentSdkReplayTranscript,
+  CursorOrchestratorReplayHarness,
+  makeCursorAgentSdkReplayRunner,
+  makeCursorProviderAdapterRegistryReplayLayer,
+} from "../Adapters/CursorAdapterV2.testkit.ts";
+import { layer as idAllocatorLayer } from "../IdAllocator.ts";
+import { makeSqlitePersistenceLive } from "../../persistence/Layers/Sqlite.ts";
+import { provideDeterministicTestRuntime } from "./DeterministicRuntime.ts";
+import {
+  CODEX_MODEL_SELECTION,
+  CURSOR_MODEL_SELECTION,
+  materializeFixtureInput,
+  type MaterializedOrchestratorFixtureInput,
+  PROVIDER_THREAD_RESUME_FIRST_PROMPT,
+  PROVIDER_THREAD_RESUME_SECOND_PROMPT,
+} from "./fixtures/shared.ts";
+import {
+  assertAssistantTextIncludes,
+  assertBaseProjection,
+  assertConversationMessageRoles,
+  assertRunOrdinals,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessagesInclude,
+  projectionFor,
+} from "./fixtures/shared.ts";
+import { runOrchestratorV2ProviderReplayScenario } from "./ProviderReplayHarness.ts";
+import { checkpointWorkspace } from "./ReplayFixtureWorkspace.ts";
+import {
+  decodeProviderReplayNdjson,
+  materializeReplayTranscriptWorkspace,
+} from "./ReplayTranscriptNdjson.ts";
+
+const FIRST_FINAL = "provider thread resume fixture first turn complete";
+const SECOND_FINAL = "provider thread resume fixture second turn complete";
+
+const decodeCodexTranscript = Schema.decodeUnknownEffect(
+  CodexReplay.CodexAppServerReplayTranscript,
+);
+const readRawTranscript = Effect.fn("readRecoveryTranscript")(function* (file: URL) {
+  const fs = yield* FileSystem.FileSystem;
+  const text = yield* fs.readFileString(decodeURIComponent(file.pathname));
+  return yield* decodeProviderReplayNdjson(text);
+});
+const readCodexTranscript = Effect.fn("readCodexRecoveryTranscript")(function* (workspace: string) {
+  const transcript = yield* readRawTranscript(
+    new URL("./fixtures/provider_thread_resume/codex_transcript.ndjson", import.meta.url),
+  );
+  return yield* decodeCodexTranscript(materializeReplayTranscriptWorkspace(transcript, workspace));
+});
+const readCursorTranscript = Effect.fn("readCursorRecoveryTranscript")(function* () {
+  const transcript = yield* readRawTranscript(
+    new URL("./fixtures/provider_thread_resume/cursor_transcript.ndjson", import.meta.url),
+  );
+  return yield* CursorOrchestratorReplayHarness.decodeTranscript(transcript);
+});
+
+function splitAfterFirstIdle(materialized: MaterializedOrchestratorFixtureInput) {
+  const splitIndex = materialized.steps.findIndex((step) => step.type === "await_thread_idle");
+  if (splitIndex < 0) {
+    throw new Error("Expected fixture to contain await_thread_idle after the first turn.");
+  }
+
+  const phase1Steps = materialized.steps.slice(0, splitIndex + 1);
+  const phase2Steps = materialized.steps.slice(splitIndex + 1);
+  return {
+    phase1Steps,
+    phase2Steps,
+    phase1Commands: phase1Steps.flatMap((step) => (step.type === "dispatch" ? [step.command] : [])),
+    phase2Commands: phase2Steps.flatMap((step) => (step.type === "dispatch" ? [step.command] : [])),
+  };
+}
+
+const runCursorRecovery = Effect.fn("runCursorRecovery")(function* (input: {
+  readonly transcript: CursorAgentSdkReplayTranscript;
+  readonly runner: ReturnType<typeof makeCursorAgentSdkReplayRunner>;
+}) {
+  const fs = yield* FileSystem.FileSystem;
+  const path = yield* Path.Path;
+  const tempDir = yield* Effect.acquireRelease(
+    fs.makeTempDirectory({
+      prefix: "t3-orchestration-v2-cursor-recovery-",
+    }),
+    (directory) => fs.remove(directory, { recursive: true, force: true }).pipe(Effect.orDie),
+  );
+  yield* fs.makeDirectory(tempDir, { recursive: true });
+  const dbPath = path.join(tempDir, "state.sqlite");
+  const materialized = yield* materializeFixtureInput({
+    scenario: "provider_thread_resume",
+    fixtureInput: {
+      steps: [
+        { type: "message", text: PROVIDER_THREAD_RESUME_FIRST_PROMPT },
+        { type: "message", text: PROVIDER_THREAD_RESUME_SECOND_PROMPT },
+      ],
+    },
+    driver: ProviderDriverKind.make("cursor"),
+    modelSelection: CURSOR_MODEL_SELECTION,
+  });
+  const { phase1Commands, phase1Steps, phase2Commands, phase2Steps } =
+    splitAfterFirstIdle(materialized);
+  const options = {
+    databaseLayer: makeSqlitePersistenceLive(dbPath).pipe(Layer.provide(NodeServices.layer)),
+  };
+  const harness = {
+    ...CursorOrchestratorReplayHarness,
+    makeProviderAdapterRegistryLayer: () =>
+      makeCursorProviderAdapterRegistryReplayLayer(input.transcript, {
+        runner: input.runner,
+        assertCompleteOnFinalize: false,
+      }),
+  };
+
+  yield* Effect.scoped(
+    runOrchestratorV2ProviderReplayScenario(
+      {
+        name: "provider_thread_resume/cursor:first-runtime",
+        transcript: input.transcript,
+        commands: phase1Commands,
+        steps: phase1Steps,
+        projectionThreadIds: materialized.projectionThreadIds,
+        runtimePolicyOverride: { cwd: tempDir },
+      },
+      harness,
+      options,
+    ),
+  );
+
+  const result = yield* Effect.scoped(
+    runOrchestratorV2ProviderReplayScenario(
+      {
+        name: "provider_thread_resume/cursor:second-runtime",
+        transcript: input.transcript,
+        commands: phase2Commands,
+        steps: phase2Steps,
+        projectionThreadIds: materialized.projectionThreadIds,
+        runtimePolicyOverride: { cwd: tempDir },
+      },
+      harness,
+      options,
+    ),
+  );
+
+  assertBaseProjection({
+    result,
+    transcript: input.transcript,
+    runCount: 2,
+    runStatuses: ["completed", "completed"],
+  });
+  const projection = projectionFor(result, input.transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertRunOrdinals(projection, [1, 2]);
+  assertConversationMessageRoles(projection, ["user", "assistant", "user", "assistant"]);
+  assertTurnItemTypes(projection, ["user_message", "assistant_message"]);
+  assertUserMessagesInclude(projection, [
+    PROVIDER_THREAD_RESUME_FIRST_PROMPT,
+    PROVIDER_THREAD_RESUME_SECOND_PROMPT,
+  ]);
+  assertAssistantTextIncludes(projection, FIRST_FINAL);
+  assertAssistantTextIncludes(projection, SECOND_FINAL);
+  assert.lengthOf(projection.providerThreads, 1);
+});
+
+describe("orchestrator replay recovery", () => {
+  it.effect(
+    "resumes a provider-native Codex thread after recreating the orchestrator runtime",
+    () =>
+      Effect.scoped(
+        Effect.gen(function* () {
+          // Checkpoint against a throwaway git workspace: with no override the
+          // scope cwd falls back to process.cwd(), and a cold full-repo
+          // baseline capture on CI outlives the scenario wait budget.
+          const workspace = yield* checkpointWorkspace("provider_thread_resume");
+          const transcript = yield* readCodexTranscript(workspace);
+          const fs = yield* FileSystem.FileSystem;
+          const path = yield* Path.Path;
+          const tempDir = yield* Effect.acquireRelease(
+            fs.makeTempDirectory({
+              prefix: "t3-orchestration-v2-recovery-",
+            }),
+            (directory) =>
+              fs.remove(directory, { recursive: true, force: true }).pipe(Effect.orDie),
+          );
+          yield* fs.makeDirectory(tempDir, { recursive: true });
+          const dbPath = path.join(tempDir, "state.sqlite");
+          const driver = yield* CodexReplay.makeReplayDriver(transcript);
+          const materialized = yield* materializeFixtureInput({
+            scenario: "provider_thread_resume",
+            fixtureInput: {
+              steps: [
+                { type: "message", text: PROVIDER_THREAD_RESUME_FIRST_PROMPT },
+                { type: "message", text: PROVIDER_THREAD_RESUME_SECOND_PROMPT },
+              ],
+            },
+            driver: ProviderDriverKind.make("codex"),
+            modelSelection: CODEX_MODEL_SELECTION,
+          });
+          const { phase1Commands, phase1Steps, phase2Commands, phase2Steps } =
+            splitAfterFirstIdle(materialized);
+
+          const harness = {
+            ...CodexOrchestratorReplayHarness,
+            makeProviderAdapterRegistryLayer: () =>
+              makeCodexProviderAdapterRegistryReplayLayer({ transcript, driver }),
+          };
+          const options = {
+            databaseLayer: makeSqlitePersistenceLive(dbPath).pipe(
+              Layer.provide(NodeServices.layer),
+            ),
+          };
+
+          yield* runOrchestratorV2ProviderReplayScenario(
+            {
+              name: "provider_thread_resume/codex:first-runtime",
+              transcript,
+              commands: phase1Commands,
+              steps: phase1Steps,
+              projectionThreadIds: materialized.projectionThreadIds,
+              runtimePolicyOverride: { cwd: workspace },
+            },
+            harness,
+            options,
+          );
+
+          const result = yield* runOrchestratorV2ProviderReplayScenario(
+            {
+              name: "provider_thread_resume/codex:second-runtime",
+              transcript,
+              commands: phase2Commands,
+              steps: phase2Steps,
+              projectionThreadIds: materialized.projectionThreadIds,
+              runtimePolicyOverride: { cwd: workspace },
+            },
+            harness,
+            options,
+          );
+
+          assertBaseProjection({
+            result,
+            transcript,
+            runCount: 2,
+            runStatuses: ["completed", "completed"],
+          });
+          const projection = projectionFor(result, transcript.scenario);
+          assertSemanticProjectionIntegrity(projection);
+          assertRunOrdinals(projection, [1, 2]);
+          assertConversationMessageRoles(projection, ["user", "assistant", "user", "assistant"]);
+          assertTurnItemTypes(projection, ["user_message", "assistant_message"]);
+          assertUserMessagesInclude(projection, [
+            PROVIDER_THREAD_RESUME_FIRST_PROMPT,
+            PROVIDER_THREAD_RESUME_SECOND_PROMPT,
+          ]);
+          assertAssistantTextIncludes(projection, FIRST_FINAL);
+          assertAssistantTextIncludes(projection, SECOND_FINAL);
+          assert.lengthOf(projection.providerThreads, 1);
+        }).pipe(
+          provideDeterministicTestRuntime,
+          Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer)),
+        ),
+      ),
+  );
+
+  it.effect(
+    "resumes a provider-native Cursor thread after recreating the orchestrator runtime",
+    () =>
+      Effect.scoped(
+        Effect.gen(function* () {
+          const transcript = yield* readCursorTranscript();
+          const runner = makeCursorAgentSdkReplayRunner(transcript);
+          yield* runCursorRecovery({ transcript, runner });
+          yield* runner.assertComplete;
+        }).pipe(
+          provideDeterministicTestRuntime,
+          Effect.provide(Layer.merge(idAllocatorLayer, NodeServices.layer)),
+        ),
+      ),
+  );
+});
diff --git a/apps/server/src/orchestration-v2/testkit/OrchestratorScenario.ts b/apps/server/src/orchestration-v2/testkit/OrchestratorScenario.ts
new file mode 100644
index 000000000000..a2e4a0661038
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/OrchestratorScenario.ts
@@ -0,0 +1,599 @@
+import type {
+  OrchestrationV2Command,
+  OrchestrationV2DomainEvent,
+  OrchestrationV2RuntimeRequest,
+  OrchestrationV2Run,
+  OrchestrationV2ThreadShellSnapshot,
+  OrchestrationV2StoredEvent,
+  OrchestrationV2ThreadProjection,
+  OrchestrationV2TurnItem,
+  ProviderApprovalDecision,
+  ProviderUserInputAnswers,
+  CommandId,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as Fiber from "effect/Fiber";
+import * as Ref from "effect/Ref";
+import * as Schema from "effect/Schema";
+import * as Stream from "effect/Stream";
+import { TestClock } from "effect/testing";
+
+import { OrchestratorV2, type OrchestratorV2Error } from "../Orchestrator.ts";
+import type { ProviderReplayGate } from "./ProviderReplayGate.testkit.ts";
+
+export type OrchestratorV2ScenarioStep =
+  | {
+      readonly type: "dispatch";
+      readonly command: OrchestrationV2Command;
+      readonly await?: boolean;
+      readonly key?: string;
+    }
+  | {
+      readonly type: "advance_clock";
+      readonly duration: Duration.Input;
+    }
+  | {
+      readonly type: "await";
+      readonly key: string;
+    }
+  | {
+      readonly type: "await_all";
+    }
+  | {
+      readonly type: "await_thread_idle";
+      readonly threadId: ThreadId;
+    }
+  | {
+      readonly type: "await_run_steerable";
+      readonly threadId: ThreadId;
+      readonly runId: OrchestrationV2Run["id"];
+    }
+  | {
+      readonly type: "await_run_status";
+      readonly threadId: ThreadId;
+      readonly runId: OrchestrationV2Run["id"];
+      readonly status: OrchestrationV2Run["status"];
+    }
+  | {
+      readonly type: "await_run_turn_item";
+      readonly threadId: ThreadId;
+      readonly runId: OrchestrationV2Run["id"];
+      readonly itemType: OrchestrationV2TurnItem["type"];
+    }
+  | {
+      readonly type: "release_replay_gate_after_waiting";
+      readonly label: string;
+      readonly threadId: ThreadId;
+      readonly runId: OrchestrationV2Run["id"];
+    }
+  | {
+      readonly type: "release_replay_gate";
+      readonly label: string;
+    }
+  | {
+      readonly type: "capture_shell_snapshot";
+      readonly key: string;
+    }
+  | {
+      readonly type: "respond_to_next_runtime_request";
+      readonly threadId: ThreadId;
+      readonly commandId: CommandId;
+      readonly decision?: ProviderApprovalDecision;
+      readonly answers?: ProviderUserInputAnswers;
+    };
+
+export interface OrchestratorV2Scenario {
+  readonly name: string;
+  readonly commands: ReadonlyArray<OrchestrationV2Command>;
+  readonly steps?: ReadonlyArray<OrchestratorV2ScenarioStep>;
+  readonly projectionThreadIds?: ReadonlyArray<ThreadId>;
+}
+
+export interface OrchestratorV2ScenarioResult {
+  readonly storedEvents: ReadonlyArray<OrchestrationV2StoredEvent>;
+  readonly domainEvents: ReadonlyArray<OrchestrationV2DomainEvent>;
+  readonly projections: ReadonlyMap<ThreadId, OrchestrationV2ThreadProjection>;
+  readonly shellSnapshot: OrchestrationV2ThreadShellSnapshot;
+  readonly capturedShellSnapshots: ReadonlyMap<string, OrchestrationV2ThreadShellSnapshot>;
+}
+
+export class OrchestratorV2ScenarioStepError extends Schema.TaggedErrorClass<OrchestratorV2ScenarioStepError>()(
+  "OrchestratorV2ScenarioStepError",
+  {
+    scenario: Schema.String,
+    step: Schema.String,
+  },
+) {
+  override get message(): string {
+    return `Invalid orchestrator scenario step ${this.step} in ${this.scenario}.`;
+  }
+}
+
+function commandThreadIds(command: OrchestrationV2Command): ReadonlyArray<ThreadId> {
+  switch (command.type) {
+    case "thread.create":
+    case "thread.archive":
+    case "thread.unarchive":
+    case "thread.delete":
+    case "thread.settle":
+    case "thread.unsettle":
+    case "thread.snooze":
+    case "thread.unsnooze":
+    case "thread.pin":
+    case "thread.unpin":
+    case "thread.pin.reorder":
+    case "thread.visit":
+    case "thread.mark-unread":
+    case "thread.metadata.update":
+    case "thread.title.regeneration.complete":
+    case "thread.runtime-mode.set":
+    case "thread.interaction-mode.set":
+    case "thread.model-selection.set":
+    case "provider-session.detach":
+    case "message.dispatch":
+    case "prepared-run.release":
+    case "prepared-run.progress":
+    case "prepared-run.fail":
+    case "run.interrupt":
+    case "queued-message.promote-to-steer":
+    case "queued-run.reorder":
+    case "queued-run.cancel":
+    case "queued-run.edit":
+    case "runtime-request.respond":
+    case "checkpoint.rollback":
+    case "provider.switch":
+      return [command.threadId];
+    case "delegated_task.request":
+    case "delegated_task.wake-policy":
+    case "delegated_task.completion-delivery.acknowledge":
+    case "delegated_task.completion-delivery.dispose":
+    case "thread.created.record":
+      return [command.parentThreadId];
+    case "thread.fork":
+    case "thread.merge_back":
+      return [command.sourceThreadId, command.targetThreadId];
+  }
+}
+
+function scenarioSteps(
+  scenario: OrchestratorV2Scenario,
+): ReadonlyArray<OrchestratorV2ScenarioStep> {
+  return (
+    scenario.steps ??
+    scenario.commands.map((command) => ({
+      type: "dispatch" as const,
+      command,
+      await: true,
+    }))
+  );
+}
+
+function scenarioCommands(scenario: OrchestratorV2Scenario): ReadonlyArray<OrchestrationV2Command> {
+  return scenarioSteps(scenario).flatMap((step) =>
+    step.type === "dispatch" ? [step.command] : [],
+  );
+}
+
+const findPendingRuntimeRequest = (projection: OrchestrationV2ThreadProjection) =>
+  projection.runtimeRequests.find((request) => request.status === "pending");
+
+const hasActiveRun = (projection: OrchestrationV2ThreadProjection) =>
+  projection.runs.some((run) =>
+    ["preparing", "queued", "starting", "running", "waiting"].includes(run.status),
+  );
+
+const SCENARIO_WAIT_ATTEMPTS = 10_000;
+// Iterations count event-loop turns, not time: while async work (git
+// subprocesses, fixture IO) is in flight the loop is idle and the counter
+// burns at full speed on slow runners. A wait is exhausted only once BOTH
+// the iteration budget and this wall-clock deadline are spent.
+const SCENARIO_WAIT_DEADLINE_MS = 60_000;
+const scenarioWaitDeadline = () => performance.now() + SCENARIO_WAIT_DEADLINE_MS;
+const scenarioWaitExhausted = (attemptsRemaining: number, deadlineAt: number) =>
+  attemptsRemaining <= 0 && performance.now() >= deadlineAt;
+
+const yieldToRuntime = Effect.yieldNow.pipe(
+  Effect.andThen(
+    Effect.promise(
+      () =>
+        new Promise<void>((resolve) => {
+          setImmediate(resolve);
+        }),
+    ),
+  ),
+);
+
+function collectProjectionThreadIds(scenario: OrchestratorV2Scenario): ReadonlyArray<ThreadId> {
+  if (scenario.projectionThreadIds) {
+    return scenario.projectionThreadIds;
+  }
+
+  const ids = new Set<ThreadId>();
+  for (const command of scenarioCommands(scenario)) {
+    for (const threadId of commandThreadIds(command)) {
+      ids.add(threadId);
+    }
+  }
+  return Array.from(ids);
+}
+
+export function runOrchestratorV2Scenario(
+  scenario: OrchestratorV2Scenario,
+  options: {
+    readonly replayGate?: ProviderReplayGate;
+  } = {},
+): Effect.Effect<
+  OrchestratorV2ScenarioResult,
+  OrchestratorV2Error | OrchestratorV2ScenarioStepError,
+  OrchestratorV2
+> {
+  return Effect.scoped(
+    Effect.gen(function* () {
+      const orchestrator = yield* OrchestratorV2;
+      const storedEventGroups: Array<ReadonlyArray<OrchestrationV2StoredEvent>> = [];
+      const observedStoredEvents = yield* Ref.make<Array<OrchestrationV2StoredEvent>>([]);
+      yield* orchestrator.streamStoredEvents.pipe(
+        Stream.runForEach((event) =>
+          Ref.update(observedStoredEvents, (existing) => [...existing, event]),
+        ),
+        Effect.forkScoped,
+      );
+      const backgroundDispatches = new Map<
+        string,
+        Fiber.Fiber<ReadonlyArray<OrchestrationV2StoredEvent>, OrchestratorV2Error>
+      >();
+      const capturedShellSnapshots = new Map<string, OrchestrationV2ThreadShellSnapshot>();
+      let anonymousBackgroundDispatchIndex = 0;
+
+      const awaitDispatch = (key: string) =>
+        Effect.gen(function* () {
+          const fiber = backgroundDispatches.get(key);
+          if (!fiber) {
+            return yield* new OrchestratorV2ScenarioStepError({
+              scenario: scenario.name,
+              step: `await:${key}`,
+            });
+          }
+          const events = yield* Fiber.join(fiber);
+          backgroundDispatches.delete(key);
+          storedEventGroups.push(events);
+        });
+
+      const waitForPendingRuntimeRequest = (
+        threadId: ThreadId,
+        attemptsRemaining = SCENARIO_WAIT_ATTEMPTS,
+        deadlineAt = scenarioWaitDeadline(),
+      ): Effect.Effect<
+        OrchestrationV2RuntimeRequest,
+        OrchestratorV2Error | OrchestratorV2ScenarioStepError,
+        never
+      > =>
+        Effect.gen(function* () {
+          const projection = yield* orchestrator.getThreadProjection(threadId);
+          const request = findPendingRuntimeRequest(projection);
+          if (request !== undefined) {
+            return request;
+          }
+          if (scenarioWaitExhausted(attemptsRemaining, deadlineAt)) {
+            const runState = projection.runs.map((run) => `${run.id}:${run.status}`).join(",");
+            return yield* new OrchestratorV2ScenarioStepError({
+              scenario: scenario.name,
+              step: `respond_to_next_runtime_request:${threadId}:runs=${runState}:providerTurns=${projection.providerTurns.length}`,
+            });
+          }
+          yield* yieldToRuntime;
+          return yield* waitForPendingRuntimeRequest(threadId, attemptsRemaining - 1, deadlineAt);
+        });
+
+      const waitForThreadIdle = (
+        threadId: ThreadId,
+        attemptsRemaining = SCENARIO_WAIT_ATTEMPTS,
+        deadlineAt = scenarioWaitDeadline(),
+      ): Effect.Effect<void, OrchestratorV2Error | OrchestratorV2ScenarioStepError, never> =>
+        Effect.gen(function* () {
+          const projection = yield* orchestrator.getThreadProjection(threadId);
+          if (!hasActiveRun(projection)) {
+            return;
+          }
+          if (scenarioWaitExhausted(attemptsRemaining, deadlineAt)) {
+            const activeRuns = projection.runs
+              .filter((run) =>
+                ["preparing", "queued", "starting", "running", "waiting"].includes(run.status),
+              )
+              .map((run) => `${run.id}:${run.status}`)
+              .join(",");
+            const pendingRequests = projection.runtimeRequests
+              .filter((request) => request.status === "pending")
+              .map((request) => `${request.id}:${request.kind}`)
+              .join(",");
+            return yield* new OrchestratorV2ScenarioStepError({
+              scenario: scenario.name,
+              step: `await_thread_idle:${threadId}:runs=${activeRuns}:requests=${pendingRequests}`,
+            });
+          }
+          yield* yieldToRuntime;
+          return yield* waitForThreadIdle(threadId, attemptsRemaining - 1, deadlineAt);
+        });
+
+      const waitForRunSteerable = (
+        threadId: ThreadId,
+        runId: OrchestrationV2Run["id"],
+        attemptsRemaining = SCENARIO_WAIT_ATTEMPTS,
+        deadlineAt = scenarioWaitDeadline(),
+      ): Effect.Effect<void, OrchestratorV2Error | OrchestratorV2ScenarioStepError, never> =>
+        Effect.gen(function* () {
+          const projection = yield* orchestrator.getThreadProjection(threadId);
+          const run = projection.runs.find((candidate) => candidate.id === runId);
+          const providerTurn = projection.providerTurns.find(
+            (candidate) =>
+              run?.activeAttemptId !== null &&
+              candidate.runAttemptId === run?.activeAttemptId &&
+              candidate.status === "running",
+          );
+          if (run?.status === "running" && providerTurn !== undefined) {
+            return;
+          }
+          if (scenarioWaitExhausted(attemptsRemaining, deadlineAt)) {
+            return yield* new OrchestratorV2ScenarioStepError({
+              scenario: scenario.name,
+              step: `await_run_steerable:${runId}`,
+            });
+          }
+          yield* yieldToRuntime;
+          return yield* waitForRunSteerable(threadId, runId, attemptsRemaining - 1, deadlineAt);
+        });
+
+      const waitForRunStatus = (
+        threadId: ThreadId,
+        runId: OrchestrationV2Run["id"],
+        status: OrchestrationV2Run["status"],
+        attemptsRemaining = SCENARIO_WAIT_ATTEMPTS,
+        deadlineAt = scenarioWaitDeadline(),
+      ): Effect.Effect<void, OrchestratorV2Error | OrchestratorV2ScenarioStepError, never> =>
+        Effect.gen(function* () {
+          const projection = yield* orchestrator.getThreadProjection(threadId);
+          const run = projection.runs.find((candidate) => candidate.id === runId);
+          if (run?.status === status) {
+            return;
+          }
+          if (scenarioWaitExhausted(attemptsRemaining, deadlineAt)) {
+            return yield* new OrchestratorV2ScenarioStepError({
+              scenario: scenario.name,
+              step: `await_run_status:${runId}:${status}:actual=${run?.status ?? "missing"}`,
+            });
+          }
+          yield* yieldToRuntime;
+          return yield* waitForRunStatus(
+            threadId,
+            runId,
+            status,
+            attemptsRemaining - 1,
+            deadlineAt,
+          );
+        });
+
+      const waitForRunTurnItem = (
+        threadId: ThreadId,
+        runId: OrchestrationV2Run["id"],
+        itemType: OrchestrationV2TurnItem["type"],
+        attemptsRemaining = SCENARIO_WAIT_ATTEMPTS,
+        deadlineAt = scenarioWaitDeadline(),
+      ): Effect.Effect<void, OrchestratorV2Error | OrchestratorV2ScenarioStepError, never> =>
+        Effect.gen(function* () {
+          const projection = yield* orchestrator.getThreadProjection(threadId);
+          const hasTurnItem = projection.turnItems.some(
+            (item) => item.runId === runId && item.type === itemType,
+          );
+          if (hasTurnItem) {
+            return;
+          }
+          if (scenarioWaitExhausted(attemptsRemaining, deadlineAt)) {
+            return yield* new OrchestratorV2ScenarioStepError({
+              scenario: scenario.name,
+              step: `await_run_turn_item:${runId}:${itemType}`,
+            });
+          }
+          yield* yieldToRuntime;
+          return yield* waitForRunTurnItem(
+            threadId,
+            runId,
+            itemType,
+            attemptsRemaining - 1,
+            deadlineAt,
+          );
+        });
+
+      const releaseReplayGateAfterWaiting = (
+        label: string,
+        threadId: ThreadId,
+        runId: OrchestrationV2Run["id"],
+        attemptsRemaining = SCENARIO_WAIT_ATTEMPTS,
+      ): Effect.Effect<void, OrchestratorV2Error | OrchestratorV2ScenarioStepError, never> =>
+        Effect.gen(function* () {
+          const projection = yield* orchestrator.getThreadProjection(threadId);
+          const run = projection.runs.find((candidate) => candidate.id === runId);
+          const providerThread = projection.providerThreads.find(
+            (candidate) => candidate.id === run?.providerThreadId,
+          );
+          const pendingTaskCount = providerThread?.pendingBackgroundTasks?.length ?? 0;
+          const gateReached = options.replayGate?.hasReached(label) ?? false;
+          if (
+            gateReached &&
+            run?.status === "completed" &&
+            providerThread !== undefined &&
+            pendingTaskCount > 0
+          ) {
+            options.replayGate?.release(label);
+            yield* waitForProviderBackgroundTasksCleared(threadId, providerThread.id);
+            return;
+          }
+          if (attemptsRemaining <= 0) {
+            options.replayGate?.release(label);
+            return yield* new OrchestratorV2ScenarioStepError({
+              scenario: scenario.name,
+              step: `release_replay_gate_after_waiting:${label}:reached=${gateReached}:run=${run?.status ?? "missing"}:providerThread=${run?.providerThreadId ?? "missing"}:pending=${pendingTaskCount}`,
+            });
+          }
+          yield* yieldToRuntime;
+          return yield* releaseReplayGateAfterWaiting(
+            label,
+            threadId,
+            runId,
+            attemptsRemaining - 1,
+          );
+        });
+
+      const waitForProviderBackgroundTasksCleared = (
+        threadId: ThreadId,
+        providerThreadId: NonNullable<OrchestrationV2Run["providerThreadId"]>,
+        attemptsRemaining = SCENARIO_WAIT_ATTEMPTS,
+      ): Effect.Effect<void, OrchestratorV2Error | OrchestratorV2ScenarioStepError, never> =>
+        Effect.gen(function* () {
+          const projection = yield* orchestrator.getThreadProjection(threadId);
+          const providerThread = projection.providerThreads.find(
+            (candidate) => candidate.id === providerThreadId,
+          );
+          const hasPendingTasks = (providerThread?.pendingBackgroundTasks?.length ?? 0) > 0;
+          if (!hasPendingTasks && providerThread?.status === "idle") {
+            return;
+          }
+          if (attemptsRemaining <= 0) {
+            const providerState = projection.providerThreads
+              .map(
+                (candidate) =>
+                  `${candidate.id}:${candidate.status}:pending=${candidate.pendingBackgroundTasks?.length ?? 0}`,
+              )
+              .join(",");
+            return yield* new OrchestratorV2ScenarioStepError({
+              scenario: scenario.name,
+              step: `await_provider_background_tasks_cleared:${threadId}:target=${providerThreadId}:providers=${providerState}`,
+            });
+          }
+          yield* yieldToRuntime;
+          return yield* waitForProviderBackgroundTasksCleared(
+            threadId,
+            providerThreadId,
+            attemptsRemaining - 1,
+          );
+        });
+
+      const releaseReplayGate = (
+        label: string,
+        attemptsRemaining = SCENARIO_WAIT_ATTEMPTS,
+      ): Effect.Effect<void, OrchestratorV2ScenarioStepError> =>
+        Effect.gen(function* () {
+          if (options.replayGate?.hasReached(label) ?? false) {
+            options.replayGate?.release(label);
+            return;
+          }
+          if (attemptsRemaining <= 0) {
+            options.replayGate?.release(label);
+            return yield* new OrchestratorV2ScenarioStepError({
+              scenario: scenario.name,
+              step: `release_replay_gate:${label}:reached=false`,
+            });
+          }
+          yield* yieldToRuntime;
+          return yield* releaseReplayGate(label, attemptsRemaining - 1);
+        });
+
+      for (const step of scenarioSteps(scenario)) {
+        switch (step.type) {
+          case "dispatch": {
+            if (step.await ?? true) {
+              const result = yield* orchestrator.dispatch(step.command);
+              storedEventGroups.push(result.storedEvents);
+              break;
+            }
+
+            anonymousBackgroundDispatchIndex += 1;
+            const key = step.key ?? `dispatch:${anonymousBackgroundDispatchIndex}`;
+            backgroundDispatches.set(
+              key,
+              yield* orchestrator.dispatch(step.command).pipe(
+                Effect.map((result) => result.storedEvents),
+                Effect.forkScoped,
+              ),
+            );
+            break;
+          }
+          case "advance_clock":
+            yield* TestClock.adjust(step.duration);
+            break;
+          case "await":
+            yield* awaitDispatch(step.key);
+            break;
+          case "await_all":
+            for (const key of Array.from(backgroundDispatches.keys())) {
+              yield* awaitDispatch(key);
+            }
+            break;
+          case "await_thread_idle":
+            yield* waitForThreadIdle(step.threadId);
+            break;
+          case "await_run_steerable":
+            yield* waitForRunSteerable(step.threadId, step.runId);
+            break;
+          case "await_run_status":
+            yield* waitForRunStatus(step.threadId, step.runId, step.status);
+            break;
+          case "await_run_turn_item":
+            yield* waitForRunTurnItem(step.threadId, step.runId, step.itemType);
+            break;
+          case "release_replay_gate_after_waiting":
+            yield* releaseReplayGateAfterWaiting(step.label, step.threadId, step.runId);
+            break;
+          case "release_replay_gate":
+            yield* releaseReplayGate(step.label);
+            break;
+          case "capture_shell_snapshot":
+            capturedShellSnapshots.set(step.key, yield* orchestrator.getShellSnapshot());
+            break;
+          case "respond_to_next_runtime_request": {
+            const request = yield* waitForPendingRuntimeRequest(step.threadId);
+            const result = yield* orchestrator.dispatch({
+              type: "runtime-request.respond",
+              commandId: step.commandId,
+              threadId: step.threadId,
+              requestId: request.id,
+              ...(step.decision === undefined ? {} : { decision: step.decision }),
+              ...(step.answers === undefined ? {} : { answers: step.answers }),
+            });
+            storedEventGroups.push(result.storedEvents);
+            break;
+          }
+        }
+      }
+
+      for (const key of Array.from(backgroundDispatches.keys())) {
+        yield* awaitDispatch(key);
+      }
+
+      const shellSnapshot = yield* orchestrator.getShellSnapshot();
+      const projectionThreadIds = new Set(collectProjectionThreadIds(scenario));
+      for (const thread of shellSnapshot.threads) {
+        projectionThreadIds.add(thread.id);
+      }
+      const projections = new Map<ThreadId, OrchestrationV2ThreadProjection>();
+      for (const threadId of projectionThreadIds) {
+        projections.set(threadId, yield* orchestrator.getThreadProjection(threadId));
+      }
+
+      yield* Effect.yieldNow;
+
+      const observedEvents = yield* Ref.get(observedStoredEvents);
+      const storedEvents = (
+        observedEvents.length > 0 ? observedEvents : storedEventGroups.flat()
+      ).toSorted((left, right) => left.sequence - right.sequence);
+      return {
+        storedEvents,
+        domainEvents: storedEvents.map((stored) => stored.event),
+        projections,
+        shellSnapshot,
+        capturedShellSnapshots,
+      };
+    }),
+  );
+}
diff --git a/apps/server/src/orchestration-v2/testkit/ProviderReplayGate.testkit.test.ts b/apps/server/src/orchestration-v2/testkit/ProviderReplayGate.testkit.test.ts
new file mode 100644
index 000000000000..371badcec069
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/ProviderReplayGate.testkit.test.ts
@@ -0,0 +1,17 @@
+import { describe, expect, it } from "vite-plus/test";
+
+import { makeProviderReplayGate } from "./ProviderReplayGate.testkit.ts";
+
+describe("ProviderReplayGate", () => {
+  it("stops waiting when the replay consumer is interrupted", async () => {
+    const label = "held-frame";
+    const gate = makeProviderReplayGate([label]);
+    const controller = new AbortController();
+    const waiting = gate.beforeEmit(label, controller.signal);
+
+    expect(gate.hasReached(label)).toBe(true);
+    controller.abort();
+    await waiting;
+    expect(gate.release(label)).toBe(true);
+  });
+});
diff --git a/apps/server/src/orchestration-v2/testkit/ProviderReplayGate.testkit.ts b/apps/server/src/orchestration-v2/testkit/ProviderReplayGate.testkit.ts
new file mode 100644
index 000000000000..a9bbb3b9befd
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/ProviderReplayGate.testkit.ts
@@ -0,0 +1,78 @@
+export interface ProviderReplayGate {
+  readonly beforeEmit: (label: string | undefined, signal?: AbortSignal) => Promise<void>;
+  readonly hasReached: (label: string) => boolean;
+  readonly release: (label: string) => boolean;
+  readonly releaseAll: () => void;
+}
+
+interface GateState {
+  reached: boolean;
+  released: boolean;
+  readonly promise: Promise<void>;
+  readonly resolve: () => void;
+}
+
+export function makeProviderReplayGate(labels: ReadonlyArray<string>): ProviderReplayGate {
+  const states = new Map<string, GateState>();
+  for (const label of labels) {
+    if (states.has(label)) {
+      throw new Error(`Duplicate provider replay gate label ${label}.`);
+    }
+    let resolve = () => {};
+    const promise = new Promise<void>((resume) => {
+      resolve = resume;
+    });
+    states.set(label, {
+      reached: false,
+      released: false,
+      promise,
+      resolve,
+    });
+  }
+
+  return {
+    beforeEmit: (label, signal) => {
+      if (label === undefined) {
+        return Promise.resolve();
+      }
+      const state = states.get(label);
+      if (state === undefined) {
+        return Promise.resolve();
+      }
+      state.reached = true;
+      if (signal === undefined) {
+        return state.promise;
+      }
+      if (signal.aborted) {
+        return Promise.resolve();
+      }
+      return new Promise<void>((resolve) => {
+        const stopWaiting = () => resolve();
+        signal.addEventListener("abort", stopWaiting, { once: true });
+        void state.promise.then(() => {
+          signal.removeEventListener("abort", stopWaiting);
+          resolve();
+        });
+      });
+    },
+    hasReached: (label) => states.get(label)?.reached ?? false,
+    release: (label) => {
+      const state = states.get(label);
+      if (state === undefined || state.released) {
+        return false;
+      }
+      state.released = true;
+      state.resolve();
+      return true;
+    },
+    releaseAll: () => {
+      for (const state of states.values()) {
+        if (state.released) {
+          continue;
+        }
+        state.released = true;
+        state.resolve();
+      }
+    },
+  };
+}
diff --git a/apps/server/src/orchestration-v2/testkit/ProviderReplayHarness.ts b/apps/server/src/orchestration-v2/testkit/ProviderReplayHarness.ts
new file mode 100644
index 000000000000..42cbef3ff8cf
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/ProviderReplayHarness.ts
@@ -0,0 +1,413 @@
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import type { ProviderDriverKind, ProviderReplayTranscript } from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Layer from "effect/Layer";
+import * as Path from "effect/Path";
+import * as PlatformError from "effect/PlatformError";
+import type * as SqlClient from "effect/unstable/sql/SqlClient";
+import type { MigrationError } from "effect/unstable/sql/Migrator";
+import type { SqlError } from "effect/unstable/sql/SqlError";
+
+import * as CheckpointStore from "../../checkpointing/CheckpointStore.ts";
+import { ServerConfig } from "../../config.ts";
+import { SqlitePersistenceMemory } from "../../persistence/Layers/Sqlite.ts";
+import { ServerSettingsService } from "../../serverSettings.ts";
+import { layer as mcpSessionRegistryTestLayer } from "../../mcp/McpSessionRegistry.testkit.ts";
+import * as VcsDriverRegistry from "../../vcs/VcsDriverRegistry.ts";
+import * as VcsProcess from "../../vcs/VcsProcess.ts";
+import { layer as checkpointCaptureServiceLayer } from "../CheckpointCaptureService.ts";
+import { layer as checkpointServiceLayer } from "../CheckpointService.ts";
+import { layer as checkpointRollbackServiceLayer } from "../CheckpointRollbackService.ts";
+import { layer as commandPolicyLayer } from "../CommandPolicy.ts";
+import { layer as commandReceiptStoreLayer } from "../CommandReceiptStore.ts";
+import { layer as contextHandoffServiceLayer } from "../ContextHandoffService.ts";
+import { layer as effectOutboxLayer } from "../EffectOutbox.ts";
+import {
+  executorLayer as effectExecutorLayer,
+  layer as effectWorkerLayer,
+  runDaemon as runEffectWorkerDaemon,
+} from "../EffectWorker.ts";
+import { layerFromStores as eventSinkLayer } from "../EventSink.ts";
+import { layer as eventStoreLayer } from "../EventStore.ts";
+import { layer as idAllocatorLayer } from "../IdAllocator.ts";
+import { layer as orchestratorLayer } from "../Orchestrator.ts";
+import { layer as projectionStoreLayer } from "../ProjectionStore.ts";
+import { OrchestratorV2, type OrchestratorV2Error } from "../Orchestrator.ts";
+import { ProviderAdapterRegistryV2 } from "../ProviderAdapterRegistry.ts";
+import { layer as providerEventIngestorLayer } from "../ProviderEventIngestor.ts";
+import { layerWithOptions as providerSessionManagerLayerWithOptions } from "../ProviderSessionManager.ts";
+import { layer as providerSwitchServiceLayer } from "../ProviderSwitchService.ts";
+import { layer as providerTurnControlServiceLayer } from "../ProviderTurnControlService.ts";
+import { layer as providerTurnStartServiceLayer } from "../ProviderTurnStartService.ts";
+import { worktreeRepairDependenciesTestLayer } from "../ProviderTurnStartService.testkit.ts";
+import { layer as runExecutionServiceLayer } from "../RunExecutionService.ts";
+import { layer as runFinalizationServiceLayer } from "../RunFinalizationService.ts";
+import { ThreadTitleRegenerationService } from "../ThreadTitleRegenerationService.ts";
+import {
+  layer as runtimePolicyLayer,
+  layerWithOverride as runtimePolicyLayerWithOverride,
+  type RuntimePolicyV2Override,
+} from "../RuntimePolicy.ts";
+import { layer as turnItemPositionStoreLayer } from "../TurnItemPositionStore.ts";
+import { layer as runtimeRequestServiceLayer } from "../RuntimeRequestService.ts";
+import { layer as threadForkServiceLayer } from "../ThreadForkService.ts";
+import {
+  runOrchestratorV2Scenario,
+  type OrchestratorV2ScenarioStepError,
+  type OrchestratorV2Scenario,
+  type OrchestratorV2ScenarioResult,
+} from "./OrchestratorScenario.ts";
+import { makeProviderReplayGate, type ProviderReplayGate } from "./ProviderReplayGate.testkit.ts";
+
+export function makeReplayServerConfig(
+  scenario: string,
+): Effect.Effect<
+  ServerConfig["Service"],
+  PlatformError.PlatformError,
+  FileSystem.FileSystem | Path.Path
+> {
+  const safeScenario = scenario.replace(/[^a-z0-9_-]+/gi, "-");
+  return Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const baseDir = yield* fs.makeTempDirectory({
+      prefix: `t3-orchestration-v2-replay-${safeScenario}-`,
+    });
+    const stateDir = path.join(baseDir, "userdata");
+    const logsDir = path.join(stateDir, "logs");
+    const providerLogsDir = path.join(logsDir, "provider");
+    const terminalLogsDir = path.join(logsDir, "terminals");
+    const attachmentsDir = path.join(stateDir, "attachments");
+    const environmentThemesDir = path.join(stateDir, "themes");
+    const worktreesDir = path.join(baseDir, "worktrees");
+    const providerStatusCacheDir = path.join(baseDir, "caches");
+
+    for (const directory of [
+      stateDir,
+      logsDir,
+      providerLogsDir,
+      terminalLogsDir,
+      attachmentsDir,
+      environmentThemesDir,
+      worktreesDir,
+      providerStatusCacheDir,
+    ]) {
+      yield* fs.makeDirectory(directory, { recursive: true });
+    }
+
+    return {
+      logLevel: "Error",
+      traceMinLevel: "Info",
+      traceTimingEnabled: true,
+      traceBatchWindowMs: 200,
+      traceMaxBytes: 10 * 1024 * 1024,
+      traceMaxFiles: 10,
+      otlpTracesUrl: undefined,
+      otlpMetricsUrl: undefined,
+      otlpExportIntervalMs: 10_000,
+      otlpServiceName: "t3-server",
+      mode: "web",
+      port: 0,
+      host: undefined,
+      cwd: process.cwd(),
+      baseDir,
+      staticDir: undefined,
+      devUrl: undefined,
+      devAllowedOrigins: [],
+      noBrowser: false,
+      startupPresentation: "browser",
+      tailscaleServeEnabled: false,
+      tailscaleServePort: 443,
+      desktopBootstrapToken: undefined,
+      autoBootstrapProjectFromCwd: false,
+      logWebSocketEvents: false,
+      stateDir,
+      dbPath: path.join(stateDir, "state.sqlite"),
+      keybindingsConfigPath: path.join(stateDir, "keybindings.json"),
+      settingsPath: path.join(stateDir, "settings.json"),
+      providerStatusCacheDir,
+      worktreesDir,
+      attachmentsDir,
+      environmentThemesDir,
+      logsDir,
+      serverLogPath: path.join(logsDir, "server.log"),
+      serverTracePath: path.join(logsDir, "server.trace.ndjson"),
+      providerLogsDir,
+      providerEventLogPath: path.join(providerLogsDir, "events.log"),
+      terminalLogsDir,
+      anonymousIdPath: path.join(stateDir, "anonymous-id"),
+      environmentIdPath: path.join(stateDir, "environment-id"),
+      serverRuntimeStatePath: path.join(stateDir, "server-runtime.json"),
+      secretsDir: path.join(stateDir, "secrets"),
+    };
+  });
+}
+
+export interface OrchestratorV2ProviderReplayScenario<
+  Transcript extends ProviderReplayTranscript = ProviderReplayTranscript,
+> extends OrchestratorV2Scenario {
+  readonly transcript: Transcript;
+  readonly runtimePolicyOverride?: RuntimePolicyV2Override;
+}
+
+export interface OrchestratorV2ProviderReplayHarness<
+  Transcript extends ProviderReplayTranscript = ProviderReplayTranscript,
+  Error = never,
+> {
+  readonly driver: ProviderDriverKind;
+  readonly decodeTranscript: (
+    transcript: ProviderReplayTranscript,
+  ) => Effect.Effect<Transcript, Error>;
+  readonly makeProviderAdapterRegistryLayer: (
+    transcript: Transcript,
+    options?: { readonly replayGate?: ProviderReplayGate },
+  ) => Layer.Layer<ProviderAdapterRegistryV2, Error>;
+}
+
+export function runOrchestratorV2ProviderReplayScenario<
+  Transcript extends ProviderReplayTranscript,
+  Error,
+>(
+  scenario: OrchestratorV2ProviderReplayScenario<Transcript>,
+  harness: OrchestratorV2ProviderReplayHarness<Transcript, Error>,
+  options: {
+    readonly databaseLayer?: Layer.Layer<
+      SqlClient.SqlClient,
+      MigrationError | PlatformError.PlatformError | SqlError
+    >;
+    readonly enableLegacyTokenStreaming?: boolean;
+    readonly runEffectWorker?: boolean;
+  } = {},
+): Effect.Effect<
+  OrchestratorV2ScenarioResult,
+  | OrchestratorV2Error
+  | OrchestratorV2ScenarioStepError
+  | Error
+  | MigrationError
+  | PlatformError.PlatformError
+  | SqlError,
+  never
+> {
+  const replayGate = makeProviderReplayGate(
+    scenario.steps?.flatMap((step) =>
+      step.type === "release_replay_gate" || step.type === "release_replay_gate_after_waiting"
+        ? [step.label]
+        : [],
+    ) ?? [],
+  );
+  const layer = makeOrchestratorV2ProviderReplayLayer(scenario, harness, {
+    ...options,
+    replayGate,
+  });
+
+  return runOrchestratorV2Scenario(scenario, { replayGate }).pipe(Effect.provide(layer));
+}
+
+export function makeOrchestratorV2ProviderReplayLayer<
+  Transcript extends ProviderReplayTranscript,
+  Error,
+>(
+  scenario: OrchestratorV2ProviderReplayScenario<Transcript>,
+  harness: OrchestratorV2ProviderReplayHarness<Transcript, Error>,
+  options: {
+    readonly databaseLayer?: Layer.Layer<
+      SqlClient.SqlClient,
+      MigrationError | PlatformError.PlatformError | SqlError
+    >;
+    readonly enableLegacyTokenStreaming?: boolean;
+    readonly runEffectWorker?: boolean;
+    readonly replayGate?: ProviderReplayGate;
+  } = {},
+): Layer.Layer<OrchestratorV2, Error | MigrationError | PlatformError.PlatformError | SqlError> {
+  const registryLayer = harness.makeProviderAdapterRegistryLayer(
+    scenario.transcript,
+    options.replayGate === undefined ? {} : { replayGate: options.replayGate },
+  );
+  return makeOrchestratorV2ReplayLayerWithRegistry(scenario, registryLayer, options);
+}
+
+export function makeOrchestratorV2ReplayLayerWithRegistry<Error>(
+  scenario: Pick<OrchestratorV2ProviderReplayScenario, "name" | "runtimePolicyOverride">,
+  registryLayer: Layer.Layer<ProviderAdapterRegistryV2, Error>,
+  options: {
+    readonly databaseLayer?: Layer.Layer<
+      SqlClient.SqlClient,
+      MigrationError | PlatformError.PlatformError | SqlError
+    >;
+    readonly enableLegacyTokenStreaming?: boolean;
+    readonly runEffectWorker?: boolean;
+  } = {},
+): Layer.Layer<OrchestratorV2, Error | MigrationError | PlatformError.PlatformError | SqlError> {
+  const serverConfigLayer = Layer.effect(
+    ServerConfig,
+    makeReplayServerConfig(scenario.name).pipe(Effect.orDie),
+  ).pipe(Layer.provide(NodeServices.layer));
+  const runtimeLayer =
+    scenario.runtimePolicyOverride === undefined
+      ? runtimePolicyLayer
+      : runtimePolicyLayerWithOverride(scenario.runtimePolicyOverride).pipe(
+          Layer.provide(runtimePolicyLayer),
+        );
+  const databaseLayer = options.databaseLayer ?? SqlitePersistenceMemory;
+  const serverSettingsLayer = ServerSettingsService.layerTest({
+    enableLegacyTokenStreaming: options.enableLegacyTokenStreaming ?? false,
+  }).pipe(Layer.orDie);
+  const storesLayer = Layer.mergeAll(
+    eventStoreLayer,
+    projectionStoreLayer,
+    commandReceiptStoreLayer,
+    effectOutboxLayer,
+    turnItemPositionStoreLayer,
+  ).pipe(Layer.provide(databaseLayer));
+  const eventSinkProvided = eventSinkLayer.pipe(
+    Layer.provide(Layer.mergeAll(storesLayer, databaseLayer)),
+  );
+  const commandReceiptStoreProvided = commandReceiptStoreLayer.pipe(Layer.provide(databaseLayer));
+  const providerEventIngestorProvided = providerEventIngestorLayer.pipe(
+    Layer.provide(Layer.mergeAll(storesLayer, eventSinkProvided, idAllocatorLayer)),
+  );
+  const vcsDriverRegistryLayer = VcsDriverRegistry.layer.pipe(
+    Layer.provide(VcsProcess.layer),
+    Layer.provide(serverConfigLayer),
+    Layer.provide(NodeServices.layer),
+  );
+  const checkpointStoreLayer = CheckpointStore.layer.pipe(
+    Layer.provide(vcsDriverRegistryLayer),
+    Layer.provide(NodeServices.layer),
+  );
+  const checkpointServiceProvided = checkpointServiceLayer.pipe(
+    Layer.provide(Layer.mergeAll(checkpointStoreLayer, idAllocatorLayer)),
+  );
+  const contextHandoffServiceProvided = contextHandoffServiceLayer.pipe(
+    Layer.provide(idAllocatorLayer),
+  );
+  const persistenceLayer = Layer.mergeAll(
+    storesLayer,
+    eventSinkProvided,
+    commandReceiptStoreProvided,
+    idAllocatorLayer,
+    providerEventIngestorProvided,
+  );
+  const providerSessionManagerProvided = providerSessionManagerLayerWithOptions({
+    configureMcp: false,
+  }).pipe(
+    Layer.provide(
+      Layer.mergeAll(
+        registryLayer,
+        eventSinkProvided,
+        idAllocatorLayer,
+        mcpSessionRegistryTestLayer,
+        storesLayer,
+      ),
+    ),
+  );
+  const providerSwitchServiceProvided = providerSwitchServiceLayer.pipe(
+    Layer.provide(registryLayer),
+  );
+  const runExecutionServiceProvided = runExecutionServiceLayer.pipe(
+    Layer.provide(
+      Layer.mergeAll(
+        checkpointServiceProvided,
+        eventSinkProvided,
+        idAllocatorLayer,
+        providerEventIngestorProvided,
+        serverSettingsLayer,
+      ),
+    ),
+  );
+  const providerTurnStartServiceProvided = providerTurnStartServiceLayer.pipe(
+    Layer.provide(
+      Layer.mergeAll(
+        contextHandoffServiceProvided,
+        eventSinkProvided,
+        idAllocatorLayer,
+        storesLayer,
+        providerSessionManagerProvided,
+        runExecutionServiceProvided,
+        runtimeLayer,
+      ),
+    ),
+  );
+  const providerTurnControlServiceProvided = providerTurnControlServiceLayer.pipe(
+    Layer.provide(Layer.merge(storesLayer, providerSessionManagerProvided)),
+  );
+  const runtimeRequestServiceProvided = runtimeRequestServiceLayer.pipe(
+    Layer.provide(Layer.merge(storesLayer, providerSessionManagerProvided)),
+  );
+  const checkpointRollbackServiceProvided = checkpointRollbackServiceLayer.pipe(
+    Layer.provide(
+      Layer.mergeAll(
+        checkpointServiceProvided,
+        eventSinkProvided,
+        idAllocatorLayer,
+        storesLayer,
+        providerSessionManagerProvided,
+        runtimeLayer,
+      ),
+    ),
+  );
+  const checkpointCaptureServiceProvided = checkpointCaptureServiceLayer.pipe(
+    Layer.provide(
+      Layer.mergeAll(checkpointServiceProvided, eventSinkProvided, idAllocatorLayer, storesLayer),
+    ),
+  );
+  const runFinalizationServiceProvided = runFinalizationServiceLayer.pipe(
+    Layer.provide(Layer.merge(checkpointCaptureServiceProvided, storesLayer)),
+  );
+  const threadTitleRegenerationTestLayer = Layer.succeed(
+    ThreadTitleRegenerationService,
+    ThreadTitleRegenerationService.of({ execute: () => Effect.void }),
+  );
+  const effectExecutorProvided = effectExecutorLayer.pipe(
+    Layer.provide(
+      Layer.mergeAll(
+        runFinalizationServiceProvided,
+        checkpointRollbackServiceProvided,
+        providerSessionManagerProvided,
+        providerTurnControlServiceProvided,
+        providerTurnStartServiceProvided,
+        runtimeRequestServiceProvided,
+        threadTitleRegenerationTestLayer,
+      ),
+    ),
+  );
+  const effectWorkerProvided = effectWorkerLayer.pipe(
+    Layer.provide(Layer.merge(storesLayer, effectExecutorProvided)),
+  );
+  const orchestratorProvided = orchestratorLayer.pipe(
+    Layer.provide(
+      Layer.mergeAll(
+        checkpointServiceProvided,
+        commandPolicyLayer,
+        contextHandoffServiceProvided,
+        persistenceLayer,
+        registryLayer,
+        runtimeLayer,
+        providerSessionManagerProvided,
+        providerSwitchServiceProvided,
+        runExecutionServiceProvided,
+        threadForkServiceLayer,
+      ),
+    ),
+  );
+  const replayRuntime = Layer.merge(orchestratorProvided, effectWorkerProvided).pipe(
+    Layer.provide(worktreeRepairDependenciesTestLayer),
+    Layer.provide(NodeServices.layer),
+  );
+
+  // Build the daemon from the exact worker instance exposed alongside the
+  // orchestrator. Keeping this acquisition in the replay layer makes the
+  // outbox lifecycle explicit and prevents test-only command-side draining.
+  if (options.runEffectWorker === false) {
+    return orchestratorProvided;
+  }
+  return Layer.effect(
+    OrchestratorV2,
+    Effect.gen(function* () {
+      const orchestrator = yield* OrchestratorV2;
+      yield* runEffectWorkerDaemon.pipe(Effect.forkScoped);
+      return orchestrator;
+    }),
+  ).pipe(Layer.provide(replayRuntime));
+}
diff --git a/apps/server/src/orchestration-v2/testkit/ProviderSwitch.integration.test.ts b/apps/server/src/orchestration-v2/testkit/ProviderSwitch.integration.test.ts
new file mode 100644
index 000000000000..9b009720d3a0
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/ProviderSwitch.integration.test.ts
@@ -0,0 +1,1251 @@
+import { assert, describe, it } from "@effect/vitest";
+import {
+  CommandId,
+  MessageId,
+  type ModelSelection,
+  type OrchestrationV2Command,
+  type OrchestrationV2ProviderCapabilities,
+  type OrchestrationV2ProviderSession,
+  type OrchestrationV2ProviderThread,
+  ProjectId,
+  ProviderInstanceId,
+  ProviderThreadId,
+  ProviderTurnId,
+  ThreadId,
+  TurnItemId,
+  ProviderDriverKind,
+} from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as PubSub from "effect/PubSub";
+import * as Ref from "effect/Ref";
+import * as Stream from "effect/Stream";
+import * as SqlClient from "effect/unstable/sql/SqlClient";
+
+import { SqlitePersistenceMemory } from "../../persistence/Layers/Sqlite.ts";
+import { ClaudeProviderCapabilitiesV2 } from "../Adapters/ClaudeAdapterV2.ts";
+import { CodexProviderCapabilitiesV2 } from "../Adapters/CodexAdapterV2.ts";
+import { CursorProviderCapabilitiesV2 } from "../Adapters/CursorAdapterV2.ts";
+import { layer as eventSinkLayer } from "../EventSink.ts";
+import { layer as eventStoreLayer } from "../EventStore.ts";
+import {
+  LegacyV1ThreadImporter,
+  layer as legacyV1ThreadImporterLayer,
+} from "../LegacyV1ThreadImporter.ts";
+import { OrchestratorV2 } from "../Orchestrator.ts";
+import {
+  ProjectionMaintenanceV2,
+  layer as projectionMaintenanceLayer,
+} from "../ProjectionMaintenance.ts";
+import { layer as projectionStoreLayer } from "../ProjectionStore.ts";
+import {
+  type ProviderAdapterV2Event,
+  ProviderAdapterProtocolError,
+  type ProviderAdapterV2Shape,
+} from "../ProviderAdapter.ts";
+import { makeLayer as makeProviderAdapterRegistryLayer } from "../ProviderAdapterRegistry.ts";
+import { makeProviderFailure } from "../ProviderFailure.ts";
+import {
+  CLAUDE_MODEL_SELECTION,
+  CODEX_MODEL_SELECTION,
+  CURSOR_MODEL_SELECTION,
+} from "./fixtures/shared.ts";
+import { makeOrchestratorV2ReplayLayerWithRegistry } from "./ProviderReplayHarness.ts";
+import { checkpointWorkspace } from "./ReplayFixtureWorkspace.ts";
+
+const threadId = ThreadId.make("thread:provider-switch");
+const projectId = ProjectId.make("project:provider-switch");
+const firstPrompt = "Respond with exactly: codex before switch";
+const claudePrompt = "Respond with exactly: claude switched response";
+const returnPrompt = "Respond with exactly: codex after return";
+const CODEX_DRIVER = ProviderDriverKind.make("codex");
+const CLAUDE_DRIVER = ProviderDriverKind.make("claudeAgent");
+const CURSOR_DRIVER = ProviderDriverKind.make("cursor");
+
+interface CapturedTurn {
+  readonly driver: ProviderDriverKind;
+  readonly threadId: ThreadId;
+  readonly providerThreadId: ProviderThreadId;
+  readonly text: string;
+}
+
+function unimplemented(driver: ProviderDriverKind, detail: string) {
+  return Effect.fail(new ProviderAdapterProtocolError({ driver, detail }));
+}
+
+function makeTestAdapter(input: {
+  readonly instanceId: ProviderInstanceId;
+  readonly driver: ProviderDriverKind;
+  readonly capabilities: OrchestrationV2ProviderCapabilities;
+  readonly modelSelection: ModelSelection;
+  readonly responseByRunOrdinal: Readonly<Record<number, string>>;
+  readonly responseByThreadId?: Readonly<Record<string, Readonly<Record<number, string>>>>;
+  readonly capturedTurns: Ref.Ref<ReadonlyArray<CapturedTurn>>;
+  readonly failResume?: boolean;
+  readonly failedRunOrdinals?: ReadonlySet<number>;
+}): ProviderAdapterV2Shape {
+  return {
+    instanceId: input.instanceId,
+    driver: input.driver,
+    getCapabilities: () => Effect.succeed(input.capabilities),
+    planSelectionTransition: () => Effect.succeed({ type: "apply_on_next_turn" }),
+    openSession: (sessionInput) =>
+      Effect.gen(function* () {
+        const events = yield* PubSub.unbounded<ProviderAdapterV2Event>();
+        const now = yield* DateTime.now;
+        const providerSession: OrchestrationV2ProviderSession = {
+          id: sessionInput.providerSessionId,
+          driver: input.driver,
+          providerInstanceId: input.instanceId,
+          status: "ready",
+          cwd: sessionInput.runtimePolicy.cwd ?? process.cwd(),
+          model: input.modelSelection.model,
+          capabilities: input.capabilities,
+          createdAt: now,
+          updatedAt: now,
+          lastError: null,
+        };
+
+        return {
+          instanceId: input.instanceId,
+          driver: input.driver,
+          providerSessionId: sessionInput.providerSessionId,
+          providerSession,
+          events: Stream.fromPubSub(events),
+          ensureThread: (threadInput) =>
+            Effect.gen(function* () {
+              const createdAt = yield* DateTime.now;
+              const nativeThreadId = `${input.driver}:${threadInput.threadId}`;
+              return {
+                id: ProviderThreadId.make(`provider-thread:${nativeThreadId}`),
+                driver: input.driver,
+                providerInstanceId: input.instanceId,
+                providerSessionId: sessionInput.providerSessionId,
+                appThreadId: threadInput.threadId,
+                ownerNodeId: null,
+                nativeThreadRef: {
+                  driver: input.driver,
+                  nativeId: nativeThreadId,
+                  strength: "strong",
+                },
+                nativeConversationHeadRef: null,
+                status: "idle",
+                firstRunOrdinal: null,
+                lastRunOrdinal: null,
+                handoffIds: [],
+                forkedFrom: null,
+                createdAt,
+                updatedAt: createdAt,
+              } satisfies OrchestrationV2ProviderThread;
+            }),
+          resumeThread: ({ providerThread }) =>
+            input.failResume
+              ? unimplemented(input.driver, "simulated native resume failure")
+              : Effect.succeed(providerThread),
+          startTurn: (turnInput) =>
+            Effect.gen(function* () {
+              yield* Effect.yieldNow;
+              yield* Ref.update(input.capturedTurns, (turns) => [
+                ...turns,
+                {
+                  driver: input.driver,
+                  threadId: turnInput.threadId,
+                  providerThreadId: turnInput.providerThread.id,
+                  text: turnInput.message.text,
+                },
+              ]);
+              const eventTime = yield* DateTime.now;
+              const providerTurnId = ProviderTurnId.make(
+                `provider-turn:${input.driver}:${turnInput.threadId}:${turnInput.runOrdinal}`,
+              );
+              if (input.failedRunOrdinals?.has(turnInput.runOrdinal) === true) {
+                yield* PubSub.publish(events, {
+                  type: "provider_turn.updated",
+                  driver: input.driver,
+                  providerTurn: {
+                    id: providerTurnId,
+                    providerThreadId: turnInput.providerThread.id,
+                    nodeId: turnInput.rootNodeId,
+                    runAttemptId: turnInput.attemptId,
+                    nativeTurnRef: {
+                      driver: input.driver,
+                      nativeId: `native-turn:${turnInput.threadId}:${turnInput.runOrdinal}`,
+                      strength: "strong",
+                    },
+                    ordinal: turnInput.runOrdinal,
+                    status: "failed",
+                    startedAt: eventTime,
+                    completedAt: eventTime,
+                  },
+                });
+                yield* PubSub.publish(events, {
+                  type: "turn.terminal",
+                  driver: input.driver,
+                  providerThreadId: turnInput.providerThread.id,
+                  providerTurnId,
+                  runOrdinal: turnInput.runOrdinal,
+                  failureItemOrdinal: turnInput.runOrdinal * 100 + 1,
+                  status: "failed",
+                  failure: makeProviderFailure({
+                    message: "Simulated provider failure.",
+                    code: "simulated_failure",
+                    class: "provider_error",
+                  }),
+                  threadDisposition: "reusable",
+                });
+                return;
+              }
+              const response =
+                input.responseByThreadId?.[turnInput.threadId]?.[turnInput.runOrdinal] ??
+                input.responseByRunOrdinal[turnInput.runOrdinal] ??
+                `${input.driver} response for run ${turnInput.runOrdinal}`;
+              const providerEvents: ReadonlyArray<ProviderAdapterV2Event> = [
+                {
+                  type: "provider_turn.updated",
+                  driver: input.driver,
+                  providerTurn: {
+                    id: providerTurnId,
+                    providerThreadId: turnInput.providerThread.id,
+                    nodeId: turnInput.rootNodeId,
+                    runAttemptId: turnInput.attemptId,
+                    nativeTurnRef: {
+                      driver: input.driver,
+                      nativeId: `native-turn:${turnInput.threadId}:${turnInput.runOrdinal}`,
+                      strength: "strong",
+                    },
+                    ordinal: turnInput.runOrdinal,
+                    status: "completed",
+                    startedAt: eventTime,
+                    completedAt: eventTime,
+                  },
+                },
+                {
+                  type: "turn_item.updated",
+                  driver: input.driver,
+                  turnItem: {
+                    id: TurnItemId.make(
+                      `turn-item:${input.driver}:${turnInput.threadId}:${turnInput.runOrdinal}:assistant`,
+                    ),
+                    threadId: turnInput.threadId,
+                    runId: turnInput.runId,
+                    nodeId: turnInput.rootNodeId,
+                    providerThreadId: turnInput.providerThread.id,
+                    providerTurnId,
+                    nativeItemRef: null,
+                    parentItemId: null,
+                    ordinal: turnInput.runOrdinal * 100 + 1,
+                    status: "completed",
+                    title: null,
+                    startedAt: eventTime,
+                    completedAt: eventTime,
+                    updatedAt: eventTime,
+                    type: "assistant_message",
+                    messageId: MessageId.make(
+                      `message:${input.driver}:${turnInput.threadId}:${turnInput.runOrdinal}:assistant`,
+                    ),
+                    text: response,
+                    streaming: false,
+                  },
+                },
+                {
+                  type: "turn.terminal",
+                  driver: input.driver,
+                  providerThreadId: turnInput.providerThread.id,
+                  providerTurnId,
+                  runOrdinal: turnInput.runOrdinal,
+                  status: "completed",
+                  failure: null,
+                  threadDisposition: "reusable",
+                },
+              ];
+              for (const event of providerEvents) {
+                yield* PubSub.publish(events, event);
+              }
+            }),
+          steerTurn: () => Effect.void,
+          interruptTurn: () => Effect.void,
+          respondToRuntimeRequest: () => Effect.void,
+          readThreadSnapshot: () =>
+            unimplemented(input.driver, "readThreadSnapshot unused in provider switch test"),
+          rollbackThread: () =>
+            unimplemented(input.driver, "rollbackThread unused in provider switch test"),
+          forkThread: () =>
+            unimplemented(input.driver, "forkThread unused in provider switch test"),
+        };
+      }),
+  };
+}
+
+const waitForIdle = Effect.fn("ProviderSwitchTest.waitForIdle")(function* (
+  targetThreadId: ThreadId,
+) {
+  const orchestrator = yield* OrchestratorV2;
+  for (let attempt = 0; attempt < 1_000; attempt += 1) {
+    const projection = yield* orchestrator.getThreadProjection(targetThreadId);
+    if (
+      projection.runs.every(
+        (run) => !["queued", "starting", "running", "waiting"].includes(run.status),
+      )
+    ) {
+      return projection;
+    }
+    yield* Effect.sleep("5 millis");
+  }
+  return yield* Effect.die(new Error("Provider switch test timed out waiting for idle"));
+});
+
+describe("orchestration v2 provider switching", () => {
+  it.live("reissues imported v1 context when switching after the first provider fails", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const importedThreadId = ThreadId.make("thread:provider-switch:legacy-import");
+        const importedProjectId = ProjectId.make("project:provider-switch:legacy-import");
+        const failedPrompt = "This first provider attempt should fail.";
+        const recoveryPrompt = "What was the imported release marker?";
+        const cwd = yield* checkpointWorkspace("provider-switch-legacy-import");
+        const capturedTurns = yield* Ref.make<ReadonlyArray<CapturedTurn>>([]);
+        const registryLayer = makeProviderAdapterRegistryLayer([
+          makeTestAdapter({
+            instanceId: ProviderInstanceId.make("codex"),
+            driver: CODEX_DRIVER,
+            capabilities: CodexProviderCapabilitiesV2,
+            modelSelection: CODEX_MODEL_SELECTION,
+            responseByRunOrdinal: {},
+            capturedTurns,
+            failedRunOrdinals: new Set([1]),
+          }),
+          makeTestAdapter({
+            instanceId: ProviderInstanceId.make("claudeAgent"),
+            driver: CLAUDE_DRIVER,
+            capabilities: ClaudeProviderCapabilitiesV2,
+            modelSelection: CLAUDE_MODEL_SELECTION,
+            responseByRunOrdinal: { 2: "The imported release marker is violet." },
+            capturedTurns,
+          }),
+        ]);
+        const databaseLayer = SqlitePersistenceMemory;
+        const eventStoreProvided = eventStoreLayer.pipe(Layer.provideMerge(databaseLayer));
+        const projectionStoreProvided = projectionStoreLayer.pipe(
+          Layer.provideMerge(databaseLayer),
+        );
+        const storesProvided = Layer.mergeAll(
+          databaseLayer,
+          eventStoreProvided,
+          projectionStoreProvided,
+        );
+        const eventSinkProvided = eventSinkLayer.pipe(Layer.provide(storesProvided));
+        const importerProvided = legacyV1ThreadImporterLayer.pipe(
+          Layer.provide(Layer.mergeAll(storesProvided, eventSinkProvided)),
+        );
+        const maintenanceProvided = projectionMaintenanceLayer.pipe(Layer.provide(storesProvided));
+        const orchestratorProvided = makeOrchestratorV2ReplayLayerWithRegistry(
+          {
+            name: "provider-switch-legacy-import",
+            runtimePolicyOverride: {
+              cwd,
+              approvalPolicy: "never",
+              sandboxPolicy: {
+                type: "readOnly",
+                access: { type: "fullAccess" },
+                networkAccess: false,
+              },
+            },
+          },
+          registryLayer,
+          { databaseLayer },
+        );
+        const testLayer = Layer.mergeAll(
+          storesProvided,
+          importerProvided,
+          maintenanceProvided,
+          orchestratorProvided,
+        );
+
+        const projection = yield* Effect.gen(function* () {
+          const sql = yield* SqlClient.SqlClient;
+          const importer = yield* LegacyV1ThreadImporter;
+          const maintenance = yield* ProjectionMaintenanceV2;
+          const orchestrator = yield* OrchestratorV2;
+
+          yield* sql`
+            INSERT INTO projection_projects (
+              project_id,
+              title,
+              workspace_root,
+              default_model_selection_json,
+              scripts_json,
+              created_at,
+              updated_at,
+              deleted_at
+            ) VALUES (
+              ${importedProjectId},
+              'Imported provider switch project',
+              ${cwd},
+              '{"instanceId":"codex","model":"gpt-5.4"}',
+              '[]',
+              '2026-01-01T00:00:00.000Z',
+              '2026-01-01T00:00:00.000Z',
+              NULL
+            )
+          `;
+          yield* sql`
+            INSERT INTO projection_threads (
+              thread_id,
+              project_id,
+              title,
+              model_selection_json,
+              runtime_mode,
+              interaction_mode,
+              branch,
+              worktree_path,
+              latest_turn_id,
+              created_at,
+              updated_at,
+              archived_at,
+              settled_override,
+              settled_at,
+              deleted_at
+            ) VALUES (
+              ${importedThreadId},
+              ${importedProjectId},
+              'Imported provider switch thread',
+              '{"instanceId":"codex","model":"gpt-5.4"}',
+              'full-access',
+              'default',
+              'main',
+              ${cwd},
+              NULL,
+              '2026-01-01T00:00:00.000Z',
+              '2026-01-01T00:00:00.000Z',
+              NULL,
+              NULL,
+              NULL,
+              NULL
+            )
+          `;
+          yield* sql`
+            INSERT INTO projection_thread_messages (
+              message_id,
+              thread_id,
+              turn_id,
+              role,
+              text,
+              attachments_json,
+              is_streaming,
+              created_at,
+              updated_at
+            ) VALUES
+              (
+                'message:provider-switch:legacy-import:user',
+                ${importedThreadId},
+                NULL,
+                'user',
+                'Remember that the imported release marker is violet.',
+                '[]',
+                0,
+                '2026-01-01T01:00:00.000Z',
+                '2026-01-01T01:00:00.000Z'
+              ),
+              (
+                'message:provider-switch:legacy-import:assistant',
+                ${importedThreadId},
+                NULL,
+                'assistant',
+                'I will remember violet.',
+                '[]',
+                0,
+                '2026-01-01T01:01:00.000Z',
+                '2026-01-01T01:01:00.000Z'
+              )
+          `;
+
+          yield* importer.reconcileShells;
+          yield* maintenance.rebuild;
+          yield* importer.ensureTranscript(importedThreadId);
+
+          yield* orchestrator.dispatch({
+            type: "message.dispatch",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command:provider-switch:legacy-import:failed"),
+            threadId: importedThreadId,
+            messageId: MessageId.make("message:provider-switch:legacy-import:failed"),
+            text: failedPrompt,
+            attachments: [],
+            modelSelection: CODEX_MODEL_SELECTION,
+            dispatchMode: { type: "start_immediately" },
+          });
+          yield* waitForIdle(importedThreadId);
+          yield* orchestrator.dispatch({
+            type: "message.dispatch",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command:provider-switch:legacy-import:recovery"),
+            threadId: importedThreadId,
+            messageId: MessageId.make("message:provider-switch:legacy-import:recovery"),
+            text: recoveryPrompt,
+            attachments: [],
+            modelSelection: CLAUDE_MODEL_SELECTION,
+            dispatchMode: { type: "start_immediately" },
+          });
+          return yield* waitForIdle(importedThreadId);
+        }).pipe(Effect.provide(testLayer));
+
+        const turns = yield* Ref.get(capturedTurns);
+        assert.deepEqual(
+          projection.runs.map((run) => [run.providerInstanceId, run.status]),
+          [
+            ["codex", "failed"],
+            ["claudeAgent", "completed"],
+          ],
+        );
+        assert.deepEqual(
+          projection.contextHandoffs.map((handoff) => [
+            handoff.targetRunId,
+            handoff.strategy,
+            handoff.status,
+          ]),
+          [
+            [projection.runs[0]?.id, "manual_context", "ready"],
+            [projection.runs[1]?.id, "manual_context", "ready"],
+          ],
+        );
+        assert.equal(projection.runs[1]?.contextHandoffId, projection.contextHandoffs[1]?.id);
+        assert.include(turns[1]?.text ?? "", "Context handoff (manual_context):");
+        assert.include(turns[1]?.text ?? "", "imported release marker is violet");
+        assert.include(turns[1]?.text ?? "", "I will remember violet.");
+        assert.include(turns[1]?.text ?? "", recoveryPrompt);
+        assert.notInclude(turns[1]?.text ?? "", failedPrompt);
+      }),
+    ),
+  );
+
+  it.live("uses portable fallback when native resume fails after a provider switch", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const cwd = yield* checkpointWorkspace("provider-switch");
+        const capturedTurns = yield* Ref.make<ReadonlyArray<CapturedTurn>>([]);
+        const registryLayer = makeProviderAdapterRegistryLayer([
+          makeTestAdapter({
+            instanceId: ProviderInstanceId.make("codex"),
+            driver: CODEX_DRIVER,
+            capabilities: CodexProviderCapabilitiesV2,
+            modelSelection: CODEX_MODEL_SELECTION,
+            responseByRunOrdinal: {
+              1: "codex before switch",
+              3: "codex after return",
+            },
+            capturedTurns,
+            failResume: true,
+          }),
+          makeTestAdapter({
+            instanceId: ProviderInstanceId.make("claudeAgent"),
+            driver: CLAUDE_DRIVER,
+            capabilities: ClaudeProviderCapabilitiesV2,
+            modelSelection: CLAUDE_MODEL_SELECTION,
+            responseByRunOrdinal: { 2: "claude switched response" },
+            capturedTurns,
+          }),
+        ]);
+        const commands = [
+          {
+            type: "thread.create",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command:provider-switch:create"),
+            threadId,
+            projectId,
+            title: "Provider switch",
+            modelSelection: CODEX_MODEL_SELECTION,
+            runtimeMode: "full-access",
+            interactionMode: "default",
+            branch: null,
+            worktreePath: null,
+          },
+          {
+            type: "message.dispatch",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command:provider-switch:codex"),
+            threadId,
+            messageId: MessageId.make("message:provider-switch:codex"),
+            text: firstPrompt,
+            attachments: [],
+            modelSelection: CODEX_MODEL_SELECTION,
+            dispatchMode: { type: "start_immediately" },
+          },
+          {
+            type: "message.dispatch",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command:provider-switch:claude"),
+            threadId,
+            messageId: MessageId.make("message:provider-switch:claude"),
+            text: claudePrompt,
+            attachments: [],
+            modelSelection: CLAUDE_MODEL_SELECTION,
+            dispatchMode: { type: "start_immediately" },
+          },
+          {
+            type: "message.dispatch",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command:provider-switch:return"),
+            threadId,
+            messageId: MessageId.make("message:provider-switch:return"),
+            text: returnPrompt,
+            attachments: [],
+            modelSelection: CODEX_MODEL_SELECTION,
+            dispatchMode: { type: "start_immediately" },
+          },
+        ] satisfies ReadonlyArray<OrchestrationV2Command>;
+
+        const projection = yield* Effect.gen(function* () {
+          const orchestrator = yield* OrchestratorV2;
+          yield* orchestrator.dispatch(commands[0]!);
+          yield* orchestrator.dispatch(commands[1]!);
+          yield* waitForIdle(threadId);
+          yield* orchestrator.dispatch(commands[2]!);
+          yield* waitForIdle(threadId);
+          yield* orchestrator.dispatch(commands[3]!);
+          return yield* waitForIdle(threadId);
+        }).pipe(
+          Effect.provide(
+            makeOrchestratorV2ReplayLayerWithRegistry(
+              {
+                name: "provider-switch",
+                runtimePolicyOverride: {
+                  cwd,
+                  approvalPolicy: "never",
+                  sandboxPolicy: {
+                    type: "readOnly",
+                    access: { type: "fullAccess" },
+                    networkAccess: false,
+                  },
+                },
+              },
+              registryLayer,
+            ),
+          ),
+        );
+        const turns = yield* Ref.get(capturedTurns);
+
+        assert.deepEqual(
+          projection.runs.map((run) => [run.providerInstanceId, run.status]),
+          [
+            ["codex", "completed"],
+            ["claudeAgent", "completed"],
+            ["codex", "completed"],
+          ],
+        );
+        assert.lengthOf(projection.providerThreads, 2);
+        assert.equal(projection.runs[0]?.providerThreadId, projection.runs[2]?.providerThreadId);
+        assert.notEqual(projection.runs[0]?.providerThreadId, projection.runs[1]?.providerThreadId);
+        assert.deepEqual(
+          projection.contextHandoffs.map((handoff) => handoff.strategy),
+          ["full_thread_summary", "delta_since_target_last_seen"],
+        );
+        assert.deepEqual(
+          projection.contextTransfers.map((transfer) => [
+            transfer.type,
+            transfer.status,
+            transfer.resolution?.strategy,
+          ]),
+          [
+            ["provider_handoff", "consumed", "portable_context"],
+            ["provider_handoff", "consumed", "delta_context"],
+          ],
+        );
+        assert.deepEqual(
+          projection.turnItems
+            .filter((item) => item.type === "user_message")
+            .map((item) => item.text),
+          [firstPrompt, claudePrompt, returnPrompt],
+        );
+        assert.deepEqual(
+          projection.providerThreads.map((providerThread) => [
+            providerThread.driver,
+            providerThread.status,
+            providerThread.handoffIds.length,
+          ]),
+          [
+            ["codex", "idle", 1],
+            ["claudeAgent", "idle", 1],
+          ],
+        );
+        assert.equal(turns[0]?.text, firstPrompt);
+        assert.include(turns[1]?.text ?? "", "Context handoff (full_thread_summary):");
+        assert.include(turns[1]?.text ?? "", "codex before switch");
+        assert.include(turns[1]?.text ?? "", claudePrompt);
+        assert.include(turns[2]?.text ?? "", "Context handoff (delta_since_target_last_seen):");
+        assert.include(turns[2]?.text ?? "", "claude switched response");
+        assert.include(turns[2]?.text ?? "", returnPrompt);
+        assert.notInclude(turns[2]?.text ?? "", "codex before switch");
+        assert.equal(turns[0]?.providerThreadId, turns[2]?.providerThreadId);
+      }),
+    ),
+  );
+
+  it.live("resolves a Claude fork into portable Codex context on first dispatch", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const sourceThreadId = ThreadId.make("thread:cross-provider-fork:source");
+        const targetThreadId = ThreadId.make("thread:cross-provider-fork:target");
+        const sourcePrompt = "Remember that the release color is violet.";
+        const targetPrompt = "What release color did we choose?";
+        const cwd = yield* checkpointWorkspace("cross-provider-fork");
+        const capturedTurns = yield* Ref.make<ReadonlyArray<CapturedTurn>>([]);
+        const registryLayer = makeProviderAdapterRegistryLayer([
+          makeTestAdapter({
+            instanceId: ProviderInstanceId.make("codex"),
+            driver: CODEX_DRIVER,
+            capabilities: CodexProviderCapabilitiesV2,
+            modelSelection: CODEX_MODEL_SELECTION,
+            responseByRunOrdinal: { 1: "The release color is violet." },
+            capturedTurns,
+          }),
+          makeTestAdapter({
+            instanceId: ProviderInstanceId.make("claudeAgent"),
+            driver: CLAUDE_DRIVER,
+            capabilities: ClaudeProviderCapabilitiesV2,
+            modelSelection: CLAUDE_MODEL_SELECTION,
+            responseByRunOrdinal: { 1: "I will remember violet." },
+            capturedTurns,
+          }),
+        ]);
+        const commands = [
+          {
+            type: "thread.create",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command:cross-provider-fork:create"),
+            threadId: sourceThreadId,
+            projectId,
+            title: "Cross-provider fork source",
+            modelSelection: CLAUDE_MODEL_SELECTION,
+            runtimeMode: "full-access",
+            interactionMode: "default",
+            branch: null,
+            worktreePath: null,
+          },
+          {
+            type: "message.dispatch",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command:cross-provider-fork:source"),
+            threadId: sourceThreadId,
+            messageId: MessageId.make("message:cross-provider-fork:source"),
+            text: sourcePrompt,
+            attachments: [],
+            modelSelection: CLAUDE_MODEL_SELECTION,
+            dispatchMode: { type: "start_immediately" },
+          },
+          {
+            type: "thread.fork",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command:cross-provider-fork:fork"),
+            sourceThreadId,
+            targetThreadId,
+            sourcePoint: { type: "latest_stable" },
+            title: "Cross-provider fork target",
+          },
+          {
+            type: "message.dispatch",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command:cross-provider-fork:target"),
+            threadId: targetThreadId,
+            messageId: MessageId.make("message:cross-provider-fork:target"),
+            text: targetPrompt,
+            attachments: [],
+            modelSelection: CODEX_MODEL_SELECTION,
+            dispatchMode: { type: "start_immediately" },
+          },
+        ] satisfies ReadonlyArray<OrchestrationV2Command>;
+
+        const targetProjection = yield* Effect.gen(function* () {
+          const orchestrator = yield* OrchestratorV2;
+          yield* orchestrator.dispatch(commands[0]!);
+          yield* orchestrator.dispatch(commands[1]!);
+          yield* waitForIdle(sourceThreadId);
+          yield* orchestrator.dispatch(commands[2]!);
+          yield* orchestrator.dispatch(commands[3]!);
+          return yield* waitForIdle(targetThreadId);
+        }).pipe(
+          Effect.provide(
+            makeOrchestratorV2ReplayLayerWithRegistry(
+              {
+                name: "cross-provider-fork",
+                runtimePolicyOverride: {
+                  cwd,
+                  approvalPolicy: "never",
+                  sandboxPolicy: {
+                    type: "readOnly",
+                    access: { type: "fullAccess" },
+                    networkAccess: false,
+                  },
+                },
+              },
+              registryLayer,
+            ),
+          ),
+        );
+        const turns = yield* Ref.get(capturedTurns);
+        const targetTurn = turns.find((turn) => turn.threadId === targetThreadId);
+
+        assert.deepEqual(
+          targetProjection.runs.map((run) => [run.providerInstanceId, run.status]),
+          [["codex", "completed"]],
+        );
+        assert.lengthOf(targetProjection.providerThreads, 1);
+        assert.equal(targetProjection.providerThreads[0]?.driver, "codex");
+        assert.isNull(targetProjection.providerThreads[0]?.forkedFrom);
+        assert.deepEqual(
+          targetProjection.contextTransfers.map((transfer) => [
+            transfer.type,
+            transfer.status,
+            transfer.resolution?.strategy,
+          ]),
+          [["fork", "consumed", "portable_context"]],
+        );
+        assert.deepEqual(
+          targetProjection.contextHandoffs.map((handoff) => handoff.strategy),
+          ["full_thread_summary"],
+        );
+        assert.equal(
+          targetProjection.runs[0]?.contextHandoffId,
+          targetProjection.contextHandoffs[0]?.id,
+        );
+        assert.include(targetTurn?.text ?? "", "Context handoff (full_thread_summary):");
+        assert.include(targetTurn?.text ?? "", sourcePrompt);
+        assert.include(targetTurn?.text ?? "", "I will remember violet.");
+        assert.include(targetTurn?.text ?? "", targetPrompt);
+      }),
+    ),
+  );
+
+  it.live("resolves a same-provider Cursor fork with portable context", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const sourceThreadId = ThreadId.make("thread:cursor-portable-fork:source");
+        const targetThreadId = ThreadId.make("thread:cursor-portable-fork:target");
+        const sourcePrompt = "Remember that the deployment marker is indigo.";
+        const sourceResponse = "I will remember indigo.";
+        const targetPrompt = "What deployment marker did we choose?";
+        const cwd = yield* checkpointWorkspace("cursor-portable-fork");
+        const capturedTurns = yield* Ref.make<ReadonlyArray<CapturedTurn>>([]);
+        const registryLayer = makeProviderAdapterRegistryLayer([
+          makeTestAdapter({
+            instanceId: ProviderInstanceId.make("cursor"),
+            driver: CURSOR_DRIVER,
+            capabilities: CursorProviderCapabilitiesV2,
+            modelSelection: CURSOR_MODEL_SELECTION,
+            responseByRunOrdinal: {},
+            responseByThreadId: {
+              [sourceThreadId]: { 1: sourceResponse },
+              [targetThreadId]: { 1: "The deployment marker is indigo." },
+            },
+            capturedTurns,
+          }),
+        ]);
+        const commands = [
+          {
+            type: "thread.create",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command:cursor-portable-fork:create"),
+            threadId: sourceThreadId,
+            projectId,
+            title: "Cursor portable fork source",
+            modelSelection: CURSOR_MODEL_SELECTION,
+            runtimeMode: "full-access",
+            interactionMode: "default",
+            branch: null,
+            worktreePath: null,
+          },
+          {
+            type: "message.dispatch",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command:cursor-portable-fork:source"),
+            threadId: sourceThreadId,
+            messageId: MessageId.make("message:cursor-portable-fork:source"),
+            text: sourcePrompt,
+            attachments: [],
+            modelSelection: CURSOR_MODEL_SELECTION,
+            dispatchMode: { type: "start_immediately" },
+          },
+          {
+            type: "thread.fork",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command:cursor-portable-fork:fork"),
+            sourceThreadId,
+            targetThreadId,
+            sourcePoint: { type: "latest_stable" },
+            title: "Cursor portable fork target",
+          },
+          {
+            type: "message.dispatch",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command:cursor-portable-fork:target"),
+            threadId: targetThreadId,
+            messageId: MessageId.make("message:cursor-portable-fork:target"),
+            text: targetPrompt,
+            attachments: [],
+            modelSelection: CURSOR_MODEL_SELECTION,
+            dispatchMode: { type: "start_immediately" },
+          },
+        ] satisfies ReadonlyArray<OrchestrationV2Command>;
+
+        const targetProjection = yield* Effect.gen(function* () {
+          const orchestrator = yield* OrchestratorV2;
+          yield* orchestrator.dispatch(commands[0]!);
+          yield* orchestrator.dispatch(commands[1]!);
+          yield* waitForIdle(sourceThreadId);
+          yield* orchestrator.dispatch(commands[2]!);
+          yield* orchestrator.dispatch(commands[3]!);
+          return yield* waitForIdle(targetThreadId);
+        }).pipe(
+          Effect.provide(
+            makeOrchestratorV2ReplayLayerWithRegistry(
+              {
+                name: "cursor-portable-fork",
+                runtimePolicyOverride: {
+                  cwd,
+                  approvalPolicy: "never",
+                  sandboxPolicy: {
+                    type: "readOnly",
+                    access: { type: "fullAccess" },
+                    networkAccess: false,
+                  },
+                },
+              },
+              registryLayer,
+            ),
+          ),
+        );
+        const turns = yield* Ref.get(capturedTurns);
+        const targetTurn = turns.find((turn) => turn.threadId === targetThreadId);
+
+        assert.deepEqual(
+          targetProjection.runs.map((run) => [run.providerInstanceId, run.status]),
+          [["cursor", "completed"]],
+        );
+        assert.lengthOf(targetProjection.providerThreads, 1);
+        assert.equal(targetProjection.providerThreads[0]?.driver, "cursor");
+        assert.isNull(targetProjection.providerThreads[0]?.forkedFrom);
+        assert.deepEqual(
+          targetProjection.contextTransfers.map((transfer) => [
+            transfer.type,
+            transfer.status,
+            transfer.resolution?.strategy,
+          ]),
+          [["fork", "consumed", "portable_context"]],
+        );
+        assert.deepEqual(
+          targetProjection.contextHandoffs.map((handoff) => handoff.strategy),
+          ["full_thread_summary"],
+        );
+        assert.include(targetTurn?.text ?? "", "Context handoff (full_thread_summary):");
+        assert.include(targetTurn?.text ?? "", sourcePrompt);
+        assert.include(targetTurn?.text ?? "", sourceResponse);
+        assert.include(targetTurn?.text ?? "", targetPrompt);
+      }),
+    ),
+  );
+
+  it.live("switches providers while consuming a pending cross-provider merge-back", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const sourceThreadId = ThreadId.make("thread:cross-provider-merge:source");
+        const forkThreadId = ThreadId.make("thread:cross-provider-merge:fork");
+        const firstSourcePrompt = "Remember that the first source marker is amber.";
+        const secondSourcePrompt = "Remember that the second source marker is violet.";
+        const forkPrompt = "Remember that the fork marker is cobalt.";
+        const mergePrompt = "Report all three remembered markers.";
+        const cwd = yield* checkpointWorkspace("cross-provider-merge");
+        const capturedTurns = yield* Ref.make<ReadonlyArray<CapturedTurn>>([]);
+        const registryLayer = makeProviderAdapterRegistryLayer([
+          makeTestAdapter({
+            instanceId: ProviderInstanceId.make("codex"),
+            driver: CODEX_DRIVER,
+            capabilities: CodexProviderCapabilitiesV2,
+            modelSelection: CODEX_MODEL_SELECTION,
+            responseByRunOrdinal: {},
+            responseByThreadId: {
+              [sourceThreadId]: {
+                1: "I will remember amber.",
+                3: "The markers are amber, violet, and cobalt.",
+              },
+              [forkThreadId]: {
+                1: "I will remember cobalt.",
+              },
+            },
+            capturedTurns,
+          }),
+          makeTestAdapter({
+            instanceId: ProviderInstanceId.make("claudeAgent"),
+            driver: CLAUDE_DRIVER,
+            capabilities: ClaudeProviderCapabilitiesV2,
+            modelSelection: CLAUDE_MODEL_SELECTION,
+            responseByRunOrdinal: { 2: "I will remember violet." },
+            capturedTurns,
+          }),
+        ]);
+        const commands = [
+          {
+            type: "thread.create",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command:cross-provider-merge:create"),
+            threadId: sourceThreadId,
+            projectId,
+            title: "Cross-provider merge source",
+            modelSelection: CODEX_MODEL_SELECTION,
+            runtimeMode: "full-access",
+            interactionMode: "default",
+            branch: null,
+            worktreePath: null,
+          },
+          {
+            type: "message.dispatch",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command:cross-provider-merge:first-source"),
+            threadId: sourceThreadId,
+            messageId: MessageId.make("message:cross-provider-merge:first-source"),
+            text: firstSourcePrompt,
+            attachments: [],
+            modelSelection: CODEX_MODEL_SELECTION,
+            dispatchMode: { type: "start_immediately" },
+          },
+          {
+            type: "message.dispatch",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command:cross-provider-merge:second-source"),
+            threadId: sourceThreadId,
+            messageId: MessageId.make("message:cross-provider-merge:second-source"),
+            text: secondSourcePrompt,
+            attachments: [],
+            modelSelection: CLAUDE_MODEL_SELECTION,
+            dispatchMode: { type: "start_immediately" },
+          },
+          {
+            type: "thread.fork",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command:cross-provider-merge:fork"),
+            sourceThreadId,
+            targetThreadId: forkThreadId,
+            sourcePoint: { type: "latest_stable" },
+            title: "Cross-provider merge fork",
+          },
+          {
+            type: "message.dispatch",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command:cross-provider-merge:fork-turn"),
+            threadId: forkThreadId,
+            messageId: MessageId.make("message:cross-provider-merge:fork-turn"),
+            text: forkPrompt,
+            attachments: [],
+            modelSelection: CODEX_MODEL_SELECTION,
+            dispatchMode: { type: "start_immediately" },
+          },
+          {
+            type: "thread.merge_back",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command:cross-provider-merge:merge"),
+            sourceThreadId: forkThreadId,
+            targetThreadId: sourceThreadId,
+            sourcePoint: { type: "latest_stable" },
+          },
+          {
+            type: "message.dispatch",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command:cross-provider-merge:consume"),
+            threadId: sourceThreadId,
+            messageId: MessageId.make("message:cross-provider-merge:consume"),
+            text: mergePrompt,
+            attachments: [],
+            modelSelection: CODEX_MODEL_SELECTION,
+            dispatchMode: { type: "start_immediately" },
+          },
+        ] satisfies ReadonlyArray<OrchestrationV2Command>;
+
+        const projection = yield* Effect.gen(function* () {
+          const orchestrator = yield* OrchestratorV2;
+          yield* orchestrator.dispatch(commands[0]!);
+          yield* orchestrator.dispatch(commands[1]!);
+          yield* waitForIdle(sourceThreadId);
+          yield* orchestrator.dispatch(commands[2]!);
+          yield* waitForIdle(sourceThreadId);
+          yield* orchestrator.dispatch(commands[3]!);
+          yield* orchestrator.dispatch(commands[4]!);
+          yield* waitForIdle(forkThreadId);
+          yield* orchestrator.dispatch(commands[5]!);
+          yield* orchestrator.dispatch(commands[6]!);
+          return yield* waitForIdle(sourceThreadId);
+        }).pipe(
+          Effect.provide(
+            makeOrchestratorV2ReplayLayerWithRegistry(
+              {
+                name: "cross-provider-merge",
+                runtimePolicyOverride: {
+                  cwd,
+                  approvalPolicy: "never",
+                  sandboxPolicy: {
+                    type: "readOnly",
+                    access: { type: "fullAccess" },
+                    networkAccess: false,
+                  },
+                },
+              },
+              registryLayer,
+            ),
+          ),
+        );
+        const turns = yield* Ref.get(capturedTurns);
+        const mergedTurn = turns.findLast(
+          (turn) => turn.threadId === sourceThreadId && turn.driver === "codex",
+        );
+        const mergeTransfer = projection.contextTransfers.find(
+          (transfer) => transfer.type === "merge_back",
+        );
+
+        assert.isDefined(mergedTurn);
+        assert.include(mergedTurn.text, "Context handoff (full_thread_summary):");
+        assert.include(mergedTurn.text, firstSourcePrompt);
+        assert.include(mergedTurn.text, "I will remember amber.");
+        assert.include(mergedTurn.text, secondSourcePrompt);
+        assert.include(mergedTurn.text, "I will remember violet.");
+        assert.include(mergedTurn.text, "Context handoff (merge_back / fork_delta_summary):");
+        assert.include(mergedTurn.text, forkPrompt);
+        assert.include(mergedTurn.text, "I will remember cobalt.");
+        assert.include(mergedTurn.text, mergePrompt);
+        assert.isDefined(mergeTransfer);
+        assert.equal(mergeTransfer.status, "consumed");
+        assert.equal(mergeTransfer.targetProviderInstanceId, "codex");
+        assert.equal(mergeTransfer.resolution?.strategy, "fork_delta_context");
+      }),
+    ),
+  );
+
+  it.live("routes two custom instances of the same driver independently", () =>
+    Effect.scoped(
+      Effect.gen(function* () {
+        const personalThreadId = ThreadId.make("thread:custom-codex-personal");
+        const workThreadId = ThreadId.make("thread:custom-codex-work");
+        const personalSelection = {
+          instanceId: ProviderInstanceId.make("codex_personal"),
+          model: "gpt-5.4",
+        } satisfies ModelSelection;
+        const workSelection = {
+          instanceId: ProviderInstanceId.make("codex_work"),
+          model: "gpt-5.4",
+        } satisfies ModelSelection;
+        const cwd = yield* checkpointWorkspace("custom-codex-instances");
+        const capturedTurns = yield* Ref.make<ReadonlyArray<CapturedTurn>>([]);
+        const registryLayer = makeProviderAdapterRegistryLayer([
+          makeTestAdapter({
+            instanceId: personalSelection.instanceId,
+            driver: CODEX_DRIVER,
+            capabilities: CodexProviderCapabilitiesV2,
+            modelSelection: personalSelection,
+            responseByRunOrdinal: { 1: "personal response" },
+            capturedTurns,
+          }),
+          makeTestAdapter({
+            instanceId: workSelection.instanceId,
+            driver: CODEX_DRIVER,
+            capabilities: CodexProviderCapabilitiesV2,
+            modelSelection: workSelection,
+            responseByRunOrdinal: { 1: "work response" },
+            capturedTurns,
+          }),
+        ]);
+
+        const [personal, work] = yield* Effect.gen(function* () {
+          const orchestrator = yield* OrchestratorV2;
+          for (const [targetThreadId, selection, suffix] of [
+            [personalThreadId, personalSelection, "personal"],
+            [workThreadId, workSelection, "work"],
+          ] as const) {
+            yield* orchestrator.dispatch({
+              type: "thread.create",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: CommandId.make(`command:custom-codex:${suffix}:create`),
+              threadId: targetThreadId,
+              projectId,
+              title: `Custom Codex ${suffix}`,
+              modelSelection: selection,
+              runtimeMode: "full-access",
+              interactionMode: "default",
+              branch: null,
+              worktreePath: null,
+            });
+            yield* orchestrator.dispatch({
+              type: "message.dispatch",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: CommandId.make(`command:custom-codex:${suffix}:message`),
+              threadId: targetThreadId,
+              messageId: MessageId.make(`message:custom-codex:${suffix}`),
+              text: `${suffix} prompt`,
+              attachments: [],
+              modelSelection: selection,
+              dispatchMode: { type: "start_immediately" },
+            });
+            yield* waitForIdle(targetThreadId);
+          }
+          return yield* Effect.all([
+            orchestrator.getThreadProjection(personalThreadId),
+            orchestrator.getThreadProjection(workThreadId),
+          ]);
+        }).pipe(
+          Effect.provide(
+            makeOrchestratorV2ReplayLayerWithRegistry(
+              {
+                name: "custom-codex-instances",
+                runtimePolicyOverride: {
+                  cwd,
+                  approvalPolicy: "never",
+                  sandboxPolicy: {
+                    type: "readOnly",
+                    access: { type: "fullAccess" },
+                    networkAccess: false,
+                  },
+                },
+              },
+              registryLayer,
+            ),
+          ),
+        );
+
+        assert.equal(personal.runs[0]?.providerInstanceId, personalSelection.instanceId);
+        assert.equal(
+          personal.providerSessions[0]?.providerInstanceId,
+          personalSelection.instanceId,
+        );
+        assert.equal(work.runs[0]?.providerInstanceId, workSelection.instanceId);
+        assert.equal(work.providerSessions[0]?.providerInstanceId, workSelection.instanceId);
+        assert.notEqual(personal.providerSessions[0]?.id, work.providerSessions[0]?.id);
+        assert.deepEqual(
+          (yield* Ref.get(capturedTurns)).map((turn) => [turn.threadId, turn.text]),
+          [
+            [personalThreadId, "personal prompt"],
+            [workThreadId, "work prompt"],
+          ],
+        );
+      }),
+    ),
+  );
+});
diff --git a/apps/server/src/orchestration-v2/testkit/ReplayFixtureWorkspace.ts b/apps/server/src/orchestration-v2/testkit/ReplayFixtureWorkspace.ts
new file mode 100644
index 000000000000..e5fa165374d8
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/ReplayFixtureWorkspace.ts
@@ -0,0 +1,74 @@
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as PlatformError from "effect/PlatformError";
+import * as Schema from "effect/Schema";
+import { ChildProcess, ChildProcessSpawner } from "effect/unstable/process";
+
+class ReplayFixtureGitCommandError extends Schema.TaggedErrorClass<ReplayFixtureGitCommandError>()(
+  "ReplayFixtureGitCommandError",
+  {
+    command: Schema.String,
+    exitCode: Schema.Number,
+  },
+) {
+  override get message(): string {
+    return `${this.command} failed with exit ${this.exitCode}.`;
+  }
+}
+
+function runGit(
+  cwd: string,
+  args: ReadonlyArray<string>,
+): Effect.Effect<
+  void,
+  ReplayFixtureGitCommandError | PlatformError.PlatformError,
+  ChildProcessSpawner.ChildProcessSpawner
+> {
+  return Effect.gen(function* () {
+    const spawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+    const exitCode = yield* spawner.exitCode(ChildProcess.make("git", args, { cwd }));
+    if (Number(exitCode) !== 0) {
+      return yield* new ReplayFixtureGitCommandError({
+        command: `git ${args.join(" ")}`,
+        exitCode: Number(exitCode),
+      });
+    }
+  });
+}
+
+export const makeCheckpointWorkspaceEffect = Effect.fn("makeCheckpointWorkspace")(function* (
+  fixtureName: string,
+) {
+  const fs = yield* FileSystem.FileSystem;
+  const path = yield* Path.Path;
+  const cwd = yield* fs.makeTempDirectory({
+    prefix: `t3-orchestrator-v2-${fixtureName}-`,
+  });
+  yield* runGit(cwd, ["init"]);
+  yield* runGit(cwd, ["config", "user.name", "T3 Code Test"]);
+  yield* runGit(cwd, ["config", "user.email", "t3code-test@example.com"]);
+  yield* fs.writeFileString(path.join(cwd, "README.md"), `# ${fixtureName}\n`);
+  yield* runGit(cwd, ["add", "README.md"]);
+  yield* runGit(cwd, ["commit", "-m", "initial"]);
+  return cwd;
+});
+
+export const removeCheckpointWorkspaceEffect = Effect.fn("removeCheckpointWorkspace")(function* (
+  cwd: string,
+) {
+  const fs = yield* FileSystem.FileSystem;
+  yield* fs.remove(cwd, { recursive: true });
+});
+
+export const checkpointWorkspace = (fixtureName: string) =>
+  Effect.acquireRelease(makeCheckpointWorkspaceEffect(fixtureName), (cwd) =>
+    removeCheckpointWorkspaceEffect(cwd).pipe(Effect.orDie),
+  ).pipe(Effect.provide(NodeServices.layer));
+
+export async function makeCheckpointWorkspace(fixtureName: string): Promise<string> {
+  return await Effect.runPromise(
+    makeCheckpointWorkspaceEffect(fixtureName).pipe(Effect.provide(NodeServices.layer)),
+  );
+}
diff --git a/apps/server/src/orchestration-v2/testkit/ReplayTranscriptNdjson.test.ts b/apps/server/src/orchestration-v2/testkit/ReplayTranscriptNdjson.test.ts
new file mode 100644
index 000000000000..d494f18b7f8a
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/ReplayTranscriptNdjson.test.ts
@@ -0,0 +1,98 @@
+import { ProviderReplayNdjsonParseError } from "./ReplayTranscriptNdjson.ts";
+import { assert, describe, it } from "@effect/vitest";
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+
+import {
+  decodeProviderReplayNdjson,
+  materializeReplayTranscriptWorkspace,
+} from "./ReplayTranscriptNdjson.ts";
+
+const encodeParseError = Schema.encodeUnknownEffect(ProviderReplayNdjsonParseError);
+
+describe("decodeProviderReplayNdjson", () => {
+  it.effect("decodes a self-describing provider replay fixture", () =>
+    Effect.gen(function* () {
+      const transcript = yield* decodeProviderReplayNdjson(`
+        {"type":"transcript_start","provider":"codex","protocol":"codex.app-server","version":"0.120.0","scenario":"simple"}
+        {"type":"expect_outbound","label":"initialize","frame":{"id":1,"method":"initialize","params":{}}}
+        {"type":"emit_inbound","label":"initialized","afterMs":5,"frame":{"id":1,"result":{"ok":true}}}
+        {"type":"runtime_exit","status":"success"}
+      `);
+
+      assert.equal(transcript.provider, "codex");
+      assert.equal(transcript.protocol, "codex.app-server");
+      assert.equal(transcript.scenario, "simple");
+      assert.deepEqual(
+        transcript.entries.map((entry) => entry.type),
+        ["expect_outbound", "emit_inbound", "runtime_exit"],
+      );
+    }),
+  );
+
+  it.effect("decodes entry-only fixtures when metadata is supplied by the test", () =>
+    Effect.gen(function* () {
+      const transcript = yield* decodeProviderReplayNdjson(
+        `
+          {"type":"emit_inbound","frame":{"method":"thread/created","params":{"id":"native-thread"}}}
+          {"type":"runtime_exit","status":"success"}
+        `,
+        {
+          provider: "claudeAgent",
+          protocol: "claude-agent-sdk",
+          version: "0.2.111",
+          scenario: "entry-only",
+        },
+      );
+
+      assert.equal(transcript.provider, "claudeAgent");
+      assert.equal(transcript.entries.length, 2);
+    }),
+  );
+
+  it.effect("returns a schema-serializable typed parse error", () =>
+    Effect.gen(function* () {
+      const error = yield* decodeProviderReplayNdjson(`{"type":`).pipe(Effect.flip);
+      const encoded = yield* encodeParseError(error);
+
+      assert.equal(error._tag, "ProviderReplayNdjsonLineParseError");
+      assert.equal(encoded._tag, "ProviderReplayNdjsonLineParseError");
+      if (encoded._tag !== "ProviderReplayNdjsonLineParseError") {
+        throw new Error("Expected line parse error encoding.");
+      }
+      assert.equal(encoded.lineNumber, 1);
+      assert.equal(encoded.line, '{"type":');
+      const cause = encoded.cause;
+      if (typeof cause !== "object" || cause === null || Array.isArray(cause)) {
+        throw new Error("Expected encoded parse cause to be a JSON object.");
+      }
+      const causeRecord = cause as Record<string, unknown>;
+      assert.equal(causeRecord.name, "SchemaError");
+      assert.doesNotThrow(() => JSON.stringify(encoded));
+    }),
+  );
+
+  it.effect("materializes outbound workspace placeholders without weakening replay frames", () =>
+    Effect.gen(function* () {
+      const transcript = yield* decodeProviderReplayNdjson(`
+        {"type":"transcript_start","provider":"codex","protocol":"codex.app-server","version":"0.120.0","scenario":"workspace"}
+        {"type":"expect_outbound","frame":{"method":"turn/start","params":{"cwd":"<workspace>","nested":["<workspace>"]}}}
+        {"type":"emit_inbound","frame":{"method":"item/completed","params":{"text":"<workspace>"}}}
+      `);
+
+      const materialized = materializeReplayTranscriptWorkspace(transcript, "/tmp/workspace");
+
+      assert.deepEqual(materialized.entries[0], {
+        type: "expect_outbound",
+        frame: {
+          method: "turn/start",
+          params: { cwd: "/tmp/workspace", nested: ["/tmp/workspace"] },
+        },
+      });
+      assert.deepEqual(materialized.entries[1], {
+        type: "emit_inbound",
+        frame: { method: "item/completed", params: { text: "<workspace>" } },
+      });
+    }),
+  );
+});
diff --git a/apps/server/src/orchestration-v2/testkit/ReplayTranscriptNdjson.ts b/apps/server/src/orchestration-v2/testkit/ReplayTranscriptNdjson.ts
new file mode 100644
index 000000000000..c7090917a1f8
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/ReplayTranscriptNdjson.ts
@@ -0,0 +1,162 @@
+import {
+  ProviderReplayEntry,
+  ProviderReplayNdjsonRecord,
+  ProviderReplayTranscript,
+  type ProviderReplayTranscriptHeader,
+} from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+
+export class ProviderReplayNdjsonLineParseError extends Schema.TaggedErrorClass<ProviderReplayNdjsonLineParseError>()(
+  "ProviderReplayNdjsonLineParseError",
+  {
+    lineNumber: Schema.Number,
+    line: Schema.String,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return `Failed to parse provider replay NDJSON line ${this.lineNumber}.`;
+  }
+}
+
+export class ProviderReplayNdjsonMissingHeaderError extends Schema.TaggedErrorClass<ProviderReplayNdjsonMissingHeaderError>()(
+  "ProviderReplayNdjsonMissingHeaderError",
+  {},
+) {
+  override get message(): string {
+    return "Provider replay NDJSON requires a transcript_start header or fallback transcript metadata.";
+  }
+}
+
+export class ProviderReplayNdjsonEmptyError extends Schema.TaggedErrorClass<ProviderReplayNdjsonEmptyError>()(
+  "ProviderReplayNdjsonEmptyError",
+  {},
+) {
+  override get message(): string {
+    return "Provider replay NDJSON did not contain any records.";
+  }
+}
+
+export const ProviderReplayNdjsonParseError = Schema.Union([
+  ProviderReplayNdjsonLineParseError,
+  ProviderReplayNdjsonMissingHeaderError,
+  ProviderReplayNdjsonEmptyError,
+]);
+export type ProviderReplayNdjsonParseError = typeof ProviderReplayNdjsonParseError.Type;
+
+export type ProviderReplayTranscriptMetadata = Omit<ProviderReplayTranscript, "entries">;
+
+export const REPLAY_TRANSCRIPT_WORKSPACE_PLACEHOLDER = "<workspace>";
+
+function materializeWorkspacePlaceholder(value: unknown, workspace: string): unknown {
+  if (value === REPLAY_TRANSCRIPT_WORKSPACE_PLACEHOLDER) {
+    return workspace;
+  }
+  if (Array.isArray(value)) {
+    return value.map((entry) => materializeWorkspacePlaceholder(entry, workspace));
+  }
+  if (typeof value !== "object" || value === null) {
+    return value;
+  }
+  return Object.fromEntries(
+    Object.entries(value).map(([key, entry]) => [
+      key,
+      materializeWorkspacePlaceholder(entry, workspace),
+    ]),
+  );
+}
+
+/**
+ * Resolves portable fixture placeholders before a replay driver sees the transcript.
+ * The resulting outbound frames still use exact structural equality during replay.
+ */
+export function materializeReplayTranscriptWorkspace(
+  transcript: ProviderReplayTranscript,
+  workspace: string,
+): ProviderReplayTranscript {
+  return {
+    ...transcript,
+    entries: transcript.entries.map((entry) =>
+      entry.type === "expect_outbound"
+        ? {
+            ...entry,
+            frame: materializeWorkspacePlaceholder(entry.frame, workspace),
+          }
+        : entry,
+    ),
+  };
+}
+
+const decodeReplayRecord = Schema.decodeUnknownSync(
+  Schema.fromJsonString(ProviderReplayNdjsonRecord),
+);
+const decodeTranscript = Schema.decodeUnknownSync(ProviderReplayTranscript);
+
+function parseReplayRecord(
+  line: string,
+  lineNumber: number,
+): Effect.Effect<ProviderReplayNdjsonRecord, ProviderReplayNdjsonLineParseError> {
+  return Effect.try({
+    try: () => decodeReplayRecord(line),
+    catch: (cause) =>
+      new ProviderReplayNdjsonLineParseError({
+        lineNumber,
+        line,
+        cause,
+      }),
+  });
+}
+
+function metadataFromHeader(
+  header: ProviderReplayTranscriptHeader,
+): ProviderReplayTranscriptMetadata {
+  const { type: _type, ...metadata } = header;
+  return metadata;
+}
+
+export function decodeProviderReplayNdjson(
+  input: string,
+  fallbackMetadata?: ProviderReplayTranscriptMetadata,
+): Effect.Effect<ProviderReplayTranscript, ProviderReplayNdjsonParseError> {
+  return Effect.gen(function* () {
+    const lines = input
+      .split(/\r?\n/u)
+      .map((line, index) => ({ line: line.trim(), lineNumber: index + 1 }))
+      .filter(({ line }) => line.length > 0);
+
+    if (lines.length === 0) {
+      return yield* new ProviderReplayNdjsonEmptyError();
+    }
+
+    const firstRecord = yield* parseReplayRecord(lines[0]!.line, lines[0]!.lineNumber);
+    const metadata =
+      firstRecord.type === "transcript_start" ? metadataFromHeader(firstRecord) : fallbackMetadata;
+
+    if (!metadata) {
+      return yield* new ProviderReplayNdjsonMissingHeaderError();
+    }
+
+    const entries: Array<ProviderReplayEntry> = [];
+    if (firstRecord.type !== "transcript_start") {
+      entries.push(firstRecord);
+    }
+
+    for (const { line, lineNumber } of lines.slice(1)) {
+      const record = yield* parseReplayRecord(line, lineNumber);
+      if (record.type === "transcript_start") {
+        return yield* new ProviderReplayNdjsonLineParseError({
+          lineNumber,
+          line,
+          cause: "transcript_start is only valid as the first replay record",
+        });
+      }
+      entries.push(record);
+    }
+
+    return decodeTranscript({
+      ...metadata,
+      entries,
+    });
+  });
+}
diff --git a/apps/server/src/orchestration-v2/testkit/ThreadFork.integration.test.ts b/apps/server/src/orchestration-v2/testkit/ThreadFork.integration.test.ts
new file mode 100644
index 000000000000..92d9b1693b16
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/ThreadFork.integration.test.ts
@@ -0,0 +1,1774 @@
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import { assert, describe, it } from "@effect/vitest";
+import {
+  CommandId,
+  MessageId,
+  type OrchestrationV2Command,
+  type OrchestrationV2ThreadProjection,
+  ProviderInstanceId,
+  type ProviderReplayEntry,
+  type ProviderReplayTranscript,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as PlatformError from "effect/PlatformError";
+import * as Schema from "effect/Schema";
+import { ChildProcess, ChildProcessSpawner } from "effect/unstable/process";
+
+import { ClaudeOrchestratorReplayHarness } from "../Adapters/ClaudeAdapterV2.testkit.ts";
+import { CodexOrchestratorReplayHarness } from "../Adapters/CodexAdapterV2.testkit.ts";
+import { IdAllocatorV2, layer as idAllocatorLayer } from "../IdAllocator.ts";
+import { provideDeterministicTestRuntime } from "./DeterministicRuntime.ts";
+import {
+  THREAD_FORK_NATIVE_PRIOR_TURN_ALPHA_PROMPT,
+  THREAD_FORK_NATIVE_PRIOR_TURN_BETA_PROMPT,
+  THREAD_FORK_NATIVE_PRIOR_TURN_REPEAT_PROMPT,
+  THREAD_FORK_NATIVE_SOURCE_PROMPT,
+  THREAD_FORK_NATIVE_TARGET_PROMPT,
+} from "./fixtures/shared.ts";
+import { runOrchestratorV2ProviderReplayScenario } from "./ProviderReplayHarness.ts";
+import {
+  decodeProviderReplayNdjson,
+  materializeReplayTranscriptWorkspace,
+} from "./ReplayTranscriptNdjson.ts";
+
+const CODEX_MODEL_SELECTION = {
+  instanceId: ProviderInstanceId.make("codex"),
+  model: "gpt-5.4",
+} as const;
+const CLAUDE_MODEL_SELECTION = {
+  instanceId: ProviderInstanceId.make("claudeAgent"),
+  model: "claude-sonnet-4-6",
+} as const;
+const TRANSCRIPT_PATH = `${import.meta.dirname}/fixtures/thread_fork_native/codex_transcript.ndjson`;
+const PRIOR_TURN_TRANSCRIPT_PATH = `${import.meta.dirname}/fixtures/thread_fork_native_prior_turn/codex_transcript.ndjson`;
+const CLAUDE_TRANSCRIPT_PATH = `${import.meta.dirname}/fixtures/thread_fork_native/claude_transcript.ndjson`;
+const CLAUDE_PRIOR_TURN_TRANSCRIPT_PATH = `${import.meta.dirname}/fixtures/thread_fork_native_prior_turn/claude_transcript.ndjson`;
+const CLAUDE_FORK_LOCAL_ROLLBACK_TRANSCRIPT_PATH = `${import.meta.dirname}/fixtures/thread_fork_native_fork_local_rollback/claude_transcript.ndjson`;
+const CODEX_READ_ONLY_NEVER_POLICY = {
+  approvalPolicy: "never",
+  sandboxPolicy: {
+    type: "readOnly",
+    access: { type: "fullAccess" },
+    networkAccess: false,
+  },
+} as const;
+
+class ThreadForkGitCommandError extends Schema.TaggedErrorClass<ThreadForkGitCommandError>()(
+  "ThreadForkGitCommandError",
+  {
+    command: Schema.String,
+    exitCode: Schema.Number,
+  },
+) {
+  override get message(): string {
+    return `${this.command} failed with exit ${this.exitCode}.`;
+  }
+}
+
+function runGit(
+  cwd: string,
+  args: ReadonlyArray<string>,
+): Effect.Effect<
+  void,
+  ThreadForkGitCommandError | PlatformError.PlatformError,
+  ChildProcessSpawner.ChildProcessSpawner
+> {
+  return Effect.gen(function* () {
+    const spawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+    const exitCode = yield* spawner.exitCode(ChildProcess.make("git", args, { cwd }));
+    if (Number(exitCode) !== 0) {
+      return yield* new ThreadForkGitCommandError({
+        command: `git ${args.join(" ")}`,
+        exitCode: Number(exitCode),
+      });
+    }
+  });
+}
+
+const makeCheckpointWorkspace = Effect.gen(function* () {
+  const fs = yield* FileSystem.FileSystem;
+  const path = yield* Path.Path;
+  const cwd = yield* fs.makeTempDirectory({ prefix: "t3-orchestrator-v2-thread-fork-" });
+  yield* runGit(cwd, ["init"]);
+  yield* runGit(cwd, ["config", "user.name", "T3 Code Test"]);
+  yield* runGit(cwd, ["config", "user.email", "t3code-test@example.com"]);
+  yield* fs.writeFileString(path.join(cwd, "README.md"), "# thread fork\n");
+  yield* runGit(cwd, ["add", "README.md"]);
+  yield* runGit(cwd, ["commit", "-m", "initial"]);
+  return cwd;
+});
+
+function readTranscript(transcriptPath: string = TRANSCRIPT_PATH) {
+  return Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const text = yield* fs.readFileString(transcriptPath);
+    return yield* decodeProviderReplayNdjson(text);
+  });
+}
+
+function metadataString(transcript: ProviderReplayTranscript, key: string): string {
+  const value = transcript.metadata?.[key];
+  if (typeof value !== "string") {
+    throw new Error(`Transcript ${transcript.scenario} is missing metadata string ${key}.`);
+  }
+  return value;
+}
+
+function metadataStringArray(
+  transcript: ProviderReplayTranscript,
+  key: string,
+): ReadonlyArray<string> {
+  const value = transcript.metadata?.[key];
+  if (!Array.isArray(value) || !value.every((entry) => typeof entry === "string")) {
+    throw new Error(`Transcript ${transcript.scenario} is missing metadata string array ${key}.`);
+  }
+  return value;
+}
+
+function userAndAssistantText(
+  projection: Pick<OrchestrationV2ThreadProjection, "visibleTurnItems">,
+): string {
+  return projection.visibleTurnItems
+    .flatMap((row) => {
+      const item = row.item;
+      return item.type === "user_message" || item.type === "assistant_message" ? [item.text] : [];
+    })
+    .join("\n");
+}
+
+function compactExpectedText(text: string, maxLength = 240): string {
+  const compacted = text.replace(/\s+/g, " ").trim();
+  if (compacted.length <= maxLength) {
+    return compacted;
+  }
+  return `${compacted.slice(0, maxLength - 3)}...`;
+}
+
+function findCompletedAgentMessageText(input: {
+  readonly transcript: ProviderReplayTranscript;
+  readonly threadId: string;
+  readonly turnId: string;
+}): string {
+  for (const entry of input.transcript.entries) {
+    if (entry.type !== "emit_inbound") {
+      continue;
+    }
+    const frame = entry.frame as {
+      readonly method?: unknown;
+      readonly params?: {
+        readonly threadId?: unknown;
+        readonly turnId?: unknown;
+        readonly item?: {
+          readonly type?: unknown;
+          readonly text?: unknown;
+        };
+      };
+    };
+    if (
+      frame.method === "item/completed" &&
+      frame.params?.threadId === input.threadId &&
+      frame.params.turnId === input.turnId &&
+      frame.params.item?.type === "agentMessage" &&
+      typeof frame.params.item.text === "string"
+    ) {
+      return frame.params.item.text;
+    }
+  }
+  throw new Error(`No completed agent message found for ${input.threadId}/${input.turnId}`);
+}
+
+function makeExpectedForkDeltaSummary(input: {
+  readonly sourceThreadId: string;
+  readonly targetThreadId: string;
+  readonly forkUserText: string;
+  readonly forkAssistantText: string;
+}): string {
+  return [
+    "Merge-back context from forked conversation.",
+    `Source thread: ${input.sourceThreadId}`,
+    `Target thread: ${input.targetThreadId}`,
+    "Covered fork runs: 1-1",
+    "",
+    "Fork delta:",
+    `- User: ${compactExpectedText(input.forkUserText)}`,
+    `- Assistant: ${compactExpectedText(input.forkAssistantText)}`,
+    "- Checkpoint: 0 files",
+  ].join("\n");
+}
+
+function transcriptWithMergeBackContinuation(input: {
+  readonly transcript: ProviderReplayTranscript;
+  readonly providerMessageText: string;
+  readonly projectedUserText: string;
+  readonly assistantText: string;
+}): ProviderReplayTranscript {
+  const sourceNativeThreadId = "019dd6ba-2681-7bf0-b051-141b0cbcbb27";
+  const mergeBackNativeTurnId = "019dd6ba-5000-7000-8000-000000000001";
+  const mergeBackUserItemId = "merge-back-user-message";
+  const mergeBackAgentItemId = "merge-back-agent-message";
+  const entriesWithoutExit = input.transcript.entries.filter(
+    (entry) => entry.type !== "runtime_exit",
+  );
+  const continuation = [
+    {
+      type: "expect_outbound",
+      label: "turn/start/merge-back-source",
+      frame: {
+        id: 9,
+        method: "turn/start",
+        params: {
+          threadId: sourceNativeThreadId,
+          input: [{ type: "text", text: input.providerMessageText }],
+          approvalPolicy: "never",
+          sandboxPolicy: {
+            type: "readOnly",
+            access: { type: "fullAccess" },
+            networkAccess: false,
+          },
+        },
+      },
+    },
+    {
+      type: "emit_inbound",
+      label: "turn/start/merge-back-source",
+      frame: {
+        id: 9,
+        result: {
+          turn: {
+            id: mergeBackNativeTurnId,
+            items: [],
+            status: "inProgress",
+            error: null,
+            startedAt: 1777424041,
+            completedAt: null,
+            durationMs: null,
+          },
+        },
+      },
+    },
+    {
+      type: "emit_inbound",
+      label: "thread/status/changed/merge-back-source",
+      frame: {
+        method: "thread/status/changed",
+        params: {
+          threadId: sourceNativeThreadId,
+          status: { type: "active", activeFlags: [] },
+        },
+      },
+    },
+    {
+      type: "emit_inbound",
+      label: "turn/started/merge-back-source",
+      frame: {
+        method: "turn/started",
+        params: {
+          threadId: sourceNativeThreadId,
+          turn: {
+            id: mergeBackNativeTurnId,
+            items: [],
+            status: "inProgress",
+            error: null,
+            startedAt: 1777424041,
+            completedAt: null,
+            durationMs: null,
+          },
+        },
+      },
+    },
+    {
+      type: "emit_inbound",
+      label: "item/userMessage/started/merge-back-source",
+      frame: {
+        method: "item/started",
+        params: {
+          item: {
+            type: "userMessage",
+            id: mergeBackUserItemId,
+            content: [{ type: "text", text: input.projectedUserText, text_elements: [] }],
+          },
+          threadId: sourceNativeThreadId,
+          turnId: mergeBackNativeTurnId,
+        },
+      },
+    },
+    {
+      type: "emit_inbound",
+      label: "item/userMessage/completed/merge-back-source",
+      frame: {
+        method: "item/completed",
+        params: {
+          item: {
+            type: "userMessage",
+            id: mergeBackUserItemId,
+            content: [{ type: "text", text: input.projectedUserText, text_elements: [] }],
+          },
+          threadId: sourceNativeThreadId,
+          turnId: mergeBackNativeTurnId,
+        },
+      },
+    },
+    {
+      type: "emit_inbound",
+      label: "item/agentMessage/started/merge-back-source",
+      frame: {
+        method: "item/started",
+        params: {
+          item: {
+            type: "agentMessage",
+            id: mergeBackAgentItemId,
+            text: "",
+            phase: "final_answer",
+            memoryCitation: null,
+          },
+          threadId: sourceNativeThreadId,
+          turnId: mergeBackNativeTurnId,
+        },
+      },
+    },
+    {
+      type: "emit_inbound",
+      label: "item/agentMessage/delta/merge-back-source",
+      frame: {
+        method: "item/agentMessage/delta",
+        params: {
+          threadId: sourceNativeThreadId,
+          turnId: mergeBackNativeTurnId,
+          itemId: mergeBackAgentItemId,
+          delta: input.assistantText,
+        },
+      },
+    },
+    {
+      type: "emit_inbound",
+      label: "item/agentMessage/completed/merge-back-source",
+      frame: {
+        method: "item/completed",
+        params: {
+          item: {
+            type: "agentMessage",
+            id: mergeBackAgentItemId,
+            text: input.assistantText,
+            phase: "final_answer",
+            memoryCitation: null,
+          },
+          threadId: sourceNativeThreadId,
+          turnId: mergeBackNativeTurnId,
+        },
+      },
+    },
+    {
+      type: "emit_inbound",
+      label: "thread/status/changed/merge-back-source",
+      frame: {
+        method: "thread/status/changed",
+        params: { threadId: sourceNativeThreadId, status: { type: "idle" } },
+      },
+    },
+    {
+      type: "emit_inbound",
+      label: "turn/completed/merge-back-source",
+      frame: {
+        method: "turn/completed",
+        params: {
+          threadId: sourceNativeThreadId,
+          turn: {
+            id: mergeBackNativeTurnId,
+            items: [],
+            status: "completed",
+            error: null,
+            startedAt: 1777424041,
+            completedAt: 1777424042,
+            durationMs: 1000,
+          },
+        },
+      },
+    },
+    { type: "runtime_exit", status: "success" },
+  ] satisfies ReadonlyArray<ProviderReplayEntry>;
+
+  return {
+    ...input.transcript,
+    scenario: `${input.transcript.scenario}_merge_back`,
+    entries: [...entriesWithoutExit, ...continuation],
+  };
+}
+
+describe("orchestration V2 thread fork", () => {
+  it.effect(
+    "creates an idle app fork and resolves it with Codex native thread/fork on first dispatch",
+    () =>
+      Effect.gen(function* () {
+        const rawTranscript = yield* readTranscript();
+        const cwd = yield* Effect.acquireRelease(makeCheckpointWorkspace, (directory) =>
+          Effect.service(FileSystem.FileSystem).pipe(
+            Effect.flatMap((fs) => fs.remove(directory, { recursive: true, force: true })),
+            Effect.orDie,
+          ),
+        );
+        const transcript = yield* CodexOrchestratorReplayHarness.decodeTranscript(
+          materializeReplayTranscriptWorkspace(rawTranscript, cwd),
+        );
+
+        const materialized = yield* Effect.gen(function* () {
+          const ids = yield* IdAllocatorV2;
+          const projectId = yield* ids.allocate.project({ fixtureName: "thread-fork-native" });
+          const sourceThreadId = yield* ids.allocate.thread({
+            fixtureName: "thread-fork-native-source",
+            projectId,
+          });
+          const targetThreadId = ThreadId.make("thread-fork-native-target");
+
+          const commands = [
+            {
+              type: "thread.create",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: yield* ids.allocate.command({
+                fixtureName: "thread-fork-native",
+                commandName: "thread-create-source",
+              }),
+              threadId: sourceThreadId,
+              projectId,
+              title: "Source thread",
+              modelSelection: CODEX_MODEL_SELECTION,
+              runtimeMode: "full-access",
+              interactionMode: "default",
+              branch: null,
+              worktreePath: null,
+            },
+            {
+              type: "message.dispatch",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: yield* ids.allocate.command({
+                fixtureName: "thread-fork-native",
+                commandName: "source-message",
+              }),
+              threadId: sourceThreadId,
+              messageId: MessageId.make("message-thread-fork-native-source"),
+              text: THREAD_FORK_NATIVE_SOURCE_PROMPT,
+              attachments: [],
+              modelSelection: CODEX_MODEL_SELECTION,
+              dispatchMode: { type: "start_immediately" },
+            },
+            {
+              type: "thread.fork",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: CommandId.make("command-thread-fork-native"),
+              sourceThreadId,
+              targetThreadId,
+              sourcePoint: { type: "latest_stable" },
+              title: "Forked thread",
+            },
+            {
+              type: "thread.fork",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: CommandId.make("command-thread-fork-native"),
+              sourceThreadId,
+              targetThreadId,
+              sourcePoint: { type: "latest_stable" },
+              title: "Forked thread",
+            },
+            {
+              type: "message.dispatch",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: yield* ids.allocate.command({
+                fixtureName: "thread-fork-native",
+                commandName: "target-message",
+              }),
+              threadId: targetThreadId,
+              messageId: MessageId.make("message-thread-fork-native-target"),
+              text: THREAD_FORK_NATIVE_TARGET_PROMPT,
+              attachments: [],
+              modelSelection: CODEX_MODEL_SELECTION,
+              dispatchMode: { type: "start_immediately" },
+            },
+          ] satisfies ReadonlyArray<OrchestrationV2Command>;
+
+          return {
+            sourceThreadId,
+            targetThreadId,
+            commands,
+          };
+        }).pipe(Effect.provide(idAllocatorLayer), provideDeterministicTestRuntime);
+
+        const result = yield* runOrchestratorV2ProviderReplayScenario(
+          {
+            name: "thread_fork_native/codex",
+            transcript,
+            commands: materialized.commands,
+            steps: [
+              { type: "dispatch", command: materialized.commands[0]!, await: true },
+              { type: "advance_clock", duration: "1 millis" },
+              { type: "dispatch", command: materialized.commands[1]!, await: true },
+              { type: "await_thread_idle", threadId: materialized.sourceThreadId },
+              { type: "dispatch", command: materialized.commands[2]!, await: true },
+              { type: "dispatch", command: materialized.commands[3]!, await: true },
+              { type: "dispatch", command: materialized.commands[4]!, await: true },
+              { type: "await_thread_idle", threadId: materialized.targetThreadId },
+            ],
+            projectionThreadIds: [materialized.sourceThreadId, materialized.targetThreadId],
+            runtimePolicyOverride: { cwd },
+          },
+          CodexOrchestratorReplayHarness,
+        ).pipe(provideDeterministicTestRuntime);
+
+        const sourceProjection = result.projections.get(materialized.sourceThreadId);
+        const targetProjection = result.projections.get(materialized.targetThreadId);
+        assert.isDefined(sourceProjection);
+        assert.isDefined(targetProjection);
+        assert.equal(targetProjection.thread.lineage.parentThreadId, materialized.sourceThreadId);
+        assert.equal(targetProjection.thread.lineage.relationshipToParent, "fork");
+        assert.lengthOf(targetProjection.providerSessions, 1);
+        assert.lengthOf(targetProjection.providerThreads, 1);
+        assert.equal(
+          targetProjection.providerThreads[0]?.nativeThreadRef?.nativeId,
+          "native-fork-thread",
+        );
+        assert.equal(
+          targetProjection.providerThreads[0]?.forkedFrom?.providerThreadId,
+          sourceProjection.providerThreads[0]?.id,
+        );
+
+        const transfers = targetProjection.contextTransfers.filter(
+          (transfer) => transfer.targetThreadId === materialized.targetThreadId,
+        );
+        assert.lengthOf(transfers, 1);
+        assert.equal(transfers[0]?.status, "consumed");
+        assert.equal(transfers[0]?.resolution?.strategy, "native_fork");
+        assert.equal(transfers[0]?.targetRunId, targetProjection.runs[0]?.id);
+
+        const transferCreatedIndex = result.domainEvents.findIndex(
+          (event) => event.type === "context-transfer.created",
+        );
+        const targetProviderSessionIndex = result.domainEvents.findIndex(
+          (event) =>
+            event.threadId === materialized.targetThreadId &&
+            event.type === "provider-session.updated",
+        );
+        const targetRunCreatedIndex = result.domainEvents.findIndex(
+          (event) => event.threadId === materialized.targetThreadId && event.type === "run.created",
+        );
+        assert.isAtLeast(transferCreatedIndex, 0);
+        assert.isAbove(targetProviderSessionIndex, transferCreatedIndex);
+        assert.isAbove(
+          targetProviderSessionIndex,
+          targetRunCreatedIndex,
+          "provider runtime state must be materialized only after the target run commits",
+        );
+
+        const forkEvents = result.domainEvents.filter(
+          (event) => event.type === "context-transfer.created",
+        );
+        assert.lengthOf(
+          forkEvents,
+          1,
+          "duplicate fork command must return the receipt without creating another transfer",
+        );
+      }).pipe(Effect.scoped, Effect.provide(NodeServices.layer)),
+  );
+
+  it.effect(
+    "creates an idle app fork and resolves it with Claude native session fork on first dispatch",
+    () =>
+      Effect.gen(function* () {
+        const rawTranscript = yield* readTranscript(CLAUDE_TRANSCRIPT_PATH);
+        const transcript = yield* ClaudeOrchestratorReplayHarness.decodeTranscript(rawTranscript);
+        const forkedNativeSessionId = metadataString(transcript, "forkedNativeSessionId");
+        const cwd = yield* Effect.acquireRelease(makeCheckpointWorkspace, (directory) =>
+          Effect.service(FileSystem.FileSystem).pipe(
+            Effect.flatMap((fs) => fs.remove(directory, { recursive: true, force: true })),
+            Effect.orDie,
+          ),
+        );
+
+        const materialized = yield* Effect.gen(function* () {
+          const ids = yield* IdAllocatorV2;
+          const projectId = yield* ids.allocate.project({ fixtureName: "thread-fork-native" });
+          const sourceThreadId = yield* ids.allocate.thread({
+            fixtureName: "thread-fork-native-source",
+            projectId,
+          });
+          const targetThreadId = ThreadId.make("thread-fork-native-target");
+
+          const commands = [
+            {
+              type: "thread.create",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: yield* ids.allocate.command({
+                fixtureName: "thread-fork-native",
+                commandName: "thread-create-source",
+              }),
+              threadId: sourceThreadId,
+              projectId,
+              title: "Source thread",
+              modelSelection: CLAUDE_MODEL_SELECTION,
+              runtimeMode: "full-access",
+              interactionMode: "default",
+              branch: null,
+              worktreePath: null,
+            },
+            {
+              type: "message.dispatch",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: yield* ids.allocate.command({
+                fixtureName: "thread-fork-native",
+                commandName: "source-message",
+              }),
+              threadId: sourceThreadId,
+              messageId: MessageId.make("message-thread-fork-native-source"),
+              text: THREAD_FORK_NATIVE_SOURCE_PROMPT,
+              attachments: [],
+              modelSelection: CLAUDE_MODEL_SELECTION,
+              dispatchMode: { type: "start_immediately" },
+            },
+            {
+              type: "thread.fork",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: CommandId.make("command-thread-fork-native"),
+              sourceThreadId,
+              targetThreadId,
+              sourcePoint: { type: "latest_stable" },
+              title: "Forked thread",
+            },
+            {
+              type: "message.dispatch",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: yield* ids.allocate.command({
+                fixtureName: "thread-fork-native",
+                commandName: "target-message",
+              }),
+              threadId: targetThreadId,
+              messageId: MessageId.make("message-thread-fork-native-target"),
+              text: THREAD_FORK_NATIVE_TARGET_PROMPT,
+              attachments: [],
+              modelSelection: CLAUDE_MODEL_SELECTION,
+              dispatchMode: { type: "start_immediately" },
+            },
+          ] satisfies ReadonlyArray<OrchestrationV2Command>;
+
+          return {
+            sourceThreadId,
+            targetThreadId,
+            commands,
+          };
+        }).pipe(Effect.provide(idAllocatorLayer), provideDeterministicTestRuntime);
+
+        const result = yield* runOrchestratorV2ProviderReplayScenario(
+          {
+            name: "thread_fork_native/claude",
+            transcript,
+            commands: materialized.commands,
+            steps: [
+              { type: "dispatch", command: materialized.commands[0]!, await: true },
+              { type: "advance_clock", duration: "1 millis" },
+              { type: "dispatch", command: materialized.commands[1]!, await: true },
+              { type: "await_thread_idle", threadId: materialized.sourceThreadId },
+              { type: "dispatch", command: materialized.commands[2]!, await: true },
+              { type: "dispatch", command: materialized.commands[3]!, await: true },
+              { type: "await_thread_idle", threadId: materialized.targetThreadId },
+            ],
+            projectionThreadIds: [materialized.sourceThreadId, materialized.targetThreadId],
+            runtimePolicyOverride: { cwd },
+          },
+          ClaudeOrchestratorReplayHarness,
+        ).pipe(provideDeterministicTestRuntime);
+
+        const sourceProjection = result.projections.get(materialized.sourceThreadId);
+        const targetProjection = result.projections.get(materialized.targetThreadId);
+        assert.isDefined(sourceProjection);
+        assert.isDefined(targetProjection);
+        assert.equal(
+          targetProjection.providerThreads[0]?.nativeThreadRef?.nativeId,
+          forkedNativeSessionId,
+        );
+        assert.equal(
+          targetProjection.providerThreads[0]?.forkedFrom?.providerThreadId,
+          sourceProjection.providerThreads[0]?.id,
+        );
+        assert.include(
+          targetProjection.turnItems
+            .filter((item) => item.type === "assistant_message")
+            .map((item) => item.text)
+            .join("\n"),
+          "fork native ok",
+        );
+
+        const transfers = targetProjection.contextTransfers.filter(
+          (transfer) => transfer.targetThreadId === materialized.targetThreadId,
+        );
+        assert.lengthOf(transfers, 1);
+        assert.equal(transfers[0]?.status, "consumed");
+        assert.equal(transfers[0]?.resolution?.strategy, "native_fork");
+      }).pipe(Effect.scoped, Effect.provide(NodeServices.layer)),
+  );
+
+  it.effect(
+    "rolls back a Codex native fork when forking from an earlier completed source turn",
+    () =>
+      Effect.gen(function* () {
+        const rawTranscript = yield* readTranscript(PRIOR_TURN_TRANSCRIPT_PATH);
+        const cwd = yield* Effect.acquireRelease(makeCheckpointWorkspace, (directory) =>
+          Effect.service(FileSystem.FileSystem).pipe(
+            Effect.flatMap((fs) => fs.remove(directory, { recursive: true, force: true })),
+            Effect.orDie,
+          ),
+        );
+        const transcript = yield* CodexOrchestratorReplayHarness.decodeTranscript(
+          materializeReplayTranscriptWorkspace(rawTranscript, cwd),
+        );
+
+        const materialized = yield* Effect.gen(function* () {
+          const ids = yield* IdAllocatorV2;
+          const projectId = yield* ids.allocate.project({
+            fixtureName: "thread-fork-native-prior-turn",
+          });
+          const sourceThreadId = yield* ids.allocate.thread({
+            fixtureName: "thread-fork-native-prior-turn-source",
+            projectId,
+          });
+          const targetThreadId = ThreadId.make("thread-fork-native-prior-turn-target");
+          const firstRunId = ids.derive.run({ threadId: sourceThreadId, ordinal: 1 });
+
+          const commands = [
+            {
+              type: "thread.create",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: yield* ids.allocate.command({
+                fixtureName: "thread-fork-native-prior-turn",
+                commandName: "thread-create-source",
+              }),
+              threadId: sourceThreadId,
+              projectId,
+              title: "Source thread",
+              modelSelection: CODEX_MODEL_SELECTION,
+              runtimeMode: "full-access",
+              interactionMode: "default",
+              branch: null,
+              worktreePath: null,
+            },
+            {
+              type: "message.dispatch",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: yield* ids.allocate.command({
+                fixtureName: "thread-fork-native-prior-turn",
+                commandName: "source-message-alpha",
+              }),
+              threadId: sourceThreadId,
+              messageId: MessageId.make("message-thread-fork-native-prior-turn-alpha"),
+              text: THREAD_FORK_NATIVE_PRIOR_TURN_ALPHA_PROMPT,
+              attachments: [],
+              modelSelection: CODEX_MODEL_SELECTION,
+              dispatchMode: { type: "start_immediately" },
+            },
+            {
+              type: "message.dispatch",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: yield* ids.allocate.command({
+                fixtureName: "thread-fork-native-prior-turn",
+                commandName: "source-message-beta",
+              }),
+              threadId: sourceThreadId,
+              messageId: MessageId.make("message-thread-fork-native-prior-turn-beta"),
+              text: THREAD_FORK_NATIVE_PRIOR_TURN_BETA_PROMPT,
+              attachments: [],
+              modelSelection: CODEX_MODEL_SELECTION,
+              dispatchMode: { type: "start_immediately" },
+            },
+            {
+              type: "thread.fork",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: CommandId.make("command-thread-fork-native-prior-turn"),
+              sourceThreadId,
+              targetThreadId,
+              sourcePoint: { type: "run", runId: firstRunId },
+              title: "Forked from first response",
+            },
+            {
+              type: "message.dispatch",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: yield* ids.allocate.command({
+                fixtureName: "thread-fork-native-prior-turn",
+                commandName: "target-message-repeat",
+              }),
+              threadId: targetThreadId,
+              messageId: MessageId.make("message-thread-fork-native-prior-turn-repeat"),
+              text: THREAD_FORK_NATIVE_PRIOR_TURN_REPEAT_PROMPT,
+              attachments: [],
+              modelSelection: CODEX_MODEL_SELECTION,
+              dispatchMode: { type: "start_immediately" },
+            },
+          ] satisfies ReadonlyArray<OrchestrationV2Command>;
+
+          return {
+            sourceThreadId,
+            targetThreadId,
+            commands,
+          };
+        }).pipe(Effect.provide(idAllocatorLayer), provideDeterministicTestRuntime);
+
+        const result = yield* runOrchestratorV2ProviderReplayScenario(
+          {
+            name: "thread_fork_native_prior_turn/codex",
+            transcript,
+            commands: materialized.commands,
+            steps: [
+              { type: "dispatch", command: materialized.commands[0]!, await: true },
+              { type: "advance_clock", duration: "1 millis" },
+              { type: "dispatch", command: materialized.commands[1]!, await: true },
+              { type: "await_thread_idle", threadId: materialized.sourceThreadId },
+              { type: "dispatch", command: materialized.commands[2]!, await: true },
+              { type: "await_thread_idle", threadId: materialized.sourceThreadId },
+              { type: "dispatch", command: materialized.commands[3]!, await: true },
+              { type: "dispatch", command: materialized.commands[4]!, await: true },
+              { type: "await_thread_idle", threadId: materialized.targetThreadId },
+            ],
+            projectionThreadIds: [materialized.sourceThreadId, materialized.targetThreadId],
+            runtimePolicyOverride: { cwd, ...CODEX_READ_ONLY_NEVER_POLICY },
+          },
+          CodexOrchestratorReplayHarness,
+        ).pipe(provideDeterministicTestRuntime);
+
+        const targetProjection = result.projections.get(materialized.targetThreadId);
+        assert.isDefined(targetProjection);
+        const targetAssistantText = targetProjection.turnItems
+          .filter((item) => item.type === "assistant_message")
+          .map((item) => item.text)
+          .join("\n");
+        assert.include(targetAssistantText, "fork boundary alpha");
+        assert.notInclude(
+          targetAssistantText,
+          "fork boundary beta",
+          "forking from the first source run must not preserve later source turns in native Codex context",
+        );
+        assert.equal(targetProjection.contextTransfers[0]?.resolution?.strategy, "native_fork");
+
+        const visibleItems = targetProjection.visibleTurnItems.map((row) => row.item);
+        assert.deepEqual(
+          visibleItems.slice(0, 2).map((item) => item.type),
+          ["user_message", "assistant_message"],
+          "fork target projection should expose inherited source history through the fork point",
+        );
+        assert.equal(
+          visibleItems[0]?.type === "user_message" ? visibleItems[0].inputIntent : undefined,
+          "turn_start",
+          "inherited fork history should preserve source message intent",
+        );
+        assert.equal(targetProjection.visibleTurnItems[0]?.visibility, "inherited");
+        assert.equal(targetProjection.visibleTurnItems[1]?.visibility, "inherited");
+        const forkMarker = targetProjection.visibleTurnItems.find(
+          (row) => row.item.type === "fork",
+        );
+        assert.isDefined(forkMarker, "fork target projection should include a visible fork marker");
+        assert.equal(forkMarker.visibility, "synthetic");
+        const targetShell = result.shellSnapshot.threads.find(
+          (thread) => thread.id === materialized.targetThreadId,
+        );
+        assert.isDefined(targetShell, "shell snapshot should include the fork target thread");
+        assert.equal(targetShell.visibleItemCount, targetProjection.visibleTurnItems.length);
+        assert.equal(targetShell.lineage.relationshipToParent, "fork");
+        assert.equal(targetShell.forkedFrom?.type, "run");
+
+        const visibleText = visibleItems
+          .filter((item) => item.type === "user_message" || item.type === "assistant_message")
+          .map((item) => item.text)
+          .join("\n");
+        assert.include(visibleText, "fork boundary alpha");
+        assert.notInclude(
+          visibleText,
+          "fork boundary beta",
+          "fork target visible projection must not inherit source turns after the fork point",
+        );
+      }).pipe(Effect.scoped, Effect.provide(NodeServices.layer)),
+  );
+
+  it.effect("forks a Claude native session from an earlier completed source turn", () =>
+    Effect.gen(function* () {
+      const rawTranscript = yield* readTranscript(CLAUDE_PRIOR_TURN_TRANSCRIPT_PATH);
+      const transcript = yield* ClaudeOrchestratorReplayHarness.decodeTranscript(rawTranscript);
+      const forkedNativeSessionId = metadataString(transcript, "forkedNativeSessionId");
+      const cwd = yield* Effect.acquireRelease(makeCheckpointWorkspace, (directory) =>
+        Effect.service(FileSystem.FileSystem).pipe(
+          Effect.flatMap((fs) => fs.remove(directory, { recursive: true, force: true })),
+          Effect.orDie,
+        ),
+      );
+
+      const materialized = yield* Effect.gen(function* () {
+        const ids = yield* IdAllocatorV2;
+        const projectId = yield* ids.allocate.project({
+          fixtureName: "thread-fork-native-prior-turn",
+        });
+        const sourceThreadId = yield* ids.allocate.thread({
+          fixtureName: "thread-fork-native-prior-turn-source",
+          projectId,
+        });
+        const targetThreadId = ThreadId.make("thread-fork-native-prior-turn-target");
+        const firstRunId = ids.derive.run({ threadId: sourceThreadId, ordinal: 1 });
+
+        const commands = [
+          {
+            type: "thread.create",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: yield* ids.allocate.command({
+              fixtureName: "thread-fork-native-prior-turn",
+              commandName: "thread-create-source",
+            }),
+            threadId: sourceThreadId,
+            projectId,
+            title: "Source thread",
+            modelSelection: CLAUDE_MODEL_SELECTION,
+            runtimeMode: "full-access",
+            interactionMode: "default",
+            branch: null,
+            worktreePath: null,
+          },
+          {
+            type: "message.dispatch",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: yield* ids.allocate.command({
+              fixtureName: "thread-fork-native-prior-turn",
+              commandName: "source-message-alpha",
+            }),
+            threadId: sourceThreadId,
+            messageId: MessageId.make("message-thread-fork-native-prior-turn-alpha"),
+            text: THREAD_FORK_NATIVE_PRIOR_TURN_ALPHA_PROMPT,
+            attachments: [],
+            modelSelection: CLAUDE_MODEL_SELECTION,
+            dispatchMode: { type: "start_immediately" },
+          },
+          {
+            type: "message.dispatch",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: yield* ids.allocate.command({
+              fixtureName: "thread-fork-native-prior-turn",
+              commandName: "source-message-beta",
+            }),
+            threadId: sourceThreadId,
+            messageId: MessageId.make("message-thread-fork-native-prior-turn-beta"),
+            text: THREAD_FORK_NATIVE_PRIOR_TURN_BETA_PROMPT,
+            attachments: [],
+            modelSelection: CLAUDE_MODEL_SELECTION,
+            dispatchMode: { type: "start_immediately" },
+          },
+          {
+            type: "thread.fork",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command-thread-fork-native-prior-turn"),
+            sourceThreadId,
+            targetThreadId,
+            sourcePoint: { type: "run", runId: firstRunId },
+            title: "Forked from first response",
+          },
+          {
+            type: "message.dispatch",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: yield* ids.allocate.command({
+              fixtureName: "thread-fork-native-prior-turn",
+              commandName: "target-message-repeat",
+            }),
+            threadId: targetThreadId,
+            messageId: MessageId.make("message-thread-fork-native-prior-turn-repeat"),
+            text: THREAD_FORK_NATIVE_PRIOR_TURN_REPEAT_PROMPT,
+            attachments: [],
+            modelSelection: CLAUDE_MODEL_SELECTION,
+            dispatchMode: { type: "start_immediately" },
+          },
+        ] satisfies ReadonlyArray<OrchestrationV2Command>;
+
+        return {
+          sourceThreadId,
+          targetThreadId,
+          commands,
+        };
+      }).pipe(Effect.provide(idAllocatorLayer), provideDeterministicTestRuntime);
+
+      const result = yield* runOrchestratorV2ProviderReplayScenario(
+        {
+          name: "thread_fork_native_prior_turn/claude",
+          transcript,
+          commands: materialized.commands,
+          steps: [
+            { type: "dispatch", command: materialized.commands[0]!, await: true },
+            { type: "advance_clock", duration: "1 millis" },
+            { type: "dispatch", command: materialized.commands[1]!, await: true },
+            { type: "await_thread_idle", threadId: materialized.sourceThreadId },
+            { type: "dispatch", command: materialized.commands[2]!, await: true },
+            { type: "await_thread_idle", threadId: materialized.sourceThreadId },
+            { type: "dispatch", command: materialized.commands[3]!, await: true },
+            { type: "dispatch", command: materialized.commands[4]!, await: true },
+            { type: "await_thread_idle", threadId: materialized.targetThreadId },
+          ],
+          projectionThreadIds: [materialized.sourceThreadId, materialized.targetThreadId],
+          runtimePolicyOverride: { cwd },
+        },
+        ClaudeOrchestratorReplayHarness,
+      ).pipe(provideDeterministicTestRuntime);
+
+      const targetProjection = result.projections.get(materialized.targetThreadId);
+      assert.isDefined(targetProjection);
+      assert.equal(
+        targetProjection.providerThreads[0]?.nativeThreadRef?.nativeId,
+        forkedNativeSessionId,
+      );
+      const targetAssistantText = targetProjection.turnItems
+        .filter((item) => item.type === "assistant_message")
+        .map((item) => item.text)
+        .join("\n");
+      assert.include(targetAssistantText, "fork boundary alpha");
+      assert.notInclude(
+        targetAssistantText,
+        "fork boundary beta",
+        "forking from the first source run must not preserve later source turns in native Claude context",
+      );
+      assert.equal(targetProjection.contextTransfers[0]?.resolution?.strategy, "native_fork");
+    }).pipe(Effect.scoped, Effect.provide(NodeServices.layer)),
+  );
+
+  it.effect("keeps a Claude native fork stable when the source thread rolls back", () =>
+    Effect.gen(function* () {
+      const rawTranscript = yield* readTranscript(CLAUDE_PRIOR_TURN_TRANSCRIPT_PATH);
+      const transcript = yield* ClaudeOrchestratorReplayHarness.decodeTranscript(rawTranscript);
+      const forkedNativeSessionId = metadataString(transcript, "forkedNativeSessionId");
+      const sourceAssistantMessageUuids = metadataStringArray(
+        transcript,
+        "sourceAssistantMessageUuids",
+      );
+      const cwd = yield* Effect.acquireRelease(makeCheckpointWorkspace, (directory) =>
+        Effect.service(FileSystem.FileSystem).pipe(
+          Effect.flatMap((fs) => fs.remove(directory, { recursive: true, force: true })),
+          Effect.orDie,
+        ),
+      );
+
+      const materialized = yield* Effect.gen(function* () {
+        const ids = yield* IdAllocatorV2;
+        const projectId = yield* ids.allocate.project({
+          fixtureName: "thread-fork-native-prior-turn-source-rollback",
+        });
+        const sourceThreadId = yield* ids.allocate.thread({
+          fixtureName: "thread-fork-native-prior-turn-source-rollback-source",
+          projectId,
+        });
+        const targetThreadId = ThreadId.make(
+          "thread-fork-native-prior-turn-source-rollback-target",
+        );
+        const firstRunId = ids.derive.run({ threadId: sourceThreadId, ordinal: 1 });
+        const secondRunId = ids.derive.run({ threadId: sourceThreadId, ordinal: 2 });
+        const checkpointScopeId = yield* ids.allocate.checkpointScope({
+          threadId: sourceThreadId,
+          name: "root",
+        });
+        const firstCheckpointId = yield* ids.allocate.checkpoint({
+          checkpointScopeId,
+          name: "1",
+        });
+
+        const commands = [
+          {
+            type: "thread.create",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: yield* ids.allocate.command({
+              fixtureName: "thread-fork-native-prior-turn-source-rollback",
+              commandName: "thread-create-source",
+            }),
+            threadId: sourceThreadId,
+            projectId,
+            title: "Source thread",
+            modelSelection: CLAUDE_MODEL_SELECTION,
+            runtimeMode: "full-access",
+            interactionMode: "default",
+            branch: null,
+            worktreePath: null,
+          },
+          {
+            type: "message.dispatch",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: yield* ids.allocate.command({
+              fixtureName: "thread-fork-native-prior-turn-source-rollback",
+              commandName: "source-message-alpha",
+            }),
+            threadId: sourceThreadId,
+            messageId: MessageId.make(
+              "message-thread-fork-native-prior-turn-source-rollback-alpha",
+            ),
+            text: THREAD_FORK_NATIVE_PRIOR_TURN_ALPHA_PROMPT,
+            attachments: [],
+            modelSelection: CLAUDE_MODEL_SELECTION,
+            dispatchMode: { type: "start_immediately" },
+          },
+          {
+            type: "message.dispatch",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: yield* ids.allocate.command({
+              fixtureName: "thread-fork-native-prior-turn-source-rollback",
+              commandName: "source-message-beta",
+            }),
+            threadId: sourceThreadId,
+            messageId: MessageId.make("message-thread-fork-native-prior-turn-source-rollback-beta"),
+            text: THREAD_FORK_NATIVE_PRIOR_TURN_BETA_PROMPT,
+            attachments: [],
+            modelSelection: CLAUDE_MODEL_SELECTION,
+            dispatchMode: { type: "start_immediately" },
+          },
+          {
+            type: "thread.fork",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command-thread-fork-native-prior-turn-source-rollback"),
+            sourceThreadId,
+            targetThreadId,
+            sourcePoint: { type: "run", runId: firstRunId },
+            title: "Forked from first response",
+          },
+          {
+            type: "message.dispatch",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: yield* ids.allocate.command({
+              fixtureName: "thread-fork-native-prior-turn-source-rollback",
+              commandName: "target-message-repeat",
+            }),
+            threadId: targetThreadId,
+            messageId: MessageId.make(
+              "message-thread-fork-native-prior-turn-source-rollback-repeat",
+            ),
+            text: THREAD_FORK_NATIVE_PRIOR_TURN_REPEAT_PROMPT,
+            attachments: [],
+            modelSelection: CLAUDE_MODEL_SELECTION,
+            dispatchMode: { type: "start_immediately" },
+          },
+          {
+            type: "checkpoint.rollback",
+            commandId: yield* ids.allocate.command({
+              fixtureName: "thread-fork-native-prior-turn-source-rollback",
+              commandName: "rollback-source-to-alpha",
+            }),
+            threadId: sourceThreadId,
+            scopeId: checkpointScopeId,
+            checkpointId: firstCheckpointId,
+          },
+        ] satisfies ReadonlyArray<OrchestrationV2Command>;
+
+        return {
+          sourceThreadId,
+          targetThreadId,
+          secondRunId,
+          commands,
+        };
+      }).pipe(Effect.provide(idAllocatorLayer), provideDeterministicTestRuntime);
+
+      const result = yield* runOrchestratorV2ProviderReplayScenario(
+        {
+          name: "thread_fork_native_prior_turn_source_rollback/claude",
+          transcript,
+          commands: materialized.commands,
+          steps: [
+            { type: "dispatch", command: materialized.commands[0]!, await: true },
+            { type: "advance_clock", duration: "1 millis" },
+            { type: "dispatch", command: materialized.commands[1]!, await: true },
+            { type: "await_thread_idle", threadId: materialized.sourceThreadId },
+            { type: "dispatch", command: materialized.commands[2]!, await: true },
+            { type: "await_thread_idle", threadId: materialized.sourceThreadId },
+            { type: "dispatch", command: materialized.commands[3]!, await: true },
+            { type: "dispatch", command: materialized.commands[4]!, await: true },
+            { type: "await_thread_idle", threadId: materialized.targetThreadId },
+            { type: "dispatch", command: materialized.commands[5]!, await: true },
+            {
+              type: "await_run_status",
+              threadId: materialized.sourceThreadId,
+              runId: materialized.secondRunId,
+              status: "rolled_back",
+            },
+          ],
+          projectionThreadIds: [materialized.sourceThreadId, materialized.targetThreadId],
+          runtimePolicyOverride: { cwd },
+        },
+        ClaudeOrchestratorReplayHarness,
+      ).pipe(provideDeterministicTestRuntime);
+
+      const sourceProjection = result.projections.get(materialized.sourceThreadId);
+      const targetProjection = result.projections.get(materialized.targetThreadId);
+      assert.isDefined(sourceProjection);
+      assert.isDefined(targetProjection);
+
+      assert.equal(
+        sourceProjection.runs.map((run) => run.status).join(","),
+        "completed,rolled_back",
+      );
+      assert.equal(
+        sourceProjection.providerThreads[0]?.nativeConversationHeadRef?.nativeId,
+        sourceAssistantMessageUuids[0],
+        "source rollback should persist the Claude resume cursor for the first assistant message",
+      );
+      assert.equal(
+        targetProjection.providerThreads[0]?.nativeThreadRef?.nativeId,
+        forkedNativeSessionId,
+      );
+      assert.equal(targetProjection.providerThreads[0]?.nativeConversationHeadRef, null);
+
+      const sourceVisibleText = userAndAssistantText(sourceProjection);
+      assert.include(sourceVisibleText, "fork boundary alpha");
+      assert.notInclude(sourceVisibleText, "fork boundary beta");
+
+      const targetVisibleText = userAndAssistantText(targetProjection);
+      assert.include(targetVisibleText, "fork boundary alpha");
+      assert.notInclude(
+        targetVisibleText,
+        "fork boundary beta",
+        "source rollback must not cause the fork target to inherit turns past its fork point",
+      );
+      assert.equal(targetProjection.contextTransfers[0]?.resolution?.strategy, "native_fork");
+    }).pipe(Effect.scoped, Effect.provide(NodeServices.layer)),
+  );
+
+  it.effect("rolls back a Claude native fork to an earlier fork-local turn", () =>
+    Effect.gen(function* () {
+      const rawTranscript = yield* readTranscript(CLAUDE_FORK_LOCAL_ROLLBACK_TRANSCRIPT_PATH);
+      const transcript = yield* ClaudeOrchestratorReplayHarness.decodeTranscript(rawTranscript);
+      const forkedNativeSessionId = metadataString(transcript, "forkedNativeSessionId");
+      const resumeSessionAt = metadataString(transcript, "resumeSessionAt");
+      const prompts = metadataStringArray(transcript, "prompts");
+      const [sourcePrompt, forkFirstPrompt, forkSecondPrompt, repeatPrompt] = prompts;
+      if (
+        sourcePrompt === undefined ||
+        forkFirstPrompt === undefined ||
+        forkSecondPrompt === undefined ||
+        repeatPrompt === undefined
+      ) {
+        throw new Error("Claude fork-local rollback transcript is missing expected prompts.");
+      }
+
+      const cwd = yield* Effect.acquireRelease(makeCheckpointWorkspace, (directory) =>
+        Effect.service(FileSystem.FileSystem).pipe(
+          Effect.flatMap((fs) => fs.remove(directory, { recursive: true, force: true })),
+          Effect.orDie,
+        ),
+      );
+
+      const materialized = yield* Effect.gen(function* () {
+        const ids = yield* IdAllocatorV2;
+        const projectId = yield* ids.allocate.project({
+          fixtureName: "thread-fork-native-fork-local-rollback",
+        });
+        const sourceThreadId = yield* ids.allocate.thread({
+          fixtureName: "thread-fork-native-fork-local-rollback-source",
+          projectId,
+        });
+        const targetThreadId = ThreadId.make("thread-fork-native-fork-local-rollback-target");
+        const targetSecondRunId = ids.derive.run({ threadId: targetThreadId, ordinal: 2 });
+        const targetCheckpointScopeId = yield* ids.allocate.checkpointScope({
+          threadId: targetThreadId,
+          name: "root",
+        });
+        const targetFirstCheckpointId = yield* ids.allocate.checkpoint({
+          checkpointScopeId: targetCheckpointScopeId,
+          name: "1",
+        });
+
+        const commands = [
+          {
+            type: "thread.create",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: yield* ids.allocate.command({
+              fixtureName: "thread-fork-native-fork-local-rollback",
+              commandName: "thread-create-source",
+            }),
+            threadId: sourceThreadId,
+            projectId,
+            title: "Source thread",
+            modelSelection: CLAUDE_MODEL_SELECTION,
+            runtimeMode: "full-access",
+            interactionMode: "default",
+            branch: null,
+            worktreePath: null,
+          },
+          {
+            type: "message.dispatch",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: yield* ids.allocate.command({
+              fixtureName: "thread-fork-native-fork-local-rollback",
+              commandName: "source-message",
+            }),
+            threadId: sourceThreadId,
+            messageId: MessageId.make("message-thread-fork-native-fork-local-rollback-source"),
+            text: sourcePrompt,
+            attachments: [],
+            modelSelection: CLAUDE_MODEL_SELECTION,
+            dispatchMode: { type: "start_immediately" },
+          },
+          {
+            type: "thread.fork",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command-thread-fork-native-fork-local-rollback"),
+            sourceThreadId,
+            targetThreadId,
+            sourcePoint: { type: "latest_stable" },
+            title: "Forked thread",
+          },
+          {
+            type: "message.dispatch",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: yield* ids.allocate.command({
+              fixtureName: "thread-fork-native-fork-local-rollback",
+              commandName: "fork-first-message",
+            }),
+            threadId: targetThreadId,
+            messageId: MessageId.make("message-thread-fork-native-fork-local-rollback-first"),
+            text: forkFirstPrompt,
+            attachments: [],
+            modelSelection: CLAUDE_MODEL_SELECTION,
+            dispatchMode: { type: "start_immediately" },
+          },
+          {
+            type: "message.dispatch",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: yield* ids.allocate.command({
+              fixtureName: "thread-fork-native-fork-local-rollback",
+              commandName: "fork-second-message",
+            }),
+            threadId: targetThreadId,
+            messageId: MessageId.make("message-thread-fork-native-fork-local-rollback-second"),
+            text: forkSecondPrompt,
+            attachments: [],
+            modelSelection: CLAUDE_MODEL_SELECTION,
+            dispatchMode: { type: "start_immediately" },
+          },
+          {
+            type: "checkpoint.rollback",
+            commandId: yield* ids.allocate.command({
+              fixtureName: "thread-fork-native-fork-local-rollback",
+              commandName: "rollback-fork-to-first",
+            }),
+            threadId: targetThreadId,
+            scopeId: targetCheckpointScopeId,
+            checkpointId: targetFirstCheckpointId,
+          },
+          {
+            type: "message.dispatch",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: yield* ids.allocate.command({
+              fixtureName: "thread-fork-native-fork-local-rollback",
+              commandName: "fork-repeat-after-rollback",
+            }),
+            threadId: targetThreadId,
+            messageId: MessageId.make("message-thread-fork-native-fork-local-rollback-repeat"),
+            text: repeatPrompt,
+            attachments: [],
+            modelSelection: CLAUDE_MODEL_SELECTION,
+            dispatchMode: { type: "start_immediately" },
+          },
+        ] satisfies ReadonlyArray<OrchestrationV2Command>;
+
+        return {
+          sourceThreadId,
+          targetThreadId,
+          targetSecondRunId,
+          commands,
+        };
+      }).pipe(Effect.provide(idAllocatorLayer), provideDeterministicTestRuntime);
+
+      const result = yield* runOrchestratorV2ProviderReplayScenario(
+        {
+          name: "thread_fork_native_fork_local_rollback/claude",
+          transcript,
+          commands: materialized.commands,
+          steps: [
+            { type: "dispatch", command: materialized.commands[0]!, await: true },
+            { type: "advance_clock", duration: "1 millis" },
+            { type: "dispatch", command: materialized.commands[1]!, await: true },
+            { type: "await_thread_idle", threadId: materialized.sourceThreadId },
+            { type: "dispatch", command: materialized.commands[2]!, await: true },
+            { type: "dispatch", command: materialized.commands[3]!, await: true },
+            { type: "await_thread_idle", threadId: materialized.targetThreadId },
+            { type: "dispatch", command: materialized.commands[4]!, await: true },
+            { type: "await_thread_idle", threadId: materialized.targetThreadId },
+            { type: "dispatch", command: materialized.commands[5]!, await: true },
+            {
+              type: "await_run_status",
+              threadId: materialized.targetThreadId,
+              runId: materialized.targetSecondRunId,
+              status: "rolled_back",
+            },
+            { type: "dispatch", command: materialized.commands[6]!, await: true },
+            { type: "await_thread_idle", threadId: materialized.targetThreadId },
+          ],
+          projectionThreadIds: [materialized.sourceThreadId, materialized.targetThreadId],
+          runtimePolicyOverride: { cwd },
+        },
+        ClaudeOrchestratorReplayHarness,
+      ).pipe(provideDeterministicTestRuntime);
+
+      const targetProjection = result.projections.get(materialized.targetThreadId);
+      assert.isDefined(targetProjection);
+      assert.equal(
+        targetProjection.providerThreads[0]?.nativeThreadRef?.nativeId,
+        forkedNativeSessionId,
+      );
+      assert.isString(resumeSessionAt);
+
+      const targetVisibleText = userAndAssistantText(targetProjection);
+      assert.include(targetVisibleText, "fork local source alpha");
+      assert.include(targetVisibleText, "fork local first");
+      assert.notInclude(
+        targetVisibleText,
+        "fork local second",
+        "rolled back fork-local turns must disappear from the projected fork thread",
+      );
+
+      const targetVisibleAssistantText = targetProjection.visibleTurnItems
+        .map((row) => row.item)
+        .filter((item) => item.type === "assistant_message")
+        .map((item) => item.text)
+        .join("\n");
+      assert.notInclude(
+        targetVisibleAssistantText,
+        "fork local second",
+        "resumeSessionAt must reopen the Claude fork before the rolled-back second fork turn",
+      );
+    }).pipe(Effect.scoped, Effect.provide(NodeServices.layer)),
+  );
+
+  // Covered with recorded Codex and Claude provider transcripts in ThreadMergeBack.integration.
+  it.skip("merges a fork delta back into the source thread through context handoff", () =>
+    Effect.gen(function* () {
+      const rawTranscript = yield* readTranscript(PRIOR_TURN_TRANSCRIPT_PATH);
+      const forkNativeThreadId = "019dd6ba-47b7-7092-8688-9cf7fe5f6498";
+      const sourceNativeThreadId = "019dd6ba-2681-7bf0-b051-141b0cbcbb27";
+      const forkRepeatNativeTurnId = "019dd6ba-47eb-7041-ad45-5abe752c28c9";
+      const forkPrompt = THREAD_FORK_NATIVE_PRIOR_TURN_REPEAT_PROMPT;
+      const mergeBackPrompt = "Acknowledge the fork context with exactly: merge back acknowledged";
+      const mergeBackAssistantText = "merge back acknowledged";
+      const materialized = yield* Effect.gen(function* () {
+        const ids = yield* IdAllocatorV2;
+        const projectId = yield* ids.allocate.project({
+          fixtureName: "thread-fork-native-prior-turn",
+        });
+        const sourceThreadId = yield* ids.allocate.thread({
+          fixtureName: "thread-fork-native-prior-turn-source",
+          projectId,
+        });
+        const targetThreadId = ThreadId.make("thread-fork-native-prior-turn-target");
+        const firstRunId = ids.derive.run({ threadId: sourceThreadId, ordinal: 1 });
+        const forkRunId = ids.derive.run({ threadId: targetThreadId, ordinal: 1 });
+
+        const commands = [
+          {
+            type: "thread.create",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: yield* ids.allocate.command({
+              fixtureName: "thread-fork-native-prior-turn",
+              commandName: "thread-create-source",
+            }),
+            threadId: sourceThreadId,
+            projectId,
+            title: "Source thread",
+            modelSelection: CODEX_MODEL_SELECTION,
+            runtimeMode: "full-access",
+            interactionMode: "default",
+            branch: null,
+            worktreePath: null,
+          },
+          {
+            type: "message.dispatch",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: yield* ids.allocate.command({
+              fixtureName: "thread-fork-native-prior-turn",
+              commandName: "source-message-alpha",
+            }),
+            threadId: sourceThreadId,
+            messageId: MessageId.make("message-thread-fork-native-prior-turn-alpha"),
+            text: THREAD_FORK_NATIVE_PRIOR_TURN_ALPHA_PROMPT,
+            attachments: [],
+            modelSelection: CODEX_MODEL_SELECTION,
+            dispatchMode: { type: "start_immediately" },
+          },
+          {
+            type: "message.dispatch",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: yield* ids.allocate.command({
+              fixtureName: "thread-fork-native-prior-turn",
+              commandName: "source-message-beta",
+            }),
+            threadId: sourceThreadId,
+            messageId: MessageId.make("message-thread-fork-native-prior-turn-beta"),
+            text: THREAD_FORK_NATIVE_PRIOR_TURN_BETA_PROMPT,
+            attachments: [],
+            modelSelection: CODEX_MODEL_SELECTION,
+            dispatchMode: { type: "start_immediately" },
+          },
+          {
+            type: "thread.fork",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command-thread-fork-native-prior-turn"),
+            sourceThreadId,
+            targetThreadId,
+            sourcePoint: { type: "run", runId: firstRunId },
+            title: "Forked from first response",
+          },
+          {
+            type: "message.dispatch",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: yield* ids.allocate.command({
+              fixtureName: "thread-fork-native-prior-turn",
+              commandName: "target-message-repeat",
+            }),
+            threadId: targetThreadId,
+            messageId: MessageId.make("message-thread-fork-native-prior-turn-repeat"),
+            text: forkPrompt,
+            attachments: [],
+            modelSelection: CODEX_MODEL_SELECTION,
+            dispatchMode: { type: "start_immediately" },
+          },
+          {
+            type: "thread.merge_back",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command-thread-merge-back-native-prior-turn-stale"),
+            sourceThreadId: targetThreadId,
+            targetThreadId: sourceThreadId,
+            sourcePoint: { type: "run", runId: forkRunId },
+          },
+          {
+            type: "thread.merge_back",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: CommandId.make("command-thread-merge-back-native-prior-turn"),
+            sourceThreadId: targetThreadId,
+            targetThreadId: sourceThreadId,
+            sourcePoint: { type: "run", runId: forkRunId },
+          },
+          {
+            type: "message.dispatch",
+            createdBy: "user",
+            creationSource: "web",
+            commandId: yield* ids.allocate.command({
+              fixtureName: "thread-fork-native-prior-turn",
+              commandName: "source-message-merge-back",
+            }),
+            threadId: sourceThreadId,
+            messageId: MessageId.make("message-thread-fork-native-prior-turn-merge-back"),
+            text: mergeBackPrompt,
+            attachments: [],
+            modelSelection: CODEX_MODEL_SELECTION,
+            dispatchMode: { type: "start_immediately" },
+          },
+        ] satisfies ReadonlyArray<OrchestrationV2Command>;
+
+        return {
+          sourceThreadId,
+          targetThreadId,
+          firstRunId,
+          forkRunId,
+          commands,
+        };
+      }).pipe(Effect.provide(idAllocatorLayer), provideDeterministicTestRuntime);
+      const expectedSummary = makeExpectedForkDeltaSummary({
+        sourceThreadId: materialized.targetThreadId,
+        targetThreadId: materialized.sourceThreadId,
+        forkUserText: forkPrompt,
+        forkAssistantText: findCompletedAgentMessageText({
+          transcript: rawTranscript,
+          threadId: forkNativeThreadId,
+          turnId: forkRepeatNativeTurnId,
+        }),
+      });
+      const providerMessageText = [
+        "Context handoff (merge_back / fork_delta_summary):",
+        expectedSummary,
+        "",
+        "User message:",
+        mergeBackPrompt,
+      ].join("\n");
+      const transcript = yield* CodexOrchestratorReplayHarness.decodeTranscript(
+        transcriptWithMergeBackContinuation({
+          transcript: rawTranscript,
+          providerMessageText,
+          projectedUserText: mergeBackPrompt,
+          assistantText: mergeBackAssistantText,
+        }),
+      );
+      const cwd = yield* Effect.acquireRelease(makeCheckpointWorkspace, (directory) =>
+        Effect.service(FileSystem.FileSystem).pipe(
+          Effect.flatMap((fs) => fs.remove(directory, { recursive: true, force: true })),
+          Effect.orDie,
+        ),
+      );
+
+      const result = yield* runOrchestratorV2ProviderReplayScenario(
+        {
+          name: "thread_fork_native_prior_turn_merge_back/codex",
+          transcript,
+          commands: materialized.commands,
+          steps: [
+            { type: "dispatch", command: materialized.commands[0]!, await: true },
+            { type: "advance_clock", duration: "1 millis" },
+            { type: "dispatch", command: materialized.commands[1]!, await: true },
+            { type: "await_thread_idle", threadId: materialized.sourceThreadId },
+            { type: "dispatch", command: materialized.commands[2]!, await: true },
+            { type: "await_thread_idle", threadId: materialized.sourceThreadId },
+            { type: "dispatch", command: materialized.commands[3]!, await: true },
+            { type: "dispatch", command: materialized.commands[4]!, await: true },
+            { type: "await_thread_idle", threadId: materialized.targetThreadId },
+            { type: "dispatch", command: materialized.commands[5]!, await: true },
+            { type: "dispatch", command: materialized.commands[6]!, await: true },
+            { type: "dispatch", command: materialized.commands[7]!, await: true },
+            { type: "await_thread_idle", threadId: materialized.sourceThreadId },
+          ],
+          projectionThreadIds: [materialized.sourceThreadId, materialized.targetThreadId],
+          runtimePolicyOverride: { cwd, ...CODEX_READ_ONLY_NEVER_POLICY },
+        },
+        CodexOrchestratorReplayHarness,
+      ).pipe(provideDeterministicTestRuntime);
+
+      const sourceProjection = result.projections.get(materialized.sourceThreadId);
+      const forkProjection = result.projections.get(materialized.targetThreadId);
+      assert.isDefined(sourceProjection);
+      assert.isDefined(forkProjection);
+
+      assert.equal(
+        sourceProjection.providerThreads[0]?.nativeThreadRef?.nativeId,
+        sourceNativeThreadId,
+        "merge-back should continue the original source provider thread",
+      );
+      assert.lengthOf(sourceProjection.runs, 3);
+      assert.equal(
+        sourceProjection.runs[2]?.contextHandoffId,
+        sourceProjection.contextHandoffs[0]?.id,
+      );
+      assert.lengthOf(sourceProjection.contextHandoffs, 1);
+      const handoff = sourceProjection.contextHandoffs[0]!;
+      assert.equal(handoff.strategy, "fork_delta_summary");
+      assert.equal(handoff.status, "ready");
+      assert.equal(handoff.threadId, materialized.sourceThreadId);
+      assert.equal(handoff.targetRunId, sourceProjection.runs[2]?.id);
+      assert.deepEqual(handoff.coveredRunOrdinals, { from: 1, to: 1 });
+      assert.include(handoff.summaryText, "Merge-back context from forked conversation.");
+      assert.include(handoff.summaryText, "Repeat the user-visible conversation");
+      assert.notInclude(
+        handoff.summaryText,
+        "fork boundary beta",
+        "merge-back context should summarize only fork-local delta after the source point",
+      );
+      assert.equal(handoff.summaryText, expectedSummary);
+
+      const mergeBackTransfers = sourceProjection.contextTransfers.filter(
+        (transfer) => transfer.type === "merge_back",
+      );
+      assert.lengthOf(mergeBackTransfers, 2);
+      const supersededTransfer = mergeBackTransfers.find(
+        (transfer) => transfer.status === "superseded",
+      );
+      const mergeBackTransfer = mergeBackTransfers.find(
+        (transfer) => transfer.status === "consumed",
+      );
+      assert.isDefined(supersededTransfer);
+      assert.isDefined(mergeBackTransfer);
+      assert.include(
+        supersededTransfer.error ?? "",
+        mergeBackTransfer.id,
+        "newer merge-back preparation should supersede the previous pending transfer",
+      );
+      assert.equal(mergeBackTransfer.sourceThreadId, materialized.targetThreadId);
+      assert.equal(mergeBackTransfer.targetThreadId, materialized.sourceThreadId);
+      assert.equal(mergeBackTransfer.sourcePoint.runId, materialized.forkRunId);
+      assert.equal(mergeBackTransfer.basePoint?.runId, materialized.firstRunId);
+      assert.equal(mergeBackTransfer.status, "consumed");
+      assert.equal(mergeBackTransfer.targetRunId, sourceProjection.runs[2]?.id);
+      assert.equal(mergeBackTransfer.resolution?.strategy, "fork_delta_context");
+      assert.equal(
+        mergeBackTransfer.resolution?.strategy === "fork_delta_context"
+          ? mergeBackTransfer.resolution.contextHandoffId
+          : null,
+        handoff.id,
+      );
+
+      const mergeBackRunItems = sourceProjection.turnItems.filter(
+        (item) => item.runId === sourceProjection.runs[2]?.id,
+      );
+      assert.deepEqual(
+        mergeBackRunItems.map((item) => item.type),
+        ["handoff", "user_message", "assistant_message", "checkpoint"],
+      );
+      const handoffItem = mergeBackRunItems[0];
+      assert.equal(handoffItem?.type, "handoff");
+      assert.equal(
+        handoffItem?.type === "handoff" ? handoffItem.contextHandoffId : null,
+        handoff.id,
+      );
+      assert.equal(handoffItem?.ordinal, 299);
+      const mergeUserItem = mergeBackRunItems.find((item) => item.type === "user_message");
+      assert.equal(
+        mergeUserItem?.type === "user_message" ? mergeUserItem.text : null,
+        mergeBackPrompt,
+      );
+      assert.notInclude(
+        sourceProjection.turnItems
+          .filter((item) => item.type === "user_message")
+          .map((item) => item.text)
+          .join("\n"),
+        "Context handoff",
+        "context handoff text should be provider input only, not projected user-visible message text",
+      );
+      assert.include(
+        sourceProjection.turnItems
+          .filter((item) => item.type === "assistant_message")
+          .map((item) => item.text)
+          .join("\n"),
+        mergeBackAssistantText,
+      );
+
+      const visibleTypes = sourceProjection.visibleTurnItems.map((row) => row.item.type);
+      assert.includeMembers(visibleTypes, ["handoff", "user_message", "assistant_message"]);
+      const sourceShell = result.shellSnapshot.threads.find(
+        (thread) => thread.id === materialized.sourceThreadId,
+      );
+      assert.isDefined(sourceShell);
+      assert.equal(sourceShell.visibleItemCount, sourceProjection.visibleTurnItems.length);
+
+      assert.include(
+        forkProjection.turnItems
+          .filter((item) => item.type === "user_message")
+          .map((item) => item.text)
+          .join("\n"),
+        forkPrompt,
+        "merge-back should not remove fork-local history",
+      );
+      assert.equal(forkProjection.contextTransfers[0]?.resolution?.strategy, "native_fork");
+    }).pipe(Effect.scoped, Effect.provide(NodeServices.layer)));
+});
diff --git a/apps/server/src/orchestration-v2/testkit/ThreadMergeBack.integration.test.ts b/apps/server/src/orchestration-v2/testkit/ThreadMergeBack.integration.test.ts
new file mode 100644
index 000000000000..9acc0baf831d
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/ThreadMergeBack.integration.test.ts
@@ -0,0 +1,668 @@
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import { assert, describe, it } from "@effect/vitest";
+import {
+  CommandId,
+  MessageId,
+  type ModelSelection,
+  type OrchestrationV2Command,
+  type OrchestrationV2ThreadProjection,
+  ProjectId,
+  ProviderInstanceId,
+  ProviderDriverKind,
+  type ProviderReplayTranscript,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+
+import { ClaudeOrchestratorReplayHarness } from "../Adapters/ClaudeAdapterV2.testkit.ts";
+import { CodexOrchestratorReplayHarness } from "../Adapters/CodexAdapterV2.testkit.ts";
+import { IdAllocatorV2, layer as idAllocatorLayer } from "../IdAllocator.ts";
+import { provideDeterministicTestRuntime } from "./DeterministicRuntime.ts";
+import {
+  THREAD_MERGE_BACK_FORK_PROMPT,
+  THREAD_MERGE_BACK_HANDOFF_PROMPT,
+  THREAD_MERGE_BACK_RECALL,
+  THREAD_MERGE_BACK_RECALL_PROMPT,
+  THREAD_MERGE_BACK_SIBLINGS_FIRST_FORK_PROMPT,
+  THREAD_MERGE_BACK_SIBLINGS_FIRST_HANDOFF_PROMPT,
+  THREAD_MERGE_BACK_SIBLINGS_RECALL,
+  THREAD_MERGE_BACK_SIBLINGS_RECALL_PROMPT,
+  THREAD_MERGE_BACK_SIBLINGS_SECOND_FORK_PROMPT,
+  THREAD_MERGE_BACK_SIBLINGS_SECOND_HANDOFF_PROMPT,
+  THREAD_MERGE_BACK_SIBLINGS_SOURCE_PROMPT,
+  THREAD_MERGE_BACK_SOURCE_PROMPT,
+} from "./fixtures/shared.ts";
+import { runOrchestratorV2ProviderReplayScenario } from "./ProviderReplayHarness.ts";
+import { makeCheckpointWorkspace } from "./ReplayFixtureWorkspace.ts";
+import {
+  decodeProviderReplayNdjson,
+  materializeReplayTranscriptWorkspace,
+} from "./ReplayTranscriptNdjson.ts";
+
+const CODEX_MODEL_SELECTION = {
+  instanceId: ProviderInstanceId.make("codex"),
+  model: "gpt-5.4",
+} as const;
+const CLAUDE_MODEL_SELECTION = {
+  instanceId: ProviderInstanceId.make("claudeAgent"),
+  model: "claude-sonnet-4-6",
+} as const;
+const MERGE_BACK_USER_TEXT =
+  "Retain the transferred fork marker for later. Respond with exactly: merge delta stored";
+const FIRST_SIBLING_MERGE_USER_TEXT =
+  "Retain the first transferred marker for later. Respond with exactly: first merge delta stored";
+const SECOND_SIBLING_MERGE_USER_TEXT =
+  "Retain the second transferred marker for later. Respond with exactly: second merge delta stored";
+
+interface ProviderVariant {
+  readonly driver: ProviderDriverKind;
+  readonly modelSelection: ModelSelection;
+}
+
+const PROVIDERS: ReadonlyArray<ProviderVariant> = [
+  {
+    driver: ProviderDriverKind.make("codex"),
+    modelSelection: CODEX_MODEL_SELECTION,
+  },
+  {
+    driver: ProviderDriverKind.make("claudeAgent"),
+    modelSelection: CLAUDE_MODEL_SELECTION,
+  },
+];
+
+function transcriptPath(scenario: string, driver: ProviderDriverKind): string {
+  const fileName = driver === "codex" ? "codex_transcript.ndjson" : "claude_transcript.ndjson";
+  return `${import.meta.dirname}/fixtures/${scenario}/${fileName}`;
+}
+
+function readTranscript(scenario: string, driver: ProviderDriverKind) {
+  return Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const text = yield* fs.readFileString(transcriptPath(scenario, driver));
+    return yield* decodeProviderReplayNdjson(text);
+  });
+}
+
+function compactExpectedText(text: string, maxLength = 240): string {
+  const compacted = text.replace(/\s+/gu, " ").trim();
+  return compacted.length <= maxLength ? compacted : `${compacted.slice(0, maxLength - 3)}...`;
+}
+
+function forkDeltaSummary(input: {
+  readonly sourceThreadId: ThreadId;
+  readonly targetThreadId: ThreadId;
+  readonly forkUserText: string;
+  readonly forkAssistantText: string;
+}): string {
+  return [
+    "Merge-back context from forked conversation.",
+    `Source thread: ${input.sourceThreadId}`,
+    `Target thread: ${input.targetThreadId}`,
+    "Covered fork runs: 1-1",
+    "",
+    "Fork delta:",
+    `- User: ${compactExpectedText(input.forkUserText)}`,
+    `- Assistant: ${compactExpectedText(input.forkAssistantText)}`,
+    "- Checkpoint: 0 files",
+  ].join("\n");
+}
+
+function providerMessage(summary: string, userText: string): string {
+  return [
+    "Context handoff (merge_back / fork_delta_summary):",
+    summary,
+    "",
+    "User message:",
+    userText,
+  ].join("\n");
+}
+
+function replaceExactString(value: unknown, from: string, to: string): unknown {
+  if (value === from) {
+    return to;
+  }
+  if (Array.isArray(value)) {
+    return value.map((entry) => replaceExactString(entry, from, to));
+  }
+  if (typeof value !== "object" || value === null) {
+    return value;
+  }
+  return Object.fromEntries(
+    Object.entries(value).map(([key, entry]) => [key, replaceExactString(entry, from, to)]),
+  );
+}
+
+function parameterizeHandoffs(
+  transcript: ProviderReplayTranscript,
+  replacements: ReadonlyArray<readonly [recorded: string, generated: string]>,
+): ProviderReplayTranscript {
+  return replacements.reduce(
+    (current, [recorded, generated]) =>
+      replaceExactString(current, recorded, generated) as ProviderReplayTranscript,
+    transcript,
+  );
+}
+
+function nativeSourceThreadId(transcript: ProviderReplayTranscript): string {
+  if (transcript.provider === "claudeAgent") {
+    const value = transcript.metadata?.nativeSessionId;
+    if (typeof value !== "string") {
+      throw new Error(`${transcript.scenario} is missing metadata.nativeSessionId.`);
+    }
+    return value;
+  }
+  for (const entry of transcript.entries) {
+    if (entry.type !== "emit_inbound") {
+      continue;
+    }
+    const frame = entry.frame as {
+      readonly method?: unknown;
+      readonly params?: { readonly thread?: { readonly id?: unknown } };
+    };
+    if (frame.method === "thread/started" && typeof frame.params?.thread?.id === "string") {
+      return frame.params.thread.id;
+    }
+  }
+  throw new Error(`${transcript.scenario} is missing the source native thread id.`);
+}
+
+function visibleConversationText(projection: OrchestrationV2ThreadProjection): string {
+  return projection.visibleTurnItems
+    .flatMap(({ item }) =>
+      item.type === "user_message" || item.type === "assistant_message" ? [item.text] : [],
+    )
+    .join("\n");
+}
+
+function normalizePipeSpacing(text: string): string {
+  return text.replace(/\s*\|\s*/gu, "|");
+}
+
+function makeCreateCommand(input: {
+  readonly commandId: CommandId;
+  readonly threadId: ThreadId;
+  readonly projectId: ProjectId;
+  readonly modelSelection: ModelSelection;
+}): OrchestrationV2Command {
+  return {
+    type: "thread.create",
+    createdBy: "user",
+    creationSource: "web",
+    commandId: input.commandId,
+    threadId: input.threadId,
+    projectId: input.projectId,
+    title: "Merge-back source",
+    modelSelection: input.modelSelection,
+    runtimeMode: "full-access",
+    interactionMode: "default",
+    branch: null,
+    worktreePath: null,
+  };
+}
+
+describe("orchestration V2 merge-back provider replay", () => {
+  for (const variant of PROVIDERS) {
+    it.effect(`merges one fork delta back into the original ${variant.driver} thread`, () =>
+      Effect.gen(function* () {
+        const rawTranscript = yield* readTranscript("thread_merge_back_continue", variant.driver);
+        const materialized = yield* Effect.gen(function* () {
+          const ids = yield* IdAllocatorV2;
+          const projectId = yield* ids.allocate.project({
+            fixtureName: `thread-merge-back-${variant.driver}`,
+          });
+          const sourceThreadId = yield* ids.allocate.thread({
+            fixtureName: `thread-merge-back-${variant.driver}-source`,
+            projectId,
+          });
+          const forkThreadId = ThreadId.make(`thread-merge-back-${variant.driver}-fork`);
+          const forkRunId = ids.derive.run({ threadId: forkThreadId, ordinal: 1 });
+          const commands = [
+            makeCreateCommand({
+              commandId: yield* ids.allocate.command({
+                fixtureName: `thread-merge-back-${variant.driver}`,
+                commandName: "create",
+              }),
+              threadId: sourceThreadId,
+              projectId,
+              modelSelection: variant.modelSelection,
+            }),
+            {
+              type: "message.dispatch",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: yield* ids.allocate.command({
+                fixtureName: `thread-merge-back-${variant.driver}`,
+                commandName: "source",
+              }),
+              threadId: sourceThreadId,
+              messageId: MessageId.make(`message-merge-source-${variant.driver}`),
+              text: THREAD_MERGE_BACK_SOURCE_PROMPT,
+              attachments: [],
+              modelSelection: variant.modelSelection,
+              dispatchMode: { type: "start_immediately" },
+            },
+            {
+              type: "thread.fork",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: CommandId.make(`command-merge-fork-${variant.driver}`),
+              sourceThreadId,
+              targetThreadId: forkThreadId,
+              sourcePoint: { type: "latest_stable" },
+              title: "Merge-back fork",
+            },
+            {
+              type: "message.dispatch",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: yield* ids.allocate.command({
+                fixtureName: `thread-merge-back-${variant.driver}`,
+                commandName: "fork-delta",
+              }),
+              threadId: forkThreadId,
+              messageId: MessageId.make(`message-merge-fork-${variant.driver}`),
+              text: THREAD_MERGE_BACK_FORK_PROMPT,
+              attachments: [],
+              modelSelection: variant.modelSelection,
+              dispatchMode: { type: "start_immediately" },
+            },
+            {
+              type: "thread.merge_back",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: CommandId.make(`command-merge-back-${variant.driver}`),
+              sourceThreadId: forkThreadId,
+              targetThreadId: sourceThreadId,
+              sourcePoint: { type: "run", runId: forkRunId },
+            },
+            {
+              type: "message.dispatch",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: yield* ids.allocate.command({
+                fixtureName: `thread-merge-back-${variant.driver}`,
+                commandName: "consume-merge",
+              }),
+              threadId: sourceThreadId,
+              messageId: MessageId.make(`message-consume-merge-${variant.driver}`),
+              text: MERGE_BACK_USER_TEXT,
+              attachments: [],
+              modelSelection: variant.modelSelection,
+              dispatchMode: { type: "start_immediately" },
+            },
+            {
+              type: "message.dispatch",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: yield* ids.allocate.command({
+                fixtureName: `thread-merge-back-${variant.driver}`,
+                commandName: "recall",
+              }),
+              threadId: sourceThreadId,
+              messageId: MessageId.make(`message-merge-recall-${variant.driver}`),
+              text: THREAD_MERGE_BACK_RECALL_PROMPT,
+              attachments: [],
+              modelSelection: variant.modelSelection,
+              dispatchMode: { type: "start_immediately" },
+            },
+          ] satisfies ReadonlyArray<OrchestrationV2Command>;
+          return { commands, sourceThreadId, forkThreadId, forkRunId };
+        }).pipe(Effect.provide(idAllocatorLayer), provideDeterministicTestRuntime);
+        const summary = forkDeltaSummary({
+          sourceThreadId: materialized.forkThreadId,
+          targetThreadId: materialized.sourceThreadId,
+          forkUserText: THREAD_MERGE_BACK_FORK_PROMPT,
+          forkAssistantText: "merge fork stored",
+        });
+        const generatedProviderMessage = providerMessage(summary, MERGE_BACK_USER_TEXT);
+        const parameterizedTranscript = parameterizeHandoffs(rawTranscript, [
+          [THREAD_MERGE_BACK_HANDOFF_PROMPT, generatedProviderMessage],
+        ]);
+        const cwd = yield* Effect.acquireRelease(
+          Effect.promise(() => makeCheckpointWorkspace(`merge-back-${variant.driver}`)),
+          (directory) =>
+            Effect.service(FileSystem.FileSystem).pipe(
+              Effect.flatMap((fs) => fs.remove(directory, { recursive: true, force: true })),
+              Effect.orDie,
+            ),
+        );
+        const scenario = {
+          name: `thread_merge_back_continue/${variant.driver}`,
+          commands: materialized.commands,
+          steps: [
+            { type: "dispatch" as const, command: materialized.commands[0]!, await: true },
+            { type: "advance_clock" as const, duration: "1 millis" as const },
+            { type: "dispatch" as const, command: materialized.commands[1]!, await: true },
+            { type: "await_thread_idle" as const, threadId: materialized.sourceThreadId },
+            { type: "dispatch" as const, command: materialized.commands[2]!, await: true },
+            { type: "dispatch" as const, command: materialized.commands[3]!, await: true },
+            { type: "await_thread_idle" as const, threadId: materialized.forkThreadId },
+            { type: "dispatch" as const, command: materialized.commands[4]!, await: true },
+            { type: "dispatch" as const, command: materialized.commands[5]!, await: true },
+            { type: "await_thread_idle" as const, threadId: materialized.sourceThreadId },
+            { type: "dispatch" as const, command: materialized.commands[6]!, await: true },
+            { type: "await_thread_idle" as const, threadId: materialized.sourceThreadId },
+          ],
+          projectionThreadIds: [materialized.sourceThreadId, materialized.forkThreadId],
+          runtimePolicyOverride: { cwd },
+        };
+        const result =
+          variant.driver === "codex"
+            ? yield* runOrchestratorV2ProviderReplayScenario(
+                {
+                  ...scenario,
+                  transcript: yield* CodexOrchestratorReplayHarness.decodeTranscript(
+                    materializeReplayTranscriptWorkspace(parameterizedTranscript, cwd),
+                  ),
+                },
+                CodexOrchestratorReplayHarness,
+              ).pipe(provideDeterministicTestRuntime)
+            : yield* runOrchestratorV2ProviderReplayScenario(
+                {
+                  ...scenario,
+                  transcript:
+                    yield* ClaudeOrchestratorReplayHarness.decodeTranscript(
+                      parameterizedTranscript,
+                    ),
+                },
+                ClaudeOrchestratorReplayHarness,
+              ).pipe(provideDeterministicTestRuntime);
+
+        const source = result.projections.get(materialized.sourceThreadId);
+        const fork = result.projections.get(materialized.forkThreadId);
+        assert.isDefined(source);
+        assert.isDefined(fork);
+        assert.equal(
+          source.providerThreads[0]?.nativeThreadRef?.nativeId,
+          nativeSourceThreadId(rawTranscript),
+        );
+        assert.lengthOf(source.contextHandoffs, 1);
+        assert.equal(source.contextHandoffs[0]?.summaryText, summary);
+        assert.equal(source.contextHandoffs[0]?.strategy, "fork_delta_summary");
+        const mergeTransfer = source.contextTransfers.find(
+          (transfer) => transfer.type === "merge_back",
+        );
+        assert.isDefined(mergeTransfer);
+        assert.equal(mergeTransfer.status, "consumed");
+        assert.equal(mergeTransfer.sourcePoint.runId, materialized.forkRunId);
+        assert.equal(mergeTransfer.resolution?.strategy, "fork_delta_context");
+        assert.include(
+          normalizePipeSpacing(visibleConversationText(source)),
+          THREAD_MERGE_BACK_RECALL,
+        );
+        assert.notInclude(visibleConversationText(source), "Context handoff (");
+        assert.include(visibleConversationText(fork), "merge fork stored");
+      }).pipe(Effect.scoped, Effect.provide(NodeServices.layer)),
+    );
+
+    it.effect(`merges two sibling fork deltas into the original ${variant.driver} thread`, () =>
+      Effect.gen(function* () {
+        const rawTranscript = yield* readTranscript("thread_merge_back_siblings", variant.driver);
+        const materialized = yield* Effect.gen(function* () {
+          const ids = yield* IdAllocatorV2;
+          const fixtureName = `thread-merge-back-siblings-${variant.driver}`;
+          const projectId = yield* ids.allocate.project({ fixtureName });
+          const sourceThreadId = yield* ids.allocate.thread({
+            fixtureName: `${fixtureName}-source`,
+            projectId,
+          });
+          const firstForkThreadId = ThreadId.make(`${fixtureName}-first-fork`);
+          const secondForkThreadId = ThreadId.make(`${fixtureName}-second-fork`);
+          const firstForkRunId = ids.derive.run({ threadId: firstForkThreadId, ordinal: 1 });
+          const secondForkRunId = ids.derive.run({ threadId: secondForkThreadId, ordinal: 1 });
+          const commandId = (commandName: string) =>
+            ids.allocate.command({ fixtureName, commandName });
+          const commands = [
+            makeCreateCommand({
+              commandId: yield* commandId("create"),
+              threadId: sourceThreadId,
+              projectId,
+              modelSelection: variant.modelSelection,
+            }),
+            {
+              type: "message.dispatch",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: yield* commandId("source"),
+              threadId: sourceThreadId,
+              messageId: MessageId.make(`message-${fixtureName}-source`),
+              text: THREAD_MERGE_BACK_SIBLINGS_SOURCE_PROMPT,
+              attachments: [],
+              modelSelection: variant.modelSelection,
+              dispatchMode: { type: "start_immediately" },
+            },
+            {
+              type: "thread.fork",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: yield* commandId("first-fork"),
+              sourceThreadId,
+              targetThreadId: firstForkThreadId,
+              sourcePoint: { type: "latest_stable" },
+              title: "First merge-back sibling",
+            },
+            {
+              type: "message.dispatch",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: yield* commandId("first-fork-delta"),
+              threadId: firstForkThreadId,
+              messageId: MessageId.make(`message-${fixtureName}-first-fork`),
+              text: THREAD_MERGE_BACK_SIBLINGS_FIRST_FORK_PROMPT,
+              attachments: [],
+              modelSelection: variant.modelSelection,
+              dispatchMode: { type: "start_immediately" },
+            },
+            {
+              type: "thread.fork",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: yield* commandId("second-fork"),
+              sourceThreadId,
+              targetThreadId: secondForkThreadId,
+              sourcePoint: { type: "latest_stable" },
+              title: "Second merge-back sibling",
+            },
+            {
+              type: "message.dispatch",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: yield* commandId("second-fork-delta"),
+              threadId: secondForkThreadId,
+              messageId: MessageId.make(`message-${fixtureName}-second-fork`),
+              text: THREAD_MERGE_BACK_SIBLINGS_SECOND_FORK_PROMPT,
+              attachments: [],
+              modelSelection: variant.modelSelection,
+              dispatchMode: { type: "start_immediately" },
+            },
+            {
+              type: "thread.merge_back",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: yield* commandId("merge-first"),
+              sourceThreadId: firstForkThreadId,
+              targetThreadId: sourceThreadId,
+              sourcePoint: { type: "run", runId: firstForkRunId },
+            },
+            {
+              type: "message.dispatch",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: yield* commandId("consume-first"),
+              threadId: sourceThreadId,
+              messageId: MessageId.make(`message-${fixtureName}-consume-first`),
+              text: FIRST_SIBLING_MERGE_USER_TEXT,
+              attachments: [],
+              modelSelection: variant.modelSelection,
+              dispatchMode: { type: "start_immediately" },
+            },
+            {
+              type: "thread.merge_back",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: yield* commandId("merge-second"),
+              sourceThreadId: secondForkThreadId,
+              targetThreadId: sourceThreadId,
+              sourcePoint: { type: "run", runId: secondForkRunId },
+            },
+            {
+              type: "message.dispatch",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: yield* commandId("consume-second"),
+              threadId: sourceThreadId,
+              messageId: MessageId.make(`message-${fixtureName}-consume-second`),
+              text: SECOND_SIBLING_MERGE_USER_TEXT,
+              attachments: [],
+              modelSelection: variant.modelSelection,
+              dispatchMode: { type: "start_immediately" },
+            },
+            {
+              type: "message.dispatch",
+              createdBy: "user",
+              creationSource: "web",
+              commandId: yield* commandId("recall"),
+              threadId: sourceThreadId,
+              messageId: MessageId.make(`message-${fixtureName}-recall`),
+              text: THREAD_MERGE_BACK_SIBLINGS_RECALL_PROMPT,
+              attachments: [],
+              modelSelection: variant.modelSelection,
+              dispatchMode: { type: "start_immediately" },
+            },
+          ] satisfies ReadonlyArray<OrchestrationV2Command>;
+          return {
+            commands,
+            sourceThreadId,
+            firstForkThreadId,
+            secondForkThreadId,
+            firstForkRunId,
+            secondForkRunId,
+          };
+        }).pipe(Effect.provide(idAllocatorLayer), provideDeterministicTestRuntime);
+        const firstSummary = forkDeltaSummary({
+          sourceThreadId: materialized.firstForkThreadId,
+          targetThreadId: materialized.sourceThreadId,
+          forkUserText: THREAD_MERGE_BACK_SIBLINGS_FIRST_FORK_PROMPT,
+          forkAssistantText: "first merge sibling stored",
+        });
+        const secondSummary = forkDeltaSummary({
+          sourceThreadId: materialized.secondForkThreadId,
+          targetThreadId: materialized.sourceThreadId,
+          forkUserText: THREAD_MERGE_BACK_SIBLINGS_SECOND_FORK_PROMPT,
+          forkAssistantText: "second merge sibling stored",
+        });
+        const transcript = parameterizeHandoffs(rawTranscript, [
+          [
+            THREAD_MERGE_BACK_SIBLINGS_FIRST_HANDOFF_PROMPT,
+            providerMessage(firstSummary, FIRST_SIBLING_MERGE_USER_TEXT),
+          ],
+          [
+            THREAD_MERGE_BACK_SIBLINGS_SECOND_HANDOFF_PROMPT,
+            providerMessage(secondSummary, SECOND_SIBLING_MERGE_USER_TEXT),
+          ],
+        ]);
+        const cwd = yield* Effect.acquireRelease(
+          Effect.promise(() => makeCheckpointWorkspace(`merge-back-siblings-${variant.driver}`)),
+          (directory) =>
+            Effect.service(FileSystem.FileSystem).pipe(
+              Effect.flatMap((fs) => fs.remove(directory, { recursive: true, force: true })),
+              Effect.orDie,
+            ),
+        );
+        const steps = [
+          { type: "dispatch" as const, command: materialized.commands[0]!, await: true },
+          { type: "advance_clock" as const, duration: "1 millis" as const },
+          { type: "dispatch" as const, command: materialized.commands[1]!, await: true },
+          { type: "await_thread_idle" as const, threadId: materialized.sourceThreadId },
+          { type: "dispatch" as const, command: materialized.commands[2]!, await: true },
+          { type: "dispatch" as const, command: materialized.commands[3]!, await: true },
+          { type: "await_thread_idle" as const, threadId: materialized.firstForkThreadId },
+          { type: "dispatch" as const, command: materialized.commands[4]!, await: true },
+          { type: "dispatch" as const, command: materialized.commands[5]!, await: true },
+          { type: "await_thread_idle" as const, threadId: materialized.secondForkThreadId },
+          { type: "dispatch" as const, command: materialized.commands[6]!, await: true },
+          { type: "dispatch" as const, command: materialized.commands[7]!, await: true },
+          { type: "await_thread_idle" as const, threadId: materialized.sourceThreadId },
+          { type: "dispatch" as const, command: materialized.commands[8]!, await: true },
+          { type: "dispatch" as const, command: materialized.commands[9]!, await: true },
+          { type: "await_thread_idle" as const, threadId: materialized.sourceThreadId },
+          { type: "dispatch" as const, command: materialized.commands[10]!, await: true },
+          { type: "await_thread_idle" as const, threadId: materialized.sourceThreadId },
+        ];
+        const scenario = {
+          name: `thread_merge_back_siblings/${variant.driver}`,
+          commands: materialized.commands,
+          steps,
+          projectionThreadIds: [
+            materialized.sourceThreadId,
+            materialized.firstForkThreadId,
+            materialized.secondForkThreadId,
+          ],
+          runtimePolicyOverride: { cwd },
+        };
+        const result =
+          variant.driver === "codex"
+            ? yield* runOrchestratorV2ProviderReplayScenario(
+                {
+                  ...scenario,
+                  transcript: yield* CodexOrchestratorReplayHarness.decodeTranscript(
+                    materializeReplayTranscriptWorkspace(transcript, cwd),
+                  ),
+                },
+                CodexOrchestratorReplayHarness,
+              ).pipe(provideDeterministicTestRuntime)
+            : yield* runOrchestratorV2ProviderReplayScenario(
+                {
+                  ...scenario,
+                  transcript: yield* ClaudeOrchestratorReplayHarness.decodeTranscript(transcript),
+                },
+                ClaudeOrchestratorReplayHarness,
+              ).pipe(provideDeterministicTestRuntime);
+
+        const source = result.projections.get(materialized.sourceThreadId);
+        const firstFork = result.projections.get(materialized.firstForkThreadId);
+        const secondFork = result.projections.get(materialized.secondForkThreadId);
+        assert.isDefined(source);
+        assert.isDefined(firstFork);
+        assert.isDefined(secondFork);
+        assert.equal(
+          source.providerThreads[0]?.nativeThreadRef?.nativeId,
+          nativeSourceThreadId(rawTranscript),
+        );
+        const firstForkNativeId = firstFork.providerThreads[0]?.nativeThreadRef?.nativeId;
+        const secondForkNativeId = secondFork.providerThreads[0]?.nativeThreadRef?.nativeId;
+        assert.isDefined(firstForkNativeId);
+        assert.isDefined(secondForkNativeId);
+        assert.notEqual(firstForkNativeId, secondForkNativeId);
+        assert.notEqual(firstForkNativeId, source.providerThreads[0]?.nativeThreadRef?.nativeId);
+        assert.notEqual(secondForkNativeId, source.providerThreads[0]?.nativeThreadRef?.nativeId);
+        assert.deepEqual(
+          source.contextHandoffs.map((handoff) => handoff.summaryText),
+          [firstSummary, secondSummary],
+        );
+        const mergeTransfers = source.contextTransfers.filter(
+          (transfer) => transfer.type === "merge_back",
+        );
+        assert.lengthOf(mergeTransfers, 2);
+        assert.deepEqual(
+          mergeTransfers.map((transfer) => transfer.status),
+          ["consumed", "consumed"],
+        );
+        assert.deepEqual(
+          mergeTransfers.map((transfer) => transfer.sourcePoint.runId),
+          [materialized.firstForkRunId, materialized.secondForkRunId],
+        );
+        assert.include(
+          normalizePipeSpacing(visibleConversationText(source)),
+          THREAD_MERGE_BACK_SIBLINGS_RECALL,
+        );
+        assert.notInclude(visibleConversationText(source), "Context handoff (");
+        assert.include(visibleConversationText(firstFork), "first merge sibling stored");
+        assert.notInclude(visibleConversationText(firstFork), "second merge sibling stored");
+        assert.include(visibleConversationText(secondFork), "second merge sibling stored");
+        assert.notInclude(visibleConversationText(secondFork), "first merge sibling stored");
+      }).pipe(Effect.scoped, Effect.provide(NodeServices.layer)),
+    );
+  }
+});
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/acp_elicitation/grok_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/acp_elicitation/grok_transcript.ndjson
new file mode 100644
index 000000000000..674723056c59
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/acp_elicitation/grok_transcript.ndjson
@@ -0,0 +1,11 @@
+{"type":"transcript_start","provider":"grok","protocol":"acp.ndjson-jsonrpc","version":"1","scenario":"acp_elicitation","metadata":{"generatedBy":"protocol-semantic-fixture","nativeSessionId":"grok-replay-session-1"}}
+{"type":"expect_outbound","label":"initialize","frame":{"kind":"request","method":"initialize","params":{"protocolVersion":1,"clientCapabilities":{"fs":{"readTextFile":false,"writeTextFile":false},"terminal":false,"elicitation":{"form":{}}},"clientInfo":{"name":"t3-code","version":"0.0.0"}}}}
+{"type":"emit_inbound","label":"initialized","frame":{"kind":"response","method":"initialize","result":{"protocolVersion":1,"agentCapabilities":{"loadSession":true,"mcpCapabilities":{"http":true,"sse":true},"promptCapabilities":{"audio":false,"embeddedContext":true,"image":false}},"authMethods":[{"id":"replay","name":"Replay"}],"agentInfo":{"name":"generic-acp-replay","version":"1"}}}}
+{"type":"expect_outbound","label":"session.new","frame":{"kind":"request","method":"session/new","params":{"cwd":"<workspace>","mcpServers":"<any>"}}}
+{"type":"emit_inbound","label":"session.created","frame":{"kind":"response","method":"session/new","result":{"sessionId":"grok-replay-session-1","models":{"currentModelId":"grok-build","availableModels":[{"modelId":"grok-build","name":"Grok Build"}]}}}}
+{"type":"expect_outbound","label":"session.prompt","frame":{"kind":"request","method":"session/prompt","params":{"sessionId":"grok-replay-session-1","prompt":[{"type":"text","text":"Use request_user_input to ask one multiple-choice clarifying question about whether this fixture should prefer strict schemas or UI flexibility. After receiving the answer, respond exactly: plan questions fixture complete"}]}}}
+{"type":"emit_inbound","label":"elicitation.request","frame":{"kind":"request","method":"session/elicitation","params":{"sessionId":"grok-replay-session-1","mode":"form","message":"Choose the fixture preference.","requestedSchema":{"type":"object","title":"Fixture preference","properties":{"schema_vs_ui_flexibility":{"type":"string","title":"Fixture","description":"Should this fixture prefer strict schemas or UI flexibility?","enum":["Strict schemas (Recommended)","UI flexibility"]}},"required":["schema_vs_ui_flexibility"]}}}}
+{"type":"expect_outbound","label":"elicitation.response","frame":{"kind":"response","method":"session/elicitation","result":{"action":{"action":"accept","content":{"schema_vs_ui_flexibility":"Strict schemas (Recommended)"}}}}}
+{"type":"emit_inbound","label":"assistant.final","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"grok-replay-session-1","update":{"sessionUpdate":"agent_message_chunk","content":{"type":"text","text":"plan questions fixture complete"}}}}}
+{"type":"emit_inbound","label":"prompt.completed","frame":{"kind":"response","method":"session/prompt","result":{"stopReason":"end_turn"}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/claude_background_task_after_root/claude_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/claude_background_task_after_root/claude_transcript.ndjson
new file mode 100644
index 000000000000..2e22da2d3b9b
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/claude_background_task_after_root/claude_transcript.ndjson
@@ -0,0 +1,13 @@
+{"type":"transcript_start","provider":"claudeAgent","protocol":"claude-agent-sdk.query","version":"0.2.111","scenario":"claude_background_task_after_root","metadata":{"prompts":["Live-test post-settle background Bash wake. Do exactly this in order, with no extra steps.\n\n1) Run this exact command using the Bash tool with run_in_background set to true:\n   sleep 25 && echo L2_BG_DONE\n2) Immediately after starting it, reply with a short message containing exactly L2_STARTED and stop.\n3) Do NOT poll TaskOutput. Do NOT wait for the task. Do not spawn subagents or monitors.\n4) If its completion is reported later, acknowledge it once by replying with exactly L2_WAKE: L2_BG_DONE and stop.\n\nThe point is that your first turn ends while the command is still running."],"model":"claude-sonnet-4-6","nativeSessionId":"ec24a006-617b-4324-b516-57a7afff15a4","queryMode":"streaming","tools":"claude_code","permissionMode":"bypassPermissions","timingCompression":"25-second background gap controlled by the replay scenario gate","generatedBy":"manual-replay-from-thread-ec24a006 (ctm-catchup-l2-20260729, captured 2026-07-30T00:35:14Z)"}}
+{"type":"expect_outbound","label":"query.open","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"sessionId":"ec24a006-617b-4324-b516-57a7afff15a4"}}}
+{"type":"expect_outbound","label":"prompt.offer:1","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Live-test post-settle background Bash wake. Do exactly this in order, with no extra steps.\n\n1) Run this exact command using the Bash tool with run_in_background set to true:\n   sleep 25 && echo L2_BG_DONE\n2) Immediately after starting it, reply with a short message containing exactly L2_STARTED and stop.\n3) Do NOT poll TaskOutput. Do NOT wait for the task. Do not spawn subagents or monitors.\n4) If its completion is reported later, acknowledge it once by replying with exactly L2_WAKE: L2_BG_DONE and stop.\n\nThe point is that your first turn ends while the command is still running."},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system:init","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.219","cwd":"/tmp/claude-replay-claude_background_task_after_root","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"fdd8c2b3-f443-405c-996d-1a5ac798e100","session_id":"ec24a006-617b-4324-b516-57a7afff15a4"}}
+{"type":"emit_inbound","label":"assistant:background-bash","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_011CdXJcN9jaK2KDf7LcqkDx","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01DAnwwvVvLM1cTfzrm6kkor","name":"Bash","input":{"command":"sleep 25 && echo L2_BG_DONE","run_in_background":true},"caller":{"type":"direct"}}],"stop_reason":"tool_use","stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"output_tokens":89,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"ec24a006-617b-4324-b516-57a7afff15a4","uuid":"6e8e602b-da0f-409d-92a4-8a912b9c7ca9"}}
+{"type":"emit_inbound","label":"task_started:local_bash","frame":{"type":"system","subtype":"task_started","task_id":"bc9gkn8ei","tool_use_id":"toolu_01DAnwwvVvLM1cTfzrm6kkor","description":"sleep 25 && echo L2_BG_DONE","task_type":"local_bash","uuid":"ed0f530b-93fe-4f94-a385-367b440a04ba","session_id":"ec24a006-617b-4324-b516-57a7afff15a4"}}
+{"type":"emit_inbound","label":"background_tasks_changed:pending","frame":{"type":"system","subtype":"background_tasks_changed","tasks":[{"task_id":"bc9gkn8ei","description":"sleep 25 && echo L2_BG_DONE","task_type":"local_bash"}],"uuid":"7d3cb8ba-6736-4b30-a748-c511cfa61803","session_id":"ec24a006-617b-4324-b516-57a7afff15a4"}}
+{"type":"emit_inbound","label":"user:background-bash-ack","frame":{"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01DAnwwvVvLM1cTfzrm6kkor","type":"tool_result","content":"Command running in background with ID: bc9gkn8ei. Output is being written to: /tmp/claude-replay-claude_background_task_after_root/tasks/bc9gkn8ei.output. You will be notified when it completes. To check interim output, use Read on that file path.","is_error":false}]},"parent_tool_use_id":null,"session_id":"ec24a006-617b-4324-b516-57a7afff15a4","uuid":"7e95842b-dec4-4be5-9b20-9738697edf62","timestamp":"2026-07-30T00:35:18.555Z","tool_use_result":{"stdout":"","stderr":"","interrupted":false,"isImage":false,"noOutputExpected":false,"backgroundTaskId":"bc9gkn8ei"}}}
+{"type":"emit_inbound","label":"assistant:root-final","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_011CdXJcdoKdTMfN4depYTKM","type":"message","role":"assistant","content":[{"type":"text","text":"L2_STARTED"}],"stop_reason":"end_turn","stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"output_tokens":9,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"ec24a006-617b-4324-b516-57a7afff15a4","uuid":"12ddebd6-6f2d-4223-be97-56ed454f7d15"}}
+{"type":"emit_inbound","label":"result:root","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":7125,"duration_api_ms":6500,"num_turns":2,"result":"L2_STARTED","stop_reason":"end_turn","session_id":"ec24a006-617b-4324-b516-57a7afff15a4","total_cost_usd":0.001,"usage":{"input_tokens":2,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"output_tokens":9,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[{"input_tokens":2,"output_tokens":9,"cache_read_input_tokens":0,"cache_creation_input_tokens":0,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":2,"outputTokens":9,"cacheReadInputTokens":0,"cacheCreationInputTokens":0,"webSearchRequests":0,"costUSD":0.001,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"633b885b-240f-4f44-bfe1-d554088b2dfd"}}
+{"type":"emit_inbound","label":"background_tasks_changed:empty","frame":{"type":"system","subtype":"background_tasks_changed","tasks":[],"uuid":"3464e6d2-1a25-4e37-82de-d305440ed44b","session_id":"ec24a006-617b-4324-b516-57a7afff15a4"}}
+{"type":"emit_inbound","label":"task_notification:local_bash","frame":{"type":"system","subtype":"task_notification","task_id":"bc9gkn8ei","tool_use_id":"toolu_01DAnwwvVvLM1cTfzrm6kkor","status":"completed","output_file":"/tmp/claude-replay-claude_background_task_after_root/tasks/bc9gkn8ei.output","summary":"Background command \"sleep 25 && echo L2_BG_DONE\" completed (exit code 0)","uuid":"0a8bc186-10a1-421c-a319-e3c7db9cb4a6","session_id":"ec24a006-617b-4324-b516-57a7afff15a4"}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/claude_background_task_after_root/input.ts b/apps/server/src/orchestration-v2/testkit/fixtures/claude_background_task_after_root/input.ts
new file mode 100644
index 000000000000..8ed37f284cce
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/claude_background_task_after_root/input.ts
@@ -0,0 +1,26 @@
+import type { OrchestratorFixtureInput } from "../shared.ts";
+
+export const CLAUDE_BACKGROUND_TASK_AFTER_ROOT_PROMPT = [
+  "Live-test post-settle background Bash wake. Do exactly this in order, with no extra steps.",
+  "",
+  "1) Run this exact command using the Bash tool with run_in_background set to true:",
+  "   sleep 25 && echo L2_BG_DONE",
+  "2) Immediately after starting it, reply with a short message containing exactly L2_STARTED and stop.",
+  "3) Do NOT poll TaskOutput. Do NOT wait for the task. Do not spawn subagents or monitors.",
+  "4) If its completion is reported later, acknowledge it once by replying with exactly L2_WAKE: L2_BG_DONE and stop.",
+  "",
+  "The point is that your first turn ends while the command is still running.",
+].join("\n");
+
+export function claudeBackgroundTaskAfterRootInput(): OrchestratorFixtureInput {
+  return {
+    steps: [
+      { type: "message", text: CLAUDE_BACKGROUND_TASK_AFTER_ROOT_PROMPT },
+      {
+        type: "release_replay_gate_after_waiting",
+        label: "background_tasks_changed:empty",
+        targetRunIndex: 1,
+      },
+    ],
+  };
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/claude_background_task_after_root/output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/claude_background_task_after_root/output.ts
new file mode 100644
index 000000000000..38cbeaf35dae
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/claude_background_task_after_root/output.ts
@@ -0,0 +1,96 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertBaseProjection,
+  assertSemanticProjectionIntegrity,
+  assertUserMessagesInclude,
+  projectionFor,
+} from "../shared.ts";
+import { CLAUDE_BACKGROUND_TASK_AFTER_ROOT_PROMPT } from "./input.ts";
+
+const BACKGROUND_TASK_ID = "bc9gkn8ei";
+
+export function assertClaudeBackgroundTaskAfterRootOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({
+    result,
+    transcript,
+    runCount: 1,
+    runStatuses: ["completed"],
+  });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertUserMessagesInclude(projection, [CLAUDE_BACKGROUND_TASK_AFTER_ROOT_PROMPT]);
+
+  const rootRun = projection.runs[0];
+  assert.isDefined(rootRun);
+  const pendingRosterIndex = result.domainEvents.findIndex(
+    (event) =>
+      event.type === "provider-thread.updated" &&
+      event.payload.pendingBackgroundTasks?.some((task) => task.taskId === BACKGROUND_TASK_ID),
+  );
+  const waitingRunIndex = result.domainEvents.findIndex(
+    (event) =>
+      event.type === "run.updated" &&
+      event.runId === rootRun.id &&
+      event.payload.status === "waiting",
+  );
+  const waitingRootNodeIndex = result.domainEvents.findIndex(
+    (event) =>
+      event.type === "node.updated" &&
+      event.payload.runId === rootRun.id &&
+      event.payload.kind === "root_turn" &&
+      event.payload.status === "waiting",
+  );
+  const idleRosterIndex = result.domainEvents.findIndex(
+    (event, index) =>
+      index > waitingRunIndex &&
+      event.type === "provider-thread.updated" &&
+      event.payload.status === "idle" &&
+      (event.payload.pendingBackgroundTasks?.length ?? 0) === 0,
+  );
+
+  assert.isAtLeast(pendingRosterIndex, 0, "replay must project the live background task roster");
+  assert.isAbove(
+    waitingRunIndex,
+    pendingRosterIndex,
+    "checkpoint-waiting root run must retain the background roster",
+  );
+  assert.isAbove(
+    waitingRootNodeIndex,
+    pendingRosterIndex,
+    "checkpoint-waiting root node must retain the background roster",
+  );
+  assert.isAbove(
+    idleRosterIndex,
+    waitingRunIndex,
+    "late background completion must clear the roster and return the provider thread to idle",
+  );
+  assert.equal(rootRun.status, "completed");
+  const rootNode = projection.nodes.find(
+    (node) => node.runId === rootRun.id && node.kind === "root_turn",
+  );
+  assert.isDefined(rootNode);
+  assert.equal(rootNode.status, "completed");
+
+  assert.lengthOf(projection.providerThreads, 1);
+  assert.equal(projection.providerThreads[0]?.status, "idle");
+  assert.deepEqual(projection.providerThreads[0]?.pendingBackgroundTasks ?? [], []);
+  assert.lengthOf(projection.subagents, 0);
+
+  const assistantTexts = projection.turnItems.flatMap((item) =>
+    item.type === "assistant_message" ? [item.text] : [],
+  );
+  assert.deepEqual(assistantTexts, ["L2_STARTED"]);
+
+  const shell = result.shellSnapshot.threads.find((thread) => thread.id === projection.thread.id);
+  assert.isDefined(shell);
+  assert.equal(shell.activeRunId, null);
+  assert.equal(shell.status, "completed");
+  assert.deepEqual(shell.pendingBackgroundTasks ?? [], []);
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/claude_idle_resume/claude_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/claude_idle_resume/claude_transcript.ndjson
new file mode 100644
index 000000000000..ba7fd8e044ac
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/claude_idle_resume/claude_transcript.ndjson
@@ -0,0 +1,19 @@
+{"type":"transcript_start","provider":"claudeAgent","protocol":"claude-agent-sdk.query","version":"0.2.111","scenario":"claude_idle_resume","metadata":{"prompts":["Respond with exactly: idle resume first turn complete","Respond with exactly: idle resume second turn complete"],"model":"claude-sonnet-4-6","nativeSessionId":"1d1e5e55-1041-4e40-8e40-000000000001","queryMode":"restart","tools":"claude_code","permissionMode":"bypassPermissions","generatedBy":"manual-replay-from-thread-d0fe9018 runs 6-8 (idle-released session must reopen with resume, 2026-07-02T20:46:05Z)"}}
+{"type":"expect_outbound","label":"query.open:1","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"sessionId":"1d1e5e55-1041-4e40-8e40-000000000001"}}}
+{"type":"expect_outbound","label":"prompt.offer:1","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Respond with exactly: idle resume first turn complete"},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"96353a54-8984-4e77-8060-b1dc6b030cf6","hook_name":"SessionStart:startup","hook_event":"SessionStart","uuid":"ffbfcc28-dd82-4c2a-a99f-58e5af6e393e","session_id":"1d1e5e55-1041-4e40-8e40-000000000001"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"96353a54-8984-4e77-8060-b1dc6b030cf6","hook_name":"SessionStart:startup","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"bbf29fb9-d4b3-4ab2-b0e3-9d2aa833099c","session_id":"1d1e5e55-1041-4e40-8e40-000000000001"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.111","cwd":"/tmp/claude-replay-claude_idle_resume","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"f468f37d-e0e6-43cf-bcd7-71e34045083e","session_id":"1d1e5e55-1041-4e40-8e40-000000000001"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01DKpWHtEMhugcX5nJwxKfeM","type":"message","role":"assistant","content":[{"type":"text","text":"idle resume first turn complete"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":11792,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"1d1e5e55-1041-4e40-8e40-000000000001","uuid":"7e96c9db-0543-4276-b97d-ced7f53b93c4"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed"},"uuid":"28620e49-aa10-42fa-a7f9-768c9c79c093","session_id":"1d1e5e55-1041-4e40-8e40-000000000001"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":2809,"duration_api_ms":2523,"num_turns":1,"result":"idle resume first turn complete","stop_reason":"end_turn","session_id":"1d1e5e55-1041-4e40-8e40-000000000001","total_cost_usd":0.0036516,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":11792,"output_tokens":7,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[{"input_tokens":3,"output_tokens":7,"cache_read_input_tokens":11792,"cache_creation_input_tokens":0,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":3,"outputTokens":7,"cacheReadInputTokens":11792,"cacheCreationInputTokens":0,"webSearchRequests":0,"costUSD":0.0036516,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"d88c31ae-a8fd-4ed4-a168-96cfd3b0edd7"}}
+{"type":"runtime_exit","status":"success"}
+{"type":"expect_outbound","label":"query.open:2","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"resume":"1d1e5e55-1041-4e40-8e40-000000000001"}}}
+{"type":"expect_outbound","label":"prompt.offer:2","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Respond with exactly: idle resume second turn complete"},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"4db1e61e-de28-49ee-b7ef-c375670d0aae","hook_name":"SessionStart:resume","hook_event":"SessionStart","uuid":"66e900fe-b02e-41a0-ac08-92260125b13d","session_id":"377e06a0-fe46-420e-bfaa-b4b9fcc8b871"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"4db1e61e-de28-49ee-b7ef-c375670d0aae","hook_name":"SessionStart:resume","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"03f2754d-daee-4128-b180-c1a39faa03f0","session_id":"377e06a0-fe46-420e-bfaa-b4b9fcc8b871"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.111","cwd":"/tmp/claude-replay-claude_idle_resume","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"5e1d64c9-a2ca-4ad1-ba2c-546ba18d1785","session_id":"1d1e5e55-1041-4e40-8e40-000000000001"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01CiTVsN2HCfqr6Ge166z8hv","type":"message","role":"assistant","content":[{"type":"text","text":"idle resume second turn complete"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":11811,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"output_tokens":7,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"1d1e5e55-1041-4e40-8e40-000000000001","uuid":"e821cdff-a217-4fb3-b1d0-f89387dbac41"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed"},"uuid":"21e2dfd3-a7f5-48d1-a343-ddb1be3198c8","session_id":"1d1e5e55-1041-4e40-8e40-000000000001"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":2103,"duration_api_ms":1644,"num_turns":1,"result":"idle resume second turn complete","stop_reason":"end_turn","session_id":"1d1e5e55-1041-4e40-8e40-000000000001","total_cost_usd":0.0036573,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":11811,"output_tokens":7,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[{"input_tokens":3,"output_tokens":7,"cache_read_input_tokens":11811,"cache_creation_input_tokens":0,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":3,"outputTokens":7,"cacheReadInputTokens":11811,"cacheCreationInputTokens":0,"webSearchRequests":0,"costUSD":0.0036573,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"a876579c-a18c-4237-ba4e-6105b2162bbb"}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/claude_idle_resume/input.ts b/apps/server/src/orchestration-v2/testkit/fixtures/claude_idle_resume/input.ts
new file mode 100644
index 000000000000..8ba8310f3e40
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/claude_idle_resume/input.ts
@@ -0,0 +1,25 @@
+import type { OrchestratorFixtureInput } from "../shared.ts";
+
+export const CLAUDE_IDLE_RESUME_PROMPT_1 = "Respond with exactly: idle resume first turn complete";
+export const CLAUDE_IDLE_RESUME_PROMPT_2 = "Respond with exactly: idle resume second turn complete";
+
+/**
+ * Regression for the stale-session first-message failure (threads 47763f5e
+ * run 10 and d0fe9018 runs 7/8, 2026-07-01/02): the provider session manager
+ * idle-releases the session runtime between turns, wiping the adapter's
+ * in-memory openedNativeThreads set. The next turn must reopen the SDK query
+ * with `resume` (the persisted provider thread proves the native session
+ * exists) — a create-style `sessionId` open fails against an existing
+ * session and burned the user's first message after every idle gap.
+ */
+export function claudeIdleResumeInput(): OrchestratorFixtureInput {
+  return {
+    steps: [
+      { type: "message", text: CLAUDE_IDLE_RESUME_PROMPT_1 },
+      // Past ProviderSessionManager's 30-minute idle timeout: the reaper
+      // releases the live session entry and closes the SDK query.
+      { type: "advance_clock", duration: "31 minutes" },
+      { type: "message", text: CLAUDE_IDLE_RESUME_PROMPT_2 },
+    ],
+  };
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/claude_idle_resume/output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/claude_idle_resume/output.ts
new file mode 100644
index 000000000000..0e65d6429843
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/claude_idle_resume/output.ts
@@ -0,0 +1,39 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertBaseProjection,
+  assertSemanticProjectionIntegrity,
+  assertUserMessagesInclude,
+  projectionFor,
+} from "../shared.ts";
+import { CLAUDE_IDLE_RESUME_PROMPT_1, CLAUDE_IDLE_RESUME_PROMPT_2 } from "./input.ts";
+
+export function assertClaudeIdleResumeOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  // The transcript itself enforces the regression: query.open:2 expects a
+  // `resume`-style open. A create-style reopen (the bug) fails the replay at
+  // the boundary before these assertions run. Both runs must complete — the
+  // pre-fix behavior burned the first post-idle message as a failed run.
+  assertBaseProjection({
+    result,
+    transcript,
+    runCount: 2,
+    runStatuses: ["completed", "completed"],
+  });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertUserMessagesInclude(projection, [CLAUDE_IDLE_RESUME_PROMPT_1, CLAUDE_IDLE_RESUME_PROMPT_2]);
+
+  const assistantTexts = projection.turnItems.flatMap((item) =>
+    item.type === "assistant_message" ? [item.text] : [],
+  );
+  assert.deepEqual(assistantTexts, [
+    "idle resume first turn complete",
+    "idle resume second turn complete",
+  ]);
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/claude_local_bash_task/claude_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/claude_local_bash_task/claude_transcript.ndjson
new file mode 100644
index 000000000000..a8c1603a95b4
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/claude_local_bash_task/claude_transcript.ndjson
@@ -0,0 +1,12 @@
+{"type":"transcript_start","provider":"claudeAgent","protocol":"claude-agent-sdk.query","version":"0.2.111","scenario":"claude_local_bash_task","metadata":{"prompts":["Run a local Bash typecheck command, then answer exactly: claude local bash task fixture complete"],"model":"claude-sonnet-4-6","nativeSessionId":"6a8f8455-10bc-4e31-8e30-b0ea9f88b911","queryMode":"streaming","tools":"claude_code","permissionMode":"bypassPermissions","generatedBy":"manual-replay-from-thread-7f1dfff1"}}
+{"type":"expect_outbound","label":"query.open","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"sessionId":"6a8f8455-10bc-4e31-8e30-b0ea9f88b911"}}}
+{"type":"expect_outbound","label":"prompt.offer:1","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Run a local Bash typecheck command, then answer exactly: claude local bash task fixture complete"},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.183","cwd":"/tmp/claude-replay-claude_local_bash_task","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"af3bf4cc-1385-4e19-a5fa-fcbe2a0ca001","session_id":"6a8f8455-10bc-4e31-8e30-b0ea9f88b911"}}
+{"type":"emit_inbound","label":"assistant:commentary","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01localbashfixture1","type":"message","role":"assistant","content":[{"type":"text","text":"I'll run the typecheck command now."}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":1,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"6a8f8455-10bc-4e31-8e30-b0ea9f88b911","uuid":"97898e28-ee4e-4fcf-80c3-5c790c502a42"}}
+{"type":"emit_inbound","label":"assistant:bash","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01localbashfixture1","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01QHaWEM6vnYqxYPvpqv6Xq4","name":"Bash","input":{"command":"vp run --filter @t3tools/web typecheck 2>&1 | tail -30"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":1,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"6a8f8455-10bc-4e31-8e30-b0ea9f88b911","uuid":"1d21fda6-13b4-4229-aa5c-c7c92bdca799"}}
+{"type":"emit_inbound","label":"task_started:local_bash","frame":{"type":"system","subtype":"task_started","task_id":"bw28jiyac","tool_use_id":"toolu_01QHaWEM6vnYqxYPvpqv6Xq4","description":"vp run --filter @t3tools/web typecheck 2>&1 | tail -30","task_type":"local_bash","uuid":"4873c95b-1aa9-44a5-9783-dc56dac734e6","session_id":"6a8f8455-10bc-4e31-8e30-b0ea9f88b911"}}
+{"type":"emit_inbound","label":"task_notification:local_bash","frame":{"type":"system","subtype":"task_notification","task_id":"bw28jiyac","tool_use_id":"toolu_01QHaWEM6vnYqxYPvpqv6Xq4","status":"completed","output_file":"","summary":"vp run --filter @t3tools/web typecheck 2>&1 | tail -30","uuid":"5af2cb9e-6c69-4b5c-a935-2dfba519a773","session_id":"6a8f8455-10bc-4e31-8e30-b0ea9f88b911"}}
+{"type":"emit_inbound","label":"user:bash_result","frame":{"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01QHaWEM6vnYqxYPvpqv6Xq4","type":"tool_result","content":"~/apps/web$ tsgo --noEmit cache disabled","is_error":false}]},"parent_tool_use_id":null,"session_id":"6a8f8455-10bc-4e31-8e30-b0ea9f88b911","uuid":"2820be54-3f9f-4f82-b677-fe11a2e44e3a","timestamp":"2026-07-01T15:51:27.047Z","tool_use_result":{"stdout":"~/apps/web$ tsgo --noEmit cache disabled","stderr":"","interrupted":false,"isImage":false,"noOutputExpected":false}}}
+{"type":"emit_inbound","label":"assistant:final","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01localbashfixture2","type":"message","role":"assistant","content":[{"type":"text","text":"claude local bash task fixture complete"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":1,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"6a8f8455-10bc-4e31-8e30-b0ea9f88b911","uuid":"89be9e65-097b-47e8-849b-be723386b72f"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":4000,"duration_api_ms":3500,"num_turns":2,"result":"claude local bash task fixture complete","stop_reason":"end_turn","session_id":"6a8f8455-10bc-4e31-8e30-b0ea9f88b911","total_cost_usd":0.001,"usage":{"input_tokens":2,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"output_tokens":2,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[{"input_tokens":1,"output_tokens":1,"cache_read_input_tokens":0,"cache_creation_input_tokens":0,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":2,"outputTokens":2,"cacheReadInputTokens":0,"cacheCreationInputTokens":0,"webSearchRequests":0,"costUSD":0.001,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"7ff94c9f-194c-4c2e-85ae-6ea81aa6ff16"}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/claude_local_bash_task/input.ts b/apps/server/src/orchestration-v2/testkit/fixtures/claude_local_bash_task/input.ts
new file mode 100644
index 000000000000..19b15de262a7
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/claude_local_bash_task/input.ts
@@ -0,0 +1,7 @@
+import { CLAUDE_LOCAL_BASH_TASK_PROMPT, type OrchestratorFixtureInput } from "../shared.ts";
+
+export function claudeLocalBashTaskInput(): OrchestratorFixtureInput {
+  return {
+    steps: [{ type: "message", text: CLAUDE_LOCAL_BASH_TASK_PROMPT }],
+  };
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/claude_local_bash_task/output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/claude_local_bash_task/output.ts
new file mode 100644
index 000000000000..b705ea36105b
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/claude_local_bash_task/output.ts
@@ -0,0 +1,58 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertBaseProjection,
+  assertSemanticProjectionIntegrity,
+  assertUserMessagesInclude,
+  assertVisibleTurnItemsMirrorLocalTurnItems,
+  CLAUDE_LOCAL_BASH_TASK_PROMPT,
+  projectionFor,
+} from "../shared.ts";
+
+export function assertClaudeLocalBashTaskOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({ result, transcript, runCount: 1, runStatuses: ["completed"] });
+
+  assert.equal(
+    result.projections.size,
+    1,
+    "Claude local_bash task lifecycle events must not create child app threads",
+  );
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertVisibleTurnItemsMirrorLocalTurnItems(projection);
+  assertUserMessagesInclude(projection, [CLAUDE_LOCAL_BASH_TASK_PROMPT]);
+  assert.deepEqual(
+    projection.turnItems.filter((item) => item.type !== "checkpoint").map((item) => item.type),
+    ["user_message", "assistant_message", "command_execution", "assistant_message"],
+  );
+
+  assert.lengthOf(
+    projection.subagents,
+    0,
+    "Claude local_bash task lifecycle events must not project subagents",
+  );
+  assert.lengthOf(
+    projection.nodes.filter((node) => node.kind === "subagent"),
+    0,
+    "Claude local_bash task lifecycle events must not project subagent nodes",
+  );
+
+  const assistantTexts = projection.turnItems.flatMap((item) =>
+    item.type === "assistant_message" ? [item.text] : [],
+  );
+  assert.deepEqual(assistantTexts, [
+    "I'll run the typecheck command now.",
+    "claude local bash task fixture complete",
+  ]);
+
+  const command = projection.turnItems.find((item) => item.type === "command_execution");
+  assert.isDefined(command);
+  assert.include(JSON.stringify(command ?? null), "vp run --filter @t3tools/web typecheck");
+  assert.include(JSON.stringify(command?.output ?? null), "tsgo --noEmit");
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/claude_result_is_error/claude_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/claude_result_is_error/claude_transcript.ndjson
new file mode 100644
index 000000000000..e5393a74466b
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/claude_result_is_error/claude_transcript.ndjson
@@ -0,0 +1,10 @@
+{"type":"transcript_start","provider":"claudeAgent","protocol":"claude-agent-sdk.query","version":"0.2.111","scenario":"claude_result_is_error","metadata":{"prompts":["Say hello before the credentials expire.","Try again now that auth is back."],"model":"claude-sonnet-4-6","nativeSessionId":"aa401aa4-e597-4e40-8e40-1e401e401e40","queryMode":"streaming","tools":"claude_code","permissionMode":"bypassPermissions","generatedBy":"manual-replay-from-thread-47763f5e run 1 (subtype success + is_error 401 result, 2026-07-01T20:56:54Z)"}}
+{"type":"expect_outbound","label":"query.open","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"sessionId":"aa401aa4-e597-4e40-8e40-1e401e401e40"}}}
+{"type":"expect_outbound","label":"prompt.offer:1","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Say hello before the credentials expire."},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system:init:1","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.183","cwd":"/tmp/claude-replay-claude_result_is_error","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"aa401aa4-0000-4000-8000-000000000001","session_id":"aa401aa4-e597-4e40-8e40-1e401e401e40"}}
+{"type":"emit_inbound","label":"assistant:synthetic_auth_error","frame":{"type":"assistant","message":{"id":"7f28a402-6d4c-491e-abbb-2b3c231a06f0","container":null,"model":"<synthetic>","role":"assistant","stop_details":null,"stop_reason":"stop_sequence","stop_sequence":"","type":"message","usage":{"input_tokens":0,"output_tokens":0,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":null,"cache_creation":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"inference_geo":null,"iterations":null,"speed":null},"content":[{"type":"text","text":"Failed to authenticate. API Error: 401 Invalid authentication credentials"}],"context_management":null},"parent_tool_use_id":null,"session_id":"aa401aa4-e597-4e40-8e40-1e401e401e40","uuid":"aa401aa4-0000-4000-8000-000000000002","error":"authentication_failed"}}
+{"type":"emit_inbound","label":"result:1_is_error","frame":{"type":"result","subtype":"success","is_error":true,"api_error_status":401,"duration_ms":2116,"duration_api_ms":0,"num_turns":1,"result":"Failed to authenticate. API Error: 401 Invalid authentication credentials","stop_reason":"stop_sequence","session_id":"aa401aa4-e597-4e40-8e40-1e401e401e40","total_cost_usd":0,"usage":{"input_tokens":0,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"output_tokens":0,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[],"speed":"standard"},"modelUsage":{},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"aa401aa4-0000-4000-8000-000000000003"}}
+{"type":"expect_outbound","label":"prompt.offer:2","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Try again now that auth is back."},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"assistant:recovered","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01iserrorfixture1","type":"message","role":"assistant","content":[{"type":"text","text":"claude result is_error fixture recovered"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":1,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"aa401aa4-e597-4e40-8e40-1e401e401e40","uuid":"aa401aa4-0000-4000-8000-000000000004"}}
+{"type":"emit_inbound","label":"result:2_success","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":4000,"duration_api_ms":3500,"num_turns":1,"result":"claude result is_error fixture recovered","stop_reason":"end_turn","session_id":"aa401aa4-e597-4e40-8e40-1e401e401e40","total_cost_usd":0.001,"usage":{"input_tokens":2,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"output_tokens":2,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[{"input_tokens":1,"output_tokens":1,"cache_read_input_tokens":0,"cache_creation_input_tokens":0,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":2,"outputTokens":2,"cacheReadInputTokens":0,"cacheCreationInputTokens":0,"webSearchRequests":0,"costUSD":0.001,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"aa401aa4-0000-4000-8000-000000000005"}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/claude_result_is_error/input.ts b/apps/server/src/orchestration-v2/testkit/fixtures/claude_result_is_error/input.ts
new file mode 100644
index 000000000000..0f7af1a6757d
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/claude_result_is_error/input.ts
@@ -0,0 +1,22 @@
+import {
+  CLAUDE_RESULT_IS_ERROR_FOLLOW_UP,
+  CLAUDE_RESULT_IS_ERROR_PROMPT,
+  type OrchestratorFixtureInput,
+} from "../shared.ts";
+
+/**
+ * Recorded from thread 47763f5e run 1 (2026-07-01): the SDK reports API-level
+ * failures (401 auth, 529 overloaded, …) as a result with subtype "success"
+ * but is_error: true, alongside a synthetic-model assistant message carrying
+ * the error text. The run must finalize as failed with the API error on the
+ * failure item — not as a completed run — and the session must stay usable
+ * for the next turn.
+ */
+export function claudeResultIsErrorInput(): OrchestratorFixtureInput {
+  return {
+    steps: [
+      { type: "message", text: CLAUDE_RESULT_IS_ERROR_PROMPT },
+      { type: "message", text: CLAUDE_RESULT_IS_ERROR_FOLLOW_UP },
+    ],
+  };
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/claude_result_is_error/output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/claude_result_is_error/output.ts
new file mode 100644
index 000000000000..8d676460112c
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/claude_result_is_error/output.ts
@@ -0,0 +1,71 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertBaseProjection,
+  assertSemanticProjectionIntegrity,
+  assertUserMessagesInclude,
+  CLAUDE_RESULT_IS_ERROR_FOLLOW_UP,
+  CLAUDE_RESULT_IS_ERROR_PROMPT,
+  projectionFor,
+} from "../shared.ts";
+
+const AUTH_ERROR_TEXT = "Failed to authenticate. API Error: 401 Invalid authentication credentials";
+
+export function assertClaudeResultIsErrorOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({
+    result,
+    transcript,
+    runCount: 2,
+    runStatuses: ["failed", "completed"],
+  });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertUserMessagesInclude(projection, [
+    CLAUDE_RESULT_IS_ERROR_PROMPT,
+    CLAUDE_RESULT_IS_ERROR_FOLLOW_UP,
+  ]);
+
+  // Run 1 ended with subtype "success" + is_error: the run and its provider
+  // turn must be failed, and the failure must preserve the API error verbatim
+  // (message + status code), not a generic wrapper string.
+  const failedRun = projection.runs.find((run) => run.ordinal === 1);
+  assert.isDefined(failedRun);
+  assert.equal(failedRun?.status, "failed");
+  const failedTurn = projection.providerTurns.find(
+    (turn) => turn.status !== "completed" && turn.status !== "running",
+  );
+  assert.equal(failedTurn?.status, "failed");
+
+  const errorItem = projection.turnItems.find(
+    (item) => item.runId === failedRun?.id && item.type === "error",
+  );
+  assert.isDefined(errorItem);
+  if (errorItem?.type !== "error") throw new Error("expected error item");
+  assert.equal(errorItem.failure.message, AUTH_ERROR_TEXT);
+  assert.equal(errorItem.failure.code, "api_error_401");
+  assert.equal(errorItem.failure.class, "provider_error");
+
+  // The SDK's synthetic assistant message still surfaces as ordinary
+  // assistant text (that is what the stream contained), but the error text
+  // must not be duplicated a second time via the result-text fallback.
+  const run1AssistantTexts = projection.turnItems.flatMap((item) =>
+    item.runId === failedRun?.id && item.type === "assistant_message" ? [item.text] : [],
+  );
+  assert.deepEqual(run1AssistantTexts, [AUTH_ERROR_TEXT]);
+
+  // The failed turn must not poison the thread: the follow-up run reuses the
+  // same open query and completes.
+  const recoveredRun = projection.runs.find((run) => run.ordinal === 2);
+  assert.isDefined(recoveredRun);
+  assert.equal(recoveredRun?.status, "completed");
+  const recoveredTexts = projection.turnItems.flatMap((item) =>
+    item.runId === recoveredRun?.id && item.type === "assistant_message" ? [item.text] : [],
+  );
+  assert.deepEqual(recoveredTexts, ["claude result is_error fixture recovered"]);
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/grok_subagent_lineage/grok_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/grok_subagent_lineage/grok_transcript.ndjson
new file mode 100644
index 000000000000..450abab6f17e
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/grok_subagent_lineage/grok_transcript.ndjson
@@ -0,0 +1,17 @@
+{"type":"transcript_start","provider":"grok","protocol":"acp.ndjson-jsonrpc","version":"1","scenario":"grok_subagent_lineage","metadata":{"generatedBy":"compiled-provider-log","sourceThreadId":"571b464b-0b43-47f4-a710-23d915aa6a5b","sourceTurnId":"3a20e836-9e7a-4858-9cdb-2e1e7d3e35c6","sourceNativeSessionId":"019f0220-b386-78b3-bc57-dc127c023559","normalization":"Large audit result chunks were truncated while preserving source session IDs, task IDs, ordering, and text boundaries."}}
+{"type":"expect_outbound","label":"initialize","frame":{"kind":"request","method":"initialize","params":{"protocolVersion":1,"clientCapabilities":{"fs":{"readTextFile":false,"writeTextFile":false},"terminal":false,"elicitation":{"form":{}}},"clientInfo":{"name":"t3-code","version":"0.0.0"}}}}
+{"type":"emit_inbound","label":"initialized","frame":{"kind":"response","method":"initialize","result":{"protocolVersion":1,"agentCapabilities":{"loadSession":true,"mcpCapabilities":{"http":true,"sse":true},"promptCapabilities":{"audio":false,"embeddedContext":true,"image":false}},"authMethods":[{"id":"replay","name":"Replay"}],"agentInfo":{"name":"grok-replay","version":"1"}}}}
+{"type":"expect_outbound","label":"session.new","frame":{"kind":"request","method":"session/new","params":{"cwd":"<workspace>","mcpServers":"<any>"}}}
+{"type":"emit_inbound","label":"session.created","frame":{"kind":"response","method":"session/new","result":{"sessionId":"019f0220-b386-78b3-bc57-dc127c023559","models":{"currentModelId":"grok-composer-2.5-fast","availableModels":[{"modelId":"grok-composer-2.5-fast","name":"Grok Composer 2.5 Fast"}]}}}}
+{"type":"expect_outbound","label":"session.prompt","frame":{"kind":"request","method":"session/prompt","params":{"sessionId":"019f0220-b386-78b3-bc57-dc127c023559","prompt":[{"type":"text","text":"audit this codebase"}]}}}
+{"type":"emit_inbound","label":"task.server.started","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"019f0220-b386-78b3-bc57-dc127c023559","update":{"sessionUpdate":"tool_call","toolCallId":"call-28397a12-0446-478e-a180-b06aefb56734-composer_call_kFjs8","title":"Task","rawInput":{"description":"Explore server architecture","prompt":"Audit the apps/server package and return a structured summary.","subagent_type":"generalPurpose","model":"composer-2.5-fast"}}}}}
+{"type":"emit_inbound","label":"task.web.started","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"019f0220-b386-78b3-bc57-dc127c023559","update":{"sessionUpdate":"tool_call","toolCallId":"call-28397a12-0446-478e-a180-b06aefb56734-composer_call_Olv1X","title":"Task","rawInput":{"description":"Explore web client architecture","prompt":"Audit the apps/web package and return a structured summary.","subagent_type":"generalPurpose","model":"composer-2.5-fast"}}}}}
+{"type":"emit_inbound","label":"child.server.progress","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"019f0220-e192-7c41-9e9d-b406bc3459c8","update":{"sessionUpdate":"agent_message_chunk","content":{"type":"text","text":"I'll audit `apps/server` by mapping its layout first, then reading entry points, WebSocket/auth/session code, and tests.\n"}}}}}
+{"type":"emit_inbound","label":"child.web.progress","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"019f0220-e197-7833-a8e4-ad38f2bd5b4c","update":{"sessionUpdate":"agent_message_chunk","content":{"type":"text","text":"Auditing `apps/web`: mapping package structure and searching source for state, WebSocket, components, performance, and tests.\n"}}}}}
+{"type":"emit_inbound","label":"child.server.result","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"019f0220-e192-7c41-9e9d-b406bc3459c8","update":{"sessionUpdate":"agent_message_chunk","content":{"type":"text","text":"# `apps/server` Audit Summary\n\nLayered Effect architecture with WebSocket RPC and durable provider sessions."}}}}}
+{"type":"emit_inbound","label":"child.web.result","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"019f0220-e197-7833-a8e4-ad38f2bd5b4c","update":{"sessionUpdate":"agent_message_chunk","content":{"type":"text","text":"# `apps/web` Audit Summary\n\nHybrid Effect Atom and Zustand state with centralized reconnect handling."}}}}}
+{"type":"emit_inbound","label":"task.server.completed","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"019f0220-b386-78b3-bc57-dc127c023559","update":{"sessionUpdate":"tool_call_update","toolCallId":"call-28397a12-0446-478e-a180-b06aefb56734-composer_call_kFjs8","status":"completed","rawOutput":{"type":"Text","text":"Server audit complete.\n\nAgent ID: 019f0220-e192-7c41-9e9d-b406bc3459c8 (can be used with the `resume` parameter to send a follow-up after it completes)"}}}}}
+{"type":"emit_inbound","label":"task.web.completed","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"019f0220-b386-78b3-bc57-dc127c023559","update":{"sessionUpdate":"tool_call_update","toolCallId":"call-28397a12-0446-478e-a180-b06aefb56734-composer_call_Olv1X","status":"completed","rawOutput":{"type":"Text","text":"Web audit complete.\n\nAgent ID: 019f0220-e197-7833-a8e4-ad38f2bd5b4c (can be used with the `resume` parameter to send a follow-up after it completes)"}}}}}
+{"type":"emit_inbound","label":"parent.final","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"019f0220-b386-78b3-bc57-dc127c023559","update":{"sessionUpdate":"agent_message_chunk","content":{"type":"text","text":"Audit complete."}}}}}
+{"type":"emit_inbound","label":"prompt.completed","frame":{"kind":"response","method":"session/prompt","result":{"stopReason":"end_turn"}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/grok_subagent_lineage/input.ts b/apps/server/src/orchestration-v2/testkit/fixtures/grok_subagent_lineage/input.ts
new file mode 100644
index 000000000000..1013fc97d4a2
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/grok_subagent_lineage/input.ts
@@ -0,0 +1,9 @@
+import type { OrchestratorFixtureInput } from "../shared.ts";
+
+export const GROK_SUBAGENT_LINEAGE_PROMPT = "audit this codebase";
+
+export function grokSubagentLineageInput(): OrchestratorFixtureInput {
+  return {
+    steps: [{ type: "message", text: GROK_SUBAGENT_LINEAGE_PROMPT }],
+  };
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/grok_subagent_lineage/output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/grok_subagent_lineage/output.ts
new file mode 100644
index 000000000000..5b290cb201b1
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/grok_subagent_lineage/output.ts
@@ -0,0 +1,95 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertBaseProjection,
+  assertExecutionNodeKinds,
+  assertNoExtraAppRunsForProviderChildren,
+  assertTurnItemTypes,
+  projectionFor,
+} from "../shared.ts";
+
+const EXPECTED_CHILDREN = [
+  {
+    title: "Explore server architecture",
+    sessionId: "019f0220-e192-7c41-9e9d-b406bc3459c8",
+    first: "I'll audit `apps/server` by mapping its layout first",
+    second: "# `apps/server` Audit Summary",
+  },
+  {
+    title: "Explore web client architecture",
+    sessionId: "019f0220-e197-7833-a8e4-ad38f2bd5b4c",
+    first: "Auditing `apps/web`: mapping package structure",
+    second: "# `apps/web` Audit Summary",
+  },
+] as const;
+
+export function assertGrokSubagentLineageOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({ result, transcript, runCount: 1, runStatuses: ["completed"] });
+  const parent = projectionFor(result, transcript.scenario);
+  assertTurnItemTypes(parent, ["user_message", "subagent", "subagent", "assistant_message"]);
+  assertExecutionNodeKinds(parent, ["root_turn", "subagent", "subagent", "assistant_message"]);
+  assertNoExtraAppRunsForProviderChildren({ projection: parent, expectedAppRuns: 1 });
+  assert.lengthOf(parent.subagents, 2);
+  assert.lengthOf(result.shellSnapshot.threads, 3);
+  assert.notInclude(
+    parent.messages.map((message) => message.text).join("\n"),
+    "Audit Summary",
+    "interleaved child output must not leak into the parent timeline",
+  );
+
+  for (const expected of EXPECTED_CHILDREN) {
+    const subagent = parent.subagents.find((candidate) => candidate.title === expected.title);
+    assert.isDefined(subagent);
+    assert.equal(subagent.status, "completed");
+    assert.equal(subagent.origin, "provider_native");
+    assert.equal(subagent.driver, "grok");
+    assert.isNotNull(subagent.childThreadId);
+    assert.isNotNull(subagent.providerThreadId);
+    assert.include(subagent.result ?? "", expected.first);
+    assert.include(subagent.result ?? "", expected.second);
+    if (subagent.childThreadId === null || subagent.providerThreadId === null) {
+      throw new Error(`Grok subagent ${expected.title} is missing lineage`);
+    }
+
+    const child = result.projections.get(subagent.childThreadId);
+    assert.isDefined(child);
+    assert.equal(child.thread.lineage.parentThreadId, parent.thread.id);
+    assert.equal(child.thread.lineage.relationshipToParent, "subagent");
+    assert.equal(child.thread.lineage.rootThreadId, parent.thread.lineage.rootThreadId);
+    assert.equal(child.thread.activeProviderThreadId, subagent.providerThreadId);
+    assert.lengthOf(child.runs, 0);
+    assert.lengthOf(child.providerThreads, 1);
+    assert.equal(child.providerThreads[0]?.nativeThreadRef?.nativeId, expected.sessionId);
+    const forkedFrom = child.providerThreads[0]?.forkedFrom;
+    if (forkedFrom == null) {
+      throw new Error(`Grok subagent ${expected.title} is missing provider lineage`);
+    }
+    assert.notEqual(forkedFrom.providerThreadId, subagent.providerThreadId);
+    assert.isTrue(
+      parent.providerTurns.some(
+        (turn) =>
+          turn.id === forkedFrom.providerTurnId &&
+          turn.providerThreadId === forkedFrom.providerThreadId,
+      ),
+      "the native child session must fork from the parent provider turn",
+    );
+    assertTurnItemTypes(child, ["user_message", "assistant_message"]);
+    const assistant = child.messages.find((message) => message.role === "assistant");
+    assert.isDefined(assistant);
+    assert.isBelow(assistant.text.indexOf(expected.first), assistant.text.indexOf(expected.second));
+    for (const other of EXPECTED_CHILDREN) {
+      if (other.sessionId !== expected.sessionId) {
+        assert.notInclude(
+          assistant.text,
+          other.second,
+          "interleaved chunks must remain isolated to their native child session",
+        );
+      }
+    }
+  }
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/index.ts b/apps/server/src/orchestration-v2/testkit/fixtures/index.ts
new file mode 100644
index 000000000000..f83f42cc3d77
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/index.ts
@@ -0,0 +1,807 @@
+import { ProviderDriverKind } from "@t3tools/contracts";
+
+import { claudeBackgroundTaskAfterRootInput } from "./claude_background_task_after_root/input.ts";
+import { assertClaudeBackgroundTaskAfterRootOutput } from "./claude_background_task_after_root/output.ts";
+import { claudeIdleResumeInput } from "./claude_idle_resume/input.ts";
+import { assertClaudeIdleResumeOutput } from "./claude_idle_resume/output.ts";
+import { claudeLocalBashTaskInput } from "./claude_local_bash_task/input.ts";
+import { assertClaudeLocalBashTaskOutput } from "./claude_local_bash_task/output.ts";
+import { claudeResultIsErrorInput } from "./claude_result_is_error/input.ts";
+import { assertClaudeResultIsErrorOutput } from "./claude_result_is_error/output.ts";
+import { grokSubagentLineageInput } from "./grok_subagent_lineage/input.ts";
+import { assertGrokSubagentLineageOutput } from "./grok_subagent_lineage/output.ts";
+import { assertClaudeMessageSteeringOutput } from "./message_steering/claude_output.ts";
+import { assertMessageSteeringOutput } from "./message_steering/codex_output.ts";
+import { assertCursorMessageSteeringOutput } from "./message_steering/cursor_output.ts";
+import { assertGrokMessageSteeringOutput } from "./message_steering/grok_output.ts";
+import { messageSteeringInput } from "./message_steering/input.ts";
+import { assertMultiTurnClaudeOutput } from "./multi_turn/claude_output.ts";
+import { assertMultiTurnOutput } from "./multi_turn/codex_output.ts";
+import { multiTurnInput } from "./multi_turn/input.ts";
+import { openCodeChildApprovalInput } from "./opencode_child_approval/input.ts";
+import { assertOpenCodeChildApprovalOutput } from "./opencode_child_approval/output.ts";
+import { openCodeSubagentInput } from "./opencode_subagent/input.ts";
+import { assertOpenCodeSubagentOutput } from "./opencode_subagent/output.ts";
+import { assertPlanQuestionsOutput } from "./plan_questions/codex_output.ts";
+import { assertOpenCodePlanQuestionsOutput } from "./plan_questions/opencode_output.ts";
+import { planQuestionsInput } from "./plan_questions/input.ts";
+import { assertProposedPlanOutput } from "./proposed_plan/codex_output.ts";
+import { assertProposedPlanCursorOutput } from "./proposed_plan/cursor_output.ts";
+import { proposedPlanInput } from "./proposed_plan/input.ts";
+import { assertQueuedCancelledWhileActiveOutput } from "./queued_cancelled_while_active/codex_output.ts";
+import { queuedCancelledWhileActiveInput } from "./queued_cancelled_while_active/input.ts";
+import { assertQueuedTurnOutput } from "./queued_turn/codex_output.ts";
+import { queuedTurnInput } from "./queued_turn/input.ts";
+import { assertSimpleClaudeOutput } from "./simple/claude_output.ts";
+import { assertSimpleOutput } from "./simple/codex_output.ts";
+import { simpleInput } from "./simple/input.ts";
+import { assertSubagentOutput } from "./subagent/codex_output.ts";
+import { assertClaudeSubagentOutput } from "./subagent/claude_output.ts";
+import { subagentInput } from "./subagent/input.ts";
+import { assertCursorSubagentOutput } from "./subagent/cursor_output.ts";
+import { assertSubagentContinueOutput } from "./subagent_continue/codex_output.ts";
+import { subagentContinueInput } from "./subagent_continue/input.ts";
+import { assertSubagentV2Output } from "./subagent_v2/codex_output.ts";
+import { subagentV2Input } from "./subagent_v2/input.ts";
+import { assertSubagentV2NestedOutput } from "./subagent_v2_nested/codex_output.ts";
+import { assertClaudeThreadRollbackOutput } from "./thread_rollback/claude_output.ts";
+import { assertThreadRollbackOutput } from "./thread_rollback/codex_output.ts";
+import { threadRollbackInput } from "./thread_rollback/input.ts";
+import { assertTodoListOutput } from "./todo_list/codex_output.ts";
+import { assertTodoListCursorOutput } from "./todo_list/cursor_output.ts";
+import { assertTodoListGrokOutput } from "./todo_list/grok_output.ts";
+import { todoListInput } from "./todo_list/input.ts";
+import { assertToolCallReadOnlyClaudeOutput } from "./tool_call_read_only/claude_output.ts";
+import { assertToolCallReadOnlyCursorOutput } from "./tool_call_read_only/cursor_output.ts";
+import { toolCallReadOnlyInput } from "./tool_call_read_only/input.ts";
+import { assertToolCallReadOnlyOnRequestClaudeOutput } from "./tool_call_read_only_on_request/claude_output.ts";
+import { assertToolCallReadOnlyOnRequestOutput } from "./tool_call_read_only_on_request/codex_output.ts";
+import { toolCallReadOnlyOnRequestInput } from "./tool_call_read_only_on_request/input.ts";
+import { assertToolCallRestrictedGranularClaudeOutput } from "./tool_call_restricted_granular/claude_output.ts";
+import { assertToolCallRestrictedGranularOutput } from "./tool_call_restricted_granular/codex_output.ts";
+import { toolCallRestrictedGranularInput } from "./tool_call_restricted_granular/input.ts";
+import { assertToolCallWorkspaceNeverClaudeOutput } from "./tool_call_workspace_never/claude_output.ts";
+import { assertToolCallWorkspaceNeverOutput } from "./tool_call_workspace_never/codex_output.ts";
+import { toolCallWorkspaceNeverInput } from "./tool_call_workspace_never/input.ts";
+import { assertTurnInterruptClaudeOutput } from "./turn_interrupt/claude_output.ts";
+import { assertTurnInterruptOutput } from "./turn_interrupt/codex_output.ts";
+import { turnInterruptInput } from "./turn_interrupt/input.ts";
+import { assertTurnInterruptMidToolClaudeOutput } from "./turn_interrupt_mid_tool/claude_output.ts";
+import { assertTurnInterruptMidToolCodexOutput } from "./turn_interrupt_mid_tool/codex_output.ts";
+import { assertTurnInterruptMidToolCursorOutput } from "./turn_interrupt_mid_tool/cursor_output.ts";
+import { turnInterruptMidToolInput } from "./turn_interrupt_mid_tool/input.ts";
+import { assertTurnInterruptRestartClaudeOutput } from "./turn_interrupt_restart/claude_output.ts";
+import { turnInterruptRestartInput } from "./turn_interrupt_restart/input.ts";
+import { assertClaudeWebSearchOutput } from "./web_search/claude_output.ts";
+import { assertWebSearchOutput } from "./web_search/codex_output.ts";
+import { webSearchInput } from "./web_search/input.ts";
+import {
+  ACP_REGISTRY_MODEL_SELECTION,
+  CLAUDE_MODEL_SELECTION,
+  CODEX_MODEL_SELECTION,
+  CURSOR_MODEL_SELECTION,
+  GROK_MODEL_SELECTION,
+  OPENCODE_MODEL_SELECTION,
+  READ_ONLY_NEVER_POLICY,
+  READ_ONLY_ON_REQUEST_POLICY,
+  RESTRICTED_GRANULAR_POLICY,
+  type OrchestratorReplayFixture,
+  WORKSPACE_NEVER_POLICY,
+} from "./shared.ts";
+
+export const ORCHESTRATOR_REPLAY_FIXTURES: ReadonlyArray<OrchestratorReplayFixture> = [
+  {
+    name: "claude_background_task_after_root",
+    buildInput: claudeBackgroundTaskAfterRootInput,
+    providers: [
+      {
+        driver: ProviderDriverKind.make("claudeAgent"),
+        transcriptFile: new URL(
+          "./claude_background_task_after_root/claude_transcript.ndjson",
+          import.meta.url,
+        ),
+        modelSelection: CLAUDE_MODEL_SELECTION,
+        assertOutput: assertClaudeBackgroundTaskAfterRootOutput,
+      },
+    ],
+  },
+  {
+    name: "claude_local_bash_task",
+    buildInput: claudeLocalBashTaskInput,
+    providers: [
+      {
+        driver: ProviderDriverKind.make("claudeAgent"),
+        transcriptFile: new URL(
+          "./claude_local_bash_task/claude_transcript.ndjson",
+          import.meta.url,
+        ),
+        modelSelection: CLAUDE_MODEL_SELECTION,
+        assertOutput: assertClaudeLocalBashTaskOutput,
+      },
+    ],
+  },
+  {
+    name: "claude_idle_resume",
+    buildInput: claudeIdleResumeInput,
+    providers: [
+      {
+        driver: ProviderDriverKind.make("claudeAgent"),
+        transcriptFile: new URL("./claude_idle_resume/claude_transcript.ndjson", import.meta.url),
+        modelSelection: CLAUDE_MODEL_SELECTION,
+        assertOutput: assertClaudeIdleResumeOutput,
+      },
+    ],
+  },
+  {
+    name: "claude_result_is_error",
+    buildInput: claudeResultIsErrorInput,
+    providers: [
+      {
+        driver: ProviderDriverKind.make("claudeAgent"),
+        transcriptFile: new URL(
+          "./claude_result_is_error/claude_transcript.ndjson",
+          import.meta.url,
+        ),
+        modelSelection: CLAUDE_MODEL_SELECTION,
+        assertOutput: assertClaudeResultIsErrorOutput,
+      },
+    ],
+  },
+  {
+    name: "grok_subagent_lineage",
+    buildInput: grokSubagentLineageInput,
+    providers: [
+      {
+        driver: ProviderDriverKind.make("grok"),
+        transcriptFile: new URL("./grok_subagent_lineage/grok_transcript.ndjson", import.meta.url),
+        modelSelection: {
+          ...GROK_MODEL_SELECTION,
+          model: "grok-composer-2.5-fast",
+        },
+        assertOutput: assertGrokSubagentLineageOutput,
+      },
+    ],
+  },
+  {
+    name: "acp_elicitation",
+    buildInput: planQuestionsInput,
+    providers: [
+      {
+        driver: ProviderDriverKind.make("grok"),
+        transcriptFile: new URL("./acp_elicitation/grok_transcript.ndjson", import.meta.url),
+        modelSelection: GROK_MODEL_SELECTION,
+        runtimePolicyOverride: READ_ONLY_NEVER_POLICY,
+        assertOutput: assertPlanQuestionsOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("acpRegistry"),
+        transcriptFile: new URL("./acp_elicitation/grok_transcript.ndjson", import.meta.url),
+        modelSelection: ACP_REGISTRY_MODEL_SELECTION,
+        runtimePolicyOverride: READ_ONLY_NEVER_POLICY,
+        assertOutput: assertPlanQuestionsOutput,
+      },
+    ],
+  },
+  {
+    name: "simple",
+    buildInput: simpleInput,
+    providers: [
+      {
+        driver: ProviderDriverKind.make("codex"),
+        transcriptFile: new URL("./simple/codex_transcript.ndjson", import.meta.url),
+        modelSelection: CODEX_MODEL_SELECTION,
+        assertOutput: assertSimpleOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("claudeAgent"),
+        transcriptFile: new URL("./simple/claude_transcript.ndjson", import.meta.url),
+        modelSelection: CLAUDE_MODEL_SELECTION,
+        assertOutput: assertSimpleClaudeOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("cursor"),
+        transcriptFile: new URL("./simple/cursor_transcript.ndjson", import.meta.url),
+        modelSelection: CURSOR_MODEL_SELECTION,
+        assertOutput: assertSimpleOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("grok"),
+        transcriptFile: new URL("./simple/grok_transcript.ndjson", import.meta.url),
+        modelSelection: GROK_MODEL_SELECTION,
+        assertOutput: assertSimpleOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("acpRegistry"),
+        transcriptFile: new URL("./simple/grok_transcript.ndjson", import.meta.url),
+        modelSelection: ACP_REGISTRY_MODEL_SELECTION,
+        assertOutput: assertSimpleOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("opencode"),
+        transcriptFile: new URL("./simple/opencode_transcript.ndjson", import.meta.url),
+        modelSelection: OPENCODE_MODEL_SELECTION,
+        assertOutput: assertSimpleOutput,
+      },
+    ],
+  },
+  {
+    name: "tool_call_read_only",
+    buildInput: toolCallReadOnlyInput,
+    providers: [
+      {
+        driver: ProviderDriverKind.make("claudeAgent"),
+        transcriptFile: new URL("./tool_call_read_only/claude_transcript.ndjson", import.meta.url),
+        modelSelection: CLAUDE_MODEL_SELECTION,
+        runtimePolicyOverride: READ_ONLY_NEVER_POLICY,
+        assertOutput: assertToolCallReadOnlyClaudeOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("cursor"),
+        transcriptFile: new URL("./tool_call_read_only/cursor_transcript.ndjson", import.meta.url),
+        modelSelection: CURSOR_MODEL_SELECTION,
+        runtimePolicyOverride: READ_ONLY_NEVER_POLICY,
+        assertOutput: assertToolCallReadOnlyCursorOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("grok"),
+        transcriptFile: new URL("./tool_call_read_only/grok_transcript.ndjson", import.meta.url),
+        modelSelection: GROK_MODEL_SELECTION,
+        runtimePolicyOverride: READ_ONLY_NEVER_POLICY,
+        assertOutput: assertToolCallReadOnlyCursorOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("acpRegistry"),
+        transcriptFile: new URL("./tool_call_read_only/grok_transcript.ndjson", import.meta.url),
+        modelSelection: ACP_REGISTRY_MODEL_SELECTION,
+        runtimePolicyOverride: READ_ONLY_NEVER_POLICY,
+        assertOutput: assertToolCallReadOnlyCursorOutput,
+      },
+    ],
+  },
+  {
+    name: "tool_call_read_only_on_request",
+    buildInput: toolCallReadOnlyOnRequestInput,
+    providers: [
+      {
+        driver: ProviderDriverKind.make("codex"),
+        transcriptFile: new URL(
+          "./tool_call_read_only_on_request/codex_transcript.ndjson",
+          import.meta.url,
+        ),
+        modelSelection: CODEX_MODEL_SELECTION,
+        runtimePolicyOverride: READ_ONLY_ON_REQUEST_POLICY,
+        assertOutput: assertToolCallReadOnlyOnRequestOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("claudeAgent"),
+        transcriptFile: new URL(
+          "./tool_call_read_only_on_request/claude_transcript.ndjson",
+          import.meta.url,
+        ),
+        modelSelection: CLAUDE_MODEL_SELECTION,
+        runtimePolicyOverride: READ_ONLY_ON_REQUEST_POLICY,
+        assertOutput: assertToolCallReadOnlyOnRequestClaudeOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("grok"),
+        transcriptFile: new URL(
+          "./tool_call_read_only_on_request/grok_transcript.ndjson",
+          import.meta.url,
+        ),
+        modelSelection: GROK_MODEL_SELECTION,
+        runtimePolicyOverride: READ_ONLY_ON_REQUEST_POLICY,
+        assertOutput: assertToolCallReadOnlyOnRequestOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("acpRegistry"),
+        transcriptFile: new URL(
+          "./tool_call_read_only_on_request/grok_transcript.ndjson",
+          import.meta.url,
+        ),
+        modelSelection: ACP_REGISTRY_MODEL_SELECTION,
+        runtimePolicyOverride: READ_ONLY_ON_REQUEST_POLICY,
+        assertOutput: assertToolCallReadOnlyOnRequestOutput,
+      },
+    ],
+  },
+  {
+    name: "tool_call_workspace_never",
+    buildInput: toolCallWorkspaceNeverInput,
+    providers: [
+      {
+        driver: ProviderDriverKind.make("codex"),
+        transcriptFile: new URL(
+          "./tool_call_workspace_never/codex_transcript.ndjson",
+          import.meta.url,
+        ),
+        modelSelection: CODEX_MODEL_SELECTION,
+        runtimePolicyOverride: WORKSPACE_NEVER_POLICY,
+        assertOutput: assertToolCallWorkspaceNeverOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("claudeAgent"),
+        transcriptFile: new URL(
+          "./tool_call_workspace_never/claude_transcript.ndjson",
+          import.meta.url,
+        ),
+        modelSelection: CLAUDE_MODEL_SELECTION,
+        runtimePolicyOverride: WORKSPACE_NEVER_POLICY,
+        assertOutput: assertToolCallWorkspaceNeverClaudeOutput,
+      },
+    ],
+  },
+  {
+    name: "tool_call_restricted_granular",
+    buildInput: toolCallRestrictedGranularInput,
+    providers: [
+      {
+        driver: ProviderDriverKind.make("codex"),
+        transcriptFile: new URL(
+          "./tool_call_restricted_granular/codex_transcript.ndjson",
+          import.meta.url,
+        ),
+        modelSelection: CODEX_MODEL_SELECTION,
+        runtimePolicyOverride: RESTRICTED_GRANULAR_POLICY,
+        assertOutput: assertToolCallRestrictedGranularOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("claudeAgent"),
+        transcriptFile: new URL(
+          "./tool_call_restricted_granular/claude_transcript.ndjson",
+          import.meta.url,
+        ),
+        modelSelection: CLAUDE_MODEL_SELECTION,
+        runtimePolicyOverride: RESTRICTED_GRANULAR_POLICY,
+        assertOutput: assertToolCallRestrictedGranularClaudeOutput,
+      },
+    ],
+  },
+  {
+    name: "subagent",
+    buildInput: subagentInput,
+    providers: [
+      {
+        driver: ProviderDriverKind.make("codex"),
+        transcriptFile: new URL("./subagent/codex_transcript.ndjson", import.meta.url),
+        modelSelection: CODEX_MODEL_SELECTION,
+        runtimePolicyOverride: READ_ONLY_ON_REQUEST_POLICY,
+        assertOutput: assertSubagentOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("claudeAgent"),
+        transcriptFile: new URL("./subagent/claude_transcript.ndjson", import.meta.url),
+        modelSelection: CLAUDE_MODEL_SELECTION,
+        assertOutput: assertClaudeSubagentOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("cursor"),
+        transcriptFile: new URL("./subagent/cursor_transcript.ndjson", import.meta.url),
+        modelSelection: CURSOR_MODEL_SELECTION,
+        runtimePolicyOverride: READ_ONLY_NEVER_POLICY,
+        assertOutput: assertCursorSubagentOutput,
+      },
+    ],
+  },
+  {
+    name: "subagent_continue",
+    buildInput: subagentContinueInput,
+    providers: [
+      {
+        driver: ProviderDriverKind.make("codex"),
+        transcriptFile: new URL("./subagent_continue/codex_transcript.ndjson", import.meta.url),
+        modelSelection: CODEX_MODEL_SELECTION,
+        assertOutput: assertSubagentContinueOutput,
+      },
+    ],
+  },
+  {
+    name: "subagent_v2",
+    buildInput: subagentV2Input,
+    providers: [
+      {
+        driver: ProviderDriverKind.make("codex"),
+        transcriptFile: new URL("./subagent_v2/codex_transcript.ndjson", import.meta.url),
+        modelSelection: CODEX_MODEL_SELECTION,
+        assertOutput: assertSubagentV2Output,
+      },
+    ],
+  },
+  {
+    name: "subagent_v2_nested",
+    buildInput: subagentV2Input,
+    providers: [
+      {
+        driver: ProviderDriverKind.make("codex"),
+        transcriptFile: new URL("./subagent_v2_nested/codex_transcript.ndjson", import.meta.url),
+        modelSelection: CODEX_MODEL_SELECTION,
+        assertOutput: assertSubagentV2NestedOutput,
+      },
+    ],
+  },
+  {
+    name: "opencode_subagent",
+    buildInput: openCodeSubagentInput,
+    providers: [
+      {
+        driver: ProviderDriverKind.make("opencode"),
+        transcriptFile: new URL("./opencode_subagent/opencode_transcript.ndjson", import.meta.url),
+        modelSelection: OPENCODE_MODEL_SELECTION,
+        assertOutput: assertOpenCodeSubagentOutput,
+      },
+    ],
+  },
+  {
+    name: "opencode_child_approval",
+    buildInput: openCodeChildApprovalInput,
+    providers: [
+      {
+        driver: ProviderDriverKind.make("opencode"),
+        transcriptFile: new URL(
+          "./opencode_child_approval/opencode_transcript.ndjson",
+          import.meta.url,
+        ),
+        modelSelection: OPENCODE_MODEL_SELECTION,
+        assertOutput: assertOpenCodeChildApprovalOutput,
+      },
+    ],
+  },
+  {
+    name: "multi_turn",
+    buildInput: multiTurnInput,
+    providers: [
+      {
+        driver: ProviderDriverKind.make("codex"),
+        transcriptFile: new URL("./multi_turn/codex_transcript.ndjson", import.meta.url),
+        modelSelection: CODEX_MODEL_SELECTION,
+        assertOutput: assertMultiTurnOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("claudeAgent"),
+        transcriptFile: new URL("./multi_turn/claude_transcript.ndjson", import.meta.url),
+        modelSelection: CLAUDE_MODEL_SELECTION,
+        assertOutput: assertMultiTurnClaudeOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("cursor"),
+        transcriptFile: new URL("./multi_turn/cursor_transcript.ndjson", import.meta.url),
+        modelSelection: CURSOR_MODEL_SELECTION,
+        assertOutput: assertMultiTurnOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("grok"),
+        transcriptFile: new URL("./multi_turn/grok_transcript.ndjson", import.meta.url),
+        modelSelection: GROK_MODEL_SELECTION,
+        assertOutput: assertMultiTurnOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("acpRegistry"),
+        transcriptFile: new URL("./multi_turn/grok_transcript.ndjson", import.meta.url),
+        modelSelection: ACP_REGISTRY_MODEL_SELECTION,
+        assertOutput: assertMultiTurnOutput,
+      },
+    ],
+  },
+  {
+    name: "multi_turn_restart",
+    buildInput: multiTurnInput,
+    providers: [
+      {
+        driver: ProviderDriverKind.make("claudeAgent"),
+        transcriptFile: new URL("./multi_turn_restart/claude_transcript.ndjson", import.meta.url),
+        modelSelection: CLAUDE_MODEL_SELECTION,
+        assertOutput: assertMultiTurnClaudeOutput,
+      },
+    ],
+  },
+  {
+    name: "queued_cancelled_while_active",
+    buildInput: queuedCancelledWhileActiveInput,
+    providers: [
+      {
+        driver: ProviderDriverKind.make("codex"),
+        transcriptFile: new URL("./queued_turn/codex_transcript.ndjson", import.meta.url),
+        recordedScenario: "queued_turn",
+        transcriptEntriesThroughLabel: "turn/completed",
+        modelSelection: CODEX_MODEL_SELECTION,
+        assertOutput: assertQueuedCancelledWhileActiveOutput,
+      },
+    ],
+  },
+  {
+    name: "queued_turn",
+    buildInput: queuedTurnInput,
+    providers: [
+      {
+        driver: ProviderDriverKind.make("codex"),
+        transcriptFile: new URL("./queued_turn/codex_transcript.ndjson", import.meta.url),
+        modelSelection: CODEX_MODEL_SELECTION,
+        assertOutput: assertQueuedTurnOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("claudeAgent"),
+        transcriptFile: new URL("./queued_turn/claude_transcript.ndjson", import.meta.url),
+        modelSelection: CLAUDE_MODEL_SELECTION,
+        assertOutput: assertQueuedTurnOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("cursor"),
+        transcriptFile: new URL("./queued_turn/cursor_transcript.ndjson", import.meta.url),
+        modelSelection: CURSOR_MODEL_SELECTION,
+        assertOutput: assertQueuedTurnOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("grok"),
+        transcriptFile: new URL("./queued_turn/grok_transcript.ndjson", import.meta.url),
+        modelSelection: GROK_MODEL_SELECTION,
+        assertOutput: assertQueuedTurnOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("acpRegistry"),
+        transcriptFile: new URL("./queued_turn/grok_transcript.ndjson", import.meta.url),
+        modelSelection: ACP_REGISTRY_MODEL_SELECTION,
+        assertOutput: assertQueuedTurnOutput,
+      },
+    ],
+  },
+  {
+    name: "todo_list",
+    buildInput: todoListInput,
+    providers: [
+      {
+        driver: ProviderDriverKind.make("codex"),
+        transcriptFile: new URL("./todo_list/codex_transcript.ndjson", import.meta.url),
+        modelSelection: CODEX_MODEL_SELECTION,
+        runtimePolicyOverride: READ_ONLY_NEVER_POLICY,
+        assertOutput: assertTodoListOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("cursor"),
+        transcriptFile: new URL("./todo_list/cursor_transcript.ndjson", import.meta.url),
+        modelSelection: CURSOR_MODEL_SELECTION,
+        runtimePolicyOverride: READ_ONLY_NEVER_POLICY,
+        assertOutput: assertTodoListCursorOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("grok"),
+        transcriptFile: new URL("./todo_list/grok_transcript.ndjson", import.meta.url),
+        modelSelection: GROK_MODEL_SELECTION,
+        assertOutput: assertTodoListGrokOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("acpRegistry"),
+        transcriptFile: new URL("./todo_list/grok_transcript.ndjson", import.meta.url),
+        modelSelection: ACP_REGISTRY_MODEL_SELECTION,
+        assertOutput: assertTodoListGrokOutput,
+      },
+    ],
+  },
+  {
+    name: "web_search",
+    buildInput: webSearchInput,
+    providers: [
+      {
+        driver: ProviderDriverKind.make("codex"),
+        transcriptFile: new URL("./web_search/codex_transcript.ndjson", import.meta.url),
+        modelSelection: CODEX_MODEL_SELECTION,
+        assertOutput: assertWebSearchOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("claudeAgent"),
+        transcriptFile: new URL("./web_search/claude_transcript.ndjson", import.meta.url),
+        modelSelection: CLAUDE_MODEL_SELECTION,
+        assertOutput: assertClaudeWebSearchOutput,
+      },
+    ],
+  },
+  {
+    name: "plan_questions",
+    buildInput: planQuestionsInput,
+    providers: [
+      {
+        driver: ProviderDriverKind.make("codex"),
+        transcriptFile: new URL("./plan_questions/codex_transcript.ndjson", import.meta.url),
+        modelSelection: CODEX_MODEL_SELECTION,
+        runtimePolicyOverride: READ_ONLY_NEVER_POLICY,
+        assertOutput: assertPlanQuestionsOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("grok"),
+        transcriptFile: new URL("./plan_questions/grok_transcript.ndjson", import.meta.url),
+        modelSelection: GROK_MODEL_SELECTION,
+        runtimePolicyOverride: READ_ONLY_NEVER_POLICY,
+        assertOutput: assertPlanQuestionsOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("opencode"),
+        transcriptFile: new URL("./plan_questions/opencode_transcript.ndjson", import.meta.url),
+        modelSelection: OPENCODE_MODEL_SELECTION,
+        runtimePolicyOverride: READ_ONLY_NEVER_POLICY,
+        assertOutput: assertOpenCodePlanQuestionsOutput,
+      },
+    ],
+  },
+  {
+    name: "proposed_plan",
+    buildInput: proposedPlanInput,
+    providers: [
+      {
+        driver: ProviderDriverKind.make("codex"),
+        transcriptFile: new URL("./proposed_plan/codex_transcript.ndjson", import.meta.url),
+        modelSelection: CODEX_MODEL_SELECTION,
+        runtimePolicyOverride: READ_ONLY_NEVER_POLICY,
+        assertOutput: assertProposedPlanOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("cursor"),
+        transcriptFile: new URL("./proposed_plan/cursor_transcript.ndjson", import.meta.url),
+        modelSelection: CURSOR_MODEL_SELECTION,
+        runtimePolicyOverride: READ_ONLY_NEVER_POLICY,
+        assertOutput: assertProposedPlanCursorOutput,
+      },
+    ],
+  },
+  {
+    name: "message_steering",
+    buildInput: messageSteeringInput,
+    providers: [
+      {
+        driver: ProviderDriverKind.make("codex"),
+        transcriptFile: new URL("./message_steering/codex_transcript.ndjson", import.meta.url),
+        modelSelection: CODEX_MODEL_SELECTION,
+        assertOutput: assertMessageSteeringOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("claudeAgent"),
+        transcriptFile: new URL("./message_steering/claude_transcript.ndjson", import.meta.url),
+        modelSelection: CLAUDE_MODEL_SELECTION,
+        assertOutput: assertClaudeMessageSteeringOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("cursor"),
+        transcriptFile: new URL("./message_steering/cursor_transcript.ndjson", import.meta.url),
+        modelSelection: CURSOR_MODEL_SELECTION,
+        assertOutput: assertCursorMessageSteeringOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("grok"),
+        transcriptFile: new URL("./message_steering/grok_transcript.ndjson", import.meta.url),
+        modelSelection: GROK_MODEL_SELECTION,
+        assertOutput: assertGrokMessageSteeringOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("acpRegistry"),
+        transcriptFile: new URL("./message_steering/grok_transcript.ndjson", import.meta.url),
+        modelSelection: ACP_REGISTRY_MODEL_SELECTION,
+        assertOutput: assertGrokMessageSteeringOutput,
+      },
+    ],
+  },
+  {
+    name: "turn_interrupt",
+    buildInput: turnInterruptInput,
+    providers: [
+      {
+        driver: ProviderDriverKind.make("codex"),
+        transcriptFile: new URL("./turn_interrupt/codex_transcript.ndjson", import.meta.url),
+        modelSelection: CODEX_MODEL_SELECTION,
+        runtimePolicyOverride: WORKSPACE_NEVER_POLICY,
+        assertOutput: assertTurnInterruptOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("claudeAgent"),
+        transcriptFile: new URL("./turn_interrupt/claude_transcript.ndjson", import.meta.url),
+        modelSelection: CLAUDE_MODEL_SELECTION,
+        runtimePolicyOverride: WORKSPACE_NEVER_POLICY,
+        assertOutput: assertTurnInterruptClaudeOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("grok"),
+        transcriptFile: new URL("./turn_interrupt/grok_transcript.ndjson", import.meta.url),
+        modelSelection: GROK_MODEL_SELECTION,
+        runtimePolicyOverride: WORKSPACE_NEVER_POLICY,
+        assertOutput: assertTurnInterruptOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("acpRegistry"),
+        transcriptFile: new URL("./turn_interrupt/grok_transcript.ndjson", import.meta.url),
+        modelSelection: ACP_REGISTRY_MODEL_SELECTION,
+        runtimePolicyOverride: WORKSPACE_NEVER_POLICY,
+        assertOutput: assertTurnInterruptOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("opencode"),
+        transcriptFile: new URL("./turn_interrupt/opencode_transcript.ndjson", import.meta.url),
+        modelSelection: OPENCODE_MODEL_SELECTION,
+        runtimePolicyOverride: WORKSPACE_NEVER_POLICY,
+        assertOutput: assertTurnInterruptOutput,
+      },
+    ],
+  },
+  {
+    name: "turn_interrupt_mid_tool",
+    buildInput: turnInterruptMidToolInput,
+    providers: [
+      {
+        driver: ProviderDriverKind.make("codex"),
+        transcriptFile: new URL(
+          "./turn_interrupt_mid_tool/codex_transcript.ndjson",
+          import.meta.url,
+        ),
+        modelSelection: CODEX_MODEL_SELECTION,
+        runtimePolicyOverride: WORKSPACE_NEVER_POLICY,
+        assertOutput: assertTurnInterruptMidToolCodexOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("claudeAgent"),
+        transcriptFile: new URL(
+          "./turn_interrupt_mid_tool/claude_transcript.ndjson",
+          import.meta.url,
+        ),
+        modelSelection: CLAUDE_MODEL_SELECTION,
+        runtimePolicyOverride: WORKSPACE_NEVER_POLICY,
+        assertOutput: assertTurnInterruptMidToolClaudeOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("cursor"),
+        transcriptFile: new URL(
+          "./turn_interrupt_mid_tool/cursor_transcript.ndjson",
+          import.meta.url,
+        ),
+        modelSelection: CURSOR_MODEL_SELECTION,
+        runtimePolicyOverride: WORKSPACE_NEVER_POLICY,
+        assertOutput: assertTurnInterruptMidToolCursorOutput,
+      },
+    ],
+  },
+  {
+    name: "turn_interrupt_restart",
+    buildInput: turnInterruptRestartInput,
+    providers: [
+      {
+        driver: ProviderDriverKind.make("claudeAgent"),
+        transcriptFile: new URL(
+          "./turn_interrupt_restart/claude_transcript.ndjson",
+          import.meta.url,
+        ),
+        modelSelection: CLAUDE_MODEL_SELECTION,
+        runtimePolicyOverride: WORKSPACE_NEVER_POLICY,
+        assertOutput: assertTurnInterruptRestartClaudeOutput,
+      },
+    ],
+  },
+  {
+    name: "thread_rollback",
+    buildInput: threadRollbackInput,
+    providers: [
+      {
+        driver: ProviderDriverKind.make("codex"),
+        transcriptFile: new URL("./thread_rollback/codex_transcript.ndjson", import.meta.url),
+        modelSelection: CODEX_MODEL_SELECTION,
+        assertOutput: assertThreadRollbackOutput,
+      },
+      {
+        driver: ProviderDriverKind.make("claudeAgent"),
+        transcriptFile: new URL("./thread_rollback/claude_transcript.ndjson", import.meta.url),
+        modelSelection: CLAUDE_MODEL_SELECTION,
+        assertOutput: assertClaudeThreadRollbackOutput,
+      },
+    ],
+  },
+];
+
+// TODO(claude-v2/approvals-denied): add denied write fixtures after the live query runner records
+// Claude denial callback responses. Cross-reference
+// `tool_call_read_only_on_request/claude_transcript.ndjson`,
+// `tool_call_workspace_never/claude_transcript.ndjson`,
+// `tool_call_restricted_granular/claude_transcript.ndjson`, and
+// docs/orchestration-v2/provider-capability-system.md.
+
+// TODO(claude-v2/context-transfer): add provider-switch handoff and return fixtures when portable
+// context handoff is implemented. Cross-reference docs/orchestration-v2/provider-switching-and-context.md
+// and docs/orchestration-v2/thread-lineage-and-context-transfer.md. The return fixture should
+// prefer a delta handoff into an existing Claude provider thread.
+
+// TODO(claude-v2/context-transfer-fixtures): register provider-switch, merge-back, and cross-provider
+// fork fixtures after each path has a real provider transcript. Cross-reference
+// docs/orchestration-v2/provider-switching-and-context.md and
+// docs/orchestration-v2/thread-lineage-and-context-transfer.md.
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/message_steering/claude_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/message_steering/claude_output.ts
new file mode 100644
index 000000000000..26c2646bbb1f
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/message_steering/claude_output.ts
@@ -0,0 +1,43 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertAssistantTextIncludes,
+  assertBaseProjection,
+  assertRuntimeRequestCounts,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessageInputIntents,
+  assertUserMessagesInclude,
+  assertVisibleTurnItemsMirrorLocalTurnItems,
+  MESSAGE_STEERING_INITIAL_PROMPT,
+  MESSAGE_STEERING_STEER_PROMPT,
+  projectionFor,
+} from "../shared.ts";
+
+export function assertClaudeMessageSteeringOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assert.equal(transcript.provider, "claudeAgent");
+  assertBaseProjection({ result, transcript, runCount: 1, runStatuses: ["completed"] });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertVisibleTurnItemsMirrorLocalTurnItems(projection);
+  assertTurnItemTypes(projection, ["user_message", "assistant_message"]);
+  assertRuntimeRequestCounts(projection, { total: 0 });
+  assertUserMessagesInclude(projection, [
+    MESSAGE_STEERING_INITIAL_PROMPT,
+    MESSAGE_STEERING_STEER_PROMPT,
+  ]);
+  assertUserMessageInputIntents(projection, ["turn_start", "steer"]);
+  assertAssistantTextIncludes(projection, "steering fixture observed");
+  assert.equal(projection.runs.length, 1, "steering must attach to the active run");
+  assert.equal(
+    projection.providerTurns.length,
+    1,
+    "active steering must not create a new provider turn",
+  );
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/message_steering/claude_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/message_steering/claude_transcript.ndjson
new file mode 100644
index 000000000000..f534330245e2
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/message_steering/claude_transcript.ndjson
@@ -0,0 +1,13 @@
+{"type":"transcript_start","provider":"claudeAgent","protocol":"claude-agent-sdk.query","version":"0.2.111","scenario":"message_steering","metadata":{"prompts":["Respond with exactly: steering fixture initial response","Actually, respond with exactly: steering fixture observed"],"model":"claude-sonnet-4-6","nativeSessionId":"05f72f7d-81d5-4db9-a3cf-234191cf79f9","queryMode":"active_steering","tools":"claude_code","permissionMode":"bypassPermissions","generatedBy":"recordClaudeAgentSdkReplayTranscript"}}
+{"type":"expect_outbound","label":"query.open","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"sessionId":"05f72f7d-81d5-4db9-a3cf-234191cf79f9"}}}
+{"type":"expect_outbound","label":"prompt.offer:1","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Respond with exactly: steering fixture initial response"},"parent_tool_use_id":null}}}
+{"type":"expect_outbound","label":"prompt.offer:2","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Actually, respond with exactly: steering fixture observed"},"parent_tool_use_id":null,"priority":"now"}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"2961831d-241e-47c4-8099-b8779c6b3878","hook_name":"SessionStart:startup","hook_event":"SessionStart","uuid":"d45438eb-d485-490f-9668-a02c5721a6b3","session_id":"05f72f7d-81d5-4db9-a3cf-234191cf79f9"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"2961831d-241e-47c4-8099-b8779c6b3878","hook_name":"SessionStart:startup","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"40ef0c52-1168-4049-99af-4c3beb507994","session_id":"05f72f7d-81d5-4db9-a3cf-234191cf79f9"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.111","cwd":"/tmp/claude-replay-message_steering","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"71579637-9bc5-4182-b104-4ebb8f2bda0d","session_id":"05f72f7d-81d5-4db9-a3cf-234191cf79f9"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"error_during_execution","duration_ms":747,"duration_api_ms":0,"is_error":true,"num_turns":1,"stop_reason":null,"session_id":"05f72f7d-81d5-4db9-a3cf-234191cf79f9","total_cost_usd":0,"usage":{"input_tokens":0,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"output_tokens":0,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[],"speed":"standard"},"modelUsage":{},"permission_denials":[],"terminal_reason":"aborted_streaming","fast_mode_state":"off","uuid":"781fa8c7-98dd-4679-bb99-82d4c77c9b0c","errors":["[ede_diagnostic] result_type=user last_content_type=n/a stop_reason=null","Error: Request was aborted.\n    at vn8 (/tmp/claude-replay-message_steering/node_modules/.bun/@anthropic-ai+claude-agent-sdk@0.2.111+3c5d820c62823f0b/node_modules/@anthropic-ai/claude-agent-sdk/cli.js:5550:1432)\n    at next (native:1:11)\n    at a85 (/tmp/claude-replay-message_steering/node_modules/.bun/@anthropic-ai+claude-agent-sdk@0.2.111+3c5d820c62823f0b/node_modules/@anthropic-ai/claude-agent-sdk/cli.js:8321:5086)\n    at processTicksAndRejections (native:7:39)"]}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.111","cwd":"/tmp/claude-replay-message_steering","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"60494b15-57a4-417d-a0d0-0ce42590c36e","session_id":"05f72f7d-81d5-4db9-a3cf-234191cf79f9"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01Cjp5MnmN6F7wwrzNss9zVW","type":"message","role":"assistant","content":[{"type":"text","text":"steering fixture observed"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":2347,"cache_read_input_tokens":9455,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2347},"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"05f72f7d-81d5-4db9-a3cf-234191cf79f9","uuid":"2faa9bee-1c72-4b8f-ab04-9796a7ecf6a2"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed"},"uuid":"b0bfc7e0-1698-4480-821d-16262ceb4448","session_id":"05f72f7d-81d5-4db9-a3cf-234191cf79f9"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":3836,"duration_api_ms":1808,"num_turns":1,"result":"steering fixture observed","stop_reason":"end_turn","session_id":"05f72f7d-81d5-4db9-a3cf-234191cf79f9","total_cost_usd":0.01173675,"usage":{"input_tokens":3,"cache_creation_input_tokens":2347,"cache_read_input_tokens":9455,"output_tokens":6,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":2347,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[{"input_tokens":3,"output_tokens":6,"cache_read_input_tokens":9455,"cache_creation_input_tokens":2347,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2347},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":3,"outputTokens":6,"cacheReadInputTokens":9455,"cacheCreationInputTokens":2347,"webSearchRequests":0,"costUSD":0.01173675,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"7ac0393a-c862-449c-95f7-bbf391264476"}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/message_steering/codex_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/message_steering/codex_output.ts
new file mode 100644
index 000000000000..1a238beea3a5
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/message_steering/codex_output.ts
@@ -0,0 +1,43 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertAssistantTextIncludes,
+  assertBaseProjection,
+  assertRuntimeRequestCounts,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessageInputIntents,
+  assertUserMessagesInclude,
+  assertVisibleTurnItemsMirrorLocalTurnItems,
+  MESSAGE_STEERING_INITIAL_PROMPT,
+  MESSAGE_STEERING_STEER_PROMPT,
+  projectionFor,
+} from "../shared.ts";
+
+export function assertMessageSteeringOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assert.equal(transcript.provider, "codex");
+  assertBaseProjection({ result, transcript, runCount: 1, runStatuses: ["completed"] });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertVisibleTurnItemsMirrorLocalTurnItems(projection);
+  assertTurnItemTypes(projection, ["user_message", "assistant_message"]);
+  assertRuntimeRequestCounts(projection, { total: 0 });
+  assertUserMessagesInclude(projection, [
+    MESSAGE_STEERING_INITIAL_PROMPT,
+    MESSAGE_STEERING_STEER_PROMPT,
+  ]);
+  assertUserMessageInputIntents(projection, ["turn_start", "steer"]);
+  assertAssistantTextIncludes(projection, "steering fixture observed");
+  assert.equal(projection.runs.length, 1, "steering must attach to the active run");
+  assert.equal(
+    projection.providerTurns.length,
+    1,
+    "active steering must not create a new provider turn",
+  );
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/message_steering/codex_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/message_steering/codex_transcript.ndjson
new file mode 100644
index 000000000000..5ec0fa5313bf
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/message_steering/codex_transcript.ndjson
@@ -0,0 +1,51 @@
+{"type":"transcript_start","provider":"codex","protocol":"codex.app-server","version":"0.128.0","scenario":"message_steering","metadata":{"source":"record-codex-app-server-replay-fixture","fileName":"message_steering.ndjson","description":"One active turn receives an immediate turn/steer request."}}
+{"type":"expect_outbound","label":"initialize","frame":{"id":1,"method":"initialize","params":{"capabilities":{"experimentalApi":true},"clientInfo":{"name":"t3code_desktop","title":"T3 Code Desktop","version":"0.1.0"}}}}
+{"type":"emit_inbound","label":"initialize","frame":{"id":1,"result":{"userAgent":"t3code_desktop/0.128.0 (Mac OS 26.4.1; arm64) dumb (t3code_desktop; 0.1.0)","codexHome":"/Users/julius/.codex_p","platformFamily":"unix","platformOs":"macos"}}}
+{"type":"expect_outbound","label":"initialized","frame":{"method":"initialized"}}
+{"type":"expect_outbound","label":"thread/start","frame":{"id":2,"method":"thread/start","params":{}}}
+{"type":"emit_inbound","label":"remoteControl/status/changed","frame":{"method":"remoteControl/status/changed","params":{"status":"disabled","environmentId":null}}}
+{"type":"emit_inbound","label":"thread/start","frame":{"id":2,"result":{"thread":{"id":"019e014d-b214-71f0-9538-23527e8247ca","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1778138329,"updatedAt":1778138329,"status":{"type":"idle"},"path":"/Users/julius/.codex_p/sessions/2026/05/07/rollout-2026-05-07T00-18-49-019e014d-b214-71f0-9538-23527e8247ca.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/apps/server","cliVersion":"0.128.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]},"model":"gpt-5.5","modelProvider":"openai","serviceTier":"fast","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/apps/server","instructionSources":["/Users/julius/.codex_p/AGENTS.md","/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/AGENTS.md"],"approvalPolicy":"on-request","approvalsReviewer":"user","sandbox":{"type":"workspaceWrite","writableRoots":["/Users/julius/.codex_p/memories"],"networkAccess":false,"excludeTmpdirEnvVar":false,"excludeSlashTmp":false},"permissionProfile":{"type":"managed","network":{"enabled":false},"fileSystem":{"type":"restricted","entries":[{"path":{"type":"special","value":{"kind":"root"}},"access":"read"},{"path":{"type":"special","value":{"kind":"project_roots","subpath":null}},"access":"write"},{"path":{"type":"special","value":{"kind":"slash_tmp"}},"access":"write"},{"path":{"type":"special","value":{"kind":"tmpdir"}},"access":"write"},{"path":{"type":"special","value":{"kind":"project_roots","subpath":".git"}},"access":"read"},{"path":{"type":"special","value":{"kind":"project_roots","subpath":".agents"}},"access":"read"},{"path":{"type":"special","value":{"kind":"project_roots","subpath":".codex"}},"access":"read"},{"path":{"type":"path","path":"/Users/julius/.codex_p/memories"},"access":"write"}]}},"activePermissionProfile":{"id":":workspace","extends":null,"modifications":[]},"reasoningEffort":"medium"}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":3,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Respond with exactly: steering fixture initial response","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"type":"dangerFullAccess"},"threadId":"019e014d-b214-71f0-9538-23527e8247ca","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"thread/started","frame":{"method":"thread/started","params":{"thread":{"id":"019e014d-b214-71f0-9538-23527e8247ca","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1778138329,"updatedAt":1778138329,"status":{"type":"idle"},"path":"/Users/julius/.codex_p/sessions/2026/05/07/rollout-2026-05-07T00-18-49-019e014d-b214-71f0-9538-23527e8247ca.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/apps/server","cliVersion":"0.128.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]}}}}
+{"type":"emit_inbound","label":"deprecationNotice","frame":{"method":"deprecationNotice","params":{"summary":"`[features].collab` is deprecated. Use `[features].multi_agent` instead.","details":"Enable it with `--enable multi_agent` or `[features].multi_agent` in config.toml. See https://developers.openai.com/codex/config-basic#feature-flags for details."}}}
+{"type":"emit_inbound","label":"warning","frame":{"method":"warning","params":{"threadId":"019e014d-b214-71f0-9538-23527e8247ca","message":"Under-development features enabled: apply_patch_freeform. Under-development features are incomplete and may behave unpredictably. To suppress this warning, set `suppress_unstable_features_warning = true` in /Users/julius/.codex_p/config.toml."}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"computer-use","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":3,"result":{"turn":{"id":"019e014d-b227-7af1-a889-6c7d828eb1a2","items":[],"status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019e014d-b214-71f0-9538-23527e8247ca","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019e014d-b214-71f0-9538-23527e8247ca","turn":{"id":"019e014d-b227-7af1-a889-6c7d828eb1a2","items":[],"status":"inProgress","error":null,"startedAt":1778138329,"completedAt":null,"durationMs":null}}}}
+{"type":"expect_outbound","label":"turn/steer","frame":{"id":4,"method":"turn/steer","params":{"expectedTurnId":"019e014d-b227-7af1-a889-6c7d828eb1a2","input":[{"text":"Actually, respond with exactly: steering fixture observed","type":"text"}],"threadId":"019e014d-b214-71f0-9538-23527e8247ca"}}}
+{"type":"emit_inbound","label":"turn/steer","frame":{"id":4,"result":{"turnId":"019e014d-b227-7af1-a889-6c7d828eb1a2"}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"computer-use","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"4fac8685-35e8-475c-96b6-9adb33c68158","content":[{"type":"text","text":"Respond with exactly: steering fixture initial response","text_elements":[]}]},"threadId":"019e014d-b214-71f0-9538-23527e8247ca","turnId":"019e014d-b227-7af1-a889-6c7d828eb1a2"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"4fac8685-35e8-475c-96b6-9adb33c68158","content":[{"type":"text","text":"Respond with exactly: steering fixture initial response","text_elements":[]}]},"threadId":"019e014d-b214-71f0-9538-23527e8247ca","turnId":"019e014d-b227-7af1-a889-6c7d828eb1a2"}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":19,"windowDurationMins":300,"resetsAt":1778142198},"secondary":{"usedPercent":31,"windowDurationMins":10080,"resetsAt":1778539136},"credits":null,"planType":"pro","rateLimitReachedType":null}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"reasoning","id":"rs_010631d904f9e19a0169fc3cdcb670819486fcc6dc7b883f58","summary":[],"content":[]},"threadId":"019e014d-b214-71f0-9538-23527e8247ca","turnId":"019e014d-b227-7af1-a889-6c7d828eb1a2"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"reasoning","id":"rs_010631d904f9e19a0169fc3cdcb670819486fcc6dc7b883f58","summary":[],"content":[]},"threadId":"019e014d-b214-71f0-9538-23527e8247ca","turnId":"019e014d-b227-7af1-a889-6c7d828eb1a2"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_010631d904f9e19a0169fc3cdce8ec8194a7d8a5bb50424c09","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019e014d-b214-71f0-9538-23527e8247ca","turnId":"019e014d-b227-7af1-a889-6c7d828eb1a2"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019e014d-b214-71f0-9538-23527e8247ca","turnId":"019e014d-b227-7af1-a889-6c7d828eb1a2","itemId":"msg_010631d904f9e19a0169fc3cdce8ec8194a7d8a5bb50424c09","delta":"ste"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019e014d-b214-71f0-9538-23527e8247ca","turnId":"019e014d-b227-7af1-a889-6c7d828eb1a2","itemId":"msg_010631d904f9e19a0169fc3cdce8ec8194a7d8a5bb50424c09","delta":"ering"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019e014d-b214-71f0-9538-23527e8247ca","turnId":"019e014d-b227-7af1-a889-6c7d828eb1a2","itemId":"msg_010631d904f9e19a0169fc3cdce8ec8194a7d8a5bb50424c09","delta":" fixture"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019e014d-b214-71f0-9538-23527e8247ca","turnId":"019e014d-b227-7af1-a889-6c7d828eb1a2","itemId":"msg_010631d904f9e19a0169fc3cdce8ec8194a7d8a5bb50424c09","delta":" initial"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019e014d-b214-71f0-9538-23527e8247ca","turnId":"019e014d-b227-7af1-a889-6c7d828eb1a2","itemId":"msg_010631d904f9e19a0169fc3cdce8ec8194a7d8a5bb50424c09","delta":" response"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_010631d904f9e19a0169fc3cdce8ec8194a7d8a5bb50424c09","text":"steering fixture initial response","phase":"final_answer","memoryCitation":null},"threadId":"019e014d-b214-71f0-9538-23527e8247ca","turnId":"019e014d-b227-7af1-a889-6c7d828eb1a2"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019e014d-b214-71f0-9538-23527e8247ca","turnId":"019e014d-b227-7af1-a889-6c7d828eb1a2","tokenUsage":{"total":{"totalTokens":18900,"inputTokens":18880,"cachedInputTokens":7552,"outputTokens":20,"reasoningOutputTokens":9},"last":{"totalTokens":18900,"inputTokens":18880,"cachedInputTokens":7552,"outputTokens":20,"reasoningOutputTokens":9},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":19,"windowDurationMins":300,"resetsAt":1778142198},"secondary":{"usedPercent":31,"windowDurationMins":10080,"resetsAt":1778539136},"credits":null,"planType":"pro","rateLimitReachedType":null}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"3d8198bc-53c8-4885-8dfe-c5158eb2cfb3","content":[{"type":"text","text":"Actually, respond with exactly: steering fixture observed","text_elements":[]}]},"threadId":"019e014d-b214-71f0-9538-23527e8247ca","turnId":"019e014d-b227-7af1-a889-6c7d828eb1a2"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"3d8198bc-53c8-4885-8dfe-c5158eb2cfb3","content":[{"type":"text","text":"Actually, respond with exactly: steering fixture observed","text_elements":[]}]},"threadId":"019e014d-b214-71f0-9538-23527e8247ca","turnId":"019e014d-b227-7af1-a889-6c7d828eb1a2"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019e014d-b214-71f0-9538-23527e8247ca","turnId":"019e014d-b227-7af1-a889-6c7d828eb1a2","tokenUsage":{"total":{"totalTokens":18900,"inputTokens":18880,"cachedInputTokens":7552,"outputTokens":20,"reasoningOutputTokens":9},"last":{"totalTokens":18900,"inputTokens":18880,"cachedInputTokens":7552,"outputTokens":20,"reasoningOutputTokens":9},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":19,"windowDurationMins":300,"resetsAt":1778142198},"secondary":{"usedPercent":31,"windowDurationMins":10080,"resetsAt":1778539136},"credits":null,"planType":"pro","rateLimitReachedType":null}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_010631d904f9e19a0169fc3cddd2b08194ba097f57a2fd6332","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019e014d-b214-71f0-9538-23527e8247ca","turnId":"019e014d-b227-7af1-a889-6c7d828eb1a2"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019e014d-b214-71f0-9538-23527e8247ca","turnId":"019e014d-b227-7af1-a889-6c7d828eb1a2","itemId":"msg_010631d904f9e19a0169fc3cddd2b08194ba097f57a2fd6332","delta":"ste"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019e014d-b214-71f0-9538-23527e8247ca","turnId":"019e014d-b227-7af1-a889-6c7d828eb1a2","itemId":"msg_010631d904f9e19a0169fc3cddd2b08194ba097f57a2fd6332","delta":"ering"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019e014d-b214-71f0-9538-23527e8247ca","turnId":"019e014d-b227-7af1-a889-6c7d828eb1a2","itemId":"msg_010631d904f9e19a0169fc3cddd2b08194ba097f57a2fd6332","delta":" fixture"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019e014d-b214-71f0-9538-23527e8247ca","turnId":"019e014d-b227-7af1-a889-6c7d828eb1a2","itemId":"msg_010631d904f9e19a0169fc3cddd2b08194ba097f57a2fd6332","delta":" observed"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_010631d904f9e19a0169fc3cddd2b08194ba097f57a2fd6332","text":"steering fixture observed","phase":"final_answer","memoryCitation":null},"threadId":"019e014d-b214-71f0-9538-23527e8247ca","turnId":"019e014d-b227-7af1-a889-6c7d828eb1a2"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019e014d-b214-71f0-9538-23527e8247ca","turnId":"019e014d-b227-7af1-a889-6c7d828eb1a2","tokenUsage":{"total":{"totalTokens":37812,"inputTokens":37784,"cachedInputTokens":26368,"outputTokens":28,"reasoningOutputTokens":9},"last":{"totalTokens":18912,"inputTokens":18904,"cachedInputTokens":18816,"outputTokens":8,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":19,"windowDurationMins":300,"resetsAt":1778142198},"secondary":{"usedPercent":31,"windowDurationMins":10080,"resetsAt":1778539136},"credits":null,"planType":"pro","rateLimitReachedType":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019e014d-b214-71f0-9538-23527e8247ca","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019e014d-b214-71f0-9538-23527e8247ca","turn":{"id":"019e014d-b227-7af1-a889-6c7d828eb1a2","items":[],"status":"completed","error":null,"startedAt":1778138329,"completedAt":1778138333,"durationMs":4311}}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/message_steering/cursor_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/message_steering/cursor_output.ts
new file mode 100644
index 000000000000..331494492745
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/message_steering/cursor_output.ts
@@ -0,0 +1,56 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertAssistantTextIncludes,
+  assertBaseProjection,
+  assertRuntimeRequestCounts,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessageInputIntents,
+  assertUserMessagesInclude,
+  MESSAGE_STEERING_INITIAL_PROMPT,
+  MESSAGE_STEERING_STEER_PROMPT,
+  projectionFor,
+} from "../shared.ts";
+
+export function assertCursorMessageSteeringOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assert.equal(transcript.provider, "cursor");
+  assertBaseProjection({ result, transcript, runCount: 1, runStatuses: ["completed"] });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertTurnItemTypes(projection, ["user_message", "assistant_message"]);
+  assertRuntimeRequestCounts(projection, { total: 0 });
+  assertUserMessagesInclude(projection, [
+    MESSAGE_STEERING_INITIAL_PROMPT,
+    MESSAGE_STEERING_STEER_PROMPT,
+  ]);
+  assertUserMessageInputIntents(projection, ["turn_start", "steer"]);
+  assertAssistantTextIncludes(projection, "steering fixture observed");
+
+  assert.lengthOf(projection.runs, 1, "steering must preserve the app run");
+  assert.deepEqual(
+    projection.attempts.map((attempt) => [attempt.reason, attempt.status]),
+    [
+      ["initial", "superseded"],
+      ["steering_restart", "completed"],
+    ],
+  );
+  assert.deepEqual(
+    projection.providerTurns.map((turn) => turn.status),
+    ["interrupted", "completed"],
+  );
+  assert.equal(projection.runs[0]?.activeAttemptId, projection.attempts[1]?.id);
+  assert.equal(projection.runs[0]?.rootNodeId, projection.attempts[1]?.rootNodeId);
+  assert.isFalse(
+    projection.turnItems.some(
+      (item) => item.type === "run_interrupt_request" || item.type === "run_interrupt_result",
+    ),
+    "steer supersede must not project run_interrupt_* items (those are hard Stop only)",
+  );
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/message_steering/cursor_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/message_steering/cursor_transcript.ndjson
new file mode 100644
index 000000000000..4a2357eebc83
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/message_steering/cursor_transcript.ndjson
@@ -0,0 +1,21 @@
+{"type":"transcript_start","provider":"cursor","protocol":"cursor-agent-sdk.local","version":"1","scenario":"message_steering","metadata":{"generatedBy":"recordCursorAgentSdkReplayTranscript","nativeAgentId":"agent-95a210ed-ddf9-4b36-b265-9a2b02e46050"}}
+{"type":"expect_outbound","label":"agent.open","frame":{"type":"agent.open","operation":"create","options":{"model":{"id":"composer-2.5"},"hasName":true,"mode":"agent","local":{"hasCwd":true,"autoReview":false,"sandboxEnabled":false,"enableAgentRetries":true}}}}
+{"type":"emit_inbound","label":"agent.opened","frame":{"type":"agent.opened","agentId":"agent-95a210ed-ddf9-4b36-b265-9a2b02e46050"}}
+{"type":"expect_outbound","label":"run.start:1","frame":{"type":"run.start","message":"Respond with exactly: steering fixture initial response","options":{"model":{"id":"composer-2.5"},"mode":"agent"}}}
+{"type":"emit_inbound","label":"run.started:1","frame":{"type":"run.started","runId":"run-c794f71d-f53a-47ba-b127-b9f26cf64ce1","agentId":"agent-95a210ed-ddf9-4b36-b265-9a2b02e46050"}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-c794f71d-f53a-47ba-b127-b9f26cf64ce1","update":{"type":"text-delta","text":"ste"}}}
+{"type":"expect_outbound","label":"run.cancel:1","frame":{"type":"run.cancel","runId":"run-c794f71d-f53a-47ba-b127-b9f26cf64ce1"}}
+{"type":"emit_inbound","label":"run.completed:1","frame":{"type":"run.completed","result":{"id":"run-c794f71d-f53a-47ba-b127-b9f26cf64ce1","requestId":"60f12d12-3cd5-47f1-a4dc-bda43dc5a136","status":"cancelled","model":{"id":"composer-2.5"},"durationMs":4219}}}
+{"type":"expect_outbound","label":"run.start:2","frame":{"type":"run.start","message":"Actually, respond with exactly: steering fixture observed","options":{"model":{"id":"composer-2.5"},"mode":"agent"}}}
+{"type":"emit_inbound","label":"run.started:2","frame":{"type":"run.started","runId":"run-c93ec26d-f38b-4a58-9005-1ed91ad98b9c","agentId":"agent-95a210ed-ddf9-4b36-b265-9a2b02e46050"}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-c93ec26d-f38b-4a58-9005-1ed91ad98b9c","update":{"type":"text-delta","text":"ste"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-c93ec26d-f38b-4a58-9005-1ed91ad98b9c","update":{"type":"text-delta","text":"ering"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-c93ec26d-f38b-4a58-9005-1ed91ad98b9c","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-c93ec26d-f38b-4a58-9005-1ed91ad98b9c","update":{"type":"text-delta","text":" fixture"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-c93ec26d-f38b-4a58-9005-1ed91ad98b9c","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-c93ec26d-f38b-4a58-9005-1ed91ad98b9c","update":{"type":"text-delta","text":" observed"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-c93ec26d-f38b-4a58-9005-1ed91ad98b9c","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"step-completed","frame":{"type":"interaction.update","runId":"run-c93ec26d-f38b-4a58-9005-1ed91ad98b9c","update":{"type":"step-completed","stepId":1,"stepDurationMs":1055}}}
+{"type":"emit_inbound","label":"turn-ended","frame":{"type":"interaction.update","runId":"run-c93ec26d-f38b-4a58-9005-1ed91ad98b9c","update":{"type":"turn-ended","usage":{"inputTokens":10270,"outputTokens":42,"cacheReadTokens":7441,"cacheWriteTokens":0}}}}
+{"type":"emit_inbound","label":"run.completed:2","frame":{"type":"run.completed","result":{"id":"run-c93ec26d-f38b-4a58-9005-1ed91ad98b9c","requestId":"21e1995e-2649-4e30-aec6-d967e9bce64c","status":"finished","result":"steering fixture observed","model":{"id":"composer-2.5"},"durationMs":1465}}}
+{"type":"expect_outbound","label":"agent.close","frame":{"type":"agent.close","agentId":"agent-95a210ed-ddf9-4b36-b265-9a2b02e46050"}}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/message_steering/grok_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/message_steering/grok_output.ts
new file mode 100644
index 000000000000..3587141c96f7
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/message_steering/grok_output.ts
@@ -0,0 +1,55 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertAssistantTextIncludes,
+  assertBaseProjection,
+  assertRuntimeRequestCounts,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessageInputIntents,
+  assertUserMessagesInclude,
+  MESSAGE_STEERING_INITIAL_PROMPT,
+  MESSAGE_STEERING_STEER_PROMPT,
+  projectionFor,
+} from "../shared.ts";
+
+export function assertGrokMessageSteeringOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({ result, transcript, runCount: 1, runStatuses: ["completed"] });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertTurnItemTypes(projection, ["user_message", "assistant_message"]);
+  assertRuntimeRequestCounts(projection, { total: 0 });
+  assertUserMessagesInclude(projection, [
+    MESSAGE_STEERING_INITIAL_PROMPT,
+    MESSAGE_STEERING_STEER_PROMPT,
+  ]);
+  assertUserMessageInputIntents(projection, ["turn_start", "steer"]);
+  assertAssistantTextIncludes(projection, "steering fixture observed");
+
+  assert.lengthOf(projection.runs, 1, "steering must preserve the app run");
+  assert.deepEqual(
+    projection.attempts.map((attempt) => [attempt.reason, attempt.status]),
+    [
+      ["initial", "superseded"],
+      ["steering_restart", "completed"],
+    ],
+  );
+  assert.deepEqual(
+    projection.providerTurns.map((turn) => turn.status),
+    ["interrupted", "completed"],
+  );
+  assert.equal(projection.runs[0]?.activeAttemptId, projection.attempts[1]?.id);
+  assert.equal(projection.runs[0]?.rootNodeId, projection.attempts[1]?.rootNodeId);
+  assert.isFalse(
+    projection.turnItems.some(
+      (item) => item.type === "run_interrupt_request" || item.type === "run_interrupt_result",
+    ),
+    "steer supersede must not project run_interrupt_* items (those are hard Stop only)",
+  );
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/message_steering/grok_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/message_steering/grok_transcript.ndjson
new file mode 100644
index 000000000000..b50308c07f88
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/message_steering/grok_transcript.ndjson
@@ -0,0 +1,14 @@
+{"type":"transcript_start","provider":"grok","protocol":"acp.ndjson-jsonrpc","version":"1","scenario":"message_steering","metadata":{"generatedBy":"live-grok-shape-probe","nativeSessionId":"grok-replay-session-1"}}
+{"type":"expect_outbound","label":"initialize","frame":{"kind":"request","method":"initialize","params":{"protocolVersion":1,"clientCapabilities":{"fs":{"readTextFile":false,"writeTextFile":false},"terminal":false,"elicitation":{"form":{}}},"clientInfo":{"name":"t3-code","version":"0.0.0"}}}}
+{"type":"emit_inbound","label":"initialized","frame":{"kind":"response","method":"initialize","result":{"protocolVersion":1,"agentCapabilities":{"loadSession":true,"mcpCapabilities":{"http":true,"sse":true},"promptCapabilities":{"audio":false,"embeddedContext":true,"image":false}},"authMethods":[{"id":"replay","name":"Replay"}],"agentInfo":{"name":"grok-replay","version":"1"}}}}
+{"type":"expect_outbound","label":"session.new","frame":{"kind":"request","method":"session/new","params":{"cwd":"<workspace>","mcpServers":"<any>"}}}
+{"type":"emit_inbound","label":"session.created","frame":{"kind":"response","method":"session/new","result":{"sessionId":"grok-replay-session-1","models":{"currentModelId":"grok-build","availableModels":[{"modelId":"grok-build","name":"Grok Build"}]}}}}
+{"type":"expect_outbound","label":"session.prompt.1","frame":{"kind":"request","method":"session/prompt","params":{"sessionId":"grok-replay-session-1","prompt":[{"type":"text","text":"Respond with exactly: steering fixture initial response"}]}}}
+{"type":"emit_inbound","label":"assistant.partial","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"grok-replay-session-1","update":{"sessionUpdate":"agent_message_chunk","content":{"type":"text","text":"ste"}}}}}
+{"type":"expect_outbound","label":"session.cancel","frame":{"kind":"notification","method":"session/cancel","params":{"sessionId":"grok-replay-session-1"}}}
+{"type":"emit_inbound","label":"prompt.cancelled","frame":{"kind":"response","method":"session/prompt","result":{"stopReason":"cancelled"}}}
+{"type":"expect_outbound","label":"session.prompt.2","frame":{"kind":"request","method":"session/prompt","params":{"sessionId":"grok-replay-session-1","prompt":[{"type":"text","text":"Actually, respond with exactly: steering fixture observed"}]}}}
+{"type":"emit_inbound","label":"assistant.1","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"grok-replay-session-1","update":{"sessionUpdate":"agent_message_chunk","content":{"type":"text","text":"steering fixture "}}}}}
+{"type":"emit_inbound","label":"assistant.2","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"grok-replay-session-1","update":{"sessionUpdate":"agent_message_chunk","content":{"type":"text","text":"observed"}}}}}
+{"type":"emit_inbound","label":"prompt.completed","frame":{"kind":"response","method":"session/prompt","result":{"stopReason":"end_turn"}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/message_steering/input.ts b/apps/server/src/orchestration-v2/testkit/fixtures/message_steering/input.ts
new file mode 100644
index 000000000000..185d2726143c
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/message_steering/input.ts
@@ -0,0 +1,31 @@
+import {
+  MESSAGE_STEERING_INITIAL_PROMPT,
+  MESSAGE_STEERING_STEER_PROMPT,
+  type OrchestratorFixtureInput,
+} from "../shared.ts";
+
+export function messageSteeringInput(): OrchestratorFixtureInput {
+  return {
+    steps: [
+      { type: "message", text: MESSAGE_STEERING_INITIAL_PROMPT },
+      {
+        type: "steer",
+        text: MESSAGE_STEERING_STEER_PROMPT,
+        targetRunIndex: 1,
+      },
+    ],
+  };
+}
+
+export function messageRestartInput(): OrchestratorFixtureInput {
+  return {
+    steps: [
+      { type: "message", text: MESSAGE_STEERING_INITIAL_PROMPT },
+      {
+        type: "restart",
+        text: MESSAGE_STEERING_STEER_PROMPT,
+        targetRunIndex: 1,
+      },
+    ],
+  };
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/multi_turn/claude_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/multi_turn/claude_output.ts
new file mode 100644
index 000000000000..0c1c374c1912
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/multi_turn/claude_output.ts
@@ -0,0 +1,53 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import { assertMultiTurnOutput } from "./codex_output.ts";
+import { projectionFor } from "../shared.ts";
+
+function isReplayFrameWithType(
+  frame: unknown,
+  type: string,
+): frame is { readonly type: string; readonly options?: Record<string, unknown> } {
+  return (
+    typeof frame === "object" &&
+    frame !== null &&
+    "type" in frame &&
+    (frame as { readonly type?: unknown }).type === type
+  );
+}
+
+export function assertMultiTurnClaudeOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertMultiTurnOutput(result, transcript);
+
+  const projection = projectionFor(result, transcript.scenario);
+  assert.lengthOf(projection.providerThreads, 1);
+  const providerThread = projection.providerThreads[0];
+  assert.isDefined(providerThread);
+  assert.isNotNull(providerThread.nativeThreadRef);
+  assert.deepEqual(
+    projection.runs.map((run) => run.providerThreadId),
+    projection.runs.map(() => providerThread.id),
+  );
+
+  const outboundFrames = transcript.entries.flatMap((entry) =>
+    entry.type === "expect_outbound" ? [entry.frame] : [],
+  );
+  const queryOpenFrames = outboundFrames.filter((frame) =>
+    isReplayFrameWithType(frame, "query.open"),
+  );
+  const promptOfferFrames = outboundFrames.filter((frame) =>
+    isReplayFrameWithType(frame, "prompt.offer"),
+  );
+
+  assert.lengthOf(promptOfferFrames, 2);
+  if (transcript.scenario === "multi_turn_restart") {
+    assert.lengthOf(queryOpenFrames, 2);
+    assert.isString(queryOpenFrames[1]?.options?.resume);
+  } else {
+    assert.lengthOf(queryOpenFrames, 1);
+  }
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/multi_turn/claude_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/multi_turn/claude_transcript.ndjson
new file mode 100644
index 000000000000..d905455eeba2
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/multi_turn/claude_transcript.ndjson
@@ -0,0 +1,14 @@
+{"type":"transcript_start","provider":"claudeAgent","protocol":"claude-agent-sdk.query","version":"0.2.111","scenario":"multi_turn","metadata":{"prompts":["Respond with exactly: first fixture turn complete","Respond with exactly: second fixture turn complete"],"model":"claude-sonnet-4-6","nativeSessionId":"01899f29-45f7-43c3-b963-0f9181ed013f","queryMode":"streaming","tools":"claude_code","permissionMode":"bypassPermissions","generatedBy":"recordClaudeAgentSdkReplayTranscript"}}
+{"type":"expect_outbound","label":"query.open","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"sessionId":"01899f29-45f7-43c3-b963-0f9181ed013f"}}}
+{"type":"expect_outbound","label":"prompt.offer:1","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Respond with exactly: first fixture turn complete"},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"a8f3420b-6e02-4f06-8b20-139030128614","hook_name":"SessionStart:startup","hook_event":"SessionStart","uuid":"91827846-9643-43f7-802a-7622a4d59945","session_id":"01899f29-45f7-43c3-b963-0f9181ed013f"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"a8f3420b-6e02-4f06-8b20-139030128614","hook_name":"SessionStart:startup","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"3f1f1a2b-1ddb-4e07-8f62-d3e2020a1bf0","session_id":"01899f29-45f7-43c3-b963-0f9181ed013f"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.111","cwd":"/tmp/claude-replay-multi_turn","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"dbef42fe-0daa-40e2-8b4a-b8fbf39191bc","session_id":"01899f29-45f7-43c3-b963-0f9181ed013f"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_018QDgm81Jgo5XonK3Bm8dEc","type":"message","role":"assistant","content":[{"type":"text","text":"first fixture turn complete"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":2337,"cache_read_input_tokens":9455,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2337},"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"01899f29-45f7-43c3-b963-0f9181ed013f","uuid":"d513887e-fb2d-47a1-adbb-e8678b42ad9a"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed"},"uuid":"53a27a3d-676a-4781-9c94-abe4a8af8fdd","session_id":"01899f29-45f7-43c3-b963-0f9181ed013f"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":1877,"duration_api_ms":1400,"num_turns":1,"result":"first fixture turn complete","stop_reason":"end_turn","session_id":"01899f29-45f7-43c3-b963-0f9181ed013f","total_cost_usd":0.01171425,"usage":{"input_tokens":3,"cache_creation_input_tokens":2337,"cache_read_input_tokens":9455,"output_tokens":7,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":2337,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[{"input_tokens":3,"output_tokens":7,"cache_read_input_tokens":9455,"cache_creation_input_tokens":2337,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2337},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":3,"outputTokens":7,"cacheReadInputTokens":9455,"cacheCreationInputTokens":2337,"webSearchRequests":0,"costUSD":0.01171425,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"bd7da0d2-bc9e-42db-841e-4285de52d9a2"}}
+{"type":"expect_outbound","label":"prompt.offer:2","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Respond with exactly: second fixture turn complete"},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.111","cwd":"/tmp/claude-replay-multi_turn","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"09aafcb5-80e8-465c-b99f-14185f9e737d","session_id":"01899f29-45f7-43c3-b963-0f9181ed013f"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01PifXzuLoccLsnMjRC9hXJ8","type":"message","role":"assistant","content":[{"type":"text","text":"second fixture turn complete"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":19,"cache_read_input_tokens":11792,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":19},"output_tokens":7,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"01899f29-45f7-43c3-b963-0f9181ed013f","uuid":"8553017b-6ade-4de7-913a-0beacfd3728c"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":1415,"duration_api_ms":2278,"num_turns":1,"result":"second fixture turn complete","stop_reason":"end_turn","session_id":"01899f29-45f7-43c3-b963-0f9181ed013f","total_cost_usd":0.0154371,"usage":{"input_tokens":3,"cache_creation_input_tokens":19,"cache_read_input_tokens":11792,"output_tokens":7,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":19,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[{"input_tokens":3,"output_tokens":7,"cache_read_input_tokens":11792,"cache_creation_input_tokens":19,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":19},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":6,"outputTokens":14,"cacheReadInputTokens":21247,"cacheCreationInputTokens":2356,"webSearchRequests":0,"costUSD":0.0154371,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"f57bf2b0-a6e3-4701-9898-cd3be185a5d0"}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/multi_turn/codex_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/multi_turn/codex_output.ts
new file mode 100644
index 000000000000..82bda348d381
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/multi_turn/codex_output.ts
@@ -0,0 +1,40 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertAssistantTextIncludes,
+  assertBaseProjection,
+  assertConversationMessageRoles,
+  assertRunOrdinals,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessagesInclude,
+  assertVisibleTurnItemsMirrorLocalTurnItems,
+  MULTI_TURN_FIRST_PROMPT,
+  MULTI_TURN_SECOND_PROMPT,
+  projectionFor,
+} from "../shared.ts";
+
+export function assertMultiTurnOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({
+    result,
+    transcript,
+    runCount: 2,
+    runStatuses: ["completed", "completed"],
+  });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertVisibleTurnItemsMirrorLocalTurnItems(projection);
+  assertRunOrdinals(projection, [1, 2]);
+  assertConversationMessageRoles(projection, ["user", "assistant", "user", "assistant"]);
+  assertTurnItemTypes(projection, ["user_message", "assistant_message"]);
+  assertUserMessagesInclude(projection, [MULTI_TURN_FIRST_PROMPT, MULTI_TURN_SECOND_PROMPT]);
+  assert.equal(projection.turnItems.filter((item) => item.type === "user_message").length, 2);
+  assertAssistantTextIncludes(projection, "first fixture turn complete");
+  assertAssistantTextIncludes(projection, "second fixture turn complete");
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/multi_turn/codex_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/multi_turn/codex_transcript.ndjson
new file mode 100644
index 000000000000..7501e0b07e84
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/multi_turn/codex_transcript.ndjson
@@ -0,0 +1,52 @@
+{"type":"transcript_start","provider":"codex","protocol":"codex.app-server","version":"0.120.0","scenario":"multi_turn","metadata":{"source":"codex-app-server-probe","fileName":"multi_turn.ndjson","description":"One thread with two sequential user turns."}}
+{"type":"expect_outbound","label":"initialize","frame":{"id":1,"method":"initialize","params":{"capabilities":{"experimentalApi":true},"clientInfo":{"name":"t3code_desktop","title":"T3 Code Desktop","version":"0.1.0"}}}}
+{"type":"emit_inbound","label":"initialize","frame":{"id":1,"result":{"userAgent":"t3code_desktop/0.120.0 (Mac OS 26.4.1; arm64) dumb (t3code_desktop; 0.1.0)","codexHome":"/Users/julius/.codex","platformFamily":"unix","platformOs":"macos"}}}
+{"type":"expect_outbound","label":"initialized","frame":{"method":"initialized"}}
+{"type":"expect_outbound","label":"thread/start","frame":{"id":2,"method":"thread/start","params":{}}}
+{"type":"emit_inbound","label":"thread/start","frame":{"id":2,"result":{"thread":{"id":"019dadec-c14b-7b13-b96c-92c98ccfc342","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1776739467,"updatedAt":1776739467,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/04/20/rollout-2026-04-20T19-44-27-019dadec-c14b-7b13-b96c-92c98ccfc342.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","cliVersion":"0.120.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]},"model":"gpt-5.4","modelProvider":"openai","serviceTier":"fast","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","approvalPolicy":"on-request","approvalsReviewer":"user","sandbox":{"type":"workspaceWrite","writableRoots":["/Users/julius/.codex/memories"],"readOnlyAccess":{"type":"fullAccess"},"networkAccess":false,"excludeTmpdirEnvVar":false,"excludeSlashTmp":false},"reasoningEffort":"xhigh"}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":3,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Respond with exactly: first fixture turn complete","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"type":"dangerFullAccess"},"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"thread/started","frame":{"method":"thread/started","params":{"thread":{"id":"019dadec-c14b-7b13-b96c-92c98ccfc342","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1776739467,"updatedAt":1776739467,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/04/20/rollout-2026-04-20T19-44-27-019dadec-c14b-7b13-b96c-92c98ccfc342.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","cliVersion":"0.120.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]}}}}
+{"type":"emit_inbound","label":"deprecationNotice","frame":{"method":"deprecationNotice","params":{"summary":"`[features].collab` is deprecated. Use `[features].multi_agent` instead.","details":"Enable it with `--enable multi_agent` or `[features].multi_agent` in config.toml. See https://developers.openai.com/codex/config-basic#feature-flags for details."}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":3,"result":{"turn":{"id":"019dadec-c155-74a2-8acc-f9f4ff86c15b","items":[],"status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turn":{"id":"019dadec-c155-74a2-8acc-f9f4ff86c15b","items":[],"status":"inProgress","error":null,"startedAt":1776739467,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"2562fa0b-0d7c-4030-9be5-ece4962d27bd","content":[{"type":"text","text":"Respond with exactly: first fixture turn complete","text_elements":[]}]},"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-c155-74a2-8acc-f9f4ff86c15b"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"2562fa0b-0d7c-4030-9be5-ece4962d27bd","content":[{"type":"text","text":"Respond with exactly: first fixture turn complete","text_elements":[]}]},"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-c155-74a2-8acc-f9f4ff86c15b"}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"reasoning","id":"rs_0110066f30127def0169e6e4920934819996efbb3a16f7bded","summary":[],"content":[]},"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-c155-74a2-8acc-f9f4ff86c15b"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"reasoning","id":"rs_0110066f30127def0169e6e4920934819996efbb3a16f7bded","summary":[],"content":[]},"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-c155-74a2-8acc-f9f4ff86c15b"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_0110066f30127def0169e6e49249948199913f38f859d73ca9","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-c155-74a2-8acc-f9f4ff86c15b"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-c155-74a2-8acc-f9f4ff86c15b","itemId":"msg_0110066f30127def0169e6e49249948199913f38f859d73ca9","delta":"first"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-c155-74a2-8acc-f9f4ff86c15b","itemId":"msg_0110066f30127def0169e6e49249948199913f38f859d73ca9","delta":" fixture"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-c155-74a2-8acc-f9f4ff86c15b","itemId":"msg_0110066f30127def0169e6e49249948199913f38f859d73ca9","delta":" turn"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-c155-74a2-8acc-f9f4ff86c15b","itemId":"msg_0110066f30127def0169e6e49249948199913f38f859d73ca9","delta":" complete"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_0110066f30127def0169e6e49249948199913f38f859d73ca9","text":"first fixture turn complete","phase":"final_answer","memoryCitation":null},"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-c155-74a2-8acc-f9f4ff86c15b"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-c155-74a2-8acc-f9f4ff86c15b","tokenUsage":{"total":{"totalTokens":28248,"inputTokens":28222,"cachedInputTokens":28032,"outputTokens":26,"reasoningOutputTokens":16},"last":{"totalTokens":28248,"inputTokens":28222,"cachedInputTokens":28032,"outputTokens":26,"reasoningOutputTokens":16},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turn":{"id":"019dadec-c155-74a2-8acc-f9f4ff86c15b","items":[],"status":"completed","error":null,"startedAt":1776739467,"completedAt":1776739474,"durationMs":6986}}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":4,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Respond with exactly: second fixture turn complete","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"type":"dangerFullAccess"},"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":4,"result":{"turn":{"id":"019dadec-dca0-7df0-9bc1-5a44135d8735","items":[],"status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turn":{"id":"019dadec-dca0-7df0-9bc1-5a44135d8735","items":[],"status":"inProgress","error":null,"startedAt":1776739474,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"0c4bed3e-fdd2-422c-bc28-4d688a5a9289","content":[{"type":"text","text":"Respond with exactly: second fixture turn complete","text_elements":[]}]},"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-dca0-7df0-9bc1-5a44135d8735"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"0c4bed3e-fdd2-422c-bc28-4d688a5a9289","content":[{"type":"text","text":"Respond with exactly: second fixture turn complete","text_elements":[]}]},"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-dca0-7df0-9bc1-5a44135d8735"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-dca0-7df0-9bc1-5a44135d8735","tokenUsage":{"total":{"totalTokens":28248,"inputTokens":28222,"cachedInputTokens":28032,"outputTokens":26,"reasoningOutputTokens":16},"last":{"totalTokens":28248,"inputTokens":28222,"cachedInputTokens":28032,"outputTokens":26,"reasoningOutputTokens":16},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748633},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335433},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"reasoning","id":"rs_0110066f30127def0169e6e495c82481998e6c7e0925c86cfa","summary":[],"content":[]},"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-dca0-7df0-9bc1-5a44135d8735"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"reasoning","id":"rs_0110066f30127def0169e6e495c82481998e6c7e0925c86cfa","summary":[],"content":[]},"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-dca0-7df0-9bc1-5a44135d8735"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_0110066f30127def0169e6e495f6088199b4c7aad5e1b7d0aa","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-dca0-7df0-9bc1-5a44135d8735"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-dca0-7df0-9bc1-5a44135d8735","itemId":"msg_0110066f30127def0169e6e495f6088199b4c7aad5e1b7d0aa","delta":"second"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-dca0-7df0-9bc1-5a44135d8735","itemId":"msg_0110066f30127def0169e6e495f6088199b4c7aad5e1b7d0aa","delta":" fixture"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-dca0-7df0-9bc1-5a44135d8735","itemId":"msg_0110066f30127def0169e6e495f6088199b4c7aad5e1b7d0aa","delta":" turn"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-dca0-7df0-9bc1-5a44135d8735","itemId":"msg_0110066f30127def0169e6e495f6088199b4c7aad5e1b7d0aa","delta":" complete"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_0110066f30127def0169e6e495f6088199b4c7aad5e1b7d0aa","text":"second fixture turn complete","phase":"final_answer","memoryCitation":null},"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-dca0-7df0-9bc1-5a44135d8735"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-dca0-7df0-9bc1-5a44135d8735","tokenUsage":{"total":{"totalTokens":56514,"inputTokens":56466,"cachedInputTokens":56064,"outputTokens":48,"reasoningOutputTokens":28},"last":{"totalTokens":28266,"inputTokens":28244,"cachedInputTokens":28032,"outputTokens":22,"reasoningOutputTokens":12},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748633},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335433},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turn":{"id":"019dadec-dca0-7df0-9bc1-5a44135d8735","items":[],"status":"completed","error":null,"startedAt":1776739474,"completedAt":1776739478,"durationMs":3700}}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/multi_turn/cursor_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/multi_turn/cursor_transcript.ndjson
new file mode 100644
index 000000000000..c7c450e7b293
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/multi_turn/cursor_transcript.ndjson
@@ -0,0 +1,30 @@
+{"type":"transcript_start","provider":"cursor","protocol":"cursor-agent-sdk.local","version":"1","scenario":"multi_turn","metadata":{"generatedBy":"recordCursorAgentSdkReplayTranscript","nativeAgentId":"agent-93ba82d8-7489-48f7-9b93-b9f65f425666"}}
+{"type":"expect_outbound","label":"agent.open","frame":{"type":"agent.open","operation":"create","options":{"model":{"id":"composer-2.5"},"hasName":true,"mode":"agent","local":{"hasCwd":true,"autoReview":false,"sandboxEnabled":false,"enableAgentRetries":true}}}}
+{"type":"emit_inbound","label":"agent.opened","frame":{"type":"agent.opened","agentId":"agent-93ba82d8-7489-48f7-9b93-b9f65f425666"}}
+{"type":"expect_outbound","label":"run.start:1","frame":{"type":"run.start","message":"Respond with exactly: first fixture turn complete","options":{"model":{"id":"composer-2.5"},"mode":"agent"}}}
+{"type":"emit_inbound","label":"run.started:1","frame":{"type":"run.started","runId":"run-e94938bb-f461-4834-b729-c4562b715945","agentId":"agent-93ba82d8-7489-48f7-9b93-b9f65f425666"}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-e94938bb-f461-4834-b729-c4562b715945","update":{"type":"text-delta","text":"first"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-e94938bb-f461-4834-b729-c4562b715945","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-e94938bb-f461-4834-b729-c4562b715945","update":{"type":"text-delta","text":" fixture"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-e94938bb-f461-4834-b729-c4562b715945","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-e94938bb-f461-4834-b729-c4562b715945","update":{"type":"text-delta","text":" turn"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-e94938bb-f461-4834-b729-c4562b715945","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-e94938bb-f461-4834-b729-c4562b715945","update":{"type":"text-delta","text":" complete"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-e94938bb-f461-4834-b729-c4562b715945","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"step-completed","frame":{"type":"interaction.update","runId":"run-e94938bb-f461-4834-b729-c4562b715945","update":{"type":"step-completed","stepId":1,"stepDurationMs":969}}}
+{"type":"emit_inbound","label":"turn-ended","frame":{"type":"interaction.update","runId":"run-e94938bb-f461-4834-b729-c4562b715945","update":{"type":"turn-ended","usage":{"inputTokens":10403,"outputTokens":38,"cacheReadTokens":7392,"cacheWriteTokens":0}}}}
+{"type":"emit_inbound","label":"run.completed:1","frame":{"type":"run.completed","result":{"id":"run-e94938bb-f461-4834-b729-c4562b715945","requestId":"ef58f76f-ef8f-475e-bff1-568e8aed367c","status":"finished","result":"first fixture turn complete","model":{"id":"composer-2.5"},"durationMs":3891}}}
+{"type":"expect_outbound","label":"run.start:2","frame":{"type":"run.start","message":"Respond with exactly: second fixture turn complete","options":{"model":{"id":"composer-2.5"},"mode":"agent"}}}
+{"type":"emit_inbound","label":"run.started:2","frame":{"type":"run.started","runId":"run-2fefd1d7-40f3-4ffc-bbd3-30e709a85935","agentId":"agent-93ba82d8-7489-48f7-9b93-b9f65f425666"}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-2fefd1d7-40f3-4ffc-bbd3-30e709a85935","update":{"type":"text-delta","text":"second"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-2fefd1d7-40f3-4ffc-bbd3-30e709a85935","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-2fefd1d7-40f3-4ffc-bbd3-30e709a85935","update":{"type":"text-delta","text":" fixture"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-2fefd1d7-40f3-4ffc-bbd3-30e709a85935","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-2fefd1d7-40f3-4ffc-bbd3-30e709a85935","update":{"type":"text-delta","text":" turn"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-2fefd1d7-40f3-4ffc-bbd3-30e709a85935","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-2fefd1d7-40f3-4ffc-bbd3-30e709a85935","update":{"type":"text-delta","text":" complete"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-2fefd1d7-40f3-4ffc-bbd3-30e709a85935","update":{"type":"token-delta","tokens":3}}}
+{"type":"emit_inbound","label":"step-completed","frame":{"type":"interaction.update","runId":"run-2fefd1d7-40f3-4ffc-bbd3-30e709a85935","update":{"type":"step-completed","stepId":1,"stepDurationMs":816}}}
+{"type":"emit_inbound","label":"turn-ended","frame":{"type":"interaction.update","runId":"run-2fefd1d7-40f3-4ffc-bbd3-30e709a85935","update":{"type":"turn-ended","usage":{"inputTokens":10461,"outputTokens":28,"cacheReadTokens":10402,"cacheWriteTokens":0}}}}
+{"type":"emit_inbound","label":"run.completed:2","frame":{"type":"run.completed","result":{"id":"run-2fefd1d7-40f3-4ffc-bbd3-30e709a85935","requestId":"94d9bed1-7b67-4093-ac41-64a43014290e","status":"finished","result":"second fixture turn complete","model":{"id":"composer-2.5"},"durationMs":1727}}}
+{"type":"expect_outbound","label":"agent.close","frame":{"type":"agent.close","agentId":"agent-93ba82d8-7489-48f7-9b93-b9f65f425666"}}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/multi_turn/grok_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/multi_turn/grok_transcript.ndjson
new file mode 100644
index 000000000000..541d21f79c16
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/multi_turn/grok_transcript.ndjson
@@ -0,0 +1,12 @@
+{"type":"transcript_start","provider":"grok","protocol":"acp.ndjson-jsonrpc","version":"1","scenario":"multi_turn","metadata":{"generatedBy":"protocol-semantic-fixture","nativeSessionId":"grok-replay-session-1"}}
+{"type":"expect_outbound","label":"initialize","frame":{"kind":"request","method":"initialize","params":{"protocolVersion":1,"clientCapabilities":{"fs":{"readTextFile":false,"writeTextFile":false},"terminal":false,"elicitation":{"form":{}}},"clientInfo":{"name":"t3-code","version":"0.0.0"}}}}
+{"type":"emit_inbound","label":"initialized","frame":{"kind":"response","method":"initialize","result":{"protocolVersion":1,"agentCapabilities":{"loadSession":true,"mcpCapabilities":{"http":true,"sse":true},"promptCapabilities":{"audio":false,"embeddedContext":true,"image":false}},"authMethods":[{"id":"replay","name":"Replay"}],"agentInfo":{"name":"grok-replay","version":"1"}}}}
+{"type":"expect_outbound","label":"session.new","frame":{"kind":"request","method":"session/new","params":{"cwd":"<workspace>","mcpServers":"<any>"}}}
+{"type":"emit_inbound","label":"session.created","frame":{"kind":"response","method":"session/new","result":{"sessionId":"grok-replay-session-1","models":{"currentModelId":"grok-build","availableModels":[{"modelId":"grok-build","name":"Grok Build"}]}}}}
+{"type":"expect_outbound","label":"first.prompt","frame":{"kind":"request","method":"session/prompt","params":{"sessionId":"grok-replay-session-1","prompt":[{"type":"text","text":"Respond with exactly: first fixture turn complete"}]}}}
+{"type":"emit_inbound","label":"first.assistant","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"grok-replay-session-1","update":{"sessionUpdate":"agent_message_chunk","content":{"type":"text","text":"first fixture turn complete"}}}}}
+{"type":"emit_inbound","label":"first.completed","frame":{"kind":"response","method":"session/prompt","result":{"stopReason":"end_turn"}}}
+{"type":"expect_outbound","label":"second.prompt","frame":{"kind":"request","method":"session/prompt","params":{"sessionId":"grok-replay-session-1","prompt":[{"type":"text","text":"Respond with exactly: second fixture turn complete"}]}}}
+{"type":"emit_inbound","label":"second.assistant","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"grok-replay-session-1","update":{"sessionUpdate":"agent_message_chunk","content":{"type":"text","text":"second fixture turn complete"}}}}}
+{"type":"emit_inbound","label":"second.completed","frame":{"kind":"response","method":"session/prompt","result":{"stopReason":"end_turn"}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/multi_turn/input.ts b/apps/server/src/orchestration-v2/testkit/fixtures/multi_turn/input.ts
new file mode 100644
index 000000000000..8646fb6be2ae
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/multi_turn/input.ts
@@ -0,0 +1,14 @@
+import {
+  MULTI_TURN_FIRST_PROMPT,
+  MULTI_TURN_SECOND_PROMPT,
+  type OrchestratorFixtureInput,
+} from "../shared.ts";
+
+export function multiTurnInput(): OrchestratorFixtureInput {
+  return {
+    steps: [
+      { type: "message", text: MULTI_TURN_FIRST_PROMPT },
+      { type: "message", text: MULTI_TURN_SECOND_PROMPT },
+    ],
+  };
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/multi_turn_restart/claude_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/multi_turn_restart/claude_transcript.ndjson
new file mode 100644
index 000000000000..fef5d72c0e3d
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/multi_turn_restart/claude_transcript.ndjson
@@ -0,0 +1,19 @@
+{"type":"transcript_start","provider":"claudeAgent","protocol":"claude-agent-sdk.query","version":"0.2.111","scenario":"multi_turn_restart","metadata":{"prompts":["Respond with exactly: first fixture turn complete","Respond with exactly: second fixture turn complete"],"model":"claude-sonnet-4-6","nativeSessionId":"a9b9a331-6bf3-4753-93dd-b14ff7130f3f","queryMode":"restart","tools":"claude_code","permissionMode":"bypassPermissions","generatedBy":"recordClaudeAgentSdkReplayTranscript"}}
+{"type":"expect_outbound","label":"query.open:1","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"sessionId":"a9b9a331-6bf3-4753-93dd-b14ff7130f3f"}}}
+{"type":"expect_outbound","label":"prompt.offer:1","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Respond with exactly: first fixture turn complete"},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"96353a54-8984-4e77-8060-b1dc6b030cf6","hook_name":"SessionStart:startup","hook_event":"SessionStart","uuid":"ffbfcc28-dd82-4c2a-a99f-58e5af6e393e","session_id":"a9b9a331-6bf3-4753-93dd-b14ff7130f3f"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"96353a54-8984-4e77-8060-b1dc6b030cf6","hook_name":"SessionStart:startup","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"bbf29fb9-d4b3-4ab2-b0e3-9d2aa833099c","session_id":"a9b9a331-6bf3-4753-93dd-b14ff7130f3f"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.111","cwd":"/tmp/claude-replay-multi_turn_restart","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"f468f37d-e0e6-43cf-bcd7-71e34045083e","session_id":"a9b9a331-6bf3-4753-93dd-b14ff7130f3f"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01DKpWHtEMhugcX5nJwxKfeM","type":"message","role":"assistant","content":[{"type":"text","text":"first fixture turn complete"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":11792,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"a9b9a331-6bf3-4753-93dd-b14ff7130f3f","uuid":"7e96c9db-0543-4276-b97d-ced7f53b93c4"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed"},"uuid":"28620e49-aa10-42fa-a7f9-768c9c79c093","session_id":"a9b9a331-6bf3-4753-93dd-b14ff7130f3f"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":2809,"duration_api_ms":2523,"num_turns":1,"result":"first fixture turn complete","stop_reason":"end_turn","session_id":"a9b9a331-6bf3-4753-93dd-b14ff7130f3f","total_cost_usd":0.0036516,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":11792,"output_tokens":7,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[{"input_tokens":3,"output_tokens":7,"cache_read_input_tokens":11792,"cache_creation_input_tokens":0,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":3,"outputTokens":7,"cacheReadInputTokens":11792,"cacheCreationInputTokens":0,"webSearchRequests":0,"costUSD":0.0036516,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"d88c31ae-a8fd-4ed4-a168-96cfd3b0edd7"}}
+{"type":"runtime_exit","status":"success"}
+{"type":"expect_outbound","label":"query.open:2","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"resume":"a9b9a331-6bf3-4753-93dd-b14ff7130f3f"}}}
+{"type":"expect_outbound","label":"prompt.offer:2","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Respond with exactly: second fixture turn complete"},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"4db1e61e-de28-49ee-b7ef-c375670d0aae","hook_name":"SessionStart:resume","hook_event":"SessionStart","uuid":"66e900fe-b02e-41a0-ac08-92260125b13d","session_id":"377e06a0-fe46-420e-bfaa-b4b9fcc8b871"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"4db1e61e-de28-49ee-b7ef-c375670d0aae","hook_name":"SessionStart:resume","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"03f2754d-daee-4128-b180-c1a39faa03f0","session_id":"377e06a0-fe46-420e-bfaa-b4b9fcc8b871"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.111","cwd":"/tmp/claude-replay-multi_turn_restart","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"5e1d64c9-a2ca-4ad1-ba2c-546ba18d1785","session_id":"a9b9a331-6bf3-4753-93dd-b14ff7130f3f"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01CiTVsN2HCfqr6Ge166z8hv","type":"message","role":"assistant","content":[{"type":"text","text":"second fixture turn complete"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":11811,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"output_tokens":7,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"a9b9a331-6bf3-4753-93dd-b14ff7130f3f","uuid":"e821cdff-a217-4fb3-b1d0-f89387dbac41"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed"},"uuid":"21e2dfd3-a7f5-48d1-a343-ddb1be3198c8","session_id":"a9b9a331-6bf3-4753-93dd-b14ff7130f3f"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":2103,"duration_api_ms":1644,"num_turns":1,"result":"second fixture turn complete","stop_reason":"end_turn","session_id":"a9b9a331-6bf3-4753-93dd-b14ff7130f3f","total_cost_usd":0.0036573,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":11811,"output_tokens":7,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[{"input_tokens":3,"output_tokens":7,"cache_read_input_tokens":11811,"cache_creation_input_tokens":0,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":3,"outputTokens":7,"cacheReadInputTokens":11811,"cacheCreationInputTokens":0,"webSearchRequests":0,"costUSD":0.0036573,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"a876579c-a18c-4237-ba4e-6105b2162bbb"}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/opencode_child_approval/input.ts b/apps/server/src/orchestration-v2/testkit/fixtures/opencode_child_approval/input.ts
new file mode 100644
index 000000000000..666ff8b01433
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/opencode_child_approval/input.ts
@@ -0,0 +1,10 @@
+import { OPENCODE_SUBAGENT_PROMPT, type OrchestratorFixtureInput } from "../shared.ts";
+
+export function openCodeChildApprovalInput(): OrchestratorFixtureInput {
+  return {
+    steps: [
+      { type: "message", text: OPENCODE_SUBAGENT_PROMPT },
+      { type: "approve_next_runtime_request" },
+    ],
+  };
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/opencode_child_approval/opencode_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/opencode_child_approval/opencode_transcript.ndjson
new file mode 100644
index 000000000000..e578e0ad5055
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/opencode_child_approval/opencode_transcript.ndjson
@@ -0,0 +1,36 @@
+{"type": "transcript_start", "provider": "opencode", "protocol": "opencode-sdk.sse", "version": "1.14.39", "scenario": "opencode_child_approval", "metadata": {"source": "hand-authored from the opencode_subagent capture", "capturedAt": "2026-06-18", "nativeSessionId": "ses_1235df8f8ffekByXP7gVnnXA3P", "nativeChildSessionId": "ses_1235debc9ffe9MNk00UheV2j0q", "model": "openai/gpt-5.4-mini", "description": "OpenCode task delegation where the child session asks for a bash permission BEFORE the task part reveals the child relation. The adapter must resolve the owner via session.get, surface the approval on the root turn, and route the reply."}}
+{"type": "expect_outbound", "label": "event.subscribe", "frame": {"type": "event.subscribe"}}
+{"type": "expect_outbound", "label": "session.create", "frame": {"type": "session.create", "input": {"title": "<any>", "permission": "<any>"}}}
+{"type": "emit_inbound", "label": "session.created", "frame": {"type": "sdk.response", "operation": "session.create", "data": {"id": "ses_1235df8f8ffekByXP7gVnnXA3P", "slug": "kind-tiger", "version": "1.14.39", "projectID": "global", "directory": "/private/tmp/t3-opencode-probe", "path": "private/tmp/t3-opencode-probe", "title": "T3 OpenCode v2 probe", "time": {"created": 1781818066695, "updated": 1781818066695}}}}
+{"type": "expect_outbound", "label": "session.promptAsync", "frame": {"type": "session.promptAsync", "input": {"sessionID": "ses_1235df8f8ffekByXP7gVnnXA3P", "model": {"providerID": "openai", "modelID": "gpt-5.4-mini"}, "agent": "build", "parts": [{"type": "text", "text": "Use the task tool exactly once. Delegate to the general subagent with this prompt: Respond exactly CHILD_OK. After the task completes, respond exactly PARENT_OK."}]}}}
+{"type": "emit_inbound", "label": "session.promptAsync.response", "frame": {"type": "sdk.response", "operation": "session.promptAsync", "data": null}}
+{"type": "emit_inbound", "label": "root.user", "frame": {"type": "sdk.event", "event": {"id": "evt_edca20735003a32yj1UtyUpHkU", "type": "message.updated", "properties": {"sessionID": "ses_1235df8f8ffekByXP7gVnnXA3P", "info": {"id": "msg_edca20735001Esh39V762TEx7f", "role": "user", "sessionID": "ses_1235df8f8ffekByXP7gVnnXA3P", "time": {"created": 1781818066741}, "agent": "build", "model": {"providerID": "openai", "modelID": "gpt-5.4-mini"}}}}}}
+{"type": "emit_inbound", "label": "root.user.text", "frame": {"type": "sdk.event", "event": {"id": "evt_edca207360015UIWeYXmKllHo3", "type": "message.part.updated", "properties": {"sessionID": "ses_1235df8f8ffekByXP7gVnnXA3P", "part": {"type": "text", "text": "Use the task tool exactly once. Delegate to the general subagent with this prompt: Respond exactly CHILD_OK. After the task completes, respond exactly PARENT_OK.", "messageID": "msg_edca20735001Esh39V762TEx7f", "sessionID": "ses_1235df8f8ffekByXP7gVnnXA3P", "id": "prt_edca20735002U603TIFRMOYd9M"}, "time": 1781818066742}}}}
+{"type": "emit_inbound", "label": "root.busy", "frame": {"type": "sdk.event", "event": {"id": "evt_edca207370013ecC1B3n7HWHF0", "type": "session.status", "properties": {"sessionID": "ses_1235df8f8ffekByXP7gVnnXA3P", "status": {"type": "busy"}}}}}
+{"type": "emit_inbound", "label": "root.assistant.tool-step", "frame": {"type": "sdk.event", "event": {"id": "evt_edca207380024rQ5C0LdF5jkgv", "type": "message.updated", "properties": {"sessionID": "ses_1235df8f8ffekByXP7gVnnXA3P", "info": {"id": "msg_edca20738001L0AkDDqxC8ipdK", "parentID": "msg_edca20735001Esh39V762TEx7f", "role": "assistant", "mode": "build", "agent": "build", "path": {"cwd": "/private/tmp/t3-opencode-probe", "root": "/"}, "cost": 0, "tokens": {"input": 0, "output": 0, "reasoning": 0, "cache": {"read": 0, "write": 0}}, "modelID": "gpt-5.4-mini", "providerID": "openai", "time": {"created": 1781818066744}, "sessionID": "ses_1235df8f8ffekByXP7gVnnXA3P"}}}}}
+{"type": "emit_inbound", "label": "child.permission.asked", "frame": {"type": "sdk.event", "event": {"id": "evt_childperm0001", "type": "permission.asked", "properties": {"id": "perm_childbash0001", "sessionID": "ses_1235debc9ffe9MNk00UheV2j0q", "permission": "bash", "patterns": ["git status"], "metadata": {}, "always": ["bash"], "tool": {"messageID": "msg_childtool0001", "callID": "call_childbash0001"}}}}}
+{"type": "expect_outbound", "label": "session.get.request-owner", "frame": {"type": "session.get", "input": {"sessionID": "ses_1235debc9ffe9MNk00UheV2j0q"}}}
+{"type": "emit_inbound", "label": "session.get.request-owner.response", "frame": {"type": "sdk.response", "operation": "session.get", "data": {"id": "ses_1235debc9ffe9MNk00UheV2j0q", "slug": "tidy-engine", "projectID": "global", "directory": "/private/tmp/t3-opencode-probe", "path": "private/tmp/t3-opencode-probe", "parentID": "ses_1235df8f8ffekByXP7gVnnXA3P", "title": "Return CHILD_OK (@general subagent)", "version": "1.14.39", "permission": [{"permission": "task", "action": "deny", "pattern": "*"}], "time": {"created": 1781818070070, "updated": 1781818070072}}}}
+{"type": "expect_outbound", "label": "permission.reply", "frame": {"type": "permission.reply", "input": {"requestID": "perm_childbash0001", "reply": "once"}}}
+{"type": "emit_inbound", "label": "permission.reply.response", "frame": {"type": "sdk.response", "operation": "permission.reply", "data": true}}
+{"type": "emit_inbound", "label": "child.permission.replied", "frame": {"type": "sdk.event", "event": {"id": "evt_childperm0002", "type": "permission.replied", "properties": {"sessionID": "ses_1235debc9ffe9MNk00UheV2j0q", "requestID": "perm_childbash0001", "reply": "once"}}}}
+{"type": "emit_inbound", "label": "task.pending", "frame": {"type": "sdk.event", "event": {"id": "evt_edca213fb002A7172u3WxPY2Jy", "type": "message.part.updated", "properties": {"sessionID": "ses_1235df8f8ffekByXP7gVnnXA3P", "part": {"id": "prt_edca213fb001pDRIA33EBmsHOT", "messageID": "msg_edca20738001L0AkDDqxC8ipdK", "sessionID": "ses_1235df8f8ffekByXP7gVnnXA3P", "type": "tool", "tool": "task", "callID": "call_MMPbMUvLDj12T5aimkDZC8Sl", "state": {"status": "pending", "input": {}, "raw": ""}}, "time": 1781818070011}}}}
+{"type": "emit_inbound", "label": "task.running", "frame": {"type": "sdk.event", "event": {"id": "evt_edca21438001pcNOWgyXdKFyaI", "type": "message.part.updated", "properties": {"sessionID": "ses_1235df8f8ffekByXP7gVnnXA3P", "part": {"type": "tool", "tool": "task", "callID": "call_MMPbMUvLDj12T5aimkDZC8Sl", "state": {"title": "Return CHILD_OK", "metadata": {"sessionId": "ses_1235debc9ffe9MNk00UheV2j0q", "model": {"modelID": "gpt-5.4-mini", "providerID": "openai"}}, "status": "running", "input": {"description": "Return CHILD_OK", "prompt": "Respond exactly CHILD_OK.", "subagent_type": "general", "task_id": "", "command": "delegate exact response"}, "time": {"start": 1781818070072}}, "id": "prt_edca213fb001pDRIA33EBmsHOT", "sessionID": "ses_1235df8f8ffekByXP7gVnnXA3P", "messageID": "msg_edca20738001L0AkDDqxC8ipdK"}, "time": 1781818070072}}}}
+{"type": "expect_outbound", "label": "session.get.child-policy", "frame": {"type": "session.get", "input": {"sessionID": "ses_1235debc9ffe9MNk00UheV2j0q"}}}
+{"type": "emit_inbound", "label": "session.get.child-policy.response", "frame": {"type": "sdk.response", "operation": "session.get", "data": {"id": "ses_1235debc9ffe9MNk00UheV2j0q", "slug": "tidy-engine", "projectID": "global", "directory": "/private/tmp/t3-opencode-probe", "path": "private/tmp/t3-opencode-probe", "parentID": "ses_1235df8f8ffekByXP7gVnnXA3P", "title": "Return CHILD_OK (@general subagent)", "version": "1.14.39", "permission": [{"permission": "task", "action": "deny", "pattern": "*"}], "time": {"created": 1781818070070, "updated": 1781818070072}}}}
+{"type": "expect_outbound", "label": "session.update.child-policy", "frame": {"type": "session.update", "input": {"sessionID": "ses_1235debc9ffe9MNk00UheV2j0q", "permission": "<any>"}}}
+{"type": "emit_inbound", "label": "session.update.child-policy.response", "frame": {"type": "sdk.response", "operation": "session.update", "data": {"id": "ses_1235debc9ffe9MNk00UheV2j0q", "permission": [{"permission": "*", "pattern": "*", "action": "allow"}, {"permission": "task", "pattern": "*", "action": "deny"}]}}}
+{"type": "emit_inbound", "label": "child.user", "frame": {"type": "sdk.event", "event": {"id": "evt_edca21439002NEQt3QTkDp4ENI", "type": "message.updated", "properties": {"sessionID": "ses_1235debc9ffe9MNk00UheV2j0q", "info": {"id": "msg_edca21438002r6NiMUSoqNKyyO", "role": "user", "sessionID": "ses_1235debc9ffe9MNk00UheV2j0q", "time": {"created": 1781818070073}, "tools": {"task": false}, "agent": "general", "model": {"providerID": "openai", "modelID": "gpt-5.4-mini"}}}}}}
+{"type": "emit_inbound", "label": "child.user.text", "frame": {"type": "sdk.event", "event": {"id": "evt_edca21439003pseKePjnoGiTMW", "type": "message.part.updated", "properties": {"sessionID": "ses_1235debc9ffe9MNk00UheV2j0q", "part": {"type": "text", "text": "Respond exactly CHILD_OK.", "messageID": "msg_edca21438002r6NiMUSoqNKyyO", "sessionID": "ses_1235debc9ffe9MNk00UheV2j0q", "id": "prt_edca214390014Naiz0G5HjlDbr"}, "time": 1781818070073}}}}
+{"type": "emit_inbound", "label": "child.busy", "frame": {"type": "sdk.event", "event": {"id": "evt_edca2143c0013lzfo6Odo5FMzE", "type": "session.status", "properties": {"sessionID": "ses_1235debc9ffe9MNk00UheV2j0q", "status": {"type": "busy"}}}}}
+{"type": "emit_inbound", "label": "child.assistant", "frame": {"type": "sdk.event", "event": {"id": "evt_edca2143c0033666Mhyl3cAlhK", "type": "message.updated", "properties": {"sessionID": "ses_1235debc9ffe9MNk00UheV2j0q", "info": {"id": "msg_edca2143c002Eu46Ey4Vg2BbuM", "parentID": "msg_edca21438002r6NiMUSoqNKyyO", "role": "assistant", "mode": "general", "agent": "general", "path": {"cwd": "/private/tmp/t3-opencode-probe", "root": "/"}, "cost": 0, "tokens": {"input": 0, "output": 0, "reasoning": 0, "cache": {"read": 0, "write": 0}}, "modelID": "gpt-5.4-mini", "providerID": "openai", "time": {"created": 1781818070076}, "sessionID": "ses_1235debc9ffe9MNk00UheV2j0q"}}}}}
+{"type": "emit_inbound", "label": "child.assistant.text", "frame": {"type": "sdk.event", "event": {"id": "evt_edca21a3f001VbjReH1JvfruIc", "type": "message.part.updated", "properties": {"sessionID": "ses_1235debc9ffe9MNk00UheV2j0q", "part": {"id": "prt_edca21a22001xAMVOfMPeu3Pe5", "messageID": "msg_edca2143c002Eu46Ey4Vg2BbuM", "sessionID": "ses_1235debc9ffe9MNk00UheV2j0q", "type": "text", "text": "CHILD_OK", "time": {"start": 1781818071586, "end": 1781818071615}, "metadata": {"openai": {"itemId": "msg_08dabd7d4c704130016a3462d793f48196a3764bab4f871b8d", "phase": "final_answer"}}}, "time": 1781818071615}}}}
+{"type": "emit_inbound", "label": "child.assistant.completed", "frame": {"type": "sdk.event", "event": {"id": "evt_edca21a5d001RVnmfbE88crcg3", "type": "message.updated", "properties": {"sessionID": "ses_1235debc9ffe9MNk00UheV2j0q", "info": {"id": "msg_edca2143c002Eu46Ey4Vg2BbuM", "parentID": "msg_edca21438002r6NiMUSoqNKyyO", "role": "assistant", "mode": "general", "agent": "general", "path": {"cwd": "/private/tmp/t3-opencode-probe", "root": "/"}, "cost": 0, "tokens": {"total": 7538, "input": 7515, "output": 9, "reasoning": 14, "cache": {"write": 0, "read": 0}}, "modelID": "gpt-5.4-mini", "providerID": "openai", "time": {"created": 1781818070076, "completed": 1781818071645}, "sessionID": "ses_1235debc9ffe9MNk00UheV2j0q", "finish": "stop"}}}}}
+{"type": "emit_inbound", "label": "child.idle", "frame": {"type": "sdk.event", "event": {"id": "evt_edca21a5d0033WtPpZQdeaACpg", "type": "session.status", "properties": {"sessionID": "ses_1235debc9ffe9MNk00UheV2j0q", "status": {"type": "idle"}}}}}
+{"type": "emit_inbound", "label": "task.completed", "frame": {"type": "sdk.event", "event": {"id": "evt_edca21a5e001nGDHspvGlDIOu3", "type": "message.part.updated", "properties": {"sessionID": "ses_1235df8f8ffekByXP7gVnnXA3P", "part": {"type": "tool", "tool": "task", "callID": "call_MMPbMUvLDj12T5aimkDZC8Sl", "state": {"status": "completed", "input": {"description": "Return CHILD_OK", "prompt": "Respond exactly CHILD_OK.", "subagent_type": "general", "task_id": "", "command": "delegate exact response"}, "output": "task_id: ses_1235debc9ffe9MNk00UheV2j0q (for resuming to continue this task if needed)\n\n<task_result>\nCHILD_OK\n</task_result>", "metadata": {"sessionId": "ses_1235debc9ffe9MNk00UheV2j0q", "model": {"modelID": "gpt-5.4-mini", "providerID": "openai"}, "truncated": false}, "title": "Return CHILD_OK", "time": {"start": 1781818070075, "end": 1781818071646}}, "metadata": {"openai": {"itemId": "fc_0f59e88787b4bf7e016a3462d5f5d08196893b4fa241992c81"}}, "id": "prt_edca213fb001pDRIA33EBmsHOT", "sessionID": "ses_1235df8f8ffekByXP7gVnnXA3P", "messageID": "msg_edca20738001L0AkDDqxC8ipdK"}, "time": 1781818071646}}}}
+{"type": "emit_inbound", "label": "root.assistant.tool-step.completed", "frame": {"type": "sdk.event", "event": {"id": "evt_edca21a5f001I6X2xOrOgrkGi4", "type": "message.updated", "properties": {"sessionID": "ses_1235df8f8ffekByXP7gVnnXA3P", "info": {"id": "msg_edca20738001L0AkDDqxC8ipdK", "parentID": "msg_edca20735001Esh39V762TEx7f", "role": "assistant", "mode": "build", "agent": "build", "path": {"cwd": "/private/tmp/t3-opencode-probe", "root": "/"}, "cost": 0, "tokens": {"total": 10945, "input": 10835, "output": 43, "reasoning": 67, "cache": {"write": 0, "read": 0}}, "modelID": "gpt-5.4-mini", "providerID": "openai", "time": {"created": 1781818066744, "completed": 1781818071647}, "sessionID": "ses_1235df8f8ffekByXP7gVnnXA3P", "finish": "tool-calls"}}}}}
+{"type": "emit_inbound", "label": "root.assistant.final-step", "frame": {"type": "sdk.event", "event": {"id": "evt_edca21a5f004jTKIwlcQchMbZY", "type": "message.updated", "properties": {"sessionID": "ses_1235df8f8ffekByXP7gVnnXA3P", "info": {"id": "msg_edca21a5f003lreMfrQqG0qWIe", "parentID": "msg_edca20735001Esh39V762TEx7f", "role": "assistant", "mode": "build", "agent": "build", "path": {"cwd": "/private/tmp/t3-opencode-probe", "root": "/"}, "cost": 0, "tokens": {"input": 0, "output": 0, "reasoning": 0, "cache": {"read": 0, "write": 0}}, "modelID": "gpt-5.4-mini", "providerID": "openai", "time": {"created": 1781818071647}, "sessionID": "ses_1235df8f8ffekByXP7gVnnXA3P"}}}}}
+{"type": "emit_inbound", "label": "root.assistant.text", "frame": {"type": "sdk.event", "event": {"id": "evt_edca21e36001X0l8t5UPa1gOe3", "type": "message.part.updated", "properties": {"sessionID": "ses_1235df8f8ffekByXP7gVnnXA3P", "part": {"id": "prt_edca21d9e001I40GbbzvlzhQ6Z", "messageID": "msg_edca21a5f003lreMfrQqG0qWIe", "sessionID": "ses_1235df8f8ffekByXP7gVnnXA3P", "type": "text", "text": "PARENT_OK", "time": {"start": 1781818072478, "end": 1781818072630}, "metadata": {"openai": {"itemId": "msg_06e59296cb53fc7c016a3462d879288196aead5e9838c741df", "phase": "final_answer"}}}, "time": 1781818072630}}}}
+{"type": "emit_inbound", "label": "root.assistant.completed", "frame": {"type": "sdk.event", "event": {"id": "evt_edca21e3800181OyYIBTDTTK3r", "type": "message.updated", "properties": {"sessionID": "ses_1235df8f8ffekByXP7gVnnXA3P", "info": {"id": "msg_edca21a5f003lreMfrQqG0qWIe", "parentID": "msg_edca20735001Esh39V762TEx7f", "role": "assistant", "mode": "build", "agent": "build", "path": {"cwd": "/private/tmp/t3-opencode-probe", "root": "/"}, "cost": 0, "tokens": {"total": 11007, "input": 248, "output": 7, "reasoning": 0, "cache": {"write": 0, "read": 10752}}, "modelID": "gpt-5.4-mini", "providerID": "openai", "time": {"created": 1781818071647, "completed": 1781818072632}, "sessionID": "ses_1235df8f8ffekByXP7gVnnXA3P", "finish": "stop"}}}}}
+{"type": "emit_inbound", "label": "root.idle", "frame": {"type": "sdk.event", "event": {"id": "evt_edca21e39001lo71BB2Ym4WFC2", "type": "session.status", "properties": {"sessionID": "ses_1235df8f8ffekByXP7gVnnXA3P", "status": {"type": "idle"}}}}}
+{"type": "runtime_exit", "status": "success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/opencode_child_approval/output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/opencode_child_approval/output.ts
new file mode 100644
index 000000000000..26c753d9204d
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/opencode_child_approval/output.ts
@@ -0,0 +1,43 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertAssistantTextIncludes,
+  assertBaseProjection,
+  assertSemanticProjectionIntegrity,
+  assertUserMessagesInclude,
+  OPENCODE_SUBAGENT_PROMPT,
+  projectionFor,
+} from "../shared.ts";
+
+export function assertOpenCodeChildApprovalOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({ result, transcript, runCount: 1, runStatuses: ["completed"] });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertUserMessagesInclude(projection, [OPENCODE_SUBAGENT_PROMPT]);
+  assertAssistantTextIncludes(projection, "PARENT_OK");
+
+  // The child session's permission ask lands on the ROOT turn as an approval
+  // request instead of being dropped, and the reply resolves it.
+  const approvalItems = projection.turnItems.filter((item) => item.type === "approval_request");
+  assert.lengthOf(approvalItems, 1);
+  const approval = approvalItems[0];
+  assert.isDefined(approval);
+  assert.equal(approval.status, "completed");
+  assert.equal(approval.runId, projection.runs[0]?.id ?? null);
+
+  const requests = projection.runtimeRequests;
+  assert.lengthOf(requests, 1);
+  assert.equal(requests[0]?.kind, "command");
+  assert.equal(requests[0]?.status, "resolved");
+
+  // The delegation itself still completes.
+  assert.lengthOf(projection.subagents, 1);
+  assert.equal(projection.subagents[0]?.status, "completed");
+  assert.include(projection.subagents[0]?.result ?? "", "CHILD_OK");
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/opencode_subagent/input.ts b/apps/server/src/orchestration-v2/testkit/fixtures/opencode_subagent/input.ts
new file mode 100644
index 000000000000..29fdd8910b4d
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/opencode_subagent/input.ts
@@ -0,0 +1,7 @@
+import { OPENCODE_SUBAGENT_PROMPT, type OrchestratorFixtureInput } from "../shared.ts";
+
+export function openCodeSubagentInput(): OrchestratorFixtureInput {
+  return {
+    steps: [{ type: "message", text: OPENCODE_SUBAGENT_PROMPT }],
+  };
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/opencode_subagent/opencode_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/opencode_subagent/opencode_transcript.ndjson
new file mode 100644
index 000000000000..f82517996468
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/opencode_subagent/opencode_transcript.ndjson
@@ -0,0 +1,30 @@
+{"type":"transcript_start","provider":"opencode","protocol":"opencode-sdk.sse","version":"1.14.39","scenario":"opencode_subagent","metadata":{"source":"authenticated-opencode-sdk-probe","capturedAt":"2026-06-18","nativeSessionId":"ses_1235df8f8ffekByXP7gVnnXA3P","nativeChildSessionId":"ses_1235debc9ffe9MNk00UheV2j0q","model":"openai/gpt-5.4-mini","description":"One real OpenCode task-tool delegation. The session.update boundary records the adapter policy propagation required before projecting buffered child events."}}
+{"type":"expect_outbound","label":"event.subscribe","frame":{"type":"event.subscribe"}}
+{"type":"expect_outbound","label":"session.create","frame":{"type":"session.create","input":{"title":"<any>","permission":"<any>"}}}
+{"type":"emit_inbound","label":"session.created","frame":{"type":"sdk.response","operation":"session.create","data":{"id":"ses_1235df8f8ffekByXP7gVnnXA3P","slug":"kind-tiger","version":"1.14.39","projectID":"global","directory":"/private/tmp/t3-opencode-probe","path":"private/tmp/t3-opencode-probe","title":"T3 OpenCode v2 probe","time":{"created":1781818066695,"updated":1781818066695}}}}
+{"type":"expect_outbound","label":"session.promptAsync","frame":{"type":"session.promptAsync","input":{"sessionID":"ses_1235df8f8ffekByXP7gVnnXA3P","model":{"providerID":"openai","modelID":"gpt-5.4-mini"},"agent":"build","parts":[{"type":"text","text":"Use the task tool exactly once. Delegate to the general subagent with this prompt: Respond exactly CHILD_OK. After the task completes, respond exactly PARENT_OK."}]}}}
+{"type":"emit_inbound","label":"session.promptAsync.response","frame":{"type":"sdk.response","operation":"session.promptAsync","data":null}}
+{"type":"emit_inbound","label":"root.user","frame":{"type":"sdk.event","event":{"id":"evt_edca20735003a32yj1UtyUpHkU","type":"message.updated","properties":{"sessionID":"ses_1235df8f8ffekByXP7gVnnXA3P","info":{"id":"msg_edca20735001Esh39V762TEx7f","role":"user","sessionID":"ses_1235df8f8ffekByXP7gVnnXA3P","time":{"created":1781818066741},"agent":"build","model":{"providerID":"openai","modelID":"gpt-5.4-mini"}}}}}}
+{"type":"emit_inbound","label":"root.user.text","frame":{"type":"sdk.event","event":{"id":"evt_edca207360015UIWeYXmKllHo3","type":"message.part.updated","properties":{"sessionID":"ses_1235df8f8ffekByXP7gVnnXA3P","part":{"type":"text","text":"Use the task tool exactly once. Delegate to the general subagent with this prompt: Respond exactly CHILD_OK. After the task completes, respond exactly PARENT_OK.","messageID":"msg_edca20735001Esh39V762TEx7f","sessionID":"ses_1235df8f8ffekByXP7gVnnXA3P","id":"prt_edca20735002U603TIFRMOYd9M"},"time":1781818066742}}}}
+{"type":"emit_inbound","label":"root.busy","frame":{"type":"sdk.event","event":{"id":"evt_edca207370013ecC1B3n7HWHF0","type":"session.status","properties":{"sessionID":"ses_1235df8f8ffekByXP7gVnnXA3P","status":{"type":"busy"}}}}}
+{"type":"emit_inbound","label":"root.assistant.tool-step","frame":{"type":"sdk.event","event":{"id":"evt_edca207380024rQ5C0LdF5jkgv","type":"message.updated","properties":{"sessionID":"ses_1235df8f8ffekByXP7gVnnXA3P","info":{"id":"msg_edca20738001L0AkDDqxC8ipdK","parentID":"msg_edca20735001Esh39V762TEx7f","role":"assistant","mode":"build","agent":"build","path":{"cwd":"/private/tmp/t3-opencode-probe","root":"/"},"cost":0,"tokens":{"input":0,"output":0,"reasoning":0,"cache":{"read":0,"write":0}},"modelID":"gpt-5.4-mini","providerID":"openai","time":{"created":1781818066744},"sessionID":"ses_1235df8f8ffekByXP7gVnnXA3P"}}}}}
+{"type":"emit_inbound","label":"task.pending","frame":{"type":"sdk.event","event":{"id":"evt_edca213fb002A7172u3WxPY2Jy","type":"message.part.updated","properties":{"sessionID":"ses_1235df8f8ffekByXP7gVnnXA3P","part":{"id":"prt_edca213fb001pDRIA33EBmsHOT","messageID":"msg_edca20738001L0AkDDqxC8ipdK","sessionID":"ses_1235df8f8ffekByXP7gVnnXA3P","type":"tool","tool":"task","callID":"call_MMPbMUvLDj12T5aimkDZC8Sl","state":{"status":"pending","input":{},"raw":""}},"time":1781818070011}}}}
+{"type":"emit_inbound","label":"task.running","frame":{"type":"sdk.event","event":{"id":"evt_edca21438001pcNOWgyXdKFyaI","type":"message.part.updated","properties":{"sessionID":"ses_1235df8f8ffekByXP7gVnnXA3P","part":{"type":"tool","tool":"task","callID":"call_MMPbMUvLDj12T5aimkDZC8Sl","state":{"title":"Return CHILD_OK","metadata":{"sessionId":"ses_1235debc9ffe9MNk00UheV2j0q","model":{"modelID":"gpt-5.4-mini","providerID":"openai"}},"status":"running","input":{"description":"Return CHILD_OK","prompt":"Respond exactly CHILD_OK.","subagent_type":"general","task_id":"","command":"delegate exact response"},"time":{"start":1781818070072}},"id":"prt_edca213fb001pDRIA33EBmsHOT","sessionID":"ses_1235df8f8ffekByXP7gVnnXA3P","messageID":"msg_edca20738001L0AkDDqxC8ipdK"},"time":1781818070072}}}}
+{"type":"expect_outbound","label":"session.get.child-policy","frame":{"type":"session.get","input":{"sessionID":"ses_1235debc9ffe9MNk00UheV2j0q"}}}
+{"type":"emit_inbound","label":"session.get.child-policy.response","frame":{"type":"sdk.response","operation":"session.get","data":{"id":"ses_1235debc9ffe9MNk00UheV2j0q","slug":"tidy-engine","projectID":"global","directory":"/private/tmp/t3-opencode-probe","path":"private/tmp/t3-opencode-probe","parentID":"ses_1235df8f8ffekByXP7gVnnXA3P","title":"Return CHILD_OK (@general subagent)","version":"1.14.39","permission":[{"permission":"task","action":"deny","pattern":"*"}],"time":{"created":1781818070070,"updated":1781818070072}}}}
+{"type":"expect_outbound","label":"session.update.child-policy","frame":{"type":"session.update","input":{"sessionID":"ses_1235debc9ffe9MNk00UheV2j0q","permission":"<any>"}}}
+{"type":"emit_inbound","label":"session.update.child-policy.response","frame":{"type":"sdk.response","operation":"session.update","data":{"id":"ses_1235debc9ffe9MNk00UheV2j0q","permission":[{"permission":"*","pattern":"*","action":"allow"},{"permission":"task","pattern":"*","action":"deny"}]}}}
+{"type":"emit_inbound","label":"child.user","frame":{"type":"sdk.event","event":{"id":"evt_edca21439002NEQt3QTkDp4ENI","type":"message.updated","properties":{"sessionID":"ses_1235debc9ffe9MNk00UheV2j0q","info":{"id":"msg_edca21438002r6NiMUSoqNKyyO","role":"user","sessionID":"ses_1235debc9ffe9MNk00UheV2j0q","time":{"created":1781818070073},"tools":{"task":false},"agent":"general","model":{"providerID":"openai","modelID":"gpt-5.4-mini"}}}}}}
+{"type":"emit_inbound","label":"child.user.text","frame":{"type":"sdk.event","event":{"id":"evt_edca21439003pseKePjnoGiTMW","type":"message.part.updated","properties":{"sessionID":"ses_1235debc9ffe9MNk00UheV2j0q","part":{"type":"text","text":"Respond exactly CHILD_OK.","messageID":"msg_edca21438002r6NiMUSoqNKyyO","sessionID":"ses_1235debc9ffe9MNk00UheV2j0q","id":"prt_edca214390014Naiz0G5HjlDbr"},"time":1781818070073}}}}
+{"type":"emit_inbound","label":"child.busy","frame":{"type":"sdk.event","event":{"id":"evt_edca2143c0013lzfo6Odo5FMzE","type":"session.status","properties":{"sessionID":"ses_1235debc9ffe9MNk00UheV2j0q","status":{"type":"busy"}}}}}
+{"type":"emit_inbound","label":"child.assistant","frame":{"type":"sdk.event","event":{"id":"evt_edca2143c0033666Mhyl3cAlhK","type":"message.updated","properties":{"sessionID":"ses_1235debc9ffe9MNk00UheV2j0q","info":{"id":"msg_edca2143c002Eu46Ey4Vg2BbuM","parentID":"msg_edca21438002r6NiMUSoqNKyyO","role":"assistant","mode":"general","agent":"general","path":{"cwd":"/private/tmp/t3-opencode-probe","root":"/"},"cost":0,"tokens":{"input":0,"output":0,"reasoning":0,"cache":{"read":0,"write":0}},"modelID":"gpt-5.4-mini","providerID":"openai","time":{"created":1781818070076},"sessionID":"ses_1235debc9ffe9MNk00UheV2j0q"}}}}}
+{"type":"emit_inbound","label":"child.assistant.text","frame":{"type":"sdk.event","event":{"id":"evt_edca21a3f001VbjReH1JvfruIc","type":"message.part.updated","properties":{"sessionID":"ses_1235debc9ffe9MNk00UheV2j0q","part":{"id":"prt_edca21a22001xAMVOfMPeu3Pe5","messageID":"msg_edca2143c002Eu46Ey4Vg2BbuM","sessionID":"ses_1235debc9ffe9MNk00UheV2j0q","type":"text","text":"CHILD_OK","time":{"start":1781818071586,"end":1781818071615},"metadata":{"openai":{"itemId":"msg_08dabd7d4c704130016a3462d793f48196a3764bab4f871b8d","phase":"final_answer"}}},"time":1781818071615}}}}
+{"type":"emit_inbound","label":"child.assistant.completed","frame":{"type":"sdk.event","event":{"id":"evt_edca21a5d001RVnmfbE88crcg3","type":"message.updated","properties":{"sessionID":"ses_1235debc9ffe9MNk00UheV2j0q","info":{"id":"msg_edca2143c002Eu46Ey4Vg2BbuM","parentID":"msg_edca21438002r6NiMUSoqNKyyO","role":"assistant","mode":"general","agent":"general","path":{"cwd":"/private/tmp/t3-opencode-probe","root":"/"},"cost":0,"tokens":{"total":7538,"input":7515,"output":9,"reasoning":14,"cache":{"write":0,"read":0}},"modelID":"gpt-5.4-mini","providerID":"openai","time":{"created":1781818070076,"completed":1781818071645},"sessionID":"ses_1235debc9ffe9MNk00UheV2j0q","finish":"stop"}}}}}
+{"type":"emit_inbound","label":"child.idle","frame":{"type":"sdk.event","event":{"id":"evt_edca21a5d0033WtPpZQdeaACpg","type":"session.status","properties":{"sessionID":"ses_1235debc9ffe9MNk00UheV2j0q","status":{"type":"idle"}}}}}
+{"type":"emit_inbound","label":"task.completed","frame":{"type":"sdk.event","event":{"id":"evt_edca21a5e001nGDHspvGlDIOu3","type":"message.part.updated","properties":{"sessionID":"ses_1235df8f8ffekByXP7gVnnXA3P","part":{"type":"tool","tool":"task","callID":"call_MMPbMUvLDj12T5aimkDZC8Sl","state":{"status":"completed","input":{"description":"Return CHILD_OK","prompt":"Respond exactly CHILD_OK.","subagent_type":"general","task_id":"","command":"delegate exact response"},"output":"task_id: ses_1235debc9ffe9MNk00UheV2j0q (for resuming to continue this task if needed)\n\n<task_result>\nCHILD_OK\n</task_result>","metadata":{"sessionId":"ses_1235debc9ffe9MNk00UheV2j0q","model":{"modelID":"gpt-5.4-mini","providerID":"openai"},"truncated":false},"title":"Return CHILD_OK","time":{"start":1781818070075,"end":1781818071646}},"metadata":{"openai":{"itemId":"fc_0f59e88787b4bf7e016a3462d5f5d08196893b4fa241992c81"}},"id":"prt_edca213fb001pDRIA33EBmsHOT","sessionID":"ses_1235df8f8ffekByXP7gVnnXA3P","messageID":"msg_edca20738001L0AkDDqxC8ipdK"},"time":1781818071646}}}}
+{"type":"emit_inbound","label":"root.assistant.tool-step.completed","frame":{"type":"sdk.event","event":{"id":"evt_edca21a5f001I6X2xOrOgrkGi4","type":"message.updated","properties":{"sessionID":"ses_1235df8f8ffekByXP7gVnnXA3P","info":{"id":"msg_edca20738001L0AkDDqxC8ipdK","parentID":"msg_edca20735001Esh39V762TEx7f","role":"assistant","mode":"build","agent":"build","path":{"cwd":"/private/tmp/t3-opencode-probe","root":"/"},"cost":0,"tokens":{"total":10945,"input":10835,"output":43,"reasoning":67,"cache":{"write":0,"read":0}},"modelID":"gpt-5.4-mini","providerID":"openai","time":{"created":1781818066744,"completed":1781818071647},"sessionID":"ses_1235df8f8ffekByXP7gVnnXA3P","finish":"tool-calls"}}}}}
+{"type":"emit_inbound","label":"root.assistant.final-step","frame":{"type":"sdk.event","event":{"id":"evt_edca21a5f004jTKIwlcQchMbZY","type":"message.updated","properties":{"sessionID":"ses_1235df8f8ffekByXP7gVnnXA3P","info":{"id":"msg_edca21a5f003lreMfrQqG0qWIe","parentID":"msg_edca20735001Esh39V762TEx7f","role":"assistant","mode":"build","agent":"build","path":{"cwd":"/private/tmp/t3-opencode-probe","root":"/"},"cost":0,"tokens":{"input":0,"output":0,"reasoning":0,"cache":{"read":0,"write":0}},"modelID":"gpt-5.4-mini","providerID":"openai","time":{"created":1781818071647},"sessionID":"ses_1235df8f8ffekByXP7gVnnXA3P"}}}}}
+{"type":"emit_inbound","label":"root.assistant.text","frame":{"type":"sdk.event","event":{"id":"evt_edca21e36001X0l8t5UPa1gOe3","type":"message.part.updated","properties":{"sessionID":"ses_1235df8f8ffekByXP7gVnnXA3P","part":{"id":"prt_edca21d9e001I40GbbzvlzhQ6Z","messageID":"msg_edca21a5f003lreMfrQqG0qWIe","sessionID":"ses_1235df8f8ffekByXP7gVnnXA3P","type":"text","text":"PARENT_OK","time":{"start":1781818072478,"end":1781818072630},"metadata":{"openai":{"itemId":"msg_06e59296cb53fc7c016a3462d879288196aead5e9838c741df","phase":"final_answer"}}},"time":1781818072630}}}}
+{"type":"emit_inbound","label":"root.assistant.completed","frame":{"type":"sdk.event","event":{"id":"evt_edca21e3800181OyYIBTDTTK3r","type":"message.updated","properties":{"sessionID":"ses_1235df8f8ffekByXP7gVnnXA3P","info":{"id":"msg_edca21a5f003lreMfrQqG0qWIe","parentID":"msg_edca20735001Esh39V762TEx7f","role":"assistant","mode":"build","agent":"build","path":{"cwd":"/private/tmp/t3-opencode-probe","root":"/"},"cost":0,"tokens":{"total":11007,"input":248,"output":7,"reasoning":0,"cache":{"write":0,"read":10752}},"modelID":"gpt-5.4-mini","providerID":"openai","time":{"created":1781818071647,"completed":1781818072632},"sessionID":"ses_1235df8f8ffekByXP7gVnnXA3P","finish":"stop"}}}}}
+{"type":"emit_inbound","label":"root.idle","frame":{"type":"sdk.event","event":{"id":"evt_edca21e39001lo71BB2Ym4WFC2","type":"session.status","properties":{"sessionID":"ses_1235df8f8ffekByXP7gVnnXA3P","status":{"type":"idle"}}}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/opencode_subagent/output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/opencode_subagent/output.ts
new file mode 100644
index 000000000000..c6ea4f4b8675
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/opencode_subagent/output.ts
@@ -0,0 +1,71 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertAssistantTextIncludes,
+  assertBaseProjection,
+  assertExecutionNodeKinds,
+  assertNoExtraAppRunsForProviderChildren,
+  assertRunProviderTurnCardinality,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessagesInclude,
+  OPENCODE_SUBAGENT_PROMPT,
+  projectionFor,
+} from "../shared.ts";
+
+export function assertOpenCodeSubagentOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({ result, transcript, runCount: 1, runStatuses: ["completed"] });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertExecutionNodeKinds(projection, ["root_turn", "subagent", "assistant_message"]);
+  assertTurnItemTypes(projection, ["user_message", "subagent", "assistant_message"]);
+  assertRunProviderTurnCardinality({ projection, rootRunCount: 1 });
+  assertNoExtraAppRunsForProviderChildren({ projection, expectedAppRuns: 1 });
+  assertUserMessagesInclude(projection, [OPENCODE_SUBAGENT_PROMPT]);
+  assertAssistantTextIncludes(projection, "PARENT_OK");
+
+  assert.lengthOf(projection.subagents, 1);
+  assert.lengthOf(result.shellSnapshot.threads, 2);
+  const subagent = projection.subagents[0];
+  assert.isDefined(subagent);
+  assert.equal(subagent.origin, "provider_native");
+  assert.equal(subagent.createdBy, "agent");
+  assert.equal(subagent.driver, "opencode");
+  assert.equal(subagent.status, "completed");
+  assert.equal(subagent.prompt, "Respond exactly CHILD_OK.");
+  assert.include(subagent.result ?? "", "CHILD_OK");
+  assert.isNotNull(subagent.childThreadId);
+  assert.isNotNull(subagent.providerThreadId);
+  assert.isNotNull(subagent.nativeTaskRef);
+  assert.isNotNull(subagent.completedAt);
+  if (subagent.childThreadId === null || subagent.providerThreadId === null) {
+    throw new Error("OpenCode subagent is missing its child thread identity");
+  }
+
+  const providerThread = projection.providerThreads.find(
+    (thread) => thread.id === subagent.providerThreadId,
+  );
+  assert.isDefined(providerThread);
+  assert.equal(providerThread.appThreadId, subagent.childThreadId);
+  assert.equal(providerThread.ownerNodeId, subagent.id);
+
+  const childProjection = result.projections.get(subagent.childThreadId);
+  assert.isDefined(childProjection);
+  assert.equal(childProjection.thread.lineage.parentThreadId, projection.thread.id);
+  assert.equal(childProjection.thread.lineage.relationshipToParent, "subagent");
+  assert.equal(childProjection.thread.activeProviderThreadId, providerThread.id);
+  assert.lengthOf(childProjection.runs, 0);
+  assert.lengthOf(childProjection.providerThreads, 1);
+  assert.lengthOf(childProjection.providerTurns, 1);
+  assert.equal(childProjection.providerTurns[0]?.status, "completed");
+  assertExecutionNodeKinds(childProjection, ["root_turn", "assistant_message"]);
+  assertTurnItemTypes(childProjection, ["user_message", "assistant_message"]);
+  assertUserMessagesInclude(childProjection, ["Respond exactly CHILD_OK."]);
+  assertAssistantTextIncludes(childProjection, "CHILD_OK");
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/plan_questions/codex_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/plan_questions/codex_output.ts
new file mode 100644
index 000000000000..8b1abc5c4dbf
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/plan_questions/codex_output.ts
@@ -0,0 +1,50 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertAllRuntimeRequestsResolved,
+  assertAssistantTextIncludes,
+  assertBaseProjection,
+  assertExecutionNodeKinds,
+  assertRunOrdinals,
+  assertRuntimeRequestCounts,
+  assertRuntimeRequestKinds,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessagesInclude,
+  assertVisibleTurnItemsMirrorLocalTurnItems,
+  PLAN_QUESTIONS_PROMPT,
+  projectionFor,
+} from "../shared.ts";
+
+export function assertPlanQuestionsOutputBase(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({ result, transcript, runCount: 1, runStatuses: ["completed"] });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertVisibleTurnItemsMirrorLocalTurnItems(projection);
+  assertRunOrdinals(projection, [1]);
+  assertExecutionNodeKinds(projection, ["root_turn", "user_input_request", "assistant_message"]);
+  assertRuntimeRequestCounts(projection, { total: 1, resolved: 1 });
+  assertRuntimeRequestKinds(projection, ["user_input"]);
+  assertAllRuntimeRequestsResolved(projection);
+  assertTurnItemTypes(projection, ["user_message", "user_input_request", "assistant_message"]);
+  assertUserMessagesInclude(projection, [PLAN_QUESTIONS_PROMPT]);
+  assertAssistantTextIncludes(projection, "plan questions fixture complete");
+}
+
+export function assertPlanQuestionsOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertPlanQuestionsOutputBase(result, transcript);
+
+  const projection = projectionFor(result, transcript.scenario);
+  const requestItem = projection.turnItems.find((item) => item.type === "user_input_request");
+  assert.isDefined(requestItem);
+  assert.equal(requestItem?.questions[0]?.id, "schema_vs_ui_flexibility");
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/plan_questions/codex_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/plan_questions/codex_transcript.ndjson
new file mode 100644
index 000000000000..1f4ebc25a84a
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/plan_questions/codex_transcript.ndjson
@@ -0,0 +1,67 @@
+{"type":"transcript_start","provider":"codex","protocol":"codex.app-server","version":"0.120.0","scenario":"plan_questions","metadata":{"source":"codex-app-server-probe","fileName":"plan_questions.ndjson","description":"One plan-mode turn that asks a structured clarifying question."}}
+{"type":"expect_outbound","label":"initialize","frame":{"id":1,"method":"initialize","params":{"capabilities":{"experimentalApi":true},"clientInfo":{"name":"t3code_desktop","title":"T3 Code Desktop","version":"0.1.0"}}}}
+{"type":"emit_inbound","label":"initialize","frame":{"id":1,"result":{"userAgent":"t3code_desktop/0.120.0 (Mac OS 26.4.1; arm64) dumb (t3code_desktop; 0.1.0)","codexHome":"/Users/julius/.codex","platformFamily":"unix","platformOs":"macos"}}}
+{"type":"expect_outbound","label":"initialized","frame":{"method":"initialized"}}
+{"type":"expect_outbound","label":"thread/start","frame":{"id":2,"method":"thread/start","params":{}}}
+{"type":"emit_inbound","label":"thread/start","frame":{"id":2,"result":{"thread":{"id":"019db22a-e824-7ac3-bbf7-994a4aa087e5","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1776810649,"updatedAt":1776810649,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/04/21/rollout-2026-04-21T15-30-49-019db22a-e824-7ac3-bbf7-994a4aa087e5.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","cliVersion":"0.120.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]},"model":"gpt-5.3-codex","modelProvider":"openai","serviceTier":"fast","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","approvalPolicy":"on-request","approvalsReviewer":"user","sandbox":{"type":"workspaceWrite","writableRoots":["/Users/julius/.codex/memories"],"readOnlyAccess":{"type":"fullAccess"},"networkAccess":false,"excludeTmpdirEnvVar":false,"excludeSlashTmp":false},"reasoningEffort":"xhigh"}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":3,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Use request_user_input to ask one multiple-choice clarifying question about whether this fixture should prefer strict schemas or UI flexibility. After receiving the answer, respond exactly: plan questions fixture complete","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"networkAccess":false,"type":"readOnly"},"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","collaborationMode":{"mode":"plan","settings":{"developer_instructions":"<collaboration_mode># Plan Mode (Conversational)\n\nYou work in 3 phases, and you should *chat your way* to a great plan before finalizing it. A great plan is very detailed-intent- and implementation-wise-so that it can be handed to another engineer or agent to be implemented right away. It must be **decision complete**, where the implementer does not need to make any decisions.\n\n## Mode rules (strict)\n\nYou are in **Plan Mode** until a developer message explicitly ends it.\n\nPlan Mode is not changed by user intent, tone, or imperative language. If a user asks for execution while still in Plan Mode, treat it as a request to **plan the execution**, not perform it.\n\n## Plan Mode vs update_plan tool\n\nPlan Mode is a collaboration mode that can involve requesting user input and eventually issuing a `<proposed_plan>` block.\n\nSeparately, `update_plan` is a checklist/progress/TODOs tool; it does not enter or exit Plan Mode. Do not confuse it with Plan mode or try to use it while in Plan mode. If you try to use `update_plan` in Plan mode, it will return an error.\n\n## Execution vs. mutation in Plan Mode\n\nYou may explore and execute **non-mutating** actions that improve the plan. You must not perform **mutating** actions.\n\n### Allowed (non-mutating, plan-improving)\n\nActions that gather truth, reduce ambiguity, or validate feasibility without changing repo-tracked state. Examples:\n\n* Reading or searching files, configs, schemas, types, manifests, and docs\n* Static analysis, inspection, and repo exploration\n* Dry-run style commands when they do not edit repo-tracked files\n* Tests, builds, or checks that may write to caches or build artifacts (for example, `target/`, `.cache/`, or snapshots) so long as they do not edit repo-tracked files\n\n### Not allowed (mutating, plan-executing)\n\nActions that implement the plan or change repo-tracked state. Examples:\n\n* Editing or writing files\n* Running formatters or linters that rewrite files\n* Applying patches, migrations, or codegen that updates repo-tracked files\n* Side-effectful commands whose purpose is to carry out the plan rather than refine it\n\nWhen in doubt: if the action would reasonably be described as \"doing the work\" rather than \"planning the work,\" do not do it.\n\n## PHASE 1 - Ground in the environment (explore first, ask second)\n\nBegin by grounding yourself in the actual environment. Eliminate unknowns in the prompt by discovering facts, not by asking the user. Resolve all questions that can be answered through exploration or inspection. Identify missing or ambiguous details only if they cannot be derived from the environment. Silent exploration between turns is allowed and encouraged.\n\nBefore asking the user any question, perform at least one targeted non-mutating exploration pass (for example: search relevant files, inspect likely entrypoints/configs, confirm current implementation shape), unless no local environment/repo is available.\n\nException: you may ask clarifying questions about the user's prompt before exploring, ONLY if there are obvious ambiguities or contradictions in the prompt itself. However, if ambiguity might be resolved by exploring, always prefer exploring first.\n\nDo not ask questions that can be answered from the repo or system (for example, \"where is this struct?\" or \"which UI component should we use?\" when exploration can make it clear). Only ask once you have exhausted reasonable non-mutating exploration.\n\n## PHASE 2 - Intent chat (what they actually want)\n\n* Keep asking until you can clearly state: goal + success criteria, audience, in/out of scope, constraints, current state, and the key preferences/tradeoffs.\n* Bias toward questions over guessing: if any high-impact ambiguity remains, do NOT plan yet-ask.\n\n## PHASE 3 - Implementation chat (what/how we'll build)\n\n* Once intent is stable, keep asking until the spec is decision complete: approach, interfaces (APIs/schemas/I/O), data flow, edge cases/failure modes, testing + acceptance criteria, rollout/monitoring, and any migrations/compat constraints.\n\n## Asking questions\n\nCritical rules:\n\n* Strongly prefer using the `request_user_input` tool to ask any questions.\n* Offer only meaningful multiple-choice options; don't include filler choices that are obviously wrong or irrelevant.\n* In rare cases where an unavoidable, important question can't be expressed with reasonable multiple-choice options (due to extreme ambiguity), you may ask it directly without the tool.\n\nYou SHOULD ask many questions, but each question must:\n\n* materially change the spec/plan, OR\n* confirm/lock an assumption, OR\n* choose between meaningful tradeoffs.\n* not be answerable by non-mutating commands.\n\nUse the `request_user_input` tool only for decisions that materially change the plan, for confirming important assumptions, or for information that cannot be discovered via non-mutating exploration.\n\n## Two kinds of unknowns (treat differently)\n\n1. **Discoverable facts** (repo/system truth): explore first.\n\n   * Before asking, run targeted searches and check likely sources of truth (configs/manifests/entrypoints/schemas/types/constants).\n   * Ask only if: multiple plausible candidates; nothing found but you need a missing identifier/context; or ambiguity is actually product intent.\n   * If asking, present concrete candidates (paths/service names) + recommend one.\n   * Never ask questions you can answer from your environment (e.g., \"where is this struct\").\n\n2. **Preferences/tradeoffs** (not discoverable): ask early.\n\n   * These are intent or implementation preferences that cannot be derived from exploration.\n   * Provide 2-4 mutually exclusive options + a recommended default.\n   * If unanswered, proceed with the recommended option and record it as an assumption in the final plan.\n\n## Finalization rule\n\nOnly output the final plan when it is decision complete and leaves no decisions to the implementer.\n\nWhen you present the official plan, wrap it in a `<proposed_plan>` block so the client can render it specially:\n\n1) The opening tag must be on its own line.\n2) Start the plan content on the next line (no text on the same line as the tag).\n3) The closing tag must be on its own line.\n4) Use Markdown inside the block.\n5) Keep the tags exactly as `<proposed_plan>` and `</proposed_plan>` (do not translate or rename them), even if the plan content is in another language.\n\nExample:\n\n<proposed_plan>\nplan content\n</proposed_plan>\n\nplan content should be human and agent digestible. The final plan must be plan-only and include:\n\n* A clear title\n* A brief summary section\n* Important changes or additions to public APIs/interfaces/types\n* Test cases and scenarios\n* Explicit assumptions and defaults chosen where needed\n\nDo not ask \"should I proceed?\" in the final output. The user can easily switch out of Plan mode and request implementation if you have included a `<proposed_plan>` block in your response. Alternatively, they can decide to stay in Plan mode and continue refining the plan.\n\nOnly produce at most one `<proposed_plan>` block per turn, and only when you are presenting a complete spec.\n</collaboration_mode>","model":"gpt-5.4","reasoning_effort":"medium"}},"approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"thread/started","frame":{"method":"thread/started","params":{"thread":{"id":"019db22a-e824-7ac3-bbf7-994a4aa087e5","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1776810649,"updatedAt":1776810649,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/04/21/rollout-2026-04-21T15-30-49-019db22a-e824-7ac3-bbf7-994a4aa087e5.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","cliVersion":"0.120.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]}}}}
+{"type":"emit_inbound","label":"deprecationNotice","frame":{"method":"deprecationNotice","params":{"summary":"`[features].collab` is deprecated. Use `[features].multi_agent` instead.","details":"Enable it with `--enable multi_agent` or `[features].multi_agent` in config.toml. See https://developers.openai.com/codex/config-basic#feature-flags for details."}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":3,"result":{"turn":{"id":"019db22a-e831-7b60-82fd-9eb12d353264","items":[],"status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turn":{"id":"019db22a-e831-7b60-82fd-9eb12d353264","items":[],"status":"inProgress","error":null,"startedAt":1776810649,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"c4e1268e-2e0c-46bb-9084-06e0cfe431c5","content":[{"type":"text","text":"Use request_user_input to ask one multiple-choice clarifying question about whether this fixture should prefer strict schemas or UI flexibility. After receiving the answer, respond exactly: plan questions fixture complete","text_elements":[]}]},"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"c4e1268e-2e0c-46bb-9084-06e0cfe431c5","content":[{"type":"text","text":"Use request_user_input to ask one multiple-choice clarifying question about whether this fixture should prefer strict schemas or UI flexibility. After receiving the answer, respond exactly: plan questions fixture complete","text_elements":[]}]},"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264"}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":1,"windowDurationMins":300,"resetsAt":1776821038},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777407838},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_030666e5f3da47180169e7fa9ec6948199bec1205ddf98adea","text":"","phase":"commentary","memoryCitation":null},"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264","itemId":"msg_030666e5f3da47180169e7fa9ec6948199bec1205ddf98adea","delta":"I"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264","itemId":"msg_030666e5f3da47180169e7fa9ec6948199bec1205ddf98adea","delta":"’ll"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264","itemId":"msg_030666e5f3da47180169e7fa9ec6948199bec1205ddf98adea","delta":" ask"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264","itemId":"msg_030666e5f3da47180169e7fa9ec6948199bec1205ddf98adea","delta":" the"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264","itemId":"msg_030666e5f3da47180169e7fa9ec6948199bec1205ddf98adea","delta":" requested"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264","itemId":"msg_030666e5f3da47180169e7fa9ec6948199bec1205ddf98adea","delta":" multiple"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264","itemId":"msg_030666e5f3da47180169e7fa9ec6948199bec1205ddf98adea","delta":"-choice"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264","itemId":"msg_030666e5f3da47180169e7fa9ec6948199bec1205ddf98adea","delta":" clarification"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264","itemId":"msg_030666e5f3da47180169e7fa9ec6948199bec1205ddf98adea","delta":" using"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264","itemId":"msg_030666e5f3da47180169e7fa9ec6948199bec1205ddf98adea","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264","itemId":"msg_030666e5f3da47180169e7fa9ec6948199bec1205ddf98adea","delta":"request"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264","itemId":"msg_030666e5f3da47180169e7fa9ec6948199bec1205ddf98adea","delta":"_user"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264","itemId":"msg_030666e5f3da47180169e7fa9ec6948199bec1205ddf98adea","delta":"_input"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264","itemId":"msg_030666e5f3da47180169e7fa9ec6948199bec1205ddf98adea","delta":"`,"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264","itemId":"msg_030666e5f3da47180169e7fa9ec6948199bec1205ddf98adea","delta":" then"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264","itemId":"msg_030666e5f3da47180169e7fa9ec6948199bec1205ddf98adea","delta":" wait"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264","itemId":"msg_030666e5f3da47180169e7fa9ec6948199bec1205ddf98adea","delta":" for"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264","itemId":"msg_030666e5f3da47180169e7fa9ec6948199bec1205ddf98adea","delta":" the"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264","itemId":"msg_030666e5f3da47180169e7fa9ec6948199bec1205ddf98adea","delta":" selected"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264","itemId":"msg_030666e5f3da47180169e7fa9ec6948199bec1205ddf98adea","delta":" preference"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264","itemId":"msg_030666e5f3da47180169e7fa9ec6948199bec1205ddf98adea","delta":" before"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264","itemId":"msg_030666e5f3da47180169e7fa9ec6948199bec1205ddf98adea","delta":" returning"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264","itemId":"msg_030666e5f3da47180169e7fa9ec6948199bec1205ddf98adea","delta":" the"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264","itemId":"msg_030666e5f3da47180169e7fa9ec6948199bec1205ddf98adea","delta":" exact"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264","itemId":"msg_030666e5f3da47180169e7fa9ec6948199bec1205ddf98adea","delta":" fixture"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264","itemId":"msg_030666e5f3da47180169e7fa9ec6948199bec1205ddf98adea","delta":" completion"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264","itemId":"msg_030666e5f3da47180169e7fa9ec6948199bec1205ddf98adea","delta":" text"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264","itemId":"msg_030666e5f3da47180169e7fa9ec6948199bec1205ddf98adea","delta":"."}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_030666e5f3da47180169e7fa9ec6948199bec1205ddf98adea","text":"I’ll ask the requested multiple-choice clarification using `request_user_input`, then wait for the selected preference before returning the exact fixture completion text.","phase":"commentary","memoryCitation":null},"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264"}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","status":{"type":"active","activeFlags":["waitingOnUserInput"]}}}}
+{"type":"emit_inbound","label":"item/tool/requestUserInput","frame":{"method":"item/tool/requestUserInput","id":0,"params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264","itemId":"call_cG9h11JYLbWjw78z3xcup9JJ","questions":[{"id":"schema_vs_ui_flexibility","header":"Fixture","question":"For this fixture, should the plan prefer strict schemas or UI flexibility?","isOther":true,"isSecret":false,"options":[{"label":"Strict schemas (Recommended)","description":"Favor precise contracts and validation even if UI changes require schema updates."},{"label":"UI flexibility","description":"Favor looser fixture shapes so the UI can evolve with less schema churn."}]}]}}}
+{"type":"expect_outbound","label":"item/tool/requestUserInput","frame":{"id":0,"result":{"answers":{"schema_vs_ui_flexibility":{"answers":["Strict schemas (Recommended)"]}}}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264","tokenUsage":{"total":{"totalTokens":26283,"inputTokens":26148,"cachedInputTokens":15744,"outputTokens":135,"reasoningOutputTokens":0},"last":{"totalTokens":26283,"inputTokens":26148,"cachedInputTokens":15744,"outputTokens":135,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":1,"windowDurationMins":300,"resetsAt":1776821038},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777407838},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"serverRequest/resolved","frame":{"method":"serverRequest/resolved","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","requestId":0}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_030666e5f3da47180169e7faa1bef481998a4a44763d13f9ec","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264","itemId":"msg_030666e5f3da47180169e7faa1bef481998a4a44763d13f9ec","delta":"plan"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264","itemId":"msg_030666e5f3da47180169e7faa1bef481998a4a44763d13f9ec","delta":" questions"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264","itemId":"msg_030666e5f3da47180169e7faa1bef481998a4a44763d13f9ec","delta":" fixture"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264","itemId":"msg_030666e5f3da47180169e7faa1bef481998a4a44763d13f9ec","delta":" complete"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_030666e5f3da47180169e7faa1bef481998a4a44763d13f9ec","text":"plan questions fixture complete","phase":"final_answer","memoryCitation":null},"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turnId":"019db22a-e831-7b60-82fd-9eb12d353264","tokenUsage":{"total":{"totalTokens":52606,"inputTokens":52463,"cachedInputTokens":31488,"outputTokens":143,"reasoningOutputTokens":0},"last":{"totalTokens":26323,"inputTokens":26315,"cachedInputTokens":15744,"outputTokens":8,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":1,"windowDurationMins":300,"resetsAt":1776821038},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777407838},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019db22a-e824-7ac3-bbf7-994a4aa087e5","turn":{"id":"019db22a-e831-7b60-82fd-9eb12d353264","items":[],"status":"completed","error":null,"startedAt":1776810649,"completedAt":1776810657,"durationMs":8310}}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/plan_questions/grok_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/plan_questions/grok_transcript.ndjson
new file mode 100644
index 000000000000..be5d2bb29f68
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/plan_questions/grok_transcript.ndjson
@@ -0,0 +1,11 @@
+{"type":"transcript_start","provider":"grok","protocol":"acp.ndjson-jsonrpc","version":"1","scenario":"plan_questions","metadata":{"generatedBy":"live-grok-shape-probe","nativeSessionId":"grok-replay-session-1"}}
+{"type":"expect_outbound","label":"initialize","frame":{"kind":"request","method":"initialize","params":{"protocolVersion":1,"clientCapabilities":{"fs":{"readTextFile":false,"writeTextFile":false},"terminal":false,"elicitation":{"form":{}}},"clientInfo":{"name":"t3-code","version":"0.0.0"}}}}
+{"type":"emit_inbound","label":"initialized","frame":{"kind":"response","method":"initialize","result":{"protocolVersion":1,"agentCapabilities":{"loadSession":true,"mcpCapabilities":{"http":true,"sse":true},"promptCapabilities":{"audio":false,"embeddedContext":true,"image":false}},"authMethods":[{"id":"replay","name":"Replay"}],"agentInfo":{"name":"grok-replay","version":"1"}}}}
+{"type":"expect_outbound","label":"session.new","frame":{"kind":"request","method":"session/new","params":{"cwd":"<workspace>","mcpServers":"<any>"}}}
+{"type":"emit_inbound","label":"session.created","frame":{"kind":"response","method":"session/new","result":{"sessionId":"grok-replay-session-1","models":{"currentModelId":"grok-build","availableModels":[{"modelId":"grok-build","name":"Grok Build"}]}}}}
+{"type":"expect_outbound","label":"session.prompt","frame":{"kind":"request","method":"session/prompt","params":{"sessionId":"grok-replay-session-1","prompt":[{"type":"text","text":"Use request_user_input to ask one multiple-choice clarifying question about whether this fixture should prefer strict schemas or UI flexibility. After receiving the answer, respond exactly: plan questions fixture complete"}]}}}
+{"type":"emit_inbound","label":"question.request","frame":{"kind":"request","method":"_x.ai/ask_user_question","params":{"method":"x.ai/ask_user_question","params":{"sessionId":"grok-replay-session-1","toolCallId":"ask-user-question-tool-call-1","questions":[{"id":"schema_vs_ui_flexibility","question":"For this fixture, should the plan prefer strict schemas or UI flexibility?","multiSelect":null,"options":[{"label":"Strict schemas (Recommended)","description":"Favor precise contracts and validation."},{"label":"UI flexibility","description":"Favor looser fixture shapes."}]}],"mode":"plan"}}}}
+{"type":"expect_outbound","label":"question.response","frame":{"kind":"response","method":"_x.ai/ask_user_question","result":{"outcome":"accepted","answers":{"For this fixture, should the plan prefer strict schemas or UI flexibility?":["Strict schemas (Recommended)"]}}}}
+{"type":"emit_inbound","label":"assistant.final","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"grok-replay-session-1","update":{"sessionUpdate":"agent_message_chunk","content":{"type":"text","text":"plan questions fixture complete"}}}}}
+{"type":"emit_inbound","label":"prompt.completed","frame":{"kind":"response","method":"session/prompt","result":{"stopReason":"end_turn"}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/plan_questions/input.ts b/apps/server/src/orchestration-v2/testkit/fixtures/plan_questions/input.ts
new file mode 100644
index 000000000000..a3442ca6f5d2
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/plan_questions/input.ts
@@ -0,0 +1,17 @@
+import { PLAN_QUESTIONS_PROMPT, type OrchestratorFixtureInput } from "../shared.ts";
+
+export function planQuestionsInput(): OrchestratorFixtureInput {
+  return {
+    interactionMode: "plan",
+    steps: [
+      { type: "message", text: PLAN_QUESTIONS_PROMPT },
+      {
+        type: "answer_next_user_input_request",
+        answers: {
+          schema_vs_ui_flexibility: "Strict schemas (Recommended)",
+          "question-0-schema-vs-flexibility": "Strict schemas",
+        },
+      },
+    ],
+  };
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/plan_questions/opencode_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/plan_questions/opencode_output.ts
new file mode 100644
index 000000000000..790b74379b13
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/plan_questions/opencode_output.ts
@@ -0,0 +1,26 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import { assertPlanQuestionsOutputBase } from "./codex_output.ts";
+import { projectionFor } from "../shared.ts";
+
+export function assertOpenCodePlanQuestionsOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  // The shared assertions cover the runtime-request lifecycle. OpenCode owns
+  // its question identifiers, so assert its normalized native header instead
+  // of Codex's fixture-specific id.
+  assertPlanQuestionsOutputBase(result, transcript);
+  const projection = projectionFor(result, transcript.scenario);
+  const requestItem = projection.turnItems.find((item) => item.type === "user_input_request");
+  assert.equal(requestItem?.questions[0]?.id, "question-0-schema-vs-flexibility");
+  assert.equal(requestItem?.status, "completed");
+  assert.lengthOf(
+    projection.turnItems.filter(
+      (item) => item.type === "dynamic_tool" && item.toolName === "question",
+    ),
+    0,
+  );
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/plan_questions/opencode_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/plan_questions/opencode_transcript.ndjson
new file mode 100644
index 000000000000..c6e7bb8e5302
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/plan_questions/opencode_transcript.ndjson
@@ -0,0 +1,23 @@
+{"type":"transcript_start","provider":"opencode","protocol":"opencode-sdk.sse","version":"1.14.39","scenario":"plan_questions","metadata":{"source":"authenticated-opencode-sdk-probe","capturedAt":"2026-06-18","nativeSessionId":"ses_12369ea4cffePl0BsyVg3hGlmZ","model":"openai/gpt-5.4-mini","filteredToRelevantEvents":true,"description":"Real structured-question request/reply and continuation across two assistant steps."}}
+{"type":"expect_outbound","label":"event.subscribe","frame":{"type":"event.subscribe"}}
+{"type":"expect_outbound","label":"session.create","frame":{"type":"session.create","input":{"title":"<any>","permission":"<any>"}}}
+{"type":"emit_inbound","label":"session.created","frame":{"type":"sdk.response","operation":"session.create","data":{"id":"ses_12369ea4cffePl0BsyVg3hGlmZ","slug":"mighty-harbor","version":"1.14.39","projectID":"global","directory":"/private/tmp/t3-opencode-probe","path":"private/tmp/t3-opencode-probe","title":"T3 OpenCode v2 probe","time":{"created":1781817284019,"updated":1781817284019}}}}
+{"type":"expect_outbound","label":"session.promptAsync","frame":{"type":"session.promptAsync","input":{"sessionID":"ses_12369ea4cffePl0BsyVg3hGlmZ","model":{"providerID":"openai","modelID":"gpt-5.4-mini"},"agent":"build","parts":[{"type":"text","text":"Use request_user_input to ask one multiple-choice clarifying question about whether this fixture should prefer strict schemas or UI flexibility. After receiving the answer, respond exactly: plan questions fixture complete"}]}}}
+{"type":"emit_inbound","label":"message.updated.user","frame":{"type":"sdk.event","event":{"id":"evt_edc9615bb003WEUXUNfpZxMZDD","type":"message.updated","properties":{"sessionID":"ses_12369ea4cffePl0BsyVg3hGlmZ","info":{"id":"msg_edc9615bb001iCnWab1qzSeRA3","role":"user","sessionID":"ses_12369ea4cffePl0BsyVg3hGlmZ","time":{"created":1781817284027},"agent":"build","model":{"providerID":"openai","modelID":"gpt-5.4-mini"}}}}}}
+{"type":"emit_inbound","label":"message.part.updated.user","frame":{"type":"sdk.event","event":{"id":"evt_edc9615bc001l8KO7edlPViXO0","type":"message.part.updated","properties":{"sessionID":"ses_12369ea4cffePl0BsyVg3hGlmZ","part":{"type":"text","text":"Use request_user_input to ask one multiple-choice clarifying question about whether this fixture should prefer strict schemas or UI flexibility. After receiving the answer, respond exactly: plan questions fixture complete","messageID":"msg_edc9615bb001iCnWab1qzSeRA3","sessionID":"ses_12369ea4cffePl0BsyVg3hGlmZ","id":"prt_edc9615bb002fjGpO5oeQE22B9"},"time":1781817284028}}}}
+{"type":"emit_inbound","label":"session.promptAsync.response","frame":{"type":"sdk.response","operation":"session.promptAsync","data":null}}
+{"type":"emit_inbound","label":"session.status.busy","frame":{"type":"sdk.event","event":{"id":"evt_edc9615bd0012brtruCEXYmNyX","type":"session.status","properties":{"sessionID":"ses_12369ea4cffePl0BsyVg3hGlmZ","status":{"type":"busy"}}}}}
+{"type":"emit_inbound","label":"message.updated.assistant","frame":{"type":"sdk.event","event":{"id":"evt_edc9615bd003GQj8GzeHgoMlZ2","type":"message.updated","properties":{"sessionID":"ses_12369ea4cffePl0BsyVg3hGlmZ","info":{"id":"msg_edc9615bd002qb49gh9N1krbX2","parentID":"msg_edc9615bb001iCnWab1qzSeRA3","role":"assistant","mode":"build","agent":"build","path":{"cwd":"/private/tmp/t3-opencode-probe","root":"/"},"cost":0,"tokens":{"input":0,"output":0,"reasoning":0,"cache":{"read":0,"write":0}},"modelID":"gpt-5.4-mini","providerID":"openai","time":{"created":1781817284029},"sessionID":"ses_12369ea4cffePl0BsyVg3hGlmZ"}}}}}
+{"type":"emit_inbound","label":"reasoning.completed","frame":{"type":"sdk.event","event":{"id":"evt_edc96244e001ez77NBs6gJaPZh","type":"message.part.updated","properties":{"sessionID":"ses_12369ea4cffePl0BsyVg3hGlmZ","part":{"id":"prt_edc961988001aollEeE48XSJDg","messageID":"msg_edc9615bd002qb49gh9N1krbX2","sessionID":"ses_12369ea4cffePl0BsyVg3hGlmZ","type":"reasoning","text":"Clarifying user input before asking the structured question.","time":{"start":1781817285000,"end":1781817287757}},"time":1781817287757}}}}
+{"type":"emit_inbound","label":"question.tool.pending","frame":{"type":"sdk.event","event":{"id":"evt_edc96244e003ljcUzfVu0WTFc2","type":"message.part.updated","properties":{"sessionID":"ses_12369ea4cffePl0BsyVg3hGlmZ","part":{"id":"prt_edc96244e002RBYg9ASwc10E8R","messageID":"msg_edc9615bd002qb49gh9N1krbX2","sessionID":"ses_12369ea4cffePl0BsyVg3hGlmZ","type":"tool","tool":"question","callID":"call_XU0dxWGu2ioLZscBtYAIqGfT","state":{"status":"pending","input":{},"raw":""}},"time":1781817287758}}}}
+{"type":"emit_inbound","label":"question.asked","frame":{"type":"sdk.event","event":{"id":"evt_edc9624d90022x2I3Rv9S6t1tt","type":"question.asked","properties":{"id":"que_edc9624d9001e2GFKX724Z8b5Z","sessionID":"ses_12369ea4cffePl0BsyVg3hGlmZ","questions":[{"question":"Should this fixture prefer strict schemas or UI flexibility?","header":"Schema vs Flexibility","options":[{"label":"Strict schemas","description":"Prioritize validation and exact structure over visual freedom."},{"label":"UI flexibility","description":"Prioritize adaptable rendering and tolerant input handling."}],"multiple":false}],"tool":{"messageID":"msg_edc9615bd002qb49gh9N1krbX2","callID":"call_XU0dxWGu2ioLZscBtYAIqGfT"}}}}}
+{"type":"expect_outbound","label":"question.reply","frame":{"type":"question.reply","input":{"requestID":"que_edc9624d9001e2GFKX724Z8b5Z","answers":[["Strict schemas"]]}}}
+{"type":"emit_inbound","label":"question.reply.response","frame":{"type":"sdk.response","operation":"question.reply","data":true}}
+{"type":"emit_inbound","label":"question.tool.running","frame":{"type":"sdk.event","event":{"id":"evt_edc9624da001qamTLzcYoY2CPY","type":"message.part.updated","properties":{"sessionID":"ses_12369ea4cffePl0BsyVg3hGlmZ","part":{"type":"tool","tool":"question","callID":"call_XU0dxWGu2ioLZscBtYAIqGfT","state":{"status":"running","input":{"questions":[{"question":"Should this fixture prefer strict schemas or UI flexibility?","header":"Schema vs Flexibility","options":[{"label":"Strict schemas","description":"Prioritize validation and exact structure over visual freedom."},{"label":"UI flexibility","description":"Prioritize adaptable rendering and tolerant input handling."}],"multiple":false}]},"raw":"","time":{"start":1781817287898}},"id":"prt_edc96244e002RBYg9ASwc10E8R","sessionID":"ses_12369ea4cffePl0BsyVg3hGlmZ","messageID":"msg_edc9615bd002qb49gh9N1krbX2"},"time":1781817287898}}}}
+{"type":"emit_inbound","label":"question.replied","frame":{"type":"sdk.event","event":{"id":"evt_edc9624de001JBbX1qaXzgfeKl","type":"question.replied","properties":{"sessionID":"ses_12369ea4cffePl0BsyVg3hGlmZ","requestID":"que_edc9624d9001e2GFKX724Z8b5Z","answers":[["Strict schemas"]]}}}}
+{"type":"emit_inbound","label":"question.tool.completed","frame":{"type":"sdk.event","event":{"id":"evt_edc9624df001Pw6H7GGa8tCa3V","type":"message.part.updated","properties":{"sessionID":"ses_12369ea4cffePl0BsyVg3hGlmZ","part":{"type":"tool","tool":"question","callID":"call_XU0dxWGu2ioLZscBtYAIqGfT","state":{"status":"completed","input":{"questions":[{"question":"Should this fixture prefer strict schemas or UI flexibility?","header":"Schema vs Flexibility","options":[{"label":"Strict schemas","description":"Prioritize validation and exact structure over visual freedom."},{"label":"UI flexibility","description":"Prioritize adaptable rendering and tolerant input handling."}],"multiple":false}]},"output":"User answered: Strict schemas","metadata":{"answers":[["Strict schemas"]],"truncated":false},"title":"Asked 1 question","time":{"start":1781817287898,"end":1781817287903}},"id":"prt_edc96244e002RBYg9ASwc10E8R","sessionID":"ses_12369ea4cffePl0BsyVg3hGlmZ","messageID":"msg_edc9615bd002qb49gh9N1krbX2"},"time":1781817287903}}}}
+{"type":"emit_inbound","label":"message.updated.assistant.second-step","frame":{"type":"sdk.event","event":{"id":"evt_edc9624fa002nuPVbTfhxoDpJh","type":"message.updated","properties":{"sessionID":"ses_12369ea4cffePl0BsyVg3hGlmZ","info":{"id":"msg_edc9624fa0015O6R1rRjuqc4uS","parentID":"msg_edc9615bb001iCnWab1qzSeRA3","role":"assistant","mode":"build","agent":"build","path":{"cwd":"/private/tmp/t3-opencode-probe","root":"/"},"cost":0,"tokens":{"input":0,"output":0,"reasoning":0,"cache":{"read":0,"write":0}},"modelID":"gpt-5.4-mini","providerID":"openai","time":{"created":1781817287930},"sessionID":"ses_12369ea4cffePl0BsyVg3hGlmZ"}}}}}
+{"type":"emit_inbound","label":"assistant.completed","frame":{"type":"sdk.event","event":{"id":"evt_edc9628b5001owQkxpRhqtRF5N","type":"message.part.updated","properties":{"sessionID":"ses_12369ea4cffePl0BsyVg3hGlmZ","part":{"id":"prt_edc962867001us1nuabvajQrgu","messageID":"msg_edc9624fa0015O6R1rRjuqc4uS","sessionID":"ses_12369ea4cffePl0BsyVg3hGlmZ","type":"text","text":"plan questions fixture complete","time":{"start":1781817288807,"end":1781817288885}},"time":1781817288885}}}}
+{"type":"emit_inbound","label":"message.updated.assistant.completed","frame":{"type":"sdk.event","event":{"id":"evt_edc9628bf002uUONicDkn1X7YA","type":"message.updated","properties":{"sessionID":"ses_12369ea4cffePl0BsyVg3hGlmZ","info":{"id":"msg_edc9624fa0015O6R1rRjuqc4uS","parentID":"msg_edc9615bb001iCnWab1qzSeRA3","role":"assistant","mode":"build","agent":"build","path":{"cwd":"/private/tmp/t3-opencode-probe","root":"/"},"cost":0,"tokens":{"total":11041,"input":281,"output":8,"reasoning":0,"cache":{"write":0,"read":10752}},"modelID":"gpt-5.4-mini","providerID":"openai","time":{"created":1781817287930,"completed":1781817288895},"sessionID":"ses_12369ea4cffePl0BsyVg3hGlmZ","finish":"stop"}}}}}
+{"type":"emit_inbound","label":"session.status.idle","frame":{"type":"sdk.event","event":{"id":"evt_edc9628c00021lW2ZypKwU71AE","type":"session.status","properties":{"sessionID":"ses_12369ea4cffePl0BsyVg3hGlmZ","status":{"type":"idle"}}}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/proposed_plan/codex_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/proposed_plan/codex_output.ts
new file mode 100644
index 000000000000..935ebf841df1
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/proposed_plan/codex_output.ts
@@ -0,0 +1,38 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertBaseProjection,
+  assertExecutionNodeKinds,
+  assertRunOrdinals,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessagesInclude,
+  assertVisibleTurnItemsMirrorLocalTurnItems,
+  projectionFor,
+  PROPOSED_PLAN_PROMPT,
+} from "../shared.ts";
+
+export function assertProposedPlanOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({ result, transcript, runCount: 1, runStatuses: ["completed"] });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertVisibleTurnItemsMirrorLocalTurnItems(projection);
+  assertRunOrdinals(projection, [1]);
+  assertExecutionNodeKinds(projection, ["root_turn", "plan"]);
+  assertTurnItemTypes(projection, ["user_message", "proposed_plan"]);
+  assertUserMessagesInclude(projection, [PROPOSED_PLAN_PROMPT]);
+
+  const proposedPlans = projection.plans.filter((plan) => plan.kind === "proposed_plan");
+  assert.isAtLeast(proposedPlans.length, 1);
+  assert.include(proposedPlans.at(-1)?.markdown, "Deterministic Replay Fixtures");
+
+  const proposedPlanItems = projection.turnItems.filter((item) => item.type === "proposed_plan");
+  assert.isAtLeast(proposedPlanItems.length, 1);
+  assert.equal(proposedPlanItems.at(-1)?.streaming, false);
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/proposed_plan/codex_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/proposed_plan/codex_transcript.ndjson
new file mode 100644
index 000000000000..a536fec30cf6
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/proposed_plan/codex_transcript.ndjson
@@ -0,0 +1,619 @@
+{"type":"transcript_start","provider":"codex","protocol":"codex.app-server","version":"0.120.0","scenario":"proposed_plan","metadata":{"source":"codex-app-server-probe","fileName":"proposed_plan.ndjson","description":"One plan-mode turn that emits a proposed plan document."}}
+{"type":"expect_outbound","label":"initialize","frame":{"id":1,"method":"initialize","params":{"capabilities":{"experimentalApi":true},"clientInfo":{"name":"t3code_desktop","title":"T3 Code Desktop","version":"0.1.0"}}}}
+{"type":"emit_inbound","label":"initialize","frame":{"id":1,"result":{"userAgent":"t3code_desktop/0.120.0 (Mac OS 26.4.1; arm64) dumb (t3code_desktop; 0.1.0)","codexHome":"/Users/julius/.codex","platformFamily":"unix","platformOs":"macos"}}}
+{"type":"expect_outbound","label":"initialized","frame":{"method":"initialized"}}
+{"type":"expect_outbound","label":"thread/start","frame":{"id":2,"method":"thread/start","params":{}}}
+{"type":"emit_inbound","label":"thread/start","frame":{"id":2,"result":{"thread":{"id":"019db22b-08cd-7e12-b967-cf6ab32dd408","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1776810658,"updatedAt":1776810658,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/04/21/rollout-2026-04-21T15-30-58-019db22b-08cd-7e12-b967-cf6ab32dd408.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","cliVersion":"0.120.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]},"model":"gpt-5.3-codex","modelProvider":"openai","serviceTier":"fast","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","approvalPolicy":"on-request","approvalsReviewer":"user","sandbox":{"type":"workspaceWrite","writableRoots":["/Users/julius/.codex/memories"],"readOnlyAccess":{"type":"fullAccess"},"networkAccess":false,"excludeTmpdirEnvVar":false,"excludeSlashTmp":false},"reasoningEffort":"xhigh"}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":3,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Create a short implementation plan for adding deterministic replay fixtures. Do not ask questions. Present the final plan in a proposed plan block.","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"networkAccess":false,"type":"readOnly"},"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","collaborationMode":{"mode":"plan","settings":{"developer_instructions":"<collaboration_mode># Plan Mode (Conversational)\n\nYou work in 3 phases, and you should *chat your way* to a great plan before finalizing it. A great plan is very detailed-intent- and implementation-wise-so that it can be handed to another engineer or agent to be implemented right away. It must be **decision complete**, where the implementer does not need to make any decisions.\n\n## Mode rules (strict)\n\nYou are in **Plan Mode** until a developer message explicitly ends it.\n\nPlan Mode is not changed by user intent, tone, or imperative language. If a user asks for execution while still in Plan Mode, treat it as a request to **plan the execution**, not perform it.\n\n## Plan Mode vs update_plan tool\n\nPlan Mode is a collaboration mode that can involve requesting user input and eventually issuing a `<proposed_plan>` block.\n\nSeparately, `update_plan` is a checklist/progress/TODOs tool; it does not enter or exit Plan Mode. Do not confuse it with Plan mode or try to use it while in Plan mode. If you try to use `update_plan` in Plan mode, it will return an error.\n\n## Execution vs. mutation in Plan Mode\n\nYou may explore and execute **non-mutating** actions that improve the plan. You must not perform **mutating** actions.\n\n### Allowed (non-mutating, plan-improving)\n\nActions that gather truth, reduce ambiguity, or validate feasibility without changing repo-tracked state. Examples:\n\n* Reading or searching files, configs, schemas, types, manifests, and docs\n* Static analysis, inspection, and repo exploration\n* Dry-run style commands when they do not edit repo-tracked files\n* Tests, builds, or checks that may write to caches or build artifacts (for example, `target/`, `.cache/`, or snapshots) so long as they do not edit repo-tracked files\n\n### Not allowed (mutating, plan-executing)\n\nActions that implement the plan or change repo-tracked state. Examples:\n\n* Editing or writing files\n* Running formatters or linters that rewrite files\n* Applying patches, migrations, or codegen that updates repo-tracked files\n* Side-effectful commands whose purpose is to carry out the plan rather than refine it\n\nWhen in doubt: if the action would reasonably be described as \"doing the work\" rather than \"planning the work,\" do not do it.\n\n## PHASE 1 - Ground in the environment (explore first, ask second)\n\nBegin by grounding yourself in the actual environment. Eliminate unknowns in the prompt by discovering facts, not by asking the user. Resolve all questions that can be answered through exploration or inspection. Identify missing or ambiguous details only if they cannot be derived from the environment. Silent exploration between turns is allowed and encouraged.\n\nBefore asking the user any question, perform at least one targeted non-mutating exploration pass (for example: search relevant files, inspect likely entrypoints/configs, confirm current implementation shape), unless no local environment/repo is available.\n\nException: you may ask clarifying questions about the user's prompt before exploring, ONLY if there are obvious ambiguities or contradictions in the prompt itself. However, if ambiguity might be resolved by exploring, always prefer exploring first.\n\nDo not ask questions that can be answered from the repo or system (for example, \"where is this struct?\" or \"which UI component should we use?\" when exploration can make it clear). Only ask once you have exhausted reasonable non-mutating exploration.\n\n## PHASE 2 - Intent chat (what they actually want)\n\n* Keep asking until you can clearly state: goal + success criteria, audience, in/out of scope, constraints, current state, and the key preferences/tradeoffs.\n* Bias toward questions over guessing: if any high-impact ambiguity remains, do NOT plan yet-ask.\n\n## PHASE 3 - Implementation chat (what/how we'll build)\n\n* Once intent is stable, keep asking until the spec is decision complete: approach, interfaces (APIs/schemas/I/O), data flow, edge cases/failure modes, testing + acceptance criteria, rollout/monitoring, and any migrations/compat constraints.\n\n## Asking questions\n\nCritical rules:\n\n* Strongly prefer using the `request_user_input` tool to ask any questions.\n* Offer only meaningful multiple-choice options; don't include filler choices that are obviously wrong or irrelevant.\n* In rare cases where an unavoidable, important question can't be expressed with reasonable multiple-choice options (due to extreme ambiguity), you may ask it directly without the tool.\n\nYou SHOULD ask many questions, but each question must:\n\n* materially change the spec/plan, OR\n* confirm/lock an assumption, OR\n* choose between meaningful tradeoffs.\n* not be answerable by non-mutating commands.\n\nUse the `request_user_input` tool only for decisions that materially change the plan, for confirming important assumptions, or for information that cannot be discovered via non-mutating exploration.\n\n## Two kinds of unknowns (treat differently)\n\n1. **Discoverable facts** (repo/system truth): explore first.\n\n   * Before asking, run targeted searches and check likely sources of truth (configs/manifests/entrypoints/schemas/types/constants).\n   * Ask only if: multiple plausible candidates; nothing found but you need a missing identifier/context; or ambiguity is actually product intent.\n   * If asking, present concrete candidates (paths/service names) + recommend one.\n   * Never ask questions you can answer from your environment (e.g., \"where is this struct\").\n\n2. **Preferences/tradeoffs** (not discoverable): ask early.\n\n   * These are intent or implementation preferences that cannot be derived from exploration.\n   * Provide 2-4 mutually exclusive options + a recommended default.\n   * If unanswered, proceed with the recommended option and record it as an assumption in the final plan.\n\n## Finalization rule\n\nOnly output the final plan when it is decision complete and leaves no decisions to the implementer.\n\nWhen you present the official plan, wrap it in a `<proposed_plan>` block so the client can render it specially:\n\n1) The opening tag must be on its own line.\n2) Start the plan content on the next line (no text on the same line as the tag).\n3) The closing tag must be on its own line.\n4) Use Markdown inside the block.\n5) Keep the tags exactly as `<proposed_plan>` and `</proposed_plan>` (do not translate or rename them), even if the plan content is in another language.\n\nExample:\n\n<proposed_plan>\nplan content\n</proposed_plan>\n\nplan content should be human and agent digestible. The final plan must be plan-only and include:\n\n* A clear title\n* A brief summary section\n* Important changes or additions to public APIs/interfaces/types\n* Test cases and scenarios\n* Explicit assumptions and defaults chosen where needed\n\nDo not ask \"should I proceed?\" in the final output. The user can easily switch out of Plan mode and request implementation if you have included a `<proposed_plan>` block in your response. Alternatively, they can decide to stay in Plan mode and continue refining the plan.\n\nOnly produce at most one `<proposed_plan>` block per turn, and only when you are presenting a complete spec.\n</collaboration_mode>","model":"gpt-5.4","reasoning_effort":"medium"}},"approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"thread/started","frame":{"method":"thread/started","params":{"thread":{"id":"019db22b-08cd-7e12-b967-cf6ab32dd408","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1776810658,"updatedAt":1776810658,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/04/21/rollout-2026-04-21T15-30-58-019db22b-08cd-7e12-b967-cf6ab32dd408.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","cliVersion":"0.120.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]}}}}
+{"type":"emit_inbound","label":"deprecationNotice","frame":{"method":"deprecationNotice","params":{"summary":"`[features].collab` is deprecated. Use `[features].multi_agent` instead.","details":"Enable it with `--enable multi_agent` or `[features].multi_agent` in config.toml. See https://developers.openai.com/codex/config-basic#feature-flags for details."}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":3,"result":{"turn":{"id":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","items":[],"status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turn":{"id":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","items":[],"status":"inProgress","error":null,"startedAt":1776810658,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"ab25b70d-641e-4c17-af07-1c8d78d88b0a","content":[{"type":"text","text":"Create a short implementation plan for adding deterministic replay fixtures. Do not ask questions. Present the final plan in a proposed plan block.","text_elements":[]}]},"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"ab25b70d-641e-4c17-af07-1c8d78d88b0a","content":[{"type":"text","text":"Create a short implementation plan for adding deterministic replay fixtures. Do not ask questions. Present the final plan in a proposed plan block.","text_elements":[]}]},"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04"}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":1,"windowDurationMins":300,"resetsAt":1776821038},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777407838},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"reasoning","id":"rs_0b2955d3a75fd8630169e7faa644c08199bc55546beda2214b","summary":[],"content":[]},"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"reasoning","id":"rs_0b2955d3a75fd8630169e7faa644c08199bc55546beda2214b","summary":[],"content":[]},"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_0b2955d3a75fd8630169e7faa6b5208199bd94e7bea8298058","text":"","phase":"commentary","memoryCitation":null},"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faa6b5208199bd94e7bea8298058","delta":"I"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faa6b5208199bd94e7bea8298058","delta":"’ll"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faa6b5208199bd94e7bea8298058","delta":" ground"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faa6b5208199bd94e7bea8298058","delta":" the"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faa6b5208199bd94e7bea8298058","delta":" plan"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faa6b5208199bd94e7bea8298058","delta":" in"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faa6b5208199bd94e7bea8298058","delta":" the"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faa6b5208199bd94e7bea8298058","delta":" package"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faa6b5208199bd94e7bea8298058","delta":" structure"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faa6b5208199bd94e7bea8298058","delta":" first"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faa6b5208199bd94e7bea8298058","delta":","}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faa6b5208199bd94e7bea8298058","delta":" then"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faa6b5208199bd94e7bea8298058","delta":" produce"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faa6b5208199bd94e7bea8298058","delta":" a"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faa6b5208199bd94e7bea8298058","delta":" concise"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faa6b5208199bd94e7bea8298058","delta":" decision"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faa6b5208199bd94e7bea8298058","delta":"-com"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faa6b5208199bd94e7bea8298058","delta":"plete"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faa6b5208199bd94e7bea8298058","delta":" implementation"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faa6b5208199bd94e7bea8298058","delta":" plan"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faa6b5208199bd94e7bea8298058","delta":" without"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faa6b5208199bd94e7bea8298058","delta":" questions"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faa6b5208199bd94e7bea8298058","delta":"."}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_0b2955d3a75fd8630169e7faa6b5208199bd94e7bea8298058","text":"I’ll ground the plan in the package structure first, then produce a concise decision-complete implementation plan without questions.","phase":"commentary","memoryCitation":null},"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","tokenUsage":{"total":{"totalTokens":26377,"inputTokens":26138,"cachedInputTokens":15744,"outputTokens":239,"reasoningOutputTokens":33},"last":{"totalTokens":26377,"inputTokens":26138,"cachedInputTokens":15744,"outputTokens":239,"reasoningOutputTokens":33},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":1,"windowDurationMins":300,"resetsAt":1776821038},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777407838},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"commandExecution","id":"call_tEQUu764R8mtF1ZCsFOt2XaV","command":"/bin/zsh -lc 'find .. -name AGENTS.md -print'","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","processId":"55615","source":"unifiedExecStartup","status":"inProgress","commandActions":[{"type":"search","command":"find .. -name AGENTS.md -print","query":"AGENTS.md","path":".."}],"aggregatedOutput":null,"exitCode":null,"durationMs":null},"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"commandExecution","id":"call_eyjz6BPmvc8LMkoXbSFsGlAw","command":"/bin/zsh -lc \"pwd && rg --files | sed -n '1,120p'\"","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","processId":"17756","source":"unifiedExecStartup","status":"inProgress","commandActions":[{"type":"unknown","command":"pwd && rg --files | sed -n '1,120p'"}],"aggregatedOutput":null,"exitCode":null,"durationMs":null},"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"commandExecution","id":"call_tEQUu764R8mtF1ZCsFOt2XaV","command":"/bin/zsh -lc 'find .. -name AGENTS.md -print'","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","processId":"55615","source":"unifiedExecStartup","status":"completed","commandActions":[{"type":"search","command":"find .. -name AGENTS.md -print","query":"AGENTS.md","path":".."}],"aggregatedOutput":null,"exitCode":0,"durationMs":0},"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"commandExecution","id":"call_eyjz6BPmvc8LMkoXbSFsGlAw","command":"/bin/zsh -lc \"pwd && rg --files | sed -n '1,120p'\"","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","processId":"17756","source":"unifiedExecStartup","status":"completed","commandActions":[{"type":"unknown","command":"pwd && rg --files | sed -n '1,120p'"}],"aggregatedOutput":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server\nsrc/_generated/namespaces.gen.ts\nsrc/_generated/schema.gen.ts\nsrc/_generated/meta.gen.ts\nsrc/client.test.ts\nsrc/replay.test.ts\nsrc/protocol.ts\nsrc/client.ts\nsrc/replay.ts\nsrc/rpc.ts\nsrc/errors.ts\nsrc/_internal/shared.ts\nsrc/_internal/stdio.ts\nsrc/schema.ts\nsrc/protocol.test.ts\ntsconfig.json\nscripts/generate.ts\npackage.json\ntest/fixtures/codex-app-server-mock-peer.ts\ntest/fixtures/codex-app-server-probes/tool_call_read_only_on_request.ndjson\ntest/fixtures/codex-app-server-probes/thread_rollback.ndjson\ntest/fixtures/codex-app-server-probes/simple.ndjson\ntest/fixtures/codex-app-server-probes/todo_list.ndjson\ntest/fixtures/codex-app-server-probes/plan_questions.ndjson\ntest/fixtures/codex-app-server-probes/turn_interrupt.ndjson\ntest/fixtures/codex-app-server-probes/tool_call_restricted_granular.ndjson\ntest/fixtures/codex-app-server-probes/multi_turn.ndjson\ntest/fixtures/codex-app-server-probes/proposed_plan.ndjson\ntest/fixtures/codex-app-server-probes/message_steering.ndjson\ntest/fixtures/codex-app-server-probes/subagent.ndjson\ntest/fixtures/codex-app-server-probes/tool_call_workspace_never.ndjson\ntest/examples/codex-app-server-probe.ts\n","exitCode":0,"durationMs":0},"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"reasoning","id":"rs_0b2955d3a75fd8630169e7faaa1df08199b13b72cd3ef95057","summary":[],"content":[]},"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"reasoning","id":"rs_0b2955d3a75fd8630169e7faaa1df08199b13b72cd3ef95057","summary":[],"content":[]},"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","text":"","phase":"commentary","memoryCitation":null},"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":"The"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":" package"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":" already"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":" has"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":" replay"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":"-oriented"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":" code"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":" and"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":" probe"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":" ND"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":"JSON"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":" fixtures"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":","}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":" so"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":" I"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":"’m"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":" checking"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":" those"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":" shapes"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":" to"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":" make"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":" the"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":" plan"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":" target"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":" the"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":" existing"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":" abstra"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":"ctions"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":" rather"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":" than"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":" invent"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":" a"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":" parallel"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":" fixture"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":" system"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","delta":"."}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_0b2955d3a75fd8630169e7faaa89188199b0743576f83c9470","text":"The package already has replay-oriented code and probe NDJSON fixtures, so I’m checking those shapes to make the plan target the existing abstractions rather than invent a parallel fixture system.","phase":"commentary","memoryCitation":null},"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","tokenUsage":{"total":{"totalTokens":53584,"inputTokens":52954,"cachedInputTokens":41728,"outputTokens":630,"reasoningOutputTokens":43},"last":{"totalTokens":27207,"inputTokens":26816,"cachedInputTokens":25984,"outputTokens":391,"reasoningOutputTokens":10},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":1,"windowDurationMins":300,"resetsAt":1776821038},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777407838},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"commandExecution","id":"call_0B2ieGRdMDXmQA8peWORTcTz","command":"/bin/zsh -lc \"sed -n '1,220p' src/replay.ts && printf '\\\\n--- replay.test ---\\\\n' && sed -n '1,240p' src/replay.test.ts\"","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","processId":"16103","source":"unifiedExecStartup","status":"inProgress","commandActions":[{"type":"read","command":"sed -n '1,220p' src/replay.ts","name":"replay.ts","path":"src/replay.ts"},{"type":"read","command":"sed -n '1,240p' src/replay.test.ts","name":"replay.test.ts","path":"src/replay.test.ts"}],"aggregatedOutput":null,"exitCode":null,"durationMs":null},"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"commandExecution","id":"call_A9NEOfTYCCXkUPLqxfWsCNE5","command":"/bin/zsh -lc \"cat package.json && printf '\\\\n--- protocol ---\\\\n' && sed -n '1,220p' src/protocol.ts\"","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","processId":"24242","source":"unifiedExecStartup","status":"inProgress","commandActions":[{"type":"read","command":"cat package.json","name":"package.json","path":"package.json"},{"type":"read","command":"sed -n '1,220p' src/protocol.ts","name":"protocol.ts","path":"src/protocol.ts"}],"aggregatedOutput":null,"exitCode":null,"durationMs":null},"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"commandExecution","id":"call_yp787C983Bb0Klnj9F8zRBDd","command":"/bin/zsh -lc \"sed -n '1,220p' test/fixtures/codex-app-server-mock-peer.ts && printf '\\\\n--- sample fixture ---\\\\n' && sed -n '1,80p' test/fixtures/codex-app-server-probes/simple.ndjson\"","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","processId":"80213","source":"unifiedExecStartup","status":"inProgress","commandActions":[{"type":"read","command":"sed -n '1,220p' test/fixtures/codex-app-server-mock-peer.ts","name":"codex-app-server-mock-peer.ts","path":"test/fixtures/codex-app-server-mock-peer.ts"},{"type":"read","command":"sed -n '1,80p' test/fixtures/codex-app-server-probes/simple.ndjson","name":"simple.ndjson","path":"test/fixtures/codex-app-server-probes/simple.ndjson"}],"aggregatedOutput":null,"exitCode":null,"durationMs":null},"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"commandExecution","id":"call_A9NEOfTYCCXkUPLqxfWsCNE5","command":"/bin/zsh -lc \"cat package.json && printf '\\\\n--- protocol ---\\\\n' && sed -n '1,220p' src/protocol.ts\"","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","processId":"24242","source":"unifiedExecStartup","status":"completed","commandActions":[{"type":"read","command":"cat package.json","name":"package.json","path":"package.json"},{"type":"read","command":"sed -n '1,220p' src/protocol.ts","name":"protocol.ts","path":"src/protocol.ts"}],"aggregatedOutput":"{\n  \"name\": \"effect-codex-app-server\",\n  \"private\": true,\n  \"type\": \"module\",\n  \"exports\": {\n    \"./client\": {\n      \"types\": \"./src/client.ts\",\n      \"import\": \"./src/client.ts\"\n    },\n    \"./schema\": {\n      \"types\": \"./src/schema.ts\",\n      \"import\": \"./src/schema.ts\"\n    },\n    \"./rpc\": {\n      \"types\": \"./src/rpc.ts\",\n      \"import\": \"./src/rpc.ts\"\n    },\n    \"./protocol\": {\n      \"types\": \"./src/protocol.ts\",\n      \"import\": \"./src/protocol.ts\"\n    },\n    \"./replay\": {\n      \"types\": \"./src/replay.ts\",\n      \"import\": \"./src/replay.ts\"\n    },\n    \"./errors\": {\n      \"types\": \"./src/errors.ts\",\n      \"import\": \"./src/errors.ts\"\n    }\n  },\n  \"scripts\": {\n    \"dev\": \"tsdown src/client.ts src/rpc.ts src/protocol.ts src/schema.ts --format esm,cjs --dts --watch --clean\",\n    \"build\": \"tsdown src/client.ts src/rpc.ts src/protocol.ts src/schema.ts --format esm,cjs --dts --clean\",\n    \"prepare\": \"effect-language-service patch\",\n    \"typecheck\": \"tsc --noEmit\",\n    \"test\": \"vitest run\",\n    \"generate\": \"bun run scripts/generate.ts\",\n    \"probe\": \"bun run test/examples/codex-app-server-probe.ts\"\n  },\n  \"dependencies\": {\n    \"effect\": \"catalog:\"\n  },\n  \"devDependencies\": {\n    \"@effect/language-service\": \"catalog:\",\n    \"@effect/openapi-generator\": \"catalog:\",\n    \"@effect/platform-node\": \"catalog:\",\n    \"@effect/vitest\": \"catalog:\",\n    \"tsdown\": \"catalog:\",\n    \"typescript\": \"catalog:\",\n    \"vitest\": \"catalog:\"\n  }\n}\n\n--- protocol ---\nimport * as Cause from \"effect/Cause\";\nimport * as Deferred from \"effect/Deferred\";\nimport * as Effect from \"effect/Effect\";\nimport * as Queue from \"effect/Queue\";\nimport * as Ref from \"effect/Ref\";\nimport * as Scope from \"effect/Scope\";\nimport * as Schema from \"effect/Schema\";\nimport * as Stdio from \"effect/Stdio\";\nimport * as Stream from \"effect/Stream\";\n\nimport * as CodexError from \"./errors.ts\";\nimport { JsonRpcId, JsonRpcResponseEnvelope } from \"./_internal/shared.ts\";\n\nexport interface CodexAppServerProtocolLogEvent {\n  readonly direction: \"incoming\" | \"outgoing\";\n  readonly stage: \"raw\" | \"decoded\" | \"decode_failed\";\n  readonly payload: unknown;\n}\n\nexport interface CodexAppServerIncomingNotification {\n  readonly method: string;\n  readonly params?: unknown;\n}\n\nexport interface CodexAppServerIncomingRequest {\n  readonly id: string | number;\n  readonly method: string;\n  readonly params?: unknown;\n}\n\nexport interface CodexAppServerPatchedProtocolOptions {\n  readonly stdio: Stdio.Stdio;\n  readonly terminationError?: Effect.Effect<CodexError.CodexAppServerError>;\n  readonly logIncoming?: boolean;\n  readonly logOutgoing?: boolean;\n  readonly logger?: (event: CodexAppServerProtocolLogEvent) => Effect.Effect<void, never>;\n  readonly onNotification?: (\n    notification: CodexAppServerIncomingNotification,\n  ) => Effect.Effect<void, never>;\n  readonly onRequest?: (\n    request: CodexAppServerIncomingRequest,\n  ) => Effect.Effect<unknown, CodexError.CodexAppServerError>;\n  readonly onTermination?: (error: CodexError.CodexAppServerError) => Effect.Effect<void, never>;\n}\n\nexport interface CodexAppServerPatchedProtocol {\n  readonly incomingNotifications: Stream.Stream<CodexAppServerIncomingNotification>;\n  readonly incomingRequests: Stream.Stream<CodexAppServerIncomingRequest>;\n  readonly request: (\n    method: string,\n    payload?: unknown,\n  ) => Effect.Effect<unknown, CodexError.CodexAppServerError>;\n  readonly notify: (\n    method: string,\n    payload?: unknown,\n  ) => Effect.Effect<void, CodexError.CodexAppServerError>;\n  readonly respond: (\n    requestId: string | number,\n    result: unknown,\n  ) => Effect.Effect<void, CodexError.CodexAppServerError>;\n  readonly respondError: (\n    requestId: string | number,\n    error: CodexError.CodexAppServerRequestError,\n  ) => Effect.Effect<void, CodexError.CodexAppServerError>;\n}\n\nfunction isObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction isIncomingRequest(value: unknown): value is CodexAppServerIncomingRequest {\n  if (!isObject(value) || typeof value.method !== \"string\") {\n    return false;\n  }\n  return Schema.is(JsonRpcId)(value.id);\n}\n\nfunction isIncomingNotification(value: unknown): value is CodexAppServerIncomingNotification {\n  return isObject(value) && typeof value.method === \"string\" && !(\"id\" in value);\n}\n\nfunction isIncomingResponse(value: unknown): value is typeof JsonRpcResponseEnvelope.Type {\n  return Schema.is(JsonRpcResponseEnvelope)(value);\n}\n\nconst encodeWireMessage = (\n  message: Record<string, unknown>,\n): Effect.Effect<string, CodexError.CodexAppServerProtocolParseError> =>\n  Effect.try({\n    try: () => `${JSON.stringify(message)}\\n`,\n    catch: (cause) =>\n      new CodexError.CodexAppServerProtocolParseError({\n        detail: \"Failed to encode Codex App Server message\",\n        cause,\n      }),\n  });\n\nconst normalizeIncomingError = (error: unknown, detail: string): CodexError.CodexAppServerError =>\n  Schema.is(CodexError.CodexAppServerError)(error)\n    ? error\n    : new CodexError.CodexAppServerTransportError({\n        detail,\n        cause: error,\n      });\n\nconst toProtocolMessage = (\n  requestId: string | number,\n  fields: {\n    readonly result?: unknown;\n    readonly error?: CodexError.CodexAppServerProtocolErrorShape;\n  },\n): { readonly [key: string]: unknown } => ({\n  id: requestId,\n  ...(fields.result !== undefined ? { result: fields.result } : {}),\n  ...(fields.error !== undefined ? { error: fields.error } : {}),\n});\n\nexport const makeCodexAppServerPatchedProtocol = Effect.fn(\"makeCodexAppServerPatchedProtocol\")(\n  function* (\n    options: CodexAppServerPatchedProtocolOptions,\n  ): Effect.fn.Return<CodexAppServerPatchedProtocol, never, Scope.Scope> {\n    const outgoing = yield* Queue.unbounded<string, Cause.Done<void>>();\n    const incomingNotifications = yield* Queue.unbounded<CodexAppServerIncomingNotification>();\n    const incomingRequests = yield* Queue.unbounded<CodexAppServerIncomingRequest>();\n    const pending = yield* Ref.make(\n      new Map<string, Deferred.Deferred<unknown, CodexError.CodexAppServerError>>(),\n    );\n    const nextRequestId = yield* Ref.make(1);\n    const remainder = yield* Ref.make(\"\");\n    const terminationHandled = yield* Ref.make(false);\n\n    const logProtocol = (event: CodexAppServerProtocolLogEvent) => {\n      if (event.direction === \"incoming\" && !options.logIncoming) {\n        return Effect.void;\n      }\n      if (event.direction === \"outgoing\" && !options.logOutgoing) {\n        return Effect.void;\n      }\n      return (\n        options.logger?.(event) ??\n        Effect.logDebug(\"Codex App Server protocol event\").pipe(Effect.annotateLogs({ event }))\n      );\n    };\n\n    const failAllPending = (error: CodexError.CodexAppServerError) =>\n      Ref.get(pending).pipe(\n        Effect.flatMap((current) =>\n          Effect.forEach([...current.values()], (deferred) => Deferred.fail(deferred, error), {\n            discard: true,\n          }),\n        ),\n        Effect.andThen(Ref.set(pending, new Map())),\n      );\n\n    const handleTermination = (classify: () => Effect.Effect<CodexError.CodexAppServerError>) =>\n      Ref.modify(terminationHandled, (handled) => {\n        if (handled) {\n          return [Effect.void, true] as const;\n        }\n        return [\n          Effect.gen(function* () {\n            const error = yield* classify();\n            yield* failAllPending(error);\n            yield* Queue.end(outgoing);\n            if (options.onTermination) {\n              yield* options.onTermination(error);\n            }\n          }),\n          true,\n        ] as const;\n      }).pipe(Effect.flatten);\n\n    const offerOutgoing = (message: Record<string, unknown>) =>\n      Effect.gen(function* () {\n        yield* logProtocol({\n          direction: \"outgoing\",\n          stage: \"decoded\",\n          payload: message,\n        });\n        const encoded = yield* encodeWireMessage(message);\n        yield* logProtocol({\n          direction: \"outgoing\",\n          stage: \"raw\",\n          payload: encoded,\n        });\n        yield* Queue.offer(outgoing, encoded).pipe(Effect.asVoid);\n      });\n\n    const removePending = (requestId: string) =>\n      Ref.update(pending, (current) => {\n        if (!current.has(requestId)) {\n          return current;\n        }\n        const next = new Map(current);\n        next.delete(requestId);\n        return next;\n      });\n\n    const resolvePending = (\n      requestId: string,\n      handler: (\n        deferred: Deferred.Deferred<unknown, CodexError.CodexAppServerError>,\n      ) => Effect.Effect<void>,\n    ) =>\n      Ref.modify(pending, (current) => {\n        const deferred = current.get(requestId);\n        if (!deferred) {\n          return [Effect.void, current] as const;\n        }\n        const next = new Map(current);\n        next.delete(requestId);\n        return [handler(deferred), next] as const;\n      }).pipe(Effect.flatten);\n\n    const respond = (requestId: string | number, result: unknown) =>\n      offerOutgoing(toProtocolMessage(requestId, { result }));\n\n    const respondError = (\n      requestId: string | number,\n      error: CodexError.CodexAppServerRequestError,\n","exitCode":0,"durationMs":0},"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"commandExecution","id":"call_0B2ieGRdMDXmQA8peWORTcTz","command":"/bin/zsh -lc \"sed -n '1,220p' src/replay.ts && printf '\\\\n--- replay.test ---\\\\n' && sed -n '1,240p' src/replay.test.ts\"","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","processId":"16103","source":"unifiedExecStartup","status":"completed","commandActions":[{"type":"read","command":"sed -n '1,220p' src/replay.ts","name":"replay.ts","path":"src/replay.ts"},{"type":"read","command":"sed -n '1,240p' src/replay.test.ts","name":"replay.test.ts","path":"src/replay.test.ts"}],"aggregatedOutput":"import * as Cause from \"effect/Cause\";\nimport * as Duration from \"effect/Duration\";\nimport * as Effect from \"effect/Effect\";\nimport * as Layer from \"effect/Layer\";\nimport * as Queue from \"effect/Queue\";\nimport * as Ref from \"effect/Ref\";\nimport * as Schema from \"effect/Schema\";\nimport * as Sink from \"effect/Sink\";\nimport * as Stdio from \"effect/Stdio\";\nimport * as Stream from \"effect/Stream\";\n\nimport { CodexAppServerClient } from \"./client.ts\";\nimport * as CodexClient from \"./client.ts\";\nimport * as CodexError from \"./errors.ts\";\n\nexport const CodexAppServerReplayEntry = Schema.Union([\n  Schema.Struct({\n    type: Schema.Literal(\"expect_outbound\"),\n    label: Schema.optional(Schema.String),\n    frame: Schema.Unknown,\n  }),\n  Schema.Struct({\n    type: Schema.Literal(\"emit_inbound\"),\n    label: Schema.optional(Schema.String),\n    frame: Schema.Unknown,\n    afterMs: Schema.optional(Schema.Number),\n  }),\n  Schema.Struct({\n    type: Schema.Literal(\"runtime_exit\"),\n    status: Schema.Literals([\"success\", \"error\", \"cancelled\"]),\n    error: Schema.optional(Schema.Unknown),\n  }),\n]);\nexport type CodexAppServerReplayEntry = typeof CodexAppServerReplayEntry.Type;\n\nexport const CodexAppServerReplayTranscript = Schema.Struct({\n  driver: Schema.Literal(\"codex\"),\n  protocol: Schema.Literal(\"codex.app-server\"),\n  version: Schema.String,\n  scenario: Schema.String,\n  metadata: Schema.optional(Schema.Record(Schema.String, Schema.Unknown)),\n  entries: Schema.Array(CodexAppServerReplayEntry),\n});\nexport type CodexAppServerReplayTranscript = typeof CodexAppServerReplayTranscript.Type;\n\nexport class CodexAppServerReplayJsonParseError extends Schema.TaggedErrorClass<CodexAppServerReplayJsonParseError>()(\n  \"CodexAppServerReplayJsonParseError\",\n  {\n    scenario: Schema.String,\n    line: Schema.String,\n    cause: Schema.Defect,\n  },\n) {\n  override get message(): string {\n    return `Failed to parse outbound Codex app-server replay frame for scenario ${this.scenario}.`;\n  }\n}\n\nexport class CodexAppServerReplayExhaustedError extends Schema.TaggedErrorClass<CodexAppServerReplayExhaustedError>()(\n  \"CodexAppServerReplayExhaustedError\",\n  {\n    scenario: Schema.String,\n    cursor: Schema.Number,\n    actual: Schema.Unknown,\n  },\n) {\n  override get message(): string {\n    return `Codex app-server replay transcript exhausted before outbound frame ${this.cursor} in scenario ${this.scenario}.`;\n  }\n}\n\nexport class CodexAppServerReplayUnexpectedOutboundError extends Schema.TaggedErrorClass<CodexAppServerReplayUnexpectedOutboundError>()(\n  \"CodexAppServerReplayUnexpectedOutboundError\",\n  {\n    scenario: Schema.String,\n    cursor: Schema.Number,\n    expectedType: Schema.String,\n    actual: Schema.Unknown,\n  },\n) {\n  override get message(): string {\n    return `Unexpected outbound Codex app-server frame at replay cursor ${this.cursor} in scenario ${this.scenario}.`;\n  }\n}\n\nexport class CodexAppServerReplayFrameMismatchError extends Schema.TaggedErrorClass<CodexAppServerReplayFrameMismatchError>()(\n  \"CodexAppServerReplayFrameMismatchError\",\n  {\n    scenario: Schema.String,\n    cursor: Schema.Number,\n    label: Schema.optional(Schema.String),\n    expected: Schema.Unknown,\n    actual: Schema.Unknown,\n  },\n) {\n  override get message(): string {\n    return `Outbound Codex app-server frame did not match replay cursor ${this.cursor} in scenario ${this.scenario}.`;\n  }\n}\n\nexport class CodexAppServerReplayRuntimeExitError extends Schema.TaggedErrorClass<CodexAppServerReplayRuntimeExitError>()(\n  \"CodexAppServerReplayRuntimeExitError\",\n  {\n    scenario: Schema.String,\n    cursor: Schema.Number,\n    status: Schema.Literals([\"error\", \"cancelled\"]),\n    error: Schema.optional(Schema.Unknown),\n  },\n) {\n  override get message(): string {\n    return `Codex app-server replay exited with status ${this.status} at cursor ${this.cursor} in scenario ${this.scenario}.`;\n  }\n}\n\nexport class CodexAppServerReplayIncompleteError extends Schema.TaggedErrorClass<CodexAppServerReplayIncompleteError>()(\n  \"CodexAppServerReplayIncompleteError\",\n  {\n    scenario: Schema.String,\n    cursor: Schema.Number,\n    remaining: Schema.Number,\n  },\n) {\n  override get message(): string {\n    return `Codex app-server replay ended with ${this.remaining} unconsumed entries in scenario ${this.scenario}.`;\n  }\n}\n\nexport const CodexAppServerReplayError = Schema.Union([\n  CodexAppServerReplayJsonParseError,\n  CodexAppServerReplayExhaustedError,\n  CodexAppServerReplayUnexpectedOutboundError,\n  CodexAppServerReplayFrameMismatchError,\n  CodexAppServerReplayRuntimeExitError,\n  CodexAppServerReplayIncompleteError,\n]);\nexport type CodexAppServerReplayError = typeof CodexAppServerReplayError.Type;\n\nexport interface CodexAppServerReplayState {\n  readonly cursor: number;\n  readonly failure: CodexAppServerReplayError | null;\n}\n\nexport interface CodexAppServerReplayDriver {\n  readonly transcript: CodexAppServerReplayTranscript;\n  readonly state: Ref.Ref<CodexAppServerReplayState>;\n}\n\nconst encoder = new TextEncoder();\nconst decoder = new TextDecoder();\n\nfunction stableStringify(value: unknown): string {\n  if (Array.isArray(value)) {\n    return `[${value.map(stableStringify).join(\",\")}]`;\n  }\n  if (typeof value === \"object\" && value !== null) {\n    const record = value as Record<string, unknown>;\n    return `{${Object.keys(record)\n      .toSorted()\n      .map((key) => `${JSON.stringify(key)}:${stableStringify(record[key])}`)\n      .join(\",\")}}`;\n  }\n  return JSON.stringify(value);\n}\n\nfunction normalizeReplayFrame(value: unknown): unknown {\n  if (typeof value !== \"object\" || value === null) {\n    return value;\n  }\n  if (Array.isArray(value)) {\n    return value.map(normalizeReplayFrame);\n  }\n\n  const record = value as Record<string, unknown>;\n  const normalized = Object.fromEntries(\n    Object.entries(record).map(([key, entry]) => [key, normalizeReplayFrame(entry)]),\n  );\n\n  if (\n    normalized.method === \"initialize\" &&\n    typeof normalized.params === \"object\" &&\n    normalized.params !== null\n  ) {\n    const params = normalized.params as Record<string, unknown>;\n    if (typeof params.clientInfo === \"object\" && params.clientInfo !== null) {\n      normalized.params = {\n        ...params,\n        clientInfo: {\n          ...(params.clientInfo as Record<string, unknown>),\n          version: \"<ignored>\",\n        },\n      };\n    }\n  }\n\n  return normalized;\n}\n\nfunction sameFrame(left: unknown, right: unknown): boolean {\n  return (\n    stableStringify(normalizeReplayFrame(left)) === stableStringify(normalizeReplayFrame(right))\n  );\n}\n\nfunction encodeInboundFrame(frame: unknown): Uint8Array {\n  return encoder.encode(`${JSON.stringify(frame)}\\n`);\n}\n\nfunction replayTransportError(\n  transcript: CodexAppServerReplayTranscript,\n  error: CodexAppServerReplayError,\n): CodexError.CodexAppServerTransportError {\n  return new CodexError.CodexAppServerTransportError({\n    detail: error.message,\n    cause: error,\n  });\n}\n\nexport function layerReplay(\n  transcript: CodexAppServerReplayTranscript,\n): Layer.Layer<CodexAppServerClient, CodexAppServerReplayError> {\n\n--- replay.test ---\nimport * as Exit from \"effect/Exit\";\nimport * as Effect from \"effect/Effect\";\nimport * as Layer from \"effect/Layer\";\nimport * as Schema from \"effect/Schema\";\nimport * as Scope from \"effect/Scope\";\n\nimport { assert, it } from \"@effect/vitest\";\n\nimport * as CodexClient from \"./client.ts\";\nimport * as CodexError from \"./errors.ts\";\nimport * as CodexReplay from \"./replay.ts\";\n\nconst initializeParams = {\n  clientInfo: {\n    name: \"effect-codex-app-server-test\",\n    title: \"Effect Codex App Server Test\",\n    version: \"0.0.0\",\n  },\n  capabilities: {\n    experimentalApi: true,\n    optOutNotificationMethods: null,\n  },\n} as const;\n\nconst initializeResponse = {\n  userAgent: \"replay-codex-app-server\",\n  codexHome: \"/tmp/codex-home\",\n  platformFamily: \"unix\",\n  platformOs: \"macos\",\n} as const;\n\nfunction buildContext(transcript: CodexReplay.CodexAppServerReplayTranscript) {\n  return Effect.gen(function* () {\n    const scope = yield* Scope.make();\n    const context = yield* Layer.buildWithScope(CodexReplay.layerReplay(transcript), scope);\n    return { context, scope };\n  });\n}\n\nit.effect(\"replays Codex app-server frames through the real client protocol\", () =>\n  Effect.gen(function* () {\n    const { context, scope } = yield* buildContext({\n      driver: \"codex\",\n      protocol: \"codex.app-server\",\n      version: \"test\",\n      scenario: \"initialize\",\n      entries: [\n        {\n          type: \"expect_outbound\",\n          label: \"initialize\",\n          frame: {\n            id: 1,\n            method: \"initialize\",\n            params: {\n              ...initializeParams,\n              clientInfo: {\n                ...initializeParams.clientInfo,\n                version: \"older-fixture-version\",\n              },\n            },\n          },\n        },\n        {\n          type: \"emit_inbound\",\n          label: \"initialize\",\n          frame: {\n            id: 1,\n            result: initializeResponse,\n          },\n        },\n        {\n          type: \"expect_outbound\",\n          label: \"initialized\",\n          frame: {\n            method: \"initialized\",\n          },\n        },\n        {\n          type: \"runtime_exit\",\n          status: \"success\",\n        },\n      ],\n    });\n\n    yield* Effect.gen(function* () {\n      const client = yield* CodexClient.CodexAppServerClient;\n      assert.deepEqual(yield* client.request(\"initialize\", initializeParams), initializeResponse);\n      yield* client.notify(\"initialized\", undefined);\n    }).pipe(Effect.provide(context), Effect.ensuring(Scope.close(scope, Exit.void)));\n  }),\n);\n\nit.effect(\"fails pending client requests with a schema-serializable replay mismatch\", () =>\n  Effect.gen(function* () {\n    const { context, scope } = yield* buildContext({\n      driver: \"codex\",\n      protocol: \"codex.app-server\",\n      version: \"test\",\n      scenario: \"mismatch\",\n      entries: [\n        {\n          type: \"expect_outbound\",\n          label: \"initialize\",\n          frame: {\n            id: 1,\n            method: \"initialize\",\n            params: initializeParams,\n          },\n        },\n        {\n          type: \"runtime_exit\",\n          status: \"success\",\n        },\n      ],\n    });\n\n    const error = yield* Effect.gen(function* () {\n      const client = yield* CodexClient.CodexAppServerClient;\n      return yield* client.request(\"account/read\", {});\n    }).pipe(Effect.provide(context), Effect.flip, Effect.ensuring(Scope.close(scope, Exit.void)));\n\n    assert.equal(error._tag, \"CodexAppServerTransportError\");\n    if (!Schema.is(CodexError.CodexAppServerTransportError)(error)) {\n      throw new Error(\"Expected transport error.\");\n    }\n\n    const replayError = Schema.decodeUnknownSync(CodexReplay.CodexAppServerReplayError)(\n      error.cause,\n    );\n    const encoded = Schema.encodeUnknownSync(CodexReplay.CodexAppServerReplayError)(replayError);\n\n    assert.equal(encoded._tag, \"CodexAppServerReplayFrameMismatchError\");\n    if (encoded._tag !== \"CodexAppServerReplayFrameMismatchError\") {\n      throw new Error(\"Expected frame mismatch error.\");\n    }\n    assert.equal(encoded.scenario, \"mismatch\");\n    assert.equal(encoded.cursor, 0);\n    assert.deepEqual(encoded.actual, {\n      id: 1,\n      method: \"account/read\",\n      params: {},\n    });\n  }),\n);\n","exitCode":0,"durationMs":0},"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"commandExecution","id":"call_yp787C983Bb0Klnj9F8zRBDd","command":"/bin/zsh -lc \"sed -n '1,220p' test/fixtures/codex-app-server-mock-peer.ts && printf '\\\\n--- sample fixture ---\\\\n' && sed -n '1,80p' test/fixtures/codex-app-server-probes/simple.ndjson\"","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","processId":"80213","source":"unifiedExecStartup","status":"completed","commandActions":[{"type":"read","command":"sed -n '1,220p' test/fixtures/codex-app-server-mock-peer.ts","name":"codex-app-server-mock-peer.ts","path":"test/fixtures/codex-app-server-mock-peer.ts"},{"type":"read","command":"sed -n '1,80p' test/fixtures/codex-app-server-probes/simple.ndjson","name":"simple.ndjson","path":"test/fixtures/codex-app-server-probes/simple.ndjson"}],"aggregatedOutput":"let nextServerRequestId = 10_000;\nlet pendingSkillsListRequestId: number | string | null = null;\nlet pendingUserInputRequestId: number | null = null;\n\nconst writeMessage = (message: unknown) => {\n  process.stdout.write(`${JSON.stringify(message)}\\n`);\n};\n\nconst respond = (id: number | string, result: unknown) => {\n  writeMessage({ id, result });\n};\n\nconst respondError = (id: number | string, code: number, message: string) => {\n  writeMessage({\n    id,\n    error: {\n      code,\n      message,\n    },\n  });\n};\n\nconst sendRequest = (method: string, params: unknown) => {\n  const id = nextServerRequestId++;\n  writeMessage({ id, method, params });\n  return id;\n};\n\nconst handleMethod = (message: Record<string, unknown>) => {\n  const method = message.method;\n  if (typeof method !== \"string\") {\n    return;\n  }\n\n  switch (method) {\n    case \"initialize\": {\n      respond(message.id as number | string, {\n        userAgent: \"mock-codex-app-server\",\n        codexHome: process.cwd(),\n        platformFamily: process.platform === \"win32\" ? \"windows\" : \"unix\",\n        platformOs: process.platform === \"darwin\" ? \"macos\" : process.platform,\n      });\n      return;\n    }\n    case \"initialized\": {\n      writeMessage({\n        method: \"item/agentMessage/delta\",\n        params: {\n          delta: \"Mock server is ready.\",\n          itemId: \"item-1\",\n          threadId: \"thread-1\",\n          turnId: \"turn-1\",\n        },\n      });\n      return;\n    }\n    case \"account/read\": {\n      respond(message.id as number | string, {\n        account: {\n          type: \"chatgpt\",\n          email: \"mock@example.com\",\n          planType: \"plus\",\n        },\n        requiresOpenaiAuth: false,\n      });\n      return;\n    }\n    case \"skills/list\": {\n      pendingSkillsListRequestId = message.id as number | string;\n      pendingUserInputRequestId = sendRequest(\"item/tool/requestUserInput\", {\n        itemId: \"item-approval-1\",\n        threadId: \"thread-1\",\n        turnId: \"turn-1\",\n        questions: [\n          {\n            id: \"approved\",\n            header: \"Approve\",\n            question: \"Continue with the mock skills request?\",\n            options: [\n              {\n                label: \"yes\",\n                description: \"Approve the request\",\n              },\n            ],\n          },\n        ],\n      });\n      return;\n    }\n    default: {\n      if (message.id !== undefined) {\n        respondError(message.id as number | string, -32601, `Unhandled request: ${method}`);\n      }\n    }\n  }\n};\n\nconst handleResponse = (message: Record<string, unknown>) => {\n  if (message.id !== pendingUserInputRequestId) {\n    return;\n  }\n\n  pendingUserInputRequestId = null;\n\n  respond(pendingSkillsListRequestId!, {\n    data: [\n      {\n        cwd: process.cwd(),\n        errors: [],\n        skills: [],\n      },\n    ],\n  });\n  pendingSkillsListRequestId = null;\n};\n\nlet remainder = \"\";\n\nprocess.stdin.setEncoding(\"utf8\");\nprocess.stdin.on(\"data\", (chunk) => {\n  remainder += chunk;\n  const lines = remainder.split(\"\\n\");\n  remainder = lines.pop() ?? \"\";\n\n  for (const line of lines) {\n    const trimmed = line.trim();\n    if (trimmed.length === 0) {\n      continue;\n    }\n\n    const message = JSON.parse(trimmed) as Record<string, unknown>;\n    if (\"method\" in message) {\n      handleMethod(message);\n      continue;\n    }\n    if (\"id\" in message) {\n      handleResponse(message);\n    }\n  }\n});\n\nprocess.stdin.on(\"end\", () => {\n  process.exit(0);\n});\n\n--- sample fixture ---\n{\"type\":\"transcript_start\",\"provider\":\"codex\",\"protocol\":\"codex.app-server\",\"version\":\"0.120.0\",\"scenario\":\"simple\",\"metadata\":{\"source\":\"codex-app-server-probe\",\"fileName\":\"simple.ndjson\",\"description\":\"One thread and one turn with a deterministic text-only response.\"}}\n{\"type\":\"expect_outbound\",\"label\":\"initialize\",\"frame\":{\"id\":1,\"method\":\"initialize\",\"params\":{\"capabilities\":{\"experimentalApi\":true,\"optOutNotificationMethods\":null},\"clientInfo\":{\"name\":\"effect-codex-app-server-probe\",\"title\":\"Effect Codex App Server Probe\",\"version\":\"0.0.0\"}}}}\n{\"type\":\"emit_inbound\",\"label\":\"initialize\",\"frame\":{\"id\":1,\"result\":{\"userAgent\":\"effect-codex-app-server-probe/0.120.0 (Mac OS 26.4.1; arm64) dumb (effect-codex-app-server-probe; 0.0.0)\",\"codexHome\":\"/Users/julius/.codex\",\"platformFamily\":\"unix\",\"platformOs\":\"macos\"}}}\n{\"type\":\"expect_outbound\",\"label\":\"initialized\",\"frame\":{\"method\":\"initialized\"}}\n{\"type\":\"expect_outbound\",\"label\":\"thread/start\",\"frame\":{\"id\":2,\"method\":\"thread/start\",\"params\":{}}}\n{\"type\":\"emit_inbound\",\"label\":\"thread/start\",\"frame\":{\"id\":2,\"result\":{\"thread\":{\"id\":\"019dad19-92e1-7460-8c82-034802b2a6cc\",\"forkedFromId\":null,\"preview\":\"\",\"ephemeral\":false,\"modelProvider\":\"openai\",\"createdAt\":1776725627,\"updatedAt\":1776725627,\"status\":{\"type\":\"idle\"},\"path\":\"/Users/julius/.codex/sessions/2026/04/20/rollout-2026-04-20T15-53-47-019dad19-92e1-7460-8c82-034802b2a6cc.jsonl\",\"cwd\":\"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server\",\"cliVersion\":\"0.120.0\",\"source\":\"vscode\",\"agentNickname\":null,\"agentRole\":null,\"gitInfo\":null,\"name\":null,\"turns\":[]},\"model\":\"gpt-5.4\",\"modelProvider\":\"openai\",\"serviceTier\":\"fast\",\"cwd\":\"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server\",\"approvalPolicy\":\"on-request\",\"approvalsReviewer\":\"user\",\"sandbox\":{\"type\":\"workspaceWrite\",\"writableRoots\":[\"/Users/julius/.codex/memories\"],\"readOnlyAccess\":{\"type\":\"fullAccess\"},\"networkAccess\":false,\"excludeTmpdirEnvVar\":false,\"excludeSlashTmp\":false},\"reasoningEffort\":\"xhigh\"}}}\n{\"type\":\"expect_outbound\",\"label\":\"turn/start\",\"frame\":{\"id\":3,\"method\":\"turn/start\",\"params\":{\"input\":[{\"text\":\"Respond with the following text: fixture simple ok\",\"type\":\"text\"}],\"threadId\":\"019dad19-92e1-7460-8c82-034802b2a6cc\"}}}\n{\"type\":\"emit_inbound\",\"label\":\"thread/started\",\"frame\":{\"method\":\"thread/started\",\"params\":{\"thread\":{\"id\":\"019dad19-92e1-7460-8c82-034802b2a6cc\",\"forkedFromId\":null,\"preview\":\"\",\"ephemeral\":false,\"modelProvider\":\"openai\",\"createdAt\":1776725627,\"updatedAt\":1776725627,\"status\":{\"type\":\"idle\"},\"path\":\"/Users/julius/.codex/sessions/2026/04/20/rollout-2026-04-20T15-53-47-019dad19-92e1-7460-8c82-034802b2a6cc.jsonl\",\"cwd\":\"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server\",\"cliVersion\":\"0.120.0\",\"source\":\"vscode\",\"agentNickname\":null,\"agentRole\":null,\"gitInfo\":null,\"name\":null,\"turns\":[]}}}}\n{\"type\":\"emit_inbound\",\"label\":\"deprecationNotice\",\"frame\":{\"method\":\"deprecationNotice\",\"params\":{\"summary\":\"`[features].collab` is deprecated. Use `[features].multi_agent` instead.\",\"details\":\"Enable it with `--enable multi_agent` or `[features].multi_agent` in config.toml. See https://developers.openai.com/codex/config-basic#feature-flags for details.\"}}}\n{\"type\":\"emit_inbound\",\"label\":\"mcpServer/startupStatus/updated\",\"frame\":{\"method\":\"mcpServer/startupStatus/updated\",\"params\":{\"name\":\"codex_apps\",\"status\":\"starting\",\"error\":null}}}\n{\"type\":\"emit_inbound\",\"label\":\"mcpServer/startupStatus/updated\",\"frame\":{\"method\":\"mcpServer/startupStatus/updated\",\"params\":{\"name\":\"uidotsh\",\"status\":\"starting\",\"error\":null}}}\n{\"type\":\"emit_inbound\",\"label\":\"turn/start\",\"frame\":{\"id\":3,\"result\":{\"turn\":{\"id\":\"019dad19-92ef-7e13-b919-c01c6abf3d0c\",\"items\":[],\"status\":\"inProgress\",\"error\":null,\"startedAt\":null,\"completedAt\":null,\"durationMs\":null}}}}\n{\"type\":\"emit_inbound\",\"label\":\"thread/status/changed\",\"frame\":{\"method\":\"thread/status/changed\",\"params\":{\"threadId\":\"019dad19-92e1-7460-8c82-034802b2a6cc\",\"status\":{\"type\":\"active\",\"activeFlags\":[]}}}}\n{\"type\":\"emit_inbound\",\"label\":\"turn/started\",\"frame\":{\"method\":\"turn/started\",\"params\":{\"threadId\":\"019dad19-92e1-7460-8c82-034802b2a6cc\",\"turn\":{\"id\":\"019dad19-92ef-7e13-b919-c01c6abf3d0c\",\"items\":[],\"status\":\"inProgress\",\"error\":null,\"startedAt\":1776725627,\"completedAt\":null,\"durationMs\":null}}}}\n{\"type\":\"emit_inbound\",\"label\":\"mcpServer/startupStatus/updated\",\"frame\":{\"method\":\"mcpServer/startupStatus/updated\",\"params\":{\"name\":\"codex_apps\",\"status\":\"ready\",\"error\":null}}}\n{\"type\":\"emit_inbound\",\"label\":\"mcpServer/startupStatus/updated\",\"frame\":{\"method\":\"mcpServer/startupStatus/updated\",\"params\":{\"name\":\"uidotsh\",\"status\":\"ready\",\"error\":null}}}\n{\"type\":\"emit_inbound\",\"label\":\"item/started\",\"frame\":{\"method\":\"item/started\",\"params\":{\"item\":{\"type\":\"userMessage\",\"id\":\"28c8a871-c12e-4d6a-af88-7a53c03b748e\",\"content\":[{\"type\":\"text\",\"text\":\"Respond with the following text: fixture simple ok\",\"text_elements\":[]}]},\"threadId\":\"019dad19-92e1-7460-8c82-034802b2a6cc\",\"turnId\":\"019dad19-92ef-7e13-b919-c01c6abf3d0c\"}}}\n{\"type\":\"emit_inbound\",\"label\":\"item/completed\",\"frame\":{\"method\":\"item/completed\",\"params\":{\"item\":{\"type\":\"userMessage\",\"id\":\"28c8a871-c12e-4d6a-af88-7a53c03b748e\",\"content\":[{\"type\":\"text\",\"text\":\"Respond with the following text: fixture simple ok\",\"text_elements\":[]}]},\"threadId\":\"019dad19-92e1-7460-8c82-034802b2a6cc\",\"turnId\":\"019dad19-92ef-7e13-b919-c01c6abf3d0c\"}}}\n{\"type\":\"emit_inbound\",\"label\":\"account/rateLimits/updated\",\"frame\":{\"method\":\"account/rateLimits/updated\",\"params\":{\"rateLimits\":{\"limitId\":\"codex\",\"limitName\":null,\"primary\":{\"usedPercent\":0,\"windowDurationMins\":300,\"resetsAt\":1776738279},\"secondary\":{\"usedPercent\":34,\"windowDurationMins\":10080,\"resetsAt\":1776893129},\"credits\":null,\"planType\":\"pro\"}}}}\n{\"type\":\"emit_inbound\",\"label\":\"item/started\",\"frame\":{\"method\":\"item/started\",\"params\":{\"item\":{\"type\":\"reasoning\",\"id\":\"rs_0e6f3b2a309a10b40169e6ae80f20c819bbe4ad96641fe124e\",\"summary\":[],\"content\":[]},\"threadId\":\"019dad19-92e1-7460-8c82-034802b2a6cc\",\"turnId\":\"019dad19-92ef-7e13-b919-c01c6abf3d0c\"}}}\n{\"type\":\"emit_inbound\",\"label\":\"item/completed\",\"frame\":{\"method\":\"item/completed\",\"params\":{\"item\":{\"type\":\"reasoning\",\"id\":\"rs_0e6f3b2a309a10b40169e6ae80f20c819bbe4ad96641fe124e\",\"summary\":[],\"content\":[]},\"threadId\":\"019dad19-92e1-7460-8c82-034802b2a6cc\",\"turnId\":\"019dad19-92ef-7e13-b919-c01c6abf3d0c\"}}}\n{\"type\":\"emit_inbound\",\"label\":\"item/started\",\"frame\":{\"method\":\"item/started\",\"params\":{\"item\":{\"type\":\"agentMessage\",\"id\":\"msg_0e6f3b2a309a10b40169e6ae814a88819bb76ddc2495f25a5a\",\"text\":\"\",\"phase\":\"final_answer\",\"memoryCitation\":null},\"threadId\":\"019dad19-92e1-7460-8c82-034802b2a6cc\",\"turnId\":\"019dad19-92ef-7e13-b919-c01c6abf3d0c\"}}}\n{\"type\":\"emit_inbound\",\"label\":\"item/agentMessage/delta\",\"frame\":{\"method\":\"item/agentMessage/delta\",\"params\":{\"threadId\":\"019dad19-92e1-7460-8c82-034802b2a6cc\",\"turnId\":\"019dad19-92ef-7e13-b919-c01c6abf3d0c\",\"itemId\":\"msg_0e6f3b2a309a10b40169e6ae814a88819bb76ddc2495f25a5a\",\"delta\":\"fixture\"}}}\n{\"type\":\"emit_inbound\",\"label\":\"item/agentMessage/delta\",\"frame\":{\"method\":\"item/agentMessage/delta\",\"params\":{\"threadId\":\"019dad19-92e1-7460-8c82-034802b2a6cc\",\"turnId\":\"019dad19-92ef-7e13-b919-c01c6abf3d0c\",\"itemId\":\"msg_0e6f3b2a309a10b40169e6ae814a88819bb76ddc2495f25a5a\",\"delta\":\" simple\"}}}\n{\"type\":\"emit_inbound\",\"label\":\"item/agentMessage/delta\",\"frame\":{\"method\":\"item/agentMessage/delta\",\"params\":{\"threadId\":\"019dad19-92e1-7460-8c82-034802b2a6cc\",\"turnId\":\"019dad19-92ef-7e13-b919-c01c6abf3d0c\",\"itemId\":\"msg_0e6f3b2a309a10b40169e6ae814a88819bb76ddc2495f25a5a\",\"delta\":\" ok\"}}}\n{\"type\":\"emit_inbound\",\"label\":\"item/completed\",\"frame\":{\"method\":\"item/completed\",\"params\":{\"item\":{\"type\":\"agentMessage\",\"id\":\"msg_0e6f3b2a309a10b40169e6ae814a88819bb76ddc2495f25a5a\",\"text\":\"fixture simple ok\",\"phase\":\"final_answer\",\"memoryCitation\":null},\"threadId\":\"019dad19-92e1-7460-8c82-034802b2a6cc\",\"turnId\":\"019dad19-92ef-7e13-b919-c01c6abf3d0c\"}}}\n{\"type\":\"emit_inbound\",\"label\":\"thread/tokenUsage/updated\",\"frame\":{\"method\":\"thread/tokenUsage/updated\",\"params\":{\"threadId\":\"019dad19-92e1-7460-8c82-034802b2a6cc\",\"turnId\":\"019dad19-92ef-7e13-b919-c01c6abf3d0c\",\"tokenUsage\":{\"total\":{\"totalTokens\":28263,\"inputTokens\":28223,\"cachedInputTokens\":28032,\"outputTokens\":40,\"reasoningOutputTokens\":31},\"last\":{\"totalTokens\":28263,\"inputTokens\":28223,\"cachedInputTokens\":28032,\"outputTokens\":40,\"reasoningOutputTokens\":31},\"modelContextWindow\":258400}}}}\n{\"type\":\"emit_inbound\",\"label\":\"account/rateLimits/updated\",\"frame\":{\"method\":\"account/rateLimits/updated\",\"params\":{\"rateLimits\":{\"limitId\":\"codex\",\"limitName\":null,\"primary\":{\"usedPercent\":0,\"windowDurationMins\":300,\"resetsAt\":1776738279},\"secondary\":{\"usedPercent\":34,\"windowDurationMins\":10080,\"resetsAt\":1776893129},\"credits\":null,\"planType\":\"pro\"}}}}\n{\"type\":\"emit_inbound\",\"label\":\"thread/status/changed\",\"frame\":{\"method\":\"thread/status/changed\",\"params\":{\"threadId\":\"019dad19-92e1-7460-8c82-034802b2a6cc\",\"status\":{\"type\":\"idle\"}}}}\n{\"type\":\"emit_inbound\",\"label\":\"turn/completed\",\"frame\":{\"method\":\"turn/completed\",\"params\":{\"threadId\":\"019dad19-92e1-7460-8c82-034802b2a6cc\",\"turn\":{\"id\":\"019dad19-92ef-7e13-b919-c01c6abf3d0c\",\"items\":[],\"status\":\"completed\",\"error\":null,\"startedAt\":1776725627,\"completedAt\":1776725633,\"durationMs\":5852}}}}\n{\"type\":\"runtime_exit\",\"status\":\"success\"}\n","exitCode":0,"durationMs":0},"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"reasoning","id":"rs_0b2955d3a75fd8630169e7fab1e01481999f57bbddc11af4b5","summary":[],"content":[]},"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"reasoning","id":"rs_0b2955d3a75fd8630169e7fab1e01481999f57bbddc11af4b5","summary":[],"content":[]},"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","tokenUsage":{"total":{"totalTokens":89827,"inputTokens":89103,"cachedInputTokens":68224,"outputTokens":724,"reasoningOutputTokens":53},"last":{"totalTokens":36243,"inputTokens":36149,"cachedInputTokens":26496,"outputTokens":94,"reasoningOutputTokens":10},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":1,"windowDurationMins":300,"resetsAt":1776821038},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777407838},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"commandExecution","id":"call_2fPDBzc8uv95TwAdZy6xNyRd","command":"/bin/zsh -lc \"sed -n '120,360p' src/replay.ts\"","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","processId":"40798","source":"unifiedExecStartup","status":"inProgress","commandActions":[{"type":"read","command":"sed -n '120,360p' src/replay.ts","name":"replay.ts","path":"src/replay.ts"}],"aggregatedOutput":null,"exitCode":null,"durationMs":null},"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"commandExecution","id":"call_2fPDBzc8uv95TwAdZy6xNyRd","command":"/bin/zsh -lc \"sed -n '120,360p' src/replay.ts\"","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","processId":"40798","source":"unifiedExecStartup","status":"completed","commandActions":[{"type":"read","command":"sed -n '120,360p' src/replay.ts","name":"replay.ts","path":"src/replay.ts"}],"aggregatedOutput":"    remaining: Schema.Number,\n  },\n) {\n  override get message(): string {\n    return `Codex app-server replay ended with ${this.remaining} unconsumed entries in scenario ${this.scenario}.`;\n  }\n}\n\nexport const CodexAppServerReplayError = Schema.Union([\n  CodexAppServerReplayJsonParseError,\n  CodexAppServerReplayExhaustedError,\n  CodexAppServerReplayUnexpectedOutboundError,\n  CodexAppServerReplayFrameMismatchError,\n  CodexAppServerReplayRuntimeExitError,\n  CodexAppServerReplayIncompleteError,\n]);\nexport type CodexAppServerReplayError = typeof CodexAppServerReplayError.Type;\n\nexport interface CodexAppServerReplayState {\n  readonly cursor: number;\n  readonly failure: CodexAppServerReplayError | null;\n}\n\nexport interface CodexAppServerReplayDriver {\n  readonly transcript: CodexAppServerReplayTranscript;\n  readonly state: Ref.Ref<CodexAppServerReplayState>;\n}\n\nconst encoder = new TextEncoder();\nconst decoder = new TextDecoder();\n\nfunction stableStringify(value: unknown): string {\n  if (Array.isArray(value)) {\n    return `[${value.map(stableStringify).join(\",\")}]`;\n  }\n  if (typeof value === \"object\" && value !== null) {\n    const record = value as Record<string, unknown>;\n    return `{${Object.keys(record)\n      .toSorted()\n      .map((key) => `${JSON.stringify(key)}:${stableStringify(record[key])}`)\n      .join(\",\")}}`;\n  }\n  return JSON.stringify(value);\n}\n\nfunction normalizeReplayFrame(value: unknown): unknown {\n  if (typeof value !== \"object\" || value === null) {\n    return value;\n  }\n  if (Array.isArray(value)) {\n    return value.map(normalizeReplayFrame);\n  }\n\n  const record = value as Record<string, unknown>;\n  const normalized = Object.fromEntries(\n    Object.entries(record).map(([key, entry]) => [key, normalizeReplayFrame(entry)]),\n  );\n\n  if (\n    normalized.method === \"initialize\" &&\n    typeof normalized.params === \"object\" &&\n    normalized.params !== null\n  ) {\n    const params = normalized.params as Record<string, unknown>;\n    if (typeof params.clientInfo === \"object\" && params.clientInfo !== null) {\n      normalized.params = {\n        ...params,\n        clientInfo: {\n          ...(params.clientInfo as Record<string, unknown>),\n          version: \"<ignored>\",\n        },\n      };\n    }\n  }\n\n  return normalized;\n}\n\nfunction sameFrame(left: unknown, right: unknown): boolean {\n  return (\n    stableStringify(normalizeReplayFrame(left)) === stableStringify(normalizeReplayFrame(right))\n  );\n}\n\nfunction encodeInboundFrame(frame: unknown): Uint8Array {\n  return encoder.encode(`${JSON.stringify(frame)}\\n`);\n}\n\nfunction replayTransportError(\n  transcript: CodexAppServerReplayTranscript,\n  error: CodexAppServerReplayError,\n): CodexError.CodexAppServerTransportError {\n  return new CodexError.CodexAppServerTransportError({\n    detail: error.message,\n    cause: error,\n  });\n}\n\nexport function layerReplay(\n  transcript: CodexAppServerReplayTranscript,\n): Layer.Layer<CodexAppServerClient, CodexAppServerReplayError> {\n  return Layer.effect(CodexAppServerClient, makeReplayClient(transcript));\n}\n\nexport const makeReplayDriver = Effect.fn(\"effect-codex-app-server/replay.makeReplayDriver\")(\n  function* (transcript: CodexAppServerReplayTranscript) {\n    return {\n      transcript,\n      state: yield* Ref.make<CodexAppServerReplayState>({ cursor: 0, failure: null }),\n    } satisfies CodexAppServerReplayDriver;\n  },\n);\n\nexport function layerReplayWithDriver(\n  driver: CodexAppServerReplayDriver,\n): Layer.Layer<CodexAppServerClient, CodexAppServerReplayError> {\n  return Layer.effect(CodexAppServerClient, makeReplayClientWithState(driver));\n}\n\nexport const makeReplayClient = Effect.fn(\"effect-codex-app-server/replay.makeReplayClient\")(\n  function* (\n    transcript: CodexAppServerReplayTranscript,\n    options: CodexClient.CodexAppServerClientOptions = {},\n  ) {\n    const driver = yield* makeReplayDriver(transcript);\n    return yield* makeReplayClientWithState(driver, options);\n  },\n);\n\nconst makeReplayClientWithState = Effect.fn(\n  \"effect-codex-app-server/replay.makeReplayClientWithState\",\n)(function* (\n  driver: CodexAppServerReplayDriver,\n  options: CodexClient.CodexAppServerClientOptions = {},\n) {\n  const transcript = driver.transcript;\n  const input = yield* Queue.unbounded<Uint8Array, Cause.Done<void>>();\n  const state = driver.state;\n  const outboundRemainder = yield* Ref.make(\"\");\n\n  const failReplay = (error: CodexAppServerReplayError) =>\n    Ref.update(state, (current) => ({\n      ...current,\n      failure: current.failure ?? error,\n    })).pipe(Effect.andThen(Queue.end(input)));\n\n  const drainInbound = Effect.fn(\"effect-codex-app-server/replay.drainInbound\")(function* () {\n    while (true) {\n      const current = yield* Ref.get(state);\n      if (current.failure) {\n        return;\n      }\n\n      const entry = transcript.entries[current.cursor];\n      if (!entry) {\n        return;\n      }\n\n      if (entry.type === \"emit_inbound\") {\n        if (entry.afterMs !== undefined && entry.afterMs > 0) {\n          yield* Effect.sleep(Duration.millis(entry.afterMs));\n        }\n        yield* Queue.offer(input, encodeInboundFrame(entry.frame));\n        yield* Ref.update(state, (latest) => ({ ...latest, cursor: latest.cursor + 1 }));\n        continue;\n      }\n\n      if (entry.type === \"runtime_exit\") {\n        yield* Ref.update(state, (latest) => ({ ...latest, cursor: latest.cursor + 1 }));\n        if (entry.status === \"success\") {\n          yield* Queue.end(input);\n          return;\n        }\n        yield* failReplay(\n          new CodexAppServerReplayRuntimeExitError({\n            scenario: transcript.scenario,\n            cursor: current.cursor,\n            status: entry.status,\n            ...(entry.error === undefined ? {} : { error: entry.error }),\n          }),\n        );\n        return;\n      }\n\n      return;\n    }\n  });\n\n  const processOutboundFrame = (actual: unknown) =>\n    drainInbound().pipe(\n      Effect.andThen(\n        Effect.gen(function* () {\n          const current = yield* Ref.get(state);\n          if (current.failure) {\n            return;\n          }\n\n          const entry = transcript.entries[current.cursor];\n          if (!entry) {\n            yield* failReplay(\n              new CodexAppServerReplayExhaustedError({\n                scenario: transcript.scenario,\n                cursor: current.cursor,\n                actual,\n              }),\n            );\n            return;\n          }\n\n          if (entry.type !== \"expect_outbound\") {\n            yield* failReplay(\n              new CodexAppServerReplayUnexpectedOutboundError({\n                scenario: transcript.scenario,\n                cursor: current.cursor,\n                expectedType: entry.type,\n                actual,\n              }),\n            );\n            return;\n          }\n\n          if (!sameFrame(entry.frame, actual)) {\n            yield* failReplay(\n              new CodexAppServerReplayFrameMismatchError({\n                scenario: transcript.scenario,\n                cursor: current.cursor,\n                ...(entry.label === undefined ? {} : { label: entry.label }),\n                expected: entry.frame,\n                actual,\n              }),\n            );\n            return;\n          }\n\n          yield* Ref.update(state, (latest) => ({ ...latest, cursor: latest.cursor + 1 }));\n          yield* drainInbound();\n        }),\n      ),\n    );\n\n  const processOutboundLine = (line: string) => {\n","exitCode":0,"durationMs":0},"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","tokenUsage":{"total":{"totalTokens":127847,"inputTokens":127041,"cachedInputTokens":103936,"outputTokens":806,"reasoningOutputTokens":53},"last":{"totalTokens":38020,"inputTokens":37938,"cachedInputTokens":35712,"outputTokens":82,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":1,"windowDurationMins":300,"resetsAt":1776821038},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777407838},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"commandExecution","id":"call_WeQ2VXeRTLB3MyVSeGxPdVda","command":"/bin/zsh -lc \"sed -n '360,720p' src/replay.ts\"","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","processId":"73456","source":"unifiedExecStartup","status":"inProgress","commandActions":[{"type":"read","command":"sed -n '360,720p' src/replay.ts","name":"replay.ts","path":"src/replay.ts"}],"aggregatedOutput":null,"exitCode":null,"durationMs":null},"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"commandExecution","id":"call_WeQ2VXeRTLB3MyVSeGxPdVda","command":"/bin/zsh -lc \"sed -n '360,720p' src/replay.ts\"","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","processId":"73456","source":"unifiedExecStartup","status":"completed","commandActions":[{"type":"read","command":"sed -n '360,720p' src/replay.ts","name":"replay.ts","path":"src/replay.ts"}],"aggregatedOutput":"  const processOutboundLine = (line: string) => {\n    const trimmed = line.trim();\n    if (trimmed.length === 0) {\n      return Effect.void;\n    }\n    return Effect.try({\n      try: () => JSON.parse(trimmed),\n      catch: (cause) =>\n        new CodexAppServerReplayJsonParseError({\n          scenario: transcript.scenario,\n          line: trimmed,\n          cause,\n        }),\n    }).pipe(\n      Effect.matchEffect({\n        onFailure: failReplay,\n        onSuccess: processOutboundFrame,\n      }),\n    );\n  };\n\n  const processOutboundChunk = (chunk: string | Uint8Array) =>\n    Ref.modify(outboundRemainder, (current) => {\n      const text = typeof chunk === \"string\" ? chunk : decoder.decode(chunk, { stream: true });\n      const combined = current + text;\n      const lines = combined.split(\"\\n\");\n      const nextRemainder = lines.pop() ?? \"\";\n      return [lines.map((line) => line.replace(/\\r$/, \"\")), nextRemainder] as const;\n    }).pipe(\n      Effect.flatMap((lines) => Effect.forEach(lines, processOutboundLine, { discard: true })),\n    );\n\n  const terminationError: Effect.Effect<CodexError.CodexAppServerError> = Ref.get(state).pipe(\n    Effect.map((current) =>\n      current.failure\n        ? replayTransportError(transcript, current.failure)\n        : new CodexError.CodexAppServerProcessExitedError({ code: 0 }),\n    ),\n  );\n\n  const stdio = Stdio.make({\n    args: Effect.succeed([]),\n    stdin: Stream.fromQueue(input),\n    stdout: () => Sink.forEach(processOutboundChunk),\n    stderr: () => Sink.drain,\n  });\n\n  yield* drainInbound();\n\n  return yield* CodexClient.make(stdio, options, terminationError);\n});\n","exitCode":0,"durationMs":0},"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"reasoning","id":"rs_0b2955d3a75fd8630169e7fab6175881998551059b68f6c342","summary":[],"content":[]},"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"reasoning","id":"rs_0b2955d3a75fd8630169e7fab6175881998551059b68f6c342","summary":[],"content":[]},"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"plan","id":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","text":""},"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"#"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" Determ"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"in"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"istic"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" Replay"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" Fixtures"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"\n\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"##"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" Summary"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Add"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" first"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"-class"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" deterministic"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" replay"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" fixture"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" support"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" to"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" `"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"packages"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"/e"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"ffect"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"-c"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"od"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"ex"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"-app"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"-server"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"`"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" by"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" loading"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" existing"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" ND"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"JSON"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" probe"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" transcripts"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" into"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" the"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" current"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" `"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Cod"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"ex"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"App"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Server"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Replay"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Transcript"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"`"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" model"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" and"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" validating"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" them"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" through"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" the"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" real"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" replay"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" client"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":".\n\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"##"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" Implementation"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"1"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"."}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" Add"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" a"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" fixture"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" loader"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" module"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":","}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" likely"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" `"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"src"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"/re"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"play"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Fixtures"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":".ts"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"`.\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"2"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"."}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" Parse"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" ND"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"JSON"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" fixtures"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" with"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":":\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"   -"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" first"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" line"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":":"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" `"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"trans"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"cript"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"_start"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"`\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"   -"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" remaining"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" lines"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":":"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" replay"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" entries"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" already"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" compatible"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" with"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" `"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Cod"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"ex"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"App"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Server"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Replay"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Entry"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"`\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"3"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"."}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" Convert"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" each"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" file"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" into"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" `"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Cod"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"ex"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"App"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Server"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Replay"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Transcript"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"`.\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"4"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"."}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" Validate"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" all"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" lines"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" through"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" Effect"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" Schema"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":","}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" returning"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" schema"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"-"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"serial"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"izable"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" errors"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" with"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" file"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" path"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":","}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" line"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" number"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":","}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" scenario"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":","}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" and"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" parse"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"/schema"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" cause"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":".\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"5"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"."}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" Export"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" fixture"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" helpers"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" from"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" `"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"package"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":".json"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"`"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" as"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" `"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"./"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"re"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"play"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"-fi"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"xtures"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"`.\n\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"##"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" Public"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" API"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Add"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":":\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"```"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"ts"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"load"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Replay"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Fixture"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"(path"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":":"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" string"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"):"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" Effect"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":".E"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"ffect"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"<C"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"od"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"ex"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"App"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Server"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Replay"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Transcript"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":","}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" Replay"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Fixture"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Error"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":">\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"load"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Replay"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Fixtures"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"(dir"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":":"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" string"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"):"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" Effect"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":".E"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"ffect"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"<Readonly"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Array"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"<C"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"od"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"ex"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"App"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Server"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Replay"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Transcript"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":">,"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" Replay"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Fixture"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Error"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":">\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"``"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"`\n\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Add"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" error"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" types"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":":\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"```"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"ts"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Replay"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Fixture"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Read"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Error"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Replay"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Fixture"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Json"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Parse"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Error"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Replay"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Fixture"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Schema"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Error"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Replay"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Fixture"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Empty"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Error"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Replay"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Fixture"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Missing"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Transcript"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Start"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Error"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"``"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"`\n\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"##"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" Tests"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Add"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" tests"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" covering"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":":\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"1"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"."}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" `"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"simple"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":".nd"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"json"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"`"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" loads"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" into"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" a"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" valid"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" transcript"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":".\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"2"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"."}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" Loaded"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" `"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"simple"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":".nd"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"json"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"`"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" re"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"plays"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" successfully"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" through"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" `"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"layer"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Replay"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"`.\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"3"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"."}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" Mal"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"formed"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" JSON"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" reports"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" file"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" and"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" line"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" number"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":".\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"4"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"."}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" Missing"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" `"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"trans"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"cript"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"_start"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"`"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" fails"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" determin"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"istically"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":".\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"5"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"."}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" Invalid"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" entry"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" shape"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" fails"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" schema"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" validation"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":".\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"6"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"."}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" Fixture"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" loading"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" preserves"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" entry"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" order"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" exactly"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":".\n\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"##"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" Determ"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"in"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"ism"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" Rules"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"1"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"."}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" Do"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" not"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" rewrite"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" existing"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" fixture"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" contents"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" during"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" replay"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":".\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"2"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"."}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" Keep"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" normalization"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" limited"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" to"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" existing"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" replay"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" comparison"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" logic"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":".\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"3"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"."}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" Fixture"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" loader"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" must"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" not"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" depend"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" on"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" wall"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"-clock"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" time"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":","}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" current"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" cwd"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":","}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" network"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":","}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" or"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" process"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" environment"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" except"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" the"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" explicit"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" file"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" path"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" input"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":".\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"4"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"."}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" Fixture"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" order"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" from"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" directory"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" loading"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" should"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" be"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" lex"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"ic"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"ographic"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" by"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" filename"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":".\n\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"##"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" Verification"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"Run"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" before"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" completion"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":":\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"```"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"sh"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"bun"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" fmt"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"bun"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" lint"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"bun"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" type"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"check"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"bun"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" run"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" test"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"``"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"`\n\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"##"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" Ass"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"um"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"ptions"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"1"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"."}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" Existing"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" `"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"test"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"/"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"fixtures"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"/c"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"od"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"ex"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"-app"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"-server"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"-pro"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"bes"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"/*."}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"nd"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"json"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"`"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" files"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" are"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" the"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" canonical"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" initial"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" deterministic"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" fixture"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" corpus"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":".\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"2"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"."}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" The"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" current"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" replay"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" engine"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" remains"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" responsible"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" for"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" protocol"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"-level"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" matching"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":".\n"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"3"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"."}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" Fixture"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" support"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" is"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" package"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"-local"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" and"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" should"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" not"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" introduce"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" runtime"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" logic"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" into"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" contracts"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":"/shared"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":" packages"}}}
+{"type":"emit_inbound","label":"item/plan/delta","frame":{"method":"item/plan/delta","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","itemId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","delta":".\n"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"plan","id":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04-plan","text":"# Deterministic Replay Fixtures\n\n## Summary\nAdd first-class deterministic replay fixture support to `packages/effect-codex-app-server` by loading existing NDJSON probe transcripts into the current `CodexAppServerReplayTranscript` model and validating them through the real replay client.\n\n## Implementation\n1. Add a fixture loader module, likely `src/replayFixtures.ts`.\n2. Parse NDJSON fixtures with:\n   - first line: `transcript_start`\n   - remaining lines: replay entries already compatible with `CodexAppServerReplayEntry`\n3. Convert each file into `CodexAppServerReplayTranscript`.\n4. Validate all lines through Effect Schema, returning schema-serializable errors with file path, line number, scenario, and parse/schema cause.\n5. Export fixture helpers from `package.json` as `./replay-fixtures`.\n\n## Public API\nAdd:\n```ts\nloadReplayFixture(path: string): Effect.Effect<CodexAppServerReplayTranscript, ReplayFixtureError>\nloadReplayFixtures(dir: string): Effect.Effect<ReadonlyArray<CodexAppServerReplayTranscript>, ReplayFixtureError>\n```\n\nAdd error types:\n```ts\nReplayFixtureReadError\nReplayFixtureJsonParseError\nReplayFixtureSchemaError\nReplayFixtureEmptyError\nReplayFixtureMissingTranscriptStartError\n```\n\n## Tests\nAdd tests covering:\n1. `simple.ndjson` loads into a valid transcript.\n2. Loaded `simple.ndjson` replays successfully through `layerReplay`.\n3. Malformed JSON reports file and line number.\n4. Missing `transcript_start` fails deterministically.\n5. Invalid entry shape fails schema validation.\n6. Fixture loading preserves entry order exactly.\n\n## Determinism Rules\n1. Do not rewrite existing fixture contents during replay.\n2. Keep normalization limited to existing replay comparison logic.\n3. Fixture loader must not depend on wall-clock time, current cwd, network, or process environment except the explicit file path input.\n4. Fixture order from directory loading should be lexicographic by filename.\n\n## Verification\nRun before completion:\n```sh\nbun fmt\nbun lint\nbun typecheck\nbun run test\n```\n\n## Assumptions\n1. Existing `test/fixtures/codex-app-server-probes/*.ndjson` files are the canonical initial deterministic fixture corpus.\n2. The current replay engine remains responsible for protocol-level matching.\n3. Fixture support is package-local and should not introduce runtime logic into contracts/shared packages.\n"},"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turnId":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","tokenUsage":{"total":{"totalTokens":166935,"inputTokens":165504,"cachedInputTokens":141696,"outputTokens":1431,"reasoningOutputTokens":159},"last":{"totalTokens":39088,"inputTokens":38463,"cachedInputTokens":37760,"outputTokens":625,"reasoningOutputTokens":106},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":1,"windowDurationMins":300,"resetsAt":1776821038},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777407838},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019db22b-08cd-7e12-b967-cf6ab32dd408","turn":{"id":"019db22b-08d6-7bb3-9b7d-2ae5b8661a04","items":[],"status":"completed","error":null,"startedAt":1776810658,"completedAt":1776810693,"durationMs":35554}}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/proposed_plan/cursor_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/proposed_plan/cursor_output.ts
new file mode 100644
index 000000000000..5b6c3ae21264
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/proposed_plan/cursor_output.ts
@@ -0,0 +1,39 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertBaseProjection,
+  assertExecutionNodeKinds,
+  assertRunOrdinals,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessagesInclude,
+  assertVisibleTurnItemsMirrorLocalTurnItems,
+  projectionFor,
+  PROPOSED_PLAN_PROMPT,
+} from "../shared.ts";
+
+export function assertProposedPlanCursorOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({ result, transcript, runCount: 1, runStatuses: ["completed"] });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertVisibleTurnItemsMirrorLocalTurnItems(projection);
+  assertRunOrdinals(projection, [1]);
+  assertExecutionNodeKinds(projection, ["root_turn", "plan", "subagent", "tool_call"]);
+  assertTurnItemTypes(projection, ["user_message", "subagent", "file_search", "proposed_plan"]);
+  assertUserMessagesInclude(projection, [PROPOSED_PLAN_PROMPT]);
+
+  const proposedPlans = projection.plans.filter((plan) => plan.kind === "proposed_plan");
+  assert.isAtLeast(proposedPlans.length, 1);
+  assert.include(proposedPlans.at(-1)?.markdown, "Deterministic Replay Fixtures");
+
+  const proposedPlanItems = projection.turnItems.filter((item) => item.type === "proposed_plan");
+  assert.isAtLeast(proposedPlanItems.length, 1);
+  assert.equal(proposedPlanItems.at(-1)?.streaming, false);
+  assert.isAtLeast(projection.subagents.length, 1);
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/proposed_plan/cursor_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/proposed_plan/cursor_transcript.ndjson
new file mode 100644
index 000000000000..701111f13ac8
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/proposed_plan/cursor_transcript.ndjson
@@ -0,0 +1,132 @@
+{"type":"transcript_start","provider":"cursor","protocol":"cursor-agent-sdk.local","version":"1","scenario":"proposed_plan","metadata":{"generatedBy":"recordCursorAgentSdkReplayTranscript","nativeAgentId":"agent-bc5d59e0-bc8b-441a-9292-b49dfff962d3"}}
+{"type":"expect_outbound","label":"agent.open","frame":{"type":"agent.open","operation":"create","options":{"model":{"id":"composer-2.5"},"hasName":true,"mode":"plan","local":{"hasCwd":true,"autoReview":false,"sandboxEnabled":true,"enableAgentRetries":true}}}}
+{"type":"emit_inbound","label":"agent.opened","frame":{"type":"agent.opened","agentId":"agent-bc5d59e0-bc8b-441a-9292-b49dfff962d3"}}
+{"type":"expect_outbound","label":"run.start:1","frame":{"type":"run.start","message":"Create a short implementation plan for adding deterministic replay fixtures. Do not ask questions. Present the final plan in a proposed plan block.","options":{"model":{"id":"composer-2.5"},"mode":"plan"}}}
+{"type":"emit_inbound","label":"run.started:1","frame":{"type":"run.started","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","agentId":"agent-bc5d59e0-bc8b-441a-9292-b49dfff962d3"}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"text-delta","text":"Exploring the"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":3}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"text-delta","text":" codebase for replay"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":5}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"text-delta","text":", fixtures, and"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":4}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"text-delta","text":" related"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"text-delta","text":" patterns"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"text-delta","text":" to"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"text-delta","text":" draft a concrete"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":4}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"text-delta","text":" plan"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"text-delta","text":".\n"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":4}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":8}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":3}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":183}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":5}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":4}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"partial-tool-call","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"partial-tool-call","callId":"tool_c651551c-9935-48e7-b5c4-28bd5ce2909","toolCall":{"type":"task","args":{"description":"Explore replay/fixture patterns","prompt":"Explore this codebase thoroughly to understand:\n1. What is this project (orchestrator, cursor agent SDK, etc.)?\n2. Any existing replay, recording, or fixture infrastructure\n3. Test patterns, mock patterns, deterministic testing approaches\n4. Any references to \"proposed_plan\", \"record\", \"replay\", \"fixture\"\n\nSearch for keywords: replay, fixture, record, deterministic, snapshot, mock, proposed_plan\n\nReturn:\n- Project structure overview\n- Relevant file paths and their roles\n- Current gaps for deterministic replay fixtures\n- Any existing types/interfaces that would need extension\n- Suggested integration points based on actual code\n\nBe specific with file paths and code snippets. Read-only exploration only.","subagentType":{"kind":"explore"},"model":"composer-2.5-fast","agentId":"95b8b4ba-cc91-4455-9389-9729e569f76b","mode":"unspecified"}},"modelCallId":"12792358-9978-4430-839d-d1aa84ab7471-0-yjwv"}}}
+{"type":"emit_inbound","label":"tool-call-started","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"tool-call-started","callId":"tool_c651551c-9935-48e7-b5c4-28bd5ce2909","toolCall":{"type":"task","args":{"description":"Explore replay/fixture patterns","prompt":"Explore this codebase thoroughly to understand:\n1. What is this project (orchestrator, cursor agent SDK, etc.)?\n2. Any existing replay, recording, or fixture infrastructure\n3. Test patterns, mock patterns, deterministic testing approaches\n4. Any references to \"proposed_plan\", \"record\", \"replay\", \"fixture\"\n\nSearch for keywords: replay, fixture, record, deterministic, snapshot, mock, proposed_plan\n\nReturn:\n- Project structure overview\n- Relevant file paths and their roles\n- Current gaps for deterministic replay fixtures\n- Any existing types/interfaces that would need extension\n- Suggested integration points based on actual code\n\nBe specific with file paths and code snippets. Read-only exploration only.","subagentType":{"kind":"explore"},"model":"composer-2.5-fast","agentId":"95b8b4ba-cc91-4455-9389-9729e569f76b","mode":"unspecified"}},"modelCallId":"12792358-9978-4430-839d-d1aa84ab7471-0-yjwv"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":5}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"tool-call-started","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"tool-call-started","callId":"tool_acdbbf78-c550-4f16-9311-7e10a3c2d03","toolCall":{"type":"glob","args":{"globPattern":"**/*"}},"modelCallId":"12792358-9978-4430-839d-d1aa84ab7471-0-yjwv"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":3}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":11}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"tool-call-started","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"tool-call-started","callId":"tool_e7511f26-8602-4658-81d3-139a335230c","toolCall":{"type":"grep","args":{"pattern":"replay|fixture|proposed_plan|deterministic","caseInsensitive":true,"offset":0}},"modelCallId":"12792358-9978-4430-839d-d1aa84ab7471-0-yjwv"}}}
+{"type":"emit_inbound","label":"tool-call-completed","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"tool-call-completed","callId":"tool_e7511f26-8602-4658-81d3-139a335230c","toolCall":{"type":"grep","args":{"pattern":"replay|fixture|proposed_plan|deterministic","caseInsensitive":true,"offset":0},"result":{"status":"success","value":{"workspaceResults":{"/var/folders/b3/b51_pdxj7dl0t981zpqkxxhr0000gn/T/t3-orchestrator-v2-cursor-agent-sdk-record-proposed_plan-ggwFWW":{"type":"content","output":{"matches":[{"file":"./README.md"}],"totalMatches":0}}}}}},"modelCallId":"12792358-9978-4430-839d-d1aa84ab7471-0-yjwv"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":56}}}
+{"type":"emit_inbound","label":"tool-call-completed","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"tool-call-completed","callId":"tool_acdbbf78-c550-4f16-9311-7e10a3c2d03","toolCall":{"type":"glob","args":{"globPattern":"**/*"},"result":{"status":"success","value":{"files":["./.git/logs/refs/heads/main","./.git/logs/HEAD","./.git/refs/heads/main","./.git/objects/fc/daa658b54f15c125d37542fbc5c39063cc8ae5","./.git/COMMIT_EDITMSG","./README.md","./.git/config","./.git/HEAD","./.git/hooks/push-to-checkout.sample","./.git/hooks/update.sample","./.git/hooks/pre-push.sample","./.git/hooks/pre-applypatch.sample","./.git/hooks/pre-merge-commit.sample","./.git/hooks/post-update.sample","./.git/hooks/prepare-commit-msg.sample","./.git/hooks/pre-receive.sample","./.git/hooks/fsmonitor-watchman.sample","./.git/hooks/applypatch-msg.sample","./.git/hooks/pre-commit.sample","./.git/hooks/sendemail-validate.sample","./.git/hooks/pre-rebase.sample","./.git/hooks/commit-msg.sample","./.git/description","./.git/info/exclude"],"totalFiles":24,"clientTruncated":false,"ripgrepTruncated":false}}},"modelCallId":"12792358-9978-4430-839d-d1aa84ab7471-0-yjwv"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":197}}}
+{"type":"emit_inbound","label":"tool-call-completed","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"tool-call-completed","callId":"tool_c651551c-9935-48e7-b5c4-28bd5ce2909","toolCall":{"type":"task","args":{"description":"Explore replay/fixture patterns","prompt":"Explore this codebase thoroughly to understand:\n1. What is this project (orchestrator, cursor agent SDK, etc.)?\n2. Any existing replay, recording, or fixture infrastructure\n3. Test patterns, mock patterns, deterministic testing approaches\n4. Any references to \"proposed_plan\", \"record\", \"replay\", \"fixture\"\n\nSearch for keywords: replay, fixture, record, deterministic, snapshot, mock, proposed_plan\n\nReturn:\n- Project structure overview\n- Relevant file paths and their roles\n- Current gaps for deterministic replay fixtures\n- Any existing types/interfaces that would need extension\n- Suggested integration points based on actual code\n\nBe specific with file paths and code snippets. Read-only exploration only.","subagentType":{"kind":"explore"},"model":"composer-2.5-fast","agentId":"95b8b4ba-cc91-4455-9389-9729e569f76b","mode":"unspecified"},"result":{"status":"success","value":{"conversationSteps":[{"assistantMessage":{"text":"I'll explore the codebase structure and search for replay, recording, fixture, and related patterns.\n"}},{"toolCall":{"readToolCall":{"args":{"path":"/tmp/cursor-replay-proposed_plan/README.md"},"result":{"success":{"content":"# cursor-agent-sdk-record-proposed_plan\n","totalLines":2,"fileSize":40,"path":"/tmp/cursor-replay-proposed_plan/README.md","readRange":{"startLine":1,"endLine":2}}}},"toolCallId":"tool_6b944780-b235-43eb-87b1-f1b31ec1df5"}},{"toolCall":{"grepToolCall":{"args":{"pattern":"proposed_plan|replay|fixture|record|deterministic|snapshot|mock","outputMode":"content","caseInsensitive":true,"multiline":false,"toolCallId":"tool_9703f1e1-6268-4d6f-b68f-3832af37dbe","offset":0},"result":{"success":{"pattern":"proposed_plan|replay|fixture|record|deterministic|snapshot|mock","outputMode":"content","workspaceResults":{"/var/folders/b3/b51_pdxj7dl0t981zpqkxxhr0000gn/T/t3-orchestrator-v2-cursor-agent-sdk-record-proposed_plan-ggwFWW":{"content":{"matches":[{"file":"./README.md","matches":[{"lineNumber":1,"content":"# cursor-agent-sdk-record-proposed_plan"}]}],"totalLines":1,"totalMatchedLines":1}}}}}},"toolCallId":"tool_9703f1e1-6268-4d6f-b68f-3832af37dbe"}},{"toolCall":{"globToolCall":{"args":{"globPattern":"**/*"},"result":{"success":{"files":["./.git/logs/refs/heads/main","./.git/logs/HEAD","./.git/refs/heads/main","./.git/objects/fc/daa658b54f15c125d37542fbc5c39063cc8ae5","./.git/COMMIT_EDITMSG","./README.md","./.git/config","./.git/HEAD","./.git/hooks/push-to-checkout.sample","./.git/hooks/update.sample","./.git/hooks/pre-push.sample","./.git/hooks/pre-applypatch.sample","./.git/hooks/pre-merge-commit.sample","./.git/hooks/post-update.sample","./.git/hooks/prepare-commit-msg.sample","./.git/hooks/pre-receive.sample","./.git/hooks/fsmonitor-watchman.sample","./.git/hooks/applypatch-msg.sample","./.git/hooks/pre-commit.sample","./.git/hooks/sendemail-validate.sample","./.git/hooks/pre-rebase.sample","./.git/hooks/commit-msg.sample","./.git/description","./.git/info/exclude"],"totalFiles":24}}},"toolCallId":"tool_2258753f-1e24-4b68-8f55-f5cc37d0df7"}},{"assistantMessage":{"text":"The repo looks minimal; I'll dig into git history and any hidden files for more context.\n"}},{"toolCall":{"readToolCall":{"args":{"path":"/tmp/cursor-replay-proposed_plan/.git/COMMIT_EDITMSG"},"result":{"success":{"content":"initial\n","totalLines":2,"fileSize":8,"path":"/tmp/cursor-replay-proposed_plan/.git/COMMIT_EDITMSG","readRange":{"startLine":1,"endLine":2}}}},"toolCallId":"tool_d7b3c0a2-3478-4188-b075-473d62608b5"}},{"toolCall":{"shellToolCall":{"result":{"permissionDenied":{"command":"git -C \"/tmp/cursor-replay-proposed_plan\" log --oneline -5 && echo \"---\" && git -C \"/tmp/cursor-replay-proposed_plan\" show --stat HEAD","error":"This operation is not allowed in readonly mode. The subagent was launched with readonly: true, which restricts write operations.","isReadonly":true}}},"toolCallId":"tool_1a463236-a1f4-46c9-9858-40ecb97beef"}},{"toolCall":{"globToolCall":{"args":{"targetDirectory":"/tmp/cursor-replay-proposed_plan","globPattern":"**/*.*"},"result":{"success":{"path":"/tmp/cursor-replay-proposed_plan","files":["README.md",".git/hooks/push-to-checkout.sample",".git/hooks/update.sample",".git/hooks/pre-push.sample",".git/hooks/pre-applypatch.sample",".git/hooks/pre-merge-commit.sample",".git/hooks/post-update.sample",".git/hooks/prepare-commit-msg.sample",".git/hooks/pre-receive.sample",".git/hooks/fsmonitor-watchman.sample",".git/hooks/applypatch-msg.sample",".git/hooks/pre-commit.sample",".git/hooks/sendemail-validate.sample",".git/hooks/pre-rebase.sample",".git/hooks/commit-msg.sample"],"totalFiles":15}}},"toolCallId":"tool_8b855f7c-7d59-4558-bbcc-33ed95edbf6"}},{"thinkingMessage":{"text":"The workspace contains only a README.md file with no other files present.","durationMs":741}},{"toolCall":{"grepToolCall":{"result":{"error":{"error":"rg: ../../../../../../Users/julius/.cursor/projects/var-folders-b3-b51-pdxj7dl0t981zpqkxxhr0000gn-T-t3-orchestrator-v2-cursor-agent-sdk-record-proposed-plan-ggwFWW: IO error for operation on ../../../../../../Users/julius/.cursor/projects/var-folders-b3-b51-pdxj7dl0t981zpqkxxhr0000gn-T-t3-orchestrator-v2-cursor-agent-sdk-record-proposed-plan-ggwFWW: No such file or directory (os error 2)\n"}}},"toolCallId":"tool_6483ec94-58b4-4995-948f-7929c5308a6"}},{"toolCall":{"readToolCall":{"args":{"path":"/tmp/cursor-replay-proposed_plan/.git/logs/HEAD"},"result":{"success":{"content":"0000000000000000000000000000000000000000 fcdaa658b54f15c125d37542fbc5c39063cc8ae5 T3 Code Test <t3code-test@example.com> 1781727514 -0700\tcommit (initial): initial\n","totalLines":2,"fileSize":164,"path":"/tmp/cursor-replay-proposed_plan/.git/logs/HEAD","readRange":{"startLine":1,"endLine":2}}}},"toolCallId":"tool_40fcc6a5-6ed4-41ef-92fa-a7f2636844e"}},{"toolCall":{"globToolCall":{"args":{"targetDirectory":"/var/folders/b3/b51_pdxj7dl0t981zpqkxxhr0000gn/T","globPattern":"**/*"},"result":{"success":{"path":"/var/folders/b3/b51_pdxj7dl0t981zpqkxxhr0000gn/T","files":["t3-orchestrator-v2-cursor-agent-sdk-record-proposed_plan-ggwFWW/.git/logs/refs/heads/main","t3-orchestrator-v2-cursor-agent-sdk-record-proposed_plan-ggwFWW/.git/logs/HEAD","t3-orchestrator-v2-cursor-agent-sdk-record-proposed_plan-ggwFWW/.git/refs/heads/main","t3-orchestrator-v2-cursor-agent-sdk-record-proposed_plan-ggwFWW/.git/objects/fc/daa658b54f15c125d37542fbc5c39063cc8ae5","t3-orchestrator-v2-cursor-agent-sdk-record-proposed_plan-ggwFWW/.git/COMMIT_EDITMSG","t3-orchestrator-v2-cursor-agent-sdk-record-proposed_plan-ggwFWW/README.md","t3-orchestrator-v2-cursor-agent-sdk-record-proposed_plan-ggwFWW/.git/config","t3-orchestrator-v2-cursor-agent-sdk-record-proposed_plan-ggwFWW/.git/HEAD","t3-orchestrator-v2-cursor-agent-sdk-record-proposed_plan-ggwFWW/.git/hooks/push-to-checkout.sample","t3-orchestrator-v2-cursor-agent-sdk-record-proposed_plan-ggwFWW/.git/hooks/update.sample","t3-orchestrator-v2-cursor-agent-sdk-record-proposed_plan-ggwFWW/.git/hooks/pre-push.sample","t3-orchestrator-v2-cursor-agent-sdk-record-proposed_plan-ggwFWW/.git/hooks/pre-applypatch.sample","t3-orchestrator-v2-cursor-agent-sdk-record-proposed_plan-ggwFWW/.git/hooks/pre-merge-commit.sample","t3-orchestrator-v2-cursor-agent-sdk-record-proposed_plan-ggwFWW/.git/hooks/post-update.sample","t3-orchestrator-v2-cursor-agent-sdk-record-proposed_plan-ggwFWW/.git/hooks/prepare-commit-msg.sample","t3-orchestrator-v2-cursor-agent-sdk-record-proposed_plan-ggwFWW/.git/hooks/pre-receive.sample","t3-orchestrator-v2-cursor-agent-sdk-record-proposed_plan-ggwFWW/.git/hooks/fsmonitor-watchman.sample","t3-orchestrator-v2-cursor-agent-sdk-record-proposed_plan-ggwFWW/.git/hooks/applypatch-msg.sample","t3-orchestrator-v2-cursor-agent-sdk-record-proposed_plan-ggwFWW/.git/hooks/pre-commit.sample","t3-orchestrator-v2-cursor-agent-sdk-record-proposed_plan-ggwFWW/.git/hooks/sendemail-validate.sample","t3-orchestrator-v2-cursor-agent-sdk-record-proposed_plan-ggwFWW/.git/hooks/pre-rebase.sample","t3-orchestrator-v2-cursor-agent-sdk-record-proposed_plan-ggwFWW/.git/hooks/commit-msg.sample","t3-orchestrator-v2-cursor-agent-sdk-record-proposed_plan-ggwFWW/.git/description","t3-orchestrator-v2-cursor-agent-sdk-record-proposed_plan-ggwFWW/.git/info/exclude","CCqK1MQUAekfYNUa51kXl/ssr/1b6ea0b090b16ca68587e35e5691757979c4dbb9","CCqK1MQUAekfYNUa51kXl/ssr/79bb62c3ed83171a3b36a1eb963082420016cb70","CCqK1MQUAekfYNUa51kXl/ssr/0c2da54c3119b606e8c2905c547acca7af45aa39","CCqK1MQUAekfYNUa51kXl/ssr/f20478f9c64f4cca804b8b7f576affd083776c07","CCqK1MQUAekfYNUa51kXl/ssr/108e7a223d191f879a4c8051f311e7b1c0ebfdce","CCqK1MQUAekfYNUa51kXl/ssr/2de7d3205b4ee297e3dfa788676de6c69fb8007e","CCqK1MQUAekfYNUa51kXl/ssr/457946fa6d3ce4d97e71b48f1750bf93f99c06bc","CCqK1MQUAekfYNUa51kXl/ssr/f1520271a08811d17d2c4880b5afdbf7ac9da618","CCqK1MQUAekfYNUa51kXl/ssr/d437b342aa504cc264cd6c5db9cdc521fd6e0821","CCqK1MQUAekfYNUa51kXl/ssr/d047bef17077dca83ce4a251e28c4063c0e538f4","CCqK1MQUAekfYNUa51kXl/ssr/f3a9e0af27dd4b49f4165fbaf27662c271048005","CCqK1MQUAekfYNUa51kXl/ssr/83a2d7c41f465a99bfd7c736de2459cd83029320","CCqK1MQUAekfYNUa51kXl/ssr/e736de55c464a13c9c14854dccbcf4bbb57a4b7f","CCqK1MQUAekfYNUa51kXl/ssr/0b7c9ad62ad69946d442ba006c8980f0cd629483","CCqK1MQUAekfYNUa51kXl/ssr/4d2e48b21fd3e56cf2c131c12b7128d5e313260e","CCqK1MQUAekfYNUa51kXl/ssr/880431d601e71a19cb978e237d4b2b592fd72bc7","CCqK1MQUAekfYNUa51kXl/ssr/ab5dcf7ac7bd5b000cefacc297199d4af8fd245a","CCqK1MQUAekfYNUa51kXl/ssr/b60425009385208a49a7cefb90e43ae3aef5dd82","CCqK1MQUAekfYNUa51kXl/ssr/440915f8846468272bb1dafcd23646f0365cb3f5","CCqK1MQUAekfYNUa51kXl/ssr/b2e4b867420b48a4c6f59a9b1ae3c42137d201a7","CCqK1MQUAekfYNUa51kXl/ssr/5f9efd0f68ba7680aa015462154ed5e43d055cc9","CCqK1MQUAekfYNUa51kXl/ssr/b222b9ce36afa608b234f80fd072710735675e3e","CCqK1MQUAekfYNUa51kXl/ssr/132a433c77c4569a5fd8934ec346367cb8c08fdd","CCqK1MQUAekfYNUa51kXl/ssr/595a7f12f587232e6859c0418f1d8dc252d146cf","CCqK1MQUAekfYNUa51kXl/ssr/e82e8b073eed72f7e57650dd089959ec97a47613","CCqK1MQUAekfYNUa51kXl/ssr/d6ca2de59e50d4c6c10f5f1bcd223bdce815e837","CCqK1MQUAekfYNUa51kXl/ssr/589a2245dfe67b5e830d21e12c50fc2c8baf5aee","CCqK1MQUAekfYNUa51kXl/ssr/117216c8617289ba3d5d6dfdf1ac301e9faf58f2","CCqK1MQUAekfYNUa51kXl/ssr/e5a8a7f1e54634c961d1f2188fe1f70709215ff2","CCqK1MQUAekfYNUa51kXl/ssr/ab4e9c0c155519fc53e566fab2965635c528137b","CCqK1MQUAekfYNUa51kXl/ssr/bb63df4de73c4e5f82faec56a3ab08ec66ffbf69","CCqK1MQUAekfYNUa51kXl/ssr/d1b6e51017eb1883023eebce64ac14e6f0d82b39","CCqK1MQUAekfYNUa51kXl/ssr/bd4a74d492060a9dbdc8f631170721ec5b72156b","CCqK1MQUAekfYNUa51kXl/ssr/b5f664a38161e78eaee69fef923422f6816b958f","CCqK1MQUAekfYNUa51kXl/ssr/4d66c4e0b61ac9d511e9be435abacbb831477bd2","CCqK1MQUAekfYNUa51kXl/ssr/22858e0edba23ff7b4e99e0bb854c1e6eb5d67e5","CCqK1MQUAekfYNUa51kXl/ssr/57937a82893c775976f44de35796090eefc3fd8f","CCqK1MQUAekfYNUa51kXl/ssr/7dd483e15d4a4afef1e8aae204761a909ae1bc43","CCqK1MQUAekfYNUa51kXl/ssr/bc69a12ac750e779e589e094f49e77031f53f05a","CCqK1MQUAekfYNUa51kXl/ssr/8432da594202b10f98b51ec2c1112963d7f705c5","CCqK1MQUAekfYNUa51kXl/ssr/ca1b9e023995c6fcb85084759a964a0062faf1a9","CCqK1MQUAekfYNUa51kXl/ssr/f34155c05d008fce01a6cf1750e9535f89c308b3","CCqK1MQUAekfYNUa51kXl/ssr/970972bec3921402c7785a22824f2c0198efc88f","CCqK1MQUAekfYNUa51kXl/ssr/08c41285ab65807254c5ea4923cf741b173a96b4","CCqK1MQUAekfYNUa51kXl/ssr/e675afb01ffc8b54f5863d95ae38c908d884912b","CCqK1MQUAekfYNUa51kXl/ssr/3062def690e5fe2976775c2d28642b6d0d5507ef","CCqK1MQUAekfYNUa51kXl/ssr/e735fe699fdf6dedab877dd1ee8036991c50d3e9","CCqK1MQUAekfYNUa51kXl/ssr/14be6fc6943f81092358c3f62356826467e8e52d","CCqK1MQUAekfYNUa51kXl/ssr/6c654a0e59eb3bc4c1b967f2318eb33edcb2ab81","CCqK1MQUAekfYNUa51kXl/ssr/1b7ad70ecb70da350c3de11228ba9ed61cc4151d","CCqK1MQUAekfYNUa51kXl/ssr/8242d1067cc0ec7384bbd2ae0a4aedf811a3a3b7","CCqK1MQUAekfYNUa51kXl/ssr/8ce9c3448eb1f4932b032e0ca15d292fc4e3bd9a","CCqK1MQUAekfYNUa51kXl/ssr/b73faaf68ad485afad44313585b03fc354f06423","CCqK1MQUAekfYNUa51kXl/ssr/45accde829b4cdcbe11fd7d765787a2b3b9a8011","CCqK1MQUAekfYNUa51kXl/ssr/61f658e66a7d263036ad5585d74a5571f60bf17e","CCqK1MQUAekfYNUa51kXl/ssr/6e9748916c3cf1c002e477c02ecbae3a2eab474d","t3code-git-manager-SKlXJL/README.md","t3code-git-manager-SKlXJL/.git/config","t3code-git-manager-SKlXJL/.git/HEAD","t3code-git-manager-SKlXJL/.git/hooks/push-to-checkout.sample","t3code-git-manager-SKlXJL/.git/hooks/update.sample","t3code-git-manager-SKlXJL/.git/hooks/pre-push.sample","t3code-git-manager-SKlXJL/.git/hooks/pre-applypatch.sample","t3code-git-manager-SKlXJL/.git/hooks/pre-merge-commit.sample","t3code-git-manager-SKlXJL/.git/hooks/post-update.sample","t3code-git-manager-SKlXJL/.git/hooks/prepare-commit-msg.sample","t3code-git-manager-SKlXJL/.git/hooks/pre-receive.sample","t3code-git-manager-SKlXJL/.git/hooks/fsmonitor-watchman.sample","t3code-git-manager-SKlXJL/.git/hooks/applypatch-msg.sample","t3code-git-manager-SKlXJL/.git/hooks/pre-commit.sample","t3code-git-manager-SKlXJL/.git/hooks/sendemail-validate.sample","t3code-git-manager-SKlXJL/.git/hooks/pre-rebase.sample","t3code-git-manager-SKlXJL/.git/hooks/commit-msg.sample","t3code-git-manager-SKlXJL/.git/description","t3code-git-manager-SKlXJL/.git/info/exclude","Sv70zJ_VefJwjnnkCDctC/ssr/4e8947ba6e8c68b58749bcf9dc89d6b388dbfda2","Sv70zJ_VefJwjnnkCDctC/ssr/03512668e6e78af858678dc39f94b4ebfd9a1636","Sv70zJ_VefJwjnnkCDctC/ssr/6bec7b7400c14152f326930c9f12e90765694bf6","Sv70zJ_VefJwjnnkCDctC/ssr/8a44f7672da6886d5d4c779e40a57c69e21f3700","Sv70zJ_VefJwjnnkCDctC/ssr/6170d80995eb5bf2450aa08c44d6034de5d7a6fa","Sv70zJ_VefJwjnnkCDctC/ssr/2af0d4320498e93b1fd64a2bb25dc03500380209","Sv70zJ_VefJwjnnkCDctC/ssr/105aedadccbab6c1a6220826b051cf6e22a394f5","Sv70zJ_VefJwjnnkCDctC/ssr/a419dc28f487a0ba1a715f2807e517597cb4fd14","Sv70zJ_VefJwjnnkCDctC/ssr/7c0a017158f766e8a561c3153c97e0248bd7c88e","Sv70zJ_VefJwjnnkCDctC/ssr/3bc130f687ccea4b9889ab5a7defd7161b03df9f","Sv70zJ_VefJwjnnkCDctC/ssr/c3038c415b2ee8e907ee87ed638e3646b9e6473e","Sv70zJ_VefJwjnnkCDctC/ssr/6ab12736b2568e78e4c8c91eac42fb1fcce6e963","Sv70zJ_VefJwjnnkCDctC/ssr/91f9f66076592f19082d40e122566775834e4f72","Sv70zJ_VefJwjnnkCDctC/ssr/c0d5abd5f318459829f34025ccf9b24cad610c73","Sv70zJ_VefJwjnnkCDctC/ssr/f2aabcdba3747cebeb6e6dc99aa0b719a5baea7f","Sv70zJ_VefJwjnnkCDctC/ssr/568a349648f6ea825a685f7ab04aace2bce709ea","Sv70zJ_VefJwjnnkCDctC/ssr/ef6de42efc4ca71ed7bb5c04f3c6264257ea8723","Sv70zJ_VefJwjnnkCDctC/ssr/9b37ab18399be392930f2d2d3b93efd7e9f808b8","Sv70zJ_VefJwjnnkCDctC/ssr/fb37d378e9a3db2548e86d2bbbccde9e95187d38","Sv70zJ_VefJwjnnkCDctC/ssr/2781fbcf333100abf170395a4bee351395a19a02","Sv70zJ_VefJwjnnkCDctC/ssr/af7e964c307af042ae151df647376565fada4fa5","Sv70zJ_VefJwjnnkCDctC/ssr/0a847a5b9eea2b489f04be234114b569dc91dc0f","Sv70zJ_VefJwjnnkCDctC/ssr/924cf181258915d6beb4dcc76cca729818f170ea","Sv70zJ_VefJwjnnkCDctC/ssr/a8e7395fe8e3d1c7b0182175274ff19af4dece24","Sv70zJ_VefJwjnnkCDctC/ssr/1d65f2e89b8107d7c0ab9ff7e6dcea1627ffa2a2","Sv70zJ_VefJwjnnkCDctC/ssr/04d71a2e0660948234564261fcbfe69fae8eee5a","Sv70zJ_VefJwjnnkCDctC/ssr/869435fe5e1ec79357698c530a40319ef5f70812","Sv70zJ_VefJwjnnkCDctC/ssr/99e8e0f481e7e0b86ec88bb0146c16634fc326bb","Sv70zJ_VefJwjnnkCDctC/ssr/b29b5b1a1d9b44ee5ec5c3fdcf7ea8e1e06d827b","Sv70zJ_VefJwjnnkCDctC/ssr/73b5f379e83c6d6f8a620bbd6bbb051c98cce470","Sv70zJ_VefJwjnnkCDctC/ssr/67e8ebb3b24ed6cd07652522b9a48d2dbc9effd9","Sv70zJ_VefJwjnnkCDctC/ssr/e0d855cd53346d51344d4e9b1aa653582598a289","Sv70zJ_VefJwjnnkCDctC/ssr/66bfafe9668a4d37928fc59445af54ecd42a0d7f","Sv70zJ_VefJwjnnkCDctC/ssr/38f2ff294448561a12240bce7bdd9dfd16b914ad","Sv70zJ_VefJwjnnkCDctC/ssr/9a7cb78cb97573a8ef99ba178c76fc6baa4816bf","Sv70zJ_VefJwjnnkCDctC/ssr/845b214c955416e370dfa851c8ab46e8709bd51f","Sv70zJ_VefJwjnnkCDctC/ssr/34090bc2870a8ede0205408322b27efa569b96b8","Sv70zJ_VefJwjnnkCDctC/ssr/76dffe916b65cb9397c31ae8f513dc664faa5328","Sv70zJ_VefJwjnnkCDctC/ssr/0aad60b4bd76a5d0cd6bb975bad327c3999f206b","Sv70zJ_VefJwjnnkCDctC/ssr/604048c2336981e74492550ed0f454ee40b5c8f0","Sv70zJ_VefJwjnnkCDctC/ssr/43de3cc0230dd481864fe855998b3e40f3c2fccd","Sv70zJ_VefJwjnnkCDctC/ssr/dc11b24e72820253f410319237f6c1c7d3d36a91","Sv70zJ_VefJwjnnkCDctC/ssr/b5ac96e942e73e3e012c359c83da2f3bfe64794f","Sv70zJ_VefJwjnnkCDctC/ssr/cb79d2fc362b7924c747404a2ebd2e9fb6c4f6af","Sv70zJ_VefJwjnnkCDctC/ssr/947a07dab01d2a431253095aea1c68661be705d4","Sv70zJ_VefJwjnnkCDctC/ssr/c6f320061bb2cccfd10e681ff2080a971f671d63","Sv70zJ_VefJwjnnkCDctC/ssr/bb5037638f3321c5ee72472b6ee61f4a7c241d5d","Sv70zJ_VefJwjnnkCDctC/ssr/bf54ab6d6fd67b848aa9f30c43ab1c56d794e148","Sv70zJ_VefJwjnnkCDctC/ssr/807fedcadca300a7d914de715be8c9b00e596c38","Sv70zJ_VefJwjnnkCDctC/ssr/7e2ac7117f27ee9bdb03e47f13159476ca1ca545","Sv70zJ_VefJwjnnkCDctC/ssr/aad96267a6612b94322a105105992df1bc0fa7d3","Sv70zJ_VefJwjnnkCDctC/ssr/8161aba1340f9a1495f03d2373abb9e77b791c7b","Sv70zJ_VefJwjnnkCDctC/ssr/ecf71a5d3255bac0fffab581b93ca2932c3644ac","Sv70zJ_VefJwjnnkCDctC/ssr/07410e3be2a60c549f8942ea734ecb7f013e23f6","Sv70zJ_VefJwjnnkCDctC/ssr/10e7b0808d63aeb799c1d91548159cf08f632cad","Sv70zJ_VefJwjnnkCDctC/ssr/050803c975e5c3d0ec842523bdb2e28520faf721","Sv70zJ_VefJwjnnkCDctC/ssr/9deeea88026e431b03d5d4030484a59e3ada96e5","Sv70zJ_VefJwjnnkCDctC/ssr/ac132509ddf5c65f579b5e623bcdf7594d75395c","Sv70zJ_VefJwjnnkCDctC/ssr/2976a59021fcc289405d177183422f0618d603bd","Sv70zJ_VefJwjnnkCDctC/ssr/ad2cd083c434b347d0069c3c506a217f521e4196","Sv70zJ_VefJwjnnkCDctC/ssr/679dbb0643fb081c8343e6abd36984e510b09261","Sv70zJ_VefJwjnnkCDctC/ssr/46466b0d07ebc7b40ccfdfe55d13dd0537ba704d","Sv70zJ_VefJwjnnkCDctC/ssr/dded9812fd2e21a0928170fbee3d0448d387d97d","Sv70zJ_VefJwjnnkCDctC/ssr/8131fc571317c963c3cc61e95bfb5ff5b520170b","Sv70zJ_VefJwjnnkCDctC/ssr/4695aeaedcb667ba0232f17ce1f40eb268219742","Sv70zJ_VefJwjnnkCDctC/ssr/658e9a921ebf496fca62e5156ba25dcd6be72ea4","Sv70zJ_VefJwjnnkCDctC/ssr/7518e120614ce4a212333b60c74054dfd17d54d8","Sv70zJ_VefJwjnnkCDctC/ssr/47f8fb2701a4c395716a64e5b2cbdd72ce965a9e","Sv70zJ_VefJwjnnkCDctC/ssr/3e61c25af65ba0676189d882183712746f32bd6b","Sv70zJ_VefJwjnnkCDctC/ssr/bb1194a208db95b464003f0b0e5d5c018a743d3a","Sv70zJ_VefJwjnnkCDctC/ssr/39f2b2496a50b8ca65f29b911935458a93a57db8","Sv70zJ_VefJwjnnkCDctC/ssr/6d0093e0e7c63bfbf24d50739c0ac90d94ba9847","Sv70zJ_VefJwjnnkCDctC/ssr/e4957b5198cb7f41cec1b2aedf09649a60dd6e4a","Sv70zJ_VefJwjnnkCDctC/ssr/bcb868f22f818c5254a289e9c92bc08fefc14ab5","Sv70zJ_VefJwjnnkCDctC/ssr/42e9a1d6105278e1340f8cfc335c9d607c6862fd","Sv70zJ_VefJwjnnkCDctC/ssr/024eef6cba335cd547a54ebdb5b4cfdf4fe05ee5","Sv70zJ_VefJwjnnkCDctC/ssr/95a967c3c8f62f9f3cab195d4299233dbb6d17db","Sv70zJ_VefJwjnnkCDctC/ssr/905fd6ad08354e303f1196aaf38a2620648a7309","Sv70zJ_VefJwjnnkCDctC/ssr/84050534eacbc50aaec19fe12fbbc883180e5122","Sv70zJ_VefJwjnnkCDctC/ssr/2cf3599409190ff6e1b334e211e166ce5d3d2d0a","Sv70zJ_VefJwjnnkCDctC/ssr/3c4fef3cf4f7a1481992dec6aa61025255a4c5b2","Sv70zJ_VefJwjnnkCDctC/ssr/53eb8909614c5d8e7453c5c78531894062722d6c","Sv70zJ_VefJwjnnkCDctC/ssr/bfb9910fe809ecd0ab264e1fc7001642e009c133","Sv70zJ_VefJwjnnkCDctC/ssr/16df9be6fe74dd6cacc1d884c1538b6af35c4a1d","Sv70zJ_VefJwjnnkCDctC/ssr/bbe2983d3c312d474d463a92a4359c611452b730","Sv70zJ_VefJwjnnkCDctC/ssr/e7a92a185a34b19bda41eba0ad256e370ea10c59","Sv70zJ_VefJwjnnkCDctC/ssr/58f558f67ce1473475dee602195610641bba1a62","Sv70zJ_VefJwjnnkCDctC/ssr/4329f1b90a043569cc157412bb5fb42300c4d540","Sv70zJ_VefJwjnnkCDctC/ssr/f65f1afed8f26237c2aa2bbfd5b9470f58e3a712","Sv70zJ_VefJwjnnkCDctC/ssr/761ec34282c325d5706f27011bf00fa4975284e9","Sv70zJ_VefJwjnnkCDctC/ssr/2044def5ddd39b7602ef276ccc150a5e8fa711d7","Sv70zJ_VefJwjnnkCDctC/ssr/1292293d36ee2bb22a34924c518920df546e7fed","Sv70zJ_VefJwjnnkCDctC/ssr/15b07e765340c56f231a1bef27f039ba6a79f278","Sv70zJ_VefJwjnnkCDctC/ssr/f58e7e5e21adb0067ee56a42ab214ceb2c7b3a8a","Sv70zJ_VefJwjnnkCDctC/ssr/d13e06a3757d19e7e4837c828a614ce83daf9c38","Sv70zJ_VefJwjnnkCDctC/ssr/d46483bd29468b1cc14e4ba5e326254c6b966668","Sv70zJ_VefJwjnnkCDctC/ssr/8b567e0d6a0328a0c247114c5813fbb69ccdc970","Sv70zJ_VefJwjnnkCDctC/ssr/9712582533cbc72df7ea4f0be827de0bf4021854","Sv70zJ_VefJwjnnkCDctC/ssr/2ef7301f6f8e541e046e393e338fba360e46477d","Sv70zJ_VefJwjnnkCDctC/ssr/234453211a3f5552a0460ff23201f9295824b84c","Sv70zJ_VefJwjnnkCDctC/ssr/aeed46aa94878a41de42b018571d9b1ecbe69580","Sv70zJ_VefJwjnnkCDctC/ssr/7b54aa2700d8346b4bbe1256e129c0deef5414ba","Sv70zJ_VefJwjnnkCDctC/ssr/45b6672c00a36b755554b1d29abd4cec548e4ca8","Sv70zJ_VefJwjnnkCDctC/ssr/d295cf3b93be748ee79877c07e1f48de909ecb91","Sv70zJ_VefJwjnnkCDctC/ssr/ac0e5be012551140c406a76787fadaae319cd863","Sv70zJ_VefJwjnnkCDctC/ssr/248e5748e11178cb2eb7f7d1627ab8eeb239011e","Sv70zJ_VefJwjnnkCDctC/ssr/7edd5b85415c10828833f76d43460ea4de8fb652","Sv70zJ_VefJwjnnkCDctC/ssr/bebfeca96c099e1a25c229e61f5dc3d4c4e3c173","Sv70zJ_VefJwjnnkCDctC/ssr/5dabfb3632bce2e970dca32dd35b14b53fdf7d6e","Sv70zJ_VefJwjnnkCDctC/ssr/a07d4f8d6214fb049f440daa96f99f647c834a64","Sv70zJ_VefJwjnnkCDctC/ssr/f0cd0d1b65dc92c7bed4e0d24b9fdd202d3bb0f2","Sv70zJ_VefJwjnnkCDctC/ssr/21c434d1616216c1c252da8cf7157dc5d9dba585","Sv70zJ_VefJwjnnkCDctC/ssr/88e2c1ffa1689a369c8125fdc52653c3de49553a","Sv70zJ_VefJwjnnkCDctC/ssr/dcabbc69a49bfcfe87a35c29db0e9b9508e2d737","Sv70zJ_VefJwjnnkCDctC/ssr/1a665cdeb85601518de641e9cfda350a4a4b2cba","Sv70zJ_VefJwjnnkCDctC/ssr/8d65c08f8445cfa1b7259bbdbc93d553d9f28959","Sv70zJ_VefJwjnnkCDctC/ssr/179a276c9157b91392bda5540d11abfae3515e9c","Sv70zJ_VefJwjnnkCDctC/ssr/e06f83ec6b5c8314a46cfb08a9803ed9dc37ed48","Sv70zJ_VefJwjnnkCDctC/ssr/db079c9fd366c30990dcedeb7c88cf28bc316818","Sv70zJ_VefJwjnnkCDctC/ssr/0b64023b4d1bed0f1f63f8a93ca546e8a9650e42","Sv70zJ_VefJwjnnkCDctC/ssr/c0feee60cbb354fca689602e17e27212509952fe","Sv70zJ_VefJwjnnkCDctC/ssr/9cdf98ed1585642c86efcf9121fe1a31a64482e1","Sv70zJ_VefJwjnnkCDctC/ssr/d7c340049aa7f8e97c14070fe52e62933ea7cff0","Sv70zJ_VefJwjnnkCDctC/ssr/b52112ed80c2d4ba2bdf2795387205719404470b","Sv70zJ_VefJwjnnkCDctC/ssr/fdca1191087ab6421b7b9075726e38683a67e680","Sv70zJ_VefJwjnnkCDctC/ssr/78dab201f4b26f9b3aa2d038bb8dcf749084fb36","Sv70zJ_VefJwjnnkCDctC/ssr/0a62aecdc01fbbebfb7da14f3936bd9ba99c3d5a","Sv70zJ_VefJwjnnkCDctC/ssr/91dd671fccccb8ebc483c22ce477d732762d7a50","Sv70zJ_VefJwjnnkCDctC/ssr/cd2781184fd12c967eb571b85d56cd69642c0f7b","Sv70zJ_VefJwjnnkCDctC/ssr/507f00bc80b5f9b08b01407a2b9db910a736a458","Sv70zJ_VefJwjnnkCDctC/ssr/bb1929c1030cf1800eb2fc409bf8f8edd4b7ff60","Sv70zJ_VefJwjnnkCDctC/ssr/82224c0f6fa407944c819118a2b9b9ccd54b98d5","Sv70zJ_VefJwjnnkCDctC/ssr/4230cbf5f9e3b638ce57eaa7d8820ed43588cfde","Sv70zJ_VefJwjnnkCDctC/ssr/a5e3d77f7bf363d10d3c5f856b01b83ea4cd480d","Sv70zJ_VefJwjnnkCDctC/ssr/e62038f7b31af248a683a27c507974783791afd0","Sv70zJ_VefJwjnnkCDctC/ssr/534b7c1fe05e6733a2b0723050177a5b3a94dd20","Sv70zJ_VefJwjnnkCDctC/ssr/c6338f5cbcb4476872c42c16e4a951e2b00fbc37","Sv70zJ_VefJwjnnkCDctC/ssr/93e2bb9dd21dae3cbb43930bb27c4229af9a7470","Sv70zJ_VefJwjnnkCDctC/ssr/e6abf249b2708845ac6f6c15e407822dae517223","Sv70zJ_VefJwjnnkCDctC/ssr/c8208873297ab5ec63a27f6c5d058313a402bbe0","Sv70zJ_VefJwjnnkCDctC/ssr/9bcbe270ac22d3fa0a6cfd0defe9b9124f016d3f","Sv70zJ_VefJwjnnkCDctC/ssr/d478d4f1ebfbb5f487b14f9c68fa6445f969e1df","Sv70zJ_VefJwjnnkCDctC/ssr/c636629172b3ea1502146817f54a5da25ebcf337","Sv70zJ_VefJwjnnkCDctC/ssr/5cd925dd4034fc0a614c10d410631072f255f173","Sv70zJ_VefJwjnnkCDctC/ssr/86316717a491a8f273f5182d5ccbaee6623de4da","Sv70zJ_VefJwjnnkCDctC/ssr/25257d03950239399a7ceafdd780caafe6129a7c","Sv70zJ_VefJwjnnkCDctC/ssr/31c276668d4592b51d2c9e711c6c8292de1503de","Sv70zJ_VefJwjnnkCDctC/ssr/7dd031c2de5f39ae5cdf78bd1b233660cfe747bd","Sv70zJ_VefJwjnnkCDctC/ssr/62ee5cc18542a9a90f4aefe86c71e7ece1a46200","Sv70zJ_VefJwjnnkCDctC/ssr/69f67decdee21d1932b9f5e53748991232675b40","Sv70zJ_VefJwjnnkCDctC/ssr/52ecc183b63d00e54e83752ca85d8627290f46e5","Sv70zJ_VefJwjnnkCDctC/ssr/100f3d5f7d9b2616380643ce62541454d858d97b","Sv70zJ_VefJwjnnkCDctC/ssr/cca1841223796e51d33b39529dabb09734bfe60b","Sv70zJ_VefJwjnnkCDctC/ssr/8e12da0adce85220790ff575de972c48d5258beb","Sv70zJ_VefJwjnnkCDctC/ssr/2d4d2626746953deac0b15dbf8b698fbb21ca373","Sv70zJ_VefJwjnnkCDctC/ssr/b74a42a7d88110d59b3599b917bef8dcd1faa014","Sv70zJ_VefJwjnnkCDctC/ssr/15c04ddc4b71b3171a9968af32a09a3b1b9cbc1d","Sv70zJ_VefJwjnnkCDctC/ssr/2c0885e21bf350e47164e280362c073f8451f471","Sv70zJ_VefJwjnnkCDctC/ssr/e41d57f867d537f1ab21a5aa82819e382e857071","Sv70zJ_VefJwjnnkCDctC/ssr/a36c28f367c6ec6010eff776865da0f1c9a680ce","Sv70zJ_VefJwjnnkCDctC/ssr/b649a44bbfddef9eccda289930b8843b10d8e05c","Sv70zJ_VefJwjnnkCDctC/ssr/231d6cd2e8e9d2d5058643dc561ea67c887c83e9","Sv70zJ_VefJwjnnkCDctC/ssr/44ad3ea2a0c5f8ee15586ec584a5c3db6964ab1d","Sv70zJ_VefJwjnnkCDctC/ssr/c5a104b61863ade78ec2ddca2bfbb681bd4f2042","Sv70zJ_VefJwjnnkCDctC/ssr/fa4b97c694bc17346cf3bd27368b061dfc9da048","Sv70zJ_VefJwjnnkCDctC/ssr/9ba96505ccde7eeae7de2d9a13c2bf51ed82b6e3","Sv70zJ_VefJwjnnkCDctC/ssr/95e7ebf9f4b4557446373108f84a594771e20af5","Sv70zJ_VefJwjnnkCDctC/ssr/c5bb4f29113c05568f114a5a22da36324ff29b50","Sv70zJ_VefJwjnnkCDctC/ssr/ec966d218efabe3d5c6699ef6d4bf644da5056f1","Sv70zJ_VefJwjnnkCDctC/ssr/d36974c37297ed382699c6a2f3f4a03750060098","Sv70zJ_VefJwjnnkCDctC/ssr/c5180db9e5bf973acb250efacc01222345eb4b66","Sv70zJ_VefJwjnnkCDctC/ssr/6886a7685f171cf978e665404f51114250ecf13f","Sv70zJ_VefJwjnnkCDctC/ssr/32f61621a028cde3fb6f4a918512932d1b115ac0","Sv70zJ_VefJwjnnkCDctC/ssr/5bd554840430b34e5df04093aac733ade8e577e0","Sv70zJ_VefJwjnnkCDctC/ssr/5100ff82f79b4abb91fb4234e9b12c774804ca5f","Sv70zJ_VefJwjnnkCDctC/ssr/9462ccb273484faf6bbde34e124c406b1a1bdca8","Sv70zJ_VefJwjnnkCDctC/ssr/775ec3abe151bf53f926fad8e65f6141da32062c","Sv70zJ_VefJwjnnkCDctC/ssr/d57130c2eeb6e9188dadb60541149957ac608485","Sv70zJ_VefJwjnnkCDctC/ssr/c640488eec74e9acafcc01c25df8e12c97beb905","Sv70zJ_VefJwjnnkCDctC/ssr/a8f78580bb9b75ece06c5f9eaabe83bca684e4cc","Sv70zJ_VefJwjnnkCDctC/ssr/969ab7b73ea371b44b63d7bb3aefef749800e4b5","Sv70zJ_VefJwjnnkCDctC/ssr/5030ee88e2d1a049299344026a86a9245b8b82ae","Sv70zJ_VefJwjnnkCDctC/ssr/71bccaeb5ebd68d9ff0c9cf88530db5c1e1465c8","Sv70zJ_VefJwjnnkCDctC/ssr/56233dd266c3f433c826003417df7a5f13dce64a","Sv70zJ_VefJwjnnkCDctC/ssr/817486c70c0f16bebab0a6c46cca1e90840a33b8","Sv70zJ_VefJwjnnkCDctC/ssr/1dcd77ede93f725b09e31931870c2a7a698b271a","Sv70zJ_VefJwjnnkCDctC/ssr/3a8e68edc1acb3092cf4e25c1c1e808de940f49a","Sv70zJ_VefJwjnnkCDctC/ssr/a61fd36d08daaa8f09fcca8e8f210d1e9dc9ddcb","Sv70zJ_VefJwjnnkCDctC/ssr/d957b24663e031714d8d6eac6c9dec28028bcc16","Sv70zJ_VefJwjnnkCDctC/ssr/a7f44410184c826b9c130089f60c616da12861b8","Sv70zJ_VefJwjnnkCDctC/ssr/090c801a6f51853090b398f86c929a497e877a25","Sv70zJ_VefJwjnnkCDctC/ssr/e9848f684a9c4500cfceb82354e4cda695480a3f","Sv70zJ_VefJwjnnkCDctC/ssr/8732cbce972931f1ae92b31fc0ac3c54913b9540","Sv70zJ_VefJwjnnkCDctC/ssr/e9b06953c6ab57baffd7e084c3ec51924fff2cd9","Sv70zJ_VefJwjnnkCDctC/ssr/39ae6570a0c093f48d7dd5e24fd2a7a268686a15","Sv70zJ_VefJwjnnkCDctC/ssr/3f4824e976165b406aa3e4fa3ed26ef5011ae0c3","Sv70zJ_VefJwjnnkCDctC/ssr/0c4735a49daa28f7a5e3605e1d8a4361872ebddc","Sv70zJ_VefJwjnnkCDctC/ssr/0d3155f9476d78c60bd6ff3274ad32fef742bb1a","Sv70zJ_VefJwjnnkCDctC/ssr/2068d4a1a12598ee736582e3bb69ceb83f08d9c7","Sv70zJ_VefJwjnnkCDctC/ssr/34fc927394c13d776d08367ebdb830f978993781","Sv70zJ_VefJwjnnkCDctC/ssr/a25ceb5fe4996bfd9f7e1b6b05f5e6fdf7a4887e","Sv70zJ_VefJwjnnkCDctC/ssr/be9b4a5bc5c79b5dbb2f076f4b48fa53f011eb30","Sv70zJ_VefJwjnnkCDctC/ssr/4911a8faffda0641ee2f30ac5ae327dae2396f06","Sv70zJ_VefJwjnnkCDctC/ssr/9cdb646b02792688dec5c37dca66f3f932bb88f1","Sv70zJ_VefJwjnnkCDctC/ssr/6ff46b6b6314d3dfb07ed7c4b6959e2da58d5510","Sv70zJ_VefJwjnnkCDctC/ssr/008328a40b4c1bf48e4d4a52a0140504266122b0","Sv70zJ_VefJwjnnkCDctC/ssr/d5364be67060739e798b692902b26eb83702ed4f","Sv70zJ_VefJwjnnkCDctC/ssr/31455ce5303a502a5c291c9c998c2c31fa63587d","Sv70zJ_VefJwjnnkCDctC/ssr/2c7162d3a6ae81897fb41d55701c73cf6db571c4","Sv70zJ_VefJwjnnkCDctC/ssr/88f021b5affca9330e1a98bf685b7a25ea1905cd","Sv70zJ_VefJwjnnkCDctC/ssr/8ccbc56708df217db4c9c0d52e6a48d8d59e093e","Sv70zJ_VefJwjnnkCDctC/ssr/81d2fccf64cbe765eb6e0393e2f1d7b5556248dc","Sv70zJ_VefJwjnnkCDctC/ssr/fab576abe2912e4adba53b6deba59e56f814e26a","Sv70zJ_VefJwjnnkCDctC/ssr/da516fa23a5d2553514372961d880948663398e1","Sv70zJ_VefJwjnnkCDctC/ssr/76de13f05026829e30b5fdd5914c38f5c5d6e2f8","Sv70zJ_VefJwjnnkCDctC/ssr/35b7dba0d675903d97318f7c832e763fa2c07cd3","Sv70zJ_VefJwjnnkCDctC/ssr/08a42571fb0c8804b9d6cffab51e7e8b8d15ef34","Sv70zJ_VefJwjnnkCDctC/ssr/162d415198735858141d31bd17c4adf7d6750e85","Sv70zJ_VefJwjnnkCDctC/ssr/31411a690c6a6199ffc0f9e89ab2f45a569e05d0","Sv70zJ_VefJwjnnkCDctC/ssr/ae9c2f564d57601b5973c252189b305c2dd0766d","Sv70zJ_VefJwjnnkCDctC/ssr/ed13c14b1fc821ab883c468dc4a31363ed953961","Sv70zJ_VefJwjnnkCDctC/ssr/af50f1185b48d62addac5c348f1a57074c040d71","Sv70zJ_VefJwjnnkCDctC/ssr/8c4f85c7417bed8cb4036f22466e0d924afe8efe","Sv70zJ_VefJwjnnkCDctC/ssr/bbb5513fd48ec448415cc832ed07aa99ce3dbfb1","Sv70zJ_VefJwjnnkCDctC/ssr/894a63336f8fa24c61e7b7bfe49e62b41fc1fec4","Sv70zJ_VefJwjnnkCDctC/ssr/9c2fc4a1f5aa128e15be29eb66a9b222a7edd8fd","Sv70zJ_VefJwjnnkCDctC/ssr/c2adedc70899c190d32d80100716bac7149843c4","Sv70zJ_VefJwjnnkCDctC/ssr/c6825d8696aa55b8533f19f5afa7623ccfa3e147","Sv70zJ_VefJwjnnkCDctC/ssr/9c466febf16e79aeea76db23c01564cc821b42aa","Sv70zJ_VefJwjnnkCDctC/ssr/158ffa51785aa7fbd6ee212bdd4b2df3dc75cc86","Sv70zJ_VefJwjnnkCDctC/ssr/5c9ee3f6838f0c667f00e43abda84d96b022be14","Sv70zJ_VefJwjnnkCDctC/ssr/628e1c5942d2468f3b3ca5f8199e4aa528e8f581","Sv70zJ_VefJwjnnkCDctC/ssr/f6c75a4f3e6cf647fbbaefc3587c21c343e609a0","Sv70zJ_VefJwjnnkCDctC/ssr/351229eaf479413b8f71070e085a4faf5c1432dc","Sv70zJ_VefJwjnnkCDctC/ssr/ad2a705e5bb442826b685e8f634600fb08d13a42","Sv70zJ_VefJwjnnkCDctC/ssr/3f3f4621a370e9dfe62e3c5f44d7dceb9526eac6","Sv70zJ_VefJwjnnkCDctC/ssr/c1aa3883410adffe95cd003833b044eee0131b2f","Sv70zJ_VefJwjnnkCDctC/ssr/d562100289e9d26bf0f318056f977e6b14105f24","Sv70zJ_VefJwjnnkCDctC/ssr/452355ec5ff93c66a015263b2c948968349d36d3","Sv70zJ_VefJwjnnkCDctC/ssr/09ea9f2ef190a2c44b791e9d37450699758f46af","Sv70zJ_VefJwjnnkCDctC/ssr/d515d4ffc2e203d9d3e7c1fc096471bbdc0c4aaa","Sv70zJ_VefJwjnnkCDctC/ssr/0eb5a2c93c645dd29fc66012d901405cc20c338b","Sv70zJ_VefJwjnnkCDctC/ssr/170882a72561807b8a346067e0a2da57b8b1000c","Sv70zJ_VefJwjnnkCDctC/ssr/254717b6d9263dc47f4b688cb1e39272676091af","Sv70zJ_VefJwjnnkCDctC/ssr/820f00c202350210c65051904ab413462e3eebb8","Sv70zJ_VefJwjnnkCDctC/ssr/663176d39f8fead3db22f34c002ee2bd488033cb","Sv70zJ_VefJwjnnkCDctC/ssr/9a4398512abcfaa3ac351f7ac6e2baffd3a81379","Sv70zJ_VefJwjnnkCDctC/ssr/0b164bbc5e0b194f10985360f88cd0aa3386c5d4","Sv70zJ_VefJwjnnkCDctC/ssr/ce7a1fa56c53811127835c9a49de1c7d1a660323","Sv70zJ_VefJwjnnkCDctC/ssr/bf652a35d42ca6df89bb1ed8469160412fd1158d","Sv70zJ_VefJwjnnkCDctC/ssr/996cec74552f48ba4b96ba1266ec732bc32f9e52","Sv70zJ_VefJwjnnkCDctC/ssr/223858851e2e3c9ef3b6988abdccfe75ba03fc3f","Sv70zJ_VefJwjnnkCDctC/ssr/6c1b9463133f2ed96e6e7c9848606cf4e98f5349","Sv70zJ_VefJwjnnkCDctC/ssr/34df0ef1330a29eb2af138803f25778ecc0119b1","Sv70zJ_VefJwjnnkCDctC/ssr/c48f49331b8d47b61b7d1002f7dfec1898e5fe68","Sv70zJ_VefJwjnnkCDctC/ssr/f0a68998883dce361b13abae7c910adef144df83","Sv70zJ_VefJwjnnkCDctC/ssr/a6cbefb7a412277b882366e9e236697e619f328f","Sv70zJ_VefJwjnnkCDctC/ssr/5b008a3507cfa6ade71132b321cb39233ab8533e","Sv70zJ_VefJwjnnkCDctC/ssr/d884027d3b10fb57307eeedb3e51b3acc5e0fc2d","Sv70zJ_VefJwjnnkCDctC/ssr/fdfdcc1f950624fdf41d263586b85d083a43aa52","Sv70zJ_VefJwjnnkCDctC/ssr/b1f82d09bec7ab9fc5e5625ac1f89de7c9a78282","Sv70zJ_VefJwjnnkCDctC/ssr/ac7d67a28e34fbf74670b344822ec819705c72c8","Sv70zJ_VefJwjnnkCDctC/ssr/e515a77eaf480b778ad89ec036f7e437ae5e9609","Sv70zJ_VefJwjnnkCDctC/ssr/0551f4c98fc518c371aa306e3ddbad88c20e1d55","Sv70zJ_VefJwjnnkCDctC/ssr/8e4388c50c710c042e22ec1af4390e279ebc6648","Sv70zJ_VefJwjnnkCDctC/ssr/34624b1d1de27fcd5081defc4f42bcc5a107cad3","Sv70zJ_VefJwjnnkCDctC/ssr/cd66063ed4fe0d4de42a2b32fb2c341813252b55","Sv70zJ_VefJwjnnkCDctC/ssr/0aecaf88ba7ae6f5fabb7470190c09818a245ed9","Sv70zJ_VefJwjnnkCDctC/ssr/2bea1ef0ffeac0c9c93ae42e5db78db5e44b587e","Sv70zJ_VefJwjnnkCDctC/ssr/838cb839340a07873d557412c5e49aa4e9119c29","Sv70zJ_VefJwjnnkCDctC/ssr/58fb45c9eb05a961625c5c6e41583c0732184cbf","Sv70zJ_VefJwjnnkCDctC/ssr/ba8a90b824592ceda0530a2cd3102e59ba6f91fe","Sv70zJ_VefJwjnnkCDctC/ssr/755216c401bc86e57923d13d970b3add9e765a4f","Sv70zJ_VefJwjnnkCDctC/ssr/9a3bf53517d2a4c3addc236ff717f1304caee9bf","Sv70zJ_VefJwjnnkCDctC/ssr/74ed6f2492ce5b3974aa3531ecdd7969d5802f5c","Sv70zJ_VefJwjnnkCDctC/ssr/36c35a7831ac6a12406b0071bbc01c85a64c2f09","Sv70zJ_VefJwjnnkCDctC/ssr/a69643eaa40e41bd8aa4603f3a1d1cbd4e158dce","Sv70zJ_VefJwjnnkCDctC/ssr/c603b8fb065f1627cadccb40958ee7f81114ef4d","Sv70zJ_VefJwjnnkCDctC/ssr/26de644d4995473009b7631a28db744864c4764b","Sv70zJ_VefJwjnnkCDctC/ssr/9b2f26b3936d13542c1f9f6c6efbacd1fed3b39d","Sv70zJ_VefJwjnnkCDctC/ssr/6e3d553be2d2f4a7fbccd992187ebfbe43b4e8a9","Sv70zJ_VefJwjnnkCDctC/ssr/5a2b0df0cb7fd278bb3d426ec69b61f0377e5b15","Sv70zJ_VefJwjnnkCDctC/ssr/b82c021e58fb56dff2861bdc4631752c0b56acc1","Sv70zJ_VefJwjnnkCDctC/ssr/6698ce88403439ccc8dfcb4987510d1714b22c79","Sv70zJ_VefJwjnnkCDctC/ssr/7e64cff11ee61529273a28f16e66545e3c10ed7c","Sv70zJ_VefJwjnnkCDctC/ssr/9a741f3dd6fd5809166de2f0c022f98f2a19b743","Sv70zJ_VefJwjnnkCDctC/ssr/629d47f9a3a86fce99de315c045c5938e8be765f","Sv70zJ_VefJwjnnkCDctC/ssr/b941acdbfdac60db060c25f59264a98eec151055","Sv70zJ_VefJwjnnkCDctC/ssr/48d89bacab2af0dedf4f009a204e4438ef3db6eb","Sv70zJ_VefJwjnnkCDctC/ssr/9572c9465bbad942e5917c5b9ee6018efc4305fa","Sv70zJ_VefJwjnnkCDctC/ssr/a9010b078fa9d9c0e11a2a49b32e7ad761ce8aed","Sv70zJ_VefJwjnnkCDctC/ssr/492ddead3d10a6520babbc58aa579871a8aa74bf","Sv70zJ_VefJwjnnkCDctC/ssr/4d806a05ae6f765a5e5f45ce7dee4af787b87360","Sv70zJ_VefJwjnnkCDctC/ssr/2423f5a2ee7a6602d047bcdb473628462bc3cfdb","Sv70zJ_VefJwjnnkCDctC/ssr/71ebda753b30298ee8df65705da598dacc90e576","Sv70zJ_VefJwjnnkCDctC/ssr/db9374acb79c55a348d1e0cb91596bd6ceb10a46","Sv70zJ_VefJwjnnkCDctC/ssr/04c31cd9d29e65042eb819a92c00db419b6374ec","Sv70zJ_VefJwjnnkCDctC/ssr/2433d9b37ebfd55b5a22d8165c058d4640718980","Sv70zJ_VefJwjnnkCDctC/ssr/610ef813701155348a6ae348d77ff02d8d90625b","Sv70zJ_VefJwjnnkCDctC/ssr/424c11e49966d5f0e28e568d2fd38071338cf583","Sv70zJ_VefJwjnnkCDctC/ssr/ef4b1551065fa9fbc8a4f3960477438a4124ebfc","Sv70zJ_VefJwjnnkCDctC/ssr/209ef97a57202af3c590245a2a6459b05ed2bc76","Sv70zJ_VefJwjnnkCDctC/ssr/f676ab4f721dad1ae78872ff557ad634494fc40a","Sv70zJ_VefJwjnnkCDctC/ssr/5b64af36c9c42eb30d430c166b2774ac74b8b363","Sv70zJ_VefJwjnnkCDctC/ssr/93ed55c3ae31357f7e80c7f369c8c59d9f0112cb","Sv70zJ_VefJwjnnkCDctC/ssr/83cbd66c88465d3b2679eaaab4407cf80721d7bc","Sv70zJ_VefJwjnnkCDctC/ssr/8b32ccb8244da40b454a2ac27bda2e4aee749fbf","Sv70zJ_VefJwjnnkCDctC/ssr/38f5bfa52834c928215381c9f9329e447c0d06cc","Sv70zJ_VefJwjnnkCDctC/ssr/dae2d57161ff35b6af32fb5f6ebc40ae6fcf37ad","Sv70zJ_VefJwjnnkCDctC/ssr/605c73e2c8230b73996cb7980cce2b0095f5be1c","Sv70zJ_VefJwjnnkCDctC/ssr/6698fc6c9bf9b4d90409b243a6f828d919fac87e","Sv70zJ_VefJwjnnkCDctC/ssr/ae21b8913f01a4ed7ffcd98ebc3182c1b01bbf70","Sv70zJ_VefJwjnnkCDctC/ssr/43bca728b1f279e9d412b1fcd2030e315b971722","Sv70zJ_VefJwjnnkCDctC/ssr/b6020c6f92e349604cdfdd2d6d579fcfcd5c31f8","Sv70zJ_VefJwjnnkCDctC/ssr/a617e5838c576056d39d4230104d06393f35bb6e","Sv70zJ_VefJwjnnkCDctC/ssr/3986e4877b58d07219946b2108421ce55ad6f959","Sv70zJ_VefJwjnnkCDctC/ssr/1feae06d3c90ed2e3875a1ce044dc373a3252ccf","Sv70zJ_VefJwjnnkCDctC/ssr/146991546b310b2af6bb6de755ad7d0b1cf38f92","Sv70zJ_VefJwjnnkCDctC/ssr/98ce595f163e64b5099e998d96a1c020d890587d","Sv70zJ_VefJwjnnkCDctC/ssr/b26f46f7885db47c3eba2bffc6d45f6e0ce7a9b5","Sv70zJ_VefJwjnnkCDctC/ssr/b63bf13d0ef6e1dd1842ec1cbf15a3f65532b66b","Sv70zJ_VefJwjnnkCDctC/ssr/b1d331711b6511dc7892829a21ca4e2cd9c80975","Sv70zJ_VefJwjnnkCDctC/ssr/e0aaf6150b6ea14c8d4e6dce5954c0e9d8998144","Sv70zJ_VefJwjnnkCDctC/ssr/f680c1cee894d5bab7fd249a549e3ab7f57571d9","Sv70zJ_VefJwjnnkCDctC/ssr/69acf08728a2467c4d8e6de2b923c5c0182bba75","Sv70zJ_VefJwjnnkCDctC/ssr/356c1bc00d454ec31a7e8deba884081cf00e912f","Sv70zJ_VefJwjnnkCDctC/ssr/43846eb0b29320bffbddea62d57d06a060ec6756","Sv70zJ_VefJwjnnkCDctC/ssr/8d0cafa0b66ed744e46194ecc9b0d80b4942450c","Sv70zJ_VefJwjnnkCDctC/ssr/08fa404ad5186677dedfa098a02f9825aea9e620","Sv70zJ_VefJwjnnkCDctC/ssr/dea35a265fa2fceacc8c4e3154f1603e4ff93673","Sv70zJ_VefJwjnnkCDctC/ssr/e86830316da1ab792a08457dac1f03fdda992fd3","Sv70zJ_VefJwjnnkCDctC/ssr/37146fe439fee0c8b935bbb43e284e4caae40979","Sv70zJ_VefJwjnnkCDctC/ssr/3688c24bfc01d628a53212f950efccce099117ab","Sv70zJ_VefJwjnnkCDctC/ssr/7868bef71390d9ea30f4a8cd5e68688ee720b256","Sv70zJ_VefJwjnnkCDctC/ssr/0e55eb0d05466eeea0d82e9bbd8003a0ea278e13","Sv70zJ_VefJwjnnkCDctC/ssr/83aa992657c5f8f7db14c66c8434fc501b4868ff","Sv70zJ_VefJwjnnkCDctC/ssr/7eb3dfcee8fedbdf288c8fc09086476c32cee5d5","Sv70zJ_VefJwjnnkCDctC/ssr/9e6d4bb86d2579762e7709636fe1e053d3cda002","Sv70zJ_VefJwjnnkCDctC/ssr/07509d348750849e4c46686c31ad075782410c75","Sv70zJ_VefJwjnnkCDctC/ssr/97593a4b0c29791200dfa6960c2ee4ab7f409244","Sv70zJ_VefJwjnnkCDctC/ssr/61b0a452891da57cf0a1d3d57a6403b541fee6a9","Sv70zJ_VefJwjnnkCDctC/ssr/07960523deb017bcba627a471f768c45b2615df8","Sv70zJ_VefJwjnnkCDctC/ssr/5a778f2e05728c4197a459581e505ccfd0e66b63","Sv70zJ_VefJwjnnkCDctC/ssr/6c0f4d768eb2b72f31c5501d0d9949ff416749cf","Sv70zJ_VefJwjnnkCDctC/ssr/d3a3c3c417c647198b46a0446afe908c8c8a12f8","Sv70zJ_VefJwjnnkCDctC/ssr/6c2627bed0d9f3d6466f5cf7d93a9480070666a2","Sv70zJ_VefJwjnnkCDctC/ssr/0df2859dbcfefe36df96cb68086100a5f5f3173d","Sv70zJ_VefJwjnnkCDctC/ssr/4b14c1f05f2c000bcda2d6d55df6d4c60793f352","Sv70zJ_VefJwjnnkCDctC/ssr/c4c785a7045db28c6dc5a6d93c31a29d3acc7d49","Sv70zJ_VefJwjnnkCDctC/ssr/9ffd0b989dd8a29ace3a14f29b2b7377731d31c5","Sv70zJ_VefJwjnnkCDctC/ssr/9d168bbfe0c29204e18e87ee7310b84739092bf7","Sv70zJ_VefJwjnnkCDctC/ssr/0abc76be8721de4db9c4868dec4524112fdd6f2c","Sv70zJ_VefJwjnnkCDctC/ssr/b6d9b22942df0a899302e1176fcafeda9028fe58","Sv70zJ_VefJwjnnkCDctC/ssr/f63427ef5f12e90f9111e8d75fa086a4cafcdbcc","Sv70zJ_VefJwjnnkCDctC/ssr/65a33a521816e4b1753706b25893c0e55df91474","Sv70zJ_VefJwjnnkCDctC/ssr/0dd0e394c0fdb25342f9eeb0a01114eb60c18c05","Sv70zJ_VefJwjnnkCDctC/ssr/d0baae87822755c3fde223325472423fe2ad14a8","Sv70zJ_VefJwjnnkCDctC/ssr/31ba2897101251b752e107220be6812d30ec1fee","Sv70zJ_VefJwjnnkCDctC/ssr/aa9f8190066645f5fab5c1adb9f92eaa9f94a105","Sv70zJ_VefJwjnnkCDctC/ssr/c76e8b4622d44ba9927de762dc23f7a987ae73a4","Sv70zJ_VefJwjnnkCDctC/ssr/8e6c16f1af662610c46925f5d5a0deec5e973c8f","Sv70zJ_VefJwjnnkCDctC/ssr/ceb5820a1d2dafdc98850dade09986af4670a69b","Sv70zJ_VefJwjnnkCDctC/ssr/db3588308c77c65e3f4e2c770be9ec08f892d685","Sv70zJ_VefJwjnnkCDctC/ssr/f42575b871470f135d3176f40e29562c566f6297","Sv70zJ_VefJwjnnkCDctC/ssr/e8b4796bdbeb7695fff36b2e95351775b9fa77dd","Sv70zJ_VefJwjnnkCDctC/ssr/5263a98dfa8d2e289ea0627d11e79a45f28fa127","Sv70zJ_VefJwjnnkCDctC/ssr/91817ba2877b2bf6e7630a7cc5c9ad267b50fcaf","Sv70zJ_VefJwjnnkCDctC/ssr/defd665e660f1dabd067511368daf8aa031e40e6","Sv70zJ_VefJwjnnkCDctC/ssr/a71a679e59193ddda0d2f5001d6ce4ef4a6cd1de","Sv70zJ_VefJwjnnkCDctC/ssr/69f1cc96b5ebd7cd945774498548b28777b8fb1e","Sv70zJ_VefJwjnnkCDctC/ssr/5d0d60d47a110056b41ec6e7a1f6d8de52a9ff0f","Sv70zJ_VefJwjnnkCDctC/ssr/b43f91759e6747b4144274b34cebf8bf1ef0e206","Sv70zJ_VefJwjnnkCDctC/ssr/b40a7b9ac1be360370748b935875cecfa8ea2527","Sv70zJ_VefJwjnnkCDctC/ssr/9caf09b5b6871a20968284cfc0914a6dddf1be14","Sv70zJ_VefJwjnnkCDctC/ssr/313016b24e608f2f067bd0a115ec48875edc21b5","Sv70zJ_VefJwjnnkCDctC/ssr/b86a2ba4a89c2da15adc2e248de6e9cf85360c5c","Sv70zJ_VefJwjnnkCDctC/ssr/3b65ebe9fcd12fe24a76bb927137b4222fe8e2ed","Sv70zJ_VefJwjnnkCDctC/ssr/3680b99cae573437b28c31d14053ab82aa2ff218","Sv70zJ_VefJwjnnkCDctC/ssr/4d2ca6f32a599a77625c91e851b5ee47802c71ae","Sv70zJ_VefJwjnnkCDctC/ssr/b27687e52e8c53384196d545873e9acd3c891889","Sv70zJ_VefJwjnnkCDctC/ssr/3500fc73fee410ed58f71ea53b1752db38b4a992","Sv70zJ_VefJwjnnkCDctC/ssr/1fcf132f314576ab88083820a691bd09bdbb6c71","Sv70zJ_VefJwjnnkCDctC/ssr/723db991cfb55705a53a470f1fef4b48e7326112","Sv70zJ_VefJwjnnkCDctC/ssr/b52821238d6f764d22cb048b650da96205c329cb","Sv70zJ_VefJwjnnkCDctC/ssr/0e5f9bdc4a9c328e402fd5403ef75abee83ccee9","Sv70zJ_VefJwjnnkCDctC/ssr/e1f7c6ccd2bf53f3f9d947a8c4590bcc1629a888","Sv70zJ_VefJwjnnkCDctC/ssr/3303a07f8acc2f81074668777c6e25c22ed967e9","Sv70zJ_VefJwjnnkCDctC/ssr/cfa1c36be30ed00d7918b112312230f8007351f1","Sv70zJ_VefJwjnnkCDctC/ssr/b36cb2afcb35c2418f36d243608e4a7b9b2952d4","Sv70zJ_VefJwjnnkCDctC/ssr/bca292541ae1ce0542406457e11e248f37b9f1f8","Sv70zJ_VefJwjnnkCDctC/ssr/7e1ef2892230a0b7d2c84a8aaf71eb41817c6eb4","Sv70zJ_VefJwjnnkCDctC/ssr/965a4acdf761ac29a47e461cc6fcb1fec1f90dda","Sv70zJ_VefJwjnnkCDctC/ssr/ba5ef04ddcca9b567a04ee2e24b334cd994e815c","Sv70zJ_VefJwjnnkCDctC/ssr/ee1129b0e27d116acad909c42bff055183d521ae","Sv70zJ_VefJwjnnkCDctC/ssr/d5778fd1adc167ca6293dab0abdfa62264707917","tmp.iOU32nzqCx/store/agents.ndjson","tmp.iOU32nzqCx/store/runs.ndjson","tmp.iOU32nzqCx/store/run_events.ndjson","tmp.iOU32nzqCx/store/checkpoints.ndjson","tmp.vKYnC7f9uh/store/agents.ndjson","tmp.vKYnC7f9uh/store/runs.ndjson","tmp.vKYnC7f9uh/store/run_events.ndjson","tmp.vKYnC7f9uh/store/checkpoints.ndjson","tmp.qjI2uPTcHz/store/agents.ndjson","tmp.qjI2uPTcHz/store/runs.ndjson","tmp.qjI2uPTcHz/store/run_events.ndjson","tmp.qjI2uPTcHz/store/checkpoints.ndjson","react-doctor-4e289efd-db39-4bbb-afec-26444c70c8a9/diagnostics.json","react-doctor-4e289efd-db39-4bbb-afec-26444c70c8a9/react-doctor--prefer-module-scope-pure-function.txt","react-doctor-79ce569f-546c-407a-affb-2f0d6641a3c1/diagnostics.json","react-doctor-79ce569f-546c-407a-affb-2f0d6641a3c1/react-doctor--prefer-useReducer.txt","react-doctor-79ce569f-546c-407a-affb-2f0d6641a3c1/react-doctor--rerender-lazy-ref-init.txt","react-doctor-79ce569f-546c-407a-affb-2f0d6641a3c1/react-doctor--no-render-in-render.txt","react-doctor-79ce569f-546c-407a-affb-2f0d6641a3c1/react-doctor--exhaustive-deps.txt","react-doctor-79ce569f-546c-407a-affb-2f0d6641a3c1/react-doctor--no-event-handler.txt","react-doctor-79ce569f-546c-407a-affb-2f0d6641a3c1/react-doctor--server-sequential-independent-await.txt","react-doctor-79ce569f-546c-407a-affb-2f0d6641a3c1/react-doctor--js-combine-iterations.txt","react-doctor-79ce569f-546c-407a-affb-2f0d6641a3c1/react-doctor--async-await-in-loop.txt","react-doctor-79ce569f-546c-407a-affb-2f0d6641a3c1/react-doctor--no-cascading-set-state.txt","react-doctor-79ce569f-546c-407a-affb-2f0d6641a3c1/react-doctor--no-barrel-import.txt","react-doctor-79ce569f-546c-407a-affb-2f0d6641a3c1/react-hooks-js--set-state-in-effect.txt","react-doctor-79ce569f-546c-407a-affb-2f0d6641a3c1/react-hooks-js--preserve-manual-memoization.txt","react-doctor-79ce569f-546c-407a-affb-2f0d6641a3c1/react-doctor--only-export-components.txt","react-doctor-79ce569f-546c-407a-affb-2f0d6641a3c1/react-doctor--react-compiler-no-manual-memoization.txt","react-doctor-79ce569f-546c-407a-affb-2f0d6641a3c1/react-doctor--rn-prefer-expo-image.txt","react-doctor-79ce569f-546c-407a-affb-2f0d6641a3c1/react-doctor--no-giant-component.txt","react-doctor-79ce569f-546c-407a-affb-2f0d6641a3c1/react-doctor--no-derived-state.txt","react-doctor-79ce569f-546c-407a-affb-2f0d6641a3c1/react-doctor--no-chain-state-updates.txt","react-doctor-79ce569f-546c-407a-affb-2f0d6641a3c1/react-doctor--rn-style-prefer-boxshadow.txt","react-doctor-79ce569f-546c-407a-affb-2f0d6641a3c1/react-doctor--rn-no-legacy-shadow-styles.txt","tmp.rnt6jWdd66/store/agents.ndjson","tmp.rnt6jWdd66/store/runs.ndjson","tmp.rnt6jWdd66/store/run_events.ndjson","tmp.rnt6jWdd66/store/checkpoints.ndjson","tmp.jPtDqRD123/store/agents.ndjson","tmp.jPtDqRD123/store/runs.ndjson","tmp.jPtDqRD123/store/run_events.ndjson","tmp.jPtDqRD123/store/checkpoints.ndjson","tmp.jPtDqRD123/workspace/fixture.txt","tmp.x8cNhhZUbp/store/agents.ndjson","tmp.x8cNhhZUbp/store/runs.ndjson","tmp.x8cNhhZUbp/store/run_events.ndjson","tmp.x8cNhhZUbp/store/checkpoints.ndjson","tmp.g5gLilKPNJ/store/agents.ndjson","tmp.g5gLilKPNJ/store/runs.ndjson","tmp.g5gLilKPNJ/store/run_events.ndjson","tmp.zMdRdRTzEA/store/agents.ndjson","tmp.zMdRdRTzEA/store/runs.ndjson","tmp.qpYdIp2c36/store/agents.ndjson","tmp.qpYdIp2c36/store/runs.ndjson","tmp.qpYdIp2c36/store/run_events.ndjson","screenstudio/polyrecorder-discover-logs/polyrecorder-discovery-1781651188960.log","julius-code-insiders-zsh/.zlogin","julius-code-insiders-zsh/.zshenv","julius-code-insiders-zsh/.zprofile","julius-code-insiders-zsh/.zshrc","gitkraken/gitlens/gitlens-ipc-server-39753-58539.json","gitkraken/gitlens/agents/gitlens-ipc-server-39753-58539.json","react-doctor-c70aa040-70de-4f72-88fb-2459f7e6d242/diagnostics.json","react-doctor-c70aa040-70de-4f72-88fb-2459f7e6d242/react-doctor--no-render-in-render.txt","react-doctor-c70aa040-70de-4f72-88fb-2459f7e6d242/react-doctor--js-combine-iterations.txt","react-doctor-c70aa040-70de-4f72-88fb-2459f7e6d242/react-doctor--rerender-lazy-ref-init.txt","react-doctor-c70aa040-70de-4f72-88fb-2459f7e6d242/react-doctor--no-barrel-import.txt","react-doctor-c70aa040-70de-4f72-88fb-2459f7e6d242/react-doctor--no-cascading-set-state.txt","react-doctor-c70aa040-70de-4f72-88fb-2459f7e6d242/react-doctor--async-await-in-loop.txt","react-doctor-c70aa040-70de-4f72-88fb-2459f7e6d242/react-hooks-js--set-state-in-effect.txt","react-doctor-c70aa040-70de-4f72-88fb-2459f7e6d242/react-hooks-js--preserve-manual-memoization.txt","react-doctor-c70aa040-70de-4f72-88fb-2459f7e6d242/react-doctor--exhaustive-deps.txt","react-doctor-c70aa040-70de-4f72-88fb-2459f7e6d242/react-doctor--no-event-handler.txt","react-doctor-c70aa040-70de-4f72-88fb-2459f7e6d242/react-doctor--server-sequential-independent-await.txt","react-doctor-c70aa040-70de-4f72-88fb-2459f7e6d242/react-doctor--prefer-useReducer.txt","react-doctor-c70aa040-70de-4f72-88fb-2459f7e6d242/react-doctor--only-export-components.txt","react-doctor-c70aa040-70de-4f72-88fb-2459f7e6d242/react-doctor--react-compiler-no-manual-memoization.txt","react-doctor-c70aa040-70de-4f72-88fb-2459f7e6d242/react-doctor--rn-style-prefer-boxshadow.txt","react-doctor-c70aa040-70de-4f72-88fb-2459f7e6d242/react-doctor--rn-no-legacy-shadow-styles.txt","react-doctor-c70aa040-70de-4f72-88fb-2459f7e6d242/react-doctor--no-derived-state.txt","react-doctor-c70aa040-70de-4f72-88fb-2459f7e6d242/react-doctor--no-chain-state-updates.txt","react-doctor-c70aa040-70de-4f72-88fb-2459f7e6d242/react-doctor--rn-prefer-expo-image.txt","react-doctor-c70aa040-70de-4f72-88fb-2459f7e6d242/react-doctor--no-giant-component.txt","react-doctor-923097e1-1901-414f-b867-ad3ed750c42f/diagnostics.json","react-doctor-923097e1-1901-414f-b867-ad3ed750c42f/react-doctor--prefer-useReducer.txt","react-doctor-923097e1-1901-414f-b867-ad3ed750c42f/react-doctor--async-await-in-loop.txt","react-doctor-923097e1-1901-414f-b867-ad3ed750c42f/react-doctor--rerender-lazy-ref-init.txt","react-doctor-923097e1-1901-414f-b867-ad3ed750c42f/react-doctor--no-cascading-set-state.txt","react-doctor-923097e1-1901-414f-b867-ad3ed750c42f/react-hooks-js--preserve-manual-memoization.txt","react-doctor-923097e1-1901-414f-b867-ad3ed750c42f/react-doctor--js-combine-iterations.txt","react-doctor-923097e1-1901-414f-b867-ad3ed750c42f/react-hooks-js--set-state-in-effect.txt","react-doctor-923097e1-1901-414f-b867-ad3ed750c42f/react-doctor--no-event-handler.txt","react-doctor-923097e1-1901-414f-b867-ad3ed750c42f/react-doctor--exhaustive-deps.txt","react-doctor-923097e1-1901-414f-b867-ad3ed750c42f/react-doctor--no-render-in-render.txt","react-doctor-923097e1-1901-414f-b867-ad3ed750c42f/react-doctor--no-barrel-import.txt","react-doctor-923097e1-1901-414f-b867-ad3ed750c42f/react-doctor--only-export-components.txt","react-doctor-923097e1-1901-414f-b867-ad3ed750c42f/react-doctor--server-sequential-independent-await.txt","react-doctor-923097e1-1901-414f-b867-ad3ed750c42f/react-doctor--react-compiler-no-manual-memoization.txt","react-doctor-923097e1-1901-414f-b867-ad3ed750c42f/react-doctor--rn-prefer-expo-image.txt","react-doctor-923097e1-1901-414f-b867-ad3ed750c42f/react-doctor--no-giant-component.txt","react-doctor-923097e1-1901-414f-b867-ad3ed750c42f/react-doctor--rn-style-prefer-boxshadow.txt","react-doctor-923097e1-1901-414f-b867-ad3ed750c42f/react-doctor--rn-no-legacy-shadow-styles.txt","react-doctor-923097e1-1901-414f-b867-ad3ed750c42f/react-doctor--no-derived-state.txt","react-doctor-923097e1-1901-414f-b867-ad3ed750c42f/react-doctor--no-chain-state-updates.txt","react-doctor-c75d1898-35bf-4040-9291-143a461c0bc2/diagnostics.json","react-doctor-c75d1898-35bf-4040-9291-143a461c0bc2/react-hooks-js--preserve-manual-memoization.txt","react-doctor-c75d1898-35bf-4040-9291-143a461c0bc2/react-doctor--no-barrel-import.txt","react-doctor-c75d1898-35bf-4040-9291-143a461c0bc2/react-doctor--no-render-in-render.txt","react-doctor-c75d1898-35bf-4040-9291-143a461c0bc2/react-doctor--prefer-useReducer.txt","react-doctor-c75d1898-35bf-4040-9291-143a461c0bc2/react-doctor--no-cascading-set-state.txt","react-doctor-c75d1898-35bf-4040-9291-143a461c0bc2/react-doctor--js-combine-iterations.txt","react-doctor-c75d1898-35bf-4040-9291-143a461c0bc2/react-hooks-js--set-state-in-effect.txt","react-doctor-c75d1898-35bf-4040-9291-143a461c0bc2/react-doctor--exhaustive-deps.txt","react-doctor-c75d1898-35bf-4040-9291-143a461c0bc2/react-doctor--no-event-handler.txt","react-doctor-c75d1898-35bf-4040-9291-143a461c0bc2/react-doctor--server-sequential-independent-await.txt","react-doctor-c75d1898-35bf-4040-9291-143a461c0bc2/react-doctor--async-await-in-loop.txt","react-doctor-c75d1898-35bf-4040-9291-143a461c0bc2/react-doctor--rerender-lazy-ref-init.txt","react-doctor-c75d1898-35bf-4040-9291-143a461c0bc2/react-doctor--only-export-components.txt","react-doctor-c75d1898-35bf-4040-9291-143a461c0bc2/react-doctor--react-compiler-no-manual-memoization.txt","react-doctor-c75d1898-35bf-4040-9291-143a461c0bc2/react-doctor--no-derived-state.txt","react-doctor-c75d1898-35bf-4040-9291-143a461c0bc2/react-doctor--no-chain-state-updates.txt","react-doctor-c75d1898-35bf-4040-9291-143a461c0bc2/react-doctor--rn-style-prefer-boxshadow.txt","react-doctor-c75d1898-35bf-4040-9291-143a461c0bc2/react-doctor--rn-no-legacy-shadow-styles.txt","react-doctor-c75d1898-35bf-4040-9291-143a461c0bc2/react-doctor--rn-prefer-expo-image.txt","react-doctor-c75d1898-35bf-4040-9291-143a461c0bc2/react-doctor--no-giant-component.txt",".tmp0v8kOo/tracing.js",".tmp0v8kOo/meriyah.umd.min.js",".tmp0v8kOo/privileged-node-repl-config.js",".tmp0v8kOo/privileged-node-repl.js",".tmp0v8kOo/diagnostics.js",".tmp0v8kOo/kernel.js","t3-orchestrator-v2-subagent-oacb4S/.git/logs/refs/heads/main","t3-orchestrator-v2-subagent-oacb4S/.git/logs/HEAD","t3-orchestrator-v2-subagent-oacb4S/.git/refs/heads/main","t3-orchestrator-v2-subagent-oacb4S/.git/COMMIT_EDITMSG","t3-orchestrator-v2-subagent-oacb4S/README.md","t3-orchestrator-v2-subagent-oacb4S/.git/config","t3-orchestrator-v2-subagent-oacb4S/.git/HEAD","t3-orchestrator-v2-subagent-oacb4S/.git/hooks/push-to-checkout.sample","t3-orchestrator-v2-subagent-oacb4S/.git/hooks/update.sample","t3-orchestrator-v2-subagent-oacb4S/.git/hooks/pre-push.sample","t3-orchestrator-v2-subagent-oacb4S/.git/hooks/pre-applypatch.sample","t3-orchestrator-v2-subagent-oacb4S/.git/hooks/pre-merge-commit.sample","t3-orchestrator-v2-subagent-oacb4S/.git/hooks/post-update.sample","t3-orchestrator-v2-subagent-oacb4S/.git/hooks/prepare-commit-msg.sample","t3-orchestrator-v2-subagent-oacb4S/.git/hooks/pre-receive.sample","t3-orchestrator-v2-subagent-oacb4S/.git/hooks/fsmonitor-watchman.sample","t3-orchestrator-v2-subagent-oacb4S/.git/hooks/applypatch-msg.sample","t3-orchestrator-v2-subagent-oacb4S/.git/hooks/pre-commit.sample","t3-orchestrator-v2-subagent-oacb4S/.git/hooks/sendemail-validate.sample","t3-orchestrator-v2-subagent-oacb4S/.git/hooks/pre-rebase.sample","t3-orchestrator-v2-subagent-oacb4S/.git/hooks/commit-msg.sample","t3-orchestrator-v2-subagent-oacb4S/.git/description","t3-orchestrator-v2-subagent-oacb4S/.git/info/exclude","6I2aNB1hLUYb8xMmS8D-A/ssr/03512668e6e78af858678dc39f94b4ebfd9a1636","6I2aNB1hLUYb8xMmS8D-A/ssr/fdc533205cc4baba09e204fbdf8df01390315412","6I2aNB1hLUYb8xMmS8D-A/ssr/3f7629ddfb31c7d1882e4a63c41b471931502692","6I2aNB1hLUYb8xMmS8D-A/ssr/860676e14ee3d69d53c9738f0fd4bda9479d233e","6I2aNB1hLUYb8xMmS8D-A/ssr/34df0ef1330a29eb2af138803f25778ecc0119b1","6I2aNB1hLUYb8xMmS8D-A/ssr/c48f49331b8d47b61b7d1002f7dfec1898e5fe68","6I2aNB1hLUYb8xMmS8D-A/ssr/f0a68998883dce361b13abae7c910adef144df83","6I2aNB1hLUYb8xMmS8D-A/ssr/0551f4c98fc518c371aa306e3ddbad88c20e1d55","6I2aNB1hLUYb8xMmS8D-A/ssr/4d806a05ae6f765a5e5f45ce7dee4af787b87360","6I2aNB1hLUYb8xMmS8D-A/ssr/8e4388c50c710c042e22ec1af4390e279ebc6648","6I2aNB1hLUYb8xMmS8D-A/ssr/cd66063ed4fe0d4de42a2b32fb2c341813252b55","6I2aNB1hLUYb8xMmS8D-A/ssr/26de644d4995473009b7631a28db744864c4764b","6I2aNB1hLUYb8xMmS8D-A/ssr/0aecaf88ba7ae6f5fabb7470190c09818a245ed9","6I2aNB1hLUYb8xMmS8D-A/ssr/2bea1ef0ffeac0c9c93ae42e5db78db5e44b587e","6I2aNB1hLUYb8xMmS8D-A/ssr/838cb839340a07873d557412c5e49aa4e9119c29","6I2aNB1hLUYb8xMmS8D-A/ssr/58fb45c9eb05a961625c5c6e41583c0732184cbf","6I2aNB1hLUYb8xMmS8D-A/ssr/ba8a90b824592ceda0530a2cd3102e59ba6f91fe","6I2aNB1hLUYb8xMmS8D-A/ssr/755216c401bc86e57923d13d970b3add9e765a4f","6I2aNB1hLUYb8xMmS8D-A/ssr/a69643eaa40e41bd8aa4603f3a1d1cbd4e158dce","6I2aNB1hLUYb8xMmS8D-A/ssr/c603b8fb065f1627cadccb40958ee7f81114ef4d","6I2aNB1hLUYb8xMmS8D-A/ssr/71ebda753b30298ee8df65705da598dacc90e576","6I2aNB1hLUYb8xMmS8D-A/ssr/db9374acb79c55a348d1e0cb91596bd6ceb10a46","6I2aNB1hLUYb8xMmS8D-A/ssr/04c31cd9d29e65042eb819a92c00db419b6374ec","6I2aNB1hLUYb8xMmS8D-A/ssr/2433d9b37ebfd55b5a22d8165c058d4640718980","6I2aNB1hLUYb8xMmS8D-A/ssr/610ef813701155348a6ae348d77ff02d8d90625b","6I2aNB1hLUYb8xMmS8D-A/ssr/424c11e49966d5f0e28e568d2fd38071338cf583","6I2aNB1hLUYb8xMmS8D-A/ssr/ef4b1551065fa9fbc8a4f3960477438a4124ebfc","6I2aNB1hLUYb8xMmS8D-A/ssr/209ef97a57202af3c590245a2a6459b05ed2bc76","6I2aNB1hLUYb8xMmS8D-A/ssr/f676ab4f721dad1ae78872ff557ad634494fc40a","6I2aNB1hLUYb8xMmS8D-A/ssr/5b64af36c9c42eb30d430c166b2774ac74b8b363","6I2aNB1hLUYb8xMmS8D-A/ssr/93ed55c3ae31357f7e80c7f369c8c59d9f0112cb","6I2aNB1hLUYb8xMmS8D-A/ssr/83cbd66c88465d3b2679eaaab4407cf80721d7bc","6I2aNB1hLUYb8xMmS8D-A/ssr/8b32ccb8244da40b454a2ac27bda2e4aee749fbf","6I2aNB1hLUYb8xMmS8D-A/ssr/38f5bfa52834c928215381c9f9329e447c0d06cc","6I2aNB1hLUYb8xMmS8D-A/ssr/dae2d57161ff35b6af32fb5f6ebc40ae6fcf37ad","6I2aNB1hLUYb8xMmS8D-A/ssr/605c73e2c8230b73996cb7980cce2b0095f5be1c","6I2aNB1hLUYb8xMmS8D-A/ssr/6698fc6c9bf9b4d90409b243a6f828d919fac87e","6I2aNB1hLUYb8xMmS8D-A/ssr/ae21b8913f01a4ed7ffcd98ebc3182c1b01bbf70","6I2aNB1hLUYb8xMmS8D-A/ssr/43bca728b1f279e9d412b1fcd2030e315b971722","6I2aNB1hLUYb8xMmS8D-A/ssr/b6020c6f92e349604cdfdd2d6d579fcfcd5c31f8","6I2aNB1hLUYb8xMmS8D-A/ssr/a617e5838c576056d39d4230104d06393f35bb6e","6I2aNB1hLUYb8xMmS8D-A/ssr/3986e4877b58d07219946b2108421ce55ad6f959","6I2aNB1hLUYb8xMmS8D-A/ssr/1feae06d3c90ed2e3875a1ce044dc373a3252ccf","6I2aNB1hLUYb8xMmS8D-A/ssr/146991546b310b2af6bb6de755ad7d0b1cf38f92","6I2aNB1hLUYb8xMmS8D-A/ssr/98ce595f163e64b5099e998d96a1c020d890587d","6I2aNB1hLUYb8xMmS8D-A/ssr/b26f46f7885db47c3eba2bffc6d45f6e0ce7a9b5","6I2aNB1hLUYb8xMmS8D-A/ssr/b63bf13d0ef6e1dd1842ec1cbf15a3f65532b66b","6I2aNB1hLUYb8xMmS8D-A/ssr/b1d331711b6511dc7892829a21ca4e2cd9c80975","6I2aNB1hLUYb8xMmS8D-A/ssr/e0aaf6150b6ea14c8d4e6dce5954c0e9d8998144","6I2aNB1hLUYb8xMmS8D-A/ssr/f680c1cee894d5bab7fd249a549e3ab7f57571d9","6I2aNB1hLUYb8xMmS8D-A/ssr/69acf08728a2467c4d8e6de2b923c5c0182bba75","6I2aNB1hLUYb8xMmS8D-A/ssr/356c1bc00d454ec31a7e8deba884081cf00e912f","6I2aNB1hLUYb8xMmS8D-A/ssr/43846eb0b29320bffbddea62d57d06a060ec6756","6I2aNB1hLUYb8xMmS8D-A/ssr/8d0cafa0b66ed744e46194ecc9b0d80b4942450c","6I2aNB1hLUYb8xMmS8D-A/ssr/08fa404ad5186677dedfa098a02f9825aea9e620","6I2aNB1hLUYb8xMmS8D-A/ssr/dea35a265fa2fceacc8c4e3154f1603e4ff93673","6I2aNB1hLUYb8xMmS8D-A/ssr/4911a8faffda0641ee2f30ac5ae327dae2396f06","6I2aNB1hLUYb8xMmS8D-A/ssr/170882a72561807b8a346067e0a2da57b8b1000c","6I2aNB1hLUYb8xMmS8D-A/ssr/5c9ee3f6838f0c667f00e43abda84d96b022be14","6I2aNB1hLUYb8xMmS8D-A/ssr/da516fa23a5d2553514372961d880948663398e1","6I2aNB1hLUYb8xMmS8D-A/ssr/76de13f05026829e30b5fdd5914c38f5c5d6e2f8","6I2aNB1hLUYb8xMmS8D-A/ssr/162d415198735858141d31bd17c4adf7d6750e85","6I2aNB1hLUYb8xMmS8D-A/ssr/bf652a35d42ca6df89bb1ed8469160412fd1158d","6I2aNB1hLUYb8xMmS8D-A/ssr/ce7a1fa56c53811127835c9a49de1c7d1a660323","6I2aNB1hLUYb8xMmS8D-A/ssr/f63427ef5f12e90f9111e8d75fa086a4cafcdbcc","6I2aNB1hLUYb8xMmS8D-A/ssr/bbb5513fd48ec448415cc832ed07aa99ce3dbfb1","6I2aNB1hLUYb8xMmS8D-A/ssr/894a63336f8fa24c61e7b7bfe49e62b41fc1fec4","6I2aNB1hLUYb8xMmS8D-A/ssr/35b7dba0d675903d97318f7c832e763fa2c07cd3","6I2aNB1hLUYb8xMmS8D-A/ssr/08a42571fb0c8804b9d6cffab51e7e8b8d15ef34","6I2aNB1hLUYb8xMmS8D-A/ssr/9cdb646b02792688dec5c37dca66f3f932bb88f1","6I2aNB1hLUYb8xMmS8D-A/ssr/36c35a7831ac6a12406b0071bbc01c85a64c2f09","6I2aNB1hLUYb8xMmS8D-A/ssr/9ba96505ccde7eeae7de2d9a13c2bf51ed82b6e3","6I2aNB1hLUYb8xMmS8D-A/ssr/90eb3168c927e9ddcf0ab4cd169bb31daa5d0e7f","6I2aNB1hLUYb8xMmS8D-A/ssr/e6d547638bc3fd9992a8897714b844680da6f7ae","6I2aNB1hLUYb8xMmS8D-A/ssr/2e90945296775108efa9b01fa739ad47e8aba4dd","6I2aNB1hLUYb8xMmS8D-A/ssr/426b264e71b295f2e89d6660c982549d998eb126","6I2aNB1hLUYb8xMmS8D-A/ssr/20b76bfc8ad0e67d220d0e9323a5b97fcfd765a4","6I2aNB1hLUYb8xMmS8D-A/ssr/89f1e0b4eae28003f174b7c5a5881d82a067e2c8","6I2aNB1hLUYb8xMmS8D-A/ssr/dda0cfe11159b11a071c1d68f2f188eb03e78b85","6I2aNB1hLUYb8xMmS8D-A/ssr/056577ee33fdf896349ea9d45f23b32c7411a9da","6I2aNB1hLUYb8xMmS8D-A/ssr/f56228a1c8e89972e0b9de88c268c4b1052e5208","6I2aNB1hLUYb8xMmS8D-A/ssr/9160809084ea0683dabd81e5664e5c4f92622373","6I2aNB1hLUYb8xMmS8D-A/ssr/9dc8fe9293a9583ebeb59c79d690e29244e2c6a1","6I2aNB1hLUYb8xMmS8D-A/ssr/3213db423cf0ce233e240a56922a0e08bfe0a3f4","6I2aNB1hLUYb8xMmS8D-A/ssr/e3f31f14749821719da975c89201b98d50d38e82","6I2aNB1hLUYb8xMmS8D-A/ssr/1e735c16bf919f0511b4872fb5b82fa216195e3e","6I2aNB1hLUYb8xMmS8D-A/ssr/03c44824143d55d72e5071a7a35b9d33b10b3e88","6I2aNB1hLUYb8xMmS8D-A/ssr/0c2684970f300361612969cc3f81f864f666fba0","6I2aNB1hLUYb8xMmS8D-A/ssr/ead5980546cb65d218d5c030272067a55b501021","6I2aNB1hLUYb8xMmS8D-A/ssr/9f339af2b6527f1a40317774dbc3c74b83486905","6I2aNB1hLUYb8xMmS8D-A/ssr/0bb63e10030b4ef29f811aa74fc442e258c76fb5","6I2aNB1hLUYb8xMmS8D-A/ssr/3132f86817109cc8acea83c7902d0fea0e96f9d7","6I2aNB1hLUYb8xMmS8D-A/ssr/66aee5cb71bbe76e949705d41738631ef02fc371","6I2aNB1hLUYb8xMmS8D-A/ssr/d21f9cb11d2cc7cc3972e960170f1abd15eb08f8","6I2aNB1hLUYb8xMmS8D-A/ssr/e8ef6410eaa3710dc899a3f22a0d4acf7ae889fb","6I2aNB1hLUYb8xMmS8D-A/ssr/176a4bd4eb0a3a539bcb1fa845821af9d2af41c3","6I2aNB1hLUYb8xMmS8D-A/ssr/bef06ba48d24d7081310d9b876431216182d06d6","6I2aNB1hLUYb8xMmS8D-A/ssr/7e0e0c3611fcc458858c9110971959c697bb313b","6I2aNB1hLUYb8xMmS8D-A/ssr/7b6792cb0e1a0594b40cae540b52bbb19763ac97","6I2aNB1hLUYb8xMmS8D-A/ssr/f263c4b6594e239dd59a42bed0b03cc1b0441dbc","6I2aNB1hLUYb8xMmS8D-A/ssr/86a32f9b4ff4370c6b514272b9b5975cba550c33","6I2aNB1hLUYb8xMmS8D-A/ssr/6a7963df7c19582578651c6705c8b0245061a93f","6I2aNB1hLUYb8xMmS8D-A/ssr/503ad5cdcbcc242806fdd170c760202c331a6b6d","6I2aNB1hLUYb8xMmS8D-A/ssr/daa354e850993db37f736a8f5b489436c8124327","6I2aNB1hLUYb8xMmS8D-A/ssr/5313d6298be90479e5793d25364fa4f4b2bad69d","6I2aNB1hLUYb8xMmS8D-A/ssr/4d15985c155136629f688c0f56440f4f01bd95d5","6I2aNB1hLUYb8xMmS8D-A/ssr/f26ac95ac397f898c6b0960740dc851c1a0dae44","6I2aNB1hLUYb8xMmS8D-A/ssr/9af13b165c80573c915bac4e4cd0cec12093bf62","6I2aNB1hLUYb8xMmS8D-A/ssr/dcf3d546a8b96be2d34171110b5cfd48b292e98f","6I2aNB1hLUYb8xMmS8D-A/ssr/b4a117709df63869dfd68c06c97766fea7f96d28","6I2aNB1hLUYb8xMmS8D-A/ssr/4a895b30a440125f726e11b292ce21434637204b","6I2aNB1hLUYb8xMmS8D-A/ssr/24bd728815ed2dfad045837f3fe0911543d0fd3f","6I2aNB1hLUYb8xMmS8D-A/ssr/5cdc491ca6c95b15118a439a30d1b45831e42cdd","6I2aNB1hLUYb8xMmS8D-A/ssr/461fcf4297afc4698b57f8b411a96513463487fe","6I2aNB1hLUYb8xMmS8D-A/ssr/8f9b7afad1e0ae0ff0bc855f44bb1a571f887cd3","6I2aNB1hLUYb8xMmS8D-A/ssr/0f40501169dcabe1bcf43b0ec600f87b02f7d15b","6I2aNB1hLUYb8xMmS8D-A/ssr/cab083fba948e156c272f1312af21b691378eca8","6I2aNB1hLUYb8xMmS8D-A/ssr/012418f8afa5d932d199eff26d9444fc3649d91d","6I2aNB1hLUYb8xMmS8D-A/ssr/81bb3a7ec5d30a472d5eee10d93843aa1ff5e217","6I2aNB1hLUYb8xMmS8D-A/ssr/f5dadf272ae5748ae224c18caf9967eb5c846649","6I2aNB1hLUYb8xMmS8D-A/ssr/98e6dfc34bf155f998f3757d2fe6503997ee7347","6I2aNB1hLUYb8xMmS8D-A/ssr/f5f9c8fe76a9bbc470c8d3279ed29c6336a6befe","6I2aNB1hLUYb8xMmS8D-A/ssr/218eb0759133e8caea9a14f5bd1dd28e19ec5e7c","6I2aNB1hLUYb8xMmS8D-A/ssr/9b0c800ee134a8f74ca2505ac3f0da43111847cc","6I2aNB1hLUYb8xMmS8D-A/ssr/255aedfeeadf2a4cd733177484b0910cfb900cf3","6I2aNB1hLUYb8xMmS8D-A/ssr/82224c0f6fa407944c819118a2b9b9ccd54b98d5","6I2aNB1hLUYb8xMmS8D-A/ssr/4230cbf5f9e3b638ce57eaa7d8820ed43588cfde","6I2aNB1hLUYb8xMmS8D-A/ssr/d478d4f1ebfbb5f487b14f9c68fa6445f969e1df","6I2aNB1hLUYb8xMmS8D-A/ssr/b5535b07bba259da83bb912423eec19163876994","6I2aNB1hLUYb8xMmS8D-A/ssr/86316717a491a8f273f5182d5ccbaee6623de4da","6I2aNB1hLUYb8xMmS8D-A/ssr/534b7c1fe05e6733a2b0723050177a5b3a94dd20","6I2aNB1hLUYb8xMmS8D-A/ssr/c6338f5cbcb4476872c42c16e4a951e2b00fbc37","6I2aNB1hLUYb8xMmS8D-A/ssr/93e2bb9dd21dae3cbb43930bb27c4229af9a7470","6I2aNB1hLUYb8xMmS8D-A/ssr/25257d03950239399a7ceafdd780caafe6129a7c","6I2aNB1hLUYb8xMmS8D-A/ssr/546009b089dbf57256bd33aafe17f2a3a6092f30","6I2aNB1hLUYb8xMmS8D-A/ssr/5cd925dd4034fc0a614c10d410631072f255f173","6I2aNB1hLUYb8xMmS8D-A/ssr/9ffd0b989dd8a29ace3a14f29b2b7377731d31c5","6I2aNB1hLUYb8xMmS8D-A/ssr/5b008a3507cfa6ade71132b321cb39233ab8533e","6I2aNB1hLUYb8xMmS8D-A/ssr/d884027d3b10fb57307eeedb3e51b3acc5e0fc2d","6I2aNB1hLUYb8xMmS8D-A/ssr/c636629172b3ea1502146817f54a5da25ebcf337","6I2aNB1hLUYb8xMmS8D-A/ssr/7e64cff11ee61529273a28f16e66545e3c10ed7c","6I2aNB1hLUYb8xMmS8D-A/ssr/e6abf249b2708845ac6f6c15e407822dae517223","6I2aNB1hLUYb8xMmS8D-A/ssr/fdfdcc1f950624fdf41d263586b85d083a43aa52","6I2aNB1hLUYb8xMmS8D-A/ssr/9a741f3dd6fd5809166de2f0c022f98f2a19b743","6I2aNB1hLUYb8xMmS8D-A/ssr/b1f82d09bec7ab9fc5e5625ac1f89de7c9a78282","6I2aNB1hLUYb8xMmS8D-A/ssr/e7a92a185a34b19bda41eba0ad256e370ea10c59","6I2aNB1hLUYb8xMmS8D-A/ssr/ac7d67a28e34fbf74670b344822ec819705c72c8","6I2aNB1hLUYb8xMmS8D-A/ssr/6c1b9463133f2ed96e6e7c9848606cf4e98f5349","6I2aNB1hLUYb8xMmS8D-A/ssr/9572c9465bbad942e5917c5b9ee6018efc4305fa","6I2aNB1hLUYb8xMmS8D-A/ssr/a6cbefb7a412277b882366e9e236697e619f328f","6I2aNB1hLUYb8xMmS8D-A/ssr/e515a77eaf480b778ad89ec036f7e437ae5e9609","6I2aNB1hLUYb8xMmS8D-A/ssr/9a3bf53517d2a4c3addc236ff717f1304caee9bf","6I2aNB1hLUYb8xMmS8D-A/ssr/74ed6f2492ce5b3974aa3531ecdd7969d5802f5c","6I2aNB1hLUYb8xMmS8D-A/ssr/34624b1d1de27fcd5081defc4f42bcc5a107cad3","6I2aNB1hLUYb8xMmS8D-A/ssr/52ecc183b63d00e54e83752ca85d8627290f46e5","6I2aNB1hLUYb8xMmS8D-A/ssr/0df2859dbcfefe36df96cb68086100a5f5f3173d","6I2aNB1hLUYb8xMmS8D-A/ssr/4b14c1f05f2c000bcda2d6d55df6d4c60793f352","6I2aNB1hLUYb8xMmS8D-A/ssr/c4c785a7045db28c6dc5a6d93c31a29d3acc7d49","6I2aNB1hLUYb8xMmS8D-A/ssr/b6d9b22942df0a899302e1176fcafeda9028fe58","6I2aNB1hLUYb8xMmS8D-A/ssr/5100ff82f79b4abb91fb4234e9b12c774804ca5f","6I2aNB1hLUYb8xMmS8D-A/ssr/15c04ddc4b71b3171a9968af32a09a3b1b9cbc1d","6I2aNB1hLUYb8xMmS8D-A/ssr/2c0885e21bf350e47164e280362c073f8451f471","6I2aNB1hLUYb8xMmS8D-A/ssr/d0baae87822755c3fde223325472423fe2ad14a8","6I2aNB1hLUYb8xMmS8D-A/ssr/31ba2897101251b752e107220be6812d30ec1fee","6I2aNB1hLUYb8xMmS8D-A/ssr/2d4d2626746953deac0b15dbf8b698fbb21ca373","6I2aNB1hLUYb8xMmS8D-A/ssr/58f558f67ce1473475dee602195610641bba1a62","6I2aNB1hLUYb8xMmS8D-A/ssr/db3588308c77c65e3f4e2c770be9ec08f892d685","6I2aNB1hLUYb8xMmS8D-A/ssr/f42575b871470f135d3176f40e29562c566f6297","6I2aNB1hLUYb8xMmS8D-A/ssr/e8b4796bdbeb7695fff36b2e95351775b9fa77dd","6I2aNB1hLUYb8xMmS8D-A/ssr/5263a98dfa8d2e289ea0627d11e79a45f28fa127","6I2aNB1hLUYb8xMmS8D-A/ssr/91817ba2877b2bf6e7630a7cc5c9ad267b50fcaf","6I2aNB1hLUYb8xMmS8D-A/ssr/defd665e660f1dabd067511368daf8aa031e40e6","6I2aNB1hLUYb8xMmS8D-A/ssr/a71a679e59193ddda0d2f5001d6ce4ef4a6cd1de","6I2aNB1hLUYb8xMmS8D-A/ssr/69f1cc96b5ebd7cd945774498548b28777b8fb1e","6I2aNB1hLUYb8xMmS8D-A/ssr/5d0d60d47a110056b41ec6e7a1f6d8de52a9ff0f","6I2aNB1hLUYb8xMmS8D-A/ssr/b43f91759e6747b4144274b34cebf8bf1ef0e206","6I2aNB1hLUYb8xMmS8D-A/ssr/b40a7b9ac1be360370748b935875cecfa8ea2527","6I2aNB1hLUYb8xMmS8D-A/ssr/9caf09b5b6871a20968284cfc0914a6dddf1be14","6I2aNB1hLUYb8xMmS8D-A/ssr/313016b24e608f2f067bd0a115ec48875edc21b5","6I2aNB1hLUYb8xMmS8D-A/ssr/b86a2ba4a89c2da15adc2e248de6e9cf85360c5c","6I2aNB1hLUYb8xMmS8D-A/ssr/3b65ebe9fcd12fe24a76bb927137b4222fe8e2ed","6I2aNB1hLUYb8xMmS8D-A/ssr/3680b99cae573437b28c31d14053ab82aa2ff218","6I2aNB1hLUYb8xMmS8D-A/ssr/4d2ca6f32a599a77625c91e851b5ee47802c71ae","6I2aNB1hLUYb8xMmS8D-A/ssr/b27687e52e8c53384196d545873e9acd3c891889","6I2aNB1hLUYb8xMmS8D-A/ssr/3500fc73fee410ed58f71ea53b1752db38b4a992","6I2aNB1hLUYb8xMmS8D-A/ssr/d1c7193ffe5d30f1dd8d5a3cd30f1ab729aed5ca","6I2aNB1hLUYb8xMmS8D-A/ssr/1fcf132f314576ab88083820a691bd09bdbb6c71","6I2aNB1hLUYb8xMmS8D-A/ssr/723db991cfb55705a53a470f1fef4b48e7326112","6I2aNB1hLUYb8xMmS8D-A/ssr/b52821238d6f764d22cb048b650da96205c329cb","6I2aNB1hLUYb8xMmS8D-A/ssr/0e5f9bdc4a9c328e402fd5403ef75abee83ccee9","6I2aNB1hLUYb8xMmS8D-A/ssr/e1f7c6ccd2bf53f3f9d947a8c4590bcc1629a888","6I2aNB1hLUYb8xMmS8D-A/ssr/3303a07f8acc2f81074668777c6e25c22ed967e9","6I2aNB1hLUYb8xMmS8D-A/ssr/cfa1c36be30ed00d7918b112312230f8007351f1","6I2aNB1hLUYb8xMmS8D-A/ssr/b36cb2afcb35c2418f36d243608e4a7b9b2952d4","6I2aNB1hLUYb8xMmS8D-A/ssr/bca292541ae1ce0542406457e11e248f37b9f1f8","6I2aNB1hLUYb8xMmS8D-A/ssr/7e1ef2892230a0b7d2c84a8aaf71eb41817c6eb4","6I2aNB1hLUYb8xMmS8D-A/ssr/965a4acdf761ac29a47e461cc6fcb1fec1f90dda","6I2aNB1hLUYb8xMmS8D-A/ssr/ba5ef04ddcca9b567a04ee2e24b334cd994e815c","6I2aNB1hLUYb8xMmS8D-A/ssr/ee1129b0e27d116acad909c42bff055183d521ae","6I2aNB1hLUYb8xMmS8D-A/ssr/c3e9dc1c0287989eb1fe1aeffb495bd43fb90d3c","6I2aNB1hLUYb8xMmS8D-A/ssr/3c99065d603c15874997449f8f1dec863d5d6ec9","react-doctor-7689037e-8abb-4ead-9a92-4f9c01ee2fec/diagnostics.json","react-doctor-7689037e-8abb-4ead-9a92-4f9c01ee2fec/react-doctor--js-combine-iterations.txt","react-doctor-7689037e-8abb-4ead-9a92-4f9c01ee2fec/react-doctor--no-render-in-render.txt","react-doctor-7689037e-8abb-4ead-9a92-4f9c01ee2fec/react-doctor--async-await-in-loop.txt","react-doctor-7689037e-8abb-4ead-9a92-4f9c01ee2fec/react-doctor--no-barrel-import.txt","react-doctor-7689037e-8abb-4ead-9a92-4f9c01ee2fec/react-doctor--no-cascading-set-state.txt","react-doctor-7689037e-8abb-4ead-9a92-4f9c01ee2fec/react-doctor--rerender-lazy-ref-init.txt","react-doctor-7689037e-8abb-4ead-9a92-4f9c01ee2fec/react-doctor--prefer-useReducer.txt","react-doctor-7689037e-8abb-4ead-9a92-4f9c01ee2fec/react-doctor--exhaustive-deps.txt","react-doctor-7689037e-8abb-4ead-9a92-4f9c01ee2fec/react-doctor--no-event-handler.txt","react-doctor-7689037e-8abb-4ead-9a92-4f9c01ee2fec/react-doctor--server-sequential-independent-await.txt","react-doctor-7689037e-8abb-4ead-9a92-4f9c01ee2fec/react-doctor--react-compiler-no-manual-memoization.txt","react-doctor-7689037e-8abb-4ead-9a92-4f9c01ee2fec/react-doctor--only-export-components.txt","react-doctor-7689037e-8abb-4ead-9a92-4f9c01ee2fec/react-hooks-js--set-state-in-effect.txt","react-doctor-7689037e-8abb-4ead-9a92-4f9c01ee2fec/react-hooks-js--preserve-manual-memoization.txt","react-doctor-7689037e-8abb-4ead-9a92-4f9c01ee2fec/react-doctor--rn-style-prefer-boxshadow.txt","react-doctor-7689037e-8abb-4ead-9a92-4f9c01ee2fec/react-doctor--rn-no-legacy-shadow-styles.txt","react-doctor-7689037e-8abb-4ead-9a92-4f9c01ee2fec/react-doctor--no-giant-component.txt","react-doctor-7689037e-8abb-4ead-9a92-4f9c01ee2fec/react-doctor--rn-prefer-expo-image.txt","react-doctor-7689037e-8abb-4ead-9a92-4f9c01ee2fec/react-doctor--no-derived-state.txt","react-doctor-7689037e-8abb-4ead-9a92-4f9c01ee2fec/react-doctor--no-chain-state-updates.txt","react-doctor-dea5677f-6356-45da-ae48-29898add4f3d/diagnostics.json","react-doctor-dea5677f-6356-45da-ae48-29898add4f3d/react-doctor--no-cascading-set-state.txt","react-doctor-dea5677f-6356-45da-ae48-29898add4f3d/react-doctor--no-barrel-import.txt","react-doctor-dea5677f-6356-45da-ae48-29898add4f3d/react-doctor--prefer-useReducer.txt","react-doctor-dea5677f-6356-45da-ae48-29898add4f3d/react-doctor--js-combine-iterations.txt","react-doctor-dea5677f-6356-45da-ae48-29898add4f3d/react-doctor--exhaustive-deps.txt","react-doctor-dea5677f-6356-45da-ae48-29898add4f3d/react-doctor--no-event-handler.txt","react-doctor-dea5677f-6356-45da-ae48-29898add4f3d/react-doctor--server-sequential-independent-await.txt","react-doctor-dea5677f-6356-45da-ae48-29898add4f3d/react-doctor--rerender-lazy-ref-init.txt","react-doctor-dea5677f-6356-45da-ae48-29898add4f3d/react-doctor--only-export-components.txt","react-doctor-dea5677f-6356-45da-ae48-29898add4f3d/react-hooks-js--set-state-in-effect.txt","react-doctor-dea5677f-6356-45da-ae48-29898add4f3d/react-hooks-js--preserve-manual-memoization.txt","react-doctor-dea5677f-6356-45da-ae48-29898add4f3d/react-doctor--async-await-in-loop.txt","react-doctor-dea5677f-6356-45da-ae48-29898add4f3d/react-doctor--no-render-in-render.txt","react-doctor-dea5677f-6356-45da-ae48-29898add4f3d/react-doctor--react-compiler-no-manual-memoization.txt","react-doctor-dea5677f-6356-45da-ae48-29898add4f3d/react-doctor--rn-style-prefer-boxshadow.txt","react-doctor-dea5677f-6356-45da-ae48-29898add4f3d/react-doctor--rn-no-legacy-shadow-styles.txt","react-doctor-dea5677f-6356-45da-ae48-29898add4f3d/react-doctor--no-giant-component.txt","react-doctor-dea5677f-6356-45da-ae48-29898add4f3d/react-doctor--rn-prefer-expo-image.txt","react-doctor-dea5677f-6356-45da-ae48-29898add4f3d/react-doctor--no-derived-state.txt","react-doctor-dea5677f-6356-45da-ae48-29898add4f3d/react-doctor--no-chain-state-updates.txt","metro-cache/55/ae891e4bf5c3a1284aa9e426881c445707c9d590e0f832f818c6de850ef379dc1d6b67","metro-cache/71/b90bcbc6d99cddca9322d8a2e10368f024f76b12bed3d84647b984ac3e2ee934592280","metro-cache/e5/8d2690194be45c0f213f789b5e10ade9f5f5d40e05f97b59a912f472932219db59de56","metro-cache/3e/cf23617e4d3134b6cabad48cba46e83573ae42ffecf0ca7f74ce6e4445313c047a6293","metro-cache/ae/5911c4f429b2b971f819d76155e2e3a80124a579cbef75c3f92e527f05cde59a8b85c8","metro-cache/03/c75a7f6df5ac74e4e1616c19305267acf14cac245ed985bd264dc1c6857966326f601e","metro-cache/a4/6c70033b1eb5dc4ab1b3680ed2d998c80a9f100cc4130d48b59ab69177702d6e5e1967","metro-cache/88/a4f80e39aa8c930a4f5b0b0540a2b51e12815a99b322585dcd6706c7755bfb65740e95","metro-cache/d7/7eadb4813ea68d3ad698da87b59091b89134217fe238870106345de7392d1c744de657","metro-cache/d4/2c2f88a9e3fc4ab94d1ccb9aeb0927712fe76652c54b16073639b692157b72aca82365","metro-cache/8f/5da3f48b191aacf69d81b3bdb721606a690ae46349de8416a47618ee7515aa1a94f691","metro-cache/78/6d484fd8824184b4b1e86e5782c3ed1a9f6c7c00e701808f7fde4d793678cd3ff78698","metro-cache/34/be05c88776a1b2dcace166b56de28abb39bd39f3cd118e9bb1c9e64943342078279acd","metro-cache/52/0048c17e50ae25f310ad1ee4ca1b325bf9b2f26ac8c7e9322d78f24654f740004c4bec","metro-cache/1d/e17dac7f14b03d6c8dcb7b9f21bda51f250fdb6266784d7ddeb820ddd2aa9cb3f77f14","metro-cache/56/c4a16f36f2332fbddd1b1d6a6fb9cb2af1ba1179f234fdc5f63f35673e1aea50ea12da","metro-cache/ea/209ff0cd4956ff1cf202a3330b26bcc6dda4aae86a1f8cf891348b5aa9366433bd2d16","metro-cache/72/b87307702723d60484b86ee1754417b62708d4c6d57aea76ff87c570f5adf2541f78b0","metro-cache/86/2f1b4ac1f880a4c65f002165dffc45069889c43a8bfa5b6c58c9fcd2d6bc8c140ed3a1","metro-cache/a8/e7fca8fa717df92babc2a0568a2476d473a0789f6b9c420e8f83066c3b963b3c255a46","metro-cache/65/b265e5d9757622350bc9a64f4ad2421649e7f4b1a6a2663321f53e1f7e519c9181419d","metro-cache/4a/5765a4c1038692e987ba0c6daede38247ed197d4eb104e3a683137ceaadd7870aa1643","metro-cache/d7/ddb8fdbc433083fe81fa4353cb5df305a7c240489f860d19ab12b40e2d7b0ae14e7ca3","metro-cache/d4/144d83290270806fd0e066ae7f85cfac7cb26fb90c73e22b21a13a0f9b1e176bcec8c3","metro-cache/87/108211f3b8df8c853f201705fbf1e837f6c722970f2d75770af1a253b0208b2281e785","metro-cache/76/5d4c430a98cb2b7a4629d7c13885e4518861b6f01151da7c723cf0cb7b4251ab94f10c","metro-cache/da/a383663ecd0ccb21adcd374ffddb2a8713bee9a99d13df38b7d361f85c4835cb736395","metro-cache/15/d2f9550d8b0aca0d6ae6c309303523ebbffb7d7ea5362a22bfa1bab0bfdeb1617cd610","metro-cache/7a/179c7698f67424d1f0190b325dc4f4fbbb442c138a43c4f8063ba8e7738ea5c56b6e40","metro-cache/af/03996feff6199cfd615bb81494e0f43a9391b51f78e36447ec8272750a76cde6f98a3f","metro-cache/b7/f8eddec8fcf67976fcf3bef53138a4b247d31878019770ffab182f3abaf6e6bf67b3f7","metro-cache/61/a7da34911e9dd131226adb6b5b557e1ba5f29e239a2f1ea910a6ce5ffc0d0ebcae0dff","metro-cache/f5/5a1799c6433130284983658b0770649a171049a9ba63e445f8beb5450b04cc28335ab5","metro-cache/bd/718a02af093d64d21f24aa5a484c78b4cc5542e8dc759eef46581b3ef2bc93c0c41e33","metro-cache/0c/b16789981f00584286fbaaceffd368e75693be686632d510e3f87437e8da311e69f1a9","metro-cache/58/2ea5bbf91e0d167c2284f2223fe70c15e4444e2a60dbcd90632696dc9437ce82a4893e","metro-cache/0d/90058dd4221aa6814c1ef19adbdbc3fca640925d9dbf6518ded4b3b67979657c40a213","metro-cache/9c/2d85bbc9d4d6d1895c990b45d191be282ec2659a9e22f2db4935d4b661303bc2385dad","metro-cache/35/63f1bdbf2ae78d0bcdbd3fb8a1ecbccf0c732a404205a6fec8dedf90d8b7689406f2c8","metro-cache/f0/111fbb4ea4a19f40d0e9d873fc82b6b3370ab3ad06eb4d40cb26bc25f2058347b3b657","metro-cache/dd/7941684dd71e219a906005b8075245d312090485ff42b9d51700f89d5a6bfe046708d3","metro-cache/91/1aa1ab4c7bb54a47449cc0adccb8a42d839eedc64f881337e1197b89f84c16ac9f8c57","metro-cache/c4/e75ac58e6ee6c6bc0b5a9265413cf526b3ce80381d0759035e57453f4af277721104f4","metro-cache/c0/21db256633aeaafece57d62b4edf52ef45331ecc610913e7c49b92441e6bd0996efc19","metro-cache/a3/95d289e5d264d59da94691d3e0c4da7c06b978f881db1d05aeb16168d4468a69812cb2","metro-cache/76/5afb2f83e41f334b3c21b3a45605fc342289bd48a9b031b856ccca15c102b1240bc397","metro-cache/82/75e8db25ea68467d946786fb161f2964b88f1fe85d4448e403fbd70618ff4255c727e5","metro-cache/fa/5370f536426bce1b7021917b906f14aab0e4ad6cbef1d5d99846ef65ec5d402596ceb3","metro-cache/59/548871396103e8bcbae4f0a0056d49e7aec5afedc37faa43e782de82b9f897a63bdd46","metro-cache/4b/0c365d4050518538202eddbf99451aff104092ea95f93204cd2db9cd56076f2dffd63c","metro-cache/db/5e07b9c0496e38b12589f08b55cab5e9e7baf1c749c5a507ccc03f18f49f6e8ae85057","metro-cache/6f/22d983e1ffd04a49a7cdd3d13a7618e0d81e73d78b8260396c6fd119237a75247f7aea","metro-cache/e2/6b0cffa91184b9adcc589e89bcf24f762a84b00d1e5b0ee9a3a751f5c7b51602ee2901","metro-cache/7a/7b26b4e80b8d4260cd4cd14e4320822650aff1137bb94b951d27bf70b067b56bcc757e","metro-cache/e6/eae46b41d2387e1515b20377180896119f69c076882072ce138671c26f887ce245eaf1","metro-cache/92/e93462daa2fd7e3acff2d4fd37f0e1d8cfd20360f7fea399f59f90698d148185d7a698","metro-cache/5e/408c44923d2e1c3c7b9b0fd51c7a0728918f046cd525c7e98ef26be572f740ae807b32","metro-cache/58/49a365428a3eb87f8f8fddf9e2e9ece05c4b31aca8fbb79f5b30c3c83c13f3fec04539","metro-cache/b2/b03ff5e671b9a8e5e7d9e4512a7f8b2f5b0c5a70d1f114e37a4314252048210f24e5c5","metro-cache/b5/c8eab7e802a14ed3957a22cbc1598d122c03e88e00d8e63c14bee0fdf3152382a43013","metro-cache/13/92137f3d5ceef1a4066e6ebc50c379df365463d77f6c9ad572ba3bb3f064a7181f59d6","metro-cache/5c/2ef44455dea2019b838966a8a42453b878f55d43f619a18fed2bca450e40ddfe689ed8","metro-cache/1a/17d5502ce4a24ba7fb8416d01fb64caafc862e0cff951a6cb49f8865696d8fc629323e","metro-cache/d7/88e5e82a9b2e908c02b2d6b9ba127b4cab9a942ed28316fa3d72458fdea45183761919","metro-cache/6b/c644387a99328ce8f1888662b55b2cf1f963a3d32f0153ea3f617be662bff48056fa2e","metro-cache/1e/9c1961e38a0e6a13ed0501e79b55a69a713ab28892a259ced48e1b5eac242915295a9d","metro-cache/59/3912395227e623c11ece36e4b28fab0fff4043961cf0b2af8cabf233b353cc836cb8f9","metro-cache/03/c5df93f7c254369ff07c1751c0fd972ee803fcd0e34fe91423bf921dfcc9e1ec75a891","metro-cache/52/bf48081655201c96fe2bb0a48a58a9806f6df747c5e755d793843d0ddd2be0158d889c","metro-cache/b0/5d9dc9caa7b6cfe62465eb02275fec987c79e16dee569be53e6f3a984bc07642e3b355","metro-cache/0b/06a9ccb2ee19f8712652fb482e9add77901c6a0256ba334b2148f278cfc58e65d23c9d","metro-cache/73/865b2502fe14254e73ae43f5a67299ec5b4ba015ed158a7e52c2d366d35813e12bd726","metro-cache/27/9e003b5f70b6636cf81ebabd8a4058573b1be49a9ae690f02ebc95369c01c99799a29d","metro-cache/bb/617fc12dba5978d591a9fcc1c79cbcb47ed17946947771e1e4409766ff2865eb381f28","metro-cache/d2/035dece083349a131460cb4e57d00ab65ac9df80b6b59b752e178d960a87550cc1d8f9","metro-cache/02/cdcccec74d8989693cc0a8849acb37478b5a1d48f4a998b0226e1863837dbb282a5912","metro-cache/c8/51a3ce40a6d352cd69fae7cc010ba5df792feea90bfa00cf20fca936722de61d275ae2","metro-cache/3b/bf6c2bcbcf4fe17b9353067c270dd46e3aba528884e16f093c8fc08dc72d87b7380f85","metro-cache/01/3453a84b52d9c706cfdec416917c4ceb75635a6770e1f672f48af7dfb30af4cef67257","metro-cache/11/6b700f5dcf01a3493a7cb60d742cde5f02c0ee5d943c87db70503b449331109468a070","metro-cache/81/74587b35777277711b191eeffc6672007f97e34c69fb444dda8ce6c935516eca0ac38b","metro-cache/d5/7bf6ddc09bf3f1c1acc76399565dd56d6b70b54964431aefd2f163f6f85568fdbb2e8a","metro-cache/7a/bc6919df59b4c89a380c5cfb6c388d88ae3a69fa5d54e964e9c7bd9c3bce94f3ec1f5a","metro-cache/93/a65c8cdcc338e431148458b93129ca4dbbb78f0ff3ba425eab2e9c44b2abcb135cb5fa","metro-cache/34/3c210b0b7c8330aae93bd795acdfa6af6c91997f70ad4b900a50863a72c7d2e30e182c","metro-cache/de/1bd126ebab29b2d3e06d83c41cd3970073c92e49db2420d5a96a01b8dc2c0c3d23ee29","metro-cache/cd/7b8852008cabe73ad0aa4f87315991c66fe058484c8f9ade7740fe5cf1f314d5e3e736","metro-cache/85/619815d8b1e8d9d946973df1f27c53fda36387d976578d59b6b1742ff8578151d3ded5","metro-cache/a6/5907ac156e77a27122ca806a8db39293ab8f248b30c5076bae33d6530e6dfe3eca97e4","metro-cache/0d/dfcbd0f5e8fbacd79fa1f88a5e244ef25239db610218d0b3c17258a838acd250e8580e","metro-cache/48/2bb9b148736074ab402dd97be4dfd53e518a8d2bdfe2f7a6f6f1a57c2500574c8ef03c","metro-cache/11/f8621f4883799213ce67e0f107aa66d6223644174d5e121765fcb9f68546610e06bd0e","metro-cache/b6/c8dce4b7568b47936ce1a384fcbfae8aaa744cbbf4ac9d897d4ff1948c7812b4861f20","metro-cache/34/05a6f13c1ab9a138c8f25a95d825107d22c7aca1a3512c4576ca2e8efa76099505e30d","metro-cache/e9/01396787ccb3e63059f69f117ce5319983050e7a9362a1726519f611118eda66e9a58f","metro-cache/3f/f32e83895279b3e3b1b37c17474b8cb1a7021f0fce85b7cf3ace34803023099fb0979e","metro-cache/79/1e1704e15aeedc4e366d6ff34aef21d7b22afcb1f79198baa9f81fbe5d1e2d0ad6fbee","metro-cache/73/cc64a151663c7dc1564ed5447ae384813ef3c50570f208f95d0d3d5cb467df33324f4e","metro-cache/99/bc202578f2aec25edd46055437f8c5bdae81d63b86987532783062e9f0e52cd510337e","metro-cache/e5/ad68e8e596c4dad88c0e9e293baf3e6f89f0a0a7ce597288a7a6d4996687cbe8868fcb","metro-cache/3c/fa46286f7124807bba62bcd5fa2c51796af6597de85e5bd441222fe327ff1e182c805f","metro-cache/f6/468dc25d7680c73defe9778f743de821166423b991b3b2ac7ecc153fd7f766723431cc","metro-cache/82/205a9b61c88c1394389f205627a60385f4a727c53a3a941f13e5c1d4a5b5621837018d","metro-cache/c3/0a5e48e3c5a9b0a5a9b6d65727e81654122fce1116f43a4179acc71c67dfb7cc3b1244","metro-cache/e5/006a41d01e15c93b1853dc5931d8bdb8d9bfbf3de18a0d8d3732113e2a03cdba50b878","metro-cache/0f/e4570a447a892908cf2f8132000549c60988a46e7c6d88d60c36d9f8a37c87d31fa0ee","metro-cache/c0/23c366fc364954b69e11d75307d1532ec3506a357603ccaa7af39b9773f40a0cfc9845","metro-cache/e2/cdbfc1fecbed542f7ae7867c47ac667a444693ba27f2f07348961ad309d6285ba5b06c","metro-cache/4e/b7910147dd4274d718a328e61d4c3983f1244b88c620799ebb6302909434bdd31790cf","metro-cache/03/5d732c87804b0099421691b7ec7f82a7751758a1a2c4a6748435819e9748e42366cfa1","metro-cache/d8/e7e7344a2ebcb72e33ea7cce4d94737251473b1afcf9e24e5bdb75f17451914e3e8f32","metro-cache/66/1d676f2f89a370b8aa76a4cf182f5bb6b52bed7a0fabd01ceb776c0888153b4f6692c1","metro-cache/b9/d07aa9443dedfe8968706764d0076313b4f75ed3abbcfa3eb99daabddab07f0c81638b","metro-cache/42/c8d9001ac7c019b8927ade7b2fa35c8f0a98aaca1dbec87ed1be85b3c998501f89499d","metro-cache/de/cf625c0fc58d102e476caa3075217856aa928ca7d3b73fc583cd7a79073b5b09a53c55","metro-cache/bd/6ef3869139ff7d71e173f00067eb4f49a551419880e4be1b1a412de9882ba700628faa","metro-cache/d8/2824fa75f2897398aa9875963ddb3f936d8aa4a41bd45eee9f80d44de41ce973abe126","metro-cache/1e/2dd630afa1e7cd0c342470288f5f27373b6d92adebc6d2a0e22055f529b68c5d3b3e12","metro-cache/cd/185621f2aae046a8bc38039e4cfb19ca42618e8499f827e0e1a9e94edf692c04389e33","metro-cache/12/a97ed6cb09c1df74f87d7fe1a5f8019924133330792cf741214234c0a0c61781d654cb","metro-cache/c4/0330ef754a0f16ec0919b993bb5a0b7fb22fa4fe4be8c1f2f6d1ef6ab0ad2a4142dffb","metro-cache/f7/0330c462f3888f3c33b97a5820f8dc999d4c50a7e18c476f2c9039d029b526efc48ce4","metro-cache/8f/3cf30e29f25fb814da3fb3e065dbe277be619889c6618eb3718e684f72c6923ebac8e7","metro-cache/31/b7215609a31a186249cdd4c6d1ce393fb88d8d9c4bebe8607592ebc42aa6e525f3f9d9","metro-cache/3b/27cd3bdbfc5310c16106cd737611bf29d3d73bb6721d213428ce01afa43feff4b46740","metro-cache/73/aff9c18275ff815bee8f94aa9cfa0cd56186942c15afb5129ceae965284f34d71b9529","metro-cache/8b/faec3954712eb43f0fe51d15baf07a635c5ca7ed927ddc641c34908ec0afad51831635","metro-cache/f0/9bde564509b8b42fbb83d2ccd866ba017369c0ec9026b22b832f9fe545403d2e91850c","metro-cache/74/9c36da5cae8977ac4c6f8760efda2783aad00428736b1f34690d7e2290a6d8c791ad69","metro-cache/72/c4023d95bd076171edf4ca4252a283a82b157d29daa04f0fca078943b15657f225e112","metro-cache/18/be58c31ac62690c690dbf44d3267bd114968b158b993f59738df254154d66ac4685c10","metro-cache/3f/c7e547abb1652be90b7dd2ab51f5842069342183702206986a78d8349a4cee35e3d7a6","metro-cache/61/da3e92f1a47a937b931be9c5cb77eff6d0d7c0ee5ce97f3ef308b0f3ecd34b39419fcb","metro-cache/8f/c81d745636e29658211f23a88a32232179a7f92cb5dcc5e2c2ae103fc60a83bd75c794","metro-cache/f7/a7b1ea4488d43f5b75447ab1de3c402d7ce0ee55cca453cd96116e1ef3605a4b337b91","metro-cache/94/832a849d178289df4d52c4c0915d303694be15a782252bae9482a48f5acf6d140a6607","metro-cache/82/d8db5baa32fe9d914b037856cae1ab36c03d84b256d770f998934695381d16c223440e","metro-cache/e0/26c7584df4c302cedabf5824114bd27cc2245b9f478a9525455b59e263279fc7bf3ef1","metro-cache/aa/00f1f91559db642a124064cce15ec40183245229ea5d2b0ae239060d0be95a7ceaafaf","metro-cache/f0/2e987f40129786b229e670e1e167630dccc3b8420bbb8c2176ecd065cd6ba63193e301","metro-cache/15/78049477e0cd336b1bb26190e086e7bce2fd093a35bb22db772e551945679472dc1475","metro-cache/ec/9955eac293f90f4ba24a6198242419930890a517f1438dbdbee0686f85a649e8e998fa","metro-cache/4d/0d17e377e297989e1d5369b8add92e97dfd22ddd89c572448f2ff46d67b448d9104bf2","metro-cache/24/7b976c28c92977028a1f06d83410b9758b4ec082436fa3034910906be9980e2c68526a","metro-cache/cf/c6e46d244b966aafd0ef6a677fdebc2183f6e705776434eca3f41ccc1d897f208c6023","metro-cache/a8/894310263b41062039d6647fb51c55be12de0fc7cc6de53bf8705bda40df31b31ad7ff","metro-cache/a8/218ac0597a3ccdb36ff90794bd4768d0c14a92755b1969b8586207f4b1c9f58dd37026","metro-cache/e8/d1c3b9bdd27ef91827e6a6e955275c7a41142dbc97785473d7f05233cbde5e37e3726a","metro-cache/07/98049e21f43b432e79d277f333a8ec85082fd904bf6c7ac9886a3d9ea977dd9b30776b","metro-cache/d0/2e6bc6c1a1f6db69bc33f761f256c1de7cbd7c2ecba7515323293a1771afb627fb1d22","metro-cache/20/ac77241c58509fd96c40b127646feac07210e9d82761ad449a3cf680e9384b4505f83d","metro-cache/9f/9d2f4972ea277952696bc57f0b6cd9f8f92a7c06be652d2ab85fea3788113ebf3ab825","metro-cache/13/8bc9e8416ba19f761627e782355f6497bc07263a39dd3b1f62a6fc18326cc3bfc13e99","metro-cache/c7/8602939ad787725c2527a377a84504d62b104681a25708d46ea3845ced9286b3a8d1fd","metro-cache/57/069bfcadeb56c8dad9f4c99ed092b43c870ec8af8f75eba32fbffb23aaf51ebb0813b2","metro-cache/73/58f2975ddddc016d0a340b0584f2c1bfae71c9eee9ef60d32261ba6e99dbf11ed667c2","metro-cache/e2/5c5f6570938011c359dfb2f9528f959be3ff43b53eabeb6cd1c2512fbc2fe3c0afd610","metro-cache/a3/67537995910fe91f36b107e26a2cd95a4f50702c5df82771cd8b141e3cd10c7ec82d44","metro-cache/27/cb24f0e455b8efe296a18558896f7d65e0c706e5443d06322dda710015a2276e07ec31","metro-cache/2e/1b78ce8ccf5e55d9ad025f03a0585e433f55498ceca52d104d994fbc18dcfdca12d59a","metro-cache/10/e8e2e81ecd15ab85317d06ace50343f4b20fda373be61d0d0a931747cacd4db6c340de","metro-cache/71/6fa3eb2a716f1c334a62e8687be3aa6daa062b72c32cadb9b6a462fb00339a866748d0","metro-cache/a7/9effa014da65cf283ef035249534e41f1c7eab8b1852c21fb76cff5fe6d6ed73fe7262","metro-cache/b3/564c951212bb77fa44cfe70a8b3959e4705af170f7962e665e064b5a944f343812c167","metro-cache/86/5a9533e418ac1f8915aee35ab94a1f16f40c7ed3bc23c98584dad61da3663dd49bb4e9","metro-cache/2b/90ddb3c1bba650436ab64d6919a96791aef271ae771be40c5e6f3776d931b445f00b32","metro-cache/0c/3d1ed6ea10e8db10e82a79f3ee1076fbe728dccd6875db85c21a0cfbc6ea9803706d8a","metro-cache/84/6874ddc679a784eedc8dd6de264b11ac638cb5fc71d1e87f1f331ed139a0d69507a05a","metro-cache/8e/73b091ebae29edc6038b0f499d29fdbdf1041b6d2fd00a47a281adc882c6ec3ec400c7","metro-cache/51/976408b0b7aced73828292bc076d07e22e6ec5a95799a6781f44ca27dae4809fad9730","metro-cache/0e/0eb0e490703730d8070db9b879603de87a23a19db11f49091c557c3a17fab09adb79ac","metro-cache/8f/a487fa04571b02e6e89c99ce13f4540b8a49f80adcc8f1ae5615ad23f158114f5dd0c5","metro-cache/94/c93f25f5f86bcdfa5dbd68da3900bd873e27ee9bc9639dafe54395269d4e2c3c334a33","metro-cache/7a/11a6cbc397a035a9a878c1a65a254736f1614e45818df767cd80914978a14682da8d1c","metro-cache/f3/20e0af4707340f60e5179dc1df21a3df351095eba7d70f1314550fa29c26fc32c33d7a","metro-cache/b5/5f031b7fd3467199d8fb4334dc02e06beb72343aba284212d6c8785eea07f900a4a497","metro-cache/84/56733130a840c56b0fa509d9640d9fd61ad829abb78d5cbc55f7f5440be6fc22775285","metro-cache/65/6de9ad6639a6f8635f723bfe429820f7941e635273fdaadee183074c8c10bda4d722d1","metro-cache/80/c71dfe60b6b5d302a901eb508ae33dcaa830861b5f5bc3d43386db6847c270fffcbd86","metro-cache/98/449a7c2379ed3e721aa55b8dc6230572e0a8e72c9e3c916f6f91e1ea6acf39896ddce4","metro-cache/af/1dd55a01b3a31273f59c6d4e6157b073506d0afa0b9aafb4c23146474268ebe88d24be","metro-cache/61/0497d94c9e6d661bb9318d432e569fa39e9d2914ff3eddc8423a98333943601e7067ac","metro-cache/fa/8d7ce9e3f315ea25c4041326efaa714b8ad4bc2607cbcd25997d27603d2909f93779ec","metro-cache/cf/6e775327e10396fee9310d882828fd36c6fa32eff0c9d2e51158c057983cf63b05be10","metro-cache/95/3bc8cf342f0046379f2862299df1b7e12bad8ec84a1f7bbafcc707fc7fd8fa5fd2e543","metro-cache/32/d2d9a5e642e00c64efa63aa8894345a423e916c36581a3a6bffac1fbdf85552408bb84","metro-cache/8d/dcea02b4595b9f26eec3297e7e1c1c1ab948d47f4790d9ca9e4785f38a2fcd0ef5455c","metro-cache/e4/71278802de78a28da9ad08e3a8de171861169d65412ead375b2091b5ab4c3128e7b78f","metro-cache/f4/c713b77df0322b441b14516cea2aaa9c7ec361f53e53b0ec0f3900453aa701c29a3757","metro-cache/4b/0246ab0f0c67453f9c0c30d1d9a92345cafb794ef0fb26ecb825cdd619d2f5ccfa9f76","metro-cache/43/6522f5fb734898802a78015508e7ea6681b712baa6c0c2651fac5791097677c310d5ec","metro-cache/cc/1af54d719c9a1ab0c3b8b748a779cee1eeb88b1450edef4841169bc4083b86bee235b7","metro-cache/20/7f3eecafe7e67ae85ef570ff4df8ddd5681ffbb2b1631e94e8319f6d36655d410acb9a","metro-cache/3b/2a4442506f70b97cf5166904aed07e04ebbca03d0da20af72497cbff4f641339921d9f","metro-cache/90/1863829453c9bcdde8536146def3ed85d321b6e2711a065e65d9035531824fc1ad3b91","metro-cache/63/cb575d4bf8accec99afbf4ec2e0d09010f6162aa1143ede3f26d228a5cd0841c7bcc04","metro-cache/94/46b05e486da960fb35ceeb44c9c358ff2c32b5580f8b237ef68a76816d896835350da6","metro-cache/72/3c60f8ae78bd79a8fc8d9651c8af4a1f3a30ccfc0cb31377630ed0a64fa65bb5d9a912","metro-cache/38/d96cb38102a12d08bf3b6b8a1606eef5548c11f158d9cf1a4eac0e23525b926a1641b3","metro-cache/5b/3b3bffc224d91cce3bf66eb76a6e416c6120186b77d7c3174d6da19b415e317c10e68f","metro-cache/d1/9b5d021f80d67e690133965fa71d47dd8cc3c3a16192d522811d32d0b4f9dc1e99191a","metro-cache/ab/575a2394becf4123286b1bd829927230ab5186932ad36dd40e6877f4cb94bd4c2c3d9e","metro-cache/13/42214c623b2acc1b31f4b1f10571bd0aa99f269c717645c28adb5ef73d7eab177abd0f","metro-cache/66/1b14ec0bbc0b3dedb0e2122170766814c2beadfce9537a74ea0a60bffcab2059e723a5","metro-cache/f3/29e4201749fc1fc67be08258833a1ec137370cb447bb5bc56ff2430c2ab7b0cd6dabaf","metro-cache/eb/5bb04fe0f566e797a06758fe3a66f535cf2c6bde4ee484907a5c5da0dcd06c409501e1","metro-cache/a1/82310a16d24589c701f743a0b5899d923aacf6f2193185a9a1be459808f07de93b4015","metro-cache/1a/3cd556753c076b70d4ef88c4684070e981b1a5721b7676e3994a77f5b84e6b82311ee4","metro-cache/e6/10455278033369cc18311250faa551a05aaba7fa837594b8d939b6c47b5cef148a1773","metro-cache/db/a2917a26537ea26183248fa2bb269759e372108e8c988cc6f86c5a388eb45589cd1e9b","metro-cache/cb/8a01b6dcf544fc6b2b844b83fb91e8fb75abffb826f3a25d448f7db29878fc45dae58f","metro-cache/1d/b9255ecdc28d590d9b759404b50f005931ab9fb33b0b3e80b53404fcc92f96f0ccafa7","metro-cache/e9/3da63cf8567725a822b36318c140b32ca95c28ce58b472356d87072bac9555c6fa8d18","metro-cache/50/cebabd75dd1a3856296f0ba1a181220b06b32a307cdace45e3558233d80ba80c31f8d8","metro-cache/b7/a608444860da60388f0c1d473653bf5f97ad6caab7f3ba3ad599b9541e9570a9f1b2f6","metro-cache/96/1237063d6077edc5e0824cd5f76c577d0c7de3fa268c50b43e063e0f43c3d03cec7035","metro-cache/96/4d1d9afbd2b9813e75c21f14e7a983624b5607f58a1a84f47ad6d5d5e710217beeb23e","metro-cache/8b/74bd7e972e57e0f0fce56e3146e7b5aa03424ca430683debc283846cea2de2a2130ab1","metro-cache/2d/c4e707d808fe31775f38c0c181dd6bf595e677b47467358bd102975ba07adf3692f6e2","metro-cache/6b/2ea0ac032f738351a84de370a6f9aeada016ac5c6de753b8e071e65de3b772d947f326","metro-cache/32/bbb85523fff3626f1fac16b1084dd11e6a01cc6fd8e63809150af1008cd0c16bfa1fc5","metro-cache/75/18c79c7fc7566866970957e0c772c60cb972b8ab6d9702c1b855abac4ceb1b29ba300c","metro-cache/18/2ea770d8784d69747e6906f3e5040a16250322262885f40e4870e7c1b91cde633acd99","metro-cache/01/017a9291976ca35fd6555f46f614279cced3145a5cc3da5b69acbf54c476c59d7a7614","metro-cache/cc/2a8c6127551c44e7b7d743303a9abb99892d257ac6a4eb62c001ccdbc4d9adeeba0d6c","metro-cache/8b/97f7ef1e59609a991e0a7efb5a8560ac48478fb856a42103e178353f3bec8478d19632","metro-cache/80/1510bbc7ddcc0f95f46662a6147b8d38cd316286bd2cc8eddeda05fc619c6d55135c71","metro-cache/7c/9c1448e5dd363fb4f1290e1dd14d4952b6a78ef1d020346810fcc12d4f9b949aa53612","metro-cache/a3/71bca7c1c459a0471c203b025e573dcb5c432905b3a2b4d38c0c56143cbf311fec3e3b","metro-cache/b2/a8c4334dd8311dddf59ca53c47eaa1c9b0cc70c586ab3300be5722fccef224af5cfaff","metro-cache/58/e51599f428663dbe6401a792cf016c84c8475596a73be599ad81fa4c87171116ed626c","metro-cache/fc/2c011ae0efa7cffa77579a45d1359457984ed897edb2419fc7111072c7da472fb8d61f","metro-cache/e8/c0f724ddcab4facf4effebdb035b27a41d9041a832c5c180eee33411a3cbf6a523d28e","metro-cache/ce/2bb21823864c91c452f9edddc8970a79e980c0c622c34a409a8e58b18377b2dbcb3ec1","metro-cache/7f/0548a211dde20baf3f0af999e101a93e3ae8154624de76f2ab40059b33fb8b89f1af30","metro-cache/9d/d932dfce282262fbf511ea6e8f5ff11c735eb15f9c359ade385a19035a71ed3fa1cc0d","metro-cache/6f/444e7cf9e666ad7ed5815189b16314d3b5690b391a632d6949f5a1b12b8492bc2cbd58","metro-cache/ad/86f039c45edce486f7c2e680bd1675b9c858c990a5b4d4021233d3dccb448e19496279","metro-cache/94/b21421462e72e2f039ae93df3c5cacfd245a9ce091634c7683b4d5f8dc8ffe2006ab70","metro-cache/06/38ea39ce25371de33fd712d826bf10f31cac43cabfbcc1b8a43c36d2c8b4716a2e12f2","metro-cache/46/a6784217641b5056b3703e34f016fd1c9111c853bdfb5ac91ea98a498f24528c7857f4","metro-cache/ac/48adc902ddbbd04a6d48f6749a9261c70aa438ab667bce2403137a9926cf4d1455be83","metro-cache/3b/179eac5fe86f579c792907dd5045f94649aa57e9b8691e3b7e5d04c3f072f7b57ee720","metro-cache/ec/6c0b0f10722e94a599f0f694c3345fb48bcb9c032c3f29c0940cb953036b3ce17436dc","metro-cache/58/6a8c597adc2d3e4d1b13a772090b195d498f6d309840702770f388d7c8e6857045eb75","metro-cache/2c/36d05aa1412db7614c61b9c37b6488217b4566649cc609059cac43f20dc6b16fbe463e","metro-cache/59/abf6e1392c5f3a5fb0863b14ac0a0897a77d9b24d2a4dc73054244131a28fc0c199307","metro-cache/f3/5e041b93140e49714c44829842c14757e19b79c4d27b020376f4f1c2cf231c272bc6d2","metro-cache/d8/e136ed9b6fa4816eb7033af920762f928caa05531ab7ca69828bd42d1db813ee14c789","metro-cache/b7/96379e7cd155aaee8120358906820644f568d8522a9c49467713f05c327ab22512a170","metro-cache/0e/86269df5499722696e6cc0ab08fbca53a60a35d3d26e41a9dc5cd7bd12edb1e73e8fbd","metro-cache/3e/afe126d26e26fbafa7754b27f39f01a45491583ac404fa6b56b1dc65d1cb16ac41981a","metro-cache/9d/eade21170f461e2fa4dc60abfc00fdaba24cd354198406a6df70f284fdfc3cf43d4aaf","metro-cache/fb/588f91c5e96a2757d51f02c3cb516049db8e30e21b1499acfae826171d4992de43c0ca","metro-cache/d8/1de43dc6c67d4ec4cbcccdb3e09047a14ea153eca771e966db15c7efb905038985eec1","metro-cache/ea/ff9392d37f5bcba3161249dae3709aa23625358f737e4ede8befe6f413ba3b133da300","metro-cache/6f/bb945a95de4f005e0b291d6249a3dc40a1bcc83d64ec96ec94bef386a9af6e126d12b4","metro-cache/86/52fda23c8d76b776f49c84d575d00b5f062987a1173abda485ca7d20ff7512362eae77","metro-cache/2b/07be3249f9d0c09add23eb07b55ec32503a635759cdfd2c7de1f64e457030abda501a1","metro-cache/22/bf471bac903b355ad0ae2b3e08d6712a1bb0a208c4f094fe5184d09c35e7e68898971d","metro-cache/da/c5e5149ecad95e4e3f96b4168e71081d16fd0666e9e1cd7473ea8ac33c2680030386e2","metro-cache/aa/0a9740dca73006903cdb3ceb80243f3662f74890ecffb667cb41207b1ad9bc8d6c8352","metro-cache/28/643b776f4fdb268b7dbdd42a330d9e310d8e36b5f2495bd743fa49e3e2097418b88ec8","metro-cache/f5/fda65eb8d765c3de2181766f77a7b61099a4d42520a454d8dbd648ca9f829acd871789","metro-cache/47/6f9a36d423905dc58d0f1d2def951adb20105dc898fa8aa6706492502431c680c0dc94","metro-cache/3c/7bfec6398f36dc2b7508fbc501b17f6af240c1bc8acb76ce34b5aec83c7638082540f4","metro-cache/28/c753f5753aa00f7dac0d51710fab2e01005d1f2b540c4df7e02fb7ac06c60ba3bae371","metro-cache/73/71a0a27e531ab1eece04dbb1ed8e4d71f1cbc572efc7d939433d593f0ce11ed8cc1b7f","metro-cache/39/9c24e1a05ab10b3305a3d415fe526dc6faec724ef47d02ff303772e373c40c9f7f10fc","metro-cache/16/1e8751df11296ef715058f6bdb09fc3e2a7209b065f05777b03502bf2f7336fdb04867","metro-cache/36/0eb2bf650d249827dbaf2c3bd2819203c48b9812f560fd746e06d2245838655e9b0b46","metro-cache/a4/73a95e4d3aee2aaf39bd709a02708982de718a0fa27b93ffd661a58f8b57afd9766f78","metro-cache/33/eaa5bf68cc4f33ef2465e480b684041154567c1ad173a482174e8966f3a54ed7d8f0bd","metro-cache/30/0bfa566ec701fd2268a4356cc1f9c87669e8b84b6c0c87b4944194361b204565ff78cc","metro-cache/f4/ce129f3c2321c27df8cfeed726d1ae9e43b50620d590b1ea1d9e4ab80b30e76ffbb735","metro-cache/a7/32888ae84ae8d27231f6d0951af4d48138b507e70a990e3406a37b1397d706bc9f9f2e","metro-cache/25/1a6feff485b3a4582d807c8905a865e6081ae418c86b9a7c298db80af512a8462fb034","metro-cache/6d/9fc7d3e47695da96561a050d2aea8ebe12f6b17e29a65b2f8835d1326a7524ff194314","metro-cache/56/2bfd54e6abc8d50b8d6e0efe625c0add853347880b9db0997d648fd540252e1f8ccbc6","metro-cache/c5/9289b711ce6c423b18dcc35c6be8c6da242f209bc7d04f85064865a7b6ef1e3e378804","metro-cache/88/d3ee443e0f002720719ff1de495865dc93c48ff2a4546ef3df4d535a3ace35a66a9d51","metro-cache/1d/1e2fa2d4105e3c2992f5a090c146529b0045ff2c599913457121d988c0251211b905c3","metro-cache/84/df73ef8a5e0ebe7fe09e879ccca3d98fed13025b5f6e2cd40fe23badee7665177af59e","metro-cache/44/d6df74a88d0e0041657397137dbf90522bf3d51586b9ee7315d95017664d706fab22ad","metro-cache/b3/8827c8e91cadd50150f2ecf2f7f85e638f154744678907a9bd9c6fea52e702d23627e9","metro-cache/32/fe3e6afba5cd6a484deabac68e691d94713a985cdf03b1474e3b9f7162190a83022050","metro-cache/1c/639588c85cc598eccd7e86680021bdff76d166355052d633d555090e080ba3712e314a","metro-cache/7d/3f086f1c1889a136733ba39e01961785ddaa9fe55bef85f8970f0daac8c3098f468693","metro-cache/6e/4ca8e04ceb84f56896f456605108b67f80126916ca93ecab6896c4d4384fd2b0db2198","metro-cache/26/74a5deff7479f5703198d52bfe463750687b79a52defdbcde400e8755aeb760add4e88","metro-cache/c1/500441528f38c4b86837978b278eed47feda930790ca35148cd94d90cbf67f83dc57c9","metro-cache/98/3f7f761d88d737352b5d78044fe44d924357144ebb96855ec0cec5a9c4827b8668d259","metro-cache/6e/af8b85e97c11d6f5d2c78ec64d7629c0f5c46193377db830d25eac3333baf911f67870","metro-cache/a8/8dc92212ffa01550d29ec58abcce5fe6dc66f2ec504a4ee6bb16316ed31d1743a52838","metro-cache/eb/4e407d9fba7f2ccee2145d22f383d36694287e3f2e3bd86078aee00f31f5612f884088","metro-cache/b9/ef4b9ff65320611ff4a75781624c591b4074d6b8ed9821c9286bfcdf912b584aaeacae","metro-cache/01/1367653468a68e96da4e3b7c08435ff3d373fcef29341c63332fde70d091f95f7dc0d4","metro-cache/ed/e746705b9b51300e2203922937f4479c6364eddaf022891973f38676b1d9ac719c56bd","metro-cache/3b/0809331920bd4e9710a348fa4d1c02ef71d14b2f2c1e7669c1e2c5049c8dbbed7d4577","metro-cache/e4/f3d717b99e862b124502aba9b816c1ada42cd557e6702201e99d5e16da04480b371f0c","metro-cache/3f/785e131e8f590b20f9e5451f814919da62c3d018cb84f84d12441c816c930b3d88b51f","metro-cache/ee/db5eae006d5b2638a23c53a6e9f6c219b90a89cb84cf0a45677e2488636d00f5d5d2d5","metro-cache/b9/f0859543f5bfbf2b72c316da8833de1c46d16cf19816eef5cc9d64c7e0f84f0066f520","metro-cache/6f/78663e49f19d64b174ff86237f5507efc3756a16a4a7781db09e43be776e72259d06e1","metro-cache/db/9929084ccc6924fb1e626a4eefa3035b0cfee1a4b8fcf9bf089136695b686c64281914","metro-cache/0e/7f3a5c4c292a54dca23290baf26acfda3c0db4f2c0d582fbf1e9f0c07ae1e1619f30d0","metro-cache/c3/4b77ce6c5ead9dfabf43e532dea90df71146e2a8111eb5a7d66efe6ac5a2ad6711cbab","metro-cache/74/47881493f533ffe306815f4159b7f27466708d22fbe0a64c7e7b2e2465e84e9b7669f3","metro-cache/b7/3cab097f1a279af71f80e134986b5b4784e631e73b651615d7a40c21f28f4dac9a13ea","metro-cache/92/fe865002c5e283d9877af5d19d70364b5cdf7e761af9618053ee6b65a43d7874a8113a","metro-cache/7d/92cb7791e0777558796e4424c3332e1e877816d921329822a415ea7e1ae2bf76774d04","metro-cache/40/98509a07d0201d2e798483c47d83ca62465e56c468204fbca25e791a5ae8d58c9d5672","metro-cache/19/962b051d8b1b79d4e3efbe9191c44d0c9a3ab79811692b29b2448da8e92b828239f07c","metro-cache/32/a8a4dfdb9546555ecedfb5111a64e97e2f9c147d4e0dc25e5a8ca81cb83eb5653c4d35","metro-cache/73/bad0f0c052d5585d4fff279949793415fd49e52ec2bc900c9410fe703a1494d19f4f19","metro-cache/b0/e128f7e02bc98ca721c5a9f74c2e3963b354f3dc93ce32844834589de9c8ac510f3858","metro-cache/4c/3c45fee8c8264ab4e5f9d4ffd530e9c74196529541236fc08a54879ef96107c04cb2ef","metro-cache/c4/47819f3afc1fb5257240e7d98d795a07aaa7705d099a508d5c978bf837889d0f9e29b9","metro-cache/7c/0d273bba3268e9cacaa336abfd1b0c7e626363bb2acf593c61d5bbe76e443f58f3593e","metro-cache/70/cae48e6e1bd356119cff8b81c7c0586697c1db52c3a12d9da651161d0b58156bbba859","metro-cache/7e/7e9d971ce9a2edb7221a39254f4d63b7f00ed99d8aa81c5b33e8c1ef039c70a4d20234","metro-cache/0d/4d4382631b081ddd184e3eefb58a6addd260d91066697d34262077e2511689958163bf","metro-cache/73/eeadbc6e804e20ae419f567511c44dd91c99d60bbb89d85ee36bf22e40be8283ff8b95","metro-cache/04/9a2b5dbcf1a55c589293232d03a23ee0202e473bac8448c31984d0ead8083005bc46a4","metro-cache/da/bace2a471d8824ff7f39cfe7ac0ef4aa5f836de4c4f74fa1b06cf029da5fd368a1b52b","metro-cache/a1/dc08ed271f46c0ab26925faf77f97b5ec7c402c0c827a0d0d6912866becb91a7f20f08","metro-cache/70/d327ef3bd675a1908bde1524b140dcfa25808231bb391ea64a98a6ee30ef93fc651be3","metro-cache/ac/61d88c0fa6a0761571456dc82b63d6a5a2d8ad395ec9dbd9e21679badc501a6cbf89d2","metro-cache/e3/879a49148a823546427557a66dbec69254c382fbb46c67d53dffae70238cac70637350","metro-cache/03/498a5eeafd0ad3894d4220060340256867b2572ca8b36b716842df4ec933bfb6c7e910","metro-cache/11/e0b6dc55a2172e10e9655b1bec3b28e029531cb66f1a6afd3d77d94a55da8205560f76","metro-cache/ac/bc65e855160b9f8ef00302f50c78be878607dd34c0cf7dfd29ab83666a604096671073","metro-cache/7e/4521527d7bbf0d45757c7cb17ffa74115fd076dd6165f1dfc2d509508be6a7c5d0f9b6","metro-cache/38/3cea595353278c23f29ef8acb0cc498b6bd2d1093a111a1ac6ab91cfae798f9c62d40f","metro-cache/4b/1842ceceb5b537422d2c5a29c3184939624ad0770ecc208f6e891ebbb1903e440a7029","metro-cache/d1/16a95bc4f7e9763169f00d10d3fedbf3be96f13f5a608f645e755839dc8e0f774544d6","metro-cache/d7/1352bb15c040f3500f76c2062909fedba1c968c2a16022ea094387ce339703a14130ab","metro-cache/78/ca9af7cdce9ee5eb3290ebae6b35ddf145573a35268dc10646051aaf96b8fd1d89eedf","metro-cache/57/794ad38f04d0c2f609adc9ab56e39b6bf352455512c3cdc13e2da2fa5c83fd35b6dac2","metro-cache/ea/301e88606c7e980d0da9fddfe31e6333ab4db0ae7e64d751cc19e5870f930da753d4e1","metro-cache/70/1872bc4cc174e78ec14f08b3cd99f725279e5d7b3a59a23b0726a2c2e390eaa6145f54","metro-cache/9f/0490614da874398f3d553caa6bd8331da66973e773004b77d476770db1be05970f5c6c","metro-cache/ad/042be0a14d4d0f86da8fb0bc46ccaa3d50bfecaa1c9d9742ebdacb0f6979a535a77594","metro-cache/8f/744747a6c22afb2c2e8f294a212bf1886b6e364a156fbc3b11c09faf748946114bfcc4","metro-cache/52/cd05b10d4fc6ae35991f39de8fd55a770d4850114d08e47626847c5f17ed8b303750b1","metro-cache/a0/0e9c4f7a268131d928406758077152e3b6f983ff9ed1e4f2a76437965d501295e08057","metro-cache/cd/5fd1672d1cdc63a4b49a1b17216cd7431e1c4a20095f71c1e71d5ee92d8c6cdfa44311","metro-cache/b2/fb1bf5eb63e912f2f23c812dc166dcdffa733a378f1d04193bf1770c591463ec5e9c1f","metro-cache/79/51866c39996cd9c30de5f788d8bbdd8f31c5c1b3f5bed4721113735dabf4ce8caaf95b","metro-cache/c1/e88583908640e38f6023772d2ae32c08cfddb198966d8b6e6ca3e7dc98abcaaaa02be9","metro-cache/37/2835fe70f8cd1d2d68d672ecc95cc174059e050a74d16a38a8a46dd5a34121253dbf06","metro-cache/12/43eb4b6daa5a810eda732c10dff149aabb02936546ad78dcce7925be18e724c7d2e6ae","metro-cache/f8/dba22bb48455cc9bb7733ace88e47ccad0bb993bb27cdab79898d40e1427d1d6f5553b","metro-cache/a1/548ed51651d07218e1f2d060ab26a292607738e83d33295b4bda3f825886cc619645a6","metro-cache/af/87001c1c0ba39cba6fa128a56d73a44874e2c0ba57664ce10625ce624a411a6a5e4a7c","metro-cache/ca/2c96de175464d65c168804b62f9b6b1a695b4eedb0abe748db60d89b07e57589f3e5e1","metro-cache/a2/c7d77c9ca84cf88c16860b16e44fcdc9352be370722bd749f45b5995be744e1adc5b6c","metro-cache/88/950eef1b3c5a0ec7e80e1a3e4448bf504399e8a7a81ab317a222fb808cc4069d7e6ab2","metro-cache/13/96265468e0f4929d1ce860572b4952db79f111fca8791b02eaaa480611291aa4f1b17b","metro-cache/8e/5b10a285687964be66f3766688b34a4c272a78cfc6d9705a0255af553a58993d1696c4","metro-cache/fc/58dbaf6a2e5ea8117a1fbfeafb6e901c260b4cb5fe4b5a8b696b5178b0eddb0a7abb61","metro-cache/90/c749a3a93d3159ac4e76859e6df4aeaf471f367e1f1a943ca05ab98950c223617c312f","metro-cache/dd/0c56ce0f0b2ee7b69913cf7e887ce79386c8bebc506491b4ee7b098c26f06b1dbc5d26","metro-cache/a5/5f9fb2b7824ca4900fe58cbfffd48986e346e18aa62ddc0a90b99148a23e9151952334","metro-cache/4f/237c3fc3d330b39446a996c9a3c77c1f86eb97f0de86915326b565fa50c2fb5eb91c4c","metro-cache/68/c3f3c26f9c7d17128b03a56d16c740385224e2cc37cdd11c77ebc874a88e4f7c8b6b4f","metro-cache/d0/021d3e2d07c5226b4b7a4e91d9367929f7b67d6f00a851ec21f6ea6c06dede92703bc1","metro-cache/f6/a1283b64b2af3651df0611398bc8eaeec9127cbfc8223463339589a075efad53332aa6","metro-cache/92/2bcf574858c3f2dd15c6fcb22ae2e12a7b6860b63d618e46a578c368146e8b8c94ec45","metro-cache/88/cb500392a130f1e7e380f16a4b91f674718810957edcfd47a87f9d9f754c79e53ab500","metro-cache/b5/3628f27bcd634411190a6e8cb1c4bbd1fea14ab0229525e7438269f4be2bd8042feb44","metro-cache/e9/15bcb922dd84f13e54b0ae82265f98ff32848a40614b057ab8b055dcfb09a7daabd6f1","metro-cache/34/3056ff1cbabd99afa9f4bf4f3315b241ebd6f249556f9bdf3553e13393d663614f27f2","metro-cache/a2/1230c3823fb43b6cd3d8dabae04d92d04af1049fbc0926c94d94213fed2e7330679c53","metro-cache/79/99a1d94db78dfee080f7ee0525a920ca71d59effae6426b13dc02ec154ac266a37c9a8","metro-cache/a5/c274ecbc77fd12a785ea260796816b19446976d892fa7124b0c3574dbc5173a2c08231","metro-cache/65/8fb1b43a13454087d560eca1b9f66e51a16f1fc617a17d2546dbdad2b8670c61ea655c","metro-cache/17/52c50c046195d0e7c1bd39d4a86c40fb9ae4a280173c3d5554976cd2f7beb749d26dc5","metro-cache/de/565da312c70cc968ff8da771f548e86e9f78983b602521ff552b116daef075f6edda21","metro-cache/a3/4aa29bfb043b3f980c0fe9f87dc78642e0e197645ac6f7aac2f191def800b52feb0c9d","metro-cache/1b/fe076b93c0fbca3bafcf4c1ccaa26cb5d6647f74479f74414d7f8308c76c4c78dcf44f","metro-cache/40/59413defd9a33c20c1ceb822e9bd0ef29f87ea548c062e4e7b17df11f8cb8a9e93e350","metro-cache/ae/a5e56db11e0fcaae1af1e4f6b037c0080e396bdff3f6f009cac54e4e85231326bd7098","metro-cache/f9/23444fc00012b83dbf5fcc0ba1df0e408ac4b5012283266cfb78519db2d1f6553082dc","metro-cache/70/7733c363d53d6db74e0377893d7056fee117c6e29096618f4bb64b6c501ede4d6322b5","metro-cache/79/f25cc3a9416e72ec0eba2dcf1e7d1267ffb8c3aaec16baeafcf829546cf16e014eef64","metro-cache/bf/632a735b6f3782799be9f88b677c097e42709d12a30e2b407bbd73e125d8568bc0da8c","metro-cache/de/439fdd1bbe480dd78e825875553a6e39bd2bef758d36739b805360871478d96845a724","metro-cache/b7/d53106e45ca32a71e28f9377a5d79e79c3691018838a05069eee7d9503553048528b69","metro-cache/b6/e426fc7734f6662353519544e286532cae483e09388b77d566e6f74ac41265aa0c5d77","metro-cache/3f/5c1374f7de167ae851ee62f0c64791455dabedeac8d2e500759e8e60ac8d85ceb63ce7","metro-cache/12/6c0abadb2c54c473090eb6d54c753beb1dabc3a9974dfcabf71736640d2f0e5305a3da","metro-cache/67/14de1908e413e52a2bc1887c636c3b0660bad6704f1ec15ece242a7a15a7721ef727be","metro-cache/cc/ff34d7bb19482b11124507299aec3d82256fa61412b6d2af6cddf3c93fbb4bfa905543","metro-cache/6c/aca69bd7c9c0ab850fb42201f1878922cfdaf82ce64eb10295e9ccabf9247be4d8d47e","metro-cache/72/9638db719dbe3eca83bcec80aabc168a4769f97d7af98b2c8181c29fc738ecaa51544b","metro-cache/61/6cc7db07bcfcba6b146269bd000edd364f4d4b756ce5712be0b3b62316263ba3741ad7","metro-cache/b6/72270289c54891a908b765e2b7ea305529805ef9b0f40e3ed0d9b123c8669b725a3b02","metro-cache/a4/699606e14df1a4e2b4be24fc9549cf282532bcbd7a1a69480e247afb22f24d489d6ba7","metro-cache/f1/c87212ca8eb0da7f3a2daa7ef3fd9c3a14273c4bc030d3906d56aa43aa22e7ba6c6d7c","metro-cache/a4/8521efaeab2c12d65b9a942b7fbe00d1cbea1df65b7e296fc1a6c5d0ce516b9be7b30a","metro-cache/f1/5893319d73038f5fbeb1fdc9623bcec89d1e1fa50b942d073363e96a2eca2f9c8f00f3","metro-cache/53/738d822fdcfaed2d209423fb810785e9831ba9c8c6806de5e4c07ff31b9567daa19eb2","metro-cache/c2/c978f9ff0dcf03d7ac03eb89b62e4542a8427aece7c954f08a8677563f4fff68ad5ec2","metro-cache/9b/c980f065a4e4ff3c31e8170d1bc6bc8d4a251b5b785c0f83587aab0a68b920cccd272f","metro-cache/b0/cbe1c7c7c9febb054d3e8805b0421bcb2dff549dce6b872bf997709e25300e5bafe8ab","metro-cache/9a/5d386f33ac880c80066fb695cbc3678fe1929729619da339a1c259ba6862d6d7ada95d","metro-cache/6b/574f5eae88201d9ca19b04e0d5e9c849dcbd36cf95209331b5366df15c4aa4349f391f","metro-cache/a9/73bb4c2edbd3a3c989b6406804d7642318df9f018858302732a0d573bf4c43b73a2980","metro-cache/a2/bd5976d6f966be6ff63a5c00ef9c39ace5db6e20f9ca58701d6eb46a1b7e130963155c","metro-cache/75/913fbe3d84b681ba5c1b6220fde506101c16691ff3bfde140781722d3f8a28ef046baf","metro-cache/a9/810a6dd35abce4073495c081ec5ecc9436dd900be0b451003984d6c4f94f1fe1eaccde","metro-cache/c6/c1f5c60e1391ab154ea4f09df730bf2fee5fd5cae0ebb19f8e652b1636e9b8b5bee64f","metro-cache/4f/aeb0cd01df1100806da08519b3fe7296d3c8e8a6da3618a0b1a8da41d7bc6ededdc4bb","metro-cache/94/b7538def41654771b71712be1f36df249a437adad0d0665e06ae6343aecc7c851bf9b2","metro-cache/77/1358040a13bcb1de7d68a1366d23bbfab7f372b030aa799625d88a2f1bb7dbbcbd809b","metro-cache/73/02572229efb0278068a31f58a579de398eaa9ec2236878490ef1b463a5a324edc9bb6f","metro-cache/a8/dccaf825373c52b6d6211fffbf799d966852238bc069420a6402c27c4eee4fbba8571d","metro-cache/f9/393921f3d49e81820a7dc7c4c4d98cacda22b3f526ef71553db94b94009f30421f2657","metro-cache/02/aec10c0836fd0c764adbdd9188f5f0f0aedf0023dc9feac49f191f24da70534a31fb71","metro-cache/d2/eef9b899cb1292872fea44c860c0292b0dd63d32395893da707eb33d38fe40cb7eac06","metro-cache/23/29d9f755c668c286d92152ec83b3b51008b9da2e422063521ecb65d8c90f00991a1056","metro-cache/b7/eded85a9316c523e287066245816f90a009b9e7005b38ac40b1bf5653365f0a7ae21eb","metro-cache/7f/9db8e20ba38098772fb67e4d441dfe1c1297c032a2eefbaf9c6094508c3ca9bbcdf978","metro-cache/78/6450e4a359c1892e43d65567db3074df9a0441529d40a1a553a36647091e1e49bbf5f0","metro-cache/5c/a192356060066965b91ec4d1bd91ff8dfc25df75a5bf9f89314659ede6201a2ad12874","metro-cache/06/f3a6ec8a5c12de34873d90f312f0a6c025a73e037d012f746965c31addb73272de37d6","metro-cache/61/ef95ed6da75805da3af3f697fa66036f7208762ac05e87fed991b4ab24a35de42d2f4a","metro-cache/5b/d58d58301981725f7570bf4516e72eac61ee1b4a8e1763730e04ddd1003d4ee994add8","metro-cache/1e/6db9af91d981e3ea5a8eef1e4bca335e5d4693636eb4b2c4ce3e307f0573bd561709fc","metro-cache/ba/0ebc49e32c0ae08d3659b34181772616ac16f01ef9606ed5b714fd64299118b5afe1e0","metro-cache/0c/0105c5cecd121a475ccecc254031b12b813f77095eaa5ba54de2f1444b4dd8125fdb40","metro-cache/26/9e59aa9ab4a30b3f11adcf8b249a6f51674a8187d339507ae700149d4c3f2014082c43","metro-cache/54/7e25ec048dc74f336e30a0e04e8803e6fb8581e5bf05f66a175b4ae26c96630e9b0450","metro-cache/69/75fa48355effb29bede75189fae986006c1a5b2d7470dc0109ef4abec1eca21248584b","metro-cache/89/6858d1bc63b1aa101305777396f4c9c934b17426d91d5819f5c0f76ca0eb216d976fd5","metro-cache/c6/489fe66ae38f3e7c247541b6188bb378525553d6f0f40e1ced2708cba326d28e6b79e0","metro-cache/6d/aeda73ed0ac9fa163e4ad78f5aabc17efba3fd190110f9ee9bdbcbe8ae7aa1effcb345","metro-cache/97/dc6e87f5ae278c5e9a86b3923ea36cf07a582974ce5d9659af5aebb4ac8e58d2ef765a","metro-cache/6d/698c7a882bf5d77e85cfa6de936733a8902c9d85ca9bd0c529b9b9e1f8928cd9c4ec57","metro-cache/c9/8c0712944a1e5af9d71a50242dcc18a4a4ac71cc153f9c3a7a30bcc268f3d19d06d63d","metro-cache/e6/b8ecfbb0ebf7e9c028a194c7ac89ac2dc8c3343b0deb548f08d6680145876512eea3be","metro-cache/9e/3fdd3f6c0bdf8e0b8307b80ed16e1fbacd8f498850a7e816a40998644b88d030fb6778","metro-cache/4a/bdaa0d2baed3dee22cfc1d1294b66bbc549251486d4c35386fa782a58b059c5e8b0020","metro-cache/2a/49739c024a8b2bb23268173569b14ee3f2b013ac223c12c3d22f00b622cdfe14929b4f","metro-cache/74/96ba64fe70cb3f7ad39c70e89853c6f955d1c00ef5af0ceaf3183a79bbedd9df70a98d","metro-cache/1f/60d6dadd93bfeaf97bdfda944b6eca6c1870fa7265484430a5a1ef5f7e23d611061f85","metro-cache/cf/ed13b7c3bd5cd3fee6e03e789956d7633cc43203ebc98747b95e28c533d3aa90f857cc","metro-cache/12/eb4594a61549c9828c0349ffcaa66feca397c095bb9cff005cdec4a31f30f5bcaad922","metro-cache/ff/1657525ef1d32b8f2c5690f2fff6a7de05c054f29b1fa098d286ab14cdc2843ad60a06","metro-cache/92/a6bfe524258fad700445bb1f66396a9277fdd5fcbe287676aec4cdeb5a612cb846b379","metro-cache/5f/0037bd0e31abdecac526a86de21e3f07edcde3b1550d9aa440f1449d026e44cac44ef0","metro-cache/13/313b662e00c357d20256ed52a00e3f17059b8345631dcc4a7c36fff4cb090f88eb7413","metro-cache/f1/03c2ba0684aa30cd15b1866d93c9cadfb554e7422293e0ff46aed39e56b0567f58e4b5","metro-cache/25/e6c7361d0088dde13ad1a36d67f5881181aa61f00c0b32f8db347d887f329cbad5358d","metro-cache/51/f9503ddd99a693eb88b7807cba6b565eb3c8f78717bfa7adc94d97e36051248e5c1eec","metro-cache/5c/eb42de37b3faf6260b245a312b8c11a07ed7a78921d8160e4f5d834660aa95825c610a","metro-cache/a6/30a73fe1d9e93828d15e044b37586fad1669405577a2aa7fe742e34e7ccf2a5ba4cae0","metro-cache/9e/be1025f84e90892acbcff73e8d15b5f1e4a998f276163e09d8736508cf8731a78c8b1b","metro-cache/5a/7874861ce8f5f69437de9b33df345502b06c6b45e242c56d29c1d5c75536561bbe16bb","metro-cache/69/0d25e36b9413fe7e0813497cd51652d1989cceecd07b19fdfc51dc173479986dd3c9c4","metro-cache/36/01a1d5e833330b1fdabf260c6030c64096f7ab3aa503ee4fc9199b4a1302c109c3454f","metro-cache/cc/f330e5021abf4711c7b89998d0c599f01c9912c9dc00b470b2e8f41ed95ab70185d57b","metro-cache/e1/eb33913ef4d0d3343754b2b3a0cf2967ddf36f727a1d8a99c1324f02b8dd6d897e0a30","metro-cache/c7/983a24fd3a90fdfec5513fb1cc1301bd017569bbcca1e695225b1ffbad3943a687c38d","metro-cache/8e/fe14ecdeab07114469472bfccacd1b031cb78385bb27043fca42491a60aa8a6d1e9cd4","metro-cache/a8/f716f4dea27316b020f584bdafc69ba8456e1d4207c4fef2f33f17c6b0b6d19ed90ea3","metro-cache/3c/c4837fd0154c9b95005ef299223970bd017569bbcca1e695225b1ffbad3943a687c38d","metro-cache/e2/cd8a83fb0109c2530d530d930ebcc15a136d55c4d0bd813264d3feff3c26fbc605272c","metro-cache/13/fe5726b3ea4a133452d10ace740852a1a8f48a4e56e8e61807646016b8dfb6f17963cb","metro-cache/5c/164efe87c220028ff36a6faeba0db4dd16a139566efab77a88bec5e6a8be1153a0302a","metro-cache/a6/cab78680427101c854b2c36f5dc039f6d155c84bf33cfdd109884cf9202508ed197f76","metro-cache/a8/22cd64808814e4f5dba78bb6608347f14e8d990561530baa8d72bab876d7da1713515c","metro-cache/bf/fa1c66859d3e47e08952c86e1b1008bc6aea33196a3cd30be353281864950da07941f2","metro-cache/7f/a7177fbd228a36bec3f0858401ae08a903d7a044b2fc6b9cf58573f8fad39e40a426d8","metro-cache/a8/a977b6f348add0e87adb367a04ed5306a20647259844b7cc7914bb58538f3b39fa38b6","metro-cache/ff/c0fabbf395d0cab31d70d6c35e98e0f261fc5969827959170bd316c012a39bdeb03362","metro-cache/e3/64d602274801231f4346d7f7d9f76840faf1f36cd3b93f8bec0809d562a2543ecf0074","metro-cache/3f/8002cb7fc7f43b3010737e07e99b7f97e941a7f40f77c6fddbc74621dbb07f7dd77130","metro-cache/86/39b043b90e70e83a2d5831533bd43509ee2caa587bed44f6b5253c56e436e2bda271e9","metro-cache/ce/eb0b9813f1dda1a9d4c582530ff6bcd2179e3f400debd5377b58efa5c981ea236a1f32","metro-cache/f3/9b8a4619076edc043ef835997072f1114fa2b2fb0846e55004c1b0045d3b8593b9c083","metro-cache/96/9dd676f8e29bcb14eb3e0351154831ca76d6bf4a31003fdd4a977d1f5a5713c5b760ea","metro-cache/96/bb0792e0313fd1ac94f06aeb3ffc97e882288002cdc9dabf4a1517ce6d4fcef9710a8d","metro-cache/fd/a79e1bcb963c4f7157c8a1b077acb2be039f5cf18e094455588157e4fd4c216f7b37b5","metro-cache/49/b83419cf71a088377a31b7ad8ff061bd9f4d9f2ca128a7fc45d754281c77e40e793a2f","metro-cache/f3/233b412bac2a6b184ccc5229c56ccb9fc3dee7dac635965994c4d112be5dfdd8f7d894","metro-cache/cc/05ae9619a2fb32461de768bcf410fce4fed3812b741ad5c1b724646a069cf200d64319","metro-cache/39/98e45713a7998219939721ae15eef8b7c3c019e4e4bc615f7f73c3fb6872943f28a311","metro-cache/53/483554cbb7c26477d65eb4fdbd877e93640289391cb6bd69d4b192c31ad5d9b79f6919","metro-cache/70/649d6f24a3a0c36152a0b6d4249ee7686d3d8b5e806137ff4ae202788b7d7e4166bfa6","metro-cache/dc/0d2222e7008ad4a0fbe222d22be6eb6c84857cfb7c203e5627ed619654fa30d3ad4a45","metro-cache/3b/56568fd57d016cd7e732f9eda6d6c19d4545d85af6536c45d3dbff8fddc942fc057828","metro-cache/8c/1c46d5b624b2d9f181ea54899f032e1f22c44c855736323bfc1bf3ddc7925c91e9f3e3","metro-cache/30/7e484e29196b9ddb2845114b947a665215c46ff7e4acb5fb140887f062dfb66126676c","metro-cache/ea/9ba5b0c34f69a189c0f0fcce0c124d8f63d424524e772b994ec35921036ce8850cc007","metro-cache/8b/e30914f2a4a164738e988a1f57c11019e0ec83c766927b1c96d961ebfcb485dfa3ebb0","metro-cache/d7/9bccd7939015c66e4fdf2791519b15c7b78d4c705c9bb51b451fa9cea4367675144502","metro-cache/c1/412d40d9b0ef9bcdd5d16ecf2eeb1436f8525b5a8c5a95274ed49581859434d691c0e0","metro-cache/26/6eabfb436bbdf1bc51df7469e9e6854cbe6bce963ee356c1017440b908b3d3682d2061","metro-cache/b0/d5aca858d4f589999e123f7730b64383288d924078f2a0aea40f31ee04d4b306ffdd98","metro-cache/e8/3f1d1f67d66d422602ee76a3c2590722ad4a3f3530c448a2752aa7158d66819e5b8609","metro-cache/dc/e0f29458c981584d0e3c6a42f272280eafec6244f1db6336aa5b37986984216e69166b","metro-cache/d2/c677cfdf471f323665e3c9a41f3132a73ab16faf0dcd0a82995bd2abcefb957bf61232","metro-cache/37/37527fffa3b967a6f524e90d732c2ad27334a759dc4e083cd86dda798231c5ab2c297b","metro-cache/8f/baf624c2aa4a38f69c2b0468376d9e772ef0b23e93e07360d14aac6322db6dbea2ba3c","metro-cache/22/474d5ef3dd2157bc838ad33811bd1194b4dfd640d95543974fd08ee6cc907de432a6cf","metro-cache/a8/0c8657912d0648080c5a4b33f7c38bcc9c3b4ee728e1d19ac7ab89ad5de81505571fdc","metro-cache/80/66eb2e92df9531ef961acb4339b03ad51fb50e0fd799a59b20c3a9a44ef06a73288e81","metro-cache/80/ef857edee160fdf2df199cbde7a4ce2eaf4dd084b8b605c2c1e378b657e14f3e9babda","metro-cache/59/07977b07a04164bff21925c5fa2e3ee4891a86571ee88b0ae9e32abf3d3df064b69020","metro-cache/25/dba0b1ab20a1bf55f161210d25deac46bb8c978a8b0c0f0a1b9f8b82196d8bdbe8e905","metro-cache/8a/d43d014a886d1d361a885e4e285d6ad95b2bdbd831cbd00cf9fc6700385081d6e8223f","metro-cache/19/d7ee75d8dd56573f30e70148d932affe1fa8709e923c50172fc82459fbd1908ad6e54a","metro-cache/50/3e49a26576bbc09d62357255ebf9f903f5398e921bc6773a619cb8747d4683c7ea5c7c","metro-cache/b2/16ec97a5841329a978bafe0ff97a4ee7de7c9355bfc9e35bc27ae308c761bbff238ff2","metro-cache/e2/014701700518dc5f6e40562820be14aba0e50ef0b74c34efbc0ebd9923f26619cf64ab","metro-cache/58/5f813af1062df8f8845f1617623af33d623c713cab8302e87e06e5d424c92c60cf4455","metro-cache/89/f535caecb6004f623f679fad443514b02e7e7011f219f03f4f6482cf6e260ff624a41c","metro-cache/b3/dca124d3ce6cc3f6fcf42975105ce4ee3a807dfb536fe99b8568eaa326ad5f64d90b8f","metro-cache/05/1963909aeacdc1bbb0beff3842ba08136ebcb8d049cf4ae83acc1ea4a5125fdb3cf21b","metro-cache/59/fe29a395b8c9544b31a4577c0471f0944493b3efc3a67039637d9d2851cbab4088cfb0","metro-cache/5c/5ab7eaa686996d038ec6f94a1c65641b7566818f0efa9d847e06e80550df0a3917c8a5","metro-cache/f8/ad161f953b8f633bcd1d503bc3d64802719add2a02e1fd26fee7af49a81a13f7b3d6e8","metro-cache/ba/43d5768f4ba1d662a672b5bc8ccf119fedab17af54e6360be4a53dd17b7145ab822150","metro-cache/70/4d64fc6f50dc62299c2155b7b3e5cb8a37583fc44cd3c9804cb0bee11362871b854969","metro-cache/23/3982787c4c36419aeac549a1e7b9b349f06a7e758613a71faeb3dc0c0f62d85e7a9bfd","metro-cache/ce/3908ce32438fe1bd8c23097e6ce41ab079735415b65c817d219783930768f214570529","metro-cache/db/6b60612b6263dbf6539bc95cf1d8c8cf06cedda36144ae608f36653c74ef7cb46d431d","metro-cache/75/970cbb07c053a564ec455afabc6227c0c7a5b07271f7d19a6f4bfde9b04b45c4cc4068","metro-cache/3e/e3f856e6c40d7ab284df77dbe81c6b59353115a8ae488915463b4425f39b70315f59b1","metro-cache/4f/5311c9a30ead7ea769fa618368cc2cf99cec9eb8997fbae9913e2d1e15d1e64fac9a29","metro-cache/a4/55fde5e6ef8440d844dc1e5b49352bcd0cc5872b88d4d4574e9b11c506bf4659ff15a0","metro-cache/16/ce45371201fe21356943d639c1a6b56fe01c397898c76f12ac8daf183b4cadce501f7a","metro-cache/57/9180aa54e91ff15a51912db09d39bba187911e069ca72aa98ef1bf03481bb4d926117a","metro-cache/b9/cd6b98ea449fb9f777647d9af19ab933fc9d051f0edde9a40e59107d0af886e563c2b2","metro-cache/7f/10c367dabe178704a812b8c3ebaf3bea0774fff8159f16dea8bee3249fcb10a3d32511","metro-cache/31/7e2b4817ab7aa7917916b1124ce238a114f82dd8267046eaef88c69bc9449c6f7eb62f","metro-cache/45/0dc4053943aee78162e631768c37954085eab4628f6927f1c1d0d387855232b1825867","metro-cache/3d/55da36fb3ee637b9213065d93f92b502c51f0493784d0e40a4e4c166399e3d8e512981","metro-cache/d0/fa986e65e6a176c2348a3219bb7a00bbdc9047d2a940bf7439622540ee110ac50fbfc2","metro-cache/7e/aed9ace01f49c31c9eab5d581eaad2f5624957af74c1370c7ef2b0cd4b7c45fce25930","metro-cache/3e/8c9814be9b304b55006b5718822b60bcdf13510f94467e86f6c808b221ed4a93bc0049","metro-cache/32/bd481edc04a86232ee4186975dc5ef286b789c1384ce7a3965f771e09bfcbbda2cdc68","metro-cache/39/54b778967f2d897139be7964bac61f264006ae0e0923de228fca4251e6776969357c87","metro-cache/7b/bce91701fd53a11432c4bd6ae49c93f886d1b250ae2213be88ada07181ac1c5573ae21","metro-cache/63/e592396adf72047ccf271180bc6bca9bb9a2876f7917338c439c9d1da32690fbae8835","metro-cache/ba/c3f19702b7d21cdb9301fdf82045e12118765385dbc4944f2e44ae421c0fd34bec6538","metro-cache/66/15980b2aec0b2a3145bc0e9f7297bc2cdf1135cc2b8fa5d218130888fa5f369207593a","metro-cache/51/a5c26cbfbac11cddb62404ea62f65dd1184e881247a8c925ed88e3faa36c230a1f0335","metro-cache/39/d6c2a76d7510cd1ef5c4c3ac6910cdb66611b27a91c0af5b2178fe555781ced4471424","metro-cache/35/ce51788b97cdc998fb3e05dca57b32c1b76a45a87e5db3e9b45dddb7a1c800b2037101","metro-cache/d1/b12680d126bc3226e1b65f70439455adadf0fa9f32cf6a7538f3fbdb43182bc5ab7b1e","metro-cache/35/f8a3ddb217e030ea12acfb68165ca8c10b2f470ab63de30019c35155c0d05254bb1388","metro-cache/ef/12578335a7b3cb8df2f44a5a94dd990fa10a2036d09032a94a18f5a7f4f79cbacd7e1f","metro-cache/44/5c5383e7e8472885e5596e4f1a14572800bb7879fa0bdc2de6f34d95b74da6b0ad783b","metro-cache/13/4733250d13ba1f604d7ef752d78eca6a41ee904b2a7c5fec4502618f32b6974e290759","metro-cache/06/cfe70002179f4439965eaf9ef0d365ef2c66cdd0e07a7340d15eb796f7851ccb8821ad","metro-cache/69/cd1c67689a201fccf683928429ec8416d85fdf213df664f20ac9f46aa66e52f8db021c","metro-cache/36/0d0b8da92d32b7e37eef0803764cc68e97ce4830ac41fd29bacedfe559ba02f04eb2e3","metro-cache/93/336a6639c865c739e49c841d83cfa7e3306ee5aad5702d7fe24f87e263c0007f3659b2","metro-cache/de/8268c771c4c7a38a75289064a350d94bff734b90ddeb11297794ffc5e6baf554c4fde4","metro-cache/fc/ff5c79f92e3a9a8d6161f1fa98c1282e324ec6c2d91846b8559c60f4eaf01d529dd65c","metro-cache/7e/7ae6f92dd5c823c40a60f2cf74acba181e883607402fcb239591befec9456c0eba67a8","metro-cache/10/38a655761c866ca2ec3f88f13a53afb6e7832d87cf1c4749f7f76511c3e37ca7c7abe2","metro-cache/e3/30f04cfbeb67ab18070ca9010200a0d3159daed83a76c792b18863c864227ac5831d1a","metro-cache/2b/0bbe1a4b63e4e49aafb4d1a2235eb92751473ba7f506f88dce227ee1ab8b8e5522dd42","metro-cache/53/9520c9f3bc1265a6544dac2888b31cd6f8de36095337c8625e817dc8698da51afce19c","metro-cache/04/d03eda2ad4d24438a614f06dec70a15024650b55339d578a9e143dc40d238a38b6151a","metro-cache/42/47a1b6e2dce1f1ababaccae5c64e77a5890812939d4f2ab3c488126bb425492aa701a1","metro-cache/c4/23f5878325c84c13dc7d4497053ba5088bf9c2a0e586eb193d8b7e560e4179c176a8a6","metro-cache/ee/db1c8c193ae5b2920df3296a28365b22dd86ea81f489c762e2e542abe74db42ff7bb4e","metro-cache/2b/65598131dca20de82d86ffbac061970c9bd79111dc779d691af6ac81f18002fe2821aa","metro-cache/1f/068e77f0c9a6db748af65784f8159219910ec7e34707b54473072c502a9967fce2a6de","metro-cache/f0/c5077122244c2e921a0df34ccf66e8f86efbf29a65d33a160d12a7be6c7180f67f4a71","metro-cache/49/13ed036566bb378c884c8b8dc6650aefaefba90062f5b173f2241ae91a964874cdd0e2","metro-cache/7d/352ef163884de676de27bbb8a926c36232bbf561e3ea77c8d463784d87c6fc2575cd0f","metro-cache/99/45deac5d9b804f786b776487d687812ad80386de80536ed276a8417274b859aa0f2c62","metro-cache/7d/84d6606e6e55ac91170d78368ecf3af5a3feeacecbe13da659c7f596affaa8daaef1dd","metro-cache/3f/c32a7475263e10664803c210614a431b0eea8f4eff0e3d5324991fae782f4d4d9f812f","metro-cache/a8/dfc2c05ce871f0258911dad99429122cb3fc117fd17877f0eaa37f357d9769df610d10","metro-cache/7a/524dbc6f8092eaa7ec9ca164f6510a83554f61d40ffb7fb55e628eceef6c908bd505d2","metro-cache/a7/c2b20012359ae302afbf535fc37accb00e0223154d1df01481d7707d8a8ef1040867bb","metro-cache/4c/3b6e4aa48f599680e17cf870a00acf580f8d407f9f4b8c3d6fb723e91de216174df5e6","metro-cache/a5/4904548be69a3d133e803ae451a796c3122d1a428587bfc6e37caa2b6b5be76376cbb8","metro-cache/b0/f220c966fe4958e23b90bc55dd69abde6f4761937f4692723ffd92250160412dde4950","metro-cache/e5/7b7a76dfa1791c9487597a23756d0d3cbda9dbaf515b5a789742966c8f65b8800a0104","metro-cache/f6/41624fcf7f20fb5f37c470191cf08aeb68c5379d0c17d9bf7f33a2ffc9299b8ca5547e","metro-cache/fa/f8e9f30fb2103b431f75470c0724c5cebe3cb22f8fe09325f5f3754720f9e130b8f2ec","metro-cache/80/1376a4cc093dcbc07c3200231f9a1ee923a4a5e209940e2639afc972c016477d8d8d1c","metro-cache/ff/c6daa4e32f8312bcf295b9dc4f30ce0083351a734fccf8547696adf6cf5fae9069cf90","metro-cache/05/1ab62287ef1b12d0d3952f56f1523a08405595c0703f7b910ce5ace252d76ea9fc79f7","metro-cache/91/c432cb35c65945949d7eecd1807d121bf6928219fd319c079f03f3ca01eece4e851878","metro-cache/13/9350e2e85749c22d0176847b05a4f8699e9f3f36392a9cc435c724e407ac90c950f19c","metro-cache/85/24648f529f837119904e78be300294d0eae72dfc79097861eff7c0187d8b4210545f1b","metro-cache/0a/98e75bc84fbaa3754ecc96dfe7e7e5ed165eeb4387e28369a266f3fc8d48cf71554749","metro-cache/85/50af35fb6fbb3bbea5b6ac46290e04165a18c7ea74e45b63613191b196928556d44b44","metro-cache/4a/7809b2467654487e09719ba68fd195a2a38608cc1e3be03f9f4d827d60693974ca54f2","metro-cache/69/36c52b9476fb6f94a3532bef3842ba1b51cbeb1ea790e6af206b075097a2e7c109983d","metro-cache/a9/27a11a91dac6909686abaff09f41b6b82edbdd10dadf2aa3c831c6e35c52c637526587","metro-cache/2a/b3c5995c887fbeaab0d7228411ed7d10af9c4a6581fe1f6cf3b011488702f8170349fa","metro-cache/4c/fbf50d5d3457d04494db707b960c9bc8a99c2afe89a087f8b3fa3e1b3a2c0a5c718d1b","metro-cache/17/09573aac011884960fffd0ad5165a4c829244a8a627d9ef13ce45757dd87adf8566848","metro-cache/34/d552525a8ce3daddda1b5ac8c5dc0d3101694b3c964fbc336973571a5cd837516c2dfa","metro-cache/a7/868b8985a4b4b0e67de3cc6c2f0306f3005cd6762bf76a161e119624ce5135c43a1a9f","metro-cache/9f/f655837180a15145eaad204ee4987b3828fffb20f2a5cfbf84a593d2dfe16ffbc8a4bc","metro-cache/b9/164d01f720cfb9da0ee95ef9c6dee473bc66df954dab6cee0cda026fd29aad7f59ad9c","metro-cache/63/8cb500b2bd0462ad82d2c6c91a9b894c54bb10af2e9781a2cd76e1a82fbc9f2c65b259","metro-cache/b4/e18307e5d370374fbada9ca2d7e8a60f44f363379bb12f29b7fd9e49f0cb1daa76195e","metro-cache/64/840bd46b2349ce808ca4a57f82a09384a6f17d8bd293cc6cc41209094e3d45e938893b","metro-cache/06/51782855b7dcf86a16a4a22fa98d00c47cf489a5628721aef42b7385d109dd1d7888d4","metro-cache/11/1d0186032d553ef4da6bfeb0469a4e5070ab64cc765280af4df697ca55e1dc6480c90e","metro-cache/fa/da565c9d33aa63260eca2ab706c23eb12183260b005dbc46925e05f273831b29b35527","metro-cache/9c/55ee71600d3e542778f0a01d3f4b08a0d87c2dab07f5c07c3d919a93d4aa8068dea2ad","metro-cache/40/be491d1166e79f186dadf8ae9ef538b4efa6d46a6684d6e887033334e86c50a05308f9","metro-cache/aa/7e8e8e67a5ad551137ebaedccd4073db299ba942f6a1758f562010b41a13fe118a06dd","metro-cache/32/e4c8d51cb9a45d25b71c993a0303bd221ddb3cd27025d27aaf4c827e4dfc4c05bba85f","metro-cache/c3/ab6225bfcd68fb09b1eb62ba603712f812afbc2e8be71b79b8defc33921086470b4d69","metro-cache/69/04598cf535da24c37024f297913db654eb37480fae703a90415cf52a01e8ac2118bb59","metro-cache/a4/e1e1be337b0add8d2ce5d377466241255fc057557d90a58360e379db9628728d3ab787","metro-cache/9b/ac7409707ea0b5f48d37567d0df50bfa5bad04776843481c55fd88c572718134304374","metro-cache/b5/afc07444f1792092a3e151c71b2300e3ce593d38ca74ebe98180c5ae31352e5c3445ca","metro-cache/1c/cbecc73cd90b3a597ee0c9ef908aa0740dfda6afba0c915c41eb4ad84464d43035b58d","metro-cache/bc/09e4105db02506eab7b0dee6220f1b243cddb2bf3ea24f1b0947791e8cffa80294c10b","metro-cache/85/2df9ca5a624dea40cd3f2ff3f42ee268774f6a507a5b264a1aae19dd4eb295d5685880","metro-cache/3a/dc95846a2beb773dd36aade8ba99acbecb3886422e59fee8a8806ee9195f3b6b27defd","metro-cache/7e/be1026d9045c547b41a51a35f8219e0f98a94cf4cd075aec6451065029201f4dde4519","metro-cache/e5/7c80970d0f484f0c9b4435bceec85e81271c5e9d8e276a40aa9034d26591c619e7cefb","metro-cache/5d/886c90adc50003dc177f25e291f50fc643bd898f028a09719d450bd89722bc8c10332b","metro-cache/1b/7d1956e76bf679b2d23ef61a544352d3a5d4bfbae67200daeb9417d61a4d0b8677041a","metro-cache/60/abc57f04f0ad710140c1eaaef689a702720ff1c5172ed8e19522e87d85334b7444f749","metro-cache/27/cc8a77e29916f22ad095688f16adc536399ccf4ac852b38505be379f69a30ae9b66d9b","metro-cache/d0/1209c34066d6b7ac7415a4ee31401d75a9a193648d5ed53042528db08f289b1535de46","metro-cache/9d/4ce039c91e5d3964fb0bc7fa4f1b1abc439039967ada128b5c7cfc4eb3d14a4ec136ba","metro-cache/db/e4a52e2dc5e79d5fb399fb109dac50b52862c8f466e2b572a69b6caf0003d5eb27f64c","metro-cache/ea/d7becd973a162ff25fb7f52fcd2a243a8ccd91e4aa939a07786b29565f84a7ad000d61","metro-cache/c6/7c4954c355a22af6d50884caf80d1c1f3a9311637c8b5a942c27ace3d6aa75350f3249","metro-cache/72/a4df689da093154e80cad8c253dc7864d2efd8e5c1d8f7eb9f12c52b20f17b22c01d61","metro-cache/8f/8997d9182d300187a7b9752131c7fcc5e43341932829d8ae52a3ddfe05d680f48098f5","metro-cache/8c/85aebabfecf3833da0180418b260a6bb2196be0ca6209ce238cc38cc511971397561d2","metro-cache/c3/9e7bd2bea57d767661742760645d65ff9bf7af612ae6b929dde5a7a8f529f772fb654e","metro-cache/3f/dafd3958aab41f056a5d564368db1add4b73c302a7f6bfd34675cb2b2f0a599e78e132","metro-cache/be/396fb9d3c53f6a79787dad65bcc282a9c580ed52cd9d6fd031d3eab19d23f617bc3d9d","metro-cache/6b/f838d9eb5a1a367742463927545c2730d5c04b22013f8313cef4c8d850e5050f334d21","metro-cache/db/46baa216b3a05bc63648f971a68819a0e7ea46e25c7a1eeab14644cba8963a71db6e33","metro-cache/cb/483d4283f499950bd6143e38fcca06677d3a751c95ec23b21de787e44f1cb457df2f17","metro-cache/da/65332bd7f9870816c84dc52b882330c8783c1696a8009d4fc2805f4315fa090b7ab1d7","metro-cache/cf/938f46cd1c5b219547f432f2bd8d55d9b886175e2fb78d93f00b85856eb6ce0c1ace23","metro-cache/ac/35623f59afda7fa09d30b4d8fb31822025f7c92de7a60804f800739ca1887db5a22ab5","metro-cache/57/d4a0a527731ed59c01dad3b6e9a3c0c87b68e70546467fe1cd50db44be0c4cbada0591","metro-cache/08/7c003ac9956236e4a580f2765ed4f0a83a56c9d15c7670e0b13c17813a62ba050fd698","metro-cache/40/def0d149ca1a6a1818104a7920bef2456d93307acc56836955b7b965613f1b7089b5b6","metro-cache/fe/aeb81ada998f128472d4edf53092777adac681ced3f4fa01e2d55ac6f7b6dd28be52a5","metro-cache/32/228acad92eeee3e38ea346ea5d1f16904084ac9067a13e0bf60a1b061084f2dc62ee61","metro-cache/02/920653eca394105438238002befb962b0673ff4e8700d5f7b2f33e9b4ed5b6cc071e96","metro-cache/a6/46c14e9bfe7c1ea38b8f2c5b8b3b62c53899c06bde304f16867a2e9baaafeb66a59a82","metro-cache/63/79cbcd0f99ff0ee82cee785387aacd457bc43a23c8f86ea780c0a6dd3724e0a556b4d2","metro-cache/82/465af39ee6fa19ccc252c2973bc0e7ff6869a23b20ffc398165e7f03f8c7641387682a","metro-cache/a0/07ef7ccf5ef39f1ba6086997fe4887e06a530c944dc6c693c1c1d8278e68ade5a4fe70","metro-cache/5b/2244f09d3fee8f3ebf634542274b13637d473ae1454f54433dc8abda758483a97b4aa7","metro-cache/a2/fa1dc62ecaa1a7e6a1178c72d80ca6040078b3503543081030a7f44c9ca3d4107943f1","metro-cache/16/cfda696badb146b544603e6578796bc376d06b21a3b4bc9902fe9c9e241b67f8b269c8","metro-cache/01/5a957c7e1cf249f8dec1e730df599afa4295ad3ee0300de9925ef2d9944f789becb27a","metro-cache/3b/16bf997552e4a983ff0d9e0b1df7d808396e7ed4dd42afbdd6fc10023258377c1c73a0","metro-cache/23/72c1204754c0619d2392c5138773e5e987c126a0f77d5d4772aebc7c2728b8bf765b5f","metro-cache/b4/55e645f623291290abe7b15a107006851487c51cad4e0c36e89923c918fbb35723ed3b","metro-cache/be/3c0f9a9310d6d1fb5ae2346d96f782521b7339d8877d38e33c051815f995a933d8a83e","metro-cache/6e/cab366ad99272bd5173fcdd7529ec472ff4ecd9cf55b2809c6e2d57f307c89f8ebe677","metro-cache/7b/37ca30af8b8a409c943bd8719999d1d0043dc9e27b5ded651b539e8ec10e84edca0f17","metro-cache/e4/e5d8e41b506e289b2d4ad8854eba2e3c4961516891d9546f3d211190c03ecd88554487","metro-cache/f6/70ce768c68969cd2778e00a13fc14b62593f2760f9abe554b54a3449db69a5e61d44e1","metro-cache/bc/521faebe2c4b740c13c05cc226b5f453e752a43b6c5d548e61ceb3d6e2ee6d6c7646c9","metro-cache/1c/22e06363aaf34f70f542d29d6a347d2bba9e73d1c975ae85f427d1b1c2c96ddb452d55","metro-cache/f9/6a832adc7ddcc97d251c63f9f6ce1f95c8e58b0114707288dce6a7185f9c212c829799","metro-cache/07/d84fc32a5bb4fa78057f43de28c12a647c76854762a4f2b106e0db436c0d6f8a9b1708","metro-cache/6e/47c5158a35b98e0968c2520b22ea152816924371fc637ee62ef973565d73c79c2d2273","metro-cache/c3/ef6b63130dd0b1d4341f1653111b6b09b51df6ca5dde1733176d26a218a5feae6ca78c","metro-cache/59/b911bcaa9179d94c37b79670ecf0781a210fc0cecd8196659de041ced584d6ea778b92","metro-cache/62/ece867394787cd27243bc93dc6269180383f329cc19765b1e9f9d44311642303c99bf5","metro-cache/2a/8084d938ac5fcc44be6fed0f2f95beaf4a520d2023005bacf37ca9e1e6bbce11a5053b","metro-cache/7b/8d18790e42b0b50b3725fbb0c556a47f40fefd6b93381e0cb166a5313d6db830a9dda9","metro-cache/60/f06cc7da424a3270876d6b9c2514befdbd2b068e5cd2f51ba029430f615b2f170daeef","metro-cache/29/192c61364f28ce9cdeefcb20ff294be60f029e2c8b51dae5c2cdde9038ab8de949f1fc","metro-cache/ee/84b72c23879d45fb44c897b81a1cbc8b5cb159865419e095a0665f8b42ff15c0ddd126","metro-cache/64/b58c3b9735fa456d8c6ce9ab1d783804cf1af4d8b933e86372b473eb47f57915afeef6","metro-cache/e5/30e0e02b1c3e2bf7542eb65caf77700b318899efee1d85dac8e749b60e9adcff68b125","metro-cache/53/c6590316a2513c27bbf3e64ae074378e92f030c21b83374176d19e15f2cea7089af580","metro-cache/6d/ee45ebdb30d15cc0ed8a5abd61af7bbaf998ebde5e548bb145b71a4c8ccdfae891d891","metro-cache/7f/9e15a23cfedf7373235462b144fcf5a050a254010022eac29d3e93213726ae30092139","metro-cache/7f/dae1da3128173cd749d313db6edb39003f2584befd83de4bf8bc1d2d7fd6c675760137","metro-cache/30/c869fb6bcec56dd22bff747545431208373f51db1e3269c929fc0050abb0c0e81a1b39","metro-cache/b3/fc529a34c76bce8669e35c846179963d741592497e0445ce0cd5c1368caf6b4f3eda00","metro-cache/73/88325170e99e8d04419d91ec842c2c5ecb829b1baa55399fe01081c14392ab0aa87ff3","metro-cache/0c/80c7f2ab0c20629798fa0142d13f191324ee147599b1026491bda70c44ce7f61fa0c0f","metro-cache/74/2390f0c2220d2f043e9b65ac92331342c0ba6e2f56c4e16264c8439ebc112ed9b2191a","metro-cache/64/4c1880fae5cc49ade711b87ccf095582ce371f29f2c704dc357db4065abef63a8d13da","metro-cache/0d/cb07ec100044fda3c55b26df2b11598fd5989ca7f7ee278e8e0f42a4fcdae4988e9d54","metro-cache/a8/41b100b85c60f29ba309f1be57dd57f959338ed364fbf601aab566b69abc337493cf47","metro-cache/56/22dcf139595780a3b1be01a48ef61590e0d49cc41f97ffdaaf57b22f9c9b8fe1fa9b97","metro-cache/e9/108adbfaa7f8fcff215e6e1990d5e56f0236a37a42a9f695c5342d2bd359b9e52d3e0d","metro-cache/6b/013254ee3e238fd96837b5eea7aa5af6ddc8819ae1f31047644d62ea89b0faab593086","metro-cache/83/610add0f0a487eec7241bb576545b873df16557e86deaedb9b4c8fbce8fd254ebabbc4","metro-cache/fa/37b39f1b6a72ea604b79ee9d533383d0227a336a033a5253b9b142fb118b332e46f2cc","metro-cache/00/45bcdaa7900c82f07d6258a42148f5b629471c256f57f2cf67e013ef79fd68a16b60bd","metro-cache/8f/c2b5a49e5cc8f04115bed030f0a5afb7fe715b874f4415540f5698d41dc6a737b87612","metro-cache/3f/5a56a1a52ea72267aced56addb9373c0ec087ae92d3e0a586e850341268f4be26cb03f","metro-cache/09/8905cd2df3a34209abb5a2802d45e0cf890c9ba9d3984889eef2ca68f9f4488922a08d","metro-cache/e2/e1b1c8a5a5bbf9cc7bed55e6b2c2703a669c5b30a729d3474494a7321623d7812900ce","metro-cache/be/cfbb88dad6f0e83666961175bd988f6a4e8f783d5d1664e67109c0984ee56f508a9afc","metro-cache/3b/976e212883cd4b23b69d23b0d96568a2e75b2b35819034e19ddeacdbf1fa6dac15dd2e","metro-cache/a3/b636ed6095e23566a855261b3ab44d920a864c7350ab1e85c857f497197ab38caf385e","metro-cache/96/bd4aa48c71622600867a3bf8e8c147c29b420b82488fad4248c0f58ad354d98032e17f","metro-cache/a8/0c2b295b48d4810f7ad34470a76cfb1f833dd1e6167e1d9f40a7462624e3f45db149f6","metro-cache/4d/bdedc5ac8d3cd33d09a639d3596a8331a5fdc5b1db9744efa15d2218b1f1dea85df0ff","metro-cache/0a/07b0ee9834ef802f76bcec25340dbb4214959766a637fac767a9109206453513c8d506","metro-cache/79/37a7c60d184efb2f13802669cbe2edfbfcd3d327acd3f4b2ab271c79639cf6ca4a4a84","metro-cache/86/81d797230278b81bf6ba35ead588326f5d30acabe2b24fa1a44fcb3746bcd6e0066f86","metro-cache/4e/a025b3e500b8dcee9d470ec6e10eea528794e303b683475957d038f422fad3e74f6f80","metro-cache/b6/b2168db8989303acd5b7d523c512054c700593145b19716c159bba200699a1801ec7b0","metro-cache/bb/6724c8b80351e558d24d49e4a8c34ac8659235d73e0915099d6db7072a9e515d1d4ad3","metro-cache/3e/29829ce68b233e76cfb990df353f4ec7cd4e8aad63afd5ece442a7d1cc5ae30671739d","metro-cache/71/28e49f9b2f238ce30edfcfccd176c3726bf078f3fa8f3bdfbc4bf8ba72d17cd8be8cc2","metro-cache/85/6f62dddc76240638fcf1b4865f7ac5034dc5a67164c407cdfa3112968ffa3ba8c761bc","metro-cache/86/b8e362e5f602f14cbae963f165b2bb0cebf401ca7c3ed4faccf50882948b69fcfd1c86","metro-cache/e8/740a4ace2e034a6e2ceccbfd2311a03185a75d951b5985f33e0420b0773e045abf6101","metro-cache/dd/42cd428713f66662f43ae675e8778f33a0077b599052c909d232cfa5fc4071f914324b","metro-cache/e9/c2bb4373a1a2bbe2f3e3a56ee66193b5025e0ce6350702f35d6e3343d9b605a94be3fe","metro-cache/4b/bc3043ad443b954c9bd2c9608ffe88688b2059b7f6dedac01168e461305b3558a981e1","metro-cache/43/259e0c1722db9e0b84f54532c1a6f19349d1dc2824667abb4128a7dd6b754169a6d2c4","metro-cache/eb/84b9d525379ee943bb0f1fdf10c8e1d130e0f21e65b6d029d0b166436ef1a49acf6f7b","metro-cache/b1/c9627c52ef49131bdf37e1e02339598c9f4d2c4c9bf460579346abb9b53edb901cdd91","metro-cache/f2/d5507f4753ed2b54486e32555e72ed283684dde22acf1cc7d1c133a670627c311fc5ac","metro-cache/69/71f7e3454d2a465eb1f0de59d624841474dcaead8abfeb715b2c18bf4c846eca082a65","metro-cache/c4/10ee30055d48b88676193b28bbdb4168d487c0ef88b7a8a682091fff6c2d32ff541095","metro-cache/60/5bb232a2026e2f6fc3281fe13372935626c98572bd4856ac847e6f959b1b2d46ee6b7d","metro-cache/a2/da42e6af16f859e31568bdfb5a3dfd85ddf62d7db05e2e552c32a877a79bf6acaf8c93","metro-cache/0d/cc27118309cb3abc52633a4426c89a68e1387673d6e9da65fdc7f69ae97122354f0a83","metro-cache/f1/300a839fc273034b252649591d589028b3aafc5860ceed08bf1f9b84399d17f032f01f","metro-cache/5a/64c24f21d8b462e49a4ea60e9c380aa11418adbae80ef2ab1907a545cc0ac1ce73a1a6","metro-cache/1a/14a3e4f47a7e36e7c40da264059fb2e9c6dc2d49f0ba99706af32442e4574c01d20534","metro-cache/28/590bd648bde7f24b8d725371b6b98fd9f6604f6aa50f754b0aefed83d3062970bcb4db","metro-cache/c2/d400dc8510496fccf6105f1afef85dc542beb89a61a047b8ec7c3ebfef3ac7181bde50","metro-cache/60/270f6b2d3bb9f3a69058586d947a709f7581b0aa72d7dc051179a5b02780611158c6c5","metro-cache/b8/67c08845c9bea4ae8e02115f4c147031f160300402d258af59880fbc030584a887e74d","metro-cache/26/81d6ef6f7a6b7de70af3060a1e6df0c70caf0229b308431d47bf5f27f81c37e14aeb4c","metro-cache/fc/f4dc86ea5c9afe42cb73ffcb4cbec2867957c642cae73ce3f3489b38f0318abaa41835","metro-cache/43/b2a88a57af3c07de9d48230cba77051e79ec99c7411f1eb3391e45d9ffe392227f771b","metro-cache/a6/6b3f67441b13a15d72a2d33905256e6c6785d6dcfd904f510938b4df1742f31538f6f9","metro-cache/77/a48c6eeee96809da267f0ccdf81066f08ba2e6b953680a6a5898a04858ff387c12529f","metro-cache/aa/0470cbf7409a2ef97eb145497f61d3ddac09ad31aeefd83a62ea3afb9d68e7ed5d4056","metro-cache/31/e175f510725637e5c93a5f5ccd7a096f9ac192fba966e50135f5a2873a739e942f9451","metro-cache/95/811c215ef2e702680eff4df87c8617347df4e3246fe231aaac70d6281326c9c400b1f0","metro-cache/b6/7994dee338a007cac1579586cbe1d6815449048328c95f015e5db64e4232013847b38d","metro-cache/27/30223810c824aafba40dafd90b4968a68c316cac9130405839b241b9cd25a6f7993764","metro-cache/3a/ade616160ae1f3ae7c8495fb512d4142cd6f1c21de3cebd11ded40b10cc6a151ece9cb","metro-cache/61/965f7eff007d639b3c44ffdd316096a160b4fa06de5e1725ea538e601a03064d8295d0","metro-cache/4d/8609357d36f4df7b52007541fc648b31e8acc207d8123c670afcb0ed3b36da05929bcc","metro-cache/3f/3a5e0e3183bf26cb8e669cc59e1147c0e3c77bd8d57016343edd9ef5f5b11bea3e2800","metro-cache/a2/8be4f125d27f22666c19df4fbe4a261f0fcfd0513552c30ab5a2a6aca19d0606faa508","metro-cache/15/7472b25f64a8170b94f89152da0d5b0c83206845c3c354863eb6051f0fb7b4a5fd9409","metro-cache/24/9d5645380ad1a4af63902137e3d3d4ebf14af8d19c48f52a4397212124f4245664cab7","metro-cache/1f/97202822b4de0b25fa5ca79b3146f3f5709b48727558bea4e952ad811dc7a5a7060be4","metro-cache/a4/b654368ade29eac437b10665cddb05226cc7ecfd3cd6351090275e26642965504453eb","metro-cache/2d/e908138d8d3c73abe93f2a9f0e29abd95327556d4a811cf5da499dd8ef6e37ffcd9e63","metro-cache/e4/ea945a7a49b1f68f76b5dc5b6d74902f2ef54edb3ea87bae1247dad2e799ce91e8b220","metro-cache/9a/c1cdedeb0687082cebc907e48dd21b31d4596cf2287fdaa07d9f34f4638be065c58b38","metro-cache/d1/aa9e0aa07d7b310ff8c1e0edc713af5c956a47078927e3fc44bf0c62540f74fe1e3a09","metro-cache/ba/bf1c808c7ee9e5c44c0343ccf5772afacc0140cda5abcc4c60afccdca477db988a83d0","metro-cache/c4/b5b0fa6a278f32de08a76c410c1730c8eecb401fb98444e1aff71857997bfb926acff2","metro-cache/c8/43876ab3ac2aeaceb8aebdd61bf3f8c6b0f17e711f16dd128a547a6467efaca01b7671","metro-cache/64/c8b6573981e7b7ce1a9dc47909aa564bb5d2d2475adfa4f07af51a53ba504bf0739b25","metro-cache/ce/0fdfc20c5810bfdc68480c2ba514da7319a2366791a14d246f81535aa77ccb380610fb","metro-cache/42/d0d67fd6021c641bb17de25a8db7e7d3c6874ad1bede835f57970aaaf571d90952d250","metro-cache/cf/f78ed5b8de31c6c6bb784315595513360481c523c477ad193cc6b2cee16453c6562a52","metro-cache/1b/d36765d5c78cca96dc0337150688702c740f065f5aadaf9e10ab11490e673c823e450b","metro-cache/d6/b9906da4eaf7573174de65021c0aac7c6eec3c4ffbb2d9e731db77dd6b7a2494b3574d","metro-cache/08/429e6f32bf5e77ae41d0764a5d0158aa10342fb84afce46682cb47c4c45c4a28a50331","metro-cache/64/29c557909a3893ee9b9837695667e1cea4c0856f8ace59430f5d16e6e993a515123226","metro-cache/22/d4cd2067bd31069f238ec3ef334cdd83bc73ea3ed3ae99bb3369441b0a0944549585fb","metro-cache/26/98fc694ad7f40ef1ab79f73a4ff7596422ccbbc13cc76d4687dd07e3c120c237602298","metro-cache/ba/0bdf4872c26a5a4d14b8da329ed44541f5e0632a41eeea47e984ff9c03c2fe5146ded5","metro-cache/ae/6c0f04a79c4d934426faeb45ca306f7c545b70c84d5c27a1555c9f24d52e41ca12bd82","metro-cache/64/574bb65fa7e96746ae54401f843028a2d65efcbff7bf216c712a533e3fbef24d1e68b8","metro-cache/8b/d11912989c4fb6227d79bce1ac46a31d6ad0fcbb8dbbf6d551e64718faf746b840be79","metro-cache/a0/2eb4ced7e9628c2ce10b35beff94b972a7427e9cf077c9e5f28027bdcea5748b81e4d1","metro-cache/9c/3ee9031a063ece8b1341d563051c4ad26de03b5a1dcd038679ff465ddbd50d410e7b06","metro-cache/1d/31a2ee09bb8a09b4645f2163bbcca180f0a71bb6ffa9a9166eb2e86c46993a303709e8","metro-cache/a2/efec0c06166b912991fdc4c17d88ed4675541293a2139836b94c17e11b44be3c26c22a","metro-cache/23/fd07d87f203a82ff46250c01a37a42c066258b988c40e7b30a5f885679f1ce32692209","metro-cache/88/b27fee12404a93531793d220b84038b558975948fdf6b2a33959f90b5923920e0ad8d3","metro-cache/6d/d961158b0d14c7cad88215fc58fedf8efe4ef33fe9559f3dc61b417faa6a4f7ac1a0a2","metro-cache/df/a12f14073032b35efd1dbef80075ae49f0915d130526827dab9767c03cd7d29424993a","metro-cache/40/defe18dd131ae10c28779b4833b6622fac98efa2edaf9f209344880314df692214a241","metro-cache/b5/45e30ba9450bfe09ba228bd54bfd659fe3e80fab6f82d019af0cfc4cc520a835e09999","metro-cache/da/449ec3bf022987132927da9bb3bf832a3c55d5566bcc4ea5c6b9bded3bd863d8334a07","metro-cache/4b/fd75c5536c898415e596caeb0e8082fc46cb664e316f82f24d35711c3ae76779681248","metro-cache/0a/bea750608a1eb7e32cb792ee86e02380bd6aa323ebf3d35d7ed333f7e209c7e554fda4","metro-cache/f8/106c13d1664ae60b00ea82f83e52760505c33fa4a84204b93b9333ce530b45bd683524","metro-cache/ff/c4bb7a36baaf57375bd0bdce5ae7f9975e6796e04cd77eee858664d3fd7585d5fae657","metro-cache/bf/e13c0e0297a4f8172daa4103aa35038c071da10e8fbfdd9f8322946973b9e286b260f7","metro-cache/62/c3b872bc57fd8aba3ac178d89b006693a9e6be7d94658fafe0dbf644fa914f520426ae","metro-cache/88/a3863a562f0b7dbe847a67474e906df4128b5465cfe6016e71b8d8223e20008940f530","metro-cache/a5/d996cb0037b676b7829e3d1c03596193a9e6be7d94658fafe0dbf644fa914f520426ae","metro-cache/97/cd0b99011585a13c79a1a4c1827af7ca6203a185de9d9c2ac8737e99bc18e826a6ee33","metro-cache/b3/72dea7229ee996cbcbd2bce22509fac044a8b67e401bb41c4a29430f8d5ccb4e427a7e","metro-cache/f8/448e539144e6db5e1257a726f0fae0a1237632034b9d03c35a8e3553d326777cfbb69b","metro-cache/31/bdac4d815c2d14fffe0dc7b5c7a05eb9bae776f5b2b7f4b125a1884685293dff5d2e60","metro-cache/6f/f07f8f002737a2b3a20b4820155f2c90ff2bcc366a4959b32d989ec2855d1770e98995","metro-cache/fc/28fa3a919ee5875d91736184654a94cddbd1c69b5441db994a1ca068d4667be9b6199e","metro-cache/04/7942ea6dc5cf4a6be42e13c2981772d791b697d813d104562825837af75c995c75058c","metro-cache/54/5180ec9e6ab606ab9b262512c85928752c2b53ba1f31f966b53e3b63e20ee39749f61d","metro-cache/56/06cda8d522369569ffbbb36b9cc39ea22f14264994a4f2c7d7150c92c35f4518f96779","metro-cache/28/aa5212de457274e037a71ddbef99b44134931e5dd2b90a2e845fe221f2ab517d6d7631","metro-cache/ee/4a8c69d3534a5af0b007c8d9994dda127264a08fc61f2e6c3d9b62a28f82541b178aee","metro-cache/92/be48d3414e1f56cd77d8ccde2c951c9f791a29cab924d311d2163e2c99a825cf2931c5","metro-cache/eb/3fd080053449dccd53b61e168dd66e13e854b021150d048b9f8bc137807adeae6f0242","metro-cache/2c/9bd1d6b73efc1e0fd6463a42e4a8ecb3da9b31e7fb1f7c4325491b19ff4f4d87249068","metro-cache/b5/2efafa76a8c12765df937a6b47fcf2646b3e1285181ba456407f3e2983e0322d5fb5ce","metro-cache/57/1f02a8e5b86208b0ebff8e800d4c1ea9b23b1a983dfb3e77faea291f6773967b5fc19e","metro-cache/39/a18e8e647677da01c6a8f687ca35f02b1a9c5327c4c1e03e74546bb95a6b350ab49933","metro-cache/2c/b745ef776ac99e656babd9a04f38a2fa1c4e5bc81affed2f6d218896b89b6b83390214","metro-cache/83/d91975fac56693f9beea48cba4975e951609c263421fc5807d7fe6b15e07c29526e7ba","metro-cache/c9/188270e20ebc9110e9fbd69bb306444f7fb6c640790311b4d0f3b3f7f8c5de6326c2ab","metro-cache/ac/aee484d2ae9d7a0d622456d8c8dd1a5bc2943e51eaa43748f0a662c664d783100c171c","metro-cache/e3/0a3253d5eb990f438446d9646fa8f2816e603c5bae95b1ff069dad4d5f2658b8a1395b","metro-cache/bb/f650fefab96bbb23c0afa7df2019e40d43cb7089175bcb6764a2e56d717730103685d5","metro-cache/74/bc7cabf174a241bc16f95f3255a536057136e2544fd3105e5812e8b2fd0ff697bda664","metro-cache/76/fcd8d815ea2fcf81ecbf7e51678ebef57e8ec707e93735dae8fa5b53ebbe99b02a23d5","metro-cache/81/d5251a29a9fac6abeb5d2cf7d56a4df69e8a5aa74ad16aa803f1195b031ab326809d6b","metro-cache/c9/758add3d9abdc52b1d77dacad9be64960114096b7fb1966c02f856d72a5026671e8ef3","metro-cache/65/f294b16d9fa45864be005aea0cfa1e462c82e8f7a68c5b9c98aab9531f7030f283bd52","metro-cache/6e/62dce4bf4f472763338092b9abf6c0a60363147c7e92c992dbe80dd87e44a69a22b3a9","metro-cache/62/64fd561514fbeca4f8e5d9155fc5752e11a0e239a2607477da4696b3f8cf23c8e289c6","metro-cache/c6/bbc49a326ffdce102b4820a098000f75946d772baeb622633b17ba1ac36ae6a29242d5","metro-cache/bf/a3699b748f7df3cd6fe3ddc5c6924cc32a039448cef8639cc0b7cc676ad9016e89e3c1","metro-cache/a6/8afc098d0c59cd9d9ef1a642f57aa51add1083d55d20be4518b7a15feec7b196ea4a5d","metro-cache/ab/057b5c111708921d48bee194b6e2fe2be6e38e91b7a7905e047c9eab77068068111631","metro-cache/5f/7345f5ec2d3b8a54e47023095110748c64880a401ee75f43030c29ab84269243a55220","metro-cache/f7/8d7e7fdf001ab0ac6f8d436041b55d2bb05a10bc06181adfd499063ff910e3ea0d30ee","metro-cache/ac/dce5bf4303a2f009112e8cc23fcf9fcf3d45da95e9650df68bd214e0bc96b795b89a0e","metro-cache/45/5d20e8d0284673b83e6517545b2b036fb34d5d9551dc383d284080cbe1f952c880c582","metro-cache/87/2b7830f3b0b27f4d125e3b9ee826f28f4a2471569fcd215a60bfe92b3f9d7d8f5f7a90","metro-cache/59/082f4c8bd4daefcea322ca143f932bb35b054afdc1f95b01445050b25b4e1c9d7db0c0","metro-cache/ec/c5cae4b6b7d3215a35cfd36db275ac0533765efaf7feedd75a41724ffcfa7b605ab806","metro-cache/f9/8bc1281642058b6f59fb226f992738985031bea33846609ac9b809a378d96a3522028e","metro-cache/25/3defdedf665b0a83972b7acae7fc5b1de6a4bdd133ee36a193df6d6abab2e775506c24","metro-cache/6a/e4330fe172518bc7703a641229ea60d6d39f178aa147438c813447096cdd6d9d32e79f","metro-cache/c1/31b5dd8bce168a8a904e5861bec5aa67b4ce303694d04cc7348aa74bd6f168f8d76c12","metro-cache/47/f9da122d43e6855346e3072e1071ea36bc035d46b9f74858b47d36f41c2ee0354067f0","metro-cache/1e/15062892b1f592576a58e853b4d7010f7c18c8073557a43a0fbc077fa2e33a746030af","metro-cache/6a/dcde868663ef613cdd231cf16bd1904d7d60c55e866f095904cd78babf2909c36e5a96","metro-cache/c5/085c79388c332b3cbe1866da743b1f77bea4c09e91381c11d0097e9e585b703ff77864","metro-cache/39/ee61c415e5c32cb9ac5caf7e65419fdfb8734796f0d83e72eafa832d8ad381bca691c8","metro-cache/c8/d2493284539c14970427dbd13ec1e2b337a203fc06af1e1c434e9266209dd6b54e270b","metro-cache/59/82c4133864b7ca55e81bd53c5b5e373ada5afad7ab8ba91956a01ff4099b967e781415","metro-cache/fb/aef87b7f2387a6b18572c6a213b3c11be07e4e0e7c7765a45a278b36582cb0e53cc98f","metro-cache/f3/cdaf9f25ef49a789cf513d86048734f47bd88e781803a3565c7e4f8565e3a576899501","metro-cache/1e/fa37d275d1d9f50d307009d5cd8a5c23e73cc6ca9cda339774d24aa27d2d91e133a45b","metro-cache/9e/2c6a5a9348898e8d99e77c582bd1103e5fa8d3a7b555e3cc965169d0e25fd07f1038a0","metro-cache/19/1ac60e3e3d3e9c25d94f637607243e3ae95d263725f81ab50eab9efa69941b597701a1","metro-cache/be/d56655f9dd0d4ed873c9925849cd4d577b87044c60b580e7e0698e6d850b6adf6af7b4","metro-cache/93/42a41b7a99e41be545fdc2f2dc485ca52dd342a549d58a989c5e6b6fabece49bfafff9","metro-cache/a2/63697ee463ae8657fb02a1f16c3ca33e5f21814fb5570947a1a602a6856fdefb0352b2","metro-cache/4f/a11ad79b8b92e3683cda6a58136b5d57ee4a807ed9de1d73ee6f4af29e8ade2bd95658","metro-cache/89/b4e95f97009586c8d3d115089c443f0e2dbc42473871652b96a067138ae060bc3f9b74","metro-cache/9d/8ebff7626246bcd8ec210d59e5eccd71872838611c8d1b416d2a75028e46f84b2ae2ef","metro-cache/a5/32588e9624f9c83e2420306eeeef34eea3dc6d53e480ca732a8aad08b485898fc0a8c7","metro-cache/98/75f3380337d61c29dd2ccf69563bff51f0c1fc422758e4b18e15d2563a71d5d24e9f63","metro-cache/db/90d6c40fcc7f1de3adf73e6399b78614b03b442c343e235d534ee05857e3c904bea88e","metro-cache/c8/16d243f49f56cd49f2b93cde194af431ff9047091ec22a2d36b653b4ae5cbe40e87092","metro-cache/0e/62a0e5a1ee324e6d4cae103f29c9c3a345cd4485305cc21a5261b078abc1e90848d879","metro-cache/8b/7828fcadaddf87658adcafeb391d8ec2ab3d8597f657d3e7f8e18f7e32edfa96c9f31f","metro-cache/db/53df330b6a3d028f4974d015fa41ebc9a539e32697fdeab1b5411b527c5068bbe3c17b","metro-cache/29/6985f9698073abd12daf2bf7766f5950ea5d5f717d8a66fda4d92cb980a11d1cc95ad9","metro-cache/34/8f66ad583ad310fc7500549e683f8ad187fc8f42ce2e83f1cd27115e85eb02cc102669","metro-cache/2f/9274187bf4e44ac54a194498428bee53ef622b5f883fd15d78720e3c6aaabd971a5b32","metro-cache/fc/3b8205c8aeef08bfcbd508136083628bab11ee58b7e4495e2f816688f957b7125ba622","metro-cache/47/a976cf20ca4640022b04281bbf426ab92f48000ef25256fe8a76d9898500d4d818949a","metro-cache/8c/2bd4a3595d2ae79653271873b8640d631d905c18f8ec90c23dda0719743ddc16f52335","metro-cache/06/ef5b6674a2395cfbc7de0b87b2383efed57f345864e1301fac35764a655737f1829a72","metro-cache/12/4931bbd26b5b0341c9c576e830c59ab2c2fc3938799319e186522625b14e8dcb2e5198","metro-cache/21/74a7aa45b07881e6d39429f80b01e92868c8ad0ee4e736104a74a2f7ed372687369b09","metro-cache/9d/f4a67b1ca08052cbc204ab4b04adf8e5cfff0b63c530bd2d240d7669dde9aafde0b313","metro-cache/31/49d1237fb0f7598ac8b747047bafd312f0e3d172dce13768c8c3a52079c1d4a19e6580","metro-cache/ed/41c6bf29642e26d5cee73a2de79505e46922fd5166a572d288badf80c7c6912d16eb50","metro-cache/f6/ebea86c97c1f1c9ddc1b49a3da0f630e7570f93ce111a041ceb7317fa6911d8a31ac6d","metro-cache/91/ded6e53ef4240f7d9b3f9725575927edd5d0aeb006abeeb0ad65939d419bc7a5c91231","metro-cache/b4/d626c3f37ca72cc9c6d56eef55aef2b3530e603f6a08c096eeadc7c9444395fc4fadf5","metro-cache/3b/34db96d175c20e2fe0a8eb0f1d7b50777ad5855cafc4df70c832fc1d262403faff0e7f","metro-cache/52/9cad2402b9023ee8ab0c171f7f43b3933ff2a5909ca5c0188c3ffb22aee19a5d437b74","metro-cache/45/5db6636c33a5efd42277794b537898b27f76f735a3f4141b0aad38829430b3b1493a7d","metro-cache/c0/b3500d499fe21ef61e0c824a5385da19a68ac451cb57b89bec41715caa4e1df239a121","metro-cache/18/4cfcc366bce6f848564a6656013b4cde00b3dedfef8198feeeb9fbe51a81b879fbcd7a","metro-cache/f0/daebc9b262ed68769b5add7089a20e46145e3e04ce7f94c30307d93312b8f28f86ab4e","metro-cache/3b/a330ebacac9daf4cef320a592cd5fc2d34a0e22ebc74e80b389ed868a0e2a846ad99c9","metro-cache/8a/aa7a62ffbc6a3f25483617123786df7bcbc71da9c04c9aa6efe881dfaf2b9efa4dc991","metro-cache/85/8b8f46f9009f6187655139531e427879c2c3d4a0c007fc5be27df61eadea0ca80c064d","metro-cache/5a/5fead52a6844a7b87ac0f3a268165ae09d1c7363354b46be39d8d48ec0b5d78a8331fa","metro-cache/6c/1a8f47c5577c060e2827db628d8df3629c006f2e6a6271990b1667894e994174538f2d","metro-cache/0f/c7eb3ba8fd744c25a40c551d2f06a8c62018d16d9100e2cc2cdb25b3426e2ef8677578","metro-cache/c9/2a220883b5812d1a918f691c081f84d301543ff615ffb5c47a5997ac8d2687de9617ba","metro-cache/ce/f4027c09c43865cbccb85264f7edecff12082d6b7cfc77ae8685909430c14486561e70","metro-cache/85/969283187d4c085c92f3d8d9cf5705b775d25bfdb59c599829c02ac17b4fe82cd8d028","metro-cache/65/9cfcbe3f6ca7d5019d93b8a7e57ff5badd89799db7d567f981842c841160a45f00e687","metro-cache/22/e3ab76945a675c9e5887aaac5864a71c2509083f83f04ef8ae25a8498bb373bc1ee4fb","metro-cache/d5/4daa6197045f6d5a0b5d2853cd999e0941fa091c39bf106e13f8544c6812e61d6fd9dc","metro-cache/a0/276ec6a8f92b68d17751c766d1f542a4643db72d0578384427c6e8d35fe88bb131a056","metro-cache/e9/55a0c77a270017e4e76138405c4617f61d528b872e90ccfc815654e4fa202f6624c778","metro-cache/1e/9ba1b3873bef11aa6ab3f9339673ada5d2e2a920d8d0af8077224a15e43d31162b6bf4","metro-cache/1d/c88ddda1d0a8e049837c5696030c8c9aa44d0e6ca9012641f2ca717a4d27309563990a","metro-cache/cf/104ae6c1359cb32f9da333671b6b0b4f8e5d6f8a4470da2dcf008eab61d63873f12a66","metro-cache/21/85e214f0c18836a6ecc6253f1ab78caafdde0957672c4ca10c79b0b6ad67bc3c79b94c","metro-cache/4a/ff909c6502b92548247005d2547e4d9cde3179c0ea5b9b99cdc1555a9853642cb78855","metro-cache/cb/0d2574033b8b20f78ab47e06ec9477c5ee38229ab265cee9553a130a77717f9a72113b","metro-cache/38/dbcdba77edcc5408e2f0f5fc9769433ae88ede10622eb599566d9fdb37722e41738361","metro-cache/f6/2b31b3b844b32e494f15cac35250769fda832c06e05674ce66fc13dbf0f22cef3929f1","metro-cache/fc/d5339eb6b46db6bbba6ac01dbb63f6b8d59106c2d6a98c8ad822a881bbcacf09c9b976","metro-cache/e0/a42b79daa56c9a9054f046c07195cb7a13784fdef2d95da8db7f0b6c1d2752e3b8dd4e","metro-cache/77/cdf5a3f71568e4de1958508282d0a334bcaf94e81689d84feb2e1d4e7a6328a32aceff","metro-cache/77/6f846eacd79914811c82e1d19701bd9a2e6b499c70a752d2fd05fbdc9fa6c892e70268","metro-cache/01/d45b1b537f7cfabaa1126c30e464b8037f4a906a12e79b98cd6635dffdb02fce885cb9","metro-cache/9f/98d965f94aed8557b6cb1deb5e2e2adff30a8a4eb0bd08515e7c4e20e87831b350c121","metro-cache/62/76a9ec035450d3b04f92ca579164c5862997dfae4701bd0dfb559da6354a54471d422b","metro-cache/ab/006cd75c3c6757b34d8ad7ecb5c6e75145ecf45b1688b04d6fd11a25e298296a5ba9ed","metro-cache/09/7554894179ce929c91619c7a1d2ae66c56758790ab0f1502713accfa79bbba73f0d471","metro-cache/95/6bfc7e4f64fd7f408ffb709b5d1eae754b7d0b1092e46cffe89a218e22681bd7619c1f","metro-cache/52/399fbd6cc4566d47c3dcbe0cf625ee88d591ab71df7c37b02910be1d42c9c69f3bbfe1","metro-cache/96/8c80025d2f6c3b53e94e42b48e6051b90eed435a687542c2e4e6328fdd7330dacf2f2f","metro-cache/1a/69b3169b8bda93dfbb8620409a1b0612e81ea8fc7dede1d654a0921c1ec87381df158e","metro-cache/b3/5efd241364af2827fa069b455c307e5b63bdbcd18e6401d16f3ef6fb594c602d3d2be8","metro-cache/1f/b928c2b8d63ada6f1886e441d993e61902e9a78e8491a55c8e71427dbb274c8e6ddc33","metro-cache/f8/81fc11fdcd023c014c8faae71fe2bdea873bf24934a2740b47f0bbade1592b45feae9d","metro-cache/27/d32d3adc66e5c70e80b483d1dd2d193119f1637c27dcdd66fc32887a5547d41be5d847","metro-cache/d5/d6d371f3123513d4967b776c281eb8feb41e1aec0db582a7ace106809b8cb1b6159fe6","metro-cache/8a/fed5a3b0c41aa825f322420571552ed8acff1b102989f2e30aa3f233515c082ccdc7c3","metro-cache/af/5ecdd98a43134bded2175d6cb624ace15d671f339f6a629279fc1e5e1a2bf491598cae","metro-cache/21/f170e74ed114a33a95f87bfea74eed7193320888349ff47d318fb999cbc7895a747383","metro-cache/3b/0b134aa215ab785ec517e05870ecd24c283bbc1a827e6f0a6f73a1a6cd5ab1cd5a7cba","metro-cache/47/96851f43f5ae08f5cd2fd03564dfc99aafa4009270a000c35aaa9185461f8c3c91b1a3","metro-cache/ef/248b9e385bb7a7b250205b392614fe7f0675d3bc835d89856550c64ae4ac5b6ac381db","metro-cache/41/abce194b012269cd8699b8043a899f07c4f8af0b24489df0aa4c2e8c7274921ff4f5dd","metro-cache/14/b2470bb47aa6bf29d0040578ea1a6c0619cb6a33260bfb91ff15fc00e2f9afc213536e","metro-cache/0b/d2d6dfd4772a76afe82f99f8d60beb4107d17715e75492a3e47408be9afdcd66ea2cd6","metro-cache/d5/77cebb0925fe9c21ef7993826e588d38f0580cde45ed3d945f792b1ed6fcf36a35ef69","metro-cache/c7/1e11a697c969173de80d90949af47897645f59ac9c34914d254087f9a40dc0d70269a4","metro-cache/21/3fe682ffe544753dcbdcfdbf3aaaea11d4333cb46ad1e3f668cc580ed1df641fbe9e2a","metro-cache/02/935e6e8c5191a1a24ff39659b52c318445010f6d31c732564b9d0a8cc4c8f405044e36","metro-cache/40/e5e90afa5457f10d101203e2ed10a636e97a965d7f2a656ef8c53a72ca4f165dc1c675","metro-cache/4a/8c9b46b4792f74a2ea8670be074a286bf606832fbba4e725407e92934cda85b3906a2e","metro-cache/bc/e7b5adb4d7fd28d41172da463376ae05ec174181bc2b3468965cbb0fd7b820d9d6df00","metro-cache/72/b45a096c59021823b2df91f429e63e1e9e711e6685af312e3450beeaa3206b90c5f9ac","metro-cache/d4/0fb0468a80c23189dc08b3ec20d4fe52d0dd99c4af78b9ea200d215b467a62c2a85f44","metro-cache/2c/0c1a6da25923f79e63a075e1ef9cec5ae0b911cfa33122c18339fc15252463aa90017f","metro-cache/15/6550424a1db344091dbfd1abf50e489878290b5fe5c9b41dba704d57df8bf5d9d2b268","metro-cache/0b/fabd2fde6fdeb6de17471d583728317eabdb5f4b6bf4b56752ddf06dcbd56fbc731e85","metro-cache/30/094847b138e2af6b210b212a20b9f697693aed2e8bdd7d02685a2bbb176153a376d9fd","metro-cache/27/52de1ce0ca0feb9783e3365bdda28f112ee456c38a65b16daa5db25a1058cde1a45eed","metro-cache/cc/331f1d48231d5d1a3b847b9bbc1d868873ce5dc5a5b632e947fcbc0fce33de0f83f8f3","metro-cache/84/64401cd57eb33b47f02fb1073486e2cb5717ae855438c41fae3b87c3aaf8519cf6e5a6","metro-cache/d5/b4bbc89d88c4846d7fe96f3f9ced37fbb0d6fb62b75e0740801123b4e4318e3a08b22e","metro-cache/74/b245d28e6c88560ad47957b5cff52ffc18a2f3cebffa053eea13b83463218f862682f0","metro-cache/a3/f5f4dab786a3100bccc201954096e3980e96398db6f99962de65fbed4a7aeb772954de","metro-cache/38/fdf071113b470b4a1235f99f238812ef9047127dc032cecf9d6e91915de845bc7913a4","metro-cache/1f/49627a47eaa540ecfe68c469fe668229b437485c8ad3e8882d7809ae9ef795b558b573","metro-cache/b8/4ada01bd1c981ce7548c7729a5782f26edbdeba893595d0d5aa404008f85de1a7516a1","metro-cache/4a/aefd4ac1587cd1490c834ff9149c97b61becd38b2608ec297f203b6bf62a6e2c517745","metro-cache/30/fa6ca3b072a40fef39700ae57591a82d25fc71030cfa602b936bab1927266b16b59926","metro-cache/3a/a04f8bde36a7e20fc1361d8b50618318bf2be115d3ec8adc84169363968156d5e1ea47","metro-cache/7f/65f4f2a8be70810eed311e11bfc88613326f5202aeec6fef6d50a7a51d4472a550f3fa","metro-cache/ad/b13f8c0b1c0ac308f356914fe70efe736e9dae15748e9c22746e16c14d1473d7612112","metro-cache/47/35c15c6b57d9a2cc808ff647aa35f44846bf21504ee0383811bb63156f06b1ec9ba147","metro-cache/e5/6689a7859ab1203bf30ad3c4e31241f904e0d3a28259ef7206485b484b03f58ea0bdaf","metro-cache/be/f9bb6fbfd60c7366093926de0fae70a777399544954c0cfdccbcfab7b2ed5b2e884315","metro-cache/e0/c93b51909c292de5bbce5292b0f6d4f17484a5e2d93dd176d68803cea4e0de74ceab3c","metro-cache/39/f33b377b7fee88d4060bd428bdfe1ac58314f77290ba5eaf221ada9f25c2cdf7ee9fe1","metro-cache/1f/5e942cf892432532a17e2185b00b2e1de7c5264b7cdb2da6be49e7afac68ad574cb441","metro-cache/fb/54a9adb21e73947c89b8b7460373c9057bb5318d02333712d9a6f1ca3f727687d2759b","metro-cache/89/09105800c59cd05a5a2dc0ab37f363762c1b188543d8f5e32b31f33db88695e3509530","metro-cache/d7/8cc7ad9088df1cae4b50ed019facb222de44749ad9ba676ff68a55aee5aeeb1cf86f67","metro-cache/70/88a367d66e0a47dabbc0effaca013e4aa61ec235b609f46d12f01d6e24db3d2662d889","metro-cache/3a/104c18e114bf26568315735c4349a28f6e737a7944ca1abf61bd52d00351b0b308a6a2","metro-cache/9b/d6f7b2f364f163a62161bc0d0ce742ea911a6453389fefa662249eb125114a79e29df9","metro-cache/79/55811552e7918d68c739ce9ce8c46a79476a8917636f1591c8aa04a7da233169dd7d6b","metro-cache/09/e9f0781dc05d17a0ee1dacd471537cc355781c0f3fa4a32e511007deac2b94e59c78cc","metro-cache/c8/22ded40ef930c1084b61aabf0d7649a332ada0af3ad10a3d085caa0ac8712196046b80","metro-cache/90/69daab80ab81b382b68a3f98604896b73f0a86556e8d8d3d98f206c231dea6d80de944","metro-cache/4b/49878f7c21ce325e7e179fa5ff9f66e03814311da1801fb4fa626e0320fb463a469322","metro-cache/6b/800d3b3ae437ad30c2887b7803a3a3ca2c2f050da0faaf03509668f8ff32a5f5bb0386","metro-cache/f8/1fae29c0dfc43e4c675729d20ef82a4871e458ebe38763093e8db4fd280037622565c7","metro-cache/33/d4d678347935e205f4bd71be3ddd25ee744e0c6b26016e2ce758d3534f4d000f04261a","metro-cache/a1/68c52923014d223332c1be28f703d83af0b673d49efe9e1f950124b3a6600384e53adc","metro-cache/70/8429ddb2ea1c01677f50aa81226bd68ed76ccbc9078f7c5cc50ed87164fcba34f5a60d","metro-cache/0c/b57572c9f13fd6a3311bdf1904070ae54aaec15c02f01bdce2fd9fdaa3561e97f51f5d","metro-cache/f5/ae655df841a5e302a765690daaf8cebd8173a54567b55504dacab8a16d055c49ec9e0a","metro-cache/cb/512a2a2df45eab35b9f06eb613a17803ead64606dfc8eb26bc9f6f0850c2bad6f5e018","metro-cache/29/69fdd096ce0ff053f4b2ea6829a62d0d30ebb2302e5864bdbd2d0ce8cb024f900d9c58","metro-cache/7d/f5d19258e509d3899876310776dfe5653a0f0a16f416fc19e954d6e232be0f674b71a6","metro-cache/f0/974fb725e18245d4dab54841eebd864810b52989fbd1f484b9f62f3980a46f4db0f696","metro-cache/fd/d2d47653cd8bf8657ddd4b7f057069904e37e7ce6e451222752410a4f0ad2aba027162","metro-cache/be/6e1e223fa2c729e30c246106788b5a513f5d0e10f2a89e61362a7accd6e1145f1c221d","metro-cache/0b/def74a40464c1990770d766248834bbb2b0f8fbc66c256b141a254e7fe33adfc3cf8a8","metro-cache/17/57301b66e820129b1ad1f9075bc3a3adfa83640a63e78340d232cdc7bb95343dee1158","metro-cache/30/e5dddbd2eeb6632303cf9b1ec85feaaab037dc4909bc9f317e34f8bab9e56d72b5d350","metro-cache/8d/8f84c0d09b8b8db678df274d70360f2499b08d7f90cd66a14ce30703fc068a1fba826a","metro-cache/ab/69558004250c75a8cd71579c79488f36107750da3d03bd80aee2fa1d51ceed75f4a55a","metro-cache/49/210e9034504da515d270971812650a91d34b837e49145614f8405adc3d6516d5246f1a","metro-cache/d3/acebc0a06f94ff9ed93fd993c9e84e9beb61a12a7948f555938d8c31cf0a9e9e6a462c","metro-cache/c9/4f45707f2656d746615461d57c120cc8ee7e1a3c332c3195ef0cb1a4d3d8697b921f01","metro-cache/94/6a2c607c8032bc620e27967dbc9480bf86be183a05a66e3895655452a6f46c11b16a39","metro-cache/f2/a4538c685aeeeb8f6ec7ed34dfc8a1eab3b8609a358960507c6ad17134b5b67355b9a6","metro-cache/4d/faaf6948d2fa30cb4946d8ea4c292d1275384c63cd37bfa4732cb9fd5857dd164a64e4","metro-cache/42/a608ce43cbc78826c72c7d6fd7923085bf27c176e3e2290fbb0d58b90ea03a1fd7976e","metro-cache/c1/38942dbd3ef5c38934ebf54e7cf68e9ef017b6614ab3ea8b570aa464ba184b5dbf540d","metro-cache/74/6832ca95fd85f3f3085808f7b57119e9d14d0b75325bcfad5566e48417700cfacc40b1","metro-cache/e8/6e345b7eb25f183bae939bb1136e638d4545038994e288af78b3816842110bec84bbd2","metro-cache/81/65b284ff31f6b25d1cf1c3db85c18acf42715632f387e822ae582617d570bf14aedc4b","metro-cache/85/43c57416d28b78c21af5f3c3e28743e8c0ea448917d7afd8a417c0622c6efa2397db7f","metro-cache/61/7032f2ec5884b9431fb5597265f5b74085054a6d4cead98016e664ee285ee7f63b8224","metro-cache/32/271ade9a63cc76dd6582c4b22834ff3cc8737dae63601259eba3ffcc1f5c20ed790675","metro-cache/89/f4c8318b878cce09dd69ad4e9e3cf89d83496ad413acf2f2139f7385767cfaf637599b","metro-cache/20/ba7ad3b2b5a53b30d7c6fc48c0cd4efa894a1d31670c1bf009599d698a16e81fa3bae9","metro-cache/53/2ac444196401836fbdd757730cb395b5b0e78da53f5d0d22db52528a60f134e605a8c0","metro-cache/75/ea7d4b992eeeb28e8bce05459e23c9eef4d0b01ee26adea59ca7865822232d16aae872","metro-cache/b6/570095369c792127807236d4e40351b41e83b4f7f188976e4c342d27622c99b802c3d1","metro-cache/46/2221012a58b0a45d166453e9fe553ad9f5b11b14e3a04e8c29b074bd1bb36b15683d91","metro-cache/69/421f95c48a51435bce183293fca15c5f47959204196e544bc516ff5e8f6c6f10a13bcd","metro-cache/a0/c2632398bfe5cbfc7d73d60e7f4353bdb95abdaa00966d037b98fd24a83672e0341463","metro-cache/95/b4e32f0d70254b19c68fecb1766c6608ad4adaf494084f2f1ee45a3ca66ccce80cf459","metro-cache/71/c61816d38beb7fdd6719aec7d93ff459bdaaf6222ed85898a4db06f3961b7534853160","metro-cache/05/d489774ef72efbd6ae415c55e0689b1550a667531868fb3df1cc7c20318545999a8904","metro-cache/24/ff3d402defd58ff4ad5021cc2efbdb0f13841e587414c9fafbc220988f7543eb4b7b27","metro-cache/3c/d281acac8b275382993e228fab16083df9af1a379ab1f2be634d36588102012ca6365e","metro-cache/7f/8b09f6b68661a72d183fac2b3fa8ce7ca2627a10323a3bb851a062bf3527b0ec214bea","metro-cache/af/4562c098ba5e4629daab2f22c60c9ac6124dadbb0826b133424648c1e1262e54aa45f8","metro-cache/e1/98ebb517ac9a7c5a2102b480954833249fa227273ae801599c0c2abf230816916adb5d","metro-cache/f0/079c3cef2db7ba167bd2b4ed40567ed0874410227caebf69f641d5430e597a00702534","metro-cache/e3/23f4bed29ccec301ebac55143c985233a001ee46269984eb7a2b85046d23b8591f57c1","metro-cache/19/1e06a57ac58ea0eb8942be3d4155a292b30008774796e75fb51c729e981b05dad1dd6d","metro-cache/08/92b6458774a227d9ab7b50f2c79cb37b611f10699059c068b2bf26d0698bbd19e837c5","metro-cache/16/441d1005ff53d8f4e611821d0a3a45faceeba3a31bd56979c58282f191beb7f1699889","metro-cache/3d/e52c1b6a652a1d6f282cac3f8daa764ca5659a4a9433ce3a1240034a458e9b8aa2200b","metro-cache/80/104af27d0ee7b18720982d40e7e9eb840c09820bdd2d1d8ecbeb3fbbf4f73de37096aa","metro-cache/d6/f74aa6e6c13ec0618cb8b432b8b28644c5390f8a6c615cfcd8994805eb95fbe1c2d312","metro-cache/3d/c1e507f6c0c85062696c4eb5e3c3950960a46e1457c76dca59c9222f376f1e591d6a78","metro-cache/79/5398f746e2908a4ed1b2dfbcfbe28810eeffdf73150ac3ddfff3635cc55c2d064110f3","metro-cache/b5/3b13664aa37567052e7456432f9284748c634dd35b4867f128b662fbf3a2288848c928","metro-cache/76/e5bd999091be28402db08e157c45b94c70ba5fecde6d08efdea4f3c0a0970977e448a8","metro-cache/aa/d149bc7df6d09adce348e867876a51c7184f918daef36d39c9ea9c975cc32074eec395","metro-cache/57/f8ae11bf6573b2db34dd6776280b9280066ef791ab57c6f7b54d527a71a52872487ced","metro-cache/1a/0ce1d456291361eb45e9433c5f5673ab3a88bd0b5799101318b4c8d02ea92190b0770a","metro-cache/da/428a9a092419569694c73137661559a9749ce3643ca09768690930965048b27b8808c5","metro-cache/51/a618318bb7c9b6857388917ef0c2a218c6068d81c2962e5aba89d8b06705174ff1ae2f","metro-cache/0a/a59fd73e511c3f7f16b518f7aeb1692bc89129358f514b1e2adbc2c614e755a45b1bd5","metro-cache/be/7a85ec45460a9701099d1ce982e0a326a20099fbc5237bbe8481244a7f6028465dd27f","metro-cache/7d/dfdab63a03e090e2559609a1bf238a119fbfe9744986a5aa731211abc66b90fe1c1db2","metro-cache/0d/2542f0f2d31facbdac5aa5535a4337cbd1d1ec87af382f8fe9df47ec935124df3619d2","metro-cache/38/822f0652daf1b9e6b3124726556d04423804c851b0c98eb123f41edadefa88d10bc050","metro-cache/4f/eb655b3071cc9eaa71368839b48489a85024cf3b754156ca8fffb5df321e9d614e3ba1","metro-cache/9c/1eb30a70daed9a10353f3538ce4b707e6d4979d06e2bd1574f35f410dce47d38b2a700","metro-cache/53/ad2448ac9a3dc6c53f6b9fb52e9a9c5e8ff6071934b02b779850f8d06abe5874861fe4","metro-cache/74/505bde7c2e79813fafef05b045cf208bfcc84455fd01feccd463e726c9eff695e53512","metro-cache/0e/7a0d4343f2abd121c4f0e7c56a01d91b8213f84e71116a1bb07bde95bc4f45ab6ff232","metro-cache/54/33fcb507f0ab0ca1fe578531ba1cd30c40c2008bab81c9d3f4a7478c0428e30a6904de","metro-cache/82/975a0b6395058172bca7be1f58601caf93a8e94e0ca66fc7754e7e4d415357006eda72","metro-cache/65/cee7b84dccda00a746b7915f12a61a02f3cedf9a0bd0e778ed7ef1586edd50e9cdf380","metro-cache/77/f9e32d3afc7b3c05b631ca207c9d580c7477da76c4af38d04575a703ada74061a57ddf","metro-cache/70/fa0c34c969d49bd220ef2a599fc579e93ad09a808cc37992ad42a30b0771296ddcf578","metro-cache/5a/01aceaf140b92dadb9610e0d9ff1ba7b2e7262cebbef9cf33057e1fc79b8e1d91f53a0","metro-cache/82/5ae93b223fea7f8520c72765c53b5aacfe61026ac60a3433742a86cfd879a7637aac6a","metro-cache/cc/ed4f4835906cf24e4ac5878db1d46d1687bd0ee26dc4138271d1099c7251d5fced898a","metro-cache/90/4fee654c7839f992e4ca9917122cd80e4288b5eacdbae6c533099b1ddea543d751dfd2","metro-cache/f3/2c695ee043890af41c756d548db5903fbe14f57f537560b5d759d90c2ee09a03344f25","metro-cache/a7/d44b683adb64942a630640d597d7d19b2d63f56991febf18149ec2012ca1495b1d17bd","metro-cache/a2/fb735578eccaf698a400595a3bb6f219adff1058da7c568eb91db08ac016fd5dd55bed","metro-cache/53/448c12973b275fa77369ef0dab0c822d72b9c702badd6fa80dc3405ad7100b19ba049a","metro-cache/65/e43332110292f967b9773d6200bc51481505efd7b6c6a1aa160ba18e400e52bea3e1de","metro-cache/d9/dd51e99fd0a0a2b36d9913550afbfc311a2c8eaec6926cb91176a76a2d8cb003056a1b","metro-cache/d2/edc97fd1f7996a053139ca9c0e15c9018057b5632a6acab6db0cc0242db413487dce62","metro-cache/8f/a55e5195830c30f0b1e4469b3f513b9e70be8d8c5c4a0200f64bd9b9a766aa6f44ad8e","metro-cache/cb/2f05df36629ad2437078cafb016316cde92ed787f8596c5d8d7cab3cf8119435c041b1","metro-cache/ea/1c03fe900a06f694215afecf6acf41e5b8e3b2aadbd3d55187abc86974c30852311106","metro-cache/95/3c91c1a183fa79472d2369dce1e97f9ccd18faeff765b426a36a2b59ad19b007bc170b","metro-cache/f2/2a33727844c910249e68e935d69d4414a22b3eb563a3f2c5bb145c99a34540fdde01d7","metro-cache/8a/c5f3728a35ee2f3e69607172ab5c02b725243ab910d4940036254a34be6fe116322aa7","metro-cache/98/8e5a9eaa9535aa4eedae73106a635fdc68c1ec1e239b1fe9d83a70607f4729b3e0b4e4","metro-cache/88/9222a5d195dfeb3036fa12849c79286549b1523e2e83bbfbe665f218f863161864b6ce","metro-cache/a5/a5b73e76cb26e2ee8a92bba63f1691d63bf2d6e3c4cb9bffa0a3dc29c44e9aef87d517","metro-cache/7c/3d15c2f004c31375f3f06aaf1b4f87cbbf6db4f4a586b39285d94b0479db5aaa2d9308","metro-cache/9d/d9f1a156f0500a0899ce87e8390eab334ec56e622ebe99ef9566782888dc93b081803e","metro-cache/92/d7eb491da86de8d1d41cb23d7f84deedbe5b7f733081cbd57ac5070b1e9e166049706a","metro-cache/ed/4b51df989317141b76cf476e49826b68d26cb5e937e1998eea868ef4addc901282e193","metro-cache/9d/4c5289ef7baf9df79131eaf1d5a248933b75756d4cf0083ab9b573b28bd429385dfdf4","metro-cache/e4/85cbd0a564abf78e14a18b94f3f877520fdb56c230c977ef34ccff8ab03ab75fe26655","metro-cache/22/ec1a311a39065a045c1d8940be99a5ef970226f01b6b050571f7bdb5882e8c7508bf4f","metro-cache/45/2f60c95b3404b0bd413beef61291f96c0323229f4e85d9022927f0705baca22a6bfe89","metro-cache/14/073b16c4484fbf640ca59f3fcbf15d45ebd2e08a82f759d576b97aa8675bc1346f8392","metro-cache/e2/6ee5e2eebde5200f8183a826b056beb9a5aee05119d8b14885f772add34c98efd31266","metro-cache/c8/4ef0d64509b8794bc3888c9a23d31d498c548a9640cc9ccb19fd110e05670b05c5934d","metro-cache/58/4ce4e6095a3c7b636c3ace1161c58dba611da4200e5c26e3285fe28742bf9c407ecadf","metro-cache/b4/8ea74de4016b0cbea9d4e212c8904970af110ffc9e100f1d4275a66c5a2ea01151de36","metro-cache/a8/063ff5e5c13e3556474c811a02a8bf54a081b408572dec598853e3a45d797033d6fc0a","metro-cache/00/b8d3c58b71151c3cdfb28ddc42c4d5459bd4da93aface4c94f746944cd614e73c7718d","metro-cache/d6/1cf536a0ca6bf9f1eb037dcaffabdb5a89ae1a1ab5ba7955fd773ac234436e2839fc03","metro-cache/c3/c53bf3e08e76cef1a9bff2baa6621b78407b97ae5c3eb42c7dd2f8d0acfee10152ed98","metro-cache/36/f4ca0a1156cdf179fa4b589b24affef3c86de447d39fe4e41c4f0f873d4321a0fd8845","metro-cache/93/7dfacbce285bcf1e13f075bde09a64ba7af42b5d7de1adc23f72a5fe2e666f8db3be64","metro-cache/d5/2093330a6566a38106539337b44109250b27efef3cb57cd6ece95c77591951b0c6ebef","metro-cache/fb/ba239f66ae8c98ece0a1c45f1b339b75af78c5eb867660bf96704d5548899e787f4fa1"],"totalFiles":10000,"clientTruncated":true,"ripgrepTruncated":true}}},"toolCallId":"tool_19d8434f-d852-4aa1-ac74-ddfc2182ea7"}},{"toolCall":{"readToolCall":{"result":{"error":{"errorMessage":"Binary files without an extension are not supported by the read executor"}}},"toolCallId":"tool_5ba36719-f64a-4ee4-b1ef-09522d3044e"}},{"toolCall":{"globToolCall":{"result":{"error":{"error":"rg: ../../../../../../Users/julius/.cursor/projects/var-folders-b3-b51-pdxj7dl0t981zpqkxxhr0000gn-T-t3-orchestrator-v2-cursor-agent-sdk-record-proposed-plan-ggwFWW: IO error for operation on ../../../../../../Users/julius/.cursor/projects/var-folders-b3-b51-pdxj7dl0t981zpqkxxhr0000gn-T-t3-orchestrator-v2-cursor-agent-sdk-record-proposed-plan-ggwFWW: No such file or directory (os error 2)\n"}}},"toolCallId":"tool_1d4f6ac5-3ffc-406a-abfc-962a7ecdd49"}},{"toolCall":{"globToolCall":{"result":{"error":{"error":"rg: ../com.apple.replayd/TemporaryItems: IO error for operation on ../com.apple.replayd/TemporaryItems: Operation not permitted (os error 1)\nrg: ../com.apple.securityuploadd/TemporaryItems: IO error for operation on ../com.apple.securityuploadd/TemporaryItems: Operation not permitted (os error 1)\nrg: ../com.apple.syncdefaultsd/TemporaryItems: IO error for operation on ../com.apple.syncdefaultsd/TemporaryItems: Operation not permitted (os error 1)\nrg: ../com.apple.transparencyd/TemporaryItems: IO error for operation on ../com.apple.transparencyd/TemporaryItems: Operation not permitted (os error 1)\nrg: ../scoped_dirILNojf/SingletonCookie: IO error for operation on ../scoped_dirILNojf/SingletonCookie: No such file or directory (os error 2)\nrg: ../com.apple.iconservicesagent/TemporaryItems: IO error for operation on ../com.apple.iconservicesagent/TemporaryItems: Operation not permitted (os error 1)\nrg: ../com.apple.triald/TemporaryItems: IO error for operation on ../com.apple.triald/TemporaryItems: Operation not permitted (os error 1)\nrg: ../com.apple.ap.promotedcontentd/TemporaryItems: IO error for operation on ../com.apple.ap.promotedcontentd/TemporaryItems: Operation not permitted (os error 1)\nrg: ../com.apple.replicatord/TemporaryItems: IO error for operation on ../com.apple.replicatord/TemporaryItems: Operation not permitted (os error 1)\nrg: ../net.imput.helium.yM2qKz/SingletonCookie: IO error for operation on ../net.imput.helium.yM2qKz/SingletonCookie: No such file or directory (os error 2)\nrg: ../scoped_dirRPFOYo/SingletonCookie: IO error for operation on ../scoped_dirRPFOYo/SingletonCookie: No such file or directory (os error 2)\nrg: ../scoped_dir6d02yz/SingletonCookie: IO error for operation on ../scoped_dir6d02yz/SingletonCookie: No such file or directory (os error 2)\nrg: ../com.apple.appstoreagent/TemporaryItems: IO error for operation on ../com.apple.appstoreagent/TemporaryItems: Operation not permitted (os error 1)\nrg: ../com.apple.imtransferservices.IMTransferAgent/TemporaryItems: IO error for operation on ../com.apple.imtransferservices.IMTransferAgent/TemporaryItems: Operation not permitted (os error 1)\nrg: ../com.openai.codex.Kkes0i/SingletonCookie: IO error for operation on ../com.openai.codex.Kkes0i/SingletonCookie: No such file or directory (os error 2)\nrg: ../TemporaryItems: IO error for operation on ../TemporaryItems: Operation not permitted (os error 1)\nrg: ../com.apple.parsec-fbf/TemporaryItems: IO error for operation on ../com.apple.parsec-fbf/TemporaryItems: Operation not permitted (os error 1)\nrg: ../com.apple.tipsd/TemporaryItems: IO error for operation on ../com.apple.tipsd/TemporaryItems: Operation not permitted (os error 1)\nrg: ../com.apple.fileproviderd/TemporaryItems: IO error for operation on ../com.apple.fileproviderd/TemporaryItems: Operation not permitted (os error 1)\nrg: ../com.apple.imtranscoding.IMTranscoderAgent/TemporaryItems: IO error for operation on ../com.apple.imtranscoding.IMTranscoderAgent/TemporaryItems: Operation not permitted (os error 1)\nrg: ../com.apple.chrono/TemporaryItems: IO error for operation on ../com.apple.chrono/TemporaryItems: Operation not permitted (os error 1)\nrg: ../com.apple.calaccessd/TemporaryItems: IO error for operation on ../com.apple.calaccessd/TemporaryItems: Operation not permitted (os error 1)\nrg: ../com.apple.remindd/TemporaryItems: IO error for operation on ../com.apple.remindd/TemporaryItems: Operation not permitted (os error 1)\nrg: ../duetexpertd/TemporaryItems: IO error for operation on ../duetexpertd/TemporaryItems: Operation not permitted (os error 1)\nrg: ../com.apple.studentd/TemporaryItems: IO error for operation on ../com.apple.studentd/TemporaryItems: Operation not permitted (os error 1)\nrg: ../com.apple.parsecd/TemporaryItems: IO error for operation on ../com.apple.parsecd/TemporaryItems: Operation not permitted (os error 1)\nrg: ../com.apple.identityservicesd/TemporaryItems: IO error for operation on ../com.apple.identityservicesd/TemporaryItems: Operation not permitted (os error 1)\nrg: ../com.apple.sharingd/TemporaryItems: IO error for operation on ../com.apple.sharingd/TemporaryItems: Operation not permitted (os error 1)\nrg: ../com.apple.bluetoothuserd/TemporaryItems: IO error for operation on ../com.apple.bluetoothuserd/TemporaryItems: Operation not permitted (os error 1)\nrg: ../com.apple.bird/TemporaryItems: IO error for operation on ../com.apple.bird/TemporaryItems: Operation not permitted (os error 1)\nrg: ../com.spotify.client.TtbUSJ/SingletonCookie: IO error for operation on ../com.spotify.client.TtbUSJ/SingletonCookie: No such file or directory (os error 2)\nrg: ../com.openai.codex.OpU7gz/SingletonCookie: IO error for operation on ../com.openai.codex.OpU7gz/SingletonCookie: No such file or directory (os error 2)\nrg: ../homed/TemporaryItems: IO error for operation on ../homed/TemporaryItems: Operation not permitted (os error 1)\nrg: ../com.openai.codex.ARhBC6/SingletonCookie: IO error for operation on ../com.openai.codex.ARhBC6/SingletonCookie: No such file or directory (os error 2)\nrg: ../com.apple.usernotificationsd/TemporaryItems: IO error for operation on ../com.apple.usernotificationsd/TemporaryItems: Operation not permitted (os error 1)\nrg: ../com.apple.quicklook.ThumbnailsAgent/TemporaryItems: IO error for operation on ../com.apple.quicklook.ThumbnailsAgent/TemporaryItems: Operation not permitted (os error 1)\nrg: ../com.apple.pluginkit/TemporaryItems: IO error for operation on ../com.apple.pluginkit/TemporaryItems: Operation not permitted (os error 1)\nrg: ../com.apple.donotdisturbd/TemporaryItems: IO error for operation on ../com.apple.donotdisturbd/TemporaryItems: Operation not permitted (os error 1)\nrg: ../scoped_dirfKTmVG/SingletonCookie: IO error for operation on ../scoped_dirfKTmVG/SingletonCookie: No such file or directory (os error 2)\nrg: ../com.apple.imagent/TemporaryItems: IO error for operation on ../com.apple.imagent/TemporaryItems: Operation not permitted (os error 1)\nrg: ../com.apple.weatherd/TemporaryItems: IO error for operation on ../com.apple.weatherd/TemporaryItems: Operation not permitted (os error 1)\nrg: ../com.apple.imdpersistence.IMDPersistenceAgent/TemporaryItems: IO error for operation on ../com.apple.imdpersistence.IMDPersistenceAgent/TemporaryItems: Operation not permitted (os error 1)\nrg: ../com.apple.amsengagementd/TemporaryItems: IO error for operation on ../com.apple.amsengagementd/TemporaryItems: Operation not permitted (os error 1)\nrg: ../com.apple.icloud.searchpartyuseragent/TemporaryItems: IO error for operation on ../com.apple.icloud.searchpartyuseragent/TemporaryItems: Operation not permitted (os error 1)\n"}}},"toolCallId":"tool_77d9e32a-f036-4ecc-9704-e6e484e158a"}},{"toolCall":{"globToolCall":{"result":{"error":{"error":"rg: ../../../../../../Users/julius/.cursor/projects: IO error for operation on ../../../../../../Users/julius/.cursor/projects: No such file or directory (os error 2)\n"}}},"toolCallId":"tool_5b5b3e42-39a6-4f5a-9a36-6dcf0296872"}},{"toolCall":{"readToolCall":{"args":{"path":"/tmp/cursor-replay-proposed_plan/.git/config"},"result":{"success":{"content":"[core]\n\trepositoryformatversion = 0\n\tfilemode = true\n\tbare = false\n\tlogallrefupdates = true\n\tignorecase = true\n\tprecomposeunicode = true\n[user]\n\tname = T3 Code Test\n\temail = t3code-test@example.com\n","totalLines":11,"fileSize":198,"path":"/tmp/cursor-replay-proposed_plan/.git/config","readRange":{"startLine":1,"endLine":11}}}},"toolCallId":"tool_90ab80d0-945f-44d3-88e9-500bb6cab35"}},{"toolCall":{"grepToolCall":{"args":{"pattern":".","path":"/tmp/cursor-replay-proposed_plan","glob":"*","outputMode":"files_with_matches","caseInsensitive":false,"multiline":false,"toolCallId":"tool_af1a9a15-a402-49c4-b5a6-395ff6a285e","offset":0},"result":{"success":{"pattern":".","path":"/tmp/cursor-replay-proposed_plan","outputMode":"files_with_matches","workspaceResults":{"/var/folders/b3/b51_pdxj7dl0t981zpqkxxhr0000gn/T/t3-orchestrator-v2-cursor-agent-sdk-record-proposed_plan-ggwFWW":{"files":{"files":["./.git/logs/refs/heads/main","./.git/logs/HEAD","./.git/refs/heads/main","./.git/objects/fc/daa658b54f15c125d37542fbc5c39063cc8ae5","./.git/COMMIT_EDITMSG","./README.md","./.git/config","./.git/HEAD","./.git/hooks/push-to-checkout.sample","./.git/hooks/update.sample","./.git/hooks/pre-push.sample","./.git/hooks/pre-applypatch.sample","./.git/hooks/pre-merge-commit.sample","./.git/hooks/post-update.sample","./.git/hooks/prepare-commit-msg.sample","./.git/hooks/pre-receive.sample","./.git/hooks/fsmonitor-watchman.sample","./.git/hooks/applypatch-msg.sample","./.git/hooks/pre-commit.sample","./.git/hooks/sendemail-validate.sample","./.git/hooks/pre-rebase.sample","./.git/hooks/commit-msg.sample","./.git/description","./.git/info/exclude"],"totalFiles":24}}}}}},"toolCallId":"tool_af1a9a15-a402-49c4-b5a6-395ff6a285e"}},{"thinkingMessage":{"text":"The workspace contains only a README with a title. No source files, tests, or infrastructure exist yet.","durationMs":558}},{"toolCall":{"grepToolCall":{"result":{"error":{"error":"Glob pattern \"**/*\" matches every file and is not allowed. Use a more specific glob or no glob."}}},"toolCallId":"tool_ac6f70b1-60ad-4482-afdc-7563df54fee"}},{"toolCall":{"globToolCall":{"args":{"targetDirectory":"/tmp/cursor-replay-proposed_plan","globPattern":"**/.*"},"result":{"success":{"path":"/tmp/cursor-replay-proposed_plan"}}},"toolCallId":"tool_13b532d9-49c8-4d2d-a01b-99b1f3a4fcb"}},{"thinkingMessage":{"text":"The workspace contains only a README.md and git metadata. No source files or test infrastructure were found.","durationMs":681}},{"toolCall":{"grepToolCall":{"result":{"error":{"error":"Glob pattern \"**/*\" matches every file and is not allowed. Use a more specific glob or no glob."}}},"toolCallId":"tool_0a725569-43c1-4226-8b51-48fef92f25d"}},{"toolCall":{"webSearchToolCall":{"args":{"searchTerm":"t3-orchestrator cursor agent sdk proposed_plan record replay","toolCallId":"tool_854579ea-3e01-40e1-ab7a-304bf71c37c"},"result":{"success":{"references":[{"title":"Web search results","chunk":"Links:\n1. [Cursor Python SDK | Cursor Documentation](https://cursor.com/docs/sdk/python)\n2. [GustavoWinter/cursor-agent-orchestrator-mcp](https://github.com/GustavoWinter/cursor-agent-orchestrator-mcp)\n3. [Build programmatic agents with the Cursor SDK · Cursor](https://cursor.com/blog/typescript-sdk)\n4. [@cursor/february](https://registry.npmjs.org/@cursor/february)\n5. [docs/development/cursor-backend.md at main · ralphkrauss/agent-orchestrator](https://github.com/ralphkrauss/agent-orchestrator/blob/main/docs/development/cursor-backend.md)\n\nSynthesis:\nTo record and replay plans using the Cursor SDK, you utilize `mode=\"plan\"` during agent creation or updates [1]. \n\nThe Cursor SDK itself does not include a native `proposed_plan` record/replay mechanism; such functionality is typically implemented via an orchestrator layer [2]. Using the `@cursor/sdk` TypeScript or Python packages, you control this flow as follows [3][1]:\n\n- Plan creation: Set `mode=\"plan\"` in `Agent.create` or `agent.send` to trigger plan-oriented output [1].\n- Record: You must manually record these events via the SDK's streaming interface (e.g., `run.stream()` in TypeScript or `on_delta`/`on_step` callbacks in Python) [4][1].\n- Replay: Replaying requires consuming these stored event logs and re-initiating the agent state via `Agent.resume(agentId)` [5][4][1].\n\nThird-party MCP orchestrators provide ready-made tools like `propose_plan` and `confirm_plan` to automate this [2]. These tools handle the persistence of plan states and approvals in an external JSON file, allowing you to gate execution until the plan is confirmed [2].\n\nHighlights:\n<result id=\"1\">\n<title>Cursor Python SDK | Cursor Documentation</title>\n<url>https://cursor.com/docs/sdk/python</url>\n<content>The async client mirrors the\n[...]\nsurface and is recommended for servers, bots, and\n[...]\ncursor_sdk\n[...]\n### Conversation mode\n[...]\nPass `mode=\"plan\"` or `mode=\"agent\"` to control whether a run explores and plans first or implements changes directly. See Plan mode for what plan mode does in the product.\n[...]\nSet `mode` on `Agent.create()` to seed the first run. On follow-up `agent.send()` calls, omit `mode` to keep the conversation's current mode, or pass `mode` to switch for that run only.\n[...]\n) as agent:\n[...]\n| Property | Type | Description |\n| --- | --- | --- |\n| `model` | `str | ModelSelection | Mapping[str, Any]` | Per-send model override. If omitted, uses `agent.model`. Sticky after a successful send. |\n| `mode` | `\"agent\" | \"plan\"` | Per-send conversation mode override. If omitted on follow-ups, keeps the conversation's current mode. |\n| `mcp_servers` | `Mapping[str, McpServerConfig]` | Inline MCP server definitions. Fully replaces creation-time servers for this run. |\n| `local.force` | `bool` | Local agents only. Defaults to `False`. Expire a stuck active run before starting this message. Cloud returns `409 agent_busy` server-side, so no equivalent is needed. |\n| `idempotency_key` | `str` | Optional client-generated idempotency key for the send. |\n| `on_step` | `Callable[[ConversationStep], Any]` | Callback after each\n[...]\nconversation step (text, thinking, or tool batch). |\n| `on_delta` | `Callable[[InteractionUpdate], Any]` | Callback per raw `InteractionUpdate`. |\n[...]\nUse `Agent.resume()` or `client.agents.resume()` to reattach to an existing agent by ID. Common flows: reconnecting to a long-running cloud agent that was kicked off earlier, or continuing a conversation after the local process restarted. Runtime is auto-detected from the ID prefix (`bc-` is cloud, anything else is local).\n[...]\n| `mode\n[...]\n| `\"agent\" | \"plan\n[...]\n`\"agent\"` | Initial conversation mode\n[...]\nConversation mode. |</content>\n</result>\n\n<result id=\"2\">\n<title>GustavoWinter/cursor-agent-orchestrator-mcp</title>\n<url>https://github.com/GustavoWinter/cursor-agent-orchestrator-mcp</url>\n<content>An MCP server that runs many `@cursor/sdk` agents in parallel from one Cursor chat — locally or on Cursor Cloud — with a **propose → confirm → execute** flow and one merged event stream.\n[...]\n> **TL;DR**: Add the MCP to `.cursor/mcp.json` and set `CURSOR_API_KEY`. Your agent gets tools like `propose_plan`, `confirm_plan`, `execute_plan`, and `stream_plan`. `CURSOR_ORCH_PROPOSE_PLAN_MODE` controls when `propose_plan` may run (`auto` asks yes/no first; `manual` only after you ask for orchestration). `confirm_plan` gates `execute_plan` unless `CURSOR_ORCH_SKIP_CONFIRMATION=true` is set before the MCP starts.\n[...]\n_plan`** — the planner reads your repos\n[...]\nruns a single SDK agent\n[...]\ndiagram. It picks the right\n[...]\n1. **`confirm_plan`** — records your explicit approval. `execute_plan` is blocked until this is called (server-side, not just instructions).\n2. **`execute_plan`** — spawns N independent SDK agents in parallel (locally or on Cursor Cloud). Each subagent gets the repo context, project conventions (`.cursor/rules/`, skills), and its own prompt slice.\n3. **`stream_plan`** — merges all subagent event streams into one labeled feed so you see everything in one place.\n[...]\n| Tool | Purpose |\n| --- | --- |\n| `propose_plan` | Turn a goal into a JSON plan; does not run agents |\n| `confirm_plan` | Record your approval of a plan |\n| `execute_plan` | Spawn subagents and return a `planRunId` |\n| `stream_plan` | Pull merged labeled events until `done` |\n| `get_plan_status` | Snapshot run state + PR links |\n| `get_subagent_result` | Per-label result text and PR URL |\n| `cancel_plan` / `cancel_subagent` | Stop a run or one subagent |\n| `prompt_one_shot` | Single SDK agent without the planner |\n| `list_plans` | Recent plans and runs |\n| `prune_runs` | Remove old finished runs |\n| `attach_plan` | Re-attach to persisted run after restart (cancel only) |\n| `resume_plan` | Fully resume a persisted plan run after MCP restart |</content>\n</result>\n\n<result id=\"3\">\n<title>Build programmatic agents with the Cursor SDK · Cursor</title>\n<url>https://cursor.com/blog/typescript-sdk</url>\n<content>The Cursor SDK\n[...]\n. Run`npm\n[...]\n/sdk`\n[...]\n`/sdk` skill\n[...]\nyou build.\n[...]\nThe SDK uses our updated Cloud Agents API, which allows cloud agent runs to show up in Cursor's Agents Window and web app. You can start a task programmatically and then jump into Cursor to inspect progress or take over the work.\n[...]\njs example that creates\n[...]\nprompt, and streams the response.\n[...]\n- Prototyping tool: A web app for spinning up agents to scaffold\n[...]\n- Kanban board: An agent-\n[...]\nWe're introducing the Cursor SDK so you can build agents with the same runtime, harness, and models that power Cursor.\n[...]\n. The Cursor SDK lets you deploy\n[...]\nThe Cursor SDK is now available in public beta for all users. Run`npm install @cursor/sdk` to get started, then use Cursor's native`/sdk` skill for guidance as you build.\n[...]\nfrom the SDK run on the same optimized runtime we use\n[...]\nCloud Agents.\n[...]\nstrong sandboxing\n[...]\nAgents keep going when your laptop sleeps or network drops. You can stream the conversation and reconnect later. When the agent finishes, it can\n[...]\na PR, push a branch, or attach demos and screenshots.\n[...]\nThe SDK uses our updated Cloud Agents API, which allows cloud agent runs to show up in Cursor's Agents Window and web app. You can start a task programmatically and then jump into Cursor to inspect progress or take over the work.\n[...]\nusing the Cursor SDK to ship\n[...]\n. For example, programmatic agents that are kicked off\n[...]\nfrom CI/CD to summarize changes\n[...]\nidentify root causes for CI failures, and update PRs with fixes. Others are building\n[...]\nlet GTM\n[...]\nquery product data</content>\n</result>\n\n<result id=\"4\">\n<title>@cursor/february</title>\n<url>https://registry.npmjs.org/@cursor/february</url>\n<content>TypeScript SDK for Cursor agents (private alpha — codenamed).\n[...]\nThe primary API is the static `Agent` namespace. It creates durable agents, starts runs, streams normalized run events, waits for completion, resumes existing agents, and inspects persisted agent state.\n[...]\n- `run.stream()`: Async generator of normalized `SDKMessage` events.\n- `run.wait()`: Resolves to a terminal `RunResult`.\n- `run.cancel()`: Cancels a supported running run.\n- `run.conversation()`: Returns accumulated `ConversationTurn[]` for this run.\n- `run.supports(operation)`: Checks whether `stream`, `wait`, `cancel`, or `conversation` is supported.\n- `run.unsupportedReason(operation)`: Explains why an operation is unavailable.\n- `run.onDidChangeStatus(listener)`: Subscribes to run status changes.\n[...]\n`run.stream()` emits `SDKMessage` events. This is the stable public stream surface shared by local and cloud runs.\n[...]\nLive local runs can accumulate tool steps from raw executor deltas. Persisted replay reconstructs conversation from `SDKMessage` events, so replayed conversations can include tool-call steps when the persisted stream contains tool payload data.\n[...]\n`Agent.messages.list(...)` reads persisted conversation/checkpoint messages. It is complementary to `run.conversation()`, which is scoped to one run.\n[...]\n- Persisted conversation replay can only reconstruct information present in the public `SDKMessage` stream.\n- Inline MCP server definitions are not persisted across `Agent.resume(...)`.\n- Artifact download support is not implemented for local SDK agents yet.</content>\n</result>\n\n<result id=\"5\">\n<title>docs/development/cursor-backend.md at main · ralphkrauss/agent-orchestrator</title>\n<url>https://github.com/ralphkrauss/agent-orchestrator/blob/main/docs/development/cursor-backend.md</url>\n<content>```md\n# Cursor Backend (Local SDK Runtime)\n[...]\nThe `cursor` backend runs Cursor agents in-process through the\n[`@cursor/sdk`](https://www.npmjs.com/package/@cursor/sdk) TypeScript SDK.\n[...]\nUnlike the `codex` and `claude` backends, the cursor backend does not spawn a\nCLI subprocess: it loads the SDK in the daemon Node process and streams typed\nevents.\n[...]\nThis release ships the **local runtime only** (`local: { cwd }`). The agent\noperates against files on disk in the run's `cwd`. Cloud and self-hosted\nruntimes (`cloud: { repos, ... }`) are out of scope and tracked as follow-ups.\n[...]\n- subagents (`AgentDefinition`)\n[...]\nserver forwarding from the\n[...]\n| Setting | Cursor behavior |\n|---|---|\n| `model` | Required. Pass a Cursor-side model id (e.g. `composer-2`). Resume calls thread per-run model overrides through `SendOptions.model`. |\n| `reasoning_effort` | Rejected with `INVALID_INPUT`. The SDK exposes per-model parameter discovery (`Cursor.models.list()`) which is deferred. |\n| `service_tier` | Rejected with `INVALID_INPUT`. |\n| `worker_posture` | Optional; defaults to `'trusted'`. Under `'trusted'`, `Agent.create` and `Agent.resume` receive `local.settingSources: ['all']` so the SDK loads every ambient settings layer (project, user, team, MDM, plugins). Under `'restricted'`, the shim omits `settingSources` and the SDK falls back to its pre-#58 in-process defaults. |\n[...]\n## Sessions and resume\n[...]\nThe runtime persists the durable Cursor `agentId` as the run's `session_id`.\nFollow-ups call `Agent.resume(agentId, { apiKey, local: { cwd } })` and pass\nthe per-call `SendOptions.model` only when the follow-up changes the model.\n[...]\nA `Run.status === \"cancelled\"` is recorded with `runStatusOverride =\n\"cancelled\"` so the run finalizes as cancelled rather than completed.</content>\n</result>"}]}}},"toolCallId":"tool_854579ea-3e01-40e1-ab7a-304bf71c37c"}},{"thinkingMessage":{"text":"The workspace appears empty. No files are present to explore.","durationMs":868}},{"toolCall":{"readToolCall":{"args":{"path":"/tmp/cursor-replay-proposed_plan/.git/info/exclude"},"result":{"success":{"content":"# git ls-files --others --exclude-from=.git/info/exclude\n# Lines that start with '#' are comments.\n# For a project mostly in C, the following would be a good set of\n# exclude patterns (uncomment them if you want to use them):\n# *.[oa]\n# *~\n","totalLines":7,"fileSize":240,"path":"/tmp/cursor-replay-proposed_plan/.git/info/exclude","readRange":{"startLine":1,"endLine":7}}}},"toolCallId":"tool_cb4fafcf-08df-449a-8ee9-a1a0f78410d"}},{"toolCall":{"readToolCall":{"args":{"path":"/tmp/cursor-replay-proposed_plan/.git/refs/heads/main"},"result":{"success":{"content":"fcdaa658b54f15c125d37542fbc5c39063cc8ae5\n","totalLines":2,"fileSize":41,"path":"/tmp/cursor-replay-proposed_plan/.git/refs/heads/main","readRange":{"startLine":1,"endLine":2}}}},"toolCallId":"tool_a4044dd9-25ad-43ba-89e7-2315b0165c7"}},{"toolCall":{"globToolCall":{"args":{"targetDirectory":"/tmp/cursor-replay-proposed_plan","globPattern":"**/*.{ts,tsx,js,py,json,yml,yaml,md}"},"result":{"success":{"path":"/tmp/cursor-replay-proposed_plan","files":["README.md"],"totalFiles":1}}},"toolCallId":"tool_c7276bc4-70a6-4065-8ecc-d5002bd2aec"}},{"thinkingMessage":{"text":"The workspace is a greenfield scaffold containing only a README.","durationMs":979}},{"toolCall":{"globToolCall":{"result":{"error":{"error":"rg: ../../../../../../Users/julius/.cursor/projects: IO error for operation on ../../../../../../Users/julius/.cursor/projects: No such file or directory (os error 2)\n"}}},"toolCallId":"tool_1bbd05f9-8821-42a4-aaa1-748344ca8f2"}},{"toolCall":{"grepToolCall":{"args":{"pattern":"t3-orchestrator|proposed_plan|cursor-agent-sdk","glob":"*.jsonl","caseInsensitive":false,"headLimit":30,"multiline":false,"toolCallId":"tool_726cab56-6097-4b7c-a4d3-493856329fb","offset":0},"result":{"success":{"pattern":"t3-orchestrator|proposed_plan|cursor-agent-sdk","outputMode":"content","workspaceResults":{"/var/folders/b3/b51_pdxj7dl0t981zpqkxxhr0000gn/T/t3-orchestrator-v2-cursor-agent-sdk-record-proposed_plan-ggwFWW":{"content":{"headLimitApplied":30}}}}}},"toolCallId":"tool_726cab56-6097-4b7c-a4d3-493856329fb"}},{"assistantMessage":{"text":"## Executive summary\n\nThis workspace is a **greenfield scaffold**, not an existing orchestrator or SDK codebase. After a full file search and keyword scan, the only tracked source file is `README.md` (one line). There is **no** replay, recording, fixture, test, or mock infrastructure to analyze yet.\n\n---\n\n## 1. What is this project?\n\n### What exists in the repo\n\n```\nt3-orchestrator-v2-cursor-agent-sdk-record-proposed_plan-ggwFWW/\n├── README.md          # sole source file\n└── .git/              # single initial commit (\"initial\")\n```\n\nThe entire README:\n\n```1:1:README.md\n# cursor-agent-sdk-record-proposed_plan\n```\n\nGit metadata suggests this was created by an automated test harness:\n\n- Author: `T3 Code Test <t3code-test@example.com>`\n- One commit: `fcdaa658` — message `\"initial\"`\n- No remote, no `package.json`, no source tree, no tests\n\n### Inferred intent (from naming only)\n\nThe directory name `t3-orchestrator-v2-cursor-agent-sdk-record-proposed_plan-ggwFWW` strongly suggests a **planned feature task**, not an implemented repo:\n\n| Name segment | Likely meaning |\n|---|---|\n| `t3-orchestrator-v2` | Second version of a T3 test orchestrator |\n| `cursor-agent-sdk` | Integration with Cursor’s programmatic Agent SDK |\n| `record-proposed_plan` | Record `proposed_plan` events/states for deterministic replay |\n| `ggwFWW` | Ephemeral sandbox ID |\n\nThere is **no orchestrator code, no SDK wrapper, and no `proposed_plan` type** in this workspace.\n\n---\n\n## 2. Replay / recording / fixture infrastructure\n\n### Keyword search results (entire repo)\n\n| Keyword | Matches |\n|---|---|\n| `proposed_plan` | `README.md` title only |\n| `record` | Substring of README title only |\n| `replay` | **0** |\n| `fixture` | **0** |\n| `deterministic` | **0** |\n| `snapshot` | **0** |\n| `mock` | **0** |\n| `orchestrator` | **0** (only in path name) |\n| `cursor-agent-sdk` | **0** (only in path/README title) |\n\n**Conclusion:** No recording, replay, fixture, or persistence layer exists.\n\n---\n\n## 3. Test patterns, mocks, deterministic testing\n\n**None present.** Specifically absent:\n\n- No test runner config (`package.json`, `vitest.config.*`, `jest.config.*`, `pytest.ini`, etc.)\n- No `__tests__/`, `test/`, or `*.test.*` / `*.spec.*` files\n- No mock/stub utilities\n- No snapshot or golden-file tests\n- No VCR/cassette-style HTTP recording\n- No seed/time/randomness controls for determinism\n\n---\n\n## 4. Project structure overview\n\n| Path | Role |\n|---|---|\n| `README.md` | Project title placeholder |\n| `.git/` | Initial commit with README only |\n| *(everything else)* | **Does not exist** |\n\nExpected structure for the task implied by the name (not yet present):\n\n```\nsrc/\n  orchestrator/       # plan lifecycle, subagent coordination\n  cursor-sdk/         # Agent.create, run.stream(), Agent.resume()\n  record/             # event capture during propose_plan\n  replay/             # fixture playback for tests\nfixtures/\n  proposed_plan/      # recorded plan JSON + SDK event streams\ntests/\n  replay/             # deterministic replay tests\n```\n\n---\n\n## 5. Current gaps for deterministic replay fixtures\n\nBecause there is no code, **all** of the following are gaps:\n\n1. **Event schema** — No type for `proposed_plan` or recorded SDK events (`SDKMessage`, tool calls, deltas).\n2. **Recorder** — No hook on agent streaming (`run.stream()`, `on_delta`, `on_step`) to persist events.\n3. **Fixture format** — No JSON/YAML convention for plans + event sequences + metadata (model, mode, cwd).\n4. **Replayer** — No substitute transport that feeds recorded events instead of live SDK calls.\n5. **Determinism controls** — No fixed clocks, idempotency keys, or stripped nondeterministic fields (timestamps, IDs).\n6. **Test harness** — No assertions comparing replay output to expected snapshots.\n7. **Orchestrator integration** — No `propose_plan` → `confirm_plan` → `execute_plan` flow to record.\n\n---\n\n## 6. Types/interfaces that would need extension\n\n**None exist in this repo.** Based on the task name and typical Cursor SDK + orchestrator patterns, you would likely need:\n\n```typescript\n// Hypothetical — NOT in codebase\n\ninterface ProposedPlan {\n  id: string;\n  goal: string;\n  subagents: SubagentSpec[];\n  // ...\n}\n\ninterface RecordedRun {\n  mode: 'plan' | 'agent';\n  agentId?: string;\n  events: SDKMessage[];  // from run.stream()\n  proposedPlan?: ProposedPlan;\n  recordedAt: string;\n}\n\ninterface ReplayFixture {\n  name: string;\n  input: { prompt: string; mode: 'plan' };\n  recorded: RecordedRun;\n  expected?: { finalStatus: string; planHash?: string };\n}\n\ninterface RecordReplayTransport {\n  record(run: AgentRun): AsyncIterable<SDKMessage>;\n  replay(fixture: ReplayFixture): AsyncIterable<SDKMessage>;\n}\n```\n\nPublic Cursor SDK concepts relevant here (external, not in repo):\n\n- `run.stream()` → normalized `SDKMessage` events (stable replay surface)\n- `Agent.resume(agentId)` → reconnect to persisted agents\n- `mode: \"plan\"` → plan-mode runs\n- Persisted replay reconstructs conversation from `SDKMessage` streams\n\n---\n\n## 7. Suggested integration points (when code is added)\n\nSince there is no code to anchor to, these are **architectural integration points** aligned with the task name:\n\n### A. SDK stream boundary (primary record point)\n\nWrap `Agent.create()` / `run.stream()`:\n\n```\nLive:  prompt → Agent.create → run.stream() → [RECORDER] → consumer\nReplay: fixture → [REPLAYER] → consumer (same interface as stream)\n```\n\nRecord every `SDKMessage`; normalize timestamps/IDs before writing fixtures.\n\n### B. Orchestrator plan lifecycle\n\nIf following a propose → confirm → execute model:\n\n| Phase | Record | Replay |\n|---|---|---|\n| `propose_plan` | Full plan JSON + planning stream | Feed recorded plan stream; skip LLM |\n| `confirm_plan` | Approval metadata | Inject fixed approval |\n| `execute_plan` | Per-subagent streams | Replay subagent fixtures in parallel |\n\n### C. Transport abstraction\n\n```typescript\ninterface AgentTransport {\n  create(options: CreateOptions): Promise<AgentHandle>;\n  stream(handle: AgentHandle): AsyncIterable<SDKMessage>;\n}\n\nclass LiveSdkTransport implements AgentTransport { /* @cursor/sdk */ }\nclass FixtureReplayTransport implements AgentTransport { /* read fixtures/ */ }\n```\n\nTests inject `FixtureReplayTransport`; production uses `LiveSdkTransport`.\n\n### D. Fixture layout (suggested)\n\n```\nfixtures/\n  proposed_plan/\n    simple-refactor/\n      meta.json           # mode, model, cwd\n      plan.json           # proposed plan artifact\n      events.ndjson       # one SDKMessage per line\n      expected.json       # optional assertions\n```\n\n### E. Determinism checklist\n\n- Strip or normalize: `timestamp`, `runId`, `agentId`, token counts\n- Use stable ordering for parallel subagent events (e.g. sort by `label` + `sequence`)\n- Fixed `idempotency_key` on sends\n- Mock filesystem/git side effects in replay mode\n\n---\n\n## 8. What you can do next\n\nThis workspace has nothing to extend yet. To proceed you would need either:\n\n1. **The parent `t3-orchestrator-v2` repo** cloned or copied into this workspace, or  \n2. **Agent mode** to scaffold the recorder/replayer/fixture layout from scratch.\n\nIf you have the orchestrator source elsewhere, point me at that repo (or switch to Agent mode with it checked out) and I can map concrete files, existing types, and exact hook points instead of this inferred architecture."}}],"agentId":"95b8b4ba-cc91-4455-9389-9729e569f76b","isBackground":false,"durationMs":45981,"backgroundReason":"unspecified"}}},"modelCallId":"12792358-9978-4430-839d-d1aa84ab7471-0-yjwv"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":1912}}}
+{"type":"emit_inbound","label":"thinking-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"thinking-delta","text":"The codebase is empty"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":5}}}
+{"type":"emit_inbound","label":"thinking-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"thinking-delta","text":" aside from a README."}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":5}}}
+{"type":"emit_inbound","label":"thinking-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"thinking-delta","text":" I will draft a proposed"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":6}}}
+{"type":"emit_inbound","label":"thinking-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"thinking-delta","text":" plan for deterministic"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":6}}}
+{"type":"emit_inbound","label":"thinking-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"thinking-delta","text":" replay fixtures."}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":4}}}
+{"type":"emit_inbound","label":"thinking-completed","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"thinking-completed","thinkingDurationMs":562}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"text-delta","text":"Checking agent"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":4}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"text-delta","text":" transcripts for"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":4}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"text-delta","text":" prior context on this"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":5}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"text-delta","text":" task"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"text-delta","text":".\n"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":4}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":5}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":41}}}
+{"type":"emit_inbound","label":"tool-call-started","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"tool-call-started","callId":"tool_2fcd3afc-c41d-42ca-9978-6944952eba2","toolCall":{"type":"glob","args":{"globPattern":"**/*","targetDirectory":"/Users/julius/.cursor/projects/var-folders-b3-b51-pdxj7dl0t981zpqkxxhr0000gn-T-t3-orchestrator-v2-cursor-agent-sdk-record-proposed-plan-ggwFWW/agent-transcripts"}},"modelCallId":"12792358-9978-4430-839d-d1aa84ab7471-1-e5et"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":31}}}
+{"type":"emit_inbound","label":"tool-call-started","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"tool-call-started","callId":"tool_240db1e2-13d0-4012-9b2a-90ad32b0ec5","toolCall":{"type":"read","args":{"path":"/tmp/cursor-replay-proposed_plan/README.md"}},"modelCallId":"12792358-9978-4430-839d-d1aa84ab7471-1-e5et"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":107}}}
+{"type":"emit_inbound","label":"tool-call-completed","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"tool-call-completed","callId":"tool_240db1e2-13d0-4012-9b2a-90ad32b0ec5","toolCall":{"type":"read","args":{"path":"/tmp/cursor-replay-proposed_plan/README.md"},"result":{"status":"success","value":{"content":"# cursor-agent-sdk-record-proposed_plan\n","totalLines":2,"fileSize":40}}},"modelCallId":"12792358-9978-4430-839d-d1aa84ab7471-1-e5et"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":10}}}
+{"type":"emit_inbound","label":"thinking-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"thinking-delta","text":"The workspace is empty."}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":5}}}
+{"type":"emit_inbound","label":"thinking-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"thinking-delta","text":" I am drafting a short"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":6}}}
+{"type":"emit_inbound","label":"thinking-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"thinking-delta","text":" implementation plan"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":5}}}
+{"type":"emit_inbound","label":"thinking-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"thinking-delta","text":" for deterministic replay"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":6}}}
+{"type":"emit_inbound","label":"thinking-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"thinking-delta","text":" fixtures based on typical"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":7}}}
+{"type":"emit_inbound","label":"thinking-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"thinking-delta","text":" Cursor Agent SDK and"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":5}}}
+{"type":"emit_inbound","label":"thinking-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"thinking-delta","text":" orchestrator patterns."}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":6}}}
+{"type":"emit_inbound","label":"thinking-completed","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"thinking-completed","thinkingDurationMs":1027}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"text-delta","text":"The"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"text-delta","text":" repo is a"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":3}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"text-delta","text":" greenfield scaffold;"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":5}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"text-delta","text":" drafting"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"text-delta","text":" a concise"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":3}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"text-delta","text":" plan"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"text-delta","text":" from the project"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":4}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"text-delta","text":" name and standard"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":5}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"text-delta","text":" Cursor Agent SDK replay"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":6}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"text-delta","text":" patterns"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"text-delta","text":".\n"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"partial-tool-call","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"partial-tool-call","callId":"tool_27b151a5-1a11-410a-a412-5325c4f7d2c","toolCall":{"type":"createPlan","args":{"plan":""}},"modelCallId":"12792358-9978-4430-839d-d1aa84ab7471-2-z9b0"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":8}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":3}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":49}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"partial-tool-call","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"partial-tool-call","callId":"tool_27b151a5-1a11-410a-a412-5325c4f7d2c","toolCall":{"type":"createPlan","args":{"plan":"# Deterministic Replay Fixtures for `proposed_plan`\n\n## Context\n\nThe workspace is a greenfield scaffold ([README.md](README.md)). This plan introduces the minimum structure to **record** plan-mode SDK streams and **replay** them as fixtures for deterministic tests.\n\n## Architecture\n\n```mermaid\nflowchart LR\n  subgraph live [Live mode]\n    Prompt --> LiveTransport\n    LiveTransport --> SDK[\"Cursor Agent SDK\"]\n    SDK --> Recorder\n    Recorder --> Consumer\n    Recorder --> FixtureFile\n  end\n\n  subgraph replay [Replay mode]\n    FixtureFile2[Fixture file] --> ReplayTransport\n    ReplayTransport --> Consumer2[Same consumer code]\n  end\n```\n\n**Key idea:** Orchestrator code consumes `AsyncIterable<SDKMessage>` from a transport interface; production uses live SDK, tests use fixture replay.\n\n## 1. Define core types\n\nAdd [`src/replay/types.ts`](src/replay/types.ts):\n\n- `ProposedPlanFixture` — `{ name, input: { prompt, mode: \"plan\" }, events: SDKMessage[], plan?: unknown, meta: { model?, cwd? } }`\n- `AgentTransport` — `{ create(opts), stream(handle): AsyncIterable<SDKMessage> }`\n- `RecordOptions` / `ReplayOptions` — fixture path, normalize flag\n\nReuse SDK message shapes from `@cursor/agent-sdk` (or a thin local mirror) so fixtures stay aligned with `run.stream()` output.\n\n## 2. Fixture format and layout\n\n```\nfixtures/proposed_plan/\n  <case-name>/\n    meta.json      # input prompt, mode, model, cwd\n    events.ndjson  # one SDKMessage per line (post-normalization)\n    plan.json      # extracted proposed plan artifact (optional convenience)\n    expected.json  # optional assertions (status, plan hash, key fields)\n```\n\n- NDJSON keeps diffs readable and supports streaming replay.\n- Commit normalized fixtures only (no secrets, no absolute paths).\n\n## 3. Normalization for determinism\n\nAdd [`src/replay/normalize.ts`](src/replay/normalize.ts) to strip or replace volatile fields before write/compare:\n\n- Timestamps, run/agent IDs, token counts, latency fields\n- Sort parallel sub-events by stable key (`type` + `sequence` or `label`)\n- Replace cwd/home with placeholders (e.g. `$WORKSPACE`)\n\nApply normalization in both **recorder** (on write) and **test assertions** (on compare).\n\n## 4. Implement recorder\n\nAdd [`src/replay/recorder.ts`](src/replay/recorder.ts):\n\n- Wrap live `AgentTransport.stream()` and tee events to consumer + buffer\n- On stream end, extract `proposed_plan` payload from terminal plan message(s)\n- Write fixture directory via `writeFixture(name, data)`\n\nCLI entrypoint [`src/cli/record-fixture.ts`](src/cli/record-fixture.ts):\n\n```bash\npnpm record-fixture --name simple-refactor --prompt \"...\" --mode plan\n```\n\n## 5. Implement replay transport\n\nAdd [`src/replay/replay-transport.ts`](src/replay/replay-transport.ts):\n\n- Load fixture by name/path\n- Yield `events.ndjson` lines as `SDKMessage` with configurable tick delay (default 0)\n- Implement `AgentTransport` so orchestrator plan flow is unchanged\n\nWire via env or factory in [`src/transport/index.ts`](src/transport/index.ts):\n\n```typescript\nexport function createTransport(): AgentTransport {\n  return process.env.REPLAY_FIXTURE\n    ? new ReplayTransport(process.env.REPLAY_FIXTURE)\n    : new LiveSdkTransport();\n}\n```\n\n## 6. Orchestrator hook: `proposed_plan`\n\nAdd [`src/orchestrator/propose-plan.ts`](src/orchestrator/propose-plan.ts):\n\n1. `createTransport()` → `create({ mode: \"plan\", prompt })`\n2. Consume stream until plan-complete message\n3. Return parsed plan + raw events (for optional inline recording in dev)\n\nThis is the single integration point both live and replay modes share.\n\n## 7. Deterministic tests\n\nAdd [`tests/replay/proposed-plan.test.ts`](tests/replay/proposed-plan.test.ts):\n\n- Set `REPLAY_FIXTURE=fixtures/proposed_plan/simple-refactor`\n- Run `proposePlan(prompt)` and assert:\n  - Stable plan hash or snapshot of normalized `plan.json`\n  - Expected status from `expected.json`\n- Add one golden fixture recorded from a real run, then lock behavior\n\nUse Vitest (or project-standard runner) with `fixtures/` as test data.\n\n## 8. Deliverables (minimal scope)\n\n| File | Purpose |\n|------|---------|\n| `src/replay/types.ts` | Shared fixture + transport types |\n| `src/replay/normalize.ts` | Deterministic field stripping |\n| `src/replay/recorder.ts` | Live capture → fixture |\n| `src/replay/replay-transport.ts` | Fixture → stream |\n| `src/transport/live-sdk-transport.ts` | Thin SDK wrapper |\n| `src/orchestrator/propose-plan.ts` | Plan-mode orchestration |\n| `src/cli/record-fixture.ts` | One-shot recording CLI |\n| `fixtures/proposed_plan/simple-refactor/` | Seed fixture |\n| `tests/replay/proposed-plan.test.ts` | Replay regression test |\n\n## Success criteria\n\n- Same orchestrator code path works in live and replay modes.\n- Re-running replay tests produces identical normalized plan output across machines.\n- New fixtures can be recorded with one CLI command and committed as NDJSON + JSON.\n"}},"modelCallId":"12792358-9978-4430-839d-d1aa84ab7471-2-z9b0"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":1261}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":3}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":155}}}
+{"type":"emit_inbound","label":"tool-call-started","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"tool-call-started","callId":"tool_27b151a5-1a11-410a-a412-5325c4f7d2c","toolCall":{"type":"createPlan","args":{"plan":"# Deterministic Replay Fixtures for `proposed_plan`\n\n## Context\n\nThe workspace is a greenfield scaffold ([README.md](README.md)). This plan introduces the minimum structure to **record** plan-mode SDK streams and **replay** them as fixtures for deterministic tests.\n\n## Architecture\n\n```mermaid\nflowchart LR\n  subgraph live [Live mode]\n    Prompt --> LiveTransport\n    LiveTransport --> SDK[\"Cursor Agent SDK\"]\n    SDK --> Recorder\n    Recorder --> Consumer\n    Recorder --> FixtureFile\n  end\n\n  subgraph replay [Replay mode]\n    FixtureFile2[Fixture file] --> ReplayTransport\n    ReplayTransport --> Consumer2[Same consumer code]\n  end\n```\n\n**Key idea:** Orchestrator code consumes `AsyncIterable<SDKMessage>` from a transport interface; production uses live SDK, tests use fixture replay.\n\n## 1. Define core types\n\nAdd [`src/replay/types.ts`](src/replay/types.ts):\n\n- `ProposedPlanFixture` — `{ name, input: { prompt, mode: \"plan\" }, events: SDKMessage[], plan?: unknown, meta: { model?, cwd? } }`\n- `AgentTransport` — `{ create(opts), stream(handle): AsyncIterable<SDKMessage> }`\n- `RecordOptions` / `ReplayOptions` — fixture path, normalize flag\n\nReuse SDK message shapes from `@cursor/agent-sdk` (or a thin local mirror) so fixtures stay aligned with `run.stream()` output.\n\n## 2. Fixture format and layout\n\n```\nfixtures/proposed_plan/\n  <case-name>/\n    meta.json      # input prompt, mode, model, cwd\n    events.ndjson  # one SDKMessage per line (post-normalization)\n    plan.json      # extracted proposed plan artifact (optional convenience)\n    expected.json  # optional assertions (status, plan hash, key fields)\n```\n\n- NDJSON keeps diffs readable and supports streaming replay.\n- Commit normalized fixtures only (no secrets, no absolute paths).\n\n## 3. Normalization for determinism\n\nAdd [`src/replay/normalize.ts`](src/replay/normalize.ts) to strip or replace volatile fields before write/compare:\n\n- Timestamps, run/agent IDs, token counts, latency fields\n- Sort parallel sub-events by stable key (`type` + `sequence` or `label`)\n- Replace cwd/home with placeholders (e.g. `$WORKSPACE`)\n\nApply normalization in both **recorder** (on write) and **test assertions** (on compare).\n\n## 4. Implement recorder\n\nAdd [`src/replay/recorder.ts`](src/replay/recorder.ts):\n\n- Wrap live `AgentTransport.stream()` and tee events to consumer + buffer\n- On stream end, extract `proposed_plan` payload from terminal plan message(s)\n- Write fixture directory via `writeFixture(name, data)`\n\nCLI entrypoint [`src/cli/record-fixture.ts`](src/cli/record-fixture.ts):\n\n```bash\npnpm record-fixture --name simple-refactor --prompt \"...\" --mode plan\n```\n\n## 5. Implement replay transport\n\nAdd [`src/replay/replay-transport.ts`](src/replay/replay-transport.ts):\n\n- Load fixture by name/path\n- Yield `events.ndjson` lines as `SDKMessage` with configurable tick delay (default 0)\n- Implement `AgentTransport` so orchestrator plan flow is unchanged\n\nWire via env or factory in [`src/transport/index.ts`](src/transport/index.ts):\n\n```typescript\nexport function createTransport(): AgentTransport {\n  return process.env.REPLAY_FIXTURE\n    ? new ReplayTransport(process.env.REPLAY_FIXTURE)\n    : new LiveSdkTransport();\n}\n```\n\n## 6. Orchestrator hook: `proposed_plan`\n\nAdd [`src/orchestrator/propose-plan.ts`](src/orchestrator/propose-plan.ts):\n\n1. `createTransport()` → `create({ mode: \"plan\", prompt })`\n2. Consume stream until plan-complete message\n3. Return parsed plan + raw events (for optional inline recording in dev)\n\nThis is the single integration point both live and replay modes share.\n\n## 7. Deterministic tests\n\nAdd [`tests/replay/proposed-plan.test.ts`](tests/replay/proposed-plan.test.ts):\n\n- Set `REPLAY_FIXTURE=fixtures/proposed_plan/simple-refactor`\n- Run `proposePlan(prompt)` and assert:\n  - Stable plan hash or snapshot of normalized `plan.json`\n  - Expected status from `expected.json`\n- Add one golden fixture recorded from a real run, then lock behavior\n\nUse Vitest (or project-standard runner) with `fixtures/` as test data.\n\n## 8. Deliverables (minimal scope)\n\n| File | Purpose |\n|------|---------|\n| `src/replay/types.ts` | Shared fixture + transport types |\n| `src/replay/normalize.ts` | Deterministic field stripping |\n| `src/replay/recorder.ts` | Live capture → fixture |\n| `src/replay/replay-transport.ts` | Fixture → stream |\n| `src/transport/live-sdk-transport.ts` | Thin SDK wrapper |\n| `src/orchestrator/propose-plan.ts` | Plan-mode orchestration |\n| `src/cli/record-fixture.ts` | One-shot recording CLI |\n| `fixtures/proposed_plan/simple-refactor/` | Seed fixture |\n| `tests/replay/proposed-plan.test.ts` | Replay regression test |\n\n## Success criteria\n\n- Same orchestrator code path works in live and replay modes.\n- Re-running replay tests produces identical normalized plan output across machines.\n- New fixtures can be recorded with one CLI command and committed as NDJSON + JSON.\n"}},"modelCallId":"12792358-9978-4430-839d-d1aa84ab7471-2-z9b0"}}}
+{"type":"emit_inbound","label":"tool-call-completed","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"tool-call-completed","callId":"tool_27b151a5-1a11-410a-a412-5325c4f7d2c","toolCall":{"type":"createPlan","args":{"plan":"# Deterministic Replay Fixtures for `proposed_plan`\n\n## Context\n\nThe workspace is a greenfield scaffold ([README.md](README.md)). This plan introduces the minimum structure to **record** plan-mode SDK streams and **replay** them as fixtures for deterministic tests.\n\n## Architecture\n\n```mermaid\nflowchart LR\n  subgraph live [Live mode]\n    Prompt --> LiveTransport\n    LiveTransport --> SDK[\"Cursor Agent SDK\"]\n    SDK --> Recorder\n    Recorder --> Consumer\n    Recorder --> FixtureFile\n  end\n\n  subgraph replay [Replay mode]\n    FixtureFile2[Fixture file] --> ReplayTransport\n    ReplayTransport --> Consumer2[Same consumer code]\n  end\n```\n\n**Key idea:** Orchestrator code consumes `AsyncIterable<SDKMessage>` from a transport interface; production uses live SDK, tests use fixture replay.\n\n## 1. Define core types\n\nAdd [`src/replay/types.ts`](src/replay/types.ts):\n\n- `ProposedPlanFixture` — `{ name, input: { prompt, mode: \"plan\" }, events: SDKMessage[], plan?: unknown, meta: { model?, cwd? } }`\n- `AgentTransport` — `{ create(opts), stream(handle): AsyncIterable<SDKMessage> }`\n- `RecordOptions` / `ReplayOptions` — fixture path, normalize flag\n\nReuse SDK message shapes from `@cursor/agent-sdk` (or a thin local mirror) so fixtures stay aligned with `run.stream()` output.\n\n## 2. Fixture format and layout\n\n```\nfixtures/proposed_plan/\n  <case-name>/\n    meta.json      # input prompt, mode, model, cwd\n    events.ndjson  # one SDKMessage per line (post-normalization)\n    plan.json      # extracted proposed plan artifact (optional convenience)\n    expected.json  # optional assertions (status, plan hash, key fields)\n```\n\n- NDJSON keeps diffs readable and supports streaming replay.\n- Commit normalized fixtures only (no secrets, no absolute paths).\n\n## 3. Normalization for determinism\n\nAdd [`src/replay/normalize.ts`](src/replay/normalize.ts) to strip or replace volatile fields before write/compare:\n\n- Timestamps, run/agent IDs, token counts, latency fields\n- Sort parallel sub-events by stable key (`type` + `sequence` or `label`)\n- Replace cwd/home with placeholders (e.g. `$WORKSPACE`)\n\nApply normalization in both **recorder** (on write) and **test assertions** (on compare).\n\n## 4. Implement recorder\n\nAdd [`src/replay/recorder.ts`](src/replay/recorder.ts):\n\n- Wrap live `AgentTransport.stream()` and tee events to consumer + buffer\n- On stream end, extract `proposed_plan` payload from terminal plan message(s)\n- Write fixture directory via `writeFixture(name, data)`\n\nCLI entrypoint [`src/cli/record-fixture.ts`](src/cli/record-fixture.ts):\n\n```bash\npnpm record-fixture --name simple-refactor --prompt \"...\" --mode plan\n```\n\n## 5. Implement replay transport\n\nAdd [`src/replay/replay-transport.ts`](src/replay/replay-transport.ts):\n\n- Load fixture by name/path\n- Yield `events.ndjson` lines as `SDKMessage` with configurable tick delay (default 0)\n- Implement `AgentTransport` so orchestrator plan flow is unchanged\n\nWire via env or factory in [`src/transport/index.ts`](src/transport/index.ts):\n\n```typescript\nexport function createTransport(): AgentTransport {\n  return process.env.REPLAY_FIXTURE\n    ? new ReplayTransport(process.env.REPLAY_FIXTURE)\n    : new LiveSdkTransport();\n}\n```\n\n## 6. Orchestrator hook: `proposed_plan`\n\nAdd [`src/orchestrator/propose-plan.ts`](src/orchestrator/propose-plan.ts):\n\n1. `createTransport()` → `create({ mode: \"plan\", prompt })`\n2. Consume stream until plan-complete message\n3. Return parsed plan + raw events (for optional inline recording in dev)\n\nThis is the single integration point both live and replay modes share.\n\n## 7. Deterministic tests\n\nAdd [`tests/replay/proposed-plan.test.ts`](tests/replay/proposed-plan.test.ts):\n\n- Set `REPLAY_FIXTURE=fixtures/proposed_plan/simple-refactor`\n- Run `proposePlan(prompt)` and assert:\n  - Stable plan hash or snapshot of normalized `plan.json`\n  - Expected status from `expected.json`\n- Add one golden fixture recorded from a real run, then lock behavior\n\nUse Vitest (or project-standard runner) with `fixtures/` as test data.\n\n## 8. Deliverables (minimal scope)\n\n| File | Purpose |\n|------|---------|\n| `src/replay/types.ts` | Shared fixture + transport types |\n| `src/replay/normalize.ts` | Deterministic field stripping |\n| `src/replay/recorder.ts` | Live capture → fixture |\n| `src/replay/replay-transport.ts` | Fixture → stream |\n| `src/transport/live-sdk-transport.ts` | Thin SDK wrapper |\n| `src/orchestrator/propose-plan.ts` | Plan-mode orchestration |\n| `src/cli/record-fixture.ts` | One-shot recording CLI |\n| `fixtures/proposed_plan/simple-refactor/` | Seed fixture |\n| `tests/replay/proposed-plan.test.ts` | Replay regression test |\n\n## Success criteria\n\n- Same orchestrator code path works in live and replay modes.\n- Re-running replay tests produces identical normalized plan output across machines.\n- New fixtures can be recorded with one CLI command and committed as NDJSON + JSON.\n"},"result":{"status":"success","value":{}}},"modelCallId":"12792358-9978-4430-839d-d1aa84ab7471-2-z9b0"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"token-delta","tokens":7}}}
+{"type":"emit_inbound","label":"step-completed","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"step-completed","stepId":11,"stepDurationMs":54858}}}
+{"type":"emit_inbound","label":"turn-ended","frame":{"type":"interaction.update","runId":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","update":{"type":"turn-ended","usage":{"inputTokens":41151,"outputTokens":2171,"cacheReadTokens":30336,"cacheWriteTokens":0}}}}
+{"type":"emit_inbound","label":"run.completed:1","frame":{"type":"run.completed","result":{"id":"run-6fc6c9f5-f2b7-4f6e-8922-d479f68e7710","requestId":"12792358-9978-4430-839d-d1aa84ab7471","status":"finished","result":"The repo is a greenfield scaffold; drafting a concise plan from the project name and standard Cursor Agent SDK replay patterns.\n","model":{"id":"composer-2.5"},"durationMs":57537}}}
+{"type":"expect_outbound","label":"agent.close","frame":{"type":"agent.close","agentId":"agent-bc5d59e0-bc8b-441a-9292-b49dfff962d3"}}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/proposed_plan/input.ts b/apps/server/src/orchestration-v2/testkit/fixtures/proposed_plan/input.ts
new file mode 100644
index 000000000000..6d880c2f5c3d
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/proposed_plan/input.ts
@@ -0,0 +1,8 @@
+import { PROPOSED_PLAN_PROMPT, type OrchestratorFixtureInput } from "../shared.ts";
+
+export function proposedPlanInput(): OrchestratorFixtureInput {
+  return {
+    interactionMode: "plan",
+    steps: [{ type: "message", text: PROPOSED_PLAN_PROMPT }],
+  };
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/provider_thread_resume/codex_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/provider_thread_resume/codex_transcript.ndjson
new file mode 100644
index 000000000000..dd86c03706e5
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/provider_thread_resume/codex_transcript.ndjson
@@ -0,0 +1,78 @@
+{"type":"transcript_start","provider":"codex","protocol":"codex.app-server","version":"0.120.0","scenario":"provider_thread_resume","metadata":{"source":"codex-app-server-probe","fileName":"provider_thread_resume.ndjson","description":"One provider-native thread is started, completed, then resumed by thread id in a fresh app-server session."}}
+{"type":"expect_outbound","label":"initialize","frame":{"id":1,"method":"initialize","params":{"capabilities":{"experimentalApi":true},"clientInfo":{"name":"t3code_desktop","title":"T3 Code Desktop","version":"0.1.0"}}}}
+{"type":"emit_inbound","label":"initialize","frame":{"id":1,"result":{"userAgent":"t3code_desktop/0.120.0 (Mac OS 26.4.1; arm64) dumb (t3code_desktop; 0.1.0)","codexHome":"/Users/julius/.codex","platformFamily":"unix","platformOs":"macos"}}}
+{"type":"expect_outbound","label":"initialized","frame":{"method":"initialized"}}
+{"type":"expect_outbound","label":"thread/start","frame":{"id":2,"method":"thread/start","params":{}}}
+{"type":"emit_inbound","label":"thread/start","frame":{"id":2,"result":{"thread":{"id":"019db117-b50d-7a01-a6b6-65e47d749c3e","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1776792614,"updatedAt":1776792614,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/04/21/rollout-2026-04-21T10-30-14-019db117-b50d-7a01-a6b6-65e47d749c3e.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1","cliVersion":"0.120.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]},"model":"gpt-5.3-codex","modelProvider":"openai","serviceTier":"fast","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1","approvalPolicy":"on-request","approvalsReviewer":"user","sandbox":{"type":"workspaceWrite","writableRoots":["/Users/julius/.codex/memories"],"readOnlyAccess":{"type":"fullAccess"},"networkAccess":false,"excludeTmpdirEnvVar":false,"excludeSlashTmp":false},"reasoningEffort":"xhigh"}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":3,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Respond with exactly: provider thread resume fixture first turn complete","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"type":"dangerFullAccess"},"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"thread/started","frame":{"method":"thread/started","params":{"thread":{"id":"019db117-b50d-7a01-a6b6-65e47d749c3e","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1776792614,"updatedAt":1776792614,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/04/21/rollout-2026-04-21T10-30-14-019db117-b50d-7a01-a6b6-65e47d749c3e.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1","cliVersion":"0.120.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]}}}}
+{"type":"emit_inbound","label":"deprecationNotice","frame":{"method":"deprecationNotice","params":{"summary":"`[features].collab` is deprecated. Use `[features].multi_agent` instead.","details":"Enable it with `--enable multi_agent` or `[features].multi_agent` in config.toml. See https://developers.openai.com/codex/config-basic#feature-flags for details."}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":3,"result":{"turn":{"id":"019db117-b519-7fa3-85c8-7762b26478a7","items":[],"status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turn":{"id":"019db117-b519-7fa3-85c8-7762b26478a7","items":[],"status":"inProgress","error":null,"startedAt":1776792614,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"ae32c5a2-6bec-4610-99f2-7827af1bb75b","content":[{"type":"text","text":"Respond with exactly: provider thread resume fixture first turn complete","text_elements":[]}]},"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-b519-7fa3-85c8-7762b26478a7"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"ae32c5a2-6bec-4610-99f2-7827af1bb75b","content":[{"type":"text","text":"Respond with exactly: provider thread resume fixture first turn complete","text_elements":[]}]},"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-b519-7fa3-85c8-7762b26478a7"}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":8,"windowDurationMins":300,"resetsAt":1776799966},"secondary":{"usedPercent":2,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"reasoning","id":"rs_06068603eaa6e1e70169e7b42dd9fc819696b725f447365db0","summary":[],"content":[]},"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-b519-7fa3-85c8-7762b26478a7"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"reasoning","id":"rs_06068603eaa6e1e70169e7b42dd9fc819696b725f447365db0","summary":[],"content":[]},"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-b519-7fa3-85c8-7762b26478a7"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_06068603eaa6e1e70169e7b42e9cac819687b02433006e736b","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-b519-7fa3-85c8-7762b26478a7"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-b519-7fa3-85c8-7762b26478a7","itemId":"msg_06068603eaa6e1e70169e7b42e9cac819687b02433006e736b","delta":"provider"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-b519-7fa3-85c8-7762b26478a7","itemId":"msg_06068603eaa6e1e70169e7b42e9cac819687b02433006e736b","delta":" thread"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-b519-7fa3-85c8-7762b26478a7","itemId":"msg_06068603eaa6e1e70169e7b42e9cac819687b02433006e736b","delta":" resume"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-b519-7fa3-85c8-7762b26478a7","itemId":"msg_06068603eaa6e1e70169e7b42e9cac819687b02433006e736b","delta":" fixture"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-b519-7fa3-85c8-7762b26478a7","itemId":"msg_06068603eaa6e1e70169e7b42e9cac819687b02433006e736b","delta":" first"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-b519-7fa3-85c8-7762b26478a7","itemId":"msg_06068603eaa6e1e70169e7b42e9cac819687b02433006e736b","delta":" turn"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-b519-7fa3-85c8-7762b26478a7","itemId":"msg_06068603eaa6e1e70169e7b42e9cac819687b02433006e736b","delta":" complete"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_06068603eaa6e1e70169e7b42e9cac819687b02433006e736b","text":"provider thread resume fixture first turn complete","phase":"final_answer","memoryCitation":null},"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-b519-7fa3-85c8-7762b26478a7"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-b519-7fa3-85c8-7762b26478a7","tokenUsage":{"total":{"totalTokens":25863,"inputTokens":25810,"cachedInputTokens":4480,"outputTokens":53,"reasoningOutputTokens":40},"last":{"totalTokens":25863,"inputTokens":25810,"cachedInputTokens":4480,"outputTokens":53,"reasoningOutputTokens":40},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":8,"windowDurationMins":300,"resetsAt":1776799966},"secondary":{"usedPercent":2,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turn":{"id":"019db117-b519-7fa3-85c8-7762b26478a7","items":[],"status":"completed","error":null,"startedAt":1776792614,"completedAt":1776792622,"durationMs":8794}}}}
+{"type":"runtime_exit","status":"success"}
+{"type":"expect_outbound","label":"initialize","frame":{"id":1,"method":"initialize","params":{"capabilities":{"experimentalApi":true},"clientInfo":{"name":"t3code_desktop","title":"T3 Code Desktop","version":"0.1.0"}}}}
+{"type":"emit_inbound","label":"initialize","frame":{"id":1,"result":{"userAgent":"t3code_desktop/0.120.0 (Mac OS 26.4.1; arm64) dumb (t3code_desktop; 0.1.0)","codexHome":"/Users/julius/.codex","platformFamily":"unix","platformOs":"macos"}}}
+{"type":"expect_outbound","label":"initialized","frame":{"method":"initialized"}}
+{"type":"expect_outbound","label":"thread/resume","frame":{"id":2,"method":"thread/resume","params":{"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e"}}}
+{"type":"emit_inbound","label":"deprecationNotice","frame":{"method":"deprecationNotice","params":{"summary":"`[features].collab` is deprecated. Use `[features].multi_agent` instead.","details":"Enable it with `--enable multi_agent` or `[features].multi_agent` in config.toml. See https://developers.openai.com/codex/config-basic#feature-flags for details."}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"thread/resume","frame":{"id":2,"result":{"thread":{"id":"019db117-b50d-7a01-a6b6-65e47d749c3e","forkedFromId":null,"preview":"Respond with exactly: provider thread resume fixture first turn complete","ephemeral":false,"modelProvider":"openai","createdAt":1776792614,"updatedAt":1776792622,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/04/21/rollout-2026-04-21T10-30-14-019db117-b50d-7a01-a6b6-65e47d749c3e.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1","cliVersion":"0.120.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":{"sha":"7eefb2eb1d98f6b814c9fd7f43652727059c3326","branch":"t3code/codex-turn-mapping","originUrl":"git@github.com:pingdotgg/t3code.git"},"name":null,"turns":[{"id":"019db117-b519-7fa3-85c8-7762b26478a7","items":[{"type":"userMessage","id":"item-1","content":[{"type":"text","text":"Respond with exactly: provider thread resume fixture first turn complete","text_elements":[]}]},{"type":"agentMessage","id":"item-2","text":"provider thread resume fixture first turn complete","phase":"final_answer","memoryCitation":null}],"status":"completed","error":null,"startedAt":1776792614,"completedAt":1776792622,"durationMs":8794}]},"model":"gpt-5.3-codex","modelProvider":"openai","serviceTier":"fast","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1","approvalPolicy":"on-request","approvalsReviewer":"user","sandbox":{"type":"workspaceWrite","writableRoots":["/Users/julius/.codex/memories"],"readOnlyAccess":{"type":"fullAccess"},"networkAccess":false,"excludeTmpdirEnvVar":false,"excludeSlashTmp":false},"reasoningEffort":"xhigh"}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":3,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Using the conversation history available in this resumed thread, first repeat the exact final answer you gave in the previous turn. Then on a new line write exactly: provider thread resume fixture second turn complete","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"type":"dangerFullAccess"},"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":3,"result":{"turn":{"id":"019db117-d7ac-7462-90cf-8e244a290f78","items":[],"status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turn":{"id":"019db117-d7ac-7462-90cf-8e244a290f78","items":[],"status":"inProgress","error":null,"startedAt":1776792623,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"bbc9d0c6-a0cf-420f-8376-64b7b6f2671f","content":[{"type":"text","text":"Using the conversation history available in this resumed thread, first repeat the exact final answer you gave in the previous turn. Then on a new line write exactly: provider thread resume fixture second turn complete","text_elements":[]}]},"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-d7ac-7462-90cf-8e244a290f78"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"bbc9d0c6-a0cf-420f-8376-64b7b6f2671f","content":[{"type":"text","text":"Using the conversation history available in this resumed thread, first repeat the exact final answer you gave in the previous turn. Then on a new line write exactly: provider thread resume fixture second turn complete","text_elements":[]}]},"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-d7ac-7462-90cf-8e244a290f78"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-d7ac-7462-90cf-8e244a290f78","tokenUsage":{"total":{"totalTokens":25863,"inputTokens":25810,"cachedInputTokens":4480,"outputTokens":53,"reasoningOutputTokens":40},"last":{"totalTokens":25863,"inputTokens":25810,"cachedInputTokens":4480,"outputTokens":53,"reasoningOutputTokens":40},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":8,"windowDurationMins":300,"resetsAt":1776799966},"secondary":{"usedPercent":2,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"reasoning","id":"rs_026c2c40daf929d70169e7b43983148195b9f744d3c959d778","summary":[],"content":[]},"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-d7ac-7462-90cf-8e244a290f78"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"reasoning","id":"rs_026c2c40daf929d70169e7b43983148195b9f744d3c959d778","summary":[],"content":[]},"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-d7ac-7462-90cf-8e244a290f78"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_026c2c40daf929d70169e7b43a9ae88195b509f693bda7ff89","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-d7ac-7462-90cf-8e244a290f78"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-d7ac-7462-90cf-8e244a290f78","itemId":"msg_026c2c40daf929d70169e7b43a9ae88195b509f693bda7ff89","delta":"provider"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-d7ac-7462-90cf-8e244a290f78","itemId":"msg_026c2c40daf929d70169e7b43a9ae88195b509f693bda7ff89","delta":" thread"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-d7ac-7462-90cf-8e244a290f78","itemId":"msg_026c2c40daf929d70169e7b43a9ae88195b509f693bda7ff89","delta":" resume"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-d7ac-7462-90cf-8e244a290f78","itemId":"msg_026c2c40daf929d70169e7b43a9ae88195b509f693bda7ff89","delta":" fixture"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-d7ac-7462-90cf-8e244a290f78","itemId":"msg_026c2c40daf929d70169e7b43a9ae88195b509f693bda7ff89","delta":" first"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-d7ac-7462-90cf-8e244a290f78","itemId":"msg_026c2c40daf929d70169e7b43a9ae88195b509f693bda7ff89","delta":" turn"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-d7ac-7462-90cf-8e244a290f78","itemId":"msg_026c2c40daf929d70169e7b43a9ae88195b509f693bda7ff89","delta":" complete"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-d7ac-7462-90cf-8e244a290f78","itemId":"msg_026c2c40daf929d70169e7b43a9ae88195b509f693bda7ff89","delta":"\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-d7ac-7462-90cf-8e244a290f78","itemId":"msg_026c2c40daf929d70169e7b43a9ae88195b509f693bda7ff89","delta":"provider"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-d7ac-7462-90cf-8e244a290f78","itemId":"msg_026c2c40daf929d70169e7b43a9ae88195b509f693bda7ff89","delta":" thread"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-d7ac-7462-90cf-8e244a290f78","itemId":"msg_026c2c40daf929d70169e7b43a9ae88195b509f693bda7ff89","delta":" resume"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-d7ac-7462-90cf-8e244a290f78","itemId":"msg_026c2c40daf929d70169e7b43a9ae88195b509f693bda7ff89","delta":" fixture"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-d7ac-7462-90cf-8e244a290f78","itemId":"msg_026c2c40daf929d70169e7b43a9ae88195b509f693bda7ff89","delta":" second"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-d7ac-7462-90cf-8e244a290f78","itemId":"msg_026c2c40daf929d70169e7b43a9ae88195b509f693bda7ff89","delta":" turn"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-d7ac-7462-90cf-8e244a290f78","itemId":"msg_026c2c40daf929d70169e7b43a9ae88195b509f693bda7ff89","delta":" complete"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_026c2c40daf929d70169e7b43a9ae88195b509f693bda7ff89","text":"provider thread resume fixture first turn complete\nprovider thread resume fixture second turn complete","phase":"final_answer","memoryCitation":null},"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-d7ac-7462-90cf-8e244a290f78"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turnId":"019db117-d7ac-7462-90cf-8e244a290f78","tokenUsage":{"total":{"totalTokens":51845,"inputTokens":51717,"cachedInputTokens":30336,"outputTokens":128,"reasoningOutputTokens":94},"last":{"totalTokens":25982,"inputTokens":25907,"cachedInputTokens":25856,"outputTokens":75,"reasoningOutputTokens":54},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":8,"windowDurationMins":300,"resetsAt":1776799966},"secondary":{"usedPercent":2,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019db117-b50d-7a01-a6b6-65e47d749c3e","turn":{"id":"019db117-d7ac-7462-90cf-8e244a290f78","items":[],"status":"completed","error":null,"startedAt":1776792623,"completedAt":1776792634,"durationMs":11956}}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/provider_thread_resume/cursor_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/provider_thread_resume/cursor_transcript.ndjson
new file mode 100644
index 000000000000..5adf0d528c19
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/provider_thread_resume/cursor_transcript.ndjson
@@ -0,0 +1,60 @@
+{"type":"transcript_start","provider":"cursor","protocol":"cursor-agent-sdk.local","version":"1","scenario":"provider_thread_resume","metadata":{"generatedBy":"recordCursorAgentSdkReplayTranscript","nativeAgentId":"agent-06c9d7f0-c6a5-4194-b204-8aa8ddb04d10"}}
+{"type":"expect_outbound","label":"agent.open","frame":{"type":"agent.open","operation":"create","options":{"model":{"id":"composer-2.5"},"hasName":true,"mode":"agent","local":{"hasCwd":true,"autoReview":false,"sandboxEnabled":false,"enableAgentRetries":true}}}}
+{"type":"emit_inbound","label":"agent.opened","frame":{"type":"agent.opened","agentId":"agent-06c9d7f0-c6a5-4194-b204-8aa8ddb04d10"}}
+{"type":"expect_outbound","label":"run.start:1","frame":{"type":"run.start","message":"Respond with exactly: provider thread resume fixture first turn complete","options":{"model":{"id":"composer-2.5"},"mode":"agent"}}}
+{"type":"emit_inbound","label":"run.started:1","frame":{"type":"run.started","runId":"run-2aa4fc7d-3102-4d95-b449-2fb5e8703b5b","agentId":"agent-06c9d7f0-c6a5-4194-b204-8aa8ddb04d10"}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-2aa4fc7d-3102-4d95-b449-2fb5e8703b5b","update":{"type":"text-delta","text":"provider"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-2aa4fc7d-3102-4d95-b449-2fb5e8703b5b","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-2aa4fc7d-3102-4d95-b449-2fb5e8703b5b","update":{"type":"text-delta","text":" thread"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-2aa4fc7d-3102-4d95-b449-2fb5e8703b5b","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-2aa4fc7d-3102-4d95-b449-2fb5e8703b5b","update":{"type":"text-delta","text":" resume"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-2aa4fc7d-3102-4d95-b449-2fb5e8703b5b","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-2aa4fc7d-3102-4d95-b449-2fb5e8703b5b","update":{"type":"text-delta","text":" fixture"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-2aa4fc7d-3102-4d95-b449-2fb5e8703b5b","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-2aa4fc7d-3102-4d95-b449-2fb5e8703b5b","update":{"type":"text-delta","text":" first"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-2aa4fc7d-3102-4d95-b449-2fb5e8703b5b","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-2aa4fc7d-3102-4d95-b449-2fb5e8703b5b","update":{"type":"text-delta","text":" turn"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-2aa4fc7d-3102-4d95-b449-2fb5e8703b5b","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-2aa4fc7d-3102-4d95-b449-2fb5e8703b5b","update":{"type":"text-delta","text":" complete"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-2aa4fc7d-3102-4d95-b449-2fb5e8703b5b","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"step-completed","frame":{"type":"interaction.update","runId":"run-2aa4fc7d-3102-4d95-b449-2fb5e8703b5b","update":{"type":"step-completed","stepId":1,"stepDurationMs":766}}}
+{"type":"emit_inbound","label":"turn-ended","frame":{"type":"interaction.update","runId":"run-2aa4fc7d-3102-4d95-b449-2fb5e8703b5b","update":{"type":"turn-ended","usage":{"inputTokens":10274,"outputTokens":45,"cacheReadTokens":1856,"cacheWriteTokens":0}}}}
+{"type":"emit_inbound","label":"run.completed:1","frame":{"type":"run.completed","result":{"id":"run-2aa4fc7d-3102-4d95-b449-2fb5e8703b5b","requestId":"ff15a3d5-de92-4d4c-ae3d-2b627b3d4839","status":"finished","result":"provider thread resume fixture first turn complete","model":{"id":"composer-2.5"},"durationMs":5298}}}
+{"type":"expect_outbound","label":"agent.close:before-prompt-2","frame":{"type":"agent.close","agentId":"agent-06c9d7f0-c6a5-4194-b204-8aa8ddb04d10"}}
+{"type":"expect_outbound","label":"agent.resume:before-prompt-2","frame":{"type":"agent.open","operation":"resume","agentId":"agent-06c9d7f0-c6a5-4194-b204-8aa8ddb04d10","options":{"model":{"id":"composer-2.5"},"hasName":true,"mode":"agent","local":{"hasCwd":true,"autoReview":false,"sandboxEnabled":false,"enableAgentRetries":true}}}}
+{"type":"emit_inbound","label":"agent.resumed:before-prompt-2","frame":{"type":"agent.opened","agentId":"agent-06c9d7f0-c6a5-4194-b204-8aa8ddb04d10"}}
+{"type":"expect_outbound","label":"run.start:2","frame":{"type":"run.start","message":"Using the conversation history available in this resumed thread, first repeat the exact final answer you gave in the previous turn. Then on a new line write exactly: provider thread resume fixture second turn complete","options":{"model":{"id":"composer-2.5"},"mode":"agent"}}}
+{"type":"emit_inbound","label":"run.started:2","frame":{"type":"run.started","runId":"run-57e0a96b-f734-4919-b59a-8fbdfa9a8880","agentId":"agent-06c9d7f0-c6a5-4194-b204-8aa8ddb04d10"}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-57e0a96b-f734-4919-b59a-8fbdfa9a8880","update":{"type":"text-delta","text":"provider"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-57e0a96b-f734-4919-b59a-8fbdfa9a8880","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-57e0a96b-f734-4919-b59a-8fbdfa9a8880","update":{"type":"text-delta","text":" thread"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-57e0a96b-f734-4919-b59a-8fbdfa9a8880","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-57e0a96b-f734-4919-b59a-8fbdfa9a8880","update":{"type":"text-delta","text":" resume"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-57e0a96b-f734-4919-b59a-8fbdfa9a8880","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-57e0a96b-f734-4919-b59a-8fbdfa9a8880","update":{"type":"text-delta","text":" fixture"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-57e0a96b-f734-4919-b59a-8fbdfa9a8880","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-57e0a96b-f734-4919-b59a-8fbdfa9a8880","update":{"type":"text-delta","text":" first"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-57e0a96b-f734-4919-b59a-8fbdfa9a8880","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-57e0a96b-f734-4919-b59a-8fbdfa9a8880","update":{"type":"text-delta","text":" turn"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-57e0a96b-f734-4919-b59a-8fbdfa9a8880","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-57e0a96b-f734-4919-b59a-8fbdfa9a8880","update":{"type":"text-delta","text":" complete"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-57e0a96b-f734-4919-b59a-8fbdfa9a8880","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-57e0a96b-f734-4919-b59a-8fbdfa9a8880","update":{"type":"text-delta","text":"\n"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-57e0a96b-f734-4919-b59a-8fbdfa9a8880","update":{"type":"text-delta","text":"provider"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-57e0a96b-f734-4919-b59a-8fbdfa9a8880","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-57e0a96b-f734-4919-b59a-8fbdfa9a8880","update":{"type":"text-delta","text":" thread"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-57e0a96b-f734-4919-b59a-8fbdfa9a8880","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-57e0a96b-f734-4919-b59a-8fbdfa9a8880","update":{"type":"text-delta","text":" resume"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-57e0a96b-f734-4919-b59a-8fbdfa9a8880","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-57e0a96b-f734-4919-b59a-8fbdfa9a8880","update":{"type":"text-delta","text":" fixture"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-57e0a96b-f734-4919-b59a-8fbdfa9a8880","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-57e0a96b-f734-4919-b59a-8fbdfa9a8880","update":{"type":"text-delta","text":" second"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-57e0a96b-f734-4919-b59a-8fbdfa9a8880","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-57e0a96b-f734-4919-b59a-8fbdfa9a8880","update":{"type":"text-delta","text":" turn"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-57e0a96b-f734-4919-b59a-8fbdfa9a8880","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-57e0a96b-f734-4919-b59a-8fbdfa9a8880","update":{"type":"text-delta","text":" complete"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-57e0a96b-f734-4919-b59a-8fbdfa9a8880","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"step-completed","frame":{"type":"interaction.update","runId":"run-57e0a96b-f734-4919-b59a-8fbdfa9a8880","update":{"type":"step-completed","stepId":1,"stepDurationMs":773}}}
+{"type":"emit_inbound","label":"turn-ended","frame":{"type":"interaction.update","runId":"run-57e0a96b-f734-4919-b59a-8fbdfa9a8880","update":{"type":"turn-ended","usage":{"inputTokens":10369,"outputTokens":101,"cacheReadTokens":10304,"cacheWriteTokens":0}}}}
+{"type":"emit_inbound","label":"run.completed:2","frame":{"type":"run.completed","result":{"id":"run-57e0a96b-f734-4919-b59a-8fbdfa9a8880","requestId":"3822e867-4c17-44fb-81b9-e0f3d76b0c87","status":"finished","result":"provider thread resume fixture first turn complete\nprovider thread resume fixture second turn complete","model":{"id":"composer-2.5"},"durationMs":4461}}}
+{"type":"expect_outbound","label":"agent.close","frame":{"type":"agent.close","agentId":"agent-06c9d7f0-c6a5-4194-b204-8aa8ddb04d10"}}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/queued_cancelled_while_active/codex_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/queued_cancelled_while_active/codex_output.ts
new file mode 100644
index 000000000000..9f20f064257e
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/queued_cancelled_while_active/codex_output.ts
@@ -0,0 +1,42 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import { assertBaseProjection, projectionFor } from "../shared.ts";
+import { ACTIVE_RUN_SHELL_SNAPSHOT_KEY } from "./input.ts";
+
+export function assertQueuedCancelledWhileActiveOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({
+    result,
+    transcript,
+    runCount: 2,
+    runStatuses: ["completed", "cancelled"],
+    providerTurnCountAtLeast: 1,
+  });
+
+  const projection = projectionFor(result, transcript.scenario);
+  const activeRun = projection.runs[0];
+  const cancelledRun = projection.runs[1];
+  assert.isDefined(activeRun);
+  assert.isDefined(cancelledRun);
+  assert.isNull(cancelledRun.startedAt);
+  const cancelledMessage = projection.messages.find(
+    (message) => message.id === cancelledRun.userMessageId,
+  );
+  assert.isDefined(cancelledMessage);
+  assert.equal(cancelledMessage.createdBy, "agent");
+  assert.equal(cancelledMessage.creationSource, "server");
+
+  const capturedShell = result.capturedShellSnapshots
+    .get(ACTIVE_RUN_SHELL_SNAPSHOT_KEY)
+    ?.threads.find((thread) => thread.id === projection.thread.id);
+  assert.isDefined(capturedShell);
+  assert.equal(capturedShell.latestRunId, cancelledRun.id);
+  assert.equal(capturedShell.status, "cancelled");
+  assert.equal(capturedShell.activeRunId, activeRun.id);
+  assert.equal(capturedShell.activityRunStatus, "running");
+  assert.deepEqual(capturedShell.pendingBackgroundTasks, []);
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/queued_cancelled_while_active/input.ts b/apps/server/src/orchestration-v2/testkit/fixtures/queued_cancelled_while_active/input.ts
new file mode 100644
index 000000000000..a8e0ba7651cc
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/queued_cancelled_while_active/input.ts
@@ -0,0 +1,25 @@
+import {
+  MULTI_TURN_FIRST_PROMPT,
+  MULTI_TURN_SECOND_PROMPT,
+  type OrchestratorFixtureInput,
+} from "../shared.ts";
+
+export const ACTIVE_RUN_SHELL_SNAPSHOT_KEY = "active-run-over-cancelled-latest";
+
+export function queuedCancelledWhileActiveInput(): OrchestratorFixtureInput {
+  return {
+    steps: [
+      { type: "message", text: MULTI_TURN_FIRST_PROMPT },
+      {
+        type: "queue_message",
+        text: MULTI_TURN_SECOND_PROMPT,
+        createdBy: "agent",
+        creationSource: "server",
+      },
+      { type: "cancel_queued_run", targetRunIndex: 2 },
+      { type: "await_run_status", targetRunIndex: 1, status: "running" },
+      { type: "capture_shell_snapshot", key: ACTIVE_RUN_SHELL_SNAPSHOT_KEY },
+      { type: "release_replay_gate", label: "turn/completed" },
+    ],
+  };
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/queued_turn/claude_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/queued_turn/claude_transcript.ndjson
new file mode 100644
index 000000000000..ed3dd64c83eb
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/queued_turn/claude_transcript.ndjson
@@ -0,0 +1,14 @@
+{"type":"transcript_start","provider":"claudeAgent","protocol":"claude-agent-sdk.query","version":"0.2.111","scenario":"queued_turn","metadata":{"prompts":["Respond with exactly: first fixture turn complete","Respond with exactly: second fixture turn complete"],"model":"claude-sonnet-4-6","nativeSessionId":"df83c769-3523-4961-95ad-9739bfdf71dd","queryMode":"streaming","tools":"claude_code","permissionMode":"bypassPermissions","generatedBy":"recordClaudeAgentSdkReplayTranscript"}}
+{"type":"expect_outbound","label":"query.open","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"sessionId":"df83c769-3523-4961-95ad-9739bfdf71dd"}}}
+{"type":"expect_outbound","label":"prompt.offer:1","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Respond with exactly: first fixture turn complete"},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"cbcb8e66-b64a-49c2-a192-5928cf12f605","hook_name":"SessionStart:startup","hook_event":"SessionStart","uuid":"e1ba5cbc-e83f-452d-a12e-2decc801d1df","session_id":"df83c769-3523-4961-95ad-9739bfdf71dd"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"cbcb8e66-b64a-49c2-a192-5928cf12f605","hook_name":"SessionStart:startup","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"9a8d10e1-b662-44f5-873a-cddcb1f95cd0","session_id":"df83c769-3523-4961-95ad-9739bfdf71dd"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.111","cwd":"/tmp/claude-replay-queued_turn","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"86533c51-7a5a-4034-b94f-12b1b6dd6472","session_id":"df83c769-3523-4961-95ad-9739bfdf71dd"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01NQEE1Hdycdhefjehrr9zcz","type":"message","role":"assistant","content":[{"type":"text","text":"first fixture turn complete"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":2337,"cache_read_input_tokens":9455,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2337},"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"df83c769-3523-4961-95ad-9739bfdf71dd","uuid":"284c2284-4cd0-4f23-8e0d-32ad924e9227"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed"},"uuid":"ab9548dc-42c4-4c53-bfb3-765384bd3c8c","session_id":"df83c769-3523-4961-95ad-9739bfdf71dd"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":1429,"duration_api_ms":1065,"num_turns":1,"result":"first fixture turn complete","stop_reason":"end_turn","session_id":"df83c769-3523-4961-95ad-9739bfdf71dd","total_cost_usd":0.01171425,"usage":{"input_tokens":3,"cache_creation_input_tokens":2337,"cache_read_input_tokens":9455,"output_tokens":7,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":2337,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[{"input_tokens":3,"output_tokens":7,"cache_read_input_tokens":9455,"cache_creation_input_tokens":2337,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2337},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":3,"outputTokens":7,"cacheReadInputTokens":9455,"cacheCreationInputTokens":2337,"webSearchRequests":0,"costUSD":0.01171425,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"bd5d5c48-b577-45f8-a0ef-d45fce2ab84d"}}
+{"type":"expect_outbound","label":"prompt.offer:2","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Respond with exactly: second fixture turn complete"},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.111","cwd":"/tmp/claude-replay-queued_turn","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"9e812fd7-f51a-49f6-878e-b95360f3da63","session_id":"df83c769-3523-4961-95ad-9739bfdf71dd"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01TLFS8vZYtEwwSUSbBztEFJ","type":"message","role":"assistant","content":[{"type":"text","text":"second fixture turn complete"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":19,"cache_read_input_tokens":11792,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":19},"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"df83c769-3523-4961-95ad-9739bfdf71dd","uuid":"39376d80-6475-4fbc-a95c-b005f83dcfee"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":1866,"duration_api_ms":2133,"num_turns":1,"result":"second fixture turn complete","stop_reason":"end_turn","session_id":"df83c769-3523-4961-95ad-9739bfdf71dd","total_cost_usd":0.0154371,"usage":{"input_tokens":3,"cache_creation_input_tokens":19,"cache_read_input_tokens":11792,"output_tokens":7,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":19,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[{"input_tokens":3,"output_tokens":7,"cache_read_input_tokens":11792,"cache_creation_input_tokens":19,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":19},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":6,"outputTokens":14,"cacheReadInputTokens":21247,"cacheCreationInputTokens":2356,"webSearchRequests":0,"costUSD":0.0154371,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"5e21b6c3-b1e0-4d8c-a106-d34a14e941ee"}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/queued_turn/codex_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/queued_turn/codex_output.ts
new file mode 100644
index 000000000000..5eac40193b57
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/queued_turn/codex_output.ts
@@ -0,0 +1,49 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertAssistantTextIncludes,
+  assertBaseProjection,
+  assertConversationMessageRoles,
+  assertRunOrdinals,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessageInputIntents,
+  assertUserMessagesInclude,
+  assertVisibleTurnItemsMirrorLocalTurnItems,
+  MULTI_TURN_FIRST_PROMPT,
+  MULTI_TURN_SECOND_PROMPT,
+  projectionFor,
+} from "../shared.ts";
+
+export function assertQueuedTurnOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({
+    result,
+    transcript,
+    runCount: 2,
+    runStatuses: ["completed", "completed"],
+  });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertVisibleTurnItemsMirrorLocalTurnItems(projection);
+  assertRunOrdinals(projection, [1, 2]);
+  assertConversationMessageRoles(projection, ["user", "assistant", "user", "assistant"]);
+  assertTurnItemTypes(projection, ["user_message", "assistant_message"]);
+  assertUserMessagesInclude(projection, [MULTI_TURN_FIRST_PROMPT, MULTI_TURN_SECOND_PROMPT]);
+  assertUserMessageInputIntents(projection, ["turn_start", "queued_turn"]);
+  assert.equal(projection.turnItems.filter((item) => item.type === "user_message").length, 2);
+  assertAssistantTextIncludes(projection, "first fixture turn complete");
+  assertAssistantTextIncludes(projection, "second fixture turn complete");
+
+  const run2Events = result.domainEvents
+    .filter((event) => event.type === "run.created" || event.type === "run.updated")
+    .filter((event) => event.runId === projection.runs[1]?.id);
+  assert.equal(run2Events[0]?.type, "run.created");
+  assert.equal(run2Events[0]?.payload.status, "queued");
+  assert.isTrue(run2Events.some((event) => event.payload.status === "running"));
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/queued_turn/codex_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/queued_turn/codex_transcript.ndjson
new file mode 100644
index 000000000000..f26e022651c2
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/queued_turn/codex_transcript.ndjson
@@ -0,0 +1,52 @@
+{"type":"transcript_start","provider":"codex","protocol":"codex.app-server","version":"0.120.0","scenario":"queued_turn","metadata":{"source":"codex-app-server-probe","fileName":"queued_turn.ndjson","description":"One thread with a queued second user turn."}}
+{"type":"expect_outbound","label":"initialize","frame":{"id":1,"method":"initialize","params":{"capabilities":{"experimentalApi":true},"clientInfo":{"name":"t3code_desktop","title":"T3 Code Desktop","version":"0.1.0"}}}}
+{"type":"emit_inbound","label":"initialize","frame":{"id":1,"result":{"userAgent":"t3code_desktop/0.120.0 (Mac OS 26.4.1; arm64) dumb (t3code_desktop; 0.1.0)","codexHome":"/Users/julius/.codex","platformFamily":"unix","platformOs":"macos"}}}
+{"type":"expect_outbound","label":"initialized","frame":{"method":"initialized"}}
+{"type":"expect_outbound","label":"thread/start","frame":{"id":2,"method":"thread/start","params":{}}}
+{"type":"emit_inbound","label":"thread/start","frame":{"id":2,"result":{"thread":{"id":"019dadec-c14b-7b13-b96c-92c98ccfc342","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1776739467,"updatedAt":1776739467,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/04/20/rollout-2026-04-20T19-44-27-019dadec-c14b-7b13-b96c-92c98ccfc342.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","cliVersion":"0.120.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]},"model":"gpt-5.4","modelProvider":"openai","serviceTier":"fast","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","approvalPolicy":"on-request","approvalsReviewer":"user","sandbox":{"type":"workspaceWrite","writableRoots":["/Users/julius/.codex/memories"],"readOnlyAccess":{"type":"fullAccess"},"networkAccess":false,"excludeTmpdirEnvVar":false,"excludeSlashTmp":false},"reasoningEffort":"xhigh"}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":3,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Respond with exactly: first fixture turn complete","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"type":"dangerFullAccess"},"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"thread/started","frame":{"method":"thread/started","params":{"thread":{"id":"019dadec-c14b-7b13-b96c-92c98ccfc342","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1776739467,"updatedAt":1776739467,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/04/20/rollout-2026-04-20T19-44-27-019dadec-c14b-7b13-b96c-92c98ccfc342.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","cliVersion":"0.120.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]}}}}
+{"type":"emit_inbound","label":"deprecationNotice","frame":{"method":"deprecationNotice","params":{"summary":"`[features].collab` is deprecated. Use `[features].multi_agent` instead.","details":"Enable it with `--enable multi_agent` or `[features].multi_agent` in config.toml. See https://developers.openai.com/codex/config-basic#feature-flags for details."}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":3,"result":{"turn":{"id":"019dadec-c155-74a2-8acc-f9f4ff86c15b","items":[],"status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turn":{"id":"019dadec-c155-74a2-8acc-f9f4ff86c15b","items":[],"status":"inProgress","error":null,"startedAt":1776739467,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"2562fa0b-0d7c-4030-9be5-ece4962d27bd","content":[{"type":"text","text":"Respond with exactly: first fixture turn complete","text_elements":[]}]},"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-c155-74a2-8acc-f9f4ff86c15b"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"2562fa0b-0d7c-4030-9be5-ece4962d27bd","content":[{"type":"text","text":"Respond with exactly: first fixture turn complete","text_elements":[]}]},"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-c155-74a2-8acc-f9f4ff86c15b"}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"reasoning","id":"rs_0110066f30127def0169e6e4920934819996efbb3a16f7bded","summary":[],"content":[]},"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-c155-74a2-8acc-f9f4ff86c15b"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"reasoning","id":"rs_0110066f30127def0169e6e4920934819996efbb3a16f7bded","summary":[],"content":[]},"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-c155-74a2-8acc-f9f4ff86c15b"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_0110066f30127def0169e6e49249948199913f38f859d73ca9","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-c155-74a2-8acc-f9f4ff86c15b"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-c155-74a2-8acc-f9f4ff86c15b","itemId":"msg_0110066f30127def0169e6e49249948199913f38f859d73ca9","delta":"first"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-c155-74a2-8acc-f9f4ff86c15b","itemId":"msg_0110066f30127def0169e6e49249948199913f38f859d73ca9","delta":" fixture"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-c155-74a2-8acc-f9f4ff86c15b","itemId":"msg_0110066f30127def0169e6e49249948199913f38f859d73ca9","delta":" turn"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-c155-74a2-8acc-f9f4ff86c15b","itemId":"msg_0110066f30127def0169e6e49249948199913f38f859d73ca9","delta":" complete"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_0110066f30127def0169e6e49249948199913f38f859d73ca9","text":"first fixture turn complete","phase":"final_answer","memoryCitation":null},"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-c155-74a2-8acc-f9f4ff86c15b"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-c155-74a2-8acc-f9f4ff86c15b","tokenUsage":{"total":{"totalTokens":28248,"inputTokens":28222,"cachedInputTokens":28032,"outputTokens":26,"reasoningOutputTokens":16},"last":{"totalTokens":28248,"inputTokens":28222,"cachedInputTokens":28032,"outputTokens":26,"reasoningOutputTokens":16},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turn":{"id":"019dadec-c155-74a2-8acc-f9f4ff86c15b","items":[],"status":"completed","error":null,"startedAt":1776739467,"completedAt":1776739474,"durationMs":6986}}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":4,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Respond with exactly: second fixture turn complete","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"type":"dangerFullAccess"},"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":4,"result":{"turn":{"id":"019dadec-dca0-7df0-9bc1-5a44135d8735","items":[],"status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turn":{"id":"019dadec-dca0-7df0-9bc1-5a44135d8735","items":[],"status":"inProgress","error":null,"startedAt":1776739474,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"0c4bed3e-fdd2-422c-bc28-4d688a5a9289","content":[{"type":"text","text":"Respond with exactly: second fixture turn complete","text_elements":[]}]},"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-dca0-7df0-9bc1-5a44135d8735"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"0c4bed3e-fdd2-422c-bc28-4d688a5a9289","content":[{"type":"text","text":"Respond with exactly: second fixture turn complete","text_elements":[]}]},"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-dca0-7df0-9bc1-5a44135d8735"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-dca0-7df0-9bc1-5a44135d8735","tokenUsage":{"total":{"totalTokens":28248,"inputTokens":28222,"cachedInputTokens":28032,"outputTokens":26,"reasoningOutputTokens":16},"last":{"totalTokens":28248,"inputTokens":28222,"cachedInputTokens":28032,"outputTokens":26,"reasoningOutputTokens":16},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748633},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335433},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"reasoning","id":"rs_0110066f30127def0169e6e495c82481998e6c7e0925c86cfa","summary":[],"content":[]},"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-dca0-7df0-9bc1-5a44135d8735"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"reasoning","id":"rs_0110066f30127def0169e6e495c82481998e6c7e0925c86cfa","summary":[],"content":[]},"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-dca0-7df0-9bc1-5a44135d8735"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_0110066f30127def0169e6e495f6088199b4c7aad5e1b7d0aa","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-dca0-7df0-9bc1-5a44135d8735"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-dca0-7df0-9bc1-5a44135d8735","itemId":"msg_0110066f30127def0169e6e495f6088199b4c7aad5e1b7d0aa","delta":"second"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-dca0-7df0-9bc1-5a44135d8735","itemId":"msg_0110066f30127def0169e6e495f6088199b4c7aad5e1b7d0aa","delta":" fixture"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-dca0-7df0-9bc1-5a44135d8735","itemId":"msg_0110066f30127def0169e6e495f6088199b4c7aad5e1b7d0aa","delta":" turn"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-dca0-7df0-9bc1-5a44135d8735","itemId":"msg_0110066f30127def0169e6e495f6088199b4c7aad5e1b7d0aa","delta":" complete"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_0110066f30127def0169e6e495f6088199b4c7aad5e1b7d0aa","text":"second fixture turn complete","phase":"final_answer","memoryCitation":null},"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-dca0-7df0-9bc1-5a44135d8735"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turnId":"019dadec-dca0-7df0-9bc1-5a44135d8735","tokenUsage":{"total":{"totalTokens":56514,"inputTokens":56466,"cachedInputTokens":56064,"outputTokens":48,"reasoningOutputTokens":28},"last":{"totalTokens":28266,"inputTokens":28244,"cachedInputTokens":28032,"outputTokens":22,"reasoningOutputTokens":12},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748633},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335433},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019dadec-c14b-7b13-b96c-92c98ccfc342","turn":{"id":"019dadec-dca0-7df0-9bc1-5a44135d8735","items":[],"status":"completed","error":null,"startedAt":1776739474,"completedAt":1776739478,"durationMs":3700}}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/queued_turn/cursor_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/queued_turn/cursor_transcript.ndjson
new file mode 100644
index 000000000000..86448aaa89f8
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/queued_turn/cursor_transcript.ndjson
@@ -0,0 +1,30 @@
+{"type":"transcript_start","provider":"cursor","protocol":"cursor-agent-sdk.local","version":"1","scenario":"queued_turn","metadata":{"generatedBy":"recordCursorAgentSdkReplayTranscript","nativeAgentId":"agent-2c1578fc-9bfb-4db9-91c2-8d6744a8cb4c"}}
+{"type":"expect_outbound","label":"agent.open","frame":{"type":"agent.open","operation":"create","options":{"model":{"id":"composer-2.5"},"hasName":true,"mode":"agent","local":{"hasCwd":true,"autoReview":false,"sandboxEnabled":false,"enableAgentRetries":true}}}}
+{"type":"emit_inbound","label":"agent.opened","frame":{"type":"agent.opened","agentId":"agent-2c1578fc-9bfb-4db9-91c2-8d6744a8cb4c"}}
+{"type":"expect_outbound","label":"run.start:1","frame":{"type":"run.start","message":"Respond with exactly: first fixture turn complete","options":{"model":{"id":"composer-2.5"},"mode":"agent"}}}
+{"type":"emit_inbound","label":"run.started:1","frame":{"type":"run.started","runId":"run-e8e94512-2578-458e-8fcd-3d2c232ed00a","agentId":"agent-2c1578fc-9bfb-4db9-91c2-8d6744a8cb4c"}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-e8e94512-2578-458e-8fcd-3d2c232ed00a","update":{"type":"text-delta","text":"first"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-e8e94512-2578-458e-8fcd-3d2c232ed00a","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-e8e94512-2578-458e-8fcd-3d2c232ed00a","update":{"type":"text-delta","text":" fixture"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-e8e94512-2578-458e-8fcd-3d2c232ed00a","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-e8e94512-2578-458e-8fcd-3d2c232ed00a","update":{"type":"text-delta","text":" turn"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-e8e94512-2578-458e-8fcd-3d2c232ed00a","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-e8e94512-2578-458e-8fcd-3d2c232ed00a","update":{"type":"text-delta","text":" complete"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-e8e94512-2578-458e-8fcd-3d2c232ed00a","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"step-completed","frame":{"type":"interaction.update","runId":"run-e8e94512-2578-458e-8fcd-3d2c232ed00a","update":{"type":"step-completed","stepId":1,"stepDurationMs":884}}}
+{"type":"emit_inbound","label":"turn-ended","frame":{"type":"interaction.update","runId":"run-e8e94512-2578-458e-8fcd-3d2c232ed00a","update":{"type":"turn-ended","usage":{"inputTokens":10397,"outputTokens":41,"cacheReadTokens":448,"cacheWriteTokens":0}}}}
+{"type":"emit_inbound","label":"run.completed:1","frame":{"type":"run.completed","result":{"id":"run-e8e94512-2578-458e-8fcd-3d2c232ed00a","requestId":"b0ca1b65-cdfd-4f50-8698-1924b0521b15","status":"finished","result":"first fixture turn complete","model":{"id":"composer-2.5"},"durationMs":3685}}}
+{"type":"expect_outbound","label":"run.start:2","frame":{"type":"run.start","message":"Respond with exactly: second fixture turn complete","options":{"model":{"id":"composer-2.5"},"mode":"agent"}}}
+{"type":"emit_inbound","label":"run.started:2","frame":{"type":"run.started","runId":"run-28ee8e5c-e5b0-4da3-a793-6ac182da167f","agentId":"agent-2c1578fc-9bfb-4db9-91c2-8d6744a8cb4c"}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-28ee8e5c-e5b0-4da3-a793-6ac182da167f","update":{"type":"text-delta","text":"second"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-28ee8e5c-e5b0-4da3-a793-6ac182da167f","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-28ee8e5c-e5b0-4da3-a793-6ac182da167f","update":{"type":"text-delta","text":" fixture"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-28ee8e5c-e5b0-4da3-a793-6ac182da167f","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-28ee8e5c-e5b0-4da3-a793-6ac182da167f","update":{"type":"text-delta","text":" turn"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-28ee8e5c-e5b0-4da3-a793-6ac182da167f","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-28ee8e5c-e5b0-4da3-a793-6ac182da167f","update":{"type":"text-delta","text":" complete"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-28ee8e5c-e5b0-4da3-a793-6ac182da167f","update":{"type":"token-delta","tokens":3}}}
+{"type":"emit_inbound","label":"step-completed","frame":{"type":"interaction.update","runId":"run-28ee8e5c-e5b0-4da3-a793-6ac182da167f","update":{"type":"step-completed","stepId":1,"stepDurationMs":830}}}
+{"type":"emit_inbound","label":"turn-ended","frame":{"type":"interaction.update","runId":"run-28ee8e5c-e5b0-4da3-a793-6ac182da167f","update":{"type":"turn-ended","usage":{"inputTokens":10458,"outputTokens":29,"cacheReadTokens":10432,"cacheWriteTokens":0}}}}
+{"type":"emit_inbound","label":"run.completed:2","frame":{"type":"run.completed","result":{"id":"run-28ee8e5c-e5b0-4da3-a793-6ac182da167f","requestId":"9e7ec735-db7c-4bdc-b75d-dce82a288678","status":"finished","result":"second fixture turn complete","model":{"id":"composer-2.5"},"durationMs":2467}}}
+{"type":"expect_outbound","label":"agent.close","frame":{"type":"agent.close","agentId":"agent-2c1578fc-9bfb-4db9-91c2-8d6744a8cb4c"}}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/queued_turn/grok_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/queued_turn/grok_transcript.ndjson
new file mode 100644
index 000000000000..a1bfc238bc32
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/queued_turn/grok_transcript.ndjson
@@ -0,0 +1,12 @@
+{"type":"transcript_start","provider":"grok","protocol":"acp.ndjson-jsonrpc","version":"1","scenario":"queued_turn","metadata":{"generatedBy":"protocol-semantic-fixture","nativeSessionId":"grok-replay-session-1"}}
+{"type":"expect_outbound","label":"initialize","frame":{"kind":"request","method":"initialize","params":{"protocolVersion":1,"clientCapabilities":{"fs":{"readTextFile":false,"writeTextFile":false},"terminal":false,"elicitation":{"form":{}}},"clientInfo":{"name":"t3-code","version":"0.0.0"}}}}
+{"type":"emit_inbound","label":"initialized","frame":{"kind":"response","method":"initialize","result":{"protocolVersion":1,"agentCapabilities":{"loadSession":true,"mcpCapabilities":{"http":true,"sse":true},"promptCapabilities":{"audio":false,"embeddedContext":true,"image":false}},"authMethods":[{"id":"replay","name":"Replay"}],"agentInfo":{"name":"grok-replay","version":"1"}}}}
+{"type":"expect_outbound","label":"session.new","frame":{"kind":"request","method":"session/new","params":{"cwd":"<workspace>","mcpServers":"<any>"}}}
+{"type":"emit_inbound","label":"session.created","frame":{"kind":"response","method":"session/new","result":{"sessionId":"grok-replay-session-1","models":{"currentModelId":"grok-build","availableModels":[{"modelId":"grok-build","name":"Grok Build"}]}}}}
+{"type":"expect_outbound","label":"first.prompt","frame":{"kind":"request","method":"session/prompt","params":{"sessionId":"grok-replay-session-1","prompt":[{"type":"text","text":"Respond with exactly: first fixture turn complete"}]}}}
+{"type":"emit_inbound","label":"first.assistant","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"grok-replay-session-1","update":{"sessionUpdate":"agent_message_chunk","content":{"type":"text","text":"first fixture turn complete"}}}}}
+{"type":"emit_inbound","label":"first.completed","frame":{"kind":"response","method":"session/prompt","result":{"stopReason":"end_turn"}}}
+{"type":"expect_outbound","label":"queued.prompt","frame":{"kind":"request","method":"session/prompt","params":{"sessionId":"grok-replay-session-1","prompt":[{"type":"text","text":"Respond with exactly: second fixture turn complete"}]}}}
+{"type":"emit_inbound","label":"queued.assistant","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"grok-replay-session-1","update":{"sessionUpdate":"agent_message_chunk","content":{"type":"text","text":"second fixture turn complete"}}}}}
+{"type":"emit_inbound","label":"queued.completed","frame":{"kind":"response","method":"session/prompt","result":{"stopReason":"end_turn"}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/queued_turn/input.ts b/apps/server/src/orchestration-v2/testkit/fixtures/queued_turn/input.ts
new file mode 100644
index 000000000000..01337a0b2233
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/queued_turn/input.ts
@@ -0,0 +1,14 @@
+import {
+  MULTI_TURN_FIRST_PROMPT,
+  MULTI_TURN_SECOND_PROMPT,
+  type OrchestratorFixtureInput,
+} from "../shared.ts";
+
+export function queuedTurnInput(): OrchestratorFixtureInput {
+  return {
+    steps: [
+      { type: "message", text: MULTI_TURN_FIRST_PROMPT },
+      { type: "queue_message", text: MULTI_TURN_SECOND_PROMPT },
+    ],
+  };
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/shared.ts b/apps/server/src/orchestration-v2/testkit/fixtures/shared.ts
new file mode 100644
index 000000000000..685565c63fd9
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/shared.ts
@@ -0,0 +1,1184 @@
+import { assert } from "@effect/vitest";
+import {
+  type ChatAttachment,
+  CommandId,
+  MessageId,
+  ProjectId,
+  ThreadId,
+  type ModelSelection,
+  type OrchestrationV2Command,
+  type OrchestrationV2ExecutionNode,
+  type OrchestrationV2RunStatus,
+  type OrchestrationV2ThreadProjection,
+  type OrchestrationV2TurnItem,
+  type OrchestrationV2UserMessageInputIntent,
+  ProviderInstanceId,
+  type ProviderInteractionMode,
+  type ProviderDriverKind,
+  type ProviderReplayTranscript,
+  type ProviderUserInputAnswers,
+} from "@t3tools/contracts";
+import type * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+
+import type {
+  OrchestratorV2ScenarioResult,
+  OrchestratorV2ScenarioStep,
+} from "../OrchestratorScenario.ts";
+import { IdAllocatorV2, type IdAllocatorV2Error } from "../../IdAllocator.ts";
+import type { RuntimePolicyV2Override } from "../../RuntimePolicy.ts";
+
+export const SIMPLE_PROMPT = "Respond with the following text: fixture simple ok";
+export const MULTI_TURN_FIRST_PROMPT = "Respond with exactly: first fixture turn complete";
+export const MULTI_TURN_SECOND_PROMPT = "Respond with exactly: second fixture turn complete";
+export const PROVIDER_THREAD_RESUME_FIRST_PROMPT =
+  "Respond with exactly: provider thread resume fixture first turn complete";
+export const PROVIDER_THREAD_RESUME_SECOND_PROMPT =
+  "Using the conversation history available in this resumed thread, first repeat the exact final answer you gave in the previous turn. Then on a new line write exactly: provider thread resume fixture second turn complete";
+export const TOOL_CALL_READ_ONLY_WORKSPACE_ROOT = "/tmp/claude-replay-tool_call_read_only";
+export const TOOL_CALL_READ_ONLY_PROMPT = `Read ${TOOL_CALL_READ_ONLY_WORKSPACE_ROOT}/package.json and ${TOOL_CALL_READ_ONLY_WORKSPACE_ROOT}/tsconfig.json, then answer exactly: read only tool fixture complete`;
+export const CLAUDE_LOCAL_BASH_TASK_PROMPT =
+  "Run a local Bash typecheck command, then answer exactly: claude local bash task fixture complete";
+export const CLAUDE_RESULT_IS_ERROR_PROMPT = "Say hello before the credentials expire.";
+export const CLAUDE_RESULT_IS_ERROR_FOLLOW_UP = "Try again now that auth is back.";
+export const TOOL_CALL_WRITE_PROMPT =
+  "Create or overwrite .codex-probe-write-action.txt with exactly this text: codex app-server approval fixture. Use a local shell command or file edit only, then briefly report what happened. Do not read package metadata, use GitHub, use web, or use MCP.";
+export const MESSAGE_STEERING_INITIAL_PROMPT =
+  "Respond with exactly: steering fixture initial response";
+export const SUBAGENT_PROMPT =
+  "Spawn 2 subagents, one to read package.json and one to read tsconfig.json";
+export const SUBAGENT_V2_PROMPT = "just say hello";
+export const OPENCODE_SUBAGENT_PROMPT =
+  "Use the task tool exactly once. Delegate to the general subagent with this prompt: Respond exactly CHILD_OK. After the task completes, respond exactly PARENT_OK.";
+export const SUBAGENT_CONTINUE_PROMPT =
+  "Spawn one subagent and have it reply exactly: initial subagent response";
+export const SUBAGENT_CONTINUE_PARENT_PROMPT =
+  "@hooke have the same subagent reply exactly: continued subagent response";
+export const SUBAGENT_CONTINUE_CHILD_PROMPT = "Reply exactly: continued subagent response";
+export const TURN_INTERRUPT_PROMPT =
+  "Do not answer immediately. First run the local shell command `sleep 30`, then respond with exactly: interrupt fixture should not finish naturally.";
+export const TURN_INTERRUPT_MID_TOOL_PROMPT =
+  "Run this exact local command: `node -e \"console.log('interrupt fixture tool started'); setTimeout(() => {}, 30000)\"`. Do not answer until it completes, then respond exactly: interrupt fixture should not finish naturally.";
+export const TURN_INTERRUPT_RECOVERY_PROMPT =
+  "Respond with exactly: interrupt recovery fixture complete";
+export const MESSAGE_STEERING_STEER_PROMPT =
+  "Actually, respond with exactly: steering fixture observed";
+export const THREAD_ROLLBACK_FIRST_PROMPT =
+  "Respond with exactly: rollback fixture first turn complete";
+export const THREAD_ROLLBACK_SECOND_PROMPT =
+  "Respond with exactly: rollback fixture second turn complete";
+export const THREAD_ROLLBACK_AFTER_PROMPT = "Repeat the conversation verbatim.";
+export const THREAD_FORK_NATIVE_SOURCE_PROMPT =
+  "Respond with the following text: source fork seed ok";
+export const THREAD_FORK_NATIVE_TARGET_PROMPT = "Respond with the following text: fork native ok";
+export const THREAD_FORK_NATIVE_CONTINUE_SOURCE_MARKER = "source-marker-7Q9V";
+export const THREAD_FORK_NATIVE_CONTINUE_FORK_MARKER = "fork-marker-2K4M";
+export const THREAD_FORK_NATIVE_CONTINUE_RECALL = `${THREAD_FORK_NATIVE_CONTINUE_SOURCE_MARKER}|${THREAD_FORK_NATIVE_CONTINUE_FORK_MARKER}`;
+export const THREAD_FORK_NATIVE_CONTINUE_SOURCE_PROMPT = `Remember the opaque marker ${THREAD_FORK_NATIVE_CONTINUE_SOURCE_MARKER} for later in this conversation. Respond with exactly: source marker stored`;
+export const THREAD_FORK_NATIVE_CONTINUE_FIRST_PROMPT = `Remember the second opaque marker ${THREAD_FORK_NATIVE_CONTINUE_FORK_MARKER} for later in this conversation. Respond with exactly: fork marker stored`;
+export const THREAD_FORK_NATIVE_CONTINUE_SECOND_PROMPT =
+  "Return the two opaque markers previously provided in chronological order, separated by a single | character. Respond with only the markers and separator.";
+export const THREAD_FORK_NATIVE_SIBLINGS_SOURCE_MARKER = "sibling-source-8R3D";
+export const THREAD_FORK_NATIVE_SIBLINGS_FIRST_MARKER = "sibling-first-5L2P";
+export const THREAD_FORK_NATIVE_SIBLINGS_SECOND_MARKER = "sibling-second-9N6C";
+export const THREAD_FORK_NATIVE_SIBLINGS_SOURCE_PROMPT = `Remember the opaque marker ${THREAD_FORK_NATIVE_SIBLINGS_SOURCE_MARKER} for later in this conversation. Respond with exactly: sibling source stored`;
+export const THREAD_FORK_NATIVE_SIBLINGS_FIRST_PROMPT = `Remember the fork-local marker ${THREAD_FORK_NATIVE_SIBLINGS_FIRST_MARKER}. Return the source marker followed by this marker, separated by |. Respond with only the markers and separator.`;
+export const THREAD_FORK_NATIVE_SIBLINGS_SECOND_PROMPT = `Remember the fork-local marker ${THREAD_FORK_NATIVE_SIBLINGS_SECOND_MARKER}. Return the source marker followed by this marker, separated by |. Respond with only the markers and separator.`;
+export const THREAD_MERGE_BACK_SOURCE_MARKER = "merge-source-4H8Q";
+export const THREAD_MERGE_BACK_FORK_MARKER = "merge-fork-7T2W";
+export const THREAD_MERGE_BACK_SOURCE_PROMPT = `Remember the opaque marker ${THREAD_MERGE_BACK_SOURCE_MARKER} for later in this conversation. Respond with exactly: merge source stored`;
+export const THREAD_MERGE_BACK_FORK_PROMPT = `Remember the fork-local marker ${THREAD_MERGE_BACK_FORK_MARKER}. Respond with exactly: merge fork stored`;
+export const THREAD_MERGE_BACK_HANDOFF_PROMPT = [
+  "Context handoff (merge_back / fork_delta_summary):",
+  "Merge-back context from forked conversation.",
+  "",
+  "Fork delta:",
+  `- User introduced opaque marker ${THREAD_MERGE_BACK_FORK_MARKER}.`,
+  "- Assistant confirmed: merge fork stored",
+  "",
+  "User message:",
+  "Retain the transferred fork marker for later. Respond with exactly: merge delta stored",
+].join("\n");
+export const THREAD_MERGE_BACK_RECALL = `${THREAD_MERGE_BACK_SOURCE_MARKER}|${THREAD_MERGE_BACK_FORK_MARKER}`;
+export const THREAD_MERGE_BACK_RECALL_PROMPT =
+  "Return the source marker followed by the transferred fork marker, separated by a single | character. Respond with only the markers and separator.";
+export const THREAD_MERGE_BACK_SIBLINGS_SOURCE_MARKER = "merge-sibling-source-3C7K";
+export const THREAD_MERGE_BACK_SIBLINGS_FIRST_MARKER = "merge-sibling-first-6V2J";
+export const THREAD_MERGE_BACK_SIBLINGS_SECOND_MARKER = "merge-sibling-second-9X5B";
+export const THREAD_MERGE_BACK_SIBLINGS_SOURCE_PROMPT = `Remember the opaque marker ${THREAD_MERGE_BACK_SIBLINGS_SOURCE_MARKER} for later in this conversation. Respond with exactly: merge sibling source stored`;
+export const THREAD_MERGE_BACK_SIBLINGS_FIRST_FORK_PROMPT = `Remember the fork-local marker ${THREAD_MERGE_BACK_SIBLINGS_FIRST_MARKER}. Respond with exactly: first merge sibling stored`;
+export const THREAD_MERGE_BACK_SIBLINGS_SECOND_FORK_PROMPT = `Remember the fork-local marker ${THREAD_MERGE_BACK_SIBLINGS_SECOND_MARKER}. Respond with exactly: second merge sibling stored`;
+export const THREAD_MERGE_BACK_SIBLINGS_FIRST_HANDOFF_PROMPT = [
+  "Context handoff (merge_back / fork_delta_summary):",
+  "Merge-back context from first forked conversation.",
+  "",
+  "Fork delta:",
+  `- User introduced opaque marker ${THREAD_MERGE_BACK_SIBLINGS_FIRST_MARKER}.`,
+  "- Assistant confirmed: first merge sibling stored",
+  "",
+  "User message:",
+  "Retain the first transferred marker for later. Respond with exactly: first merge delta stored",
+].join("\n");
+export const THREAD_MERGE_BACK_SIBLINGS_SECOND_HANDOFF_PROMPT = [
+  "Context handoff (merge_back / fork_delta_summary):",
+  "Merge-back context from second forked conversation.",
+  "",
+  "Fork delta:",
+  `- User introduced opaque marker ${THREAD_MERGE_BACK_SIBLINGS_SECOND_MARKER}.`,
+  "- Assistant confirmed: second merge sibling stored",
+  "",
+  "User message:",
+  "Retain the second transferred marker for later. Respond with exactly: second merge delta stored",
+].join("\n");
+export const THREAD_MERGE_BACK_SIBLINGS_RECALL = [
+  THREAD_MERGE_BACK_SIBLINGS_SOURCE_MARKER,
+  THREAD_MERGE_BACK_SIBLINGS_FIRST_MARKER,
+  THREAD_MERGE_BACK_SIBLINGS_SECOND_MARKER,
+].join("|");
+export const THREAD_MERGE_BACK_SIBLINGS_RECALL_PROMPT =
+  "Return the source marker followed by both transferred fork markers in merge order, separated by single | characters. Respond with only the markers and separators.";
+export const THREAD_FORK_NATIVE_PRIOR_TURN_ALPHA_PROMPT =
+  "For this fork-boundary fixture, respond with exactly: fork boundary alpha";
+export const THREAD_FORK_NATIVE_PRIOR_TURN_BETA_PROMPT =
+  "For this fork-boundary fixture, respond with exactly: fork boundary beta";
+export const THREAD_FORK_NATIVE_PRIOR_TURN_REPEAT_PROMPT =
+  "Repeat the user-visible conversation so far verbatim. Include only user and assistant messages. Do not include hidden system/developer content.";
+export const TODO_LIST_PROMPT =
+  "Use the update_plan tool to track exactly three steps: inspect package.json, inspect tsconfig.json, report completion. Then read package.json and tsconfig.json, and answer exactly: todo list fixture complete";
+export const PLAN_QUESTIONS_PROMPT =
+  "Use request_user_input to ask one multiple-choice clarifying question about whether this fixture should prefer strict schemas or UI flexibility. After receiving the answer, respond exactly: plan questions fixture complete";
+export const PROPOSED_PLAN_PROMPT =
+  "Create a short implementation plan for adding deterministic replay fixtures. Do not ask questions. Present the final plan in a proposed plan block.";
+export const WEB_SEARCH_PROMPT =
+  "Search the web for FIFA World Cup ticket pricing, then answer exactly: web search fixture complete";
+
+export type OrchestratorFixtureInputStep =
+  | {
+      readonly type: "message";
+      readonly text: string;
+      readonly attachments?: ReadonlyArray<ChatAttachment>;
+    }
+  | {
+      readonly type: "queue_message";
+      readonly text: string;
+      readonly attachments?: ReadonlyArray<ChatAttachment>;
+      readonly createdBy?: Extract<
+        OrchestrationV2Command,
+        { readonly type: "message.dispatch" }
+      >["createdBy"];
+      readonly creationSource?: Extract<
+        OrchestrationV2Command,
+        { readonly type: "message.dispatch" }
+      >["creationSource"];
+    }
+  | {
+      readonly type: "cancel_queued_run";
+      readonly targetRunIndex: number;
+    }
+  | {
+      readonly type: "await_run_status";
+      readonly targetRunIndex: number;
+      readonly status: OrchestrationV2RunStatus;
+    }
+  | {
+      readonly type: "capture_shell_snapshot";
+      readonly key: string;
+    }
+  | {
+      readonly type: "release_replay_gate";
+      readonly label: string;
+    }
+  | {
+      readonly type: "steer";
+      readonly text: string;
+      readonly attachments?: ReadonlyArray<ChatAttachment>;
+      readonly targetRunIndex: number;
+    }
+  | {
+      readonly type: "restart";
+      readonly text: string;
+      readonly attachments?: ReadonlyArray<ChatAttachment>;
+      readonly targetRunIndex: number;
+    }
+  | {
+      readonly type: "interrupt";
+      readonly targetRunIndex: number;
+      readonly waitForTurnItemType?: OrchestrationV2TurnItem["type"];
+    }
+  | {
+      readonly type: "release_replay_gate_after_waiting";
+      readonly label: string;
+      readonly targetRunIndex: number;
+    }
+  | {
+      readonly type: "approve_next_runtime_request";
+      readonly decision?: Extract<
+        OrchestrationV2Command,
+        { readonly type: "runtime-request.respond" }
+      >["decision"];
+    }
+  | {
+      readonly type: "answer_next_user_input_request";
+      readonly answers: ProviderUserInputAnswers;
+    }
+  | {
+      readonly type: "rollback";
+      readonly checkpointScopeSuffix: string;
+      readonly checkpointSuffix: string;
+    }
+  | {
+      /**
+       * Advance the deterministic test clock, e.g. past the provider session
+       * manager's idle timeout so the next message must reopen the session.
+       */
+      readonly type: "advance_clock";
+      readonly duration: Duration.Input;
+    };
+
+export interface OrchestratorFixtureInput {
+  readonly interactionMode?: ProviderInteractionMode;
+  readonly steps: ReadonlyArray<OrchestratorFixtureInputStep>;
+}
+
+export interface ProviderOrchestratorReplayVariant {
+  readonly driver: ProviderDriverKind;
+  readonly transcriptFile: URL;
+  readonly recordedScenario?: string;
+  readonly transcriptEntriesThroughLabel?: string;
+  readonly modelSelection: ModelSelection;
+  readonly runtimePolicyOverride?: RuntimePolicyV2Override;
+  readonly assertOutput: (
+    result: OrchestratorV2ScenarioResult,
+    transcript: ProviderReplayTranscript,
+  ) => void;
+}
+
+export interface OrchestratorReplayFixture {
+  readonly name: string;
+  readonly buildInput: () => OrchestratorFixtureInput;
+  readonly providers: ReadonlyArray<ProviderOrchestratorReplayVariant>;
+}
+
+export interface MaterializedOrchestratorFixtureInput {
+  readonly commands: ReadonlyArray<OrchestrationV2Command>;
+  readonly steps: ReadonlyArray<OrchestratorV2ScenarioStep>;
+  readonly projectionThreadIds: ReadonlyArray<ThreadId>;
+}
+
+export interface FixtureIds {
+  readonly threadId: ThreadId;
+  readonly projectId: ProjectId;
+}
+
+export const CODEX_MODEL_SELECTION = {
+  instanceId: ProviderInstanceId.make("codex"),
+  model: "gpt-5.4",
+} satisfies ModelSelection;
+
+export const CLAUDE_MODEL_SELECTION = {
+  instanceId: ProviderInstanceId.make("claudeAgent"),
+  model: "claude-sonnet-4-6",
+} satisfies ModelSelection;
+
+export const CURSOR_MODEL_SELECTION = {
+  instanceId: ProviderInstanceId.make("cursor"),
+  model: "composer-2.5",
+} satisfies ModelSelection;
+
+export const GROK_MODEL_SELECTION = {
+  instanceId: ProviderInstanceId.make("grok"),
+  model: "grok-build",
+} satisfies ModelSelection;
+
+export const OPENCODE_MODEL_SELECTION = {
+  instanceId: ProviderInstanceId.make("opencode"),
+  model: "openai/gpt-5.4-mini",
+  options: [{ id: "agent", value: "build" }],
+} satisfies ModelSelection;
+
+export const ACP_REGISTRY_MODEL_SELECTION = {
+  instanceId: ProviderInstanceId.make("acpRegistry"),
+  model: "default",
+} satisfies ModelSelection;
+
+export const READ_ONLY_ON_REQUEST_POLICY = {
+  approvalPolicy: "on-request",
+  sandboxPolicy: {
+    type: "readOnly",
+    access: { type: "fullAccess" },
+    networkAccess: false,
+  },
+} as const satisfies RuntimePolicyV2Override;
+
+export const READ_ONLY_NEVER_POLICY = {
+  approvalPolicy: "never",
+  sandboxPolicy: {
+    type: "readOnly",
+    access: { type: "fullAccess" },
+    networkAccess: false,
+  },
+} as const satisfies RuntimePolicyV2Override;
+
+export const WORKSPACE_NEVER_POLICY = {
+  approvalPolicy: "never",
+  sandboxPolicy: {
+    type: "workspaceWrite",
+    writableRoots: [],
+    readOnlyAccess: { type: "fullAccess" },
+    networkAccess: false,
+  },
+} as const satisfies RuntimePolicyV2Override;
+
+export const RESTRICTED_GRANULAR_POLICY = {
+  approvalPolicy: {
+    granular: {
+      mcp_elicitations: true,
+      request_permissions: true,
+      rules: true,
+      sandbox_approval: true,
+      skill_approval: true,
+    },
+  },
+  sandboxPolicy: {
+    type: "readOnly",
+    access: {
+      type: "restricted",
+      includePlatformDefaults: false,
+      readableRoots: [],
+    },
+    networkAccess: false,
+  },
+} as const satisfies RuntimePolicyV2Override;
+
+export function createThreadCommand(input: {
+  readonly commandId: CommandId;
+  readonly ids: FixtureIds;
+  readonly scenario: string;
+  readonly modelSelection: ModelSelection;
+  readonly interactionMode?: ProviderInteractionMode;
+}): OrchestrationV2Command {
+  return {
+    type: "thread.create",
+    createdBy: "user",
+    creationSource: "web",
+    commandId: input.commandId,
+    threadId: input.ids.threadId,
+    projectId: input.ids.projectId,
+    title: `Replay fixture: ${input.scenario}`,
+    modelSelection: input.modelSelection,
+    runtimeMode: "full-access",
+    interactionMode: input.interactionMode ?? "default",
+    branch: null,
+    worktreePath: null,
+  };
+}
+
+export function dispatchMessageCommand(input: {
+  readonly commandId: CommandId;
+  readonly ids: FixtureIds;
+  readonly modelSelection: ModelSelection;
+  readonly messageId: MessageId;
+  readonly text: string;
+  readonly attachments?: ReadonlyArray<ChatAttachment>;
+  readonly createdBy?: Extract<
+    OrchestrationV2Command,
+    { readonly type: "message.dispatch" }
+  >["createdBy"];
+  readonly creationSource?: Extract<
+    OrchestrationV2Command,
+    { readonly type: "message.dispatch" }
+  >["creationSource"];
+  readonly dispatchMode?: Extract<
+    OrchestrationV2Command,
+    { readonly type: "message.dispatch" }
+  >["dispatchMode"];
+}): OrchestrationV2Command {
+  return {
+    type: "message.dispatch",
+    createdBy: input.createdBy ?? "user",
+    creationSource: input.creationSource ?? "web",
+    commandId: input.commandId,
+    threadId: input.ids.threadId,
+    messageId: input.messageId,
+    text: input.text,
+    attachments: [...(input.attachments ?? [])],
+    modelSelection: input.modelSelection,
+    dispatchMode: input.dispatchMode ?? { type: "start_immediately" },
+  };
+}
+
+export function materializeFixtureInput(input: {
+  readonly scenario: string;
+  readonly fixtureInput: OrchestratorFixtureInput;
+  readonly driver: ProviderDriverKind;
+  readonly modelSelection: ModelSelection;
+}): Effect.Effect<MaterializedOrchestratorFixtureInput, IdAllocatorV2Error, IdAllocatorV2> {
+  return Effect.gen(function* () {
+    const idAllocator = yield* IdAllocatorV2;
+    const projectId = yield* idAllocator.allocate.project({ fixtureName: input.scenario });
+    const threadId = yield* idAllocator.allocate.thread({
+      fixtureName: input.scenario,
+      projectId,
+    });
+    const ids = { threadId, projectId } satisfies FixtureIds;
+    const commands: Array<OrchestrationV2Command> = [];
+    const steps: Array<OrchestratorV2ScenarioStep> = [];
+    let messageIndex = 0;
+    let runIndex = 0;
+    const activeRunDispatchKeys = new Set<string>();
+
+    const runIdFor = (runOrdinal: number) =>
+      idAllocator.derive.run({ threadId: ids.threadId, ordinal: runOrdinal });
+
+    const pushDispatch = (
+      command: OrchestrationV2Command,
+      options: {
+        readonly await?: boolean;
+        readonly key?: string;
+        readonly advanceClockAfter?: boolean;
+      } = {},
+    ) => {
+      commands.push(command);
+      steps.push({
+        type: "dispatch",
+        command,
+        await: options.await ?? true,
+        ...(options.key === undefined ? {} : { key: options.key }),
+      });
+      if (options.advanceClockAfter ?? true) {
+        steps.push({ type: "advance_clock", duration: "1 millis" });
+      }
+    };
+
+    pushDispatch(
+      createThreadCommand({
+        commandId: yield* idAllocator.allocate.command({
+          fixtureName: input.scenario,
+          commandName: "thread-create",
+        }),
+        ids,
+        scenario: input.scenario,
+        modelSelection: input.modelSelection,
+        ...(input.fixtureInput.interactionMode === undefined
+          ? {}
+          : { interactionMode: input.fixtureInput.interactionMode }),
+      }),
+    );
+
+    for (const [stepIndex, step] of input.fixtureInput.steps.entries()) {
+      switch (step.type) {
+        case "message":
+          messageIndex += 1;
+          runIndex += 1;
+          {
+            const nextStep = input.fixtureInput.steps[stepIndex + 1];
+            const shouldRunInBackground =
+              (nextStep !== undefined &&
+                ((nextStep.type === "interrupt" && nextStep.targetRunIndex === runIndex) ||
+                  nextStep.type === "queue_message" ||
+                  (nextStep.type === "restart" && nextStep.targetRunIndex === runIndex) ||
+                  (nextStep.type === "release_replay_gate_after_waiting" &&
+                    nextStep.targetRunIndex === runIndex))) ||
+              nextStep?.type === "approve_next_runtime_request" ||
+              nextStep?.type === "answer_next_user_input_request";
+            const key = `run:${runIndex}`;
+            pushDispatch(
+              dispatchMessageCommand({
+                commandId: yield* idAllocator.allocate.command({
+                  fixtureName: input.scenario,
+                  commandName: `message-${messageIndex}`,
+                }),
+                ids,
+                modelSelection: input.modelSelection,
+                messageId: yield* idAllocator.allocate.message({
+                  threadId: ids.threadId,
+                  ordinal: messageIndex,
+                }),
+                text: step.text,
+                ...(step.attachments === undefined ? {} : { attachments: step.attachments }),
+              }),
+              shouldRunInBackground ? { await: false, key } : undefined,
+            );
+            if (shouldRunInBackground) {
+              activeRunDispatchKeys.add(key);
+            } else if (
+              !(
+                nextStep !== undefined &&
+                (nextStep.type === "steer" || nextStep.type === "restart") &&
+                nextStep.targetRunIndex === runIndex
+              )
+            ) {
+              steps.push({ type: "await_thread_idle", threadId: ids.threadId });
+            }
+          }
+          break;
+        case "queue_message": {
+          messageIndex += 1;
+          runIndex += 1;
+          const nextStep = input.fixtureInput.steps[stepIndex + 1];
+          pushDispatch(
+            dispatchMessageCommand({
+              commandId: yield* idAllocator.allocate.command({
+                fixtureName: input.scenario,
+                commandName: `queue-message-${messageIndex}`,
+              }),
+              ids,
+              modelSelection: input.modelSelection,
+              messageId: yield* idAllocator.allocate.message({
+                threadId: ids.threadId,
+                ordinal: messageIndex,
+              }),
+              text: step.text,
+              ...(step.createdBy === undefined ? {} : { createdBy: step.createdBy }),
+              ...(step.creationSource === undefined ? {} : { creationSource: step.creationSource }),
+              ...(step.attachments === undefined ? {} : { attachments: step.attachments }),
+              dispatchMode: { type: "queue_after_active" },
+            }),
+          );
+          const shouldSkipQueueBarrier =
+            nextStep?.type === "queue_message" ||
+            (nextStep?.type === "cancel_queued_run" && nextStep.targetRunIndex === runIndex);
+          if (!shouldSkipQueueBarrier) {
+            const queueBarrierKey =
+              Array.from(activeRunDispatchKeys).at(-1) ?? `run:${runIndex - 1}`;
+            activeRunDispatchKeys.delete(queueBarrierKey);
+            steps.push({ type: "await", key: queueBarrierKey });
+            steps.push({ type: "await_thread_idle", threadId: ids.threadId });
+          }
+          break;
+        }
+        case "cancel_queued_run":
+          pushDispatch({
+            type: "queued-run.cancel",
+            commandId: yield* idAllocator.allocate.command({
+              fixtureName: input.scenario,
+              commandName: `cancel-queued-run-${step.targetRunIndex}`,
+            }),
+            threadId: ids.threadId,
+            runId: runIdFor(step.targetRunIndex),
+          });
+          break;
+        case "await_run_status":
+          steps.push({
+            type: "await_run_status",
+            threadId: ids.threadId,
+            runId: runIdFor(step.targetRunIndex),
+            status: step.status,
+          });
+          break;
+        case "capture_shell_snapshot":
+          steps.push({ type: "capture_shell_snapshot", key: step.key });
+          break;
+        case "release_replay_gate":
+          steps.push({ type: "release_replay_gate", label: step.label });
+          break;
+        case "answer_next_user_input_request":
+          pushDispatch(
+            {
+              type: "runtime-request.respond",
+              commandId: yield* idAllocator.allocate.command({
+                fixtureName: input.scenario,
+                commandName: `answer-user-input-request-${messageIndex}`,
+              }),
+              threadId: ids.threadId,
+              requestId: yield* idAllocator.allocate.runtimeRequest({
+                driver: input.driver,
+                nativeRequestId: `fixture-placeholder-${messageIndex}`,
+              }),
+              answers: step.answers,
+            },
+            { advanceClockAfter: false },
+          );
+          steps[steps.length - 1] = {
+            type: "respond_to_next_runtime_request",
+            threadId: ids.threadId,
+            commandId: commands.at(-1)!.commandId,
+            answers: step.answers,
+          };
+          steps.push({ type: "advance_clock", duration: "1 millis" });
+          steps.push({ type: "await_thread_idle", threadId: ids.threadId });
+          break;
+        case "approve_next_runtime_request":
+          pushDispatch(
+            {
+              type: "runtime-request.respond",
+              commandId: yield* idAllocator.allocate.command({
+                fixtureName: input.scenario,
+                commandName: `approve-runtime-request-${messageIndex}`,
+              }),
+              threadId: ids.threadId,
+              requestId: yield* idAllocator.allocate.runtimeRequest({
+                driver: input.driver,
+                nativeRequestId: `fixture-placeholder-${messageIndex}`,
+              }),
+              decision: step.decision ?? "accept",
+            },
+            { advanceClockAfter: false },
+          );
+          steps[steps.length - 1] = {
+            type: "respond_to_next_runtime_request",
+            threadId: ids.threadId,
+            commandId: commands.at(-1)!.commandId,
+            decision: step.decision ?? "accept",
+          };
+          steps.push({ type: "advance_clock", duration: "1 millis" });
+          steps.push({ type: "await_thread_idle", threadId: ids.threadId });
+          break;
+        case "steer":
+          messageIndex += 1;
+          steps.push({
+            type: "await_run_steerable",
+            threadId: ids.threadId,
+            runId: runIdFor(step.targetRunIndex),
+          });
+          pushDispatch(
+            dispatchMessageCommand({
+              commandId: yield* idAllocator.allocate.command({
+                fixtureName: input.scenario,
+                commandName: `steer-${messageIndex}`,
+              }),
+              ids,
+              modelSelection: input.modelSelection,
+              messageId: yield* idAllocator.allocate.message({
+                threadId: ids.threadId,
+                ordinal: messageIndex,
+              }),
+              text: step.text,
+              ...(step.attachments === undefined ? {} : { attachments: step.attachments }),
+              dispatchMode: {
+                type: "steer_active",
+                targetRunId: runIdFor(step.targetRunIndex),
+              },
+            }),
+          );
+          {
+            const nextStepType = input.fixtureInput.steps[stepIndex + 1]?.type;
+            if (
+              nextStepType !== "approve_next_runtime_request" &&
+              nextStepType !== "answer_next_user_input_request"
+            ) {
+              if (activeRunDispatchKeys.delete(`run:${step.targetRunIndex}`)) {
+                steps.push({ type: "await", key: `run:${step.targetRunIndex}` });
+              }
+              steps.push({ type: "await_thread_idle", threadId: ids.threadId });
+            }
+          }
+          break;
+        case "restart":
+          messageIndex += 1;
+          steps.push({
+            type: "await_run_steerable",
+            threadId: ids.threadId,
+            runId: runIdFor(step.targetRunIndex),
+          });
+          pushDispatch(
+            dispatchMessageCommand({
+              commandId: yield* idAllocator.allocate.command({
+                fixtureName: input.scenario,
+                commandName: `restart-${messageIndex}`,
+              }),
+              ids,
+              modelSelection: input.modelSelection,
+              messageId: yield* idAllocator.allocate.message({
+                threadId: ids.threadId,
+                ordinal: messageIndex,
+              }),
+              text: step.text,
+              ...(step.attachments === undefined ? {} : { attachments: step.attachments }),
+              dispatchMode: {
+                type: "restart_active",
+                targetRunId: runIdFor(step.targetRunIndex),
+              },
+            }),
+          );
+          {
+            const nextStepType = input.fixtureInput.steps[stepIndex + 1]?.type;
+            if (
+              nextStepType !== "approve_next_runtime_request" &&
+              nextStepType !== "answer_next_user_input_request"
+            ) {
+              if (activeRunDispatchKeys.delete(`run:${step.targetRunIndex}`)) {
+                steps.push({ type: "await", key: `run:${step.targetRunIndex}` });
+              }
+              steps.push({ type: "await_thread_idle", threadId: ids.threadId });
+            }
+          }
+          break;
+        case "interrupt":
+          steps.push({
+            type: "await_run_steerable",
+            threadId: ids.threadId,
+            runId: runIdFor(step.targetRunIndex),
+          });
+          if (step.waitForTurnItemType !== undefined) {
+            steps.push({
+              type: "await_run_turn_item",
+              threadId: ids.threadId,
+              runId: runIdFor(step.targetRunIndex),
+              itemType: step.waitForTurnItemType,
+            });
+          }
+          pushDispatch(
+            {
+              type: "run.interrupt",
+              commandId: yield* idAllocator.allocate.command({
+                fixtureName: input.scenario,
+                commandName: `interrupt-${step.targetRunIndex}`,
+              }),
+              threadId: ids.threadId,
+              runId: runIdFor(step.targetRunIndex),
+            },
+            { advanceClockAfter: false },
+          );
+          if (activeRunDispatchKeys.delete(`run:${step.targetRunIndex}`)) {
+            steps.push({ type: "await", key: `run:${step.targetRunIndex}` });
+          }
+          steps.push({ type: "advance_clock", duration: "1 millis" });
+          steps.push({ type: "await_thread_idle", threadId: ids.threadId });
+          break;
+        case "release_replay_gate_after_waiting":
+          steps.push({
+            type: "release_replay_gate_after_waiting",
+            label: step.label,
+            threadId: ids.threadId,
+            runId: runIdFor(step.targetRunIndex),
+          });
+          break;
+        case "advance_clock":
+          steps.push({ type: "advance_clock", duration: step.duration });
+          break;
+        case "rollback":
+          {
+            const scopeId = yield* idAllocator.allocate.checkpointScope({
+              threadId: ids.threadId,
+              name: step.checkpointScopeSuffix,
+            });
+            pushDispatch({
+              type: "checkpoint.rollback",
+              commandId: yield* idAllocator.allocate.command({
+                fixtureName: input.scenario,
+                commandName: `rollback-${step.checkpointSuffix}`,
+              }),
+              threadId: ids.threadId,
+              scopeId,
+              checkpointId: yield* idAllocator.allocate.checkpoint({
+                checkpointScopeId: scopeId,
+                name: step.checkpointSuffix,
+              }),
+            });
+          }
+          break;
+      }
+    }
+
+    if (activeRunDispatchKeys.size > 0) {
+      steps.push({ type: "await_all" });
+      steps.push({ type: "await_thread_idle", threadId: ids.threadId });
+    }
+
+    return {
+      commands,
+      steps,
+      projectionThreadIds: [ids.threadId],
+    };
+  });
+}
+
+export function projectionFor(
+  result: OrchestratorV2ScenarioResult,
+  scenario: string,
+): OrchestrationV2ThreadProjection {
+  const projections = [...result.projections.values()].filter(
+    (projection) => projection.thread.lineage.parentThreadId === null,
+  );
+
+  assert.equal(projections.length, 1, `expected one root projection for ${scenario}`);
+  const projection = projections[0];
+  assert.isDefined(projection, `missing projection for ${scenario}`);
+  return projection;
+}
+
+export function assertBaseProjection(input: {
+  readonly result: OrchestratorV2ScenarioResult;
+  readonly transcript: ProviderReplayTranscript;
+  readonly runCount: number;
+  readonly providerTurnCountAtLeast?: number;
+  readonly runStatuses?: ReadonlyArray<OrchestrationV2RunStatus>;
+}) {
+  const projection = projectionFor(input.result, input.transcript.scenario);
+
+  assert.equal(
+    projection.thread.providerInstanceId,
+    ProviderInstanceId.make(input.transcript.provider),
+  );
+  assert.lengthOf(projection.runs, input.runCount);
+  assert.isAtLeast(projection.providerThreads.length, 1);
+  assert.isAtLeast(
+    projection.providerTurns.length,
+    input.providerTurnCountAtLeast ?? input.runCount,
+    `expected provider turns; runs=${projection.runs.map((run) => `${run.id}:${run.status}`).join(",")}; sessions=${projection.providerSessions.map((session) => `${session.id}:${session.status}`).join(",")}; items=${projection.turnItems.map((item) => (item.type === "error" ? `${item.type}:${item.failure.message}` : item.type)).join(",")}`,
+  );
+  assert.isAtLeast(input.result.domainEvents.length, 1);
+  assert.deepEqual(
+    input.result.storedEvents.map((stored) => stored.sequence),
+    input.result.storedEvents.map((_, index) => index + 1),
+  );
+  assert.deepEqual(
+    input.result.storedEvents.map((stored) => stored.event.id),
+    input.result.domainEvents.map((event) => event.id),
+  );
+
+  if (input.runStatuses) {
+    assert.deepEqual(
+      projection.runs.map((run) => run.status),
+      input.runStatuses,
+    );
+  }
+}
+
+export function assertRunOrdinals(
+  projection: OrchestrationV2ThreadProjection,
+  expectedOrdinals: ReadonlyArray<number>,
+) {
+  assert.deepEqual(
+    projection.runs.map((run) => run.ordinal),
+    expectedOrdinals,
+  );
+}
+
+export function assertRunsHaveRootNodes(projection: OrchestrationV2ThreadProjection) {
+  for (const run of projection.runs) {
+    assert.isNotNull(run.rootNodeId, `run ${run.id} must have a root node`);
+    assert.isTrue(
+      projection.nodes.some((node) => node.id === run.rootNodeId && node.kind === "root_turn"),
+      `run ${run.id} root node must exist`,
+    );
+  }
+}
+
+export function assertRootNodesCountForRuns(projection: OrchestrationV2ThreadProjection) {
+  const rootNodes = projection.nodes.filter((node) => node.kind === "root_turn");
+  assert.isAtLeast(rootNodes.length, projection.runs.length);
+  for (const node of rootNodes) {
+    assert.equal(node.countsForRun, true, `root node ${node.id} must count for its app run`);
+  }
+}
+
+export function assertProviderTurnsReferenceNodes(projection: OrchestrationV2ThreadProjection) {
+  for (const providerTurn of projection.providerTurns) {
+    assert.isTrue(
+      projection.nodes.some((node) => node.id === providerTurn.nodeId),
+      `provider turn ${providerTurn.id} must reference an execution node`,
+    );
+    assert.isTrue(
+      projection.providerThreads.some((thread) => thread.id === providerTurn.providerThreadId),
+      `provider turn ${providerTurn.id} must reference a provider thread`,
+    );
+  }
+}
+
+export function assertTurnItemsAreOrdered(projection: OrchestrationV2ThreadProjection) {
+  const ordinals = projection.turnItems.map((item) => item.ordinal);
+  assert.deepEqual(
+    ordinals,
+    [...ordinals].toSorted((left, right) => left - right),
+  );
+}
+
+export function assertTurnItemsReferenceProjection(projection: OrchestrationV2ThreadProjection) {
+  for (const item of projection.turnItems) {
+    if (item.runId !== null) {
+      assert.isTrue(
+        projection.runs.some((run) => run.id === item.runId),
+        `turn item ${item.id} must reference an existing run`,
+      );
+    }
+    if (item.nodeId !== null) {
+      assert.isTrue(
+        projection.nodes.some((node) => node.id === item.nodeId),
+        `turn item ${item.id} must reference an existing node`,
+      );
+    }
+    if (item.providerTurnId !== null) {
+      assert.isTrue(
+        projection.providerTurns.some((turn) => turn.id === item.providerTurnId),
+        `turn item ${item.id} must reference an existing provider turn`,
+      );
+    }
+  }
+}
+
+export function assertVisibleTurnItemsMirrorLocalTurnItems(
+  projection: OrchestrationV2ThreadProjection,
+) {
+  assert.lengthOf(
+    projection.visibleTurnItems,
+    projection.turnItems.length,
+    "non-fork visible turn items must mirror local canonical turn items",
+  );
+
+  for (const [index, item] of projection.turnItems.entries()) {
+    const visibleItem = projection.visibleTurnItems[index];
+    assert.isDefined(visibleItem, `missing visible turn item at position ${index}`);
+    assert.equal(visibleItem.position, index);
+    assert.equal(visibleItem.visibility, "local");
+    assert.equal(visibleItem.sourceThreadId, item.threadId);
+    assert.equal(visibleItem.sourceItemId, item.id);
+    assert.deepEqual(visibleItem.item, item);
+  }
+}
+
+export function assertMessagesReferenceProjection(projection: OrchestrationV2ThreadProjection) {
+  for (const message of projection.messages) {
+    if (message.runId !== null) {
+      assert.isTrue(
+        projection.runs.some((run) => run.id === message.runId),
+        `message ${message.id} must reference an existing run`,
+      );
+    }
+    if (message.nodeId !== null) {
+      assert.isTrue(
+        projection.nodes.some((node) => node.id === message.nodeId),
+        `message ${message.id} must reference an existing node`,
+      );
+    }
+  }
+}
+
+export function assertRuntimeRequestsReferenceProjection(
+  projection: OrchestrationV2ThreadProjection,
+) {
+  for (const request of projection.runtimeRequests) {
+    const requestNode = projection.nodes.find((node) => node.id === request.nodeId);
+    assert.isTrue(
+      requestNode !== undefined,
+      `runtime request ${request.id} must reference an existing node`,
+    );
+    if (
+      requestNode !== undefined &&
+      (request.kind === "command" || request.kind === "file-read" || request.kind === "file-change")
+    ) {
+      assert.equal(
+        requestNode.kind,
+        "approval_request",
+        `runtime request ${request.id} must reference an approval request node`,
+      );
+    }
+    if (request.providerTurnId !== null) {
+      assert.isTrue(
+        projection.providerTurns.some((turn) => turn.id === request.providerTurnId),
+        `runtime request ${request.id} must reference an existing provider turn`,
+      );
+    }
+  }
+}
+
+export function assertSemanticProjectionIntegrity(projection: OrchestrationV2ThreadProjection) {
+  assertRunsHaveRootNodes(projection);
+  assertRootNodesCountForRuns(projection);
+  assertProviderTurnsReferenceNodes(projection);
+  assertTurnItemsAreOrdered(projection);
+  assertTurnItemsReferenceProjection(projection);
+  assertMessagesReferenceProjection(projection);
+  assertRuntimeRequestsReferenceProjection(projection);
+}
+
+export function assertRunProviderTurnCardinality(input: {
+  readonly projection: OrchestrationV2ThreadProjection;
+  readonly rootRunCount: number;
+  readonly providerTurnCountAtLeast?: number;
+}) {
+  assert.lengthOf(input.projection.runs, input.rootRunCount);
+  assert.isAtLeast(
+    input.projection.providerTurns.length,
+    input.providerTurnCountAtLeast ?? input.rootRunCount,
+  );
+}
+
+export function assertNoExtraAppRunsForProviderChildren(input: {
+  readonly projection: OrchestrationV2ThreadProjection;
+  readonly expectedAppRuns: number;
+}) {
+  assert.lengthOf(
+    input.projection.runs,
+    input.expectedAppRuns,
+    "provider child activity must not create additional app runs",
+  );
+}
+
+export function assertExecutionNodeKinds(
+  projection: OrchestrationV2ThreadProjection,
+  expectedKinds: ReadonlyArray<OrchestrationV2ExecutionNode["kind"]>,
+) {
+  const kinds = projection.nodes.map((node) => node.kind);
+  for (const expectedKind of expectedKinds) {
+    assert.include(kinds, expectedKind);
+  }
+}
+
+export function assertTurnItemTypes(
+  projection: OrchestrationV2ThreadProjection,
+  expectedTypes: ReadonlyArray<OrchestrationV2TurnItem["type"]>,
+) {
+  const actualTypes = projection.turnItems.map((item) => item.type);
+  for (const expectedType of expectedTypes) {
+    assert.include(actualTypes, expectedType);
+  }
+}
+
+export function assertTurnItemTypeSequence(
+  projection: OrchestrationV2ThreadProjection,
+  expectedTypes: ReadonlyArray<OrchestrationV2TurnItem["type"]>,
+) {
+  assert.deepEqual(
+    projection.turnItems.map((item) => item.type),
+    expectedTypes,
+  );
+}
+
+export function assertVisibleTurnItemTypeSequence(
+  projection: OrchestrationV2ThreadProjection,
+  expectedTypes: ReadonlyArray<OrchestrationV2TurnItem["type"]>,
+) {
+  assert.deepEqual(
+    projection.visibleTurnItems.map((row) => row.item.type),
+    expectedTypes,
+  );
+}
+
+export function assertAssistantTextIncludes(
+  projection: OrchestrationV2ThreadProjection,
+  expectedText: string,
+) {
+  assert.isTrue(
+    projection.turnItems.some(
+      (item) => item.type === "assistant_message" && item.text.includes(expectedText),
+    ),
+    `expected assistant output to include ${JSON.stringify(expectedText)}`,
+  );
+}
+
+export function assertRuntimeRequestCounts(
+  projection: OrchestrationV2ThreadProjection,
+  expected: { readonly total: number; readonly resolved?: number },
+) {
+  assert.lengthOf(projection.runtimeRequests, expected.total);
+  if (expected.resolved !== undefined) {
+    assert.equal(
+      projection.runtimeRequests.filter((request) => request.status === "resolved").length,
+      expected.resolved,
+    );
+  }
+}
+
+export function countReplayLabelsWithPrefix(
+  transcript: ProviderReplayTranscript,
+  prefix: string,
+): number {
+  return transcript.entries.filter(
+    (entry) => entry.type !== "runtime_exit" && (entry.label?.startsWith(prefix) ?? false),
+  ).length;
+}
+
+export function assertReplayLabelPrefixCount(
+  transcript: ProviderReplayTranscript,
+  prefix: string,
+  expected: number,
+) {
+  assert.equal(countReplayLabelsWithPrefix(transcript, prefix), expected);
+}
+
+export function assertRuntimeRequestKinds(
+  projection: OrchestrationV2ThreadProjection,
+  expectedKinds: ReadonlyArray<string>,
+) {
+  assert.deepEqual(
+    projection.runtimeRequests.map((request) => request.kind),
+    expectedKinds,
+  );
+}
+
+export function assertAllRuntimeRequestsResolved(projection: OrchestrationV2ThreadProjection) {
+  assert.deepEqual(
+    projection.runtimeRequests.map((request) => request.status),
+    projection.runtimeRequests.map(() => "resolved"),
+  );
+}
+
+export function assertConversationMessageRoles(
+  projection: OrchestrationV2ThreadProjection,
+  expectedRoles: ReadonlyArray<string>,
+) {
+  assert.deepEqual(
+    projection.messages.map((message) => message.role),
+    expectedRoles,
+  );
+}
+
+export function assertUserMessagesInclude(
+  projection: OrchestrationV2ThreadProjection,
+  expectedTexts: ReadonlyArray<string>,
+) {
+  for (const expectedText of expectedTexts) {
+    assert.isTrue(
+      projection.turnItems.some(
+        (item) => item.type === "user_message" && item.text.includes(expectedText),
+      ),
+      `expected user input to include ${JSON.stringify(expectedText)}`,
+    );
+  }
+}
+
+export function assertUserMessagesExclude(
+  projection: OrchestrationV2ThreadProjection,
+  rejectedTexts: ReadonlyArray<string>,
+) {
+  for (const rejectedText of rejectedTexts) {
+    assert.isFalse(
+      projection.turnItems.some(
+        (item) => item.type === "user_message" && item.text.includes(rejectedText),
+      ),
+      `expected user input to exclude ${JSON.stringify(rejectedText)}`,
+    );
+  }
+}
+
+export function assertVisibleUserMessagesInclude(
+  projection: OrchestrationV2ThreadProjection,
+  expectedTexts: ReadonlyArray<string>,
+) {
+  for (const expectedText of expectedTexts) {
+    assert.isTrue(
+      projection.visibleTurnItems.some(
+        (row) => row.item.type === "user_message" && row.item.text.includes(expectedText),
+      ),
+      `expected visible user input to include ${JSON.stringify(expectedText)}`,
+    );
+  }
+}
+
+export function assertVisibleUserMessagesExclude(
+  projection: OrchestrationV2ThreadProjection,
+  rejectedTexts: ReadonlyArray<string>,
+) {
+  for (const rejectedText of rejectedTexts) {
+    assert.isFalse(
+      projection.visibleTurnItems.some(
+        (row) => row.item.type === "user_message" && row.item.text.includes(rejectedText),
+      ),
+      `expected visible user input to exclude ${JSON.stringify(rejectedText)}`,
+    );
+  }
+}
+
+export function assertUserMessageInputIntents(
+  projection: OrchestrationV2ThreadProjection,
+  expectedIntents: ReadonlyArray<OrchestrationV2UserMessageInputIntent>,
+) {
+  assert.deepEqual(
+    projection.turnItems
+      .filter((item) => item.type === "user_message")
+      .map((item) => item.inputIntent),
+    expectedIntents,
+  );
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/simple/claude_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/simple/claude_output.ts
new file mode 100644
index 000000000000..ee6aa72f2f9d
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/simple/claude_output.ts
@@ -0,0 +1,33 @@
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertAssistantTextIncludes,
+  assertBaseProjection,
+  assertConversationMessageRoles,
+  assertExecutionNodeKinds,
+  assertRunOrdinals,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessagesInclude,
+  assertVisibleTurnItemsMirrorLocalTurnItems,
+  projectionFor,
+  SIMPLE_PROMPT,
+} from "../shared.ts";
+
+export function assertSimpleClaudeOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({ result, transcript, runCount: 1, runStatuses: ["completed"] });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertVisibleTurnItemsMirrorLocalTurnItems(projection);
+  assertRunOrdinals(projection, [1]);
+  assertExecutionNodeKinds(projection, ["root_turn", "assistant_message"]);
+  assertConversationMessageRoles(projection, ["user", "assistant"]);
+  assertTurnItemTypes(projection, ["user_message", "assistant_message"]);
+  assertUserMessagesInclude(projection, [SIMPLE_PROMPT]);
+  assertAssistantTextIncludes(projection, "fixture simple ok");
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/simple/claude_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/simple/claude_transcript.ndjson
new file mode 100644
index 000000000000..633984e8874a
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/simple/claude_transcript.ndjson
@@ -0,0 +1,10 @@
+{"type":"transcript_start","provider":"claudeAgent","protocol":"claude-agent-sdk.query","version":"0.2.111","scenario":"simple","metadata":{"prompts":["Respond with the following text: fixture simple ok"],"model":"claude-sonnet-4-6","nativeSessionId":"77171d01-fb4f-4dff-a961-d9dd334be93d","queryMode":"streaming","tools":"claude_code","permissionMode":"bypassPermissions","generatedBy":"recordClaudeAgentSdkReplayTranscript"}}
+{"type":"expect_outbound","label":"query.open","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"sessionId":"77171d01-fb4f-4dff-a961-d9dd334be93d"}}}
+{"type":"expect_outbound","label":"prompt.offer:1","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Respond with the following text: fixture simple ok"},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"6402f3ef-506b-4859-b69c-173458c244b3","hook_name":"SessionStart:startup","hook_event":"SessionStart","uuid":"5daa14d4-b571-4451-986a-a9a07d3c277e","session_id":"77171d01-fb4f-4dff-a961-d9dd334be93d"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"6402f3ef-506b-4859-b69c-173458c244b3","hook_name":"SessionStart:startup","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"adfe8057-6178-47bc-945d-b178f5ca578a","session_id":"77171d01-fb4f-4dff-a961-d9dd334be93d"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.111","cwd":"/tmp/claude-replay-simple","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"df4adde0-72a9-49e1-9149-195fe0f629ee","session_id":"77171d01-fb4f-4dff-a961-d9dd334be93d"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01CM449j71BXKjsRZZpW2z64","type":"message","role":"assistant","content":[{"type":"text","text":"fixture simple ok"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":2338,"cache_read_input_tokens":9455,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2338},"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"77171d01-fb4f-4dff-a961-d9dd334be93d","uuid":"502cdf40-1af1-428c-87cb-a07cfc99dafd"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed"},"uuid":"ea562a84-375e-4e8f-ba30-8b98d56122a9","session_id":"77171d01-fb4f-4dff-a961-d9dd334be93d"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":1291,"duration_api_ms":1039,"num_turns":1,"result":"fixture simple ok","stop_reason":"end_turn","session_id":"77171d01-fb4f-4dff-a961-d9dd334be93d","total_cost_usd":0.011703,"usage":{"input_tokens":3,"cache_creation_input_tokens":2338,"cache_read_input_tokens":9455,"output_tokens":6,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":2338,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[{"input_tokens":3,"output_tokens":6,"cache_read_input_tokens":9455,"cache_creation_input_tokens":2338,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2338},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":3,"outputTokens":6,"cacheReadInputTokens":9455,"cacheCreationInputTokens":2338,"webSearchRequests":0,"costUSD":0.011703,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"6b6fcbd9-d2dd-4b4f-9345-d6c7a7d7eb4e"}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/simple/codex_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/simple/codex_output.ts
new file mode 100644
index 000000000000..b8a30ba9f3ba
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/simple/codex_output.ts
@@ -0,0 +1,33 @@
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertAssistantTextIncludes,
+  assertBaseProjection,
+  assertConversationMessageRoles,
+  assertExecutionNodeKinds,
+  assertRunOrdinals,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessagesInclude,
+  assertVisibleTurnItemsMirrorLocalTurnItems,
+  projectionFor,
+  SIMPLE_PROMPT,
+} from "../shared.ts";
+
+export function assertSimpleOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({ result, transcript, runCount: 1, runStatuses: ["completed"] });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertVisibleTurnItemsMirrorLocalTurnItems(projection);
+  assertRunOrdinals(projection, [1]);
+  assertExecutionNodeKinds(projection, ["root_turn", "assistant_message"]);
+  assertConversationMessageRoles(projection, ["user", "assistant"]);
+  assertTurnItemTypes(projection, ["user_message", "assistant_message"]);
+  assertUserMessagesInclude(projection, [SIMPLE_PROMPT]);
+  assertAssistantTextIncludes(projection, "fixture simple ok");
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/simple/codex_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/simple/codex_transcript.ndjson
new file mode 100644
index 000000000000..2e6cef23e4d7
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/simple/codex_transcript.ndjson
@@ -0,0 +1,31 @@
+{"type":"transcript_start","provider":"codex","protocol":"codex.app-server","version":"0.120.0","scenario":"simple","metadata":{"source":"codex-app-server-probe","fileName":"simple.ndjson","description":"One thread and one turn with a deterministic text-only response."}}
+{"type":"expect_outbound","label":"initialize","frame":{"id":1,"method":"initialize","params":{"capabilities":{"experimentalApi":true},"clientInfo":{"name":"t3code_desktop","title":"T3 Code Desktop","version":"0.1.0"}}}}
+{"type":"emit_inbound","label":"initialize","frame":{"id":1,"result":{"userAgent":"t3code_desktop/0.120.0 (Mac OS 26.4.1; arm64) dumb (t3code_desktop; 0.1.0)","codexHome":"/Users/julius/.codex","platformFamily":"unix","platformOs":"macos"}}}
+{"type":"expect_outbound","label":"initialized","frame":{"method":"initialized"}}
+{"type":"expect_outbound","label":"thread/start","frame":{"id":2,"method":"thread/start","params":{}}}
+{"type":"emit_inbound","label":"thread/start","frame":{"id":2,"result":{"thread":{"id":"019dadea-f49b-7012-aa03-534f1bfc3181","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1776739349,"updatedAt":1776739349,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/04/20/rollout-2026-04-20T19-42-29-019dadea-f49b-7012-aa03-534f1bfc3181.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","cliVersion":"0.120.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]},"model":"gpt-5.4","modelProvider":"openai","serviceTier":"fast","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","approvalPolicy":"on-request","approvalsReviewer":"user","sandbox":{"type":"workspaceWrite","writableRoots":["/Users/julius/.codex/memories"],"readOnlyAccess":{"type":"fullAccess"},"networkAccess":false,"excludeTmpdirEnvVar":false,"excludeSlashTmp":false},"reasoningEffort":"xhigh"}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":3,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Respond with the following text: fixture simple ok","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"type":"dangerFullAccess"},"threadId":"019dadea-f49b-7012-aa03-534f1bfc3181","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"thread/started","frame":{"method":"thread/started","params":{"thread":{"id":"019dadea-f49b-7012-aa03-534f1bfc3181","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1776739349,"updatedAt":1776739349,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/04/20/rollout-2026-04-20T19-42-29-019dadea-f49b-7012-aa03-534f1bfc3181.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","cliVersion":"0.120.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]}}}}
+{"type":"emit_inbound","label":"deprecationNotice","frame":{"method":"deprecationNotice","params":{"summary":"`[features].collab` is deprecated. Use `[features].multi_agent` instead.","details":"Enable it with `--enable multi_agent` or `[features].multi_agent` in config.toml. See https://developers.openai.com/codex/config-basic#feature-flags for details."}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":3,"result":{"turn":{"id":"019dadea-f4a8-75f0-9e95-07b357d41cfe","items":[],"status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019dadea-f49b-7012-aa03-534f1bfc3181","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019dadea-f49b-7012-aa03-534f1bfc3181","turn":{"id":"019dadea-f4a8-75f0-9e95-07b357d41cfe","items":[],"status":"inProgress","error":null,"startedAt":1776739349,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"c0d2203d-1eb7-48ef-91c8-e99e72dfa899","content":[{"type":"text","text":"Respond with the following text: fixture simple ok","text_elements":[]}]},"threadId":"019dadea-f49b-7012-aa03-534f1bfc3181","turnId":"019dadea-f4a8-75f0-9e95-07b357d41cfe"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"c0d2203d-1eb7-48ef-91c8-e99e72dfa899","content":[{"type":"text","text":"Respond with the following text: fixture simple ok","text_elements":[]}]},"threadId":"019dadea-f49b-7012-aa03-534f1bfc3181","turnId":"019dadea-f4a8-75f0-9e95-07b357d41cfe"}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"reasoning","id":"rs_0dae408e3c0b132b0169e6e41ba700819a9d9801b062c4c022","summary":[],"content":[]},"threadId":"019dadea-f49b-7012-aa03-534f1bfc3181","turnId":"019dadea-f4a8-75f0-9e95-07b357d41cfe"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"reasoning","id":"rs_0dae408e3c0b132b0169e6e41ba700819a9d9801b062c4c022","summary":[],"content":[]},"threadId":"019dadea-f49b-7012-aa03-534f1bfc3181","turnId":"019dadea-f4a8-75f0-9e95-07b357d41cfe"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_0dae408e3c0b132b0169e6e41bf13c819a885a64988b80a02d","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019dadea-f49b-7012-aa03-534f1bfc3181","turnId":"019dadea-f4a8-75f0-9e95-07b357d41cfe"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadea-f49b-7012-aa03-534f1bfc3181","turnId":"019dadea-f4a8-75f0-9e95-07b357d41cfe","itemId":"msg_0dae408e3c0b132b0169e6e41bf13c819a885a64988b80a02d","delta":"fixture"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadea-f49b-7012-aa03-534f1bfc3181","turnId":"019dadea-f4a8-75f0-9e95-07b357d41cfe","itemId":"msg_0dae408e3c0b132b0169e6e41bf13c819a885a64988b80a02d","delta":" simple"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadea-f49b-7012-aa03-534f1bfc3181","turnId":"019dadea-f4a8-75f0-9e95-07b357d41cfe","itemId":"msg_0dae408e3c0b132b0169e6e41bf13c819a885a64988b80a02d","delta":" ok"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_0dae408e3c0b132b0169e6e41bf13c819a885a64988b80a02d","text":"fixture simple ok","phase":"final_answer","memoryCitation":null},"threadId":"019dadea-f49b-7012-aa03-534f1bfc3181","turnId":"019dadea-f4a8-75f0-9e95-07b357d41cfe"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019dadea-f49b-7012-aa03-534f1bfc3181","turnId":"019dadea-f4a8-75f0-9e95-07b357d41cfe","tokenUsage":{"total":{"totalTokens":28260,"inputTokens":28223,"cachedInputTokens":3456,"outputTokens":37,"reasoningOutputTokens":28},"last":{"totalTokens":28260,"inputTokens":28223,"cachedInputTokens":3456,"outputTokens":37,"reasoningOutputTokens":28},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019dadea-f49b-7012-aa03-534f1bfc3181","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019dadea-f49b-7012-aa03-534f1bfc3181","turn":{"id":"019dadea-f4a8-75f0-9e95-07b357d41cfe","items":[],"status":"completed","error":null,"startedAt":1776739349,"completedAt":1776739356,"durationMs":6434}}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/simple/cursor_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/simple/cursor_transcript.ndjson
new file mode 100644
index 000000000000..76b8b5278c4c
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/simple/cursor_transcript.ndjson
@@ -0,0 +1,11 @@
+{"type":"transcript_start","provider":"cursor","protocol":"cursor-agent-sdk.local","version":"1","scenario":"simple","metadata":{"generatedBy":"recordCursorAgentSdkReplayTranscript","nativeAgentId":"agent-78cfad4d-9b71-4534-b49c-fbcfab939a0f"}}
+{"type":"expect_outbound","label":"agent.open","frame":{"type":"agent.open","operation":"create","options":{"model":{"id":"composer-2.5"},"hasName":true,"mode":"agent","local":{"hasCwd":true,"autoReview":false,"sandboxEnabled":false,"enableAgentRetries":true}}}}
+{"type":"emit_inbound","label":"agent.opened","frame":{"type":"agent.opened","agentId":"agent-78cfad4d-9b71-4534-b49c-fbcfab939a0f"}}
+{"type":"expect_outbound","label":"run.start:1","frame":{"type":"run.start","message":"Respond with the following text: fixture simple ok","options":{"model":{"id":"composer-2.5"},"mode":"agent"}}}
+{"type":"emit_inbound","label":"run.started:1","frame":{"type":"run.started","runId":"run-74d16078-96e5-44f9-ac08-9d854eeb3bab","agentId":"agent-78cfad4d-9b71-4534-b49c-fbcfab939a0f"}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-74d16078-96e5-44f9-ac08-9d854eeb3bab","update":{"type":"text-delta","text":"fixture simple ok"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-74d16078-96e5-44f9-ac08-9d854eeb3bab","update":{"type":"token-delta","tokens":4}}}
+{"type":"emit_inbound","label":"step-completed","frame":{"type":"interaction.update","runId":"run-74d16078-96e5-44f9-ac08-9d854eeb3bab","update":{"type":"step-completed","stepId":1,"stepDurationMs":1246}}}
+{"type":"emit_inbound","label":"turn-ended","frame":{"type":"interaction.update","runId":"run-74d16078-96e5-44f9-ac08-9d854eeb3bab","update":{"type":"turn-ended","usage":{"inputTokens":10393,"outputTokens":38,"cacheReadTokens":1856,"cacheWriteTokens":0}}}}
+{"type":"emit_inbound","label":"run.completed:1","frame":{"type":"run.completed","result":{"id":"run-74d16078-96e5-44f9-ac08-9d854eeb3bab","requestId":"a35bc166-9742-4bd7-bcc4-22620560c2d2","status":"finished","result":"fixture simple ok","model":{"id":"composer-2.5"},"durationMs":3983}}}
+{"type":"expect_outbound","label":"agent.close","frame":{"type":"agent.close","agentId":"agent-78cfad4d-9b71-4534-b49c-fbcfab939a0f"}}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/simple/grok_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/simple/grok_transcript.ndjson
new file mode 100644
index 000000000000..15a35708bcae
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/simple/grok_transcript.ndjson
@@ -0,0 +1,12 @@
+{"type":"transcript_start","provider":"grok","protocol":"acp.ndjson-jsonrpc","version":"1","scenario":"simple","metadata":{"generatedBy":"live-grok-shape-probe","nativeSessionId":"grok-replay-session-1"}}
+{"type":"expect_outbound","label":"initialize","frame":{"kind":"request","method":"initialize","params":{"protocolVersion":1,"clientCapabilities":{"fs":{"readTextFile":false,"writeTextFile":false},"terminal":false,"elicitation":{"form":{}}},"clientInfo":{"name":"t3-code","version":"0.0.0"}}}}
+{"type":"emit_inbound","label":"initialized","frame":{"kind":"response","method":"initialize","result":{"protocolVersion":1,"agentCapabilities":{"loadSession":true,"mcpCapabilities":{"http":true,"sse":true},"promptCapabilities":{"audio":false,"embeddedContext":true,"image":false}},"authMethods":[{"id":"replay","name":"Replay"}],"agentInfo":{"name":"grok-replay","version":"1"}}}}
+{"type":"expect_outbound","label":"session.new","frame":{"kind":"request","method":"session/new","params":{"cwd":"<workspace>","mcpServers":"<any>"}}}
+{"type":"emit_inbound","label":"session.created","frame":{"kind":"response","method":"session/new","result":{"sessionId":"grok-replay-session-1","models":{"currentModelId":"grok-build","availableModels":[{"modelId":"grok-build","name":"Grok Build"},{"modelId":"grok-composer-2.5-fast","name":"Grok Composer 2.5 Fast"}]}}}}
+{"type":"expect_outbound","label":"session.prompt","frame":{"kind":"request","method":"session/prompt","params":{"sessionId":"grok-replay-session-1","prompt":[{"type":"text","text":"Respond with the following text: fixture simple ok"}]}}}
+{"type":"emit_inbound","label":"reasoning.1","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"grok-replay-session-1","update":{"sessionUpdate":"agent_thought_chunk","content":{"type":"text","text":"I should "}}}}}
+{"type":"emit_inbound","label":"reasoning.2","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"grok-replay-session-1","update":{"sessionUpdate":"agent_thought_chunk","content":{"type":"text","text":"answer exactly."}}}}}
+{"type":"emit_inbound","label":"assistant.1","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"grok-replay-session-1","update":{"sessionUpdate":"agent_message_chunk","content":{"type":"text","text":"fixture simple "}}}}}
+{"type":"emit_inbound","label":"assistant.2","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"grok-replay-session-1","update":{"sessionUpdate":"agent_message_chunk","content":{"type":"text","text":"ok"}}}}}
+{"type":"emit_inbound","label":"prompt.completed","frame":{"kind":"response","method":"session/prompt","result":{"stopReason":"end_turn"}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/simple/input.ts b/apps/server/src/orchestration-v2/testkit/fixtures/simple/input.ts
new file mode 100644
index 000000000000..2d011aace219
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/simple/input.ts
@@ -0,0 +1,7 @@
+import { SIMPLE_PROMPT, type OrchestratorFixtureInput } from "../shared.ts";
+
+export function simpleInput(): OrchestratorFixtureInput {
+  return {
+    steps: [{ type: "message", text: SIMPLE_PROMPT }],
+  };
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/simple/opencode_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/simple/opencode_transcript.ndjson
new file mode 100644
index 000000000000..b38d99658b1d
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/simple/opencode_transcript.ndjson
@@ -0,0 +1,19 @@
+{"type":"transcript_start","provider":"opencode","protocol":"opencode-sdk.sse","version":"1.14.39","scenario":"simple","metadata":{"source":"authenticated-opencode-sdk-probe","capturedAt":"2026-06-18","nativeSessionId":"ses_1236c522dffeunHBidt20OIzWc","model":"openai/gpt-5.4-mini","description":"One real OpenCode session and text-only turn, captured at the SDK request/SSE boundary."}}
+{"type":"expect_outbound","label":"event.subscribe","frame":{"type":"event.subscribe"}}
+{"type":"expect_outbound","label":"session.create","frame":{"type":"session.create","input":{"title":"<any>","permission":"<any>"}}}
+{"type":"emit_inbound","label":"session.created","frame":{"type":"sdk.response","operation":"session.create","data":{"id":"ses_1236c522dffeunHBidt20OIzWc","slug":"shiny-tiger","version":"1.14.39","projectID":"global","directory":"/private/tmp/t3-opencode-probe","path":"private/tmp/t3-opencode-probe","title":"T3 OpenCode v2 probe","time":{"created":1781817126354,"updated":1781817126354}}}}
+{"type":"expect_outbound","label":"session.promptAsync","frame":{"type":"session.promptAsync","input":{"sessionID":"ses_1236c522dffeunHBidt20OIzWc","model":{"providerID":"openai","modelID":"gpt-5.4-mini"},"agent":"build","parts":[{"type":"text","text":"Respond with the following text: fixture simple ok"}]}}}
+{"type":"emit_inbound","label":"session.promptAsync.response","frame":{"type":"sdk.response","operation":"session.promptAsync","data":null}}
+{"type":"emit_inbound","label":"message.updated.user","frame":{"type":"sdk.event","event":{"id":"evt_edc93ade5002giWB7gMKgKTh1N","type":"message.updated","properties":{"sessionID":"ses_1236c522dffeunHBidt20OIzWc","info":{"role":"user","time":{"created":1781817126365},"agent":"build","model":{"providerID":"openai","modelID":"gpt-5.4-mini"},"id":"msg_edc93addd001jzzrE6lotn7BJj","sessionID":"ses_1236c522dffeunHBidt20OIzWc","summary":{"diffs":[]}}}}}}
+{"type":"emit_inbound","label":"session.status.busy","frame":{"type":"sdk.event","event":{"id":"evt_edc93ade80015pjdCBdTty67tQ","type":"session.status","properties":{"sessionID":"ses_1236c522dffeunHBidt20OIzWc","status":{"type":"busy"}}}}}
+{"type":"emit_inbound","label":"step-start","frame":{"type":"sdk.event","event":{"id":"evt_edc93b29c002bOE0jF6Ngtp9WQ","type":"message.part.updated","properties":{"sessionID":"ses_1236c522dffeunHBidt20OIzWc","part":{"id":"prt_edc93b29c001e2RRrSU0wC3EBK","messageID":"msg_edc93ade1001nkGj5Jt1JAd8nq","sessionID":"ses_1236c522dffeunHBidt20OIzWc","type":"step-start"},"time":1781817127580}}}}
+{"type":"emit_inbound","label":"reasoning.started","frame":{"type":"sdk.event","event":{"id":"evt_edc93b3ac002IjQHVrdbEr0grF","type":"message.part.updated","properties":{"sessionID":"ses_1236c522dffeunHBidt20OIzWc","part":{"id":"prt_edc93b3ac0018TDuhzb5SgaTNW","messageID":"msg_edc93ade1001nkGj5Jt1JAd8nq","sessionID":"ses_1236c522dffeunHBidt20OIzWc","type":"reasoning","text":"","time":{"start":1781817127852},"metadata":{"openai":{"itemId":"rs_0cebf1703d45601c016a345f27cd448193bf5ca8d64792912b","reasoningEncryptedContent":"<redacted>"}}},"time":1781817127852}}}}
+{"type":"emit_inbound","label":"reasoning.completed","frame":{"type":"sdk.event","event":{"id":"evt_edc93b5b7001F8JgWVWz3axRi4","type":"message.part.updated","properties":{"sessionID":"ses_1236c522dffeunHBidt20OIzWc","part":{"id":"prt_edc93b3ac0018TDuhzb5SgaTNW","messageID":"msg_edc93ade1001nkGj5Jt1JAd8nq","sessionID":"ses_1236c522dffeunHBidt20OIzWc","type":"reasoning","text":"","time":{"start":1781817127852,"end":1781817128375},"metadata":{"openai":{"itemId":"rs_0cebf1703d45601c016a345f27cd448193bf5ca8d64792912b","reasoningEncryptedContent":"<redacted>"}}},"time":1781817128375}}}}
+{"type":"emit_inbound","label":"assistant.started","frame":{"type":"sdk.event","event":{"id":"evt_edc93b5b8002b8hqk8j4ycOQDv","type":"message.part.updated","properties":{"sessionID":"ses_1236c522dffeunHBidt20OIzWc","part":{"id":"prt_edc93b5b8001T13mKZn2DRRWdH","messageID":"msg_edc93ade1001nkGj5Jt1JAd8nq","sessionID":"ses_1236c522dffeunHBidt20OIzWc","type":"text","text":"","time":{"start":1781817128376},"metadata":{"openai":{"itemId":"msg_0cebf1703d45601c016a345f284b7c819398d57b692541e5a1","phase":"final_answer"}}},"time":1781817128376}}}}
+{"type":"emit_inbound","label":"assistant.completed","frame":{"type":"sdk.event","event":{"id":"evt_edc93b5b90010jWiRMyH8CF4tS","type":"message.part.updated","properties":{"sessionID":"ses_1236c522dffeunHBidt20OIzWc","part":{"id":"prt_edc93b5b8001T13mKZn2DRRWdH","messageID":"msg_edc93ade1001nkGj5Jt1JAd8nq","sessionID":"ses_1236c522dffeunHBidt20OIzWc","type":"text","text":"fixture simple ok","time":{"start":1781817128376,"end":1781817128377},"metadata":{"openai":{"itemId":"msg_0cebf1703d45601c016a345f284b7c819398d57b692541e5a1","phase":"final_answer"}}},"time":1781817128377}}}}
+{"type":"emit_inbound","label":"step-finish","frame":{"type":"sdk.event","event":{"id":"evt_edc93b5d500236244jGWEFb6ac","type":"message.part.updated","properties":{"sessionID":"ses_1236c522dffeunHBidt20OIzWc","part":{"id":"prt_edc93b5d5001CPBPBe0mxI1DbU","reason":"stop","messageID":"msg_edc93ade1001nkGj5Jt1JAd8nq","sessionID":"ses_1236c522dffeunHBidt20OIzWc","type":"step-finish","tokens":{"total":10837,"input":571,"output":9,"reasoning":17,"cache":{"write":0,"read":10240}},"cost":0},"time":1781817128405}}}}
+{"type":"emit_inbound","label":"message.updated.assistant","frame":{"type":"sdk.event","event":{"id":"evt_edc93b5d6001bMOQP8gbJZ0od6","type":"message.updated","properties":{"sessionID":"ses_1236c522dffeunHBidt20OIzWc","info":{"id":"msg_edc93ade1001nkGj5Jt1JAd8nq","parentID":"msg_edc93addd001jzzrE6lotn7BJj","role":"assistant","mode":"build","agent":"build","path":{"cwd":"/private/tmp/t3-opencode-probe","root":"/"},"cost":0,"tokens":{"total":10837,"input":571,"output":9,"reasoning":17,"cache":{"write":0,"read":10240}},"modelID":"gpt-5.4-mini","providerID":"openai","time":{"created":1781817126369},"sessionID":"ses_1236c522dffeunHBidt20OIzWc","finish":"stop"}}}}}
+{"type":"emit_inbound","label":"message.updated.assistant.completed","frame":{"type":"sdk.event","event":{"id":"evt_edc93b5d7001XXJei8Ixk5qMHN","type":"message.updated","properties":{"sessionID":"ses_1236c522dffeunHBidt20OIzWc","info":{"id":"msg_edc93ade1001nkGj5Jt1JAd8nq","parentID":"msg_edc93addd001jzzrE6lotn7BJj","role":"assistant","mode":"build","agent":"build","path":{"cwd":"/private/tmp/t3-opencode-probe","root":"/"},"cost":0,"tokens":{"total":10837,"input":571,"output":9,"reasoning":17,"cache":{"write":0,"read":10240}},"modelID":"gpt-5.4-mini","providerID":"openai","time":{"created":1781817126369,"completed":1781817128407},"sessionID":"ses_1236c522dffeunHBidt20OIzWc","finish":"stop"}}}}}
+{"type":"emit_inbound","label":"session.status.busy.finalizing","frame":{"type":"sdk.event","event":{"id":"evt_edc93b5d7002NYE00v0LorwLmf","type":"session.status","properties":{"sessionID":"ses_1236c522dffeunHBidt20OIzWc","status":{"type":"busy"}}}}}
+{"type":"emit_inbound","label":"session.status.idle","frame":{"type":"sdk.event","event":{"id":"evt_edc93b5d8001wkyQQVJNv3M9vP","type":"session.status","properties":{"sessionID":"ses_1236c522dffeunHBidt20OIzWc","status":{"type":"idle"}}}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/subagent/claude_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/subagent/claude_output.ts
new file mode 100644
index 000000000000..1f5585a79381
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/subagent/claude_output.ts
@@ -0,0 +1,135 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertAssistantTextIncludes,
+  assertBaseProjection,
+  assertExecutionNodeKinds,
+  assertNoExtraAppRunsForProviderChildren,
+  assertRunProviderTurnCardinality,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessagesInclude,
+  projectionFor,
+  SUBAGENT_PROMPT,
+} from "../shared.ts";
+
+export function assertClaudeSubagentOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({
+    result,
+    transcript,
+    runCount: 1,
+    runStatuses: ["completed"],
+  });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertExecutionNodeKinds(projection, ["root_turn", "subagent"]);
+  assertTurnItemTypes(projection, ["user_message", "subagent", "assistant_message"]);
+  assertRunProviderTurnCardinality({ projection, rootRunCount: 1 });
+  assertNoExtraAppRunsForProviderChildren({ projection, expectedAppRuns: 1 });
+  assertUserMessagesInclude(projection, [SUBAGENT_PROMPT]);
+  assertAssistantTextIncludes(projection, "claude-read-only-fixture");
+  assertAssistantTextIncludes(projection, "ES2022");
+  assert.lengthOf(
+    projection.turnItems.filter((item) => item.type === "dynamic_tool"),
+    0,
+    "subagent tools must not be projected into the parent thread",
+  );
+
+  const subagentNodes = projection.nodes.filter((node) => node.kind === "subagent");
+  assert.lengthOf(subagentNodes, 2);
+  assert.deepEqual(
+    subagentNodes.map((node) => node.status),
+    ["completed", "completed"],
+  );
+
+  assert.lengthOf(projection.subagents, 2);
+  assert.lengthOf(result.shellSnapshot.threads, 3);
+  assert.isTrue(
+    projection.subagents.some(
+      (subagent) =>
+        subagent.prompt ===
+          "Read the file `package.json` in the current working directory and return its full contents." &&
+        subagent.result?.includes("claude-read-only-fixture"),
+    ),
+  );
+  assert.isTrue(
+    projection.subagents.some(
+      (subagent) =>
+        subagent.prompt ===
+          "Read the file `tsconfig.json` in the current working directory and return its full contents." &&
+        subagent.result?.includes("ES2022"),
+    ),
+  );
+  for (const subagent of projection.subagents) {
+    const expectedProgress = subagent.prompt.includes("package.json")
+      ? "Summarizing package.json"
+      : "Reading tsconfig.json";
+    assert.equal(subagent.origin, "provider_native");
+    assert.equal(subagent.createdBy, "agent");
+    assert.equal(subagent.driver, "claudeAgent");
+    assert.equal(subagent.status, "completed");
+    assert.equal(subagent.progress, expectedProgress);
+    assert.isNull(subagent.providerThreadId);
+    assert.isNotNull(subagent.childThreadId);
+    assert.isNotNull(subagent.nativeTaskRef);
+    assert.isNotNull(subagent.completedAt);
+    if (subagent.childThreadId === null) {
+      throw new Error(`Subagent ${subagent.id} is missing its child thread`);
+    }
+
+    const childProjection = result.projections.get(subagent.childThreadId);
+    assert.isDefined(childProjection);
+    assert.equal(childProjection.thread.lineage.parentThreadId, projection.thread.id);
+    assert.equal(childProjection.thread.lineage.relationshipToParent, "subagent");
+    assert.isNull(childProjection.thread.activeProviderThreadId);
+    assert.lengthOf(childProjection.runs, 0);
+    assert.lengthOf(childProjection.providerThreads, 0);
+    assert.lengthOf(childProjection.providerTurns, 0);
+    assertExecutionNodeKinds(childProjection, ["root_turn", "tool_call"]);
+    assertTurnItemTypes(childProjection, [
+      "user_message",
+      "reasoning",
+      "dynamic_tool",
+      "assistant_message",
+    ]);
+    assertUserMessagesInclude(childProjection, [subagent.prompt]);
+    assert.isTrue(
+      childProjection.turnItems.some(
+        (item) =>
+          item.type === "assistant_message" &&
+          subagent.result !== null &&
+          item.text.includes(subagent.result.slice(0, 40)),
+      ),
+      `child thread ${subagent.childThreadId} must contain the subagent response`,
+    );
+    const progressItems = childProjection.turnItems.filter((item) => item.type === "reasoning");
+    assert.lengthOf(
+      progressItems,
+      1,
+      `child thread ${subagent.childThreadId} must coalesce progress into one item`,
+    );
+    const progressItem = progressItems[0];
+    if (progressItem === undefined) {
+      throw new Error(`Missing progress item for subagent ${subagent.id}`);
+    }
+    assert.equal(progressItem.text, expectedProgress);
+    assert.equal(progressItem.status, "completed");
+    assert.isFalse(progressItem.streaming);
+    assert.isNotNull(progressItem.completedAt);
+
+    const parentItem = projection.turnItems.find(
+      (item) => item.type === "subagent" && item.subagentId === subagent.id,
+    );
+    assert.isDefined(parentItem);
+    if (parentItem?.type !== "subagent") {
+      throw new Error(`Missing parent lifecycle item for subagent ${subagent.id}`);
+    }
+    assert.equal(parentItem.progress, expectedProgress);
+  }
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/subagent/claude_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/subagent/claude_transcript.ndjson
new file mode 100644
index 000000000000..c22e4aeed85c
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/subagent/claude_transcript.ndjson
@@ -0,0 +1,29 @@
+{"type":"transcript_start","provider":"claudeAgent","protocol":"claude-agent-sdk.query","version":"0.2.111","scenario":"subagent","metadata":{"prompts":["Spawn 2 subagents, one to read package.json and one to read tsconfig.json"],"model":"claude-sonnet-4-6","nativeSessionId":"edf38df1-8d2f-4781-b9e3-f9e72ba7b76d","queryMode":"streaming","tools":"claude_code","permissionMode":"bypassPermissions","generatedBy":"recordClaudeAgentSdkReplayTranscript"}}
+{"type":"expect_outbound","label":"query.open","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"sessionId":"edf38df1-8d2f-4781-b9e3-f9e72ba7b76d"}}}
+{"type":"expect_outbound","label":"prompt.offer:1","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Spawn 2 subagents, one to read package.json and one to read tsconfig.json"},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"4fde9c84-285e-4a68-9070-3704c94168f6","hook_name":"SessionStart:startup","hook_event":"SessionStart","uuid":"caf0439c-1455-4bd5-bcbf-14be3b13db5c","session_id":"edf38df1-8d2f-4781-b9e3-f9e72ba7b76d"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"4fde9c84-285e-4a68-9070-3704c94168f6","hook_name":"SessionStart:startup","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"5af52be5-9839-49fb-aebe-da4068d0ba2a","session_id":"edf38df1-8d2f-4781-b9e3-f9e72ba7b76d"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.111","cwd":"/tmp/claude-replay-subagent","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"38e13364-a3ab-43cf-865f-cb790e39532b","session_id":"edf38df1-8d2f-4781-b9e3-f9e72ba7b76d"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_014tG9SY8VfiqS7bCEAJ1oKt","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"The user wants me to spawn 2 subagents in parallel - one to read package.json and one to read tsconfig.json.","signature":"ErMCCmUIDhgCKkBRbKaYlD+XeRoQv536GegpaFwi9jwMXXtuPsLxongxP3e2xG7qRV+sWykxHk4twYSGIzmfHtgg9TYwH4IBe1GuMhFjbGF1ZGUtc29ubmV0LTQtNjgAQgh0aGlua2luZxIMasLti+z60m9mTQ7iGgwfWbzjzMVaZS/99/0iMBzqZIXucbe83OrH5rh5RJUMDW06UPJkxEczZtLVG/CEhmOLiPnJ23mzX4QZkbxHBip8IqOdwO4Zse+34IUUKau4H/PkUq20GEDeRENlujYtF+YkMI8wk9Oh3X/xKjUy+/kj0udJORGyQp7W0oTRRBojJNT6uYQ53rx+5d8BNwIjJMs2GUAlyBDCJz14UrfXDY3qQTqmtBowAlVKaKx6w8KZLNdGVFdH0nVzqugdMBgB"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":2351,"cache_read_input_tokens":9455,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2351},"output_tokens":0,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"edf38df1-8d2f-4781-b9e3-f9e72ba7b76d","uuid":"682886b5-991a-42be-9f6f-0b92cd685c3d"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_014tG9SY8VfiqS7bCEAJ1oKt","type":"message","role":"assistant","content":[{"type":"text","text":"I'll spawn both subagents simultaneously right now!"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":2351,"cache_read_input_tokens":9455,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2351},"output_tokens":0,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"edf38df1-8d2f-4781-b9e3-f9e72ba7b76d","uuid":"79a75f39-f73f-428d-9009-986d85044454"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_014tG9SY8VfiqS7bCEAJ1oKt","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01FfHTrUeymLi4LfqJVmTZjz","name":"Agent","input":{"description":"Read package.json","prompt":"Read the file `package.json` in the current working directory and return its full contents."},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":2351,"cache_read_input_tokens":9455,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2351},"output_tokens":0,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"edf38df1-8d2f-4781-b9e3-f9e72ba7b76d","uuid":"3688ac34-266c-43f3-bd97-863da3485701"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"task_started","task_id":"a35c9b7d354c20172","tool_use_id":"toolu_01FfHTrUeymLi4LfqJVmTZjz","description":"Read package.json","task_type":"local_agent","prompt":"Read the file `package.json` in the current working directory and return its full contents.","uuid":"5de9156d-9c9c-414e-9a5c-4f88878f7f27","session_id":"edf38df1-8d2f-4781-b9e3-f9e72ba7b76d"}}
+{"type":"emit_inbound","label":"user","frame":{"type":"user","message":{"role":"user","content":[{"type":"text","text":"Read the file `package.json` in the current working directory and return its full contents."}]},"parent_tool_use_id":"toolu_01FfHTrUeymLi4LfqJVmTZjz","session_id":"edf38df1-8d2f-4781-b9e3-f9e72ba7b76d","uuid":"4e7570c6-2512-4307-99ea-37f4cb98ba74","timestamp":"2026-05-27T00:24:44.805Z"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_014tG9SY8VfiqS7bCEAJ1oKt","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_0113VSWTCamvp1adXDZrK5NG","name":"Agent","input":{"description":"Read tsconfig.json","prompt":"Read the file `tsconfig.json` in the current working directory and return its full contents."},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":2351,"cache_read_input_tokens":9455,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2351},"output_tokens":0,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"edf38df1-8d2f-4781-b9e3-f9e72ba7b76d","uuid":"caf23ae6-07b0-4934-a5bf-a4c7e95d112e"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"task_started","task_id":"a3d3213ffad1bd057","tool_use_id":"toolu_0113VSWTCamvp1adXDZrK5NG","description":"Read tsconfig.json","task_type":"local_agent","prompt":"Read the file `tsconfig.json` in the current working directory and return its full contents.","uuid":"e907d290-9015-42f1-a80b-f7d0835b9c96","session_id":"edf38df1-8d2f-4781-b9e3-f9e72ba7b76d"}}
+{"type":"emit_inbound","label":"user","frame":{"type":"user","message":{"role":"user","content":[{"type":"text","text":"Read the file `tsconfig.json` in the current working directory and return its full contents."}]},"parent_tool_use_id":"toolu_0113VSWTCamvp1adXDZrK5NG","session_id":"edf38df1-8d2f-4781-b9e3-f9e72ba7b76d","uuid":"01811bb7-eb17-4da4-b511-0bbee0ae887f","timestamp":"2026-05-27T00:24:44.900Z"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed"},"uuid":"d61e6565-fa4c-4fd6-9174-17c93b91614b","session_id":"edf38df1-8d2f-4781-b9e3-f9e72ba7b76d"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"task_progress","task_id":"a35c9b7d354c20172","tool_use_id":"toolu_01FfHTrUeymLi4LfqJVmTZjz","description":"Reading package.json","usage":{"total_tokens":8707,"tool_uses":1,"duration_ms":2053},"last_tool_name":"Read","uuid":"4ed5c537-4bc1-424f-9462-8efb9d5dd0ab","session_id":"edf38df1-8d2f-4781-b9e3-f9e72ba7b76d"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01DqozNMytHgJ2P5Buwf5f6A","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01EV8j88CPEmhoWF3iuvaFSC","name":"Read","input":{"file_path":"/private/var/folders/b3/b51_pdxj7dl0t981zpqkxxhr0000gn/T/t3-orchestrator-v2-claude-agent-sdk-record-subagent-jAoxxI/package.json"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":1139,"cache_read_input_tokens":7492,"cache_creation":{"ephemeral_5m_input_tokens":1139,"ephemeral_1h_input_tokens":0},"output_tokens":73,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":"toolu_01FfHTrUeymLi4LfqJVmTZjz","session_id":"edf38df1-8d2f-4781-b9e3-f9e72ba7b76d","uuid":"debf5765-e302-4724-8df7-c64d11108860"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"task_progress","task_id":"a3d3213ffad1bd057","tool_use_id":"toolu_0113VSWTCamvp1adXDZrK5NG","description":"Reading tsconfig.json","usage":{"total_tokens":8708,"tool_uses":1,"duration_ms":2093},"last_tool_name":"Read","uuid":"e31a6683-35ab-49f0-8913-1e8a8d559343","session_id":"edf38df1-8d2f-4781-b9e3-f9e72ba7b76d"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_019MHopVQzAkpKERfKvRB1cj","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01P6KQcUPy8t2bCbFjv8K4Jz","name":"Read","input":{"file_path":"/private/var/folders/b3/b51_pdxj7dl0t981zpqkxxhr0000gn/T/t3-orchestrator-v2-claude-agent-sdk-record-subagent-jAoxxI/tsconfig.json"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":1140,"cache_read_input_tokens":7492,"cache_creation":{"ephemeral_5m_input_tokens":1140,"ephemeral_1h_input_tokens":0},"output_tokens":73,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":"toolu_0113VSWTCamvp1adXDZrK5NG","session_id":"edf38df1-8d2f-4781-b9e3-f9e72ba7b76d","uuid":"a5d6d0ed-bc30-43fb-9295-f338fedbf020"}}
+{"type":"emit_inbound","label":"user","frame":{"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01P6KQcUPy8t2bCbFjv8K4Jz","type":"tool_result","content":"1\t{\"compilerOptions\":{\"module\":\"ESNext\",\"strict\":true,\"target\":\"ES2022\"}}"}]},"parent_tool_use_id":"toolu_0113VSWTCamvp1adXDZrK5NG","session_id":"edf38df1-8d2f-4781-b9e3-f9e72ba7b76d","uuid":"6814c55d-46df-4aeb-b594-f8819f353925","timestamp":"2026-05-27T00:24:46.995Z"}}
+{"type":"emit_inbound","label":"user","frame":{"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01EV8j88CPEmhoWF3iuvaFSC","type":"tool_result","content":"1\t{\"name\":\"claude-read-only-fixture\",\"private\":true,\"scripts\":{\"typecheck\":\"tsc --noEmit\"}}"}]},"parent_tool_use_id":"toolu_01FfHTrUeymLi4LfqJVmTZjz","session_id":"edf38df1-8d2f-4781-b9e3-f9e72ba7b76d","uuid":"cd552b77-8f0a-4984-b2e1-8eeea3e63148","timestamp":"2026-05-27T00:24:46.875Z"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"task_progress","task_id":"a35c9b7d354c20172","tool_use_id":"toolu_01FfHTrUeymLi4LfqJVmTZjz","description":"Summarizing package.json","usage":{"total_tokens":9250,"tool_uses":1,"duration_ms":3090},"last_tool_name":"Read","uuid":"9de3f10b-1955-4be3-a046-0e064e2d0e0d","session_id":"edf38df1-8d2f-4781-b9e3-f9e72ba7b76d"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"task_notification","task_id":"a3d3213ffad1bd057","tool_use_id":"toolu_0113VSWTCamvp1adXDZrK5NG","status":"completed","output_file":"","summary":"Read tsconfig.json","usage":{"total_tokens":10750,"tool_uses":1,"duration_ms":5183},"uuid":"71cc121b-cc9f-42ad-aaea-40730ef81125","session_id":"edf38df1-8d2f-4781-b9e3-f9e72ba7b76d"}}
+{"type":"emit_inbound","label":"user","frame":{"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_0113VSWTCamvp1adXDZrK5NG","type":"tool_result","content":[{"type":"text","text":"Here are the full contents of `tsconfig.json`:\n\n```json\n{\"compilerOptions\":{\"module\":\"ESNext\",\"strict\":true,\"target\":\"ES2022\"}}\n```\n\nIt is a minimal TypeScript configuration with three compiler options set:\n- `module`: `ESNext` — uses ES module syntax\n- `strict`: `true` — enables all strict type-checking options\n- `target`: `ES2022` — compiles down to ES2022 JavaScript"},{"type":"text","text":"agentId: a3d3213ffad1bd057 (use SendMessage with to: 'a3d3213ffad1bd057' to continue this agent)\n<usage>total_tokens: 10783\ntool_uses: 1\nduration_ms: 5186</usage>"}]}]},"parent_tool_use_id":null,"session_id":"edf38df1-8d2f-4781-b9e3-f9e72ba7b76d","uuid":"526e0d3c-7688-4b39-8b54-4aa438b93f07","timestamp":"2026-05-27T00:24:50.087Z","tool_use_result":{"status":"completed","prompt":"Read the file `tsconfig.json` in the current working directory and return its full contents.","agentId":"a3d3213ffad1bd057","agentType":"general-purpose","content":[{"type":"text","text":"Here are the full contents of `tsconfig.json`:\n\n```json\n{\"compilerOptions\":{\"module\":\"ESNext\",\"strict\":true,\"target\":\"ES2022\"}}\n```\n\nIt is a minimal TypeScript configuration with three compiler options set:\n- `module`: `ESNext` — uses ES module syntax\n- `strict`: `true` — enables all strict type-checking options\n- `target`: `ES2022` — compiles down to ES2022 JavaScript"}],"totalDurationMs":5186,"totalTokens":10783,"totalToolUseCount":1,"usage":{"input_tokens":1,"cache_creation_input_tokens":2043,"cache_read_input_tokens":8632,"output_tokens":107,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":2043},"inference_geo":"","iterations":[{"input_tokens":1,"output_tokens":107,"cache_read_input_tokens":8632,"cache_creation_input_tokens":2043,"cache_creation":{"ephemeral_5m_input_tokens":2043,"ephemeral_1h_input_tokens":0},"type":"message"}],"speed":"standard"},"toolStats":{"readCount":1,"searchCount":0,"bashCount":0,"editFileCount":0,"linesAdded":0,"linesRemoved":0,"otherToolCount":0}}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"task_notification","task_id":"a35c9b7d354c20172","tool_use_id":"toolu_01FfHTrUeymLi4LfqJVmTZjz","status":"completed","output_file":"","summary":"Read package.json","usage":{"total_tokens":10755,"tool_uses":1,"duration_ms":6211},"uuid":"5fd5a6f9-6045-4b50-99d9-a0bbe8991047","session_id":"edf38df1-8d2f-4781-b9e3-f9e72ba7b76d"}}
+{"type":"emit_inbound","label":"user","frame":{"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01FfHTrUeymLi4LfqJVmTZjz","type":"tool_result","content":[{"type":"text","text":"Here are the full contents of `package.json`:\n\n```json\n{\"name\":\"claude-read-only-fixture\",\"private\":true,\"scripts\":{\"typecheck\":\"tsc --noEmit\"}}\n```\n\nFormatted for readability:\n\n```json\n{\n  \"name\": \"claude-read-only-fixture\",\n  \"private\": true,\n  \"scripts\": {\n    \"typecheck\": \"tsc --noEmit\"\n  }\n}\n```\n\nThe file is minimal, containing just the package name (`claude-read-only-fixture`), a `private: true` flag, and a single script (`typecheck`) that runs the TypeScript compiler in no-emit mode."},{"type":"text","text":"agentId: a35c9b7d354c20172 (use SendMessage with to: 'a35c9b7d354c20172' to continue this agent)\n<usage>total_tokens: 10839\ntool_uses: 1\nduration_ms: 6213</usage>"}]}]},"parent_tool_use_id":null,"session_id":"edf38df1-8d2f-4781-b9e3-f9e72ba7b76d","uuid":"3dac736f-a3d6-4f43-b01d-92c17f34b020","timestamp":"2026-05-27T00:24:51.018Z","tool_use_result":{"status":"completed","prompt":"Read the file `package.json` in the current working directory and return its full contents.","agentId":"a35c9b7d354c20172","agentType":"general-purpose","content":[{"type":"text","text":"Here are the full contents of `package.json`:\n\n```json\n{\"name\":\"claude-read-only-fixture\",\"private\":true,\"scripts\":{\"typecheck\":\"tsc --noEmit\"}}\n```\n\nFormatted for readability:\n\n```json\n{\n  \"name\": \"claude-read-only-fixture\",\n  \"private\": true,\n  \"scripts\": {\n    \"typecheck\": \"tsc --noEmit\"\n  }\n}\n```\n\nThe file is minimal, containing just the package name (`claude-read-only-fixture`), a `private: true` flag, and a single script (`typecheck`) that runs the TypeScript compiler in no-emit mode."}],"totalDurationMs":6213,"totalTokens":10839,"totalToolUseCount":1,"usage":{"input_tokens":1,"cache_creation_input_tokens":2049,"cache_read_input_tokens":8631,"output_tokens":158,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":2049},"inference_geo":"","iterations":[{"input_tokens":1,"output_tokens":158,"cache_read_input_tokens":8631,"cache_creation_input_tokens":2049,"cache_creation":{"ephemeral_5m_input_tokens":2049,"ephemeral_1h_input_tokens":0},"type":"message"}],"speed":"standard"},"toolStats":{"readCount":1,"searchCount":0,"bashCount":0,"editFileCount":0,"linesAdded":0,"linesRemoved":0,"otherToolCount":0}}}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_0149tB2WYRkkPLcXTkYZknLb","type":"message","role":"assistant","content":[{"type":"text","text":"Both subagents completed in parallel! Here's a summary of what they found:\n\n---\n\n### 📦 `package.json`\n```json\n{\n  \"name\": \"claude-read-only-fixture\",\n  \"private\": true,\n  \"scripts\": {\n    \"typecheck\": \"tsc --noEmit\"\n  }\n}\n```\nA minimal package config — private package named `claude-read-only-fixture` with a single `typecheck` script.\n\n---\n\n### 🔧 `tsconfig.json`\n```json\n{\n  \"compilerOptions\": {\n    \"module\": \"ESNext\",\n    \"strict\": true,\n    \"target\": \"ES2022\"\n  }\n}\n```\nA lean TypeScript config targeting **ES2022**, using **ESNext modules**, and enabling **strict** type-checking."}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":209,"cache_creation_input_tokens":481,"cache_read_input_tokens":11806,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":481},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"edf38df1-8d2f-4781-b9e3-f9e72ba7b76d","uuid":"dbd66caf-dabe-4f13-956a-3a4e276c1e80"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":16909,"duration_api_ms":18827,"num_turns":3,"result":"Both subagents completed in parallel! Here's a summary of what they found:\n\n---\n\n### 📦 `package.json`\n```json\n{\n  \"name\": \"claude-read-only-fixture\",\n  \"private\": true,\n  \"scripts\": {\n    \"typecheck\": \"tsc --noEmit\"\n  }\n}\n```\nA minimal package config — private package named `claude-read-only-fixture` with a single `typecheck` script.\n\n---\n\n### 🔧 `tsconfig.json`\n```json\n{\n  \"compilerOptions\": {\n    \"module\": \"ESNext\",\n    \"strict\": true,\n    \"target\": \"ES2022\"\n  }\n}\n```\nA lean TypeScript config targeting **ES2022**, using **ESNext modules**, and enabling **strict** type-checking.","stop_reason":"end_turn","session_id":"edf38df1-8d2f-4781-b9e3-f9e72ba7b76d","total_cost_usd":0.06497865000000001,"usage":{"input_tokens":212,"cache_creation_input_tokens":2832,"cache_read_input_tokens":21261,"output_tokens":419,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":2832,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[{"input_tokens":209,"output_tokens":201,"cache_read_input_tokens":11806,"cache_creation_input_tokens":481,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":481},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":220,"outputTokens":917,"cacheReadInputTokens":53508,"cacheCreationInputTokens":9203,"webSearchRequests":0,"costUSD":0.06497865000000001,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"aa48d52b-3473-44a8-b291-3844d61a4105"}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/subagent/codex_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/subagent/codex_output.ts
new file mode 100644
index 000000000000..6e9160624ba5
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/subagent/codex_output.ts
@@ -0,0 +1,121 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertBaseProjection,
+  assertExecutionNodeKinds,
+  assertNoExtraAppRunsForProviderChildren,
+  assertRunProviderTurnCardinality,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessagesInclude,
+  projectionFor,
+  SUBAGENT_PROMPT,
+} from "../shared.ts";
+
+export function assertSubagentOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({
+    result,
+    transcript,
+    runCount: 1,
+    runStatuses: ["completed"],
+  });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertTurnItemTypes(projection, ["user_message", "subagent", "assistant_message"]);
+  assertExecutionNodeKinds(projection, ["root_turn", "subagent"]);
+  assertRunProviderTurnCardinality({ projection, rootRunCount: 1 });
+  assertNoExtraAppRunsForProviderChildren({ projection, expectedAppRuns: 1 });
+  assertUserMessagesInclude(projection, [SUBAGENT_PROMPT]);
+  assert.equal(projection.runs.length, 1, "subagent provider turns must not become app runs");
+  assert.lengthOf(
+    projection.turnItems.filter((item) => item.type === "command_execution"),
+    0,
+    "subagent commands must not be projected into the parent thread",
+  );
+
+  assert.lengthOf(projection.subagents, 2);
+  assert.lengthOf(result.shellSnapshot.threads, 3);
+  assert.deepEqual(
+    projection.subagents.map((subagent) => subagent.status),
+    ["completed", "completed"],
+  );
+  assert.isTrue(
+    projection.subagents.some(
+      (subagent) =>
+        subagent.prompt.includes("Read package.json only") &&
+        subagent.result?.includes("Package name: `effect-codex-app-server`"),
+    ),
+  );
+  assert.isTrue(
+    projection.subagents.some(
+      (subagent) =>
+        subagent.prompt.includes("Read tsconfig.json only") &&
+        subagent.result?.includes("`extends`: `../../tsconfig.base.json`"),
+    ),
+  );
+
+  for (const subagent of projection.subagents) {
+    assert.equal(subagent.origin, "provider_native");
+    assert.equal(subagent.createdBy, "agent");
+    assert.equal(subagent.driver, "codex");
+    assert.isNotNull(subagent.childThreadId);
+    assert.isNotNull(subagent.providerThreadId);
+    assert.isNotNull(subagent.nativeTaskRef);
+    assert.isNotNull(subagent.completedAt);
+    const parentItem = projection.turnItems.find(
+      (item) => item.type === "subagent" && item.subagentId === subagent.id,
+    );
+    assert.isDefined(parentItem);
+    if (parentItem?.type !== "subagent") {
+      throw new Error(`Missing parent lifecycle item for subagent ${subagent.id}`);
+    }
+    assert.equal(parentItem.result, subagent.result);
+    if (subagent.childThreadId === null) {
+      throw new Error(`Subagent ${subagent.id} is missing its child thread`);
+    }
+
+    const providerThread = projection.providerThreads.find(
+      (thread) => thread.id === subagent.providerThreadId,
+    );
+    assert.isDefined(providerThread);
+    assert.equal(providerThread.appThreadId, subagent.childThreadId);
+    assert.isNull(providerThread.ownerNodeId);
+
+    const childProjection = result.projections.get(subagent.childThreadId);
+    assert.isDefined(childProjection);
+    assert.equal(childProjection.thread.lineage.parentThreadId, projection.thread.id);
+    assert.equal(childProjection.thread.lineage.relationshipToParent, "subagent");
+    assert.equal(childProjection.thread.activeProviderThreadId, providerThread.id);
+    assert.lengthOf(childProjection.runs, 0);
+    assert.lengthOf(childProjection.providerThreads, 1);
+    assert.lengthOf(childProjection.providerTurns, 1);
+    assertTurnItemTypes(childProjection, [
+      "user_message",
+      "command_execution",
+      "assistant_message",
+    ]);
+    assertUserMessagesInclude(childProjection, [subagent.prompt]);
+    assert.isTrue(
+      childProjection.turnItems.some(
+        (item) =>
+          item.type === "assistant_message" &&
+          subagent.result !== null &&
+          item.text.includes(subagent.result.slice(0, 40)),
+      ),
+      `child thread ${subagent.childThreadId} must contain the subagent response`,
+    );
+  }
+
+  const rootProviderThread = projection.providerThreads.find(
+    (thread) => thread.ownerNodeId === null && thread.appThreadId === projection.thread.id,
+  );
+  assert.isDefined(rootProviderThread);
+  assert.equal(rootProviderThread.appThreadId, projection.thread.id);
+  assert.equal(projection.thread.activeProviderThreadId, rootProviderThread.id);
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/subagent/codex_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/subagent/codex_transcript.ndjson
new file mode 100644
index 000000000000..b62e9cea8316
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/subagent/codex_transcript.ndjson
@@ -0,0 +1,577 @@
+{"type":"transcript_start","provider":"codex","protocol":"codex.app-server","version":"0.120.0","scenario":"subagent","metadata":{"source":"codex-app-server-probe","fileName":"subagent.ndjson","description":"One root turn that asks Codex to spawn two collab agents."}}
+{"type":"expect_outbound","label":"initialize","frame":{"id":1,"method":"initialize","params":{"capabilities":{"experimentalApi":true},"clientInfo":{"name":"t3code_desktop","title":"T3 Code Desktop","version":"0.1.0"}}}}
+{"type":"emit_inbound","label":"initialize","frame":{"id":1,"result":{"userAgent":"t3code_desktop/0.120.0 (Mac OS 26.4.1; arm64) dumb (t3code_desktop; 0.1.0)","codexHome":"/Users/julius/.codex","platformFamily":"unix","platformOs":"macos"}}}
+{"type":"expect_outbound","label":"initialized","frame":{"method":"initialized"}}
+{"type":"expect_outbound","label":"thread/start","frame":{"id":2,"method":"thread/start","params":{}}}
+{"type":"emit_inbound","label":"thread/start","frame":{"id":2,"result":{"thread":{"id":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1776739437,"updatedAt":1776739437,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/04/20/rollout-2026-04-20T19-43-57-019dadec-4bed-7991-a1b7-1ed4fc1038b8.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","cliVersion":"0.120.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]},"model":"gpt-5.4","modelProvider":"openai","serviceTier":"fast","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","approvalPolicy":"on-request","approvalsReviewer":"user","sandbox":{"type":"workspaceWrite","writableRoots":["/Users/julius/.codex/memories"],"readOnlyAccess":{"type":"fullAccess"},"networkAccess":false,"excludeTmpdirEnvVar":false,"excludeSlashTmp":false},"reasoningEffort":"xhigh"}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":3,"method":"turn/start","params":{"approvalPolicy":"on-request","cwd":"<workspace>","input":[{"text":"Spawn 2 subagents, one to read package.json and one to read tsconfig.json","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"networkAccess":false,"type":"readOnly"},"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"thread/started","frame":{"method":"thread/started","params":{"thread":{"id":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1776739437,"updatedAt":1776739437,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/04/20/rollout-2026-04-20T19-43-57-019dadec-4bed-7991-a1b7-1ed4fc1038b8.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","cliVersion":"0.120.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]}}}}
+{"type":"emit_inbound","label":"deprecationNotice","frame":{"method":"deprecationNotice","params":{"summary":"`[features].collab` is deprecated. Use `[features].multi_agent` instead.","details":"Enable it with `--enable multi_agent` or `[features].multi_agent` in config.toml. See https://developers.openai.com/codex/config-basic#feature-flags for details."}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":3,"result":{"turn":{"id":"019dadec-4bfa-73e1-868c-9251fd3f65c3","items":[],"status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turn":{"id":"019dadec-4bfa-73e1-868c-9251fd3f65c3","items":[],"status":"inProgress","error":null,"startedAt":1776739437,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"b582fa32-d45c-4963-b7e1-1ed3c8296742","content":[{"type":"text","text":"Spawn 2 subagents, one to read package.json and one to read tsconfig.json","text_elements":[]}]},"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"b582fa32-d45c-4963-b7e1-1ed3c8296742","content":[{"type":"text","text":"Spawn 2 subagents, one to read package.json and one to read tsconfig.json","text_elements":[]}]},"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3"}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"reasoning","id":"rs_04b4cd274d53a3dd0169e6e47486c4819a9dbce004b2ccde45","summary":[],"content":[]},"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"reasoning","id":"rs_04b4cd274d53a3dd0169e6e47486c4819a9dbce004b2ccde45","summary":[],"content":[]},"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_04b4cd274d53a3dd0169e6e47b6d84819a81f30d787a641f45","text":"","phase":"commentary","memoryCitation":null},"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e47b6d84819a81f30d787a641f45","delta":"Sp"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e47b6d84819a81f30d787a641f45","delta":"awning"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e47b6d84819a81f30d787a641f45","delta":" two"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e47b6d84819a81f30d787a641f45","delta":" explorer"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e47b6d84819a81f30d787a641f45","delta":" agents"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e47b6d84819a81f30d787a641f45","delta":" now"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e47b6d84819a81f30d787a641f45","delta":":"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e47b6d84819a81f30d787a641f45","delta":" one"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e47b6d84819a81f30d787a641f45","delta":" scoped"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e47b6d84819a81f30d787a641f45","delta":" to"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e47b6d84819a81f30d787a641f45","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e47b6d84819a81f30d787a641f45","delta":"package"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e47b6d84819a81f30d787a641f45","delta":".json"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e47b6d84819a81f30d787a641f45","delta":"`,"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e47b6d84819a81f30d787a641f45","delta":" one"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e47b6d84819a81f30d787a641f45","delta":" scoped"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e47b6d84819a81f30d787a641f45","delta":" to"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e47b6d84819a81f30d787a641f45","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e47b6d84819a81f30d787a641f45","delta":"ts"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e47b6d84819a81f30d787a641f45","delta":"config"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e47b6d84819a81f30d787a641f45","delta":".json"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e47b6d84819a81f30d787a641f45","delta":"`."}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e47b6d84819a81f30d787a641f45","delta":" They"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e47b6d84819a81f30d787a641f45","delta":" will"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e47b6d84819a81f30d787a641f45","delta":" read"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e47b6d84819a81f30d787a641f45","delta":" only"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e47b6d84819a81f30d787a641f45","delta":" and"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e47b6d84819a81f30d787a641f45","delta":" report"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e47b6d84819a81f30d787a641f45","delta":" back"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e47b6d84819a81f30d787a641f45","delta":"."}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_04b4cd274d53a3dd0169e6e47b6d84819a81f30d787a641f45","text":"Spawning two explorer agents now: one scoped to `package.json`, one scoped to `tsconfig.json`. They will read only and report back.","phase":"commentary","memoryCitation":null},"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"collabAgentToolCall","id":"call_PEuMv7rWiiPuZwUv4DOiM9jl","tool":"spawnAgent","status":"inProgress","senderThreadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","receiverThreadIds":[],"prompt":"You are in /Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server. Read package.json only. Do not edit files. Report the package name, scripts, dependencies/devDependencies summary, and any notable package metadata. Keep it concise.","model":"","reasoningEffort":"low","agentsStates":{}},"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","tokenUsage":{"total":{"totalTokens":28790,"inputTokens":28131,"cachedInputTokens":28032,"outputTokens":659,"reasoningOutputTokens":516},"last":{"totalTokens":28790,"inputTokens":28131,"cachedInputTokens":28032,"outputTokens":659,"reasoningOutputTokens":516},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"deprecationNotice","frame":{"method":"deprecationNotice","params":{"summary":"`[features].collab` is deprecated. Use `[features].multi_agent` instead.","details":"Enable it with `--enable multi_agent` or `[features].multi_agent` in config.toml. See https://developers.openai.com/codex/config-basic#feature-flags for details."}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turn":{"id":"019dadec-86a3-73d1-82b8-c97820fc845e","items":[],"status":"inProgress","error":null,"startedAt":1776739452,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"collabAgentToolCall","id":"call_PEuMv7rWiiPuZwUv4DOiM9jl","tool":"spawnAgent","status":"completed","senderThreadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","receiverThreadIds":["019dadec-8671-7861-98e8-f458a0fa9ed6"],"prompt":"You are in /Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server. Read package.json only. Do not edit files. Report the package name, scripts, dependencies/devDependencies summary, and any notable package metadata. Keep it concise.","model":"gpt-5.4","reasoningEffort":"low","agentsStates":{"019dadec-8671-7861-98e8-f458a0fa9ed6":{"status":"pendingInit","message":null}}},"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3"}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"526a55d9-9300-4ab0-a4c2-e2e56d541d74","content":[{"type":"text","text":"You are in /Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server. Read package.json only. Do not edit files. Report the package name, scripts, dependencies/devDependencies summary, and any notable package metadata. Keep it concise.","text_elements":[]}]},"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"526a55d9-9300-4ab0-a4c2-e2e56d541d74","content":[{"type":"text","text":"You are in /Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server. Read package.json only. Do not edit files. Report the package name, scripts, dependencies/devDependencies summary, and any notable package metadata. Keep it concise.","text_elements":[]}]},"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e"}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"collabAgentToolCall","id":"call_iJmO2XRSBlxqdsWgYJbWopX8","tool":"spawnAgent","status":"inProgress","senderThreadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","receiverThreadIds":[],"prompt":"You are in /Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server. Read tsconfig.json only. Do not edit files. Report the extends/compilerOptions/include/exclude or equivalent structure, plus any notable TypeScript configuration choices. Keep it concise.","model":"","reasoningEffort":"low","agentsStates":{}},"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","tokenUsage":{"total":{"totalTokens":57729,"inputTokens":56963,"cachedInputTokens":56064,"outputTokens":766,"reasoningOutputTokens":516},"last":{"totalTokens":28939,"inputTokens":28832,"cachedInputTokens":28032,"outputTokens":107,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"deprecationNotice","frame":{"method":"deprecationNotice","params":{"summary":"`[features].collab` is deprecated. Use `[features].multi_agent` instead.","details":"Enable it with `--enable multi_agent` or `[features].multi_agent` in config.toml. See https://developers.openai.com/codex/config-basic#feature-flags for details."}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"collabAgentToolCall","id":"call_iJmO2XRSBlxqdsWgYJbWopX8","tool":"spawnAgent","status":"completed","senderThreadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","receiverThreadIds":["019dadec-92b5-78c0-b9f1-f729dd16b784"],"prompt":"You are in /Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server. Read tsconfig.json only. Do not edit files. Report the extends/compilerOptions/include/exclude or equivalent structure, plus any notable TypeScript configuration choices. Keep it concise.","model":"gpt-5.4","reasoningEffort":"low","agentsStates":{"019dadec-92b5-78c0-b9f1-f729dd16b784":{"status":"pendingInit","message":null}}},"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3"}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turn":{"id":"019dadec-92de-7873-a0c8-cfc82a9a0801","items":[],"status":"inProgress","error":null,"startedAt":1776739455,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_0cac0024e4c3e1140169e6e47fe524819ba6db378fcb930527","text":"","phase":"commentary","memoryCitation":null},"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e47fe524819ba6db378fcb930527","delta":"Reading"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e47fe524819ba6db378fcb930527","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e47fe524819ba6db378fcb930527","delta":"package"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e47fe524819ba6db378fcb930527","delta":".json"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e47fe524819ba6db378fcb930527","delta":"`"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e47fe524819ba6db378fcb930527","delta":" only"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e47fe524819ba6db378fcb930527","delta":" and"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e47fe524819ba6db378fcb930527","delta":" leaving"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e47fe524819ba6db378fcb930527","delta":" the"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e47fe524819ba6db378fcb930527","delta":" workspace"}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e47fe524819ba6db378fcb930527","delta":" unchanged"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e47fe524819ba6db378fcb930527","delta":"."}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_0cac0024e4c3e1140169e6e47fe524819ba6db378fcb930527","text":"Reading `package.json` only and leaving the workspace unchanged.","phase":"commentary","memoryCitation":null},"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e"}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","tokenUsage":{"total":{"totalTokens":25637,"inputTokens":25538,"cachedInputTokens":2432,"outputTokens":99,"reasoningOutputTokens":0},"last":{"totalTokens":25637,"inputTokens":25538,"cachedInputTokens":2432,"outputTokens":99,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"commandExecution","id":"call_IACZrSa5ZyzSOlbGjsIfruAx","command":"/bin/zsh -lc \"sed -n '1,220p' package.json\"","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","processId":"85606","source":"unifiedExecStartup","status":"inProgress","commandActions":[{"type":"read","command":"sed -n '1,220p' package.json","name":"package.json","path":"package.json"}],"aggregatedOutput":null,"exitCode":null,"durationMs":null},"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"commandExecution","id":"call_IACZrSa5ZyzSOlbGjsIfruAx","command":"/bin/zsh -lc \"sed -n '1,220p' package.json\"","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","processId":"85606","source":"unifiedExecStartup","status":"completed","commandActions":[{"type":"read","command":"sed -n '1,220p' package.json","name":"package.json","path":"package.json"}],"aggregatedOutput":"{\n  \"name\": \"effect-codex-app-server\",\n  \"private\": true,\n  \"type\": \"module\",\n  \"exports\": {\n    \"./client\": {\n      \"types\": \"./src/client.ts\",\n      \"import\": \"./src/client.ts\"\n    },\n    \"./schema\": {\n      \"types\": \"./src/schema.ts\",\n      \"import\": \"./src/schema.ts\"\n    },\n    \"./rpc\": {\n      \"types\": \"./src/rpc.ts\",\n      \"import\": \"./src/rpc.ts\"\n    },\n    \"./protocol\": {\n      \"types\": \"./src/protocol.ts\",\n      \"import\": \"./src/protocol.ts\"\n    },\n    \"./replay\": {\n      \"types\": \"./src/replay.ts\",\n      \"import\": \"./src/replay.ts\"\n    },\n    \"./errors\": {\n      \"types\": \"./src/errors.ts\",\n      \"import\": \"./src/errors.ts\"\n    }\n  },\n  \"scripts\": {\n    \"dev\": \"tsdown src/client.ts src/rpc.ts src/protocol.ts src/schema.ts --format esm,cjs --dts --watch --clean\",\n    \"build\": \"tsdown src/client.ts src/rpc.ts src/protocol.ts src/schema.ts --format esm,cjs --dts --clean\",\n    \"prepare\": \"effect-language-service patch\",\n    \"typecheck\": \"tsc --noEmit\",\n    \"test\": \"vitest run\",\n    \"generate\": \"bun run scripts/generate.ts\",\n    \"probe\": \"bun run test/examples/codex-app-server-probe.ts\"\n  },\n  \"dependencies\": {\n    \"effect\": \"catalog:\"\n  },\n  \"devDependencies\": {\n    \"@effect/language-service\": \"catalog:\",\n    \"@effect/openapi-generator\": \"catalog:\",\n    \"@effect/platform-node\": \"catalog:\",\n    \"@effect/vitest\": \"catalog:\",\n    \"tsdown\": \"catalog:\",\n    \"typescript\": \"catalog:\",\n    \"vitest\": \"catalog:\"\n  }\n}\n","exitCode":0,"durationMs":0},"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_04b4cd274d53a3dd0169e6e481adac819a97b08e12770d8abb","text":"","phase":"commentary","memoryCitation":null},"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e481adac819a97b08e12770d8abb","delta":"Both"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e481adac819a97b08e12770d8abb","delta":" agents"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e481adac819a97b08e12770d8abb","delta":" are"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e481adac819a97b08e12770d8abb","delta":" running"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e481adac819a97b08e12770d8abb","delta":"."}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e481adac819a97b08e12770d8abb","delta":" I"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e481adac819a97b08e12770d8abb","delta":"’ll"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e481adac819a97b08e12770d8abb","delta":" wait"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e481adac819a97b08e12770d8abb","delta":" for"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e481adac819a97b08e12770d8abb","delta":" their"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e481adac819a97b08e12770d8abb","delta":" summaries"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e481adac819a97b08e12770d8abb","delta":" and"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e481adac819a97b08e12770d8abb","delta":" relay"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e481adac819a97b08e12770d8abb","delta":" the"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e481adac819a97b08e12770d8abb","delta":" useful"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e481adac819a97b08e12770d8abb","delta":" parts"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e481adac819a97b08e12770d8abb","delta":"."}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_04b4cd274d53a3dd0169e6e481adac819a97b08e12770d8abb","text":"Both agents are running. I’ll wait for their summaries and relay the useful parts.","phase":"commentary","memoryCitation":null},"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"`"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"package"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":".json"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"`"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" only"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":":\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" Package"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" name"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":":"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"effect"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"-c"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"od"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"ex"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"-app"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"-server"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"`\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" Metadata"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":":"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"private"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":":"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" true"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"`,"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"type"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":":"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" module"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"`\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" Ex"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"ports"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":":"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"./"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"client"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"`,"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"./"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"schema"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"`,"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"./"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"rpc"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"`,"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"./"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"protocol"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"`,"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"./"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"re"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"play"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"`,"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"./"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"errors"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"`,"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" all"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" pointing"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" to"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" Type"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"Script"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" source"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" files"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" under"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"src"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"/"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"`\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" Scripts"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":":\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" "}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" -"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"dev"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"`:"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" ts"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"down"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" watch"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" build"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" for"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" selected"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" entry"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"points"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" "}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" -"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"build"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"collabAgentToolCall","id":"call_VHAnY7OGDl0gPQyCvmDHfQAR","tool":"wait","status":"inProgress","senderThreadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","receiverThreadIds":["019dadec-8671-7861-98e8-f458a0fa9ed6","019dadec-92b5-78c0-b9f1-f729dd16b784"],"prompt":null,"model":null,"reasoningEffort":null,"agentsStates":{}},"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"`:"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" ts"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"down"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" E"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"SM"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"/C"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"JS"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"/D"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","tokenUsage":{"total":{"totalTokens":86801,"inputTokens":85944,"cachedInputTokens":84608,"outputTokens":857,"reasoningOutputTokens":516},"last":{"totalTokens":29072,"inputTokens":28981,"cachedInputTokens":28544,"outputTokens":91,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"TS"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" build"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" "}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" -"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"prepare"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"`:"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"effect"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"-language"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"-service"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" patch"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"`\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" "}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" -"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"type"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"check"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"`:"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"ts"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"c"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" --"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"no"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"Emit"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"`\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" "}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" -"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"test"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"`:"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"vit"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"est"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" run"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"`\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" "}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" -"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"generate"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"`:"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" runs"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"scripts"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"/g"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"enerate"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":".ts"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"`\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" "}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" -"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"probe"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"`:"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" runs"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" Cod"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"ex"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" app"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"-server"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" probe"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" example"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" Dependencies"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":":"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" only"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"effect"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"`\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" Dev"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" dependencies"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":":"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" Effect"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" tooling"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":","}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" Open"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"API"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" generator"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":","}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" platform"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"-node"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":","}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" Vit"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"est"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" integration"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":","}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"ts"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"down"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"`,"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"typescript"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"`,"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"vit"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"est"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"`\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" Version"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"ing"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" uses"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" workspace"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" catalog"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" protocol"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":":"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":"catalog"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","itemId":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","delta":":`"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_0cac0024e4c3e1140169e6e4823318819b813207b3fd805826","text":"`package.json` only:\n\n- Package name: `effect-codex-app-server`\n- Metadata: `private: true`, `type: module`\n- Exports: `./client`, `./schema`, `./rpc`, `./protocol`, `./replay`, `./errors`, all pointing to TypeScript source files under `src/`\n- Scripts:\n  - `dev`: tsdown watch build for selected entrypoints\n  - `build`: tsdown ESM/CJS/DTS build\n  - `prepare`: `effect-language-service patch`\n  - `typecheck`: `tsc --noEmit`\n  - `test`: `vitest run`\n  - `generate`: runs `scripts/generate.ts`\n  - `probe`: runs Codex app-server probe example\n- Dependencies: only `effect`\n- Dev dependencies: Effect tooling, OpenAPI generator, platform-node, Vitest integration, `tsdown`, `typescript`, `vitest`\n- Versioning uses workspace catalog protocol: `catalog:`","phase":"final_answer","memoryCitation":null},"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turnId":"019dadec-86a3-73d1-82b8-c97820fc845e","tokenUsage":{"total":{"totalTokens":51942,"inputTokens":51629,"cachedInputTokens":27904,"outputTokens":313,"reasoningOutputTokens":0},"last":{"totalTokens":26305,"inputTokens":26091,"cachedInputTokens":25472,"outputTokens":214,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019dadec-8671-7861-98e8-f458a0fa9ed6","turn":{"id":"019dadec-86a3-73d1-82b8-c97820fc845e","items":[],"status":"completed","error":null,"startedAt":1776739452,"completedAt":1776739459,"durationMs":7390}}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"collabAgentToolCall","id":"call_VHAnY7OGDl0gPQyCvmDHfQAR","tool":"wait","status":"completed","senderThreadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","receiverThreadIds":["019dadec-8671-7861-98e8-f458a0fa9ed6"],"prompt":null,"model":null,"reasoningEffort":null,"agentsStates":{"019dadec-8671-7861-98e8-f458a0fa9ed6":{"status":"completed","message":"`package.json` only:\n\n- Package name: `effect-codex-app-server`\n- Metadata: `private: true`, `type: module`\n- Exports: `./client`, `./schema`, `./rpc`, `./protocol`, `./replay`, `./errors`, all pointing to TypeScript source files under `src/`\n- Scripts:\n  - `dev`: tsdown watch build for selected entrypoints\n  - `build`: tsdown ESM/CJS/DTS build\n  - `prepare`: `effect-language-service patch`\n  - `typecheck`: `tsc --noEmit`\n  - `test`: `vitest run`\n  - `generate`: runs `scripts/generate.ts`\n  - `probe`: runs Codex app-server probe example\n- Dependencies: only `effect`\n- Dev dependencies: Effect tooling, OpenAPI generator, platform-node, Vitest integration, `tsdown`, `typescript`, `vitest`\n- Versioning uses workspace catalog protocol: `catalog:`"}}},"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","tokenUsage":{"total":{"totalTokens":86801,"inputTokens":85944,"cachedInputTokens":84608,"outputTokens":857,"reasoningOutputTokens":516},"last":{"totalTokens":29072,"inputTokens":28981,"cachedInputTokens":28544,"outputTokens":91,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"42af2ce8-54d7-44c7-b8d1-b06d07252994","content":[{"type":"text","text":"You are in /Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server. Read tsconfig.json only. Do not edit files. Report the extends/compilerOptions/include/exclude or equivalent structure, plus any notable TypeScript configuration choices. Keep it concise.","text_elements":[]}]},"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"42af2ce8-54d7-44c7-b8d1-b06d07252994","content":[{"type":"text","text":"You are in /Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server. Read tsconfig.json only. Do not edit files. Report the extends/compilerOptions/include/exclude or equivalent structure, plus any notable TypeScript configuration choices. Keep it concise.","text_elements":[]}]},"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","tokenUsage":{"total":{"totalTokens":28790,"inputTokens":28131,"cachedInputTokens":28032,"outputTokens":659,"reasoningOutputTokens":516},"last":{"totalTokens":28790,"inputTokens":28131,"cachedInputTokens":28032,"outputTokens":659,"reasoningOutputTokens":516},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748633},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335433},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"reasoning","id":"rs_073f47c9f548c99b0169e6e485cba4819ab336315c13c3d0b0","summary":[],"content":[]},"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"reasoning","id":"rs_04b4cd274d53a3dd0169e6e485fa44819aa4aeb85ff58480fc","summary":[],"content":[]},"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"reasoning","id":"rs_073f47c9f548c99b0169e6e485cba4819ab336315c13c3d0b0","summary":[],"content":[]},"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_073f47c9f548c99b0169e6e4861f34819aa52c1968a4557e3f","text":"","phase":"commentary","memoryCitation":null},"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4861f34819aa52c1968a4557e3f","delta":"Reading"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4861f34819aa52c1968a4557e3f","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4861f34819aa52c1968a4557e3f","delta":"ts"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4861f34819aa52c1968a4557e3f","delta":"config"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4861f34819aa52c1968a4557e3f","delta":".json"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4861f34819aa52c1968a4557e3f","delta":"`"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4861f34819aa52c1968a4557e3f","delta":" only"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4861f34819aa52c1968a4557e3f","delta":" and"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4861f34819aa52c1968a4557e3f","delta":" will"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4861f34819aa52c1968a4557e3f","delta":" report"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4861f34819aa52c1968a4557e3f","delta":" the"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4861f34819aa52c1968a4557e3f","delta":" requested"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4861f34819aa52c1968a4557e3f","delta":" structure"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4861f34819aa52c1968a4557e3f","delta":"."}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_073f47c9f548c99b0169e6e4861f34819aa52c1968a4557e3f","text":"Reading `tsconfig.json` only and will report the requested structure.","phase":"commentary","memoryCitation":null},"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"reasoning","id":"rs_04b4cd274d53a3dd0169e6e485fa44819aa4aeb85ff58480fc","summary":[],"content":[]},"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","tokenUsage":{"total":{"totalTokens":54450,"inputTokens":53672,"cachedInputTokens":53504,"outputTokens":778,"reasoningOutputTokens":534},"last":{"totalTokens":25660,"inputTokens":25541,"cachedInputTokens":25472,"outputTokens":119,"reasoningOutputTokens":18},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748633},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335433},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"commandExecution","id":"call_SDdfBoFgywZ8TrT74OddggA3","command":"/bin/zsh -lc \"sed -n '1,220p' tsconfig.json\"","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","processId":"53307","source":"unifiedExecStartup","status":"inProgress","commandActions":[{"type":"read","command":"sed -n '1,220p' tsconfig.json","name":"tsconfig.json","path":"tsconfig.json"}],"aggregatedOutput":null,"exitCode":null,"durationMs":null},"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"commandExecution","id":"call_SDdfBoFgywZ8TrT74OddggA3","command":"/bin/zsh -lc \"sed -n '1,220p' tsconfig.json\"","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","processId":"53307","source":"unifiedExecStartup","status":"completed","commandActions":[{"type":"read","command":"sed -n '1,220p' tsconfig.json","name":"tsconfig.json","path":"tsconfig.json"}],"aggregatedOutput":"{\n  \"extends\": \"../../tsconfig.base.json\",\n  \"compilerOptions\": {\n    \"plugins\": [\n      {\n        \"name\": \"@effect/language-service\",\n        \"namespaceImportPackages\": [\"@effect/platform-node\"],\n        \"diagnosticSeverity\": {\n          \"importFromBarrel\": \"error\",\n          \"anyUnknownInErrorContext\": \"warning\",\n          \"instanceOfSchema\": \"warning\",\n          \"deterministicKeys\": \"warning\"\n        }\n      }\n    ]\n  },\n  \"include\": [\"src\", \"scripts\", \"test\"]\n}\n","exitCode":0,"durationMs":0},"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"collabAgentToolCall","id":"call_Y4ENPpPPMs0p1N9KdBG8rRaL","tool":"wait","status":"inProgress","senderThreadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","receiverThreadIds":["019dadec-92b5-78c0-b9f1-f729dd16b784"],"prompt":null,"model":null,"reasoningEffort":null,"agentsStates":{}},"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","tokenUsage":{"total":{"totalTokens":116527,"inputTokens":115552,"cachedInputTokens":113152,"outputTokens":975,"reasoningOutputTokens":587},"last":{"totalTokens":29726,"inputTokens":29608,"cachedInputTokens":28544,"outputTokens":118,"reasoningOutputTokens":71},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"`"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"ts"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"config"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":".json"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"`"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" structure"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":":\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"extends"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"`:"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"../../"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"ts"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"config"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":".base"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":".json"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"`\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"compiler"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"Options"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":".plugins"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"`:"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" uses"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"@"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"effect"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"/l"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"anguage"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"-service"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"`\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" "}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" -"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"namespace"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"Import"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"Packages"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"`:"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"[\"@"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"effect"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"/platform"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"-node"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"\"]"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"`\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" "}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" -"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" diagnostics"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":":\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"   "}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" -"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"import"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"From"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"Bar"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"rel"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"`:"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"error"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"`\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"   "}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" -"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"any"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"Unknown"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"In"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"Error"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"Context"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"`:"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"warning"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"`\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"   "}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" -"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"instance"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"Of"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"Schema"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"`:"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"warning"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"`\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"   "}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" -"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"det"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"ermin"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"istic"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"Keys"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"`:"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"warning"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"`\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"include"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"`:"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"[\""}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"src"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"\","}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" \""}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"scripts"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"\","}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" \""}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"test"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"\"]"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"`\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"exclude"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"`:"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" not"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" specified"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"Not"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"able"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" choice"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":":"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" this"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" package"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" relies"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" mostly"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" on"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" the"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" shared"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" base"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" config"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":","}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" with"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" package"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"-specific"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" Effect"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" language"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" service"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" diagnostics"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" layered"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" on"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":" top"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","itemId":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","delta":"."}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_073f47c9f548c99b0169e6e4888d58819a8aeb946008ad6167","text":"`tsconfig.json` structure:\n\n- `extends`: `../../tsconfig.base.json`\n- `compilerOptions.plugins`: uses `@effect/language-service`\n  - `namespaceImportPackages`: `[\"@effect/platform-node\"]`\n  - diagnostics:\n    - `importFromBarrel`: `error`\n    - `anyUnknownInErrorContext`: `warning`\n    - `instanceOfSchema`: `warning`\n    - `deterministicKeys`: `warning`\n- `include`: `[\"src\", \"scripts\", \"test\"]`\n- `exclude`: not specified\n\nNotable choice: this package relies mostly on the shared base config, with package-specific Effect language service diagnostics layered on top.","phase":"final_answer","memoryCitation":null},"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turnId":"019dadec-92de-7873-a0c8-cfc82a9a0801","tokenUsage":{"total":{"totalTokens":80412,"inputTokens":79489,"cachedInputTokens":78976,"outputTokens":923,"reasoningOutputTokens":534},"last":{"totalTokens":25962,"inputTokens":25817,"cachedInputTokens":25472,"outputTokens":145,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748633},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335433},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019dadec-92b5-78c0-b9f1-f729dd16b784","turn":{"id":"019dadec-92de-7873-a0c8-cfc82a9a0801","items":[],"status":"completed","error":null,"startedAt":1776739455,"completedAt":1776739465,"durationMs":9914}}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"collabAgentToolCall","id":"call_Y4ENPpPPMs0p1N9KdBG8rRaL","tool":"wait","status":"completed","senderThreadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","receiverThreadIds":["019dadec-92b5-78c0-b9f1-f729dd16b784"],"prompt":null,"model":null,"reasoningEffort":null,"agentsStates":{"019dadec-92b5-78c0-b9f1-f729dd16b784":{"status":"completed","message":"`tsconfig.json` structure:\n\n- `extends`: `../../tsconfig.base.json`\n- `compilerOptions.plugins`: uses `@effect/language-service`\n  - `namespaceImportPackages`: `[\"@effect/platform-node\"]`\n  - diagnostics:\n    - `importFromBarrel`: `error`\n    - `anyUnknownInErrorContext`: `warning`\n    - `instanceOfSchema`: `warning`\n    - `deterministicKeys`: `warning`\n- `include`: `[\"src\", \"scripts\", \"test\"]`\n- `exclude`: not specified\n\nNotable choice: this package relies mostly on the shared base config, with package-specific Effect language service diagnostics layered on top."}}},"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","tokenUsage":{"total":{"totalTokens":116527,"inputTokens":115552,"cachedInputTokens":113152,"outputTokens":975,"reasoningOutputTokens":587},"last":{"totalTokens":29726,"inputTokens":29608,"cachedInputTokens":28544,"outputTokens":118,"reasoningOutputTokens":71},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":"Done"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":"."}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":" I"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":" spawned"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":" two"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":" explorer"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":" sub"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":"agents"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":":\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":"package"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":".json"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":"`:"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":" reported"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":" package"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":" metadata"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":","}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":" exports"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":","}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":" scripts"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":","}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":" and"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":" dependencies"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":".\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":"ts"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":"config"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":".json"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":"`:"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":" reported"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":" base"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":" config"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":" inheritance"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":","}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":" Effect"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":" language"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":" service"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":" plugin"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":" diagnostics"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":","}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":" includes"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":","}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":" and"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":" lack"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":" of"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":" explicit"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":" excludes"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","itemId":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","delta":"."}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_04b4cd274d53a3dd0169e6e48ab3c0819aa622fac79e1dcc77","text":"Done. I spawned two explorer subagents:\n\n- `package.json`: reported package metadata, exports, scripts, and dependencies.\n- `tsconfig.json`: reported base config inheritance, Effect language service plugin diagnostics, includes, and lack of explicit excludes.","phase":"final_answer","memoryCitation":null},"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turnId":"019dadec-4bfa-73e1-868c-9251fd3f65c3","tokenUsage":{"total":{"totalTokens":146706,"inputTokens":145677,"cachedInputTokens":142720,"outputTokens":1029,"reasoningOutputTokens":587},"last":{"totalTokens":30179,"inputTokens":30125,"cachedInputTokens":29568,"outputTokens":54,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019dadec-4bed-7991-a1b7-1ed4fc1038b8","turn":{"id":"019dadec-4bfa-73e1-868c-9251fd3f65c3","items":[],"status":"completed","error":null,"startedAt":1776739437,"completedAt":1776739467,"durationMs":29849}}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/subagent/cursor_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/subagent/cursor_output.ts
new file mode 100644
index 000000000000..d152df55e8e0
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/subagent/cursor_output.ts
@@ -0,0 +1,96 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertAssistantTextIncludes,
+  assertBaseProjection,
+  assertExecutionNodeKinds,
+  assertNoExtraAppRunsForProviderChildren,
+  assertRunProviderTurnCardinality,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessagesInclude,
+  projectionFor,
+  SUBAGENT_PROMPT,
+} from "../shared.ts";
+
+export function assertCursorSubagentOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({
+    result,
+    transcript,
+    runCount: 1,
+    runStatuses: ["completed"],
+  });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertExecutionNodeKinds(projection, ["root_turn", "subagent"]);
+  assertTurnItemTypes(projection, ["user_message", "subagent", "assistant_message"]);
+  assertRunProviderTurnCardinality({ projection, rootRunCount: 1 });
+  assertNoExtraAppRunsForProviderChildren({ projection, expectedAppRuns: 1 });
+  assertUserMessagesInclude(projection, [SUBAGENT_PROMPT]);
+  assertAssistantTextIncludes(projection, "cursor-read-only-fixture");
+  assertAssistantTextIncludes(projection, "ES2022");
+
+  const lifecycleItems = projection.turnItems.filter(
+    (item) =>
+      item.type === "reasoning" || item.type === "assistant_message" || item.type === "subagent",
+  );
+  assert.deepEqual(
+    lifecycleItems.map((item) => item.type),
+    ["reasoning", "assistant_message", "subagent", "subagent", "assistant_message"],
+    "Cursor progress, subagents, and the final response must retain provider order",
+  );
+  const assistantMessages = lifecycleItems.filter((item) => item.type === "assistant_message");
+  assert.lengthOf(assistantMessages, 2);
+  assert.equal(
+    assistantMessages[0]?.text,
+    "Spawning two subagents in parallel to read `package.json` and `tsconfig.json`.\n",
+  );
+  assert.include(assistantMessages[1]?.text ?? "", "Both subagents finished.");
+
+  assert.lengthOf(projection.subagents, 2);
+  assert.lengthOf(result.shellSnapshot.threads, 3);
+  assert.deepEqual(
+    projection.subagents.map((subagent) => subagent.status),
+    ["completed", "completed"],
+  );
+
+  for (const subagent of projection.subagents) {
+    assert.equal(subagent.origin, "provider_native");
+    assert.equal(subagent.createdBy, "agent");
+    assert.equal(subagent.driver, "cursor");
+    assert.isNull(subagent.providerThreadId);
+    assert.isNotNull(subagent.childThreadId);
+    assert.isNotNull(subagent.nativeTaskRef);
+    assert.isNotNull(subagent.completedAt);
+    assert.isNotNull(subagent.result);
+    if (subagent.childThreadId === null) {
+      throw new Error(`Subagent ${subagent.id} is missing its child thread`);
+    }
+
+    const childProjection = result.projections.get(subagent.childThreadId);
+    assert.isDefined(childProjection);
+    assert.equal(childProjection.thread.lineage.parentThreadId, projection.thread.id);
+    assert.equal(childProjection.thread.lineage.relationshipToParent, "subagent");
+    assert.isNull(childProjection.thread.activeProviderThreadId);
+    assert.lengthOf(childProjection.runs, 0);
+    assert.lengthOf(childProjection.providerThreads, 0);
+    assert.lengthOf(childProjection.providerTurns, 0);
+    assertExecutionNodeKinds(childProjection, ["root_turn", "tool_call"]);
+    assertTurnItemTypes(childProjection, ["user_message", "file_search", "assistant_message"]);
+    assertUserMessagesInclude(childProjection, [subagent.prompt]);
+    assert.isTrue(
+      childProjection.turnItems.some(
+        (item) =>
+          item.type === "assistant_message" &&
+          subagent.result !== null &&
+          item.text.includes(subagent.result.slice(0, 40)),
+      ),
+    );
+  }
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/subagent/cursor_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/subagent/cursor_transcript.ndjson
new file mode 100644
index 000000000000..f1e2187642b4
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/subagent/cursor_transcript.ndjson
@@ -0,0 +1,474 @@
+{"type":"transcript_start","provider":"cursor","protocol":"cursor-agent-sdk.local","version":"1","scenario":"subagent","metadata":{"generatedBy":"recordCursorAgentSdkReplayTranscript","nativeAgentId":"agent-1eee5e51-da10-4b21-af9a-ef9aca8c482d"}}
+{"type":"expect_outbound","label":"agent.open","frame":{"type":"agent.open","operation":"create","options":{"model":{"id":"composer-2.5"},"hasName":true,"mode":"agent","local":{"hasCwd":true,"autoReview":false,"sandboxEnabled":true,"enableAgentRetries":true}}}}
+{"type":"emit_inbound","label":"agent.opened","frame":{"type":"agent.opened","agentId":"agent-1eee5e51-da10-4b21-af9a-ef9aca8c482d"}}
+{"type":"expect_outbound","label":"run.start:1","frame":{"type":"run.start","message":"Spawn 2 subagents, one to read package.json and one to read tsconfig.json","options":{"model":{"id":"composer-2.5"},"mode":"agent"}}}
+{"type":"emit_inbound","label":"run.started:1","frame":{"type":"run.started","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","agentId":"agent-1eee5e51-da10-4b21-af9a-ef9aca8c482d"}}
+{"type":"emit_inbound","label":"thinking-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"thinking-delta","text":"Spawning two subagents"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":5}}}
+{"type":"emit_inbound","label":"thinking-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"thinking-delta","text":" to read package.json"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":5}}}
+{"type":"emit_inbound","label":"thinking-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"thinking-delta","text":" and tsconfig.json."}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":5}}}
+{"type":"emit_inbound","label":"thinking-completed","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"thinking-completed","thinkingDurationMs":130}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"Sp"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"awning"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" two"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" sub"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"agents"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" in"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" parallel"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":3}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" to"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" read"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" `"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"package"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":".json"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"`"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" and"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" `"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"ts"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"config"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":".json"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"`.\n"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":4}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":5}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":3}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":72}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":5}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":4}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":3}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":5}}}
+{"type":"emit_inbound","label":"partial-tool-call","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"partial-tool-call","callId":"tool_0c313ecc-9783-4a21-b0d5-74150331312","toolCall":{"type":"task","args":{"description":"Read package.json","prompt":"Read the file package.json in the workspace root at /tmp/cursor-replay-subagent/package.json and return its full contents along with a brief summary of what the project is (name, dependencies, scripts, etc.).","subagentType":{"kind":"unspecified"},"model":"composer-2.5-fast","agentId":"414d4889-6f0e-4866-9379-cd8a57673251","mode":"unspecified"}},"modelCallId":"393d6cf5-3363-488b-80aa-ca0498451dca-0-zcvb"}}}
+{"type":"emit_inbound","label":"tool-call-started","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"tool-call-started","callId":"tool_0c313ecc-9783-4a21-b0d5-74150331312","toolCall":{"type":"task","args":{"description":"Read package.json","prompt":"Read the file package.json in the workspace root at /tmp/cursor-replay-subagent/package.json and return its full contents along with a brief summary of what the project is (name, dependencies, scripts, etc.).","subagentType":{"kind":"unspecified"},"model":"composer-2.5-fast","agentId":"414d4889-6f0e-4866-9379-cd8a57673251","mode":"unspecified"}},"modelCallId":"393d6cf5-3363-488b-80aa-ca0498451dca-0-zcvb"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":4}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":5}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":3}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":78}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":5}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":4}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":3}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":5}}}
+{"type":"emit_inbound","label":"partial-tool-call","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"partial-tool-call","callId":"tool_1d92aa7d-e115-4918-9cf6-d384c92098a","toolCall":{"type":"task","args":{"description":"Read tsconfig.json","prompt":"Read the file tsconfig.json in the workspace root at /tmp/cursor-replay-subagent/tsconfig.json and return its full contents along with a brief summary of the TypeScript configuration (compiler options, target, module settings, etc.).","subagentType":{"kind":"unspecified"},"model":"composer-2.5-fast","agentId":"4eab0559-c807-4f08-a101-c8d99d895c82","mode":"unspecified"}},"modelCallId":"393d6cf5-3363-488b-80aa-ca0498451dca-0-zcvb"}}}
+{"type":"emit_inbound","label":"tool-call-started","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"tool-call-started","callId":"tool_1d92aa7d-e115-4918-9cf6-d384c92098a","toolCall":{"type":"task","args":{"description":"Read tsconfig.json","prompt":"Read the file tsconfig.json in the workspace root at /tmp/cursor-replay-subagent/tsconfig.json and return its full contents along with a brief summary of the TypeScript configuration (compiler options, target, module settings, etc.).","subagentType":{"kind":"unspecified"},"model":"composer-2.5-fast","agentId":"4eab0559-c807-4f08-a101-c8d99d895c82","mode":"unspecified"}},"modelCallId":"393d6cf5-3363-488b-80aa-ca0498451dca-0-zcvb"}}}
+{"type":"emit_inbound","label":"tool-call-completed","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"tool-call-completed","callId":"tool_0c313ecc-9783-4a21-b0d5-74150331312","toolCall":{"type":"task","args":{"description":"Read package.json","prompt":"Read the file package.json in the workspace root at /tmp/cursor-replay-subagent/package.json and return its full contents along with a brief summary of what the project is (name, dependencies, scripts, etc.).","subagentType":{"kind":"unspecified"},"model":"composer-2.5-fast","agentId":"414d4889-6f0e-4866-9379-cd8a57673251","mode":"unspecified"},"result":{"status":"success","value":{"conversationSteps":[{"toolCall":{"readToolCall":{"args":{"path":"/tmp/cursor-replay-subagent/package.json"},"result":{"success":{"content":"{\"name\":\"cursor-read-only-fixture\",\"private\":true,\"scripts\":{\"typecheck\":\"tsc --noEmit\"}}","totalLines":1,"fileSize":89,"path":"/tmp/cursor-replay-subagent/package.json","readRange":{"startLine":1,"endLine":1}}}},"toolCallId":"tool_45b696cd-7ad1-4fb6-bdd5-32452d02ea5"}},{"assistantMessage":{"text":"## Full contents\n\n```json\n{\n  \"name\": \"cursor-read-only-fixture\",\n  \"private\": true,\n  \"scripts\": {\n    \"typecheck\": \"tsc --noEmit\"\n  }\n}\n```\n\n## Summary\n\n| Field | Value |\n|--------|--------|\n| **Name** | `cursor-read-only-fixture` |\n| **Private** | `true` (not intended for npm publish) |\n| **Scripts** | `typecheck` — runs TypeScript compiler in check-only mode (`tsc --noEmit`) |\n| **Dependencies** | None listed |\n| **Dev dependencies** | None listed |\n\nThis is a minimal TypeScript fixture project. It has no runtime or build dependencies in `package.json`; the only script is type-checking via `tsc`. The name suggests it’s a read-only test or demo setup for Cursor/orchestrator tooling rather than a full application."}}],"agentId":"414d4889-6f0e-4866-9379-cd8a57673251","isBackground":false,"durationMs":3570,"backgroundReason":"unspecified"}}},"modelCallId":"393d6cf5-3363-488b-80aa-ca0498451dca-0-zcvb"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":258}}}
+{"type":"emit_inbound","label":"tool-call-completed","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"tool-call-completed","callId":"tool_1d92aa7d-e115-4918-9cf6-d384c92098a","toolCall":{"type":"task","args":{"description":"Read tsconfig.json","prompt":"Read the file tsconfig.json in the workspace root at /tmp/cursor-replay-subagent/tsconfig.json and return its full contents along with a brief summary of the TypeScript configuration (compiler options, target, module settings, etc.).","subagentType":{"kind":"unspecified"},"model":"composer-2.5-fast","agentId":"4eab0559-c807-4f08-a101-c8d99d895c82","mode":"unspecified"},"result":{"status":"success","value":{"conversationSteps":[{"assistantMessage":{"text":"Reading `tsconfig.json` and summarizing its TypeScript settings.\n"}},{"toolCall":{"readToolCall":{"args":{"path":"/tmp/cursor-replay-subagent/tsconfig.json"},"result":{"success":{"content":"{\"compilerOptions\":{\"module\":\"ESNext\",\"strict\":true,\"target\":\"ES2022\"}}","totalLines":1,"fileSize":71,"path":"/tmp/cursor-replay-subagent/tsconfig.json","readRange":{"startLine":1,"endLine":1}}}},"toolCallId":"tool_af98da3d-ddfc-4f07-a9a2-1c1ac8efcd6"}},{"assistantMessage":{"text":"## Full contents\n\n```json\n{\n  \"compilerOptions\": {\n    \"module\": \"ESNext\",\n    \"strict\": true,\n    \"target\": \"ES2022\"\n  }\n}\n```\n\n## Summary\n\nThis is a minimal TypeScript config with three compiler options:\n\n| Option | Value | Meaning |\n|--------|--------|---------|\n| **target** | `ES2022` | Emit JavaScript for ES2022 (modern syntax and runtime features). |\n| **module** | `ESNext` | Use the latest ECMAScript module format for imports/exports. |\n| **strict** | `true` | Enable all strict type-checking options (e.g. `strictNullChecks`, `noImplicitAny`). |\n\n**Not specified (defaults apply):**\n- No `include` / `exclude` — TypeScript will include all `.ts` files in the project directory.\n- No `outDir` / `rootDir` — output location and root are inferred or use defaults.\n- No `moduleResolution`, `esModuleInterop`, `skipLibCheck`, or path aliases — standard defaults are used.\n\nOverall, it targets modern ES modules with strict checking and leaves most other settings at TypeScript defaults."}}],"agentId":"4eab0559-c807-4f08-a101-c8d99d895c82","isBackground":false,"durationMs":3614,"backgroundReason":"unspecified"}}},"modelCallId":"393d6cf5-3363-488b-80aa-ca0498451dca-0-zcvb"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":325}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"Both"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" sub"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"agents"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" finished"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"."}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" Here"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"’s"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" what"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" they"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" reported"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":":\n\n"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"##"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" package"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":".json"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"\n\n"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"```"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"json"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"\n"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"{\n"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" "}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" \""}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"name"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"\":"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" \""}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"cursor"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"-read"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"-only"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"-fix"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"ture"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"\",\n"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" "}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" \""}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"private"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"\":"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" true"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":",\n"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" "}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" \""}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"scripts"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"\":"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" {\n"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"   "}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" \""}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"type"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"check"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"\":"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" \""}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"t"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"sc"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" --"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"no"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"Emit"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"\"\n"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" "}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" }\n"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"}\n"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"```\n\n"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"-"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" **"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"Name"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":":**"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" `"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"cursor"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"-read"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"-only"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"-fix"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"ture"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"`\n"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"-"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" **"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"Private"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":":**"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" `"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"true"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"`"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" ("}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"not"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" for"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" npm"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" publish"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":")\n"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"-"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" **"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"Scripts"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":":**"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" `"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"type"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"check"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"`"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" runs"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" `"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"t"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"sc"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" --"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"no"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"Emit"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"`\n"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"-"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" **"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"Dependencies"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":3}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":":**"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" none"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" listed"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"\n\n"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"This"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" looks"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" like"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" a"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" minimal"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" Type"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"Script"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" fixture"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" for"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" Cursor"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"/or"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"che"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"strator"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" tooling"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":".\n\n"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"##"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" ts"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"config"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":".json"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"\n\n"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"```"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"json"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"\n"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"{\n"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" "}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" \""}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"compiler"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"Options"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"\":"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" {\n"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"   "}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" \""}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"module"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"\":"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" \""}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"ES"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"Next"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"\",\n"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"   "}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" \""}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"strict"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"\":"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" true"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":",\n"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"   "}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" \""}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"target"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"\":"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" \""}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"ES"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"202"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"2"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"\"\n"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" "}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" }\n"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"}\n"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"```\n\n"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"-"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" **"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"target"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":":**"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" `"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"ES"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"202"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"2"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"`\n"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"-"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" **"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"module"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":":**"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" `"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"ES"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"Next"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"`\n"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"-"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" **"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"strict"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":":**"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" `"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"true"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"`"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" ("}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"full"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" strict"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" type"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"-check"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"ing"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":")\n"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"-"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" No"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" `"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"include"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"`"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"/`"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"exclude"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"`,"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" `"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"out"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"Dir"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"`,"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" or"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" path"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" aliases"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" —"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" defaults"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" apply"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"\n\n"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"Together"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":","}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" this"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" is"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" a"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" small"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" read"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"-only"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" Type"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"Script"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" project"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" with"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" strict"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" checking"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" and"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" a"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" single"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" type"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"check"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":" script"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"text-delta","text":"."}}}
+{"type":"emit_inbound","label":"step-completed","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"step-completed","stepId":5,"stepDurationMs":6831}}}
+{"type":"emit_inbound","label":"turn-ended","frame":{"type":"interaction.update","runId":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","update":{"type":"turn-ended","usage":{"inputTokens":21878,"outputTokens":661,"cacheReadTokens":17788,"cacheWriteTokens":0}}}}
+{"type":"emit_inbound","label":"run.completed:1","frame":{"type":"run.completed","result":{"id":"run-4f9fd970-8f15-44ae-8973-09aa4d42daaf","requestId":"393d6cf5-3363-488b-80aa-ca0498451dca","status":"finished","result":"Both subagents finished. Here’s what they reported:\n\n## package.json\n\n```json\n{\n  \"name\": \"cursor-read-only-fixture\",\n  \"private\": true,\n  \"scripts\": {\n    \"typecheck\": \"tsc --noEmit\"\n  }\n}\n```\n\n- **Name:** `cursor-read-only-fixture`\n- **Private:** `true` (not for npm publish)\n- **Scripts:** `typecheck` runs `tsc --noEmit`\n- **Dependencies:** none listed\n\nThis looks like a minimal TypeScript fixture for Cursor/orchestrator tooling.\n\n## tsconfig.json\n\n```json\n{\n  \"compilerOptions\": {\n    \"module\": \"ESNext\",\n    \"strict\": true,\n    \"target\": \"ES2022\"\n  }\n}\n```\n\n- **target:** `ES2022`\n- **module:** `ESNext`\n- **strict:** `true` (full strict type-checking)\n- No `include`/`exclude`, `outDir`, or path aliases — defaults apply\n\nTogether, this is a small read-only TypeScript project with strict checking and a single typecheck script.","model":{"id":"composer-2.5"},"durationMs":9585}}}
+{"type":"expect_outbound","label":"agent.close","frame":{"type":"agent.close","agentId":"agent-1eee5e51-da10-4b21-af9a-ef9aca8c482d"}}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/subagent/input.ts b/apps/server/src/orchestration-v2/testkit/fixtures/subagent/input.ts
new file mode 100644
index 000000000000..d0f885c57dcb
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/subagent/input.ts
@@ -0,0 +1,7 @@
+import { SUBAGENT_PROMPT, type OrchestratorFixtureInput } from "../shared.ts";
+
+export function subagentInput(): OrchestratorFixtureInput {
+  return {
+    steps: [{ type: "message", text: SUBAGENT_PROMPT }],
+  };
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/subagent_continue/README.md b/apps/server/src/orchestration-v2/testkit/fixtures/subagent_continue/README.md
new file mode 100644
index 000000000000..ed6c33a8a5d1
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/subagent_continue/README.md
@@ -0,0 +1,28 @@
+# Continued Native Subagent
+
+This fixture records Codex continuing a native subagent from a later parent turn.
+
+```text
+Parent app thread / Codex thread A
+  Turn 1: spawn one subagent
+    |
+    +-- spawnAgent
+          |
+          v
+        Child app thread / Codex thread B
+          Turn 1: initial prompt
+          Assistant: initial subagent response
+
+  Turn 2: @hooke continue the same subagent
+    |
+    +-- resumeAgent + sendInput
+          |
+          v
+        Child app thread / Codex thread B
+          Turn 2: continuation prompt
+          Assistant: continued subagent response
+```
+
+The original parent `subagent` item represents only the spawn lifecycle. It must
+remain completed with the first result while the child thread accumulates later
+conversation turns.
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/subagent_continue/codex_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/subagent_continue/codex_output.ts
new file mode 100644
index 000000000000..b631cbf565f9
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/subagent_continue/codex_output.ts
@@ -0,0 +1,59 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertBaseProjection,
+  assertNoExtraAppRunsForProviderChildren,
+  assertSemanticProjectionIntegrity,
+  assertUserMessagesInclude,
+  projectionFor,
+  SUBAGENT_CONTINUE_CHILD_PROMPT,
+  SUBAGENT_CONTINUE_PARENT_PROMPT,
+  SUBAGENT_CONTINUE_PROMPT,
+} from "../shared.ts";
+
+export function assertSubagentContinueOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({
+    result,
+    transcript,
+    runCount: 2,
+    runStatuses: ["completed", "completed"],
+  });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertNoExtraAppRunsForProviderChildren({ projection, expectedAppRuns: 2 });
+  assertUserMessagesInclude(projection, [
+    SUBAGENT_CONTINUE_PROMPT,
+    SUBAGENT_CONTINUE_PARENT_PROMPT,
+  ]);
+  assert.lengthOf(projection.subagents, 1);
+
+  const subagent = projection.subagents[0]!;
+  assert.equal(subagent.status, "completed");
+  assert.equal(subagent.result, "initial subagent response");
+  assert.isNotNull(subagent.childThreadId);
+  if (subagent.childThreadId === null) {
+    throw new Error("Continued subagent is missing its child thread");
+  }
+
+  const childProjection = result.projections.get(subagent.childThreadId);
+  assert.isDefined(childProjection);
+  assert.lengthOf(childProjection.runs, 0);
+  assert.lengthOf(childProjection.providerTurns, 2);
+  assertUserMessagesInclude(childProjection, [subagent.prompt, SUBAGENT_CONTINUE_CHILD_PROMPT]);
+  assert.isTrue(
+    childProjection.turnItems.some(
+      (item) => item.type === "assistant_message" && item.text === "initial subagent response",
+    ),
+  );
+  assert.isTrue(
+    childProjection.turnItems.some(
+      (item) => item.type === "assistant_message" && item.text === "continued subagent response",
+    ),
+  );
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/subagent_continue/codex_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/subagent_continue/codex_transcript.ndjson
new file mode 100644
index 000000000000..cdf0e8d90daf
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/subagent_continue/codex_transcript.ndjson
@@ -0,0 +1,33 @@
+{"type":"transcript_start","provider":"codex","protocol":"codex.app-server","version":"0.137.0","scenario":"subagent_continue","metadata":{"source":"record-codex-app-server-replay-fixture","fileName":"subagent_continue.ndjson","description":"A root turn spawns one native Codex subagent, then a later root turn resumes and messages the same child thread."}}
+{"type":"expect_outbound","label":"initialize","frame":{"id":1,"method":"initialize","params":{"capabilities":{"experimentalApi":true},"clientInfo":{"name":"t3code_desktop","title":"T3 Code Desktop","version":"0.1.0"}}}}
+{"type":"emit_inbound","label":"initialize","frame":{"id":1,"result":{"userAgent":"t3code_desktop/0.137.0","codexHome":"/tmp/codex-home","platformFamily":"unix","platformOs":"macos"}}}
+{"type":"expect_outbound","label":"initialized","frame":{"method":"initialized"}}
+{"type":"expect_outbound","label":"thread/start","frame":{"id":2,"method":"thread/start","params":{}}}
+{"type":"emit_inbound","label":"thread/start","frame":{"id":2,"result":{"thread":{"id":"native-root-thread","sessionId":"native-root-thread","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1781051850,"updatedAt":1781051850,"status":{"type":"idle"},"path":"/tmp/root-thread.jsonl","cwd":"/tmp","cliVersion":"0.137.0","source":"vscode","threadSource":null,"agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]},"model":"gpt-5.4","modelProvider":"openai","serviceTier":null,"cwd":"/tmp","instructionSources":[],"approvalPolicy":"on-request","approvalsReviewer":"user","sandbox":{"type":"workspaceWrite","writableRoots":[],"networkAccess":false},"reasoningEffort":"high"}}}
+{"type":"expect_outbound","label":"turn/start/spawn","frame":{"id":3,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Spawn one subagent and have it reply exactly: initial subagent response","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"type":"dangerFullAccess"},"threadId":"native-root-thread","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"turn/start/spawn","frame":{"id":3,"result":{"turn":{"id":"native-root-turn-1","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"turn/started/root-1","frame":{"method":"turn/started","params":{"threadId":"native-root-thread","turn":{"id":"native-root-turn-1","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":1781051851,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"item/completed/root-user-1","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"root-user-1","content":[{"type":"text","text":"Spawn one subagent and have it reply exactly: initial subagent response","text_elements":[]}]},"threadId":"native-root-thread","turnId":"native-root-turn-1","completedAtMs":1781051851000}}}
+{"type":"emit_inbound","label":"item/started/spawnAgent","frame":{"method":"item/started","params":{"item":{"type":"collabAgentToolCall","id":"spawn-call-1","tool":"spawnAgent","status":"inProgress","senderThreadId":"native-root-thread","receiverThreadIds":[],"prompt":"Reply exactly: initial subagent response","model":"","reasoningEffort":"medium","agentsStates":{}},"threadId":"native-root-thread","turnId":"native-root-turn-1","startedAtMs":1781051852000}}}
+{"type":"emit_inbound","label":"item/completed/spawnAgent","frame":{"method":"item/completed","params":{"item":{"type":"collabAgentToolCall","id":"spawn-call-1","tool":"spawnAgent","status":"completed","senderThreadId":"native-root-thread","receiverThreadIds":["native-child-thread"],"prompt":"Reply exactly: initial subagent response","model":"kindle-alpha","reasoningEffort":"high","agentsStates":{"native-child-thread":{"status":"pendingInit","message":null}}},"threadId":"native-root-thread","turnId":"native-root-turn-1","completedAtMs":1781051852100}}}
+{"type":"emit_inbound","label":"turn/started/child-1","frame":{"method":"turn/started","params":{"threadId":"native-child-thread","turn":{"id":"native-child-turn-1","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":1781051852,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"item/completed/child-user-1","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"child-user-1","content":[{"type":"text","text":"Reply exactly: initial subagent response","text_elements":[]}]},"threadId":"native-child-thread","turnId":"native-child-turn-1","completedAtMs":1781051852200}}}
+{"type":"emit_inbound","label":"item/completed/child-answer-1","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"child-answer-1","text":"initial subagent response","phase":"final_answer","memoryCitation":null},"threadId":"native-child-thread","turnId":"native-child-turn-1","completedAtMs":1781051853000}}}
+{"type":"emit_inbound","label":"turn/completed/child-1","frame":{"method":"turn/completed","params":{"threadId":"native-child-thread","turn":{"id":"native-child-turn-1","items":[],"itemsView":"notLoaded","status":"completed","error":null,"startedAt":1781051852,"completedAt":1781051853,"durationMs":1000}}}}
+{"type":"emit_inbound","label":"item/completed/wait-1","frame":{"method":"item/completed","params":{"item":{"type":"collabAgentToolCall","id":"wait-call-1","tool":"wait","status":"completed","senderThreadId":"native-root-thread","receiverThreadIds":["native-child-thread"],"prompt":null,"model":null,"reasoningEffort":null,"agentsStates":{"native-child-thread":{"status":"completed","message":"initial subagent response"}}},"threadId":"native-root-thread","turnId":"native-root-turn-1","completedAtMs":1781051853100}}}
+{"type":"emit_inbound","label":"item/completed/root-answer-1","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"root-answer-1","text":"Hooke says: initial subagent response","phase":"final_answer","memoryCitation":null},"threadId":"native-root-thread","turnId":"native-root-turn-1","completedAtMs":1781051854000}}}
+{"type":"emit_inbound","label":"turn/completed/root-1","frame":{"method":"turn/completed","params":{"threadId":"native-root-thread","turn":{"id":"native-root-turn-1","items":[],"itemsView":"notLoaded","status":"completed","error":null,"startedAt":1781051851,"completedAt":1781051854,"durationMs":3000}}}}
+{"type":"expect_outbound","label":"turn/start/continue","frame":{"id":4,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"@hooke have the same subagent reply exactly: continued subagent response","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"type":"dangerFullAccess"},"threadId":"native-root-thread","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"turn/start/continue","frame":{"id":4,"result":{"turn":{"id":"native-root-turn-2","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"turn/started/root-2","frame":{"method":"turn/started","params":{"threadId":"native-root-thread","turn":{"id":"native-root-turn-2","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":1781051860,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"item/completed/root-user-2","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"root-user-2","content":[{"type":"text","text":"@hooke have the same subagent reply exactly: continued subagent response","text_elements":[]}]},"threadId":"native-root-thread","turnId":"native-root-turn-2","completedAtMs":1781051860000}}}
+{"type":"emit_inbound","label":"item/completed/resumeAgent","frame":{"method":"item/completed","params":{"item":{"type":"collabAgentToolCall","id":"resume-call-1","tool":"resumeAgent","status":"completed","senderThreadId":"native-root-thread","receiverThreadIds":["native-child-thread"],"prompt":null,"model":null,"reasoningEffort":null,"agentsStates":{"native-child-thread":{"status":"completed","message":"initial subagent response"}}},"threadId":"native-root-thread","turnId":"native-root-turn-2","completedAtMs":1781051860100}}}
+{"type":"emit_inbound","label":"item/completed/sendInput","frame":{"method":"item/completed","params":{"item":{"type":"collabAgentToolCall","id":"send-input-call-1","tool":"sendInput","status":"completed","senderThreadId":"native-root-thread","receiverThreadIds":["native-child-thread"],"prompt":"Reply exactly: continued subagent response","model":null,"reasoningEffort":null,"agentsStates":{"native-child-thread":{"status":"completed","message":"initial subagent response"}}},"threadId":"native-root-thread","turnId":"native-root-turn-2","completedAtMs":1781051860200}}}
+{"type":"emit_inbound","label":"turn/started/child-2","frame":{"method":"turn/started","params":{"threadId":"native-child-thread","turn":{"id":"native-child-turn-2","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":1781051861,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"item/completed/child-user-2","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"child-user-2","content":[{"type":"text","text":"Reply exactly: continued subagent response","text_elements":[]}]},"threadId":"native-child-thread","turnId":"native-child-turn-2","completedAtMs":1781051861100}}}
+{"type":"emit_inbound","label":"item/completed/child-answer-2","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"child-answer-2","text":"continued subagent response","phase":"final_answer","memoryCitation":null},"threadId":"native-child-thread","turnId":"native-child-turn-2","completedAtMs":1781051862000}}}
+{"type":"emit_inbound","label":"turn/completed/child-2","frame":{"method":"turn/completed","params":{"threadId":"native-child-thread","turn":{"id":"native-child-turn-2","items":[],"itemsView":"notLoaded","status":"completed","error":null,"startedAt":1781051861,"completedAt":1781051862,"durationMs":1000}}}}
+{"type":"emit_inbound","label":"item/completed/wait-2","frame":{"method":"item/completed","params":{"item":{"type":"collabAgentToolCall","id":"wait-call-2","tool":"wait","status":"completed","senderThreadId":"native-root-thread","receiverThreadIds":["native-child-thread"],"prompt":null,"model":null,"reasoningEffort":null,"agentsStates":{"native-child-thread":{"status":"completed","message":"continued subagent response"}}},"threadId":"native-root-thread","turnId":"native-root-turn-2","completedAtMs":1781051862100}}}
+{"type":"emit_inbound","label":"item/completed/root-answer-2","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"root-answer-2","text":"Hooke says: continued subagent response","phase":"final_answer","memoryCitation":null},"threadId":"native-root-thread","turnId":"native-root-turn-2","completedAtMs":1781051863000}}}
+{"type":"emit_inbound","label":"turn/completed/root-2","frame":{"method":"turn/completed","params":{"threadId":"native-root-thread","turn":{"id":"native-root-turn-2","items":[],"itemsView":"notLoaded","status":"completed","error":null,"startedAt":1781051860,"completedAt":1781051863,"durationMs":3000}}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/subagent_continue/input.ts b/apps/server/src/orchestration-v2/testkit/fixtures/subagent_continue/input.ts
new file mode 100644
index 000000000000..136ffa1dab9a
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/subagent_continue/input.ts
@@ -0,0 +1,14 @@
+import {
+  SUBAGENT_CONTINUE_PARENT_PROMPT,
+  SUBAGENT_CONTINUE_PROMPT,
+  type OrchestratorFixtureInput,
+} from "../shared.ts";
+
+export function subagentContinueInput(): OrchestratorFixtureInput {
+  return {
+    steps: [
+      { type: "message", text: SUBAGENT_CONTINUE_PROMPT },
+      { type: "message", text: SUBAGENT_CONTINUE_PARENT_PROMPT },
+    ],
+  };
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/subagent_v2/codex_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/subagent_v2/codex_output.ts
new file mode 100644
index 000000000000..aa73387fa84f
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/subagent_v2/codex_output.ts
@@ -0,0 +1,85 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertBaseProjection,
+  assertExecutionNodeKinds,
+  assertNoExtraAppRunsForProviderChildren,
+  assertRunProviderTurnCardinality,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessagesInclude,
+  projectionFor,
+  SUBAGENT_V2_PROMPT,
+} from "../shared.ts";
+
+export function assertSubagentV2Output(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({
+    result,
+    transcript,
+    runCount: 1,
+    runStatuses: ["completed"],
+  });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertTurnItemTypes(projection, ["user_message", "subagent", "assistant_message"]);
+  assertExecutionNodeKinds(projection, ["root_turn", "subagent"]);
+  assertRunProviderTurnCardinality({ projection, rootRunCount: 1 });
+  assertNoExtraAppRunsForProviderChildren({ projection, expectedAppRuns: 1 });
+  assertUserMessagesInclude(projection, [SUBAGENT_V2_PROMPT]);
+  assert.lengthOf(projection.subagents, 1);
+  assert.lengthOf(result.shellSnapshot.threads, 2);
+
+  const subagent = projection.subagents[0]!;
+  assert.equal(subagent.origin, "provider_native");
+  assert.equal(subagent.createdBy, "agent");
+  assert.equal(subagent.driver, "codex");
+  assert.equal(subagent.title, "/root/hello_agent");
+  assert.equal(subagent.prompt, "");
+  assert.equal(subagent.status, "completed");
+  assert.equal(subagent.result, "Hello.");
+  assert.isNotNull(subagent.childThreadId);
+  assert.isNotNull(subagent.providerThreadId);
+  assert.isNotNull(subagent.nativeTaskRef);
+  assert.isNotNull(subagent.completedAt);
+  const parentItem = projection.turnItems.find(
+    (item) => item.type === "subagent" && item.subagentId === subagent.id,
+  );
+  assert.isDefined(parentItem);
+  if (parentItem?.type !== "subagent") {
+    throw new Error(`Missing parent lifecycle item for subagent ${subagent.id}`);
+  }
+  assert.equal(parentItem.result, subagent.result);
+  if (subagent.childThreadId === null) {
+    throw new Error(`Subagent ${subagent.id} is missing its child thread`);
+  }
+
+  const providerThread = projection.providerThreads.find(
+    (thread) => thread.id === subagent.providerThreadId,
+  );
+  assert.isDefined(providerThread);
+  assert.equal(providerThread.appThreadId, subagent.childThreadId);
+  assert.isNull(providerThread.ownerNodeId);
+
+  const childProjection = result.projections.get(subagent.childThreadId);
+  assert.isDefined(childProjection);
+  assert.equal(childProjection.thread.lineage.parentThreadId, projection.thread.id);
+  assert.equal(childProjection.thread.lineage.relationshipToParent, "subagent");
+  assert.equal(childProjection.thread.activeProviderThreadId, providerThread.id);
+  assert.lengthOf(childProjection.runs, 0);
+  assert.lengthOf(childProjection.providerThreads, 1);
+  assert.lengthOf(childProjection.providerTurns, 1);
+  assertTurnItemTypes(childProjection, ["assistant_message"]);
+  assert.isTrue(
+    childProjection.turnItems.some(
+      (item) => item.type === "assistant_message" && item.text.includes("Hello."),
+    ),
+    "child thread must contain the post-root subagent response",
+  );
+  assert.equal(childProjection.providerTurns[0]?.status, "completed");
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/subagent_v2/codex_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/subagent_v2/codex_transcript.ndjson
new file mode 100644
index 000000000000..c9fc8e97d837
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/subagent_v2/codex_transcript.ndjson
@@ -0,0 +1,25 @@
+{"type":"transcript_start","provider":"codex","protocol":"codex.app-server","version":"0.141.0","scenario":"subagent_v2","metadata":{"source":"observed-codex-app-server-replay-fixture","fileName":"subagent_v2.ndjson","description":"Agents-v2 Codex subagent spawn observed from a real run: parent emits subAgentActivity(started), child emits a normal turn and final agent message."}}
+{"type":"expect_outbound","label":"initialize","frame":{"id":1,"method":"initialize","params":{"capabilities":{"experimentalApi":true},"clientInfo":{"name":"t3code_desktop","title":"T3 Code Desktop","version":"0.1.0"}}}}
+{"type":"emit_inbound","label":"initialize","frame":{"id":1,"result":{"userAgent":"t3code_desktop/0.141.0","codexHome":"/tmp/codex-home","platformFamily":"unix","platformOs":"macos"}}}
+{"type":"expect_outbound","label":"initialized","frame":{"method":"initialized"}}
+{"type":"expect_outbound","label":"thread/start","frame":{"id":2,"method":"thread/start","params":{}}}
+{"type":"emit_inbound","label":"thread/start","frame":{"id":2,"result":{"thread":{"id":"native-v2-root-thread","sessionId":"native-v2-root-thread","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1782622440,"updatedAt":1782622440,"status":{"type":"idle"},"path":"/tmp/root-thread.jsonl","cwd":"/tmp","cliVersion":"0.141.0","source":"vscode","threadSource":null,"agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]},"model":"gpt-5.4","modelProvider":"openai","serviceTier":null,"cwd":"/tmp","instructionSources":[],"approvalPolicy":"on-request","approvalsReviewer":"user","sandbox":{"type":"workspaceWrite","writableRoots":[],"networkAccess":false},"reasoningEffort":"medium"}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":3,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"just say hello","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"type":"dangerFullAccess"},"threadId":"native-v2-root-thread","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":3,"result":{"turn":{"id":"native-v2-root-turn","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed/root-active","frame":{"method":"thread/status/changed","params":{"threadId":"native-v2-root-thread","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"native-v2-root-thread","turn":{"id":"native-v2-root-turn","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":1782622440,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"item/completed/root-user","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"root-user-v2","clientId":null,"content":[{"type":"text","text":"just say hello","text_elements":[]}]},"threadId":"native-v2-root-thread","turnId":"native-v2-root-turn","completedAtMs":1782622440261}}}
+{"type":"emit_inbound","label":"thread/status/changed/child-idle-before-start","frame":{"method":"thread/status/changed","params":{"threadId":"native-v2-child-thread","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"item/completed/subAgentActivity-started","frame":{"method":"item/completed","params":{"item":{"type":"subAgentActivity","id":"call-v2-spawn","kind":"started","agentThreadId":"native-v2-child-thread","agentPath":"/root/hello_agent"},"threadId":"native-v2-root-thread","turnId":"native-v2-root-turn","completedAtMs":1782622442529}}}
+{"type":"emit_inbound","label":"thread/status/changed/child-active","frame":{"method":"thread/status/changed","params":{"threadId":"native-v2-child-thread","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started/child","frame":{"method":"turn/started","params":{"threadId":"native-v2-child-thread","turn":{"id":"native-v2-child-turn","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":1782622442,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"item/completed/root-commentary","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"root-commentary-v2","text":"I spawned a subagent to say hello.","phase":"commentary","memoryCitation":null},"threadId":"native-v2-root-thread","turnId":"native-v2-root-turn","completedAtMs":1782622443818}}}
+{"type":"emit_inbound","label":"item/started/wait-agent","frame":{"method":"item/started","params":{"item":{"type":"collabAgentToolCall","id":"wait-call-v2","tool":"wait","status":"inProgress","senderThreadId":"native-v2-root-thread","receiverThreadIds":[],"prompt":null,"model":null,"reasoningEffort":null,"agentsStates":{}},"threadId":"native-v2-root-thread","turnId":"native-v2-root-turn","startedAtMs":1782622444012}}}
+{"type":"emit_inbound","label":"item/completed/wait-agent","frame":{"method":"item/completed","params":{"item":{"type":"collabAgentToolCall","id":"wait-call-v2","tool":"wait","status":"completed","senderThreadId":"native-v2-root-thread","receiverThreadIds":[],"prompt":null,"model":null,"reasoningEffort":null,"agentsStates":{}},"threadId":"native-v2-root-thread","turnId":"native-v2-root-turn","completedAtMs":1782622454013}}}
+{"type":"emit_inbound","label":"item/completed/root-answer","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"root-answer-v2","text":"Subagent spawned as `/root/hello_agent`. It hasn't returned within the short wait window yet.","phase":"final_answer","memoryCitation":null},"threadId":"native-v2-root-thread","turnId":"native-v2-root-turn","completedAtMs":1782622455859}}}
+{"type":"emit_inbound","label":"thread/status/changed/root-idle","frame":{"method":"thread/status/changed","params":{"threadId":"native-v2-root-thread","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"native-v2-root-thread","turn":{"id":"native-v2-root-turn","items":[],"itemsView":"notLoaded","status":"completed","error":null,"startedAt":1782622440,"completedAt":1782622455,"durationMs":15598}}}}
+{"type":"emit_inbound","label":"item/completed/child-answer","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"child-answer-v2","text":"Hello.","phase":"final_answer","memoryCitation":null},"threadId":"native-v2-child-thread","turnId":"native-v2-child-turn","completedAtMs":1782622463754}}}
+{"type":"emit_inbound","label":"thread/status/changed/child-idle","frame":{"method":"thread/status/changed","params":{"threadId":"native-v2-child-thread","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"native-v2-child-thread","turn":{"id":"native-v2-child-turn","items":[],"itemsView":"notLoaded","status":"completed","error":null,"startedAt":1782622442,"completedAt":1782622463,"durationMs":21247}}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/subagent_v2/input.ts b/apps/server/src/orchestration-v2/testkit/fixtures/subagent_v2/input.ts
new file mode 100644
index 000000000000..e257e763bde7
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/subagent_v2/input.ts
@@ -0,0 +1,7 @@
+import { SUBAGENT_V2_PROMPT, type OrchestratorFixtureInput } from "../shared.ts";
+
+export function subagentV2Input(): OrchestratorFixtureInput {
+  return {
+    steps: [{ type: "message", text: SUBAGENT_V2_PROMPT }],
+  };
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/subagent_v2_nested/codex_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/subagent_v2_nested/codex_output.ts
new file mode 100644
index 000000000000..b01365cb5e65
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/subagent_v2_nested/codex_output.ts
@@ -0,0 +1,131 @@
+import { assert } from "@effect/vitest";
+import type {
+  OrchestrationV2ThreadProjection,
+  ProviderReplayTranscript,
+  ThreadId,
+} from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertBaseProjection,
+  assertNoExtraAppRunsForProviderChildren,
+  assertRunProviderTurnCardinality,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessagesInclude,
+  projectionFor,
+  SUBAGENT_V2_PROMPT,
+} from "../shared.ts";
+
+function projectionById(
+  result: OrchestratorV2ScenarioResult,
+  threadId: ThreadId,
+): OrchestrationV2ThreadProjection {
+  const projection = result.projections.get(threadId);
+  assert.isDefined(projection, `missing projection for ${threadId}`);
+  return projection;
+}
+
+function assertCompletedProviderNativeSubagent(input: {
+  readonly projection: OrchestrationV2ThreadProjection;
+  readonly title: string;
+  readonly result: string;
+}) {
+  assert.lengthOf(input.projection.subagents, 1);
+  assert.lengthOf(
+    input.projection.turnItems.filter((item) => item.type === "subagent"),
+    1,
+    `${input.projection.thread.id} must only render its direct subagent`,
+  );
+
+  const subagent = input.projection.subagents[0]!;
+  assert.equal(subagent.origin, "provider_native");
+  assert.equal(subagent.createdBy, "agent");
+  assert.equal(subagent.driver, "codex");
+  assert.equal(subagent.title, input.title);
+  assert.equal(subagent.status, "completed");
+  assert.equal(subagent.result, input.result);
+  assert.isNotNull(subagent.childThreadId);
+  assert.isNotNull(subagent.providerThreadId);
+  assert.isNotNull(subagent.nativeTaskRef);
+  assert.isNotNull(subagent.completedAt);
+  return subagent;
+}
+
+export function assertSubagentV2NestedOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({
+    result,
+    transcript,
+    runCount: 1,
+    runStatuses: ["completed"],
+  });
+
+  const rootProjection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(rootProjection);
+  assertTurnItemTypes(rootProjection, ["user_message", "subagent", "assistant_message"]);
+  assertRunProviderTurnCardinality({ projection: rootProjection, rootRunCount: 1 });
+  assertNoExtraAppRunsForProviderChildren({ projection: rootProjection, expectedAppRuns: 1 });
+  assertUserMessagesInclude(rootProjection, [SUBAGENT_V2_PROMPT]);
+  assert.lengthOf(result.shellSnapshot.threads, 4);
+
+  const first = assertCompletedProviderNativeSubagent({
+    projection: rootProjection,
+    title: "/root/hello_agent",
+    result: "Subagent says: “Hello.”",
+  });
+  if (first.childThreadId === null) {
+    throw new Error("first nested fixture subagent is missing its child thread");
+  }
+
+  const firstProjection = projectionById(result, first.childThreadId);
+  assert.equal(firstProjection.thread.lineage.parentThreadId, rootProjection.thread.id);
+  assert.equal(firstProjection.thread.lineage.relationshipToParent, "subagent");
+  assert.equal(firstProjection.thread.lineage.rootThreadId, rootProjection.thread.id);
+  assert.lengthOf(firstProjection.runs, 0);
+  assert.lengthOf(firstProjection.providerTurns, 1);
+  assertTurnItemTypes(firstProjection, ["subagent", "assistant_message"]);
+
+  const second = assertCompletedProviderNativeSubagent({
+    projection: firstProjection,
+    title: "/root/hello_agent/hello_agent",
+    result: "Subagent says: “Hello.”",
+  });
+  if (second.childThreadId === null) {
+    throw new Error("second nested fixture subagent is missing its child thread");
+  }
+
+  const secondProjection = projectionById(result, second.childThreadId);
+  assert.equal(secondProjection.thread.lineage.parentThreadId, firstProjection.thread.id);
+  assert.equal(secondProjection.thread.lineage.relationshipToParent, "subagent");
+  assert.equal(secondProjection.thread.lineage.rootThreadId, rootProjection.thread.id);
+  assert.lengthOf(secondProjection.runs, 0);
+  assert.lengthOf(secondProjection.providerTurns, 1);
+  assertTurnItemTypes(secondProjection, ["subagent", "assistant_message"]);
+
+  const third = assertCompletedProviderNativeSubagent({
+    projection: secondProjection,
+    title: "/root/hello_agent/hello_agent/hello_agent",
+    result: "Hello.",
+  });
+  if (third.childThreadId === null) {
+    throw new Error("third nested fixture subagent is missing its child thread");
+  }
+
+  const thirdProjection = projectionById(result, third.childThreadId);
+  assert.equal(thirdProjection.thread.lineage.parentThreadId, secondProjection.thread.id);
+  assert.equal(thirdProjection.thread.lineage.relationshipToParent, "subagent");
+  assert.equal(thirdProjection.thread.lineage.rootThreadId, rootProjection.thread.id);
+  assert.lengthOf(thirdProjection.runs, 0);
+  assert.lengthOf(thirdProjection.providerTurns, 1);
+  assert.lengthOf(thirdProjection.subagents, 0);
+  assertTurnItemTypes(thirdProjection, ["assistant_message"]);
+  assert.isTrue(
+    thirdProjection.turnItems.some(
+      (item) => item.type === "assistant_message" && item.text === "Hello.",
+    ),
+    "leaf child thread must contain the final assistant message",
+  );
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/subagent_v2_nested/codex_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/subagent_v2_nested/codex_transcript.ndjson
new file mode 100644
index 000000000000..a85accb50aea
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/subagent_v2_nested/codex_transcript.ndjson
@@ -0,0 +1,33 @@
+{"type":"transcript_start","provider":"codex","protocol":"codex.app-server","version":"0.141.0","scenario":"subagent_v2_nested","metadata":{"source":"observed-codex-app-server-replay-fixture","description":"Agents-v2 Codex nested subagent spawn: root emits a subAgentActivity, that child emits another, and that grandchild emits a final nested child."}}
+{"type":"expect_outbound","label":"initialize","frame":{"id":1,"method":"initialize","params":{"capabilities":{"experimentalApi":true},"clientInfo":{"name":"t3code_desktop","title":"T3 Code Desktop","version":"0.1.0"}}}}
+{"type":"emit_inbound","label":"initialize","frame":{"id":1,"result":{"userAgent":"t3code_desktop/0.141.0","codexHome":"/tmp/codex-home","platformFamily":"unix","platformOs":"macos"}}}
+{"type":"expect_outbound","label":"initialized","frame":{"method":"initialized"}}
+{"type":"expect_outbound","label":"thread/start","frame":{"id":2,"method":"thread/start","params":{}}}
+{"type":"emit_inbound","label":"thread/start","frame":{"id":2,"result":{"thread":{"id":"native-v2-nested-root-thread","sessionId":"native-v2-nested-root-thread","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1782622500,"updatedAt":1782622500,"status":{"type":"idle"},"path":"/tmp/root-thread.jsonl","cwd":"/tmp","cliVersion":"0.141.0","source":"vscode","threadSource":null,"agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]},"model":"gpt-5.4","modelProvider":"openai","serviceTier":null,"cwd":"/tmp","instructionSources":[],"approvalPolicy":"on-request","approvalsReviewer":"user","sandbox":{"type":"workspaceWrite","writableRoots":[],"networkAccess":false},"reasoningEffort":"medium"}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":3,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"just say hello","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"type":"dangerFullAccess"},"threadId":"native-v2-nested-root-thread","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":3,"result":{"turn":{"id":"native-v2-nested-root-turn","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed/root-active","frame":{"method":"thread/status/changed","params":{"threadId":"native-v2-nested-root-thread","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"native-v2-nested-root-thread","turn":{"id":"native-v2-nested-root-turn","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":1782622500,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"item/completed/root-user","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"nested-root-user","clientId":null,"content":[{"type":"text","text":"just say hello","text_elements":[]}]},"threadId":"native-v2-nested-root-thread","turnId":"native-v2-nested-root-turn","completedAtMs":1782622500261}}}
+{"type":"emit_inbound","label":"item/completed/root-subagent","frame":{"method":"item/completed","params":{"item":{"type":"subAgentActivity","id":"call-nested-root-child","kind":"started","agentThreadId":"native-v2-nested-child-thread","agentPath":"/root/hello_agent"},"threadId":"native-v2-nested-root-thread","turnId":"native-v2-nested-root-turn","completedAtMs":1782622502529}}}
+{"type":"emit_inbound","label":"thread/status/changed/child-active","frame":{"method":"thread/status/changed","params":{"threadId":"native-v2-nested-child-thread","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started/child","frame":{"method":"turn/started","params":{"threadId":"native-v2-nested-child-thread","turn":{"id":"native-v2-nested-child-turn","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":1782622502,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"item/completed/child-subagent","frame":{"method":"item/completed","params":{"item":{"type":"subAgentActivity","id":"call-nested-child-grandchild","kind":"started","agentThreadId":"native-v2-nested-grandchild-thread","agentPath":"/root/hello_agent/hello_agent"},"threadId":"native-v2-nested-child-thread","turnId":"native-v2-nested-child-turn","completedAtMs":1782622507262}}}
+{"type":"emit_inbound","label":"thread/status/changed/grandchild-active","frame":{"method":"thread/status/changed","params":{"threadId":"native-v2-nested-grandchild-thread","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started/grandchild","frame":{"method":"turn/started","params":{"threadId":"native-v2-nested-grandchild-thread","turn":{"id":"native-v2-nested-grandchild-turn","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":1782622507,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"item/completed/grandchild-subagent","frame":{"method":"item/completed","params":{"item":{"type":"subAgentActivity","id":"call-nested-grandchild-leaf","kind":"started","agentThreadId":"native-v2-nested-leaf-thread","agentPath":"/root/hello_agent/hello_agent/hello_agent"},"threadId":"native-v2-nested-grandchild-thread","turnId":"native-v2-nested-grandchild-turn","completedAtMs":1782622511426}}}
+{"type":"emit_inbound","label":"thread/status/changed/leaf-active","frame":{"method":"thread/status/changed","params":{"threadId":"native-v2-nested-leaf-thread","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started/leaf","frame":{"method":"turn/started","params":{"threadId":"native-v2-nested-leaf-thread","turn":{"id":"native-v2-nested-leaf-turn","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":1782622511,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"item/completed/leaf-answer","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"nested-leaf-answer","text":"Hello.","phase":"final_answer","memoryCitation":null},"threadId":"native-v2-nested-leaf-thread","turnId":"native-v2-nested-leaf-turn","completedAtMs":1782622513754}}}
+{"type":"emit_inbound","label":"thread/status/changed/leaf-idle","frame":{"method":"thread/status/changed","params":{"threadId":"native-v2-nested-leaf-thread","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"native-v2-nested-leaf-thread","turn":{"id":"native-v2-nested-leaf-turn","items":[],"itemsView":"notLoaded","status":"completed","error":null,"startedAt":1782622511,"completedAt":1782622513,"durationMs":2754}}}}
+{"type":"emit_inbound","label":"item/completed/grandchild-answer","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"nested-grandchild-answer","text":"Subagent says: “Hello.”","phase":"final_answer","memoryCitation":null},"threadId":"native-v2-nested-grandchild-thread","turnId":"native-v2-nested-grandchild-turn","completedAtMs":1782622514500}}}
+{"type":"emit_inbound","label":"thread/status/changed/grandchild-idle","frame":{"method":"thread/status/changed","params":{"threadId":"native-v2-nested-grandchild-thread","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"native-v2-nested-grandchild-thread","turn":{"id":"native-v2-nested-grandchild-turn","items":[],"itemsView":"notLoaded","status":"completed","error":null,"startedAt":1782622507,"completedAt":1782622514,"durationMs":7500}}}}
+{"type":"emit_inbound","label":"item/completed/child-answer","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"nested-child-answer","text":"Subagent says: “Hello.”","phase":"final_answer","memoryCitation":null},"threadId":"native-v2-nested-child-thread","turnId":"native-v2-nested-child-turn","completedAtMs":1782622515200}}}
+{"type":"emit_inbound","label":"thread/status/changed/child-idle","frame":{"method":"thread/status/changed","params":{"threadId":"native-v2-nested-child-thread","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"native-v2-nested-child-thread","turn":{"id":"native-v2-nested-child-turn","items":[],"itemsView":"notLoaded","status":"completed","error":null,"startedAt":1782622502,"completedAt":1782622515,"durationMs":13200}}}}
+{"type":"emit_inbound","label":"item/completed/root-answer","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"nested-root-answer","text":"Subagent says: “Hello.”","phase":"final_answer","memoryCitation":null},"threadId":"native-v2-nested-root-thread","turnId":"native-v2-nested-root-turn","completedAtMs":1782622515859}}}
+{"type":"emit_inbound","label":"thread/status/changed/root-idle","frame":{"method":"thread/status/changed","params":{"threadId":"native-v2-nested-root-thread","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"native-v2-nested-root-thread","turn":{"id":"native-v2-nested-root-turn","items":[],"itemsView":"notLoaded","status":"completed","error":null,"startedAt":1782622500,"completedAt":1782622515,"durationMs":15598}}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/thread_fork_native/claude_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/thread_fork_native/claude_transcript.ndjson
new file mode 100644
index 000000000000..f1cb48cd8b07
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/thread_fork_native/claude_transcript.ndjson
@@ -0,0 +1,21 @@
+{"type":"transcript_start","provider":"claudeAgent","protocol":"claude-agent-sdk.query","version":"0.2.111","scenario":"thread_fork_native","metadata":{"prompts":["Respond with the following text: source fork seed ok","Respond with the following text: fork native ok"],"model":"claude-sonnet-4-6","nativeSessionId":"8d0dafab-45d3-45eb-abef-41b9e55d5ff9","queryMode":"fork_session","tools":"claude_code","permissionMode":"bypassPermissions","generatedBy":"recordClaudeAgentSdkReplayTranscript","sourceAssistantMessageUuids":["68baa075-b7d4-4689-866b-96bd51e570c3"],"forkUpToMessageId":"68baa075-b7d4-4689-866b-96bd51e570c3","forkedNativeSessionId":"7e7ad6ec-db4a-4510-85ff-59df35cf7fad"}}
+{"type":"expect_outbound","label":"query.open:source","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"sessionId":"8d0dafab-45d3-45eb-abef-41b9e55d5ff9"}}}
+{"type":"expect_outbound","label":"prompt.offer:1","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Respond with the following text: source fork seed ok"},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"72dd9de7-b5a9-46bf-9c57-9bca11344e73","hook_name":"SessionStart:startup","hook_event":"SessionStart","uuid":"4edf7621-d696-4b60-9821-187bcac04c7d","session_id":"8d0dafab-45d3-45eb-abef-41b9e55d5ff9"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"72dd9de7-b5a9-46bf-9c57-9bca11344e73","hook_name":"SessionStart:startup","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"6959d784-05f0-48b4-97de-d3f4a11b4b1a","session_id":"8d0dafab-45d3-45eb-abef-41b9e55d5ff9"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.111","cwd":"/tmp/claude-replay-thread_fork_native","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"fd90233b-ff4e-429c-a3b2-088d9b3bafc8","session_id":"8d0dafab-45d3-45eb-abef-41b9e55d5ff9"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01RzC6FfR9RGxxVcrpBK6duZ","type":"message","role":"assistant","content":[{"type":"text","text":"source fork seed ok"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":2339,"cache_read_input_tokens":9455,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2339},"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"8d0dafab-45d3-45eb-abef-41b9e55d5ff9","uuid":"68baa075-b7d4-4689-866b-96bd51e570c3"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed"},"uuid":"84451d3f-e7ba-4d80-aea3-4fbc442f4b3b","session_id":"8d0dafab-45d3-45eb-abef-41b9e55d5ff9"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":2066,"duration_api_ms":1815,"num_turns":1,"result":"source fork seed ok","stop_reason":"end_turn","session_id":"8d0dafab-45d3-45eb-abef-41b9e55d5ff9","total_cost_usd":0.01172175,"usage":{"input_tokens":3,"cache_creation_input_tokens":2339,"cache_read_input_tokens":9455,"output_tokens":7,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":2339,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[{"input_tokens":3,"output_tokens":7,"cache_read_input_tokens":9455,"cache_creation_input_tokens":2339,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2339},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":3,"outputTokens":7,"cacheReadInputTokens":9455,"cacheCreationInputTokens":2339,"webSearchRequests":0,"costUSD":0.01172175,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"892cdc1f-e2d5-440d-ae57-ca27d32f63f1"}}
+{"type":"runtime_exit","status":"success"}
+{"type":"expect_outbound","label":"session.fork","frame":{"type":"session.fork","sessionId":"8d0dafab-45d3-45eb-abef-41b9e55d5ff9","options":{"dir":"/tmp/claude-replay-thread_fork_native","upToMessageId":"68baa075-b7d4-4689-866b-96bd51e570c3"}}}
+{"type":"emit_inbound","label":"session.forked","frame":{"type":"session.forked","sessionId":"7e7ad6ec-db4a-4510-85ff-59df35cf7fad"}}
+{"type":"expect_outbound","label":"query.open:fork","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"resume":"7e7ad6ec-db4a-4510-85ff-59df35cf7fad"}}}
+{"type":"expect_outbound","label":"prompt.offer:2","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Respond with the following text: fork native ok"},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"53ad62fa-7988-4d2e-9efd-e923756eb7e5","hook_name":"SessionStart:resume","hook_event":"SessionStart","uuid":"c2160988-c159-4ace-abd3-1eb6bbaa76ad","session_id":"d2c41d57-6ad4-4c9e-9444-f93bc492aa53"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"53ad62fa-7988-4d2e-9efd-e923756eb7e5","hook_name":"SessionStart:resume","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"fa30d315-9265-40ec-afbe-c76704c6d66c","session_id":"d2c41d57-6ad4-4c9e-9444-f93bc492aa53"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.111","cwd":"/tmp/claude-replay-thread_fork_native","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"41edb892-5f02-4bdd-bef3-5945d3414fc8","session_id":"7e7ad6ec-db4a-4510-85ff-59df35cf7fad"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01MvGdK8D9o71fU1raKAbM69","type":"message","role":"assistant","content":[{"type":"text","text":"fork native ok"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":20,"cache_read_input_tokens":11794,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":20},"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"7e7ad6ec-db4a-4510-85ff-59df35cf7fad","uuid":"b800a4dd-77a5-4e68-acac-1c651a50a02e"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed"},"uuid":"91026341-c039-4110-928f-4ab67cd13375","session_id":"7e7ad6ec-db4a-4510-85ff-59df35cf7fad"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":4452,"duration_api_ms":3680,"num_turns":1,"result":"fork native ok","stop_reason":"end_turn","session_id":"7e7ad6ec-db4a-4510-85ff-59df35cf7fad","total_cost_usd":0.0037122,"usage":{"input_tokens":3,"cache_creation_input_tokens":20,"cache_read_input_tokens":11794,"output_tokens":6,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":20,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[{"input_tokens":3,"output_tokens":6,"cache_read_input_tokens":11794,"cache_creation_input_tokens":20,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":20},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":3,"outputTokens":6,"cacheReadInputTokens":11794,"cacheCreationInputTokens":20,"webSearchRequests":0,"costUSD":0.0037122,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"cc267266-37bf-4cac-a602-ecfabd1e8170"}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/thread_fork_native/codex_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/thread_fork_native/codex_transcript.ndjson
new file mode 100644
index 000000000000..2a2420c557fa
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/thread_fork_native/codex_transcript.ndjson
@@ -0,0 +1,21 @@
+{"type":"transcript_start","provider":"codex","protocol":"codex.app-server","version":"0.120.0","scenario":"thread_fork_native","metadata":{"source":"hand-authored-replay","description":"One completed source turn, a native thread/fork, and the first target fork turn."}}
+{"type":"expect_outbound","label":"initialize/source","frame":{"id":1,"method":"initialize","params":{"capabilities":{"experimentalApi":true},"clientInfo":{"name":"t3code_desktop","title":"T3 Code Desktop","version":"0.1.0"}}}}
+{"type":"emit_inbound","label":"initialize/source","frame":{"id":1,"result":{"userAgent":"t3code_desktop/0.120.0","codexHome":"/tmp/codex","platformFamily":"unix","platformOs":"macos"}}}
+{"type":"expect_outbound","label":"initialized/source","frame":{"method":"initialized"}}
+{"type":"expect_outbound","label":"thread/start/source","frame":{"id":2,"method":"thread/start","params":{}}}
+{"type":"emit_inbound","label":"thread/start/source","frame":{"id":2,"result":{"thread":{"id":"native-source-thread","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1776739349,"updatedAt":1776739349,"status":{"type":"idle"},"path":"/tmp/source.jsonl","cwd":"/tmp/project","cliVersion":"0.120.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]},"model":"gpt-5.4","modelProvider":"openai","serviceTier":"fast","cwd":"/tmp/project","approvalPolicy":"on-request","approvalsReviewer":"user","sandbox":{"type":"workspaceWrite","writableRoots":[],"readOnlyAccess":{"type":"fullAccess"},"networkAccess":false,"excludeTmpdirEnvVar":false,"excludeSlashTmp":false},"reasoningEffort":"xhigh"}}}
+{"type":"expect_outbound","label":"turn/start/source","frame":{"id":3,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Respond with the following text: source fork seed ok","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"type":"dangerFullAccess"},"threadId":"native-source-thread","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"turn/start/source","frame":{"id":3,"result":{"turn":{"id":"native-source-turn","items":[],"status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"turn/started/source","frame":{"method":"turn/started","params":{"threadId":"native-source-thread","turn":{"id":"native-source-turn","items":[],"status":"inProgress","error":null,"startedAt":1776739349,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"item/completed/source-user","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"native-source-user-item","content":[{"type":"text","text":"Respond with the following text: source fork seed ok","text_elements":[]}]},"threadId":"native-source-thread","turnId":"native-source-turn"}}}
+{"type":"emit_inbound","label":"item/completed/source-agent","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"native-source-agent-item","text":"source fork seed ok","phase":"final_answer","memoryCitation":null},"threadId":"native-source-thread","turnId":"native-source-turn"}}}
+{"type":"emit_inbound","label":"turn/completed/source","frame":{"method":"turn/completed","params":{"threadId":"native-source-thread","turn":{"id":"native-source-turn","items":[],"status":"completed","error":null,"startedAt":1776739349,"completedAt":1776739356,"durationMs":6434}}}}
+{"type":"expect_outbound","label":"thread/fork","frame":{"id":4,"method":"thread/fork","params":{"threadId":"native-source-thread"}}}
+{"type":"emit_inbound","label":"thread/fork","frame":{"id":4,"result":{"thread":{"id":"native-fork-thread","forkedFromId":"native-source-thread","preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1776739360,"updatedAt":1776739360,"status":{"type":"idle"},"path":"/tmp/fork.jsonl","cwd":"/tmp/project","cliVersion":"0.120.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]},"model":"gpt-5.4","modelProvider":"openai","serviceTier":"fast","cwd":"/tmp/project","approvalPolicy":"on-request","approvalsReviewer":"user","sandbox":{"type":"workspaceWrite","writableRoots":[],"readOnlyAccess":{"type":"fullAccess"},"networkAccess":false,"excludeTmpdirEnvVar":false,"excludeSlashTmp":false},"reasoningEffort":"xhigh"}}}
+{"type":"expect_outbound","label":"turn/start/fork","frame":{"id":5,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Respond with the following text: fork native ok","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"type":"dangerFullAccess"},"threadId":"native-fork-thread","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"turn/start/fork","frame":{"id":5,"result":{"turn":{"id":"native-fork-turn","items":[],"status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"turn/started/fork","frame":{"method":"turn/started","params":{"threadId":"native-fork-thread","turn":{"id":"native-fork-turn","items":[],"status":"inProgress","error":null,"startedAt":1776739361,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"item/completed/fork-user","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"native-fork-user-item","content":[{"type":"text","text":"Respond with the following text: fork native ok","text_elements":[]}]},"threadId":"native-fork-thread","turnId":"native-fork-turn"}}}
+{"type":"emit_inbound","label":"item/completed/fork-agent","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"native-fork-agent-item","text":"fork native ok","phase":"final_answer","memoryCitation":null},"threadId":"native-fork-thread","turnId":"native-fork-turn"}}}
+{"type":"emit_inbound","label":"turn/completed/fork","frame":{"method":"turn/completed","params":{"threadId":"native-fork-thread","turn":{"id":"native-fork-turn","items":[],"status":"completed","error":null,"startedAt":1776739361,"completedAt":1776739363,"durationMs":2000}}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/thread_fork_native_continue/README.md b/apps/server/src/orchestration-v2/testkit/fixtures/thread_fork_native_continue/README.md
new file mode 100644
index 000000000000..0bb565f1e8b7
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/thread_fork_native_continue/README.md
@@ -0,0 +1,49 @@
+# Native Fork Continuation Fixture
+
+This fixture records a provider-native fork followed by two turns on the fork.
+It verifies that:
+
+1. The fork inherits conversation context from its source.
+2. Context introduced on the fork remains available on later fork turns.
+3. The final recall prompt does not contain either marker, so the response must
+   come from provider conversation state.
+
+Both `codex_transcript.ndjson` and `claude_transcript.ndjson` record the same
+logical scenario using each provider's native thread or session mechanism.
+
+## Conversation Graph
+
+```text
+Source provider thread
+|
++-- Turn 1
+|   User: remember source-marker-7Q9V
+|   Assistant: source marker stored
+|
+`-- native fork after Turn 1
+    |
+    `-- Forked provider thread
+        |
+        +-- Turn 2
+        |   User: remember fork-marker-2K4M
+        |   Assistant: fork marker stored
+        |
+        `-- Turn 3
+            User: recall both markers without restating them
+            Assistant: source-marker-7Q9V|fork-marker-2K4M
+```
+
+## Assertions
+
+- The fork has a native provider thread or session ID distinct from its source.
+- Turn 3's user prompt contains neither opaque marker.
+- Turn 3 returns the source marker first and the fork-local marker second.
+
+The providers may add whitespace around `|`; replay assertions normalize that
+formatting before comparing the semantic result.
+
+## Scope
+
+This is a provider-capability fixture. It proves native fork inheritance and
+continued fork context. It does not record or assert app-level merge-back
+behavior.
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/thread_fork_native_continue/claude_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/thread_fork_native_continue/claude_transcript.ndjson
new file mode 100644
index 000000000000..cd638783fe48
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/thread_fork_native_continue/claude_transcript.ndjson
@@ -0,0 +1,25 @@
+{"type":"transcript_start","provider":"claudeAgent","protocol":"claude-agent-sdk.query","version":"0.2.111","scenario":"thread_fork_native_continue","metadata":{"prompts":["Remember the opaque marker source-marker-7Q9V for later in this conversation. Respond with exactly: source marker stored","Remember the second opaque marker fork-marker-2K4M for later in this conversation. Respond with exactly: fork marker stored","Return the two opaque markers previously provided in chronological order, separated by a single | character. Respond with only the markers and separator."],"model":"claude-sonnet-4-6","nativeSessionId":"ec97110d-6e25-4737-9071-38680f41f305","queryMode":"fork_session_continue","tools":"claude_code","permissionMode":"bypassPermissions","generatedBy":"recordClaudeAgentSdkReplayTranscript","sourceAssistantMessageUuids":["a82bbfaa-01e1-42c0-8cfd-8e513b0814ee"],"forkUpToMessageId":"a82bbfaa-01e1-42c0-8cfd-8e513b0814ee","forkedNativeSessionId":"07ab8628-bbc1-41c3-9e14-0ed8af3651ac"}}
+{"type":"expect_outbound","label":"query.open:source","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"sessionId":"ec97110d-6e25-4737-9071-38680f41f305"}}}
+{"type":"expect_outbound","label":"prompt.offer:1","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Remember the opaque marker source-marker-7Q9V for later in this conversation. Respond with exactly: source marker stored"},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"e69e5e70-7070-47a3-8ed6-684c6508e5e0","hook_name":"SessionStart:startup","hook_event":"SessionStart","uuid":"b84c01b3-4af9-419c-9b7c-8fb430603a24","session_id":"ec97110d-6e25-4737-9071-38680f41f305"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"e69e5e70-7070-47a3-8ed6-684c6508e5e0","hook_name":"SessionStart:startup","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"d076f999-5546-47f9-9b99-bb06dbf7fadb","session_id":"ec97110d-6e25-4737-9071-38680f41f305"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.159","cwd":"/tmp/claude-replay-thread_fork_native_continue","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"a5a55a44-292a-41de-8030-36e3af337e0a","session_id":"ec97110d-6e25-4737-9071-38680f41f305"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_015wswEVVDWXMk7ALAtkQ8X6","type":"message","role":"assistant","content":[{"type":"text","text":"source marker stored"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":2783,"cache_read_input_tokens":16194,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2783},"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"ec97110d-6e25-4737-9071-38680f41f305","uuid":"a82bbfaa-01e1-42c0-8cfd-8e513b0814ee","request_id":"req_011Cbrdy9BoEWCy9YaxrFqcz"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed"},"uuid":"3785a246-1146-4db3-9153-7f6c91e62554","session_id":"ec97110d-6e25-4737-9071-38680f41f305"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":2978,"duration_api_ms":1928,"ttft_ms":1910,"num_turns":1,"result":"source marker stored","stop_reason":"end_turn","session_id":"ec97110d-6e25-4737-9071-38680f41f305","total_cost_usd":0.01539345,"usage":{"input_tokens":3,"cache_creation_input_tokens":2783,"cache_read_input_tokens":16194,"output_tokens":6,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":2783,"ephemeral_5m_input_tokens":0},"inference_geo":"not_available","iterations":[{"input_tokens":3,"output_tokens":6,"cache_read_input_tokens":16194,"cache_creation_input_tokens":2783,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2783},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":3,"outputTokens":6,"cacheReadInputTokens":16194,"cacheCreationInputTokens":2783,"webSearchRequests":0,"costUSD":0.01539345,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"1aefbda2-db0f-40bc-ba5e-dac873fa0f4d"}}
+{"type":"runtime_exit","status":"success"}
+{"type":"expect_outbound","label":"session.fork","frame":{"type":"session.fork","sessionId":"ec97110d-6e25-4737-9071-38680f41f305","options":{"dir":"/tmp/claude-replay-thread_fork_native_continue","upToMessageId":"a82bbfaa-01e1-42c0-8cfd-8e513b0814ee"}}}
+{"type":"emit_inbound","label":"session.forked","frame":{"type":"session.forked","sessionId":"07ab8628-bbc1-41c3-9e14-0ed8af3651ac"}}
+{"type":"expect_outbound","label":"query.open:fork","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"resume":"07ab8628-bbc1-41c3-9e14-0ed8af3651ac"}}}
+{"type":"expect_outbound","label":"prompt.offer:2","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Remember the second opaque marker fork-marker-2K4M for later in this conversation. Respond with exactly: fork marker stored"},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"e8cc877f-a07a-410c-80e7-6d2c8309fe8c","hook_name":"SessionStart:resume","hook_event":"SessionStart","uuid":"0ab192fd-6114-41b7-baa2-683a93bb3d48","session_id":"d7fc5a69-f503-492f-ad0e-791e464d0f75"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"e8cc877f-a07a-410c-80e7-6d2c8309fe8c","hook_name":"SessionStart:resume","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"1ccbe90e-1eb7-45d9-ace2-7fc5f05ed933","session_id":"d7fc5a69-f503-492f-ad0e-791e464d0f75"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.159","cwd":"/tmp/claude-replay-thread_fork_native_continue","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"81aea19a-ca67-4743-889d-8ee8c2ececdf","session_id":"07ab8628-bbc1-41c3-9e14-0ed8af3651ac"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01M35CGHxMAeVJ2bwPMcKsjj","type":"message","role":"assistant","content":[{"type":"text","text":"fork marker stored"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":136,"cache_read_input_tokens":18977,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":136},"output_tokens":6,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"07ab8628-bbc1-41c3-9e14-0ed8af3651ac","uuid":"33970774-b18e-4bf9-bb78-b08d2e1085eb","request_id":"req_011CbrdyUNDeFvnau5cyxM8q"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed"},"uuid":"8fd2f971-b39f-465b-94e8-e33e2c698ace","session_id":"07ab8628-bbc1-41c3-9e14-0ed8af3651ac"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":2711,"duration_api_ms":1768,"ttft_ms":2232,"num_turns":1,"result":"fork marker stored","stop_reason":"end_turn","session_id":"07ab8628-bbc1-41c3-9e14-0ed8af3651ac","total_cost_usd":0.006302100000000001,"usage":{"input_tokens":3,"cache_creation_input_tokens":136,"cache_read_input_tokens":18977,"output_tokens":6,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":136,"ephemeral_5m_input_tokens":0},"inference_geo":"not_available","iterations":[{"input_tokens":3,"output_tokens":6,"cache_read_input_tokens":18977,"cache_creation_input_tokens":136,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":136},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":3,"outputTokens":6,"cacheReadInputTokens":18977,"cacheCreationInputTokens":136,"webSearchRequests":0,"costUSD":0.006302100000000001,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"f0b7f4b3-446d-465a-9518-98a4bd85190e"}}
+{"type":"expect_outbound","label":"prompt.offer:3","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Return the two opaque markers previously provided in chronological order, separated by a single | character. Respond with only the markers and separator."},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.159","cwd":"/tmp/claude-replay-thread_fork_native_continue","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"c66e8e65-fc24-42c8-a6c4-96085ae1b682","session_id":"07ab8628-bbc1-41c3-9e14-0ed8af3651ac"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01LvikUbyD2Jid97f8q8MUnP","type":"message","role":"assistant","content":[{"type":"text","text":"source-marker-7Q9V | fork-marker-2K4M"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":38,"cache_read_input_tokens":19113,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":38},"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"07ab8628-bbc1-41c3-9e14-0ed8af3651ac","uuid":"4d63fe38-f2b9-4112-8c35-347bee5ffe81","request_id":"req_011CbrdyfTDMCoDxxqAckUGN"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":2717,"duration_api_ms":3802,"ttft_ms":2303,"num_turns":1,"result":"source-marker-7Q9V | fork-marker-2K4M","stop_reason":"end_turn","session_id":"07ab8628-bbc1-41c3-9e14-0ed8af3651ac","total_cost_usd":0.012487500000000002,"usage":{"input_tokens":3,"cache_creation_input_tokens":38,"cache_read_input_tokens":19113,"output_tokens":20,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":38,"ephemeral_5m_input_tokens":0},"inference_geo":"not_available","iterations":[{"input_tokens":3,"output_tokens":20,"cache_read_input_tokens":19113,"cache_creation_input_tokens":38,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":38},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":6,"outputTokens":26,"cacheReadInputTokens":38090,"cacheCreationInputTokens":174,"webSearchRequests":0,"costUSD":0.012487500000000002,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"76b4538f-0ec8-49b8-bd04-ac000bc6dfcd"}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/thread_fork_native_continue/codex_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/thread_fork_native_continue/codex_transcript.ndjson
new file mode 100644
index 000000000000..5805ae0eb6bd
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/thread_fork_native_continue/codex_transcript.ndjson
@@ -0,0 +1,96 @@
+{"type":"transcript_start","provider":"codex","protocol":"codex.app-server","version":"0.137.0","scenario":"thread_fork_native_continue","metadata":{"source":"record-codex-app-server-replay-fixture","fileName":"thread_fork_native_continue.ndjson","description":"One source marker turn, a native thread fork, a fork-local marker turn, and a recall turn that requires both contexts."}}
+{"type":"expect_outbound","label":"initialize","frame":{"id":1,"method":"initialize","params":{"capabilities":{"experimentalApi":true},"clientInfo":{"name":"t3code_desktop","title":"T3 Code Desktop","version":"0.1.0"}}}}
+{"type":"emit_inbound","label":"initialize","frame":{"id":1,"result":{"userAgent":"t3code_desktop/0.137.0 (Mac OS 26.5.1; arm64) dumb (t3code_desktop; 0.1.0)","codexHome":"/Users/julius/.codex","platformFamily":"unix","platformOs":"macos"}}}
+{"type":"expect_outbound","label":"initialized","frame":{"method":"initialized"}}
+{"type":"expect_outbound","label":"thread/start","frame":{"id":2,"method":"thread/start","params":{}}}
+{"type":"emit_inbound","label":"remoteControl/status/changed","frame":{"method":"remoteControl/status/changed","params":{"status":"disabled","serverName":"Juliuss-MacBook-Pro.local","installationId":"c067a38f-79bf-4874-ba7b-c00e86012954","environmentId":null}}}
+{"type":"emit_inbound","label":"thread/start","frame":{"id":2,"result":{"thread":{"id":"019ea981-51d9-7ba2-a200-6937187e3928","sessionId":"019ea981-51d9-7ba2-a200-6937187e3928","forkedFromId":null,"parentThreadId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1780960285,"updatedAt":1780960285,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/06/08/rollout-2026-06-08T16-11-25-019ea981-51d9-7ba2-a200-6937187e3928.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server","cliVersion":"0.137.0","source":"vscode","threadSource":null,"agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]},"model":"kindle-alpha","modelProvider":"openai","serviceTier":null,"cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server","runtimeWorkspaceRoots":["/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server"],"instructionSources":["/Users/julius/.codex/AGENTS.md","/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/AGENTS.md"],"approvalPolicy":"on-request","approvalsReviewer":"user","sandbox":{"type":"workspaceWrite","writableRoots":[],"networkAccess":false,"excludeTmpdirEnvVar":false,"excludeSlashTmp":false},"activePermissionProfile":{"id":":workspace","extends":null},"reasoningEffort":"medium"}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":3,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Remember the opaque marker source-marker-7Q9V for later in this conversation. Respond with exactly: source marker stored","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"type":"dangerFullAccess"},"threadId":"019ea981-51d9-7ba2-a200-6937187e3928","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"thread/started","frame":{"method":"thread/started","params":{"thread":{"id":"019ea981-51d9-7ba2-a200-6937187e3928","sessionId":"019ea981-51d9-7ba2-a200-6937187e3928","forkedFromId":null,"parentThreadId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1780960285,"updatedAt":1780960285,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/06/08/rollout-2026-06-08T16-11-25-019ea981-51d9-7ba2-a200-6937187e3928.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server","cliVersion":"0.137.0","source":"vscode","threadSource":null,"agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]}}}}
+{"type":"emit_inbound","label":"deprecationNotice","frame":{"method":"deprecationNotice","params":{"summary":"`[features].collab` is deprecated. Use `[features].multi_agent` instead.","details":"Enable it with `--enable multi_agent` or `[features].multi_agent` in config.toml. See https://developers.openai.com/codex/config-basic#feature-flags for details."}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"node_repl","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"computer-use","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"openaiDeveloperDocs","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"xcodebuildmcp","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"node_repl","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":3,"result":{"turn":{"id":"019ea981-539b-7650-a091-e03174d8e009","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"computer-use","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019ea981-51d9-7ba2-a200-6937187e3928","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019ea981-51d9-7ba2-a200-6937187e3928","turn":{"id":"019ea981-539b-7650-a091-e03174d8e009","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":1780960285,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"openaiDeveloperDocs","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"xcodebuildmcp","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"024dc3fe-b529-40cb-b948-ae403129811d","clientId":null,"content":[{"type":"text","text":"Remember the opaque marker source-marker-7Q9V for later in this conversation. Respond with exactly: source marker stored","text_elements":[]}]},"threadId":"019ea981-51d9-7ba2-a200-6937187e3928","turnId":"019ea981-539b-7650-a091-e03174d8e009","startedAtMs":1780960288755}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"024dc3fe-b529-40cb-b948-ae403129811d","clientId":null,"content":[{"type":"text","text":"Remember the opaque marker source-marker-7Q9V for later in this conversation. Respond with exactly: source marker stored","text_elements":[]}]},"threadId":"019ea981-51d9-7ba2-a200-6937187e3928","turnId":"019ea981-539b-7650-a091-e03174d8e009","completedAtMs":1780960288755}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_033096791f6ecb8a016a274c21e078819b8210e40617e54a06","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019ea981-51d9-7ba2-a200-6937187e3928","turnId":"019ea981-539b-7650-a091-e03174d8e009","startedAtMs":1780960289901}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea981-51d9-7ba2-a200-6937187e3928","turnId":"019ea981-539b-7650-a091-e03174d8e009","itemId":"msg_033096791f6ecb8a016a274c21e078819b8210e40617e54a06","delta":"source"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea981-51d9-7ba2-a200-6937187e3928","turnId":"019ea981-539b-7650-a091-e03174d8e009","itemId":"msg_033096791f6ecb8a016a274c21e078819b8210e40617e54a06","delta":" marker"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea981-51d9-7ba2-a200-6937187e3928","turnId":"019ea981-539b-7650-a091-e03174d8e009","itemId":"msg_033096791f6ecb8a016a274c21e078819b8210e40617e54a06","delta":" stored"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_033096791f6ecb8a016a274c21e078819b8210e40617e54a06","text":"source marker stored","phase":"final_answer","memoryCitation":null},"threadId":"019ea981-51d9-7ba2-a200-6937187e3928","turnId":"019ea981-539b-7650-a091-e03174d8e009","completedAtMs":1780960289969}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019ea981-51d9-7ba2-a200-6937187e3928","turnId":"019ea981-539b-7650-a091-e03174d8e009","tokenUsage":{"total":{"totalTokens":18446,"inputTokens":18439,"cachedInputTokens":9088,"outputTokens":7,"reasoningOutputTokens":0},"last":{"totalTokens":18446,"inputTokens":18439,"cachedInputTokens":9088,"outputTokens":7,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1780968999},"secondary":{"usedPercent":3,"windowDurationMins":10080,"resetsAt":1781296757},"credits":null,"individualLimit":null,"planType":"pro","rateLimitReachedType":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019ea981-51d9-7ba2-a200-6937187e3928","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019ea981-51d9-7ba2-a200-6937187e3928","turn":{"id":"019ea981-539b-7650-a091-e03174d8e009","items":[],"itemsView":"notLoaded","status":"completed","error":null,"startedAt":1780960285,"completedAt":1780960289,"durationMs":4325}}}}
+{"type":"expect_outbound","label":"thread/fork","frame":{"id":4,"method":"thread/fork","params":{"threadId":"019ea981-51d9-7ba2-a200-6937187e3928"}}}
+{"type":"emit_inbound","label":"deprecationNotice","frame":{"method":"deprecationNotice","params":{"summary":"`[features].collab` is deprecated. Use `[features].multi_agent` instead.","details":"Enable it with `--enable multi_agent` or `[features].multi_agent` in config.toml. See https://developers.openai.com/codex/config-basic#feature-flags for details."}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"openaiDeveloperDocs","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"node_repl","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"xcodebuildmcp","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"computer-use","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"node_repl","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"thread/fork","frame":{"id":4,"result":{"thread":{"id":"019ea981-64c4-76b1-9f90-866490b7dd60","sessionId":"019ea981-64c4-76b1-9f90-866490b7dd60","forkedFromId":"019ea981-51d9-7ba2-a200-6937187e3928","parentThreadId":null,"preview":"Remember the opaque marker source-marker-7Q9V for later in this conversation. Respond with exactly: source marker stored","ephemeral":false,"modelProvider":"openai","createdAt":1780960289,"updatedAt":1780960290,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/06/08/rollout-2026-06-08T16-11-30-019ea981-64c4-76b1-9f90-866490b7dd60.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server","cliVersion":"0.137.0","source":"vscode","threadSource":null,"agentNickname":null,"agentRole":null,"gitInfo":{"sha":"5115887f33051a4e25d2b427622a54656eeb9ab0","branch":"t3code/17b43ed6","originUrl":"git@github.com:pingdotgg/t3code.git"},"name":null,"turns":[{"id":"019ea981-539b-7650-a091-e03174d8e009","items":[{"type":"userMessage","id":"item-1","clientId":null,"content":[{"type":"text","text":"Remember the opaque marker source-marker-7Q9V for later in this conversation. Respond with exactly: source marker stored","text_elements":[]}]},{"type":"agentMessage","id":"item-2","text":"source marker stored","phase":"final_answer","memoryCitation":null}],"itemsView":"full","status":"completed","error":null,"startedAt":1780960285,"completedAt":1780960289,"durationMs":4325}]},"model":"kindle-alpha","modelProvider":"openai","serviceTier":null,"cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server","runtimeWorkspaceRoots":["/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server"],"instructionSources":["/Users/julius/.codex/AGENTS.md","/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/AGENTS.md"],"approvalPolicy":"on-request","approvalsReviewer":"user","sandbox":{"type":"workspaceWrite","writableRoots":[],"networkAccess":false,"excludeTmpdirEnvVar":false,"excludeSlashTmp":false},"activePermissionProfile":{"id":":workspace","extends":null},"reasoningEffort":"medium"}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":5,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Remember the second opaque marker fork-marker-2K4M for later in this conversation. Respond with exactly: fork marker stored","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"type":"dangerFullAccess"},"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","turnId":"019ea981-539b-7650-a091-e03174d8e009","tokenUsage":{"total":{"totalTokens":18446,"inputTokens":18439,"cachedInputTokens":9088,"outputTokens":7,"reasoningOutputTokens":0},"last":{"totalTokens":18446,"inputTokens":18439,"cachedInputTokens":9088,"outputTokens":7,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"thread/started","frame":{"method":"thread/started","params":{"thread":{"id":"019ea981-64c4-76b1-9f90-866490b7dd60","sessionId":"019ea981-64c4-76b1-9f90-866490b7dd60","forkedFromId":"019ea981-51d9-7ba2-a200-6937187e3928","parentThreadId":null,"preview":"Remember the opaque marker source-marker-7Q9V for later in this conversation. Respond with exactly: source marker stored","ephemeral":false,"modelProvider":"openai","createdAt":1780960289,"updatedAt":1780960290,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/06/08/rollout-2026-06-08T16-11-30-019ea981-64c4-76b1-9f90-866490b7dd60.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server","cliVersion":"0.137.0","source":"vscode","threadSource":null,"agentNickname":null,"agentRole":null,"gitInfo":{"sha":"5115887f33051a4e25d2b427622a54656eeb9ab0","branch":"t3code/17b43ed6","originUrl":"git@github.com:pingdotgg/t3code.git"},"name":null,"turns":[]}}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":5,"result":{"turn":{"id":"019ea981-662f-70c3-b2e4-9357b2beb122","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","turn":{"id":"019ea981-662f-70c3-b2e4-9357b2beb122","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":1780960290,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"computer-use","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"openaiDeveloperDocs","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"xcodebuildmcp","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"13a3ec40-b839-4190-a15f-263b54ae12e9","clientId":null,"content":[{"type":"text","text":"Remember the second opaque marker fork-marker-2K4M for later in this conversation. Respond with exactly: fork marker stored","text_elements":[]}]},"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","turnId":"019ea981-662f-70c3-b2e4-9357b2beb122","startedAtMs":1780960293090}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"13a3ec40-b839-4190-a15f-263b54ae12e9","clientId":null,"content":[{"type":"text","text":"Remember the second opaque marker fork-marker-2K4M for later in this conversation. Respond with exactly: fork marker stored","text_elements":[]}]},"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","turnId":"019ea981-662f-70c3-b2e4-9357b2beb122","completedAtMs":1780960293090}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_09d1bdad36e20dad016a274c262d4881999249df611ae5658c","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","turnId":"019ea981-662f-70c3-b2e4-9357b2beb122","startedAtMs":1780960294269}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","turnId":"019ea981-662f-70c3-b2e4-9357b2beb122","itemId":"msg_09d1bdad36e20dad016a274c262d4881999249df611ae5658c","delta":"fork"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","turnId":"019ea981-662f-70c3-b2e4-9357b2beb122","itemId":"msg_09d1bdad36e20dad016a274c262d4881999249df611ae5658c","delta":" marker"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","turnId":"019ea981-662f-70c3-b2e4-9357b2beb122","itemId":"msg_09d1bdad36e20dad016a274c262d4881999249df611ae5658c","delta":" stored"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_09d1bdad36e20dad016a274c262d4881999249df611ae5658c","text":"fork marker stored","phase":"final_answer","memoryCitation":null},"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","turnId":"019ea981-662f-70c3-b2e4-9357b2beb122","completedAtMs":1780960294269}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","turnId":"019ea981-662f-70c3-b2e4-9357b2beb122","tokenUsage":{"total":{"totalTokens":36930,"inputTokens":36916,"cachedInputTokens":27392,"outputTokens":14,"reasoningOutputTokens":0},"last":{"totalTokens":18484,"inputTokens":18477,"cachedInputTokens":18304,"outputTokens":7,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1780968999},"secondary":{"usedPercent":3,"windowDurationMins":10080,"resetsAt":1781296757},"credits":null,"individualLimit":null,"planType":"pro","rateLimitReachedType":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","turn":{"id":"019ea981-662f-70c3-b2e4-9357b2beb122","items":[],"itemsView":"notLoaded","status":"completed","error":null,"startedAt":1780960290,"completedAt":1780960294,"durationMs":3942}}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":6,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Return the two opaque markers previously provided in chronological order, separated by a single | character. Respond with only the markers and separator.","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"type":"dangerFullAccess"},"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":6,"result":{"turn":{"id":"019ea981-759a-7e61-90b2-29c4a08825db","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","turn":{"id":"019ea981-759a-7e61-90b2-29c4a08825db","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":1780960294,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"438a8ce6-36e7-42e4-b37d-0689934995b5","clientId":null,"content":[{"type":"text","text":"Return the two opaque markers previously provided in chronological order, separated by a single | character. Respond with only the markers and separator.","text_elements":[]}]},"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","turnId":"019ea981-759a-7e61-90b2-29c4a08825db","startedAtMs":1780960294306}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"438a8ce6-36e7-42e4-b37d-0689934995b5","clientId":null,"content":[{"type":"text","text":"Return the two opaque markers previously provided in chronological order, separated by a single | character. Respond with only the markers and separator.","text_elements":[]}]},"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","turnId":"019ea981-759a-7e61-90b2-29c4a08825db","completedAtMs":1780960294306}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_09d1bdad36e20dad016a274c2945788199af67a52221987a8f","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","turnId":"019ea981-759a-7e61-90b2-29c4a08825db","startedAtMs":1780960297297}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","turnId":"019ea981-759a-7e61-90b2-29c4a08825db","itemId":"msg_09d1bdad36e20dad016a274c2945788199af67a52221987a8f","delta":"source"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","turnId":"019ea981-759a-7e61-90b2-29c4a08825db","itemId":"msg_09d1bdad36e20dad016a274c2945788199af67a52221987a8f","delta":"-marker"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","turnId":"019ea981-759a-7e61-90b2-29c4a08825db","itemId":"msg_09d1bdad36e20dad016a274c2945788199af67a52221987a8f","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","turnId":"019ea981-759a-7e61-90b2-29c4a08825db","itemId":"msg_09d1bdad36e20dad016a274c2945788199af67a52221987a8f","delta":"7"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","turnId":"019ea981-759a-7e61-90b2-29c4a08825db","itemId":"msg_09d1bdad36e20dad016a274c2945788199af67a52221987a8f","delta":"Q"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","turnId":"019ea981-759a-7e61-90b2-29c4a08825db","itemId":"msg_09d1bdad36e20dad016a274c2945788199af67a52221987a8f","delta":"9"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","turnId":"019ea981-759a-7e61-90b2-29c4a08825db","itemId":"msg_09d1bdad36e20dad016a274c2945788199af67a52221987a8f","delta":"V"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","turnId":"019ea981-759a-7e61-90b2-29c4a08825db","itemId":"msg_09d1bdad36e20dad016a274c2945788199af67a52221987a8f","delta":"|"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","turnId":"019ea981-759a-7e61-90b2-29c4a08825db","itemId":"msg_09d1bdad36e20dad016a274c2945788199af67a52221987a8f","delta":"fork"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","turnId":"019ea981-759a-7e61-90b2-29c4a08825db","itemId":"msg_09d1bdad36e20dad016a274c2945788199af67a52221987a8f","delta":"-marker"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","turnId":"019ea981-759a-7e61-90b2-29c4a08825db","itemId":"msg_09d1bdad36e20dad016a274c2945788199af67a52221987a8f","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","turnId":"019ea981-759a-7e61-90b2-29c4a08825db","itemId":"msg_09d1bdad36e20dad016a274c2945788199af67a52221987a8f","delta":"2"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","turnId":"019ea981-759a-7e61-90b2-29c4a08825db","itemId":"msg_09d1bdad36e20dad016a274c2945788199af67a52221987a8f","delta":"K"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","turnId":"019ea981-759a-7e61-90b2-29c4a08825db","itemId":"msg_09d1bdad36e20dad016a274c2945788199af67a52221987a8f","delta":"4"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","turnId":"019ea981-759a-7e61-90b2-29c4a08825db","itemId":"msg_09d1bdad36e20dad016a274c2945788199af67a52221987a8f","delta":"M"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_09d1bdad36e20dad016a274c2945788199af67a52221987a8f","text":"source-marker-7Q9V|fork-marker-2K4M","phase":"final_answer","memoryCitation":null},"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","turnId":"019ea981-759a-7e61-90b2-29c4a08825db","completedAtMs":1780960297433}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","turnId":"019ea981-759a-7e61-90b2-29c4a08825db","tokenUsage":{"total":{"totalTokens":55465,"inputTokens":55432,"cachedInputTokens":45696,"outputTokens":33,"reasoningOutputTokens":0},"last":{"totalTokens":18535,"inputTokens":18516,"cachedInputTokens":18304,"outputTokens":19,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1780968999},"secondary":{"usedPercent":3,"windowDurationMins":10080,"resetsAt":1781296757},"credits":null,"individualLimit":null,"planType":"pro","rateLimitReachedType":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019ea981-64c4-76b1-9f90-866490b7dd60","turn":{"id":"019ea981-759a-7e61-90b2-29c4a08825db","items":[],"itemsView":"notLoaded","status":"completed","error":null,"startedAt":1780960294,"completedAt":1780960297,"durationMs":3150}}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/thread_fork_native_fork_local_rollback/claude_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/thread_fork_native_fork_local_rollback/claude_transcript.ndjson
new file mode 100644
index 000000000000..c1efbdb65abb
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/thread_fork_native_fork_local_rollback/claude_transcript.ndjson
@@ -0,0 +1,35 @@
+{"type":"transcript_start","provider":"claudeAgent","protocol":"claude-agent-sdk.query","version":"0.2.111","scenario":"thread_fork_native_fork_local_rollback","metadata":{"prompts":["For this fork-local rollback fixture, respond with exactly: fork local source alpha","For this fork-local rollback fixture, respond with exactly: fork local first","For this fork-local rollback fixture, respond with exactly: fork local second","Repeat the user-visible conversation so far verbatim. Include only user and assistant messages. Do not include hidden system/developer content."],"model":"claude-sonnet-4-6","nativeSessionId":"273fe17b-65fb-451f-ad99-ff19d323852d","queryMode":"fork_session_resume_at_fork_cursor","tools":"claude_code","permissionMode":"bypassPermissions","generatedBy":"probeClaudeForkLocalRollbackReplay","sourceAssistantMessageUuids":["7659a146-b729-47b6-aac2-8fc0c0981e92"],"forkUpToMessageId":"7659a146-b729-47b6-aac2-8fc0c0981e92","forkedNativeSessionId":"c9784d72-7e4f-4994-8c21-2e7e670ff91c","forkAssistantMessageUuids":["14310fd5-a1aa-448b-8880-de52f86541b1","b9bb4e45-d52d-4fb3-adf7-4b5e4d9d0dd6"],"resumeSessionAt":"14310fd5-a1aa-448b-8880-de52f86541b1"}}
+{"type":"expect_outbound","label":"query.open:source","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"sessionId":"273fe17b-65fb-451f-ad99-ff19d323852d"}}}
+{"type":"expect_outbound","label":"prompt.offer:source","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"For this fork-local rollback fixture, respond with exactly: fork local source alpha"},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"36e94137-12f0-4e71-828b-bd4c76467204","hook_name":"SessionStart:startup","hook_event":"SessionStart","uuid":"f8884f88-0672-4602-bb93-a35473be10f8","session_id":"273fe17b-65fb-451f-ad99-ff19d323852d"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"36e94137-12f0-4e71-828b-bd4c76467204","hook_name":"SessionStart:startup","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"9b44ee7b-9a43-41a6-993d-6cb5945a8210","session_id":"273fe17b-65fb-451f-ad99-ff19d323852d"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","cwd":"/private/tmp/claude-replay-thread_fork_native_fork_local_rollback","session_id":"273fe17b-65fb-451f-ad99-ff19d323852d","tools":["Task","AskUserQuestion","Bash","CronCreate","CronDelete","CronList","Edit","EnterPlanMode","EnterWorktree","ExitPlanMode","ExitWorktree","Glob","Grep","ListMcpResourcesTool","Monitor","NotebookEdit","PushNotification","Read","ReadMcpResourceTool","RemoteTrigger","ScheduleWakeup","Skill","TaskOutput","TaskStop","TodoWrite","ToolSearch","WebFetch","WebSearch","Write","mcp__claude_ai_Google_Drive__authenticate","mcp__claude_ai_Google_Drive__complete_authentication","mcp__uidotsh__uidotsh_fetch"],"mcp_servers":[{"name":"uidotsh","status":"connected"},{"name":"claude.ai Google Drive","status":"needs-auth"}],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":["update-config","debug","simplify","batch","less-permission-prompts","loop","schedule","claude-api","expo-dev-client","ui","agent-browser","native-data-fetching","expo-deployment","btca-cli","uniwind","web-design-guidelines","react-doctor","migrate-nativewind-to-uniwind","building-native-ui","frontend-design","turborepo","vercel-composition-patterns","expo-cicd-workflows","expo-tailwind-setup","coderabbit:review","coderabbit:coderabbit-review","coderabbit:code-review","agent-browser:agent-browser","frontend-design:frontend-design","coderabbit:autofix","compact","context","cost","heapdump","init","review","security-review","extra-usage","insights","team-onboarding"],"apiKeySource":"none","claude_code_version":"2.1.111","output_style":"default","agents":["coderabbit:code-reviewer","Explore","general-purpose","Plan","statusline-setup"],"skills":["update-config","debug","simplify","batch","less-permission-prompts","loop","schedule","claude-api","expo-dev-client","ui","agent-browser","native-data-fetching","expo-deployment","btca-cli","uniwind","web-design-guidelines","react-doctor","migrate-nativewind-to-uniwind","building-native-ui","frontend-design","turborepo","vercel-composition-patterns","expo-cicd-workflows","expo-tailwind-setup","coderabbit:code-review","agent-browser:agent-browser","frontend-design:frontend-design","coderabbit:autofix","coderabbit:code-review"],"plugins":[{"name":"coderabbit","path":"/home/replay-user/.claude/plugins/marketplaces/coderabbit/","source":"coderabbit@coderabbit"},{"name":"agent-browser","path":"/home/replay-user/.claude/plugins/cache/agent-browser/agent-browser/ea17db856473","source":"agent-browser@agent-browser"},{"name":"frontend-design","path":"/home/replay-user/.claude/plugins/cache/claude-plugins-official/frontend-design/unknown","source":"frontend-design@claude-plugins-official"},{"name":"coderabbit","path":"/home/replay-user/.claude/plugins/cache/claude-plugins-official/coderabbit/1.1.1","source":"coderabbit@claude-plugins-official"}],"uuid":"1e7d6f8f-2295-42cb-a413-50274ffe1bdd","memory_paths":{"auto":"/home/replay-user/.claude/projects/-private-var-folders-b3-b51-pdxj7dl0t981zpqkxxhr0000gn-T-t3-orchestrator-v2-claude-agent-sdk-record-thread-fork-native-fork-local-rollback-6isYFV/memory/"},"fast_mode_state":"off"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01GymzntxN7tobzwVerJJDMw","type":"message","role":"assistant","content":[{"type":"text","text":"fork local source alpha"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":11800,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"273fe17b-65fb-451f-ad99-ff19d323852d","uuid":"7659a146-b729-47b6-aac2-8fc0c0981e92"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed","resetsAt":1779846000,"rateLimitType":"five_hour","overageStatus":"rejected","overageDisabledReason":"org_level_disabled","isUsingOverage":false},"uuid":"94e56646-7610-4a7a-8245-9301469861ae","session_id":"273fe17b-65fb-451f-ad99-ff19d323852d"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":2928,"duration_api_ms":1977,"num_turns":1,"result":"fork local source alpha","stop_reason":"end_turn","session_id":"273fe17b-65fb-451f-ad99-ff19d323852d","total_cost_usd":0.0036539999999999997,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":11800,"output_tokens":7,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[{"input_tokens":3,"output_tokens":7,"cache_read_input_tokens":11800,"cache_creation_input_tokens":0,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":3,"outputTokens":7,"cacheReadInputTokens":11800,"cacheCreationInputTokens":0,"webSearchRequests":0,"costUSD":0.0036539999999999997,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"684990a5-0d00-4928-a332-fdc2c66769c6"}}
+{"type":"runtime_exit","status":"success"}
+{"type":"expect_outbound","label":"session.fork","frame":{"type":"session.fork","sessionId":"273fe17b-65fb-451f-ad99-ff19d323852d","options":{"dir":"/tmp/claude-replay-thread_fork_native_fork_local_rollback","upToMessageId":"7659a146-b729-47b6-aac2-8fc0c0981e92"}}}
+{"type":"emit_inbound","label":"session.forked","frame":{"type":"session.forked","sessionId":"c9784d72-7e4f-4994-8c21-2e7e670ff91c"}}
+{"type":"expect_outbound","label":"query.open:fork","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"resume":"c9784d72-7e4f-4994-8c21-2e7e670ff91c"}}}
+{"type":"expect_outbound","label":"prompt.offer:fork-first","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"For this fork-local rollback fixture, respond with exactly: fork local first"},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"b8ac144f-11aa-4f98-96f3-9c9caa8c93ef","hook_name":"SessionStart:resume","hook_event":"SessionStart","uuid":"7e53533c-0f7a-4c67-bed4-0124e8b57438","session_id":"1eb8c977-ac69-4559-8501-92edb5a32f2f"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"b8ac144f-11aa-4f98-96f3-9c9caa8c93ef","hook_name":"SessionStart:resume","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"c176d46f-750b-4bab-9d7a-ab863903a141","session_id":"1eb8c977-ac69-4559-8501-92edb5a32f2f"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","cwd":"/private/tmp/claude-replay-thread_fork_native_fork_local_rollback","session_id":"c9784d72-7e4f-4994-8c21-2e7e670ff91c","tools":["Task","AskUserQuestion","Bash","CronCreate","CronDelete","CronList","Edit","EnterPlanMode","EnterWorktree","ExitPlanMode","ExitWorktree","Glob","Grep","ListMcpResourcesTool","Monitor","NotebookEdit","PushNotification","Read","ReadMcpResourceTool","RemoteTrigger","ScheduleWakeup","Skill","TaskOutput","TaskStop","TodoWrite","ToolSearch","WebFetch","WebSearch","Write","mcp__claude_ai_Google_Drive__authenticate","mcp__claude_ai_Google_Drive__complete_authentication","mcp__uidotsh__uidotsh_fetch"],"mcp_servers":[{"name":"uidotsh","status":"connected"},{"name":"claude.ai Google Drive","status":"needs-auth"}],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":["update-config","debug","simplify","batch","less-permission-prompts","loop","schedule","claude-api","expo-dev-client","ui","agent-browser","native-data-fetching","expo-deployment","btca-cli","uniwind","web-design-guidelines","react-doctor","migrate-nativewind-to-uniwind","building-native-ui","frontend-design","turborepo","vercel-composition-patterns","expo-cicd-workflows","expo-tailwind-setup","coderabbit:review","coderabbit:coderabbit-review","coderabbit:code-review","agent-browser:agent-browser","frontend-design:frontend-design","coderabbit:autofix","compact","context","cost","heapdump","init","review","security-review","extra-usage","insights","team-onboarding"],"apiKeySource":"none","claude_code_version":"2.1.111","output_style":"default","agents":["coderabbit:code-reviewer","Explore","general-purpose","Plan","statusline-setup"],"skills":["update-config","debug","simplify","batch","less-permission-prompts","loop","schedule","claude-api","expo-dev-client","ui","agent-browser","native-data-fetching","expo-deployment","btca-cli","uniwind","web-design-guidelines","react-doctor","migrate-nativewind-to-uniwind","building-native-ui","frontend-design","turborepo","vercel-composition-patterns","expo-cicd-workflows","expo-tailwind-setup","coderabbit:code-review","agent-browser:agent-browser","frontend-design:frontend-design","coderabbit:autofix","coderabbit:code-review"],"plugins":[{"name":"coderabbit","path":"/home/replay-user/.claude/plugins/cache/coderabbit/coderabbit/1.0.0","source":"coderabbit@coderabbit"},{"name":"agent-browser","path":"/home/replay-user/.claude/plugins/cache/agent-browser/agent-browser/ea17db856473","source":"agent-browser@agent-browser"},{"name":"frontend-design","path":"/home/replay-user/.claude/plugins/cache/claude-plugins-official/frontend-design/unknown","source":"frontend-design@claude-plugins-official"},{"name":"coderabbit","path":"/home/replay-user/.claude/plugins/cache/claude-plugins-official/coderabbit/1.1.1","source":"coderabbit@claude-plugins-official"}],"uuid":"741656e7-2341-497c-83bc-89e946bd631f","memory_paths":{"auto":"/home/replay-user/.claude/projects/-private-var-folders-b3-b51-pdxj7dl0t981zpqkxxhr0000gn-T-t3-orchestrator-v2-claude-agent-sdk-record-thread-fork-native-fork-local-rollback-6isYFV/memory/"},"fast_mode_state":"off"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01Fum9PErU1oqWY16swx8VpU","type":"message","role":"assistant","content":[{"type":"text","text":"fork local first"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":11826,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"c9784d72-7e4f-4994-8c21-2e7e670ff91c","uuid":"14310fd5-a1aa-448b-8880-de52f86541b1"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed","resetsAt":1779846000,"rateLimitType":"five_hour","overageStatus":"rejected","overageDisabledReason":"org_level_disabled","isUsingOverage":false},"uuid":"830763b3-7ff2-4b0f-8dd9-35b141cca7a4","session_id":"c9784d72-7e4f-4994-8c21-2e7e670ff91c"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":2891,"duration_api_ms":2011,"num_turns":1,"result":"fork local first","stop_reason":"end_turn","session_id":"c9784d72-7e4f-4994-8c21-2e7e670ff91c","total_cost_usd":0.0036468,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":11826,"output_tokens":6,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[{"input_tokens":3,"output_tokens":6,"cache_read_input_tokens":11826,"cache_creation_input_tokens":0,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":3,"outputTokens":6,"cacheReadInputTokens":11826,"cacheCreationInputTokens":0,"webSearchRequests":0,"costUSD":0.0036468,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"bac4638c-4c4e-4e8d-9361-1c32f538297e"}}
+{"type":"expect_outbound","label":"prompt.offer:fork-second","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"For this fork-local rollback fixture, respond with exactly: fork local second"},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","cwd":"/private/tmp/claude-replay-thread_fork_native_fork_local_rollback","session_id":"c9784d72-7e4f-4994-8c21-2e7e670ff91c","tools":["Task","AskUserQuestion","Bash","CronCreate","CronDelete","CronList","Edit","EnterPlanMode","EnterWorktree","ExitPlanMode","ExitWorktree","Glob","Grep","ListMcpResourcesTool","Monitor","NotebookEdit","PushNotification","Read","ReadMcpResourceTool","RemoteTrigger","ScheduleWakeup","Skill","TaskOutput","TaskStop","TodoWrite","ToolSearch","WebFetch","WebSearch","Write","mcp__claude_ai_Google_Drive__authenticate","mcp__claude_ai_Google_Drive__complete_authentication","mcp__uidotsh__uidotsh_fetch"],"mcp_servers":[{"name":"uidotsh","status":"connected"},{"name":"claude.ai Google Drive","status":"needs-auth"}],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":["update-config","debug","simplify","batch","less-permission-prompts","loop","schedule","claude-api","expo-dev-client","ui","agent-browser","native-data-fetching","expo-deployment","btca-cli","uniwind","web-design-guidelines","react-doctor","migrate-nativewind-to-uniwind","building-native-ui","frontend-design","turborepo","vercel-composition-patterns","expo-cicd-workflows","expo-tailwind-setup","coderabbit:review","coderabbit:coderabbit-review","coderabbit:code-review","agent-browser:agent-browser","frontend-design:frontend-design","coderabbit:autofix","compact","context","cost","heapdump","init","review","security-review","extra-usage","insights","team-onboarding"],"apiKeySource":"none","claude_code_version":"2.1.111","output_style":"default","agents":["coderabbit:code-reviewer","Explore","general-purpose","Plan","statusline-setup"],"skills":["update-config","debug","simplify","batch","less-permission-prompts","loop","schedule","claude-api","expo-dev-client","ui","agent-browser","native-data-fetching","expo-deployment","btca-cli","uniwind","web-design-guidelines","react-doctor","migrate-nativewind-to-uniwind","building-native-ui","frontend-design","turborepo","vercel-composition-patterns","expo-cicd-workflows","expo-tailwind-setup","coderabbit:code-review","agent-browser:agent-browser","frontend-design:frontend-design","coderabbit:autofix","coderabbit:code-review"],"plugins":[{"name":"coderabbit","path":"/home/replay-user/.claude/plugins/cache/coderabbit/coderabbit/1.0.0","source":"coderabbit@coderabbit"},{"name":"agent-browser","path":"/home/replay-user/.claude/plugins/cache/agent-browser/agent-browser/ea17db856473","source":"agent-browser@agent-browser"},{"name":"frontend-design","path":"/home/replay-user/.claude/plugins/cache/claude-plugins-official/frontend-design/unknown","source":"frontend-design@claude-plugins-official"},{"name":"coderabbit","path":"/home/replay-user/.claude/plugins/cache/claude-plugins-official/coderabbit/1.1.1","source":"coderabbit@claude-plugins-official"}],"uuid":"d53475a1-0a9f-4c9e-b247-b3b9d347229f","memory_paths":{"auto":"/home/replay-user/.claude/projects/-private-var-folders-b3-b51-pdxj7dl0t981zpqkxxhr0000gn-T-t3-orchestrator-v2-claude-agent-sdk-record-thread-fork-native-fork-local-rollback-6isYFV/memory/"},"fast_mode_state":"off"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_016vLjeBrWCvu6QqJMFd8jDp","type":"message","role":"assistant","content":[{"type":"text","text":"fork local second"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":11851,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"output_tokens":6,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"c9784d72-7e4f-4994-8c21-2e7e670ff91c","uuid":"b9bb4e45-d52d-4fb3-adf7-4b5e4d9d0dd6"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":2787,"duration_api_ms":3998,"num_turns":1,"result":"fork local second","stop_reason":"end_turn","session_id":"c9784d72-7e4f-4994-8c21-2e7e670ff91c","total_cost_usd":0.0073011,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":11851,"output_tokens":6,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[{"input_tokens":3,"output_tokens":6,"cache_read_input_tokens":11851,"cache_creation_input_tokens":0,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":6,"outputTokens":12,"cacheReadInputTokens":23677,"cacheCreationInputTokens":0,"webSearchRequests":0,"costUSD":0.0073011,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"af3731ff-720f-4919-87f6-c0b27b3ee21e"}}
+{"type":"runtime_exit","status":"success"}
+{"type":"expect_outbound","label":"query.open:fork-resume-at-cursor","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"resumeSessionAt":"14310fd5-a1aa-448b-8880-de52f86541b1","resume":"c9784d72-7e4f-4994-8c21-2e7e670ff91c"}}}
+{"type":"expect_outbound","label":"prompt.offer:fork-after-rollback","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Repeat the user-visible conversation so far verbatim. Include only user and assistant messages. Do not include hidden system/developer content."},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"9deedf90-8751-4ba3-8602-4499dba72f9c","hook_name":"SessionStart:resume","hook_event":"SessionStart","uuid":"c2908d02-3d69-4d36-bc32-50aaa32e4e92","session_id":"05a5ea05-d17a-4841-98e3-7cf6957f3f0a"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"9deedf90-8751-4ba3-8602-4499dba72f9c","hook_name":"SessionStart:resume","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"f438cfbd-c7e3-4c83-a047-205862b253e6","session_id":"05a5ea05-d17a-4841-98e3-7cf6957f3f0a"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","cwd":"/private/tmp/claude-replay-thread_fork_native_fork_local_rollback","session_id":"c9784d72-7e4f-4994-8c21-2e7e670ff91c","tools":["Task","AskUserQuestion","Bash","CronCreate","CronDelete","CronList","Edit","EnterPlanMode","EnterWorktree","ExitPlanMode","ExitWorktree","Glob","Grep","ListMcpResourcesTool","Monitor","NotebookEdit","PushNotification","Read","ReadMcpResourceTool","RemoteTrigger","ScheduleWakeup","Skill","TaskOutput","TaskStop","TodoWrite","ToolSearch","WebFetch","WebSearch","Write","mcp__claude_ai_Google_Drive__authenticate","mcp__claude_ai_Google_Drive__complete_authentication","mcp__uidotsh__uidotsh_fetch"],"mcp_servers":[{"name":"uidotsh","status":"connected"},{"name":"claude.ai Google Drive","status":"needs-auth"}],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":["update-config","debug","simplify","batch","less-permission-prompts","loop","schedule","claude-api","expo-dev-client","ui","agent-browser","native-data-fetching","expo-deployment","btca-cli","uniwind","web-design-guidelines","react-doctor","migrate-nativewind-to-uniwind","building-native-ui","frontend-design","turborepo","vercel-composition-patterns","expo-cicd-workflows","expo-tailwind-setup","coderabbit:review","coderabbit:coderabbit-review","coderabbit:code-review","agent-browser:agent-browser","frontend-design:frontend-design","coderabbit:autofix","compact","context","cost","heapdump","init","review","security-review","extra-usage","insights","team-onboarding"],"apiKeySource":"none","claude_code_version":"2.1.111","output_style":"default","agents":["coderabbit:code-reviewer","Explore","general-purpose","Plan","statusline-setup"],"skills":["update-config","debug","simplify","batch","less-permission-prompts","loop","schedule","claude-api","expo-dev-client","ui","agent-browser","native-data-fetching","expo-deployment","btca-cli","uniwind","web-design-guidelines","react-doctor","migrate-nativewind-to-uniwind","building-native-ui","frontend-design","turborepo","vercel-composition-patterns","expo-cicd-workflows","expo-tailwind-setup","coderabbit:code-review","agent-browser:agent-browser","frontend-design:frontend-design","coderabbit:code-review","coderabbit:autofix"],"plugins":[{"name":"coderabbit","path":"/home/replay-user/.claude/plugins/marketplaces/coderabbit/","source":"coderabbit@coderabbit"},{"name":"agent-browser","path":"/home/replay-user/.claude/plugins/cache/agent-browser/agent-browser/ea17db856473","source":"agent-browser@agent-browser"},{"name":"frontend-design","path":"/home/replay-user/.claude/plugins/cache/claude-plugins-official/frontend-design/unknown","source":"frontend-design@claude-plugins-official"},{"name":"coderabbit","path":"/home/replay-user/.claude/plugins/cache/claude-plugins-official/coderabbit/1.1.1","source":"coderabbit@claude-plugins-official"}],"uuid":"54c3aef7-de37-41de-81e9-b79cf044464b","memory_paths":{"auto":"/home/replay-user/.claude/projects/-private-var-folders-b3-b51-pdxj7dl0t981zpqkxxhr0000gn-T-t3-orchestrator-v2-claude-agent-sdk-record-thread-fork-native-fork-local-rollback-6isYFV/memory/"},"fast_mode_state":"off"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01SMtNaYRbU1BonxpaTu5bxG","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"The user wants me to repeat the user-visible conversation so far verbatim, including only user and assistant messages.","signature":"Er4CCmUIDhgCKkAHbcjlRRK3rHsyqzZn5jI5+wWIl32x7k4E5feJpl1bBZVM6FJVJDBBV5ZgPlHGZMMALoCcDsULDBqzwNbRQ8o0MhFjbGF1ZGUtc29ubmV0LTQtNjgAQgh0aGlua2luZxIMoLzq1u1TRvWwekqBGgwtjzuuwl6xVaBbaIwiMFElE3wNpvOZkdvQJt0d5Iy2NLdr4Wfwrm+7xTXMyx8a6uiOS9qM9NCvBFlNCOV80SqGARBc5k/ENzjBSzsiEbFPeRQi7CV0sm3Csm4WAbC92/ulSlHrBa/+2flxuX4BC24CtUORK7vwEaBjXCmClZibaHWKTmk2cq1SXGzQGifcNR94R5O/B7/oYR/VBEaZb7ctHHXaO7SEifznsRhPibvj9wG4BnxU99aoUgnk1riwYsyEXWsg1rFNGAE="}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":11864,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"output_tokens":8,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"c9784d72-7e4f-4994-8c21-2e7e670ff91c","uuid":"a259ccd5-2f6b-4e3c-9c1a-ce55d21c5ba5"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01SMtNaYRbU1BonxpaTu5bxG","type":"message","role":"assistant","content":[{"type":"text","text":"**User:** For this fork-local rollback fixture, respond with exactly: fork local source alpha\n\n**Assistant:** fork local source alpha\n\n**User:** For this fork-local rollback fixture, respond with exactly: fork local first\n\n**Assistant:** fork local first\n\n**User:** Repeat the user-visible conversation so far verbatim. Include only user and assistant messages. Do not include hidden system/developer content."}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":11864,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"output_tokens":8,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"c9784d72-7e4f-4994-8c21-2e7e670ff91c","uuid":"1ef6575a-75b1-4568-84cb-0eadc9e224e6"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed","resetsAt":1779846000,"rateLimitType":"five_hour","overageStatus":"rejected","overageDisabledReason":"org_level_disabled","isUsingOverage":false},"uuid":"a39eccdb-a0f9-4b39-bbd1-6931138dc5d0","session_id":"c9784d72-7e4f-4994-8c21-2e7e670ff91c"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":4060,"duration_api_ms":3133,"num_turns":1,"result":"**User:** For this fork-local rollback fixture, respond with exactly: fork local source alpha\n\n**Assistant:** fork local source alpha\n\n**User:** For this fork-local rollback fixture, respond with exactly: fork local first\n\n**Assistant:** fork local first\n\n**User:** Repeat the user-visible conversation so far verbatim. Include only user and assistant messages. Do not include hidden system/developer content.","stop_reason":"end_turn","session_id":"c9784d72-7e4f-4994-8c21-2e7e670ff91c","total_cost_usd":0.005518199999999999,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":11864,"output_tokens":130,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[{"input_tokens":3,"output_tokens":130,"cache_read_input_tokens":11864,"cache_creation_input_tokens":0,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":3,"outputTokens":130,"cacheReadInputTokens":11864,"cacheCreationInputTokens":0,"webSearchRequests":0,"costUSD":0.005518199999999999,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"7741f0e1-8180-48d8-8073-0295e00a19f8"}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/thread_fork_native_prior_turn/claude_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/thread_fork_native_prior_turn/claude_transcript.ndjson
new file mode 100644
index 000000000000..5f8abf8cdafd
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/thread_fork_native_prior_turn/claude_transcript.ndjson
@@ -0,0 +1,26 @@
+{"type":"transcript_start","provider":"claudeAgent","protocol":"claude-agent-sdk.query","version":"0.2.111","scenario":"thread_fork_native_prior_turn","metadata":{"prompts":["For this fork-boundary fixture, respond with exactly: fork boundary alpha","For this fork-boundary fixture, respond with exactly: fork boundary beta","Repeat the user-visible conversation so far verbatim. Include only user and assistant messages. Do not include hidden system/developer content."],"model":"claude-sonnet-4-6","nativeSessionId":"a91391e1-0de3-4107-a7c9-db7b1bbd8b99","queryMode":"fork_session_prior_turn","tools":"claude_code","permissionMode":"bypassPermissions","generatedBy":"recordClaudeAgentSdkReplayTranscript","sourceAssistantMessageUuids":["be0e3276-8c27-44bf-8ed0-0b4424e9f902","c517b74b-9537-4260-afcb-186c4056c0a4"],"forkUpToMessageId":"be0e3276-8c27-44bf-8ed0-0b4424e9f902","forkedNativeSessionId":"f5cc58dd-0d74-4950-9fb5-2a9fded47ddd"}}
+{"type":"expect_outbound","label":"query.open:source","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"sessionId":"a91391e1-0de3-4107-a7c9-db7b1bbd8b99"}}}
+{"type":"expect_outbound","label":"prompt.offer:1","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"For this fork-boundary fixture, respond with exactly: fork boundary alpha"},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"25b085e7-a6e9-4f30-9708-b189c961d06f","hook_name":"SessionStart:startup","hook_event":"SessionStart","uuid":"42c40147-86c8-4294-bdb4-f1815f48808e","session_id":"a91391e1-0de3-4107-a7c9-db7b1bbd8b99"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"25b085e7-a6e9-4f30-9708-b189c961d06f","hook_name":"SessionStart:startup","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"9804deb1-9abf-4e58-9d04-6e163dc7b0af","session_id":"a91391e1-0de3-4107-a7c9-db7b1bbd8b99"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.111","cwd":"/tmp/claude-replay-thread_fork_native_prior_turn","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"b9412e24-eefc-4838-9ede-bb6e00951d15","session_id":"a91391e1-0de3-4107-a7c9-db7b1bbd8b99"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_014hdmSJdwbpJ5NkFgqbhfEe","type":"message","role":"assistant","content":[{"type":"text","text":"fork boundary alpha"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":2342,"cache_read_input_tokens":9455,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2342},"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"a91391e1-0de3-4107-a7c9-db7b1bbd8b99","uuid":"be0e3276-8c27-44bf-8ed0-0b4424e9f902"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed"},"uuid":"0c649726-b7a2-4e89-a62a-a9ae534905c7","session_id":"a91391e1-0de3-4107-a7c9-db7b1bbd8b99"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":1174,"duration_api_ms":897,"num_turns":1,"result":"fork boundary alpha","stop_reason":"end_turn","session_id":"a91391e1-0de3-4107-a7c9-db7b1bbd8b99","total_cost_usd":0.011718000000000001,"usage":{"input_tokens":3,"cache_creation_input_tokens":2342,"cache_read_input_tokens":9455,"output_tokens":6,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":2342,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[{"input_tokens":3,"output_tokens":6,"cache_read_input_tokens":9455,"cache_creation_input_tokens":2342,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2342},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":3,"outputTokens":6,"cacheReadInputTokens":9455,"cacheCreationInputTokens":2342,"webSearchRequests":0,"costUSD":0.011718000000000001,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"d384185c-9b38-44a4-8917-53d7a8765a5a"}}
+{"type":"expect_outbound","label":"prompt.offer:2","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"For this fork-boundary fixture, respond with exactly: fork boundary beta"},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.111","cwd":"/tmp/claude-replay-thread_fork_native_prior_turn","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"5fd1f879-e742-4911-95e3-3dfb0141dc52","session_id":"a91391e1-0de3-4107-a7c9-db7b1bbd8b99"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_0181K4CdzyVanM6Px26CQP7L","type":"message","role":"assistant","content":[{"type":"text","text":"fork boundary beta"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":23,"cache_read_input_tokens":11797,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":23},"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"a91391e1-0de3-4107-a7c9-db7b1bbd8b99","uuid":"c517b74b-9537-4260-afcb-186c4056c0a4"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":2545,"duration_api_ms":3001,"num_turns":1,"result":"fork boundary beta","stop_reason":"end_turn","session_id":"a91391e1-0de3-4107-a7c9-db7b1bbd8b99","total_cost_usd":0.01544235,"usage":{"input_tokens":3,"cache_creation_input_tokens":23,"cache_read_input_tokens":11797,"output_tokens":6,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":23,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[{"input_tokens":3,"output_tokens":6,"cache_read_input_tokens":11797,"cache_creation_input_tokens":23,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":23},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":6,"outputTokens":12,"cacheReadInputTokens":21252,"cacheCreationInputTokens":2365,"webSearchRequests":0,"costUSD":0.01544235,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"e4f26af4-3a60-45f3-8d5c-c0f8b968c400"}}
+{"type":"runtime_exit","status":"success"}
+{"type":"expect_outbound","label":"session.fork","frame":{"type":"session.fork","sessionId":"a91391e1-0de3-4107-a7c9-db7b1bbd8b99","options":{"dir":"/tmp/claude-replay-thread_fork_native_prior_turn","upToMessageId":"be0e3276-8c27-44bf-8ed0-0b4424e9f902"}}}
+{"type":"emit_inbound","label":"session.forked","frame":{"type":"session.forked","sessionId":"f5cc58dd-0d74-4950-9fb5-2a9fded47ddd"}}
+{"type":"expect_outbound","label":"query.open:fork","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"resume":"f5cc58dd-0d74-4950-9fb5-2a9fded47ddd"}}}
+{"type":"expect_outbound","label":"prompt.offer:3","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Repeat the user-visible conversation so far verbatim. Include only user and assistant messages. Do not include hidden system/developer content."},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"6ce9327c-4534-484c-96e5-b47fa1a3143f","hook_name":"SessionStart:resume","hook_event":"SessionStart","uuid":"d4280b57-8334-4021-971d-93bba0e38b4c","session_id":"1dc8dab2-9e1b-4475-bd46-f40e2ebca07d"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"6ce9327c-4534-484c-96e5-b47fa1a3143f","hook_name":"SessionStart:resume","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"ac1dee1e-63c5-4db8-81b7-e1f68ecadf01","session_id":"1dc8dab2-9e1b-4475-bd46-f40e2ebca07d"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.111","cwd":"/tmp/claude-replay-thread_fork_native_prior_turn","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"65e2ff1d-ded8-42d2-a491-70fed78b2368","session_id":"f5cc58dd-0d74-4950-9fb5-2a9fded47ddd"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01NP2pmrWJHY1AZ8HWqgsCQS","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"The user wants me to repeat the user-visible conversation so far verbatim, including only user and assistant messages.","signature":"ErQCClsIDRgCKkAHbcjlRRK3rHsyqzZn5jI5+wWIl32x7k4E5feJpl1bBZVM6FJVJDBBV5ZgPlHGZMMALoCcDsULDBqzwNbRQ8o0MhFjbGF1ZGUtc29ubmV0LTQtNjgAEgzxdU+J4dE9HPjPJBwaDFLfMOU1oTIY4zJlVSIwkqZMdRU0W/uaPIztqHfQSORVwpEKdR6RAOJb0t5E+IOBu+tFmopmwfCbQjON3NoEKoYBs8E4pkuYLNz2Q+Qp7XeZOdCvvXUTYVIBJ90r2tl9NtEyDgCKce2VtEShQxnPZH9OhcyuEuKrL8c+Fsc8rTj6vYelMB2UJfj9KI1bREqSwoBf1oD7uwiuOz+S40+1Tx7LprJUcmw+JzkTO73YmVr8EHYGCHbQlLSeUHm7NgypEkTcOAaETiIYAQ=="}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":38,"cache_read_input_tokens":11797,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":38},"output_tokens":7,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"f5cc58dd-0d74-4950-9fb5-2a9fded47ddd","uuid":"3a81c9d0-22dd-4bbd-8f27-103c75e2878c"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01NP2pmrWJHY1AZ8HWqgsCQS","type":"message","role":"assistant","content":[{"type":"text","text":"**User:** For this fork-boundary fixture, respond with exactly: fork boundary alpha\n\n**Assistant:** fork boundary alpha\n\n**User:** Repeat the user-visible conversation so far verbatim. Include only user and assistant messages. Do not include hidden system/developer content."}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":38,"cache_read_input_tokens":11797,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":38},"output_tokens":7,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"f5cc58dd-0d74-4950-9fb5-2a9fded47ddd","uuid":"90f4c83b-8fff-454a-a95d-aa0cf87ff967"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed"},"uuid":"74ba363a-dc66-4335-b18c-b335f75d4c9b","session_id":"f5cc58dd-0d74-4950-9fb5-2a9fded47ddd"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":2557,"duration_api_ms":2194,"num_turns":1,"result":"**User:** For this fork-boundary fixture, respond with exactly: fork boundary alpha\n\n**Assistant:** fork boundary alpha\n\n**User:** Repeat the user-visible conversation so far verbatim. Include only user and assistant messages. Do not include hidden system/developer content.","stop_reason":"end_turn","session_id":"f5cc58dd-0d74-4950-9fb5-2a9fded47ddd","total_cost_usd":0.0051756,"usage":{"input_tokens":3,"cache_creation_input_tokens":38,"cache_read_input_tokens":11797,"output_tokens":99,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":38,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[{"input_tokens":3,"output_tokens":99,"cache_read_input_tokens":11797,"cache_creation_input_tokens":38,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":38},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":3,"outputTokens":99,"cacheReadInputTokens":11797,"cacheCreationInputTokens":38,"webSearchRequests":0,"costUSD":0.0051756,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"6fe96da3-b212-41e9-be7b-12d5aee4f191"}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/thread_fork_native_prior_turn/codex_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/thread_fork_native_prior_turn/codex_transcript.ndjson
new file mode 100644
index 000000000000..2556833b6e13
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/thread_fork_native_prior_turn/codex_transcript.ndjson
@@ -0,0 +1,933 @@
+{"type":"transcript_start","provider":"codex","protocol":"codex.app-server","version":"0.124.0-alpha.3","scenario":"thread_fork_native_prior_turn","metadata":{"source":"codex-app-server-live-probe-normalized-for-orchestrator-replay","description":"Two completed source turns, native thread/fork, rollback of the fork to the first source turn, and a fork turn that only sees the first turn.","sourceThreadId":"019dd6ba-2681-7bf0-b051-141b0cbcbb27","forkThreadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","firstTurnId":"019dd6ba-268b-7f82-8f4c-9fde0edcfd55","secondTurnId":"019dd6ba-416d-7902-95cf-d4179c3f4738","repeatTurnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","normalization":"Native frames are live. Initialize frames are normalized to the T3 adapter client info, and a fork-session initialize was inserted to match orchestrator provider-session lifecycle."}}
+{"type":"expect_outbound","label":"initialize/source","frame":{"id":1,"method":"initialize","params":{"capabilities":{"experimentalApi":true},"clientInfo":{"name":"t3code_desktop","title":"T3 Code Desktop","version":"0.1.0"}}}}
+{"type":"emit_inbound","label":"initialize/source","frame":{"id":1,"result":{"userAgent":"t3code_desktop/0.124.0-alpha.3","codexHome":"/Users/julius/.codex","platformFamily":"unix","platformOs":"macos"}}}
+{"type":"expect_outbound","label":"initialized/source","frame":{"method":"initialized"}}
+{"type":"expect_outbound","label":"thread/start","frame":{"id":2,"method":"thread/start","params":{}}}
+{"type":"emit_inbound","label":"thread/start","frame":{"id":2,"result":{"thread":{"id":"019dd6ba-2681-7bf0-b051-141b0cbcbb27","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1777424017,"updatedAt":1777424017,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/04/28/rollout-2026-04-28T17-53-37-019dd6ba-2681-7bf0-b051-141b0cbcbb27.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1","cliVersion":"0.124.0-alpha.3","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]},"model":"gpt-5.5","modelProvider":"openai","serviceTier":"fast","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1","instructionSources":["/Users/julius/.codex/AGENTS.md","/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/AGENTS.md"],"approvalPolicy":"on-request","approvalsReviewer":"user","sandbox":{"type":"workspaceWrite","writableRoots":["/Users/julius/.codex/memories"],"readOnlyAccess":{"type":"fullAccess"},"networkAccess":false,"excludeTmpdirEnvVar":false,"excludeSlashTmp":false},"permissionProfile":{"network":{"enabled":false},"fileSystem":{"entries":[{"path":{"type":"special","value":{"kind":"root"}},"access":"read"},{"path":{"type":"special","value":{"kind":"current_working_directory"}},"access":"write"},{"path":{"type":"special","value":{"kind":"slash_tmp"}},"access":"write"},{"path":{"type":"special","value":{"kind":"tmpdir"}},"access":"write"},{"path":{"type":"path","path":"/Users/julius/.codex/memories"},"access":"write"},{"path":{"type":"path","path":"/Users/julius/Development/Work/codething-mvp/.git/worktrees/t3code-c1e5e1d1"},"access":"read"},{"path":{"type":"path","path":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/.git"},"access":"read"},{"path":{"type":"path","path":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/.codex"},"access":"read"}]}},"reasoningEffort":"medium"}}}
+{"type":"emit_inbound","label":"thread/started","frame":{"method":"thread/started","params":{"thread":{"id":"019dd6ba-2681-7bf0-b051-141b0cbcbb27","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1777424017,"updatedAt":1777424017,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/04/28/rollout-2026-04-28T17-53-37-019dd6ba-2681-7bf0-b051-141b0cbcbb27.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1","cliVersion":"0.124.0-alpha.3","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]}}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":3,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"type":"text","text":"For this fork-boundary fixture, respond with exactly: fork boundary alpha"}],"model":"gpt-5.4","sandboxPolicy":{"type":"readOnly","networkAccess":false},"threadId":"019dd6ba-2681-7bf0-b051-141b0cbcbb27","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"deprecationNotice","frame":{"method":"deprecationNotice","params":{"summary":"`[features].collab` is deprecated. Use `[features].multi_agent` instead.","details":"Enable it with `--enable multi_agent` or `[features].multi_agent` in config.toml. See https://developers.openai.com/codex/config-basic#feature-flags for details."}}}
+{"type":"emit_inbound","label":"warning","frame":{"method":"warning","params":{"threadId":"019dd6ba-2681-7bf0-b051-141b0cbcbb27","message":"Under-development features enabled: apply_patch_freeform. Under-development features are incomplete and may behave unpredictably. To suppress this warning, set `suppress_unstable_features_warning = true` in /Users/julius/.codex/config.toml."}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"computer-use","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":3,"result":{"turn":{"id":"019dd6ba-268b-7f82-8f4c-9fde0edcfd55","items":[],"status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019dd6ba-2681-7bf0-b051-141b0cbcbb27","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019dd6ba-2681-7bf0-b051-141b0cbcbb27","turn":{"id":"019dd6ba-268b-7f82-8f4c-9fde0edcfd55","items":[],"status":"inProgress","error":null,"startedAt":1777424017,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"computer-use","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"844ba324-a7e8-42c8-9008-70c68163b7e8","content":[{"type":"text","text":"For this fork-boundary fixture, respond with exactly: fork boundary alpha","text_elements":[]}]},"threadId":"019dd6ba-2681-7bf0-b051-141b0cbcbb27","turnId":"019dd6ba-268b-7f82-8f4c-9fde0edcfd55"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"844ba324-a7e8-42c8-9008-70c68163b7e8","content":[{"type":"text","text":"For this fork-boundary fixture, respond with exactly: fork boundary alpha","text_elements":[]}]},"threadId":"019dd6ba-2681-7bf0-b051-141b0cbcbb27","turnId":"019dd6ba-268b-7f82-8f4c-9fde0edcfd55"}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":61,"windowDurationMins":300,"resetsAt":1777429830},"secondary":{"usedPercent":23,"windowDurationMins":10080,"resetsAt":1777959590},"credits":null,"planType":"pro","rateLimitReachedType":null}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"reasoning","id":"rs_0e55e81d6295a5050169f156979d24819b80cbd167a76cda9d","summary":[],"content":[]},"threadId":"019dd6ba-2681-7bf0-b051-141b0cbcbb27","turnId":"019dd6ba-268b-7f82-8f4c-9fde0edcfd55"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"reasoning","id":"rs_0e55e81d6295a5050169f156979d24819b80cbd167a76cda9d","summary":[],"content":[]},"threadId":"019dd6ba-2681-7bf0-b051-141b0cbcbb27","turnId":"019dd6ba-268b-7f82-8f4c-9fde0edcfd55"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_0e55e81d6295a5050169f15697bfc0819bb19113933c189c9a","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019dd6ba-2681-7bf0-b051-141b0cbcbb27","turnId":"019dd6ba-268b-7f82-8f4c-9fde0edcfd55"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-2681-7bf0-b051-141b0cbcbb27","turnId":"019dd6ba-268b-7f82-8f4c-9fde0edcfd55","itemId":"msg_0e55e81d6295a5050169f15697bfc0819bb19113933c189c9a","delta":"fork"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-2681-7bf0-b051-141b0cbcbb27","turnId":"019dd6ba-268b-7f82-8f4c-9fde0edcfd55","itemId":"msg_0e55e81d6295a5050169f15697bfc0819bb19113933c189c9a","delta":" boundary"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-2681-7bf0-b051-141b0cbcbb27","turnId":"019dd6ba-268b-7f82-8f4c-9fde0edcfd55","itemId":"msg_0e55e81d6295a5050169f15697bfc0819bb19113933c189c9a","delta":" alpha"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_0e55e81d6295a5050169f15697bfc0819bb19113933c189c9a","text":"fork boundary alpha","phase":"final_answer","memoryCitation":null},"threadId":"019dd6ba-2681-7bf0-b051-141b0cbcbb27","turnId":"019dd6ba-268b-7f82-8f4c-9fde0edcfd55"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019dd6ba-2681-7bf0-b051-141b0cbcbb27","turnId":"019dd6ba-268b-7f82-8f4c-9fde0edcfd55","tokenUsage":{"total":{"totalTokens":26918,"inputTokens":26900,"cachedInputTokens":3456,"outputTokens":18,"reasoningOutputTokens":9},"last":{"totalTokens":26918,"inputTokens":26900,"cachedInputTokens":3456,"outputTokens":18,"reasoningOutputTokens":9},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":61,"windowDurationMins":300,"resetsAt":1777429830},"secondary":{"usedPercent":23,"windowDurationMins":10080,"resetsAt":1777959590},"credits":null,"planType":"pro","rateLimitReachedType":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019dd6ba-2681-7bf0-b051-141b0cbcbb27","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019dd6ba-2681-7bf0-b051-141b0cbcbb27","turn":{"id":"019dd6ba-268b-7f82-8f4c-9fde0edcfd55","items":[],"status":"completed","error":null,"startedAt":1777424017,"completedAt":1777424023,"durationMs":6880}}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":4,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"type":"text","text":"For this fork-boundary fixture, respond with exactly: fork boundary beta"}],"model":"gpt-5.4","sandboxPolicy":{"type":"readOnly","networkAccess":false},"threadId":"019dd6ba-2681-7bf0-b051-141b0cbcbb27","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":4,"result":{"turn":{"id":"019dd6ba-416d-7902-95cf-d4179c3f4738","items":[],"status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019dd6ba-2681-7bf0-b051-141b0cbcbb27","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019dd6ba-2681-7bf0-b051-141b0cbcbb27","turn":{"id":"019dd6ba-416d-7902-95cf-d4179c3f4738","items":[],"status":"inProgress","error":null,"startedAt":1777424023,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"e8550ffa-7e59-48b3-8fd2-7bbca932ab95","content":[{"type":"text","text":"For this fork-boundary fixture, respond with exactly: fork boundary beta","text_elements":[]}]},"threadId":"019dd6ba-2681-7bf0-b051-141b0cbcbb27","turnId":"019dd6ba-416d-7902-95cf-d4179c3f4738"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"e8550ffa-7e59-48b3-8fd2-7bbca932ab95","content":[{"type":"text","text":"For this fork-boundary fixture, respond with exactly: fork boundary beta","text_elements":[]}]},"threadId":"019dd6ba-2681-7bf0-b051-141b0cbcbb27","turnId":"019dd6ba-416d-7902-95cf-d4179c3f4738"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019dd6ba-2681-7bf0-b051-141b0cbcbb27","turnId":"019dd6ba-416d-7902-95cf-d4179c3f4738","tokenUsage":{"total":{"totalTokens":26918,"inputTokens":26900,"cachedInputTokens":3456,"outputTokens":18,"reasoningOutputTokens":9},"last":{"totalTokens":26918,"inputTokens":26900,"cachedInputTokens":3456,"outputTokens":18,"reasoningOutputTokens":9},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":61,"windowDurationMins":300,"resetsAt":1777429830},"secondary":{"usedPercent":23,"windowDurationMins":10080,"resetsAt":1777959590},"credits":null,"planType":"pro","rateLimitReachedType":null}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_0e55e81d6295a5050169f156990ae4819b9bc7f93dfdd76a91","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019dd6ba-2681-7bf0-b051-141b0cbcbb27","turnId":"019dd6ba-416d-7902-95cf-d4179c3f4738"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-2681-7bf0-b051-141b0cbcbb27","turnId":"019dd6ba-416d-7902-95cf-d4179c3f4738","itemId":"msg_0e55e81d6295a5050169f156990ae4819b9bc7f93dfdd76a91","delta":"fork"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-2681-7bf0-b051-141b0cbcbb27","turnId":"019dd6ba-416d-7902-95cf-d4179c3f4738","itemId":"msg_0e55e81d6295a5050169f156990ae4819b9bc7f93dfdd76a91","delta":" boundary"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-2681-7bf0-b051-141b0cbcbb27","turnId":"019dd6ba-416d-7902-95cf-d4179c3f4738","itemId":"msg_0e55e81d6295a5050169f156990ae4819b9bc7f93dfdd76a91","delta":" beta"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_0e55e81d6295a5050169f156990ae4819b9bc7f93dfdd76a91","text":"fork boundary beta","phase":"final_answer","memoryCitation":null},"threadId":"019dd6ba-2681-7bf0-b051-141b0cbcbb27","turnId":"019dd6ba-416d-7902-95cf-d4179c3f4738"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019dd6ba-2681-7bf0-b051-141b0cbcbb27","turnId":"019dd6ba-416d-7902-95cf-d4179c3f4738","tokenUsage":{"total":{"totalTokens":53852,"inputTokens":53827,"cachedInputTokens":29952,"outputTokens":25,"reasoningOutputTokens":9},"last":{"totalTokens":26934,"inputTokens":26927,"cachedInputTokens":26496,"outputTokens":7,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":61,"windowDurationMins":300,"resetsAt":1777429830},"secondary":{"usedPercent":23,"windowDurationMins":10080,"resetsAt":1777959590},"credits":null,"planType":"pro","rateLimitReachedType":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019dd6ba-2681-7bf0-b051-141b0cbcbb27","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019dd6ba-2681-7bf0-b051-141b0cbcbb27","turn":{"id":"019dd6ba-416d-7902-95cf-d4179c3f4738","items":[],"status":"completed","error":null,"startedAt":1777424023,"completedAt":1777424025,"durationMs":1596}}}}
+{"type":"expect_outbound","label":"thread/fork","frame":{"id":5,"method":"thread/fork","params":{"threadId":"019dd6ba-2681-7bf0-b051-141b0cbcbb27"}}}
+{"type":"emit_inbound","label":"deprecationNotice","frame":{"method":"deprecationNotice","params":{"summary":"`[features].collab` is deprecated. Use `[features].multi_agent` instead.","details":"Enable it with `--enable multi_agent` or `[features].multi_agent` in config.toml. See https://developers.openai.com/codex/config-basic#feature-flags for details."}}}
+{"type":"emit_inbound","label":"warning","frame":{"method":"warning","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","message":"Under-development features enabled: apply_patch_freeform. Under-development features are incomplete and may behave unpredictably. To suppress this warning, set `suppress_unstable_features_warning = true` in /Users/julius/.codex/config.toml."}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"computer-use","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"computer-use","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"thread/fork","frame":{"id":5,"result":{"thread":{"id":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","forkedFromId":"019dd6ba-2681-7bf0-b051-141b0cbcbb27","preview":"For this fork-boundary fixture, respond with exactly: fork boundary alpha","ephemeral":false,"modelProvider":"openai","createdAt":1777424025,"updatedAt":1777424025,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/04/28/rollout-2026-04-28T17-53-45-019dd6ba-47b7-7092-8688-9cf7fe5f6498.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1","cliVersion":"0.124.0-alpha.3","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":{"sha":"969e8ea4fac1f2066ed50dd4f82b5fd0014d8a4d","branch":"t3code/codex-turn-mapping","originUrl":"git@github.com:pingdotgg/t3code.git"},"name":null,"turns":[{"id":"019dd6ba-268b-7f82-8f4c-9fde0edcfd55","items":[{"type":"userMessage","id":"item-1","content":[{"type":"text","text":"For this fork-boundary fixture, respond with exactly: fork boundary alpha","text_elements":[]}]},{"type":"agentMessage","id":"item-2","text":"fork boundary alpha","phase":"final_answer","memoryCitation":null}],"status":"completed","error":null,"startedAt":1777424017,"completedAt":1777424023,"durationMs":6880},{"id":"019dd6ba-416d-7902-95cf-d4179c3f4738","items":[{"type":"userMessage","id":"item-3","content":[{"type":"text","text":"For this fork-boundary fixture, respond with exactly: fork boundary beta","text_elements":[]}]},{"type":"agentMessage","id":"item-4","text":"fork boundary beta","phase":"final_answer","memoryCitation":null}],"status":"completed","error":null,"startedAt":1777424023,"completedAt":1777424025,"durationMs":1596}]},"model":"gpt-5.5","modelProvider":"openai","serviceTier":"fast","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1","instructionSources":["/Users/julius/.codex/AGENTS.md","/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/AGENTS.md"],"approvalPolicy":"on-request","approvalsReviewer":"user","sandbox":{"type":"workspaceWrite","writableRoots":["/Users/julius/.codex/memories"],"readOnlyAccess":{"type":"fullAccess"},"networkAccess":false,"excludeTmpdirEnvVar":false,"excludeSlashTmp":false},"permissionProfile":{"network":{"enabled":false},"fileSystem":{"entries":[{"path":{"type":"special","value":{"kind":"root"}},"access":"read"},{"path":{"type":"special","value":{"kind":"current_working_directory"}},"access":"write"},{"path":{"type":"special","value":{"kind":"slash_tmp"}},"access":"write"},{"path":{"type":"special","value":{"kind":"tmpdir"}},"access":"write"},{"path":{"type":"path","path":"/Users/julius/.codex/memories"},"access":"write"},{"path":{"type":"path","path":"/Users/julius/Development/Work/codething-mvp/.git/worktrees/t3code-c1e5e1d1"},"access":"read"},{"path":{"type":"path","path":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/.git"},"access":"read"},{"path":{"type":"path","path":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/.codex"},"access":"read"}]}},"reasoningEffort":"medium"}}}
+{"type":"expect_outbound","label":"thread/rollback","frame":{"id":6,"method":"thread/rollback","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","numTurns":1}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-416d-7902-95cf-d4179c3f4738","tokenUsage":{"total":{"totalTokens":53852,"inputTokens":53827,"cachedInputTokens":29952,"outputTokens":25,"reasoningOutputTokens":9},"last":{"totalTokens":26934,"inputTokens":26927,"cachedInputTokens":26496,"outputTokens":7,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"thread/started","frame":{"method":"thread/started","params":{"thread":{"id":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","forkedFromId":"019dd6ba-2681-7bf0-b051-141b0cbcbb27","preview":"For this fork-boundary fixture, respond with exactly: fork boundary alpha","ephemeral":false,"modelProvider":"openai","createdAt":1777424025,"updatedAt":1777424025,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/04/28/rollout-2026-04-28T17-53-45-019dd6ba-47b7-7092-8688-9cf7fe5f6498.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1","cliVersion":"0.124.0-alpha.3","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":{"sha":"969e8ea4fac1f2066ed50dd4f82b5fd0014d8a4d","branch":"t3code/codex-turn-mapping","originUrl":"git@github.com:pingdotgg/t3code.git"},"name":null,"turns":[{"id":"019dd6ba-268b-7f82-8f4c-9fde0edcfd55","items":[{"type":"userMessage","id":"item-1","content":[{"type":"text","text":"For this fork-boundary fixture, respond with exactly: fork boundary alpha","text_elements":[]}]},{"type":"agentMessage","id":"item-2","text":"fork boundary alpha","phase":"final_answer","memoryCitation":null}],"status":"completed","error":null,"startedAt":1777424017,"completedAt":1777424023,"durationMs":6880},{"id":"019dd6ba-416d-7902-95cf-d4179c3f4738","items":[{"type":"userMessage","id":"item-3","content":[{"type":"text","text":"For this fork-boundary fixture, respond with exactly: fork boundary beta","text_elements":[]}]},{"type":"agentMessage","id":"item-4","text":"fork boundary beta","phase":"final_answer","memoryCitation":null}],"status":"completed","error":null,"startedAt":1777424023,"completedAt":1777424025,"durationMs":1596}]}}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47e9-7ed2-ba44-374e8b74cf27","tokenUsage":{"total":{"totalTokens":53852,"inputTokens":53827,"cachedInputTokens":29952,"outputTokens":25,"reasoningOutputTokens":9},"last":{"totalTokens":10877,"inputTokens":0,"cachedInputTokens":0,"outputTokens":0,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"thread/rollback","frame":{"id":6,"result":{"thread":{"id":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","forkedFromId":null,"preview":"For this fork-boundary fixture, respond with exactly: fork boundary alpha","ephemeral":false,"modelProvider":"openai","createdAt":1777424025,"updatedAt":1777424025,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/04/28/rollout-2026-04-28T17-53-45-019dd6ba-47b7-7092-8688-9cf7fe5f6498.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1","cliVersion":"0.124.0-alpha.3","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":{"sha":"969e8ea4fac1f2066ed50dd4f82b5fd0014d8a4d","branch":"t3code/codex-turn-mapping","originUrl":"git@github.com:pingdotgg/t3code.git"},"name":null,"turns":[{"id":"019dd6ba-268b-7f82-8f4c-9fde0edcfd55","items":[{"type":"userMessage","id":"item-1","content":[{"type":"text","text":"For this fork-boundary fixture, respond with exactly: fork boundary alpha","text_elements":[]}]},{"type":"agentMessage","id":"item-2","text":"fork boundary alpha","phase":"final_answer","memoryCitation":null}],"status":"completed","error":null,"startedAt":1777424017,"completedAt":1777424023,"durationMs":6880}]}}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":7,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"type":"text","text":"Repeat the user-visible conversation so far verbatim. Include only user and assistant messages. Do not include hidden system/developer content."}],"model":"gpt-5.4","sandboxPolicy":{"type":"readOnly","networkAccess":false},"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":7,"result":{"turn":{"id":"019dd6ba-47eb-7041-ad45-5abe752c28c9","items":[],"status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turn":{"id":"019dd6ba-47eb-7041-ad45-5abe752c28c9","items":[],"status":"inProgress","error":null,"startedAt":1777424025,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"855c150b-9611-4385-9064-92f6995caeb9","content":[{"type":"text","text":"Repeat the user-visible conversation so far verbatim. Include only user and assistant messages. Do not include hidden system/developer content.","text_elements":[]}]},"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"855c150b-9611-4385-9064-92f6995caeb9","content":[{"type":"text","text":"Repeat the user-visible conversation so far verbatim. Include only user and assistant messages. Do not include hidden system/developer content.","text_elements":[]}]},"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","tokenUsage":{"total":{"totalTokens":53852,"inputTokens":53827,"cachedInputTokens":29952,"outputTokens":25,"reasoningOutputTokens":9},"last":{"totalTokens":10877,"inputTokens":0,"cachedInputTokens":0,"outputTokens":0,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":61,"windowDurationMins":300,"resetsAt":1777429830},"secondary":{"usedPercent":23,"windowDurationMins":10080,"resetsAt":1777959590},"credits":null,"planType":"pro","rateLimitReachedType":null}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"reasoning","id":"rs_0b7536498b07e3900169f1569c4fcc81998db1e60f01250900","summary":[],"content":[]},"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"reasoning","id":"rs_0b7536498b07e3900169f1569c4fcc81998db1e60f01250900","summary":[],"content":[]},"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"User"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":":\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"#"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" AG"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"ENTS"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":".md"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" instructions"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" for"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" /"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"Users"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/j"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"uli"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"us"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/."}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"t"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"3"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/work"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"trees"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/c"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"od"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"ething"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-m"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"vp"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/t"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"3"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"code"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-c"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"1"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"e"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"5"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"e"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"1"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"d"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"1"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"<IN"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"STRUCTIONS"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":">\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" include"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"Co"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-auth"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"ored"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-by"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":":"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" cod"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"ex"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" "}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"<cod"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"ex"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"@"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"users"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":".n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"ore"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"ply"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":".github"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":".com"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":">`"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" in"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" commit"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" messages"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" always"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" run"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" project"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" lint"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" scripts"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" before"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" considering"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" any"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" task"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" to"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" be"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" done"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" always"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" implement"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" and"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" run"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" tests"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" for"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" backend"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" changes"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"."}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" add"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" test"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" implementations"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" ("}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"layers"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":")"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" for"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" external"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" services"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" only"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"."}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" don't"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" mock"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" core"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" business"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" logic"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" out"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":".\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"---"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" project"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-doc"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" --"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"#"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" AG"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"ENTS"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":".md"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"##"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Task"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Completion"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Requirements"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" All"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" of"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"bun"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" fmt"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"`,"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"bun"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" lint"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"`,"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" and"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"bun"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" type"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"check"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"`"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" must"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" pass"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" before"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" considering"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" tasks"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" completed"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":".\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" NEVER"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" run"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"bun"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" test"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"`."}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Always"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" use"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"bun"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" run"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" test"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"`"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" ("}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"runs"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Vit"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"est"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":").\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"##"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Project"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Snapshot"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"T"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"3"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Code"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" is"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" a"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" minimal"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" web"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" GUI"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" for"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" using"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" coding"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" agents"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" like"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Cod"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"ex"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" and"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Claude"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":".\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"This"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" repository"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" is"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" a"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" VERY"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" EAR"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"LY"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" W"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"IP"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"."}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Pro"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"posing"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" sweeping"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" changes"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" that"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" improve"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" long"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-term"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" maintain"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"ability"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" is"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" encouraged"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":".\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"##"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Core"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Prior"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"ities"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"1"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"."}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Performance"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" first"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":".\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"2"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"."}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Reliability"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" first"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":".\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"3"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"."}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Keep"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" behavior"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" predictable"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" under"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" load"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" and"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" during"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" failures"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" ("}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"session"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" rest"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"arts"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":","}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" reconnect"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"s"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":","}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" partial"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" streams"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":").\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"If"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" a"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" trade"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"off"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" is"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" required"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":","}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" choose"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" correctness"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" and"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" robustness"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" over"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" short"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-term"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" convenience"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":".\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"##"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Maintain"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"ability"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"Long"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" term"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" maintain"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"ability"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" is"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" a"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" core"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" priority"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"."}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" If"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" you"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" add"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" new"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" functionality"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":","}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" first"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" check"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" if"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" there"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" is"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" shared"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" logic"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" that"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" can"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" be"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" extracted"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" to"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" a"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" separate"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" module"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"."}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Duplicate"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" logic"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" across"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" multiple"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" files"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" is"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" a"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" code"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" smell"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" and"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" should"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" be"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" avoided"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"."}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Don't"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" be"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" afraid"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" to"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" change"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" existing"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" code"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"."}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Don't"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" take"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" shortcuts"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" by"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" just"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" adding"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" local"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" logic"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" to"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" solve"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" a"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" problem"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":".\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"##"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Package"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Roles"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"apps"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/server"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"`:"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Node"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":".js"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Web"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"Socket"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" server"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"."}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Wrap"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"s"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Cod"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"ex"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" app"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-server"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" ("}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"JSON"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-R"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"PC"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" over"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" std"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"io"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"),"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" serves"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" the"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" React"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" web"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" app"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":","}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" and"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" manages"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" provider"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" sessions"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":".\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"apps"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/web"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"`:"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" React"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/V"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"ite"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" UI"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"."}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Own"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"s"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" session"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" UX"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":","}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" conversation"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/event"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" rendering"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":","}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" and"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" client"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-side"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" state"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"."}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Connect"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"s"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" to"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" the"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" server"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" via"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Web"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"Socket"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":".\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"packages"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/contracts"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"`:"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Shared"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" effect"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"Schema"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" schemas"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" and"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Type"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"Script"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" contracts"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" for"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" provider"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" events"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":","}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Web"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"Socket"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" protocol"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":","}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" and"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" model"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/session"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" types"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"."}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Keep"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" this"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" package"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" schema"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-only"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" —"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" no"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" runtime"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" logic"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":".\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"packages"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/shared"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"`:"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Shared"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" runtime"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" utilities"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" consumed"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" by"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" both"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" server"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" and"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" web"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"."}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Uses"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" explicit"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" sub"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"path"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" exports"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" ("}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"e"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":".g"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"."}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"@"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"t"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"3"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"tools"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/shared"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/git"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"`)"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" —"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" no"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" barrel"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" index"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":".\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"##"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Cod"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"ex"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" App"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Server"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" ("}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"Important"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":")\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"T"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"3"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Code"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" is"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" currently"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Cod"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"ex"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-first"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"."}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" The"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" server"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" starts"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"cod"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"ex"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" app"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-server"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"`"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" ("}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"JSON"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-R"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"PC"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" over"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" std"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"io"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":")"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" per"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" provider"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" session"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":","}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" then"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" streams"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" structured"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" events"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" to"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" the"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" browser"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" through"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Web"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"Socket"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" push"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" messages"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":".\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"How"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" we"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" use"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" it"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" in"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" this"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" code"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"base"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":":\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Session"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" startup"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/res"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"ume"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" and"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" turn"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" lifecycle"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" are"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" broker"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"ed"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" in"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"apps"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/server"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/src"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/c"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"od"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"ex"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"App"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"Server"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"Manager"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":".ts"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"`.\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Provider"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" dispatch"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" and"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" thread"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" event"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" logging"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" are"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" coordinated"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" in"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"apps"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/server"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/src"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/provider"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"Manager"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":".ts"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"`.\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Web"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"Socket"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" server"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" routes"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Native"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"Api"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" methods"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" in"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"apps"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/server"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/src"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/ws"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"Server"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":".ts"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"`.\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Web"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" app"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" consumes"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" orches"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"tration"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" domain"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" events"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" via"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Web"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"Socket"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" push"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" on"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" channel"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"or"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"ches"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"tration"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":".domain"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"Event"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"`"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" ("}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"provider"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" runtime"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" activity"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" is"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" projected"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" into"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" orches"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"tration"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" events"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" server"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-side"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":").\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"Docs"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":":\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Cod"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"ex"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" App"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Server"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" docs"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":":"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" https"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"://"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"developers"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":".open"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"ai"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":".com"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/c"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"od"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"ex"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/sdk"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/#"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"app"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-server"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"##"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Reference"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Re"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"pos"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Open"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-source"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Cod"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"ex"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" repo"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":":"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" https"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"://"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"github"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":".com"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/open"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"ai"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/c"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"od"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"ex"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Cod"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"ex"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-M"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"onitor"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" ("}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"T"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"auri"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":","}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" feature"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-com"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"plete"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":","}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" strong"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" reference"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" implementation"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"):"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" https"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"://"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"github"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":".com"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"Dim"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"illian"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/C"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"od"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"ex"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"Monitor"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"Use"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" these"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" as"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" implementation"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" references"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" when"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" designing"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" protocol"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" handling"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":","}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" UX"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" flows"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":","}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" and"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" operational"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" safeguards"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":".\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"</"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"IN"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"STRUCTIONS"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":">"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"<environment"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"_context"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":">\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" "}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" "}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"<cwd"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":">/"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"Users"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/j"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"uli"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"us"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/."}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"t"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"3"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/work"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"trees"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/c"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"od"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"ething"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-m"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"vp"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/t"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"3"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"code"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-c"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"1"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"e"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"5"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"e"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"1"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"d"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"1"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"</"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"cwd"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":">\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" "}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" "}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"<shell"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":">"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"z"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"sh"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"</"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"shell"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":">\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" "}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" "}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"<current"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"_date"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":">"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"202"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"6"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"04"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"28"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"</"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"current"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"_date"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":">\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" "}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" "}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"<timezone"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":">"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"America"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"Los"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"_A"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"ngeles"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"</"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"timezone"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":">\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"</"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"environment"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"_context"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":">\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"User"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":":\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"For"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" this"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" fork"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-bound"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"ary"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" fixture"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":","}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" respond"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" with"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" exactly"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":":"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" fork"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" boundary"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" alpha"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"Assistant"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":":\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"fork"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" boundary"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" alpha"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"User"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":":\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"Repeat"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" the"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" user"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"-visible"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" conversation"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" so"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" far"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" verb"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"atim"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"."}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Include"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" only"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" user"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" and"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" assistant"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" messages"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"."}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" Do"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" not"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" include"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" hidden"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" system"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"/de"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"veloper"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":" content"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","itemId":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","delta":"."}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_0b7536498b07e3900169f1569db3a48199a7192e9f3b34cc8d","text":"User:\n# AGENTS.md instructions for /Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1\n\n<INSTRUCTIONS>\n- include `Co-authored-by: codex <codex@users.noreply.github.com>` in commit messages\n- always run project lint scripts before considering any task to be done\n- always implement and run tests for backend changes. add test implementations (layers) for external services only. don't mock core business logic out.\n\n--- project-doc ---\n\n# AGENTS.md\n\n## Task Completion Requirements\n\n- All of `bun fmt`, `bun lint`, and `bun typecheck` must pass before considering tasks completed.\n- NEVER run `bun test`. Always use `bun run test` (runs Vitest).\n\n## Project Snapshot\n\nT3 Code is a minimal web GUI for using coding agents like Codex and Claude.\n\nThis repository is a VERY EARLY WIP. Proposing sweeping changes that improve long-term maintainability is encouraged.\n\n## Core Priorities\n\n1. Performance first.\n2. Reliability first.\n3. Keep behavior predictable under load and during failures (session restarts, reconnects, partial streams).\n\nIf a tradeoff is required, choose correctness and robustness over short-term convenience.\n\n## Maintainability\n\nLong term maintainability is a core priority. If you add new functionality, first check if there is shared logic that can be extracted to a separate module. Duplicate logic across multiple files is a code smell and should be avoided. Don't be afraid to change existing code. Don't take shortcuts by just adding local logic to solve a problem.\n\n## Package Roles\n\n- `apps/server`: Node.js WebSocket server. Wraps Codex app-server (JSON-RPC over stdio), serves the React web app, and manages provider sessions.\n- `apps/web`: React/Vite UI. Owns session UX, conversation/event rendering, and client-side state. Connects to the server via WebSocket.\n- `packages/contracts`: Shared effect/Schema schemas and TypeScript contracts for provider events, WebSocket protocol, and model/session types. Keep this package schema-only — no runtime logic.\n- `packages/shared`: Shared runtime utilities consumed by both server and web. Uses explicit subpath exports (e.g. `@t3tools/shared/git`) — no barrel index.\n\n## Codex App Server (Important)\n\nT3 Code is currently Codex-first. The server starts `codex app-server` (JSON-RPC over stdio) per provider session, then streams structured events to the browser through WebSocket push messages.\n\nHow we use it in this codebase:\n\n- Session startup/resume and turn lifecycle are brokered in `apps/server/src/codexAppServerManager.ts`.\n- Provider dispatch and thread event logging are coordinated in `apps/server/src/providerManager.ts`.\n- WebSocket server routes NativeApi methods in `apps/server/src/wsServer.ts`.\n- Web app consumes orchestration domain events via WebSocket push on channel `orchestration.domainEvent` (provider runtime activity is projected into orchestration events server-side).\n\nDocs:\n\n- Codex App Server docs: https://developers.openai.com/codex/sdk/#app-server\n\n## Reference Repos\n\n- Open-source Codex repo: https://github.com/openai/codex\n- Codex-Monitor (Tauri, feature-complete, strong reference implementation): https://github.com/Dimillian/CodexMonitor\n\nUse these as implementation references when designing protocol handling, UX flows, and operational safeguards.\n\n</INSTRUCTIONS><environment_context>\n  <cwd>/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1</cwd>\n  <shell>zsh</shell>\n  <current_date>2026-04-28</current_date>\n  <timezone>America/Los_Angeles</timezone>\n</environment_context>\n\nUser:\nFor this fork-boundary fixture, respond with exactly: fork boundary alpha\n\nAssistant:\nfork boundary alpha\n\nUser:\nRepeat the user-visible conversation so far verbatim. Include only user and assistant messages. Do not include hidden system/developer content.","phase":"final_answer","memoryCitation":null},"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turnId":"019dd6ba-47eb-7041-ad45-5abe752c28c9","tokenUsage":{"total":{"totalTokens":81766,"inputTokens":80777,"cachedInputTokens":36480,"outputTokens":989,"reasoningOutputTokens":115},"last":{"totalTokens":27914,"inputTokens":26950,"cachedInputTokens":6528,"outputTokens":964,"reasoningOutputTokens":106},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":61,"windowDurationMins":300,"resetsAt":1777429830},"secondary":{"usedPercent":23,"windowDurationMins":10080,"resetsAt":1777959590},"credits":null,"planType":"pro","rateLimitReachedType":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019dd6ba-47b7-7092-8688-9cf7fe5f6498","turn":{"id":"019dd6ba-47eb-7041-ad45-5abe752c28c9","items":[],"status":"completed","error":null,"startedAt":1777424025,"completedAt":1777424040,"durationMs":14420}}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/thread_fork_native_siblings/README.md b/apps/server/src/orchestration-v2/testkit/fixtures/thread_fork_native_siblings/README.md
new file mode 100644
index 000000000000..e83c638f8665
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/thread_fork_native_siblings/README.md
@@ -0,0 +1,48 @@
+# Native Sibling Forks Fixture
+
+This fixture records two independent provider-native forks from the same source
+turn. It verifies that both forks inherit source context while keeping their
+fork-local context isolated.
+
+Both `codex_transcript.ndjson` and `claude_transcript.ndjson` record the same
+logical scenario using each provider's native thread or session mechanism.
+
+## Conversation Graph
+
+```text
+Source provider thread
+|
+`-- Turn 1
+    User: remember sibling-source-8R3D
+    Assistant: sibling source stored
+    |
+    +-- native fork A after Turn 1
+    |   |
+    |   `-- Turn 2A
+    |       User: remember sibling-first-5L2P and recall source + local
+    |       Assistant: sibling-source-8R3D|sibling-first-5L2P
+    |
+    `-- native fork B after Turn 1
+        |
+        `-- Turn 2B
+            User: remember sibling-second-9N6C and recall source + local
+            Assistant: sibling-source-8R3D|sibling-second-9N6C
+```
+
+Fork B is created from the original source provider thread, not from fork A.
+
+## Assertions
+
+- Fork A and fork B have distinct native provider thread or session IDs.
+- Both fork responses contain the source marker.
+- Fork A contains its own marker and does not contain fork B's marker.
+- Fork B contains its own marker and does not contain fork A's marker.
+
+The providers may add whitespace around `|`; replay assertions normalize that
+formatting before comparing the semantic result.
+
+## Scope
+
+This is a provider-capability fixture. It proves native sibling topology,
+source-context inheritance, and branch isolation. It does not record or assert
+app-level merge-back behavior or the resulting source-thread context.
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/thread_fork_native_siblings/claude_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/thread_fork_native_siblings/claude_transcript.ndjson
new file mode 100644
index 000000000000..93f684136bcc
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/thread_fork_native_siblings/claude_transcript.ndjson
@@ -0,0 +1,32 @@
+{"type":"transcript_start","provider":"claudeAgent","protocol":"claude-agent-sdk.query","version":"0.2.111","scenario":"thread_fork_native_siblings","metadata":{"prompts":["Remember the opaque marker sibling-source-8R3D for later in this conversation. Respond with exactly: sibling source stored","Remember the fork-local marker sibling-first-5L2P. Return the source marker followed by this marker, separated by |. Respond with only the markers and separator.","Remember the fork-local marker sibling-second-9N6C. Return the source marker followed by this marker, separated by |. Respond with only the markers and separator."],"model":"claude-sonnet-4-6","nativeSessionId":"b2ebab8b-5577-4100-8d9a-8cea2947daa4","queryMode":"fork_session_siblings","tools":"claude_code","permissionMode":"bypassPermissions","generatedBy":"recordClaudeAgentSdkReplayTranscript","sourceAssistantMessageUuids":["54be56c8-5ba7-46f8-850a-a117f198d091"],"forkUpToMessageId":"54be56c8-5ba7-46f8-850a-a117f198d091","forkedNativeSessionId":"7c0e27d9-82ee-422f-84d2-724e9a9e15a3","forkedNativeSessionIds":["7c0e27d9-82ee-422f-84d2-724e9a9e15a3","dab0d5d1-6f21-481c-92ef-3507c2f963c6"]}}
+{"type":"expect_outbound","label":"query.open:source","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"sessionId":"b2ebab8b-5577-4100-8d9a-8cea2947daa4"}}}
+{"type":"expect_outbound","label":"prompt.offer:1","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Remember the opaque marker sibling-source-8R3D for later in this conversation. Respond with exactly: sibling source stored"},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"f46351b6-2ac0-41a1-81b4-2228d68e27ce","hook_name":"SessionStart:startup","hook_event":"SessionStart","uuid":"00de780b-06bd-4fb8-bd73-619f48444960","session_id":"b2ebab8b-5577-4100-8d9a-8cea2947daa4"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"f46351b6-2ac0-41a1-81b4-2228d68e27ce","hook_name":"SessionStart:startup","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"d3b39655-21a9-4333-ad72-95a8ca6e75bf","session_id":"b2ebab8b-5577-4100-8d9a-8cea2947daa4"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.159","cwd":"/tmp/claude-replay-thread_fork_native_siblings","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"dd0f967c-e3c5-4c4d-bf03-01cb9524cb49","session_id":"b2ebab8b-5577-4100-8d9a-8cea2947daa4"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01K8TEtyhWcwYd41w9Cdfmyp","type":"message","role":"assistant","content":[{"type":"text","text":"sibling source stored"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":2785,"cache_read_input_tokens":16194,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2785},"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"b2ebab8b-5577-4100-8d9a-8cea2947daa4","uuid":"54be56c8-5ba7-46f8-850a-a117f198d091","request_id":"req_011CbredpKpon7Fe6KFguwKb"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed"},"uuid":"9b7bccf3-65bd-4273-a353-21458b4ad33c","session_id":"b2ebab8b-5577-4100-8d9a-8cea2947daa4"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":2203,"duration_api_ms":1334,"ttft_ms":1338,"num_turns":1,"result":"sibling source stored","stop_reason":"end_turn","session_id":"b2ebab8b-5577-4100-8d9a-8cea2947daa4","total_cost_usd":0.015415950000000001,"usage":{"input_tokens":3,"cache_creation_input_tokens":2785,"cache_read_input_tokens":16194,"output_tokens":7,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":2785,"ephemeral_5m_input_tokens":0},"inference_geo":"not_available","iterations":[{"input_tokens":3,"output_tokens":7,"cache_read_input_tokens":16194,"cache_creation_input_tokens":2785,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2785},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":3,"outputTokens":7,"cacheReadInputTokens":16194,"cacheCreationInputTokens":2785,"webSearchRequests":0,"costUSD":0.015415950000000001,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"dbce593b-36e9-44b7-86f4-77793263ec99"}}
+{"type":"runtime_exit","status":"success"}
+{"type":"expect_outbound","label":"session.fork:1","frame":{"type":"session.fork","sessionId":"b2ebab8b-5577-4100-8d9a-8cea2947daa4","options":{"dir":"/tmp/claude-replay-thread_fork_native_siblings","upToMessageId":"54be56c8-5ba7-46f8-850a-a117f198d091"}}}
+{"type":"emit_inbound","label":"session.forked:1","frame":{"type":"session.forked","sessionId":"7c0e27d9-82ee-422f-84d2-724e9a9e15a3"}}
+{"type":"expect_outbound","label":"query.open:fork:1","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"resume":"7c0e27d9-82ee-422f-84d2-724e9a9e15a3"}}}
+{"type":"expect_outbound","label":"prompt.offer:2","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Remember the fork-local marker sibling-first-5L2P. Return the source marker followed by this marker, separated by |. Respond with only the markers and separator."},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"b2f46bc1-2d26-410b-b245-f5aba8081d50","hook_name":"SessionStart:resume","hook_event":"SessionStart","uuid":"f7b58c2c-1c71-4b73-9a55-ba89994a7179","session_id":"3932747d-dc1a-4384-81c6-9623ef5a6667"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"b2f46bc1-2d26-410b-b245-f5aba8081d50","hook_name":"SessionStart:resume","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"5851b52c-acda-48db-9a1f-f6cacf572d5e","session_id":"3932747d-dc1a-4384-81c6-9623ef5a6667"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.159","cwd":"/tmp/claude-replay-thread_fork_native_siblings","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"f3decd25-065f-454b-9a05-b11af3832054","session_id":"7c0e27d9-82ee-422f-84d2-724e9a9e15a3"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_012tPZydTUsGY7C5DEFHWcFf","type":"message","role":"assistant","content":[{"type":"text","text":"sibling-source-8R3D | sibling-first-5L2P"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":147,"cache_read_input_tokens":18979,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":147},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"7c0e27d9-82ee-422f-84d2-724e9a9e15a3","uuid":"a184a8ec-ec4c-45c2-817c-082db4664952","request_id":"req_011Cbree5hHkj796kAxQPgTu"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed"},"uuid":"9ae5c104-de1c-4697-bf2e-ccc9c13c5b49","session_id":"7c0e27d9-82ee-422f-84d2-724e9a9e15a3"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":2337,"duration_api_ms":1572,"ttft_ms":1966,"num_turns":1,"result":"sibling-source-8R3D | sibling-first-5L2P","stop_reason":"end_turn","session_id":"7c0e27d9-82ee-422f-84d2-724e9a9e15a3","total_cost_usd":0.006583949999999999,"usage":{"input_tokens":3,"cache_creation_input_tokens":147,"cache_read_input_tokens":18979,"output_tokens":22,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":147,"ephemeral_5m_input_tokens":0},"inference_geo":"not_available","iterations":[{"input_tokens":3,"output_tokens":22,"cache_read_input_tokens":18979,"cache_creation_input_tokens":147,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":147},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":3,"outputTokens":22,"cacheReadInputTokens":18979,"cacheCreationInputTokens":147,"webSearchRequests":0,"costUSD":0.006583949999999999,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"db9c4ce3-48bf-41ce-92df-ef9cd3ec104b"}}
+{"type":"runtime_exit","status":"success"}
+{"type":"expect_outbound","label":"session.fork:2","frame":{"type":"session.fork","sessionId":"b2ebab8b-5577-4100-8d9a-8cea2947daa4","options":{"dir":"/tmp/claude-replay-thread_fork_native_siblings","upToMessageId":"54be56c8-5ba7-46f8-850a-a117f198d091"}}}
+{"type":"emit_inbound","label":"session.forked:2","frame":{"type":"session.forked","sessionId":"dab0d5d1-6f21-481c-92ef-3507c2f963c6"}}
+{"type":"expect_outbound","label":"query.open:fork:2","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"resume":"dab0d5d1-6f21-481c-92ef-3507c2f963c6"}}}
+{"type":"expect_outbound","label":"prompt.offer:3","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Remember the fork-local marker sibling-second-9N6C. Return the source marker followed by this marker, separated by |. Respond with only the markers and separator."},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"a28af220-0bc3-4e60-bee3-99bc9d6c0584","hook_name":"SessionStart:resume","hook_event":"SessionStart","uuid":"ea78a327-8320-4ce6-8984-126630c14701","session_id":"4500c567-1357-4db7-9683-232feea0a7ef"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"a28af220-0bc3-4e60-bee3-99bc9d6c0584","hook_name":"SessionStart:resume","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"1ea4f273-66f1-4d95-852b-1ee0bff4fb58","session_id":"4500c567-1357-4db7-9683-232feea0a7ef"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.159","cwd":"/tmp/claude-replay-thread_fork_native_siblings","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"22eef7cd-2092-42b0-850e-8355f62587ca","session_id":"dab0d5d1-6f21-481c-92ef-3507c2f963c6"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01B2wuPm7NkZAn5utuHdf59K","type":"message","role":"assistant","content":[{"type":"text","text":"sibling-source-8R3D | sibling-second-9N6C"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":147,"cache_read_input_tokens":18979,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":147},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"dab0d5d1-6f21-481c-92ef-3507c2f963c6","uuid":"117a4eb6-0e43-4ebd-8c23-a7b0c8a172be","request_id":"req_011CbreeK5CivoWJJ3hffQzL"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed"},"uuid":"91426d33-2995-4b22-8d5c-b0570414ba91","session_id":"dab0d5d1-6f21-481c-92ef-3507c2f963c6"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":2858,"duration_api_ms":2004,"ttft_ms":2326,"num_turns":1,"result":"sibling-source-8R3D | sibling-second-9N6C","stop_reason":"end_turn","session_id":"dab0d5d1-6f21-481c-92ef-3507c2f963c6","total_cost_usd":0.006583949999999999,"usage":{"input_tokens":3,"cache_creation_input_tokens":147,"cache_read_input_tokens":18979,"output_tokens":22,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":147,"ephemeral_5m_input_tokens":0},"inference_geo":"not_available","iterations":[{"input_tokens":3,"output_tokens":22,"cache_read_input_tokens":18979,"cache_creation_input_tokens":147,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":147},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":3,"outputTokens":22,"cacheReadInputTokens":18979,"cacheCreationInputTokens":147,"webSearchRequests":0,"costUSD":0.006583949999999999,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"58c71fb3-7226-4887-930c-a8ed4818d55d"}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/thread_fork_native_siblings/codex_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/thread_fork_native_siblings/codex_transcript.ndjson
new file mode 100644
index 000000000000..68b31064d821
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/thread_fork_native_siblings/codex_transcript.ndjson
@@ -0,0 +1,130 @@
+{"type":"transcript_start","provider":"codex","protocol":"codex.app-server","version":"0.137.0","scenario":"thread_fork_native_siblings","metadata":{"source":"record-codex-app-server-replay-fixture","fileName":"thread_fork_native_siblings.ndjson","description":"One source marker turn and two independent native forks that each recall the source plus only their own fork marker."}}
+{"type":"expect_outbound","label":"initialize","frame":{"id":1,"method":"initialize","params":{"capabilities":{"experimentalApi":true},"clientInfo":{"name":"t3code_desktop","title":"T3 Code Desktop","version":"0.1.0"}}}}
+{"type":"emit_inbound","label":"initialize","frame":{"id":1,"result":{"userAgent":"t3code_desktop/0.137.0 (Mac OS 26.5.1; arm64) dumb (t3code_desktop; 0.1.0)","codexHome":"/Users/julius/.codex","platformFamily":"unix","platformOs":"macos"}}}
+{"type":"expect_outbound","label":"initialized","frame":{"method":"initialized"}}
+{"type":"expect_outbound","label":"thread/start","frame":{"id":2,"method":"thread/start","params":{}}}
+{"type":"emit_inbound","label":"remoteControl/status/changed","frame":{"method":"remoteControl/status/changed","params":{"status":"disabled","serverName":"Juliuss-MacBook-Pro.local","installationId":"c067a38f-79bf-4874-ba7b-c00e86012954","environmentId":null}}}
+{"type":"emit_inbound","label":"thread/start","frame":{"id":2,"result":{"thread":{"id":"019ea989-52ea-7360-b19f-391107d1f7ea","sessionId":"019ea989-52ea-7360-b19f-391107d1f7ea","forkedFromId":null,"parentThreadId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1780960810,"updatedAt":1780960810,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/06/08/rollout-2026-06-08T16-20-09-019ea989-52ea-7360-b19f-391107d1f7ea.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server","cliVersion":"0.137.0","source":"vscode","threadSource":null,"agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]},"model":"kindle-alpha","modelProvider":"openai","serviceTier":null,"cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server","runtimeWorkspaceRoots":["/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server"],"instructionSources":["/Users/julius/.codex/AGENTS.md","/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/AGENTS.md"],"approvalPolicy":"on-request","approvalsReviewer":"user","sandbox":{"type":"workspaceWrite","writableRoots":[],"networkAccess":false,"excludeTmpdirEnvVar":false,"excludeSlashTmp":false},"activePermissionProfile":{"id":":workspace","extends":null},"reasoningEffort":"medium"}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":3,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Remember the opaque marker sibling-source-8R3D for later in this conversation. Respond with exactly: sibling source stored","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"type":"dangerFullAccess"},"threadId":"019ea989-52ea-7360-b19f-391107d1f7ea","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"thread/started","frame":{"method":"thread/started","params":{"thread":{"id":"019ea989-52ea-7360-b19f-391107d1f7ea","sessionId":"019ea989-52ea-7360-b19f-391107d1f7ea","forkedFromId":null,"parentThreadId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1780960810,"updatedAt":1780960810,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/06/08/rollout-2026-06-08T16-20-09-019ea989-52ea-7360-b19f-391107d1f7ea.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server","cliVersion":"0.137.0","source":"vscode","threadSource":null,"agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]}}}}
+{"type":"emit_inbound","label":"deprecationNotice","frame":{"method":"deprecationNotice","params":{"summary":"`[features].collab` is deprecated. Use `[features].multi_agent` instead.","details":"Enable it with `--enable multi_agent` or `[features].multi_agent` in config.toml. See https://developers.openai.com/codex/config-basic#feature-flags for details."}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"openaiDeveloperDocs","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"computer-use","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"node_repl","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"xcodebuildmcp","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"node_repl","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":3,"result":{"turn":{"id":"019ea989-5456-7383-9002-f4f035fa8cb8","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"computer-use","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019ea989-52ea-7360-b19f-391107d1f7ea","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019ea989-52ea-7360-b19f-391107d1f7ea","turn":{"id":"019ea989-5456-7383-9002-f4f035fa8cb8","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":1780960810,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"openaiDeveloperDocs","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"xcodebuildmcp","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"46f51b59-945e-4ca0-8fd0-3eaaaefb6e33","clientId":null,"content":[{"type":"text","text":"Remember the opaque marker sibling-source-8R3D for later in this conversation. Respond with exactly: sibling source stored","text_elements":[]}]},"threadId":"019ea989-52ea-7360-b19f-391107d1f7ea","turnId":"019ea989-5456-7383-9002-f4f035fa8cb8","startedAtMs":1780960813596}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"46f51b59-945e-4ca0-8fd0-3eaaaefb6e33","clientId":null,"content":[{"type":"text","text":"Remember the opaque marker sibling-source-8R3D for later in this conversation. Respond with exactly: sibling source stored","text_elements":[]}]},"threadId":"019ea989-52ea-7360-b19f-391107d1f7ea","turnId":"019ea989-5456-7383-9002-f4f035fa8cb8","completedAtMs":1780960813596}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_0186c77be116345b016a274e2ebe80819888df3c038f847c3a","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019ea989-52ea-7360-b19f-391107d1f7ea","turnId":"019ea989-5456-7383-9002-f4f035fa8cb8","startedAtMs":1780960814738}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-52ea-7360-b19f-391107d1f7ea","turnId":"019ea989-5456-7383-9002-f4f035fa8cb8","itemId":"msg_0186c77be116345b016a274e2ebe80819888df3c038f847c3a","delta":"s"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-52ea-7360-b19f-391107d1f7ea","turnId":"019ea989-5456-7383-9002-f4f035fa8cb8","itemId":"msg_0186c77be116345b016a274e2ebe80819888df3c038f847c3a","delta":"ibling"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-52ea-7360-b19f-391107d1f7ea","turnId":"019ea989-5456-7383-9002-f4f035fa8cb8","itemId":"msg_0186c77be116345b016a274e2ebe80819888df3c038f847c3a","delta":" source"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-52ea-7360-b19f-391107d1f7ea","turnId":"019ea989-5456-7383-9002-f4f035fa8cb8","itemId":"msg_0186c77be116345b016a274e2ebe80819888df3c038f847c3a","delta":" stored"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_0186c77be116345b016a274e2ebe80819888df3c038f847c3a","text":"sibling source stored","phase":"final_answer","memoryCitation":null},"threadId":"019ea989-52ea-7360-b19f-391107d1f7ea","turnId":"019ea989-5456-7383-9002-f4f035fa8cb8","completedAtMs":1780960814870}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019ea989-52ea-7360-b19f-391107d1f7ea","turnId":"019ea989-5456-7383-9002-f4f035fa8cb8","tokenUsage":{"total":{"totalTokens":18447,"inputTokens":18439,"cachedInputTokens":18304,"outputTokens":8,"reasoningOutputTokens":0},"last":{"totalTokens":18447,"inputTokens":18439,"cachedInputTokens":18304,"outputTokens":8,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1780968999},"secondary":{"usedPercent":3,"windowDurationMins":10080,"resetsAt":1781296757},"credits":null,"individualLimit":null,"planType":"pro","rateLimitReachedType":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019ea989-52ea-7360-b19f-391107d1f7ea","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019ea989-52ea-7360-b19f-391107d1f7ea","turn":{"id":"019ea989-5456-7383-9002-f4f035fa8cb8","items":[],"itemsView":"notLoaded","status":"completed","error":null,"startedAt":1780960810,"completedAt":1780960814,"durationMs":4719}}}}
+{"type":"expect_outbound","label":"thread/fork","frame":{"id":4,"method":"thread/fork","params":{"threadId":"019ea989-52ea-7360-b19f-391107d1f7ea"}}}
+{"type":"emit_inbound","label":"deprecationNotice","frame":{"method":"deprecationNotice","params":{"summary":"`[features].collab` is deprecated. Use `[features].multi_agent` instead.","details":"Enable it with `--enable multi_agent` or `[features].multi_agent` in config.toml. See https://developers.openai.com/codex/config-basic#feature-flags for details."}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"openaiDeveloperDocs","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"node_repl","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"xcodebuildmcp","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"computer-use","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"node_repl","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"thread/fork","frame":{"id":4,"result":{"thread":{"id":"019ea989-6721-7b82-bc0c-de6aae7d46e2","sessionId":"019ea989-6721-7b82-bc0c-de6aae7d46e2","forkedFromId":"019ea989-52ea-7360-b19f-391107d1f7ea","parentThreadId":null,"preview":"Remember the opaque marker sibling-source-8R3D for later in this conversation. Respond with exactly: sibling source stored","ephemeral":false,"modelProvider":"openai","createdAt":1780960814,"updatedAt":1780960815,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/06/08/rollout-2026-06-08T16-20-14-019ea989-6721-7b82-bc0c-de6aae7d46e2.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server","cliVersion":"0.137.0","source":"vscode","threadSource":null,"agentNickname":null,"agentRole":null,"gitInfo":{"sha":"5115887f33051a4e25d2b427622a54656eeb9ab0","branch":"t3code/17b43ed6","originUrl":"git@github.com:pingdotgg/t3code.git"},"name":null,"turns":[{"id":"019ea989-5456-7383-9002-f4f035fa8cb8","items":[{"type":"userMessage","id":"item-1","clientId":null,"content":[{"type":"text","text":"Remember the opaque marker sibling-source-8R3D for later in this conversation. Respond with exactly: sibling source stored","text_elements":[]}]},{"type":"agentMessage","id":"item-2","text":"sibling source stored","phase":"final_answer","memoryCitation":null}],"itemsView":"full","status":"completed","error":null,"startedAt":1780960810,"completedAt":1780960814,"durationMs":4719}]},"model":"kindle-alpha","modelProvider":"openai","serviceTier":null,"cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server","runtimeWorkspaceRoots":["/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server"],"instructionSources":["/Users/julius/.codex/AGENTS.md","/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/AGENTS.md"],"approvalPolicy":"on-request","approvalsReviewer":"user","sandbox":{"type":"workspaceWrite","writableRoots":[],"networkAccess":false,"excludeTmpdirEnvVar":false,"excludeSlashTmp":false},"activePermissionProfile":{"id":":workspace","extends":null},"reasoningEffort":"medium"}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":5,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Remember the fork-local marker sibling-first-5L2P. Return the source marker followed by this marker, separated by |. Respond with only the markers and separator.","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"type":"dangerFullAccess"},"threadId":"019ea989-6721-7b82-bc0c-de6aae7d46e2","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019ea989-6721-7b82-bc0c-de6aae7d46e2","turnId":"019ea989-5456-7383-9002-f4f035fa8cb8","tokenUsage":{"total":{"totalTokens":18447,"inputTokens":18439,"cachedInputTokens":18304,"outputTokens":8,"reasoningOutputTokens":0},"last":{"totalTokens":18447,"inputTokens":18439,"cachedInputTokens":18304,"outputTokens":8,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"thread/started","frame":{"method":"thread/started","params":{"thread":{"id":"019ea989-6721-7b82-bc0c-de6aae7d46e2","sessionId":"019ea989-6721-7b82-bc0c-de6aae7d46e2","forkedFromId":"019ea989-52ea-7360-b19f-391107d1f7ea","parentThreadId":null,"preview":"Remember the opaque marker sibling-source-8R3D for later in this conversation. Respond with exactly: sibling source stored","ephemeral":false,"modelProvider":"openai","createdAt":1780960814,"updatedAt":1780960815,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/06/08/rollout-2026-06-08T16-20-14-019ea989-6721-7b82-bc0c-de6aae7d46e2.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server","cliVersion":"0.137.0","source":"vscode","threadSource":null,"agentNickname":null,"agentRole":null,"gitInfo":{"sha":"5115887f33051a4e25d2b427622a54656eeb9ab0","branch":"t3code/17b43ed6","originUrl":"git@github.com:pingdotgg/t3code.git"},"name":null,"turns":[]}}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":5,"result":{"turn":{"id":"019ea989-6834-72b3-887d-747b22d38305","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019ea989-6721-7b82-bc0c-de6aae7d46e2","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019ea989-6721-7b82-bc0c-de6aae7d46e2","turn":{"id":"019ea989-6834-72b3-887d-747b22d38305","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":1780960815,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"computer-use","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"openaiDeveloperDocs","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"xcodebuildmcp","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"1e1b8056-2414-42f4-b438-1c36246e6cbf","clientId":null,"content":[{"type":"text","text":"Remember the fork-local marker sibling-first-5L2P. Return the source marker followed by this marker, separated by |. Respond with only the markers and separator.","text_elements":[]}]},"threadId":"019ea989-6721-7b82-bc0c-de6aae7d46e2","turnId":"019ea989-6834-72b3-887d-747b22d38305","startedAtMs":1780960818024}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"1e1b8056-2414-42f4-b438-1c36246e6cbf","clientId":null,"content":[{"type":"text","text":"Remember the fork-local marker sibling-first-5L2P. Return the source marker followed by this marker, separated by |. Respond with only the markers and separator.","text_elements":[]}]},"threadId":"019ea989-6721-7b82-bc0c-de6aae7d46e2","turnId":"019ea989-6834-72b3-887d-747b22d38305","completedAtMs":1780960818024}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_0c66891f655b02a4016a274e33829c819ba03d8e26e1c8ab93","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019ea989-6721-7b82-bc0c-de6aae7d46e2","turnId":"019ea989-6834-72b3-887d-747b22d38305","startedAtMs":1780960819591}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-6721-7b82-bc0c-de6aae7d46e2","turnId":"019ea989-6834-72b3-887d-747b22d38305","itemId":"msg_0c66891f655b02a4016a274e33829c819ba03d8e26e1c8ab93","delta":"s"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-6721-7b82-bc0c-de6aae7d46e2","turnId":"019ea989-6834-72b3-887d-747b22d38305","itemId":"msg_0c66891f655b02a4016a274e33829c819ba03d8e26e1c8ab93","delta":"ibling"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-6721-7b82-bc0c-de6aae7d46e2","turnId":"019ea989-6834-72b3-887d-747b22d38305","itemId":"msg_0c66891f655b02a4016a274e33829c819ba03d8e26e1c8ab93","delta":"-source"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-6721-7b82-bc0c-de6aae7d46e2","turnId":"019ea989-6834-72b3-887d-747b22d38305","itemId":"msg_0c66891f655b02a4016a274e33829c819ba03d8e26e1c8ab93","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-6721-7b82-bc0c-de6aae7d46e2","turnId":"019ea989-6834-72b3-887d-747b22d38305","itemId":"msg_0c66891f655b02a4016a274e33829c819ba03d8e26e1c8ab93","delta":"8"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-6721-7b82-bc0c-de6aae7d46e2","turnId":"019ea989-6834-72b3-887d-747b22d38305","itemId":"msg_0c66891f655b02a4016a274e33829c819ba03d8e26e1c8ab93","delta":"R"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-6721-7b82-bc0c-de6aae7d46e2","turnId":"019ea989-6834-72b3-887d-747b22d38305","itemId":"msg_0c66891f655b02a4016a274e33829c819ba03d8e26e1c8ab93","delta":"3"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-6721-7b82-bc0c-de6aae7d46e2","turnId":"019ea989-6834-72b3-887d-747b22d38305","itemId":"msg_0c66891f655b02a4016a274e33829c819ba03d8e26e1c8ab93","delta":"D"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-6721-7b82-bc0c-de6aae7d46e2","turnId":"019ea989-6834-72b3-887d-747b22d38305","itemId":"msg_0c66891f655b02a4016a274e33829c819ba03d8e26e1c8ab93","delta":"|"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-6721-7b82-bc0c-de6aae7d46e2","turnId":"019ea989-6834-72b3-887d-747b22d38305","itemId":"msg_0c66891f655b02a4016a274e33829c819ba03d8e26e1c8ab93","delta":"s"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-6721-7b82-bc0c-de6aae7d46e2","turnId":"019ea989-6834-72b3-887d-747b22d38305","itemId":"msg_0c66891f655b02a4016a274e33829c819ba03d8e26e1c8ab93","delta":"ibling"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-6721-7b82-bc0c-de6aae7d46e2","turnId":"019ea989-6834-72b3-887d-747b22d38305","itemId":"msg_0c66891f655b02a4016a274e33829c819ba03d8e26e1c8ab93","delta":"-first"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-6721-7b82-bc0c-de6aae7d46e2","turnId":"019ea989-6834-72b3-887d-747b22d38305","itemId":"msg_0c66891f655b02a4016a274e33829c819ba03d8e26e1c8ab93","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-6721-7b82-bc0c-de6aae7d46e2","turnId":"019ea989-6834-72b3-887d-747b22d38305","itemId":"msg_0c66891f655b02a4016a274e33829c819ba03d8e26e1c8ab93","delta":"5"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-6721-7b82-bc0c-de6aae7d46e2","turnId":"019ea989-6834-72b3-887d-747b22d38305","itemId":"msg_0c66891f655b02a4016a274e33829c819ba03d8e26e1c8ab93","delta":"L"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-6721-7b82-bc0c-de6aae7d46e2","turnId":"019ea989-6834-72b3-887d-747b22d38305","itemId":"msg_0c66891f655b02a4016a274e33829c819ba03d8e26e1c8ab93","delta":"2"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-6721-7b82-bc0c-de6aae7d46e2","turnId":"019ea989-6834-72b3-887d-747b22d38305","itemId":"msg_0c66891f655b02a4016a274e33829c819ba03d8e26e1c8ab93","delta":"P"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_0c66891f655b02a4016a274e33829c819ba03d8e26e1c8ab93","text":"sibling-source-8R3D|sibling-first-5L2P","phase":"final_answer","memoryCitation":null},"threadId":"019ea989-6721-7b82-bc0c-de6aae7d46e2","turnId":"019ea989-6834-72b3-887d-747b22d38305","completedAtMs":1780960819680}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019ea989-6721-7b82-bc0c-de6aae7d46e2","turnId":"019ea989-6834-72b3-887d-747b22d38305","tokenUsage":{"total":{"totalTokens":36955,"inputTokens":36926,"cachedInputTokens":36608,"outputTokens":29,"reasoningOutputTokens":0},"last":{"totalTokens":18508,"inputTokens":18487,"cachedInputTokens":18304,"outputTokens":21,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1780968999},"secondary":{"usedPercent":3,"windowDurationMins":10080,"resetsAt":1781296757},"credits":null,"individualLimit":null,"planType":"pro","rateLimitReachedType":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019ea989-6721-7b82-bc0c-de6aae7d46e2","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019ea989-6721-7b82-bc0c-de6aae7d46e2","turn":{"id":"019ea989-6834-72b3-887d-747b22d38305","items":[],"itemsView":"notLoaded","status":"completed","error":null,"startedAt":1780960815,"completedAt":1780960819,"durationMs":4534}}}}
+{"type":"expect_outbound","label":"thread/fork","frame":{"id":6,"method":"thread/fork","params":{"threadId":"019ea989-52ea-7360-b19f-391107d1f7ea"}}}
+{"type":"emit_inbound","label":"deprecationNotice","frame":{"method":"deprecationNotice","params":{"summary":"`[features].collab` is deprecated. Use `[features].multi_agent` instead.","details":"Enable it with `--enable multi_agent` or `[features].multi_agent` in config.toml. See https://developers.openai.com/codex/config-basic#feature-flags for details."}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"openaiDeveloperDocs","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"node_repl","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"xcodebuildmcp","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"computer-use","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"node_repl","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"thread/fork","frame":{"id":6,"result":{"thread":{"id":"019ea989-79f2-7d43-ad3f-6999afbd845e","sessionId":"019ea989-79f2-7d43-ad3f-6999afbd845e","forkedFromId":"019ea989-52ea-7360-b19f-391107d1f7ea","parentThreadId":null,"preview":"Remember the opaque marker sibling-source-8R3D for later in this conversation. Respond with exactly: sibling source stored","ephemeral":false,"modelProvider":"openai","createdAt":1780960819,"updatedAt":1780960819,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/06/08/rollout-2026-06-08T16-20-19-019ea989-79f2-7d43-ad3f-6999afbd845e.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server","cliVersion":"0.137.0","source":"vscode","threadSource":null,"agentNickname":null,"agentRole":null,"gitInfo":{"sha":"5115887f33051a4e25d2b427622a54656eeb9ab0","branch":"t3code/17b43ed6","originUrl":"git@github.com:pingdotgg/t3code.git"},"name":null,"turns":[{"id":"019ea989-5456-7383-9002-f4f035fa8cb8","items":[{"type":"userMessage","id":"item-1","clientId":null,"content":[{"type":"text","text":"Remember the opaque marker sibling-source-8R3D for later in this conversation. Respond with exactly: sibling source stored","text_elements":[]}]},{"type":"agentMessage","id":"item-2","text":"sibling source stored","phase":"final_answer","memoryCitation":null}],"itemsView":"full","status":"completed","error":null,"startedAt":1780960810,"completedAt":1780960814,"durationMs":4719}]},"model":"kindle-alpha","modelProvider":"openai","serviceTier":null,"cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server","runtimeWorkspaceRoots":["/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server"],"instructionSources":["/Users/julius/.codex/AGENTS.md","/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/AGENTS.md"],"approvalPolicy":"on-request","approvalsReviewer":"user","sandbox":{"type":"workspaceWrite","writableRoots":[],"networkAccess":false,"excludeTmpdirEnvVar":false,"excludeSlashTmp":false},"activePermissionProfile":{"id":":workspace","extends":null},"reasoningEffort":"medium"}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":7,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Remember the fork-local marker sibling-second-9N6C. Return the source marker followed by this marker, separated by |. Respond with only the markers and separator.","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"type":"dangerFullAccess"},"threadId":"019ea989-79f2-7d43-ad3f-6999afbd845e","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019ea989-79f2-7d43-ad3f-6999afbd845e","turnId":"019ea989-5456-7383-9002-f4f035fa8cb8","tokenUsage":{"total":{"totalTokens":18447,"inputTokens":18439,"cachedInputTokens":18304,"outputTokens":8,"reasoningOutputTokens":0},"last":{"totalTokens":18447,"inputTokens":18439,"cachedInputTokens":18304,"outputTokens":8,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"thread/started","frame":{"method":"thread/started","params":{"thread":{"id":"019ea989-79f2-7d43-ad3f-6999afbd845e","sessionId":"019ea989-79f2-7d43-ad3f-6999afbd845e","forkedFromId":"019ea989-52ea-7360-b19f-391107d1f7ea","parentThreadId":null,"preview":"Remember the opaque marker sibling-source-8R3D for later in this conversation. Respond with exactly: sibling source stored","ephemeral":false,"modelProvider":"openai","createdAt":1780960819,"updatedAt":1780960819,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/06/08/rollout-2026-06-08T16-20-19-019ea989-79f2-7d43-ad3f-6999afbd845e.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server","cliVersion":"0.137.0","source":"vscode","threadSource":null,"agentNickname":null,"agentRole":null,"gitInfo":{"sha":"5115887f33051a4e25d2b427622a54656eeb9ab0","branch":"t3code/17b43ed6","originUrl":"git@github.com:pingdotgg/t3code.git"},"name":null,"turns":[]}}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":7,"result":{"turn":{"id":"019ea989-7b05-7190-9e84-b6f5e70d2312","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019ea989-79f2-7d43-ad3f-6999afbd845e","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019ea989-79f2-7d43-ad3f-6999afbd845e","turn":{"id":"019ea989-7b05-7190-9e84-b6f5e70d2312","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":1780960819,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"computer-use","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"openaiDeveloperDocs","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"xcodebuildmcp","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"52ae1b46-260a-4238-a643-9514aa85f97b","clientId":null,"content":[{"type":"text","text":"Remember the fork-local marker sibling-second-9N6C. Return the source marker followed by this marker, separated by |. Respond with only the markers and separator.","text_elements":[]}]},"threadId":"019ea989-79f2-7d43-ad3f-6999afbd845e","turnId":"019ea989-7b05-7190-9e84-b6f5e70d2312","startedAtMs":1780960822774}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"52ae1b46-260a-4238-a643-9514aa85f97b","clientId":null,"content":[{"type":"text","text":"Remember the fork-local marker sibling-second-9N6C. Return the source marker followed by this marker, separated by |. Respond with only the markers and separator.","text_elements":[]}]},"threadId":"019ea989-79f2-7d43-ad3f-6999afbd845e","turnId":"019ea989-7b05-7190-9e84-b6f5e70d2312","completedAtMs":1780960822774}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_0256927256e5e51b016a274e384acc819b86af10640ed1dff4","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019ea989-79f2-7d43-ad3f-6999afbd845e","turnId":"019ea989-7b05-7190-9e84-b6f5e70d2312","startedAtMs":1780960824311}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-79f2-7d43-ad3f-6999afbd845e","turnId":"019ea989-7b05-7190-9e84-b6f5e70d2312","itemId":"msg_0256927256e5e51b016a274e384acc819b86af10640ed1dff4","delta":"s"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-79f2-7d43-ad3f-6999afbd845e","turnId":"019ea989-7b05-7190-9e84-b6f5e70d2312","itemId":"msg_0256927256e5e51b016a274e384acc819b86af10640ed1dff4","delta":"ibling"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-79f2-7d43-ad3f-6999afbd845e","turnId":"019ea989-7b05-7190-9e84-b6f5e70d2312","itemId":"msg_0256927256e5e51b016a274e384acc819b86af10640ed1dff4","delta":"-source"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-79f2-7d43-ad3f-6999afbd845e","turnId":"019ea989-7b05-7190-9e84-b6f5e70d2312","itemId":"msg_0256927256e5e51b016a274e384acc819b86af10640ed1dff4","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-79f2-7d43-ad3f-6999afbd845e","turnId":"019ea989-7b05-7190-9e84-b6f5e70d2312","itemId":"msg_0256927256e5e51b016a274e384acc819b86af10640ed1dff4","delta":"8"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-79f2-7d43-ad3f-6999afbd845e","turnId":"019ea989-7b05-7190-9e84-b6f5e70d2312","itemId":"msg_0256927256e5e51b016a274e384acc819b86af10640ed1dff4","delta":"R"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-79f2-7d43-ad3f-6999afbd845e","turnId":"019ea989-7b05-7190-9e84-b6f5e70d2312","itemId":"msg_0256927256e5e51b016a274e384acc819b86af10640ed1dff4","delta":"3"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-79f2-7d43-ad3f-6999afbd845e","turnId":"019ea989-7b05-7190-9e84-b6f5e70d2312","itemId":"msg_0256927256e5e51b016a274e384acc819b86af10640ed1dff4","delta":"D"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-79f2-7d43-ad3f-6999afbd845e","turnId":"019ea989-7b05-7190-9e84-b6f5e70d2312","itemId":"msg_0256927256e5e51b016a274e384acc819b86af10640ed1dff4","delta":"|"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-79f2-7d43-ad3f-6999afbd845e","turnId":"019ea989-7b05-7190-9e84-b6f5e70d2312","itemId":"msg_0256927256e5e51b016a274e384acc819b86af10640ed1dff4","delta":"s"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-79f2-7d43-ad3f-6999afbd845e","turnId":"019ea989-7b05-7190-9e84-b6f5e70d2312","itemId":"msg_0256927256e5e51b016a274e384acc819b86af10640ed1dff4","delta":"ibling"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-79f2-7d43-ad3f-6999afbd845e","turnId":"019ea989-7b05-7190-9e84-b6f5e70d2312","itemId":"msg_0256927256e5e51b016a274e384acc819b86af10640ed1dff4","delta":"-second"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-79f2-7d43-ad3f-6999afbd845e","turnId":"019ea989-7b05-7190-9e84-b6f5e70d2312","itemId":"msg_0256927256e5e51b016a274e384acc819b86af10640ed1dff4","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-79f2-7d43-ad3f-6999afbd845e","turnId":"019ea989-7b05-7190-9e84-b6f5e70d2312","itemId":"msg_0256927256e5e51b016a274e384acc819b86af10640ed1dff4","delta":"9"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-79f2-7d43-ad3f-6999afbd845e","turnId":"019ea989-7b05-7190-9e84-b6f5e70d2312","itemId":"msg_0256927256e5e51b016a274e384acc819b86af10640ed1dff4","delta":"N"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-79f2-7d43-ad3f-6999afbd845e","turnId":"019ea989-7b05-7190-9e84-b6f5e70d2312","itemId":"msg_0256927256e5e51b016a274e384acc819b86af10640ed1dff4","delta":"6"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea989-79f2-7d43-ad3f-6999afbd845e","turnId":"019ea989-7b05-7190-9e84-b6f5e70d2312","itemId":"msg_0256927256e5e51b016a274e384acc819b86af10640ed1dff4","delta":"C"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_0256927256e5e51b016a274e384acc819b86af10640ed1dff4","text":"sibling-source-8R3D|sibling-second-9N6C","phase":"final_answer","memoryCitation":null},"threadId":"019ea989-79f2-7d43-ad3f-6999afbd845e","turnId":"019ea989-7b05-7190-9e84-b6f5e70d2312","completedAtMs":1780960824464}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019ea989-79f2-7d43-ad3f-6999afbd845e","turnId":"019ea989-7b05-7190-9e84-b6f5e70d2312","tokenUsage":{"total":{"totalTokens":36955,"inputTokens":36926,"cachedInputTokens":36608,"outputTokens":29,"reasoningOutputTokens":0},"last":{"totalTokens":18508,"inputTokens":18487,"cachedInputTokens":18304,"outputTokens":21,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1780968999},"secondary":{"usedPercent":3,"windowDurationMins":10080,"resetsAt":1781296757},"credits":null,"individualLimit":null,"planType":"pro","rateLimitReachedType":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019ea989-79f2-7d43-ad3f-6999afbd845e","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019ea989-79f2-7d43-ad3f-6999afbd845e","turn":{"id":"019ea989-7b05-7190-9e84-b6f5e70d2312","items":[],"itemsView":"notLoaded","status":"completed","error":null,"startedAt":1780960819,"completedAt":1780960824,"durationMs":4499}}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/thread_merge_back_continue/README.md b/apps/server/src/orchestration-v2/testkit/fixtures/thread_merge_back_continue/README.md
new file mode 100644
index 000000000000..cf2a76e4526f
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/thread_merge_back_continue/README.md
@@ -0,0 +1,45 @@
+# Merge-Back Continuation Fixture
+
+This fixture records a native fork, a fork-local delta, and an app-style
+merge-back handoff consumed by the original provider thread. A later source
+turn recalls both markers without receiving either marker in its prompt.
+
+Both provider transcripts execute the same graph.
+
+## Conversation Graph
+
+```text
+Source provider thread
+|
++-- Turn 1
+|   User: remember merge-source-4H8Q
+|   Assistant: merge source stored
+|
++-- native fork
+|   |
+|   `-- Forked provider thread
+|       `-- Turn 2
+|           User: remember merge-fork-7T2W
+|           Assistant: merge fork stored
+|
+`-- original source provider thread
+    |
+    +-- Turn 3
+    |   App input: merge_back handoff containing merge-fork-7T2W
+    |   Assistant: merge delta stored
+    |
+    `-- Turn 4
+        User: recall source and transferred markers without restating them
+        Assistant: merge-source-4H8Q|merge-fork-7T2W
+```
+
+## Assertions
+
+- The fork uses a different native provider thread or session.
+- The handoff and recall turns continue the original source provider thread.
+- The recall prompt contains neither marker.
+- The final response recalls both source and transferred fork context.
+
+The transcript records the provider-facing handoff format. The app-level
+`thread.merge_back` command and context-transfer lifecycle remain covered by
+the orchestrator integration tests.
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/thread_merge_back_continue/claude_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/thread_merge_back_continue/claude_transcript.ndjson
new file mode 100644
index 000000000000..cfc5e0e31e74
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/thread_merge_back_continue/claude_transcript.ndjson
@@ -0,0 +1,34 @@
+{"type":"transcript_start","provider":"claudeAgent","protocol":"claude-agent-sdk.query","version":"0.2.111","scenario":"thread_merge_back_continue","metadata":{"prompts":["Remember the opaque marker merge-source-4H8Q for later in this conversation. Respond with exactly: merge source stored","Remember the fork-local marker merge-fork-7T2W. Respond with exactly: merge fork stored","Context handoff (merge_back / fork_delta_summary):\nMerge-back context from forked conversation.\n\nFork delta:\n- User introduced opaque marker merge-fork-7T2W.\n- Assistant confirmed: merge fork stored\n\nUser message:\nRetain the transferred fork marker for later. Respond with exactly: merge delta stored","Return the source marker followed by the transferred fork marker, separated by a single | character. Respond with only the markers and separator."],"model":"claude-sonnet-4-6","nativeSessionId":"79522bc8-3de1-41c4-a2fd-902246ef1290","queryMode":"fork_session_merge_back","tools":"claude_code","permissionMode":"bypassPermissions","generatedBy":"recordClaudeAgentSdkReplayTranscript","sourceAssistantMessageUuids":["a4647f9c-80c4-458e-be3a-b15e5105fa4f"],"forkUpToMessageId":"a4647f9c-80c4-458e-be3a-b15e5105fa4f","forkedNativeSessionId":"8baac83f-471d-4d65-9091-2e7e66557251","forkedNativeSessionIds":["8baac83f-471d-4d65-9091-2e7e66557251"],"sourceContinuationPromptCount":2}}
+{"type":"expect_outbound","label":"query.open:source","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"sessionId":"79522bc8-3de1-41c4-a2fd-902246ef1290"}}}
+{"type":"expect_outbound","label":"prompt.offer:1","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Remember the opaque marker merge-source-4H8Q for later in this conversation. Respond with exactly: merge source stored"},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"ca138fb7-425e-49c2-81c3-74bba4794caa","hook_name":"SessionStart:startup","hook_event":"SessionStart","uuid":"8683c9cc-5740-4f87-8692-4f475d2ba357","session_id":"79522bc8-3de1-41c4-a2fd-902246ef1290"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"ca138fb7-425e-49c2-81c3-74bba4794caa","hook_name":"SessionStart:startup","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"98fb5ba2-d12a-40e6-b114-26da116f7360","session_id":"79522bc8-3de1-41c4-a2fd-902246ef1290"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.159","cwd":"/tmp/claude-replay-thread_merge_back_continue","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"2a2e49f2-27b0-40b0-b1ac-7367b908dcb8","session_id":"79522bc8-3de1-41c4-a2fd-902246ef1290"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01MNXMZ2663k7u7x7qvgyrpx","type":"message","role":"assistant","content":[{"type":"text","text":"merge source stored"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":18977,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"79522bc8-3de1-41c4-a2fd-902246ef1290","uuid":"a4647f9c-80c4-458e-be3a-b15e5105fa4f","request_id":"req_011CbrhadoaKaXmYQpTYNbHv"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed"},"uuid":"41517fd7-973f-44ed-86e1-779bac6e6ab2","session_id":"79522bc8-3de1-41c4-a2fd-902246ef1290"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":2584,"duration_api_ms":1954,"ttft_ms":1885,"num_turns":1,"result":"merge source stored","stop_reason":"end_turn","session_id":"79522bc8-3de1-41c4-a2fd-902246ef1290","total_cost_usd":0.0057921000000000005,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":18977,"output_tokens":6,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"inference_geo":"not_available","iterations":[{"input_tokens":3,"output_tokens":6,"cache_read_input_tokens":18977,"cache_creation_input_tokens":0,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":3,"outputTokens":6,"cacheReadInputTokens":18977,"cacheCreationInputTokens":0,"webSearchRequests":0,"costUSD":0.0057921000000000005,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"ea85fb12-2387-44cf-b6c9-b62e2fc48696"}}
+{"type":"runtime_exit","status":"success"}
+{"type":"expect_outbound","label":"session.fork","frame":{"type":"session.fork","sessionId":"79522bc8-3de1-41c4-a2fd-902246ef1290","options":{"dir":"/tmp/claude-replay-thread_merge_back_continue","upToMessageId":"a4647f9c-80c4-458e-be3a-b15e5105fa4f"}}}
+{"type":"emit_inbound","label":"session.forked","frame":{"type":"session.forked","sessionId":"8baac83f-471d-4d65-9091-2e7e66557251"}}
+{"type":"expect_outbound","label":"query.open:fork","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"resume":"8baac83f-471d-4d65-9091-2e7e66557251"}}}
+{"type":"expect_outbound","label":"prompt.offer:2","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Remember the fork-local marker merge-fork-7T2W. Respond with exactly: merge fork stored"},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"a2cb0c98-569d-4b16-9e71-937c6f38bfb2","hook_name":"SessionStart:resume","hook_event":"SessionStart","uuid":"8786da30-2c27-4fa8-aa71-ff7fecaa37f8","session_id":"350f8022-de90-440c-b32e-c559a60e7383"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"a2cb0c98-569d-4b16-9e71-937c6f38bfb2","hook_name":"SessionStart:resume","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"8da14dd3-d942-4ed4-a80d-a5eaf5c39d50","session_id":"350f8022-de90-440c-b32e-c559a60e7383"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.159","cwd":"/tmp/claude-replay-thread_merge_back_continue","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"a3110ea8-1198-4a03-a8df-670c78523fd4","session_id":"8baac83f-471d-4d65-9091-2e7e66557251"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01BxoJ9bgjaXn24qSchFoFnQ","type":"message","role":"assistant","content":[{"type":"text","text":"merge fork stored"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":19009,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"8baac83f-471d-4d65-9091-2e7e66557251","uuid":"e2c1b56e-9ade-44ab-9087-bf293eb3aeaf","request_id":"req_011CbrhauAJJxiGXkMuAb2aA"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed"},"uuid":"0ef1ea39-53df-4c70-81ac-ae4e11960937","session_id":"8baac83f-471d-4d65-9091-2e7e66557251"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":2531,"duration_api_ms":1866,"ttft_ms":2102,"num_turns":1,"result":"merge fork stored","stop_reason":"end_turn","session_id":"8baac83f-471d-4d65-9091-2e7e66557251","total_cost_usd":0.005801700000000001,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":19009,"output_tokens":6,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"inference_geo":"not_available","iterations":[{"input_tokens":3,"output_tokens":6,"cache_read_input_tokens":19009,"cache_creation_input_tokens":0,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":3,"outputTokens":6,"cacheReadInputTokens":19009,"cacheCreationInputTokens":0,"webSearchRequests":0,"costUSD":0.005801700000000001,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"e22495dc-0ab1-4e99-bd90-3d2ac8295c6f"}}
+{"type":"runtime_exit","status":"success"}
+{"type":"expect_outbound","label":"query.open:source-continuation","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"resume":"79522bc8-3de1-41c4-a2fd-902246ef1290"}}}
+{"type":"expect_outbound","label":"prompt.offer:3","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Context handoff (merge_back / fork_delta_summary):\nMerge-back context from forked conversation.\n\nFork delta:\n- User introduced opaque marker merge-fork-7T2W.\n- Assistant confirmed: merge fork stored\n\nUser message:\nRetain the transferred fork marker for later. Respond with exactly: merge delta stored"},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"5e475fe2-aef6-4282-b1d8-334acfa4c4cd","hook_name":"SessionStart:resume","hook_event":"SessionStart","uuid":"9888cede-fed1-4dc7-b75c-0ce156547e70","session_id":"49021892-2f16-4f92-98ee-1d2943382082"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"5e475fe2-aef6-4282-b1d8-334acfa4c4cd","hook_name":"SessionStart:resume","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"3faffda5-2087-4eb1-bdb9-27bfad62b5f1","session_id":"49021892-2f16-4f92-98ee-1d2943382082"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.159","cwd":"/tmp/claude-replay-thread_merge_back_continue","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"370aeede-59f6-4d9c-a0f5-a4810fec3651","session_id":"79522bc8-3de1-41c4-a2fd-902246ef1290"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01QywCNnUUGSBbcW4HG5Fbj6","type":"message","role":"assistant","content":[{"type":"text","text":"merge delta stored"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":84,"cache_read_input_tokens":18977,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":84},"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"79522bc8-3de1-41c4-a2fd-902246ef1290","uuid":"7f1e76ac-a80e-48e5-8a5e-d54099bb68e2","request_id":"req_011CbrhbAZkbickYjaYkr1MU"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed"},"uuid":"c31657df-4b5d-4b81-b1ae-c2da7df3c68a","session_id":"79522bc8-3de1-41c4-a2fd-902246ef1290"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":2399,"duration_api_ms":1773,"ttft_ms":2000,"num_turns":1,"result":"merge delta stored","stop_reason":"end_turn","session_id":"79522bc8-3de1-41c4-a2fd-902246ef1290","total_cost_usd":0.006107100000000001,"usage":{"input_tokens":3,"cache_creation_input_tokens":84,"cache_read_input_tokens":18977,"output_tokens":6,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":84,"ephemeral_5m_input_tokens":0},"inference_geo":"not_available","iterations":[{"input_tokens":3,"output_tokens":6,"cache_read_input_tokens":18977,"cache_creation_input_tokens":84,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":84},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":3,"outputTokens":6,"cacheReadInputTokens":18977,"cacheCreationInputTokens":84,"webSearchRequests":0,"costUSD":0.006107100000000001,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"d8fdda24-40ab-4bbe-9147-b0433c5a5d5b"}}
+{"type":"expect_outbound","label":"prompt.offer:4","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Return the source marker followed by the transferred fork marker, separated by a single | character. Respond with only the markers and separator."},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.159","cwd":"/tmp/claude-replay-thread_merge_back_continue","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"930c142a-b5e9-4056-8636-329558eb401f","session_id":"79522bc8-3de1-41c4-a2fd-902246ef1290"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01RovhD68EryidHLBGQMKjeQ","type":"message","role":"assistant","content":[{"type":"text","text":"merge-source-4H8Q | merge-fork-7T2W"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":135,"cache_read_input_tokens":19061,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":135},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"79522bc8-3de1-41c4-a2fd-902246ef1290","uuid":"0ed8c280-8f05-46b8-a7f8-40c98b1993f1","request_id":"req_011CbrhbNGTNVZmtXQuy7R5V"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":2611,"duration_api_ms":3876,"ttft_ms":2308,"num_turns":1,"result":"merge-source-4H8Q | merge-fork-7T2W","stop_reason":"end_turn","session_id":"79522bc8-3de1-41c4-a2fd-902246ef1290","total_cost_usd":0.01264065,"usage":{"input_tokens":3,"cache_creation_input_tokens":135,"cache_read_input_tokens":19061,"output_tokens":20,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":135,"ephemeral_5m_input_tokens":0},"inference_geo":"not_available","iterations":[{"input_tokens":3,"output_tokens":20,"cache_read_input_tokens":19061,"cache_creation_input_tokens":135,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":135},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":6,"outputTokens":26,"cacheReadInputTokens":38038,"cacheCreationInputTokens":219,"webSearchRequests":0,"costUSD":0.01264065,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"e6282264-d155-4e72-8289-fc0310eaca0c"}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/thread_merge_back_continue/codex_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/thread_merge_back_continue/codex_transcript.ndjson
new file mode 100644
index 000000000000..203b56a6a0d6
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/thread_merge_back_continue/codex_transcript.ndjson
@@ -0,0 +1,112 @@
+{"type":"transcript_start","provider":"codex","protocol":"codex.app-server","version":"0.137.0","scenario":"thread_merge_back_continue","metadata":{"source":"record-codex-app-server-replay-fixture","fileName":"thread_merge_back_continue.ndjson","description":"A source thread consumes one fork-delta handoff and later recalls source and transferred context."}}
+{"type":"expect_outbound","label":"initialize","frame":{"id":1,"method":"initialize","params":{"capabilities":{"experimentalApi":true},"clientInfo":{"name":"t3code_desktop","title":"T3 Code Desktop","version":"0.1.0"}}}}
+{"type":"emit_inbound","label":"initialize","frame":{"id":1,"result":{"userAgent":"t3code_desktop/0.137.0 (Mac OS 26.5.1; arm64) dumb (t3code_desktop; 0.1.0)","codexHome":"/Users/julius/.codex","platformFamily":"unix","platformOs":"macos"}}}
+{"type":"expect_outbound","label":"initialized","frame":{"method":"initialized"}}
+{"type":"expect_outbound","label":"thread/start","frame":{"id":2,"method":"thread/start","params":{}}}
+{"type":"emit_inbound","label":"remoteControl/status/changed","frame":{"method":"remoteControl/status/changed","params":{"status":"disabled","serverName":"Juliuss-MacBook-Pro.local","installationId":"c067a38f-79bf-4874-ba7b-c00e86012954","environmentId":null}}}
+{"type":"emit_inbound","label":"thread/start","frame":{"id":2,"result":{"thread":{"id":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","sessionId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","forkedFromId":null,"parentThreadId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1780962799,"updatedAt":1780962799,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/06/08/rollout-2026-06-08T16-53-18-019ea9a7-ac5e-74f0-a17c-75426d4c40c1.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server","cliVersion":"0.137.0","source":"vscode","threadSource":null,"agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]},"model":"kindle-alpha","modelProvider":"openai","serviceTier":null,"cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server","runtimeWorkspaceRoots":["/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server"],"instructionSources":["/Users/julius/.codex/AGENTS.md","/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/AGENTS.md"],"approvalPolicy":"on-request","approvalsReviewer":"user","sandbox":{"type":"workspaceWrite","writableRoots":[],"networkAccess":false,"excludeTmpdirEnvVar":false,"excludeSlashTmp":false},"activePermissionProfile":{"id":":workspace","extends":null},"reasoningEffort":"medium"}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":3,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Remember the opaque marker merge-source-4H8Q for later in this conversation. Respond with exactly: merge source stored","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"type":"dangerFullAccess"},"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"thread/started","frame":{"method":"thread/started","params":{"thread":{"id":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","sessionId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","forkedFromId":null,"parentThreadId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1780962799,"updatedAt":1780962799,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/06/08/rollout-2026-06-08T16-53-18-019ea9a7-ac5e-74f0-a17c-75426d4c40c1.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server","cliVersion":"0.137.0","source":"vscode","threadSource":null,"agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]}}}}
+{"type":"emit_inbound","label":"deprecationNotice","frame":{"method":"deprecationNotice","params":{"summary":"`[features].collab` is deprecated. Use `[features].multi_agent` instead.","details":"Enable it with `--enable multi_agent` or `[features].multi_agent` in config.toml. See https://developers.openai.com/codex/config-basic#feature-flags for details."}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"xcodebuildmcp","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"node_repl","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"computer-use","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"openaiDeveloperDocs","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"node_repl","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":3,"result":{"turn":{"id":"019ea9a7-adb0-77a2-85a6-3d3b6ff5ef67","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"computer-use","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turn":{"id":"019ea9a7-adb0-77a2-85a6-3d3b6ff5ef67","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":1780962799,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"openaiDeveloperDocs","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"xcodebuildmcp","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"dc0e189a-c4ab-4edd-a3e3-7e1ac1ce6c7a","clientId":null,"content":[{"type":"text","text":"Remember the opaque marker merge-source-4H8Q for later in this conversation. Respond with exactly: merge source stored","text_elements":[]}]},"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-adb0-77a2-85a6-3d3b6ff5ef67","startedAtMs":1780962802307}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"dc0e189a-c4ab-4edd-a3e3-7e1ac1ce6c7a","clientId":null,"content":[{"type":"text","text":"Remember the opaque marker merge-source-4H8Q for later in this conversation. Respond with exactly: merge source stored","text_elements":[]}]},"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-adb0-77a2-85a6-3d3b6ff5ef67","completedAtMs":1780962802307}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_07606c9d8f192b2f016a2755f40d848199a0ff8d5cb07a8bff","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-adb0-77a2-85a6-3d3b6ff5ef67","startedAtMs":1780962804037}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-adb0-77a2-85a6-3d3b6ff5ef67","itemId":"msg_07606c9d8f192b2f016a2755f40d848199a0ff8d5cb07a8bff","delta":"merge"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-adb0-77a2-85a6-3d3b6ff5ef67","itemId":"msg_07606c9d8f192b2f016a2755f40d848199a0ff8d5cb07a8bff","delta":" source"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-adb0-77a2-85a6-3d3b6ff5ef67","itemId":"msg_07606c9d8f192b2f016a2755f40d848199a0ff8d5cb07a8bff","delta":" stored"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_07606c9d8f192b2f016a2755f40d848199a0ff8d5cb07a8bff","text":"merge source stored","phase":"final_answer","memoryCitation":null},"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-adb0-77a2-85a6-3d3b6ff5ef67","completedAtMs":1780962804164}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-adb0-77a2-85a6-3d3b6ff5ef67","tokenUsage":{"total":{"totalTokens":18446,"inputTokens":18439,"cachedInputTokens":18304,"outputTokens":7,"reasoningOutputTokens":0},"last":{"totalTokens":18446,"inputTokens":18439,"cachedInputTokens":18304,"outputTokens":7,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1780968999},"secondary":{"usedPercent":3,"windowDurationMins":10080,"resetsAt":1781296757},"credits":null,"individualLimit":null,"planType":"pro","rateLimitReachedType":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turn":{"id":"019ea9a7-adb0-77a2-85a6-3d3b6ff5ef67","items":[],"itemsView":"notLoaded","status":"completed","error":null,"startedAt":1780962799,"completedAt":1780962804,"durationMs":5102}}}}
+{"type":"expect_outbound","label":"thread/fork","frame":{"id":4,"method":"thread/fork","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1"}}}
+{"type":"emit_inbound","label":"deprecationNotice","frame":{"method":"deprecationNotice","params":{"summary":"`[features].collab` is deprecated. Use `[features].multi_agent` instead.","details":"Enable it with `--enable multi_agent` or `[features].multi_agent` in config.toml. See https://developers.openai.com/codex/config-basic#feature-flags for details."}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"xcodebuildmcp","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"node_repl","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"computer-use","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"openaiDeveloperDocs","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"node_repl","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"thread/fork","frame":{"id":4,"result":{"thread":{"id":"019ea9a7-c1e4-72a0-b56b-a7b751aa97e6","sessionId":"019ea9a7-c1e4-72a0-b56b-a7b751aa97e6","forkedFromId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","parentThreadId":null,"preview":"Remember the opaque marker merge-source-4H8Q for later in this conversation. Respond with exactly: merge source stored","ephemeral":false,"modelProvider":"openai","createdAt":1780962804,"updatedAt":1780962804,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/06/08/rollout-2026-06-08T16-53-24-019ea9a7-c1e4-72a0-b56b-a7b751aa97e6.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server","cliVersion":"0.137.0","source":"vscode","threadSource":null,"agentNickname":null,"agentRole":null,"gitInfo":{"sha":"5115887f33051a4e25d2b427622a54656eeb9ab0","branch":"t3code/17b43ed6","originUrl":"git@github.com:pingdotgg/t3code.git"},"name":null,"turns":[{"id":"019ea9a7-adb0-77a2-85a6-3d3b6ff5ef67","items":[{"type":"userMessage","id":"item-1","clientId":null,"content":[{"type":"text","text":"Remember the opaque marker merge-source-4H8Q for later in this conversation. Respond with exactly: merge source stored","text_elements":[]}]},{"type":"agentMessage","id":"item-2","text":"merge source stored","phase":"final_answer","memoryCitation":null}],"itemsView":"full","status":"completed","error":null,"startedAt":1780962799,"completedAt":1780962804,"durationMs":5102}]},"model":"kindle-alpha","modelProvider":"openai","serviceTier":null,"cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server","runtimeWorkspaceRoots":["/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server"],"instructionSources":["/Users/julius/.codex/AGENTS.md","/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/AGENTS.md"],"approvalPolicy":"on-request","approvalsReviewer":"user","sandbox":{"type":"workspaceWrite","writableRoots":[],"networkAccess":false,"excludeTmpdirEnvVar":false,"excludeSlashTmp":false},"activePermissionProfile":{"id":":workspace","extends":null},"reasoningEffort":"medium"}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":5,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Remember the fork-local marker merge-fork-7T2W. Respond with exactly: merge fork stored","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"type":"dangerFullAccess"},"threadId":"019ea9a7-c1e4-72a0-b56b-a7b751aa97e6","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019ea9a7-c1e4-72a0-b56b-a7b751aa97e6","turnId":"019ea9a7-adb0-77a2-85a6-3d3b6ff5ef67","tokenUsage":{"total":{"totalTokens":18446,"inputTokens":18439,"cachedInputTokens":18304,"outputTokens":7,"reasoningOutputTokens":0},"last":{"totalTokens":18446,"inputTokens":18439,"cachedInputTokens":18304,"outputTokens":7,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"thread/started","frame":{"method":"thread/started","params":{"thread":{"id":"019ea9a7-c1e4-72a0-b56b-a7b751aa97e6","sessionId":"019ea9a7-c1e4-72a0-b56b-a7b751aa97e6","forkedFromId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","parentThreadId":null,"preview":"Remember the opaque marker merge-source-4H8Q for later in this conversation. Respond with exactly: merge source stored","ephemeral":false,"modelProvider":"openai","createdAt":1780962804,"updatedAt":1780962804,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/06/08/rollout-2026-06-08T16-53-24-019ea9a7-c1e4-72a0-b56b-a7b751aa97e6.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server","cliVersion":"0.137.0","source":"vscode","threadSource":null,"agentNickname":null,"agentRole":null,"gitInfo":{"sha":"5115887f33051a4e25d2b427622a54656eeb9ab0","branch":"t3code/17b43ed6","originUrl":"git@github.com:pingdotgg/t3code.git"},"name":null,"turns":[]}}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":5,"result":{"turn":{"id":"019ea9a7-c370-73a2-a906-f722f57cb683","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019ea9a7-c1e4-72a0-b56b-a7b751aa97e6","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019ea9a7-c1e4-72a0-b56b-a7b751aa97e6","turn":{"id":"019ea9a7-c370-73a2-a906-f722f57cb683","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":1780962804,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"computer-use","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"openaiDeveloperDocs","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"xcodebuildmcp","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"8bb4a29c-a319-4b62-8ca2-b795151def39","clientId":null,"content":[{"type":"text","text":"Remember the fork-local marker merge-fork-7T2W. Respond with exactly: merge fork stored","text_elements":[]}]},"threadId":"019ea9a7-c1e4-72a0-b56b-a7b751aa97e6","turnId":"019ea9a7-c370-73a2-a906-f722f57cb683","startedAtMs":1780962807856}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"8bb4a29c-a319-4b62-8ca2-b795151def39","clientId":null,"content":[{"type":"text","text":"Remember the fork-local marker merge-fork-7T2W. Respond with exactly: merge fork stored","text_elements":[]}]},"threadId":"019ea9a7-c1e4-72a0-b56b-a7b751aa97e6","turnId":"019ea9a7-c370-73a2-a906-f722f57cb683","completedAtMs":1780962807856}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_003f78a6266e6bfb016a2755f911908199946b033128f6d498","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019ea9a7-c1e4-72a0-b56b-a7b751aa97e6","turnId":"019ea9a7-c370-73a2-a906-f722f57cb683","startedAtMs":1780962809116}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-c1e4-72a0-b56b-a7b751aa97e6","turnId":"019ea9a7-c370-73a2-a906-f722f57cb683","itemId":"msg_003f78a6266e6bfb016a2755f911908199946b033128f6d498","delta":"merge"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-c1e4-72a0-b56b-a7b751aa97e6","turnId":"019ea9a7-c370-73a2-a906-f722f57cb683","itemId":"msg_003f78a6266e6bfb016a2755f911908199946b033128f6d498","delta":" fork"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-c1e4-72a0-b56b-a7b751aa97e6","turnId":"019ea9a7-c370-73a2-a906-f722f57cb683","itemId":"msg_003f78a6266e6bfb016a2755f911908199946b033128f6d498","delta":" stored"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_003f78a6266e6bfb016a2755f911908199946b033128f6d498","text":"merge fork stored","phase":"final_answer","memoryCitation":null},"threadId":"019ea9a7-c1e4-72a0-b56b-a7b751aa97e6","turnId":"019ea9a7-c370-73a2-a906-f722f57cb683","completedAtMs":1780962809255}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019ea9a7-c1e4-72a0-b56b-a7b751aa97e6","turnId":"019ea9a7-c370-73a2-a906-f722f57cb683","tokenUsage":{"total":{"totalTokens":36926,"inputTokens":36912,"cachedInputTokens":36608,"outputTokens":14,"reasoningOutputTokens":0},"last":{"totalTokens":18480,"inputTokens":18473,"cachedInputTokens":18304,"outputTokens":7,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1780968999},"secondary":{"usedPercent":3,"windowDurationMins":10080,"resetsAt":1781296757},"credits":null,"individualLimit":null,"planType":"pro","rateLimitReachedType":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019ea9a7-c1e4-72a0-b56b-a7b751aa97e6","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019ea9a7-c1e4-72a0-b56b-a7b751aa97e6","turn":{"id":"019ea9a7-c370-73a2-a906-f722f57cb683","items":[],"itemsView":"notLoaded","status":"completed","error":null,"startedAt":1780962804,"completedAt":1780962809,"durationMs":4675}}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":6,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Context handoff (merge_back / fork_delta_summary):\nMerge-back context from forked conversation.\n\nFork delta:\n- User introduced opaque marker merge-fork-7T2W.\n- Assistant confirmed: merge fork stored\n\nUser message:\nRetain the transferred fork marker for later. Respond with exactly: merge delta stored","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"type":"dangerFullAccess"},"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":6,"result":{"turn":{"id":"019ea9a7-d5bd-7c13-a5ae-7479b421a677","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turn":{"id":"019ea9a7-d5bd-7c13-a5ae-7479b421a677","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":1780962809,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"a55b36a2-aca0-49e2-888c-03d7ea045d0d","clientId":null,"content":[{"type":"text","text":"Context handoff (merge_back / fork_delta_summary):\nMerge-back context from forked conversation.\n\nFork delta:\n- User introduced opaque marker merge-fork-7T2W.\n- Assistant confirmed: merge fork stored\n\nUser message:\nRetain the transferred fork marker for later. Respond with exactly: merge delta stored","text_elements":[]}]},"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-d5bd-7c13-a5ae-7479b421a677","startedAtMs":1780962809285}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"a55b36a2-aca0-49e2-888c-03d7ea045d0d","clientId":null,"content":[{"type":"text","text":"Context handoff (merge_back / fork_delta_summary):\nMerge-back context from forked conversation.\n\nFork delta:\n- User introduced opaque marker merge-fork-7T2W.\n- Assistant confirmed: merge fork stored\n\nUser message:\nRetain the transferred fork marker for later. Respond with exactly: merge delta stored","text_elements":[]}]},"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-d5bd-7c13-a5ae-7479b421a677","completedAtMs":1780962809285}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_07606c9d8f192b2f016a2755fa98ac8199bfa30556cbb5a359","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-d5bd-7c13-a5ae-7479b421a677","startedAtMs":1780962810583}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-d5bd-7c13-a5ae-7479b421a677","itemId":"msg_07606c9d8f192b2f016a2755fa98ac8199bfa30556cbb5a359","delta":"merge"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-d5bd-7c13-a5ae-7479b421a677","itemId":"msg_07606c9d8f192b2f016a2755fa98ac8199bfa30556cbb5a359","delta":" delta"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-d5bd-7c13-a5ae-7479b421a677","itemId":"msg_07606c9d8f192b2f016a2755fa98ac8199bfa30556cbb5a359","delta":" stored"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_07606c9d8f192b2f016a2755fa98ac8199bfa30556cbb5a359","text":"merge delta stored","phase":"final_answer","memoryCitation":null},"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-d5bd-7c13-a5ae-7479b421a677","completedAtMs":1780962810689}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-d5bd-7c13-a5ae-7479b421a677","tokenUsage":{"total":{"totalTokens":36968,"inputTokens":36954,"cachedInputTokens":36608,"outputTokens":14,"reasoningOutputTokens":0},"last":{"totalTokens":18522,"inputTokens":18515,"cachedInputTokens":18304,"outputTokens":7,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1780968999},"secondary":{"usedPercent":3,"windowDurationMins":10080,"resetsAt":1781296757},"credits":null,"individualLimit":null,"planType":"pro","rateLimitReachedType":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turn":{"id":"019ea9a7-d5bd-7c13-a5ae-7479b421a677","items":[],"itemsView":"notLoaded","status":"completed","error":null,"startedAt":1780962809,"completedAt":1780962810,"durationMs":1414}}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":7,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Return the source marker followed by the transferred fork marker, separated by a single | character. Respond with only the markers and separator.","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"type":"dangerFullAccess"},"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":7,"result":{"turn":{"id":"019ea9a7-db48-7bd3-9c20-3d806cf8a702","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turn":{"id":"019ea9a7-db48-7bd3-9c20-3d806cf8a702","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":1780962810,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"cbaa6105-6995-4c6a-811f-276491c56bd8","clientId":null,"content":[{"type":"text","text":"Return the source marker followed by the transferred fork marker, separated by a single | character. Respond with only the markers and separator.","text_elements":[]}]},"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-db48-7bd3-9c20-3d806cf8a702","startedAtMs":1780962810702}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"cbaa6105-6995-4c6a-811f-276491c56bd8","clientId":null,"content":[{"type":"text","text":"Return the source marker followed by the transferred fork marker, separated by a single | character. Respond with only the markers and separator.","text_elements":[]}]},"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-db48-7bd3-9c20-3d806cf8a702","completedAtMs":1780962810702}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_07606c9d8f192b2f016a2755fbeae881998ccd60fcefdf629e","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-db48-7bd3-9c20-3d806cf8a702","startedAtMs":1780962811903}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-db48-7bd3-9c20-3d806cf8a702","itemId":"msg_07606c9d8f192b2f016a2755fbeae881998ccd60fcefdf629e","delta":"merge"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-db48-7bd3-9c20-3d806cf8a702","itemId":"msg_07606c9d8f192b2f016a2755fbeae881998ccd60fcefdf629e","delta":"-source"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-db48-7bd3-9c20-3d806cf8a702","itemId":"msg_07606c9d8f192b2f016a2755fbeae881998ccd60fcefdf629e","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-db48-7bd3-9c20-3d806cf8a702","itemId":"msg_07606c9d8f192b2f016a2755fbeae881998ccd60fcefdf629e","delta":"4"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-db48-7bd3-9c20-3d806cf8a702","itemId":"msg_07606c9d8f192b2f016a2755fbeae881998ccd60fcefdf629e","delta":"H"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-db48-7bd3-9c20-3d806cf8a702","itemId":"msg_07606c9d8f192b2f016a2755fbeae881998ccd60fcefdf629e","delta":"8"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-db48-7bd3-9c20-3d806cf8a702","itemId":"msg_07606c9d8f192b2f016a2755fbeae881998ccd60fcefdf629e","delta":"Q"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-db48-7bd3-9c20-3d806cf8a702","itemId":"msg_07606c9d8f192b2f016a2755fbeae881998ccd60fcefdf629e","delta":"|"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-db48-7bd3-9c20-3d806cf8a702","itemId":"msg_07606c9d8f192b2f016a2755fbeae881998ccd60fcefdf629e","delta":"merge"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-db48-7bd3-9c20-3d806cf8a702","itemId":"msg_07606c9d8f192b2f016a2755fbeae881998ccd60fcefdf629e","delta":"-f"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-db48-7bd3-9c20-3d806cf8a702","itemId":"msg_07606c9d8f192b2f016a2755fbeae881998ccd60fcefdf629e","delta":"ork"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-db48-7bd3-9c20-3d806cf8a702","itemId":"msg_07606c9d8f192b2f016a2755fbeae881998ccd60fcefdf629e","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-db48-7bd3-9c20-3d806cf8a702","itemId":"msg_07606c9d8f192b2f016a2755fbeae881998ccd60fcefdf629e","delta":"7"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-db48-7bd3-9c20-3d806cf8a702","itemId":"msg_07606c9d8f192b2f016a2755fbeae881998ccd60fcefdf629e","delta":"T"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-db48-7bd3-9c20-3d806cf8a702","itemId":"msg_07606c9d8f192b2f016a2755fbeae881998ccd60fcefdf629e","delta":"2"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-db48-7bd3-9c20-3d806cf8a702","itemId":"msg_07606c9d8f192b2f016a2755fbeae881998ccd60fcefdf629e","delta":"W"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_07606c9d8f192b2f016a2755fbeae881998ccd60fcefdf629e","text":"merge-source-4H8Q|merge-fork-7T2W","phase":"final_answer","memoryCitation":null},"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-db48-7bd3-9c20-3d806cf8a702","completedAtMs":1780962812055}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turnId":"019ea9a7-db48-7bd3-9c20-3d806cf8a702","tokenUsage":{"total":{"totalTokens":55542,"inputTokens":55508,"cachedInputTokens":54912,"outputTokens":34,"reasoningOutputTokens":0},"last":{"totalTokens":18574,"inputTokens":18554,"cachedInputTokens":18304,"outputTokens":20,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1780968999},"secondary":{"usedPercent":3,"windowDurationMins":10080,"resetsAt":1781296757},"credits":null,"individualLimit":null,"planType":"pro","rateLimitReachedType":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019ea9a7-ac5e-74f0-a17c-75426d4c40c1","turn":{"id":"019ea9a7-db48-7bd3-9c20-3d806cf8a702","items":[],"itemsView":"notLoaded","status":"completed","error":null,"startedAt":1780962810,"completedAt":1780962812,"durationMs":1382}}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/thread_merge_back_siblings/README.md b/apps/server/src/orchestration-v2/testkit/fixtures/thread_merge_back_siblings/README.md
new file mode 100644
index 000000000000..363b3a510328
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/thread_merge_back_siblings/README.md
@@ -0,0 +1,46 @@
+# Repeated Sibling Merge-Back Fixture
+
+This fixture records two independent native forks from one source turn, then
+feeds both fork deltas back into the original provider thread in sequence. A
+later source turn must recall all transferred context.
+
+Both provider transcripts execute the same graph.
+
+## Conversation Graph
+
+```text
+Source provider thread
+|
+`-- Turn 1: remember merge-sibling-source-3C7K
+    |
+    +-- native fork A
+    |   `-- Turn 2A: remember merge-sibling-first-6V2J
+    |
+    `-- native fork B
+        `-- Turn 2B: remember merge-sibling-second-9X5B
+
+Original source provider thread
+|
++-- Turn 3: consume merge-back handoff from fork A
+|   `-- Assistant: first merge delta stored
+|
++-- Turn 4: consume merge-back handoff from fork B
+|   `-- Assistant: second merge delta stored
+|
+`-- Turn 5: recall all markers without restating them
+    `-- merge-sibling-source-3C7K
+        |merge-sibling-first-6V2J
+        |merge-sibling-second-9X5B
+```
+
+## Assertions
+
+- Both forks have distinct native provider thread or session IDs.
+- Both handoffs resume the original source provider thread.
+- The final recall prompt contains none of the three markers.
+- The final response returns the source marker followed by both fork markers
+  in merge order.
+
+This proves repeated handoffs accumulate provider context. The app-level
+transfer records, merge ordering, and source/fork projections remain
+orchestrator responsibilities.
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/thread_merge_back_siblings/claude_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/thread_merge_back_siblings/claude_transcript.ndjson
new file mode 100644
index 000000000000..2e0bbf285ecf
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/thread_merge_back_siblings/claude_transcript.ndjson
@@ -0,0 +1,49 @@
+{"type":"transcript_start","provider":"claudeAgent","protocol":"claude-agent-sdk.query","version":"0.2.111","scenario":"thread_merge_back_siblings","metadata":{"prompts":["Remember the opaque marker merge-sibling-source-3C7K for later in this conversation. Respond with exactly: merge sibling source stored","Remember the fork-local marker merge-sibling-first-6V2J. Respond with exactly: first merge sibling stored","Remember the fork-local marker merge-sibling-second-9X5B. Respond with exactly: second merge sibling stored","Context handoff (merge_back / fork_delta_summary):\nMerge-back context from first forked conversation.\n\nFork delta:\n- User introduced opaque marker merge-sibling-first-6V2J.\n- Assistant confirmed: first merge sibling stored\n\nUser message:\nRetain the first transferred marker for later. Respond with exactly: first merge delta stored","Context handoff (merge_back / fork_delta_summary):\nMerge-back context from second forked conversation.\n\nFork delta:\n- User introduced opaque marker merge-sibling-second-9X5B.\n- Assistant confirmed: second merge sibling stored\n\nUser message:\nRetain the second transferred marker for later. Respond with exactly: second merge delta stored","Return the source marker followed by both transferred fork markers in merge order, separated by single | characters. Respond with only the markers and separators."],"model":"claude-sonnet-4-6","nativeSessionId":"093127f0-d3a7-42f8-938e-b1162927a0ea","queryMode":"fork_session_merge_back_siblings","tools":"claude_code","permissionMode":"bypassPermissions","generatedBy":"recordClaudeAgentSdkReplayTranscript","sourceAssistantMessageUuids":["1fc21da3-d746-4ed9-9a01-47a5bced6ad7"],"forkUpToMessageId":"1fc21da3-d746-4ed9-9a01-47a5bced6ad7","forkedNativeSessionId":"aeec447f-87e5-4874-8fe7-7f937f7c3311","forkedNativeSessionIds":["aeec447f-87e5-4874-8fe7-7f937f7c3311","f85cf945-d406-4573-b2ae-0e799d9a9365"],"sourceContinuationPromptCount":3}}
+{"type":"expect_outbound","label":"query.open:source","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"sessionId":"093127f0-d3a7-42f8-938e-b1162927a0ea"}}}
+{"type":"expect_outbound","label":"prompt.offer:1","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Remember the opaque marker merge-sibling-source-3C7K for later in this conversation. Respond with exactly: merge sibling source stored"},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"287092a3-3285-4f46-aec5-46b1564d2c0f","hook_name":"SessionStart:startup","hook_event":"SessionStart","uuid":"6e964ad7-4a39-40da-a119-9d2d1f2d3a4d","session_id":"093127f0-d3a7-42f8-938e-b1162927a0ea"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"287092a3-3285-4f46-aec5-46b1564d2c0f","hook_name":"SessionStart:startup","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"d721febd-160d-4f12-a7c0-ed4d7d50e627","session_id":"093127f0-d3a7-42f8-938e-b1162927a0ea"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.159","cwd":"/tmp/claude-replay-thread_merge_back_siblings","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"6356a232-e499-4aab-9b93-ebcaf58a44ae","session_id":"093127f0-d3a7-42f8-938e-b1162927a0ea"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01RrxtVdwmiru9uWcEgFMQtT","type":"message","role":"assistant","content":[{"type":"text","text":"merge sibling source stored"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":18982,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"093127f0-d3a7-42f8-938e-b1162927a0ea","uuid":"1fc21da3-d746-4ed9-9a01-47a5bced6ad7","request_id":"req_011CbrhcV1YMqb8WGRDjvTgo"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed"},"uuid":"04dac113-90a6-48fa-ab30-d02d34e76f76","session_id":"093127f0-d3a7-42f8-938e-b1162927a0ea"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":2354,"duration_api_ms":1892,"ttft_ms":1845,"num_turns":1,"result":"merge sibling source stored","stop_reason":"end_turn","session_id":"093127f0-d3a7-42f8-938e-b1162927a0ea","total_cost_usd":0.005823599999999999,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":18982,"output_tokens":8,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"inference_geo":"not_available","iterations":[{"input_tokens":3,"output_tokens":8,"cache_read_input_tokens":18982,"cache_creation_input_tokens":0,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":3,"outputTokens":8,"cacheReadInputTokens":18982,"cacheCreationInputTokens":0,"webSearchRequests":0,"costUSD":0.005823599999999999,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"148a66d3-6af8-42ec-95d9-51106ba6b80c"}}
+{"type":"runtime_exit","status":"success"}
+{"type":"expect_outbound","label":"session.fork:1","frame":{"type":"session.fork","sessionId":"093127f0-d3a7-42f8-938e-b1162927a0ea","options":{"dir":"/tmp/claude-replay-thread_merge_back_siblings","upToMessageId":"1fc21da3-d746-4ed9-9a01-47a5bced6ad7"}}}
+{"type":"emit_inbound","label":"session.forked:1","frame":{"type":"session.forked","sessionId":"aeec447f-87e5-4874-8fe7-7f937f7c3311"}}
+{"type":"expect_outbound","label":"query.open:fork:1","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"resume":"aeec447f-87e5-4874-8fe7-7f937f7c3311"}}}
+{"type":"expect_outbound","label":"prompt.offer:2","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Remember the fork-local marker merge-sibling-first-6V2J. Respond with exactly: first merge sibling stored"},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"a4497d0c-e144-496b-a3c6-8353bd5a478f","hook_name":"SessionStart:resume","hook_event":"SessionStart","uuid":"e3634541-eac3-4e8a-8f66-f4ce9aa1cf3e","session_id":"a0138f8c-497c-4d60-919d-97615e7f41f3"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"a4497d0c-e144-496b-a3c6-8353bd5a478f","hook_name":"SessionStart:resume","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"c2cc2495-045f-4d09-8dfb-039360e1f075","session_id":"a0138f8c-497c-4d60-919d-97615e7f41f3"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.159","cwd":"/tmp/claude-replay-thread_merge_back_siblings","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"383d91ea-4429-40e2-8138-c88e6898a6ac","session_id":"aeec447f-87e5-4874-8fe7-7f937f7c3311"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_015qRf5PaeUWEPpaDCg7caEa","type":"message","role":"assistant","content":[{"type":"text","text":"first merge sibling stored"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":19120,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"aeec447f-87e5-4874-8fe7-7f937f7c3311","uuid":"882b9c8b-27a0-4f65-a8bb-56855435efcc","request_id":"req_011CbrhcjEZ9Ncci4PPWFmnv"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed"},"uuid":"3b7a92ea-d3b5-47b8-94df-b214af9ccd75","session_id":"aeec447f-87e5-4874-8fe7-7f937f7c3311"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":2344,"duration_api_ms":1855,"ttft_ms":1992,"num_turns":1,"result":"first merge sibling stored","stop_reason":"end_turn","session_id":"aeec447f-87e5-4874-8fe7-7f937f7c3311","total_cost_usd":0.005865,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":19120,"output_tokens":8,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"inference_geo":"not_available","iterations":[{"input_tokens":3,"output_tokens":8,"cache_read_input_tokens":19120,"cache_creation_input_tokens":0,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":3,"outputTokens":8,"cacheReadInputTokens":19120,"cacheCreationInputTokens":0,"webSearchRequests":0,"costUSD":0.005865,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"64da0416-b03b-4e9e-9ae9-9c85eb8ac0ef"}}
+{"type":"runtime_exit","status":"success"}
+{"type":"expect_outbound","label":"session.fork:2","frame":{"type":"session.fork","sessionId":"093127f0-d3a7-42f8-938e-b1162927a0ea","options":{"dir":"/tmp/claude-replay-thread_merge_back_siblings","upToMessageId":"1fc21da3-d746-4ed9-9a01-47a5bced6ad7"}}}
+{"type":"emit_inbound","label":"session.forked:2","frame":{"type":"session.forked","sessionId":"f85cf945-d406-4573-b2ae-0e799d9a9365"}}
+{"type":"expect_outbound","label":"query.open:fork:2","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"resume":"f85cf945-d406-4573-b2ae-0e799d9a9365"}}}
+{"type":"expect_outbound","label":"prompt.offer:3","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Remember the fork-local marker merge-sibling-second-9X5B. Respond with exactly: second merge sibling stored"},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"67ef07f2-14fe-426e-9f98-0045dfc87584","hook_name":"SessionStart:resume","hook_event":"SessionStart","uuid":"53ba32d0-f84e-4d95-a546-c59a6cf79204","session_id":"0c31bc0d-e94d-40a1-8438-7a046085e63c"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"67ef07f2-14fe-426e-9f98-0045dfc87584","hook_name":"SessionStart:resume","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"a4415555-c7a7-4438-90d3-3ede9f25c09e","session_id":"0c31bc0d-e94d-40a1-8438-7a046085e63c"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.159","cwd":"/tmp/claude-replay-thread_merge_back_siblings","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"3915b18b-6762-41cf-a1e4-efe7c59b02fb","session_id":"f85cf945-d406-4573-b2ae-0e799d9a9365"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01CJMcHKa4tPF7WmbzgiYJzK","type":"message","role":"assistant","content":[{"type":"text","text":"second merge sibling stored"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":19120,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"f85cf945-d406-4573-b2ae-0e799d9a9365","uuid":"bd00e335-ddc7-4632-b2f7-91884a61c526","request_id":"req_011Cbrhcxod9xdS2RyzudMBf"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed"},"uuid":"0866ea29-f780-4df5-a750-ca690616ebc8","session_id":"f85cf945-d406-4573-b2ae-0e799d9a9365"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":3142,"duration_api_ms":2643,"ttft_ms":2742,"num_turns":1,"result":"second merge sibling stored","stop_reason":"end_turn","session_id":"f85cf945-d406-4573-b2ae-0e799d9a9365","total_cost_usd":0.005865,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":19120,"output_tokens":8,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"inference_geo":"not_available","iterations":[{"input_tokens":3,"output_tokens":8,"cache_read_input_tokens":19120,"cache_creation_input_tokens":0,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":3,"outputTokens":8,"cacheReadInputTokens":19120,"cacheCreationInputTokens":0,"webSearchRequests":0,"costUSD":0.005865,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"416477cb-5817-4ce6-91f6-9af0512546c1"}}
+{"type":"runtime_exit","status":"success"}
+{"type":"expect_outbound","label":"query.open:source-continuation","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"resume":"093127f0-d3a7-42f8-938e-b1162927a0ea"}}}
+{"type":"expect_outbound","label":"prompt.offer:4","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Context handoff (merge_back / fork_delta_summary):\nMerge-back context from first forked conversation.\n\nFork delta:\n- User introduced opaque marker merge-sibling-first-6V2J.\n- Assistant confirmed: first merge sibling stored\n\nUser message:\nRetain the first transferred marker for later. Respond with exactly: first merge delta stored"},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"34c28999-6908-4d67-b82b-57b867c753c4","hook_name":"SessionStart:resume","hook_event":"SessionStart","uuid":"a54c5bb9-b6ee-4fc6-9e88-a7e46e280f66","session_id":"60a34659-0e64-4a1a-bfe5-c509b267fd8c"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"34c28999-6908-4d67-b82b-57b867c753c4","hook_name":"SessionStart:resume","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"2884b7c6-317a-4b6b-bf65-8309cb8b6311","session_id":"60a34659-0e64-4a1a-bfe5-c509b267fd8c"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.159","cwd":"/tmp/claude-replay-thread_merge_back_siblings","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"1af63cf2-01bf-4777-8c9a-5af132449a84","session_id":"093127f0-d3a7-42f8-938e-b1162927a0ea"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_019cPzFiAZRSLJVq7oAmq9iS","type":"message","role":"assistant","content":[{"type":"text","text":"first merge delta stored"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":19174,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"093127f0-d3a7-42f8-938e-b1162927a0ea","uuid":"eefb144e-de0a-4bd0-9b5b-1d0275f8279a","request_id":"req_011CbrhdGmcr3UsGQaYg3J2P"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed"},"uuid":"e02f1855-f7bf-4f32-8881-67521b3c3f50","session_id":"093127f0-d3a7-42f8-938e-b1162927a0ea"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":2290,"duration_api_ms":1716,"ttft_ms":1887,"num_turns":1,"result":"first merge delta stored","stop_reason":"end_turn","session_id":"093127f0-d3a7-42f8-938e-b1162927a0ea","total_cost_usd":0.0058662,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":19174,"output_tokens":7,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"inference_geo":"not_available","iterations":[{"input_tokens":3,"output_tokens":7,"cache_read_input_tokens":19174,"cache_creation_input_tokens":0,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":3,"outputTokens":7,"cacheReadInputTokens":19174,"cacheCreationInputTokens":0,"webSearchRequests":0,"costUSD":0.0058662,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"60db1964-08e2-4150-9a53-d801b42532e3"}}
+{"type":"expect_outbound","label":"prompt.offer:5","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Context handoff (merge_back / fork_delta_summary):\nMerge-back context from second forked conversation.\n\nFork delta:\n- User introduced opaque marker merge-sibling-second-9X5B.\n- Assistant confirmed: second merge sibling stored\n\nUser message:\nRetain the second transferred marker for later. Respond with exactly: second merge delta stored"},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.159","cwd":"/tmp/claude-replay-thread_merge_back_siblings","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"a75759c3-f74c-4a6b-96fd-37d9676c8aa0","session_id":"093127f0-d3a7-42f8-938e-b1162927a0ea"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01V73UC9GPx9CYzNQZ98G7Cj","type":"message","role":"assistant","content":[{"type":"text","text":"second merge delta stored"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":19266,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"output_tokens":7,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"093127f0-d3a7-42f8-938e-b1162927a0ea","uuid":"0ca21389-bb8b-4e36-9945-03197086ff4a","request_id":"req_011CbrhdTjvQiYZFwuo6LRFF"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":2674,"duration_api_ms":3656,"ttft_ms":2315,"num_turns":1,"result":"second merge delta stored","stop_reason":"end_turn","session_id":"093127f0-d3a7-42f8-938e-b1162927a0ea","total_cost_usd":0.01176,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":19266,"output_tokens":7,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"inference_geo":"not_available","iterations":[{"input_tokens":3,"output_tokens":7,"cache_read_input_tokens":19266,"cache_creation_input_tokens":0,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":6,"outputTokens":14,"cacheReadInputTokens":38440,"cacheCreationInputTokens":0,"webSearchRequests":0,"costUSD":0.01176,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"2371916a-f2e1-448d-8e02-021b3f285f26"}}
+{"type":"expect_outbound","label":"prompt.offer:6","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Return the source marker followed by both transferred fork markers in merge order, separated by single | characters. Respond with only the markers and separators."},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.159","cwd":"/tmp/claude-replay-thread_merge_back_siblings","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"0424e87c-1117-425e-b1bd-b8818bd515ff","session_id":"093127f0-d3a7-42f8-938e-b1162927a0ea"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01Th7ELGf9SmiFAU5SdHWj6M","type":"message","role":"assistant","content":[{"type":"text","text":"merge-sibling-source-3C7K|merge-sibling-first-6V2J|merge-sibling-second-9X5B"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":19306,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"093127f0-d3a7-42f8-938e-b1162927a0ea","uuid":"c944fb89-eaf9-4d43-a866-61c938cd5b16","request_id":"req_011Cbrhde6GjewDduCrJMfAK"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":2913,"duration_api_ms":6052,"ttft_ms":2605,"num_turns":1,"result":"merge-sibling-source-3C7K|merge-sibling-first-6V2J|merge-sibling-second-9X5B","stop_reason":"end_turn","session_id":"093127f0-d3a7-42f8-938e-b1162927a0ea","total_cost_usd":0.0181308,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":19306,"output_tokens":38,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"inference_geo":"not_available","iterations":[{"input_tokens":3,"output_tokens":38,"cache_read_input_tokens":19306,"cache_creation_input_tokens":0,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":9,"outputTokens":52,"cacheReadInputTokens":57746,"cacheCreationInputTokens":0,"webSearchRequests":0,"costUSD":0.0181308,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"ed8d4207-bb59-4363-af94-dd399e7280b5"}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/thread_merge_back_siblings/codex_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/thread_merge_back_siblings/codex_transcript.ndjson
new file mode 100644
index 000000000000..6c093a23e45f
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/thread_merge_back_siblings/codex_transcript.ndjson
@@ -0,0 +1,177 @@
+{"type":"transcript_start","provider":"codex","protocol":"codex.app-server","version":"0.137.0","scenario":"thread_merge_back_siblings","metadata":{"source":"record-codex-app-server-replay-fixture","fileName":"thread_merge_back_siblings.ndjson","description":"Two sibling fork deltas are merged sequentially into one source provider thread and recalled together."}}
+{"type":"expect_outbound","label":"initialize","frame":{"id":1,"method":"initialize","params":{"capabilities":{"experimentalApi":true},"clientInfo":{"name":"t3code_desktop","title":"T3 Code Desktop","version":"0.1.0"}}}}
+{"type":"emit_inbound","label":"initialize","frame":{"id":1,"result":{"userAgent":"t3code_desktop/0.137.0 (Mac OS 26.5.1; arm64) dumb (t3code_desktop; 0.1.0)","codexHome":"/Users/julius/.codex","platformFamily":"unix","platformOs":"macos"}}}
+{"type":"expect_outbound","label":"initialized","frame":{"method":"initialized"}}
+{"type":"expect_outbound","label":"thread/start","frame":{"id":2,"method":"thread/start","params":{}}}
+{"type":"emit_inbound","label":"remoteControl/status/changed","frame":{"method":"remoteControl/status/changed","params":{"status":"disabled","serverName":"Juliuss-MacBook-Pro.local","installationId":"c067a38f-79bf-4874-ba7b-c00e86012954","environmentId":null}}}
+{"type":"emit_inbound","label":"thread/start","frame":{"id":2,"result":{"thread":{"id":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","sessionId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","forkedFromId":null,"parentThreadId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1780962812,"updatedAt":1780962812,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/06/08/rollout-2026-06-08T16-53-32-019ea9a7-e28f-7c72-96e8-9ca581f225ce.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server","cliVersion":"0.137.0","source":"vscode","threadSource":null,"agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]},"model":"kindle-alpha","modelProvider":"openai","serviceTier":null,"cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server","runtimeWorkspaceRoots":["/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server"],"instructionSources":["/Users/julius/.codex/AGENTS.md","/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/AGENTS.md"],"approvalPolicy":"on-request","approvalsReviewer":"user","sandbox":{"type":"workspaceWrite","writableRoots":[],"networkAccess":false,"excludeTmpdirEnvVar":false,"excludeSlashTmp":false},"activePermissionProfile":{"id":":workspace","extends":null},"reasoningEffort":"medium"}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":3,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Remember the opaque marker merge-sibling-source-3C7K for later in this conversation. Respond with exactly: merge sibling source stored","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"type":"dangerFullAccess"},"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"thread/started","frame":{"method":"thread/started","params":{"thread":{"id":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","sessionId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","forkedFromId":null,"parentThreadId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1780962812,"updatedAt":1780962812,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/06/08/rollout-2026-06-08T16-53-32-019ea9a7-e28f-7c72-96e8-9ca581f225ce.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server","cliVersion":"0.137.0","source":"vscode","threadSource":null,"agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]}}}}
+{"type":"emit_inbound","label":"deprecationNotice","frame":{"method":"deprecationNotice","params":{"summary":"`[features].collab` is deprecated. Use `[features].multi_agent` instead.","details":"Enable it with `--enable multi_agent` or `[features].multi_agent` in config.toml. See https://developers.openai.com/codex/config-basic#feature-flags for details."}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"node_repl","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"openaiDeveloperDocs","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"computer-use","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"xcodebuildmcp","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"node_repl","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":3,"result":{"turn":{"id":"019ea9a7-e43a-74f2-b94e-99f168de38fd","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"computer-use","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turn":{"id":"019ea9a7-e43a-74f2-b94e-99f168de38fd","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":1780962813,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"openaiDeveloperDocs","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"xcodebuildmcp","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"414865c7-8d0f-4e99-884f-f733ab31af58","clientId":null,"content":[{"type":"text","text":"Remember the opaque marker merge-sibling-source-3C7K for later in this conversation. Respond with exactly: merge sibling source stored","text_elements":[]}]},"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a7-e43a-74f2-b94e-99f168de38fd","startedAtMs":1780962815823}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"414865c7-8d0f-4e99-884f-f733ab31af58","clientId":null,"content":[{"type":"text","text":"Remember the opaque marker merge-sibling-source-3C7K for later in this conversation. Respond with exactly: merge sibling source stored","text_elements":[]}]},"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a7-e43a-74f2-b94e-99f168de38fd","completedAtMs":1780962815823}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_06277fc0328731b4016a2756010c1081988be7cdbf9f74ae0f","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a7-e43a-74f2-b94e-99f168de38fd","startedAtMs":1780962817032}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a7-e43a-74f2-b94e-99f168de38fd","itemId":"msg_06277fc0328731b4016a2756010c1081988be7cdbf9f74ae0f","delta":"merge"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a7-e43a-74f2-b94e-99f168de38fd","itemId":"msg_06277fc0328731b4016a2756010c1081988be7cdbf9f74ae0f","delta":" sibling"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a7-e43a-74f2-b94e-99f168de38fd","itemId":"msg_06277fc0328731b4016a2756010c1081988be7cdbf9f74ae0f","delta":" source"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a7-e43a-74f2-b94e-99f168de38fd","itemId":"msg_06277fc0328731b4016a2756010c1081988be7cdbf9f74ae0f","delta":" stored"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_06277fc0328731b4016a2756010c1081988be7cdbf9f74ae0f","text":"merge sibling source stored","phase":"final_answer","memoryCitation":null},"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a7-e43a-74f2-b94e-99f168de38fd","completedAtMs":1780962817141}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a7-e43a-74f2-b94e-99f168de38fd","tokenUsage":{"total":{"totalTokens":18450,"inputTokens":18442,"cachedInputTokens":18304,"outputTokens":8,"reasoningOutputTokens":0},"last":{"totalTokens":18450,"inputTokens":18442,"cachedInputTokens":18304,"outputTokens":8,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1780968999},"secondary":{"usedPercent":3,"windowDurationMins":10080,"resetsAt":1781296757},"credits":null,"individualLimit":null,"planType":"pro","rateLimitReachedType":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turn":{"id":"019ea9a7-e43a-74f2-b94e-99f168de38fd","items":[],"itemsView":"notLoaded","status":"completed","error":null,"startedAt":1780962813,"completedAt":1780962817,"durationMs":4111}}}}
+{"type":"expect_outbound","label":"thread/fork","frame":{"id":4,"method":"thread/fork","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce"}}}
+{"type":"emit_inbound","label":"deprecationNotice","frame":{"method":"deprecationNotice","params":{"summary":"`[features].collab` is deprecated. Use `[features].multi_agent` instead.","details":"Enable it with `--enable multi_agent` or `[features].multi_agent` in config.toml. See https://developers.openai.com/codex/config-basic#feature-flags for details."}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"computer-use","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"openaiDeveloperDocs","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"xcodebuildmcp","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"node_repl","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"node_repl","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"thread/fork","frame":{"id":4,"result":{"thread":{"id":"019ea9a7-f48f-74e2-b87e-4a7e9313b57a","sessionId":"019ea9a7-f48f-74e2-b87e-4a7e9313b57a","forkedFromId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","parentThreadId":null,"preview":"Remember the opaque marker merge-sibling-source-3C7K for later in this conversation. Respond with exactly: merge sibling source stored","ephemeral":false,"modelProvider":"openai","createdAt":1780962817,"updatedAt":1780962817,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/06/08/rollout-2026-06-08T16-53-37-019ea9a7-f48f-74e2-b87e-4a7e9313b57a.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server","cliVersion":"0.137.0","source":"vscode","threadSource":null,"agentNickname":null,"agentRole":null,"gitInfo":{"sha":"5115887f33051a4e25d2b427622a54656eeb9ab0","branch":"t3code/17b43ed6","originUrl":"git@github.com:pingdotgg/t3code.git"},"name":null,"turns":[{"id":"019ea9a7-e43a-74f2-b94e-99f168de38fd","items":[{"type":"userMessage","id":"item-1","clientId":null,"content":[{"type":"text","text":"Remember the opaque marker merge-sibling-source-3C7K for later in this conversation. Respond with exactly: merge sibling source stored","text_elements":[]}]},{"type":"agentMessage","id":"item-2","text":"merge sibling source stored","phase":"final_answer","memoryCitation":null}],"itemsView":"full","status":"completed","error":null,"startedAt":1780962813,"completedAt":1780962817,"durationMs":4111}]},"model":"kindle-alpha","modelProvider":"openai","serviceTier":null,"cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server","runtimeWorkspaceRoots":["/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server"],"instructionSources":["/Users/julius/.codex/AGENTS.md","/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/AGENTS.md"],"approvalPolicy":"on-request","approvalsReviewer":"user","sandbox":{"type":"workspaceWrite","writableRoots":[],"networkAccess":false,"excludeTmpdirEnvVar":false,"excludeSlashTmp":false},"activePermissionProfile":{"id":":workspace","extends":null},"reasoningEffort":"medium"}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":5,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Remember the fork-local marker merge-sibling-first-6V2J. Respond with exactly: first merge sibling stored","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"type":"dangerFullAccess"},"threadId":"019ea9a7-f48f-74e2-b87e-4a7e9313b57a","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019ea9a7-f48f-74e2-b87e-4a7e9313b57a","turnId":"019ea9a7-e43a-74f2-b94e-99f168de38fd","tokenUsage":{"total":{"totalTokens":18450,"inputTokens":18442,"cachedInputTokens":18304,"outputTokens":8,"reasoningOutputTokens":0},"last":{"totalTokens":18450,"inputTokens":18442,"cachedInputTokens":18304,"outputTokens":8,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"thread/started","frame":{"method":"thread/started","params":{"thread":{"id":"019ea9a7-f48f-74e2-b87e-4a7e9313b57a","sessionId":"019ea9a7-f48f-74e2-b87e-4a7e9313b57a","forkedFromId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","parentThreadId":null,"preview":"Remember the opaque marker merge-sibling-source-3C7K for later in this conversation. Respond with exactly: merge sibling source stored","ephemeral":false,"modelProvider":"openai","createdAt":1780962817,"updatedAt":1780962817,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/06/08/rollout-2026-06-08T16-53-37-019ea9a7-f48f-74e2-b87e-4a7e9313b57a.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server","cliVersion":"0.137.0","source":"vscode","threadSource":null,"agentNickname":null,"agentRole":null,"gitInfo":{"sha":"5115887f33051a4e25d2b427622a54656eeb9ab0","branch":"t3code/17b43ed6","originUrl":"git@github.com:pingdotgg/t3code.git"},"name":null,"turns":[]}}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":5,"result":{"turn":{"id":"019ea9a7-f5bd-7c22-a906-5625e1d8564d","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019ea9a7-f48f-74e2-b87e-4a7e9313b57a","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019ea9a7-f48f-74e2-b87e-4a7e9313b57a","turn":{"id":"019ea9a7-f5bd-7c22-a906-5625e1d8564d","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":1780962817,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"computer-use","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"openaiDeveloperDocs","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"xcodebuildmcp","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"6b29bc9c-a11c-4964-8abb-bd6d4d9b5a45","clientId":null,"content":[{"type":"text","text":"Remember the fork-local marker merge-sibling-first-6V2J. Respond with exactly: first merge sibling stored","text_elements":[]}]},"threadId":"019ea9a7-f48f-74e2-b87e-4a7e9313b57a","turnId":"019ea9a7-f5bd-7c22-a906-5625e1d8564d","startedAtMs":1780962820754}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"6b29bc9c-a11c-4964-8abb-bd6d4d9b5a45","clientId":null,"content":[{"type":"text","text":"Remember the fork-local marker merge-sibling-first-6V2J. Respond with exactly: first merge sibling stored","text_elements":[]}]},"threadId":"019ea9a7-f48f-74e2-b87e-4a7e9313b57a","turnId":"019ea9a7-f5bd-7c22-a906-5625e1d8564d","completedAtMs":1780962820754}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_0fde512d42364efb016a275605f480819881e0df18496165db","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019ea9a7-f48f-74e2-b87e-4a7e9313b57a","turnId":"019ea9a7-f5bd-7c22-a906-5625e1d8564d","startedAtMs":1780962821962}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-f48f-74e2-b87e-4a7e9313b57a","turnId":"019ea9a7-f5bd-7c22-a906-5625e1d8564d","itemId":"msg_0fde512d42364efb016a275605f480819881e0df18496165db","delta":"first"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-f48f-74e2-b87e-4a7e9313b57a","turnId":"019ea9a7-f5bd-7c22-a906-5625e1d8564d","itemId":"msg_0fde512d42364efb016a275605f480819881e0df18496165db","delta":" merge"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-f48f-74e2-b87e-4a7e9313b57a","turnId":"019ea9a7-f5bd-7c22-a906-5625e1d8564d","itemId":"msg_0fde512d42364efb016a275605f480819881e0df18496165db","delta":" sibling"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-f48f-74e2-b87e-4a7e9313b57a","turnId":"019ea9a7-f5bd-7c22-a906-5625e1d8564d","itemId":"msg_0fde512d42364efb016a275605f480819881e0df18496165db","delta":" stored"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_0fde512d42364efb016a275605f480819881e0df18496165db","text":"first merge sibling stored","phase":"final_answer","memoryCitation":null},"threadId":"019ea9a7-f48f-74e2-b87e-4a7e9313b57a","turnId":"019ea9a7-f5bd-7c22-a906-5625e1d8564d","completedAtMs":1780962822025}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019ea9a7-f48f-74e2-b87e-4a7e9313b57a","turnId":"019ea9a7-f5bd-7c22-a906-5625e1d8564d","tokenUsage":{"total":{"totalTokens":36937,"inputTokens":36921,"cachedInputTokens":36608,"outputTokens":16,"reasoningOutputTokens":0},"last":{"totalTokens":18487,"inputTokens":18479,"cachedInputTokens":18304,"outputTokens":8,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1780968999},"secondary":{"usedPercent":3,"windowDurationMins":10080,"resetsAt":1781296757},"credits":null,"individualLimit":null,"planType":"pro","rateLimitReachedType":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019ea9a7-f48f-74e2-b87e-4a7e9313b57a","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019ea9a7-f48f-74e2-b87e-4a7e9313b57a","turn":{"id":"019ea9a7-f5bd-7c22-a906-5625e1d8564d","items":[],"itemsView":"notLoaded","status":"completed","error":null,"startedAt":1780962817,"completedAt":1780962822,"durationMs":4566}}}}
+{"type":"expect_outbound","label":"thread/fork","frame":{"id":6,"method":"thread/fork","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce"}}}
+{"type":"emit_inbound","label":"deprecationNotice","frame":{"method":"deprecationNotice","params":{"summary":"`[features].collab` is deprecated. Use `[features].multi_agent` instead.","details":"Enable it with `--enable multi_agent` or `[features].multi_agent` in config.toml. See https://developers.openai.com/codex/config-basic#feature-flags for details."}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"node_repl","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"xcodebuildmcp","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"openaiDeveloperDocs","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"computer-use","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"node_repl","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"thread/fork","frame":{"id":6,"result":{"thread":{"id":"019ea9a8-079f-7100-bbdf-74026e9c20c1","sessionId":"019ea9a8-079f-7100-bbdf-74026e9c20c1","forkedFromId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","parentThreadId":null,"preview":"Remember the opaque marker merge-sibling-source-3C7K for later in this conversation. Respond with exactly: merge sibling source stored","ephemeral":false,"modelProvider":"openai","createdAt":1780962822,"updatedAt":1780962822,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/06/08/rollout-2026-06-08T16-53-42-019ea9a8-079f-7100-bbdf-74026e9c20c1.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server","cliVersion":"0.137.0","source":"vscode","threadSource":null,"agentNickname":null,"agentRole":null,"gitInfo":{"sha":"5115887f33051a4e25d2b427622a54656eeb9ab0","branch":"t3code/17b43ed6","originUrl":"git@github.com:pingdotgg/t3code.git"},"name":null,"turns":[{"id":"019ea9a7-e43a-74f2-b94e-99f168de38fd","items":[{"type":"userMessage","id":"item-1","clientId":null,"content":[{"type":"text","text":"Remember the opaque marker merge-sibling-source-3C7K for later in this conversation. Respond with exactly: merge sibling source stored","text_elements":[]}]},{"type":"agentMessage","id":"item-2","text":"merge sibling source stored","phase":"final_answer","memoryCitation":null}],"itemsView":"full","status":"completed","error":null,"startedAt":1780962813,"completedAt":1780962817,"durationMs":4111}]},"model":"kindle-alpha","modelProvider":"openai","serviceTier":null,"cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server","runtimeWorkspaceRoots":["/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server"],"instructionSources":["/Users/julius/.codex/AGENTS.md","/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/AGENTS.md"],"approvalPolicy":"on-request","approvalsReviewer":"user","sandbox":{"type":"workspaceWrite","writableRoots":[],"networkAccess":false,"excludeTmpdirEnvVar":false,"excludeSlashTmp":false},"activePermissionProfile":{"id":":workspace","extends":null},"reasoningEffort":"medium"}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":7,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Remember the fork-local marker merge-sibling-second-9X5B. Respond with exactly: second merge sibling stored","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"type":"dangerFullAccess"},"threadId":"019ea9a8-079f-7100-bbdf-74026e9c20c1","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019ea9a8-079f-7100-bbdf-74026e9c20c1","turnId":"019ea9a7-e43a-74f2-b94e-99f168de38fd","tokenUsage":{"total":{"totalTokens":18450,"inputTokens":18442,"cachedInputTokens":18304,"outputTokens":8,"reasoningOutputTokens":0},"last":{"totalTokens":18450,"inputTokens":18442,"cachedInputTokens":18304,"outputTokens":8,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"thread/started","frame":{"method":"thread/started","params":{"thread":{"id":"019ea9a8-079f-7100-bbdf-74026e9c20c1","sessionId":"019ea9a8-079f-7100-bbdf-74026e9c20c1","forkedFromId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","parentThreadId":null,"preview":"Remember the opaque marker merge-sibling-source-3C7K for later in this conversation. Respond with exactly: merge sibling source stored","ephemeral":false,"modelProvider":"openai","createdAt":1780962822,"updatedAt":1780962822,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/06/08/rollout-2026-06-08T16-53-42-019ea9a8-079f-7100-bbdf-74026e9c20c1.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-17b43ed6/apps/server","cliVersion":"0.137.0","source":"vscode","threadSource":null,"agentNickname":null,"agentRole":null,"gitInfo":{"sha":"5115887f33051a4e25d2b427622a54656eeb9ab0","branch":"t3code/17b43ed6","originUrl":"git@github.com:pingdotgg/t3code.git"},"name":null,"turns":[]}}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":7,"result":{"turn":{"id":"019ea9a8-093e-7f11-8cd1-a38c032d4642","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019ea9a8-079f-7100-bbdf-74026e9c20c1","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019ea9a8-079f-7100-bbdf-74026e9c20c1","turn":{"id":"019ea9a8-093e-7f11-8cd1-a38c032d4642","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":1780962822,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"computer-use","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"openaiDeveloperDocs","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"xcodebuildmcp","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"9b987e5e-f881-42f5-af00-5933edcaa621","clientId":null,"content":[{"type":"text","text":"Remember the fork-local marker merge-sibling-second-9X5B. Respond with exactly: second merge sibling stored","text_elements":[]}]},"threadId":"019ea9a8-079f-7100-bbdf-74026e9c20c1","turnId":"019ea9a8-093e-7f11-8cd1-a38c032d4642","startedAtMs":1780962825378}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"9b987e5e-f881-42f5-af00-5933edcaa621","clientId":null,"content":[{"type":"text","text":"Remember the fork-local marker merge-sibling-second-9X5B. Respond with exactly: second merge sibling stored","text_elements":[]}]},"threadId":"019ea9a8-079f-7100-bbdf-74026e9c20c1","turnId":"019ea9a8-093e-7f11-8cd1-a38c032d4642","completedAtMs":1780962825378}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_0d7a2fc55871887b016a27560a7d448199be437b0c7def0a16","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019ea9a8-079f-7100-bbdf-74026e9c20c1","turnId":"019ea9a8-093e-7f11-8cd1-a38c032d4642","startedAtMs":1780962826472}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a8-079f-7100-bbdf-74026e9c20c1","turnId":"019ea9a8-093e-7f11-8cd1-a38c032d4642","itemId":"msg_0d7a2fc55871887b016a27560a7d448199be437b0c7def0a16","delta":"second"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a8-079f-7100-bbdf-74026e9c20c1","turnId":"019ea9a8-093e-7f11-8cd1-a38c032d4642","itemId":"msg_0d7a2fc55871887b016a27560a7d448199be437b0c7def0a16","delta":" merge"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a8-079f-7100-bbdf-74026e9c20c1","turnId":"019ea9a8-093e-7f11-8cd1-a38c032d4642","itemId":"msg_0d7a2fc55871887b016a27560a7d448199be437b0c7def0a16","delta":" sibling"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a8-079f-7100-bbdf-74026e9c20c1","turnId":"019ea9a8-093e-7f11-8cd1-a38c032d4642","itemId":"msg_0d7a2fc55871887b016a27560a7d448199be437b0c7def0a16","delta":" stored"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_0d7a2fc55871887b016a27560a7d448199be437b0c7def0a16","text":"second merge sibling stored","phase":"final_answer","memoryCitation":null},"threadId":"019ea9a8-079f-7100-bbdf-74026e9c20c1","turnId":"019ea9a8-093e-7f11-8cd1-a38c032d4642","completedAtMs":1780962826567}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019ea9a8-079f-7100-bbdf-74026e9c20c1","turnId":"019ea9a8-093e-7f11-8cd1-a38c032d4642","tokenUsage":{"total":{"totalTokens":36937,"inputTokens":36921,"cachedInputTokens":36608,"outputTokens":16,"reasoningOutputTokens":0},"last":{"totalTokens":18487,"inputTokens":18479,"cachedInputTokens":18304,"outputTokens":8,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1780968999},"secondary":{"usedPercent":3,"windowDurationMins":10080,"resetsAt":1781296757},"credits":null,"individualLimit":null,"planType":"pro","rateLimitReachedType":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019ea9a8-079f-7100-bbdf-74026e9c20c1","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019ea9a8-079f-7100-bbdf-74026e9c20c1","turn":{"id":"019ea9a8-093e-7f11-8cd1-a38c032d4642","items":[],"itemsView":"notLoaded","status":"completed","error":null,"startedAt":1780962822,"completedAt":1780962826,"durationMs":4114}}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":8,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Context handoff (merge_back / fork_delta_summary):\nMerge-back context from first forked conversation.\n\nFork delta:\n- User introduced opaque marker merge-sibling-first-6V2J.\n- Assistant confirmed: first merge sibling stored\n\nUser message:\nRetain the first transferred marker for later. Respond with exactly: first merge delta stored","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"type":"dangerFullAccess"},"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":8,"result":{"turn":{"id":"019ea9a8-1956-7183-acaa-f43d53da7a22","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turn":{"id":"019ea9a8-1956-7183-acaa-f43d53da7a22","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":1780962826,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"7eabb7de-b7f9-4c1d-b82d-cfbbe71c4ea4","clientId":null,"content":[{"type":"text","text":"Context handoff (merge_back / fork_delta_summary):\nMerge-back context from first forked conversation.\n\nFork delta:\n- User introduced opaque marker merge-sibling-first-6V2J.\n- Assistant confirmed: first merge sibling stored\n\nUser message:\nRetain the first transferred marker for later. Respond with exactly: first merge delta stored","text_elements":[]}]},"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-1956-7183-acaa-f43d53da7a22","startedAtMs":1780962826590}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"7eabb7de-b7f9-4c1d-b82d-cfbbe71c4ea4","clientId":null,"content":[{"type":"text","text":"Context handoff (merge_back / fork_delta_summary):\nMerge-back context from first forked conversation.\n\nFork delta:\n- User introduced opaque marker merge-sibling-first-6V2J.\n- Assistant confirmed: first merge sibling stored\n\nUser message:\nRetain the first transferred marker for later. Respond with exactly: first merge delta stored","text_elements":[]}]},"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-1956-7183-acaa-f43d53da7a22","completedAtMs":1780962826590}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_06277fc0328731b4016a27560c205881988d5b078c30e6526b","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-1956-7183-acaa-f43d53da7a22","startedAtMs":1780962828113}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-1956-7183-acaa-f43d53da7a22","itemId":"msg_06277fc0328731b4016a27560c205881988d5b078c30e6526b","delta":"first"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-1956-7183-acaa-f43d53da7a22","itemId":"msg_06277fc0328731b4016a27560c205881988d5b078c30e6526b","delta":" merge"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-1956-7183-acaa-f43d53da7a22","itemId":"msg_06277fc0328731b4016a27560c205881988d5b078c30e6526b","delta":" delta"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-1956-7183-acaa-f43d53da7a22","itemId":"msg_06277fc0328731b4016a27560c205881988d5b078c30e6526b","delta":" stored"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_06277fc0328731b4016a27560c205881988d5b078c30e6526b","text":"first merge delta stored","phase":"final_answer","memoryCitation":null},"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-1956-7183-acaa-f43d53da7a22","completedAtMs":1780962828289}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-1956-7183-acaa-f43d53da7a22","tokenUsage":{"total":{"totalTokens":36981,"inputTokens":36965,"cachedInputTokens":36608,"outputTokens":16,"reasoningOutputTokens":0},"last":{"totalTokens":18531,"inputTokens":18523,"cachedInputTokens":18304,"outputTokens":8,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1780968999},"secondary":{"usedPercent":3,"windowDurationMins":10080,"resetsAt":1781296757},"credits":null,"individualLimit":null,"planType":"pro","rateLimitReachedType":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turn":{"id":"019ea9a8-1956-7183-acaa-f43d53da7a22","items":[],"itemsView":"notLoaded","status":"completed","error":null,"startedAt":1780962826,"completedAt":1780962828,"durationMs":1738}}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":9,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Context handoff (merge_back / fork_delta_summary):\nMerge-back context from second forked conversation.\n\nFork delta:\n- User introduced opaque marker merge-sibling-second-9X5B.\n- Assistant confirmed: second merge sibling stored\n\nUser message:\nRetain the second transferred marker for later. Respond with exactly: second merge delta stored","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"type":"dangerFullAccess"},"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":9,"result":{"turn":{"id":"019ea9a8-2025-7de2-bb4b-ecd86a568956","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turn":{"id":"019ea9a8-2025-7de2-bb4b-ecd86a568956","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":1780962828,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"fa82b56f-507e-488a-b784-899434c3d8cc","clientId":null,"content":[{"type":"text","text":"Context handoff (merge_back / fork_delta_summary):\nMerge-back context from second forked conversation.\n\nFork delta:\n- User introduced opaque marker merge-sibling-second-9X5B.\n- Assistant confirmed: second merge sibling stored\n\nUser message:\nRetain the second transferred marker for later. Respond with exactly: second merge delta stored","text_elements":[]}]},"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-2025-7de2-bb4b-ecd86a568956","startedAtMs":1780962828332}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"fa82b56f-507e-488a-b784-899434c3d8cc","clientId":null,"content":[{"type":"text","text":"Context handoff (merge_back / fork_delta_summary):\nMerge-back context from second forked conversation.\n\nFork delta:\n- User introduced opaque marker merge-sibling-second-9X5B.\n- Assistant confirmed: second merge sibling stored\n\nUser message:\nRetain the second transferred marker for later. Respond with exactly: second merge delta stored","text_elements":[]}]},"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-2025-7de2-bb4b-ecd86a568956","completedAtMs":1780962828332}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_06277fc0328731b4016a27560d83d48198b3495fcdb9df105b","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-2025-7de2-bb4b-ecd86a568956","startedAtMs":1780962829564}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-2025-7de2-bb4b-ecd86a568956","itemId":"msg_06277fc0328731b4016a27560d83d48198b3495fcdb9df105b","delta":"second"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-2025-7de2-bb4b-ecd86a568956","itemId":"msg_06277fc0328731b4016a27560d83d48198b3495fcdb9df105b","delta":" merge"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-2025-7de2-bb4b-ecd86a568956","itemId":"msg_06277fc0328731b4016a27560d83d48198b3495fcdb9df105b","delta":" delta"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-2025-7de2-bb4b-ecd86a568956","itemId":"msg_06277fc0328731b4016a27560d83d48198b3495fcdb9df105b","delta":" stored"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_06277fc0328731b4016a27560d83d48198b3495fcdb9df105b","text":"second merge delta stored","phase":"final_answer","memoryCitation":null},"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-2025-7de2-bb4b-ecd86a568956","completedAtMs":1780962829632}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-2025-7de2-bb4b-ecd86a568956","tokenUsage":{"total":{"totalTokens":55593,"inputTokens":55569,"cachedInputTokens":54912,"outputTokens":24,"reasoningOutputTokens":0},"last":{"totalTokens":18612,"inputTokens":18604,"cachedInputTokens":18304,"outputTokens":8,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1780968999},"secondary":{"usedPercent":3,"windowDurationMins":10080,"resetsAt":1781296757},"credits":null,"individualLimit":null,"planType":"pro","rateLimitReachedType":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turn":{"id":"019ea9a8-2025-7de2-bb4b-ecd86a568956","items":[],"itemsView":"notLoaded","status":"completed","error":null,"startedAt":1780962828,"completedAt":1780962829,"durationMs":1313}}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":10,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Return the source marker followed by both transferred fork markers in merge order, separated by single | characters. Respond with only the markers and separators.","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"type":"dangerFullAccess"},"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":10,"result":{"turn":{"id":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turn":{"id":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","items":[],"itemsView":"notLoaded","status":"inProgress","error":null,"startedAt":1780962829,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"f92dacf3-9750-47d3-937b-8af94a859b87","clientId":null,"content":[{"type":"text","text":"Return the source marker followed by both transferred fork markers in merge order, separated by single | characters. Respond with only the markers and separators.","text_elements":[]}]},"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","startedAtMs":1780962829651}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"f92dacf3-9750-47d3-937b-8af94a859b87","clientId":null,"content":[{"type":"text","text":"Return the source marker followed by both transferred fork markers in merge order, separated by single | characters. Respond with only the markers and separators.","text_elements":[]}]},"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","completedAtMs":1780962829651}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_06277fc0328731b4016a27560ecf108198af3cbd23416442ff","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","startedAtMs":1780962830796}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","itemId":"msg_06277fc0328731b4016a27560ecf108198af3cbd23416442ff","delta":"merge"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","itemId":"msg_06277fc0328731b4016a27560ecf108198af3cbd23416442ff","delta":"-s"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","itemId":"msg_06277fc0328731b4016a27560ecf108198af3cbd23416442ff","delta":"ibling"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","itemId":"msg_06277fc0328731b4016a27560ecf108198af3cbd23416442ff","delta":"-source"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","itemId":"msg_06277fc0328731b4016a27560ecf108198af3cbd23416442ff","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","itemId":"msg_06277fc0328731b4016a27560ecf108198af3cbd23416442ff","delta":"3"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","itemId":"msg_06277fc0328731b4016a27560ecf108198af3cbd23416442ff","delta":"C"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","itemId":"msg_06277fc0328731b4016a27560ecf108198af3cbd23416442ff","delta":"7"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","itemId":"msg_06277fc0328731b4016a27560ecf108198af3cbd23416442ff","delta":"K"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","itemId":"msg_06277fc0328731b4016a27560ecf108198af3cbd23416442ff","delta":"|"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","itemId":"msg_06277fc0328731b4016a27560ecf108198af3cbd23416442ff","delta":"merge"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","itemId":"msg_06277fc0328731b4016a27560ecf108198af3cbd23416442ff","delta":"-s"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","itemId":"msg_06277fc0328731b4016a27560ecf108198af3cbd23416442ff","delta":"ibling"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","itemId":"msg_06277fc0328731b4016a27560ecf108198af3cbd23416442ff","delta":"-first"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","itemId":"msg_06277fc0328731b4016a27560ecf108198af3cbd23416442ff","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","itemId":"msg_06277fc0328731b4016a27560ecf108198af3cbd23416442ff","delta":"6"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","itemId":"msg_06277fc0328731b4016a27560ecf108198af3cbd23416442ff","delta":"V"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","itemId":"msg_06277fc0328731b4016a27560ecf108198af3cbd23416442ff","delta":"2"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","itemId":"msg_06277fc0328731b4016a27560ecf108198af3cbd23416442ff","delta":"J"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","itemId":"msg_06277fc0328731b4016a27560ecf108198af3cbd23416442ff","delta":"|"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","itemId":"msg_06277fc0328731b4016a27560ecf108198af3cbd23416442ff","delta":"merge"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","itemId":"msg_06277fc0328731b4016a27560ecf108198af3cbd23416442ff","delta":"-s"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","itemId":"msg_06277fc0328731b4016a27560ecf108198af3cbd23416442ff","delta":"ibling"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","itemId":"msg_06277fc0328731b4016a27560ecf108198af3cbd23416442ff","delta":"-second"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","itemId":"msg_06277fc0328731b4016a27560ecf108198af3cbd23416442ff","delta":"-"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","itemId":"msg_06277fc0328731b4016a27560ecf108198af3cbd23416442ff","delta":"9"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","itemId":"msg_06277fc0328731b4016a27560ecf108198af3cbd23416442ff","delta":"X"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","itemId":"msg_06277fc0328731b4016a27560ecf108198af3cbd23416442ff","delta":"5"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","itemId":"msg_06277fc0328731b4016a27560ecf108198af3cbd23416442ff","delta":"B"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_06277fc0328731b4016a27560ecf108198af3cbd23416442ff","text":"merge-sibling-source-3C7K|merge-sibling-first-6V2J|merge-sibling-second-9X5B","phase":"final_answer","memoryCitation":null},"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","completedAtMs":1780962831144}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turnId":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","tokenUsage":{"total":{"totalTokens":74272,"inputTokens":74215,"cachedInputTokens":73216,"outputTokens":57,"reasoningOutputTokens":0},"last":{"totalTokens":18679,"inputTokens":18646,"cachedInputTokens":18304,"outputTokens":33,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1780968999},"secondary":{"usedPercent":3,"windowDurationMins":10080,"resetsAt":1781296757},"credits":null,"individualLimit":null,"planType":"pro","rateLimitReachedType":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019ea9a7-e28f-7c72-96e8-9ca581f225ce","turn":{"id":"019ea9a8-254b-7e53-af1e-1066f8bc37a4","items":[],"itemsView":"notLoaded","status":"completed","error":null,"startedAt":1780962829,"completedAt":1780962831,"durationMs":1502}}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/thread_rollback/claude_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/thread_rollback/claude_output.ts
new file mode 100644
index 000000000000..1100fec51088
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/thread_rollback/claude_output.ts
@@ -0,0 +1,69 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertBaseProjection,
+  assertRunOrdinals,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypeSequence,
+  assertUserMessagesInclude,
+  assertVisibleTurnItemTypeSequence,
+  assertVisibleUserMessagesExclude,
+  assertVisibleUserMessagesInclude,
+  projectionFor,
+  THREAD_ROLLBACK_AFTER_PROMPT,
+  THREAD_ROLLBACK_FIRST_PROMPT,
+  THREAD_ROLLBACK_SECOND_PROMPT,
+} from "../shared.ts";
+
+export function assertClaudeThreadRollbackOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({
+    result,
+    transcript,
+    runCount: 3,
+    runStatuses: ["completed", "rolled_back", "completed"],
+  });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertRunOrdinals(projection, [1, 2, 3]);
+  assertTurnItemTypeSequence(projection, [
+    "user_message",
+    "assistant_message",
+    "checkpoint",
+    "user_message",
+    "assistant_message",
+    "checkpoint",
+    "user_message",
+    "assistant_message",
+    "checkpoint",
+  ]);
+  assertVisibleTurnItemTypeSequence(projection, [
+    "user_message",
+    "assistant_message",
+    "checkpoint",
+    "user_message",
+    "assistant_message",
+    "checkpoint",
+  ]);
+  assertUserMessagesInclude(projection, [
+    THREAD_ROLLBACK_FIRST_PROMPT,
+    THREAD_ROLLBACK_SECOND_PROMPT,
+    THREAD_ROLLBACK_AFTER_PROMPT,
+  ]);
+  assertVisibleUserMessagesInclude(projection, [
+    THREAD_ROLLBACK_FIRST_PROMPT,
+    THREAD_ROLLBACK_AFTER_PROMPT,
+  ]);
+  assertVisibleUserMessagesExclude(projection, [THREAD_ROLLBACK_SECOND_PROMPT]);
+  assert.isAtLeast(projection.checkpoints.length, 2);
+  assert.isTrue(
+    projection.runs.some((run) => run.status === "rolled_back"),
+    "rollback must be visible in run state",
+  );
+  assert.equal(projection.providerThreads[0]?.nativeConversationHeadRef, null);
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/thread_rollback/claude_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/thread_rollback/claude_transcript.ndjson
new file mode 100644
index 000000000000..cbf7760f0961
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/thread_rollback/claude_transcript.ndjson
@@ -0,0 +1,24 @@
+{"type":"transcript_start","provider":"claudeAgent","protocol":"claude-agent-sdk.query","version":"0.2.111","scenario":"thread_rollback","metadata":{"prompts":["Respond with exactly: rollback fixture first turn complete","Respond with exactly: rollback fixture second turn complete","Repeat the conversation verbatim."],"model":"claude-sonnet-4-6","nativeSessionId":"f9415703-bf61-49e3-8155-1d3fed83f935","queryMode":"resume_at_cursor","tools":"claude_code","permissionMode":"bypassPermissions","generatedBy":"recordClaudeAgentSdkReplayTranscript","resumeSessionAt":"3831efb6-619c-4c16-a38a-bf788040ac42","sourceAssistantMessageUuids":["3831efb6-619c-4c16-a38a-bf788040ac42","d03f5cd6-5e8b-4cf5-998f-7d96a923ecf8"]}}
+{"type":"expect_outbound","label":"query.open:source","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"sessionId":"f9415703-bf61-49e3-8155-1d3fed83f935"}}}
+{"type":"expect_outbound","label":"prompt.offer:1","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Respond with exactly: rollback fixture first turn complete"},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"10af24d0-396e-4d26-a07b-d6c66704b322","hook_name":"SessionStart:startup","hook_event":"SessionStart","uuid":"45ae7f96-b6f0-49fa-933d-ea449ac377ea","session_id":"f9415703-bf61-49e3-8155-1d3fed83f935"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"10af24d0-396e-4d26-a07b-d6c66704b322","hook_name":"SessionStart:startup","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"b3e745a0-d47d-4bb8-b67f-5faf244eb50d","session_id":"f9415703-bf61-49e3-8155-1d3fed83f935"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.111","cwd":"/tmp/claude-replay-thread_rollback","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"218871ce-bb95-4526-ba59-0dcc71e47835","session_id":"f9415703-bf61-49e3-8155-1d3fed83f935"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01NUv7RH7XTuJnHd6WyVG1Vo","type":"message","role":"assistant","content":[{"type":"text","text":"rollback fixture first turn complete"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":11794,"cache_read_input_tokens":0,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":11794},"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"f9415703-bf61-49e3-8155-1d3fed83f935","uuid":"3831efb6-619c-4c16-a38a-bf788040ac42"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed"},"uuid":"db72cb9f-000f-454a-8b05-cc231a6434ed","session_id":"f9415703-bf61-49e3-8155-1d3fed83f935"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":1813,"duration_api_ms":1317,"num_turns":1,"result":"rollback fixture first turn complete","stop_reason":"end_turn","session_id":"f9415703-bf61-49e3-8155-1d3fed83f935","total_cost_usd":0.0443715,"usage":{"input_tokens":3,"cache_creation_input_tokens":11794,"cache_read_input_tokens":0,"output_tokens":9,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":11794,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[{"input_tokens":3,"output_tokens":9,"cache_read_input_tokens":0,"cache_creation_input_tokens":11794,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":11794},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":3,"outputTokens":9,"cacheReadInputTokens":0,"cacheCreationInputTokens":11794,"webSearchRequests":0,"costUSD":0.0443715,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"7b499f7a-fb88-462d-bdd0-aa4841528c96"}}
+{"type":"expect_outbound","label":"prompt.offer:2","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Respond with exactly: rollback fixture second turn complete"},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.111","cwd":"/tmp/claude-replay-thread_rollback","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"b398ca88-f2c0-4606-9480-d4a37be9fcdc","session_id":"f9415703-bf61-49e3-8155-1d3fed83f935"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01U9BNPSbhQkJZsmNc4VpdBn","type":"message","role":"assistant","content":[{"type":"text","text":"rollback fixture second turn complete"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":23,"cache_read_input_tokens":11794,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":23},"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"f9415703-bf61-49e3-8155-1d3fed83f935","uuid":"d03f5cd6-5e8b-4cf5-998f-7d96a923ecf8"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":1563,"duration_api_ms":2262,"num_turns":1,"result":"rollback fixture second turn complete","stop_reason":"end_turn","session_id":"f9415703-bf61-49e3-8155-1d3fed83f935","total_cost_usd":0.04813995,"usage":{"input_tokens":3,"cache_creation_input_tokens":23,"cache_read_input_tokens":11794,"output_tokens":9,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":23,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[{"input_tokens":3,"output_tokens":9,"cache_read_input_tokens":11794,"cache_creation_input_tokens":23,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":23},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":6,"outputTokens":18,"cacheReadInputTokens":11794,"cacheCreationInputTokens":11817,"webSearchRequests":0,"costUSD":0.04813995,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"badfd2cf-d9be-486f-a0ad-fdd84c9b644f"}}
+{"type":"runtime_exit","status":"success"}
+{"type":"expect_outbound","label":"query.open:resume_at_cursor","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"resumeSessionAt":"3831efb6-619c-4c16-a38a-bf788040ac42","resume":"f9415703-bf61-49e3-8155-1d3fed83f935"}}}
+{"type":"expect_outbound","label":"prompt.offer:3","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Repeat the conversation verbatim."},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"c9f667e7-ca12-49e9-a8ba-bdbca3abbb52","hook_name":"SessionStart:resume","hook_event":"SessionStart","uuid":"8ca5d046-22be-4a78-b62d-017a82cacde5","session_id":"364d2478-ab5e-4d54-8f1a-ac5985780b94"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"c9f667e7-ca12-49e9-a8ba-bdbca3abbb52","hook_name":"SessionStart:resume","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"6369a44f-6abb-4e6b-8302-603b2ae6f4af","session_id":"364d2478-ab5e-4d54-8f1a-ac5985780b94"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.111","cwd":"/tmp/claude-replay-thread_rollback","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"18ad1c2a-af69-41b0-b5c4-68368d89338e","session_id":"f9415703-bf61-49e3-8155-1d3fed83f935"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_018VXP9s6TV1dsMYKJDkM5cb","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"The user wants me to repeat the conversation verbatim. Let me recall the conversation so far.","signature":"EpoCClsIDRgCKkAWt3L1MZbqQnRJfaQpC/zTmnX+89ilokWcVeWkpDrrEY2oZntDTkRch9BHty3vZDGi5JqizC60fkS3UYDi9nvdMhFjbGF1ZGUtc29ubmV0LTQtNjgAEgy2iD+JrxDeNoidixsaDLnyeHyQiuJ87Mp2HSIwYxphRaf5TTSOq0kBF/cS2SYHvchyl7A857XzjZC6x1+n1WRVjeFu85/guUqGhkbpKm2zNZSjsFz9IVYeNWdsNuBbUftQ5RZuBipNrqaJfXtBuGl7NHeBArYZvFgcNZMScvsFrYjII7RWaEOAZYaiRnxSUzrZB+rEe0xnx0PJHKM3Vv5uVJl68/JXEyTfWV1hgKGa5hm6rUpoudwW7eujGAE="}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":20,"cache_read_input_tokens":11794,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":20},"output_tokens":6,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"f9415703-bf61-49e3-8155-1d3fed83f935","uuid":"2a455c39-eef8-45b9-83f5-11567ff0459b"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_018VXP9s6TV1dsMYKJDkM5cb","type":"message","role":"assistant","content":[{"type":"text","text":"Here is the conversation verbatim:\n\n---\n\n**User:** Respond with exactly: rollback fixture first turn complete\n\n**Assistant:** rollback fixture first turn complete\n\n---\n\n**User:** Repeat the conversation verbatim."}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":20,"cache_read_input_tokens":11794,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":20},"output_tokens":6,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"f9415703-bf61-49e3-8155-1d3fed83f935","uuid":"572fafb1-2351-4f3a-848d-7b4703496bc3"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed"},"uuid":"f3a34752-3bb6-42d7-a5d2-230917f30a7c","session_id":"f9415703-bf61-49e3-8155-1d3fed83f935"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":2368,"duration_api_ms":1731,"num_turns":1,"result":"Here is the conversation verbatim:\n\n---\n\n**User:** Respond with exactly: rollback fixture first turn complete\n\n**Assistant:** rollback fixture first turn complete\n\n---\n\n**User:** Repeat the conversation verbatim.","stop_reason":"end_turn","session_id":"f9415703-bf61-49e3-8155-1d3fed83f935","total_cost_usd":0.0049272000000000005,"usage":{"input_tokens":3,"cache_creation_input_tokens":20,"cache_read_input_tokens":11794,"output_tokens":87,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":20,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[{"input_tokens":3,"output_tokens":87,"cache_read_input_tokens":11794,"cache_creation_input_tokens":20,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":20},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":3,"outputTokens":87,"cacheReadInputTokens":11794,"cacheCreationInputTokens":20,"webSearchRequests":0,"costUSD":0.0049272000000000005,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"980fa6e9-fcc5-4f52-92c7-ff95c180a46a"}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/thread_rollback/codex_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/thread_rollback/codex_output.ts
new file mode 100644
index 000000000000..89c904cee9b2
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/thread_rollback/codex_output.ts
@@ -0,0 +1,68 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertBaseProjection,
+  assertRunOrdinals,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypeSequence,
+  assertVisibleTurnItemTypeSequence,
+  assertVisibleUserMessagesExclude,
+  assertVisibleUserMessagesInclude,
+  assertUserMessagesInclude,
+  projectionFor,
+  THREAD_ROLLBACK_AFTER_PROMPT,
+  THREAD_ROLLBACK_FIRST_PROMPT,
+  THREAD_ROLLBACK_SECOND_PROMPT,
+} from "../shared.ts";
+
+export function assertThreadRollbackOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({
+    result,
+    transcript,
+    runCount: 3,
+    runStatuses: ["completed", "rolled_back", "completed"],
+  });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertRunOrdinals(projection, [1, 2, 3]);
+  assertTurnItemTypeSequence(projection, [
+    "user_message",
+    "assistant_message",
+    "checkpoint",
+    "user_message",
+    "assistant_message",
+    "checkpoint",
+    "user_message",
+    "assistant_message",
+    "checkpoint",
+  ]);
+  assertVisibleTurnItemTypeSequence(projection, [
+    "user_message",
+    "assistant_message",
+    "checkpoint",
+    "user_message",
+    "assistant_message",
+    "checkpoint",
+  ]);
+  assertUserMessagesInclude(projection, [
+    THREAD_ROLLBACK_FIRST_PROMPT,
+    THREAD_ROLLBACK_SECOND_PROMPT,
+    THREAD_ROLLBACK_AFTER_PROMPT,
+  ]);
+  assertVisibleUserMessagesInclude(projection, [
+    THREAD_ROLLBACK_FIRST_PROMPT,
+    THREAD_ROLLBACK_AFTER_PROMPT,
+  ]);
+  assertVisibleUserMessagesExclude(projection, [THREAD_ROLLBACK_SECOND_PROMPT]);
+  assert.isAtLeast(projection.checkpoints.length, 2);
+  assert.isTrue(
+    projection.runs.some((run) => run.status === "rolled_back"),
+    "rollback must be visible in run state",
+  );
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/thread_rollback/codex_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/thread_rollback/codex_transcript.ndjson
new file mode 100644
index 000000000000..5c2b45abba2c
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/thread_rollback/codex_transcript.ndjson
@@ -0,0 +1,100 @@
+{"type":"transcript_start","provider":"codex","protocol":"codex.app-server","version":"0.120.0","scenario":"thread_rollback","metadata":{"source":"codex-app-server-probe","fileName":"thread_rollback.ndjson","description":"One thread completes two turns, rolls back the most recent turn, then starts another turn."}}
+{"type":"expect_outbound","label":"initialize","frame":{"id":1,"method":"initialize","params":{"capabilities":{"experimentalApi":true},"clientInfo":{"name":"t3code_desktop","title":"T3 Code Desktop","version":"0.1.0"}}}}
+{"type":"emit_inbound","label":"initialize","frame":{"id":1,"result":{"userAgent":"t3code_desktop/0.120.0 (Mac OS 26.4.1; arm64) dumb (t3code_desktop; 0.1.0)","codexHome":"/Users/julius/.codex","platformFamily":"unix","platformOs":"macos"}}}
+{"type":"expect_outbound","label":"initialized","frame":{"method":"initialized"}}
+{"type":"expect_outbound","label":"thread/start","frame":{"id":2,"method":"thread/start","params":{}}}
+{"type":"emit_inbound","label":"thread/start","frame":{"id":2,"result":{"thread":{"id":"019daded-23e0-7100-87d7-12089c71339a","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1776739492,"updatedAt":1776739492,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/04/20/rollout-2026-04-20T19-44-52-019daded-23e0-7100-87d7-12089c71339a.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","cliVersion":"0.120.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]},"model":"gpt-5.4","modelProvider":"openai","serviceTier":"fast","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","approvalPolicy":"on-request","approvalsReviewer":"user","sandbox":{"type":"workspaceWrite","writableRoots":["/Users/julius/.codex/memories"],"readOnlyAccess":{"type":"fullAccess"},"networkAccess":false,"excludeTmpdirEnvVar":false,"excludeSlashTmp":false},"reasoningEffort":"xhigh"}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":3,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Respond with exactly: rollback fixture first turn complete","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"type":"dangerFullAccess"},"threadId":"019daded-23e0-7100-87d7-12089c71339a","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"thread/started","frame":{"method":"thread/started","params":{"thread":{"id":"019daded-23e0-7100-87d7-12089c71339a","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1776739492,"updatedAt":1776739492,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/04/20/rollout-2026-04-20T19-44-52-019daded-23e0-7100-87d7-12089c71339a.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","cliVersion":"0.120.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]}}}}
+{"type":"emit_inbound","label":"deprecationNotice","frame":{"method":"deprecationNotice","params":{"summary":"`[features].collab` is deprecated. Use `[features].multi_agent` instead.","details":"Enable it with `--enable multi_agent` or `[features].multi_agent` in config.toml. See https://developers.openai.com/codex/config-basic#feature-flags for details."}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":3,"result":{"turn":{"id":"019daded-23e9-7100-8f16-28223024be18","items":[],"status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turn":{"id":"019daded-23e9-7100-8f16-28223024be18","items":[],"status":"inProgress","error":null,"startedAt":1776739492,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"99075ce0-b5fd-4d44-b765-874c3d5e98d7","content":[{"type":"text","text":"Respond with exactly: rollback fixture first turn complete","text_elements":[]}]},"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-23e9-7100-8f16-28223024be18"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"99075ce0-b5fd-4d44-b765-874c3d5e98d7","content":[{"type":"text","text":"Respond with exactly: rollback fixture first turn complete","text_elements":[]}]},"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-23e9-7100-8f16-28223024be18"}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"reasoning","id":"rs_06f406cdc76c42010169e6e4ac9c3c819a8f45370ee32a9e95","summary":[],"content":[]},"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-23e9-7100-8f16-28223024be18"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"reasoning","id":"rs_06f406cdc76c42010169e6e4ac9c3c819a8f45370ee32a9e95","summary":[],"content":[]},"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-23e9-7100-8f16-28223024be18"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_06f406cdc76c42010169e6e4ace378819a8bac065db540df6c","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-23e9-7100-8f16-28223024be18"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-23e9-7100-8f16-28223024be18","itemId":"msg_06f406cdc76c42010169e6e4ace378819a8bac065db540df6c","delta":"rollback"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-23e9-7100-8f16-28223024be18","itemId":"msg_06f406cdc76c42010169e6e4ace378819a8bac065db540df6c","delta":" fixture"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-23e9-7100-8f16-28223024be18","itemId":"msg_06f406cdc76c42010169e6e4ace378819a8bac065db540df6c","delta":" first"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-23e9-7100-8f16-28223024be18","itemId":"msg_06f406cdc76c42010169e6e4ace378819a8bac065db540df6c","delta":" turn"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-23e9-7100-8f16-28223024be18","itemId":"msg_06f406cdc76c42010169e6e4ace378819a8bac065db540df6c","delta":" complete"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_06f406cdc76c42010169e6e4ace378819a8bac065db540df6c","text":"rollback fixture first turn complete","phase":"final_answer","memoryCitation":null},"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-23e9-7100-8f16-28223024be18"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-23e9-7100-8f16-28223024be18","tokenUsage":{"total":{"totalTokens":28247,"inputTokens":28223,"cachedInputTokens":28032,"outputTokens":24,"reasoningOutputTokens":13},"last":{"totalTokens":28247,"inputTokens":28223,"cachedInputTokens":28032,"outputTokens":24,"reasoningOutputTokens":13},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turn":{"id":"019daded-23e9-7100-8f16-28223024be18","items":[],"status":"completed","error":null,"startedAt":1776739492,"completedAt":1776739501,"durationMs":8544}}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":4,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Respond with exactly: rollback fixture second turn complete","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"type":"dangerFullAccess"},"threadId":"019daded-23e0-7100-87d7-12089c71339a","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":4,"result":{"turn":{"id":"019daded-454a-70e2-acce-09a54f6192d0","items":[],"status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turn":{"id":"019daded-454a-70e2-acce-09a54f6192d0","items":[],"status":"inProgress","error":null,"startedAt":1776739501,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"9a8286af-6e78-4b7b-9122-1b477229a4e8","content":[{"type":"text","text":"Respond with exactly: rollback fixture second turn complete","text_elements":[]}]},"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-454a-70e2-acce-09a54f6192d0"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"9a8286af-6e78-4b7b-9122-1b477229a4e8","content":[{"type":"text","text":"Respond with exactly: rollback fixture second turn complete","text_elements":[]}]},"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-454a-70e2-acce-09a54f6192d0"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-454a-70e2-acce-09a54f6192d0","tokenUsage":{"total":{"totalTokens":28247,"inputTokens":28223,"cachedInputTokens":28032,"outputTokens":24,"reasoningOutputTokens":13},"last":{"totalTokens":28247,"inputTokens":28223,"cachedInputTokens":28032,"outputTokens":24,"reasoningOutputTokens":13},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_06f406cdc76c42010169e6e4b03dbc819abd1ab64b725345b6","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-454a-70e2-acce-09a54f6192d0"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-454a-70e2-acce-09a54f6192d0","itemId":"msg_06f406cdc76c42010169e6e4b03dbc819abd1ab64b725345b6","delta":"rollback"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-454a-70e2-acce-09a54f6192d0","itemId":"msg_06f406cdc76c42010169e6e4b03dbc819abd1ab64b725345b6","delta":" fixture"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-454a-70e2-acce-09a54f6192d0","itemId":"msg_06f406cdc76c42010169e6e4b03dbc819abd1ab64b725345b6","delta":" second"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-454a-70e2-acce-09a54f6192d0","itemId":"msg_06f406cdc76c42010169e6e4b03dbc819abd1ab64b725345b6","delta":" turn"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-454a-70e2-acce-09a54f6192d0","itemId":"msg_06f406cdc76c42010169e6e4b03dbc819abd1ab64b725345b6","delta":" complete"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_06f406cdc76c42010169e6e4b03dbc819abd1ab64b725345b6","text":"rollback fixture second turn complete","phase":"final_answer","memoryCitation":null},"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-454a-70e2-acce-09a54f6192d0"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-454a-70e2-acce-09a54f6192d0","tokenUsage":{"total":{"totalTokens":56503,"inputTokens":56470,"cachedInputTokens":56064,"outputTokens":33,"reasoningOutputTokens":13},"last":{"totalTokens":28256,"inputTokens":28247,"cachedInputTokens":28032,"outputTokens":9,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turn":{"id":"019daded-454a-70e2-acce-09a54f6192d0","items":[],"status":"completed","error":null,"startedAt":1776739501,"completedAt":1776739504,"durationMs":3091}}}}
+{"type":"expect_outbound","label":"thread/rollback","frame":{"id":5,"method":"thread/rollback","params":{"numTurns":1,"threadId":"019daded-23e0-7100-87d7-12089c71339a"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-515f-7642-b0db-bd62c3f7a473","tokenUsage":{"total":{"totalTokens":56503,"inputTokens":56470,"cachedInputTokens":56064,"outputTokens":33,"reasoningOutputTokens":13},"last":{"totalTokens":12317,"inputTokens":0,"cachedInputTokens":0,"outputTokens":0,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"thread/rollback","frame":{"id":5,"result":{"thread":{"id":"019daded-23e0-7100-87d7-12089c71339a","forkedFromId":null,"preview":"Respond with exactly: rollback fixture first turn complete","ephemeral":false,"modelProvider":"openai","createdAt":1776739492,"updatedAt":1776739504,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/04/20/rollout-2026-04-20T19-44-52-019daded-23e0-7100-87d7-12089c71339a.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","cliVersion":"0.120.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":{"sha":"7eefb2eb1d98f6b814c9fd7f43652727059c3326","branch":"t3code/codex-turn-mapping","originUrl":"git@github.com:pingdotgg/t3code.git"},"name":null,"turns":[{"id":"019daded-23e9-7100-8f16-28223024be18","items":[{"type":"userMessage","id":"item-1","content":[{"type":"text","text":"Respond with exactly: rollback fixture first turn complete","text_elements":[]}]},{"type":"agentMessage","id":"item-2","text":"rollback fixture first turn complete","phase":"final_answer","memoryCitation":null}],"status":"completed","error":null,"startedAt":1776739492,"completedAt":1776739501,"durationMs":8544}]}}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":6,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Repeat the conversation verbatim.","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"type":"dangerFullAccess"},"threadId":"019daded-23e0-7100-87d7-12089c71339a","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":6,"result":{"turn":{"id":"019daded-5165-7f73-a6bc-3cf4386b542c","items":[],"status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turn":{"id":"019daded-5165-7f73-a6bc-3cf4386b542c","items":[],"status":"inProgress","error":null,"startedAt":1776739504,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"18c178ce-88cd-436b-8a5b-11f9e081167d","content":[{"type":"text","text":"Repeat the conversation verbatim.","text_elements":[]}]},"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"18c178ce-88cd-436b-8a5b-11f9e081167d","content":[{"type":"text","text":"Repeat the conversation verbatim.","text_elements":[]}]},"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c","tokenUsage":{"total":{"totalTokens":56503,"inputTokens":56470,"cachedInputTokens":56064,"outputTokens":33,"reasoningOutputTokens":13},"last":{"totalTokens":12317,"inputTokens":0,"cachedInputTokens":0,"outputTokens":0,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"reasoning","id":"rs_0aad8fe64aad9e920169e6e4b1c9bc819896d64445e9585404","summary":[],"content":[]},"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"reasoning","id":"rs_0aad8fe64aad9e920169e6e4b1c9bc819896d64445e9585404","summary":[],"content":[]},"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_0aad8fe64aad9e920169e6e4b7d6b08198b4e2c09b80bbed9b","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c","itemId":"msg_0aad8fe64aad9e920169e6e4b7d6b08198b4e2c09b80bbed9b","delta":"User"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c","itemId":"msg_0aad8fe64aad9e920169e6e4b7d6b08198b4e2c09b80bbed9b","delta":":\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c","itemId":"msg_0aad8fe64aad9e920169e6e4b7d6b08198b4e2c09b80bbed9b","delta":"Respond"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c","itemId":"msg_0aad8fe64aad9e920169e6e4b7d6b08198b4e2c09b80bbed9b","delta":" with"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c","itemId":"msg_0aad8fe64aad9e920169e6e4b7d6b08198b4e2c09b80bbed9b","delta":" exactly"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c","itemId":"msg_0aad8fe64aad9e920169e6e4b7d6b08198b4e2c09b80bbed9b","delta":":"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c","itemId":"msg_0aad8fe64aad9e920169e6e4b7d6b08198b4e2c09b80bbed9b","delta":" rollback"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c","itemId":"msg_0aad8fe64aad9e920169e6e4b7d6b08198b4e2c09b80bbed9b","delta":" fixture"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c","itemId":"msg_0aad8fe64aad9e920169e6e4b7d6b08198b4e2c09b80bbed9b","delta":" first"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c","itemId":"msg_0aad8fe64aad9e920169e6e4b7d6b08198b4e2c09b80bbed9b","delta":" turn"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c","itemId":"msg_0aad8fe64aad9e920169e6e4b7d6b08198b4e2c09b80bbed9b","delta":" complete"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c","itemId":"msg_0aad8fe64aad9e920169e6e4b7d6b08198b4e2c09b80bbed9b","delta":"\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c","itemId":"msg_0aad8fe64aad9e920169e6e4b7d6b08198b4e2c09b80bbed9b","delta":"Assistant"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c","itemId":"msg_0aad8fe64aad9e920169e6e4b7d6b08198b4e2c09b80bbed9b","delta":":\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c","itemId":"msg_0aad8fe64aad9e920169e6e4b7d6b08198b4e2c09b80bbed9b","delta":"rollback"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c","itemId":"msg_0aad8fe64aad9e920169e6e4b7d6b08198b4e2c09b80bbed9b","delta":" fixture"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c","itemId":"msg_0aad8fe64aad9e920169e6e4b7d6b08198b4e2c09b80bbed9b","delta":" first"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c","itemId":"msg_0aad8fe64aad9e920169e6e4b7d6b08198b4e2c09b80bbed9b","delta":" turn"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c","itemId":"msg_0aad8fe64aad9e920169e6e4b7d6b08198b4e2c09b80bbed9b","delta":" complete"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c","itemId":"msg_0aad8fe64aad9e920169e6e4b7d6b08198b4e2c09b80bbed9b","delta":"\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c","itemId":"msg_0aad8fe64aad9e920169e6e4b7d6b08198b4e2c09b80bbed9b","delta":"User"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c","itemId":"msg_0aad8fe64aad9e920169e6e4b7d6b08198b4e2c09b80bbed9b","delta":":\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c","itemId":"msg_0aad8fe64aad9e920169e6e4b7d6b08198b4e2c09b80bbed9b","delta":"Repeat"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c","itemId":"msg_0aad8fe64aad9e920169e6e4b7d6b08198b4e2c09b80bbed9b","delta":" the"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c","itemId":"msg_0aad8fe64aad9e920169e6e4b7d6b08198b4e2c09b80bbed9b","delta":" conversation"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c","itemId":"msg_0aad8fe64aad9e920169e6e4b7d6b08198b4e2c09b80bbed9b","delta":" verb"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c","itemId":"msg_0aad8fe64aad9e920169e6e4b7d6b08198b4e2c09b80bbed9b","delta":"atim"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c","itemId":"msg_0aad8fe64aad9e920169e6e4b7d6b08198b4e2c09b80bbed9b","delta":"."}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_0aad8fe64aad9e920169e6e4b7d6b08198b4e2c09b80bbed9b","text":"User:\nRespond with exactly: rollback fixture first turn complete\n\nAssistant:\nrollback fixture first turn complete\n\nUser:\nRepeat the conversation verbatim.","phase":"final_answer","memoryCitation":null},"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turnId":"019daded-5165-7f73-a6bc-3cf4386b542c","tokenUsage":{"total":{"totalTokens":85297,"inputTokens":84714,"cachedInputTokens":84096,"outputTokens":583,"reasoningOutputTokens":529},"last":{"totalTokens":28794,"inputTokens":28244,"cachedInputTokens":28032,"outputTokens":550,"reasoningOutputTokens":516},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019daded-23e0-7100-87d7-12089c71339a","turn":{"id":"019daded-5165-7f73-a6bc-3cf4386b542c","items":[],"status":"completed","error":null,"startedAt":1776739504,"completedAt":1776739512,"durationMs":7806}}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/thread_rollback/input.ts b/apps/server/src/orchestration-v2/testkit/fixtures/thread_rollback/input.ts
new file mode 100644
index 000000000000..47371f6be766
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/thread_rollback/input.ts
@@ -0,0 +1,21 @@
+import {
+  THREAD_ROLLBACK_AFTER_PROMPT,
+  THREAD_ROLLBACK_FIRST_PROMPT,
+  THREAD_ROLLBACK_SECOND_PROMPT,
+  type OrchestratorFixtureInput,
+} from "../shared.ts";
+
+export function threadRollbackInput(): OrchestratorFixtureInput {
+  return {
+    steps: [
+      { type: "message", text: THREAD_ROLLBACK_FIRST_PROMPT },
+      { type: "message", text: THREAD_ROLLBACK_SECOND_PROMPT },
+      {
+        type: "rollback",
+        checkpointScopeSuffix: "root",
+        checkpointSuffix: "1",
+      },
+      { type: "message", text: THREAD_ROLLBACK_AFTER_PROMPT },
+    ],
+  };
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/todo_list/codex_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/todo_list/codex_output.ts
new file mode 100644
index 000000000000..3b1ff8379f7e
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/todo_list/codex_output.ts
@@ -0,0 +1,39 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertAssistantTextIncludes,
+  assertBaseProjection,
+  assertExecutionNodeKinds,
+  assertRunOrdinals,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessagesInclude,
+  assertVisibleTurnItemsMirrorLocalTurnItems,
+  projectionFor,
+  TODO_LIST_PROMPT,
+} from "../shared.ts";
+
+export function assertTodoListOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({ result, transcript, runCount: 1, runStatuses: ["completed"] });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertVisibleTurnItemsMirrorLocalTurnItems(projection);
+  assertRunOrdinals(projection, [1]);
+  assertExecutionNodeKinds(projection, ["root_turn", "todo_list", "tool_call"]);
+  assertTurnItemTypes(projection, ["user_message", "todo_list", "command_execution"]);
+  assertUserMessagesInclude(projection, [TODO_LIST_PROMPT]);
+  assertAssistantTextIncludes(projection, "todo list fixture complete");
+
+  const todoLists = projection.plans.filter((plan) => plan.kind === "todo_list");
+  assert.isAtLeast(todoLists.length, 1);
+  assert.deepEqual(
+    todoLists.at(-1)?.steps.map((step) => step.status),
+    ["completed", "completed", "completed"],
+  );
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/todo_list/codex_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/todo_list/codex_transcript.ndjson
new file mode 100644
index 000000000000..21f3d9b935a8
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/todo_list/codex_transcript.ndjson
@@ -0,0 +1,105 @@
+{"type":"transcript_start","provider":"codex","protocol":"codex.app-server","version":"0.120.0","scenario":"todo_list","metadata":{"source":"codex-app-server-probe","fileName":"todo_list.ndjson","description":"One turn that asks Codex to emit progress through update_plan."}}
+{"type":"expect_outbound","label":"initialize","frame":{"id":1,"method":"initialize","params":{"capabilities":{"experimentalApi":true},"clientInfo":{"name":"t3code_desktop","title":"T3 Code Desktop","version":"0.1.0"}}}}
+{"type":"emit_inbound","label":"initialize","frame":{"id":1,"result":{"userAgent":"t3code_desktop/0.120.0 (Mac OS 26.4.1; arm64) dumb (t3code_desktop; 0.1.0)","codexHome":"/Users/julius/.codex","platformFamily":"unix","platformOs":"macos"}}}
+{"type":"expect_outbound","label":"initialized","frame":{"method":"initialized"}}
+{"type":"expect_outbound","label":"thread/start","frame":{"id":2,"method":"thread/start","params":{}}}
+{"type":"emit_inbound","label":"thread/start","frame":{"id":2,"result":{"thread":{"id":"019db229-ac7a-7923-ab72-67bfefd79a8b","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1776810568,"updatedAt":1776810568,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/04/21/rollout-2026-04-21T15-29-28-019db229-ac7a-7923-ab72-67bfefd79a8b.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","cliVersion":"0.120.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]},"model":"gpt-5.3-codex","modelProvider":"openai","serviceTier":"fast","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","approvalPolicy":"on-request","approvalsReviewer":"user","sandbox":{"type":"workspaceWrite","writableRoots":["/Users/julius/.codex/memories"],"readOnlyAccess":{"type":"fullAccess"},"networkAccess":false,"excludeTmpdirEnvVar":false,"excludeSlashTmp":false},"reasoningEffort":"xhigh"}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":3,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Use the update_plan tool to track exactly three steps: inspect package.json, inspect tsconfig.json, report completion. Then read package.json and tsconfig.json, and answer exactly: todo list fixture complete","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"networkAccess":false,"type":"readOnly"},"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"thread/started","frame":{"method":"thread/started","params":{"thread":{"id":"019db229-ac7a-7923-ab72-67bfefd79a8b","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1776810568,"updatedAt":1776810568,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/04/21/rollout-2026-04-21T15-29-28-019db229-ac7a-7923-ab72-67bfefd79a8b.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","cliVersion":"0.120.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]}}}}
+{"type":"emit_inbound","label":"deprecationNotice","frame":{"method":"deprecationNotice","params":{"summary":"`[features].collab` is deprecated. Use `[features].multi_agent` instead.","details":"Enable it with `--enable multi_agent` or `[features].multi_agent` in config.toml. See https://developers.openai.com/codex/config-basic#feature-flags for details."}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":3,"result":{"turn":{"id":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","items":[],"status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turn":{"id":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","items":[],"status":"inProgress","error":null,"startedAt":1776810568,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"a37f5d89-8a7a-4799-8398-2d6c409acb98","content":[{"type":"text","text":"Use the update_plan tool to track exactly three steps: inspect package.json, inspect tsconfig.json, report completion. Then read package.json and tsconfig.json, and answer exactly: todo list fixture complete","text_elements":[]}]},"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"a37f5d89-8a7a-4799-8398-2d6c409acb98","content":[{"type":"text","text":"Use the update_plan tool to track exactly three steps: inspect package.json, inspect tsconfig.json, report completion. Then read package.json and tsconfig.json, and answer exactly: todo list fixture complete","text_elements":[]}]},"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0"}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":1,"windowDurationMins":300,"resetsAt":1776821038},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777407838},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"reasoning","id":"rs_075f3159e45307370169e7fa4dd1448198bca55c29410eafb7","summary":[],"content":[]},"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"reasoning","id":"rs_075f3159e45307370169e7fa4dd1448198bca55c29410eafb7","summary":[],"content":[]},"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_075f3159e45307370169e7fa5f305c81989b4dcab9d3036440","text":"","phase":"commentary","memoryCitation":null},"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa5f305c81989b4dcab9d3036440","delta":"Tracking"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa5f305c81989b4dcab9d3036440","delta":" the"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa5f305c81989b4dcab9d3036440","delta":" three"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa5f305c81989b4dcab9d3036440","delta":" requested"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa5f305c81989b4dcab9d3036440","delta":" plan"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa5f305c81989b4dcab9d3036440","delta":" steps"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa5f305c81989b4dcab9d3036440","delta":" first"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa5f305c81989b4dcab9d3036440","delta":","}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa5f305c81989b4dcab9d3036440","delta":" then"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa5f305c81989b4dcab9d3036440","delta":" I"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa5f305c81989b4dcab9d3036440","delta":"’ll"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa5f305c81989b4dcab9d3036440","delta":" read"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa5f305c81989b4dcab9d3036440","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa5f305c81989b4dcab9d3036440","delta":"package"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa5f305c81989b4dcab9d3036440","delta":".json"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa5f305c81989b4dcab9d3036440","delta":"`"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa5f305c81989b4dcab9d3036440","delta":" and"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa5f305c81989b4dcab9d3036440","delta":" `"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa5f305c81989b4dcab9d3036440","delta":"ts"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa5f305c81989b4dcab9d3036440","delta":"config"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa5f305c81989b4dcab9d3036440","delta":".json"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa5f305c81989b4dcab9d3036440","delta":"`"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa5f305c81989b4dcab9d3036440","delta":" and"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa5f305c81989b4dcab9d3036440","delta":" finish"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa5f305c81989b4dcab9d3036440","delta":" with"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa5f305c81989b4dcab9d3036440","delta":" the"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa5f305c81989b4dcab9d3036440","delta":" exact"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa5f305c81989b4dcab9d3036440","delta":" response"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa5f305c81989b4dcab9d3036440","delta":" text"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa5f305c81989b4dcab9d3036440","delta":"."}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_075f3159e45307370169e7fa5f305c81989b4dcab9d3036440","text":"Tracking the three requested plan steps first, then I’ll read `package.json` and `tsconfig.json` and finish with the exact response text.","phase":"commentary","memoryCitation":null},"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0"}}}
+{"type":"emit_inbound","label":"turn/plan/updated","frame":{"method":"turn/plan/updated","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","explanation":null,"plan":[{"step":"inspect package.json","status":"inProgress"},{"step":"inspect tsconfig.json","status":"pending"},{"step":"report completion","status":"pending"}]}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","tokenUsage":{"total":{"totalTokens":25386,"inputTokens":24336,"cachedInputTokens":3456,"outputTokens":1050,"reasoningOutputTokens":962},"last":{"totalTokens":25386,"inputTokens":24336,"cachedInputTokens":3456,"outputTokens":1050,"reasoningOutputTokens":962},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":1,"windowDurationMins":300,"resetsAt":1776821038},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777407838},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"reasoning","id":"rs_075f3159e45307370169e7fa61751c8198bcb1d63a6e31608c","summary":[],"content":[]},"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"reasoning","id":"rs_075f3159e45307370169e7fa61751c8198bcb1d63a6e31608c","summary":[],"content":[]},"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_075f3159e45307370169e7fa6276f881988716e668d1364f8b","text":"","phase":"commentary","memoryCitation":null},"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa6276f881988716e668d1364f8b","delta":"Reading"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa6276f881988716e668d1364f8b","delta":" both"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa6276f881988716e668d1364f8b","delta":" files"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa6276f881988716e668d1364f8b","delta":" now"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa6276f881988716e668d1364f8b","delta":" to"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa6276f881988716e668d1364f8b","delta":" complete"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa6276f881988716e668d1364f8b","delta":" the"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa6276f881988716e668d1364f8b","delta":" inspect"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa6276f881988716e668d1364f8b","delta":" steps"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa6276f881988716e668d1364f8b","delta":","}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa6276f881988716e668d1364f8b","delta":" then"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa6276f881988716e668d1364f8b","delta":" I"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa6276f881988716e668d1364f8b","delta":"’ll"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa6276f881988716e668d1364f8b","delta":" mark"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa6276f881988716e668d1364f8b","delta":" the"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa6276f881988716e668d1364f8b","delta":" plan"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa6276f881988716e668d1364f8b","delta":" complete"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa6276f881988716e668d1364f8b","delta":"."}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_075f3159e45307370169e7fa6276f881988716e668d1364f8b","text":"Reading both files now to complete the inspect steps, then I’ll mark the plan complete.","phase":"commentary","memoryCitation":null},"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","tokenUsage":{"total":{"totalTokens":50994,"inputTokens":49735,"cachedInputTokens":28416,"outputTokens":1259,"reasoningOutputTokens":1015},"last":{"totalTokens":25608,"inputTokens":25399,"cachedInputTokens":24960,"outputTokens":209,"reasoningOutputTokens":53},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":1,"windowDurationMins":300,"resetsAt":1776821038},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777407838},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"commandExecution","id":"call_ZCMqKDv3xX8eeFDlEsjdf9cz","command":"/bin/zsh -lc 'cat package.json'","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","processId":"57218","source":"unifiedExecStartup","status":"inProgress","commandActions":[{"type":"read","command":"cat package.json","name":"package.json","path":"package.json"}],"aggregatedOutput":null,"exitCode":null,"durationMs":null},"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"commandExecution","id":"call_ZCMqKDv3xX8eeFDlEsjdf9cz","command":"/bin/zsh -lc 'cat package.json'","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","processId":"57218","source":"unifiedExecStartup","status":"completed","commandActions":[{"type":"read","command":"cat package.json","name":"package.json","path":"package.json"}],"aggregatedOutput":"{\n  \"name\": \"effect-codex-app-server\",\n  \"private\": true,\n  \"type\": \"module\",\n  \"exports\": {\n    \"./client\": {\n      \"types\": \"./src/client.ts\",\n      \"import\": \"./src/client.ts\"\n    },\n    \"./schema\": {\n      \"types\": \"./src/schema.ts\",\n      \"import\": \"./src/schema.ts\"\n    },\n    \"./rpc\": {\n      \"types\": \"./src/rpc.ts\",\n      \"import\": \"./src/rpc.ts\"\n    },\n    \"./protocol\": {\n      \"types\": \"./src/protocol.ts\",\n      \"import\": \"./src/protocol.ts\"\n    },\n    \"./replay\": {\n      \"types\": \"./src/replay.ts\",\n      \"import\": \"./src/replay.ts\"\n    },\n    \"./errors\": {\n      \"types\": \"./src/errors.ts\",\n      \"import\": \"./src/errors.ts\"\n    }\n  },\n  \"scripts\": {\n    \"dev\": \"tsdown src/client.ts src/rpc.ts src/protocol.ts src/schema.ts --format esm,cjs --dts --watch --clean\",\n    \"build\": \"tsdown src/client.ts src/rpc.ts src/protocol.ts src/schema.ts --format esm,cjs --dts --clean\",\n    \"prepare\": \"effect-language-service patch\",\n    \"typecheck\": \"tsc --noEmit\",\n    \"test\": \"vitest run\",\n    \"generate\": \"bun run scripts/generate.ts\",\n    \"probe\": \"bun run test/examples/codex-app-server-probe.ts\"\n  },\n  \"dependencies\": {\n    \"effect\": \"catalog:\"\n  },\n  \"devDependencies\": {\n    \"@effect/language-service\": \"catalog:\",\n    \"@effect/openapi-generator\": \"catalog:\",\n    \"@effect/platform-node\": \"catalog:\",\n    \"@effect/vitest\": \"catalog:\",\n    \"tsdown\": \"catalog:\",\n    \"typescript\": \"catalog:\",\n    \"vitest\": \"catalog:\"\n  }\n}\n","exitCode":0,"durationMs":0},"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"commandExecution","id":"call_ZXkLHFX09x8LZ8WEfEq0V85a","command":"/bin/zsh -lc 'cat tsconfig.json'","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","processId":"71881","source":"unifiedExecStartup","status":"inProgress","commandActions":[{"type":"read","command":"cat tsconfig.json","name":"tsconfig.json","path":"tsconfig.json"}],"aggregatedOutput":null,"exitCode":null,"durationMs":null},"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"commandExecution","id":"call_ZXkLHFX09x8LZ8WEfEq0V85a","command":"/bin/zsh -lc 'cat tsconfig.json'","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","processId":"71881","source":"unifiedExecStartup","status":"completed","commandActions":[{"type":"read","command":"cat tsconfig.json","name":"tsconfig.json","path":"tsconfig.json"}],"aggregatedOutput":"{\n  \"extends\": \"../../tsconfig.base.json\",\n  \"compilerOptions\": {\n    \"plugins\": [\n      {\n        \"name\": \"@effect/language-service\",\n        \"namespaceImportPackages\": [\"@effect/platform-node\"],\n        \"diagnosticSeverity\": {\n          \"importFromBarrel\": \"error\",\n          \"anyUnknownInErrorContext\": \"warning\",\n          \"instanceOfSchema\": \"warning\",\n          \"deterministicKeys\": \"warning\"\n        }\n      }\n    ]\n  },\n  \"include\": [\"src\", \"scripts\", \"test\"]\n}\n","exitCode":0,"durationMs":0},"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"reasoning","id":"rs_075f3159e45307370169e7fa665fc881988fc7df3876aaea10","summary":[],"content":[]},"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"reasoning","id":"rs_075f3159e45307370169e7fa665fc881988fc7df3876aaea10","summary":[],"content":[]},"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0"}}}
+{"type":"emit_inbound","label":"turn/plan/updated","frame":{"method":"turn/plan/updated","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","explanation":null,"plan":[{"step":"inspect package.json","status":"completed"},{"step":"inspect tsconfig.json","status":"completed"},{"step":"report completion","status":"inProgress"}]}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","tokenUsage":{"total":{"totalTokens":77451,"inputTokens":75954,"cachedInputTokens":54016,"outputTokens":1497,"reasoningOutputTokens":1202},"last":{"totalTokens":26457,"inputTokens":26219,"cachedInputTokens":25600,"outputTokens":238,"reasoningOutputTokens":187},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":1,"windowDurationMins":300,"resetsAt":1776821038},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777407838},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"turn/plan/updated","frame":{"method":"turn/plan/updated","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","explanation":null,"plan":[{"step":"inspect package.json","status":"completed"},{"step":"inspect tsconfig.json","status":"completed"},{"step":"report completion","status":"completed"}]}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","tokenUsage":{"total":{"totalTokens":103969,"inputTokens":102424,"cachedInputTokens":80384,"outputTokens":1545,"reasoningOutputTokens":1202},"last":{"totalTokens":26518,"inputTokens":26470,"cachedInputTokens":26368,"outputTokens":48,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":1,"windowDurationMins":300,"resetsAt":1776821038},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777407838},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"reasoning","id":"rs_075f3159e45307370169e7fa6f98608198aa4521e637e1bc62","summary":[],"content":[]},"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"reasoning","id":"rs_075f3159e45307370169e7fa6f98608198aa4521e637e1bc62","summary":[],"content":[]},"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_075f3159e45307370169e7fa6fde708198b09a8c5ac7c02317","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa6fde708198b09a8c5ac7c02317","delta":"todo"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa6fde708198b09a8c5ac7c02317","delta":" list"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa6fde708198b09a8c5ac7c02317","delta":" fixture"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","itemId":"msg_075f3159e45307370169e7fa6fde708198b09a8c5ac7c02317","delta":" complete"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_075f3159e45307370169e7fa6fde708198b09a8c5ac7c02317","text":"todo list fixture complete","phase":"final_answer","memoryCitation":null},"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turnId":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","tokenUsage":{"total":{"totalTokens":130523,"inputTokens":128955,"cachedInputTokens":106880,"outputTokens":1568,"reasoningOutputTokens":1215},"last":{"totalTokens":26554,"inputTokens":26531,"cachedInputTokens":26496,"outputTokens":23,"reasoningOutputTokens":13},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":1,"windowDurationMins":300,"resetsAt":1776821038},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777407838},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019db229-ac7a-7923-ab72-67bfefd79a8b","turn":{"id":"019db229-ac8a-7bb2-8e03-9dcd9f2328e0","items":[],"status":"completed","error":null,"startedAt":1776810568,"completedAt":1776810608,"durationMs":39233}}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/todo_list/cursor_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/todo_list/cursor_output.ts
new file mode 100644
index 000000000000..219f51f3adc9
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/todo_list/cursor_output.ts
@@ -0,0 +1,62 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertAssistantTextIncludes,
+  assertBaseProjection,
+  assertExecutionNodeKinds,
+  assertRunOrdinals,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessagesInclude,
+  assertVisibleTurnItemsMirrorLocalTurnItems,
+  projectionFor,
+  TODO_LIST_PROMPT,
+} from "../shared.ts";
+
+export function assertTodoListCursorOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({ result, transcript, runCount: 1, runStatuses: ["completed"] });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertVisibleTurnItemsMirrorLocalTurnItems(projection);
+  assertRunOrdinals(projection, [1]);
+  assertExecutionNodeKinds(projection, ["root_turn", "todo_list", "tool_call"]);
+  assertTurnItemTypes(projection, [
+    "user_message",
+    "file_search",
+    "todo_list",
+    "assistant_message",
+  ]);
+  assertUserMessagesInclude(projection, [TODO_LIST_PROMPT]);
+  assertAssistantTextIncludes(projection, "todo list fixture complete");
+
+  const conversationalItems = projection.turnItems.filter(
+    (item) => item.type === "assistant_message" || item.type === "reasoning",
+  );
+  assert.deepEqual(
+    conversationalItems.map((item) => item.type),
+    ["assistant_message", "reasoning", "reasoning", "assistant_message", "assistant_message"],
+    "separate Cursor reasoning and assistant segments must not be concatenated",
+  );
+  const assistantMessages = conversationalItems.filter((item) => item.type === "assistant_message");
+  assert.lengthOf(assistantMessages, 3);
+  assert.include(assistantMessages[0]?.text ?? "", "I'll use the update_plan tool");
+  assert.include(assistantMessages[1]?.text ?? "", "No `update_plan` tool is available");
+  assert.equal(assistantMessages[2]?.text, "todo list fixture complete");
+  assert.lengthOf(
+    conversationalItems.filter((item) => item.type === "reasoning"),
+    2,
+  );
+
+  const todoLists = projection.plans.filter((plan) => plan.kind === "todo_list");
+  assert.isAtLeast(todoLists.length, 1);
+  assert.deepEqual(
+    todoLists.at(-1)?.steps.map((step) => step.status),
+    ["completed", "completed", "completed"],
+  );
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/todo_list/cursor_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/todo_list/cursor_transcript.ndjson
new file mode 100644
index 000000000000..915b3b3c2848
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/todo_list/cursor_transcript.ndjson
@@ -0,0 +1,104 @@
+{"type":"transcript_start","provider":"cursor","protocol":"cursor-agent-sdk.local","version":"1","scenario":"todo_list","metadata":{"generatedBy":"recordCursorAgentSdkReplayTranscript","nativeAgentId":"agent-dc85ea29-1f94-4803-8d28-0dc358300ffe"}}
+{"type":"expect_outbound","label":"agent.open","frame":{"type":"agent.open","operation":"create","options":{"model":{"id":"composer-2.5"},"hasName":true,"mode":"agent","local":{"hasCwd":true,"autoReview":false,"sandboxEnabled":true,"enableAgentRetries":true}}}}
+{"type":"emit_inbound","label":"agent.opened","frame":{"type":"agent.opened","agentId":"agent-dc85ea29-1f94-4803-8d28-0dc358300ffe"}}
+{"type":"expect_outbound","label":"run.start:1","frame":{"type":"run.start","message":"Use the update_plan tool to track exactly three steps: inspect package.json, inspect tsconfig.json, report completion. Then read package.json and tsconfig.json, and answer exactly: todo list fixture complete","options":{"model":{"id":"composer-2.5"},"mode":"agent"}}}
+{"type":"emit_inbound","label":"run.started:1","frame":{"type":"run.started","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","agentId":"agent-dc85ea29-1f94-4803-8d28-0dc358300ffe"}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"text-delta","text":"I'll"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"text-delta","text":" use"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"text-delta","text":" the update_plan"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":4}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"text-delta","text":" tool for"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"text-delta","text":" the three steps"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":4}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"text-delta","text":","}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"text-delta","text":" then read both"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":4}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"text-delta","text":" config"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"text-delta","text":" files"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"text-delta","text":".\n"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":3}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":3}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":3}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":30}}}
+{"type":"emit_inbound","label":"tool-call-started","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"tool-call-started","callId":"tool_1afa2c76-8304-41d9-a59d-139ff962eb0","toolCall":{"type":"read","args":{"path":"/tmp/cursor-replay-todo_list/package.json"}},"modelCallId":"78b3b965-5601-4832-a723-a9259703c762-0-wgfq"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":3}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":31}}}
+{"type":"emit_inbound","label":"tool-call-started","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"tool-call-started","callId":"tool_fb1809e9-fffb-4f76-9b0f-10e4f0f1f88","toolCall":{"type":"read","args":{"path":"/tmp/cursor-replay-todo_list/tsconfig.json"}},"modelCallId":"78b3b965-5601-4832-a723-a9259703c762-0-wgfq"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":17}}}
+{"type":"emit_inbound","label":"tool-call-completed","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"tool-call-completed","callId":"tool_1afa2c76-8304-41d9-a59d-139ff962eb0","toolCall":{"type":"read","args":{"path":"/tmp/cursor-replay-todo_list/package.json"},"result":{"status":"success","value":{"content":"{\"name\":\"cursor-read-only-fixture\",\"private\":true,\"scripts\":{\"typecheck\":\"tsc --noEmit\"}}","totalLines":1,"fileSize":89}}},"modelCallId":"78b3b965-5601-4832-a723-a9259703c762-0-wgfq"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":22}}}
+{"type":"emit_inbound","label":"tool-call-completed","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"tool-call-completed","callId":"tool_fb1809e9-fffb-4f76-9b0f-10e4f0f1f88","toolCall":{"type":"read","args":{"path":"/tmp/cursor-replay-todo_list/tsconfig.json"},"result":{"status":"success","value":{"content":"{\"compilerOptions\":{\"module\":\"ESNext\",\"strict\":true,\"target\":\"ES2022\"}}","totalLines":1,"fileSize":71}}},"modelCallId":"78b3b965-5601-4832-a723-a9259703c762-0-wgfq"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":18}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":3}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":3}}}
+{"type":"emit_inbound","label":"tool-call-started","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"tool-call-started","callId":"tool_b9573f13-5878-4f12-8a4a-1ac6539d2c6","toolCall":{"type":"grep","args":{"pattern":"update_plan","offset":0}},"modelCallId":"78b3b965-5601-4832-a723-a9259703c762-1-kj0v"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":5}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"tool-call-started","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"tool-call-started","callId":"tool_85d050cc-5276-4dea-9ae0-69d7d0c5dcf","toolCall":{"type":"glob","args":{"globPattern":"**/*"}},"modelCallId":"78b3b965-5601-4832-a723-a9259703c762-1-kj0v"}}}
+{"type":"emit_inbound","label":"tool-call-completed","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"tool-call-completed","callId":"tool_b9573f13-5878-4f12-8a4a-1ac6539d2c6","toolCall":{"type":"grep","args":{"pattern":"update_plan","offset":0},"result":{"status":"success","value":{"workspaceResults":{"/var/folders/b3/b51_pdxj7dl0t981zpqkxxhr0000gn/T/t3-orchestrator-v2-cursor-agent-sdk-record-todo_list-CIb23S":{"type":"content","output":{"matches":[],"totalMatches":0}}}}}},"modelCallId":"78b3b965-5601-4832-a723-a9259703c762-1-kj0v"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":45}}}
+{"type":"emit_inbound","label":"tool-call-completed","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"tool-call-completed","callId":"tool_85d050cc-5276-4dea-9ae0-69d7d0c5dcf","toolCall":{"type":"glob","args":{"globPattern":"**/*"},"result":{"status":"success","value":{"files":["./tsconfig.json","./package.json","./.git/logs/refs/heads/main","./.git/logs/HEAD","./.git/refs/heads/main","./.git/objects/ca/af47d623ededb9003c98e14a66bcfd037f0182","./.git/COMMIT_EDITMSG","./README.md","./.git/config","./.git/HEAD","./.git/hooks/push-to-checkout.sample","./.git/hooks/update.sample","./.git/hooks/pre-push.sample","./.git/hooks/pre-applypatch.sample","./.git/hooks/pre-merge-commit.sample","./.git/hooks/post-update.sample","./.git/hooks/prepare-commit-msg.sample","./.git/hooks/pre-receive.sample","./.git/hooks/fsmonitor-watchman.sample","./.git/hooks/applypatch-msg.sample","./.git/hooks/pre-commit.sample","./.git/hooks/sendemail-validate.sample","./.git/hooks/pre-rebase.sample","./.git/hooks/commit-msg.sample","./.git/description","./.git/info/exclude"],"totalFiles":26,"clientTruncated":false,"ripgrepTruncated":false}}},"modelCallId":"78b3b965-5601-4832-a723-a9259703c762-1-kj0v"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":206}}}
+{"type":"emit_inbound","label":"thinking-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"thinking-delta","text":"The update_plan tool"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":5}}}
+{"type":"emit_inbound","label":"thinking-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"thinking-delta","text":" does not exist in the"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":5}}}
+{"type":"emit_inbound","label":"thinking-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"thinking-delta","text":" MCP servers or codebase."}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":6}}}
+{"type":"emit_inbound","label":"thinking-completed","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"thinking-completed","thinkingDurationMs":608}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":3}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":30}}}
+{"type":"emit_inbound","label":"tool-call-started","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"tool-call-started","callId":"tool_196feaa1-1381-49c6-8bf5-e716ff05eef","toolCall":{"type":"read","args":{"path":"/tmp/cursor-replay-todo_list/README.md"}},"modelCallId":"78b3b965-5601-4832-a723-a9259703c762-2-zbbf"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":10}}}
+{"type":"emit_inbound","label":"tool-call-completed","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"tool-call-completed","callId":"tool_196feaa1-1381-49c6-8bf5-e716ff05eef","toolCall":{"type":"read","args":{"path":"/tmp/cursor-replay-todo_list/README.md"},"result":{"status":"success","value":{"content":"# cursor-agent-sdk-record-todo_list\n","totalLines":2,"fileSize":36}}},"modelCallId":"78b3b965-5601-4832-a723-a9259703c762-2-zbbf"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":9}}}
+{"type":"emit_inbound","label":"thinking-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"thinking-delta","text":"The update_plan tool"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":5}}}
+{"type":"emit_inbound","label":"thinking-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"thinking-delta","text":" is unavailable."}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":4}}}
+{"type":"emit_inbound","label":"thinking-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"thinking-delta","text":"\n\nTodoWrite will replace"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":6}}}
+{"type":"emit_inbound","label":"thinking-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"thinking-delta","text":" the unavailable update_plan"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":7}}}
+{"type":"emit_inbound","label":"thinking-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"thinking-delta","text":" tool."}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"thinking-completed","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"thinking-completed","thinkingDurationMs":984}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"text-delta","text":"No `update_plan"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":4}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"text-delta","text":"` tool is"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"text-delta","text":" available here; I'll"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":5}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"text-delta","text":" track"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"text-delta","text":" the three"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"text-delta","text":" steps with Todo"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":4}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"text-delta","text":"Write instead"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":4}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"text-delta","text":".\n"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":3}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":3}}}
+{"type":"emit_inbound","label":"partial-tool-call","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"partial-tool-call","callId":"tool_64775a27-f6f1-4f85-9061-2038c1c6d57","toolCall":{"type":"updateTodos","args":{"todos":[{"content":"inspect package.json","status":"completed"}]}},"modelCallId":"78b3b965-5601-4832-a723-a9259703c762-3-fvov"}}}
+{"type":"emit_inbound","label":"partial-tool-call","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"partial-tool-call","callId":"tool_64775a27-f6f1-4f85-9061-2038c1c6d57","toolCall":{"type":"updateTodos","args":{"todos":[{"content":"inspect package.json","status":"completed"},{"content":"inspect tsconfig.json","status":"completed"}]}},"modelCallId":"78b3b965-5601-4832-a723-a9259703c762-3-fvov"}}}
+{"type":"emit_inbound","label":"partial-tool-call","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"partial-tool-call","callId":"tool_64775a27-f6f1-4f85-9061-2038c1c6d57","toolCall":{"type":"updateTodos","args":{"todos":[{"content":"inspect package.json","status":"completed"},{"content":"inspect tsconfig.json","status":"completed"},{"content":"report completion","status":"completed"}]}},"modelCallId":"78b3b965-5601-4832-a723-a9259703c762-3-fvov"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":53}}}
+{"type":"emit_inbound","label":"tool-call-started","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"tool-call-started","callId":"tool_64775a27-f6f1-4f85-9061-2038c1c6d57","toolCall":{"type":"updateTodos","args":{"todos":[{"content":"inspect package.json","status":"completed"},{"content":"inspect tsconfig.json","status":"completed"},{"content":"report completion","status":"completed"}]}},"modelCallId":"78b3b965-5601-4832-a723-a9259703c762-3-fvov"}}}
+{"type":"emit_inbound","label":"tool-call-completed","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"tool-call-completed","callId":"tool_64775a27-f6f1-4f85-9061-2038c1c6d57","toolCall":{"type":"updateTodos","args":{"todos":[{"content":"inspect package.json","status":"completed"},{"content":"inspect tsconfig.json","status":"completed"},{"content":"report completion","status":"completed"}]},"result":{"status":"success","value":{"todos":[{"content":"inspect package.json","status":"completed"},{"content":"inspect tsconfig.json","status":"completed"},{"content":"report completion","status":"completed"}],"totalCount":3}}},"modelCallId":"78b3b965-5601-4832-a723-a9259703c762-3-fvov"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":93}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"text-delta","text":"todo"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"text-delta","text":" list fixture complete"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"token-delta","tokens":5}}}
+{"type":"emit_inbound","label":"step-completed","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"step-completed","stepId":13,"stepDurationMs":9044}}}
+{"type":"emit_inbound","label":"turn-ended","frame":{"type":"interaction.update","runId":"run-50c35736-cb9d-4070-8299-8a4360c76af7","update":{"type":"turn-ended","usage":{"inputTokens":55956,"outputTokens":1036,"cacheReadTokens":40288,"cacheWriteTokens":0}}}}
+{"type":"emit_inbound","label":"run.completed:1","frame":{"type":"run.completed","result":{"id":"run-50c35736-cb9d-4070-8299-8a4360c76af7","requestId":"78b3b965-5601-4832-a723-a9259703c762","status":"finished","result":"todo list fixture complete","model":{"id":"composer-2.5"},"durationMs":11741}}}
+{"type":"expect_outbound","label":"agent.close","frame":{"type":"agent.close","agentId":"agent-dc85ea29-1f94-4803-8d28-0dc358300ffe"}}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/todo_list/grok_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/todo_list/grok_output.ts
new file mode 100644
index 000000000000..3c18c1fa2438
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/todo_list/grok_output.ts
@@ -0,0 +1,50 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertAssistantTextIncludes,
+  assertBaseProjection,
+  assertExecutionNodeKinds,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessagesInclude,
+  assertVisibleTurnItemsMirrorLocalTurnItems,
+  projectionFor,
+  TODO_LIST_PROMPT,
+} from "../shared.ts";
+
+export function assertTodoListGrokOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({ result, transcript, runCount: 1, runStatuses: ["completed"] });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertVisibleTurnItemsMirrorLocalTurnItems(projection);
+  assertExecutionNodeKinds(projection, ["root_turn", "todo_list", "tool_call"]);
+  assertTurnItemTypes(projection, [
+    "user_message",
+    "todo_list",
+    "file_search",
+    "assistant_message",
+  ]);
+  assertUserMessagesInclude(projection, [TODO_LIST_PROMPT]);
+  assertAssistantTextIncludes(projection, "todo list fixture complete");
+
+  const planEvents = result.domainEvents.filter((event) => event.type === "plan.updated");
+  assert.lengthOf(planEvents, 2);
+  assert.equal(
+    new Set(planEvents.map((event) => (event.type === "plan.updated" ? event.payload.id : null)))
+      .size,
+    1,
+    "ACP plan updates must preserve one plan identity",
+  );
+  const todoLists = projection.plans.filter((plan) => plan.kind === "todo_list");
+  assert.isAtLeast(todoLists.length, 1);
+  assert.deepEqual(
+    todoLists.at(-1)?.steps.map((step) => step.status),
+    ["completed", "completed", "completed"],
+  );
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/todo_list/grok_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/todo_list/grok_transcript.ndjson
new file mode 100644
index 000000000000..e726ac5b21a3
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/todo_list/grok_transcript.ndjson
@@ -0,0 +1,16 @@
+{"type":"transcript_start","provider":"grok","protocol":"acp.ndjson-jsonrpc","version":"1","scenario":"todo_list","metadata":{"generatedBy":"live-grok-shape-probe","nativeSessionId":"grok-replay-session-1"}}
+{"type":"expect_outbound","label":"initialize","frame":{"kind":"request","method":"initialize","params":{"protocolVersion":1,"clientCapabilities":{"fs":{"readTextFile":false,"writeTextFile":false},"terminal":false,"elicitation":{"form":{}}},"clientInfo":{"name":"t3-code","version":"0.0.0"}}}}
+{"type":"emit_inbound","label":"initialized","frame":{"kind":"response","method":"initialize","result":{"protocolVersion":1,"agentCapabilities":{"loadSession":true,"mcpCapabilities":{"http":true,"sse":true},"promptCapabilities":{"audio":false,"embeddedContext":true,"image":false}},"authMethods":[{"id":"replay","name":"Replay"}],"agentInfo":{"name":"grok-replay","version":"1"}}}}
+{"type":"expect_outbound","label":"session.new","frame":{"kind":"request","method":"session/new","params":{"cwd":"<workspace>","mcpServers":"<any>"}}}
+{"type":"emit_inbound","label":"session.created","frame":{"kind":"response","method":"session/new","result":{"sessionId":"grok-replay-session-1","models":{"currentModelId":"grok-build","availableModels":[{"modelId":"grok-build","name":"Grok Build"}]}}}}
+{"type":"expect_outbound","label":"session.prompt","frame":{"kind":"request","method":"session/prompt","params":{"sessionId":"grok-replay-session-1","prompt":[{"type":"text","text":"Use the update_plan tool to track exactly three steps: inspect package.json, inspect tsconfig.json, report completion. Then read package.json and tsconfig.json, and answer exactly: todo list fixture complete"}]}}}
+{"type":"emit_inbound","label":"assistant.progress","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"grok-replay-session-1","update":{"sessionUpdate":"agent_message_chunk","content":{"type":"text","text":"I'll track the three steps and inspect both files."}}}}}
+{"type":"emit_inbound","label":"plan.started","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"grok-replay-session-1","update":{"sessionUpdate":"plan","entries":[{"content":"Inspect package.json","priority":"high","status":"in_progress"},{"content":"Inspect tsconfig.json","priority":"high","status":"pending"},{"content":"Report completion","priority":"high","status":"pending"}]}}}}
+{"type":"emit_inbound","label":"tool.package.started","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"grok-replay-session-1","update":{"sessionUpdate":"tool_call","toolCallId":"read-package","title":"Read package.json","kind":"read","status":"pending","rawInput":{"path":"package.json"}}}}}
+{"type":"emit_inbound","label":"tool.package.completed","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"grok-replay-session-1","update":{"sessionUpdate":"tool_call_update","toolCallId":"read-package","status":"completed","rawOutput":{"content":"{\"name\":\"t3\"}"}}}}}
+{"type":"emit_inbound","label":"tool.tsconfig.started","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"grok-replay-session-1","update":{"sessionUpdate":"tool_call","toolCallId":"read-tsconfig","title":"Read tsconfig.json","kind":"read","status":"pending","rawInput":{"path":"tsconfig.json"}}}}}
+{"type":"emit_inbound","label":"tool.tsconfig.completed","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"grok-replay-session-1","update":{"sessionUpdate":"tool_call_update","toolCallId":"read-tsconfig","status":"completed","rawOutput":{"content":"{\"compilerOptions\":{}}"}}}}}
+{"type":"emit_inbound","label":"plan.completed","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"grok-replay-session-1","update":{"sessionUpdate":"plan","entries":[{"content":"Inspect package.json","priority":"high","status":"completed"},{"content":"Inspect tsconfig.json","priority":"high","status":"completed"},{"content":"Report completion","priority":"high","status":"completed"}]}}}}
+{"type":"emit_inbound","label":"assistant.final","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"grok-replay-session-1","update":{"sessionUpdate":"agent_message_chunk","content":{"type":"text","text":"todo list fixture complete"}}}}}
+{"type":"emit_inbound","label":"prompt.completed","frame":{"kind":"response","method":"session/prompt","result":{"stopReason":"end_turn"}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/todo_list/input.ts b/apps/server/src/orchestration-v2/testkit/fixtures/todo_list/input.ts
new file mode 100644
index 000000000000..8e41003bb6c8
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/todo_list/input.ts
@@ -0,0 +1,7 @@
+import { TODO_LIST_PROMPT, type OrchestratorFixtureInput } from "../shared.ts";
+
+export function todoListInput(): OrchestratorFixtureInput {
+  return {
+    steps: [{ type: "message", text: TODO_LIST_PROMPT }],
+  };
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only/claude_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only/claude_output.ts
new file mode 100644
index 000000000000..41fced1a633a
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only/claude_output.ts
@@ -0,0 +1,62 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertAssistantTextIncludes,
+  assertBaseProjection,
+  assertReplayLabelPrefixCount,
+  assertRuntimeRequestCounts,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessagesInclude,
+  assertVisibleTurnItemsMirrorLocalTurnItems,
+  projectionFor,
+  TOOL_CALL_READ_ONLY_PROMPT,
+} from "../shared.ts";
+
+export function assertToolCallReadOnlyClaudeOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({ result, transcript, runCount: 1, runStatuses: ["completed"] });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertVisibleTurnItemsMirrorLocalTurnItems(projection);
+  assertTurnItemTypes(projection, ["user_message", "dynamic_tool", "assistant_message"]);
+  assertUserMessagesInclude(projection, [TOOL_CALL_READ_ONLY_PROMPT]);
+  assertAssistantTextIncludes(projection, "read only tool fixture complete");
+  assertRuntimeRequestCounts(projection, { total: 0 });
+  assertReplayLabelPrefixCount(transcript, "permission.request:", 0);
+  assertReplayLabelPrefixCount(transcript, "permission.response:", 0);
+  assert.notInclude(JSON.stringify(transcript.entries), '"is_error":true');
+  assert.notInclude(JSON.stringify(transcript.entries), "File does not exist");
+
+  const dynamicTools = projection.turnItems.filter((item) => item.type === "dynamic_tool");
+  assert.lengthOf(dynamicTools, 2);
+  assert.lengthOf(
+    dynamicTools.filter((item) => item.toolName === "Glob"),
+    0,
+    "Claude should not need discovery errors for this deterministic read-only fixture",
+  );
+  assert.lengthOf(
+    dynamicTools.filter((item) => item.toolName === "Read"),
+    2,
+    "Claude must project Read file tool calls",
+  );
+  assert.isTrue(
+    dynamicTools.some((item) =>
+      JSON.stringify(item.output ?? null).includes("claude-read-only-fixture"),
+    ),
+    "Claude must read package.json contents",
+  );
+  assert.isTrue(
+    dynamicTools.some((item) => JSON.stringify(item.output ?? null).includes("ESNext")),
+    "Claude must read tsconfig.json contents",
+  );
+  assert.lengthOf(
+    projection.turnItems.filter((item) => item.type === "approval_request"),
+    0,
+  );
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only/claude_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only/claude_transcript.ndjson
new file mode 100644
index 000000000000..1278ba6b1e19
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only/claude_transcript.ndjson
@@ -0,0 +1,16 @@
+{"type":"transcript_start","provider":"claudeAgent","protocol":"claude-agent-sdk.query","version":"0.2.111","scenario":"tool_call_read_only","metadata":{"prompts":["Read /tmp/claude-replay-tool_call_read_only/package.json and /tmp/claude-replay-tool_call_read_only/tsconfig.json, then answer exactly: read only tool fixture complete"],"model":"claude-sonnet-4-6","nativeSessionId":"473fb58f-85a3-4f21-b9d3-b1fdf5ef41f9","queryMode":"streaming","tools":["Read","Glob","Grep"],"permissionMode":"dontAsk","allowedTools":["Read","Glob","Grep"],"generatedBy":"recordClaudeAgentSdkReplayTranscript"}}
+{"type":"expect_outbound","label":"query.open","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":["Read","Glob","Grep"],"permissionMode":"dontAsk","allowedTools":["Read","Glob","Grep"],"sessionId":"473fb58f-85a3-4f21-b9d3-b1fdf5ef41f9"}}}
+{"type":"expect_outbound","label":"prompt.offer:1","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Read /tmp/claude-replay-tool_call_read_only/package.json and /tmp/claude-replay-tool_call_read_only/tsconfig.json, then answer exactly: read only tool fixture complete"},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"4d07cf82-fa99-4897-afc7-51775243eb93","hook_name":"SessionStart:startup","hook_event":"SessionStart","uuid":"1c40e207-bb7e-438e-b09e-8fe547a5fd7f","session_id":"473fb58f-85a3-4f21-b9d3-b1fdf5ef41f9"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"4d07cf82-fa99-4897-afc7-51775243eb93","hook_name":"SessionStart:startup","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"926cc2b6-6925-495e-95d4-15e722ed3e80","session_id":"473fb58f-85a3-4f21-b9d3-b1fdf5ef41f9"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.111","cwd":"/tmp/claude-replay-tool_call_read_only","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"dontAsk","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"7d295979-f2e5-43cb-a9ee-b05f140f3ed8","session_id":"473fb58f-85a3-4f21-b9d3-b1fdf5ef41f9"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01GA9LpBQUx46bYfJz1Dg3sx","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"Let me read both files simultaneously.","signature":"EuMBClsIDRgCKkCgcxLVMMfd/q0XMe3G9eezJXNLWZHFeCeLQQe+ZV/7LgzunPPqJA4qIhBlaUd20MdLktQmupV8Pf3F0M48mCXvMhFjbGF1ZGUtc29ubmV0LTQtNjgAEgyXwqTEvhX6TK7UPN0aDFxE8OrDIanq7FuUWSIwylTxDMwjDluRqVJpzPtcyggC9mQWyDuXfygmPXaHmQC4tKfQm7u+n1Q+KXKkqQQQKjYALOZjd9uroAWLpWRN1lxeoD9ivHXr/I/DLToXbofDxYKZ7+AUJPsKWfIBAjUtu208DrI5/FsYAQ=="}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":3149,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"output_tokens":6,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"473fb58f-85a3-4f21-b9d3-b1fdf5ef41f9","uuid":"7afffaac-efb9-4e50-a30d-2fbab11e09ff"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01GA9LpBQUx46bYfJz1Dg3sx","type":"message","role":"assistant","content":[{"type":"text","text":"I'll read both files simultaneously!"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":3149,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"output_tokens":6,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"473fb58f-85a3-4f21-b9d3-b1fdf5ef41f9","uuid":"1431fb1c-7870-4f90-bb8b-f93f3e1c2c39"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01GA9LpBQUx46bYfJz1Dg3sx","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_017Q89TYYCDJPT2uLttrCn3A","name":"Read","input":{"file_path":"/tmp/claude-replay-tool_call_read_only/package.json"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":3149,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"output_tokens":6,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"473fb58f-85a3-4f21-b9d3-b1fdf5ef41f9","uuid":"b1f4ff95-1ab5-4b39-ad86-0b820abfba5a"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01GA9LpBQUx46bYfJz1Dg3sx","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01CAafSU7YvuRYWdrFzpGCCW","name":"Read","input":{"file_path":"/tmp/claude-replay-tool_call_read_only/tsconfig.json"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":0,"cache_read_input_tokens":3149,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"output_tokens":6,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"473fb58f-85a3-4f21-b9d3-b1fdf5ef41f9","uuid":"4a184534-4099-48f8-8bd0-4b9aaab8868c"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed"},"uuid":"1d2f25d8-fb17-4671-bd83-c918afbabdff","session_id":"473fb58f-85a3-4f21-b9d3-b1fdf5ef41f9"}}
+{"type":"emit_inbound","label":"user","frame":{"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_017Q89TYYCDJPT2uLttrCn3A","type":"tool_result","content":"1\t{\n2\t  \"name\": \"claude-read-only-fixture\",\n3\t  \"private\": true,\n4\t  \"scripts\": {\n5\t    \"typecheck\": \"tsc --noEmit\"\n6\t  }\n7\t}"}]},"parent_tool_use_id":null,"session_id":"473fb58f-85a3-4f21-b9d3-b1fdf5ef41f9","uuid":"0d5bfbc0-e826-466a-bea8-54368db21675","timestamp":"2026-05-07T03:35:43.611Z","tool_use_result":{"type":"text","file":{"filePath":"/tmp/claude-replay-tool_call_read_only/package.json","content":"{\n  \"name\": \"claude-read-only-fixture\",\n  \"private\": true,\n  \"scripts\": {\n    \"typecheck\": \"tsc --noEmit\"\n  }\n}","numLines":7,"startLine":1,"totalLines":7}}}}
+{"type":"emit_inbound","label":"user","frame":{"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01CAafSU7YvuRYWdrFzpGCCW","type":"tool_result","content":"1\t{\n2\t  \"compilerOptions\": {\n3\t    \"module\": \"ESNext\",\n4\t    \"strict\": true,\n5\t    \"target\": \"ES2022\"\n6\t  }\n7\t}"}]},"parent_tool_use_id":null,"session_id":"473fb58f-85a3-4f21-b9d3-b1fdf5ef41f9","uuid":"259604ce-267c-4f3f-8a26-29e55f461d40","timestamp":"2026-05-07T03:35:43.652Z","tool_use_result":{"type":"text","file":{"filePath":"/tmp/claude-replay-tool_call_read_only/tsconfig.json","content":"{\n  \"compilerOptions\": {\n    \"module\": \"ESNext\",\n    \"strict\": true,\n    \"target\": \"ES2022\"\n  }\n}","numLines":7,"startLine":1,"totalLines":7}}}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_017vbtgCJT7W7ayU6dpcREpU","type":"message","role":"assistant","content":[{"type":"text","text":"read only tool fixture complete"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":1,"cache_creation_input_tokens":328,"cache_read_input_tokens":3149,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":328},"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"473fb58f-85a3-4f21-b9d3-b1fdf5ef41f9","uuid":"5f4a941e-08e7-4217-bc4c-a48cd3c237fa"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":4122,"duration_api_ms":3687,"num_turns":3,"result":"read only tool fixture complete","stop_reason":"end_turn","session_id":"473fb58f-85a3-4f21-b9d3-b1fdf5ef41f9","total_cost_usd":0.005561399999999999,"usage":{"input_tokens":4,"cache_creation_input_tokens":328,"cache_read_input_tokens":6298,"output_tokens":162,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":328,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[{"input_tokens":1,"output_tokens":8,"cache_read_input_tokens":3149,"cache_creation_input_tokens":328,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":328},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":4,"outputTokens":162,"cacheReadInputTokens":6298,"cacheCreationInputTokens":328,"webSearchRequests":0,"costUSD":0.005561399999999999,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"6f61e05c-80c8-4b60-afd0-ce2d0a9eafc9"}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only/cursor_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only/cursor_output.ts
new file mode 100644
index 000000000000..128d2efb8b6a
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only/cursor_output.ts
@@ -0,0 +1,64 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertAssistantTextIncludes,
+  assertBaseProjection,
+  assertRuntimeRequestCounts,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessagesInclude,
+  assertVisibleTurnItemsMirrorLocalTurnItems,
+  projectionFor,
+  TOOL_CALL_READ_ONLY_PROMPT,
+} from "../shared.ts";
+
+export function assertToolCallReadOnlyCursorOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({ result, transcript, runCount: 1, runStatuses: ["completed"] });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertVisibleTurnItemsMirrorLocalTurnItems(projection);
+  assertTurnItemTypes(projection, ["user_message", "file_search", "assistant_message"]);
+  assertUserMessagesInclude(projection, [TOOL_CALL_READ_ONLY_PROMPT]);
+  assertAssistantTextIncludes(projection, "read only tool fixture complete");
+  assertRuntimeRequestCounts(projection, { total: 0 });
+
+  const assistantMessages = projection.turnItems.filter(
+    (item) => item.type === "assistant_message",
+  );
+  assert.deepEqual(
+    assistantMessages.map((item) => item.text),
+    ["Reading both files now.\n", "read only tool fixture complete"],
+    "Cursor progress text and the final response must be separate messages",
+  );
+
+  const fileSearches = projection.turnItems.filter((item) => item.type === "file_search");
+  assert.lengthOf(fileSearches, 2);
+  assert.isBelow(assistantMessages[0]?.ordinal ?? Infinity, fileSearches[0]?.ordinal ?? -Infinity);
+  assert.isBelow(fileSearches[1]?.ordinal ?? Infinity, assistantMessages[1]?.ordinal ?? -Infinity);
+  assert.isTrue(
+    fileSearches.some((item) =>
+      JSON.stringify(item.results ?? []).includes("cursor-read-only-fixture"),
+    ),
+  );
+  assert.isTrue(fileSearches.some((item) => JSON.stringify(item.results ?? []).includes("ES2022")));
+  const expectedPaths = [
+    "/tmp/claude-replay-tool_call_read_only/package.json",
+    "/tmp/claude-replay-tool_call_read_only/tsconfig.json",
+  ];
+  assert.deepEqual(
+    fileSearches.map((item) => item.pattern).toSorted(),
+    expectedPaths,
+    "Cursor file_search patterns must match the files named in the recorded prompt",
+  );
+  assert.deepEqual(
+    fileSearches.flatMap((item) => item.results?.map((result) => result.fileName) ?? []).toSorted(),
+    expectedPaths,
+    "Cursor file_search paths must match the files named in the recorded prompt",
+  );
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only/cursor_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only/cursor_transcript.ndjson
new file mode 100644
index 000000000000..dfb2d9dfce12
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only/cursor_transcript.ndjson
@@ -0,0 +1,27 @@
+{"type":"transcript_start","provider":"cursor","protocol":"cursor-agent-sdk.local","version":"1","scenario":"tool_call_read_only","metadata":{"generatedBy":"recordCursorAgentSdkReplayTranscript","nativeAgentId":"agent-3d017b33-d7fe-40aa-868b-0b7a68d0e15b"}}
+{"type":"expect_outbound","label":"agent.open","frame":{"type":"agent.open","operation":"create","options":{"model":{"id":"composer-2.5"},"hasName":true,"mode":"agent","local":{"hasCwd":true,"autoReview":false,"sandboxEnabled":true,"enableAgentRetries":true}}}}
+{"type":"emit_inbound","label":"agent.opened","frame":{"type":"agent.opened","agentId":"agent-3d017b33-d7fe-40aa-868b-0b7a68d0e15b"}}
+{"type":"expect_outbound","label":"run.start:1","frame":{"type":"run.start","message":"Read /tmp/claude-replay-tool_call_read_only/package.json and /tmp/claude-replay-tool_call_read_only/tsconfig.json, then answer exactly: read only tool fixture complete","options":{"model":{"id":"composer-2.5"},"mode":"agent"}}}
+{"type":"emit_inbound","label":"run.started:1","frame":{"type":"run.started","runId":"run-db8a1002-593e-4baf-9ed1-d837c14643ed","agentId":"agent-3d017b33-d7fe-40aa-868b-0b7a68d0e15b"}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-db8a1002-593e-4baf-9ed1-d837c14643ed","update":{"type":"text-delta","text":"Reading both files now"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-db8a1002-593e-4baf-9ed1-d837c14643ed","update":{"type":"token-delta","tokens":5}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-db8a1002-593e-4baf-9ed1-d837c14643ed","update":{"type":"text-delta","text":".\n"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-db8a1002-593e-4baf-9ed1-d837c14643ed","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-db8a1002-593e-4baf-9ed1-d837c14643ed","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-db8a1002-593e-4baf-9ed1-d837c14643ed","update":{"type":"token-delta","tokens":13}}}
+{"type":"emit_inbound","label":"tool-call-started","frame":{"type":"interaction.update","runId":"run-db8a1002-593e-4baf-9ed1-d837c14643ed","update":{"type":"tool-call-started","callId":"tool_56c7e2fb-8a39-4b1d-8b28-31f47bd717e","toolCall":{"type":"read","args":{"path":"/tmp/claude-replay-tool_call_read_only/package.json"}},"modelCallId":"fb59b086-fb0a-4263-ac27-2c53351e44ac-0-279u"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-db8a1002-593e-4baf-9ed1-d837c14643ed","update":{"type":"token-delta","tokens":3}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-db8a1002-593e-4baf-9ed1-d837c14643ed","update":{"type":"token-delta","tokens":13}}}
+{"type":"emit_inbound","label":"tool-call-started","frame":{"type":"interaction.update","runId":"run-db8a1002-593e-4baf-9ed1-d837c14643ed","update":{"type":"tool-call-started","callId":"tool_a4c6ef64-f13c-4738-b527-1aad09b6185","toolCall":{"type":"read","args":{"path":"/tmp/claude-replay-tool_call_read_only/tsconfig.json"}},"modelCallId":"fb59b086-fb0a-4263-ac27-2c53351e44ac-0-279u"}}}
+{"type":"emit_inbound","label":"tool-call-completed","frame":{"type":"interaction.update","runId":"run-db8a1002-593e-4baf-9ed1-d837c14643ed","update":{"type":"tool-call-completed","callId":"tool_56c7e2fb-8a39-4b1d-8b28-31f47bd717e","toolCall":{"type":"read","args":{"path":"/tmp/claude-replay-tool_call_read_only/package.json"},"result":{"status":"success","value":{"content":"{\"name\":\"cursor-read-only-fixture\",\"private\":true,\"scripts\":{\"typecheck\":\"tsc --noEmit\"}}","totalLines":1,"fileSize":89}}},"modelCallId":"fb59b086-fb0a-4263-ac27-2c53351e44ac-0-279u"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-db8a1002-593e-4baf-9ed1-d837c14643ed","update":{"type":"token-delta","tokens":23}}}
+{"type":"emit_inbound","label":"tool-call-completed","frame":{"type":"interaction.update","runId":"run-db8a1002-593e-4baf-9ed1-d837c14643ed","update":{"type":"tool-call-completed","callId":"tool_a4c6ef64-f13c-4738-b527-1aad09b6185","toolCall":{"type":"read","args":{"path":"/tmp/claude-replay-tool_call_read_only/tsconfig.json"},"result":{"status":"success","value":{"content":"{\"compilerOptions\":{\"module\":\"ESNext\",\"strict\":true,\"target\":\"ES2022\"}}","totalLines":1,"fileSize":71}}},"modelCallId":"fb59b086-fb0a-4263-ac27-2c53351e44ac-0-279u"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-db8a1002-593e-4baf-9ed1-d837c14643ed","update":{"type":"token-delta","tokens":17}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-db8a1002-593e-4baf-9ed1-d837c14643ed","update":{"type":"text-delta","text":"read"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-db8a1002-593e-4baf-9ed1-d837c14643ed","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-db8a1002-593e-4baf-9ed1-d837c14643ed","update":{"type":"text-delta","text":" only tool fixture complete"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-db8a1002-593e-4baf-9ed1-d837c14643ed","update":{"type":"token-delta","tokens":6}}}
+{"type":"emit_inbound","label":"step-completed","frame":{"type":"interaction.update","runId":"run-db8a1002-593e-4baf-9ed1-d837c14643ed","update":{"type":"step-completed","stepId":4,"stepDurationMs":2132}}}
+{"type":"emit_inbound","label":"turn-ended","frame":{"type":"interaction.update","runId":"run-db8a1002-593e-4baf-9ed1-d837c14643ed","update":{"type":"turn-ended","usage":{"inputTokens":20572,"outputTokens":118,"cacheReadTokens":14720,"cacheWriteTokens":0}}}}
+{"type":"emit_inbound","label":"run.completed:1","frame":{"type":"run.completed","result":{"id":"run-db8a1002-593e-4baf-9ed1-d837c14643ed","requestId":"fb59b086-fb0a-4263-ac27-2c53351e44ac","status":"finished","result":"read only tool fixture complete","model":{"id":"composer-2.5"},"durationMs":4662}}}
+{"type":"expect_outbound","label":"agent.close","frame":{"type":"agent.close","agentId":"agent-3d017b33-d7fe-40aa-868b-0b7a68d0e15b"}}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only/grok_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only/grok_transcript.ndjson
new file mode 100644
index 000000000000..e0742029b685
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only/grok_transcript.ndjson
@@ -0,0 +1,15 @@
+{"type":"transcript_start","provider":"grok","protocol":"acp.ndjson-jsonrpc","version":"1","scenario":"tool_call_read_only","metadata":{"generatedBy":"live-grok-shape-probe","nativeSessionId":"grok-replay-session-1"}}
+{"type":"expect_outbound","label":"initialize","frame":{"kind":"request","method":"initialize","params":{"protocolVersion":1,"clientCapabilities":{"fs":{"readTextFile":false,"writeTextFile":false},"terminal":false,"elicitation":{"form":{}}},"clientInfo":{"name":"t3-code","version":"0.0.0"}}}}
+{"type":"emit_inbound","label":"initialized","frame":{"kind":"response","method":"initialize","result":{"protocolVersion":1,"agentCapabilities":{"loadSession":true,"mcpCapabilities":{"http":true,"sse":true},"promptCapabilities":{"audio":false,"embeddedContext":true,"image":false}},"authMethods":[{"id":"replay","name":"Replay"}],"agentInfo":{"name":"grok-replay","version":"1"}}}}
+{"type":"expect_outbound","label":"session.new","frame":{"kind":"request","method":"session/new","params":{"cwd":"<workspace>","mcpServers":"<any>"}}}
+{"type":"emit_inbound","label":"session.created","frame":{"kind":"response","method":"session/new","result":{"sessionId":"grok-replay-session-1","models":{"currentModelId":"grok-build","availableModels":[{"modelId":"grok-build","name":"Grok Build"}]}}}}
+{"type":"expect_outbound","label":"session.prompt","frame":{"kind":"request","method":"session/prompt","params":{"sessionId":"grok-replay-session-1","prompt":[{"type":"text","text":"Read /tmp/claude-replay-tool_call_read_only/package.json and /tmp/claude-replay-tool_call_read_only/tsconfig.json, then answer exactly: read only tool fixture complete"}]}}}
+{"type":"emit_inbound","label":"assistant.progress","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"grok-replay-session-1","update":{"sessionUpdate":"agent_message_chunk","content":{"type":"text","text":"Reading both files now.\n"}}}}}
+{"type":"emit_inbound","label":"tool.package.started","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"grok-replay-session-1","update":{"sessionUpdate":"tool_call","toolCallId":"read-package","title":"Read package.json","kind":"read","status":"pending","rawInput":{"path":"/tmp/claude-replay-tool_call_read_only/package.json"}}}}}
+{"type":"emit_inbound","label":"tool.package.running","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"grok-replay-session-1","update":{"sessionUpdate":"tool_call_update","toolCallId":"read-package","status":"in_progress"}}}}
+{"type":"emit_inbound","label":"tool.package.completed","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"grok-replay-session-1","update":{"sessionUpdate":"tool_call_update","toolCallId":"read-package","status":"completed","rawOutput":{"content":"{\"name\":\"cursor-read-only-fixture\"}"}}}}}
+{"type":"emit_inbound","label":"tool.tsconfig.started","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"grok-replay-session-1","update":{"sessionUpdate":"tool_call","toolCallId":"read-tsconfig","title":"Read tsconfig.json","kind":"read","status":"pending","rawInput":{"path":"/tmp/claude-replay-tool_call_read_only/tsconfig.json"}}}}}
+{"type":"emit_inbound","label":"tool.tsconfig.completed","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"grok-replay-session-1","update":{"sessionUpdate":"tool_call_update","toolCallId":"read-tsconfig","status":"completed","rawOutput":{"content":"{\"compilerOptions\":{\"target\":\"ES2022\"}}"}}}}}
+{"type":"emit_inbound","label":"assistant.final","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"grok-replay-session-1","update":{"sessionUpdate":"agent_message_chunk","content":{"type":"text","text":"read only tool fixture complete"}}}}}
+{"type":"emit_inbound","label":"prompt.completed","frame":{"kind":"response","method":"session/prompt","result":{"stopReason":"end_turn"}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only/input.ts b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only/input.ts
new file mode 100644
index 000000000000..8559e5239f28
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only/input.ts
@@ -0,0 +1,7 @@
+import { TOOL_CALL_READ_ONLY_PROMPT, type OrchestratorFixtureInput } from "../shared.ts";
+
+export function toolCallReadOnlyInput(): OrchestratorFixtureInput {
+  return {
+    steps: [{ type: "message", text: TOOL_CALL_READ_ONLY_PROMPT }],
+  };
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only_on_request/claude_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only_on_request/claude_output.ts
new file mode 100644
index 000000000000..6bdf718ca022
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only_on_request/claude_output.ts
@@ -0,0 +1,50 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertAllRuntimeRequestsResolved,
+  assertBaseProjection,
+  assertReplayLabelPrefixCount,
+  assertRuntimeRequestCounts,
+  assertRuntimeRequestKinds,
+  assertSemanticProjectionIntegrity,
+  assertUserMessagesInclude,
+  assertVisibleTurnItemsMirrorLocalTurnItems,
+  projectionFor,
+  TOOL_CALL_WRITE_PROMPT,
+} from "../shared.ts";
+
+export function assertToolCallReadOnlyOnRequestClaudeOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({ result, transcript, runCount: 1, runStatuses: ["completed"] });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertVisibleTurnItemsMirrorLocalTurnItems(projection);
+  assertUserMessagesInclude(projection, [TOOL_CALL_WRITE_PROMPT]);
+  assertRuntimeRequestCounts(projection, { total: 1, resolved: 1 });
+  assertRuntimeRequestKinds(projection, ["command"]);
+  assertAllRuntimeRequestsResolved(projection);
+  assertReplayLabelPrefixCount(transcript, "permission.request:", 1);
+  assertReplayLabelPrefixCount(transcript, "permission.response:", 1);
+
+  assert.isAtLeast(
+    projection.turnItems.filter((i) => i.type === "command_execution" || i.type === "file_change")
+      .length,
+    1,
+    "Claude must project at least one concrete tool item",
+  );
+  assert.isAtLeast(
+    projection.turnItems.filter((item) => item.type === "approval_request").length,
+    1,
+    "Claude must project a V2 approval request for the permission callback",
+  );
+  assert.isAtLeast(
+    projection.turnItems.filter((item) => item.type === "assistant_message").length,
+    1,
+    "Claude must project the final assistant message",
+  );
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only_on_request/claude_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only_on_request/claude_transcript.ndjson
new file mode 100644
index 000000000000..033f08ff9ba4
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only_on_request/claude_transcript.ndjson
@@ -0,0 +1,15 @@
+{"type":"transcript_start","provider":"claudeAgent","protocol":"claude-agent-sdk.query","version":"0.2.111","scenario":"tool_call_read_only_on_request","metadata":{"prompts":["Create or overwrite .codex-probe-write-action.txt with exactly this text: codex app-server approval fixture. Use a local shell command or file edit only, then briefly report what happened. Do not read package metadata, use GitHub, use web, or use MCP."],"model":"claude-sonnet-4-6","nativeSessionId":"2b73817d-f7ab-41a7-a533-31b13b698b0d","queryMode":"streaming","tools":"claude_code","permissionMode":"default","enablePermissionCallback":true,"generatedBy":"recordClaudeAgentSdkReplayTranscript"}}
+{"type":"expect_outbound","label":"query.open","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":["Read","Glob","Grep"],"permissionMode":"default","allowedTools":["Read","Glob","Grep"],"sessionId":"2b73817d-f7ab-41a7-a533-31b13b698b0d"}}}
+{"type":"expect_outbound","label":"prompt.offer:1","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Create or overwrite .codex-probe-write-action.txt with exactly this text: codex app-server approval fixture. Use a local shell command or file edit only, then briefly report what happened. Do not read package metadata, use GitHub, use web, or use MCP."},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"ae3f0d68-becd-4b08-871b-f857a9ca1f90","hook_name":"SessionStart:startup","hook_event":"SessionStart","uuid":"1d299042-40fc-44af-8459-0a80baa7b7de","session_id":"2b73817d-f7ab-41a7-a533-31b13b698b0d"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"ae3f0d68-becd-4b08-871b-f857a9ca1f90","hook_name":"SessionStart:startup","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"5c410b64-6b03-49c4-9991-a8e624d0fe12","session_id":"2b73817d-f7ab-41a7-a533-31b13b698b0d"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.111","cwd":"/tmp/claude-replay-tool_call_read_only_on_request","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"default","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"c5dfaae5-ef85-4e12-8409-cc9351fd7210","session_id":"2b73817d-f7ab-41a7-a533-31b13b698b0d"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01RYtFxM6APgAoCYhiLedG4K","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"The user wants me to create or overwrite a file `.codex-probe-write-action.txt` with the exact text \"codex app-server approval fixture\". I'll use the Write tool to do this.","signature":"EuoCClsIDRgCKkClr6vi12d2VWDHyQI4PQ3CYaTuGSqke5KamWkoyt7GSszWGimltdaakn0h3D57BAMzZugqy2w6r5sxzVumSF+WMhFjbGF1ZGUtc29ubmV0LTQtNjgAEgx+g0cUWHR+Om1U0+0aDFf7COMwxRTyh5ltrCIwrLK4K+YAHJlq+V1ocE64ayjAFKrejgHNsqaAc1laYo6nwBSbGGTEL0A5qYF9yNl6KrwBBK2oZnFeIjkYKk31mNjrQ3ZdBKjHMrSa4PrqZWSTddS3rSDrFCAJPCewW5LUzy9lwI46DhHyK/b81RUao8cRd3YTpI3Bem4ze8hBoUJLGgm+BHTNC4wctLsZtacVMVJkpFozCCS/1slxj5WlzLKOarNfk299l86FD/VJpz7YxnQtYPUgaB+emkyWfjpk2Fy/RL1scue1gjBfuhQlaWZiy66XR/+6N221Xa6KtqAc6t+gSeeu3hYQ+7u+2PYYAQ=="}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":11844,"cache_read_input_tokens":0,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":11844},"output_tokens":6,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"2b73817d-f7ab-41a7-a533-31b13b698b0d","uuid":"b021382a-4ec3-4e73-906c-6449bc858477"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01RYtFxM6APgAoCYhiLedG4K","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01CUcXE2dtk9uUvh3LpAWzhK","name":"Bash","input":{"command":"printf 'codex app-server approval fixture' > .codex-probe-write-action.txt","description":"Write exact text to .codex-probe-write-action.txt"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":11844,"cache_read_input_tokens":0,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":11844},"output_tokens":6,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"2b73817d-f7ab-41a7-a533-31b13b698b0d","uuid":"4887439e-b0cd-4d24-88d7-b60dfc5268b0"}}
+{"type":"emit_inbound","label":"permission.request:Bash","frame":{"type":"permission.request","toolName":"Bash","input":{"command":"printf 'codex app-server approval fixture' > .codex-probe-write-action.txt","description":"Write exact text to .codex-probe-write-action.txt"},"options":{"suggestions":[{"type":"addDirectories","directories":["/private/var/folders/b3/b51_pdxj7dl0t981zpqkxxhr0000gn/T/t3-orchestrator-v2-claude-agent-sdk-record-tool_call_read_only_on_request-lW3JAE"],"destination":"session"}],"blockedPath":"/private/var/folders/b3/b51_pdxj7dl0t981zpqkxxhr0000gn/T/t3-orchestrator-v2-claude-agent-sdk-record-tool_call_read_only_on_request-lW3JAE/.codex-probe-write-action.txt","displayName":"Bash","toolUseID":"toolu_01CUcXE2dtk9uUvh3LpAWzhK"}}}
+{"type":"expect_outbound","label":"permission.response:Bash","frame":{"type":"permission.response","result":{"behavior":"allow","updatedInput":{"command":"printf 'codex app-server approval fixture' > .codex-probe-write-action.txt","description":"Write exact text to .codex-probe-write-action.txt"},"toolUseID":"toolu_01CUcXE2dtk9uUvh3LpAWzhK","decisionClassification":"user_temporary"}}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed"},"uuid":"f35e140f-d07e-4155-8500-21dadb554186","session_id":"2b73817d-f7ab-41a7-a533-31b13b698b0d"}}
+{"type":"emit_inbound","label":"user","frame":{"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01CUcXE2dtk9uUvh3LpAWzhK","type":"tool_result","content":"(Bash completed with no output)","is_error":false}]},"parent_tool_use_id":null,"session_id":"2b73817d-f7ab-41a7-a533-31b13b698b0d","uuid":"fc89ff85-b44d-4429-b85a-ccaf034bbcfc","timestamp":"2026-05-06T23:30:31.673Z","tool_use_result":{"stdout":"","stderr":"","interrupted":false,"isImage":false,"noOutputExpected":false}}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_011qF9hmJ6aS4YS2j41cqJhz","type":"message","role":"assistant","content":[{"type":"text","text":"Done. I used `printf` to write the exact text `codex app-server approval fixture` (no trailing newline) to `.codex-probe-write-action.txt` in the current working directory. The file was created (or overwritten if it already existed)."}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":1,"cache_creation_input_tokens":186,"cache_read_input_tokens":11844,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":186},"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"2b73817d-f7ab-41a7-a533-31b13b698b0d","uuid":"af0006d0-bdda-4ac7-9724-cc877f7a7931"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":6918,"duration_api_ms":6218,"num_turns":2,"result":"Done. I used `printf` to write the exact text `codex app-server approval fixture` (no trailing newline) to `.codex-probe-write-action.txt` in the current working directory. The file was created (or overwritten if it already existed).","stop_reason":"end_turn","session_id":"2b73817d-f7ab-41a7-a533-31b13b698b0d","total_cost_usd":0.052097700000000004,"usage":{"input_tokens":4,"cache_creation_input_tokens":12030,"cache_read_input_tokens":11844,"output_tokens":228,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":12030,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[{"input_tokens":1,"output_tokens":62,"cache_read_input_tokens":11844,"cache_creation_input_tokens":186,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":186},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":4,"outputTokens":228,"cacheReadInputTokens":11844,"cacheCreationInputTokens":12030,"webSearchRequests":0,"costUSD":0.052097700000000004,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"1b85e0c8-2cd3-44dc-b33a-4e084453cc9d"}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only_on_request/codex_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only_on_request/codex_output.ts
new file mode 100644
index 000000000000..74948d6931ea
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only_on_request/codex_output.ts
@@ -0,0 +1,36 @@
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertAllRuntimeRequestsResolved,
+  assertBaseProjection,
+  assertRuntimeRequestCounts,
+  assertRuntimeRequestKinds,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessagesInclude,
+  assertVisibleTurnItemsMirrorLocalTurnItems,
+  projectionFor,
+  TOOL_CALL_WRITE_PROMPT,
+} from "../shared.ts";
+
+export function assertToolCallReadOnlyOnRequestOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({ result, transcript, runCount: 1, runStatuses: ["completed"] });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertVisibleTurnItemsMirrorLocalTurnItems(projection);
+  assertTurnItemTypes(projection, [
+    "user_message",
+    "command_execution",
+    "approval_request",
+    "assistant_message",
+  ]);
+  assertRuntimeRequestCounts(projection, { total: 1, resolved: 1 });
+  assertRuntimeRequestKinds(projection, ["command"]);
+  assertAllRuntimeRequestsResolved(projection);
+  assertUserMessagesInclude(projection, [TOOL_CALL_WRITE_PROMPT]);
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only_on_request/codex_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only_on_request/codex_transcript.ndjson
new file mode 100644
index 000000000000..1146de01a071
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only_on_request/codex_transcript.ndjson
@@ -0,0 +1,65 @@
+{"type":"transcript_start","provider":"codex","protocol":"codex.app-server","version":"0.120.0","scenario":"tool_call_read_only_on_request","metadata":{"source":"codex-app-server-probe","fileName":"tool_call_read_only_on_request.ndjson","description":"Write a small probe file with read-only full filesystem visibility and on-request approvals."}}
+{"type":"expect_outbound","label":"initialize","frame":{"id":1,"method":"initialize","params":{"capabilities":{"experimentalApi":true},"clientInfo":{"name":"t3code_desktop","title":"T3 Code Desktop","version":"0.1.0"}}}}
+{"type":"emit_inbound","label":"initialize","frame":{"id":1,"result":{"userAgent":"t3code_desktop/0.120.0 (Mac OS 26.4.1; arm64) dumb (t3code_desktop; 0.1.0)","codexHome":"/Users/julius/.codex","platformFamily":"unix","platformOs":"macos"}}}
+{"type":"expect_outbound","label":"initialized","frame":{"method":"initialized"}}
+{"type":"expect_outbound","label":"thread/start","frame":{"id":2,"method":"thread/start","params":{}}}
+{"type":"emit_inbound","label":"thread/start","frame":{"id":2,"result":{"thread":{"id":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1776739376,"updatedAt":1776739376,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/04/20/rollout-2026-04-20T19-42-56-019dadeb-5cd0-76e1-910c-3effc0cc5e67.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","cliVersion":"0.120.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]},"model":"gpt-5.4","modelProvider":"openai","serviceTier":"fast","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","approvalPolicy":"on-request","approvalsReviewer":"user","sandbox":{"type":"workspaceWrite","writableRoots":["/Users/julius/.codex/memories"],"readOnlyAccess":{"type":"fullAccess"},"networkAccess":false,"excludeTmpdirEnvVar":false,"excludeSlashTmp":false},"reasoningEffort":"xhigh"}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":3,"method":"turn/start","params":{"approvalPolicy":"on-request","cwd":"<workspace>","input":[{"text":"Create or overwrite .codex-probe-write-action.txt with exactly this text: codex app-server approval fixture. Use a local shell command or file edit only, then briefly report what happened. Do not read package metadata, use GitHub, use web, or use MCP.","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"networkAccess":false,"type":"readOnly"},"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"thread/started","frame":{"method":"thread/started","params":{"thread":{"id":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1776739376,"updatedAt":1776739376,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/04/20/rollout-2026-04-20T19-42-56-019dadeb-5cd0-76e1-910c-3effc0cc5e67.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","cliVersion":"0.120.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]}}}}
+{"type":"emit_inbound","label":"deprecationNotice","frame":{"method":"deprecationNotice","params":{"summary":"`[features].collab` is deprecated. Use `[features].multi_agent` instead.","details":"Enable it with `--enable multi_agent` or `[features].multi_agent` in config.toml. See https://developers.openai.com/codex/config-basic#feature-flags for details."}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":3,"result":{"turn":{"id":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd","items":[],"status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turn":{"id":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd","items":[],"status":"inProgress","error":null,"startedAt":1776739376,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"2e670fd4-fe2c-4186-b5ec-2adf65fa4423","content":[{"type":"text","text":"Create or overwrite .codex-probe-write-action.txt with exactly this text: codex app-server approval fixture. Use a local shell command or file edit only, then briefly report what happened. Do not read package metadata, use GitHub, use web, or use MCP.","text_elements":[]}]},"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"2e670fd4-fe2c-4186-b5ec-2adf65fa4423","content":[{"type":"text","text":"Create or overwrite .codex-probe-write-action.txt with exactly this text: codex app-server approval fixture. Use a local shell command or file edit only, then briefly report what happened. Do not read package metadata, use GitHub, use web, or use MCP.","text_elements":[]}]},"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd"}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"reasoning","id":"rs_036b6500c9fbca5b0169e6e43488c481998992663af0a4d71f","summary":[],"content":[]},"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"reasoning","id":"rs_036b6500c9fbca5b0169e6e43488c481998992663af0a4d71f","summary":[],"content":[]},"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd"}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","status":{"type":"active","activeFlags":["waitingOnApproval"]}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"commandExecution","id":"call_amHJNIBwvjyYP8oLIY2jnZmZ","command":"/bin/zsh -lc \"printf '%s' 'codex app-server approval fixture' > .codex-probe-write-action.txt\"","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","processId":null,"source":"agent","status":"inProgress","commandActions":[{"type":"unknown","command":"printf '%s' 'codex app-server approval fixture' > .codex-probe-write-action.txt"}],"aggregatedOutput":null,"exitCode":null,"durationMs":null},"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd"}}}
+{"type":"emit_inbound","label":"item/commandExecution/requestApproval","frame":{"method":"item/commandExecution/requestApproval","id":0,"params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd","itemId":"call_amHJNIBwvjyYP8oLIY2jnZmZ","reason":"Allow creating or overwriting .codex-probe-write-action.txt in the current workspace?","command":"/bin/zsh -lc \"printf '%s' 'codex app-server approval fixture' > .codex-probe-write-action.txt\"","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","commandActions":[{"type":"unknown","command":"printf '%s' 'codex app-server approval fixture' > .codex-probe-write-action.txt"}],"proposedExecpolicyAmendment":["/bin/zsh","-lc","printf '%s' 'codex app-server approval fixture' > .codex-probe-write-action.txt"],"availableDecisions":["accept",{"acceptWithExecpolicyAmendment":{"execpolicy_amendment":["/bin/zsh","-lc","printf '%s' 'codex app-server approval fixture' > .codex-probe-write-action.txt"]}},"cancel"]}}}
+{"type":"expect_outbound","label":"item/commandExecution/requestApproval","frame":{"id":0,"result":{"decision":"accept"}}}
+{"type":"emit_inbound","label":"serverRequest/resolved","frame":{"method":"serverRequest/resolved","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","requestId":0}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd","tokenUsage":{"total":{"totalTokens":28807,"inputTokens":28169,"cachedInputTokens":21376,"outputTokens":638,"reasoningOutputTokens":516},"last":{"totalTokens":28807,"inputTokens":28169,"cachedInputTokens":21376,"outputTokens":638,"reasoningOutputTokens":516},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"commandExecution","id":"call_amHJNIBwvjyYP8oLIY2jnZmZ","command":"/bin/zsh -lc \"printf '%s' 'codex app-server approval fixture' > .codex-probe-write-action.txt\"","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","processId":"70053","source":"unifiedExecStartup","status":"completed","commandActions":[{"type":"unknown","command":"printf '%s' 'codex app-server approval fixture' > .codex-probe-write-action.txt"}],"aggregatedOutput":null,"exitCode":0,"durationMs":0},"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_036b6500c9fbca5b0169e6e43f90448199920abc1d46f9f832","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd","itemId":"msg_036b6500c9fbca5b0169e6e43f90448199920abc1d46f9f832","delta":"Created"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd","itemId":"msg_036b6500c9fbca5b0169e6e43f90448199920abc1d46f9f832","delta":"/"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd","itemId":"msg_036b6500c9fbca5b0169e6e43f90448199920abc1d46f9f832","delta":"over"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd","itemId":"msg_036b6500c9fbca5b0169e6e43f90448199920abc1d46f9f832","delta":"w"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd","itemId":"msg_036b6500c9fbca5b0169e6e43f90448199920abc1d46f9f832","delta":"rote"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd","itemId":"msg_036b6500c9fbca5b0169e6e43f90448199920abc1d46f9f832","delta":" `."}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd","itemId":"msg_036b6500c9fbca5b0169e6e43f90448199920abc1d46f9f832","delta":"cod"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd","itemId":"msg_036b6500c9fbca5b0169e6e43f90448199920abc1d46f9f832","delta":"ex"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd","itemId":"msg_036b6500c9fbca5b0169e6e43f90448199920abc1d46f9f832","delta":"-pro"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd","itemId":"msg_036b6500c9fbca5b0169e6e43f90448199920abc1d46f9f832","delta":"be"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd","itemId":"msg_036b6500c9fbca5b0169e6e43f90448199920abc1d46f9f832","delta":"-write"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd","itemId":"msg_036b6500c9fbca5b0169e6e43f90448199920abc1d46f9f832","delta":"-action"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd","itemId":"msg_036b6500c9fbca5b0169e6e43f90448199920abc1d46f9f832","delta":".txt"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd","itemId":"msg_036b6500c9fbca5b0169e6e43f90448199920abc1d46f9f832","delta":"`"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd","itemId":"msg_036b6500c9fbca5b0169e6e43f90448199920abc1d46f9f832","delta":" with"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd","itemId":"msg_036b6500c9fbca5b0169e6e43f90448199920abc1d46f9f832","delta":" exactly"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd","itemId":"msg_036b6500c9fbca5b0169e6e43f90448199920abc1d46f9f832","delta":":\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd","itemId":"msg_036b6500c9fbca5b0169e6e43f90448199920abc1d46f9f832","delta":"```"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd","itemId":"msg_036b6500c9fbca5b0169e6e43f90448199920abc1d46f9f832","delta":"text"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd","itemId":"msg_036b6500c9fbca5b0169e6e43f90448199920abc1d46f9f832","delta":"\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd","itemId":"msg_036b6500c9fbca5b0169e6e43f90448199920abc1d46f9f832","delta":"cod"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd","itemId":"msg_036b6500c9fbca5b0169e6e43f90448199920abc1d46f9f832","delta":"ex"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd","itemId":"msg_036b6500c9fbca5b0169e6e43f90448199920abc1d46f9f832","delta":" app"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd","itemId":"msg_036b6500c9fbca5b0169e6e43f90448199920abc1d46f9f832","delta":"-server"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd","itemId":"msg_036b6500c9fbca5b0169e6e43f90448199920abc1d46f9f832","delta":" approval"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd","itemId":"msg_036b6500c9fbca5b0169e6e43f90448199920abc1d46f9f832","delta":" fixture"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd","itemId":"msg_036b6500c9fbca5b0169e6e43f90448199920abc1d46f9f832","delta":"\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd","itemId":"msg_036b6500c9fbca5b0169e6e43f90448199920abc1d46f9f832","delta":"```"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_036b6500c9fbca5b0169e6e43f90448199920abc1d46f9f832","text":"Created/overwrote `.codex-probe-write-action.txt` with exactly:\n\n```text\ncodex app-server approval fixture\n```","phase":"final_answer","memoryCitation":null},"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turnId":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd","tokenUsage":{"total":{"totalTokens":57691,"inputTokens":57021,"cachedInputTokens":49408,"outputTokens":670,"reasoningOutputTokens":516},"last":{"totalTokens":28884,"inputTokens":28852,"cachedInputTokens":28032,"outputTokens":32,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019dadeb-5cd0-76e1-910c-3effc0cc5e67","turn":{"id":"019dadeb-5cdc-7932-a5cc-c15b0a5abacd","items":[],"status":"completed","error":null,"startedAt":1776739376,"completedAt":1776739391,"durationMs":15502}}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only_on_request/grok_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only_on_request/grok_transcript.ndjson
new file mode 100644
index 000000000000..b3d009f1281e
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only_on_request/grok_transcript.ndjson
@@ -0,0 +1,13 @@
+{"type":"transcript_start","provider":"grok","protocol":"acp.ndjson-jsonrpc","version":"1","scenario":"tool_call_read_only_on_request","metadata":{"generatedBy":"live-grok-shape-probe","nativeSessionId":"grok-replay-session-1"}}
+{"type":"expect_outbound","label":"initialize","frame":{"kind":"request","method":"initialize","params":{"protocolVersion":1,"clientCapabilities":{"fs":{"readTextFile":false,"writeTextFile":false},"terminal":false,"elicitation":{"form":{}}},"clientInfo":{"name":"t3-code","version":"0.0.0"}}}}
+{"type":"emit_inbound","label":"initialized","frame":{"kind":"response","method":"initialize","result":{"protocolVersion":1,"agentCapabilities":{"loadSession":true,"mcpCapabilities":{"http":true,"sse":true},"promptCapabilities":{"audio":false,"embeddedContext":true,"image":false}},"authMethods":[{"id":"replay","name":"Replay"}],"agentInfo":{"name":"grok-replay","version":"1"}}}}
+{"type":"expect_outbound","label":"session.new","frame":{"kind":"request","method":"session/new","params":{"cwd":"<workspace>","mcpServers":"<any>"}}}
+{"type":"emit_inbound","label":"session.created","frame":{"kind":"response","method":"session/new","result":{"sessionId":"grok-replay-session-1","models":{"currentModelId":"grok-build","availableModels":[{"modelId":"grok-build","name":"Grok Build"}]}}}}
+{"type":"expect_outbound","label":"session.prompt","frame":{"kind":"request","method":"session/prompt","params":{"sessionId":"grok-replay-session-1","prompt":[{"type":"text","text":"Create or overwrite .codex-probe-write-action.txt with exactly this text: codex app-server approval fixture. Use a local shell command or file edit only, then briefly report what happened. Do not read package metadata, use GitHub, use web, or use MCP."}]}}}
+{"type":"emit_inbound","label":"tool.started","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"grok-replay-session-1","update":{"sessionUpdate":"tool_call","toolCallId":"write-probe","title":"Write probe file","kind":"execute","status":"pending","rawInput":{"command":"printf fixture > .codex-probe-write-action.txt"}}}}}
+{"type":"emit_inbound","label":"permission.request","frame":{"kind":"request","method":"session/request_permission","params":{"sessionId":"grok-replay-session-1","toolCall":{"toolCallId":"write-probe","title":"Write probe file","kind":"execute","status":"pending","content":[{"type":"content","content":{"type":"text","text":"Write .codex-probe-write-action.txt"}}]},"options":[{"optionId":"allow-once","name":"Allow once","kind":"allow_once"},{"optionId":"allow-always","name":"Allow for session","kind":"allow_always"},{"optionId":"reject-once","name":"Reject","kind":"reject_once"}]}}}
+{"type":"expect_outbound","label":"permission.response","frame":{"kind":"response","method":"session/request_permission","result":{"outcome":{"outcome":"selected","optionId":"allow-once"}}}}
+{"type":"emit_inbound","label":"tool.completed","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"grok-replay-session-1","update":{"sessionUpdate":"tool_call_update","toolCallId":"write-probe","status":"completed","rawOutput":{"exitCode":0,"stdout":"","stderr":""}}}}}
+{"type":"emit_inbound","label":"assistant.final","frame":{"kind":"notification","method":"session/update","params":{"sessionId":"grok-replay-session-1","update":{"sessionUpdate":"agent_message_chunk","content":{"type":"text","text":"Created the requested probe file."}}}}}
+{"type":"emit_inbound","label":"prompt.completed","frame":{"kind":"response","method":"session/prompt","result":{"stopReason":"end_turn"}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only_on_request/input.ts b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only_on_request/input.ts
new file mode 100644
index 000000000000..5df27434a0a9
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_read_only_on_request/input.ts
@@ -0,0 +1,10 @@
+import { TOOL_CALL_WRITE_PROMPT, type OrchestratorFixtureInput } from "../shared.ts";
+
+export function toolCallReadOnlyOnRequestInput(): OrchestratorFixtureInput {
+  return {
+    steps: [
+      { type: "message", text: TOOL_CALL_WRITE_PROMPT },
+      { type: "approve_next_runtime_request" },
+    ],
+  };
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_restricted_granular/claude_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_restricted_granular/claude_output.ts
new file mode 100644
index 000000000000..b29b8f78e417
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_restricted_granular/claude_output.ts
@@ -0,0 +1,41 @@
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertAllRuntimeRequestsResolved,
+  assertAssistantTextIncludes,
+  assertBaseProjection,
+  assertReplayLabelPrefixCount,
+  assertRuntimeRequestCounts,
+  assertRuntimeRequestKinds,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessagesInclude,
+  assertVisibleTurnItemsMirrorLocalTurnItems,
+  projectionFor,
+  TOOL_CALL_WRITE_PROMPT,
+} from "../shared.ts";
+
+export function assertToolCallRestrictedGranularClaudeOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({ result, transcript, runCount: 1, runStatuses: ["completed"] });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertVisibleTurnItemsMirrorLocalTurnItems(projection);
+  assertTurnItemTypes(projection, [
+    "user_message",
+    "command_execution",
+    "approval_request",
+    "assistant_message",
+  ]);
+  assertUserMessagesInclude(projection, [TOOL_CALL_WRITE_PROMPT]);
+  assertAssistantTextIncludes(projection, "codex app-server approval fixture");
+  assertRuntimeRequestCounts(projection, { total: 1, resolved: 1 });
+  assertRuntimeRequestKinds(projection, ["command"]);
+  assertAllRuntimeRequestsResolved(projection);
+  assertReplayLabelPrefixCount(transcript, "permission.request:", 1);
+  assertReplayLabelPrefixCount(transcript, "permission.response:", 1);
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_restricted_granular/claude_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_restricted_granular/claude_transcript.ndjson
new file mode 100644
index 000000000000..abd246cea4e1
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_restricted_granular/claude_transcript.ndjson
@@ -0,0 +1,15 @@
+{"type":"transcript_start","provider":"claudeAgent","protocol":"claude-agent-sdk.query","version":"0.2.111","scenario":"tool_call_restricted_granular","metadata":{"prompts":["Create or overwrite .codex-probe-write-action.txt with exactly this text: codex app-server approval fixture. Use a local shell command or file edit only, then briefly report what happened. Do not read package metadata, use GitHub, use web, or use MCP."],"model":"claude-sonnet-4-6","nativeSessionId":"ffd3df75-f3cf-433d-bb67-1dd1e9db316b","queryMode":"streaming","tools":"claude_code","permissionMode":"default","enablePermissionCallback":true,"generatedBy":"recordClaudeAgentSdkReplayTranscript"}}
+{"type":"expect_outbound","label":"query.open","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":["Read","Glob","Grep"],"permissionMode":"default","sessionId":"ffd3df75-f3cf-433d-bb67-1dd1e9db316b"}}}
+{"type":"expect_outbound","label":"prompt.offer:1","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Create or overwrite .codex-probe-write-action.txt with exactly this text: codex app-server approval fixture. Use a local shell command or file edit only, then briefly report what happened. Do not read package metadata, use GitHub, use web, or use MCP."},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"ba333d12-6a9a-4a5e-9cb5-2d6ce18cd0f8","hook_name":"SessionStart:startup","hook_event":"SessionStart","uuid":"544c0cee-2195-49a9-ab30-088c3d3d5e83","session_id":"ffd3df75-f3cf-433d-bb67-1dd1e9db316b"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"ba333d12-6a9a-4a5e-9cb5-2d6ce18cd0f8","hook_name":"SessionStart:startup","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"09419836-e234-4231-a15d-927acb1fbdb1","session_id":"ffd3df75-f3cf-433d-bb67-1dd1e9db316b"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.111","cwd":"/tmp/claude-replay-tool_call_restricted_granular","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"default","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"cc4bb931-a9d3-4819-8d00-58e00c2d81fe","session_id":"ffd3df75-f3cf-433d-bb67-1dd1e9db316b"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01DbHDhWivNDrjU961RBEG9p","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"The user wants me to create or overwrite a file called `.codex-probe-write-action.txt` with exactly the text \"codex app-server approval fixture\". I'll use the Write tool to do this.","signature":"EvMCClsIDRgCKkA0ya25b0YOVTPetE8tyofNk75/KAu2bOCsI5OuAA4QGPrPmQrwANVZrxU3sm28pCyXwwS/QRHWvKNw8o8ewFfBMhFjbGF1ZGUtc29ubmV0LTQtNjgAEgyBNStUvXa2J+3E/YgaDKD5vB/dvuXfFaB9QyIwVs4Dk5D21dBC5+DbUFpY60RQMafxcmSkL4Li3yVljtNzv4Xu6r3hwy4j8Vx+hKNPKsUBnZzPx9BrnInN42xNoQMW/Gmx6yn1jD02wnol96oqWWPuM1jaAtPD92I2Fq2h64yWC0SCX3+mYDjYSo3jN/K/++w5+d8YZ1ciglXFPCjJ/dbD8ZcA5MGjNuUEVerGqaO8MAmai7v7NzMgf2mGggZJBll7rLYDFo/d5tNBcEKsM5lqRBqwKaXxiNmNGWHv5e3x04cwLUVUD9VCxjhFoh9td5K737EuLDu43StHlqHLNsH1JJ3ipZR9wPrYQ7ZIfdTjt8cpb58YAQ=="}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":2389,"cache_read_input_tokens":9455,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2389},"output_tokens":8,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"ffd3df75-f3cf-433d-bb67-1dd1e9db316b","uuid":"5404910b-43e2-4261-a599-428eece3b4ed"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01DbHDhWivNDrjU961RBEG9p","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01Ayxc73fyGSj2frmw8XLmJn","name":"Bash","input":{"command":"printf 'codex app-server approval fixture' > .codex-probe-write-action.txt","description":"Write exact text to .codex-probe-write-action.txt"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":2389,"cache_read_input_tokens":9455,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2389},"output_tokens":8,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"ffd3df75-f3cf-433d-bb67-1dd1e9db316b","uuid":"bd8a3c7b-706b-4833-a859-2914fe94da80"}}
+{"type":"emit_inbound","label":"permission.request:Bash","frame":{"type":"permission.request","toolName":"Bash","input":{"command":"printf 'codex app-server approval fixture' > .codex-probe-write-action.txt","description":"Write exact text to .codex-probe-write-action.txt"},"options":{"suggestions":[{"type":"addDirectories","directories":["/private/var/folders/b3/b51_pdxj7dl0t981zpqkxxhr0000gn/T/t3-orchestrator-v2-claude-agent-sdk-record-tool_call_restricted_granular-6FUxAp"],"destination":"session"}],"blockedPath":"/private/var/folders/b3/b51_pdxj7dl0t981zpqkxxhr0000gn/T/t3-orchestrator-v2-claude-agent-sdk-record-tool_call_restricted_granular-6FUxAp/.codex-probe-write-action.txt","displayName":"Bash","toolUseID":"toolu_01Ayxc73fyGSj2frmw8XLmJn"}}}
+{"type":"expect_outbound","label":"permission.response:Bash","frame":{"type":"permission.response","result":{"behavior":"allow","updatedInput":{"command":"printf 'codex app-server approval fixture' > .codex-probe-write-action.txt","description":"Write exact text to .codex-probe-write-action.txt"},"toolUseID":"toolu_01Ayxc73fyGSj2frmw8XLmJn","decisionClassification":"user_temporary"}}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed"},"uuid":"a2b5e849-0d78-45f9-9b80-3c8e81949adb","session_id":"ffd3df75-f3cf-433d-bb67-1dd1e9db316b"}}
+{"type":"emit_inbound","label":"user","frame":{"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01Ayxc73fyGSj2frmw8XLmJn","type":"tool_result","content":"(Bash completed with no output)","is_error":false}]},"parent_tool_use_id":null,"session_id":"ffd3df75-f3cf-433d-bb67-1dd1e9db316b","uuid":"35e1a0cd-5946-4b13-b8c8-ae65f859c447","timestamp":"2026-05-07T01:41:04.458Z","tool_use_result":{"stdout":"","stderr":"","interrupted":false,"isImage":false,"noOutputExpected":false}}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_014BHCrtTfAbEdhQ3oBkZUAZ","type":"message","role":"assistant","content":[{"type":"text","text":"Done. The file `.codex-probe-write-action.txt` was created (or overwritten) in the current directory with the exact content `codex app-server approval fixture` — no trailing newline, no extra characters."}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":1,"cache_creation_input_tokens":187,"cache_read_input_tokens":11844,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":187},"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"ffd3df75-f3cf-433d-bb67-1dd1e9db316b","uuid":"ea75d6df-7f51-4d9b-ae74-c6e0fbf1d3f6"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":6064,"duration_api_ms":5641,"num_turns":2,"result":"Done. The file `.codex-probe-write-action.txt` was created (or overwritten) in the current directory with the exact content `codex app-server approval fixture` — no trailing newline, no extra characters.","stop_reason":"end_turn","session_id":"ffd3df75-f3cf-433d-bb67-1dd1e9db316b","total_cost_usd":0.0193617,"usage":{"input_tokens":4,"cache_creation_input_tokens":2576,"cache_read_input_tokens":21299,"output_tokens":220,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":2576,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[{"input_tokens":1,"output_tokens":53,"cache_read_input_tokens":11844,"cache_creation_input_tokens":187,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":187},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":4,"outputTokens":220,"cacheReadInputTokens":21299,"cacheCreationInputTokens":2576,"webSearchRequests":0,"costUSD":0.0193617,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"11c4a92a-677b-4caf-b7bf-4d0f1d5f7c08"}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_restricted_granular/codex_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_restricted_granular/codex_output.ts
new file mode 100644
index 000000000000..7217f4005c10
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_restricted_granular/codex_output.ts
@@ -0,0 +1,37 @@
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertAllRuntimeRequestsResolved,
+  assertBaseProjection,
+  assertRuntimeRequestCounts,
+  assertRuntimeRequestKinds,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessagesInclude,
+  assertVisibleTurnItemsMirrorLocalTurnItems,
+  projectionFor,
+  TOOL_CALL_WRITE_PROMPT,
+} from "../shared.ts";
+
+export function assertToolCallRestrictedGranularOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({ result, transcript, runCount: 1, runStatuses: ["completed"] });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertVisibleTurnItemsMirrorLocalTurnItems(projection);
+  assertTurnItemTypes(projection, [
+    "user_message",
+    "command_execution",
+    "file_change",
+    "approval_request",
+    "assistant_message",
+  ]);
+  assertRuntimeRequestCounts(projection, { total: 1, resolved: 1 });
+  assertRuntimeRequestKinds(projection, ["file-change"]);
+  assertAllRuntimeRequestsResolved(projection);
+  assertUserMessagesInclude(projection, [TOOL_CALL_WRITE_PROMPT]);
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_restricted_granular/codex_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_restricted_granular/codex_transcript.ndjson
new file mode 100644
index 000000000000..8f767ad6bd5f
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_restricted_granular/codex_transcript.ndjson
@@ -0,0 +1,137 @@
+{"type":"transcript_start","provider":"codex","protocol":"codex.app-server","version":"0.120.0","scenario":"tool_call_restricted_granular","metadata":{"source":"codex-app-server-probe","fileName":"tool_call_restricted_granular.ndjson","description":"Write a small probe file with restricted read access and granular approval flags enabled."}}
+{"type":"expect_outbound","label":"initialize","frame":{"id":1,"method":"initialize","params":{"capabilities":{"experimentalApi":true},"clientInfo":{"name":"t3code_desktop","title":"T3 Code Desktop","version":"0.1.0"}}}}
+{"type":"emit_inbound","label":"initialize","frame":{"id":1,"result":{"userAgent":"t3code_desktop/0.120.0 (Mac OS 26.4.1; arm64) dumb (t3code_desktop; 0.1.0)","codexHome":"/Users/julius/.codex","platformFamily":"unix","platformOs":"macos"}}}
+{"type":"expect_outbound","label":"initialized","frame":{"method":"initialized"}}
+{"type":"expect_outbound","label":"thread/start","frame":{"id":2,"method":"thread/start","params":{}}}
+{"type":"emit_inbound","label":"thread/start","frame":{"id":2,"result":{"thread":{"id":"019dadeb-c0d3-7331-8353-a710f2912df3","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1776739401,"updatedAt":1776739401,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/04/20/rollout-2026-04-20T19-43-21-019dadeb-c0d3-7331-8353-a710f2912df3.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","cliVersion":"0.120.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]},"model":"gpt-5.4","modelProvider":"openai","serviceTier":"fast","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","approvalPolicy":"on-request","approvalsReviewer":"user","sandbox":{"type":"workspaceWrite","writableRoots":["/Users/julius/.codex/memories"],"readOnlyAccess":{"type":"fullAccess"},"networkAccess":false,"excludeTmpdirEnvVar":false,"excludeSlashTmp":false},"reasoningEffort":"xhigh"}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":3,"method":"turn/start","params":{"approvalPolicy":{"granular":{"mcp_elicitations":true,"request_permissions":true,"rules":true,"sandbox_approval":true,"skill_approval":true}},"cwd":"<workspace>","input":[{"text":"Create or overwrite .codex-probe-write-action.txt with exactly this text: codex app-server approval fixture. Use a local shell command or file edit only, then briefly report what happened. Do not read package metadata, use GitHub, use web, or use MCP.","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"networkAccess":false,"type":"readOnly"},"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"thread/started","frame":{"method":"thread/started","params":{"thread":{"id":"019dadeb-c0d3-7331-8353-a710f2912df3","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1776739401,"updatedAt":1776739401,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/04/20/rollout-2026-04-20T19-43-21-019dadeb-c0d3-7331-8353-a710f2912df3.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","cliVersion":"0.120.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]}}}}
+{"type":"emit_inbound","label":"deprecationNotice","frame":{"method":"deprecationNotice","params":{"summary":"`[features].collab` is deprecated. Use `[features].multi_agent` instead.","details":"Enable it with `--enable multi_agent` or `[features].multi_agent` in config.toml. See https://developers.openai.com/codex/config-basic#feature-flags for details."}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":3,"result":{"turn":{"id":"019dadeb-c0de-7803-b8fc-a791b566ced6","items":[],"status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turn":{"id":"019dadeb-c0de-7803-b8fc-a791b566ced6","items":[],"status":"inProgress","error":null,"startedAt":1776739401,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"e43e205e-f22b-4ab0-9b88-69b41f7fec16","content":[{"type":"text","text":"Create or overwrite .codex-probe-write-action.txt with exactly this text: codex app-server approval fixture. Use a local shell command or file edit only, then briefly report what happened. Do not read package metadata, use GitHub, use web, or use MCP.","text_elements":[]}]},"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"e43e205e-f22b-4ab0-9b88-69b41f7fec16","content":[{"type":"text","text":"Create or overwrite .codex-probe-write-action.txt with exactly this text: codex app-server approval fixture. Use a local shell command or file edit only, then briefly report what happened. Do not read package metadata, use GitHub, use web, or use MCP.","text_elements":[]}]},"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6"}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"reasoning","id":"rs_068036a3123897970169e6e44e641c819abe2c74de8be2df7c","summary":[],"content":[]},"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"reasoning","id":"rs_068036a3123897970169e6e44e641c819abe2c74de8be2df7c","summary":[],"content":[]},"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_068036a3123897970169e6e452cf78819a87cbdc7d3da1631f","text":"","phase":"commentary","memoryCitation":null},"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e452cf78819a87cbdc7d3da1631f","delta":"Writing"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e452cf78819a87cbdc7d3da1631f","delta":" the"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e452cf78819a87cbdc7d3da1631f","delta":" fixture"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e452cf78819a87cbdc7d3da1631f","delta":" file"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e452cf78819a87cbdc7d3da1631f","delta":" now"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e452cf78819a87cbdc7d3da1631f","delta":" with"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e452cf78819a87cbdc7d3da1631f","delta":" a"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e452cf78819a87cbdc7d3da1631f","delta":" single"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e452cf78819a87cbdc7d3da1631f","delta":" local"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e452cf78819a87cbdc7d3da1631f","delta":" shell"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e452cf78819a87cbdc7d3da1631f","delta":" command"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e452cf78819a87cbdc7d3da1631f","delta":"."}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_068036a3123897970169e6e452cf78819a87cbdc7d3da1631f","text":"Writing the fixture file now with a single local shell command.","phase":"commentary","memoryCitation":null},"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","tokenUsage":{"total":{"totalTokens":27988,"inputTokens":27471,"cachedInputTokens":21376,"outputTokens":517,"reasoningOutputTokens":400},"last":{"totalTokens":27988,"inputTokens":27471,"cachedInputTokens":21376,"outputTokens":517,"reasoningOutputTokens":400},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"reasoning","id":"rs_068036a3123897970169e6e4549b5c819aaf17f9850caeee02","summary":[],"content":[]},"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"reasoning","id":"rs_068036a3123897970169e6e4549b5c819aaf17f9850caeee02","summary":[],"content":[]},"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","tokenUsage":{"total":{"totalTokens":56381,"inputTokens":55562,"cachedInputTokens":48384,"outputTokens":819,"reasoningOutputTokens":648},"last":{"totalTokens":28393,"inputTokens":28091,"cachedInputTokens":27008,"outputTokens":302,"reasoningOutputTokens":248},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"commandExecution","id":"call_Ldr19xmcSmrCDZPWOU281hio","command":"/bin/zsh -lc \"printf '%s' 'codex app-server approval fixture' > .codex-probe-write-action.txt\"","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","processId":"67342","source":"unifiedExecStartup","status":"inProgress","commandActions":[{"type":"unknown","command":"printf '%s' 'codex app-server approval fixture' > .codex-probe-write-action.txt"}],"aggregatedOutput":null,"exitCode":null,"durationMs":null},"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"commandExecution","id":"call_Ldr19xmcSmrCDZPWOU281hio","command":"/bin/zsh -lc \"printf '%s' 'codex app-server approval fixture' > .codex-probe-write-action.txt\"","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","processId":"67342","source":"unifiedExecStartup","status":"failed","commandActions":[{"type":"unknown","command":"printf '%s' 'codex app-server approval fixture' > .codex-probe-write-action.txt"}],"aggregatedOutput":null,"exitCode":-1,"durationMs":0},"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"reasoning","id":"rs_068036a3123897970169e6e45a524c819a89b5d0e20d23b4b2","summary":[],"content":[]},"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"reasoning","id":"rs_068036a3123897970169e6e45a524c819a89b5d0e20d23b4b2","summary":[],"content":[]},"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_068036a3123897970169e6e45b9ea8819aa4ca6c7150b75e02","text":"","phase":"commentary","memoryCitation":null},"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e45b9ea8819aa4ca6c7150b75e02","delta":"The"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e45b9ea8819aa4ca6c7150b75e02","delta":" sandbox"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e45b9ea8819aa4ca6c7150b75e02","delta":" rejected"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e45b9ea8819aa4ca6c7150b75e02","delta":" the"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e45b9ea8819aa4ca6c7150b75e02","delta":" shell"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e45b9ea8819aa4ca6c7150b75e02","delta":" write"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e45b9ea8819aa4ca6c7150b75e02","delta":" without"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e45b9ea8819aa4ca6c7150b75e02","delta":" producing"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e45b9ea8819aa4ca6c7150b75e02","delta":" a"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e45b9ea8819aa4ca6c7150b75e02","delta":" diagnostic"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e45b9ea8819aa4ca6c7150b75e02","delta":"."}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e45b9ea8819aa4ca6c7150b75e02","delta":" I"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e45b9ea8819aa4ca6c7150b75e02","delta":"’m"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e45b9ea8819aa4ca6c7150b75e02","delta":" switching"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e45b9ea8819aa4ca6c7150b75e02","delta":" to"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e45b9ea8819aa4ca6c7150b75e02","delta":" the"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e45b9ea8819aa4ca6c7150b75e02","delta":" file"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e45b9ea8819aa4ca6c7150b75e02","delta":"-edit"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e45b9ea8819aa4ca6c7150b75e02","delta":" tool"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e45b9ea8819aa4ca6c7150b75e02","delta":" for"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e45b9ea8819aa4ca6c7150b75e02","delta":" the"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e45b9ea8819aa4ca6c7150b75e02","delta":" same"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e45b9ea8819aa4ca6c7150b75e02","delta":" single"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e45b9ea8819aa4ca6c7150b75e02","delta":"-file"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e45b9ea8819aa4ca6c7150b75e02","delta":" change"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e45b9ea8819aa4ca6c7150b75e02","delta":"."}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_068036a3123897970169e6e45b9ea8819aa4ca6c7150b75e02","text":"The sandbox rejected the shell write without producing a diagnostic. I’m switching to the file-edit tool for the same single-file change.","phase":"commentary","memoryCitation":null},"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"fileChange","id":"call_CjSAZQlgh7pnYe8dEL4Ri8Q5","changes":[{"path":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server/.codex-probe-write-action.txt","kind":{"type":"add"},"diff":"codex app-server approval fixture\n"}],"status":"inProgress"},"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6"}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","status":{"type":"active","activeFlags":["waitingOnApproval"]}}}}
+{"type":"emit_inbound","label":"item/fileChange/requestApproval","frame":{"method":"item/fileChange/requestApproval","id":0,"params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"call_CjSAZQlgh7pnYe8dEL4Ri8Q5","reason":null,"grantRoot":null}}}
+{"type":"expect_outbound","label":"item/fileChange/requestApproval","frame":{"id":0,"result":{"decision":"accept"}}}
+{"type":"emit_inbound","label":"serverRequest/resolved","frame":{"method":"serverRequest/resolved","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","requestId":0}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"item/fileChange/outputDelta","frame":{"method":"item/fileChange/outputDelta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"call_CjSAZQlgh7pnYe8dEL4Ri8Q5","delta":"sandbox-exec: execvp() of '/opt/homebrew/bin/codex' failed: Operation not permitted\n"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","tokenUsage":{"total":{"totalTokens":84983,"inputTokens":84000,"cachedInputTokens":76416,"outputTokens":983,"reasoningOutputTokens":737},"last":{"totalTokens":28602,"inputTokens":28438,"cachedInputTokens":28032,"outputTokens":164,"reasoningOutputTokens":89},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/fileChange/outputDelta","frame":{"method":"item/fileChange/outputDelta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"call_CjSAZQlgh7pnYe8dEL4Ri8Q5","delta":"Success. Updated the following files:\nA .codex-probe-write-action.txt\n"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"fileChange","id":"call_CjSAZQlgh7pnYe8dEL4Ri8Q5","changes":[{"path":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server/.codex-probe-write-action.txt","kind":{"type":"add"},"diff":"codex app-server approval fixture\n"}],"status":"completed"},"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6"}}}
+{"type":"emit_inbound","label":"turn/diff/updated","frame":{"method":"turn/diff/updated","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","diff":"diff --git a/packages/effect-codex-app-server/.codex-probe-write-action.txt b/packages/effect-codex-app-server/.codex-probe-write-action.txt\nindex e268d360687fcf05587151030b12bd2f96437cf7..6e495a5a1d7e41515ba0968b0f65b3675bfb0a01\n--- a/packages/effect-codex-app-server/.codex-probe-write-action.txt\n+++ b/packages/effect-codex-app-server/.codex-probe-write-action.txt\n@@ -1 +1 @@\n-codex app-server approval fixture\n\\ No newline at end of file\n+codex app-server approval fixture\n"}}}
+{"type":"emit_inbound","label":"turn/diff/updated","frame":{"method":"turn/diff/updated","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","diff":"diff --git a/packages/effect-codex-app-server/.codex-probe-write-action.txt b/packages/effect-codex-app-server/.codex-probe-write-action.txt\nindex e268d360687fcf05587151030b12bd2f96437cf7..6e495a5a1d7e41515ba0968b0f65b3675bfb0a01\n--- a/packages/effect-codex-app-server/.codex-probe-write-action.txt\n+++ b/packages/effect-codex-app-server/.codex-probe-write-action.txt\n@@ -1 +1 @@\n-codex app-server approval fixture\n\\ No newline at end of file\n+codex app-server approval fixture\n"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"reasoning","id":"rs_068036a3123897970169e6e45df0f4819ab4d2890641352e6b","summary":[],"content":[]},"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"reasoning","id":"rs_068036a3123897970169e6e45df0f4819ab4d2890641352e6b","summary":[],"content":[]},"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","tokenUsage":{"total":{"totalTokens":114190,"inputTokens":112645,"cachedInputTokens":104448,"outputTokens":1545,"reasoningOutputTokens":1253},"last":{"totalTokens":29207,"inputTokens":28645,"cachedInputTokens":28032,"outputTokens":562,"reasoningOutputTokens":516},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"commandExecution","id":"call_3CTnF0RRhAPV1UmQxnNl9F1T","command":"/bin/zsh -lc 'truncate -s -1 .codex-probe-write-action.txt'","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","processId":"81884","source":"unifiedExecStartup","status":"inProgress","commandActions":[{"type":"unknown","command":"truncate -s -1 .codex-probe-write-action.txt"}],"aggregatedOutput":null,"exitCode":null,"durationMs":null},"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"commandExecution","id":"call_3CTnF0RRhAPV1UmQxnNl9F1T","command":"/bin/zsh -lc 'truncate -s -1 .codex-probe-write-action.txt'","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","processId":"81884","source":"unifiedExecStartup","status":"failed","commandActions":[{"type":"unknown","command":"truncate -s -1 .codex-probe-write-action.txt"}],"aggregatedOutput":null,"exitCode":-1,"durationMs":0},"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6"}}}
+{"type":"emit_inbound","label":"turn/diff/updated","frame":{"method":"turn/diff/updated","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","diff":"diff --git a/packages/effect-codex-app-server/.codex-probe-write-action.txt b/packages/effect-codex-app-server/.codex-probe-write-action.txt\nindex e268d360687fcf05587151030b12bd2f96437cf7..6e495a5a1d7e41515ba0968b0f65b3675bfb0a01\n--- a/packages/effect-codex-app-server/.codex-probe-write-action.txt\n+++ b/packages/effect-codex-app-server/.codex-probe-write-action.txt\n@@ -1 +1 @@\n-codex app-server approval fixture\n\\ No newline at end of file\n+codex app-server approval fixture\n"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"reasoning","id":"rs_068036a3123897970169e6e465c344819aae78ff3d9f491306","summary":[],"content":[]},"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"reasoning","id":"rs_068036a3123897970169e6e465c344819aae78ff3d9f491306","summary":[],"content":[]},"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","delta":"Created"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","delta":" `."}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","delta":"cod"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","delta":"ex"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","delta":"-pro"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","delta":"be"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","delta":"-write"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","delta":"-action"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","delta":".txt"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","delta":"`"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","delta":" with"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","delta":" the"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","delta":" requested"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","delta":" text"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","delta":" using"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","delta":" a"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","delta":" local"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","delta":" file"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","delta":" edit"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","delta":"."}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","delta":" No"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","delta":" Git"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","delta":"Hub"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","delta":","}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","delta":" web"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","delta":","}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","delta":" MCP"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","delta":","}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","delta":" or"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","delta":" package"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","delta":" metadata"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","delta":" access"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","delta":" used"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","itemId":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","delta":"."}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_068036a3123897970169e6e46cc118819ab235e4613b1adcbb","text":"Created `.codex-probe-write-action.txt` with the requested text using a local file edit. No GitHub, web, MCP, or package metadata access used.","phase":"final_answer","memoryCitation":null},"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","tokenUsage":{"total":{"totalTokens":143998,"inputTokens":141897,"cachedInputTokens":132992,"outputTokens":2101,"reasoningOutputTokens":1769},"last":{"totalTokens":29808,"inputTokens":29252,"cachedInputTokens":28544,"outputTokens":556,"reasoningOutputTokens":516},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"turn/diff/updated","frame":{"method":"turn/diff/updated","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turnId":"019dadeb-c0de-7803-b8fc-a791b566ced6","diff":"diff --git a/packages/effect-codex-app-server/.codex-probe-write-action.txt b/packages/effect-codex-app-server/.codex-probe-write-action.txt\nindex e268d360687fcf05587151030b12bd2f96437cf7..6e495a5a1d7e41515ba0968b0f65b3675bfb0a01\n--- a/packages/effect-codex-app-server/.codex-probe-write-action.txt\n+++ b/packages/effect-codex-app-server/.codex-probe-write-action.txt\n@@ -1 +1 @@\n-codex app-server approval fixture\n\\ No newline at end of file\n+codex app-server approval fixture\n"}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019dadeb-c0d3-7331-8353-a710f2912df3","turn":{"id":"019dadeb-c0de-7803-b8fc-a791b566ced6","items":[],"status":"completed","error":null,"startedAt":1776739401,"completedAt":1776739437,"durationMs":35380}}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_restricted_granular/input.ts b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_restricted_granular/input.ts
new file mode 100644
index 000000000000..f6c14cd94b4d
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_restricted_granular/input.ts
@@ -0,0 +1,10 @@
+import { TOOL_CALL_WRITE_PROMPT, type OrchestratorFixtureInput } from "../shared.ts";
+
+export function toolCallRestrictedGranularInput(): OrchestratorFixtureInput {
+  return {
+    steps: [
+      { type: "message", text: TOOL_CALL_WRITE_PROMPT },
+      { type: "approve_next_runtime_request" },
+    ],
+  };
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_workspace_never/claude_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_workspace_never/claude_output.ts
new file mode 100644
index 000000000000..55cd22cec329
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_workspace_never/claude_output.ts
@@ -0,0 +1,34 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertAssistantTextIncludes,
+  assertBaseProjection,
+  assertReplayLabelPrefixCount,
+  assertRuntimeRequestCounts,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessagesInclude,
+  assertVisibleTurnItemsMirrorLocalTurnItems,
+  projectionFor,
+  TOOL_CALL_WRITE_PROMPT,
+} from "../shared.ts";
+
+export function assertToolCallWorkspaceNeverClaudeOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({ result, transcript, runCount: 1, runStatuses: ["completed"] });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertVisibleTurnItemsMirrorLocalTurnItems(projection);
+  assertTurnItemTypes(projection, ["user_message", "command_execution", "assistant_message"]);
+  assertUserMessagesInclude(projection, [TOOL_CALL_WRITE_PROMPT]);
+  assertAssistantTextIncludes(projection, "codex app-server approval fixture");
+  assertRuntimeRequestCounts(projection, { total: 0 });
+  assert.equal(projection.turnItems.filter((item) => item.type === "approval_request").length, 0);
+  assertReplayLabelPrefixCount(transcript, "permission.request:", 0);
+  assertReplayLabelPrefixCount(transcript, "permission.response:", 0);
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_workspace_never/claude_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_workspace_never/claude_transcript.ndjson
new file mode 100644
index 000000000000..9b7288fae65f
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_workspace_never/claude_transcript.ndjson
@@ -0,0 +1,13 @@
+{"type":"transcript_start","provider":"claudeAgent","protocol":"claude-agent-sdk.query","version":"0.2.111","scenario":"tool_call_workspace_never","metadata":{"prompts":["Create or overwrite .codex-probe-write-action.txt with exactly this text: codex app-server approval fixture. Use a local shell command or file edit only, then briefly report what happened. Do not read package metadata, use GitHub, use web, or use MCP."],"model":"claude-sonnet-4-6","nativeSessionId":"d5a53b77-f5e5-4b4b-b387-65392391e9c9","queryMode":"streaming","tools":"claude_code","permissionMode":"bypassPermissions","generatedBy":"recordClaudeAgentSdkReplayTranscript"}}
+{"type":"expect_outbound","label":"query.open","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"sessionId":"d5a53b77-f5e5-4b4b-b387-65392391e9c9"}}}
+{"type":"expect_outbound","label":"prompt.offer:1","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Create or overwrite .codex-probe-write-action.txt with exactly this text: codex app-server approval fixture. Use a local shell command or file edit only, then briefly report what happened. Do not read package metadata, use GitHub, use web, or use MCP."},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"7c9c2603-f09a-4200-93a0-3b5a2d9f7b7d","hook_name":"SessionStart:startup","hook_event":"SessionStart","uuid":"b8818ae6-b7d3-4d82-b22d-4c93a4ca297e","session_id":"d5a53b77-f5e5-4b4b-b387-65392391e9c9"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"7c9c2603-f09a-4200-93a0-3b5a2d9f7b7d","hook_name":"SessionStart:startup","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"cfb9d36b-2b7d-4e20-a097-a6435b424cb2","session_id":"d5a53b77-f5e5-4b4b-b387-65392391e9c9"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.111","cwd":"/tmp/claude-replay-tool_call_workspace_never","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"f27f371a-cb8f-4b65-a45c-b6140b83de93","session_id":"d5a53b77-f5e5-4b4b-b387-65392391e9c9"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01GQZgjX6VSrRs4s66TgykJA","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"The user wants me to create or overwrite a file called `.codex-probe-write-action.txt` with exactly the text \"codex app-server approval fixture\". I'll use the Write tool to do this.","signature":"EvMCClsIDRgCKkA0ya25b0YOVTPetE8tyofNk75/KAu2bOCsI5OuAA4QGPrPmQrwANVZrxU3sm28pCyXwwS/QRHWvKNw8o8ewFfBMhFjbGF1ZGUtc29ubmV0LTQtNjgAEgxmiLI12jaPlA5zzlEaDHaQPVLmpq9Et6BpmSIwpM8rayY3bPZo77J1XMmGDz5TVtFpYEUI30e7ErnsceW5jPAqqBsIibR3TpEOJmGeKsUBwuMobTb4l172BeZhif8O/HyWbW0hNPkVFrfzcsfx2gC3CiAzJiaTK7qPKYemFpSGzp8DwpzubxwVXuZdWlNxuhm21gTsx1H5BKPaIzPk9xD1gEMFnZgEh5Fs8jojN1Xn6XpQOuk3okL19/KT3muV/Z2C7TT0FTMEABI6Sk+RvzY0IuvmO+vMNFLS5xWIpUPyB5FFAmXn6yv/8z1eVG0S7Koyqmg7v7AO8OHxj8xX85kE4xB+FP4woAUUs3sF1f9VgcWoN+4YAQ=="}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":2389,"cache_read_input_tokens":9455,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2389},"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"d5a53b77-f5e5-4b4b-b387-65392391e9c9","uuid":"fb7a6901-22b2-40f6-9741-681310cd0920"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01GQZgjX6VSrRs4s66TgykJA","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01FQqJNkP2G4VexujpTyb9QK","name":"Bash","input":{"command":"printf 'codex app-server approval fixture' > .codex-probe-write-action.txt","description":"Write exact text to .codex-probe-write-action.txt"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":2389,"cache_read_input_tokens":9455,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2389},"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"d5a53b77-f5e5-4b4b-b387-65392391e9c9","uuid":"1c6c4d15-a807-4fc0-8061-08e73d3f5a64"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed"},"uuid":"b9ed927a-4036-4761-adad-903db0eeded4","session_id":"d5a53b77-f5e5-4b4b-b387-65392391e9c9"}}
+{"type":"emit_inbound","label":"user","frame":{"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01FQqJNkP2G4VexujpTyb9QK","type":"tool_result","content":"(Bash completed with no output)","is_error":false}]},"parent_tool_use_id":null,"session_id":"d5a53b77-f5e5-4b4b-b387-65392391e9c9","uuid":"b4842b76-eaed-4e14-825c-3e65fa199b59","timestamp":"2026-05-07T01:40:47.865Z","tool_use_result":{"stdout":"","stderr":"","interrupted":false,"isImage":false,"noOutputExpected":false}}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01ALXv3UiL2KfbTV1dxPnhWt","type":"message","role":"assistant","content":[{"type":"text","text":"Done. I used `printf` to write exactly `codex app-server approval fixture` (no trailing newline) to `.codex-probe-write-action.txt` in the current working directory. The command completed successfully with no errors."}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":1,"cache_creation_input_tokens":187,"cache_read_input_tokens":11844,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":187},"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"d5a53b77-f5e5-4b4b-b387-65392391e9c9","uuid":"da722e7b-e35c-47fc-b7a1-c01fed1dd46c"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":6172,"duration_api_ms":5548,"num_turns":2,"result":"Done. I used `printf` to write exactly `codex app-server approval fixture` (no trailing newline) to `.codex-probe-write-action.txt` in the current working directory. The command completed successfully with no errors.","stop_reason":"end_turn","session_id":"d5a53b77-f5e5-4b4b-b387-65392391e9c9","total_cost_usd":0.019391699999999998,"usage":{"input_tokens":4,"cache_creation_input_tokens":2576,"cache_read_input_tokens":21299,"output_tokens":222,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":2576,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[{"input_tokens":1,"output_tokens":55,"cache_read_input_tokens":11844,"cache_creation_input_tokens":187,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":187},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":4,"outputTokens":222,"cacheReadInputTokens":21299,"cacheCreationInputTokens":2576,"webSearchRequests":0,"costUSD":0.019391699999999998,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"f5a7d267-410b-47e6-8296-1a71551565bc"}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_workspace_never/codex_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_workspace_never/codex_output.ts
new file mode 100644
index 000000000000..d6bdc414c75e
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_workspace_never/codex_output.ts
@@ -0,0 +1,29 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertBaseProjection,
+  assertRuntimeRequestCounts,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessagesInclude,
+  assertVisibleTurnItemsMirrorLocalTurnItems,
+  projectionFor,
+  TOOL_CALL_WRITE_PROMPT,
+} from "../shared.ts";
+
+export function assertToolCallWorkspaceNeverOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({ result, transcript, runCount: 1, runStatuses: ["completed"] });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertVisibleTurnItemsMirrorLocalTurnItems(projection);
+  assertTurnItemTypes(projection, ["user_message", "command_execution", "assistant_message"]);
+  assertUserMessagesInclude(projection, [TOOL_CALL_WRITE_PROMPT]);
+  assertRuntimeRequestCounts(projection, { total: 0 });
+  assert.equal(projection.turnItems.filter((item) => item.type === "approval_request").length, 0);
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_workspace_never/codex_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_workspace_never/codex_transcript.ndjson
new file mode 100644
index 000000000000..1a2ce154c0d5
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_workspace_never/codex_transcript.ndjson
@@ -0,0 +1,57 @@
+{"type":"transcript_start","provider":"codex","protocol":"codex.app-server","version":"0.120.0","scenario":"tool_call_workspace_never","metadata":{"source":"codex-app-server-probe","fileName":"tool_call_workspace_never.ndjson","description":"Write a small probe file with workspace-write sandbox policy and never approvals."}}
+{"type":"expect_outbound","label":"initialize","frame":{"id":1,"method":"initialize","params":{"capabilities":{"experimentalApi":true},"clientInfo":{"name":"t3code_desktop","title":"T3 Code Desktop","version":"0.1.0"}}}}
+{"type":"emit_inbound","label":"initialize","frame":{"id":1,"result":{"userAgent":"t3code_desktop/0.120.0 (Mac OS 26.4.1; arm64) dumb (t3code_desktop; 0.1.0)","codexHome":"/Users/julius/.codex","platformFamily":"unix","platformOs":"macos"}}}
+{"type":"expect_outbound","label":"initialized","frame":{"method":"initialized"}}
+{"type":"expect_outbound","label":"thread/start","frame":{"id":2,"method":"thread/start","params":{}}}
+{"type":"emit_inbound","label":"thread/start","frame":{"id":2,"result":{"thread":{"id":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1776739392,"updatedAt":1776739392,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/04/20/rollout-2026-04-20T19-43-12-019dadeb-9a1f-7d61-8e4b-92d487d180b4.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","cliVersion":"0.120.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]},"model":"gpt-5.4","modelProvider":"openai","serviceTier":"fast","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","approvalPolicy":"on-request","approvalsReviewer":"user","sandbox":{"type":"workspaceWrite","writableRoots":["/Users/julius/.codex/memories"],"readOnlyAccess":{"type":"fullAccess"},"networkAccess":false,"excludeTmpdirEnvVar":false,"excludeSlashTmp":false},"reasoningEffort":"xhigh"}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":3,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Create or overwrite .codex-probe-write-action.txt with exactly this text: codex app-server approval fixture. Use a local shell command or file edit only, then briefly report what happened. Do not read package metadata, use GitHub, use web, or use MCP.","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"networkAccess":false,"type":"workspaceWrite","writableRoots":[]},"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"thread/started","frame":{"method":"thread/started","params":{"thread":{"id":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1776739392,"updatedAt":1776739392,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/04/20/rollout-2026-04-20T19-43-12-019dadeb-9a1f-7d61-8e4b-92d487d180b4.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","cliVersion":"0.120.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]}}}}
+{"type":"emit_inbound","label":"deprecationNotice","frame":{"method":"deprecationNotice","params":{"summary":"`[features].collab` is deprecated. Use `[features].multi_agent` instead.","details":"Enable it with `--enable multi_agent` or `[features].multi_agent` in config.toml. See https://developers.openai.com/codex/config-basic#feature-flags for details."}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":3,"result":{"turn":{"id":"019dadeb-9a2a-7e92-abef-82bf1c3d103f","items":[],"status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turn":{"id":"019dadeb-9a2a-7e92-abef-82bf1c3d103f","items":[],"status":"inProgress","error":null,"startedAt":1776739392,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"fabe6753-e817-4530-af44-2981cc32d64b","content":[{"type":"text","text":"Create or overwrite .codex-probe-write-action.txt with exactly this text: codex app-server approval fixture. Use a local shell command or file edit only, then briefly report what happened. Do not read package metadata, use GitHub, use web, or use MCP.","text_elements":[]}]},"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turnId":"019dadeb-9a2a-7e92-abef-82bf1c3d103f"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"fabe6753-e817-4530-af44-2981cc32d64b","content":[{"type":"text","text":"Create or overwrite .codex-probe-write-action.txt with exactly this text: codex app-server approval fixture. Use a local shell command or file edit only, then briefly report what happened. Do not read package metadata, use GitHub, use web, or use MCP.","text_elements":[]}]},"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turnId":"019dadeb-9a2a-7e92-abef-82bf1c3d103f"}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"reasoning","id":"rs_0b179d008122e92d0169e6e444dbcc8199a1dfe44c0c295d8c","summary":[],"content":[]},"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turnId":"019dadeb-9a2a-7e92-abef-82bf1c3d103f"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"reasoning","id":"rs_0b179d008122e92d0169e6e444dbcc8199a1dfe44c0c295d8c","summary":[],"content":[]},"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turnId":"019dadeb-9a2a-7e92-abef-82bf1c3d103f"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turnId":"019dadeb-9a2a-7e92-abef-82bf1c3d103f","tokenUsage":{"total":{"totalTokens":27205,"inputTokens":26816,"cachedInputTokens":3456,"outputTokens":389,"reasoningOutputTokens":336},"last":{"totalTokens":27205,"inputTokens":26816,"cachedInputTokens":3456,"outputTokens":389,"reasoningOutputTokens":336},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"commandExecution","id":"call_lLtECQhta9io8u1TEtgo5DJ0","command":"/bin/zsh -lc \"printf %s 'codex app-server approval fixture' > .codex-probe-write-action.txt\"","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","processId":"71918","source":"unifiedExecStartup","status":"inProgress","commandActions":[{"type":"unknown","command":"printf %s 'codex app-server approval fixture' > .codex-probe-write-action.txt"}],"aggregatedOutput":null,"exitCode":null,"durationMs":null},"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turnId":"019dadeb-9a2a-7e92-abef-82bf1c3d103f"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"commandExecution","id":"call_lLtECQhta9io8u1TEtgo5DJ0","command":"/bin/zsh -lc \"printf %s 'codex app-server approval fixture' > .codex-probe-write-action.txt\"","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","processId":"71918","source":"unifiedExecStartup","status":"completed","commandActions":[{"type":"unknown","command":"printf %s 'codex app-server approval fixture' > .codex-probe-write-action.txt"}],"aggregatedOutput":null,"exitCode":0,"durationMs":0},"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turnId":"019dadeb-9a2a-7e92-abef-82bf1c3d103f"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_0b179d008122e92d0169e6e44980f88199b7bfbd7f33eaff77","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turnId":"019dadeb-9a2a-7e92-abef-82bf1c3d103f"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turnId":"019dadeb-9a2a-7e92-abef-82bf1c3d103f","itemId":"msg_0b179d008122e92d0169e6e44980f88199b7bfbd7f33eaff77","delta":"Created"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turnId":"019dadeb-9a2a-7e92-abef-82bf1c3d103f","itemId":"msg_0b179d008122e92d0169e6e44980f88199b7bfbd7f33eaff77","delta":"/"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turnId":"019dadeb-9a2a-7e92-abef-82bf1c3d103f","itemId":"msg_0b179d008122e92d0169e6e44980f88199b7bfbd7f33eaff77","delta":"over"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turnId":"019dadeb-9a2a-7e92-abef-82bf1c3d103f","itemId":"msg_0b179d008122e92d0169e6e44980f88199b7bfbd7f33eaff77","delta":"w"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turnId":"019dadeb-9a2a-7e92-abef-82bf1c3d103f","itemId":"msg_0b179d008122e92d0169e6e44980f88199b7bfbd7f33eaff77","delta":"rote"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turnId":"019dadeb-9a2a-7e92-abef-82bf1c3d103f","itemId":"msg_0b179d008122e92d0169e6e44980f88199b7bfbd7f33eaff77","delta":" `."}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turnId":"019dadeb-9a2a-7e92-abef-82bf1c3d103f","itemId":"msg_0b179d008122e92d0169e6e44980f88199b7bfbd7f33eaff77","delta":"cod"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turnId":"019dadeb-9a2a-7e92-abef-82bf1c3d103f","itemId":"msg_0b179d008122e92d0169e6e44980f88199b7bfbd7f33eaff77","delta":"ex"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turnId":"019dadeb-9a2a-7e92-abef-82bf1c3d103f","itemId":"msg_0b179d008122e92d0169e6e44980f88199b7bfbd7f33eaff77","delta":"-pro"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turnId":"019dadeb-9a2a-7e92-abef-82bf1c3d103f","itemId":"msg_0b179d008122e92d0169e6e44980f88199b7bfbd7f33eaff77","delta":"be"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turnId":"019dadeb-9a2a-7e92-abef-82bf1c3d103f","itemId":"msg_0b179d008122e92d0169e6e44980f88199b7bfbd7f33eaff77","delta":"-write"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turnId":"019dadeb-9a2a-7e92-abef-82bf1c3d103f","itemId":"msg_0b179d008122e92d0169e6e44980f88199b7bfbd7f33eaff77","delta":"-action"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turnId":"019dadeb-9a2a-7e92-abef-82bf1c3d103f","itemId":"msg_0b179d008122e92d0169e6e44980f88199b7bfbd7f33eaff77","delta":".txt"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turnId":"019dadeb-9a2a-7e92-abef-82bf1c3d103f","itemId":"msg_0b179d008122e92d0169e6e44980f88199b7bfbd7f33eaff77","delta":"`"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turnId":"019dadeb-9a2a-7e92-abef-82bf1c3d103f","itemId":"msg_0b179d008122e92d0169e6e44980f88199b7bfbd7f33eaff77","delta":" with"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turnId":"019dadeb-9a2a-7e92-abef-82bf1c3d103f","itemId":"msg_0b179d008122e92d0169e6e44980f88199b7bfbd7f33eaff77","delta":" exactly"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turnId":"019dadeb-9a2a-7e92-abef-82bf1c3d103f","itemId":"msg_0b179d008122e92d0169e6e44980f88199b7bfbd7f33eaff77","delta":":\n\n"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turnId":"019dadeb-9a2a-7e92-abef-82bf1c3d103f","itemId":"msg_0b179d008122e92d0169e6e44980f88199b7bfbd7f33eaff77","delta":"`"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turnId":"019dadeb-9a2a-7e92-abef-82bf1c3d103f","itemId":"msg_0b179d008122e92d0169e6e44980f88199b7bfbd7f33eaff77","delta":"cod"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turnId":"019dadeb-9a2a-7e92-abef-82bf1c3d103f","itemId":"msg_0b179d008122e92d0169e6e44980f88199b7bfbd7f33eaff77","delta":"ex"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turnId":"019dadeb-9a2a-7e92-abef-82bf1c3d103f","itemId":"msg_0b179d008122e92d0169e6e44980f88199b7bfbd7f33eaff77","delta":" app"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turnId":"019dadeb-9a2a-7e92-abef-82bf1c3d103f","itemId":"msg_0b179d008122e92d0169e6e44980f88199b7bfbd7f33eaff77","delta":"-server"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turnId":"019dadeb-9a2a-7e92-abef-82bf1c3d103f","itemId":"msg_0b179d008122e92d0169e6e44980f88199b7bfbd7f33eaff77","delta":" approval"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turnId":"019dadeb-9a2a-7e92-abef-82bf1c3d103f","itemId":"msg_0b179d008122e92d0169e6e44980f88199b7bfbd7f33eaff77","delta":" fixture"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turnId":"019dadeb-9a2a-7e92-abef-82bf1c3d103f","itemId":"msg_0b179d008122e92d0169e6e44980f88199b7bfbd7f33eaff77","delta":"`"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_0b179d008122e92d0169e6e44980f88199b7bfbd7f33eaff77","text":"Created/overwrote `.codex-probe-write-action.txt` with exactly:\n\n`codex app-server approval fixture`","phase":"final_answer","memoryCitation":null},"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turnId":"019dadeb-9a2a-7e92-abef-82bf1c3d103f"}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turnId":"019dadeb-9a2a-7e92-abef-82bf1c3d103f","tokenUsage":{"total":{"totalTokens":54484,"inputTokens":54066,"cachedInputTokens":29952,"outputTokens":418,"reasoningOutputTokens":336},"last":{"totalTokens":27279,"inputTokens":27250,"cachedInputTokens":26496,"outputTokens":29,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1776748632},"secondary":{"usedPercent":0,"windowDurationMins":10080,"resetsAt":1777335432},"credits":null,"planType":"pro"}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019dadeb-9a1f-7d61-8e4b-92d487d180b4","turn":{"id":"019dadeb-9a2a-7e92-abef-82bf1c3d103f","items":[],"status":"completed","error":null,"startedAt":1776739392,"completedAt":1776739401,"durationMs":9704}}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_workspace_never/input.ts b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_workspace_never/input.ts
new file mode 100644
index 000000000000..d45698ce5fcd
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/tool_call_workspace_never/input.ts
@@ -0,0 +1,7 @@
+import { TOOL_CALL_WRITE_PROMPT, type OrchestratorFixtureInput } from "../shared.ts";
+
+export function toolCallWorkspaceNeverInput(): OrchestratorFixtureInput {
+  return {
+    steps: [{ type: "message", text: TOOL_CALL_WRITE_PROMPT }],
+  };
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt/claude_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt/claude_output.ts
new file mode 100644
index 000000000000..cbcf90cc9624
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt/claude_output.ts
@@ -0,0 +1,51 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertBaseProjection,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessagesInclude,
+  assertVisibleTurnItemsMirrorLocalTurnItems,
+  projectionFor,
+  TURN_INTERRUPT_PROMPT,
+} from "../shared.ts";
+
+export function assertTurnInterruptClaudeOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assert.equal(transcript.provider, "claudeAgent");
+  assertBaseProjection({ result, transcript, runCount: 1, runStatuses: ["interrupted"] });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertVisibleTurnItemsMirrorLocalTurnItems(projection);
+  assertTurnItemTypes(projection, [
+    "user_message",
+    "run_interrupt_request",
+    "run_interrupt_result",
+  ]);
+  assertUserMessagesInclude(projection, [TURN_INTERRUPT_PROMPT]);
+
+  const interruptRequest = projection.turnItems.find(
+    (item) => item.type === "run_interrupt_request",
+  );
+  const interruptResult = projection.turnItems.find((item) => item.type === "run_interrupt_result");
+  assert.isDefined(interruptRequest);
+  assert.isDefined(interruptResult);
+  assert.equal(interruptRequest.status, "completed");
+  assert.equal(interruptResult.status, "interrupted");
+  assert.equal(interruptResult.parentItemId, interruptRequest.id);
+  assert.deepEqual(
+    projection.attempts.map((attempt) => attempt.status),
+    ["interrupted"],
+  );
+  assert.deepEqual(
+    projection.nodes.map((node) => node.status),
+    ["interrupted"],
+  );
+  assert.equal(projection.providerThreads[0]?.status, "idle");
+  assert.equal(projection.providerTurns[0]?.status, "interrupted");
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt/claude_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt/claude_transcript.ndjson
new file mode 100644
index 000000000000..a036d00cd018
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt/claude_transcript.ndjson
@@ -0,0 +1,7 @@
+{"type":"transcript_start","provider":"claudeAgent","protocol":"claude-agent-sdk.query","version":"0.2.111","scenario":"turn_interrupt","metadata":{"prompts":["Do not answer immediately. First run the local shell command `sleep 30`, then respond with exactly: interrupt fixture should not finish naturally."],"model":"claude-sonnet-4-6","nativeSessionId":"2da9a7f1-f9cd-4d45-abd7-25f5370301f3","queryMode":"interrupt","tools":"claude_code","permissionMode":"bypassPermissions","generatedBy":"recordClaudeAgentSdkReplayTranscript"}}
+{"type":"expect_outbound","label":"query.open","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"sessionId":"2da9a7f1-f9cd-4d45-abd7-25f5370301f3"}}}
+{"type":"expect_outbound","label":"prompt.offer:1","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Do not answer immediately. First run the local shell command `sleep 30`, then respond with exactly: interrupt fixture should not finish naturally."},"parent_tool_use_id":null}}}
+{"type":"expect_outbound","label":"query.interrupt:1","frame":{"type":"query.interrupt"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"7dd3898f-86a3-4aac-ae8a-222fe62cb13f","hook_name":"SessionStart:startup","hook_event":"SessionStart","uuid":"34154a8b-b7bb-4204-8c14-d9feb1971e17","session_id":"2da9a7f1-f9cd-4d45-abd7-25f5370301f3"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"7dd3898f-86a3-4aac-ae8a-222fe62cb13f","hook_name":"SessionStart:startup","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"3e1cab63-3de4-4a98-a36c-a237d01bbea6","session_id":"2da9a7f1-f9cd-4d45-abd7-25f5370301f3"}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt/codex_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt/codex_output.ts
new file mode 100644
index 000000000000..a446c5abbba3
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt/codex_output.ts
@@ -0,0 +1,49 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertBaseProjection,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessagesInclude,
+  assertVisibleTurnItemsMirrorLocalTurnItems,
+  projectionFor,
+  TURN_INTERRUPT_PROMPT,
+} from "../shared.ts";
+
+export function assertTurnInterruptOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({ result, transcript, runCount: 1, runStatuses: ["interrupted"] });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertVisibleTurnItemsMirrorLocalTurnItems(projection);
+  assertTurnItemTypes(projection, [
+    "user_message",
+    "run_interrupt_request",
+    "run_interrupt_result",
+  ]);
+  assertUserMessagesInclude(projection, [TURN_INTERRUPT_PROMPT]);
+  const interruptRequest = projection.turnItems.find(
+    (item) => item.type === "run_interrupt_request",
+  );
+  const interruptResult = projection.turnItems.find((item) => item.type === "run_interrupt_result");
+  assert.isDefined(interruptRequest);
+  assert.isDefined(interruptResult);
+  assert.equal(interruptRequest.status, "completed");
+  assert.equal(interruptResult.status, "interrupted");
+  assert.equal(interruptResult.parentItemId, interruptRequest.id);
+  assert.deepEqual(
+    projection.attempts.map((attempt) => attempt.status),
+    ["interrupted"],
+  );
+  assert.deepEqual(
+    projection.nodes.map((node) => node.status),
+    ["interrupted"],
+  );
+  assert.equal(projection.providerThreads[0]?.status, "idle");
+  assert.include(["interrupted", "cancelled"], projection.providerTurns[0]?.status);
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt/codex_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt/codex_transcript.ndjson
new file mode 100644
index 000000000000..10c11a06d04a
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt/codex_transcript.ndjson
@@ -0,0 +1,21 @@
+{"type":"transcript_start","provider":"codex","protocol":"codex.app-server","version":"0.120.0","scenario":"turn_interrupt","metadata":{"source":"codex-app-server-probe","fileName":"turn_interrupt.ndjson","description":"One active turn is interrupted before it finishes naturally."}}
+{"type":"expect_outbound","label":"initialize","frame":{"id":1,"method":"initialize","params":{"capabilities":{"experimentalApi":true},"clientInfo":{"name":"t3code_desktop","title":"T3 Code Desktop","version":"0.1.0"}}}}
+{"type":"emit_inbound","label":"initialize","frame":{"id":1,"result":{"userAgent":"t3code_desktop/0.120.0 (Mac OS 26.4.1; arm64) dumb (t3code_desktop; 0.1.0)","codexHome":"/Users/julius/.codex","platformFamily":"unix","platformOs":"macos"}}}
+{"type":"expect_outbound","label":"initialized","frame":{"method":"initialized"}}
+{"type":"expect_outbound","label":"thread/start","frame":{"id":2,"method":"thread/start","params":{}}}
+{"type":"emit_inbound","label":"thread/start","frame":{"id":2,"result":{"thread":{"id":"019daded-1d25-7df0-abf3-9ed9d31c346c","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1776739491,"updatedAt":1776739491,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/04/20/rollout-2026-04-20T19-44-51-019daded-1d25-7df0-abf3-9ed9d31c346c.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","cliVersion":"0.120.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]},"model":"gpt-5.4","modelProvider":"openai","serviceTier":"fast","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","approvalPolicy":"on-request","approvalsReviewer":"user","sandbox":{"type":"workspaceWrite","writableRoots":["/Users/julius/.codex/memories"],"readOnlyAccess":{"type":"fullAccess"},"networkAccess":false,"excludeTmpdirEnvVar":false,"excludeSlashTmp":false},"reasoningEffort":"xhigh"}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":3,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Do not answer immediately. First run the local shell command `sleep 30`, then respond with exactly: interrupt fixture should not finish naturally.","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"networkAccess":false,"type":"workspaceWrite","writableRoots":[]},"threadId":"019daded-1d25-7df0-abf3-9ed9d31c346c","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"thread/started","frame":{"method":"thread/started","params":{"thread":{"id":"019daded-1d25-7df0-abf3-9ed9d31c346c","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1776739491,"updatedAt":1776739491,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/04/20/rollout-2026-04-20T19-44-51-019daded-1d25-7df0-abf3-9ed9d31c346c.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/packages/effect-codex-app-server","cliVersion":"0.120.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]}}}}
+{"type":"emit_inbound","label":"deprecationNotice","frame":{"method":"deprecationNotice","params":{"summary":"`[features].collab` is deprecated. Use `[features].multi_agent` instead.","details":"Enable it with `--enable multi_agent` or `[features].multi_agent` in config.toml. See https://developers.openai.com/codex/config-basic#feature-flags for details."}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":3,"result":{"turn":{"id":"019daded-1d2f-70f2-8abd-bf90f7dff165","items":[],"status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019daded-1d25-7df0-abf3-9ed9d31c346c","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019daded-1d25-7df0-abf3-9ed9d31c346c","turn":{"id":"019daded-1d2f-70f2-8abd-bf90f7dff165","items":[],"status":"inProgress","error":null,"startedAt":1776739491,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"ready","error":null}}}
+{"type":"expect_outbound","label":"turn/interrupt","frame":{"id":4,"method":"turn/interrupt","params":{"threadId":"019daded-1d25-7df0-abf3-9ed9d31c346c","turnId":"019daded-1d2f-70f2-8abd-bf90f7dff165"}}}
+{"type":"emit_inbound","label":"turn/interrupt","frame":{"id":4,"result":{}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019daded-1d25-7df0-abf3-9ed9d31c346c","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019daded-1d25-7df0-abf3-9ed9d31c346c","turn":{"id":"019daded-1d2f-70f2-8abd-bf90f7dff165","items":[],"status":"interrupted","error":null,"startedAt":1776739491,"completedAt":1776739492,"durationMs":1539}}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt/grok_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt/grok_transcript.ndjson
new file mode 100644
index 000000000000..d8496c0a5572
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt/grok_transcript.ndjson
@@ -0,0 +1,9 @@
+{"type":"transcript_start","provider":"grok","protocol":"acp.ndjson-jsonrpc","version":"1","scenario":"turn_interrupt","metadata":{"generatedBy":"protocol-semantic-fixture","nativeSessionId":"grok-replay-session-1"}}
+{"type":"expect_outbound","label":"initialize","frame":{"kind":"request","method":"initialize","params":{"protocolVersion":1,"clientCapabilities":{"fs":{"readTextFile":false,"writeTextFile":false},"terminal":false,"elicitation":{"form":{}}},"clientInfo":{"name":"t3-code","version":"0.0.0"}}}}
+{"type":"emit_inbound","label":"initialized","frame":{"kind":"response","method":"initialize","result":{"protocolVersion":1,"agentCapabilities":{"loadSession":true,"mcpCapabilities":{"http":true,"sse":true},"promptCapabilities":{"audio":false,"embeddedContext":true,"image":false}},"authMethods":[{"id":"replay","name":"Replay"}],"agentInfo":{"name":"grok-replay","version":"1"}}}}
+{"type":"expect_outbound","label":"session.new","frame":{"kind":"request","method":"session/new","params":{"cwd":"<workspace>","mcpServers":"<any>"}}}
+{"type":"emit_inbound","label":"session.created","frame":{"kind":"response","method":"session/new","result":{"sessionId":"grok-replay-session-1","models":{"currentModelId":"grok-build","availableModels":[{"modelId":"grok-build","name":"Grok Build"}]}}}}
+{"type":"expect_outbound","label":"session.prompt","frame":{"kind":"request","method":"session/prompt","params":{"sessionId":"grok-replay-session-1","prompt":[{"type":"text","text":"Do not answer immediately. First run the local shell command `sleep 30`, then respond with exactly: interrupt fixture should not finish naturally."}]}}}
+{"type":"expect_outbound","label":"session.cancel","frame":{"kind":"notification","method":"session/cancel","params":{"sessionId":"grok-replay-session-1"}}}
+{"type":"emit_inbound","label":"prompt.cancelled","frame":{"kind":"response","method":"session/prompt","result":{"stopReason":"cancelled"}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt/input.ts b/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt/input.ts
new file mode 100644
index 000000000000..341e7378f574
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt/input.ts
@@ -0,0 +1,10 @@
+import { TURN_INTERRUPT_PROMPT, type OrchestratorFixtureInput } from "../shared.ts";
+
+export function turnInterruptInput(): OrchestratorFixtureInput {
+  return {
+    steps: [
+      { type: "message", text: TURN_INTERRUPT_PROMPT },
+      { type: "interrupt", targetRunIndex: 1 },
+    ],
+  };
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt/opencode_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt/opencode_transcript.ndjson
new file mode 100644
index 000000000000..14ab96d6a95a
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt/opencode_transcript.ndjson
@@ -0,0 +1,14 @@
+{"type":"transcript_start","provider":"opencode","protocol":"opencode-sdk.sse","version":"1.14.39","scenario":"turn_interrupt","metadata":{"source":"authenticated-opencode-sdk-probe","capturedAt":"2026-06-18","nativeSessionId":"ses_123570840ffenLEumkPQfegGCd","model":"openai/gpt-5.4-mini","filteredToRelevantEvents":true,"description":"A real immediate session abort where the authoritative idle notification arrived before the abort HTTP response."}}
+{"type":"expect_outbound","label":"event.subscribe","frame":{"type":"event.subscribe"}}
+{"type":"expect_outbound","label":"session.create","frame":{"type":"session.create","input":{"title":"<any>","permission":"<any>"}}}
+{"type":"emit_inbound","label":"session.created","frame":{"type":"sdk.response","operation":"session.create","data":{"id":"ses_123570840ffenLEumkPQfegGCd","slug":"shiny-wolf","version":"1.14.39","projectID":"global","directory":"/private/tmp/t3-opencode-probe","path":"private/tmp/t3-opencode-probe","title":"T3 OpenCode interrupt probe","permission":[{"permission":"bash","pattern":"*","action":"deny"},{"permission":"edit","pattern":"*","action":"deny"},{"permission":"webfetch","pattern":"*","action":"deny"},{"permission":"websearch","pattern":"*","action":"deny"},{"permission":"codesearch","pattern":"*","action":"deny"},{"permission":"external_directory","pattern":"*","action":"deny"},{"permission":"question","pattern":"*","action":"allow"},{"permission":"read","pattern":"*","action":"allow"},{"permission":"glob","pattern":"*","action":"allow"},{"permission":"grep","pattern":"*","action":"allow"},{"permission":"lsp","pattern":"*","action":"allow"},{"permission":"todowrite","pattern":"*","action":"allow"},{"permission":"task","pattern":"*","action":"allow"},{"permission":"skill","pattern":"*","action":"allow"},{"permission":"doom_loop","pattern":"*","action":"allow"},{"permission":"edit","pattern":"*","action":"allow"}],"time":{"created":1781818521535,"updated":1781818521535}}}}
+{"type":"expect_outbound","label":"session.promptAsync","frame":{"type":"session.promptAsync","input":{"sessionID":"ses_123570840ffenLEumkPQfegGCd","model":{"providerID":"openai","modelID":"gpt-5.4-mini"},"agent":"build","parts":[{"type":"text","text":"Do not answer immediately. First run the local shell command `sleep 30`, then respond with exactly: interrupt fixture should not finish naturally."}]}}}
+{"type":"emit_inbound","label":"session.promptAsync.response","frame":{"type":"sdk.response","operation":"session.promptAsync","data":null}}
+{"type":"expect_outbound","label":"session.abort","frame":{"type":"session.abort","input":{"sessionID":"ses_123570840ffenLEumkPQfegGCd"}}}
+{"type":"emit_inbound","label":"message.updated.user","frame":{"type":"sdk.event","event":{"id":"evt_edca8f7ca002yIVK4oYgGErvdA","type":"message.updated","properties":{"sessionID":"ses_123570840ffenLEumkPQfegGCd","info":{"id":"msg_edca8f7c9001w8R30p1SpzPuUJ","role":"user","sessionID":"ses_123570840ffenLEumkPQfegGCd","time":{"created":1781818521545},"agent":"build","model":{"providerID":"openai","modelID":"gpt-5.4-mini"}}}}}}
+{"type":"emit_inbound","label":"message.part.updated.user","frame":{"type":"sdk.event","event":{"id":"evt_edca8f7ca00377fxNZjgW62lds","type":"message.part.updated","properties":{"sessionID":"ses_123570840ffenLEumkPQfegGCd","part":{"type":"text","text":"Do not answer immediately. First run the local shell command `sleep 30`, then respond with exactly: interrupt fixture should not finish naturally.","messageID":"msg_edca8f7c9001w8R30p1SpzPuUJ","sessionID":"ses_123570840ffenLEumkPQfegGCd","id":"prt_edca8f7ca001ugmdiNWtC2964M"},"time":1781818521546}}}}
+{"type":"emit_inbound","label":"session.status.busy","frame":{"type":"sdk.event","event":{"id":"evt_edca8f7cc001qWTqVj4Xrui4Sc","type":"session.status","properties":{"sessionID":"ses_123570840ffenLEumkPQfegGCd","status":{"type":"busy"}}}}}
+{"type":"emit_inbound","label":"message.updated.assistant","frame":{"type":"sdk.event","event":{"id":"evt_edca8f7cc003brTfV2AHRR2C61","type":"message.updated","properties":{"sessionID":"ses_123570840ffenLEumkPQfegGCd","info":{"id":"msg_edca8f7cc002W56d1gpf5e17kX","parentID":"msg_edca8f7c9001w8R30p1SpzPuUJ","role":"assistant","mode":"build","agent":"build","path":{"cwd":"/private/tmp/t3-opencode-probe","root":"/"},"cost":0,"tokens":{"input":0,"output":0,"reasoning":0,"cache":{"read":0,"write":0}},"modelID":"gpt-5.4-mini","providerID":"openai","time":{"created":1781818521548},"sessionID":"ses_123570840ffenLEumkPQfegGCd"}}}}}
+{"type":"emit_inbound","label":"session.status.idle","frame":{"type":"sdk.event","event":{"id":"evt_edca8f7d0001Gjy7U3InhsfliL","type":"session.status","properties":{"sessionID":"ses_123570840ffenLEumkPQfegGCd","status":{"type":"idle"}}}}}
+{"type":"emit_inbound","label":"session.abort.response","frame":{"type":"sdk.response","operation":"session.abort","data":true}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt_mid_tool/claude_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt_mid_tool/claude_output.ts
new file mode 100644
index 000000000000..72884607068b
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt_mid_tool/claude_output.ts
@@ -0,0 +1,95 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertBaseProjection,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessagesInclude,
+  assertVisibleTurnItemsMirrorLocalTurnItems,
+  projectionFor,
+  TURN_INTERRUPT_MID_TOOL_PROMPT,
+} from "../shared.ts";
+
+function frameType(frame: unknown): string | undefined {
+  return typeof frame === "object" && frame !== null && "type" in frame
+    ? (frame as { readonly type?: string }).type
+    : undefined;
+}
+
+function assistantHasToolUse(frame: unknown): boolean {
+  if (frameType(frame) !== "assistant") {
+    return false;
+  }
+  const message = (frame as { readonly message?: unknown }).message;
+  const content =
+    typeof message === "object" && message !== null && "content" in message
+      ? (message as { readonly content?: unknown }).content
+      : undefined;
+  return (
+    Array.isArray(content) &&
+    content.some(
+      (part) =>
+        typeof part === "object" &&
+        part !== null &&
+        "type" in part &&
+        (part as { readonly type?: string }).type === "tool_use",
+    )
+  );
+}
+
+function assertClaudeInterruptAfterToolUse(transcript: ProviderReplayTranscript) {
+  const toolUseIndex = transcript.entries.findIndex(
+    (entry) => entry.type === "emit_inbound" && assistantHasToolUse(entry.frame),
+  );
+  const interruptIndex = transcript.entries.findIndex(
+    (entry) => entry.type === "expect_outbound" && frameType(entry.frame) === "query.interrupt",
+  );
+  assert.isAtLeast(toolUseIndex, 0, "Claude interrupt fixture must record a started tool use");
+  assert.isAbove(
+    interruptIndex,
+    toolUseIndex,
+    "Claude interrupt must be issued after the replayed tool use starts",
+  );
+}
+
+export function assertTurnInterruptMidToolClaudeOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assert.equal(transcript.provider, "claudeAgent");
+  assertClaudeInterruptAfterToolUse(transcript);
+  assertBaseProjection({ result, transcript, runCount: 1, runStatuses: ["interrupted"] });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertVisibleTurnItemsMirrorLocalTurnItems(projection);
+  assertTurnItemTypes(projection, [
+    "user_message",
+    "command_execution",
+    "run_interrupt_request",
+    "run_interrupt_result",
+  ]);
+  assertUserMessagesInclude(projection, [TURN_INTERRUPT_MID_TOOL_PROMPT]);
+
+  const commandItem = projection.turnItems.find((item) => item.type === "command_execution");
+  const interruptRequest = projection.turnItems.find(
+    (item) => item.type === "run_interrupt_request",
+  );
+  const interruptResult = projection.turnItems.find((item) => item.type === "run_interrupt_result");
+  assert.isDefined(commandItem);
+  assert.isDefined(interruptRequest);
+  assert.isDefined(interruptResult);
+  assert.equal(commandItem.status, "failed");
+  assert.include(commandItem.input, "node -e");
+  assert.equal(interruptRequest.status, "completed");
+  assert.equal(interruptResult.status, "interrupted");
+  assert.equal(interruptResult.parentItemId, interruptRequest.id);
+  assert.deepEqual(
+    projection.attempts.map((attempt) => attempt.status),
+    ["interrupted"],
+  );
+  assert.equal(projection.providerThreads[0]?.status, "idle");
+  assert.equal(projection.providerTurns[0]?.status, "interrupted");
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt_mid_tool/claude_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt_mid_tool/claude_transcript.ndjson
new file mode 100644
index 000000000000..ada528b30931
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt_mid_tool/claude_transcript.ndjson
@@ -0,0 +1,11 @@
+{"type":"transcript_start","provider":"claudeAgent","protocol":"claude-agent-sdk.query","version":"0.2.111","scenario":"turn_interrupt_mid_tool","metadata":{"prompts":["Run this exact local command: `node -e \"console.log('interrupt fixture tool started'); setTimeout(() => {}, 30000)\"`. Do not answer until it completes, then respond exactly: interrupt fixture should not finish naturally."],"model":"claude-sonnet-4-6","nativeSessionId":"7d29f78b-4ff3-4147-b35f-4d0f89c5d7f5","queryMode":"interrupt","tools":"claude_code","permissionMode":"bypassPermissions","interruptAfter":"tool_use","generatedBy":"recordClaudeAgentSdkReplayTranscript"}}
+{"type":"expect_outbound","label":"query.open","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"sessionId":"7d29f78b-4ff3-4147-b35f-4d0f89c5d7f5"}}}
+{"type":"expect_outbound","label":"prompt.offer:1","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Run this exact local command: `node -e \"console.log('interrupt fixture tool started'); setTimeout(() => {}, 30000)\"`. Do not answer until it completes, then respond exactly: interrupt fixture should not finish naturally."},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"8557ae70-649c-47ed-94c4-555567ddf93f","hook_name":"SessionStart:startup","hook_event":"SessionStart","uuid":"5f8a6db0-da77-4ac6-a34e-1502fdddcb2d","session_id":"7d29f78b-4ff3-4147-b35f-4d0f89c5d7f5"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"8557ae70-649c-47ed-94c4-555567ddf93f","hook_name":"SessionStart:startup","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"93406e3b-e131-447a-8e21-066c7ac7da5a","session_id":"7d29f78b-4ff3-4147-b35f-4d0f89c5d7f5"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.111","cwd":"/tmp/claude-replay-turn_interrupt_mid_tool","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"24114010-ef49-4403-92e8-d76b3234d9eb","session_id":"7d29f78b-4ff3-4147-b35f-4d0f89c5d7f5"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_0134LoSqmeAtmiGfT8XBAnc4","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"The user wants me to run a specific command that will take 30 seconds to complete (due to the setTimeout). Let me run it.","signature":"ErcCClsIDRgCKkCX7DIBv4J2HjLNPifJq4HAANiIdEr2/GYMGyhdF9zkHFjE9AwbyKNoDI3MXdCly81YpJMMr6ky4//OnX7XrJcAMhFjbGF1ZGUtc29ubmV0LTQtNjgAEgzvtPfUQk3cHbNsLsEaDASyv+jHKV/wcM5HASIw415m94Xy244+UXxpWThWU7A8/9DEtOQ9sLzR9/duaPYc2SeKjvmhKOg1oQZi3nczKokB2YWThB+/yKnsTc2k+1xsUcUYXPcNk6jCZsnJtwkFDA0j7ar6Z5cY0ZaNli+aFbVGJrreiWvsGf8icWy0GedLUshQHGjvwXTbQ/F1kcR2NMBgBjot13Q3iN8/zcGMp6ViJu/R+roW7q6se2i0vbbRBg+1UtYrQ5rkbSBQ3TAlNmYDqe78XtexmHoYAQ=="}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":2377,"cache_read_input_tokens":9455,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2377},"output_tokens":8,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"7d29f78b-4ff3-4147-b35f-4d0f89c5d7f5","uuid":"6574c500-9646-4151-ab05-a0d7065adc47"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_0134LoSqmeAtmiGfT8XBAnc4","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01FAyzzWN34naNJKvPcD7B1D","name":"Bash","input":{"command":"node -e \"console.log('interrupt fixture tool started'); setTimeout(() => {}, 30000)\"","timeout":60000},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":2377,"cache_read_input_tokens":9455,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2377},"output_tokens":8,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"7d29f78b-4ff3-4147-b35f-4d0f89c5d7f5","uuid":"ae2c90aa-4ded-4184-941b-ff32527cc9de"}}
+{"type":"expect_outbound","label":"query.interrupt:1","frame":{"type":"query.interrupt"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed"},"uuid":"0f354af4-9fdf-463f-a3bc-75c31eeaa074","session_id":"7d29f78b-4ff3-4147-b35f-4d0f89c5d7f5"}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt_mid_tool/codex_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt_mid_tool/codex_output.ts
new file mode 100644
index 000000000000..1f5260878d68
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt_mid_tool/codex_output.ts
@@ -0,0 +1,146 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertBaseProjection,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessagesInclude,
+  assertVisibleTurnItemsMirrorLocalTurnItems,
+  projectionFor,
+  TURN_INTERRUPT_MID_TOOL_PROMPT,
+} from "../shared.ts";
+
+function protocolMethod(frame: unknown): string | undefined {
+  return typeof frame === "object" && frame !== null && "method" in frame
+    ? (frame as { readonly method?: string }).method
+    : undefined;
+}
+
+function isCommandExecutionStartedFrame(frame: unknown): boolean {
+  if (protocolMethod(frame) !== "item/started") {
+    return false;
+  }
+  const params =
+    typeof frame === "object" && frame !== null && "params" in frame
+      ? (frame as { readonly params?: unknown }).params
+      : undefined;
+  const item =
+    typeof params === "object" && params !== null && "item" in params
+      ? (params as { readonly item?: unknown }).item
+      : undefined;
+  return (
+    typeof item === "object" &&
+    item !== null &&
+    "type" in item &&
+    (item as { readonly type?: string }).type === "commandExecution"
+  );
+}
+
+function frameParams(frame: unknown): Record<string, unknown> | undefined {
+  if (typeof frame !== "object" || frame === null || !("params" in frame)) {
+    return undefined;
+  }
+  const params = (frame as { readonly params?: unknown }).params;
+  return typeof params === "object" && params !== null
+    ? (params as Record<string, unknown>)
+    : undefined;
+}
+
+function assertCodexInterruptAfterCommandExecution(transcript: ProviderReplayTranscript) {
+  const commandIndex = transcript.entries.findIndex(
+    (entry) => entry.type === "emit_inbound" && isCommandExecutionStartedFrame(entry.frame),
+  );
+  const interruptIndex = transcript.entries.findIndex(
+    (entry) => entry.type === "expect_outbound" && protocolMethod(entry.frame) === "turn/interrupt",
+  );
+  const completedIndex = transcript.entries.findIndex(
+    (entry) => entry.type === "emit_inbound" && protocolMethod(entry.frame) === "turn/completed",
+  );
+  const terminateIndex = transcript.entries.findIndex(
+    (entry) =>
+      entry.type === "expect_outbound" &&
+      protocolMethod(entry.frame) === "thread/backgroundTerminals/terminate",
+  );
+  assert.isAtLeast(commandIndex, 0, "Codex interrupt fixture must record command execution start");
+  assert.isAbove(
+    interruptIndex,
+    commandIndex,
+    "Codex interrupt must be issued after command execution starts in replay",
+  );
+  assert.isAtLeast(
+    completedIndex,
+    0,
+    "Codex interrupt fixture must record turn/completed before terminal cleanup",
+  );
+  assert.isAtLeast(
+    terminateIndex,
+    0,
+    "Codex interrupt fixture must record background terminal terminate",
+  );
+  assert.isAbove(
+    terminateIndex,
+    completedIndex,
+    "This recorded Codex interrupt fixture terminates background terminals after turn/completed",
+  );
+  const terminateEntry = transcript.entries[terminateIndex];
+  const terminateParams =
+    terminateEntry?.type === "expect_outbound" ? frameParams(terminateEntry.frame) : undefined;
+  assert.equal(terminateParams?.threadId, "019e03b8-9e5c-7b32-88ab-f742a29b75b8");
+  assert.equal(terminateParams?.processId, "4275");
+}
+
+export function assertTurnInterruptMidToolCodexOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assert.equal(transcript.provider, "codex");
+  assertCodexInterruptAfterCommandExecution(transcript);
+  assertBaseProjection({ result, transcript, runCount: 1, runStatuses: ["interrupted"] });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertVisibleTurnItemsMirrorLocalTurnItems(projection);
+  assertTurnItemTypes(projection, [
+    "user_message",
+    "command_execution",
+    "run_interrupt_request",
+    "run_interrupt_result",
+  ]);
+  assertUserMessagesInclude(projection, [TURN_INTERRUPT_MID_TOOL_PROMPT]);
+
+  const commandItem = projection.turnItems.find((item) => item.type === "command_execution");
+  const interruptRequest = projection.turnItems.find(
+    (item) => item.type === "run_interrupt_request",
+  );
+  const interruptResult = projection.turnItems.find((item) => item.type === "run_interrupt_result");
+  assert.isDefined(commandItem);
+  assert.isDefined(interruptRequest);
+  assert.isDefined(interruptResult);
+  // Interrupted Codex turns must terminalize mid-flight commandExecution items so
+  // the projected card is never left running forever after turn.terminal.
+  assert.equal(commandItem.status, "interrupted");
+  assert.isNotNull(commandItem.completedAt);
+  assert.include(commandItem.input, "node -e");
+  assert.equal(interruptRequest.status, "completed");
+  assert.equal(interruptResult.status, "interrupted");
+  assert.equal(interruptResult.parentItemId, interruptRequest.id);
+  assert.deepEqual(
+    projection.attempts.map((attempt) => attempt.status),
+    ["interrupted"],
+  );
+  assert.equal(projection.providerThreads[0]?.status, "idle");
+  assert.include(["interrupted", "cancelled"], projection.providerTurns[0]?.status);
+
+  const runningCommands = projection.turnItems.filter(
+    (item) => item.type === "command_execution" && item.status === "running",
+  );
+  assert.lengthOf(runningCommands, 0, "interrupted turn must not leave running command items");
+
+  const toolNodes = projection.nodes.filter((node) => node.kind === "tool_call");
+  for (const node of toolNodes) {
+    assert.notEqual(node.status, "running", "interrupted turn tool nodes must be terminal");
+    assert.isNotNull(node.completedAt);
+  }
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt_mid_tool/codex_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt_mid_tool/codex_transcript.ndjson
new file mode 100644
index 000000000000..0a49ffd891ec
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt_mid_tool/codex_transcript.ndjson
@@ -0,0 +1,35 @@
+{"type":"transcript_start","provider":"codex","protocol":"codex.app-server","version":"0.128.0","scenario":"turn_interrupt_mid_tool","metadata":{"source":"record-codex-app-server-replay-fixture","fileName":"turn_interrupt_mid_tool.ndjson","description":"One active turn is interrupted after Codex has already executed a local command."}}
+{"type":"expect_outbound","label":"initialize","frame":{"id":1,"method":"initialize","params":{"capabilities":{"experimentalApi":true},"clientInfo":{"name":"t3code_desktop","title":"T3 Code Desktop","version":"0.1.0"}}}}
+{"type":"emit_inbound","label":"initialize","frame":{"id":1,"result":{"userAgent":"t3code_desktop/0.128.0 (Mac OS 26.4.1; arm64) dumb (t3code_desktop; 0.1.0)","codexHome":"/Users/julius/.codex_p","platformFamily":"unix","platformOs":"macos"}}}
+{"type":"expect_outbound","label":"initialized","frame":{"method":"initialized"}}
+{"type":"expect_outbound","label":"thread/start","frame":{"id":2,"method":"thread/start","params":{}}}
+{"type":"emit_inbound","label":"remoteControl/status/changed","frame":{"method":"remoteControl/status/changed","params":{"status":"disabled","environmentId":null}}}
+{"type":"emit_inbound","label":"thread/start","frame":{"id":2,"result":{"thread":{"id":"019e03b8-9e5c-7b32-88ab-f742a29b75b8","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1778178891,"updatedAt":1778178891,"status":{"type":"idle"},"path":"/Users/julius/.codex_p/sessions/2026/05/07/rollout-2026-05-07T11-34-51-019e03b8-9e5c-7b32-88ab-f742a29b75b8.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/apps/server","cliVersion":"0.128.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]},"model":"gpt-5.5","modelProvider":"openai","serviceTier":"fast","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/apps/server","instructionSources":["/Users/julius/.codex_p/AGENTS.md","/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/AGENTS.md"],"approvalPolicy":"on-request","approvalsReviewer":"user","sandbox":{"type":"workspaceWrite","writableRoots":["/Users/julius/.codex_p/memories"],"networkAccess":false,"excludeTmpdirEnvVar":false,"excludeSlashTmp":false},"permissionProfile":{"type":"managed","network":{"enabled":false},"fileSystem":{"type":"restricted","entries":[{"path":{"type":"special","value":{"kind":"root"}},"access":"read"},{"path":{"type":"special","value":{"kind":"project_roots","subpath":null}},"access":"write"},{"path":{"type":"special","value":{"kind":"slash_tmp"}},"access":"write"},{"path":{"type":"special","value":{"kind":"tmpdir"}},"access":"write"},{"path":{"type":"special","value":{"kind":"project_roots","subpath":".git"}},"access":"read"},{"path":{"type":"special","value":{"kind":"project_roots","subpath":".agents"}},"access":"read"},{"path":{"type":"special","value":{"kind":"project_roots","subpath":".codex"}},"access":"read"},{"path":{"type":"path","path":"/Users/julius/.codex_p/memories"},"access":"write"}]}},"activePermissionProfile":{"id":":workspace","extends":null,"modifications":[]},"reasoningEffort":"medium"}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":3,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Run this exact local command: `node -e \"console.log('interrupt fixture tool started'); setTimeout(() => {}, 30000)\"`. Do not answer until it completes, then respond exactly: interrupt fixture should not finish naturally.","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"networkAccess":false,"type":"workspaceWrite","writableRoots":[]},"threadId":"019e03b8-9e5c-7b32-88ab-f742a29b75b8","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"thread/started","frame":{"method":"thread/started","params":{"thread":{"id":"019e03b8-9e5c-7b32-88ab-f742a29b75b8","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1778178891,"updatedAt":1778178891,"status":{"type":"idle"},"path":"/Users/julius/.codex_p/sessions/2026/05/07/rollout-2026-05-07T11-34-51-019e03b8-9e5c-7b32-88ab-f742a29b75b8.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/apps/server","cliVersion":"0.128.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]}}}}
+{"type":"emit_inbound","label":"deprecationNotice","frame":{"method":"deprecationNotice","params":{"summary":"`[features].collab` is deprecated. Use `[features].multi_agent` instead.","details":"Enable it with `--enable multi_agent` or `[features].multi_agent` in config.toml. See https://developers.openai.com/codex/config-basic#feature-flags for details."}}}
+{"type":"emit_inbound","label":"warning","frame":{"method":"warning","params":{"threadId":"019e03b8-9e5c-7b32-88ab-f742a29b75b8","message":"Under-development features enabled: apply_patch_freeform. Under-development features are incomplete and may behave unpredictably. To suppress this warning, set `suppress_unstable_features_warning = true` in /Users/julius/.codex_p/config.toml."}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"computer-use","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"openaiDeveloperDocs","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"starting","error":null}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":3,"result":{"turn":{"id":"019e03b8-9f34-7bb1-8267-ad79b7e2e69a","items":[],"status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019e03b8-9e5c-7b32-88ab-f742a29b75b8","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019e03b8-9e5c-7b32-88ab-f742a29b75b8","turn":{"id":"019e03b8-9f34-7bb1-8267-ad79b7e2e69a","items":[],"status":"inProgress","error":null,"startedAt":1778178891,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"computer-use","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"openaiDeveloperDocs","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"codex_apps","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"mcpServer/startupStatus/updated","frame":{"method":"mcpServer/startupStatus/updated","params":{"name":"uidotsh","status":"ready","error":null}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"ed97ce32-6075-4da5-9c7e-7518427a7bb6","content":[{"type":"text","text":"Run this exact local command: `node -e \"console.log('interrupt fixture tool started'); setTimeout(() => {}, 30000)\"`. Do not answer until it completes, then respond exactly: interrupt fixture should not finish naturally.","text_elements":[]}]},"threadId":"019e03b8-9e5c-7b32-88ab-f742a29b75b8","turnId":"019e03b8-9f34-7bb1-8267-ad79b7e2e69a"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"ed97ce32-6075-4da5-9c7e-7518427a7bb6","content":[{"type":"text","text":"Run this exact local command: `node -e \"console.log('interrupt fixture tool started'); setTimeout(() => {}, 30000)\"`. Do not answer until it completes, then respond exactly: interrupt fixture should not finish naturally.","text_elements":[]}]},"threadId":"019e03b8-9e5c-7b32-88ab-f742a29b75b8","turnId":"019e03b8-9f34-7bb1-8267-ad79b7e2e69a"}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":6,"windowDurationMins":300,"resetsAt":1778193273},"secondary":{"usedPercent":32,"windowDurationMins":10080,"resetsAt":1778539136},"credits":null,"planType":"pro","rateLimitReachedType":null}}}}
+{"type":"emit_inbound","label":"thread/tokenUsage/updated","frame":{"method":"thread/tokenUsage/updated","params":{"threadId":"019e03b8-9e5c-7b32-88ab-f742a29b75b8","turnId":"019e03b8-9f34-7bb1-8267-ad79b7e2e69a","tokenUsage":{"total":{"totalTokens":17497,"inputTokens":17444,"cachedInputTokens":7552,"outputTokens":53,"reasoningOutputTokens":0},"last":{"totalTokens":17497,"inputTokens":17444,"cachedInputTokens":7552,"outputTokens":53,"reasoningOutputTokens":0},"modelContextWindow":258400}}}}
+{"type":"emit_inbound","label":"account/rateLimits/updated","frame":{"method":"account/rateLimits/updated","params":{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":6,"windowDurationMins":300,"resetsAt":1778193273},"secondary":{"usedPercent":32,"windowDurationMins":10080,"resetsAt":1778539136},"credits":null,"planType":"pro","rateLimitReachedType":null}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"commandExecution","id":"call_m8JXk02QAzuzBMHNgh1RsGaw","command":"/bin/zsh -lc \"node -e \\\"console.log('interrupt fixture tool started'); setTimeout(() => {}, 30000)\\\"\"","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1/apps/server","processId":"4275","source":"unifiedExecStartup","status":"inProgress","commandActions":[{"type":"unknown","command":"node -e \"console.log('interrupt fixture tool started'); setTimeout(() => {}, 30000)\""}],"aggregatedOutput":null,"exitCode":null,"durationMs":null},"threadId":"019e03b8-9e5c-7b32-88ab-f742a29b75b8","turnId":"019e03b8-9f34-7bb1-8267-ad79b7e2e69a"}}}
+{"type":"expect_outbound","label":"turn/interrupt","frame":{"id":4,"method":"turn/interrupt","params":{"threadId":"019e03b8-9e5c-7b32-88ab-f742a29b75b8","turnId":"019e03b8-9f34-7bb1-8267-ad79b7e2e69a"}}}
+{"type":"emit_inbound","label":"turn/interrupt","frame":{"id":4,"result":{}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019e03b8-9e5c-7b32-88ab-f742a29b75b8","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019e03b8-9e5c-7b32-88ab-f742a29b75b8","turn":{"id":"019e03b8-9f34-7bb1-8267-ad79b7e2e69a","items":[],"status":"interrupted","error":null,"startedAt":1778178891,"completedAt":1778178895,"durationMs":3792}}}}
+{"type":"expect_outbound","label":"thread/backgroundTerminals/terminate","frame":{"id":5,"method":"thread/backgroundTerminals/terminate","params":{"threadId":"019e03b8-9e5c-7b32-88ab-f742a29b75b8","processId":"4275"}}}
+{"type":"emit_inbound","label":"thread/backgroundTerminals/terminate","frame":{"id":5,"result":{"terminated":true}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt_mid_tool/cursor_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt_mid_tool/cursor_output.ts
new file mode 100644
index 000000000000..becc6006a970
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt_mid_tool/cursor_output.ts
@@ -0,0 +1,75 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertBaseProjection,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessagesInclude,
+  assertVisibleTurnItemsMirrorLocalTurnItems,
+  projectionFor,
+  TURN_INTERRUPT_MID_TOOL_PROMPT,
+} from "../shared.ts";
+
+function frameType(frame: unknown): string | undefined {
+  return typeof frame === "object" && frame !== null
+    ? (Reflect.get(frame, "type") as string | undefined)
+    : undefined;
+}
+
+function cursorUpdateType(frame: unknown): string | undefined {
+  if (frameType(frame) !== "interaction.update") {
+    return undefined;
+  }
+  const update = Reflect.get(frame as object, "update");
+  return typeof update === "object" && update !== null
+    ? (Reflect.get(update, "type") as string | undefined)
+    : undefined;
+}
+
+export function assertTurnInterruptMidToolCursorOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  const toolStartedIndex = transcript.entries.findIndex(
+    (entry) =>
+      entry.type === "emit_inbound" && cursorUpdateType(entry.frame) === "tool-call-started",
+  );
+  const cancelIndex = transcript.entries.findIndex(
+    (entry) => entry.type === "expect_outbound" && frameType(entry.frame) === "run.cancel",
+  );
+  assert.isAtLeast(toolStartedIndex, 0);
+  assert.isAbove(cancelIndex, toolStartedIndex);
+  assertBaseProjection({ result, transcript, runCount: 1, runStatuses: ["interrupted"] });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertVisibleTurnItemsMirrorLocalTurnItems(projection);
+  assertTurnItemTypes(projection, [
+    "user_message",
+    "command_execution",
+    "run_interrupt_request",
+    "run_interrupt_result",
+  ]);
+  assertUserMessagesInclude(projection, [TURN_INTERRUPT_MID_TOOL_PROMPT]);
+
+  const commandItem = projection.turnItems.find((item) => item.type === "command_execution");
+  const interruptRequest = projection.turnItems.find(
+    (item) => item.type === "run_interrupt_request",
+  );
+  const interruptResult = projection.turnItems.find((item) => item.type === "run_interrupt_result");
+  assert.isDefined(commandItem);
+  assert.isDefined(interruptRequest);
+  assert.isDefined(interruptResult);
+  assert.include(commandItem.input, "node -e");
+  assert.equal(interruptRequest.status, "completed");
+  assert.equal(interruptResult.status, "interrupted");
+  assert.equal(interruptResult.parentItemId, interruptRequest.id);
+  assert.deepEqual(
+    projection.attempts.map((attempt) => attempt.status),
+    ["interrupted"],
+  );
+  assert.equal(projection.providerThreads[0]?.status, "idle");
+  assert.equal(projection.providerTurns[0]?.status, "interrupted");
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt_mid_tool/cursor_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt_mid_tool/cursor_transcript.ndjson
new file mode 100644
index 000000000000..fbbcca5af5ac
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt_mid_tool/cursor_transcript.ndjson
@@ -0,0 +1,43 @@
+{"type":"transcript_start","provider":"cursor","protocol":"cursor-agent-sdk.local","version":"1","scenario":"turn_interrupt_mid_tool","metadata":{"generatedBy":"recordCursorAgentSdkReplayTranscript","nativeAgentId":"agent-e4dcb030-b82a-4526-9b30-3db02142c1bb"}}
+{"type":"expect_outbound","label":"agent.open","frame":{"type":"agent.open","operation":"create","options":{"model":{"id":"composer-2.5"},"hasName":true,"mode":"agent","local":{"hasCwd":true,"autoReview":false,"sandboxEnabled":true,"enableAgentRetries":true}}}}
+{"type":"emit_inbound","label":"agent.opened","frame":{"type":"agent.opened","agentId":"agent-e4dcb030-b82a-4526-9b30-3db02142c1bb"}}
+{"type":"expect_outbound","label":"run.start:1","frame":{"type":"run.start","message":"Run this exact local command: `node -e \"console.log('interrupt fixture tool started'); setTimeout(() => {}, 30000)\"`. Do not answer until it completes, then respond exactly: interrupt fixture should not finish naturally.","options":{"model":{"id":"composer-2.5"},"mode":"agent"}}}
+{"type":"emit_inbound","label":"run.started:1","frame":{"type":"run.started","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","agentId":"agent-e4dcb030-b82a-4526-9b30-3db02142c1bb"}}
+{"type":"emit_inbound","label":"thinking-delta","frame":{"type":"interaction.update","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","update":{"type":"thinking-delta","text":"Running the Node.js "}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","update":{"type":"token-delta","tokens":5}}}
+{"type":"emit_inbound","label":"thinking-delta","frame":{"type":"interaction.update","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","update":{"type":"thinking-delta","text":"command now. Waiting"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","update":{"type":"token-delta","tokens":5}}}
+{"type":"emit_inbound","label":"thinking-delta","frame":{"type":"interaction.update","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","update":{"type":"thinking-delta","text":" for it to complete "}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","update":{"type":"token-delta","tokens":5}}}
+{"type":"emit_inbound","label":"thinking-delta","frame":{"type":"interaction.update","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","update":{"type":"thinking-delta","text":"before responding."}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","update":{"type":"token-delta","tokens":4}}}
+{"type":"emit_inbound","label":"thinking-completed","frame":{"type":"interaction.update","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","update":{"type":"thinking-completed","thinkingDurationMs":697}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","update":{"type":"text-delta","text":"Running"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","update":{"type":"text-delta","text":" the"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","update":{"type":"text-delta","text":" command"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","update":{"type":"text-delta","text":" and"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","update":{"type":"text-delta","text":" waiting"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","update":{"type":"text-delta","text":" for"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","update":{"type":"text-delta","text":" it"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","update":{"type":"text-delta","text":" to"}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","update":{"type":"text-delta","text":" finish"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","update":{"type":"token-delta","tokens":2}}}
+{"type":"emit_inbound","label":"text-delta","frame":{"type":"interaction.update","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","update":{"type":"text-delta","text":".\n"}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","update":{"type":"token-delta","tokens":3}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","update":{"type":"token-delta","tokens":22}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","update":{"type":"token-delta","tokens":4}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","update":{"type":"token-delta","tokens":9}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","update":{"type":"token-delta","tokens":5}}}
+{"type":"emit_inbound","label":"token-delta","frame":{"type":"interaction.update","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","update":{"type":"token-delta","tokens":1}}}
+{"type":"emit_inbound","label":"tool-call-started","frame":{"type":"interaction.update","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","update":{"type":"tool-call-started","callId":"tool_6ecf0e02-3c15-448d-8994-2d041457475","toolCall":{"type":"shell","args":{"command":"node -e \"console.log('interrupt fixture tool started'); setTimeout(() => {}, 30000)\"","timeout":35000}},"modelCallId":"d7f78da1-7ccd-45fc-a021-a0f7c333bd1d-0-kteu"}}}
+{"type":"expect_outbound","label":"run.cancel:1","frame":{"type":"run.cancel","runId":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2"}}
+{"type":"emit_inbound","label":"run.completed:1","frame":{"type":"run.completed","result":{"id":"run-3735f72d-3c3a-40b3-ae4a-caed784e6ea2","requestId":"d7f78da1-7ccd-45fc-a021-a0f7c333bd1d","status":"cancelled","model":{"id":"composer-2.5"},"durationMs":4496}}}
+{"type":"expect_outbound","label":"agent.close","frame":{"type":"agent.close","agentId":"agent-e4dcb030-b82a-4526-9b30-3db02142c1bb"}}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt_mid_tool/input.ts b/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt_mid_tool/input.ts
new file mode 100644
index 000000000000..238c0f7a9edb
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt_mid_tool/input.ts
@@ -0,0 +1,10 @@
+import { TURN_INTERRUPT_MID_TOOL_PROMPT, type OrchestratorFixtureInput } from "../shared.ts";
+
+export function turnInterruptMidToolInput(): OrchestratorFixtureInput {
+  return {
+    steps: [
+      { type: "message", text: TURN_INTERRUPT_MID_TOOL_PROMPT },
+      { type: "interrupt", targetRunIndex: 1, waitForTurnItemType: "command_execution" },
+    ],
+  };
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt_restart/claude_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt_restart/claude_output.ts
new file mode 100644
index 000000000000..1da224a8485b
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt_restart/claude_output.ts
@@ -0,0 +1,129 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertAssistantTextIncludes,
+  assertBaseProjection,
+  assertConversationMessageRoles,
+  assertRunOrdinals,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessagesInclude,
+  assertVisibleTurnItemsMirrorLocalTurnItems,
+  projectionFor,
+  TURN_INTERRUPT_MID_TOOL_PROMPT,
+  TURN_INTERRUPT_RECOVERY_PROMPT,
+} from "../shared.ts";
+
+function isReplayFrameWithType(
+  frame: unknown,
+  type: string,
+): frame is { readonly type: string; readonly options?: Record<string, unknown> } {
+  return (
+    typeof frame === "object" &&
+    frame !== null &&
+    "type" in frame &&
+    (frame as { readonly type?: unknown }).type === type
+  );
+}
+
+function frameType(frame: unknown): string | undefined {
+  return typeof frame === "object" && frame !== null && "type" in frame
+    ? (frame as { readonly type?: string }).type
+    : undefined;
+}
+
+function assistantHasToolUse(frame: unknown): boolean {
+  if (frameType(frame) !== "assistant") {
+    return false;
+  }
+  const message = (frame as { readonly message?: unknown }).message;
+  const content =
+    typeof message === "object" && message !== null && "content" in message
+      ? (message as { readonly content?: unknown }).content
+      : undefined;
+  return (
+    Array.isArray(content) &&
+    content.some(
+      (part) =>
+        typeof part === "object" &&
+        part !== null &&
+        "type" in part &&
+        (part as { readonly type?: string }).type === "tool_use",
+    )
+  );
+}
+
+function assertClaudeInterruptAfterToolUse(transcript: ProviderReplayTranscript) {
+  const toolUseIndex = transcript.entries.findIndex(
+    (entry) => entry.type === "emit_inbound" && assistantHasToolUse(entry.frame),
+  );
+  const interruptIndex = transcript.entries.findIndex(
+    (entry) => entry.type === "expect_outbound" && frameType(entry.frame) === "query.interrupt",
+  );
+  assert.isAtLeast(toolUseIndex, 0, "Claude interrupt fixture must record a started tool use");
+  assert.isAbove(
+    interruptIndex,
+    toolUseIndex,
+    "Claude interrupt must be issued after the replayed tool use starts",
+  );
+}
+
+export function assertTurnInterruptRestartClaudeOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assert.equal(transcript.provider, "claudeAgent");
+  assertClaudeInterruptAfterToolUse(transcript);
+  assertBaseProjection({
+    result,
+    transcript,
+    runCount: 2,
+    runStatuses: ["interrupted", "completed"],
+  });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertVisibleTurnItemsMirrorLocalTurnItems(projection);
+  assertRunOrdinals(projection, [1, 2]);
+  assertConversationMessageRoles(projection, ["user", "user", "assistant"]);
+  assertTurnItemTypes(projection, [
+    "user_message",
+    "command_execution",
+    "run_interrupt_request",
+    "run_interrupt_result",
+    "assistant_message",
+  ]);
+  assertUserMessagesInclude(projection, [
+    TURN_INTERRUPT_MID_TOOL_PROMPT,
+    TURN_INTERRUPT_RECOVERY_PROMPT,
+  ]);
+  assertAssistantTextIncludes(projection, "interrupt recovery fixture complete");
+  assert.deepEqual(
+    projection.attempts.map((attempt) => attempt.status),
+    ["interrupted", "completed"],
+  );
+  assert.deepEqual(
+    projection.providerTurns.map((turn) => turn.status),
+    ["interrupted", "completed"],
+  );
+  assert.equal(projection.providerThreads[0]?.status, "idle");
+  const commandItem = projection.turnItems.find((item) => item.type === "command_execution");
+  assert.isDefined(commandItem);
+  assert.equal(commandItem.status, "failed");
+  assert.include(commandItem.input, "node -e");
+
+  const outboundFrames = transcript.entries.flatMap((entry) =>
+    entry.type === "expect_outbound" ? [entry.frame] : [],
+  );
+  const queryOpenFrames = outboundFrames.filter((frame) =>
+    isReplayFrameWithType(frame, "query.open"),
+  );
+  const interruptFrames = outboundFrames.filter((frame) =>
+    isReplayFrameWithType(frame, "query.interrupt"),
+  );
+  assert.lengthOf(queryOpenFrames, 2);
+  assert.isString(queryOpenFrames[1]?.options?.resume);
+  assert.lengthOf(interruptFrames, 1);
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt_restart/claude_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt_restart/claude_transcript.ndjson
new file mode 100644
index 000000000000..80ecb6d2a98f
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt_restart/claude_transcript.ndjson
@@ -0,0 +1,20 @@
+{"type":"transcript_start","provider":"claudeAgent","protocol":"claude-agent-sdk.query","version":"0.2.111","scenario":"turn_interrupt_restart","metadata":{"prompts":["Run this exact local command: `node -e \"console.log('interrupt fixture tool started'); setTimeout(() => {}, 30000)\"`. Do not answer until it completes, then respond exactly: interrupt fixture should not finish naturally.","Respond with exactly: interrupt recovery fixture complete"],"model":"claude-sonnet-4-6","nativeSessionId":"fb591f8f-073f-4981-bf67-9b5bffb537d5","queryMode":"interrupt_restart","tools":"claude_code","permissionMode":"bypassPermissions","interruptAfter":"tool_use","generatedBy":"recordClaudeAgentSdkReplayTranscript"}}
+{"type":"expect_outbound","label":"query.open:1","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"sessionId":"fb591f8f-073f-4981-bf67-9b5bffb537d5"}}}
+{"type":"expect_outbound","label":"prompt.offer:1","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Run this exact local command: `node -e \"console.log('interrupt fixture tool started'); setTimeout(() => {}, 30000)\"`. Do not answer until it completes, then respond exactly: interrupt fixture should not finish naturally."},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"9e9d889c-c7cc-41c8-862c-691efcebe3a4","hook_name":"SessionStart:startup","hook_event":"SessionStart","uuid":"ac49901c-0458-4870-b5d7-9c8ed20ffa68","session_id":"fb591f8f-073f-4981-bf67-9b5bffb537d5"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"9e9d889c-c7cc-41c8-862c-691efcebe3a4","hook_name":"SessionStart:startup","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"1f69ab12-dcff-4bb3-9dc7-6284fc356fd4","session_id":"fb591f8f-073f-4981-bf67-9b5bffb537d5"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.111","cwd":"/tmp/claude-replay-turn_interrupt_restart","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"a3d73993-da1f-4dd2-ae3f-6d9fbfde4e17","session_id":"fb591f8f-073f-4981-bf67-9b5bffb537d5"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01Ri3g1NyAvmxateKU6RpTZt","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"The user wants me to run a specific command that will take 30 seconds to complete (due to the setTimeout). Let me run it.","signature":"ErcCClsIDRgCKkCX7DIBv4J2HjLNPifJq4HAANiIdEr2/GYMGyhdF9zkHFjE9AwbyKNoDI3MXdCly81YpJMMr6ky4//OnX7XrJcAMhFjbGF1ZGUtc29ubmV0LTQtNjgAEgyvpmUstPaO3mULIDoaDFDTBmO2AKTDNHheWCIwmltJgzr/Y82edEUCc2SZ/vmduVXkEGJFBpYfDgWg++UCyftnJ2jIuU7OjMrgnlGyKokBovHsKA1SGudP3mxdKaHpo9wyKvUQgjmjBUYndKN68q/l/LSN27pia+/x2C99K8iJTvWWykEjSvXn59qOQJI49MVav3hPKR0t0kQcrdM17ceB/ZYPcAxNN4u+EB2cxxeUAGXmcoJ5H69FBoNxtnDf1ECnTp3cdcd7af7W5oTUKX075fqAXS7rKJ4YAQ=="}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":2377,"cache_read_input_tokens":9455,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2377},"output_tokens":8,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"fb591f8f-073f-4981-bf67-9b5bffb537d5","uuid":"d7c45832-9ef6-4a07-81ef-2f3c5bfbbb60"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01Ri3g1NyAvmxateKU6RpTZt","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01KHpBiM7muckukoYeKCJnSn","name":"Bash","input":{"command":"node -e \"console.log('interrupt fixture tool started'); setTimeout(() => {}, 30000)\"","timeout":60000},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":2377,"cache_read_input_tokens":9455,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2377},"output_tokens":8,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"fb591f8f-073f-4981-bf67-9b5bffb537d5","uuid":"a4208b49-5191-48bf-ae90-9e25f49822de"}}
+{"type":"expect_outbound","label":"query.interrupt:1","frame":{"type":"query.interrupt"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed"},"uuid":"72dd2e75-8bf4-4119-85b4-0176e138ca89","session_id":"fb591f8f-073f-4981-bf67-9b5bffb537d5"}}
+{"type":"runtime_exit","status":"success"}
+{"type":"expect_outbound","label":"query.open:2","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"resume":"fb591f8f-073f-4981-bf67-9b5bffb537d5"}}}
+{"type":"expect_outbound","label":"prompt.offer:2","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Respond with exactly: interrupt recovery fixture complete"},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"b6eca4f5-a876-4c87-b985-ac51dfdcd45a","hook_name":"SessionStart:resume","hook_event":"SessionStart","uuid":"333f23b1-5e16-416a-ad70-28fc820390b8","session_id":"be6cf26c-092d-4fe1-8a63-057bfd8b4723"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"b6eca4f5-a876-4c87-b985-ac51dfdcd45a","hook_name":"SessionStart:resume","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"29fb9baf-b0ed-4097-b8fc-be223aa6dd76","session_id":"be6cf26c-092d-4fe1-8a63-057bfd8b4723"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.111","cwd":"/tmp/claude-replay-turn_interrupt_restart","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"1b86dd32-214c-4c7e-81d1-2a73befc5da8","session_id":"fb591f8f-073f-4981-bf67-9b5bffb537d5"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_015EmKr5Mwpb1EixMz3GZupx","type":"message","role":"assistant","content":[{"type":"text","text":"interrupt recovery fixture complete"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":243,"cache_read_input_tokens":11832,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":243},"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"fb591f8f-073f-4981-bf67-9b5bffb537d5","uuid":"dd46fcd4-0fca-4418-bcd6-30e6df3e9479"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed"},"uuid":"0548e03f-e3ea-431d-b6d2-100d02680b4d","session_id":"fb591f8f-073f-4981-bf67-9b5bffb537d5"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":9358,"duration_api_ms":8922,"num_turns":1,"result":"interrupt recovery fixture complete","stop_reason":"end_turn","session_id":"fb591f8f-073f-4981-bf67-9b5bffb537d5","total_cost_usd":0.00457485,"usage":{"input_tokens":3,"cache_creation_input_tokens":243,"cache_read_input_tokens":11832,"output_tokens":7,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":243,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[{"input_tokens":3,"output_tokens":7,"cache_read_input_tokens":11832,"cache_creation_input_tokens":243,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":243},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":3,"outputTokens":7,"cacheReadInputTokens":11832,"cacheCreationInputTokens":243,"webSearchRequests":0,"costUSD":0.00457485,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"aaf4e093-6e70-4418-8507-99d62cece13e"}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt_restart/input.ts b/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt_restart/input.ts
new file mode 100644
index 000000000000..c6ecdf6302b5
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/turn_interrupt_restart/input.ts
@@ -0,0 +1,15 @@
+import {
+  TURN_INTERRUPT_MID_TOOL_PROMPT,
+  TURN_INTERRUPT_RECOVERY_PROMPT,
+  type OrchestratorFixtureInput,
+} from "../shared.ts";
+
+export function turnInterruptRestartInput(): OrchestratorFixtureInput {
+  return {
+    steps: [
+      { type: "message", text: TURN_INTERRUPT_MID_TOOL_PROMPT },
+      { type: "interrupt", targetRunIndex: 1, waitForTurnItemType: "command_execution" },
+      { type: "message", text: TURN_INTERRUPT_RECOVERY_PROMPT },
+    ],
+  };
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/web_search/claude_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/web_search/claude_output.ts
new file mode 100644
index 000000000000..4bffd81e7087
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/web_search/claude_output.ts
@@ -0,0 +1,58 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertAssistantTextIncludes,
+  assertBaseProjection,
+  assertConversationMessageRoles,
+  assertExecutionNodeKinds,
+  assertRuntimeRequestCounts,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessagesInclude,
+  assertVisibleTurnItemsMirrorLocalTurnItems,
+  projectionFor,
+  WEB_SEARCH_PROMPT,
+} from "../shared.ts";
+
+const CLAUDE_WEB_SEARCH_QUERY = "FIFA World Cup 2026 ticket pricing";
+
+export function assertClaudeWebSearchOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({ result, transcript, runCount: 1, runStatuses: ["completed"] });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertVisibleTurnItemsMirrorLocalTurnItems(projection);
+  assertExecutionNodeKinds(projection, ["root_turn", "tool_call", "assistant_message"]);
+  assertConversationMessageRoles(projection, ["user", "assistant"]);
+  assertTurnItemTypes(projection, [
+    "user_message",
+    "dynamic_tool",
+    "web_search",
+    "assistant_message",
+  ]);
+  assertRuntimeRequestCounts(projection, { total: 0 });
+  assertUserMessagesInclude(projection, [WEB_SEARCH_PROMPT]);
+  assertAssistantTextIncludes(projection, "web search fixture complete");
+
+  const toolSearchItems = projection.turnItems.filter(
+    (item) => item.type === "dynamic_tool" && item.toolName === "ToolSearch",
+  );
+  assert.lengthOf(toolSearchItems, 1);
+
+  const webSearchItems = projection.turnItems.filter((item) => item.type === "web_search");
+  assert.lengthOf(webSearchItems, 1);
+  const webSearch = webSearchItems[0];
+  assert.isDefined(webSearch);
+  assert.equal(webSearch.status, "completed");
+  assert.include(webSearch.patterns ?? [], CLAUDE_WEB_SEARCH_QUERY);
+  assert.isAtLeast(webSearch.results?.length ?? 0, 1);
+  assert.isTrue(
+    webSearch.results?.some((entry) => entry.url?.includes("fifa.com")) ?? false,
+    "Claude web search should project structured result URLs",
+  );
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/web_search/claude_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/web_search/claude_transcript.ndjson
new file mode 100644
index 000000000000..c4a1a314fdac
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/web_search/claude_transcript.ndjson
@@ -0,0 +1,16 @@
+{"type":"transcript_start","provider":"claudeAgent","protocol":"claude-agent-sdk.query","version":"0.2.111","scenario":"web_search","metadata":{"prompts":["Search the web for FIFA World Cup ticket pricing, then answer exactly: web search fixture complete"],"model":"claude-sonnet-4-6","nativeSessionId":"f5ff7f51-4729-4331-93bd-416f3fdf2d19","queryMode":"streaming","tools":"claude_code","permissionMode":"bypassPermissions","generatedBy":"recordClaudeAgentSdkReplayTranscript"}}
+{"type":"expect_outbound","label":"query.open","frame":{"type":"query.open","options":{"model":"claude-sonnet-4-6","tools":{"type":"preset","preset":"claude_code"},"permissionMode":"bypassPermissions","allowDangerouslySkipPermissions":true,"sessionId":"f5ff7f51-4729-4331-93bd-416f3fdf2d19"}}}
+{"type":"expect_outbound","label":"prompt.offer:1","frame":{"type":"prompt.offer","message":{"type":"user","message":{"role":"user","content":"Search the web for FIFA World Cup ticket pricing, then answer exactly: web search fixture complete"},"parent_tool_use_id":null}}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_started","hook_id":"824ca161-8a1d-45f3-9fac-d5611119d73b","hook_name":"SessionStart:startup","hook_event":"SessionStart","uuid":"37c7a47b-8682-443c-a12c-61b2b3520213","session_id":"f5ff7f51-4729-4331-93bd-416f3fdf2d19"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"hook_response","hook_id":"824ca161-8a1d-45f3-9fac-d5611119d73b","hook_name":"SessionStart:startup","hook_event":"SessionStart","output":"","stdout":"","stderr":"","exit_code":0,"outcome":"success","uuid":"6c2fbe70-34ca-4fd7-be53-7ee413e9ea0c","session_id":"f5ff7f51-4729-4331-93bd-416f3fdf2d19"}}
+{"type":"emit_inbound","label":"system","frame":{"type":"system","subtype":"init","agents":[],"apiKeySource":"none","claude_code_version":"2.1.111","cwd":"/tmp/claude-replay-web_search","tools":[],"mcp_servers":[],"model":"claude-sonnet-4-6","permissionMode":"bypassPermissions","slash_commands":[],"output_style":"default","skills":[],"plugins":[],"fast_mode_state":"off","uuid":"c0128e2f-6a1c-4e08-a6df-e0c9e770e520","session_id":"f5ff7f51-4729-4331-93bd-416f3fdf2d19"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_013ghDLNooL9JjT7LM8dfvKv","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"The user wants me to search the web for FIFA World Cup ticket pricing. Let me use the WebSearch tool for this.","signature":"EqsCClsIDRgCKkAVt/Rl62+yw6rhmmNVYRVjiFAgkjumuFJIsvwCZZL0vIbb2flNthojSzcHnxTJlkEKnkjDIrmmpounw3JVAbBYMhFjbGF1ZGUtc29ubmV0LTQtNjgAEgyfu3NkAC3ykykneaIaDJj7JQdfxEhIV0a5HiIw3XX+IVr+XsX569Exa2UvUqbgWIrbtbQZsePslTE4ej81ZtUtSrsymPeoD9pKnMogKn4w73zb3sYiICwUenD0Hh5XOT9gmutoI6b2xPSbFRTjwnI/B0cqqkF2BS9+Zt+W+j+0jWxVP4/+uhR/wg6zul8LOg0RZZKqHEpYeDIXNYkbENE4EwVNwwhlSUHJ6VAha+TBx9iO2xMz2RJuxQp3PnEhq1Ggp07qewWZQKyHk/AYAQ=="}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":11801,"cache_read_input_tokens":0,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":11801},"output_tokens":0,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"f5ff7f51-4729-4331-93bd-416f3fdf2d19","uuid":"94477848-5d1a-43c5-9845-19ba3d150a6f"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_013ghDLNooL9JjT7LM8dfvKv","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01KGz7z4A7CtpkSnPyMCS7EP","name":"ToolSearch","input":{"query":"select:WebSearch","max_results":1},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":11801,"cache_read_input_tokens":0,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":11801},"output_tokens":0,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"f5ff7f51-4729-4331-93bd-416f3fdf2d19","uuid":"a07dbc7b-03c1-47d7-86d1-653c65d9bbd8"}}
+{"type":"emit_inbound","label":"rate_limit_event","frame":{"type":"rate_limit_event","rate_limit_info":{"status":"allowed"},"uuid":"215ceb84-3aab-4ab5-a044-773fdc7a86f1","session_id":"f5ff7f51-4729-4331-93bd-416f3fdf2d19"}}
+{"type":"emit_inbound","label":"user","frame":{"type":"user","message":{"role":"user","content":[{"type":"tool_result","tool_use_id":"toolu_01KGz7z4A7CtpkSnPyMCS7EP","content":[{"type":"tool_reference","tool_name":"WebSearch"}]}]},"parent_tool_use_id":null,"session_id":"f5ff7f51-4729-4331-93bd-416f3fdf2d19","uuid":"196d5d0d-d6e5-4130-a559-45ad7030542f","timestamp":"2026-05-07T01:18:48.005Z","tool_use_result":{"matches":["WebSearch"],"query":"select:WebSearch","total_deferred_tools":22}}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01YTXwWhu5v3exh54x4Y9mgo","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"Now let me search the web for FIFA World Cup ticket pricing.","signature":"EvkBClsIDRgCKkA45QKRkX3BN5Cgyc8u4q/I7qrBKNidzbBl7AYPkXb013ySNW9pzbwWCWqKsAKp+a8oyT0z0aksj3mKlSf8pcU2MhFjbGF1ZGUtc29ubmV0LTQtNjgAEgzgDr6UfC7FnM/MLd4aDHzA23y4Ui176BzMNSIwSsB7fT9onFB7qo4QK/qJrv8KL7lnlKXtuvo4N+SRBkPNTkBwFbxDeR5ZZaIKQEtQKkxNTo4mSkAL4p+WGarjdfaUrLbEuVN6imJ6esefnk4BEhdH3+tonhzYKezTa2NnxE1zPlSoB7xm/vxGiBMF6kiefrO0XbxrR/FXneFpGAE="}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":644,"cache_read_input_tokens":11801,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":644},"output_tokens":6,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"f5ff7f51-4729-4331-93bd-416f3fdf2d19","uuid":"820d6a9a-f033-493b-ad0a-7554be7dafc1"}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01YTXwWhu5v3exh54x4Y9mgo","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_011fKbh9ER69cDiCCpp93oRG","name":"WebSearch","input":{"query":"FIFA World Cup 2026 ticket pricing"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":3,"cache_creation_input_tokens":644,"cache_read_input_tokens":11801,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":644},"output_tokens":6,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"f5ff7f51-4729-4331-93bd-416f3fdf2d19","uuid":"2b089653-2f18-4833-99d9-c2194073a327"}}
+{"type":"emit_inbound","label":"user","frame":{"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_011fKbh9ER69cDiCCpp93oRG","type":"tool_result","content":"Web search results for query: \"FIFA World Cup 2026 ticket pricing\"\n\nLinks: [{\"title\":\"Tickets - FIFA World Cup 2026™\",\"url\":\"https://www.fifa.com/en/tournaments/mens/worldcup/canadamexicousa2026/tickets\"},{\"title\":\"FIFA chief Infantino defends World Cup ticket prices | World Cup 2026 News | Al Jazeera\",\"url\":\"https://www.aljazeera.com/sports/2026/5/6/fifa-chief-infantino-defends-world-cup-ticket-prices\"},{\"title\":\"World Cup 2026 tickets: Fans slam FIFA's new pricing strategy as tournament availability lingers | FOX 11 Los Angeles\",\"url\":\"https://www.foxla.com/news/world-cup-2026-ticket-prices-fifa-strategy\"},{\"title\":\"Tickets now on sale for FIFA World Cup 2026™ Play-Off ...\",\"url\":\"https://www.fifa.com/en/tournaments/mens/worldcup/canadamexicousa2026/articles/tickets-now-on-sale-for-play-off-tournament\"},{\"title\":\"New ticket pricing tier introduced for fans | FIFA World Cup\",\"url\":\"https://www.fifa.com/en/tournaments/mens/worldcup/canadamexicousa2026/articles/fifa-world-cup-2026-new-ticket-pricing-tier\"},{\"title\":\"How expensive is a 2026 FIFA World Cup ticket? | Britannica\",\"url\":\"https://www.britannica.com/question/How-expensive-is-a-2026-FIFA-World-Cup-ticket\"},{\"title\":\"Why are FIFA World Cup 2026 tickets so expensive? | World Cup 2026 News | Al Jazeera\",\"url\":\"https://www.aljazeera.com/sports/2026/4/23/why-are-fifa-world-cup-2026-tickets-so-expensive\"},{\"title\":\"2026 World Cup Ticket Prices by City | The World Cup Guide\",\"url\":\"https://theworldcupguide.com/2026-world-cup-ticket-prices/\"},{\"title\":\"How Much Do 2026 World Cup Tickets Cost? Complete Price Guide\",\"url\":\"https://www.jetpacglobal.com/blog/fifa-world-cup-2026-ticket-prices/\"},{\"title\":\"Expensive tickets for early World Cup games still on general sale | PBS News\",\"url\":\"https://www.pbs.org/newshour/world/expensive-tickets-for-early-world-cup-games-still-on-general-sale\"}]\n\nBased on the search results, here's what I found about FIFA World Cup 2026 ticket pricing:\n\n## Price Range\n\nTicket prices on the official direct sale platform vary from about $60 to $10,990 depending on factors including the fixture's popularity, the seat category, FIFA's dynamic pricing models, and the date of purchase.\n\n## Specific Examples\n\n- General public entry starts at USD 120.\n- The cheapest tickets currently are $380 for seven different games, including matches like Curacao vs. Ivory Coast in Philadelphia.\n- Tickets for USA vs Paraguay start at $1,120 and go as high as $4,105, with many tickets priced at about $2,000 for the June 12 match in Los Angeles.\n- The most expensive ticket for the final is about $11,000 at its original price.\n\n## Pricing Strategy\n\nOfficial FIFA World Cup 2026 ticket prices use dynamic pricing, meaning costs shift based on match demand, teams, city, and sales phase. Additionally, all prices are subject to a 15% FIFA service fee at checkout.\n\n## Context\n\nThe 2026 FIFA World Cup will be the most expensive in tournament history. Dynamic pricing, three host nations, 104 matches, and record ticket demand have created a pricing environment unlike anything seen at a previous World Cup. FIFA received in excess of 500 million ticket requests for 2026, compared with fewer than 50 million combined for the 2018 and 2022 World Cups.\n\n\nREMINDER: You MUST include the sources above in your response to the user using markdown hyperlinks."}]},"parent_tool_use_id":null,"session_id":"f5ff7f51-4729-4331-93bd-416f3fdf2d19","uuid":"14e14d41-5638-4293-bc96-5b872dc25556","timestamp":"2026-05-07T01:18:56.738Z","tool_use_result":{"query":"FIFA World Cup 2026 ticket pricing","results":[{"tool_use_id":"srvtoolu_01PoQRt4QWnLhDhzXYQJqbsk","content":[{"title":"Tickets - FIFA World Cup 2026™","url":"https://www.fifa.com/en/tournaments/mens/worldcup/canadamexicousa2026/tickets"},{"title":"FIFA chief Infantino defends World Cup ticket prices | World Cup 2026 News | Al Jazeera","url":"https://www.aljazeera.com/sports/2026/5/6/fifa-chief-infantino-defends-world-cup-ticket-prices"},{"title":"World Cup 2026 tickets: Fans slam FIFA's new pricing strategy as tournament availability lingers | FOX 11 Los Angeles","url":"https://www.foxla.com/news/world-cup-2026-ticket-prices-fifa-strategy"},{"title":"Tickets now on sale for FIFA World Cup 2026™ Play-Off ...","url":"https://www.fifa.com/en/tournaments/mens/worldcup/canadamexicousa2026/articles/tickets-now-on-sale-for-play-off-tournament"},{"title":"New ticket pricing tier introduced for fans | FIFA World Cup","url":"https://www.fifa.com/en/tournaments/mens/worldcup/canadamexicousa2026/articles/fifa-world-cup-2026-new-ticket-pricing-tier"},{"title":"How expensive is a 2026 FIFA World Cup ticket? | Britannica","url":"https://www.britannica.com/question/How-expensive-is-a-2026-FIFA-World-Cup-ticket"},{"title":"Why are FIFA World Cup 2026 tickets so expensive? | World Cup 2026 News | Al Jazeera","url":"https://www.aljazeera.com/sports/2026/4/23/why-are-fifa-world-cup-2026-tickets-so-expensive"},{"title":"2026 World Cup Ticket Prices by City | The World Cup Guide","url":"https://theworldcupguide.com/2026-world-cup-ticket-prices/"},{"title":"How Much Do 2026 World Cup Tickets Cost? Complete Price Guide","url":"https://www.jetpacglobal.com/blog/fifa-world-cup-2026-ticket-prices/"},{"title":"Expensive tickets for early World Cup games still on general sale | PBS News","url":"https://www.pbs.org/newshour/world/expensive-tickets-for-early-world-cup-games-still-on-general-sale"}]},"Based on the search results, here's what I found about FIFA World Cup 2026 ticket pricing:\n\n## Price Range\n\nTicket prices on the official direct sale platform vary from about $60 to $10,990 depending on factors including the fixture's popularity, the seat category, FIFA's dynamic pricing models, and the date of purchase.\n\n## Specific Examples\n\n- General public entry starts at USD 120.\n- The cheapest tickets currently are $380 for seven different games, including matches like Curacao vs. Ivory Coast in Philadelphia.\n- Tickets for USA vs Paraguay start at $1,120 and go as high as $4,105, with many tickets priced at about $2,000 for the June 12 match in Los Angeles.\n- The most expensive ticket for the final is about $11,000 at its original price.\n\n## Pricing Strategy\n\nOfficial FIFA World Cup 2026 ticket prices use dynamic pricing, meaning costs shift based on match demand, teams, city, and sales phase. Additionally, all prices are subject to a 15% FIFA service fee at checkout.\n\n## Context\n\nThe 2026 FIFA World Cup will be the most expensive in tournament history. Dynamic pricing, three host nations, 104 matches, and record ticket demand have created a pricing environment unlike anything seen at a previous World Cup. FIFA received in excess of 500 million ticket requests for 2026, compared with fewer than 50 million combined for the 2018 and 2022 World Cups."],"durationSeconds":6.5914467089999995}}}
+{"type":"emit_inbound","label":"assistant","frame":{"type":"assistant","message":{"model":"claude-sonnet-4-6","id":"msg_01Cu2HWhZV3Mp5ukA4H97kP7","type":"message","role":"assistant","content":[{"type":"text","text":"web search fixture complete\n\nSources:\n- [Tickets - FIFA World Cup 2026™](https://www.fifa.com/en/tournaments/mens/worldcup/canadamexicousa2026/tickets)\n- [FIFA chief Infantino defends World Cup ticket prices | Al Jazeera](https://www.aljazeera.com/sports/2026/5/6/fifa-chief-infantino-defends-world-cup-ticket-prices)\n- [Why are FIFA World Cup 2026 tickets so expensive? | Al Jazeera](https://www.aljazeera.com/sports/2026/4/23/why-are-fifa-world-cup-2026-tickets-so-expensive)\n- [2026 World Cup Ticket Prices by City | The World Cup Guide](https://theworldcupguide.com/2026-world-cup-ticket-prices/)\n- [How Much Do 2026 World Cup Tickets Cost? | Jetpac Global](https://www.jetpacglobal.com/blog/fifa-world-cup-2026-ticket-prices/)"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":1,"cache_creation_input_tokens":1065,"cache_read_input_tokens":12445,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":1065},"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"context_management":null},"parent_tool_use_id":null,"session_id":"f5ff7f51-4729-4331-93bd-416f3fdf2d19","uuid":"84c57a60-1b00-4e0c-a34a-b6431a3b5590"}}
+{"type":"emit_inbound","label":"result","frame":{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":15297,"duration_api_ms":14227,"num_turns":3,"result":"web search fixture complete\n\nSources:\n- [Tickets - FIFA World Cup 2026™](https://www.fifa.com/en/tournaments/mens/worldcup/canadamexicousa2026/tickets)\n- [FIFA chief Infantino defends World Cup ticket prices | Al Jazeera](https://www.aljazeera.com/sports/2026/5/6/fifa-chief-infantino-defends-world-cup-ticket-prices)\n- [Why are FIFA World Cup 2026 tickets so expensive? | Al Jazeera](https://www.aljazeera.com/sports/2026/4/23/why-are-fifa-world-cup-2026-tickets-so-expensive)\n- [2026 World Cup Ticket Prices by City | The World Cup Guide](https://theworldcupguide.com/2026-world-cup-ticket-prices/)\n- [How Much Do 2026 World Cup Tickets Cost? | Jetpac Global](https://www.jetpacglobal.com/blog/fifa-world-cup-2026-ticket-prices/)","stop_reason":"end_turn","session_id":"f5ff7f51-4729-4331-93bd-416f3fdf2d19","total_cost_usd":0.09358280000000001,"usage":{"input_tokens":7,"cache_creation_input_tokens":13510,"cache_read_input_tokens":24246,"output_tokens":471,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":13510,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[{"input_tokens":1,"output_tokens":268,"cache_read_input_tokens":12445,"cache_creation_input_tokens":1065,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":1065},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-sonnet-4-6":{"inputTokens":7,"outputTokens":471,"cacheReadInputTokens":24246,"cacheCreationInputTokens":13510,"webSearchRequests":0,"costUSD":0.0650223,"contextWindow":200000,"maxOutputTokens":32000},"claude-haiku-4-5-20251001":{"inputTokens":2363,"outputTokens":524,"cacheReadInputTokens":0,"cacheCreationInputTokens":10862,"webSearchRequests":1,"costUSD":0.028560500000000003,"contextWindow":200000,"maxOutputTokens":32000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"b0c24262-d526-4ef7-b0d6-92b91e51915c"}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/web_search/codex_output.ts b/apps/server/src/orchestration-v2/testkit/fixtures/web_search/codex_output.ts
new file mode 100644
index 000000000000..eeae90be4440
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/web_search/codex_output.ts
@@ -0,0 +1,41 @@
+import { assert } from "@effect/vitest";
+import type { ProviderReplayTranscript } from "@t3tools/contracts";
+
+import type { OrchestratorV2ScenarioResult } from "../../OrchestratorScenario.ts";
+import {
+  assertAssistantTextIncludes,
+  assertBaseProjection,
+  assertConversationMessageRoles,
+  assertExecutionNodeKinds,
+  assertRuntimeRequestCounts,
+  assertSemanticProjectionIntegrity,
+  assertTurnItemTypes,
+  assertUserMessagesInclude,
+  assertVisibleTurnItemsMirrorLocalTurnItems,
+  projectionFor,
+  WEB_SEARCH_PROMPT,
+} from "../shared.ts";
+
+const WEB_SEARCH_QUERY = "FIFA World Cup 2026 ticket prices official";
+
+export function assertWebSearchOutput(
+  result: OrchestratorV2ScenarioResult,
+  transcript: ProviderReplayTranscript,
+) {
+  assertBaseProjection({ result, transcript, runCount: 1, runStatuses: ["completed"] });
+
+  const projection = projectionFor(result, transcript.scenario);
+  assertSemanticProjectionIntegrity(projection);
+  assertVisibleTurnItemsMirrorLocalTurnItems(projection);
+  assertExecutionNodeKinds(projection, ["root_turn", "tool_call", "assistant_message"]);
+  assertConversationMessageRoles(projection, ["user", "assistant"]);
+  assertTurnItemTypes(projection, ["user_message", "web_search", "assistant_message"]);
+  assertRuntimeRequestCounts(projection, { total: 0 });
+  assertUserMessagesInclude(projection, [WEB_SEARCH_PROMPT]);
+  assertAssistantTextIncludes(projection, "web search fixture complete");
+
+  const webSearchItems = projection.turnItems.filter((item) => item.type === "web_search");
+  assert.lengthOf(webSearchItems, 1);
+  assert.equal(webSearchItems[0]?.status, "completed");
+  assert.include(webSearchItems[0]?.patterns ?? [], WEB_SEARCH_QUERY);
+}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/web_search/codex_transcript.ndjson b/apps/server/src/orchestration-v2/testkit/fixtures/web_search/codex_transcript.ndjson
new file mode 100644
index 000000000000..d6cb3077e442
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/web_search/codex_transcript.ndjson
@@ -0,0 +1,22 @@
+{"type":"transcript_start","provider":"codex","protocol":"codex.app-server","version":"0.120.0","scenario":"web_search","metadata":{"source":"codex-app-server-probe","fileName":"web_search.ndjson","description":"One turn with a native Codex webSearch item that should become normalized progress."}}
+{"type":"expect_outbound","label":"initialize","frame":{"id":1,"method":"initialize","params":{"capabilities":{"experimentalApi":true},"clientInfo":{"name":"t3code_desktop","title":"T3 Code Desktop","version":"0.1.0"}}}}
+{"type":"emit_inbound","label":"initialize","frame":{"id":1,"result":{"userAgent":"t3code_desktop/0.120.0 (Mac OS 26.4.1; arm64) dumb (t3code_desktop; 0.1.0)","codexHome":"/Users/julius/.codex","platformFamily":"unix","platformOs":"macos"}}}
+{"type":"expect_outbound","label":"initialized","frame":{"method":"initialized"}}
+{"type":"expect_outbound","label":"thread/start","frame":{"id":2,"method":"thread/start","params":{}}}
+{"type":"emit_inbound","label":"thread/start","frame":{"id":2,"result":{"thread":{"id":"019db20e-d982-70e9-a996-8e56a2f7968d","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1776819600,"updatedAt":1776819600,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/04/21/rollout-2026-04-21T18-00-00-019db20e-d982-70e9-a996-8e56a2f7968d.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1","cliVersion":"0.120.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]},"model":"gpt-5.4","modelProvider":"openai","serviceTier":"fast","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1","approvalPolicy":"on-request","approvalsReviewer":"user","sandbox":{"type":"workspaceWrite","writableRoots":["/Users/julius/.codex/memories"],"readOnlyAccess":{"type":"fullAccess"},"networkAccess":false,"excludeTmpdirEnvVar":false,"excludeSlashTmp":false},"reasoningEffort":"xhigh"}}}
+{"type":"expect_outbound","label":"turn/start","frame":{"id":3,"method":"turn/start","params":{"approvalPolicy":"never","cwd":"<workspace>","input":[{"text":"Search the web for FIFA World Cup ticket pricing, then answer exactly: web search fixture complete","type":"text"}],"model":"gpt-5.4","sandboxPolicy":{"type":"dangerFullAccess"},"threadId":"019db20e-d982-70e9-a996-8e56a2f7968d","approvalsReviewer":"user"}}}
+{"type":"emit_inbound","label":"thread/started","frame":{"method":"thread/started","params":{"thread":{"id":"019db20e-d982-70e9-a996-8e56a2f7968d","forkedFromId":null,"preview":"","ephemeral":false,"modelProvider":"openai","createdAt":1776819600,"updatedAt":1776819600,"status":{"type":"idle"},"path":"/Users/julius/.codex/sessions/2026/04/21/rollout-2026-04-21T18-00-00-019db20e-d982-70e9-a996-8e56a2f7968d.jsonl","cwd":"/Users/julius/.t3/worktrees/codething-mvp/t3code-c1e5e1d1","cliVersion":"0.120.0","source":"vscode","agentNickname":null,"agentRole":null,"gitInfo":null,"name":null,"turns":[]}}}}
+{"type":"emit_inbound","label":"turn/start","frame":{"id":3,"result":{"turn":{"id":"019db20e-d98f-73c1-bb7e-e5d2dd9a77cf","items":[],"status":"inProgress","error":null,"startedAt":null,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019db20e-d982-70e9-a996-8e56a2f7968d","status":{"type":"active","activeFlags":[]}}}}
+{"type":"emit_inbound","label":"turn/started","frame":{"method":"turn/started","params":{"threadId":"019db20e-d982-70e9-a996-8e56a2f7968d","turn":{"id":"019db20e-d98f-73c1-bb7e-e5d2dd9a77cf","items":[],"status":"inProgress","error":null,"startedAt":1776819600,"completedAt":null,"durationMs":null}}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"userMessage","id":"a089d29b-7d1a-4b02-b628-5a5c4210a7ad","content":[{"type":"text","text":"Search the web for FIFA World Cup ticket pricing, then answer exactly: web search fixture complete","text_elements":[]}]},"threadId":"019db20e-d982-70e9-a996-8e56a2f7968d","turnId":"019db20e-d98f-73c1-bb7e-e5d2dd9a77cf"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"userMessage","id":"a089d29b-7d1a-4b02-b628-5a5c4210a7ad","content":[{"type":"text","text":"Search the web for FIFA World Cup ticket pricing, then answer exactly: web search fixture complete","text_elements":[]}]},"threadId":"019db20e-d982-70e9-a996-8e56a2f7968d","turnId":"019db20e-d98f-73c1-bb7e-e5d2dd9a77cf"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"webSearch","id":"ws_019db20f2b4d741ca59b7931c377143d","query":"","action":{"type":"other"}},"threadId":"019db20e-d982-70e9-a996-8e56a2f7968d","turnId":"019db20e-d98f-73c1-bb7e-e5d2dd9a77cf"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"webSearch","id":"ws_019db20f2b4d741ca59b7931c377143d","query":"FIFA World Cup 2026 ticket prices official","action":{"type":"search","query":"FIFA World Cup 2026 ticket prices official","queries":["FIFA World Cup 2026 ticket prices official"]}},"threadId":"019db20e-d982-70e9-a996-8e56a2f7968d","turnId":"019db20e-d98f-73c1-bb7e-e5d2dd9a77cf"}}}
+{"type":"emit_inbound","label":"item/started","frame":{"method":"item/started","params":{"item":{"type":"agentMessage","id":"msg_0b4f006af9ba4fd99d08163d5945120a","text":"","phase":"final_answer","memoryCitation":null},"threadId":"019db20e-d982-70e9-a996-8e56a2f7968d","turnId":"019db20e-d98f-73c1-bb7e-e5d2dd9a77cf"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db20e-d982-70e9-a996-8e56a2f7968d","turnId":"019db20e-d98f-73c1-bb7e-e5d2dd9a77cf","itemId":"msg_0b4f006af9ba4fd99d08163d5945120a","delta":"web search"}}}
+{"type":"emit_inbound","label":"item/agentMessage/delta","frame":{"method":"item/agentMessage/delta","params":{"threadId":"019db20e-d982-70e9-a996-8e56a2f7968d","turnId":"019db20e-d98f-73c1-bb7e-e5d2dd9a77cf","itemId":"msg_0b4f006af9ba4fd99d08163d5945120a","delta":" fixture complete"}}}
+{"type":"emit_inbound","label":"item/completed","frame":{"method":"item/completed","params":{"item":{"type":"agentMessage","id":"msg_0b4f006af9ba4fd99d08163d5945120a","text":"web search fixture complete","phase":"final_answer","memoryCitation":null},"threadId":"019db20e-d982-70e9-a996-8e56a2f7968d","turnId":"019db20e-d98f-73c1-bb7e-e5d2dd9a77cf"}}}
+{"type":"emit_inbound","label":"thread/status/changed","frame":{"method":"thread/status/changed","params":{"threadId":"019db20e-d982-70e9-a996-8e56a2f7968d","status":{"type":"idle"}}}}
+{"type":"emit_inbound","label":"turn/completed","frame":{"method":"turn/completed","params":{"threadId":"019db20e-d982-70e9-a996-8e56a2f7968d","turn":{"id":"019db20e-d98f-73c1-bb7e-e5d2dd9a77cf","items":[],"status":"completed","error":null,"startedAt":1776819600,"completedAt":1776819610,"durationMs":10000}}}}
+{"type":"runtime_exit","status":"success"}
diff --git a/apps/server/src/orchestration-v2/testkit/fixtures/web_search/input.ts b/apps/server/src/orchestration-v2/testkit/fixtures/web_search/input.ts
new file mode 100644
index 000000000000..9de95fe069bf
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/fixtures/web_search/input.ts
@@ -0,0 +1,7 @@
+import { type OrchestratorFixtureInput, WEB_SEARCH_PROMPT } from "../shared.ts";
+
+export function webSearchInput(): OrchestratorFixtureInput {
+  return {
+    steps: [{ type: "message", text: WEB_SEARCH_PROMPT }],
+  };
+}
diff --git a/apps/server/src/orchestration-v2/testkit/index.ts b/apps/server/src/orchestration-v2/testkit/index.ts
new file mode 100644
index 000000000000..17b95ad8d94e
--- /dev/null
+++ b/apps/server/src/orchestration-v2/testkit/index.ts
@@ -0,0 +1,4 @@
+export * from "./DeterministicRuntime.ts";
+export * from "./OrchestratorScenario.ts";
+export * from "./ProviderReplayHarness.ts";
+export * from "./ReplayTranscriptNdjson.ts";
diff --git a/apps/server/src/orchestration-v2/threadHistoryPaging.test.ts b/apps/server/src/orchestration-v2/threadHistoryPaging.test.ts
new file mode 100644
index 000000000000..2b588d45ec51
--- /dev/null
+++ b/apps/server/src/orchestration-v2/threadHistoryPaging.test.ts
@@ -0,0 +1,621 @@
+import {
+  MessageId,
+  NodeId,
+  RunId,
+  ThreadId,
+  TurnItemId,
+  type OrchestrationV2ProjectedTurnItem,
+  type OrchestrationV2TurnItem,
+} from "@t3tools/contracts";
+import { describe, expect, it } from "@effect/vitest";
+import * as DateTime from "effect/DateTime";
+
+import {
+  buildBoundedThreadProjection,
+  boundedTimelineEncodedBytes,
+  computeLatestLocalTurnOrdinal,
+  decodeThreadHistoryCursor,
+  encodeThreadHistoryCursor,
+  InvalidThreadHistoryCursorError,
+  projectedRowBoundedSnapshotEncodedBytes,
+  projectedRowEncodedBytes,
+  selectHistoryPageFromCursor,
+  selectRecentTimelineWindow,
+  THREAD_HISTORY_CURSOR_MAX_LENGTH,
+  THREAD_HISTORY_PAGE_POLICY,
+} from "./threadHistoryPaging.ts";
+import { projectThreadProjectionForWire } from "./WireProjection.ts";
+
+const NOW = DateTime.makeUnsafe("2026-06-20T00:00:00.000Z");
+const THREAD = ThreadId.make("thread-1");
+const RUN = RunId.make("run-interrupt-1");
+const NODE = NodeId.make("node-interrupt-1");
+
+function makeRow(
+  index: number,
+  options?: { readonly outputBytes?: number },
+): OrchestrationV2ProjectedTurnItem {
+  const id = TurnItemId.make(`item-${index}`);
+  const output =
+    options?.outputBytes !== undefined ? "x".repeat(options.outputBytes) : `output-${index}`;
+  return {
+    position: index,
+    visibility: "local",
+    sourceThreadId: THREAD,
+    sourceItemId: id,
+    item: {
+      id,
+      type: "command_execution",
+      threadId: THREAD,
+      runId: null,
+      nodeId: null,
+      providerThreadId: null,
+      providerTurnId: null,
+      nativeItemRef: null,
+      parentItemId: null,
+      ordinal: index + 1,
+      status: "completed",
+      title: `Command ${index}`,
+      input: `cmd-${index}`,
+      output,
+      exitCode: 0,
+      startedAt: NOW,
+      completedAt: NOW,
+      updatedAt: NOW,
+    },
+  };
+}
+
+function interruptItem(
+  id: string,
+  type: "run_interrupt_request" | "run_interrupt_result",
+  ordinal: number,
+): OrchestrationV2TurnItem {
+  return {
+    id: TurnItemId.make(id),
+    type,
+    threadId: THREAD,
+    runId: RUN,
+    nodeId: NODE,
+    providerThreadId: null,
+    providerTurnId: null,
+    nativeItemRef: null,
+    parentItemId: null,
+    ordinal,
+    status: "completed",
+    title: type,
+    message: type === "run_interrupt_request" ? "Stopping" : "Stopped",
+    startedAt: NOW,
+    completedAt: NOW,
+    updatedAt: NOW,
+  } as OrchestrationV2TurnItem;
+}
+
+function interruptRow(
+  index: number,
+  type: "run_interrupt_request" | "run_interrupt_result",
+): OrchestrationV2ProjectedTurnItem {
+  const item = interruptItem(
+    type === "run_interrupt_request" ? "interrupt-req" : "interrupt-res",
+    type,
+    index + 1,
+  );
+  return {
+    position: index,
+    visibility: "local",
+    sourceThreadId: THREAD,
+    sourceItemId: item.id,
+    item,
+  };
+}
+
+function makeProjection(visibleTurnItems: OrchestrationV2ProjectedTurnItem[]) {
+  return {
+    thread: {
+      id: THREAD,
+      projectId: "project-1",
+      title: "Thread",
+      providerInstanceId: "codex",
+      modelSelection: { instanceId: "codex", model: "gpt-5" },
+      runtimeMode: "full-access",
+      interactionMode: "default",
+      branch: null,
+      worktreePath: null,
+      activeProviderThreadId: null,
+      lineage: {
+        parentThreadId: null,
+        relationshipToParent: null,
+        rootThreadId: THREAD,
+      },
+      forkedFrom: null,
+      createdBy: "user",
+      creationSource: "web",
+      createdAt: NOW,
+      updatedAt: NOW,
+      archivedAt: null,
+      deletedAt: null,
+      settledOverride: null,
+      settledAt: null,
+    },
+    runs: [{ id: "run-1" }],
+    attempts: [{ id: "attempt-1" }],
+    nodes: [],
+    subagents: [],
+    providerSessions: [],
+    providerThreads: [],
+    providerTurns: [],
+    runtimeRequests: [{ id: "req-1" }],
+    messages: [],
+    plans: [],
+    turnItems: visibleTurnItems.map((row) => row.item),
+    checkpointScopes: [],
+    checkpoints: [],
+    contextHandoffs: [],
+    contextTransfers: [],
+    visibleTurnItems,
+    updatedAt: NOW,
+  } as unknown as Parameters<typeof buildBoundedThreadProjection>[0]["projection"];
+}
+
+describe("threadHistoryPaging", () => {
+  it("encodes opaque cursors with stable source identity", () => {
+    const cursor = encodeThreadHistoryCursor({
+      snapshotSequence: 9,
+      sourceThreadId: THREAD,
+      sourceItemId: TurnItemId.make("item-3"),
+      position: 3,
+    });
+    expect(cursor.includes("{")).toBe(false);
+    expect(decodeThreadHistoryCursor(cursor)).toEqual({
+      v: 1,
+      seq: 9,
+      st: "thread-1",
+      si: "item-3",
+      p: 3,
+    });
+  });
+
+  it("rejects malformed cursors", () => {
+    expect(() => decodeThreadHistoryCursor("not-valid")).toThrow(InvalidThreadHistoryCursorError);
+    expect(() =>
+      decodeThreadHistoryCursor(Buffer.from("{}", "utf8").toString("base64url")),
+    ).toThrow(InvalidThreadHistoryCursorError);
+  });
+
+  it("rejects cursors longer than the maximum length before decoding", () => {
+    const oversized = "A".repeat(THREAD_HISTORY_CURSOR_MAX_LENGTH + 1);
+    expect(() => decodeThreadHistoryCursor(oversized)).toThrow(InvalidThreadHistoryCursorError);
+  });
+
+  it("selects a recent window by item count", () => {
+    const items = Array.from({ length: 120 }, (_, index) => makeRow(index));
+    const page = selectRecentTimelineWindow({
+      items,
+      snapshotSequence: 4,
+      policy: { maxItems: 10, maxEncodedBytes: 10_000_000 },
+    });
+    expect(page.items).toHaveLength(10);
+    expect(page.items[0]?.sourceItemId).toBe("item-110");
+    expect(page.items[9]?.sourceItemId).toBe("item-119");
+    expect(page.hasMoreHistory).toBe(true);
+    expect(page.nextCursor).not.toBeNull();
+    const cursor = decodeThreadHistoryCursor(page.nextCursor!);
+    expect(cursor.si).toBe("item-110");
+    expect(cursor.seq).toBe(4);
+  });
+
+  it("always includes at least one pathological oversized item", () => {
+    const items = [makeRow(0, { outputBytes: 2_000_000 }), makeRow(1, { outputBytes: 10 })];
+    const page = selectRecentTimelineWindow({
+      items,
+      snapshotSequence: 1,
+      policy: { maxItems: 50, maxEncodedBytes: 1_024 },
+    });
+    expect(page.items).toHaveLength(1);
+    expect(page.items[0]?.sourceItemId).toBe("item-1");
+    expect(page.hasMoreHistory).toBe(true);
+
+    const older = selectHistoryPageFromCursor({
+      items,
+      cursor: page.nextCursor!,
+      snapshotSequence: 1,
+      policy: { maxItems: 50, maxEncodedBytes: 1_024 },
+    });
+    expect(older.items).toHaveLength(1);
+    expect(older.items[0]?.sourceItemId).toBe("item-0");
+    expect(older.hasMoreHistory).toBe(false);
+    expect(older.nextCursor).toBeNull();
+  });
+
+  it("recovers identity-miss cursors when position is past a shrunken timeline", () => {
+    const items = Array.from({ length: 5 }, (_, index) => makeRow(index));
+    const cursor = encodeThreadHistoryCursor({
+      snapshotSequence: 3,
+      sourceThreadId: THREAD,
+      sourceItemId: TurnItemId.make("item-deleted-long-ago"),
+      position: 40,
+    });
+    const page = selectHistoryPageFromCursor({
+      items,
+      cursor,
+      snapshotSequence: 3,
+      policy: { maxItems: 2, maxEncodedBytes: 10_000_000 },
+    });
+    // Clamp exclusive end to items.length and page backward so the client can
+    // dedupe and advance rather than permanently 400 on a dead cursor.
+    expect(page.items.map((row) => row.sourceItemId)).toEqual(["item-3", "item-4"]);
+    expect(page.hasMoreHistory).toBe(true);
+    expect(page.nextCursor).not.toBeNull();
+  });
+
+  it("keeps cursor resolution stable when newer items append", () => {
+    const initial = Array.from({ length: 20 }, (_, index) => makeRow(index));
+    const recent = selectRecentTimelineWindow({
+      items: initial,
+      snapshotSequence: 2,
+      policy: { maxItems: 5, maxEncodedBytes: 10_000_000 },
+    });
+    const cursor = recent.nextCursor!;
+    const grown = [...initial, makeRow(20), makeRow(21)];
+    const older = selectHistoryPageFromCursor({
+      items: grown,
+      cursor,
+      snapshotSequence: 5,
+      policy: { maxItems: 5, maxEncodedBytes: 10_000_000 },
+    });
+    expect(older.items.map((row) => row.sourceItemId)).toEqual([
+      "item-10",
+      "item-11",
+      "item-12",
+      "item-13",
+      "item-14",
+    ]);
+    expect(older.hasMoreHistory).toBe(true);
+  });
+
+  it("builds a bounded projection that preserves non-timeline control state", () => {
+    const full = makeProjection(Array.from({ length: 40 }, (_, index) => makeRow(index)));
+    const bounded = buildBoundedThreadProjection({
+      projection: full,
+      snapshotSequence: 7,
+      policy: { maxItems: 5, maxEncodedBytes: 10_000_000 },
+    });
+    expect(bounded.projection.runs).toEqual(full.runs);
+    expect(bounded.projection.runtimeRequests).toEqual(full.runtimeRequests);
+    expect(bounded.projection.attempts).toEqual(full.attempts);
+    expect(bounded.projection.visibleTurnItems).toHaveLength(5);
+    expect(bounded.projection.turnItems).toHaveLength(5);
+    expect(bounded.hasMoreHistory).toBe(true);
+    expect(bounded.historyCursor).not.toBeNull();
+    expect(bounded.projection.visibleTurnItems.map((row) => row.position)).toEqual([0, 1, 2, 3, 4]);
+    // Watermark comes from the full projection, not the trimmed window.
+    expect(bounded.latestLocalTurnOrdinal).toBe(40);
+    expect(computeLatestLocalTurnOrdinal(full.turnItems)).toBe(40);
+  });
+
+  it("preserves linked control rows as one coherent graph", () => {
+    const base = makeProjection(Array.from({ length: 40 }, (_, index) => makeRow(index)));
+    const linked = {
+      ...base,
+      runs: [{ id: "run-linked", threadId: THREAD }],
+      attempts: [{ id: "attempt-linked", runId: "run-linked" }],
+      nodes: [{ id: "node-linked", runId: "run-linked", attemptId: "attempt-linked" }],
+      providerThreads: [{ id: "provider-thread-linked", runId: "run-linked" }],
+      providerTurns: [
+        {
+          id: "provider-turn-linked",
+          providerThreadId: "provider-thread-linked",
+          nodeId: "node-linked",
+        },
+      ],
+      checkpointScopes: [{ id: "scope-linked", runId: "run-linked" }],
+      checkpoints: [{ id: "checkpoint-linked", scopeId: "scope-linked" }],
+    } as unknown as typeof base;
+
+    const bounded = buildBoundedThreadProjection({
+      projection: linked,
+      snapshotSequence: 7,
+      policy: { maxItems: 5, maxEncodedBytes: 10_000_000 },
+    });
+
+    expect(bounded.projection.runs).toEqual(linked.runs);
+    expect(bounded.projection.attempts).toEqual(linked.attempts);
+    expect(bounded.projection.nodes).toEqual(linked.nodes);
+    expect(bounded.projection.providerThreads).toEqual(linked.providerThreads);
+    expect(bounded.projection.providerTurns).toEqual(linked.providerTurns);
+    expect(bounded.projection.checkpointScopes).toEqual(linked.checkpointScopes);
+    expect(bounded.projection.checkpoints).toEqual(linked.checkpoints);
+  });
+
+  it("carries a full-projection watermark when the bounded window is inherited-only", () => {
+    const localOlder = makeRow(0);
+    const localMid = makeRow(1);
+    const inherited = {
+      ...makeRow(2),
+      visibility: "inherited" as const,
+      sourceThreadId: ThreadId.make("parent-thread"),
+      item: {
+        ...makeRow(2).item,
+        threadId: ThreadId.make("parent-thread"),
+      },
+    };
+    // Full projection still has local turnItems even if the recent window is
+    // only the inherited row (e.g. after aggressive byte budget on a large
+    // local item that is not selected into the recent page). Use a synthetic
+    // projection with local turnItems and inherited-only visible window.
+    const full = makeProjection([localOlder, localMid, inherited]);
+    // Force an inherited-only visible window by rebuilding with only inherited
+    // visible rows while retaining full local turnItems for the watermark.
+    const inheritedOnly = {
+      ...full,
+      visibleTurnItems: [inherited],
+      turnItems: [localOlder.item, localMid.item],
+    };
+    const bounded = buildBoundedThreadProjection({
+      projection: inheritedOnly,
+      snapshotSequence: 2,
+      policy: { maxItems: 1, maxEncodedBytes: 10_000_000 },
+    });
+    expect(bounded.projection.visibleTurnItems.map((row) => String(row.sourceItemId))).toEqual([
+      String(inherited.sourceItemId),
+    ]);
+    expect(bounded.latestLocalTurnOrdinal).toBe(2);
+    expect(computeLatestLocalTurnOrdinal([])).toBeNull();
+  });
+
+  it("retains an out-of-window run_interrupt_request needed by a visible result", () => {
+    // Older request sits outside a 1-row recent window; result is visible alone.
+    const request = interruptRow(0, "run_interrupt_request");
+    const filler = makeRow(1);
+    const result = interruptRow(2, "run_interrupt_result");
+    const full = makeProjection([request, filler, result]);
+    const bounded = buildBoundedThreadProjection({
+      projection: full,
+      snapshotSequence: 3,
+      policy: { maxItems: 1, maxEncodedBytes: 10_000_000 },
+    });
+
+    expect(bounded.projection.visibleTurnItems.map((row) => String(row.sourceItemId))).toEqual([
+      "interrupt-res",
+    ]);
+    expect(bounded.projection.turnItems.map((item) => String(item.id)).sort()).toEqual([
+      "interrupt-req",
+      "interrupt-res",
+    ]);
+    expect(bounded.hasMoreHistory).toBe(true);
+  });
+
+  it("retains all run_interrupt_request items even when no result is in the initial window", () => {
+    // Cold open: recent window is only filler. Request and result both live on
+    // older pages, but the request must still ride in turnItems so a later
+    // history page can introduce the result safely under live attempt updates.
+    const request = interruptRow(0, "run_interrupt_request");
+    const result = interruptRow(1, "run_interrupt_result");
+    const recent = makeRow(2);
+    const full = makeProjection([request, result, recent]);
+    const bounded = buildBoundedThreadProjection({
+      projection: full,
+      snapshotSequence: 4,
+      policy: { maxItems: 1, maxEncodedBytes: 10_000_000 },
+    });
+
+    expect(bounded.projection.visibleTurnItems.map((row) => String(row.sourceItemId))).toEqual([
+      "item-2",
+    ]);
+    expect(bounded.projection.turnItems.map((item) => String(item.id)).sort()).toEqual([
+      "interrupt-req",
+      "item-2",
+    ]);
+    expect(bounded.projection.turnItems.some((item) => item.type === "run_interrupt_request")).toBe(
+      true,
+    );
+    expect(bounded.projection.turnItems.some((item) => item.type === "run_interrupt_result")).toBe(
+      false,
+    );
+  });
+
+  it("charges local row.item duplication when measuring bounded timeline bytes", () => {
+    const rows = Array.from({ length: 8 }, (_, index) => makeRow(index, { outputBytes: 2_000 }));
+    const full = makeProjection(rows);
+    const maxEncodedBytes = 12_000;
+    const bounded = buildBoundedThreadProjection({
+      projection: full,
+      snapshotSequence: 1,
+      policy: { maxItems: 50, maxEncodedBytes },
+    });
+
+    const contribution = boundedTimelineEncodedBytes({
+      visibleTurnItems: bounded.projection.visibleTurnItems,
+      turnItems: bounded.projection.turnItems,
+    });
+    expect(contribution).toBeLessThanOrEqual(maxEncodedBytes);
+    expect(bounded.projection.visibleTurnItems.length).toBeGreaterThan(0);
+    expect(bounded.projection.visibleTurnItems.length).toBeLessThan(rows.length);
+
+    // History pages only charge the projected row once (no turnItems copy).
+    const historyPage = selectRecentTimelineWindow({
+      items: rows,
+      snapshotSequence: 1,
+      policy: { maxItems: 50, maxEncodedBytes },
+    });
+    const historyBytes = historyPage.items.reduce(
+      (sum, row) => sum + projectedRowEncodedBytes(row),
+      0,
+    );
+    expect(historyBytes).toBeLessThanOrEqual(maxEncodedBytes);
+    expect(historyPage.items.length).toBeGreaterThan(bounded.projection.visibleTurnItems.length);
+
+    // Dual-cost for one local row exceeds the plain row cost.
+    const sample = rows[0]!;
+    expect(projectedRowBoundedSnapshotEncodedBytes(sample, THREAD)).toBeGreaterThan(
+      projectedRowEncodedBytes(sample),
+    );
+  });
+
+  it("allows a single pathological bounded row to exceed the configured cap", () => {
+    const huge = makeRow(0, { outputBytes: 50_000 });
+    const full = makeProjection([huge]);
+    const maxEncodedBytes = 1_000;
+    const bounded = buildBoundedThreadProjection({
+      projection: full,
+      snapshotSequence: 1,
+      policy: { maxItems: 10, maxEncodedBytes },
+    });
+    expect(bounded.projection.visibleTurnItems).toHaveLength(1);
+    const contribution = boundedTimelineEncodedBytes({
+      visibleTurnItems: bounded.projection.visibleTurnItems,
+      turnItems: bounded.projection.turnItems,
+    });
+    expect(contribution).toBeGreaterThan(maxEncodedBytes);
+  });
+
+  it("exposes conservative default page budgets", () => {
+    expect(THREAD_HISTORY_PAGE_POLICY.maxItems).toBeGreaterThanOrEqual(50);
+    expect(THREAD_HISTORY_PAGE_POLICY.maxItems).toBeLessThanOrEqual(100);
+    expect(THREAD_HISTORY_PAGE_POLICY.maxEncodedBytes).toBe(1_048_576);
+  });
+
+  it("does not carry the full duplicated message table into a bounded snapshot", () => {
+    const projection = makeProjection(Array.from({ length: 120 }, (_, index) => makeRow(index)));
+    const full = {
+      ...projection,
+      messages: Array.from({ length: 2_000 }, (_, index) => ({
+        id: MessageId.make(`message-${index}`),
+        threadId: THREAD,
+        runId: RunId.make(`old-run-${index}`),
+        nodeId: null,
+        role: "assistant" as const,
+        text: "x".repeat(1_000),
+        attachments: [],
+        streaming: false,
+        createdBy: "agent" as const,
+        creationSource: "provider" as const,
+        createdAt: NOW,
+        updatedAt: NOW,
+      })),
+    } as typeof projection;
+
+    const bounded = buildBoundedThreadProjection({
+      projection: full,
+      snapshotSequence: 9,
+    });
+
+    expect(bounded.projection.messages).toEqual([]);
+    expect(Buffer.byteLength(JSON.stringify(bounded.projection), "utf8")).toBeLessThan(
+      THREAD_HISTORY_PAGE_POLICY.maxEncodedBytes + 100_000,
+    );
+  });
+
+  it("omits historical control details that remain available from history items", () => {
+    const projection = makeProjection(Array.from({ length: 200 }, (_, index) => makeRow(index)));
+    const populated = {
+      ...projection,
+      plans: Array.from({ length: 120 }, (_, index) => ({
+        id: `plan-${index}`,
+        threadId: THREAD,
+        runId: null,
+        nodeId: `node-${index}`,
+        status: "completed",
+        kind: "proposed_plan",
+        markdown: "p".repeat(2_097_152),
+      })),
+      contextHandoffs: Array.from({ length: 120 }, (_, index) => ({
+        id: `handoff-${index}`,
+        threadId: THREAD,
+        targetRunId: "run-1",
+        fromProviderThreadIds: [],
+        toProviderThreadId: "provider-thread-1",
+        coveredRunOrdinals: { from: 1, to: 1 },
+        strategy: "manual_context",
+        status: "superseded",
+        summaryMessageId: null,
+        summaryText: "h".repeat(2_097_152),
+        createdByProviderInstanceId: null,
+        createdAt: NOW,
+        updatedAt: NOW,
+      })),
+    } as unknown as typeof projection;
+
+    const bounded = buildBoundedThreadProjection({
+      projection: projectThreadProjectionForWire(populated),
+      snapshotSequence: 9,
+    });
+    const serializedBytes = Buffer.byteLength(JSON.stringify(bounded.projection), "utf8");
+
+    expect(serializedBytes).toBeLessThanOrEqual(THREAD_HISTORY_PAGE_POLICY.maxEncodedBytes);
+    expect(bounded.payloadBudgetExceeded).toBe(false);
+    expect(bounded.projection.plans).toEqual([]);
+    expect(bounded.projection.contextHandoffs).toEqual([]);
+    expect(populated.plans).toHaveLength(120);
+    expect(
+      populated.plans[0]?.kind === "proposed_plan" ? populated.plans[0].markdown.length : 0,
+    ).toBe(2_097_152);
+  });
+
+  it("preserves oversized actionable state and reports the budget exception", () => {
+    const projection = makeProjection([]);
+    const actionable = {
+      ...projection,
+      plans: [
+        {
+          id: "plan-actionable",
+          threadId: THREAD,
+          runId: null,
+          nodeId: "node-actionable",
+          status: "active",
+          kind: "proposed_plan",
+          markdown: "a".repeat(2_097_152),
+        },
+      ],
+    } as unknown as typeof projection;
+
+    const bounded = buildBoundedThreadProjection({ projection: actionable, snapshotSequence: 9 });
+
+    expect(bounded.payloadBudgetExceeded).toBe(true);
+    expect(bounded.projection.plans[0]).toEqual(actionable.plans[0]);
+  });
+
+  it("keeps paged historical plan detail in the turn item and only status in its artifact", () => {
+    const detail = "Implement the historical plan exactly.\n".repeat(1_000);
+    const item = {
+      ...makeRow(0).item,
+      type: "proposed_plan",
+      planId: "plan-historical-visible",
+      markdown: detail,
+      streaming: false,
+    } as OrchestrationV2TurnItem;
+    const row = {
+      ...makeRow(0),
+      sourceItemId: item.id,
+      item,
+    } as OrchestrationV2ProjectedTurnItem;
+    const base = makeProjection([row]);
+    const projection = {
+      ...base,
+      plans: [
+        {
+          id: "plan-historical-visible",
+          threadId: THREAD,
+          runId: null,
+          nodeId: "node-historical-visible",
+          status: "completed",
+          kind: "proposed_plan",
+          markdown: detail,
+        },
+      ],
+    } as unknown as typeof base;
+
+    const bounded = buildBoundedThreadProjection({ projection, snapshotSequence: 9 });
+
+    expect(bounded.projection.visibleTurnItems[0]?.item).toMatchObject({
+      type: "proposed_plan",
+      markdown: detail,
+    });
+    expect(bounded.projection.plans[0]).toMatchObject({
+      status: "completed",
+      markdown: "",
+      detailInTurnItem: true,
+    });
+    expect(bounded.payloadBudgetExceeded).toBe(false);
+  });
+});
diff --git a/apps/server/src/orchestration-v2/threadHistoryPaging.ts b/apps/server/src/orchestration-v2/threadHistoryPaging.ts
new file mode 100644
index 000000000000..fea1ff89325d
--- /dev/null
+++ b/apps/server/src/orchestration-v2/threadHistoryPaging.ts
@@ -0,0 +1,497 @@
+import type {
+  OrchestrationV2ProjectedTurnItem,
+  OrchestrationV2ThreadProjection,
+  OrchestrationV2TurnItem,
+  ThreadId,
+  TurnItemId,
+} from "@t3tools/contracts";
+
+/**
+ * Centralized page budgets for progressive client hydration. Sized for relay
+ * cold opens: dozens of rows and about 1 MiB of encoded JSON per page.
+ */
+export const THREAD_HISTORY_PAGE_POLICY = {
+  maxItems: 75,
+  maxEncodedBytes: 1_048_576,
+} as const;
+
+/** Reject absurd cursors before base64 work or JSON parse. */
+export const THREAD_HISTORY_CURSOR_MAX_LENGTH = 4_096;
+
+export type ThreadHistoryPagePolicy = {
+  readonly maxItems: number;
+  readonly maxEncodedBytes: number;
+};
+
+export type ThreadHistoryCursorPayload = {
+  readonly v: 1;
+  readonly seq: number;
+  readonly st: string;
+  readonly si: string;
+  readonly p: number;
+};
+
+export type SelectTimelinePageResult = {
+  readonly items: ReadonlyArray<OrchestrationV2ProjectedTurnItem>;
+  readonly nextCursor: string | null;
+  readonly hasMoreHistory: boolean;
+};
+
+export type BoundedProjectionResult = {
+  readonly projection: OrchestrationV2ThreadProjection;
+  readonly historyCursor: string | null;
+  readonly hasMoreHistory: boolean;
+  /** Max ordinal across the authoritative full projection's local turnItems. */
+  readonly latestLocalTurnOrdinal: number | null;
+  readonly payloadBudgetExceeded: boolean;
+};
+
+export class InvalidThreadHistoryCursorError extends Error {
+  readonly _tag = "InvalidThreadHistoryCursorError";
+  constructor(message = "Invalid thread history cursor.") {
+    super(message);
+    this.name = "InvalidThreadHistoryCursorError";
+  }
+}
+
+function bytesOfJson(value: unknown): number {
+  return Buffer.byteLength(JSON.stringify(value), "utf8");
+}
+
+/** Ordinary history-page cost: one projected row (item is nested once). */
+export function projectedRowEncodedBytes(row: OrchestrationV2ProjectedTurnItem): number {
+  return bytesOfJson(row);
+}
+
+/**
+ * Bounded-snapshot cost: local rows also land in `projection.turnItems`, so
+ * charge the nested item a second time. Inherited rows only appear in the
+ * visible list.
+ */
+export function projectedRowBoundedSnapshotEncodedBytes(
+  row: OrchestrationV2ProjectedTurnItem,
+  threadId: ThreadId | string,
+): number {
+  const rowBytes = projectedRowEncodedBytes(row);
+  if (row.visibility === "local" || String(row.sourceThreadId) === String(threadId)) {
+    return rowBytes + bytesOfJson(row.item);
+  }
+  return rowBytes;
+}
+
+function renumberPositions(
+  items: ReadonlyArray<OrchestrationV2ProjectedTurnItem>,
+): OrchestrationV2ProjectedTurnItem[] {
+  return items.map((row, position) => (row.position === position ? row : { ...row, position }));
+}
+
+function encodeCursorPayload(payload: ThreadHistoryCursorPayload): string {
+  return Buffer.from(JSON.stringify(payload), "utf8").toString("base64url");
+}
+
+export function encodeThreadHistoryCursor(input: {
+  readonly snapshotSequence: number;
+  readonly sourceThreadId: ThreadId | string;
+  readonly sourceItemId: TurnItemId | string;
+  readonly position: number;
+}): string {
+  return encodeCursorPayload({
+    v: 1,
+    seq: input.snapshotSequence,
+    st: String(input.sourceThreadId),
+    si: String(input.sourceItemId),
+    p: input.position,
+  });
+}
+
+export function decodeThreadHistoryCursor(cursor: string): ThreadHistoryCursorPayload {
+  if (cursor.length === 0 || cursor.length > THREAD_HISTORY_CURSOR_MAX_LENGTH) {
+    throw new InvalidThreadHistoryCursorError();
+  }
+  let parsed: unknown;
+  try {
+    const json = Buffer.from(cursor, "base64url").toString("utf8");
+    parsed = JSON.parse(json) as unknown;
+  } catch {
+    throw new InvalidThreadHistoryCursorError();
+  }
+  if (
+    typeof parsed !== "object" ||
+    parsed === null ||
+    !("v" in parsed) ||
+    (parsed as { v: unknown }).v !== 1 ||
+    !("seq" in parsed) ||
+    typeof (parsed as { seq: unknown }).seq !== "number" ||
+    !Number.isInteger((parsed as { seq: number }).seq) ||
+    (parsed as { seq: number }).seq < 0 ||
+    !("st" in parsed) ||
+    typeof (parsed as { st: unknown }).st !== "string" ||
+    (parsed as { st: string }).st.length === 0 ||
+    !("si" in parsed) ||
+    typeof (parsed as { si: unknown }).si !== "string" ||
+    (parsed as { si: string }).si.length === 0 ||
+    !("p" in parsed) ||
+    typeof (parsed as { p: unknown }).p !== "number" ||
+    !Number.isInteger((parsed as { p: number }).p) ||
+    (parsed as { p: number }).p < 0
+  ) {
+    throw new InvalidThreadHistoryCursorError();
+  }
+  return parsed as ThreadHistoryCursorPayload;
+}
+
+/**
+ * Walk a chronological timeline from `startIndex` backward, collecting rows
+ * under count and byte budgets. Always includes at least one row when available
+ * so a single oversized item cannot deadlock pagination.
+ */
+export function selectOlderTimelinePage(input: {
+  readonly items: ReadonlyArray<OrchestrationV2ProjectedTurnItem>;
+  readonly exclusiveEndIndex: number;
+  readonly snapshotSequence: number;
+  readonly policy?: ThreadHistoryPagePolicy | undefined;
+  readonly rowEncodedBytes?: ((row: OrchestrationV2ProjectedTurnItem) => number) | undefined;
+}): SelectTimelinePageResult {
+  const policy = input.policy ?? THREAD_HISTORY_PAGE_POLICY;
+  const rowCost = input.rowEncodedBytes ?? projectedRowEncodedBytes;
+  const end = Math.min(Math.max(input.exclusiveEndIndex, 0), input.items.length);
+  if (end <= 0) {
+    return { items: [], nextCursor: null, hasMoreHistory: false };
+  }
+
+  const selected: OrchestrationV2ProjectedTurnItem[] = [];
+  let encodedBytes = 0;
+  for (let index = end - 1; index >= 0; index -= 1) {
+    const row = input.items[index]!;
+    const rowBytes = rowCost(row);
+    if (
+      selected.length > 0 &&
+      (selected.length >= policy.maxItems || encodedBytes + rowBytes > policy.maxEncodedBytes)
+    ) {
+      break;
+    }
+    selected.push(row);
+    encodedBytes += rowBytes;
+  }
+  selected.reverse();
+
+  const oldest = selected[0];
+  const oldestIndex = oldest
+    ? input.items.findIndex(
+        (row) =>
+          row.sourceThreadId === oldest.sourceThreadId && row.sourceItemId === oldest.sourceItemId,
+      )
+    : -1;
+  const hasMoreHistory = oldestIndex > 0;
+  const nextCursor =
+    hasMoreHistory && oldest
+      ? encodeThreadHistoryCursor({
+          snapshotSequence: input.snapshotSequence,
+          sourceThreadId: oldest.sourceThreadId,
+          sourceItemId: oldest.sourceItemId,
+          position: oldest.position,
+        })
+      : null;
+
+  return {
+    items: renumberPositions(selected),
+    nextCursor,
+    hasMoreHistory,
+  };
+}
+
+export function selectRecentTimelineWindow(input: {
+  readonly items: ReadonlyArray<OrchestrationV2ProjectedTurnItem>;
+  readonly snapshotSequence: number;
+  readonly policy?: ThreadHistoryPagePolicy | undefined;
+  readonly rowEncodedBytes?: ((row: OrchestrationV2ProjectedTurnItem) => number) | undefined;
+}): SelectTimelinePageResult {
+  return selectOlderTimelinePage({
+    items: input.items,
+    exclusiveEndIndex: input.items.length,
+    snapshotSequence: input.snapshotSequence,
+    ...(input.policy === undefined ? {} : { policy: input.policy }),
+    ...(input.rowEncodedBytes === undefined ? {} : { rowEncodedBytes: input.rowEncodedBytes }),
+  });
+}
+
+function findCursorIndex(
+  items: ReadonlyArray<OrchestrationV2ProjectedTurnItem>,
+  cursor: ThreadHistoryCursorPayload,
+): number {
+  const byIdentity = items.findIndex(
+    (row) => String(row.sourceThreadId) === cursor.st && String(row.sourceItemId) === cursor.si,
+  );
+  if (byIdentity !== -1) {
+    return byIdentity;
+  }
+  // Identity miss can happen if the cursor item was deleted; fall back to the
+  // recorded position clamped into the current timeline so pagination can
+  // continue from a stable-ish anchor rather than failing hard. Clamp to
+  // items.length (exclusive end) so a shrunken timeline never 400s forever.
+  // decodeThreadHistoryCursor already guarantees p is a non-negative integer.
+  return Math.min(cursor.p, items.length);
+}
+
+export function selectHistoryPageFromCursor(input: {
+  readonly items: ReadonlyArray<OrchestrationV2ProjectedTurnItem>;
+  readonly cursor: string;
+  readonly snapshotSequence: number;
+  readonly policy?: ThreadHistoryPagePolicy | undefined;
+}): SelectTimelinePageResult {
+  const decoded = decodeThreadHistoryCursor(input.cursor);
+  const anchorIndex = findCursorIndex(input.items, decoded);
+  return selectOlderTimelinePage({
+    items: input.items,
+    exclusiveEndIndex: anchorIndex,
+    snapshotSequence: input.snapshotSequence,
+    ...(input.policy === undefined ? {} : { policy: input.policy }),
+  });
+}
+
+function isLocalProjectedRow(
+  projection: OrchestrationV2ThreadProjection,
+  row: OrchestrationV2ProjectedTurnItem,
+): boolean {
+  return row.visibility === "local" || String(row.sourceThreadId) === String(projection.thread.id);
+}
+
+/**
+ * Visibility for superseded `run_interrupt_result` rows depends on a matching
+ * `run_interrupt_request` in `turnItems`. Keep every small request item from the
+ * full projection even when it sits outside the recent visible window, so a
+ * later history page that introduces the matching result still has the request
+ * available for live attempt/run reducers.
+ */
+export function retainedInterruptRequestTurnItems(
+  projection: OrchestrationV2ThreadProjection,
+  visible: ReadonlyArray<OrchestrationV2ProjectedTurnItem>,
+): OrchestrationV2TurnItem[] {
+  const visibleLocalIds = new Set<string>();
+  for (const row of visible) {
+    if (isLocalProjectedRow(projection, row)) {
+      visibleLocalIds.add(String(row.sourceItemId));
+    }
+  }
+
+  const retained: OrchestrationV2TurnItem[] = [];
+  for (const item of projection.turnItems) {
+    if (item.type !== "run_interrupt_request") {
+      continue;
+    }
+    // Already covered by local turnItems for the visible window.
+    if (visibleLocalIds.has(String(item.id))) {
+      continue;
+    }
+    retained.push(item);
+  }
+  return retained;
+}
+
+function localTurnItemsForVisibleWindow(
+  projection: OrchestrationV2ThreadProjection,
+  visible: ReadonlyArray<OrchestrationV2ProjectedTurnItem>,
+): OrchestrationV2TurnItem[] {
+  const localIds = new Set<string>();
+  for (const row of visible) {
+    if (isLocalProjectedRow(projection, row)) {
+      localIds.add(String(row.sourceItemId));
+    }
+  }
+  if (localIds.size === 0) {
+    return [];
+  }
+  return projection.turnItems.filter((item) => localIds.has(String(item.id)));
+}
+
+function messagesForBoundedProjection(
+  projection: OrchestrationV2ThreadProjection,
+  turnItems: ReadonlyArray<OrchestrationV2TurnItem>,
+): OrchestrationV2ThreadProjection["messages"] {
+  const retainedMessageIds = new Set<string>();
+  for (const item of turnItems) {
+    if ("messageId" in item) {
+      retainedMessageIds.add(String(item.messageId));
+    }
+  }
+
+  const latestRun = projection.runs.reduce<(typeof projection.runs)[number] | null>(
+    (latest, run) => (latest === null || run.ordinal > latest.ordinal ? run : latest),
+    null,
+  );
+  const retainedRunIds = new Set<string>();
+  for (const run of projection.runs) {
+    if (
+      run.id === latestRun?.id ||
+      run.status === "preparing" ||
+      run.status === "starting" ||
+      run.status === "running" ||
+      run.status === "waiting" ||
+      run.status === "queued"
+    ) {
+      retainedRunIds.add(String(run.id));
+      retainedMessageIds.add(String(run.userMessageId));
+    }
+  }
+
+  return projection.messages.filter(
+    (message) =>
+      retainedMessageIds.has(String(message.id)) ||
+      (message.runId !== null && retainedRunIds.has(String(message.runId))) ||
+      message.delegatedCompletion !== undefined,
+  );
+}
+
+/**
+ * Max local turn ordinal over the authoritative full projection turnItems.
+ * Used as a cheap partial-timeline watermark so old missing turn-item updates
+ * cannot append newest when the bounded window has no local rows.
+ */
+export function computeLatestLocalTurnOrdinal(
+  turnItems: ReadonlyArray<{ readonly ordinal: number }>,
+): number | null {
+  let latest: number | null = null;
+  for (const item of turnItems) {
+    if (latest === null || item.ordinal > latest) {
+      latest = item.ordinal;
+    }
+  }
+  return latest;
+}
+
+/**
+ * Encoded timeline contribution for a bounded snapshot: visible rows plus the
+ * duplicated local turnItems and any retained interrupt-request dependencies.
+ */
+export function boundedTimelineEncodedBytes(input: {
+  readonly visibleTurnItems: ReadonlyArray<OrchestrationV2ProjectedTurnItem>;
+  readonly turnItems: ReadonlyArray<OrchestrationV2TurnItem>;
+}): number {
+  let total = 0;
+  for (const row of input.visibleTurnItems) {
+    total += projectedRowEncodedBytes(row);
+  }
+  for (const item of input.turnItems) {
+    total += bytesOfJson(item);
+  }
+  return total;
+}
+
+/**
+ * Builds a partial thread projection with full control-plane arrays and a
+ * bounded recent timeline window plus matching local turnItems.
+ */
+export function buildBoundedThreadProjection(input: {
+  readonly projection: OrchestrationV2ThreadProjection;
+  readonly snapshotSequence: number;
+  readonly policy?: ThreadHistoryPagePolicy | undefined;
+}): BoundedProjectionResult {
+  const policy = input.policy ?? THREAD_HISTORY_PAGE_POLICY;
+  const threadId = input.projection.thread.id;
+  const controlProjection = {
+    ...input.projection,
+    plans: input.projection.plans.filter((plan) => plan.status === "active"),
+    contextHandoffs: input.projection.contextHandoffs.filter(
+      (handoff) => handoff.status === "pending" || handoff.status === "ready",
+    ),
+  };
+  const latestLocalTurnOrdinal = computeLatestLocalTurnOrdinal(input.projection.turnItems);
+
+  // Reserve bytes for small interrupt-request dependencies that may sit outside
+  // the recent window but are required for visibility of results inside it.
+  const dependencyReserve = (() => {
+    // Upper bound: all request items in the full projection. Window selection
+    // uses this reserve so the final contribution stays under the cap.
+    let reserve = 0;
+    for (const item of controlProjection.turnItems) {
+      if (item.type === "run_interrupt_request") {
+        reserve += bytesOfJson(item);
+      }
+    }
+    return reserve;
+  })();
+  const controlBytes = bytesOfJson({
+    ...controlProjection,
+    messages: [],
+    turnItems: [],
+    visibleTurnItems: [],
+  });
+  const windowBudget = Math.max(
+    0,
+    policy.maxEncodedBytes - dependencyReserve - controlBytes - 1_024,
+  );
+  const windowPolicy: ThreadHistoryPagePolicy = {
+    maxItems: policy.maxItems,
+    // Zero still admits the first row via the at-least-one rule.
+    maxEncodedBytes: windowBudget,
+  };
+
+  const window = selectRecentTimelineWindow({
+    items: controlProjection.visibleTurnItems,
+    snapshotSequence: input.snapshotSequence,
+    policy: windowPolicy,
+    rowEncodedBytes: (row) => projectedRowBoundedSnapshotEncodedBytes(row, threadId),
+  });
+  const visibleTurnItems = renumberPositions(window.items);
+  const windowTurnItems = localTurnItemsForVisibleWindow(controlProjection, visibleTurnItems);
+  const dependencyTurnItems = retainedInterruptRequestTurnItems(
+    controlProjection,
+    visibleTurnItems,
+  );
+  const turnItemById = new Map<string, OrchestrationV2TurnItem>();
+  for (const item of windowTurnItems) {
+    turnItemById.set(String(item.id), item);
+  }
+  for (const item of dependencyTurnItems) {
+    turnItemById.set(String(item.id), item);
+  }
+  const turnItems = [...turnItemById.values()];
+
+  const visiblePlanIds = new Set(
+    turnItems.flatMap((item) =>
+      item.type === "proposed_plan" || item.type === "todo_list" ? [String(item.planId)] : [],
+    ),
+  );
+  const visibleHandoffIds = new Set(
+    turnItems.flatMap((item) => (item.type === "handoff" ? [String(item.contextHandoffId)] : [])),
+  );
+  const plans = input.projection.plans
+    .filter((plan) => plan.status === "active" || visiblePlanIds.has(String(plan.id)))
+    .map((plan) =>
+      plan.status === "active"
+        ? plan
+        : plan.kind === "proposed_plan"
+          ? { ...plan, markdown: "", detailInTurnItem: true as const }
+          : { ...plan, explanation: undefined, detailInTurnItem: true as const },
+    );
+  const contextHandoffs = input.projection.contextHandoffs
+    .filter(
+      (handoff) =>
+        handoff.status === "pending" ||
+        handoff.status === "ready" ||
+        visibleHandoffIds.has(String(handoff.id)),
+    )
+    .map((handoff) =>
+      handoff.status === "pending" || handoff.status === "ready"
+        ? handoff
+        : { ...handoff, summaryText: "", detailInTurnItem: true as const },
+    );
+
+  const projection = {
+    ...controlProjection,
+    plans,
+    contextHandoffs,
+    messages: messagesForBoundedProjection(controlProjection, turnItems),
+    turnItems,
+    visibleTurnItems,
+  };
+  return {
+    projection,
+    historyCursor: window.nextCursor,
+    hasMoreHistory: window.hasMoreHistory,
+    // Always from the full projection so inherited-only windows still carry a
+    // watermark for partial live reducers.
+    latestLocalTurnOrdinal,
+    payloadBudgetExceeded: bytesOfJson(projection) > policy.maxEncodedBytes,
+  };
+}
diff --git a/apps/server/src/orchestration/ActivityPayloadProjection.test.ts b/apps/server/src/orchestration/ActivityPayloadProjection.test.ts
deleted file mode 100644
index 2cdfef19fd18..000000000000
--- a/apps/server/src/orchestration/ActivityPayloadProjection.test.ts
+++ /dev/null
@@ -1,209 +0,0 @@
-import { describe, expect, it } from "vite-plus/test";
-import type { OrchestrationThreadActivity } from "@t3tools/contracts";
-import { projectActivityPayload } from "./ActivityPayloadProjection.ts";
-
-function activity(payload: Record<string, unknown>): OrchestrationThreadActivity {
-  return {
-    id: "activity-1",
-    tone: "tool",
-    kind: "tool.completed",
-    summary: "Tool",
-    payload,
-    turnId: null,
-    createdAt: "2026-08-01T10:00:00.000Z",
-  } as unknown as OrchestrationThreadActivity;
-}
-
-/**
- * Wire-survival regression: the slimming pass rewrites payload.data but must
- * never strip the top-level per-agent fields the subagent fold depends on.
- * If slimming ever moves to an allowlist over the whole payload, these
- * assertions are the tripwire.
- */
-describe("projectActivityPayload", () => {
-  it("preserves tool attribution (agentId/parentToolUseId) through data slimming", () => {
-    const projected = projectActivityPayload(
-      activity({
-        itemType: "command_execution",
-        agentId: "task-123",
-        parentToolUseId: "toolu_abc",
-        data: {
-          toolName: "Bash",
-          input: { command: "ls" },
-          command: "ls",
-          rawOutput: { content: "x".repeat(10) },
-          somethingClientNeverReads: { big: "blob" },
-        },
-      }),
-    );
-    const payload = projected.payload as Record<string, unknown>;
-    expect(payload.agentId).toBe("task-123");
-    expect(payload.parentToolUseId).toBe("toolu_abc");
-    // Slimming itself still applies to data.
-    const data = payload.data as Record<string, unknown>;
-    expect(data.somethingClientNeverReads).toBeUndefined();
-  });
-
-  it("keeps a bounded Codex command output summary", () => {
-    const projected = projectActivityPayload(
-      activity({
-        itemType: "command_execution",
-        data: {
-          item: {
-            command: "/bin/zsh -lc 'printf hello'",
-            aggregatedOutput: `hello from codex\n${"x".repeat(5000)}`,
-          },
-        },
-      }),
-    );
-    const data = (projected.payload as Record<string, unknown>).data as Record<string, unknown>;
-    expect(data.item).toEqual({
-      command: "/bin/zsh -lc 'printf hello'",
-      aggregatedOutput: "hello from codex",
-    });
-    expect(JSON.stringify(projected.payload).length).toBeLessThan(500);
-  });
-
-  it("keeps bounded Claude and ACP command output summaries", () => {
-    const claude = projectActivityPayload(
-      activity({
-        itemType: "command_execution",
-        data: {
-          command: "printf hello",
-          rawOutput: { stdout: `hello from claude\n${"y".repeat(5000)}` },
-        },
-      }),
-    );
-    const acp = projectActivityPayload(
-      activity({
-        itemType: "command_execution",
-        data: {
-          command: "printf hello",
-          content: [
-            {
-              type: "content",
-              content: { type: "text", text: `hello from acp\n${"z".repeat(5000)}` },
-            },
-          ],
-        },
-      }),
-    );
-
-    const claudeData = (claude.payload as Record<string, unknown>).data as Record<string, unknown>;
-    const acpData = (acp.payload as Record<string, unknown>).data as Record<string, unknown>;
-    expect(claudeData.rawOutput).toEqual({ content: "hello from claude" });
-    expect(acpData.rawOutput).toEqual({ content: "hello from acp" });
-    expect(JSON.stringify(claude.payload).length).toBeLessThan(500);
-    expect(JSON.stringify(acp.payload).length).toBeLessThan(500);
-  });
-
-  it("normalizes Claude and OpenCode command inputs before slimming provider data", () => {
-    const claude = projectActivityPayload(
-      activity({
-        itemType: "command_execution",
-        toolCallId: "claude-call-1",
-        data: {
-          toolName: "Bash",
-          input: { command: "vp test run" },
-          result: { content: "x".repeat(5_000) },
-        },
-      }),
-    );
-    const openCode = projectActivityPayload(
-      activity({
-        itemType: "command_execution",
-        toolCallId: "opencode-call-1",
-        data: {
-          tool: "bash",
-          state: {
-            status: "running",
-            input: { command: "vp lint" },
-            output: "x".repeat(5_000),
-          },
-        },
-      }),
-    );
-
-    expect(claude.payload).toMatchObject({
-      toolCallId: "claude-call-1",
-      data: { command: "vp test run" },
-    });
-    expect(openCode.payload).toMatchObject({
-      toolCallId: "opencode-call-1",
-      data: { command: "vp lint" },
-    });
-    expect(JSON.stringify(claude.payload).length).toBeLessThan(200);
-    expect(JSON.stringify(openCode.payload).length).toBeLessThan(200);
-  });
-
-  it("slims Codex-shaped mcp_tool_call items to rendered fields plus a result summary", () => {
-    const projected = projectActivityPayload(
-      activity({
-        itemType: "mcp_tool_call",
-        data: {
-          item: {
-            type: "mcpToolCall",
-            id: "item-1",
-            tool: "fetch_pr",
-            server: "github",
-            status: "completed",
-            arguments: { pr: 42 },
-            durationMs: 1200,
-            result: {
-              content: [{ type: "text", text: `PR body line one\n${"x".repeat(5000)}` }],
-              structuredContent: { huge: "y".repeat(5000) },
-            },
-            _meta: { internal: true },
-          },
-        },
-      }),
-    );
-    const data = (projected.payload as Record<string, unknown>).data as Record<string, unknown>;
-    const item = data.item as Record<string, unknown>;
-    expect(item.tool).toBe("fetch_pr");
-    expect(item.server).toBe("github");
-    expect(item.arguments).toEqual({ pr: 42 });
-    expect(item._meta).toBeUndefined();
-    expect(item.result).toEqual({ content: "PR body line one" });
-    expect(JSON.stringify(projected.payload).length).toBeLessThan(500);
-  });
-
-  it("slims Claude-shaped mcp_tool_call data (toolName/input/result block)", () => {
-    const projected = projectActivityPayload(
-      activity({
-        itemType: "mcp_tool_call",
-        data: {
-          toolName: "mcp__github__fetch_pr",
-          input: { pr: 42 },
-          result: {
-            type: "tool_result",
-            tool_use_id: "toolu_1",
-            content: [{ type: "text", text: `first line of output\n${"z".repeat(5000)}` }],
-          },
-        },
-      }),
-    );
-    const data = (projected.payload as Record<string, unknown>).data as Record<string, unknown>;
-    expect(data.toolName).toBe("mcp__github__fetch_pr");
-    expect(data.input).toEqual({ pr: 42 });
-    expect(data.result).toEqual({ content: "first line of output" });
-    expect(JSON.stringify(projected.payload).length).toBeLessThan(500);
-  });
-
-  it("passes task lifecycle payloads (no data field) through untouched", () => {
-    const source = activity({
-      taskId: "task-9",
-      title: "Audit auth",
-      role: "explorer",
-      model: "opus",
-      effort: "high",
-      workflowName: "audit-flow",
-      phases: [{ index: 0, title: "Audit" }],
-      typedUsage: { totalTokens: 1200 },
-      runHandles: { runId: "run-1", scriptPath: "/tmp/wf.js" },
-      timelineBypass: true,
-    });
-    const projected = projectActivityPayload(source);
-    expect(projected.payload).toEqual(source.payload);
-  });
-});
diff --git a/apps/server/src/orchestration/ActivityPayloadProjection.ts b/apps/server/src/orchestration/ActivityPayloadProjection.ts
deleted file mode 100644
index 32f249c251d5..000000000000
--- a/apps/server/src/orchestration/ActivityPayloadProjection.ts
+++ /dev/null
@@ -1,570 +0,0 @@
-import type {
-  OrchestrationEvent,
-  OrchestrationThreadActivity,
-  OrchestrationThreadDetailSnapshot,
-} from "@t3tools/contracts";
-
-function asRecord(value: unknown): Record<string, unknown> | null {
-  return value !== null && typeof value === "object" && !Array.isArray(value)
-    ? (value as Record<string, unknown>)
-    : null;
-}
-
-function asTrimmedString(value: unknown): string | null {
-  if (typeof value !== "string") {
-    return null;
-  }
-  const trimmed = value.trim();
-  return trimmed.length > 0 ? trimmed : null;
-}
-
-function pushChangedFile(target: string[], seen: Set<string>, value: unknown): void {
-  const normalized = asTrimmedString(value);
-  if (!normalized || seen.has(normalized)) {
-    return;
-  }
-  seen.add(normalized);
-  target.push(normalized);
-}
-
-function collectChangedFiles(
-  value: unknown,
-  target: string[],
-  seen: Set<string>,
-  depth: number,
-): void {
-  if (depth > 4 || target.length >= 12) {
-    return;
-  }
-  if (Array.isArray(value)) {
-    for (const entry of value) {
-      collectChangedFiles(entry, target, seen, depth + 1);
-      if (target.length >= 12) {
-        return;
-      }
-    }
-    return;
-  }
-
-  const record = asRecord(value);
-  if (!record) {
-    return;
-  }
-
-  pushChangedFile(target, seen, record.path);
-  pushChangedFile(target, seen, record.filePath);
-  pushChangedFile(target, seen, record.relativePath);
-  pushChangedFile(target, seen, record.filename);
-  pushChangedFile(target, seen, record.newPath);
-  pushChangedFile(target, seen, record.oldPath);
-
-  for (const nestedKey of [
-    "item",
-    "result",
-    "input",
-    "data",
-    "changes",
-    "files",
-    "edits",
-    "patch",
-    "patches",
-    "operations",
-  ]) {
-    if (!(nestedKey in record)) {
-      continue;
-    }
-    collectChangedFiles(record[nestedKey], target, seen, depth + 1);
-    if (target.length >= 12) {
-      return;
-    }
-  }
-}
-
-function projectCommandData(data: Record<string, unknown>): Record<string, unknown> | undefined {
-  const item = asRecord(data.item);
-  if (!item) {
-    return undefined;
-  }
-
-  const projectedItem: Record<string, unknown> = {};
-  if ("command" in item) {
-    projectedItem.command = item.command;
-  }
-
-  const aggregatedOutput = asTrimmedString(item.aggregatedOutput);
-  if (aggregatedOutput) {
-    const summary = summarizeToolTextOutput(aggregatedOutput);
-    if (summary) {
-      projectedItem.aggregatedOutput = summary;
-    }
-  }
-
-  const input = asRecord(item.input);
-  if (input && "command" in input) {
-    projectedItem.input = { command: input.command };
-  }
-
-  const result = asRecord(item.result);
-  if (result) {
-    const projectedResult: Record<string, unknown> = {};
-    if ("command" in result) {
-      projectedResult.command = result.command;
-    }
-    const content = asTrimmedString(result.content);
-    if (content) {
-      const summary = summarizeToolTextOutput(content);
-      if (summary) {
-        projectedResult.content = summary;
-      }
-    }
-    if (Object.keys(projectedResult).length > 0) {
-      projectedItem.result = projectedResult;
-    }
-  }
-
-  return Object.keys(projectedItem).length > 0 ? projectedItem : undefined;
-}
-
-function projectCommandValue(data: Record<string, unknown>): unknown {
-  if (data.command !== undefined) {
-    return data.command;
-  }
-
-  const input = asRecord(data.input);
-  if (input?.command !== undefined) {
-    return input.command;
-  }
-
-  const stateInput = asRecord(asRecord(data.state)?.input);
-  if (stateInput?.command !== undefined) {
-    return stateInput.command;
-  }
-
-  return undefined;
-}
-
-function summarizeToolTextOutput(value: string): string | null {
-  const lines: string[] = [];
-  for (const rawLine of value.split(/\r?\n/u)) {
-    const line = rawLine.replace(/\s+/g, " ").trim();
-    if (line.length > 0) {
-      lines.push(line);
-    }
-  }
-
-  const firstLine = lines.find((line) => line !== "```");
-  if (firstLine) {
-    return firstLine.length <= 84 ? firstLine : `${firstLine.slice(0, 83).trimEnd()}…`;
-  }
-  if (lines.length > 1) {
-    return `${lines.length.toLocaleString()} lines`;
-  }
-  return null;
-}
-
-/**
- * Fields of an MCP tool-call item both clients render in the expanded
- * work-log row. Everything else — notably `result`, which carries the full
- * tool output and dominates wire size on MCP-heavy threads — is summarized
- * or dropped. Full payloads remain in persistence.
- */
-const MCP_ITEM_KEPT_FIELDS = [
-  "type",
-  "id",
-  "tool",
-  "server",
-  "status",
-  "arguments",
-  "appContext",
-  "error",
-  "durationMs",
-] as const;
-
-/**
- * Pulls renderable text out of an MCP tool result: either a Codex-style
- * `{content: [{type: "text", text}, ...]}` record or a raw Claude
- * `tool_result` block whose `content` is a string or block array.
- */
-function extractMcpResultText(result: unknown): string | null {
-  const record = asRecord(result);
-  if (!record) {
-    return typeof result === "string" ? result : null;
-  }
-  if (typeof record.content === "string") {
-    return record.content;
-  }
-  if (Array.isArray(record.content)) {
-    const texts: string[] = [];
-    for (const entry of record.content) {
-      const text = asRecord(entry)?.text;
-      if (typeof text === "string" && text.trim().length > 0) {
-        texts.push(text);
-      }
-    }
-    if (texts.length > 0) {
-      return texts.join("\n");
-    }
-  }
-  return null;
-}
-
-function summarizeMcpResult(result: unknown): Record<string, unknown> | undefined {
-  if (result === undefined || result === null) {
-    return undefined;
-  }
-  const text = extractMcpResultText(result);
-  const summary = text ? summarizeToolTextOutput(text) : null;
-  return summary ? { content: summary } : undefined;
-}
-
-/**
- * MCP tool calls carry full tool results (`data.item.result` on Codex,
- * `data.result` on Claude/OpenCode) that used to bypass slimming entirely to
- * keep the expanded-row UI working. Keep the fields the UI actually renders
- * and summarize the result like regular tool output.
- */
-function projectMcpToolCallData(data: Record<string, unknown>): Record<string, unknown> {
-  const projectedData: Record<string, unknown> = {};
-
-  const item = asRecord(data.item);
-  if (item) {
-    const projectedItem: Record<string, unknown> = {};
-    for (const key of MCP_ITEM_KEPT_FIELDS) {
-      if (key in item) {
-        projectedItem[key] = item[key];
-      }
-    }
-    const result = summarizeMcpResult(item.result);
-    if (result) {
-      projectedItem.result = result;
-    }
-    projectedData.item = projectedItem;
-  }
-
-  if ("toolName" in data) {
-    projectedData.toolName = data.toolName;
-  }
-  if ("input" in data) {
-    projectedData.input = data.input;
-  }
-  if (!item) {
-    const result = summarizeMcpResult(data.result);
-    if (result) {
-      projectedData.result = result;
-    }
-  }
-
-  if ("toolCallId" in data) {
-    projectedData.toolCallId = data.toolCallId;
-  }
-  if ("kind" in data) {
-    projectedData.kind = data.kind;
-  }
-
-  const changedFiles: string[] = [];
-  collectChangedFiles(data, changedFiles, new Set<string>(), 0);
-  if (changedFiles.length > 0) {
-    projectedData.files = changedFiles.map((path) => ({ path }));
-  }
-
-  return projectedData;
-}
-
-function projectRawOutput(value: unknown): Record<string, unknown> | undefined {
-  const direct = asTrimmedString(value);
-  if (direct) {
-    const summary = summarizeToolTextOutput(direct);
-    return summary ? { content: summary } : undefined;
-  }
-
-  const rawOutput = asRecord(value);
-  if (!rawOutput) {
-    return undefined;
-  }
-
-  if (typeof rawOutput.totalFiles === "number" && Number.isFinite(rawOutput.totalFiles)) {
-    return {
-      totalFiles: rawOutput.totalFiles,
-      ...(rawOutput.truncated === true ? { truncated: true } : {}),
-    };
-  }
-
-  const content = asTrimmedString(rawOutput.content);
-  if (content) {
-    const summary = summarizeToolTextOutput(content);
-    return summary ? { content: summary } : undefined;
-  }
-
-  const stdout = asTrimmedString(rawOutput.stdout);
-  if (stdout) {
-    const summary = summarizeToolTextOutput(stdout);
-    return summary ? { content: summary } : undefined;
-  }
-
-  const stderr = asTrimmedString(rawOutput.stderr);
-  if (stderr) {
-    const summary = summarizeToolTextOutput(stderr);
-    return summary ? { content: summary } : undefined;
-  }
-
-  return undefined;
-}
-
-function projectAcpContent(value: unknown): Record<string, unknown> | undefined {
-  if (!Array.isArray(value)) {
-    return undefined;
-  }
-
-  const text = value
-    .map((entryValue) => {
-      const entry = asRecord(entryValue);
-      const content = asRecord(entry?.content);
-      return entry?.type === "content" && content?.type === "text"
-        ? asTrimmedString(content.text)
-        : null;
-    })
-    .filter((entry): entry is string => entry !== null)
-    .join("\n");
-  const summary = summarizeToolTextOutput(text);
-  return summary ? { content: summary } : undefined;
-}
-
-/**
- * Removes activity payload fields that no current client reads while retaining
- * the full payload in persistence and the event store.
- */
-export function projectActivityPayload(
-  activity: OrchestrationThreadActivity,
-): OrchestrationThreadActivity {
-  const payload = asRecord(activity.payload);
-  const data = asRecord(payload?.data);
-  if (!payload || !data) {
-    return activity;
-  }
-
-  const itemStatus = asRecord(data.item)?.status;
-  const projectedPayload =
-    payload.status === "completed" && (itemStatus === "failed" || itemStatus === "declined")
-      ? { ...payload, status: itemStatus }
-      : payload;
-
-  if (payload.itemType === "mcp_tool_call") {
-    return {
-      ...activity,
-      payload: {
-        ...projectedPayload,
-        data: projectMcpToolCallData(data),
-      },
-    };
-  }
-
-  const projectedData: Record<string, unknown> = {};
-  const item = projectCommandData(data);
-  if (item) {
-    projectedData.item = item;
-  }
-  const command = projectCommandValue(data);
-  if (command !== undefined) {
-    projectedData.command = command;
-  }
-
-  const changedFiles: string[] = [];
-  collectChangedFiles(data, changedFiles, new Set<string>(), 0);
-  if (changedFiles.length > 0) {
-    // Both clients discover file names by walking objects with path-like keys.
-    projectedData.files = changedFiles.map((path) => ({ path }));
-  }
-
-  if ("toolCallId" in data) {
-    projectedData.toolCallId = data.toolCallId;
-  }
-  if ("kind" in data) {
-    projectedData.kind = data.kind;
-  }
-
-  const rawOutput = projectRawOutput(data.rawOutput) ?? projectAcpContent(data.content);
-  if (rawOutput) {
-    projectedData.rawOutput = rawOutput;
-  }
-
-  return {
-    ...activity,
-    payload: {
-      ...projectedPayload,
-      data: projectedData,
-    },
-  };
-}
-
-/**
- * Matches the validity rule in the web client's
- * `deriveLatestContextWindowSnapshot`: rows without a finite, non-negative
- * `usedTokens` are skipped during its backward walk, so they must not shadow
- * an earlier resolvable row here.
- */
-function isResolvableContextWindowActivity(activity: OrchestrationThreadActivity): boolean {
-  if (activity.kind !== "context-window.updated") {
-    return false;
-  }
-  const payload = asRecord(activity.payload);
-  const usedTokens = payload?.usedTokens;
-  return typeof usedTokens === "number" && Number.isFinite(usedTokens) && usedTokens >= 0;
-}
-
-/**
- * Drops all but the last resolvable context-window activity per turn from a
- * snapshot. Clients only ever read the latest usage value (walking the array
- * backwards), so shipping the full history — often thousands of rows on long
- * threads — buys nothing. Retention is per turn rather than per thread because
- * a live `thread.reverted` makes the client discard whole turns; keeping each
- * turn's latest row means the meter can still resolve a value from the turns
- * that survive. Malformed rows pass through untouched rather than shadowing a
- * valid earlier row. Live `thread.activity-appended` events are untouched:
- * newer updates still stream through and supersede the retained rows on the
- * client.
- */
-function dropStaleContextWindowActivities(
-  activities: ReadonlyArray<OrchestrationThreadActivity>,
-): ReadonlyArray<OrchestrationThreadActivity> {
-  const latestIndexByTurn = new Map<string | null, number>();
-  for (let index = 0; index < activities.length; index += 1) {
-    if (isResolvableContextWindowActivity(activities[index]!)) {
-      latestIndexByTurn.set(activities[index]!.turnId, index);
-    }
-  }
-  if (latestIndexByTurn.size === 0) {
-    return activities;
-  }
-  return activities.filter(
-    (activity, index) =>
-      !isResolvableContextWindowActivity(activity) ||
-      latestIndexByTurn.get(activity.turnId) === index,
-  );
-}
-
-/**
- * Identity used to retain only the newest lifecycle row for each call in a
- * thread snapshot. Prefer the runtime item id, then the legacy nested id, and
- * finally the itemType/title/detail triple. Rows without any identity remain
- * untouched.
- */
-function toolLifecycleIdentity(activity: OrchestrationThreadActivity): string | null {
-  const payload = asRecord(activity.payload);
-  if (!payload) {
-    return null;
-  }
-
-  const toolCallId =
-    asTrimmedString(payload.toolCallId) ?? asTrimmedString(asRecord(payload.data)?.toolCallId);
-  if (toolCallId) {
-    return `id:${toolCallId}`;
-  }
-
-  const itemType = asTrimmedString(payload.itemType) ?? "";
-  // Mirrors the clients' `normalizeCompactToolLabel`: a completion's title may
-  // gain a trailing "complete"/"completed" the in-flight updates lack.
-  const label = (asTrimmedString(payload.title) ?? activity.summary)
-    .replace(/\s+(?:complete|completed)\s*$/iu, "")
-    .trim();
-  const detail = asTrimmedString(payload.detail) ?? "";
-  if (itemType.length === 0 && label.length === 0 && detail.length === 0) {
-    return null;
-  }
-  return [itemType, label, detail].join("");
-}
-
-/**
- * Drops `tool.updated` rows a `tool.completed` row already supersedes. An
- * update is the in-flight snapshot of a call; once the call completes, the
- * completion carries the final state and the clients fold every matching
- * update into it, so shipping the updates buys nothing — 47k such rows exist
- * in one real database, and a single thread carries 2,291 of them totalling
- * ~1MB post-slimming.
- *
- * Matching is per turn for the same reason `dropStaleContextWindowActivities`
- * retains per turn: a live `thread.reverted` makes the client discard whole
- * turns, so a completion in a different turn could vanish and leave the
- * dropped update unrepresented. The completion must also come *after* the
- * update within the turn — a later update belongs to a subsequent call that
- * reuses the same identity and is still in flight. Rows without a lifecycle
- * identity pass through, matching the clients, which never collapse them.
- * Live `thread.activity-appended` events are untouched: updates still stream
- * in real time and the completion supersedes them on the client as before.
- *
- * Deliberate divergence from client collapse: clients fold only *adjacent*
- * lifecycle rows, so a superseded update separated from its completion by an
- * interleaved parallel call renders as its own row today, and this drop
- * removes it. Measured against a real database, that affects 1.5% of dropped
- * rows (553 of 36,581), all pure in-flight state whose final result the
- * retained completion still shows. Dropping them is intentional; matching
- * adjacency server-side would forfeit most of the win for parallel-heavy
- * threads, which are exactly the heavy ones. Superseding completions always
- * carry a payload superset of their updates (verified across all 49,515
- * update rows: zero dropped rows held a client-merged field — detail, title,
- * command, item, kind, files — their completion lacked), so no expanded-row
- * content is lost.
- */
-function dropSupersededToolUpdatedActivities(
-  activities: ReadonlyArray<OrchestrationThreadActivity>,
-): ReadonlyArray<OrchestrationThreadActivity> {
-  const completionIndicesByKey = new Map<string, number[]>();
-  for (let index = 0; index < activities.length; index += 1) {
-    const activity = activities[index]!;
-    if (activity.kind !== "tool.completed") {
-      continue;
-    }
-    const identity = toolLifecycleIdentity(activity);
-    if (!identity) {
-      continue;
-    }
-    const key = `${activity.turnId ?? ""}${identity}`;
-    const indices = completionIndicesByKey.get(key);
-    if (indices) {
-      indices.push(index);
-    } else {
-      completionIndicesByKey.set(key, [index]);
-    }
-  }
-  if (completionIndicesByKey.size === 0) {
-    return activities;
-  }
-
-  return activities.filter((activity, index) => {
-    if (activity.kind !== "tool.updated") {
-      return true;
-    }
-    const identity = toolLifecycleIdentity(activity);
-    if (!identity) {
-      return true;
-    }
-    const indices = completionIndicesByKey.get(`${activity.turnId ?? ""}${identity}`);
-    return !indices?.some((completionIndex) => completionIndex > index);
-  });
-}
-
-export function projectThreadDetailSnapshot(
-  snapshot: OrchestrationThreadDetailSnapshot,
-): OrchestrationThreadDetailSnapshot {
-  return {
-    ...snapshot,
-    thread: {
-      ...snapshot.thread,
-      activities: dropSupersededToolUpdatedActivities(
-        dropStaleContextWindowActivities(snapshot.thread.activities),
-      ).map(projectActivityPayload),
-    },
-  };
-}
-
-export function projectActivityEvent(event: OrchestrationEvent): OrchestrationEvent {
-  if (event.type !== "thread.activity-appended") {
-    return event;
-  }
-  return {
-    ...event,
-    payload: {
-      ...event.payload,
-      activity: projectActivityPayload(event.payload.activity),
-    },
-  };
-}
diff --git a/apps/server/src/orchestration/Layers/CheckpointReactor.test.ts b/apps/server/src/orchestration/Layers/CheckpointReactor.test.ts
deleted file mode 100644
index ca4cb7afd9ab..000000000000
--- a/apps/server/src/orchestration/Layers/CheckpointReactor.test.ts
+++ /dev/null
@@ -1,1261 +0,0 @@
-// @effect-diagnostics nodeBuiltinImport:off
-import * as NodeFS from "node:fs";
-import * as NodeOS from "node:os";
-import * as NodePath from "node:path";
-import * as NodeChildProcess from "node:child_process";
-
-import {
-  ProviderDriverKind,
-  ProviderRuntimeEvent,
-  ProviderSession,
-  ProviderInstanceId,
-} from "@t3tools/contracts";
-import {
-  CommandId,
-  DEFAULT_PROVIDER_INTERACTION_MODE,
-  EventId,
-  MessageId,
-  ProjectId,
-  ThreadId,
-  TurnId,
-} from "@t3tools/contracts";
-import * as NodeServices from "@effect/platform-node/NodeServices";
-import * as Clock from "effect/Clock";
-import * as Effect from "effect/Effect";
-import * as Exit from "effect/Exit";
-import * as Layer from "effect/Layer";
-import * as ManagedRuntime from "effect/ManagedRuntime";
-import * as PubSub from "effect/PubSub";
-import * as Scope from "effect/Scope";
-import * as Stream from "effect/Stream";
-import { afterEach, describe, expect, it, vi } from "vite-plus/test";
-
-import * as CheckpointStore from "../../checkpointing/CheckpointStore.ts";
-import * as VcsDriverRegistry from "../../vcs/VcsDriverRegistry.ts";
-import * as VcsProcess from "../../vcs/VcsProcess.ts";
-import { VcsStatusBroadcaster } from "../../vcs/VcsStatusBroadcaster.ts";
-import * as RepositoryIdentityResolver from "../../project/RepositoryIdentityResolver.ts";
-import { CheckpointReactorLive } from "./CheckpointReactor.ts";
-import { OrchestrationEngineLive } from "./OrchestrationEngine.ts";
-import { OrchestrationProjectionPipelineLive } from "./ProjectionPipeline.ts";
-import { OrchestrationProjectionSnapshotQueryLive } from "./ProjectionSnapshotQuery.ts";
-import * as ThreadBackgroundLiveness from "../ThreadBackgroundLiveness.ts";
-import * as ThreadPlanProgress from "../ThreadPlanProgress.ts";
-import { RuntimeReceiptBusLive } from "./RuntimeReceiptBus.ts";
-import { OrchestrationEventStoreLive } from "../../persistence/Layers/OrchestrationEventStore.ts";
-import { OrchestrationCommandReceiptRepositoryLive } from "../../persistence/Layers/OrchestrationCommandReceipts.ts";
-import { SqlitePersistenceMemory } from "../../persistence/Layers/Sqlite.ts";
-import {
-  OrchestrationEngineService,
-  type OrchestrationEngineShape,
-} from "../Services/OrchestrationEngine.ts";
-import { CheckpointReactor } from "../Services/CheckpointReactor.ts";
-import { ProjectionSnapshotQuery } from "../Services/ProjectionSnapshotQuery.ts";
-import {
-  ProviderService,
-  type ProviderServiceShape,
-} from "../../provider/Services/ProviderService.ts";
-import { checkpointRefForThreadTurn } from "../../checkpointing/Utils.ts";
-import { ServerConfig } from "../../config.ts";
-import * as WorkspaceEntries from "../../workspace/WorkspaceEntries.ts";
-import * as WorkspacePaths from "../../workspace/WorkspacePaths.ts";
-
-const asProjectId = (value: string): ProjectId => ProjectId.make(value);
-const asTurnId = (value: string): TurnId => TurnId.make(value);
-
-type LegacyProviderRuntimeEvent = {
-  readonly type: string;
-  readonly eventId: EventId;
-  readonly provider: ProviderDriverKind;
-  readonly createdAt: string;
-  readonly threadId: ThreadId;
-  readonly turnId?: string | undefined;
-  readonly itemId?: string | undefined;
-  readonly requestId?: string | undefined;
-  readonly payload?: unknown | undefined;
-  readonly [key: string]: unknown;
-};
-
-function createProviderServiceHarness(
-  cwd: string,
-  hasSession = true,
-  sessionCwd = cwd,
-  providerName: ProviderSession["provider"] = ProviderDriverKind.make("codex"),
-) {
-  const now = "2026-01-01T00:00:00.000Z";
-  const runtimeEventPubSub = Effect.runSync(PubSub.unbounded<ProviderRuntimeEvent>());
-  const rollbackConversation = vi.fn(
-    (_input: { readonly threadId: ThreadId; readonly numTurns: number }) => Effect.void,
-  );
-
-  const unsupported = <A>() =>
-    Effect.die(new Error("Unsupported provider call in test")) as Effect.Effect<A, never>;
-  const listSessions = () =>
-    hasSession
-      ? Effect.succeed([
-          {
-            provider: providerName,
-            status: "ready",
-            runtimeMode: "full-access",
-            threadId: ThreadId.make("thread-1"),
-            cwd: sessionCwd,
-            createdAt: now,
-            updatedAt: now,
-          },
-        ] satisfies ReadonlyArray<ProviderSession>)
-      : Effect.succeed([] as ReadonlyArray<ProviderSession>);
-  const service: ProviderServiceShape = {
-    startSession: () => unsupported(),
-    sendTurn: () => unsupported(),
-    interruptTurn: () => unsupported(),
-    respondToRequest: () => unsupported(),
-    respondToUserInput: () => unsupported(),
-    stopSession: () => unsupported(),
-    listSessions,
-    getCapabilities: () => Effect.succeed({ sessionModelSwitch: "in-session" }),
-    getInstanceInfo: (instanceId) =>
-      Effect.succeed({
-        instanceId,
-        driverKind: ProviderDriverKind.make(providerName),
-        displayName: undefined,
-        enabled: true,
-        continuationIdentity: {
-          driverKind: ProviderDriverKind.make(providerName),
-          continuationKey: `${providerName}:instance:${instanceId}`,
-        },
-      }),
-    rollbackConversation,
-    uploadFeedback: () => unsupported(),
-    get streamEvents() {
-      return Stream.fromPubSub(runtimeEventPubSub);
-    },
-  };
-
-  const emit = (event: LegacyProviderRuntimeEvent): void => {
-    Effect.runSync(PubSub.publish(runtimeEventPubSub, event as unknown as ProviderRuntimeEvent));
-  };
-
-  return {
-    service,
-    rollbackConversation,
-    emit,
-  };
-}
-
-async function waitForThread(
-  readModel: () => Promise<{
-    readonly threads: ReadonlyArray<{
-      readonly id: ThreadId;
-      readonly latestTurn: { readonly turnId: string } | null;
-      readonly checkpoints: ReadonlyArray<{ readonly checkpointTurnCount: number }>;
-      readonly activities: ReadonlyArray<{ readonly kind: string }>;
-    }>;
-  }>,
-  predicate: (thread: {
-    latestTurn: { turnId: string } | null;
-    checkpoints: ReadonlyArray<{ checkpointTurnCount: number }>;
-    activities: ReadonlyArray<{ kind: string }>;
-  }) => boolean,
-  timeoutMs = 15_000,
-) {
-  const deadline = (await Effect.runPromise(Clock.currentTimeMillis)) + timeoutMs;
-  const poll = async (): Promise<{
-    latestTurn: { turnId: string } | null;
-    checkpoints: ReadonlyArray<{ checkpointTurnCount: number }>;
-    activities: ReadonlyArray<{ kind: string }>;
-  }> => {
-    const snapshot = await readModel();
-    const thread = snapshot.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    if (thread && predicate(thread)) {
-      return thread;
-    }
-    if ((await Effect.runPromise(Clock.currentTimeMillis)) >= deadline) {
-      throw new Error("Timed out waiting for thread state.");
-    }
-    await Effect.runPromise(Effect.sleep("10 millis"));
-    return poll();
-  };
-  return poll();
-}
-
-async function waitForEvent(
-  engine: OrchestrationEngineShape,
-  predicate: (event: { type: string }) => boolean,
-  timeoutMs = 15_000,
-) {
-  const deadline = (await Effect.runPromise(Clock.currentTimeMillis)) + timeoutMs;
-  const poll = async () => {
-    const events = await Effect.runPromise(
-      Stream.runCollect(engine.readEvents(0)).pipe(Effect.map((chunk) => Array.from(chunk))),
-    );
-    if (events.some(predicate)) {
-      return events;
-    }
-    if ((await Effect.runPromise(Clock.currentTimeMillis)) >= deadline) {
-      throw new Error("Timed out waiting for orchestration event.");
-    }
-    await Effect.runPromise(Effect.sleep("10 millis"));
-    return poll();
-  };
-  return poll();
-}
-
-function runGit(cwd: string, args: ReadonlyArray<string>) {
-  return NodeChildProcess.execFileSync("git", args, {
-    cwd,
-    stdio: ["ignore", "pipe", "pipe"],
-    encoding: "utf8",
-  });
-}
-
-function createGitRepository() {
-  const cwd = NodeFS.mkdtempSync(NodePath.join(NodeOS.tmpdir(), "t3-checkpoint-handler-"));
-  runGit(cwd, ["init", "--initial-branch=main"]);
-  runGit(cwd, ["config", "user.email", "test@example.com"]);
-  runGit(cwd, ["config", "user.name", "Test User"]);
-  NodeFS.writeFileSync(NodePath.join(cwd, "README.md"), "v1\n", "utf8");
-  runGit(cwd, ["add", "."]);
-  runGit(cwd, ["commit", "-m", "Initial"]);
-  return cwd;
-}
-
-function gitRefExists(cwd: string, ref: string): boolean {
-  try {
-    runGit(cwd, ["show-ref", "--verify", "--quiet", ref]);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-function gitShowFileAtRef(cwd: string, ref: string, filePath: string): string {
-  return runGit(cwd, ["show", `${ref}:${filePath}`]);
-}
-
-async function waitForGitRefExists(cwd: string, ref: string, timeoutMs = 15_000) {
-  const deadline = (await Effect.runPromise(Clock.currentTimeMillis)) + timeoutMs;
-  const poll = async (): Promise<void> => {
-    if (gitRefExists(cwd, ref)) {
-      return;
-    }
-    if ((await Effect.runPromise(Clock.currentTimeMillis)) >= deadline) {
-      throw new Error(`Timed out waiting for git ref '${ref}'.`);
-    }
-    await Effect.runPromise(Effect.sleep("10 millis"));
-    return poll();
-  };
-  return poll();
-}
-
-describe("CheckpointReactor", () => {
-  let runtime: ManagedRuntime.ManagedRuntime<
-    | OrchestrationEngineService
-    | CheckpointReactor
-    | CheckpointStore.CheckpointStore
-    | ProjectionSnapshotQuery,
-    unknown
-  > | null = null;
-  let scope: Scope.Closeable | null = null;
-  const tempDirs: string[] = [];
-
-  afterEach(async () => {
-    if (scope) {
-      await Effect.runPromise(Scope.close(scope, Exit.void));
-    }
-    scope = null;
-    if (runtime) {
-      await runtime.dispose();
-    }
-    runtime = null;
-    while (tempDirs.length > 0) {
-      const dir = tempDirs.pop();
-      if (dir) {
-        NodeFS.rmSync(dir, { recursive: true, force: true });
-      }
-    }
-  });
-
-  async function createHarness(options?: {
-    readonly hasSession?: boolean;
-    readonly seedFilesystemCheckpoints?: boolean;
-    readonly projectWorkspaceRoot?: string;
-    readonly threadWorktreePath?: string | null;
-    readonly threadBranch?: string | null;
-    readonly secondThreadSharingWorktree?: boolean;
-    readonly localStatusRefName?: string | null;
-    readonly providerSessionCwd?: string;
-    readonly providerName?: ProviderDriverKind;
-    readonly gitStatusRefreshCalls?: Array<string>;
-  }) {
-    const cwd = createGitRepository();
-    tempDirs.push(cwd);
-    const provider = createProviderServiceHarness(
-      cwd,
-      options?.hasSession ?? true,
-      options?.providerSessionCwd ?? cwd,
-      options?.providerName ?? ProviderDriverKind.make("codex"),
-    );
-    const orchestrationLayer = OrchestrationEngineLive.pipe(
-      Layer.provide(OrchestrationProjectionSnapshotQueryLive),
-      Layer.provide(ThreadBackgroundLiveness.layer),
-      Layer.provide(ThreadPlanProgress.layer),
-      Layer.provide(OrchestrationProjectionPipelineLive),
-      Layer.provide(OrchestrationEventStoreLive),
-      Layer.provide(OrchestrationCommandReceiptRepositoryLive),
-      Layer.provide(RepositoryIdentityResolver.layer),
-      Layer.provide(SqlitePersistenceMemory),
-    );
-    const projectionSnapshotLayer = OrchestrationProjectionSnapshotQueryLive.pipe(
-      Layer.provide(ThreadBackgroundLiveness.layer),
-      Layer.provide(ThreadPlanProgress.layer),
-      Layer.provide(RepositoryIdentityResolver.layer),
-      Layer.provide(SqlitePersistenceMemory),
-    );
-
-    const ServerConfigLayer = ServerConfig.layerTest(process.cwd(), {
-      prefix: "t3-checkpoint-reactor-test-",
-    });
-    const vcsStatusBroadcasterLayer = Layer.succeed(VcsStatusBroadcaster, {
-      getStatus: () => Effect.die("getStatus should not be called in this test"),
-      refreshLocalStatus: (cwd: string) =>
-        Effect.sync(() => {
-          options?.gitStatusRefreshCalls?.push(cwd);
-        }).pipe(
-          Effect.as({
-            isRepo: true,
-            hasPrimaryRemote: false,
-            isDefaultRef: true,
-            refName:
-              options?.localStatusRefName !== undefined ? options.localStatusRefName : "main",
-            hasWorkingTreeChanges: false,
-            workingTree: { files: [], insertions: 0, deletions: 0 },
-          }),
-        ),
-      refreshStatus: () => Effect.die("refreshStatus should not be called in this test"),
-      streamStatus: () => Stream.empty,
-    });
-
-    const layer = CheckpointReactorLive.pipe(
-      Layer.provideMerge(orchestrationLayer),
-      Layer.provideMerge(projectionSnapshotLayer),
-      Layer.provideMerge(RuntimeReceiptBusLive),
-      Layer.provideMerge(Layer.succeed(ProviderService, provider.service)),
-      Layer.provideMerge(vcsStatusBroadcasterLayer),
-      Layer.provideMerge(CheckpointStore.layer.pipe(Layer.provide(VcsDriverRegistry.layer))),
-      Layer.provideMerge(
-        WorkspaceEntries.layer.pipe(
-          Layer.provide(WorkspacePaths.layer),
-          Layer.provideMerge(VcsDriverRegistry.layer),
-        ),
-      ),
-      Layer.provideMerge(WorkspacePaths.layer),
-      Layer.provideMerge(VcsProcess.layer),
-      Layer.provideMerge(ServerConfigLayer),
-      Layer.provideMerge(NodeServices.layer),
-    );
-
-    runtime = ManagedRuntime.make(layer);
-    const engine = await runtime.runPromise(Effect.service(OrchestrationEngineService));
-    const snapshotQuery = await runtime.runPromise(Effect.service(ProjectionSnapshotQuery));
-    const reactor = await runtime.runPromise(Effect.service(CheckpointReactor));
-    const checkpointStore = await runtime.runPromise(
-      Effect.service(CheckpointStore.CheckpointStore),
-    );
-    scope = await Effect.runPromise(Scope.make("sequential"));
-    await Effect.runPromise(reactor.start().pipe(Scope.provide(scope)));
-    const drain = () => Effect.runPromise(reactor.drain);
-
-    const createdAt = "2026-01-01T00:00:00.000Z";
-    await Effect.runPromise(
-      engine.dispatch({
-        type: "project.create",
-        commandId: CommandId.make("cmd-project-create"),
-        projectId: asProjectId("project-1"),
-        title: "Test Project",
-        workspaceRoot: options?.projectWorkspaceRoot ?? cwd,
-        defaultModelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5-codex",
-        },
-        createdAt,
-      }),
-    );
-    await Effect.runPromise(
-      engine
-        .dispatch({
-          type: "thread.create",
-          commandId: CommandId.make("cmd-thread-create"),
-          threadId: ThreadId.make("thread-1"),
-          projectId: asProjectId("project-1"),
-          title: "Thread",
-          modelSelection: {
-            instanceId: ProviderInstanceId.make("codex"),
-            model: "gpt-5-codex",
-          },
-          interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-          runtimeMode: "approval-required",
-          branch: options?.threadBranch ?? null,
-          worktreePath: options?.threadWorktreePath ?? cwd,
-          createdAt,
-        })
-        .pipe(
-          options?.secondThreadSharingWorktree
-            ? Effect.andThen(
-                engine.dispatch({
-                  type: "thread.create",
-                  commandId: CommandId.make("cmd-thread-create-2"),
-                  threadId: ThreadId.make("thread-2"),
-                  projectId: asProjectId("project-1"),
-                  title: "Thread 2",
-                  modelSelection: {
-                    instanceId: ProviderInstanceId.make("codex"),
-                    model: "gpt-5-codex",
-                  },
-                  interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-                  runtimeMode: "approval-required",
-                  branch: null,
-                  worktreePath: options?.threadWorktreePath ?? cwd,
-                  createdAt,
-                }),
-              )
-            : Effect.asVoid,
-        ),
-    );
-
-    if (options?.seedFilesystemCheckpoints ?? true) {
-      await runtime.runPromise(
-        checkpointStore.captureCheckpoint({
-          cwd,
-          checkpointRef: checkpointRefForThreadTurn(ThreadId.make("thread-1"), 0),
-        }),
-      );
-      NodeFS.writeFileSync(NodePath.join(cwd, "README.md"), "v2\n", "utf8");
-      await runtime.runPromise(
-        checkpointStore.captureCheckpoint({
-          cwd,
-          checkpointRef: checkpointRefForThreadTurn(ThreadId.make("thread-1"), 1),
-        }),
-      );
-      NodeFS.writeFileSync(NodePath.join(cwd, "README.md"), "v3\n", "utf8");
-      await runtime.runPromise(
-        checkpointStore.captureCheckpoint({
-          cwd,
-          checkpointRef: checkpointRefForThreadTurn(ThreadId.make("thread-1"), 2),
-        }),
-      );
-    }
-
-    return {
-      engine,
-      readModel: () => Effect.runPromise(snapshotQuery.getSnapshot()),
-      provider,
-      cwd,
-      drain,
-    };
-  }
-
-  it("captures pre-turn baseline on turn.started and post-turn checkpoint on turn.completed", async () => {
-    const harness = await createHarness({ seedFilesystemCheckpoints: false });
-    const createdAt = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.session.set",
-        commandId: CommandId.make("cmd-session-set-capture"),
-        threadId: ThreadId.make("thread-1"),
-        session: {
-          threadId: ThreadId.make("thread-1"),
-          status: "ready",
-          providerName: "codex",
-          runtimeMode: "approval-required",
-          activeTurnId: null,
-          lastError: null,
-          updatedAt: createdAt,
-        },
-        createdAt,
-      }),
-    );
-
-    harness.provider.emit({
-      type: "turn.started",
-      eventId: EventId.make("evt-turn-started-1"),
-      provider: ProviderDriverKind.make("codex"),
-
-      createdAt: "2026-01-01T00:00:00.000Z",
-      threadId: ThreadId.make("thread-1"),
-      turnId: asTurnId("turn-1"),
-    });
-    await waitForGitRefExists(
-      harness.cwd,
-      checkpointRefForThreadTurn(ThreadId.make("thread-1"), 0),
-    );
-
-    NodeFS.writeFileSync(NodePath.join(harness.cwd, "README.md"), "v2\n", "utf8");
-    harness.provider.emit({
-      type: "turn.completed",
-      eventId: EventId.make("evt-turn-completed-1"),
-      provider: ProviderDriverKind.make("codex"),
-
-      createdAt: "2026-01-01T00:00:00.000Z",
-      threadId: ThreadId.make("thread-1"),
-      turnId: asTurnId("turn-1"),
-      payload: { state: "completed" },
-    });
-
-    await waitForEvent(harness.engine, (event) => event.type === "thread.turn-diff-completed");
-    const thread = await waitForThread(
-      harness.readModel,
-      (entry) => entry.latestTurn?.turnId === "turn-1" && entry.checkpoints.length === 1,
-    );
-    expect(thread.checkpoints[0]?.checkpointTurnCount).toBe(1);
-    expect(
-      gitRefExists(harness.cwd, checkpointRefForThreadTurn(ThreadId.make("thread-1"), 0)),
-    ).toBe(true);
-    expect(
-      gitRefExists(harness.cwd, checkpointRefForThreadTurn(ThreadId.make("thread-1"), 1)),
-    ).toBe(true);
-    expect(
-      gitShowFileAtRef(
-        harness.cwd,
-        checkpointRefForThreadTurn(ThreadId.make("thread-1"), 0),
-        "README.md",
-      ),
-    ).toBe("v1\n");
-    expect(
-      gitShowFileAtRef(
-        harness.cwd,
-        checkpointRefForThreadTurn(ThreadId.make("thread-1"), 1),
-        "README.md",
-      ),
-    ).toBe("v2\n");
-  });
-
-  it("refreshes local git status state on turn completion using the session cwd", async () => {
-    const gitStatusRefreshCalls: string[] = [];
-    const harness = await createHarness({
-      seedFilesystemCheckpoints: false,
-      gitStatusRefreshCalls,
-    });
-
-    harness.provider.emit({
-      type: "turn.completed",
-      eventId: EventId.make("evt-turn-completed-refresh-local-status"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: "2026-01-01T00:00:00.000Z",
-      threadId: ThreadId.make("thread-1"),
-      turnId: asTurnId("turn-refresh-local-status"),
-      payload: { state: "completed" },
-    });
-
-    await harness.drain();
-
-    expect(gitStatusRefreshCalls).toEqual([harness.cwd]);
-  });
-
-  it("adopts a drifted checkout as the thread branch on a dedicated worktree", async () => {
-    const harness = await createHarness({
-      seedFilesystemCheckpoints: false,
-      threadBranch: "t3code/original-branch",
-      localStatusRefName: "t3code/renamed-by-agent",
-    });
-
-    harness.provider.emit({
-      type: "turn.completed",
-      eventId: EventId.make("evt-turn-completed-branch-drift"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: "2026-01-01T00:00:00.000Z",
-      threadId: ThreadId.make("thread-1"),
-      turnId: asTurnId("turn-branch-drift"),
-      payload: { state: "completed" },
-    });
-
-    await harness.drain();
-    await waitForEvent(
-      harness.engine,
-      (event) =>
-        event.type === "thread.meta-updated" &&
-        (event as unknown as { payload: { branch?: string } }).payload.branch ===
-          "t3code/renamed-by-agent",
-    );
-
-    const snapshot = await harness.readModel();
-    const thread = snapshot.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    expect(thread?.branch).toBe("t3code/renamed-by-agent");
-  });
-
-  it("does not adopt a drifted checkout when the worktree is shared by another thread", async () => {
-    const harness = await createHarness({
-      seedFilesystemCheckpoints: false,
-      threadBranch: "t3code/original-branch",
-      localStatusRefName: "t3code/renamed-by-agent",
-      secondThreadSharingWorktree: true,
-    });
-
-    harness.provider.emit({
-      type: "turn.completed",
-      eventId: EventId.make("evt-turn-completed-branch-drift-shared"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: "2026-01-01T00:00:00.000Z",
-      threadId: ThreadId.make("thread-1"),
-      turnId: asTurnId("turn-branch-drift-shared"),
-      payload: { state: "completed" },
-    });
-
-    await harness.drain();
-
-    const snapshot = await harness.readModel();
-    const thread = snapshot.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    expect(thread?.branch).toBe("t3code/original-branch");
-  });
-
-  it("does not adopt a temporary placeholder checkout as the thread branch", async () => {
-    const harness = await createHarness({
-      seedFilesystemCheckpoints: false,
-      threadBranch: "t3code/original-branch",
-      localStatusRefName: "t3code/0a1b2c3d",
-    });
-
-    harness.provider.emit({
-      type: "turn.completed",
-      eventId: EventId.make("evt-turn-completed-branch-drift-temp"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: "2026-01-01T00:00:00.000Z",
-      threadId: ThreadId.make("thread-1"),
-      turnId: asTurnId("turn-branch-drift-temp"),
-      payload: { state: "completed" },
-    });
-
-    await harness.drain();
-
-    const snapshot = await harness.readModel();
-    const thread = snapshot.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    expect(thread?.branch).toBe("t3code/original-branch");
-  });
-
-  it("ignores auxiliary thread turn completion while primary turn is active", async () => {
-    const harness = await createHarness({ seedFilesystemCheckpoints: false });
-    const createdAt = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.session.set",
-        commandId: CommandId.make("cmd-session-set-primary-running"),
-        threadId: ThreadId.make("thread-1"),
-        session: {
-          threadId: ThreadId.make("thread-1"),
-          status: "running",
-          providerName: "codex",
-          runtimeMode: "approval-required",
-          activeTurnId: asTurnId("turn-main"),
-          lastError: null,
-          updatedAt: createdAt,
-        },
-        createdAt,
-      }),
-    );
-
-    harness.provider.emit({
-      type: "turn.started",
-      eventId: EventId.make("evt-turn-started-main"),
-      provider: ProviderDriverKind.make("codex"),
-
-      createdAt: "2026-01-01T00:00:00.000Z",
-      threadId: ThreadId.make("thread-1"),
-      turnId: asTurnId("turn-main"),
-    });
-    await waitForGitRefExists(
-      harness.cwd,
-      checkpointRefForThreadTurn(ThreadId.make("thread-1"), 0),
-    );
-
-    NodeFS.writeFileSync(NodePath.join(harness.cwd, "README.md"), "v2\n", "utf8");
-
-    harness.provider.emit({
-      type: "turn.completed",
-      eventId: EventId.make("evt-turn-completed-aux"),
-      provider: ProviderDriverKind.make("codex"),
-
-      createdAt: "2026-01-01T00:00:00.000Z",
-      threadId: ThreadId.make("thread-1"),
-      turnId: asTurnId("turn-aux"),
-      payload: { state: "completed" },
-    });
-
-    await harness.drain();
-    const midReadModel = await harness.readModel();
-    const midThread = midReadModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    expect(midThread?.checkpoints).toHaveLength(0);
-
-    harness.provider.emit({
-      type: "turn.completed",
-      eventId: EventId.make("evt-turn-completed-main"),
-      provider: ProviderDriverKind.make("codex"),
-
-      createdAt: "2026-01-01T00:00:00.000Z",
-      threadId: ThreadId.make("thread-1"),
-      turnId: asTurnId("turn-main"),
-      payload: { state: "completed" },
-    });
-
-    const thread = await waitForThread(
-      harness.readModel,
-      (entry) => entry.latestTurn?.turnId === "turn-main" && entry.checkpoints.length === 1,
-    );
-    expect(thread.checkpoints[0]?.checkpointTurnCount).toBe(1);
-  });
-
-  it("captures pre-turn and completion checkpoints for claude runtime events", async () => {
-    const harness = await createHarness({
-      seedFilesystemCheckpoints: false,
-      providerName: ProviderDriverKind.make("claudeAgent"),
-    });
-    const createdAt = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.session.set",
-        commandId: CommandId.make("cmd-session-set-capture-claude"),
-        threadId: ThreadId.make("thread-1"),
-        session: {
-          threadId: ThreadId.make("thread-1"),
-          status: "ready",
-          providerName: "claudeAgent",
-          runtimeMode: "approval-required",
-          activeTurnId: null,
-          lastError: null,
-          updatedAt: createdAt,
-        },
-        createdAt,
-      }),
-    );
-
-    harness.provider.emit({
-      type: "turn.started",
-      eventId: EventId.make("evt-turn-started-claude-1"),
-      provider: ProviderDriverKind.make("claudeAgent"),
-      createdAt: "2026-01-01T00:00:00.000Z",
-      threadId: ThreadId.make("thread-1"),
-      turnId: asTurnId("turn-claude-1"),
-    });
-    await waitForGitRefExists(
-      harness.cwd,
-      checkpointRefForThreadTurn(ThreadId.make("thread-1"), 0),
-    );
-
-    NodeFS.writeFileSync(NodePath.join(harness.cwd, "README.md"), "v2\n", "utf8");
-    harness.provider.emit({
-      type: "turn.completed",
-      eventId: EventId.make("evt-turn-completed-claude-1"),
-      provider: ProviderDriverKind.make("claudeAgent"),
-      createdAt: "2026-01-01T00:00:00.000Z",
-      threadId: ThreadId.make("thread-1"),
-      turnId: asTurnId("turn-claude-1"),
-      payload: { state: "completed" },
-    });
-
-    await waitForEvent(harness.engine, (event) => event.type === "thread.turn-diff-completed");
-    const thread = await waitForThread(
-      harness.readModel,
-      (entry) => entry.latestTurn?.turnId === "turn-claude-1" && entry.checkpoints.length === 1,
-    );
-
-    expect(thread.checkpoints[0]?.checkpointTurnCount).toBe(1);
-    expect(
-      gitRefExists(harness.cwd, checkpointRefForThreadTurn(ThreadId.make("thread-1"), 1)),
-    ).toBe(true);
-  });
-
-  it("appends capture failure activity when turn diff summary cannot be derived", async () => {
-    const harness = await createHarness({ seedFilesystemCheckpoints: false });
-    const createdAt = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.session.set",
-        commandId: CommandId.make("cmd-session-set-missing-baseline-diff"),
-        threadId: ThreadId.make("thread-1"),
-        session: {
-          threadId: ThreadId.make("thread-1"),
-          status: "ready",
-          providerName: "codex",
-          runtimeMode: "approval-required",
-          activeTurnId: null,
-          lastError: null,
-          updatedAt: createdAt,
-        },
-        createdAt,
-      }),
-    );
-
-    harness.provider.emit({
-      type: "turn.completed",
-      eventId: EventId.make("evt-turn-completed-missing-baseline"),
-      provider: ProviderDriverKind.make("codex"),
-
-      createdAt: "2026-01-01T00:00:00.000Z",
-      threadId: ThreadId.make("thread-1"),
-      turnId: asTurnId("turn-missing-baseline"),
-      payload: { state: "completed" },
-    });
-
-    await waitForEvent(harness.engine, (event) => event.type === "thread.turn-diff-completed");
-    const thread = await waitForThread(
-      harness.readModel,
-      (entry) =>
-        entry.checkpoints.length === 1 &&
-        entry.activities.some((activity) => activity.kind === "checkpoint.capture.failed"),
-    );
-
-    expect(thread.checkpoints[0]?.checkpointTurnCount).toBe(1);
-    expect(
-      thread.activities.some((activity) => activity.kind === "checkpoint.capture.failed"),
-    ).toBe(true);
-  });
-
-  it("captures pre-turn baseline from project workspace root when thread worktree is unset", async () => {
-    const harness = await createHarness({
-      hasSession: false,
-      seedFilesystemCheckpoints: false,
-      threadWorktreePath: null,
-    });
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-for-baseline"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: MessageId.make("message-user-1"),
-          role: "user",
-          text: "start turn",
-          attachments: [],
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: "2026-01-01T00:00:00.000Z",
-      }),
-    );
-
-    await waitForGitRefExists(
-      harness.cwd,
-      checkpointRefForThreadTurn(ThreadId.make("thread-1"), 0),
-    );
-    expect(
-      gitShowFileAtRef(
-        harness.cwd,
-        checkpointRefForThreadTurn(ThreadId.make("thread-1"), 0),
-        "README.md",
-      ),
-    ).toBe("v1\n");
-  });
-
-  it("captures turn completion checkpoint from project workspace root when provider session cwd is unavailable", async () => {
-    const harness = await createHarness({
-      hasSession: false,
-      seedFilesystemCheckpoints: false,
-      threadWorktreePath: null,
-    });
-    const createdAt = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.session.set",
-        commandId: CommandId.make("cmd-session-set-missing-provider-cwd"),
-        threadId: ThreadId.make("thread-1"),
-        session: {
-          threadId: ThreadId.make("thread-1"),
-          status: "running",
-          providerName: "codex",
-          runtimeMode: "approval-required",
-          activeTurnId: asTurnId("turn-missing-cwd"),
-          lastError: null,
-          updatedAt: createdAt,
-        },
-        createdAt,
-      }),
-    );
-
-    NodeFS.writeFileSync(NodePath.join(harness.cwd, "README.md"), "v2\n", "utf8");
-    harness.provider.emit({
-      type: "turn.completed",
-      eventId: EventId.make("evt-turn-completed-missing-provider-cwd"),
-      provider: ProviderDriverKind.make("codex"),
-
-      createdAt: "2026-01-01T00:00:00.000Z",
-      threadId: ThreadId.make("thread-1"),
-      turnId: asTurnId("turn-missing-cwd"),
-      payload: { state: "completed" },
-    });
-
-    await waitForEvent(harness.engine, (event) => event.type === "thread.turn-diff-completed");
-    expect(
-      gitRefExists(harness.cwd, checkpointRefForThreadTurn(ThreadId.make("thread-1"), 1)),
-    ).toBe(true);
-    expect(
-      gitShowFileAtRef(
-        harness.cwd,
-        checkpointRefForThreadTurn(ThreadId.make("thread-1"), 1),
-        "README.md",
-      ),
-    ).toBe("v2\n");
-  });
-
-  it("ignores non-v2 checkpoint.captured runtime events", async () => {
-    const harness = await createHarness();
-    const createdAt = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.session.set",
-        commandId: CommandId.make("cmd-session-set-checkpoint-captured"),
-        threadId: ThreadId.make("thread-1"),
-        session: {
-          threadId: ThreadId.make("thread-1"),
-          status: "ready",
-          providerName: "codex",
-          runtimeMode: "approval-required",
-          activeTurnId: null,
-          lastError: null,
-          updatedAt: createdAt,
-        },
-        createdAt,
-      }),
-    );
-
-    harness.provider.emit({
-      type: "checkpoint.captured",
-      eventId: EventId.make("evt-checkpoint-captured-3"),
-      provider: ProviderDriverKind.make("codex"),
-
-      createdAt: "2026-01-01T00:00:00.000Z",
-      threadId: ThreadId.make("thread-1"),
-      turnId: asTurnId("turn-3"),
-      turnCount: 3,
-      status: "completed",
-    });
-
-    await harness.drain();
-    const readModel = await harness.readModel();
-    const thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    expect(thread?.checkpoints.some((checkpoint) => checkpoint.checkpointTurnCount === 3)).toBe(
-      false,
-    );
-  });
-
-  it("continues processing runtime events after a single checkpoint runtime failure", async () => {
-    const nonRepositorySessionCwd = NodeFS.mkdtempSync(
-      NodePath.join(NodeOS.tmpdir(), "t3-checkpoint-runtime-non-repo-"),
-    );
-    tempDirs.push(nonRepositorySessionCwd);
-
-    const harness = await createHarness({
-      seedFilesystemCheckpoints: false,
-      providerSessionCwd: nonRepositorySessionCwd,
-    });
-    const createdAt = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.session.set",
-        commandId: CommandId.make("cmd-session-set-non-repo-runtime"),
-        threadId: ThreadId.make("thread-1"),
-        session: {
-          threadId: ThreadId.make("thread-1"),
-          status: "ready",
-          providerName: "codex",
-          runtimeMode: "approval-required",
-          activeTurnId: null,
-          lastError: null,
-          updatedAt: createdAt,
-        },
-        createdAt,
-      }),
-    );
-
-    harness.provider.emit({
-      type: "turn.completed",
-      eventId: EventId.make("evt-runtime-capture-failure"),
-      provider: ProviderDriverKind.make("codex"),
-
-      createdAt: "2026-01-01T00:00:00.000Z",
-      threadId: ThreadId.make("thread-1"),
-      turnId: asTurnId("turn-runtime-failure"),
-      payload: { state: "completed" },
-    });
-
-    harness.provider.emit({
-      type: "turn.started",
-      eventId: EventId.make("evt-turn-started-after-runtime-failure"),
-      provider: ProviderDriverKind.make("codex"),
-
-      createdAt: "2026-01-01T00:00:00.000Z",
-      threadId: ThreadId.make("thread-1"),
-      turnId: asTurnId("turn-after-runtime-failure"),
-    });
-
-    await waitForGitRefExists(
-      harness.cwd,
-      checkpointRefForThreadTurn(ThreadId.make("thread-1"), 0),
-    );
-    expect(
-      gitRefExists(harness.cwd, checkpointRefForThreadTurn(ThreadId.make("thread-1"), 0)),
-    ).toBe(true);
-  });
-
-  it("executes provider revert and emits thread.reverted for checkpoint revert requests", async () => {
-    const harness = await createHarness();
-    const createdAt = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.session.set",
-        commandId: CommandId.make("cmd-session-set"),
-        threadId: ThreadId.make("thread-1"),
-        session: {
-          threadId: ThreadId.make("thread-1"),
-          status: "ready",
-          providerName: "codex",
-          runtimeMode: "approval-required",
-          activeTurnId: null,
-          lastError: null,
-          updatedAt: createdAt,
-        },
-        createdAt,
-      }),
-    );
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.diff.complete",
-        commandId: CommandId.make("cmd-diff-1"),
-        threadId: ThreadId.make("thread-1"),
-        turnId: asTurnId("turn-1"),
-        completedAt: createdAt,
-        checkpointRef: checkpointRefForThreadTurn(ThreadId.make("thread-1"), 1),
-        status: "ready",
-        files: [],
-        checkpointTurnCount: 1,
-        createdAt,
-      }),
-    );
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.diff.complete",
-        commandId: CommandId.make("cmd-diff-2"),
-        threadId: ThreadId.make("thread-1"),
-        turnId: asTurnId("turn-2"),
-        completedAt: createdAt,
-        checkpointRef: checkpointRefForThreadTurn(ThreadId.make("thread-1"), 2),
-        status: "ready",
-        files: [],
-        checkpointTurnCount: 2,
-        createdAt,
-      }),
-    );
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.checkpoint.revert",
-        commandId: CommandId.make("cmd-revert-request"),
-        threadId: ThreadId.make("thread-1"),
-        turnCount: 1,
-        createdAt,
-      }),
-    );
-
-    await waitForEvent(harness.engine, (event) => event.type === "thread.reverted");
-    const thread = await waitForThread(
-      harness.readModel,
-      (entry) => entry.checkpoints.length === 1,
-    );
-
-    expect(thread.latestTurn?.turnId).toBe("turn-1");
-    expect(thread.checkpoints).toHaveLength(1);
-    expect(thread.checkpoints[0]?.checkpointTurnCount).toBe(1);
-    expect(harness.provider.rollbackConversation).toHaveBeenCalledTimes(1);
-    expect(harness.provider.rollbackConversation).toHaveBeenCalledWith({
-      threadId: ThreadId.make("thread-1"),
-      numTurns: 1,
-    });
-    expect(NodeFS.readFileSync(NodePath.join(harness.cwd, "README.md"), "utf8")).toBe("v2\n");
-    expect(
-      gitRefExists(harness.cwd, checkpointRefForThreadTurn(ThreadId.make("thread-1"), 2)),
-    ).toBe(false);
-  });
-
-  it("executes provider revert and emits thread.reverted for claude sessions", async () => {
-    const harness = await createHarness({ providerName: ProviderDriverKind.make("claudeAgent") });
-    const createdAt = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.session.set",
-        commandId: CommandId.make("cmd-session-set-claude"),
-        threadId: ThreadId.make("thread-1"),
-        session: {
-          threadId: ThreadId.make("thread-1"),
-          status: "ready",
-          providerName: "claudeAgent",
-          runtimeMode: "approval-required",
-          activeTurnId: null,
-          lastError: null,
-          updatedAt: createdAt,
-        },
-        createdAt,
-      }),
-    );
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.diff.complete",
-        commandId: CommandId.make("cmd-diff-claude-1"),
-        threadId: ThreadId.make("thread-1"),
-        turnId: asTurnId("turn-claude-1"),
-        completedAt: createdAt,
-        checkpointRef: checkpointRefForThreadTurn(ThreadId.make("thread-1"), 1),
-        status: "ready",
-        files: [],
-        checkpointTurnCount: 1,
-        createdAt,
-      }),
-    );
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.diff.complete",
-        commandId: CommandId.make("cmd-diff-claude-2"),
-        threadId: ThreadId.make("thread-1"),
-        turnId: asTurnId("turn-claude-2"),
-        completedAt: createdAt,
-        checkpointRef: checkpointRefForThreadTurn(ThreadId.make("thread-1"), 2),
-        status: "ready",
-        files: [],
-        checkpointTurnCount: 2,
-        createdAt,
-      }),
-    );
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.checkpoint.revert",
-        commandId: CommandId.make("cmd-revert-request-claude"),
-        threadId: ThreadId.make("thread-1"),
-        turnCount: 1,
-        createdAt,
-      }),
-    );
-
-    await waitForEvent(harness.engine, (event) => event.type === "thread.reverted");
-    expect(harness.provider.rollbackConversation).toHaveBeenCalledTimes(1);
-    expect(harness.provider.rollbackConversation).toHaveBeenCalledWith({
-      threadId: ThreadId.make("thread-1"),
-      numTurns: 1,
-    });
-  });
-
-  it("processes consecutive revert requests with deterministic rollback sequencing", async () => {
-    const harness = await createHarness();
-    const createdAt = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.session.set",
-        commandId: CommandId.make("cmd-session-set-inline-revert"),
-        threadId: ThreadId.make("thread-1"),
-        session: {
-          threadId: ThreadId.make("thread-1"),
-          status: "ready",
-          providerName: "codex",
-          runtimeMode: "approval-required",
-          activeTurnId: null,
-          lastError: null,
-          updatedAt: createdAt,
-        },
-        createdAt,
-      }),
-    );
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.diff.complete",
-        commandId: CommandId.make("cmd-inline-revert-diff-1"),
-        threadId: ThreadId.make("thread-1"),
-        turnId: asTurnId("turn-1"),
-        completedAt: createdAt,
-        checkpointRef: checkpointRefForThreadTurn(ThreadId.make("thread-1"), 1),
-        status: "ready",
-        files: [],
-        checkpointTurnCount: 1,
-        createdAt,
-      }),
-    );
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.diff.complete",
-        commandId: CommandId.make("cmd-inline-revert-diff-2"),
-        threadId: ThreadId.make("thread-1"),
-        turnId: asTurnId("turn-2"),
-        completedAt: createdAt,
-        checkpointRef: checkpointRefForThreadTurn(ThreadId.make("thread-1"), 2),
-        status: "ready",
-        files: [],
-        checkpointTurnCount: 2,
-        createdAt,
-      }),
-    );
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.checkpoint.revert",
-        commandId: CommandId.make("cmd-sequenced-revert-request-1"),
-        threadId: ThreadId.make("thread-1"),
-        turnCount: 1,
-        createdAt,
-      }),
-    );
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.checkpoint.revert",
-        commandId: CommandId.make("cmd-sequenced-revert-request-0"),
-        threadId: ThreadId.make("thread-1"),
-        turnCount: 0,
-        createdAt,
-      }),
-    );
-
-    await harness.drain();
-
-    expect(harness.provider.rollbackConversation).toHaveBeenCalledTimes(2);
-    expect(harness.provider.rollbackConversation.mock.calls[0]?.[0]).toEqual({
-      threadId: ThreadId.make("thread-1"),
-      numTurns: 1,
-    });
-    expect(harness.provider.rollbackConversation.mock.calls[1]?.[0]).toEqual({
-      threadId: ThreadId.make("thread-1"),
-      numTurns: 1,
-    });
-  });
-
-  it("appends an error activity when revert is requested without an active session", async () => {
-    const harness = await createHarness({ hasSession: false });
-    const createdAt = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.checkpoint.revert",
-        commandId: CommandId.make("cmd-revert-no-session"),
-        threadId: ThreadId.make("thread-1"),
-        turnCount: 1,
-        createdAt,
-      }),
-    );
-
-    const thread = await waitForThread(harness.readModel, (entry) =>
-      entry.activities.some((activity) => activity.kind === "checkpoint.revert.failed"),
-    );
-
-    expect(thread.activities.some((activity) => activity.kind === "checkpoint.revert.failed")).toBe(
-      true,
-    );
-    expect(harness.provider.rollbackConversation).not.toHaveBeenCalled();
-  });
-});
diff --git a/apps/server/src/orchestration/Layers/CheckpointReactor.ts b/apps/server/src/orchestration/Layers/CheckpointReactor.ts
deleted file mode 100644
index 95adee0cf7f8..000000000000
--- a/apps/server/src/orchestration/Layers/CheckpointReactor.ts
+++ /dev/null
@@ -1,946 +0,0 @@
-import {
-  CommandId,
-  type CheckpointRef,
-  EventId,
-  MessageId,
-  type ProjectId,
-  ThreadId,
-  TurnId,
-  type OrchestrationEvent,
-  type ProviderRuntimeEvent,
-  type VcsStatusLocalResult,
-} from "@t3tools/contracts";
-import * as Cause from "effect/Cause";
-import * as Crypto from "effect/Crypto";
-import * as DateTime from "effect/DateTime";
-import * as Effect from "effect/Effect";
-import * as Layer from "effect/Layer";
-import * as Option from "effect/Option";
-import type * as PlatformError from "effect/PlatformError";
-import * as Stream from "effect/Stream";
-import { makeDrainableWorker } from "@t3tools/shared/DrainableWorker";
-import { isTemporaryWorktreeBranch } from "@t3tools/shared/git";
-
-import { parseTurnDiffFilesFromUnifiedDiff } from "../../checkpointing/Diffs.ts";
-import {
-  checkpointRefForThreadTurn,
-  resolveThreadWorkspaceCwd,
-} from "../../checkpointing/Utils.ts";
-import * as CheckpointStore from "../../checkpointing/CheckpointStore.ts";
-import { ProviderService } from "../../provider/Services/ProviderService.ts";
-import { CheckpointReactor, type CheckpointReactorShape } from "../Services/CheckpointReactor.ts";
-import { forkParked } from "../../serverActivation.ts";
-import { OrchestrationEngineService } from "../Services/OrchestrationEngine.ts";
-import { ProjectionSnapshotQuery } from "../Services/ProjectionSnapshotQuery.ts";
-import { RuntimeReceiptBus } from "../Services/RuntimeReceiptBus.ts";
-import type { CheckpointStoreError } from "../../checkpointing/Errors.ts";
-import type { OrchestrationDispatchError } from "../Errors.ts";
-import { isGitRepository } from "../../git/Utils.ts";
-import { VcsStatusBroadcaster } from "../../vcs/VcsStatusBroadcaster.ts";
-import * as WorkspaceEntries from "../../workspace/WorkspaceEntries.ts";
-
-const nowIso = Effect.map(DateTime.now, DateTime.formatIso);
-
-type ReactorInput =
-  | {
-      readonly source: "runtime";
-      readonly event: ProviderRuntimeEvent;
-    }
-  | {
-      readonly source: "domain";
-      readonly event: OrchestrationEvent;
-    };
-
-function toTurnId(value: string | undefined): TurnId | null {
-  return value === undefined ? null : TurnId.make(String(value));
-}
-
-function sameId(left: string | null | undefined, right: string | null | undefined): boolean {
-  if (left === null || left === undefined || right === null || right === undefined) {
-    return false;
-  }
-  return left === right;
-}
-
-function checkpointStatusFromRuntime(status: string | undefined): "ready" | "missing" | "error" {
-  switch (status) {
-    case "failed":
-      return "error";
-    case "cancelled":
-    case "interrupted":
-      return "missing";
-    case "completed":
-    default:
-      return "ready";
-  }
-}
-
-const make = Effect.gen(function* () {
-  const crypto = yield* Crypto.Crypto;
-  const randomUUID = crypto.randomUUIDv4;
-  const serverEventId = randomUUID.pipe(Effect.map(EventId.make));
-  const serverCommandId = (tag: string) =>
-    randomUUID.pipe(Effect.map((uuid) => CommandId.make(`server:${tag}:${uuid}`)));
-  const orchestrationEngine = yield* OrchestrationEngineService;
-  const projectionSnapshotQuery = yield* ProjectionSnapshotQuery;
-  const providerService = yield* ProviderService;
-  const checkpointStore = yield* CheckpointStore.CheckpointStore;
-  const receiptBus = yield* RuntimeReceiptBus;
-  const workspaceEntries = yield* WorkspaceEntries.WorkspaceEntries;
-  const vcsStatusBroadcaster = yield* VcsStatusBroadcaster;
-
-  const appendRevertFailureActivity = (input: {
-    readonly threadId: ThreadId;
-    readonly turnCount: number;
-    readonly detail: string;
-    readonly createdAt: string;
-  }) =>
-    Effect.all({
-      commandId: serverCommandId("checkpoint-revert-failure"),
-      activityId: serverEventId,
-    }).pipe(
-      Effect.flatMap(({ commandId, activityId }) =>
-        orchestrationEngine.dispatch({
-          type: "thread.activity.append",
-          commandId,
-          threadId: input.threadId,
-          activity: {
-            id: activityId,
-            tone: "error",
-            kind: "checkpoint.revert.failed",
-            summary: "Checkpoint revert failed",
-            payload: {
-              turnCount: input.turnCount,
-              detail: input.detail,
-            },
-            turnId: null,
-            createdAt: input.createdAt,
-          },
-          createdAt: input.createdAt,
-        }),
-      ),
-    );
-
-  const appendCaptureFailureActivity = (input: {
-    readonly threadId: ThreadId;
-    readonly turnId: TurnId | null;
-    readonly detail: string;
-    readonly createdAt: string;
-  }) =>
-    Effect.all({
-      commandId: serverCommandId("checkpoint-capture-failure"),
-      activityId: serverEventId,
-    }).pipe(
-      Effect.flatMap(({ commandId, activityId }) =>
-        orchestrationEngine.dispatch({
-          type: "thread.activity.append",
-          commandId,
-          threadId: input.threadId,
-          activity: {
-            id: activityId,
-            tone: "error",
-            kind: "checkpoint.capture.failed",
-            summary: "Checkpoint capture failed",
-            payload: {
-              detail: input.detail,
-            },
-            turnId: input.turnId,
-            createdAt: input.createdAt,
-          },
-          createdAt: input.createdAt,
-        }),
-      ),
-    );
-
-  const resolveSessionRuntimeForThread = Effect.fn("resolveSessionRuntimeForThread")(function* (
-    threadId: ThreadId,
-  ): Effect.fn.Return<Option.Option<{ readonly threadId: ThreadId; readonly cwd: string }>> {
-    const sessions = yield* providerService.listSessions();
-    const session = sessions.find((entry) => entry.threadId === threadId);
-    return session?.cwd
-      ? Option.some({ threadId: session.threadId, cwd: session.cwd })
-      : Option.none();
-  });
-
-  const resolveThreadDetail = Effect.fn("resolveThreadDetail")(function* (threadId: ThreadId) {
-    return yield* projectionSnapshotQuery
-      .getThreadDetailById(threadId)
-      .pipe(Effect.map(Option.getOrUndefined));
-  });
-
-  const resolveThreadProjects = Effect.fn("resolveThreadProjects")(function* (
-    projectId: ProjectId,
-  ) {
-    const project = yield* projectionSnapshotQuery
-      .getProjectShellById(projectId)
-      .pipe(Effect.map(Option.getOrUndefined));
-    return project ? [project] : [];
-  });
-
-  const isGitWorkspace = (cwd: string) => isGitRepository(cwd);
-
-  // Resolves the workspace CWD for checkpoint operations, preferring the
-  // active provider session CWD and falling back to the thread/project config.
-  // Returns undefined when no CWD can be determined or the workspace is not
-  // a git repository.
-  const resolveCheckpointCwd = Effect.fn("resolveCheckpointCwd")(function* (input: {
-    readonly threadId: ThreadId;
-    readonly thread: { readonly projectId: ProjectId; readonly worktreePath: string | null };
-    readonly projects: ReadonlyArray<{ readonly id: ProjectId; readonly workspaceRoot: string }>;
-    readonly preferSessionRuntime: boolean;
-  }): Effect.fn.Return<string | undefined> {
-    const fromSession = yield* resolveSessionRuntimeForThread(input.threadId);
-    const fromThread = resolveThreadWorkspaceCwd({
-      thread: input.thread,
-      projects: input.projects,
-    });
-
-    const cwd = input.preferSessionRuntime
-      ? (Option.match(fromSession, {
-          onNone: () => undefined,
-          onSome: (runtime) => runtime.cwd,
-        }) ?? fromThread)
-      : (fromThread ??
-        Option.match(fromSession, {
-          onNone: () => undefined,
-          onSome: (runtime) => runtime.cwd,
-        }));
-
-    if (!cwd) {
-      return undefined;
-    }
-    if (!isGitWorkspace(cwd)) {
-      return undefined;
-    }
-    return cwd;
-  });
-
-  // Shared tail for both capture paths: creates the git checkpoint ref, diffs
-  // it against the previous turn, then dispatches the domain events to update
-  // the orchestration read model.
-  const captureAndDispatchCheckpoint = Effect.fn("captureAndDispatchCheckpoint")(function* (input: {
-    readonly threadId: ThreadId;
-    readonly turnId: TurnId;
-    readonly thread: {
-      readonly messages: ReadonlyArray<{
-        readonly id: MessageId;
-        readonly role: string;
-        readonly turnId: TurnId | null;
-      }>;
-    };
-    readonly cwd: string;
-    readonly turnCount: number;
-    readonly status: "ready" | "missing" | "error";
-    readonly assistantMessageId: MessageId | undefined;
-    readonly createdAt: string;
-  }) {
-    const fromTurnCount = Math.max(0, input.turnCount - 1);
-    const fromCheckpointRef = checkpointRefForThreadTurn(input.threadId, fromTurnCount);
-    const targetCheckpointRef = checkpointRefForThreadTurn(input.threadId, input.turnCount);
-
-    const fromCheckpointExists = yield* checkpointStore.hasCheckpointRef({
-      cwd: input.cwd,
-      checkpointRef: fromCheckpointRef,
-    });
-    if (!fromCheckpointExists) {
-      yield* Effect.logWarning("checkpoint capture missing pre-turn baseline", {
-        threadId: input.threadId,
-        turnId: input.turnId,
-        fromTurnCount,
-      });
-    }
-
-    yield* checkpointStore.captureCheckpoint({
-      cwd: input.cwd,
-      checkpointRef: targetCheckpointRef,
-    });
-
-    // Refresh the workspace entry index so the @-mention file picker
-    // reflects files created or deleted during this turn.
-    yield* workspaceEntries.refresh(input.cwd);
-
-    const files = yield* checkpointStore
-      .diffCheckpoints({
-        cwd: input.cwd,
-        fromCheckpointRef,
-        toCheckpointRef: targetCheckpointRef,
-        fallbackFromToHead: false,
-        ignoreWhitespace: false,
-      })
-      .pipe(
-        Effect.map((diff) =>
-          parseTurnDiffFilesFromUnifiedDiff(diff).map((file) => ({
-            path: file.path,
-            kind: "modified" as const,
-            additions: file.additions,
-            deletions: file.deletions,
-          })),
-        ),
-        Effect.tapError((error) =>
-          appendCaptureFailureActivity({
-            threadId: input.threadId,
-            turnId: input.turnId,
-            detail: `Checkpoint captured, but turn diff summary is unavailable: ${error.message}`,
-            createdAt: input.createdAt,
-          }),
-        ),
-        Effect.catch((error) =>
-          Effect.logWarning("failed to derive checkpoint file summary", {
-            threadId: input.threadId,
-            turnId: input.turnId,
-            turnCount: input.turnCount,
-            detail: error.message,
-          }).pipe(Effect.as([])),
-        ),
-      );
-
-    const assistantMessageId =
-      input.assistantMessageId ??
-      input.thread.messages
-        .toReversed()
-        .find((entry) => entry.role === "assistant" && entry.turnId === input.turnId)?.id ??
-      MessageId.make(`assistant:${input.turnId}`);
-
-    yield* orchestrationEngine.dispatch({
-      type: "thread.turn.diff.complete",
-      commandId: yield* serverCommandId("checkpoint-turn-diff-complete"),
-      threadId: input.threadId,
-      turnId: input.turnId,
-      completedAt: input.createdAt,
-      checkpointRef: targetCheckpointRef,
-      status: input.status,
-      files,
-      assistantMessageId,
-      checkpointTurnCount: input.turnCount,
-      createdAt: input.createdAt,
-    });
-    yield* receiptBus.publish({
-      type: "checkpoint.diff.finalized",
-      threadId: input.threadId,
-      turnId: input.turnId,
-      checkpointTurnCount: input.turnCount,
-      checkpointRef: targetCheckpointRef,
-      status: input.status,
-      createdAt: input.createdAt,
-    });
-    yield* receiptBus.publish({
-      type: "turn.processing.quiesced",
-      threadId: input.threadId,
-      turnId: input.turnId,
-      checkpointTurnCount: input.turnCount,
-      createdAt: input.createdAt,
-    });
-
-    yield* orchestrationEngine.dispatch({
-      type: "thread.activity.append",
-      commandId: yield* serverCommandId("checkpoint-captured-activity"),
-      threadId: input.threadId,
-      activity: {
-        id: EventId.make(yield* randomUUID),
-        tone: "info",
-        kind: "checkpoint.captured",
-        summary: "Checkpoint captured",
-        payload: {
-          turnCount: input.turnCount,
-          status: input.status,
-        },
-        turnId: input.turnId,
-        createdAt: input.createdAt,
-      },
-      createdAt: input.createdAt,
-    });
-  });
-
-  // Captures a real git checkpoint when a turn completes via a runtime event.
-  const captureCheckpointFromTurnCompletion = Effect.fn("captureCheckpointFromTurnCompletion")(
-    function* (event: Extract<ProviderRuntimeEvent, { type: "turn.completed" }>) {
-      const turnId = toTurnId(event.turnId);
-      if (!turnId) {
-        return;
-      }
-
-      const thread = yield* resolveThreadDetail(event.threadId);
-      if (!thread) {
-        return;
-      }
-
-      // When a primary turn is active, only that turn may produce completion checkpoints.
-      if (thread.session?.activeTurnId && !sameId(thread.session.activeTurnId, turnId)) {
-        return;
-      }
-
-      // Only skip if a real (non-placeholder) checkpoint already exists for this turn.
-      // ProviderRuntimeIngestion may insert placeholder entries with status "missing"
-      // before this reactor runs; those must not prevent real git capture.
-      if (
-        thread.checkpoints.some(
-          (checkpoint) => checkpoint.turnId === turnId && checkpoint.status !== "missing",
-        )
-      ) {
-        return;
-      }
-
-      const projects = yield* resolveThreadProjects(thread.projectId);
-      const checkpointCwd = yield* resolveCheckpointCwd({
-        threadId: thread.id,
-        thread,
-        projects,
-        preferSessionRuntime: true,
-      });
-      if (!checkpointCwd) {
-        return;
-      }
-
-      // If a placeholder checkpoint exists for this turn, reuse its turn count
-      // instead of incrementing past it.
-      const existingPlaceholder = thread.checkpoints.find(
-        (checkpoint) => checkpoint.turnId === turnId && checkpoint.status === "missing",
-      );
-      const currentTurnCount = thread.checkpoints.reduce(
-        (maxTurnCount, checkpoint) => Math.max(maxTurnCount, checkpoint.checkpointTurnCount),
-        0,
-      );
-      const nextTurnCount = existingPlaceholder
-        ? existingPlaceholder.checkpointTurnCount
-        : currentTurnCount + 1;
-
-      yield* captureAndDispatchCheckpoint({
-        threadId: thread.id,
-        turnId,
-        thread,
-        cwd: checkpointCwd,
-        turnCount: nextTurnCount,
-        status: checkpointStatusFromRuntime(event.payload.state),
-        assistantMessageId: undefined,
-        createdAt: event.createdAt,
-      });
-    },
-  );
-
-  // Captures a real git checkpoint when a placeholder checkpoint (status "missing")
-  // is detected via a domain event. This replaces the placeholder with a real
-  // git-ref-based checkpoint.
-  //
-  // ProviderRuntimeIngestion creates placeholder checkpoints on turn.diff.updated
-  // events from the Codex runtime. This handler fires when the corresponding
-  // domain event arrives, allowing the reactor to capture the actual filesystem
-  // state into a git ref and dispatch a replacement checkpoint.
-  const captureCheckpointFromPlaceholder = Effect.fn("captureCheckpointFromPlaceholder")(function* (
-    event: Extract<OrchestrationEvent, { type: "thread.turn-diff-completed" }>,
-  ) {
-    const { threadId, turnId, checkpointTurnCount, status } = event.payload;
-
-    // Only replace placeholders; skip events from our own real captures.
-    if (status !== "missing") {
-      return;
-    }
-
-    const thread = yield* resolveThreadDetail(threadId);
-    if (!thread) {
-      yield* Effect.logWarning("checkpoint capture from placeholder skipped: thread not found", {
-        threadId,
-      });
-      return;
-    }
-
-    // If a real checkpoint already exists for this turn, skip.
-    if (
-      thread.checkpoints.some(
-        (checkpoint) => checkpoint.turnId === turnId && checkpoint.status !== "missing",
-      )
-    ) {
-      yield* Effect.logDebug(
-        "checkpoint capture from placeholder skipped: real checkpoint already exists",
-        { threadId, turnId },
-      );
-      return;
-    }
-
-    const projects = yield* resolveThreadProjects(thread.projectId);
-    const checkpointCwd = yield* resolveCheckpointCwd({
-      threadId,
-      thread,
-      projects,
-      preferSessionRuntime: true,
-    });
-    if (!checkpointCwd) {
-      return;
-    }
-
-    yield* captureAndDispatchCheckpoint({
-      threadId,
-      turnId,
-      thread,
-      cwd: checkpointCwd,
-      turnCount: checkpointTurnCount,
-      status: "ready",
-      assistantMessageId: event.payload.assistantMessageId ?? undefined,
-      createdAt: event.payload.completedAt,
-    });
-  });
-
-  const ensurePreTurnBaselineFromTurnStart = Effect.fn("ensurePreTurnBaselineFromTurnStart")(
-    function* (event: Extract<ProviderRuntimeEvent, { type: "turn.started" }>) {
-      const turnId = toTurnId(event.turnId);
-      if (!turnId) {
-        return;
-      }
-
-      const thread = yield* resolveThreadDetail(event.threadId);
-      if (!thread) {
-        return;
-      }
-
-      const projects = yield* resolveThreadProjects(thread.projectId);
-      const checkpointCwd = yield* resolveCheckpointCwd({
-        threadId: thread.id,
-        thread,
-        projects,
-        preferSessionRuntime: false,
-      });
-      if (!checkpointCwd) {
-        return;
-      }
-
-      const currentTurnCount = thread.checkpoints.reduce(
-        (maxTurnCount, checkpoint) => Math.max(maxTurnCount, checkpoint.checkpointTurnCount),
-        0,
-      );
-      const baselineCheckpointRef = checkpointRefForThreadTurn(thread.id, currentTurnCount);
-      const baselineExists = yield* checkpointStore.hasCheckpointRef({
-        cwd: checkpointCwd,
-        checkpointRef: baselineCheckpointRef,
-      });
-      if (baselineExists) {
-        return;
-      }
-
-      yield* checkpointStore.captureCheckpoint({
-        cwd: checkpointCwd,
-        checkpointRef: baselineCheckpointRef,
-      });
-      yield* receiptBus.publish({
-        type: "checkpoint.baseline.captured",
-        threadId: thread.id,
-        checkpointTurnCount: currentTurnCount,
-        checkpointRef: baselineCheckpointRef,
-        createdAt: event.createdAt,
-      });
-    },
-  );
-
-  const refreshLocalGitStatusFromTurnCompletion = Effect.fn(
-    "refreshLocalGitStatusFromTurnCompletion",
-  )(function* (event: Extract<ProviderRuntimeEvent, { type: "turn.completed" }>) {
-    const sessionRuntime = yield* resolveSessionRuntimeForThread(event.threadId);
-    if (Option.isNone(sessionRuntime)) {
-      return;
-    }
-
-    const local = yield* vcsStatusBroadcaster.refreshLocalStatus(sessionRuntime.value.cwd).pipe(
-      Effect.catch((error) =>
-        Effect.logWarning("failed to refresh local git status after turn completion", {
-          threadId: event.threadId,
-          turnId: event.turnId ?? null,
-          cwd: sessionRuntime.value.cwd,
-          detail: error.message,
-        }).pipe(Effect.as(null)),
-      ),
-    );
-    if (local !== null) {
-      yield* followWorktreeBranchDrift({
-        threadId: event.threadId,
-        cwd: sessionRuntime.value.cwd,
-        local,
-      });
-    }
-  });
-
-  // A `git checkout` run inside a thread's dedicated worktree (by an agent or
-  // the user) bypasses T3's commands, so the thread's recorded branch goes
-  // stale. Since #4460 the client only attributes PR state to a thread when
-  // the checked-out branch equals the recorded one, so stale metadata silently
-  // orphans the thread's PR. Follow the drift here: adopt the checked-out
-  // branch as the thread's branch, but only when the worktree belongs to
-  // exactly this thread — for shared cwds the strict matching is the point.
-  const followWorktreeBranchDrift = Effect.fn("followWorktreeBranchDrift")(function* (input: {
-    readonly threadId: ThreadId;
-    readonly cwd: string;
-    readonly local: VcsStatusLocalResult;
-  }) {
-    // Detached HEAD has no branch to adopt; a temporary placeholder checkout
-    // means the first-turn auto-rename is still in flight — don't race it.
-    const checkedOutBranch = input.local.refName;
-    if (checkedOutBranch === null || isTemporaryWorktreeBranch(checkedOutBranch)) {
-      return;
-    }
-
-    yield* Effect.gen(function* () {
-      const thread = yield* projectionSnapshotQuery
-        .getThreadShellById(input.threadId)
-        .pipe(Effect.map(Option.getOrUndefined));
-      if (
-        !thread ||
-        thread.branch === null ||
-        thread.branch === checkedOutBranch ||
-        thread.worktreePath === null ||
-        thread.worktreePath !== input.cwd ||
-        isTemporaryWorktreeBranch(thread.branch)
-      ) {
-        return;
-      }
-
-      const shell = yield* projectionSnapshotQuery.getShellSnapshot();
-      const worktreeIsShared = shell.threads.some(
-        (other) => other.id !== thread.id && other.worktreePath === thread.worktreePath,
-      );
-      if (worktreeIsShared) {
-        return;
-      }
-
-      // expectedBranch makes this a compare-and-swap in the decider: if the
-      // recorded branch moved between our read and the dispatch (rename,
-      // concurrent drift-follow), the stale update is dropped.
-      yield* orchestrationEngine.dispatch({
-        type: "thread.meta.update",
-        commandId: yield* serverCommandId("worktree-branch-drift"),
-        threadId: thread.id,
-        branch: checkedOutBranch,
-        expectedBranch: thread.branch,
-      });
-      yield* Effect.logInfo("thread branch followed worktree checkout", {
-        threadId: thread.id,
-        previousBranch: thread.branch,
-        branch: checkedOutBranch,
-      });
-    }).pipe(
-      Effect.catchCause((cause) => {
-        if (Cause.hasInterruptsOnly(cause)) {
-          return Effect.failCause(cause);
-        }
-        return Effect.logWarning("failed to follow worktree branch drift", {
-          threadId: input.threadId,
-          cause: Cause.pretty(cause),
-        });
-      }),
-    );
-  });
-
-  const ensurePreTurnBaselineFromDomainTurnStart = Effect.fn(
-    "ensurePreTurnBaselineFromDomainTurnStart",
-  )(function* (
-    event: Extract<
-      OrchestrationEvent,
-      { type: "thread.turn-start-requested" | "thread.message-sent" }
-    >,
-  ) {
-    if (event.type === "thread.message-sent") {
-      if (
-        event.payload.role !== "user" ||
-        event.payload.streaming ||
-        event.payload.turnId !== null
-      ) {
-        return;
-      }
-    }
-
-    const threadId = event.payload.threadId;
-    const thread = yield* resolveThreadDetail(threadId);
-    if (!thread) {
-      return;
-    }
-
-    const projects = yield* resolveThreadProjects(thread.projectId);
-    const checkpointCwd = yield* resolveCheckpointCwd({
-      threadId,
-      thread,
-      projects,
-      preferSessionRuntime: false,
-    });
-    if (!checkpointCwd) {
-      return;
-    }
-
-    const currentTurnCount = thread.checkpoints.reduce(
-      (maxTurnCount, checkpoint) => Math.max(maxTurnCount, checkpoint.checkpointTurnCount),
-      0,
-    );
-    const baselineCheckpointRef = checkpointRefForThreadTurn(threadId, currentTurnCount);
-    const baselineExists = yield* checkpointStore.hasCheckpointRef({
-      cwd: checkpointCwd,
-      checkpointRef: baselineCheckpointRef,
-    });
-    if (baselineExists) {
-      return;
-    }
-
-    yield* checkpointStore.captureCheckpoint({
-      cwd: checkpointCwd,
-      checkpointRef: baselineCheckpointRef,
-    });
-    yield* receiptBus.publish({
-      type: "checkpoint.baseline.captured",
-      threadId,
-      checkpointTurnCount: currentTurnCount,
-      checkpointRef: baselineCheckpointRef,
-      createdAt: event.occurredAt,
-    });
-  });
-
-  const handleRevertRequested = Effect.fn("handleRevertRequested")(function* (
-    event: Extract<OrchestrationEvent, { type: "thread.checkpoint-revert-requested" }>,
-  ) {
-    const now = DateTime.formatIso(yield* DateTime.now);
-
-    const thread = yield* resolveThreadDetail(event.payload.threadId);
-    if (!thread) {
-      yield* appendRevertFailureActivity({
-        threadId: event.payload.threadId,
-        turnCount: event.payload.turnCount,
-        detail: "Thread was not found in read model.",
-        createdAt: now,
-      }).pipe(Effect.catch(() => Effect.void));
-      return;
-    }
-
-    const sessionRuntime = yield* resolveSessionRuntimeForThread(event.payload.threadId);
-    if (Option.isNone(sessionRuntime)) {
-      yield* appendRevertFailureActivity({
-        threadId: event.payload.threadId,
-        turnCount: event.payload.turnCount,
-        detail: "No active provider session with workspace cwd is bound to this thread.",
-        createdAt: now,
-      }).pipe(Effect.catch(() => Effect.void));
-      return;
-    }
-    if (!isGitWorkspace(sessionRuntime.value.cwd)) {
-      yield* appendRevertFailureActivity({
-        threadId: event.payload.threadId,
-        turnCount: event.payload.turnCount,
-        detail: "Checkpoints are unavailable because this project is not a git repository.",
-        createdAt: now,
-      }).pipe(Effect.catch(() => Effect.void));
-      return;
-    }
-
-    const currentTurnCount = thread.checkpoints.reduce(
-      (maxTurnCount, checkpoint) => Math.max(maxTurnCount, checkpoint.checkpointTurnCount),
-      0,
-    );
-
-    if (event.payload.turnCount > currentTurnCount) {
-      yield* appendRevertFailureActivity({
-        threadId: event.payload.threadId,
-        turnCount: event.payload.turnCount,
-        detail: `Checkpoint turn count ${event.payload.turnCount} exceeds current turn count ${currentTurnCount}.`,
-        createdAt: now,
-      }).pipe(Effect.catch(() => Effect.void));
-      return;
-    }
-
-    const targetCheckpointRef =
-      event.payload.turnCount === 0
-        ? checkpointRefForThreadTurn(event.payload.threadId, 0)
-        : thread.checkpoints.find(
-            (checkpoint) => checkpoint.checkpointTurnCount === event.payload.turnCount,
-          )?.checkpointRef;
-
-    if (!targetCheckpointRef) {
-      yield* appendRevertFailureActivity({
-        threadId: event.payload.threadId,
-        turnCount: event.payload.turnCount,
-        detail: `Checkpoint ref for turn ${event.payload.turnCount} is unavailable in read model.`,
-        createdAt: now,
-      }).pipe(Effect.catch(() => Effect.void));
-      return;
-    }
-
-    const restored = yield* checkpointStore.restoreCheckpoint({
-      cwd: sessionRuntime.value.cwd,
-      checkpointRef: targetCheckpointRef,
-      fallbackToHead: event.payload.turnCount === 0,
-    });
-    if (!restored) {
-      yield* appendRevertFailureActivity({
-        threadId: event.payload.threadId,
-        turnCount: event.payload.turnCount,
-        detail: `Filesystem checkpoint is unavailable for turn ${event.payload.turnCount}.`,
-        createdAt: now,
-      }).pipe(Effect.catch(() => Effect.void));
-      return;
-    }
-
-    // Refresh the workspace entry index so the @-mention file picker
-    // reflects the reverted filesystem state.
-    yield* workspaceEntries.refresh(sessionRuntime.value.cwd);
-
-    const rolledBackTurns = Math.max(0, currentTurnCount - event.payload.turnCount);
-    if (rolledBackTurns > 0) {
-      yield* providerService.rollbackConversation({
-        threadId: sessionRuntime.value.threadId,
-        numTurns: rolledBackTurns,
-      });
-    }
-
-    const staleCheckpointRefs: Array<CheckpointRef> = [];
-    for (const checkpoint of thread.checkpoints) {
-      if (checkpoint.checkpointTurnCount > event.payload.turnCount) {
-        staleCheckpointRefs.push(checkpoint.checkpointRef);
-      }
-    }
-
-    if (staleCheckpointRefs.length > 0) {
-      yield* checkpointStore.deleteCheckpointRefs({
-        cwd: sessionRuntime.value.cwd,
-        checkpointRefs: staleCheckpointRefs,
-      });
-    }
-
-    yield* orchestrationEngine
-      .dispatch({
-        type: "thread.revert.complete",
-        commandId: yield* serverCommandId("checkpoint-revert-complete"),
-        threadId: event.payload.threadId,
-        turnCount: event.payload.turnCount,
-        createdAt: now,
-      })
-      .pipe(
-        Effect.catch((error) =>
-          appendRevertFailureActivity({
-            threadId: event.payload.threadId,
-            turnCount: event.payload.turnCount,
-            detail: error.message,
-            createdAt: now,
-          }),
-        ),
-        Effect.asVoid,
-      );
-  });
-
-  const processDomainEvent = Effect.fn("processDomainEvent")(function* (event: OrchestrationEvent) {
-    if (event.type === "thread.turn-start-requested" || event.type === "thread.message-sent") {
-      yield* ensurePreTurnBaselineFromDomainTurnStart(event);
-      return;
-    }
-
-    if (event.type === "thread.checkpoint-revert-requested") {
-      yield* handleRevertRequested(event).pipe(
-        Effect.catch((error) =>
-          Effect.flatMap(nowIso, (createdAt) =>
-            appendRevertFailureActivity({
-              threadId: event.payload.threadId,
-              turnCount: event.payload.turnCount,
-              detail: error.message,
-              createdAt,
-            }),
-          ),
-        ),
-      );
-      return;
-    }
-
-    // When ProviderRuntimeIngestion creates a placeholder checkpoint (status "missing")
-    // from a turn.diff.updated runtime event, capture the real git checkpoint to
-    // replace it. The providerService.streamEvents PubSub does not reliably deliver
-    // turn.completed runtime events to this reactor (shared subscription), so
-    // reacting to the domain event is the reliable path.
-    if (event.type === "thread.turn-diff-completed") {
-      yield* captureCheckpointFromPlaceholder(event).pipe(
-        Effect.catch((error) =>
-          Effect.flatMap(nowIso, (createdAt) =>
-            appendCaptureFailureActivity({
-              threadId: event.payload.threadId,
-              turnId: event.payload.turnId,
-              detail: error.message,
-              createdAt,
-            }).pipe(Effect.catch(() => Effect.void)),
-          ),
-        ),
-      );
-    }
-  });
-
-  const processRuntimeEvent = Effect.fn("processRuntimeEvent")(function* (
-    event: ProviderRuntimeEvent,
-  ) {
-    if (event.type === "turn.started") {
-      yield* ensurePreTurnBaselineFromTurnStart(event);
-      return;
-    }
-
-    if (event.type === "turn.completed") {
-      const turnId = toTurnId(event.turnId);
-      yield* refreshLocalGitStatusFromTurnCompletion(event);
-      yield* captureCheckpointFromTurnCompletion(event).pipe(
-        Effect.catch((error) =>
-          Effect.flatMap(nowIso, (createdAt) =>
-            appendCaptureFailureActivity({
-              threadId: event.threadId,
-              turnId,
-              detail: error.message,
-              createdAt,
-            }).pipe(Effect.catch(() => Effect.void)),
-          ),
-        ),
-      );
-      return;
-    }
-  });
-
-  const processInput = (
-    input: ReactorInput,
-  ): Effect.Effect<
-    void,
-    CheckpointStoreError | OrchestrationDispatchError | PlatformError.PlatformError,
-    never
-  > =>
-    input.source === "domain" ? processDomainEvent(input.event) : processRuntimeEvent(input.event);
-
-  const processInputSafely = (input: ReactorInput) =>
-    processInput(input).pipe(
-      Effect.catchCause((cause) => {
-        if (Cause.hasInterruptsOnly(cause)) {
-          return Effect.failCause(cause);
-        }
-        return Effect.logWarning("checkpoint reactor failed to process input", {
-          source: input.source,
-          eventType: input.event.type,
-          cause: Cause.pretty(cause),
-        });
-      }),
-    );
-
-  const worker = yield* makeDrainableWorker(processInputSafely);
-
-  const start: CheckpointReactorShape["start"] = Effect.fn("start")(function* () {
-    yield* forkParked(
-      Stream.runForEach(orchestrationEngine.streamDomainEvents, (event) => {
-        if (
-          event.type !== "thread.turn-start-requested" &&
-          event.type !== "thread.message-sent" &&
-          event.type !== "thread.checkpoint-revert-requested" &&
-          event.type !== "thread.turn-diff-completed"
-        ) {
-          return Effect.void;
-        }
-        return worker.enqueue({ source: "domain", event });
-      }),
-    );
-
-    yield* forkParked(
-      Stream.runForEach(providerService.streamEvents, (event) => {
-        if (event.type !== "turn.started" && event.type !== "turn.completed") {
-          return Effect.void;
-        }
-        return worker.enqueue({ source: "runtime", event });
-      }),
-    );
-  });
-
-  return {
-    start,
-    drain: worker.drain,
-  } satisfies CheckpointReactorShape;
-});
-
-export const CheckpointReactorLive = Layer.effect(CheckpointReactor, make);
diff --git a/apps/server/src/orchestration/Layers/OrchestrationEngine.test.ts b/apps/server/src/orchestration/Layers/OrchestrationEngine.test.ts
deleted file mode 100644
index ba23d56b5e07..000000000000
--- a/apps/server/src/orchestration/Layers/OrchestrationEngine.test.ts
+++ /dev/null
@@ -1,1436 +0,0 @@
-import {
-  CheckpointRef,
-  CommandId,
-  DEFAULT_PROVIDER_INTERACTION_MODE,
-  MessageId,
-  ProjectId,
-  ThreadId,
-  TurnId,
-  type OrchestrationEvent,
-  ProviderInstanceId,
-} from "@t3tools/contracts";
-import * as NodeServices from "@effect/platform-node/NodeServices";
-import * as Effect from "effect/Effect";
-import * as Layer from "effect/Layer";
-import * as ManagedRuntime from "effect/ManagedRuntime";
-import * as Metric from "effect/Metric";
-import * as Option from "effect/Option";
-import * as Queue from "effect/Queue";
-import * as Stream from "effect/Stream";
-import { describe, expect, it } from "vite-plus/test";
-
-import { PersistenceSqlError } from "../../persistence/Errors.ts";
-import { OrchestrationCommandReceiptRepositoryLive } from "../../persistence/Layers/OrchestrationCommandReceipts.ts";
-import { OrchestrationEventStoreLive } from "../../persistence/Layers/OrchestrationEventStore.ts";
-import { SqlitePersistenceMemory } from "../../persistence/Layers/Sqlite.ts";
-import {
-  OrchestrationEventStore,
-  type OrchestrationEventStoreShape,
-} from "../../persistence/Services/OrchestrationEventStore.ts";
-import * as RepositoryIdentityResolver from "../../project/RepositoryIdentityResolver.ts";
-import { OrchestrationEngineLive } from "./OrchestrationEngine.ts";
-import { OrchestrationProjectionPipelineLive } from "./ProjectionPipeline.ts";
-import { OrchestrationProjectionSnapshotQueryLive } from "./ProjectionSnapshotQuery.ts";
-import * as ThreadBackgroundLiveness from "../ThreadBackgroundLiveness.ts";
-import * as ThreadPlanProgress from "../ThreadPlanProgress.ts";
-import { OrchestrationEngineService } from "../Services/OrchestrationEngine.ts";
-import {
-  OrchestrationProjectionPipeline,
-  type OrchestrationProjectionPipelineShape,
-} from "../Services/ProjectionPipeline.ts";
-import { ProjectionSnapshotQuery } from "../Services/ProjectionSnapshotQuery.ts";
-import { ServerConfig } from "../../config.ts";
-
-const asProjectId = (value: string): ProjectId => ProjectId.make(value);
-const asMessageId = (value: string): MessageId => MessageId.make(value);
-const asTurnId = (value: string): TurnId => TurnId.make(value);
-const asCheckpointRef = (value: string): CheckpointRef => CheckpointRef.make(value);
-
-async function createOrchestrationSystem() {
-  const ServerConfigLayer = ServerConfig.layerTest(process.cwd(), {
-    prefix: "t3-orchestration-engine-test-",
-  });
-  const orchestrationLayer = Layer.mergeAll(
-    OrchestrationEngineLive.pipe(
-      Layer.provide(OrchestrationProjectionSnapshotQueryLive),
-      Layer.provide(OrchestrationProjectionPipelineLive),
-    ),
-    OrchestrationProjectionSnapshotQueryLive,
-  ).pipe(
-    Layer.provide(ThreadBackgroundLiveness.layer),
-    Layer.provide(ThreadPlanProgress.layer),
-    Layer.provide(OrchestrationEventStoreLive),
-    Layer.provide(OrchestrationCommandReceiptRepositoryLive),
-    Layer.provide(RepositoryIdentityResolver.layer),
-    Layer.provide(SqlitePersistenceMemory),
-    Layer.provideMerge(ServerConfigLayer),
-    Layer.provideMerge(NodeServices.layer),
-  );
-  const runtime = ManagedRuntime.make(orchestrationLayer);
-  const engine = await runtime.runPromise(Effect.service(OrchestrationEngineService));
-  const snapshotQuery = await runtime.runPromise(Effect.service(ProjectionSnapshotQuery));
-  return {
-    engine,
-    readModel: () => runtime.runPromise(snapshotQuery.getSnapshot()),
-    run: <A, E>(effect: Effect.Effect<A, E>) => runtime.runPromise(effect),
-    dispose: () => runtime.dispose(),
-  };
-}
-
-function now() {
-  return "2026-01-01T00:00:00.000Z";
-}
-
-const hasMetricSnapshot = (
-  snapshots: ReadonlyArray<Metric.Metric.Snapshot>,
-  id: string,
-  attributes: Readonly<Record<string, string>>,
-) =>
-  snapshots.some(
-    (snapshot) =>
-      snapshot.id === id &&
-      Object.entries(attributes).every(([key, value]) => snapshot.attributes?.[key] === value),
-  );
-
-describe("OrchestrationEngine", () => {
-  it("bootstraps command handling from persisted projections without reading the full snapshot", async () => {
-    let nextSequence = 8;
-    const eventStore: OrchestrationEventStoreShape = {
-      append: (event) =>
-        Effect.sync(() => {
-          const savedEvent = {
-            ...event,
-            sequence: nextSequence,
-          } as OrchestrationEvent;
-          nextSequence += 1;
-          return savedEvent;
-        }),
-      readFromSequence: () => Stream.empty,
-      readAll: () =>
-        Stream.fail(
-          new PersistenceSqlError({
-            operation: "test.readAll",
-            detail: "historical replay should not be used during bootstrap",
-          }),
-        ),
-      hasEventAfter: () => Effect.succeed(false),
-    };
-
-    const projectionSnapshot = {
-      snapshotSequence: 7,
-      updatedAt: "2026-03-03T00:00:04.000Z",
-      projects: [
-        {
-          id: asProjectId("project-bootstrap"),
-          title: "Bootstrap Project",
-          workspaceRoot: "/tmp/project-bootstrap",
-          defaultModelSelection: {
-            instanceId: ProviderInstanceId.make("codex"),
-            model: "gpt-5-codex",
-          },
-          scripts: [],
-          createdAt: "2026-03-03T00:00:00.000Z",
-          updatedAt: "2026-03-03T00:00:01.000Z",
-          deletedAt: null,
-        },
-      ],
-      threads: [
-        {
-          id: ThreadId.make("thread-bootstrap"),
-          projectId: asProjectId("project-bootstrap"),
-          title: "Bootstrap Thread",
-          modelSelection: {
-            instanceId: ProviderInstanceId.make("codex"),
-            model: "gpt-5-codex",
-          },
-          interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-          runtimeMode: "full-access" as const,
-          branch: null,
-          worktreePath: null,
-          latestTurn: null,
-          createdAt: "2026-03-03T00:00:02.000Z",
-          updatedAt: "2026-03-03T00:00:03.000Z",
-          archivedAt: null,
-          settledOverride: null,
-          settledAt: null,
-          deletedAt: null,
-          messages: [],
-          proposedPlans: [],
-          activities: [],
-          checkpoints: [],
-          session: null,
-        },
-      ],
-    };
-    const commandReadModel = {
-      ...projectionSnapshot,
-      threads: projectionSnapshot.threads.map((thread) => ({
-        ...thread,
-        messages: [],
-        proposedPlans: [],
-        activities: [],
-        checkpoints: [],
-      })),
-    };
-    let fullSnapshotReadCount = 0;
-
-    const layer = OrchestrationEngineLive.pipe(
-      Layer.provide(
-        Layer.succeed(ProjectionSnapshotQuery, {
-          getCommandReadModel: () => Effect.succeed(commandReadModel),
-          getSnapshot: () =>
-            Effect.sync(() => {
-              fullSnapshotReadCount += 1;
-              return projectionSnapshot;
-            }),
-          getShellSnapshot: () =>
-            Effect.succeed({
-              snapshotSequence: projectionSnapshot.snapshotSequence,
-              projects: [],
-              threads: [],
-              updatedAt: projectionSnapshot.updatedAt,
-            }),
-          getArchivedShellSnapshot: () =>
-            Effect.succeed({
-              snapshotSequence: projectionSnapshot.snapshotSequence,
-              projects: [],
-              threads: [],
-              updatedAt: projectionSnapshot.updatedAt,
-            }),
-          getSnapshotSequence: () =>
-            Effect.succeed({ snapshotSequence: projectionSnapshot.snapshotSequence }),
-          getCounts: () => Effect.succeed({ projectCount: 1, threadCount: 1 }),
-          getActiveProjectByWorkspaceRoot: () => Effect.succeed(Option.none()),
-          getProjectShellById: () => Effect.succeed(Option.none()),
-          getFirstActiveThreadIdByProjectId: () => Effect.succeed(Option.none()),
-          getThreadCheckpointContext: () => Effect.succeed(Option.none()),
-          getFullThreadDiffContext: () => Effect.succeed(Option.none()),
-          getThreadShellById: () => Effect.succeed(Option.none()),
-          getThreadDetailById: () => Effect.succeed(Option.none()),
-          getThreadDetailSnapshot: () => Effect.succeed(Option.none()),
-          searchThreads: () => Effect.succeed({ matches: [] }),
-        }),
-      ),
-      Layer.provide(
-        Layer.succeed(OrchestrationProjectionPipeline, {
-          bootstrap: Effect.void,
-          projectEvent: () => Effect.void,
-        } satisfies OrchestrationProjectionPipelineShape),
-      ),
-      Layer.provide(Layer.succeed(OrchestrationEventStore, eventStore)),
-      Layer.provide(OrchestrationCommandReceiptRepositoryLive),
-      Layer.provide(SqlitePersistenceMemory),
-      Layer.provideMerge(NodeServices.layer),
-    );
-
-    const runtime = ManagedRuntime.make(layer);
-
-    const engine = await runtime.runPromise(Effect.service(OrchestrationEngineService));
-    expect(await runtime.runPromise(engine.latestSequence)).toBe(7);
-    const result = await runtime.runPromise(
-      engine.dispatch({
-        type: "thread.meta.update",
-        commandId: CommandId.make("cmd-bootstrap-thread-update"),
-        threadId: ThreadId.make("thread-bootstrap"),
-        title: "Updated Bootstrap Thread",
-      }),
-    );
-
-    expect(result.sequence).toBe(8);
-    expect(await runtime.runPromise(engine.latestSequence)).toBe(8);
-    expect(fullSnapshotReadCount).toBe(0);
-
-    await runtime.dispose();
-  });
-
-  it("persists deterministic read models for repeated snapshot reads", async () => {
-    const createdAt = now();
-    const system = await createOrchestrationSystem();
-    const { engine } = system;
-
-    await system.run(
-      engine.dispatch({
-        type: "project.create",
-        commandId: CommandId.make("cmd-project-1-create"),
-        projectId: asProjectId("project-1"),
-        title: "Project 1",
-        workspaceRoot: "/tmp/project-1",
-        defaultModelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5-codex",
-        },
-        createdAt,
-      }),
-    );
-    await system.run(
-      engine.dispatch({
-        type: "thread.create",
-        commandId: CommandId.make("cmd-thread-1-create"),
-        threadId: ThreadId.make("thread-1"),
-        projectId: asProjectId("project-1"),
-        title: "Thread",
-        modelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5-codex",
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        branch: null,
-        worktreePath: null,
-        createdAt,
-      }),
-    );
-    await system.run(
-      engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-1"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("msg-1"),
-          role: "user",
-          text: "hello",
-          attachments: [],
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt,
-      }),
-    );
-
-    const readModelA = await system.readModel();
-    const readModelB = await system.readModel();
-    expect(readModelB).toEqual(readModelA);
-    await system.dispose();
-  });
-
-  it("archives and unarchives threads through orchestration commands", async () => {
-    const system = await createOrchestrationSystem();
-    const { engine } = system;
-    const createdAt = now();
-
-    await system.run(
-      engine.dispatch({
-        type: "project.create",
-        commandId: CommandId.make("cmd-project-archive-create"),
-        projectId: asProjectId("project-archive"),
-        title: "Project Archive",
-        workspaceRoot: "/tmp/project-archive",
-        defaultModelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5-codex",
-        },
-        createdAt,
-      }),
-    );
-    await system.run(
-      engine.dispatch({
-        type: "thread.create",
-        commandId: CommandId.make("cmd-thread-archive-create"),
-        threadId: ThreadId.make("thread-archive"),
-        projectId: asProjectId("project-archive"),
-        title: "Archive me",
-        modelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5-codex",
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "full-access",
-        branch: null,
-        worktreePath: null,
-        createdAt,
-      }),
-    );
-
-    await system.run(
-      engine.dispatch({
-        type: "thread.meta.update",
-        commandId: CommandId.make("cmd-thread-archive-title-regeneration"),
-        threadId: ThreadId.make("thread-archive"),
-        regenerateTitle: true,
-      }),
-    );
-    await system.run(
-      engine.dispatch({
-        type: "thread.archive",
-        commandId: CommandId.make("cmd-thread-archive"),
-        threadId: ThreadId.make("thread-archive"),
-      }),
-    );
-    expect(
-      (await system.readModel()).threads.find((thread) => thread.id === "thread-archive")
-        ?.archivedAt,
-    ).not.toBeNull();
-    expect(
-      (await system.readModel()).threads.find((thread) => thread.id === "thread-archive")
-        ?.titleRegeneration,
-    ).toBeNull();
-
-    await system.run(
-      engine.dispatch({
-        type: "thread.unarchive",
-        commandId: CommandId.make("cmd-thread-unarchive"),
-        threadId: ThreadId.make("thread-archive"),
-      }),
-    );
-    expect(
-      (await system.readModel()).threads.find((thread) => thread.id === "thread-archive")
-        ?.archivedAt,
-    ).toBeNull();
-    expect(
-      (await system.readModel()).threads.find((thread) => thread.id === "thread-archive")
-        ?.titleRegeneration,
-    ).toBeNull();
-    await system.run(
-      engine.dispatch({
-        type: "thread.title.regeneration.complete",
-        commandId: CommandId.make("cmd-thread-archive-stale-title-completion"),
-        threadId: ThreadId.make("thread-archive"),
-        requestId: CommandId.make("cmd-thread-archive-title-regeneration"),
-        title: "Stale generated title",
-      }),
-    );
-    expect(
-      (await system.readModel()).threads.find((thread) => thread.id === "thread-archive")?.title,
-    ).toBe("Archive me");
-
-    await system.dispose();
-  });
-
-  it("replays append-only events from sequence", async () => {
-    const system = await createOrchestrationSystem();
-    const { engine } = system;
-    const createdAt = now();
-
-    await system.run(
-      engine.dispatch({
-        type: "project.create",
-        commandId: CommandId.make("cmd-project-replay-create"),
-        projectId: asProjectId("project-replay"),
-        title: "Replay Project",
-        workspaceRoot: "/tmp/project-replay",
-        defaultModelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5-codex",
-        },
-        createdAt,
-      }),
-    );
-    await system.run(
-      engine.dispatch({
-        type: "thread.create",
-        commandId: CommandId.make("cmd-thread-replay-create"),
-        threadId: ThreadId.make("thread-replay"),
-        projectId: asProjectId("project-replay"),
-        title: "replay",
-        modelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5-codex",
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        branch: null,
-        worktreePath: null,
-        createdAt,
-      }),
-    );
-    await system.run(
-      engine.dispatch({
-        type: "thread.delete",
-        commandId: CommandId.make("cmd-thread-replay-delete"),
-        threadId: ThreadId.make("thread-replay"),
-      }),
-    );
-
-    const events = await system.run(
-      Stream.runCollect(engine.readEvents(0)).pipe(
-        Effect.map((chunk): OrchestrationEvent[] => Array.from(chunk)),
-      ),
-    );
-    expect(events.map((event) => event.type)).toEqual([
-      "project.created",
-      "thread.created",
-      "thread.deleted",
-    ]);
-    await system.dispose();
-  });
-
-  it("streams persisted domain events in order", async () => {
-    const system = await createOrchestrationSystem();
-    const { engine } = system;
-    const createdAt = now();
-
-    await system.run(
-      engine.dispatch({
-        type: "project.create",
-        commandId: CommandId.make("cmd-project-stream-create"),
-        projectId: asProjectId("project-stream"),
-        title: "Stream Project",
-        workspaceRoot: "/tmp/project-stream",
-        defaultModelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5-codex",
-        },
-        createdAt,
-      }),
-    );
-
-    const eventTypes: string[] = [];
-    await system.run(
-      Effect.gen(function* () {
-        const eventQueue = yield* Queue.unbounded<OrchestrationEvent>();
-        yield* Effect.forkScoped(
-          Stream.take(engine.streamDomainEvents, 2).pipe(
-            Stream.runForEach((event) => Queue.offer(eventQueue, event).pipe(Effect.asVoid)),
-          ),
-        );
-        yield* Effect.sleep("10 millis");
-        yield* engine.dispatch({
-          type: "thread.create",
-          commandId: CommandId.make("cmd-stream-thread-create"),
-          threadId: ThreadId.make("thread-stream"),
-          projectId: asProjectId("project-stream"),
-          title: "domain-stream",
-          modelSelection: {
-            instanceId: ProviderInstanceId.make("codex"),
-            model: "gpt-5-codex",
-          },
-          interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-          runtimeMode: "approval-required",
-          branch: null,
-          worktreePath: null,
-          createdAt,
-        });
-        yield* engine.dispatch({
-          type: "thread.meta.update",
-          commandId: CommandId.make("cmd-stream-thread-update"),
-          threadId: ThreadId.make("thread-stream"),
-          title: "domain-stream-updated",
-        });
-        eventTypes.push((yield* Queue.take(eventQueue)).type);
-        eventTypes.push((yield* Queue.take(eventQueue)).type);
-      }).pipe(Effect.scoped),
-    );
-
-    expect(eventTypes).toEqual(["thread.created", "thread.meta-updated"]);
-    await system.dispose();
-  });
-
-  it("does not regress a generated branch to a stale temporary worktree branch", async () => {
-    const system = await createOrchestrationSystem();
-    const { engine } = system;
-    const createdAt = now();
-
-    await system.run(
-      engine.dispatch({
-        type: "project.create",
-        commandId: CommandId.make("cmd-branch-race-project-create"),
-        projectId: asProjectId("project-branch-race"),
-        title: "Branch Race Project",
-        workspaceRoot: "/tmp/project-branch-race",
-        defaultModelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5-codex",
-        },
-        createdAt,
-      }),
-    );
-    await system.run(
-      engine.dispatch({
-        type: "thread.create",
-        commandId: CommandId.make("cmd-branch-race-thread-create"),
-        threadId: ThreadId.make("thread-branch-race"),
-        projectId: asProjectId("project-branch-race"),
-        title: "Branch Race Thread",
-        modelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5-codex",
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        branch: "t3code/generated-branch-name",
-        worktreePath: "/tmp/project-branch-race-worktree",
-        createdAt,
-      }),
-    );
-
-    await system.run(
-      engine.dispatch({
-        type: "thread.meta.update",
-        commandId: CommandId.make("cmd-stale-temporary-branch-sync"),
-        threadId: ThreadId.make("thread-branch-race"),
-        branch: "t3code/1234abcd",
-        expectedBranch: "t3code/1234abcd",
-      }),
-    );
-
-    const snapshot = await system.readModel();
-    expect(snapshot.threads[0]?.branch).toBe("t3code/generated-branch-name");
-    await system.dispose();
-  });
-
-  it("allows authoritative worktree bootstrap to assign a temporary branch", async () => {
-    const system = await createOrchestrationSystem();
-    const { engine } = system;
-    const createdAt = now();
-
-    await system.run(
-      engine.dispatch({
-        type: "project.create",
-        commandId: CommandId.make("cmd-worktree-bootstrap-project-create"),
-        projectId: asProjectId("project-worktree-bootstrap"),
-        title: "Worktree Bootstrap Project",
-        workspaceRoot: "/tmp/project-worktree-bootstrap",
-        defaultModelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5-codex",
-        },
-        createdAt,
-      }),
-    );
-    await system.run(
-      engine.dispatch({
-        type: "thread.create",
-        commandId: CommandId.make("cmd-worktree-bootstrap-thread-create"),
-        threadId: ThreadId.make("thread-worktree-bootstrap"),
-        projectId: asProjectId("project-worktree-bootstrap"),
-        title: "Worktree Bootstrap Thread",
-        modelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5-codex",
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        branch: "main",
-        worktreePath: null,
-        createdAt,
-      }),
-    );
-    await system.run(
-      engine.dispatch({
-        type: "thread.meta.update",
-        commandId: CommandId.make("cmd-authoritative-worktree-bootstrap"),
-        threadId: ThreadId.make("thread-worktree-bootstrap"),
-        branch: "t3code/1234abcd",
-        worktreePath: "/tmp/project-worktree-bootstrap-worktree",
-      }),
-    );
-
-    const snapshot = await system.readModel();
-    expect(snapshot.threads[0]?.branch).toBe("t3code/1234abcd");
-    expect(snapshot.threads[0]?.worktreePath).toBe("/tmp/project-worktree-bootstrap-worktree");
-    await system.dispose();
-  });
-
-  it("records command ack duration using the first committed event type", async () => {
-    const system = await createOrchestrationSystem();
-    const { engine } = system;
-    const createdAt = now();
-
-    await system.run(
-      engine.dispatch({
-        type: "project.create",
-        commandId: CommandId.make("cmd-project-ack-create"),
-        projectId: asProjectId("project-ack"),
-        title: "Ack Project",
-        workspaceRoot: "/tmp/project-ack",
-        defaultModelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5-codex",
-        },
-        createdAt,
-      }),
-    );
-
-    await system.run(
-      engine.dispatch({
-        type: "thread.create",
-        commandId: CommandId.make("cmd-thread-ack-create"),
-        threadId: ThreadId.make("thread-ack"),
-        projectId: asProjectId("project-ack"),
-        title: "Ack Thread",
-        modelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5-codex",
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "full-access",
-        branch: null,
-        worktreePath: null,
-        createdAt,
-      }),
-    );
-
-    const snapshots = await system.run(Metric.snapshot);
-    expect(
-      hasMetricSnapshot(snapshots, "t3_orchestration_command_ack_duration", {
-        commandType: "thread.create",
-        aggregateKind: "thread",
-        ackEventType: "thread.created",
-      }),
-    ).toBe(true);
-
-    await system.dispose();
-  });
-
-  it("records failed command dispatches as metric failures", async () => {
-    const system = await createOrchestrationSystem();
-    const { engine } = system;
-    const createdAt = now();
-
-    await expect(
-      system.run(
-        engine.dispatch({
-          type: "thread.create",
-          commandId: CommandId.make("cmd-thread-missing-project"),
-          threadId: ThreadId.make("thread-missing-project"),
-          projectId: asProjectId("project-missing"),
-          title: "Missing Project Thread",
-          modelSelection: {
-            instanceId: ProviderInstanceId.make("codex"),
-            model: "gpt-5-codex",
-          },
-          interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-          runtimeMode: "full-access",
-          branch: null,
-          worktreePath: null,
-          createdAt,
-        }),
-      ),
-    ).rejects.toThrow("does not exist");
-
-    const snapshots = await system.run(Metric.snapshot);
-    expect(
-      hasMetricSnapshot(snapshots, "t3_orchestration_commands_total", {
-        commandType: "thread.create",
-        aggregateKind: "thread",
-        outcome: "failure",
-      }),
-    ).toBe(true);
-
-    await system.dispose();
-  });
-
-  it("stores completed checkpoint summaries even when no files changed", async () => {
-    const system = await createOrchestrationSystem();
-    const { engine } = system;
-    const createdAt = now();
-
-    await system.run(
-      engine.dispatch({
-        type: "project.create",
-        commandId: CommandId.make("cmd-project-turn-diff-create"),
-        projectId: asProjectId("project-turn-diff"),
-        title: "Turn Diff Project",
-        workspaceRoot: "/tmp/project-turn-diff",
-        defaultModelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5-codex",
-        },
-        createdAt,
-      }),
-    );
-    await system.run(
-      engine.dispatch({
-        type: "thread.create",
-        commandId: CommandId.make("cmd-thread-turn-diff-create"),
-        threadId: ThreadId.make("thread-turn-diff"),
-        projectId: asProjectId("project-turn-diff"),
-        title: "Turn diff thread",
-        modelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5-codex",
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        branch: null,
-        worktreePath: null,
-        createdAt,
-      }),
-    );
-    await system.run(
-      engine.dispatch({
-        type: "thread.turn.diff.complete",
-        commandId: CommandId.make("cmd-turn-diff-complete"),
-        threadId: ThreadId.make("thread-turn-diff"),
-        turnId: asTurnId("turn-1"),
-        completedAt: createdAt,
-        checkpointRef: asCheckpointRef("refs/t3/checkpoints/thread-turn-diff/turn/1"),
-        status: "ready",
-        files: [],
-        checkpointTurnCount: 1,
-        createdAt,
-      }),
-    );
-
-    const thread = (await system.readModel()).threads.find(
-      (entry) => entry.id === "thread-turn-diff",
-    );
-    expect(thread?.checkpoints).toEqual([
-      {
-        turnId: asTurnId("turn-1"),
-        checkpointTurnCount: 1,
-        checkpointRef: asCheckpointRef("refs/t3/checkpoints/thread-turn-diff/turn/1"),
-        status: "ready",
-        files: [],
-        assistantMessageId: null,
-        completedAt: createdAt,
-      },
-    ]);
-    await system.dispose();
-  });
-
-  it("keeps processing queued commands after a storage failure", async () => {
-    type StoredEvent =
-      ReturnType<OrchestrationEventStoreShape["append"]> extends Effect.Effect<infer A, any, any>
-        ? A
-        : never;
-    const events: StoredEvent[] = [];
-    let nextSequence = 1;
-    let shouldFailFirstAppend = true;
-
-    const flakyStore: OrchestrationEventStoreShape = {
-      append(event) {
-        if (shouldFailFirstAppend && event.commandId === CommandId.make("cmd-flaky-1")) {
-          shouldFailFirstAppend = false;
-          return Effect.fail(
-            new PersistenceSqlError({
-              operation: "test.append",
-              detail: "append failed",
-            }),
-          );
-        }
-        const savedEvent = {
-          ...event,
-          sequence: nextSequence,
-        } as StoredEvent;
-        nextSequence += 1;
-        events.push(savedEvent);
-        return Effect.succeed(savedEvent);
-      },
-      readFromSequence(sequenceExclusive) {
-        return Stream.fromIterable(events.filter((event) => event.sequence > sequenceExclusive));
-      },
-      readAll() {
-        return Stream.fromIterable(events);
-      },
-      hasEventAfter: () => Effect.succeed(false),
-    };
-
-    const ServerConfigLayer = ServerConfig.layerTest(process.cwd(), {
-      prefix: "t3-orchestration-engine-test-",
-    });
-
-    const runtime = ManagedRuntime.make(
-      OrchestrationEngineLive.pipe(
-        Layer.provide(OrchestrationProjectionSnapshotQueryLive),
-        Layer.provide(ThreadBackgroundLiveness.layer),
-        Layer.provide(ThreadPlanProgress.layer),
-        Layer.provide(OrchestrationProjectionPipelineLive),
-        Layer.provide(Layer.succeed(OrchestrationEventStore, flakyStore)),
-        Layer.provide(OrchestrationCommandReceiptRepositoryLive),
-        Layer.provide(RepositoryIdentityResolver.layer),
-        Layer.provide(SqlitePersistenceMemory),
-        Layer.provideMerge(ServerConfigLayer),
-        Layer.provideMerge(NodeServices.layer),
-      ),
-    );
-    const engine = await runtime.runPromise(Effect.service(OrchestrationEngineService));
-    const createdAt = now();
-
-    await runtime.runPromise(
-      engine.dispatch({
-        type: "project.create",
-        commandId: CommandId.make("cmd-project-flaky-create"),
-        projectId: asProjectId("project-flaky"),
-        title: "Flaky Project",
-        workspaceRoot: "/tmp/project-flaky",
-        defaultModelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5-codex",
-        },
-        createdAt,
-      }),
-    );
-
-    await expect(
-      runtime.runPromise(
-        engine.dispatch({
-          type: "thread.create",
-          commandId: CommandId.make("cmd-flaky-1"),
-          threadId: ThreadId.make("thread-flaky-fail"),
-          projectId: asProjectId("project-flaky"),
-          title: "flaky-fail",
-          modelSelection: {
-            instanceId: ProviderInstanceId.make("codex"),
-            model: "gpt-5-codex",
-          },
-          interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-          runtimeMode: "approval-required",
-          branch: null,
-          worktreePath: null,
-          createdAt,
-        }),
-      ),
-    ).rejects.toThrow("append failed");
-
-    const result = await runtime.runPromise(
-      engine.dispatch({
-        type: "thread.create",
-        commandId: CommandId.make("cmd-flaky-2"),
-        threadId: ThreadId.make("thread-flaky-ok"),
-        projectId: asProjectId("project-flaky"),
-        title: "flaky-ok",
-        modelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5-codex",
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        branch: null,
-        worktreePath: null,
-        createdAt,
-      }),
-    );
-
-    expect(result.sequence).toBe(2);
-    const eventsAfterRetry = await runtime.runPromise(
-      Stream.runCollect(engine.readEvents(0)).pipe(
-        Effect.map((chunk): OrchestrationEvent[] => Array.from(chunk)),
-      ),
-    );
-    expect(eventsAfterRetry.map((event) => event.type)).toEqual([
-      "project.created",
-      "thread.created",
-    ]);
-    await runtime.dispose();
-  });
-
-  it("rolls back all events for a multi-event command when projection fails mid-dispatch", async () => {
-    let shouldFailRequestedProjection = true;
-    const flakyProjectionPipeline: OrchestrationProjectionPipelineShape = {
-      bootstrap: Effect.void,
-      projectEvent: (event) => {
-        if (
-          shouldFailRequestedProjection &&
-          event.commandId === CommandId.make("cmd-turn-start-atomic") &&
-          event.type === "thread.turn-start-requested"
-        ) {
-          shouldFailRequestedProjection = false;
-          return Effect.fail(
-            new PersistenceSqlError({
-              operation: "test.projection",
-              detail: "projection failed",
-            }),
-          );
-        }
-        return Effect.void;
-      },
-    };
-
-    const runtime = ManagedRuntime.make(
-      OrchestrationEngineLive.pipe(
-        Layer.provide(OrchestrationProjectionSnapshotQueryLive),
-        Layer.provide(ThreadBackgroundLiveness.layer),
-        Layer.provide(ThreadPlanProgress.layer),
-        Layer.provide(Layer.succeed(OrchestrationProjectionPipeline, flakyProjectionPipeline)),
-        Layer.provide(OrchestrationEventStoreLive),
-        Layer.provide(OrchestrationCommandReceiptRepositoryLive),
-        Layer.provide(RepositoryIdentityResolver.layer),
-        Layer.provide(SqlitePersistenceMemory),
-        Layer.provide(NodeServices.layer),
-      ),
-    );
-    const engine = await runtime.runPromise(Effect.service(OrchestrationEngineService));
-    const createdAt = now();
-
-    await runtime.runPromise(
-      engine.dispatch({
-        type: "project.create",
-        commandId: CommandId.make("cmd-project-atomic-create"),
-        projectId: asProjectId("project-atomic"),
-        title: "Atomic Project",
-        workspaceRoot: "/tmp/project-atomic",
-        defaultModelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5-codex",
-        },
-        createdAt,
-      }),
-    );
-    await runtime.runPromise(
-      engine.dispatch({
-        type: "thread.create",
-        commandId: CommandId.make("cmd-thread-atomic-create"),
-        threadId: ThreadId.make("thread-atomic"),
-        projectId: asProjectId("project-atomic"),
-        title: "atomic",
-        modelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5-codex",
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        branch: null,
-        worktreePath: null,
-        createdAt,
-      }),
-    );
-
-    const turnStartCommand = {
-      type: "thread.turn.start" as const,
-      commandId: CommandId.make("cmd-turn-start-atomic"),
-      threadId: ThreadId.make("thread-atomic"),
-      message: {
-        messageId: asMessageId("msg-atomic-1"),
-        role: "user" as const,
-        text: "hello",
-        attachments: [],
-      },
-      interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-      runtimeMode: "approval-required" as const,
-      createdAt,
-    };
-
-    await expect(runtime.runPromise(engine.dispatch(turnStartCommand))).rejects.toThrow(
-      "projection failed",
-    );
-
-    const eventsAfterFailure = await runtime.runPromise(
-      Stream.runCollect(engine.readEvents(0)).pipe(
-        Effect.map((chunk): OrchestrationEvent[] => Array.from(chunk)),
-      ),
-    );
-    expect(eventsAfterFailure.map((event) => event.type)).toEqual([
-      "project.created",
-      "thread.created",
-    ]);
-
-    const retryResult = await runtime.runPromise(engine.dispatch(turnStartCommand));
-    expect(retryResult.sequence).toBe(4);
-
-    const eventsAfterRetry = await runtime.runPromise(
-      Stream.runCollect(engine.readEvents(0)).pipe(
-        Effect.map((chunk): OrchestrationEvent[] => Array.from(chunk)),
-      ),
-    );
-    expect(eventsAfterRetry.map((event) => event.type)).toEqual([
-      "project.created",
-      "thread.created",
-      "thread.message-sent",
-      "thread.turn-start-requested",
-    ]);
-    expect(
-      eventsAfterRetry.filter((event) => event.commandId === turnStartCommand.commandId),
-    ).toHaveLength(2);
-
-    await runtime.dispose();
-  });
-
-  it("reconciles command state when append persists but projection fails", async () => {
-    type StoredEvent =
-      ReturnType<OrchestrationEventStoreShape["append"]> extends Effect.Effect<infer A, any, any>
-        ? A
-        : never;
-    const events: StoredEvent[] = [];
-    let nextSequence = 1;
-
-    const nonTransactionalStore: OrchestrationEventStoreShape = {
-      append(event) {
-        const savedEvent = {
-          ...event,
-          sequence: nextSequence,
-        } as StoredEvent;
-        nextSequence += 1;
-        events.push(savedEvent);
-        return Effect.succeed(savedEvent);
-      },
-      readFromSequence(sequenceExclusive) {
-        return Stream.fromIterable(events.filter((event) => event.sequence > sequenceExclusive));
-      },
-      readAll() {
-        return Stream.fromIterable(events);
-      },
-      hasEventAfter: () => Effect.succeed(false),
-    };
-
-    let shouldFailProjection = true;
-    const flakyProjectionPipeline: OrchestrationProjectionPipelineShape = {
-      bootstrap: Effect.void,
-      projectEvent: (event) => {
-        if (
-          shouldFailProjection &&
-          event.commandId === CommandId.make("cmd-thread-archive-sync-fail")
-        ) {
-          shouldFailProjection = false;
-          return Effect.fail(
-            new PersistenceSqlError({
-              operation: "test.projection",
-              detail: "projection failed",
-            }),
-          );
-        }
-        return Effect.void;
-      },
-    };
-
-    const runtime = ManagedRuntime.make(
-      OrchestrationEngineLive.pipe(
-        Layer.provide(OrchestrationProjectionSnapshotQueryLive),
-        Layer.provide(ThreadBackgroundLiveness.layer),
-        Layer.provide(ThreadPlanProgress.layer),
-        Layer.provide(Layer.succeed(OrchestrationProjectionPipeline, flakyProjectionPipeline)),
-        Layer.provide(Layer.succeed(OrchestrationEventStore, nonTransactionalStore)),
-        Layer.provide(OrchestrationCommandReceiptRepositoryLive),
-        Layer.provide(RepositoryIdentityResolver.layer),
-        Layer.provide(SqlitePersistenceMemory),
-        Layer.provide(NodeServices.layer),
-      ),
-    );
-    const engine = await runtime.runPromise(Effect.service(OrchestrationEngineService));
-    const createdAt = now();
-
-    await runtime.runPromise(
-      engine.dispatch({
-        type: "project.create",
-        commandId: CommandId.make("cmd-project-sync-create"),
-        projectId: asProjectId("project-sync"),
-        title: "Sync Project",
-        workspaceRoot: "/tmp/project-sync",
-        defaultModelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5-codex",
-        },
-        createdAt,
-      }),
-    );
-    await runtime.runPromise(
-      engine.dispatch({
-        type: "thread.create",
-        commandId: CommandId.make("cmd-thread-sync-create"),
-        threadId: ThreadId.make("thread-sync"),
-        projectId: asProjectId("project-sync"),
-        title: "sync-before",
-        modelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5-codex",
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        branch: null,
-        worktreePath: null,
-        createdAt,
-      }),
-    );
-
-    await expect(
-      runtime.runPromise(
-        engine.dispatch({
-          type: "thread.archive",
-          commandId: CommandId.make("cmd-thread-archive-sync-fail"),
-          threadId: ThreadId.make("thread-sync"),
-        }),
-      ),
-    ).rejects.toThrow("projection failed");
-
-    await expect(
-      runtime.runPromise(
-        engine.dispatch({
-          type: "thread.archive",
-          commandId: CommandId.make("cmd-thread-archive-sync-retry"),
-          threadId: ThreadId.make("thread-sync"),
-        }),
-      ),
-    ).rejects.toThrow("already archived");
-
-    await runtime.dispose();
-  });
-
-  it("fails command dispatch when command invariants are violated", async () => {
-    const system = await createOrchestrationSystem();
-    const { engine } = system;
-
-    await expect(
-      system.run(
-        engine.dispatch({
-          type: "thread.turn.start",
-          commandId: CommandId.make("cmd-invariant-missing-thread"),
-          threadId: ThreadId.make("thread-missing"),
-          message: {
-            messageId: asMessageId("msg-missing"),
-            role: "user",
-            text: "hello",
-            attachments: [],
-          },
-          interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-          runtimeMode: "approval-required",
-          createdAt: now(),
-        }),
-      ),
-    ).rejects.toThrow("Thread 'thread-missing' does not exist");
-
-    await system.dispose();
-  });
-
-  it("rejects duplicate thread creation", async () => {
-    const system = await createOrchestrationSystem();
-    const { engine } = system;
-    const createdAt = now();
-
-    await system.run(
-      engine.dispatch({
-        type: "project.create",
-        commandId: CommandId.make("cmd-project-duplicate-create"),
-        projectId: asProjectId("project-duplicate"),
-        title: "Duplicate Project",
-        workspaceRoot: "/tmp/project-duplicate",
-        defaultModelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5-codex",
-        },
-        createdAt,
-      }),
-    );
-
-    await system.run(
-      engine.dispatch({
-        type: "thread.create",
-        commandId: CommandId.make("cmd-thread-duplicate-1"),
-        threadId: ThreadId.make("thread-duplicate"),
-        projectId: asProjectId("project-duplicate"),
-        title: "duplicate",
-        modelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5-codex",
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        branch: null,
-        worktreePath: null,
-        createdAt,
-      }),
-    );
-
-    await expect(
-      system.run(
-        engine.dispatch({
-          type: "thread.create",
-          commandId: CommandId.make("cmd-thread-duplicate-2"),
-          threadId: ThreadId.make("thread-duplicate"),
-          projectId: asProjectId("project-duplicate"),
-          title: "duplicate",
-          modelSelection: {
-            instanceId: ProviderInstanceId.make("codex"),
-            model: "gpt-5-codex",
-          },
-          interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-          runtimeMode: "approval-required",
-          branch: null,
-          worktreePath: null,
-          createdAt,
-        }),
-      ),
-    ).rejects.toThrow("already exists");
-
-    await system.dispose();
-  });
-
-  it("replays the accepted receipt for a genuine retry of the same command", async () => {
-    const createdAt = now();
-    const system = await createOrchestrationSystem();
-    const { engine } = system;
-
-    await system.run(
-      engine.dispatch({
-        type: "project.create",
-        commandId: CommandId.make("cmd-retry-project-create"),
-        projectId: asProjectId("project-retry"),
-        title: "Retry Project",
-        workspaceRoot: "/tmp/project-retry",
-        defaultModelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5-codex",
-        },
-        createdAt,
-      }),
-    );
-    await system.run(
-      engine.dispatch({
-        type: "thread.create",
-        commandId: CommandId.make("cmd-retry-thread-create"),
-        threadId: ThreadId.make("thread-retry"),
-        projectId: asProjectId("project-retry"),
-        title: "retry",
-        modelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5-codex",
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        branch: null,
-        worktreePath: null,
-        createdAt,
-      }),
-    );
-
-    const turnStart = {
-      type: "thread.turn.start",
-      commandId: CommandId.make("cmd-retry-turn-start"),
-      threadId: ThreadId.make("thread-retry"),
-      message: {
-        messageId: asMessageId("msg-retry"),
-        role: "user",
-        text: "hello",
-        attachments: [],
-      },
-      interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-      runtimeMode: "approval-required",
-      createdAt,
-    } as const;
-
-    const first = await system.run(engine.dispatch(turnStart));
-    const second = await system.run(engine.dispatch(turnStart));
-    expect(second.sequence).toBe(first.sequence);
-
-    const readModel = await system.readModel();
-    const thread = readModel.threads.find((candidate) => candidate.id === "thread-retry");
-    expect(thread?.messages.filter((message) => message.role === "user")).toHaveLength(1);
-
-    await system.dispose();
-  });
-
-  it("rejects reusing an accepted command id for a different aggregate", async () => {
-    const createdAt = now();
-    const system = await createOrchestrationSystem();
-    const { engine } = system;
-
-    await system.run(
-      engine.dispatch({
-        type: "project.create",
-        commandId: CommandId.make("cmd-conflict-project-create"),
-        projectId: asProjectId("project-conflict"),
-        title: "Conflict Project",
-        workspaceRoot: "/tmp/project-conflict",
-        defaultModelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5-codex",
-        },
-        createdAt,
-      }),
-    );
-    for (const threadId of ["thread-conflict-a", "thread-conflict-b"]) {
-      await system.run(
-        engine.dispatch({
-          type: "thread.create",
-          commandId: CommandId.make(`cmd-${threadId}-create`),
-          threadId: ThreadId.make(threadId),
-          projectId: asProjectId("project-conflict"),
-          title: threadId,
-          modelSelection: {
-            instanceId: ProviderInstanceId.make("codex"),
-            model: "gpt-5-codex",
-          },
-          interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-          runtimeMode: "approval-required",
-          branch: null,
-          worktreePath: null,
-          createdAt,
-        }),
-      );
-    }
-
-    await system.run(
-      engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-conflict-turn-start"),
-        threadId: ThreadId.make("thread-conflict-a"),
-        message: {
-          messageId: asMessageId("msg-conflict-a"),
-          role: "user",
-          text: "hello",
-          attachments: [],
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt,
-      }),
-    );
-
-    await expect(
-      system.run(
-        engine.dispatch({
-          type: "thread.turn.start",
-          commandId: CommandId.make("cmd-conflict-turn-start"),
-          threadId: ThreadId.make("thread-conflict-b"),
-          message: {
-            messageId: asMessageId("msg-conflict-b"),
-            role: "user",
-            text: "hello again",
-            attachments: [],
-          },
-          interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-          runtimeMode: "approval-required",
-          createdAt,
-        }),
-      ),
-    ).rejects.toThrow("already used for thread 'thread-conflict-a'");
-
-    const readModel = await system.readModel();
-    const targetThread = readModel.threads.find(
-      (candidate) => candidate.id === "thread-conflict-b",
-    );
-    expect(targetThread?.messages.filter((message) => message.role === "user")).toHaveLength(0);
-
-    await system.dispose();
-  });
-
-  it("stamps the dispatching client's origin onto persisted event metadata", async () => {
-    const createdAt = now();
-    const system = await createOrchestrationSystem();
-    const { engine } = system;
-
-    await system.run(
-      engine.dispatch(
-        {
-          type: "project.create",
-          commandId: CommandId.make("cmd-origin-project-create"),
-          projectId: asProjectId("project-origin"),
-          title: "Origin Project",
-          workspaceRoot: "/tmp/project-origin",
-          defaultModelSelection: {
-            instanceId: ProviderInstanceId.make("codex"),
-            model: "gpt-5-codex",
-          },
-          createdAt,
-        },
-        { origin: { surface: "mobile", appVersion: "1.2.3" } },
-      ),
-    );
-    await system.run(
-      engine.dispatch({
-        type: "project.create",
-        commandId: CommandId.make("cmd-no-origin-project-create"),
-        projectId: asProjectId("project-no-origin"),
-        title: "No Origin Project",
-        workspaceRoot: "/tmp/project-no-origin",
-        defaultModelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5-codex",
-        },
-        createdAt,
-      }),
-    );
-
-    const events = await system.run(
-      Stream.runCollect(engine.readEvents(0)).pipe(Effect.map((chunk) => Array.from(chunk))),
-    );
-    const withOrigin = events.find((event) => event.commandId === "cmd-origin-project-create");
-    const withoutOrigin = events.find(
-      (event) => event.commandId === "cmd-no-origin-project-create",
-    );
-
-    expect(withOrigin?.metadata.origin).toEqual({ surface: "mobile", appVersion: "1.2.3" });
-    expect(withoutOrigin?.metadata.origin).toBeUndefined();
-
-    await system.dispose();
-  });
-});
diff --git a/apps/server/src/orchestration/Layers/OrchestrationEngine.ts b/apps/server/src/orchestration/Layers/OrchestrationEngine.ts
index 423a44a6ff15..4cfb06b9cadf 100644
--- a/apps/server/src/orchestration/Layers/OrchestrationEngine.ts
+++ b/apps/server/src/orchestration/Layers/OrchestrationEngine.ts
@@ -1,11 +1,10 @@
+import type { ProjectId } from "@t3tools/contracts";
 import type {
   OrchestrationClientOrigin,
   OrchestrationEvent,
   OrchestrationReadModel,
-  ProjectId,
-  ThreadId,
-} from "@t3tools/contracts";
-import { OrchestrationCommand } from "@t3tools/contracts";
+  ProjectOrchestrationCommand,
+} from "@t3tools/contracts/legacy-orchestration";
 import * as Cause from "effect/Cause";
 import * as Clock from "effect/Clock";
 import * as Crypto from "effect/Crypto";
@@ -54,30 +53,17 @@ const isOrchestrationCommandIdConflictError = Schema.is(OrchestrationCommandIdCo
 const isOrchestrationCommandInvariantError = Schema.is(OrchestrationCommandInvariantError);
 
 interface CommandEnvelope {
-  command: OrchestrationCommand;
+  command: ProjectOrchestrationCommand;
   origin: OrchestrationClientOrigin | undefined;
   result: Deferred.Deferred<{ sequence: number }, OrchestrationDispatchError>;
   startedAtMs: number;
 }
 
-function commandToAggregateRef(command: OrchestrationCommand): {
-  readonly aggregateKind: "project" | "thread";
-  readonly aggregateId: ProjectId | ThreadId;
+function commandToAggregateRef(command: ProjectOrchestrationCommand): {
+  readonly aggregateKind: "project";
+  readonly aggregateId: ProjectId;
 } {
-  switch (command.type) {
-    case "project.create":
-    case "project.meta.update":
-    case "project.delete":
-      return {
-        aggregateKind: "project",
-        aggregateId: command.projectId,
-      };
-    default:
-      return {
-        aggregateKind: "thread",
-        aggregateId: command.threadId,
-      };
-  }
+  return { aggregateKind: "project", aggregateId: command.projectId };
 }
 
 const makeOrchestrationEngine = Effect.gen(function* () {
@@ -124,6 +110,15 @@ const makeOrchestrationEngine = Effect.gen(function* () {
 
       commandReadModel = yield* projectEventsOntoReadModel(commandReadModel, persistedEvents);
 
+      yield* eventStore.publishCommitted(
+        persistedEvents.filter(
+          (event) =>
+            event.type === "project.created" ||
+            event.type === "project.meta-updated" ||
+            event.type === "project.deleted",
+        ),
+      );
+
       for (const persistedEvent of persistedEvents) {
         yield* PubSub.publish(eventPubSub, persistedEvent);
       }
@@ -219,6 +214,7 @@ const makeOrchestrationEngine = Effect.gen(function* () {
                 commandId: envelope.command.commandId,
                 aggregateKind: lastSavedEvent.aggregateKind,
                 aggregateId: lastSavedEvent.aggregateId,
+                commandType: envelope.command.type,
                 acceptedAt: lastSavedEvent.occurredAt,
                 resultSequence: lastSavedEvent.sequence,
                 status: "accepted",
@@ -241,6 +237,14 @@ const makeOrchestrationEngine = Effect.gen(function* () {
           );
 
         commandReadModel = committedCommand.nextCommandReadModel;
+        yield* eventStore.publishCommitted(
+          committedCommand.committedEvents.filter(
+            (event) =>
+              event.type === "project.created" ||
+              event.type === "project.meta-updated" ||
+              event.type === "project.deleted",
+          ),
+        );
         for (const [index, event] of committedCommand.committedEvents.entries()) {
           yield* PubSub.publish(eventPubSub, event);
           if (index === 0) {
@@ -313,6 +317,7 @@ const makeOrchestrationEngine = Effect.gen(function* () {
                   commandId: envelope.command.commandId,
                   aggregateKind: aggregateRef.aggregateKind,
                   aggregateId: aggregateRef.aggregateId,
+                  commandType: envelope.command.type,
                   acceptedAt: yield* nowIso,
                   resultSequence: commandReadModel.snapshotSequence,
                   status: "rejected",
diff --git a/apps/server/src/orchestration/Layers/OrchestrationReactor.test.ts b/apps/server/src/orchestration/Layers/OrchestrationReactor.test.ts
deleted file mode 100644
index b05ce3b1e235..000000000000
--- a/apps/server/src/orchestration/Layers/OrchestrationReactor.test.ts
+++ /dev/null
@@ -1,93 +0,0 @@
-import * as Effect from "effect/Effect";
-import * as Exit from "effect/Exit";
-import * as Layer from "effect/Layer";
-import * as ManagedRuntime from "effect/ManagedRuntime";
-import * as Scope from "effect/Scope";
-import { afterEach, describe, expect, it } from "vite-plus/test";
-
-import { CheckpointReactor } from "../Services/CheckpointReactor.ts";
-import { ProviderCommandReactor } from "../Services/ProviderCommandReactor.ts";
-import { ProviderRuntimeIngestionService } from "../Services/ProviderRuntimeIngestion.ts";
-import { ThreadDeletionReactor } from "../Services/ThreadDeletionReactor.ts";
-import { OrchestrationReactor } from "../Services/OrchestrationReactor.ts";
-import { makeOrchestrationReactor } from "./OrchestrationReactor.ts";
-import * as AgentAwarenessRelay from "../../relay/AgentAwarenessRelay.ts";
-
-describe("OrchestrationReactor", () => {
-  let runtime: ManagedRuntime.ManagedRuntime<OrchestrationReactor, never> | null = null;
-
-  afterEach(async () => {
-    if (runtime) {
-      await runtime.dispose();
-    }
-    runtime = null;
-  });
-
-  it("starts provider ingestion, provider command, checkpoint, and thread deletion reactors", async () => {
-    const started: string[] = [];
-
-    runtime = ManagedRuntime.make(
-      Layer.effect(OrchestrationReactor, makeOrchestrationReactor).pipe(
-        Layer.provideMerge(
-          Layer.succeed(ProviderRuntimeIngestionService, {
-            start: () => {
-              started.push("provider-runtime-ingestion");
-              return Effect.void;
-            },
-            drain: Effect.void,
-          }),
-        ),
-        Layer.provideMerge(
-          Layer.succeed(ProviderCommandReactor, {
-            start: () => {
-              started.push("provider-command-reactor");
-              return Effect.void;
-            },
-            drain: Effect.void,
-          }),
-        ),
-        Layer.provideMerge(
-          Layer.succeed(CheckpointReactor, {
-            start: () => {
-              started.push("checkpoint-reactor");
-              return Effect.void;
-            },
-            drain: Effect.void,
-          }),
-        ),
-        Layer.provideMerge(
-          Layer.succeed(ThreadDeletionReactor, {
-            start: () => {
-              started.push("thread-deletion-reactor");
-              return Effect.void;
-            },
-            drainThrough: () => Effect.void,
-          }),
-        ),
-        Layer.provideMerge(
-          Layer.succeed(AgentAwarenessRelay.AgentAwarenessRelay, {
-            publishThread: () => Effect.void,
-            start: () => {
-              started.push("agent-awareness-relay");
-              return Effect.void;
-            },
-          }),
-        ),
-      ),
-    );
-
-    const reactor = await runtime!.runPromise(Effect.service(OrchestrationReactor));
-    const scope = await Effect.runPromise(Scope.make("sequential"));
-    await Effect.runPromise(reactor.start().pipe(Scope.provide(scope)));
-
-    expect(started).toEqual([
-      "provider-runtime-ingestion",
-      "provider-command-reactor",
-      "checkpoint-reactor",
-      "thread-deletion-reactor",
-      "agent-awareness-relay",
-    ]);
-
-    await Effect.runPromise(Scope.close(scope, Exit.void));
-  });
-});
diff --git a/apps/server/src/orchestration/Layers/OrchestrationReactor.ts b/apps/server/src/orchestration/Layers/OrchestrationReactor.ts
deleted file mode 100644
index fb7543e31af0..000000000000
--- a/apps/server/src/orchestration/Layers/OrchestrationReactor.ts
+++ /dev/null
@@ -1,37 +0,0 @@
-import * as Effect from "effect/Effect";
-import * as Layer from "effect/Layer";
-
-import {
-  OrchestrationReactor,
-  type OrchestrationReactorShape,
-} from "../Services/OrchestrationReactor.ts";
-import { CheckpointReactor } from "../Services/CheckpointReactor.ts";
-import { ProviderCommandReactor } from "../Services/ProviderCommandReactor.ts";
-import { ProviderRuntimeIngestionService } from "../Services/ProviderRuntimeIngestion.ts";
-import { ThreadDeletionReactor } from "../Services/ThreadDeletionReactor.ts";
-import * as AgentAwarenessRelay from "../../relay/AgentAwarenessRelay.ts";
-
-export const makeOrchestrationReactor = Effect.gen(function* () {
-  const providerRuntimeIngestion = yield* ProviderRuntimeIngestionService;
-  const providerCommandReactor = yield* ProviderCommandReactor;
-  const checkpointReactor = yield* CheckpointReactor;
-  const threadDeletionReactor = yield* ThreadDeletionReactor;
-  const agentAwarenessRelay = yield* AgentAwarenessRelay.AgentAwarenessRelay;
-
-  const start: OrchestrationReactorShape["start"] = Effect.fn("start")(function* () {
-    yield* providerRuntimeIngestion.start();
-    yield* providerCommandReactor.start();
-    yield* checkpointReactor.start();
-    yield* threadDeletionReactor.start();
-    yield* agentAwarenessRelay.start();
-  });
-
-  return {
-    start,
-  } satisfies OrchestrationReactorShape;
-});
-
-export const OrchestrationReactorLive = Layer.effect(
-  OrchestrationReactor,
-  makeOrchestrationReactor,
-);
diff --git a/apps/server/src/orchestration/Layers/ProjectEnrichmentProjection.test.ts b/apps/server/src/orchestration/Layers/ProjectEnrichmentProjection.test.ts
new file mode 100644
index 000000000000..be31c4d917ae
--- /dev/null
+++ b/apps/server/src/orchestration/Layers/ProjectEnrichmentProjection.test.ts
@@ -0,0 +1,105 @@
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import { assert, it } from "@effect/vitest";
+import { ProjectId } from "@t3tools/contracts";
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+import * as Fiber from "effect/Fiber";
+import * as Layer from "effect/Layer";
+import * as Stream from "effect/Stream";
+import * as SqlClient from "effect/unstable/sql/SqlClient";
+
+import { ServerConfig } from "../../config.ts";
+import { SqlitePersistenceMemory } from "../../persistence/Layers/Sqlite.ts";
+import * as ProjectEnrichment from "../../project/ProjectEnrichmentService.ts";
+import * as ProjectFaviconResolver from "../../project/ProjectFaviconResolver.ts";
+import * as RepositoryIdentityResolver from "../../project/RepositoryIdentityResolver.ts";
+import { ProjectionSnapshotQuery } from "../Services/ProjectionSnapshotQuery.ts";
+import * as ThreadBackgroundLiveness from "../ThreadBackgroundLiveness.ts";
+import * as ThreadPlanProgress from "../ThreadPlanProgress.ts";
+import { OrchestrationProjectionSnapshotQueryLive } from "./ProjectionSnapshotQuery.ts";
+
+it.effect("keeps shell snapshots and later deltas moving while project enrichment is hung", () =>
+  Effect.gen(function* () {
+    const repositoryStarted = yield* Deferred.make<void>();
+    const releaseRepository = yield* Deferred.make<void>();
+    const metadataLayer = Layer.merge(
+      Layer.succeed(RepositoryIdentityResolver.RepositoryIdentityResolver, {
+        resolve: (workspaceRoot) =>
+          Deferred.succeed(repositoryStarted, undefined).pipe(
+            Effect.andThen(Deferred.await(releaseRepository)),
+            Effect.as({
+              canonicalKey: "example.test/project",
+              locator: {
+                source: "git-remote" as const,
+                remoteName: "origin",
+                remoteUrl: "https://example.test/project.git",
+              },
+              rootPath: workspaceRoot,
+            }),
+          ),
+      }),
+      Layer.succeed(ProjectFaviconResolver.ProjectFaviconResolver, {
+        resolvePath: () => Effect.succeed(null),
+      }),
+    );
+    const testLayer = OrchestrationProjectionSnapshotQueryLive.pipe(
+      Layer.provideMerge(ThreadBackgroundLiveness.layer),
+      Layer.provideMerge(ThreadPlanProgress.layer),
+      Layer.provideMerge(ProjectEnrichment.layer),
+      Layer.provideMerge(metadataLayer),
+      Layer.provideMerge(SqlitePersistenceMemory),
+      Layer.provide(
+        ServerConfig.layerTest(process.cwd(), { prefix: "projection-snapshot-query-test-" }),
+      ),
+      Layer.provide(NodeServices.layer),
+    );
+
+    yield* Effect.gen(function* () {
+      const sql = yield* SqlClient.SqlClient;
+      const query = yield* ProjectionSnapshotQuery;
+      const projectId = ProjectId.make("project:hung-enrichment");
+      const now = "2026-06-22T00:00:00.000Z";
+      yield* sql`
+        INSERT INTO projection_projects (
+          project_id,
+          title,
+          workspace_root,
+          default_model_selection_json,
+          scripts_json,
+          created_at,
+          updated_at,
+          deleted_at
+        ) VALUES (
+          ${projectId},
+          'Hung enrichment',
+          '/work/hung-enrichment',
+          NULL,
+          '[]',
+          ${now},
+          ${now},
+          NULL
+        )
+      `;
+
+      const snapshotFiber = yield* query
+        .getShellSnapshot()
+        .pipe(Effect.forkChild({ startImmediately: true }));
+      const snapshot = yield* Fiber.join(snapshotFiber);
+      assert.equal(snapshot.projects[0]?.id, projectId);
+      assert.isNull(snapshot.projects[0]?.repositoryIdentity ?? null);
+      yield* Deferred.await(repositoryStarted);
+
+      const delivered = yield* Stream.fromIterable(["project", "thread"] as const).pipe(
+        Stream.mapEffect((kind) =>
+          kind === "project"
+            ? query.getProjectShellById(projectId).pipe(Effect.as(kind))
+            : Effect.succeed(kind),
+        ),
+        Stream.runCollect,
+      );
+      assert.deepEqual(Array.from(delivered), ["project", "thread"]);
+
+      yield* Deferred.succeed(releaseRepository, undefined);
+    }).pipe(Effect.provide(testLayer));
+  }),
+);
diff --git a/apps/server/src/orchestration/Layers/ProjectionPipeline.test.ts b/apps/server/src/orchestration/Layers/ProjectionPipeline.test.ts
deleted file mode 100644
index 57215803f4b9..000000000000
--- a/apps/server/src/orchestration/Layers/ProjectionPipeline.test.ts
+++ /dev/null
@@ -1,3220 +0,0 @@
-import {
-  CheckpointRef,
-  CommandId,
-  CorrelationId,
-  EventId,
-  MessageId,
-  ProjectId,
-  ThreadId,
-  TurnId,
-  ProviderInstanceId,
-} from "@t3tools/contracts";
-import * as Option from "effect/Option";
-import * as NodeServices from "@effect/platform-node/NodeServices";
-import { assert, it } from "@effect/vitest";
-import * as Effect from "effect/Effect";
-import * as FileSystem from "effect/FileSystem";
-import * as Layer from "effect/Layer";
-import * as Path from "effect/Path";
-import * as SqlClient from "effect/unstable/sql/SqlClient";
-
-import { OrchestrationCommandReceiptRepositoryLive } from "../../persistence/Layers/OrchestrationCommandReceipts.ts";
-import { OrchestrationEventStoreLive } from "../../persistence/Layers/OrchestrationEventStore.ts";
-import {
-  makeSqlitePersistenceLive,
-  SqlitePersistenceMemory,
-} from "../../persistence/Layers/Sqlite.ts";
-import { OrchestrationEventStore } from "../../persistence/Services/OrchestrationEventStore.ts";
-import * as RepositoryIdentityResolver from "../../project/RepositoryIdentityResolver.ts";
-import { OrchestrationEngineLive } from "./OrchestrationEngine.ts";
-import {
-  ORCHESTRATION_PROJECTOR_NAMES,
-  OrchestrationProjectionPipelineLive,
-} from "./ProjectionPipeline.ts";
-import { OrchestrationProjectionSnapshotQueryLive } from "./ProjectionSnapshotQuery.ts";
-import { ProjectionSnapshotQuery } from "../Services/ProjectionSnapshotQuery.ts";
-import * as ThreadBackgroundLiveness from "../ThreadBackgroundLiveness.ts";
-import * as ThreadPlanProgress from "../ThreadPlanProgress.ts";
-import { OrchestrationEngineService } from "../Services/OrchestrationEngine.ts";
-import { OrchestrationProjectionPipeline } from "../Services/ProjectionPipeline.ts";
-import { ServerConfig } from "../../config.ts";
-
-const makeProjectionPipelinePrefixedTestLayer = (prefix: string) =>
-  OrchestrationProjectionPipelineLive.pipe(
-    Layer.provideMerge(OrchestrationEventStoreLive),
-    Layer.provideMerge(ServerConfig.layerTest(process.cwd(), { prefix })),
-    Layer.provideMerge(SqlitePersistenceMemory),
-    Layer.provideMerge(NodeServices.layer),
-  );
-
-const exists = (filePath: string) =>
-  Effect.gen(function* () {
-    const fileSystem = yield* FileSystem.FileSystem;
-    const fileInfo = yield* Effect.result(fileSystem.stat(filePath));
-    return fileInfo._tag === "Success";
-  });
-
-const BaseTestLayer = makeProjectionPipelinePrefixedTestLayer("t3-projection-pipeline-test-");
-
-it.layer(BaseTestLayer)("OrchestrationProjectionPipeline", (it) => {
-  it.effect("bootstraps all projection states and writes projection rows", () =>
-    Effect.gen(function* () {
-      const projectionPipeline = yield* OrchestrationProjectionPipeline;
-      const eventStore = yield* OrchestrationEventStore;
-      const sql = yield* SqlClient.SqlClient;
-      const now = "2026-01-01T00:00:00.000Z";
-
-      yield* eventStore.append({
-        type: "project.created",
-        eventId: EventId.make("evt-1"),
-        aggregateKind: "project",
-        aggregateId: ProjectId.make("project-1"),
-        occurredAt: now,
-        commandId: CommandId.make("cmd-1"),
-        causationEventId: null,
-        correlationId: CommandId.make("cmd-1"),
-        metadata: {},
-        payload: {
-          projectId: ProjectId.make("project-1"),
-          title: "Project 1",
-          workspaceRoot: "/tmp/project-1",
-          defaultModelSelection: null,
-          scripts: [],
-          createdAt: now,
-          updatedAt: now,
-        },
-      });
-
-      yield* eventStore.append({
-        type: "thread.created",
-        eventId: EventId.make("evt-2"),
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-1"),
-        occurredAt: now,
-        commandId: CommandId.make("cmd-2"),
-        causationEventId: null,
-        correlationId: CommandId.make("cmd-2"),
-        metadata: {},
-        payload: {
-          threadId: ThreadId.make("thread-1"),
-          projectId: ProjectId.make("project-1"),
-          title: "Thread 1",
-          modelSelection: {
-            instanceId: ProviderInstanceId.make("codex"),
-            model: "gpt-5-codex",
-          },
-          runtimeMode: "full-access",
-          branch: null,
-          worktreePath: null,
-          createdAt: now,
-          updatedAt: now,
-        },
-      });
-
-      yield* eventStore.append({
-        type: "thread.message-sent",
-        eventId: EventId.make("evt-3"),
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-1"),
-        occurredAt: now,
-        commandId: CommandId.make("cmd-3"),
-        causationEventId: null,
-        correlationId: CommandId.make("cmd-3"),
-        metadata: {},
-        payload: {
-          threadId: ThreadId.make("thread-1"),
-          messageId: MessageId.make("message-1"),
-          role: "assistant",
-          text: "hello",
-          turnId: null,
-          streaming: false,
-          createdAt: now,
-          updatedAt: now,
-        },
-      });
-
-      yield* projectionPipeline.bootstrap;
-
-      const projectRows = yield* sql<{
-        readonly projectId: string;
-        readonly title: string;
-        readonly scriptsJson: string;
-      }>`
-        SELECT
-          project_id AS "projectId",
-          title,
-          scripts_json AS "scriptsJson"
-        FROM projection_projects
-      `;
-      assert.deepEqual(projectRows, [
-        { projectId: "project-1", title: "Project 1", scriptsJson: "[]" },
-      ]);
-
-      const messageRows = yield* sql<{
-        readonly messageId: string;
-        readonly text: string;
-      }>`
-        SELECT
-          message_id AS "messageId",
-          text
-        FROM projection_thread_messages
-      `;
-      assert.deepEqual(messageRows, [{ messageId: "message-1", text: "hello" }]);
-
-      const stateRows = yield* sql<{
-        readonly projector: string;
-        readonly lastAppliedSequence: number;
-      }>`
-        SELECT
-          projector,
-          last_applied_sequence AS "lastAppliedSequence"
-        FROM projection_state
-        ORDER BY projector ASC
-      `;
-      assert.equal(stateRows.length, Object.keys(ORCHESTRATION_PROJECTOR_NAMES).length);
-      for (const row of stateRows) {
-        assert.equal(row.lastAppliedSequence, 3);
-      }
-
-      yield* sql`CREATE TABLE thread_shell_updates (count INTEGER NOT NULL)`;
-      yield* sql`INSERT INTO thread_shell_updates (count) VALUES (0)`;
-      yield* sql`
-        CREATE TRIGGER count_thread_shell_updates
-        AFTER UPDATE ON projection_threads
-        WHEN NEW.thread_id = 'thread-1'
-        BEGIN
-          UPDATE thread_shell_updates SET count = count + 1;
-        END;
-      `;
-
-      yield* eventStore.append({
-        type: "thread.message-sent",
-        eventId: EventId.make("evt-assistant-update"),
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-1"),
-        occurredAt: "2026-01-01T00:00:00.100Z",
-        commandId: CommandId.make("cmd-assistant-update"),
-        causationEventId: null,
-        correlationId: CommandId.make("cmd-assistant-update"),
-        metadata: {},
-        payload: {
-          threadId: ThreadId.make("thread-1"),
-          messageId: MessageId.make("message-2"),
-          role: "assistant",
-          text: "more work",
-          turnId: null,
-          streaming: false,
-          createdAt: "2026-01-01T00:00:00.100Z",
-          updatedAt: "2026-01-01T00:00:00.100Z",
-        },
-      });
-      yield* projectionPipeline.bootstrap;
-
-      let threadShellUpdates = yield* sql<{ readonly count: number }>`
-        SELECT count FROM thread_shell_updates
-      `;
-      assert.deepEqual(threadShellUpdates, [{ count: 1 }]);
-
-      yield* sql`UPDATE thread_shell_updates SET count = 0`;
-      yield* eventStore.append({
-        type: "thread.activity-appended",
-        eventId: EventId.make("evt-routine-activity"),
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-1"),
-        occurredAt: "2026-01-01T00:00:00.200Z",
-        commandId: CommandId.make("cmd-routine-activity"),
-        causationEventId: null,
-        correlationId: CommandId.make("cmd-routine-activity"),
-        metadata: {},
-        payload: {
-          threadId: ThreadId.make("thread-1"),
-          activity: {
-            id: EventId.make("activity-routine"),
-            tone: "tool",
-            kind: "tool.updated",
-            summary: "Tool made progress",
-            payload: {},
-            turnId: null,
-            createdAt: "2026-01-01T00:00:00.200Z",
-          },
-        },
-      });
-      yield* projectionPipeline.bootstrap;
-
-      threadShellUpdates = yield* sql<{ readonly count: number }>`
-        SELECT count FROM thread_shell_updates
-      `;
-      assert.deepEqual(threadShellUpdates, [{ count: 1 }]);
-      yield* sql`DROP TRIGGER count_thread_shell_updates`;
-      yield* sql`DROP TABLE thread_shell_updates`;
-
-      // Settled lifecycle through the DB pipeline: thread.settled writes the
-      // override + timestamp, thread.unsettled(user) flips to the active pin.
-      yield* eventStore.append({
-        type: "thread.settled",
-        eventId: EventId.make("evt-settle-1"),
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-1"),
-        occurredAt: "2026-01-01T00:00:01.000Z",
-        commandId: CommandId.make("cmd-settle-1"),
-        causationEventId: null,
-        correlationId: CommandId.make("cmd-settle-1"),
-        metadata: {},
-        payload: {
-          threadId: ThreadId.make("thread-1"),
-          settledAt: "2026-01-01T00:00:01.000Z",
-          updatedAt: "2026-01-01T00:00:01.000Z",
-        },
-      });
-      yield* projectionPipeline.bootstrap;
-
-      const settledRows = yield* sql<{
-        readonly settledOverride: string | null;
-        readonly settledAt: string | null;
-        readonly unsettledAt: string | null;
-      }>`
-        SELECT
-          settled_override AS "settledOverride",
-          settled_at AS "settledAt",
-          unsettled_at AS "unsettledAt"
-        FROM projection_threads
-        WHERE thread_id = 'thread-1'
-      `;
-      assert.deepEqual(settledRows, [
-        { settledOverride: "settled", settledAt: "2026-01-01T00:00:01.000Z", unsettledAt: null },
-      ]);
-
-      yield* eventStore.append({
-        type: "thread.unsettled",
-        eventId: EventId.make("evt-unsettle-1"),
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-1"),
-        occurredAt: "2026-01-01T00:00:02.000Z",
-        commandId: CommandId.make("cmd-unsettle-1"),
-        causationEventId: null,
-        correlationId: CommandId.make("cmd-unsettle-1"),
-        metadata: {},
-        payload: {
-          threadId: ThreadId.make("thread-1"),
-          reason: "user",
-          updatedAt: "2026-01-01T00:00:02.000Z",
-        },
-      });
-      yield* projectionPipeline.bootstrap;
-
-      const unsettledRows = yield* sql<{
-        readonly settledOverride: string | null;
-        readonly settledAt: string | null;
-        readonly unsettledAt: string | null;
-      }>`
-        SELECT
-          settled_override AS "settledOverride",
-          settled_at AS "settledAt",
-          unsettled_at AS "unsettledAt"
-        FROM projection_threads
-        WHERE thread_id = 'thread-1'
-      `;
-      // The un-settle stamps the active-list re-entry time so clients can
-      // surface the thread at the top of the list.
-      assert.deepEqual(unsettledRows, [
-        {
-          settledOverride: "active",
-          settledAt: null,
-          unsettledAt: "2026-01-01T00:00:02.000Z",
-        },
-      ]);
-    }),
-  );
-});
-
-it.layer(Layer.fresh(makeProjectionPipelinePrefixedTestLayer("t3-base-")))(
-  "OrchestrationProjectionPipeline",
-  (it) => {
-    it.effect("stores message attachment references without mutating payloads", () =>
-      Effect.gen(function* () {
-        const projectionPipeline = yield* OrchestrationProjectionPipeline;
-        const eventStore = yield* OrchestrationEventStore;
-        const sql = yield* SqlClient.SqlClient;
-        const now = "2026-01-01T00:00:00.000Z";
-
-        yield* eventStore.append({
-          type: "thread.message-sent",
-          eventId: EventId.make("evt-attachments"),
-          aggregateKind: "thread",
-          aggregateId: ThreadId.make("thread-attachments"),
-          occurredAt: now,
-          commandId: CommandId.make("cmd-attachments"),
-          causationEventId: null,
-          correlationId: CommandId.make("cmd-attachments"),
-          metadata: {},
-          payload: {
-            threadId: ThreadId.make("thread-attachments"),
-            messageId: MessageId.make("message-attachments"),
-            role: "user",
-            text: "Inspect this",
-            attachments: [
-              {
-                type: "image",
-                id: "thread-attachments-att-1",
-                name: "example.png",
-                mimeType: "image/png",
-                sizeBytes: 5,
-              },
-            ],
-            turnId: null,
-            streaming: false,
-            createdAt: now,
-            updatedAt: now,
-          },
-        });
-
-        yield* projectionPipeline.bootstrap;
-
-        const rows = yield* sql<{
-          readonly attachmentsJson: string | null;
-        }>`
-            SELECT
-              attachments_json AS "attachmentsJson"
-            FROM projection_thread_messages
-            WHERE message_id = 'message-attachments'
-          `;
-        assert.equal(rows.length, 1);
-        // @effect-diagnostics-next-line preferSchemaOverJson:off
-        assert.deepEqual(JSON.parse(rows[0]?.attachmentsJson ?? "null"), [
-          {
-            type: "image",
-            id: "thread-attachments-att-1",
-            name: "example.png",
-            mimeType: "image/png",
-            sizeBytes: 5,
-          },
-        ]);
-      }),
-    );
-  },
-);
-
-it.layer(Layer.fresh(makeProjectionPipelinePrefixedTestLayer("t3-projection-attachments-safe-")))(
-  "OrchestrationProjectionPipeline",
-  (it) => {
-    it.effect("preserves mixed image attachment metadata as-is", () =>
-      Effect.gen(function* () {
-        const projectionPipeline = yield* OrchestrationProjectionPipeline;
-        const eventStore = yield* OrchestrationEventStore;
-        const sql = yield* SqlClient.SqlClient;
-        const now = "2026-01-01T00:00:00.000Z";
-
-        yield* eventStore.append({
-          type: "thread.message-sent",
-          eventId: EventId.make("evt-attachments-safe"),
-          aggregateKind: "thread",
-          aggregateId: ThreadId.make("thread-attachments-safe"),
-          occurredAt: now,
-          commandId: CommandId.make("cmd-attachments-safe"),
-          causationEventId: null,
-          correlationId: CommandId.make("cmd-attachments-safe"),
-          metadata: {},
-          payload: {
-            threadId: ThreadId.make("thread-attachments-safe"),
-            messageId: MessageId.make("message-attachments-safe"),
-            role: "user",
-            text: "Inspect this",
-            attachments: [
-              {
-                type: "image",
-                id: "thread-attachments-safe-att-1",
-                name: "untrusted.exe",
-                mimeType: "image/x-unknown",
-                sizeBytes: 5,
-              },
-              {
-                type: "image",
-                id: "thread-attachments-safe-att-2",
-                name: "not-image.png",
-                mimeType: "image/png",
-                sizeBytes: 5,
-              },
-            ],
-            turnId: null,
-            streaming: false,
-            createdAt: now,
-            updatedAt: now,
-          },
-        });
-
-        yield* projectionPipeline.bootstrap;
-
-        const rows = yield* sql<{
-          readonly attachmentsJson: string | null;
-        }>`
-            SELECT
-              attachments_json AS "attachmentsJson"
-            FROM projection_thread_messages
-            WHERE message_id = 'message-attachments-safe'
-          `;
-        assert.equal(rows.length, 1);
-        // @effect-diagnostics-next-line preferSchemaOverJson:off
-        assert.deepEqual(JSON.parse(rows[0]?.attachmentsJson ?? "null"), [
-          {
-            type: "image",
-            id: "thread-attachments-safe-att-1",
-            name: "untrusted.exe",
-            mimeType: "image/x-unknown",
-            sizeBytes: 5,
-          },
-          {
-            type: "image",
-            id: "thread-attachments-safe-att-2",
-            name: "not-image.png",
-            mimeType: "image/png",
-            sizeBytes: 5,
-          },
-        ]);
-      }),
-    );
-  },
-);
-
-it.layer(BaseTestLayer)("OrchestrationProjectionPipeline", (it) => {
-  it.effect(
-    "passes explicit empty attachment arrays through the projection pipeline to clear attachments",
-    () =>
-      Effect.gen(function* () {
-        const projectionPipeline = yield* OrchestrationProjectionPipeline;
-        const eventStore = yield* OrchestrationEventStore;
-        const sql = yield* SqlClient.SqlClient;
-        const now = "2026-01-01T00:00:00.000Z";
-        const later = "2026-01-01T00:00:01.000Z";
-
-        yield* eventStore.append({
-          type: "project.created",
-          eventId: EventId.make("evt-clear-attachments-1"),
-          aggregateKind: "project",
-          aggregateId: ProjectId.make("project-clear-attachments"),
-          occurredAt: now,
-          commandId: CommandId.make("cmd-clear-attachments-1"),
-          causationEventId: null,
-          correlationId: CommandId.make("cmd-clear-attachments-1"),
-          metadata: {},
-          payload: {
-            projectId: ProjectId.make("project-clear-attachments"),
-            title: "Project Clear Attachments",
-            workspaceRoot: "/tmp/project-clear-attachments",
-            defaultModelSelection: null,
-            scripts: [],
-            createdAt: now,
-            updatedAt: now,
-          },
-        });
-
-        yield* eventStore.append({
-          type: "thread.created",
-          eventId: EventId.make("evt-clear-attachments-2"),
-          aggregateKind: "thread",
-          aggregateId: ThreadId.make("thread-clear-attachments"),
-          occurredAt: now,
-          commandId: CommandId.make("cmd-clear-attachments-2"),
-          causationEventId: null,
-          correlationId: CommandId.make("cmd-clear-attachments-2"),
-          metadata: {},
-          payload: {
-            threadId: ThreadId.make("thread-clear-attachments"),
-            projectId: ProjectId.make("project-clear-attachments"),
-            title: "Thread Clear Attachments",
-            modelSelection: {
-              instanceId: ProviderInstanceId.make("codex"),
-              model: "gpt-5-codex",
-            },
-            runtimeMode: "full-access",
-            branch: null,
-            worktreePath: null,
-            createdAt: now,
-            updatedAt: now,
-          },
-        });
-
-        yield* eventStore.append({
-          type: "thread.message-sent",
-          eventId: EventId.make("evt-clear-attachments-3"),
-          aggregateKind: "thread",
-          aggregateId: ThreadId.make("thread-clear-attachments"),
-          occurredAt: now,
-          commandId: CommandId.make("cmd-clear-attachments-3"),
-          causationEventId: null,
-          correlationId: CommandId.make("cmd-clear-attachments-3"),
-          metadata: {},
-          payload: {
-            threadId: ThreadId.make("thread-clear-attachments"),
-            messageId: MessageId.make("message-clear-attachments"),
-            role: "user",
-            text: "Has attachments",
-            attachments: [
-              {
-                type: "image",
-                id: "thread-clear-attachments-att-1",
-                name: "clear.png",
-                mimeType: "image/png",
-                sizeBytes: 5,
-              },
-            ],
-            turnId: null,
-            streaming: false,
-            createdAt: now,
-            updatedAt: now,
-          },
-        });
-
-        yield* eventStore.append({
-          type: "thread.message-sent",
-          eventId: EventId.make("evt-clear-attachments-4"),
-          aggregateKind: "thread",
-          aggregateId: ThreadId.make("thread-clear-attachments"),
-          occurredAt: later,
-          commandId: CommandId.make("cmd-clear-attachments-4"),
-          causationEventId: null,
-          correlationId: CommandId.make("cmd-clear-attachments-4"),
-          metadata: {},
-          payload: {
-            threadId: ThreadId.make("thread-clear-attachments"),
-            messageId: MessageId.make("message-clear-attachments"),
-            role: "user",
-            text: "",
-            attachments: [],
-            turnId: null,
-            streaming: false,
-            createdAt: now,
-            updatedAt: later,
-          },
-        });
-
-        yield* projectionPipeline.bootstrap;
-
-        const rows = yield* sql<{
-          readonly attachmentsJson: string | null;
-        }>`
-          SELECT
-            attachments_json AS "attachmentsJson"
-          FROM projection_thread_messages
-          WHERE message_id = 'message-clear-attachments'
-        `;
-        assert.equal(rows.length, 1);
-        // @effect-diagnostics-next-line preferSchemaOverJson:off
-        assert.deepEqual(JSON.parse(rows[0]?.attachmentsJson ?? "null"), []);
-      }),
-  );
-});
-
-it.layer(
-  Layer.fresh(makeProjectionPipelinePrefixedTestLayer("t3-projection-attachments-overwrite-")),
-)("OrchestrationProjectionPipeline", (it) => {
-  it.effect("overwrites stored attachment references when a message updates attachments", () =>
-    Effect.gen(function* () {
-      const projectionPipeline = yield* OrchestrationProjectionPipeline;
-      const eventStore = yield* OrchestrationEventStore;
-      const sql = yield* SqlClient.SqlClient;
-      const now = "2026-01-01T00:00:00.000Z";
-      const later = "2026-01-01T00:00:01.000Z";
-
-      yield* eventStore.append({
-        type: "project.created",
-        eventId: EventId.make("evt-overwrite-1"),
-        aggregateKind: "project",
-        aggregateId: ProjectId.make("project-overwrite"),
-        occurredAt: now,
-        commandId: CommandId.make("cmd-overwrite-1"),
-        causationEventId: null,
-        correlationId: CommandId.make("cmd-overwrite-1"),
-        metadata: {},
-        payload: {
-          projectId: ProjectId.make("project-overwrite"),
-          title: "Project Overwrite",
-          workspaceRoot: "/tmp/project-overwrite",
-          defaultModelSelection: null,
-          scripts: [],
-          createdAt: now,
-          updatedAt: now,
-        },
-      });
-
-      yield* eventStore.append({
-        type: "thread.created",
-        eventId: EventId.make("evt-overwrite-2"),
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-overwrite"),
-        occurredAt: now,
-        commandId: CommandId.make("cmd-overwrite-2"),
-        causationEventId: null,
-        correlationId: CommandId.make("cmd-overwrite-2"),
-        metadata: {},
-        payload: {
-          threadId: ThreadId.make("thread-overwrite"),
-          projectId: ProjectId.make("project-overwrite"),
-          title: "Thread Overwrite",
-          modelSelection: {
-            instanceId: ProviderInstanceId.make("codex"),
-            model: "gpt-5-codex",
-          },
-          runtimeMode: "full-access",
-          branch: null,
-          worktreePath: null,
-          createdAt: now,
-          updatedAt: now,
-        },
-      });
-
-      yield* eventStore.append({
-        type: "thread.message-sent",
-        eventId: EventId.make("evt-overwrite-3"),
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-overwrite"),
-        occurredAt: now,
-        commandId: CommandId.make("cmd-overwrite-3"),
-        causationEventId: null,
-        correlationId: CommandId.make("cmd-overwrite-3"),
-        metadata: {},
-        payload: {
-          threadId: ThreadId.make("thread-overwrite"),
-          messageId: MessageId.make("message-overwrite"),
-          role: "user",
-          text: "first image",
-          attachments: [
-            {
-              type: "image",
-              id: "thread-overwrite-att-1",
-              name: "file.png",
-              mimeType: "image/png",
-              sizeBytes: 5,
-            },
-          ],
-          turnId: null,
-          streaming: false,
-          createdAt: now,
-          updatedAt: now,
-        },
-      });
-
-      yield* eventStore.append({
-        type: "thread.message-sent",
-        eventId: EventId.make("evt-overwrite-4"),
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-overwrite"),
-        occurredAt: later,
-        commandId: CommandId.make("cmd-overwrite-4"),
-        causationEventId: null,
-        correlationId: CommandId.make("cmd-overwrite-4"),
-        metadata: {},
-        payload: {
-          threadId: ThreadId.make("thread-overwrite"),
-          messageId: MessageId.make("message-overwrite"),
-          role: "user",
-          text: "",
-          attachments: [
-            {
-              type: "image",
-              id: "thread-overwrite-att-2",
-              name: "file.png",
-              mimeType: "image/png",
-              sizeBytes: 5,
-            },
-          ],
-          turnId: null,
-          streaming: false,
-          createdAt: now,
-          updatedAt: later,
-        },
-      });
-
-      yield* projectionPipeline.bootstrap;
-
-      const rows = yield* sql<{
-        readonly attachmentsJson: string | null;
-      }>`
-              SELECT attachments_json AS "attachmentsJson"
-              FROM projection_thread_messages
-              WHERE message_id = 'message-overwrite'
-            `;
-      assert.equal(rows.length, 1);
-      // @effect-diagnostics-next-line preferSchemaOverJson:off
-      assert.deepEqual(JSON.parse(rows[0]?.attachmentsJson ?? "null"), [
-        {
-          type: "image",
-          id: "thread-overwrite-att-2",
-          name: "file.png",
-          mimeType: "image/png",
-          sizeBytes: 5,
-        },
-      ]);
-    }),
-  );
-});
-
-it.layer(
-  Layer.fresh(makeProjectionPipelinePrefixedTestLayer("t3-projection-attachments-rollback-")),
-)("OrchestrationProjectionPipeline", (it) => {
-  it.effect("does not persist attachment files when projector transaction rolls back", () =>
-    Effect.gen(function* () {
-      const projectionPipeline = yield* OrchestrationProjectionPipeline;
-      const eventStore = yield* OrchestrationEventStore;
-      const path = yield* Path.Path;
-      const sql = yield* SqlClient.SqlClient;
-      const now = "2026-01-01T00:00:00.000Z";
-
-      const appendAndProject = (event: Parameters<typeof eventStore.append>[0]) =>
-        eventStore
-          .append(event)
-          .pipe(Effect.flatMap((savedEvent) => projectionPipeline.projectEvent(savedEvent)));
-
-      yield* appendAndProject({
-        type: "project.created",
-        eventId: EventId.make("evt-rollback-1"),
-        aggregateKind: "project",
-        aggregateId: ProjectId.make("project-rollback"),
-        occurredAt: now,
-        commandId: CommandId.make("cmd-rollback-1"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-rollback-1"),
-        metadata: {},
-        payload: {
-          projectId: ProjectId.make("project-rollback"),
-          title: "Project Rollback",
-          workspaceRoot: "/tmp/project-rollback",
-          defaultModelSelection: null,
-          scripts: [],
-          createdAt: now,
-          updatedAt: now,
-        },
-      });
-
-      yield* appendAndProject({
-        type: "thread.created",
-        eventId: EventId.make("evt-rollback-2"),
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-rollback"),
-        occurredAt: now,
-        commandId: CommandId.make("cmd-rollback-2"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-rollback-2"),
-        metadata: {},
-        payload: {
-          threadId: ThreadId.make("thread-rollback"),
-          projectId: ProjectId.make("project-rollback"),
-          title: "Thread Rollback",
-          modelSelection: {
-            instanceId: ProviderInstanceId.make("codex"),
-            model: "gpt-5-codex",
-          },
-          runtimeMode: "full-access",
-          branch: null,
-          worktreePath: null,
-          createdAt: now,
-          updatedAt: now,
-        },
-      });
-
-      yield* sql`
-        CREATE TRIGGER fail_thread_messages_projection_state_update
-        BEFORE UPDATE ON projection_state
-        WHEN NEW.projector = 'projection.thread-messages'
-        BEGIN
-          SELECT RAISE(ABORT, 'forced-projection-state-failure');
-        END;
-      `;
-
-      const result = yield* Effect.result(
-        appendAndProject({
-          type: "thread.message-sent",
-          eventId: EventId.make("evt-rollback-3"),
-          aggregateKind: "thread",
-          aggregateId: ThreadId.make("thread-rollback"),
-          occurredAt: now,
-          commandId: CommandId.make("cmd-rollback-3"),
-          causationEventId: null,
-          correlationId: CorrelationId.make("cmd-rollback-3"),
-          metadata: {},
-          payload: {
-            threadId: ThreadId.make("thread-rollback"),
-            messageId: MessageId.make("message-rollback"),
-            role: "user",
-            text: "Rollback me",
-            attachments: [
-              {
-                type: "image",
-                id: "thread-rollback-att-1",
-                name: "rollback.png",
-                mimeType: "image/png",
-                sizeBytes: 5,
-              },
-            ],
-            turnId: null,
-            streaming: false,
-            createdAt: now,
-            updatedAt: now,
-          },
-        }),
-      );
-      assert.equal(result._tag, "Failure");
-
-      const rows = yield* sql<{
-        readonly count: number;
-      }>`
-        SELECT COUNT(*) AS "count"
-        FROM projection_thread_messages
-        WHERE message_id = 'message-rollback'
-      `;
-      assert.equal(rows[0]?.count ?? 0, 0);
-
-      const { attachmentsDir } = yield* ServerConfig;
-      const attachmentPath = path.join(attachmentsDir, "thread-rollback-att-1.png");
-      assert.isFalse(yield* exists(attachmentPath));
-      yield* sql`DROP TRIGGER IF EXISTS fail_thread_messages_projection_state_update`;
-    }),
-  );
-});
-
-it.layer(
-  Layer.fresh(makeProjectionPipelinePrefixedTestLayer("t3-projection-attachments-overwrite-")),
-)("OrchestrationProjectionPipeline", (it) => {
-  it.effect("removes unreferenced attachment files when a thread is reverted", () =>
-    Effect.gen(function* () {
-      const fileSystem = yield* FileSystem.FileSystem;
-      const path = yield* Path.Path;
-      const projectionPipeline = yield* OrchestrationProjectionPipeline;
-      const eventStore = yield* OrchestrationEventStore;
-      const { attachmentsDir } = yield* ServerConfig;
-      const now = "2026-01-01T00:00:00.000Z";
-      const threadId = ThreadId.make("Thread Revert.Files");
-      const keepAttachmentId = "thread-revert-files-00000000-0000-4000-8000-000000000001";
-      const keepFileAttachmentId = "thread-revert-files-00000000-0000-4000-8000-000000000004-pdf";
-      const removeAttachmentId = "thread-revert-files-00000000-0000-4000-8000-000000000002";
-      const otherThreadAttachmentId =
-        "thread-revert-files-extra-00000000-0000-4000-8000-000000000003";
-
-      const appendAndProject = (event: Parameters<typeof eventStore.append>[0]) =>
-        eventStore
-          .append(event)
-          .pipe(Effect.flatMap((savedEvent) => projectionPipeline.projectEvent(savedEvent)));
-
-      yield* appendAndProject({
-        type: "project.created",
-        eventId: EventId.make("evt-revert-files-1"),
-        aggregateKind: "project",
-        aggregateId: ProjectId.make("project-revert-files"),
-        occurredAt: now,
-        commandId: CommandId.make("cmd-revert-files-1"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-revert-files-1"),
-        metadata: {},
-        payload: {
-          projectId: ProjectId.make("project-revert-files"),
-          title: "Project Revert Files",
-          workspaceRoot: "/tmp/project-revert-files",
-          defaultModelSelection: null,
-          scripts: [],
-          createdAt: now,
-          updatedAt: now,
-        },
-      });
-
-      yield* appendAndProject({
-        type: "thread.created",
-        eventId: EventId.make("evt-revert-files-2"),
-        aggregateKind: "thread",
-        aggregateId: threadId,
-        occurredAt: now,
-        commandId: CommandId.make("cmd-revert-files-2"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-revert-files-2"),
-        metadata: {},
-        payload: {
-          threadId,
-          projectId: ProjectId.make("project-revert-files"),
-          title: "Thread Revert Files",
-          modelSelection: {
-            instanceId: ProviderInstanceId.make("codex"),
-            model: "gpt-5-codex",
-          },
-          runtimeMode: "full-access",
-          branch: null,
-          worktreePath: null,
-          createdAt: now,
-          updatedAt: now,
-        },
-      });
-
-      yield* appendAndProject({
-        type: "thread.turn-diff-completed",
-        eventId: EventId.make("evt-revert-files-3"),
-        aggregateKind: "thread",
-        aggregateId: threadId,
-        occurredAt: now,
-        commandId: CommandId.make("cmd-revert-files-3"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-revert-files-3"),
-        metadata: {},
-        payload: {
-          threadId,
-          turnId: TurnId.make("turn-keep"),
-          checkpointTurnCount: 1,
-          checkpointRef: CheckpointRef.make("refs/t3/checkpoints/thread-revert-files/turn/1"),
-          status: "ready",
-          files: [],
-          assistantMessageId: MessageId.make("message-keep"),
-          completedAt: now,
-        },
-      });
-
-      yield* appendAndProject({
-        type: "thread.message-sent",
-        eventId: EventId.make("evt-revert-files-4"),
-        aggregateKind: "thread",
-        aggregateId: threadId,
-        occurredAt: now,
-        commandId: CommandId.make("cmd-revert-files-4"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-revert-files-4"),
-        metadata: {},
-        payload: {
-          threadId,
-          messageId: MessageId.make("message-keep"),
-          role: "assistant",
-          text: "Keep",
-          attachments: [
-            {
-              type: "image",
-              id: keepAttachmentId,
-              name: "keep.png",
-              mimeType: "image/png",
-              sizeBytes: 5,
-            },
-            {
-              type: "file",
-              id: keepFileAttachmentId,
-              name: "keep.pdf",
-              mimeType: "application/pdf",
-              sizeBytes: 5,
-            },
-          ],
-          turnId: TurnId.make("turn-keep"),
-          streaming: false,
-          createdAt: now,
-          updatedAt: now,
-        },
-      });
-
-      yield* appendAndProject({
-        type: "thread.turn-diff-completed",
-        eventId: EventId.make("evt-revert-files-5"),
-        aggregateKind: "thread",
-        aggregateId: threadId,
-        occurredAt: now,
-        commandId: CommandId.make("cmd-revert-files-5"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-revert-files-5"),
-        metadata: {},
-        payload: {
-          threadId,
-          turnId: TurnId.make("turn-remove"),
-          checkpointTurnCount: 2,
-          checkpointRef: CheckpointRef.make("refs/t3/checkpoints/thread-revert-files/turn/2"),
-          status: "ready",
-          files: [],
-          assistantMessageId: MessageId.make("message-remove"),
-          completedAt: now,
-        },
-      });
-
-      yield* appendAndProject({
-        type: "thread.message-sent",
-        eventId: EventId.make("evt-revert-files-6"),
-        aggregateKind: "thread",
-        aggregateId: threadId,
-        occurredAt: now,
-        commandId: CommandId.make("cmd-revert-files-6"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-revert-files-6"),
-        metadata: {},
-        payload: {
-          threadId,
-          messageId: MessageId.make("message-remove"),
-          role: "assistant",
-          text: "Remove",
-          attachments: [
-            {
-              type: "image",
-              id: removeAttachmentId,
-              name: "remove.png",
-              mimeType: "image/png",
-              sizeBytes: 5,
-            },
-          ],
-          turnId: TurnId.make("turn-remove"),
-          streaming: false,
-          createdAt: now,
-          updatedAt: now,
-        },
-      });
-
-      const keepPath = path.join(attachmentsDir, `${keepAttachmentId}.png`);
-      const keepFilePath = path.join(attachmentsDir, `${keepFileAttachmentId}.pdf`);
-      const removePath = path.join(attachmentsDir, `${removeAttachmentId}.png`);
-      yield* fileSystem.makeDirectory(attachmentsDir, { recursive: true });
-      yield* fileSystem.writeFileString(keepPath, "keep");
-      yield* fileSystem.writeFileString(keepFilePath, "keep");
-      yield* fileSystem.writeFileString(removePath, "remove");
-      const otherThreadPath = path.join(attachmentsDir, `${otherThreadAttachmentId}.png`);
-      yield* fileSystem.writeFileString(otherThreadPath, "other");
-      assert.isTrue(yield* exists(keepPath));
-      assert.isTrue(yield* exists(removePath));
-      assert.isTrue(yield* exists(otherThreadPath));
-
-      yield* appendAndProject({
-        type: "thread.reverted",
-        eventId: EventId.make("evt-revert-files-7"),
-        aggregateKind: "thread",
-        aggregateId: threadId,
-        occurredAt: now,
-        commandId: CommandId.make("cmd-revert-files-7"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-revert-files-7"),
-        metadata: {},
-        payload: {
-          threadId,
-          turnCount: 1,
-        },
-      });
-
-      assert.isTrue(yield* exists(keepPath));
-      assert.isTrue(yield* exists(keepFilePath));
-      assert.isFalse(yield* exists(removePath));
-      assert.isTrue(yield* exists(otherThreadPath));
-    }),
-  );
-});
-
-it.layer(Layer.fresh(makeProjectionPipelinePrefixedTestLayer("t3-projection-attachments-revert-")))(
-  "OrchestrationProjectionPipeline",
-  (it) => {
-    it.effect("removes thread attachment directory when thread is deleted", () =>
-      Effect.gen(function* () {
-        const fileSystem = yield* FileSystem.FileSystem;
-        const path = yield* Path.Path;
-        const projectionPipeline = yield* OrchestrationProjectionPipeline;
-        const eventStore = yield* OrchestrationEventStore;
-        const { attachmentsDir } = yield* ServerConfig;
-        const now = "2026-01-01T00:00:00.000Z";
-        const threadId = ThreadId.make("Thread Delete.Files");
-        const attachmentId = "thread-delete-files-00000000-0000-4000-8000-000000000001";
-        const fileAttachmentId = "thread-delete-files-00000000-0000-4000-8000-000000000003-pdf";
-        const otherThreadAttachmentId =
-          "thread-delete-files-extra-00000000-0000-4000-8000-000000000002";
-
-        const appendAndProject = (event: Parameters<typeof eventStore.append>[0]) =>
-          eventStore
-            .append(event)
-            .pipe(Effect.flatMap((savedEvent) => projectionPipeline.projectEvent(savedEvent)));
-
-        yield* appendAndProject({
-          type: "project.created",
-          eventId: EventId.make("evt-delete-files-1"),
-          aggregateKind: "project",
-          aggregateId: ProjectId.make("project-delete-files"),
-          occurredAt: now,
-          commandId: CommandId.make("cmd-delete-files-1"),
-          causationEventId: null,
-          correlationId: CorrelationId.make("cmd-delete-files-1"),
-          metadata: {},
-          payload: {
-            projectId: ProjectId.make("project-delete-files"),
-            title: "Project Delete Files",
-            workspaceRoot: "/tmp/project-delete-files",
-            defaultModelSelection: null,
-            scripts: [],
-            createdAt: now,
-            updatedAt: now,
-          },
-        });
-
-        yield* appendAndProject({
-          type: "thread.created",
-          eventId: EventId.make("evt-delete-files-2"),
-          aggregateKind: "thread",
-          aggregateId: threadId,
-          occurredAt: now,
-          commandId: CommandId.make("cmd-delete-files-2"),
-          causationEventId: null,
-          correlationId: CorrelationId.make("cmd-delete-files-2"),
-          metadata: {},
-          payload: {
-            threadId,
-            projectId: ProjectId.make("project-delete-files"),
-            title: "Thread Delete Files",
-            modelSelection: {
-              instanceId: ProviderInstanceId.make("codex"),
-              model: "gpt-5-codex",
-            },
-            runtimeMode: "full-access",
-            branch: null,
-            worktreePath: null,
-            createdAt: now,
-            updatedAt: now,
-          },
-        });
-
-        yield* appendAndProject({
-          type: "thread.message-sent",
-          eventId: EventId.make("evt-delete-files-3"),
-          aggregateKind: "thread",
-          aggregateId: threadId,
-          occurredAt: now,
-          commandId: CommandId.make("cmd-delete-files-3"),
-          causationEventId: null,
-          correlationId: CorrelationId.make("cmd-delete-files-3"),
-          metadata: {},
-          payload: {
-            threadId,
-            messageId: MessageId.make("message-delete-files"),
-            role: "user",
-            text: "Delete",
-            attachments: [
-              {
-                type: "image",
-                id: attachmentId,
-                name: "delete.png",
-                mimeType: "image/png",
-                sizeBytes: 5,
-              },
-              {
-                type: "file",
-                id: fileAttachmentId,
-                name: "delete.pdf",
-                mimeType: "application/pdf",
-                sizeBytes: 6,
-              },
-            ],
-            turnId: null,
-            streaming: false,
-            createdAt: now,
-            updatedAt: now,
-          },
-        });
-
-        const threadAttachmentPath = path.join(attachmentsDir, `${attachmentId}.png`);
-        const threadFileAttachmentPath = path.join(attachmentsDir, `${fileAttachmentId}.pdf`);
-        const otherThreadAttachmentPath = path.join(
-          attachmentsDir,
-          `${otherThreadAttachmentId}.png`,
-        );
-        yield* fileSystem.makeDirectory(attachmentsDir, { recursive: true });
-        yield* fileSystem.writeFileString(threadAttachmentPath, "delete");
-        yield* fileSystem.writeFileString(threadFileAttachmentPath, "delete");
-        yield* fileSystem.writeFileString(otherThreadAttachmentPath, "other-thread");
-        assert.isTrue(yield* exists(threadAttachmentPath));
-        assert.isTrue(yield* exists(threadFileAttachmentPath));
-        assert.isTrue(yield* exists(otherThreadAttachmentPath));
-
-        yield* appendAndProject({
-          type: "thread.deleted",
-          eventId: EventId.make("evt-delete-files-4"),
-          aggregateKind: "thread",
-          aggregateId: threadId,
-          occurredAt: now,
-          commandId: CommandId.make("cmd-delete-files-4"),
-          causationEventId: null,
-          correlationId: CorrelationId.make("cmd-delete-files-4"),
-          metadata: {},
-          payload: {
-            threadId,
-            deletedAt: now,
-          },
-        });
-
-        assert.isFalse(yield* exists(threadAttachmentPath));
-        assert.isFalse(yield* exists(threadFileAttachmentPath));
-        assert.isTrue(yield* exists(otherThreadAttachmentPath));
-      }),
-    );
-  },
-);
-
-it.layer(Layer.fresh(makeProjectionPipelinePrefixedTestLayer("t3-projection-attachments-delete-")))(
-  "OrchestrationProjectionPipeline",
-  (it) => {
-    it.effect("ignores unsafe thread ids for attachment cleanup paths", () =>
-      Effect.gen(function* () {
-        const fileSystem = yield* FileSystem.FileSystem;
-        const path = yield* Path.Path;
-        const projectionPipeline = yield* OrchestrationProjectionPipeline;
-        const eventStore = yield* OrchestrationEventStore;
-        const now = "2026-01-01T00:00:00.000Z";
-        const { attachmentsDir: attachmentsRootDir, stateDir } = yield* ServerConfig;
-        const attachmentsSentinelPath = path.join(attachmentsRootDir, "sentinel.txt");
-        const stateDirSentinelPath = path.join(stateDir, "state-sentinel.txt");
-        yield* fileSystem.makeDirectory(attachmentsRootDir, { recursive: true });
-        yield* fileSystem.writeFileString(attachmentsSentinelPath, "keep-attachments-root");
-        yield* fileSystem.writeFileString(stateDirSentinelPath, "keep-state-dir");
-
-        yield* eventStore.append({
-          type: "thread.deleted",
-          eventId: EventId.make("evt-unsafe-thread-delete"),
-          aggregateKind: "thread",
-          aggregateId: ThreadId.make(".."),
-          occurredAt: now,
-          commandId: CommandId.make("cmd-unsafe-thread-delete"),
-          causationEventId: null,
-          correlationId: CorrelationId.make("cmd-unsafe-thread-delete"),
-          metadata: {},
-          payload: {
-            threadId: ThreadId.make(".."),
-            deletedAt: now,
-          },
-        });
-
-        yield* projectionPipeline.bootstrap;
-
-        assert.isTrue(yield* exists(attachmentsRootDir));
-        assert.isTrue(yield* exists(attachmentsSentinelPath));
-        assert.isTrue(yield* exists(stateDirSentinelPath));
-      }),
-    );
-  },
-);
-
-it.layer(Layer.fresh(makeProjectionPipelinePrefixedTestLayer("t3-projection-attachments-replay-")))(
-  "OrchestrationProjectionPipeline",
-  (it) => {
-    it.effect("replaying a superseded thread.deleted keeps the re-created thread's files", () =>
-      Effect.gen(function* () {
-        const fileSystem = yield* FileSystem.FileSystem;
-        const path = yield* Path.Path;
-        const projectionPipeline = yield* OrchestrationProjectionPipeline;
-        const eventStore = yield* OrchestrationEventStore;
-        const { attachmentsDir } = yield* ServerConfig;
-        const now = "2026-01-01T00:00:00.000Z";
-        const projectId = ProjectId.make("project-replay");
-        const retriedThreadId = ThreadId.make("thread-replay-retried");
-        const goneThreadId = ThreadId.make("thread-replay-gone");
-        const retriedAttachmentPath = path.join(
-          attachmentsDir,
-          "thread-replay-retried-00000000-0000-4000-8000-000000000001.png",
-        );
-        const goneAttachmentPath = path.join(
-          attachmentsDir,
-          "thread-replay-gone-00000000-0000-4000-8000-000000000002.png",
-        );
-        const threadCreated = (threadId: ThreadId, suffix: string) =>
-          eventStore.append({
-            type: "thread.created",
-            eventId: EventId.make(`evt-replay-create-${suffix}`),
-            aggregateKind: "thread",
-            aggregateId: threadId,
-            occurredAt: now,
-            commandId: CommandId.make(`cmd-replay-create-${suffix}`),
-            causationEventId: null,
-            correlationId: CorrelationId.make(`cmd-replay-create-${suffix}`),
-            metadata: {},
-            payload: {
-              threadId,
-              projectId,
-              title: `Thread ${suffix}`,
-              modelSelection: {
-                instanceId: ProviderInstanceId.make("codex"),
-                model: "gpt-5-codex",
-              },
-              runtimeMode: "full-access",
-              branch: null,
-              worktreePath: null,
-              createdAt: now,
-              updatedAt: now,
-            },
-          });
-        const threadDeleted = (threadId: ThreadId, suffix: string) =>
-          eventStore.append({
-            type: "thread.deleted",
-            eventId: EventId.make(`evt-replay-delete-${suffix}`),
-            aggregateKind: "thread",
-            aggregateId: threadId,
-            occurredAt: now,
-            commandId: CommandId.make(`cmd-replay-delete-${suffix}`),
-            causationEventId: null,
-            correlationId: CorrelationId.make(`cmd-replay-delete-${suffix}`),
-            metadata: {},
-            payload: { threadId, deletedAt: now },
-          });
-
-        yield* eventStore.append({
-          type: "project.created",
-          eventId: EventId.make("evt-replay-project"),
-          aggregateKind: "project",
-          aggregateId: projectId,
-          occurredAt: now,
-          commandId: CommandId.make("cmd-replay-project"),
-          causationEventId: null,
-          correlationId: CorrelationId.make("cmd-replay-project"),
-          metadata: {},
-          payload: {
-            projectId,
-            title: "Replay",
-            workspaceRoot: "/tmp/project-replay",
-            defaultModelSelection: null,
-            scripts: [],
-            createdAt: now,
-            updatedAt: now,
-          },
-        });
-        // A failed first send: create, roll back, then the draft retries the id.
-        yield* threadCreated(retriedThreadId, "retried-1");
-        yield* threadDeleted(retriedThreadId, "retried");
-        yield* threadCreated(retriedThreadId, "retried-2");
-        // A thread that was deleted for good.
-        yield* threadCreated(goneThreadId, "gone");
-        yield* threadDeleted(goneThreadId, "gone");
-
-        // Files on disk are not event-sourced: by the time anything replays,
-        // the retried thread's attachments already belong to its second life.
-        yield* fileSystem.makeDirectory(attachmentsDir, { recursive: true });
-        yield* fileSystem.writeFileString(retriedAttachmentPath, "second incarnation");
-        yield* fileSystem.writeFileString(goneAttachmentPath, "gone");
-
-        yield* projectionPipeline.bootstrap;
-
-        assert.isTrue(yield* exists(retriedAttachmentPath));
-        assert.isFalse(yield* exists(goneAttachmentPath));
-      }),
-    );
-  },
-);
-
-it.layer(BaseTestLayer)("OrchestrationProjectionPipeline", (it) => {
-  it.effect("replays a bootstrap backlog larger than the event store default limit", () =>
-    Effect.gen(function* () {
-      const projectionPipeline = yield* OrchestrationProjectionPipeline;
-      const eventStore = yield* OrchestrationEventStore;
-      const sql = yield* SqlClient.SqlClient;
-      const now = "2026-01-01T00:00:00.000Z";
-      const projectId = ProjectId.make("project-bootstrap-backlog");
-
-      const sequenceRows = yield* sql<{ readonly maxSequence: number | null }>`
-        SELECT MAX(sequence) AS "maxSequence" FROM orchestration_events
-      `;
-      const sequenceBeforeBacklog = sequenceRows[0]?.maxSequence ?? 0;
-      const appendedEvents = yield* Effect.forEach(
-        Array.from({ length: 1_001 }, (_, index) => index),
-        (index) => {
-          const eventId = EventId.make(`evt-bootstrap-backlog-${index}`);
-          const commandId = CommandId.make(`cmd-bootstrap-backlog-${index}`);
-          return eventStore.append({
-            type: "project.created",
-            eventId,
-            aggregateKind: "project",
-            aggregateId: projectId,
-            occurredAt: now,
-            commandId,
-            causationEventId: null,
-            correlationId: CorrelationId.make(commandId),
-            metadata: {},
-            payload: {
-              projectId,
-              title: `Bootstrap backlog ${index}`,
-              workspaceRoot: "/tmp/project-bootstrap-backlog",
-              defaultModelSelection: null,
-              scripts: [],
-              createdAt: now,
-              updatedAt: now,
-            },
-          });
-        },
-      );
-      const lastSequence = appendedEvents[appendedEvents.length - 1]!.sequence;
-
-      yield* Effect.forEach(
-        Object.values(ORCHESTRATION_PROJECTOR_NAMES),
-        (projector) => {
-          const lastAppliedSequence =
-            projector === ORCHESTRATION_PROJECTOR_NAMES.projects
-              ? sequenceBeforeBacklog
-              : lastSequence;
-          return sql`
-            INSERT INTO projection_state (projector, last_applied_sequence, updated_at)
-            VALUES (${projector}, ${lastAppliedSequence}, ${now})
-            ON CONFLICT (projector)
-            DO UPDATE SET
-              last_applied_sequence = excluded.last_applied_sequence,
-              updated_at = excluded.updated_at
-          `;
-        },
-        { discard: true },
-      );
-
-      yield* projectionPipeline.bootstrap;
-
-      const stateRows = yield* sql<{ readonly lastAppliedSequence: number }>`
-        SELECT last_applied_sequence AS "lastAppliedSequence"
-        FROM projection_state
-        WHERE projector = ${ORCHESTRATION_PROJECTOR_NAMES.projects}
-      `;
-      assert.deepEqual(stateRows, [{ lastAppliedSequence: lastSequence }]);
-    }),
-  );
-
-  it.effect("resumes from projector last_applied_sequence without replaying older events", () =>
-    Effect.gen(function* () {
-      const projectionPipeline = yield* OrchestrationProjectionPipeline;
-      const eventStore = yield* OrchestrationEventStore;
-      const sql = yield* SqlClient.SqlClient;
-      const now = "2026-01-01T00:00:00.000Z";
-
-      yield* eventStore.append({
-        type: "project.created",
-        eventId: EventId.make("evt-a1"),
-        aggregateKind: "project",
-        aggregateId: ProjectId.make("project-a"),
-        occurredAt: now,
-        commandId: CommandId.make("cmd-a1"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-a1"),
-        metadata: {},
-        payload: {
-          projectId: ProjectId.make("project-a"),
-          title: "Project A",
-          workspaceRoot: "/tmp/project-a",
-          defaultModelSelection: null,
-          scripts: [],
-          createdAt: now,
-          updatedAt: now,
-        },
-      });
-
-      yield* eventStore.append({
-        type: "thread.created",
-        eventId: EventId.make("evt-a2"),
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-a"),
-        occurredAt: now,
-        commandId: CommandId.make("cmd-a2"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-a2"),
-        metadata: {},
-        payload: {
-          threadId: ThreadId.make("thread-a"),
-          projectId: ProjectId.make("project-a"),
-          title: "Thread A",
-          modelSelection: {
-            instanceId: ProviderInstanceId.make("codex"),
-            model: "gpt-5-codex",
-          },
-          runtimeMode: "full-access",
-          branch: null,
-          worktreePath: null,
-          createdAt: now,
-          updatedAt: now,
-        },
-      });
-
-      yield* eventStore.append({
-        type: "thread.message-sent",
-        eventId: EventId.make("evt-a3"),
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-a"),
-        occurredAt: now,
-        commandId: CommandId.make("cmd-a3"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-a3"),
-        metadata: {},
-        payload: {
-          threadId: ThreadId.make("thread-a"),
-          messageId: MessageId.make("message-a"),
-          role: "assistant",
-          text: "hello",
-          turnId: null,
-          streaming: false,
-          createdAt: now,
-          updatedAt: now,
-        },
-      });
-
-      yield* projectionPipeline.bootstrap;
-
-      yield* eventStore.append({
-        type: "thread.message-sent",
-        eventId: EventId.make("evt-a4"),
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-a"),
-        occurredAt: now,
-        commandId: CommandId.make("cmd-a4"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-a4"),
-        metadata: {},
-        payload: {
-          threadId: ThreadId.make("thread-a"),
-          messageId: MessageId.make("message-a"),
-          role: "assistant",
-          text: " world",
-          turnId: null,
-          streaming: true,
-          createdAt: now,
-          updatedAt: now,
-        },
-      });
-
-      yield* projectionPipeline.bootstrap;
-      yield* projectionPipeline.bootstrap;
-
-      const messageRows = yield* sql<{ readonly text: string }>`
-        SELECT text FROM projection_thread_messages WHERE message_id = 'message-a'
-      `;
-      assert.deepEqual(messageRows, [{ text: "hello world" }]);
-
-      const stateRows = yield* sql<{
-        readonly projector: string;
-        readonly lastAppliedSequence: number;
-      }>`
-        SELECT
-          projector,
-          last_applied_sequence AS "lastAppliedSequence"
-        FROM projection_state
-      `;
-      const maxSequenceRows = yield* sql<{ readonly maxSequence: number }>`
-        SELECT MAX(sequence) AS "maxSequence" FROM orchestration_events
-      `;
-      const maxSequence = maxSequenceRows[0]?.maxSequence ?? 0;
-      for (const row of stateRows) {
-        assert.equal(row.lastAppliedSequence, maxSequence);
-      }
-    }),
-  );
-
-  it.effect("keeps the turn running across interim assistant messages until the session ends", () =>
-    Effect.gen(function* () {
-      const projectionPipeline = yield* OrchestrationProjectionPipeline;
-      const eventStore = yield* OrchestrationEventStore;
-      const sql = yield* SqlClient.SqlClient;
-      const now = "2026-01-01T00:00:00.000Z";
-      const threadId = ThreadId.make("thread-turn-lifecycle");
-      const turnId = TurnId.make("turn-lifecycle-1");
-
-      yield* eventStore.append({
-        type: "thread.created",
-        eventId: EventId.make("evt-tl1"),
-        aggregateKind: "thread",
-        aggregateId: threadId,
-        occurredAt: now,
-        commandId: CommandId.make("cmd-tl1"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-tl1"),
-        metadata: {},
-        payload: {
-          threadId,
-          projectId: ProjectId.make("project-turn-lifecycle"),
-          title: "Turn lifecycle",
-          modelSelection: {
-            instanceId: ProviderInstanceId.make("claude"),
-            model: "claude-opus",
-          },
-          runtimeMode: "full-access",
-          branch: null,
-          worktreePath: null,
-          createdAt: now,
-          updatedAt: now,
-        },
-      });
-
-      yield* eventStore.append({
-        type: "thread.session-set",
-        eventId: EventId.make("evt-tl2"),
-        aggregateKind: "thread",
-        aggregateId: threadId,
-        occurredAt: "2026-01-01T00:00:01.000Z",
-        commandId: CommandId.make("cmd-tl2"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-tl2"),
-        metadata: {},
-        payload: {
-          threadId,
-          session: {
-            threadId,
-            status: "running",
-            providerName: "claude",
-            runtimeMode: "full-access",
-            activeTurnId: turnId,
-            lastError: null,
-            updatedAt: "2026-01-01T00:00:01.000Z",
-          },
-        },
-      });
-
-      // Interim assistant message completes mid-turn (commentary between
-      // tool calls) — the turn must stay running and unsettled.
-      yield* eventStore.append({
-        type: "thread.message-sent",
-        eventId: EventId.make("evt-tl3"),
-        aggregateKind: "thread",
-        aggregateId: threadId,
-        occurredAt: "2026-01-01T00:00:05.000Z",
-        commandId: CommandId.make("cmd-tl3"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-tl3"),
-        metadata: {},
-        payload: {
-          threadId,
-          messageId: MessageId.make("message-tl-interim"),
-          role: "assistant",
-          text: "interim commentary",
-          turnId,
-          streaming: false,
-          createdAt: "2026-01-01T00:00:05.000Z",
-          updatedAt: "2026-01-01T00:00:05.000Z",
-        },
-      });
-
-      yield* projectionPipeline.bootstrap;
-
-      const runningRows = yield* sql<{
-        readonly state: string;
-        readonly completedAt: string | null;
-      }>`
-        SELECT state, completed_at AS "completedAt"
-        FROM projection_turns
-        WHERE thread_id = ${threadId} AND turn_id = ${turnId}
-      `;
-      assert.deepEqual(runningRows, [{ state: "running", completedAt: null }]);
-
-      // The session leaving "running" is the turn-end signal.
-      yield* eventStore.append({
-        type: "thread.session-set",
-        eventId: EventId.make("evt-tl4"),
-        aggregateKind: "thread",
-        aggregateId: threadId,
-        occurredAt: "2026-01-01T00:01:00.000Z",
-        commandId: CommandId.make("cmd-tl4"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-tl4"),
-        metadata: {},
-        payload: {
-          threadId,
-          session: {
-            threadId,
-            status: "ready",
-            providerName: "claude",
-            runtimeMode: "full-access",
-            activeTurnId: null,
-            lastError: null,
-            updatedAt: "2026-01-01T00:01:00.000Z",
-          },
-        },
-      });
-
-      yield* projectionPipeline.bootstrap;
-
-      const settledRows = yield* sql<{
-        readonly state: string;
-        readonly completedAt: string | null;
-      }>`
-        SELECT state, completed_at AS "completedAt"
-        FROM projection_turns
-        WHERE thread_id = ${threadId} AND turn_id = ${turnId}
-      `;
-      assert.deepEqual(settledRows, [
-        { state: "completed", completedAt: "2026-01-01T00:01:00.000Z" },
-      ]);
-
-      const threadRows = yield* sql<{ readonly latestTurnId: string | null }>`
-        SELECT latest_turn_id AS "latestTurnId"
-        FROM projection_threads
-        WHERE thread_id = ${threadId}
-      `;
-      assert.deepEqual(threadRows, [{ latestTurnId: turnId }]);
-    }),
-  );
-
-  it.effect("settles a superseded running turn when a new turn becomes active", () =>
-    Effect.gen(function* () {
-      const projectionPipeline = yield* OrchestrationProjectionPipeline;
-      const eventStore = yield* OrchestrationEventStore;
-      const sql = yield* SqlClient.SqlClient;
-      const now = "2026-01-01T00:00:00.000Z";
-      const threadId = ThreadId.make("thread-turn-supersede");
-      const oldTurnId = TurnId.make("turn-superseded");
-      const newTurnId = TurnId.make("turn-steer");
-
-      yield* eventStore.append({
-        type: "thread.created",
-        eventId: EventId.make("evt-ts1"),
-        aggregateKind: "thread",
-        aggregateId: threadId,
-        occurredAt: now,
-        commandId: CommandId.make("cmd-ts1"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-ts1"),
-        metadata: {},
-        payload: {
-          threadId,
-          projectId: ProjectId.make("project-turn-supersede"),
-          title: "Turn supersede",
-          modelSelection: {
-            instanceId: ProviderInstanceId.make("opencode"),
-            model: "big-pickle",
-          },
-          runtimeMode: "full-access",
-          branch: null,
-          worktreePath: null,
-          createdAt: now,
-          updatedAt: now,
-        },
-      });
-
-      const appendRunningSessionSet = (eventId: string, turnId: TurnId, updatedAt: string) =>
-        eventStore.append({
-          type: "thread.session-set",
-          eventId: EventId.make(eventId),
-          aggregateKind: "thread",
-          aggregateId: threadId,
-          occurredAt: updatedAt,
-          commandId: CommandId.make(`cmd-${eventId}`),
-          causationEventId: null,
-          correlationId: CorrelationId.make(`cmd-${eventId}`),
-          metadata: {},
-          payload: {
-            threadId,
-            session: {
-              threadId,
-              status: "running",
-              providerName: "opencode",
-              runtimeMode: "full-access",
-              activeTurnId: turnId,
-              lastError: null,
-              updatedAt,
-            },
-          },
-        });
-
-      yield* appendRunningSessionSet("evt-ts2", oldTurnId, "2026-01-01T00:00:01.000Z");
-      // A steer: a new turn becomes active without the provider ever
-      // completing the previous one.
-      yield* appendRunningSessionSet("evt-ts3", newTurnId, "2026-01-01T00:00:30.000Z");
-
-      yield* projectionPipeline.bootstrap;
-
-      const rows = yield* sql<{
-        readonly turnId: string;
-        readonly state: string;
-        readonly completedAt: string | null;
-      }>`
-        SELECT turn_id AS "turnId", state, completed_at AS "completedAt"
-        FROM projection_turns
-        WHERE thread_id = ${threadId}
-        ORDER BY requested_at
-      `;
-      assert.deepEqual(rows, [
-        { turnId: oldTurnId, state: "completed", completedAt: "2026-01-01T00:00:30.000Z" },
-        { turnId: newTurnId, state: "running", completedAt: null },
-      ]);
-    }),
-  );
-
-  it.effect("keeps accumulated assistant text when completion payload text is empty", () =>
-    Effect.gen(function* () {
-      const projectionPipeline = yield* OrchestrationProjectionPipeline;
-      const eventStore = yield* OrchestrationEventStore;
-      const sql = yield* SqlClient.SqlClient;
-      const now = "2026-01-01T00:00:00.000Z";
-
-      yield* eventStore.append({
-        type: "project.created",
-        eventId: EventId.make("evt-empty-1"),
-        aggregateKind: "project",
-        aggregateId: ProjectId.make("project-empty"),
-        occurredAt: now,
-        commandId: CommandId.make("cmd-empty-1"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-empty-1"),
-        metadata: {},
-        payload: {
-          projectId: ProjectId.make("project-empty"),
-          title: "Project Empty",
-          workspaceRoot: "/tmp/project-empty",
-          defaultModelSelection: null,
-          scripts: [],
-          createdAt: now,
-          updatedAt: now,
-        },
-      });
-
-      yield* eventStore.append({
-        type: "thread.created",
-        eventId: EventId.make("evt-empty-2"),
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-empty"),
-        occurredAt: now,
-        commandId: CommandId.make("cmd-empty-2"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-empty-2"),
-        metadata: {},
-        payload: {
-          threadId: ThreadId.make("thread-empty"),
-          projectId: ProjectId.make("project-empty"),
-          title: "Thread Empty",
-          modelSelection: {
-            instanceId: ProviderInstanceId.make("codex"),
-            model: "gpt-5-codex",
-          },
-          runtimeMode: "full-access",
-          branch: null,
-          worktreePath: null,
-          createdAt: now,
-          updatedAt: now,
-        },
-      });
-
-      yield* eventStore.append({
-        type: "thread.message-sent",
-        eventId: EventId.make("evt-empty-3"),
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-empty"),
-        occurredAt: now,
-        commandId: CommandId.make("cmd-empty-3"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-empty-3"),
-        metadata: {},
-        payload: {
-          threadId: ThreadId.make("thread-empty"),
-          messageId: MessageId.make("assistant-empty"),
-          role: "assistant",
-          text: "Hello",
-          turnId: null,
-          streaming: true,
-          createdAt: now,
-          updatedAt: now,
-        },
-      });
-
-      yield* eventStore.append({
-        type: "thread.message-sent",
-        eventId: EventId.make("evt-empty-4"),
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-empty"),
-        occurredAt: now,
-        commandId: CommandId.make("cmd-empty-4"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-empty-4"),
-        metadata: {},
-        payload: {
-          threadId: ThreadId.make("thread-empty"),
-          messageId: MessageId.make("assistant-empty"),
-          role: "assistant",
-          text: " world",
-          turnId: null,
-          streaming: true,
-          createdAt: now,
-          updatedAt: now,
-        },
-      });
-
-      yield* eventStore.append({
-        type: "thread.message-sent",
-        eventId: EventId.make("evt-empty-5"),
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-empty"),
-        occurredAt: now,
-        commandId: CommandId.make("cmd-empty-5"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-empty-5"),
-        metadata: {},
-        payload: {
-          threadId: ThreadId.make("thread-empty"),
-          messageId: MessageId.make("assistant-empty"),
-          role: "assistant",
-          text: "",
-          turnId: null,
-          streaming: false,
-          createdAt: now,
-          updatedAt: now,
-        },
-      });
-
-      yield* projectionPipeline.bootstrap;
-
-      const messageRows = yield* sql<{ readonly text: string; readonly isStreaming: unknown }>`
-        SELECT
-          text,
-          is_streaming AS "isStreaming"
-        FROM projection_thread_messages
-        WHERE message_id = 'assistant-empty'
-      `;
-      assert.equal(messageRows.length, 1);
-      assert.equal(messageRows[0]?.text, "Hello world");
-      assert.isFalse(Boolean(messageRows[0]?.isStreaming));
-    }),
-  );
-
-  it.effect(
-    "resolves turn-count conflicts when checkpoint completion rewrites provisional turns",
-    () =>
-      Effect.gen(function* () {
-        const projectionPipeline = yield* OrchestrationProjectionPipeline;
-        const eventStore = yield* OrchestrationEventStore;
-        const sql = yield* SqlClient.SqlClient;
-        const appendAndProject = (event: Parameters<typeof eventStore.append>[0]) =>
-          eventStore
-            .append(event)
-            .pipe(Effect.flatMap((savedEvent) => projectionPipeline.projectEvent(savedEvent)));
-
-        yield* appendAndProject({
-          type: "project.created",
-          eventId: EventId.make("evt-conflict-1"),
-          aggregateKind: "project",
-          aggregateId: ProjectId.make("project-conflict"),
-          occurredAt: "2026-02-26T13:00:00.000Z",
-          commandId: CommandId.make("cmd-conflict-1"),
-          causationEventId: null,
-          correlationId: CorrelationId.make("cmd-conflict-1"),
-          metadata: {},
-          payload: {
-            projectId: ProjectId.make("project-conflict"),
-            title: "Project Conflict",
-            workspaceRoot: "/tmp/project-conflict",
-            defaultModelSelection: null,
-            scripts: [],
-            createdAt: "2026-02-26T13:00:00.000Z",
-            updatedAt: "2026-02-26T13:00:00.000Z",
-          },
-        });
-
-        yield* appendAndProject({
-          type: "thread.created",
-          eventId: EventId.make("evt-conflict-2"),
-          aggregateKind: "thread",
-          aggregateId: ThreadId.make("thread-conflict"),
-          occurredAt: "2026-02-26T13:00:01.000Z",
-          commandId: CommandId.make("cmd-conflict-2"),
-          causationEventId: null,
-          correlationId: CorrelationId.make("cmd-conflict-2"),
-          metadata: {},
-          payload: {
-            threadId: ThreadId.make("thread-conflict"),
-            projectId: ProjectId.make("project-conflict"),
-            title: "Thread Conflict",
-            modelSelection: {
-              instanceId: ProviderInstanceId.make("codex"),
-              model: "gpt-5-codex",
-            },
-            runtimeMode: "full-access",
-            branch: null,
-            worktreePath: null,
-            createdAt: "2026-02-26T13:00:01.000Z",
-            updatedAt: "2026-02-26T13:00:01.000Z",
-          },
-        });
-
-        yield* appendAndProject({
-          type: "thread.turn-interrupt-requested",
-          eventId: EventId.make("evt-conflict-3"),
-          aggregateKind: "thread",
-          aggregateId: ThreadId.make("thread-conflict"),
-          occurredAt: "2026-02-26T13:00:02.000Z",
-          commandId: CommandId.make("cmd-conflict-3"),
-          causationEventId: null,
-          correlationId: CorrelationId.make("cmd-conflict-3"),
-          metadata: {},
-          payload: {
-            threadId: ThreadId.make("thread-conflict"),
-            turnId: TurnId.make("turn-interrupted"),
-            createdAt: "2026-02-26T13:00:02.000Z",
-          },
-        });
-
-        yield* appendAndProject({
-          type: "thread.message-sent",
-          eventId: EventId.make("evt-conflict-4"),
-          aggregateKind: "thread",
-          aggregateId: ThreadId.make("thread-conflict"),
-          occurredAt: "2026-02-26T13:00:03.000Z",
-          commandId: CommandId.make("cmd-conflict-4"),
-          causationEventId: null,
-          correlationId: CorrelationId.make("cmd-conflict-4"),
-          metadata: {},
-          payload: {
-            threadId: ThreadId.make("thread-conflict"),
-            messageId: MessageId.make("assistant-conflict"),
-            role: "assistant",
-            text: "done",
-            turnId: TurnId.make("turn-completed"),
-            streaming: false,
-            createdAt: "2026-02-26T13:00:03.000Z",
-            updatedAt: "2026-02-26T13:00:03.000Z",
-          },
-        });
-
-        yield* appendAndProject({
-          type: "thread.turn-diff-completed",
-          eventId: EventId.make("evt-conflict-5"),
-          aggregateKind: "thread",
-          aggregateId: ThreadId.make("thread-conflict"),
-          occurredAt: "2026-02-26T13:00:04.000Z",
-          commandId: CommandId.make("cmd-conflict-5"),
-          causationEventId: null,
-          correlationId: CorrelationId.make("cmd-conflict-5"),
-          metadata: {},
-          payload: {
-            threadId: ThreadId.make("thread-conflict"),
-            turnId: TurnId.make("turn-completed"),
-            checkpointTurnCount: 1,
-            checkpointRef: CheckpointRef.make("refs/t3/checkpoints/thread-conflict/turn/1"),
-            status: "ready",
-            files: [],
-            assistantMessageId: MessageId.make("assistant-conflict"),
-            completedAt: "2026-02-26T13:00:04.000Z",
-          },
-        });
-
-        const turnRows = yield* sql<{
-          readonly turnId: string;
-          readonly checkpointTurnCount: number | null;
-          readonly status: string;
-        }>`
-        SELECT
-          turn_id AS "turnId",
-          checkpoint_turn_count AS "checkpointTurnCount",
-          state AS "status"
-        FROM projection_turns
-        WHERE thread_id = 'thread-conflict'
-        ORDER BY
-          CASE
-            WHEN checkpoint_turn_count IS NULL THEN 1
-            ELSE 0
-          END ASC,
-          checkpoint_turn_count ASC,
-          requested_at ASC
-      `;
-        assert.deepEqual(turnRows, [
-          { turnId: "turn-completed", checkpointTurnCount: 1, status: "completed" },
-          { turnId: "turn-interrupted", checkpointTurnCount: null, status: "interrupted" },
-        ]);
-      }),
-  );
-
-  it.effect("clears stale pending approvals from projected shell summaries", () =>
-    Effect.gen(function* () {
-      const projectionPipeline = yield* OrchestrationProjectionPipeline;
-      const eventStore = yield* OrchestrationEventStore;
-      const sql = yield* SqlClient.SqlClient;
-      const appendAndProject = (event: Parameters<typeof eventStore.append>[0]) =>
-        eventStore
-          .append(event)
-          .pipe(Effect.flatMap((savedEvent) => projectionPipeline.projectEvent(savedEvent)));
-
-      yield* appendAndProject({
-        type: "project.created",
-        eventId: EventId.make("evt-stale-approval-1"),
-        aggregateKind: "project",
-        aggregateId: ProjectId.make("project-stale-approval"),
-        occurredAt: "2026-02-26T12:30:00.000Z",
-        commandId: CommandId.make("cmd-stale-approval-1"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-stale-approval-1"),
-        metadata: {},
-        payload: {
-          projectId: ProjectId.make("project-stale-approval"),
-          title: "Project Stale Approval",
-          workspaceRoot: "/tmp/project-stale-approval",
-          defaultModelSelection: null,
-          scripts: [],
-          createdAt: "2026-02-26T12:30:00.000Z",
-          updatedAt: "2026-02-26T12:30:00.000Z",
-        },
-      });
-
-      yield* appendAndProject({
-        type: "thread.created",
-        eventId: EventId.make("evt-stale-approval-2"),
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-stale-approval"),
-        occurredAt: "2026-02-26T12:30:01.000Z",
-        commandId: CommandId.make("cmd-stale-approval-2"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-stale-approval-2"),
-        metadata: {},
-        payload: {
-          threadId: ThreadId.make("thread-stale-approval"),
-          projectId: ProjectId.make("project-stale-approval"),
-          title: "Thread Stale Approval",
-          modelSelection: {
-            instanceId: ProviderInstanceId.make("codex"),
-            model: "gpt-5-codex",
-          },
-          runtimeMode: "approval-required",
-          interactionMode: "default",
-          branch: null,
-          worktreePath: null,
-          createdAt: "2026-02-26T12:30:01.000Z",
-          updatedAt: "2026-02-26T12:30:01.000Z",
-        },
-      });
-
-      yield* appendAndProject({
-        type: "thread.activity-appended",
-        eventId: EventId.make("evt-stale-approval-3"),
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-stale-approval"),
-        occurredAt: "2026-02-26T12:30:02.000Z",
-        commandId: CommandId.make("cmd-stale-approval-3"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-stale-approval-3"),
-        metadata: {},
-        payload: {
-          threadId: ThreadId.make("thread-stale-approval"),
-          activity: {
-            id: EventId.make("activity-stale-approval-requested"),
-            tone: "approval",
-            kind: "approval.requested",
-            summary: "Command approval requested",
-            payload: {
-              requestId: "approval-request-stale-1",
-              requestKind: "command",
-            },
-            turnId: null,
-            createdAt: "2026-02-26T12:30:02.000Z",
-          },
-        },
-      });
-
-      yield* appendAndProject({
-        type: "thread.activity-appended",
-        eventId: EventId.make("evt-stale-approval-4"),
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-stale-approval"),
-        occurredAt: "2026-02-26T12:30:03.000Z",
-        commandId: CommandId.make("cmd-stale-approval-4"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-stale-approval-4"),
-        metadata: {},
-        payload: {
-          threadId: ThreadId.make("thread-stale-approval"),
-          activity: {
-            id: EventId.make("activity-stale-approval-failed"),
-            tone: "error",
-            kind: "provider.approval.respond.failed",
-            summary: "Provider approval response failed",
-            payload: {
-              requestId: "approval-request-stale-1",
-              detail: "Unknown pending permission request: approval-request-stale-1",
-            },
-            turnId: null,
-            createdAt: "2026-02-26T12:30:03.000Z",
-          },
-        },
-      });
-
-      const approvalRows = yield* sql<{
-        readonly requestId: string;
-        readonly status: string;
-        readonly resolvedAt: string | null;
-      }>`
-        SELECT
-          request_id AS "requestId",
-          status,
-          resolved_at AS "resolvedAt"
-        FROM projection_pending_approvals
-        WHERE request_id = 'approval-request-stale-1'
-      `;
-      assert.deepEqual(approvalRows, [
-        {
-          requestId: "approval-request-stale-1",
-          status: "resolved",
-          resolvedAt: "2026-02-26T12:30:03.000Z",
-        },
-      ]);
-
-      const threadRows = yield* sql<{
-        readonly pendingApprovalCount: number;
-      }>`
-        SELECT pending_approval_count AS "pendingApprovalCount"
-        FROM projection_threads
-        WHERE thread_id = 'thread-stale-approval'
-      `;
-      assert.deepEqual(threadRows, [{ pendingApprovalCount: 0 }]);
-    }),
-  );
-
-  it.effect("clears stale pending user input from projected shell summaries", () =>
-    Effect.gen(function* () {
-      const projectionPipeline = yield* OrchestrationProjectionPipeline;
-      const eventStore = yield* OrchestrationEventStore;
-      const sql = yield* SqlClient.SqlClient;
-      const appendAndProject = (event: Parameters<typeof eventStore.append>[0]) =>
-        eventStore
-          .append(event)
-          .pipe(Effect.flatMap((savedEvent) => projectionPipeline.projectEvent(savedEvent)));
-
-      yield* appendAndProject({
-        type: "project.created",
-        eventId: EventId.make("evt-stale-user-input-1"),
-        aggregateKind: "project",
-        aggregateId: ProjectId.make("project-stale-user-input"),
-        occurredAt: "2026-02-26T12:35:00.000Z",
-        commandId: CommandId.make("cmd-stale-user-input-1"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-stale-user-input-1"),
-        metadata: {},
-        payload: {
-          projectId: ProjectId.make("project-stale-user-input"),
-          title: "Project Stale User Input",
-          workspaceRoot: "/tmp/project-stale-user-input",
-          defaultModelSelection: null,
-          scripts: [],
-          createdAt: "2026-02-26T12:35:00.000Z",
-          updatedAt: "2026-02-26T12:35:00.000Z",
-        },
-      });
-
-      yield* appendAndProject({
-        type: "thread.created",
-        eventId: EventId.make("evt-stale-user-input-2"),
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-stale-user-input"),
-        occurredAt: "2026-02-26T12:35:01.000Z",
-        commandId: CommandId.make("cmd-stale-user-input-2"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-stale-user-input-2"),
-        metadata: {},
-        payload: {
-          threadId: ThreadId.make("thread-stale-user-input"),
-          projectId: ProjectId.make("project-stale-user-input"),
-          title: "Thread Stale User Input",
-          modelSelection: {
-            instanceId: ProviderInstanceId.make("codex"),
-            model: "gpt-5-codex",
-          },
-          runtimeMode: "approval-required",
-          interactionMode: "default",
-          branch: null,
-          worktreePath: null,
-          createdAt: "2026-02-26T12:35:01.000Z",
-          updatedAt: "2026-02-26T12:35:01.000Z",
-        },
-      });
-
-      yield* appendAndProject({
-        type: "thread.activity-appended",
-        eventId: EventId.make("evt-stale-user-input-3"),
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-stale-user-input"),
-        occurredAt: "2026-02-26T12:35:02.000Z",
-        commandId: CommandId.make("cmd-stale-user-input-3"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-stale-user-input-3"),
-        metadata: {},
-        payload: {
-          threadId: ThreadId.make("thread-stale-user-input"),
-          activity: {
-            id: EventId.make("activity-stale-user-input-requested"),
-            tone: "info",
-            kind: "user-input.requested",
-            summary: "User input requested",
-            payload: {
-              requestId: "user-input-request-stale-1",
-              questions: [
-                {
-                  id: "sandbox_mode",
-                  header: "Sandbox",
-                  question: "Which mode should be used?",
-                  options: [
-                    {
-                      label: "workspace-write",
-                      description: "Allow workspace writes only",
-                    },
-                  ],
-                },
-              ],
-            },
-            turnId: null,
-            createdAt: "2026-02-26T12:35:02.000Z",
-          },
-        },
-      });
-
-      yield* appendAndProject({
-        type: "thread.activity-appended",
-        eventId: EventId.make("evt-stale-user-input-4"),
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-stale-user-input"),
-        occurredAt: "2026-02-26T12:35:03.000Z",
-        commandId: CommandId.make("cmd-stale-user-input-4"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-stale-user-input-4"),
-        metadata: {},
-        payload: {
-          threadId: ThreadId.make("thread-stale-user-input"),
-          activity: {
-            id: EventId.make("activity-stale-user-input-failed"),
-            tone: "error",
-            kind: "provider.user-input.respond.failed",
-            summary: "Provider user input response failed",
-            payload: {
-              requestId: "user-input-request-stale-1",
-              detail:
-                "Provider adapter request failed (codex) for item/tool/requestUserInput: Unknown pending Codex user input request: user-input-request-stale-1",
-            },
-            turnId: null,
-            createdAt: "2026-02-26T12:35:03.000Z",
-          },
-        },
-      });
-
-      const threadRows = yield* sql<{
-        readonly pendingUserInputCount: number;
-      }>`
-        SELECT pending_user_input_count AS "pendingUserInputCount"
-        FROM projection_threads
-        WHERE thread_id = 'thread-stale-user-input'
-      `;
-      assert.deepEqual(threadRows, [{ pendingUserInputCount: 0 }]);
-    }),
-  );
-
-  it.effect("ignores non-stale provider approval response failures", () =>
-    Effect.gen(function* () {
-      const projectionPipeline = yield* OrchestrationProjectionPipeline;
-      const eventStore = yield* OrchestrationEventStore;
-      const sql = yield* SqlClient.SqlClient;
-      const appendAndProject = (event: Parameters<typeof eventStore.append>[0]) =>
-        eventStore
-          .append(event)
-          .pipe(Effect.flatMap((savedEvent) => projectionPipeline.projectEvent(savedEvent)));
-
-      yield* appendAndProject({
-        type: "project.created",
-        eventId: EventId.make("evt-nonstale-approval-1"),
-        aggregateKind: "project",
-        aggregateId: ProjectId.make("project-nonstale-approval"),
-        occurredAt: "2026-02-26T12:45:00.000Z",
-        commandId: CommandId.make("cmd-nonstale-approval-1"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-nonstale-approval-1"),
-        metadata: {},
-        payload: {
-          projectId: ProjectId.make("project-nonstale-approval"),
-          title: "Project Non-Stale Approval",
-          workspaceRoot: "/tmp/project-nonstale-approval",
-          defaultModelSelection: null,
-          scripts: [],
-          createdAt: "2026-02-26T12:45:00.000Z",
-          updatedAt: "2026-02-26T12:45:00.000Z",
-        },
-      });
-
-      yield* appendAndProject({
-        type: "thread.created",
-        eventId: EventId.make("evt-nonstale-approval-2"),
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-nonstale-approval"),
-        occurredAt: "2026-02-26T12:45:01.000Z",
-        commandId: CommandId.make("cmd-nonstale-approval-2"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-nonstale-approval-2"),
-        metadata: {},
-        payload: {
-          threadId: ThreadId.make("thread-nonstale-approval"),
-          projectId: ProjectId.make("project-nonstale-approval"),
-          title: "Thread Non-Stale Approval",
-          modelSelection: {
-            instanceId: ProviderInstanceId.make("codex"),
-            model: "gpt-5-codex",
-          },
-          runtimeMode: "approval-required",
-          interactionMode: "default",
-          branch: null,
-          worktreePath: null,
-          createdAt: "2026-02-26T12:45:01.000Z",
-          updatedAt: "2026-02-26T12:45:01.000Z",
-        },
-      });
-
-      yield* appendAndProject({
-        type: "thread.activity-appended",
-        eventId: EventId.make("evt-nonstale-approval-3"),
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-nonstale-approval"),
-        occurredAt: "2026-02-26T12:45:02.000Z",
-        commandId: CommandId.make("cmd-nonstale-approval-3"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-nonstale-approval-3"),
-        metadata: {},
-        payload: {
-          threadId: ThreadId.make("thread-nonstale-approval"),
-          activity: {
-            id: EventId.make("activity-nonstale-approval-requested"),
-            tone: "approval",
-            kind: "approval.requested",
-            summary: "Command approval requested",
-            payload: {
-              requestId: "approval-request-nonstale-existing",
-              requestKind: "command",
-            },
-            turnId: null,
-            createdAt: "2026-02-26T12:45:02.000Z",
-          },
-        },
-      });
-
-      yield* appendAndProject({
-        type: "thread.activity-appended",
-        eventId: EventId.make("evt-nonstale-approval-4"),
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-nonstale-approval"),
-        occurredAt: "2026-02-26T12:45:03.000Z",
-        commandId: CommandId.make("cmd-nonstale-approval-4"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-nonstale-approval-4"),
-        metadata: {},
-        payload: {
-          threadId: ThreadId.make("thread-nonstale-approval"),
-          activity: {
-            id: EventId.make("activity-nonstale-approval-failed-existing"),
-            tone: "error",
-            kind: "provider.approval.respond.failed",
-            summary: "Provider approval response failed",
-            payload: {
-              requestId: "approval-request-nonstale-existing",
-              detail: "Provider timed out while responding to approval request",
-            },
-            turnId: TurnId.make("turn-nonstale-failure"),
-            createdAt: "2026-02-26T12:45:03.000Z",
-          },
-        },
-      });
-
-      yield* appendAndProject({
-        type: "thread.activity-appended",
-        eventId: EventId.make("evt-nonstale-approval-5"),
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-nonstale-approval"),
-        occurredAt: "2026-02-26T12:45:04.000Z",
-        commandId: CommandId.make("cmd-nonstale-approval-5"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-nonstale-approval-5"),
-        metadata: {},
-        payload: {
-          threadId: ThreadId.make("thread-nonstale-approval"),
-          activity: {
-            id: EventId.make("activity-nonstale-approval-failed-missing"),
-            tone: "error",
-            kind: "provider.approval.respond.failed",
-            summary: "Provider approval response failed",
-            payload: {
-              requestId: "approval-request-nonstale-missing",
-              detail: "Provider timed out while responding to approval request",
-            },
-            turnId: null,
-            createdAt: "2026-02-26T12:45:04.000Z",
-          },
-        },
-      });
-
-      const approvalRows = yield* sql<{
-        readonly requestId: string;
-        readonly status: string;
-        readonly turnId: string | null;
-        readonly createdAt: string;
-        readonly resolvedAt: string | null;
-      }>`
-        SELECT
-          request_id AS "requestId",
-          status,
-          turn_id AS "turnId",
-          created_at AS "createdAt",
-          resolved_at AS "resolvedAt"
-        FROM projection_pending_approvals
-        WHERE request_id IN (
-          'approval-request-nonstale-existing',
-          'approval-request-nonstale-missing'
-        )
-        ORDER BY request_id
-      `;
-      assert.deepEqual(approvalRows, [
-        {
-          requestId: "approval-request-nonstale-existing",
-          status: "pending",
-          turnId: null,
-          createdAt: "2026-02-26T12:45:02.000Z",
-          resolvedAt: null,
-        },
-      ]);
-
-      const threadRows = yield* sql<{
-        readonly pendingApprovalCount: number;
-      }>`
-        SELECT pending_approval_count AS "pendingApprovalCount"
-        FROM projection_threads
-        WHERE thread_id = 'thread-nonstale-approval'
-      `;
-      assert.deepEqual(threadRows, [{ pendingApprovalCount: 1 }]);
-    }),
-  );
-
-  it.effect("does not fallback-retain messages whose turnId is removed by revert", () =>
-    Effect.gen(function* () {
-      const projectionPipeline = yield* OrchestrationProjectionPipeline;
-      const eventStore = yield* OrchestrationEventStore;
-      const sql = yield* SqlClient.SqlClient;
-      const appendAndProject = (event: Parameters<typeof eventStore.append>[0]) =>
-        eventStore
-          .append(event)
-          .pipe(Effect.flatMap((savedEvent) => projectionPipeline.projectEvent(savedEvent)));
-
-      yield* appendAndProject({
-        type: "project.created",
-        eventId: EventId.make("evt-revert-1"),
-        aggregateKind: "project",
-        aggregateId: ProjectId.make("project-revert"),
-        occurredAt: "2026-02-26T12:00:00.000Z",
-        commandId: CommandId.make("cmd-revert-1"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-revert-1"),
-        metadata: {},
-        payload: {
-          projectId: ProjectId.make("project-revert"),
-          title: "Project Revert",
-          workspaceRoot: "/tmp/project-revert",
-          defaultModelSelection: null,
-          scripts: [],
-          createdAt: "2026-02-26T12:00:00.000Z",
-          updatedAt: "2026-02-26T12:00:00.000Z",
-        },
-      });
-
-      yield* appendAndProject({
-        type: "thread.created",
-        eventId: EventId.make("evt-revert-2"),
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-revert"),
-        occurredAt: "2026-02-26T12:00:01.000Z",
-        commandId: CommandId.make("cmd-revert-2"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-revert-2"),
-        metadata: {},
-        payload: {
-          threadId: ThreadId.make("thread-revert"),
-          projectId: ProjectId.make("project-revert"),
-          title: "Thread Revert",
-          modelSelection: {
-            instanceId: ProviderInstanceId.make("codex"),
-            model: "gpt-5-codex",
-          },
-          runtimeMode: "full-access",
-          branch: null,
-          worktreePath: null,
-          createdAt: "2026-02-26T12:00:01.000Z",
-          updatedAt: "2026-02-26T12:00:01.000Z",
-        },
-      });
-
-      yield* appendAndProject({
-        type: "thread.turn-diff-completed",
-        eventId: EventId.make("evt-revert-3"),
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-revert"),
-        occurredAt: "2026-02-26T12:00:02.000Z",
-        commandId: CommandId.make("cmd-revert-3"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-revert-3"),
-        metadata: {},
-        payload: {
-          threadId: ThreadId.make("thread-revert"),
-          turnId: TurnId.make("turn-1"),
-          checkpointTurnCount: 1,
-          checkpointRef: CheckpointRef.make("refs/t3/checkpoints/thread-revert/turn/1"),
-          status: "ready",
-          files: [],
-          assistantMessageId: MessageId.make("assistant-keep"),
-          completedAt: "2026-02-26T12:00:02.000Z",
-        },
-      });
-
-      yield* appendAndProject({
-        type: "thread.message-sent",
-        eventId: EventId.make("evt-revert-4"),
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-revert"),
-        occurredAt: "2026-02-26T12:00:02.100Z",
-        commandId: CommandId.make("cmd-revert-4"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-revert-4"),
-        metadata: {},
-        payload: {
-          threadId: ThreadId.make("thread-revert"),
-          messageId: MessageId.make("assistant-keep"),
-          role: "assistant",
-          text: "kept",
-          turnId: TurnId.make("turn-1"),
-          streaming: false,
-          createdAt: "2026-02-26T12:00:02.100Z",
-          updatedAt: "2026-02-26T12:00:02.100Z",
-        },
-      });
-
-      yield* appendAndProject({
-        type: "thread.turn-diff-completed",
-        eventId: EventId.make("evt-revert-5"),
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-revert"),
-        occurredAt: "2026-02-26T12:00:03.000Z",
-        commandId: CommandId.make("cmd-revert-5"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-revert-5"),
-        metadata: {},
-        payload: {
-          threadId: ThreadId.make("thread-revert"),
-          turnId: TurnId.make("turn-2"),
-          checkpointTurnCount: 2,
-          checkpointRef: CheckpointRef.make("refs/t3/checkpoints/thread-revert/turn/2"),
-          status: "ready",
-          files: [],
-          assistantMessageId: MessageId.make("assistant-remove"),
-          completedAt: "2026-02-26T12:00:03.000Z",
-        },
-      });
-
-      yield* appendAndProject({
-        type: "thread.message-sent",
-        eventId: EventId.make("evt-revert-6"),
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-revert"),
-        occurredAt: "2026-02-26T12:00:03.050Z",
-        commandId: CommandId.make("cmd-revert-6"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-revert-6"),
-        metadata: {},
-        payload: {
-          threadId: ThreadId.make("thread-revert"),
-          messageId: MessageId.make("user-remove"),
-          role: "user",
-          text: "removed",
-          turnId: TurnId.make("turn-2"),
-          streaming: false,
-          createdAt: "2026-02-26T12:00:03.050Z",
-          updatedAt: "2026-02-26T12:00:03.050Z",
-        },
-      });
-
-      yield* appendAndProject({
-        type: "thread.message-sent",
-        eventId: EventId.make("evt-revert-7"),
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-revert"),
-        occurredAt: "2026-02-26T12:00:03.100Z",
-        commandId: CommandId.make("cmd-revert-7"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-revert-7"),
-        metadata: {},
-        payload: {
-          threadId: ThreadId.make("thread-revert"),
-          messageId: MessageId.make("assistant-remove"),
-          role: "assistant",
-          text: "removed",
-          turnId: TurnId.make("turn-2"),
-          streaming: false,
-          createdAt: "2026-02-26T12:00:03.100Z",
-          updatedAt: "2026-02-26T12:00:03.100Z",
-        },
-      });
-
-      yield* appendAndProject({
-        type: "thread.reverted",
-        eventId: EventId.make("evt-revert-8"),
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-revert"),
-        occurredAt: "2026-02-26T12:00:04.000Z",
-        commandId: CommandId.make("cmd-revert-8"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-revert-8"),
-        metadata: {},
-        payload: {
-          threadId: ThreadId.make("thread-revert"),
-          turnCount: 1,
-        },
-      });
-
-      const messageRows = yield* sql<{
-        readonly messageId: string;
-        readonly turnId: string | null;
-        readonly role: string;
-      }>`
-        SELECT
-          message_id AS "messageId",
-          turn_id AS "turnId",
-          role
-        FROM projection_thread_messages
-        WHERE thread_id = 'thread-revert'
-        ORDER BY created_at ASC, message_id ASC
-      `;
-      assert.deepEqual(messageRows, [
-        {
-          messageId: "assistant-keep",
-          turnId: "turn-1",
-          role: "assistant",
-        },
-      ]);
-    }),
-  );
-});
-
-it.layer(makeProjectionPipelinePrefixedTestLayer("t3-pending-turn-terminal-test-"))(
-  "OrchestrationProjectionPipeline pending turn cleanup",
-  (it) => {
-    it.effect("clears pending turn starts when startup reaches a terminal session state", () =>
-      Effect.gen(function* () {
-        const projectionPipeline = yield* OrchestrationProjectionPipeline;
-        const eventStore = yield* OrchestrationEventStore;
-        const sql = yield* SqlClient.SqlClient;
-
-        for (const [index, status] of (["error", "interrupted", "stopped"] as const).entries()) {
-          const threadId = ThreadId.make(`thread-terminal-${status}`);
-          const requestedAt = `2026-02-26T14:00:0${index}.000Z`;
-          yield* eventStore.append({
-            type: "thread.turn-start-requested",
-            eventId: EventId.make(`evt-terminal-pending-${status}`),
-            aggregateKind: "thread",
-            aggregateId: threadId,
-            occurredAt: requestedAt,
-            commandId: CommandId.make(`cmd-terminal-pending-${status}`),
-            causationEventId: null,
-            correlationId: CorrelationId.make(`cmd-terminal-pending-${status}`),
-            metadata: {},
-            payload: {
-              threadId,
-              messageId: MessageId.make(`message-terminal-${status}`),
-              runtimeMode: "approval-required",
-              createdAt: requestedAt,
-            },
-          });
-          yield* eventStore.append({
-            type: "thread.session-set",
-            eventId: EventId.make(`evt-terminal-session-${status}`),
-            aggregateKind: "thread",
-            aggregateId: threadId,
-            occurredAt: requestedAt,
-            commandId: CommandId.make(`cmd-terminal-session-${status}`),
-            causationEventId: null,
-            correlationId: CorrelationId.make(`cmd-terminal-session-${status}`),
-            metadata: {},
-            payload: {
-              threadId,
-              session: {
-                threadId,
-                status,
-                providerName: "codex",
-                runtimeMode: "approval-required",
-                activeTurnId: null,
-                lastError: status === "error" ? "startup failed" : null,
-                updatedAt: requestedAt,
-              },
-            },
-          });
-        }
-
-        yield* projectionPipeline.bootstrap;
-
-        const pendingRows = yield* sql<{ readonly threadId: string }>`
-          SELECT thread_id AS "threadId"
-          FROM projection_turns
-          WHERE turn_id IS NULL
-            AND state = 'pending'
-        `;
-        assert.deepEqual(pendingRows, []);
-      }),
-    );
-  },
-);
-
-it.effect("restores pending turn-start metadata across projection pipeline restart", () =>
-  Effect.gen(function* () {
-    const { dbPath } = yield* ServerConfig;
-    const persistenceLayer = makeSqlitePersistenceLive(dbPath);
-    const firstProjectionLayer = OrchestrationProjectionPipelineLive.pipe(
-      Layer.provideMerge(OrchestrationEventStoreLive),
-      Layer.provideMerge(persistenceLayer),
-    );
-    const secondProjectionLayer = OrchestrationProjectionPipelineLive.pipe(
-      Layer.provideMerge(OrchestrationEventStoreLive),
-      Layer.provideMerge(persistenceLayer),
-    );
-
-    const threadId = ThreadId.make("thread-restart");
-    const turnId = TurnId.make("turn-restart");
-    const messageId = MessageId.make("message-restart");
-    const sourcePlanThreadId = ThreadId.make("thread-plan-source");
-    const sourcePlanId = "plan-source";
-    const turnStartedAt = "2026-02-26T14:00:00.000Z";
-    const sessionSetAt = "2026-02-26T14:00:05.000Z";
-
-    yield* Effect.gen(function* () {
-      const eventStore = yield* OrchestrationEventStore;
-      const projectionPipeline = yield* OrchestrationProjectionPipeline;
-
-      yield* eventStore.append({
-        type: "thread.turn-start-requested",
-        eventId: EventId.make("evt-restart-1"),
-        aggregateKind: "thread",
-        aggregateId: threadId,
-        occurredAt: turnStartedAt,
-        commandId: CommandId.make("cmd-restart-1"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-restart-1"),
-        metadata: {},
-        payload: {
-          threadId,
-          messageId,
-          sourceProposedPlan: {
-            threadId: sourcePlanThreadId,
-            planId: sourcePlanId,
-          },
-          runtimeMode: "approval-required",
-          createdAt: turnStartedAt,
-        },
-      });
-
-      yield* projectionPipeline.bootstrap;
-    }).pipe(Effect.provide(firstProjectionLayer));
-
-    const turnRows = yield* Effect.gen(function* () {
-      const eventStore = yield* OrchestrationEventStore;
-      const projectionPipeline = yield* OrchestrationProjectionPipeline;
-      const sql = yield* SqlClient.SqlClient;
-
-      yield* eventStore.append({
-        type: "thread.session-set",
-        eventId: EventId.make("evt-restart-2"),
-        aggregateKind: "thread",
-        aggregateId: threadId,
-        occurredAt: sessionSetAt,
-        commandId: CommandId.make("cmd-restart-2"),
-        causationEventId: null,
-        correlationId: CorrelationId.make("cmd-restart-2"),
-        metadata: {},
-        payload: {
-          threadId,
-          session: {
-            threadId,
-            status: "running",
-            providerName: "codex",
-            runtimeMode: "approval-required",
-            activeTurnId: turnId,
-            lastError: null,
-            updatedAt: sessionSetAt,
-          },
-        },
-      });
-
-      yield* projectionPipeline.bootstrap;
-
-      const pendingRows = yield* sql<{ readonly threadId: string }>`
-        SELECT thread_id AS "threadId"
-        FROM projection_turns
-        WHERE thread_id = ${threadId}
-          AND turn_id IS NULL
-          AND state = 'pending'
-      `;
-      assert.deepEqual(pendingRows, []);
-
-      return yield* sql<{
-        readonly turnId: string;
-        readonly userMessageId: string | null;
-        readonly sourceProposedPlanThreadId: string | null;
-        readonly sourceProposedPlanId: string | null;
-        readonly startedAt: string;
-      }>`
-        SELECT
-          turn_id AS "turnId",
-          pending_message_id AS "userMessageId",
-          source_proposed_plan_thread_id AS "sourceProposedPlanThreadId",
-          source_proposed_plan_id AS "sourceProposedPlanId",
-          started_at AS "startedAt"
-        FROM projection_turns
-        WHERE turn_id = ${turnId}
-      `;
-    }).pipe(Effect.provide(secondProjectionLayer));
-
-    assert.deepEqual(turnRows, [
-      {
-        turnId: "turn-restart",
-        userMessageId: "message-restart",
-        sourceProposedPlanThreadId: "thread-plan-source",
-        sourceProposedPlanId: "plan-source",
-        startedAt: turnStartedAt,
-      },
-    ]);
-  }).pipe(
-    Effect.provide(
-      Layer.provideMerge(
-        ServerConfig.layerTest(process.cwd(), {
-          prefix: "t3-projection-pipeline-restart-",
-        }),
-        NodeServices.layer,
-      ),
-    ),
-  ),
-);
-
-const engineLayer = it.layer(
-  OrchestrationEngineLive.pipe(
-    Layer.provideMerge(OrchestrationProjectionSnapshotQueryLive),
-    Layer.provide(ThreadBackgroundLiveness.layer),
-    Layer.provide(ThreadPlanProgress.layer),
-    Layer.provide(OrchestrationProjectionPipelineLive),
-    Layer.provide(OrchestrationEventStoreLive),
-    Layer.provide(OrchestrationCommandReceiptRepositoryLive),
-    Layer.provide(RepositoryIdentityResolver.layer),
-    Layer.provideMerge(SqlitePersistenceMemory),
-    Layer.provideMerge(
-      ServerConfig.layerTest(process.cwd(), {
-        prefix: "t3-projection-pipeline-engine-dispatch-",
-      }),
-    ),
-    Layer.provideMerge(NodeServices.layer),
-  ),
-);
-
-engineLayer("OrchestrationProjectionPipeline via engine dispatch", (it) => {
-  it.effect("projects dispatched engine events immediately", () =>
-    Effect.gen(function* () {
-      const engine = yield* OrchestrationEngineService;
-      const sql = yield* SqlClient.SqlClient;
-      const createdAt = "2026-01-01T00:00:00.000Z";
-
-      yield* engine.dispatch({
-        type: "project.create",
-        commandId: CommandId.make("cmd-live-project"),
-        projectId: ProjectId.make("project-live"),
-        title: "Live Project",
-        workspaceRoot: "/tmp/project-live",
-        defaultModelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5-codex",
-        },
-        createdAt,
-      });
-
-      const projectRows = yield* sql<{ readonly title: string; readonly scriptsJson: string }>`
-        SELECT
-          title,
-          scripts_json AS "scriptsJson"
-        FROM projection_projects
-        WHERE project_id = 'project-live'
-      `;
-      assert.deepEqual(projectRows, [{ title: "Live Project", scriptsJson: "[]" }]);
-
-      const projectorRows = yield* sql<{ readonly lastAppliedSequence: number }>`
-        SELECT
-          last_applied_sequence AS "lastAppliedSequence"
-        FROM projection_state
-        WHERE projector = 'projection.projects'
-      `;
-      assert.deepEqual(projectorRows, [{ lastAppliedSequence: 1 }]);
-    }),
-  );
-
-  it.effect("projects persist updated scripts from project.meta.update", () =>
-    Effect.gen(function* () {
-      const engine = yield* OrchestrationEngineService;
-      const sql = yield* SqlClient.SqlClient;
-      const createdAt = "2026-01-01T00:00:00.000Z";
-
-      yield* engine.dispatch({
-        type: "project.create",
-        commandId: CommandId.make("cmd-scripts-project-create"),
-        projectId: ProjectId.make("project-scripts"),
-        title: "Scripts Project",
-        workspaceRoot: "/tmp/project-scripts",
-        defaultModelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5-codex",
-        },
-        createdAt,
-      });
-
-      yield* engine.dispatch({
-        type: "project.meta.update",
-        commandId: CommandId.make("cmd-scripts-project-update"),
-        projectId: ProjectId.make("project-scripts"),
-        scripts: [
-          {
-            id: "script-1",
-            name: "Build",
-            command: "bun run build",
-            icon: "build",
-            runOnWorktreeCreate: false,
-          },
-        ],
-        defaultModelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5",
-        },
-        faviconPath: "brand/icon.svg",
-      });
-
-      const projectRows = yield* sql<{
-        readonly scriptsJson: string;
-        readonly defaultModelSelection: string;
-        readonly faviconPath: string | null;
-      }>`
-        SELECT
-          scripts_json AS "scriptsJson",
-          default_model_selection_json AS "defaultModelSelection",
-          favicon_path AS "faviconPath"
-        FROM projection_projects
-        WHERE project_id = 'project-scripts'
-      `;
-      assert.deepEqual(projectRows, [
-        {
-          scriptsJson:
-            '[{"id":"script-1","name":"Build","command":"bun run build","icon":"build","runOnWorktreeCreate":false}]',
-          defaultModelSelection: '{"instanceId":"codex","model":"gpt-5"}',
-          faviconPath: "brand/icon.svg",
-        },
-      ]);
-    }),
-  );
-
-  it.effect("re-creating a deleted thread id starts from an empty projection", () =>
-    Effect.gen(function* () {
-      const engine = yield* OrchestrationEngineService;
-      const snapshotQuery = yield* ProjectionSnapshotQuery;
-      const sql = yield* SqlClient.SqlClient;
-      const createdAt = "2026-01-01T00:00:00.000Z";
-      const projectId = ProjectId.make("project-retry");
-      const threadId = ThreadId.make("thread-retry");
-      const modelSelection = {
-        instanceId: ProviderInstanceId.make("codex"),
-        model: "gpt-5-codex",
-      };
-      const createThread = (commandId: string, title: string) =>
-        engine.dispatch({
-          type: "thread.create",
-          commandId: CommandId.make(commandId),
-          threadId,
-          projectId,
-          title,
-          modelSelection,
-          runtimeMode: "full-access",
-          interactionMode: "default",
-          branch: null,
-          worktreePath: null,
-          createdAt,
-        });
-      const countRowsForThread = (table: string) =>
-        sql<{ readonly count: number }>`
-          SELECT COUNT(*) AS count FROM ${sql(table)} WHERE thread_id = ${threadId}
-        `.pipe(Effect.map((rows) => rows[0]?.count ?? 0));
-      const perThreadTables = [
-        "projection_thread_messages",
-        "projection_thread_activities",
-        "projection_thread_sessions",
-        "projection_turns",
-        "projection_thread_proposed_plans",
-        "projection_pending_approvals",
-      ];
-
-      yield* engine.dispatch({
-        type: "project.create",
-        commandId: CommandId.make("cmd-retry-project"),
-        projectId,
-        title: "Retry Project",
-        workspaceRoot: "/tmp/project-retry",
-        defaultModelSelection: modelSelection,
-        createdAt,
-      });
-
-      // First attempt: the thread gets a turn, a message, an activity, and a
-      // running session before its bootstrap fails and the server rolls back.
-      yield* createThread("cmd-retry-create-1", "First attempt");
-      yield* engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-retry-turn-1"),
-        threadId,
-        message: {
-          messageId: MessageId.make("message-retry-1"),
-          role: "user",
-          text: "first attempt",
-          attachments: [],
-        },
-        runtimeMode: "full-access",
-        interactionMode: "default",
-        createdAt,
-      });
-      yield* engine.dispatch({
-        type: "thread.activity.append",
-        commandId: CommandId.make("cmd-retry-activity-1"),
-        threadId,
-        activity: {
-          id: EventId.make("activity-retry-1"),
-          tone: "info",
-          kind: "approval.requested",
-          summary: "approval requested",
-          payload: { requestId: "request-retry-1" },
-          turnId: null,
-          createdAt,
-        },
-        createdAt,
-      });
-      yield* engine.dispatch({
-        type: "thread.proposed-plan.upsert",
-        commandId: CommandId.make("cmd-retry-plan-1"),
-        threadId,
-        proposedPlan: {
-          id: "plan-retry-1",
-          turnId: null,
-          planMarkdown: "# Plan",
-          implementedAt: null,
-          implementationThreadId: null,
-          createdAt,
-          updatedAt: createdAt,
-        },
-        createdAt,
-      });
-      yield* engine.dispatch({
-        type: "thread.session.set",
-        commandId: CommandId.make("cmd-retry-session-1"),
-        threadId,
-        session: {
-          threadId,
-          status: "running",
-          providerName: "codex",
-          runtimeMode: "full-access",
-          activeTurnId: TurnId.make("turn-retry-1"),
-          lastError: null,
-          updatedAt: createdAt,
-        },
-        createdAt,
-      });
-      for (const table of perThreadTables) {
-        assert.isAbove(yield* countRowsForThread(table), 0, `${table} should be populated`);
-      }
-      const populatedShell = Option.getOrThrow(yield* snapshotQuery.getThreadShellById(threadId));
-      assert.isTrue(populatedShell.hasPendingApprovals);
-      assert.isTrue(populatedShell.hasActionableProposedPlan);
-
-      yield* engine.dispatch({
-        type: "thread.delete",
-        commandId: CommandId.make("cmd-retry-delete"),
-        threadId,
-      });
-      assert.isTrue(Option.isNone(yield* snapshotQuery.getThreadShellById(threadId)));
-
-      // Retry from the same draft reuses the thread id.
-      yield* createThread("cmd-retry-create-2", "Second attempt");
-
-      const shell = Option.getOrThrow(yield* snapshotQuery.getThreadShellById(threadId));
-      assert.strictEqual(shell.title, "Second attempt");
-      assert.isFalse(shell.hasPendingApprovals);
-      assert.isFalse(shell.hasActionableProposedPlan);
-      for (const table of perThreadTables) {
-        assert.strictEqual(yield* countRowsForThread(table), 0, `${table} should be empty`);
-      }
-      const detail = Option.getOrThrow(yield* snapshotQuery.getThreadDetailById(threadId));
-      assert.deepEqual(detail.messages, []);
-      assert.deepEqual(detail.activities, []);
-      assert.isNull(detail.latestTurn);
-      assert.isNull(detail.session);
-    }),
-  );
-});
diff --git a/apps/server/src/orchestration/Layers/ProjectionPipeline.ts b/apps/server/src/orchestration/Layers/ProjectionPipeline.ts
index ac514d7eb282..8d42c2dda207 100644
--- a/apps/server/src/orchestration/Layers/ProjectionPipeline.ts
+++ b/apps/server/src/orchestration/Layers/ProjectionPipeline.ts
@@ -1,10 +1,8 @@
-import {
-  ApprovalRequestId,
-  type ChatAttachment,
-  type OrchestrationEvent,
-  type OrchestrationSessionStatus,
-  ThreadId,
-} from "@t3tools/contracts";
+import { ApprovalRequestId, type ChatAttachment, ThreadId } from "@t3tools/contracts";
+import type {
+  OrchestrationEvent,
+  OrchestrationSessionStatus,
+} from "@t3tools/contracts/legacy-orchestration";
 import * as Effect from "effect/Effect";
 import * as FileSystem from "effect/FileSystem";
 import * as Layer from "effect/Layer";
diff --git a/apps/server/src/orchestration/Layers/ProjectionSnapshotQuery.search.test.ts b/apps/server/src/orchestration/Layers/ProjectionSnapshotQuery.search.test.ts
new file mode 100644
index 000000000000..3e865b82e259
--- /dev/null
+++ b/apps/server/src/orchestration/Layers/ProjectionSnapshotQuery.search.test.ts
@@ -0,0 +1,102 @@
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import { assert, it } from "@effect/vitest";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as SqlClient from "effect/unstable/sql/SqlClient";
+
+import { ServerConfig } from "../../config.ts";
+import { SqlitePersistenceMemory } from "../../persistence/Layers/Sqlite.ts";
+import * as ProjectEnrichment from "../../project/ProjectEnrichmentService.ts";
+import * as ProjectFaviconResolver from "../../project/ProjectFaviconResolver.ts";
+import * as RepositoryIdentityResolver from "../../project/RepositoryIdentityResolver.ts";
+import { ProjectionSnapshotQuery } from "../Services/ProjectionSnapshotQuery.ts";
+import * as ThreadBackgroundLiveness from "../ThreadBackgroundLiveness.ts";
+import * as ThreadPlanProgress from "../ThreadPlanProgress.ts";
+import { OrchestrationProjectionSnapshotQueryLive } from "./ProjectionSnapshotQuery.ts";
+
+const metadataLayer = Layer.merge(
+  Layer.succeed(RepositoryIdentityResolver.RepositoryIdentityResolver, {
+    resolve: () => Effect.succeed(null),
+  }),
+  Layer.succeed(ProjectFaviconResolver.ProjectFaviconResolver, {
+    resolvePath: () => Effect.succeed(null),
+  }),
+);
+
+const TestLayer = OrchestrationProjectionSnapshotQueryLive.pipe(
+  Layer.provideMerge(ThreadBackgroundLiveness.layer),
+  Layer.provideMerge(ThreadPlanProgress.layer),
+  Layer.provideMerge(ProjectEnrichment.layer),
+  Layer.provideMerge(metadataLayer),
+  Layer.provideMerge(SqlitePersistenceMemory),
+  Layer.provide(ServerConfig.layerTest(process.cwd(), { prefix: "projection-search-test-" })),
+  Layer.provide(NodeServices.layer),
+);
+
+it.effect("search uses v2 visibility while legacy transcripts are still lazy", () =>
+  Effect.gen(function* () {
+    const sql = yield* SqlClient.SqlClient;
+    const query = yield* ProjectionSnapshotQuery;
+    const now = "2026-08-29T00:00:00.000Z";
+    yield* sql`
+      INSERT INTO projection_projects (
+        project_id, title, workspace_root, default_model_selection_json,
+        scripts_json, created_at, updated_at, deleted_at
+      ) VALUES (
+        'project:search', 'Search', '/tmp/search', NULL,
+        '[]', ${now}, ${now}, NULL
+      )
+    `;
+    yield* sql`
+      INSERT INTO projection_threads (
+        thread_id, project_id, title, model_selection_json, runtime_mode,
+        interaction_mode, branch, worktree_path, latest_turn_id, created_at,
+        updated_at, archived_at, settled_override, settled_at, deleted_at
+      ) VALUES
+        ('thread:active', 'project:search', 'Active', '{"instanceId":"codex","model":"gpt-5.4"}', 'full-access', 'default', NULL, NULL, NULL, ${now}, ${now}, NULL, NULL, NULL, NULL),
+        ('thread:archived', 'project:search', 'Archived', '{"instanceId":"codex","model":"gpt-5.4"}', 'full-access', 'default', NULL, NULL, NULL, ${now}, ${now}, NULL, NULL, NULL, NULL),
+        ('thread:deleted', 'project:search', 'Deleted', '{"instanceId":"codex","model":"gpt-5.4"}', 'full-access', 'default', NULL, NULL, NULL, ${now}, ${now}, NULL, NULL, NULL, NULL),
+        ('thread:assistant', 'project:search', 'Assistant', '{"instanceId":"codex","model":"gpt-5.4"}', 'full-access', 'default', NULL, NULL, 'turn:assistant', ${now}, ${now}, NULL, NULL, NULL, NULL)
+    `;
+    yield* sql`
+      INSERT INTO projection_thread_messages (
+        message_id, thread_id, turn_id, role, text, attachments_json,
+        is_streaming, created_at, updated_at
+      ) VALUES
+        ('message:active', 'thread:active', NULL, 'user', 'migration needle active', '[]', 0, ${now}, ${now}),
+        ('message:archived', 'thread:archived', NULL, 'user', 'migration needle archived', '[]', 0, ${now}, ${now}),
+        ('message:deleted', 'thread:deleted', NULL, 'user', 'migration needle deleted', '[]', 0, ${now}, ${now}),
+        ('message:orphan-assistant', 'thread:assistant', NULL, 'assistant', 'migration needle orphan', '[]', 0, ${now}, ${now}),
+        ('message:assistant', 'thread:assistant', 'turn:assistant', 'assistant', 'migration needle answer', '[]', 0, ${now}, ${now})
+    `;
+    yield* sql`
+      INSERT INTO projection_turns (
+        turn_id, thread_id, state, requested_at, started_at, completed_at,
+        assistant_message_id, checkpoint_files_json,
+        source_proposed_plan_thread_id, source_proposed_plan_id
+      ) VALUES (
+        'turn:assistant', 'thread:assistant', 'completed', ${now}, ${now}, ${now},
+        'message:assistant', '[]', NULL, NULL
+      )
+    `;
+    yield* sql`
+      INSERT INTO orchestration_v2_projection_threads (
+        thread_id, project_id, title, default_provider, provider_instance_id,
+        runtime_mode, interaction_mode, active_provider_thread_id, created_at,
+        updated_at, archived_at, deleted_at, payload_json
+      ) VALUES
+        ('thread:active', 'project:search', 'Active', 'codex', 'codex', 'full-access', 'default', NULL, ${now}, ${now}, NULL, NULL, '{}'),
+        ('thread:archived', 'project:search', 'Archived', 'codex', 'codex', 'full-access', 'default', NULL, ${now}, ${now}, ${now}, NULL, '{}'),
+        ('thread:deleted', 'project:search', 'Deleted', 'codex', 'codex', 'full-access', 'default', NULL, ${now}, ${now}, NULL, ${now}, '{}')
+    `;
+
+    const result = yield* query.searchThreads({ query: "migration needle", limit: 20 });
+    assert.deepEqual(
+      result.matches.map((match) => [match.threadId, match.source, match.snippet]),
+      [
+        ["thread:active", "user", "migration needle active"],
+        ["thread:assistant", "assistant", "migration needle answer"],
+      ],
+    );
+  }).pipe(Effect.provide(TestLayer)),
+);
diff --git a/apps/server/src/orchestration/Layers/ProjectionSnapshotQuery.test.ts b/apps/server/src/orchestration/Layers/ProjectionSnapshotQuery.test.ts
deleted file mode 100644
index 30892c760e77..000000000000
--- a/apps/server/src/orchestration/Layers/ProjectionSnapshotQuery.test.ts
+++ /dev/null
@@ -1,2478 +0,0 @@
-import {
-  CheckpointRef,
-  EventId,
-  MessageId,
-  ProjectId,
-  ThreadId,
-  TurnId,
-  ProviderInstanceId,
-} from "@t3tools/contracts";
-import { assert, it } from "@effect/vitest";
-import * as NodeServices from "@effect/platform-node/NodeServices";
-import * as Effect from "effect/Effect";
-import * as Layer from "effect/Layer";
-import * as SqlClient from "effect/unstable/sql/SqlClient";
-
-import { SqlitePersistenceMemory } from "../../persistence/Layers/Sqlite.ts";
-import * as RepositoryIdentityResolver from "../../project/RepositoryIdentityResolver.ts";
-import { ORCHESTRATION_PROJECTOR_NAMES } from "./ProjectionPipeline.ts";
-import { OrchestrationProjectionSnapshotQueryLive } from "./ProjectionSnapshotQuery.ts";
-import * as ThreadBackgroundLiveness from "../ThreadBackgroundLiveness.ts";
-import * as ThreadPlanProgress from "../ThreadPlanProgress.ts";
-import { ProjectionSnapshotQuery } from "../Services/ProjectionSnapshotQuery.ts";
-import { encodeThreadDetailPageCursor } from "../threadDetailCursor.ts";
-
-const asProjectId = (value: string): ProjectId => ProjectId.make(value);
-const asTurnId = (value: string): TurnId => TurnId.make(value);
-const asMessageId = (value: string): MessageId => MessageId.make(value);
-const asEventId = (value: string): EventId => EventId.make(value);
-const asCheckpointRef = (value: string): CheckpointRef => CheckpointRef.make(value);
-
-const projectionSnapshotLayer = it.layer(
-  OrchestrationProjectionSnapshotQueryLive.pipe(
-    Layer.provide(ThreadBackgroundLiveness.layer),
-    Layer.provide(ThreadPlanProgress.layer),
-    Layer.provideMerge(RepositoryIdentityResolver.layer),
-    Layer.provideMerge(SqlitePersistenceMemory),
-    Layer.provideMerge(NodeServices.layer),
-  ),
-);
-
-projectionSnapshotLayer("ProjectionSnapshotQuery", (it) => {
-  it.effect("hydrates read model from projection tables and computes snapshot sequence", () =>
-    Effect.gen(function* () {
-      const snapshotQuery = yield* ProjectionSnapshotQuery;
-      const sql = yield* SqlClient.SqlClient;
-
-      yield* sql`DELETE FROM projection_projects`;
-      yield* sql`DELETE FROM projection_state`;
-      yield* sql`DELETE FROM projection_thread_proposed_plans`;
-      yield* sql`DELETE FROM projection_turns`;
-
-      yield* sql`
-        INSERT INTO projection_projects (
-          project_id,
-          title,
-          workspace_root,
-          default_model_selection_json,
-          scripts_json,
-          created_at,
-          updated_at,
-          deleted_at
-        )
-        VALUES (
-          'project-1',
-          'Project 1',
-          '/tmp/project-1',
-          '{"provider":"codex","model":"gpt-5-codex"}',
-          '[{"id":"script-1","name":"Build","command":"bun run build","icon":"build","runOnWorktreeCreate":false}]',
-          '2026-02-24T00:00:00.000Z',
-          '2026-02-24T00:00:01.000Z',
-          NULL
-        )
-      `;
-
-      yield* sql`
-        INSERT INTO projection_threads (
-          thread_id,
-          project_id,
-          title,
-          model_selection_json,
-          runtime_mode,
-          interaction_mode,
-          branch,
-          worktree_path,
-          linked_pull_request_json,
-          latest_turn_id,
-          latest_user_message_at,
-          pending_approval_count,
-          pending_user_input_count,
-          has_actionable_proposed_plan,
-          pinned_at,
-          pin_order_key,
-          created_at,
-          updated_at,
-          deleted_at
-        )
-        VALUES (
-          'thread-1',
-          'project-1',
-          'Thread 1',
-          '{"provider":"codex","model":"gpt-5-codex"}',
-          'full-access',
-          'default',
-          NULL,
-          NULL,
-          '{"projectId":"project-1","repository":"pingdotgg/t3code","number":42,"url":"https://github.com/pingdotgg/t3code/pull/42"}',
-          'turn-1',
-          '2026-02-24T00:00:04.000Z',
-          1,
-          0,
-          0,
-          '2026-02-24T00:00:01.000Z',
-          'gm',
-          '2026-02-24T00:00:02.000Z',
-          '2026-02-24T00:00:03.000Z',
-          NULL
-        )
-      `;
-
-      yield* sql`
-        INSERT INTO projection_thread_messages (
-          message_id,
-          thread_id,
-          turn_id,
-          role,
-          text,
-          is_streaming,
-          created_at,
-          updated_at
-        )
-        VALUES (
-          'message-1',
-          'thread-1',
-          'turn-1',
-          'assistant',
-          'hello from projection',
-          0,
-          '2026-02-24T00:00:04.000Z',
-          '2026-02-24T00:00:05.000Z'
-        )
-      `;
-
-      yield* sql`
-        INSERT INTO projection_thread_proposed_plans (
-          plan_id,
-          thread_id,
-          turn_id,
-          plan_markdown,
-          implemented_at,
-          implementation_thread_id,
-          created_at,
-          updated_at
-        )
-        VALUES (
-          'plan-1',
-          'thread-1',
-          'turn-1',
-          '# Ship it',
-          '2026-02-24T00:00:05.500Z',
-          'thread-2',
-          '2026-02-24T00:00:05.000Z',
-          '2026-02-24T00:00:05.500Z'
-        )
-      `;
-
-      yield* sql`
-        INSERT INTO projection_thread_activities (
-          activity_id,
-          thread_id,
-          turn_id,
-          tone,
-          kind,
-          summary,
-          payload_json,
-          created_at
-        )
-        VALUES (
-          'activity-1',
-          'thread-1',
-          'turn-1',
-          'info',
-          'runtime.note',
-          'provider started',
-          '{"stage":"start"}',
-          '2026-02-24T00:00:06.000Z'
-        )
-      `;
-
-      yield* sql`
-        INSERT INTO projection_thread_sessions (
-          thread_id,
-          status,
-          provider_name,
-          provider_session_id,
-          provider_thread_id,
-          runtime_mode,
-          active_turn_id,
-          last_error,
-          updated_at
-        )
-        VALUES (
-          'thread-1',
-          'running',
-          'codex',
-          'provider-session-1',
-          'provider-thread-1',
-          'approval-required',
-          'turn-1',
-          NULL,
-          '2026-02-24T00:00:07.000Z'
-        )
-      `;
-
-      yield* sql`
-        INSERT INTO projection_turns (
-          thread_id,
-          turn_id,
-          pending_message_id,
-          source_proposed_plan_thread_id,
-          source_proposed_plan_id,
-          assistant_message_id,
-          state,
-          requested_at,
-          started_at,
-          completed_at,
-          checkpoint_turn_count,
-          checkpoint_ref,
-          checkpoint_status,
-          checkpoint_files_json
-        )
-        VALUES (
-          'thread-1',
-          'turn-1',
-          NULL,
-          'thread-1',
-          'plan-1',
-          'message-1',
-          'completed',
-          '2026-02-24T00:00:08.000Z',
-          '2026-02-24T00:00:08.000Z',
-          '2026-02-24T00:00:08.000Z',
-          1,
-          'checkpoint-1',
-          'ready',
-          '[{"path":"README.md","kind":"modified","additions":2,"deletions":1}]'
-        )
-      `;
-
-      let sequence = 5;
-      for (const projector of Object.values(ORCHESTRATION_PROJECTOR_NAMES)) {
-        yield* sql`
-          INSERT INTO projection_state (
-            projector,
-            last_applied_sequence,
-            updated_at
-          )
-          VALUES (
-            ${projector},
-            ${sequence},
-            '2026-02-24T00:00:09.000Z'
-          )
-        `;
-        sequence += 1;
-      }
-
-      const snapshot = yield* snapshotQuery.getSnapshot();
-
-      assert.equal(snapshot.snapshotSequence, 5);
-      assert.equal(snapshot.updatedAt, "2026-02-24T00:00:09.000Z");
-      assert.deepEqual(snapshot.projects, [
-        {
-          id: asProjectId("project-1"),
-          title: "Project 1",
-          workspaceRoot: "/tmp/project-1",
-          repositoryIdentity: null,
-          defaultModelSelection: {
-            instanceId: ProviderInstanceId.make("codex"),
-            model: "gpt-5-codex",
-          },
-          faviconPath: null,
-          scripts: [
-            {
-              id: "script-1",
-              name: "Build",
-              command: "bun run build",
-              icon: "build",
-              runOnWorktreeCreate: false,
-            },
-          ],
-          defaultThreadEnvMode: null,
-          createdAt: "2026-02-24T00:00:00.000Z",
-          updatedAt: "2026-02-24T00:00:01.000Z",
-          deletedAt: null,
-        },
-      ]);
-      assert.deepEqual(snapshot.threads, [
-        {
-          id: ThreadId.make("thread-1"),
-          projectId: asProjectId("project-1"),
-          title: "Thread 1",
-          modelSelection: {
-            instanceId: ProviderInstanceId.make("codex"),
-            model: "gpt-5-codex",
-          },
-          interactionMode: "default",
-          runtimeMode: "full-access",
-          branch: null,
-          worktreePath: null,
-          linkedPullRequest: {
-            projectId: asProjectId("project-1"),
-            repository: "pingdotgg/t3code",
-            number: 42,
-            url: "https://github.com/pingdotgg/t3code/pull/42",
-          },
-          latestTurn: {
-            turnId: asTurnId("turn-1"),
-            state: "completed",
-            requestedAt: "2026-02-24T00:00:08.000Z",
-            startedAt: "2026-02-24T00:00:08.000Z",
-            completedAt: "2026-02-24T00:00:08.000Z",
-            assistantMessageId: asMessageId("message-1"),
-            sourceProposedPlan: {
-              threadId: ThreadId.make("thread-1"),
-              planId: "plan-1",
-            },
-          },
-          createdAt: "2026-02-24T00:00:02.000Z",
-          updatedAt: "2026-02-24T00:00:03.000Z",
-          archivedAt: null,
-          settledOverride: null,
-          settledAt: null,
-          unsettledAt: null,
-          snoozedUntil: null,
-          snoozedAt: null,
-          pinnedAt: "2026-02-24T00:00:01.000Z",
-          pinOrderKey: "gm",
-          titleRegeneration: null,
-          deletedAt: null,
-          messages: [
-            {
-              id: asMessageId("message-1"),
-              role: "assistant",
-              text: "hello from projection",
-              turnId: asTurnId("turn-1"),
-              streaming: false,
-              createdAt: "2026-02-24T00:00:04.000Z",
-              updatedAt: "2026-02-24T00:00:05.000Z",
-            },
-          ],
-          proposedPlans: [
-            {
-              id: "plan-1",
-              turnId: asTurnId("turn-1"),
-              planMarkdown: "# Ship it",
-              implementedAt: "2026-02-24T00:00:05.500Z",
-              implementationThreadId: ThreadId.make("thread-2"),
-              createdAt: "2026-02-24T00:00:05.000Z",
-              updatedAt: "2026-02-24T00:00:05.500Z",
-            },
-          ],
-          activities: [
-            {
-              id: asEventId("activity-1"),
-              tone: "info",
-              kind: "runtime.note",
-              summary: "provider started",
-              payload: { stage: "start" },
-              turnId: asTurnId("turn-1"),
-              createdAt: "2026-02-24T00:00:06.000Z",
-            },
-          ],
-          checkpoints: [
-            {
-              turnId: asTurnId("turn-1"),
-              checkpointTurnCount: 1,
-              checkpointRef: asCheckpointRef("checkpoint-1"),
-              status: "ready",
-              files: [{ path: "README.md", kind: "modified", additions: 2, deletions: 1 }],
-              assistantMessageId: asMessageId("message-1"),
-              completedAt: "2026-02-24T00:00:08.000Z",
-            },
-          ],
-          session: {
-            threadId: ThreadId.make("thread-1"),
-            status: "running",
-            providerName: "codex",
-            runtimeMode: "approval-required",
-            activeTurnId: asTurnId("turn-1"),
-            lastError: null,
-            updatedAt: "2026-02-24T00:00:07.000Z",
-          },
-        },
-      ]);
-
-      const shellSnapshot = yield* snapshotQuery.getShellSnapshot();
-      assert.equal(shellSnapshot.snapshotSequence, 5);
-      assert.deepEqual(shellSnapshot.projects, [
-        {
-          id: asProjectId("project-1"),
-          title: "Project 1",
-          workspaceRoot: "/tmp/project-1",
-          repositoryIdentity: null,
-          defaultModelSelection: {
-            instanceId: ProviderInstanceId.make("codex"),
-            model: "gpt-5-codex",
-          },
-          faviconPath: null,
-          scripts: [
-            {
-              id: "script-1",
-              name: "Build",
-              command: "bun run build",
-              icon: "build",
-              runOnWorktreeCreate: false,
-            },
-          ],
-          defaultThreadEnvMode: null,
-          createdAt: "2026-02-24T00:00:00.000Z",
-          updatedAt: "2026-02-24T00:00:01.000Z",
-        },
-      ]);
-      assert.deepEqual(shellSnapshot.threads, [
-        {
-          id: ThreadId.make("thread-1"),
-          projectId: asProjectId("project-1"),
-          title: "Thread 1",
-          modelSelection: {
-            instanceId: ProviderInstanceId.make("codex"),
-            model: "gpt-5-codex",
-          },
-          interactionMode: "default",
-          runtimeMode: "full-access",
-          branch: null,
-          worktreePath: null,
-          linkedPullRequest: {
-            projectId: asProjectId("project-1"),
-            repository: "pingdotgg/t3code",
-            number: 42,
-            url: "https://github.com/pingdotgg/t3code/pull/42",
-          },
-          latestTurn: {
-            turnId: asTurnId("turn-1"),
-            state: "completed",
-            requestedAt: "2026-02-24T00:00:08.000Z",
-            startedAt: "2026-02-24T00:00:08.000Z",
-            completedAt: "2026-02-24T00:00:08.000Z",
-            assistantMessageId: asMessageId("message-1"),
-            sourceProposedPlan: {
-              threadId: ThreadId.make("thread-1"),
-              planId: "plan-1",
-            },
-          },
-          createdAt: "2026-02-24T00:00:02.000Z",
-          updatedAt: "2026-02-24T00:00:03.000Z",
-          archivedAt: null,
-          settledOverride: null,
-          settledAt: null,
-          unsettledAt: null,
-          snoozedUntil: null,
-          snoozedAt: null,
-          pinnedAt: "2026-02-24T00:00:01.000Z",
-          pinOrderKey: "gm",
-          titleRegeneration: null,
-          session: {
-            threadId: ThreadId.make("thread-1"),
-            status: "running",
-            providerName: "codex",
-            runtimeMode: "approval-required",
-            activeTurnId: asTurnId("turn-1"),
-            lastError: null,
-            updatedAt: "2026-02-24T00:00:07.000Z",
-          },
-          latestUserMessageAt: "2026-02-24T00:00:04.000Z",
-          hasPendingApprovals: true,
-          hasPendingUserInput: false,
-          hasActionableProposedPlan: false,
-          backgroundLiveness: null,
-          planProgress: null,
-        },
-      ]);
-
-      const threadDetail = yield* snapshotQuery.getThreadDetailById(ThreadId.make("thread-1"));
-      assert.equal(threadDetail._tag, "Some");
-      if (threadDetail._tag === "Some") {
-        assert.deepEqual(threadDetail.value, snapshot.threads[0]);
-      }
-    }),
-  );
-
-  it.effect("keeps archived threads out of the main shell snapshot", () =>
-    Effect.gen(function* () {
-      const snapshotQuery = yield* ProjectionSnapshotQuery;
-      const sql = yield* SqlClient.SqlClient;
-
-      yield* sql`DELETE FROM projection_projects`;
-      yield* sql`DELETE FROM projection_threads`;
-      yield* sql`DELETE FROM projection_state`;
-
-      yield* sql`
-        INSERT INTO projection_projects (
-          project_id,
-          title,
-          workspace_root,
-          default_model_selection_json,
-          scripts_json,
-          created_at,
-          updated_at,
-          deleted_at
-        )
-        VALUES (
-          'project-archive-test',
-          'Archive Test',
-          '/tmp/archive-test',
-          '{"provider":"codex","model":"gpt-5-codex"}',
-          '[]',
-          '2026-04-06T00:00:00.000Z',
-          '2026-04-06T00:00:01.000Z',
-          NULL
-        )
-      `;
-
-      yield* sql`
-        INSERT INTO projection_threads (
-          thread_id,
-          project_id,
-          title,
-          model_selection_json,
-          runtime_mode,
-          interaction_mode,
-          branch,
-          worktree_path,
-          latest_turn_id,
-          latest_user_message_at,
-          pending_approval_count,
-          pending_user_input_count,
-          has_actionable_proposed_plan,
-          created_at,
-          updated_at,
-          archived_at,
-          deleted_at
-        )
-        VALUES
-          (
-            'thread-active',
-            'project-archive-test',
-            'Active Thread',
-            '{"provider":"codex","model":"gpt-5-codex"}',
-            'full-access',
-            'default',
-            NULL,
-            NULL,
-            NULL,
-            NULL,
-            0,
-            0,
-            0,
-            '2026-04-06T00:00:02.000Z',
-            '2026-04-06T00:00:03.000Z',
-            NULL,
-            NULL
-          ),
-          (
-            'thread-archived',
-            'project-archive-test',
-            'Archived Thread',
-            '{"provider":"codex","model":"gpt-5-codex"}',
-            'full-access',
-            'default',
-            NULL,
-            NULL,
-            NULL,
-            NULL,
-            0,
-            0,
-            0,
-            '2026-04-06T00:00:04.000Z',
-            '2026-04-06T00:00:05.000Z',
-            '2026-04-06T00:00:06.000Z',
-            NULL
-          )
-      `;
-
-      yield* sql`
-        INSERT INTO projection_state (projector, last_applied_sequence, updated_at)
-        VALUES
-          (${ORCHESTRATION_PROJECTOR_NAMES.projects}, 4, '2026-04-06T00:00:07.000Z'),
-          (${ORCHESTRATION_PROJECTOR_NAMES.threads}, 4, '2026-04-06T00:00:07.000Z'),
-          (${ORCHESTRATION_PROJECTOR_NAMES.threadMessages}, 4, '2026-04-06T00:00:07.000Z'),
-          (${ORCHESTRATION_PROJECTOR_NAMES.threadProposedPlans}, 4, '2026-04-06T00:00:07.000Z'),
-          (${ORCHESTRATION_PROJECTOR_NAMES.threadActivities}, 4, '2026-04-06T00:00:07.000Z'),
-          (${ORCHESTRATION_PROJECTOR_NAMES.threadSessions}, 4, '2026-04-06T00:00:07.000Z'),
-          (${ORCHESTRATION_PROJECTOR_NAMES.checkpoints}, 4, '2026-04-06T00:00:07.000Z')
-      `;
-
-      const shellSnapshot = yield* snapshotQuery.getShellSnapshot();
-      assert.deepEqual(
-        shellSnapshot.threads.map((thread) => thread.id),
-        [ThreadId.make("thread-active")],
-      );
-
-      const archivedShellSnapshot = yield* snapshotQuery.getArchivedShellSnapshot();
-      assert.deepEqual(
-        archivedShellSnapshot.threads.map((thread) => thread.id),
-        [ThreadId.make("thread-archived")],
-      );
-      assert.equal(archivedShellSnapshot.threads[0]?.archivedAt, "2026-04-06T00:00:06.000Z");
-    }),
-  );
-
-  it.effect("keeps settled threads in the shell snapshot with non-null settlement fields", () =>
-    Effect.gen(function* () {
-      const snapshotQuery = yield* ProjectionSnapshotQuery;
-      const sql = yield* SqlClient.SqlClient;
-
-      yield* sql`DELETE FROM projection_projects`;
-      yield* sql`DELETE FROM projection_threads`;
-      yield* sql`DELETE FROM projection_state`;
-
-      yield* sql`
-        INSERT INTO projection_projects (
-          project_id,
-          title,
-          workspace_root,
-          default_model_selection_json,
-          scripts_json,
-          created_at,
-          updated_at,
-          deleted_at
-        )
-        VALUES (
-          'project-settled-test',
-          'Settled Test',
-          '/tmp/settled-test',
-          '{"provider":"codex","model":"gpt-5-codex"}',
-          '[]',
-          '2026-04-06T00:00:00.000Z',
-          '2026-04-06T00:00:01.000Z',
-          NULL
-        )
-      `;
-
-      yield* sql`
-        INSERT INTO projection_threads (
-          thread_id,
-          project_id,
-          title,
-          model_selection_json,
-          runtime_mode,
-          interaction_mode,
-          branch,
-          worktree_path,
-          latest_turn_id,
-          latest_user_message_at,
-          pending_approval_count,
-          pending_user_input_count,
-          has_actionable_proposed_plan,
-          created_at,
-          updated_at,
-          archived_at,
-          settled_override,
-          settled_at,
-          deleted_at
-        )
-        VALUES (
-          'thread-settled',
-          'project-settled-test',
-          'Settled Thread',
-          '{"provider":"codex","model":"gpt-5-codex"}',
-          'full-access',
-          'default',
-          NULL,
-          NULL,
-          NULL,
-          NULL,
-          0,
-          0,
-          0,
-          '2026-04-06T00:00:02.000Z',
-          '2026-04-06T00:00:05.000Z',
-          NULL,
-          'settled',
-          '2026-04-06T00:00:04.000Z',
-          NULL
-        )
-      `;
-
-      yield* sql`
-        INSERT INTO projection_state (projector, last_applied_sequence, updated_at)
-        VALUES
-          (${ORCHESTRATION_PROJECTOR_NAMES.projects}, 4, '2026-04-06T00:00:07.000Z'),
-          (${ORCHESTRATION_PROJECTOR_NAMES.threads}, 4, '2026-04-06T00:00:07.000Z'),
-          (${ORCHESTRATION_PROJECTOR_NAMES.threadMessages}, 4, '2026-04-06T00:00:07.000Z'),
-          (${ORCHESTRATION_PROJECTOR_NAMES.threadProposedPlans}, 4, '2026-04-06T00:00:07.000Z'),
-          (${ORCHESTRATION_PROJECTOR_NAMES.threadActivities}, 4, '2026-04-06T00:00:07.000Z'),
-          (${ORCHESTRATION_PROJECTOR_NAMES.threadSessions}, 4, '2026-04-06T00:00:07.000Z'),
-          (${ORCHESTRATION_PROJECTOR_NAMES.checkpoints}, 4, '2026-04-06T00:00:07.000Z')
-      `;
-
-      // Settled ≠ archived: the thread must appear in the LIVE shell
-      // snapshot, carrying its settlement fields through the row aliases.
-      const shellSnapshot = yield* snapshotQuery.getShellSnapshot();
-      assert.deepEqual(
-        shellSnapshot.threads.map((thread) => thread.id),
-        [ThreadId.make("thread-settled")],
-      );
-      assert.equal(shellSnapshot.threads[0]?.settledOverride, "settled");
-      assert.equal(shellSnapshot.threads[0]?.settledAt, "2026-04-06T00:00:04.000Z");
-
-      // And the full command read model carries them too.
-      const readModel = yield* snapshotQuery.getCommandReadModel();
-      const thread = readModel.threads.find(
-        (candidate) => candidate.id === ThreadId.make("thread-settled"),
-      );
-      assert.equal(thread?.settledOverride, "settled");
-      assert.equal(thread?.settledAt, "2026-04-06T00:00:04.000Z");
-    }),
-  );
-
-  it.effect(
-    "reads targeted project, thread, and count queries without hydrating the full snapshot",
-    () =>
-      Effect.gen(function* () {
-        const snapshotQuery = yield* ProjectionSnapshotQuery;
-        const sql = yield* SqlClient.SqlClient;
-
-        yield* sql`DELETE FROM projection_projects`;
-        yield* sql`DELETE FROM projection_threads`;
-        yield* sql`DELETE FROM projection_turns`;
-
-        yield* sql`
-        INSERT INTO projection_projects (
-          project_id,
-          title,
-          workspace_root,
-          default_model_selection_json,
-          scripts_json,
-          created_at,
-          updated_at,
-          deleted_at
-        )
-        VALUES
-          (
-            'project-active',
-            'Active Project',
-            '/tmp/workspace',
-            '{"provider":"codex","model":"gpt-5-codex"}',
-            '[]',
-            '2026-03-01T00:00:00.000Z',
-            '2026-03-01T00:00:01.000Z',
-            NULL
-          ),
-          (
-            'project-deleted',
-            'Deleted Project',
-            '/tmp/deleted',
-            NULL,
-            '[]',
-            '2026-03-01T00:00:02.000Z',
-            '2026-03-01T00:00:03.000Z',
-            '2026-03-01T00:00:04.000Z'
-          )
-      `;
-
-        yield* sql`
-        INSERT INTO projection_threads (
-          thread_id,
-          project_id,
-          title,
-          model_selection_json,
-          runtime_mode,
-          interaction_mode,
-          branch,
-          worktree_path,
-          latest_turn_id,
-          created_at,
-          updated_at,
-          archived_at,
-          deleted_at
-        )
-        VALUES
-          (
-            'thread-first',
-            'project-active',
-            'First Thread',
-            '{"provider":"codex","model":"gpt-5-codex"}',
-            'full-access',
-            'default',
-            NULL,
-            NULL,
-            NULL,
-            '2026-03-01T00:00:05.000Z',
-            '2026-03-01T00:00:06.000Z',
-            NULL,
-            NULL
-          ),
-          (
-            'thread-second',
-            'project-active',
-            'Second Thread',
-            '{"provider":"codex","model":"gpt-5-codex"}',
-            'full-access',
-            'default',
-            NULL,
-            NULL,
-            NULL,
-            '2026-03-01T00:00:07.000Z',
-            '2026-03-01T00:00:08.000Z',
-            NULL,
-            NULL
-          ),
-          (
-            'thread-deleted',
-            'project-active',
-            'Deleted Thread',
-            '{"provider":"codex","model":"gpt-5-codex"}',
-            'full-access',
-            'default',
-            NULL,
-            NULL,
-            NULL,
-            '2026-03-01T00:00:09.000Z',
-            '2026-03-01T00:00:10.000Z',
-            NULL,
-            '2026-03-01T00:00:11.000Z'
-          )
-      `;
-
-        const counts = yield* snapshotQuery.getCounts();
-        assert.deepEqual(counts, {
-          projectCount: 2,
-          threadCount: 3,
-        });
-
-        const project = yield* snapshotQuery.getActiveProjectByWorkspaceRoot("/tmp/workspace");
-        assert.equal(project._tag, "Some");
-        if (project._tag === "Some") {
-          assert.equal(project.value.id, asProjectId("project-active"));
-        }
-
-        const missingProject = yield* snapshotQuery.getActiveProjectByWorkspaceRoot("/tmp/missing");
-        assert.equal(missingProject._tag, "None");
-
-        const firstThreadId = yield* snapshotQuery.getFirstActiveThreadIdByProjectId(
-          asProjectId("project-active"),
-        );
-        assert.equal(firstThreadId._tag, "Some");
-        if (firstThreadId._tag === "Some") {
-          assert.equal(firstThreadId.value, ThreadId.make("thread-first"));
-        }
-      }),
-  );
-
-  it.effect("reads single-thread checkpoint context without hydrating unrelated threads", () =>
-    Effect.gen(function* () {
-      const snapshotQuery = yield* ProjectionSnapshotQuery;
-      const sql = yield* SqlClient.SqlClient;
-
-      yield* sql`DELETE FROM projection_projects`;
-      yield* sql`DELETE FROM projection_threads`;
-      yield* sql`DELETE FROM projection_turns`;
-
-      yield* sql`
-        INSERT INTO projection_projects (
-          project_id,
-          title,
-          workspace_root,
-          default_model_selection_json,
-          scripts_json,
-          created_at,
-          updated_at,
-          deleted_at
-        )
-        VALUES (
-          'project-context',
-          'Context Project',
-          '/tmp/context-workspace',
-          NULL,
-          '[]',
-          '2026-03-02T00:00:00.000Z',
-          '2026-03-02T00:00:01.000Z',
-          NULL
-        )
-      `;
-
-      yield* sql`
-        INSERT INTO projection_threads (
-          thread_id,
-          project_id,
-          title,
-          model_selection_json,
-          runtime_mode,
-          interaction_mode,
-          branch,
-          worktree_path,
-          latest_turn_id,
-          created_at,
-          updated_at,
-          archived_at,
-          deleted_at
-        )
-        VALUES (
-          'thread-context',
-          'project-context',
-          'Context Thread',
-          '{"provider":"codex","model":"gpt-5-codex"}',
-          'full-access',
-          'default',
-          'feature/perf',
-          '/tmp/context-worktree',
-          NULL,
-          '2026-03-02T00:00:02.000Z',
-          '2026-03-02T00:00:03.000Z',
-          NULL,
-          NULL
-        )
-      `;
-
-      yield* sql`
-        INSERT INTO projection_turns (
-          thread_id,
-          turn_id,
-          pending_message_id,
-          source_proposed_plan_thread_id,
-          source_proposed_plan_id,
-          assistant_message_id,
-          state,
-          requested_at,
-          started_at,
-          completed_at,
-          checkpoint_turn_count,
-          checkpoint_ref,
-          checkpoint_status,
-          checkpoint_files_json
-        )
-        VALUES
-          (
-            'thread-context',
-            'turn-1',
-            NULL,
-            NULL,
-            NULL,
-            NULL,
-            'completed',
-            '2026-03-02T00:00:04.000Z',
-            '2026-03-02T00:00:04.000Z',
-            '2026-03-02T00:00:04.000Z',
-            1,
-            'checkpoint-a',
-            'ready',
-            '[]'
-          ),
-          (
-            'thread-context',
-            'turn-2',
-            NULL,
-            NULL,
-            NULL,
-            NULL,
-            'completed',
-            '2026-03-02T00:00:05.000Z',
-            '2026-03-02T00:00:05.000Z',
-            '2026-03-02T00:00:05.000Z',
-            2,
-            'checkpoint-b',
-            'ready',
-            '[]'
-          )
-      `;
-
-      const context = yield* snapshotQuery.getThreadCheckpointContext(
-        ThreadId.make("thread-context"),
-      );
-      assert.equal(context._tag, "Some");
-      if (context._tag === "Some") {
-        assert.deepEqual(context.value, {
-          threadId: ThreadId.make("thread-context"),
-          projectId: asProjectId("project-context"),
-          workspaceRoot: "/tmp/context-workspace",
-          worktreePath: "/tmp/context-worktree",
-          checkpoints: [
-            {
-              turnId: asTurnId("turn-1"),
-              checkpointTurnCount: 1,
-              checkpointRef: asCheckpointRef("checkpoint-a"),
-              status: "ready",
-              files: [],
-              assistantMessageId: null,
-              completedAt: "2026-03-02T00:00:04.000Z",
-            },
-            {
-              turnId: asTurnId("turn-2"),
-              checkpointTurnCount: 2,
-              checkpointRef: asCheckpointRef("checkpoint-b"),
-              status: "ready",
-              files: [],
-              assistantMessageId: null,
-              completedAt: "2026-03-02T00:00:05.000Z",
-            },
-          ],
-        });
-      }
-    }),
-  );
-
-  it.effect("keeps thread detail activity ordering consistent with shell snapshot ordering", () =>
-    Effect.gen(function* () {
-      const snapshotQuery = yield* ProjectionSnapshotQuery;
-      const sql = yield* SqlClient.SqlClient;
-
-      yield* sql`DELETE FROM projection_projects`;
-      yield* sql`DELETE FROM projection_threads`;
-      yield* sql`DELETE FROM projection_thread_activities`;
-      yield* sql`DELETE FROM projection_state`;
-
-      yield* sql`
-        INSERT INTO projection_projects (
-          project_id,
-          title,
-          workspace_root,
-          default_model_selection_json,
-          scripts_json,
-          created_at,
-          updated_at,
-          deleted_at
-        )
-        VALUES (
-          'project-1',
-          'Project 1',
-          '/tmp/project-1',
-          '{"provider":"codex","model":"gpt-5-codex"}',
-          '[]',
-          '2026-04-01T00:00:00.000Z',
-          '2026-04-01T00:00:01.000Z',
-          NULL
-        )
-      `;
-
-      yield* sql`
-        INSERT INTO projection_threads (
-          thread_id,
-          project_id,
-          title,
-          model_selection_json,
-          runtime_mode,
-          interaction_mode,
-          branch,
-          worktree_path,
-          latest_turn_id,
-          latest_user_message_at,
-          pending_approval_count,
-          pending_user_input_count,
-          has_actionable_proposed_plan,
-          created_at,
-          updated_at,
-          deleted_at
-        )
-        VALUES (
-          'thread-1',
-          'project-1',
-          'Thread 1',
-          '{"provider":"codex","model":"gpt-5-codex"}',
-          'full-access',
-          'default',
-          NULL,
-          NULL,
-          NULL,
-          NULL,
-          0,
-          0,
-          0,
-          '2026-04-01T00:00:02.000Z',
-          '2026-04-01T00:00:03.000Z',
-          NULL
-        )
-      `;
-
-      yield* sql`
-        INSERT INTO projection_thread_activities (
-          activity_id,
-          thread_id,
-          turn_id,
-          tone,
-          kind,
-          summary,
-          payload_json,
-          sequence,
-          created_at
-        )
-        VALUES
-          (
-            'activity-unsequenced',
-            'thread-1',
-            NULL,
-            'info',
-            'runtime.note',
-            'unsequenced first',
-            '{"source":"unsequenced"}',
-            NULL,
-            '2026-04-01T00:00:06.000Z'
-          ),
-          (
-            'activity-sequence-2',
-            'thread-1',
-            NULL,
-            'info',
-            'runtime.note',
-            'sequence two',
-            '{"source":"sequence-2"}',
-            2,
-            '2026-04-01T00:00:04.000Z'
-          ),
-          (
-            'activity-sequence-1',
-            'thread-1',
-            NULL,
-            'info',
-            'runtime.note',
-            'sequence one',
-            '{"source":"sequence-1"}',
-            1,
-            '2026-04-01T00:00:05.000Z'
-          )
-      `;
-
-      const snapshot = yield* snapshotQuery.getSnapshot();
-      const threadDetail = yield* snapshotQuery.getThreadDetailById(ThreadId.make("thread-1"));
-
-      assert.equal(threadDetail._tag, "Some");
-      if (threadDetail._tag === "Some") {
-        assert.deepEqual(threadDetail.value.activities, snapshot.threads[0]?.activities ?? []);
-      }
-
-      assert.deepEqual(snapshot.threads[0]?.activities ?? [], [
-        {
-          id: asEventId("activity-unsequenced"),
-          tone: "info",
-          kind: "runtime.note",
-          summary: "unsequenced first",
-          payload: { source: "unsequenced" },
-          turnId: null,
-          createdAt: "2026-04-01T00:00:06.000Z",
-        },
-        {
-          id: asEventId("activity-sequence-1"),
-          tone: "info",
-          kind: "runtime.note",
-          summary: "sequence one",
-          payload: { source: "sequence-1" },
-          turnId: null,
-          sequence: 1,
-          createdAt: "2026-04-01T00:00:05.000Z",
-        },
-        {
-          id: asEventId("activity-sequence-2"),
-          tone: "info",
-          kind: "runtime.note",
-          summary: "sequence two",
-          payload: { source: "sequence-2" },
-          turnId: null,
-          sequence: 2,
-          createdAt: "2026-04-01T00:00:04.000Z",
-        },
-      ]);
-    }),
-  );
-
-  it.effect("uses projection_threads.latest_turn_id for targeted thread latest turn queries", () =>
-    Effect.gen(function* () {
-      const snapshotQuery = yield* ProjectionSnapshotQuery;
-      const sql = yield* SqlClient.SqlClient;
-
-      yield* sql`DELETE FROM projection_projects`;
-      yield* sql`DELETE FROM projection_threads`;
-      yield* sql`DELETE FROM projection_turns`;
-
-      yield* sql`
-        INSERT INTO projection_projects (
-          project_id,
-          title,
-          workspace_root,
-          default_model_selection_json,
-          scripts_json,
-          created_at,
-          updated_at,
-          deleted_at
-        )
-        VALUES (
-          'project-1',
-          'Project 1',
-          '/tmp/project-1',
-          '{"provider":"codex","model":"gpt-5-codex"}',
-          '[]',
-          '2026-04-02T00:00:00.000Z',
-          '2026-04-02T00:00:01.000Z',
-          NULL
-        )
-      `;
-
-      yield* sql`
-        INSERT INTO projection_threads (
-          thread_id,
-          project_id,
-          title,
-          model_selection_json,
-          runtime_mode,
-          interaction_mode,
-          branch,
-          worktree_path,
-          latest_turn_id,
-          latest_user_message_at,
-          pending_approval_count,
-          pending_user_input_count,
-          has_actionable_proposed_plan,
-          created_at,
-          updated_at,
-          archived_at,
-          deleted_at
-        )
-        VALUES (
-          'thread-1',
-          'project-1',
-          'Thread 1',
-          '{"provider":"codex","model":"gpt-5-codex"}',
-          'full-access',
-          'default',
-          NULL,
-          NULL,
-          'turn-running',
-          '2026-04-02T00:00:04.000Z',
-          0,
-          0,
-          0,
-          '2026-04-02T00:00:02.000Z',
-          '2026-04-02T00:00:03.000Z',
-          NULL,
-          NULL
-        )
-      `;
-
-      yield* sql`
-        INSERT INTO projection_turns (
-          thread_id,
-          turn_id,
-          pending_message_id,
-          source_proposed_plan_thread_id,
-          source_proposed_plan_id,
-          assistant_message_id,
-          state,
-          requested_at,
-          started_at,
-          completed_at,
-          checkpoint_turn_count,
-          checkpoint_ref,
-          checkpoint_status,
-          checkpoint_files_json
-        )
-        VALUES
-          (
-            'thread-1',
-            'turn-completed',
-            'message-user-1',
-            NULL,
-            NULL,
-            'message-assistant-1',
-            'completed',
-            '2026-04-02T00:00:05.000Z',
-            '2026-04-02T00:00:06.000Z',
-            '2026-04-02T00:00:20.000Z',
-            5,
-            'checkpoint-5',
-            'ready',
-            '[]'
-          ),
-          (
-            'thread-1',
-            'turn-running',
-            'message-user-2',
-            NULL,
-            NULL,
-            NULL,
-            'running',
-            '2026-04-02T00:00:30.000Z',
-            '2026-04-02T00:00:30.000Z',
-            NULL,
-            NULL,
-            NULL,
-            NULL,
-            '[]'
-          )
-      `;
-
-      const threadShell = yield* snapshotQuery.getThreadShellById(ThreadId.make("thread-1"));
-      assert.equal(threadShell._tag, "Some");
-      if (threadShell._tag === "Some") {
-        assert.equal(threadShell.value.latestTurn?.turnId, asTurnId("turn-running"));
-        assert.equal(threadShell.value.latestTurn?.state, "running");
-        assert.equal(threadShell.value.latestTurn?.startedAt, "2026-04-02T00:00:30.000Z");
-      }
-
-      const threadDetail = yield* snapshotQuery.getThreadDetailById(ThreadId.make("thread-1"));
-      assert.equal(threadDetail._tag, "Some");
-      if (threadDetail._tag === "Some") {
-        assert.equal(threadDetail.value.latestTurn?.turnId, asTurnId("turn-running"));
-        assert.equal(threadDetail.value.latestTurn?.state, "running");
-        assert.equal(threadDetail.value.latestTurn?.startedAt, "2026-04-02T00:00:30.000Z");
-      }
-    }),
-  );
-
-  it.effect("uses projection_threads.latest_turn_id for bulk command and shell snapshots", () =>
-    Effect.gen(function* () {
-      const snapshotQuery = yield* ProjectionSnapshotQuery;
-      const sql = yield* SqlClient.SqlClient;
-
-      yield* sql`DELETE FROM projection_projects`;
-      yield* sql`DELETE FROM projection_threads`;
-      yield* sql`DELETE FROM projection_turns`;
-      yield* sql`DELETE FROM projection_state`;
-
-      yield* sql`
-        INSERT INTO projection_projects (
-          project_id,
-          title,
-          workspace_root,
-          default_model_selection_json,
-          scripts_json,
-          created_at,
-          updated_at,
-          deleted_at
-        )
-        VALUES (
-          'project-1',
-          'Project 1',
-          '/tmp/project-1',
-          '{"provider":"codex","model":"gpt-5-codex"}',
-          '[]',
-          '2026-04-03T00:00:00.000Z',
-          '2026-04-03T00:00:01.000Z',
-          NULL
-        )
-      `;
-
-      yield* sql`
-        INSERT INTO projection_threads (
-          thread_id,
-          project_id,
-          title,
-          model_selection_json,
-          runtime_mode,
-          interaction_mode,
-          branch,
-          worktree_path,
-          latest_turn_id,
-          latest_user_message_at,
-          pending_approval_count,
-          pending_user_input_count,
-          has_actionable_proposed_plan,
-          created_at,
-          updated_at,
-          archived_at,
-          deleted_at
-        )
-        VALUES (
-          'thread-1',
-          'project-1',
-          'Thread 1',
-          '{"provider":"codex","model":"gpt-5-codex"}',
-          'full-access',
-          'default',
-          NULL,
-          NULL,
-          'turn-running',
-          '2026-04-03T00:00:04.000Z',
-          0,
-          0,
-          0,
-          '2026-04-03T00:00:02.000Z',
-          '2026-04-03T00:00:03.000Z',
-          NULL,
-          NULL
-        )
-      `;
-
-      yield* sql`
-        INSERT INTO projection_turns (
-          thread_id,
-          turn_id,
-          pending_message_id,
-          source_proposed_plan_thread_id,
-          source_proposed_plan_id,
-          assistant_message_id,
-          state,
-          requested_at,
-          started_at,
-          completed_at,
-          checkpoint_turn_count,
-          checkpoint_ref,
-          checkpoint_status,
-          checkpoint_files_json
-        )
-        VALUES
-          (
-            'thread-1',
-            'turn-running',
-            'message-user-2',
-            NULL,
-            NULL,
-            NULL,
-            'running',
-            '2026-04-03T00:00:30.000Z',
-            '2026-04-03T00:00:30.000Z',
-            NULL,
-            NULL,
-            NULL,
-            NULL,
-            '[]'
-          ),
-          (
-            'thread-1',
-            'turn-completed',
-            'message-user-1',
-            NULL,
-            NULL,
-            'message-assistant-1',
-            'completed',
-            '2026-04-03T00:00:05.000Z',
-            '2026-04-03T00:00:06.000Z',
-            '2026-04-03T00:00:20.000Z',
-            NULL,
-            NULL,
-            NULL,
-            '[]'
-          )
-      `;
-
-      yield* sql`
-        INSERT INTO projection_state (projector, last_applied_sequence, updated_at)
-        VALUES
-          (${ORCHESTRATION_PROJECTOR_NAMES.projects}, 3, '2026-04-03T00:00:40.000Z'),
-          (${ORCHESTRATION_PROJECTOR_NAMES.threads}, 3, '2026-04-03T00:00:40.000Z'),
-          (${ORCHESTRATION_PROJECTOR_NAMES.threadMessages}, 3, '2026-04-03T00:00:40.000Z'),
-          (${ORCHESTRATION_PROJECTOR_NAMES.threadProposedPlans}, 3, '2026-04-03T00:00:40.000Z'),
-          (${ORCHESTRATION_PROJECTOR_NAMES.threadActivities}, 3, '2026-04-03T00:00:40.000Z'),
-          (${ORCHESTRATION_PROJECTOR_NAMES.threadSessions}, 3, '2026-04-03T00:00:40.000Z'),
-          (${ORCHESTRATION_PROJECTOR_NAMES.checkpoints}, 3, '2026-04-03T00:00:40.000Z')
-      `;
-
-      const commandReadModel = yield* snapshotQuery.getCommandReadModel();
-      assert.equal(commandReadModel.threads[0]?.latestTurn?.turnId, asTurnId("turn-running"));
-      assert.equal(commandReadModel.threads[0]?.latestTurn?.state, "running");
-
-      const shellSnapshot = yield* snapshotQuery.getShellSnapshot();
-      assert.equal(shellSnapshot.threads[0]?.latestTurn?.turnId, asTurnId("turn-running"));
-      assert.equal(shellSnapshot.threads[0]?.latestTurn?.state, "running");
-
-      const fullSnapshot = yield* snapshotQuery.getSnapshot();
-      assert.equal(fullSnapshot.threads[0]?.latestTurn?.turnId, asTurnId("turn-running"));
-      assert.equal(fullSnapshot.threads[0]?.latestTurn?.state, "running");
-    }),
-  );
-
-  it.effect("keeps deleted project and thread tombstones in the command read model", () =>
-    Effect.gen(function* () {
-      const snapshotQuery = yield* ProjectionSnapshotQuery;
-      const sql = yield* SqlClient.SqlClient;
-
-      yield* sql`DELETE FROM projection_projects`;
-      yield* sql`DELETE FROM projection_threads`;
-      yield* sql`DELETE FROM projection_turns`;
-      yield* sql`DELETE FROM projection_state`;
-
-      yield* sql`
-        INSERT INTO projection_projects (
-          project_id,
-          title,
-          workspace_root,
-          default_model_selection_json,
-          scripts_json,
-          created_at,
-          updated_at,
-          deleted_at
-        )
-        VALUES (
-          'project-deleted',
-          'Deleted Project',
-          '/tmp/deleted-project',
-          '{"provider":"codex","model":"gpt-5-codex"}',
-          '[]',
-          '2026-04-05T00:00:00.000Z',
-          '2026-04-05T00:00:01.000Z',
-          '2026-04-05T00:00:02.000Z'
-        )
-      `;
-
-      yield* sql`
-        INSERT INTO projection_threads (
-          thread_id,
-          project_id,
-          title,
-          model_selection_json,
-          runtime_mode,
-          interaction_mode,
-          branch,
-          worktree_path,
-          latest_turn_id,
-          latest_user_message_at,
-          pending_approval_count,
-          pending_user_input_count,
-          has_actionable_proposed_plan,
-          created_at,
-          updated_at,
-          archived_at,
-          deleted_at
-        )
-        VALUES (
-          'thread-deleted',
-          'project-deleted',
-          'Deleted Thread',
-          '{"provider":"codex","model":"gpt-5-codex"}',
-          'full-access',
-          'default',
-          NULL,
-          NULL,
-          'turn-deleted',
-          NULL,
-          0,
-          0,
-          0,
-          '2026-04-05T00:00:03.000Z',
-          '2026-04-05T00:00:04.000Z',
-          NULL,
-          '2026-04-05T00:00:05.000Z'
-        )
-      `;
-
-      yield* sql`
-        INSERT INTO projection_turns (
-          thread_id,
-          turn_id,
-          pending_message_id,
-          source_proposed_plan_thread_id,
-          source_proposed_plan_id,
-          assistant_message_id,
-          state,
-          requested_at,
-          started_at,
-          completed_at,
-          checkpoint_turn_count,
-          checkpoint_ref,
-          checkpoint_status,
-          checkpoint_files_json
-        )
-        VALUES (
-          'thread-deleted',
-          'turn-deleted',
-          'message-deleted-user',
-          NULL,
-          NULL,
-          'message-deleted-assistant',
-          'completed',
-          '2026-04-05T00:00:04.100Z',
-          '2026-04-05T00:00:04.200Z',
-          '2026-04-05T00:00:04.300Z',
-          NULL,
-          NULL,
-          NULL,
-          '[]'
-        )
-      `;
-
-      const commandReadModel = yield* snapshotQuery.getCommandReadModel();
-      assert.equal(commandReadModel.projects[0]?.id, asProjectId("project-deleted"));
-      assert.equal(commandReadModel.projects[0]?.deletedAt, "2026-04-05T00:00:02.000Z");
-      assert.equal(commandReadModel.threads[0]?.id, ThreadId.make("thread-deleted"));
-      assert.equal(commandReadModel.threads[0]?.deletedAt, "2026-04-05T00:00:05.000Z");
-      assert.equal(commandReadModel.threads[0]?.latestTurn?.turnId, asTurnId("turn-deleted"));
-      assert.equal(commandReadModel.threads[0]?.latestTurn?.state, "completed");
-
-      const fullSnapshot = yield* snapshotQuery.getSnapshot();
-      assert.equal(fullSnapshot.threads[0]?.id, ThreadId.make("thread-deleted"));
-      assert.equal(fullSnapshot.threads[0]?.latestTurn?.turnId, asTurnId("turn-deleted"));
-      assert.equal(fullSnapshot.threads[0]?.latestTurn?.state, "completed");
-
-      const shellSnapshot = yield* snapshotQuery.getShellSnapshot();
-      assert.equal(shellSnapshot.projects.length, 0);
-      assert.equal(shellSnapshot.threads.length, 0);
-    }),
-  );
-
-  it.effect("searches active user messages and canonical assistant outputs", () =>
-    Effect.gen(function* () {
-      const snapshotQuery = yield* ProjectionSnapshotQuery;
-      const sql = yield* SqlClient.SqlClient;
-
-      yield* sql`DELETE FROM projection_thread_messages`;
-      yield* sql`DELETE FROM projection_turns`;
-      yield* sql`DELETE FROM projection_threads`;
-      yield* sql`DELETE FROM projection_projects`;
-
-      yield* sql`
-        INSERT INTO projection_projects (
-          project_id,
-          title,
-          workspace_root,
-          default_model_selection_json,
-          scripts_json,
-          created_at,
-          updated_at,
-          deleted_at
-        )
-        VALUES (
-          'project-search',
-          'Project Needle',
-          '/tmp/project-search',
-          '{"provider":"codex","model":"gpt-5-codex"}',
-          '[]',
-          '2026-05-01T00:00:00.000Z',
-          '2026-05-01T00:00:01.000Z',
-          NULL
-        )
-      `;
-
-      yield* sql`
-        INSERT INTO projection_threads (
-          thread_id,
-          project_id,
-          title,
-          model_selection_json,
-          runtime_mode,
-          interaction_mode,
-          branch,
-          worktree_path,
-          latest_turn_id,
-          latest_user_message_at,
-          pending_approval_count,
-          pending_user_input_count,
-          has_actionable_proposed_plan,
-          created_at,
-          updated_at,
-          archived_at,
-          deleted_at
-        )
-        VALUES
-          (
-            'thread-active',
-            'project-search',
-            'Literal 100% fix',
-            '{"provider":"codex","model":"gpt-5-codex"}',
-            'full-access',
-            'default',
-            'search-branch',
-            NULL,
-            'turn-active',
-            '2026-05-01T00:00:02.000Z',
-            0,
-            0,
-            0,
-            '2026-05-01T00:00:02.000Z',
-            '2026-05-01T00:00:03.000Z',
-            NULL,
-            NULL
-          ),
-          (
-            'thread-percent-decoy',
-            'project-search',
-            'Literal 100x fix',
-            '{"provider":"codex","model":"gpt-5-codex"}',
-            'full-access',
-            'default',
-            NULL,
-            NULL,
-            NULL,
-            NULL,
-            0,
-            0,
-            0,
-            '2026-05-01T00:00:04.000Z',
-            '2026-05-01T00:00:05.000Z',
-            NULL,
-            NULL
-          ),
-          (
-            'thread-hidden',
-            'project-search',
-            'Archived search',
-            '{"provider":"codex","model":"gpt-5-codex"}',
-            'full-access',
-            'default',
-            NULL,
-            NULL,
-            NULL,
-            NULL,
-            0,
-            0,
-            0,
-            '2026-05-01T00:00:06.000Z',
-            '2026-05-01T00:00:07.000Z',
-            '2026-05-01T00:00:08.000Z',
-            NULL
-          )
-      `;
-
-      yield* sql`
-        INSERT INTO projection_thread_messages (
-          message_id,
-          thread_id,
-          turn_id,
-          role,
-          text,
-          is_streaming,
-          created_at,
-          updated_at
-        )
-        VALUES
-          (
-            'message-user',
-            'thread-active',
-            'turn-active',
-            'user',
-            'Please find this USER needle in an old prompt.',
-            0,
-            '2026-05-01T00:00:12.000Z',
-            '2026-05-01T00:00:12.000Z'
-          ),
-          (
-            'message-percent',
-            'thread-active',
-            NULL,
-            'user',
-            'Literal 100% fix in a prompt.',
-            0,
-            '2026-05-01T00:00:11.000Z',
-            '2026-05-01T00:00:11.000Z'
-          ),
-          (
-            'message-percent-decoy',
-            'thread-percent-decoy',
-            NULL,
-            'user',
-            'Literal 100x fix in a prompt.',
-            0,
-            '2026-05-01T00:00:11.000Z',
-            '2026-05-01T00:00:11.000Z'
-          ),
-          (
-            'message-final',
-            'thread-active',
-            'turn-active',
-            'assistant',
-            'The canonical final needle appears in this completed answer.',
-            0,
-            '2026-05-01T00:00:13.000Z',
-            '2026-05-01T00:00:13.000Z'
-          ),
-          (
-            'message-interim',
-            'thread-active',
-            'turn-active',
-            'assistant',
-            'Interim needle must not be searchable.',
-            0,
-            '2026-05-01T00:00:14.000Z',
-            '2026-05-01T00:00:14.000Z'
-          ),
-          (
-            'message-system',
-            'thread-active',
-            NULL,
-            'system',
-            'System needle must not be searchable.',
-            0,
-            '2026-05-01T00:00:15.000Z',
-            '2026-05-01T00:00:15.000Z'
-          ),
-          (
-            'message-hidden',
-            'thread-hidden',
-            NULL,
-            'user',
-            'Hidden needle in archive.',
-            0,
-            '2026-05-01T00:00:16.000Z',
-            '2026-05-01T00:00:16.000Z'
-          )
-      `;
-
-      yield* sql`
-        INSERT INTO projection_turns (
-          thread_id,
-          turn_id,
-          pending_message_id,
-          assistant_message_id,
-          state,
-          requested_at,
-          started_at,
-          completed_at,
-          checkpoint_files_json
-        )
-        VALUES (
-          'thread-active',
-          'turn-active',
-          'message-user',
-          'message-final',
-          'completed',
-          '2026-05-01T00:00:12.000Z',
-          '2026-05-01T00:00:12.000Z',
-          '2026-05-01T00:00:13.000Z',
-          '[]'
-        )
-      `;
-
-      const literalPercent = yield* snapshotQuery.searchThreads({ query: "100%" });
-      assert.deepStrictEqual(
-        literalPercent.matches.map((match) => [match.threadId, match.source]),
-        [[ThreadId.make("thread-active"), "user"]],
-      );
-
-      const user = yield* snapshotQuery.searchThreads({ query: "user needle" });
-      assert.equal(user.matches[0]?.source, "user");
-      assert.match(user.matches[0]?.snippet ?? "", /USER needle/);
-
-      const assistant = yield* snapshotQuery.searchThreads({ query: "FINAL NEEDLE" });
-      assert.equal(assistant.matches[0]?.source, "assistant");
-
-      const deduped = yield* snapshotQuery.searchThreads({ query: "needle" });
-      assert.deepStrictEqual(
-        deduped.matches.map((match) => [match.threadId, match.source]),
-        [[ThreadId.make("thread-active"), "user"]],
-      );
-
-      assert.deepStrictEqual(
-        (yield* snapshotQuery.searchThreads({ query: "interim needle" })).matches,
-        [],
-      );
-      assert.deepStrictEqual(
-        (yield* snapshotQuery.searchThreads({ query: "system needle" })).matches,
-        [],
-      );
-      assert.deepStrictEqual(
-        (yield* snapshotQuery.searchThreads({ query: "hidden needle" })).matches,
-        [],
-      );
-      yield* sql`
-        UPDATE projection_threads
-        SET deleted_at = '2026-05-01T00:00:20.000Z'
-        WHERE thread_id = 'thread-active'
-      `;
-      assert.deepStrictEqual(
-        (yield* snapshotQuery.searchThreads({ query: "user needle" })).matches,
-        [],
-      );
-    }),
-  );
-});
-
-it.effect(
-  "ProjectionSnapshotQuery dedupes repository identity resolution by workspace root and skips deleted projects for shell snapshots",
-  () => {
-    const resolveCalls: string[] = [];
-    const layer = OrchestrationProjectionSnapshotQueryLive.pipe(
-      Layer.provide(ThreadBackgroundLiveness.layer),
-      Layer.provide(ThreadPlanProgress.layer),
-      Layer.provideMerge(
-        Layer.succeed(RepositoryIdentityResolver.RepositoryIdentityResolver, {
-          resolve: (cwd: string) =>
-            Effect.sync(() => {
-              resolveCalls.push(cwd);
-              return {
-                canonicalKey: `github.com/acme${cwd}`,
-                locator: {
-                  source: "git-remote" as const,
-                  remoteName: "origin",
-                  remoteUrl: `https://github.com/acme${cwd}.git`,
-                },
-                rootPath: cwd,
-              };
-            }),
-        }),
-      ),
-      Layer.provideMerge(SqlitePersistenceMemory),
-    );
-
-    return Effect.gen(function* () {
-      const snapshotQuery = yield* ProjectionSnapshotQuery;
-      const sql = yield* SqlClient.SqlClient;
-
-      yield* sql`DELETE FROM projection_projects`;
-      yield* sql`DELETE FROM projection_threads`;
-      yield* sql`DELETE FROM projection_turns`;
-      yield* sql`DELETE FROM projection_state`;
-
-      yield* sql`
-        INSERT INTO projection_projects (
-          project_id,
-          title,
-          workspace_root,
-          default_model_selection_json,
-          scripts_json,
-          created_at,
-          updated_at,
-          deleted_at
-        )
-        VALUES
-          (
-            'project-1',
-            'Shared Project 1',
-            '/tmp/shared-root',
-            '{"provider":"codex","model":"gpt-5-codex"}',
-            '[]',
-            '2026-04-04T00:00:00.000Z',
-            '2026-04-04T00:00:01.000Z',
-            NULL
-          ),
-          (
-            'project-2',
-            'Shared Project 2',
-            '/tmp/shared-root',
-            '{"provider":"codex","model":"gpt-5-codex"}',
-            '[]',
-            '2026-04-04T00:00:02.000Z',
-            '2026-04-04T00:00:03.000Z',
-            NULL
-          ),
-          (
-            'project-3',
-            'Deleted Project',
-            '/tmp/deleted-root',
-            '{"provider":"codex","model":"gpt-5-codex"}',
-            '[]',
-            '2026-04-04T00:00:04.000Z',
-            '2026-04-04T00:00:05.000Z',
-            '2026-04-04T00:00:06.000Z'
-          )
-      `;
-
-      const shellSnapshot = yield* snapshotQuery.getShellSnapshot();
-      assert.deepStrictEqual(resolveCalls.toSorted(), ["/tmp/shared-root"]);
-      assert.equal(shellSnapshot.projects.length, 2);
-      assert.equal(shellSnapshot.projects[0]?.repositoryIdentity?.rootPath, "/tmp/shared-root");
-      assert.equal(shellSnapshot.projects[1]?.repositoryIdentity?.rootPath, "/tmp/shared-root");
-
-      resolveCalls.length = 0;
-
-      const fullSnapshot = yield* snapshotQuery.getSnapshot();
-      assert.deepStrictEqual(resolveCalls.toSorted(), ["/tmp/deleted-root", "/tmp/shared-root"]);
-      assert.equal(fullSnapshot.projects.length, 3);
-      assert.equal(fullSnapshot.projects[2]?.repositoryIdentity?.rootPath, "/tmp/deleted-root");
-    }).pipe(Effect.provide(layer));
-  },
-);
-
-projectionSnapshotLayer("ProjectionSnapshotQuery windowed thread detail", (it) => {
-  // A thread shaped like real fan-out usage: user turns interleaved with
-  // subagent turns (no user pending message), plus a turnless straggler user
-  // message and a turnless activity anchored between turns.
-  //
-  //   row  turn      pending msg        anchor (requested_at)
-  //   1    turn-1    user-msg-1         T00
-  //   2    turn-2    (subagent)         T01
-  //   3    turn-3    (subagent)         T02
-  //   4    turn-4    user-msg-4         T03
-  //   5    turn-5    user-msg-5         T04
-  //
-  // Straggler user message at T03.5 (turn_id NULL, not any pending_message_id)
-  // and a turnless activity at T03.6 — both belong to the page containing T03+.
-  const seedFanOutThread = Effect.fnUntraced(function* () {
-    const sql = yield* SqlClient.SqlClient;
-
-    // Tests in this block share one in-memory database; reset before seeding.
-    yield* sql`DELETE FROM projection_projects`;
-    yield* sql`DELETE FROM projection_threads`;
-    yield* sql`DELETE FROM projection_turns`;
-    yield* sql`DELETE FROM projection_thread_messages`;
-    yield* sql`DELETE FROM projection_thread_activities`;
-    yield* sql`DELETE FROM projection_state`;
-
-    yield* sql`
-      INSERT INTO projection_projects (
-        project_id, title, workspace_root, scripts_json, created_at, updated_at, deleted_at
-      )
-      VALUES ('project-w', 'Windowed', '/tmp/project-w', '[]',
-        '2026-03-01T00:00:00.000Z', '2026-03-01T00:00:00.000Z', NULL)
-    `;
-    yield* sql`
-      INSERT INTO projection_threads (
-        thread_id, project_id, title, model_selection_json, runtime_mode, interaction_mode,
-        latest_turn_id, pending_approval_count, pending_user_input_count,
-        has_actionable_proposed_plan, created_at, updated_at, deleted_at
-      )
-      VALUES ('thread-w', 'project-w', 'Windowed thread',
-        '{"provider":"codex","model":"gpt-5-codex"}', 'full-access', 'default',
-        'turn-5', 0, 0, 0, '2026-03-01T00:00:00.000Z', '2026-03-01T00:00:10.000Z', NULL)
-    `;
-
-    const turns: ReadonlyArray<{
-      turn: string;
-      pendingMessage: string | null;
-      at: string;
-    }> = [
-      { turn: "turn-1", pendingMessage: "user-msg-1", at: "2026-03-01T00:00:00.000Z" },
-      { turn: "turn-2", pendingMessage: null, at: "2026-03-01T00:01:00.000Z" },
-      { turn: "turn-3", pendingMessage: null, at: "2026-03-01T00:02:00.000Z" },
-      { turn: "turn-4", pendingMessage: "user-msg-4", at: "2026-03-01T00:03:00.000Z" },
-      { turn: "turn-5", pendingMessage: "user-msg-5", at: "2026-03-01T00:04:00.000Z" },
-    ];
-    for (const { turn, pendingMessage, at } of turns) {
-      yield* sql`
-        INSERT INTO projection_turns (
-          thread_id, turn_id, pending_message_id, state, requested_at, started_at, completed_at,
-          checkpoint_files_json
-        )
-        VALUES ('thread-w', ${turn}, ${pendingMessage}, 'completed', ${at}, ${at}, ${at}, '[]')
-      `;
-      if (pendingMessage !== null) {
-        yield* sql`
-          INSERT INTO projection_thread_messages (
-            message_id, thread_id, turn_id, role, text, is_streaming, created_at, updated_at
-          )
-          VALUES (${pendingMessage}, 'thread-w', NULL, 'user', ${"prompt for " + turn}, 0, ${at}, ${at})
-        `;
-      }
-      yield* sql`
-        INSERT INTO projection_thread_messages (
-          message_id, thread_id, turn_id, role, text, is_streaming, created_at, updated_at
-        )
-        VALUES (${turn + "-reply"}, 'thread-w', ${turn}, 'assistant', ${"reply from " + turn}, 0, ${at}, ${at})
-      `;
-      yield* sql`
-        INSERT INTO projection_thread_activities (
-          activity_id, thread_id, turn_id, tone, kind, summary, payload_json, created_at
-        )
-        VALUES (${turn + "-activity"}, 'thread-w', ${turn}, 'tool', 'tool.completed',
-          'ran tool', '{"ok":true}', ${at})
-      `;
-    }
-
-    // Straggler user message sent while turn-4 ran: turn_id NULL and not any
-    // turn's pending_message_id.
-    yield* sql`
-      INSERT INTO projection_thread_messages (
-        message_id, thread_id, turn_id, role, text, is_streaming, created_at, updated_at
-      )
-      VALUES ('user-msg-straggler', 'thread-w', NULL, 'user', 'while you are at it',
-        0, '2026-03-01T00:03:30.000Z', '2026-03-01T00:03:30.000Z')
-    `;
-    // Turnless activity in the same time range.
-    yield* sql`
-      INSERT INTO projection_thread_activities (
-        activity_id, thread_id, turn_id, tone, kind, summary, payload_json, created_at
-      )
-      VALUES ('turnless-activity', 'thread-w', NULL, 'info', 'context-window.updated',
-        'usage', '{"usedTokens":1}', '2026-03-01T00:03:36.000Z')
-    `;
-
-    for (const projector of Object.values(ORCHESTRATION_PROJECTOR_NAMES)) {
-      yield* sql`
-        INSERT INTO projection_state (projector, last_applied_sequence, updated_at)
-        VALUES (${projector}, 42, '2026-03-01T00:00:10.000Z')
-      `;
-    }
-  });
-
-  const threadW = ThreadId.make("thread-w");
-  const messageIds = (snapshot: { thread: { messages: ReadonlyArray<{ id: string }> } }) =>
-    snapshot.thread.messages.map((message) => message.id).toSorted();
-  const activityIds = (snapshot: { thread: { activities: ReadonlyArray<{ id: string }> } }) =>
-    snapshot.thread.activities.map((activity) => activity.id).toSorted();
-
-  it.effect("returns the full thread with no page metadata when no window is requested", () =>
-    Effect.gen(function* () {
-      yield* seedFanOutThread();
-      const snapshotQuery = yield* ProjectionSnapshotQuery;
-
-      const snapshot = yield* snapshotQuery.getThreadDetailSnapshot(threadW);
-      assert.equal(snapshot._tag, "Some");
-      if (snapshot._tag === "Some") {
-        assert.equal(snapshot.value.page, undefined);
-        assert.equal(snapshot.value.thread.messages.length, 9);
-        assert.equal(snapshot.value.thread.activities.length, 6);
-        assert.equal(snapshot.value.snapshotSequence, 42);
-      }
-    }),
-  );
-
-  it.effect("windows to the last N user-anchored turns with subagent turns riding along", () =>
-    Effect.gen(function* () {
-      yield* seedFanOutThread();
-      const snapshotQuery = yield* ProjectionSnapshotQuery;
-
-      // turnLimit 2 walks back: turn-5 (user), turn-4 (user) -> window is
-      // rows 4..5. Subagent turns 2-3 are older than the 2nd user turn and
-      // stay out; the straggler message and turnless activity (T03.5/T03.6,
-      // after turn-4's anchor) ride along.
-      const snapshot = yield* snapshotQuery.getThreadDetailSnapshot(threadW, { turnLimit: 2 });
-      assert.equal(snapshot._tag, "Some");
-      if (snapshot._tag === "Some") {
-        assert.deepEqual(messageIds(snapshot.value), [
-          "turn-4-reply",
-          "turn-5-reply",
-          "user-msg-4",
-          "user-msg-5",
-          "user-msg-straggler",
-        ]);
-        assert.deepEqual(activityIds(snapshot.value), [
-          "turn-4-activity",
-          "turn-5-activity",
-          "turnless-activity",
-        ]);
-        assert.equal(snapshot.value.page?.hasMore, true);
-        assert.notEqual(snapshot.value.page?.beforeCursor, null);
-        assert.equal(snapshot.value.page?.snapshotSequence, 42);
-      }
-    }),
-  );
-
-  it.effect("subagent turns between user turns ride along inside the window", () =>
-    Effect.gen(function* () {
-      yield* seedFanOutThread();
-      const snapshotQuery = yield* ProjectionSnapshotQuery;
-
-      // turnLimit 3 reaches user turn-1, dragging subagent turns 2-3 along:
-      // the full thread, so no further pages.
-      const snapshot = yield* snapshotQuery.getThreadDetailSnapshot(threadW, { turnLimit: 3 });
-      assert.equal(snapshot._tag, "Some");
-      if (snapshot._tag === "Some") {
-        assert.equal(snapshot.value.thread.messages.length, 9);
-        assert.equal(snapshot.value.thread.activities.length, 6);
-        assert.equal(snapshot.value.page?.hasMore, false);
-        assert.equal(snapshot.value.page?.beforeCursor, null);
-      }
-    }),
-  );
-
-  it.effect("cursors survive a projection rewrite that reassigns turn row ids", () =>
-    Effect.gen(function* () {
-      // The revert projector (and any projection rebuild) deletes and
-      // re-upserts projection_turns, assigning fresh autoincrement row ids.
-      // The keyset cursor is derived from event content, so a page cursor
-      // minted before the rewrite must keep working after it.
-      yield* seedFanOutThread();
-      const sql = yield* SqlClient.SqlClient;
-      const snapshotQuery = yield* ProjectionSnapshotQuery;
-
-      const firstPage = yield* snapshotQuery.getThreadDetailSnapshot(threadW, { turnLimit: 2 });
-      assert.equal(firstPage._tag, "Some");
-      if (firstPage._tag !== "Some") return;
-      const cursor = firstPage.value.page?.beforeCursor;
-      assert.notEqual(cursor, null);
-      if (cursor === null || cursor === undefined) return;
-
-      // Simulate the rewrite: delete and re-insert every turn row with the
-      // same content, which reassigns all row ids.
-      const turnRows = yield* sql`
-        SELECT thread_id, turn_id, pending_message_id, state, requested_at, started_at,
-          completed_at, checkpoint_files_json
-        FROM projection_turns WHERE thread_id = 'thread-w' ORDER BY row_id
-      `;
-      yield* sql`DELETE FROM projection_turns WHERE thread_id = 'thread-w'`;
-      for (const row of turnRows) {
-        yield* sql`
-          INSERT INTO projection_turns (
-            thread_id, turn_id, pending_message_id, state, requested_at, started_at,
-            completed_at, checkpoint_files_json
-          )
-          VALUES (${row.thread_id as string}, ${row.turn_id as string},
-            ${row.pending_message_id as string | null}, ${row.state as string},
-            ${row.requested_at as string}, ${row.started_at as string},
-            ${row.completed_at as string}, ${row.checkpoint_files_json as string})
-        `;
-      }
-
-      const olderPage = yield* snapshotQuery.getThreadDetailSnapshot(threadW, {
-        turnLimit: 1,
-        beforeCursor: cursor,
-      });
-      assert.equal(olderPage._tag, "Some");
-      if (olderPage._tag === "Some") {
-        // Identical older slice to what the pre-rewrite cursor would return.
-        assert.deepEqual(messageIds(olderPage.value), [
-          "turn-1-reply",
-          "turn-2-reply",
-          "turn-3-reply",
-          "user-msg-1",
-        ]);
-        assert.equal(olderPage.value.page?.hasMore, false);
-      }
-    }),
-  );
-
-  it.effect("beforeCursor returns the disjoint adjacent older slice", () =>
-    Effect.gen(function* () {
-      yield* seedFanOutThread();
-      const snapshotQuery = yield* ProjectionSnapshotQuery;
-
-      const firstPage = yield* snapshotQuery.getThreadDetailSnapshot(threadW, { turnLimit: 2 });
-      assert.equal(firstPage._tag, "Some");
-      if (firstPage._tag !== "Some") return;
-      const cursor = firstPage.value.page?.beforeCursor;
-      assert.notEqual(cursor, null);
-      assert.notEqual(cursor, undefined);
-      if (cursor === null || cursor === undefined) return;
-
-      // Older page: user turn-1 plus subagent turns 2-3 riding along. Disjoint
-      // from the first page: no turn-4/5 rows, no straggler.
-      const olderPage = yield* snapshotQuery.getThreadDetailSnapshot(threadW, {
-        turnLimit: 1,
-        beforeCursor: cursor,
-      });
-      assert.equal(olderPage._tag, "Some");
-      if (olderPage._tag === "Some") {
-        assert.deepEqual(messageIds(olderPage.value), [
-          "turn-1-reply",
-          "turn-2-reply",
-          "turn-3-reply",
-          "user-msg-1",
-        ]);
-        assert.deepEqual(activityIds(olderPage.value), [
-          "turn-1-activity",
-          "turn-2-activity",
-          "turn-3-activity",
-        ]);
-        assert.equal(olderPage.value.page?.hasMore, false);
-        assert.equal(olderPage.value.page?.beforeCursor, null);
-      }
-    }),
-  );
-
-  it.effect("a cursor for a different thread degrades to the first page", () =>
-    Effect.gen(function* () {
-      yield* seedFanOutThread();
-      const snapshotQuery = yield* ProjectionSnapshotQuery;
-
-      const firstPage = yield* snapshotQuery.getThreadDetailSnapshot(threadW, { turnLimit: 2 });
-      assert.equal(firstPage._tag, "Some");
-      if (firstPage._tag !== "Some") return;
-
-      const foreign = encodeThreadDetailPageCursor({
-        threadId: ThreadId.make("thread-other"),
-        beforeAnchorAt: "2026-03-01T00:01:00.000Z",
-        beforeTurnId: "turn-2",
-      });
-      const snapshot = yield* snapshotQuery.getThreadDetailSnapshot(threadW, {
-        turnLimit: 2,
-        beforeCursor: foreign,
-      });
-      assert.equal(snapshot._tag, "Some");
-      if (snapshot._tag === "Some") {
-        assert.deepEqual(messageIds(snapshot.value), messageIds(firstPage.value));
-      }
-    }),
-  );
-
-  it.effect("a malformed cursor degrades to the first page instead of failing", () =>
-    Effect.gen(function* () {
-      yield* seedFanOutThread();
-      const snapshotQuery = yield* ProjectionSnapshotQuery;
-
-      const snapshot = yield* snapshotQuery.getThreadDetailSnapshot(threadW, {
-        turnLimit: 2,
-        beforeCursor: "not-a-cursor",
-      });
-      assert.equal(snapshot._tag, "Some");
-      if (snapshot._tag === "Some") {
-        assert.equal(snapshot.value.page?.hasMore, true);
-        assert.equal(snapshot.value.thread.messages.length, 5);
-      }
-    }),
-  );
-
-  it.effect("windows never split below the raw-turn ceiling boundary contiguously", () =>
-    Effect.gen(function* () {
-      yield* seedFanOutThread();
-      const snapshotQuery = yield* ProjectionSnapshotQuery;
-
-      // Page repeatedly with turnLimit 1 and assert the union of all pages is
-      // exactly the full thread with no duplicates (disjointness + coverage).
-      const seenMessages: string[] = [];
-      const seenActivities: string[] = [];
-      let cursor: string | undefined;
-      for (let page = 0; page < 10; page += 1) {
-        const snapshot = yield* snapshotQuery.getThreadDetailSnapshot(threadW, {
-          turnLimit: 1,
-          ...(cursor !== undefined ? { beforeCursor: cursor } : {}),
-        });
-        assert.equal(snapshot._tag, "Some");
-        if (snapshot._tag !== "Some") return;
-        seenMessages.push(...snapshot.value.thread.messages.map((message) => message.id));
-        seenActivities.push(...snapshot.value.thread.activities.map((activity) => activity.id));
-        const next = snapshot.value.page?.beforeCursor;
-        if (next === null || next === undefined) break;
-        cursor = next;
-      }
-      assert.equal(new Set(seenMessages).size, seenMessages.length);
-      assert.equal(new Set(seenActivities).size, seenActivities.length);
-      assert.equal(seenMessages.length, 9);
-      assert.equal(seenActivities.length, 6);
-    }),
-  );
-
-  it.effect("bounds activity hydration and preserves unresolved requests", () =>
-    Effect.gen(function* () {
-      yield* seedFanOutThread();
-      const snapshotQuery = yield* ProjectionSnapshotQuery;
-      const sql = yield* SqlClient.SqlClient;
-
-      yield* sql`DELETE FROM projection_thread_activities`;
-      yield* sql`
-        WITH RECURSIVE activity_rows(sequence) AS (
-          SELECT 1
-          UNION ALL
-          SELECT sequence + 1 FROM activity_rows WHERE sequence < 501
-        )
-        INSERT INTO projection_thread_activities (
-          activity_id, thread_id, turn_id, tone, kind, summary, payload_json, sequence, created_at
-        )
-        SELECT
-          printf('activity-%04d', sequence),
-          'thread-w',
-          'turn-5',
-          'tool',
-          'tool.completed',
-          'ran tool',
-          printf('{"sequence":%d}', sequence),
-          sequence,
-          '2026-03-01T00:04:00.000Z'
-        FROM activity_rows
-      `;
-
-      const fullDetail = yield* snapshotQuery.getThreadDetailById(threadW);
-      assert.equal(fullDetail._tag, "Some");
-      if (fullDetail._tag === "Some") {
-        assert.equal(fullDetail.value.activities.length, 500);
-        assert.equal(fullDetail.value.activities[0]?.id, asEventId("activity-0002"));
-        assert.equal(fullDetail.value.activities.at(-1)?.id, asEventId("activity-0501"));
-      }
-
-      const windowedDetail = yield* snapshotQuery.getThreadDetailSnapshot(threadW, {
-        turnLimit: 2,
-      });
-      assert.equal(windowedDetail._tag, "Some");
-      if (windowedDetail._tag === "Some") {
-        assert.equal(windowedDetail.value.thread.activities.length, 500);
-        assert.equal(windowedDetail.value.thread.activities[0]?.id, asEventId("activity-0002"));
-        assert.equal(windowedDetail.value.thread.activities.at(-1)?.id, asEventId("activity-0501"));
-      }
-
-      yield* sql`
-        INSERT INTO projection_thread_activities (
-          activity_id, thread_id, turn_id, tone, kind, summary, payload_json, sequence, created_at
-        )
-        VALUES
-          (
-            'approval-old', 'thread-w', NULL, 'approval', 'approval.requested',
-            'Approve old command', '{"requestId":"approval-1"}', NULL,
-            '2026-03-01T00:00:01.000Z'
-          ),
-          (
-            'user-input-old', 'thread-w', NULL, 'approval', 'user-input.requested',
-            'Answer old question', '{"requestId":"input-1"}', NULL,
-            '2026-03-01T00:00:02.000Z'
-          ),
-          (
-            'user-input-closed', 'thread-w', NULL, 'approval', 'user-input.requested',
-            'Closed question', '{"requestId":"input-closed"}', NULL,
-            '2026-03-01T00:00:03.000Z'
-          ),
-          (
-            'user-input-closed-resolution', 'thread-w', NULL, 'info', 'user-input.resolved',
-            'Closed question', '{"requestId":"input-closed"}', NULL,
-            '2026-03-01T00:00:04.000Z'
-          ),
-          (
-            'user-input-tied-z-request', 'thread-w', NULL, 'approval', 'user-input.requested',
-            'Tied open question', '{"requestId":"input-tied-open"}', NULL,
-            '2026-03-01T00:00:05.000Z'
-          ),
-          (
-            'user-input-tied-a-resolution', 'thread-w', NULL, 'info', 'user-input.resolved',
-            'Tied open question', '{"requestId":"input-tied-open"}', NULL,
-            '2026-03-01T00:00:05.000Z'
-          )
-      `;
-      yield* sql`
-        INSERT INTO projection_pending_approvals (
-          request_id, thread_id, turn_id, status, decision, created_at, resolved_at
-        )
-        VALUES (
-          'approval-1', 'thread-w', NULL, 'pending', NULL,
-          '2026-03-01T00:00:01.000Z', NULL
-        )
-      `;
-      yield* sql`
-        UPDATE projection_threads
-        SET pending_approval_count = 1, pending_user_input_count = 1
-        WHERE thread_id = 'thread-w'
-      `;
-
-      const detailWithPinnedRequests = yield* snapshotQuery.getThreadDetailById(threadW);
-      assert.equal(detailWithPinnedRequests._tag, "Some");
-      if (detailWithPinnedRequests._tag === "Some") {
-        const ids = detailWithPinnedRequests.value.activities.map((activity) => activity.id);
-        assert.equal(detailWithPinnedRequests.value.activities.length, 503);
-        assert.equal(ids.includes(asEventId("approval-old")), true);
-        assert.equal(ids.includes(asEventId("user-input-old")), true);
-        assert.equal(ids.includes(asEventId("user-input-closed")), false);
-        assert.equal(ids.includes(asEventId("user-input-tied-z-request")), true);
-      }
-
-      const windowWithPinnedRequests = yield* snapshotQuery.getThreadDetailSnapshot(threadW, {
-        turnLimit: 2,
-      });
-      assert.equal(windowWithPinnedRequests._tag, "Some");
-      if (windowWithPinnedRequests._tag === "Some") {
-        const ids = windowWithPinnedRequests.value.thread.activities.map((activity) => activity.id);
-        assert.equal(windowWithPinnedRequests.value.thread.activities.length, 503);
-        assert.equal(ids.includes(asEventId("approval-old")), true);
-        assert.equal(ids.includes(asEventId("user-input-old")), true);
-        assert.equal(ids.includes(asEventId("user-input-closed")), false);
-        assert.equal(ids.includes(asEventId("user-input-tied-z-request")), true);
-      }
-    }),
-  );
-
-  it.effect("a thread with no turns returns its content unwindowed on the first page", () =>
-    Effect.gen(function* () {
-      const sql = yield* SqlClient.SqlClient;
-      const snapshotQuery = yield* ProjectionSnapshotQuery;
-
-      yield* sql`DELETE FROM projection_projects`;
-      yield* sql`DELETE FROM projection_threads`;
-      yield* sql`DELETE FROM projection_turns`;
-      yield* sql`DELETE FROM projection_thread_messages`;
-      yield* sql`DELETE FROM projection_thread_activities`;
-      yield* sql`DELETE FROM projection_state`;
-
-      yield* sql`
-        INSERT INTO projection_projects (
-          project_id, title, workspace_root, scripts_json, created_at, updated_at, deleted_at
-        )
-        VALUES ('project-e', 'Empty', '/tmp/project-e', '[]',
-          '2026-03-02T00:00:00.000Z', '2026-03-02T00:00:00.000Z', NULL)
-      `;
-      yield* sql`
-        INSERT INTO projection_threads (
-          thread_id, project_id, title, model_selection_json, runtime_mode, interaction_mode,
-          pending_approval_count, pending_user_input_count, has_actionable_proposed_plan,
-          created_at, updated_at, deleted_at
-        )
-        VALUES ('thread-e', 'project-e', 'Turnless thread',
-          '{"provider":"codex","model":"gpt-5-codex"}', 'full-access', 'default',
-          0, 0, 0, '2026-03-02T00:00:00.000Z', '2026-03-02T00:00:00.000Z', NULL)
-      `;
-      yield* sql`
-        INSERT INTO projection_thread_messages (
-          message_id, thread_id, turn_id, role, text, is_streaming, created_at, updated_at
-        )
-        VALUES ('pre-turn-msg', 'thread-e', NULL, 'user', 'first prompt', 0,
-          '2026-03-02T00:00:01.000Z', '2026-03-02T00:00:01.000Z')
-      `;
-      for (const projector of Object.values(ORCHESTRATION_PROJECTOR_NAMES)) {
-        yield* sql`
-          INSERT INTO projection_state (projector, last_applied_sequence, updated_at)
-          VALUES (${projector}, 7, '2026-03-02T00:00:01.000Z')
-        `;
-      }
-
-      const snapshot = yield* snapshotQuery.getThreadDetailSnapshot(ThreadId.make("thread-e"), {
-        turnLimit: 5,
-      });
-      assert.equal(snapshot._tag, "Some");
-      if (snapshot._tag === "Some") {
-        assert.deepEqual(messageIds(snapshot.value), ["pre-turn-msg"]);
-        assert.equal(snapshot.value.page?.hasMore, false);
-        assert.equal(snapshot.value.page?.beforeCursor, null);
-      }
-    }),
-  );
-});
diff --git a/apps/server/src/orchestration/Layers/ProjectionSnapshotQuery.ts b/apps/server/src/orchestration/Layers/ProjectionSnapshotQuery.ts
index 0b9698eaf9cf..8dcb06ad1176 100644
--- a/apps/server/src/orchestration/Layers/ProjectionSnapshotQuery.ts
+++ b/apps/server/src/orchestration/Layers/ProjectionSnapshotQuery.ts
@@ -4,6 +4,13 @@ import {
   IsoDateTime,
   MessageId,
   NonNegativeInt,
+  ProjectScript,
+  TurnId,
+  ModelSelection,
+  ProjectId,
+  ThreadId,
+} from "@t3tools/contracts";
+import {
   OrchestrationCheckpointFile,
   OrchestrationProposedPlanId,
   OrchestrationReadModel,
@@ -11,8 +18,6 @@ import {
   OrchestrationShellSnapshot,
   OrchestrationThread,
   OrchestrationThreadDetailSnapshot,
-  ProjectScript,
-  TurnId,
   type OrchestrationCheckpointSummary,
   type OrchestrationLatestTurn,
   type OrchestrationMessage,
@@ -22,11 +27,7 @@ import {
   type OrchestrationSession,
   type OrchestrationThreadActivity,
   type OrchestrationThreadShell,
-  ModelSelection,
-  ProjectId,
-  ThreadLinkedPullRequest,
-  ThreadId,
-} from "@t3tools/contracts";
+} from "@t3tools/contracts/legacy-orchestration";
 import * as Arr from "effect/Array";
 import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
@@ -53,11 +54,11 @@ import { ProjectionThreadMessage } from "../../persistence/Services/ProjectionTh
 import { ProjectionThreadProposedPlan } from "../../persistence/Services/ProjectionThreadProposedPlans.ts";
 import { ProjectionThreadSession } from "../../persistence/Services/ProjectionThreadSessions.ts";
 import { ProjectionThread } from "../../persistence/Services/ProjectionThreads.ts";
+import { ProjectEnrichmentService } from "../../project/ProjectEnrichmentService.ts";
 import {
   decodeThreadDetailPageCursor,
   encodeThreadDetailPageCursor,
 } from "../threadDetailCursor.ts";
-import * as RepositoryIdentityResolver from "../../project/RepositoryIdentityResolver.ts";
 import { ORCHESTRATION_PROJECTOR_NAMES } from "./ProjectionPipeline.ts";
 import {
   ProjectionSnapshotQuery,
@@ -90,7 +91,6 @@ const ProjectionThreadProposedPlanDbRowSchema = ProjectionThreadProposedPlan;
 const ProjectionThreadDbRowSchema = ProjectionThread.mapFields(
   Struct.assign({
     modelSelection: Schema.fromJsonString(ModelSelection),
-    linkedPullRequest: Schema.NullOr(Schema.fromJsonString(ThreadLinkedPullRequest)),
   }),
 );
 const ProjectionThreadActivityDbRowSchema = ProjectionThreadActivity.mapFields(
@@ -355,10 +355,9 @@ const makeProjectionSnapshotQuery = Effect.gen(function* () {
   const threadBackgroundLiveness = yield* ThreadBackgroundLivenessService;
   const threadPlanProgress = yield* ThreadPlanProgressService;
   const sql = yield* SqlClient.SqlClient;
-  const repositoryIdentityResolver = yield* RepositoryIdentityResolver.RepositoryIdentityResolver;
-  const repositoryIdentityResolutionConcurrency = 4;
-  const resolveRepositoryIdentitiesForProjects = Effect.fn(
-    "ProjectionSnapshotQuery.resolveRepositoryIdentitiesForProjects",
+  const projectEnrichment = yield* ProjectEnrichmentService;
+  const getAvailableRepositoryIdentities = Effect.fn(
+    "ProjectionSnapshotQuery.getAvailableRepositoryIdentities",
   )(function* (
     projectRows: ReadonlyArray<Schema.Schema.Type<typeof ProjectionProjectDbRowSchema>>,
     options?: {
@@ -374,10 +373,12 @@ const makeProjectionSnapshotQuery = Effect.gen(function* () {
       yield* Effect.forEach(
         uniqueWorkspaceRoots,
         (workspaceRoot) =>
-          repositoryIdentityResolver
-            .resolve(workspaceRoot)
-            .pipe(Effect.map((identity) => [workspaceRoot, identity] as const)),
-        { concurrency: repositoryIdentityResolutionConcurrency },
+          projectEnrichment
+            .getAvailable(workspaceRoot)
+            .pipe(
+              Effect.map((enrichment) => [workspaceRoot, enrichment.repositoryIdentity] as const),
+            ),
+        { concurrency: 16 },
       ),
     );
 
@@ -787,38 +788,31 @@ const makeProjectionSnapshotQuery = Effect.gen(function* () {
     Result: ProjectionThreadSearchRow,
     execute: ({ pattern, limit }) =>
       sql`
-        WITH ranked AS (
+        WITH candidate AS (
           SELECT
             threads.thread_id AS thread_id,
-            threads.project_id AS project_id,
-            CASE messages.role
-              WHEN 'user' THEN 'user'
-              ELSE 'assistant'
-            END AS source,
+            COALESCE(v2_threads.project_id, threads.project_id) AS project_id,
+            messages.role AS role,
             messages.text AS match_text,
             messages.created_at AS message_created_at,
-            CASE messages.role
-              WHEN 'user' THEN 0
-              ELSE 1
-            END AS match_rank,
-            threads.updated_at AS thread_updated_at,
-            ROW_NUMBER() OVER (
-              PARTITION BY threads.thread_id
-              ORDER BY
-                CASE messages.role
-                  WHEN 'user' THEN 0
-                  ELSE 1
-                END ASC,
-                messages.created_at DESC,
-                messages.message_id ASC
-            ) AS thread_match_rank
+            messages.message_id AS message_id,
+            COALESCE(v2_threads.updated_at, threads.updated_at) AS thread_updated_at
           FROM projection_thread_messages AS messages
           INNER JOIN projection_threads AS threads
             ON threads.thread_id = messages.thread_id
+          LEFT JOIN orchestration_v2_projection_threads AS v2_threads
+            ON v2_threads.thread_id = threads.thread_id
           INNER JOIN projection_projects AS projects
-            ON projects.project_id = threads.project_id
-          WHERE threads.deleted_at IS NULL
-            AND threads.archived_at IS NULL
+            ON projects.project_id = COALESCE(v2_threads.project_id, threads.project_id)
+          WHERE (
+              v2_threads.thread_id IS NULL
+              AND threads.deleted_at IS NULL
+              AND threads.archived_at IS NULL
+            OR
+              v2_threads.thread_id IS NOT NULL
+              AND v2_threads.deleted_at IS NULL
+              AND v2_threads.archived_at IS NULL
+            )
             AND projects.deleted_at IS NULL
             AND messages.is_streaming = 0
             AND (
@@ -833,6 +827,53 @@ const makeProjectionSnapshotQuery = Effect.gen(function* () {
               )
             )
             AND messages.text LIKE ${pattern} ESCAPE '!'
+          UNION ALL
+          SELECT
+            v2_threads.thread_id AS thread_id,
+            v2_threads.project_id AS project_id,
+            v2_messages.role AS role,
+            json_extract(v2_messages.payload_json, '$.text') AS match_text,
+            v2_messages.created_at AS message_created_at,
+            v2_messages.message_id AS message_id,
+            v2_threads.updated_at AS thread_updated_at
+          FROM orchestration_v2_projection_messages AS v2_messages
+          INNER JOIN orchestration_v2_projection_threads AS v2_threads
+            ON v2_threads.thread_id = v2_messages.thread_id
+          INNER JOIN projection_projects AS projects
+            ON projects.project_id = v2_threads.project_id
+          WHERE v2_threads.deleted_at IS NULL
+            AND v2_threads.archived_at IS NULL
+            AND projects.deleted_at IS NULL
+            AND v2_messages.streaming = 0
+            AND v2_messages.role IN ('user', 'assistant')
+            AND json_extract(v2_messages.payload_json, '$.text') LIKE ${pattern} ESCAPE '!'
+        ),
+        ranked AS (
+          SELECT
+            thread_id,
+            project_id,
+            CASE role
+              WHEN 'user' THEN 'user'
+              ELSE 'assistant'
+            END AS source,
+            match_text,
+            message_created_at,
+            CASE role
+              WHEN 'user' THEN 0
+              ELSE 1
+            END AS match_rank,
+            thread_updated_at,
+            ROW_NUMBER() OVER (
+              PARTITION BY thread_id
+              ORDER BY
+                CASE role
+                  WHEN 'user' THEN 0
+                  ELSE 1
+                END ASC,
+                message_created_at DESC,
+                message_id ASC
+            ) AS thread_match_rank
+          FROM candidate
         )
         SELECT
           thread_id AS "threadId",
@@ -1676,10 +1717,9 @@ const makeProjectionSnapshotQuery = Effect.gen(function* () {
                 });
               }
 
-              const repositoryIdentities = yield* resolveRepositoryIdentitiesForProjects(
-                projectRows,
-                { includeDeleted: true },
-              );
+              const repositoryIdentities = yield* getAvailableRepositoryIdentities(projectRows, {
+                includeDeleted: true,
+              });
 
               const projects: ReadonlyArray<OrchestrationProject> = projectRows.map((row) => ({
                 id: row.projectId,
@@ -1704,16 +1744,12 @@ const makeProjectionSnapshotQuery = Effect.gen(function* () {
                 interactionMode: row.interactionMode,
                 branch: row.branch,
                 worktreePath: row.worktreePath,
-                ...(row.linkedPullRequest === null
-                  ? {}
-                  : { linkedPullRequest: row.linkedPullRequest }),
                 latestTurn: latestTurnByThread.get(row.threadId) ?? null,
                 createdAt: row.createdAt,
                 updatedAt: row.updatedAt,
                 archivedAt: row.archivedAt,
                 settledOverride: row.settledOverride,
                 settledAt: row.settledAt,
-                unsettledAt: row.unsettledAt,
                 snoozedUntil: row.snoozedUntil,
                 snoozedAt: row.snoozedAt,
                 pinnedAt: row.pinnedAt,
@@ -1915,16 +1951,12 @@ const makeProjectionSnapshotQuery = Effect.gen(function* () {
                   interactionMode: row.interactionMode,
                   branch: row.branch,
                   worktreePath: row.worktreePath,
-                  ...(row.linkedPullRequest === null
-                    ? {}
-                    : { linkedPullRequest: row.linkedPullRequest }),
                   latestTurn: latestTurnByThread.get(row.threadId) ?? null,
                   createdAt: row.createdAt,
                   updatedAt: row.updatedAt,
                   archivedAt: row.archivedAt,
                   settledOverride: row.settledOverride,
                   settledAt: row.settledAt,
-                  unsettledAt: row.unsettledAt,
                   snoozedUntil: row.snoozedUntil,
                   snoozedAt: row.snoozedAt,
                   pinnedAt: row.pinnedAt,
@@ -1955,152 +1987,157 @@ const makeProjectionSnapshotQuery = Effect.gen(function* () {
         }),
       );
 
-  const getShellSnapshot: ProjectionSnapshotQueryShape["getShellSnapshot"] = () =>
-    sql
-      .withTransaction(
-        Effect.all([
-          listProjectRows(undefined).pipe(
-            Effect.mapError(
-              toPersistenceSqlOrDecodeError(
-                "ProjectionSnapshotQuery.getShellSnapshot:listProjects:query",
-                "ProjectionSnapshotQuery.getShellSnapshot:listProjects:decodeRows",
+  const getShellSnapshotWithoutEnrichment: ProjectionSnapshotQueryShape["getShellSnapshotWithoutEnrichment"] =
+    () =>
+      sql
+        .withTransaction(
+          Effect.all([
+            listProjectRows(undefined).pipe(
+              Effect.mapError(
+                toPersistenceSqlOrDecodeError(
+                  "ProjectionSnapshotQuery.getShellSnapshot:listProjects:query",
+                  "ProjectionSnapshotQuery.getShellSnapshot:listProjects:decodeRows",
+                ),
               ),
             ),
-          ),
-          listActiveThreadRows(undefined).pipe(
-            Effect.mapError(
-              toPersistenceSqlOrDecodeError(
-                "ProjectionSnapshotQuery.getShellSnapshot:listThreads:query",
-                "ProjectionSnapshotQuery.getShellSnapshot:listThreads:decodeRows",
+            listActiveThreadRows(undefined).pipe(
+              Effect.mapError(
+                toPersistenceSqlOrDecodeError(
+                  "ProjectionSnapshotQuery.getShellSnapshot:listThreads:query",
+                  "ProjectionSnapshotQuery.getShellSnapshot:listThreads:decodeRows",
+                ),
               ),
             ),
-          ),
-          listActiveThreadSessionRows(undefined).pipe(
-            Effect.mapError(
-              toPersistenceSqlOrDecodeError(
-                "ProjectionSnapshotQuery.getShellSnapshot:listThreadSessions:query",
-                "ProjectionSnapshotQuery.getShellSnapshot:listThreadSessions:decodeRows",
+            listActiveThreadSessionRows(undefined).pipe(
+              Effect.mapError(
+                toPersistenceSqlOrDecodeError(
+                  "ProjectionSnapshotQuery.getShellSnapshot:listThreadSessions:query",
+                  "ProjectionSnapshotQuery.getShellSnapshot:listThreadSessions:decodeRows",
+                ),
               ),
             ),
-          ),
-          listActiveLatestTurnRows(undefined).pipe(
-            Effect.mapError(
-              toPersistenceSqlOrDecodeError(
-                "ProjectionSnapshotQuery.getShellSnapshot:listLatestTurns:query",
-                "ProjectionSnapshotQuery.getShellSnapshot:listLatestTurns:decodeRows",
+            listActiveLatestTurnRows(undefined).pipe(
+              Effect.mapError(
+                toPersistenceSqlOrDecodeError(
+                  "ProjectionSnapshotQuery.getShellSnapshot:listLatestTurns:query",
+                  "ProjectionSnapshotQuery.getShellSnapshot:listLatestTurns:decodeRows",
+                ),
               ),
             ),
-          ),
-          listProjectionStateRows(undefined).pipe(
-            Effect.mapError(
-              toPersistenceSqlOrDecodeError(
-                "ProjectionSnapshotQuery.getShellSnapshot:listProjectionState:query",
-                "ProjectionSnapshotQuery.getShellSnapshot:listProjectionState:decodeRows",
+            listProjectionStateRows(undefined).pipe(
+              Effect.mapError(
+                toPersistenceSqlOrDecodeError(
+                  "ProjectionSnapshotQuery.getShellSnapshot:listProjectionState:query",
+                  "ProjectionSnapshotQuery.getShellSnapshot:listProjectionState:decodeRows",
+                ),
               ),
             ),
-          ),
-        ]),
-      )
-      .pipe(
-        Effect.flatMap(([projectRows, threadRows, sessionRows, latestTurnRows, stateRows]) =>
-          Effect.gen(function* () {
-            let updatedAt: string | null = null;
-            for (const row of projectRows) {
-              updatedAt = maxIso(updatedAt, row.updatedAt);
-            }
-            for (const row of threadRows) {
-              updatedAt = maxIso(updatedAt, row.updatedAt);
-            }
-            for (const row of sessionRows) {
-              updatedAt = maxIso(updatedAt, row.updatedAt);
-            }
-            for (const row of latestTurnRows) {
-              updatedAt = maxIso(updatedAt, row.requestedAt);
-              if (row.startedAt !== null) {
-                updatedAt = maxIso(updatedAt, row.startedAt);
+          ]),
+        )
+        .pipe(
+          Effect.flatMap(([projectRows, threadRows, sessionRows, latestTurnRows, stateRows]) =>
+            Effect.gen(function* () {
+              let updatedAt: string | null = null;
+              for (const row of projectRows) {
+                updatedAt = maxIso(updatedAt, row.updatedAt);
               }
-              if (row.completedAt !== null) {
-                updatedAt = maxIso(updatedAt, row.completedAt);
+              for (const row of threadRows) {
+                updatedAt = maxIso(updatedAt, row.updatedAt);
+              }
+              for (const row of sessionRows) {
+                updatedAt = maxIso(updatedAt, row.updatedAt);
+              }
+              for (const row of latestTurnRows) {
+                updatedAt = maxIso(updatedAt, row.requestedAt);
+                if (row.startedAt !== null) {
+                  updatedAt = maxIso(updatedAt, row.startedAt);
+                }
+                if (row.completedAt !== null) {
+                  updatedAt = maxIso(updatedAt, row.completedAt);
+                }
+              }
+              for (const row of stateRows) {
+                updatedAt = maxIso(updatedAt, row.updatedAt);
               }
-            }
-            for (const row of stateRows) {
-              updatedAt = maxIso(updatedAt, row.updatedAt);
-            }
 
-            const repositoryIdentities = yield* resolveRepositoryIdentitiesForProjects(projectRows);
-            const latestTurnByThread = new Map(
-              latestTurnRows.map((row) => [row.threadId, mapLatestTurn(row)] as const),
-            );
-            const sessionByThread = new Map(
-              sessionRows.map((row) => [row.threadId, mapSessionRow(row)] as const),
-            );
+              const latestTurnByThread = new Map(
+                latestTurnRows.map((row) => [row.threadId, mapLatestTurn(row)] as const),
+              );
+              const sessionByThread = new Map(
+                sessionRows.map((row) => [row.threadId, mapSessionRow(row)] as const),
+              );
 
-            const snapshot = {
-              snapshotSequence: computeSnapshotSequence(stateRows),
-              projects: Arr.filterMap(projectRows, (row) =>
-                row.deletedAt === null
-                  ? Result.succeed(
-                      mapProjectShellRow(row, repositoryIdentities.get(row.projectId) ?? null),
-                    )
-                  : Result.failVoid,
-              ),
-              threads: Arr.filterMap(threadRows, (row) =>
-                row.deletedAt === null
-                  ? Result.succeed({
-                      id: row.threadId,
-                      projectId: row.projectId,
-                      title: row.title,
-                      modelSelection: row.modelSelection,
-                      runtimeMode: row.runtimeMode,
-                      interactionMode: row.interactionMode,
-                      branch: row.branch,
-                      worktreePath: row.worktreePath,
-                      ...(row.linkedPullRequest === null
-                        ? {}
-                        : { linkedPullRequest: row.linkedPullRequest }),
-                      latestTurn: latestTurnByThread.get(row.threadId) ?? null,
-                      createdAt: row.createdAt,
-                      updatedAt: row.updatedAt,
-                      archivedAt: row.archivedAt,
-                      settledOverride: row.settledOverride,
-                      settledAt: row.settledAt,
-                      unsettledAt: row.unsettledAt,
-                      snoozedUntil: row.snoozedUntil,
-                      snoozedAt: row.snoozedAt,
-                      pinnedAt: row.pinnedAt,
-                      pinOrderKey: row.pinOrderKey ?? null,
-                      titleRegeneration: mapTitleRegeneration(row),
-                      session: sessionByThread.get(row.threadId) ?? null,
-                      latestUserMessageAt: row.latestUserMessageAt,
-                      hasPendingApprovals: row.pendingApprovalCount > 0,
-                      hasPendingUserInput: row.pendingUserInputCount > 0,
-                      hasActionableProposedPlan: row.hasActionableProposedPlan > 0,
-                      backgroundLiveness: threadBackgroundLiveness.getThreadBackgroundLiveness(
-                        row.threadId,
-                      ),
-                      planProgress: threadPlanProgress.getThreadPlanProgress(row.threadId),
-                    } satisfies OrchestrationThreadShell)
-                  : Result.failVoid,
-              ),
-              updatedAt: updatedAt ?? "1970-01-01T00:00:00.000Z",
-            };
+              const snapshot = {
+                snapshotSequence: computeSnapshotSequence(stateRows),
+                projects: Arr.filterMap(projectRows, (row) =>
+                  row.deletedAt === null
+                    ? Result.succeed(mapProjectShellRow(row, null))
+                    : Result.failVoid,
+                ),
+                threads: Arr.filterMap(threadRows, (row) =>
+                  row.deletedAt === null
+                    ? Result.succeed({
+                        id: row.threadId,
+                        projectId: row.projectId,
+                        title: row.title,
+                        modelSelection: row.modelSelection,
+                        runtimeMode: row.runtimeMode,
+                        interactionMode: row.interactionMode,
+                        branch: row.branch,
+                        worktreePath: row.worktreePath,
+                        latestTurn: latestTurnByThread.get(row.threadId) ?? null,
+                        createdAt: row.createdAt,
+                        updatedAt: row.updatedAt,
+                        archivedAt: row.archivedAt,
+                        settledOverride: row.settledOverride,
+                        settledAt: row.settledAt,
+                        snoozedUntil: row.snoozedUntil,
+                        snoozedAt: row.snoozedAt,
+                        titleRegeneration: mapTitleRegeneration(row),
+                        session: sessionByThread.get(row.threadId) ?? null,
+                        latestUserMessageAt: row.latestUserMessageAt,
+                        hasPendingApprovals: row.pendingApprovalCount > 0,
+                        hasPendingUserInput: row.pendingUserInputCount > 0,
+                        hasActionableProposedPlan: row.hasActionableProposedPlan > 0,
+                      } satisfies OrchestrationThreadShell)
+                    : Result.failVoid,
+                ),
+                updatedAt: updatedAt ?? "1970-01-01T00:00:00.000Z",
+              };
 
-            return yield* decodeShellSnapshot(snapshot).pipe(
-              Effect.mapError(
-                toPersistenceDecodeError(
-                  "ProjectionSnapshotQuery.getShellSnapshot:decodeShellSnapshot",
+              return yield* decodeShellSnapshot(snapshot).pipe(
+                Effect.mapError(
+                  toPersistenceDecodeError(
+                    "ProjectionSnapshotQuery.getShellSnapshot:decodeShellSnapshot",
+                  ),
                 ),
-              ),
-            );
+              );
+            }),
+          ),
+          Effect.mapError((error) => {
+            if (isPersistenceError(error)) {
+              return error;
+            }
+            return toPersistenceSqlError("ProjectionSnapshotQuery.getShellSnapshot:query")(error);
           }),
-        ),
-        Effect.mapError((error) => {
-          if (isPersistenceError(error)) {
-            return error;
-          }
-          return toPersistenceSqlError("ProjectionSnapshotQuery.getShellSnapshot:query")(error);
-        }),
-      );
+        );
+
+  const getShellSnapshot: ProjectionSnapshotQueryShape["getShellSnapshot"] = () =>
+    getShellSnapshotWithoutEnrichment().pipe(
+      Effect.flatMap((snapshot) =>
+        Effect.forEach(
+          snapshot.projects,
+          (project) =>
+            projectEnrichment.getAvailable(project.workspaceRoot).pipe(
+              Effect.map((enrichment) => ({
+                ...project,
+                repositoryIdentity: enrichment.repositoryIdentity,
+              })),
+            ),
+          { concurrency: 16 },
+        ).pipe(Effect.map((projects) => ({ ...snapshot, projects }))),
+      ),
+    );
 
   const getArchivedShellSnapshot: ProjectionSnapshotQueryShape["getArchivedShellSnapshot"] = () =>
     sql
@@ -2175,7 +2212,7 @@ const makeProjectionSnapshotQuery = Effect.gen(function* () {
             }
 
             const activeProjectIds = new Set(threadRows.map((row) => row.projectId));
-            const repositoryIdentities = yield* resolveRepositoryIdentitiesForProjects(
+            const repositoryIdentities = yield* getAvailableRepositoryIdentities(
               projectRows.filter((row) => activeProjectIds.has(row.projectId)),
             );
             const latestTurnByThread = new Map(
@@ -2204,16 +2241,12 @@ const makeProjectionSnapshotQuery = Effect.gen(function* () {
                   interactionMode: row.interactionMode,
                   branch: row.branch,
                   worktreePath: row.worktreePath,
-                  ...(row.linkedPullRequest === null
-                    ? {}
-                    : { linkedPullRequest: row.linkedPullRequest }),
                   latestTurn: latestTurnByThread.get(row.threadId) ?? null,
                   createdAt: row.createdAt,
                   updatedAt: row.updatedAt,
                   archivedAt: row.archivedAt,
                   settledOverride: row.settledOverride,
                   settledAt: row.settledAt,
-                  unsettledAt: row.unsettledAt,
                   snoozedUntil: row.snoozedUntil,
                   snoozedAt: row.snoozedAt,
                   pinnedAt: row.pinnedAt,
@@ -2319,13 +2352,13 @@ const makeProjectionSnapshotQuery = Effect.gen(function* () {
         Effect.flatMap((option) =>
           Option.isNone(option)
             ? Effect.succeed(Option.none<OrchestrationProject>())
-            : repositoryIdentityResolver.resolve(option.value.workspaceRoot).pipe(
-                Effect.map((repositoryIdentity) =>
+            : projectEnrichment.getAvailable(option.value.workspaceRoot).pipe(
+                Effect.map((enrichment) =>
                   Option.some({
                     id: option.value.projectId,
                     title: option.value.title,
                     workspaceRoot: option.value.workspaceRoot,
-                    repositoryIdentity,
+                    repositoryIdentity: enrichment.repositoryIdentity,
                     defaultModelSelection: option.value.defaultModelSelection,
                     defaultThreadEnvMode: option.value.defaultThreadEnvMode,
                     faviconPath: option.value.faviconPath ?? null,
@@ -2350,16 +2383,34 @@ const makeProjectionSnapshotQuery = Effect.gen(function* () {
       Effect.flatMap((option) =>
         Option.isNone(option)
           ? Effect.succeed(Option.none<OrchestrationProjectShell>())
-          : repositoryIdentityResolver
-              .resolve(option.value.workspaceRoot)
+          : projectEnrichment
+              .getAvailable(option.value.workspaceRoot)
               .pipe(
-                Effect.map((repositoryIdentity) =>
-                  Option.some(mapProjectShellRow(option.value, repositoryIdentity)),
+                Effect.map((enrichment) =>
+                  Option.some(mapProjectShellRow(option.value, enrichment.repositoryIdentity)),
                 ),
               ),
       ),
     );
 
+  const getProjectShellsWithoutEnrichment: ProjectionSnapshotQueryShape["getProjectShellsWithoutEnrichment"] =
+    () =>
+      listProjectRows(undefined).pipe(
+        Effect.mapError(
+          toPersistenceSqlOrDecodeError(
+            "ProjectionSnapshotQuery.getProjectShellsWithoutEnrichment:query",
+            "ProjectionSnapshotQuery.getProjectShellsWithoutEnrichment:decodeRows",
+          ),
+        ),
+        Effect.map((rows) =>
+          Arr.filterMap(rows, (row) =>
+            row.deletedAt === null
+              ? Result.succeed(mapProjectShellRow(row, null))
+              : Result.failVoid,
+          ),
+        ),
+      );
+
   const getFirstActiveThreadIdByProjectId: ProjectionSnapshotQueryShape["getFirstActiveThreadIdByProjectId"] =
     (projectId) =>
       getFirstActiveThreadIdByProject({ projectId }).pipe(
@@ -2487,16 +2538,12 @@ const makeProjectionSnapshotQuery = Effect.gen(function* () {
         interactionMode: threadRow.value.interactionMode,
         branch: threadRow.value.branch,
         worktreePath: threadRow.value.worktreePath,
-        ...(threadRow.value.linkedPullRequest === null
-          ? {}
-          : { linkedPullRequest: threadRow.value.linkedPullRequest }),
         latestTurn: Option.isSome(latestTurnRow) ? mapLatestTurn(latestTurnRow.value) : null,
         createdAt: threadRow.value.createdAt,
         updatedAt: threadRow.value.updatedAt,
         archivedAt: threadRow.value.archivedAt,
         settledOverride: threadRow.value.settledOverride,
         settledAt: threadRow.value.settledAt,
-        unsettledAt: threadRow.value.unsettledAt,
         snoozedUntil: threadRow.value.snoozedUntil,
         snoozedAt: threadRow.value.snoozedAt,
         pinnedAt: threadRow.value.pinnedAt,
@@ -2632,16 +2679,12 @@ const makeProjectionSnapshotQuery = Effect.gen(function* () {
         interactionMode: threadRow.value.interactionMode,
         branch: threadRow.value.branch,
         worktreePath: threadRow.value.worktreePath,
-        ...(threadRow.value.linkedPullRequest === null
-          ? {}
-          : { linkedPullRequest: threadRow.value.linkedPullRequest }),
         latestTurn: Option.isSome(latestTurnRow) ? mapLatestTurn(latestTurnRow.value) : null,
         createdAt: threadRow.value.createdAt,
         updatedAt: threadRow.value.updatedAt,
         archivedAt: threadRow.value.archivedAt,
         settledOverride: threadRow.value.settledOverride,
         settledAt: threadRow.value.settledAt,
-        unsettledAt: threadRow.value.unsettledAt,
         snoozedUntil: threadRow.value.snoozedUntil,
         snoozedAt: threadRow.value.snoozedAt,
         pinnedAt: threadRow.value.pinnedAt,
@@ -2849,12 +2892,14 @@ const makeProjectionSnapshotQuery = Effect.gen(function* () {
     getCommandReadModel,
     getSnapshot,
     getShellSnapshot,
+    getShellSnapshotWithoutEnrichment,
     getArchivedShellSnapshot,
     searchThreads,
     getSnapshotSequence,
     getCounts,
     getActiveProjectByWorkspaceRoot,
     getProjectShellById,
+    getProjectShellsWithoutEnrichment,
     getFirstActiveThreadIdByProjectId,
     getThreadCheckpointContext,
     getFullThreadDiffContext,
diff --git a/apps/server/src/orchestration/Layers/ProviderCommandReactor.test.ts b/apps/server/src/orchestration/Layers/ProviderCommandReactor.test.ts
deleted file mode 100644
index 4ad35e54cca8..000000000000
--- a/apps/server/src/orchestration/Layers/ProviderCommandReactor.test.ts
+++ /dev/null
@@ -1,3232 +0,0 @@
-// @effect-diagnostics nodeBuiltinImport:off
-import * as NodeFS from "node:fs";
-import * as NodeOS from "node:os";
-import * as NodePath from "node:path";
-
-import {
-  ModelSelection,
-  ProviderRuntimeEvent,
-  ProviderSession,
-  ProviderDriverKind,
-  ProviderInstanceId,
-} from "@t3tools/contracts";
-import { createModelSelection } from "@t3tools/shared/model";
-import {
-  ApprovalRequestId,
-  CommandId,
-  DEFAULT_PROVIDER_INTERACTION_MODE,
-  EventId,
-  MessageId,
-  ProjectId,
-  ThreadId,
-  TurnId,
-} from "@t3tools/contracts";
-import * as Effect from "effect/Effect";
-import * as Deferred from "effect/Deferred";
-import * as Exit from "effect/Exit";
-import * as Layer from "effect/Layer";
-import * as ManagedRuntime from "effect/ManagedRuntime";
-import * as PubSub from "effect/PubSub";
-import * as Scope from "effect/Scope";
-import * as Stream from "effect/Stream";
-import { it as effectIt } from "@effect/vitest";
-import { afterEach, describe, expect, it, vi } from "vite-plus/test";
-
-import { deriveServerPaths, ServerConfig } from "../../config.ts";
-import { TextGenerationError } from "@t3tools/contracts";
-import { ProviderAdapterRequestError } from "../../provider/Errors.ts";
-import { OrchestrationEventStoreLive } from "../../persistence/Layers/OrchestrationEventStore.ts";
-import { OrchestrationCommandReceiptRepositoryLive } from "../../persistence/Layers/OrchestrationCommandReceipts.ts";
-import { SqlitePersistenceMemory } from "../../persistence/Layers/Sqlite.ts";
-import {
-  ProviderService,
-  type ProviderServiceShape,
-} from "../../provider/Services/ProviderService.ts";
-import { makeProviderRegistryLayer } from "../../provider/testUtils/providerRegistryMock.ts";
-import { TextGeneration, type TextGenerationShape } from "../../textGeneration/TextGeneration.ts";
-import * as RepositoryIdentityResolver from "../../project/RepositoryIdentityResolver.ts";
-import { OrchestrationEngineLive } from "./OrchestrationEngine.ts";
-import { OrchestrationProjectionPipelineLive } from "./ProjectionPipeline.ts";
-import { OrchestrationProjectionSnapshotQueryLive } from "./ProjectionSnapshotQuery.ts";
-import * as ThreadBackgroundLiveness from "../ThreadBackgroundLiveness.ts";
-import * as ThreadPlanProgress from "../ThreadPlanProgress.ts";
-import {
-  providerErrorLabel,
-  providerErrorLabelFromInstanceHint,
-  ProviderCommandReactorLive,
-} from "./ProviderCommandReactor.ts";
-import { OrchestrationEngineService } from "../Services/OrchestrationEngine.ts";
-import { ProviderCommandReactor } from "../Services/ProviderCommandReactor.ts";
-import { ProjectionSnapshotQuery } from "../Services/ProjectionSnapshotQuery.ts";
-import * as NodeServices from "@effect/platform-node/NodeServices";
-import * as Clock from "effect/Clock";
-import { ServerSettingsService } from "../../serverSettings.ts";
-import { VcsStatusBroadcaster } from "../../vcs/VcsStatusBroadcaster.ts";
-import * as GitWorkflowService from "../../git/GitWorkflowService.ts";
-
-const asProjectId = (value: string): ProjectId => ProjectId.make(value);
-const asApprovalRequestId = (value: string): ApprovalRequestId => ApprovalRequestId.make(value);
-const asMessageId = (value: string): MessageId => MessageId.make(value);
-const asTurnId = (value: string): TurnId => TurnId.make(value);
-
-const deriveServerPathsSync = (baseDir: string, devUrl: URL | undefined) =>
-  Effect.runSync(deriveServerPaths(baseDir, devUrl).pipe(Effect.provide(NodeServices.layer)));
-
-async function waitFor(
-  predicate: () => boolean | Promise<boolean>,
-  timeoutMs = 10_000,
-): Promise<void> {
-  const deadline = (await Effect.runPromise(Clock.currentTimeMillis)) + timeoutMs;
-  const poll = async (): Promise<void> => {
-    if (await predicate()) {
-      return;
-    }
-    if ((await Effect.runPromise(Clock.currentTimeMillis)) >= deadline) {
-      throw new Error("Timed out waiting for expectation.");
-    }
-    await Effect.runPromise(Effect.yieldNow);
-    return poll();
-  };
-
-  return poll();
-}
-
-describe("ProviderCommandReactor", () => {
-  let runtime: ManagedRuntime.ManagedRuntime<
-    OrchestrationEngineService | ProviderCommandReactor | ProjectionSnapshotQuery,
-    unknown
-  > | null = null;
-  let scope: Scope.Closeable | null = null;
-  const createdStateDirs = new Set<string>();
-  const createdBaseDirs = new Set<string>();
-
-  afterEach(async () => {
-    if (scope) {
-      await Effect.runPromise(Scope.close(scope, Exit.void));
-    }
-    scope = null;
-    if (runtime) {
-      await runtime.dispose();
-    }
-    runtime = null;
-    for (const stateDir of createdStateDirs) {
-      NodeFS.rmSync(stateDir, { recursive: true, force: true });
-    }
-    createdStateDirs.clear();
-    for (const baseDir of createdBaseDirs) {
-      NodeFS.rmSync(baseDir, { recursive: true, force: true });
-    }
-    createdBaseDirs.clear();
-  });
-
-  describe("provider error attribution", () => {
-    it("uses the current provider instance slug when current instance lookup fails", () => {
-      expect(
-        providerErrorLabelFromInstanceHint({
-          instanceId: "codex_personal",
-          modelSelectionInstanceId: "codex",
-          sessionProvider: "codex",
-        }),
-      ).toBe("codex_personal");
-    });
-
-    it("uses the desired provider instance slug when desired instance lookup fails", () => {
-      expect(
-        providerErrorLabelFromInstanceHint({
-          instanceId: "claude_openrouter",
-        }),
-      ).toBe("claude_openrouter");
-    });
-
-    it("uses the unknown driver kind when the resolved driver is not registered locally", () => {
-      expect(providerErrorLabel("third_party_driver")).toBe("third_party_driver");
-    });
-  });
-
-  async function createHarness(input?: {
-    readonly baseDir?: string;
-    readonly threadModelSelection?: ModelSelection;
-    readonly sessionModelSwitch?: "unsupported" | "in-session";
-    readonly requiresNewThreadForModelChange?: boolean;
-    readonly titleRegenerationCompletionDispatchFailures?: number;
-    readonly titleRegenerationBeforeStart?: "one" | "two";
-    readonly interruptTurnEffect?: () => Effect.Effect<void, ProviderAdapterRequestError>;
-    readonly stopSessionEffect?: () => Effect.Effect<void, ProviderAdapterRequestError>;
-    readonly startSessionEffect?: (
-      session: ProviderSession,
-    ) => Effect.Effect<ProviderSession, ProviderAdapterRequestError>;
-  }) {
-    const now = "2026-01-01T00:00:00.000Z";
-    const baseDir =
-      input?.baseDir ?? NodeFS.mkdtempSync(NodePath.join(NodeOS.tmpdir(), "t3code-reactor-"));
-    createdBaseDirs.add(baseDir);
-    const { stateDir } = deriveServerPathsSync(baseDir, undefined);
-    createdStateDirs.add(stateDir);
-    const runtimeEventPubSub = Effect.runSync(PubSub.unbounded<ProviderRuntimeEvent>());
-    let nextSessionIndex = 1;
-    const runtimeSessions: Array<ProviderSession> = [];
-    const modelSelection = input?.threadModelSelection ?? {
-      instanceId: ProviderInstanceId.make("codex"),
-      model: "gpt-5-codex",
-    };
-    const startSessionEffect = input?.startSessionEffect;
-    const startSession = vi.fn((_: unknown, input: unknown) => {
-      const sessionIndex = nextSessionIndex++;
-      const resumeCursor =
-        typeof input === "object" && input !== null && "resumeCursor" in input
-          ? input.resumeCursor
-          : undefined;
-      const threadId =
-        typeof input === "object" &&
-        input !== null &&
-        "threadId" in input &&
-        typeof input.threadId === "string"
-          ? ThreadId.make(input.threadId)
-          : ThreadId.make(`thread-${sessionIndex}`);
-      const inputModelSelection =
-        typeof input === "object" && input !== null && "modelSelection" in input
-          ? (input.modelSelection as ModelSelection | undefined)
-          : undefined;
-      const providerInstanceId =
-        typeof input === "object" && input !== null && "providerInstanceId" in input
-          ? (input.providerInstanceId as ProviderInstanceId | undefined)
-          : inputModelSelection?.instanceId;
-      const provider =
-        typeof input === "object" &&
-        input !== null &&
-        "provider" in input &&
-        typeof input.provider === "string"
-          ? (input.provider as ProviderSession["provider"])
-          : ProviderDriverKind.make(inputModelSelection?.instanceId ?? modelSelection.instanceId);
-      const session: ProviderSession = {
-        provider,
-        ...(providerInstanceId ? { providerInstanceId } : {}),
-        status: "ready" as const,
-        runtimeMode:
-          typeof input === "object" &&
-          input !== null &&
-          "runtimeMode" in input &&
-          (input.runtimeMode === "approval-required" || input.runtimeMode === "full-access")
-            ? input.runtimeMode
-            : "full-access",
-        ...(typeof input === "object" &&
-        input !== null &&
-        "cwd" in input &&
-        typeof input.cwd === "string"
-          ? { cwd: input.cwd }
-          : {}),
-        ...((inputModelSelection?.model ?? modelSelection.model)
-          ? { model: inputModelSelection?.model ?? modelSelection.model }
-          : {}),
-        threadId,
-        resumeCursor: resumeCursor ?? { opaque: `resume-${sessionIndex}` },
-        createdAt: now,
-        updatedAt: now,
-      };
-      return (startSessionEffect?.(session) ?? Effect.succeed(session)).pipe(
-        Effect.tap((startedSession) =>
-          Effect.sync(() => {
-            runtimeSessions.push(startedSession);
-          }),
-        ),
-      );
-    });
-    const sendTurn = vi.fn((_: unknown) =>
-      Effect.succeed({
-        threadId: ThreadId.make("thread-1"),
-        turnId: asTurnId("turn-1"),
-      }),
-    );
-    const interruptTurn = vi.fn((_: unknown) => input?.interruptTurnEffect?.() ?? Effect.void);
-    const respondToRequest = vi.fn<ProviderServiceShape["respondToRequest"]>(() => Effect.void);
-    const respondToUserInput = vi.fn<ProviderServiceShape["respondToUserInput"]>(() => Effect.void);
-    const stopSession = vi.fn((stopInput: unknown) =>
-      (input?.stopSessionEffect?.() ?? Effect.void).pipe(
-        Effect.tap(() =>
-          Effect.sync(() => {
-            const threadId =
-              typeof stopInput === "object" && stopInput !== null && "threadId" in stopInput
-                ? (stopInput as { threadId?: ThreadId }).threadId
-                : undefined;
-            if (!threadId) {
-              return;
-            }
-            const index = runtimeSessions.findIndex((session) => session.threadId === threadId);
-            if (index >= 0) {
-              runtimeSessions.splice(index, 1);
-            }
-          }),
-        ),
-      ),
-    );
-    const renameBranch = vi.fn((input: unknown) =>
-      Effect.succeed({
-        branch:
-          typeof input === "object" &&
-          input !== null &&
-          "newBranch" in input &&
-          typeof input.newBranch === "string"
-            ? input.newBranch
-            : "renamed-branch",
-      }),
-    );
-    const pruneWorktrees = vi.fn((_: { readonly cwd: string }) => Effect.void);
-    const createWorktree = vi.fn(
-      (input: { readonly refName: string; readonly path: string | null }) =>
-        Effect.succeed({ worktree: { path: input.path ?? "", refName: input.refName } }),
-    );
-    const refreshStatus = vi.fn((_: string) =>
-      Effect.succeed({
-        isRepo: true,
-        hasPrimaryRemote: true,
-        isDefaultRef: false,
-        refName: "renamed-branch",
-        hasWorkingTreeChanges: false,
-        workingTree: {
-          files: [],
-          insertions: 0,
-          deletions: 0,
-        },
-        hasUpstream: true,
-        aheadCount: 0,
-        behindCount: 0,
-        pr: null,
-      }),
-    );
-    const generateBranchName = vi.fn<TextGenerationShape["generateBranchName"]>((_) =>
-      Effect.fail(
-        new TextGenerationError({
-          operation: "generateBranchName",
-          detail: "disabled in test harness",
-        }),
-      ),
-    );
-    const generateThreadTitle = vi.fn<TextGenerationShape["generateThreadTitle"]>((_) =>
-      Effect.fail(
-        new TextGenerationError({
-          operation: "generateThreadTitle",
-          detail: "disabled in test harness",
-        }),
-      ),
-    );
-    const providerSnapshots = [
-      {
-        instanceId: modelSelection.instanceId,
-        ...(input?.requiresNewThreadForModelChange === true
-          ? { requiresNewThreadForModelChange: true }
-          : {}),
-      },
-    ];
-
-    const unsupported = () => Effect.die(new Error("Unsupported provider call in test")) as never;
-    const service: ProviderServiceShape = {
-      startSession: startSession as ProviderServiceShape["startSession"],
-      sendTurn: sendTurn as ProviderServiceShape["sendTurn"],
-      interruptTurn: interruptTurn as ProviderServiceShape["interruptTurn"],
-      respondToRequest: respondToRequest as ProviderServiceShape["respondToRequest"],
-      respondToUserInput: respondToUserInput as ProviderServiceShape["respondToUserInput"],
-      stopSession: stopSession as ProviderServiceShape["stopSession"],
-      listSessions: () => Effect.succeed(runtimeSessions),
-      getCapabilities: (_provider) =>
-        Effect.succeed({
-          sessionModelSwitch: input?.sessionModelSwitch ?? "in-session",
-        }),
-      getInstanceInfo: (instanceId) => {
-        const raw = String(instanceId);
-        const driverKind = ProviderDriverKind.make(
-          raw.startsWith("claude") ? "claudeAgent" : raw.startsWith("codex") ? "codex" : raw,
-        );
-        return Effect.succeed({
-          instanceId,
-          driverKind,
-          displayName: undefined,
-          enabled: true,
-          continuationIdentity: {
-            driverKind,
-            continuationKey:
-              driverKind === ProviderDriverKind.make("codex")
-                ? "codex:home:/shared-codex"
-                : `${driverKind}:instance:${instanceId}`,
-          },
-        });
-      },
-      rollbackConversation: () => unsupported(),
-      uploadFeedback: () => unsupported(),
-      get streamEvents() {
-        return Stream.fromPubSub(runtimeEventPubSub);
-      },
-    };
-
-    const orchestrationLayer = OrchestrationEngineLive.pipe(
-      Layer.provide(OrchestrationProjectionSnapshotQueryLive),
-      Layer.provide(ThreadBackgroundLiveness.layer),
-      Layer.provide(ThreadPlanProgress.layer),
-      Layer.provide(OrchestrationProjectionPipelineLive),
-      Layer.provide(OrchestrationEventStoreLive),
-      Layer.provide(OrchestrationCommandReceiptRepositoryLive),
-      Layer.provide(RepositoryIdentityResolver.layer),
-      Layer.provide(SqlitePersistenceMemory),
-    );
-    const projectionSnapshotLayer = OrchestrationProjectionSnapshotQueryLive.pipe(
-      Layer.provide(ThreadBackgroundLiveness.layer),
-      Layer.provide(ThreadPlanProgress.layer),
-      Layer.provide(RepositoryIdentityResolver.layer),
-      Layer.provide(SqlitePersistenceMemory),
-    );
-    let titleRegenerationCompletionDispatchAttempts = 0;
-    const reactorOrchestrationLayer = Layer.effect(
-      OrchestrationEngineService,
-      Effect.gen(function* () {
-        const engine = yield* OrchestrationEngineService;
-        return {
-          readEvents: engine.readEvents,
-          dispatch: (command) => {
-            if (command.type === "thread.title.regeneration.complete") {
-              titleRegenerationCompletionDispatchAttempts += 1;
-              if (
-                titleRegenerationCompletionDispatchAttempts <=
-                (input?.titleRegenerationCompletionDispatchFailures ?? 0)
-              ) {
-                return Effect.die(new Error("Injected title regeneration completion failure"));
-              }
-            }
-            return engine.dispatch(command);
-          },
-          get streamDomainEvents() {
-            return engine.streamDomainEvents;
-          },
-          latestSequence: engine.latestSequence,
-        } satisfies OrchestrationEngineService["Service"];
-      }),
-    ).pipe(Layer.provide(orchestrationLayer));
-    const layer = ProviderCommandReactorLive.pipe(
-      Layer.provideMerge(reactorOrchestrationLayer),
-      Layer.provideMerge(projectionSnapshotLayer),
-      Layer.provideMerge(Layer.succeed(ProviderService, service)),
-      Layer.provideMerge(makeProviderRegistryLayer(providerSnapshots as never)),
-      Layer.provideMerge(
-        Layer.mock(GitWorkflowService.GitWorkflowService)({
-          renameBranch,
-          pruneWorktrees,
-          createWorktree,
-        } satisfies Partial<GitWorkflowService.GitWorkflowService["Service"]>),
-      ),
-      Layer.provideMerge(
-        Layer.succeed(VcsStatusBroadcaster, {
-          getStatus: () => Effect.die("getStatus should not be called in this test"),
-          refreshLocalStatus: () =>
-            Effect.die("refreshLocalStatus should not be called in this test"),
-          refreshStatus,
-          streamStatus: () => Stream.die("streamStatus should not be called in this test"),
-        }),
-      ),
-      Layer.provideMerge(
-        Layer.mock(TextGeneration, {
-          generateBranchName,
-          generateThreadTitle,
-        }),
-      ),
-      Layer.provideMerge(ServerSettingsService.layerTest()),
-      Layer.provideMerge(ServerConfig.layerTest(process.cwd(), baseDir)),
-      Layer.provideMerge(NodeServices.layer),
-    );
-    runtime = ManagedRuntime.make(layer);
-
-    const engine = await runtime.runPromise(Effect.service(OrchestrationEngineService));
-    const snapshotQuery = await runtime.runPromise(Effect.service(ProjectionSnapshotQuery));
-    const reactor = await runtime.runPromise(Effect.service(ProviderCommandReactor));
-    const runEffect = <A, E>(effect: Effect.Effect<A, E>) => runtime!.runPromise(effect);
-
-    await Effect.runPromise(
-      engine.dispatch({
-        type: "project.create",
-        commandId: CommandId.make("cmd-project-create"),
-        projectId: asProjectId("project-1"),
-        title: "Provider Project",
-        workspaceRoot: "/tmp/provider-project",
-        defaultModelSelection: modelSelection,
-        createdAt: now,
-      }),
-    );
-    await Effect.runPromise(
-      engine.dispatch({
-        type: "thread.create",
-        commandId: CommandId.make("cmd-thread-create"),
-        threadId: ThreadId.make("thread-1"),
-        projectId: asProjectId("project-1"),
-        title: "Thread",
-        modelSelection: modelSelection,
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        branch: null,
-        worktreePath: null,
-        createdAt: now,
-      }),
-    );
-    if (input?.titleRegenerationBeforeStart === "two") {
-      await Effect.runPromise(
-        engine.dispatch({
-          type: "thread.create",
-          commandId: CommandId.make("cmd-thread-create-2"),
-          threadId: ThreadId.make("thread-2"),
-          projectId: asProjectId("project-1"),
-          title: "Thread 2",
-          modelSelection: modelSelection,
-          interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-          runtimeMode: "approval-required",
-          branch: null,
-          worktreePath: null,
-          createdAt: now,
-        }),
-      );
-    }
-    const titleRegenerationThreadIds =
-      input?.titleRegenerationBeforeStart === "two"
-        ? [ThreadId.make("thread-1"), ThreadId.make("thread-2")]
-        : input?.titleRegenerationBeforeStart === "one"
-          ? [ThreadId.make("thread-1")]
-          : [];
-    for (const [index, threadId] of titleRegenerationThreadIds.entries()) {
-      await Effect.runPromise(
-        engine.dispatch({
-          type: "thread.meta.update",
-          commandId: CommandId.make(
-            `cmd-thread-title-regeneration-before-reactor-start-${index + 1}`,
-          ),
-          threadId,
-          regenerateTitle: true,
-        }),
-      );
-    }
-
-    scope = await Effect.runPromise(Scope.make("sequential"));
-    await Effect.runPromise(reactor.start().pipe(Scope.provide(scope)));
-    const drain = () => Effect.runPromise(reactor.drain);
-
-    return {
-      engine,
-      readModel: () => Effect.runPromise(snapshotQuery.getSnapshot()),
-      startSession,
-      sendTurn,
-      interruptTurn,
-      respondToRequest,
-      respondToUserInput,
-      stopSession,
-      renameBranch,
-      pruneWorktrees,
-      createWorktree,
-      refreshStatus,
-      generateBranchName,
-      generateThreadTitle,
-      runtimeSessions,
-      stateDir,
-      drain,
-      runEffect,
-      get titleRegenerationCompletionDispatchAttempts() {
-        return titleRegenerationCompletionDispatchAttempts;
-      },
-    };
-  }
-
-  it("reacts to thread.turn.start by ensuring session and sending provider turn", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-1"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-1"),
-          role: "user",
-          text: "hello reactor",
-          attachments: [],
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(() => harness.startSession.mock.calls.length === 1);
-    await waitFor(() => harness.sendTurn.mock.calls.length === 1);
-    expect(harness.startSession.mock.calls[0]?.[0]).toEqual(ThreadId.make("thread-1"));
-    expect(harness.startSession.mock.calls[0]?.[1]).toMatchObject({
-      cwd: "/tmp/provider-project",
-      modelSelection: {
-        instanceId: ProviderInstanceId.make("codex"),
-        model: "gpt-5-codex",
-      },
-      runtimeMode: "approval-required",
-    });
-
-    const readModel = await harness.readModel();
-    const thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    expect(thread?.session?.threadId).toBe("thread-1");
-    expect(thread?.session?.status).toBe("starting");
-    expect(thread?.session?.runtimeMode).toBe("approval-required");
-  });
-
-  effectIt.effect("projects starting before a slow provider session finishes", () =>
-    Effect.gen(function* () {
-      const releaseStart = yield* Deferred.make<void>();
-      const harness = yield* Effect.promise(() =>
-        createHarness({
-          startSessionEffect: (session) => Deferred.await(releaseStart).pipe(Effect.as(session)),
-        }),
-      );
-      const now = "2026-01-01T00:00:00.000Z";
-
-      yield* harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-slow-provider"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-slow-provider"),
-          role: "user",
-          text: "start slowly",
-          attachments: [],
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      });
-
-      yield* Effect.promise(() => waitFor(() => harness.startSession.mock.calls.length === 1));
-      const duringStartup = yield* Effect.promise(() => harness.readModel());
-      expect(
-        duringStartup.threads.find((entry) => entry.id === ThreadId.make("thread-1"))?.session
-          ?.status,
-      ).toBe("starting");
-      expect(harness.sendTurn).not.toHaveBeenCalled();
-
-      yield* Deferred.succeed(releaseStart, undefined);
-      yield* Effect.promise(() => waitFor(() => harness.sendTurn.mock.calls.length === 1));
-    }),
-  );
-
-  effectIt.effect("settles a failed provider startup and allows a clean retry", () =>
-    Effect.gen(function* () {
-      let failStartup = true;
-      const harness = yield* Effect.promise(() =>
-        createHarness({
-          startSessionEffect: (session) =>
-            failStartup
-              ? Effect.fail(
-                  new ProviderAdapterRequestError({
-                    provider: "codex",
-                    method: "thread.start",
-                    detail: "deterministic startup failure",
-                  }),
-                )
-              : Effect.succeed(session),
-        }),
-      );
-      const now = "2026-01-01T00:00:00.000Z";
-
-      yield* harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-provider-failure"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-provider-failure"),
-          role: "user",
-          text: "fail once",
-          attachments: [],
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      });
-
-      yield* Effect.promise(() =>
-        waitFor(async () => {
-          const readModel = await harness.readModel();
-          return (
-            readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"))?.session
-              ?.status === "error"
-          );
-        }),
-      );
-      let readModel = yield* Effect.promise(() => harness.readModel());
-      let thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-      expect(thread?.session?.lastError).toContain("deterministic startup failure");
-      expect(harness.sendTurn).not.toHaveBeenCalled();
-
-      failStartup = false;
-      yield* harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-provider-retry"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-provider-retry"),
-          role: "user",
-          text: "retry",
-          attachments: [],
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: "2026-01-01T00:00:01.000Z",
-      });
-
-      yield* Effect.promise(() => waitFor(() => harness.sendTurn.mock.calls.length === 1));
-      readModel = yield* Effect.promise(() => harness.readModel());
-      thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-      expect(thread?.session?.status).toBe("starting");
-      expect(thread?.session?.lastError).toBeNull();
-    }),
-  );
-
-  it("retries thread title generation after a transient failure", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-    const seededTitle = "Please investigate reconnect failures after restar...";
-    let attempts = 0;
-    harness.generateThreadTitle.mockReturnValue(
-      Effect.suspend(() => {
-        attempts += 1;
-        return attempts === 1
-          ? Effect.fail(
-              new TextGenerationError({
-                operation: "generateThreadTitle",
-                detail: "Claude CLI request timed out.",
-              }),
-            )
-          : Effect.succeed({ title: "Generated title" });
-      }),
-    );
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.meta.update",
-        commandId: CommandId.make("cmd-thread-title-seed"),
-        threadId: ThreadId.make("thread-1"),
-        title: seededTitle,
-      }),
-    );
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-title"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-title"),
-          role: "user",
-          text: "Please investigate reconnect failures after restarting the session.",
-          attachments: [],
-        },
-        titleSeed: seededTitle,
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(() => harness.generateThreadTitle.mock.calls.length === 1);
-    expect(harness.generateThreadTitle.mock.calls[0]?.[0]).toMatchObject({
-      message: "Please investigate reconnect failures after restarting the session.",
-    });
-
-    await waitFor(async () => {
-      const readModel = await harness.readModel();
-      return (
-        readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"))?.title ===
-        "Generated title"
-      );
-    });
-    const readModel = await harness.readModel();
-    const thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    expect(thread?.title).toBe("Generated title");
-    expect(attempts).toBe(2);
-  });
-
-  it("regenerates a thread title from the current conversation", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-    harness.generateThreadTitle.mockReturnValue(
-      Effect.succeed({ title: "Resolve stale reconnect state" }),
-    );
-
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.meta.update",
-        commandId: CommandId.make("cmd-thread-title-existing"),
-        threadId: ThreadId.make("thread-1"),
-        title: "Investigate reconnect regressions",
-      }),
-    );
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-before-title-regeneration"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-before-title-regeneration"),
-          role: "user",
-          text: "Please investigate reconnect regressions after restarting the session.",
-          attachments: [],
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.message.assistant.delta",
-        commandId: CommandId.make("cmd-assistant-before-title-regeneration"),
-        threadId: ThreadId.make("thread-1"),
-        messageId: asMessageId("assistant-message-before-title-regeneration"),
-        delta: "The remaining issue is stale reconnect state.",
-        createdAt: "2026-01-01T00:00:01.000Z",
-      }),
-    );
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.message.assistant.complete",
-        commandId: CommandId.make("cmd-assistant-complete-before-title-regeneration"),
-        threadId: ThreadId.make("thread-1"),
-        messageId: asMessageId("assistant-message-before-title-regeneration"),
-        createdAt: "2026-01-01T00:00:02.000Z",
-      }),
-    );
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.meta.update",
-        commandId: CommandId.make("cmd-thread-title-regenerate"),
-        threadId: ThreadId.make("thread-1"),
-        regenerateTitle: true,
-      }),
-    );
-
-    await harness.drain();
-
-    expect(harness.generateThreadTitle).toHaveBeenCalledTimes(1);
-    expect(harness.generateThreadTitle.mock.calls[0]?.[0]).toMatchObject({
-      cwd: "/tmp/provider-project",
-      previousTitle: "Investigate reconnect regressions",
-      message: [
-        "USER:",
-        "Please investigate reconnect regressions after restarting the session.",
-        "",
-        "ASSISTANT:",
-        "The remaining issue is stale reconnect state.",
-      ].join("\n"),
-    });
-    const readModel = await harness.readModel();
-    const thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    expect(thread?.title).toBe("Resolve stale reconnect state");
-    expect(thread?.titleRegeneration).toBeNull();
-  });
-
-  it("pins the first user message when regeneration context is truncated", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-    const firstUserMessage = `Review subagent monitoring risks. ${"Opening context. ".repeat(200)}`;
-    const recentUserMessage = `LATEST FINDING: ${"implementation detail ".repeat(320)}`;
-    harness.generateThreadTitle.mockReturnValue(
-      Effect.succeed({ title: "Review subagent monitoring risks" }),
-    );
-
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.meta.update",
-        commandId: CommandId.make("cmd-thread-title-existing-long"),
-        threadId: ThreadId.make("thread-1"),
-        title: "Generic PR review",
-      }),
-    );
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-before-long-title-regeneration"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-before-long-title-regeneration"),
-          role: "user",
-          text: firstUserMessage,
-          attachments: [
-            {
-              type: "image",
-              id: "opening-context-image",
-              name: "image.png",
-              mimeType: "image/png",
-              sizeBytes: 5,
-            },
-          ],
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-middle-turn-before-long-title-regeneration"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("middle-message-before-long-title-regeneration"),
-          role: "user",
-          text: "Temporary handoff details.",
-          attachments: [
-            {
-              type: "image",
-              id: "middle-context-image",
-              name: "image.png",
-              mimeType: "image/png",
-              sizeBytes: 5,
-            },
-          ],
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: "2026-01-01T00:00:01.000Z",
-      }),
-    );
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-recent-turn-before-long-title-regeneration"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("recent-message-before-long-title-regeneration"),
-          role: "user",
-          text: recentUserMessage,
-          attachments: [
-            {
-              type: "image",
-              id: "recent-context-image",
-              name: "image.png",
-              mimeType: "image/png",
-              sizeBytes: 5,
-            },
-          ],
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: "2026-01-01T00:00:02.000Z",
-      }),
-    );
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.meta.update",
-        commandId: CommandId.make("cmd-thread-title-regenerate-long"),
-        threadId: ThreadId.make("thread-1"),
-        regenerateTitle: true,
-      }),
-    );
-
-    await harness.drain();
-
-    expect(harness.generateThreadTitle).toHaveBeenCalledTimes(1);
-    const input = harness.generateThreadTitle.mock.calls[0]?.[0];
-    if (!input) {
-      throw new Error("Expected a title generation input");
-    }
-    const message = input.message;
-    expect(message.startsWith("USER:\nReview subagent monitoring risks.")).toBe(true);
-    expect(message).toContain("[First user message truncated]");
-    expect(message).toContain("[Earlier content truncated]");
-    expect(message).toContain("image.png");
-    expect(message).toHaveLength(8_000);
-    expect(input.attachments?.map((attachment) => attachment.id)).toEqual([
-      "opening-context-image",
-      "recent-context-image",
-    ]);
-  });
-
-  it("clears title regeneration state left pending across reactor startup", async () => {
-    const harness = await createHarness({
-      titleRegenerationBeforeStart: "one",
-    });
-
-    expect(harness.generateThreadTitle).not.toHaveBeenCalled();
-    expect(harness.titleRegenerationCompletionDispatchAttempts).toBe(1);
-    const readModel = await harness.readModel();
-    const thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    expect(thread?.title).toBe("Thread");
-    expect(thread?.titleRegeneration).toBeNull();
-  });
-
-  it("continues clearing startup title regeneration state after one completion fails", async () => {
-    const harness = await createHarness({
-      titleRegenerationBeforeStart: "two",
-      titleRegenerationCompletionDispatchFailures: 1,
-    });
-
-    expect(harness.generateThreadTitle).not.toHaveBeenCalled();
-    expect(harness.titleRegenerationCompletionDispatchAttempts).toBe(2);
-    const readModel = await harness.readModel();
-    expect(
-      readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"))?.titleRegeneration,
-    ).not.toBeNull();
-    expect(
-      readModel.threads.find((entry) => entry.id === ThreadId.make("thread-2"))?.titleRegeneration,
-    ).toBeNull();
-  });
-
-  it("keeps the current title when regeneration returns the fallback", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-    harness.generateThreadTitle.mockReturnValue(Effect.succeed({ title: "New thread" }));
-
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.meta.update",
-        commandId: CommandId.make("cmd-thread-title-before-fallback-regeneration"),
-        threadId: ThreadId.make("thread-1"),
-        title: "Keep meaningful title",
-      }),
-    );
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-before-fallback-regeneration"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-before-fallback-regeneration"),
-          role: "user",
-          text: "Investigate the reconnect state.",
-          attachments: [],
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.meta.update",
-        commandId: CommandId.make("cmd-thread-title-fallback-regeneration"),
-        threadId: ThreadId.make("thread-1"),
-        regenerateTitle: true,
-      }),
-    );
-
-    await harness.drain();
-
-    const readModel = await harness.readModel();
-    const thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    expect(thread?.title).toBe("Keep meaningful title");
-    expect(thread?.titleRegeneration).toBeNull();
-  });
-
-  it("clears title regeneration state when generation fails", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.meta.update",
-        commandId: CommandId.make("cmd-thread-title-before-failed-regeneration"),
-        threadId: ThreadId.make("thread-1"),
-        title: "Keep title after failure",
-      }),
-    );
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-before-failed-regeneration"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-before-failed-regeneration"),
-          role: "user",
-          text: "Investigate the reconnect state.",
-          attachments: [],
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.meta.update",
-        commandId: CommandId.make("cmd-thread-title-failed-regeneration"),
-        threadId: ThreadId.make("thread-1"),
-        regenerateTitle: true,
-      }),
-    );
-
-    await harness.drain();
-
-    const readModel = await harness.readModel();
-    const thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    expect(thread?.title).toBe("Keep title after failure");
-    expect(thread?.titleRegeneration).toBeNull();
-  });
-
-  it("retries a failed completion and continues regenerating", async () => {
-    const harness = await createHarness({
-      titleRegenerationCompletionDispatchFailures: 1,
-    });
-    const now = "2026-01-01T00:00:00.000Z";
-    harness.generateThreadTitle
-      .mockReturnValueOnce(Effect.succeed({ title: "Title lost to completion failure" }))
-      .mockReturnValueOnce(Effect.succeed({ title: "Recovered regeneration worker" }));
-
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.meta.update",
-        commandId: CommandId.make("cmd-thread-title-before-completion-failure"),
-        threadId: ThreadId.make("thread-1"),
-        title: "Existing title",
-      }),
-    );
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-before-completion-failure"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-before-completion-failure"),
-          role: "user",
-          text: "Investigate the reconnect state.",
-          attachments: [],
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.meta.update",
-        commandId: CommandId.make("cmd-thread-title-regeneration-completion-failure"),
-        threadId: ThreadId.make("thread-1"),
-        regenerateTitle: true,
-      }),
-    );
-    await harness.drain();
-
-    let readModel = await harness.readModel();
-    let thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    expect(thread?.title).toBe("Title lost to completion failure");
-    expect(thread?.titleRegeneration).toBeNull();
-
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.meta.update",
-        commandId: CommandId.make("cmd-thread-title-regeneration-after-completion-failure"),
-        threadId: ThreadId.make("thread-1"),
-        regenerateTitle: true,
-      }),
-    );
-    await harness.drain();
-
-    expect(harness.generateThreadTitle).toHaveBeenCalledTimes(2);
-    expect(harness.titleRegenerationCompletionDispatchAttempts).toBe(3);
-    readModel = await harness.readModel();
-    thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    expect(thread?.title).toBe("Recovered regeneration worker");
-    expect(thread?.titleRegeneration).toBeNull();
-  });
-
-  it("pins the first user context and attachment before the retained tail", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-    const firstUserContext = "USER:\nOld visual issue\n[Attachments: old-issue.png]";
-    const truncationMarker = "[Earlier content truncated]\n\n";
-    const retainedContext = "x".repeat(
-      8_000 - firstUserContext.length - "\n\n".length - truncationMarker.length,
-    );
-
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.meta.update",
-        commandId: CommandId.make("cmd-thread-title-before-truncated-regeneration"),
-        threadId: ThreadId.make("thread-1"),
-        title: "Existing title",
-      }),
-    );
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-before-truncated-regeneration"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-before-truncated-regeneration"),
-          role: "user",
-          text: "Old visual issue",
-          attachments: [
-            {
-              type: "image",
-              id: "old-title-context-image",
-              name: "old-issue.png",
-              mimeType: "image/png",
-              sizeBytes: 5,
-            },
-          ],
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.message.assistant.delta",
-        commandId: CommandId.make("cmd-assistant-truncated-regeneration-context"),
-        threadId: ThreadId.make("thread-1"),
-        messageId: asMessageId("assistant-truncated-regeneration-context"),
-        delta: `content before retained tail${"x".repeat(8_100)}`,
-        createdAt: "2026-01-01T00:00:01.000Z",
-      }),
-    );
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.message.assistant.complete",
-        commandId: CommandId.make("cmd-assistant-truncated-regeneration-context-complete"),
-        threadId: ThreadId.make("thread-1"),
-        messageId: asMessageId("assistant-truncated-regeneration-context"),
-        createdAt: "2026-01-01T00:00:02.000Z",
-      }),
-    );
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.meta.update",
-        commandId: CommandId.make("cmd-thread-title-regenerate-truncated-context"),
-        threadId: ThreadId.make("thread-1"),
-        regenerateTitle: true,
-      }),
-    );
-
-    await harness.drain();
-
-    expect(harness.generateThreadTitle.mock.calls[0]?.[0].message).toBe(
-      `${firstUserContext}\n\n${truncationMarker}${retainedContext}`,
-    );
-    expect(harness.generateThreadTitle.mock.calls[0]?.[0].attachments).toEqual([
-      expect.objectContaining({
-        id: "old-title-context-image",
-        name: "old-issue.png",
-      }),
-    ]);
-  });
-
-  it("does not overwrite a manual rename while title regeneration is running", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-    const generatedTitle = await harness.runEffect(
-      Deferred.make<{ readonly title: string }, never>(),
-    );
-    harness.generateThreadTitle.mockReturnValue(Deferred.await(generatedTitle));
-
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.meta.update",
-        commandId: CommandId.make("cmd-thread-title-before-regeneration-race"),
-        threadId: ThreadId.make("thread-1"),
-        title: "Existing thread title",
-      }),
-    );
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-before-regeneration-race"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-before-regeneration-race"),
-          role: "user",
-          text: "Investigate the reconnect state.",
-          attachments: [],
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.meta.update",
-        commandId: CommandId.make("cmd-thread-title-regeneration-race"),
-        threadId: ThreadId.make("thread-1"),
-        regenerateTitle: true,
-      }),
-    );
-    await waitFor(() => harness.generateThreadTitle.mock.calls.length === 1);
-    const pendingReadModel = await harness.readModel();
-    expect(
-      pendingReadModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"))
-        ?.titleRegeneration?.requestId,
-    ).toBe(CommandId.make("cmd-thread-title-regeneration-race"));
-
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.meta.update",
-        commandId: CommandId.make("cmd-thread-manual-rename-during-regeneration"),
-        threadId: ThreadId.make("thread-1"),
-        title: "Keep manual rename",
-      }),
-    );
-    await harness.runEffect(
-      Deferred.succeed(generatedTitle, { title: "Generated title should not win" }),
-    );
-    await harness.drain();
-
-    const readModel = await harness.readModel();
-    const thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    expect(thread?.title).toBe("Keep manual rename");
-    expect(thread?.titleRegeneration).toBeNull();
-  });
-
-  it("does not overwrite a manual rename while title regeneration is queued", async () => {
-    let releaseStart = () => {};
-    const startGate = new Promise<void>((resolve) => {
-      releaseStart = resolve;
-    });
-    const harness = await createHarness({
-      startSessionEffect: (session) => Effect.promise(() => startGate).pipe(Effect.as(session)),
-    });
-    const now = "2026-01-01T00:00:00.000Z";
-    harness.generateThreadTitle.mockReturnValue(
-      Effect.succeed({ title: "Generated title should not win" }),
-    );
-
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.meta.update",
-        commandId: CommandId.make("cmd-thread-title-before-queued-regeneration"),
-        threadId: ThreadId.make("thread-1"),
-        title: "Existing thread title",
-      }),
-    );
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-before-queued-regeneration"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-before-queued-regeneration"),
-          role: "user",
-          text: "Investigate the reconnect state.",
-          attachments: [],
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-    await waitFor(() => harness.startSession.mock.calls.length === 1);
-
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.meta.update",
-        commandId: CommandId.make("cmd-thread-title-queued-regeneration"),
-        threadId: ThreadId.make("thread-1"),
-        regenerateTitle: true,
-      }),
-    );
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.meta.update",
-        commandId: CommandId.make("cmd-thread-manual-rename-before-regeneration-starts"),
-        threadId: ThreadId.make("thread-1"),
-        title: "Keep queued manual rename",
-      }),
-    );
-    releaseStart();
-    await harness.drain();
-
-    expect(harness.generateThreadTitle).not.toHaveBeenCalled();
-    const readModel = await harness.readModel();
-    const thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    expect(thread?.title).toBe("Keep queued manual rename");
-  });
-
-  it("skips superseded title regeneration before generation starts", async () => {
-    let releaseStart = () => {};
-    const startGate = new Promise<void>((resolve) => {
-      releaseStart = resolve;
-    });
-    const harness = await createHarness({
-      startSessionEffect: (session) => Effect.promise(() => startGate).pipe(Effect.as(session)),
-    });
-    const now = "2026-01-01T00:00:00.000Z";
-    harness.generateThreadTitle.mockReturnValue(
-      Effect.succeed({ title: "Latest regenerated title" }),
-    );
-
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-before-superseded-regeneration"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-before-superseded-regeneration"),
-          role: "user",
-          text: "Investigate the reconnect state.",
-          attachments: [],
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-    await waitFor(() => harness.startSession.mock.calls.length === 1);
-
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.meta.update",
-        commandId: CommandId.make("cmd-thread-title-superseded-regeneration"),
-        threadId: ThreadId.make("thread-1"),
-        regenerateTitle: true,
-      }),
-    );
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.meta.update",
-        commandId: CommandId.make("cmd-thread-title-latest-regeneration"),
-        threadId: ThreadId.make("thread-1"),
-        regenerateTitle: true,
-      }),
-    );
-    releaseStart();
-    await harness.drain();
-
-    expect(harness.generateThreadTitle).toHaveBeenCalledTimes(1);
-    expect(harness.titleRegenerationCompletionDispatchAttempts).toBe(1);
-    const readModel = await harness.readModel();
-    const thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    expect(thread?.title).toBe("Latest regenerated title");
-    expect(thread?.titleRegeneration).toBeNull();
-  });
-
-  it("does not overwrite an existing custom thread title on the first turn", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-    const seededTitle = "Please investigate reconnect failures after restar...";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.meta.update",
-        commandId: CommandId.make("cmd-thread-title-custom"),
-        threadId: ThreadId.make("thread-1"),
-        title: "Keep this custom title",
-      }),
-    );
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-title-preserve"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-title-preserve"),
-          role: "user",
-          text: "Please investigate reconnect failures after restarting the session.",
-          attachments: [],
-        },
-        titleSeed: seededTitle,
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(() => harness.sendTurn.mock.calls.length === 1);
-    expect(harness.generateThreadTitle).not.toHaveBeenCalled();
-
-    const readModel = await harness.readModel();
-    const thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    expect(thread?.title).toBe("Keep this custom title");
-  });
-
-  it("matches the client-seeded title even when the outgoing prompt is reformatted", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-    const seededTitle = "Fix reconnect spinner on resume";
-    harness.generateThreadTitle.mockReturnValue(
-      Effect.succeed({
-        title: "Reconnect spinner resume bug",
-      }),
-    );
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.meta.update",
-        commandId: CommandId.make("cmd-thread-title-formatted-seed"),
-        threadId: ThreadId.make("thread-1"),
-        title: seededTitle,
-      }),
-    );
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-title-formatted"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-title-formatted"),
-          role: "user",
-          text: "[effort:high]\\n\\nFix reconnect spinner on resume",
-          attachments: [],
-        },
-        titleSeed: seededTitle,
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(() => harness.generateThreadTitle.mock.calls.length === 1);
-    await waitFor(async () => {
-      const readModel = await harness.readModel();
-      return (
-        readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"))?.title ===
-        "Reconnect spinner resume bug"
-      );
-    });
-
-    const readModel = await harness.readModel();
-    const thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    expect(thread?.title).toBe("Reconnect spinner resume bug");
-  });
-
-  it("generates a worktree branch name for the first turn", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.meta.update",
-        commandId: CommandId.make("cmd-thread-branch"),
-        threadId: ThreadId.make("thread-1"),
-        branch: "t3code/1234abcd",
-        worktreePath: "/tmp/provider-project-worktree",
-      }),
-    );
-
-    harness.generateBranchName.mockImplementation((input: unknown) =>
-      Effect.succeed({
-        branch:
-          typeof input === "object" &&
-          input !== null &&
-          "modelSelection" in input &&
-          typeof input.modelSelection === "object" &&
-          input.modelSelection !== null &&
-          "model" in input.modelSelection &&
-          typeof input.modelSelection.model === "string"
-            ? `feature/${input.modelSelection.model}`
-            : "feature/generated",
-      }),
-    );
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-branch-model"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-branch-model"),
-          role: "user",
-          text: "Add a safer reconnect backoff.",
-          attachments: [],
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(() => harness.generateBranchName.mock.calls.length === 1);
-    await waitFor(() => harness.refreshStatus.mock.calls.length === 1);
-    expect(harness.generateBranchName.mock.calls[0]?.[0]).toMatchObject({
-      message: "Add a safer reconnect backoff.",
-    });
-    expect(harness.refreshStatus.mock.calls[0]?.[0]).toBe("/tmp/provider-project-worktree");
-  });
-
-  it("recreates a missing worktree from the thread branch before starting a turn", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-    const worktreePath = NodePath.join(harness.stateDir, "missing-worktree");
-
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.meta.update",
-        commandId: CommandId.make("cmd-thread-missing-worktree"),
-        threadId: ThreadId.make("thread-1"),
-        branch: "feature/restore",
-        worktreePath,
-      }),
-    );
-
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-missing-worktree"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-missing-worktree"),
-          role: "user",
-          text: "continue",
-          attachments: [],
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(() => harness.startSession.mock.calls.length === 1);
-    expect(harness.pruneWorktrees).toHaveBeenCalledWith({ cwd: "/tmp/provider-project" });
-    expect(harness.createWorktree).toHaveBeenCalledWith({
-      cwd: "/tmp/provider-project",
-      refName: "feature/restore",
-      path: worktreePath,
-    });
-    expect(harness.createWorktree.mock.invocationCallOrder[0]).toBeLessThan(
-      harness.startSession.mock.invocationCallOrder[0]!,
-    );
-  });
-
-  it("forwards codex model options through session start and turn send", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-fast"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-fast"),
-          role: "user",
-          text: "hello fast mode",
-          attachments: [],
-        },
-        modelSelection: createModelSelection(ProviderInstanceId.make("codex"), "gpt-5.3-codex", [
-          { id: "reasoningEffort", value: "high" },
-          { id: "fastMode", value: true },
-        ]),
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(() => harness.startSession.mock.calls.length === 1);
-    await waitFor(() => harness.sendTurn.mock.calls.length === 1);
-    expect(harness.startSession.mock.calls[0]?.[1]).toMatchObject({
-      modelSelection: createModelSelection(ProviderInstanceId.make("codex"), "gpt-5.3-codex", [
-        { id: "reasoningEffort", value: "high" },
-        { id: "fastMode", value: true },
-      ]),
-    });
-    expect(harness.sendTurn.mock.calls[0]?.[0]).toMatchObject({
-      threadId: ThreadId.make("thread-1"),
-      modelSelection: createModelSelection(ProviderInstanceId.make("codex"), "gpt-5.3-codex", [
-        { id: "reasoningEffort", value: "high" },
-        { id: "fastMode", value: true },
-      ]),
-    });
-  });
-
-  it("forwards claude effort options through session start and turn send", async () => {
-    const harness = await createHarness({
-      threadModelSelection: {
-        instanceId: ProviderInstanceId.make("claudeAgent"),
-        model: "claude-sonnet-4-6",
-      },
-    });
-    const now = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-claude-effort"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-claude-effort"),
-          role: "user",
-          text: "hello with effort",
-          attachments: [],
-        },
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("claudeAgent"),
-          "claude-sonnet-4-6",
-          [{ id: "effort", value: "max" }],
-        ),
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(() => harness.startSession.mock.calls.length === 1);
-    await waitFor(() => harness.sendTurn.mock.calls.length === 1);
-    expect(harness.startSession.mock.calls[0]?.[1]).toMatchObject({
-      modelSelection: createModelSelection(
-        ProviderInstanceId.make("claudeAgent"),
-        "claude-sonnet-4-6",
-        [{ id: "effort", value: "max" }],
-      ),
-    });
-    expect(harness.sendTurn.mock.calls[0]?.[0]).toMatchObject({
-      threadId: ThreadId.make("thread-1"),
-      modelSelection: createModelSelection(
-        ProviderInstanceId.make("claudeAgent"),
-        "claude-sonnet-4-6",
-        [{ id: "effort", value: "max" }],
-      ),
-    });
-  });
-
-  it("forwards claude fast mode options through session start and turn send", async () => {
-    const harness = await createHarness({
-      threadModelSelection: {
-        instanceId: ProviderInstanceId.make("claudeAgent"),
-        model: "claude-opus-4-6",
-      },
-    });
-    const now = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-claude-fast-mode"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-claude-fast-mode"),
-          role: "user",
-          text: "hello with fast mode",
-          attachments: [],
-        },
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("claudeAgent"),
-          "claude-opus-4-6",
-          [{ id: "fastMode", value: true }],
-        ),
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(() => harness.startSession.mock.calls.length === 1);
-    await waitFor(() => harness.sendTurn.mock.calls.length === 1);
-    expect(harness.startSession.mock.calls[0]?.[1]).toMatchObject({
-      modelSelection: createModelSelection(
-        ProviderInstanceId.make("claudeAgent"),
-        "claude-opus-4-6",
-        [{ id: "fastMode", value: true }],
-      ),
-    });
-    expect(harness.sendTurn.mock.calls[0]?.[0]).toMatchObject({
-      threadId: ThreadId.make("thread-1"),
-      modelSelection: createModelSelection(
-        ProviderInstanceId.make("claudeAgent"),
-        "claude-opus-4-6",
-        [{ id: "fastMode", value: true }],
-      ),
-    });
-  });
-
-  it("forwards plan interaction mode to the provider turn request", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.interaction-mode.set",
-        commandId: CommandId.make("cmd-interaction-mode-set-plan"),
-        threadId: ThreadId.make("thread-1"),
-        interactionMode: "plan",
-        createdAt: now,
-      }),
-    );
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-plan"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-plan"),
-          role: "user",
-          text: "plan this change",
-          attachments: [],
-        },
-        interactionMode: "plan",
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(() => harness.sendTurn.mock.calls.length === 1);
-    expect(harness.sendTurn.mock.calls[0]?.[0]).toMatchObject({
-      threadId: ThreadId.make("thread-1"),
-      interactionMode: "plan",
-    });
-  });
-
-  it("preserves the active session model when in-session model switching is unsupported", async () => {
-    const harness = await createHarness({ sessionModelSwitch: "unsupported" });
-    const now = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-unsupported-1"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-unsupported-1"),
-          role: "user",
-          text: "first",
-          attachments: [],
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(() => harness.sendTurn.mock.calls.length === 1);
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-unsupported-2"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-unsupported-2"),
-          role: "user",
-          text: "second",
-          attachments: [],
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(() => harness.sendTurn.mock.calls.length === 2);
-
-    expect(harness.sendTurn.mock.calls[1]?.[0]).toMatchObject({
-      threadId: ThreadId.make("thread-1"),
-      modelSelection: {
-        instanceId: ProviderInstanceId.make("codex"),
-        model: "gpt-5-codex",
-      },
-    });
-  });
-
-  effectIt.effect(
-    "rejects changing models after start when the provider requires a new thread",
-    () =>
-      Effect.gen(function* () {
-        const harness = yield* Effect.promise(() =>
-          createHarness({ requiresNewThreadForModelChange: true }),
-        );
-        const now = "2026-01-01T00:00:00.000Z";
-
-        yield* harness.engine.dispatch({
-          type: "thread.turn.start",
-          commandId: CommandId.make("cmd-turn-start-restricted-1"),
-          threadId: ThreadId.make("thread-1"),
-          message: {
-            messageId: asMessageId("user-message-restricted-1"),
-            role: "user",
-            text: "first",
-            attachments: [],
-          },
-          interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-          runtimeMode: "approval-required",
-          createdAt: now,
-        });
-
-        yield* Effect.promise(() => waitFor(() => harness.sendTurn.mock.calls.length === 1));
-
-        yield* harness.engine.dispatch({
-          type: "thread.turn.start",
-          commandId: CommandId.make("cmd-turn-start-restricted-2"),
-          threadId: ThreadId.make("thread-1"),
-          message: {
-            messageId: asMessageId("user-message-restricted-2"),
-            role: "user",
-            text: "second",
-            attachments: [],
-          },
-          modelSelection: {
-            instanceId: ProviderInstanceId.make("codex"),
-            model: "gpt-5.1-codex",
-          },
-          interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-          runtimeMode: "approval-required",
-          createdAt: now,
-        });
-
-        yield* Effect.promise(() =>
-          waitFor(async () => {
-            const readModel = await harness.readModel();
-            const thread = readModel.threads.find(
-              (entry) => entry.id === ThreadId.make("thread-1"),
-            );
-            return (
-              thread?.activities.some(
-                (activity) => activity.kind === "provider.turn.start.failed",
-              ) ?? false
-            );
-          }),
-        );
-
-        expect(harness.sendTurn).toHaveBeenCalledTimes(1);
-        const readModel = yield* Effect.promise(() => harness.readModel());
-        const thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-        expect(
-          thread?.activities.find((activity) => activity.kind === "provider.turn.start.failed"),
-        ).toMatchObject({
-          payload: {
-            detail: expect.stringContaining(
-              "cannot switch models after the conversation has started",
-            ),
-          },
-        });
-      }),
-  );
-
-  it("starts a first turn on the requested provider instance even when it differs from the thread model", async () => {
-    const harness = await createHarness({
-      threadModelSelection: { instanceId: ProviderInstanceId.make("codex"), model: "gpt-5-codex" },
-    });
-    const now = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-provider-first"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-provider-first"),
-          role: "user",
-          text: "hello claude",
-          attachments: [],
-        },
-        modelSelection: {
-          instanceId: ProviderInstanceId.make("claudeAgent"),
-          model: "claude-opus-4-6",
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(() => harness.sendTurn.mock.calls.length === 1);
-
-    expect(harness.startSession).toHaveBeenCalledTimes(1);
-    expect(harness.startSession.mock.calls[0]?.[1]).toMatchObject({
-      provider: ProviderDriverKind.make("claudeAgent"),
-      providerInstanceId: ProviderInstanceId.make("claudeAgent"),
-      modelSelection: {
-        instanceId: ProviderInstanceId.make("claudeAgent"),
-        model: "claude-opus-4-6",
-      },
-    });
-
-    const readModel = await harness.readModel();
-    const thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    expect(thread?.session?.providerName).toBe("claudeAgent");
-    expect(thread?.session?.providerInstanceId).toBe(ProviderInstanceId.make("claudeAgent"));
-    expect(
-      thread?.activities.find((activity) => activity.kind === "provider.turn.start.failed"),
-    ).toBeUndefined();
-  });
-
-  it("reuses the same provider session when runtime mode is unchanged", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-unchanged-1"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-unchanged-1"),
-          role: "user",
-          text: "first",
-          attachments: [],
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(() => harness.startSession.mock.calls.length === 1);
-    await waitFor(() => harness.sendTurn.mock.calls.length === 1);
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-unchanged-2"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-unchanged-2"),
-          role: "user",
-          text: "second",
-          attachments: [],
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(() => harness.sendTurn.mock.calls.length === 2);
-    expect(harness.startSession.mock.calls.length).toBe(1);
-    expect(harness.stopSession.mock.calls.length).toBe(0);
-  });
-
-  it("restarts an existing Codex thread on a compatible requested instance", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-compatible-codex-1"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-compatible-codex-1"),
-          role: "user",
-          text: "first",
-          attachments: [],
-        },
-        modelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5-codex",
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(() => harness.sendTurn.mock.calls.length === 1);
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-compatible-codex-2"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-compatible-codex-2"),
-          role: "user",
-          text: "second",
-          attachments: [],
-        },
-        modelSelection: {
-          instanceId: ProviderInstanceId.make("codex_work"),
-          model: "gpt-5-codex",
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: "2026-01-01T00:00:00.000Z",
-      }),
-    );
-
-    await waitFor(() => harness.sendTurn.mock.calls.length === 2);
-
-    expect(harness.startSession).toHaveBeenCalledTimes(2);
-    expect(harness.startSession.mock.calls[1]?.[1]).toMatchObject({
-      provider: ProviderDriverKind.make("codex"),
-      providerInstanceId: ProviderInstanceId.make("codex_work"),
-      resumeCursor: { opaque: "resume-1" },
-    });
-
-    const readModel = await harness.readModel();
-    const thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    expect(thread?.session?.providerInstanceId).toBe(ProviderInstanceId.make("codex_work"));
-  });
-
-  it("restarts the provider session when the thread workspace changes", async () => {
-    const harness = await createHarness({
-      threadModelSelection: {
-        instanceId: ProviderInstanceId.make("claudeAgent"),
-        model: "claude-sonnet-4-6",
-      },
-    });
-    const now = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-workspace-1"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-workspace-1"),
-          role: "user",
-          text: "first in project root",
-          attachments: [],
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(() => harness.startSession.mock.calls.length === 1);
-    await waitFor(() => harness.sendTurn.mock.calls.length === 1);
-    expect(harness.startSession.mock.calls[0]?.[1]).toMatchObject({
-      cwd: "/tmp/provider-project",
-    });
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.meta.update",
-        commandId: CommandId.make("cmd-thread-worktree-change"),
-        threadId: ThreadId.make("thread-1"),
-        worktreePath: "/tmp/provider-project-worktree",
-      }),
-    );
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-workspace-2"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-workspace-2"),
-          role: "user",
-          text: "second in worktree",
-          attachments: [],
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(() => harness.startSession.mock.calls.length === 2);
-    await waitFor(() => harness.sendTurn.mock.calls.length === 2);
-    expect(harness.stopSession.mock.calls.length).toBe(0);
-    expect(harness.startSession.mock.calls[1]?.[1]).toMatchObject({
-      threadId: ThreadId.make("thread-1"),
-      cwd: "/tmp/provider-project-worktree",
-      resumeCursor: { opaque: "resume-1" },
-      modelSelection: {
-        instanceId: ProviderInstanceId.make("claudeAgent"),
-        model: "claude-sonnet-4-6",
-      },
-      runtimeMode: "approval-required",
-    });
-  });
-
-  it("restarts claude sessions when claude effort changes", async () => {
-    const harness = await createHarness({
-      threadModelSelection: {
-        instanceId: ProviderInstanceId.make("claudeAgent"),
-        model: "claude-sonnet-4-6",
-      },
-    });
-    const now = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-claude-effort-1"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-claude-effort-1"),
-          role: "user",
-          text: "first claude turn",
-          attachments: [],
-        },
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("claudeAgent"),
-          "claude-sonnet-4-6",
-          [{ id: "effort", value: "medium" }],
-        ),
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(() => harness.startSession.mock.calls.length === 1);
-    await waitFor(() => harness.sendTurn.mock.calls.length === 1);
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-claude-effort-2"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-claude-effort-2"),
-          role: "user",
-          text: "second claude turn",
-          attachments: [],
-        },
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("claudeAgent"),
-          "claude-sonnet-4-6",
-          [{ id: "effort", value: "max" }],
-        ),
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(() => harness.startSession.mock.calls.length === 2);
-    await waitFor(() => harness.sendTurn.mock.calls.length === 2);
-    expect(harness.startSession.mock.calls[1]?.[1]).toMatchObject({
-      resumeCursor: { opaque: "resume-1" },
-      modelSelection: createModelSelection(
-        ProviderInstanceId.make("claudeAgent"),
-        "claude-sonnet-4-6",
-        [{ id: "effort", value: "max" }],
-      ),
-    });
-  });
-
-  it("restarts the provider session when runtime mode is updated on the thread", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.runtime-mode.set",
-        commandId: CommandId.make("cmd-runtime-mode-set-initial-full-access"),
-        threadId: ThreadId.make("thread-1"),
-        runtimeMode: "full-access",
-        createdAt: now,
-      }),
-    );
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-runtime-mode-1"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-runtime-mode-1"),
-          role: "user",
-          text: "first",
-          attachments: [],
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "full-access",
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(() => harness.startSession.mock.calls.length === 1);
-    await waitFor(() => harness.sendTurn.mock.calls.length === 1);
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.runtime-mode.set",
-        commandId: CommandId.make("cmd-runtime-mode-set-1"),
-        threadId: ThreadId.make("thread-1"),
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(async () => {
-      const readModel = await harness.readModel();
-      const thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-      return thread?.runtimeMode === "approval-required";
-    });
-    await waitFor(() => harness.startSession.mock.calls.length === 2);
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-runtime-mode-2"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-runtime-mode-2"),
-          role: "user",
-          text: "second",
-          attachments: [],
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "full-access",
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(() => harness.sendTurn.mock.calls.length === 2);
-
-    expect(harness.stopSession.mock.calls.length).toBe(0);
-    expect(harness.startSession.mock.calls[1]?.[1]).toMatchObject({
-      threadId: ThreadId.make("thread-1"),
-      resumeCursor: { opaque: "resume-1" },
-      runtimeMode: "approval-required",
-    });
-    expect(harness.sendTurn.mock.calls[1]?.[0]).toMatchObject({
-      threadId: ThreadId.make("thread-1"),
-    });
-
-    const readModel = await harness.readModel();
-    const thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    expect(thread?.session?.threadId).toBe("thread-1");
-    expect(thread?.session?.runtimeMode).toBe("approval-required");
-  });
-
-  it("does not inject derived model options when restarting claude on runtime mode changes", async () => {
-    const harness = await createHarness({
-      threadModelSelection: {
-        instanceId: ProviderInstanceId.make("claudeAgent"),
-        model: "claude-opus-4-6",
-      },
-    });
-    const now = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.session.set",
-        commandId: CommandId.make("cmd-session-set-runtime-mode-claude"),
-        threadId: ThreadId.make("thread-1"),
-        session: {
-          threadId: ThreadId.make("thread-1"),
-          status: "ready",
-          providerName: "claudeAgent",
-          runtimeMode: "full-access",
-          activeTurnId: null,
-          lastError: null,
-          updatedAt: now,
-        },
-        createdAt: now,
-      }),
-    );
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.runtime-mode.set",
-        commandId: CommandId.make("cmd-runtime-mode-set-claude-no-options"),
-        threadId: ThreadId.make("thread-1"),
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(() => harness.startSession.mock.calls.length === 1);
-
-    expect(harness.startSession.mock.calls[0]?.[1]).toMatchObject({
-      modelSelection: {
-        instanceId: ProviderInstanceId.make("claudeAgent"),
-        model: "claude-opus-4-6",
-      },
-      runtimeMode: "approval-required",
-    });
-  });
-
-  it("does not stop the active session when restart fails before rebind", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.runtime-mode.set",
-        commandId: CommandId.make("cmd-runtime-mode-set-initial-full-access-2"),
-        threadId: ThreadId.make("thread-1"),
-        runtimeMode: "full-access",
-        createdAt: now,
-      }),
-    );
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-restart-failure-1"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-restart-failure-1"),
-          role: "user",
-          text: "first",
-          attachments: [],
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "full-access",
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(() => harness.startSession.mock.calls.length === 1);
-    await waitFor(() => harness.sendTurn.mock.calls.length === 1);
-
-    harness.startSession.mockImplementationOnce(
-      (_: unknown, __: unknown) => Effect.fail("simulated restart failure") as never,
-    );
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.runtime-mode.set",
-        commandId: CommandId.make("cmd-runtime-mode-set-restart-failure"),
-        threadId: ThreadId.make("thread-1"),
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(async () => {
-      const readModel = await harness.readModel();
-      const thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-      return thread?.runtimeMode === "approval-required";
-    });
-    await waitFor(() => harness.startSession.mock.calls.length === 2);
-    await harness.drain();
-
-    expect(harness.stopSession.mock.calls.length).toBe(0);
-    expect(harness.sendTurn.mock.calls.length).toBe(1);
-
-    const readModel = await harness.readModel();
-    const thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    expect(thread?.session?.threadId).toBe("thread-1");
-    expect(thread?.session?.runtimeMode).toBe("full-access");
-  });
-
-  it("rejects provider changes after a thread is already bound to a session provider", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-provider-switch-1"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-provider-switch-1"),
-          role: "user",
-          text: "first",
-          attachments: [],
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(() => harness.startSession.mock.calls.length === 1);
-    await waitFor(() => harness.sendTurn.mock.calls.length === 1);
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-provider-switch-2"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-provider-switch-2"),
-          role: "user",
-          text: "second",
-          attachments: [],
-        },
-        modelSelection: {
-          instanceId: ProviderInstanceId.make("claudeAgent"),
-          model: "claude-opus-4-6",
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(async () => {
-      const readModel = await harness.readModel();
-      const thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-      return (
-        thread?.activities.some((activity) => activity.kind === "provider.turn.start.failed") ??
-        false
-      );
-    });
-
-    expect(harness.startSession.mock.calls.length).toBe(1);
-    expect(harness.sendTurn.mock.calls.length).toBe(1);
-    expect(harness.stopSession.mock.calls.length).toBe(0);
-
-    const readModel = await harness.readModel();
-    const thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    expect(thread?.session?.threadId).toBe("thread-1");
-    expect(thread?.session?.providerName).toBe("codex");
-    expect(thread?.session?.runtimeMode).toBe("approval-required");
-    expect(
-      thread?.activities.find((activity) => activity.kind === "provider.turn.start.failed"),
-    ).toMatchObject({
-      payload: {
-        detail: expect.stringContaining("cannot switch to 'claudeAgent'"),
-      },
-    });
-  });
-
-  it("rejects cross-driver provider changes after the existing thread session has stopped", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.session.set",
-        commandId: CommandId.make("cmd-session-set-stopped-provider-switch"),
-        threadId: ThreadId.make("thread-1"),
-        session: {
-          threadId: ThreadId.make("thread-1"),
-          status: "stopped",
-          providerName: "codex",
-          providerInstanceId: ProviderInstanceId.make("codex"),
-          runtimeMode: "approval-required",
-          activeTurnId: null,
-          lastError: null,
-          updatedAt: now,
-        },
-        createdAt: now,
-      }),
-    );
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-stopped-provider-switch"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-stopped-provider-switch"),
-          role: "user",
-          text: "continue with claude",
-          attachments: [],
-        },
-        modelSelection: {
-          instanceId: ProviderInstanceId.make("claudeAgent"),
-          model: "claude-opus-4-6",
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(async () => {
-      const readModel = await harness.readModel();
-      const thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-      return (
-        thread?.activities.some((activity) => activity.kind === "provider.turn.start.failed") ??
-        false
-      );
-    });
-
-    expect(harness.startSession.mock.calls.length).toBe(0);
-    expect(harness.sendTurn.mock.calls.length).toBe(0);
-    const readModel = await harness.readModel();
-    const thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    expect(
-      thread?.activities.find((activity) => activity.kind === "provider.turn.start.failed"),
-    ).toMatchObject({
-      payload: {
-        detail: expect.stringContaining("cannot switch to 'claudeAgent'"),
-      },
-    });
-  });
-
-  it("reacts to thread.turn.interrupt-requested by calling provider interrupt", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.session.set",
-        commandId: CommandId.make("cmd-session-set"),
-        threadId: ThreadId.make("thread-1"),
-        session: {
-          threadId: ThreadId.make("thread-1"),
-          status: "running",
-          providerName: "codex",
-          runtimeMode: "approval-required",
-          activeTurnId: asTurnId("turn-1"),
-          lastError: null,
-          updatedAt: now,
-        },
-        createdAt: now,
-      }),
-    );
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.interrupt",
-        commandId: CommandId.make("cmd-turn-interrupt"),
-        threadId: ThreadId.make("thread-1"),
-        turnId: asTurnId("turn-1"),
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(() => harness.interruptTurn.mock.calls.length === 1);
-    expect(harness.interruptTurn.mock.calls[0]?.[0]).toEqual({
-      threadId: "thread-1",
-    });
-  });
-
-  effectIt.effect(
-    "stops a running session and records the failure when provider interrupt fails",
-    () =>
-      Effect.gen(function* () {
-        const harness = yield* Effect.promise(() =>
-          createHarness({
-            interruptTurnEffect: () =>
-              Effect.fail(
-                new ProviderAdapterRequestError({
-                  provider: "codex",
-                  method: "thread.interrupt",
-                  detail: "provider session disappeared",
-                }),
-              ),
-            stopSessionEffect: () =>
-              Effect.fail(
-                new ProviderAdapterRequestError({
-                  provider: "codex",
-                  method: "session.stop",
-                  detail: "provider process already exited",
-                }),
-              ),
-          }),
-        );
-        const now = "2026-01-01T00:00:00.000Z";
-
-        yield* harness.engine.dispatch({
-          type: "thread.session.set",
-          commandId: CommandId.make("cmd-session-set-interrupt-failure"),
-          threadId: ThreadId.make("thread-1"),
-          session: {
-            threadId: ThreadId.make("thread-1"),
-            status: "running",
-            providerName: "codex",
-            runtimeMode: "approval-required",
-            activeTurnId: asTurnId("turn-1"),
-            lastError: null,
-            updatedAt: now,
-          },
-          createdAt: now,
-        });
-
-        yield* harness.engine.dispatch({
-          type: "thread.turn.interrupt",
-          commandId: CommandId.make("cmd-turn-interrupt-provider-failure"),
-          threadId: ThreadId.make("thread-1"),
-          turnId: asTurnId("turn-1"),
-          createdAt: now,
-        });
-
-        yield* Effect.promise(() =>
-          waitFor(async () => {
-            const thread = (await harness.readModel()).threads.find(
-              (entry) => entry.id === ThreadId.make("thread-1"),
-            );
-            return thread?.session?.status === "stopped";
-          }),
-        );
-
-        const thread = (yield* Effect.promise(() => harness.readModel())).threads.find(
-          (entry) => entry.id === ThreadId.make("thread-1"),
-        );
-        expect(thread?.session).toMatchObject({
-          status: "stopped",
-          activeTurnId: null,
-          lastError: "provider session disappeared",
-        });
-        expect(
-          thread?.activities.find((activity) => activity.kind === "provider.turn.interrupt.failed"),
-        ).toMatchObject({
-          summary: "Provider turn interrupt failed",
-          payload: { detail: "provider session disappeared" },
-        });
-        expect(harness.stopSession).toHaveBeenCalledWith({ threadId: ThreadId.make("thread-1") });
-      }),
-  );
-
-  effectIt.effect("stops a starting session without a bound turn when interrupt fails", () =>
-    Effect.gen(function* () {
-      const harness = yield* Effect.promise(() =>
-        createHarness({
-          interruptTurnEffect: () =>
-            Effect.fail(
-              new ProviderAdapterRequestError({
-                provider: "codex",
-                method: "thread.interrupt",
-                detail: "provider session disappeared",
-              }),
-            ),
-        }),
-      );
-      const now = "2026-01-01T00:00:00.000Z";
-
-      yield* harness.engine.dispatch({
-        type: "thread.session.set",
-        commandId: CommandId.make("cmd-session-set-interrupt-starting"),
-        threadId: ThreadId.make("thread-1"),
-        session: {
-          threadId: ThreadId.make("thread-1"),
-          status: "starting",
-          providerName: "codex",
-          runtimeMode: "approval-required",
-          activeTurnId: null,
-          lastError: null,
-          updatedAt: now,
-        },
-        createdAt: now,
-      });
-
-      yield* harness.engine.dispatch({
-        type: "thread.turn.interrupt",
-        commandId: CommandId.make("cmd-turn-interrupt-starting-provider-failure"),
-        threadId: ThreadId.make("thread-1"),
-        createdAt: now,
-      });
-
-      yield* Effect.promise(() => harness.drain());
-
-      const thread = (yield* Effect.promise(() => harness.readModel())).threads.find(
-        (entry) => entry.id === ThreadId.make("thread-1"),
-      );
-      expect(thread?.session).toMatchObject({
-        status: "stopped",
-        activeTurnId: null,
-        lastError: "provider session disappeared",
-      });
-      expect(harness.stopSession).toHaveBeenCalledWith({ threadId: ThreadId.make("thread-1") });
-      expect(
-        thread?.activities.find((activity) => activity.kind === "provider.turn.interrupt.failed"),
-      ).toMatchObject({ payload: { detail: "provider session disappeared" } });
-    }),
-  );
-
-  effectIt.effect("does not overwrite a session that became ready while an interrupt failed", () =>
-    Effect.gen(function* () {
-      const harness = yield* Effect.promise(() => createHarness());
-      const now = "2026-01-01T00:00:00.000Z";
-      const completedAt = "2026-01-01T00:00:01.000Z";
-
-      yield* harness.engine.dispatch({
-        type: "thread.session.set",
-        commandId: CommandId.make("cmd-session-set-interrupt-race"),
-        threadId: ThreadId.make("thread-1"),
-        session: {
-          threadId: ThreadId.make("thread-1"),
-          status: "running",
-          providerName: "codex",
-          runtimeMode: "approval-required",
-          activeTurnId: asTurnId("turn-1"),
-          lastError: null,
-          updatedAt: now,
-        },
-        createdAt: now,
-      });
-
-      harness.interruptTurn.mockImplementation(() =>
-        harness.engine
-          .dispatch({
-            type: "thread.session.set",
-            commandId: CommandId.make("cmd-session-set-natural-completion"),
-            threadId: ThreadId.make("thread-1"),
-            session: {
-              threadId: ThreadId.make("thread-1"),
-              status: "ready",
-              providerName: "codex",
-              runtimeMode: "approval-required",
-              activeTurnId: null,
-              lastError: null,
-              updatedAt: completedAt,
-            },
-            createdAt: completedAt,
-          })
-          .pipe(
-            Effect.catchCause((cause) => Effect.die(cause)),
-            Effect.andThen(
-              Effect.fail(
-                new ProviderAdapterRequestError({
-                  provider: "codex",
-                  method: "thread.interrupt",
-                  detail: "provider session disappeared",
-                }),
-              ),
-            ),
-          ),
-      );
-
-      yield* harness.engine.dispatch({
-        type: "thread.turn.interrupt",
-        commandId: CommandId.make("cmd-turn-interrupt-race"),
-        threadId: ThreadId.make("thread-1"),
-        turnId: asTurnId("turn-1"),
-        createdAt: now,
-      });
-
-      yield* Effect.promise(() => harness.drain());
-
-      const thread = (yield* Effect.promise(() => harness.readModel())).threads.find(
-        (entry) => entry.id === ThreadId.make("thread-1"),
-      );
-      expect(thread?.session).toMatchObject({
-        status: "ready",
-        activeTurnId: null,
-        lastError: null,
-        updatedAt: completedAt,
-      });
-      expect(harness.stopSession).not.toHaveBeenCalled();
-      expect(
-        thread?.activities.some((activity) => activity.kind === "provider.turn.interrupt.failed"),
-      ).toBe(false);
-    }),
-  );
-
-  it("starts a fresh session when only projected session state exists", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.session.set",
-        commandId: CommandId.make("cmd-session-set-stale"),
-        threadId: ThreadId.make("thread-1"),
-        session: {
-          threadId: ThreadId.make("thread-1"),
-          status: "ready",
-          providerName: "codex",
-          runtimeMode: "approval-required",
-          activeTurnId: null,
-          lastError: null,
-          updatedAt: now,
-        },
-        createdAt: now,
-      }),
-    );
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-stale"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-stale"),
-          role: "user",
-          text: "resume codex",
-          attachments: [],
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(() => harness.startSession.mock.calls.length === 1);
-    await waitFor(() => harness.sendTurn.mock.calls.length === 1);
-
-    expect(harness.startSession.mock.calls[0]?.[1]).toMatchObject({
-      threadId: ThreadId.make("thread-1"),
-      modelSelection: {
-        instanceId: ProviderInstanceId.make("codex"),
-        model: "gpt-5-codex",
-      },
-      runtimeMode: "approval-required",
-    });
-    expect(harness.sendTurn.mock.calls[0]?.[0]).toMatchObject({
-      threadId: ThreadId.make("thread-1"),
-    });
-  });
-
-  it("rejects active runtime sessions that are missing provider instance ids", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.session.set",
-        commandId: CommandId.make("cmd-session-set-missing-instance"),
-        threadId: ThreadId.make("thread-1"),
-        session: {
-          threadId: ThreadId.make("thread-1"),
-          status: "ready",
-          providerName: "codex",
-          runtimeMode: "approval-required",
-          activeTurnId: null,
-          lastError: null,
-          updatedAt: now,
-        },
-        createdAt: now,
-      }),
-    );
-    harness.runtimeSessions.push({
-      provider: ProviderDriverKind.make("codex"),
-      status: "ready",
-      runtimeMode: "approval-required",
-      threadId: ThreadId.make("thread-1"),
-      cwd: "/tmp/provider-project",
-      resumeCursor: { opaque: "resume-without-instance" },
-      createdAt: now,
-      updatedAt: now,
-    });
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-missing-instance"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("user-message-missing-instance"),
-          role: "user",
-          text: "resume codex",
-          attachments: [],
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(async () => {
-      const readModel = await harness.readModel();
-      const thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-      return (
-        thread?.activities.some((activity) => activity.kind === "provider.turn.start.failed") ??
-        false
-      );
-    });
-
-    expect(harness.startSession.mock.calls.length).toBe(0);
-    expect(harness.sendTurn.mock.calls.length).toBe(0);
-    const readModel = await harness.readModel();
-    const thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    expect(
-      thread?.activities.find((activity) => activity.kind === "provider.turn.start.failed"),
-    ).toMatchObject({
-      payload: {
-        detail: expect.stringContaining("without a provider instance id"),
-      },
-    });
-  });
-
-  it("reacts to thread.approval.respond by forwarding provider approval response", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.session.set",
-        commandId: CommandId.make("cmd-session-set-for-approval"),
-        threadId: ThreadId.make("thread-1"),
-        session: {
-          threadId: ThreadId.make("thread-1"),
-          status: "running",
-          providerName: "codex",
-          runtimeMode: "approval-required",
-          activeTurnId: null,
-          lastError: null,
-          updatedAt: now,
-        },
-        createdAt: now,
-      }),
-    );
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.approval.respond",
-        commandId: CommandId.make("cmd-approval-respond"),
-        threadId: ThreadId.make("thread-1"),
-        requestId: asApprovalRequestId("approval-request-1"),
-        decision: "accept",
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(() => harness.respondToRequest.mock.calls.length === 1);
-    expect(harness.respondToRequest.mock.calls[0]?.[0]).toEqual({
-      threadId: "thread-1",
-      requestId: "approval-request-1",
-      decision: "accept",
-    });
-  });
-
-  it("reacts to thread.user-input.respond by forwarding structured user input answers", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.session.set",
-        commandId: CommandId.make("cmd-session-set-for-user-input"),
-        threadId: ThreadId.make("thread-1"),
-        session: {
-          threadId: ThreadId.make("thread-1"),
-          status: "running",
-          providerName: "codex",
-          runtimeMode: "approval-required",
-          activeTurnId: null,
-          lastError: null,
-          updatedAt: now,
-        },
-        createdAt: now,
-      }),
-    );
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.user-input.respond",
-        commandId: CommandId.make("cmd-user-input-respond"),
-        threadId: ThreadId.make("thread-1"),
-        requestId: asApprovalRequestId("user-input-request-1"),
-        answers: {
-          sandbox_mode: "workspace-write",
-        },
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(() => harness.respondToUserInput.mock.calls.length === 1);
-    expect(harness.respondToUserInput.mock.calls[0]?.[0]).toEqual({
-      threadId: "thread-1",
-      requestId: "user-input-request-1",
-      answers: {
-        sandbox_mode: "workspace-write",
-      },
-    });
-  });
-
-  it("normalizes stale Codex approval callbacks without faking approval resolution", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-    harness.respondToRequest.mockImplementation(() =>
-      Effect.fail(
-        new ProviderAdapterRequestError({
-          provider: ProviderDriverKind.make("codex"),
-          method: "item/requestApproval/decision",
-          detail: "Unknown pending Codex approval request: approval-request-1",
-        }),
-      ),
-    );
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.session.set",
-        commandId: CommandId.make("cmd-session-set-for-approval-error"),
-        threadId: ThreadId.make("thread-1"),
-        session: {
-          threadId: ThreadId.make("thread-1"),
-          status: "running",
-          providerName: "codex",
-          runtimeMode: "approval-required",
-          activeTurnId: null,
-          lastError: null,
-          updatedAt: now,
-        },
-        createdAt: now,
-      }),
-    );
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.activity.append",
-        commandId: CommandId.make("cmd-approval-requested"),
-        threadId: ThreadId.make("thread-1"),
-        activity: {
-          id: EventId.make("activity-approval-requested"),
-          tone: "approval",
-          kind: "approval.requested",
-          summary: "Command approval requested",
-          payload: {
-            requestId: "approval-request-1",
-            requestKind: "command",
-          },
-          turnId: null,
-          createdAt: now,
-        },
-        createdAt: now,
-      }),
-    );
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.approval.respond",
-        commandId: CommandId.make("cmd-approval-respond-stale"),
-        threadId: ThreadId.make("thread-1"),
-        requestId: asApprovalRequestId("approval-request-1"),
-        decision: "acceptForSession",
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(async () => {
-      const readModel = await harness.readModel();
-      const thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-      if (!thread) return false;
-      return thread.activities.some(
-        (activity) => activity.kind === "provider.approval.respond.failed",
-      );
-    });
-
-    const readModel = await harness.readModel();
-    const thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    expect(thread).toBeDefined();
-
-    const failureActivity = thread?.activities.find(
-      (activity) => activity.kind === "provider.approval.respond.failed",
-    );
-    expect(failureActivity).toBeDefined();
-    expect(failureActivity?.payload).toMatchObject({
-      requestId: "approval-request-1",
-      detail: expect.stringContaining("Stale pending approval request: approval-request-1"),
-    });
-
-    const resolvedActivity = thread?.activities.find(
-      (activity) =>
-        activity.kind === "approval.resolved" &&
-        typeof activity.payload === "object" &&
-        activity.payload !== null &&
-        (activity.payload as Record<string, unknown>).requestId === "approval-request-1",
-    );
-    expect(resolvedActivity).toBeUndefined();
-  });
-
-  it("surfaces non-resumable provider user-input callbacks as stale failures", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-    harness.respondToUserInput.mockImplementation(() =>
-      Effect.fail(
-        new ProviderAdapterRequestError({
-          provider: ProviderDriverKind.make("claudeAgent"),
-          method: "item/tool/respondToUserInput",
-          detail: "Unknown pending Codex user input request: user-input-request-1",
-        }),
-      ),
-    );
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.session.set",
-        commandId: CommandId.make("cmd-session-set-for-user-input-error"),
-        threadId: ThreadId.make("thread-1"),
-        session: {
-          threadId: ThreadId.make("thread-1"),
-          status: "running",
-          providerName: "claudeAgent",
-          runtimeMode: "approval-required",
-          activeTurnId: null,
-          lastError: null,
-          updatedAt: now,
-        },
-        createdAt: now,
-      }),
-    );
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.activity.append",
-        commandId: CommandId.make("cmd-user-input-requested"),
-        threadId: ThreadId.make("thread-1"),
-        activity: {
-          id: EventId.make("activity-user-input-requested"),
-          tone: "info",
-          kind: "user-input.requested",
-          summary: "User input requested",
-          payload: {
-            requestId: "user-input-request-1",
-            questions: [
-              {
-                id: "sandbox_mode",
-                header: "Sandbox",
-                question: "Which mode should be used?",
-                options: [
-                  {
-                    label: "workspace-write",
-                    description: "Allow workspace writes only",
-                  },
-                ],
-              },
-            ],
-          },
-          turnId: null,
-          createdAt: now,
-        },
-        createdAt: now,
-      }),
-    );
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.user-input.respond",
-        commandId: CommandId.make("cmd-user-input-respond-stale"),
-        threadId: ThreadId.make("thread-1"),
-        requestId: asApprovalRequestId("user-input-request-1"),
-        answers: {
-          sandbox_mode: "workspace-write",
-        },
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(async () => {
-      const readModel = await harness.readModel();
-      const thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-      if (!thread) return false;
-      return thread.activities.some(
-        (activity) => activity.kind === "provider.user-input.respond.failed",
-      );
-    });
-
-    const readModel = await harness.readModel();
-    const thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    expect(thread).toBeDefined();
-
-    const failureActivity = thread?.activities.find(
-      (activity) => activity.kind === "provider.user-input.respond.failed",
-    );
-    expect(failureActivity).toBeDefined();
-    expect(failureActivity?.payload).toMatchObject({
-      requestId: "user-input-request-1",
-      detail: expect.stringContaining("Stale pending user-input request: user-input-request-1"),
-    });
-
-    const resolvedActivity = thread?.activities.find(
-      (activity) =>
-        activity.kind === "user-input.resolved" &&
-        typeof activity.payload === "object" &&
-        activity.payload !== null &&
-        (activity.payload as Record<string, unknown>).requestId === "user-input-request-1",
-    );
-    expect(resolvedActivity).toBeUndefined();
-  });
-
-  it("reacts to thread.session.stop by stopping provider session and clearing thread session state", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.session.set",
-        commandId: CommandId.make("cmd-session-set-for-stop"),
-        threadId: ThreadId.make("thread-1"),
-        session: {
-          threadId: ThreadId.make("thread-1"),
-          status: "ready",
-          providerName: "codex",
-          providerInstanceId: ProviderInstanceId.make("codex_work"),
-          runtimeMode: "approval-required",
-          activeTurnId: null,
-          lastError: null,
-          updatedAt: now,
-        },
-        createdAt: now,
-      }),
-    );
-
-    await harness.runEffect(
-      harness.engine.dispatch({
-        type: "thread.session.stop",
-        commandId: CommandId.make("cmd-session-stop"),
-        threadId: ThreadId.make("thread-1"),
-        createdAt: now,
-      }),
-    );
-
-    await waitFor(() => harness.stopSession.mock.calls.length === 1);
-    const readModel = await harness.readModel();
-    const thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    expect(thread?.session).not.toBeNull();
-    expect(thread?.session?.status).toBe("stopped");
-    expect(thread?.session?.threadId).toBe("thread-1");
-    expect(thread?.session?.providerInstanceId).toBe(ProviderInstanceId.make("codex_work"));
-    expect(thread?.session?.activeTurnId).toBeNull();
-  });
-});
diff --git a/apps/server/src/orchestration/Layers/ProviderCommandReactor.ts b/apps/server/src/orchestration/Layers/ProviderCommandReactor.ts
deleted file mode 100644
index 22c70094ce0e..000000000000
--- a/apps/server/src/orchestration/Layers/ProviderCommandReactor.ts
+++ /dev/null
@@ -1,1574 +0,0 @@
-import {
-  type ChatAttachment,
-  CommandId,
-  EventId,
-  type ModelSelection,
-  type OrchestrationEvent,
-  ProviderDriverKind,
-  type ProjectId,
-  type OrchestrationSession,
-  ThreadId,
-  type ProviderSession,
-  type RuntimeMode,
-  type TurnId,
-} from "@t3tools/contracts";
-import { isTemporaryWorktreeBranch, WORKTREE_BRANCH_PREFIX } from "@t3tools/shared/git";
-import * as Cache from "effect/Cache";
-import * as Cause from "effect/Cause";
-import * as Crypto from "effect/Crypto";
-import * as Duration from "effect/Duration";
-import * as Effect from "effect/Effect";
-import * as Equal from "effect/Equal";
-import * as FileSystem from "effect/FileSystem";
-import * as Layer from "effect/Layer";
-import * as Option from "effect/Option";
-import * as Schedule from "effect/Schedule";
-import * as Schema from "effect/Schema";
-import * as Stream from "effect/Stream";
-import { makeDrainableWorker } from "@t3tools/shared/DrainableWorker";
-
-import { resolveThreadWorkspaceCwd } from "../../checkpointing/Utils.ts";
-import { increment, orchestrationEventsProcessedTotal } from "../../observability/Metrics.ts";
-import { ProviderAdapterRequestError } from "../../provider/Errors.ts";
-import type { ProviderServiceError } from "../../provider/Errors.ts";
-import { TextGeneration } from "../../textGeneration/TextGeneration.ts";
-import { ProviderService } from "../../provider/Services/ProviderService.ts";
-import { ProviderRegistry } from "../../provider/Services/ProviderRegistry.ts";
-import { OrchestrationEngineService } from "../Services/OrchestrationEngine.ts";
-import { ProjectionSnapshotQuery } from "../Services/ProjectionSnapshotQuery.ts";
-import {
-  ProviderCommandReactor,
-  type ProviderCommandReactorShape,
-} from "../Services/ProviderCommandReactor.ts";
-import { forkParked, ServerActivation } from "../../serverActivation.ts";
-import { canReplaceThreadTitle, DEFAULT_THREAD_TITLE } from "../threadTitles.ts";
-import {
-  resolveSourceControlWriterModelSelection,
-  ServerSettingsService,
-} from "../../serverSettings.ts";
-import { VcsStatusBroadcaster } from "../../vcs/VcsStatusBroadcaster.ts";
-import { GitWorkflowService } from "../../git/GitWorkflowService.ts";
-const isProviderAdapterRequestError = Schema.is(ProviderAdapterRequestError);
-const isProviderDriverKind = Schema.is(ProviderDriverKind);
-
-type ProviderIntentEvent = Extract<
-  OrchestrationEvent,
-  {
-    type:
-      | "thread.meta-updated"
-      | "thread.runtime-mode-set"
-      | "thread.turn-start-requested"
-      | "thread.turn-interrupt-requested"
-      | "thread.approval-response-requested"
-      | "thread.user-input-response-requested"
-      | "thread.session-stop-requested";
-  }
->;
-
-function toNonEmptyProviderInput(value: string | undefined): string | undefined {
-  const normalized = value?.trim();
-  return normalized && normalized.length > 0 ? normalized : undefined;
-}
-
-function mapProviderSessionStatusToOrchestrationStatus(
-  status: "connecting" | "ready" | "running" | "error" | "closed",
-): OrchestrationSession["status"] {
-  switch (status) {
-    case "connecting":
-      return "starting";
-    case "running":
-      return "running";
-    case "error":
-      return "error";
-    case "closed":
-      return "stopped";
-    case "ready":
-    default:
-      return "ready";
-  }
-}
-
-const turnStartKeyForEvent = (event: ProviderIntentEvent): string =>
-  event.commandId !== null ? `command:${event.commandId}` : `event:${event.eventId}`;
-
-const HANDLED_TURN_START_KEY_MAX = 10_000;
-const HANDLED_TURN_START_KEY_TTL = Duration.minutes(30);
-const DEFAULT_RUNTIME_MODE: RuntimeMode = "full-access";
-const MAX_REGENERATION_ATTACHMENTS = 4;
-const MAX_THREAD_TITLE_CONTEXT_CHARS = 8_000;
-const MAX_FIRST_USER_TITLE_CONTEXT_CHARS = 2_000;
-const THREAD_TITLE_CONTEXT_TRUNCATION_MARKER = "[Earlier content truncated]\n\n";
-const FIRST_USER_CONTEXT_TRUNCATION_MARKER = "\n[First user message truncated]";
-
-type ThreadTitleMessage = {
-  readonly role: "user" | "assistant" | "system";
-  readonly text: string;
-  readonly attachments?: ReadonlyArray<ChatAttachment> | undefined;
-};
-
-function formatThreadTitleSection(message: ThreadTitleMessage): string | undefined {
-  if (message.role === "system") {
-    return undefined;
-  }
-  const text = message.text.trim();
-  const attachmentSummary = (message.attachments ?? [])
-    .map((attachment) => attachment.name)
-    .join(", ");
-  const contents = [
-    ...(text.length > 0 ? [text] : []),
-    ...(attachmentSummary.length > 0 ? [`[Attachments: ${attachmentSummary}]`] : []),
-  ].join("\n");
-  return contents.length > 0 ? `${message.role.toUpperCase()}:\n${contents}` : undefined;
-}
-
-function limitFirstUserSection(section: string): string {
-  if (section.length <= MAX_FIRST_USER_TITLE_CONTEXT_CHARS) {
-    return section;
-  }
-  return `${section.slice(
-    0,
-    MAX_FIRST_USER_TITLE_CONTEXT_CHARS - FIRST_USER_CONTEXT_TRUNCATION_MARKER.length,
-  )}${FIRST_USER_CONTEXT_TRUNCATION_MARKER}`;
-}
-
-function collectRecentThreadTitleContext(
-  messages: ReadonlyArray<ThreadTitleMessage>,
-  maxChars: number,
-): {
-  readonly context: string;
-  readonly attachments: ReadonlyArray<ChatAttachment>;
-  readonly truncated: boolean;
-} {
-  let context = "";
-  let truncated = false;
-  const retainedAttachments: Array<ChatAttachment> = [];
-
-  for (const message of messages.toReversed()) {
-    const section = formatThreadTitleSection(message);
-    if (section === undefined) {
-      continue;
-    }
-
-    const separator = context.length > 0 ? "\n\n" : "";
-    const available = maxChars - context.length - separator.length;
-    if (section.length > available) {
-      if (available > 0) {
-        context = `${section.slice(-available)}${separator}${context}`;
-        retainedAttachments.unshift(...(message.attachments ?? []));
-      }
-      truncated = true;
-      break;
-    }
-    context = `${section}${separator}${context}`;
-    retainedAttachments.unshift(...(message.attachments ?? []));
-  }
-
-  return { context, attachments: retainedAttachments, truncated };
-}
-
-function formatThreadTitleContext(messages: ReadonlyArray<ThreadTitleMessage>): {
-  readonly message: string;
-  readonly attachments: ReadonlyArray<ChatAttachment>;
-} {
-  const recent = collectRecentThreadTitleContext(messages, MAX_THREAD_TITLE_CONTEXT_CHARS);
-  if (!recent.truncated) {
-    return {
-      message: recent.context,
-      attachments: recent.attachments.slice(-MAX_REGENERATION_ATTACHMENTS),
-    };
-  }
-
-  const firstUserMessage = messages.find(
-    (message) => message.role === "user" && formatThreadTitleSection(message),
-  );
-  const firstUserSection = firstUserMessage
-    ? formatThreadTitleSection(firstUserMessage)
-    : undefined;
-  if (!firstUserMessage || !firstUserSection) {
-    return {
-      message: `${THREAD_TITLE_CONTEXT_TRUNCATION_MARKER}${recent.context}`,
-      attachments: recent.attachments.slice(-MAX_REGENERATION_ATTACHMENTS),
-    };
-  }
-
-  const pinnedSection = limitFirstUserSection(firstUserSection);
-  const recentContextBudget =
-    MAX_THREAD_TITLE_CONTEXT_CHARS -
-    pinnedSection.length -
-    "\n\n".length -
-    THREAD_TITLE_CONTEXT_TRUNCATION_MARKER.length;
-  const retainedRecent = collectRecentThreadTitleContext(messages, recentContextBudget);
-  const pinnedAttachment = firstUserMessage.attachments?.[0];
-  const recentAttachments = retainedRecent.attachments.filter(
-    (attachment) => attachment.id !== pinnedAttachment?.id,
-  );
-
-  return {
-    message: `${pinnedSection}\n\n${THREAD_TITLE_CONTEXT_TRUNCATION_MARKER}${retainedRecent.context}`,
-    attachments: [
-      ...(pinnedAttachment ? [pinnedAttachment] : []),
-      ...recentAttachments.slice(
-        -(MAX_REGENERATION_ATTACHMENTS - (pinnedAttachment === undefined ? 0 : 1)),
-      ),
-    ],
-  };
-}
-
-export function providerErrorLabel(value: string | undefined): string {
-  const normalized = value?.trim();
-  return normalized && normalized.length > 0 ? normalized : "unknown";
-}
-
-export function providerErrorLabelFromInstanceHint(input: {
-  readonly instanceId?: string | undefined;
-  readonly modelSelectionInstanceId?: string | undefined;
-  readonly sessionProvider?: string | undefined;
-}): string {
-  return providerErrorLabel(
-    input.instanceId ?? input.modelSelectionInstanceId ?? input.sessionProvider,
-  );
-}
-
-function findProviderAdapterRequestError(
-  cause: Cause.Cause<ProviderServiceError>,
-): ProviderAdapterRequestError | undefined {
-  const failReason = cause.reasons.find(Cause.isFailReason);
-  return isProviderAdapterRequestError(failReason?.error) ? failReason.error : undefined;
-}
-
-function isUnknownPendingApprovalRequestError(cause: Cause.Cause<ProviderServiceError>): boolean {
-  const error = findProviderAdapterRequestError(cause);
-  if (error) {
-    const detail = error.detail.toLowerCase();
-    return (
-      detail.includes("unknown pending approval request") ||
-      detail.includes("unknown pending permission request") ||
-      detail.includes("unknown pending codex approval request")
-    );
-  }
-  const message = Cause.pretty(cause).toLowerCase();
-  return (
-    message.includes("unknown pending approval request") ||
-    message.includes("unknown pending permission request") ||
-    message.includes("unknown pending codex approval request")
-  );
-}
-
-function isUnknownPendingUserInputRequestError(cause: Cause.Cause<ProviderServiceError>): boolean {
-  const error = findProviderAdapterRequestError(cause);
-  if (error) {
-    const detail = error.detail.toLowerCase();
-    return (
-      detail.includes("unknown pending user-input request") ||
-      detail.includes("unknown pending user input request") ||
-      detail.includes("unknown pending codex user input request")
-    );
-  }
-  const message = Cause.pretty(cause).toLowerCase();
-  return (
-    message.includes("unknown pending user-input request") ||
-    message.includes("unknown pending user input request") ||
-    message.includes("unknown pending codex user input request")
-  );
-}
-
-function stalePendingRequestDetail(
-  requestKind: "approval" | "user-input",
-  requestId: string,
-): string {
-  return `Stale pending ${requestKind} request: ${requestId}. Provider callback state does not survive app restarts or recovered sessions. Restart the turn to continue.`;
-}
-
-function buildGeneratedWorktreeBranchName(raw: string): string {
-  const normalized = raw
-    .trim()
-    .toLowerCase()
-    .replace(/^refs\/heads\//, "")
-    .replace(/['"`]/g, "");
-
-  const withoutPrefix = normalized.startsWith(`${WORKTREE_BRANCH_PREFIX}/`)
-    ? normalized.slice(`${WORKTREE_BRANCH_PREFIX}/`.length)
-    : normalized;
-
-  const branchFragment = withoutPrefix
-    .replace(/[^a-z0-9/_-]+/g, "-")
-    .replace(/\/+/g, "/")
-    .replace(/-+/g, "-")
-    .replace(/^[./_-]+|[./_-]+$/g, "")
-    .slice(0, 64)
-    .replace(/[./_-]+$/g, "");
-
-  const safeFragment = branchFragment.length > 0 ? branchFragment : "update";
-  return `${WORKTREE_BRANCH_PREFIX}/${safeFragment}`;
-}
-
-const make = Effect.gen(function* () {
-  const crypto = yield* Crypto.Crypto;
-  const orchestrationEngine = yield* OrchestrationEngineService;
-  const projectionSnapshotQuery = yield* ProjectionSnapshotQuery;
-  const providerService = yield* ProviderService;
-  const providerRegistry = yield* ProviderRegistry;
-  const gitWorkflow = yield* GitWorkflowService;
-  const fileSystem = yield* FileSystem.FileSystem;
-  const vcsStatusBroadcaster = yield* VcsStatusBroadcaster;
-  const textGeneration = yield* TextGeneration;
-  const serverSettingsService = yield* ServerSettingsService;
-  const serverCommandId = (tag: string) =>
-    crypto.randomUUIDv4.pipe(Effect.map((uuid) => CommandId.make(`server:${tag}:${uuid}`)));
-  const serverEventId = () => crypto.randomUUIDv4.pipe(Effect.map(EventId.make));
-  const handledTurnStartKeys = yield* Cache.make<string, true>({
-    capacity: HANDLED_TURN_START_KEY_MAX,
-    timeToLive: HANDLED_TURN_START_KEY_TTL,
-    lookup: () => Effect.succeed(true),
-  });
-
-  const hasHandledTurnStartRecently = (key: string) =>
-    Cache.getOption(handledTurnStartKeys, key).pipe(
-      Effect.flatMap((cached) =>
-        Cache.set(handledTurnStartKeys, key, true).pipe(Effect.as(Option.isSome(cached))),
-      ),
-    );
-
-  const threadModelSelections = new Map<string, ModelSelection>();
-
-  const appendProviderFailureActivity = (input: {
-    readonly threadId: ThreadId;
-    readonly kind:
-      | "provider.turn.start.failed"
-      | "provider.turn.interrupt.failed"
-      | "provider.approval.respond.failed"
-      | "provider.user-input.respond.failed"
-      | "provider.session.stop.failed";
-    readonly summary: string;
-    readonly detail: string;
-    readonly turnId: TurnId | null;
-    readonly createdAt: string;
-    readonly requestId?: string;
-  }) =>
-    Effect.all({
-      commandId: serverCommandId("provider-failure-activity"),
-      eventId: serverEventId(),
-    }).pipe(
-      Effect.flatMap(({ commandId, eventId }) =>
-        orchestrationEngine.dispatch({
-          type: "thread.activity.append",
-          commandId,
-          threadId: input.threadId,
-          activity: {
-            id: eventId,
-            tone: "error",
-            kind: input.kind,
-            summary: input.summary,
-            payload: {
-              detail: input.detail,
-              ...(input.requestId ? { requestId: input.requestId } : {}),
-            },
-            turnId: input.turnId,
-            createdAt: input.createdAt,
-          },
-          createdAt: input.createdAt,
-        }),
-      ),
-    );
-
-  const formatFailureDetail = (cause: Cause.Cause<unknown>): string => {
-    const failReason = cause.reasons.find(Cause.isFailReason);
-    const providerError = isProviderAdapterRequestError(failReason?.error)
-      ? failReason.error
-      : undefined;
-    if (providerError) {
-      return providerError.detail;
-    }
-    return Cause.pretty(cause);
-  };
-
-  const setThreadSession = (input: {
-    readonly threadId: ThreadId;
-    readonly session: OrchestrationSession;
-    readonly createdAt: string;
-  }) =>
-    serverCommandId("provider-session-set").pipe(
-      Effect.flatMap((commandId) =>
-        orchestrationEngine.dispatch({
-          type: "thread.session.set",
-          commandId,
-          threadId: input.threadId,
-          session: input.session,
-          createdAt: input.createdAt,
-        }),
-      ),
-    );
-
-  const setThreadSessionErrorOnTurnStartFailure = Effect.fnUntraced(function* (input: {
-    readonly threadId: ThreadId;
-    readonly detail: string;
-    readonly createdAt: string;
-  }) {
-    const thread = yield* resolveThread(input.threadId);
-    if (!thread) {
-      return;
-    }
-    const session = thread.session;
-    yield* setThreadSession({
-      threadId: input.threadId,
-      session: {
-        ...(session ?? {
-          threadId: input.threadId,
-          providerName: null,
-          providerInstanceId: thread.modelSelection.instanceId,
-          runtimeMode: thread.runtimeMode,
-        }),
-        status: session?.status === "stopped" ? "stopped" : "error",
-        activeTurnId: null,
-        lastError: input.detail,
-        updatedAt: input.createdAt,
-      },
-      createdAt: input.createdAt,
-    });
-  });
-
-  const resolveProject = Effect.fnUntraced(function* (projectId: ProjectId) {
-    return yield* projectionSnapshotQuery
-      .getProjectShellById(projectId)
-      .pipe(Effect.map(Option.getOrUndefined));
-  });
-
-  /**
-   * Recreates a thread's worktree from its branch when the directory has
-   * disappeared. Provider sessions resume into the persisted cwd, so a missing
-   * worktree makes every later turn fail as a bogus "session not found".
-   * Best-effort: on failure the turn proceeds and reports the real error.
-   */
-  const ensureThreadWorktree = Effect.fnUntraced(function* (thread: {
-    readonly id: ThreadId;
-    readonly projectId: ProjectId;
-    readonly branch: string | null;
-    readonly worktreePath: string | null;
-  }) {
-    const { worktreePath, branch } = thread;
-    if (!worktreePath || !branch) {
-      return;
-    }
-    const exists = yield* fileSystem.exists(worktreePath).pipe(Effect.orElseSucceed(() => true));
-    if (exists) {
-      return;
-    }
-    const project = yield* resolveProject(thread.projectId);
-    if (!project) {
-      return;
-    }
-    const cwd = project.workspaceRoot;
-    yield* Effect.logWarning("provider command reactor recreating missing worktree", {
-      threadId: thread.id,
-      worktreePath,
-      branch,
-    });
-    // A directory deleted without `git worktree remove` leaves an admin entry
-    // that makes `git worktree add` refuse the path; prune clears it.
-    yield* gitWorkflow.pruneWorktrees({ cwd }).pipe(
-      Effect.andThen(gitWorkflow.createWorktree({ cwd, refName: branch, path: worktreePath })),
-      Effect.catchCause((cause) =>
-        Cause.hasInterruptsOnly(cause)
-          ? Effect.failCause(cause)
-          : Effect.logWarning("provider command reactor failed to recreate worktree", {
-              threadId: thread.id,
-              worktreePath,
-              cause: Cause.pretty(cause),
-            }),
-      ),
-    );
-  });
-
-  const resolveThread = Effect.fnUntraced(function* (threadId: ThreadId) {
-    return yield* projectionSnapshotQuery
-      .getThreadDetailById(threadId)
-      .pipe(Effect.map(Option.getOrUndefined));
-  });
-
-  const rejectStartedThreadModelChangeIfRequired = Effect.fnUntraced(function* (input: {
-    readonly threadId: ThreadId;
-    readonly currentModelSelection: ModelSelection;
-    readonly requestedModelSelection: ModelSelection | undefined;
-  }) {
-    const requestedModelSelection = input.requestedModelSelection;
-    if (
-      requestedModelSelection === undefined ||
-      (input.currentModelSelection.instanceId === requestedModelSelection.instanceId &&
-        input.currentModelSelection.model === requestedModelSelection.model)
-    ) {
-      return;
-    }
-    const providers = yield* providerRegistry.getProviders;
-    const requiresNewThread =
-      providers.find((snapshot) => snapshot.instanceId === input.currentModelSelection.instanceId)
-        ?.requiresNewThreadForModelChange === true ||
-      providers.find((snapshot) => snapshot.instanceId === requestedModelSelection.instanceId)
-        ?.requiresNewThreadForModelChange === true;
-    if (!requiresNewThread) {
-      return;
-    }
-    return yield* new ProviderAdapterRequestError({
-      provider: providerErrorLabelFromInstanceHint({
-        instanceId: String(requestedModelSelection.instanceId),
-        modelSelectionInstanceId: String(input.currentModelSelection.instanceId),
-      }),
-      method: "thread.turn.start",
-      detail: `Thread '${input.threadId}' cannot switch models after the conversation has started. Start a new thread to use '${requestedModelSelection.model}'.`,
-    });
-  });
-
-  const ensureSessionForThread = Effect.fn("ensureSessionForThread")(function* (
-    threadId: ThreadId,
-    createdAt: string,
-    options?: {
-      readonly modelSelection?: ModelSelection;
-      readonly pendingTurnStart?: boolean;
-    },
-  ) {
-    const thread = yield* resolveThread(threadId);
-    if (!thread) {
-      return yield* Effect.die(new Error(`Thread '${threadId}' was not found in read model.`));
-    }
-
-    const desiredRuntimeMode = thread.runtimeMode;
-    const requestedModelSelection = options?.modelSelection;
-    const resolveActiveSession = (threadId: ThreadId) =>
-      providerService
-        .listSessions()
-        .pipe(Effect.map((sessions) => sessions.find((session) => session.threadId === threadId)));
-
-    const activeSession = yield* resolveActiveSession(threadId);
-    const activeThreadSession =
-      thread.session !== null && thread.session.status !== "stopped" && activeSession
-        ? thread.session
-        : null;
-    if (
-      activeThreadSession !== null &&
-      activeSession !== undefined &&
-      (activeThreadSession.providerInstanceId === undefined ||
-        activeSession.providerInstanceId === undefined)
-    ) {
-      return yield* new ProviderAdapterRequestError({
-        provider: providerErrorLabel(activeThreadSession.providerName ?? undefined),
-        method: "thread.turn.start",
-        detail: `Thread '${threadId}' has an active provider session without a provider instance id.`,
-      });
-    }
-    const currentInstanceId =
-      activeThreadSession !== null &&
-      activeSession !== undefined &&
-      activeSession.providerInstanceId !== undefined
-        ? activeSession.providerInstanceId
-        : thread.modelSelection.instanceId;
-    const desiredModelSelection = requestedModelSelection ?? thread.modelSelection;
-    const desiredInstanceId = desiredModelSelection.instanceId;
-    const currentInfo = yield* providerService.getInstanceInfo(currentInstanceId).pipe(
-      Effect.mapError(
-        () =>
-          new ProviderAdapterRequestError({
-            provider: providerErrorLabelFromInstanceHint({
-              instanceId: String(currentInstanceId),
-              modelSelectionInstanceId: String(thread.modelSelection.instanceId),
-              sessionProvider: thread.session?.providerName ?? undefined,
-            }),
-            method: "thread.turn.start",
-            detail: `Thread '${threadId}' references unknown provider instance '${currentInstanceId}'. The instance is not configured in this build.`,
-          }),
-      ),
-    );
-    const desiredInfo = yield* providerService.getInstanceInfo(desiredInstanceId).pipe(
-      Effect.mapError(
-        () =>
-          new ProviderAdapterRequestError({
-            provider: providerErrorLabelFromInstanceHint({
-              instanceId: String(desiredModelSelection.instanceId),
-            }),
-            method: "thread.turn.start",
-            detail: `Requested provider instance '${desiredInstanceId}' is not configured in this build.`,
-          }),
-      ),
-    );
-    const desiredDriverKind = desiredInfo.driverKind;
-    if (!isProviderDriverKind(desiredDriverKind)) {
-      return yield* new ProviderAdapterRequestError({
-        provider: providerErrorLabel(String(desiredDriverKind)),
-        method: "thread.turn.start",
-        detail: `Requested provider instance '${desiredInstanceId}' uses unknown provider driver '${desiredDriverKind}'. The driver is not installed in this build.`,
-      });
-    }
-    const preferredProvider: ProviderDriverKind = desiredDriverKind;
-    if (options?.pendingTurnStart === true && thread.session?.status !== "running") {
-      yield* setThreadSession({
-        threadId,
-        session: {
-          threadId,
-          status: "starting",
-          providerName: activeSession?.provider ?? preferredProvider,
-          providerInstanceId: activeSession?.providerInstanceId ?? desiredInstanceId,
-          runtimeMode: desiredRuntimeMode,
-          activeTurnId: null,
-          lastError: null,
-          updatedAt: createdAt,
-        },
-        createdAt,
-      });
-    }
-    if (thread.session !== null) {
-      yield* rejectStartedThreadModelChangeIfRequired({
-        threadId,
-        currentModelSelection:
-          activeSession?.model !== undefined
-            ? {
-                ...thread.modelSelection,
-                instanceId: currentInstanceId,
-                model: activeSession.model,
-              }
-            : thread.modelSelection,
-        requestedModelSelection,
-      });
-    }
-    if (
-      thread.session !== null &&
-      requestedModelSelection !== undefined &&
-      requestedModelSelection.instanceId !== currentInstanceId
-    ) {
-      if (currentInfo.driverKind !== desiredInfo.driverKind) {
-        return yield* new ProviderAdapterRequestError({
-          provider: preferredProvider,
-          method: "thread.turn.start",
-          detail: `Thread '${threadId}' is bound to driver '${currentInfo.driverKind}' and cannot switch to '${desiredInfo.driverKind}'.`,
-        });
-      }
-      if (
-        currentInfo.continuationIdentity.continuationKey !==
-        desiredInfo.continuationIdentity.continuationKey
-      ) {
-        return yield* new ProviderAdapterRequestError({
-          provider: preferredProvider,
-          method: "thread.turn.start",
-          detail: `Thread '${threadId}' cannot switch from instance '${currentInstanceId}' to '${desiredInstanceId}' because their provider resume state is incompatible.`,
-        });
-      }
-    }
-    const project = yield* resolveProject(thread.projectId);
-    const effectiveCwd = resolveThreadWorkspaceCwd({
-      thread,
-      projects: project ? [project] : [],
-    });
-
-    const startProviderSession = (input?: {
-      readonly resumeCursor?: unknown;
-      readonly provider?: ProviderDriverKind;
-    }) =>
-      providerService.startSession(threadId, {
-        threadId,
-        ...(preferredProvider ? { provider: preferredProvider } : {}),
-        providerInstanceId: desiredInstanceId,
-        ...(effectiveCwd ? { cwd: effectiveCwd } : {}),
-        ...(thread.title ? { title: thread.title } : {}),
-        modelSelection: desiredModelSelection,
-        ...(input?.resumeCursor !== undefined ? { resumeCursor: input.resumeCursor } : {}),
-        runtimeMode: desiredRuntimeMode,
-      });
-
-    const bindSessionToThread = (session: ProviderSession) =>
-      Effect.gen(function* () {
-        if (session.providerInstanceId === undefined) {
-          return yield* new ProviderAdapterRequestError({
-            provider: providerErrorLabel(session.provider),
-            method: "thread.turn.start",
-            detail: `Provider session '${session.threadId}' started without a provider instance id.`,
-          });
-        }
-        yield* setThreadSession({
-          threadId,
-          session: {
-            threadId,
-            status:
-              options?.pendingTurnStart === true && session.status === "ready"
-                ? "starting"
-                : mapProviderSessionStatusToOrchestrationStatus(session.status),
-            providerName: session.provider,
-            providerInstanceId: session.providerInstanceId,
-            runtimeMode: desiredRuntimeMode,
-            // Provider turn ids are not orchestration turn ids.
-            activeTurnId: null,
-            lastError: session.lastError ?? null,
-            updatedAt: session.updatedAt,
-          },
-          createdAt,
-        });
-      });
-
-    const existingSessionThreadId =
-      thread.session && thread.session.status !== "stopped" && activeSession ? thread.id : null;
-    if (existingSessionThreadId) {
-      const runtimeModeChanged = thread.runtimeMode !== thread.session?.runtimeMode;
-      const cwdChanged = effectiveCwd !== activeSession?.cwd;
-      const sessionModelSwitch = (yield* providerService.getCapabilities(desiredInstanceId))
-        .sessionModelSwitch;
-      const modelChanged =
-        requestedModelSelection !== undefined &&
-        requestedModelSelection.model !== activeSession?.model;
-      const instanceChanged =
-        requestedModelSelection !== undefined &&
-        activeSession?.providerInstanceId !== requestedModelSelection.instanceId;
-      const shouldRestartForModelChange = modelChanged && sessionModelSwitch === "unsupported";
-      const previousModelSelection = threadModelSelections.get(threadId);
-      const shouldRestartForModelSelectionChange =
-        preferredProvider === "claudeAgent" &&
-        requestedModelSelection !== undefined &&
-        !Equal.equals(previousModelSelection, requestedModelSelection);
-
-      if (
-        !runtimeModeChanged &&
-        !cwdChanged &&
-        !instanceChanged &&
-        !shouldRestartForModelChange &&
-        !shouldRestartForModelSelectionChange
-      ) {
-        return existingSessionThreadId;
-      }
-
-      const resumeCursor = shouldRestartForModelChange
-        ? undefined
-        : (activeSession?.resumeCursor ?? undefined);
-      yield* Effect.logInfo("provider command reactor restarting provider session", {
-        threadId,
-        existingSessionThreadId,
-        currentProvider: activeSession?.provider,
-        currentInstanceId,
-        desiredInstanceId,
-        desiredProvider: desiredModelSelection.instanceId,
-        currentRuntimeMode: thread.session?.runtimeMode,
-        desiredRuntimeMode: thread.runtimeMode,
-        runtimeModeChanged,
-        previousCwd: activeSession?.cwd,
-        desiredCwd: effectiveCwd,
-        cwdChanged,
-        modelChanged,
-        instanceChanged,
-        shouldRestartForModelChange,
-        shouldRestartForModelSelectionChange,
-        hasResumeCursor: resumeCursor !== undefined,
-      });
-      const restartedSession = yield* startProviderSession(
-        resumeCursor !== undefined ? { resumeCursor } : undefined,
-      );
-      yield* Effect.logInfo("provider command reactor restarted provider session", {
-        threadId,
-        previousSessionId: existingSessionThreadId,
-        restartedSessionThreadId: restartedSession.threadId,
-        provider: restartedSession.provider,
-        runtimeMode: restartedSession.runtimeMode,
-        cwd: restartedSession.cwd,
-      });
-      yield* bindSessionToThread(restartedSession);
-      return restartedSession.threadId;
-    }
-
-    const startedSession = yield* startProviderSession(undefined);
-    yield* bindSessionToThread(startedSession);
-    return startedSession.threadId;
-  });
-
-  const buildSendTurnRequestForThread = Effect.fnUntraced(function* (input: {
-    readonly threadId: ThreadId;
-    readonly messageText: string;
-    readonly attachments?: ReadonlyArray<ChatAttachment>;
-    readonly modelSelection?: ModelSelection;
-    readonly interactionMode?: "default" | "plan";
-    readonly createdAt: string;
-  }) {
-    const thread = yield* resolveThread(input.threadId);
-    if (!thread) {
-      return yield* Effect.die(
-        new Error(`Thread '${input.threadId}' was not found in read model.`),
-      );
-    }
-    yield* ensureSessionForThread(input.threadId, input.createdAt, {
-      ...(input.modelSelection !== undefined ? { modelSelection: input.modelSelection } : {}),
-      pendingTurnStart: true,
-    });
-    if (input.modelSelection !== undefined) {
-      threadModelSelections.set(input.threadId, input.modelSelection);
-    }
-    const normalizedInput = toNonEmptyProviderInput(input.messageText);
-    const normalizedAttachments = input.attachments ?? [];
-    const activeSession = yield* providerService
-      .listSessions()
-      .pipe(
-        Effect.map((sessions) => sessions.find((session) => session.threadId === input.threadId)),
-      );
-    const sessionModelSwitch =
-      activeSession === undefined
-        ? "in-session"
-        : activeSession.providerInstanceId === undefined
-          ? yield* new ProviderAdapterRequestError({
-              provider: providerErrorLabel(activeSession.provider),
-              method: "thread.turn.start",
-              detail: `Active provider session '${activeSession.threadId}' is missing a provider instance id.`,
-            })
-          : (yield* providerService.getCapabilities(activeSession.providerInstanceId))
-              .sessionModelSwitch;
-    const requestedModelSelection =
-      input.modelSelection ?? threadModelSelections.get(input.threadId) ?? thread.modelSelection;
-    const modelForTurn =
-      sessionModelSwitch === "unsupported" && input.modelSelection === undefined
-        ? activeSession?.model !== undefined
-          ? {
-              ...requestedModelSelection,
-              model: activeSession.model,
-            }
-          : requestedModelSelection
-        : input.modelSelection;
-
-    return {
-      threadId: input.threadId,
-      ...(normalizedInput ? { input: normalizedInput } : {}),
-      ...(normalizedAttachments.length > 0 ? { attachments: normalizedAttachments } : {}),
-      ...(modelForTurn !== undefined ? { modelSelection: modelForTurn } : {}),
-      ...(input.interactionMode !== undefined ? { interactionMode: input.interactionMode } : {}),
-    };
-  });
-
-  const maybeGenerateAndRenameWorktreeBranchForFirstTurn = Effect.fn(
-    "maybeGenerateAndRenameWorktreeBranchForFirstTurn",
-  )(function* (input: {
-    readonly threadId: ThreadId;
-    readonly branch: string | null;
-    readonly worktreePath: string | null;
-    readonly messageText: string;
-    readonly attachments?: ReadonlyArray<ChatAttachment>;
-  }) {
-    if (!input.branch || !input.worktreePath) {
-      return;
-    }
-    if (!isTemporaryWorktreeBranch(input.branch)) {
-      return;
-    }
-
-    const oldBranch = input.branch;
-    const cwd = input.worktreePath;
-    const attachments = input.attachments ?? [];
-    yield* Effect.gen(function* () {
-      const settings = yield* serverSettingsService.getSettings;
-      const modelSelection =
-        settings.sourceControlWriterModelSelection === null
-          ? settings.textGenerationModelSelection
-          : resolveSourceControlWriterModelSelection(
-              settings,
-              yield* providerRegistry.getProviders,
-            );
-
-      const generated = yield* textGeneration.generateBranchName({
-        cwd,
-        message: input.messageText,
-        ...(attachments.length > 0 ? { attachments } : {}),
-        modelSelection,
-      });
-      if (!generated) return;
-
-      const targetBranch = buildGeneratedWorktreeBranchName(generated.branch);
-      if (targetBranch === oldBranch) return;
-
-      const renamed = yield* gitWorkflow.renameBranch({ cwd, oldBranch, newBranch: targetBranch });
-      yield* orchestrationEngine.dispatch({
-        type: "thread.meta.update",
-        commandId: yield* serverCommandId("worktree-branch-rename"),
-        threadId: input.threadId,
-        branch: renamed.branch,
-        worktreePath: cwd,
-      });
-      yield* vcsStatusBroadcaster.refreshStatus(cwd).pipe(Effect.ignoreCause({ log: true }));
-    }).pipe(
-      Effect.catchCause((cause) =>
-        Effect.logWarning("provider command reactor failed to generate or rename worktree branch", {
-          threadId: input.threadId,
-          cwd,
-          oldBranch,
-          cause: Cause.pretty(cause),
-        }),
-      ),
-    );
-  });
-
-  const maybeGenerateThreadTitleForFirstTurn = Effect.fn("maybeGenerateThreadTitleForFirstTurn")(
-    function* (input: {
-      readonly threadId: ThreadId;
-      readonly cwd: string;
-      readonly messageText: string;
-      readonly attachments?: ReadonlyArray<ChatAttachment>;
-      readonly titleSeed?: string;
-    }) {
-      const attachments = input.attachments ?? [];
-      yield* Effect.gen(function* () {
-        const { textGenerationModelSelection: modelSelection } =
-          yield* serverSettingsService.getSettings;
-
-        const generated = yield* textGeneration
-          .generateThreadTitle({
-            cwd: input.cwd,
-            message: input.messageText,
-            ...(attachments.length > 0 ? { attachments } : {}),
-            modelSelection,
-          })
-          .pipe(
-            Effect.retry({
-              times: 2,
-              schedule: Schedule.exponential("2 seconds"),
-            }),
-          );
-        if (!generated) return;
-
-        const thread = yield* resolveThread(input.threadId);
-        if (!thread) return;
-        if (!canReplaceThreadTitle(thread.title, input.titleSeed)) {
-          return;
-        }
-
-        yield* orchestrationEngine.dispatch({
-          type: "thread.meta.update",
-          commandId: yield* serverCommandId("thread-title-rename"),
-          threadId: input.threadId,
-          title: generated.title,
-        });
-      }).pipe(
-        Effect.catchCause((cause) =>
-          Effect.logWarning("provider command reactor failed to generate or rename thread title", {
-            threadId: input.threadId,
-            cwd: input.cwd,
-            cause: Cause.pretty(cause),
-          }),
-        ),
-      );
-    },
-  );
-
-  const regenerateThreadTitle = Effect.fn("regenerateThreadTitle")(function* (
-    event: Extract<ProviderIntentEvent, { type: "thread.meta-updated" }>,
-    requestId: CommandId,
-  ) {
-    if (event.payload.regenerateTitle !== true) {
-      return { _tag: "Superseded" } as const;
-    }
-
-    const thread = yield* resolveThread(event.payload.threadId);
-    if (!thread || thread.titleRegeneration?.requestId !== requestId) {
-      return { _tag: "Superseded" } as const;
-    }
-
-    const { message, attachments } = formatThreadTitleContext(thread.messages);
-    if (message.length === 0) {
-      return { _tag: "Completed", title: undefined } as const;
-    }
-
-    const previousTitle = event.payload.previousTitle ?? thread.title;
-    if (thread.title !== previousTitle) {
-      return { _tag: "Superseded" } as const;
-    }
-    const project = yield* resolveProject(thread.projectId);
-    const cwd =
-      resolveThreadWorkspaceCwd({
-        thread,
-        projects: project ? [project] : [],
-      }) ?? process.cwd();
-    const { textGenerationModelSelection: modelSelection } =
-      yield* serverSettingsService.getSettings;
-    const generated = yield* textGeneration.generateThreadTitle({
-      cwd,
-      message,
-      previousTitle,
-      ...(attachments.length > 0 ? { attachments } : {}),
-      modelSelection,
-    });
-    if (generated.title === DEFAULT_THREAD_TITLE || generated.title === previousTitle) {
-      return { _tag: "Completed", title: undefined } as const;
-    }
-
-    const latestThread = yield* resolveThread(event.payload.threadId);
-    if (
-      !latestThread ||
-      latestThread.titleRegeneration?.requestId !== requestId ||
-      latestThread.title !== previousTitle
-    ) {
-      return { _tag: "Superseded" } as const;
-    }
-
-    return { _tag: "Completed", title: generated.title } as const;
-  });
-  const dispatchThreadTitleRegenerationCompletion = Effect.fn(
-    "dispatchThreadTitleRegenerationCompletion",
-  )(function* (input: {
-    readonly threadId: ThreadId;
-    readonly requestId: CommandId;
-    readonly title?: string;
-  }) {
-    yield* orchestrationEngine.dispatch({
-      type: "thread.title.regeneration.complete",
-      commandId: yield* serverCommandId("thread-title-regeneration-complete"),
-      threadId: input.threadId,
-      requestId: input.requestId,
-      ...(input.title !== undefined ? { title: input.title } : {}),
-    });
-  });
-  const findInterruptedThreadTitleRegenerations = Effect.fn(
-    "findInterruptedThreadTitleRegenerations",
-  )(function* () {
-    const readModel = yield* projectionSnapshotQuery.getCommandReadModel();
-    return readModel.threads.flatMap((thread) => {
-      const requestId = thread.titleRegeneration?.requestId;
-      return requestId === undefined ? [] : [{ threadId: thread.id, requestId }];
-    });
-  });
-  const clearInterruptedThreadTitleRegenerations = Effect.fn(
-    "clearInterruptedThreadTitleRegenerations",
-  )(function* (
-    interrupted: ReadonlyArray<{ readonly threadId: ThreadId; readonly requestId: CommandId }>,
-  ) {
-    yield* Effect.forEach(
-      interrupted,
-      ({ threadId, requestId }) => {
-        return dispatchThreadTitleRegenerationCompletion({
-          threadId,
-          requestId,
-        }).pipe(
-          Effect.catchCause((cause) => {
-            if (Cause.hasInterruptsOnly(cause)) {
-              return Effect.interrupt;
-            }
-            return Effect.logWarning(
-              "provider command reactor failed to clear interrupted title regeneration",
-              {
-                threadId,
-                cause: Cause.pretty(cause),
-              },
-            );
-          }),
-        );
-      },
-      { discard: true },
-    );
-  });
-  const processThreadTitleRegenerationSafely = Effect.fn("processThreadTitleRegenerationSafely")(
-    function* (event: Extract<ProviderIntentEvent, { type: "thread.meta-updated" }>) {
-      if (event.payload.regenerateTitle !== true) {
-        return;
-      }
-
-      const requestId = event.payload.titleRegeneration?.requestId ?? event.commandId;
-      if (requestId === null) {
-        return;
-      }
-      const result = yield* regenerateThreadTitle(event, requestId).pipe(
-        Effect.catchCause((cause) => {
-          if (Cause.hasInterruptsOnly(cause)) {
-            return Effect.failCause(cause);
-          }
-          return Effect.logWarning("provider command reactor failed to regenerate thread title", {
-            threadId: event.payload.threadId,
-            cause: Cause.pretty(cause),
-          }).pipe(Effect.as({ _tag: "Completed", title: undefined } as const));
-        }),
-      );
-      if (result._tag === "Superseded") {
-        return;
-      }
-
-      const completion = {
-        threadId: event.payload.threadId,
-        requestId,
-        ...(result.title !== undefined ? { title: result.title } : {}),
-      };
-      yield* dispatchThreadTitleRegenerationCompletion(completion).pipe(
-        Effect.catchCause((cause) => {
-          if (Cause.hasInterruptsOnly(cause)) {
-            return Effect.failCause(cause);
-          }
-          return Effect.logWarning(
-            "provider command reactor retrying title regeneration completion",
-            {
-              threadId: event.payload.threadId,
-              cause: Cause.pretty(cause),
-            },
-          ).pipe(Effect.andThen(dispatchThreadTitleRegenerationCompletion(completion)));
-        }),
-      );
-    },
-    (effect, event) =>
-      effect.pipe(
-        Effect.catchCause((cause) => {
-          if (Cause.hasInterruptsOnly(cause)) {
-            return Effect.failCause(cause);
-          }
-          return Effect.logWarning(
-            "provider command reactor failed to complete title regeneration",
-            {
-              threadId: event.payload.threadId,
-              cause: Cause.pretty(cause),
-            },
-          );
-        }),
-      ),
-  );
-  const threadTitleRegenerationWorker = yield* makeDrainableWorker(
-    processThreadTitleRegenerationSafely,
-  );
-
-  const processTurnStartRequested = Effect.fn("processTurnStartRequested")(function* (
-    event: Extract<ProviderIntentEvent, { type: "thread.turn-start-requested" }>,
-  ) {
-    const key = turnStartKeyForEvent(event);
-    if (yield* hasHandledTurnStartRecently(key)) {
-      return;
-    }
-
-    const thread = yield* resolveThread(event.payload.threadId);
-    if (!thread) {
-      return;
-    }
-
-    const message = thread.messages.find((entry) => entry.id === event.payload.messageId);
-    if (!message || message.role !== "user") {
-      yield* appendProviderFailureActivity({
-        threadId: event.payload.threadId,
-        kind: "provider.turn.start.failed",
-        summary: "Provider turn start failed",
-        detail: `User message '${event.payload.messageId}' was not found for turn start request.`,
-        turnId: null,
-        createdAt: event.payload.createdAt,
-      });
-      return;
-    }
-
-    yield* ensureThreadWorktree(thread);
-
-    const isFirstUserMessageTurn =
-      thread.messages.filter((entry) => entry.role === "user").length === 1;
-    if (isFirstUserMessageTurn) {
-      const project = yield* resolveProject(thread.projectId);
-      const generationCwd =
-        resolveThreadWorkspaceCwd({
-          thread,
-          projects: project ? [project] : [],
-        }) ?? process.cwd();
-      const generationInput = {
-        messageText: message.text,
-        ...(message.attachments !== undefined ? { attachments: message.attachments } : {}),
-        ...(event.payload.titleSeed !== undefined ? { titleSeed: event.payload.titleSeed } : {}),
-      };
-
-      yield* maybeGenerateAndRenameWorktreeBranchForFirstTurn({
-        threadId: event.payload.threadId,
-        branch: thread.branch,
-        worktreePath: thread.worktreePath,
-        ...generationInput,
-      }).pipe(Effect.forkScoped);
-
-      if (canReplaceThreadTitle(thread.title, event.payload.titleSeed)) {
-        yield* maybeGenerateThreadTitleForFirstTurn({
-          threadId: event.payload.threadId,
-          cwd: generationCwd,
-          ...generationInput,
-        }).pipe(Effect.forkScoped);
-      }
-    }
-
-    const handleTurnStartFailure = (cause: Cause.Cause<unknown>) => {
-      if (Cause.hasInterruptsOnly(cause)) {
-        return Effect.void;
-      }
-      const detail = formatFailureDetail(cause);
-      return setThreadSessionErrorOnTurnStartFailure({
-        threadId: event.payload.threadId,
-        detail,
-        createdAt: event.payload.createdAt,
-      }).pipe(
-        Effect.flatMap(() =>
-          appendProviderFailureActivity({
-            threadId: event.payload.threadId,
-            kind: "provider.turn.start.failed",
-            summary: "Provider turn start failed",
-            detail,
-            turnId: null,
-            createdAt: event.payload.createdAt,
-          }),
-        ),
-        Effect.asVoid,
-      );
-    };
-
-    const recoverTurnStartFailure = (cause: Cause.Cause<unknown>) =>
-      handleTurnStartFailure(cause).pipe(
-        Effect.catchCause((recoveryCause) =>
-          Effect.logWarning("provider command reactor failed to recover turn start failure", {
-            eventType: event.type,
-            threadId: event.payload.threadId,
-            cause: Cause.pretty(recoveryCause),
-            originalCause: Cause.pretty(cause),
-          }),
-        ),
-      );
-
-    const sendTurnRequest = yield* buildSendTurnRequestForThread({
-      threadId: event.payload.threadId,
-      messageText: message.text,
-      ...(message.attachments !== undefined ? { attachments: message.attachments } : {}),
-      ...(event.payload.modelSelection !== undefined
-        ? { modelSelection: event.payload.modelSelection }
-        : {}),
-      interactionMode: event.payload.interactionMode,
-      createdAt: event.payload.createdAt,
-    }).pipe(
-      Effect.map(Option.some),
-      Effect.catchCause((cause) => handleTurnStartFailure(cause).pipe(Effect.as(Option.none()))),
-    );
-
-    if (Option.isNone(sendTurnRequest)) {
-      return;
-    }
-
-    yield* providerService
-      .sendTurn(sendTurnRequest.value)
-      .pipe(Effect.catchCause(recoverTurnStartFailure), Effect.forkScoped);
-  });
-
-  const processTurnInterruptRequested = Effect.fn("processTurnInterruptRequested")(function* (
-    event: Extract<ProviderIntentEvent, { type: "thread.turn-interrupt-requested" }>,
-  ) {
-    const thread = yield* resolveThread(event.payload.threadId);
-    if (!thread) {
-      return;
-    }
-    const session = thread.session;
-    if (!session || session.status === "stopped") {
-      return yield* appendProviderFailureActivity({
-        threadId: event.payload.threadId,
-        kind: "provider.turn.interrupt.failed",
-        summary: "Provider turn interrupt failed",
-        detail: "No active provider session is bound to this thread.",
-        turnId: event.payload.turnId ?? null,
-        createdAt: event.payload.createdAt,
-      });
-    }
-
-    const recoverInterruptFailure = (cause: Cause.Cause<unknown>) => {
-      if (Cause.hasInterruptsOnly(cause)) {
-        return Effect.interrupt;
-      }
-
-      const detail = formatFailureDetail(cause);
-      return Effect.gen(function* () {
-        const latestThread = yield* resolveThread(event.payload.threadId);
-        const latestSession = latestThread?.session;
-        if (
-          !latestSession ||
-          latestSession.status === "stopped" ||
-          latestSession.status === "ready" ||
-          (event.payload.turnId !== undefined &&
-            latestSession.activeTurnId !== null &&
-            latestSession.activeTurnId !== event.payload.turnId)
-        ) {
-          return;
-        }
-
-        yield* providerService.stopSession({ threadId: event.payload.threadId }).pipe(
-          Effect.catchCause((stopCause) => {
-            if (Cause.hasInterruptsOnly(stopCause)) {
-              return Effect.interrupt;
-            }
-            return Effect.logWarning(
-              "provider command reactor failed to stop session after interrupt failure",
-              {
-                threadId: event.payload.threadId,
-                cause: Cause.pretty(stopCause),
-                originalCause: Cause.pretty(cause),
-              },
-            );
-          }),
-        );
-        const stoppedThread = yield* resolveThread(event.payload.threadId);
-        const stoppedSession = stoppedThread?.session;
-        if (
-          !stoppedSession ||
-          stoppedSession.status === "stopped" ||
-          stoppedSession.status === "ready" ||
-          (event.payload.turnId !== undefined &&
-            stoppedSession.activeTurnId !== null &&
-            stoppedSession.activeTurnId !== event.payload.turnId)
-        ) {
-          return;
-        }
-
-        yield* setThreadSession({
-          threadId: event.payload.threadId,
-          session: {
-            ...stoppedSession,
-            status: "stopped",
-            activeTurnId: null,
-            lastError: detail,
-            updatedAt: event.payload.createdAt,
-          },
-          createdAt: event.payload.createdAt,
-        });
-        yield* appendProviderFailureActivity({
-          threadId: event.payload.threadId,
-          kind: "provider.turn.interrupt.failed",
-          summary: "Provider turn interrupt failed",
-          detail,
-          turnId: event.payload.turnId ?? null,
-          createdAt: event.payload.createdAt,
-        });
-      });
-    };
-
-    // Orchestration turn ids are not provider turn ids, so interrupt by session.
-    yield* providerService
-      .interruptTurn({ threadId: event.payload.threadId })
-      .pipe(Effect.catchCause(recoverInterruptFailure));
-  });
-
-  const processApprovalResponseRequested = Effect.fn("processApprovalResponseRequested")(function* (
-    event: Extract<ProviderIntentEvent, { type: "thread.approval-response-requested" }>,
-  ) {
-    const thread = yield* resolveThread(event.payload.threadId);
-    if (!thread) {
-      return;
-    }
-    const hasSession = thread.session && thread.session.status !== "stopped";
-    if (!hasSession) {
-      return yield* appendProviderFailureActivity({
-        threadId: event.payload.threadId,
-        kind: "provider.approval.respond.failed",
-        summary: "Provider approval response failed",
-        detail: "No active provider session is bound to this thread.",
-        turnId: null,
-        createdAt: event.payload.createdAt,
-        requestId: event.payload.requestId,
-      });
-    }
-
-    yield* providerService
-      .respondToRequest({
-        threadId: event.payload.threadId,
-        requestId: event.payload.requestId,
-        decision: event.payload.decision,
-      })
-      .pipe(
-        Effect.catchCause((cause) =>
-          appendProviderFailureActivity({
-            threadId: event.payload.threadId,
-            kind: "provider.approval.respond.failed",
-            summary: "Provider approval response failed",
-            detail: isUnknownPendingApprovalRequestError(cause)
-              ? stalePendingRequestDetail("approval", event.payload.requestId)
-              : Cause.pretty(cause),
-            turnId: null,
-            createdAt: event.payload.createdAt,
-            requestId: event.payload.requestId,
-          }),
-        ),
-      );
-  });
-
-  const processUserInputResponseRequested = Effect.fn("processUserInputResponseRequested")(
-    function* (
-      event: Extract<ProviderIntentEvent, { type: "thread.user-input-response-requested" }>,
-    ) {
-      const thread = yield* resolveThread(event.payload.threadId);
-      if (!thread) {
-        return;
-      }
-      const hasSession = thread.session && thread.session.status !== "stopped";
-      if (!hasSession) {
-        return yield* appendProviderFailureActivity({
-          threadId: event.payload.threadId,
-          kind: "provider.user-input.respond.failed",
-          summary: "Provider user input response failed",
-          detail: "No active provider session is bound to this thread.",
-          turnId: null,
-          createdAt: event.payload.createdAt,
-          requestId: event.payload.requestId,
-        });
-      }
-
-      yield* providerService
-        .respondToUserInput({
-          threadId: event.payload.threadId,
-          requestId: event.payload.requestId,
-          answers: event.payload.answers,
-        })
-        .pipe(
-          Effect.catchCause((cause) =>
-            appendProviderFailureActivity({
-              threadId: event.payload.threadId,
-              kind: "provider.user-input.respond.failed",
-              summary: "Provider user input response failed",
-              detail: isUnknownPendingUserInputRequestError(cause)
-                ? stalePendingRequestDetail("user-input", event.payload.requestId)
-                : Cause.pretty(cause),
-              turnId: null,
-              createdAt: event.payload.createdAt,
-              requestId: event.payload.requestId,
-            }),
-          ),
-        );
-    },
-  );
-
-  const processSessionStopRequested = Effect.fn("processSessionStopRequested")(function* (
-    event: Extract<ProviderIntentEvent, { type: "thread.session-stop-requested" }>,
-  ) {
-    const thread = yield* resolveThread(event.payload.threadId);
-    if (!thread) {
-      return;
-    }
-
-    const now = event.payload.createdAt;
-    if (thread.session && thread.session.status !== "stopped") {
-      yield* providerService.stopSession({ threadId: thread.id });
-    }
-
-    yield* setThreadSession({
-      threadId: thread.id,
-      session: {
-        threadId: thread.id,
-        status: "stopped",
-        providerName: thread.session?.providerName ?? null,
-        ...(thread.session?.providerInstanceId !== undefined
-          ? { providerInstanceId: thread.session.providerInstanceId }
-          : {}),
-        runtimeMode: thread.session?.runtimeMode ?? DEFAULT_RUNTIME_MODE,
-        activeTurnId: null,
-        lastError: thread.session?.lastError ?? null,
-        updatedAt: now,
-      },
-      createdAt: now,
-    });
-  });
-
-  const processDomainEvent = Effect.fn("processDomainEvent")(function* (
-    event: ProviderIntentEvent,
-  ) {
-    yield* Effect.annotateCurrentSpan({
-      "orchestration.event_type": event.type,
-      "orchestration.thread_id": event.payload.threadId,
-      ...(event.commandId ? { "orchestration.command_id": event.commandId } : {}),
-    });
-    yield* increment(orchestrationEventsProcessedTotal, {
-      eventType: event.type,
-    });
-    switch (event.type) {
-      case "thread.meta-updated":
-        yield* threadTitleRegenerationWorker.enqueue(event);
-        return;
-      case "thread.runtime-mode-set": {
-        const thread = yield* resolveThread(event.payload.threadId);
-        if (!thread?.session || thread.session.status === "stopped") {
-          return;
-        }
-        const cachedModelSelection = threadModelSelections.get(event.payload.threadId);
-        yield* ensureSessionForThread(
-          event.payload.threadId,
-          event.occurredAt,
-          cachedModelSelection !== undefined ? { modelSelection: cachedModelSelection } : {},
-        );
-        return;
-      }
-      case "thread.turn-start-requested":
-        yield* processTurnStartRequested(event);
-        return;
-      case "thread.turn-interrupt-requested":
-        yield* processTurnInterruptRequested(event);
-        return;
-      case "thread.approval-response-requested":
-        yield* processApprovalResponseRequested(event);
-        return;
-      case "thread.user-input-response-requested":
-        yield* processUserInputResponseRequested(event);
-        return;
-      case "thread.session-stop-requested":
-        yield* processSessionStopRequested(event);
-        return;
-    }
-  });
-
-  const processDomainEventSafely = (event: ProviderIntentEvent) =>
-    processDomainEvent(event).pipe(
-      Effect.catchCause((cause) => {
-        if (Cause.hasInterruptsOnly(cause)) {
-          return Effect.interrupt;
-        }
-        return Effect.logWarning("provider command reactor failed to process event", {
-          eventType: event.type,
-          cause: Cause.pretty(cause),
-        });
-      }),
-    );
-
-  const worker = yield* makeDrainableWorker(processDomainEventSafely);
-
-  const start: ProviderCommandReactorShape["start"] = Effect.fn("start")(function* () {
-    const interruptedTitleRegenerations = yield* findInterruptedThreadTitleRegenerations().pipe(
-      Effect.catchCause((cause) => {
-        if (Cause.hasInterruptsOnly(cause)) {
-          return Effect.interrupt;
-        }
-        return Effect.logWarning(
-          "provider command reactor failed to find interrupted title regenerations",
-          { cause: Cause.pretty(cause) },
-        ).pipe(Effect.as([]));
-      }),
-    );
-    const processEvent = Effect.fn("processEvent")(function* (event: OrchestrationEvent) {
-      if (
-        (event.type === "thread.meta-updated" && event.payload.regenerateTitle === true) ||
-        event.type === "thread.runtime-mode-set" ||
-        event.type === "thread.turn-start-requested" ||
-        event.type === "thread.turn-interrupt-requested" ||
-        event.type === "thread.approval-response-requested" ||
-        event.type === "thread.user-input-response-requested" ||
-        event.type === "thread.session-stop-requested"
-      ) {
-        return yield* worker.enqueue(event);
-      }
-    });
-
-    yield* forkParked(Stream.runForEach(orchestrationEngine.streamDomainEvents, processEvent));
-
-    // The domain event stream is hot, so work pending before this reactor
-    // starts cannot be resumed. Correlated completions only clear the request
-    // captured here, leaving any newer request untouched.
-    const clearInterrupted = clearInterruptedThreadTitleRegenerations(
-      interruptedTitleRegenerations,
-    ).pipe(
-      Effect.catchCause((cause) => {
-        if (Cause.hasInterruptsOnly(cause)) {
-          return Effect.interrupt;
-        }
-        return Effect.logWarning(
-          "provider command reactor failed to clear interrupted title regenerations",
-          {
-            cause: Cause.pretty(cause),
-          },
-        );
-      }),
-    );
-    const activation = yield* ServerActivation;
-    if (activation === undefined) {
-      yield* clearInterrupted;
-    } else {
-      yield* forkParked(clearInterrupted);
-    }
-  });
-
-  return {
-    start,
-    drain: Effect.gen(function* () {
-      yield* worker.drain;
-      yield* threadTitleRegenerationWorker.drain;
-    }),
-  } satisfies ProviderCommandReactorShape;
-});
-
-export const ProviderCommandReactorLive = Layer.effect(ProviderCommandReactor, make);
diff --git a/apps/server/src/orchestration/Layers/ProviderRuntimeIngestion.activity.test.ts b/apps/server/src/orchestration/Layers/ProviderRuntimeIngestion.activity.test.ts
deleted file mode 100644
index 27564eb572ca..000000000000
--- a/apps/server/src/orchestration/Layers/ProviderRuntimeIngestion.activity.test.ts
+++ /dev/null
@@ -1,144 +0,0 @@
-import {
-  EventId,
-  ProviderDriverKind,
-  RuntimeTaskId,
-  ThreadId,
-  type ProviderRuntimeEvent,
-} from "@t3tools/contracts";
-import { describe, expect, it } from "vite-plus/test";
-
-import { runtimeEventToActivities } from "./ProviderRuntimeIngestion.ts";
-
-const base = {
-  provider: ProviderDriverKind.make("codex"),
-  createdAt: "2026-08-06T00:00:00.000Z",
-  threadId: ThreadId.make("thread-1"),
-};
-
-describe("runtimeEventToActivities task progress", () => {
-  it("persists usage independently from replaceable activity", () => {
-    const taskId = RuntimeTaskId.make("agent-1");
-    const usageOnly = {
-      ...base,
-      type: "task.progress",
-      eventId: EventId.make("evt-usage"),
-      payload: {
-        taskId,
-        description: "Agent one",
-        typedUsage: { totalTokens: 73_700_000 },
-      },
-    } satisfies ProviderRuntimeEvent;
-    const command = {
-      ...base,
-      type: "task.progress",
-      eventId: EventId.make("evt-command"),
-      payload: {
-        taskId,
-        description: "Agent one",
-        summary: "Running tests",
-        lastToolName: "exec_command",
-      },
-    } satisfies ProviderRuntimeEvent;
-
-    const usageActivities = runtimeEventToActivities(usageOnly);
-    const commandActivities = runtimeEventToActivities(command);
-
-    expect(usageActivities.map((activity) => activity.id)).toEqual(["task-usage:thread-1:agent-1"]);
-    expect(commandActivities.map((activity) => activity.id)).toEqual([
-      "task-progress:thread-1:agent-1",
-    ]);
-    const usagePayload = usageActivities[0]?.payload as Record<string, unknown> | undefined;
-    expect(usagePayload?.typedUsage).toEqual({ totalTokens: 73_700_000 });
-    expect(usagePayload?.usageSnapshot).toBe(true);
-  });
-
-  it("splits combined progress and usage into their independent snapshots", () => {
-    const event = {
-      ...base,
-      type: "task.progress",
-      eventId: EventId.make("evt-combined"),
-      payload: {
-        taskId: RuntimeTaskId.make("agent-2"),
-        description: "Agent two",
-        summary: "Inspecting the panel",
-        typedUsage: { totalTokens: 4_200, toolUses: 7 },
-        status: "running",
-      },
-    } satisfies ProviderRuntimeEvent;
-
-    const activities = runtimeEventToActivities(event);
-    const progressPayload = activities[0]?.payload as Record<string, unknown>;
-    const usagePayload = activities[1]?.payload as Record<string, unknown>;
-
-    expect(activities.map((activity) => activity.id)).toEqual([
-      "task-progress:thread-1:agent-2",
-      "task-usage:thread-1:agent-2",
-    ]);
-    expect(progressPayload.summary).toBe("Inspecting the panel");
-    expect(progressPayload.status).toBe("running");
-    expect(progressPayload).not.toHaveProperty("typedUsage");
-    expect(usagePayload.typedUsage).toEqual({ totalTokens: 4_200, toolUses: 7 });
-    expect(usagePayload.usageSnapshot).toBe(true);
-    expect(usagePayload).not.toHaveProperty("status");
-  });
-});
-describe("runtimeEventToActivities tool streaming persistence", () => {
-  const accumulatedStdout = [
-    "first line of output",
-    ...Array.from({ length: 500 }, (_, index) => `Capturing frame ${index}/9028`),
-  ].join("\n");
-  const streamingData = {
-    toolCallId: "tool-call-1",
-    kind: "execute",
-    command: "blender --render",
-    rawOutput: { stdout: accumulatedStdout },
-    content: [{ type: "content", content: { type: "text", text: accumulatedStdout } }],
-  };
-
-  it("persists tool.updated with the wire projection of data, not the accumulated stream", () => {
-    const event = {
-      ...base,
-      type: "item.updated",
-      eventId: EventId.make("evt-tool-streaming-updated"),
-      payload: {
-        itemType: "command_execution",
-        status: "inProgress",
-        title: "Render",
-        detail: accumulatedStdout,
-        data: streamingData,
-      },
-    } satisfies ProviderRuntimeEvent;
-
-    const activities = runtimeEventToActivities(event);
-
-    expect(activities).toHaveLength(1);
-    const payload = activities[0]?.payload as Record<string, unknown>;
-    const data = payload.data as Record<string, unknown>;
-    expect(payload.status).toBe("inProgress");
-    expect(data.toolCallId).toBe("tool-call-1");
-    expect(data.command).toBe("blender --render");
-    expect(data.rawOutput).toEqual({ content: "first line of output" });
-    expect(data.content).toBeUndefined();
-    expect(JSON.stringify(data).length).toBeLessThan(1_000);
-  });
-
-  it("persists the full terminal payload on tool.completed", () => {
-    const event = {
-      ...base,
-      type: "item.completed",
-      eventId: EventId.make("evt-tool-streaming-completed"),
-      payload: {
-        itemType: "command_execution",
-        status: "completed",
-        title: "Render",
-        data: streamingData,
-      },
-    } satisfies ProviderRuntimeEvent;
-
-    const activities = runtimeEventToActivities(event);
-
-    expect(activities).toHaveLength(1);
-    const payload = activities[0]?.payload as Record<string, unknown>;
-    expect(payload.data).toEqual(streamingData);
-  });
-});
diff --git a/apps/server/src/orchestration/Layers/ProviderRuntimeIngestion.approval.test.ts b/apps/server/src/orchestration/Layers/ProviderRuntimeIngestion.approval.test.ts
deleted file mode 100644
index 0d262028dedf..000000000000
--- a/apps/server/src/orchestration/Layers/ProviderRuntimeIngestion.approval.test.ts
+++ /dev/null
@@ -1,70 +0,0 @@
-import {
-  EventId,
-  ProviderDriverKind,
-  RuntimeRequestId,
-  ThreadId,
-  type ProviderRuntimeEvent,
-} from "@t3tools/contracts";
-import { describe, expect, it } from "vite-plus/test";
-
-import { runtimeEventToActivities } from "./ProviderRuntimeIngestion.ts";
-
-describe("runtimeEventToActivities approval details", () => {
-  it("preserves complete multiline command details", () => {
-    const detail = `bun run release -- ${"long-argument ".repeat(20)}\nsecond line`;
-    const event = {
-      type: "request.opened",
-      eventId: EventId.make("evt-request-opened"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: "2026-07-18T00:00:00.000Z",
-      threadId: ThreadId.make("thread-1"),
-      requestId: RuntimeRequestId.make("approval-1"),
-      payload: {
-        requestType: "command_execution_approval",
-        detail,
-      },
-    } satisfies ProviderRuntimeEvent;
-
-    const [activity] = runtimeEventToActivities(event);
-
-    expect(activity?.kind).toBe("approval.requested");
-    expect((activity?.payload as Record<string, unknown> | undefined)?.detail).toBe(detail);
-  });
-
-  it("keeps app details and approval options available to remote clients", () => {
-    const options = [
-      { decision: "decline", label: "Decline" },
-      { decision: "acceptAlways", label: "Always allow Safari" },
-      { decision: "accept", label: "Approve" },
-    ] as const;
-    const event = {
-      type: "request.opened",
-      eventId: EventId.make("evt-mcp-elicitation"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: "2026-08-24T00:00:00.000Z",
-      threadId: ThreadId.make("thread-1"),
-      requestId: RuntimeRequestId.make("approval-safari"),
-      payload: {
-        requestType: "mcp_elicitation_approval",
-        detail: "Allow ChatGPT to use Safari?",
-        appName: "Safari",
-        options,
-      },
-    } satisfies ProviderRuntimeEvent;
-
-    const [activity] = runtimeEventToActivities(event);
-
-    expect(activity).toMatchObject({
-      kind: "approval.requested",
-      summary: "App access approval requested",
-      payload: {
-        requestId: "approval-safari",
-        requestKind: "mcp-elicitation",
-        requestType: "mcp_elicitation_approval",
-        detail: "Allow ChatGPT to use Safari?",
-        appName: "Safari",
-        options,
-      },
-    });
-  });
-});
diff --git a/apps/server/src/orchestration/Layers/ProviderRuntimeIngestion.test.ts b/apps/server/src/orchestration/Layers/ProviderRuntimeIngestion.test.ts
deleted file mode 100644
index 84858b6affe9..000000000000
--- a/apps/server/src/orchestration/Layers/ProviderRuntimeIngestion.test.ts
+++ /dev/null
@@ -1,3627 +0,0 @@
-// @effect-diagnostics nodeBuiltinImport:off
-import * as NodeFS from "node:fs";
-import * as NodeOS from "node:os";
-import * as NodePath from "node:path";
-
-import {
-  OrchestrationReadModel,
-  ProviderDriverKind,
-  ProviderRuntimeEvent,
-  ProviderSession,
-  ProviderInstanceId,
-} from "@t3tools/contracts";
-import {
-  ApprovalRequestId,
-  CommandId,
-  DEFAULT_PROVIDER_INTERACTION_MODE,
-  EventId,
-  MessageId,
-  type OrchestrationCommand,
-  ProjectId,
-  ProviderItemId,
-  type ServerSettings,
-  ThreadId,
-  TurnId,
-} from "@t3tools/contracts";
-import * as Clock from "effect/Clock";
-import * as Effect from "effect/Effect";
-import * as Exit from "effect/Exit";
-import * as Layer from "effect/Layer";
-import * as ManagedRuntime from "effect/ManagedRuntime";
-import * as PubSub from "effect/PubSub";
-import * as Scope from "effect/Scope";
-import * as Stream from "effect/Stream";
-import { it as effectIt } from "@effect/vitest";
-import { afterEach, describe, expect, it } from "vite-plus/test";
-
-import { OrchestrationEventStoreLive } from "../../persistence/Layers/OrchestrationEventStore.ts";
-import { OrchestrationCommandReceiptRepositoryLive } from "../../persistence/Layers/OrchestrationCommandReceipts.ts";
-import { SqlitePersistenceMemory } from "../../persistence/Layers/Sqlite.ts";
-import {
-  ProviderService,
-  type ProviderServiceShape,
-} from "../../provider/Services/ProviderService.ts";
-import * as RepositoryIdentityResolver from "../../project/RepositoryIdentityResolver.ts";
-import { OrchestrationEngineLive } from "./OrchestrationEngine.ts";
-import { OrchestrationProjectionPipelineLive } from "./ProjectionPipeline.ts";
-import { OrchestrationProjectionSnapshotQueryLive } from "./ProjectionSnapshotQuery.ts";
-import * as ThreadBackgroundLiveness from "../ThreadBackgroundLiveness.ts";
-import * as ThreadPlanProgress from "../ThreadPlanProgress.ts";
-import { ProviderRuntimeIngestionLive } from "./ProviderRuntimeIngestion.ts";
-import { DEFAULT_THREAD_TITLE } from "../threadTitles.ts";
-import { OrchestrationEngineService } from "../Services/OrchestrationEngine.ts";
-import { ProviderRuntimeIngestionService } from "../Services/ProviderRuntimeIngestion.ts";
-import { ProjectionSnapshotQuery } from "../Services/ProjectionSnapshotQuery.ts";
-import { ServerConfig } from "../../config.ts";
-import { ServerSettingsService } from "../../serverSettings.ts";
-import * as NodeServices from "@effect/platform-node/NodeServices";
-
-function makeTestServerSettingsLayer(overrides: Partial<ServerSettings> = {}) {
-  return ServerSettingsService.layerTest(overrides);
-}
-
-const asProjectId = (value: string): ProjectId => ProjectId.make(value);
-const asItemId = (value: string): ProviderItemId => ProviderItemId.make(value);
-const asEventId = (value: string): EventId => EventId.make(value);
-const asMessageId = (value: string): MessageId => MessageId.make(value);
-const asThreadId = (value: string): ThreadId => ThreadId.make(value);
-const asTurnId = (value: string): TurnId => TurnId.make(value);
-
-type LegacyProviderRuntimeEvent = {
-  readonly type: string;
-  readonly eventId: EventId;
-  readonly provider: ProviderRuntimeEvent["provider"];
-  readonly createdAt: string;
-  readonly threadId: ThreadId;
-  readonly turnId?: string | undefined;
-  readonly itemId?: string | undefined;
-  readonly requestId?: string | undefined;
-  readonly payload?: unknown | undefined;
-  readonly [key: string]: unknown;
-};
-
-type LegacyTurnCompletedEvent = LegacyProviderRuntimeEvent & {
-  readonly type: "turn.completed";
-  readonly payload?: undefined;
-  readonly status: "completed" | "failed" | "interrupted" | "cancelled";
-  readonly errorMessage?: string | undefined;
-};
-
-function isLegacyTurnCompletedEvent(
-  event: LegacyProviderRuntimeEvent,
-): event is LegacyTurnCompletedEvent {
-  return (
-    event.type === "turn.completed" &&
-    event.payload === undefined &&
-    typeof event.status === "string"
-  );
-}
-
-function createProviderServiceHarness() {
-  const runtimeEventPubSub = Effect.runSync(PubSub.unbounded<ProviderRuntimeEvent>());
-  const runtimeSessions: ProviderSession[] = [];
-
-  const unsupported = () => Effect.die(new Error("Unsupported provider call in test")) as never;
-  const service: ProviderServiceShape = {
-    startSession: () => unsupported(),
-    sendTurn: () => unsupported(),
-    interruptTurn: () => unsupported(),
-    respondToRequest: () => unsupported(),
-    respondToUserInput: () => unsupported(),
-    stopSession: () => unsupported(),
-    listSessions: () => Effect.succeed([...runtimeSessions]),
-    getCapabilities: () => Effect.succeed({ sessionModelSwitch: "in-session" }),
-    getInstanceInfo: (instanceId) => {
-      const driverKind = ProviderDriverKind.make(String(instanceId));
-      return Effect.succeed({
-        instanceId,
-        driverKind,
-        displayName: undefined,
-        enabled: true,
-        continuationIdentity: {
-          driverKind,
-          continuationKey: `${driverKind}:instance:${instanceId}`,
-        },
-      });
-    },
-    rollbackConversation: () => unsupported(),
-    uploadFeedback: () => unsupported(),
-    get streamEvents() {
-      return Stream.fromPubSub(runtimeEventPubSub);
-    },
-  };
-
-  const setSession = (session: ProviderSession): void => {
-    const existingIndex = runtimeSessions.findIndex((entry) => entry.threadId === session.threadId);
-    if (existingIndex >= 0) {
-      runtimeSessions[existingIndex] = session;
-      return;
-    }
-    runtimeSessions.push(session);
-  };
-
-  const normalizeLegacyEvent = (event: LegacyProviderRuntimeEvent): ProviderRuntimeEvent => {
-    if (isLegacyTurnCompletedEvent(event)) {
-      const normalized: Extract<ProviderRuntimeEvent, { type: "turn.completed" }> = {
-        ...(event as Omit<Extract<ProviderRuntimeEvent, { type: "turn.completed" }>, "payload">),
-        payload: {
-          state: event.status,
-          ...(typeof event.errorMessage === "string" ? { errorMessage: event.errorMessage } : {}),
-        },
-      };
-      return normalized;
-    }
-
-    return event as ProviderRuntimeEvent;
-  };
-
-  const emit = (event: LegacyProviderRuntimeEvent): void => {
-    Effect.runSync(PubSub.publish(runtimeEventPubSub, normalizeLegacyEvent(event)));
-  };
-
-  return {
-    service,
-    emit,
-    setSession,
-  };
-}
-
-type ProviderRuntimeTestReadModel = OrchestrationReadModel;
-type ProviderRuntimeTestThread = ProviderRuntimeTestReadModel["threads"][number];
-type ProviderRuntimeTestMessage = ProviderRuntimeTestThread["messages"][number];
-type ProviderRuntimeTestProposedPlan = ProviderRuntimeTestThread["proposedPlans"][number];
-type ProviderRuntimeTestActivity = ProviderRuntimeTestThread["activities"][number];
-type ProviderRuntimeTestCheckpoint = ProviderRuntimeTestThread["checkpoints"][number];
-
-async function waitForThread(
-  readModel: () => Promise<ProviderRuntimeTestReadModel>,
-  predicate: (thread: ProviderRuntimeTestThread) => boolean,
-  timeoutMs = 2000,
-  threadId: ThreadId = asThreadId("thread-1"),
-) {
-  const deadline = (await Effect.runPromise(Clock.currentTimeMillis)) + timeoutMs;
-  const poll = async (): Promise<ProviderRuntimeTestThread> => {
-    const snapshot = await readModel();
-    const thread = snapshot.threads.find((entry) => entry.id === threadId);
-    if (thread && predicate(thread)) {
-      return thread;
-    }
-    if ((await Effect.runPromise(Clock.currentTimeMillis)) >= deadline) {
-      throw new Error("Timed out waiting for thread state");
-    }
-    await Effect.runPromise(Effect.yieldNow);
-    return poll();
-  };
-  return poll();
-}
-
-describe("ProviderRuntimeIngestion", () => {
-  let runtime: ManagedRuntime.ManagedRuntime<
-    OrchestrationEngineService | ProviderRuntimeIngestionService | ProjectionSnapshotQuery,
-    unknown
-  > | null = null;
-  let scope: Scope.Closeable | null = null;
-  const tempDirs: string[] = [];
-
-  function makeTempDir(prefix: string): string {
-    const dir = NodeFS.mkdtempSync(NodePath.join(NodeOS.tmpdir(), prefix));
-    tempDirs.push(dir);
-    return dir;
-  }
-
-  afterEach(async () => {
-    if (scope) {
-      await Effect.runPromise(Scope.close(scope, Exit.void));
-    }
-    scope = null;
-    if (runtime) {
-      await runtime.dispose();
-    }
-    runtime = null;
-    for (const dir of tempDirs.splice(0)) {
-      NodeFS.rmSync(dir, { recursive: true, force: true });
-    }
-  });
-
-  async function createHarness(options?: {
-    serverSettings?: Partial<ServerSettings>;
-    threadTitle?: string;
-  }) {
-    const workspaceRoot = makeTempDir("t3-provider-project-");
-    NodeFS.mkdirSync(NodePath.join(workspaceRoot, ".git"));
-    const provider = createProviderServiceHarness();
-    const orchestrationLayer = OrchestrationEngineLive.pipe(
-      Layer.provide(OrchestrationProjectionSnapshotQueryLive),
-      Layer.provide(OrchestrationProjectionPipelineLive),
-      Layer.provide(OrchestrationEventStoreLive),
-      Layer.provide(OrchestrationCommandReceiptRepositoryLive),
-      Layer.provide(RepositoryIdentityResolver.layer),
-      Layer.provide(SqlitePersistenceMemory),
-    );
-    const projectionSnapshotLayer = OrchestrationProjectionSnapshotQueryLive.pipe(
-      Layer.provide(RepositoryIdentityResolver.layer),
-      Layer.provide(SqlitePersistenceMemory),
-    );
-    const layer = ProviderRuntimeIngestionLive.pipe(
-      Layer.provideMerge(orchestrationLayer),
-      Layer.provideMerge(projectionSnapshotLayer),
-      // Single shared liveness instance across ingestion (writer), the
-      // engine, and the snapshot query (reader).
-      Layer.provideMerge(ThreadBackgroundLiveness.layer),
-      Layer.provideMerge(ThreadPlanProgress.layer),
-      Layer.provideMerge(SqlitePersistenceMemory),
-      Layer.provideMerge(Layer.succeed(ProviderService, provider.service)),
-      Layer.provideMerge(makeTestServerSettingsLayer(options?.serverSettings)),
-      Layer.provideMerge(ServerConfig.layerTest(process.cwd(), process.cwd())),
-      Layer.provideMerge(NodeServices.layer),
-    );
-    runtime = ManagedRuntime.make(layer);
-    const engine = await runtime.runPromise(Effect.service(OrchestrationEngineService));
-    const snapshotQuery = await runtime.runPromise(Effect.service(ProjectionSnapshotQuery));
-    const ingestion = await runtime.runPromise(Effect.service(ProviderRuntimeIngestionService));
-    scope = await Effect.runPromise(Scope.make("sequential"));
-    await Effect.runPromise(ingestion.start().pipe(Scope.provide(scope)));
-    const drain = () => Effect.runPromise(ingestion.drain);
-    const dispatch = (command: OrchestrationCommand) => Effect.runPromise(engine.dispatch(command));
-
-    const createdAt = "2026-01-01T00:00:00.000Z";
-    await dispatch({
-      type: "project.create",
-      commandId: CommandId.make("cmd-provider-project-create"),
-      projectId: asProjectId("project-1"),
-      title: "Provider Project",
-      workspaceRoot,
-      defaultModelSelection: {
-        instanceId: ProviderInstanceId.make("codex"),
-        model: "gpt-5-codex",
-      },
-      createdAt,
-    });
-    await dispatch({
-      type: "thread.create",
-      commandId: CommandId.make("cmd-thread-create"),
-      threadId: ThreadId.make("thread-1"),
-      projectId: asProjectId("project-1"),
-      title: options?.threadTitle ?? "Thread",
-      modelSelection: {
-        instanceId: ProviderInstanceId.make("codex"),
-        model: "gpt-5-codex",
-      },
-      interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-      runtimeMode: "approval-required",
-      branch: null,
-      worktreePath: null,
-      createdAt,
-    });
-    await dispatch({
-      type: "thread.session.set",
-      commandId: CommandId.make("cmd-session-seed"),
-      threadId: ThreadId.make("thread-1"),
-      session: {
-        threadId: ThreadId.make("thread-1"),
-        status: "ready",
-        providerName: "codex",
-        runtimeMode: "approval-required",
-        activeTurnId: null,
-        updatedAt: createdAt,
-        lastError: null,
-      },
-      createdAt,
-    });
-    provider.setSession({
-      provider: ProviderDriverKind.make("codex"),
-      status: "ready",
-      runtimeMode: "approval-required",
-      threadId: ThreadId.make("thread-1"),
-      createdAt,
-      updatedAt: createdAt,
-    });
-
-    return {
-      engine,
-      dispatch,
-      readModel: () => Effect.runPromise(snapshotQuery.getSnapshot()),
-      emit: provider.emit,
-      setProviderSession: provider.setSession,
-      drain,
-    };
-  }
-
-  it("maps turn started/completed events into thread session updates", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    harness.emit({
-      type: "turn.started",
-      eventId: asEventId("evt-turn-started"),
-      provider: ProviderDriverKind.make("codex"),
-      threadId: asThreadId("thread-1"),
-      createdAt: now,
-      turnId: asTurnId("turn-1"),
-    });
-
-    await waitForThread(
-      harness.readModel,
-      (thread) => thread.session?.status === "running" && thread.session?.activeTurnId === "turn-1",
-    );
-
-    harness.emit({
-      type: "turn.completed",
-      eventId: asEventId("evt-turn-completed"),
-      provider: ProviderDriverKind.make("codex"),
-      threadId: asThreadId("thread-1"),
-      createdAt: "2026-01-01T00:00:00.000Z",
-      turnId: asTurnId("turn-1"),
-      payload: {
-        state: "failed",
-        errorMessage: "turn failed",
-      },
-    });
-
-    const thread = await waitForThread(
-      harness.readModel,
-      (entry) =>
-        entry.session?.status === "error" &&
-        entry.session?.activeTurnId === null &&
-        entry.session?.lastError === "turn failed",
-    );
-    expect(thread.session?.status).toBe("error");
-    expect(thread.session?.lastError).toBe("turn failed");
-  });
-
-  it("applies provider session.state.changed transitions directly", async () => {
-    const harness = await createHarness();
-    const waitingAt = "2026-01-01T00:00:00.000Z";
-
-    harness.emit({
-      type: "session.state.changed",
-      eventId: asEventId("evt-session-state-waiting"),
-      provider: ProviderDriverKind.make("codex"),
-      threadId: asThreadId("thread-1"),
-      createdAt: waitingAt,
-      payload: {
-        state: "waiting",
-        reason: "awaiting approval",
-      },
-    });
-
-    let thread = await waitForThread(
-      harness.readModel,
-      (entry) => entry.session?.status === "running" && entry.session?.activeTurnId === null,
-    );
-    expect(thread.session?.status).toBe("running");
-    expect(thread.session?.lastError).toBeNull();
-
-    harness.emit({
-      type: "session.state.changed",
-      eventId: asEventId("evt-session-state-error"),
-      provider: ProviderDriverKind.make("codex"),
-      threadId: asThreadId("thread-1"),
-      createdAt: "2026-01-01T00:00:00.000Z",
-      payload: {
-        state: "error",
-        reason: "provider crashed",
-      },
-    });
-
-    thread = await waitForThread(
-      harness.readModel,
-      (entry) =>
-        entry.session?.status === "error" &&
-        entry.session?.activeTurnId === null &&
-        entry.session?.lastError === "provider crashed",
-    );
-    expect(thread.session?.status).toBe("error");
-    expect(thread.session?.lastError).toBe("provider crashed");
-
-    harness.emit({
-      type: "session.state.changed",
-      eventId: asEventId("evt-session-state-stopped"),
-      provider: ProviderDriverKind.make("codex"),
-      threadId: asThreadId("thread-1"),
-      createdAt: "2026-01-01T00:00:00.000Z",
-      payload: {
-        state: "stopped",
-      },
-    });
-
-    thread = await waitForThread(
-      harness.readModel,
-      (entry) =>
-        entry.session?.status === "stopped" &&
-        entry.session?.activeTurnId === null &&
-        entry.session?.lastError === "provider crashed",
-    );
-    expect(thread.session?.status).toBe("stopped");
-    expect(thread.session?.lastError).toBe("provider crashed");
-
-    harness.emit({
-      type: "session.state.changed",
-      eventId: asEventId("evt-session-state-ready"),
-      provider: ProviderDriverKind.make("codex"),
-      threadId: asThreadId("thread-1"),
-      createdAt: "2026-01-01T00:00:00.000Z",
-      payload: {
-        state: "ready",
-      },
-    });
-
-    thread = await waitForThread(
-      harness.readModel,
-      (entry) =>
-        entry.session?.status === "ready" &&
-        entry.session?.activeTurnId === null &&
-        entry.session?.lastError === null,
-    );
-    expect(thread.session?.status).toBe("ready");
-    expect(thread.session?.lastError).toBeNull();
-  });
-
-  it("clears active turn when provider session becomes ready", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    harness.emit({
-      type: "turn.started",
-      eventId: asEventId("evt-turn-started-session-ready"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-session-ready"),
-    });
-
-    await waitForThread(
-      harness.readModel,
-      (thread) =>
-        thread.session?.status === "running" &&
-        thread.session?.activeTurnId === "turn-session-ready",
-      10_000,
-    );
-
-    harness.emit({
-      type: "session.state.changed",
-      eventId: asEventId("evt-session-state-ready-with-active-turn"),
-      provider: ProviderDriverKind.make("codex"),
-      threadId: asThreadId("thread-1"),
-      createdAt: "2026-01-01T00:00:01.000Z",
-      payload: {
-        state: "ready",
-      },
-    });
-
-    const thread = await waitForThread(
-      harness.readModel,
-      (entry) =>
-        entry.session?.status === "ready" &&
-        entry.session?.activeTurnId === null &&
-        entry.session?.lastError === null,
-      10_000,
-    );
-    expect(thread.session?.status).toBe("ready");
-    expect(thread.session?.activeTurnId).toBeNull();
-    expect(thread.session?.lastError).toBeNull();
-  });
-
-  effectIt.effect(
-    "keeps a reconnecting pending turn starting while ready clears stale active state",
-    () =>
-      Effect.gen(function* () {
-        const harness = yield* Effect.promise(() => createHarness());
-        const threadId = asThreadId("thread-1");
-        const staleTurnId = asTurnId("turn-stale-before-reconnect");
-
-        yield* harness.engine.dispatch({
-          type: "thread.turn.start",
-          commandId: CommandId.make("cmd-turn-start-pending-reconnect"),
-          threadId,
-          message: {
-            messageId: MessageId.make("message-pending-reconnect"),
-            role: "user",
-            text: "resume after reconnect",
-            attachments: [],
-          },
-          interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-          runtimeMode: "approval-required",
-          createdAt: "2026-01-01T00:00:01.000Z",
-        });
-        yield* harness.engine.dispatch({
-          type: "thread.session.set",
-          commandId: CommandId.make("cmd-session-starting-pending-reconnect"),
-          threadId,
-          session: {
-            threadId,
-            status: "starting",
-            providerName: "codex",
-            runtimeMode: "approval-required",
-            activeTurnId: staleTurnId,
-            lastError: null,
-            updatedAt: "2026-01-01T00:00:01.000Z",
-          },
-          createdAt: "2026-01-01T00:00:01.000Z",
-        });
-
-        harness.emit({
-          type: "session.state.changed",
-          eventId: asEventId("evt-session-ready-pending-reconnect"),
-          provider: ProviderDriverKind.make("codex"),
-          threadId,
-          createdAt: "2026-01-01T00:00:02.000Z",
-          payload: { state: "ready" },
-        });
-
-        let thread = yield* Effect.promise(() =>
-          waitForThread(
-            harness.readModel,
-            (entry) => entry.session?.status === "starting" && entry.session.activeTurnId === null,
-          ),
-        );
-        expect(thread.session?.status).toBe("starting");
-        expect(thread.session?.activeTurnId).toBeNull();
-
-        harness.emit({
-          type: "session.started",
-          eventId: asEventId("evt-session-started-pending-reconnect"),
-          provider: ProviderDriverKind.make("codex"),
-          threadId,
-          createdAt: "2026-01-01T00:00:03.000Z",
-        });
-        yield* Effect.promise(() => harness.drain());
-        thread = (yield* Effect.promise(() => harness.readModel())).threads.find(
-          (entry) => entry.id === threadId,
-        )!;
-        expect(thread.session?.status).toBe("starting");
-        expect(thread.session?.activeTurnId).toBeNull();
-
-        harness.emit({
-          type: "turn.started",
-          eventId: asEventId("evt-turn-started-pending-reconnect"),
-          provider: ProviderDriverKind.make("codex"),
-          threadId,
-          turnId: asTurnId("turn-after-reconnect"),
-          createdAt: "2026-01-01T00:00:04.000Z",
-        });
-        thread = yield* Effect.promise(() =>
-          waitForThread(
-            harness.readModel,
-            (entry) =>
-              entry.session?.status === "running" &&
-              entry.session.activeTurnId === asTurnId("turn-after-reconnect"),
-          ),
-        );
-        expect(thread.session?.status).toBe("running");
-
-        harness.emit({
-          type: "session.started",
-          eventId: asEventId("evt-session-started-duplicate-midturn"),
-          provider: ProviderDriverKind.make("codex"),
-          threadId,
-          createdAt: "2026-01-01T00:00:05.000Z",
-        });
-        yield* Effect.promise(() => harness.drain());
-        thread = (yield* Effect.promise(() => harness.readModel())).threads.find(
-          (entry) => entry.id === threadId,
-        )!;
-        expect(thread.session?.status).toBe("running");
-        expect(thread.session?.activeTurnId).toBe(asTurnId("turn-after-reconnect"));
-      }),
-  );
-
-  effectIt.effect("keeps an aborted pending start stopped across duplicate exit events", () =>
-    Effect.gen(function* () {
-      const harness = yield* Effect.promise(() => createHarness());
-      const threadId = asThreadId("thread-1");
-      const stoppedAt = "2026-01-01T00:00:02.000Z";
-
-      yield* harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-before-stop"),
-        threadId,
-        message: {
-          messageId: MessageId.make("message-before-stop"),
-          role: "user",
-          text: "stop this startup",
-          attachments: [],
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: "2026-01-01T00:00:01.000Z",
-      });
-      yield* harness.engine.dispatch({
-        type: "thread.session.set",
-        commandId: CommandId.make("cmd-session-starting-before-stop"),
-        threadId,
-        session: {
-          threadId,
-          status: "starting",
-          providerName: "codex",
-          runtimeMode: "approval-required",
-          activeTurnId: null,
-          lastError: null,
-          updatedAt: "2026-01-01T00:00:01.000Z",
-        },
-        createdAt: "2026-01-01T00:00:01.000Z",
-      });
-      yield* harness.engine.dispatch({
-        type: "thread.session.set",
-        commandId: CommandId.make("cmd-session-stop-pending-start"),
-        threadId,
-        session: {
-          threadId,
-          status: "stopped",
-          providerName: "codex",
-          runtimeMode: "approval-required",
-          activeTurnId: null,
-          lastError: null,
-          updatedAt: stoppedAt,
-        },
-        createdAt: stoppedAt,
-      });
-
-      harness.emit({
-        type: "session.exited",
-        eventId: asEventId("evt-session-exited-after-stop"),
-        provider: ProviderDriverKind.make("codex"),
-        threadId,
-        createdAt: "2026-01-01T00:00:03.000Z",
-      });
-      harness.emit({
-        type: "session.exited",
-        eventId: asEventId("evt-duplicate-session-exited-after-stop"),
-        provider: ProviderDriverKind.make("codex"),
-        threadId,
-        createdAt: "2026-01-01T00:00:04.000Z",
-      });
-
-      yield* Effect.promise(() => harness.drain());
-      const thread = (yield* Effect.promise(() => harness.readModel())).threads.find(
-        (entry) => entry.id === threadId,
-      );
-      expect(thread?.session?.status).toBe("stopped");
-      expect(thread?.session?.activeTurnId).toBeNull();
-    }),
-  );
-
-  it("does not clear active turn when session/thread started arrives mid-turn", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    harness.emit({
-      type: "turn.started",
-      eventId: asEventId("evt-turn-started-midturn-lifecycle"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-midturn-lifecycle"),
-    });
-
-    await waitForThread(
-      harness.readModel,
-      (thread) =>
-        thread.session?.status === "running" &&
-        thread.session?.activeTurnId === "turn-midturn-lifecycle",
-      10_000,
-    );
-
-    harness.emit({
-      type: "thread.started",
-      eventId: asEventId("evt-thread-started-midturn-lifecycle"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: "2026-01-01T00:00:00.000Z",
-      threadId: asThreadId("thread-1"),
-    });
-    harness.emit({
-      type: "session.started",
-      eventId: asEventId("evt-session-started-midturn-lifecycle"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: "2026-01-01T00:00:00.000Z",
-      threadId: asThreadId("thread-1"),
-    });
-
-    await harness.drain();
-    const midReadModel = await harness.readModel();
-    const midThread = midReadModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    expect(midThread?.session?.status).toBe("running");
-    expect(midThread?.session?.activeTurnId).toBe("turn-midturn-lifecycle");
-
-    harness.emit({
-      type: "turn.completed",
-      eventId: asEventId("evt-turn-completed-midturn-lifecycle"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: "2026-01-01T00:00:00.000Z",
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-midturn-lifecycle"),
-      status: "completed",
-    });
-
-    await waitForThread(
-      harness.readModel,
-      (thread) => thread.session?.status === "ready" && thread.session?.activeTurnId === null,
-      10_000,
-    );
-  });
-
-  it("accepts claude turn lifecycle when seeded thread id is a synthetic placeholder", async () => {
-    const harness = await createHarness();
-    const seededAt = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.session.set",
-        commandId: CommandId.make("cmd-session-seed-claude-placeholder"),
-        threadId: ThreadId.make("thread-1"),
-        session: {
-          threadId: ThreadId.make("thread-1"),
-          status: "ready",
-          providerName: "claudeAgent",
-          runtimeMode: "approval-required",
-          activeTurnId: null,
-          updatedAt: seededAt,
-          lastError: null,
-        },
-        createdAt: seededAt,
-      }),
-    );
-
-    harness.emit({
-      type: "turn.started",
-      eventId: asEventId("evt-turn-started-claude-placeholder"),
-      provider: ProviderDriverKind.make("claudeAgent"),
-      createdAt: "2026-01-01T00:00:00.000Z",
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-claude-placeholder"),
-    });
-
-    await waitForThread(
-      harness.readModel,
-      (thread) =>
-        thread.session?.status === "running" &&
-        thread.session?.activeTurnId === "turn-claude-placeholder",
-    );
-
-    harness.emit({
-      type: "turn.completed",
-      eventId: asEventId("evt-turn-completed-claude-placeholder"),
-      provider: ProviderDriverKind.make("claudeAgent"),
-      createdAt: "2026-01-01T00:00:00.000Z",
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-claude-placeholder"),
-      status: "completed",
-    });
-
-    await waitForThread(
-      harness.readModel,
-      (thread) => thread.session?.status === "ready" && thread.session?.activeTurnId === null,
-    );
-  });
-
-  it("ignores auxiliary turn completions from a different provider thread", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    harness.emit({
-      type: "turn.started",
-      eventId: asEventId("evt-turn-started-primary"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-primary"),
-    });
-
-    await waitForThread(
-      harness.readModel,
-      (thread) =>
-        thread.session?.status === "running" && thread.session?.activeTurnId === "turn-primary",
-    );
-
-    harness.emit({
-      type: "turn.completed",
-      eventId: asEventId("evt-turn-completed-aux"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: "2026-01-01T00:00:00.000Z",
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-aux"),
-      status: "completed",
-    });
-
-    await harness.drain();
-    const midReadModel = await harness.readModel();
-    const midThread = midReadModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    expect(midThread?.session?.status).toBe("running");
-    expect(midThread?.session?.activeTurnId).toBe("turn-primary");
-
-    harness.emit({
-      type: "turn.completed",
-      eventId: asEventId("evt-turn-completed-primary"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: "2026-01-01T00:00:00.000Z",
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-primary"),
-      status: "completed",
-    });
-
-    await waitForThread(
-      harness.readModel,
-      (thread) => thread.session?.status === "ready" && thread.session?.activeTurnId === null,
-    );
-  });
-
-  it("rejects an untargeted turn.completed when no turn is active", async () => {
-    const harness = await createHarness();
-    const seededAt = "2026-01-01T00:00:00.000Z";
-
-    // A turn start is pending: the session reads "starting" with no active
-    // turn tracked yet. This is the window the Claude resume handshake's
-    // phantom (turn.completed with no turnId) used to slip through, stomping
-    // "starting" back to "ready" for a turn that never existed.
-    await harness.dispatch({
-      type: "thread.session.set",
-      commandId: CommandId.make("cmd-session-seed-untargeted-completion"),
-      threadId: ThreadId.make("thread-1"),
-      session: {
-        threadId: ThreadId.make("thread-1"),
-        status: "starting",
-        providerName: "claudeAgent",
-        runtimeMode: "approval-required",
-        activeTurnId: null,
-        updatedAt: seededAt,
-        lastError: null,
-      },
-      createdAt: seededAt,
-    });
-
-    harness.emit({
-      type: "turn.completed",
-      eventId: asEventId("evt-turn-completed-untargeted"),
-      provider: ProviderDriverKind.make("claudeAgent"),
-      createdAt: seededAt,
-      threadId: asThreadId("thread-1"),
-      status: "completed",
-    });
-
-    await harness.drain();
-    const readModel = await harness.readModel();
-    const thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    expect(thread?.session?.status).toBe("starting");
-    expect(thread?.session?.activeTurnId).toBeNull();
-  });
-
-  it("accepts a targeted turn.completed when no turn is active", async () => {
-    const harness = await createHarness();
-    const seededAt = "2026-01-01T00:00:00.000Z";
-
-    // A completion that names its turn still lands even when no active turn
-    // is tracked (e.g. its turn.started was lost). Only untargeted
-    // completions are rejected.
-    await harness.dispatch({
-      type: "thread.session.set",
-      commandId: CommandId.make("cmd-session-seed-targeted-completion"),
-      threadId: ThreadId.make("thread-1"),
-      session: {
-        threadId: ThreadId.make("thread-1"),
-        status: "starting",
-        providerName: "claudeAgent",
-        runtimeMode: "approval-required",
-        activeTurnId: null,
-        updatedAt: seededAt,
-        lastError: null,
-      },
-      createdAt: seededAt,
-    });
-
-    harness.emit({
-      type: "turn.completed",
-      eventId: asEventId("evt-turn-completed-targeted-late"),
-      provider: ProviderDriverKind.make("claudeAgent"),
-      createdAt: seededAt,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-late"),
-      status: "completed",
-    });
-
-    await waitForThread(harness.readModel, (thread) => thread.session?.status === "ready");
-  });
-
-  it("ignores non-active turn completion when runtime omits thread id", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    harness.emit({
-      type: "turn.started",
-      eventId: asEventId("evt-turn-started-guarded"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-guarded-main"),
-    });
-
-    await waitForThread(
-      harness.readModel,
-      (thread) =>
-        thread.session?.status === "running" &&
-        thread.session?.activeTurnId === "turn-guarded-main",
-    );
-
-    harness.emit({
-      type: "turn.completed",
-      eventId: asEventId("evt-turn-completed-guarded-other"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: "2026-01-01T00:00:00.000Z",
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-guarded-other"),
-      status: "completed",
-    });
-
-    await harness.drain();
-    const midReadModel = await harness.readModel();
-    const midThread = midReadModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    expect(midThread?.session?.status).toBe("running");
-    expect(midThread?.session?.activeTurnId).toBe("turn-guarded-main");
-
-    harness.emit({
-      type: "turn.completed",
-      eventId: asEventId("evt-turn-completed-guarded-main"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: "2026-01-01T00:00:00.000Z",
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-guarded-main"),
-      status: "completed",
-    });
-
-    await waitForThread(
-      harness.readModel,
-      (thread) => thread.session?.status === "ready" && thread.session?.activeTurnId === null,
-    );
-  });
-
-  it("maps canonical content delta/item completed into finalized assistant messages", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    harness.emit({
-      type: "content.delta",
-      eventId: asEventId("evt-message-delta-1"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-2"),
-      itemId: asItemId("item-1"),
-      payload: {
-        streamKind: "assistant_text",
-        delta: "hello",
-      },
-    });
-    harness.emit({
-      type: "content.delta",
-      eventId: asEventId("evt-message-delta-2"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-2"),
-      itemId: asItemId("item-1"),
-      payload: {
-        streamKind: "assistant_text",
-        delta: " world",
-      },
-    });
-    harness.emit({
-      type: "item.completed",
-      eventId: asEventId("evt-message-completed"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-2"),
-      itemId: asItemId("item-1"),
-      payload: {
-        itemType: "assistant_message",
-        status: "completed",
-      },
-    });
-
-    const thread = await waitForThread(harness.readModel, (entry) =>
-      entry.messages.some(
-        (message: ProviderRuntimeTestMessage) =>
-          message.id === "assistant:item-1" && !message.streaming,
-      ),
-    );
-    const message = thread.messages.find(
-      (entry: ProviderRuntimeTestMessage) => entry.id === "assistant:item-1",
-    );
-    expect(message?.text).toBe("hello world");
-    expect(message?.streaming).toBe(false);
-  });
-
-  it("uses assistant item completion detail when no assistant deltas were streamed", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    harness.emit({
-      type: "item.completed",
-      eventId: asEventId("evt-assistant-item-completed-no-delta"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-no-delta"),
-      itemId: asItemId("item-no-delta"),
-      payload: {
-        itemType: "assistant_message",
-        status: "completed",
-        detail: "assistant-only final text",
-      },
-    });
-
-    const thread = await waitForThread(harness.readModel, (entry) =>
-      entry.messages.some(
-        (message: ProviderRuntimeTestMessage) =>
-          message.id === "assistant:item-no-delta" && !message.streaming,
-      ),
-    );
-    const message = thread.messages.find(
-      (entry: ProviderRuntimeTestMessage) => entry.id === "assistant:item-no-delta",
-    );
-    expect(message?.text).toBe("assistant-only final text");
-    expect(message?.streaming).toBe(false);
-  });
-
-  it("preserves completed tool metadata on projected tool activities", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    harness.emit({
-      type: "item.completed",
-      eventId: asEventId("evt-tool-completed-with-data"),
-      provider: ProviderDriverKind.make("cursor"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-tool-completed"),
-      itemId: asItemId("item-tool-completed"),
-      payload: {
-        itemType: "dynamic_tool_call",
-        status: "completed",
-        title: "Read file",
-        data: {
-          toolCallId: "tool-read-1",
-          kind: "read",
-          rawOutput: {
-            content: 'import * as Effect from "effect/Effect"\n',
-          },
-        },
-      },
-    });
-
-    const thread = await waitForThread(harness.readModel, (entry) =>
-      entry.activities.some(
-        (activity: ProviderRuntimeTestActivity) => activity.id === "evt-tool-completed-with-data",
-      ),
-    );
-    const activity = thread.activities.find(
-      (entry: ProviderRuntimeTestActivity) => entry.id === "evt-tool-completed-with-data",
-    );
-    const payload =
-      activity?.payload && typeof activity.payload === "object"
-        ? (activity.payload as Record<string, unknown>)
-        : undefined;
-    const data =
-      payload?.data && typeof payload.data === "object"
-        ? (payload.data as Record<string, unknown>)
-        : undefined;
-    const rawOutput =
-      data?.rawOutput && typeof data.rawOutput === "object"
-        ? (data.rawOutput as Record<string, unknown>)
-        : undefined;
-
-    expect(activity?.kind).toBe("tool.completed");
-    expect(activity?.summary).toBe("Read file");
-    expect(payload?.itemType).toBe("dynamic_tool_call");
-    expect(payload?.detail).toBeUndefined();
-    expect(data?.toolCallId).toBe("tool-read-1");
-    expect(data?.kind).toBe("read");
-    expect(rawOutput?.content).toBe('import * as Effect from "effect/Effect"\n');
-  });
-
-  it("normalizes command execution activities to ran-command summaries", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    harness.emit({
-      type: "item.completed",
-      eventId: asEventId("evt-command-completed"),
-      provider: ProviderDriverKind.make("cursor"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-command-completed"),
-      itemId: asItemId("item-command-completed"),
-      payload: {
-        itemType: "command_execution",
-        status: "completed",
-        title: "Ran command",
-        detail: "bun run lint",
-        data: {
-          toolCallId: "tool-command-1",
-          kind: "execute",
-          command: "bun run lint",
-        },
-      },
-    });
-
-    const thread = await waitForThread(harness.readModel, (entry) =>
-      entry.activities.some(
-        (activity: ProviderRuntimeTestActivity) => activity.id === "evt-command-completed",
-      ),
-    );
-    const activity = thread.activities.find(
-      (entry: ProviderRuntimeTestActivity) => entry.id === "evt-command-completed",
-    );
-    const payload =
-      activity?.payload && typeof activity.payload === "object"
-        ? (activity.payload as Record<string, unknown>)
-        : undefined;
-
-    expect(activity?.summary).toBe("Ran command");
-    expect(payload?.detail).toBe("bun run lint");
-  });
-
-  it("uses structured read-file paths when available", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    harness.emit({
-      type: "item.completed",
-      eventId: asEventId("evt-read-path-completed"),
-      provider: ProviderDriverKind.make("cursor"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-read-path"),
-      itemId: asItemId("item-read-path"),
-      payload: {
-        itemType: "dynamic_tool_call",
-        status: "completed",
-        title: "Read file",
-        detail: "/tmp/app.ts",
-        data: {
-          toolCallId: "tool-read-path-1",
-          kind: "read",
-          locations: [{ path: "/tmp/app.ts" }],
-        },
-      },
-    });
-
-    const thread = await waitForThread(harness.readModel, (entry) =>
-      entry.activities.some(
-        (activity: ProviderRuntimeTestActivity) => activity.id === "evt-read-path-completed",
-      ),
-    );
-    const activity = thread.activities.find(
-      (entry: ProviderRuntimeTestActivity) => entry.id === "evt-read-path-completed",
-    );
-    const payload =
-      activity?.payload && typeof activity.payload === "object"
-        ? (activity.payload as Record<string, unknown>)
-        : undefined;
-
-    expect(activity?.summary).toBe("Read file");
-    expect(payload?.detail).toBe("/tmp/app.ts");
-  });
-
-  it("projects completed plan items into first-class proposed plans", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    harness.emit({
-      type: "turn.proposed.completed",
-      eventId: asEventId("evt-plan-item-completed"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-plan-final"),
-      payload: {
-        planMarkdown: "## Ship plan\n\n- wire projection\n- render follow-up",
-      },
-    });
-
-    const thread = await waitForThread(harness.readModel, (entry) =>
-      entry.proposedPlans.some(
-        (proposedPlan: ProviderRuntimeTestProposedPlan) =>
-          proposedPlan.id === "plan:thread-1:turn:turn-plan-final",
-      ),
-    );
-    const proposedPlan = thread.proposedPlans.find(
-      (entry: ProviderRuntimeTestProposedPlan) => entry.id === "plan:thread-1:turn:turn-plan-final",
-    );
-    expect(proposedPlan?.planMarkdown).toBe(
-      "## Ship plan\n\n- wire projection\n- render follow-up",
-    );
-  });
-
-  it("marks the source proposed plan implemented only after the target turn starts", async () => {
-    const harness = await createHarness();
-    const sourceThreadId = asThreadId("thread-plan");
-    const targetThreadId = asThreadId("thread-implement");
-    const sourceTurnId = asTurnId("turn-plan-source");
-    const targetTurnId = asTurnId("turn-plan-implement");
-    const createdAt = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.create",
-        commandId: CommandId.make("cmd-thread-create-plan-source"),
-        threadId: sourceThreadId,
-        projectId: asProjectId("project-1"),
-        title: "Plan Source",
-        modelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5-codex",
-        },
-        interactionMode: "plan",
-        runtimeMode: "approval-required",
-        branch: null,
-        worktreePath: null,
-        createdAt,
-      }),
-    );
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.session.set",
-        commandId: CommandId.make("cmd-session-set-plan-source"),
-        threadId: sourceThreadId,
-        session: {
-          threadId: sourceThreadId,
-          status: "ready",
-          providerName: "codex",
-          runtimeMode: "approval-required",
-          activeTurnId: null,
-          updatedAt: createdAt,
-          lastError: null,
-        },
-        createdAt,
-      }),
-    );
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.create",
-        commandId: CommandId.make("cmd-thread-create-plan-target"),
-        threadId: targetThreadId,
-        projectId: asProjectId("project-1"),
-        title: "Plan Target",
-        modelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5-codex",
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        branch: null,
-        worktreePath: null,
-        createdAt,
-      }),
-    );
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.session.set",
-        commandId: CommandId.make("cmd-session-set-plan-target"),
-        threadId: targetThreadId,
-        session: {
-          threadId: targetThreadId,
-          status: "ready",
-          providerName: "codex",
-          runtimeMode: "approval-required",
-          activeTurnId: null,
-          updatedAt: createdAt,
-          lastError: null,
-        },
-        createdAt,
-      }),
-    );
-    harness.setProviderSession({
-      provider: ProviderDriverKind.make("codex"),
-      status: "ready",
-      runtimeMode: "approval-required",
-      threadId: targetThreadId,
-      createdAt,
-      updatedAt: createdAt,
-      activeTurnId: targetTurnId,
-    });
-
-    harness.emit({
-      type: "turn.proposed.completed",
-      eventId: asEventId("evt-plan-source-completed"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt,
-      threadId: sourceThreadId,
-      turnId: sourceTurnId,
-      payload: {
-        planMarkdown: "# Source plan",
-      },
-    });
-
-    const sourceThreadWithPlan = await waitForThread(
-      harness.readModel,
-      (thread) =>
-        thread.proposedPlans.some(
-          (proposedPlan: ProviderRuntimeTestProposedPlan) =>
-            proposedPlan.id === "plan:thread-plan:turn:turn-plan-source" &&
-            proposedPlan.implementedAt === null,
-        ),
-      2_000,
-      sourceThreadId,
-    );
-    const sourcePlan = sourceThreadWithPlan.proposedPlans.find(
-      (entry: ProviderRuntimeTestProposedPlan) =>
-        entry.id === "plan:thread-plan:turn:turn-plan-source",
-    );
-    expect(sourcePlan).toBeDefined();
-    if (!sourcePlan) {
-      throw new Error("Expected source plan to exist.");
-    }
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-plan-target"),
-        threadId: targetThreadId,
-        message: {
-          messageId: asMessageId("msg-plan-target"),
-          role: "user",
-          text: "PLEASE IMPLEMENT THIS PLAN:\n# Source plan",
-          attachments: [],
-        },
-        sourceProposedPlan: {
-          threadId: sourceThreadId,
-          planId: sourcePlan.id,
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: "2026-01-01T00:00:00.000Z",
-      }),
-    );
-
-    const sourceThreadBeforeStart = await waitForThread(
-      harness.readModel,
-      (thread) =>
-        thread.proposedPlans.some(
-          (proposedPlan: ProviderRuntimeTestProposedPlan) =>
-            proposedPlan.id === sourcePlan.id && proposedPlan.implementedAt === null,
-        ),
-      2_000,
-      sourceThreadId,
-    );
-    expect(
-      sourceThreadBeforeStart.proposedPlans.find((entry) => entry.id === sourcePlan.id),
-    ).toMatchObject({
-      implementedAt: null,
-      implementationThreadId: null,
-    });
-
-    harness.emit({
-      type: "turn.started",
-      eventId: asEventId("evt-plan-target-started"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: "2026-01-01T00:00:00.000Z",
-      threadId: targetThreadId,
-      turnId: targetTurnId,
-    });
-
-    const sourceThreadAfterStart = await waitForThread(
-      harness.readModel,
-      (thread) =>
-        thread.proposedPlans.some(
-          (proposedPlan: ProviderRuntimeTestProposedPlan) =>
-            proposedPlan.id === sourcePlan.id &&
-            proposedPlan.implementedAt !== null &&
-            proposedPlan.implementationThreadId === targetThreadId,
-        ),
-      2_000,
-      sourceThreadId,
-    );
-    expect(
-      sourceThreadAfterStart.proposedPlans.find((entry) => entry.id === sourcePlan.id),
-    ).toMatchObject({
-      implementationThreadId: "thread-implement",
-    });
-  });
-
-  it("does not mark the source proposed plan implemented for a rejected turn.started event", async () => {
-    const harness = await createHarness();
-    const sourceThreadId = asThreadId("thread-plan");
-    const targetThreadId = asThreadId("thread-1");
-    const sourceTurnId = asTurnId("turn-plan-source");
-    const activeTurnId = asTurnId("turn-already-running");
-    const staleTurnId = asTurnId("turn-stale-start");
-    const createdAt = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      Effect.andThen(
-        harness.engine.dispatch({
-          type: "thread.create",
-          commandId: CommandId.make("cmd-thread-create-plan-source-guarded"),
-          threadId: sourceThreadId,
-          projectId: asProjectId("project-1"),
-          title: "Plan Source",
-          modelSelection: {
-            instanceId: ProviderInstanceId.make("codex"),
-            model: "gpt-5-codex",
-          },
-          interactionMode: "plan",
-          runtimeMode: "approval-required",
-          branch: null,
-          worktreePath: null,
-          createdAt,
-        }),
-        harness.engine.dispatch({
-          type: "thread.session.set",
-          commandId: CommandId.make("cmd-session-set-plan-source-guarded"),
-          threadId: sourceThreadId,
-          session: {
-            threadId: sourceThreadId,
-            status: "ready",
-            providerName: "codex",
-            runtimeMode: "approval-required",
-            activeTurnId: null,
-            updatedAt: createdAt,
-            lastError: null,
-          },
-          createdAt,
-        }),
-      ),
-    );
-    harness.setProviderSession({
-      provider: ProviderDriverKind.make("codex"),
-      status: "running",
-      runtimeMode: "approval-required",
-      threadId: targetThreadId,
-      createdAt,
-      updatedAt: createdAt,
-      activeTurnId,
-    });
-
-    harness.emit({
-      type: "turn.started",
-      eventId: asEventId("evt-turn-started-already-running"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt,
-      threadId: targetThreadId,
-      turnId: activeTurnId,
-    });
-
-    await waitForThread(
-      harness.readModel,
-      (thread) =>
-        thread.session?.status === "running" && thread.session?.activeTurnId === activeTurnId,
-      2_000,
-      targetThreadId,
-    );
-
-    harness.emit({
-      type: "turn.proposed.completed",
-      eventId: asEventId("evt-plan-source-completed-guarded"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt,
-      threadId: sourceThreadId,
-      turnId: sourceTurnId,
-      payload: {
-        planMarkdown: "# Source plan",
-      },
-    });
-
-    const sourceThreadWithPlan = await waitForThread(
-      harness.readModel,
-      (thread) =>
-        thread.proposedPlans.some(
-          (proposedPlan: ProviderRuntimeTestProposedPlan) =>
-            proposedPlan.id === "plan:thread-plan:turn:turn-plan-source" &&
-            proposedPlan.implementedAt === null,
-        ),
-      2_000,
-      sourceThreadId,
-    );
-    const sourcePlan = sourceThreadWithPlan.proposedPlans.find(
-      (entry: ProviderRuntimeTestProposedPlan) =>
-        entry.id === "plan:thread-plan:turn:turn-plan-source",
-    );
-    expect(sourcePlan).toBeDefined();
-    if (!sourcePlan) {
-      throw new Error("Expected source plan to exist.");
-    }
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-plan-target-guarded"),
-        threadId: targetThreadId,
-        message: {
-          messageId: asMessageId("msg-plan-target-guarded"),
-          role: "user",
-          text: "PLEASE IMPLEMENT THIS PLAN:\n# Source plan",
-          attachments: [],
-        },
-        sourceProposedPlan: {
-          threadId: sourceThreadId,
-          planId: sourcePlan.id,
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: "2026-01-01T00:00:00.000Z",
-      }),
-    );
-
-    harness.emit({
-      type: "turn.started",
-      eventId: asEventId("evt-turn-started-stale-plan-implementation"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: "2026-01-01T00:00:00.000Z",
-      threadId: targetThreadId,
-      turnId: staleTurnId,
-    });
-
-    await harness.drain();
-
-    const readModel = await harness.readModel();
-    const sourceThreadAfterRejectedStart = readModel.threads.find(
-      (entry) => entry.id === sourceThreadId,
-    );
-    expect(
-      sourceThreadAfterRejectedStart?.proposedPlans.find((entry) => entry.id === sourcePlan.id),
-    ).toMatchObject({
-      implementedAt: null,
-      implementationThreadId: null,
-    });
-
-    const targetThreadAfterRejectedStart = readModel.threads.find(
-      (entry) => entry.id === targetThreadId,
-    );
-    expect(targetThreadAfterRejectedStart?.session?.status).toBe("running");
-    expect(targetThreadAfterRejectedStart?.session?.activeTurnId).toBe(activeTurnId);
-  });
-
-  it("accepts a conflicting turn.started for a pending turn start when the provider expects that turn", async () => {
-    // Steering a running turn: the server requests a new turn while the old
-    // one is still active, and providers like opencode open the new turn
-    // without ever completing the superseded one. The new turn.started must
-    // replace the active turn instead of being rejected as stale.
-    const harness = await createHarness();
-    const threadId = asThreadId("thread-1");
-    const oldTurnId = asTurnId("turn-steered-over");
-    const newTurnId = asTurnId("turn-from-steer");
-    const createdAt = "2026-01-01T00:00:00.000Z";
-
-    harness.setProviderSession({
-      provider: ProviderDriverKind.make("codex"),
-      status: "running",
-      runtimeMode: "approval-required",
-      threadId,
-      createdAt,
-      updatedAt: createdAt,
-      activeTurnId: oldTurnId,
-    });
-    harness.emit({
-      type: "turn.started",
-      eventId: asEventId("evt-turn-started-steered-over"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt,
-      threadId,
-      turnId: oldTurnId,
-    });
-    await waitForThread(
-      harness.readModel,
-      (thread) =>
-        thread.session?.status === "running" && thread.session?.activeTurnId === oldTurnId,
-      2_000,
-      threadId,
-    );
-
-    // The steer: a user-requested turn start while the old turn still runs.
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-steer"),
-        threadId,
-        message: {
-          messageId: asMessageId("msg-steer"),
-          role: "user",
-          text: "actually, do 15 instead",
-          attachments: [],
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt,
-      }),
-    );
-
-    // The provider session tracks the new turn before emitting turn.started
-    // (sendTurn updates the session first).
-    harness.setProviderSession({
-      provider: ProviderDriverKind.make("codex"),
-      status: "running",
-      runtimeMode: "approval-required",
-      threadId,
-      createdAt,
-      updatedAt: createdAt,
-      activeTurnId: newTurnId,
-    });
-    harness.emit({
-      type: "turn.started",
-      eventId: asEventId("evt-turn-started-from-steer"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt,
-      threadId,
-      turnId: newTurnId,
-    });
-
-    const threadAfterSteer = await waitForThread(
-      harness.readModel,
-      (thread) =>
-        thread.session?.status === "running" && thread.session?.activeTurnId === newTurnId,
-      2_000,
-      threadId,
-    );
-    expect(threadAfterSteer.session?.activeTurnId).toBe(newTurnId);
-    expect(threadAfterSteer.latestTurn?.turnId).toBe(newTurnId);
-    expect(threadAfterSteer.latestTurn?.state).toBe("running");
-  });
-
-  it("does not mark the source proposed plan implemented for an unrelated turn.started when no thread active turn is tracked", async () => {
-    const harness = await createHarness();
-    const sourceThreadId = asThreadId("thread-plan");
-    const targetThreadId = asThreadId("thread-implement");
-    const sourceTurnId = asTurnId("turn-plan-source");
-    const expectedTurnId = asTurnId("turn-plan-implement");
-    const replayedTurnId = asTurnId("turn-replayed");
-    const createdAt = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.create",
-        commandId: CommandId.make("cmd-thread-create-plan-source-unrelated"),
-        threadId: sourceThreadId,
-        projectId: asProjectId("project-1"),
-        title: "Plan Source",
-        modelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5-codex",
-        },
-        interactionMode: "plan",
-        runtimeMode: "approval-required",
-        branch: null,
-        worktreePath: null,
-        createdAt,
-      }),
-    );
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.session.set",
-        commandId: CommandId.make("cmd-session-set-plan-source-unrelated"),
-        threadId: sourceThreadId,
-        session: {
-          threadId: sourceThreadId,
-          status: "ready",
-          providerName: "codex",
-          runtimeMode: "approval-required",
-          activeTurnId: null,
-          updatedAt: createdAt,
-          lastError: null,
-        },
-        createdAt,
-      }),
-    );
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.create",
-        commandId: CommandId.make("cmd-thread-create-plan-target-unrelated"),
-        threadId: targetThreadId,
-        projectId: asProjectId("project-1"),
-        title: "Plan Target",
-        modelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5-codex",
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        branch: null,
-        worktreePath: null,
-        createdAt,
-      }),
-    );
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.session.set",
-        commandId: CommandId.make("cmd-session-set-plan-target-unrelated"),
-        threadId: targetThreadId,
-        session: {
-          threadId: targetThreadId,
-          status: "ready",
-          providerName: "codex",
-          runtimeMode: "approval-required",
-          activeTurnId: null,
-          updatedAt: createdAt,
-          lastError: null,
-        },
-        createdAt,
-      }),
-    );
-
-    harness.emit({
-      type: "turn.proposed.completed",
-      eventId: asEventId("evt-plan-source-completed-unrelated"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt,
-      threadId: sourceThreadId,
-      turnId: sourceTurnId,
-      payload: {
-        planMarkdown: "# Source plan",
-      },
-    });
-
-    const sourceThreadWithPlan = await waitForThread(
-      harness.readModel,
-      (thread) =>
-        thread.proposedPlans.some(
-          (proposedPlan: ProviderRuntimeTestProposedPlan) =>
-            proposedPlan.id === "plan:thread-plan:turn:turn-plan-source" &&
-            proposedPlan.implementedAt === null,
-        ),
-      2_000,
-      sourceThreadId,
-    );
-    const sourcePlan = sourceThreadWithPlan.proposedPlans.find(
-      (entry: ProviderRuntimeTestProposedPlan) =>
-        entry.id === "plan:thread-plan:turn:turn-plan-source",
-    );
-    expect(sourcePlan).toBeDefined();
-    if (!sourcePlan) {
-      throw new Error("Expected source plan to exist.");
-    }
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-plan-target-unrelated"),
-        threadId: targetThreadId,
-        message: {
-          messageId: asMessageId("msg-plan-target-unrelated"),
-          role: "user",
-          text: "PLEASE IMPLEMENT THIS PLAN:\n# Source plan",
-          attachments: [],
-        },
-        sourceProposedPlan: {
-          threadId: sourceThreadId,
-          planId: sourcePlan.id,
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: "2026-01-01T00:00:00.000Z",
-      }),
-    );
-
-    harness.setProviderSession({
-      provider: ProviderDriverKind.make("codex"),
-      status: "running",
-      runtimeMode: "approval-required",
-      threadId: targetThreadId,
-      createdAt,
-      updatedAt: createdAt,
-      activeTurnId: expectedTurnId,
-    });
-
-    harness.emit({
-      type: "turn.started",
-      eventId: asEventId("evt-turn-started-unrelated-plan-implementation"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: "2026-01-01T00:00:00.000Z",
-      threadId: targetThreadId,
-      turnId: replayedTurnId,
-    });
-
-    await harness.drain();
-
-    const readModel = await harness.readModel();
-    const sourceThreadAfterUnrelatedStart = readModel.threads.find(
-      (entry) => entry.id === sourceThreadId,
-    );
-    expect(
-      sourceThreadAfterUnrelatedStart?.proposedPlans.find((entry) => entry.id === sourcePlan.id),
-    ).toMatchObject({
-      implementedAt: null,
-      implementationThreadId: null,
-    });
-  });
-
-  it("finalizes buffered proposed-plan deltas into a first-class proposed plan on turn completion", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    harness.emit({
-      type: "turn.started",
-      eventId: asEventId("evt-turn-started-plan-buffer"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-plan-buffer"),
-    });
-
-    await waitForThread(
-      harness.readModel,
-      (thread) =>
-        thread.session?.status === "running" && thread.session?.activeTurnId === "turn-plan-buffer",
-    );
-
-    harness.emit({
-      type: "turn.proposed.delta",
-      eventId: asEventId("evt-plan-delta-1"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-plan-buffer"),
-      payload: {
-        delta: "## Buffered plan\n\n- first",
-      },
-    });
-    harness.emit({
-      type: "turn.proposed.delta",
-      eventId: asEventId("evt-plan-delta-2"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-plan-buffer"),
-      payload: {
-        delta: "\n- second",
-      },
-    });
-    harness.emit({
-      type: "turn.completed",
-      eventId: asEventId("evt-turn-completed-plan-buffer"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-plan-buffer"),
-      payload: {
-        state: "completed",
-      },
-    });
-
-    const thread = await waitForThread(harness.readModel, (entry) =>
-      entry.proposedPlans.some(
-        (proposedPlan: ProviderRuntimeTestProposedPlan) =>
-          proposedPlan.id === "plan:thread-1:turn:turn-plan-buffer",
-      ),
-    );
-    const proposedPlan = thread.proposedPlans.find(
-      (entry: ProviderRuntimeTestProposedPlan) =>
-        entry.id === "plan:thread-1:turn:turn-plan-buffer",
-    );
-    expect(proposedPlan?.planMarkdown).toBe("## Buffered plan\n\n- first\n- second");
-  });
-
-  it("buffers assistant deltas by default until completion", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    harness.emit({
-      type: "turn.started",
-      eventId: asEventId("evt-turn-started-buffered"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-buffered"),
-    });
-    await waitForThread(
-      harness.readModel,
-      (thread) =>
-        thread.session?.status === "running" && thread.session?.activeTurnId === "turn-buffered",
-    );
-
-    harness.emit({
-      type: "content.delta",
-      eventId: asEventId("evt-message-delta-buffered"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-buffered"),
-      itemId: asItemId("item-buffered"),
-      payload: {
-        streamKind: "assistant_text",
-        delta: "buffer me",
-      },
-    });
-
-    await harness.drain();
-    const midReadModel = await harness.readModel();
-    const midThread = midReadModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    expect(
-      midThread?.messages.some(
-        (message: ProviderRuntimeTestMessage) => message.id === "assistant:item-buffered",
-      ),
-    ).toBe(false);
-
-    harness.emit({
-      type: "item.completed",
-      eventId: asEventId("evt-message-completed-buffered"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-buffered"),
-      itemId: asItemId("item-buffered"),
-      payload: {
-        itemType: "assistant_message",
-        status: "completed",
-      },
-    });
-
-    const thread = await waitForThread(harness.readModel, (entry) =>
-      entry.messages.some(
-        (message: ProviderRuntimeTestMessage) =>
-          message.id === "assistant:item-buffered" && !message.streaming,
-      ),
-    );
-    const message = thread.messages.find(
-      (entry: ProviderRuntimeTestMessage) => entry.id === "assistant:item-buffered",
-    );
-    expect(message?.text).toBe("buffer me");
-    expect(message?.streaming).toBe(false);
-  });
-
-  it("flushes and completes buffered assistant text when an approval request opens", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    harness.emit({
-      type: "turn.started",
-      eventId: asEventId("evt-turn-started-buffered-request-flush"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-buffered-request-flush"),
-    });
-    await waitForThread(
-      harness.readModel,
-      (thread) =>
-        thread.session?.status === "running" &&
-        thread.session?.activeTurnId === "turn-buffered-request-flush",
-    );
-
-    harness.emit({
-      type: "content.delta",
-      eventId: asEventId("evt-message-delta-buffered-request-flush"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-buffered-request-flush"),
-      itemId: asItemId("item-buffered-request-flush"),
-      payload: {
-        streamKind: "assistant_text",
-        delta: "visible before approval",
-      },
-    });
-    harness.emit({
-      type: "request.opened",
-      eventId: asEventId("evt-request-opened-buffered-request-flush"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-buffered-request-flush"),
-      requestId: ApprovalRequestId.make("req-buffered-request-flush"),
-      payload: {
-        requestType: "command_execution_approval",
-        detail: "pwd",
-      },
-    });
-
-    const thread = await waitForThread(harness.readModel, (entry) =>
-      entry.messages.some(
-        (message: ProviderRuntimeTestMessage) =>
-          message.id === "assistant:item-buffered-request-flush" &&
-          !message.streaming &&
-          message.text === "visible before approval",
-      ),
-    );
-    const message = thread.messages.find(
-      (entry: ProviderRuntimeTestMessage) => entry.id === "assistant:item-buffered-request-flush",
-    );
-    expect(message?.streaming).toBe(false);
-  });
-
-  it("flushes and completes buffered assistant text when user input is requested", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    harness.emit({
-      type: "turn.started",
-      eventId: asEventId("evt-turn-started-buffered-user-input-flush"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-buffered-user-input-flush"),
-    });
-    await waitForThread(
-      harness.readModel,
-      (thread) =>
-        thread.session?.status === "running" &&
-        thread.session?.activeTurnId === "turn-buffered-user-input-flush",
-    );
-
-    harness.emit({
-      type: "content.delta",
-      eventId: asEventId("evt-message-delta-buffered-user-input-flush"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-buffered-user-input-flush"),
-      itemId: asItemId("item-buffered-user-input-flush"),
-      payload: {
-        streamKind: "assistant_text",
-        delta: "visible before user input",
-      },
-    });
-    harness.emit({
-      type: "user-input.requested",
-      eventId: asEventId("evt-user-input-requested-buffered-user-input-flush"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-buffered-user-input-flush"),
-      requestId: ApprovalRequestId.make("req-buffered-user-input-flush"),
-      payload: {
-        questions: [
-          {
-            id: "choice",
-            header: "Choice",
-            question: "Pick one",
-            options: [{ label: "A", description: "Option A" }],
-          },
-        ],
-      },
-    });
-
-    const thread = await waitForThread(harness.readModel, (entry) =>
-      entry.messages.some(
-        (message: ProviderRuntimeTestMessage) =>
-          message.id === "assistant:item-buffered-user-input-flush" &&
-          !message.streaming &&
-          message.text === "visible before user input",
-      ),
-    );
-    const message = thread.messages.find(
-      (entry: ProviderRuntimeTestMessage) =>
-        entry.id === "assistant:item-buffered-user-input-flush",
-    );
-    expect(message?.streaming).toBe(false);
-  });
-
-  it("does not create assistant segments for whitespace-only buffered text at approval boundaries", async () => {
-    const harness = await createHarness();
-    const startedAt = "2026-03-28T06:28:00.000Z";
-    const pausedAt = "2026-03-28T06:28:01.000Z";
-
-    harness.emit({
-      type: "turn.started",
-      eventId: asEventId("evt-turn-started-buffered-whitespace-request"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: startedAt,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-buffered-whitespace-request"),
-    });
-    await waitForThread(
-      harness.readModel,
-      (thread) =>
-        thread.session?.status === "running" &&
-        thread.session?.activeTurnId === "turn-buffered-whitespace-request",
-    );
-
-    harness.emit({
-      type: "content.delta",
-      eventId: asEventId("evt-message-delta-buffered-whitespace-request"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: startedAt,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-buffered-whitespace-request"),
-      itemId: asItemId("item-buffered-whitespace-request"),
-      payload: {
-        streamKind: "assistant_text",
-        delta: "\n\n\n",
-      },
-    });
-    harness.emit({
-      type: "request.opened",
-      eventId: asEventId("evt-request-opened-buffered-whitespace-request"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: pausedAt,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-buffered-whitespace-request"),
-      requestId: ApprovalRequestId.make("req-buffered-whitespace-request"),
-      payload: {
-        requestType: "command_execution_approval",
-        detail: "pwd",
-      },
-    });
-
-    const thread = await waitForThread(harness.readModel, (entry) =>
-      entry.activities.some(
-        (activity: ProviderRuntimeTestActivity) => activity.kind === "approval.requested",
-      ),
-    );
-    expect(
-      thread.messages.some(
-        (message: ProviderRuntimeTestMessage) =>
-          message.id === "assistant:item-buffered-whitespace-request",
-      ),
-    ).toBe(false);
-  });
-
-  it("starts a new buffered assistant message segment after approval and completes without duplication", async () => {
-    const harness = await createHarness();
-    const startedAt = "2026-03-28T06:07:00.000Z";
-    const pausedAt = "2026-03-28T06:07:01.000Z";
-    const resumedAt = "2026-03-28T06:07:02.000Z";
-    const completedAt = "2026-03-28T06:07:03.000Z";
-
-    harness.emit({
-      type: "turn.started",
-      eventId: asEventId("evt-turn-started-buffered-request-append"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: startedAt,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-buffered-request-append"),
-    });
-    await waitForThread(
-      harness.readModel,
-      (thread) =>
-        thread.session?.status === "running" &&
-        thread.session?.activeTurnId === "turn-buffered-request-append",
-    );
-
-    harness.emit({
-      type: "content.delta",
-      eventId: asEventId("evt-message-delta-buffered-request-append-initial"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: startedAt,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-buffered-request-append"),
-      itemId: asItemId("item-buffered-request-append"),
-      payload: {
-        streamKind: "assistant_text",
-        delta: "first half",
-      },
-    });
-    harness.emit({
-      type: "request.opened",
-      eventId: asEventId("evt-request-opened-buffered-request-append"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: pausedAt,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-buffered-request-append"),
-      requestId: ApprovalRequestId.make("req-buffered-request-append"),
-      payload: {
-        requestType: "command_execution_approval",
-        detail: "pwd",
-      },
-    });
-
-    await waitForThread(harness.readModel, (entry) =>
-      entry.messages.some(
-        (message: ProviderRuntimeTestMessage) =>
-          message.id === "assistant:item-buffered-request-append" &&
-          !message.streaming &&
-          message.text === "first half",
-      ),
-    );
-
-    harness.emit({
-      type: "content.delta",
-      eventId: asEventId("evt-message-delta-buffered-request-append-followup"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: resumedAt,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-buffered-request-append"),
-      itemId: asItemId("item-buffered-request-append"),
-      payload: {
-        streamKind: "assistant_text",
-        delta: " second half",
-      },
-    });
-    harness.emit({
-      type: "item.completed",
-      eventId: asEventId("evt-message-completed-buffered-request-append"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: completedAt,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-buffered-request-append"),
-      itemId: asItemId("item-buffered-request-append"),
-      payload: {
-        itemType: "assistant_message",
-        status: "completed",
-      },
-    });
-
-    const thread = await waitForThread(harness.readModel, (entry) =>
-      entry.messages.some(
-        (message: ProviderRuntimeTestMessage) =>
-          message.id === "assistant:item-buffered-request-append:segment:1" &&
-          !message.streaming &&
-          message.text === " second half",
-      ),
-    );
-    const firstMessage = thread.messages.find(
-      (entry: ProviderRuntimeTestMessage) => entry.id === "assistant:item-buffered-request-append",
-    );
-    const resumedMessage = thread.messages.find(
-      (entry: ProviderRuntimeTestMessage) =>
-        entry.id === "assistant:item-buffered-request-append:segment:1",
-    );
-    expect(firstMessage?.text).toBe("first half");
-    expect(firstMessage?.streaming).toBe(false);
-    expect(resumedMessage?.text).toBe(" second half");
-    expect(resumedMessage?.streaming).toBe(false);
-
-    const events = await Effect.runPromise(
-      Stream.runCollect(harness.engine.readEvents(0)).pipe(
-        Effect.map((chunk) => Array.from(chunk)),
-      ),
-    );
-    const assistantEvents = events.filter(
-      (event): event is Extract<(typeof events)[number], { type: "thread.message-sent" }> =>
-        event.type === "thread.message-sent" &&
-        event.payload.messageId.startsWith("assistant:item-buffered-request-append"),
-    );
-    expect(assistantEvents).toHaveLength(4);
-    expect(assistantEvents[0]?.payload.streaming).toBe(true);
-    expect(assistantEvents[0]?.payload.text).toBe("first half");
-    expect(assistantEvents[1]?.payload.streaming).toBe(false);
-    expect(assistantEvents[1]?.payload.text).toBe("");
-    expect(assistantEvents[2]?.payload.messageId).toBe(
-      "assistant:item-buffered-request-append:segment:1",
-    );
-    expect(assistantEvents[2]?.payload.streaming).toBe(true);
-    expect(assistantEvents[2]?.payload.text).toBe(" second half");
-    expect(assistantEvents[3]?.payload.messageId).toBe(
-      "assistant:item-buffered-request-append:segment:1",
-    );
-    expect(assistantEvents[3]?.payload.streaming).toBe(false);
-    expect(assistantEvents[3]?.payload.text).toBe("");
-  });
-
-  it("starts a new streaming assistant message segment after approval", async () => {
-    const harness = await createHarness({ serverSettings: { enableLegacyTokenStreaming: true } });
-    const startedAt = "2026-03-28T07:00:00.000Z";
-    const pausedAt = "2026-03-28T07:00:01.000Z";
-    const resumedAt = "2026-03-28T07:00:02.000Z";
-    const completedAt = "2026-03-28T07:00:03.000Z";
-
-    harness.emit({
-      type: "turn.started",
-      eventId: asEventId("evt-turn-started-streaming-request-segment"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: startedAt,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-streaming-request-segment"),
-    });
-    await waitForThread(
-      harness.readModel,
-      (thread) =>
-        thread.session?.status === "running" &&
-        thread.session?.activeTurnId === "turn-streaming-request-segment",
-    );
-
-    harness.emit({
-      type: "content.delta",
-      eventId: asEventId("evt-message-delta-streaming-request-segment-initial"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: startedAt,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-streaming-request-segment"),
-      itemId: asItemId("item-streaming-request-segment"),
-      payload: {
-        streamKind: "assistant_text",
-        delta: "before approval",
-      },
-    });
-    harness.emit({
-      type: "request.opened",
-      eventId: asEventId("evt-request-opened-streaming-request-segment"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: pausedAt,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-streaming-request-segment"),
-      requestId: ApprovalRequestId.make("req-streaming-request-segment"),
-      payload: {
-        requestType: "command_execution_approval",
-        detail: "pwd",
-      },
-    });
-
-    await waitForThread(harness.readModel, (entry) =>
-      entry.messages.some(
-        (message: ProviderRuntimeTestMessage) =>
-          message.id === "assistant:item-streaming-request-segment" &&
-          !message.streaming &&
-          message.text === "before approval",
-      ),
-    );
-
-    harness.emit({
-      type: "content.delta",
-      eventId: asEventId("evt-message-delta-streaming-request-segment-followup"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: resumedAt,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-streaming-request-segment"),
-      itemId: asItemId("item-streaming-request-segment"),
-      payload: {
-        streamKind: "assistant_text",
-        delta: " after approval",
-      },
-    });
-    harness.emit({
-      type: "item.completed",
-      eventId: asEventId("evt-message-completed-streaming-request-segment"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: completedAt,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-streaming-request-segment"),
-      itemId: asItemId("item-streaming-request-segment"),
-      payload: {
-        itemType: "assistant_message",
-        status: "completed",
-      },
-    });
-
-    const thread = await waitForThread(harness.readModel, (entry) =>
-      entry.messages.some(
-        (message: ProviderRuntimeTestMessage) =>
-          message.id === "assistant:item-streaming-request-segment:segment:1" &&
-          !message.streaming &&
-          message.text === " after approval",
-      ),
-    );
-    expect(
-      thread.messages.find(
-        (message: ProviderRuntimeTestMessage) =>
-          message.id === "assistant:item-streaming-request-segment",
-      )?.text,
-    ).toBe("before approval");
-    expect(
-      thread.messages.find(
-        (message: ProviderRuntimeTestMessage) =>
-          message.id === "assistant:item-streaming-request-segment:segment:1",
-      )?.text,
-    ).toBe(" after approval");
-  });
-
-  it("streams assistant deltas when thread.turn.start requests streaming mode", async () => {
-    const harness = await createHarness({ serverSettings: { enableLegacyTokenStreaming: true } });
-    const now = "2026-01-01T00:00:00.000Z";
-
-    await Effect.runPromise(
-      harness.engine.dispatch({
-        type: "thread.turn.start",
-        commandId: CommandId.make("cmd-turn-start-streaming-mode"),
-        threadId: ThreadId.make("thread-1"),
-        message: {
-          messageId: asMessageId("message-streaming-mode"),
-          role: "user",
-          text: "stream please",
-          attachments: [],
-        },
-        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-        runtimeMode: "approval-required",
-        createdAt: now,
-      }),
-    );
-    await harness.drain();
-
-    harness.emit({
-      type: "turn.started",
-      eventId: asEventId("evt-turn-started-streaming-mode"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-streaming-mode"),
-    });
-    await waitForThread(
-      harness.readModel,
-      (thread) =>
-        thread.session?.status === "running" &&
-        thread.session?.activeTurnId === "turn-streaming-mode",
-    );
-
-    harness.emit({
-      type: "content.delta",
-      eventId: asEventId("evt-message-delta-streaming-mode"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-streaming-mode"),
-      itemId: asItemId("item-streaming-mode"),
-      payload: {
-        streamKind: "assistant_text",
-        delta: "hello live",
-      },
-    });
-
-    const liveThread = await waitForThread(harness.readModel, (entry) =>
-      entry.messages.some(
-        (message: ProviderRuntimeTestMessage) =>
-          message.id === "assistant:item-streaming-mode" &&
-          message.streaming &&
-          message.text === "hello live",
-      ),
-    );
-    const liveMessage = liveThread.messages.find(
-      (entry: ProviderRuntimeTestMessage) => entry.id === "assistant:item-streaming-mode",
-    );
-    expect(liveMessage?.streaming).toBe(true);
-
-    harness.emit({
-      type: "item.completed",
-      eventId: asEventId("evt-message-completed-streaming-mode"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-streaming-mode"),
-      itemId: asItemId("item-streaming-mode"),
-      payload: {
-        itemType: "assistant_message",
-        status: "completed",
-        detail: "hello live",
-      },
-    });
-
-    const finalThread = await waitForThread(harness.readModel, (entry) =>
-      entry.messages.some(
-        (message: ProviderRuntimeTestMessage) =>
-          message.id === "assistant:item-streaming-mode" && !message.streaming,
-      ),
-    );
-    const finalMessage = finalThread.messages.find(
-      (entry: ProviderRuntimeTestMessage) => entry.id === "assistant:item-streaming-mode",
-    );
-    expect(finalMessage?.text).toBe("hello live");
-    expect(finalMessage?.streaming).toBe(false);
-  });
-
-  it("spills oversized buffered deltas and still finalizes full assistant text", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-    const oversizedText = "x".repeat(40_000);
-
-    harness.emit({
-      type: "turn.started",
-      eventId: asEventId("evt-turn-started-buffer-spill"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-buffer-spill"),
-    });
-    await waitForThread(
-      harness.readModel,
-      (thread) =>
-        thread.session?.status === "running" &&
-        thread.session?.activeTurnId === "turn-buffer-spill",
-    );
-
-    harness.emit({
-      type: "content.delta",
-      eventId: asEventId("evt-message-delta-buffer-spill"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-buffer-spill"),
-      itemId: asItemId("item-buffer-spill"),
-      payload: {
-        streamKind: "assistant_text",
-        delta: oversizedText,
-      },
-    });
-    harness.emit({
-      type: "item.completed",
-      eventId: asEventId("evt-message-completed-buffer-spill"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-buffer-spill"),
-      itemId: asItemId("item-buffer-spill"),
-      payload: {
-        itemType: "assistant_message",
-        status: "completed",
-      },
-    });
-
-    const thread = await waitForThread(harness.readModel, (entry) =>
-      entry.messages.some(
-        (message: ProviderRuntimeTestMessage) =>
-          message.id === "assistant:item-buffer-spill" && !message.streaming,
-      ),
-    );
-    const message = thread.messages.find(
-      (entry: ProviderRuntimeTestMessage) => entry.id === "assistant:item-buffer-spill",
-    );
-    expect(message?.text.length).toBe(oversizedText.length);
-    expect(message?.text).toBe(oversizedText);
-    expect(message?.streaming).toBe(false);
-  });
-
-  it("does not duplicate assistant completion when item.completed is followed by turn.completed", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    harness.emit({
-      type: "turn.started",
-      eventId: asEventId("evt-turn-started-for-complete-dedup"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-complete-dedup"),
-    });
-
-    await waitForThread(
-      harness.readModel,
-      (thread) =>
-        thread.session?.status === "running" &&
-        thread.session?.activeTurnId === "turn-complete-dedup",
-    );
-
-    harness.emit({
-      type: "content.delta",
-      eventId: asEventId("evt-message-delta-for-complete-dedup"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-complete-dedup"),
-      itemId: asItemId("item-complete-dedup"),
-      payload: {
-        streamKind: "assistant_text",
-        delta: "done",
-      },
-    });
-    harness.emit({
-      type: "item.completed",
-      eventId: asEventId("evt-message-completed-for-complete-dedup"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-complete-dedup"),
-      itemId: asItemId("item-complete-dedup"),
-      payload: {
-        itemType: "assistant_message",
-        status: "completed",
-      },
-    });
-    harness.emit({
-      type: "turn.completed",
-      eventId: asEventId("evt-turn-completed-for-complete-dedup"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-complete-dedup"),
-      payload: {
-        state: "completed",
-      },
-    });
-
-    await waitForThread(
-      harness.readModel,
-      (thread) =>
-        thread.session?.status === "ready" &&
-        thread.session?.activeTurnId === null &&
-        thread.messages.some(
-          (message: ProviderRuntimeTestMessage) =>
-            message.id === "assistant:item-complete-dedup" && !message.streaming,
-        ),
-    );
-
-    const events = await Effect.runPromise(
-      Stream.runCollect(harness.engine.readEvents(0)).pipe(
-        Effect.map((chunk) => Array.from(chunk)),
-      ),
-    );
-    const completionEvents = events.filter((event) => {
-      if (event.type !== "thread.message-sent") {
-        return false;
-      }
-      return (
-        event.payload.messageId === "assistant:item-complete-dedup" &&
-        event.payload.streaming === false
-      );
-    });
-    expect(completionEvents).toHaveLength(1);
-  });
-
-  it("maps canonical request events into approval activities with requestKind", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    harness.emit({
-      type: "request.opened",
-      eventId: asEventId("evt-request-opened"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      requestId: ApprovalRequestId.make("req-open"),
-      payload: {
-        requestType: "command_execution_approval",
-        detail: "pwd",
-      },
-    });
-
-    harness.emit({
-      type: "request.resolved",
-      eventId: asEventId("evt-request-resolved"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      requestId: ApprovalRequestId.make("req-open"),
-      payload: {
-        requestType: "command_execution_approval",
-        decision: "accept",
-      },
-    });
-
-    await waitForThread(
-      harness.readModel,
-      (entry) =>
-        entry.activities.some(
-          (activity: ProviderRuntimeTestActivity) => activity.kind === "approval.requested",
-        ) &&
-        entry.activities.some(
-          (activity: ProviderRuntimeTestActivity) => activity.kind === "approval.resolved",
-        ),
-    );
-
-    const readModel = await harness.readModel();
-    const thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    expect(thread).toBeDefined();
-
-    const requested = thread?.activities.find(
-      (activity: ProviderRuntimeTestActivity) => activity.id === "evt-request-opened",
-    );
-    const requestedPayload =
-      requested?.payload && typeof requested.payload === "object"
-        ? (requested.payload as Record<string, unknown>)
-        : undefined;
-    expect(requestedPayload?.requestKind).toBe("command");
-    expect(requestedPayload?.requestType).toBe("command_execution_approval");
-
-    const resolved = thread?.activities.find(
-      (activity: ProviderRuntimeTestActivity) => activity.id === "evt-request-resolved",
-    );
-    const resolvedPayload =
-      resolved?.payload && typeof resolved.payload === "object"
-        ? (resolved.payload as Record<string, unknown>)
-        : undefined;
-    expect(resolvedPayload?.requestKind).toBe("command");
-    expect(resolvedPayload?.requestType).toBe("command_execution_approval");
-  });
-
-  it("maps runtime.error into errored session state", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    harness.emit({
-      type: "runtime.error",
-      eventId: asEventId("evt-runtime-error"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-3"),
-      payload: {
-        message: "runtime exploded",
-      },
-    });
-
-    const thread = await waitForThread(
-      harness.readModel,
-      (entry) =>
-        entry.session?.status === "error" &&
-        entry.session?.activeTurnId === "turn-3" &&
-        entry.session?.lastError === "runtime exploded",
-    );
-    expect(thread.session?.status).toBe("error");
-    expect(thread.session?.lastError).toBe("runtime exploded");
-  });
-
-  it("records runtime.error activities from the typed payload message", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    harness.emit({
-      type: "runtime.error",
-      eventId: asEventId("evt-runtime-error-activity"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-runtime-error-activity"),
-      payload: {
-        message: "runtime activity exploded",
-      },
-    });
-
-    const thread = await waitForThread(harness.readModel, (entry) =>
-      entry.activities.some((activity) => activity.id === "evt-runtime-error-activity"),
-    );
-    const activity = thread.activities.find(
-      (entry: ProviderRuntimeTestActivity) => entry.id === "evt-runtime-error-activity",
-    );
-    const activityPayload =
-      activity?.payload && typeof activity.payload === "object"
-        ? (activity.payload as Record<string, unknown>)
-        : undefined;
-
-    expect(activity?.kind).toBe("runtime.error");
-    expect(activityPayload?.message).toBe("runtime activity exploded");
-  });
-
-  it("keeps the session running when a runtime.warning arrives during an active turn", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    harness.emit({
-      type: "turn.started",
-      eventId: asEventId("evt-warning-turn-started"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-warning"),
-      payload: {},
-    });
-
-    harness.emit({
-      type: "runtime.warning",
-      eventId: asEventId("evt-warning-runtime"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-warning"),
-      payload: {
-        message: "Reconnecting... 2/5",
-        detail: {
-          willRetry: true,
-        },
-      },
-    });
-
-    const thread = await waitForThread(
-      harness.readModel,
-      (entry) =>
-        entry.session?.status === "running" &&
-        entry.session?.activeTurnId === "turn-warning" &&
-        entry.activities.some(
-          (activity: ProviderRuntimeTestActivity) =>
-            activity.id === "evt-warning-runtime" && activity.kind === "runtime.warning",
-        ),
-    );
-    expect(thread.session?.status).toBe("running");
-    expect(thread.session?.activeTurnId).toBe("turn-warning");
-    expect(thread.session?.lastError).toBeNull();
-  });
-
-  it("maps session/thread lifecycle and item.started into session/activity projections", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    harness.emit({
-      type: "session.started",
-      eventId: asEventId("evt-session-started"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      message: "session started",
-    });
-    harness.emit({
-      type: "thread.started",
-      eventId: asEventId("evt-thread-started"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-    });
-    harness.emit({
-      type: "item.started",
-      eventId: asEventId("evt-tool-started"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-9"),
-      itemId: asItemId("tool-call-9"),
-      payload: {
-        itemType: "command_execution",
-        status: "inProgress",
-        title: "Command run",
-        detail: "Bash: vp test run",
-        data: {
-          toolName: "Bash",
-          input: { command: "vp test run" },
-        },
-      },
-    });
-
-    const thread = await waitForThread(
-      harness.readModel,
-      (entry) =>
-        entry.session?.status === "ready" &&
-        entry.session?.activeTurnId === null &&
-        entry.activities.some(
-          (activity: ProviderRuntimeTestActivity) => activity.kind === "tool.started",
-        ),
-    );
-
-    expect(thread.session?.status).toBe("ready");
-    const activity = thread.activities.find(
-      (entry: ProviderRuntimeTestActivity) => entry.kind === "tool.started",
-    );
-    const payload = activity?.payload as Record<string, unknown> | undefined;
-    expect(payload).toMatchObject({
-      itemType: "command_execution",
-      toolCallId: "tool-call-9",
-      status: "inProgress",
-      detail: "Bash: vp test run",
-      data: {
-        toolName: "Bash",
-        input: { command: "vp test run" },
-      },
-    });
-  });
-
-  it("consumes P1 runtime events into thread metadata, diff checkpoints, and activities", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    harness.emit({
-      type: "thread.metadata.updated",
-      eventId: asEventId("evt-thread-metadata-updated"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      payload: {
-        name: "Renamed by provider",
-        metadata: { source: "provider" },
-      },
-    });
-
-    harness.emit({
-      type: "turn.plan.updated",
-      eventId: asEventId("evt-turn-plan-updated"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-p1"),
-      payload: {
-        explanation: "Working through the plan",
-        plan: [
-          { step: "Inspect files", status: "completed" },
-          { step: "Apply patch", status: "in_progress" },
-        ],
-      },
-    });
-
-    harness.emit({
-      type: "item.updated",
-      eventId: asEventId("evt-item-updated"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-p1"),
-      itemId: asItemId("item-p1-tool"),
-      payload: {
-        itemType: "command_execution",
-        status: "in_progress",
-        title: "Run tests",
-        detail: "bun test",
-        data: { pid: 123 },
-      },
-    });
-
-    harness.emit({
-      type: "runtime.warning",
-      eventId: asEventId("evt-runtime-warning"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-p1"),
-      payload: {
-        message: "Provider got slow",
-        detail: { latencyMs: 1500 },
-      },
-    });
-
-    harness.emit({
-      type: "turn.diff.updated",
-      eventId: asEventId("evt-turn-diff-updated"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-p1"),
-      itemId: asItemId("item-p1-assistant"),
-      payload: {
-        unifiedDiff: "diff --git a/file.txt b/file.txt\n+hello\n",
-      },
-    });
-
-    const thread = await waitForThread(
-      harness.readModel,
-      (entry) =>
-        entry.title === "Thread" &&
-        entry.activities.some(
-          (activity: ProviderRuntimeTestActivity) => activity.kind === "turn.plan.updated",
-        ) &&
-        entry.activities.some(
-          (activity: ProviderRuntimeTestActivity) => activity.kind === "tool.updated",
-        ) &&
-        entry.activities.some(
-          (activity: ProviderRuntimeTestActivity) => activity.kind === "runtime.warning",
-        ) &&
-        entry.checkpoints.some(
-          (checkpoint: ProviderRuntimeTestCheckpoint) => checkpoint.turnId === "turn-p1",
-        ),
-    );
-
-    expect(thread.title).toBe("Thread");
-
-    const planActivity = thread.activities.find(
-      (activity: ProviderRuntimeTestActivity) => activity.id === "evt-turn-plan-updated",
-    );
-    const planPayload =
-      planActivity?.payload && typeof planActivity.payload === "object"
-        ? (planActivity.payload as Record<string, unknown>)
-        : undefined;
-    expect(planActivity?.kind).toBe("turn.plan.updated");
-    expect(Array.isArray(planPayload?.plan)).toBe(true);
-
-    const toolUpdate = thread.activities.find(
-      (activity: ProviderRuntimeTestActivity) => activity.id === "evt-item-updated",
-    );
-    const toolUpdatePayload =
-      toolUpdate?.payload && typeof toolUpdate.payload === "object"
-        ? (toolUpdate.payload as Record<string, unknown>)
-        : undefined;
-    expect(toolUpdate?.kind).toBe("tool.updated");
-    expect(toolUpdatePayload?.itemType).toBe("command_execution");
-    expect(toolUpdatePayload?.status).toBe("in_progress");
-    expect(toolUpdatePayload?.toolCallId).toBe("item-p1-tool");
-
-    const warning = thread.activities.find(
-      (activity: ProviderRuntimeTestActivity) => activity.id === "evt-runtime-warning",
-    );
-    const warningPayload =
-      warning?.payload && typeof warning.payload === "object"
-        ? (warning.payload as Record<string, unknown>)
-        : undefined;
-    expect(warning?.kind).toBe("runtime.warning");
-    expect(warningPayload?.message).toBe("Provider got slow");
-
-    const checkpoint = thread.checkpoints.find(
-      (entry: ProviderRuntimeTestCheckpoint) => entry.turnId === "turn-p1",
-    );
-    expect(checkpoint?.status).toBe("missing");
-    expect(checkpoint?.assistantMessageId).toBe("assistant:item-p1-assistant");
-    expect(checkpoint?.checkpointRef).toBe("provider-diff:evt-turn-diff-updated");
-  });
-
-  it("mirrors a provider title only while the thread still has the default title", async () => {
-    const harness = await createHarness({ threadTitle: DEFAULT_THREAD_TITLE });
-    const now = "2026-01-01T00:00:00.000Z";
-
-    harness.emit({
-      type: "thread.metadata.updated",
-      eventId: asEventId("evt-thread-metadata-default"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      payload: {
-        name: "Renamed by provider",
-        metadata: { source: "provider" },
-      },
-    });
-
-    const thread = await waitForThread(
-      harness.readModel,
-      (entry) => entry.title === "Renamed by provider",
-    );
-    expect(thread.title).toBe("Renamed by provider");
-  });
-
-  it("rejects a provider title once the thread has a real title", async () => {
-    const harness = await createHarness({ threadTitle: "User-set title" });
-    const now = "2026-01-01T00:00:00.000Z";
-
-    harness.emit({
-      type: "thread.metadata.updated",
-      eventId: asEventId("evt-thread-metadata-real"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      payload: {
-        name: "Renamed by provider",
-        metadata: { source: "provider" },
-      },
-    });
-
-    await harness.drain();
-    const readModel = await harness.readModel();
-    const thread = readModel.threads.find((entry) => entry.id === ThreadId.make("thread-1"));
-    expect(thread?.title).toBe("User-set title");
-  });
-
-  it("projects context window updates into normalized thread activities", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    harness.emit({
-      type: "thread.token-usage.updated",
-      eventId: asEventId("evt-thread-token-usage-updated"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      payload: {
-        usage: {
-          usedTokens: 1075,
-          totalProcessedTokens: 10_200,
-          maxTokens: 128_000,
-          inputTokens: 1000,
-          cachedInputTokens: 500,
-          outputTokens: 50,
-          reasoningOutputTokens: 25,
-          lastUsedTokens: 1075,
-          lastInputTokens: 1000,
-          lastCachedInputTokens: 500,
-          lastOutputTokens: 50,
-          lastReasoningOutputTokens: 25,
-          compactsAutomatically: true,
-        },
-      },
-    });
-
-    const thread = await waitForThread(harness.readModel, (entry) =>
-      entry.activities.some(
-        (activity: ProviderRuntimeTestActivity) => activity.kind === "context-window.updated",
-      ),
-    );
-
-    const usageActivity = thread.activities.find(
-      (activity: ProviderRuntimeTestActivity) => activity.kind === "context-window.updated",
-    );
-    expect(usageActivity).toBeDefined();
-    expect(usageActivity?.payload).toMatchObject({
-      usedTokens: 1075,
-      totalProcessedTokens: 10_200,
-      maxTokens: 128_000,
-      inputTokens: 1000,
-      cachedInputTokens: 500,
-      outputTokens: 50,
-      reasoningOutputTokens: 25,
-      lastUsedTokens: 1075,
-      compactsAutomatically: true,
-    });
-  });
-
-  it("projects Codex camelCase token usage payloads into normalized thread activities", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    harness.emit({
-      type: "thread.token-usage.updated",
-      eventId: asEventId("evt-thread-token-usage-updated-camel"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      payload: {
-        usage: {
-          usedTokens: 126,
-          totalProcessedTokens: 11_839,
-          maxTokens: 258_400,
-          inputTokens: 120,
-          cachedInputTokens: 0,
-          outputTokens: 6,
-          reasoningOutputTokens: 0,
-          lastUsedTokens: 126,
-          lastInputTokens: 120,
-          lastCachedInputTokens: 0,
-          lastOutputTokens: 6,
-          lastReasoningOutputTokens: 0,
-          compactsAutomatically: true,
-        },
-      },
-    });
-
-    const thread = await waitForThread(harness.readModel, (entry) =>
-      entry.activities.some(
-        (activity: ProviderRuntimeTestActivity) => activity.kind === "context-window.updated",
-      ),
-    );
-
-    const usageActivity = thread.activities.find(
-      (activity: ProviderRuntimeTestActivity) => activity.kind === "context-window.updated",
-    );
-    expect(usageActivity?.payload).toMatchObject({
-      usedTokens: 126,
-      totalProcessedTokens: 11_839,
-      maxTokens: 258_400,
-      inputTokens: 120,
-      cachedInputTokens: 0,
-      outputTokens: 6,
-      reasoningOutputTokens: 0,
-      lastUsedTokens: 126,
-      lastInputTokens: 120,
-      lastOutputTokens: 6,
-      compactsAutomatically: true,
-    });
-  });
-
-  it("projects Claude usage snapshots with context window into normalized thread activities", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    harness.emit({
-      type: "thread.token-usage.updated",
-      eventId: asEventId("evt-thread-token-usage-updated-claude-window"),
-      provider: ProviderDriverKind.make("claudeAgent"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      payload: {
-        usage: {
-          usedTokens: 31_251,
-          lastUsedTokens: 31_251,
-          maxTokens: 200_000,
-          toolUses: 25,
-          durationMs: 43_567,
-        },
-      },
-      raw: {
-        source: "claude.sdk.message",
-        method: "claude/result/success",
-        payload: {},
-      },
-    });
-
-    const thread = await waitForThread(harness.readModel, (entry) =>
-      entry.activities.some(
-        (activity: ProviderRuntimeTestActivity) => activity.kind === "context-window.updated",
-      ),
-    );
-
-    const usageActivity = thread.activities.find(
-      (activity: ProviderRuntimeTestActivity) => activity.kind === "context-window.updated",
-    );
-    expect(usageActivity?.payload).toMatchObject({
-      usedTokens: 31_251,
-      lastUsedTokens: 31_251,
-      maxTokens: 200_000,
-      toolUses: 25,
-      durationMs: 43_567,
-    });
-  });
-
-  it("projects compacted thread state into context compaction activities", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    harness.emit({
-      type: "thread.state.changed",
-      eventId: asEventId("evt-thread-compacted"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-1"),
-      payload: {
-        state: "compacted",
-        detail: { source: "provider" },
-      },
-    });
-
-    const thread = await waitForThread(harness.readModel, (entry) =>
-      entry.activities.some(
-        (activity: ProviderRuntimeTestActivity) => activity.kind === "context-compaction",
-      ),
-    );
-
-    const activity = thread.activities.find(
-      (candidate: ProviderRuntimeTestActivity) => candidate.kind === "context-compaction",
-    );
-    expect(activity?.summary).toBe("Context compacted");
-    expect(activity?.tone).toBe("info");
-  });
-
-  it("projects Codex task lifecycle chunks into thread activities", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    harness.emit({
-      type: "task.started",
-      eventId: asEventId("evt-task-started"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-task-1"),
-      payload: {
-        taskId: "turn-task-1",
-        taskType: "plan",
-      },
-    });
-
-    harness.emit({
-      type: "task.progress",
-      eventId: asEventId("evt-task-progress"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-task-1"),
-      payload: {
-        taskId: "turn-task-1",
-        description: "Comparing the desktop rollout chunks to the app-server stream.",
-        summary: "Code reviewer is validating the desktop rollout chunks.",
-      },
-    });
-
-    harness.emit({
-      type: "task.completed",
-      eventId: asEventId("evt-task-completed"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-task-1"),
-      payload: {
-        taskId: "turn-task-1",
-        status: "completed",
-        summary: "<proposed_plan>\n# Plan title\n</proposed_plan>",
-      },
-    });
-    harness.emit({
-      type: "turn.proposed.completed",
-      eventId: asEventId("evt-task-proposed-plan-completed"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-task-1"),
-      payload: {
-        planMarkdown: "# Plan title",
-      },
-    });
-
-    const thread = await waitForThread(
-      harness.readModel,
-      (entry) =>
-        entry.activities.some(
-          (activity: ProviderRuntimeTestActivity) => activity.kind === "task.completed",
-        ) &&
-        entry.proposedPlans.some(
-          (proposedPlan: ProviderRuntimeTestProposedPlan) =>
-            proposedPlan.id === "plan:thread-1:turn:turn-task-1",
-        ),
-    );
-
-    const started = thread.activities.find(
-      (activity: ProviderRuntimeTestActivity) => activity.id === "evt-task-started",
-    );
-    const progress = thread.activities.find(
-      (activity: ProviderRuntimeTestActivity) =>
-        activity.id === "task-progress:thread-1:turn-task-1",
-    );
-    const completed = thread.activities.find(
-      (activity: ProviderRuntimeTestActivity) => activity.id === "evt-task-completed",
-    );
-
-    const progressPayload =
-      progress?.payload && typeof progress.payload === "object"
-        ? (progress.payload as Record<string, unknown>)
-        : undefined;
-    const completedPayload =
-      completed?.payload && typeof completed.payload === "object"
-        ? (completed.payload as Record<string, unknown>)
-        : undefined;
-
-    expect(started?.kind).toBe("task.started");
-    expect(started?.summary).toBe("Plan task started");
-    expect(progress?.kind).toBe("task.progress");
-    expect(progressPayload?.detail).toBe("Code reviewer is validating the desktop rollout chunks.");
-    expect(progressPayload?.summary).toBe(
-      "Code reviewer is validating the desktop rollout chunks.",
-    );
-    expect(completed?.kind).toBe("task.completed");
-    expect(completedPayload?.detail).toBe("<proposed_plan>\n# Plan title\n</proposed_plan>");
-    expect(
-      thread.proposedPlans.find(
-        (entry: ProviderRuntimeTestProposedPlan) => entry.id === "plan:thread-1:turn:turn-task-1",
-      )?.planMarkdown,
-    ).toBe("# Plan title");
-  });
-
-  it("titles task activities with the task description, including on completion", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    harness.emit({
-      type: "task.started",
-      eventId: asEventId("evt-named-task-started"),
-      provider: ProviderDriverKind.make("claudeAgent"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-named-task"),
-      payload: {
-        taskId: "named-task-1",
-        description: "Typecheck mobile app",
-        taskType: "local_bash",
-      },
-    });
-
-    harness.emit({
-      type: "task.progress",
-      eventId: asEventId("evt-named-task-progress"),
-      provider: ProviderDriverKind.make("claudeAgent"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-named-task"),
-      payload: {
-        taskId: "named-task-1",
-        description: "Typecheck mobile app",
-        summary: "Running tsc across the mobile workspace.",
-      },
-    });
-
-    harness.emit({
-      type: "task.completed",
-      eventId: asEventId("evt-named-task-completed"),
-      provider: ProviderDriverKind.make("claudeAgent"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-named-task"),
-      payload: {
-        taskId: "named-task-1",
-        status: "completed",
-        summary: "Typecheck finished without errors.",
-      },
-    });
-
-    const thread = await waitForThread(harness.readModel, (entry) =>
-      entry.activities.some(
-        (activity: ProviderRuntimeTestActivity) => activity.id === "evt-named-task-completed",
-      ),
-    );
-
-    const progress = thread.activities.find(
-      (activity: ProviderRuntimeTestActivity) =>
-        activity.id === "task-progress:thread-1:named-task-1",
-    );
-    const completed = thread.activities.find(
-      (activity: ProviderRuntimeTestActivity) => activity.id === "evt-named-task-completed",
-    );
-
-    const progressPayload =
-      progress?.payload && typeof progress.payload === "object"
-        ? (progress.payload as Record<string, unknown>)
-        : undefined;
-    const completedPayload =
-      completed?.payload && typeof completed.payload === "object"
-        ? (completed.payload as Record<string, unknown>)
-        : undefined;
-
-    expect(progress?.summary).toBe("Typecheck mobile app");
-    expect(progressPayload?.title).toBe("Typecheck mobile app");
-    expect(completed?.summary).toBe("Task completed");
-    expect(completedPayload?.title).toBe("Typecheck mobile app");
-    expect(completedPayload?.summary).toBe("Typecheck finished without errors.");
-    expect(completedPayload?.detail).toBe("Typecheck finished without errors.");
-  });
-
-  it("titles task completion from task.started when no progress event carried the name", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    harness.emit({
-      type: "task.started",
-      eventId: asEventId("evt-fast-task-started"),
-      provider: ProviderDriverKind.make("claudeAgent"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-fast-task"),
-      payload: {
-        taskId: "fast-task-1",
-        description: "wait for codex review to finish",
-        taskType: "local_bash",
-      },
-    });
-
-    harness.emit({
-      type: "task.completed",
-      eventId: asEventId("evt-fast-task-completed"),
-      provider: ProviderDriverKind.make("claudeAgent"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-fast-task"),
-      payload: {
-        taskId: "fast-task-1",
-        status: "completed",
-      },
-    });
-
-    const thread = await waitForThread(harness.readModel, (entry) =>
-      entry.activities.some(
-        (activity: ProviderRuntimeTestActivity) => activity.id === "evt-fast-task-completed",
-      ),
-    );
-
-    const completed = thread.activities.find(
-      (activity: ProviderRuntimeTestActivity) => activity.id === "evt-fast-task-completed",
-    );
-    const completedPayload =
-      completed?.payload && typeof completed.payload === "object"
-        ? (completed.payload as Record<string, unknown>)
-        : undefined;
-
-    expect(completedPayload?.title).toBe("wait for codex review to finish");
-  });
-
-  it("titles task completion from persisted activities after the description cache is swept", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    harness.emit({
-      type: "task.progress",
-      eventId: asEventId("evt-swept-task-progress"),
-      provider: ProviderDriverKind.make("claudeAgent"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-swept-task"),
-      payload: {
-        taskId: "swept-task-1",
-        description: "Watch round-3 CI and bots",
-        summary: "Polling CI checks.",
-      },
-    });
-
-    await waitForThread(harness.readModel, (entry) =>
-      entry.activities.some(
-        (activity: ProviderRuntimeTestActivity) =>
-          activity.id === "task-progress:thread-1:swept-task-1",
-      ),
-    );
-
-    // session.exited sweeps the in-memory description cache; the completion
-    // that follows must recover the name from persisted activities.
-    harness.emit({
-      type: "session.exited",
-      eventId: asEventId("evt-swept-task-session-exited"),
-      provider: ProviderDriverKind.make("claudeAgent"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      payload: {},
-    });
-
-    harness.emit({
-      type: "task.completed",
-      eventId: asEventId("evt-swept-task-completed"),
-      provider: ProviderDriverKind.make("claudeAgent"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-swept-task"),
-      payload: {
-        taskId: "swept-task-1",
-        status: "completed",
-        summary: "CI is green.",
-      },
-    });
-
-    const thread = await waitForThread(harness.readModel, (entry) =>
-      entry.activities.some(
-        (activity: ProviderRuntimeTestActivity) => activity.id === "evt-swept-task-completed",
-      ),
-    );
-
-    const completed = thread.activities.find(
-      (activity: ProviderRuntimeTestActivity) => activity.id === "evt-swept-task-completed",
-    );
-    const completedPayload =
-      completed?.payload && typeof completed.payload === "object"
-        ? (completed.payload as Record<string, unknown>)
-        : undefined;
-
-    expect(completedPayload?.title).toBe("Watch round-3 CI and bots");
-  });
-
-  it("projects structured user input request and resolution as thread activities", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    harness.emit({
-      type: "user-input.requested",
-      eventId: asEventId("evt-user-input-requested"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-user-input"),
-      requestId: ApprovalRequestId.make("req-user-input-1"),
-      payload: {
-        questions: [
-          {
-            id: "sandbox_mode",
-            header: "Sandbox",
-            question: "Which mode should be used?",
-            options: [
-              {
-                label: "workspace-write",
-                description: "Allow workspace writes only",
-              },
-            ],
-          },
-        ],
-      },
-    });
-
-    harness.emit({
-      type: "user-input.resolved",
-      eventId: asEventId("evt-user-input-resolved"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: "2026-01-01T00:00:00.000Z",
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-user-input"),
-      requestId: ApprovalRequestId.make("req-user-input-1"),
-      payload: {
-        answers: {
-          sandbox_mode: "workspace-write",
-        },
-      },
-    });
-
-    const thread = await waitForThread(
-      harness.readModel,
-      (entry) =>
-        entry.activities.some(
-          (activity: ProviderRuntimeTestActivity) => activity.kind === "user-input.requested",
-        ) &&
-        entry.activities.some(
-          (activity: ProviderRuntimeTestActivity) => activity.kind === "user-input.resolved",
-        ),
-    );
-
-    const requested = thread.activities.find(
-      (activity: ProviderRuntimeTestActivity) => activity.id === "evt-user-input-requested",
-    );
-    expect(requested?.kind).toBe("user-input.requested");
-
-    const resolved = thread.activities.find(
-      (activity: ProviderRuntimeTestActivity) => activity.id === "evt-user-input-resolved",
-    );
-    const resolvedPayload =
-      resolved?.payload && typeof resolved.payload === "object"
-        ? (resolved.payload as Record<string, unknown>)
-        : undefined;
-    expect(resolved?.kind).toBe("user-input.resolved");
-    expect(resolvedPayload?.answers).toEqual({
-      sandbox_mode: "workspace-write",
-    });
-  });
-
-  it("continues processing runtime events after a single event handler failure", async () => {
-    const harness = await createHarness();
-    const now = "2026-01-01T00:00:00.000Z";
-
-    harness.emit({
-      type: "content.delta",
-      eventId: asEventId("evt-invalid-delta"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: now,
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-invalid"),
-      itemId: asItemId("item-invalid"),
-      payload: {
-        streamKind: "assistant_text",
-        delta: undefined,
-      },
-    } as unknown as ProviderRuntimeEvent);
-
-    harness.emit({
-      type: "runtime.error",
-      eventId: asEventId("evt-runtime-error-after-failure"),
-      provider: ProviderDriverKind.make("codex"),
-      createdAt: "2026-01-01T00:00:00.000Z",
-      threadId: asThreadId("thread-1"),
-      turnId: asTurnId("turn-after-failure"),
-      payload: {
-        message: "runtime still processed",
-      },
-    });
-
-    const thread = await waitForThread(
-      harness.readModel,
-      (entry) =>
-        entry.session?.status === "error" &&
-        entry.session?.activeTurnId === "turn-after-failure" &&
-        entry.session?.lastError === "runtime still processed",
-    );
-    expect(thread.session?.status).toBe("error");
-    expect(thread.session?.lastError).toBe("runtime still processed");
-  });
-});
diff --git a/apps/server/src/orchestration/Layers/ProviderRuntimeIngestion.ts b/apps/server/src/orchestration/Layers/ProviderRuntimeIngestion.ts
deleted file mode 100644
index 7ec3a7e64243..000000000000
--- a/apps/server/src/orchestration/Layers/ProviderRuntimeIngestion.ts
+++ /dev/null
@@ -1,2094 +0,0 @@
-import {
-  ApprovalRequestId,
-  type AssistantDeliveryMode,
-  CommandId,
-  MessageId,
-  type OrchestrationEvent,
-  type OrchestrationMessage,
-  type OrchestrationProposedPlanId,
-  CheckpointRef,
-  classifyTaskAgentKind,
-  EventId,
-  isToolLifecycleItemType,
-  ThreadId,
-  type ThreadTokenUsageSnapshot,
-  TurnId,
-  type OrchestrationCheckpointSummary,
-  type OrchestrationProposedPlan,
-  type OrchestrationThread,
-  type OrchestrationThreadActivity,
-  type ProviderRuntimeEvent,
-} from "@t3tools/contracts";
-import * as Cache from "effect/Cache";
-import * as Cause from "effect/Cause";
-import * as Crypto from "effect/Crypto";
-import * as Duration from "effect/Duration";
-import * as Effect from "effect/Effect";
-import * as Layer from "effect/Layer";
-import * as Option from "effect/Option";
-import * as Stream from "effect/Stream";
-import { makeDrainableWorker } from "@t3tools/shared/DrainableWorker";
-
-import { ProviderService } from "../../provider/Services/ProviderService.ts";
-import { ProjectionTurnRepository } from "../../persistence/Services/ProjectionTurns.ts";
-import { ProjectionTurnRepositoryLive } from "../../persistence/Layers/ProjectionTurns.ts";
-import { isGitRepository } from "../../git/Utils.ts";
-import { OrchestrationEngineService } from "../Services/OrchestrationEngine.ts";
-import { ThreadBackgroundLivenessService } from "../ThreadBackgroundLiveness.ts";
-import { ThreadPlanProgressService } from "../ThreadPlanProgress.ts";
-import { ProjectionSnapshotQuery } from "../Services/ProjectionSnapshotQuery.ts";
-import {
-  ProviderRuntimeIngestionService,
-  type ProviderRuntimeIngestionShape,
-} from "../Services/ProviderRuntimeIngestion.ts";
-import { projectActivityPayload } from "../ActivityPayloadProjection.ts";
-import { forkParked } from "../../serverActivation.ts";
-import { ServerSettingsService } from "../../serverSettings.ts";
-import { canReplaceThreadTitle } from "../threadTitles.ts";
-
-const providerTurnKey = (threadId: ThreadId, turnId: TurnId) => `${threadId}:${turnId}`;
-const providerTaskKey = (threadId: ThreadId, taskId: string) => `${threadId}:${taskId}`;
-
-// Fallback when the in-memory description cache no longer has the task name
-// (server restart, session-exit sweep, TTL/capacity eviction): earlier
-// task.started/task.progress activities for the task are persisted with it.
-function findTaskTitleInActivities(
-  activities: ReadonlyArray<OrchestrationThreadActivity> | undefined,
-  taskId: string,
-): string | undefined {
-  if (!activities) {
-    return undefined;
-  }
-  for (let index = activities.length - 1; index >= 0; index -= 1) {
-    const activity = activities[index];
-    if (!activity || (activity.kind !== "task.started" && activity.kind !== "task.progress")) {
-      continue;
-    }
-    const payload =
-      activity.payload && typeof activity.payload === "object"
-        ? (activity.payload as { taskId?: unknown; title?: unknown; detail?: unknown })
-        : undefined;
-    if (payload?.taskId !== taskId) {
-      continue;
-    }
-    const title =
-      typeof payload.title === "string"
-        ? payload.title
-        : activity.kind === "task.started" && typeof payload.detail === "string"
-          ? payload.detail
-          : undefined;
-    if (title && title.trim().length > 0) {
-      return title;
-    }
-  }
-  return undefined;
-}
-
-interface AssistantSegmentState {
-  baseKey: string;
-  nextSegmentIndex: number;
-  activeMessageId: MessageId | null;
-}
-
-const TURN_MESSAGE_IDS_BY_TURN_CACHE_CAPACITY = 10_000;
-const TURN_MESSAGE_IDS_BY_TURN_TTL = Duration.minutes(120);
-const BUFFERED_MESSAGE_TEXT_BY_MESSAGE_ID_CACHE_CAPACITY = 20_000;
-const BUFFERED_MESSAGE_TEXT_BY_MESSAGE_ID_TTL = Duration.minutes(120);
-const BUFFERED_PROPOSED_PLAN_BY_ID_CACHE_CAPACITY = 10_000;
-const BUFFERED_PROPOSED_PLAN_BY_ID_TTL = Duration.minutes(120);
-const TASK_DESCRIPTION_BY_TASK_CACHE_CAPACITY = 10_000;
-const TASK_DESCRIPTION_BY_TASK_TTL = Duration.minutes(120);
-const MAX_BUFFERED_ASSISTANT_CHARS = 24_000;
-const STRICT_PROVIDER_LIFECYCLE_GUARD = process.env.T3CODE_STRICT_PROVIDER_LIFECYCLE_GUARD !== "0";
-
-type TurnStartRequestedDomainEvent = Extract<
-  OrchestrationEvent,
-  { type: "thread.turn-start-requested" }
->;
-
-type RuntimeIngestionInput =
-  | {
-      source: "runtime";
-      event: ProviderRuntimeEvent;
-    }
-  | {
-      source: "domain";
-      event: TurnStartRequestedDomainEvent;
-    };
-
-function toTurnId(value: TurnId | string | undefined): TurnId | undefined {
-  return value === undefined ? undefined : TurnId.make(String(value));
-}
-
-function toApprovalRequestId(value: string | undefined): ApprovalRequestId | undefined {
-  return value === undefined ? undefined : ApprovalRequestId.make(value);
-}
-
-function sameId(left: string | null | undefined, right: string | null | undefined): boolean {
-  if (left === null || left === undefined || right === null || right === undefined) {
-    return false;
-  }
-  return left === right;
-}
-
-function hasAssistantMessageForTurn(
-  messages: ReadonlyArray<OrchestrationMessage>,
-  turnId: TurnId,
-  options?: { readonly streamingOnly?: boolean },
-): boolean {
-  for (let index = 0; index < messages.length; index += 1) {
-    const message = messages[index];
-    if (!message) {
-      continue;
-    }
-    if (message.role !== "assistant" || message.turnId !== turnId) {
-      continue;
-    }
-    if (options?.streamingOnly === true && !message.streaming) {
-      continue;
-    }
-    return true;
-  }
-  return false;
-}
-
-function findMessageById(
-  messages: ReadonlyArray<OrchestrationMessage>,
-  messageId: MessageId,
-): OrchestrationMessage | undefined {
-  for (let index = 0; index < messages.length; index += 1) {
-    const message = messages[index];
-    if (message?.id === messageId) {
-      return message;
-    }
-  }
-  return undefined;
-}
-
-function findProposedPlanById(
-  proposedPlans: ReadonlyArray<
-    Pick<OrchestrationProposedPlan, "id" | "createdAt" | "implementedAt" | "implementationThreadId">
-  >,
-  planId: string,
-):
-  | Pick<OrchestrationProposedPlan, "id" | "createdAt" | "implementedAt" | "implementationThreadId">
-  | undefined {
-  for (let index = 0; index < proposedPlans.length; index += 1) {
-    const proposedPlan = proposedPlans[index];
-    if (proposedPlan?.id === planId) {
-      return proposedPlan;
-    }
-  }
-  return undefined;
-}
-
-function hasCheckpointForTurn(
-  checkpoints: ReadonlyArray<OrchestrationCheckpointSummary>,
-  turnId: TurnId,
-): boolean {
-  for (let index = 0; index < checkpoints.length; index += 1) {
-    if (checkpoints[index]?.turnId === turnId) {
-      return true;
-    }
-  }
-  return false;
-}
-
-function maxCheckpointTurnCount(
-  checkpoints: ReadonlyArray<OrchestrationCheckpointSummary>,
-): number {
-  let maxTurnCount = 0;
-  for (let index = 0; index < checkpoints.length; index += 1) {
-    const checkpoint = checkpoints[index];
-    if (checkpoint && checkpoint.checkpointTurnCount > maxTurnCount) {
-      maxTurnCount = checkpoint.checkpointTurnCount;
-    }
-  }
-  return maxTurnCount;
-}
-
-function truncateDetail(value: string, limit = 180): string {
-  return value.length > limit ? `${value.slice(0, limit - 3)}...` : value;
-}
-
-function normalizeProposedPlanMarkdown(planMarkdown: string | undefined): string | undefined {
-  const trimmed = planMarkdown?.trim();
-  if (!trimmed) {
-    return undefined;
-  }
-  return trimmed;
-}
-
-function hasRenderableAssistantText(text: string | undefined): boolean {
-  return (text?.trim().length ?? 0) > 0;
-}
-
-function proposedPlanIdForTurn(threadId: ThreadId, turnId: TurnId): string {
-  return `plan:${threadId}:turn:${turnId}`;
-}
-
-function proposedPlanIdFromEvent(event: ProviderRuntimeEvent, threadId: ThreadId): string {
-  const turnId = toTurnId(event.turnId);
-  if (turnId) {
-    return proposedPlanIdForTurn(threadId, turnId);
-  }
-  if (event.itemId) {
-    return `plan:${threadId}:item:${event.itemId}`;
-  }
-  return `plan:${threadId}:event:${event.eventId}`;
-}
-
-function assistantSegmentBaseKeyFromEvent(event: ProviderRuntimeEvent): string {
-  return String(event.itemId ?? event.turnId ?? event.eventId);
-}
-
-function assistantSegmentMessageId(baseKey: string, segmentIndex: number): MessageId {
-  return MessageId.make(
-    segmentIndex === 0 ? `assistant:${baseKey}` : `assistant:${baseKey}:segment:${segmentIndex}`,
-  );
-}
-function buildContextWindowActivityPayload(
-  event: ProviderRuntimeEvent,
-): ThreadTokenUsageSnapshot | undefined {
-  if (event.type !== "thread.token-usage.updated" || event.payload.usage.usedTokens <= 0) {
-    return undefined;
-  }
-  return event.payload.usage;
-}
-
-function normalizeRuntimeTurnState(
-  value: string | undefined,
-): "completed" | "failed" | "interrupted" | "cancelled" {
-  switch (value) {
-    case "failed":
-    case "interrupted":
-    case "cancelled":
-    case "completed":
-      return value;
-    default:
-      return "completed";
-  }
-}
-
-function orchestrationSessionStatusFromRuntimeState(
-  state: "starting" | "running" | "waiting" | "ready" | "interrupted" | "stopped" | "error",
-): "starting" | "running" | "ready" | "interrupted" | "stopped" | "error" {
-  switch (state) {
-    case "starting":
-      return "starting";
-    case "running":
-    case "waiting":
-      return "running";
-    case "ready":
-      return "ready";
-    case "interrupted":
-      return "interrupted";
-    case "stopped":
-      return "stopped";
-    case "error":
-      return "error";
-  }
-}
-
-function sessionStatusAllowsActiveTurn(
-  status: ReturnType<typeof orchestrationSessionStatusFromRuntimeState>,
-): boolean {
-  return status === "starting" || status === "running";
-}
-
-function requestKindFromCanonicalRequestType(
-  requestType: string | undefined,
-): "command" | "file-read" | "file-change" | "mcp-elicitation" | undefined {
-  switch (requestType) {
-    case "command_execution_approval":
-    case "exec_command_approval":
-      return "command";
-    case "file_read_approval":
-      return "file-read";
-    case "file_change_approval":
-    case "apply_patch_approval":
-      return "file-change";
-    case "mcp_elicitation_approval":
-      return "mcp-elicitation";
-    default:
-      return undefined;
-  }
-}
-
-/**
- * Copies the optional TaskAgentLinkage bundle from a task.* runtime payload
- * into the persisted activity payload. Identity fields ride on every row so
- * client folds survive activity retention; absent fields stay absent.
- */
-function taskLinkageActivityFields(payload: Record<string, unknown>): Record<string, unknown> {
-  const fields: Record<string, unknown> = {
-    // Server-stamped classification: persisted rows are self-describing, so
-    // clients trust the stamp instead of re-deriving agent-vs-background
-    // from taskType denylists and marker heuristics (legacy rows without a
-    // stamp keep the client fallback).
-    agentKind: classifyTaskAgentKind({
-      taskType: typeof payload.taskType === "string" ? payload.taskType : undefined,
-      agentId: typeof payload.agentId === "string" ? payload.agentId : undefined,
-    }),
-  };
-  for (const key of [
-    "taskType",
-    "agentId",
-    "title",
-    "role",
-    "model",
-    "effort",
-    "toolUseId",
-    "parentAgentId",
-    "workflowName",
-    "agentIndex",
-    "phaseIndex",
-    "phaseTitle",
-    "phases",
-    "attempt",
-    "runHandles",
-    "outputFile",
-    "agentPath",
-    "timelineBypass",
-    "typedUsage",
-    "status",
-    "error",
-  ] as const) {
-    if (payload[key] !== undefined) {
-      fields[key] = payload[key];
-    }
-  }
-  return fields;
-}
-
-export function runtimeEventToActivities(
-  event: ProviderRuntimeEvent,
-  taskTitle?: string,
-): ReadonlyArray<OrchestrationThreadActivity> {
-  const maybeSequence = (() => {
-    const eventWithSequence = event as ProviderRuntimeEvent & { sessionSequence?: number };
-    return eventWithSequence.sessionSequence !== undefined
-      ? { sequence: eventWithSequence.sessionSequence }
-      : {};
-  })();
-  switch (event.type) {
-    case "request.opened": {
-      if (event.payload.requestType === "tool_user_input") {
-        return [];
-      }
-      const requestKind = requestKindFromCanonicalRequestType(event.payload.requestType);
-      return [
-        {
-          id: event.eventId,
-          createdAt: event.createdAt,
-          tone: "approval",
-          kind: "approval.requested",
-          summary:
-            requestKind === "command"
-              ? "Command approval requested"
-              : requestKind === "file-read"
-                ? "File-read approval requested"
-                : requestKind === "file-change"
-                  ? "File-change approval requested"
-                  : requestKind === "mcp-elicitation"
-                    ? "App access approval requested"
-                    : "Approval requested",
-          payload: {
-            requestId: toApprovalRequestId(event.requestId),
-            ...(requestKind ? { requestKind } : {}),
-            requestType: event.payload.requestType,
-            ...(event.payload.detail ? { detail: event.payload.detail } : {}),
-            ...(event.payload.appName ? { appName: event.payload.appName } : {}),
-            ...(event.payload.options ? { options: event.payload.options } : {}),
-          },
-          turnId: toTurnId(event.turnId) ?? null,
-          ...maybeSequence,
-        },
-      ];
-    }
-
-    case "request.resolved": {
-      if (event.payload.requestType === "tool_user_input") {
-        return [];
-      }
-      const requestKind = requestKindFromCanonicalRequestType(event.payload.requestType);
-      return [
-        {
-          id: event.eventId,
-          createdAt: event.createdAt,
-          tone: "approval",
-          kind: "approval.resolved",
-          summary: "Approval resolved",
-          payload: {
-            requestId: toApprovalRequestId(event.requestId),
-            ...(requestKind ? { requestKind } : {}),
-            requestType: event.payload.requestType,
-            ...(event.payload.decision ? { decision: event.payload.decision } : {}),
-          },
-          turnId: toTurnId(event.turnId) ?? null,
-          ...maybeSequence,
-        },
-      ];
-    }
-
-    case "runtime.error": {
-      return [
-        {
-          id: event.eventId,
-          createdAt: event.createdAt,
-          tone: "error",
-          kind: "runtime.error",
-          summary: "Runtime error",
-          payload: {
-            message: truncateDetail(event.payload.message),
-          },
-          turnId: toTurnId(event.turnId) ?? null,
-          ...maybeSequence,
-        },
-      ];
-    }
-
-    case "tool.denied": {
-      return [
-        {
-          id: event.eventId,
-          createdAt: event.createdAt,
-          tone: "error",
-          kind: "tool.denied",
-          summary: `Tool denied: ${event.payload.toolName}`,
-          payload: {
-            toolName: event.payload.toolName,
-            ...(event.payload.toolUseId ? { toolUseId: event.payload.toolUseId } : {}),
-            ...(event.payload.reason ? { detail: truncateDetail(event.payload.reason) } : {}),
-            ...(event.payload.agentId ? { agentId: event.payload.agentId } : {}),
-          },
-          turnId: toTurnId(event.turnId) ?? null,
-          ...maybeSequence,
-        },
-      ];
-    }
-
-    case "runtime.warning": {
-      return [
-        {
-          id: event.eventId,
-          createdAt: event.createdAt,
-          tone: "info",
-          kind: "runtime.warning",
-          // Use the adapter-supplied message as the row label so the work log
-          // shows what the warning was about, not a generic "Runtime warning".
-          summary: truncateDetail(event.payload.message, 120),
-          payload: {
-            message: truncateDetail(event.payload.message),
-            ...(event.payload.detail !== undefined ? { detail: event.payload.detail } : {}),
-          },
-          turnId: toTurnId(event.turnId) ?? null,
-          ...maybeSequence,
-        },
-      ];
-    }
-
-    case "turn.plan.updated": {
-      return [
-        {
-          id: event.eventId,
-          createdAt: event.createdAt,
-          tone: "info",
-          kind: "turn.plan.updated",
-          summary: "Plan updated",
-          payload: {
-            plan: event.payload.plan,
-            ...(event.payload.explanation !== undefined
-              ? { explanation: event.payload.explanation }
-              : {}),
-          },
-          turnId: toTurnId(event.turnId) ?? null,
-          ...maybeSequence,
-        },
-      ];
-    }
-
-    case "user-input.requested": {
-      return [
-        {
-          id: event.eventId,
-          createdAt: event.createdAt,
-          tone: "info",
-          kind: "user-input.requested",
-          summary: "User input requested",
-          payload: {
-            ...(event.requestId ? { requestId: event.requestId } : {}),
-            questions: event.payload.questions,
-          },
-          turnId: toTurnId(event.turnId) ?? null,
-          ...maybeSequence,
-        },
-      ];
-    }
-
-    case "user-input.resolved": {
-      return [
-        {
-          id: event.eventId,
-          createdAt: event.createdAt,
-          tone: "info",
-          kind: "user-input.resolved",
-          summary: "User input submitted",
-          payload: {
-            ...(event.requestId ? { requestId: event.requestId } : {}),
-            answers: event.payload.answers,
-          },
-          turnId: toTurnId(event.turnId) ?? null,
-          ...maybeSequence,
-        },
-      ];
-    }
-
-    case "task.started": {
-      return [
-        {
-          id: event.eventId,
-          createdAt: event.createdAt,
-          tone: "info",
-          kind: "task.started",
-          summary:
-            event.payload.taskType === "plan"
-              ? "Plan task started"
-              : event.payload.taskType
-                ? `${event.payload.taskType} task started`
-                : "Task started",
-          payload: {
-            taskId: event.payload.taskId,
-            ...(event.payload.taskType ? { taskType: event.payload.taskType } : {}),
-            ...(event.payload.description
-              ? { detail: truncateDetail(event.payload.description) }
-              : {}),
-            ...taskLinkageActivityFields(event.payload as Record<string, unknown>),
-          },
-          turnId: toTurnId(event.turnId) ?? null,
-          ...maybeSequence,
-        },
-      ];
-    }
-
-    case "task.progress": {
-      const linkage = taskLinkageActivityFields(event.payload as Record<string, unknown>);
-      // Usage and activity are independent latest-state streams. Keeping them
-      // under separate stable ids prevents a command/reasoning update from
-      // replacing the last known token count (and prevents a usage-only tick
-      // from blanking the last meaningful activity).
-      const identityLinkage = { ...linkage };
-      delete identityLinkage.typedUsage;
-      delete identityLinkage.status;
-      delete identityLinkage.error;
-      const title =
-        event.payload.description.trim().length > 0
-          ? { title: truncateDetail(event.payload.description, 120) }
-          : {};
-      const hasProgressState =
-        event.payload.typedUsage === undefined ||
-        event.payload.summary !== undefined ||
-        event.payload.lastToolName !== undefined ||
-        event.payload.status !== undefined ||
-        event.payload.error !== undefined;
-      return [
-        ...(hasProgressState
-          ? [
-              {
-                // Stable per-task id: activity is "latest state", not
-                // history, so each meaningful tick replaces the last. This
-                // bounds a large fleet to one activity row per task.
-                id: EventId.make(`task-progress:${event.threadId}:${event.payload.taskId}`),
-                createdAt: event.createdAt,
-                tone: "info" as const,
-                kind: "task.progress" as const,
-                summary:
-                  event.payload.description.trim().length > 0
-                    ? truncateDetail(event.payload.description, 120)
-                    : "Reasoning update",
-                payload: {
-                  taskId: event.payload.taskId,
-                  ...title,
-                  detail: truncateDetail(event.payload.summary ?? event.payload.description),
-                  ...(event.payload.summary
-                    ? { summary: truncateDetail(event.payload.summary) }
-                    : {}),
-                  ...(event.payload.lastToolName
-                    ? { lastToolName: event.payload.lastToolName }
-                    : {}),
-                  ...(event.payload.status ? { status: event.payload.status } : {}),
-                  ...(event.payload.error ? { error: event.payload.error } : {}),
-                  ...(event.payload.usage !== undefined ? { usage: event.payload.usage } : {}),
-                  ...identityLinkage,
-                },
-                turnId: toTurnId(event.turnId) ?? null,
-                ...maybeSequence,
-              },
-            ]
-          : []),
-        ...(event.payload.typedUsage !== undefined
-          ? [
-              {
-                id: EventId.make(`task-usage:${event.threadId}:${event.payload.taskId}`),
-                createdAt: event.createdAt,
-                tone: "info" as const,
-                kind: "task.progress" as const,
-                summary: "Task usage updated",
-                payload: {
-                  taskId: event.payload.taskId,
-                  ...title,
-                  ...identityLinkage,
-                  usageSnapshot: true,
-                  typedUsage: event.payload.typedUsage,
-                },
-                turnId: toTurnId(event.turnId) ?? null,
-                ...maybeSequence,
-              },
-            ]
-          : []),
-      ];
-    }
-
-    case "task.updated": {
-      return [
-        {
-          id: event.eventId,
-          createdAt: event.createdAt,
-          tone: event.payload.status === "failed" ? "error" : "info",
-          kind: "task.updated",
-          summary:
-            event.payload.status === "failed"
-              ? "Task failed"
-              : event.payload.status
-                ? `Task ${event.payload.status}`
-                : "Task updated",
-          payload: {
-            taskId: event.payload.taskId,
-            ...(event.payload.description
-              ? { detail: truncateDetail(event.payload.description) }
-              : {}),
-            ...(event.payload.endedAt ? { endedAt: event.payload.endedAt } : {}),
-            ...(event.payload.isBackgrounded !== undefined
-              ? { isBackgrounded: event.payload.isBackgrounded }
-              : {}),
-            ...taskLinkageActivityFields(event.payload as Record<string, unknown>),
-          },
-          turnId: toTurnId(event.turnId) ?? null,
-          ...maybeSequence,
-        },
-      ];
-    }
-
-    case "tool.progress": {
-      // Only agent-owned heartbeats are persisted: they feed the owning
-      // agent's activity line. Parent-conversation tool progress stays
-      // ephemeral (item lifecycle already covers it).
-      if (event.payload.taskId === undefined) {
-        return [];
-      }
-      return [
-        {
-          // Same stable-id treatment as task.progress: a heartbeat is
-          // "what is this agent doing right now", so one row per task
-          // (thread-scoped for the same global-PK collision reason).
-          id: EventId.make(`tool-progress:${event.threadId}:${event.payload.taskId}`),
-          createdAt: event.createdAt,
-          tone: "info",
-          kind: "tool.progress",
-          summary: event.payload.toolName ?? "Tool progress",
-          payload: {
-            taskId: event.payload.taskId,
-            ...(event.payload.toolName ? { toolName: event.payload.toolName } : {}),
-            ...(event.payload.toolUseId ? { toolUseId: event.payload.toolUseId } : {}),
-            ...(event.payload.elapsedSeconds !== undefined
-              ? { elapsedSeconds: event.payload.elapsedSeconds }
-              : {}),
-            ...(event.payload.parentToolUseId
-              ? { parentToolUseId: event.payload.parentToolUseId }
-              : {}),
-          },
-          turnId: toTurnId(event.turnId) ?? null,
-          ...maybeSequence,
-        },
-      ];
-    }
-
-    case "task.completed": {
-      return [
-        {
-          id: event.eventId,
-          createdAt: event.createdAt,
-          tone: event.payload.status === "failed" ? "error" : "info",
-          kind: "task.completed",
-          summary:
-            event.payload.status === "failed"
-              ? "Task failed"
-              : event.payload.status === "stopped"
-                ? "Task stopped"
-                : "Task completed",
-          payload: {
-            taskId: event.payload.taskId,
-            status: event.payload.status,
-            ...(taskTitle ? { title: truncateDetail(taskTitle, 120) } : {}),
-            // summary + detail mirror task.progress: clients label the row from
-            // summary and keep detail for the preview/expanded body.
-            ...(event.payload.summary
-              ? {
-                  summary: truncateDetail(event.payload.summary),
-                  detail: truncateDetail(event.payload.summary),
-                }
-              : {}),
-            ...(event.payload.usage !== undefined ? { usage: event.payload.usage } : {}),
-            ...taskLinkageActivityFields(event.payload as Record<string, unknown>),
-          },
-          turnId: toTurnId(event.turnId) ?? null,
-          ...maybeSequence,
-        },
-      ];
-    }
-
-    case "thread.state.changed": {
-      if (event.payload.state !== "compacted") {
-        return [];
-      }
-
-      return [
-        {
-          id: event.eventId,
-          createdAt: event.createdAt,
-          tone: "info",
-          kind: "context-compaction",
-          summary: "Context compacted",
-          payload: {
-            state: event.payload.state,
-            ...(event.payload.detail !== undefined ? { detail: event.payload.detail } : {}),
-          },
-          turnId: toTurnId(event.turnId) ?? null,
-          ...maybeSequence,
-        },
-      ];
-    }
-
-    case "thread.token-usage.updated": {
-      const payload = buildContextWindowActivityPayload(event);
-      if (!payload) {
-        return [];
-      }
-
-      return [
-        {
-          id: event.eventId,
-          createdAt: event.createdAt,
-          tone: "info",
-          kind: "context-window.updated",
-          summary: "Context window updated",
-          payload,
-          turnId: toTurnId(event.turnId) ?? null,
-          ...maybeSequence,
-        },
-      ];
-    }
-
-    case "item.updated": {
-      if (!isToolLifecycleItemType(event.payload.itemType)) {
-        return [];
-      }
-      // A streaming update's `data` carries the full tool output accumulated
-      // so far (adapters merge state forward), and a new activity is emitted
-      // per chunk, so persisting `data` verbatim writes O(N²) bytes per tool
-      // call into both the event store and the projection table. No reader
-      // needs it: ws.ts and http.ts apply `projectActivityPayload` before any
-      // payload reaches a client. Persist the projected form for non-terminal
-      // updates; `item.completed` below still persists the full payload.
-      return [
-        projectActivityPayload({
-          id: event.eventId,
-          createdAt: event.createdAt,
-          tone: "tool",
-          kind: "tool.updated",
-          summary: event.payload.title ?? "Tool updated",
-          payload: {
-            itemType: event.payload.itemType,
-            ...(event.itemId !== undefined ? { toolCallId: event.itemId } : {}),
-            ...(event.payload.status ? { status: event.payload.status } : {}),
-            ...(event.payload.detail ? { detail: truncateDetail(event.payload.detail) } : {}),
-            ...(event.payload.data !== undefined ? { data: event.payload.data } : {}),
-            ...(event.payload.agentId ? { agentId: event.payload.agentId } : {}),
-            ...(event.payload.parentToolUseId
-              ? { parentToolUseId: event.payload.parentToolUseId }
-              : {}),
-          },
-          turnId: toTurnId(event.turnId) ?? null,
-          ...maybeSequence,
-        }),
-      ];
-    }
-
-    case "item.completed": {
-      if (!isToolLifecycleItemType(event.payload.itemType)) {
-        return [];
-      }
-      return [
-        {
-          id: event.eventId,
-          createdAt: event.createdAt,
-          tone: "tool",
-          kind: "tool.completed",
-          summary: event.payload.title ?? "Tool",
-          payload: {
-            itemType: event.payload.itemType,
-            ...(event.itemId !== undefined ? { toolCallId: event.itemId } : {}),
-            ...(event.payload.status ? { status: event.payload.status } : {}),
-            ...(event.payload.detail ? { detail: truncateDetail(event.payload.detail) } : {}),
-            ...(event.payload.data !== undefined ? { data: event.payload.data } : {}),
-            ...(event.payload.agentId ? { agentId: event.payload.agentId } : {}),
-            ...(event.payload.parentToolUseId
-              ? { parentToolUseId: event.payload.parentToolUseId }
-              : {}),
-          },
-          turnId: toTurnId(event.turnId) ?? null,
-          ...maybeSequence,
-        },
-      ];
-    }
-
-    case "item.started": {
-      if (!isToolLifecycleItemType(event.payload.itemType)) {
-        return [];
-      }
-      return [
-        {
-          id: event.eventId,
-          createdAt: event.createdAt,
-          tone: "tool",
-          kind: "tool.started",
-          summary: `${event.payload.title ?? "Tool"} started`,
-          payload: {
-            itemType: event.payload.itemType,
-            ...(event.itemId !== undefined ? { toolCallId: event.itemId } : {}),
-            ...(event.payload.status ? { status: event.payload.status } : {}),
-            ...(event.payload.detail ? { detail: truncateDetail(event.payload.detail) } : {}),
-            ...(event.payload.data !== undefined ? { data: event.payload.data } : {}),
-            ...(event.payload.agentId ? { agentId: event.payload.agentId } : {}),
-            ...(event.payload.parentToolUseId
-              ? { parentToolUseId: event.payload.parentToolUseId }
-              : {}),
-          },
-          turnId: toTurnId(event.turnId) ?? null,
-          ...maybeSequence,
-        },
-      ];
-    }
-
-    default:
-      break;
-  }
-
-  return [];
-}
-
-const make = Effect.gen(function* () {
-  const threadBackgroundLiveness = yield* ThreadBackgroundLivenessService;
-  const threadPlanProgress = yield* ThreadPlanProgressService;
-  const crypto = yield* Crypto.Crypto;
-  const orchestrationEngine = yield* OrchestrationEngineService;
-  const projectionSnapshotQuery = yield* ProjectionSnapshotQuery;
-  const providerService = yield* ProviderService;
-  const projectionTurnRepository = yield* ProjectionTurnRepository;
-  const serverSettingsService = yield* ServerSettingsService;
-  const providerCommandId = (event: ProviderRuntimeEvent, tag: string) =>
-    crypto.randomUUIDv4.pipe(
-      Effect.map((uuid) => CommandId.make(`provider:${event.eventId}:${tag}:${uuid}`)),
-    );
-
-  const turnMessageIdsByTurnKey = yield* Cache.make<string, Set<MessageId>>({
-    capacity: TURN_MESSAGE_IDS_BY_TURN_CACHE_CAPACITY,
-    timeToLive: TURN_MESSAGE_IDS_BY_TURN_TTL,
-    lookup: () => Effect.succeed(new Set<MessageId>()),
-  });
-
-  const bufferedAssistantTextByMessageId = yield* Cache.make<MessageId, string>({
-    capacity: BUFFERED_MESSAGE_TEXT_BY_MESSAGE_ID_CACHE_CAPACITY,
-    timeToLive: BUFFERED_MESSAGE_TEXT_BY_MESSAGE_ID_TTL,
-    lookup: () => Effect.succeed(""),
-  });
-
-  const assistantSegmentStateByTurnKey = yield* Cache.make<string, AssistantSegmentState>({
-    capacity: TURN_MESSAGE_IDS_BY_TURN_CACHE_CAPACITY,
-    timeToLive: TURN_MESSAGE_IDS_BY_TURN_TTL,
-    lookup: () =>
-      Effect.die(
-        new Error("assistant segment state should be read through getOption before initialization"),
-      ),
-  });
-
-  const bufferedProposedPlanById = yield* Cache.make<string, { text: string; createdAt: string }>({
-    capacity: BUFFERED_PROPOSED_PLAN_BY_ID_CACHE_CAPACITY,
-    timeToLive: BUFFERED_PROPOSED_PLAN_BY_ID_TTL,
-    lookup: () => Effect.succeed({ text: "", createdAt: "" }),
-  });
-
-  // Task names arrive on task.started/task.progress but not on task.completed,
-  // so remember them per task to title the completion activity.
-  const taskDescriptionByTaskKey = yield* Cache.make<string, string>({
-    capacity: TASK_DESCRIPTION_BY_TASK_CACHE_CAPACITY,
-    timeToLive: TASK_DESCRIPTION_BY_TASK_TTL,
-    lookup: () => Effect.succeed(""),
-  });
-
-  const rememberTaskDescription = (threadId: ThreadId, taskId: string, description: string) =>
-    Cache.set(taskDescriptionByTaskKey, providerTaskKey(threadId, taskId), description);
-
-  // Entries are left in place after completion so replayed or duplicate
-  // terminal events stay titled; TTL, capacity, and the session-exit sweep
-  // bound the cache.
-  const lookupTaskDescription = (threadId: ThreadId, taskId: string) =>
-    Cache.getOption(taskDescriptionByTaskKey, providerTaskKey(threadId, taskId)).pipe(
-      Effect.map((description) =>
-        Option.filter(description, (value) => value.length > 0).pipe(Option.getOrUndefined),
-      ),
-    );
-
-  const resolveThreadDetail = Effect.fn("resolveThreadDetail")(function* (threadId: ThreadId) {
-    return yield* projectionSnapshotQuery
-      .getThreadDetailById(threadId)
-      .pipe(Effect.map(Option.getOrUndefined));
-  });
-
-  const resolveThreadShell = Effect.fn("resolveThreadShell")(function* (threadId: ThreadId) {
-    return yield* projectionSnapshotQuery
-      .getThreadShellById(threadId)
-      .pipe(Effect.map(Option.getOrUndefined));
-  });
-
-  const rememberAssistantMessageId = (threadId: ThreadId, turnId: TurnId, messageId: MessageId) =>
-    Cache.getOption(turnMessageIdsByTurnKey, providerTurnKey(threadId, turnId)).pipe(
-      Effect.flatMap((existingIds) =>
-        Cache.set(
-          turnMessageIdsByTurnKey,
-          providerTurnKey(threadId, turnId),
-          Option.match(existingIds, {
-            onNone: () => new Set([messageId]),
-            onSome: (ids) => {
-              const nextIds = new Set(ids);
-              nextIds.add(messageId);
-              return nextIds;
-            },
-          }),
-        ),
-      ),
-    );
-
-  const forgetAssistantMessageId = (threadId: ThreadId, turnId: TurnId, messageId: MessageId) =>
-    Cache.getOption(turnMessageIdsByTurnKey, providerTurnKey(threadId, turnId)).pipe(
-      Effect.flatMap((existingIds) =>
-        Option.match(existingIds, {
-          onNone: () => Effect.void,
-          onSome: (ids) => {
-            const nextIds = new Set(ids);
-            nextIds.delete(messageId);
-            if (nextIds.size === 0) {
-              return Cache.invalidate(turnMessageIdsByTurnKey, providerTurnKey(threadId, turnId));
-            }
-            return Cache.set(turnMessageIdsByTurnKey, providerTurnKey(threadId, turnId), nextIds);
-          },
-        }),
-      ),
-    );
-
-  const getAssistantMessageIdsForTurn = (threadId: ThreadId, turnId: TurnId) =>
-    Cache.getOption(turnMessageIdsByTurnKey, providerTurnKey(threadId, turnId)).pipe(
-      Effect.map((existingIds) =>
-        Option.getOrElse(existingIds, (): Set<MessageId> => new Set<MessageId>()),
-      ),
-    );
-
-  const clearAssistantMessageIdsForTurn = (threadId: ThreadId, turnId: TurnId) =>
-    Cache.invalidate(turnMessageIdsByTurnKey, providerTurnKey(threadId, turnId));
-
-  const getAssistantSegmentStateForTurn = (threadId: ThreadId, turnId: TurnId) =>
-    Cache.getOption(assistantSegmentStateByTurnKey, providerTurnKey(threadId, turnId));
-
-  const setAssistantSegmentStateForTurn = (
-    threadId: ThreadId,
-    turnId: TurnId,
-    state: AssistantSegmentState,
-  ) => Cache.set(assistantSegmentStateByTurnKey, providerTurnKey(threadId, turnId), state);
-
-  const clearAssistantSegmentStateForTurn = (threadId: ThreadId, turnId: TurnId) =>
-    Cache.invalidate(assistantSegmentStateByTurnKey, providerTurnKey(threadId, turnId));
-
-  const getActiveAssistantMessageIdForTurn = (threadId: ThreadId, turnId: TurnId) =>
-    getAssistantSegmentStateForTurn(threadId, turnId).pipe(
-      Effect.map((state) =>
-        Option.flatMap(state, (entry) =>
-          entry.activeMessageId ? Option.some(entry.activeMessageId) : Option.none(),
-        ),
-      ),
-    );
-
-  const startAssistantSegmentForTurn = (input: {
-    threadId: ThreadId;
-    turnId: TurnId;
-    baseKey: string;
-  }) =>
-    getAssistantSegmentStateForTurn(input.threadId, input.turnId).pipe(
-      Effect.flatMap((existingState) =>
-        Effect.gen(function* () {
-          const nextState = Option.match(existingState, {
-            onNone: () => ({
-              baseKey: input.baseKey,
-              nextSegmentIndex: 1,
-              activeMessageId: assistantSegmentMessageId(input.baseKey, 0),
-            }),
-            onSome: (state) => {
-              const segmentIndex = state.baseKey === input.baseKey ? state.nextSegmentIndex : 0;
-              const messageId = assistantSegmentMessageId(input.baseKey, segmentIndex);
-              return {
-                baseKey: input.baseKey,
-                nextSegmentIndex: state.baseKey === input.baseKey ? state.nextSegmentIndex + 1 : 1,
-                activeMessageId: messageId,
-              } satisfies AssistantSegmentState;
-            },
-          });
-          yield* setAssistantSegmentStateForTurn(input.threadId, input.turnId, nextState);
-          return nextState.activeMessageId!;
-        }),
-      ),
-    );
-
-  const getOrCreateAssistantMessageId = (input: {
-    threadId: ThreadId;
-    event: ProviderRuntimeEvent;
-    turnId?: TurnId;
-  }) =>
-    Effect.gen(function* () {
-      if (!input.turnId) {
-        return assistantSegmentMessageId(assistantSegmentBaseKeyFromEvent(input.event), 0);
-      }
-
-      const activeMessageId = yield* getActiveAssistantMessageIdForTurn(
-        input.threadId,
-        input.turnId,
-      );
-      if (Option.isSome(activeMessageId)) {
-        return activeMessageId.value;
-      }
-
-      return yield* startAssistantSegmentForTurn({
-        threadId: input.threadId,
-        turnId: input.turnId,
-        baseKey: assistantSegmentBaseKeyFromEvent(input.event),
-      });
-    });
-
-  const appendBufferedAssistantText = (messageId: MessageId, delta: string) =>
-    Cache.getOption(bufferedAssistantTextByMessageId, messageId).pipe(
-      Effect.flatMap((existingText) =>
-        Effect.gen(function* () {
-          const nextText = Option.match(existingText, {
-            onNone: () => delta,
-            onSome: (text) => `${text}${delta}`,
-          });
-          if (nextText.length <= MAX_BUFFERED_ASSISTANT_CHARS) {
-            yield* Cache.set(bufferedAssistantTextByMessageId, messageId, nextText);
-            return "";
-          }
-
-          // Safety valve: flush full buffered text as an assistant delta to cap memory.
-          yield* Cache.invalidate(bufferedAssistantTextByMessageId, messageId);
-          return nextText;
-        }),
-      ),
-    );
-
-  const takeBufferedAssistantText = (messageId: MessageId) =>
-    Cache.getOption(bufferedAssistantTextByMessageId, messageId).pipe(
-      Effect.flatMap((existingText) =>
-        Cache.invalidate(bufferedAssistantTextByMessageId, messageId).pipe(
-          Effect.as(Option.getOrElse(existingText, () => "")),
-        ),
-      ),
-    );
-
-  const clearBufferedAssistantText = (messageId: MessageId) =>
-    Cache.invalidate(bufferedAssistantTextByMessageId, messageId);
-
-  const appendBufferedProposedPlan = (planId: string, delta: string, createdAt: string) =>
-    Cache.getOption(bufferedProposedPlanById, planId).pipe(
-      Effect.flatMap((existingEntry) => {
-        const existing = Option.getOrUndefined(existingEntry);
-        return Cache.set(bufferedProposedPlanById, planId, {
-          text: `${existing?.text ?? ""}${delta}`,
-          createdAt:
-            existing?.createdAt && existing.createdAt.length > 0 ? existing.createdAt : createdAt,
-        });
-      }),
-    );
-
-  const takeBufferedProposedPlan = (planId: string) =>
-    Cache.getOption(bufferedProposedPlanById, planId).pipe(
-      Effect.flatMap((existingEntry) =>
-        Cache.invalidate(bufferedProposedPlanById, planId).pipe(
-          Effect.as(Option.getOrUndefined(existingEntry)),
-        ),
-      ),
-    );
-
-  const clearBufferedProposedPlan = (planId: string) =>
-    Cache.invalidate(bufferedProposedPlanById, planId);
-
-  const clearAssistantMessageState = (messageId: MessageId) =>
-    clearBufferedAssistantText(messageId);
-
-  const flushBufferedAssistantMessage = (input: {
-    event: ProviderRuntimeEvent;
-    threadId: ThreadId;
-    messageId: MessageId;
-    turnId?: TurnId;
-    createdAt: string;
-    commandTag: string;
-  }) =>
-    Effect.gen(function* () {
-      const bufferedText = yield* takeBufferedAssistantText(input.messageId);
-      if (!hasRenderableAssistantText(bufferedText)) {
-        return false;
-      }
-
-      yield* orchestrationEngine.dispatch({
-        type: "thread.message.assistant.delta",
-        commandId: yield* providerCommandId(input.event, input.commandTag),
-        threadId: input.threadId,
-        messageId: input.messageId,
-        delta: bufferedText,
-        ...(input.turnId ? { turnId: input.turnId } : {}),
-        createdAt: input.createdAt,
-      });
-      return true;
-    });
-
-  const flushBufferedAssistantMessagesForTurn = (input: {
-    event: ProviderRuntimeEvent;
-    threadId: ThreadId;
-    turnId: TurnId;
-    createdAt: string;
-    commandTag: string;
-  }) =>
-    Effect.gen(function* () {
-      const assistantMessageIds = yield* getAssistantMessageIdsForTurn(
-        input.threadId,
-        input.turnId,
-      );
-      const flushedMessageIds = new Set<MessageId>();
-      yield* Effect.forEach(
-        assistantMessageIds,
-        (messageId) =>
-          flushBufferedAssistantMessage({
-            event: input.event,
-            threadId: input.threadId,
-            messageId,
-            turnId: input.turnId,
-            createdAt: input.createdAt,
-            commandTag: input.commandTag,
-          }).pipe(
-            Effect.tap((flushed) =>
-              flushed ? Effect.sync(() => flushedMessageIds.add(messageId)) : Effect.void,
-            ),
-          ),
-        { concurrency: 1 },
-      ).pipe(Effect.asVoid);
-      return flushedMessageIds;
-    });
-
-  const finalizeAssistantMessage = (input: {
-    event: ProviderRuntimeEvent;
-    threadId: ThreadId;
-    messageId: MessageId;
-    turnId?: TurnId;
-    createdAt: string;
-    commandTag: string;
-    finalDeltaCommandTag: string;
-    fallbackText?: string;
-    hasProjectedMessage?: boolean;
-  }) =>
-    Effect.gen(function* () {
-      const bufferedText = yield* takeBufferedAssistantText(input.messageId);
-      const text =
-        bufferedText.length > 0
-          ? bufferedText
-          : (input.fallbackText?.trim().length ?? 0) > 0
-            ? input.fallbackText!
-            : "";
-      const hasRenderableText = hasRenderableAssistantText(text);
-
-      if (hasRenderableText) {
-        yield* orchestrationEngine.dispatch({
-          type: "thread.message.assistant.delta",
-          commandId: yield* providerCommandId(input.event, input.finalDeltaCommandTag),
-          threadId: input.threadId,
-          messageId: input.messageId,
-          delta: text,
-          ...(input.turnId ? { turnId: input.turnId } : {}),
-          createdAt: input.createdAt,
-        });
-      }
-
-      if (input.hasProjectedMessage || hasRenderableText) {
-        yield* orchestrationEngine.dispatch({
-          type: "thread.message.assistant.complete",
-          commandId: yield* providerCommandId(input.event, input.commandTag),
-          threadId: input.threadId,
-          messageId: input.messageId,
-          ...(input.turnId ? { turnId: input.turnId } : {}),
-          createdAt: input.createdAt,
-        });
-      }
-      yield* clearAssistantMessageState(input.messageId);
-    });
-
-  const finalizeActiveAssistantSegmentForTurn = (input: {
-    event: ProviderRuntimeEvent;
-    threadId: ThreadId;
-    turnId: TurnId;
-    createdAt: string;
-    commandTag: string;
-    finalDeltaCommandTag: string;
-    hasProjectedMessage: boolean;
-    flushedMessageIds?: ReadonlySet<MessageId>;
-  }) =>
-    Effect.gen(function* () {
-      const activeMessageId = yield* getActiveAssistantMessageIdForTurn(
-        input.threadId,
-        input.turnId,
-      );
-      if (Option.isNone(activeMessageId)) {
-        return;
-      }
-
-      yield* finalizeAssistantMessage({
-        event: input.event,
-        threadId: input.threadId,
-        messageId: activeMessageId.value,
-        turnId: input.turnId,
-        createdAt: input.createdAt,
-        commandTag: input.commandTag,
-        finalDeltaCommandTag: input.finalDeltaCommandTag,
-        hasProjectedMessage:
-          input.hasProjectedMessage ||
-          (input.flushedMessageIds?.has(activeMessageId.value) ?? false),
-      });
-      yield* forgetAssistantMessageId(input.threadId, input.turnId, activeMessageId.value);
-
-      const state = yield* getAssistantSegmentStateForTurn(input.threadId, input.turnId);
-      if (Option.isSome(state)) {
-        yield* setAssistantSegmentStateForTurn(input.threadId, input.turnId, {
-          ...state.value,
-          activeMessageId: null,
-        });
-      }
-    });
-
-  const upsertProposedPlan = (input: {
-    event: ProviderRuntimeEvent;
-    threadId: ThreadId;
-    threadProposedPlans: ReadonlyArray<{
-      id: string;
-      createdAt: string;
-      implementedAt: string | null;
-      implementationThreadId: ThreadId | null;
-    }>;
-    planId: string;
-    turnId?: TurnId;
-    planMarkdown: string | undefined;
-    createdAt: string;
-    updatedAt: string;
-  }) =>
-    Effect.gen(function* () {
-      const planMarkdown = normalizeProposedPlanMarkdown(input.planMarkdown);
-      if (!planMarkdown) {
-        return;
-      }
-
-      const existingPlan = findProposedPlanById(input.threadProposedPlans, input.planId);
-      yield* orchestrationEngine.dispatch({
-        type: "thread.proposed-plan.upsert",
-        commandId: yield* providerCommandId(input.event, "proposed-plan-upsert"),
-        threadId: input.threadId,
-        proposedPlan: {
-          id: input.planId,
-          turnId: input.turnId ?? null,
-          planMarkdown,
-          implementedAt: existingPlan?.implementedAt ?? null,
-          implementationThreadId: existingPlan?.implementationThreadId ?? null,
-          createdAt: existingPlan?.createdAt ?? input.createdAt,
-          updatedAt: input.updatedAt,
-        },
-        createdAt: input.updatedAt,
-      });
-    });
-
-  const finalizeBufferedProposedPlan = (input: {
-    event: ProviderRuntimeEvent;
-    threadId: ThreadId;
-    threadProposedPlans: ReadonlyArray<{
-      id: string;
-      createdAt: string;
-      implementedAt: string | null;
-      implementationThreadId: ThreadId | null;
-    }>;
-    planId: string;
-    turnId?: TurnId;
-    fallbackMarkdown?: string;
-    updatedAt: string;
-  }) =>
-    Effect.gen(function* () {
-      const bufferedPlan = yield* takeBufferedProposedPlan(input.planId);
-      const bufferedMarkdown = normalizeProposedPlanMarkdown(bufferedPlan?.text);
-      const fallbackMarkdown = normalizeProposedPlanMarkdown(input.fallbackMarkdown);
-      const planMarkdown = bufferedMarkdown ?? fallbackMarkdown;
-      if (!planMarkdown) {
-        return;
-      }
-
-      yield* upsertProposedPlan({
-        event: input.event,
-        threadId: input.threadId,
-        threadProposedPlans: input.threadProposedPlans,
-        planId: input.planId,
-        ...(input.turnId ? { turnId: input.turnId } : {}),
-        planMarkdown,
-        createdAt:
-          bufferedPlan?.createdAt && bufferedPlan.createdAt.length > 0
-            ? bufferedPlan.createdAt
-            : input.updatedAt,
-        updatedAt: input.updatedAt,
-      });
-      yield* clearBufferedProposedPlan(input.planId);
-    });
-
-  const clearTurnStateForSession = (threadId: ThreadId) =>
-    Effect.gen(function* () {
-      const prefix = `${threadId}:`;
-      const proposedPlanPrefix = `plan:${threadId}:`;
-      const turnKeys = Array.from(yield* Cache.keys(turnMessageIdsByTurnKey));
-      const assistantSegmentKeys = Array.from(yield* Cache.keys(assistantSegmentStateByTurnKey));
-      const proposedPlanKeys = Array.from(yield* Cache.keys(bufferedProposedPlanById));
-      const taskDescriptionKeys = Array.from(yield* Cache.keys(taskDescriptionByTaskKey));
-      yield* Effect.forEach(
-        turnKeys,
-        (key) =>
-          Effect.gen(function* () {
-            if (!key.startsWith(prefix)) {
-              return;
-            }
-
-            const messageIds = yield* Cache.getOption(turnMessageIdsByTurnKey, key);
-            if (Option.isSome(messageIds)) {
-              yield* Effect.forEach(messageIds.value, clearAssistantMessageState, {
-                concurrency: 1,
-              }).pipe(Effect.asVoid);
-            }
-
-            yield* Cache.invalidate(turnMessageIdsByTurnKey, key);
-          }),
-        { concurrency: 1 },
-      ).pipe(Effect.asVoid);
-      yield* Effect.forEach(
-        assistantSegmentKeys,
-        (key) =>
-          key.startsWith(prefix)
-            ? Cache.invalidate(assistantSegmentStateByTurnKey, key)
-            : Effect.void,
-        { concurrency: 1 },
-      ).pipe(Effect.asVoid);
-      yield* Effect.forEach(
-        proposedPlanKeys,
-        (key) =>
-          key.startsWith(proposedPlanPrefix)
-            ? Cache.invalidate(bufferedProposedPlanById, key)
-            : Effect.void,
-        { concurrency: 1 },
-      ).pipe(Effect.asVoid);
-      yield* Effect.forEach(
-        taskDescriptionKeys,
-        (key) =>
-          key.startsWith(prefix) ? Cache.invalidate(taskDescriptionByTaskKey, key) : Effect.void,
-        { concurrency: 1 },
-      ).pipe(Effect.asVoid);
-    });
-
-  const getSourceProposedPlanReferenceForPendingTurnStart = Effect.fn(
-    "getSourceProposedPlanReferenceForPendingTurnStart",
-  )(function* (threadId: ThreadId) {
-    const pendingTurnStart = yield* projectionTurnRepository.getPendingTurnStartByThreadId({
-      threadId,
-    });
-    if (Option.isNone(pendingTurnStart)) {
-      return null;
-    }
-
-    const sourceThreadId = pendingTurnStart.value.sourceProposedPlanThreadId;
-    const sourcePlanId = pendingTurnStart.value.sourceProposedPlanId;
-    if (sourceThreadId === null || sourcePlanId === null) {
-      return null;
-    }
-
-    return {
-      sourceThreadId,
-      sourcePlanId,
-    } as const;
-  });
-
-  const getExpectedProviderTurnIdForThread = Effect.fn("getExpectedProviderTurnIdForThread")(
-    function* (threadId: ThreadId) {
-      const sessions = yield* providerService.listSessions();
-      const session = sessions.find((entry) => entry.threadId === threadId);
-      return session?.activeTurnId;
-    },
-  );
-
-  const getSourceProposedPlanReferenceForAcceptedTurnStart = Effect.fn(
-    "getSourceProposedPlanReferenceForAcceptedTurnStart",
-  )(function* (threadId: ThreadId, eventTurnId: TurnId | undefined) {
-    if (eventTurnId === undefined) {
-      return null;
-    }
-
-    const expectedTurnId = yield* getExpectedProviderTurnIdForThread(threadId);
-    if (!sameId(expectedTurnId, eventTurnId)) {
-      return null;
-    }
-
-    return yield* getSourceProposedPlanReferenceForPendingTurnStart(threadId);
-  });
-
-  const markSourceProposedPlanImplemented = Effect.fn("markSourceProposedPlanImplemented")(
-    function* (
-      sourceThreadId: ThreadId,
-      sourcePlanId: OrchestrationProposedPlanId,
-      implementationThreadId: ThreadId,
-      implementedAt: string,
-    ) {
-      const sourceThread = yield* resolveThreadDetail(sourceThreadId);
-      const sourcePlan = sourceThread?.proposedPlans.find((entry) => entry.id === sourcePlanId);
-      if (!sourceThread || !sourcePlan || sourcePlan.implementedAt !== null) {
-        return;
-      }
-
-      const commandUuid = yield* crypto.randomUUIDv4;
-      yield* orchestrationEngine.dispatch({
-        type: "thread.proposed-plan.upsert",
-        commandId: CommandId.make(
-          `provider:source-proposed-plan-implemented:${implementationThreadId}:${commandUuid}`,
-        ),
-        threadId: sourceThread.id,
-        proposedPlan: {
-          ...sourcePlan,
-          implementedAt,
-          implementationThreadId,
-          updatedAt: implementedAt,
-        },
-        createdAt: implementedAt,
-      });
-    },
-  );
-
-  const processRuntimeEvent = (event: ProviderRuntimeEvent) =>
-    Effect.gen(function* () {
-      const thread = yield* resolveThreadShell(event.threadId);
-      if (!thread) return;
-
-      let loadedThreadDetail: OrchestrationThread | null | undefined;
-      const getLoadedThreadDetail = () =>
-        Effect.gen(function* () {
-          if (loadedThreadDetail !== undefined) {
-            return loadedThreadDetail;
-          }
-          loadedThreadDetail = (yield* resolveThreadDetail(thread.id)) ?? null;
-          return loadedThreadDetail;
-        });
-
-      const now = event.createdAt;
-      const eventTurnId = toTurnId(event.turnId);
-      const activeTurnId = thread.session?.activeTurnId ?? null;
-      const pendingTurnStart = yield* projectionTurnRepository.getPendingTurnStartByThreadId({
-        threadId: thread.id,
-      });
-      const hasPendingTurnStart =
-        Option.isSome(pendingTurnStart) && thread.session?.status === "starting";
-
-      const conflictsWithActiveTurn =
-        activeTurnId !== null && eventTurnId !== undefined && !sameId(activeTurnId, eventTurnId);
-      const missingTurnForActiveTurn = activeTurnId !== null && eventTurnId === undefined;
-
-      // A turn.started that conflicts with the active turn is legitimate when
-      // the server itself has a turn start pending for this thread AND the
-      // provider session already tracks the event's turn as its active turn:
-      // steering a running turn makes some providers (e.g. opencode) open a
-      // new turn without ever completing the superseded one. A stale
-      // turn.started for some other turn id still gets rejected.
-      const conflictingTurnStartIsPendingTurnStart =
-        event.type === "turn.started" && conflictsWithActiveTurn
-          ? sameId(yield* getExpectedProviderTurnIdForThread(thread.id), eventTurnId) &&
-            Option.isSome(pendingTurnStart)
-          : false;
-
-      const shouldApplyThreadLifecycle = (() => {
-        if (!STRICT_PROVIDER_LIFECYCLE_GUARD) {
-          return true;
-        }
-        switch (event.type) {
-          case "session.exited":
-            return true;
-          case "session.started":
-          case "thread.started":
-            return true;
-          case "turn.started":
-            return !conflictsWithActiveTurn || conflictingTurnStartIsPendingTurnStart;
-          case "turn.completed":
-            if (conflictsWithActiveTurn || missingTurnForActiveTurn) {
-              return false;
-            }
-            // Only the active turn may close the lifecycle state.
-            if (activeTurnId !== null && eventTurnId !== undefined) {
-              return sameId(activeTurnId, eventTurnId);
-            }
-            // No active turn tracked: accept only completions that name their
-            // turn (covers a real completion whose turn.started was lost). An
-            // untargeted completion cannot prove it belongs to any turn this
-            // thread ran — the known emitter was the Claude resume handshake
-            // (system/init + result(num_turns: 0)), which is not a turn at
-            // all — and applying it here stomps the "starting" lifecycle
-            // state while a turn start is pending.
-            return eventTurnId !== undefined;
-          default:
-            return true;
-        }
-      })();
-      const acceptedTurnStartedSourcePlan =
-        event.type === "turn.started" && shouldApplyThreadLifecycle
-          ? yield* getSourceProposedPlanReferenceForAcceptedTurnStart(thread.id, eventTurnId)
-          : null;
-
-      if (
-        event.type === "session.started" ||
-        event.type === "session.state.changed" ||
-        event.type === "session.exited" ||
-        event.type === "thread.started" ||
-        event.type === "turn.started" ||
-        event.type === "turn.completed"
-      ) {
-        const status = (() => {
-          switch (event.type) {
-            case "session.state.changed": {
-              const runtimeStatus = orchestrationSessionStatusFromRuntimeState(event.payload.state);
-              return hasPendingTurnStart && runtimeStatus === "ready" ? "starting" : runtimeStatus;
-            }
-            case "turn.started":
-              return "running";
-            case "session.exited":
-              return "stopped";
-            case "turn.completed":
-              return normalizeRuntimeTurnState(event.payload.state) === "failed"
-                ? "error"
-                : "ready";
-            case "session.started":
-            case "thread.started":
-              // Provider thread/session start notifications can arrive during an
-              // active or pending turn; preserve that lifecycle state.
-              return activeTurnId !== null ? "running" : hasPendingTurnStart ? "starting" : "ready";
-          }
-        })();
-        const nextActiveTurnId =
-          event.type === "turn.started"
-            ? (eventTurnId ?? null)
-            : event.type === "turn.completed" || event.type === "session.exited"
-              ? null
-              : event.type === "session.state.changed" &&
-                  !sessionStatusAllowsActiveTurn(
-                    orchestrationSessionStatusFromRuntimeState(event.payload.state),
-                  )
-                ? null
-                : activeTurnId;
-        const lastError =
-          event.type === "session.state.changed" && event.payload.state === "error"
-            ? (event.payload.reason ?? thread.session?.lastError ?? "Provider session error")
-            : event.type === "turn.completed" &&
-                normalizeRuntimeTurnState(event.payload.state) === "failed"
-              ? (event.payload.errorMessage ?? thread.session?.lastError ?? "Turn failed")
-              : status === "ready"
-                ? null
-                : (thread.session?.lastError ?? null);
-
-        if (shouldApplyThreadLifecycle) {
-          if (event.type === "turn.started" && acceptedTurnStartedSourcePlan !== null) {
-            yield* markSourceProposedPlanImplemented(
-              acceptedTurnStartedSourcePlan.sourceThreadId,
-              acceptedTurnStartedSourcePlan.sourcePlanId,
-              thread.id,
-              now,
-            ).pipe(
-              Effect.catchCause((cause) =>
-                Effect.logWarning(
-                  "provider runtime ingestion failed to mark source proposed plan",
-                  {
-                    eventId: event.eventId,
-                    eventType: event.type,
-                    cause: Cause.pretty(cause),
-                  },
-                ),
-              ),
-            );
-          }
-
-          yield* orchestrationEngine.dispatch({
-            type: "thread.session.set",
-            commandId: yield* providerCommandId(event, "thread-session-set"),
-            threadId: thread.id,
-            session: {
-              threadId: thread.id,
-              status,
-              providerName: event.provider,
-              ...(event.providerInstanceId !== undefined
-                ? { providerInstanceId: event.providerInstanceId }
-                : {}),
-              runtimeMode: thread.session?.runtimeMode ?? "full-access",
-              activeTurnId: nextActiveTurnId,
-              lastError,
-              updatedAt: now,
-            },
-            createdAt: now,
-          });
-        }
-      }
-
-      const assistantDelta =
-        event.type === "content.delta" && event.payload.streamKind === "assistant_text"
-          ? event.payload.delta
-          : undefined;
-      const proposedPlanDelta =
-        event.type === "turn.proposed.delta" ? event.payload.delta : undefined;
-
-      if (assistantDelta && assistantDelta.length > 0) {
-        const turnId = toTurnId(event.turnId);
-        const assistantMessageId = yield* getOrCreateAssistantMessageId({
-          threadId: thread.id,
-          event,
-          ...(turnId ? { turnId } : {}),
-        });
-        if (turnId) {
-          yield* rememberAssistantMessageId(thread.id, turnId, assistantMessageId);
-        }
-
-        const assistantDeliveryMode: AssistantDeliveryMode = yield* Effect.map(
-          serverSettingsService.getSettings,
-          (settings) => (settings.enableLegacyTokenStreaming ? "streaming" : "buffered"),
-        );
-        if (assistantDeliveryMode === "buffered") {
-          const spillChunk = yield* appendBufferedAssistantText(assistantMessageId, assistantDelta);
-          if (spillChunk.length > 0) {
-            yield* orchestrationEngine.dispatch({
-              type: "thread.message.assistant.delta",
-              commandId: yield* providerCommandId(event, "assistant-delta-buffer-spill"),
-              threadId: thread.id,
-              messageId: assistantMessageId,
-              delta: spillChunk,
-              ...(turnId ? { turnId } : {}),
-              createdAt: now,
-            });
-          }
-        } else {
-          yield* orchestrationEngine.dispatch({
-            type: "thread.message.assistant.delta",
-            commandId: yield* providerCommandId(event, "assistant-delta"),
-            threadId: thread.id,
-            messageId: assistantMessageId,
-            delta: assistantDelta,
-            ...(turnId ? { turnId } : {}),
-            createdAt: now,
-          });
-        }
-      }
-
-      const pauseForUserTurnId =
-        event.type === "request.opened" || event.type === "user-input.requested"
-          ? toTurnId(event.turnId)
-          : undefined;
-      if (pauseForUserTurnId) {
-        const detailedThread = yield* getLoadedThreadDetail();
-        const assistantDeliveryMode: AssistantDeliveryMode = yield* Effect.map(
-          serverSettingsService.getSettings,
-          (settings) => (settings.enableLegacyTokenStreaming ? "streaming" : "buffered"),
-        );
-        const flushedMessageIds =
-          assistantDeliveryMode === "buffered"
-            ? yield* flushBufferedAssistantMessagesForTurn({
-                event,
-                threadId: thread.id,
-                turnId: pauseForUserTurnId,
-                createdAt: now,
-                commandTag:
-                  event.type === "request.opened"
-                    ? "assistant-delta-flush-on-request-opened"
-                    : "assistant-delta-flush-on-user-input-requested",
-              })
-            : new Set<MessageId>();
-        yield* finalizeActiveAssistantSegmentForTurn({
-          event,
-          threadId: thread.id,
-          turnId: pauseForUserTurnId,
-          createdAt: now,
-          commandTag:
-            event.type === "request.opened"
-              ? "assistant-complete-on-request-opened"
-              : "assistant-complete-on-user-input-requested",
-          finalDeltaCommandTag:
-            event.type === "request.opened"
-              ? "assistant-delta-finalize-on-request-opened"
-              : "assistant-delta-finalize-on-user-input-requested",
-          hasProjectedMessage:
-            detailedThread !== null &&
-            hasAssistantMessageForTurn(detailedThread.messages, pauseForUserTurnId, {
-              streamingOnly: true,
-            }),
-          flushedMessageIds,
-        });
-      }
-
-      if (proposedPlanDelta && proposedPlanDelta.length > 0) {
-        const planId = proposedPlanIdFromEvent(event, thread.id);
-        yield* appendBufferedProposedPlan(planId, proposedPlanDelta, now);
-      }
-
-      const assistantCompletion =
-        event.type === "item.completed" && event.payload.itemType === "assistant_message"
-          ? {
-              messageId: MessageId.make(
-                `assistant:${event.itemId ?? event.turnId ?? event.eventId}`,
-              ),
-              fallbackText: event.payload.detail,
-            }
-          : undefined;
-      const proposedPlanCompletion =
-        event.type === "turn.proposed.completed"
-          ? {
-              planId: proposedPlanIdFromEvent(event, thread.id),
-              turnId: toTurnId(event.turnId),
-              planMarkdown: event.payload.planMarkdown,
-            }
-          : undefined;
-
-      if (assistantCompletion) {
-        const detailedThread = yield* getLoadedThreadDetail();
-        const messages = detailedThread?.messages ?? [];
-        const turnId = toTurnId(event.turnId);
-        const activeAssistantMessageId = turnId
-          ? yield* getActiveAssistantMessageIdForTurn(thread.id, turnId)
-          : Option.none<MessageId>();
-        const hasAssistantMessagesForTurn =
-          turnId !== undefined ? hasAssistantMessageForTurn(messages, turnId) : false;
-        const assistantMessageId = Option.getOrElse(
-          activeAssistantMessageId,
-          () => assistantCompletion.messageId,
-        );
-        const existingAssistantMessage = findMessageById(messages, assistantMessageId);
-        const shouldApplyFallbackCompletionText =
-          !existingAssistantMessage || existingAssistantMessage.text.length === 0;
-
-        const shouldSkipRedundantCompletion =
-          Option.isNone(activeAssistantMessageId) &&
-          turnId !== undefined &&
-          hasAssistantMessagesForTurn &&
-          (assistantCompletion.fallbackText?.trim().length ?? 0) === 0;
-
-        if (!shouldSkipRedundantCompletion) {
-          if (turnId && Option.isNone(activeAssistantMessageId)) {
-            yield* rememberAssistantMessageId(thread.id, turnId, assistantMessageId);
-          }
-
-          yield* finalizeAssistantMessage({
-            event,
-            threadId: thread.id,
-            messageId: assistantMessageId,
-            ...(turnId ? { turnId } : {}),
-            createdAt: now,
-            commandTag: "assistant-complete",
-            finalDeltaCommandTag: "assistant-delta-finalize",
-            hasProjectedMessage: existingAssistantMessage !== undefined,
-            ...(assistantCompletion.fallbackText !== undefined && shouldApplyFallbackCompletionText
-              ? { fallbackText: assistantCompletion.fallbackText }
-              : {}),
-          });
-
-          if (turnId) {
-            yield* forgetAssistantMessageId(thread.id, turnId, assistantMessageId);
-          }
-        }
-
-        if (turnId) {
-          yield* clearAssistantSegmentStateForTurn(thread.id, turnId);
-        }
-      }
-
-      if (proposedPlanCompletion) {
-        const detailedThread = yield* getLoadedThreadDetail();
-        yield* finalizeBufferedProposedPlan({
-          event,
-          threadId: thread.id,
-          threadProposedPlans: detailedThread?.proposedPlans ?? [],
-          planId: proposedPlanCompletion.planId,
-          ...(proposedPlanCompletion.turnId ? { turnId: proposedPlanCompletion.turnId } : {}),
-          fallbackMarkdown: proposedPlanCompletion.planMarkdown,
-          updatedAt: now,
-        });
-      }
-
-      if (event.type === "turn.completed") {
-        const detailedThread = yield* getLoadedThreadDetail();
-        const messages = detailedThread?.messages ?? [];
-        const proposedPlans = detailedThread?.proposedPlans ?? [];
-        const turnId = toTurnId(event.turnId);
-        if (turnId) {
-          const assistantMessageIds = yield* getAssistantMessageIdsForTurn(thread.id, turnId);
-          yield* Effect.forEach(
-            assistantMessageIds,
-            (assistantMessageId) =>
-              finalizeAssistantMessage({
-                event,
-                threadId: thread.id,
-                messageId: assistantMessageId,
-                turnId,
-                createdAt: now,
-                commandTag: "assistant-complete-finalize",
-                finalDeltaCommandTag: "assistant-delta-finalize-fallback",
-                hasProjectedMessage: findMessageById(messages, assistantMessageId) !== undefined,
-              }),
-            { concurrency: 1 },
-          ).pipe(Effect.asVoid);
-          yield* clearAssistantMessageIdsForTurn(thread.id, turnId);
-          yield* clearAssistantSegmentStateForTurn(thread.id, turnId);
-
-          yield* finalizeBufferedProposedPlan({
-            event,
-            threadId: thread.id,
-            threadProposedPlans: proposedPlans,
-            planId: proposedPlanIdForTurn(thread.id, turnId),
-            turnId,
-            updatedAt: now,
-          });
-        }
-      }
-
-      if (event.type === "session.exited") {
-        yield* clearTurnStateForSession(thread.id);
-      }
-
-      if (event.type === "runtime.error") {
-        const runtimeErrorMessage = event.payload.message;
-
-        const shouldApplyRuntimeError = !STRICT_PROVIDER_LIFECYCLE_GUARD
-          ? true
-          : activeTurnId === null || eventTurnId === undefined || sameId(activeTurnId, eventTurnId);
-
-        if (shouldApplyRuntimeError) {
-          yield* orchestrationEngine.dispatch({
-            type: "thread.session.set",
-            commandId: yield* providerCommandId(event, "runtime-error-session-set"),
-            threadId: thread.id,
-            session: {
-              threadId: thread.id,
-              status: "error",
-              providerName: event.provider,
-              ...(event.providerInstanceId !== undefined
-                ? { providerInstanceId: event.providerInstanceId }
-                : {}),
-              runtimeMode: thread.session?.runtimeMode ?? "full-access",
-              activeTurnId: eventTurnId ?? null,
-              lastError: runtimeErrorMessage,
-              updatedAt: now,
-            },
-            createdAt: now,
-          });
-        }
-      }
-
-      if (event.type === "thread.metadata.updated" && event.payload.name) {
-        if (canReplaceThreadTitle(thread.title)) {
-          yield* orchestrationEngine.dispatch({
-            type: "thread.meta.update",
-            commandId: yield* providerCommandId(event, "thread-meta-update"),
-            threadId: thread.id,
-            title: event.payload.name,
-          });
-        }
-      }
-
-      if (event.type === "turn.diff.updated") {
-        const turnId = toTurnId(event.turnId);
-        const checkpointContext = turnId
-          ? yield* projectionSnapshotQuery
-              .getThreadCheckpointContext(thread.id)
-              .pipe(Effect.map(Option.getOrUndefined))
-          : undefined;
-        const workspaceCwd =
-          checkpointContext?.worktreePath ?? checkpointContext?.workspaceRoot ?? undefined;
-        if (turnId && checkpointContext && workspaceCwd && isGitRepository(workspaceCwd)) {
-          // Skip if a checkpoint already exists for this turn. A real
-          // (non-placeholder) capture from CheckpointReactor should not
-          // be clobbered, and dispatching a duplicate placeholder for the
-          // same turnId would produce an unstable checkpointTurnCount.
-          if (hasCheckpointForTurn(checkpointContext.checkpoints, turnId)) {
-            // Already tracked; no-op.
-          } else {
-            const assistantMessageId = MessageId.make(
-              `assistant:${event.itemId ?? event.turnId ?? event.eventId}`,
-            );
-            yield* orchestrationEngine.dispatch({
-              type: "thread.turn.diff.complete",
-              commandId: yield* providerCommandId(event, "thread-turn-diff-complete"),
-              threadId: thread.id,
-              turnId,
-              completedAt: now,
-              checkpointRef: CheckpointRef.make(`provider-diff:${event.eventId}`),
-              status: "missing",
-              files: [],
-              assistantMessageId,
-              checkpointTurnCount: maxCheckpointTurnCount(checkpointContext.checkpoints) + 1,
-              createdAt: now,
-            });
-          }
-        }
-      }
-
-      if (event.type === "task.started" || event.type === "task.progress") {
-        const description = event.payload.description?.trim();
-        if (description) {
-          yield* rememberTaskDescription(thread.id, event.payload.taskId, description);
-        }
-      }
-      // Working-indicator plan progress: current step while the turn runs,
-      // cleared on settle so a finished plan never lingers as stale UI.
-      // Events carrying a turn id that conflicts with the active turn are
-      // stale (superseded turn) and must neither overwrite nor clear the
-      // active turn's progress; session.exited always clears.
-      if (event.type === "session.exited") {
-        threadPlanProgress.clearThreadPlanProgress(thread.id);
-      } else if (!conflictsWithActiveTurn) {
-        if (event.type === "turn.plan.updated") {
-          threadPlanProgress.recordPlanProgress(thread.id, event.payload.plan);
-        } else if (event.type === "turn.completed" || event.type === "turn.aborted") {
-          threadPlanProgress.clearThreadPlanProgress(thread.id);
-        }
-      }
-
-      // Sidebar background liveness: fed from the same lifecycle stream,
-      // read by the shell query at mapping time (no persistence).
-      switch (event.type) {
-        case "task.started":
-        case "task.progress":
-        case "task.updated":
-        case "task.completed": {
-          const payload = event.payload as {
-            taskId: string;
-            taskType?: string;
-            status?: string;
-            agentId?: string;
-          };
-          threadBackgroundLiveness.recordTaskLiveness({
-            threadId: thread.id,
-            taskId: payload.taskId,
-            taskType: payload.taskType,
-            status: payload.status,
-            agentId: payload.agentId,
-            kind:
-              event.type === "task.started"
-                ? "started"
-                : event.type === "task.progress"
-                  ? "progress"
-                  : event.type === "task.updated"
-                    ? "updated"
-                    : "completed",
-          });
-          break;
-        }
-        case "session.exited":
-          threadBackgroundLiveness.clearThreadLiveness(thread.id);
-          break;
-        default:
-          break;
-      }
-
-      let taskTitle: string | undefined;
-      if (event.type === "task.completed") {
-        taskTitle = yield* lookupTaskDescription(thread.id, event.payload.taskId);
-        if (!taskTitle) {
-          const threadDetail = yield* getLoadedThreadDetail();
-          taskTitle = findTaskTitleInActivities(threadDetail?.activities, event.payload.taskId);
-        }
-      }
-
-      const activities = runtimeEventToActivities(event, taskTitle);
-      yield* Effect.forEach(activities, (activity) =>
-        providerCommandId(event, "thread-activity-append").pipe(
-          Effect.flatMap((commandId) =>
-            orchestrationEngine.dispatch({
-              type: "thread.activity.append",
-              commandId,
-              threadId: thread.id,
-              activity,
-              createdAt: activity.createdAt,
-            }),
-          ),
-        ),
-      ).pipe(Effect.asVoid);
-    });
-
-  const processDomainEvent = (_event: TurnStartRequestedDomainEvent) => Effect.void;
-
-  const processInput = (input: RuntimeIngestionInput) =>
-    input.source === "runtime" ? processRuntimeEvent(input.event) : processDomainEvent(input.event);
-
-  const processInputSafely = (input: RuntimeIngestionInput) =>
-    processInput(input).pipe(
-      Effect.catchCause((cause) => {
-        if (Cause.hasInterruptsOnly(cause)) {
-          return Effect.failCause(cause);
-        }
-        return Effect.logWarning("provider runtime ingestion failed to process event", {
-          source: input.source,
-          eventId: input.event.eventId,
-          eventType: input.event.type,
-          cause: Cause.pretty(cause),
-        });
-      }),
-    );
-
-  const worker = yield* makeDrainableWorker(processInputSafely);
-
-  const start: ProviderRuntimeIngestionShape["start"] = () =>
-    Effect.gen(function* () {
-      yield* forkParked(
-        Stream.runForEach(providerService.streamEvents, (event) =>
-          worker.enqueue({ source: "runtime", event }),
-        ),
-      );
-      yield* forkParked(
-        Stream.runForEach(orchestrationEngine.streamDomainEvents, (event) => {
-          if (event.type !== "thread.turn-start-requested") {
-            return Effect.void;
-          }
-          return worker.enqueue({ source: "domain", event });
-        }),
-      );
-    });
-
-  return {
-    start,
-    drain: worker.drain,
-  } satisfies ProviderRuntimeIngestionShape;
-});
-
-export const ProviderRuntimeIngestionLive = Layer.effect(
-  ProviderRuntimeIngestionService,
-  make,
-).pipe(Layer.provide(ProjectionTurnRepositoryLive));
diff --git a/apps/server/src/orchestration/Layers/RuntimeReceiptBus.ts b/apps/server/src/orchestration/Layers/RuntimeReceiptBus.ts
deleted file mode 100644
index 586281dc9c6b..000000000000
--- a/apps/server/src/orchestration/Layers/RuntimeReceiptBus.ts
+++ /dev/null
@@ -1,39 +0,0 @@
-/**
- * RuntimeReceiptBus layers.
- *
- * `RuntimeReceiptBusLive` is the production default and intentionally does not
- * retain or broadcast receipts. `RuntimeReceiptBusTest` installs the in-memory
- * PubSub-backed implementation used by integration tests that need to await
- * checkpoint-reactor milestones precisely.
- *
- * @module RuntimeReceiptBus
- */
-import * as Effect from "effect/Effect";
-import * as Layer from "effect/Layer";
-import * as PubSub from "effect/PubSub";
-import * as Stream from "effect/Stream";
-
-import {
-  RuntimeReceiptBus,
-  type RuntimeReceiptBusShape,
-  type OrchestrationRuntimeReceipt,
-} from "../Services/RuntimeReceiptBus.ts";
-
-const makeRuntimeReceiptBus = Effect.succeed({
-  publish: () => Effect.void,
-  streamEventsForTest: Stream.empty,
-} satisfies RuntimeReceiptBusShape);
-
-const makeRuntimeReceiptBusTest = Effect.gen(function* () {
-  const pubSub = yield* PubSub.unbounded<OrchestrationRuntimeReceipt>();
-
-  return {
-    publish: (receipt) => PubSub.publish(pubSub, receipt).pipe(Effect.asVoid),
-    get streamEventsForTest() {
-      return Stream.fromPubSub(pubSub);
-    },
-  } satisfies RuntimeReceiptBusShape;
-});
-
-export const RuntimeReceiptBusLive = Layer.effect(RuntimeReceiptBus, makeRuntimeReceiptBus);
-export const RuntimeReceiptBusTest = Layer.effect(RuntimeReceiptBus, makeRuntimeReceiptBusTest);
diff --git a/apps/server/src/orchestration/Layers/ThreadDeletionReactor.test.ts b/apps/server/src/orchestration/Layers/ThreadDeletionReactor.test.ts
deleted file mode 100644
index f83f1dd1b9fa..000000000000
--- a/apps/server/src/orchestration/Layers/ThreadDeletionReactor.test.ts
+++ /dev/null
@@ -1,139 +0,0 @@
-import {
-  CommandId,
-  CorrelationId,
-  EventId,
-  type OrchestrationEvent,
-  ThreadId,
-} from "@t3tools/contracts";
-import { it as effectIt } from "@effect/vitest";
-import * as Cause from "effect/Cause";
-import * as Deferred from "effect/Deferred";
-import * as Effect from "effect/Effect";
-import * as Exit from "effect/Exit";
-import * as Fiber from "effect/Fiber";
-import * as Layer from "effect/Layer";
-import * as Ref from "effect/Ref";
-import * as Stream from "effect/Stream";
-import { describe, expect, it } from "vite-plus/test";
-
-import {
-  ProviderService,
-  type ProviderServiceShape,
-} from "../../provider/Services/ProviderService.ts";
-import * as TerminalManager from "../../terminal/Manager.ts";
-import {
-  OrchestrationEngineService,
-  type OrchestrationEngineShape,
-} from "../Services/OrchestrationEngine.ts";
-import { ThreadDeletionReactor } from "../Services/ThreadDeletionReactor.ts";
-import {
-  logCleanupCauseUnlessInterrupted,
-  ThreadDeletionReactorLive,
-} from "./ThreadDeletionReactor.ts";
-
-describe("logCleanupCauseUnlessInterrupted", () => {
-  const threadId = ThreadId.make("thread-deletion-reactor-test");
-
-  it("swallows ordinary cleanup failures", async () => {
-    const exit = await Effect.runPromiseExit(
-      logCleanupCauseUnlessInterrupted({
-        effect: Effect.fail("cleanup failed"),
-        message: "thread deletion cleanup skipped provider session stop",
-        threadId,
-      }),
-    );
-
-    expect(Exit.isSuccess(exit)).toBe(true);
-  });
-
-  it("preserves interrupt causes", async () => {
-    const exit = await Effect.runPromiseExit(
-      logCleanupCauseUnlessInterrupted({
-        effect: Effect.interrupt,
-        message: "thread deletion cleanup skipped provider session stop",
-        threadId,
-      }),
-    );
-
-    expect(Exit.isFailure(exit)).toBe(true);
-    if (Exit.isFailure(exit)) {
-      expect(Cause.hasInterruptsOnly(exit.cause)).toBe(true);
-    }
-  });
-});
-
-describe("ThreadDeletionReactor drain", () => {
-  const now = "2026-01-01T00:00:00.000Z";
-  const threadId = ThreadId.make("thread-deletion-reactor-drain");
-  const deletedEvent = (sequence: number): OrchestrationEvent => ({
-    sequence,
-    eventId: EventId.make(`evt-deleted-${sequence}`),
-    aggregateKind: "thread",
-    aggregateId: threadId,
-    type: "thread.deleted",
-    occurredAt: now,
-    commandId: CommandId.make(`cmd-deleted-${sequence}`),
-    causationEventId: null,
-    correlationId: CorrelationId.make(`cmd-deleted-${sequence}`),
-    metadata: {},
-    payload: { threadId, deletedAt: now },
-  });
-
-  effectIt.effect("waits for a published deletion the subscriber has not consumed yet", () =>
-    Effect.gen(function* () {
-      const stops: Array<number> = [];
-      const firstCleanupDone = yield* Deferred.make<void>();
-      // The engine has already committed and published sequence 2, but the
-      // subscriber has not received it yet: the stream releases it on demand.
-      const releaseSecondEvent = yield* Deferred.make<void>();
-      const latestSequence = yield* Ref.make(0);
-      const engine = {
-        latestSequence: Ref.get(latestSequence),
-        streamDomainEvents: Stream.concat(
-          Stream.make(deletedEvent(1)),
-          Stream.fromEffect(Deferred.await(releaseSecondEvent)).pipe(
-            Stream.map(() => deletedEvent(2)),
-          ),
-        ),
-      } as unknown as OrchestrationEngineShape;
-      const providerService = {
-        stopSession: () =>
-          Effect.gen(function* () {
-            stops.push(stops.length + 1);
-            if (stops.length === 1) {
-              yield* Deferred.succeed(firstCleanupDone, undefined);
-            }
-          }),
-      } as unknown as ProviderServiceShape;
-      const terminalManager = {
-        close: () => Effect.void,
-      } as unknown as TerminalManager.TerminalManager["Service"];
-      const layer = ThreadDeletionReactorLive.pipe(
-        Layer.provide(Layer.succeed(ProviderService, providerService)),
-        Layer.provide(Layer.succeed(TerminalManager.TerminalManager, terminalManager)),
-        Layer.provide(Layer.succeed(OrchestrationEngineService, engine)),
-      );
-
-      yield* Effect.scoped(
-        Effect.gen(function* () {
-          const reactor = yield* ThreadDeletionReactor;
-          yield* reactor.start();
-          yield* Deferred.await(firstCleanupDone);
-
-          // Sequence 1 is fully cleaned and the worker queue is idle. Sequence
-          // 2 is committed and published but still in flight to the subscriber.
-          yield* Ref.set(latestSequence, 2);
-          const drained = yield* Effect.forkChild(reactor.drainThrough(2));
-          yield* Effect.yieldNow;
-          yield* Effect.yieldNow;
-          expect(stops).toEqual([1]);
-          expect(drained.pollUnsafe()).toBeUndefined();
-
-          yield* Deferred.succeed(releaseSecondEvent, undefined);
-          yield* Fiber.join(drained);
-          expect(stops).toEqual([1, 2]);
-        }),
-      ).pipe(Effect.provide(layer));
-    }),
-  );
-});
diff --git a/apps/server/src/orchestration/Layers/ThreadDeletionReactor.ts b/apps/server/src/orchestration/Layers/ThreadDeletionReactor.ts
deleted file mode 100644
index 14a92a5eaef5..000000000000
--- a/apps/server/src/orchestration/Layers/ThreadDeletionReactor.ts
+++ /dev/null
@@ -1,124 +0,0 @@
-import type { OrchestrationEvent } from "@t3tools/contracts";
-import { makeDrainableWorker } from "@t3tools/shared/DrainableWorker";
-import * as Cause from "effect/Cause";
-import * as Effect from "effect/Effect";
-import * as Layer from "effect/Layer";
-import * as Stream from "effect/Stream";
-import * as SubscriptionRef from "effect/SubscriptionRef";
-
-import { ProviderService } from "../../provider/Services/ProviderService.ts";
-import * as TerminalManager from "../../terminal/Manager.ts";
-import { OrchestrationEngineService } from "../Services/OrchestrationEngine.ts";
-import {
-  ThreadDeletionReactor,
-  type ThreadDeletionReactorShape,
-} from "../Services/ThreadDeletionReactor.ts";
-import { forkParked } from "../../serverActivation.ts";
-
-type ThreadDeletedEvent = Extract<OrchestrationEvent, { type: "thread.deleted" }>;
-
-export const logCleanupCauseUnlessInterrupted = <R, E>({
-  effect,
-  message,
-  threadId,
-}: {
-  readonly effect: Effect.Effect<void, E, R>;
-  readonly message: string;
-  readonly threadId: ThreadDeletedEvent["payload"]["threadId"];
-}): Effect.Effect<void, E, R> =>
-  effect.pipe(
-    Effect.catchCause((cause) => {
-      if (Cause.hasInterruptsOnly(cause)) {
-        return Effect.failCause(cause);
-      }
-      return Effect.logDebug(message, {
-        threadId,
-        cause: Cause.pretty(cause),
-      });
-    }),
-  );
-
-const make = Effect.gen(function* () {
-  const orchestrationEngine = yield* OrchestrationEngineService;
-  const providerService = yield* ProviderService;
-  const terminalManager = yield* TerminalManager.TerminalManager;
-
-  const stopProviderSession = (threadId: ThreadDeletedEvent["payload"]["threadId"]) =>
-    logCleanupCauseUnlessInterrupted({
-      effect: providerService.stopSession({ threadId }),
-      message: "thread deletion cleanup skipped provider session stop",
-      threadId,
-    });
-
-  const closeThreadTerminals = (threadId: ThreadDeletedEvent["payload"]["threadId"]) =>
-    logCleanupCauseUnlessInterrupted({
-      effect: terminalManager.close({ threadId, deleteHistory: true }),
-      message: "thread deletion cleanup skipped terminal close",
-      threadId,
-    });
-
-  const processThreadDeleted = Effect.fn("processThreadDeleted")(function* (
-    event: ThreadDeletedEvent,
-  ) {
-    const { threadId } = event.payload;
-    yield* stopProviderSession(threadId);
-    yield* closeThreadTerminals(threadId);
-  });
-
-  const processThreadDeletedSafely = (event: ThreadDeletedEvent) =>
-    processThreadDeleted(event).pipe(
-      Effect.catchCause((cause) => {
-        if (Cause.hasInterruptsOnly(cause)) {
-          return Effect.failCause(cause);
-        }
-        return Effect.logWarning("thread deletion reactor failed to process event", {
-          eventType: event.type,
-          threadId: event.payload.threadId,
-          cause: Cause.pretty(cause),
-        });
-      }),
-    );
-
-  const worker = yield* makeDrainableWorker(processThreadDeletedSafely);
-
-  // Highest event sequence the subscriber has handed to the worker. Waiting
-  // through a successful thread.created sequence covers every deletion that
-  // was ahead of that create in the engine queue; the worker drain then covers
-  // the in-flight cleanup.
-  const seenSequence = yield* SubscriptionRef.make(0);
-  const noteSeen = (sequence: number) =>
-    SubscriptionRef.update(seenSequence, (seen) => Math.max(seen, sequence));
-
-  const start: ThreadDeletionReactorShape["start"] = Effect.fn("start")(function* () {
-    yield* forkParked(
-      Stream.runForEach(
-        orchestrationEngine.streamDomainEvents.pipe(
-          // Events that landed before the subscription are not replayed, so
-          // start the watermark at the current head instead of zero.
-          Stream.onStart(orchestrationEngine.latestSequence.pipe(Effect.flatMap(noteSeen))),
-        ),
-        (event) =>
-          (event.type === "thread.deleted" ? worker.enqueue(event) : Effect.void).pipe(
-            Effect.andThen(noteSeen(event.sequence)),
-          ),
-      ),
-    );
-  });
-
-  const drainThrough: ThreadDeletionReactorShape["drainThrough"] = Effect.fn(
-    "ThreadDeletionReactor.drainThrough",
-  )(function* (target) {
-    yield* SubscriptionRef.changes(seenSequence).pipe(
-      Stream.filter((seen) => seen >= target),
-      Stream.runHead,
-    );
-    yield* worker.drain;
-  });
-
-  return {
-    start,
-    drainThrough,
-  } satisfies ThreadDeletionReactorShape;
-});
-
-export const ThreadDeletionReactorLive = Layer.effect(ThreadDeletionReactor, make);
diff --git a/apps/server/src/orchestration/Normalizer.attachments.test.ts b/apps/server/src/orchestration/Normalizer.attachments.test.ts
deleted file mode 100644
index 7385b65315cb..000000000000
--- a/apps/server/src/orchestration/Normalizer.attachments.test.ts
+++ /dev/null
@@ -1,360 +0,0 @@
-// @effect-diagnostics nodeBuiltinImport:off
-import * as NodeFS from "node:fs";
-import * as NodePath from "node:path";
-
-import * as NodeServices from "@effect/platform-node/NodeServices";
-import { describe, expect, it } from "@effect/vitest";
-import {
-  type ClientOrchestrationCommand,
-  CommandId,
-  MessageId,
-  ThreadId,
-} from "@t3tools/contracts";
-import * as Effect from "effect/Effect";
-import * as Layer from "effect/Layer";
-
-import * as ServerConfig from "../config.ts";
-import * as WorkspacePaths from "../workspace/WorkspacePaths.ts";
-import { cleanupFailedUploadedAttachments, normalizeDispatchCommand } from "./Normalizer.ts";
-
-const testLayer = Layer.mergeAll(
-  WorkspacePaths.layer,
-  ServerConfig.layerTest(process.cwd(), { prefix: "t3-normalizer-attachments-" }),
-).pipe(Layer.provideMerge(NodeServices.layer));
-
-const attachmentUuid = "00000000-0000-4000-8000-0000000000aa";
-
-function turnStartCommand(input: {
-  readonly threadId?: string;
-  readonly attachments: ReadonlyArray<
-    | { readonly id: string; readonly sizeBytes: number }
-    | { readonly dataUrl: string; readonly sizeBytes: number }
-  >;
-}): ClientOrchestrationCommand {
-  return {
-    type: "thread.turn.start",
-    commandId: CommandId.make("command-1"),
-    threadId: ThreadId.make(input.threadId ?? "thread-1"),
-    message: {
-      messageId: MessageId.make("message-1"),
-      role: "user",
-      text: "look at this",
-      attachments: input.attachments.map((attachment) => ({
-        type: "image" as const,
-        name: "screenshot.png",
-        mimeType: "image/png",
-        ...attachment,
-      })),
-    },
-    runtimeMode: "full-access",
-    interactionMode: "default",
-    createdAt: "2026-08-01T00:00:00.000Z",
-  };
-}
-
-describe("normalizeDispatchCommand attachments", () => {
-  it.effect("preserves inline image attachments from existing mobile clients", () =>
-    Effect.gen(function* () {
-      const config = yield* ServerConfig.ServerConfig;
-      const normalized = yield* normalizeDispatchCommand(
-        turnStartCommand({
-          attachments: [{ dataUrl: "data:image/png;base64,cGl4ZWxz", sizeBytes: 6 }],
-        }),
-      );
-      if (normalized.type !== "thread.turn.start") {
-        throw new Error("Expected a thread.turn.start command.");
-      }
-
-      const attachment = normalized.message.attachments[0]!;
-      expect(attachment.id.startsWith("thread-1-")).toBe(true);
-      expect(
-        NodeFS.readFileSync(NodePath.join(config.attachmentsDir, `${attachment.id}.png`)),
-      ).toEqual(Buffer.from("pixels"));
-    }).pipe(Effect.provide(testLayer)),
-  );
-
-  it.effect("claims uploaded attachments while retaining a retryable pending copy", () =>
-    Effect.gen(function* () {
-      const config = yield* ServerConfig.ServerConfig;
-      const bytes = Buffer.from("pixels");
-      const pendingPath = NodePath.join(config.attachmentsDir, `pending-${attachmentUuid}.png`);
-      NodeFS.writeFileSync(pendingPath, bytes);
-
-      const normalized = yield* normalizeDispatchCommand(
-        turnStartCommand({
-          attachments: [{ id: `pending-${attachmentUuid}`, sizeBytes: bytes.byteLength }],
-        }),
-      );
-      if (normalized.type !== "thread.turn.start") {
-        throw new Error("Expected a thread.turn.start command.");
-      }
-
-      const attachmentId = normalized.message.attachments[0]!.id;
-      expect(attachmentId.startsWith("thread-1-")).toBe(true);
-      expect(attachmentId).not.toBe(`thread-1-${attachmentUuid}`);
-      expect(NodeFS.existsSync(pendingPath)).toBe(true);
-      const claimedPngPath = NodePath.join(config.attachmentsDir, `${attachmentId}.png`);
-      expect(NodeFS.existsSync(claimedPngPath)).toBe(true);
-      // A copy, not a hard link: editing the delivered file must not mutate
-      // the retryable pending upload.
-      expect(NodeFS.statSync(claimedPngPath).ino).not.toBe(NodeFS.statSync(pendingPath).ino);
-      expect(NodeFS.readFileSync(claimedPngPath)).toEqual(bytes);
-    }).pipe(Effect.provide(testLayer)),
-  );
-
-  it.effect("normalizes inline and uploaded attachments in the same turn", () =>
-    Effect.gen(function* () {
-      const config = yield* ServerConfig.ServerConfig;
-      NodeFS.writeFileSync(
-        NodePath.join(config.attachmentsDir, `pending-${attachmentUuid}.png`),
-        Buffer.from("pixels"),
-      );
-
-      const normalized = yield* normalizeDispatchCommand(
-        turnStartCommand({
-          attachments: [
-            { dataUrl: "data:image/png;base64,cGl4ZWxz", sizeBytes: 6 },
-            { id: `pending-${attachmentUuid}`, sizeBytes: 6 },
-          ],
-        }),
-      );
-      if (normalized.type !== "thread.turn.start") {
-        throw new Error("Expected a thread.turn.start command.");
-      }
-
-      expect(normalized.message.attachments).toHaveLength(2);
-      expect(normalized.message.attachments[1]?.id.startsWith("thread-1-")).toBe(true);
-    }).pipe(Effect.provide(testLayer)),
-  );
-
-  it.effect("claims uploaded documents without changing their original extension", () =>
-    Effect.gen(function* () {
-      const config = yield* ServerConfig.ServerConfig;
-      const pendingId = `pending-${attachmentUuid}-pdf`;
-      const pendingPath = NodePath.join(config.attachmentsDir, `${pendingId}.pdf`);
-      NodeFS.writeFileSync(pendingPath, Buffer.from("report"));
-
-      const imageCommand = turnStartCommand({ attachments: [] });
-      if (imageCommand.type !== "thread.turn.start") {
-        throw new Error("Expected a thread.turn.start command.");
-      }
-      const normalized = yield* normalizeDispatchCommand({
-        ...imageCommand,
-        message: {
-          ...imageCommand.message,
-          attachments: [
-            {
-              type: "file",
-              id: pendingId,
-              name: "report.pdf",
-              mimeType: "application/pdf",
-              sizeBytes: 6,
-            },
-          ],
-        },
-      });
-      if (normalized.type !== "thread.turn.start") {
-        throw new Error("Expected a thread.turn.start command.");
-      }
-
-      const attachment = normalized.message.attachments[0]!;
-      expect(attachment.type).toBe("file");
-      expect(attachment.id).toMatch(/^thread-1-.*-pdf$/);
-      const claimedPath = NodePath.join(config.attachmentsDir, `${attachment.id}.pdf`);
-      expect(NodeFS.readFileSync(claimedPath)).toEqual(Buffer.from("report"));
-      expect(NodeFS.statSync(claimedPath).ino).not.toBe(NodeFS.statSync(pendingPath).ino);
-    }).pipe(Effect.provide(testLayer)),
-  );
-
-  it.effect("retries a failed bootstrap with a fresh thread id", () =>
-    Effect.gen(function* () {
-      const config = yield* ServerConfig.ServerConfig;
-      const bytes = Buffer.from("pixels");
-      NodeFS.writeFileSync(
-        NodePath.join(config.attachmentsDir, `pending-${attachmentUuid}.png`),
-        bytes,
-      );
-
-      const first = yield* normalizeDispatchCommand(
-        turnStartCommand({
-          attachments: [{ id: `pending-${attachmentUuid}`, sizeBytes: bytes.byteLength }],
-        }),
-      );
-      if (first.type !== "thread.turn.start") {
-        throw new Error("Expected a thread.turn.start command.");
-      }
-      NodeFS.rmSync(
-        NodePath.join(config.attachmentsDir, `${first.message.attachments[0]!.id}.png`),
-      );
-
-      const retried = yield* normalizeDispatchCommand(
-        turnStartCommand({
-          threadId: "thread-retry",
-          attachments: [{ id: `pending-${attachmentUuid}`, sizeBytes: bytes.byteLength }],
-        }),
-      );
-      if (retried.type !== "thread.turn.start") {
-        throw new Error("Expected a thread.turn.start command.");
-      }
-      expect(retried.message.attachments[0]?.id.startsWith("thread-retry-")).toBe(true);
-    }).pipe(Effect.provide(testLayer)),
-  );
-
-  it.effect("removes failed attachment claims without deleting their pending uploads", () =>
-    Effect.gen(function* () {
-      const config = yield* ServerConfig.ServerConfig;
-      const pendingPath = NodePath.join(config.attachmentsDir, `pending-${attachmentUuid}.png`);
-      NodeFS.writeFileSync(pendingPath, Buffer.from("pixels"));
-      const command = turnStartCommand({
-        attachments: [
-          { dataUrl: "data:image/png;base64,cGl4ZWxz", sizeBytes: 6 },
-          { id: `pending-${attachmentUuid}`, sizeBytes: 6 },
-        ],
-      });
-      const normalized = yield* normalizeDispatchCommand(command);
-      if (normalized.type !== "thread.turn.start") {
-        throw new Error("Expected a thread.turn.start command.");
-      }
-
-      const inlinePath = NodePath.join(
-        config.attachmentsDir,
-        `${normalized.message.attachments[0]!.id}.png`,
-      );
-      const claimedPath = NodePath.join(
-        config.attachmentsDir,
-        `${normalized.message.attachments[1]!.id}.png`,
-      );
-      yield* cleanupFailedUploadedAttachments(command, normalized);
-
-      expect(NodeFS.existsSync(pendingPath)).toBe(true);
-      expect(NodeFS.existsSync(claimedPath)).toBe(false);
-      expect(NodeFS.existsSync(inlinePath)).toBe(true);
-    }).pipe(Effect.provide(testLayer)),
-  );
-
-  it.effect("removes a failed claimed copy after its pending original was removed", () =>
-    Effect.gen(function* () {
-      const config = yield* ServerConfig.ServerConfig;
-      const pendingPath = NodePath.join(config.attachmentsDir, `pending-${attachmentUuid}.png`);
-      NodeFS.writeFileSync(pendingPath, Buffer.from("pixels"));
-      const command = turnStartCommand({
-        attachments: [{ id: `pending-${attachmentUuid}`, sizeBytes: 6 }],
-      });
-      const normalized = yield* normalizeDispatchCommand(command);
-      if (normalized.type !== "thread.turn.start") {
-        throw new Error("Expected a thread.turn.start command.");
-      }
-
-      const claimedPath = NodePath.join(
-        config.attachmentsDir,
-        `${normalized.message.attachments[0]!.id}.png`,
-      );
-      NodeFS.rmSync(pendingPath);
-
-      yield* cleanupFailedUploadedAttachments(command, normalized);
-
-      expect(NodeFS.existsSync(claimedPath)).toBe(false);
-    }).pipe(Effect.provide(testLayer)),
-  );
-
-  it.effect("keeps concurrent claims independent when one dispatch fails", () =>
-    Effect.gen(function* () {
-      const config = yield* ServerConfig.ServerConfig;
-      const pendingPath = NodePath.join(config.attachmentsDir, `pending-${attachmentUuid}.png`);
-      NodeFS.writeFileSync(pendingPath, Buffer.from("pixels"));
-      const command = turnStartCommand({
-        attachments: [{ id: `pending-${attachmentUuid}`, sizeBytes: 6 }],
-      });
-
-      const [failed, succeeded] = yield* Effect.all(
-        [normalizeDispatchCommand(command), normalizeDispatchCommand(command)],
-        { concurrency: 2 },
-      );
-      if (failed.type !== "thread.turn.start" || succeeded.type !== "thread.turn.start") {
-        throw new Error("Expected thread.turn.start commands.");
-      }
-
-      const failedPath = NodePath.join(
-        config.attachmentsDir,
-        `${failed.message.attachments[0]!.id}.png`,
-      );
-      const succeededPath = NodePath.join(
-        config.attachmentsDir,
-        `${succeeded.message.attachments[0]!.id}.png`,
-      );
-      expect(failedPath).not.toBe(succeededPath);
-
-      yield* cleanupFailedUploadedAttachments(command, failed);
-
-      expect(NodeFS.existsSync(pendingPath)).toBe(true);
-      expect(NodeFS.existsSync(failedPath)).toBe(false);
-      expect(NodeFS.existsSync(succeededPath)).toBe(true);
-    }).pipe(Effect.provide(testLayer)),
-  );
-
-  it.effect("removes earlier claimed copies when a later attachment cannot be normalized", () =>
-    Effect.gen(function* () {
-      const config = yield* ServerConfig.ServerConfig;
-      const pendingId = `pending-${attachmentUuid}`;
-      const pendingPath = NodePath.join(config.attachmentsDir, `${pendingId}.png`);
-      NodeFS.writeFileSync(pendingPath, Buffer.from("pixels"));
-
-      const failure = yield* normalizeDispatchCommand(
-        turnStartCommand({
-          attachments: [
-            { id: pendingId, sizeBytes: 6 },
-            {
-              id: "pending-00000000-0000-4000-8000-0000000000ff",
-              sizeBytes: 6,
-            },
-          ],
-        }),
-      ).pipe(Effect.flip);
-
-      expect(failure.message).toContain("not found");
-      expect(NodeFS.readdirSync(config.attachmentsDir)).toEqual([`${pendingId}.png`]);
-    }).pipe(Effect.provide(testLayer)),
-  );
-
-  it.effect("rejects uploaded attachments with the wrong size or thread", () =>
-    Effect.gen(function* () {
-      const config = yield* ServerConfig.ServerConfig;
-      NodeFS.writeFileSync(
-        NodePath.join(config.attachmentsDir, `pending-${attachmentUuid}.png`),
-        Buffer.from("pixels"),
-      );
-
-      const wrongSize = yield* normalizeDispatchCommand(
-        turnStartCommand({
-          attachments: [{ id: `pending-${attachmentUuid}`, sizeBytes: 999 }],
-        }),
-      ).pipe(Effect.flip);
-      expect(wrongSize.message).toContain("size");
-
-      const wrongThread = yield* normalizeDispatchCommand(
-        turnStartCommand({
-          attachments: [{ id: `another-thread-${attachmentUuid}`, sizeBytes: 6 }],
-        }),
-      ).pipe(Effect.flip);
-      expect(wrongThread.message).toContain("pending upload");
-
-      const mismatchedTypeCommand = turnStartCommand({
-        attachments: [{ id: `pending-${attachmentUuid}`, sizeBytes: 6 }],
-      });
-      if (mismatchedTypeCommand.type !== "thread.turn.start") {
-        throw new Error("Expected a thread.turn.start command.");
-      }
-      const mismatchedType = yield* normalizeDispatchCommand({
-        ...mismatchedTypeCommand,
-        message: {
-          ...mismatchedTypeCommand.message,
-          attachments: mismatchedTypeCommand.message.attachments.map((attachment) => ({
-            ...attachment,
-            mimeType: "image/jpeg",
-          })),
-        },
-      }).pipe(Effect.flip);
-      expect(mismatchedType.message).toContain("attachment type");
-    }).pipe(Effect.provide(testLayer)),
-  );
-});
diff --git a/apps/server/src/orchestration/Normalizer.test.ts b/apps/server/src/orchestration/Normalizer.test.ts
deleted file mode 100644
index 113b6e1baeed..000000000000
--- a/apps/server/src/orchestration/Normalizer.test.ts
+++ /dev/null
@@ -1,73 +0,0 @@
-import { describe, expect, it } from "vite-plus/test";
-import {
-  CommandId,
-  type ClientOrchestrationCommand,
-  MessageId,
-  ProjectId,
-  ProviderInstanceId,
-  ThreadId,
-} from "@t3tools/contracts";
-
-import { canonicalizeClientCommandTimestamps } from "./Normalizer.ts";
-
-const clientCreatedAt = "2031-01-01T00:00:00.000Z";
-const serverReceivedAt = "2026-07-18T00:00:00.000Z";
-
-describe("canonicalizeClientCommandTimestamps", () => {
-  it("replaces a client command timestamp with the server receipt timestamp", () => {
-    const command: ClientOrchestrationCommand = {
-      type: "project.create",
-      commandId: CommandId.make("command-1"),
-      projectId: ProjectId.make("project-1"),
-      title: "Clock-safe project",
-      workspaceRoot: "/tmp/clock-safe-project",
-      createdAt: clientCreatedAt,
-    };
-
-    expect(canonicalizeClientCommandTimestamps(command, serverReceivedAt)).toEqual({
-      ...command,
-      createdAt: serverReceivedAt,
-    });
-  });
-
-  it("replaces both timestamps when the first turn bootstraps a thread", () => {
-    const command: ClientOrchestrationCommand = {
-      type: "thread.turn.start",
-      commandId: CommandId.make("command-2"),
-      threadId: ThreadId.make("thread-1"),
-      message: {
-        messageId: MessageId.make("message-1"),
-        role: "user",
-        text: "Start a thread",
-        attachments: [],
-      },
-      runtimeMode: "full-access",
-      interactionMode: "default",
-      bootstrap: {
-        createThread: {
-          projectId: ProjectId.make("project-1"),
-          title: "Clock-safe thread",
-          modelSelection: {
-            instanceId: ProviderInstanceId.make("codex"),
-            model: "gpt-5.4",
-          },
-          runtimeMode: "full-access",
-          interactionMode: "default",
-          branch: null,
-          worktreePath: null,
-          createdAt: clientCreatedAt,
-        },
-      },
-      createdAt: clientCreatedAt,
-    };
-
-    const result = canonicalizeClientCommandTimestamps(command, serverReceivedAt);
-
-    expect(result.type).toBe("thread.turn.start");
-    if (result.type !== "thread.turn.start") {
-      throw new Error("Expected a thread.turn.start command");
-    }
-    expect(result.createdAt).toBe(serverReceivedAt);
-    expect(result.bootstrap?.createThread?.createdAt).toBe(serverReceivedAt);
-  });
-});
diff --git a/apps/server/src/orchestration/Normalizer.ts b/apps/server/src/orchestration/Normalizer.ts
deleted file mode 100644
index 1226a6cd25d5..000000000000
--- a/apps/server/src/orchestration/Normalizer.ts
+++ /dev/null
@@ -1,299 +0,0 @@
-import * as DateTime from "effect/DateTime";
-import * as Effect from "effect/Effect";
-import * as FileSystem from "effect/FileSystem";
-import * as Path from "effect/Path";
-import {
-  type ClientOrchestrationCommand,
-  type IsoDateTime,
-  type OrchestrationCommand,
-  OrchestrationDispatchCommandError,
-  PROVIDER_SEND_TURN_MAX_IMAGE_BYTES,
-} from "@t3tools/contracts";
-
-import {
-  createAttachmentId,
-  planAttachmentClaim,
-  PENDING_ATTACHMENT_THREAD_SEGMENT,
-  parseThreadSegmentFromAttachmentId,
-  resolveAttachmentPath,
-} from "../attachmentStore.ts";
-import { ServerConfig } from "../config.ts";
-import { parseBase64DataUrl } from "../imageMime.ts";
-import * as WorkspacePaths from "../workspace/WorkspacePaths.ts";
-
-export const canonicalizeClientCommandTimestamps = (
-  command: ClientOrchestrationCommand,
-  receivedAt: IsoDateTime,
-): ClientOrchestrationCommand => {
-  const canonicalCommand =
-    "createdAt" in command
-      ? {
-          ...command,
-          createdAt: receivedAt,
-        }
-      : command;
-
-  if (canonicalCommand.type !== "thread.turn.start" || !canonicalCommand.bootstrap?.createThread) {
-    return canonicalCommand;
-  }
-
-  return {
-    ...canonicalCommand,
-    bootstrap: {
-      ...canonicalCommand.bootstrap,
-      createThread: {
-        ...canonicalCommand.bootstrap.createThread,
-        createdAt: receivedAt,
-      },
-    },
-  };
-};
-
-const removeClaimedAttachmentPaths = Effect.fn("Normalizer.removeClaimedAttachmentPaths")(
-  function* (attachmentPaths: ReadonlyArray<string>) {
-    if (attachmentPaths.length === 0) {
-      return;
-    }
-    const fileSystem = yield* FileSystem.FileSystem;
-    yield* Effect.forEach(
-      attachmentPaths,
-      (attachmentPath) =>
-        fileSystem.remove(attachmentPath, { force: true }).pipe(
-          Effect.tapError((cause) =>
-            Effect.logWarning("Failed to remove an unclaimed attachment copy.", {
-              attachmentPath,
-              cause,
-            }),
-          ),
-          Effect.orElseSucceed(() => undefined),
-        ),
-      { concurrency: 1 },
-    );
-  },
-);
-
-export const normalizeDispatchCommand = (command: ClientOrchestrationCommand) =>
-  Effect.gen(function* () {
-    const receivedAt = DateTime.formatIso(yield* DateTime.now);
-    const canonicalCommand = canonicalizeClientCommandTimestamps(command, receivedAt);
-    const fileSystem = yield* FileSystem.FileSystem;
-    const path = yield* Path.Path;
-    const serverConfig = yield* ServerConfig;
-    const workspacePaths = yield* WorkspacePaths.WorkspacePaths;
-
-    const normalizeProjectWorkspaceRoot = (workspaceRoot: string) =>
-      workspacePaths.normalizeWorkspaceRoot(workspaceRoot).pipe(
-        Effect.mapError(
-          (cause) =>
-            new OrchestrationDispatchCommandError({
-              message: cause.message,
-            }),
-        ),
-      );
-
-    const normalizeProjectWorkspaceRootForCreate = (
-      workspaceRoot: string,
-      createIfMissing: boolean | undefined,
-    ) =>
-      workspacePaths
-        .normalizeWorkspaceRoot(workspaceRoot, {
-          createIfMissing: createIfMissing === true,
-        })
-        .pipe(
-          Effect.mapError(
-            (cause) =>
-              new OrchestrationDispatchCommandError({
-                message: cause.message,
-              }),
-          ),
-        );
-
-    if (canonicalCommand.type === "project.create") {
-      return {
-        ...canonicalCommand,
-        workspaceRoot: yield* normalizeProjectWorkspaceRootForCreate(
-          canonicalCommand.workspaceRoot,
-          canonicalCommand.createWorkspaceRootIfMissing,
-        ),
-        createWorkspaceRootIfMissing: canonicalCommand.createWorkspaceRootIfMissing === true,
-      } satisfies OrchestrationCommand;
-    }
-
-    if (
-      canonicalCommand.type === "project.meta.update" &&
-      canonicalCommand.workspaceRoot !== undefined
-    ) {
-      return {
-        ...canonicalCommand,
-        workspaceRoot: yield* normalizeProjectWorkspaceRoot(canonicalCommand.workspaceRoot),
-      } satisfies OrchestrationCommand;
-    }
-
-    if (canonicalCommand.type !== "thread.turn.start") {
-      return canonicalCommand as OrchestrationCommand;
-    }
-
-    const claimedAttachmentPaths: string[] = [];
-    const normalizedAttachments = yield* Effect.forEach(
-      canonicalCommand.message.attachments,
-      (attachment) =>
-        Effect.gen(function* () {
-          if (!("dataUrl" in attachment)) {
-            const claim = planAttachmentClaim({
-              attachmentsDir: serverConfig.attachmentsDir,
-              threadId: canonicalCommand.threadId,
-              attachmentId: attachment.id,
-            });
-            if (!claim.ok) {
-              return yield* new OrchestrationDispatchCommandError({
-                message: `Attachment '${attachment.name}' cannot be sent: ${claim.reason}.`,
-              });
-            }
-
-            const info = yield* fileSystem.stat(claim.currentPath).pipe(
-              Effect.mapError(
-                (cause) =>
-                  new OrchestrationDispatchCommandError({
-                    message: `Attachment '${attachment.name}' cannot be sent: attachment not found.`,
-                    cause,
-                  }),
-              ),
-            );
-            if (Number(info.size) !== attachment.sizeBytes) {
-              return yield* new OrchestrationDispatchCommandError({
-                message: `Attachment '${attachment.name}' cannot be sent: stored size does not match.`,
-              });
-            }
-
-            const normalizedAttachment = {
-              ...attachment,
-              id: claim.finalId,
-              mimeType: attachment.mimeType.toLowerCase(),
-            };
-            const expectedPath = resolveAttachmentPath({
-              attachmentsDir: serverConfig.attachmentsDir,
-              attachment: normalizedAttachment,
-            });
-            if (expectedPath !== claim.finalPath) {
-              return yield* new OrchestrationDispatchCommandError({
-                message: `Attachment '${attachment.name}' cannot be sent: attachment type does not match the upload.`,
-              });
-            }
-
-            // Keep the pending copy until the turn succeeds. A failed thread
-            // bootstrap can then retry with a fresh thread id. A copy, not a
-            // hard link: an agent editing the delivered file in place must not
-            // mutate the retry source.
-            yield* fileSystem.copyFile(claim.currentPath, claim.finalPath).pipe(
-              Effect.mapError(
-                (cause) =>
-                  new OrchestrationDispatchCommandError({
-                    message: `Failed to claim attachment '${attachment.name}' for this thread.`,
-                    cause,
-                  }),
-              ),
-            );
-            claimedAttachmentPaths.push(claim.finalPath);
-
-            return normalizedAttachment;
-          }
-
-          const parsed = parseBase64DataUrl(attachment.dataUrl);
-          if (!parsed || !parsed.mimeType.startsWith("image/")) {
-            return yield* new OrchestrationDispatchCommandError({
-              message: `Invalid image attachment payload for '${attachment.name}'.`,
-            });
-          }
-
-          const bytes = Buffer.from(parsed.base64, "base64");
-          if (bytes.byteLength === 0 || bytes.byteLength > PROVIDER_SEND_TURN_MAX_IMAGE_BYTES) {
-            return yield* new OrchestrationDispatchCommandError({
-              message: `Image attachment '${attachment.name}' is empty or too large.`,
-            });
-          }
-
-          const attachmentId = createAttachmentId(canonicalCommand.threadId);
-          if (!attachmentId) {
-            return yield* new OrchestrationDispatchCommandError({
-              message: "Failed to create a safe attachment id.",
-            });
-          }
-
-          const persistedAttachment = {
-            type: "image" as const,
-            id: attachmentId,
-            name: attachment.name,
-            mimeType: parsed.mimeType.toLowerCase(),
-            sizeBytes: bytes.byteLength,
-          };
-
-          const attachmentPath = resolveAttachmentPath({
-            attachmentsDir: serverConfig.attachmentsDir,
-            attachment: persistedAttachment,
-          });
-          if (!attachmentPath) {
-            return yield* new OrchestrationDispatchCommandError({
-              message: `Failed to resolve persisted path for '${attachment.name}'.`,
-            });
-          }
-
-          yield* fileSystem.makeDirectory(path.dirname(attachmentPath), { recursive: true }).pipe(
-            Effect.mapError(
-              () =>
-                new OrchestrationDispatchCommandError({
-                  message: `Failed to create attachment directory for '${attachment.name}'.`,
-                }),
-            ),
-          );
-          yield* fileSystem.writeFile(attachmentPath, bytes).pipe(
-            Effect.mapError(
-              () =>
-                new OrchestrationDispatchCommandError({
-                  message: `Failed to persist attachment '${attachment.name}'.`,
-                }),
-            ),
-          );
-
-          return persistedAttachment;
-        }),
-      { concurrency: 1 },
-    ).pipe(Effect.tapError(() => removeClaimedAttachmentPaths(claimedAttachmentPaths)));
-
-    return {
-      ...canonicalCommand,
-      message: {
-        ...canonicalCommand.message,
-        attachments: normalizedAttachments,
-      },
-    } satisfies OrchestrationCommand;
-  });
-
-export const cleanupFailedUploadedAttachments = Effect.fn(
-  "Normalizer.cleanupFailedUploadedAttachments",
-)(function* (command: ClientOrchestrationCommand, normalizedCommand: OrchestrationCommand) {
-  if (command.type !== "thread.turn.start" || normalizedCommand.type !== "thread.turn.start") {
-    return;
-  }
-
-  const serverConfig = yield* ServerConfig;
-  const claimedPaths: string[] = [];
-  for (const [index, attachment] of normalizedCommand.message.attachments.entries()) {
-    const original = command.message.attachments[index];
-    if (
-      !original ||
-      "dataUrl" in original ||
-      parseThreadSegmentFromAttachmentId(original.id) !== PENDING_ATTACHMENT_THREAD_SEGMENT
-    ) {
-      continue;
-    }
-
-    const claimedPath = resolveAttachmentPath({
-      attachmentsDir: serverConfig.attachmentsDir,
-      attachment,
-    });
-    if (claimedPath) {
-      claimedPaths.push(claimedPath);
-    }
-  }
-  yield* removeClaimedAttachmentPaths(claimedPaths);
-});
diff --git a/apps/server/src/orchestration/Schemas.ts b/apps/server/src/orchestration/Schemas.ts
index 7e866cf89592..84613fce027b 100644
--- a/apps/server/src/orchestration/Schemas.ts
+++ b/apps/server/src/orchestration/Schemas.ts
@@ -27,7 +27,7 @@ import {
   ThreadApprovalResponseRequestedPayload as ContractsThreadApprovalResponseRequestedPayloadSchema,
   ThreadCheckpointRevertRequestedPayload as ContractsThreadCheckpointRevertRequestedPayloadSchema,
   ThreadSessionStopRequestedPayload as ContractsThreadSessionStopRequestedPayloadSchema,
-} from "@t3tools/contracts";
+} from "@t3tools/contracts/legacy-orchestration";
 
 // Server-internal alias surface, backed by contract schemas as the source of truth.
 export const ProjectCreatedPayload = ContractsProjectCreatedPayloadSchema;
diff --git a/apps/server/src/orchestration/Services/CheckpointReactor.ts b/apps/server/src/orchestration/Services/CheckpointReactor.ts
deleted file mode 100644
index bd3ee3e88f91..000000000000
--- a/apps/server/src/orchestration/Services/CheckpointReactor.ts
+++ /dev/null
@@ -1,40 +0,0 @@
-/**
- * CheckpointReactor - Checkpoint reaction service interface.
- *
- * Owns background workers that react to orchestration checkpoint lifecycle
- * events and apply checkpoint side effects.
- *
- * @module CheckpointReactor
- */
-import * as Context from "effect/Context";
-import type * as Effect from "effect/Effect";
-import type * as Scope from "effect/Scope";
-
-/**
- * CheckpointReactorShape - Service API for checkpoint reactor lifecycle.
- */
-export interface CheckpointReactorShape {
-  /**
-   * Start the checkpoint reactor.
-   *
-   * The returned effect must be run in a scope so all worker fibers can be
-   * finalized on shutdown.
-   *
-   * Consumes both orchestration-domain and provider-runtime events via an
-   * internal queue.
-   */
-  readonly start: () => Effect.Effect<void, never, Scope.Scope>;
-
-  /**
-   * Resolves when the internal processing queue is empty and idle.
-   * Intended for test use to replace timing-sensitive sleeps.
-   */
-  readonly drain: Effect.Effect<void>;
-}
-
-/**
- * CheckpointReactor - Service tag for checkpoint reactor workers.
- */
-export class CheckpointReactor extends Context.Service<CheckpointReactor, CheckpointReactorShape>()(
-  "t3/orchestration/Services/CheckpointReactor",
-) {}
diff --git a/apps/server/src/orchestration/Services/OrchestrationEngine.ts b/apps/server/src/orchestration/Services/OrchestrationEngine.ts
index a32a45684014..0b3a26ffa5d9 100644
--- a/apps/server/src/orchestration/Services/OrchestrationEngine.ts
+++ b/apps/server/src/orchestration/Services/OrchestrationEngine.ts
@@ -1,9 +1,9 @@
 /**
- * OrchestrationEngineService - Service interface for orchestration command handling.
+ * Historical name for the application event-sourcing engine.
  *
- * Owns command validation/dispatch and in-memory read-model updates backed by
- * `OrchestrationEventStore` persistence. It does not own provider process
- * management or transport concerns (e.g. websocket request parsing).
+ * This is not the agent orchestrator. It retains serialized project-command
+ * validation, append, receipt, and projection transactions. Agent execution is
+ * owned by orchestration V2, whose thread events use the same event store.
  *
  * Uses Effect `Context.Service` for dependency injection. Command dispatch,
  * replay, and unknown-input decoding all return typed domain errors.
@@ -12,9 +12,9 @@
  */
 import type {
   OrchestrationClientOrigin,
-  OrchestrationCommand,
   OrchestrationEvent,
-} from "@t3tools/contracts";
+  ProjectOrchestrationCommand,
+} from "@t3tools/contracts/legacy-orchestration";
 import * as Context from "effect/Context";
 import type * as Effect from "effect/Effect";
 import type * as Stream from "effect/Stream";
@@ -53,7 +53,7 @@ export interface OrchestrationEngineShape {
    * command receipts.
    */
   readonly dispatch: (
-    command: OrchestrationCommand,
+    command: ProjectOrchestrationCommand,
     options?: { readonly origin?: OrchestrationClientOrigin },
   ) => Effect.Effect<{ sequence: number }, OrchestrationDispatchError, never>;
 
diff --git a/apps/server/src/orchestration/Services/OrchestrationReactor.ts b/apps/server/src/orchestration/Services/OrchestrationReactor.ts
deleted file mode 100644
index eb2d95954bb5..000000000000
--- a/apps/server/src/orchestration/Services/OrchestrationReactor.ts
+++ /dev/null
@@ -1,32 +0,0 @@
-/**
- * OrchestrationReactor - Composite orchestration reactor service interface.
- *
- * Coordinates startup of orchestration runtime reactors that translate domain
- * events into downstream side effects.
- *
- * @module OrchestrationReactor
- */
-import * as Context from "effect/Context";
-import type * as Effect from "effect/Effect";
-import type * as Scope from "effect/Scope";
-
-/**
- * OrchestrationReactorShape - Service API for orchestration reactor lifecycle.
- */
-export interface OrchestrationReactorShape {
-  /**
-   * Start orchestration-side reactors for provider/runtime/checkpoint flows.
-   *
-   * The returned effect must be run in a scope so all worker fibers can be
-   * finalized on shutdown.
-   */
-  readonly start: () => Effect.Effect<void, never, Scope.Scope>;
-}
-
-/**
- * OrchestrationReactor - Service tag for orchestration reactor coordination.
- */
-export class OrchestrationReactor extends Context.Service<
-  OrchestrationReactor,
-  OrchestrationReactorShape
->()("t3/orchestration/Services/OrchestrationReactor") {}
diff --git a/apps/server/src/orchestration/Services/ProjectionPipeline.ts b/apps/server/src/orchestration/Services/ProjectionPipeline.ts
index bb4736ca57a1..b9a60ab45e8c 100644
--- a/apps/server/src/orchestration/Services/ProjectionPipeline.ts
+++ b/apps/server/src/orchestration/Services/ProjectionPipeline.ts
@@ -6,7 +6,7 @@
  *
  * @module OrchestrationProjectionPipeline
  */
-import type { OrchestrationEvent } from "@t3tools/contracts";
+import type { OrchestrationEvent } from "@t3tools/contracts/legacy-orchestration";
 import * as Context from "effect/Context";
 import type * as Effect from "effect/Effect";
 
diff --git a/apps/server/src/orchestration/Services/ProjectionSnapshotQuery.ts b/apps/server/src/orchestration/Services/ProjectionSnapshotQuery.ts
index 0a00253a2285..acd4c2b9bc26 100644
--- a/apps/server/src/orchestration/Services/ProjectionSnapshotQuery.ts
+++ b/apps/server/src/orchestration/Services/ProjectionSnapshotQuery.ts
@@ -6,8 +6,8 @@
  *
  * @module ProjectionSnapshotQuery
  */
+import type { CheckpointRef, ProjectId, ThreadId } from "@t3tools/contracts";
 import type {
-  CheckpointRef,
   OrchestrationCheckpointSummary,
   OrchestrationProject,
   OrchestrationProjectShell,
@@ -19,9 +19,7 @@ import type {
   OrchestrationThreadDetailSnapshot,
   OrchestrationThreadDetailWindow,
   OrchestrationThreadShell,
-  ProjectId,
-  ThreadId,
-} from "@t3tools/contracts";
+} from "@t3tools/contracts/legacy-orchestration";
 import * as Context from "effect/Context";
 import type * as Option from "effect/Option";
 import type * as Effect from "effect/Effect";
@@ -86,6 +84,17 @@ export interface ProjectionSnapshotQueryShape {
     ProjectionRepositoryError
   >;
 
+  /**
+   * Read the shell snapshot with null optional repository metadata.
+   *
+   * Transactional callers use this method and enrich the returned projects
+   * only after their transaction has closed.
+   */
+  readonly getShellSnapshotWithoutEnrichment: () => Effect.Effect<
+    OrchestrationShellSnapshot,
+    ProjectionRepositoryError
+  >;
+
   /**
    * Read archived thread shell summaries for the archive page.
    *
@@ -133,6 +142,12 @@ export interface ProjectionSnapshotQueryShape {
     projectId: ProjectId,
   ) => Effect.Effect<Option.Option<OrchestrationProjectShell>, ProjectionRepositoryError>;
 
+  /** Read every active project shell without hydrating thread rows or enrichment. */
+  readonly getProjectShellsWithoutEnrichment: () => Effect.Effect<
+    ReadonlyArray<OrchestrationProjectShell>,
+    ProjectionRepositoryError
+  >;
+
   /**
    * Read the earliest active thread for a project.
    */
diff --git a/apps/server/src/orchestration/Services/ProviderCommandReactor.ts b/apps/server/src/orchestration/Services/ProviderCommandReactor.ts
deleted file mode 100644
index 65aa9949fe1d..000000000000
--- a/apps/server/src/orchestration/Services/ProviderCommandReactor.ts
+++ /dev/null
@@ -1,41 +0,0 @@
-/**
- * ProviderCommandReactor - Provider command reaction service interface.
- *
- * Owns background workers that react to orchestration intent events and
- * dispatch provider-side command execution.
- *
- * @module ProviderCommandReactor
- */
-import * as Context from "effect/Context";
-import type * as Effect from "effect/Effect";
-import type * as Scope from "effect/Scope";
-
-/**
- * ProviderCommandReactorShape - Service API for provider command reactors.
- */
-export interface ProviderCommandReactorShape {
-  /**
-   * Start reacting to provider-intent orchestration domain events.
-   *
-   * The returned effect must be run in a scope so all worker fibers can be
-   * finalized on shutdown.
-   *
-   * Filters orchestration domain events to provider-intent types before
-   * processing.
-   */
-  readonly start: () => Effect.Effect<void, never, Scope.Scope>;
-
-  /**
-   * Resolves when the internal processing queue is empty and idle.
-   * Intended for test use to replace timing-sensitive sleeps.
-   */
-  readonly drain: Effect.Effect<void>;
-}
-
-/**
- * ProviderCommandReactor - Service tag for provider command reaction workers.
- */
-export class ProviderCommandReactor extends Context.Service<
-  ProviderCommandReactor,
-  ProviderCommandReactorShape
->()("t3/orchestration/Services/ProviderCommandReactor") {}
diff --git a/apps/server/src/orchestration/Services/ProviderRuntimeIngestion.ts b/apps/server/src/orchestration/Services/ProviderRuntimeIngestion.ts
deleted file mode 100644
index b6fa2711b949..000000000000
--- a/apps/server/src/orchestration/Services/ProviderRuntimeIngestion.ts
+++ /dev/null
@@ -1,41 +0,0 @@
-/**
- * ProviderRuntimeIngestionService - Provider runtime ingestion service interface.
- *
- * Owns background workers that consume provider runtime streams and emit
- * orchestration commands/events.
- *
- * @module ProviderRuntimeIngestionService
- */
-import * as Context from "effect/Context";
-import type * as Effect from "effect/Effect";
-import type * as Scope from "effect/Scope";
-
-/**
- * ProviderRuntimeIngestionShape - Service API for runtime ingestion lifecycle.
- */
-export interface ProviderRuntimeIngestionShape {
-  /**
-   * Start ingesting provider runtime events into orchestration commands.
-   *
-   * The returned effect must be run in a scope so all worker fibers can be
-   * finalized on shutdown.
-   *
-   * Uses an internal queue and continues after non-interrupt failures by
-   * logging warnings.
-   */
-  readonly start: () => Effect.Effect<void, never, Scope.Scope>;
-
-  /**
-   * Resolves when the internal processing queue is empty and idle.
-   * Intended for test use to replace timing-sensitive sleeps.
-   */
-  readonly drain: Effect.Effect<void>;
-}
-
-/**
- * ProviderRuntimeIngestionService - Service tag for runtime ingestion workers.
- */
-export class ProviderRuntimeIngestionService extends Context.Service<
-  ProviderRuntimeIngestionService,
-  ProviderRuntimeIngestionShape
->()("t3/orchestration/Services/ProviderRuntimeIngestion/ProviderRuntimeIngestionService") {}
diff --git a/apps/server/src/orchestration/Services/RuntimeReceiptBus.ts b/apps/server/src/orchestration/Services/RuntimeReceiptBus.ts
deleted file mode 100644
index 0b880ee69993..000000000000
--- a/apps/server/src/orchestration/Services/RuntimeReceiptBus.ts
+++ /dev/null
@@ -1,66 +0,0 @@
-/**
- * RuntimeReceiptBus - Internal checkpoint-reactor synchronization receipts.
- *
- * This service exists to expose short-lived orchestration milestones that are
- * useful in tests and harnesses but are not part of the production runtime
- * event model. `CheckpointReactor` publishes receipts such as baseline capture,
- * diff finalization, and turn-processing quiescence so integration tests can
- * wait for those exact points without inferring them indirectly from persisted
- * state.
- *
- * Production code should only call `publish`. Test code may subscribe via
- * `streamEventsForTest`, which is intentionally named to make the intended
- * usage explicit.
- *
- * @module RuntimeReceiptBus
- */
-import { CheckpointRef, IsoDateTime, NonNegativeInt, ThreadId, TurnId } from "@t3tools/contracts";
-import * as Schema from "effect/Schema";
-import * as Context from "effect/Context";
-import type * as Effect from "effect/Effect";
-import type * as Stream from "effect/Stream";
-
-export const CheckpointBaselineCapturedReceipt = Schema.Struct({
-  type: Schema.Literal("checkpoint.baseline.captured"),
-  threadId: ThreadId,
-  checkpointTurnCount: NonNegativeInt,
-  checkpointRef: CheckpointRef,
-  createdAt: IsoDateTime,
-});
-export type CheckpointBaselineCapturedReceipt = typeof CheckpointBaselineCapturedReceipt.Type;
-
-export const CheckpointDiffFinalizedReceipt = Schema.Struct({
-  type: Schema.Literal("checkpoint.diff.finalized"),
-  threadId: ThreadId,
-  turnId: TurnId,
-  checkpointTurnCount: NonNegativeInt,
-  checkpointRef: CheckpointRef,
-  status: Schema.Literals(["ready", "missing", "error"]),
-  createdAt: IsoDateTime,
-});
-export type CheckpointDiffFinalizedReceipt = typeof CheckpointDiffFinalizedReceipt.Type;
-
-export const TurnProcessingQuiescedReceipt = Schema.Struct({
-  type: Schema.Literal("turn.processing.quiesced"),
-  threadId: ThreadId,
-  turnId: TurnId,
-  checkpointTurnCount: NonNegativeInt,
-  createdAt: IsoDateTime,
-});
-export type TurnProcessingQuiescedReceipt = typeof TurnProcessingQuiescedReceipt.Type;
-
-export const OrchestrationRuntimeReceipt = Schema.Union([
-  CheckpointBaselineCapturedReceipt,
-  CheckpointDiffFinalizedReceipt,
-  TurnProcessingQuiescedReceipt,
-]);
-export type OrchestrationRuntimeReceipt = typeof OrchestrationRuntimeReceipt.Type;
-
-export interface RuntimeReceiptBusShape {
-  readonly publish: (receipt: OrchestrationRuntimeReceipt) => Effect.Effect<void>;
-  readonly streamEventsForTest: Stream.Stream<OrchestrationRuntimeReceipt>;
-}
-
-export class RuntimeReceiptBus extends Context.Service<RuntimeReceiptBus, RuntimeReceiptBusShape>()(
-  "t3/orchestration/Services/RuntimeReceiptBus",
-) {}
diff --git a/apps/server/src/orchestration/Services/ThreadDeletionReactor.ts b/apps/server/src/orchestration/Services/ThreadDeletionReactor.ts
deleted file mode 100644
index cdbb70919a8e..000000000000
--- a/apps/server/src/orchestration/Services/ThreadDeletionReactor.ts
+++ /dev/null
@@ -1,40 +0,0 @@
-/**
- * ThreadDeletionReactor - Thread deletion cleanup reactor service interface.
- *
- * Owns background workers that react to thread deletion domain events and
- * perform best-effort runtime cleanup for provider sessions and terminals.
- *
- * @module ThreadDeletionReactor
- */
-import * as Context from "effect/Context";
-import type * as Effect from "effect/Effect";
-import type * as Scope from "effect/Scope";
-
-/**
- * ThreadDeletionReactorShape - Service API for thread deletion cleanup.
- */
-export interface ThreadDeletionReactorShape {
-  /**
-   * Start reacting to thread.deleted orchestration domain events.
-   *
-   * The returned effect must be run in a scope so all worker fibers can be
-   * finalized on shutdown.
-   */
-  readonly start: () => Effect.Effect<void, never, Scope.Scope>;
-
-  /**
-   * Resolves once every thread.deleted at or before the supplied event
-   * sequence has been handed to the worker and the worker is empty and idle.
-   * A successful thread.create sequence is the fence callers use before the
-   * new incarnation can own runtime resources.
-   */
-  readonly drainThrough: (sequence: number) => Effect.Effect<void>;
-}
-
-/**
- * ThreadDeletionReactor - Service tag for thread deletion cleanup workers.
- */
-export class ThreadDeletionReactor extends Context.Service<
-  ThreadDeletionReactor,
-  ThreadDeletionReactorShape
->()("t3/orchestration/Services/ThreadDeletionReactor") {}
diff --git a/apps/server/src/orchestration/commandInvariants.test.ts b/apps/server/src/orchestration/commandInvariants.test.ts
deleted file mode 100644
index 9aaeba943423..000000000000
--- a/apps/server/src/orchestration/commandInvariants.test.ts
+++ /dev/null
@@ -1,232 +0,0 @@
-import { describe, expect, it } from "vite-plus/test";
-import {
-  MessageId,
-  CommandId,
-  DEFAULT_PROVIDER_INTERACTION_MODE,
-  ProjectId,
-  ThreadId,
-  type OrchestrationCommand,
-  type OrchestrationReadModel,
-  ProviderInstanceId,
-} from "@t3tools/contracts";
-import * as Effect from "effect/Effect";
-
-import {
-  findThreadById,
-  listThreadsByProjectId,
-  requireThread,
-  requireThreadAbsent,
-} from "./commandInvariants.ts";
-
-const now = "2026-01-01T00:00:00.000Z";
-
-const readModel: OrchestrationReadModel = {
-  snapshotSequence: 2,
-  updatedAt: now,
-  projects: [
-    {
-      id: ProjectId.make("project-a"),
-      title: "Project A",
-      workspaceRoot: "/tmp/project-a",
-      defaultModelSelection: {
-        instanceId: ProviderInstanceId.make("codex"),
-        model: "gpt-5-codex",
-      },
-      scripts: [],
-      createdAt: now,
-      updatedAt: now,
-      deletedAt: null,
-    },
-    {
-      id: ProjectId.make("project-b"),
-      title: "Project B",
-      workspaceRoot: "/tmp/project-b",
-      defaultModelSelection: {
-        instanceId: ProviderInstanceId.make("codex"),
-        model: "gpt-5-codex",
-      },
-      scripts: [],
-      createdAt: now,
-      updatedAt: now,
-      deletedAt: null,
-    },
-  ],
-  threads: [
-    {
-      id: ThreadId.make("thread-1"),
-      projectId: ProjectId.make("project-a"),
-      title: "Thread A",
-      modelSelection: {
-        instanceId: ProviderInstanceId.make("codex"),
-        model: "gpt-5-codex",
-      },
-      interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-      runtimeMode: "full-access",
-      branch: null,
-      worktreePath: null,
-      createdAt: now,
-      updatedAt: now,
-      archivedAt: null,
-      settledOverride: null,
-      settledAt: null,
-      latestTurn: null,
-      messages: [],
-      session: null,
-      activities: [],
-      proposedPlans: [],
-      checkpoints: [],
-      deletedAt: null,
-    },
-    {
-      id: ThreadId.make("thread-2"),
-      projectId: ProjectId.make("project-b"),
-      title: "Thread B",
-      modelSelection: {
-        instanceId: ProviderInstanceId.make("codex"),
-        model: "gpt-5-codex",
-      },
-      interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-      runtimeMode: "full-access",
-      branch: null,
-      worktreePath: null,
-      createdAt: now,
-      updatedAt: now,
-      archivedAt: null,
-      settledOverride: null,
-      settledAt: null,
-      latestTurn: null,
-      messages: [],
-      session: null,
-      activities: [],
-      proposedPlans: [],
-      checkpoints: [],
-      deletedAt: null,
-    },
-  ],
-};
-
-const messageSendCommand: OrchestrationCommand = {
-  type: "thread.turn.start",
-  commandId: CommandId.make("cmd-1"),
-  threadId: ThreadId.make("thread-1"),
-  message: {
-    messageId: MessageId.make("msg-1"),
-    role: "user",
-    text: "hello",
-    attachments: [],
-  },
-  interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-  runtimeMode: "approval-required",
-  createdAt: now,
-};
-
-describe("commandInvariants", () => {
-  it("finds threads by id and project", () => {
-    expect(findThreadById(readModel, ThreadId.make("thread-1"))?.projectId).toBe("project-a");
-    expect(findThreadById(readModel, ThreadId.make("missing"))).toBeUndefined();
-    expect(
-      listThreadsByProjectId(readModel, ProjectId.make("project-b")).map((thread) => thread.id),
-    ).toEqual([ThreadId.make("thread-2")]);
-  });
-
-  it("requires existing thread", async () => {
-    const thread = await Effect.runPromise(
-      requireThread({
-        readModel,
-        command: messageSendCommand,
-        threadId: ThreadId.make("thread-1"),
-      }),
-    );
-    expect(thread.id).toBe(ThreadId.make("thread-1"));
-
-    await expect(
-      Effect.runPromise(
-        requireThread({
-          readModel,
-          command: messageSendCommand,
-          threadId: ThreadId.make("missing"),
-        }),
-      ),
-    ).rejects.toThrow("does not exist");
-  });
-
-  it("requires missing thread for create flows", async () => {
-    await Effect.runPromise(
-      requireThreadAbsent({
-        readModel,
-        command: {
-          type: "thread.create",
-          commandId: CommandId.make("cmd-2"),
-          threadId: ThreadId.make("thread-3"),
-          projectId: ProjectId.make("project-a"),
-          title: "new",
-          modelSelection: {
-            instanceId: ProviderInstanceId.make("codex"),
-            model: "gpt-5-codex",
-          },
-          interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-          runtimeMode: "full-access",
-          branch: null,
-          worktreePath: null,
-          createdAt: now,
-        },
-        threadId: ThreadId.make("thread-3"),
-      }),
-    );
-
-    await expect(
-      Effect.runPromise(
-        requireThreadAbsent({
-          readModel,
-          command: {
-            type: "thread.create",
-            commandId: CommandId.make("cmd-3"),
-            threadId: ThreadId.make("thread-1"),
-            projectId: ProjectId.make("project-a"),
-            title: "dup",
-            modelSelection: {
-              instanceId: ProviderInstanceId.make("codex"),
-              model: "gpt-5-codex",
-            },
-            interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-            runtimeMode: "full-access",
-            branch: null,
-            worktreePath: null,
-            createdAt: now,
-          },
-          threadId: ThreadId.make("thread-1"),
-        }),
-      ),
-    ).rejects.toThrow("already exists");
-  });
-
-  it("lets a draft retry re-create a thread id after its first attempt was deleted", async () => {
-    const threadId = ThreadId.make("thread-1");
-    const firstAttempt = readModel.threads.find((thread) => thread.id === threadId)!;
-    const afterRollback: OrchestrationReadModel = {
-      ...readModel,
-      threads: readModel.threads.map((thread) =>
-        thread.id === threadId ? { ...thread, deletedAt: now, updatedAt: now } : thread,
-      ),
-    };
-    const retry: OrchestrationCommand = {
-      type: "thread.create",
-      commandId: CommandId.make("cmd-retry"),
-      threadId,
-      projectId: firstAttempt.projectId,
-      title: firstAttempt.title,
-      modelSelection: firstAttempt.modelSelection,
-      interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-      runtimeMode: "approval-required",
-      branch: null,
-      worktreePath: null,
-      createdAt: now,
-    };
-
-    await expect(
-      Effect.runPromise(
-        requireThreadAbsent({ readModel: afterRollback, command: retry, threadId }),
-      ),
-    ).resolves.toBeUndefined();
-  });
-});
diff --git a/apps/server/src/orchestration/commandInvariants.ts b/apps/server/src/orchestration/commandInvariants.ts
index 8f1e3e89851c..88583f430381 100644
--- a/apps/server/src/orchestration/commandInvariants.ts
+++ b/apps/server/src/orchestration/commandInvariants.ts
@@ -1,11 +1,10 @@
+import type { ProjectId, ThreadId } from "@t3tools/contracts";
 import type {
   OrchestrationCommand,
   OrchestrationProject,
   OrchestrationReadModel,
   OrchestrationThread,
-  ProjectId,
-  ThreadId,
-} from "@t3tools/contracts";
+} from "@t3tools/contracts/legacy-orchestration";
 import { normalizeProjectPathForComparison } from "@t3tools/shared/path";
 import * as Effect from "effect/Effect";
 
diff --git a/apps/server/src/orchestration/decider.delete.test.ts b/apps/server/src/orchestration/decider.delete.test.ts
deleted file mode 100644
index fea36b5717fe..000000000000
--- a/apps/server/src/orchestration/decider.delete.test.ts
+++ /dev/null
@@ -1,217 +0,0 @@
-import {
-  CommandId,
-  DEFAULT_PROVIDER_INTERACTION_MODE,
-  EventId,
-  ProjectId,
-  ThreadId,
-  type OrchestrationCommand,
-  type OrchestrationEvent,
-  ProviderInstanceId,
-} from "@t3tools/contracts";
-import * as Effect from "effect/Effect";
-import * as NodeServices from "@effect/platform-node/NodeServices";
-import { expect, it } from "@effect/vitest";
-
-import { decideOrchestrationCommand } from "./decider.ts";
-import { createEmptyReadModel, projectEvent } from "./projector.ts";
-
-const asCommandId = (value: string): CommandId => CommandId.make(value);
-const asEventId = (value: string): EventId => EventId.make(value);
-const asProjectId = (value: string): ProjectId => ProjectId.make(value);
-const asThreadId = (value: string): ThreadId => ThreadId.make(value);
-
-const seedReadModel = Effect.gen(function* () {
-  const now = "2026-01-01T00:00:00.000Z";
-  const initial = createEmptyReadModel(now);
-  const withProject = yield* projectEvent(initial, {
-    sequence: 1,
-    eventId: asEventId("evt-project-create"),
-    aggregateKind: "project",
-    aggregateId: asProjectId("project-delete"),
-    type: "project.created",
-    occurredAt: now,
-    commandId: asCommandId("cmd-project-create"),
-    causationEventId: null,
-    correlationId: asCommandId("cmd-project-create"),
-    metadata: {},
-    payload: {
-      projectId: asProjectId("project-delete"),
-      title: "Project Delete",
-      workspaceRoot: "/tmp/project-delete",
-      defaultModelSelection: null,
-      scripts: [],
-      createdAt: now,
-      updatedAt: now,
-    },
-  });
-
-  const withFirstThread = yield* projectEvent(withProject, {
-    sequence: 2,
-    eventId: asEventId("evt-thread-create-1"),
-    aggregateKind: "thread",
-    aggregateId: asThreadId("thread-delete-1"),
-    type: "thread.created",
-    occurredAt: now,
-    commandId: asCommandId("cmd-thread-create-1"),
-    causationEventId: null,
-    correlationId: asCommandId("cmd-thread-create-1"),
-    metadata: {},
-    payload: {
-      threadId: asThreadId("thread-delete-1"),
-      projectId: asProjectId("project-delete"),
-      title: "Thread Delete 1",
-      modelSelection: {
-        instanceId: ProviderInstanceId.make("codex"),
-        model: "gpt-5-codex",
-      },
-      interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-      runtimeMode: "approval-required",
-      branch: null,
-      worktreePath: null,
-      createdAt: now,
-      updatedAt: now,
-    },
-  });
-
-  return yield* projectEvent(withFirstThread, {
-    sequence: 3,
-    eventId: asEventId("evt-thread-create-2"),
-    aggregateKind: "thread",
-    aggregateId: asThreadId("thread-delete-2"),
-    type: "thread.created",
-    occurredAt: now,
-    commandId: asCommandId("cmd-thread-create-2"),
-    causationEventId: null,
-    correlationId: asCommandId("cmd-thread-create-2"),
-    metadata: {},
-    payload: {
-      threadId: asThreadId("thread-delete-2"),
-      projectId: asProjectId("project-delete"),
-      title: "Thread Delete 2",
-      modelSelection: {
-        instanceId: ProviderInstanceId.make("codex"),
-        model: "gpt-5-codex",
-      },
-      interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-      runtimeMode: "approval-required",
-      branch: null,
-      worktreePath: null,
-      createdAt: now,
-      updatedAt: now,
-    },
-  });
-});
-
-type PlannedEvent = Omit<OrchestrationEvent, "sequence">;
-
-function normalizeDeleteEvent(event: PlannedEvent | ReadonlyArray<PlannedEvent>) {
-  const events = Array.isArray(event) ? event : [event];
-  return events.map((entry) => {
-    switch (entry.type) {
-      case "thread.deleted":
-        return {
-          type: entry.type,
-          aggregateKind: entry.aggregateKind,
-          aggregateId: entry.aggregateId,
-          commandId: entry.commandId,
-          correlationId: entry.correlationId,
-          payload: {
-            threadId: entry.payload.threadId,
-          },
-        };
-      case "project.deleted":
-        return {
-          type: entry.type,
-          aggregateKind: entry.aggregateKind,
-          aggregateId: entry.aggregateId,
-          commandId: entry.commandId,
-          correlationId: entry.correlationId,
-          payload: {
-            projectId: entry.payload.projectId,
-          },
-        };
-      default:
-        return entry;
-    }
-  });
-}
-
-it.layer(NodeServices.layer)("decider deletion flows", (it) => {
-  it.effect("rejects deleting a non-empty project without force", () =>
-    Effect.gen(function* () {
-      const readModel = yield* seedReadModel;
-      const error = yield* Effect.flip(
-        decideOrchestrationCommand({
-          command: {
-            type: "project.delete",
-            commandId: asCommandId("cmd-project-delete-no-force"),
-            projectId: asProjectId("project-delete"),
-          },
-          readModel,
-        }),
-      );
-      expect(error.message).toContain("cannot be deleted without force=true");
-    }),
-  );
-
-  it.effect("reuses thread.delete semantics when force-deleting a non-empty project", () =>
-    Effect.gen(function* () {
-      const readModel = yield* seedReadModel;
-      const projectDeleteCommand: Extract<OrchestrationCommand, { type: "project.delete" }> = {
-        type: "project.delete",
-        commandId: asCommandId("cmd-project-delete-force"),
-        projectId: asProjectId("project-delete"),
-        force: true,
-      };
-
-      const forcedResult = yield* decideOrchestrationCommand({
-        command: projectDeleteCommand,
-        readModel,
-      });
-      const forcedEvents = Array.isArray(forcedResult) ? forcedResult : [forcedResult];
-
-      expect(forcedEvents.map((event) => event.type)).toEqual([
-        "thread.deleted",
-        "thread.deleted",
-        "project.deleted",
-      ]);
-
-      let sequentialReadModel = readModel;
-      let nextSequence = readModel.snapshotSequence;
-      const sequentialEvents: PlannedEvent[] = [];
-      for (const nextCommand of [
-        {
-          type: "thread.delete",
-          commandId: projectDeleteCommand.commandId,
-          threadId: asThreadId("thread-delete-1"),
-        },
-        {
-          type: "thread.delete",
-          commandId: projectDeleteCommand.commandId,
-          threadId: asThreadId("thread-delete-2"),
-        },
-        {
-          type: "project.delete",
-          commandId: projectDeleteCommand.commandId,
-          projectId: asProjectId("project-delete"),
-        },
-      ] satisfies ReadonlyArray<OrchestrationCommand>) {
-        const decided = yield* decideOrchestrationCommand({
-          command: nextCommand,
-          readModel: sequentialReadModel,
-        });
-        const nextEvents = Array.isArray(decided) ? decided : [decided];
-        sequentialEvents.push(...nextEvents);
-        for (const nextEvent of nextEvents) {
-          nextSequence += 1;
-          sequentialReadModel = yield* projectEvent(sequentialReadModel, {
-            ...nextEvent,
-            sequence: nextSequence,
-          });
-        }
-      }
-
-      expect(normalizeDeleteEvent(forcedResult)).toEqual(normalizeDeleteEvent(sequentialEvents));
-    }),
-  );
-});
diff --git a/apps/server/src/orchestration/decider.ts b/apps/server/src/orchestration/decider.ts
index f3fdd462f437..197437054074 100644
--- a/apps/server/src/orchestration/decider.ts
+++ b/apps/server/src/orchestration/decider.ts
@@ -1,9 +1,9 @@
+import { EventId } from "@t3tools/contracts";
 import {
-  EventId,
   type OrchestrationCommand,
   type OrchestrationEvent,
   type OrchestrationReadModel,
-} from "@t3tools/contracts";
+} from "@t3tools/contracts/legacy-orchestration";
 import * as DateTime from "effect/DateTime";
 import * as Crypto from "effect/Crypto";
 import * as Effect from "effect/Effect";
@@ -251,7 +251,7 @@ export const decideOrchestrationCommand = Effect.fn("decideOrchestrationCommand"
           workspaceRoot: command.workspaceRoot,
           defaultModelSelection: command.defaultModelSelection ?? null,
           faviconPath: null,
-          scripts: [],
+          scripts: command.scripts ?? [],
           createdAt: command.createdAt,
           updatedAt: command.createdAt,
         },
diff --git a/apps/server/src/orchestration/http.ts b/apps/server/src/orchestration/http.ts
deleted file mode 100644
index f7147106c7a9..000000000000
--- a/apps/server/src/orchestration/http.ts
+++ /dev/null
@@ -1,110 +0,0 @@
-import {
-  AuthOrchestrationOperateScope,
-  AuthOrchestrationReadScope,
-  EnvironmentHttpApi,
-} from "@t3tools/contracts";
-import * as Effect from "effect/Effect";
-import * as Option from "effect/Option";
-import * as HttpApiBuilder from "effect/unstable/httpapi/HttpApiBuilder";
-
-import { projectThreadDetailSnapshot } from "./ActivityPayloadProjection.ts";
-import { cleanupFailedUploadedAttachments, normalizeDispatchCommand } from "./Normalizer.ts";
-import {
-  annotateEnvironmentRequest,
-  failEnvironmentInternal,
-  failEnvironmentInvalidRequest,
-  failEnvironmentNotFound,
-  requireEnvironmentScope,
-} from "../auth/http.ts";
-import { OrchestrationEngineService } from "./Services/OrchestrationEngine.ts";
-import { ProjectionSnapshotQuery } from "./Services/ProjectionSnapshotQuery.ts";
-
-export const orchestrationHttpApiLayer = HttpApiBuilder.group(
-  EnvironmentHttpApi,
-  "orchestration",
-  Effect.fnUntraced(function* (handlers) {
-    const projectionSnapshotQuery = yield* ProjectionSnapshotQuery;
-    const orchestrationEngine = yield* OrchestrationEngineService;
-
-    return handlers
-      .handle(
-        "snapshot",
-        Effect.fn("environment.orchestration.snapshot")(function* (args) {
-          yield* annotateEnvironmentRequest(args.endpoint.name);
-          yield* requireEnvironmentScope(AuthOrchestrationReadScope);
-          // Serve the lightweight command read model (thread bodies empty)
-          // instead of the fully hydrated snapshot. Hydrating every message
-          // and activity payload in the database has OOM-killed servers, and
-          // the route's only consumer (the project CLI) reads projects alone —
-          // UI clients load the shell and per-thread snapshots instead.
-          return yield* projectionSnapshotQuery
-            .getCommandReadModel()
-            .pipe(
-              Effect.catch((cause) =>
-                failEnvironmentInternal("orchestration_snapshot_failed", cause),
-              ),
-            );
-        }),
-      )
-      .handle(
-        "shellSnapshot",
-        Effect.fn("environment.orchestration.shellSnapshot")(function* (args) {
-          yield* annotateEnvironmentRequest(args.endpoint.name);
-          yield* requireEnvironmentScope(AuthOrchestrationReadScope);
-          return yield* projectionSnapshotQuery
-            .getShellSnapshot()
-            .pipe(
-              Effect.catch((cause) =>
-                failEnvironmentInternal("orchestration_snapshot_failed", cause),
-              ),
-            );
-        }),
-      )
-      .handle(
-        "threadSnapshot",
-        Effect.fn("environment.orchestration.threadSnapshot")(function* (args) {
-          yield* annotateEnvironmentRequest(args.endpoint.name);
-          yield* requireEnvironmentScope(AuthOrchestrationReadScope);
-          const snapshot = yield* projectionSnapshotQuery
-            .getThreadDetailSnapshot(
-              args.params.threadId,
-              args.payload.turnLimit === undefined
-                ? undefined
-                : {
-                    turnLimit: args.payload.turnLimit,
-                    ...(args.payload.beforeCursor !== undefined
-                      ? { beforeCursor: args.payload.beforeCursor }
-                      : {}),
-                  },
-            )
-            .pipe(
-              Effect.catch((cause) =>
-                failEnvironmentInternal("orchestration_thread_snapshot_failed", cause),
-              ),
-            );
-          if (Option.isNone(snapshot)) {
-            return yield* failEnvironmentNotFound("thread_not_found");
-          }
-          return projectThreadDetailSnapshot(snapshot.value);
-        }),
-      )
-      .handle(
-        "dispatch",
-        Effect.fn("environment.orchestration.dispatch")(function* (args) {
-          yield* annotateEnvironmentRequest(args.endpoint.name);
-          yield* requireEnvironmentScope(AuthOrchestrationOperateScope);
-          const normalizedCommand = yield* normalizeDispatchCommand(args.payload).pipe(
-            Effect.catch(() => failEnvironmentInvalidRequest("invalid_command")),
-          );
-          return yield* orchestrationEngine.dispatch(normalizedCommand).pipe(
-            Effect.tapError(() =>
-              cleanupFailedUploadedAttachments(args.payload, normalizedCommand),
-            ),
-            Effect.catch((cause) =>
-              failEnvironmentInternal("orchestration_dispatch_failed", cause),
-            ),
-          );
-        }),
-      );
-  }),
-);
diff --git a/apps/server/src/orchestration/projector.test.ts b/apps/server/src/orchestration/projector.test.ts
deleted file mode 100644
index dad3d07370f9..000000000000
--- a/apps/server/src/orchestration/projector.test.ts
+++ /dev/null
@@ -1,960 +0,0 @@
-import {
-  CommandId,
-  EventId,
-  ProjectId,
-  ProviderDriverKind,
-  ThreadId,
-  type OrchestrationEvent,
-} from "@t3tools/contracts";
-import * as Effect from "effect/Effect";
-import { describe, expect, it } from "vite-plus/test";
-
-import { createEmptyReadModel, projectEvent } from "./projector.ts";
-
-function makeEvent(input: {
-  sequence: number;
-  type: OrchestrationEvent["type"];
-  occurredAt: string;
-  aggregateKind: OrchestrationEvent["aggregateKind"];
-  aggregateId: string;
-  commandId: string | null;
-  payload: unknown;
-}): OrchestrationEvent {
-  return {
-    sequence: input.sequence,
-    eventId: EventId.make(`event-${input.sequence}`),
-    type: input.type,
-    aggregateKind: input.aggregateKind,
-    aggregateId:
-      input.aggregateKind === "project"
-        ? ProjectId.make(input.aggregateId)
-        : ThreadId.make(input.aggregateId),
-    occurredAt: input.occurredAt,
-    commandId: input.commandId === null ? null : CommandId.make(input.commandId),
-    causationEventId: null,
-    correlationId: null,
-    metadata: {},
-    payload: input.payload as never,
-  } as OrchestrationEvent;
-}
-
-describe("orchestration projector", () => {
-  it("applies thread.created events", async () => {
-    const now = "2026-01-01T00:00:00.000Z";
-    const model = createEmptyReadModel(now);
-
-    const next = await Effect.runPromise(
-      projectEvent(
-        model,
-        makeEvent({
-          sequence: 1,
-          type: "thread.created",
-          aggregateKind: "thread",
-          aggregateId: "thread-1",
-          occurredAt: now,
-          commandId: "cmd-thread-create",
-          payload: {
-            threadId: "thread-1",
-            projectId: "project-1",
-            title: "demo",
-            modelSelection: {
-              provider: ProviderDriverKind.make("codex"),
-              model: "gpt-5-codex",
-            },
-            runtimeMode: "full-access",
-            branch: null,
-            worktreePath: null,
-            createdAt: now,
-            updatedAt: now,
-          },
-        }),
-      ),
-    );
-
-    expect(next.snapshotSequence).toBe(1);
-    expect(next.threads).toEqual([
-      {
-        id: "thread-1",
-        projectId: "project-1",
-        title: "demo",
-        modelSelection: {
-          instanceId: "codex",
-          model: "gpt-5-codex",
-        },
-        runtimeMode: "full-access",
-        interactionMode: "default",
-        branch: null,
-        worktreePath: null,
-        latestTurn: null,
-        createdAt: now,
-        updatedAt: now,
-        archivedAt: null,
-        settledOverride: null,
-        settledAt: null,
-        unsettledAt: null,
-        snoozedUntil: null,
-        snoozedAt: null,
-        deletedAt: null,
-        messages: [],
-        proposedPlans: [],
-        activities: [],
-        checkpoints: [],
-        session: null,
-      },
-    ]);
-  });
-
-  it("fails when event payload cannot be decoded by runtime schema", async () => {
-    const now = "2026-01-01T00:00:00.000Z";
-    const model = createEmptyReadModel(now);
-
-    await expect(
-      Effect.runPromise(
-        projectEvent(
-          model,
-          makeEvent({
-            sequence: 1,
-            type: "thread.created",
-            aggregateKind: "thread",
-            aggregateId: "thread-1",
-            occurredAt: now,
-            commandId: "cmd-invalid",
-            payload: {
-              // missing required threadId
-              projectId: "project-1",
-              title: "demo",
-              modelSelection: {
-                provider: ProviderDriverKind.make("codex"),
-                model: "gpt-5-codex",
-              },
-              branch: null,
-              worktreePath: null,
-              createdAt: now,
-              updatedAt: now,
-            },
-          }),
-        ),
-      ),
-    ).rejects.toBeDefined();
-  });
-
-  it("applies thread.archived and thread.unarchived events", async () => {
-    const now = "2026-01-01T00:00:00.000Z";
-    const later = "2026-01-01T00:00:01.000Z";
-    const created = await Effect.runPromise(
-      projectEvent(
-        createEmptyReadModel(now),
-        makeEvent({
-          sequence: 1,
-          type: "thread.created",
-          aggregateKind: "thread",
-          aggregateId: "thread-1",
-          occurredAt: now,
-          commandId: "cmd-thread-create",
-          payload: {
-            threadId: "thread-1",
-            projectId: "project-1",
-            title: "demo",
-            modelSelection: {
-              provider: ProviderDriverKind.make("codex"),
-              model: "gpt-5-codex",
-            },
-            runtimeMode: "full-access",
-            interactionMode: "default",
-            branch: null,
-            worktreePath: null,
-            createdAt: now,
-            updatedAt: now,
-          },
-        }),
-      ),
-    );
-
-    const archived = await Effect.runPromise(
-      projectEvent(
-        created,
-        makeEvent({
-          sequence: 2,
-          type: "thread.archived",
-          aggregateKind: "thread",
-          aggregateId: "thread-1",
-          occurredAt: later,
-          commandId: "cmd-thread-archive",
-          payload: {
-            threadId: "thread-1",
-            archivedAt: later,
-            updatedAt: later,
-          },
-        }),
-      ),
-    );
-    expect(archived.threads[0]?.archivedAt).toBe(later);
-
-    const unarchived = await Effect.runPromise(
-      projectEvent(
-        archived,
-        makeEvent({
-          sequence: 3,
-          type: "thread.unarchived",
-          aggregateKind: "thread",
-          aggregateId: "thread-1",
-          occurredAt: later,
-          commandId: "cmd-thread-unarchive",
-          payload: {
-            threadId: "thread-1",
-            updatedAt: later,
-          },
-        }),
-      ),
-    );
-    expect(unarchived.threads[0]?.archivedAt).toBeNull();
-  });
-
-  it("keeps projector forward-compatible for unhandled event types", async () => {
-    const now = "2026-01-01T00:00:00.000Z";
-    const model = createEmptyReadModel(now);
-
-    const next = await Effect.runPromise(
-      projectEvent(
-        model,
-        makeEvent({
-          sequence: 7,
-          type: "thread.turn-start-requested",
-          aggregateKind: "thread",
-          aggregateId: "thread-1",
-          occurredAt: "2026-01-01T00:00:00.000Z",
-          commandId: "cmd-unhandled",
-          payload: {
-            threadId: "thread-1",
-            messageId: "message-1",
-            runtimeMode: "approval-required",
-            createdAt: "2026-01-01T00:00:00.000Z",
-          },
-        }),
-      ),
-    );
-
-    expect(next.snapshotSequence).toBe(7);
-    expect(next.updatedAt).toBe("2026-01-01T00:00:00.000Z");
-    expect(next.threads).toEqual([]);
-  });
-
-  it("tracks latest turn id from session lifecycle events", async () => {
-    const createdAt = "2026-02-23T08:00:00.000Z";
-    const startedAt = "2026-02-23T08:00:05.000Z";
-    const model = createEmptyReadModel(createdAt);
-
-    const afterCreate = await Effect.runPromise(
-      projectEvent(
-        model,
-        makeEvent({
-          sequence: 1,
-          type: "thread.created",
-          aggregateKind: "thread",
-          aggregateId: "thread-1",
-          occurredAt: createdAt,
-          commandId: "cmd-create",
-          payload: {
-            threadId: "thread-1",
-            projectId: "project-1",
-            title: "demo",
-            modelSelection: {
-              provider: ProviderDriverKind.make("codex"),
-              model: "gpt-5.3-codex",
-            },
-            runtimeMode: "full-access",
-            branch: null,
-            worktreePath: null,
-            createdAt,
-            updatedAt: createdAt,
-          },
-        }),
-      ),
-    );
-
-    const settledAt = "2026-02-23T08:01:00.000Z";
-    const [afterRunning, afterReady] = await Effect.runPromise(
-      Effect.flatMap(
-        projectEvent(
-          afterCreate,
-          makeEvent({
-            sequence: 2,
-            type: "thread.session-set",
-            aggregateKind: "thread",
-            aggregateId: "thread-1",
-            occurredAt: startedAt,
-            commandId: "cmd-running",
-            payload: {
-              threadId: "thread-1",
-              session: {
-                threadId: "thread-1",
-                status: "running",
-                providerName: "codex",
-                providerSessionId: "session-1",
-                providerThreadId: "provider-thread-1",
-                runtimeMode: "approval-required",
-                activeTurnId: "turn-1",
-                lastError: null,
-                updatedAt: startedAt,
-              },
-            },
-          }),
-        ),
-        (running) =>
-          Effect.map(
-            projectEvent(
-              running,
-              makeEvent({
-                sequence: 3,
-                type: "thread.session-set",
-                aggregateKind: "thread",
-                aggregateId: "thread-1",
-                occurredAt: settledAt,
-                commandId: "cmd-ready",
-                payload: {
-                  threadId: "thread-1",
-                  session: {
-                    threadId: "thread-1",
-                    status: "ready",
-                    providerName: "codex",
-                    providerSessionId: "session-1",
-                    providerThreadId: "provider-thread-1",
-                    runtimeMode: "approval-required",
-                    activeTurnId: null,
-                    lastError: null,
-                    updatedAt: settledAt,
-                  },
-                },
-              }),
-            ),
-            (ready) => [running, ready] as const,
-          ),
-      ),
-    );
-
-    const thread = afterRunning.threads[0];
-    expect(thread?.latestTurn?.turnId).toBe("turn-1");
-    expect(thread?.session?.status).toBe("running");
-
-    // Leaving the "running" session status settles the running turn with the
-    // session timestamp as the turn end.
-    const settledThread = afterReady.threads[0];
-    expect(settledThread?.latestTurn?.turnId).toBe("turn-1");
-    expect(settledThread?.latestTurn?.state).toBe("completed");
-    expect(settledThread?.latestTurn?.completedAt).toBe(settledAt);
-  });
-
-  it("updates canonical thread runtime mode from thread.runtime-mode-set", async () => {
-    const createdAt = "2026-02-23T08:00:00.000Z";
-    const updatedAt = "2026-02-23T08:00:05.000Z";
-    const model = createEmptyReadModel(createdAt);
-
-    const afterCreate = await Effect.runPromise(
-      projectEvent(
-        model,
-        makeEvent({
-          sequence: 1,
-          type: "thread.created",
-          aggregateKind: "thread",
-          aggregateId: "thread-1",
-          occurredAt: createdAt,
-          commandId: "cmd-create",
-          payload: {
-            threadId: "thread-1",
-            projectId: "project-1",
-            title: "demo",
-            modelSelection: {
-              provider: ProviderDriverKind.make("codex"),
-              model: "gpt-5.3-codex",
-            },
-            runtimeMode: "full-access",
-            branch: null,
-            worktreePath: null,
-            createdAt,
-            updatedAt: createdAt,
-          },
-        }),
-      ),
-    );
-
-    const afterUpdate = await Effect.runPromise(
-      projectEvent(
-        afterCreate,
-        makeEvent({
-          sequence: 2,
-          type: "thread.runtime-mode-set",
-          aggregateKind: "thread",
-          aggregateId: "thread-1",
-          occurredAt: updatedAt,
-          commandId: "cmd-runtime-mode-set",
-          payload: {
-            threadId: "thread-1",
-            runtimeMode: "approval-required",
-            updatedAt,
-          },
-        }),
-      ),
-    );
-
-    expect(afterUpdate.threads[0]?.runtimeMode).toBe("approval-required");
-    expect(afterUpdate.threads[0]?.updatedAt).toBe(updatedAt);
-  });
-
-  it("marks assistant messages completed with non-streaming updates", async () => {
-    const createdAt = "2026-02-23T09:00:00.000Z";
-    const deltaAt = "2026-02-23T09:00:01.000Z";
-    const completeAt = "2026-02-23T09:00:03.500Z";
-    const model = createEmptyReadModel(createdAt);
-
-    const afterCreate = await Effect.runPromise(
-      projectEvent(
-        model,
-        makeEvent({
-          sequence: 1,
-          type: "thread.created",
-          aggregateKind: "thread",
-          aggregateId: "thread-1",
-          occurredAt: createdAt,
-          commandId: "cmd-create",
-          payload: {
-            threadId: "thread-1",
-            projectId: "project-1",
-            title: "demo",
-            modelSelection: {
-              provider: ProviderDriverKind.make("codex"),
-              model: "gpt-5.3-codex",
-            },
-            runtimeMode: "full-access",
-            branch: null,
-            worktreePath: null,
-            createdAt,
-            updatedAt: createdAt,
-          },
-        }),
-      ),
-    );
-
-    const afterDelta = await Effect.runPromise(
-      projectEvent(
-        afterCreate,
-        makeEvent({
-          sequence: 2,
-          type: "thread.message-sent",
-          aggregateKind: "thread",
-          aggregateId: "thread-1",
-          occurredAt: deltaAt,
-          commandId: "cmd-delta",
-          payload: {
-            threadId: "thread-1",
-            messageId: "assistant:msg-1",
-            role: "assistant",
-            text: "hello",
-            turnId: "turn-1",
-            streaming: true,
-            createdAt: deltaAt,
-            updatedAt: deltaAt,
-          },
-        }),
-      ),
-    );
-
-    const afterComplete = await Effect.runPromise(
-      projectEvent(
-        afterDelta,
-        makeEvent({
-          sequence: 3,
-          type: "thread.message-sent",
-          aggregateKind: "thread",
-          aggregateId: "thread-1",
-          occurredAt: completeAt,
-          commandId: "cmd-complete",
-          payload: {
-            threadId: "thread-1",
-            messageId: "assistant:msg-1",
-            role: "assistant",
-            text: "",
-            turnId: "turn-1",
-            streaming: false,
-            createdAt: completeAt,
-            updatedAt: completeAt,
-          },
-        }),
-      ),
-    );
-
-    const message = afterComplete.threads[0]?.messages[0];
-    expect(message?.id).toBe("assistant:msg-1");
-    expect(message?.text).toBe("hello");
-    expect(message?.streaming).toBe(false);
-    expect(message?.updatedAt).toBe(completeAt);
-  });
-
-  it("prunes reverted turn messages from in-memory thread snapshot", async () => {
-    const createdAt = "2026-02-23T10:00:00.000Z";
-    const model = createEmptyReadModel(createdAt);
-
-    const afterCreate = await Effect.runPromise(
-      projectEvent(
-        model,
-        makeEvent({
-          sequence: 1,
-          type: "thread.created",
-          aggregateKind: "thread",
-          aggregateId: "thread-1",
-          occurredAt: createdAt,
-          commandId: "cmd-create",
-          payload: {
-            threadId: "thread-1",
-            projectId: "project-1",
-            title: "demo",
-            modelSelection: {
-              provider: ProviderDriverKind.make("codex"),
-              model: "gpt-5.3-codex",
-            },
-            runtimeMode: "full-access",
-            branch: null,
-            worktreePath: null,
-            createdAt,
-            updatedAt: createdAt,
-          },
-        }),
-      ),
-    );
-
-    const events: ReadonlyArray<OrchestrationEvent> = [
-      makeEvent({
-        sequence: 2,
-        type: "thread.message-sent",
-        aggregateKind: "thread",
-        aggregateId: "thread-1",
-        occurredAt: "2026-02-23T10:00:01.000Z",
-        commandId: "cmd-user-1",
-        payload: {
-          threadId: "thread-1",
-          messageId: "user-msg-1",
-          role: "user",
-          text: "First edit",
-          turnId: null,
-          streaming: false,
-          createdAt: "2026-02-23T10:00:01.000Z",
-          updatedAt: "2026-02-23T10:00:01.000Z",
-        },
-      }),
-      makeEvent({
-        sequence: 3,
-        type: "thread.message-sent",
-        aggregateKind: "thread",
-        aggregateId: "thread-1",
-        occurredAt: "2026-02-23T10:00:02.000Z",
-        commandId: "cmd-assistant-1",
-        payload: {
-          threadId: "thread-1",
-          messageId: "assistant-msg-1",
-          role: "assistant",
-          text: "Updated README to v2.\n",
-          turnId: "turn-1",
-          streaming: false,
-          createdAt: "2026-02-23T10:00:02.000Z",
-          updatedAt: "2026-02-23T10:00:02.000Z",
-        },
-      }),
-      makeEvent({
-        sequence: 4,
-        type: "thread.turn-diff-completed",
-        aggregateKind: "thread",
-        aggregateId: "thread-1",
-        occurredAt: "2026-02-23T10:00:02.500Z",
-        commandId: "cmd-turn-1-complete",
-        payload: {
-          threadId: "thread-1",
-          turnId: "turn-1",
-          checkpointTurnCount: 1,
-          checkpointRef: "refs/t3/checkpoints/thread-1/turn/1",
-          status: "ready",
-          files: [],
-          assistantMessageId: "assistant-msg-1",
-          completedAt: "2026-02-23T10:00:02.500Z",
-        },
-      }),
-      makeEvent({
-        sequence: 5,
-        type: "thread.activity-appended",
-        aggregateKind: "thread",
-        aggregateId: "thread-1",
-        occurredAt: "2026-02-23T10:00:02.750Z",
-        commandId: "cmd-activity-1",
-        payload: {
-          threadId: "thread-1",
-          activity: {
-            id: "activity-1",
-            tone: "tool",
-            kind: "tool.started",
-            summary: "Edit file started",
-            payload: { toolKind: "command" },
-            turnId: "turn-1",
-            createdAt: "2026-02-23T10:00:02.750Z",
-          },
-        },
-      }),
-      makeEvent({
-        sequence: 6,
-        type: "thread.message-sent",
-        aggregateKind: "thread",
-        aggregateId: "thread-1",
-        occurredAt: "2026-02-23T10:00:03.000Z",
-        commandId: "cmd-user-2",
-        payload: {
-          threadId: "thread-1",
-          messageId: "user-msg-2",
-          role: "user",
-          text: "Second edit",
-          turnId: null,
-          streaming: false,
-          createdAt: "2026-02-23T10:00:03.000Z",
-          updatedAt: "2026-02-23T10:00:03.000Z",
-        },
-      }),
-      makeEvent({
-        sequence: 7,
-        type: "thread.message-sent",
-        aggregateKind: "thread",
-        aggregateId: "thread-1",
-        occurredAt: "2026-02-23T10:00:04.000Z",
-        commandId: "cmd-assistant-2",
-        payload: {
-          threadId: "thread-1",
-          messageId: "assistant-msg-2",
-          role: "assistant",
-          text: "Updated README to v3.\n",
-          turnId: "turn-2",
-          streaming: false,
-          createdAt: "2026-02-23T10:00:04.000Z",
-          updatedAt: "2026-02-23T10:00:04.000Z",
-        },
-      }),
-      makeEvent({
-        sequence: 8,
-        type: "thread.turn-diff-completed",
-        aggregateKind: "thread",
-        aggregateId: "thread-1",
-        occurredAt: "2026-02-23T10:00:04.500Z",
-        commandId: "cmd-turn-2-complete",
-        payload: {
-          threadId: "thread-1",
-          turnId: "turn-2",
-          checkpointTurnCount: 2,
-          checkpointRef: "refs/t3/checkpoints/thread-1/turn/2",
-          status: "ready",
-          files: [],
-          assistantMessageId: "assistant-msg-2",
-          completedAt: "2026-02-23T10:00:04.500Z",
-        },
-      }),
-      makeEvent({
-        sequence: 9,
-        type: "thread.activity-appended",
-        aggregateKind: "thread",
-        aggregateId: "thread-1",
-        occurredAt: "2026-02-23T10:00:04.750Z",
-        commandId: "cmd-activity-2",
-        payload: {
-          threadId: "thread-1",
-          activity: {
-            id: "activity-2",
-            tone: "tool",
-            kind: "tool.completed",
-            summary: "Edit file complete",
-            payload: { toolKind: "command" },
-            turnId: "turn-2",
-            createdAt: "2026-02-23T10:00:04.750Z",
-          },
-        },
-      }),
-      makeEvent({
-        sequence: 10,
-        type: "thread.reverted",
-        aggregateKind: "thread",
-        aggregateId: "thread-1",
-        occurredAt: "2026-02-23T10:00:05.000Z",
-        commandId: "cmd-revert",
-        payload: {
-          threadId: "thread-1",
-          turnCount: 1,
-        },
-      }),
-    ];
-
-    const afterRevert = await events.reduce<Promise<ReturnType<typeof createEmptyReadModel>>>(
-      (statePromise, event) =>
-        statePromise.then((state) => Effect.runPromise(projectEvent(state, event))),
-      Promise.resolve(afterCreate),
-    );
-
-    const thread = afterRevert.threads[0];
-    expect(thread?.messages.map((message) => ({ role: message.role, text: message.text }))).toEqual(
-      [
-        { role: "user", text: "First edit" },
-        { role: "assistant", text: "Updated README to v2.\n" },
-      ],
-    );
-    expect(
-      thread?.activities.map((activity) => ({ id: activity.id, turnId: activity.turnId })),
-    ).toEqual([{ id: "activity-1", turnId: "turn-1" }]);
-    expect(thread?.checkpoints.map((checkpoint) => checkpoint.checkpointTurnCount)).toEqual([1]);
-    expect(thread?.latestTurn?.turnId).toBe("turn-1");
-  });
-
-  it("does not fallback-retain messages tied to removed turn IDs", async () => {
-    const createdAt = "2026-02-26T12:00:00.000Z";
-    const model = createEmptyReadModel(createdAt);
-
-    const afterCreate = await Effect.runPromise(
-      projectEvent(
-        model,
-        makeEvent({
-          sequence: 1,
-          type: "thread.created",
-          aggregateKind: "thread",
-          aggregateId: "thread-revert",
-          occurredAt: createdAt,
-          commandId: "cmd-create-revert",
-          payload: {
-            threadId: "thread-revert",
-            projectId: "project-1",
-            title: "demo",
-            modelSelection: {
-              provider: ProviderDriverKind.make("codex"),
-              model: "gpt-5.3-codex",
-            },
-            runtimeMode: "full-access",
-            branch: null,
-            worktreePath: null,
-            createdAt,
-            updatedAt: createdAt,
-          },
-        }),
-      ),
-    );
-
-    const events: ReadonlyArray<OrchestrationEvent> = [
-      makeEvent({
-        sequence: 2,
-        type: "thread.turn-diff-completed",
-        aggregateKind: "thread",
-        aggregateId: "thread-revert",
-        occurredAt: "2026-02-26T12:00:01.000Z",
-        commandId: "cmd-turn-1",
-        payload: {
-          threadId: "thread-revert",
-          turnId: "turn-1",
-          checkpointTurnCount: 1,
-          checkpointRef: "refs/t3/checkpoints/thread-revert/turn/1",
-          status: "ready",
-          files: [],
-          assistantMessageId: "assistant-keep",
-          completedAt: "2026-02-26T12:00:01.000Z",
-        },
-      }),
-      makeEvent({
-        sequence: 3,
-        type: "thread.message-sent",
-        aggregateKind: "thread",
-        aggregateId: "thread-revert",
-        occurredAt: "2026-02-26T12:00:01.100Z",
-        commandId: "cmd-assistant-keep",
-        payload: {
-          threadId: "thread-revert",
-          messageId: "assistant-keep",
-          role: "assistant",
-          text: "kept",
-          turnId: "turn-1",
-          streaming: false,
-          createdAt: "2026-02-26T12:00:01.100Z",
-          updatedAt: "2026-02-26T12:00:01.100Z",
-        },
-      }),
-      makeEvent({
-        sequence: 4,
-        type: "thread.turn-diff-completed",
-        aggregateKind: "thread",
-        aggregateId: "thread-revert",
-        occurredAt: "2026-02-26T12:00:02.000Z",
-        commandId: "cmd-turn-2",
-        payload: {
-          threadId: "thread-revert",
-          turnId: "turn-2",
-          checkpointTurnCount: 2,
-          checkpointRef: "refs/t3/checkpoints/thread-revert/turn/2",
-          status: "ready",
-          files: [],
-          assistantMessageId: "assistant-remove",
-          completedAt: "2026-02-26T12:00:02.000Z",
-        },
-      }),
-      makeEvent({
-        sequence: 5,
-        type: "thread.message-sent",
-        aggregateKind: "thread",
-        aggregateId: "thread-revert",
-        occurredAt: "2026-02-26T12:00:02.050Z",
-        commandId: "cmd-user-remove",
-        payload: {
-          threadId: "thread-revert",
-          messageId: "user-remove",
-          role: "user",
-          text: "removed",
-          turnId: "turn-2",
-          streaming: false,
-          createdAt: "2026-02-26T12:00:02.050Z",
-          updatedAt: "2026-02-26T12:00:02.050Z",
-        },
-      }),
-      makeEvent({
-        sequence: 6,
-        type: "thread.message-sent",
-        aggregateKind: "thread",
-        aggregateId: "thread-revert",
-        occurredAt: "2026-02-26T12:00:02.100Z",
-        commandId: "cmd-assistant-remove",
-        payload: {
-          threadId: "thread-revert",
-          messageId: "assistant-remove",
-          role: "assistant",
-          text: "removed",
-          turnId: "turn-2",
-          streaming: false,
-          createdAt: "2026-02-26T12:00:02.100Z",
-          updatedAt: "2026-02-26T12:00:02.100Z",
-        },
-      }),
-      makeEvent({
-        sequence: 7,
-        type: "thread.reverted",
-        aggregateKind: "thread",
-        aggregateId: "thread-revert",
-        occurredAt: "2026-02-26T12:00:03.000Z",
-        commandId: "cmd-revert",
-        payload: {
-          threadId: "thread-revert",
-          turnCount: 1,
-        },
-      }),
-    ];
-
-    const afterRevert = await events.reduce<Promise<ReturnType<typeof createEmptyReadModel>>>(
-      (statePromise, event) =>
-        statePromise.then((state) => Effect.runPromise(projectEvent(state, event))),
-      Promise.resolve(afterCreate),
-    );
-
-    const thread = afterRevert.threads[0];
-    expect(
-      thread?.messages.map((message) => ({
-        id: message.id,
-        role: message.role,
-        turnId: message.turnId,
-      })),
-    ).toEqual([{ id: "assistant-keep", role: "assistant", turnId: "turn-1" }]);
-  });
-
-  it("caps message and checkpoint retention for long-lived threads", async () => {
-    const createdAt = "2026-03-01T10:00:00.000Z";
-    const model = createEmptyReadModel(createdAt);
-
-    const afterCreate = await Effect.runPromise(
-      projectEvent(
-        model,
-        makeEvent({
-          sequence: 1,
-          type: "thread.created",
-          aggregateKind: "thread",
-          aggregateId: "thread-capped",
-          occurredAt: createdAt,
-          commandId: "cmd-create-capped",
-          payload: {
-            threadId: "thread-capped",
-            projectId: "project-1",
-            title: "capped",
-            modelSelection: {
-              provider: ProviderDriverKind.make("codex"),
-              model: "gpt-5-codex",
-            },
-            runtimeMode: "full-access",
-            branch: null,
-            worktreePath: null,
-            createdAt,
-            updatedAt: createdAt,
-          },
-        }),
-      ),
-    );
-
-    const messageEvents: ReadonlyArray<OrchestrationEvent> = Array.from(
-      { length: 2_100 },
-      (_, index) =>
-        makeEvent({
-          sequence: index + 2,
-          type: "thread.message-sent",
-          aggregateKind: "thread",
-          aggregateId: "thread-capped",
-          occurredAt: `2026-03-01T10:00:${String(index % 60).padStart(2, "0")}.000Z`,
-          commandId: `cmd-message-${index}`,
-          payload: {
-            threadId: "thread-capped",
-            messageId: `msg-${index}`,
-            role: "assistant",
-            text: `message-${index}`,
-            turnId: `turn-${index}`,
-            streaming: false,
-            createdAt: `2026-03-01T10:00:${String(index % 60).padStart(2, "0")}.000Z`,
-            updatedAt: `2026-03-01T10:00:${String(index % 60).padStart(2, "0")}.000Z`,
-          },
-        }),
-    );
-    const afterMessages = await messageEvents.reduce<
-      Promise<ReturnType<typeof createEmptyReadModel>>
-    >(
-      (statePromise, event) =>
-        statePromise.then((state) => Effect.runPromise(projectEvent(state, event))),
-      Promise.resolve(afterCreate),
-    );
-
-    const checkpointEvents: ReadonlyArray<OrchestrationEvent> = Array.from(
-      { length: 600 },
-      (_, index) =>
-        makeEvent({
-          sequence: index + 2_102,
-          type: "thread.turn-diff-completed",
-          aggregateKind: "thread",
-          aggregateId: "thread-capped",
-          occurredAt: `2026-03-01T10:30:${String(index % 60).padStart(2, "0")}.000Z`,
-          commandId: `cmd-checkpoint-${index}`,
-          payload: {
-            threadId: "thread-capped",
-            turnId: `turn-${index}`,
-            checkpointTurnCount: index + 1,
-            checkpointRef: `refs/t3/checkpoints/thread-capped/turn/${index + 1}`,
-            status: "ready",
-            files: [],
-            assistantMessageId: `msg-${index}`,
-            completedAt: `2026-03-01T10:30:${String(index % 60).padStart(2, "0")}.000Z`,
-          },
-        }),
-    );
-    const finalState = await checkpointEvents.reduce<
-      Promise<ReturnType<typeof createEmptyReadModel>>
-    >(
-      (statePromise, event) =>
-        statePromise.then((state) => Effect.runPromise(projectEvent(state, event))),
-      Promise.resolve(afterMessages),
-    );
-
-    const thread = finalState.threads[0];
-    expect(thread?.messages).toHaveLength(2_000);
-    expect(thread?.messages[0]?.id).toBe("msg-100");
-    expect(thread?.messages.at(-1)?.id).toBe("msg-2099");
-    expect(thread?.checkpoints).toHaveLength(500);
-    expect(thread?.checkpoints[0]?.turnId).toBe("turn-100");
-    expect(thread?.checkpoints.at(-1)?.turnId).toBe("turn-599");
-  });
-});
diff --git a/apps/server/src/orchestration/projector.ts b/apps/server/src/orchestration/projector.ts
index 1c4cd65d5123..23e425014c59 100644
--- a/apps/server/src/orchestration/projector.ts
+++ b/apps/server/src/orchestration/projector.ts
@@ -1,10 +1,14 @@
-import type { OrchestrationEvent, OrchestrationReadModel, ThreadId } from "@t3tools/contracts";
+import type { ThreadId } from "@t3tools/contracts";
+import type {
+  OrchestrationEvent,
+  OrchestrationReadModel,
+} from "@t3tools/contracts/legacy-orchestration";
 import {
   OrchestrationCheckpointSummary,
   OrchestrationMessage,
   OrchestrationSession,
   OrchestrationThread,
-} from "@t3tools/contracts";
+} from "@t3tools/contracts/legacy-orchestration";
 import * as Effect from "effect/Effect";
 import * as Schema from "effect/Schema";
 
diff --git a/apps/server/src/persistence/Layers/OrchestrationCommandReceipts.ts b/apps/server/src/persistence/Layers/OrchestrationCommandReceipts.ts
index 989f5d78f8d8..33ebeb8a2b18 100644
--- a/apps/server/src/persistence/Layers/OrchestrationCommandReceipts.ts
+++ b/apps/server/src/persistence/Layers/OrchestrationCommandReceipts.ts
@@ -23,6 +23,7 @@ const makeOrchestrationCommandReceiptRepository = Effect.gen(function* () {
           command_id,
           aggregate_kind,
           aggregate_id,
+          command_type,
           accepted_at,
           result_sequence,
           status,
@@ -32,6 +33,7 @@ const makeOrchestrationCommandReceiptRepository = Effect.gen(function* () {
           ${receipt.commandId},
           ${receipt.aggregateKind},
           ${receipt.aggregateId},
+          ${receipt.commandType},
           ${receipt.acceptedAt},
           ${receipt.resultSequence},
           ${receipt.status},
@@ -40,7 +42,8 @@ const makeOrchestrationCommandReceiptRepository = Effect.gen(function* () {
         ON CONFLICT (command_id)
         DO UPDATE SET
           aggregate_kind = excluded.aggregate_kind,
-          aggregate_id = excluded.aggregate_id,
+            aggregate_id = excluded.aggregate_id,
+            command_type = excluded.command_type,
           accepted_at = excluded.accepted_at,
           result_sequence = excluded.result_sequence,
           status = excluded.status,
@@ -57,6 +60,7 @@ const makeOrchestrationCommandReceiptRepository = Effect.gen(function* () {
           command_id AS "commandId",
           aggregate_kind AS "aggregateKind",
           aggregate_id AS "aggregateId",
+          command_type AS "commandType",
           accepted_at AS "acceptedAt",
           result_sequence AS "resultSequence",
           status,
@@ -71,6 +75,37 @@ const makeOrchestrationCommandReceiptRepository = Effect.gen(function* () {
       Effect.mapError(toPersistenceSqlError("OrchestrationCommandReceiptRepository.upsert:query")),
     );
 
+  const insertIfAbsent: OrchestrationCommandReceiptRepositoryShape["insertIfAbsent"] = (receipt) =>
+    sql<{ readonly command_id: string }>`
+      INSERT INTO orchestration_command_receipts (
+        command_id,
+        aggregate_kind,
+        aggregate_id,
+        command_type,
+        accepted_at,
+        result_sequence,
+        status,
+        error
+      )
+      VALUES (
+        ${receipt.commandId},
+        ${receipt.aggregateKind},
+        ${receipt.aggregateId},
+        ${receipt.commandType},
+        ${receipt.acceptedAt},
+        ${receipt.resultSequence},
+        ${receipt.status},
+        ${receipt.error}
+      )
+      ON CONFLICT(command_id) DO NOTHING
+      RETURNING command_id
+    `.pipe(
+      Effect.map((rows) => rows.length === 1),
+      Effect.mapError(
+        toPersistenceSqlError("OrchestrationCommandReceiptRepository.insertIfAbsent:query"),
+      ),
+    );
+
   const getByCommandId: OrchestrationCommandReceiptRepositoryShape["getByCommandId"] = (input) =>
     findReceiptByCommandId(input).pipe(
       Effect.mapError(
@@ -79,6 +114,7 @@ const makeOrchestrationCommandReceiptRepository = Effect.gen(function* () {
     );
 
   return {
+    insertIfAbsent,
     upsert,
     getByCommandId,
   } satisfies OrchestrationCommandReceiptRepositoryShape;
diff --git a/apps/server/src/persistence/Layers/OrchestrationEventStore.test.ts b/apps/server/src/persistence/Layers/OrchestrationEventStore.test.ts
index 2bac5de920cb..1698c84c52d5 100644
--- a/apps/server/src/persistence/Layers/OrchestrationEventStore.test.ts
+++ b/apps/server/src/persistence/Layers/OrchestrationEventStore.test.ts
@@ -1,5 +1,6 @@
-import { CommandId, EventId, ProjectId } from "@t3tools/contracts";
+import { CommandId, EventId, ProjectId, ProviderInstanceId, ThreadId } from "@t3tools/contracts";
 import { assert, it } from "@effect/vitest";
+import * as DateTime from "effect/DateTime";
 import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
 import * as Schema from "effect/Schema";
@@ -120,4 +121,113 @@ layer("OrchestrationEventStore", (it) => {
       }
     }),
   );
+
+  it.effect("orders project and V2 agent events in the retained application event source", () =>
+    Effect.gen(function* () {
+      const eventStore = yield* OrchestrationEventStore;
+      const projectId = ProjectId.make("project-shared-stream");
+      const threadId = ThreadId.make("thread-shared-stream");
+      const providerInstanceId = ProviderInstanceId.make("codex");
+      const occurredAt = DateTime.makeUnsafe("2026-01-02T00:00:00.000Z");
+      const now = DateTime.formatIso(occurredAt);
+      const baselineSequence = yield* eventStore.latestApplicationSequence;
+
+      const projectEvent = yield* eventStore.append({
+        type: "project.created",
+        eventId: EventId.make("event-project-shared-stream"),
+        aggregateKind: "project",
+        aggregateId: projectId,
+        occurredAt: now,
+        commandId: CommandId.make("command-project-shared-stream"),
+        causationEventId: null,
+        correlationId: CommandId.make("command-project-shared-stream"),
+        metadata: {},
+        payload: {
+          projectId,
+          title: "Shared stream",
+          workspaceRoot: "/tmp/shared-stream",
+          defaultModelSelection: null,
+          scripts: [],
+          createdAt: now,
+          updatedAt: now,
+        },
+      });
+      const [threadEvent] = yield* eventStore.appendAgentEvents({
+        commandId: CommandId.make("command-thread-shared-stream"),
+        events: [
+          {
+            id: EventId.make("event-thread-shared-stream"),
+            type: "thread.created",
+            threadId,
+            providerInstanceId,
+            occurredAt,
+            payload: {
+              id: threadId,
+              projectId,
+              title: "Thread",
+              providerInstanceId,
+              modelSelection: { instanceId: providerInstanceId, model: "gpt-5.4" },
+              runtimeMode: "full-access",
+              interactionMode: "default",
+              branch: null,
+              worktreePath: null,
+              activeProviderThreadId: null,
+              lineage: {
+                rootThreadId: threadId,
+                parentThreadId: null,
+                relationshipToParent: null,
+              },
+              forkedFrom: null,
+              createdBy: "user",
+              creationSource: "web",
+              createdAt: occurredAt,
+              updatedAt: occurredAt,
+              archivedAt: null,
+              settledOverride: null,
+              settledAt: null,
+              lastVisitedAt: null,
+              deletedAt: null,
+            },
+          },
+        ],
+      });
+
+      const applicationEvents = yield* eventStore
+        .streamApplicationEvents({ afterSequence: baselineSequence })
+        .pipe(
+          Stream.take(2),
+          Stream.runCollect,
+          Effect.map((chunk) => Array.from(chunk)),
+        );
+      assert.deepEqual(
+        applicationEvents.map((event) => event.sequence),
+        [projectEvent.sequence, threadEvent!.sequence],
+      );
+      assert.isTrue("aggregateKind" in applicationEvents[0]!);
+      assert.isTrue("event" in applicationEvents[1]!);
+
+      const finiteReplay = yield* eventStore
+        .readApplicationEvents({
+          afterSequence: baselineSequence,
+          throughSequence: threadEvent!.sequence,
+        })
+        .pipe(
+          Stream.runCollect,
+          Effect.map((chunk) => Array.from(chunk)),
+        );
+      assert.deepEqual(
+        finiteReplay.map((event) => event.sequence),
+        [projectEvent.sequence, threadEvent!.sequence],
+      );
+
+      const legacyReplay = yield* eventStore.readFromSequence(projectEvent.sequence - 1).pipe(
+        Stream.runCollect,
+        Effect.map((chunk) => Array.from(chunk)),
+      );
+      assert.deepEqual(
+        legacyReplay.map((event) => event.type),
+        ["project.created"],
+      );
+    }),
+  );
 });
diff --git a/apps/server/src/persistence/Layers/OrchestrationEventStore.ts b/apps/server/src/persistence/Layers/OrchestrationEventStore.ts
index edd8620c3b3f..915a521adea3 100644
--- a/apps/server/src/persistence/Layers/OrchestrationEventStore.ts
+++ b/apps/server/src/persistence/Layers/OrchestrationEventStore.ts
@@ -1,20 +1,28 @@
 import {
+  ApplicationProjectEvent,
+  type ApplicationStoredEvent,
   CommandId,
   EventId,
   IsoDateTime,
   NonNegativeInt,
+  OrchestrationV2DomainEventJson,
+  OrchestrationV2StoredEvent,
+  ProjectId,
+  ThreadId,
+  type OrchestrationV2DomainEvent,
+} from "@t3tools/contracts";
+import {
   OrchestrationActorKind,
   OrchestrationAggregateKind,
   OrchestrationEvent,
   OrchestrationEventMetadata,
   OrchestrationEventType,
-  ProjectId,
-  ThreadId,
-} from "@t3tools/contracts";
+} from "@t3tools/contracts/legacy-orchestration";
 import * as SqlClient from "effect/unstable/sql/SqlClient";
 import * as SqlSchema from "effect/unstable/sql/SqlSchema";
 import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
+import * as PubSub from "effect/PubSub";
 import * as Option from "effect/Option";
 import * as Schema from "effect/Schema";
 import * as Stream from "effect/Stream";
@@ -30,6 +38,7 @@ import {
 } from "../Services/OrchestrationEventStore.ts";
 
 const decodeEvent = Schema.decodeUnknownEffect(OrchestrationEvent);
+const decodeProjectEvent = Schema.decodeUnknownEffect(ApplicationProjectEvent);
 const UnknownFromJsonString = Schema.fromJsonString(Schema.Unknown);
 const EventMetadataFromJsonString = Schema.fromJsonString(OrchestrationEventMetadata);
 
@@ -45,6 +54,7 @@ const AppendEventRequestSchema = Schema.Struct({
   commandId: Schema.NullOr(CommandId),
   payloadJson: UnknownFromJsonString,
   metadataJson: EventMetadataFromJsonString,
+  applicationEventVersion: Schema.Number,
 });
 
 const OrchestrationEventPersistedRowSchema = Schema.Struct({
@@ -75,6 +85,91 @@ const ReadFromSequenceRequestSchema = Schema.Struct({
 const DEFAULT_READ_FROM_SEQUENCE_LIMIT = 1_000;
 const READ_PAGE_SIZE = 500;
 
+interface ApplicationEventRow {
+  readonly sequence: number;
+  readonly event_id: string;
+  readonly command_id: string | null;
+  readonly aggregate_kind: "project" | "thread";
+  readonly stream_id: string;
+  readonly event_type: string;
+  readonly occurred_at: string;
+  readonly payload_json: string;
+  readonly metadata_json: string;
+  readonly application_event_version: number;
+  readonly causation_event_id: string | null;
+  readonly correlation_id: string | null;
+}
+
+const decodeV2EventJson = Schema.decodeUnknownEffect(OrchestrationV2DomainEventJson);
+const encodeV2EventJson = Schema.encodeEffect(OrchestrationV2DomainEventJson);
+const decodeV2StoredEvent = Schema.decodeUnknownEffect(OrchestrationV2StoredEvent);
+const decodeJson = Schema.decodeUnknownEffect(Schema.fromJsonString(Schema.Unknown));
+const encodeJson = Schema.encodeEffect(Schema.fromJsonString(Schema.Unknown));
+
+function metadataForV2Event(event: OrchestrationV2DomainEvent): Record<string, unknown> {
+  return {
+    ...(event.runId === undefined ? {} : { runId: event.runId }),
+    ...(event.nodeId === undefined ? {} : { nodeId: event.nodeId }),
+    ...(event.driver === undefined ? {} : { driver: event.driver }),
+    ...(event.providerInstanceId === undefined
+      ? {}
+      : { providerInstanceId: event.providerInstanceId }),
+    ...(event.rawEventId === undefined ? {} : { rawEventId: event.rawEventId }),
+  };
+}
+
+const rowToV2StoredEvent = Effect.fn("OrchestrationEventStore.rowToV2StoredEvent")(function* (
+  row: ApplicationEventRow,
+) {
+  const payload = yield* decodeJson(row.payload_json);
+  const metadata = yield* decodeJson(row.metadata_json);
+  const values =
+    typeof metadata === "object" && metadata !== null ? (metadata as Record<string, unknown>) : {};
+  const event = yield* decodeV2EventJson({
+    id: row.event_id,
+    threadId: row.stream_id,
+    type: row.event_type,
+    occurredAt: row.occurred_at,
+    payload,
+    ...(values.runId === undefined ? {} : { runId: values.runId }),
+    ...(values.nodeId === undefined ? {} : { nodeId: values.nodeId }),
+    ...(values.driver === undefined ? {} : { driver: values.driver }),
+    ...(values.providerInstanceId === undefined
+      ? {}
+      : { providerInstanceId: values.providerInstanceId }),
+    ...(values.rawEventId === undefined ? {} : { rawEventId: values.rawEventId }),
+  });
+  return yield* decodeV2StoredEvent({
+    sequence: row.sequence,
+    commandId: row.command_id,
+    event,
+  });
+});
+
+const rowToProjectEvent = Effect.fn("OrchestrationEventStore.rowToProjectEvent")(function* (
+  row: ApplicationEventRow,
+) {
+  return yield* decodeProjectEvent({
+    sequence: row.sequence,
+    eventId: row.event_id,
+    type: row.event_type,
+    aggregateKind: row.aggregate_kind,
+    aggregateId: row.stream_id,
+    occurredAt: row.occurred_at,
+    commandId: row.command_id,
+    causationEventId: row.causation_event_id,
+    correlationId: row.correlation_id,
+    payload: yield* decodeJson(row.payload_json),
+    metadata: yield* decodeJson(row.metadata_json),
+  });
+});
+
+function rowToApplicationStoredEvent(
+  row: ApplicationEventRow,
+): Effect.Effect<ApplicationStoredEvent, Schema.SchemaError> {
+  return row.aggregate_kind === "project" ? rowToProjectEvent(row) : rowToV2StoredEvent(row);
+}
+
 function inferActorKind(
   event: Omit<OrchestrationEvent, "sequence">,
 ): Schema.Schema.Type<typeof OrchestrationActorKind> {
@@ -106,6 +201,7 @@ function toPersistenceSqlOrDecodeError(sqlOperation: string, decodeOperation: st
 
 const makeEventStore = Effect.gen(function* () {
   const sql = yield* SqlClient.SqlClient;
+  const committedEvents = yield* PubSub.unbounded<ApplicationStoredEvent>();
 
   const appendEventRow = SqlSchema.findOne({
     Request: AppendEventRequestSchema,
@@ -125,6 +221,7 @@ const makeEventStore = Effect.gen(function* () {
           actor_kind,
           payload_json,
           metadata_json
+          , application_event_version
         )
         VALUES (
           ${request.eventId},
@@ -149,6 +246,7 @@ const makeEventStore = Effect.gen(function* () {
           ${request.actorKind},
           ${request.payloadJson},
           ${request.metadataJson}
+          , ${request.applicationEventVersion}
         )
         RETURNING
           sequence,
@@ -184,6 +282,7 @@ const makeEventStore = Effect.gen(function* () {
           metadata_json AS "metadata"
         FROM orchestration_events
         WHERE sequence > ${request.sequenceExclusive}
+          AND (application_event_version = 1 OR aggregate_kind = 'project')
         ORDER BY sequence ASC
         LIMIT ${request.limit}
       `,
@@ -202,6 +301,7 @@ const makeEventStore = Effect.gen(function* () {
       commandId: event.commandId,
       payloadJson: event.payload,
       metadataJson: event.metadata,
+      applicationEventVersion: event.aggregateKind === "project" ? 2 : 1,
     }).pipe(
       Effect.mapError(
         toPersistenceSqlOrDecodeError(
@@ -268,6 +368,219 @@ const makeEventStore = Effect.gen(function* () {
     return readPage(sequenceExclusive, normalizedLimit);
   };
 
+  const readApplicationRows = (input: {
+    readonly afterSequence: number;
+    readonly throughSequence?: number;
+    readonly threadId?: ThreadId;
+    readonly commandId?: CommandId;
+    readonly onlyAgentEvents?: boolean;
+    readonly limit: number;
+  }) =>
+    sql<ApplicationEventRow>`
+      SELECT
+        sequence,
+        event_id,
+        command_id,
+        aggregate_kind,
+        stream_id,
+        event_type,
+        occurred_at,
+        payload_json,
+        metadata_json,
+        application_event_version,
+        causation_event_id,
+        correlation_id
+      FROM orchestration_events
+      WHERE sequence > ${input.afterSequence}
+        AND sequence <= ${input.throughSequence ?? Number.MAX_SAFE_INTEGER}
+        AND (
+          (${input.onlyAgentEvents === true ? 1 : 0} = 0 AND aggregate_kind = 'project')
+          OR (application_event_version = 2 AND aggregate_kind = 'thread')
+        )
+        AND (${input.threadId ?? null} IS NULL OR stream_id = ${input.threadId ?? null})
+        AND (${input.commandId ?? null} IS NULL OR command_id = ${input.commandId ?? null})
+      ORDER BY sequence ASC
+      LIMIT ${input.limit}
+    `;
+
+  const appendAgentEvents: OrchestrationEventStoreShape["appendAgentEvents"] = (input) =>
+    Effect.forEach(
+      input.events,
+      (event) =>
+        Effect.gen(function* () {
+          const encoded = yield* encodeV2EventJson(event);
+          const rows = yield* sql<{ readonly sequence: number }>`
+            INSERT INTO orchestration_events (
+              event_id,
+              aggregate_kind,
+              stream_id,
+              stream_version,
+              event_type,
+              occurred_at,
+              command_id,
+              causation_event_id,
+              correlation_id,
+              actor_kind,
+              payload_json,
+              metadata_json,
+              application_event_version
+            )
+            VALUES (
+              ${event.id},
+              'thread',
+              ${event.threadId},
+              COALESCE(
+                (
+                  SELECT MAX(stream_version) + 1
+                  FROM orchestration_events
+                  WHERE aggregate_kind = 'thread' AND stream_id = ${event.threadId}
+                ),
+                0
+              ),
+              ${event.type},
+              ${encoded.occurredAt},
+              ${input.commandId ?? null},
+              NULL,
+              ${input.commandId ?? null},
+              ${event.rawEventId === undefined ? "server" : "provider"},
+              ${yield* encodeJson(encoded.payload)},
+              ${yield* encodeJson(metadataForV2Event(event))},
+              2
+            )
+            RETURNING sequence
+          `;
+          return yield* decodeV2StoredEvent({
+            sequence: rows[0]?.sequence,
+            commandId: input.commandId ?? null,
+            event,
+          });
+        }),
+      { concurrency: 1 },
+    ).pipe(
+      Effect.mapError(
+        toPersistenceSqlOrDecodeError(
+          "OrchestrationEventStore.appendAgentEvents:insert",
+          "OrchestrationEventStore.appendAgentEvents:decode",
+        ),
+      ),
+    );
+
+  const readAgentEvents: OrchestrationEventStoreShape["readAgentEvents"] = (input) =>
+    Stream.fromEffect(
+      readApplicationRows({
+        afterSequence: input?.afterSequence ?? 0,
+        ...(input?.throughSequence === undefined ? {} : { throughSequence: input.throughSequence }),
+        ...(input?.threadId === undefined ? {} : { threadId: input.threadId }),
+        ...(input?.commandId === undefined ? {} : { commandId: input.commandId }),
+        onlyAgentEvents: true,
+        limit: input?.limit ?? DEFAULT_READ_FROM_SEQUENCE_LIMIT,
+      }).pipe(
+        Effect.mapError(toPersistenceSqlError("OrchestrationEventStore.readAgentEvents:query")),
+      ),
+    ).pipe(
+      Stream.flatMap(Stream.fromIterable),
+      Stream.mapEffect((row) =>
+        rowToV2StoredEvent(row).pipe(
+          Effect.mapError(
+            toPersistenceDecodeError("OrchestrationEventStore.readAgentEvents:decode"),
+          ),
+        ),
+      ),
+    );
+
+  const latestAgentSequence: OrchestrationEventStoreShape["latestAgentSequence"] = (threadId) =>
+    sql<{ readonly sequence: number | null }>`
+      SELECT MAX(sequence) AS sequence
+      FROM orchestration_events
+      WHERE application_event_version = 2
+        AND aggregate_kind = 'thread'
+        AND (${threadId ?? null} IS NULL OR stream_id = ${threadId ?? null})
+    `.pipe(
+      Effect.map((rows) => rows[0]?.sequence ?? 0),
+      Effect.mapError(toPersistenceSqlError("OrchestrationEventStore.latestAgentSequence:query")),
+    );
+
+  const latestApplicationSequence = sql<{ readonly sequence: number | null }>`
+    SELECT MAX(sequence) AS sequence
+    FROM orchestration_events
+    WHERE aggregate_kind = 'project'
+      OR (application_event_version = 2 AND aggregate_kind = 'thread')
+  `.pipe(
+    Effect.map((rows) => rows[0]?.sequence ?? 0),
+    Effect.mapError(
+      toPersistenceSqlError("OrchestrationEventStore.latestApplicationSequence:query"),
+    ),
+  );
+
+  const readApplicationEventPage = (input: {
+    readonly afterSequence: number;
+    readonly throughSequence: number;
+    readonly limit: number;
+  }): Stream.Stream<ApplicationStoredEvent, OrchestrationEventStoreError> =>
+    Stream.fromEffect(
+      readApplicationRows(input).pipe(
+        Effect.mapError(
+          toPersistenceSqlError("OrchestrationEventStore.readApplicationEvents:query"),
+        ),
+      ),
+    ).pipe(
+      Stream.flatMap(Stream.fromIterable),
+      Stream.mapEffect((row) =>
+        rowToApplicationStoredEvent(row).pipe(
+          Effect.mapError(
+            toPersistenceDecodeError("OrchestrationEventStore.readApplicationEvents:decode"),
+          ),
+        ),
+      ),
+    );
+
+  const catchUpApplicationEvents = (input: {
+    readonly afterSequence: number;
+    readonly throughSequence: number;
+  }): Stream.Stream<ApplicationStoredEvent, OrchestrationEventStoreError> => {
+    const loop = (
+      afterSequence: number,
+    ): Stream.Stream<ApplicationStoredEvent, OrchestrationEventStoreError> =>
+      Stream.unwrap(
+        readApplicationEventPage({
+          afterSequence,
+          throughSequence: input.throughSequence,
+          limit: READ_PAGE_SIZE,
+        }).pipe(
+          Stream.runCollect,
+          Effect.map((chunk) => Array.from(chunk)),
+          Effect.map((events) => {
+            if (events.length === 0) return Stream.empty;
+            const current = Stream.fromIterable(events);
+            const last = events.at(-1)?.sequence ?? input.throughSequence;
+            return events.length < READ_PAGE_SIZE || last >= input.throughSequence
+              ? current
+              : Stream.concat(current, loop(last));
+          }),
+        ),
+      );
+    return loop(input.afterSequence);
+  };
+
+  const streamApplicationEvents: OrchestrationEventStoreShape["streamApplicationEvents"] = (
+    input,
+  ) =>
+    Stream.unwrap(
+      Effect.gen(function* () {
+        const subscription = yield* PubSub.subscribe(committedEvents);
+        const highWater = yield* latestApplicationSequence;
+        const afterSequence = input?.afterSequence ?? 0;
+        const replay = catchUpApplicationEvents({
+          afterSequence,
+          throughSequence: highWater,
+        });
+        const live = Stream.fromSubscription(subscription).pipe(
+          Stream.filter((event) => event.sequence > Math.max(highWater, afterSequence)),
+        );
+        return Stream.concat(replay, live);
+      }),
+    );
+
   const findEventAfter = SqlSchema.findOneOption({
     Request: HasEventAfterRequestSchema,
     Result: Schema.Struct({ sequence: Schema.Number }),
@@ -298,6 +611,13 @@ const makeEventStore = Effect.gen(function* () {
     append,
     readFromSequence,
     readAll: () => readFromSequence(0, Number.MAX_SAFE_INTEGER),
+    appendAgentEvents,
+    readAgentEvents,
+    latestAgentSequence,
+    latestApplicationSequence,
+    readApplicationEvents: catchUpApplicationEvents,
+    publishCommitted: (events) => PubSub.publishAll(committedEvents, events).pipe(Effect.asVoid),
+    streamApplicationEvents,
     hasEventAfter,
   } satisfies OrchestrationEventStoreShape;
 });
diff --git a/apps/server/src/persistence/Layers/ProjectionCheckpoints.ts b/apps/server/src/persistence/Layers/ProjectionCheckpoints.ts
index cfa5658d0e9c..42bd3e93bc09 100644
--- a/apps/server/src/persistence/Layers/ProjectionCheckpoints.ts
+++ b/apps/server/src/persistence/Layers/ProjectionCheckpoints.ts
@@ -1,4 +1,4 @@
-import { OrchestrationCheckpointFile } from "@t3tools/contracts";
+import { OrchestrationCheckpointFile } from "@t3tools/contracts/legacy-orchestration";
 import * as SqlClient from "effect/unstable/sql/SqlClient";
 import * as SqlSchema from "effect/unstable/sql/SqlSchema";
 import * as Effect from "effect/Effect";
diff --git a/apps/server/src/persistence/Layers/ProjectionTurns.ts b/apps/server/src/persistence/Layers/ProjectionTurns.ts
index bd57a4eaa30a..db25b007ed29 100644
--- a/apps/server/src/persistence/Layers/ProjectionTurns.ts
+++ b/apps/server/src/persistence/Layers/ProjectionTurns.ts
@@ -1,4 +1,4 @@
-import { OrchestrationCheckpointFile } from "@t3tools/contracts";
+import { OrchestrationCheckpointFile } from "@t3tools/contracts/legacy-orchestration";
 import * as SqlClient from "effect/unstable/sql/SqlClient";
 import * as SqlSchema from "effect/unstable/sql/SqlSchema";
 import * as Effect from "effect/Effect";
diff --git a/apps/server/src/persistence/Migrations.ts b/apps/server/src/persistence/Migrations.ts
index 8abbe87fce3e..a80195e74731 100644
--- a/apps/server/src/persistence/Migrations.ts
+++ b/apps/server/src/persistence/Migrations.ts
@@ -56,6 +56,15 @@ import Migration0040 from "./Migrations/040_ProjectionProjectFaviconPath.ts";
 import Migration0041 from "./Migrations/041_AuthSessionClientConnection.ts";
 import Migration0042 from "./Migrations/042_ProjectionThreadLinkedPullRequest.ts";
 import Migration0043 from "./Migrations/043_ProjectionThreadsUnsettledAt.ts";
+import Migration0044 from "./Migrations/044_OrchestrationV2.ts";
+import Migration0045 from "./Migrations/045_OrchestrationV2Subagents.ts";
+import Migration0046 from "./Migrations/046_OrchestrationV2Foundation.ts";
+import Migration0047 from "./Migrations/047_OrchestrationV2ProviderSessionBindings.ts";
+import Migration0048 from "./Migrations/048_OrchestrationV2ThreadLaunchWorkflows.ts";
+import Migration0049 from "./Migrations/049_ApplicationEventSource.ts";
+import Migration0050 from "./Migrations/050_OrchestrationV2EffectCancellation.ts";
+import Migration0051 from "./Migrations/051_ScheduledTasks.ts";
+import Migration0052 from "./Migrations/052_LegacyV1ImportState.ts";
 
 /**
  * Migration loader with all migrations defined inline.
@@ -111,6 +120,15 @@ export const migrationEntries = [
   [41, "AuthSessionClientConnection", Migration0041],
   [42, "ProjectionThreadLinkedPullRequest", Migration0042],
   [43, "ProjectionThreadsUnsettledAt", Migration0043],
+  [44, "OrchestrationV2", Migration0044],
+  [45, "OrchestrationV2Subagents", Migration0045],
+  [46, "OrchestrationV2Foundation", Migration0046],
+  [47, "OrchestrationV2ProviderSessionBindings", Migration0047],
+  [48, "OrchestrationV2ThreadLaunchWorkflows", Migration0048],
+  [49, "ApplicationEventSource", Migration0049],
+  [50, "OrchestrationV2EffectCancellation", Migration0050],
+  [51, "ScheduledTasks", Migration0051],
+  [52, "LegacyV1ImportState", Migration0052],
 ] as const;
 
 export const migrationManifest = migrationEntries.map(([id, name]) => [id, name] as const);
diff --git a/apps/server/src/persistence/Migrations/044_045_OrchestrationV2.test.ts b/apps/server/src/persistence/Migrations/044_045_OrchestrationV2.test.ts
new file mode 100644
index 000000000000..7fb6ec31cb65
--- /dev/null
+++ b/apps/server/src/persistence/Migrations/044_045_OrchestrationV2.test.ts
@@ -0,0 +1,230 @@
+import { assert, it } from "@effect/vitest";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as SqlClient from "effect/unstable/sql/SqlClient";
+
+import { migrationEntries, runMigrations } from "../Migrations.ts";
+import * as NodeSqliteClient from "../NodeSqliteClient.ts";
+
+const layer = it.layer(Layer.mergeAll(NodeSqliteClient.layerMemory()));
+
+layer("038_039_OrchestrationV2", (it) => {
+  it.effect("keeps released and private migration ids contiguous", () =>
+    Effect.sync(() => {
+      assert.deepStrictEqual(
+        migrationEntries.map(([id]) => id),
+        Array.from({ length: 52 }, (_, index) => index + 1),
+      );
+    }),
+  );
+
+  it.effect("installs the orchestration v2 and subagent schemas", () =>
+    Effect.gen(function* () {
+      const sql = yield* SqlClient.SqlClient;
+
+      yield* runMigrations({ toMigrationInclusive: 45 });
+
+      const migrations = yield* sql<{
+        readonly migration_id: number;
+        readonly name: string;
+      }>`
+        SELECT migration_id, name
+        FROM effect_sql_migrations
+        WHERE migration_id IN (42, 43, 44, 45)
+        ORDER BY migration_id
+      `;
+      assert.deepStrictEqual(migrations, [
+        {
+          migration_id: 42,
+          name: "ProjectionThreadLinkedPullRequest",
+        },
+        {
+          migration_id: 43,
+          name: "ProjectionThreadsUnsettledAt",
+        },
+        {
+          migration_id: 44,
+          name: "OrchestrationV2",
+        },
+        {
+          migration_id: 45,
+          name: "OrchestrationV2Subagents",
+        },
+      ]);
+
+      const eventColumns = yield* sql<{ readonly name: string }>`
+        PRAGMA table_info(orchestration_v2_events)
+      `;
+      const subagentColumns = yield* sql<{ readonly name: string }>`
+        PRAGMA table_info(orchestration_v2_projection_subagents)
+      `;
+
+      assert.ok(eventColumns.some((column) => column.name === "event_id"));
+      assert.ok(subagentColumns.some((column) => column.name === "child_thread_id"));
+    }),
+  );
+
+  it.effect("backfills provider-session thread bindings in migration 047", () =>
+    Effect.gen(function* () {
+      const sql = yield* SqlClient.SqlClient;
+      yield* runMigrations({ toMigrationInclusive: 46 });
+      yield* sql`
+        INSERT INTO orchestration_v2_projection_provider_sessions (
+          provider_session_id,
+          thread_id,
+          provider,
+          driver,
+          provider_instance_id,
+          status,
+          model,
+          updated_at,
+          payload_json
+        ) VALUES (
+          'provider-session:shared',
+          'thread:existing',
+          'codex',
+          'codex',
+          'codex',
+          'ready',
+          'gpt-5.4',
+          '2026-01-01T00:00:00.000Z',
+          '{}'
+        )
+      `;
+
+      yield* runMigrations({ toMigrationInclusive: 47 });
+
+      const bindings = yield* sql<{
+        readonly provider_session_id: string;
+        readonly thread_id: string;
+      }>`
+        SELECT provider_session_id, thread_id
+        FROM orchestration_v2_projection_provider_session_bindings
+      `;
+      assert.deepStrictEqual(bindings, [
+        {
+          provider_session_id: "provider-session:shared",
+          thread_id: "thread:existing",
+        },
+      ]);
+    }),
+  );
+
+  it.effect("preserves turn items with colliding ordinals in migration 046", () =>
+    Effect.gen(function* () {
+      const sql = yield* SqlClient.SqlClient;
+      yield* runMigrations({ toMigrationInclusive: 45 });
+      yield* sql`
+        INSERT INTO orchestration_v2_projection_runs (
+          run_id,
+          thread_id,
+          ordinal,
+          provider,
+          status,
+          requested_at,
+          payload_json
+        ) VALUES (
+          'run:one',
+          'thread:one',
+          1,
+          'codex',
+          'completed',
+          '2026-01-01T00:00:00.000Z',
+          '{}'
+        )
+      `;
+      yield* sql`
+        INSERT INTO orchestration_v2_projection_turn_items (
+          turn_item_id,
+          thread_id,
+          run_id,
+          ordinal,
+          type,
+          status,
+          updated_at,
+          payload_json
+        ) VALUES
+          ('turn-item:b', 'thread:one', 'run:one', 7, 'assistant_message', 'completed', '2026-01-01T00:00:00.000Z', '{}'),
+          ('turn-item:a', 'thread:one', 'run:one', 7, 'assistant_message', 'completed', '2026-01-01T00:00:00.000Z', '{}'),
+          ('turn-item:c', 'thread:one', 'run:one', 9, 'assistant_message', 'completed', '2026-01-01T00:00:00.000Z', '{}'),
+          ('turn-item:d', 'thread:two', NULL, 42, 'assistant_message', 'completed', '2026-01-01T00:00:00.000Z', '{}')
+      `;
+
+      yield* runMigrations({ toMigrationInclusive: 46 });
+
+      const positions = yield* sql<{
+        readonly thread_id: string;
+        readonly turn_item_id: string;
+        readonly ordinal: number;
+      }>`
+        SELECT thread_id, turn_item_id, ordinal
+        FROM orchestration_v2_turn_item_positions
+        ORDER BY thread_id, ordinal
+      `;
+      assert.deepStrictEqual(positions, [
+        { thread_id: "thread:one", turn_item_id: "turn-item:a", ordinal: 1_000_001 },
+        { thread_id: "thread:one", turn_item_id: "turn-item:b", ordinal: 1_000_002 },
+        { thread_id: "thread:one", turn_item_id: "turn-item:c", ordinal: 1_000_003 },
+        { thread_id: "thread:two", turn_item_id: "turn-item:d", ordinal: 1 },
+      ]);
+    }).pipe(Effect.provide(NodeSqliteClient.layerMemory())),
+  );
+});
+
+it.effect("upgrades a database already at released main migration 043", () =>
+  Effect.gen(function* () {
+    const sql = yield* SqlClient.SqlClient;
+
+    yield* runMigrations({ toMigrationInclusive: 43 });
+    const snoozeColumns = yield* sql<{ readonly name: string }>`
+      PRAGMA table_info(projection_threads)
+    `;
+    assert.ok(snoozeColumns.some((column) => column.name === "snoozed_until"));
+    assert.ok(snoozeColumns.some((column) => column.name === "snoozed_at"));
+
+    yield* runMigrations({ toMigrationInclusive: 52 });
+
+    const migrations = yield* sql<{
+      readonly migration_id: number;
+      readonly name: string;
+    }>`
+      SELECT migration_id, name
+      FROM effect_sql_migrations
+      WHERE migration_id BETWEEN 39 AND 52
+      ORDER BY migration_id
+    `;
+    assert.deepStrictEqual(
+      migrations.map(({ migration_id, name }) => [migration_id, name]),
+      [
+        [39, "ProjectionProjectsDefaultThreadEnvMode"],
+        [40, "ProjectionProjectFaviconPath"],
+        [41, "AuthSessionClientConnection"],
+        [42, "ProjectionThreadLinkedPullRequest"],
+        [43, "ProjectionThreadsUnsettledAt"],
+        [44, "OrchestrationV2"],
+        [45, "OrchestrationV2Subagents"],
+        [46, "OrchestrationV2Foundation"],
+        [47, "OrchestrationV2ProviderSessionBindings"],
+        [48, "OrchestrationV2ThreadLaunchWorkflows"],
+        [49, "ApplicationEventSource"],
+        [50, "OrchestrationV2EffectCancellation"],
+        [51, "ScheduledTasks"],
+        [52, "LegacyV1ImportState"],
+      ],
+    );
+
+    const v2Tables = yield* sql<{ readonly name: string }>`
+      SELECT name
+      FROM sqlite_master
+      WHERE type = 'table' AND name = 'orchestration_v2_projection_threads'
+    `;
+    assert.strictEqual(v2Tables.length, 1);
+
+    const legacyImportTables = yield* sql<{ readonly name: string }>`
+      SELECT name
+      FROM sqlite_master
+      WHERE type = 'table' AND name = 'orchestration_v2_legacy_imports'
+    `;
+    assert.strictEqual(legacyImportTables.length, 1);
+  }).pipe(Effect.provide(NodeSqliteClient.layerMemory())),
+);
diff --git a/apps/server/src/persistence/Migrations/044_OrchestrationV2.ts b/apps/server/src/persistence/Migrations/044_OrchestrationV2.ts
new file mode 100644
index 000000000000..99508f8efc08
--- /dev/null
+++ b/apps/server/src/persistence/Migrations/044_OrchestrationV2.ts
@@ -0,0 +1,303 @@
+import * as Effect from "effect/Effect";
+import * as SqlClient from "effect/unstable/sql/SqlClient";
+
+// Base schema for the orchestration V2 event log and projections.
+export default Effect.gen(function* () {
+  const sql = yield* SqlClient.SqlClient;
+
+  yield* sql`
+    CREATE TABLE orchestration_v2_events (
+      sequence INTEGER PRIMARY KEY AUTOINCREMENT,
+      event_id TEXT NOT NULL UNIQUE,
+      command_id TEXT,
+      thread_id TEXT NOT NULL,
+      run_id TEXT,
+      node_id TEXT,
+      provider TEXT,
+      raw_event_id TEXT,
+      event_type TEXT NOT NULL,
+      occurred_at TEXT NOT NULL,
+      payload_json TEXT NOT NULL
+    )
+  `;
+  yield* sql`CREATE INDEX orchestration_v2_events_command_idx ON orchestration_v2_events(command_id, sequence)`;
+  yield* sql`CREATE INDEX orchestration_v2_events_thread_sequence_idx ON orchestration_v2_events(thread_id, sequence)`;
+  yield* sql`CREATE INDEX orchestration_v2_events_thread_type_sequence_idx ON orchestration_v2_events(thread_id, event_type, sequence)`;
+  yield* sql`CREATE INDEX orchestration_v2_events_run_sequence_idx ON orchestration_v2_events(run_id, sequence)`;
+  yield* sql`CREATE INDEX orchestration_v2_events_node_sequence_idx ON orchestration_v2_events(node_id, sequence)`;
+  yield* sql`CREATE INDEX orchestration_v2_events_raw_event_idx ON orchestration_v2_events(raw_event_id)`;
+
+  yield* sql`
+    CREATE TABLE orchestration_v2_command_receipts (
+      command_id TEXT PRIMARY KEY,
+      thread_id TEXT NOT NULL,
+      command_type TEXT NOT NULL,
+      accepted_at TEXT NOT NULL,
+      result_sequence INTEGER NOT NULL,
+      status TEXT NOT NULL,
+      error TEXT
+    )
+  `;
+  yield* sql`CREATE INDEX orchestration_v2_command_receipts_thread_sequence_idx ON orchestration_v2_command_receipts(thread_id, result_sequence)`;
+
+  yield* sql`
+    CREATE TABLE orchestration_v2_projection_threads (
+      thread_id TEXT PRIMARY KEY,
+      project_id TEXT NOT NULL,
+      title TEXT NOT NULL,
+      default_provider TEXT NOT NULL,
+      runtime_mode TEXT NOT NULL,
+      interaction_mode TEXT NOT NULL,
+      active_provider_thread_id TEXT,
+      created_at TEXT NOT NULL,
+      updated_at TEXT NOT NULL,
+      archived_at TEXT,
+      deleted_at TEXT,
+      payload_json TEXT NOT NULL
+    )
+  `;
+  yield* sql`CREATE INDEX orchestration_v2_projection_threads_project_updated_idx ON orchestration_v2_projection_threads(project_id, updated_at)`;
+
+  yield* sql`
+    CREATE TABLE orchestration_v2_projection_runs (
+      run_id TEXT PRIMARY KEY,
+      thread_id TEXT NOT NULL,
+      ordinal INTEGER NOT NULL,
+      provider TEXT NOT NULL,
+      provider_thread_id TEXT,
+      status TEXT NOT NULL,
+      requested_at TEXT NOT NULL,
+      completed_at TEXT,
+      payload_json TEXT NOT NULL
+    )
+  `;
+  yield* sql`CREATE UNIQUE INDEX orchestration_v2_projection_runs_thread_ordinal_idx ON orchestration_v2_projection_runs(thread_id, ordinal)`;
+  yield* sql`CREATE INDEX orchestration_v2_projection_runs_provider_thread_idx ON orchestration_v2_projection_runs(provider_thread_id)`;
+  yield* sql`CREATE INDEX orchestration_v2_projection_runs_thread_status_idx ON orchestration_v2_projection_runs(thread_id, status)`;
+
+  yield* sql`
+    CREATE TABLE orchestration_v2_projection_run_attempts (
+      attempt_id TEXT PRIMARY KEY,
+      thread_id TEXT NOT NULL,
+      run_id TEXT NOT NULL,
+      attempt_ordinal INTEGER NOT NULL,
+      root_node_id TEXT NOT NULL,
+      provider TEXT NOT NULL,
+      provider_thread_id TEXT NOT NULL,
+      provider_turn_id TEXT,
+      status TEXT NOT NULL,
+      payload_json TEXT NOT NULL
+    )
+  `;
+  yield* sql`CREATE UNIQUE INDEX orchestration_v2_projection_run_attempts_run_ordinal_idx ON orchestration_v2_projection_run_attempts(run_id, attempt_ordinal)`;
+  yield* sql`CREATE INDEX orchestration_v2_projection_run_attempts_thread_idx ON orchestration_v2_projection_run_attempts(thread_id, run_id)`;
+
+  yield* sql`
+    CREATE TABLE orchestration_v2_projection_nodes (
+      node_id TEXT PRIMARY KEY,
+      thread_id TEXT NOT NULL,
+      run_id TEXT,
+      parent_node_id TEXT,
+      root_node_id TEXT NOT NULL,
+      kind TEXT NOT NULL,
+      status TEXT NOT NULL,
+      provider_thread_id TEXT,
+      provider_turn_id TEXT,
+      runtime_request_id TEXT,
+      checkpoint_scope_id TEXT,
+      started_at TEXT,
+      completed_at TEXT,
+      payload_json TEXT NOT NULL
+    )
+  `;
+  yield* sql`CREATE INDEX orchestration_v2_projection_nodes_thread_run_idx ON orchestration_v2_projection_nodes(thread_id, run_id)`;
+  yield* sql`CREATE INDEX orchestration_v2_projection_nodes_parent_idx ON orchestration_v2_projection_nodes(parent_node_id)`;
+  yield* sql`CREATE INDEX orchestration_v2_projection_nodes_provider_turn_idx ON orchestration_v2_projection_nodes(provider_turn_id)`;
+
+  yield* sql`
+    CREATE TABLE orchestration_v2_projection_provider_sessions (
+      provider_session_id TEXT PRIMARY KEY,
+      thread_id TEXT,
+      provider TEXT NOT NULL,
+      status TEXT NOT NULL,
+      model TEXT,
+      updated_at TEXT NOT NULL,
+      payload_json TEXT NOT NULL
+    )
+  `;
+  yield* sql`CREATE INDEX orchestration_v2_projection_provider_sessions_thread_idx ON orchestration_v2_projection_provider_sessions(thread_id)`;
+  yield* sql`CREATE INDEX orchestration_v2_projection_provider_sessions_provider_status_idx ON orchestration_v2_projection_provider_sessions(provider, status)`;
+
+  yield* sql`
+    CREATE TABLE orchestration_v2_projection_provider_threads (
+      provider_thread_id TEXT PRIMARY KEY,
+      thread_id TEXT,
+      owner_node_id TEXT,
+      provider TEXT NOT NULL,
+      provider_session_id TEXT,
+      status TEXT NOT NULL,
+      first_run_ordinal INTEGER,
+      last_run_ordinal INTEGER,
+      updated_at TEXT NOT NULL,
+      payload_json TEXT NOT NULL
+    )
+  `;
+  yield* sql`CREATE INDEX orchestration_v2_projection_provider_threads_thread_idx ON orchestration_v2_projection_provider_threads(thread_id)`;
+  yield* sql`CREATE INDEX orchestration_v2_projection_provider_threads_session_idx ON orchestration_v2_projection_provider_threads(provider_session_id)`;
+  yield* sql`CREATE INDEX orchestration_v2_projection_provider_threads_owner_idx ON orchestration_v2_projection_provider_threads(owner_node_id)`;
+
+  yield* sql`
+    CREATE TABLE orchestration_v2_projection_provider_turns (
+      provider_turn_id TEXT PRIMARY KEY,
+      thread_id TEXT NOT NULL,
+      provider_thread_id TEXT NOT NULL,
+      node_id TEXT NOT NULL,
+      run_attempt_id TEXT,
+      ordinal INTEGER NOT NULL,
+      status TEXT NOT NULL,
+      started_at TEXT,
+      completed_at TEXT,
+      payload_json TEXT NOT NULL
+    )
+  `;
+  yield* sql`CREATE INDEX orchestration_v2_projection_provider_turns_thread_idx ON orchestration_v2_projection_provider_turns(thread_id)`;
+  yield* sql`CREATE UNIQUE INDEX orchestration_v2_projection_provider_turns_thread_ordinal_idx ON orchestration_v2_projection_provider_turns(provider_thread_id, ordinal)`;
+
+  yield* sql`
+    CREATE TABLE orchestration_v2_projection_runtime_requests (
+      runtime_request_id TEXT PRIMARY KEY,
+      thread_id TEXT NOT NULL,
+      node_id TEXT NOT NULL,
+      provider_turn_id TEXT,
+      kind TEXT NOT NULL,
+      status TEXT NOT NULL,
+      created_at TEXT NOT NULL,
+      resolved_at TEXT,
+      payload_json TEXT NOT NULL
+    )
+  `;
+  yield* sql`CREATE INDEX orchestration_v2_projection_runtime_requests_thread_status_idx ON orchestration_v2_projection_runtime_requests(thread_id, status)`;
+  yield* sql`CREATE INDEX orchestration_v2_projection_runtime_requests_provider_turn_idx ON orchestration_v2_projection_runtime_requests(provider_turn_id)`;
+
+  yield* sql`
+    CREATE TABLE orchestration_v2_projection_messages (
+      message_id TEXT PRIMARY KEY,
+      thread_id TEXT NOT NULL,
+      run_id TEXT,
+      node_id TEXT,
+      role TEXT NOT NULL,
+      streaming INTEGER NOT NULL,
+      created_at TEXT NOT NULL,
+      updated_at TEXT NOT NULL,
+      payload_json TEXT NOT NULL
+    )
+  `;
+  yield* sql`CREATE INDEX orchestration_v2_projection_messages_thread_created_idx ON orchestration_v2_projection_messages(thread_id, created_at, message_id)`;
+  yield* sql`CREATE INDEX orchestration_v2_projection_messages_run_idx ON orchestration_v2_projection_messages(run_id)`;
+  yield* sql`CREATE INDEX orchestration_v2_projection_messages_node_idx ON orchestration_v2_projection_messages(node_id)`;
+
+  yield* sql`
+    CREATE TABLE orchestration_v2_projection_plans (
+      plan_id TEXT PRIMARY KEY,
+      thread_id TEXT NOT NULL,
+      run_id TEXT,
+      node_id TEXT NOT NULL,
+      kind TEXT NOT NULL,
+      status TEXT NOT NULL,
+      payload_json TEXT NOT NULL
+    )
+  `;
+  yield* sql`CREATE INDEX orchestration_v2_projection_plans_thread_idx ON orchestration_v2_projection_plans(thread_id)`;
+  yield* sql`CREATE INDEX orchestration_v2_projection_plans_run_idx ON orchestration_v2_projection_plans(run_id)`;
+
+  yield* sql`
+    CREATE TABLE orchestration_v2_projection_turn_items (
+      turn_item_id TEXT PRIMARY KEY,
+      thread_id TEXT NOT NULL,
+      run_id TEXT,
+      node_id TEXT,
+      provider_thread_id TEXT,
+      provider_turn_id TEXT,
+      parent_item_id TEXT,
+      ordinal INTEGER NOT NULL,
+      type TEXT NOT NULL,
+      status TEXT NOT NULL,
+      updated_at TEXT NOT NULL,
+      payload_json TEXT NOT NULL
+    )
+  `;
+  yield* sql`CREATE INDEX orchestration_v2_projection_turn_items_thread_ordinal_idx ON orchestration_v2_projection_turn_items(thread_id, ordinal, turn_item_id)`;
+  yield* sql`CREATE INDEX orchestration_v2_projection_turn_items_run_ordinal_idx ON orchestration_v2_projection_turn_items(run_id, ordinal)`;
+  yield* sql`CREATE INDEX orchestration_v2_projection_turn_items_node_ordinal_idx ON orchestration_v2_projection_turn_items(node_id, ordinal)`;
+  yield* sql`CREATE INDEX orchestration_v2_projection_turn_items_provider_turn_idx ON orchestration_v2_projection_turn_items(provider_turn_id)`;
+
+  yield* sql`
+    CREATE TABLE orchestration_v2_projection_checkpoint_scopes (
+      scope_id TEXT PRIMARY KEY,
+      thread_id TEXT NOT NULL,
+      run_id TEXT,
+      node_id TEXT NOT NULL,
+      parent_scope_id TEXT,
+      provider_thread_id TEXT,
+      kind TEXT NOT NULL,
+      ordinal_within_parent INTEGER NOT NULL,
+      advances_app_run_count INTEGER NOT NULL,
+      created_at TEXT NOT NULL,
+      payload_json TEXT NOT NULL
+    )
+  `;
+  yield* sql`CREATE INDEX orchestration_v2_projection_checkpoint_scopes_thread_idx ON orchestration_v2_projection_checkpoint_scopes(thread_id)`;
+  yield* sql`CREATE INDEX orchestration_v2_projection_checkpoint_scopes_parent_idx ON orchestration_v2_projection_checkpoint_scopes(parent_scope_id)`;
+
+  yield* sql`
+    CREATE TABLE orchestration_v2_projection_checkpoints (
+      checkpoint_id TEXT PRIMARY KEY,
+      thread_id TEXT NOT NULL,
+      scope_id TEXT NOT NULL,
+      run_id TEXT,
+      node_id TEXT NOT NULL,
+      parent_checkpoint_id TEXT,
+      ordinal_within_scope INTEGER NOT NULL,
+      app_run_ordinal INTEGER,
+      status TEXT NOT NULL,
+      captured_at TEXT NOT NULL,
+      payload_json TEXT NOT NULL
+    )
+  `;
+  yield* sql`CREATE UNIQUE INDEX orchestration_v2_projection_checkpoints_scope_ordinal_idx ON orchestration_v2_projection_checkpoints(scope_id, ordinal_within_scope)`;
+  yield* sql`CREATE INDEX orchestration_v2_projection_checkpoints_thread_idx ON orchestration_v2_projection_checkpoints(thread_id)`;
+  yield* sql`CREATE INDEX orchestration_v2_projection_checkpoints_parent_idx ON orchestration_v2_projection_checkpoints(parent_checkpoint_id)`;
+
+  yield* sql`
+    CREATE TABLE orchestration_v2_projection_context_handoffs (
+      context_handoff_id TEXT PRIMARY KEY,
+      thread_id TEXT NOT NULL,
+      target_run_id TEXT NOT NULL,
+      to_provider_thread_id TEXT NOT NULL,
+      strategy TEXT NOT NULL,
+      status TEXT NOT NULL,
+      updated_at TEXT NOT NULL,
+      payload_json TEXT NOT NULL
+    )
+  `;
+  yield* sql`CREATE INDEX orchestration_v2_projection_context_handoffs_thread_idx ON orchestration_v2_projection_context_handoffs(thread_id)`;
+  yield* sql`CREATE INDEX orchestration_v2_projection_context_handoffs_target_run_idx ON orchestration_v2_projection_context_handoffs(target_run_id)`;
+
+  yield* sql`
+    CREATE TABLE orchestration_v2_projection_context_transfers (
+      context_transfer_id TEXT PRIMARY KEY,
+      source_thread_id TEXT NOT NULL,
+      target_thread_id TEXT NOT NULL,
+      target_run_id TEXT,
+      type TEXT NOT NULL,
+      status TEXT NOT NULL,
+      source_provider TEXT,
+      target_provider TEXT,
+      updated_at TEXT NOT NULL,
+      payload_json TEXT NOT NULL
+    )
+  `;
+  yield* sql`CREATE INDEX orchestration_v2_projection_context_transfers_source_thread_idx ON orchestration_v2_projection_context_transfers(source_thread_id)`;
+  yield* sql`CREATE INDEX orchestration_v2_projection_context_transfers_target_thread_idx ON orchestration_v2_projection_context_transfers(target_thread_id, status)`;
+  yield* sql`CREATE INDEX orchestration_v2_projection_context_transfers_target_run_idx ON orchestration_v2_projection_context_transfers(target_run_id)`;
+});
diff --git a/apps/server/src/persistence/Migrations/045_OrchestrationV2Subagents.ts b/apps/server/src/persistence/Migrations/045_OrchestrationV2Subagents.ts
new file mode 100644
index 000000000000..b43b3a8e3d3a
--- /dev/null
+++ b/apps/server/src/persistence/Migrations/045_OrchestrationV2Subagents.ts
@@ -0,0 +1,28 @@
+import * as Effect from "effect/Effect";
+import * as SqlClient from "effect/unstable/sql/SqlClient";
+
+export default Effect.gen(function* () {
+  const sql = yield* SqlClient.SqlClient;
+
+  yield* sql`
+    CREATE TABLE orchestration_v2_projection_subagents (
+      subagent_id TEXT PRIMARY KEY,
+      thread_id TEXT NOT NULL,
+      run_id TEXT,
+      parent_node_id TEXT NOT NULL,
+      provider TEXT NOT NULL,
+      provider_thread_id TEXT,
+      child_thread_id TEXT,
+      origin TEXT NOT NULL,
+      status TEXT NOT NULL,
+      started_at TEXT,
+      completed_at TEXT,
+      updated_at TEXT NOT NULL,
+      payload_json TEXT NOT NULL
+    )
+  `;
+  yield* sql`CREATE INDEX orchestration_v2_projection_subagents_thread_idx ON orchestration_v2_projection_subagents(thread_id, started_at, subagent_id)`;
+  yield* sql`CREATE INDEX orchestration_v2_projection_subagents_parent_node_idx ON orchestration_v2_projection_subagents(parent_node_id)`;
+  yield* sql`CREATE INDEX orchestration_v2_projection_subagents_provider_thread_idx ON orchestration_v2_projection_subagents(provider_thread_id)`;
+  yield* sql`CREATE INDEX orchestration_v2_projection_subagents_child_thread_idx ON orchestration_v2_projection_subagents(child_thread_id)`;
+});
diff --git a/apps/server/src/persistence/Migrations/046_OrchestrationV2Foundation.test.ts b/apps/server/src/persistence/Migrations/046_OrchestrationV2Foundation.test.ts
new file mode 100644
index 000000000000..0aa3cf1f903a
--- /dev/null
+++ b/apps/server/src/persistence/Migrations/046_OrchestrationV2Foundation.test.ts
@@ -0,0 +1,64 @@
+import { assert, it } from "@effect/vitest";
+import * as Effect from "effect/Effect";
+import * as SqlClient from "effect/unstable/sql/SqlClient";
+
+import { runMigrations } from "../Migrations.ts";
+import * as NodeSqliteClient from "../NodeSqliteClient.ts";
+
+it.effect("backfills the V2 event driver from payload before the legacy provider column", () =>
+  Effect.gen(function* () {
+    const sql = yield* SqlClient.SqlClient;
+    yield* runMigrations({ toMigrationInclusive: 45 });
+
+    yield* sql`
+      INSERT INTO orchestration_v2_events (
+        event_id,
+        thread_id,
+        provider,
+        event_type,
+        occurred_at,
+        payload_json
+      ) VALUES
+        (
+          'event:explicit-driver',
+          'thread:explicit-driver',
+          'codex-work',
+          'thread.created',
+          '2026-07-29T00:00:00.000Z',
+          '{"driver":"codex","providerInstanceId":"codex-work"}'
+        ),
+        (
+          'event:legacy-provider',
+          'thread:legacy-provider',
+          'claude-agent',
+          'thread.created',
+          '2026-07-29T00:00:00.000Z',
+          '{}'
+        )
+    `;
+
+    yield* runMigrations({ toMigrationInclusive: 46 });
+
+    const events = yield* sql<{
+      readonly event_id: string;
+      readonly driver: string;
+      readonly provider_instance_id: string;
+    }>`
+      SELECT event_id, driver, provider_instance_id
+      FROM orchestration_v2_events
+      ORDER BY event_id
+    `;
+    assert.deepStrictEqual(events, [
+      {
+        event_id: "event:explicit-driver",
+        driver: "codex",
+        provider_instance_id: "codex-work",
+      },
+      {
+        event_id: "event:legacy-provider",
+        driver: "claude-agent",
+        provider_instance_id: "claude-agent",
+      },
+    ]);
+  }).pipe(Effect.provide(NodeSqliteClient.layerMemory())),
+);
diff --git a/apps/server/src/persistence/Migrations/046_OrchestrationV2Foundation.ts b/apps/server/src/persistence/Migrations/046_OrchestrationV2Foundation.ts
new file mode 100644
index 000000000000..e05c691e9c02
--- /dev/null
+++ b/apps/server/src/persistence/Migrations/046_OrchestrationV2Foundation.ts
@@ -0,0 +1,180 @@
+import * as Effect from "effect/Effect";
+import * as SqlClient from "effect/unstable/sql/SqlClient";
+
+/**
+ * Production-facing V2 persistence additions.
+ *
+ * The original V2 schema used a single `provider` column for both configured
+ * instance routing and driver identity. Keep those columns in place for
+ * migration compatibility. They remain write-through shadows where the old
+ * schema declared them NOT NULL; all V2 reads and indexes use the explicit
+ * columns added here.
+ */
+export default Effect.gen(function* () {
+  const sql = yield* SqlClient.SqlClient;
+
+  yield* sql`ALTER TABLE orchestration_v2_events ADD COLUMN driver TEXT`;
+  yield* sql`ALTER TABLE orchestration_v2_events ADD COLUMN provider_instance_id TEXT`;
+  yield* sql`
+    UPDATE orchestration_v2_events
+    SET
+      driver = COALESCE(json_extract(payload_json, '$.driver'), provider),
+      provider_instance_id = COALESCE(
+        json_extract(payload_json, '$.providerInstanceId'),
+        provider
+      )
+  `;
+  yield* sql`CREATE INDEX orchestration_v2_events_instance_sequence_idx ON orchestration_v2_events(provider_instance_id, sequence)`;
+
+  yield* sql`ALTER TABLE orchestration_v2_projection_threads ADD COLUMN provider_instance_id TEXT`;
+  yield* sql`
+    UPDATE orchestration_v2_projection_threads
+    SET provider_instance_id = COALESCE(
+      json_extract(payload_json, '$.providerInstanceId'),
+      default_provider
+    )
+  `;
+
+  yield* sql`ALTER TABLE orchestration_v2_projection_runs ADD COLUMN provider_instance_id TEXT`;
+  yield* sql`
+    UPDATE orchestration_v2_projection_runs
+    SET provider_instance_id = COALESCE(
+      json_extract(payload_json, '$.providerInstanceId'),
+      provider
+    )
+  `;
+
+  yield* sql`ALTER TABLE orchestration_v2_projection_run_attempts ADD COLUMN provider_instance_id TEXT`;
+  yield* sql`
+    UPDATE orchestration_v2_projection_run_attempts
+    SET provider_instance_id = COALESCE(
+      json_extract(payload_json, '$.providerInstanceId'),
+      provider
+    )
+  `;
+
+  yield* sql`ALTER TABLE orchestration_v2_projection_provider_sessions ADD COLUMN driver TEXT`;
+  yield* sql`ALTER TABLE orchestration_v2_projection_provider_sessions ADD COLUMN provider_instance_id TEXT`;
+  yield* sql`
+    UPDATE orchestration_v2_projection_provider_sessions
+    SET
+      driver = COALESCE(json_extract(payload_json, '$.driver'), provider),
+      provider_instance_id = COALESCE(
+        json_extract(payload_json, '$.providerInstanceId'),
+        provider
+      )
+  `;
+  yield* sql`CREATE INDEX orchestration_v2_projection_provider_sessions_instance_status_idx ON orchestration_v2_projection_provider_sessions(provider_instance_id, status)`;
+
+  yield* sql`ALTER TABLE orchestration_v2_projection_provider_threads ADD COLUMN driver TEXT`;
+  yield* sql`ALTER TABLE orchestration_v2_projection_provider_threads ADD COLUMN provider_instance_id TEXT`;
+  yield* sql`
+    UPDATE orchestration_v2_projection_provider_threads
+    SET
+      driver = COALESCE(json_extract(payload_json, '$.driver'), provider),
+      provider_instance_id = COALESCE(
+        json_extract(payload_json, '$.providerInstanceId'),
+        provider
+      )
+  `;
+  yield* sql`CREATE INDEX orchestration_v2_projection_provider_threads_instance_status_idx ON orchestration_v2_projection_provider_threads(provider_instance_id, status)`;
+
+  yield* sql`ALTER TABLE orchestration_v2_projection_subagents ADD COLUMN driver TEXT`;
+  yield* sql`ALTER TABLE orchestration_v2_projection_subagents ADD COLUMN provider_instance_id TEXT`;
+  yield* sql`
+    UPDATE orchestration_v2_projection_subagents
+    SET
+      driver = json_extract(payload_json, '$.driver'),
+      provider_instance_id = COALESCE(
+        json_extract(payload_json, '$.providerInstanceId'),
+        provider
+      )
+  `;
+
+  yield* sql`ALTER TABLE orchestration_v2_projection_context_transfers ADD COLUMN source_provider_instance_id TEXT`;
+  yield* sql`ALTER TABLE orchestration_v2_projection_context_transfers ADD COLUMN target_provider_instance_id TEXT`;
+  yield* sql`
+    UPDATE orchestration_v2_projection_context_transfers
+    SET
+      source_provider_instance_id = COALESCE(
+        json_extract(payload_json, '$.sourceProviderInstanceId'),
+        source_provider
+      ),
+      target_provider_instance_id = COALESCE(
+        json_extract(payload_json, '$.targetProviderInstanceId'),
+        target_provider
+      )
+  `;
+
+  yield* sql`
+    CREATE TABLE orchestration_v2_effect_outbox (
+      effect_id TEXT PRIMARY KEY,
+      command_id TEXT NOT NULL,
+      thread_id TEXT NOT NULL,
+      effect_type TEXT NOT NULL,
+      payload_json TEXT NOT NULL,
+      status TEXT NOT NULL CHECK (status IN ('pending', 'running', 'succeeded', 'failed')),
+      attempt_count INTEGER NOT NULL DEFAULT 0,
+      available_at TEXT NOT NULL,
+      lease_owner TEXT,
+      lease_expires_at TEXT,
+      created_at TEXT NOT NULL,
+      updated_at TEXT NOT NULL,
+      completed_at TEXT,
+      last_error TEXT
+    )
+  `;
+  yield* sql`CREATE INDEX orchestration_v2_effect_outbox_claim_idx ON orchestration_v2_effect_outbox(status, available_at, lease_expires_at, created_at)`;
+  yield* sql`CREATE INDEX orchestration_v2_effect_outbox_command_idx ON orchestration_v2_effect_outbox(command_id, effect_id)`;
+
+  yield* sql`
+    CREATE TABLE orchestration_v2_turn_item_positions (
+      thread_id TEXT NOT NULL,
+      turn_item_id TEXT NOT NULL,
+      ordinal INTEGER NOT NULL,
+      PRIMARY KEY (thread_id, turn_item_id),
+      UNIQUE (thread_id, ordinal)
+    )
+  `;
+  yield* sql`
+    INSERT INTO orchestration_v2_turn_item_positions (
+      thread_id,
+      turn_item_id,
+      ordinal
+    )
+    SELECT
+      item.thread_id,
+      item.turn_item_id,
+      COALESCE(run.ordinal, 0) * 1000000 + ROW_NUMBER() OVER (
+        PARTITION BY item.thread_id, COALESCE(run.ordinal, 0)
+        ORDER BY item.ordinal, item.turn_item_id
+      )
+    FROM orchestration_v2_projection_turn_items AS item
+    LEFT JOIN orchestration_v2_projection_runs AS run
+      ON run.thread_id = item.thread_id
+      AND run.run_id = item.run_id
+  `;
+
+  yield* sql`
+    CREATE TABLE orchestration_v2_projection_metadata (
+      projection_name TEXT PRIMARY KEY,
+      schema_version INTEGER NOT NULL,
+      last_sequence INTEGER NOT NULL,
+      updated_at TEXT NOT NULL
+    )
+  `;
+  yield* sql`
+    INSERT INTO orchestration_v2_projection_metadata (
+      projection_name,
+      schema_version,
+      last_sequence,
+      updated_at
+    )
+    VALUES (
+      'thread-projections',
+      1,
+      COALESCE((SELECT MAX(sequence) FROM orchestration_v2_events), 0),
+      strftime('%Y-%m-%dT%H:%M:%fZ', 'now')
+    )
+  `;
+});
diff --git a/apps/server/src/persistence/Migrations/047_OrchestrationV2ProviderSessionBindings.ts b/apps/server/src/persistence/Migrations/047_OrchestrationV2ProviderSessionBindings.ts
new file mode 100644
index 000000000000..22abde6264e2
--- /dev/null
+++ b/apps/server/src/persistence/Migrations/047_OrchestrationV2ProviderSessionBindings.ts
@@ -0,0 +1,27 @@
+import * as Effect from "effect/Effect";
+import * as SqlClient from "effect/unstable/sql/SqlClient";
+
+export default Effect.gen(function* () {
+  const sql = yield* SqlClient.SqlClient;
+
+  yield* sql`
+    CREATE TABLE orchestration_v2_projection_provider_session_bindings (
+      provider_session_id TEXT NOT NULL,
+      thread_id TEXT NOT NULL,
+      PRIMARY KEY (provider_session_id, thread_id)
+    )
+  `;
+  yield* sql`
+    INSERT OR IGNORE INTO orchestration_v2_projection_provider_session_bindings (
+      provider_session_id,
+      thread_id
+    )
+    SELECT provider_session_id, thread_id
+    FROM orchestration_v2_projection_provider_sessions
+    WHERE thread_id IS NOT NULL
+  `;
+  yield* sql`
+    CREATE INDEX orchestration_v2_projection_provider_session_bindings_thread_idx
+    ON orchestration_v2_projection_provider_session_bindings(thread_id)
+  `;
+});
diff --git a/apps/server/src/persistence/Migrations/048_OrchestrationV2ThreadLaunchWorkflows.ts b/apps/server/src/persistence/Migrations/048_OrchestrationV2ThreadLaunchWorkflows.ts
new file mode 100644
index 000000000000..1f898f648b0d
--- /dev/null
+++ b/apps/server/src/persistence/Migrations/048_OrchestrationV2ThreadLaunchWorkflows.ts
@@ -0,0 +1,23 @@
+import * as Effect from "effect/Effect";
+import * as SqlClient from "effect/unstable/sql/SqlClient";
+
+export default Effect.gen(function* () {
+  const sql = yield* SqlClient.SqlClient;
+  yield* sql`
+    CREATE TABLE IF NOT EXISTS orchestration_v2_thread_launch_workflows (
+      command_id TEXT PRIMARY KEY,
+      thread_id TEXT NOT NULL,
+      project_id TEXT NOT NULL,
+      status TEXT NOT NULL,
+      title TEXT NOT NULL,
+      worktree_path TEXT,
+      branch TEXT,
+      setup_committed INTEGER NOT NULL DEFAULT 0,
+      thread_committed INTEGER NOT NULL DEFAULT 0,
+      message_committed INTEGER NOT NULL DEFAULT 0,
+      last_error TEXT,
+      created_at TEXT NOT NULL,
+      updated_at TEXT NOT NULL
+    )
+  `;
+});
diff --git a/apps/server/src/persistence/Migrations/049_ApplicationEventSource.test.ts b/apps/server/src/persistence/Migrations/049_ApplicationEventSource.test.ts
new file mode 100644
index 000000000000..6d4944b79ed9
--- /dev/null
+++ b/apps/server/src/persistence/Migrations/049_ApplicationEventSource.test.ts
@@ -0,0 +1,135 @@
+import { assert, it } from "@effect/vitest";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as SqlClient from "effect/unstable/sql/SqlClient";
+
+import { runMigrations } from "../Migrations.ts";
+import * as NodeSqliteClient from "../NodeSqliteClient.ts";
+
+const layer = it.layer(Layer.mergeAll(NodeSqliteClient.layerMemory()));
+
+layer("043_ApplicationEventSource", (it) => {
+  it.effect("moves V2 events and current project state behind one global sequence", () =>
+    Effect.gen(function* () {
+      const sql = yield* SqlClient.SqlClient;
+      yield* runMigrations({ toMigrationInclusive: 48 });
+
+      yield* sql`
+        INSERT INTO orchestration_v2_events (
+          event_id,
+          command_id,
+          thread_id,
+          run_id,
+          node_id,
+          provider,
+          driver,
+          provider_instance_id,
+          raw_event_id,
+          event_type,
+          occurred_at,
+          payload_json
+        ) VALUES (
+          'event:v2:existing',
+          'command:v2:existing',
+          'thread:v2:existing',
+          NULL,
+          NULL,
+          'codex',
+          'codex',
+          'codex',
+          NULL,
+          'thread.created',
+          '2026-06-20T00:00:00.000Z',
+          '{}'
+        )
+      `;
+      yield* sql`
+        INSERT INTO orchestration_v2_command_receipts (
+          command_id,
+          thread_id,
+          command_type,
+          accepted_at,
+          result_sequence,
+          status,
+          error
+        ) VALUES (
+          'command:v2:existing',
+          'thread:v2:existing',
+          'thread.create',
+          '2026-06-20T00:00:00.000Z',
+          1,
+          'accepted',
+          NULL
+        )
+      `;
+      yield* sql`
+        INSERT INTO projection_projects (
+          project_id,
+          title,
+          workspace_root,
+          default_model_selection_json,
+          scripts_json,
+          created_at,
+          updated_at,
+          deleted_at
+        ) VALUES (
+          'project:existing',
+          'Existing project',
+          '/work/existing',
+          '{"instanceId":"codex","model":"gpt-5.4"}',
+          '[]',
+          '2026-06-19T00:00:00.000Z',
+          '2026-06-20T00:00:00.000Z',
+          NULL
+        )
+      `;
+
+      yield* runMigrations({ toMigrationInclusive: 49 });
+
+      const events = yield* sql<{
+        readonly sequence: number;
+        readonly aggregate_kind: string;
+        readonly stream_id: string;
+        readonly event_type: string;
+        readonly application_event_version: number;
+      }>`
+        SELECT
+          sequence,
+          aggregate_kind,
+          stream_id,
+          event_type,
+          application_event_version
+        FROM orchestration_events
+        WHERE application_event_version = 2
+        ORDER BY sequence ASC
+      `;
+      assert.deepStrictEqual(
+        events.map((event) => [event.aggregate_kind, event.stream_id, event.event_type]),
+        [
+          ["thread", "thread:v2:existing", "thread.created"],
+          ["project", "project:existing", "project.created"],
+        ],
+      );
+      assert.ok(events[0]!.sequence < events[1]!.sequence);
+
+      const receipts = yield* sql<{
+        readonly aggregate_kind: string;
+        readonly aggregate_id: string;
+        readonly command_type: string;
+        readonly result_sequence: number;
+      }>`
+        SELECT aggregate_kind, aggregate_id, command_type, result_sequence
+        FROM orchestration_command_receipts
+        WHERE command_id = 'command:v2:existing'
+      `;
+      assert.deepStrictEqual(receipts, [
+        {
+          aggregate_kind: "thread",
+          aggregate_id: "thread:v2:existing",
+          command_type: "thread.create",
+          result_sequence: events[0]!.sequence,
+        },
+      ]);
+    }),
+  );
+});
diff --git a/apps/server/src/persistence/Migrations/049_ApplicationEventSource.ts b/apps/server/src/persistence/Migrations/049_ApplicationEventSource.ts
new file mode 100644
index 000000000000..5efab4961eb6
--- /dev/null
+++ b/apps/server/src/persistence/Migrations/049_ApplicationEventSource.ts
@@ -0,0 +1,281 @@
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import * as SqlClient from "effect/unstable/sql/SqlClient";
+
+interface LegacyV2EventRow {
+  readonly event_id: string;
+  readonly command_id: string | null;
+  readonly thread_id: string;
+  readonly run_id: string | null;
+  readonly node_id: string | null;
+  readonly driver: string | null;
+  readonly provider_instance_id: string | null;
+  readonly raw_event_id: string | null;
+  readonly event_type: string;
+  readonly occurred_at: string;
+  readonly payload_json: string;
+}
+
+interface ProjectProjectionRow {
+  readonly project_id: string;
+  readonly title: string;
+  readonly workspace_root: string;
+  readonly default_model_selection_json: string | null;
+  readonly scripts_json: string;
+  readonly created_at: string;
+  readonly updated_at: string;
+  readonly deleted_at: string | null;
+}
+
+const decodeJson = Schema.decodeUnknownEffect(Schema.fromJsonString(Schema.Unknown));
+const encodeJson = Schema.encodeEffect(Schema.fromJsonString(Schema.Unknown));
+
+export default Effect.gen(function* () {
+  const sql = yield* SqlClient.SqlClient;
+
+  yield* sql`
+    ALTER TABLE orchestration_events
+    ADD COLUMN application_event_version INTEGER NOT NULL DEFAULT 1
+  `;
+  yield* sql`
+    CREATE INDEX idx_orchestration_events_application_sequence
+    ON orchestration_events(application_event_version, sequence)
+  `;
+  yield* sql`
+    ALTER TABLE orchestration_command_receipts
+    ADD COLUMN command_type TEXT NOT NULL DEFAULT 'legacy'
+  `;
+
+  const legacyV2Events = yield* sql<LegacyV2EventRow>`
+    SELECT
+      event_id,
+      command_id,
+      thread_id,
+      run_id,
+      node_id,
+      driver,
+      provider_instance_id,
+      raw_event_id,
+      event_type,
+      occurred_at,
+      payload_json
+    FROM orchestration_v2_events
+    ORDER BY sequence ASC
+  `;
+
+  yield* Effect.forEach(
+    legacyV2Events,
+    (event) =>
+      Effect.gen(function* () {
+        const metadata = yield* encodeJson({
+          applicationEventVersion: 2,
+          ...(event.run_id === null ? {} : { runId: event.run_id }),
+          ...(event.node_id === null ? {} : { nodeId: event.node_id }),
+          ...(event.driver === null ? {} : { driver: event.driver }),
+          ...(event.provider_instance_id === null
+            ? {}
+            : { providerInstanceId: event.provider_instance_id }),
+          ...(event.raw_event_id === null ? {} : { rawEventId: event.raw_event_id }),
+        });
+        yield* sql`
+        INSERT INTO orchestration_events (
+          event_id,
+          aggregate_kind,
+          stream_id,
+          stream_version,
+          event_type,
+          occurred_at,
+          command_id,
+          causation_event_id,
+          correlation_id,
+          actor_kind,
+          payload_json,
+          metadata_json,
+          application_event_version
+        )
+        SELECT
+          ${event.event_id},
+          'thread',
+          ${event.thread_id},
+          COALESCE(
+            (
+              SELECT MAX(stream_version) + 1
+              FROM orchestration_events
+              WHERE aggregate_kind = 'thread' AND stream_id = ${event.thread_id}
+            ),
+            0
+          ),
+          ${event.event_type},
+          ${event.occurred_at},
+          ${event.command_id},
+          NULL,
+          ${event.command_id},
+          ${event.raw_event_id === null ? "server" : "provider"},
+          ${event.payload_json},
+          ${metadata},
+          2
+        WHERE NOT EXISTS (
+          SELECT 1 FROM orchestration_events WHERE event_id = ${event.event_id}
+        )
+        `;
+      }),
+    { concurrency: 1, discard: true },
+  );
+
+  // ProjectService wrote this projection directly before the application event
+  // boundary was restored. Re-baseline every current row into the shared log so
+  // projection rebuilds preserve the exact pre-migration project state.
+  const projectRows = yield* sql<ProjectProjectionRow>`
+    SELECT
+      project_id,
+      title,
+      workspace_root,
+      default_model_selection_json,
+      scripts_json,
+      created_at,
+      updated_at,
+      deleted_at
+    FROM projection_projects
+    ORDER BY created_at ASC, project_id ASC
+  `;
+  yield* Effect.forEach(
+    projectRows,
+    (project) =>
+      Effect.gen(function* () {
+        const createdEventId = `migration:39:project:${project.project_id}:baseline`;
+        const createdPayload = {
+          projectId: project.project_id,
+          title: project.title,
+          workspaceRoot: project.workspace_root,
+          defaultModelSelection:
+            project.default_model_selection_json === null
+              ? null
+              : yield* decodeJson(project.default_model_selection_json),
+          scripts: yield* decodeJson(project.scripts_json),
+          createdAt: project.created_at,
+          updatedAt: project.updated_at,
+        };
+        const createdPayloadJson = yield* encodeJson(createdPayload);
+        const migrationMetadataJson = yield* encodeJson({
+          applicationEventVersion: 2,
+          migration: 39,
+        });
+        yield* sql`
+          INSERT INTO orchestration_events (
+            event_id,
+            aggregate_kind,
+            stream_id,
+            stream_version,
+            event_type,
+            occurred_at,
+            command_id,
+            causation_event_id,
+            correlation_id,
+            actor_kind,
+            payload_json,
+            metadata_json,
+            application_event_version
+          )
+          VALUES (
+            ${createdEventId},
+            'project',
+            ${project.project_id},
+            COALESCE(
+              (
+                SELECT MAX(stream_version) + 1
+                FROM orchestration_events
+                WHERE aggregate_kind = 'project' AND stream_id = ${project.project_id}
+              ),
+              0
+            ),
+            'project.created',
+            ${project.updated_at},
+            NULL,
+            NULL,
+            NULL,
+            'server',
+            ${createdPayloadJson},
+            ${migrationMetadataJson},
+            2
+          )
+        `;
+
+        if (project.deleted_at !== null) {
+          const deletedPayloadJson = yield* encodeJson({
+            projectId: project.project_id,
+            deletedAt: project.deleted_at,
+          });
+          yield* sql`
+            INSERT INTO orchestration_events (
+              event_id,
+              aggregate_kind,
+              stream_id,
+              stream_version,
+              event_type,
+              occurred_at,
+              command_id,
+              causation_event_id,
+              correlation_id,
+              actor_kind,
+              payload_json,
+              metadata_json,
+              application_event_version
+            )
+            VALUES (
+              ${`migration:39:project:${project.project_id}:deleted`},
+              'project',
+              ${project.project_id},
+              (
+                SELECT MAX(stream_version) + 1
+                FROM orchestration_events
+                WHERE aggregate_kind = 'project' AND stream_id = ${project.project_id}
+              ),
+              'project.deleted',
+              ${project.deleted_at},
+              NULL,
+              ${createdEventId},
+              NULL,
+              'server',
+              ${deletedPayloadJson},
+              ${migrationMetadataJson},
+              2
+            )
+          `;
+        }
+      }),
+    { concurrency: 1, discard: true },
+  );
+
+  yield* sql`
+    INSERT INTO orchestration_command_receipts (
+      command_id,
+      aggregate_kind,
+      aggregate_id,
+      accepted_at,
+      result_sequence,
+      status,
+      error,
+      command_type
+    )
+    SELECT
+      command_id,
+      'thread',
+      thread_id,
+      accepted_at,
+      COALESCE(
+        (
+          SELECT MAX(events.sequence)
+          FROM orchestration_events events
+          WHERE events.application_event_version = 2
+            AND events.command_id = receipts.command_id
+        ),
+        0
+      ),
+      status,
+      error,
+      command_type
+    FROM orchestration_v2_command_receipts receipts
+    WHERE TRUE
+    ON CONFLICT(command_id) DO NOTHING
+  `;
+});
diff --git a/apps/server/src/persistence/Migrations/050_OrchestrationV2EffectCancellation.test.ts b/apps/server/src/persistence/Migrations/050_OrchestrationV2EffectCancellation.test.ts
new file mode 100644
index 000000000000..86b27e29343a
--- /dev/null
+++ b/apps/server/src/persistence/Migrations/050_OrchestrationV2EffectCancellation.test.ts
@@ -0,0 +1,80 @@
+import { assert, it } from "@effect/vitest";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as SqlClient from "effect/unstable/sql/SqlClient";
+
+import { runMigrations } from "../Migrations.ts";
+import * as NodeSqliteClient from "../NodeSqliteClient.ts";
+
+const layer = it.layer(Layer.mergeAll(NodeSqliteClient.layerMemory()));
+
+layer("050_OrchestrationV2EffectCancellation", (it) => {
+  it.effect("preserves existing effects and adds the cancelled terminal status", () =>
+    Effect.gen(function* () {
+      const sql = yield* SqlClient.SqlClient;
+      yield* runMigrations({ toMigrationInclusive: 49 });
+      yield* sql`
+        INSERT INTO orchestration_v2_effect_outbox (
+          effect_id,
+          command_id,
+          thread_id,
+          effect_type,
+          payload_json,
+          status,
+          attempt_count,
+          available_at,
+          lease_owner,
+          lease_expires_at,
+          created_at,
+          updated_at,
+          completed_at,
+          last_error
+        ) VALUES (
+          'effect:existing',
+          'command:existing',
+          'thread:existing',
+          'provider-turn.start',
+          '{"type":"provider-turn.start","runId":"run:existing"}',
+          'running',
+          1,
+          '2026-06-20T00:00:00.000Z',
+          'worker:old',
+          '2026-06-20T00:00:30.000Z',
+          '2026-06-20T00:00:00.000Z',
+          '2026-06-20T00:00:00.000Z',
+          NULL,
+          NULL
+        )
+      `;
+
+      yield* runMigrations({ toMigrationInclusive: 50 });
+      yield* sql`
+        UPDATE orchestration_v2_effect_outbox
+        SET
+          status = 'cancelled',
+          lease_owner = NULL,
+          lease_expires_at = NULL,
+          completed_at = '2026-06-20T00:01:00.000Z'
+        WHERE effect_id = 'effect:existing'
+      `;
+
+      const rows = yield* sql<{
+        readonly effect_id: string;
+        readonly status: string;
+        readonly attempt_count: number;
+        readonly lease_owner: string | null;
+      }>`
+        SELECT effect_id, status, attempt_count, lease_owner
+        FROM orchestration_v2_effect_outbox
+      `;
+      assert.deepStrictEqual(rows, [
+        {
+          effect_id: "effect:existing",
+          status: "cancelled",
+          attempt_count: 1,
+          lease_owner: null,
+        },
+      ]);
+    }),
+  );
+});
diff --git a/apps/server/src/persistence/Migrations/050_OrchestrationV2EffectCancellation.ts b/apps/server/src/persistence/Migrations/050_OrchestrationV2EffectCancellation.ts
new file mode 100644
index 000000000000..eb2512b013b0
--- /dev/null
+++ b/apps/server/src/persistence/Migrations/050_OrchestrationV2EffectCancellation.ts
@@ -0,0 +1,78 @@
+import * as Effect from "effect/Effect";
+import * as SqlClient from "effect/unstable/sql/SqlClient";
+
+export default Effect.gen(function* () {
+  const sql = yield* SqlClient.SqlClient;
+
+  yield* sql`
+    CREATE TABLE orchestration_v2_effect_outbox_next (
+      effect_id TEXT PRIMARY KEY,
+      command_id TEXT NOT NULL,
+      thread_id TEXT NOT NULL,
+      effect_type TEXT NOT NULL,
+      payload_json TEXT NOT NULL,
+      status TEXT NOT NULL CHECK (
+        status IN ('pending', 'running', 'succeeded', 'failed', 'cancelled')
+      ),
+      attempt_count INTEGER NOT NULL DEFAULT 0,
+      available_at TEXT NOT NULL,
+      lease_owner TEXT,
+      lease_expires_at TEXT,
+      created_at TEXT NOT NULL,
+      updated_at TEXT NOT NULL,
+      completed_at TEXT,
+      last_error TEXT
+    )
+  `;
+  yield* sql`
+    INSERT INTO orchestration_v2_effect_outbox_next (
+      effect_id,
+      command_id,
+      thread_id,
+      effect_type,
+      payload_json,
+      status,
+      attempt_count,
+      available_at,
+      lease_owner,
+      lease_expires_at,
+      created_at,
+      updated_at,
+      completed_at,
+      last_error
+    )
+    SELECT
+      effect_id,
+      command_id,
+      thread_id,
+      effect_type,
+      payload_json,
+      status,
+      attempt_count,
+      available_at,
+      lease_owner,
+      lease_expires_at,
+      created_at,
+      updated_at,
+      completed_at,
+      last_error
+    FROM orchestration_v2_effect_outbox
+  `;
+  yield* sql`DROP TABLE orchestration_v2_effect_outbox`;
+  yield* sql`
+    ALTER TABLE orchestration_v2_effect_outbox_next
+    RENAME TO orchestration_v2_effect_outbox
+  `;
+  yield* sql`
+    CREATE INDEX orchestration_v2_effect_outbox_claim_idx
+    ON orchestration_v2_effect_outbox(status, available_at, lease_expires_at, created_at)
+  `;
+  yield* sql`
+    CREATE INDEX orchestration_v2_effect_outbox_command_idx
+    ON orchestration_v2_effect_outbox(command_id, effect_id)
+  `;
+  yield* sql`
+    CREATE INDEX orchestration_v2_effect_outbox_thread_status_idx
+    ON orchestration_v2_effect_outbox(thread_id, status, effect_type)
+  `;
+});
diff --git a/apps/server/src/persistence/Migrations/051_ScheduledTasks.ts b/apps/server/src/persistence/Migrations/051_ScheduledTasks.ts
new file mode 100644
index 000000000000..b9f951139e1c
--- /dev/null
+++ b/apps/server/src/persistence/Migrations/051_ScheduledTasks.ts
@@ -0,0 +1,42 @@
+import * as Effect from "effect/Effect";
+import * as SqlClient from "effect/unstable/sql/SqlClient";
+
+export default Effect.gen(function* () {
+  const sql = yield* SqlClient.SqlClient;
+
+  yield* sql`
+    CREATE TABLE IF NOT EXISTS scheduled_tasks (
+      task_id TEXT PRIMARY KEY,
+      title TEXT NOT NULL,
+      prompt TEXT NOT NULL,
+      enabled INTEGER NOT NULL,
+      schedule_json TEXT NOT NULL,
+      project_id TEXT NOT NULL,
+      thread_id TEXT,
+      workspace_strategy_json TEXT NOT NULL,
+      model_selection_json TEXT NOT NULL,
+      runtime_mode TEXT NOT NULL,
+      interaction_mode TEXT NOT NULL,
+      created_by TEXT NOT NULL,
+      creation_source TEXT NOT NULL,
+      created_at TEXT NOT NULL,
+      updated_at TEXT NOT NULL,
+      next_run_at TEXT,
+      last_run_at TEXT,
+      last_run_status TEXT NOT NULL,
+      last_run_error TEXT,
+      run_count INTEGER NOT NULL
+    )
+  `;
+
+  yield* sql`
+    CREATE INDEX IF NOT EXISTS idx_scheduled_tasks_due
+    ON scheduled_tasks(enabled, next_run_at)
+    WHERE enabled = 1 AND next_run_at IS NOT NULL
+  `;
+
+  yield* sql`
+    CREATE INDEX IF NOT EXISTS idx_scheduled_tasks_project
+    ON scheduled_tasks(project_id, updated_at)
+  `;
+});
diff --git a/apps/server/src/persistence/Migrations/052_LegacyV1ImportState.ts b/apps/server/src/persistence/Migrations/052_LegacyV1ImportState.ts
new file mode 100644
index 000000000000..ebd107ce78cb
--- /dev/null
+++ b/apps/server/src/persistence/Migrations/052_LegacyV1ImportState.ts
@@ -0,0 +1,27 @@
+import * as Effect from "effect/Effect";
+import * as SqlClient from "effect/unstable/sql/SqlClient";
+
+/**
+ * Tracks the incremental import of v1 materialized thread state into the v2
+ * event model. Shells are imported synchronously at startup; full transcripts
+ * are hydrated on demand and by a low-priority background pass.
+ */
+export default Effect.gen(function* () {
+  const sql = yield* SqlClient.SqlClient;
+
+  yield* sql`
+    CREATE TABLE orchestration_v2_legacy_imports (
+      thread_id TEXT PRIMARY KEY,
+      source_updated_at TEXT NOT NULL,
+      shell_imported_at TEXT NOT NULL,
+      transcript_imported_at TEXT,
+      imported_message_count INTEGER NOT NULL DEFAULT 0,
+      last_error TEXT
+    )
+  `;
+
+  yield* sql`
+    CREATE INDEX orchestration_v2_legacy_imports_pending_transcript_idx
+    ON orchestration_v2_legacy_imports(transcript_imported_at, shell_imported_at, thread_id)
+  `;
+});
diff --git a/apps/server/src/persistence/ProviderSessionRuntime.ts b/apps/server/src/persistence/ProviderSessionRuntime.ts
index 2ccdd862522f..bffdac594ffb 100644
--- a/apps/server/src/persistence/ProviderSessionRuntime.ts
+++ b/apps/server/src/persistence/ProviderSessionRuntime.ts
@@ -9,13 +9,8 @@ import * as Struct from "effect/Struct";
 import * as SqlClient from "effect/unstable/sql/SqlClient";
 import * as SqlSchema from "effect/unstable/sql/SqlSchema";
 
-import {
-  IsoDateTime,
-  ProviderInstanceId,
-  ProviderSessionRuntimeStatus,
-  RuntimeMode,
-  ThreadId,
-} from "@t3tools/contracts";
+import { IsoDateTime, ProviderInstanceId, RuntimeMode, ThreadId } from "@t3tools/contracts";
+import { ProviderSessionRuntimeStatus } from "@t3tools/contracts/legacy-orchestration";
 
 import {
   PersistenceDecodeError,
diff --git a/apps/server/src/persistence/Services/OrchestrationCommandReceipts.ts b/apps/server/src/persistence/Services/OrchestrationCommandReceipts.ts
index 1498984827e5..8586b392793d 100644
--- a/apps/server/src/persistence/Services/OrchestrationCommandReceipts.ts
+++ b/apps/server/src/persistence/Services/OrchestrationCommandReceipts.ts
@@ -6,15 +6,11 @@
  *
  * @module OrchestrationCommandReceiptRepository
  */
+import { CommandId, IsoDateTime, NonNegativeInt, ProjectId, ThreadId } from "@t3tools/contracts";
 import {
-  CommandId,
-  IsoDateTime,
-  NonNegativeInt,
   OrchestrationAggregateKind,
   OrchestrationCommandReceiptStatus,
-  ProjectId,
-  ThreadId,
-} from "@t3tools/contracts";
+} from "@t3tools/contracts/legacy-orchestration";
 import * as Option from "effect/Option";
 import * as Schema from "effect/Schema";
 import * as Context from "effect/Context";
@@ -26,6 +22,7 @@ export const OrchestrationCommandReceipt = Schema.Struct({
   commandId: CommandId,
   aggregateKind: OrchestrationAggregateKind,
   aggregateId: Schema.Union([ProjectId, ThreadId]),
+  commandType: Schema.String,
   acceptedAt: IsoDateTime,
   resultSequence: NonNegativeInt,
   status: OrchestrationCommandReceiptStatus,
@@ -42,6 +39,10 @@ export type GetByCommandIdInput = typeof GetByCommandIdInput.Type;
  * OrchestrationCommandReceiptRepositoryShape - Service API for command receipts.
  */
 export interface OrchestrationCommandReceiptRepositoryShape {
+  readonly insertIfAbsent: (
+    receipt: OrchestrationCommandReceipt,
+  ) => Effect.Effect<boolean, OrchestrationCommandReceiptRepositoryError>;
+
   /**
    * Insert or replace a command receipt row.
    *
diff --git a/apps/server/src/persistence/Services/OrchestrationEventStore.ts b/apps/server/src/persistence/Services/OrchestrationEventStore.ts
index 488210ab74a5..0499193e3ed6 100644
--- a/apps/server/src/persistence/Services/OrchestrationEventStore.ts
+++ b/apps/server/src/persistence/Services/OrchestrationEventStore.ts
@@ -1,15 +1,23 @@
 /**
- * OrchestrationEventStore - Event store interface for orchestration events.
+ * Historical name for the shared application event store.
  *
- * Owns durable append/replay access to the orchestration event stream. It does
- * not reduce events into read models or apply command validation rules.
+ * Owns durable append/replay access for project events and V2 agent-thread
+ * events under one global sequence. It does not reduce events into read models
+ * or apply command validation rules.
  *
  * Uses Effect `Context.Service` for dependency injection and exposes typed
  * persistence/decode errors for event append and replay operations.
  *
  * @module OrchestrationEventStore
  */
-import { OrchestrationEvent } from "@t3tools/contracts";
+import type {
+  ApplicationStoredEvent,
+  CommandId,
+  OrchestrationV2DomainEvent,
+  OrchestrationV2StoredEvent,
+  ThreadId,
+} from "@t3tools/contracts";
+import type { OrchestrationEvent } from "@t3tools/contracts/legacy-orchestration";
 import * as Context from "effect/Context";
 import type * as Effect from "effect/Effect";
 import type * as Stream from "effect/Stream";
@@ -53,6 +61,40 @@ export interface OrchestrationEventStoreShape {
    */
   readonly readAll: () => Stream.Stream<OrchestrationEvent, OrchestrationEventStoreError>;
 
+  /** Append V2 agent events to the same globally ordered application log. */
+  readonly appendAgentEvents: (input: {
+    readonly commandId?: CommandId;
+    readonly events: ReadonlyArray<OrchestrationV2DomainEvent>;
+  }) => Effect.Effect<ReadonlyArray<OrchestrationV2StoredEvent>, OrchestrationEventStoreError>;
+
+  /** Read only V2 thread events from the application log. */
+  readonly readAgentEvents: (input?: {
+    readonly afterSequence?: number;
+    readonly throughSequence?: number;
+    readonly threadId?: ThreadId;
+    readonly commandId?: CommandId;
+    readonly limit?: number;
+  }) => Stream.Stream<OrchestrationV2StoredEvent, OrchestrationEventStoreError>;
+
+  readonly latestAgentSequence: (
+    threadId?: ThreadId,
+  ) => Effect.Effect<number, OrchestrationEventStoreError>;
+
+  readonly latestApplicationSequence: Effect.Effect<number, OrchestrationEventStoreError>;
+
+  /** Read the finite retained application-event range `(afterSequence, throughSequence]`. */
+  readonly readApplicationEvents: (input: {
+    readonly afterSequence: number;
+    readonly throughSequence: number;
+  }) => Stream.Stream<ApplicationStoredEvent, OrchestrationEventStoreError>;
+
+  /** Publish only after the surrounding event/projection transaction commits. */
+  readonly publishCommitted: (events: ReadonlyArray<ApplicationStoredEvent>) => Effect.Effect<void>;
+
+  /** Race-free replay-to-live stream for project and V2 thread events. */
+  readonly streamApplicationEvents: (input?: {
+    readonly afterSequence?: number;
+  }) => Stream.Stream<ApplicationStoredEvent, OrchestrationEventStoreError>;
   /**
    * Check whether an aggregate has an event of the given type after a sequence.
    *
diff --git a/apps/server/src/persistence/Services/ProjectionCheckpoints.ts b/apps/server/src/persistence/Services/ProjectionCheckpoints.ts
index 7796ebec2a88..81f98c5cce0b 100644
--- a/apps/server/src/persistence/Services/ProjectionCheckpoints.ts
+++ b/apps/server/src/persistence/Services/ProjectionCheckpoints.ts
@@ -11,11 +11,13 @@ import {
   IsoDateTime,
   MessageId,
   NonNegativeInt,
-  OrchestrationCheckpointFile,
-  OrchestrationCheckpointStatus,
   ThreadId,
   TurnId,
 } from "@t3tools/contracts";
+import {
+  OrchestrationCheckpointFile,
+  OrchestrationCheckpointStatus,
+} from "@t3tools/contracts/legacy-orchestration";
 import * as Option from "effect/Option";
 import * as Context from "effect/Context";
 import * as Schema from "effect/Schema";
diff --git a/apps/server/src/persistence/Services/ProjectionPendingApprovals.ts b/apps/server/src/persistence/Services/ProjectionPendingApprovals.ts
index 40b0d1ae03b6..a319451e56de 100644
--- a/apps/server/src/persistence/Services/ProjectionPendingApprovals.ts
+++ b/apps/server/src/persistence/Services/ProjectionPendingApprovals.ts
@@ -6,14 +6,11 @@
  *
  * @module ProjectionPendingApprovalRepository
  */
+import { ApprovalRequestId, IsoDateTime, ThreadId, TurnId } from "@t3tools/contracts";
 import {
-  ApprovalRequestId,
-  IsoDateTime,
   ProjectionPendingApprovalDecision,
   ProjectionPendingApprovalStatus,
-  ThreadId,
-  TurnId,
-} from "@t3tools/contracts";
+} from "@t3tools/contracts/legacy-orchestration";
 import * as Option from "effect/Option";
 import * as Schema from "effect/Schema";
 import * as Context from "effect/Context";
diff --git a/apps/server/src/persistence/Services/ProjectionThreadActivities.ts b/apps/server/src/persistence/Services/ProjectionThreadActivities.ts
index 47cb6073c479..41a4e2955cf8 100644
--- a/apps/server/src/persistence/Services/ProjectionThreadActivities.ts
+++ b/apps/server/src/persistence/Services/ProjectionThreadActivities.ts
@@ -6,14 +6,8 @@
  *
  * @module ProjectionThreadActivityRepository
  */
-import {
-  EventId,
-  IsoDateTime,
-  NonNegativeInt,
-  OrchestrationThreadActivityTone,
-  ThreadId,
-  TurnId,
-} from "@t3tools/contracts";
+import { EventId, IsoDateTime, NonNegativeInt, ThreadId, TurnId } from "@t3tools/contracts";
+import { OrchestrationThreadActivityTone } from "@t3tools/contracts/legacy-orchestration";
 import * as Schema from "effect/Schema";
 import * as Context from "effect/Context";
 import type * as Effect from "effect/Effect";
diff --git a/apps/server/src/persistence/Services/ProjectionThreadMessages.ts b/apps/server/src/persistence/Services/ProjectionThreadMessages.ts
index d50ff3202563..8316016a0b8a 100644
--- a/apps/server/src/persistence/Services/ProjectionThreadMessages.ts
+++ b/apps/server/src/persistence/Services/ProjectionThreadMessages.ts
@@ -6,14 +6,8 @@
  *
  * @module ProjectionThreadMessageRepository
  */
-import {
-  ChatAttachment,
-  MessageId,
-  OrchestrationMessageRole,
-  ThreadId,
-  TurnId,
-  IsoDateTime,
-} from "@t3tools/contracts";
+import { ChatAttachment, MessageId, ThreadId, TurnId, IsoDateTime } from "@t3tools/contracts";
+import { OrchestrationMessageRole } from "@t3tools/contracts/legacy-orchestration";
 import * as Schema from "effect/Schema";
 import * as Context from "effect/Context";
 import type * as Option from "effect/Option";
diff --git a/apps/server/src/persistence/Services/ProjectionThreadProposedPlans.ts b/apps/server/src/persistence/Services/ProjectionThreadProposedPlans.ts
index b4bc2bcc3289..98403b7c2d20 100644
--- a/apps/server/src/persistence/Services/ProjectionThreadProposedPlans.ts
+++ b/apps/server/src/persistence/Services/ProjectionThreadProposedPlans.ts
@@ -1,10 +1,5 @@
-import {
-  IsoDateTime,
-  OrchestrationProposedPlanId,
-  ThreadId,
-  TrimmedNonEmptyString,
-  TurnId,
-} from "@t3tools/contracts";
+import { IsoDateTime, ThreadId, TrimmedNonEmptyString, TurnId } from "@t3tools/contracts";
+import { OrchestrationProposedPlanId } from "@t3tools/contracts/legacy-orchestration";
 import * as Schema from "effect/Schema";
 import * as Context from "effect/Context";
 import type * as Effect from "effect/Effect";
diff --git a/apps/server/src/persistence/Services/ProjectionThreadSessions.ts b/apps/server/src/persistence/Services/ProjectionThreadSessions.ts
index 7cecac33eb6a..e459800d24d0 100644
--- a/apps/server/src/persistence/Services/ProjectionThreadSessions.ts
+++ b/apps/server/src/persistence/Services/ProjectionThreadSessions.ts
@@ -6,14 +6,8 @@
  *
  * @module ProjectionThreadSessionRepository
  */
-import {
-  RuntimeMode,
-  IsoDateTime,
-  OrchestrationSessionStatus,
-  ProviderInstanceId,
-  ThreadId,
-  TurnId,
-} from "@t3tools/contracts";
+import { RuntimeMode, IsoDateTime, ProviderInstanceId, ThreadId, TurnId } from "@t3tools/contracts";
+import { OrchestrationSessionStatus } from "@t3tools/contracts/legacy-orchestration";
 import * as Option from "effect/Option";
 import * as Schema from "effect/Schema";
 import * as Context from "effect/Context";
diff --git a/apps/server/src/persistence/Services/ProjectionTurns.ts b/apps/server/src/persistence/Services/ProjectionTurns.ts
index f3d5d5e47061..81b43001af2d 100644
--- a/apps/server/src/persistence/Services/ProjectionTurns.ts
+++ b/apps/server/src/persistence/Services/ProjectionTurns.ts
@@ -11,12 +11,14 @@ import {
   IsoDateTime,
   MessageId,
   NonNegativeInt,
-  OrchestrationProposedPlanId,
-  OrchestrationCheckpointFile,
-  OrchestrationCheckpointStatus,
   ThreadId,
   TurnId,
 } from "@t3tools/contracts";
+import {
+  OrchestrationCheckpointFile,
+  OrchestrationCheckpointStatus,
+  OrchestrationProposedPlanId,
+} from "@t3tools/contracts/legacy-orchestration";
 import * as Option from "effect/Option";
 import * as Schema from "effect/Schema";
 import * as Context from "effect/Context";
diff --git a/apps/server/src/project/ProjectEnrichmentService.test.ts b/apps/server/src/project/ProjectEnrichmentService.test.ts
new file mode 100644
index 000000000000..a5f050fe9d04
--- /dev/null
+++ b/apps/server/src/project/ProjectEnrichmentService.test.ts
@@ -0,0 +1,343 @@
+import { assert, it } from "@effect/vitest";
+import type { RepositoryIdentity } from "@t3tools/contracts";
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as PubSub from "effect/PubSub";
+import * as Ref from "effect/Ref";
+
+import * as ProjectEnrichment from "./ProjectEnrichmentService.ts";
+import * as ProjectFaviconResolver from "./ProjectFaviconResolver.ts";
+import * as RepositoryIdentityResolver from "./RepositoryIdentityResolver.ts";
+
+const identity = (workspaceRoot: string, version = 1): RepositoryIdentity => ({
+  canonicalKey: `example.test/v${version}${workspaceRoot}`,
+  locator: {
+    source: "git-remote",
+    remoteName: "origin",
+    remoteUrl: `https://example.test/v${version}${workspaceRoot}.git`,
+  },
+  rootPath: workspaceRoot,
+});
+
+const waitForAvailable = Effect.fn("ProjectEnrichmentServiceTest.waitForAvailable")(function* (
+  service: ProjectEnrichment.ProjectEnrichmentService["Service"],
+  workspaceRoot: string,
+  predicate: (value: ProjectEnrichment.ProjectEnrichment) => boolean,
+) {
+  for (let attempt = 0; attempt < 100; attempt += 1) {
+    const available = yield* service.peek(workspaceRoot);
+    if (predicate(available)) return available;
+    yield* Effect.yieldNow;
+  }
+  return yield* Effect.die(`Project metadata for ${workspaceRoot} was not resolved in time.`);
+});
+
+const makeLayer = (
+  metadataLayer: Layer.Layer<
+    | ProjectFaviconResolver.ProjectFaviconResolver
+    | RepositoryIdentityResolver.RepositoryIdentityResolver
+  >,
+  options: ProjectEnrichment.ProjectEnrichmentServiceOptions = {},
+) =>
+  Layer.effect(ProjectEnrichment.ProjectEnrichmentService, ProjectEnrichment.make(options)).pipe(
+    Layer.provide(metadataLayer),
+  );
+
+it.effect("preserves either enrichment field when the other resolver fails", () =>
+  Effect.gen(function* () {
+    const metadataLayer = Layer.merge(
+      Layer.succeed(RepositoryIdentityResolver.RepositoryIdentityResolver, {
+        resolve: (workspaceRoot) =>
+          workspaceRoot === "/repo-fails"
+            ? Effect.die("repository resolver failed")
+            : Effect.succeed(identity(workspaceRoot)),
+      }),
+      Layer.succeed(ProjectFaviconResolver.ProjectFaviconResolver, {
+        resolvePath: (workspaceRoot) =>
+          workspaceRoot === "/favicon-fails"
+            ? Effect.fail(
+                new ProjectFaviconResolver.ProjectFaviconResolutionError({
+                  operation: "stat-candidate",
+                  workspaceRoot,
+                  cause: "favicon resolver failed",
+                }),
+              )
+            : Effect.succeed(`${workspaceRoot}/favicon.svg`),
+      }),
+    );
+
+    yield* Effect.gen(function* () {
+      const service = yield* ProjectEnrichment.ProjectEnrichmentService;
+      yield* service.request("/favicon-fails");
+      yield* service.request("/repo-fails");
+
+      const faviconFailure = yield* waitForAvailable(
+        service,
+        "/favicon-fails",
+        (value) => value.repositoryIdentity !== null,
+      );
+      assert.equal(
+        faviconFailure.repositoryIdentity?.canonicalKey,
+        "example.test/v1/favicon-fails",
+      );
+      assert.isNull(faviconFailure.faviconPath);
+
+      const repositoryFailure = yield* waitForAvailable(
+        service,
+        "/repo-fails",
+        (value) => value.faviconPath !== null,
+      );
+      assert.isNull(repositoryFailure.repositoryIdentity);
+      assert.equal(repositoryFailure.faviconPath, "/repo-fails/favicon.svg");
+    }).pipe(Effect.provide(makeLayer(metadataLayer)));
+  }),
+);
+
+it.effect("publishes repository completion while favicon enrichment is still pending", () =>
+  Effect.gen(function* () {
+    const releaseFavicon = yield* Deferred.make<void>();
+    const metadataLayer = Layer.merge(
+      Layer.succeed(RepositoryIdentityResolver.RepositoryIdentityResolver, {
+        resolve: (workspaceRoot) => Effect.succeed(identity(workspaceRoot)),
+      }),
+      Layer.succeed(ProjectFaviconResolver.ProjectFaviconResolver, {
+        resolvePath: (workspaceRoot) =>
+          Deferred.await(releaseFavicon).pipe(Effect.as(`${workspaceRoot}/favicon.svg`)),
+      }),
+    );
+
+    yield* Effect.gen(function* () {
+      const service = yield* ProjectEnrichment.ProjectEnrichmentService;
+      const changes = yield* service.subscribeChanges;
+      yield* service.request("/completed");
+
+      const change = yield* PubSub.take(changes);
+      assert.equal(change.workspaceRoot, "/completed");
+      assert.isTrue(change.repositoryIdentityResolved);
+      assert.equal(change.enrichment.repositoryIdentity?.canonicalKey, "example.test/v1/completed");
+      assert.isNull(change.enrichment.faviconPath);
+    }).pipe(Effect.provide(makeLayer(metadataLayer)));
+  }),
+);
+
+it.effect("keeps repository workers available when every favicon worker is hung", () =>
+  Effect.gen(function* () {
+    const faviconWorkersStarted = yield* Deferred.make<void>();
+    const faviconStarts = yield* Ref.make(0);
+    const metadataLayer = Layer.merge(
+      Layer.succeed(RepositoryIdentityResolver.RepositoryIdentityResolver, {
+        resolve: (workspaceRoot) => Effect.succeed(identity(workspaceRoot)),
+      }),
+      Layer.succeed(ProjectFaviconResolver.ProjectFaviconResolver, {
+        resolvePath: () =>
+          Effect.gen(function* () {
+            const started = yield* Ref.updateAndGet(faviconStarts, (count) => count + 1);
+            if (started === 2) {
+              yield* Deferred.succeed(faviconWorkersStarted, undefined);
+            }
+            return yield* Effect.never;
+          }),
+      }),
+    );
+
+    yield* Effect.gen(function* () {
+      const service = yield* ProjectEnrichment.ProjectEnrichmentService;
+      yield* service.request("/favicon-hung-a");
+      yield* service.request("/favicon-hung-b");
+      yield* Deferred.await(faviconWorkersStarted);
+
+      yield* service.request("/repository-later");
+      const available = yield* waitForAvailable(
+        service,
+        "/repository-later",
+        (value) => value.repositoryIdentity !== null,
+      );
+
+      assert.equal(available.repositoryIdentity?.canonicalKey, "example.test/v1/repository-later");
+      assert.equal(yield* Ref.get(faviconStarts), 2);
+    }).pipe(
+      Effect.provide(
+        makeLayer(metadataLayer, {
+          cacheCapacity: 8,
+          maxPending: 4,
+          concurrency: 2,
+        }),
+      ),
+    );
+  }),
+);
+
+it.effect("getAvailable returns immediately while repository identity is still unresolved", () =>
+  Effect.gen(function* () {
+    const repositoryStarted = yield* Deferred.make<void>();
+    const releaseRepository = yield* Deferred.make<void>();
+    const metadataLayer = Layer.merge(
+      Layer.succeed(RepositoryIdentityResolver.RepositoryIdentityResolver, {
+        resolve: (workspaceRoot) =>
+          Deferred.succeed(repositoryStarted, undefined).pipe(
+            Effect.andThen(Deferred.await(releaseRepository)),
+            Effect.as(identity(workspaceRoot)),
+          ),
+      }),
+      Layer.succeed(ProjectFaviconResolver.ProjectFaviconResolver, {
+        resolvePath: (workspaceRoot) => Effect.succeed(`${workspaceRoot}/favicon.svg`),
+      }),
+    );
+
+    yield* Effect.gen(function* () {
+      const service = yield* ProjectEnrichment.ProjectEnrichmentService;
+
+      // Non-blocking path must not wait on hung git/identity resolution.
+      const immediate = yield* service.getAvailable("/pending-identity");
+      assert.isNull(immediate.repositoryIdentity);
+      assert.isNull(immediate.faviconPath);
+      assert.isFalse(immediate.repositoryIdentityResolved);
+
+      yield* Deferred.await(repositoryStarted);
+
+      // Background lane still resolves after the snapshot path has returned.
+      yield* Deferred.succeed(releaseRepository, undefined);
+      const resolved = yield* waitForAvailable(
+        service,
+        "/pending-identity",
+        (value) => value.repositoryIdentity !== null,
+      );
+      assert.equal(resolved.repositoryIdentity?.canonicalKey, "example.test/v1/pending-identity");
+      assert.isTrue(resolved.repositoryIdentityResolved);
+    }).pipe(Effect.provide(makeLayer(metadataLayer)));
+  }),
+);
+
+it.effect(
+  "reports successful cached null as resolved while cold and failed lookups stay unresolved",
+  () =>
+    Effect.gen(function* () {
+      const repositoryStarted = yield* Deferred.make<void>();
+      const releaseRepository = yield* Deferred.make<void>();
+      const metadataLayer = Layer.merge(
+        Layer.succeed(RepositoryIdentityResolver.RepositoryIdentityResolver, {
+          resolve: (workspaceRoot) => {
+            if (workspaceRoot === "/no-remote") {
+              return Effect.succeed(null);
+            }
+            if (workspaceRoot === "/fails") {
+              return Effect.die("repository resolver failed");
+            }
+            return Deferred.succeed(repositoryStarted, undefined).pipe(
+              Effect.andThen(Deferred.await(releaseRepository)),
+              Effect.as(identity(workspaceRoot)),
+            );
+          },
+        }),
+        Layer.succeed(ProjectFaviconResolver.ProjectFaviconResolver, {
+          resolvePath: () => Effect.succeed(null),
+        }),
+      );
+
+      yield* Effect.gen(function* () {
+        const service = yield* ProjectEnrichment.ProjectEnrichmentService;
+        const changes = yield* service.subscribeChanges;
+
+        const cold = yield* service.peek("/never-requested");
+        assert.isNull(cold.repositoryIdentity);
+        assert.isFalse(cold.repositoryIdentityResolved);
+
+        const inFlight = yield* service.getAvailable("/in-flight");
+        assert.isNull(inFlight.repositoryIdentity);
+        assert.isFalse(inFlight.repositoryIdentityResolved);
+        yield* Deferred.await(repositoryStarted);
+        assert.isFalse((yield* service.peek("/in-flight")).repositoryIdentityResolved);
+
+        yield* service.request("/no-remote");
+        const nullChange = yield* PubSub.take(changes);
+        assert.equal(nullChange.workspaceRoot, "/no-remote");
+        assert.isTrue(nullChange.repositoryIdentityResolved);
+        assert.isNull(nullChange.enrichment.repositoryIdentity);
+        assert.isTrue(nullChange.enrichment.repositoryIdentityResolved);
+
+        // Warm success null stays resolved and does not republish.
+        const warmNull = yield* service.getAvailable("/no-remote");
+        assert.isNull(warmNull.repositoryIdentity);
+        assert.isTrue(warmNull.repositoryIdentityResolved);
+
+        yield* service.request("/fails");
+        const failChange = yield* PubSub.take(changes);
+        assert.equal(failChange.workspaceRoot, "/fails");
+        assert.isFalse(failChange.repositoryIdentityResolved);
+        const failed = yield* service.peek("/fails");
+        assert.isNull(failed.repositoryIdentity);
+        assert.isFalse(failed.repositoryIdentityResolved);
+      }).pipe(Effect.provide(makeLayer(metadataLayer)));
+    }),
+);
+
+it.effect("deduplicates requests, bounds pending work, and reloads invalidated roots", () =>
+  Effect.gen(function* () {
+    const firstStarted = yield* Deferred.make<void>();
+    const releaseFirst = yield* Deferred.make<void>();
+    const repositoryCalls = yield* Ref.make<ReadonlyArray<string>>([]);
+    const version = yield* Ref.make(1);
+    const metadataLayer = Layer.merge(
+      Layer.succeed(RepositoryIdentityResolver.RepositoryIdentityResolver, {
+        resolve: (workspaceRoot) =>
+          Effect.gen(function* () {
+            yield* Ref.update(repositoryCalls, (calls) => [...calls, workspaceRoot]);
+            if (workspaceRoot === "/first" && (yield* Ref.get(version)) === 1) {
+              yield* Deferred.succeed(firstStarted, undefined);
+              yield* Deferred.await(releaseFirst);
+            }
+            return identity(workspaceRoot, yield* Ref.get(version));
+          }),
+      }),
+      Layer.succeed(ProjectFaviconResolver.ProjectFaviconResolver, {
+        resolvePath: (workspaceRoot) => Effect.succeed(`${workspaceRoot}/favicon.svg`),
+      }),
+    );
+
+    yield* Effect.gen(function* () {
+      const service = yield* ProjectEnrichment.ProjectEnrichmentService;
+      yield* Effect.forEach(Array.from({ length: 20 }), () => service.request("/first"), {
+        concurrency: "unbounded",
+        discard: true,
+      });
+      yield* Deferred.await(firstStarted);
+      yield* service.request("/second");
+      yield* service.request("/dropped");
+      assert.deepEqual(yield* Ref.get(repositoryCalls), ["/first"]);
+
+      yield* Deferred.succeed(releaseFirst, undefined);
+      yield* waitForAvailable(service, "/second", (value) => value.repositoryIdentity !== null);
+      assert.deepEqual(yield* Ref.get(repositoryCalls), ["/first", "/second"]);
+
+      yield* service.request("/dropped");
+      yield* waitForAvailable(service, "/dropped", (value) => value.repositoryIdentity !== null);
+      assert.deepEqual(yield* Ref.get(repositoryCalls), ["/first", "/second", "/dropped"]);
+
+      yield* Ref.set(version, 2);
+      yield* service.invalidate(["/first"]);
+      const invalidated = yield* service.getAvailable("/first");
+      assert.isNull(invalidated.repositoryIdentity);
+      const refreshed = yield* waitForAvailable(
+        service,
+        "/first",
+        (value) => value.repositoryIdentity?.canonicalKey === "example.test/v2/first",
+      );
+      assert.equal(refreshed.repositoryIdentity?.canonicalKey, "example.test/v2/first");
+      assert.deepEqual(yield* Ref.get(repositoryCalls), [
+        "/first",
+        "/second",
+        "/dropped",
+        "/first",
+      ]);
+    }).pipe(
+      Effect.provide(
+        makeLayer(metadataLayer, {
+          cacheCapacity: 8,
+          maxPending: 2,
+          concurrency: 1,
+        }),
+      ),
+    );
+  }),
+);
diff --git a/apps/server/src/project/ProjectEnrichmentService.ts b/apps/server/src/project/ProjectEnrichmentService.ts
new file mode 100644
index 000000000000..93f6c5c854a1
--- /dev/null
+++ b/apps/server/src/project/ProjectEnrichmentService.ts
@@ -0,0 +1,297 @@
+import type { RepositoryIdentity } from "@t3tools/contracts";
+import * as Cache from "effect/Cache";
+import * as Cause from "effect/Cause";
+import * as Context from "effect/Context";
+import * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as PubSub from "effect/PubSub";
+import * as Queue from "effect/Queue";
+import * as Ref from "effect/Ref";
+import type * as Scope from "effect/Scope";
+
+import * as ProjectFaviconResolver from "./ProjectFaviconResolver.ts";
+import * as RepositoryIdentityResolver from "./RepositoryIdentityResolver.ts";
+
+const DEFAULT_CACHE_CAPACITY = 512;
+const DEFAULT_MAX_PENDING = 512;
+const DEFAULT_CONCURRENCY = 4;
+const DEFAULT_SUCCESS_TTL = Duration.minutes(1);
+const DEFAULT_FAILURE_TTL = Duration.seconds(5);
+
+export interface ProjectEnrichment {
+  readonly repositoryIdentity: RepositoryIdentity | null;
+  readonly faviconPath: string | null;
+  /** True when identity resolution completed successfully, including cached null. */
+  readonly repositoryIdentityResolved: boolean;
+}
+
+export interface ProjectEnrichmentChange {
+  readonly workspaceRoot: string;
+  readonly enrichment: ProjectEnrichment;
+  readonly repositoryIdentityResolved: boolean;
+}
+
+export interface ProjectEnrichmentServiceOptions {
+  readonly cacheCapacity?: number;
+  /** Maximum active and queued roots for each enrichment field. */
+  readonly maxPending?: number;
+  /** Worker concurrency for each enrichment field. */
+  readonly concurrency?: number;
+  readonly successTtl?: Duration.Input;
+  readonly failureTtl?: Duration.Input;
+}
+
+export class ProjectEnrichmentService extends Context.Service<
+  ProjectEnrichmentService,
+  {
+    /** Read resolved metadata without starting or awaiting filesystem work. */
+    readonly peek: (workspaceRoot: string) => Effect.Effect<ProjectEnrichment>;
+    /** Schedule missing metadata for bounded background resolution. */
+    readonly request: (workspaceRoot: string) => Effect.Effect<void>;
+    /** Read immediately available metadata and schedule anything missing. */
+    readonly getAvailable: (workspaceRoot: string) => Effect.Effect<ProjectEnrichment>;
+    /** Invalidate workspace-derived metadata. */
+    readonly invalidate: (workspaceRoots: Iterable<string>) => Effect.Effect<void>;
+    /** Subscribe to ephemeral completion notifications. */
+    readonly subscribeChanges: Effect.Effect<
+      PubSub.Subscription<ProjectEnrichmentChange>,
+      never,
+      Scope.Scope
+    >;
+  }
+>()("t3/project/ProjectEnrichmentService") {}
+
+function availableValue<A, E>(cached: Option.Option<Exit.Exit<A, E>>): A | null {
+  return Option.match(cached, {
+    onNone: () => null,
+    onSome: (exit) =>
+      Exit.match(exit, {
+        onFailure: () => null,
+        onSuccess: (value) => value,
+      }),
+  });
+}
+
+function isSuccessfullyResolved<A, E>(cached: Option.Option<Exit.Exit<A, E>>): boolean {
+  return Option.match(cached, {
+    onNone: () => false,
+    onSome: (exit) => Exit.isSuccess(exit),
+  });
+}
+
+interface EnrichmentWorkLane {
+  readonly pendingRoots: Ref.Ref<ReadonlySet<string>>;
+  readonly queue: Queue.Queue<string>;
+}
+
+export const make = Effect.fn("ProjectEnrichmentService.make")(function* (
+  options: ProjectEnrichmentServiceOptions = {},
+) {
+  const repositoryIdentityResolver = yield* RepositoryIdentityResolver.RepositoryIdentityResolver;
+  const faviconResolver = yield* ProjectFaviconResolver.ProjectFaviconResolver;
+  const cacheCapacity = Math.max(1, options.cacheCapacity ?? DEFAULT_CACHE_CAPACITY);
+  const maxPending = Math.max(1, options.maxPending ?? DEFAULT_MAX_PENDING);
+  const concurrency = Math.max(1, options.concurrency ?? DEFAULT_CONCURRENCY);
+  const successTtl = options.successTtl ?? DEFAULT_SUCCESS_TTL;
+  const failureTtl = options.failureTtl ?? DEFAULT_FAILURE_TTL;
+
+  const repositoryIdentityCache = yield* Cache.makeWith(
+    (workspaceRoot: string) => Effect.exit(repositoryIdentityResolver.resolve(workspaceRoot)),
+    {
+      capacity: cacheCapacity,
+      timeToLive: Exit.match({
+        onFailure: () => failureTtl,
+        onSuccess: (result) => (Exit.isSuccess(result) ? successTtl : failureTtl),
+      }),
+    },
+  );
+  const faviconCache = yield* Cache.makeWith(
+    (workspaceRoot: string) => Effect.exit(faviconResolver.resolvePath(workspaceRoot)),
+    {
+      capacity: cacheCapacity,
+      timeToLive: Exit.match({
+        onFailure: () => failureTtl,
+        onSuccess: (result) => (Exit.isSuccess(result) ? successTtl : failureTtl),
+      }),
+    },
+  );
+  const makeWorkLane = Effect.gen(function* () {
+    const pendingRoots = yield* Ref.make<ReadonlySet<string>>(new Set());
+    const queue = yield* Effect.acquireRelease(Queue.dropping<string>(maxPending), (queue) =>
+      Queue.shutdown(queue),
+    );
+    return { pendingRoots, queue } satisfies EnrichmentWorkLane;
+  });
+  const repositoryIdentityLane = yield* makeWorkLane;
+  const faviconLane = yield* makeWorkLane;
+  const changes = yield* Effect.acquireRelease(
+    PubSub.sliding<ProjectEnrichmentChange>(256),
+    (pubsub) => PubSub.shutdown(pubsub),
+  );
+
+  const removePending = (lane: EnrichmentWorkLane, workspaceRoot: string) =>
+    Ref.update(lane.pendingRoots, (current) => {
+      if (!current.has(workspaceRoot)) return current;
+      const next = new Set(current);
+      next.delete(workspaceRoot);
+      return next;
+    });
+
+  const reservePending = (lane: EnrichmentWorkLane, workspaceRoot: string) =>
+    Ref.modify(lane.pendingRoots, (current) => {
+      if (current.has(workspaceRoot) || current.size >= maxPending) {
+        return [false, current] as const;
+      }
+      const next = new Set(current);
+      next.add(workspaceRoot);
+      return [true, next] as const;
+    });
+
+  const logFailure = <A, E>(
+    workspaceRoot: string,
+    field: "repositoryIdentity" | "faviconPath",
+    result: Exit.Exit<A, E>,
+  ) =>
+    Exit.isFailure(result)
+      ? Effect.logWarning("Failed to enrich optional project metadata", {
+          workspaceRoot,
+          field,
+          cause: Cause.pretty(result.cause),
+        })
+      : Effect.void;
+
+  const resolveRepositoryIdentity = Effect.fn("ProjectEnrichmentService.resolveRepositoryIdentity")(
+    function* (workspaceRoot: string) {
+      const repositoryIdentity = yield* Cache.get(repositoryIdentityCache, workspaceRoot);
+      yield* logFailure(workspaceRoot, "repositoryIdentity", repositoryIdentity);
+      const faviconPath = yield* Cache.getSuccess(faviconCache, workspaceRoot);
+      const repositoryIdentityResolved = Exit.isSuccess(repositoryIdentity);
+      yield* PubSub.publish(changes, {
+        workspaceRoot,
+        repositoryIdentityResolved,
+        enrichment: {
+          repositoryIdentity: availableValue(Option.some(repositoryIdentity)),
+          faviconPath: availableValue(faviconPath),
+          repositoryIdentityResolved,
+        },
+      });
+    },
+  );
+
+  const resolveFavicon = Effect.fn("ProjectEnrichmentService.resolveFavicon")(function* (
+    workspaceRoot: string,
+  ) {
+    const faviconPath = yield* Cache.get(faviconCache, workspaceRoot);
+    yield* logFailure(workspaceRoot, "faviconPath", faviconPath);
+  });
+
+  const startWorkers = (
+    lane: EnrichmentWorkLane,
+    resolve: (workspaceRoot: string) => Effect.Effect<void>,
+  ) => {
+    const worker = Queue.take(lane.queue).pipe(
+      Effect.flatMap((workspaceRoot) =>
+        resolve(workspaceRoot).pipe(Effect.ensuring(removePending(lane, workspaceRoot))),
+      ),
+      Effect.forever,
+    );
+    return Effect.forEach(Array.from({ length: concurrency }), () => Effect.forkScoped(worker), {
+      discard: true,
+    });
+  };
+  yield* Effect.all(
+    [
+      startWorkers(repositoryIdentityLane, resolveRepositoryIdentity),
+      startWorkers(faviconLane, resolveFavicon),
+    ],
+    { concurrency: "unbounded", discard: true },
+  );
+
+  const requestLane = Effect.fn("ProjectEnrichmentService.requestLane")(function* (
+    lane: EnrichmentWorkLane,
+    workspaceRoot: string,
+    field: "repositoryIdentity" | "faviconPath",
+  ) {
+    if (!(yield* reservePending(lane, workspaceRoot))) return;
+    if (!(yield* Queue.offer(lane.queue, workspaceRoot))) {
+      yield* removePending(lane, workspaceRoot);
+      yield* Effect.logWarning("Project metadata enrichment queue is full", {
+        workspaceRoot,
+        field,
+      });
+    }
+  });
+
+  const peek: ProjectEnrichmentService["Service"]["peek"] = Effect.fn(
+    "ProjectEnrichmentService.peek",
+  )(function* (workspaceRoot) {
+    const [repositoryIdentity, faviconPath] = yield* Effect.all(
+      [
+        Cache.getSuccess(repositoryIdentityCache, workspaceRoot),
+        Cache.getSuccess(faviconCache, workspaceRoot),
+      ] as const,
+      { concurrency: "unbounded" },
+    );
+    return {
+      repositoryIdentity: availableValue(repositoryIdentity),
+      faviconPath: availableValue(faviconPath),
+      repositoryIdentityResolved: isSuccessfullyResolved(repositoryIdentity),
+    };
+  });
+
+  const request: ProjectEnrichmentService["Service"]["request"] = Effect.fn(
+    "ProjectEnrichmentService.request",
+  )(function* (workspaceRoot) {
+    const [hasRepositoryIdentity, hasFaviconPath] = yield* Effect.all(
+      [Cache.has(repositoryIdentityCache, workspaceRoot), Cache.has(faviconCache, workspaceRoot)],
+      { concurrency: "unbounded" },
+    );
+    yield* Effect.all(
+      [
+        hasRepositoryIdentity
+          ? Effect.void
+          : requestLane(repositoryIdentityLane, workspaceRoot, "repositoryIdentity"),
+        hasFaviconPath ? Effect.void : requestLane(faviconLane, workspaceRoot, "faviconPath"),
+      ],
+      { concurrency: "unbounded", discard: true },
+    );
+  });
+
+  const getAvailable: ProjectEnrichmentService["Service"]["getAvailable"] = Effect.fn(
+    "ProjectEnrichmentService.getAvailable",
+  )(function* (workspaceRoot) {
+    const available = yield* peek(workspaceRoot);
+    yield* request(workspaceRoot);
+    return available;
+  });
+
+  const invalidate: ProjectEnrichmentService["Service"]["invalidate"] = Effect.fn(
+    "ProjectEnrichmentService.invalidate",
+  )(function* (workspaceRoots) {
+    yield* Effect.forEach(
+      new Set(workspaceRoots),
+      (workspaceRoot) =>
+        Effect.all(
+          [
+            Cache.invalidate(repositoryIdentityCache, workspaceRoot),
+            Cache.invalidate(faviconCache, workspaceRoot),
+          ],
+          { concurrency: "unbounded", discard: true },
+        ),
+      { discard: true },
+    );
+  });
+
+  return ProjectEnrichmentService.of({
+    peek,
+    request,
+    getAvailable,
+    invalidate,
+    subscribeChanges: PubSub.subscribe(changes),
+  });
+});
+
+export const layer = Layer.effect(ProjectEnrichmentService, make());
diff --git a/apps/server/src/project/ProjectService.test.ts b/apps/server/src/project/ProjectService.test.ts
new file mode 100644
index 000000000000..c4a877edc8ae
--- /dev/null
+++ b/apps/server/src/project/ProjectService.test.ts
@@ -0,0 +1,412 @@
+import { assert, it } from "@effect/vitest";
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import { CommandId, type Project, ProjectId, ProviderInstanceId } from "@t3tools/contracts";
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+import * as Fiber from "effect/Fiber";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Ref from "effect/Ref";
+import { TestClock } from "effect/testing";
+import * as SqlClient from "effect/unstable/sql/SqlClient";
+
+import { ServerConfig } from "../config.ts";
+import { ProjectServiceLayerLive } from "../orchestration-v2/runtimeLayer.ts";
+import { SqlitePersistenceMemory } from "../persistence/Layers/Sqlite.ts";
+import * as WorkspacePaths from "../workspace/WorkspacePaths.ts";
+import * as ProjectEnrichmentService from "./ProjectEnrichmentService.ts";
+import * as ProjectFaviconResolver from "./ProjectFaviconResolver.ts";
+import * as ProjectService from "./ProjectService.ts";
+import * as RepositoryIdentityResolver from "./RepositoryIdentityResolver.ts";
+
+const workspacePathsLayer = Layer.succeed(WorkspacePaths.WorkspacePaths, {
+  normalizeWorkspaceRoot: (workspaceRoot) => Effect.succeed(workspaceRoot.replace(/\/$/, "")),
+  resolveRelativePathWithinRoot: ({ workspaceRoot, relativePath }) =>
+    Effect.succeed({ absolutePath: `${workspaceRoot}/${relativePath}`, relativePath }),
+});
+
+const metadataLayer = Layer.merge(
+  Layer.succeed(RepositoryIdentityResolver.RepositoryIdentityResolver, {
+    resolve: (workspaceRoot) =>
+      Effect.succeed({
+        canonicalKey: `github.com/t3tools/${workspaceRoot.split("/").at(-1)}`,
+        locator: {
+          source: "git-remote" as const,
+          remoteName: "origin",
+          remoteUrl: `git@github.com:t3tools/${workspaceRoot.split("/").at(-1)}.git`,
+        },
+        rootPath: workspaceRoot,
+      }),
+  }),
+  Layer.succeed(ProjectFaviconResolver.ProjectFaviconResolver, {
+    resolvePath: (workspaceRoot) => Effect.succeed(`${workspaceRoot}/favicon.svg`),
+  }),
+);
+
+const makeTestLayer = (
+  projectMetadataLayer: Layer.Layer<
+    | ProjectFaviconResolver.ProjectFaviconResolver
+    | RepositoryIdentityResolver.RepositoryIdentityResolver
+  >,
+) =>
+  ProjectServiceLayerLive.pipe(
+    Layer.provideMerge(ProjectEnrichmentService.layer),
+    Layer.provideMerge(workspacePathsLayer),
+    Layer.provideMerge(projectMetadataLayer),
+    Layer.provideMerge(SqlitePersistenceMemory),
+    Layer.provide(ServerConfig.layerTest(process.cwd(), { prefix: "project-service-test-" })),
+    Layer.provide(NodeServices.layer),
+  );
+
+const TestLayer = makeTestLayer(metadataLayer);
+
+const waitForProject = Effect.fn("ProjectServiceTest.waitForProject")(function* (
+  service: ProjectService.ProjectService["Service"],
+  projectId: ProjectId,
+  predicate: (project: Project) => boolean,
+) {
+  for (let attempt = 0; attempt < 100; attempt += 1) {
+    const project = Option.getOrThrow(yield* service.getById(projectId));
+    if (predicate(project)) return project;
+    yield* Effect.yieldNow;
+  }
+  return yield* Effect.die(`Project ${projectId} was not enriched in time.`);
+});
+
+it.layer(TestLayer)("ProjectService", (it) => {
+  it.effect("creates, updates, resolves, snapshots, and soft-deletes projects", () =>
+    Effect.gen(function* () {
+      const service = yield* ProjectService.ProjectService;
+      const projectId = ProjectId.make("project:service-test");
+      const modelSelection = {
+        instanceId: ProviderInstanceId.make("codex_custom"),
+        model: "gpt-5.1-codex",
+      } as const;
+      yield* TestClock.setTime(Date.parse("2026-06-20T10:00:00.000Z"));
+
+      const created = yield* service.create({
+        commandId: CommandId.make("command:project:create"),
+        projectId,
+        title: "Project",
+        workspaceRoot: "/work/project/",
+        defaultModelSelection: modelSelection,
+        scripts: [
+          {
+            id: "setup",
+            name: "Setup",
+            command: "vp install",
+            icon: "configure",
+            runOnWorktreeCreate: true,
+          },
+        ],
+      });
+      assert.equal(created.workspaceRoot, "/work/project");
+      assert.isNull(created.repositoryIdentity);
+      assert.isNull(created.faviconPath);
+
+      const hydratedCreated = yield* waitForProject(
+        service,
+        projectId,
+        (project) => project.repositoryIdentity !== null && project.faviconPath !== null,
+      );
+      assert.equal(hydratedCreated?.repositoryIdentity?.canonicalKey, "github.com/t3tools/project");
+      assert.equal(hydratedCreated?.faviconPath, "/work/project/favicon.svg");
+
+      const updated = yield* service.update({
+        commandId: CommandId.make("command:project:update"),
+        projectId,
+        title: "Renamed",
+      });
+      assert.equal(updated.title, "Renamed");
+      assert.equal(updated.createdAt, created.createdAt);
+
+      const byId = yield* service.getById(projectId);
+      const byWorkspace = yield* service.getByWorkspaceRoot("/work/project/");
+      assert.isTrue(Option.isSome(byId));
+      assert.isTrue(Option.isSome(byWorkspace));
+      assert.equal(Option.getOrThrow(byWorkspace).id, projectId);
+      assert.deepEqual(
+        (yield* service.snapshot).projects.map((project) => project.id),
+        [projectId],
+      );
+
+      const deleted = yield* service.delete({
+        commandId: CommandId.make("command:project:delete"),
+        projectId,
+      });
+      assert.isNotNull(deleted.deletedAt);
+      assert.isTrue(Option.isNone(yield* service.getById(projectId)));
+      assert.isTrue(Option.isSome(yield* service.getById(projectId, { includeDeleted: true })));
+      assert.deepEqual((yield* service.snapshot).projects, []);
+
+      const sql = yield* SqlClient.SqlClient;
+      const changes = yield* sql<{ readonly event_type: string }>`
+        SELECT event_type
+        FROM orchestration_events
+        WHERE aggregate_kind = 'project' AND stream_id = ${projectId}
+        ORDER BY sequence ASC
+      `;
+      assert.deepEqual(
+        changes.map((change) => change.event_type),
+        ["project.created", "project.meta-updated", "project.deleted"],
+      );
+    }),
+  );
+
+  it.effect("rejects active workspace collisions", () =>
+    Effect.gen(function* () {
+      const service = yield* ProjectService.ProjectService;
+      yield* TestClock.setTime(Date.parse("2026-06-20T10:00:00.000Z"));
+      yield* service.create({
+        commandId: CommandId.make("command:collision:first"),
+        projectId: ProjectId.make("project:collision:first"),
+        title: "First",
+        workspaceRoot: "/work/shared",
+      });
+      const error = yield* service
+        .create({
+          commandId: CommandId.make("command:collision:second"),
+          projectId: ProjectId.make("project:collision:second"),
+          title: "Second",
+          workspaceRoot: "/work/shared",
+        })
+        .pipe(Effect.flip);
+      assert.equal(error._tag, "ProjectConflictError");
+    }),
+  );
+
+  it.effect("auto-bootstraps a workspace exactly once", () =>
+    Effect.gen(function* () {
+      const service = yield* ProjectService.ProjectService;
+      yield* TestClock.setTime(Date.parse("2026-06-20T10:00:00.000Z"));
+      const input = {
+        commandId: CommandId.make("command:bootstrap:first"),
+        projectId: ProjectId.make("project:bootstrap"),
+        title: "Bootstrap",
+        workspaceRoot: "/work/bootstrap/",
+      };
+      const first = yield* service.bootstrap(input);
+      const second = yield* service.bootstrap({
+        ...input,
+        commandId: CommandId.make("command:bootstrap:second"),
+        projectId: ProjectId.make("project:bootstrap:unused"),
+      });
+      assert.isTrue(first.created);
+      assert.isFalse(second.created);
+      assert.equal(second.project.id, first.project.id);
+    }),
+  );
+});
+
+it.effect(
+  "returns project mutations before slow enrichment and shares the eventual result across reads",
+  () =>
+    Effect.gen(function* () {
+      const repositoryStarted = yield* Deferred.make<void>();
+      const releaseRepository = yield* Deferred.make<void>();
+      const repositoryCalls = yield* Ref.make(0);
+      const faviconCalls = yield* Ref.make(0);
+
+      const slowMetadataLayer = Layer.merge(
+        Layer.succeed(RepositoryIdentityResolver.RepositoryIdentityResolver, {
+          resolve: (workspaceRoot) =>
+            Effect.gen(function* () {
+              yield* Ref.update(repositoryCalls, (count) => count + 1);
+              yield* Deferred.succeed(repositoryStarted, undefined);
+              yield* Deferred.await(releaseRepository);
+              return {
+                canonicalKey: "github.com/t3tools/slow-project",
+                locator: {
+                  source: "git-remote" as const,
+                  remoteName: "origin",
+                  remoteUrl: "git@github.com:t3tools/slow-project.git",
+                },
+                rootPath: workspaceRoot,
+              };
+            }),
+        }),
+        Layer.succeed(ProjectFaviconResolver.ProjectFaviconResolver, {
+          resolvePath: (workspaceRoot) =>
+            Ref.updateAndGet(faviconCalls, (count) => count + 1).pipe(
+              Effect.as(`${workspaceRoot}/favicon.svg`),
+            ),
+        }),
+      );
+
+      yield* Effect.gen(function* () {
+        const service = yield* ProjectService.ProjectService;
+        const projectId = ProjectId.make("project:slow-enrichment");
+        const createFiber = yield* service
+          .create({
+            commandId: CommandId.make("command:slow-enrichment:create"),
+            projectId,
+            title: "Slow enrichment",
+            workspaceRoot: "/work/slow-enrichment",
+          })
+          .pipe(Effect.forkChild({ startImmediately: true }));
+
+        yield* Deferred.await(repositoryStarted);
+        yield* Effect.yieldNow;
+        assert.isDefined(createFiber.pollUnsafe());
+
+        const created = yield* Fiber.join(createFiber);
+        assert.isNull(created.repositoryIdentity);
+        assert.isNull(created.faviconPath);
+
+        const updated = yield* service.update({
+          commandId: CommandId.make("command:slow-enrichment:update"),
+          projectId,
+          title: "Updated before enrichment",
+        });
+        assert.equal(updated.title, "Updated before enrichment");
+        assert.isNull(updated.repositoryIdentity);
+        assert.equal(updated.faviconPath, "/work/slow-enrichment/favicon.svg");
+
+        const immediateReadFiber = yield* service
+          .getById(projectId)
+          .pipe(Effect.forkChild({ startImmediately: true }));
+        yield* Effect.yieldNow;
+        assert.isDefined(immediateReadFiber.pollUnsafe());
+        const immediateRead = Option.getOrThrow(yield* Fiber.join(immediateReadFiber));
+        assert.isNull(immediateRead.repositoryIdentity);
+        assert.equal(immediateRead.faviconPath, "/work/slow-enrichment/favicon.svg");
+
+        const snapshotFiber = yield* service.snapshot.pipe(
+          Effect.forkChild({ startImmediately: true }),
+        );
+        yield* Effect.yieldNow;
+        assert.isDefined(snapshotFiber.pollUnsafe());
+        const immediateSnapshot = yield* Fiber.join(snapshotFiber);
+        assert.isNull(immediateSnapshot.projects[0]?.repositoryIdentity ?? null);
+
+        yield* Deferred.succeed(releaseRepository, undefined);
+
+        const firstProject = yield* waitForProject(
+          service,
+          projectId,
+          (project) => project.repositoryIdentity !== null && project.faviconPath !== null,
+        );
+        assert.isDefined(firstProject);
+        assert.equal(
+          firstProject.repositoryIdentity?.canonicalKey,
+          "github.com/t3tools/slow-project",
+        );
+        assert.equal(firstProject.faviconPath, "/work/slow-enrichment/favicon.svg");
+
+        const byId = Option.getOrThrow(yield* service.getById(projectId));
+        const secondSnapshot = yield* service.snapshot;
+        assert.equal(byId.repositoryIdentity?.canonicalKey, "github.com/t3tools/slow-project");
+        assert.equal(secondSnapshot.projects[0]?.faviconPath, "/work/slow-enrichment/favicon.svg");
+        assert.equal(yield* Ref.get(repositoryCalls), 1);
+        assert.equal(yield* Ref.get(faviconCalls), 1);
+      }).pipe(Effect.provide(makeTestLayer(slowMetadataLayer)));
+    }),
+);
+
+it.effect("keeps project snapshots available when optional metadata enrichment fails", () =>
+  Effect.gen(function* () {
+    const failingMetadataLayer = Layer.merge(
+      Layer.succeed(RepositoryIdentityResolver.RepositoryIdentityResolver, {
+        resolve: () => Effect.succeed(null),
+      }),
+      Layer.succeed(ProjectFaviconResolver.ProjectFaviconResolver, {
+        resolvePath: (workspaceRoot) =>
+          Effect.fail(
+            new ProjectFaviconResolver.ProjectFaviconResolutionError({
+              operation: "stat-candidate",
+              workspaceRoot,
+              cause: "permission denied",
+            }),
+          ),
+      }),
+    );
+
+    yield* Effect.gen(function* () {
+      const service = yield* ProjectService.ProjectService;
+      const projectId = ProjectId.make("project:failed-enrichment");
+      yield* service.create({
+        commandId: CommandId.make("command:failed-enrichment:create"),
+        projectId,
+        title: "Still visible",
+        workspaceRoot: "/work/failed-enrichment",
+      });
+
+      const snapshot = yield* service.snapshot;
+      assert.equal(snapshot.projects.length, 1);
+      assert.equal(snapshot.projects[0]?.id, projectId);
+      assert.equal(snapshot.projects[0]?.title, "Still visible");
+      assert.isNull(snapshot.projects[0]?.repositoryIdentity ?? null);
+      assert.isNull(snapshot.projects[0]?.faviconPath ?? null);
+    }).pipe(Effect.provide(makeTestLayer(failingMetadataLayer)));
+  }),
+);
+
+it.effect("invalidates workspace-derived metadata when a project moves", () =>
+  Effect.gen(function* () {
+    const metadataVersion = yield* Ref.make(1);
+    const versionedMetadataLayer = Layer.merge(
+      Layer.succeed(RepositoryIdentityResolver.RepositoryIdentityResolver, {
+        resolve: (workspaceRoot) =>
+          Ref.get(metadataVersion).pipe(
+            Effect.map((version) => ({
+              canonicalKey: `example.test/v${version}${workspaceRoot}`,
+              locator: {
+                source: "git-remote" as const,
+                remoteName: "origin",
+                remoteUrl: `https://example.test/v${version}${workspaceRoot}.git`,
+              },
+              rootPath: workspaceRoot,
+            })),
+          ),
+      }),
+      Layer.succeed(ProjectFaviconResolver.ProjectFaviconResolver, {
+        resolvePath: (workspaceRoot) =>
+          Ref.get(metadataVersion).pipe(
+            Effect.map((version) => `${workspaceRoot}/favicon-v${version}.svg`),
+          ),
+      }),
+    );
+
+    yield* Effect.gen(function* () {
+      const service = yield* ProjectService.ProjectService;
+      const projectId = ProjectId.make("project:moved-enrichment");
+      yield* service.create({
+        commandId: CommandId.make("command:moved-enrichment:create"),
+        projectId,
+        title: "Moved",
+        workspaceRoot: "/work/original",
+      });
+      assert.equal(
+        (yield* waitForProject(
+          service,
+          projectId,
+          (project) => project.faviconPath === "/work/original/favicon-v1.svg",
+        )).faviconPath,
+        "/work/original/favicon-v1.svg",
+      );
+
+      yield* Ref.set(metadataVersion, 2);
+      yield* service.update({
+        commandId: CommandId.make("command:moved-enrichment:away"),
+        projectId,
+        workspaceRoot: "/work/temporary",
+      });
+      yield* service.snapshot;
+
+      yield* Ref.set(metadataVersion, 3);
+      yield* service.update({
+        commandId: CommandId.make("command:moved-enrichment:return"),
+        projectId,
+        workspaceRoot: "/work/original",
+      });
+      assert.equal(
+        (yield* waitForProject(
+          service,
+          projectId,
+          (project) => project.faviconPath === "/work/original/favicon-v3.svg",
+        )).faviconPath,
+        "/work/original/favicon-v3.svg",
+      );
+    }).pipe(Effect.provide(makeTestLayer(versionedMetadataLayer)));
+  }),
+);
diff --git a/apps/server/src/project/ProjectService.ts b/apps/server/src/project/ProjectService.ts
new file mode 100644
index 000000000000..4f11d0111a3b
--- /dev/null
+++ b/apps/server/src/project/ProjectService.ts
@@ -0,0 +1,395 @@
+import {
+  type CommandId,
+  ModelSelection,
+  ProjectId,
+  type Project,
+  type ProjectScript,
+  type ProjectSnapshot,
+} from "@t3tools/contracts";
+import * as Context from "effect/Context";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Schema from "effect/Schema";
+
+import { OrchestrationEngineService } from "../orchestration/Services/OrchestrationEngine.ts";
+import * as ProjectionProjects from "../persistence/Services/ProjectionProjects.ts";
+import { ProjectEnrichmentService, type ProjectEnrichment } from "./ProjectEnrichmentService.ts";
+import * as WorkspacePaths from "../workspace/WorkspacePaths.ts";
+
+export interface ProjectCreateInput {
+  readonly commandId: CommandId;
+  readonly projectId: ProjectId;
+  readonly title: string;
+  readonly workspaceRoot: string;
+  readonly createWorkspaceRootIfMissing?: boolean;
+  readonly defaultModelSelection?: ModelSelection | null;
+  readonly scripts?: ReadonlyArray<ProjectScript>;
+}
+
+export interface ProjectUpdateInput {
+  readonly commandId: CommandId;
+  readonly projectId: ProjectId;
+  readonly title?: string;
+  readonly workspaceRoot?: string;
+  readonly defaultModelSelection?: ModelSelection | null;
+  readonly scripts?: ReadonlyArray<ProjectScript>;
+}
+
+export interface ProjectBootstrapInput extends ProjectCreateInput {}
+
+export interface ProjectDeleteInput {
+  readonly commandId: CommandId;
+  readonly projectId: ProjectId;
+}
+
+export class ProjectNotFoundError extends Schema.TaggedErrorClass<ProjectNotFoundError>()(
+  "ProjectNotFoundError",
+  { projectId: ProjectId },
+) {
+  override get message(): string {
+    return `Project ${this.projectId} was not found.`;
+  }
+}
+
+export class ProjectConflictError extends Schema.TaggedErrorClass<ProjectConflictError>()(
+  "ProjectConflictError",
+  {
+    projectId: ProjectId,
+    workspaceRoot: Schema.String,
+    conflictingProjectId: ProjectId,
+  },
+) {
+  override get message(): string {
+    return `Workspace ${this.workspaceRoot} already belongs to project ${this.conflictingProjectId}.`;
+  }
+}
+
+export class ProjectOperationError extends Schema.TaggedErrorClass<ProjectOperationError>()(
+  "ProjectOperationError",
+  {
+    operation: Schema.Literals([
+      "normalize-workspace",
+      "read-project",
+      "list-projects",
+      "dispatch-project-command",
+    ]),
+    projectId: Schema.optional(ProjectId),
+    workspaceRoot: Schema.optional(Schema.String),
+    cause: Schema.Defect(),
+  },
+) {
+  override get message(): string {
+    return `Project operation '${this.operation}' failed${this.projectId === undefined ? "" : ` for ${this.projectId}`}.`;
+  }
+}
+
+export type ProjectServiceError =
+  | ProjectNotFoundError
+  | ProjectConflictError
+  | ProjectOperationError;
+
+export class ProjectService extends Context.Service<
+  ProjectService,
+  {
+    readonly create: (input: ProjectCreateInput) => Effect.Effect<Project, ProjectServiceError>;
+    readonly bootstrap: (
+      input: ProjectBootstrapInput,
+    ) => Effect.Effect<
+      { readonly project: Project; readonly created: boolean },
+      ProjectServiceError
+    >;
+    readonly update: (input: ProjectUpdateInput) => Effect.Effect<Project, ProjectServiceError>;
+    readonly delete: (input: ProjectDeleteInput) => Effect.Effect<Project, ProjectServiceError>;
+    readonly getById: (
+      projectId: ProjectId,
+      options?: { readonly includeDeleted?: boolean },
+    ) => Effect.Effect<Option.Option<Project>, ProjectOperationError>;
+    readonly getByWorkspaceRoot: (
+      workspaceRoot: string,
+      options?: { readonly includeDeleted?: boolean },
+    ) => Effect.Effect<Option.Option<Project>, ProjectOperationError>;
+    readonly snapshot: Effect.Effect<ProjectSnapshot, ProjectOperationError>;
+  }
+>()("t3/project/ProjectService") {}
+
+export const make = Effect.gen(function* () {
+  const engine = yield* OrchestrationEngineService;
+  const projects = yield* ProjectionProjects.ProjectionProjectRepository;
+  const projectEnrichment = yield* ProjectEnrichmentService;
+  const workspacePaths = yield* WorkspacePaths.WorkspacePaths;
+
+  const toProject = (
+    row: ProjectionProjects.ProjectionProject,
+    enrichment: ProjectEnrichment | null,
+  ): Project => ({
+    id: row.projectId,
+    title: row.title,
+    workspaceRoot: row.workspaceRoot,
+    repositoryIdentity: enrichment?.repositoryIdentity ?? null,
+    faviconPath: enrichment?.faviconPath ?? null,
+    defaultModelSelection: row.defaultModelSelection,
+    scripts: row.scripts,
+    createdAt: row.createdAt,
+    updatedAt: row.updatedAt,
+    deletedAt: row.deletedAt,
+  });
+
+  const hydrateAvailable = Effect.fn("ProjectService.hydrateAvailable")(function* (
+    row: ProjectionProjects.ProjectionProject,
+  ) {
+    const enrichment =
+      row.deletedAt === null
+        ? yield* projectEnrichment.getAvailable(row.workspaceRoot)
+        : yield* projectEnrichment.peek(row.workspaceRoot);
+    return toProject(row, enrichment);
+  });
+
+  const readRows = Effect.fn("ProjectService.readRows")(function* () {
+    return yield* projects
+      .listAll()
+      .pipe(
+        Effect.mapError(
+          (cause) => new ProjectOperationError({ operation: "list-projects", cause }),
+        ),
+      );
+  });
+
+  const getById: ProjectService["Service"]["getById"] = Effect.fn("ProjectService.getById")(
+    function* (projectId, options) {
+      const row = yield* projects
+        .getById({ projectId })
+        .pipe(
+          Effect.mapError(
+            (cause) => new ProjectOperationError({ operation: "read-project", projectId, cause }),
+          ),
+        );
+      if (Option.isNone(row) || (row.value.deletedAt !== null && !options?.includeDeleted)) {
+        return Option.none();
+      }
+      return Option.some(yield* hydrateAvailable(row.value));
+    },
+  );
+
+  const getByWorkspaceRoot: ProjectService["Service"]["getByWorkspaceRoot"] = Effect.fn(
+    "ProjectService.getByWorkspaceRoot",
+  )(function* (workspaceRoot, options) {
+    const normalized = yield* workspacePaths.normalizeWorkspaceRoot(workspaceRoot).pipe(
+      Effect.mapError(
+        (cause) =>
+          new ProjectOperationError({
+            operation: "normalize-workspace",
+            workspaceRoot,
+            cause,
+          }),
+      ),
+    );
+    const row = (yield* readRows()).find(
+      (candidate) =>
+        candidate.workspaceRoot === normalized &&
+        (options?.includeDeleted === true || candidate.deletedAt === null),
+    );
+    return row === undefined ? Option.none() : Option.some(yield* hydrateAvailable(row));
+  });
+
+  const readCommitted = Effect.fn("ProjectService.readCommitted")(function* (projectId: ProjectId) {
+    const row = yield* projects
+      .getById({ projectId })
+      .pipe(
+        Effect.mapError(
+          (cause) => new ProjectOperationError({ operation: "read-project", projectId, cause }),
+        ),
+      );
+    if (Option.isNone(row)) {
+      return yield* new ProjectOperationError({
+        operation: "read-project",
+        projectId,
+        cause: "The accepted project command did not produce a project projection.",
+      });
+    }
+    return yield* hydrateAvailable(row.value);
+  });
+
+  const invalidateEnrichment = (...workspaceRoots: ReadonlyArray<string>) =>
+    projectEnrichment.invalidate(workspaceRoots);
+
+  const dispatch = <A>(
+    projectId: ProjectId,
+    command: Parameters<OrchestrationEngineService["Service"]["dispatch"]>[0],
+    onCommitted: Effect.Effect<A, ProjectOperationError>,
+  ) =>
+    engine.dispatch(command).pipe(
+      Effect.mapError(
+        (cause) =>
+          new ProjectOperationError({
+            operation: "dispatch-project-command",
+            projectId,
+            cause,
+          }),
+      ),
+      Effect.andThen(onCommitted),
+    );
+
+  const assertWorkspaceAvailable = Effect.fn("ProjectService.assertWorkspaceAvailable")(function* (
+    projectId: ProjectId,
+    workspaceRoot: string,
+  ) {
+    const conflicting = (yield* readRows()).find(
+      (candidate) =>
+        candidate.deletedAt === null &&
+        candidate.projectId !== projectId &&
+        candidate.workspaceRoot === workspaceRoot,
+    );
+    if (conflicting !== undefined) {
+      return yield* new ProjectConflictError({
+        projectId,
+        workspaceRoot,
+        conflictingProjectId: conflicting.projectId,
+      });
+    }
+  });
+
+  const create: ProjectService["Service"]["create"] = Effect.fn("ProjectService.create")(
+    function* (input) {
+      const workspaceRoot = yield* workspacePaths
+        .normalizeWorkspaceRoot(input.workspaceRoot, {
+          createIfMissing: input.createWorkspaceRootIfMissing ?? false,
+        })
+        .pipe(
+          Effect.mapError(
+            (cause) =>
+              new ProjectOperationError({
+                operation: "normalize-workspace",
+                projectId: input.projectId,
+                workspaceRoot: input.workspaceRoot,
+                cause,
+              }),
+          ),
+        );
+      yield* assertWorkspaceAvailable(input.projectId, workspaceRoot);
+      const now = DateTime.formatIso(yield* DateTime.now);
+      return yield* dispatch(
+        input.projectId,
+        {
+          type: "project.create",
+          commandId: input.commandId,
+          projectId: input.projectId,
+          title: input.title,
+          workspaceRoot,
+          defaultModelSelection: input.defaultModelSelection ?? null,
+          scripts: [...(input.scripts ?? [])],
+          createdAt: now,
+        },
+        invalidateEnrichment(workspaceRoot).pipe(Effect.andThen(readCommitted(input.projectId))),
+      );
+    },
+  );
+
+  const update: ProjectService["Service"]["update"] = Effect.fn("ProjectService.update")(
+    function* (input) {
+      const existing = yield* projects.getById({ projectId: input.projectId }).pipe(
+        Effect.mapError(
+          (cause) =>
+            new ProjectOperationError({
+              operation: "read-project",
+              projectId: input.projectId,
+              cause,
+            }),
+        ),
+      );
+      if (Option.isNone(existing) || existing.value.deletedAt !== null) {
+        return yield* new ProjectNotFoundError({ projectId: input.projectId });
+      }
+      const workspaceRoot =
+        input.workspaceRoot === undefined
+          ? existing.value.workspaceRoot
+          : yield* workspacePaths.normalizeWorkspaceRoot(input.workspaceRoot).pipe(
+              Effect.mapError(
+                (cause) =>
+                  new ProjectOperationError({
+                    operation: "normalize-workspace",
+                    projectId: input.projectId,
+                    workspaceRoot: input.workspaceRoot,
+                    cause,
+                  }),
+              ),
+            );
+      yield* assertWorkspaceAvailable(input.projectId, workspaceRoot);
+      return yield* dispatch(
+        input.projectId,
+        {
+          type: "project.meta.update",
+          commandId: input.commandId,
+          projectId: input.projectId,
+          ...(input.title === undefined ? {} : { title: input.title }),
+          ...(workspaceRoot === existing.value.workspaceRoot ? {} : { workspaceRoot }),
+          ...(input.defaultModelSelection === undefined
+            ? {}
+            : { defaultModelSelection: input.defaultModelSelection }),
+          ...(input.scripts === undefined ? {} : { scripts: [...input.scripts] }),
+        },
+        (workspaceRoot === existing.value.workspaceRoot
+          ? Effect.void
+          : invalidateEnrichment(existing.value.workspaceRoot, workspaceRoot)
+        ).pipe(Effect.andThen(readCommitted(input.projectId))),
+      );
+    },
+  );
+
+  const bootstrap: ProjectService["Service"]["bootstrap"] = Effect.fn("ProjectService.bootstrap")(
+    function* (input) {
+      const existing = yield* getByWorkspaceRoot(input.workspaceRoot);
+      if (Option.isSome(existing)) return { project: existing.value, created: false };
+      return { project: yield* create(input), created: true };
+    },
+  );
+
+  const deleteProject: ProjectService["Service"]["delete"] = Effect.fn("ProjectService.delete")(
+    function* (input) {
+      const { projectId } = input;
+      const existing = yield* projects
+        .getById({ projectId })
+        .pipe(
+          Effect.mapError(
+            (cause) => new ProjectOperationError({ operation: "read-project", projectId, cause }),
+          ),
+        );
+      if (Option.isNone(existing) || existing.value.deletedAt !== null) {
+        return yield* new ProjectNotFoundError({ projectId });
+      }
+      return yield* dispatch(
+        projectId,
+        {
+          type: "project.delete",
+          commandId: input.commandId,
+          projectId,
+        },
+        invalidateEnrichment(existing.value.workspaceRoot).pipe(
+          Effect.andThen(readCommitted(projectId)),
+        ),
+      );
+    },
+  );
+
+  const snapshot = Effect.gen(function* () {
+    const rows = (yield* readRows()).filter((row) => row.deletedAt === null);
+    const hydrated = yield* Effect.forEach(rows, hydrateAvailable, { concurrency: 8 });
+    return {
+      projects: hydrated,
+      updatedAt: DateTime.formatIso(yield* DateTime.now),
+    } satisfies ProjectSnapshot;
+  });
+
+  return ProjectService.of({
+    create,
+    bootstrap,
+    update,
+    delete: deleteProject,
+    getById,
+    getByWorkspaceRoot,
+    snapshot,
+  });
+});
+
+export const layer = Layer.effect(ProjectService, make);
diff --git a/apps/server/src/project/ProjectSetupScriptRunner.test.ts b/apps/server/src/project/ProjectSetupScriptRunner.test.ts
index 5c5da4666b0d..734627df0957 100644
--- a/apps/server/src/project/ProjectSetupScriptRunner.test.ts
+++ b/apps/server/src/project/ProjectSetupScriptRunner.test.ts
@@ -1,200 +1,79 @@
-import { describe, expect, it, vi } from "@effect/vitest";
-import { type OrchestrationProject, ProjectId } from "@t3tools/contracts";
+import { assert, it, vi } from "@effect/vitest";
+import { ProjectId } from "@t3tools/contracts";
 import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
 import * as Option from "effect/Option";
-import * as Schema from "effect/Schema";
 
-import * as ProjectionSnapshotQuery from "../orchestration/Services/ProjectionSnapshotQuery.ts";
 import * as TerminalManager from "../terminal/Manager.ts";
+import * as ProjectService from "./ProjectService.ts";
 import * as ProjectSetupScriptRunner from "./ProjectSetupScriptRunner.ts";
 
-const isProjectSetupScriptOperationError = Schema.is(
-  ProjectSetupScriptRunner.ProjectSetupScriptOperationError,
-);
-
-const makeProject = (scripts: OrchestrationProject["scripts"]): OrchestrationProject => ({
-  id: ProjectId.make("project-1"),
-  title: "Project",
-  workspaceRoot: "/repo/project",
-  defaultModelSelection: null,
-  scripts,
-  createdAt: "2026-01-01T00:00:00.000Z",
-  updatedAt: "2026-01-01T00:00:00.000Z",
-  deletedAt: null,
-});
-
-const makeProjectionSnapshotQueryLayer = (project: OrchestrationProject) =>
-  Layer.succeed(ProjectionSnapshotQuery.ProjectionSnapshotQuery, {
-    getCommandReadModel: () => Effect.die("unused"),
-    getSnapshot: () => Effect.die("unused"),
-    getShellSnapshot: () => Effect.die("unused"),
-    getArchivedShellSnapshot: () => Effect.die("unused"),
-    getSnapshotSequence: () => Effect.succeed({ snapshotSequence: 1 }),
-    getCounts: () => Effect.die("unused"),
-    getActiveProjectByWorkspaceRoot: (workspaceRoot) =>
-      Effect.succeed(
-        workspaceRoot === project.workspaceRoot ? Option.some(project) : Option.none(),
-      ),
-    getProjectShellById: (projectId) =>
-      Effect.succeed(projectId === project.id ? Option.some(project) : Option.none()),
-    getFirstActiveThreadIdByProjectId: () => Effect.die("unused"),
-    getThreadCheckpointContext: () => Effect.die("unused"),
-    getFullThreadDiffContext: () => Effect.die("unused"),
-    getThreadShellById: () => Effect.die("unused"),
-    getThreadDetailById: () => Effect.die("unused"),
-    getThreadDetailSnapshot: () => Effect.die("unused"),
-    searchThreads: () => Effect.succeed({ matches: [] }),
-  });
-
-const makeTerminalManagerLayer = (
-  overrides: Pick<TerminalManager.TerminalManager["Service"], "open" | "write">,
-) =>
-  Layer.succeed(TerminalManager.TerminalManager, {
-    ...overrides,
-    attachStream: () => Effect.die(new Error("unused")),
-    resize: () => Effect.void,
-    clear: () => Effect.void,
-    restart: () => Effect.die(new Error("unused")),
-    close: () => Effect.void,
-    subscribe: () => Effect.succeed(() => undefined),
-    subscribeMetadata: () => Effect.succeed(() => undefined),
-  });
-
-const testLayer = (
-  project: OrchestrationProject,
-  terminal: Pick<TerminalManager.TerminalManager["Service"], "open" | "write">,
-) =>
-  ProjectSetupScriptRunner.layer.pipe(
-    Layer.provideMerge(makeProjectionSnapshotQueryLayer(project)),
-    Layer.provideMerge(makeTerminalManagerLayer(terminal)),
+it.effect("resolves setup scripts through the standalone project service", () => {
+  const open = vi.fn((input: Parameters<TerminalManager.TerminalManager["Service"]["open"]>[0]) =>
+    Effect.succeed({
+      threadId: input.threadId,
+      terminalId: input.terminalId,
+      cwd: input.cwd,
+      worktreePath: input.worktreePath ?? null,
+      status: "running" as const,
+      pid: 123,
+      history: "",
+      exitCode: null,
+      exitSignal: null,
+      label: "Shell",
+      updatedAt: "2026-06-20T00:00:00.000Z",
+    }),
   );
-
-describe("ProjectSetupScriptRunner", () => {
-  it.effect("returns no-script when no setup script exists", () => {
-    const open = vi.fn(() => Effect.die("unexpected open"));
-    const write = vi.fn(() => Effect.die("unexpected write"));
-    const project = makeProject([]);
-
-    return Effect.gen(function* () {
-      const runner = yield* ProjectSetupScriptRunner.ProjectSetupScriptRunner;
-      const result = yield* runner.runForThread({
-        threadId: "thread-1",
-        projectId: "project-1",
-        worktreePath: "/repo/worktrees/a",
-      });
-
-      expect(result).toEqual({ status: "no-script" });
-      expect(open).not.toHaveBeenCalled();
-      expect(write).not.toHaveBeenCalled();
-    }).pipe(Effect.provide(testLayer(project, { open, write })));
-  });
-
-  it.effect(
-    "opens the deterministic setup terminal with worktree env and writes the command",
-    () => {
-      const open = vi.fn(() =>
-        Effect.succeed({
-          threadId: "thread-1",
-          terminalId: "setup-setup",
-          cwd: "/repo/worktrees/a",
-          worktreePath: "/repo/worktrees/a",
-          status: "running" as const,
-          pid: 123,
-          history: "",
-          exitCode: null,
-          exitSignal: null,
-          label: "setup-setup",
-          updatedAt: "2026-01-01T00:00:00.000Z",
-        }),
-      );
-      const write = vi.fn(() => Effect.void);
-      const project = makeProject([
-        {
-          id: "setup",
-          name: "Setup",
-          command: "bun install",
-          icon: "configure",
-          runOnWorktreeCreate: true,
-        },
-      ]);
-
-      return Effect.gen(function* () {
-        const runner = yield* ProjectSetupScriptRunner.ProjectSetupScriptRunner;
-        const result = yield* runner.runForThread({
-          threadId: "thread-1",
-          projectCwd: "/repo/project",
-          worktreePath: "/repo/worktrees/a",
-        });
-
-        expect(result).toEqual({
-          status: "started",
-          scriptId: "setup",
-          scriptName: "Setup",
-          terminalId: "setup-setup",
-          cwd: "/repo/worktrees/a",
-        });
-        expect(open).toHaveBeenCalledWith({
-          threadId: "thread-1",
-          terminalId: "setup-setup",
-          cwd: "/repo/worktrees/a",
-          worktreePath: "/repo/worktrees/a",
-          env: {
-            T3CODE_PROJECT_ROOT: "/repo/project",
-            T3CODE_WORKTREE_PATH: "/repo/worktrees/a",
-          },
-        });
-        expect(write).toHaveBeenCalledWith({
-          threadId: "thread-1",
-          terminalId: "setup-setup",
-          data: "bun install\r",
-        });
-      }).pipe(Effect.provide(testLayer(project, { open, write })));
-    },
+  const write = vi.fn(
+    (_input: Parameters<TerminalManager.TerminalManager["Service"]["write"]>[0]) => Effect.void,
   );
-
-  it.effect("keeps terminal failures as the exact cause of a structured operation error", () => {
-    const rootCause = new Error("stat failed");
-    const terminalError = new TerminalManager.TerminalCwdStatError({
-      cwd: "/repo/worktrees/a",
-      cause: rootCause,
-    });
-    const project = makeProject([
+  const projectId = ProjectId.make("project:setup-runner-v2");
+  const project = {
+    id: projectId,
+    title: "Project",
+    workspaceRoot: "/repo",
+    repositoryIdentity: null,
+    faviconPath: null,
+    defaultModelSelection: null,
+    scripts: [
       {
         id: "setup",
         name: "Setup",
-        command: "bun install",
-        icon: "configure",
+        command: "vp install",
+        icon: "configure" as const,
         runOnWorktreeCreate: true,
       },
-    ]);
-
-    return Effect.gen(function* () {
-      const runner = yield* ProjectSetupScriptRunner.ProjectSetupScriptRunner;
-      const error = yield* runner
-        .runForThread({
-          threadId: "thread-1",
-          projectId: "project-1",
-          worktreePath: "/repo/worktrees/a",
-        })
-        .pipe(Effect.flip);
-
-      expect(isProjectSetupScriptOperationError(error)).toBe(true);
-      if (isProjectSetupScriptOperationError(error)) {
-        expect(error.operation).toBe("openTerminal");
-        expect(error.threadId).toBe("thread-1");
-        expect(error.projectId).toBe("project-1");
-        expect(error.worktreePath).toBe("/repo/worktrees/a");
-        expect(error.cause).toBe(terminalError);
-        expect(terminalError.cause).toBe(rootCause);
-      }
-    }).pipe(
-      Effect.provide(
-        testLayer(project, {
-          open: () => Effect.fail(terminalError),
-          write: () => Effect.die("unexpected write"),
+    ],
+    createdAt: "2026-06-20T00:00:00.000Z",
+    updatedAt: "2026-06-20T00:00:00.000Z",
+    deletedAt: null,
+  };
+  const layer = ProjectSetupScriptRunner.layer.pipe(
+    Layer.provide(
+      Layer.mergeAll(
+        Layer.mock(ProjectService.ProjectService)({
+          getById: () => Effect.succeed(Option.some(project)),
         }),
+        Layer.mock(TerminalManager.TerminalManager)({ open, write }),
       ),
-    );
-  });
+    ),
+  );
+
+  return Effect.gen(function* () {
+    const runner = yield* ProjectSetupScriptRunner.ProjectSetupScriptRunner;
+    const result = yield* runner.runForThread({
+      threadId: "thread-1",
+      projectId,
+      worktreePath: "/repo-worktree",
+    });
+    assert.deepEqual(result, {
+      status: "started",
+      scriptId: "setup",
+      scriptName: "Setup",
+      terminalId: "setup-setup",
+      cwd: "/repo-worktree",
+    });
+    assert.equal(open.mock.calls[0]?.[0].cwd, "/repo-worktree");
+    assert.equal(write.mock.calls[0]?.[0].data, "vp install\r");
+  }).pipe(Effect.provide(layer));
 });
diff --git a/apps/server/src/project/ProjectSetupScriptRunner.ts b/apps/server/src/project/ProjectSetupScriptRunner.ts
index 41bf0fabf489..eb997265eb16 100644
--- a/apps/server/src/project/ProjectSetupScriptRunner.ts
+++ b/apps/server/src/project/ProjectSetupScriptRunner.ts
@@ -1,4 +1,4 @@
-import { ProjectId } from "@t3tools/contracts";
+import { ProjectId, type ProjectScript } from "@t3tools/contracts";
 import { projectScriptRuntimeEnv, setupProjectScript } from "@t3tools/shared/projectScripts";
 import * as Context from "effect/Context";
 import * as Effect from "effect/Effect";
@@ -6,8 +6,8 @@ import * as Layer from "effect/Layer";
 import * as Option from "effect/Option";
 import * as Schema from "effect/Schema";
 
-import * as ProjectionSnapshotQuery from "../orchestration/Services/ProjectionSnapshotQuery.ts";
 import * as TerminalManager from "../terminal/Manager.ts";
+import * as ProjectService from "./ProjectService.ts";
 
 export interface ProjectSetupScriptRunnerResultNoScript {
   readonly status: "no-script";
@@ -31,6 +31,10 @@ export interface ProjectSetupScriptRunnerInput {
   readonly projectCwd?: string;
   readonly worktreePath: string;
   readonly preferredTerminalId?: string;
+  readonly project?: {
+    readonly workspaceRoot: string;
+    readonly scripts: ReadonlyArray<ProjectScript>;
+  };
 }
 
 export class ProjectSetupScriptOperationError extends Schema.TaggedErrorClass<ProjectSetupScriptOperationError>()(
@@ -79,7 +83,7 @@ export class ProjectSetupScriptRunner extends Context.Service<
 >()("t3/project/ProjectSetupScriptRunner") {}
 
 export const make = Effect.gen(function* () {
-  const projectionSnapshotQuery = yield* ProjectionSnapshotQuery.ProjectionSnapshotQuery;
+  const projects = yield* ProjectService.ProjectService;
   const terminalManager = yield* TerminalManager.TerminalManager;
 
   const runForThread: ProjectSetupScriptRunner["Service"]["runForThread"] = Effect.fn(
@@ -91,23 +95,27 @@ export const make = Effect.gen(function* () {
       ...(input.projectId === undefined ? {} : { projectId: input.projectId }),
       ...(input.projectCwd === undefined ? {} : { projectCwd: input.projectCwd }),
     };
-    const projectById = input.projectId
-      ? yield* projectionSnapshotQuery.getProjectShellById(ProjectId.make(input.projectId)).pipe(
-          Effect.map(Option.getOrUndefined),
-          Effect.mapError(
-            (cause) =>
-              new ProjectSetupScriptOperationError({
-                ...errorContext,
-                operation: "resolveProject",
-                cause,
-              }),
-          ),
-        )
-      : null;
+    const suppliedProject = input.project;
+    const projectById =
+      suppliedProject ??
+      (input.projectId
+        ? yield* projects.getById(ProjectId.make(input.projectId)).pipe(
+            Effect.map(Option.getOrUndefined),
+            Effect.mapError(
+              (cause) =>
+                new ProjectSetupScriptOperationError({
+                  ...errorContext,
+                  operation: "resolveProject",
+                  cause,
+                }),
+            ),
+          )
+        : null);
     const project =
+      suppliedProject ??
       projectById ??
       (input.projectCwd
-        ? yield* projectionSnapshotQuery.getActiveProjectByWorkspaceRoot(input.projectCwd).pipe(
+        ? yield* projects.getByWorkspaceRoot(input.projectCwd).pipe(
             Effect.map(Option.getOrUndefined),
             Effect.mapError(
               (cause) =>
diff --git a/apps/server/src/project/http.test.ts b/apps/server/src/project/http.test.ts
new file mode 100644
index 000000000000..a58e6a299bed
--- /dev/null
+++ b/apps/server/src/project/http.test.ts
@@ -0,0 +1,52 @@
+import { assert, it } from "@effect/vitest";
+import { ProjectId } from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+
+import {
+  ProjectConflictError,
+  ProjectNotFoundError,
+  ProjectOperationError,
+} from "./ProjectService.ts";
+import { ServerRuntimeStartupError } from "../serverRuntimeStartup.ts";
+import { failProjectMutation } from "./http.ts";
+
+const projectId = ProjectId.make("project:http-mutation");
+
+it.effect.each([
+  new ProjectNotFoundError({ projectId }),
+  new ProjectConflictError({
+    projectId,
+    workspaceRoot: "/workspace/project",
+    conflictingProjectId: ProjectId.make("project:http-mutation-conflict"),
+  }),
+])("maps expected project mutation failures to invalid requests", (cause) =>
+  Effect.gen(function* () {
+    const error = yield* failProjectMutation(cause).pipe(Effect.flip);
+
+    assert.equal(error._tag, "EnvironmentRequestInvalidError");
+    assert.equal(error.code, "invalid_request");
+    assert.equal(error.reason, "invalid_command");
+  }),
+);
+
+it.effect.each([
+  new ProjectOperationError({
+    operation: "dispatch-project-command",
+    projectId,
+    cause: "database unavailable",
+  }),
+  new ServerRuntimeStartupError({
+    mode: "web",
+    host: null,
+    port: 0,
+    cause: "startup unavailable",
+  }),
+])("keeps operational and startup failures internal", (cause) =>
+  Effect.gen(function* () {
+    const error = yield* failProjectMutation(cause).pipe(Effect.flip);
+
+    assert.equal(error._tag, "EnvironmentInternalError");
+    assert.equal(error.code, "internal_error");
+    assert.equal(error.reason, "project_mutation_failed");
+  }),
+);
diff --git a/apps/server/src/project/http.ts b/apps/server/src/project/http.ts
new file mode 100644
index 000000000000..cb31c38bfcac
--- /dev/null
+++ b/apps/server/src/project/http.ts
@@ -0,0 +1,84 @@
+import {
+  AuthOrchestrationOperateScope,
+  AuthOrchestrationReadScope,
+  EnvironmentHttpApi,
+} from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as HttpApiBuilder from "effect/unstable/httpapi/HttpApiBuilder";
+
+import {
+  annotateEnvironmentRequest,
+  failEnvironmentInternal,
+  failEnvironmentInvalidRequest,
+  requireEnvironmentScope,
+} from "../auth/http.ts";
+import * as ServerRuntimeStartup from "../serverRuntimeStartup.ts";
+import { ProjectService, type ProjectServiceError } from "./ProjectService.ts";
+
+export const failProjectMutation = Effect.fn("environment.projects.failMutation")(function* (
+  cause: ProjectServiceError | ServerRuntimeStartup.ServerRuntimeStartupError,
+) {
+  if (cause._tag === "ProjectNotFoundError" || cause._tag === "ProjectConflictError") {
+    return yield* failEnvironmentInvalidRequest("invalid_command");
+  }
+  return yield* failEnvironmentInternal("project_mutation_failed", cause);
+});
+
+export const projectHttpApiLayer = HttpApiBuilder.group(
+  EnvironmentHttpApi,
+  "projects",
+  Effect.fnUntraced(function* (handlers) {
+    const projects = yield* ProjectService;
+    const startup = yield* ServerRuntimeStartup.ServerRuntimeStartup;
+
+    return handlers
+      .handle(
+        "snapshot",
+        Effect.fn("environment.projects.snapshot")(function* (args) {
+          yield* annotateEnvironmentRequest(args.endpoint.name);
+          yield* requireEnvironmentScope(AuthOrchestrationReadScope);
+          return yield* projects.snapshot.pipe(
+            Effect.catch((cause) => failEnvironmentInternal("project_snapshot_failed", cause)),
+          );
+        }),
+      )
+      .handle(
+        "mutate",
+        Effect.fn("environment.projects.mutate")(function* (args) {
+          yield* annotateEnvironmentRequest(args.endpoint.name);
+          yield* requireEnvironmentScope(AuthOrchestrationOperateScope);
+          const mutation = args.payload;
+          const operation =
+            mutation.type === "project.create"
+              ? projects.create({
+                  commandId: mutation.commandId,
+                  projectId: mutation.projectId,
+                  title: mutation.title,
+                  workspaceRoot: mutation.workspaceRoot,
+                  ...(mutation.defaultModelSelection === undefined
+                    ? {}
+                    : { defaultModelSelection: mutation.defaultModelSelection }),
+                  ...(mutation.scripts === undefined ? {} : { scripts: mutation.scripts }),
+                })
+              : mutation.type === "project.update"
+                ? projects.update({
+                    commandId: mutation.commandId,
+                    projectId: mutation.projectId,
+                    ...(mutation.title === undefined ? {} : { title: mutation.title }),
+                    ...(mutation.workspaceRoot === undefined
+                      ? {}
+                      : { workspaceRoot: mutation.workspaceRoot }),
+                    ...(mutation.defaultModelSelection === undefined
+                      ? {}
+                      : { defaultModelSelection: mutation.defaultModelSelection }),
+                    ...(mutation.scripts === undefined ? {} : { scripts: mutation.scripts }),
+                  })
+                : projects.delete({
+                    commandId: mutation.commandId,
+                    projectId: mutation.projectId,
+                  });
+          return yield* startup.enqueueCommand(operation).pipe(Effect.catch(failProjectMutation));
+        }),
+      );
+  }),
+);
diff --git a/apps/server/src/provider/CodexDeveloperInstructions.ts b/apps/server/src/provider/CodexDeveloperInstructions.ts
index 7ce2e553e9e7..5e76d15652b2 100644
--- a/apps/server/src/provider/CodexDeveloperInstructions.ts
+++ b/apps/server/src/provider/CodexDeveloperInstructions.ts
@@ -1,5 +1,7 @@
 import type { ProviderInteractionMode } from "@t3tools/contracts";
 
+import { T3_CODE_ORCHESTRATION_INSTRUCTIONS } from "./T3OrchestrationInstructions.ts";
+
 const T3_CODE_BROWSER_TOOL_INSTRUCTIONS = `
 
 ## T3 Code collaborative browser
@@ -168,6 +170,7 @@ Use the \`request_user_input\` tool only when it is listed in the available tool
 
 In Default mode, strongly prefer making reasonable assumptions and executing the user's request rather than stopping to ask questions. If you absolutely must ask a question because the answer cannot be discovered from local context and a reasonable assumption would be risky, ask the user directly with a concise plain-text question. Never write a multiple choice question as a textual assistant message.
 ${browserToolInstructions(browserToolsAvailable)}
+${T3_CODE_ORCHESTRATION_INSTRUCTIONS}
 </collaboration_mode>`;
 
 export interface CodexRuntimeInfo {
diff --git a/apps/server/src/provider/Drivers/AcpRegistryDriver.ts b/apps/server/src/provider/Drivers/AcpRegistryDriver.ts
new file mode 100644
index 000000000000..20a7e5b5ce93
--- /dev/null
+++ b/apps/server/src/provider/Drivers/AcpRegistryDriver.ts
@@ -0,0 +1,144 @@
+import {
+  AcpRegistrySettings,
+  ProviderDriverKind,
+  TextGenerationError,
+  type ServerProvider,
+} from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as DateTime from "effect/DateTime";
+import * as Schema from "effect/Schema";
+import * as Stream from "effect/Stream";
+
+import {
+  AcpRegistryAdapterV2Driver,
+  type AcpRegistryAdapterV2DriverEnv,
+} from "../../orchestration-v2/Adapters/AcpRegistryAdapterV2.ts";
+import type { TextGenerationShape } from "../../textGeneration/TextGeneration.ts";
+import { ProviderDriverError } from "../Errors.ts";
+import { makeManualOnlyProviderMaintenanceCapabilities } from "../providerMaintenance.ts";
+import {
+  defaultProviderContinuationIdentity,
+  type ProviderDriver,
+  type ProviderInstance,
+} from "../ProviderDriver.ts";
+
+const DRIVER_KIND = ProviderDriverKind.make("acpRegistry");
+const decodeSettings = Schema.decodeSync(AcpRegistrySettings);
+
+const makeUnsupportedTextGeneration = (): TextGenerationShape => {
+  const unsupported = (operation: string) =>
+    Effect.fail(
+      new TextGenerationError({
+        operation,
+        detail: "ACP Registry instances do not provide application text generation.",
+      }),
+    );
+  return {
+    generateCommitMessage: () => unsupported("generateCommitMessage"),
+    generatePrContent: () => unsupported("generatePrContent"),
+    generateBranchName: () => unsupported("generateBranchName"),
+    generateThreadTitle: () => unsupported("generateThreadTitle"),
+  };
+};
+
+const makeSnapshot = (input: {
+  readonly instanceId: ProviderInstance["instanceId"];
+  readonly displayName: string | undefined;
+  readonly accentColor: string | undefined;
+  readonly enabled: boolean;
+  readonly settings: AcpRegistrySettings;
+  readonly continuationKey: string;
+  readonly checkedAt: string;
+}): ServerProvider => {
+  const modelIds = Array.from(new Set(["default", ...input.settings.customModels]));
+  return {
+    instanceId: input.instanceId,
+    driver: DRIVER_KIND,
+    ...(input.displayName ? { displayName: input.displayName } : {}),
+    ...(input.accentColor ? { accentColor: input.accentColor } : {}),
+    continuation: { groupKey: input.continuationKey },
+    enabled: input.enabled,
+    installed: true,
+    version: null,
+    status: input.enabled ? "ready" : "disabled",
+    auth: { status: "unknown" },
+    checkedAt: input.checkedAt,
+    models: modelIds.map((model) => ({
+      slug: model,
+      name: model,
+      isCustom: model !== "default",
+      capabilities: null,
+    })),
+    slashCommands: [],
+    skills: [],
+  };
+};
+
+export type AcpRegistryDriverEnv = AcpRegistryAdapterV2DriverEnv;
+
+/** Canonical provider-instance wrapper for ACP Registry orchestration adapters. */
+export const AcpRegistryDriver: ProviderDriver<AcpRegistrySettings, AcpRegistryDriverEnv> = {
+  driverKind: DRIVER_KIND,
+  metadata: {
+    displayName: "ACP Registry",
+    supportsMultipleInstances: true,
+  },
+  configSchema: AcpRegistrySettings,
+  defaultConfig: () => decodeSettings({}),
+  create: ({ instanceId, displayName, accentColor, environment, enabled, config }) =>
+    Effect.gen(function* () {
+      const continuationIdentity = defaultProviderContinuationIdentity({
+        driverKind: DRIVER_KIND,
+        instanceId,
+      });
+      const checkedAt = DateTime.formatIso(yield* DateTime.now);
+      const orchestrationAdapter = yield* AcpRegistryAdapterV2Driver.create({
+        instanceId,
+        displayName,
+        accentColor,
+        environment,
+        enabled,
+        config,
+      }).pipe(
+        Effect.mapError(
+          (cause) =>
+            new ProviderDriverError({
+              driver: DRIVER_KIND,
+              instanceId,
+              detail: "Failed to build ACP Registry orchestration adapter.",
+              cause,
+            }),
+        ),
+      );
+      const currentSnapshot = () =>
+        makeSnapshot({
+          instanceId,
+          displayName,
+          accentColor,
+          enabled,
+          settings: config,
+          continuationKey: continuationIdentity.continuationKey,
+          checkedAt,
+        });
+
+      return {
+        instanceId,
+        driverKind: DRIVER_KIND,
+        continuationIdentity,
+        displayName,
+        accentColor,
+        enabled,
+        snapshot: {
+          maintenanceCapabilities: makeManualOnlyProviderMaintenanceCapabilities({
+            provider: DRIVER_KIND,
+            packageName: null,
+          }),
+          getSnapshot: Effect.sync(currentSnapshot),
+          refresh: Effect.sync(currentSnapshot),
+          streamChanges: Stream.empty,
+        },
+        orchestrationAdapter,
+        textGeneration: makeUnsupportedTextGeneration(),
+      } satisfies ProviderInstance;
+    }),
+};
diff --git a/apps/server/src/provider/Drivers/ClaudeDriver.ts b/apps/server/src/provider/Drivers/ClaudeDriver.ts
index 0409b7c691b1..d05255e84aba 100644
--- a/apps/server/src/provider/Drivers/ClaudeDriver.ts
+++ b/apps/server/src/provider/Drivers/ClaudeDriver.ts
@@ -26,15 +26,18 @@ import { ChildProcessSpawner } from "effect/unstable/process";
 import { makeClaudeTextGeneration } from "../../textGeneration/ClaudeTextGeneration.ts";
 import * as BackgroundPolicy from "../../background/BackgroundPolicy.ts";
 import { ServerConfig } from "../../config.ts";
+import { ProviderEventLoggers } from "../Layers/ProviderEventLoggers.ts";
+import {
+  ClaudeAdapterV2Driver,
+  type ClaudeAdapterV2DriverEnv,
+} from "../../orchestration-v2/Adapters/ClaudeAdapterV2.ts";
 import { ServerSettingsService } from "../../serverSettings.ts";
 import { ProviderDriverError } from "../Errors.ts";
-import { makeClaudeAdapter } from "../Layers/ClaudeAdapter.ts";
 import {
   checkClaudeProviderStatus,
   makePendingClaudeProvider,
   probeClaudeCapabilities,
 } from "../Layers/ClaudeProvider.ts";
-import { ProviderEventLoggers } from "../Layers/ProviderEventLoggers.ts";
 import { makeManagedServerProvider } from "../makeManagedServerProvider.ts";
 import * as ModelManifest from "../ModelManifest.ts";
 import {
@@ -83,6 +86,7 @@ const UPDATE = makePackageManagedProviderMaintenanceResolver({
 });
 
 export type ClaudeDriverEnv =
+  | ClaudeAdapterV2DriverEnv
   | BackgroundPolicy.BackgroundPolicy
   | ChildProcessSpawner.ChildProcessSpawner
   | Crypto.Crypto
@@ -146,12 +150,24 @@ export const ClaudeDriver: ProviderDriver<ClaudeSettings, ClaudeDriverEnv> = {
         continuationGroupKey,
       });
 
-      const adapterOptions = {
+      const orchestrationAdapter = yield* ClaudeAdapterV2Driver.create({
         instanceId,
-        environment: processEnv,
-        ...(eventLoggers.native ? { nativeEventLogger: eventLoggers.native } : {}),
-      };
-      const adapter = yield* makeClaudeAdapter(effectiveConfig, adapterOptions);
+        displayName,
+        accentColor,
+        environment,
+        enabled,
+        config,
+      }).pipe(
+        Effect.mapError(
+          (cause) =>
+            new ProviderDriverError({
+              driver: DRIVER_KIND,
+              instanceId,
+              detail: "Failed to build Claude orchestration adapter.",
+              cause,
+            }),
+        ),
+      );
       const textGeneration = yield* makeClaudeTextGeneration(effectiveConfig, processEnv);
 
       // Per-instance capabilities cache: keyed on binary + resolved HOME so
@@ -233,7 +249,7 @@ export const ClaudeDriver: ProviderDriver<ClaudeSettings, ClaudeDriverEnv> = {
         accentColor,
         enabled,
         snapshot,
-        adapter,
+        orchestrationAdapter,
         textGeneration,
       } satisfies ProviderInstance;
     }),
diff --git a/apps/server/src/provider/Drivers/CodexDriver.ts b/apps/server/src/provider/Drivers/CodexDriver.ts
index 80a848c7ce3b..e5d130674336 100644
--- a/apps/server/src/provider/Drivers/CodexDriver.ts
+++ b/apps/server/src/provider/Drivers/CodexDriver.ts
@@ -33,11 +33,14 @@ import { ChildProcessSpawner } from "effect/unstable/process";
 import { makeCodexTextGeneration } from "../../textGeneration/CodexTextGeneration.ts";
 import * as BackgroundPolicy from "../../background/BackgroundPolicy.ts";
 import { ServerConfig } from "../../config.ts";
+import { ProviderEventLoggers } from "../Layers/ProviderEventLoggers.ts";
+import {
+  CodexAdapterV2Driver,
+  type CodexAdapterV2DriverEnv,
+} from "../../orchestration-v2/Adapters/CodexAdapterV2.ts";
 import { ServerSettingsService } from "../../serverSettings.ts";
 import { ProviderDriverError } from "../Errors.ts";
-import { makeCodexAdapter } from "../Layers/CodexAdapter.ts";
 import { checkCodexProviderStatus, makePendingCodexProvider } from "../Layers/CodexProvider.ts";
-import { ProviderEventLoggers } from "../Layers/ProviderEventLoggers.ts";
 import { makeManagedServerProvider } from "../makeManagedServerProvider.ts";
 import * as ModelManifest from "../ModelManifest.ts";
 import type { ProviderDriver, ProviderInstance } from "../ProviderDriver.ts";
@@ -74,6 +77,7 @@ const UPDATE = makePackageManagedProviderMaintenanceResolver({
  * registered driver and the runtime satisfies them once.
  */
 export type CodexDriverEnv =
+  | CodexAdapterV2DriverEnv
   | BackgroundPolicy.BackgroundPolicy
   | ChildProcessSpawner.ChildProcessSpawner
   | Crypto.Crypto
@@ -152,17 +156,24 @@ export const CodexDriver: ProviderDriver<CodexSettings, CodexDriverEnv> = {
         env: processEnv,
       });
 
-      // `makeCodexAdapter` and `makeCodexTextGeneration` have `never` error
-      // channels at construction time — their failure modes are all on the
-      // per-operation closures they return. No `mapError` wrapper is needed
-      // here; the registry only has to worry about snapshot-build and
-      // spawner-availability failures surfaced from `checkCodexProviderStatus`
-      // below.
-      const adapter = yield* makeCodexAdapter(effectiveConfig, {
+      const orchestrationAdapter = yield* CodexAdapterV2Driver.create({
         instanceId,
-        environment: processEnv,
-        ...(eventLoggers.native ? { nativeEventLogger: eventLoggers.native } : {}),
-      });
+        displayName,
+        accentColor,
+        environment,
+        enabled,
+        config,
+      }).pipe(
+        Effect.mapError(
+          (cause) =>
+            new ProviderDriverError({
+              driver: DRIVER_KIND,
+              instanceId,
+              detail: "Failed to build Codex orchestration adapter.",
+              cause,
+            }),
+        ),
+      );
       const textGeneration = yield* makeCodexTextGeneration(effectiveConfig, processEnv);
 
       // Build a managed snapshot whose settings never change — mutations come
@@ -225,7 +236,7 @@ export const CodexDriver: ProviderDriver<CodexSettings, CodexDriverEnv> = {
         accentColor,
         enabled,
         snapshot,
-        adapter,
+        orchestrationAdapter,
         textGeneration,
       } satisfies ProviderInstance;
     }),
diff --git a/apps/server/src/provider/Drivers/CursorDriver.ts b/apps/server/src/provider/Drivers/CursorDriver.ts
index 2101664d5cb1..c6d5af53080a 100644
--- a/apps/server/src/provider/Drivers/CursorDriver.ts
+++ b/apps/server/src/provider/Drivers/CursorDriver.ts
@@ -1,37 +1,30 @@
 /**
- * CursorDriver — `ProviderDriver` for the Cursor Agent (`cursor-agent`) runtime.
+ * CursorDriver — `ProviderDriver` for the Cursor Agent SDK runtime.
  *
- * Cursor exposes an ACP-based CLI. Model catalog and capability refreshes
- * happen during the managed provider status check via Cursor's
- * `list_available_models` extension method.
- *
- * Text generation is supported via the ACP runtime — `makeCursorTextGeneration`
- * drives `runtime.prompt` with a structured-output schema and collects the
- * agent's `agent_message_chunk` stream into a single JSON blob.
+ * Provider status, model discovery, orchestration, and text generation use the
+ * official Cursor SDK and require CURSOR_API_KEY in the provider instance
+ * environment.
  *
  * @module provider/Drivers/CursorDriver
  */
 import { CursorSettings, ProviderDriverKind, type ServerProvider } from "@t3tools/contracts";
-import * as Crypto from "effect/Crypto";
 import * as Effect from "effect/Effect";
-import * as FileSystem from "effect/FileSystem";
-import * as Path from "effect/Path";
 import * as Schema from "effect/Schema";
-import { HttpClient } from "effect/unstable/http";
-import { ChildProcessSpawner } from "effect/unstable/process";
 
 import * as BackgroundPolicy from "../../background/BackgroundPolicy.ts";
 import { ServerConfig } from "../../config.ts";
 import { ServerSettingsService } from "../../serverSettings.ts";
 import { makeCursorTextGeneration } from "../../textGeneration/CursorTextGeneration.ts";
+import {
+  CursorAdapterV2Driver,
+  type CursorAdapterV2DriverEnv,
+} from "../../orchestration-v2/Adapters/CursorAdapterV2.ts";
 import { ProviderDriverError } from "../Errors.ts";
-import { makeCursorAdapter } from "../Layers/CursorAdapter.ts";
 import {
   buildInitialCursorProviderSnapshot,
   checkCursorProviderStatus,
-  enrichCursorSnapshot,
 } from "../Layers/CursorProvider.ts";
-import { ProviderEventLoggers } from "../Layers/ProviderEventLoggers.ts";
+import { CursorSdkCatalogLive } from "../Layers/CursorSdkCatalog.ts";
 import { makeManagedServerProvider } from "../makeManagedServerProvider.ts";
 import {
   defaultProviderContinuationIdentity,
@@ -40,11 +33,7 @@ import {
 } from "../ProviderDriver.ts";
 import type { ServerProviderDraft } from "../providerSnapshot.ts";
 import { mergeProviderInstanceEnvironment } from "../ProviderInstanceEnvironment.ts";
-import {
-  makeProviderMaintenanceCapabilities,
-  type ProviderMaintenanceCapabilitiesResolver,
-  resolveProviderMaintenanceCapabilitiesEffect,
-} from "../providerMaintenance.ts";
+import { makeManualOnlyProviderMaintenanceCapabilities } from "../providerMaintenance.ts";
 import {
   haveProviderSnapshotSettingsChanged,
   makeProviderSnapshotSettingsSource,
@@ -53,25 +42,14 @@ import {
 const decodeCursorSettings = Schema.decodeSync(CursorSettings);
 
 const DRIVER_KIND = ProviderDriverKind.make("cursor");
-const UPDATE: ProviderMaintenanceCapabilitiesResolver = {
-  resolve: (options) =>
-    makeProviderMaintenanceCapabilities({
-      provider: DRIVER_KIND,
-      packageName: null,
-      updateExecutable: options?.binaryPath?.trim() || "cursor-agent",
-      updateArgs: ["update"],
-      updateLockKey: "cursor-agent",
-    }),
-};
+const MAINTENANCE_CAPABILITIES = makeManualOnlyProviderMaintenanceCapabilities({
+  provider: DRIVER_KIND,
+  packageName: null,
+});
 
 export type CursorDriverEnv =
+  | CursorAdapterV2DriverEnv
   | BackgroundPolicy.BackgroundPolicy
-  | ChildProcessSpawner.ChildProcessSpawner
-  | Crypto.Crypto
-  | FileSystem.FileSystem
-  | HttpClient.HttpClient
-  | Path.Path
-  | ProviderEventLoggers
   | ServerConfig
   | ServerSettingsService;
 
@@ -101,13 +79,7 @@ export const CursorDriver: ProviderDriver<CursorSettings, CursorDriverEnv> = {
   defaultConfig: (): CursorSettings => decodeCursorSettings({}),
   create: ({ instanceId, displayName, accentColor, environment, enabled, config }) =>
     Effect.gen(function* () {
-      const crypto = yield* Crypto.Crypto;
-      const spawner = yield* ChildProcessSpawner.ChildProcessSpawner;
-      const fileSystem = yield* FileSystem.FileSystem;
-      const path = yield* Path.Path;
-      const httpClient = yield* HttpClient.HttpClient;
       const serverSettings = yield* ServerSettingsService;
-      const eventLoggers = yield* ProviderEventLoggers;
       const processEnv = mergeProviderInstanceEnvironment(environment);
       const continuationIdentity = defaultProviderContinuationIdentity({
         driverKind: DRIVER_KIND,
@@ -120,47 +92,41 @@ export const CursorDriver: ProviderDriver<CursorSettings, CursorDriverEnv> = {
         continuationGroupKey: continuationIdentity.continuationKey,
       });
       const effectiveConfig = { ...config, enabled } satisfies CursorSettings;
-      const maintenanceCapabilities = yield* resolveProviderMaintenanceCapabilitiesEffect(UPDATE, {
-        binaryPath: effectiveConfig.binaryPath,
-        env: processEnv,
-      });
 
-      const adapter = yield* makeCursorAdapter(effectiveConfig, {
-        environment: processEnv,
-        ...(eventLoggers.native ? { nativeEventLogger: eventLoggers.native } : {}),
+      const orchestrationAdapter = yield* CursorAdapterV2Driver.create({
         instanceId,
-      });
+        displayName,
+        accentColor,
+        environment,
+        enabled,
+        config,
+      }).pipe(
+        Effect.mapError(
+          (cause) =>
+            new ProviderDriverError({
+              driver: DRIVER_KIND,
+              instanceId,
+              detail: "Failed to build Cursor orchestration adapter.",
+              cause,
+            }),
+        ),
+      );
       const textGeneration = yield* makeCursorTextGeneration(effectiveConfig, processEnv);
 
       const checkProvider = checkCursorProviderStatus(effectiveConfig, processEnv).pipe(
         Effect.map(stampIdentity),
-        Effect.provideService(Crypto.Crypto, crypto),
-        Effect.provideService(ChildProcessSpawner.ChildProcessSpawner, spawner),
-        Effect.provideService(FileSystem.FileSystem, fileSystem),
-        Effect.provideService(Path.Path, path),
+        Effect.provide(CursorSdkCatalogLive),
       );
 
       const snapshotSettings = makeProviderSnapshotSettingsSource(effectiveConfig, serverSettings);
       const snapshot = yield* makeManagedServerProvider<ProviderSnapshotSettings<CursorSettings>>({
-        maintenanceCapabilities,
+        maintenanceCapabilities: MAINTENANCE_CAPABILITIES,
         getSettings: snapshotSettings.getSettings,
         streamSettings: snapshotSettings.streamSettings,
         haveSettingsChanged: haveProviderSnapshotSettingsChanged,
         initialSnapshot: (settings) =>
           buildInitialCursorProviderSnapshot(settings.provider).pipe(Effect.map(stampIdentity)),
         checkProvider,
-        // Model catalog and capabilities come exclusively from Cursor's
-        // list_available_models extension method during provider checks.
-        enrichSnapshot: ({ settings, snapshot: currentSnapshot, publishSnapshot }) =>
-          enrichCursorSnapshot({
-            settings: settings.provider,
-            snapshot: currentSnapshot,
-            maintenanceCapabilities,
-            enableProviderUpdateChecks: settings.enableProviderUpdateChecks,
-            publishSnapshot,
-            stampIdentity,
-            httpClient,
-          }).pipe(Effect.provideService(ChildProcessSpawner.ChildProcessSpawner, spawner)),
       }).pipe(
         Effect.mapError(
           (cause) =>
@@ -181,7 +147,7 @@ export const CursorDriver: ProviderDriver<CursorSettings, CursorDriverEnv> = {
         accentColor,
         enabled,
         snapshot,
-        adapter,
+        orchestrationAdapter,
         textGeneration,
       } satisfies ProviderInstance;
     }),
diff --git a/apps/server/src/provider/Drivers/GrokDriver.ts b/apps/server/src/provider/Drivers/GrokDriver.ts
index 0b4e957fe1b2..49958013a8b4 100644
--- a/apps/server/src/provider/Drivers/GrokDriver.ts
+++ b/apps/server/src/provider/Drivers/GrokDriver.ts
@@ -9,16 +9,19 @@ import { ChildProcessSpawner } from "effect/unstable/process";
 
 import * as BackgroundPolicy from "../../background/BackgroundPolicy.ts";
 import { ServerConfig } from "../../config.ts";
+import { ProviderEventLoggers } from "../Layers/ProviderEventLoggers.ts";
 import { ServerSettingsService } from "../../serverSettings.ts";
 import { makeGrokTextGeneration } from "../../textGeneration/GrokTextGeneration.ts";
+import {
+  GrokAdapterV2Driver,
+  type GrokAdapterV2DriverEnv,
+} from "../../orchestration-v2/Adapters/GrokAdapterV2.ts";
 import { ProviderDriverError } from "../Errors.ts";
-import { makeGrokAdapter } from "../Layers/GrokAdapter.ts";
 import {
   buildInitialGrokProviderSnapshot,
   checkGrokProviderStatus,
   enrichGrokSnapshot,
 } from "../Layers/GrokProvider.ts";
-import { ProviderEventLoggers } from "../Layers/ProviderEventLoggers.ts";
 import { makeManagedServerProvider } from "../makeManagedServerProvider.ts";
 import {
   defaultProviderContinuationIdentity,
@@ -48,6 +51,7 @@ const UPDATE = makeStaticProviderMaintenanceResolver(
 );
 
 export type GrokDriverEnv =
+  | GrokAdapterV2DriverEnv
   | BackgroundPolicy.BackgroundPolicy
   | ChildProcessSpawner.ChildProcessSpawner
   | Crypto.Crypto
@@ -107,11 +111,24 @@ export const GrokDriver: ProviderDriver<GrokSettings, GrokDriverEnv> = {
         env: processEnv,
       });
 
-      const adapter = yield* makeGrokAdapter(effectiveConfig, {
-        environment: processEnv,
-        ...(eventLoggers.native ? { nativeEventLogger: eventLoggers.native } : {}),
+      const orchestrationAdapter = yield* GrokAdapterV2Driver.create({
         instanceId,
-      });
+        displayName,
+        accentColor,
+        environment,
+        enabled,
+        config,
+      }).pipe(
+        Effect.mapError(
+          (cause) =>
+            new ProviderDriverError({
+              driver: DRIVER_KIND,
+              instanceId,
+              detail: "Failed to build Grok orchestration adapter.",
+              cause,
+            }),
+        ),
+      );
       const textGeneration = yield* makeGrokTextGeneration(effectiveConfig, processEnv);
 
       const checkProvider = checkGrokProviderStatus(effectiveConfig, processEnv, cwd).pipe(
@@ -157,7 +174,7 @@ export const GrokDriver: ProviderDriver<GrokSettings, GrokDriverEnv> = {
         accentColor,
         enabled,
         snapshot,
-        adapter,
+        orchestrationAdapter,
         textGeneration,
       } satisfies ProviderInstance;
     }),
diff --git a/apps/server/src/provider/Drivers/OpenCodeDriver.ts b/apps/server/src/provider/Drivers/OpenCodeDriver.ts
index 58ccf5912025..b694ffd1e9c8 100644
--- a/apps/server/src/provider/Drivers/OpenCodeDriver.ts
+++ b/apps/server/src/provider/Drivers/OpenCodeDriver.ts
@@ -24,14 +24,16 @@ import { ChildProcessSpawner } from "effect/unstable/process";
 import { makeOpenCodeTextGeneration } from "../../textGeneration/OpenCodeTextGeneration.ts";
 import * as BackgroundPolicy from "../../background/BackgroundPolicy.ts";
 import { ServerConfig } from "../../config.ts";
+import {
+  OpenCodeAdapterV2Driver,
+  type OpenCodeAdapterV2DriverEnv,
+} from "../../orchestration-v2/Adapters/OpenCodeAdapterV2.ts";
 import { ServerSettingsService } from "../../serverSettings.ts";
 import { ProviderDriverError } from "../Errors.ts";
-import { makeOpenCodeAdapter } from "../Layers/OpenCodeAdapter.ts";
 import {
   checkOpenCodeProviderStatus,
   makePendingOpenCodeProvider,
 } from "../Layers/OpenCodeProvider.ts";
-import { ProviderEventLoggers } from "../Layers/ProviderEventLoggers.ts";
 import { makeManagedServerProvider } from "../makeManagedServerProvider.ts";
 import { OpenCodeRuntime } from "../opencodeRuntime.ts";
 import * as OpenCodeServerOwner from "../OpenCodeServerOwner.ts";
@@ -78,6 +80,7 @@ const UPDATE = makePackageManagedProviderMaintenanceResolver({
 });
 
 export type OpenCodeDriverEnv =
+  | OpenCodeAdapterV2DriverEnv
   | BackgroundPolicy.BackgroundPolicy
   | ChildProcessSpawner.ChildProcessSpawner
   | Crypto.Crypto
@@ -85,7 +88,6 @@ export type OpenCodeDriverEnv =
   | HttpClient.HttpClient
   | OpenCodeRuntime
   | Path.Path
-  | ProviderEventLoggers
   | ServerConfig
   | ServerSettingsService;
 
@@ -119,7 +121,6 @@ export const OpenCodeDriver: ProviderDriver<OpenCodeSettings, OpenCodeDriverEnv>
       const serverConfig = yield* ServerConfig;
       const httpClient = yield* HttpClient.HttpClient;
       const serverSettings = yield* ServerSettingsService;
-      const eventLoggers = yield* ProviderEventLoggers;
       const processEnv = mergeProviderInstanceEnvironment(environment);
       const continuationIdentity = defaultProviderContinuationIdentity({
         driverKind: DRIVER_KIND,
@@ -137,11 +138,24 @@ export const OpenCodeDriver: ProviderDriver<OpenCodeSettings, OpenCodeDriverEnv>
         env: processEnv,
       });
 
-      const adapter = yield* makeOpenCodeAdapter(effectiveConfig, {
+      const orchestrationAdapter = yield* OpenCodeAdapterV2Driver.create({
         instanceId,
-        environment: processEnv,
-        ...(eventLoggers.native ? { nativeEventLogger: eventLoggers.native } : {}),
-      });
+        displayName,
+        accentColor,
+        environment,
+        enabled,
+        config,
+      }).pipe(
+        Effect.mapError(
+          (cause) =>
+            new ProviderDriverError({
+              driver: DRIVER_KIND,
+              instanceId,
+              detail: "Failed to build OpenCode orchestration adapter.",
+              cause,
+            }),
+        ),
+      );
       const serverOwner = yield* OpenCodeServerOwner.make({
         binaryPath: effectiveConfig.binaryPath,
         directory: serverConfig.cwd,
@@ -204,7 +218,7 @@ export const OpenCodeDriver: ProviderDriver<OpenCodeSettings, OpenCodeDriverEnv>
         accentColor,
         enabled,
         snapshot,
-        adapter,
+        orchestrationAdapter,
         textGeneration,
       } satisfies ProviderInstance;
     }),
diff --git a/apps/server/src/provider/Errors.ts b/apps/server/src/provider/Errors.ts
index 0cf1522399b4..35244cc7156b 100644
--- a/apps/server/src/provider/Errors.ts
+++ b/apps/server/src/provider/Errors.ts
@@ -1,126 +1,10 @@
 import * as Schema from "effect/Schema";
 
-import type { CheckpointServiceError } from "../checkpointing/Errors.ts";
-
-/**
- * ProviderAdapterValidationError - Invalid adapter API input.
- */
-export class ProviderAdapterValidationError extends Schema.TaggedErrorClass<ProviderAdapterValidationError>()(
-  "ProviderAdapterValidationError",
-  {
-    provider: Schema.String,
-    operation: Schema.String,
-    issue: Schema.String,
-    cause: Schema.optional(Schema.Defect()),
-  },
-) {
-  override get message(): string {
-    return `Provider adapter validation failed (${this.provider}) in ${this.operation}: ${this.issue}`;
-  }
-}
-
-/**
- * ProviderAdapterSessionNotFoundError - Adapter-owned session id is unknown.
- */
-export class ProviderAdapterSessionNotFoundError extends Schema.TaggedErrorClass<ProviderAdapterSessionNotFoundError>()(
-  "ProviderAdapterSessionNotFoundError",
-  {
-    provider: Schema.String,
-    threadId: Schema.String,
-    cause: Schema.optional(Schema.Defect()),
-  },
-) {
-  override get message(): string {
-    return `Unknown ${this.provider} adapter thread: ${this.threadId}`;
-  }
-}
-
-/**
- * ProviderAdapterSessionClosedError - Adapter session exists but is closed.
- */
-export class ProviderAdapterSessionClosedError extends Schema.TaggedErrorClass<ProviderAdapterSessionClosedError>()(
-  "ProviderAdapterSessionClosedError",
-  {
-    provider: Schema.String,
-    threadId: Schema.String,
-    cause: Schema.optional(Schema.Defect()),
-  },
-) {
-  override get message(): string {
-    return `${this.provider} adapter thread is closed: ${this.threadId}`;
-  }
-}
-
-/**
- * ProviderAdapterRequestError - Provider protocol request failed or timed out.
- */
-export class ProviderAdapterRequestError extends Schema.TaggedErrorClass<ProviderAdapterRequestError>()(
-  "ProviderAdapterRequestError",
-  {
-    provider: Schema.String,
-    method: Schema.String,
-    detail: Schema.String,
-    cause: Schema.optional(Schema.Defect()),
-  },
-) {
-  override get message(): string {
-    return `Provider adapter request failed (${this.provider}) for ${this.method}: ${this.detail}`;
-  }
-}
-
-/**
- * ProviderAdapterProcessError - Provider process lifecycle failure.
- */
-export class ProviderAdapterProcessError extends Schema.TaggedErrorClass<ProviderAdapterProcessError>()(
-  "ProviderAdapterProcessError",
-  {
-    provider: Schema.String,
-    threadId: Schema.String,
-    detail: Schema.String,
-    cause: Schema.optional(Schema.Defect()),
-  },
-) {
-  override get message(): string {
-    return `Provider adapter process error (${this.provider}) for thread ${this.threadId}: ${this.detail}`;
-  }
-}
-
-/**
- * ProviderValidationError - Invalid provider API input.
- */
-export class ProviderValidationError extends Schema.TaggedErrorClass<ProviderValidationError>()(
-  "ProviderValidationError",
-  {
-    operation: Schema.String,
-    issue: Schema.String,
-    cause: Schema.optional(Schema.Defect()),
-  },
-) {
-  override get message(): string {
-    return `Provider validation failed in ${this.operation}: ${this.issue}`;
-  }
-}
-
-/**
- * ProviderUnsupportedError - Requested provider is not implemented.
- */
-export class ProviderUnsupportedError extends Schema.TaggedErrorClass<ProviderUnsupportedError>()(
-  "ProviderUnsupportedError",
-  {
-    provider: Schema.String,
-    cause: Schema.optional(Schema.Defect()),
-  },
-) {
-  override get message(): string {
-    return `Provider '${this.provider}' is not implemented`;
-  }
-}
-
 /**
  * ProviderInstanceNotFoundError - Lookup against the instance registry failed.
  *
- * Distinct from `ProviderUnsupportedError`: the driver is registered, but no
- * instance with the requested id has been bootstrapped — typically because
+ * The driver may be registered, but no instance with the requested id has
+ * been bootstrapped — typically because
  * the persisted instance id refers to an instance the user removed from
  * settings, or because routing is asked for an instance before the registry
  * has finished its first reload.
@@ -155,50 +39,3 @@ export class ProviderDriverError extends Schema.TaggedErrorClass<ProviderDriverE
     return `Provider driver '${this.driver}' failed to create instance '${this.instanceId}': ${this.detail}`;
   }
 }
-
-/**
- * ProviderSessionNotFoundError - Provider-facing session not found.
- */
-export class ProviderSessionNotFoundError extends Schema.TaggedErrorClass<ProviderSessionNotFoundError>()(
-  "ProviderSessionNotFoundError",
-  {
-    threadId: Schema.String,
-    cause: Schema.optional(Schema.Defect()),
-  },
-) {
-  override get message(): string {
-    return `Unknown provider thread: ${this.threadId}`;
-  }
-}
-
-/**
- * ProviderSessionDirectoryPersistenceError - Session directory persistence failure.
- */
-export class ProviderSessionDirectoryPersistenceError extends Schema.TaggedErrorClass<ProviderSessionDirectoryPersistenceError>()(
-  "ProviderSessionDirectoryPersistenceError",
-  {
-    operation: Schema.String,
-    detail: Schema.String,
-    cause: Schema.optional(Schema.Defect()),
-  },
-) {
-  override get message(): string {
-    return `Provider session directory persistence error in ${this.operation}: ${this.detail}`;
-  }
-}
-
-export type ProviderAdapterError =
-  | ProviderAdapterValidationError
-  | ProviderAdapterSessionNotFoundError
-  | ProviderAdapterSessionClosedError
-  | ProviderAdapterRequestError
-  | ProviderAdapterProcessError;
-
-export type ProviderServiceError =
-  | ProviderValidationError
-  | ProviderUnsupportedError
-  | ProviderInstanceNotFoundError
-  | ProviderSessionNotFoundError
-  | ProviderSessionDirectoryPersistenceError
-  | ProviderAdapterError
-  | CheckpointServiceError;
diff --git a/apps/server/src/provider/Layers/ClaudeAdapter.test.ts b/apps/server/src/provider/Layers/ClaudeAdapter.test.ts
deleted file mode 100644
index 2f0efeac5f53..000000000000
--- a/apps/server/src/provider/Layers/ClaudeAdapter.test.ts
+++ /dev/null
@@ -1,5146 +0,0 @@
-// @effect-diagnostics nodeBuiltinImport:off
-import * as NodeFS from "node:fs";
-import * as NodeOS from "node:os";
-import * as NodePath from "node:path";
-
-import * as NodeServices from "@effect/platform-node/NodeServices";
-import type {
-  Options as ClaudeQueryOptions,
-  PermissionMode,
-  PermissionResult,
-  SDKMessage,
-  SDKUserMessage,
-} from "@anthropic-ai/claude-agent-sdk";
-import {
-  ApprovalRequestId,
-  ClaudeSettings,
-  ProviderDriverKind,
-  ProviderItemId,
-  ProviderRuntimeEvent,
-  type RuntimeMode,
-  ThreadId,
-  ProviderInstanceId,
-} from "@t3tools/contracts";
-import { createModelSelection } from "@t3tools/shared/model";
-import { assert, describe, it } from "@effect/vitest";
-import * as Context from "effect/Context";
-import * as Effect from "effect/Effect";
-import * as Fiber from "effect/Fiber";
-import * as Layer from "effect/Layer";
-import * as Random from "effect/Random";
-import * as Schema from "effect/Schema";
-import * as Stream from "effect/Stream";
-import * as TestClock from "effect/testing/TestClock";
-
-import { attachmentRelativePath } from "../../attachmentStore.ts";
-import { ServerConfig } from "../../config.ts";
-import { ServerSettingsService } from "../../serverSettings.ts";
-import { ProviderAdapterProcessError, ProviderAdapterValidationError } from "../Errors.ts";
-import type { ClaudeAdapterShape } from "../Services/ClaudeAdapter.ts";
-import { makeClaudeAdapter, type ClaudeAdapterLiveOptions } from "./ClaudeAdapter.ts";
-const decodeClaudeSettings = Schema.decodeSync(ClaudeSettings);
-
-// Test-local service tag so the rest of the file can keep using `yield* ClaudeAdapter`.
-class ClaudeAdapter extends Context.Service<ClaudeAdapter, ClaudeAdapterShape>()(
-  "t3/provider/Layers/ClaudeAdapter.test/ClaudeAdapter",
-) {}
-
-class FakeClaudeQuery implements AsyncIterable<SDKMessage> {
-  private readonly queue: Array<SDKMessage> = [];
-  private readonly waiters: Array<{
-    readonly resolve: (value: IteratorResult<SDKMessage>) => void;
-    readonly reject: (reason: unknown) => void;
-  }> = [];
-  private done = false;
-  private failure: unknown | undefined;
-
-  public readonly setModelCalls: Array<string | undefined> = [];
-  public readonly setPermissionModeCalls: Array<string> = [];
-  public readonly setMaxThinkingTokensCalls: Array<number | null> = [];
-  public closeCalls = 0;
-  public closeError: unknown | undefined;
-
-  emit(message: SDKMessage): void {
-    if (this.done) {
-      return;
-    }
-    const waiter = this.waiters.shift();
-    if (waiter) {
-      waiter.resolve({ done: false, value: message });
-      return;
-    }
-    this.queue.push(message);
-  }
-
-  fail(cause: unknown): void {
-    if (this.done) {
-      return;
-    }
-    this.done = true;
-    this.failure = cause;
-    for (const waiter of this.waiters.splice(0)) {
-      waiter.reject(cause);
-    }
-  }
-
-  finish(): void {
-    if (this.done) {
-      return;
-    }
-    this.done = true;
-    this.failure = undefined;
-    for (const waiter of this.waiters.splice(0)) {
-      waiter.resolve({ done: true, value: undefined });
-    }
-  }
-
-  readonly setModel = async (model?: string): Promise<void> => {
-    this.setModelCalls.push(model);
-  };
-
-  readonly setPermissionMode = async (mode: PermissionMode): Promise<void> => {
-    this.setPermissionModeCalls.push(mode);
-  };
-
-  readonly setMaxThinkingTokens = async (maxThinkingTokens: number | null): Promise<void> => {
-    this.setMaxThinkingTokensCalls.push(maxThinkingTokens);
-  };
-
-  readonly close = (): void => {
-    this.closeCalls += 1;
-    if (this.closeError !== undefined) {
-      throw this.closeError;
-    }
-    this.finish();
-  };
-
-  [Symbol.asyncIterator](): AsyncIterator<SDKMessage> {
-    return {
-      next: () => {
-        if (this.queue.length > 0) {
-          const value = this.queue.shift();
-          if (value) {
-            return Promise.resolve({
-              done: false,
-              value,
-            });
-          }
-        }
-        if (this.failure !== undefined) {
-          const failure = this.failure;
-          this.failure = undefined;
-          return Promise.reject(failure);
-        }
-        if (this.done) {
-          return Promise.resolve({
-            done: true,
-            value: undefined,
-          });
-        }
-        return new Promise((resolve, reject) => {
-          this.waiters.push({
-            resolve,
-            reject,
-          });
-        });
-      },
-    };
-  }
-}
-
-function makeHarness(config?: {
-  readonly nativeEventLogPath?: string;
-  readonly nativeEventLogger?: ClaudeAdapterLiveOptions["nativeEventLogger"];
-  readonly cwd?: string;
-  readonly baseDir?: string;
-  readonly claudeConfig?: Partial<ClaudeSettings>;
-  readonly instanceId?: ProviderInstanceId;
-}) {
-  const query = new FakeClaudeQuery();
-  let createInput:
-    | {
-        readonly prompt: AsyncIterable<SDKUserMessage>;
-        readonly options: ClaudeQueryOptions;
-      }
-    | undefined;
-
-  const adapterOptions: ClaudeAdapterLiveOptions = {
-    ...(config?.instanceId ? { instanceId: config.instanceId } : {}),
-    createQuery: (input) => {
-      createInput = input;
-      return query;
-    },
-    ...(config?.nativeEventLogger
-      ? {
-          nativeEventLogger: config.nativeEventLogger,
-        }
-      : {}),
-    ...(config?.nativeEventLogPath
-      ? {
-          nativeEventLogPath: config.nativeEventLogPath,
-        }
-      : {}),
-  };
-
-  return {
-    layer: Layer.effect(
-      ClaudeAdapter,
-      Effect.gen(function* () {
-        const claudeConfig = decodeClaudeSettings(config?.claudeConfig ?? {});
-        return yield* makeClaudeAdapter(claudeConfig, adapterOptions);
-      }),
-    ).pipe(
-      Layer.provideMerge(
-        ServerConfig.layerTest(
-          config?.cwd ?? "/tmp/claude-adapter-test",
-          config?.baseDir ?? "/tmp",
-        ),
-      ),
-      Layer.provideMerge(ServerSettingsService.layerTest()),
-      Layer.provideMerge(NodeServices.layer),
-    ),
-    query,
-    getLastCreateQueryInput: () => createInput,
-  };
-}
-
-function makeDeterministicRandomService(seed = 0x1234_5678): {
-  nextIntUnsafe: () => number;
-  nextDoubleUnsafe: () => number;
-} {
-  let state = seed >>> 0;
-  const nextIntUnsafe = (): number => {
-    state = (Math.imul(1_664_525, state) + 1_013_904_223) >>> 0;
-    return state;
-  };
-
-  return {
-    nextIntUnsafe,
-    nextDoubleUnsafe: () => nextIntUnsafe() / 0x1_0000_0000,
-  };
-}
-
-async function readFirstPromptText(
-  input:
-    | {
-        readonly prompt: AsyncIterable<SDKUserMessage>;
-      }
-    | undefined,
-): Promise<string | undefined> {
-  const iterator = input?.prompt[Symbol.asyncIterator]();
-  if (!iterator) {
-    return undefined;
-  }
-  const next = await iterator.next();
-  if (next.done) {
-    return undefined;
-  }
-  if (typeof next.value.message.content === "string") {
-    return next.value.message.content;
-  }
-  const content = next.value.message.content[0];
-  if (!content || content.type !== "text") {
-    return undefined;
-  }
-  return content.text;
-}
-
-async function readFirstPromptMessage(
-  input:
-    | {
-        readonly prompt: AsyncIterable<SDKUserMessage>;
-      }
-    | undefined,
-): Promise<SDKUserMessage | undefined> {
-  const iterator = input?.prompt[Symbol.asyncIterator]();
-  if (!iterator) {
-    return undefined;
-  }
-  const next = await iterator.next();
-  if (next.done) {
-    return undefined;
-  }
-  return next.value;
-}
-
-const THREAD_ID = ThreadId.make("thread-claude-1");
-const RESUME_THREAD_ID = ThreadId.make("thread-claude-resume");
-
-describe("ClaudeAdapterLive", () => {
-  it.effect("returns validation error for non-claude provider on startSession", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-      const result = yield* adapter
-        .startSession({
-          threadId: THREAD_ID,
-          provider: ProviderDriverKind.make("codex"),
-          runtimeMode: "full-access",
-        })
-        .pipe(Effect.result);
-
-      assert.equal(result._tag, "Failure");
-      if (result._tag !== "Failure") {
-        return;
-      }
-      assert.deepEqual(
-        result.failure,
-        new ProviderAdapterValidationError({
-          provider: ProviderDriverKind.make("claudeAgent"),
-          operation: "startSession",
-          issue: "Expected provider 'claudeAgent' but received 'codex'.",
-        }),
-      );
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("retains Claude session startup causes without exposing their messages", () => {
-    const cause = new Error("credential material that must remain in the cause chain");
-    const layer = Layer.effect(
-      ClaudeAdapter,
-      Effect.gen(function* () {
-        const claudeConfig = decodeClaudeSettings({});
-        return yield* makeClaudeAdapter(claudeConfig, {
-          createQuery: () => {
-            throw cause;
-          },
-        });
-      }),
-    ).pipe(
-      Layer.provideMerge(ServerConfig.layerTest("/tmp/claude-adapter-test", "/tmp")),
-      Layer.provideMerge(ServerSettingsService.layerTest()),
-      Layer.provideMerge(NodeServices.layer),
-    );
-
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-      const error = yield* adapter
-        .startSession({
-          threadId: THREAD_ID,
-          provider: ProviderDriverKind.make("claudeAgent"),
-          runtimeMode: "full-access",
-        })
-        .pipe(Effect.flip);
-
-      assert.instanceOf(error, ProviderAdapterProcessError);
-      assert.equal(error.detail, "Failed to start Claude runtime session.");
-      assert.strictEqual(error.cause, cause);
-      assert.notMatch(error.message, /credential material/u);
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(layer),
-    );
-  });
-
-  it.effect("derives bypass permission mode from full-access runtime policy", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-      yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-
-      const createInput = harness.getLastCreateQueryInput();
-      assert.deepEqual(createInput?.options.settingSources, ["user", "project", "local"]);
-      assert.equal(createInput?.options.permissionMode, "bypassPermissions");
-      assert.equal(createInput?.options.allowDangerouslySkipPermissions, true);
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("derives auto permission mode from auto runtime policy without skip flag", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-      yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "auto",
-      });
-
-      const createInput = harness.getLastCreateQueryInput();
-      assert.equal(createInput?.options.permissionMode, "auto");
-      assert.equal(createInput?.options.allowDangerouslySkipPermissions, undefined);
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("loads Claude filesystem settings sources for SDK sessions", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-      yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "approval-required",
-      });
-
-      const createInput = harness.getLastCreateQueryInput();
-      assert.deepEqual(createInput?.options.settingSources, ["user", "project", "local"]);
-      assert.equal(createInput?.options.permissionMode, undefined);
-      assert.equal(createInput?.options.allowDangerouslySkipPermissions, undefined);
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("uses bypass permissions for full-access claude sessions", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-      yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-
-      const createInput = harness.getLastCreateQueryInput();
-      assert.equal(createInput?.options.permissionMode, "bypassPermissions");
-      assert.equal(createInput?.options.allowDangerouslySkipPermissions, true);
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("passes the configured auto-compaction window to Claude", () => {
-    const harness = makeHarness({ claudeConfig: { autoCompactWindow: "300000" } });
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-      yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-
-      const options = harness.getLastCreateQueryInput()?.options;
-      assert.deepEqual(options?.settings, { autoCompactWindow: 300000 });
-      assert.deepEqual(options?.supportedDialogKinds, ["resume_return"]);
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("forwards claude effort levels into query options", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-      yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("claudeAgent"),
-          "claude-opus-4-6",
-          [{ id: "effort", value: "max" }],
-        ),
-        runtimeMode: "full-access",
-      });
-
-      const createInput = harness.getLastCreateQueryInput();
-      assert.equal(createInput?.options.effort, "max");
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("runs Claude SDK sessions with the configured CLAUDE_CONFIG_DIR", () => {
-    const harness = makeHarness({ claudeConfig: { homePath: "~/.claude-work" } });
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-      yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("claudeAgent"),
-          "claude-opus-4-6",
-        ),
-        runtimeMode: "full-access",
-      });
-
-      const createInput = harness.getLastCreateQueryInput();
-      assert.equal(
-        createInput?.options.env?.CLAUDE_CONFIG_DIR,
-        NodePath.join(NodeOS.homedir(), ".claude-work"),
-      );
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("maps the Claude Opus 4.7 default effort to the SDK-supported max value", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-      yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        modelSelection: {
-          instanceId: ProviderInstanceId.make("claudeAgent"),
-          model: "claude-opus-4-7",
-        },
-        runtimeMode: "full-access",
-      });
-
-      const createInput = harness.getLastCreateQueryInput();
-      assert.equal(createInput?.options.effort, "max");
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("maps xhigh effort for Claude Opus 4.7 to the SDK-supported max value", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-      yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("claudeAgent"),
-          "claude-opus-4-7",
-          [{ id: "effort", value: "xhigh" }],
-        ),
-        runtimeMode: "full-access",
-      });
-
-      const createInput = harness.getLastCreateQueryInput();
-      assert.equal(createInput?.options.effort, "max");
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("preserves xhigh effort for Claude Fable 5", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-      yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("claudeAgent"),
-          "claude-fable-5",
-          [{ id: "effort", value: "xhigh" }],
-        ),
-        runtimeMode: "full-access",
-      });
-
-      const createInput = harness.getLastCreateQueryInput();
-      assert.equal(createInput?.options.effort, "xhigh");
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("preserves xhigh effort for Claude Opus 5", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-      yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("claudeAgent"),
-          "claude-opus-5",
-          [{ id: "effort", value: "xhigh" }],
-        ),
-        runtimeMode: "full-access",
-      });
-
-      const createInput = harness.getLastCreateQueryInput();
-      assert.equal(createInput?.options.effort, "xhigh");
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("falls back to default effort when unsupported max is requested for Sonnet 4.6", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-      yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("claudeAgent"),
-          "claude-sonnet-4-6",
-          [{ id: "effort", value: "max" }],
-        ),
-        runtimeMode: "full-access",
-      });
-
-      const createInput = harness.getLastCreateQueryInput();
-      assert.equal(createInput?.options.effort, "high");
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("ignores adaptive effort for Haiku 4.5", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-      yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("claudeAgent"),
-          "claude-haiku-4-5",
-          [{ id: "effort", value: "high" }],
-        ),
-        runtimeMode: "full-access",
-      });
-
-      const createInput = harness.getLastCreateQueryInput();
-      assert.equal(createInput?.options.effort, undefined);
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("forwards Claude thinking toggle into SDK settings for Haiku 4.5", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-      yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("claudeAgent"),
-          "claude-haiku-4-5",
-          [{ id: "thinking", value: false }],
-        ),
-        runtimeMode: "full-access",
-      });
-
-      const createInput = harness.getLastCreateQueryInput();
-      assert.deepEqual(createInput?.options.settings, {
-        alwaysThinkingEnabled: false,
-      });
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("ignores Claude thinking toggle for non-Haiku models", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-      yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("claudeAgent"),
-          "claude-sonnet-4-6",
-          [{ id: "thinking", value: false }],
-        ),
-        runtimeMode: "full-access",
-      });
-
-      const createInput = harness.getLastCreateQueryInput();
-      assert.equal(createInput?.options.settings, undefined);
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("forwards claude fast mode into SDK settings", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-      yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("claudeAgent"),
-          "claude-opus-4-6",
-          [{ id: "fastMode", value: true }],
-        ),
-        runtimeMode: "full-access",
-      });
-
-      const createInput = harness.getLastCreateQueryInput();
-      assert.deepEqual(createInput?.options.settings, {
-        fastMode: true,
-      });
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("ignores claude fast mode for non-opus models", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-      yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("claudeAgent"),
-          "claude-sonnet-4-6",
-          [{ id: "fastMode", value: true }],
-        ),
-        runtimeMode: "full-access",
-      });
-
-      const createInput = harness.getLastCreateQueryInput();
-      assert.equal(createInput?.options.settings, undefined);
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("treats ultrathink as a prompt keyword instead of a session effort", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-      const session = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("claudeAgent"),
-          "claude-sonnet-4-6",
-          [{ id: "effort", value: "ultrathink" }],
-        ),
-        runtimeMode: "full-access",
-      });
-
-      yield* adapter.sendTurn({
-        threadId: session.threadId,
-        input: "Investigate the edge cases",
-        attachments: [],
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("claudeAgent"),
-          "claude-sonnet-4-6",
-          [{ id: "effort", value: "ultrathink" }],
-        ),
-      });
-
-      const createInput = harness.getLastCreateQueryInput();
-      assert.equal(createInput?.options.effort, "high");
-      const promptText = yield* Effect.promise(() => readFirstPromptText(createInput));
-      assert.equal(promptText, "Ultrathink:\nInvestigate the edge cases");
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("keeps compact commands intact when ultrathink is selected", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-      const modelSelection = createModelSelection(
-        ProviderInstanceId.make("claudeAgent"),
-        "claude-sonnet-4-6",
-        [{ id: "effort", value: "ultrathink" }],
-      );
-      const session = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        modelSelection,
-        runtimeMode: "full-access",
-      });
-
-      yield* adapter.sendTurn({
-        threadId: session.threadId,
-        input: "/compact",
-        attachments: [],
-        modelSelection,
-      });
-
-      const promptText = yield* Effect.promise(() =>
-        readFirstPromptText(harness.getLastCreateQueryInput()),
-      );
-      assert.equal(promptText, "/compact");
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("embeds image attachments in Claude user messages", () => {
-    const baseDir = NodeFS.mkdtempSync(NodePath.join(NodeOS.tmpdir(), "claude-attachments-"));
-    const harness = makeHarness({
-      cwd: "/tmp/project-claude-attachments",
-      baseDir,
-    });
-    return Effect.gen(function* () {
-      yield* Effect.addFinalizer(() =>
-        Effect.sync(() =>
-          NodeFS.rmSync(baseDir, {
-            recursive: true,
-            force: true,
-          }),
-        ),
-      );
-
-      const adapter = yield* ClaudeAdapter;
-      const { attachmentsDir } = yield* ServerConfig;
-
-      const attachment = {
-        type: "image" as const,
-        id: "thread-claude-attachment-12345678-1234-1234-1234-123456789abc",
-        name: "diagram.png",
-        mimeType: "image/png",
-        sizeBytes: 4,
-      };
-      const attachmentPath = NodePath.join(attachmentsDir, attachmentRelativePath(attachment)!);
-      NodeFS.mkdirSync(NodePath.dirname(attachmentPath), { recursive: true });
-      NodeFS.writeFileSync(attachmentPath, Uint8Array.from([1, 2, 3, 4]));
-
-      const session = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-
-      yield* adapter.sendTurn({
-        threadId: session.threadId,
-        input: "What's in this image?",
-        attachments: [attachment],
-      });
-
-      const createInput = harness.getLastCreateQueryInput();
-      const promptMessage = yield* Effect.promise(() => readFirstPromptMessage(createInput));
-      assert.isDefined(promptMessage);
-      assert.deepEqual(promptMessage?.message.content, [
-        {
-          type: "text",
-          text: "What's in this image?",
-        },
-        {
-          type: "image",
-          source: {
-            type: "base64",
-            media_type: "image/png",
-            data: "AQIDBA==",
-          },
-        },
-      ]);
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("maps Claude stream/runtime messages to canonical provider runtime events", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      const runtimeEventsFiber = yield* Stream.take(adapter.streamEvents, 10).pipe(
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-
-      const session = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        modelSelection: {
-          instanceId: ProviderInstanceId.make("claudeAgent"),
-          model: "claude-sonnet-4-5",
-        },
-        runtimeMode: "full-access",
-      });
-
-      const turn = yield* adapter.sendTurn({
-        threadId: session.threadId,
-        input: "hello",
-        attachments: [],
-      });
-
-      harness.query.emit({
-        type: "stream_event",
-        session_id: "sdk-session-1",
-        uuid: "stream-0",
-        parent_tool_use_id: null,
-        event: {
-          type: "content_block_start",
-          index: 0,
-          content_block: {
-            type: "text",
-            text: "",
-          },
-        },
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "stream_event",
-        session_id: "sdk-session-1",
-        uuid: "stream-1",
-        parent_tool_use_id: null,
-        event: {
-          type: "content_block_delta",
-          index: 0,
-          delta: {
-            type: "text_delta",
-            text: "Hi",
-          },
-        },
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "stream_event",
-        session_id: "sdk-session-1",
-        uuid: "stream-2",
-        parent_tool_use_id: null,
-        event: {
-          type: "content_block_stop",
-          index: 0,
-        },
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "stream_event",
-        session_id: "sdk-session-1",
-        uuid: "stream-3",
-        parent_tool_use_id: null,
-        event: {
-          type: "content_block_start",
-          index: 1,
-          content_block: {
-            type: "tool_use",
-            id: "tool-1",
-            name: "Bash",
-            input: {
-              command: "ls",
-            },
-          },
-        },
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "stream_event",
-        session_id: "sdk-session-1",
-        uuid: "stream-4",
-        parent_tool_use_id: null,
-        event: {
-          type: "content_block_stop",
-          index: 1,
-        },
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "assistant",
-        session_id: "sdk-session-1",
-        uuid: "assistant-1",
-        parent_tool_use_id: null,
-        message: {
-          id: "assistant-message-1",
-          content: [{ type: "text", text: "Hi" }],
-        },
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "result",
-        subtype: "success",
-        is_error: false,
-        errors: [],
-        session_id: "sdk-session-1",
-        uuid: "result-1",
-      } as unknown as SDKMessage);
-
-      const runtimeEvents = Array.from(yield* Fiber.join(runtimeEventsFiber));
-      assert.deepEqual(
-        runtimeEvents.map((event) => event.type),
-        [
-          "session.started",
-          "session.configured",
-          "session.state.changed",
-          "turn.started",
-          "thread.started",
-          "content.delta",
-          "item.completed",
-          "item.started",
-          "item.completed",
-          "turn.completed",
-        ],
-      );
-
-      const turnStarted = runtimeEvents[3];
-      assert.equal(turnStarted?.type, "turn.started");
-      if (turnStarted?.type === "turn.started") {
-        assert.equal(String(turnStarted.turnId), String(turn.turnId));
-      }
-
-      const deltaEvent = runtimeEvents.find((event) => event.type === "content.delta");
-      assert.equal(deltaEvent?.type, "content.delta");
-      if (deltaEvent?.type === "content.delta") {
-        assert.equal(deltaEvent.payload.delta, "Hi");
-        assert.equal(String(deltaEvent.turnId), String(turn.turnId));
-      }
-
-      const toolStarted = runtimeEvents.find((event) => event.type === "item.started");
-      assert.equal(toolStarted?.type, "item.started");
-      if (toolStarted?.type === "item.started") {
-        assert.equal(toolStarted.payload.itemType, "command_execution");
-      }
-
-      const assistantCompletedIndex = runtimeEvents.findIndex(
-        (event) =>
-          event.type === "item.completed" && event.payload.itemType === "assistant_message",
-      );
-      const toolStartedIndex = runtimeEvents.findIndex((event) => event.type === "item.started");
-      assert.equal(
-        assistantCompletedIndex >= 0 &&
-          toolStartedIndex >= 0 &&
-          assistantCompletedIndex < toolStartedIndex,
-        true,
-      );
-
-      const turnCompleted = runtimeEvents[runtimeEvents.length - 1];
-      assert.equal(turnCompleted?.type, "turn.completed");
-      if (turnCompleted?.type === "turn.completed") {
-        assert.equal(String(turnCompleted.turnId), String(turn.turnId));
-        assert.equal(turnCompleted.payload.state, "completed");
-      }
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("does not emit turn.completed for a result with no active turn", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      // Collect through session.exited so the window after the second result
-      // is deterministically inside the collection: both results are queued
-      // after sendTurn returns and drain in order on the one stream consumer.
-      const runtimeEventsFiber = yield* adapter.streamEvents.pipe(
-        Stream.takeUntil((event) => event.type === "session.exited"),
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-
-      const session = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-
-      const turn = yield* adapter.sendTurn({
-        threadId: session.threadId,
-        input: "hello",
-        attachments: [],
-      });
-
-      harness.query.emit({
-        type: "result",
-        subtype: "success",
-        is_error: false,
-        errors: [],
-        num_turns: 1,
-        session_id: "sdk-session-1",
-        uuid: "result-real",
-      } as unknown as SDKMessage);
-
-      // Second result with no turn in flight — the shape the resume
-      // handshake (system/init + result(num_turns: 0)) delivers, and the
-      // same completeTurn branch every no-turnState result lands in. This
-      // used to emit an untargeted turn.completed; it must emit nothing.
-      harness.query.emit({
-        type: "result",
-        subtype: "success",
-        is_error: false,
-        errors: [],
-        num_turns: 0,
-        usage: { input_tokens: 0, output_tokens: 0 },
-        session_id: "sdk-session-1",
-        uuid: "result-handshake",
-      } as unknown as SDKMessage);
-
-      harness.query.finish();
-
-      const runtimeEvents = Array.from(yield* Fiber.join(runtimeEventsFiber));
-      const completions = runtimeEvents.filter((event) => event.type === "turn.completed");
-      // Exactly one completion — the real turn's, targeted at its turn id.
-      // The buggy branch produced a second, untargeted one here.
-      assert.equal(completions.length, 1);
-      const completed = completions[0];
-      if (completed?.type === "turn.completed") {
-        assert.equal(String(completed.turnId), String(turn.turnId));
-        assert.equal(completed.payload.state, "completed");
-      }
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("steers a running turn instead of opening a new one on mid-turn sendTurn", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      const runtimeEventsFiber = yield* Stream.takeUntil(
-        adapter.streamEvents,
-        (event) => event.type === "turn.completed",
-      ).pipe(Stream.runCollect, Effect.forkChild);
-
-      const session = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-
-      const turn = yield* adapter.sendTurn({
-        threadId: session.threadId,
-        input: "run 5 commands",
-        attachments: [],
-      });
-
-      // Steer: a second sendTurn while the turn is still running continues
-      // the same turn — the message is queued into the live agent loop.
-      const steeredTurn = yield* adapter.sendTurn({
-        threadId: session.threadId,
-        input: "actually run 15",
-        attachments: [],
-      });
-      assert.equal(String(steeredTurn.turnId), String(turn.turnId));
-
-      harness.query.emit({
-        type: "assistant",
-        session_id: "sdk-session-steer",
-        uuid: "assistant-steer-1",
-        parent_tool_use_id: null,
-        message: {
-          id: "assistant-message-steer-1",
-          content: [{ type: "text", text: "Adjusting to 15." }],
-        },
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "result",
-        subtype: "success",
-        is_error: false,
-        errors: [],
-        session_id: "sdk-session-steer",
-        uuid: "result-steer-1",
-      } as unknown as SDKMessage);
-
-      const runtimeEvents = Array.from(yield* Fiber.join(runtimeEventsFiber));
-      const turnStartedEvents = runtimeEvents.filter((event) => event.type === "turn.started");
-      const turnCompletedEvents = runtimeEvents.filter((event) => event.type === "turn.completed");
-
-      // One turn boundary for the whole run: the steer produced no
-      // turn.completed/turn.started pair.
-      assert.equal(turnStartedEvents.length, 1);
-      assert.equal(String(turnStartedEvents[0]?.turnId), String(turn.turnId));
-      assert.equal(turnCompletedEvents.length, 1);
-      assert.equal(String(turnCompletedEvents[0]?.turnId), String(turn.turnId));
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("maps Claude reasoning deltas, streamed tool inputs, and tool results", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      const runtimeEventsFiber = yield* Stream.take(adapter.streamEvents, 11).pipe(
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-
-      const session = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-
-      const turn = yield* adapter.sendTurn({
-        threadId: session.threadId,
-        input: "hello",
-        attachments: [],
-      });
-
-      harness.query.emit({
-        type: "stream_event",
-        session_id: "sdk-session-tool-streams",
-        uuid: "stream-thinking",
-        parent_tool_use_id: null,
-        event: {
-          type: "content_block_delta",
-          index: 0,
-          delta: {
-            type: "thinking_delta",
-            thinking: "Let",
-          },
-        },
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "stream_event",
-        session_id: "sdk-session-tool-streams",
-        uuid: "stream-tool-start",
-        parent_tool_use_id: null,
-        event: {
-          type: "content_block_start",
-          index: 1,
-          content_block: {
-            type: "tool_use",
-            id: "tool-grep-1",
-            name: "Grep",
-            input: {},
-          },
-        },
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "stream_event",
-        session_id: "sdk-session-tool-streams",
-        uuid: "stream-tool-input-1",
-        parent_tool_use_id: null,
-        event: {
-          type: "content_block_delta",
-          index: 1,
-          delta: {
-            type: "input_json_delta",
-            partial_json: '{"pattern":"foo","path":"src"}',
-          },
-        },
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "stream_event",
-        session_id: "sdk-session-tool-streams",
-        uuid: "stream-tool-stop",
-        parent_tool_use_id: null,
-        event: {
-          type: "content_block_stop",
-          index: 1,
-        },
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "user",
-        session_id: "sdk-session-tool-streams",
-        uuid: "user-tool-result",
-        parent_tool_use_id: null,
-        message: {
-          role: "user",
-          content: [
-            {
-              type: "tool_result",
-              tool_use_id: "tool-grep-1",
-              content: "src/example.ts:1:foo",
-            },
-          ],
-        },
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "result",
-        subtype: "success",
-        is_error: false,
-        errors: [],
-        session_id: "sdk-session-tool-streams",
-        uuid: "result-tool-streams",
-      } as unknown as SDKMessage);
-
-      const runtimeEvents = Array.from(yield* Fiber.join(runtimeEventsFiber));
-      assert.deepEqual(
-        runtimeEvents.map((event) => event.type),
-        [
-          "session.started",
-          "session.configured",
-          "session.state.changed",
-          "turn.started",
-          "thread.started",
-          "content.delta",
-          "item.started",
-          "item.updated",
-          "item.updated",
-          "item.completed",
-          "turn.completed",
-        ],
-      );
-
-      const reasoningDelta = runtimeEvents.find(
-        (event) => event.type === "content.delta" && event.payload.streamKind === "reasoning_text",
-      );
-      assert.equal(reasoningDelta?.type, "content.delta");
-      if (reasoningDelta?.type === "content.delta") {
-        assert.equal(reasoningDelta.payload.delta, "Let");
-        assert.equal(String(reasoningDelta.turnId), String(turn.turnId));
-      }
-
-      const toolStarted = runtimeEvents.find((event) => event.type === "item.started");
-      assert.equal(toolStarted?.type, "item.started");
-      if (toolStarted?.type === "item.started") {
-        assert.equal(toolStarted.payload.itemType, "dynamic_tool_call");
-      }
-
-      const toolInputUpdated = runtimeEvents.find(
-        (event) =>
-          event.type === "item.updated" &&
-          (event.payload.data as { input?: { pattern?: string; path?: string } } | undefined)?.input
-            ?.pattern === "foo",
-      );
-      assert.equal(toolInputUpdated?.type, "item.updated");
-      if (toolInputUpdated?.type === "item.updated") {
-        assert.deepEqual(toolInputUpdated.payload.data, {
-          toolName: "Grep",
-          input: {
-            pattern: "foo",
-            path: "src",
-          },
-        });
-      }
-
-      const toolResultUpdated = runtimeEvents.find(
-        (event) =>
-          event.type === "item.updated" &&
-          (event.payload.data as { result?: { tool_use_id?: string } } | undefined)?.result
-            ?.tool_use_id === "tool-grep-1",
-      );
-      assert.equal(toolResultUpdated?.type, "item.updated");
-      if (toolResultUpdated?.type === "item.updated") {
-        assert.equal(
-          (
-            toolResultUpdated.payload.data as {
-              result?: { content?: string };
-            }
-          ).result?.content,
-          "src/example.ts:1:foo",
-        );
-      }
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("falls back to a default plan step label for blank TodoWrite content", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      const runtimeEventsFiber = yield* Stream.take(adapter.streamEvents, 10).pipe(
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-
-      const session = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-
-      const turn = yield* adapter.sendTurn({
-        threadId: session.threadId,
-        input: "hello",
-        attachments: [],
-      });
-
-      harness.query.emit({
-        type: "stream_event",
-        session_id: "sdk-session-todo-plan",
-        uuid: "stream-todo-start",
-        parent_tool_use_id: null,
-        event: {
-          type: "content_block_start",
-          index: 1,
-          content_block: {
-            type: "tool_use",
-            id: "tool-todo-1",
-            name: "TodoWrite",
-            input: {},
-          },
-        },
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "stream_event",
-        session_id: "sdk-session-todo-plan",
-        uuid: "stream-todo-input",
-        parent_tool_use_id: null,
-        event: {
-          type: "content_block_delta",
-          index: 1,
-          delta: {
-            type: "input_json_delta",
-            partial_json:
-              '{"todos":[{"content":"   ","status":"in_progress"},{"content":"Ship it","status":"completed"}]}',
-          },
-        },
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "stream_event",
-        session_id: "sdk-session-todo-plan",
-        uuid: "stream-todo-stop",
-        parent_tool_use_id: null,
-        event: {
-          type: "content_block_stop",
-          index: 1,
-        },
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "result",
-        subtype: "success",
-        is_error: false,
-        errors: [],
-        session_id: "sdk-session-todo-plan",
-        uuid: "result-todo-plan",
-      } as unknown as SDKMessage);
-
-      const runtimeEvents = Array.from(yield* Fiber.join(runtimeEventsFiber));
-      const planUpdated = runtimeEvents.find((event) => event.type === "turn.plan.updated");
-      assert.equal(planUpdated?.type, "turn.plan.updated");
-      if (planUpdated?.type === "turn.plan.updated") {
-        assert.equal(String(planUpdated.turnId), String(turn.turnId));
-        assert.deepEqual(planUpdated.payload.plan, [
-          { step: "Task", status: "inProgress" },
-          { step: "Ship it", status: "completed" },
-        ]);
-      }
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("classifies Claude Task tool invocations as collaboration agent work", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      const runtimeEventsFiber = yield* Stream.take(adapter.streamEvents, 8).pipe(
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-
-      const session = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-
-      yield* adapter.sendTurn({
-        threadId: session.threadId,
-        input: "delegate this",
-        attachments: [],
-      });
-
-      harness.query.emit({
-        type: "stream_event",
-        session_id: "sdk-session-task",
-        uuid: "stream-task-1",
-        parent_tool_use_id: null,
-        event: {
-          type: "content_block_start",
-          index: 0,
-          content_block: {
-            type: "tool_use",
-            id: "tool-task-1",
-            name: "Task",
-            input: {
-              description: "Review the database layer",
-              prompt: "Audit the SQL changes",
-              subagent_type: "code-reviewer",
-            },
-          },
-        },
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "assistant",
-        session_id: "sdk-session-task",
-        uuid: "assistant-task-1",
-        parent_tool_use_id: null,
-        message: {
-          id: "assistant-message-task-1",
-          content: [{ type: "text", text: "Delegated" }],
-        },
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "result",
-        subtype: "success",
-        is_error: false,
-        errors: [],
-        session_id: "sdk-session-task",
-        uuid: "result-task-1",
-      } as unknown as SDKMessage);
-
-      const runtimeEvents = Array.from(yield* Fiber.join(runtimeEventsFiber));
-      const toolStarted = runtimeEvents.find((event) => event.type === "item.started");
-      assert.equal(toolStarted?.type, "item.started");
-      if (toolStarted?.type === "item.started") {
-        assert.equal(toolStarted.payload.itemType, "collab_agent_tool_call");
-        assert.equal(toolStarted.payload.title, "Subagent task");
-      }
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("treats user-aborted Claude results as interrupted without a runtime error", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      const runtimeEventsFiber = yield* Stream.take(adapter.streamEvents, 6).pipe(
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-
-      const session = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-
-      const turn = yield* adapter.sendTurn({
-        threadId: session.threadId,
-        input: "hello",
-        attachments: [],
-      });
-
-      harness.query.emit({
-        type: "result",
-        subtype: "error_during_execution",
-        is_error: false,
-        errors: ["Error: Request was aborted."],
-        stop_reason: "tool_use",
-        session_id: "sdk-session-abort",
-        uuid: "result-abort",
-      } as unknown as SDKMessage);
-
-      const runtimeEvents = Array.from(yield* Fiber.join(runtimeEventsFiber));
-      assert.deepEqual(
-        runtimeEvents.map((event) => event.type),
-        [
-          "session.started",
-          "session.configured",
-          "session.state.changed",
-          "turn.started",
-          "thread.started",
-          "turn.completed",
-        ],
-      );
-
-      const turnCompleted = runtimeEvents[runtimeEvents.length - 1];
-      assert.equal(turnCompleted?.type, "turn.completed");
-      if (turnCompleted?.type === "turn.completed") {
-        assert.equal(String(turnCompleted.turnId), String(turn.turnId));
-        assert.equal(turnCompleted.payload.state, "interrupted");
-        assert.equal(turnCompleted.payload.errorMessage, "Error: Request was aborted.");
-        assert.equal(turnCompleted.payload.stopReason, "tool_use");
-      }
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("treats aborted_tools results as interrupted and hides ede_diagnostic errors", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      const runtimeEventsFiber = yield* Stream.take(adapter.streamEvents, 6).pipe(
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-
-      const session = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-
-      const turn = yield* adapter.sendTurn({
-        threadId: session.threadId,
-        input: "hello",
-        attachments: [],
-      });
-
-      // Exact shape the CLI emits when Stop lands mid-tool-call: is_error
-      // is true and the only error is internal diagnostic telemetry.
-      harness.query.emit({
-        type: "result",
-        subtype: "error_during_execution",
-        is_error: true,
-        errors: ["[ede_diagnostic] result_type=user last_content_type=n/a stop_reason=tool_use"],
-        stop_reason: "tool_use",
-        terminal_reason: "aborted_tools",
-        session_id: "sdk-session-abort-tools",
-        uuid: "result-abort-tools",
-      } as unknown as SDKMessage);
-
-      const runtimeEvents = Array.from(yield* Fiber.join(runtimeEventsFiber));
-      assert.deepEqual(
-        runtimeEvents.map((event) => event.type),
-        [
-          "session.started",
-          "session.configured",
-          "session.state.changed",
-          "turn.started",
-          "thread.started",
-          "turn.completed",
-        ],
-      );
-
-      const turnCompleted = runtimeEvents[runtimeEvents.length - 1];
-      assert.equal(turnCompleted?.type, "turn.completed");
-      if (turnCompleted?.type === "turn.completed") {
-        assert.equal(String(turnCompleted.turnId), String(turn.turnId));
-        assert.equal(turnCompleted.payload.state, "interrupted");
-        assert.equal(turnCompleted.payload.errorMessage, undefined);
-      }
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("interruptTurn settles live tasks and closes the provider session", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      // Wait for the three task.* runtime events to prove the lifecycle
-      // handlers processed the emissions (no wall-clock sleeps under the
-      // test clock).
-      const taskEventsFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter((event) => event.type.startsWith("task.")),
-        Stream.take(3),
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-
-      const session = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-      yield* adapter.sendTurn({
-        threadId: session.threadId,
-        input: "spawn agents",
-        attachments: [],
-      });
-
-      harness.query.emit({
-        type: "system",
-        subtype: "task_started",
-        task_id: "task-live",
-        description: "Agent A",
-        task_type: "local_agent",
-        uuid: "task-live-uuid",
-        session_id: "sdk-session",
-      } as unknown as SDKMessage);
-      harness.query.emit({
-        type: "system",
-        subtype: "task_started",
-        task_id: "task-settled",
-        description: "Agent B",
-        task_type: "local_agent",
-        uuid: "task-settled-uuid",
-        session_id: "sdk-session",
-      } as unknown as SDKMessage);
-      harness.query.emit({
-        type: "system",
-        subtype: "task_notification",
-        task_id: "task-settled",
-        status: "completed",
-        output_file: "/tmp/task-settled.jsonl",
-        summary: "done",
-        uuid: "task-settled-done-uuid",
-        session_id: "sdk-session",
-      } as unknown as SDKMessage);
-
-      yield* Fiber.join(taskEventsFiber);
-
-      const stoppedTaskEventFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter((event) => event.type === "task.completed"),
-        Stream.take(1),
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-      yield* adapter.interruptTurn(session.threadId);
-
-      // Closing the session is the hard stop because SDK interrupt can leave
-      // resumed background work alive.
-      assert.equal(harness.query.closeCalls, 1);
-
-      const sessions = yield* adapter.listSessions();
-      assert.equal(sessions.length, 0);
-
-      const stoppedTaskEvents = Array.from(yield* Fiber.join(stoppedTaskEventFiber));
-      assert.equal(stoppedTaskEvents.length, 1);
-      const stoppedTaskEvent = stoppedTaskEvents[0];
-      assert.equal(stoppedTaskEvent?.type, "task.completed");
-      if (stoppedTaskEvent?.type === "task.completed") {
-        assert.equal(String(stoppedTaskEvent.payload.taskId), "task-live");
-        assert.equal(stoppedTaskEvent.payload.status, "stopped");
-        assert.equal(stoppedTaskEvent.payload.taskType, "local_agent");
-        assert.equal(stoppedTaskEvent.payload.title, "Agent A");
-      }
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("keeps the session available when process close fails", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-      const session = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-      harness.query.closeError = new Error("close failed");
-
-      const result = yield* adapter.interruptTurn(session.threadId).pipe(Effect.result);
-
-      assert.equal(result._tag, "Failure");
-      if (result._tag === "Failure") {
-        assert.equal(result.failure._tag, "ProviderAdapterProcessError");
-      }
-      assert.equal(harness.query.closeCalls, 1);
-      assert.equal(yield* adapter.hasSession(session.threadId), true);
-      assert.equal((yield* adapter.listSessions())[0]?.status, "ready");
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("stopAll attempts every session when one process close fails", () => {
-    const queries: FakeClaudeQuery[] = [];
-    const layer = Layer.effect(
-      ClaudeAdapter,
-      Effect.gen(function* () {
-        const claudeConfig = decodeClaudeSettings({});
-        return yield* makeClaudeAdapter(claudeConfig, {
-          createQuery: () => {
-            const query = new FakeClaudeQuery();
-            queries.push(query);
-            return query;
-          },
-        });
-      }),
-    ).pipe(
-      Layer.provideMerge(ServerConfig.layerTest("/tmp/claude-adapter-test", "/tmp")),
-      Layer.provideMerge(ServerSettingsService.layerTest()),
-      Layer.provideMerge(NodeServices.layer),
-    );
-
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-      yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-      yield* adapter.startSession({
-        threadId: RESUME_THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-      const firstQuery = queries[0];
-      if (!firstQuery) {
-        return;
-      }
-      firstQuery.closeError = new Error("close failed");
-
-      const result = yield* adapter.stopAll().pipe(Effect.result);
-
-      assert.equal(result._tag, "Failure");
-      assert.equal(queries[0]?.closeCalls, 1);
-      assert.equal(queries[1]?.closeCalls, 1);
-      assert.equal(yield* adapter.hasSession(THREAD_ID), true);
-      assert.equal(yield* adapter.hasSession(RESUME_THREAD_ID), false);
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(layer),
-    );
-  });
-
-  it.effect("completes with result usage without querying current context usage", () => {
-    const harness = makeHarness();
-    let getContextUsageCalls = 0;
-    Object.assign(harness.query, {
-      getContextUsage: async () => {
-        getContextUsageCalls += 1;
-        return {
-          totalTokens: 999,
-          maxTokens: 200000,
-          isAutoCompactEnabled: true,
-        };
-      },
-    });
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-      const runtimeEventsFiber = yield* Stream.take(adapter.streamEvents, 7).pipe(
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-      yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-      yield* adapter.sendTurn({
-        threadId: THREAD_ID,
-        input: "hello",
-        attachments: [],
-      });
-
-      harness.query.emit({
-        type: "assistant",
-        session_id: "sdk-session-result-usage",
-        uuid: "assistant-result-usage-1",
-        parent_tool_use_id: null,
-        message: {
-          id: "assistant-message-result-usage-1",
-          role: "assistant",
-          content: [],
-          usage: {
-            input_tokens: 80,
-            output_tokens: 20,
-          },
-        },
-      } as unknown as SDKMessage);
-      harness.query.emit({
-        type: "assistant",
-        session_id: "sdk-session-result-usage",
-        uuid: "assistant-result-usage-2",
-        parent_tool_use_id: null,
-        message: {
-          id: "assistant-message-result-usage-2",
-          role: "assistant",
-          content: [],
-          usage: {
-            input_tokens: 180,
-            output_tokens: 20,
-          },
-        },
-      } as unknown as SDKMessage);
-      harness.query.emit({
-        type: "assistant",
-        session_id: "sdk-session-result-usage",
-        uuid: "assistant-result-usage-3",
-        parent_tool_use_id: null,
-        message: {
-          id: "assistant-message-result-usage-3",
-          role: "assistant",
-          content: [],
-        },
-      } as unknown as SDKMessage);
-      harness.query.emit({
-        type: "result",
-        subtype: "success",
-        is_error: false,
-        duration_ms: 1234,
-        duration_api_ms: 1200,
-        num_turns: 1,
-        result: "done",
-        stop_reason: "end_turn",
-        session_id: "sdk-session-result-usage",
-        usage: {
-          input_tokens: 400,
-          output_tokens: 50,
-        },
-        modelUsage: {
-          "claude-opus-4-6": {
-            contextWindow: 200000,
-            maxOutputTokens: 64000,
-          },
-        },
-      } as unknown as SDKMessage);
-
-      const runtimeEvents = Array.from(yield* Fiber.join(runtimeEventsFiber));
-      assert.equal(getContextUsageCalls, 0);
-      const usageEvent = runtimeEvents.find((event) => event.type === "thread.token-usage.updated");
-      assert.equal(usageEvent?.type, "thread.token-usage.updated");
-      if (usageEvent?.type === "thread.token-usage.updated") {
-        assert.deepEqual(usageEvent.payload.usage, {
-          usedTokens: 200,
-          lastUsedTokens: 200,
-          totalProcessedTokens: 450,
-          inputTokens: 180,
-          outputTokens: 20,
-          maxTokens: 200000,
-        });
-      }
-      assert.equal(
-        runtimeEvents.find((event) => event.type === "turn.completed")?.type,
-        "turn.completed",
-      );
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("preserves compacted usage when completion follows an older assistant frame", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-      const runtimeEventsFiber = yield* Stream.take(adapter.streamEvents, 9).pipe(
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-
-      yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-      yield* adapter.sendTurn({
-        threadId: THREAD_ID,
-        input: "hello",
-        attachments: [],
-      });
-      harness.query.emit({
-        type: "assistant",
-        session_id: "sdk-session-compacted-usage",
-        uuid: "assistant-compacted-usage",
-        parent_tool_use_id: null,
-        message: {
-          id: "assistant-message-compacted-usage",
-          role: "assistant",
-          content: [],
-          usage: {
-            input_tokens: 180,
-            output_tokens: 20,
-          },
-        },
-      } as unknown as SDKMessage);
-      harness.query.emit({
-        type: "system",
-        subtype: "compact_boundary",
-        compact_metadata: {
-          pre_tokens: 200,
-          post_tokens: 40,
-        },
-        session_id: "sdk-session-compacted-usage",
-        uuid: "compact-boundary-usage",
-      } as unknown as SDKMessage);
-      harness.query.emit({
-        type: "result",
-        subtype: "success",
-        is_error: false,
-        duration_ms: 1234,
-        duration_api_ms: 1200,
-        num_turns: 2,
-        result: "done",
-        stop_reason: "end_turn",
-        session_id: "sdk-session-compacted-usage",
-        usage: {
-          input_tokens: 400,
-          output_tokens: 50,
-        },
-        modelUsage: {
-          "claude-opus-4-6": {
-            contextWindow: 200000,
-            maxOutputTokens: 64000,
-          },
-        },
-      } as unknown as SDKMessage);
-
-      const runtimeEvents = Array.from(yield* Fiber.join(runtimeEventsFiber));
-      const finalUsageEvent = runtimeEvents.findLast(
-        (event) => event.type === "thread.token-usage.updated",
-      );
-      assert.equal(finalUsageEvent?.type, "thread.token-usage.updated");
-      if (finalUsageEvent?.type === "thread.token-usage.updated") {
-        assert.deepEqual(finalUsageEvent.payload.usage, {
-          usedTokens: 40,
-          lastUsedTokens: 200,
-          totalProcessedTokens: 450,
-          maxTokens: 200000,
-        });
-      }
-      assert.equal(
-        runtimeEvents.find((event) => event.type === "turn.completed")?.type,
-        "turn.completed",
-      );
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("workflow member coalescing: identical snapshots suppress, changes emit", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      // Collect task.progress until member-0's tick-3 emission lands, then
-      // evaluate member emissions.
-      const progressFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter((event) => event.type === "task.progress"),
-        Stream.takeUntil(
-          // Sentinel: member-0's tick-3 emission (tokens 20) — members are
-          // emitted after the coordinator row within a tick.
-          (event) =>
-            (event.payload as { taskId?: string }).taskId === "wf-coalesce:wf:0" &&
-            (event.payload as { typedUsage?: { totalTokens?: number } }).typedUsage?.totalTokens ===
-              20,
-        ),
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-
-      const session = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-      yield* adapter.sendTurn({
-        threadId: session.threadId,
-        input: "run workflow",
-        attachments: [],
-      });
-
-      const memberSnapshot = (tokens: number) => [
-        { type: "workflow_phase", index: 0, title: "Work" },
-        {
-          type: "workflow_agent",
-          index: 0,
-          state: "running",
-          label: "member-0",
-          phaseIndex: 0,
-          tokens,
-        },
-        {
-          type: "workflow_agent",
-          index: 1,
-          state: "running",
-          label: "member-1",
-          phaseIndex: 0,
-          tokens: 50,
-        },
-      ];
-      const tick = (usageTotal: number, snapshot: ReturnType<typeof memberSnapshot>) =>
-        harness.query.emit({
-          type: "system",
-          subtype: "task_progress",
-          task_id: "wf-coalesce",
-          description: "Coalescing workflow",
-          usage: { total_tokens: usageTotal, tool_uses: 1, duration_ms: 10 },
-          workflow_progress: snapshot,
-          uuid: `wf-tick-${usageTotal}`,
-          session_id: "sdk-session",
-        } as unknown as SDKMessage);
-
-      // Tick 1: both members are new -> 2 member events.
-      tick(100, memberSnapshot(10));
-      // Tick 2: IDENTICAL member snapshot -> 0 member events (coordinator
-      // usage changed, but members did not).
-      tick(200, memberSnapshot(10));
-      // Tick 3: member-0's tokens advanced -> exactly 1 member event.
-      tick(300, memberSnapshot(20));
-
-      const progressEvents = Array.from(yield* Fiber.join(progressFiber));
-      const byMember = new Map<string, number>();
-      for (const event of progressEvents) {
-        const taskId = (event.payload as { taskId: string }).taskId;
-        if (!taskId.includes(":wf:")) continue;
-        byMember.set(taskId, (byMember.get(taskId) ?? 0) + 1);
-      }
-      // member-0: tick 1 + tick 3. member-1: tick 1 only (tick 2 identical,
-      // tick 3 unchanged).
-      assert.equal(byMember.get("wf-coalesce:wf:0"), 2);
-      assert.equal(byMember.get("wf-coalesce:wf:1"), 1);
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("task.started carries model/effort; subagent snapshots refine the model", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      const taskEventsFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter((event) => event.type.startsWith("task.")),
-        Stream.take(2),
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-
-      const session = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("claudeAgent"),
-          "claude-opus-4-6",
-          [{ id: "effort", value: "max" }],
-        ),
-        runtimeMode: "full-access",
-      });
-      yield* adapter.sendTurn({
-        threadId: session.threadId,
-        input: "spawn an agent",
-        attachments: [],
-      });
-
-      // No explicit model/effort on the launch input: the task inherits the
-      // session's selection.
-      harness.query.emit({
-        type: "system",
-        subtype: "task_started",
-        task_id: "task-model",
-        description: "Agent M",
-        task_type: "local_agent",
-        tool_use_id: "toolu_agent_m",
-        uuid: "task-model-uuid",
-        session_id: "sdk-session",
-      } as unknown as SDKMessage);
-      // The subagent's assistant snapshot carries the authoritative API
-      // model id, which refines the linkage on later rows.
-      harness.query.emit({
-        type: "assistant",
-        parent_tool_use_id: "toolu_agent_m",
-        message: {
-          model: "claude-sonnet-5[1m]",
-          content: [],
-        },
-        uuid: "subagent-snapshot-uuid",
-        session_id: "sdk-session",
-      } as unknown as SDKMessage);
-      harness.query.emit({
-        type: "system",
-        subtype: "task_progress",
-        task_id: "task-model",
-        description: "Agent M",
-        usage: { total_tokens: 100, tool_uses: 1, duration_ms: 10 },
-        uuid: "task-model-progress-uuid",
-        session_id: "sdk-session",
-      } as unknown as SDKMessage);
-
-      const taskEvents = Array.from(yield* Fiber.join(taskEventsFiber));
-      const started = taskEvents[0];
-      assert.equal(started?.type, "task.started");
-      if (started?.type === "task.started") {
-        assert.equal(started.payload.model, "claude-opus-4-6");
-        assert.equal(started.payload.effort, "max");
-      }
-      const progress = taskEvents[1];
-      assert.equal(progress?.type, "task.progress");
-      if (progress?.type === "task.progress") {
-        assert.equal(progress.payload.model, "claude-sonnet-5[1m]");
-        assert.equal(progress.payload.effort, "max");
-      }
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("a subagent snapshot that beats task_started still wins over the seed", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      const taskEventsFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter((event) => event.type.startsWith("task.")),
-        Stream.take(2),
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-
-      const session = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("claudeAgent"),
-          "claude-opus-4-6",
-          [{ id: "effort", value: "max" }],
-        ),
-        runtimeMode: "full-access",
-      });
-      yield* adapter.sendTurn({
-        threadId: session.threadId,
-        input: "spawn an agent",
-        attachments: [],
-      });
-
-      // The subagent streams its first assistant snapshot before the task is
-      // registered, so there is no agent to refine yet.
-      harness.query.emit({
-        type: "assistant",
-        parent_tool_use_id: "toolu_agent_early",
-        message: {
-          model: "claude-sonnet-5[1m]",
-          content: [],
-        },
-        uuid: "early-snapshot-uuid",
-        session_id: "sdk-session",
-      } as unknown as SDKMessage);
-      harness.query.emit({
-        type: "system",
-        subtype: "task_started",
-        task_id: "task-early",
-        description: "Agent E",
-        task_type: "local_agent",
-        tool_use_id: "toolu_agent_early",
-        uuid: "task-early-uuid",
-        session_id: "sdk-session",
-      } as unknown as SDKMessage);
-      harness.query.emit({
-        type: "system",
-        subtype: "task_progress",
-        task_id: "task-early",
-        description: "Agent E",
-        usage: { total_tokens: 100, tool_uses: 1, duration_ms: 10 },
-        uuid: "task-early-progress-uuid",
-        session_id: "sdk-session",
-      } as unknown as SDKMessage);
-
-      const taskEvents = Array.from(yield* Fiber.join(taskEventsFiber));
-      const started = taskEvents[0];
-      assert.equal(started?.type, "task.started");
-      if (started?.type === "task.started") {
-        assert.equal(started.payload.model, "claude-sonnet-5[1m]");
-        assert.equal(started.payload.effort, "max");
-      }
-      const progress = taskEvents[1];
-      assert.equal(progress?.type, "task.progress");
-      if (progress?.type === "task.progress") {
-        assert.equal(progress.payload.model, "claude-sonnet-5[1m]");
-      }
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("closes the session when the Claude stream aborts after a turn starts", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-      const runtimeEvents: Array<ProviderRuntimeEvent> = [];
-
-      const runtimeEventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) =>
-        Effect.sync(() => {
-          runtimeEvents.push(event);
-        }),
-      ).pipe(Effect.forkChild);
-
-      yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-
-      const turn = yield* adapter.sendTurn({
-        threadId: THREAD_ID,
-        input: "hello",
-        attachments: [],
-      });
-
-      harness.query.fail(new Error("All fibers interrupted without error"));
-
-      yield* Effect.yieldNow;
-      yield* Effect.yieldNow;
-      yield* Effect.yieldNow;
-      runtimeEventsFiber.interruptUnsafe();
-      assert.deepEqual(
-        runtimeEvents.map((event) => event.type),
-        [
-          "session.started",
-          "session.configured",
-          "session.state.changed",
-          "turn.started",
-          "turn.completed",
-          "session.exited",
-        ],
-      );
-
-      const turnCompleted = runtimeEvents[4];
-      assert.equal(turnCompleted?.type, "turn.completed");
-      if (turnCompleted?.type === "turn.completed") {
-        assert.equal(String(turnCompleted.turnId), String(turn.turnId));
-        assert.equal(turnCompleted.payload.state, "interrupted");
-        assert.equal(turnCompleted.payload.errorMessage, "Claude runtime interrupted.");
-      }
-
-      const sessionExited = runtimeEvents[5];
-      assert.equal(sessionExited?.type, "session.exited");
-
-      assert.equal(yield* adapter.hasSession(THREAD_ID), false);
-      const sessions = yield* adapter.listSessions();
-      assert.equal(sessions.length, 0);
-      assert.equal(harness.query.closeCalls, 1);
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("keeps Claude stream failure events structural", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-      const runtimeEvents: Array<ProviderRuntimeEvent> = [];
-      const runtimeEventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) =>
-        Effect.sync(() => {
-          runtimeEvents.push(event);
-        }),
-      ).pipe(Effect.forkChild);
-
-      yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-      yield* adapter.sendTurn({
-        threadId: THREAD_ID,
-        input: "hello",
-        attachments: [],
-      });
-
-      harness.query.fail(new Error("credential material that must stay in the cause chain"));
-
-      yield* Effect.yieldNow;
-      yield* Effect.yieldNow;
-      yield* Effect.yieldNow;
-      runtimeEventsFiber.interruptUnsafe();
-
-      const runtimeError = runtimeEvents.find((event) => event.type === "runtime.error");
-      assert.equal(runtimeError?.type, "runtime.error");
-      if (runtimeError?.type === "runtime.error") {
-        assert.equal(runtimeError.payload.message, "Claude runtime stream failed.");
-        assert.deepEqual(runtimeError.payload.detail, {
-          failureCount: 1,
-          failureTags: ["ProviderAdapterProcessError"],
-        });
-      }
-
-      const completed = runtimeEvents.find((event) => event.type === "turn.completed");
-      assert.equal(completed?.type, "turn.completed");
-      if (completed?.type === "turn.completed") {
-        assert.equal(completed.payload.state, "failed");
-        assert.equal(completed.payload.errorMessage, "Claude runtime stream failed.");
-      }
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("closes the previous session before replacing an existing thread session", () => {
-    const queries: FakeClaudeQuery[] = [];
-    const layer = Layer.effect(
-      ClaudeAdapter,
-      Effect.gen(function* () {
-        const claudeConfig = decodeClaudeSettings({});
-        return yield* makeClaudeAdapter(claudeConfig, {
-          createQuery: () => {
-            const query = new FakeClaudeQuery();
-            queries.push(query);
-            return query;
-          },
-        });
-      }),
-    ).pipe(
-      Layer.provideMerge(ServerConfig.layerTest("/tmp/claude-adapter-test", "/tmp")),
-      Layer.provideMerge(ServerSettingsService.layerTest()),
-      Layer.provideMerge(NodeServices.layer),
-    );
-
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      const runtimeEventsFiber = yield* Stream.take(adapter.streamEvents, 6).pipe(
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-
-      const firstSession = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-
-      const secondSession = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-        resumeCursor: firstSession.resumeCursor,
-      });
-
-      const runtimeEvents = Array.from(yield* Fiber.join(runtimeEventsFiber));
-      const activeSessions = yield* adapter.listSessions();
-
-      assert.equal(queries.length, 2);
-      assert.equal(queries[0]?.closeCalls, 1);
-      assert.equal(queries[1]?.closeCalls, 0);
-      assert.equal(yield* adapter.hasSession(THREAD_ID), true);
-      assert.equal(activeSessions.length, 1);
-      assert.deepEqual(activeSessions[0]?.resumeCursor, secondSession.resumeCursor);
-      assert.deepEqual(
-        runtimeEvents.map((event) => event.type),
-        [
-          "session.started",
-          "session.configured",
-          "session.state.changed",
-          "session.started",
-          "session.configured",
-          "session.state.changed",
-        ],
-      );
-      assert.equal(
-        runtimeEvents.some((event) => event.type === "session.exited"),
-        false,
-      );
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(layer),
-    );
-  });
-
-  it.effect("stopSession does not throw into the SDK prompt consumer", () => {
-    // The SDK consumes user messages via `for await (... of prompt)`.
-    // Stopping a session must end that loop cleanly — not throw an error.
-    //
-    // FakeClaudeQuery.close() masks this by resolving pending iterators
-    // before the shutdown propagates. Override it to match real SDK behavior
-    // where close() does not resolve the prompt consumer.
-    const query = new FakeClaudeQuery();
-    (query as { close: () => void }).close = () => {
-      query.closeCalls += 1;
-    };
-
-    let promptConsumerError: unknown = undefined;
-
-    const layer = Layer.effect(
-      ClaudeAdapter,
-      Effect.gen(function* () {
-        const claudeConfig = decodeClaudeSettings({});
-        return yield* makeClaudeAdapter(claudeConfig, {
-          createQuery: (input) => {
-            // Simulate the SDK consuming the prompt iterable
-            (async () => {
-              try {
-                for await (const _message of input.prompt) {
-                  /* SDK processes user messages */
-                }
-              } catch (error) {
-                promptConsumerError = error;
-              }
-            })();
-            return query;
-          },
-        });
-      }),
-    ).pipe(
-      Layer.provideMerge(ServerConfig.layerTest("/tmp/claude-adapter-test", "/tmp")),
-      Layer.provideMerge(ServerSettingsService.layerTest()),
-      Layer.provideMerge(NodeServices.layer),
-    );
-
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      const runtimeEventsFiber = yield* Stream.runForEach(
-        adapter.streamEvents,
-        () => Effect.void,
-      ).pipe(Effect.forkChild);
-
-      yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-
-      yield* adapter.stopSession(THREAD_ID);
-
-      yield* Effect.yieldNow;
-      yield* Effect.yieldNow;
-      yield* Effect.yieldNow;
-      yield* TestClock.adjust("50 millis");
-      yield* Effect.yieldNow;
-
-      runtimeEventsFiber.interruptUnsafe();
-
-      assert.equal(
-        promptConsumerError,
-        undefined,
-        `Prompt consumer should not receive a thrown error on session stop, ` +
-          `but got: "${promptConsumerError instanceof Error ? promptConsumerError.message : String(promptConsumerError)}"`,
-      );
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(layer),
-    );
-  });
-
-  it.effect("forwards Claude task progress summaries for subagent updates", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      const runtimeEventsFiber = yield* Stream.take(adapter.streamEvents, 6).pipe(
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-
-      yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-
-      harness.query.emit({
-        type: "system",
-        subtype: "task_progress",
-        task_id: "task-subagent-1",
-        description: "Running background teammate",
-        summary: "Code reviewer checked the migration edge cases.",
-        usage: {
-          total_tokens: 123,
-          tool_uses: 4,
-          duration_ms: 987,
-        },
-        session_id: "sdk-session-task-summary",
-        uuid: "task-progress-1",
-      } as unknown as SDKMessage);
-
-      const runtimeEvents = Array.from(yield* Fiber.join(runtimeEventsFiber));
-      const progressEvent = runtimeEvents.find((event) => event.type === "task.progress");
-      assert.equal(progressEvent?.type, "task.progress");
-      if (progressEvent?.type === "task.progress") {
-        assert.equal(
-          progressEvent.payload.summary,
-          "Code reviewer checked the migration edge cases.",
-        );
-        assert.equal(progressEvent.payload.description, "Running background teammate");
-      }
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("consumes undeclared and UX-internal system subtypes without warning rows", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-      const runtimeEvents: Array<ProviderRuntimeEvent> = [];
-      const runtimeEventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) =>
-        Effect.sync(() => runtimeEvents.push(event)),
-      ).pipe(Effect.forkChild);
-
-      yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-
-      // Undeclared wire-only roster snapshot + every typed UX-internal
-      // subtype and top-level type consumed silently: none may surface as
-      // unknown-subtype warnings.
-      for (const message of [
-        {
-          type: "system",
-          subtype: "background_tasks_changed",
-          tasks: [{ task_id: "t1", task_type: "local_agent", description: "Say hi" }],
-          session_id: "session",
-          uuid: "roster",
-        },
-        {
-          type: "system",
-          subtype: "vcs_state_changed",
-          kind: "push",
-          cwd: "/tmp/worktree",
-          session_id: "session",
-          uuid: "vcs",
-        },
-        {
-          type: "system",
-          subtype: "code_change_published",
-          provider: "github",
-          url: "https://github.com/pingdotgg/t3code/pull/1",
-          repo: "pingdotgg/t3code",
-          identifier: "1",
-          session_id: "session",
-          uuid: "ccp",
-        },
-        {
-          type: "system",
-          subtype: "task_updated",
-          task_id: "t1",
-          patch: { status: "running" },
-          session_id: "session",
-          uuid: "tu",
-        },
-        { type: "system", subtype: "commands_changed", session_id: "session", uuid: "cc" },
-        { type: "system", subtype: "model_refusal_fallback", session_id: "session", uuid: "mrf" },
-        { type: "system", subtype: "local_command_output", session_id: "session", uuid: "lco" },
-        { type: "system", subtype: "plugin_install", session_id: "session", uuid: "pi" },
-        { type: "system", subtype: "memory_recall", session_id: "session", uuid: "mr" },
-        { type: "system", subtype: "elicitation_complete", session_id: "session", uuid: "ec" },
-        { type: "prompt_suggestion", suggestion: "try this", session_id: "session", uuid: "ps" },
-        {
-          type: "system",
-          subtype: "notification",
-          key: "context",
-          text: "low priority note",
-          priority: "low",
-          session_id: "session",
-          uuid: "notif",
-        },
-      ]) {
-        harness.query.emit(message as unknown as SDKMessage);
-      }
-      // High-priority notifications DO surface as a warning row.
-      harness.query.emit({
-        type: "system",
-        subtype: "notification",
-        key: "limit",
-        text: "context window nearly full",
-        priority: "high",
-        session_id: "session",
-        uuid: "notif-high",
-      } as unknown as SDKMessage);
-      // session_state_changed maps to the matching session states.
-      for (const [state, uuid] of [
-        ["running", "ssc-run"],
-        ["requires_action", "ssc-req"],
-        ["idle", "ssc-idle"],
-      ]) {
-        harness.query.emit({
-          type: "system",
-          subtype: "session_state_changed",
-          state,
-          session_id: "session",
-          uuid,
-        } as unknown as SDKMessage);
-      }
-      // api_retry maps to a session heartbeat, not a warning row.
-      harness.query.emit({
-        type: "system",
-        subtype: "api_retry",
-        attempt: 3,
-        max_retries: 10,
-        retry_delay_ms: 1000,
-        error_status: 502,
-        error: { type: "api_error" },
-        session_id: "session",
-        uuid: "retry",
-      } as unknown as SDKMessage);
-      yield* Effect.yieldNow;
-      yield* Effect.yieldNow;
-
-      const warnings = runtimeEvents.filter((event) => event.type === "runtime.warning");
-      // Exactly one warning: the high-priority notification. Nothing else.
-      assert.deepEqual(
-        warnings.map((event) => event.payload.message),
-        ["context window nearly full"],
-      );
-      const sessionStates = runtimeEvents
-        .filter((event) => event.type === "session.state.changed")
-        .map((event) =>
-          event.type === "session.state.changed"
-            ? `${event.payload.state}:${event.payload.reason ?? ""}`
-            : "",
-        )
-        .filter(
-          (entry) => entry.startsWith("running:session_state") || entry.includes("session_state"),
-        );
-      assert.deepEqual(sessionStates, [
-        "running:session_state:running",
-        "waiting:session_state:requires_action",
-        "ready:session_state:idle",
-      ]);
-      const heartbeat = runtimeEvents.find(
-        (event) =>
-          event.type === "session.state.changed" &&
-          typeof event.payload.reason === "string" &&
-          event.payload.reason.startsWith("api_retry:"),
-      );
-      assert.equal(heartbeat?.type, "session.state.changed");
-      runtimeEventsFiber.interruptUnsafe();
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("consumes Claude command lifecycle notifications silently", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-      const sessionId = "6e81554e-5cff-4b37-8a39-f3a9051ac234";
-
-      yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-
-      const readyMessage = "command lifecycle test ready";
-      const readyFiber = yield* Stream.takeUntil(
-        adapter.streamEvents,
-        (event) => event.type === "runtime.warning" && event.payload.message === readyMessage,
-      ).pipe(Stream.runDrain, Effect.forkChild);
-      harness.query.emit({
-        type: "system",
-        subtype: "notification",
-        key: "command-lifecycle-ready",
-        text: readyMessage,
-        priority: "high",
-        session_id: sessionId,
-        uuid: "command-lifecycle-ready",
-      } as unknown as SDKMessage);
-      yield* Fiber.join(readyFiber);
-
-      const processedMessage = "command lifecycle messages processed";
-      const runtimeEventsFiber = yield* Stream.takeUntil(
-        adapter.streamEvents,
-        (event) => event.type === "runtime.warning" && event.payload.message === processedMessage,
-      ).pipe(Stream.runCollect, Effect.forkChild);
-      for (const [state, uuid] of [
-        ["started", "command-started"],
-        ["completed", "command-completed"],
-      ]) {
-        harness.query.emit({
-          type: "command_lifecycle",
-          command_uuid: "4cd8e8a3-df7a-425d-b6c9-4053abc0b8fd",
-          state,
-          session_id: sessionId,
-          uuid,
-        } as unknown as SDKMessage);
-      }
-      harness.query.emit({
-        type: "system",
-        subtype: "notification",
-        key: "command-lifecycle-processed",
-        text: processedMessage,
-        priority: "high",
-        session_id: sessionId,
-        uuid: "command-lifecycle-processed",
-      } as unknown as SDKMessage);
-
-      const runtimeEvents = Array.from(yield* Fiber.join(runtimeEventsFiber));
-      assert.deepEqual(
-        runtimeEvents.map((event) => event.type),
-        ["runtime.warning"],
-      );
-      const warning = runtimeEvents[0];
-      assert.equal(warning?.type, "runtime.warning");
-      if (warning?.type === "runtime.warning") {
-        assert.equal(warning.payload.message, processedMessage);
-      }
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("emits thread token usage updates from Claude task progress", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      const runtimeEventsFiber = yield* Stream.take(adapter.streamEvents, 6).pipe(
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-
-      yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-
-      harness.query.emit({
-        type: "system",
-        subtype: "task_progress",
-        task_id: "task-usage-1",
-        description: "Thinking through the patch",
-        usage: {
-          total_tokens: 321,
-          tool_uses: 2,
-          duration_ms: 654,
-        },
-        session_id: "sdk-session-task-usage",
-        uuid: "task-usage-progress-1",
-      } as unknown as SDKMessage);
-
-      const runtimeEvents = Array.from(yield* Fiber.join(runtimeEventsFiber));
-      const usageEvent = runtimeEvents.find((event) => event.type === "thread.token-usage.updated");
-      const progressEvent = runtimeEvents.find((event) => event.type === "task.progress");
-      assert.equal(usageEvent?.type, "thread.token-usage.updated");
-      if (usageEvent?.type === "thread.token-usage.updated") {
-        assert.deepEqual(usageEvent.payload, {
-          usage: {
-            usedTokens: 321,
-            lastUsedTokens: 321,
-            toolUses: 2,
-            durationMs: 654,
-          },
-        });
-      }
-      assert.equal(progressEvent?.type, "task.progress");
-      if (usageEvent && progressEvent) {
-        assert.notStrictEqual(usageEvent.eventId, progressEvent.eventId);
-      }
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("emits Claude context window on result completion usage snapshots", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      const runtimeEventsFiber = yield* Stream.take(adapter.streamEvents, 7).pipe(
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-
-      yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-
-      yield* adapter.sendTurn({
-        threadId: THREAD_ID,
-        input: "hello",
-        attachments: [],
-      });
-
-      harness.query.emit({
-        type: "result",
-        subtype: "success",
-        is_error: false,
-        duration_ms: 1234,
-        duration_api_ms: 1200,
-        num_turns: 1,
-        result: "done",
-        stop_reason: "end_turn",
-        session_id: "sdk-session-result-usage",
-        usage: {
-          input_tokens: 4,
-          cache_creation_input_tokens: 2715,
-          cache_read_input_tokens: 21144,
-          output_tokens: 679,
-        },
-        modelUsage: {
-          "claude-opus-4-6": {
-            contextWindow: 200000,
-            maxOutputTokens: 64000,
-          },
-        },
-      } as unknown as SDKMessage);
-      harness.query.finish();
-
-      const runtimeEvents = Array.from(yield* Fiber.join(runtimeEventsFiber));
-      const usageEvent = runtimeEvents.find((event) => event.type === "thread.token-usage.updated");
-      assert.equal(usageEvent?.type, "thread.token-usage.updated");
-      if (usageEvent?.type === "thread.token-usage.updated") {
-        assert.deepEqual(usageEvent.payload, {
-          usage: {
-            usedTokens: 24542,
-            lastUsedTokens: 24542,
-            inputTokens: 23863,
-            outputTokens: 679,
-            maxTokens: 200000,
-          },
-        });
-      }
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("clamps oversized Claude usage to the reported context window", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      const runtimeEventsFiber = yield* Stream.take(adapter.streamEvents, 7).pipe(
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-
-      yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-
-      yield* adapter.sendTurn({
-        threadId: THREAD_ID,
-        input: "hello",
-        attachments: [],
-      });
-
-      harness.query.emit({
-        type: "result",
-        subtype: "success",
-        is_error: false,
-        duration_ms: 1234,
-        duration_api_ms: 1200,
-        num_turns: 1,
-        result: "done",
-        stop_reason: "end_turn",
-        session_id: "sdk-session-result-usage-clamped",
-        usage: {
-          total_tokens: 535000,
-        },
-        modelUsage: {
-          "claude-opus-4-6": {
-            contextWindow: 200000,
-            maxOutputTokens: 64000,
-          },
-        },
-      } as unknown as SDKMessage);
-      harness.query.finish();
-
-      const runtimeEvents = Array.from(yield* Fiber.join(runtimeEventsFiber));
-      const usageEvent = runtimeEvents.find((event) => event.type === "thread.token-usage.updated");
-      assert.equal(usageEvent?.type, "thread.token-usage.updated");
-      if (usageEvent?.type === "thread.token-usage.updated") {
-        assert.deepEqual(usageEvent.payload, {
-          usage: {
-            usedTokens: 200000,
-            lastUsedTokens: 200000,
-            totalProcessedTokens: 535000,
-            maxTokens: 200000,
-          },
-        });
-      }
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect(
-    "preserves oversized Claude result totals after task progress snapshots are recorded",
-    () => {
-      const harness = makeHarness();
-      return Effect.gen(function* () {
-        const adapter = yield* ClaudeAdapter;
-
-        const runtimeEventsFiber = yield* Stream.take(adapter.streamEvents, 9).pipe(
-          Stream.runCollect,
-          Effect.forkChild,
-        );
-
-        yield* adapter.startSession({
-          threadId: THREAD_ID,
-          provider: ProviderDriverKind.make("claudeAgent"),
-          runtimeMode: "full-access",
-        });
-
-        yield* adapter.sendTurn({
-          threadId: THREAD_ID,
-          input: "hello",
-          attachments: [],
-        });
-
-        harness.query.emit({
-          type: "system",
-          subtype: "task_progress",
-          task_id: "task-usage-clamped",
-          description: "Thinking through the patch",
-          usage: {
-            total_tokens: 190000,
-          },
-          session_id: "sdk-session-task-usage-clamped",
-          uuid: "task-usage-progress-clamped",
-        } as unknown as SDKMessage);
-
-        harness.query.emit({
-          type: "result",
-          subtype: "success",
-          is_error: false,
-          duration_ms: 1234,
-          duration_api_ms: 1200,
-          num_turns: 1,
-          result: "done",
-          stop_reason: "end_turn",
-          session_id: "sdk-session-result-usage-clamped-after-progress",
-          usage: {
-            total_tokens: 535000,
-          },
-          modelUsage: {
-            "claude-opus-4-6": {
-              contextWindow: 200000,
-              maxOutputTokens: 64000,
-            },
-          },
-        } as unknown as SDKMessage);
-        harness.query.finish();
-
-        const runtimeEvents = Array.from(yield* Fiber.join(runtimeEventsFiber));
-        const usageEvents = runtimeEvents.filter(
-          (event) => event.type === "thread.token-usage.updated",
-        );
-        const finalUsageEvent = usageEvents.at(-1);
-        assert.equal(finalUsageEvent?.type, "thread.token-usage.updated");
-        if (finalUsageEvent?.type === "thread.token-usage.updated") {
-          assert.deepEqual(finalUsageEvent.payload, {
-            usage: {
-              usedTokens: 190000,
-              lastUsedTokens: 190000,
-              totalProcessedTokens: 535000,
-              maxTokens: 200000,
-            },
-          });
-        }
-      }).pipe(
-        Effect.provideService(Random.Random, makeDeterministicRandomService()),
-        Effect.provide(harness.layer),
-      );
-    },
-  );
-
-  it.effect(
-    "emits completion only after turn result when assistant frames arrive before deltas",
-    () => {
-      const harness = makeHarness();
-      return Effect.gen(function* () {
-        const adapter = yield* ClaudeAdapter;
-
-        const runtimeEventsFiber = yield* Stream.take(adapter.streamEvents, 8).pipe(
-          Stream.runCollect,
-          Effect.forkChild,
-        );
-
-        const session = yield* adapter.startSession({
-          threadId: THREAD_ID,
-          provider: ProviderDriverKind.make("claudeAgent"),
-          runtimeMode: "full-access",
-        });
-
-        const turn = yield* adapter.sendTurn({
-          threadId: session.threadId,
-          input: "hello",
-          attachments: [],
-        });
-
-        harness.query.emit({
-          type: "assistant",
-          session_id: "sdk-session-early-assistant",
-          uuid: "assistant-early",
-          parent_tool_use_id: null,
-          message: {
-            id: "assistant-message-early",
-            content: [
-              { type: "tool_use", id: "tool-early", name: "Read", input: { path: "a.ts" } },
-            ],
-          },
-        } as unknown as SDKMessage);
-
-        harness.query.emit({
-          type: "stream_event",
-          session_id: "sdk-session-early-assistant",
-          uuid: "stream-early",
-          parent_tool_use_id: null,
-          event: {
-            type: "content_block_delta",
-            index: 0,
-            delta: {
-              type: "text_delta",
-              text: "Late text",
-            },
-          },
-        } as unknown as SDKMessage);
-
-        harness.query.emit({
-          type: "result",
-          subtype: "success",
-          is_error: false,
-          errors: [],
-          session_id: "sdk-session-early-assistant",
-          uuid: "result-early",
-        } as unknown as SDKMessage);
-
-        const runtimeEvents = Array.from(yield* Fiber.join(runtimeEventsFiber));
-        assert.deepEqual(
-          runtimeEvents.map((event) => event.type),
-          [
-            "session.started",
-            "session.configured",
-            "session.state.changed",
-            "turn.started",
-            "thread.started",
-            "content.delta",
-            "item.completed",
-            "turn.completed",
-          ],
-        );
-
-        const deltaIndex = runtimeEvents.findIndex((event) => event.type === "content.delta");
-        const completedIndex = runtimeEvents.findIndex((event) => event.type === "item.completed");
-        assert.equal(deltaIndex >= 0 && completedIndex >= 0 && deltaIndex < completedIndex, true);
-
-        const deltaEvent = runtimeEvents[deltaIndex];
-        assert.equal(deltaEvent?.type, "content.delta");
-        if (deltaEvent?.type === "content.delta") {
-          assert.equal(deltaEvent.payload.delta, "Late text");
-          assert.equal(String(deltaEvent.turnId), String(turn.turnId));
-        }
-      }).pipe(
-        Effect.provideService(Random.Random, makeDeterministicRandomService()),
-        Effect.provide(harness.layer),
-      );
-    },
-  );
-
-  it.effect("creates a fresh assistant message when Claude reuses a text block index", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      const runtimeEventsFiber = yield* Stream.take(adapter.streamEvents, 9).pipe(
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-
-      const session = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-
-      yield* adapter.sendTurn({
-        threadId: session.threadId,
-        input: "hello",
-        attachments: [],
-      });
-
-      harness.query.emit({
-        type: "stream_event",
-        session_id: "sdk-session-reused-text-index",
-        uuid: "stream-reused-start-1",
-        parent_tool_use_id: null,
-        event: {
-          type: "content_block_start",
-          index: 0,
-          content_block: {
-            type: "text",
-            text: "",
-          },
-        },
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "stream_event",
-        session_id: "sdk-session-reused-text-index",
-        uuid: "stream-reused-delta-1",
-        parent_tool_use_id: null,
-        event: {
-          type: "content_block_delta",
-          index: 0,
-          delta: {
-            type: "text_delta",
-            text: "First",
-          },
-        },
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "stream_event",
-        session_id: "sdk-session-reused-text-index",
-        uuid: "stream-reused-stop-1",
-        parent_tool_use_id: null,
-        event: {
-          type: "content_block_stop",
-          index: 0,
-        },
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "stream_event",
-        session_id: "sdk-session-reused-text-index",
-        uuid: "stream-reused-start-2",
-        parent_tool_use_id: null,
-        event: {
-          type: "content_block_start",
-          index: 0,
-          content_block: {
-            type: "text",
-            text: "",
-          },
-        },
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "stream_event",
-        session_id: "sdk-session-reused-text-index",
-        uuid: "stream-reused-delta-2",
-        parent_tool_use_id: null,
-        event: {
-          type: "content_block_delta",
-          index: 0,
-          delta: {
-            type: "text_delta",
-            text: "Second",
-          },
-        },
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "stream_event",
-        session_id: "sdk-session-reused-text-index",
-        uuid: "stream-reused-stop-2",
-        parent_tool_use_id: null,
-        event: {
-          type: "content_block_stop",
-          index: 0,
-        },
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "result",
-        subtype: "success",
-        is_error: false,
-        errors: [],
-        session_id: "sdk-session-reused-text-index",
-        uuid: "result-reused-text-index",
-      } as unknown as SDKMessage);
-
-      const runtimeEvents = Array.from(yield* Fiber.join(runtimeEventsFiber));
-      assert.deepEqual(
-        runtimeEvents.map((event) => event.type),
-        [
-          "session.started",
-          "session.configured",
-          "session.state.changed",
-          "turn.started",
-          "thread.started",
-          "content.delta",
-          "item.completed",
-          "content.delta",
-          "item.completed",
-        ],
-      );
-
-      const assistantDeltas = runtimeEvents.filter(
-        (event) => event.type === "content.delta" && event.payload.streamKind === "assistant_text",
-      );
-      assert.equal(assistantDeltas.length, 2);
-      if (assistantDeltas.length !== 2) {
-        return;
-      }
-      const [firstAssistantDelta, secondAssistantDelta] = assistantDeltas;
-      assert.equal(firstAssistantDelta?.type, "content.delta");
-      assert.equal(secondAssistantDelta?.type, "content.delta");
-      if (
-        firstAssistantDelta?.type !== "content.delta" ||
-        secondAssistantDelta?.type !== "content.delta"
-      ) {
-        return;
-      }
-      assert.equal(firstAssistantDelta.payload.delta, "First");
-      assert.equal(secondAssistantDelta.payload.delta, "Second");
-      assert.notEqual(firstAssistantDelta.itemId, secondAssistantDelta.itemId);
-
-      const assistantCompletions = runtimeEvents.filter(
-        (event) =>
-          event.type === "item.completed" && event.payload.itemType === "assistant_message",
-      );
-      assert.equal(assistantCompletions.length, 2);
-      assert.equal(String(assistantCompletions[0]?.itemId), String(firstAssistantDelta.itemId));
-      assert.equal(String(assistantCompletions[1]?.itemId), String(secondAssistantDelta.itemId));
-      assert.notEqual(
-        String(assistantCompletions[0]?.itemId),
-        String(assistantCompletions[1]?.itemId),
-      );
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("falls back to assistant payload text when stream deltas are absent", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      const runtimeEventsFiber = yield* Stream.take(adapter.streamEvents, 8).pipe(
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-
-      const session = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-
-      const turn = yield* adapter.sendTurn({
-        threadId: session.threadId,
-        input: "hello",
-        attachments: [],
-      });
-
-      harness.query.emit({
-        type: "assistant",
-        session_id: "sdk-session-fallback-text",
-        uuid: "assistant-fallback",
-        parent_tool_use_id: null,
-        message: {
-          id: "assistant-message-fallback",
-          content: [{ type: "text", text: "Fallback hello" }],
-        },
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "result",
-        subtype: "success",
-        is_error: false,
-        errors: [],
-        session_id: "sdk-session-fallback-text",
-        uuid: "result-fallback",
-      } as unknown as SDKMessage);
-
-      const runtimeEvents = Array.from(yield* Fiber.join(runtimeEventsFiber));
-      assert.deepEqual(
-        runtimeEvents.map((event) => event.type),
-        [
-          "session.started",
-          "session.configured",
-          "session.state.changed",
-          "turn.started",
-          "thread.started",
-          "content.delta",
-          "item.completed",
-          "turn.completed",
-        ],
-      );
-
-      const deltaEvent = runtimeEvents.find((event) => event.type === "content.delta");
-      assert.equal(deltaEvent?.type, "content.delta");
-      if (deltaEvent?.type === "content.delta") {
-        assert.equal(deltaEvent.payload.delta, "Fallback hello");
-        assert.equal(String(deltaEvent.turnId), String(turn.turnId));
-      }
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("segments Claude assistant text blocks around tool calls", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      const runtimeEventsFiber = yield* Stream.take(adapter.streamEvents, 13).pipe(
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-
-      const session = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-
-      yield* adapter.sendTurn({
-        threadId: session.threadId,
-        input: "hello",
-        attachments: [],
-      });
-
-      harness.query.emit({
-        type: "stream_event",
-        session_id: "sdk-session-interleaved",
-        uuid: "stream-text-1-start",
-        parent_tool_use_id: null,
-        event: {
-          type: "content_block_start",
-          index: 0,
-          content_block: {
-            type: "text",
-            text: "",
-          },
-        },
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "stream_event",
-        session_id: "sdk-session-interleaved",
-        uuid: "stream-text-1-delta",
-        parent_tool_use_id: null,
-        event: {
-          type: "content_block_delta",
-          index: 0,
-          delta: {
-            type: "text_delta",
-            text: "First message.",
-          },
-        },
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "stream_event",
-        session_id: "sdk-session-interleaved",
-        uuid: "stream-text-1-stop",
-        parent_tool_use_id: null,
-        event: {
-          type: "content_block_stop",
-          index: 0,
-        },
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "stream_event",
-        session_id: "sdk-session-interleaved",
-        uuid: "stream-tool-start",
-        parent_tool_use_id: null,
-        event: {
-          type: "content_block_start",
-          index: 1,
-          content_block: {
-            type: "tool_use",
-            id: "tool-interleaved-1",
-            name: "Grep",
-            input: {
-              pattern: "assistant",
-              path: "src",
-            },
-          },
-        },
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "stream_event",
-        session_id: "sdk-session-interleaved",
-        uuid: "stream-tool-stop",
-        parent_tool_use_id: null,
-        event: {
-          type: "content_block_stop",
-          index: 1,
-        },
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "user",
-        session_id: "sdk-session-interleaved",
-        uuid: "user-tool-result-interleaved",
-        parent_tool_use_id: null,
-        message: {
-          role: "user",
-          content: [
-            {
-              type: "tool_result",
-              tool_use_id: "tool-interleaved-1",
-              content: "src/example.ts:1:assistant",
-            },
-          ],
-        },
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "stream_event",
-        session_id: "sdk-session-interleaved",
-        uuid: "stream-text-2-start",
-        parent_tool_use_id: null,
-        event: {
-          type: "content_block_start",
-          index: 2,
-          content_block: {
-            type: "text",
-            text: "",
-          },
-        },
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "stream_event",
-        session_id: "sdk-session-interleaved",
-        uuid: "stream-text-2-delta",
-        parent_tool_use_id: null,
-        event: {
-          type: "content_block_delta",
-          index: 2,
-          delta: {
-            type: "text_delta",
-            text: "Second message.",
-          },
-        },
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "stream_event",
-        session_id: "sdk-session-interleaved",
-        uuid: "stream-text-2-stop",
-        parent_tool_use_id: null,
-        event: {
-          type: "content_block_stop",
-          index: 2,
-        },
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "result",
-        subtype: "success",
-        is_error: false,
-        errors: [],
-        session_id: "sdk-session-interleaved",
-        uuid: "result-interleaved",
-      } as unknown as SDKMessage);
-
-      const runtimeEvents = Array.from(yield* Fiber.join(runtimeEventsFiber));
-      assert.deepEqual(
-        runtimeEvents.map((event) => event.type),
-        [
-          "session.started",
-          "session.configured",
-          "session.state.changed",
-          "turn.started",
-          "thread.started",
-          "content.delta",
-          "item.completed",
-          "item.started",
-          "item.updated",
-          "item.completed",
-          "content.delta",
-          "item.completed",
-          "turn.completed",
-        ],
-      );
-
-      const assistantTextDeltas = runtimeEvents.filter(
-        (event) => event.type === "content.delta" && event.payload.streamKind === "assistant_text",
-      );
-      assert.equal(assistantTextDeltas.length, 2);
-      if (assistantTextDeltas.length !== 2) {
-        return;
-      }
-      const [firstAssistantDelta, secondAssistantDelta] = assistantTextDeltas;
-      if (!firstAssistantDelta || !secondAssistantDelta) {
-        return;
-      }
-      assert.notEqual(String(firstAssistantDelta.itemId), String(secondAssistantDelta.itemId));
-
-      const firstAssistantCompletedIndex = runtimeEvents.findIndex(
-        (event) =>
-          event.type === "item.completed" &&
-          event.payload.itemType === "assistant_message" &&
-          String(event.itemId) === String(firstAssistantDelta.itemId),
-      );
-      const toolStartedIndex = runtimeEvents.findIndex((event) => event.type === "item.started");
-      const secondAssistantDeltaIndex = runtimeEvents.findIndex(
-        (event) =>
-          event.type === "content.delta" &&
-          event.payload.streamKind === "assistant_text" &&
-          String(event.itemId) === String(secondAssistantDelta.itemId),
-      );
-
-      assert.equal(
-        firstAssistantCompletedIndex >= 0 &&
-          toolStartedIndex >= 0 &&
-          secondAssistantDeltaIndex >= 0 &&
-          firstAssistantCompletedIndex < toolStartedIndex &&
-          toolStartedIndex < secondAssistantDeltaIndex,
-        true,
-      );
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("does not fabricate provider thread ids before first SDK session_id", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      const runtimeEventsFiber = yield* Stream.take(adapter.streamEvents, 5).pipe(
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-
-      const session = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-      assert.equal(session.threadId, THREAD_ID);
-
-      const turn = yield* adapter.sendTurn({
-        threadId: session.threadId,
-        input: "hello",
-        attachments: [],
-      });
-      assert.equal(turn.threadId, THREAD_ID);
-
-      harness.query.emit({
-        type: "stream_event",
-        session_id: "sdk-thread-real",
-        uuid: "stream-thread-real",
-        parent_tool_use_id: null,
-        event: {
-          type: "message_start",
-          message: {
-            id: "msg-thread-real",
-          },
-        },
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "result",
-        subtype: "success",
-        is_error: false,
-        errors: [],
-        session_id: "sdk-thread-real",
-        uuid: "result-thread-real",
-      } as unknown as SDKMessage);
-
-      const runtimeEvents = Array.from(yield* Fiber.join(runtimeEventsFiber));
-      assert.deepEqual(
-        runtimeEvents.map((event) => event.type),
-        [
-          "session.started",
-          "session.configured",
-          "session.state.changed",
-          "turn.started",
-          "thread.started",
-        ],
-      );
-
-      const sessionStarted = runtimeEvents[0];
-      assert.equal(sessionStarted?.type, "session.started");
-      if (sessionStarted?.type === "session.started") {
-        assert.equal(sessionStarted.threadId, THREAD_ID);
-      }
-
-      const threadStarted = runtimeEvents[4];
-      assert.equal(threadStarted?.type, "thread.started");
-      if (threadStarted?.type === "thread.started") {
-        assert.equal(threadStarted.threadId, THREAD_ID);
-        assert.deepEqual(threadStarted.payload, {
-          providerThreadId: "sdk-thread-real",
-        });
-      }
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("bridges approval request/response lifecycle through canUseTool", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      const session = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "approval-required",
-      });
-
-      yield* Stream.take(adapter.streamEvents, 3).pipe(Stream.runDrain);
-
-      yield* adapter.sendTurn({
-        threadId: session.threadId,
-        input: "approve this",
-        attachments: [],
-      });
-      yield* Stream.take(adapter.streamEvents, 1).pipe(Stream.runDrain);
-
-      harness.query.emit({
-        type: "stream_event",
-        session_id: "sdk-session-approval-1",
-        uuid: "stream-approval-thread",
-        parent_tool_use_id: null,
-        event: {
-          type: "message_start",
-          message: {
-            id: "msg-approval-thread",
-          },
-        },
-      } as unknown as SDKMessage);
-
-      const threadStarted = yield* Stream.runHead(adapter.streamEvents);
-      assert.equal(threadStarted._tag, "Some");
-      if (threadStarted._tag !== "Some" || threadStarted.value.type !== "thread.started") {
-        return;
-      }
-
-      const createInput = harness.getLastCreateQueryInput();
-      const canUseTool = createInput?.options.canUseTool;
-      assert.equal(typeof canUseTool, "function");
-      if (!canUseTool) {
-        return;
-      }
-
-      const permissionPromise = canUseTool(
-        "Bash",
-        { command: "pwd" },
-        {
-          signal: new AbortController().signal,
-          suggestions: [
-            {
-              type: "setMode",
-              mode: "default",
-              destination: "session",
-            },
-          ],
-          toolUseID: "tool-use-1",
-        },
-      );
-
-      const requested = yield* Stream.runHead(adapter.streamEvents);
-      assert.equal(requested._tag, "Some");
-      if (requested._tag !== "Some") {
-        return;
-      }
-      assert.equal(requested.value.type, "request.opened");
-      if (requested.value.type !== "request.opened") {
-        return;
-      }
-      assert.deepEqual(requested.value.providerRefs, {
-        providerItemId: ProviderItemId.make("tool-use-1"),
-      });
-      const runtimeRequestId = requested.value.requestId;
-      assert.equal(typeof runtimeRequestId, "string");
-      if (runtimeRequestId === undefined) {
-        return;
-      }
-
-      yield* adapter.respondToRequest(
-        session.threadId,
-        ApprovalRequestId.make(runtimeRequestId),
-        "accept",
-      );
-
-      const resolved = yield* Stream.runHead(adapter.streamEvents);
-      assert.equal(resolved._tag, "Some");
-      if (resolved._tag !== "Some") {
-        return;
-      }
-      assert.equal(resolved.value.type, "request.resolved");
-      if (resolved.value.type !== "request.resolved") {
-        return;
-      }
-      assert.equal(resolved.value.requestId, requested.value.requestId);
-      assert.equal(resolved.value.payload.decision, "accept");
-      assert.deepEqual(resolved.value.providerRefs, {
-        providerItemId: ProviderItemId.make("tool-use-1"),
-      });
-
-      const permissionResult = yield* Effect.promise(() => permissionPromise);
-      assert.equal((permissionResult as PermissionResult).behavior, "allow");
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("acceptForSession returns session-scoped permission updates", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      const session = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "approval-required",
-      });
-
-      yield* Stream.take(adapter.streamEvents, 3).pipe(Stream.runDrain);
-
-      yield* adapter.sendTurn({
-        threadId: session.threadId,
-        input: "approve this for the session",
-        attachments: [],
-      });
-      yield* Stream.take(adapter.streamEvents, 1).pipe(Stream.runDrain);
-
-      const createInput = harness.getLastCreateQueryInput();
-      const canUseTool = createInput?.options.canUseTool;
-      assert.equal(typeof canUseTool, "function");
-      if (!canUseTool) {
-        return;
-      }
-
-      const respondToNextRequest = Effect.gen(function* () {
-        const requested = yield* Stream.runHead(adapter.streamEvents);
-        assert.equal(requested._tag, "Some");
-        if (requested._tag !== "Some" || requested.value.type !== "request.opened") {
-          return;
-        }
-        const runtimeRequestId = requested.value.requestId;
-        assert.equal(typeof runtimeRequestId, "string");
-        if (runtimeRequestId === undefined) {
-          return;
-        }
-        yield* adapter.respondToRequest(
-          session.threadId,
-          ApprovalRequestId.make(runtimeRequestId),
-          "acceptForSession",
-        );
-        yield* Stream.take(adapter.streamEvents, 1).pipe(Stream.runDrain);
-      });
-
-      // MCP tools frequently arrive with no usable suggestion (Claude Code
-      // sends an empty array); the decision must still stick for the session.
-      const mcpPermissionPromise = canUseTool(
-        "mcp__linear__create_issue",
-        { title: "hello" },
-        {
-          signal: new AbortController().signal,
-          suggestions: [],
-          toolUseID: "tool-use-mcp-1",
-        },
-      );
-      yield* respondToNextRequest;
-      const mcpPermission = (yield* Effect.promise(() => mcpPermissionPromise)) as PermissionResult;
-      assert.equal(mcpPermission.behavior, "allow");
-      if (mcpPermission.behavior !== "allow") {
-        return;
-      }
-      assert.deepEqual(mcpPermission.updatedPermissions, [
-        {
-          type: "addRules",
-          rules: [{ toolName: "mcp__linear__create_issue" }],
-          behavior: "allow",
-          destination: "session",
-        },
-      ]);
-
-      // Received suggestions are reused but rescoped to the session —
-      // echoing "localSettings" would persist a session-only choice to disk.
-      const bashPermissionPromise = canUseTool(
-        "Bash",
-        { command: "git status" },
-        {
-          signal: new AbortController().signal,
-          suggestions: [
-            {
-              type: "addRules",
-              rules: [{ toolName: "Bash", ruleContent: "git status" }],
-              behavior: "allow",
-              destination: "localSettings",
-            },
-          ],
-          toolUseID: "tool-use-bash-1",
-        },
-      );
-      yield* respondToNextRequest;
-      const bashPermission = (yield* Effect.promise(
-        () => bashPermissionPromise,
-      )) as PermissionResult;
-      assert.equal(bashPermission.behavior, "allow");
-      if (bashPermission.behavior !== "allow") {
-        return;
-      }
-      assert.deepEqual(bashPermission.updatedPermissions, [
-        {
-          type: "addRules",
-          rules: [{ toolName: "Bash", ruleContent: "git status" }],
-          behavior: "allow",
-          destination: "session",
-        },
-      ]);
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("classifies Agent tools and read-only Claude tools correctly for approvals", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      const session = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "approval-required",
-      });
-
-      yield* Stream.take(adapter.streamEvents, 3).pipe(Stream.runDrain);
-
-      const createInput = harness.getLastCreateQueryInput();
-      const canUseTool = createInput?.options.canUseTool;
-      assert.equal(typeof canUseTool, "function");
-      if (!canUseTool) {
-        return;
-      }
-
-      const agentPermissionPromise = canUseTool(
-        "Agent",
-        {},
-        {
-          signal: new AbortController().signal,
-          toolUseID: "tool-agent-1",
-        },
-      );
-
-      const agentRequested = yield* Stream.runHead(adapter.streamEvents);
-      assert.equal(agentRequested._tag, "Some");
-      if (agentRequested._tag !== "Some" || agentRequested.value.type !== "request.opened") {
-        return;
-      }
-      assert.equal(agentRequested.value.payload.requestType, "dynamic_tool_call");
-
-      yield* adapter.respondToRequest(
-        session.threadId,
-        ApprovalRequestId.make(String(agentRequested.value.requestId)),
-        "accept",
-      );
-      yield* Stream.runHead(adapter.streamEvents);
-      yield* Effect.promise(() => agentPermissionPromise);
-
-      const grepPermissionPromise = canUseTool(
-        "Grep",
-        { pattern: "foo", path: "src" },
-        {
-          signal: new AbortController().signal,
-          toolUseID: "tool-grep-approval-1",
-        },
-      );
-
-      const grepRequested = yield* Stream.runHead(adapter.streamEvents);
-      assert.equal(grepRequested._tag, "Some");
-      if (grepRequested._tag !== "Some" || grepRequested.value.type !== "request.opened") {
-        return;
-      }
-      assert.equal(grepRequested.value.payload.requestType, "file_read_approval");
-
-      yield* adapter.respondToRequest(
-        session.threadId,
-        ApprovalRequestId.make(String(grepRequested.value.requestId)),
-        "accept",
-      );
-      yield* Stream.runHead(adapter.streamEvents);
-      yield* Effect.promise(() => grepPermissionPromise);
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("passes Claude resume ids without pinning a stale assistant checkpoint", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      const session = yield* adapter.startSession({
-        threadId: RESUME_THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        resumeCursor: {
-          threadId: "resume-thread-1",
-          resume: "550e8400-e29b-41d4-a716-446655440000",
-          resumeSessionAt: "assistant-99",
-          turnCount: 3,
-        },
-        runtimeMode: "full-access",
-      });
-
-      assert.equal(session.threadId, RESUME_THREAD_ID);
-      assert.deepEqual(session.resumeCursor, {
-        threadId: RESUME_THREAD_ID,
-        resume: "550e8400-e29b-41d4-a716-446655440000",
-        resumeSessionAt: "assistant-99",
-        turnCount: 3,
-      });
-
-      const createInput = harness.getLastCreateQueryInput();
-      assert.equal(createInput?.options.resume, "550e8400-e29b-41d4-a716-446655440000");
-      assert.equal(createInput?.options.sessionId, undefined);
-      assert.equal(createInput?.options.resumeSessionAt, undefined);
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("preserves durable resume ids across Claude resume hooks", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-      const durableSessionId = "550e8400-e29b-41d4-a716-446655440000";
-      const transientHookSessionId = "7368d0c7-40a3-4d8a-bcc1-ac80c49f2719";
-
-      const runtimeEventsFiber = yield* Stream.take(adapter.streamEvents, 7).pipe(
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-
-      yield* adapter.startSession({
-        threadId: RESUME_THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        resumeCursor: {
-          threadId: RESUME_THREAD_ID,
-          resume: durableSessionId,
-          resumeSessionAt: "assistant-99",
-          turnCount: 3,
-        },
-        runtimeMode: "full-access",
-      });
-
-      harness.query.emit({
-        type: "system",
-        subtype: "hook_started",
-        hook_id: "resume-hook-1",
-        hook_name: "SessionStart:resume",
-        hook_event: "SessionStart",
-        session_id: transientHookSessionId,
-        uuid: "resume-hook-started",
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "system",
-        subtype: "hook_response",
-        hook_id: "resume-hook-1",
-        hook_name: "SessionStart:resume",
-        hook_event: "SessionStart",
-        output: "",
-        stdout: "",
-        stderr: "",
-        outcome: "success",
-        session_id: transientHookSessionId,
-        uuid: "resume-hook-response",
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "system",
-        subtype: "init",
-        apiKeySource: "none",
-        claude_code_version: "test",
-        cwd: "/tmp/claude-adapter-test",
-        tools: [],
-        mcp_servers: [],
-        model: "claude-sonnet-4-5",
-        permissionMode: "bypassPermissions",
-        slash_commands: [],
-        output_style: "default",
-        skills: [],
-        plugins: [],
-        session_id: durableSessionId,
-        uuid: "resume-init",
-      } as unknown as SDKMessage);
-
-      const runtimeEvents = Array.from(yield* Fiber.join(runtimeEventsFiber));
-      const threadStartedEvents = runtimeEvents.filter((event) => event.type === "thread.started");
-      assert.equal(threadStartedEvents.length, 1);
-      const threadStarted = threadStartedEvents[0];
-      assert.equal(threadStarted?.type, "thread.started");
-      if (threadStarted?.type === "thread.started") {
-        assert.deepEqual(threadStarted.payload, {
-          providerThreadId: durableSessionId,
-        });
-      }
-
-      const activeSessions = yield* adapter.listSessions();
-      const resumeCursor = activeSessions[0]?.resumeCursor as
-        | {
-            readonly resume?: string;
-          }
-        | undefined;
-      assert.equal(resumeCursor?.resume, durableSessionId);
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("uses an app-generated Claude session id for fresh sessions", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      const session = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-
-      const createInput = harness.getLastCreateQueryInput();
-      const sessionResumeCursor = session.resumeCursor as {
-        threadId?: string;
-        resume?: string;
-        turnCount?: number;
-      };
-      assert.equal(sessionResumeCursor.threadId, THREAD_ID);
-      assert.equal(typeof sessionResumeCursor.resume, "string");
-      assert.equal(sessionResumeCursor.turnCount, 0);
-      assert.match(
-        sessionResumeCursor.resume ?? "",
-        /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,
-      );
-      assert.equal(createInput?.options.resume, undefined);
-      assert.equal(createInput?.options.sessionId, sessionResumeCursor.resume);
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect(
-    "supports rollbackThread by trimming in-memory turns and preserving earlier turns",
-    () => {
-      const harness = makeHarness();
-      return Effect.gen(function* () {
-        const adapter = yield* ClaudeAdapter;
-
-        const session = yield* adapter.startSession({
-          threadId: THREAD_ID,
-          provider: ProviderDriverKind.make("claudeAgent"),
-          runtimeMode: "full-access",
-        });
-
-        const firstTurn = yield* adapter.sendTurn({
-          threadId: session.threadId,
-          input: "first",
-          attachments: [],
-        });
-
-        const firstCompletedFiber = yield* Stream.filter(
-          adapter.streamEvents,
-          (event) => event.type === "turn.completed",
-        ).pipe(Stream.runHead, Effect.forkChild);
-
-        harness.query.emit({
-          type: "result",
-          subtype: "success",
-          is_error: false,
-          errors: [],
-          session_id: "sdk-session-rollback",
-          uuid: "result-first",
-        } as unknown as SDKMessage);
-
-        const firstCompleted = yield* Fiber.join(firstCompletedFiber);
-        assert.equal(firstCompleted._tag, "Some");
-        if (firstCompleted._tag === "Some" && firstCompleted.value.type === "turn.completed") {
-          assert.equal(String(firstCompleted.value.turnId), String(firstTurn.turnId));
-        }
-
-        const secondTurn = yield* adapter.sendTurn({
-          threadId: session.threadId,
-          input: "second",
-          attachments: [],
-        });
-
-        const secondCompletedFiber = yield* Stream.filter(
-          adapter.streamEvents,
-          (event) => event.type === "turn.completed",
-        ).pipe(Stream.runHead, Effect.forkChild);
-
-        harness.query.emit({
-          type: "result",
-          subtype: "success",
-          is_error: false,
-          errors: [],
-          session_id: "sdk-session-rollback",
-          uuid: "result-second",
-        } as unknown as SDKMessage);
-
-        const secondCompleted = yield* Fiber.join(secondCompletedFiber);
-        assert.equal(secondCompleted._tag, "Some");
-        if (secondCompleted._tag === "Some" && secondCompleted.value.type === "turn.completed") {
-          assert.equal(String(secondCompleted.value.turnId), String(secondTurn.turnId));
-        }
-
-        const threadBeforeRollback = yield* adapter.readThread(session.threadId);
-        assert.equal(threadBeforeRollback.turns.length, 2);
-
-        const rolledBack = yield* adapter.rollbackThread(session.threadId, 1);
-        assert.equal(rolledBack.turns.length, 1);
-        assert.equal(rolledBack.turns[0]?.id, firstTurn.turnId);
-
-        const threadAfterRollback = yield* adapter.readThread(session.threadId);
-        assert.equal(threadAfterRollback.turns.length, 1);
-        assert.equal(threadAfterRollback.turns[0]?.id, firstTurn.turnId);
-      }).pipe(
-        Effect.provideService(Random.Random, makeDeterministicRandomService()),
-        Effect.provide(harness.layer),
-      );
-    },
-  );
-
-  it.effect("updates model on sendTurn when model override is provided", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      const session = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-      yield* adapter.sendTurn({
-        threadId: session.threadId,
-        input: "hello",
-        modelSelection: {
-          instanceId: ProviderInstanceId.make("claudeAgent"),
-          model: "claude-opus-4-6",
-        },
-        attachments: [],
-      });
-
-      assert.deepEqual(harness.query.setModelCalls, ["claude-opus-4-6[1m]"]);
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("updates model on sendTurn for the adapter's bound custom instance id", () => {
-    const customInstanceId = ProviderInstanceId.make("claude_openrouter");
-    const harness = makeHarness({ instanceId: customInstanceId });
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      const session = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-      yield* adapter.sendTurn({
-        threadId: session.threadId,
-        input: "hello",
-        modelSelection: {
-          instanceId: customInstanceId,
-          model: "openai/gpt-5.5",
-        },
-        attachments: [],
-      });
-
-      assert.deepEqual(harness.query.setModelCalls, ["openai/gpt-5.5"]);
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect(
-    "does not re-set the Claude model when the session already uses the same effective API model",
-    () => {
-      const harness = makeHarness();
-      return Effect.gen(function* () {
-        const adapter = yield* ClaudeAdapter;
-        const modelSelection = {
-          instanceId: ProviderInstanceId.make("claudeAgent"),
-          model: "claude-opus-4-6",
-        };
-
-        const session = yield* adapter.startSession({
-          threadId: THREAD_ID,
-          provider: ProviderDriverKind.make("claudeAgent"),
-          modelSelection,
-          runtimeMode: "full-access",
-        });
-
-        yield* adapter.sendTurn({
-          threadId: session.threadId,
-          input: "hello",
-          modelSelection,
-          attachments: [],
-        });
-        yield* adapter.sendTurn({
-          threadId: session.threadId,
-          input: "hello again",
-          modelSelection,
-          attachments: [],
-        });
-
-        assert.deepEqual(harness.query.setModelCalls, []);
-      }).pipe(
-        Effect.provideService(Random.Random, makeDeterministicRandomService()),
-        Effect.provide(harness.layer),
-      );
-    },
-  );
-
-  it.effect("re-sets the Claude model when the effective API model changes", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      const session = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-
-      yield* adapter.sendTurn({
-        threadId: session.threadId,
-        input: "hello",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("claudeAgent"),
-          "claude-opus-4-6",
-          [{ id: "contextWindow", value: "1m" }],
-        ),
-        attachments: [],
-      });
-      yield* adapter.sendTurn({
-        threadId: session.threadId,
-        input: "hello again",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("claudeAgent"),
-          "claude-opus-4-6",
-          [{ id: "contextWindow", value: "200k" }],
-        ),
-        attachments: [],
-      });
-
-      assert.deepEqual(harness.query.setModelCalls, ["claude-opus-4-6[1m]", "claude-opus-4-6"]);
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("sets plan permission mode on sendTurn when interactionMode is plan", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      const session = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-      yield* adapter.sendTurn({
-        threadId: session.threadId,
-        input: "plan this for me",
-        interactionMode: "plan",
-        attachments: [],
-      });
-
-      assert.deepEqual(harness.query.setPermissionModeCalls, ["plan"]);
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect.each<{ runtimeMode: RuntimeMode; expectedBase: PermissionMode }>([
-    { runtimeMode: "full-access", expectedBase: "bypassPermissions" },
-    { runtimeMode: "approval-required", expectedBase: "default" },
-    { runtimeMode: "auto-accept-edits", expectedBase: "acceptEdits" },
-  ])(
-    "restores $expectedBase permission mode after plan turn ($runtimeMode)",
-    ({ runtimeMode, expectedBase }) => {
-      const harness = makeHarness();
-      return Effect.gen(function* () {
-        const adapter = yield* ClaudeAdapter;
-
-        const session = yield* adapter.startSession({
-          threadId: THREAD_ID,
-          provider: ProviderDriverKind.make("claudeAgent"),
-          runtimeMode,
-        });
-
-        // First turn in plan mode
-        yield* adapter.sendTurn({
-          threadId: session.threadId,
-          input: "plan this",
-          interactionMode: "plan",
-          attachments: [],
-        });
-
-        // Complete the turn so we can send another
-        const turnCompletedFiber = yield* Stream.filter(
-          adapter.streamEvents,
-          (event) => event.type === "turn.completed",
-        ).pipe(Stream.runHead, Effect.forkChild);
-
-        harness.query.emit({
-          type: "result",
-          subtype: "success",
-          is_error: false,
-          errors: [],
-          session_id: `sdk-session-${runtimeMode}`,
-          uuid: `result-${runtimeMode}`,
-        } as unknown as SDKMessage);
-
-        yield* Fiber.join(turnCompletedFiber);
-
-        // Second turn back to default
-        yield* adapter.sendTurn({
-          threadId: session.threadId,
-          input: "now do it",
-          interactionMode: "default",
-          attachments: [],
-        });
-
-        assert.deepEqual(harness.query.setPermissionModeCalls, ["plan", expectedBase]);
-      }).pipe(
-        Effect.provideService(Random.Random, makeDeterministicRandomService()),
-        Effect.provide(harness.layer),
-      );
-    },
-  );
-
-  it.effect("does not call setPermissionMode when interactionMode is absent", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      const session = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-      yield* adapter.sendTurn({
-        threadId: session.threadId,
-        input: "hello",
-        attachments: [],
-      });
-
-      assert.deepEqual(harness.query.setPermissionModeCalls, []);
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("captures ExitPlanMode as a proposed plan and denies auto-exit", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      const session = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-
-      yield* Stream.take(adapter.streamEvents, 3).pipe(Stream.runDrain);
-
-      yield* adapter.sendTurn({
-        threadId: session.threadId,
-        input: "plan this",
-        interactionMode: "plan",
-        attachments: [],
-      });
-      yield* Stream.take(adapter.streamEvents, 1).pipe(Stream.runDrain);
-
-      const createInput = harness.getLastCreateQueryInput();
-      const canUseTool = createInput?.options.canUseTool;
-      assert.equal(typeof canUseTool, "function");
-      if (!canUseTool) {
-        return;
-      }
-
-      const permissionPromise = canUseTool(
-        "ExitPlanMode",
-        {
-          plan: "# Ship it\n\n- one\n- two",
-          allowedPrompts: [{ tool: "Bash", prompt: "run tests" }],
-        },
-        {
-          signal: new AbortController().signal,
-          toolUseID: "tool-exit-1",
-        },
-      );
-
-      const proposedEvent = yield* Stream.runHead(adapter.streamEvents);
-      assert.equal(proposedEvent._tag, "Some");
-      if (proposedEvent._tag !== "Some") {
-        return;
-      }
-      assert.equal(proposedEvent.value.type, "turn.proposed.completed");
-      if (proposedEvent.value.type !== "turn.proposed.completed") {
-        return;
-      }
-      assert.equal(proposedEvent.value.payload.planMarkdown, "# Ship it\n\n- one\n- two");
-      assert.deepEqual(proposedEvent.value.providerRefs, {
-        providerItemId: ProviderItemId.make("tool-exit-1"),
-      });
-
-      const permissionResult = yield* Effect.promise(() => permissionPromise);
-      assert.equal((permissionResult as PermissionResult).behavior, "deny");
-      const deniedResult = permissionResult as PermissionResult & {
-        message?: string;
-      };
-      assert.equal(deniedResult.message?.includes("captured your proposed plan"), true);
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("extracts proposed plans from assistant ExitPlanMode snapshots", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      const session = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-
-      yield* Stream.take(adapter.streamEvents, 3).pipe(Stream.runDrain);
-
-      yield* adapter.sendTurn({
-        threadId: session.threadId,
-        input: "plan this",
-        interactionMode: "plan",
-        attachments: [],
-      });
-      yield* Stream.take(adapter.streamEvents, 1).pipe(Stream.runDrain);
-
-      const proposedEventFiber = yield* Stream.filter(
-        adapter.streamEvents,
-        (event) => event.type === "turn.proposed.completed",
-      ).pipe(Stream.runHead, Effect.forkChild);
-
-      harness.query.emit({
-        type: "assistant",
-        session_id: "sdk-session-exit-plan",
-        uuid: "assistant-exit-plan",
-        parent_tool_use_id: null,
-        message: {
-          model: "claude-opus-4-6",
-          id: "msg-exit-plan",
-          type: "message",
-          role: "assistant",
-          content: [
-            {
-              type: "tool_use",
-              id: "tool-exit-2",
-              name: "ExitPlanMode",
-              input: {
-                plan: "# Final plan\n\n- capture it",
-              },
-            },
-          ],
-          stop_reason: null,
-          stop_sequence: null,
-          usage: {},
-        },
-      } as unknown as SDKMessage);
-
-      const proposedEvent = yield* Fiber.join(proposedEventFiber);
-      assert.equal(proposedEvent._tag, "Some");
-      if (proposedEvent._tag !== "Some") {
-        return;
-      }
-      assert.equal(proposedEvent.value.type, "turn.proposed.completed");
-      if (proposedEvent.value.type !== "turn.proposed.completed") {
-        return;
-      }
-      assert.equal(proposedEvent.value.payload.planMarkdown, "# Final plan\n\n- capture it");
-      assert.deepEqual(proposedEvent.value.providerRefs, {
-        providerItemId: ProviderItemId.make("tool-exit-2"),
-      });
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("routes Claude resume compaction through the shared user-input UI", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-      const session = yield* adapter.startSession({
-        threadId: RESUME_THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        resumeCursor: { resume: "550e8400-e29b-41d4-a716-446655440000" },
-        runtimeMode: "full-access",
-      });
-      yield* Stream.take(adapter.streamEvents, 3).pipe(Stream.runDrain);
-
-      const onUserDialog = harness.getLastCreateQueryInput()?.options.onUserDialog;
-      assert.equal(typeof onUserDialog, "function");
-      if (!onUserDialog) return;
-
-      const dialogPromise = onUserDialog(
-        {
-          dialogKind: "resume_return",
-          payload: { sessionAgeMinutes: 145, estimatedTokens: 275123 },
-        },
-        { signal: new AbortController().signal },
-      );
-
-      const requested = yield* Stream.runHead(adapter.streamEvents);
-      assert.equal(requested._tag, "Some");
-      if (requested._tag !== "Some" || requested.value.type !== "user-input.requested") return;
-      const question = requested.value.payload.questions[0];
-      assert.equal(question?.header, "Resume session");
-      assert.match(question?.question ?? "", /2h 25m/);
-      assert.match(question?.question ?? "", /275,123 tokens/);
-      assert.deepEqual(
-        question?.options.map((option) => option.label),
-        ["Compact and continue", "Keep full history", "Don't ask again"],
-      );
-      if (!question || !requested.value.requestId) return;
-
-      yield* adapter.respondToUserInput(
-        session.threadId,
-        ApprovalRequestId.make(requested.value.requestId),
-        { [question.id]: "Compact and continue" },
-      );
-
-      const resolved = yield* Stream.runHead(adapter.streamEvents);
-      assert.equal(resolved._tag, "Some");
-      if (resolved._tag === "Some") assert.equal(resolved.value.type, "user-input.resolved");
-      assert.deepEqual(yield* Effect.promise(() => dialogPromise), {
-        behavior: "completed",
-        result: "compact",
-      });
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("handles AskUserQuestion via user-input.requested/resolved lifecycle", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      // Start session in approval-required mode so canUseTool fires.
-      const session = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "approval-required",
-      });
-
-      // Drain the session startup events (started, configured, state.changed).
-      yield* Stream.take(adapter.streamEvents, 3).pipe(Stream.runDrain);
-
-      yield* adapter.sendTurn({
-        threadId: session.threadId,
-        input: "question turn",
-        attachments: [],
-      });
-      yield* Stream.take(adapter.streamEvents, 1).pipe(Stream.runDrain);
-
-      harness.query.emit({
-        type: "stream_event",
-        session_id: "sdk-session-user-input-1",
-        uuid: "stream-user-input-thread",
-        parent_tool_use_id: null,
-        event: {
-          type: "message_start",
-          message: {
-            id: "msg-user-input-thread",
-          },
-        },
-      } as unknown as SDKMessage);
-
-      const threadStarted = yield* Stream.runHead(adapter.streamEvents);
-      assert.equal(threadStarted._tag, "Some");
-      if (threadStarted._tag !== "Some" || threadStarted.value.type !== "thread.started") {
-        return;
-      }
-
-      const createInput = harness.getLastCreateQueryInput();
-      const canUseTool = createInput?.options.canUseTool;
-      assert.equal(typeof canUseTool, "function");
-      if (!canUseTool) {
-        return;
-      }
-
-      // Simulate Claude calling AskUserQuestion with structured questions.
-      const askInput = {
-        questions: [
-          {
-            question: "Which framework?",
-            header: "Framework",
-            options: [
-              { label: "React", description: "React.js" },
-              { label: "Vue", description: "Vue.js" },
-            ],
-            multiSelect: false,
-          },
-        ],
-      };
-
-      const permissionPromise = canUseTool("AskUserQuestion", askInput, {
-        signal: new AbortController().signal,
-        toolUseID: "tool-ask-1",
-      });
-
-      // The adapter should emit a user-input.requested event.
-      const requestedEvent = yield* Stream.runHead(adapter.streamEvents);
-      assert.equal(requestedEvent._tag, "Some");
-      if (requestedEvent._tag !== "Some") {
-        return;
-      }
-      assert.equal(requestedEvent.value.type, "user-input.requested");
-      if (requestedEvent.value.type !== "user-input.requested") {
-        return;
-      }
-      const requestId = requestedEvent.value.requestId;
-      assert.equal(typeof requestId, "string");
-      assert.equal(requestedEvent.value.payload.questions.length, 1);
-      assert.equal(requestedEvent.value.payload.questions[0]?.question, "Which framework?");
-      // Regression for #2388: `id` must equal the full question text so the
-      // UI's draft-answer key matches what the SDK looks up downstream.
-      assert.equal(requestedEvent.value.payload.questions[0]?.id, "Which framework?");
-      assert.deepEqual(requestedEvent.value.providerRefs, {
-        providerItemId: ProviderItemId.make("tool-ask-1"),
-      });
-
-      // Respond with the user's answers.
-      yield* adapter.respondToUserInput(session.threadId, ApprovalRequestId.make(requestId!), {
-        "Which framework?": "React",
-      });
-
-      // The adapter should emit a user-input.resolved event.
-      const resolvedEvent = yield* Stream.runHead(adapter.streamEvents);
-      assert.equal(resolvedEvent._tag, "Some");
-      if (resolvedEvent._tag !== "Some") {
-        return;
-      }
-      assert.equal(resolvedEvent.value.type, "user-input.resolved");
-      if (resolvedEvent.value.type !== "user-input.resolved") {
-        return;
-      }
-      assert.deepEqual(resolvedEvent.value.payload.answers, {
-        "Which framework?": "React",
-      });
-      assert.deepEqual(resolvedEvent.value.providerRefs, {
-        providerItemId: ProviderItemId.make("tool-ask-1"),
-      });
-
-      // The canUseTool promise should resolve with the answers in SDK format.
-      const permissionResult = yield* Effect.promise(() => permissionPromise);
-      assert.equal((permissionResult as PermissionResult).behavior, "allow");
-      const updatedInput = (permissionResult as { updatedInput: Record<string, unknown> })
-        .updatedInput;
-      assert.deepEqual(updatedInput.answers, { "Which framework?": "React" });
-      // Original questions should be passed through.
-      assert.deepEqual(updatedInput.questions, askInput.questions);
-
-      // Compatibility check for #2388: the answers shape we hand to the SDK
-      // must produce a non-empty rendered tool_result on BOTH SDK iteration
-      // patterns we have seen, so we don't regress the issue and we don't
-      // break users still on the older Claude CLI.
-      const sdkAnswers = updatedInput.answers as Record<string, unknown>;
-      const sdkQuestions = updatedInput.questions as ReadonlyArray<{
-        readonly question: string;
-      }>;
-
-      // Claude CLI 2.1.119 — key-agnostic Object.entries iteration. Any key
-      // works here, but it must at least round-trip into a non-empty string.
-      const v119Rendered = Object.entries(sdkAnswers)
-        .map(([key, value]) => `"${key}"="${String(value)}"`)
-        .join(", ");
-      assert.equal(v119Rendered, '"Which framework?"="React"');
-
-      // Claude CLI 2.1.121 — lookup by full question text. This is the path
-      // that regressed in #2388 when the answers were keyed by `header`.
-      const v121Rendered = sdkQuestions
-        .map(({ question }) => {
-          const answer = sdkAnswers[question];
-          return answer === undefined ? null : `"${question}"="${String(answer)}"`;
-        })
-        .filter((entry): entry is string => entry !== null)
-        .join(", ");
-      assert.notEqual(v121Rendered, "", "Expected non-empty SDK 2.1.121 tool_result (#2388)");
-      assert.equal(v121Rendered, '"Which framework?"="React"');
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("routes AskUserQuestion through user-input flow even in full-access mode", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      // In full-access mode, regular tools are auto-approved.
-      // AskUserQuestion should still go through the user-input flow.
-      const session = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-
-      yield* Stream.take(adapter.streamEvents, 3).pipe(Stream.runDrain);
-
-      const createInput = harness.getLastCreateQueryInput();
-      const canUseTool = createInput?.options.canUseTool;
-      assert.equal(typeof canUseTool, "function");
-      if (!canUseTool) {
-        return;
-      }
-
-      const askInput = {
-        questions: [
-          {
-            question: "Deploy to which env?",
-            header: "Env",
-            options: [
-              { label: "Staging", description: "Staging environment" },
-              { label: "Production", description: "Production environment" },
-            ],
-            multiSelect: false,
-          },
-        ],
-      };
-
-      const permissionPromise = canUseTool("AskUserQuestion", askInput, {
-        signal: new AbortController().signal,
-        toolUseID: "tool-ask-2",
-      });
-
-      // Should still get user-input.requested even in full-access mode.
-      const requestedEvent = yield* Stream.runHead(adapter.streamEvents);
-      assert.equal(requestedEvent._tag, "Some");
-      if (requestedEvent._tag !== "Some" || requestedEvent.value.type !== "user-input.requested") {
-        assert.fail("Expected user-input.requested event");
-        return;
-      }
-      const requestId = requestedEvent.value.requestId;
-
-      yield* adapter.respondToUserInput(session.threadId, ApprovalRequestId.make(requestId!), {
-        "Deploy to which env?": "Staging",
-      });
-
-      // Drain the resolved event.
-      yield* Stream.runHead(adapter.streamEvents);
-
-      const permissionResult = yield* Effect.promise(() => permissionPromise);
-      assert.equal((permissionResult as PermissionResult).behavior, "allow");
-      const updatedInput = (permissionResult as { updatedInput: Record<string, unknown> })
-        .updatedInput;
-      assert.deepEqual(updatedInput.answers, { "Deploy to which env?": "Staging" });
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("denies AskUserQuestion when the waiting turn is aborted", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      const session = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "approval-required",
-      });
-
-      yield* Stream.take(adapter.streamEvents, 3).pipe(Stream.runDrain);
-
-      const createInput = harness.getLastCreateQueryInput();
-      const canUseTool = createInput?.options.canUseTool;
-      assert.equal(typeof canUseTool, "function");
-      if (!canUseTool) {
-        return;
-      }
-
-      const controller = new AbortController();
-      const permissionPromise = canUseTool(
-        "AskUserQuestion",
-        {
-          questions: [
-            {
-              question: "Continue?",
-              header: "Continue",
-              options: [{ label: "Yes", description: "Proceed" }],
-              multiSelect: false,
-            },
-          ],
-        },
-        {
-          signal: controller.signal,
-          toolUseID: "tool-ask-abort",
-        },
-      );
-
-      const requestedEvent = yield* Stream.runHead(adapter.streamEvents);
-      assert.equal(requestedEvent._tag, "Some");
-      if (requestedEvent._tag !== "Some" || requestedEvent.value.type !== "user-input.requested") {
-        assert.fail("Expected user-input.requested event");
-        return;
-      }
-      assert.equal(requestedEvent.value.threadId, session.threadId);
-
-      controller.abort();
-
-      const resolvedEvent = yield* Stream.runHead(adapter.streamEvents);
-      assert.equal(resolvedEvent._tag, "Some");
-      if (resolvedEvent._tag !== "Some" || resolvedEvent.value.type !== "user-input.resolved") {
-        assert.fail("Expected user-input.resolved event");
-        return;
-      }
-      assert.deepEqual(resolvedEvent.value.payload.answers, {});
-
-      const permissionResult = yield* Effect.promise(() => permissionPromise);
-      assert.deepEqual(permissionResult, {
-        behavior: "deny",
-        message: "User cancelled tool execution.",
-      } satisfies PermissionResult);
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("denies AskUserQuestion when the signal aborted before the listener registered", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "approval-required",
-      });
-
-      yield* Stream.take(adapter.streamEvents, 3).pipe(Stream.runDrain);
-
-      const canUseTool = harness.getLastCreateQueryInput()?.options.canUseTool;
-      assert.equal(typeof canUseTool, "function");
-      if (!canUseTool) {
-        return;
-      }
-
-      const runtimeEventsFiber = yield* Stream.take(adapter.streamEvents, 2).pipe(
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-
-      // Abort before the call so the adapter's listener registration can
-      // never observe the abort event, only the recheck can.
-      const controller = new AbortController();
-      controller.abort();
-      const permissionPromise = canUseTool(
-        "AskUserQuestion",
-        {
-          questions: [
-            {
-              question: "Continue?",
-              header: "Continue",
-              options: [{ label: "Yes", description: "Proceed" }],
-              multiSelect: false,
-            },
-          ],
-        },
-        {
-          signal: controller.signal,
-          toolUseID: "tool-ask-pre-aborted",
-        },
-      );
-
-      const permissionResult = yield* Effect.promise(() => permissionPromise);
-      assert.deepEqual(permissionResult, {
-        behavior: "deny",
-        message: "User cancelled tool execution.",
-      } satisfies PermissionResult);
-
-      const runtimeEvents = Array.from(yield* Fiber.join(runtimeEventsFiber));
-      assert.deepEqual(
-        runtimeEvents.map((event) => event.type),
-        ["user-input.requested", "user-input.resolved"],
-      );
-      const resolvedEvent = runtimeEvents[1];
-      if (resolvedEvent?.type === "user-input.resolved") {
-        assert.deepEqual(resolvedEvent.payload.answers, {});
-      }
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("stopping a session settles pending user-input waits", () => {
-    const harness = makeHarness();
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "approval-required",
-      });
-
-      yield* Stream.take(adapter.streamEvents, 3).pipe(Stream.runDrain);
-
-      const canUseTool = harness.getLastCreateQueryInput()?.options.canUseTool;
-      assert.equal(typeof canUseTool, "function");
-      if (!canUseTool) {
-        return;
-      }
-
-      const permissionPromise = canUseTool(
-        "AskUserQuestion",
-        {
-          questions: [
-            {
-              question: "Continue?",
-              header: "Continue",
-              options: [{ label: "Yes", description: "Proceed" }],
-              multiSelect: false,
-            },
-          ],
-        },
-        { signal: new AbortController().signal, toolUseID: "tool-ask-stop" },
-      );
-
-      const requestedEvent = yield* Stream.runHead(adapter.streamEvents);
-      if (requestedEvent._tag !== "Some" || requestedEvent.value.type !== "user-input.requested") {
-        assert.fail("Expected user-input.requested event");
-        return;
-      }
-
-      // The session dies while the question is still on screen.
-      yield* adapter.stopSession(THREAD_ID);
-
-      const resolvedEvent = yield* Stream.runHead(adapter.streamEvents);
-      if (resolvedEvent._tag !== "Some" || resolvedEvent.value.type !== "user-input.resolved") {
-        assert.fail("Expected user-input.resolved event");
-        return;
-      }
-      assert.deepEqual(resolvedEvent.value.payload.answers, {});
-
-      const permissionResult = yield* Effect.promise(() => permissionPromise);
-      assert.deepEqual(permissionResult, {
-        behavior: "deny",
-        message: "User cancelled tool execution.",
-      } satisfies PermissionResult);
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-
-  it.effect("writes provider-native observability records when enabled", () => {
-    const nativeEvents: Array<{
-      event?: {
-        provider?: string;
-        method?: string;
-        threadId?: string;
-        turnId?: string;
-      };
-    }> = [];
-    const nativeThreadIds: Array<string | null> = [];
-    const harness = makeHarness({
-      nativeEventLogger: {
-        filePath: "memory://claude-native-events",
-        write: (event, threadId) => {
-          nativeEvents.push(event as (typeof nativeEvents)[number]);
-          nativeThreadIds.push(threadId ?? null);
-          return Effect.void;
-        },
-        close: () => Effect.void,
-      },
-    });
-    return Effect.gen(function* () {
-      const adapter = yield* ClaudeAdapter;
-
-      const session = yield* adapter.startSession({
-        threadId: THREAD_ID,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        runtimeMode: "full-access",
-      });
-      const turn = yield* adapter.sendTurn({
-        threadId: session.threadId,
-        input: "hello",
-        attachments: [],
-      });
-
-      const turnCompletedFiber = yield* Stream.filter(
-        adapter.streamEvents,
-        (event) => event.type === "turn.completed",
-      ).pipe(Stream.runHead, Effect.forkChild);
-
-      harness.query.emit({
-        type: "stream_event",
-        session_id: "sdk-session-native-log",
-        uuid: "stream-native-log",
-        parent_tool_use_id: null,
-        event: {
-          type: "content_block_delta",
-          index: 0,
-          delta: {
-            type: "text_delta",
-            text: "hi",
-          },
-        },
-      } as unknown as SDKMessage);
-
-      harness.query.emit({
-        type: "result",
-        subtype: "success",
-        is_error: false,
-        errors: [],
-        session_id: "sdk-session-native-log",
-        uuid: "result-native-log",
-      } as unknown as SDKMessage);
-
-      const turnCompleted = yield* Fiber.join(turnCompletedFiber);
-      assert.equal(turnCompleted._tag, "Some");
-
-      assert.equal(nativeEvents.length > 0, true);
-      assert.equal(
-        nativeEvents.some((record) => record.event?.provider === "claudeAgent"),
-        true,
-      );
-      assert.equal(
-        nativeEvents.some(
-          (record) =>
-            String(
-              (record.event as { readonly providerThreadId?: string } | undefined)
-                ?.providerThreadId,
-            ) === "sdk-session-native-log",
-        ),
-        true,
-      );
-      assert.equal(
-        nativeEvents.some((record) => String(record.event?.turnId) === String(turn.turnId)),
-        true,
-      );
-      assert.equal(
-        nativeEvents.some(
-          (record) => record.event?.method === "claude/stream_event/content_block_delta/text_delta",
-        ),
-        true,
-      );
-      assert.equal(
-        nativeThreadIds.every((threadId) => threadId === String(THREAD_ID)),
-        true,
-      );
-    }).pipe(
-      Effect.provideService(Random.Random, makeDeterministicRandomService()),
-      Effect.provide(harness.layer),
-    );
-  });
-});
diff --git a/apps/server/src/provider/Layers/ClaudeAdapter.ts b/apps/server/src/provider/Layers/ClaudeAdapter.ts
deleted file mode 100644
index 6989378d8287..000000000000
--- a/apps/server/src/provider/Layers/ClaudeAdapter.ts
+++ /dev/null
@@ -1,4735 +0,0 @@
-/**
- * ClaudeAdapterLive - Scoped live implementation for the Claude Agent provider adapter.
- *
- * Wraps `@anthropic-ai/claude-agent-sdk` query sessions behind the generic
- * provider adapter contract and emits canonical runtime events.
- *
- * @module ClaudeAdapterLive
- */
-import {
-  type CanUseTool,
-  query,
-  type Options as ClaudeQueryOptions,
-  type PermissionMode,
-  type PermissionResult,
-  type PermissionUpdate,
-  type SDKMessage,
-  type SDKResultMessage,
-  type SettingSource,
-  type SDKUserMessage,
-  type ModelUsage,
-} from "@anthropic-ai/claude-agent-sdk";
-import { parseCliArgs } from "@t3tools/shared/cliArgs";
-import {
-  ApprovalRequestId,
-  type CanonicalItemType,
-  type CanonicalRequestType,
-  type ClaudeSettings,
-  EventId,
-  type ProviderApprovalDecision,
-  ProviderDriverKind,
-  ProviderInstanceId,
-  type ModelSelection,
-  ProviderItemId,
-  type ProviderRuntimeEvent,
-  type ProviderRuntimeTurnStatus,
-  type ProviderSendTurnInput,
-  type ProviderSession,
-  type ThreadTokenUsageSnapshot,
-  type ProviderUserInputAnswers,
-  type RuntimeContentStreamKind,
-  RuntimeItemId,
-  RuntimeRequestId,
-  RuntimeTaskId,
-  type RuntimeTaskStatus,
-  type RuntimeTaskUsage,
-  type TaskAgentLinkage,
-  type TaskRunHandles,
-  ThreadId,
-  TurnId,
-  type UserInputQuestion,
-} from "@t3tools/contracts";
-import {
-  applyClaudePromptEffortPrefix,
-  getModelSelectionBooleanOptionValue,
-  getModelSelectionStringOptionValue,
-  getProviderOptionDescriptors,
-  resolvePromptInjectedEffort,
-} from "@t3tools/shared/model";
-import {
-  CLAUDE_RESUME_COMPACTION_NEVER_ANSWER,
-  formatClaudeResumeCompactionQuestion,
-} from "@t3tools/shared/claudeCompaction";
-import * as Cause from "effect/Cause";
-import * as Crypto from "effect/Crypto";
-import * as DateTime from "effect/DateTime";
-import * as Deferred from "effect/Deferred";
-import * as Effect from "effect/Effect";
-import * as Exit from "effect/Exit";
-import * as FileSystem from "effect/FileSystem";
-import * as Fiber from "effect/Fiber";
-import * as Path from "effect/Path";
-import * as Queue from "effect/Queue";
-import * as Ref from "effect/Ref";
-import * as Schema from "effect/Schema";
-import * as Stream from "effect/Stream";
-
-import { resolveAttachmentPath } from "../../attachmentStore.ts";
-import { ServerConfig } from "../../config.ts";
-import * as McpProviderSession from "../../mcp/McpProviderSession.ts";
-import { resolveClaudeSdkExecutablePath } from "../Drivers/ClaudeExecutable.ts";
-import { makeClaudeEnvironment } from "../Drivers/ClaudeHome.ts";
-import {
-  getClaudeModelCapabilities,
-  isClaudeUltracodeEffort,
-  normalizeClaudeCliEffort,
-  resolveClaudeApiModelId,
-  resolveClaudeContextWindow,
-  resolveClaudeEffort,
-} from "./ClaudeProvider.ts";
-import {
-  ProviderAdapterProcessError,
-  ProviderAdapterRequestError,
-  ProviderAdapterSessionClosedError,
-  ProviderAdapterSessionNotFoundError,
-  ProviderAdapterValidationError,
-  type ProviderAdapterError,
-} from "../Errors.ts";
-import { type ClaudeAdapterShape } from "../Services/ClaudeAdapter.ts";
-import { type EventNdjsonLogger, makeEventNdjsonLogger } from "./EventNdjsonLogger.ts";
-const encodeUnknownJsonStringExit = Schema.encodeUnknownExit(Schema.fromJsonString(Schema.Unknown));
-const decodeUnknownJsonStringExit = Schema.decodeUnknownExit(Schema.fromJsonString(Schema.Unknown));
-
-const PROVIDER = ProviderDriverKind.make("claudeAgent");
-type ClaudeTextStreamKind = Extract<RuntimeContentStreamKind, "assistant_text" | "reasoning_text">;
-type ClaudeToolResultStreamKind = Extract<
-  RuntimeContentStreamKind,
-  "command_output" | "file_change_output"
->;
-type ClaudeSdkEffort = NonNullable<ClaudeQueryOptions["effort"]>;
-
-function encodeJsonStringForDiagnostics(input: unknown): string | undefined {
-  const result = encodeUnknownJsonStringExit(input);
-  return Exit.isSuccess(result) ? result.value : undefined;
-}
-
-type PromptQueueItem =
-  | {
-      readonly type: "message";
-      readonly message: SDKUserMessage;
-    }
-  | {
-      readonly type: "terminate";
-    };
-
-interface ClaudeResumeState {
-  readonly threadId?: ThreadId;
-  readonly resume?: string;
-  readonly resumeSessionAt?: string;
-  readonly turnCount?: number;
-}
-
-interface ClaudeTurnState {
-  readonly turnId: TurnId;
-  readonly startedAt: string;
-  /**
-   * True for turns auto-started by assistant output arriving without an
-   * active turn (background agent/subagent responses between user prompts).
-   * Synthetic turns are auto-closed by the next sendTurn; real turns are
-   * steered instead (the queued message continues the same turn).
-   */
-  readonly synthetic?: boolean;
-  readonly items: Array<unknown>;
-  readonly assistantTextBlocks: Map<number, AssistantTextBlockState>;
-  readonly assistantTextBlockOrder: Array<AssistantTextBlockState>;
-  readonly capturedProposedPlanKeys: Set<string>;
-  latestAssistantUsage: unknown | undefined;
-  compactedSinceLatestAssistantUsage: boolean;
-  nextSyntheticAssistantBlockIndex: number;
-}
-
-interface AssistantTextBlockState {
-  readonly itemId: string;
-  readonly blockIndex: number;
-  emittedTextDelta: boolean;
-  fallbackText: string;
-  streamClosed: boolean;
-  completionEmitted: boolean;
-}
-
-interface PendingApproval {
-  readonly requestType: CanonicalRequestType;
-  readonly detail?: string;
-  readonly suggestions?: ReadonlyArray<PermissionUpdate>;
-  readonly decision: Deferred.Deferred<ProviderApprovalDecision>;
-}
-
-/**
- * Permission updates applied for an "Always allow this session" decision.
- *
- * Claude Code's suggestions are reused when present but rescoped to
- * `destination: "session"` — echoing them verbatim would persist the
- * session-only choice as a permanent rule (suggestions typically target
- * `localSettings`, i.e. `.claude/settings.local.json`). When Claude Code
- * offers no suggestion — common for MCP tools — fall back to a whole-tool
- * session allow rule so the decision still sticks for the session instead of
- * silently degrading into a one-shot accept.
- */
-function toSessionPermissionUpdates(
-  toolName: string,
-  suggestions: ReadonlyArray<PermissionUpdate> | undefined,
-): Array<PermissionUpdate> {
-  const sessionScoped = (suggestions ?? []).map(
-    (suggestion): PermissionUpdate => ({ ...suggestion, destination: "session" }),
-  );
-  if (sessionScoped.length > 0) {
-    return sessionScoped;
-  }
-  return [
-    {
-      type: "addRules",
-      rules: [{ toolName }],
-      behavior: "allow",
-      destination: "session",
-    },
-  ];
-}
-
-interface PendingUserInput {
-  readonly questions: ReadonlyArray<UserInputQuestion>;
-  readonly answers: Deferred.Deferred<ProviderUserInputAnswers>;
-  /** Unparks the waiting handler as cancelled. Session teardown must run it. */
-  readonly cancel: Effect.Effect<void>;
-}
-
-interface ToolInFlight {
-  readonly itemId: string;
-  readonly itemType: CanonicalItemType;
-  readonly toolName: string;
-  readonly title: string;
-  readonly detail?: string;
-  readonly input: Record<string, unknown>;
-  readonly partialInputJson: string;
-  readonly lastEmittedInputFingerprint?: string;
-  /** Owning agent when this tool ran inside a subagent (see attribution note). */
-  readonly agentId?: string;
-  readonly parentToolUseId?: string;
-}
-
-interface ClaudeTaskState {
-  readonly id: string;
-  subject: string;
-  status: PlanStep["status"];
-  readonly blockedBy: Set<string>;
-}
-
-/**
- * Agent identity captured from task_started and repeated on every subsequent
- * task.* payload, so client folds can reconstruct an agent even when its
- * start row aged out of activity retention.
- */
-interface ClaudeTaskAgentState {
-  readonly taskId: string;
-  toolUseId: string | undefined;
-  description: string | undefined;
-  subagentType: string | undefined;
-  taskType: string | undefined;
-  workflowName: string | undefined;
-  skipTranscript: boolean;
-  runHandles: TaskRunHandles | undefined;
-  /** Set when this task was launched from inside a subagent. */
-  owningAgentId: string | undefined;
-  /** Seeded from the launching tool's input; refined by the subagent's own
-   * assistant snapshots (authoritative API model). */
-  model: string | undefined;
-  effort: string | undefined;
-}
-
-/**
- * How many racing snapshot models to buffer per session. A snapshot whose
- * task_started never arrives would otherwise pin its entry for the session's
- * lifetime; oldest entries evict first.
- */
-const PENDING_TASK_MODEL_CAP = 64;
-
-/**
- * Buffers a subagent snapshot's authoritative model under its
- * parent_tool_use_id, for snapshots that beat their task_started to the
- * stream. task_started consumes the entry when it registers the task.
- */
-function rememberPendingTaskModel(
-  pending: Map<string, string>,
-  parentToolUseId: string,
-  model: string,
-): void {
-  pending.set(parentToolUseId, model);
-  if (pending.size > PENDING_TASK_MODEL_CAP) {
-    const oldest = pending.keys().next();
-    if (!oldest.done) {
-      pending.delete(oldest.value);
-    }
-  }
-}
-
-interface ClaudeSessionContext {
-  session: ProviderSession;
-  readonly promptQueue: Queue.Queue<PromptQueueItem>;
-  readonly query: ClaudeQueryRuntime;
-  streamFiber: Fiber.Fiber<void, Error> | undefined;
-  readonly startedAt: string;
-  readonly basePermissionMode: PermissionMode | undefined;
-  currentApiModelId: string | undefined;
-  /** Effective effort for the session's turns; subagents without an explicit
-   * effort override inherit this. */
-  currentEffort: string | undefined;
-  resumeSessionId: string | undefined;
-  readonly pendingApprovals: Map<ApprovalRequestId, PendingApproval>;
-  readonly pendingUserInputs: Map<ApprovalRequestId, PendingUserInput>;
-  readonly turns: Array<{
-    id: TurnId;
-    items: Array<unknown>;
-  }>;
-  readonly inFlightTools: Map<number, ToolInFlight>;
-  readonly claudeTasks: Map<string, ClaudeTaskState>;
-  readonly taskAgents: Map<string, ClaudeTaskAgentState>;
-  /**
-   * Authoritative subagent models from assistant snapshots that arrived before
-   * their task_started registered the task, keyed by parent_tool_use_id.
-   * Written through `rememberPendingTaskModel`, consumed by task_started.
-   */
-  readonly pendingTaskModels: Map<string, string>;
-  /**
-   * Last emitted workflow-member fingerprint per member slot. A coordinator
-   * task_progress repeats the FULL member array every tick; without a
-   * material-transition filter one provider tick fans out into up to 100
-   * runtime events (event-log writes, queue pressure, client reducer work)
-   * even when nothing changed for most members.
-   */
-  readonly workflowMemberFingerprints: Map<string, string>;
-  /** Task ids that have started and not yet reached a terminal state. */
-  readonly liveTaskIds: Set<string>;
-  turnState: ClaudeTurnState | undefined;
-  lastKnownContextWindow: number | undefined;
-  lastKnownTokenUsage: ThreadTokenUsageSnapshot | undefined;
-  lastKnownTotalProcessedTokens: number | undefined;
-  lastAssistantUuid: string | undefined;
-  lastThreadStartedId: string | undefined;
-  stopped: boolean;
-}
-
-interface ClaudeQueryRuntime extends AsyncIterable<SDKMessage> {
-  readonly setModel: (model?: string) => Promise<void>;
-  readonly setPermissionMode: (mode: PermissionMode) => Promise<void>;
-  readonly setMaxThinkingTokens: (maxThinkingTokens: number | null) => Promise<void>;
-  readonly close: () => void;
-}
-
-export interface ClaudeAdapterLiveOptions {
-  readonly instanceId?: ProviderInstanceId;
-  readonly environment?: NodeJS.ProcessEnv;
-  readonly createQuery?: (input: {
-    readonly prompt: AsyncIterable<SDKUserMessage>;
-    readonly options: ClaudeQueryOptions;
-  }) => ClaudeQueryRuntime;
-  readonly nativeEventLogPath?: string;
-  readonly nativeEventLogger?: EventNdjsonLogger;
-}
-
-function isUuid(value: string): boolean {
-  return /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(value);
-}
-
-function isSyntheticClaudeThreadId(value: string): boolean {
-  return value.startsWith("claude-thread-");
-}
-
-function hasDurableClaudeSessionId(message: SDKMessage): boolean {
-  if (message.type !== "system") {
-    return true;
-  }
-
-  return (
-    message.subtype !== "hook_started" &&
-    message.subtype !== "hook_progress" &&
-    message.subtype !== "hook_response"
-  );
-}
-
-function toMessage(cause: unknown, fallback: string): string {
-  if (cause instanceof Error && cause.message.length > 0) {
-    return cause.message;
-  }
-  return fallback;
-}
-
-function normalizeClaudeStreamMessages(
-  cause: Cause.Cause<ProviderAdapterProcessError>,
-): ReadonlyArray<string> {
-  const errors: Array<string> = [];
-  for (const error of Cause.prettyErrors(cause)) {
-    const message = error.message.trim();
-    if (message.length > 0) {
-      errors.push(message);
-    }
-  }
-  if (errors.length > 0) {
-    return errors;
-  }
-
-  const squashed = toMessage(Cause.squash(cause), "").trim();
-  return squashed.length > 0 ? [squashed] : [];
-}
-
-function getEffectiveClaudeAgentEffort(
-  effort: string | null | undefined,
-  model: string | null | undefined,
-): ClaudeSdkEffort | null {
-  const normalized = normalizeClaudeCliEffort(effort, model);
-  return normalized ? (normalized as ClaudeSdkEffort) : null;
-}
-
-function isClaudeInterruptedMessage(message: string): boolean {
-  const normalized = message.toLowerCase();
-  return (
-    normalized.includes("all fibers interrupted without error") ||
-    normalized.includes("request was aborted") ||
-    normalized.includes("interrupted by user")
-  );
-}
-
-function isClaudeInterruptedCause(cause: Cause.Cause<ProviderAdapterProcessError>): boolean {
-  return (
-    Cause.hasInterruptsOnly(cause) ||
-    normalizeClaudeStreamMessages(cause).some(isClaudeInterruptedMessage) ||
-    cause.reasons.some(
-      (reason) =>
-        Cause.isFailReason(reason) && isClaudeInterruptedMessage(toMessage(reason.error.cause, "")),
-    )
-  );
-}
-
-function resultErrorsText(result: SDKResultMessage): string {
-  return "errors" in result && Array.isArray(result.errors)
-    ? result.errors.join(" ").toLowerCase()
-    : "";
-}
-
-/**
- * First user-facing error from a non-success result. "[ede_diagnostic] ..."
- * entries are CLI-internal telemetry (the CLI hides them from its own UI too),
- * so they must never become the error banner.
- */
-function resultUserFacingError(result: SDKResultMessage): string | undefined {
-  if (result.subtype === "success" || !Array.isArray(result.errors)) {
-    return undefined;
-  }
-  return result.errors.find((error) => !error.startsWith("[ede_diagnostic]"));
-}
-
-function isInterruptedResult(result: SDKResultMessage): boolean {
-  // The CLI stamps user aborts explicitly: interrupting mid-tool-call yields
-  // "aborted_tools" (with an internal "[ede_diagnostic] ..." error and
-  // is_error: true), interrupting mid-stream yields "aborted_streaming".
-  if (
-    result.terminal_reason === "aborted_tools" ||
-    result.terminal_reason === "aborted_streaming"
-  ) {
-    return true;
-  }
-
-  const errors = resultErrorsText(result);
-  if (errors.includes("interrupt")) {
-    return true;
-  }
-
-  return (
-    result.subtype === "error_during_execution" &&
-    result.is_error === false &&
-    (errors.includes("request was aborted") ||
-      errors.includes("interrupted by user") ||
-      errors.includes("aborted"))
-  );
-}
-
-function asRuntimeItemId(value: string): RuntimeItemId {
-  return RuntimeItemId.make(value);
-}
-
-function maxClaudeContextWindowFromModelUsage(
-  modelUsage: Record<string, ModelUsage> | undefined,
-): number | undefined {
-  if (!modelUsage) return undefined;
-
-  let maxContextWindow: number | undefined;
-  for (const value of Object.values(modelUsage)) {
-    const contextWindow = value.contextWindow;
-    maxContextWindow = Math.max(maxContextWindow ?? 0, contextWindow);
-  }
-
-  return maxContextWindow;
-}
-
-function selectedClaudeContextWindow(
-  modelSelection: ModelSelection | undefined,
-): number | undefined {
-  switch (modelSelection?.model) {
-    case "claude-opus-4-8":
-    case "claude-opus-4-7":
-      // Always 1M at the API; these models expose no contextWindow option.
-      return 1_000_000;
-  }
-
-  switch (resolveClaudeContextWindow(modelSelection)) {
-    case "1m":
-      return 1_000_000;
-    case "200k":
-      return 200_000;
-    default:
-      return undefined;
-  }
-}
-
-function finiteNonNegativeInteger(value: unknown): number | undefined {
-  return typeof value === "number" && Number.isFinite(value) && value >= 0
-    ? Math.round(value)
-    : undefined;
-}
-
-function finitePositiveInteger(value: unknown): number | undefined {
-  return typeof value === "number" && Number.isFinite(value) && value > 0
-    ? Math.round(value)
-    : undefined;
-}
-
-function claudeUsageInputTokens(usage: Record<string, unknown>): number {
-  return (
-    (finiteNonNegativeInteger(usage.input_tokens) ?? 0) +
-    (finiteNonNegativeInteger(usage.cache_creation_input_tokens) ?? 0) +
-    (finiteNonNegativeInteger(usage.cache_read_input_tokens) ?? 0)
-  );
-}
-
-function claudeUsageOutputTokens(usage: Record<string, unknown>): number {
-  return finiteNonNegativeInteger(usage.output_tokens) ?? 0;
-}
-
-function lastClaudeUsageIteration(
-  value: Record<string, unknown>,
-): Record<string, unknown> | undefined {
-  const iterations = Array.isArray(value.iterations) ? value.iterations : [];
-  return iterations.findLast(
-    (iteration): iteration is Record<string, unknown> =>
-      iteration !== null && typeof iteration === "object" && !Array.isArray(iteration),
-  );
-}
-
-function claudeTotalProcessedTokens(value: unknown): number | undefined {
-  if (!value || typeof value !== "object" || Array.isArray(value)) {
-    return undefined;
-  }
-
-  const usage = value as Record<string, unknown>;
-  const explicitTotal = finiteNonNegativeInteger(usage.total_tokens);
-  if (explicitTotal !== undefined && explicitTotal > 0) {
-    return explicitTotal;
-  }
-
-  const total = claudeUsageInputTokens(usage) + claudeUsageOutputTokens(usage);
-  return total > 0 ? total : undefined;
-}
-
-function makeClaudeTokenUsageSnapshot(input: {
-  readonly activeTokens: number;
-  readonly inputTokens?: number;
-  readonly outputTokens?: number;
-  readonly contextWindow?: number;
-  readonly totalProcessedTokens?: number;
-  readonly lastUsedTokens?: number;
-  readonly compactsAutomatically?: boolean;
-  readonly autoCompactThreshold?: number;
-}): ThreadTokenUsageSnapshot | undefined {
-  const activeTokens = finiteNonNegativeInteger(input.activeTokens);
-  if (activeTokens === undefined || activeTokens <= 0) {
-    return undefined;
-  }
-
-  const maxTokens = finitePositiveInteger(input.contextWindow);
-  const usedTokens = maxTokens !== undefined ? Math.min(activeTokens, maxTokens) : activeTokens;
-  const lastUsedTokens =
-    finiteNonNegativeInteger(input.lastUsedTokens) ??
-    (maxTokens !== undefined ? Math.min(activeTokens, maxTokens) : activeTokens);
-  const totalProcessedTokens = finiteNonNegativeInteger(input.totalProcessedTokens);
-  const inputTokens = finiteNonNegativeInteger(input.inputTokens);
-  const outputTokens = finiteNonNegativeInteger(input.outputTokens);
-
-  return {
-    usedTokens,
-    lastUsedTokens,
-    ...(totalProcessedTokens !== undefined && totalProcessedTokens > usedTokens
-      ? { totalProcessedTokens }
-      : {}),
-    ...(inputTokens !== undefined && inputTokens > 0 ? { inputTokens } : {}),
-    ...(outputTokens !== undefined && outputTokens > 0 ? { outputTokens } : {}),
-    ...(maxTokens !== undefined ? { maxTokens } : {}),
-    ...(input.compactsAutomatically !== undefined
-      ? { compactsAutomatically: input.compactsAutomatically }
-      : {}),
-    ...(input.autoCompactThreshold !== undefined
-      ? { autoCompactThreshold: input.autoCompactThreshold }
-      : {}),
-  };
-}
-
-function normalizeClaudeActiveTokenUsage(
-  value: unknown,
-  contextWindow?: number,
-  totalProcessedTokens?: number,
-): ThreadTokenUsageSnapshot | undefined {
-  if (!value || typeof value !== "object") {
-    return undefined;
-  }
-
-  const usage = value as Record<string, unknown>;
-  const activeUsage = lastClaudeUsageIteration(usage) ?? usage;
-  const inputTokens = claudeUsageInputTokens(activeUsage);
-  const outputTokens = claudeUsageOutputTokens(activeUsage);
-  const activeTokens = claudeTotalProcessedTokens(activeUsage) ?? inputTokens + outputTokens;
-  if (activeTokens <= 0) {
-    return undefined;
-  }
-
-  return makeClaudeTokenUsageSnapshot({
-    activeTokens,
-    inputTokens,
-    outputTokens,
-    ...(contextWindow !== undefined ? { contextWindow } : {}),
-    ...(totalProcessedTokens !== undefined ? { totalProcessedTokens } : {}),
-  });
-}
-
-function compactBoundaryTokenUsageSnapshot(
-  message: Record<string, unknown>,
-  contextWindow?: number,
-  totalProcessedTokens?: number,
-): ThreadTokenUsageSnapshot | undefined {
-  const metadata = message.compact_metadata;
-  if (!metadata || typeof metadata !== "object" || Array.isArray(metadata)) {
-    return undefined;
-  }
-
-  const compactMetadata = metadata as Record<string, unknown>;
-  const postTokens = finiteNonNegativeInteger(compactMetadata.post_tokens);
-  if (postTokens === undefined || postTokens <= 0) {
-    return undefined;
-  }
-
-  const preTokens = finiteNonNegativeInteger(compactMetadata.pre_tokens);
-  return makeClaudeTokenUsageSnapshot({
-    activeTokens: postTokens,
-    ...(preTokens !== undefined ? { lastUsedTokens: preTokens } : {}),
-    ...(contextWindow !== undefined ? { contextWindow } : {}),
-    ...(totalProcessedTokens !== undefined ? { totalProcessedTokens } : {}),
-  });
-}
-
-function normalizeClaudeTaskProgressTokenUsage(
-  value: unknown,
-  context: ClaudeSessionContext,
-): ThreadTokenUsageSnapshot | undefined {
-  const totalTokens = claudeTotalProcessedTokens(value);
-  if (totalTokens === undefined || totalTokens <= 0) {
-    return undefined;
-  }
-
-  const lastUsedTokens = context.lastKnownTokenUsage?.usedTokens;
-  const activeTokens =
-    lastUsedTokens !== undefined ? Math.max(totalTokens, lastUsedTokens) : totalTokens;
-  if (lastUsedTokens !== undefined && activeTokens === lastUsedTokens) {
-    return undefined;
-  }
-
-  const usage = value as Record<string, unknown>;
-  const snapshot = makeClaudeTokenUsageSnapshot({
-    activeTokens,
-    ...(context.lastKnownContextWindow !== undefined
-      ? { contextWindow: context.lastKnownContextWindow }
-      : {}),
-    totalProcessedTokens: Math.max(
-      totalTokens,
-      context.lastKnownTotalProcessedTokens ?? totalTokens,
-    ),
-  });
-  if (!snapshot) {
-    return undefined;
-  }
-
-  const toolUses = finiteNonNegativeInteger(usage.tool_uses);
-  const durationMs = finiteNonNegativeInteger(usage.duration_ms);
-  return {
-    ...snapshot,
-    ...(toolUses !== undefined ? { toolUses } : {}),
-    ...(durationMs !== undefined ? { durationMs } : {}),
-  };
-}
-
-function asCanonicalTurnId(value: TurnId): TurnId {
-  return value;
-}
-
-function asRuntimeRequestId(value: ApprovalRequestId): RuntimeRequestId {
-  return RuntimeRequestId.make(value);
-}
-
-function readClaudeResumeState(resumeCursor: unknown): ClaudeResumeState | undefined {
-  if (!resumeCursor || typeof resumeCursor !== "object") {
-    return undefined;
-  }
-  const cursor = resumeCursor as {
-    threadId?: unknown;
-    resume?: unknown;
-    sessionId?: unknown;
-    resumeSessionAt?: unknown;
-    turnCount?: unknown;
-  };
-
-  const threadIdCandidate = typeof cursor.threadId === "string" ? cursor.threadId : undefined;
-  const threadId =
-    threadIdCandidate && !isSyntheticClaudeThreadId(threadIdCandidate)
-      ? ThreadId.make(threadIdCandidate)
-      : undefined;
-  const resumeCandidate =
-    typeof cursor.resume === "string"
-      ? cursor.resume
-      : typeof cursor.sessionId === "string"
-        ? cursor.sessionId
-        : undefined;
-  const resume = resumeCandidate && isUuid(resumeCandidate) ? resumeCandidate : undefined;
-  const resumeSessionAt =
-    typeof cursor.resumeSessionAt === "string" ? cursor.resumeSessionAt : undefined;
-  const turnCountValue = typeof cursor.turnCount === "number" ? cursor.turnCount : undefined;
-
-  return {
-    ...(threadId ? { threadId } : {}),
-    ...(resume ? { resume } : {}),
-    ...(resumeSessionAt ? { resumeSessionAt } : {}),
-    ...(turnCountValue !== undefined && Number.isInteger(turnCountValue) && turnCountValue >= 0
-      ? { turnCount: turnCountValue }
-      : {}),
-  };
-}
-
-function classifyToolItemType(toolName: string): CanonicalItemType {
-  const normalized = toolName.toLowerCase();
-  if (normalized.includes("agent")) {
-    return "collab_agent_tool_call";
-  }
-  if (
-    normalized === "task" ||
-    normalized === "agent" ||
-    normalized.includes("subagent") ||
-    normalized.includes("sub-agent")
-  ) {
-    return "collab_agent_tool_call";
-  }
-  if (
-    normalized.includes("bash") ||
-    normalized.includes("command") ||
-    normalized.includes("shell") ||
-    normalized.includes("terminal")
-  ) {
-    return "command_execution";
-  }
-  if (
-    normalized.includes("edit") ||
-    normalized.includes("write") ||
-    normalized.includes("file") ||
-    normalized.includes("patch") ||
-    normalized.includes("replace") ||
-    normalized.includes("create") ||
-    normalized.includes("delete")
-  ) {
-    return "file_change";
-  }
-  if (normalized.includes("mcp")) {
-    return "mcp_tool_call";
-  }
-  if (normalized.includes("websearch") || normalized.includes("web search")) {
-    return "web_search";
-  }
-  if (normalized.includes("image")) {
-    return "image_view";
-  }
-  return "dynamic_tool_call";
-}
-
-function isReadOnlyToolName(toolName: string): boolean {
-  const normalized = toolName.toLowerCase();
-  return (
-    normalized === "read" ||
-    normalized.includes("read file") ||
-    normalized.includes("view") ||
-    normalized.includes("grep") ||
-    normalized.includes("glob") ||
-    normalized.includes("search")
-  );
-}
-
-function classifyRequestType(toolName: string): CanonicalRequestType {
-  if (isReadOnlyToolName(toolName)) {
-    return "file_read_approval";
-  }
-  const itemType = classifyToolItemType(toolName);
-  return itemType === "command_execution"
-    ? "command_execution_approval"
-    : itemType === "file_change"
-      ? "file_change_approval"
-      : "dynamic_tool_call";
-}
-
-function isTodoTool(toolName: string): boolean {
-  return toolName.toLowerCase().includes("todowrite");
-}
-
-type PlanStep = {
-  step: string;
-  status: "pending" | "inProgress" | "completed";
-};
-
-function extractPlanStepsFromTodoInput(input: Record<string, unknown>): PlanStep[] | null {
-  // TodoWrite format: { todos: [{ content, status, activeForm? }] }
-  const todos = input.todos;
-  if (!Array.isArray(todos) || todos.length === 0) {
-    return null;
-  }
-  return todos
-    .filter((t): t is Record<string, unknown> => t !== null && typeof t === "object")
-    .map((todo) => ({
-      step:
-        typeof todo.content === "string" && todo.content.trim().length > 0
-          ? todo.content.trim()
-          : "Task",
-      status:
-        todo.status === "completed"
-          ? "completed"
-          : todo.status === "in_progress"
-            ? "inProgress"
-            : "pending",
-    }));
-}
-
-function isClaudeTaskTool(toolName: string): boolean {
-  return toolName === "TaskCreate" || toolName === "TaskUpdate" || toolName === "TaskList";
-}
-
-function normalizeClaudeTaskStatus(value: unknown): PlanStep["status"] {
-  return value === "completed" ? "completed" : value === "in_progress" ? "inProgress" : "pending";
-}
-
-function readString(value: unknown): string | undefined {
-  return typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
-}
-
-function readStringArray(value: unknown): Array<string> {
-  return Array.isArray(value)
-    ? value.filter((entry): entry is string => typeof entry === "string" && entry.length > 0)
-    : [];
-}
-
-function readClaudeToolUseResult(message: SDKMessage): Record<string, unknown> | undefined {
-  if (message.type !== "user") {
-    return undefined;
-  }
-  const result = (message as { readonly tool_use_result?: unknown }).tool_use_result;
-  return result !== null && typeof result === "object" && !Array.isArray(result)
-    ? (result as Record<string, unknown>)
-    : undefined;
-}
-
-function readClaudeTaskFromResult(
-  result: Record<string, unknown> | undefined,
-): Record<string, unknown> | undefined {
-  const task = result?.task;
-  return task !== null && typeof task === "object" && !Array.isArray(task)
-    ? (task as Record<string, unknown>)
-    : undefined;
-}
-
-function applyClaudeTaskToolResult(
-  tasks: Map<string, ClaudeTaskState>,
-  tool: ToolInFlight,
-  result: Record<string, unknown> | undefined,
-): boolean {
-  if (!isClaudeTaskTool(tool.toolName)) {
-    return false;
-  }
-
-  let changed = false;
-  if (tool.toolName === "TaskList") {
-    const resultTasks = result?.tasks;
-    if (!Array.isArray(resultTasks)) {
-      return false;
-    }
-    tasks.clear();
-    for (const entry of resultTasks) {
-      if (entry === null || typeof entry !== "object" || Array.isArray(entry)) {
-        continue;
-      }
-      const task = entry as Record<string, unknown>;
-      const id = readString(task.id);
-      const subject = readString(task.subject);
-      if (!id || !subject) {
-        continue;
-      }
-      tasks.set(id, {
-        id,
-        subject,
-        status: normalizeClaudeTaskStatus(task.status),
-        blockedBy: new Set(readStringArray(task.blockedBy)),
-      });
-    }
-    return tasks.size > 0;
-  }
-
-  if (tool.toolName === "TaskCreate") {
-    const resultTask = readClaudeTaskFromResult(result);
-    const id = readString(resultTask?.id);
-    const subject = readString(resultTask?.subject) ?? readString(tool.input.subject);
-    if (!id || !subject) {
-      return false;
-    }
-    tasks.set(id, {
-      id,
-      subject,
-      status: normalizeClaudeTaskStatus(tool.input.status),
-      blockedBy: new Set(readStringArray(tool.input.blockedBy)),
-    });
-    return true;
-  }
-
-  const taskId = readString(tool.input.taskId) ?? readString(result?.taskId);
-  if (!taskId) {
-    return false;
-  }
-  const task = tasks.get(taskId);
-  if (!task) {
-    return false;
-  }
-  const subject = readString(tool.input.subject);
-  if (subject && task.subject !== subject) {
-    task.subject = subject;
-    changed = true;
-  }
-  if (typeof tool.input.status === "string") {
-    const status = normalizeClaudeTaskStatus(tool.input.status);
-    if (task.status !== status) {
-      task.status = status;
-      changed = true;
-    }
-  }
-  for (const dependency of readStringArray(tool.input.addBlockedBy)) {
-    if (!task.blockedBy.has(dependency)) {
-      task.blockedBy.add(dependency);
-      changed = true;
-    }
-  }
-  for (const dependency of readStringArray(tool.input.removeBlockedBy)) {
-    if (task.blockedBy.delete(dependency)) {
-      changed = true;
-    }
-  }
-  return changed;
-}
-
-function planStepsFromClaudeTasks(tasks: Map<string, ClaudeTaskState>): PlanStep[] {
-  return Array.from(tasks.values()).map((task) => {
-    const blockedBy = Array.from(task.blockedBy);
-    const blockedSuffix = blockedBy.length > 0 ? ` (blocked by #${blockedBy.join(", #")})` : "";
-    return {
-      step: `${task.subject}${blockedSuffix}`,
-      status: task.status,
-    };
-  });
-}
-
-/** Only http/https survive; anything else (javascript:, file:, …) is dropped. */
-function sanitizeSessionUrl(value: unknown): string | undefined {
-  if (typeof value !== "string") {
-    return undefined;
-  }
-  const trimmed = value.trim();
-  if (!/^https?:\/\//i.test(trimmed)) {
-    return undefined;
-  }
-  return trimmed;
-}
-
-function nonNegativeInt(value: unknown): number | undefined {
-  return typeof value === "number" && Number.isFinite(value) && value >= 0
-    ? Math.floor(value)
-    : undefined;
-}
-
-function trimmedString(value: unknown): string | undefined {
-  if (typeof value !== "string") {
-    return undefined;
-  }
-  const trimmed = value.trim();
-  return trimmed.length > 0 ? trimmed : undefined;
-}
-
-/**
- * SDK task usage ({total_tokens, tool_uses, duration_ms}, sometimes with
- * input/output/cache breakdowns) → the typed contract shape. Unknown or
- * malformed input yields undefined rather than a partial guess.
- */
-function normalizeTaskUsage(usage: unknown): RuntimeTaskUsage | undefined {
-  if (typeof usage !== "object" || usage === null) {
-    return undefined;
-  }
-  const record = usage as Record<string, unknown>;
-  const totalTokens = nonNegativeInt(record.total_tokens);
-  if (totalTokens === undefined) {
-    return undefined;
-  }
-  const inputTokens = nonNegativeInt(record.input_tokens);
-  const cachedInputTokens = nonNegativeInt(record.cache_read_input_tokens);
-  const outputTokens = nonNegativeInt(record.output_tokens);
-  const toolUses = nonNegativeInt(record.tool_uses);
-  const durationMs = nonNegativeInt(record.duration_ms);
-  return {
-    totalTokens,
-    ...(inputTokens !== undefined ? { inputTokens } : {}),
-    ...(cachedInputTokens !== undefined ? { cachedInputTokens } : {}),
-    ...(outputTokens !== undefined ? { outputTokens } : {}),
-    ...(toolUses !== undefined ? { toolUses } : {}),
-    ...(durationMs !== undefined ? { durationMs } : {}),
-  };
-}
-
-/** SDK task_updated patch status → the shared wire vocabulary. */
-const CLAUDE_TASK_PATCH_STATUS: Record<string, RuntimeTaskStatus> = {
-  pending: "pending",
-  running: "running",
-  completed: "completed",
-  failed: "failed",
-  killed: "cancelled",
-  paused: "idle",
-};
-
-/**
- * Resolves a stream message's parent_tool_use_id to the owning agent's
- * taskId. The Task tool's tool_use_id is remembered on task_started; any
- * subagent-forwarded block carries that id as its parent. Returns undefined
- * for parent-conversation traffic.
- */
-function agentIdForParentToolUse(
-  agents: Map<string, ClaudeTaskAgentState>,
-  parentToolUseId: string | null | undefined,
-): string | undefined {
-  if (parentToolUseId === null || parentToolUseId === undefined) {
-    return undefined;
-  }
-  for (const agent of agents.values()) {
-    if (agent.toolUseId === parentToolUseId) {
-      return agent.taskId;
-    }
-  }
-  return undefined;
-}
-
-/**
- * Linkage bundle repeated on every task.* payload for `taskId`. Reads the
- * remembered identity (from task_started) so progress/terminal rows are
- * self-describing even when the start row ages out of activity retention.
- */
-function taskLinkageFor(
-  agents: Map<string, ClaudeTaskAgentState>,
-  taskId: string,
-): TaskAgentLinkage {
-  const agent = agents.get(taskId);
-  if (!agent) {
-    return {};
-  }
-  return {
-    ...(agent.taskType ? { taskType: agent.taskType } : {}),
-    ...(agent.owningAgentId ? { agentId: agent.owningAgentId } : {}),
-    ...(agent.description ? { title: agent.description } : {}),
-    ...(agent.subagentType ? { role: agent.subagentType } : {}),
-    ...(agent.model ? { model: agent.model } : {}),
-    ...(agent.effort ? { effort: agent.effort } : {}),
-    ...(agent.toolUseId ? { toolUseId: agent.toolUseId } : {}),
-    ...(agent.workflowName ? { workflowName: agent.workflowName } : {}),
-    ...(agent.runHandles ? { runHandles: agent.runHandles } : {}),
-  };
-}
-
-const WORKFLOW_PHASE_CAP = 64;
-const WORKFLOW_AGENT_CAP = 100;
-
-interface ClaudeWorkflowAgentEntry {
-  readonly index: number;
-  readonly state: string;
-  readonly label: string | undefined;
-  readonly phaseIndex: number | undefined;
-  readonly phaseTitle: string | undefined;
-  readonly model: string | undefined;
-  readonly attempt: number | undefined;
-  readonly lastToolName: string | undefined;
-  readonly startedAt: string | undefined;
-  readonly error: string | undefined;
-  readonly tokens: number | undefined;
-  readonly toolCalls: number | undefined;
-}
-
-interface ClaudeWorkflowProgress {
-  readonly phases: ReadonlyArray<{ index: number; title: string }>;
-  readonly agents: ReadonlyArray<ClaudeWorkflowAgentEntry>;
-}
-
-/**
- * Defensive parse of the SDK's undeclared-but-real workflow_progress array on
- * task_progress messages (wire-confirmed; absent from sdk.d.ts). Unknown
- * shapes are skipped per-entry; phases and agents dedupe by index before
- * caps; a vanished field never throws. If the array disappears upstream the
- * caller keeps the coordinator row and plain task lifecycle.
- */
-function parseWorkflowProgress(value: unknown): ClaudeWorkflowProgress | undefined {
-  if (!Array.isArray(value) || value.length === 0) {
-    return undefined;
-  }
-  const phasesByIndex = new Map<number, string>();
-  const agentsByIndex = new Map<number, ClaudeWorkflowAgentEntry>();
-  for (const entry of value) {
-    if (typeof entry !== "object" || entry === null) {
-      continue;
-    }
-    const record = entry as Record<string, unknown>;
-    const entryType = trimmedString(record.type);
-    if (entryType === "workflow_phase") {
-      const index = nonNegativeInt(record.index);
-      const title = trimmedString(record.title);
-      if (index !== undefined && title && !phasesByIndex.has(index)) {
-        phasesByIndex.set(index, title);
-      }
-      continue;
-    }
-    if (entryType !== "workflow_agent") {
-      continue;
-    }
-    const index = nonNegativeInt(record.index);
-    const state = trimmedString(record.state);
-    if (index === undefined || !state || agentsByIndex.has(index)) {
-      continue;
-    }
-    agentsByIndex.set(index, {
-      index,
-      state,
-      label: trimmedString(record.label),
-      phaseIndex: nonNegativeInt(record.phaseIndex),
-      phaseTitle: trimmedString(record.phaseTitle),
-      model: trimmedString(record.model),
-      attempt: nonNegativeInt(record.attempt),
-      lastToolName: trimmedString(record.lastToolName),
-      startedAt: trimmedString(record.startedAt),
-      error: trimmedString(record.error),
-      tokens: nonNegativeInt(record.tokens),
-      toolCalls: nonNegativeInt(record.toolCalls),
-    });
-  }
-  if (phasesByIndex.size === 0 && agentsByIndex.size === 0) {
-    return undefined;
-  }
-  const phases = Array.from(phasesByIndex.entries())
-    .map(([index, title]) => ({ index, title }))
-    .toSorted((a, b) => a.index - b.index)
-    .slice(0, WORKFLOW_PHASE_CAP);
-  const agents = Array.from(agentsByIndex.values())
-    .toSorted((a, b) => a.index - b.index)
-    .slice(0, WORKFLOW_AGENT_CAP);
-  return { phases, agents };
-}
-
-/**
- * Workflow member states from workflow_progress → shared task status.
- * Unknown states read running after startedAt, pending before it.
- */
-function workflowAgentStatus(entry: ClaudeWorkflowAgentEntry): RuntimeTaskStatus {
-  switch (entry.state) {
-    case "queued":
-    case "pending":
-      return "pending";
-    case "start":
-    case "running":
-      return entry.startedAt === undefined ? "pending" : "running";
-    case "done":
-      return "completed";
-    case "error":
-      return "failed";
-    default:
-      return entry.startedAt === undefined ? "pending" : "running";
-  }
-}
-
-function summarizeToolRequest(toolName: string, input: Record<string, unknown>): string {
-  const commandValue = input.command ?? input.cmd;
-  const command = typeof commandValue === "string" ? commandValue : undefined;
-  if (command && command.trim().length > 0) {
-    return `${toolName}: ${command.trim().slice(0, 400)}`;
-  }
-
-  // For agent/subagent tools, prefer the human-readable description or prompt
-  // over raw JSON. The structured subagent_type is carried separately on the
-  // task.* payloads (role) — the label is display-only.
-  const itemType = classifyToolItemType(toolName);
-  if (itemType === "collab_agent_tool_call") {
-    const description =
-      typeof input.description === "string" ? input.description.trim() : undefined;
-    const prompt = typeof input.prompt === "string" ? input.prompt.trim() : undefined;
-    const label = description || (prompt ? prompt.slice(0, 200) : undefined);
-    if (label) {
-      return label;
-    }
-  }
-
-  const serialized = encodeJsonStringForDiagnostics(input) ?? "[unserializable input]";
-  if (serialized.length <= 400) {
-    return `${toolName}: ${serialized}`;
-  }
-  return `${toolName}: ${serialized.slice(0, 397)}...`;
-}
-
-function titleForTool(itemType: CanonicalItemType): string {
-  switch (itemType) {
-    case "command_execution":
-      return "Command run";
-    case "file_change":
-      return "File change";
-    case "mcp_tool_call":
-      return "MCP tool call";
-    case "collab_agent_tool_call":
-      return "Subagent task";
-    case "web_search":
-      return "Web search";
-    case "image_view":
-      return "Image view";
-    case "dynamic_tool_call":
-      return "Tool call";
-    default:
-      return "Item";
-  }
-}
-
-const SUPPORTED_CLAUDE_IMAGE_MIME_TYPES = new Set([
-  "image/gif",
-  "image/jpeg",
-  "image/png",
-  "image/webp",
-]);
-const CLAUDE_SETTING_SOURCES = [
-  "user",
-  "project",
-  "local",
-] as const satisfies ReadonlyArray<SettingSource>;
-
-function buildPromptText(
-  input: ProviderSendTurnInput,
-  boundInstanceId: ProviderInstanceId,
-): string {
-  const rawEffort =
-    input.modelSelection?.instanceId === boundInstanceId
-      ? getModelSelectionStringOptionValue(input.modelSelection, "effort")
-      : null;
-  const claudeModel =
-    input.modelSelection?.instanceId === boundInstanceId ? input.modelSelection.model : undefined;
-  const caps = getClaudeModelCapabilities(claudeModel);
-
-  const promptEffort = resolvePromptInjectedEffort(caps, rawEffort);
-  return applyClaudePromptEffortPrefix(input.input?.trim() ?? "", promptEffort);
-}
-
-function buildUserMessage(input: {
-  readonly sdkContent: Array<Record<string, unknown>>;
-}): SDKUserMessage {
-  return {
-    type: "user",
-    session_id: "",
-    parent_tool_use_id: null,
-    message: {
-      role: "user",
-      content: input.sdkContent as unknown as SDKUserMessage["message"]["content"],
-    },
-  } as SDKUserMessage;
-}
-
-function buildClaudeImageContentBlock(input: {
-  readonly mimeType: string;
-  readonly bytes: Uint8Array;
-}): Record<string, unknown> {
-  return {
-    type: "image",
-    source: {
-      type: "base64",
-      media_type: input.mimeType,
-      data: Buffer.from(input.bytes).toString("base64"),
-    },
-  };
-}
-
-const buildUserMessageEffect = Effect.fn("buildUserMessageEffect")(function* (
-  input: ProviderSendTurnInput,
-  dependencies: {
-    readonly fileSystem: FileSystem.FileSystem;
-    readonly attachmentsDir: string;
-    readonly boundInstanceId: ProviderInstanceId;
-  },
-) {
-  const text = buildPromptText(input, dependencies.boundInstanceId);
-  const sdkContent: Array<Record<string, unknown>> = [];
-
-  if (text.length > 0) {
-    sdkContent.push({ type: "text", text });
-  }
-
-  for (const attachment of input.attachments ?? []) {
-    // Claude ingests images only. Generic files reach the agent through the
-    // path line ProviderService puts in the prompt.
-    if (attachment.type !== "image") {
-      continue;
-    }
-
-    if (!SUPPORTED_CLAUDE_IMAGE_MIME_TYPES.has(attachment.mimeType)) {
-      return yield* new ProviderAdapterRequestError({
-        provider: PROVIDER,
-        method: "turn/start",
-        detail: `Unsupported Claude image attachment type '${attachment.mimeType}'.`,
-      });
-    }
-
-    const attachmentPath = resolveAttachmentPath({
-      attachmentsDir: dependencies.attachmentsDir,
-      attachment,
-    });
-    if (!attachmentPath) {
-      return yield* new ProviderAdapterRequestError({
-        provider: PROVIDER,
-        method: "turn/start",
-        detail: `Invalid attachment id '${attachment.id}'.`,
-      });
-    }
-
-    const bytes = yield* dependencies.fileSystem.readFile(attachmentPath).pipe(
-      Effect.mapError(
-        (cause) =>
-          new ProviderAdapterRequestError({
-            provider: PROVIDER,
-            method: "turn/start",
-            detail: "Failed to read attachment file.",
-            cause,
-          }),
-      ),
-    );
-
-    sdkContent.push(
-      buildClaudeImageContentBlock({
-        mimeType: attachment.mimeType,
-        bytes,
-      }),
-    );
-  }
-
-  return buildUserMessage({ sdkContent });
-});
-
-function turnStatusFromResult(result: SDKResultMessage): ProviderRuntimeTurnStatus {
-  if (result.subtype === "success") {
-    return "completed";
-  }
-
-  const errors = resultErrorsText(result);
-  if (isInterruptedResult(result)) {
-    return "interrupted";
-  }
-  if (errors.includes("cancel")) {
-    return "cancelled";
-  }
-  return "failed";
-}
-
-function streamKindFromDeltaType(deltaType: string): ClaudeTextStreamKind {
-  return deltaType.includes("thinking") ? "reasoning_text" : "assistant_text";
-}
-
-function nativeProviderRefs(
-  _context: ClaudeSessionContext,
-  options?: {
-    readonly providerItemId?: string | undefined;
-  },
-): NonNullable<ProviderRuntimeEvent["providerRefs"]> {
-  if (options?.providerItemId) {
-    return {
-      providerItemId: ProviderItemId.make(options.providerItemId),
-    };
-  }
-  return {};
-}
-
-function extractAssistantTextBlocks(message: SDKMessage): Array<string> {
-  if (message.type !== "assistant") {
-    return [];
-  }
-
-  const content = (message.message as { content?: unknown } | undefined)?.content;
-  if (!Array.isArray(content)) {
-    return [];
-  }
-
-  const fragments: string[] = [];
-  for (const block of content) {
-    if (!block || typeof block !== "object") {
-      continue;
-    }
-    const candidate = block as { type?: unknown; text?: unknown };
-    if (
-      candidate.type === "text" &&
-      typeof candidate.text === "string" &&
-      candidate.text.length > 0
-    ) {
-      fragments.push(candidate.text);
-    }
-  }
-
-  return fragments;
-}
-
-function extractContentBlockText(block: unknown): string {
-  if (!block || typeof block !== "object") {
-    return "";
-  }
-
-  const candidate = block as { type?: unknown; text?: unknown };
-  return candidate.type === "text" && typeof candidate.text === "string" ? candidate.text : "";
-}
-
-function extractTextContent(value: unknown): string {
-  if (typeof value === "string") {
-    return value;
-  }
-
-  if (Array.isArray(value)) {
-    return value.map((entry) => extractTextContent(entry)).join("");
-  }
-
-  if (!value || typeof value !== "object") {
-    return "";
-  }
-
-  const record = value as {
-    text?: unknown;
-    content?: unknown;
-  };
-
-  if (typeof record.text === "string") {
-    return record.text;
-  }
-
-  return extractTextContent(record.content);
-}
-
-function extractExitPlanModePlan(value: unknown): string | undefined {
-  if (!value || typeof value !== "object") {
-    return undefined;
-  }
-
-  const record = value as {
-    plan?: unknown;
-  };
-  return typeof record.plan === "string" && record.plan.trim().length > 0
-    ? record.plan.trim()
-    : undefined;
-}
-
-function exitPlanCaptureKey(input: {
-  readonly toolUseId?: string | undefined;
-  readonly planMarkdown: string;
-}): string {
-  return input.toolUseId && input.toolUseId.length > 0
-    ? `tool:${input.toolUseId}`
-    : `plan:${input.planMarkdown}`;
-}
-
-function tryParseJsonRecord(value: string): Record<string, unknown> | undefined {
-  const result = decodeUnknownJsonStringExit(value);
-  if (!Exit.isSuccess(result)) {
-    return undefined;
-  }
-  const parsed = result.value;
-  return parsed && typeof parsed === "object" && !Array.isArray(parsed)
-    ? (parsed as Record<string, unknown>)
-    : undefined;
-}
-
-function toolInputFingerprint(input: Record<string, unknown>): string | undefined {
-  return encodeJsonStringForDiagnostics(input);
-}
-
-function toolResultStreamKind(itemType: CanonicalItemType): ClaudeToolResultStreamKind | undefined {
-  switch (itemType) {
-    case "command_execution":
-      return "command_output";
-    case "file_change":
-      return "file_change_output";
-    default:
-      return undefined;
-  }
-}
-
-function toolResultBlocksFromUserMessage(message: SDKMessage): Array<{
-  readonly toolUseId: string;
-  readonly block: Record<string, unknown>;
-  readonly text: string;
-  readonly isError: boolean;
-}> {
-  if (message.type !== "user") {
-    return [];
-  }
-
-  const content = (message.message as { content?: unknown } | undefined)?.content;
-  if (!Array.isArray(content)) {
-    return [];
-  }
-
-  const blocks: Array<{
-    readonly toolUseId: string;
-    readonly block: Record<string, unknown>;
-    readonly text: string;
-    readonly isError: boolean;
-  }> = [];
-
-  for (const entry of content) {
-    if (!entry || typeof entry !== "object") {
-      continue;
-    }
-
-    const block = entry as Record<string, unknown>;
-    if (block.type !== "tool_result") {
-      continue;
-    }
-
-    const toolUseId = typeof block.tool_use_id === "string" ? block.tool_use_id : undefined;
-    if (!toolUseId) {
-      continue;
-    }
-
-    blocks.push({
-      toolUseId,
-      block,
-      text: extractTextContent(block.content),
-      isError: block.is_error === true,
-    });
-  }
-
-  return blocks;
-}
-
-function toSessionError(
-  threadId: ThreadId,
-  cause: unknown,
-): ProviderAdapterSessionNotFoundError | ProviderAdapterSessionClosedError | undefined {
-  const normalized = toMessage(cause, "").toLowerCase();
-  if (normalized.includes("unknown session") || normalized.includes("not found")) {
-    return new ProviderAdapterSessionNotFoundError({
-      provider: PROVIDER,
-      threadId,
-      cause,
-    });
-  }
-  if (normalized.includes("closed")) {
-    return new ProviderAdapterSessionClosedError({
-      provider: PROVIDER,
-      threadId,
-      cause,
-    });
-  }
-  return undefined;
-}
-
-function toRequestError(threadId: ThreadId, method: string, cause: unknown): ProviderAdapterError {
-  const sessionError = toSessionError(threadId, cause);
-  if (sessionError) {
-    return sessionError;
-  }
-  return new ProviderAdapterRequestError({
-    provider: PROVIDER,
-    method,
-    detail: `${method} failed`,
-    cause,
-  });
-}
-
-function sdkMessageType(value: unknown): string | undefined {
-  if (!value || typeof value !== "object") {
-    return undefined;
-  }
-  const record = value as { type?: unknown };
-  return typeof record.type === "string" ? record.type : undefined;
-}
-
-function sdkMessageSubtype(value: unknown): string | undefined {
-  if (!value || typeof value !== "object") {
-    return undefined;
-  }
-  const record = value as { subtype?: unknown };
-  return typeof record.subtype === "string" ? record.subtype : undefined;
-}
-
-function sdkNativeMethod(message: SDKMessage): string {
-  const subtype = sdkMessageSubtype(message);
-  if (subtype) {
-    return `claude/${message.type}/${subtype}`;
-  }
-
-  if (message.type === "stream_event") {
-    const streamType = sdkMessageType(message.event);
-    if (streamType) {
-      const deltaType =
-        streamType === "content_block_delta"
-          ? sdkMessageType((message.event as { delta?: unknown }).delta)
-          : undefined;
-      if (deltaType) {
-        return `claude/${message.type}/${streamType}/${deltaType}`;
-      }
-      return `claude/${message.type}/${streamType}`;
-    }
-  }
-
-  return `claude/${message.type}`;
-}
-
-// Discriminator/identity keys carry no human-readable content; everything else
-// on an unmodeled SDK message is potentially worth surfacing in the work log.
-const SDK_MESSAGE_NOISE_KEYS = new Set([
-  "type",
-  "subtype",
-  "uuid",
-  "parent_uuid",
-  "session_id",
-  "parent_tool_use_id",
-  "request_id",
-]);
-
-// Pull the salient scalar content out of a message the adapter doesn't model
-// yet, so the work-log row shows what actually arrived (e.g. a notification's
-// text) instead of an opaque "unhandled subtype" placeholder. Nested structures
-// are left to the full payload retained in the event's `detail`.
-function previewUnknownSdkContent(message: unknown): string | undefined {
-  if (!message || typeof message !== "object") {
-    return undefined;
-  }
-  const parts: string[] = [];
-  for (const [key, value] of Object.entries(message as Record<string, unknown>)) {
-    if (SDK_MESSAGE_NOISE_KEYS.has(key)) {
-      continue;
-    }
-    if (typeof value === "string") {
-      const trimmed = value.trim();
-      if (trimmed.length > 0) {
-        parts.push(`${key}: ${trimmed}`);
-      }
-    } else if (typeof value === "number" || typeof value === "boolean") {
-      parts.push(`${key}: ${String(value)}`);
-    }
-  }
-  if (parts.length === 0) {
-    return undefined;
-  }
-  const joined = parts.join(" · ");
-  return joined.length > 280 ? `${joined.slice(0, 279)}…` : joined;
-}
-
-function describeUnknownSdkMessage(kind: string, message: unknown): string {
-  const preview = previewUnknownSdkContent(message);
-  return preview ? `${kind} — ${preview}` : `${kind} (no displayable text content)`;
-}
-
-function sdkNativeItemId(message: SDKMessage): string | undefined {
-  if (message.type === "assistant") {
-    const maybeId = (message.message as { id?: unknown }).id;
-    if (typeof maybeId === "string") {
-      return maybeId;
-    }
-    return undefined;
-  }
-
-  if (message.type === "user") {
-    return toolResultBlocksFromUserMessage(message)[0]?.toolUseId;
-  }
-
-  if (message.type === "stream_event") {
-    const event = message.event as {
-      type?: unknown;
-      content_block?: { id?: unknown };
-    };
-    if (event.type === "content_block_start" && typeof event.content_block?.id === "string") {
-      return event.content_block.id;
-    }
-  }
-
-  return undefined;
-}
-
-export const makeClaudeAdapter = Effect.fn("makeClaudeAdapter")(function* (
-  claudeSettings: ClaudeSettings,
-  options?: ClaudeAdapterLiveOptions,
-) {
-  const boundInstanceId = options?.instanceId ?? ProviderInstanceId.make("claudeAgent");
-  const fileSystem = yield* FileSystem.FileSystem;
-  const path = yield* Path.Path;
-  const serverConfig = yield* ServerConfig;
-  const crypto = yield* Crypto.Crypto;
-  const claudeEnvironment = yield* makeClaudeEnvironment(claudeSettings, options?.environment).pipe(
-    Effect.provideService(Path.Path, path),
-  );
-  const claudeSdkExecutablePath = yield* resolveClaudeSdkExecutablePath(
-    claudeSettings.binaryPath,
-    claudeEnvironment,
-  );
-  const nativeEventLogger =
-    options?.nativeEventLogger ??
-    (options?.nativeEventLogPath !== undefined
-      ? yield* makeEventNdjsonLogger(options.nativeEventLogPath, {
-          stream: "native",
-        })
-      : undefined);
-  const managedNativeEventLogger =
-    options?.nativeEventLogger === undefined ? nativeEventLogger : undefined;
-
-  const createQuery =
-    options?.createQuery ??
-    ((input: {
-      readonly prompt: AsyncIterable<SDKUserMessage>;
-      readonly options: ClaudeQueryOptions;
-    }) =>
-      query({
-        prompt: input.prompt,
-        options: input.options,
-      }) as ClaudeQueryRuntime);
-
-  const sessions = new Map<ThreadId, ClaudeSessionContext>();
-  const runtimeEventQueue = yield* Queue.unbounded<ProviderRuntimeEvent>();
-
-  const nowIso = Effect.map(DateTime.now, DateTime.formatIso);
-  const randomUUIDv4 = crypto.randomUUIDv4.pipe(
-    Effect.mapError(
-      (cause) =>
-        new ProviderAdapterRequestError({
-          provider: PROVIDER,
-          method: "crypto/randomUUIDv4",
-          detail: "Failed to generate Claude runtime identifier.",
-          cause,
-        }),
-    ),
-  );
-  const nextEventId = Effect.map(randomUUIDv4, (id) => EventId.make(id));
-  const makeEventStamp = () => Effect.all({ eventId: nextEventId, createdAt: nowIso });
-
-  const offerRuntimeEvent = (event: ProviderRuntimeEvent): Effect.Effect<void> =>
-    Queue.offer(runtimeEventQueue, event).pipe(Effect.asVoid);
-
-  const logNativeSdkMessage = Effect.fnUntraced(function* (
-    context: ClaudeSessionContext,
-    message: SDKMessage,
-  ) {
-    if (!nativeEventLogger) {
-      return;
-    }
-
-    const observedAt = yield* nowIso;
-    const itemId = sdkNativeItemId(message);
-
-    yield* nativeEventLogger.write(
-      {
-        observedAt,
-        event: {
-          id:
-            "uuid" in message && typeof message.uuid === "string"
-              ? message.uuid
-              : yield* randomUUIDv4,
-          kind: "notification",
-          provider: PROVIDER,
-          createdAt: observedAt,
-          method: sdkNativeMethod(message),
-          ...(typeof message.session_id === "string"
-            ? { providerThreadId: message.session_id }
-            : {}),
-          ...(context.turnState
-            ? {
-                turnId: asCanonicalTurnId(context.turnState.turnId),
-              }
-            : {}),
-          ...(itemId ? { itemId: ProviderItemId.make(itemId) } : {}),
-          payload: message,
-        },
-      },
-      context.session.threadId,
-    );
-  });
-
-  const snapshotThread = Effect.fn("snapshotThread")(function* (context: ClaudeSessionContext) {
-    const threadId = context.session.threadId;
-    if (!threadId) {
-      return yield* new ProviderAdapterValidationError({
-        provider: PROVIDER,
-        operation: "readThread",
-        issue: "Session thread id is not initialized yet.",
-      });
-    }
-    return {
-      threadId,
-      turns: context.turns.map((turn) => ({
-        id: turn.id,
-        items: [...turn.items],
-      })),
-    };
-  });
-
-  const updateResumeCursor = Effect.fn("updateResumeCursor")(function* (
-    context: ClaudeSessionContext,
-  ) {
-    const threadId = context.session.threadId;
-    if (!threadId) return;
-
-    const resumeCursor = {
-      threadId,
-      ...(context.resumeSessionId ? { resume: context.resumeSessionId } : {}),
-      ...(context.lastAssistantUuid ? { resumeSessionAt: context.lastAssistantUuid } : {}),
-      turnCount: context.turns.length,
-    };
-
-    context.session = {
-      ...context.session,
-      resumeCursor,
-      updatedAt: yield* nowIso,
-    };
-  });
-
-  const ensureAssistantTextBlock = Effect.fn("ensureAssistantTextBlock")(function* (
-    context: ClaudeSessionContext,
-    blockIndex: number,
-    options?: {
-      readonly fallbackText?: string;
-      readonly streamClosed?: boolean;
-    },
-  ) {
-    const turnState = context.turnState;
-    if (!turnState) {
-      return undefined;
-    }
-
-    const existing = turnState.assistantTextBlocks.get(blockIndex);
-    if (existing && !existing.completionEmitted) {
-      if (existing.fallbackText.length === 0 && options?.fallbackText) {
-        existing.fallbackText = options.fallbackText;
-      }
-      if (options?.streamClosed) {
-        existing.streamClosed = true;
-      }
-      return { blockIndex, block: existing };
-    }
-
-    const block: AssistantTextBlockState = {
-      itemId: yield* randomUUIDv4,
-      blockIndex,
-      emittedTextDelta: false,
-      fallbackText: options?.fallbackText ?? "",
-      streamClosed: options?.streamClosed ?? false,
-      completionEmitted: false,
-    };
-    turnState.assistantTextBlocks.set(blockIndex, block);
-    turnState.assistantTextBlockOrder.push(block);
-    return { blockIndex, block };
-  });
-
-  const createSyntheticAssistantTextBlock = Effect.fn("createSyntheticAssistantTextBlock")(
-    function* (context: ClaudeSessionContext, fallbackText: string) {
-      const turnState = context.turnState;
-      if (!turnState) {
-        return undefined;
-      }
-
-      const blockIndex = turnState.nextSyntheticAssistantBlockIndex;
-      turnState.nextSyntheticAssistantBlockIndex -= 1;
-      return yield* ensureAssistantTextBlock(context, blockIndex, {
-        fallbackText,
-        streamClosed: true,
-      });
-    },
-  );
-
-  const completeAssistantTextBlock = Effect.fn("completeAssistantTextBlock")(function* (
-    context: ClaudeSessionContext,
-    block: AssistantTextBlockState,
-    options?: {
-      readonly force?: boolean;
-      readonly rawMethod?: string;
-      readonly rawPayload?: unknown;
-    },
-  ) {
-    const turnState = context.turnState;
-    if (!turnState || block.completionEmitted) {
-      return;
-    }
-
-    if (!options?.force && !block.streamClosed) {
-      return;
-    }
-
-    if (!block.emittedTextDelta && block.fallbackText.length > 0) {
-      const deltaStamp = yield* makeEventStamp();
-      yield* offerRuntimeEvent({
-        type: "content.delta",
-        eventId: deltaStamp.eventId,
-        provider: PROVIDER,
-        createdAt: deltaStamp.createdAt,
-        threadId: context.session.threadId,
-        turnId: turnState.turnId,
-        itemId: asRuntimeItemId(block.itemId),
-        payload: {
-          streamKind: "assistant_text",
-          delta: block.fallbackText,
-        },
-        providerRefs: nativeProviderRefs(context),
-        ...(options?.rawMethod || options?.rawPayload
-          ? {
-              raw: {
-                source: "claude.sdk.message" as const,
-                ...(options.rawMethod ? { method: options.rawMethod } : {}),
-                payload: options?.rawPayload,
-              },
-            }
-          : {}),
-      });
-    }
-
-    block.completionEmitted = true;
-    if (turnState.assistantTextBlocks.get(block.blockIndex) === block) {
-      turnState.assistantTextBlocks.delete(block.blockIndex);
-    }
-
-    const stamp = yield* makeEventStamp();
-    yield* offerRuntimeEvent({
-      type: "item.completed",
-      eventId: stamp.eventId,
-      provider: PROVIDER,
-      createdAt: stamp.createdAt,
-      itemId: asRuntimeItemId(block.itemId),
-      threadId: context.session.threadId,
-      turnId: turnState.turnId,
-      payload: {
-        itemType: "assistant_message",
-        status: "completed",
-        title: "Assistant message",
-        ...(block.fallbackText.length > 0 ? { detail: block.fallbackText } : {}),
-      },
-      providerRefs: nativeProviderRefs(context),
-      ...(options?.rawMethod || options?.rawPayload
-        ? {
-            raw: {
-              source: "claude.sdk.message" as const,
-              ...(options.rawMethod ? { method: options.rawMethod } : {}),
-              payload: options?.rawPayload,
-            },
-          }
-        : {}),
-    });
-  });
-
-  const backfillAssistantTextBlocksFromSnapshot = Effect.fn(
-    "backfillAssistantTextBlocksFromSnapshot",
-  )(function* (context: ClaudeSessionContext, message: SDKMessage) {
-    const turnState = context.turnState;
-    if (!turnState) {
-      return;
-    }
-
-    const snapshotTextBlocks = extractAssistantTextBlocks(message);
-    if (snapshotTextBlocks.length === 0) {
-      return;
-    }
-
-    const orderedBlocks = turnState.assistantTextBlockOrder.map((block) => ({
-      blockIndex: block.blockIndex,
-      block,
-    }));
-
-    for (const [position, text] of snapshotTextBlocks.entries()) {
-      const existingEntry = orderedBlocks[position];
-      const entry =
-        existingEntry ??
-        (yield* createSyntheticAssistantTextBlock(context, text).pipe(
-          Effect.map((created) => {
-            if (!created) {
-              return undefined;
-            }
-            orderedBlocks.push(created);
-            return created;
-          }),
-        ));
-      if (!entry) {
-        continue;
-      }
-
-      if (entry.block.fallbackText.length === 0) {
-        entry.block.fallbackText = text;
-      }
-
-      if (entry.block.streamClosed && !entry.block.completionEmitted) {
-        yield* completeAssistantTextBlock(context, entry.block, {
-          rawMethod: "claude/assistant",
-          rawPayload: message,
-        });
-      }
-    }
-  });
-
-  const ensureThreadId = Effect.fn("ensureThreadId")(function* (
-    context: ClaudeSessionContext,
-    message: SDKMessage,
-  ) {
-    if (typeof message.session_id !== "string" || message.session_id.length === 0) {
-      return;
-    }
-    if (!hasDurableClaudeSessionId(message)) {
-      return;
-    }
-    const nextThreadId = message.session_id;
-    context.resumeSessionId = message.session_id;
-    yield* updateResumeCursor(context);
-
-    if (context.lastThreadStartedId !== nextThreadId) {
-      context.lastThreadStartedId = nextThreadId;
-      const stamp = yield* makeEventStamp();
-      yield* offerRuntimeEvent({
-        type: "thread.started",
-        eventId: stamp.eventId,
-        provider: PROVIDER,
-        createdAt: stamp.createdAt,
-        threadId: context.session.threadId,
-        payload: {
-          providerThreadId: nextThreadId,
-        },
-        providerRefs: {},
-        raw: {
-          source: "claude.sdk.message",
-          method: "claude/thread/started",
-          payload: {
-            session_id: message.session_id,
-          },
-        },
-      });
-    }
-  });
-
-  const emitRuntimeError = Effect.fn("emitRuntimeError")(function* (
-    context: ClaudeSessionContext,
-    message: string,
-    cause?: unknown,
-  ) {
-    if (cause !== undefined) {
-      void cause;
-    }
-    const turnState = context.turnState;
-    const stamp = yield* makeEventStamp();
-    yield* offerRuntimeEvent({
-      type: "runtime.error",
-      eventId: stamp.eventId,
-      provider: PROVIDER,
-      createdAt: stamp.createdAt,
-      threadId: context.session.threadId,
-      ...(turnState ? { turnId: asCanonicalTurnId(turnState.turnId) } : {}),
-      payload: {
-        message,
-        class: "provider_error",
-        ...(cause !== undefined ? { detail: cause } : {}),
-      },
-      providerRefs: nativeProviderRefs(context),
-    });
-  });
-
-  const emitRuntimeWarning = Effect.fn("emitRuntimeWarning")(function* (
-    context: ClaudeSessionContext,
-    message: string,
-    detail?: unknown,
-  ) {
-    const turnState = context.turnState;
-    const stamp = yield* makeEventStamp();
-    yield* offerRuntimeEvent({
-      type: "runtime.warning",
-      eventId: stamp.eventId,
-      provider: PROVIDER,
-      createdAt: stamp.createdAt,
-      threadId: context.session.threadId,
-      ...(turnState ? { turnId: asCanonicalTurnId(turnState.turnId) } : {}),
-      payload: {
-        message,
-        ...(detail !== undefined ? { detail } : {}),
-      },
-      providerRefs: nativeProviderRefs(context),
-    });
-  });
-
-  const emitThreadTokenUsage = Effect.fn("emitThreadTokenUsage")(function* (
-    context: ClaudeSessionContext,
-    usage: ThreadTokenUsageSnapshot | undefined,
-    options?: {
-      readonly rawMethod?: string;
-      readonly rawPayload?: unknown;
-    },
-  ) {
-    if (!usage) {
-      return;
-    }
-
-    context.lastKnownTokenUsage = usage;
-    context.lastKnownTotalProcessedTokens =
-      usage.totalProcessedTokens ?? context.lastKnownTotalProcessedTokens;
-
-    const turnState = context.turnState;
-    const stamp = yield* makeEventStamp();
-    yield* offerRuntimeEvent({
-      type: "thread.token-usage.updated",
-      eventId: stamp.eventId,
-      provider: PROVIDER,
-      createdAt: stamp.createdAt,
-      threadId: context.session.threadId,
-      ...(turnState ? { turnId: turnState.turnId } : {}),
-      payload: {
-        usage,
-      },
-      providerRefs: nativeProviderRefs(context),
-      ...(options?.rawMethod || options?.rawPayload
-        ? {
-            raw: {
-              source: "claude.sdk.message" as const,
-              ...(options.rawMethod ? { method: options.rawMethod } : {}),
-              payload: options.rawPayload,
-            },
-          }
-        : {}),
-    });
-  });
-
-  const emitProposedPlanCompleted = Effect.fn("emitProposedPlanCompleted")(function* (
-    context: ClaudeSessionContext,
-    input: {
-      readonly planMarkdown: string;
-      readonly toolUseId?: string | undefined;
-      readonly rawSource: "claude.sdk.message" | "claude.sdk.permission";
-      readonly rawMethod: string;
-      readonly rawPayload: unknown;
-    },
-  ) {
-    const turnState = context.turnState;
-    const planMarkdown = input.planMarkdown.trim();
-    if (!turnState || planMarkdown.length === 0) {
-      return;
-    }
-
-    const captureKey = exitPlanCaptureKey({
-      toolUseId: input.toolUseId,
-      planMarkdown,
-    });
-    if (turnState.capturedProposedPlanKeys.has(captureKey)) {
-      return;
-    }
-    turnState.capturedProposedPlanKeys.add(captureKey);
-
-    const stamp = yield* makeEventStamp();
-    yield* offerRuntimeEvent({
-      type: "turn.proposed.completed",
-      eventId: stamp.eventId,
-      provider: PROVIDER,
-      createdAt: stamp.createdAt,
-      threadId: context.session.threadId,
-      turnId: turnState.turnId,
-      payload: {
-        planMarkdown,
-      },
-      providerRefs: nativeProviderRefs(context, {
-        providerItemId: input.toolUseId,
-      }),
-      raw: {
-        source: input.rawSource,
-        method: input.rawMethod,
-        payload: input.rawPayload,
-      },
-    });
-  });
-
-  const emitClaudeTaskPlanUpdated = Effect.fn("emitClaudeTaskPlanUpdated")(function* (
-    context: ClaudeSessionContext,
-    input: {
-      readonly toolUseId: string;
-      readonly rawMethod: string;
-      readonly rawPayload: unknown;
-    },
-  ) {
-    const plan = planStepsFromClaudeTasks(context.claudeTasks);
-    if (plan.length === 0) {
-      return;
-    }
-
-    const stamp = yield* makeEventStamp();
-    yield* offerRuntimeEvent({
-      type: "turn.plan.updated",
-      eventId: stamp.eventId,
-      provider: PROVIDER,
-      createdAt: stamp.createdAt,
-      threadId: context.session.threadId,
-      ...(context.turnState ? { turnId: asCanonicalTurnId(context.turnState.turnId) } : {}),
-      payload: {
-        explanation: "Claude Tasks",
-        plan,
-      },
-      providerRefs: nativeProviderRefs(context, {
-        providerItemId: input.toolUseId,
-      }),
-      raw: {
-        source: "claude.sdk.message",
-        method: input.rawMethod,
-        payload: input.rawPayload,
-      },
-    });
-  });
-
-  const completeTurn = Effect.fn("completeTurn")(function* (
-    context: ClaudeSessionContext,
-    status: ProviderRuntimeTurnStatus,
-    errorMessage?: string,
-    result?: SDKResultMessage,
-  ) {
-    const resultContextWindow = maxClaudeContextWindowFromModelUsage(result?.modelUsage);
-    if (resultContextWindow !== undefined) {
-      context.lastKnownContextWindow = resultContextWindow;
-    }
-
-    const maxTokens = resultContextWindow ?? context.lastKnownContextWindow;
-    const accumulatedTotalProcessedTokens = claudeTotalProcessedTokens(result?.usage);
-    if (accumulatedTotalProcessedTokens !== undefined) {
-      context.lastKnownTotalProcessedTokens = accumulatedTotalProcessedTokens;
-    }
-
-    // Avoid getContextUsage because its token-count fallback can make extra model requests.
-    const resultUsageRecord =
-      result?.usage && typeof result.usage === "object" && !Array.isArray(result.usage)
-        ? (result.usage as Record<string, unknown>)
-        : undefined;
-    const hasResultUsageIteration =
-      resultUsageRecord !== undefined && lastClaudeUsageIteration(resultUsageRecord) !== undefined;
-    const resultHasActiveUsage =
-      resultUsageRecord !== undefined &&
-      (hasResultUsageIteration ||
-        claudeUsageInputTokens(resultUsageRecord) + claudeUsageOutputTokens(resultUsageRecord) > 0);
-    const resultTotalOnly =
-      resultUsageRecord !== undefined &&
-      !resultHasActiveUsage &&
-      claudeTotalProcessedTokens(resultUsageRecord) !== undefined;
-    const resultIterationSnapshot = resultUsageRecord
-      ? normalizeClaudeActiveTokenUsage(
-          resultUsageRecord,
-          maxTokens,
-          accumulatedTotalProcessedTokens ?? context.lastKnownTotalProcessedTokens,
-        )
-      : undefined;
-    const latestAssistantSnapshot = normalizeClaudeActiveTokenUsage(
-      context.turnState?.latestAssistantUsage,
-      maxTokens,
-      accumulatedTotalProcessedTokens ?? context.lastKnownTotalProcessedTokens,
-    );
-    const lastGoodUsage = context.lastKnownTokenUsage;
-    const usageSnapshot: ThreadTokenUsageSnapshot | undefined =
-      latestAssistantSnapshot ??
-      (context.turnState?.compactedSinceLatestAssistantUsage
-        ? undefined
-        : resultTotalOnly && lastGoodUsage
-          ? {
-              ...lastGoodUsage,
-              ...(typeof maxTokens === "number" && Number.isFinite(maxTokens) && maxTokens > 0
-                ? { maxTokens }
-                : {}),
-              ...(typeof accumulatedTotalProcessedTokens === "number" &&
-              Number.isFinite(accumulatedTotalProcessedTokens) &&
-              accumulatedTotalProcessedTokens > lastGoodUsage.usedTokens
-                ? {
-                    totalProcessedTokens: accumulatedTotalProcessedTokens,
-                  }
-                : {}),
-            }
-          : resultIterationSnapshot) ??
-      (lastGoodUsage
-        ? {
-            ...lastGoodUsage,
-            ...(typeof maxTokens === "number" && Number.isFinite(maxTokens) && maxTokens > 0
-              ? { maxTokens }
-              : {}),
-            ...(typeof accumulatedTotalProcessedTokens === "number" &&
-            Number.isFinite(accumulatedTotalProcessedTokens) &&
-            accumulatedTotalProcessedTokens > lastGoodUsage.usedTokens
-              ? {
-                  totalProcessedTokens: accumulatedTotalProcessedTokens,
-                }
-              : {}),
-          }
-        : undefined);
-
-    const turnState = context.turnState;
-    if (!turnState) {
-      yield* emitThreadTokenUsage(context, usageSnapshot, {
-        rawMethod: "claude/result",
-        rawPayload: result ?? { status },
-      });
-
-      // A result with no local turn is never a turn this adapter started:
-      // real turns get turnState in sendTurn, and assistant messages that
-      // arrive outside a turn auto-start a synthetic one. What lands here is
-      // the resume handshake (system/init + result(num_turns: 0)), a late
-      // result for a turn already completed locally (steer auto-close,
-      // stream teardown), or a stream failure with no turn in flight. The
-      // untargeted turn.completed this branch used to emit carried no turnId,
-      // so ingestion could not attribute it — and whenever the projection had
-      // no active turn (a pending turn start included) it flipped the session
-      // lifecycle for a turn that never existed. Keep the usage emission,
-      // drop the lifecycle event, and leave a tripwire so the upstream
-      // trigger stays measurable in the field.
-      yield* Effect.logInfo("claude.turn.result-without-active-turn", {
-        threadId: context.session.threadId,
-        status,
-        numTurns: result?.num_turns,
-        hasUsage: result?.usage !== undefined,
-        ...(errorMessage ? { errorMessage } : {}),
-      });
-      return;
-    }
-
-    for (const [index, tool] of context.inFlightTools.entries()) {
-      const toolStamp = yield* makeEventStamp();
-      yield* offerRuntimeEvent({
-        type: "item.completed",
-        eventId: toolStamp.eventId,
-        provider: PROVIDER,
-        createdAt: toolStamp.createdAt,
-        threadId: context.session.threadId,
-        turnId: turnState.turnId,
-        itemId: asRuntimeItemId(tool.itemId),
-        payload: {
-          itemType: tool.itemType,
-          status: status === "completed" ? "completed" : "failed",
-          title: tool.title,
-          ...(tool.detail ? { detail: tool.detail } : {}),
-          data: {
-            toolName: tool.toolName,
-            input: tool.input,
-          },
-        },
-        providerRefs: nativeProviderRefs(context, {
-          providerItemId: tool.itemId,
-        }),
-        raw: {
-          source: "claude.sdk.message",
-          method: "claude/result",
-          payload: result ?? { status },
-        },
-      });
-      context.inFlightTools.delete(index);
-    }
-    // Clear any remaining stale entries (e.g. from interrupted content blocks)
-    context.inFlightTools.clear();
-
-    for (const block of turnState.assistantTextBlockOrder) {
-      yield* completeAssistantTextBlock(context, block, {
-        force: true,
-        rawMethod: "claude/result",
-        rawPayload: result ?? { status },
-      });
-    }
-
-    context.turns.push({
-      id: turnState.turnId,
-      items: [...turnState.items],
-    });
-
-    yield* emitThreadTokenUsage(context, usageSnapshot, {
-      rawMethod: "claude/result",
-      rawPayload: result ?? { status },
-    });
-
-    const stamp = yield* makeEventStamp();
-    yield* offerRuntimeEvent({
-      type: "turn.completed",
-      eventId: stamp.eventId,
-      provider: PROVIDER,
-      createdAt: stamp.createdAt,
-      threadId: context.session.threadId,
-      turnId: turnState.turnId,
-      payload: {
-        state: status,
-        ...(result?.stop_reason !== undefined ? { stopReason: result.stop_reason } : {}),
-        ...(result?.usage ? { usage: result.usage } : {}),
-        ...(result?.modelUsage ? { modelUsage: result.modelUsage } : {}),
-        ...(typeof result?.total_cost_usd === "number"
-          ? { totalCostUsd: result.total_cost_usd }
-          : {}),
-        ...(errorMessage ? { errorMessage } : {}),
-      },
-      providerRefs: nativeProviderRefs(context),
-    });
-
-    const updatedAt = yield* nowIso;
-    context.turnState = undefined;
-    context.session = {
-      ...context.session,
-      status: "ready",
-      activeTurnId: undefined,
-      updatedAt,
-      ...(status === "failed" && errorMessage ? { lastError: errorMessage } : {}),
-    };
-    yield* updateResumeCursor(context);
-  });
-
-  const handleStreamEvent = Effect.fn("handleStreamEvent")(function* (
-    context: ClaudeSessionContext,
-    message: SDKMessage,
-  ) {
-    if (message.type !== "stream_event") {
-      return;
-    }
-
-    const { event } = message;
-
-    // Subagent-owned stream traffic (parent_tool_use_id set) must not write
-    // into the parent transcript: with forwardSubagentText off the SDK still
-    // forwards subagent tool_use/tool_result blocks and their wrapping
-    // text/thinking deltas, and emitting them interleaved N subagents'
-    // narration into the chat (live-test finding). Their results reach the
-    // UI via the task.* lifecycle; their tool blocks are attributed and
-    // re-homed by the quiet-timeline filter.
-    const streamParentToolUseId = (message as { parent_tool_use_id?: string | null })
-      .parent_tool_use_id;
-    if (streamParentToolUseId !== null && streamParentToolUseId !== undefined) {
-      // Drop only the subagent's narration (text/thinking); tool_use blocks
-      // and their input_json_delta frames must flow so attributed tool items
-      // keep their inputs (review finding: dropping deltas emptied inputs).
-      const dropStart =
-        event.type === "content_block_start" &&
-        event.content_block.type !== "tool_use" &&
-        event.content_block.type !== "server_tool_use" &&
-        event.content_block.type !== "mcp_tool_use";
-      const dropDelta =
-        event.type === "content_block_delta" &&
-        (event.delta.type === "text_delta" || event.delta.type === "thinking_delta");
-      if (dropStart || dropDelta) {
-        return;
-      }
-    }
-
-    if (event.type === "message_delta") {
-      if (message.parent_tool_use_id !== null && message.parent_tool_use_id !== undefined) {
-        return;
-      }
-
-      const snapshot = normalizeClaudeActiveTokenUsage(
-        event.usage,
-        context.lastKnownContextWindow,
-        context.lastKnownTotalProcessedTokens,
-      );
-      yield* emitThreadTokenUsage(context, snapshot, {
-        rawMethod: "claude/stream_event/message_delta",
-        rawPayload: message,
-      });
-      return;
-    }
-
-    if (event.type === "content_block_delta") {
-      if (
-        (event.delta.type === "text_delta" || event.delta.type === "thinking_delta") &&
-        context.turnState
-      ) {
-        const deltaText =
-          event.delta.type === "text_delta"
-            ? event.delta.text
-            : typeof event.delta.thinking === "string"
-              ? event.delta.thinking
-              : "";
-        if (deltaText.length === 0) {
-          return;
-        }
-        const streamKind = streamKindFromDeltaType(event.delta.type);
-        const assistantBlockEntry =
-          event.delta.type === "text_delta"
-            ? yield* ensureAssistantTextBlock(context, event.index)
-            : context.turnState.assistantTextBlocks.get(event.index)
-              ? {
-                  blockIndex: event.index,
-                  block: context.turnState.assistantTextBlocks.get(
-                    event.index,
-                  ) as AssistantTextBlockState,
-                }
-              : undefined;
-        if (assistantBlockEntry?.block && event.delta.type === "text_delta") {
-          assistantBlockEntry.block.emittedTextDelta = true;
-        }
-        const stamp = yield* makeEventStamp();
-        yield* offerRuntimeEvent({
-          type: "content.delta",
-          eventId: stamp.eventId,
-          provider: PROVIDER,
-          createdAt: stamp.createdAt,
-          threadId: context.session.threadId,
-          turnId: context.turnState.turnId,
-          ...(assistantBlockEntry?.block
-            ? {
-                itemId: asRuntimeItemId(assistantBlockEntry.block.itemId),
-              }
-            : {}),
-          payload: {
-            streamKind,
-            delta: deltaText,
-          },
-          providerRefs: nativeProviderRefs(context),
-          raw: {
-            source: "claude.sdk.message",
-            method: "claude/stream_event/content_block_delta",
-            payload: message,
-          },
-        });
-        return;
-      }
-
-      if (event.delta.type === "input_json_delta") {
-        const tool = context.inFlightTools.get(event.index);
-        if (!tool || typeof event.delta.partial_json !== "string") {
-          return;
-        }
-
-        const partialInputJson = tool.partialInputJson + event.delta.partial_json;
-        const parsedInput = tryParseJsonRecord(partialInputJson);
-        const detail = parsedInput ? summarizeToolRequest(tool.toolName, parsedInput) : tool.detail;
-        let nextTool: ToolInFlight = {
-          ...tool,
-          partialInputJson,
-          ...(parsedInput ? { input: parsedInput } : {}),
-          ...(detail ? { detail } : {}),
-        };
-
-        const nextFingerprint =
-          parsedInput && Object.keys(parsedInput).length > 0
-            ? toolInputFingerprint(parsedInput)
-            : undefined;
-        context.inFlightTools.set(event.index, nextTool);
-
-        if (
-          !parsedInput ||
-          !nextFingerprint ||
-          tool.lastEmittedInputFingerprint === nextFingerprint
-        ) {
-          return;
-        }
-
-        nextTool = {
-          ...nextTool,
-          lastEmittedInputFingerprint: nextFingerprint,
-        };
-        context.inFlightTools.set(event.index, nextTool);
-
-        const stamp = yield* makeEventStamp();
-        yield* offerRuntimeEvent({
-          type: "item.updated",
-          eventId: stamp.eventId,
-          provider: PROVIDER,
-          createdAt: stamp.createdAt,
-          threadId: context.session.threadId,
-          ...(context.turnState
-            ? {
-                turnId: asCanonicalTurnId(context.turnState.turnId),
-              }
-            : {}),
-          itemId: asRuntimeItemId(nextTool.itemId),
-          payload: {
-            itemType: nextTool.itemType,
-            status: "inProgress",
-            title: nextTool.title,
-            ...(nextTool.detail ? { detail: nextTool.detail } : {}),
-            ...(nextTool.agentId ? { agentId: nextTool.agentId } : {}),
-            ...(nextTool.parentToolUseId ? { parentToolUseId: nextTool.parentToolUseId } : {}),
-            data: {
-              toolName: nextTool.toolName,
-              input: nextTool.input,
-            },
-          },
-          providerRefs: nativeProviderRefs(context, {
-            providerItemId: nextTool.itemId,
-          }),
-          raw: {
-            source: "claude.sdk.message",
-            method: "claude/stream_event/content_block_delta/input_json_delta",
-            payload: message,
-          },
-        });
-
-        // Emit plan update when TodoWrite input is parsed
-        if (parsedInput && isTodoTool(nextTool.toolName)) {
-          const planSteps = extractPlanStepsFromTodoInput(parsedInput);
-          if (planSteps && planSteps.length > 0) {
-            const planStamp = yield* makeEventStamp();
-            yield* offerRuntimeEvent({
-              type: "turn.plan.updated",
-              eventId: planStamp.eventId,
-              provider: PROVIDER,
-              createdAt: planStamp.createdAt,
-              threadId: context.session.threadId,
-              ...(context.turnState
-                ? {
-                    turnId: asCanonicalTurnId(context.turnState.turnId),
-                  }
-                : {}),
-              payload: {
-                plan: planSteps,
-              },
-              providerRefs: nativeProviderRefs(context),
-            });
-          }
-        }
-      }
-      return;
-    }
-
-    if (event.type === "content_block_start") {
-      const { index, content_block: block } = event;
-      if (block.type === "text") {
-        yield* ensureAssistantTextBlock(context, index, {
-          fallbackText: extractContentBlockText(block),
-        });
-        return;
-      }
-      if (
-        block.type !== "tool_use" &&
-        block.type !== "server_tool_use" &&
-        block.type !== "mcp_tool_use"
-      ) {
-        return;
-      }
-
-      const toolName = block.name;
-      const itemType = classifyToolItemType(toolName);
-      const toolInput =
-        typeof block.input === "object" && block.input !== null
-          ? (block.input as Record<string, unknown>)
-          : {};
-      const itemId = block.id;
-      const detail = summarizeToolRequest(toolName, toolInput);
-      const inputFingerprint =
-        Object.keys(toolInput).length > 0 ? toolInputFingerprint(toolInput) : undefined;
-
-      // Attribute tools that ran inside a subagent to their owning agent so
-      // clients can re-home them out of the main timeline (quiet-timeline
-      // guarantee): the SDK forwards subagent tool_use blocks tagged with the
-      // spawning Task tool's id as parent_tool_use_id.
-      const parentToolUseId =
-        (message as { parent_tool_use_id?: string | null }).parent_tool_use_id ?? undefined;
-      const owningAgentId = agentIdForParentToolUse(context.taskAgents, parentToolUseId);
-
-      const tool: ToolInFlight = {
-        itemId,
-        itemType,
-        toolName,
-        title: titleForTool(itemType),
-        detail,
-        input: toolInput,
-        partialInputJson: "",
-        ...(inputFingerprint ? { lastEmittedInputFingerprint: inputFingerprint } : {}),
-        ...(owningAgentId ? { agentId: owningAgentId } : {}),
-        ...(parentToolUseId ? { parentToolUseId } : {}),
-      };
-      context.inFlightTools.set(index, tool);
-
-      const stamp = yield* makeEventStamp();
-      yield* offerRuntimeEvent({
-        type: "item.started",
-        eventId: stamp.eventId,
-        provider: PROVIDER,
-        createdAt: stamp.createdAt,
-        threadId: context.session.threadId,
-        ...(context.turnState ? { turnId: asCanonicalTurnId(context.turnState.turnId) } : {}),
-        itemId: asRuntimeItemId(tool.itemId),
-        payload: {
-          itemType: tool.itemType,
-          status: "inProgress",
-          title: tool.title,
-          ...(tool.detail ? { detail: tool.detail } : {}),
-          ...(tool.agentId ? { agentId: tool.agentId } : {}),
-          ...(tool.parentToolUseId ? { parentToolUseId: tool.parentToolUseId } : {}),
-          data: {
-            toolName: tool.toolName,
-            input: toolInput,
-          },
-        },
-        providerRefs: nativeProviderRefs(context, {
-          providerItemId: tool.itemId,
-        }),
-        raw: {
-          source: "claude.sdk.message",
-          method: "claude/stream_event/content_block_start",
-          payload: message,
-        },
-      });
-      return;
-    }
-
-    if (event.type === "content_block_stop") {
-      const { index } = event;
-      const assistantBlock = context.turnState?.assistantTextBlocks.get(index);
-      if (assistantBlock) {
-        assistantBlock.streamClosed = true;
-        yield* completeAssistantTextBlock(context, assistantBlock, {
-          rawMethod: "claude/stream_event/content_block_stop",
-          rawPayload: message,
-        });
-        return;
-      }
-      const tool = context.inFlightTools.get(index);
-      if (!tool) {
-        return;
-      }
-    }
-  });
-
-  const handleUserMessage = Effect.fn("handleUserMessage")(function* (
-    context: ClaudeSessionContext,
-    message: SDKMessage,
-  ) {
-    if (message.type !== "user") {
-      return;
-    }
-
-    if (context.turnState) {
-      context.turnState.items.push(message.message);
-    }
-
-    for (const toolResult of toolResultBlocksFromUserMessage(message)) {
-      const toolEntry = Array.from(context.inFlightTools.entries()).find(
-        ([, tool]) => tool.itemId === toolResult.toolUseId,
-      );
-      if (!toolEntry) {
-        continue;
-      }
-
-      const [index, tool] = toolEntry;
-      const itemStatus = toolResult.isError ? "failed" : "completed";
-      const toolUseResult = readClaudeToolUseResult(message);
-      const toolData = {
-        toolName: tool.toolName,
-        input: tool.input,
-        result: toolResult.block,
-      };
-
-      const updatedStamp = yield* makeEventStamp();
-      yield* offerRuntimeEvent({
-        type: "item.updated",
-        eventId: updatedStamp.eventId,
-        provider: PROVIDER,
-        createdAt: updatedStamp.createdAt,
-        threadId: context.session.threadId,
-        ...(context.turnState ? { turnId: asCanonicalTurnId(context.turnState.turnId) } : {}),
-        itemId: asRuntimeItemId(tool.itemId),
-        payload: {
-          itemType: tool.itemType,
-          status: toolResult.isError ? "failed" : "inProgress",
-          title: tool.title,
-          ...(tool.detail ? { detail: tool.detail } : {}),
-          ...(tool.agentId ? { agentId: tool.agentId } : {}),
-          ...(tool.parentToolUseId ? { parentToolUseId: tool.parentToolUseId } : {}),
-          data: toolData,
-        },
-        providerRefs: nativeProviderRefs(context, {
-          providerItemId: tool.itemId,
-        }),
-        raw: {
-          source: "claude.sdk.message",
-          method: "claude/user",
-          payload: message,
-        },
-      });
-
-      const streamKind = toolResultStreamKind(tool.itemType);
-      if (streamKind && toolResult.text.length > 0 && context.turnState) {
-        const deltaStamp = yield* makeEventStamp();
-        yield* offerRuntimeEvent({
-          type: "content.delta",
-          eventId: deltaStamp.eventId,
-          provider: PROVIDER,
-          createdAt: deltaStamp.createdAt,
-          threadId: context.session.threadId,
-          turnId: context.turnState.turnId,
-          itemId: asRuntimeItemId(tool.itemId),
-          payload: {
-            streamKind,
-            delta: toolResult.text,
-          },
-          providerRefs: nativeProviderRefs(context, {
-            providerItemId: tool.itemId,
-          }),
-          raw: {
-            source: "claude.sdk.message",
-            method: "claude/user",
-            payload: message,
-          },
-        });
-      }
-
-      const completedStamp = yield* makeEventStamp();
-      yield* offerRuntimeEvent({
-        type: "item.completed",
-        eventId: completedStamp.eventId,
-        provider: PROVIDER,
-        createdAt: completedStamp.createdAt,
-        threadId: context.session.threadId,
-        ...(context.turnState ? { turnId: asCanonicalTurnId(context.turnState.turnId) } : {}),
-        itemId: asRuntimeItemId(tool.itemId),
-        payload: {
-          itemType: tool.itemType,
-          status: itemStatus,
-          title: tool.title,
-          ...(tool.detail ? { detail: tool.detail } : {}),
-          ...(tool.agentId ? { agentId: tool.agentId } : {}),
-          ...(tool.parentToolUseId ? { parentToolUseId: tool.parentToolUseId } : {}),
-          data: toolData,
-        },
-        providerRefs: nativeProviderRefs(context, {
-          providerItemId: tool.itemId,
-        }),
-        raw: {
-          source: "claude.sdk.message",
-          method: "claude/user",
-          payload: message,
-        },
-      });
-
-      // The Workflow tool's result carries the run handles (runId, scriptPath,
-      // transcriptDir, sessionUrl). Attach them to the workflow's task agent so
-      // the next task.* payload advertises them to clients.
-      if (!toolResult.isError && tool.toolName.toLowerCase() === "workflow" && toolUseResult) {
-        const workflowTaskId = trimmedString(toolUseResult.taskId);
-        if (workflowTaskId) {
-          const runHandles: TaskRunHandles = {
-            ...(trimmedString(toolUseResult.runId)
-              ? { runId: trimmedString(toolUseResult.runId) }
-              : {}),
-            ...(trimmedString(toolUseResult.scriptPath)
-              ? { scriptPath: trimmedString(toolUseResult.scriptPath) }
-              : {}),
-            ...(trimmedString(toolUseResult.transcriptDir)
-              ? { transcriptDir: trimmedString(toolUseResult.transcriptDir) }
-              : {}),
-            ...(sanitizeSessionUrl(toolUseResult.sessionUrl)
-              ? { sessionUrl: sanitizeSessionUrl(toolUseResult.sessionUrl) }
-              : {}),
-          };
-          const existing = context.taskAgents.get(workflowTaskId);
-          context.taskAgents.set(workflowTaskId, {
-            taskId: workflowTaskId,
-            toolUseId: existing?.toolUseId ?? tool.itemId,
-            description: existing?.description,
-            subagentType: existing?.subagentType,
-            taskType: existing?.taskType ?? "local_workflow",
-            workflowName: existing?.workflowName,
-            skipTranscript: existing?.skipTranscript ?? false,
-            runHandles,
-            owningAgentId: existing?.owningAgentId,
-            model: existing?.model,
-            effort: existing?.effort,
-          });
-        }
-      }
-
-      if (
-        !toolResult.isError &&
-        applyClaudeTaskToolResult(context.claudeTasks, tool, toolUseResult)
-      ) {
-        yield* emitClaudeTaskPlanUpdated(context, {
-          toolUseId: tool.itemId,
-          rawMethod: "claude/user",
-          rawPayload: message,
-        });
-      }
-
-      context.inFlightTools.delete(index);
-    }
-  });
-
-  const handleAssistantMessage = Effect.fn("handleAssistantMessage")(function* (
-    context: ClaudeSessionContext,
-    message: SDKMessage,
-  ) {
-    if (message.type !== "assistant") {
-      return;
-    }
-
-    // Subagent-owned assistant snapshots (parent_tool_use_id set) are the
-    // subagent's own conversation, not the parent's. Emitting them created
-    // interleaved "Agent N done"-adjacent leak messages and spawned synthetic
-    // turns per subagent completion (which also reset the Working timer).
-    const assistantParentToolUseId = (message as { parent_tool_use_id?: string | null })
-      .parent_tool_use_id;
-    if (assistantParentToolUseId !== null && assistantParentToolUseId !== undefined) {
-      // The snapshot's message.model is the authoritative API model the
-      // subagent actually ran on — refine the seeded launch-time value.
-      const owningTaskId = agentIdForParentToolUse(context.taskAgents, assistantParentToolUseId);
-      const snapshotModel = trimmedString(message.message.model);
-      const owningAgent = owningTaskId ? context.taskAgents.get(owningTaskId) : undefined;
-      if (snapshotModel) {
-        if (owningAgent) {
-          owningAgent.model = snapshotModel;
-        } else {
-          // The snapshot beat its task_started (or its tool_use_id was never
-          // recorded): hold the model until the task registers.
-          rememberPendingTaskModel(
-            context.pendingTaskModels,
-            assistantParentToolUseId,
-            snapshotModel,
-          );
-        }
-      }
-      context.lastAssistantUuid = message.uuid;
-      yield* updateResumeCursor(context);
-      return;
-    }
-
-    // Auto-start a synthetic turn for assistant messages that arrive without
-    // an active turn (e.g., background agent/subagent responses between user prompts).
-    if (!context.turnState) {
-      const turnId = TurnId.make(yield* randomUUIDv4);
-      const startedAt = yield* nowIso;
-      context.turnState = {
-        turnId,
-        startedAt,
-        synthetic: true,
-        items: [],
-        assistantTextBlocks: new Map(),
-        assistantTextBlockOrder: [],
-        capturedProposedPlanKeys: new Set(),
-        latestAssistantUsage: undefined,
-        compactedSinceLatestAssistantUsage: false,
-        nextSyntheticAssistantBlockIndex: -1,
-      };
-      context.session = {
-        ...context.session,
-        status: "running",
-        activeTurnId: turnId,
-        updatedAt: startedAt,
-      };
-      const turnStartedStamp = yield* makeEventStamp();
-      yield* offerRuntimeEvent({
-        type: "turn.started",
-        eventId: turnStartedStamp.eventId,
-        provider: PROVIDER,
-        createdAt: turnStartedStamp.createdAt,
-        threadId: context.session.threadId,
-        turnId,
-        payload: {},
-        providerRefs: {
-          ...nativeProviderRefs(context),
-          providerTurnId: turnId,
-        },
-        raw: {
-          source: "claude.sdk.message",
-          method: "claude/synthetic-turn-start",
-          payload: {},
-        },
-      });
-    }
-
-    const content = message.message?.content;
-    if (Array.isArray(content)) {
-      for (const block of content) {
-        if (!block || typeof block !== "object") {
-          continue;
-        }
-        const toolUse = block as {
-          type?: unknown;
-          id?: unknown;
-          name?: unknown;
-          input?: unknown;
-        };
-        if (toolUse.type !== "tool_use" || toolUse.name !== "ExitPlanMode") {
-          continue;
-        }
-        const planMarkdown = extractExitPlanModePlan(toolUse.input);
-        if (!planMarkdown) {
-          continue;
-        }
-        yield* emitProposedPlanCompleted(context, {
-          planMarkdown,
-          toolUseId: typeof toolUse.id === "string" ? toolUse.id : undefined,
-          rawSource: "claude.sdk.message",
-          rawMethod: "claude/assistant",
-          rawPayload: message,
-        });
-      }
-    }
-
-    if (context.turnState) {
-      context.turnState.items.push(message.message);
-      if (
-        normalizeClaudeActiveTokenUsage(
-          message.message.usage,
-          context.lastKnownContextWindow,
-          context.lastKnownTotalProcessedTokens,
-        )
-      ) {
-        context.turnState.latestAssistantUsage = message.message.usage;
-        context.turnState.compactedSinceLatestAssistantUsage = false;
-      }
-      yield* backfillAssistantTextBlocksFromSnapshot(context, message);
-    }
-
-    context.lastAssistantUuid = message.uuid;
-    yield* updateResumeCursor(context);
-  });
-
-  const handleResultMessage = Effect.fn("handleResultMessage")(function* (
-    context: ClaudeSessionContext,
-    message: SDKMessage,
-  ) {
-    if (message.type !== "result") {
-      return;
-    }
-
-    const status = turnStatusFromResult(message);
-    const errorMessage = resultUserFacingError(message);
-
-    if (status === "failed") {
-      yield* emitRuntimeError(context, errorMessage ?? "Claude turn failed.");
-    }
-
-    yield* completeTurn(context, status, errorMessage, message);
-  });
-
-  /**
-   * Synthesizes per-member task.progress rows from the coordinator's
-   * workflow_progress array. Member identity is the stable slot
-   * `<coordinatorTaskId>:wf:<index>` (never the per-attempt agent id, which
-   * changes on retry and would split one member into duplicate rows).
-   * timelineBypass keeps these out of the parent chat; the Agents surface and
-   * workflow card consume them.
-   */
-  const emitWorkflowMemberProgress = Effect.fn("emitWorkflowMemberProgress")(function* (
-    context: ClaudeSessionContext,
-    base: Omit<ProviderRuntimeEvent, "type" | "payload">,
-    message: Extract<SDKMessage, { type: "system"; subtype: "task_progress" }>,
-  ) {
-    const progress = parseWorkflowProgress(
-      (message as unknown as Record<string, unknown>).workflow_progress,
-    );
-    if (!progress) {
-      return;
-    }
-    const coordinatorId = message.task_id;
-    for (const entry of progress.agents) {
-      const memberTaskId = `${coordinatorId}:wf:${entry.index}`;
-      const status = workflowAgentStatus(entry);
-      // Material-transition filter: the wire repeats every member each tick.
-      // Emit only when something the client renders actually changed, so a
-      // 100-agent fleet costs ~1 event per changed member instead of 100
-      // per tick (review finding: unbounded event amplification).
-      const fingerprint = [
-        status,
-        entry.label ?? "",
-        entry.model ?? "",
-        entry.lastToolName ?? "",
-        entry.error ?? "",
-        entry.tokens ?? "",
-        entry.toolCalls ?? "",
-        entry.phaseIndex ?? "",
-        entry.phaseTitle ?? "",
-        entry.attempt ?? "",
-      ].join("\u001f");
-      if (context.workflowMemberFingerprints.get(memberTaskId) === fingerprint) {
-        continue;
-      }
-      context.workflowMemberFingerprints.set(memberTaskId, fingerprint);
-      const stamp = yield* makeEventStamp();
-      yield* offerRuntimeEvent({
-        ...base,
-        eventId: stamp.eventId,
-        createdAt: stamp.createdAt,
-        type: "task.progress",
-        payload: {
-          taskId: RuntimeTaskId.make(memberTaskId),
-          description: entry.label ?? `agent ${entry.index}`,
-          status,
-          ...(entry.error ? { error: entry.error } : {}),
-          ...(entry.label ? { title: entry.label } : {}),
-          ...(entry.model ? { model: entry.model } : {}),
-          ...(entry.lastToolName ? { lastToolName: entry.lastToolName } : {}),
-          ...(entry.tokens !== undefined
-            ? {
-                typedUsage: {
-                  totalTokens: entry.tokens,
-                  ...(entry.toolCalls !== undefined ? { toolUses: entry.toolCalls } : {}),
-                },
-              }
-            : {}),
-          parentAgentId: coordinatorId,
-          agentIndex: entry.index,
-          ...(entry.phaseIndex !== undefined ? { phaseIndex: entry.phaseIndex } : {}),
-          ...(entry.phaseTitle ? { phaseTitle: entry.phaseTitle } : {}),
-          ...(entry.attempt !== undefined ? { attempt: entry.attempt } : {}),
-          timelineBypass: true,
-        },
-      });
-    }
-  });
-
-  const handleSystemMessage = Effect.fn("handleSystemMessage")(function* (
-    context: ClaudeSessionContext,
-    message: SDKMessage,
-  ) {
-    if (message.type !== "system") {
-      return;
-    }
-
-    const stamp = yield* makeEventStamp();
-    const base = {
-      eventId: stamp.eventId,
-      provider: PROVIDER,
-      createdAt: stamp.createdAt,
-      threadId: context.session.threadId,
-      ...(context.turnState ? { turnId: asCanonicalTurnId(context.turnState.turnId) } : {}),
-      providerRefs: nativeProviderRefs(context),
-      raw: {
-        source: "claude.sdk.message" as const,
-        method: sdkNativeMethod(message),
-        messageType: `${message.type}:${message.subtype}`,
-        payload: message,
-      },
-    };
-
-    // Undeclared-but-real subtypes (absent from the SDK's union, so they can't
-    // be switch cases): consumed intentionally without emitting, otherwise
-    // they fall through to the unknown-subtype warning and surface as spurious
-    // error rows in client work logs. `background_tasks_changed` is a roster
-    // snapshot ({tasks: [...]}) — the task_* lifecycle events carry the
-    // authoritative per-agent data and the typed background_tasks control
-    // request is the reconciliation source. `vcs_state_changed`
-    // ({kind: commit|push|rebase}) and `code_change_published`
-    // ({provider, url, repo}) are informational CLI notices; the work log
-    // already shows the underlying git/gh tool calls.
-    switch (message.subtype as string) {
-      case "background_tasks_changed":
-      case "vcs_state_changed":
-      case "code_change_published":
-        return;
-    }
-
-    switch (message.subtype) {
-      case "init":
-        yield* offerRuntimeEvent({
-          ...base,
-          type: "session.configured",
-          payload: {
-            config: message as Record<string, unknown>,
-          },
-        });
-        return;
-      case "status":
-        yield* offerRuntimeEvent({
-          ...base,
-          type: "session.state.changed",
-          payload: {
-            state: message.status === "compacting" ? "waiting" : "running",
-            reason: `status:${message.status ?? "active"}`,
-            detail: message,
-          },
-        });
-        return;
-      case "compact_boundary":
-        if (context.turnState) {
-          context.turnState.latestAssistantUsage = undefined;
-          context.turnState.compactedSinceLatestAssistantUsage = true;
-        }
-        yield* emitThreadTokenUsage(
-          context,
-          compactBoundaryTokenUsageSnapshot(
-            message as unknown as Record<string, unknown>,
-            context.lastKnownContextWindow,
-            context.lastKnownTotalProcessedTokens,
-          ),
-          {
-            rawMethod: "claude/system/compact_boundary",
-            rawPayload: message,
-          },
-        );
-        yield* offerRuntimeEvent({
-          ...base,
-          type: "thread.state.changed",
-          payload: {
-            state: "compacted",
-            detail: message,
-          },
-        });
-        return;
-      case "hook_started":
-        yield* offerRuntimeEvent({
-          ...base,
-          type: "hook.started",
-          payload: {
-            hookId: message.hook_id,
-            hookName: message.hook_name,
-            hookEvent: message.hook_event,
-          },
-        });
-        return;
-      case "hook_progress":
-        yield* offerRuntimeEvent({
-          ...base,
-          type: "hook.progress",
-          payload: {
-            hookId: message.hook_id,
-            output: message.output,
-            stdout: message.stdout,
-            stderr: message.stderr,
-          },
-        });
-        return;
-      case "hook_response":
-        yield* offerRuntimeEvent({
-          ...base,
-          type: "hook.completed",
-          payload: {
-            hookId: message.hook_id,
-            outcome: message.outcome,
-            output: message.output,
-            stdout: message.stdout,
-            stderr: message.stderr,
-            ...(typeof message.exit_code === "number" ? { exitCode: message.exit_code } : {}),
-          },
-        });
-        return;
-      case "task_started": {
-        // A task launched by a tool that itself ran inside a subagent (the
-        // in-flight tool carries agentId from parent_tool_use_id) is
-        // agent-internal: a subagent's background shell, not parent work.
-        const launchingTool = message.tool_use_id
-          ? Array.from(context.inFlightTools.values()).find(
-              (tool) => tool.itemId === message.tool_use_id,
-            )
-          : undefined;
-        const owningAgentId = launchingTool?.agentId;
-        // Model/effort: the Agent tool's input carries explicit overrides;
-        // absent ones inherit the session's selection (SDK behavior).
-        // Subagent assistant snapshots refine model with the authoritative API
-        // id: one that already arrived is buffered and outranks the seed here,
-        // later ones refine the record in place. AgentInput.effort may be a
-        // named level or an integer.
-        const launchInput = launchingTool?.input;
-        const toolUseId = message.tool_use_id;
-        const bufferedModel = toolUseId ? context.pendingTaskModels.get(toolUseId) : undefined;
-        if (toolUseId) {
-          context.pendingTaskModels.delete(toolUseId);
-        }
-        const model =
-          bufferedModel ??
-          trimmedString(launchInput?.model) ??
-          trimmedString(context.session.model ?? undefined);
-        const rawLaunchEffort = launchInput?.effort;
-        const effort =
-          trimmedString(rawLaunchEffort) ??
-          (typeof rawLaunchEffort === "number" && Number.isFinite(rawLaunchEffort)
-            ? String(rawLaunchEffort)
-            : context.currentEffort);
-        // Remember the agent identity so every later task.* payload for this
-        // taskId is self-describing (identity must survive activity retention).
-        context.taskAgents.set(message.task_id, {
-          taskId: message.task_id,
-          toolUseId: message.tool_use_id,
-          description: message.description,
-          subagentType: message.subagent_type,
-          taskType: message.task_type,
-          workflowName: message.workflow_name,
-          skipTranscript: message.skip_transcript === true,
-          runHandles: context.taskAgents.get(message.task_id)?.runHandles,
-          owningAgentId,
-          model,
-          effort,
-        });
-        context.liveTaskIds.add(message.task_id);
-        yield* offerRuntimeEvent({
-          ...base,
-          type: "task.started",
-          payload: {
-            taskId: RuntimeTaskId.make(message.task_id),
-            description: message.description,
-            ...(message.task_type ? { taskType: message.task_type } : {}),
-            ...(owningAgentId ? { agentId: owningAgentId } : {}),
-            ...(message.description ? { title: message.description } : {}),
-            ...(message.subagent_type ? { role: message.subagent_type } : {}),
-            ...(model ? { model } : {}),
-            ...(effort ? { effort } : {}),
-            ...(message.tool_use_id ? { toolUseId: message.tool_use_id } : {}),
-            ...(message.workflow_name ? { workflowName: message.workflow_name } : {}),
-          },
-        });
-        return;
-      }
-      case "task_progress": {
-        yield* emitThreadTokenUsage(
-          context,
-          normalizeClaudeTaskProgressTokenUsage(message.usage, context),
-          {
-            rawMethod: "claude/system/task_progress",
-            rawPayload: message,
-          },
-        );
-        const linkage = taskLinkageFor(context.taskAgents, message.task_id);
-        const typedUsage = normalizeTaskUsage(message.usage);
-        // Phases ride on the coordinator's ONE progress row per tick. A
-        // separate phases-only row shared the stable ingestion activity id
-        // with this full row, and the thinner upsert overwrote usage and
-        // progress text (review finding).
-        const workflowPhases = parseWorkflowProgress(
-          (message as unknown as Record<string, unknown>).workflow_progress,
-        )?.phases;
-        yield* offerRuntimeEvent({
-          ...base,
-          type: "task.progress",
-          payload: {
-            taskId: RuntimeTaskId.make(message.task_id),
-            description: message.description,
-            ...(message.summary ? { summary: message.summary } : {}),
-            ...(message.usage ? { usage: message.usage } : {}),
-            ...(typedUsage ? { typedUsage } : {}),
-            ...(message.last_tool_name ? { lastToolName: message.last_tool_name } : {}),
-            ...(workflowPhases && workflowPhases.length > 0 ? { phases: workflowPhases } : {}),
-            ...linkage,
-            ...(message.subagent_type ? { role: message.subagent_type } : {}),
-          },
-        });
-        yield* emitWorkflowMemberProgress(context, base, message);
-        return;
-      }
-      case "task_updated": {
-        // Status patch (killed/paused/backgrounded/end_time/error) — main
-        // previously dropped this on the floor, losing all transitions.
-        const patch = message.patch;
-        const status =
-          patch.status !== undefined ? CLAUDE_TASK_PATCH_STATUS[patch.status] : undefined;
-        if (status === "completed" || status === "failed" || status === "cancelled") {
-          context.liveTaskIds.delete(message.task_id);
-        }
-        const endedAt =
-          typeof patch.end_time === "number" && Number.isFinite(patch.end_time)
-            ? DateTime.formatIso(DateTime.makeUnsafe(patch.end_time))
-            : undefined;
-        yield* offerRuntimeEvent({
-          ...base,
-          type: "task.updated",
-          payload: {
-            taskId: RuntimeTaskId.make(message.task_id),
-            ...(status ? { status } : {}),
-            ...(patch.description ? { description: patch.description } : {}),
-            ...(patch.error ? { error: patch.error } : {}),
-            ...(endedAt ? { endedAt } : {}),
-            ...(patch.is_backgrounded !== undefined
-              ? { isBackgrounded: patch.is_backgrounded }
-              : {}),
-            ...taskLinkageFor(context.taskAgents, message.task_id),
-          },
-        });
-        return;
-      }
-      case "task_notification": {
-        context.liveTaskIds.delete(message.task_id);
-        yield* emitThreadTokenUsage(
-          context,
-          normalizeClaudeTaskProgressTokenUsage(message.usage, context),
-          {
-            rawMethod: "claude/system/task_notification",
-            rawPayload: message,
-          },
-        );
-        const typedUsage = normalizeTaskUsage(message.usage);
-        yield* offerRuntimeEvent({
-          ...base,
-          type: "task.completed",
-          payload: {
-            taskId: RuntimeTaskId.make(message.task_id),
-            status: message.status,
-            ...(message.summary ? { summary: message.summary } : {}),
-            ...(message.usage ? { usage: message.usage } : {}),
-            ...(typedUsage ? { typedUsage } : {}),
-            ...(message.output_file ? { outputFile: message.output_file } : {}),
-            ...taskLinkageFor(context.taskAgents, message.task_id),
-          },
-        });
-        return;
-      }
-      case "files_persisted":
-        yield* offerRuntimeEvent({
-          ...base,
-          type: "files.persisted",
-          payload: {
-            files: Array.isArray(message.files)
-              ? message.files.map((file: { filename: string; file_id: string }) => ({
-                  filename: file.filename,
-                  fileId: file.file_id,
-                }))
-              : [],
-            ...(Array.isArray(message.failed)
-              ? {
-                  failed: message.failed.map((entry: { filename: string; error: string }) => ({
-                    filename: entry.filename,
-                    error: entry.error,
-                  })),
-                }
-              : {}),
-          },
-        });
-        return;
-      case "thinking_tokens":
-        return;
-      case "api_retry":
-        // Transport-level retry heartbeat. Surfacing each attempt as a
-        // warning row spammed the work log (10 rows during a 502 storm);
-        // the terminal result/error path reports the actual failure. Keep
-        // the session visibly alive instead.
-        yield* offerRuntimeEvent({
-          ...base,
-          type: "session.state.changed",
-          payload: {
-            state: "running",
-            reason: `api_retry:${message.attempt}/${message.max_retries}`,
-          },
-        });
-        return;
-      case "session_state_changed":
-        // Authoritative turn-over signal from the CLI.
-        yield* offerRuntimeEvent({
-          ...base,
-          type: "session.state.changed",
-          payload: {
-            state:
-              message.state === "running"
-                ? "running"
-                : message.state === "requires_action"
-                  ? "waiting"
-                  : "ready",
-            reason: `session_state:${message.state}`,
-          },
-        });
-        return;
-      case "notification":
-        // User-facing CLI notification (e.g. context-limit warnings). Only
-        // high-priority ones warrant a work-log row.
-        if (message.priority === "high" || message.priority === "immediate") {
-          yield* emitRuntimeWarning(context, message.text, message);
-        }
-        return;
-      // Inner protocol/UX details with no T3 surface today — consumed
-      // deliberately so they don't masquerade as unknown-subtype warnings.
-      case "model_refusal_fallback":
-      case "local_command_output":
-      case "plugin_install":
-      case "commands_changed":
-      case "memory_recall":
-      case "elicitation_complete":
-        return;
-      case "permission_denied":
-        yield* offerRuntimeEvent({
-          ...base,
-          type: "tool.denied",
-          payload: {
-            toolName: message.tool_name,
-            ...(message.tool_use_id ? { toolUseId: message.tool_use_id } : {}),
-            ...(message.decision_reason ? { reason: message.decision_reason } : {}),
-            ...(message.agent_id ? { agentId: message.agent_id } : {}),
-          },
-        });
-        return;
-      case "mirror_error":
-        yield* emitRuntimeError(
-          context,
-          `Claude workspace mirror error: ${message.error}`,
-          message,
-        );
-        return;
-      default: {
-        // Exhaustiveness guard: every subtype in the SDK's typed union is
-        // handled above, so `message` narrows to never here — a new SDK
-        // release adding a subtype fails this typecheck instead of silently
-        // warning at runtime. The runtime fallback still catches undeclared
-        // wire-only subtypes (like background_tasks_changed used to be).
-        message satisfies never;
-        const unknownMessage = message as never as { subtype: string };
-        yield* emitRuntimeWarning(
-          context,
-          describeUnknownSdkMessage(`Claude system message '${unknownMessage.subtype}'`, message),
-          message,
-        );
-        return;
-      }
-    }
-  });
-
-  const handleSdkTelemetryMessage = Effect.fn("handleSdkTelemetryMessage")(function* (
-    context: ClaudeSessionContext,
-    message: SDKMessage,
-  ) {
-    const stamp = yield* makeEventStamp();
-    const base = {
-      eventId: stamp.eventId,
-      provider: PROVIDER,
-      createdAt: stamp.createdAt,
-      threadId: context.session.threadId,
-      ...(context.turnState ? { turnId: asCanonicalTurnId(context.turnState.turnId) } : {}),
-      providerRefs: nativeProviderRefs(context),
-      raw: {
-        source: "claude.sdk.message" as const,
-        method: sdkNativeMethod(message),
-        messageType: message.type,
-        payload: message,
-      },
-    };
-
-    if (message.type === "tool_progress") {
-      yield* offerRuntimeEvent({
-        ...base,
-        type: "tool.progress",
-        payload: {
-          toolUseId: message.tool_use_id,
-          toolName: message.tool_name,
-          elapsedSeconds: message.elapsed_time_seconds,
-          ...(message.task_id ? { taskId: RuntimeTaskId.make(message.task_id) } : {}),
-          ...(message.parent_tool_use_id !== null
-            ? { parentToolUseId: message.parent_tool_use_id }
-            : {}),
-        },
-      });
-      return;
-    }
-
-    if (message.type === "tool_use_summary") {
-      yield* offerRuntimeEvent({
-        ...base,
-        type: "tool.summary",
-        payload: {
-          summary: message.summary,
-          ...(message.preceding_tool_use_ids.length > 0
-            ? {
-                precedingToolUseIds: message.preceding_tool_use_ids,
-              }
-            : {}),
-        },
-      });
-      return;
-    }
-
-    if (message.type === "auth_status") {
-      yield* offerRuntimeEvent({
-        ...base,
-        type: "auth.status",
-        payload: {
-          isAuthenticating: message.isAuthenticating,
-          output: message.output,
-          ...(message.error ? { error: message.error } : {}),
-        },
-      });
-      return;
-    }
-
-    if (message.type === "rate_limit_event") {
-      yield* offerRuntimeEvent({
-        ...base,
-        type: "account.rate-limits.updated",
-        payload: {
-          rateLimits: message,
-        },
-      });
-      return;
-    }
-  });
-
-  const handleSdkMessage = Effect.fn("handleSdkMessage")(function* (
-    context: ClaudeSessionContext,
-    message: SDKMessage,
-  ) {
-    yield* logNativeSdkMessage(context, message);
-    yield* ensureThreadId(context, message);
-
-    // Wire-only command bookkeeping has no user-facing T3 lifecycle.
-    if (sdkMessageType(message) === "command_lifecycle") {
-      return;
-    }
-
-    switch (message.type) {
-      case "stream_event":
-        yield* handleStreamEvent(context, message);
-        return;
-      case "user":
-        yield* handleUserMessage(context, message);
-        return;
-      case "assistant":
-        yield* handleAssistantMessage(context, message);
-        return;
-      case "result":
-        yield* handleResultMessage(context, message);
-        return;
-      case "system":
-        yield* handleSystemMessage(context, message);
-        return;
-      case "tool_progress":
-      case "tool_use_summary":
-      case "auth_status":
-      case "rate_limit_event":
-        yield* handleSdkTelemetryMessage(context, message);
-        return;
-      // Composer prompt suggestions have no T3 surface; consumed deliberately.
-      case "prompt_suggestion":
-        return;
-      default: {
-        // Exhaustiveness guard (see handleSystemMessage): new SDK top-level
-        // message types fail typecheck here instead of warning at runtime.
-        message satisfies never;
-        const unknownMessage = message as never as { type: string };
-        yield* emitRuntimeWarning(
-          context,
-          describeUnknownSdkMessage(`Claude SDK message '${unknownMessage.type}'`, message),
-          message,
-        );
-        return;
-      }
-    }
-  });
-
-  const runSdkStream = (
-    context: ClaudeSessionContext,
-  ): Effect.Effect<void, ProviderAdapterProcessError> =>
-    Stream.fromAsyncIterable(
-      context.query,
-      (cause) =>
-        new ProviderAdapterProcessError({
-          provider: PROVIDER,
-          threadId: context.session.threadId,
-          detail: "Claude runtime stream failed.",
-          cause,
-        }),
-    ).pipe(
-      Stream.takeWhile(() => !context.stopped),
-      Stream.runForEach((message) =>
-        handleSdkMessage(context, message).pipe(
-          Effect.mapError(
-            (cause) =>
-              new ProviderAdapterProcessError({
-                provider: PROVIDER,
-                threadId: context.session.threadId,
-                detail: "Failed to process Claude runtime event.",
-                cause,
-              }),
-          ),
-        ),
-      ),
-    );
-
-  const handleStreamExit = Effect.fn("handleStreamExit")(function* (
-    context: ClaudeSessionContext,
-    exit: Exit.Exit<void, ProviderAdapterProcessError>,
-  ) {
-    if (context.stopped) {
-      return;
-    }
-
-    if (Exit.isFailure(exit)) {
-      if (isClaudeInterruptedCause(exit.cause)) {
-        if (context.turnState) {
-          yield* completeTurn(context, "interrupted", "Claude runtime interrupted.");
-        }
-      } else {
-        const failures = exit.cause.reasons.flatMap((reason) =>
-          Cause.isFailReason(reason) ? [reason.error] : [],
-        );
-        const message = failures[0]?.detail ?? "Claude runtime stream failed.";
-        yield* emitRuntimeError(context, message, {
-          failureCount: failures.length,
-          failureTags: failures.map((failure) => failure._tag),
-        });
-        yield* completeTurn(context, "failed", message);
-      }
-    } else if (context.turnState) {
-      yield* completeTurn(context, "interrupted", "Claude runtime stream ended.");
-    }
-
-    yield* stopSessionInternal(context, {
-      emitExitEvent: true,
-    });
-  });
-
-  const stopSessionInternal = Effect.fn("stopSessionInternal")(function* (
-    context: ClaudeSessionContext,
-    options?: { readonly emitExitEvent?: boolean },
-  ) {
-    if (context.stopped) return;
-
-    // Schedule process termination before any cleanup that can wait on the
-    // provider. The SDK closes stdin, then escalates from SIGTERM to SIGKILL.
-    yield* Effect.try({
-      try: () => context.query.close(),
-      catch: (cause) =>
-        new ProviderAdapterProcessError({
-          provider: PROVIDER,
-          threadId: context.session.threadId,
-          detail: "Failed to close Claude runtime query.",
-          cause,
-        }),
-    });
-
-    context.stopped = true;
-
-    for (const taskId of Array.from(context.liveTaskIds)) {
-      if (!context.liveTaskIds.delete(taskId)) {
-        continue;
-      }
-      const stamp = yield* makeEventStamp();
-      yield* offerRuntimeEvent({
-        type: "task.completed",
-        eventId: stamp.eventId,
-        provider: PROVIDER,
-        createdAt: stamp.createdAt,
-        threadId: context.session.threadId,
-        ...(context.turnState ? { turnId: asCanonicalTurnId(context.turnState.turnId) } : {}),
-        payload: {
-          taskId: RuntimeTaskId.make(taskId),
-          status: "stopped",
-          ...taskLinkageFor(context.taskAgents, taskId),
-        },
-        providerRefs: nativeProviderRefs(context),
-      });
-    }
-
-    for (const [requestId, pending] of context.pendingApprovals) {
-      yield* Deferred.succeed(pending.decision, "cancel");
-      const stamp = yield* makeEventStamp();
-      yield* offerRuntimeEvent({
-        type: "request.resolved",
-        eventId: stamp.eventId,
-        provider: PROVIDER,
-        createdAt: stamp.createdAt,
-        threadId: context.session.threadId,
-        ...(context.turnState ? { turnId: asCanonicalTurnId(context.turnState.turnId) } : {}),
-        requestId: asRuntimeRequestId(requestId),
-        payload: {
-          requestType: pending.requestType,
-          decision: "cancel",
-        },
-        providerRefs: nativeProviderRefs(context),
-      });
-    }
-    context.pendingApprovals.clear();
-
-    // Same reason as the approvals above: a request nobody can answer any more
-    // must not stay open, or the thread can never be settled.
-    for (const pending of [...context.pendingUserInputs.values()]) {
-      yield* pending.cancel;
-    }
-
-    if (context.turnState) {
-      yield* completeTurn(context, "interrupted", "Session stopped.");
-    }
-
-    yield* Queue.shutdown(context.promptQueue);
-
-    const streamFiber = context.streamFiber;
-    context.streamFiber = undefined;
-    if (streamFiber && streamFiber.pollUnsafe() === undefined) {
-      yield* Fiber.interrupt(streamFiber);
-    }
-
-    const updatedAt = yield* nowIso;
-    context.session = {
-      ...context.session,
-      status: "closed",
-      activeTurnId: undefined,
-      updatedAt,
-    };
-
-    if (options?.emitExitEvent !== false && sessions.get(context.session.threadId) === context) {
-      const stamp = yield* makeEventStamp();
-      yield* offerRuntimeEvent({
-        type: "session.exited",
-        eventId: stamp.eventId,
-        provider: PROVIDER,
-        createdAt: stamp.createdAt,
-        threadId: context.session.threadId,
-        payload: {
-          reason: "Session stopped",
-          exitKind: "graceful",
-        },
-        providerRefs: {},
-      });
-    }
-
-    if (sessions.get(context.session.threadId) === context) {
-      sessions.delete(context.session.threadId);
-    }
-  });
-
-  const requireSession = (
-    threadId: ThreadId,
-  ): Effect.Effect<ClaudeSessionContext, ProviderAdapterError> => {
-    const context = sessions.get(threadId);
-    if (!context) {
-      return Effect.fail(
-        new ProviderAdapterSessionNotFoundError({
-          provider: PROVIDER,
-          threadId,
-        }),
-      );
-    }
-    if (context.stopped || context.session.status === "closed") {
-      return Effect.fail(
-        new ProviderAdapterSessionClosedError({
-          provider: PROVIDER,
-          threadId,
-        }),
-      );
-    }
-    return Effect.succeed(context);
-  };
-
-  const startSession: ClaudeAdapterShape["startSession"] = Effect.fn("startSession")(
-    function* (input) {
-      if (input.provider !== undefined && input.provider !== PROVIDER) {
-        return yield* new ProviderAdapterValidationError({
-          provider: PROVIDER,
-          operation: "startSession",
-          issue: `Expected provider '${PROVIDER}' but received '${input.provider}'.`,
-        });
-      }
-
-      const existingContext = sessions.get(input.threadId);
-      if (existingContext) {
-        yield* Effect.logWarning("claude.session.replacing", {
-          threadId: input.threadId,
-          existingSessionStatus: existingContext.session.status,
-          reason: "startSession called with existing active session",
-        });
-        yield* stopSessionInternal(existingContext, {
-          emitExitEvent: false,
-        });
-      }
-
-      const startedAt = yield* nowIso;
-      const resumeState = readClaudeResumeState(input.resumeCursor);
-      const threadId = input.threadId;
-      const existingResumeSessionId = resumeState?.resume;
-      const newSessionId = existingResumeSessionId === undefined ? yield* randomUUIDv4 : undefined;
-      const sessionId = existingResumeSessionId ?? newSessionId;
-
-      const runtimeContext = yield* Effect.context<never>();
-      const runFork = Effect.runForkWith(runtimeContext);
-      const runPromise = Effect.runPromiseWith(runtimeContext);
-
-      const promptQueue = yield* Queue.unbounded<PromptQueueItem>();
-      const prompt = Stream.fromQueue(promptQueue).pipe(
-        Stream.filter((item) => item.type === "message"),
-        Stream.map((item) => item.message),
-        Stream.catchCause((cause) =>
-          Cause.hasInterruptsOnly(cause) ? Stream.empty : Stream.failCause(cause),
-        ),
-        Stream.toAsyncIterable,
-      );
-
-      const pendingApprovals = new Map<ApprovalRequestId, PendingApproval>();
-      const pendingUserInputs = new Map<ApprovalRequestId, PendingUserInput>();
-      const inFlightTools = new Map<number, ToolInFlight>();
-      const claudeTasks = new Map<string, ClaudeTaskState>();
-      const taskAgents = new Map<string, ClaudeTaskAgentState>();
-      const pendingTaskModels = new Map<string, string>();
-      const workflowMemberFingerprints = new Map<string, string>();
-      const liveTaskIds = new Set<string>();
-
-      const contextRef = yield* Ref.make<ClaudeSessionContext | undefined>(undefined);
-
-      /**
-       * Handle AskUserQuestion tool calls by emitting a `user-input.requested`
-       * runtime event and waiting for the user to respond via `respondToUserInput`.
-       */
-      const handleAskUserQuestion = Effect.fn("handleAskUserQuestion")(function* (
-        context: ClaudeSessionContext,
-        toolInput: Record<string, unknown>,
-        callbackOptions: {
-          readonly signal: AbortSignal;
-          readonly toolUseID?: string;
-        },
-      ) {
-        const requestId = ApprovalRequestId.make(yield* randomUUIDv4);
-
-        // Parse questions from the SDK's AskUserQuestion input.
-        // `id` MUST equal the full question text — Claude SDK >= 2.1.121 looks
-        // up answers by question text in `mapToolResultToToolResultBlockParam`,
-        // so the key the UI uses to keep its draft answer must match the SDK's
-        // expected lookup key. See https://github.com/pingdotgg/t3code/issues/2388
-        const rawQuestions = Array.isArray(toolInput.questions) ? toolInput.questions : [];
-        const questions: Array<UserInputQuestion> = rawQuestions.map(
-          (q: Record<string, unknown>, idx: number) => ({
-            id: typeof q.question === "string" && q.question.length > 0 ? q.question : `q-${idx}`,
-            header: typeof q.header === "string" ? q.header : `Question ${idx + 1}`,
-            question: typeof q.question === "string" ? q.question : "",
-            options: Array.isArray(q.options)
-              ? q.options.map((opt: Record<string, unknown>) => ({
-                  label: typeof opt.label === "string" ? opt.label : "",
-                  description: typeof opt.description === "string" ? opt.description : "",
-                }))
-              : [],
-            multiSelect: typeof q.multiSelect === "boolean" ? q.multiSelect : false,
-          }),
-        );
-
-        const answersDeferred = yield* Deferred.make<ProviderUserInputAnswers>();
-        let aborted = false;
-        const settleAsAborted = Effect.suspend(() => {
-          if (!pendingUserInputs.has(requestId)) {
-            return Effect.void;
-          }
-          aborted = true;
-          pendingUserInputs.delete(requestId);
-          return Deferred.succeed(answersDeferred, {} as ProviderUserInputAnswers).pipe(
-            Effect.ignore,
-          );
-        });
-        const pendingInput: PendingUserInput = {
-          questions,
-          answers: answersDeferred,
-          cancel: settleAsAborted,
-        };
-
-        // Emit user-input.requested so the UI can present the questions.
-        const requestedStamp = yield* makeEventStamp();
-        yield* offerRuntimeEvent({
-          type: "user-input.requested",
-          eventId: requestedStamp.eventId,
-          provider: PROVIDER,
-          createdAt: requestedStamp.createdAt,
-          threadId: context.session.threadId,
-          ...(context.turnState
-            ? {
-                turnId: asCanonicalTurnId(context.turnState.turnId),
-              }
-            : {}),
-          requestId: asRuntimeRequestId(requestId),
-          payload: { questions },
-          providerRefs: nativeProviderRefs(context, {
-            providerItemId: callbackOptions.toolUseID,
-          }),
-          raw: {
-            source: "claude.sdk.permission",
-            method: "canUseTool/AskUserQuestion",
-            payload: {
-              toolName: "AskUserQuestion",
-              input: toolInput,
-            },
-          },
-        });
-
-        pendingUserInputs.set(requestId, pendingInput);
-
-        // Handle abort (e.g. turn interrupted while waiting for user input).
-        const onAbort = () => {
-          runFork(settleAsAborted);
-        };
-        callbackOptions.signal.addEventListener("abort", onAbort, {
-          once: true,
-        });
-        // The signal may have aborted during the awaited event emissions
-        // above, before the listener existed; settle now so the dialog
-        // cannot hang with a lingering pending question.
-        if (callbackOptions.signal.aborted) {
-          yield* settleAsAborted;
-        }
-
-        // Block until the user provides answers.
-        const answers = yield* Deferred.await(answersDeferred);
-        pendingUserInputs.delete(requestId);
-
-        // Emit user-input.resolved so the UI knows the interaction completed.
-        const resolvedStamp = yield* makeEventStamp();
-        yield* offerRuntimeEvent({
-          type: "user-input.resolved",
-          eventId: resolvedStamp.eventId,
-          provider: PROVIDER,
-          createdAt: resolvedStamp.createdAt,
-          threadId: context.session.threadId,
-          ...(context.turnState
-            ? {
-                turnId: asCanonicalTurnId(context.turnState.turnId),
-              }
-            : {}),
-          requestId: asRuntimeRequestId(requestId),
-          payload: { answers },
-          providerRefs: nativeProviderRefs(context, {
-            providerItemId: callbackOptions.toolUseID,
-          }),
-          raw: {
-            source: "claude.sdk.permission",
-            method: "canUseTool/AskUserQuestion/resolved",
-            payload: { answers },
-          },
-        });
-
-        if (aborted) {
-          return {
-            behavior: "deny",
-            message: "User cancelled tool execution.",
-          } satisfies PermissionResult;
-        }
-
-        // Return the answers to the SDK in the expected format:
-        // { questions: [...], answers: { questionText: selectedLabel } }
-        return {
-          behavior: "allow",
-          updatedInput: {
-            questions: toolInput.questions,
-            answers,
-          },
-        } satisfies PermissionResult;
-      });
-
-      const handleResumeDialog = Effect.fn("handleResumeDialog")(function* (
-        request: Parameters<NonNullable<ClaudeQueryOptions["onUserDialog"]>>[0],
-        callbackOptions: Parameters<NonNullable<ClaudeQueryOptions["onUserDialog"]>>[1],
-      ) {
-        if (request.dialogKind !== "resume_return") {
-          return { behavior: "cancelled" as const };
-        }
-
-        const context = yield* Ref.get(contextRef);
-        if (!context) {
-          return { behavior: "cancelled" as const };
-        }
-
-        // The question copy lives in @t3tools/shared/claudeCompaction because
-        // the web client recognizes this exact text (and the "never" answer)
-        // to mirror a permanent dismissal.
-        const question = formatClaudeResumeCompactionQuestion({
-          ageMinutes: finiteNonNegativeInteger(request.payload.sessionAgeMinutes) ?? 0,
-          estimatedTokens: finiteNonNegativeInteger(request.payload.estimatedTokens) ?? 0,
-        });
-        const result = yield* handleAskUserQuestion(
-          context,
-          {
-            questions: [
-              {
-                header: "Resume session",
-                question,
-                options: [
-                  {
-                    label: "Compact and continue",
-                    description: "Resume with a summary and use fewer tokens.",
-                  },
-                  {
-                    label: "Keep full history",
-                    description: "Resume without changing the conversation.",
-                  },
-                  {
-                    label: CLAUDE_RESUME_COMPACTION_NEVER_ANSWER,
-                    description: "Keep full history and skip future resume prompts.",
-                  },
-                ],
-                multiSelect: false,
-              },
-            ],
-          },
-          {
-            signal: callbackOptions.signal,
-            ...(request.toolUseID ? { toolUseID: request.toolUseID } : {}),
-          },
-        );
-
-        if (result.behavior !== "allow") {
-          return { behavior: "cancelled" as const };
-        }
-
-        const answers = result.updatedInput.answers;
-        const selection =
-          answers && typeof answers === "object" && !Array.isArray(answers)
-            ? (answers as Record<string, unknown>)[question]
-            : undefined;
-        const action =
-          selection === "Compact and continue"
-            ? "compact"
-            : selection === CLAUDE_RESUME_COMPACTION_NEVER_ANSWER
-              ? "never"
-              : "continue";
-
-        return { behavior: "completed" as const, result: action };
-      });
-
-      const canUseToolEffect = Effect.fn("canUseTool")(function* (
-        toolName: Parameters<CanUseTool>[0],
-        toolInput: Parameters<CanUseTool>[1],
-        callbackOptions: Parameters<CanUseTool>[2],
-      ) {
-        const context = yield* Ref.get(contextRef);
-        if (!context) {
-          return {
-            behavior: "deny",
-            message: "Claude session context is unavailable.",
-          } satisfies PermissionResult;
-        }
-
-        // Handle AskUserQuestion: surface clarifying questions to the
-        // user via the user-input runtime event channel, regardless of
-        // runtime mode (plan mode relies on this heavily).
-        if (toolName === "AskUserQuestion") {
-          return yield* handleAskUserQuestion(context, toolInput, callbackOptions);
-        }
-
-        if (toolName === "ExitPlanMode") {
-          const planMarkdown = extractExitPlanModePlan(toolInput);
-          if (planMarkdown) {
-            yield* emitProposedPlanCompleted(context, {
-              planMarkdown,
-              toolUseId: callbackOptions.toolUseID,
-              rawSource: "claude.sdk.permission",
-              rawMethod: "canUseTool/ExitPlanMode",
-              rawPayload: {
-                toolName,
-                input: toolInput,
-              },
-            });
-          }
-
-          return {
-            behavior: "deny",
-            message:
-              "The client captured your proposed plan. Stop here and wait for the user's feedback or implementation request in a later turn.",
-          } satisfies PermissionResult;
-        }
-
-        const runtimeMode = input.runtimeMode ?? "full-access";
-        if (runtimeMode === "full-access") {
-          return {
-            behavior: "allow",
-            updatedInput: toolInput,
-          } satisfies PermissionResult;
-        }
-
-        const requestId = ApprovalRequestId.make(yield* randomUUIDv4);
-        const requestType = classifyRequestType(toolName);
-        const detail = summarizeToolRequest(toolName, toolInput);
-        const decisionDeferred = yield* Deferred.make<ProviderApprovalDecision>();
-        const pendingApproval: PendingApproval = {
-          requestType,
-          detail,
-          decision: decisionDeferred,
-          ...(callbackOptions.suggestions ? { suggestions: callbackOptions.suggestions } : {}),
-        };
-
-        const requestedStamp = yield* makeEventStamp();
-        yield* offerRuntimeEvent({
-          type: "request.opened",
-          eventId: requestedStamp.eventId,
-          provider: PROVIDER,
-          createdAt: requestedStamp.createdAt,
-          threadId: context.session.threadId,
-          ...(context.turnState ? { turnId: asCanonicalTurnId(context.turnState.turnId) } : {}),
-          requestId: asRuntimeRequestId(requestId),
-          payload: {
-            requestType,
-            detail,
-            args: {
-              toolName,
-              input: toolInput,
-              ...(callbackOptions.toolUseID ? { toolUseId: callbackOptions.toolUseID } : {}),
-            },
-          },
-          providerRefs: nativeProviderRefs(context, {
-            providerItemId: callbackOptions.toolUseID,
-          }),
-          raw: {
-            source: "claude.sdk.permission",
-            method: "canUseTool/request",
-            payload: {
-              toolName,
-              input: toolInput,
-            },
-          },
-        });
-
-        pendingApprovals.set(requestId, pendingApproval);
-
-        const onAbort = () => {
-          if (!pendingApprovals.has(requestId)) {
-            return;
-          }
-          pendingApprovals.delete(requestId);
-          runFork(Deferred.succeed(decisionDeferred, "cancel"));
-        };
-
-        callbackOptions.signal.addEventListener("abort", onAbort, {
-          once: true,
-        });
-        // Same late-listener race as handleAskUserQuestion: the signal may
-        // have aborted while the request event emissions were awaited.
-        if (callbackOptions.signal.aborted) {
-          onAbort();
-        }
-
-        const decision = yield* Deferred.await(decisionDeferred);
-        pendingApprovals.delete(requestId);
-
-        const resolvedStamp = yield* makeEventStamp();
-        yield* offerRuntimeEvent({
-          type: "request.resolved",
-          eventId: resolvedStamp.eventId,
-          provider: PROVIDER,
-          createdAt: resolvedStamp.createdAt,
-          threadId: context.session.threadId,
-          ...(context.turnState ? { turnId: asCanonicalTurnId(context.turnState.turnId) } : {}),
-          requestId: asRuntimeRequestId(requestId),
-          payload: {
-            requestType,
-            decision,
-          },
-          providerRefs: nativeProviderRefs(context, {
-            providerItemId: callbackOptions.toolUseID,
-          }),
-          raw: {
-            source: "claude.sdk.permission",
-            method: "canUseTool/decision",
-            payload: {
-              decision,
-            },
-          },
-        });
-
-        if (decision === "accept" || decision === "acceptForSession") {
-          return {
-            behavior: "allow",
-            updatedInput: toolInput,
-            ...(decision === "acceptForSession"
-              ? {
-                  updatedPermissions: toSessionPermissionUpdates(
-                    toolName,
-                    pendingApproval.suggestions,
-                  ),
-                }
-              : {}),
-          } satisfies PermissionResult;
-        }
-
-        return {
-          behavior: "deny",
-          message:
-            decision === "cancel"
-              ? "User cancelled tool execution."
-              : "User declined tool execution.",
-        } satisfies PermissionResult;
-      });
-
-      const canUseTool: CanUseTool = (toolName, toolInput, callbackOptions) =>
-        runPromise(canUseToolEffect(toolName, toolInput, callbackOptions));
-      const onUserDialog: NonNullable<ClaudeQueryOptions["onUserDialog"]> = (
-        request,
-        callbackOptions,
-      ) => runPromise(handleResumeDialog(request, callbackOptions));
-
-      const claudeBinaryPath = claudeSdkExecutablePath;
-      const extraArgs = parseCliArgs(claudeSettings.launchArgs).flags;
-      const modelSelection =
-        input.modelSelection?.instanceId === boundInstanceId ? input.modelSelection : undefined;
-      const caps = getClaudeModelCapabilities(modelSelection?.model);
-      const descriptors = getProviderOptionDescriptors({ caps });
-      const apiModelId = modelSelection ? resolveClaudeApiModelId(modelSelection) : undefined;
-      const initialContextWindow = selectedClaudeContextWindow(modelSelection);
-      const rawEffort = getModelSelectionStringOptionValue(modelSelection, "effort");
-      const effort = resolveClaudeEffort(caps, rawEffort) ?? null;
-      const fastModeSupported = descriptors.some(
-        (descriptor) => descriptor.type === "boolean" && descriptor.id === "fastMode",
-      );
-      const thinkingSupported = descriptors.some(
-        (descriptor) => descriptor.type === "boolean" && descriptor.id === "thinking",
-      );
-      const fastMode =
-        getModelSelectionBooleanOptionValue(modelSelection, "fastMode") === true &&
-        fastModeSupported;
-      const thinking = thinkingSupported
-        ? getModelSelectionBooleanOptionValue(modelSelection, "thinking")
-        : undefined;
-      const ultracode = isClaudeUltracodeEffort(effort);
-      const effectiveEffort = getEffectiveClaudeAgentEffort(effort, modelSelection?.model);
-      const runtimeModeToPermission: Record<string, PermissionMode> = {
-        "auto-accept-edits": "acceptEdits",
-        auto: "auto",
-        "full-access": "bypassPermissions",
-      };
-      const permissionMode = runtimeModeToPermission[input.runtimeMode];
-      const settings = {
-        ...(typeof thinking === "boolean" ? { alwaysThinkingEnabled: thinking } : {}),
-        ...(fastMode ? { fastMode: true } : {}),
-        ...(ultracode ? { ultracode: true } : {}),
-        ...(claudeSettings.autoCompactWindow
-          ? { autoCompactWindow: Number(claudeSettings.autoCompactWindow) }
-          : {}),
-      };
-      const mcpSession = McpProviderSession.readMcpProviderSession(input.threadId);
-      // The attachments dir grant lets the agent Read/copy pasted images at
-      // the paths ProviderService injects into the turn text, without an
-      // approval prompt. It is a leaf directory holding only attachment
-      // files; siblings like secrets/ and state.sqlite stay ungranted.
-      const additionalDirectories = [
-        ...(input.cwd ? [input.cwd] : []),
-        serverConfig.attachmentsDir,
-      ];
-      const queryOptions: ClaudeQueryOptions = {
-        ...(input.cwd ? { cwd: input.cwd } : {}),
-        ...(apiModelId ? { model: apiModelId } : {}),
-        pathToClaudeCodeExecutable: claudeBinaryPath,
-        systemPrompt: { type: "preset", preset: "claude_code" },
-        settingSources: [...CLAUDE_SETTING_SOURCES],
-        // `ultracode` is a Claude Code setting, not an API effort level. It is
-        // normalized to `xhigh` above and paired with `settings.ultracode`.
-        ...(effectiveEffort
-          ? {
-              effort: effectiveEffort as unknown as NonNullable<ClaudeQueryOptions["effort"]>,
-            }
-          : {}),
-        ...(permissionMode ? { permissionMode } : {}),
-        ...(permissionMode === "bypassPermissions"
-          ? { allowDangerouslySkipPermissions: true }
-          : {}),
-        ...(Object.keys(settings).length > 0 ? { settings } : {}),
-        ...(existingResumeSessionId ? { resume: existingResumeSessionId } : {}),
-        ...(newSessionId ? { sessionId: newSessionId } : {}),
-        includePartialMessages: true,
-        canUseTool,
-        onUserDialog,
-        supportedDialogKinds: ["resume_return"],
-        env: claudeEnvironment,
-        additionalDirectories,
-        ...(Object.keys(extraArgs).length > 0 ? { extraArgs } : {}),
-        ...(mcpSession
-          ? {
-              mcpServers: {
-                "t3-code": {
-                  type: "http",
-                  url: mcpSession.endpoint,
-                  headers: {
-                    Authorization: mcpSession.authorizationHeader,
-                  },
-                },
-              },
-            }
-          : {}),
-      };
-
-      yield* Effect.annotateCurrentSpan({
-        "provider.kind": PROVIDER,
-        "provider.thread_id": threadId,
-        "provider.runtime_mode": input.runtimeMode,
-        "claude.resume.source":
-          existingResumeSessionId !== undefined ? "resume-session" : "generated-session",
-        "claude.resume.thread_id": resumeState?.threadId ?? "",
-        "claude.resume.session_id": existingResumeSessionId ?? "",
-        "claude.resume.session_at": resumeState?.resumeSessionAt ?? "",
-        "claude.resume.turn_count": resumeState?.turnCount ?? -1,
-        "claude.query.cwd": input.cwd ?? "",
-        "claude.query.model": apiModelId ?? "",
-        "claude.query.effort": effectiveEffort ?? "",
-        "claude.query.permission_mode": permissionMode ?? "",
-        "claude.query.allow_dangerously_skip_permissions": permissionMode === "bypassPermissions",
-        "claude.query.resume": existingResumeSessionId ?? "",
-        "claude.query.session_id": newSessionId ?? "",
-        "claude.query.include_partial_messages": true,
-        "claude.query.additional_directories": additionalDirectories,
-        "claude.query.setting_sources": [...CLAUDE_SETTING_SOURCES],
-        "claude.query.settings_json": encodeJsonStringForDiagnostics(settings) ?? "",
-        "claude.query.extra_args_json": encodeJsonStringForDiagnostics(extraArgs) ?? "",
-        "claude.query.path_to_executable": claudeBinaryPath,
-      });
-
-      const queryRuntime = yield* Effect.try({
-        try: () =>
-          createQuery({
-            prompt,
-            options: queryOptions,
-          }),
-        catch: (cause) =>
-          new ProviderAdapterProcessError({
-            provider: PROVIDER,
-            threadId,
-            detail: "Failed to start Claude runtime session.",
-            cause,
-          }),
-      });
-
-      const session: ProviderSession = {
-        threadId,
-        provider: PROVIDER,
-        providerInstanceId: boundInstanceId,
-        status: "ready",
-        runtimeMode: input.runtimeMode,
-        ...(input.cwd ? { cwd: input.cwd } : {}),
-        ...(modelSelection?.model ? { model: modelSelection.model } : {}),
-        ...(threadId ? { threadId } : {}),
-        resumeCursor: {
-          ...(threadId ? { threadId } : {}),
-          ...(sessionId ? { resume: sessionId } : {}),
-          ...(resumeState?.resumeSessionAt ? { resumeSessionAt: resumeState.resumeSessionAt } : {}),
-          turnCount: resumeState?.turnCount ?? 0,
-        },
-        createdAt: startedAt,
-        updatedAt: startedAt,
-      };
-
-      const context: ClaudeSessionContext = {
-        session,
-        promptQueue,
-        query: queryRuntime,
-        streamFiber: undefined,
-        startedAt,
-        basePermissionMode: permissionMode,
-        currentApiModelId: apiModelId,
-        currentEffort: effectiveEffort ?? undefined,
-        resumeSessionId: sessionId,
-        pendingApprovals,
-        pendingUserInputs,
-        turns: [],
-        inFlightTools,
-        claudeTasks,
-        taskAgents,
-        pendingTaskModels,
-        workflowMemberFingerprints,
-        liveTaskIds,
-        turnState: undefined,
-        lastKnownContextWindow: initialContextWindow,
-        lastKnownTokenUsage: undefined,
-        lastKnownTotalProcessedTokens: undefined,
-        lastAssistantUuid: resumeState?.resumeSessionAt,
-        lastThreadStartedId: undefined,
-        stopped: false,
-      };
-      yield* Ref.set(contextRef, context);
-      sessions.set(threadId, context);
-
-      const sessionStartedStamp = yield* makeEventStamp();
-      yield* offerRuntimeEvent({
-        type: "session.started",
-        eventId: sessionStartedStamp.eventId,
-        provider: PROVIDER,
-        createdAt: sessionStartedStamp.createdAt,
-        threadId,
-        payload: input.resumeCursor !== undefined ? { resume: input.resumeCursor } : {},
-        providerRefs: {},
-      });
-
-      const configuredStamp = yield* makeEventStamp();
-      yield* offerRuntimeEvent({
-        type: "session.configured",
-        eventId: configuredStamp.eventId,
-        provider: PROVIDER,
-        createdAt: configuredStamp.createdAt,
-        threadId,
-        payload: {
-          config: {
-            ...(apiModelId ? { model: apiModelId } : {}),
-            ...(input.cwd ? { cwd: input.cwd } : {}),
-            ...(effectiveEffort ? { effort: effectiveEffort } : {}),
-            ...(permissionMode ? { permissionMode } : {}),
-            ...(fastMode ? { fastMode: true } : {}),
-          },
-        },
-        providerRefs: {},
-      });
-
-      const readyStamp = yield* makeEventStamp();
-      yield* offerRuntimeEvent({
-        type: "session.state.changed",
-        eventId: readyStamp.eventId,
-        provider: PROVIDER,
-        createdAt: readyStamp.createdAt,
-        threadId,
-        payload: {
-          state: "ready",
-        },
-        providerRefs: {},
-      });
-
-      let streamFiber: Fiber.Fiber<void, never>;
-      streamFiber = runFork(
-        Effect.exit(runSdkStream(context)).pipe(
-          Effect.flatMap((exit) => {
-            if (context.stopped) {
-              return Effect.void;
-            }
-            if (context.streamFiber === streamFiber) {
-              context.streamFiber = undefined;
-            }
-            return handleStreamExit(context, exit).pipe(
-              Effect.catch((cause) =>
-                Effect.logError("Failed to close Claude runtime stream.", { cause }),
-              ),
-            );
-          }),
-        ),
-      );
-      context.streamFiber = streamFiber;
-      streamFiber.addObserver(() => {
-        if (context.streamFiber === streamFiber) {
-          context.streamFiber = undefined;
-        }
-      });
-
-      return {
-        ...session,
-      };
-    },
-  );
-
-  const sendTurn: ClaudeAdapterShape["sendTurn"] = Effect.fn("sendTurn")(function* (input) {
-    const context = yield* requireSession(input.threadId);
-    const modelSelection =
-      input.modelSelection !== undefined && input.modelSelection.instanceId === boundInstanceId
-        ? input.modelSelection
-        : undefined;
-
-    // A sendTurn while a real turn is running is a steer: the message is
-    // queued into the live SDK agent loop and the work continues as the same
-    // turn — no synthetic turn boundary. Stale synthetic turns (from
-    // background agent responses between user prompts) are auto-closed
-    // instead, so they don't block the user's next turn.
-    const steeringTurnState =
-      context.turnState && context.turnState.synthetic !== true ? context.turnState : null;
-    if (context.turnState && steeringTurnState === null) {
-      yield* completeTurn(context, "completed");
-    }
-
-    if (modelSelection?.model) {
-      const apiModelId = resolveClaudeApiModelId(modelSelection);
-      if (context.currentApiModelId !== apiModelId) {
-        yield* Effect.tryPromise({
-          try: () => context.query.setModel(apiModelId),
-          catch: (cause) => toRequestError(input.threadId, "turn/setModel", cause),
-        });
-        context.currentApiModelId = apiModelId;
-      }
-      context.session = {
-        ...context.session,
-        model: modelSelection.model,
-      };
-      const turnCaps = getClaudeModelCapabilities(modelSelection.model);
-      const turnEffort = resolveClaudeEffort(
-        turnCaps,
-        getModelSelectionStringOptionValue(modelSelection, "effort"),
-      );
-      context.currentEffort =
-        getEffectiveClaudeAgentEffort(turnEffort ?? null, modelSelection.model) ?? undefined;
-    }
-
-    // Apply interaction mode by switching the SDK's permission mode.
-    // "plan" maps directly to the SDK's "plan" permission mode;
-    // "default" restores the session's original permission mode.
-    // When interactionMode is absent we leave the current mode unchanged.
-    if (input.interactionMode === "plan") {
-      yield* Effect.tryPromise({
-        try: () => context.query.setPermissionMode("plan"),
-        catch: (cause) => toRequestError(input.threadId, "turn/setPermissionMode", cause),
-      });
-    } else if (input.interactionMode === "default") {
-      yield* Effect.tryPromise({
-        try: () => context.query.setPermissionMode(context.basePermissionMode ?? "default"),
-        catch: (cause) => toRequestError(input.threadId, "turn/setPermissionMode", cause),
-      });
-    }
-
-    const turnId = steeringTurnState?.turnId ?? TurnId.make(yield* randomUUIDv4);
-    if (steeringTurnState === null) {
-      const turnState: ClaudeTurnState = {
-        turnId,
-        startedAt: yield* nowIso,
-        items: [],
-        assistantTextBlocks: new Map(),
-        assistantTextBlockOrder: [],
-        capturedProposedPlanKeys: new Set(),
-        latestAssistantUsage: undefined,
-        compactedSinceLatestAssistantUsage: false,
-        nextSyntheticAssistantBlockIndex: -1,
-      };
-
-      const updatedAt = yield* nowIso;
-      context.turnState = turnState;
-      context.session = {
-        ...context.session,
-        status: "running",
-        activeTurnId: turnId,
-        updatedAt,
-      };
-
-      const turnStartedStamp = yield* makeEventStamp();
-      yield* offerRuntimeEvent({
-        type: "turn.started",
-        eventId: turnStartedStamp.eventId,
-        provider: PROVIDER,
-        createdAt: turnStartedStamp.createdAt,
-        threadId: context.session.threadId,
-        turnId,
-        payload: modelSelection?.model ? { model: modelSelection.model } : {},
-        providerRefs: {},
-      });
-    }
-
-    const message = yield* buildUserMessageEffect(input, {
-      fileSystem,
-      attachmentsDir: serverConfig.attachmentsDir,
-      boundInstanceId,
-    });
-
-    yield* Queue.offer(context.promptQueue, {
-      type: "message",
-      message,
-    }).pipe(Effect.mapError((cause) => toRequestError(input.threadId, "turn/start", cause)));
-
-    return {
-      threadId: context.session.threadId,
-      turnId,
-      ...(context.session.resumeCursor !== undefined
-        ? { resumeCursor: context.session.resumeCursor }
-        : {}),
-    };
-  });
-
-  const interruptTurn: ClaudeAdapterShape["interruptTurn"] = Effect.fn("interruptTurn")(
-    function* (threadId, _turnId) {
-      const context = yield* requireSession(threadId);
-      // interrupt() can acknowledge while resumed background tasks keep the
-      // CLI alive. Stop is a hard session boundary for Claude, so close the
-      // query and let the SDK escalate to SIGKILL when graceful exit fails.
-      yield* stopSessionInternal(context);
-    },
-  );
-
-  const readThread: ClaudeAdapterShape["readThread"] = Effect.fn("readThread")(
-    function* (threadId) {
-      const context = yield* requireSession(threadId);
-      return yield* snapshotThread(context);
-    },
-  );
-
-  const rollbackThread: ClaudeAdapterShape["rollbackThread"] = Effect.fn("rollbackThread")(
-    function* (threadId, numTurns) {
-      const context = yield* requireSession(threadId);
-      const nextLength = Math.max(0, context.turns.length - numTurns);
-      context.turns.splice(nextLength);
-      yield* updateResumeCursor(context);
-      return yield* snapshotThread(context);
-    },
-  );
-
-  const respondToRequest: ClaudeAdapterShape["respondToRequest"] = Effect.fn("respondToRequest")(
-    function* (threadId, requestId, decision) {
-      const context = yield* requireSession(threadId);
-      const pending = context.pendingApprovals.get(requestId);
-      if (!pending) {
-        return yield* new ProviderAdapterRequestError({
-          provider: PROVIDER,
-          method: "item/requestApproval/decision",
-          detail: `Unknown pending approval request: ${requestId}`,
-        });
-      }
-
-      context.pendingApprovals.delete(requestId);
-      yield* Deferred.succeed(pending.decision, decision);
-    },
-  );
-
-  const respondToUserInput: ClaudeAdapterShape["respondToUserInput"] = Effect.fn(
-    "respondToUserInput",
-  )(function* (threadId, requestId, answers) {
-    const context = yield* requireSession(threadId);
-    const pending = context.pendingUserInputs.get(requestId);
-    if (!pending) {
-      return yield* new ProviderAdapterRequestError({
-        provider: PROVIDER,
-        method: "item/tool/respondToUserInput",
-        detail: `Unknown pending user-input request: ${requestId}`,
-      });
-    }
-
-    context.pendingUserInputs.delete(requestId);
-    yield* Deferred.succeed(pending.answers, answers);
-  });
-
-  const stopSession: ClaudeAdapterShape["stopSession"] = Effect.fn("stopSession")(
-    function* (threadId) {
-      const context = yield* requireSession(threadId);
-      yield* stopSessionInternal(context, {
-        emitExitEvent: true,
-      });
-    },
-  );
-
-  const listSessions: ClaudeAdapterShape["listSessions"] = () =>
-    Effect.sync(() => Array.from(sessions.values(), ({ session }) => ({ ...session })));
-
-  const hasSession: ClaudeAdapterShape["hasSession"] = (threadId) =>
-    Effect.sync(() => {
-      const context = sessions.get(threadId);
-      return context !== undefined && !context.stopped;
-    });
-
-  const stopSessions = Effect.fn("stopSessions")(function* (
-    contexts: ReadonlyArray<ClaudeSessionContext>,
-    emitExitEvent: boolean,
-  ) {
-    const results = yield* Effect.forEach(contexts, (context) =>
-      stopSessionInternal(context, { emitExitEvent }).pipe(Effect.result),
-    );
-
-    for (const result of results) {
-      if (result._tag === "Failure") {
-        return yield* Effect.fail(result.failure);
-      }
-    }
-  });
-
-  const stopAll: ClaudeAdapterShape["stopAll"] = () =>
-    stopSessions(Array.from(sessions.values()), true);
-
-  yield* Effect.addFinalizer(() =>
-    stopSessions(Array.from(sessions.values()), false).pipe(
-      Effect.catch((cause) =>
-        Effect.logError("Failed to emit Claude session shutdown event.", { cause }),
-      ),
-      Effect.tap(() => Queue.shutdown(runtimeEventQueue)),
-      Effect.tap(() => managedNativeEventLogger?.close() ?? Effect.void),
-    ),
-  );
-
-  return {
-    provider: PROVIDER,
-    capabilities: {
-      sessionModelSwitch: "in-session",
-    },
-    startSession,
-    sendTurn,
-    interruptTurn,
-    readThread,
-    rollbackThread,
-    respondToRequest,
-    respondToUserInput,
-    stopSession,
-    listSessions,
-    hasSession,
-    stopAll,
-    get streamEvents() {
-      return Stream.fromQueue(runtimeEventQueue);
-    },
-  } satisfies ClaudeAdapterShape;
-});
diff --git a/apps/server/src/provider/Layers/CodexAdapter.test.ts b/apps/server/src/provider/Layers/CodexAdapter.test.ts
deleted file mode 100644
index f01192f8d707..000000000000
--- a/apps/server/src/provider/Layers/CodexAdapter.test.ts
+++ /dev/null
@@ -1,1684 +0,0 @@
-// @effect-diagnostics nodeBuiltinImport:off
-import * as NodeAssert from "node:assert/strict";
-import * as NodeFS from "node:fs";
-import * as NodeOS from "node:os";
-import * as NodePath from "node:path";
-import {
-  ApprovalRequestId,
-  CodexSettings,
-  EventId,
-  ProviderDriverKind,
-  ProviderInstanceId,
-  ProviderItemId,
-  type ProviderApprovalDecision,
-  type ProviderEvent,
-  type ProviderSession,
-  type ProviderTurnStartResult,
-  type ProviderUserInputAnswers,
-  ThreadId,
-  TurnId,
-} from "@t3tools/contracts";
-import { createModelSelection } from "@t3tools/shared/model";
-import * as NodeServices from "@effect/platform-node/NodeServices";
-import { it, vi } from "@effect/vitest";
-
-import * as Context from "effect/Context";
-import * as Effect from "effect/Effect";
-import * as Exit from "effect/Exit";
-import * as Fiber from "effect/Fiber";
-import * as Layer from "effect/Layer";
-import * as Option from "effect/Option";
-import * as Queue from "effect/Queue";
-import * as Schema from "effect/Schema";
-import * as Scope from "effect/Scope";
-import * as Stream from "effect/Stream";
-import * as TestClock from "effect/testing/TestClock";
-import * as CodexErrors from "effect-codex-app-server/errors";
-
-import { ServerConfig } from "../../config.ts";
-import { ServerSettingsService } from "../../serverSettings.ts";
-import { ProviderAdapterValidationError } from "../Errors.ts";
-import type { CodexAdapterShape } from "../Services/CodexAdapter.ts";
-import { ProviderSessionDirectory } from "../Services/ProviderSessionDirectory.ts";
-import {
-  type CodexSessionRuntimeOptions,
-  type CodexSessionRuntimeSendTurnInput,
-  type CodexSessionRuntimeShape,
-  type CodexThreadSnapshot,
-} from "./CodexSessionRuntime.ts";
-import { makeCodexAdapter } from "./CodexAdapter.ts";
-const decodeCodexSettings = Schema.decodeSync(CodexSettings);
-
-// Test-local service tag so the rest of the file can keep using `yield* CodexAdapter`.
-class CodexAdapter extends Context.Service<CodexAdapter, CodexAdapterShape>()(
-  "t3/provider/Layers/CodexAdapter.test/CodexAdapter",
-) {}
-
-const asThreadId = (value: string): ThreadId => ThreadId.make(value);
-const asTurnId = (value: string): TurnId => TurnId.make(value);
-const asEventId = (value: string): EventId => EventId.make(value);
-const asItemId = (value: string): ProviderItemId => ProviderItemId.make(value);
-
-class FakeCodexRuntime implements CodexSessionRuntimeShape {
-  private readonly eventQueue = Effect.runSync(Queue.unbounded<ProviderEvent>());
-  private readonly now = "2026-01-01T00:00:00.000Z";
-
-  public readonly startImpl = vi.fn(() =>
-    Promise.resolve({
-      provider: ProviderDriverKind.make("codex"),
-      status: "ready" as const,
-      runtimeMode: this.options.runtimeMode,
-      threadId: this.options.threadId,
-      cwd: this.options.cwd,
-      ...(this.options.model ? { model: this.options.model } : {}),
-      createdAt: this.now,
-      updatedAt: this.now,
-    } satisfies ProviderSession),
-  );
-
-  public readonly sendTurnImpl = vi.fn(
-    (_input: CodexSessionRuntimeSendTurnInput): Promise<ProviderTurnStartResult> =>
-      Promise.resolve({
-        threadId: this.options.threadId,
-        turnId: asTurnId("turn-1"),
-      }),
-  );
-
-  public readonly interruptTurnImpl = vi.fn(
-    (_turnId?: TurnId): Promise<void> => Promise.resolve(undefined),
-  );
-
-  public readonly readThreadImpl = vi.fn(
-    (): Promise<CodexThreadSnapshot> =>
-      Promise.resolve({
-        threadId: "provider-thread-1",
-        turns: [],
-      }),
-  );
-
-  public readonly rollbackThreadImpl = vi.fn(
-    (_numTurns: number): Promise<CodexThreadSnapshot> =>
-      Promise.resolve({
-        threadId: "provider-thread-1",
-        turns: [],
-      }),
-  );
-
-  public readonly uploadFeedbackImpl = vi.fn((_reason?: string) =>
-    Promise.resolve({ threadId: "provider-thread-1" }),
-  );
-
-  public readonly respondToRequestImpl = vi.fn(
-    (_requestId: ApprovalRequestId, _decision: ProviderApprovalDecision): Promise<void> =>
-      Promise.resolve(undefined),
-  );
-
-  public readonly respondToUserInputImpl = vi.fn(
-    (_requestId: ApprovalRequestId, _answers: ProviderUserInputAnswers): Promise<void> =>
-      Promise.resolve(undefined),
-  );
-
-  public readonly closeImpl = vi.fn(() => Promise.resolve(undefined));
-
-  readonly options: CodexSessionRuntimeOptions;
-
-  constructor(options: CodexSessionRuntimeOptions) {
-    this.options = options;
-  }
-
-  start() {
-    return Effect.promise(() => this.startImpl());
-  }
-
-  getSession = Effect.promise(() => this.startImpl());
-
-  sendTurn(input: CodexSessionRuntimeSendTurnInput) {
-    return Effect.promise(() => this.sendTurnImpl(input));
-  }
-
-  interruptTurn(turnId?: TurnId) {
-    return Effect.promise(() => this.interruptTurnImpl(turnId));
-  }
-
-  readThread = Effect.promise(() => this.readThreadImpl());
-
-  rollbackThread(numTurns: number) {
-    return Effect.promise(() => this.rollbackThreadImpl(numTurns));
-  }
-
-  uploadFeedback(reason?: string) {
-    return Effect.promise(() => this.uploadFeedbackImpl(reason));
-  }
-
-  respondToRequest(requestId: ApprovalRequestId, decision: ProviderApprovalDecision) {
-    return Effect.promise(() => this.respondToRequestImpl(requestId, decision));
-  }
-
-  respondToUserInput(requestId: ApprovalRequestId, answers: ProviderUserInputAnswers) {
-    return Effect.promise(() => this.respondToUserInputImpl(requestId, answers));
-  }
-
-  get events() {
-    return Stream.fromQueue(this.eventQueue);
-  }
-
-  close = Effect.promise(() => this.closeImpl());
-
-  emit(event: ProviderEvent) {
-    return Queue.offer(this.eventQueue, event).pipe(Effect.asVoid);
-  }
-}
-
-function makeRuntimeFactory() {
-  const runtimes: Array<FakeCodexRuntime> = [];
-  const factory = vi.fn((options: CodexSessionRuntimeOptions) => {
-    const runtime = new FakeCodexRuntime(options);
-    runtimes.push(runtime);
-    return Effect.succeed(runtime);
-  });
-
-  return {
-    factory,
-    get lastRuntime(): FakeCodexRuntime | undefined {
-      return runtimes.at(-1);
-    },
-  };
-}
-
-function makeScopedRuntimeFactory(options?: { readonly failConstruction?: boolean }) {
-  const runtimes: Array<FakeCodexRuntime> = [];
-  const releasedThreadIds: Array<ThreadId> = [];
-
-  const factory = vi.fn((runtimeOptions: CodexSessionRuntimeOptions) =>
-    Effect.gen(function* () {
-      yield* Scope.Scope;
-      yield* Effect.addFinalizer(() =>
-        Effect.sync(() => {
-          releasedThreadIds.push(runtimeOptions.threadId);
-        }),
-      );
-
-      if (options?.failConstruction) {
-        return yield* new CodexErrors.CodexAppServerSpawnError({
-          command: `${runtimeOptions.binaryPath} app-server`,
-          cause: new Error("runtime construction failed"),
-        });
-      }
-
-      const runtime = new FakeCodexRuntime(runtimeOptions);
-      runtimes.push(runtime);
-      return runtime;
-    }),
-  );
-
-  return {
-    factory,
-    releasedThreadIds,
-    get lastRuntime(): FakeCodexRuntime | undefined {
-      return runtimes.at(-1);
-    },
-  };
-}
-
-const providerSessionDirectoryTestLayer = Layer.succeed(ProviderSessionDirectory, {
-  upsert: () => Effect.void,
-  getProvider: () =>
-    Effect.die(new Error("ProviderSessionDirectory.getProvider is not used in test")),
-  getBinding: () => Effect.succeed(Option.none()),
-  listThreadIds: () => Effect.succeed([]),
-  listBindings: () => Effect.succeed([]),
-});
-
-const validationRuntimeFactory = makeRuntimeFactory();
-const validationLayer = it.layer(
-  Layer.effect(
-    CodexAdapter,
-    Effect.gen(function* () {
-      const codexConfig = decodeCodexSettings({});
-      return yield* makeCodexAdapter(codexConfig, {
-        makeRuntime: validationRuntimeFactory.factory,
-      });
-    }),
-  ).pipe(
-    Layer.provideMerge(ServerConfig.layerTest(process.cwd(), process.cwd())),
-    Layer.provideMerge(ServerSettingsService.layerTest()),
-    Layer.provideMerge(providerSessionDirectoryTestLayer),
-    Layer.provideMerge(NodeServices.layer),
-  ),
-);
-
-validationLayer("CodexAdapterLive validation", (it) => {
-  it.effect("returns validation error for non-codex provider on startSession", () =>
-    Effect.gen(function* () {
-      const adapter = yield* CodexAdapter;
-      const result = yield* adapter
-        .startSession({
-          provider: ProviderDriverKind.make("claudeAgent"),
-          threadId: asThreadId("thread-1"),
-          runtimeMode: "full-access",
-        })
-        .pipe(Effect.result);
-
-      NodeAssert.equal(result._tag, "Failure");
-      NodeAssert.deepStrictEqual(
-        result.failure,
-        new ProviderAdapterValidationError({
-          provider: ProviderDriverKind.make("codex"),
-          operation: "startSession",
-          issue: "Expected provider 'codex' but received 'claudeAgent'.",
-        }),
-      );
-      NodeAssert.equal(validationRuntimeFactory.factory.mock.calls.length, 0);
-    }),
-  );
-  it.effect("maps codex model options before starting a session", () =>
-    Effect.gen(function* () {
-      validationRuntimeFactory.factory.mockClear();
-      const adapter = yield* CodexAdapter;
-
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("codex"),
-        threadId: asThreadId("thread-1"),
-        modelSelection: createModelSelection(ProviderInstanceId.make("codex"), "gpt-5.3-codex", [
-          { id: "serviceTier", value: "priority" },
-        ]),
-        runtimeMode: "full-access",
-      });
-
-      NodeAssert.deepStrictEqual(validationRuntimeFactory.factory.mock.calls[0]?.[0], {
-        binaryPath: "codex",
-        cwd: process.cwd(),
-        launchArgs: "",
-        model: "gpt-5.3-codex",
-        providerInstanceId: ProviderInstanceId.make("codex"),
-        serviceTier: "priority",
-        threadId: asThreadId("thread-1"),
-        runtimeMode: "full-access",
-      });
-    }),
-  );
-});
-
-const sessionRuntimeFactory = makeRuntimeFactory();
-const sessionErrorLayer = it.layer(
-  Layer.effect(
-    CodexAdapter,
-    Effect.gen(function* () {
-      const codexConfig = decodeCodexSettings({});
-      return yield* makeCodexAdapter(codexConfig, {
-        makeRuntime: sessionRuntimeFactory.factory,
-      });
-    }),
-  ).pipe(
-    Layer.provideMerge(ServerConfig.layerTest(process.cwd(), process.cwd())),
-    Layer.provideMerge(ServerSettingsService.layerTest()),
-    Layer.provideMerge(providerSessionDirectoryTestLayer),
-    Layer.provideMerge(NodeServices.layer),
-  ),
-);
-
-sessionErrorLayer("CodexAdapterLive session errors", (it) => {
-  it.effect("maps missing adapter sessions to ProviderAdapterSessionNotFoundError", () =>
-    Effect.gen(function* () {
-      const adapter = yield* CodexAdapter;
-      const result = yield* adapter
-        .sendTurn({
-          threadId: asThreadId("sess-missing"),
-          input: "hello",
-          attachments: [],
-        })
-        .pipe(Effect.result);
-
-      NodeAssert.equal(result._tag, "Failure");
-      NodeAssert.equal(result.failure._tag, "ProviderAdapterSessionNotFoundError");
-      NodeAssert.equal(result.failure.provider, "codex");
-      NodeAssert.equal(result.failure.threadId, "sess-missing");
-    }),
-  );
-
-  it.effect("uploads feedback for the active Codex thread", () =>
-    Effect.gen(function* () {
-      const adapter = yield* CodexAdapter;
-      const threadId = asThreadId("thread-feedback");
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("codex"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-      const runtime = sessionRuntimeFactory.lastRuntime;
-      NodeAssert.ok(runtime);
-
-      const result = yield* adapter.uploadFeedback({
-        threadId,
-        reason: "The agent stopped early.",
-      });
-
-      NodeAssert.deepStrictEqual(result, { feedbackId: "provider-thread-1" });
-      NodeAssert.deepStrictEqual(runtime.uploadFeedbackImpl.mock.calls, [
-        ["The agent stopped early."],
-      ]);
-    }),
-  );
-
-  it.effect("rejects feedback for an unknown Codex thread", () =>
-    Effect.gen(function* () {
-      const adapter = yield* CodexAdapter;
-      const result = yield* adapter
-        .uploadFeedback({ threadId: asThreadId("thread-feedback-missing") })
-        .pipe(Effect.result);
-
-      NodeAssert.equal(result._tag, "Failure");
-      NodeAssert.equal(result.failure._tag, "ProviderAdapterSessionNotFoundError");
-    }),
-  );
-
-  it.effect("maps codex model options before sending a turn", () =>
-    Effect.gen(function* () {
-      const adapter = yield* CodexAdapter;
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("codex"),
-        threadId: asThreadId("sess-missing"),
-        runtimeMode: "full-access",
-      });
-      const runtime = sessionRuntimeFactory.lastRuntime;
-      NodeAssert.ok(runtime);
-      runtime.sendTurnImpl.mockClear();
-
-      yield* Effect.ignore(
-        adapter.sendTurn({
-          threadId: asThreadId("sess-missing"),
-          input: "hello",
-          modelSelection: createModelSelection(ProviderInstanceId.make("codex"), "gpt-5.3-codex", [
-            { id: "reasoningEffort", value: "high" },
-            { id: "serviceTier", value: "priority" },
-          ]),
-          attachments: [],
-        }),
-      );
-
-      NodeAssert.deepStrictEqual(runtime.sendTurnImpl.mock.calls[0]?.[0], {
-        input: "hello",
-        model: "gpt-5.3-codex",
-        effort: "high",
-        serviceTier: "priority",
-      });
-    }),
-  );
-
-  it.effect("passes configured launch args into the session runtime", () => {
-    const runtimeFactory = makeRuntimeFactory();
-    const layer = Layer.effect(
-      CodexAdapter,
-      Effect.gen(function* () {
-        const codexConfig = decodeCodexSettings({ launchArgs: "--strict-config --enable foo" });
-        return yield* makeCodexAdapter(codexConfig, {
-          makeRuntime: runtimeFactory.factory,
-        });
-      }),
-    ).pipe(
-      Layer.provideMerge(ServerConfig.layerTest(process.cwd(), process.cwd())),
-      Layer.provideMerge(ServerSettingsService.layerTest()),
-      Layer.provideMerge(providerSessionDirectoryTestLayer),
-      Layer.provideMerge(NodeServices.layer),
-    );
-
-    return Effect.gen(function* () {
-      const adapter = yield* CodexAdapter;
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("codex"),
-        threadId: asThreadId("sess-launch-args"),
-        runtimeMode: "full-access",
-      });
-
-      const runtime = runtimeFactory.lastRuntime;
-      NodeAssert.ok(runtime);
-      NodeAssert.equal(runtime.options.launchArgs, "--strict-config --enable foo");
-    }).pipe(Effect.provide(layer));
-  });
-
-  it.effect("uses T3CODE_CODEX_LAUNCH_ARGS for the session runtime", () => {
-    const runtimeFactory = makeRuntimeFactory();
-    const layer = Layer.effect(
-      CodexAdapter,
-      Effect.gen(function* () {
-        const codexConfig = decodeCodexSettings({ launchArgs: "--enable settings-feature" });
-        return yield* makeCodexAdapter(codexConfig, {
-          environment: { T3CODE_CODEX_LAUNCH_ARGS: " --strict-config --enable env-feature " },
-          makeRuntime: runtimeFactory.factory,
-        });
-      }),
-    ).pipe(
-      Layer.provideMerge(ServerConfig.layerTest(process.cwd(), process.cwd())),
-      Layer.provideMerge(ServerSettingsService.layerTest()),
-      Layer.provideMerge(providerSessionDirectoryTestLayer),
-      Layer.provideMerge(NodeServices.layer),
-    );
-
-    return Effect.gen(function* () {
-      const adapter = yield* CodexAdapter;
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("codex"),
-        threadId: asThreadId("sess-launch-args-env"),
-        runtimeMode: "full-access",
-      });
-
-      const runtime = runtimeFactory.lastRuntime;
-      NodeAssert.ok(runtime);
-      NodeAssert.equal(runtime.options.launchArgs, "--strict-config --enable env-feature");
-    }).pipe(Effect.provide(layer));
-  });
-
-  it.effect("maps codex model options for the adapter's bound custom instance id", () => {
-    const customInstanceId = ProviderInstanceId.make("codex_personal");
-    const customRuntimeFactory = makeRuntimeFactory();
-    const customLayer = Layer.effect(
-      CodexAdapter,
-      Effect.gen(function* () {
-        const codexConfig = decodeCodexSettings({});
-        return yield* makeCodexAdapter(codexConfig, {
-          instanceId: customInstanceId,
-          makeRuntime: customRuntimeFactory.factory,
-        });
-      }),
-    ).pipe(
-      Layer.provideMerge(ServerConfig.layerTest(process.cwd(), process.cwd())),
-      Layer.provideMerge(ServerSettingsService.layerTest()),
-      Layer.provideMerge(providerSessionDirectoryTestLayer),
-      Layer.provideMerge(NodeServices.layer),
-    );
-
-    return Effect.gen(function* () {
-      const adapter = yield* CodexAdapter;
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("codex"),
-        threadId: asThreadId("sess-custom-instance"),
-        runtimeMode: "full-access",
-      });
-      const runtime = customRuntimeFactory.lastRuntime;
-      NodeAssert.ok(runtime);
-      runtime.sendTurnImpl.mockClear();
-
-      yield* Effect.ignore(
-        adapter.sendTurn({
-          threadId: asThreadId("sess-custom-instance"),
-          input: "hello",
-          modelSelection: createModelSelection(
-            ProviderInstanceId.make("codex_personal"),
-            "gpt-5.3-codex",
-            [
-              { id: "reasoningEffort", value: "high" },
-              { id: "serviceTier", value: "flex" },
-            ],
-          ),
-          attachments: [],
-        }),
-      );
-
-      NodeAssert.deepStrictEqual(runtime.sendTurnImpl.mock.calls[0]?.[0], {
-        input: "hello",
-        model: "gpt-5.3-codex",
-        effort: "high",
-        serviceTier: "flex",
-      });
-    }).pipe(Effect.provide(customLayer));
-  });
-});
-
-const lifecycleRuntimeFactory = makeRuntimeFactory();
-const lifecycleLayer = it.layer(
-  Layer.effect(
-    CodexAdapter,
-    Effect.gen(function* () {
-      const codexConfig = decodeCodexSettings({});
-      return yield* makeCodexAdapter(codexConfig, {
-        makeRuntime: lifecycleRuntimeFactory.factory,
-      });
-    }),
-  ).pipe(
-    Layer.provideMerge(ServerConfig.layerTest(process.cwd(), process.cwd())),
-    Layer.provideMerge(ServerSettingsService.layerTest()),
-    Layer.provideMerge(providerSessionDirectoryTestLayer),
-    Layer.provideMerge(NodeServices.layer),
-  ),
-);
-
-function startLifecycleRuntime() {
-  return Effect.gen(function* () {
-    const adapter = yield* CodexAdapter;
-    yield* adapter.startSession({
-      provider: ProviderDriverKind.make("codex"),
-      threadId: asThreadId("thread-1"),
-      runtimeMode: "full-access",
-    });
-    const runtime = lifecycleRuntimeFactory.lastRuntime;
-    NodeAssert.ok(runtime);
-    return { adapter, runtime };
-  });
-}
-
-lifecycleLayer("CodexAdapterLive lifecycle", (it) => {
-  it.effect("carries child model metadata through every task event", () =>
-    Effect.gen(function* () {
-      const { adapter, runtime } = yield* startLifecycleRuntime();
-      const eventsFiber = yield* Stream.runCollect(Stream.take(adapter.streamEvents, 10)).pipe(
-        Effect.forkChild,
-      );
-
-      const cases = [
-        ["collabAgent/started", {}],
-        ["collabAgent/activity", { activityKind: "started" }],
-        ["collabAgent/turnStarted", {}],
-        ["collabAgent/turnCompleted", { turn: { status: "completed" } }],
-        ["collabAgent/statusChanged", { status: { type: "active", activeFlags: [] } }],
-        ["collabAgent/tokenUsage", { tokenUsage: { total: { totalTokens: 42 } } }],
-        ["collabAgent/item", { item: { type: "commandExecution", command: "pwd" } }],
-        ["collabAgent/closed", {}],
-        ["collabAgent/metadataUpdated", {}],
-      ] as const;
-
-      for (const [index, [method, extra]] of cases.entries()) {
-        yield* runtime.emit({
-          id: asEventId(`evt-child-model-${index}`),
-          kind: "notification",
-          provider: ProviderDriverKind.make("codex"),
-          createdAt: "2026-01-01T00:00:00.000Z",
-          method,
-          threadId: asThreadId("thread-1"),
-          turnId: asTurnId("turn-1"),
-          payload: {
-            agentThreadId: "child-model",
-            agentPath: "/root/model-check",
-            model: " gpt-5.6-sol ",
-            effort: " high ",
-            ...extra,
-          },
-        });
-      }
-      yield* runtime.emit({
-        id: asEventId("evt-child-model-blank"),
-        kind: "notification",
-        provider: ProviderDriverKind.make("codex"),
-        createdAt: "2026-01-01T00:00:00.000Z",
-        method: "collabAgent/metadataUpdated",
-        threadId: asThreadId("thread-1"),
-        turnId: asTurnId("turn-1"),
-        payload: {
-          agentThreadId: "child-model",
-          model: "  ",
-          effort: "",
-        },
-      });
-
-      const events = Array.from(yield* Fiber.join(eventsFiber));
-      NodeAssert.deepStrictEqual(
-        events.map((event) => event.type),
-        [
-          "task.started",
-          "task.started",
-          "task.updated",
-          "task.updated",
-          "task.updated",
-          "task.progress",
-          "task.progress",
-          "task.updated",
-          "task.updated",
-          "task.updated",
-        ],
-      );
-      for (const event of events.slice(0, -1)) {
-        const payload = event.payload as Record<string, unknown>;
-        NodeAssert.equal(payload.model, "gpt-5.6-sol");
-        NodeAssert.equal(payload.effort, "high");
-      }
-
-      const metadataPayload = events[8]?.payload as Record<string, unknown>;
-      NodeAssert.equal("status" in metadataPayload, false);
-      const blankMetadataPayload = events[9]?.payload as Record<string, unknown>;
-      NodeAssert.equal("status" in blankMetadataPayload, false);
-      NodeAssert.equal("model" in blankMetadataPayload, false);
-      NodeAssert.equal("effort" in blankMetadataPayload, false);
-    }),
-  );
-
-  it.effect("does not reactivate an idle child after a parent interaction", () =>
-    Effect.gen(function* () {
-      const { adapter, runtime } = yield* startLifecycleRuntime();
-      const eventsFiber = yield* Stream.runCollect(Stream.take(adapter.streamEvents, 3)).pipe(
-        Effect.forkChild,
-      );
-
-      const childEvent = (id: string, method: string, payload: Record<string, unknown>) => ({
-        id: asEventId(id),
-        kind: "notification" as const,
-        provider: ProviderDriverKind.make("codex"),
-        createdAt: "2026-01-01T00:00:00.000Z",
-        method,
-        threadId: asThreadId("thread-1"),
-        turnId: asTurnId("turn-1"),
-        payload,
-      });
-
-      yield* runtime.emit(
-        childEvent("evt-child-running", "collabAgent/turnStarted", {
-          agentThreadId: "child-1",
-          agentPath: "/root/audit",
-        }),
-      );
-      yield* runtime.emit(
-        childEvent("evt-child-idle", "collabAgent/turnCompleted", {
-          agentThreadId: "child-1",
-          agentPath: "/root/audit",
-          turn: { status: "completed" },
-        }),
-      );
-      yield* runtime.emit(
-        childEvent("evt-child-interacted", "collabAgent/activity", {
-          agentThreadId: "child-1",
-          agentPath: "/root/audit",
-          activityKind: "interacted",
-        }),
-      );
-      yield* runtime.emit(
-        childEvent("evt-other-child-running", "collabAgent/turnStarted", {
-          agentThreadId: "child-2",
-          agentPath: "/root/other",
-        }),
-      );
-
-      const events = Array.from(yield* Fiber.join(eventsFiber));
-      NodeAssert.deepStrictEqual(
-        events.map((event) =>
-          event.type === "task.updated"
-            ? { taskId: event.payload.taskId, status: event.payload.status }
-            : { type: event.type },
-        ),
-        [
-          { taskId: "child-1", status: "running" },
-          { taskId: "child-1", status: "idle" },
-          { taskId: "child-2", status: "running" },
-        ],
-      );
-    }),
-  );
-
-  it.effect("maps completed agent message items to canonical item.completed events", () =>
-    Effect.gen(function* () {
-      const { adapter, runtime } = yield* startLifecycleRuntime();
-      const firstEventFiber = yield* Stream.runHead(adapter.streamEvents).pipe(Effect.forkChild);
-
-      const event: ProviderEvent = {
-        id: asEventId("evt-msg-complete"),
-        kind: "notification",
-        provider: ProviderDriverKind.make("codex"),
-        createdAt: "2026-01-01T00:00:00.000Z",
-        method: "item/completed",
-        threadId: asThreadId("thread-1"),
-        turnId: asTurnId("turn-1"),
-        itemId: asItemId("msg_1"),
-        payload: {
-          completedAtMs: 1_778_000_000_000,
-          threadId: "thread-1",
-          turnId: "turn-1",
-          item: {
-            type: "agentMessage",
-            id: "msg_1",
-            text: "done",
-          },
-        },
-      };
-
-      yield* runtime.emit(event);
-      const firstEvent = yield* Fiber.join(firstEventFiber);
-
-      NodeAssert.equal(firstEvent._tag, "Some");
-      if (firstEvent._tag !== "Some") {
-        return;
-      }
-      NodeAssert.equal(firstEvent.value.type, "item.completed");
-      if (firstEvent.value.type !== "item.completed") {
-        return;
-      }
-      NodeAssert.equal(firstEvent.value.itemId, "msg_1");
-      NodeAssert.equal(firstEvent.value.turnId, "turn-1");
-      NodeAssert.equal(firstEvent.value.payload.itemType, "assistant_message");
-    }),
-  );
-
-  it.effect("labels MCP lifecycle entries with server and tool names", () =>
-    Effect.gen(function* () {
-      const { adapter, runtime } = yield* startLifecycleRuntime();
-      const firstEventFiber = yield* Stream.runHead(adapter.streamEvents).pipe(Effect.forkChild);
-
-      yield* runtime.emit({
-        id: asEventId("evt-mcp-complete"),
-        kind: "notification",
-        provider: ProviderDriverKind.make("codex"),
-        createdAt: "2026-01-01T00:00:00.000Z",
-        method: "item/completed",
-        threadId: asThreadId("thread-1"),
-        turnId: asTurnId("turn-1"),
-        itemId: asItemId("mcp_1"),
-        payload: {
-          completedAtMs: 1_778_000_000_000,
-          threadId: "thread-1",
-          turnId: "turn-1",
-          item: {
-            type: "mcpToolCall",
-            id: "mcp_1",
-            server: "t3-code",
-            tool: "preview_status",
-            arguments: {},
-            durationMs: 12,
-            error: null,
-            result: { content: [{ type: "text", text: "attached" }] },
-            status: "completed",
-          },
-        },
-      });
-      const firstEvent = yield* Fiber.join(firstEventFiber);
-
-      NodeAssert.equal(firstEvent._tag, "Some");
-      if (firstEvent._tag !== "Some" || firstEvent.value.type !== "item.completed") {
-        return;
-      }
-      NodeAssert.equal(firstEvent.value.payload.itemType, "mcp_tool_call");
-      NodeAssert.equal(firstEvent.value.payload.title, "t3-code · preview_status");
-      NodeAssert.deepStrictEqual(firstEvent.value.payload.data, {
-        completedAtMs: 1_778_000_000_000,
-        threadId: "thread-1",
-        turnId: "turn-1",
-        item: {
-          type: "mcpToolCall",
-          id: "mcp_1",
-          server: "t3-code",
-          tool: "preview_status",
-          arguments: {},
-          durationMs: 12,
-          error: null,
-          result: { content: [{ type: "text", text: "attached" }] },
-          status: "completed",
-        },
-      });
-    }),
-  );
-
-  it.effect("preserves failed and declined outcomes on completed tool items", () =>
-    Effect.gen(function* () {
-      const { adapter, runtime } = yield* startLifecycleRuntime();
-      const items = [
-        {
-          type: "commandExecution",
-          id: "failed-command",
-          command: "vp test run",
-          commandActions: [],
-          cwd: "/tmp",
-          exitCode: 1,
-          status: "failed",
-        },
-        {
-          type: "mcpToolCall",
-          id: "failed-mcp",
-          server: "simulator",
-          tool: "build",
-          arguments: {},
-          error: { message: "Build failed" },
-          status: "failed",
-        },
-        {
-          type: "fileChange",
-          id: "declined-change",
-          changes: [],
-          status: "declined",
-        },
-      ] as const;
-
-      for (const item of items) {
-        const firstEventFiber = yield* Stream.runHead(adapter.streamEvents).pipe(Effect.forkChild);
-
-        yield* runtime.emit({
-          id: asEventId(`evt-${item.id}`),
-          kind: "notification",
-          provider: ProviderDriverKind.make("codex"),
-          createdAt: "2026-01-01T00:00:00.000Z",
-          method: "item/completed",
-          threadId: asThreadId("thread-1"),
-          turnId: asTurnId("turn-1"),
-          itemId: asItemId(item.id),
-          payload: {
-            completedAtMs: 1_778_000_000_000,
-            threadId: "thread-1",
-            turnId: "turn-1",
-            item,
-          },
-        });
-
-        const firstEvent = yield* Fiber.join(firstEventFiber);
-        NodeAssert.equal(firstEvent._tag, "Some");
-        if (firstEvent._tag !== "Some" || firstEvent.value.type !== "item.completed") {
-          return;
-        }
-        NodeAssert.equal(firstEvent.value.payload.status, item.status);
-      }
-    }),
-  );
-
-  it.effect("maps completed plan items to canonical proposed-plan completion events", () =>
-    Effect.gen(function* () {
-      const { adapter, runtime } = yield* startLifecycleRuntime();
-      const firstEventFiber = yield* Stream.runHead(adapter.streamEvents).pipe(Effect.forkChild);
-
-      const event: ProviderEvent = {
-        id: asEventId("evt-plan-complete"),
-        kind: "notification",
-        provider: ProviderDriverKind.make("codex"),
-        createdAt: "2026-01-01T00:00:00.000Z",
-        method: "item/completed",
-        threadId: asThreadId("thread-1"),
-        turnId: asTurnId("turn-1"),
-        itemId: asItemId("plan_1"),
-        payload: {
-          completedAtMs: 1_778_000_000_000,
-          threadId: "thread-1",
-          turnId: "turn-1",
-          item: {
-            type: "plan",
-            id: "plan_1",
-            text: "## Final plan\n\n- one\n- two",
-          },
-        },
-      };
-
-      yield* runtime.emit(event);
-      const firstEvent = yield* Fiber.join(firstEventFiber);
-
-      NodeAssert.equal(firstEvent._tag, "Some");
-      if (firstEvent._tag !== "Some") {
-        return;
-      }
-      NodeAssert.equal(firstEvent.value.type, "turn.proposed.completed");
-      if (firstEvent.value.type !== "turn.proposed.completed") {
-        return;
-      }
-      NodeAssert.equal(firstEvent.value.turnId, "turn-1");
-      NodeAssert.equal(firstEvent.value.payload.planMarkdown, "## Final plan\n\n- one\n- two");
-    }),
-  );
-
-  it.effect("maps plan deltas to canonical proposed-plan delta events", () =>
-    Effect.gen(function* () {
-      const { adapter, runtime } = yield* startLifecycleRuntime();
-      const firstEventFiber = yield* Stream.runHead(adapter.streamEvents).pipe(Effect.forkChild);
-
-      yield* runtime.emit({
-        id: asEventId("evt-plan-delta"),
-        kind: "notification",
-        provider: ProviderDriverKind.make("codex"),
-        createdAt: "2026-01-01T00:00:00.000Z",
-        method: "item/plan/delta",
-        threadId: asThreadId("thread-1"),
-        turnId: asTurnId("turn-1"),
-        itemId: asItemId("plan_1"),
-        payload: {
-          threadId: "thread-1",
-          turnId: "turn-1",
-          itemId: "plan_1",
-          delta: "## Final plan",
-        },
-      } satisfies ProviderEvent);
-
-      const firstEvent = yield* Fiber.join(firstEventFiber);
-
-      NodeAssert.equal(firstEvent._tag, "Some");
-      if (firstEvent._tag !== "Some") {
-        return;
-      }
-      NodeAssert.equal(firstEvent.value.type, "turn.proposed.delta");
-      if (firstEvent.value.type !== "turn.proposed.delta") {
-        return;
-      }
-      NodeAssert.equal(firstEvent.value.turnId, "turn-1");
-      NodeAssert.equal(firstEvent.value.payload.delta, "## Final plan");
-    }),
-  );
-
-  it.effect("maps session/closed lifecycle events to canonical session.exited runtime events", () =>
-    Effect.gen(function* () {
-      const { adapter, runtime } = yield* startLifecycleRuntime();
-      const firstEventFiber = yield* Stream.runHead(adapter.streamEvents).pipe(Effect.forkChild);
-
-      const event: ProviderEvent = {
-        id: asEventId("evt-session-closed"),
-        kind: "session",
-        provider: ProviderDriverKind.make("codex"),
-        threadId: asThreadId("thread-1"),
-        createdAt: "2026-01-01T00:00:00.000Z",
-        method: "session/closed",
-        message: "Session stopped",
-      };
-
-      yield* runtime.emit(event);
-      const firstEvent = yield* Fiber.join(firstEventFiber);
-
-      NodeAssert.equal(firstEvent._tag, "Some");
-      if (firstEvent._tag !== "Some") {
-        return;
-      }
-      NodeAssert.equal(firstEvent.value.type, "session.exited");
-      if (firstEvent.value.type !== "session.exited") {
-        return;
-      }
-      NodeAssert.equal(firstEvent.value.threadId, "thread-1");
-      NodeAssert.equal(firstEvent.value.payload.reason, "Session stopped");
-    }),
-  );
-
-  it.effect("maps retryable Codex error notifications to runtime.warning", () =>
-    Effect.gen(function* () {
-      const { adapter, runtime } = yield* startLifecycleRuntime();
-      const firstEventFiber = yield* Stream.runHead(adapter.streamEvents).pipe(Effect.forkChild);
-
-      yield* runtime.emit({
-        id: asEventId("evt-retryable-error"),
-        kind: "notification",
-        provider: ProviderDriverKind.make("codex"),
-        threadId: asThreadId("thread-1"),
-        createdAt: "2026-01-01T00:00:00.000Z",
-        method: "error",
-        turnId: asTurnId("turn-1"),
-        payload: {
-          threadId: "thread-1",
-          turnId: "turn-1",
-          error: {
-            message: "Reconnecting... 2/5",
-          },
-          willRetry: true,
-        },
-      } satisfies ProviderEvent);
-
-      const firstEvent = yield* Fiber.join(firstEventFiber);
-
-      NodeAssert.equal(firstEvent._tag, "Some");
-      if (firstEvent._tag !== "Some") {
-        return;
-      }
-      NodeAssert.equal(firstEvent.value.type, "runtime.warning");
-      if (firstEvent.value.type !== "runtime.warning") {
-        return;
-      }
-      NodeAssert.equal(firstEvent.value.turnId, "turn-1");
-      NodeAssert.equal(firstEvent.value.payload.message, "Reconnecting... 2/5");
-    }),
-  );
-
-  it.effect("maps process stderr notifications to runtime.warning", () =>
-    Effect.gen(function* () {
-      const { adapter, runtime } = yield* startLifecycleRuntime();
-      const firstEventFiber = yield* Stream.runHead(adapter.streamEvents).pipe(Effect.forkChild);
-
-      yield* runtime.emit({
-        id: asEventId("evt-process-stderr"),
-        kind: "notification",
-        provider: ProviderDriverKind.make("codex"),
-        threadId: asThreadId("thread-1"),
-        createdAt: "2026-01-01T00:00:00.000Z",
-        method: "process/stderr",
-        turnId: asTurnId("turn-1"),
-        message: "The filename or extension is too long. (os error 206)",
-      } satisfies ProviderEvent);
-
-      const firstEvent = yield* Fiber.join(firstEventFiber);
-
-      NodeAssert.equal(firstEvent._tag, "Some");
-      if (firstEvent._tag !== "Some") {
-        return;
-      }
-      NodeAssert.equal(firstEvent.value.type, "runtime.warning");
-      if (firstEvent.value.type !== "runtime.warning") {
-        return;
-      }
-      NodeAssert.equal(firstEvent.value.turnId, "turn-1");
-      NodeAssert.equal(
-        firstEvent.value.payload.message,
-        "The filename or extension is too long. (os error 206)",
-      );
-    }),
-  );
-
-  it.effect("maps realtime started notifications with upstream realtime session ids", () =>
-    Effect.gen(function* () {
-      const { adapter, runtime } = yield* startLifecycleRuntime();
-      const firstEventFiber = yield* Stream.runHead(adapter.streamEvents).pipe(Effect.forkChild);
-
-      yield* runtime.emit({
-        id: asEventId("evt-realtime-started"),
-        kind: "notification",
-        provider: ProviderDriverKind.make("codex"),
-        threadId: asThreadId("thread-1"),
-        createdAt: "2026-01-01T00:00:00.000Z",
-        method: "thread/realtime/started",
-        payload: {
-          threadId: "thread-1",
-          realtimeSessionId: "realtime-session-1",
-          version: "v2",
-        },
-      } satisfies ProviderEvent);
-
-      const firstEvent = yield* Fiber.join(firstEventFiber);
-
-      NodeAssert.equal(firstEvent._tag, "Some");
-      if (firstEvent._tag !== "Some") {
-        return;
-      }
-      NodeAssert.equal(firstEvent.value.type, "thread.realtime.started");
-      if (firstEvent.value.type !== "thread.realtime.started") {
-        return;
-      }
-      NodeAssert.equal(firstEvent.value.threadId, "thread-1");
-      NodeAssert.equal(firstEvent.value.payload.realtimeSessionId, "realtime-session-1");
-    }),
-  );
-
-  it.effect("maps fatal websocket stderr notifications to runtime.error", () =>
-    Effect.gen(function* () {
-      const { adapter, runtime } = yield* startLifecycleRuntime();
-      const firstEventFiber = yield* Stream.runHead(adapter.streamEvents).pipe(Effect.forkChild);
-
-      yield* runtime.emit({
-        id: asEventId("evt-process-stderr-websocket"),
-        kind: "notification",
-        provider: ProviderDriverKind.make("codex"),
-        threadId: asThreadId("thread-1"),
-        createdAt: "2026-01-01T00:00:00.000Z",
-        method: "process/stderr",
-        turnId: asTurnId("turn-1"),
-        message:
-          "2026-03-31T18:14:06.833399Z ERROR codex_api::endpoint::responses_websocket: failed to connect to websocket: HTTP error: 503 Service Unavailable, url: wss://chatgpt.com/backend-api/codex/responses",
-      } satisfies ProviderEvent);
-
-      const firstEvent = yield* Fiber.join(firstEventFiber);
-
-      NodeAssert.equal(firstEvent._tag, "Some");
-      if (firstEvent._tag !== "Some") {
-        return;
-      }
-      NodeAssert.equal(firstEvent.value.type, "runtime.error");
-      if (firstEvent.value.type !== "runtime.error") {
-        return;
-      }
-      NodeAssert.equal(firstEvent.value.turnId, "turn-1");
-      NodeAssert.equal(firstEvent.value.payload.class, "provider_error");
-      NodeAssert.equal(
-        firstEvent.value.payload.message,
-        "2026-03-31T18:14:06.833399Z ERROR codex_api::endpoint::responses_websocket: failed to connect to websocket: HTTP error: 503 Service Unavailable, url: wss://chatgpt.com/backend-api/codex/responses",
-      );
-    }),
-  );
-
-  it.effect("preserves request type when mapping serverRequest/resolved", () =>
-    Effect.gen(function* () {
-      const { adapter, runtime } = yield* startLifecycleRuntime();
-      const firstEventFiber = yield* Stream.runHead(adapter.streamEvents).pipe(Effect.forkChild);
-
-      const event: ProviderEvent = {
-        id: asEventId("evt-request-resolved"),
-        kind: "notification",
-        provider: ProviderDriverKind.make("codex"),
-        threadId: asThreadId("thread-1"),
-        createdAt: "2026-01-01T00:00:00.000Z",
-        method: "serverRequest/resolved",
-        requestKind: "command",
-        requestId: ApprovalRequestId.make("req-1"),
-        payload: {
-          threadId: "thread-1",
-          requestId: "req-1",
-        },
-      };
-
-      yield* runtime.emit(event);
-      const firstEvent = yield* Fiber.join(firstEventFiber);
-
-      NodeAssert.equal(firstEvent._tag, "Some");
-      if (firstEvent._tag !== "Some") {
-        return;
-      }
-      NodeAssert.equal(firstEvent.value.type, "request.resolved");
-      if (firstEvent.value.type !== "request.resolved") {
-        return;
-      }
-      NodeAssert.equal(firstEvent.value.payload.requestType, "command_execution_approval");
-    }),
-  );
-
-  it.effect("maps MCP elicitation requests into app access approvals", () =>
-    Effect.gen(function* () {
-      const { adapter, runtime } = yield* startLifecycleRuntime();
-      const firstEventFiber = yield* Stream.runHead(adapter.streamEvents).pipe(Effect.forkChild);
-
-      yield* runtime.emit({
-        id: asEventId("evt-mcp-elicitation"),
-        kind: "request",
-        provider: ProviderDriverKind.make("codex"),
-        threadId: asThreadId("thread-1"),
-        createdAt: "2026-08-24T00:00:00.000Z",
-        method: "mcpServer/elicitation/request",
-        requestKind: "mcp-elicitation",
-        requestId: ApprovalRequestId.make("req-safari"),
-        turnId: asTurnId("turn-1"),
-        payload: {
-          mode: "form",
-          message: "Allow ChatGPT to use Safari?",
-          serverName: "computer-use",
-          threadId: "provider-thread-1",
-          turnId: "turn-1",
-          _meta: { app_name: "Safari", persist: ["session", "always"] },
-          requestedSchema: { type: "object", properties: {} },
-        },
-      } satisfies ProviderEvent);
-
-      const firstEvent = yield* Fiber.join(firstEventFiber);
-
-      NodeAssert.equal(firstEvent._tag, "Some");
-      if (firstEvent._tag !== "Some" || firstEvent.value.type !== "request.opened") {
-        return;
-      }
-      NodeAssert.equal(firstEvent.value.payload.requestType, "mcp_elicitation_approval");
-      NodeAssert.equal(firstEvent.value.payload.appName, "Safari");
-      NodeAssert.equal(firstEvent.value.payload.detail, "Allow ChatGPT to use Safari?");
-      NodeAssert.deepStrictEqual(firstEvent.value.payload.options, [
-        { decision: "cancel", label: "Cancel" },
-        { decision: "decline", label: "Decline" },
-        { decision: "acceptForSession", label: "Always allow this session" },
-        { decision: "acceptAlways", label: "Always allow" },
-        { decision: "accept", label: "Approve" },
-      ]);
-    }),
-  );
-
-  it.effect("preserves MCP elicitation type when an app access request resolves", () =>
-    Effect.gen(function* () {
-      const { adapter, runtime } = yield* startLifecycleRuntime();
-      const firstEventFiber = yield* Stream.runHead(adapter.streamEvents).pipe(Effect.forkChild);
-
-      yield* runtime.emit({
-        id: asEventId("evt-mcp-elicitation-resolved"),
-        kind: "notification",
-        provider: ProviderDriverKind.make("codex"),
-        threadId: asThreadId("thread-1"),
-        createdAt: "2026-08-24T00:00:00.000Z",
-        method: "item/requestApproval/decision",
-        requestKind: "mcp-elicitation",
-        requestId: ApprovalRequestId.make("req-safari"),
-        payload: { decision: "acceptAlways" },
-      } satisfies ProviderEvent);
-
-      const firstEvent = yield* Fiber.join(firstEventFiber);
-
-      NodeAssert.equal(firstEvent._tag, "Some");
-      if (firstEvent._tag !== "Some" || firstEvent.value.type !== "request.resolved") {
-        return;
-      }
-      NodeAssert.equal(firstEvent.value.payload.requestType, "mcp_elicitation_approval");
-      NodeAssert.equal(firstEvent.value.payload.decision, "acceptAlways");
-    }),
-  );
-
-  it.effect("preserves file-read request type when mapping serverRequest/resolved", () =>
-    Effect.gen(function* () {
-      const { adapter, runtime } = yield* startLifecycleRuntime();
-      const firstEventFiber = yield* Stream.runHead(adapter.streamEvents).pipe(Effect.forkChild);
-
-      const event: ProviderEvent = {
-        id: asEventId("evt-file-read-request-resolved"),
-        kind: "notification",
-        provider: ProviderDriverKind.make("codex"),
-        threadId: asThreadId("thread-1"),
-        createdAt: "2026-01-01T00:00:00.000Z",
-        method: "serverRequest/resolved",
-        requestKind: "file-read",
-        requestId: ApprovalRequestId.make("req-file-read-1"),
-        payload: {
-          threadId: "thread-1",
-          requestId: "req-file-read-1",
-        },
-      };
-
-      yield* runtime.emit(event);
-      const firstEvent = yield* Fiber.join(firstEventFiber);
-
-      NodeAssert.equal(firstEvent._tag, "Some");
-      if (firstEvent._tag !== "Some") {
-        return;
-      }
-      NodeAssert.equal(firstEvent.value.type, "request.resolved");
-      if (firstEvent.value.type !== "request.resolved") {
-        return;
-      }
-      NodeAssert.equal(firstEvent.value.payload.requestType, "file_read_approval");
-    }),
-  );
-
-  it.effect("preserves explicit empty multi-select user-input answers", () =>
-    Effect.gen(function* () {
-      const { adapter, runtime } = yield* startLifecycleRuntime();
-      const firstEventFiber = yield* Stream.runHead(adapter.streamEvents).pipe(Effect.forkChild);
-
-      const event: ProviderEvent = {
-        id: asEventId("evt-user-input-empty"),
-        kind: "notification",
-        provider: ProviderDriverKind.make("codex"),
-        threadId: asThreadId("thread-1"),
-        createdAt: "2026-01-01T00:00:00.000Z",
-        method: "item/tool/requestUserInput/answered",
-        payload: {
-          answers: {
-            scope: {
-              answers: [],
-            },
-          },
-        },
-      };
-
-      yield* runtime.emit(event);
-      const firstEvent = yield* Fiber.join(firstEventFiber);
-
-      NodeAssert.equal(firstEvent._tag, "Some");
-      if (firstEvent._tag !== "Some") {
-        return;
-      }
-      NodeAssert.equal(firstEvent.value.type, "user-input.resolved");
-      if (firstEvent.value.type !== "user-input.resolved") {
-        return;
-      }
-      NodeAssert.deepEqual(firstEvent.value.payload.answers, {
-        scope: [],
-      });
-    }),
-  );
-
-  it.effect("maps windowsSandbox/setupCompleted to session state and warning on failure", () =>
-    Effect.gen(function* () {
-      const { adapter, runtime } = yield* startLifecycleRuntime();
-      const eventsFiber = yield* Stream.runCollect(Stream.take(adapter.streamEvents, 2)).pipe(
-        Effect.forkChild,
-      );
-
-      const event: ProviderEvent = {
-        id: asEventId("evt-windows-sandbox-failed"),
-        kind: "notification",
-        provider: ProviderDriverKind.make("codex"),
-        threadId: asThreadId("thread-1"),
-        createdAt: "2026-01-01T00:00:00.000Z",
-        method: "windowsSandbox/setupCompleted",
-        message: "Sandbox setup failed",
-        payload: {
-          mode: "unelevated",
-          success: false,
-          error: "unsupported environment",
-        },
-      };
-
-      yield* runtime.emit(event);
-      const events = Array.from(yield* Fiber.join(eventsFiber));
-
-      NodeAssert.equal(events.length, 2);
-
-      const firstEvent = events[0];
-      const secondEvent = events[1];
-
-      NodeAssert.equal(firstEvent?.type, "session.state.changed");
-      if (firstEvent?.type === "session.state.changed") {
-        NodeAssert.equal(firstEvent.payload.state, "error");
-        NodeAssert.equal(firstEvent.payload.reason, "Sandbox setup failed");
-      }
-
-      NodeAssert.equal(secondEvent?.type, "runtime.warning");
-      if (secondEvent?.type === "runtime.warning") {
-        NodeAssert.equal(secondEvent.payload.message, "Sandbox setup failed");
-      }
-    }),
-  );
-
-  it.effect(
-    "maps requestUserInput requests and answered notifications to canonical user-input events",
-    () =>
-      Effect.gen(function* () {
-        const { adapter, runtime } = yield* startLifecycleRuntime();
-        const eventsFiber = yield* Stream.runCollect(Stream.take(adapter.streamEvents, 2)).pipe(
-          Effect.forkChild,
-        );
-
-        yield* runtime.emit({
-          id: asEventId("evt-user-input-requested"),
-          kind: "request",
-          provider: ProviderDriverKind.make("codex"),
-          threadId: asThreadId("thread-1"),
-          createdAt: "2026-01-01T00:00:00.000Z",
-          method: "item/tool/requestUserInput",
-          requestId: ApprovalRequestId.make("req-user-input-1"),
-          payload: {
-            itemId: "item-user-input-1",
-            threadId: "thread-1",
-            turnId: "turn-1",
-            questions: [
-              {
-                id: "sandbox_mode",
-                header: "Sandbox",
-                question: "Which mode should be used?",
-                options: [
-                  {
-                    label: "workspace-write",
-                    description: "Allow workspace writes only",
-                  },
-                ],
-              },
-            ],
-          },
-        } satisfies ProviderEvent);
-        yield* runtime.emit({
-          id: asEventId("evt-user-input-resolved"),
-          kind: "notification",
-          provider: ProviderDriverKind.make("codex"),
-          threadId: asThreadId("thread-1"),
-          createdAt: "2026-01-01T00:00:00.000Z",
-          method: "item/tool/requestUserInput/answered",
-          requestId: ApprovalRequestId.make("req-user-input-1"),
-          payload: {
-            answers: {
-              sandbox_mode: {
-                answers: ["workspace-write"],
-              },
-            },
-          },
-        } satisfies ProviderEvent);
-
-        const events = Array.from(yield* Fiber.join(eventsFiber));
-        NodeAssert.equal(events[0]?.type, "user-input.requested");
-        if (events[0]?.type === "user-input.requested") {
-          NodeAssert.equal(events[0].requestId, "req-user-input-1");
-          NodeAssert.equal(events[0].payload.questions[0]?.id, "sandbox_mode");
-          NodeAssert.equal(events[0].payload.questions[0]?.multiSelect, false);
-        }
-
-        NodeAssert.equal(events[1]?.type, "user-input.resolved");
-        if (events[1]?.type === "user-input.resolved") {
-          NodeAssert.equal(events[1].requestId, "req-user-input-1");
-          NodeAssert.deepEqual(events[1].payload.answers, {
-            sandbox_mode: "workspace-write",
-          });
-        }
-      }),
-  );
-
-  it.effect("unwraps Codex token usage payloads for context window events", () =>
-    Effect.gen(function* () {
-      const { adapter, runtime } = yield* startLifecycleRuntime();
-      const firstEventFiber = yield* Stream.runHead(adapter.streamEvents).pipe(Effect.forkChild);
-
-      yield* runtime.emit({
-        id: asEventId("evt-codex-thread-token-usage-updated"),
-        kind: "notification",
-        provider: ProviderDriverKind.make("codex"),
-        threadId: asThreadId("thread-1"),
-        turnId: asTurnId("turn-1"),
-        createdAt: "2026-01-01T00:00:00.000Z",
-        method: "thread/tokenUsage/updated",
-        payload: {
-          threadId: "thread-1",
-          turnId: "turn-1",
-          tokenUsage: {
-            total: {
-              inputTokens: 11_833,
-              cachedInputTokens: 3456,
-              outputTokens: 6,
-              reasoningOutputTokens: 0,
-              totalTokens: 11_839,
-            },
-            last: {
-              inputTokens: 120,
-              cachedInputTokens: 0,
-              outputTokens: 6,
-              reasoningOutputTokens: 0,
-              totalTokens: 126,
-            },
-            modelContextWindow: 258_400,
-          },
-        },
-      } satisfies ProviderEvent);
-
-      const firstEvent = yield* Fiber.join(firstEventFiber);
-      NodeAssert.equal(firstEvent._tag, "Some");
-      if (firstEvent._tag !== "Some") {
-        return;
-      }
-      NodeAssert.equal(firstEvent.value.type, "thread.token-usage.updated");
-      if (firstEvent.value.type !== "thread.token-usage.updated") {
-        return;
-      }
-
-      NodeAssert.deepEqual(firstEvent.value.payload.usage, {
-        usedTokens: 126,
-        totalProcessedTokens: 11_839,
-        maxTokens: 258_400,
-        inputTokens: 120,
-        cachedInputTokens: 0,
-        outputTokens: 6,
-        reasoningOutputTokens: 0,
-        lastUsedTokens: 126,
-        lastInputTokens: 120,
-        lastCachedInputTokens: 0,
-        lastOutputTokens: 6,
-        lastReasoningOutputTokens: 0,
-        compactsAutomatically: true,
-      });
-    }),
-  );
-
-  // Production calls startSession from a request fiber that finishes as soon as
-  // the session exists. `Effect.forkChild` made the runtime event consumer a
-  // child of that fiber, and Effect interrupts a fiber's children when it
-  // completes, so the consumer died on return and every event the session
-  // emitted afterwards was dropped. The other tests here start the session from
-  // the test fiber, which never completes, so the consumer survived and the bug
-  // stayed invisible. Starting it in a fiber that finishes reproduces
-  // production.
-  it.effect("keeps consuming runtime events after the startSession fiber completes", () =>
-    Effect.gen(function* () {
-      const adapter = yield* CodexAdapter;
-      const startSessionFiber = yield* adapter
-        .startSession({
-          provider: ProviderDriverKind.make("codex"),
-          threadId: asThreadId("thread-outlives-start"),
-          runtimeMode: "full-access",
-        })
-        .pipe(Effect.forkChild);
-      yield* Fiber.join(startSessionFiber);
-
-      const runtime = lifecycleRuntimeFactory.lastRuntime;
-      NodeAssert.ok(runtime);
-
-      const firstEventFiber = yield* Stream.runHead(adapter.streamEvents).pipe(Effect.forkChild);
-      yield* runtime.emit({
-        id: asEventId("evt-after-start-session"),
-        kind: "notification",
-        provider: ProviderDriverKind.make("codex"),
-        createdAt: "2026-01-01T00:00:00.000Z",
-        method: "item/completed",
-        threadId: asThreadId("thread-outlives-start"),
-        turnId: asTurnId("turn-1"),
-        itemId: asItemId("msg_after_start"),
-        payload: {
-          completedAtMs: 1_778_000_000_000,
-          threadId: "thread-outlives-start",
-          turnId: "turn-1",
-          item: {
-            type: "agentMessage",
-            id: "msg_after_start",
-            text: "emitted after startSession returned",
-          },
-        },
-      });
-
-      const firstEvent = yield* Fiber.join(firstEventFiber).pipe(Effect.timeout("10 seconds"));
-      NodeAssert.equal(firstEvent._tag, "Some");
-      if (firstEvent._tag !== "Some") {
-        return;
-      }
-      NodeAssert.equal(firstEvent.value.type, "item.completed");
-      // Live clock so the timeout above is real: under the default test clock it
-      // waits on virtual time that never advances, and a regression would hang
-      // until the suite timeout instead of failing here.
-    }).pipe(TestClock.withLive),
-  );
-});
-
-const scopedLifecycleRuntimeFactory = makeScopedRuntimeFactory();
-const scopedLifecycleLayer = it.layer(
-  Layer.effect(
-    CodexAdapter,
-    Effect.gen(function* () {
-      const codexConfig = decodeCodexSettings({});
-      return yield* makeCodexAdapter(codexConfig, {
-        makeRuntime: scopedLifecycleRuntimeFactory.factory,
-      });
-    }),
-  ).pipe(
-    Layer.provideMerge(ServerConfig.layerTest(process.cwd(), process.cwd())),
-    Layer.provideMerge(ServerSettingsService.layerTest()),
-    Layer.provideMerge(providerSessionDirectoryTestLayer),
-    Layer.provideMerge(NodeServices.layer),
-  ),
-);
-
-scopedLifecycleLayer("CodexAdapterLive scoped lifecycle", (it) => {
-  it.effect("closes the externally owned session scope on stopSession", () =>
-    Effect.gen(function* () {
-      scopedLifecycleRuntimeFactory.releasedThreadIds.length = 0;
-      const adapter = yield* CodexAdapter;
-
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("codex"),
-        threadId: asThreadId("thread-stop"),
-        runtimeMode: "full-access",
-      });
-
-      const runtime = scopedLifecycleRuntimeFactory.lastRuntime;
-      NodeAssert.ok(runtime);
-
-      yield* adapter.stopSession(asThreadId("thread-stop"));
-
-      NodeAssert.equal(runtime.closeImpl.mock.calls.length, 1);
-      NodeAssert.deepStrictEqual(scopedLifecycleRuntimeFactory.releasedThreadIds, [
-        asThreadId("thread-stop"),
-      ]);
-      NodeAssert.equal(yield* adapter.hasSession(asThreadId("thread-stop")), false);
-    }),
-  );
-});
-
-const scopedFailureRuntimeFactory = makeScopedRuntimeFactory({ failConstruction: true });
-const scopedFailureLayer = it.layer(
-  Layer.effect(
-    CodexAdapter,
-    Effect.gen(function* () {
-      const codexConfig = decodeCodexSettings({});
-      return yield* makeCodexAdapter(codexConfig, {
-        makeRuntime: scopedFailureRuntimeFactory.factory,
-      });
-    }),
-  ).pipe(
-    Layer.provideMerge(ServerConfig.layerTest(process.cwd(), process.cwd())),
-    Layer.provideMerge(ServerSettingsService.layerTest()),
-    Layer.provideMerge(providerSessionDirectoryTestLayer),
-    Layer.provideMerge(NodeServices.layer),
-  ),
-);
-
-scopedFailureLayer("CodexAdapterLive scoped startup failure", (it) => {
-  it.effect("closes the externally owned session scope when startSession fails", () =>
-    Effect.gen(function* () {
-      scopedFailureRuntimeFactory.releasedThreadIds.length = 0;
-      const adapter = yield* CodexAdapter;
-
-      const result = yield* adapter
-        .startSession({
-          provider: ProviderDriverKind.make("codex"),
-          threadId: asThreadId("thread-fail"),
-          runtimeMode: "full-access",
-        })
-        .pipe(Effect.result);
-
-      NodeAssert.equal(result._tag, "Failure");
-      NodeAssert.equal(result.failure._tag, "ProviderAdapterProcessError");
-      NodeAssert.deepStrictEqual(scopedFailureRuntimeFactory.releasedThreadIds, [
-        asThreadId("thread-fail"),
-      ]);
-      NodeAssert.equal(yield* adapter.hasSession(asThreadId("thread-fail")), false);
-    }),
-  );
-});
-
-it.effect("flushes managed native logs when the adapter layer shuts down", () =>
-  Effect.gen(function* () {
-    const tempDir = NodeFS.mkdtempSync(
-      NodePath.join(NodeOS.tmpdir(), "t3-codex-adapter-native-log-"),
-    );
-    const basePath = NodePath.join(tempDir, "provider-native.ndjson");
-    const runtimeFactory = makeRuntimeFactory();
-    const scope = yield* Scope.make("sequential");
-    let scopeClosed = false;
-
-    try {
-      const layer = Layer.effect(
-        CodexAdapter,
-        Effect.gen(function* () {
-          const codexConfig = decodeCodexSettings({});
-          return yield* makeCodexAdapter(codexConfig, {
-            makeRuntime: runtimeFactory.factory,
-            nativeEventLogPath: basePath,
-          });
-        }),
-      ).pipe(
-        Layer.provideMerge(ServerConfig.layerTest(process.cwd(), process.cwd())),
-        Layer.provideMerge(ServerSettingsService.layerTest()),
-        Layer.provideMerge(providerSessionDirectoryTestLayer),
-        Layer.provideMerge(NodeServices.layer),
-      );
-      const context = yield* Layer.buildWithScope(layer, scope);
-      const adapter = yield* Effect.service(CodexAdapter).pipe(Effect.provide(context));
-
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("codex"),
-        threadId: asThreadId("thread-logger"),
-        runtimeMode: "full-access",
-      });
-
-      const runtime = runtimeFactory.lastRuntime;
-      NodeAssert.ok(runtime);
-
-      const firstEventFiber = yield* Stream.runHead(adapter.streamEvents).pipe(Effect.forkChild);
-      yield* runtime.emit({
-        id: asEventId("evt-native-log"),
-        kind: "notification",
-        provider: ProviderDriverKind.make("codex"),
-        threadId: asThreadId("thread-logger"),
-        createdAt: "2026-01-01T00:00:00.000Z",
-        method: "process/stderr",
-        message: "native flush test",
-      } satisfies ProviderEvent);
-      yield* Fiber.join(firstEventFiber);
-
-      yield* Scope.close(scope, Exit.void);
-      scopeClosed = true;
-
-      const threadLogPath = NodePath.join(tempDir, "provider-native.thread-logger.log");
-      NodeAssert.equal(NodeFS.existsSync(threadLogPath), true);
-      const contents = NodeFS.readFileSync(threadLogPath, "utf8");
-      NodeAssert.match(contents, /NTIVE: .*"message":"native flush test"/);
-    } finally {
-      if (!scopeClosed) {
-        yield* Scope.close(scope, Exit.void);
-      }
-      NodeFS.rmSync(tempDir, { recursive: true, force: true });
-    }
-  }),
-);
diff --git a/apps/server/src/provider/Layers/CodexAdapter.ts b/apps/server/src/provider/Layers/CodexAdapter.ts
deleted file mode 100644
index 6eaccf9f47a0..000000000000
--- a/apps/server/src/provider/Layers/CodexAdapter.ts
+++ /dev/null
@@ -1,2037 +0,0 @@
-/**
- * CodexAdapterLive - Scoped live implementation for the Codex provider adapter.
- *
- * Wraps the typed Codex session runtime behind the `CodexAdapter` service
- * contract and maps runtime failures into the shared `ProviderAdapterError`
- * algebra.
- *
- * @module CodexAdapterLive
- */
-import {
-  type CanonicalItemType,
-  type CanonicalRequestType,
-  type CodexSettings,
-  ProviderDriverKind,
-  type ProviderEvent,
-  ProviderInstanceId,
-  type ProviderRuntimeEvent,
-  type ProviderRequestKind,
-  type ThreadTokenUsageSnapshot,
-  type ProviderUserInputAnswers,
-  RuntimeItemId,
-  RuntimeRequestId,
-  RuntimeTaskId,
-  type RuntimeTaskUsage,
-  ProviderApprovalDecision,
-  ThreadId,
-  ProviderSendTurnInput,
-} from "@t3tools/contracts";
-import * as Effect from "effect/Effect";
-import * as Crypto from "effect/Crypto";
-import * as Exit from "effect/Exit";
-import * as Fiber from "effect/Fiber";
-import * as FileSystem from "effect/FileSystem";
-import * as Queue from "effect/Queue";
-import * as Schema from "effect/Schema";
-import * as Scope from "effect/Scope";
-import * as Stream from "effect/Stream";
-import { ChildProcessSpawner } from "effect/unstable/process";
-import * as CodexErrors from "effect-codex-app-server/errors";
-import * as EffectCodexSchema from "effect-codex-app-server/schema";
-
-import { getModelSelectionStringOptionValue } from "@t3tools/shared/model";
-import { getCodexServiceTierOptionValue } from "../../codexModelOptions.ts";
-import * as McpProviderSession from "../../mcp/McpProviderSession.ts";
-
-import {
-  ProviderAdapterRequestError,
-  ProviderAdapterProcessError,
-  ProviderAdapterSessionClosedError,
-  ProviderAdapterSessionNotFoundError,
-  ProviderAdapterValidationError,
-  type ProviderAdapterError,
-} from "../Errors.ts";
-import { type CodexAdapterShape } from "../Services/CodexAdapter.ts";
-import { resolveAttachmentPath } from "../../attachmentStore.ts";
-import { ServerConfig } from "../../config.ts";
-import {
-  CodexResumeCursorSchema,
-  CodexSessionRuntimeThreadIdMissingError,
-  describeMcpElicitation,
-  makeCodexSessionRuntime,
-  type CodexSessionRuntimeError,
-  type CodexSessionRuntimeOptions,
-  type CodexSessionRuntimeShape,
-} from "./CodexSessionRuntime.ts";
-import { type EventNdjsonLogger, makeEventNdjsonLogger } from "./EventNdjsonLogger.ts";
-import { resolveCodexLaunchArgs } from "./codexLaunchArgs.ts";
-const isCodexAppServerProcessExitedError = Schema.is(CodexErrors.CodexAppServerProcessExitedError);
-const isCodexAppServerTransportError = Schema.is(CodexErrors.CodexAppServerTransportError);
-const isCodexSessionRuntimeThreadIdMissingError = Schema.is(
-  CodexSessionRuntimeThreadIdMissingError,
-);
-const isCodexResumeCursorSchema = Schema.is(CodexResumeCursorSchema);
-
-const PROVIDER = ProviderDriverKind.make("codex");
-
-export interface CodexAdapterLiveOptions {
-  readonly instanceId?: ProviderInstanceId;
-  readonly environment?: NodeJS.ProcessEnv;
-  readonly makeRuntime?: (
-    options: CodexSessionRuntimeOptions,
-  ) => Effect.Effect<
-    CodexSessionRuntimeShape,
-    CodexSessionRuntimeError,
-    ChildProcessSpawner.ChildProcessSpawner | Scope.Scope
-  >;
-  readonly nativeEventLogPath?: string;
-  readonly nativeEventLogger?: EventNdjsonLogger;
-}
-
-interface CodexAdapterSessionContext {
-  readonly threadId: ThreadId;
-  readonly scope: Scope.Closeable;
-  readonly runtime: CodexSessionRuntimeShape;
-  readonly eventFiber: Fiber.Fiber<void, never>;
-  stopped: boolean;
-}
-
-function mapCodexRuntimeError(
-  threadId: ThreadId,
-  method: string,
-  error: CodexSessionRuntimeError,
-): ProviderAdapterError {
-  if (isCodexAppServerProcessExitedError(error) || isCodexAppServerTransportError(error)) {
-    return new ProviderAdapterSessionClosedError({
-      provider: PROVIDER,
-      threadId,
-      cause: error,
-    });
-  }
-
-  if (isCodexSessionRuntimeThreadIdMissingError(error)) {
-    return new ProviderAdapterSessionNotFoundError({
-      provider: PROVIDER,
-      threadId,
-      cause: error,
-    });
-  }
-
-  return new ProviderAdapterRequestError({
-    provider: PROVIDER,
-    method,
-    detail: error.message,
-    cause: error,
-  });
-}
-
-type CodexLifecycleItem =
-  | EffectCodexSchema.V2ItemStartedNotification["item"]
-  | EffectCodexSchema.V2ItemCompletedNotification["item"];
-
-type CodexToolUserInputQuestion =
-  | EffectCodexSchema.ServerRequest__ToolRequestUserInputQuestion
-  | EffectCodexSchema.ToolRequestUserInputParams__ToolRequestUserInputQuestion;
-
-const ApprovalDecisionPayload = Schema.Struct({
-  decision: ProviderApprovalDecision,
-});
-
-function readPayload<A>(
-  schema: Schema.Schema<A>,
-  payload: ProviderEvent["payload"],
-): A | undefined {
-  const isPayload = Schema.is(schema);
-  return isPayload(payload) ? payload : undefined;
-}
-
-function trimText(value: string | undefined | null): string | undefined {
-  const trimmed = value?.trim();
-  return trimmed && trimmed.length > 0 ? trimmed : undefined;
-}
-
-const FATAL_CODEX_STDERR_SNIPPETS = ["failed to connect to websocket"];
-
-function isFatalCodexProcessStderrMessage(message: string): boolean {
-  const normalized = message.toLowerCase();
-  return FATAL_CODEX_STDERR_SNIPPETS.some((snippet) => normalized.includes(snippet));
-}
-
-function normalizeCodexTokenUsage(
-  usage: EffectCodexSchema.V2ThreadTokenUsageUpdatedNotification["tokenUsage"],
-): ThreadTokenUsageSnapshot | undefined {
-  const totalProcessedTokens = usage.total.totalTokens;
-  const usedTokens = usage.last.totalTokens;
-  if (usedTokens === undefined || usedTokens <= 0) {
-    return undefined;
-  }
-
-  const maxTokens = usage.modelContextWindow ?? undefined;
-  const inputTokens = usage.last.inputTokens;
-  const cachedInputTokens = usage.last.cachedInputTokens;
-  const outputTokens = usage.last.outputTokens;
-  const reasoningOutputTokens = usage.last.reasoningOutputTokens;
-
-  return {
-    usedTokens,
-    ...(totalProcessedTokens !== undefined && totalProcessedTokens > usedTokens
-      ? { totalProcessedTokens }
-      : {}),
-    ...(maxTokens !== undefined ? { maxTokens } : {}),
-    ...(inputTokens !== undefined ? { inputTokens } : {}),
-    ...(cachedInputTokens !== undefined ? { cachedInputTokens } : {}),
-    ...(outputTokens !== undefined ? { outputTokens } : {}),
-    ...(reasoningOutputTokens !== undefined ? { reasoningOutputTokens } : {}),
-    ...(usedTokens !== undefined ? { lastUsedTokens: usedTokens } : {}),
-    ...(inputTokens !== undefined ? { lastInputTokens: inputTokens } : {}),
-    ...(cachedInputTokens !== undefined ? { lastCachedInputTokens: cachedInputTokens } : {}),
-    ...(outputTokens !== undefined ? { lastOutputTokens: outputTokens } : {}),
-    ...(reasoningOutputTokens !== undefined
-      ? { lastReasoningOutputTokens: reasoningOutputTokens }
-      : {}),
-    compactsAutomatically: true,
-  };
-}
-
-function toTurnStatus(
-  value: EffectCodexSchema.V2TurnCompletedNotification["turn"]["status"] | "cancelled",
-): "completed" | "failed" | "cancelled" | "interrupted" {
-  switch (value) {
-    case "completed":
-    case "failed":
-    case "cancelled":
-    case "interrupted":
-      return value;
-    default:
-      return "completed";
-  }
-}
-
-function normalizeItemType(raw: string | undefined | null): string {
-  const type = trimText(raw);
-  if (!type) return "item";
-  return type
-    .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
-    .replace(/[._/-]/g, " ")
-    .replace(/\s+/g, " ")
-    .trim()
-    .toLowerCase();
-}
-
-function toCanonicalItemType(raw: string | undefined | null): CanonicalItemType {
-  const type = normalizeItemType(raw);
-  if (type.includes("user")) return "user_message";
-  if (type.includes("agent message") || type.includes("assistant")) return "assistant_message";
-  if (type.includes("reasoning") || type.includes("thought")) return "reasoning";
-  if (type.includes("plan") || type.includes("todo")) return "plan";
-  if (type.includes("command")) return "command_execution";
-  if (type.includes("file change") || type.includes("patch") || type.includes("edit"))
-    return "file_change";
-  if (type.includes("mcp")) return "mcp_tool_call";
-  if (type.includes("dynamic tool")) return "dynamic_tool_call";
-  if (type.includes("collab")) return "collab_agent_tool_call";
-  if (type.includes("web search")) return "web_search";
-  if (type.includes("image")) return "image_view";
-  if (type.includes("review entered")) return "review_entered";
-  if (type.includes("review exited")) return "review_exited";
-  if (type.includes("compact")) return "context_compaction";
-  if (type.includes("error")) return "error";
-  return "unknown";
-}
-
-function itemTitle(itemType: CanonicalItemType, item?: CodexLifecycleItem): string | undefined {
-  if (itemType === "mcp_tool_call" && item?.type === "mcpToolCall") {
-    return `${item.server} · ${item.tool}`;
-  }
-  switch (itemType) {
-    case "assistant_message":
-      return "Assistant message";
-    case "user_message":
-      return "User message";
-    case "reasoning":
-      return "Reasoning";
-    case "plan":
-      return "Plan";
-    case "command_execution":
-      return "Ran command";
-    case "file_change":
-      return "File change";
-    case "mcp_tool_call":
-      return "MCP tool call";
-    case "dynamic_tool_call":
-      return "Tool call";
-    case "web_search":
-      return "Web search";
-    case "image_view":
-      return "Image view";
-    case "error":
-      return "Error";
-    default:
-      return undefined;
-  }
-}
-
-function itemDetail(itemType: CanonicalItemType, item: CodexLifecycleItem): string | undefined {
-  const itemRecord = item as Record<string, unknown>;
-  const action = itemRecord.action as Record<string, unknown> | undefined;
-  const actionQueries = Array.isArray(action?.queries) ? action.queries : [];
-  const candidates = [
-    ...(itemType === "web_search"
-      ? [itemRecord.query, action?.query, ...actionQueries, action?.pattern, action?.url]
-      : []),
-    "command" in item ? item.command : undefined,
-    "title" in item ? item.title : undefined,
-    "summary" in item ? item.summary : undefined,
-    "text" in item ? item.text : undefined,
-    "path" in item ? item.path : undefined,
-    "prompt" in item ? item.prompt : undefined,
-  ];
-
-  for (const candidate of candidates) {
-    const trimmed = typeof candidate === "string" ? trimText(candidate) : undefined;
-    if (!trimmed) continue;
-    return trimmed;
-  }
-  return undefined;
-}
-
-function toRequestTypeFromMethod(method: string): CanonicalRequestType {
-  switch (method) {
-    case "item/commandExecution/requestApproval":
-      return "command_execution_approval";
-    case "item/fileRead/requestApproval":
-      return "file_read_approval";
-    case "item/fileChange/requestApproval":
-      return "file_change_approval";
-    case "mcpServer/elicitation/request":
-      return "mcp_elicitation_approval";
-    case "applyPatchApproval":
-      return "apply_patch_approval";
-    case "execCommandApproval":
-      return "exec_command_approval";
-    case "item/tool/requestUserInput":
-      return "tool_user_input";
-    case "item/tool/call":
-      return "dynamic_tool_call";
-    case "account/chatgptAuthTokens/refresh":
-      return "auth_tokens_refresh";
-    default:
-      return "unknown";
-  }
-}
-
-function toRequestTypeFromKind(kind: ProviderRequestKind | undefined): CanonicalRequestType {
-  switch (kind) {
-    case "command":
-      return "command_execution_approval";
-    case "file-read":
-      return "file_read_approval";
-    case "file-change":
-      return "file_change_approval";
-    case "mcp-elicitation":
-      return "mcp_elicitation_approval";
-    default:
-      return "unknown";
-  }
-}
-
-function toCanonicalUserInputAnswers(
-  answers: EffectCodexSchema.ToolRequestUserInputResponse["answers"],
-): ProviderUserInputAnswers {
-  return Object.fromEntries(
-    Object.entries(answers).map(([questionId, value]) => {
-      const normalizedAnswers = value.answers.length === 1 ? value.answers[0]! : [...value.answers];
-      return [questionId, normalizedAnswers] as const;
-    }),
-  );
-}
-
-function toUserInputQuestions(questions: ReadonlyArray<CodexToolUserInputQuestion>) {
-  const parsedQuestions = questions
-    .map((question) => {
-      const options =
-        question.options
-          ?.map((option) => {
-            const label = trimText(option.label);
-            const description = trimText(option.description);
-            if (!label || !description) {
-              return undefined;
-            }
-            return { label, description };
-          })
-          .filter((option) => option !== undefined) ?? [];
-
-      const id = trimText(question.id);
-      const header = trimText(question.header);
-      const prompt = trimText(question.question);
-      if (!id || !header || !prompt || options.length === 0) {
-        return undefined;
-      }
-      return {
-        id,
-        header,
-        question: prompt,
-        options,
-        multiSelect: false,
-      };
-    })
-    .filter((question) => question !== undefined);
-
-  return parsedQuestions.length > 0 ? parsedQuestions : undefined;
-}
-
-function toThreadState(
-  status: EffectCodexSchema.V2ThreadStatusChangedNotification["status"],
-): "active" | "idle" | "archived" | "closed" | "compacted" | "error" {
-  switch (status.type) {
-    case "idle":
-      return "idle";
-    case "systemError":
-      return "error";
-    default:
-      return "active";
-  }
-}
-
-function contentStreamKindFromMethod(
-  method: string,
-):
-  | "assistant_text"
-  | "reasoning_text"
-  | "reasoning_summary_text"
-  | "plan_text"
-  | "command_output"
-  | "file_change_output" {
-  switch (method) {
-    case "item/agentMessage/delta":
-      return "assistant_text";
-    case "item/reasoning/textDelta":
-      return "reasoning_text";
-    case "item/reasoning/summaryTextDelta":
-      return "reasoning_summary_text";
-    case "item/commandExecution/outputDelta":
-      return "command_output";
-    case "item/fileChange/outputDelta":
-      return "file_change_output";
-    default:
-      return "assistant_text";
-  }
-}
-
-function asRuntimeItemId(itemId: ProviderEvent["itemId"] & string): RuntimeItemId {
-  return RuntimeItemId.make(itemId);
-}
-
-function asRuntimeRequestId(requestId: string): RuntimeRequestId {
-  return RuntimeRequestId.make(requestId);
-}
-
-function eventRawSource(event: ProviderEvent): NonNullable<ProviderRuntimeEvent["raw"]>["source"] {
-  return event.kind === "request" ? "codex.app-server.request" : "codex.app-server.notification";
-}
-
-function providerRefsFromEvent(
-  event: ProviderEvent,
-): ProviderRuntimeEvent["providerRefs"] | undefined {
-  const refs: Record<string, string> = {};
-  if (event.turnId) refs.providerTurnId = event.turnId;
-  if (event.itemId) refs.providerItemId = event.itemId;
-  if (event.requestId) refs.providerRequestId = event.requestId;
-
-  return Object.keys(refs).length > 0 ? (refs as ProviderRuntimeEvent["providerRefs"]) : undefined;
-}
-
-function runtimeEventBase(
-  event: ProviderEvent,
-  canonicalThreadId: ThreadId,
-): Omit<ProviderRuntimeEvent, "type" | "payload"> {
-  const refs = providerRefsFromEvent(event);
-  return {
-    eventId: event.id,
-    provider: event.provider,
-    threadId: canonicalThreadId,
-    createdAt: event.createdAt,
-    ...(event.turnId ? { turnId: event.turnId } : {}),
-    ...(event.itemId ? { itemId: asRuntimeItemId(event.itemId) } : {}),
-    ...(event.requestId ? { requestId: asRuntimeRequestId(event.requestId) } : {}),
-    ...(refs ? { providerRefs: refs } : {}),
-    raw: {
-      source: eventRawSource(event),
-      method: event.method,
-      payload: event.payload ?? {},
-    },
-  };
-}
-
-function mapItemLifecycle(
-  event: ProviderEvent,
-  canonicalThreadId: ThreadId,
-  lifecycle: "item.started" | "item.updated" | "item.completed",
-): ProviderRuntimeEvent | undefined {
-  const payload =
-    readPayload(EffectCodexSchema.V2ItemStartedNotification, event.payload) ??
-    readPayload(EffectCodexSchema.V2ItemCompletedNotification, event.payload);
-  const item = payload?.item;
-  if (!item) {
-    return undefined;
-  }
-  const itemType = toCanonicalItemType(item.type);
-  if (itemType === "unknown" && lifecycle !== "item.updated") {
-    return undefined;
-  }
-
-  const detail = itemDetail(itemType, item);
-  const status =
-    lifecycle === "item.started"
-      ? "inProgress"
-      : lifecycle === "item.completed"
-        ? "status" in item && (item.status === "failed" || item.status === "declined")
-          ? item.status
-          : "completed"
-        : undefined;
-
-  return {
-    ...runtimeEventBase(event, canonicalThreadId),
-    type: lifecycle,
-    payload: {
-      itemType,
-      ...(status ? { status } : {}),
-      ...(itemTitle(itemType, item) ? { title: itemTitle(itemType, item) } : {}),
-      ...(detail ? { detail } : {}),
-      ...(event.payload !== undefined ? { data: event.payload } : {}),
-    },
-  };
-}
-
-/**
- * Maps the session runtime's synthetic `collabAgent/*` events (native
- * multi-agent v2 child-thread signals) into the shared task.* lifecycle.
- * Agent identity = child thread id; nickname is the display title, role is
- * agentRole (fallback: last agentPath segment, then "general-purpose").
- * A completed child turn is idle (resumable), not terminal. timelineBypass
- * keeps these rows out of the parent chat.
- */
-function mapCollabAgentEvent(
-  event: ProviderEvent,
-  canonicalThreadId: ThreadId,
-): ReadonlyArray<ProviderRuntimeEvent> {
-  const payload =
-    typeof event.payload === "object" && event.payload !== null
-      ? (event.payload as Record<string, unknown>)
-      : undefined;
-  const agentThreadId = typeof payload?.agentThreadId === "string" ? payload.agentThreadId : "";
-  if (!payload || agentThreadId.length === 0) {
-    return [];
-  }
-  const base = runtimeEventBase(event, canonicalThreadId);
-  const taskId = RuntimeTaskId.make(agentThreadId);
-  const agentPath = typeof payload.agentPath === "string" ? payload.agentPath : undefined;
-  const pathLeaf = agentPath?.split("/").findLast((segment) => segment.length > 0);
-  const nickname = typeof payload.nickname === "string" ? payload.nickname : undefined;
-  const role =
-    (typeof payload.role === "string" ? payload.role : undefined) ?? pathLeaf ?? "general-purpose";
-  // A bare thread id is not a name. Omitting the title lets the client fold
-  // keep the real one from task.started instead of clobbering it (probe
-  // finding: progress rows renamed math_one to its UUID).
-  const knownName = nickname ?? pathLeaf;
-  const title = knownName ?? agentThreadId;
-  const model = typeof payload.model === "string" ? payload.model.trim() : "";
-  const effort = typeof payload.effort === "string" ? payload.effort.trim() : "";
-  // Identity repeated on every status patch so rows are self-describing when
-  // the start row ages out of activity retention (review finding: a
-  // reconstructed agent had a UUID name and no role/path).
-  const linkage = {
-    role,
-    ...(knownName ? { title: knownName } : {}),
-    ...(model ? { model } : {}),
-    ...(effort ? { effort } : {}),
-    ...(agentPath ? { agentPath } : {}),
-    timelineBypass: true,
-  } as const;
-
-  switch (event.method) {
-    case "collabAgent/started":
-      return [
-        {
-          ...base,
-          type: "task.started",
-          payload: {
-            taskId,
-            description: title,
-            title,
-            ...linkage,
-            ...(typeof payload.parentThreadId === "string"
-              ? { parentAgentId: payload.parentThreadId }
-              : {}),
-          },
-        },
-      ];
-    case "collabAgent/metadataUpdated":
-      return [
-        {
-          ...base,
-          type: "task.updated",
-          payload: { taskId, ...linkage },
-        },
-      ];
-    case "collabAgent/activity": {
-      const activityKind = typeof payload.activityKind === "string" ? payload.activityKind : "";
-      if (activityKind === "interrupted") {
-        return [
-          {
-            ...base,
-            type: "task.updated",
-            payload: { taskId, status: "interrupted", ...linkage },
-          },
-        ];
-      }
-      if (activityKind === "started") {
-        // Wire-probe finding: children often register via subAgentActivity
-        // alone (no thread/started with a spawn source), so this is the one
-        // shot at a task.started with a real name — agentPath leaf beats a
-        // bare thread-id title.
-        return [
-          {
-            ...base,
-            type: "task.started",
-            payload: {
-              taskId,
-              description: title,
-              title,
-              ...linkage,
-            },
-          },
-        ];
-      }
-      // Reading a child's result also emits "interacted" after its turn is idle.
-      // Only the child's turn or thread lifecycle can prove it resumed work.
-      return [];
-    }
-    case "collabAgent/turnStarted":
-      return [
-        {
-          ...base,
-          type: "task.updated",
-          payload: { taskId, status: "running", ...linkage },
-        },
-      ];
-    case "collabAgent/turnCompleted": {
-      // Idle, not terminal: the identity is resumable via sendInput/resume.
-      const turn =
-        typeof payload.turn === "object" && payload.turn !== null
-          ? (payload.turn as Record<string, unknown>)
-          : undefined;
-      const turnStatus = typeof turn?.status === "string" ? turn.status : undefined;
-      const status =
-        turnStatus === "failed"
-          ? ("failed" as const)
-          : turnStatus === "interrupted"
-            ? ("interrupted" as const)
-            : ("idle" as const);
-      return [
-        {
-          ...base,
-          type: "task.updated",
-          payload: { taskId, status, ...linkage },
-        },
-      ];
-    }
-    case "collabAgent/statusChanged": {
-      const status =
-        typeof payload.status === "object" && payload.status !== null
-          ? (payload.status as Record<string, unknown>)
-          : undefined;
-      const statusType = typeof status?.type === "string" ? status.type : undefined;
-      if (statusType === "systemError") {
-        // Silently dropping this once left children stuck running forever.
-        return [
-          {
-            ...base,
-            type: "task.updated",
-            payload: { taskId, status: "failed", ...linkage },
-          },
-        ];
-      }
-      if (statusType === "active") {
-        const flags = Array.isArray(status?.activeFlags) ? status.activeFlags : [];
-        const waiting = flags.some(
-          (flag) => flag === "waitingOnApproval" || flag === "waitingOnUserInput",
-        );
-        return [
-          {
-            ...base,
-            type: "task.updated",
-            payload: { taskId, status: waiting ? "waiting" : "running", ...linkage },
-          },
-        ];
-      }
-      if (statusType === "idle") {
-        return [
-          {
-            ...base,
-            type: "task.updated",
-            payload: { taskId, status: "idle", ...linkage },
-          },
-        ];
-      }
-      return [];
-    }
-    case "collabAgent/tokenUsage": {
-      // Cumulative per child thread: always the `total` breakdown, never
-      // `last` (which shrinks on follow-ups). Client folds max-merge.
-      const tokenUsage =
-        typeof payload.tokenUsage === "object" && payload.tokenUsage !== null
-          ? (payload.tokenUsage as Record<string, unknown>)
-          : undefined;
-      const total =
-        typeof tokenUsage?.total === "object" && tokenUsage.total !== null
-          ? (tokenUsage.total as Record<string, unknown>)
-          : undefined;
-      const count = (value: unknown): number | undefined =>
-        typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : undefined;
-      // Same validation as every other field: RuntimeTaskUsage.totalTokens
-      // is NonNegativeInt, so NaN/Infinity/negative wire values must miss.
-      const totalTokens = count(total?.totalTokens);
-      if (totalTokens === undefined) {
-        return [];
-      }
-      const typedUsage: RuntimeTaskUsage = {
-        totalTokens,
-        ...(count(total?.inputTokens) !== undefined
-          ? { inputTokens: count(total?.inputTokens) }
-          : {}),
-        ...(count(total?.cachedInputTokens) !== undefined
-          ? { cachedInputTokens: count(total?.cachedInputTokens) }
-          : {}),
-        ...(count(total?.outputTokens) !== undefined
-          ? { outputTokens: count(total?.outputTokens) }
-          : {}),
-        ...(count(total?.reasoningOutputTokens) !== undefined
-          ? { reasoningOutputTokens: count(total?.reasoningOutputTokens) }
-          : {}),
-      };
-      return [
-        {
-          ...base,
-          type: "task.progress",
-          payload: {
-            taskId,
-            description: title,
-            ...linkage,
-            typedUsage,
-          },
-        },
-      ];
-    }
-    case "collabAgent/item": {
-      const item =
-        typeof payload.item === "object" && payload.item !== null
-          ? (payload.item as Record<string, unknown>)
-          : undefined;
-      const itemTypeRaw = typeof item?.type === "string" ? item.type : undefined;
-      if (!itemTypeRaw) {
-        return [];
-      }
-      // A loose summary from the raw item: the child stream is untyped at
-      // this boundary (synthetic event payload), so read best-effort fields
-      // rather than force a schema decode.
-      const looseSummary =
-        (typeof item?.command === "string" ? item.command : undefined) ??
-        (typeof item?.title === "string" ? item.title : undefined) ??
-        (typeof item?.query === "string" ? item.query : undefined);
-      const canonical = toCanonicalItemType(itemTypeRaw);
-      const summary = looseSummary ?? canonical.replaceAll("_", " ");
-      return [
-        {
-          ...base,
-          type: "task.progress",
-          payload: {
-            taskId,
-            description: title,
-            ...linkage,
-            summary,
-          },
-        },
-      ];
-    }
-    case "collabAgent/closed":
-      return [
-        {
-          ...base,
-          type: "task.updated",
-          payload: { taskId, status: "interrupted", ...linkage },
-        },
-      ];
-    default:
-      return [];
-  }
-}
-
-function mapToRuntimeEvents(
-  event: ProviderEvent,
-  canonicalThreadId: ThreadId,
-): ReadonlyArray<ProviderRuntimeEvent> {
-  if (event.kind === "notification" && event.method.startsWith("collabAgent/")) {
-    return mapCollabAgentEvent(event, canonicalThreadId);
-  }
-  if (event.kind === "error") {
-    if (!event.message) {
-      return [];
-    }
-    return [
-      {
-        ...runtimeEventBase(event, canonicalThreadId),
-        type: "runtime.error",
-        payload: {
-          message: event.message,
-          class: "provider_error",
-          ...(event.payload !== undefined ? { detail: event.payload } : {}),
-        },
-      },
-    ];
-  }
-
-  if (event.kind === "request") {
-    if (event.method === "item/tool/requestUserInput") {
-      const payload =
-        readPayload(EffectCodexSchema.ServerRequest__ToolRequestUserInputParams, event.payload) ??
-        readPayload(EffectCodexSchema.ToolRequestUserInputParams, event.payload);
-      const questions = payload ? toUserInputQuestions(payload.questions) : undefined;
-      if (!questions) {
-        return [];
-      }
-      return [
-        {
-          ...runtimeEventBase(event, canonicalThreadId),
-          type: "user-input.requested",
-          payload: {
-            questions,
-          },
-        },
-      ];
-    }
-
-    const elicitation =
-      event.method === "mcpServer/elicitation/request"
-        ? readPayload(EffectCodexSchema.McpServerElicitationRequestParams, event.payload)
-        : undefined;
-    const elicitationApproval = elicitation ? describeMcpElicitation(elicitation) : undefined;
-    const detail = (() => {
-      switch (event.method) {
-        case "item/commandExecution/requestApproval": {
-          const payload = readPayload(
-            EffectCodexSchema.ServerRequest__CommandExecutionRequestApprovalParams,
-            event.payload,
-          );
-          return payload?.command ?? payload?.reason ?? undefined;
-        }
-        case "item/fileChange/requestApproval": {
-          const payload = readPayload(
-            EffectCodexSchema.ServerRequest__FileChangeRequestApprovalParams,
-            event.payload,
-          );
-          return payload?.reason ?? undefined;
-        }
-        case "mcpServer/elicitation/request":
-          return elicitation?.message;
-        case "applyPatchApproval": {
-          const payload = readPayload(
-            EffectCodexSchema.ServerRequest__ApplyPatchApprovalParams,
-            event.payload,
-          );
-          return payload?.reason ?? undefined;
-        }
-        case "execCommandApproval": {
-          const payload = readPayload(
-            EffectCodexSchema.ServerRequest__ExecCommandApprovalParams,
-            event.payload,
-          );
-          return payload?.reason ?? payload?.command.join(" ");
-        }
-        case "item/tool/call": {
-          const payload = readPayload(
-            EffectCodexSchema.ServerRequest__DynamicToolCallParams,
-            event.payload,
-          );
-          return payload?.tool ?? undefined;
-        }
-        default:
-          return undefined;
-      }
-    })();
-
-    return [
-      {
-        ...runtimeEventBase(event, canonicalThreadId),
-        type: "request.opened",
-        payload: {
-          requestType: toRequestTypeFromMethod(event.method),
-          ...(detail ? { detail } : {}),
-          ...(elicitationApproval
-            ? {
-                appName: elicitationApproval.appName,
-                options: elicitationApproval.options,
-              }
-            : {}),
-          ...(event.payload !== undefined ? { args: event.payload } : {}),
-        },
-      },
-    ];
-  }
-
-  if (event.method === "item/requestApproval/decision" && event.requestId) {
-    const payload = readPayload(ApprovalDecisionPayload, event.payload);
-    const requestType =
-      event.requestKind !== undefined
-        ? toRequestTypeFromKind(event.requestKind)
-        : toRequestTypeFromMethod(event.method);
-    return [
-      {
-        ...runtimeEventBase(event, canonicalThreadId),
-        type: "request.resolved",
-        payload: {
-          requestType,
-          ...(payload ? { decision: payload.decision } : {}),
-          ...(event.payload !== undefined ? { resolution: event.payload } : {}),
-        },
-      },
-    ];
-  }
-
-  if (event.method === "session/connecting") {
-    return [
-      {
-        ...runtimeEventBase(event, canonicalThreadId),
-        type: "session.state.changed",
-        payload: {
-          state: "starting",
-          ...(event.message ? { reason: event.message } : {}),
-        },
-      },
-    ];
-  }
-
-  if (event.method === "session/ready") {
-    return [
-      {
-        ...runtimeEventBase(event, canonicalThreadId),
-        type: "session.state.changed",
-        payload: {
-          state: "ready",
-          ...(event.message ? { reason: event.message } : {}),
-        },
-      },
-    ];
-  }
-
-  if (event.method === "session/started") {
-    return [
-      {
-        ...runtimeEventBase(event, canonicalThreadId),
-        type: "session.started",
-        payload: {
-          ...(event.message ? { message: event.message } : {}),
-          ...(event.payload !== undefined ? { resume: event.payload } : {}),
-        },
-      },
-    ];
-  }
-
-  if (event.method === "session/exited" || event.method === "session/closed") {
-    return [
-      {
-        ...runtimeEventBase(event, canonicalThreadId),
-        type: "session.exited",
-        payload: {
-          ...(event.message ? { reason: event.message } : {}),
-          ...(event.method === "session/closed" ? { exitKind: "graceful" } : {}),
-        },
-      },
-    ];
-  }
-
-  if (event.method === "thread/started") {
-    const payload = readPayload(EffectCodexSchema.V2ThreadStartedNotification, event.payload);
-    if (!payload) {
-      return [];
-    }
-    return [
-      {
-        ...runtimeEventBase(event, canonicalThreadId),
-        type: "thread.started",
-        payload: {
-          providerThreadId: payload.thread.id,
-        },
-      },
-    ];
-  }
-
-  if (
-    event.method === "thread/status/changed" ||
-    event.method === "thread/archived" ||
-    event.method === "thread/unarchived" ||
-    event.method === "thread/closed" ||
-    event.method === "thread/compacted"
-  ) {
-    const payload =
-      event.method === "thread/status/changed"
-        ? readPayload(EffectCodexSchema.V2ThreadStatusChangedNotification, event.payload)
-        : undefined;
-    return [
-      {
-        type: "thread.state.changed",
-        ...runtimeEventBase(event, canonicalThreadId),
-        payload: {
-          state:
-            event.method === "thread/archived"
-              ? "archived"
-              : event.method === "thread/closed"
-                ? "closed"
-                : event.method === "thread/compacted"
-                  ? "compacted"
-                  : payload
-                    ? toThreadState(payload.status)
-                    : "active",
-          ...(event.payload !== undefined ? { detail: event.payload } : {}),
-        },
-      },
-    ];
-  }
-
-  if (event.method === "thread/name/updated") {
-    const payload = readPayload(EffectCodexSchema.V2ThreadNameUpdatedNotification, event.payload);
-    return [
-      {
-        type: "thread.metadata.updated",
-        ...runtimeEventBase(event, canonicalThreadId),
-        payload: {
-          ...(trimText(payload?.threadName) ? { name: trimText(payload?.threadName) } : {}),
-          ...(payload
-            ? {
-                metadata: {
-                  threadId: payload.threadId,
-                  ...(payload.threadName !== undefined && payload.threadName !== null
-                    ? { threadName: payload.threadName }
-                    : {}),
-                },
-              }
-            : {}),
-        },
-      },
-    ];
-  }
-
-  if (event.method === "thread/tokenUsage/updated") {
-    const payload = readPayload(
-      EffectCodexSchema.V2ThreadTokenUsageUpdatedNotification,
-      event.payload,
-    );
-    const normalizedUsage = payload ? normalizeCodexTokenUsage(payload.tokenUsage) : undefined;
-    if (!normalizedUsage) {
-      return [];
-    }
-    return [
-      {
-        type: "thread.token-usage.updated",
-        ...runtimeEventBase(event, canonicalThreadId),
-        payload: {
-          usage: normalizedUsage,
-        },
-      },
-    ];
-  }
-
-  if (event.method === "turn/started") {
-    const turnId = event.turnId;
-    if (!turnId) {
-      return [];
-    }
-    return [
-      {
-        ...runtimeEventBase(event, canonicalThreadId),
-        turnId,
-        type: "turn.started",
-        payload: {},
-      },
-    ];
-  }
-
-  if (event.method === "turn/completed") {
-    const payload = readPayload(EffectCodexSchema.V2TurnCompletedNotification, event.payload);
-    if (!payload) {
-      return [];
-    }
-    const errorMessage = trimText(payload.turn.error?.message);
-    return [
-      {
-        ...runtimeEventBase(event, canonicalThreadId),
-        type: "turn.completed",
-        payload: {
-          state: toTurnStatus(payload.turn.status),
-          ...(errorMessage ? { errorMessage } : {}),
-        },
-      },
-    ];
-  }
-
-  if (event.method === "turn/aborted") {
-    return [
-      {
-        ...runtimeEventBase(event, canonicalThreadId),
-        type: "turn.aborted",
-        payload: {
-          reason: event.message ?? "Turn aborted",
-        },
-      },
-    ];
-  }
-
-  if (event.method === "turn/plan/updated") {
-    const payload = readPayload(EffectCodexSchema.V2TurnPlanUpdatedNotification, event.payload);
-    if (!payload) {
-      return [];
-    }
-    return [
-      {
-        ...runtimeEventBase(event, canonicalThreadId),
-        type: "turn.plan.updated",
-        payload: {
-          ...(trimText(payload.explanation) ? { explanation: trimText(payload.explanation) } : {}),
-          plan: payload.plan.map((step) => ({
-            step: trimText(step.step) ?? "step",
-            status:
-              step.status === "completed" || step.status === "inProgress" ? step.status : "pending",
-          })),
-        },
-      },
-    ];
-  }
-
-  if (event.method === "turn/diff/updated") {
-    const payload = readPayload(EffectCodexSchema.V2TurnDiffUpdatedNotification, event.payload);
-    if (!payload) {
-      return [];
-    }
-    return [
-      {
-        ...runtimeEventBase(event, canonicalThreadId),
-        type: "turn.diff.updated",
-        payload: {
-          unifiedDiff: payload.diff,
-        },
-      },
-    ];
-  }
-
-  if (event.method === "item/started") {
-    const started = mapItemLifecycle(event, canonicalThreadId, "item.started");
-    return started ? [started] : [];
-  }
-
-  if (event.method === "item/completed") {
-    const payload = readPayload(EffectCodexSchema.V2ItemCompletedNotification, event.payload);
-    const item = payload?.item;
-    if (!item) {
-      return [];
-    }
-    const itemType = toCanonicalItemType(item.type);
-    if (itemType === "plan") {
-      const detail = itemDetail(itemType, item);
-      if (!detail) {
-        return [];
-      }
-      return [
-        {
-          ...runtimeEventBase(event, canonicalThreadId),
-          type: "turn.proposed.completed",
-          payload: {
-            planMarkdown: detail,
-          },
-        },
-      ];
-    }
-    const completed = mapItemLifecycle(event, canonicalThreadId, "item.completed");
-    return completed ? [completed] : [];
-  }
-
-  if (
-    event.method === "item/reasoning/summaryPartAdded" ||
-    event.method === "item/commandExecution/terminalInteraction"
-  ) {
-    return [
-      {
-        ...runtimeEventBase(event, canonicalThreadId),
-        type: "item.updated",
-        payload: {
-          itemType:
-            event.method === "item/reasoning/summaryPartAdded" ? "reasoning" : "command_execution",
-          ...(event.payload !== undefined ? { data: event.payload } : {}),
-        },
-      },
-    ];
-  }
-
-  if (event.method === "item/plan/delta") {
-    const payload = readPayload(EffectCodexSchema.V2PlanDeltaNotification, event.payload);
-    const delta = event.textDelta ?? payload?.delta;
-    if (!delta || delta.length === 0) {
-      return [];
-    }
-    return [
-      {
-        ...runtimeEventBase(event, canonicalThreadId),
-        type: "turn.proposed.delta",
-        payload: {
-          delta,
-        },
-      },
-    ];
-  }
-
-  if (event.method === "item/agentMessage/delta") {
-    const payload = readPayload(EffectCodexSchema.V2AgentMessageDeltaNotification, event.payload);
-    const delta = event.textDelta ?? payload?.delta;
-    if (!delta || delta.length === 0) {
-      return [];
-    }
-    return [
-      {
-        ...runtimeEventBase(event, canonicalThreadId),
-        type: "content.delta",
-        payload: {
-          streamKind: contentStreamKindFromMethod(event.method),
-          delta,
-        },
-      },
-    ];
-  }
-
-  if (event.method === "item/commandExecution/outputDelta") {
-    const payload = readPayload(
-      EffectCodexSchema.V2CommandExecutionOutputDeltaNotification,
-      event.payload,
-    );
-    const delta = event.textDelta ?? payload?.delta;
-    if (!delta || delta.length === 0) {
-      return [];
-    }
-    return [
-      {
-        ...runtimeEventBase(event, canonicalThreadId),
-        type: "content.delta",
-        payload: {
-          streamKind: "command_output",
-          delta,
-        },
-      },
-    ];
-  }
-
-  if (event.method === "item/fileChange/outputDelta") {
-    const payload = readPayload(
-      EffectCodexSchema.V2FileChangeOutputDeltaNotification,
-      event.payload,
-    );
-    const delta = event.textDelta ?? payload?.delta;
-    if (!delta || delta.length === 0) {
-      return [];
-    }
-    return [
-      {
-        ...runtimeEventBase(event, canonicalThreadId),
-        type: "content.delta",
-        payload: {
-          streamKind: "file_change_output",
-          delta,
-        },
-      },
-    ];
-  }
-
-  if (event.method === "item/reasoning/summaryTextDelta") {
-    const payload = readPayload(
-      EffectCodexSchema.V2ReasoningSummaryTextDeltaNotification,
-      event.payload,
-    );
-    const delta = event.textDelta ?? payload?.delta;
-    if (!delta || delta.length === 0) {
-      return [];
-    }
-    return [
-      {
-        ...runtimeEventBase(event, canonicalThreadId),
-        type: "content.delta",
-        payload: {
-          streamKind: "reasoning_summary_text",
-          delta,
-          ...(payload ? { summaryIndex: payload.summaryIndex } : {}),
-        },
-      },
-    ];
-  }
-
-  if (event.method === "item/reasoning/textDelta") {
-    const payload = readPayload(EffectCodexSchema.V2ReasoningTextDeltaNotification, event.payload);
-    const delta = event.textDelta ?? payload?.delta;
-    if (!delta || delta.length === 0) {
-      return [];
-    }
-    return [
-      {
-        ...runtimeEventBase(event, canonicalThreadId),
-        type: "content.delta",
-        payload: {
-          streamKind: "reasoning_text",
-          delta,
-          ...(payload ? { contentIndex: payload.contentIndex } : {}),
-        },
-      },
-    ];
-  }
-
-  if (event.method === "item/mcpToolCall/progress") {
-    const payload = readPayload(EffectCodexSchema.V2McpToolCallProgressNotification, event.payload);
-    if (!payload) {
-      return [];
-    }
-    return [
-      {
-        ...runtimeEventBase(event, canonicalThreadId),
-        type: "tool.progress",
-        payload: {
-          summary: payload.message,
-        },
-      },
-    ];
-  }
-
-  if (event.method === "serverRequest/resolved") {
-    const payload = readPayload(
-      EffectCodexSchema.V2ServerRequestResolvedNotification,
-      event.payload,
-    );
-    if (!payload) {
-      return [];
-    }
-    const requestType = toRequestTypeFromKind(event.requestKind);
-    return [
-      {
-        ...runtimeEventBase(event, canonicalThreadId),
-        type: "request.resolved",
-        payload: {
-          requestType,
-          ...(event.payload !== undefined ? { resolution: event.payload } : {}),
-        },
-      },
-    ];
-  }
-
-  if (event.method === "item/tool/requestUserInput/answered") {
-    const payload = readPayload(EffectCodexSchema.ToolRequestUserInputResponse, event.payload);
-    if (!payload) {
-      return [];
-    }
-    return [
-      {
-        ...runtimeEventBase(event, canonicalThreadId),
-        type: "user-input.resolved",
-        payload: {
-          answers: toCanonicalUserInputAnswers(payload.answers),
-        },
-      },
-    ];
-  }
-
-  if (event.method === "model/rerouted") {
-    const payload = readPayload(EffectCodexSchema.V2ModelReroutedNotification, event.payload);
-    if (!payload) {
-      return [];
-    }
-    return [
-      {
-        type: "model.rerouted",
-        ...runtimeEventBase(event, canonicalThreadId),
-        payload: {
-          fromModel: payload.fromModel,
-          toModel: payload.toModel,
-          reason: payload.reason,
-        },
-      },
-    ];
-  }
-
-  if (event.method === "deprecationNotice") {
-    const payload = readPayload(EffectCodexSchema.V2DeprecationNoticeNotification, event.payload);
-    if (!payload) {
-      return [];
-    }
-    return [
-      {
-        type: "deprecation.notice",
-        ...runtimeEventBase(event, canonicalThreadId),
-        payload: {
-          summary: payload.summary,
-          ...(trimText(payload.details) ? { details: trimText(payload.details) } : {}),
-        },
-      },
-    ];
-  }
-
-  if (event.method === "configWarning") {
-    const payload = readPayload(EffectCodexSchema.V2ConfigWarningNotification, event.payload);
-    if (!payload) {
-      return [];
-    }
-    return [
-      {
-        type: "config.warning",
-        ...runtimeEventBase(event, canonicalThreadId),
-        payload: {
-          summary: payload.summary,
-          ...(trimText(payload.details) ? { details: trimText(payload.details) } : {}),
-          ...(trimText(payload.path) ? { path: trimText(payload.path) } : {}),
-          ...(payload.range !== undefined && payload.range !== null
-            ? { range: payload.range }
-            : {}),
-        },
-      },
-    ];
-  }
-
-  if (event.method === "account/updated") {
-    if (!readPayload(EffectCodexSchema.V2AccountUpdatedNotification, event.payload)) {
-      return [];
-    }
-    return [
-      {
-        type: "account.updated",
-        ...runtimeEventBase(event, canonicalThreadId),
-        payload: {
-          account: event.payload ?? {},
-        },
-      },
-    ];
-  }
-
-  if (event.method === "account/rateLimits/updated") {
-    if (!readPayload(EffectCodexSchema.V2AccountRateLimitsUpdatedNotification, event.payload)) {
-      return [];
-    }
-    return [
-      {
-        type: "account.rate-limits.updated",
-        ...runtimeEventBase(event, canonicalThreadId),
-        payload: {
-          rateLimits: event.payload ?? {},
-        },
-      },
-    ];
-  }
-
-  if (event.method === "mcpServer/oauthLogin/completed") {
-    const payload = readPayload(
-      EffectCodexSchema.V2McpServerOauthLoginCompletedNotification,
-      event.payload,
-    );
-    if (!payload) {
-      return [];
-    }
-    return [
-      {
-        type: "mcp.oauth.completed",
-        ...runtimeEventBase(event, canonicalThreadId),
-        payload: {
-          success: payload.success,
-          name: payload.name,
-          ...(trimText(payload.error) ? { error: trimText(payload.error) } : {}),
-        },
-      },
-    ];
-  }
-
-  if (event.method === "thread/realtime/started") {
-    const payload = readPayload(
-      EffectCodexSchema.V2ThreadRealtimeStartedNotification,
-      event.payload,
-    );
-    if (!payload) {
-      return [];
-    }
-    return [
-      {
-        type: "thread.realtime.started",
-        ...runtimeEventBase(event, canonicalThreadId),
-        payload: {
-          realtimeSessionId: payload.realtimeSessionId ?? undefined,
-        },
-      },
-    ];
-  }
-
-  if (event.method === "thread/realtime/itemAdded") {
-    const payload = readPayload(
-      EffectCodexSchema.V2ThreadRealtimeItemAddedNotification,
-      event.payload,
-    );
-    if (!payload) {
-      return [];
-    }
-    return [
-      {
-        type: "thread.realtime.item-added",
-        ...runtimeEventBase(event, canonicalThreadId),
-        payload: {
-          item: payload.item,
-        },
-      },
-    ];
-  }
-
-  if (event.method === "thread/realtime/outputAudio/delta") {
-    const payload = readPayload(
-      EffectCodexSchema.V2ThreadRealtimeOutputAudioDeltaNotification,
-      event.payload,
-    );
-    if (!payload) {
-      return [];
-    }
-    return [
-      {
-        type: "thread.realtime.audio.delta",
-        ...runtimeEventBase(event, canonicalThreadId),
-        payload: {
-          audio: payload.audio,
-        },
-      },
-    ];
-  }
-
-  if (event.method === "thread/realtime/error") {
-    const payload = readPayload(EffectCodexSchema.V2ThreadRealtimeErrorNotification, event.payload);
-    const message = payload?.message ?? event.message ?? "Realtime error";
-    return [
-      {
-        type: "thread.realtime.error",
-        ...runtimeEventBase(event, canonicalThreadId),
-        payload: {
-          message,
-        },
-      },
-    ];
-  }
-
-  if (event.method === "thread/realtime/closed") {
-    const payload = readPayload(
-      EffectCodexSchema.V2ThreadRealtimeClosedNotification,
-      event.payload,
-    );
-    return [
-      {
-        type: "thread.realtime.closed",
-        ...runtimeEventBase(event, canonicalThreadId),
-        payload: {
-          reason: payload?.reason ?? event.message,
-        },
-      },
-    ];
-  }
-
-  if (event.method === "error") {
-    const payload = readPayload(EffectCodexSchema.V2ErrorNotification, event.payload);
-    const message = payload?.error.message ?? event.message ?? "Provider runtime error";
-    const willRetry = payload?.willRetry === true;
-    return [
-      {
-        type: willRetry ? "runtime.warning" : "runtime.error",
-        ...runtimeEventBase(event, canonicalThreadId),
-        payload: {
-          message,
-          ...(!willRetry ? { class: "provider_error" as const } : {}),
-          ...(event.payload !== undefined ? { detail: event.payload } : {}),
-        },
-      },
-    ];
-  }
-
-  if (event.method === "process/stderr") {
-    const message = event.message ?? "Codex process stderr";
-    const isFatal = isFatalCodexProcessStderrMessage(message);
-    return [
-      isFatal
-        ? {
-            type: "runtime.error",
-            ...runtimeEventBase(event, canonicalThreadId),
-            payload: {
-              message,
-              class: "provider_error" as const,
-              ...(event.payload !== undefined ? { detail: event.payload } : {}),
-            },
-          }
-        : {
-            type: "runtime.warning",
-            ...runtimeEventBase(event, canonicalThreadId),
-            payload: {
-              message,
-              ...(event.payload !== undefined ? { detail: event.payload } : {}),
-            },
-          },
-    ];
-  }
-
-  if (event.method === "windows/worldWritableWarning") {
-    if (!readPayload(EffectCodexSchema.V2WindowsWorldWritableWarningNotification, event.payload)) {
-      return [];
-    }
-    return [
-      {
-        type: "runtime.warning",
-        ...runtimeEventBase(event, canonicalThreadId),
-        payload: {
-          message: event.message ?? "Windows world-writable warning",
-          ...(event.payload !== undefined ? { detail: event.payload } : {}),
-        },
-      },
-    ];
-  }
-
-  if (event.method === "windowsSandbox/setupCompleted") {
-    const payload = readPayload(
-      EffectCodexSchema.V2WindowsSandboxSetupCompletedNotification,
-      event.payload,
-    );
-    if (!payload) {
-      return [];
-    }
-    const successMessage = event.message ?? "Windows sandbox setup completed";
-    const failureMessage = event.message ?? "Windows sandbox setup failed";
-
-    return [
-      {
-        type: "session.state.changed",
-        ...runtimeEventBase(event, canonicalThreadId),
-        payload: {
-          state: payload.success === false ? "error" : "ready",
-          reason: payload.success === false ? failureMessage : successMessage,
-          ...(event.payload !== undefined ? { detail: event.payload } : {}),
-        },
-      },
-      ...(payload.success === false
-        ? [
-            {
-              type: "runtime.warning" as const,
-              ...runtimeEventBase(event, canonicalThreadId),
-              payload: {
-                message: failureMessage,
-                ...(event.payload !== undefined ? { detail: event.payload } : {}),
-              },
-            },
-          ]
-        : []),
-    ];
-  }
-
-  return [];
-}
-
-/**
- * Build a Codex provider adapter bound to a specific `CodexSettings` payload.
- *
- * The adapter is a captured closure over `codexConfig` — the `binaryPath` and
- * `homePath` are read from that payload, not from `ServerSettingsService`.
- * This is what makes multi-instance routing possible: each `ProviderInstance`
- * in the registry owns its own closure with its own config, so two Codex
- * instances with different `homePath`s cannot step on each other.
- */
-export const makeCodexAdapter = Effect.fn("makeCodexAdapter")(function* (
-  codexConfig: CodexSettings,
-  options?: CodexAdapterLiveOptions,
-) {
-  const boundInstanceId = options?.instanceId ?? ProviderInstanceId.make("codex");
-  const fileSystem = yield* FileSystem.FileSystem;
-  const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
-  const crypto = yield* Crypto.Crypto;
-  const serverConfig = yield* Effect.service(ServerConfig);
-  const nativeEventLogger =
-    options?.nativeEventLogger ??
-    (options?.nativeEventLogPath !== undefined
-      ? yield* makeEventNdjsonLogger(options.nativeEventLogPath, {
-          stream: "native",
-        })
-      : undefined);
-  const managedNativeEventLogger =
-    options?.nativeEventLogger === undefined ? nativeEventLogger : undefined;
-  const runtimeEventQueue = yield* Queue.unbounded<ProviderRuntimeEvent>();
-  const sessions = new Map<ThreadId, CodexAdapterSessionContext>();
-
-  const startSession: CodexAdapterShape["startSession"] = (input) =>
-    Effect.scoped(
-      Effect.gen(function* () {
-        if (input.provider !== undefined && input.provider !== PROVIDER) {
-          return yield* new ProviderAdapterValidationError({
-            provider: PROVIDER,
-            operation: "startSession",
-            issue: `Expected provider '${PROVIDER}' but received '${input.provider}'.`,
-          });
-        }
-
-        const existing = sessions.get(input.threadId);
-        if (existing && !existing.stopped) {
-          yield* Effect.suspend(() => stopSessionInternal(existing));
-        }
-
-        const serviceTier =
-          input.modelSelection?.instanceId === boundInstanceId
-            ? getCodexServiceTierOptionValue(input.modelSelection)
-            : undefined;
-        const mcpSession = McpProviderSession.readMcpProviderSession(input.threadId);
-        const runtimeInput: CodexSessionRuntimeOptions = {
-          threadId: input.threadId,
-          providerInstanceId: boundInstanceId,
-          cwd: input.cwd ?? process.cwd(),
-          binaryPath: codexConfig.binaryPath,
-          launchArgs: resolveCodexLaunchArgs(codexConfig.launchArgs, options?.environment),
-          ...(options?.environment ? { environment: options.environment } : {}),
-          ...(codexConfig.homePath ? { homePath: codexConfig.homePath } : {}),
-          ...(isCodexResumeCursorSchema(input.resumeCursor)
-            ? { resumeCursor: input.resumeCursor }
-            : {}),
-          runtimeMode: input.runtimeMode,
-          ...(input.modelSelection?.instanceId === boundInstanceId
-            ? { model: input.modelSelection.model }
-            : {}),
-          ...(serviceTier ? { serviceTier } : {}),
-          ...(mcpSession
-            ? {
-                environment: {
-                  ...(options?.environment ?? process.env),
-                  T3_MCP_BEARER_TOKEN: mcpSession.authorizationHeader.replace(/^Bearer\s+/, ""),
-                },
-                appServerArgs: [
-                  "-c",
-                  `mcp_servers.t3-code.url=${mcpSession.endpoint}`,
-                  "-c",
-                  'mcp_servers.t3-code.bearer_token_env_var="T3_MCP_BEARER_TOKEN"',
-                ],
-              }
-            : {}),
-        };
-        const sessionScope = yield* Scope.make("sequential");
-        let sessionScopeTransferred = false;
-        yield* Effect.addFinalizer(() =>
-          sessionScopeTransferred ? Effect.void : Scope.close(sessionScope, Exit.void),
-        );
-        const createRuntime = options?.makeRuntime ?? makeCodexSessionRuntime;
-        const runtime = yield* createRuntime(runtimeInput).pipe(
-          Effect.provideService(Scope.Scope, sessionScope),
-          Effect.provideService(ChildProcessSpawner.ChildProcessSpawner, childProcessSpawner),
-          Effect.provideService(Crypto.Crypto, crypto),
-          Effect.mapError(
-            (cause) =>
-              new ProviderAdapterProcessError({
-                provider: PROVIDER,
-                threadId: input.threadId,
-                detail: cause.message,
-                cause,
-              }),
-          ),
-        );
-
-        // Fork into the session scope, not the calling fiber. `forkChild` makes
-        // this a child of `startSession`, and Effect interrupts a fiber's
-        // children when it completes, so the consumer died on return and every
-        // runtime event the session emitted afterwards was dropped.
-        const eventFiber = yield* Stream.runForEach(runtime.events, (event) =>
-          Effect.gen(function* () {
-            yield* writeNativeEvent(event);
-            const runtimeEvents = mapToRuntimeEvents(event, event.threadId);
-            if (runtimeEvents.length === 0) {
-              yield* Effect.logDebug("ignoring unhandled Codex provider event", {
-                method: event.method,
-                threadId: event.threadId,
-                turnId: event.turnId,
-                itemId: event.itemId,
-              });
-              return;
-            }
-            yield* Queue.offerAll(runtimeEventQueue, runtimeEvents);
-          }),
-        ).pipe(Effect.forkIn(sessionScope));
-
-        const started = yield* runtime.start().pipe(
-          Effect.mapError(
-            (cause) =>
-              new ProviderAdapterProcessError({
-                provider: PROVIDER,
-                threadId: input.threadId,
-                detail: cause.message,
-                cause,
-              }),
-          ),
-          Effect.onError(() =>
-            runtime.close.pipe(
-              Effect.andThen(Effect.ignore(Scope.close(sessionScope, Exit.void))),
-              Effect.andThen(Fiber.interrupt(eventFiber)),
-              Effect.ignore,
-            ),
-          ),
-        );
-
-        sessions.set(input.threadId, {
-          threadId: input.threadId,
-          scope: sessionScope,
-          runtime,
-          eventFiber,
-          stopped: false,
-        });
-        sessionScopeTransferred = true;
-
-        return started;
-      }),
-    );
-
-  const resolveAttachment = Effect.fn("resolveAttachment")(function* (
-    input: ProviderSendTurnInput,
-    attachment: NonNullable<ProviderSendTurnInput["attachments"]>[number],
-  ) {
-    const attachmentPath = resolveAttachmentPath({
-      attachmentsDir: serverConfig.attachmentsDir,
-      attachment,
-    });
-    if (!attachmentPath) {
-      return yield* new ProviderAdapterRequestError({
-        provider: PROVIDER,
-        method: "turn/start",
-        detail: `Invalid attachment id '${attachment.id}'.`,
-      });
-    }
-    const bytes = yield* fileSystem.readFile(attachmentPath).pipe(
-      Effect.mapError(
-        (cause) =>
-          new ProviderAdapterRequestError({
-            provider: PROVIDER,
-            method: "turn/start",
-            detail: `Failed to read attachment file: ${cause.message}.`,
-            cause,
-          }),
-      ),
-    );
-    return {
-      type: "image" as const,
-      url: `data:${attachment.mimeType};base64,${Buffer.from(bytes).toString("base64")}`,
-    };
-  });
-
-  const sendTurn: CodexAdapterShape["sendTurn"] = Effect.fn("sendTurn")(function* (input) {
-    // Codex ingests images only. Anything else would be base64-encoded as an
-    // image and rejected or misread; generic files reach the agent through the
-    // path line ProviderService puts in the prompt.
-    const codexAttachments = yield* Effect.forEach(
-      (input.attachments ?? []).filter((attachment) => attachment.type === "image"),
-      (attachment) => resolveAttachment(input, attachment),
-      { concurrency: 1 },
-    );
-
-    const session = yield* requireSession(input.threadId);
-    const reasoningEffort =
-      input.modelSelection?.instanceId === boundInstanceId
-        ? getModelSelectionStringOptionValue(input.modelSelection, "reasoningEffort")
-        : undefined;
-    const serviceTier =
-      input.modelSelection?.instanceId === boundInstanceId
-        ? getCodexServiceTierOptionValue(input.modelSelection)
-        : undefined;
-    return yield* session.runtime
-      .sendTurn({
-        ...(input.input !== undefined ? { input: input.input } : {}),
-        ...(input.modelSelection?.instanceId === boundInstanceId
-          ? { model: input.modelSelection.model }
-          : {}),
-        ...(reasoningEffort
-          ? {
-              effort: reasoningEffort as EffectCodexSchema.V2TurnStartParams__ReasoningEffort,
-            }
-          : {}),
-        ...(serviceTier ? { serviceTier } : {}),
-        ...(input.interactionMode !== undefined ? { interactionMode: input.interactionMode } : {}),
-        ...(codexAttachments.length > 0 ? { attachments: codexAttachments } : {}),
-      })
-      .pipe(Effect.mapError((cause) => mapCodexRuntimeError(input.threadId, "turn/start", cause)));
-  });
-
-  const requireSession = Effect.fn("requireSession")(function* (threadId: ThreadId) {
-    const session = sessions.get(threadId);
-    if (!session || session.stopped) {
-      return yield* new ProviderAdapterSessionNotFoundError({
-        provider: PROVIDER,
-        threadId,
-      });
-    }
-    return session;
-  });
-
-  const interruptTurn: CodexAdapterShape["interruptTurn"] = (threadId, turnId) =>
-    requireSession(threadId).pipe(
-      Effect.flatMap((session) => session.runtime.interruptTurn(turnId)),
-      Effect.mapError((cause) =>
-        cause._tag === "ProviderAdapterSessionNotFoundError"
-          ? cause
-          : mapCodexRuntimeError(threadId, "turn/interrupt", cause),
-      ),
-    );
-
-  const readThread: CodexAdapterShape["readThread"] = (threadId) =>
-    requireSession(threadId).pipe(
-      Effect.flatMap((session) => session.runtime.readThread),
-      Effect.mapError((cause) =>
-        cause._tag === "ProviderAdapterSessionNotFoundError"
-          ? cause
-          : mapCodexRuntimeError(threadId, "thread/read", cause),
-      ),
-      Effect.map((snapshot) => ({
-        threadId,
-        turns: snapshot.turns,
-      })),
-    );
-
-  const rollbackThread: CodexAdapterShape["rollbackThread"] = (threadId, numTurns) => {
-    if (!Number.isInteger(numTurns) || numTurns < 1) {
-      return Effect.fail(
-        new ProviderAdapterValidationError({
-          provider: PROVIDER,
-          operation: "rollbackThread",
-          issue: "numTurns must be an integer >= 1.",
-        }),
-      );
-    }
-
-    return requireSession(threadId).pipe(
-      Effect.flatMap((session) => session.runtime.rollbackThread(numTurns)),
-      Effect.mapError((cause) =>
-        cause._tag === "ProviderAdapterSessionNotFoundError"
-          ? cause
-          : mapCodexRuntimeError(threadId, "thread/rollback", cause),
-      ),
-      Effect.map((snapshot) => ({
-        threadId,
-        turns: snapshot.turns,
-      })),
-    );
-  };
-
-  const uploadFeedback: CodexAdapterShape["uploadFeedback"] = (input) =>
-    requireSession(input.threadId).pipe(
-      Effect.flatMap((session) => session.runtime.uploadFeedback(input.reason)),
-      Effect.map(({ threadId }) => ({ feedbackId: threadId })),
-      Effect.mapError((cause) =>
-        cause._tag === "ProviderAdapterSessionNotFoundError"
-          ? cause
-          : mapCodexRuntimeError(input.threadId, "feedback/upload", cause),
-      ),
-    );
-
-  const respondToRequest: CodexAdapterShape["respondToRequest"] = (threadId, requestId, decision) =>
-    requireSession(threadId).pipe(
-      Effect.flatMap((session) => session.runtime.respondToRequest(requestId, decision)),
-      Effect.mapError((cause) =>
-        cause._tag === "ProviderAdapterSessionNotFoundError"
-          ? cause
-          : mapCodexRuntimeError(threadId, "item/requestApproval/decision", cause),
-      ),
-    );
-
-  const respondToUserInput: CodexAdapterShape["respondToUserInput"] = (
-    threadId,
-    requestId,
-    answers,
-  ) =>
-    requireSession(threadId).pipe(
-      Effect.flatMap((session) => session.runtime.respondToUserInput(requestId, answers)),
-      Effect.mapError((cause) =>
-        cause._tag === "ProviderAdapterSessionNotFoundError"
-          ? cause
-          : mapCodexRuntimeError(threadId, "item/tool/requestUserInput", cause),
-      ),
-    );
-
-  const writeNativeEvent = Effect.fnUntraced(function* (event: ProviderEvent) {
-    if (!nativeEventLogger) {
-      return;
-    }
-    yield* nativeEventLogger.write(event, event.threadId);
-  });
-
-  const stopSessionInternal = Effect.fn("stopSessionInternal")(function* (
-    session: CodexAdapterSessionContext,
-  ) {
-    if (session.stopped) {
-      return;
-    }
-    session.stopped = true;
-    sessions.delete(session.threadId);
-    yield* session.runtime.close.pipe(Effect.ignore);
-    yield* Effect.ignore(Scope.close(session.scope, Exit.void));
-    yield* Fiber.interrupt(session.eventFiber).pipe(Effect.ignore);
-  });
-
-  const stopSession: CodexAdapterShape["stopSession"] = (threadId) =>
-    Effect.gen(function* () {
-      const session = sessions.get(threadId);
-      if (!session) {
-        return;
-      }
-      yield* stopSessionInternal(session);
-    });
-
-  const listSessions: CodexAdapterShape["listSessions"] = () =>
-    Effect.forEach(
-      Array.from(sessions.values()).filter((session) => !session.stopped),
-      (session) => session.runtime.getSession,
-      { concurrency: 1 },
-    );
-
-  const hasSession: CodexAdapterShape["hasSession"] = (threadId) =>
-    Effect.succeed(Boolean(sessions.get(threadId) && !sessions.get(threadId)?.stopped));
-
-  const stopAll: CodexAdapterShape["stopAll"] = () =>
-    Effect.forEach(Array.from(sessions.values()), stopSessionInternal, {
-      concurrency: 1,
-      discard: true,
-    }).pipe(Effect.asVoid);
-
-  yield* Effect.acquireRelease(Effect.void, () =>
-    stopAll().pipe(
-      Effect.andThen(Queue.shutdown(runtimeEventQueue)),
-      Effect.andThen(managedNativeEventLogger?.close() ?? Effect.void),
-      Effect.ignore,
-    ),
-  );
-
-  return {
-    provider: PROVIDER,
-    capabilities: {
-      sessionModelSwitch: "in-session",
-    },
-    startSession,
-    sendTurn,
-    interruptTurn,
-    readThread,
-    rollbackThread,
-    uploadFeedback,
-    respondToRequest,
-    respondToUserInput,
-    stopSession,
-    listSessions,
-    hasSession,
-    stopAll,
-    get streamEvents() {
-      return Stream.fromQueue(runtimeEventQueue);
-    },
-  } satisfies CodexAdapterShape;
-});
-
-// NOTE: the old `CodexAdapterLive` / `makeCodexAdapterLive` singleton Layer
-// exports have been removed as part of the per-instance-driver refactor.
-// `makeCodexAdapter(codexConfig, options?)` is now invoked directly by
-// `CodexDriver.create()` for each configured instance; downstream consumers
-// (server bootstrap, integration harness, this module's tests) will be
-// migrated to the registry in a follow-up pass.
diff --git a/apps/server/src/provider/Layers/CursorAdapter.test.ts b/apps/server/src/provider/Layers/CursorAdapter.test.ts
deleted file mode 100644
index cd5cdb7f01aa..000000000000
--- a/apps/server/src/provider/Layers/CursorAdapter.test.ts
+++ /dev/null
@@ -1,1500 +0,0 @@
-// @effect-diagnostics nodeBuiltinImport:off
-import * as NodePath from "node:path";
-import * as NodeOS from "node:os";
-import * as NodeFSP from "node:fs/promises";
-import * as NodeURL from "node:url";
-
-import * as NodeServices from "@effect/platform-node/NodeServices";
-import { assert, it } from "@effect/vitest";
-import * as Context from "effect/Context";
-import * as Deferred from "effect/Deferred";
-import * as Effect from "effect/Effect";
-import * as Fiber from "effect/Fiber";
-import * as Layer from "effect/Layer";
-import * as Schema from "effect/Schema";
-import * as Stream from "effect/Stream";
-import * as TestClock from "effect/testing/TestClock";
-import { createModelSelection } from "@t3tools/shared/model";
-
-import {
-  ApprovalRequestId,
-  CursorSettings,
-  ProviderDriverKind,
-  type ProviderRuntimeEvent,
-  ThreadId,
-  ProviderInstanceId,
-} from "@t3tools/contracts";
-
-import { ServerConfig } from "../../config.ts";
-import { ServerSettingsService } from "../../serverSettings.ts";
-import type { CursorAdapterShape } from "../Services/CursorAdapter.ts";
-import { makeCursorAdapter } from "./CursorAdapter.ts";
-const decodeCursorSettings = Schema.decodeSync(CursorSettings);
-
-// Test-local service tag so the rest of the file can keep using `yield* CursorAdapter`.
-class CursorAdapter extends Context.Service<CursorAdapter, CursorAdapterShape>()(
-  "t3/provider/Layers/CursorAdapter.test/CursorAdapter",
-) {}
-
-const __dirname = NodePath.dirname(NodeURL.fileURLToPath(import.meta.url));
-const mockAgentPath = NodePath.join(__dirname, "../../../scripts/acp-mock-agent.ts");
-const mockAgentCommand = "node";
-const mockAgentArgs = [mockAgentPath] as const;
-
-async function makeMockAgentWrapper(
-  extraEnv?: Record<string, string>,
-  options?: { initialDelaySeconds?: number },
-) {
-  const dir = await NodeFSP.mkdtemp(NodePath.join(NodeOS.tmpdir(), "cursor-acp-mock-"));
-  const wrapperPath = NodePath.join(dir, "fake-agent.sh");
-  const envExports = Object.entries(extraEnv ?? {})
-    .map(([key, value]) => `export ${key}=${JSON.stringify(value)}`)
-    .join("\n");
-  const script = `#!/bin/sh
-${envExports}
-${options?.initialDelaySeconds ? `sleep ${JSON.stringify(String(options.initialDelaySeconds))}` : ""}
-exec ${JSON.stringify(mockAgentCommand)} ${mockAgentArgs.map((arg) => JSON.stringify(arg)).join(" ")} "$@"
-`;
-  await NodeFSP.writeFile(wrapperPath, script, "utf8");
-  await NodeFSP.chmod(wrapperPath, 0o755);
-  return wrapperPath;
-}
-
-async function makeProbeWrapper(
-  requestLogPath: string,
-  argvLogPath: string,
-  extraEnv?: Record<string, string>,
-) {
-  const dir = await NodeFSP.mkdtemp(NodePath.join(NodeOS.tmpdir(), "cursor-acp-probe-"));
-  const wrapperPath = NodePath.join(dir, "fake-agent.sh");
-  const envExports = Object.entries(extraEnv ?? {})
-    .map(([key, value]) => `export ${key}=${JSON.stringify(value)}`)
-    .join("\n");
-  const script = `#!/bin/sh
-printf '%s\t' "$@" >> ${JSON.stringify(argvLogPath)}
-printf '\n' >> ${JSON.stringify(argvLogPath)}
-export T3_ACP_REQUEST_LOG_PATH=${JSON.stringify(requestLogPath)}
-${envExports}
-exec ${JSON.stringify(mockAgentCommand)} ${mockAgentArgs.map((arg) => JSON.stringify(arg)).join(" ")} "$@"
-`;
-  await NodeFSP.writeFile(wrapperPath, script, "utf8");
-  await NodeFSP.chmod(wrapperPath, 0o755);
-  return wrapperPath;
-}
-
-async function readArgvLog(filePath: string) {
-  const raw = await NodeFSP.readFile(filePath, "utf8");
-  return raw
-    .split("\n")
-    .map((line) => line.trim())
-    .filter((line) => line.length > 0)
-    .map((line) => line.split("\t").filter((token) => token.length > 0));
-}
-
-async function readJsonLines(filePath: string) {
-  const raw = await NodeFSP.readFile(filePath, "utf8");
-  return raw
-    .split("\n")
-    .map((line) => line.trim())
-    .filter((line) => line.length > 0)
-    .map((line) => JSON.parse(line) as Record<string, unknown>);
-}
-
-async function waitForFileContent(filePath: string, attempts = 40) {
-  for (let attempt = 0; attempt < attempts; attempt += 1) {
-    try {
-      const raw = await NodeFSP.readFile(filePath, "utf8");
-      if (raw.trim().length > 0) {
-        return raw;
-      }
-    } catch {}
-    await Effect.runPromise(Effect.yieldNow);
-  }
-  throw new Error(`Timed out waiting for file content at ${filePath}`);
-}
-
-function waitForJsonLogMatch(
-  filePath: string,
-  predicate: (entry: Record<string, unknown>) => boolean,
-  attempts = 40,
-) {
-  return Effect.gen(function* () {
-    for (let attempt = 0; attempt < attempts; attempt += 1) {
-      const requests = yield* Effect.promise(() => readJsonLines(filePath));
-      if (requests.some(predicate)) {
-        return requests;
-      }
-      yield* Effect.yieldNow;
-    }
-    return yield* Effect.promise(() => readJsonLines(filePath));
-  });
-}
-
-// Tests mutate `ServerSettingsService` mid-flight (e.g. setting
-// `providers.cursor.binaryPath` to a mock ACP wrapper). The adapter
-// captures `cursorSettings` once at construction, so without a resolver
-// the mutation is invisible — sessions would spawn the constructor's
-// (empty) binary path. Wiring `resolveSettings` through
-// `ServerSettingsService.getSettings` makes each session read the latest
-// snapshot, matching the old "always read live" behavior that these
-// tests assumed.
-const makeResolveCursorSettings = Effect.gen(function* () {
-  const serverSettings = yield* ServerSettingsService;
-  return yield* Effect.succeed(
-    serverSettings.getSettings.pipe(
-      Effect.map((snapshot) => snapshot.providers.cursor),
-      Effect.orDie,
-    ),
-  );
-});
-
-const cursorAdapterTestLayer = it.layer(
-  Layer.effect(
-    CursorAdapter,
-    Effect.gen(function* () {
-      const cursorConfig = decodeCursorSettings({});
-      const resolveSettings = yield* makeResolveCursorSettings;
-      return yield* makeCursorAdapter(cursorConfig, { resolveSettings });
-    }),
-  ).pipe(
-    Layer.provideMerge(ServerSettingsService.layerTest()),
-    Layer.provideMerge(
-      ServerConfig.layerTest(process.cwd(), {
-        prefix: "t3code-cursor-adapter-test-",
-      }),
-    ),
-    Layer.provideMerge(NodeServices.layer),
-  ),
-);
-
-cursorAdapterTestLayer("CursorAdapterLive", (it) => {
-  it.effect("starts a session and maps mock ACP prompt flow to runtime events", () =>
-    Effect.gen(function* () {
-      const adapter = yield* CursorAdapter;
-      const settings = yield* ServerSettingsService;
-      const threadId = ThreadId.make("cursor-mock-thread");
-
-      const wrapperPath = yield* Effect.promise(() => makeMockAgentWrapper());
-      yield* settings.updateSettings({ providers: { cursor: { binaryPath: wrapperPath } } });
-
-      const runtimeEventsFiber = yield* Stream.take(adapter.streamEvents, 9).pipe(
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-
-      const session = yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("cursor"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-        modelSelection: { instanceId: ProviderInstanceId.make("cursor"), model: "default" },
-      });
-
-      assert.equal(session.provider, "cursor");
-      assert.deepStrictEqual(session.resumeCursor, {
-        schemaVersion: 1,
-        sessionId: "mock-session-1",
-      });
-
-      yield* adapter.sendTurn({
-        threadId,
-        input: "hello mock",
-        attachments: [],
-      });
-
-      const runtimeEvents = Array.from(yield* Fiber.join(runtimeEventsFiber));
-      const types = runtimeEvents.map((e) => e.type);
-
-      for (const t of [
-        "session.started",
-        "session.state.changed",
-        "thread.started",
-        "turn.started",
-        "turn.plan.updated",
-        "item.started",
-        "content.delta",
-        "item.completed",
-        "turn.completed",
-      ] as const) {
-        assert.include(types, t);
-      }
-
-      const assistantStarted = runtimeEvents.find(
-        (event) => event.type === "item.started" && event.payload.itemType === "assistant_message",
-      );
-      assert.isDefined(assistantStarted);
-
-      const delta = runtimeEvents.find((e) => e.type === "content.delta");
-      assert.isDefined(delta);
-      if (delta?.type === "content.delta") {
-        assert.equal(delta.payload.delta, "hello from mock");
-        assert.match(String(delta.itemId), /^assistant:mock-session-1:runtime:[^:]+:segment:0$/);
-      }
-
-      const assistantCompleted = runtimeEvents.find(
-        (event) =>
-          event.type === "item.completed" && event.payload.itemType === "assistant_message",
-      );
-      assert.isDefined(assistantCompleted);
-
-      const planUpdate = runtimeEvents.find((event) => event.type === "turn.plan.updated");
-      assert.isDefined(planUpdate);
-      if (planUpdate?.type === "turn.plan.updated") {
-        assert.deepStrictEqual(planUpdate.payload.plan, [
-          { step: "Inspect mock ACP state", status: "completed" },
-          { step: "Implement the requested change", status: "inProgress" },
-        ]);
-      }
-
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("steers a running turn instead of opening a new one on mid-turn sendTurn", () =>
-    Effect.gen(function* () {
-      const adapter = yield* CursorAdapter;
-      const settings = yield* ServerSettingsService;
-      const threadId = ThreadId.make("cursor-steer-thread");
-
-      // Keep the first prompt in flight long enough for the steer to land.
-      const wrapperPath = yield* Effect.promise(() =>
-        makeMockAgentWrapper({ T3_ACP_PROMPT_DELAY_MS: "1500" }),
-      );
-      yield* settings.updateSettings({ providers: { cursor: { binaryPath: wrapperPath } } });
-
-      const runtimeEventsFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter((event) => event.threadId === threadId),
-        Stream.takeUntil((event) => event.type === "turn.completed"),
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("cursor"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-        modelSelection: { instanceId: ProviderInstanceId.make("cursor"), model: "default" },
-      });
-
-      const firstTurnFiber = yield* adapter
-        .sendTurn({
-          threadId,
-          input: "run 5 commands",
-          attachments: [],
-        })
-        .pipe(Effect.forkChild);
-
-      // Poll until the first prompt is in flight — sendTurn binds the active
-      // turn id before prompting. The mock agent runs on the real clock, so
-      // each TestClock.adjust just provides the scheduler hops for its stdio
-      // responses to land.
-      yield* Effect.gen(function* () {
-        for (let attempt = 0; attempt < 200; attempt += 1) {
-          const sessions = yield* adapter.listSessions();
-          const session = sessions.find((entry) => entry.threadId === threadId);
-          if (session?.activeTurnId !== undefined) {
-            return;
-          }
-          yield* TestClock.adjust("10 millis");
-        }
-        throw new Error("Timed out waiting for the first prompt to be in flight.");
-      });
-
-      // Steer: a second sendTurn while the first prompt is still in flight
-      // continues the same turn.
-      const steeredTurn = yield* adapter.sendTurn({
-        threadId,
-        input: "actually run 15",
-        attachments: [],
-      });
-      const firstTurn = yield* Fiber.join(firstTurnFiber);
-      assert.equal(String(steeredTurn.turnId), String(firstTurn.turnId));
-
-      const runtimeEvents = Array.from(yield* Fiber.join(runtimeEventsFiber));
-      const turnStartedEvents = runtimeEvents.filter((event) => event.type === "turn.started");
-      const turnCompletedEvents = runtimeEvents.filter((event) => event.type === "turn.completed");
-
-      // One turn boundary for the whole run: the superseded first prompt
-      // resolving must not settle the merged turn.
-      assert.equal(turnStartedEvents.length, 1);
-      assert.equal(String(turnStartedEvents[0]?.turnId), String(firstTurn.turnId));
-      assert.equal(turnCompletedEvents.length, 1);
-      assert.equal(String(turnCompletedEvents[0]?.turnId), String(firstTurn.turnId));
-
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("closes the ACP child process when a session stops", () =>
-    Effect.gen(function* () {
-      const adapter = yield* CursorAdapter;
-      const settings = yield* ServerSettingsService;
-      const threadId = ThreadId.make("cursor-stop-session-close");
-      const tempDir = yield* Effect.promise(() =>
-        NodeFSP.mkdtemp(NodePath.join(NodeOS.tmpdir(), "cursor-adapter-exit-log-")),
-      );
-      const exitLogPath = NodePath.join(tempDir, "exit.log");
-
-      const wrapperPath = yield* Effect.promise(() =>
-        makeMockAgentWrapper({
-          T3_ACP_EXIT_LOG_PATH: exitLogPath,
-        }),
-      );
-      yield* settings.updateSettings({ providers: { cursor: { binaryPath: wrapperPath } } });
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("cursor"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-        modelSelection: { instanceId: ProviderInstanceId.make("cursor"), model: "default" },
-      });
-
-      yield* adapter.stopSession(threadId);
-
-      const exitLog = yield* Effect.promise(() => waitForFileContent(exitLogPath));
-      assert.include(exitLog, "SIGTERM");
-    }),
-  );
-
-  it.effect(
-    "serializes concurrent startSession calls for the same thread and closes the replaced ACP session",
-    () =>
-      Effect.gen(function* () {
-        const adapter = yield* CursorAdapter;
-        const settings = yield* ServerSettingsService;
-        const threadId = ThreadId.make("cursor-concurrent-start-session");
-        const tempDir = yield* Effect.promise(() =>
-          NodeFSP.mkdtemp(NodePath.join(NodeOS.tmpdir(), "cursor-adapter-concurrent-exit-log-")),
-        );
-        const exitLogPath = NodePath.join(tempDir, "exit.log");
-
-        const wrapperPath = yield* Effect.promise(() =>
-          makeMockAgentWrapper(
-            {
-              T3_ACP_EXIT_LOG_PATH: exitLogPath,
-            },
-            { initialDelaySeconds: 0.2 },
-          ),
-        );
-        yield* settings.updateSettings({ providers: { cursor: { binaryPath: wrapperPath } } });
-
-        const [firstSession, secondSession] = yield* Effect.all(
-          [
-            adapter.startSession({
-              threadId,
-              provider: ProviderDriverKind.make("cursor"),
-              cwd: process.cwd(),
-              runtimeMode: "full-access",
-              modelSelection: { instanceId: ProviderInstanceId.make("cursor"), model: "default" },
-            }),
-            adapter.startSession({
-              threadId,
-              provider: ProviderDriverKind.make("cursor"),
-              cwd: process.cwd(),
-              runtimeMode: "full-access",
-              modelSelection: { instanceId: ProviderInstanceId.make("cursor"), model: "default" },
-            }),
-          ],
-          { concurrency: "unbounded" },
-        );
-
-        assert.equal(firstSession.threadId, threadId);
-        assert.equal(secondSession.threadId, threadId);
-
-        yield* adapter.stopSession(threadId);
-
-        const exitLog = yield* Effect.promise(() => waitForFileContent(exitLogPath));
-        assert.equal(exitLog.match(/SIGTERM/g)?.length ?? 0, 2);
-      }),
-  );
-
-  it.effect("rejects startSession when provider mismatches", () =>
-    Effect.gen(function* () {
-      const adapter = yield* CursorAdapter;
-      const result = yield* adapter
-        .startSession({
-          threadId: ThreadId.make("bad-provider"),
-          provider: ProviderDriverKind.make("codex"),
-          cwd: process.cwd(),
-          runtimeMode: "full-access",
-        })
-        .pipe(Effect.result);
-
-      assert.equal(result._tag, "Failure");
-    }),
-  );
-
-  it.effect("maps app plan mode onto the ACP plan session mode", () =>
-    Effect.gen(function* () {
-      const adapter = yield* CursorAdapter;
-      const serverSettings = yield* ServerSettingsService;
-      const threadId = ThreadId.make("cursor-plan-mode-probe");
-      const tempDir = yield* Effect.promise(() =>
-        NodeFSP.mkdtemp(NodePath.join(NodeOS.tmpdir(), "cursor-acp-")),
-      );
-      const requestLogPath = NodePath.join(tempDir, "requests.ndjson");
-      const argvLogPath = NodePath.join(tempDir, "argv.txt");
-      yield* Effect.promise(() => NodeFSP.writeFile(requestLogPath, "", "utf8"));
-      const wrapperPath = yield* Effect.promise(() =>
-        makeProbeWrapper(requestLogPath, argvLogPath),
-      );
-      yield* serverSettings.updateSettings({ providers: { cursor: { binaryPath: wrapperPath } } });
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("cursor"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-        modelSelection: { instanceId: ProviderInstanceId.make("cursor"), model: "composer-2" },
-      });
-
-      yield* adapter.sendTurn({
-        threadId,
-        input: "plan this change",
-        attachments: [],
-        interactionMode: "plan",
-      });
-      yield* adapter.stopSession(threadId);
-
-      const requests = yield* Effect.promise(() => readJsonLines(requestLogPath));
-      const modeRequest = requests
-        .toReversed()
-        .find(
-          (entry) =>
-            entry.method === "session/set_mode" ||
-            (entry.method === "session/set_config_option" &&
-              (entry.params as Record<string, unknown> | undefined)?.configId === "mode"),
-        );
-      assert.isDefined(modeRequest);
-      assert.equal(
-        (modeRequest?.params as Record<string, unknown> | undefined)?.sessionId,
-        "mock-session-1",
-      );
-      assert.include(
-        ["architect", "plan"],
-        String(
-          (modeRequest?.params as Record<string, unknown> | undefined)?.modeId ??
-            (modeRequest?.params as Record<string, unknown> | undefined)?.value,
-        ),
-      );
-    }),
-  );
-
-  it.effect(
-    "applies initial model and mode configuration during startSession and skips repeating it on first send",
-    () =>
-      Effect.gen(function* () {
-        const adapter = yield* CursorAdapter;
-        const serverSettings = yield* ServerSettingsService;
-        const threadId = ThreadId.make("cursor-initial-config-probe");
-        const tempDir = yield* Effect.promise(() =>
-          NodeFSP.mkdtemp(NodePath.join(NodeOS.tmpdir(), "cursor-acp-")),
-        );
-        const requestLogPath = NodePath.join(tempDir, "requests.ndjson");
-        const argvLogPath = NodePath.join(tempDir, "argv.txt");
-        yield* Effect.promise(() => NodeFSP.writeFile(requestLogPath, "", "utf8"));
-        const wrapperPath = yield* Effect.promise(() =>
-          makeProbeWrapper(requestLogPath, argvLogPath),
-        );
-        yield* serverSettings.updateSettings({
-          providers: { cursor: { binaryPath: wrapperPath } },
-        });
-
-        const modelSelection = createModelSelection(ProviderInstanceId.make("cursor"), "gpt-5.4", [
-          { id: "reasoning", value: "xhigh" },
-          { id: "contextWindow", value: "1m" },
-          { id: "fastMode", value: true },
-        ]);
-
-        yield* adapter.startSession({
-          threadId,
-          provider: ProviderDriverKind.make("cursor"),
-          cwd: process.cwd(),
-          runtimeMode: "full-access",
-          modelSelection,
-        });
-
-        yield* Effect.promise(() => waitForFileContent(requestLogPath));
-
-        const requestsAfterStart = yield* Effect.promise(() => readJsonLines(requestLogPath));
-        const configIdsAfterStart = requestsAfterStart.flatMap((entry) =>
-          entry.method === "session/set_config_option" &&
-          typeof (entry.params as Record<string, unknown> | undefined)?.configId === "string"
-            ? [String((entry.params as Record<string, unknown>).configId)]
-            : [],
-        );
-        assert.deepStrictEqual(configIdsAfterStart, [
-          "model",
-          "reasoning",
-          "context",
-          "fast",
-          "mode",
-        ]);
-
-        yield* adapter.sendTurn({
-          threadId,
-          input: "hello mock",
-          attachments: [],
-          modelSelection,
-          interactionMode: "default",
-        });
-        yield* adapter.stopSession(threadId);
-
-        const finalRequests = yield* Effect.promise(() => readJsonLines(requestLogPath));
-        const finalConfigIds = finalRequests.flatMap((entry) =>
-          entry.method === "session/set_config_option" &&
-          typeof (entry.params as Record<string, unknown> | undefined)?.configId === "string"
-            ? [String((entry.params as Record<string, unknown>).configId)]
-            : [],
-        );
-        assert.deepStrictEqual(finalConfigIds, ["model", "reasoning", "context", "fast", "mode"]);
-        assert.equal(finalRequests.filter((entry) => entry.method === "session/prompt").length, 1);
-      }),
-  );
-
-  it.effect(
-    "streams ACP tool calls and approvals on the active turn in approval-required mode",
-    () =>
-      Effect.gen(function* () {
-        const previousEmitToolCalls = process.env.T3_ACP_EMIT_TOOL_CALLS;
-        process.env.T3_ACP_EMIT_TOOL_CALLS = "1";
-
-        const adapter = yield* CursorAdapter;
-        const serverSettings = yield* ServerSettingsService;
-        const threadId = ThreadId.make("cursor-tool-call-probe");
-        const runtimeEvents: Array<ProviderRuntimeEvent> = [];
-        const settledEventTypes = new Set<string>();
-        const settledEventsReady = yield* Deferred.make<void>();
-
-        const wrapperPath = yield* Effect.promise(() =>
-          makeMockAgentWrapper({ T3_ACP_EMIT_TOOL_CALLS: "1" }),
-        );
-        yield* serverSettings.updateSettings({
-          providers: { cursor: { binaryPath: wrapperPath } },
-        });
-
-        yield* Stream.runForEach(adapter.streamEvents, (event) =>
-          Effect.gen(function* () {
-            runtimeEvents.push(event);
-            if (String(event.threadId) !== String(threadId)) {
-              return;
-            }
-            if (event.type === "request.opened" && event.requestId) {
-              yield* adapter.respondToRequest(
-                threadId,
-                ApprovalRequestId.make(String(event.requestId)),
-                "accept",
-              );
-            }
-            if (
-              event.type === "turn.completed" ||
-              (event.type === "item.completed" && event.payload.itemType === "command_execution") ||
-              event.type === "content.delta"
-            ) {
-              settledEventTypes.add(event.type);
-              if (settledEventTypes.size === 3) {
-                yield* Deferred.succeed(settledEventsReady, undefined).pipe(Effect.orDie);
-              }
-            }
-          }),
-        ).pipe(Effect.forkChild);
-
-        const program = Effect.gen(function* () {
-          yield* adapter.startSession({
-            threadId,
-            provider: ProviderDriverKind.make("cursor"),
-            cwd: process.cwd(),
-            runtimeMode: "approval-required",
-            modelSelection: { instanceId: ProviderInstanceId.make("cursor"), model: "default" },
-          });
-
-          const turn = yield* adapter.sendTurn({
-            threadId,
-            input: "run a tool call",
-            attachments: [],
-          });
-          yield* Deferred.await(settledEventsReady);
-
-          const threadEvents = runtimeEvents.filter(
-            (event) => String(event.threadId) === String(threadId),
-          );
-          assert.includeMembers(
-            threadEvents.map((event) => event.type),
-            [
-              "session.started",
-              "session.state.changed",
-              "thread.started",
-              "turn.started",
-              "request.opened",
-              "request.resolved",
-              "item.updated",
-              "item.completed",
-              "content.delta",
-              "turn.completed",
-            ],
-          );
-
-          const turnEvents = threadEvents.filter(
-            (event) => String(event.turnId) === String(turn.turnId),
-          );
-          const toolUpdates = turnEvents.filter((event) => event.type === "item.updated");
-          // ACP updates can arrive either as distinct pending + in-progress events
-          // or as a single coalesced in-progress update before approval resolves.
-          assert.isAtLeast(toolUpdates.length, 1);
-          for (const toolUpdate of toolUpdates) {
-            if (toolUpdate.type !== "item.updated") {
-              continue;
-            }
-            assert.equal(toolUpdate.payload.itemType, "command_execution");
-            assert.equal(toolUpdate.payload.status, "inProgress");
-            assert.equal(toolUpdate.payload.detail, "cat server/package.json");
-            assert.equal(String(toolUpdate.itemId), "tool-call-1");
-          }
-
-          const requestOpened = turnEvents.find((event) => event.type === "request.opened");
-          assert.isDefined(requestOpened);
-          if (requestOpened?.type === "request.opened") {
-            assert.equal(String(requestOpened.turnId), String(turn.turnId));
-            assert.equal(requestOpened.payload.requestType, "exec_command_approval");
-            assert.equal(requestOpened.payload.detail, "cat server/package.json");
-          }
-
-          const requestResolved = turnEvents.find((event) => event.type === "request.resolved");
-          assert.isDefined(requestResolved);
-          if (requestResolved?.type === "request.resolved") {
-            assert.equal(String(requestResolved.turnId), String(turn.turnId));
-            assert.equal(requestResolved.payload.requestType, "exec_command_approval");
-            assert.equal(requestResolved.payload.decision, "accept");
-          }
-
-          const toolCompleted = turnEvents.find(
-            (event) =>
-              event.type === "item.completed" && event.payload.itemType === "command_execution",
-          );
-          assert.isDefined(toolCompleted);
-          if (toolCompleted?.type === "item.completed") {
-            assert.equal(String(toolCompleted.turnId), String(turn.turnId));
-            assert.equal(toolCompleted.payload.itemType, "command_execution");
-            assert.equal(toolCompleted.payload.status, "completed");
-            assert.equal(toolCompleted.payload.detail, "cat server/package.json");
-            assert.equal(String(toolCompleted.itemId), "tool-call-1");
-          }
-
-          const contentDelta = turnEvents.find((event) => event.type === "content.delta");
-          assert.isDefined(contentDelta);
-          if (contentDelta?.type === "content.delta") {
-            assert.equal(String(contentDelta.turnId), String(turn.turnId));
-            assert.equal(contentDelta.payload.delta, "hello from mock");
-            assert.match(
-              String(contentDelta.itemId),
-              /^assistant:mock-session-1:runtime:[^:]+:segment:0$/,
-            );
-          }
-        });
-
-        yield* program.pipe(
-          Effect.ensuring(
-            Effect.sync(() => {
-              if (previousEmitToolCalls === undefined) {
-                delete process.env.T3_ACP_EMIT_TOOL_CALLS;
-              } else {
-                process.env.T3_ACP_EMIT_TOOL_CALLS = previousEmitToolCalls;
-              }
-            }),
-          ),
-        );
-      }).pipe(
-        Effect.provide(
-          Layer.effect(
-            CursorAdapter,
-            Effect.gen(function* () {
-              const cursorConfig = decodeCursorSettings({});
-              const resolveSettings = yield* makeResolveCursorSettings;
-              return yield* makeCursorAdapter(cursorConfig, { resolveSettings });
-            }),
-          ).pipe(
-            Layer.provideMerge(ServerSettingsService.layerTest()),
-            Layer.provideMerge(
-              ServerConfig.layerTest(process.cwd(), {
-                prefix: "t3code-cursor-adapter-test-",
-              }),
-            ),
-            Layer.provideMerge(NodeServices.layer),
-          ),
-        ),
-      ),
-  );
-
-  it.effect(
-    "auto-approves ACP tool permissions in full-access mode without approval runtime events",
-    () =>
-      Effect.gen(function* () {
-        const adapter = yield* CursorAdapter;
-        const serverSettings = yield* ServerSettingsService;
-        const threadId = ThreadId.make("cursor-full-access-auto-approve");
-        const runtimeEvents: Array<ProviderRuntimeEvent> = [];
-        const settledEventTypes = new Set<string>();
-        const settledEventsReady = yield* Deferred.make<void>();
-        const tempDir = yield* Effect.promise(() =>
-          NodeFSP.mkdtemp(NodePath.join(NodeOS.tmpdir(), "cursor-acp-")),
-        );
-        const requestLogPath = NodePath.join(tempDir, "requests.ndjson");
-        const argvLogPath = NodePath.join(tempDir, "argv.txt");
-        yield* Effect.promise(() => NodeFSP.writeFile(requestLogPath, "", "utf8"));
-        const wrapperPath = yield* Effect.promise(() =>
-          makeProbeWrapper(requestLogPath, argvLogPath, { T3_ACP_EMIT_TOOL_CALLS: "1" }),
-        );
-        yield* serverSettings.updateSettings({
-          providers: { cursor: { binaryPath: wrapperPath } },
-        });
-
-        const runtimeEventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) =>
-          Effect.gen(function* () {
-            runtimeEvents.push(event);
-            if (String(event.threadId) !== String(threadId)) {
-              return;
-            }
-            if (
-              event.type === "turn.completed" ||
-              (event.type === "item.completed" && event.payload.itemType === "command_execution") ||
-              event.type === "content.delta"
-            ) {
-              settledEventTypes.add(event.type);
-              if (settledEventTypes.size === 3) {
-                yield* Deferred.succeed(settledEventsReady, undefined).pipe(Effect.orDie);
-              }
-            }
-          }),
-        ).pipe(Effect.forkChild);
-
-        yield* adapter.startSession({
-          threadId,
-          provider: ProviderDriverKind.make("cursor"),
-          cwd: process.cwd(),
-          runtimeMode: "full-access",
-          modelSelection: { instanceId: ProviderInstanceId.make("cursor"), model: "default" },
-        });
-
-        const turn = yield* adapter.sendTurn({
-          threadId,
-          input: "run a tool call",
-          attachments: [],
-        });
-
-        yield* Deferred.await(settledEventsReady);
-        yield* Fiber.interrupt(runtimeEventsFiber);
-
-        const turnEvents = runtimeEvents.filter(
-          (event) =>
-            String(event.threadId) === String(threadId) &&
-            String(event.turnId) === String(turn.turnId),
-        );
-        assert.notInclude(
-          turnEvents.map((event) => event.type),
-          "request.opened",
-        );
-        assert.notInclude(
-          turnEvents.map((event) => event.type),
-          "request.resolved",
-        );
-        assert.includeMembers(
-          turnEvents.map((event) => event.type),
-          ["item.updated", "item.completed", "content.delta", "turn.completed"],
-        );
-
-        const requests = yield* Effect.promise(() => readJsonLines(requestLogPath));
-        const permissionResponse = requests.find(
-          (entry) =>
-            !("method" in entry) &&
-            typeof entry.result === "object" &&
-            entry.result !== null &&
-            "outcome" in entry.result &&
-            typeof entry.result.outcome === "object" &&
-            entry.result.outcome !== null &&
-            "outcome" in entry.result.outcome &&
-            entry.result.outcome.outcome === "selected" &&
-            "optionId" in entry.result.outcome &&
-            entry.result.outcome.optionId === "allow-always",
-        );
-        assert.isDefined(permissionResponse);
-
-        yield* adapter.stopSession(threadId);
-      }),
-  );
-
-  it.effect("segments assistant messages around ACP tool activity in full-access mode", () =>
-    Effect.gen(function* () {
-      const adapter = yield* CursorAdapter;
-      const serverSettings = yield* ServerSettingsService;
-      const threadId = ThreadId.make("cursor-assistant-tool-segmentation");
-      const runtimeEvents: Array<ProviderRuntimeEvent> = [];
-      const settledEventTypes = new Set<string>();
-      const settledEventsReady = yield* Deferred.make<void>();
-
-      const wrapperPath = yield* Effect.promise(() =>
-        makeMockAgentWrapper({ T3_ACP_EMIT_INTERLEAVED_ASSISTANT_TOOL_CALLS: "1" }),
-      );
-      yield* serverSettings.updateSettings({
-        providers: { cursor: { binaryPath: wrapperPath } },
-      });
-
-      const runtimeEventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) =>
-        Effect.gen(function* () {
-          runtimeEvents.push(event);
-          if (String(event.threadId) !== String(threadId)) {
-            return;
-          }
-          if (
-            event.type === "content.delta" ||
-            (event.type === "item.completed" && event.payload.itemType === "command_execution") ||
-            event.type === "turn.completed"
-          ) {
-            if (event.type === "content.delta") {
-              settledEventTypes.add(`delta:${event.payload.delta}`);
-            } else {
-              settledEventTypes.add(event.type);
-            }
-            if (
-              settledEventTypes.has("delta:before tool") &&
-              settledEventTypes.has("delta:after tool") &&
-              settledEventTypes.has("item.completed") &&
-              settledEventTypes.has("turn.completed")
-            ) {
-              yield* Deferred.succeed(settledEventsReady, undefined).pipe(Effect.orDie);
-            }
-          }
-        }),
-      ).pipe(Effect.forkChild);
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("cursor"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-        modelSelection: { instanceId: ProviderInstanceId.make("cursor"), model: "default" },
-      });
-
-      const turn = yield* adapter.sendTurn({
-        threadId,
-        input: "run an interleaved tool call",
-        attachments: [],
-      });
-
-      yield* Deferred.await(settledEventsReady);
-      yield* Fiber.interrupt(runtimeEventsFiber);
-
-      const turnEvents = runtimeEvents.filter(
-        (event) =>
-          String(event.threadId) === String(threadId) &&
-          String(event.turnId) === String(turn.turnId),
-      );
-      const firstAssistantStartIndex = turnEvents.findIndex(
-        (event) => event.type === "item.started" && event.payload.itemType === "assistant_message",
-      );
-      const firstAssistantDeltaIndex = turnEvents.findIndex(
-        (event) => event.type === "content.delta" && event.payload.delta === "before tool",
-      );
-      const assistantBoundaryIndex = turnEvents.findIndex(
-        (event) =>
-          event.type === "item.completed" && event.payload.itemType === "assistant_message",
-      );
-      const toolUpdateIndex = turnEvents.findIndex(
-        (event) => event.type === "item.updated" && event.payload.itemType === "command_execution",
-      );
-      const toolCompletedIndex = turnEvents.findIndex(
-        (event) =>
-          event.type === "item.completed" && event.payload.itemType === "command_execution",
-      );
-      const secondAssistantStartIndex = turnEvents.findIndex(
-        (event, index) =>
-          index > toolCompletedIndex &&
-          event.type === "item.started" &&
-          event.payload.itemType === "assistant_message",
-      );
-      const secondAssistantDeltaIndex = turnEvents.findIndex(
-        (event) => event.type === "content.delta" && event.payload.delta === "after tool",
-      );
-
-      assert.isAtLeast(firstAssistantStartIndex, 0);
-      assert.isAtLeast(firstAssistantDeltaIndex, 0);
-      assert.isAtLeast(assistantBoundaryIndex, 0);
-      assert.isAtLeast(toolUpdateIndex, 0);
-      assert.isAtLeast(toolCompletedIndex, 0);
-      assert.isAtLeast(secondAssistantStartIndex, 0);
-      assert.isAtLeast(secondAssistantDeltaIndex, 0);
-      assert.isBelow(firstAssistantStartIndex, firstAssistantDeltaIndex);
-      assert.isBelow(firstAssistantDeltaIndex, assistantBoundaryIndex);
-      assert.isBelow(assistantBoundaryIndex, toolUpdateIndex);
-      assert.isBelow(toolUpdateIndex, toolCompletedIndex);
-      assert.isBelow(toolCompletedIndex, secondAssistantStartIndex);
-      assert.isBelow(secondAssistantStartIndex, secondAssistantDeltaIndex);
-
-      const assistantStarts = turnEvents.filter(
-        (event) => event.type === "item.started" && event.payload.itemType === "assistant_message",
-      );
-      const assistantDeltas = turnEvents.filter((event) => event.type === "content.delta");
-      assert.lengthOf(assistantStarts, 2);
-      assert.lengthOf(assistantDeltas, 2);
-      if (
-        assistantStarts[0]?.type === "item.started" &&
-        assistantStarts[1]?.type === "item.started" &&
-        assistantDeltas[0]?.type === "content.delta" &&
-        assistantDeltas[1]?.type === "content.delta"
-      ) {
-        assert.notEqual(String(assistantStarts[0].itemId), String(assistantStarts[1].itemId));
-        assert.equal(String(assistantDeltas[0].itemId), String(assistantStarts[0].itemId));
-        assert.equal(String(assistantDeltas[1].itemId), String(assistantStarts[1].itemId));
-      }
-
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("cancels pending ACP approvals and marks the turn cancelled when interrupted", () =>
-    Effect.gen(function* () {
-      const adapter = yield* CursorAdapter;
-      const serverSettings = yield* ServerSettingsService;
-      const threadId = ThreadId.make("cursor-cancel-probe");
-      const tempDir = yield* Effect.promise(() =>
-        NodeFSP.mkdtemp(NodePath.join(NodeOS.tmpdir(), "cursor-acp-")),
-      );
-      const requestLogPath = NodePath.join(tempDir, "requests.ndjson");
-      const argvLogPath = NodePath.join(tempDir, "argv.txt");
-      yield* Effect.promise(() => NodeFSP.writeFile(requestLogPath, "", "utf8"));
-      const wrapperPath = yield* Effect.promise(() =>
-        makeProbeWrapper(requestLogPath, argvLogPath, { T3_ACP_EMIT_TOOL_CALLS: "1" }),
-      );
-      yield* serverSettings.updateSettings({ providers: { cursor: { binaryPath: wrapperPath } } });
-
-      const requestResolvedReady = yield* Deferred.make<ProviderRuntimeEvent>();
-      const turnCompletedReady = yield* Deferred.make<ProviderRuntimeEvent>();
-      let interrupted = false;
-
-      const runtimeEventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) =>
-        Effect.gen(function* () {
-          if (String(event.threadId) !== String(threadId)) {
-            return;
-          }
-          if (event.type === "request.opened" && event.requestId && !interrupted) {
-            interrupted = true;
-            yield* adapter.respondToRequest(
-              threadId,
-              ApprovalRequestId.make(String(event.requestId)),
-              "cancel",
-            );
-            yield* adapter.interruptTurn(threadId);
-            return;
-          }
-          if (event.type === "request.resolved") {
-            yield* Deferred.succeed(requestResolvedReady, event).pipe(Effect.ignore);
-            return;
-          }
-          if (event.type === "turn.completed") {
-            yield* Deferred.succeed(turnCompletedReady, event).pipe(Effect.ignore);
-          }
-        }),
-      ).pipe(Effect.forkChild);
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("cursor"),
-        cwd: process.cwd(),
-        runtimeMode: "approval-required",
-        modelSelection: { instanceId: ProviderInstanceId.make("cursor"), model: "default" },
-      });
-
-      const sendTurnFiber = yield* adapter
-        .sendTurn({
-          threadId,
-          input: "cancel this turn",
-          attachments: [],
-        })
-        .pipe(Effect.forkChild);
-
-      const requestResolved = yield* Deferred.await(requestResolvedReady);
-      const turnCompleted = yield* Deferred.await(turnCompletedReady);
-      yield* Fiber.join(sendTurnFiber);
-      yield* Fiber.interrupt(runtimeEventsFiber);
-
-      assert.equal(requestResolved.type, "request.resolved");
-      if (requestResolved.type === "request.resolved") {
-        assert.equal(requestResolved.payload.decision, "cancel");
-      }
-
-      assert.equal(turnCompleted.type, "turn.completed");
-      if (turnCompleted.type === "turn.completed") {
-        assert.equal(turnCompleted.payload.state, "cancelled");
-        assert.equal(turnCompleted.payload.stopReason, "cancelled");
-      }
-
-      const isCancelledApprovalResponse = (entry: Record<string, unknown>) =>
-        !("method" in entry) &&
-        typeof entry.result === "object" &&
-        entry.result !== null &&
-        "outcome" in entry.result &&
-        typeof entry.result.outcome === "object" &&
-        entry.result.outcome !== null &&
-        "outcome" in entry.result.outcome &&
-        entry.result.outcome.outcome === "cancelled";
-      const approvalResponses = yield* waitForJsonLogMatch(
-        requestLogPath,
-        isCancelledApprovalResponse,
-      );
-      assert.isTrue(approvalResponses.some(isCancelledApprovalResponse));
-
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-  it.effect("stopping a session settles pending approval waits", () =>
-    Effect.gen(function* () {
-      const adapter = yield* CursorAdapter;
-      const serverSettings = yield* ServerSettingsService;
-      const threadId = ThreadId.make("cursor-stop-pending-approval");
-      const approvalRequested = yield* Deferred.make<void>();
-
-      const wrapperPath = yield* Effect.promise(() =>
-        makeMockAgentWrapper({ T3_ACP_EMIT_TOOL_CALLS: "1" }),
-      );
-      yield* serverSettings.updateSettings({ providers: { cursor: { binaryPath: wrapperPath } } });
-
-      yield* Stream.runForEach(adapter.streamEvents, (event) => {
-        if (String(event.threadId) !== String(threadId) || event.type !== "request.opened") {
-          return Effect.void;
-        }
-        return Deferred.succeed(approvalRequested, undefined).pipe(Effect.ignore);
-      }).pipe(Effect.forkChild);
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("cursor"),
-        cwd: process.cwd(),
-        runtimeMode: "approval-required",
-        modelSelection: { instanceId: ProviderInstanceId.make("cursor"), model: "default" },
-      });
-
-      const sendTurnFiber = yield* adapter
-        .sendTurn({
-          threadId,
-          input: "run a tool call and then stop",
-          attachments: [],
-        })
-        .pipe(Effect.forkChild);
-
-      yield* Deferred.await(approvalRequested);
-      yield* adapter.stopSession(threadId);
-      yield* Fiber.await(sendTurnFiber);
-
-      assert.equal(yield* adapter.hasSession(threadId), false);
-    }),
-  );
-
-  it.effect("stopping a session settles pending user-input waits", () =>
-    Effect.gen(function* () {
-      const adapter = yield* CursorAdapter;
-      const serverSettings = yield* ServerSettingsService;
-      const threadId = ThreadId.make("cursor-stop-pending-user-input");
-      const userInputRequested = yield* Deferred.make<void>();
-
-      const wrapperPath = yield* Effect.promise(() =>
-        makeMockAgentWrapper({ T3_ACP_EMIT_ASK_QUESTION: "1" }),
-      );
-      yield* serverSettings.updateSettings({ providers: { cursor: { binaryPath: wrapperPath } } });
-
-      yield* Stream.runForEach(adapter.streamEvents, (event) => {
-        if (String(event.threadId) !== String(threadId) || event.type !== "user-input.requested") {
-          return Effect.void;
-        }
-        return Deferred.succeed(userInputRequested, undefined).pipe(Effect.ignore);
-      }).pipe(Effect.forkChild);
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("cursor"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-        modelSelection: { instanceId: ProviderInstanceId.make("cursor"), model: "default" },
-      });
-
-      const sendTurnFiber = yield* adapter
-        .sendTurn({
-          threadId,
-          input: "ask me a question and then stop",
-          attachments: [],
-        })
-        .pipe(Effect.forkChild);
-
-      yield* Deferred.await(userInputRequested);
-      yield* adapter.stopSession(threadId);
-      yield* Fiber.await(sendTurnFiber);
-
-      assert.equal(yield* adapter.hasSession(threadId), false);
-    }),
-  );
-
-  it.effect("interrupting a session settles pending user-input waits", () =>
-    Effect.gen(function* () {
-      const adapter = yield* CursorAdapter;
-      const serverSettings = yield* ServerSettingsService;
-      const threadId = ThreadId.make("cursor-interrupt-pending-user-input");
-      const userInputRequested = yield* Deferred.make<void>();
-
-      const wrapperPath = yield* Effect.promise(() =>
-        makeMockAgentWrapper({ T3_ACP_EMIT_ASK_QUESTION: "1" }),
-      );
-      yield* serverSettings.updateSettings({ providers: { cursor: { binaryPath: wrapperPath } } });
-
-      yield* Stream.runForEach(adapter.streamEvents, (event) => {
-        if (String(event.threadId) !== String(threadId) || event.type !== "user-input.requested") {
-          return Effect.void;
-        }
-        return Deferred.succeed(userInputRequested, undefined).pipe(Effect.ignore);
-      }).pipe(Effect.forkChild);
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("cursor"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-        modelSelection: { instanceId: ProviderInstanceId.make("cursor"), model: "default" },
-      });
-
-      const sendTurnFiber = yield* adapter
-        .sendTurn({
-          threadId,
-          input: "ask me a question and then interrupt",
-          attachments: [],
-        })
-        .pipe(Effect.forkChild);
-
-      yield* Deferred.await(userInputRequested);
-      yield* adapter.interruptTurn(threadId);
-      yield* Fiber.await(sendTurnFiber);
-
-      assert.equal(yield* adapter.hasSession(threadId), true);
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("broadcasts runtime events to multiple stream consumers", () =>
-    Effect.gen(function* () {
-      const adapter = yield* CursorAdapter;
-      const settings = yield* ServerSettingsService;
-      const threadId = ThreadId.make("cursor-runtime-event-broadcast");
-
-      const wrapperPath = yield* Effect.promise(() => makeMockAgentWrapper());
-      yield* settings.updateSettings({ providers: { cursor: { binaryPath: wrapperPath } } });
-
-      const firstConsumer = yield* Stream.take(adapter.streamEvents, 3).pipe(
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-      const secondConsumer = yield* Stream.take(adapter.streamEvents, 3).pipe(
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("cursor"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-        modelSelection: { instanceId: ProviderInstanceId.make("cursor"), model: "default" },
-      });
-
-      const firstEvents = Array.from(yield* Fiber.join(firstConsumer));
-      const secondEvents = Array.from(yield* Fiber.join(secondConsumer));
-
-      assert.deepStrictEqual(
-        firstEvents.map((event) => event.type),
-        ["session.started", "session.state.changed", "thread.started"],
-      );
-      assert.deepStrictEqual(
-        secondEvents.map((event) => event.type),
-        ["session.started", "session.state.changed", "thread.started"],
-      );
-
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("switches model in-session via session/set_config_option", () =>
-    Effect.gen(function* () {
-      const adapter = yield* CursorAdapter;
-      const serverSettings = yield* ServerSettingsService;
-      const threadId = ThreadId.make("cursor-model-switch");
-      const tempDir = yield* Effect.promise(() =>
-        NodeFSP.mkdtemp(NodePath.join(NodeOS.tmpdir(), "cursor-acp-")),
-      );
-      const requestLogPath = NodePath.join(tempDir, "requests.ndjson");
-      const argvLogPath = NodePath.join(tempDir, "argv.txt");
-      yield* Effect.promise(() => NodeFSP.writeFile(requestLogPath, "", "utf8"));
-      const wrapperPath = yield* Effect.promise(() =>
-        makeProbeWrapper(requestLogPath, argvLogPath),
-      );
-      yield* serverSettings.updateSettings({ providers: { cursor: { binaryPath: wrapperPath } } });
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("cursor"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-        modelSelection: { instanceId: ProviderInstanceId.make("cursor"), model: "composer-2" },
-      });
-
-      yield* adapter.sendTurn({
-        threadId,
-        input: "first turn",
-        attachments: [],
-      });
-
-      yield* adapter.sendTurn({
-        threadId,
-        input: "second turn after switching model",
-        attachments: [],
-        modelSelection: createModelSelection(ProviderInstanceId.make("cursor"), "composer-2", [
-          { id: "fastMode", value: true },
-        ]),
-      });
-
-      const argvRuns = yield* Effect.promise(() => readArgvLog(argvLogPath));
-      assert.lengthOf(argvRuns, 1, "session should not restart — only one spawn");
-      assert.deepStrictEqual(argvRuns[0], ["acp"]);
-
-      const requests = yield* Effect.promise(() => readJsonLines(requestLogPath));
-      const setConfigRequests = requests.filter(
-        (entry) =>
-          entry.method === "session/set_config_option" &&
-          (entry.params as Record<string, unknown> | undefined)?.configId === "model",
-      );
-      assert.isAbove(setConfigRequests.length, 0, "should call session/set_config_option");
-      assert.equal((setConfigRequests[0]?.params as Record<string, unknown>)?.value, "composer-2");
-
-      const fastConfigRequests = requests.filter(
-        (entry) =>
-          entry.method === "session/set_config_option" &&
-          (entry.params as Record<string, unknown> | undefined)?.configId === "fast",
-      );
-      assert.isAbove(fastConfigRequests.length, 0, "should apply fast mode as a separate config");
-      const lastFastConfig = fastConfigRequests[fastConfigRequests.length - 1];
-      assert.equal((lastFastConfig?.params as Record<string, unknown>)?.value, "true");
-
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("clears prior fast mode in-session when the next turn sets fastMode: false", () =>
-    Effect.gen(function* () {
-      const adapter = yield* CursorAdapter;
-      const serverSettings = yield* ServerSettingsService;
-      const threadId = ThreadId.make("cursor-fast-mode-reset");
-      const tempDir = yield* Effect.promise(() =>
-        NodeFSP.mkdtemp(NodePath.join(NodeOS.tmpdir(), "cursor-acp-")),
-      );
-      const requestLogPath = NodePath.join(tempDir, "requests.ndjson");
-      const argvLogPath = NodePath.join(tempDir, "argv.txt");
-      yield* Effect.promise(() => NodeFSP.writeFile(requestLogPath, "", "utf8"));
-      const wrapperPath = yield* Effect.promise(() =>
-        makeProbeWrapper(requestLogPath, argvLogPath),
-      );
-      yield* serverSettings.updateSettings({ providers: { cursor: { binaryPath: wrapperPath } } });
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("cursor"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-        modelSelection: { instanceId: ProviderInstanceId.make("cursor"), model: "composer-2" },
-      });
-
-      yield* adapter.sendTurn({
-        threadId,
-        input: "first turn with fast mode",
-        attachments: [],
-        modelSelection: createModelSelection(ProviderInstanceId.make("cursor"), "composer-2", [
-          { id: "fastMode", value: true },
-        ]),
-      });
-
-      yield* adapter.sendTurn({
-        threadId,
-        input: "second turn without fast mode",
-        attachments: [],
-        modelSelection: createModelSelection(ProviderInstanceId.make("cursor"), "composer-2", [
-          { id: "fastMode", value: false },
-        ]),
-      });
-
-      const requests = yield* Effect.promise(() => readJsonLines(requestLogPath));
-      const fastConfigRequests = requests.filter(
-        (entry) =>
-          entry.method === "session/set_config_option" &&
-          (entry.params as Record<string, unknown> | undefined)?.configId === "fast",
-      );
-      assert.isAtLeast(fastConfigRequests.length, 2, "should set fast mode on and then off");
-
-      const lastFastConfig = fastConfigRequests[fastConfigRequests.length - 1];
-      assert.equal((lastFastConfig?.params as Record<string, unknown>)?.value, "false");
-
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect(
-    "applies fast mode on the first turn when modelSelection uses a non-default instance id",
-    () => {
-      const customInstanceId = ProviderInstanceId.make("cursor_secondary");
-      // Custom-instance cases can't share the suite-level `CursorAdapter`
-      // layer because that one binds `instanceId: "cursor"`. We build a
-      // fresh layer graph — including a fresh `ServerSettingsService` — so
-      // mid-test `updateSettings` calls target the same service instance the
-      // adapter's `resolveSettings` reads from, and so the outer
-      // `yield* ServerSettingsService` sees the same snapshot as well.
-      const customAdapterLayer = Layer.effect(
-        CursorAdapter,
-        Effect.gen(function* () {
-          const cursorConfig = decodeCursorSettings({});
-          const resolveSettings = yield* makeResolveCursorSettings;
-          return yield* makeCursorAdapter(cursorConfig, {
-            instanceId: customInstanceId,
-            resolveSettings,
-          });
-        }),
-      ).pipe(
-        Layer.provideMerge(ServerSettingsService.layerTest()),
-        Layer.provideMerge(
-          ServerConfig.layerTest(process.cwd(), {
-            prefix: "t3code-cursor-adapter-custom-instance-",
-          }),
-        ),
-        Layer.provideMerge(NodeServices.layer),
-      );
-
-      return Effect.gen(function* () {
-        const adapter = yield* CursorAdapter;
-        const serverSettings = yield* ServerSettingsService;
-        const threadId = ThreadId.make("cursor-fast-mode-custom-instance");
-        const tempDir = yield* Effect.promise(() =>
-          NodeFSP.mkdtemp(NodePath.join(NodeOS.tmpdir(), "cursor-acp-")),
-        );
-        const requestLogPath = NodePath.join(tempDir, "requests.ndjson");
-        const argvLogPath = NodePath.join(tempDir, "argv.txt");
-        yield* Effect.promise(() => NodeFSP.writeFile(requestLogPath, "", "utf8"));
-        const wrapperPath = yield* Effect.promise(() =>
-          makeProbeWrapper(requestLogPath, argvLogPath),
-        );
-        yield* serverSettings.updateSettings({
-          providers: { cursor: { binaryPath: wrapperPath } },
-        });
-
-        yield* adapter.startSession({
-          threadId,
-          provider: ProviderDriverKind.make("cursor"),
-          cwd: process.cwd(),
-          runtimeMode: "full-access",
-          modelSelection: {
-            instanceId: customInstanceId,
-            model: "composer-2",
-          },
-        });
-
-        yield* adapter.sendTurn({
-          threadId,
-          input: "first turn with fast mode",
-          attachments: [],
-          modelSelection: {
-            ...createModelSelection(ProviderInstanceId.make("cursor"), "composer-2", [
-              { id: "fastMode", value: true },
-            ]),
-            instanceId: customInstanceId,
-          },
-        });
-
-        const requests = yield* Effect.promise(() => readJsonLines(requestLogPath));
-        const fastConfigRequests = requests.filter(
-          (entry) =>
-            entry.method === "session/set_config_option" &&
-            (entry.params as Record<string, unknown> | undefined)?.configId === "fast",
-        );
-        assert.isAbove(
-          fastConfigRequests.length,
-          0,
-          "fast mode should apply when instance id matches the adapter binding",
-        );
-        const lastFastConfig = fastConfigRequests[fastConfigRequests.length - 1];
-        assert.equal((lastFastConfig?.params as Record<string, unknown>)?.value, "true");
-
-        yield* adapter.stopSession(threadId);
-      }).pipe(Effect.provide(customAdapterLayer));
-    },
-  );
-
-  // Production calls startSession from a request fiber that finishes as soon as
-  // the session exists. `Effect.forkChild` made the notification consumer a
-  // child of that fiber, and Effect interrupts a fiber's children when it
-  // completes, so the consumer died on return and every later session/update
-  // was dropped: the thread sat on "Working" forever while the provider
-  // streamed its whole turn. The other tests here call startSession directly
-  // from the test fiber, which never completes, so the consumer survived and
-  // the bug stayed invisible. Running it in a fiber that finishes is what
-  // reproduces production.
-  it.effect("keeps consuming notifications after the startSession fiber completes", () =>
-    Effect.gen(function* () {
-      const adapter = yield* CursorAdapter;
-      const settings = yield* ServerSettingsService;
-      const threadId = ThreadId.make("cursor-consumer-outlives-start-session");
-
-      const wrapperPath = yield* Effect.promise(() => makeMockAgentWrapper());
-      yield* settings.updateSettings({ providers: { cursor: { binaryPath: wrapperPath } } });
-
-      const runtimeEvents: ProviderRuntimeEvent[] = [];
-      const sawContentDelta = yield* Deferred.make<void>();
-      const runtimeEventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) =>
-        Effect.sync(() => {
-          runtimeEvents.push(event);
-        }).pipe(
-          Effect.andThen(
-            event.type === "content.delta" && String(event.threadId) === String(threadId)
-              ? Deferred.succeed(sawContentDelta, undefined).pipe(Effect.asVoid)
-              : Effect.void,
-          ),
-        ),
-      ).pipe(Effect.forkChild);
-
-      const startSessionFiber = yield* adapter
-        .startSession({
-          threadId,
-          provider: ProviderDriverKind.make("cursor"),
-          cwd: process.cwd(),
-          runtimeMode: "full-access",
-          modelSelection: { instanceId: ProviderInstanceId.make("cursor"), model: "default" },
-        })
-        .pipe(Effect.forkChild);
-      yield* Fiber.join(startSessionFiber).pipe(Effect.timeout("10 seconds"));
-
-      // Forked, and the assertion waits on the projected event rather than on
-      // sendTurn: with the consumer dead the turn never settles, so awaiting it
-      // directly would hang until the suite timeout instead of failing here.
-      const sendTurnFiber = yield* adapter
-        .sendTurn({ threadId, input: "hello mock", attachments: [] })
-        .pipe(Effect.forkChild);
-      yield* Deferred.await(sawContentDelta).pipe(Effect.timeout("10 seconds"));
-      yield* Fiber.join(sendTurnFiber).pipe(Effect.timeout("10 seconds"));
-
-      const delta = runtimeEvents.find(
-        (event) => event.type === "content.delta" && String(event.threadId) === String(threadId),
-      );
-      assert.isDefined(
-        delta,
-        "no content.delta was projected after the startSession fiber completed",
-      );
-
-      yield* Fiber.interrupt(runtimeEventsFiber);
-      yield* adapter.stopSession(threadId);
-      // Live clock so the timeouts above are real: under the default test clock
-      // they wait on virtual time that never advances, and a regression would
-      // hang until the suite timeout instead of failing here.
-    }).pipe(TestClock.withLive),
-  );
-});
diff --git a/apps/server/src/provider/Layers/CursorAdapter.ts b/apps/server/src/provider/Layers/CursorAdapter.ts
deleted file mode 100644
index 818fe567b9b3..000000000000
--- a/apps/server/src/provider/Layers/CursorAdapter.ts
+++ /dev/null
@@ -1,1193 +0,0 @@
-/**
- * CursorAdapterLive — Cursor CLI (`agent acp`) via ACP.
- *
- * @module CursorAdapterLive
- */
-
-import {
-  ApprovalRequestId,
-  type CursorSettings,
-  type ProviderOptionSelection,
-  EventId,
-  type ProviderApprovalDecision,
-  type ProviderInteractionMode,
-  type ProviderRuntimeEvent,
-  type ProviderSession,
-  type ProviderUserInputAnswers,
-  ProviderDriverKind,
-  ProviderInstanceId,
-  RuntimeRequestId,
-  type RuntimeMode,
-  type ThreadId,
-  TurnId,
-} from "@t3tools/contracts";
-import * as DateTime from "effect/DateTime";
-import * as Crypto from "effect/Crypto";
-import * as Deferred from "effect/Deferred";
-import * as Effect from "effect/Effect";
-import * as Exit from "effect/Exit";
-import * as Fiber from "effect/Fiber";
-import * as FileSystem from "effect/FileSystem";
-import * as Option from "effect/Option";
-import * as Path from "effect/Path";
-import * as PubSub from "effect/PubSub";
-import * as Schema from "effect/Schema";
-import * as Scope from "effect/Scope";
-import * as Semaphore from "effect/Semaphore";
-import * as Stream from "effect/Stream";
-import * as SynchronizedRef from "effect/SynchronizedRef";
-import * as ChildProcessSpawner from "effect/unstable/process/ChildProcessSpawner";
-import * as EffectAcpErrors from "effect-acp/errors";
-import type * as EffectAcpSchema from "effect-acp/schema";
-
-import { resolveAttachmentPath } from "../../attachmentStore.ts";
-import { ServerConfig } from "../../config.ts";
-import * as McpProviderSession from "../../mcp/McpProviderSession.ts";
-import {
-  ProviderAdapterProcessError,
-  ProviderAdapterRequestError,
-  ProviderAdapterSessionNotFoundError,
-  ProviderAdapterValidationError,
-} from "../Errors.ts";
-import { acpPermissionOutcome, mapAcpToAdapterError } from "../acp/AcpAdapterSupport.ts";
-import type * as AcpSessionRuntime from "../acp/AcpSessionRuntime.ts";
-import {
-  makeAcpAssistantItemEvent,
-  makeAcpContentDeltaEvent,
-  makeAcpPlanUpdatedEvent,
-  makeAcpRequestOpenedEvent,
-  makeAcpRequestResolvedEvent,
-  makeAcpToolCallEvent,
-} from "../acp/AcpCoreRuntimeEvents.ts";
-import {
-  type AcpSessionMode,
-  type AcpSessionModeState,
-  parsePermissionRequest,
-} from "../acp/AcpRuntimeModel.ts";
-import { makeAcpNativeLoggerFactory } from "../acp/AcpNativeLogging.ts";
-import { applyCursorAcpModelSelection, makeCursorAcpRuntime } from "../acp/CursorAcpSupport.ts";
-import {
-  CursorAskQuestionRequest,
-  CursorCreatePlanRequest,
-  CursorUpdateTodosRequest,
-  extractAskQuestions,
-  extractPlanMarkdown,
-  extractTodosAsPlan,
-} from "../acp/CursorAcpExtension.ts";
-import { type CursorAdapterShape } from "../Services/CursorAdapter.ts";
-import { resolveCursorAcpBaseModelId } from "./CursorProvider.ts";
-import { type EventNdjsonLogger, makeEventNdjsonLogger } from "./EventNdjsonLogger.ts";
-const encodeUnknownJsonStringExit = Schema.encodeUnknownExit(Schema.fromJsonString(Schema.Unknown));
-
-const PROVIDER = ProviderDriverKind.make("cursor");
-const CURSOR_RESUME_VERSION = 1 as const;
-const ACP_PLAN_MODE_ALIASES = ["plan", "architect"];
-const ACP_IMPLEMENT_MODE_ALIASES = ["code", "agent", "default", "chat", "implement"];
-const ACP_APPROVAL_MODE_ALIASES = ["ask"];
-
-function encodeJsonStringForDiagnostics(input: unknown): string | undefined {
-  const result = encodeUnknownJsonStringExit(input);
-  return Exit.isSuccess(result) ? result.value : undefined;
-}
-
-export interface CursorAdapterLiveOptions {
-  readonly environment?: NodeJS.ProcessEnv;
-  readonly nativeEventLogPath?: string;
-  readonly nativeEventLogger?: EventNdjsonLogger;
-  /**
-   * Selections are honored when `modelSelection.instanceId` matches this value.
-   * Defaults to the legacy built-in instance id (`cursor`).
-   */
-  readonly instanceId?: ProviderInstanceId;
-  /**
-   * Optional per-session settings resolver. When provided the adapter yields
-   * this effect at the start of every session and uses the result instead of
-   * the `cursorSettings` captured at construction.
-   *
-   * Production instances bind settings to the instance scope (the hydration
-   * layer rebuilds the adapter on config change) and leave this undefined.
-   * Test suites that mutate `ServerSettingsService` mid-flight — e.g. to
-   * swap `binaryPath` to a mock ACP wrapper — pass a resolver that reads
-   * the latest snapshot so the closure isn't stale.
-   */
-  readonly resolveSettings?: Effect.Effect<CursorSettings>;
-}
-
-interface PendingApproval {
-  readonly decision: Deferred.Deferred<ProviderApprovalDecision>;
-  readonly kind: string | "unknown";
-}
-
-interface PendingUserInput {
-  readonly answers: Deferred.Deferred<ProviderUserInputAnswers>;
-}
-
-interface CursorSessionContext {
-  readonly threadId: ThreadId;
-  session: ProviderSession;
-  readonly scope: Scope.Closeable;
-  readonly acp: AcpSessionRuntime.AcpSessionRuntime["Service"];
-  notificationFiber: Fiber.Fiber<void, never> | undefined;
-  readonly pendingApprovals: Map<ApprovalRequestId, PendingApproval>;
-  readonly pendingUserInputs: Map<ApprovalRequestId, PendingUserInput>;
-  readonly turns: Array<{ id: TurnId; items: Array<unknown> }>;
-  lastPlanFingerprint: string | undefined;
-  activeTurnId: TurnId | undefined;
-  /** Number of sendTurn prompts currently in flight or being prepared.
-   * >0 means a turn is actively running, so a new sendTurn is a steer that
-   * continues it, and only the last remaining prompt settles the turn. */
-  promptsInFlight: number;
-  stopped: boolean;
-}
-
-function settlePendingApprovalsAsCancelled(
-  pendingApprovals: ReadonlyMap<ApprovalRequestId, PendingApproval>,
-): Effect.Effect<void> {
-  const pendingEntries = Array.from(pendingApprovals.values());
-  return Effect.forEach(
-    pendingEntries,
-    (pending) => Deferred.succeed(pending.decision, "cancel").pipe(Effect.ignore),
-    {
-      discard: true,
-    },
-  );
-}
-
-function settlePendingUserInputsAsEmptyAnswers(
-  pendingUserInputs: ReadonlyMap<ApprovalRequestId, PendingUserInput>,
-): Effect.Effect<void> {
-  const pendingEntries = Array.from(pendingUserInputs.values());
-  return Effect.forEach(
-    pendingEntries,
-    (pending) => Deferred.succeed(pending.answers, {}).pipe(Effect.ignore),
-    {
-      discard: true,
-    },
-  );
-}
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-
-function parseCursorResume(raw: unknown): { sessionId: string } | undefined {
-  if (!isRecord(raw)) return undefined;
-  if (raw.schemaVersion !== CURSOR_RESUME_VERSION) return undefined;
-  if (typeof raw.sessionId !== "string" || !raw.sessionId.trim()) return undefined;
-  return { sessionId: raw.sessionId.trim() };
-}
-
-function normalizeModeSearchText(mode: AcpSessionMode): string {
-  return [mode.id, mode.name, mode.description]
-    .filter((value): value is string => typeof value === "string" && value.length > 0)
-    .join(" ")
-    .toLowerCase()
-    .replace(/[^a-z0-9]+/g, " ")
-    .trim();
-}
-
-function findModeByAliases(
-  modes: ReadonlyArray<AcpSessionMode>,
-  aliases: ReadonlyArray<string>,
-): AcpSessionMode | undefined {
-  const normalizedAliases = aliases.map((alias) => alias.toLowerCase());
-  for (const alias of normalizedAliases) {
-    const exact = modes.find((mode) => {
-      const id = mode.id.toLowerCase();
-      const name = mode.name.toLowerCase();
-      return id === alias || name === alias;
-    });
-    if (exact) {
-      return exact;
-    }
-  }
-  for (const alias of normalizedAliases) {
-    const partial = modes.find((mode) => normalizeModeSearchText(mode).includes(alias));
-    if (partial) {
-      return partial;
-    }
-  }
-  return undefined;
-}
-
-function isPlanMode(mode: AcpSessionMode): boolean {
-  return findModeByAliases([mode], ACP_PLAN_MODE_ALIASES) !== undefined;
-}
-
-function resolveRequestedModeId(input: {
-  readonly interactionMode: ProviderInteractionMode | undefined;
-  readonly runtimeMode: RuntimeMode;
-  readonly modeState: AcpSessionModeState | undefined;
-}): string | undefined {
-  const modeState = input.modeState;
-  if (!modeState) {
-    return undefined;
-  }
-
-  if (input.interactionMode === "plan") {
-    return findModeByAliases(modeState.availableModes, ACP_PLAN_MODE_ALIASES)?.id;
-  }
-
-  if (input.runtimeMode === "approval-required") {
-    return (
-      findModeByAliases(modeState.availableModes, ACP_APPROVAL_MODE_ALIASES)?.id ??
-      findModeByAliases(modeState.availableModes, ACP_IMPLEMENT_MODE_ALIASES)?.id ??
-      modeState.availableModes.find((mode) => !isPlanMode(mode))?.id ??
-      modeState.currentModeId
-    );
-  }
-
-  return (
-    findModeByAliases(modeState.availableModes, ACP_IMPLEMENT_MODE_ALIASES)?.id ??
-    findModeByAliases(modeState.availableModes, ACP_APPROVAL_MODE_ALIASES)?.id ??
-    modeState.availableModes.find((mode) => !isPlanMode(mode))?.id ??
-    modeState.currentModeId
-  );
-}
-
-function applyRequestedSessionConfiguration<E>(input: {
-  readonly runtime: AcpSessionRuntime.AcpSessionRuntime["Service"];
-  readonly runtimeMode: RuntimeMode;
-  readonly interactionMode: ProviderInteractionMode | undefined;
-  readonly modelSelection:
-    | {
-        readonly model: string;
-        readonly options?: ReadonlyArray<ProviderOptionSelection> | null | undefined;
-      }
-    | undefined;
-  readonly mapError: (context: {
-    readonly cause: import("effect-acp/errors").AcpError;
-    readonly method: "session/set_config_option" | "session/set_mode";
-  }) => E;
-}): Effect.Effect<void, E> {
-  return Effect.gen(function* () {
-    if (input.modelSelection) {
-      yield* applyCursorAcpModelSelection({
-        runtime: input.runtime,
-        model: input.modelSelection.model,
-        selections: input.modelSelection.options,
-        mapError: ({ cause }) =>
-          input.mapError({
-            cause,
-            method: "session/set_config_option",
-          }),
-      });
-    }
-
-    const requestedModeId = resolveRequestedModeId({
-      interactionMode: input.interactionMode,
-      runtimeMode: input.runtimeMode,
-      modeState: yield* input.runtime.getModeState,
-    });
-    if (!requestedModeId) {
-      return;
-    }
-
-    yield* input.runtime.setMode(requestedModeId).pipe(
-      Effect.mapError((cause) =>
-        input.mapError({
-          cause,
-          method: "session/set_mode",
-        }),
-      ),
-    );
-  });
-}
-
-function selectAutoApprovedPermissionOption(
-  request: EffectAcpSchema.RequestPermissionRequest,
-): string | undefined {
-  const allowAlwaysOption = request.options.find((option) => option.kind === "allow_always");
-  if (typeof allowAlwaysOption?.optionId === "string" && allowAlwaysOption.optionId.trim()) {
-    return allowAlwaysOption.optionId.trim();
-  }
-
-  const allowOnceOption = request.options.find((option) => option.kind === "allow_once");
-  if (typeof allowOnceOption?.optionId === "string" && allowOnceOption.optionId.trim()) {
-    return allowOnceOption.optionId.trim();
-  }
-
-  return undefined;
-}
-
-export function makeCursorAdapter(
-  cursorSettings: CursorSettings,
-  options?: CursorAdapterLiveOptions,
-) {
-  return Effect.gen(function* () {
-    const boundInstanceId = options?.instanceId ?? ProviderInstanceId.make("cursor");
-    const fileSystem = yield* FileSystem.FileSystem;
-    const path = yield* Path.Path;
-    const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
-    const serverConfig = yield* Effect.service(ServerConfig);
-    const crypto = yield* Crypto.Crypto;
-    const nativeEventLogger =
-      options?.nativeEventLogger ??
-      (options?.nativeEventLogPath !== undefined
-        ? yield* makeEventNdjsonLogger(options.nativeEventLogPath, {
-            stream: "native",
-          })
-        : undefined);
-    const managedNativeEventLogger =
-      options?.nativeEventLogger === undefined ? nativeEventLogger : undefined;
-    const makeAcpNativeLoggers = yield* makeAcpNativeLoggerFactory();
-
-    const sessions = new Map<ThreadId, CursorSessionContext>();
-    const threadLocksRef = yield* SynchronizedRef.make(new Map<string, Semaphore.Semaphore>());
-    const runtimeEventPubSub = yield* PubSub.unbounded<ProviderRuntimeEvent>();
-
-    const nowIso = Effect.map(DateTime.now, DateTime.formatIso);
-    const randomUUIDv4 = crypto.randomUUIDv4.pipe(
-      Effect.mapError(
-        (cause) =>
-          new ProviderAdapterRequestError({
-            provider: PROVIDER,
-            method: "crypto/randomUUIDv4",
-            detail: "Failed to generate Cursor runtime identifier.",
-            cause,
-          }),
-      ),
-    );
-    const nextEventId = Effect.map(randomUUIDv4, (id) => EventId.make(id));
-    const makeEventStamp = () => Effect.all({ eventId: nextEventId, createdAt: nowIso });
-    const mapExtensionFailure = <A, E, R>(effect: Effect.Effect<A, E, R>) =>
-      effect.pipe(
-        Effect.mapError(
-          (cause) =>
-            new EffectAcpErrors.AcpTransportError({
-              detail: "Failed to process Cursor ACP extension event.",
-              cause,
-            }),
-        ),
-      );
-
-    const offerRuntimeEvent = (event: ProviderRuntimeEvent) =>
-      PubSub.publish(runtimeEventPubSub, event).pipe(Effect.asVoid);
-
-    const getThreadSemaphore = (threadId: string) =>
-      SynchronizedRef.modifyEffect(threadLocksRef, (current) => {
-        const existing: Option.Option<Semaphore.Semaphore> = Option.fromNullishOr(
-          current.get(threadId),
-        );
-        return Option.match(existing, {
-          onNone: () =>
-            Semaphore.make(1).pipe(
-              Effect.map((semaphore) => {
-                const next = new Map(current);
-                next.set(threadId, semaphore);
-                return [semaphore, next] as const;
-              }),
-            ),
-          onSome: (semaphore) => Effect.succeed([semaphore, current] as const),
-        });
-      });
-
-    const withThreadLock = <A, E, R>(threadId: string, effect: Effect.Effect<A, E, R>) =>
-      Effect.flatMap(getThreadSemaphore(threadId), (semaphore) => semaphore.withPermit(effect));
-
-    const logNative = (
-      threadId: ThreadId,
-      method: string,
-      payload: unknown,
-      _source: "acp.jsonrpc" | "acp.cursor.extension",
-    ) =>
-      Effect.gen(function* () {
-        if (!nativeEventLogger) return;
-        const observedAt = yield* nowIso;
-        yield* nativeEventLogger.write(
-          {
-            observedAt,
-            event: {
-              id: yield* randomUUIDv4,
-              kind: "notification",
-              provider: PROVIDER,
-              createdAt: observedAt,
-              method,
-              threadId,
-              payload,
-            },
-          },
-          threadId,
-        );
-      });
-
-    const emitPlanUpdate = (
-      ctx: CursorSessionContext,
-      payload: {
-        readonly explanation?: string | null;
-        readonly plan: ReadonlyArray<{
-          readonly step: string;
-          readonly status: "pending" | "inProgress" | "completed";
-        }>;
-      },
-      rawPayload: unknown,
-      source: "acp.jsonrpc" | "acp.cursor.extension",
-      method: string,
-    ) =>
-      Effect.gen(function* () {
-        const fingerprint = `${ctx.activeTurnId ?? "no-turn"}:${encodeJsonStringForDiagnostics(payload) ?? "[unserializable payload]"}`;
-        if (ctx.lastPlanFingerprint === fingerprint) {
-          return;
-        }
-        ctx.lastPlanFingerprint = fingerprint;
-        yield* offerRuntimeEvent(
-          makeAcpPlanUpdatedEvent({
-            stamp: yield* makeEventStamp(),
-            provider: PROVIDER,
-            threadId: ctx.threadId,
-            turnId: ctx.activeTurnId,
-            payload,
-            source,
-            method,
-            rawPayload,
-          }),
-        );
-      });
-
-    const requireSession = (
-      threadId: ThreadId,
-    ): Effect.Effect<CursorSessionContext, ProviderAdapterSessionNotFoundError> => {
-      const ctx = sessions.get(threadId);
-      if (!ctx || ctx.stopped) {
-        return Effect.fail(
-          new ProviderAdapterSessionNotFoundError({ provider: PROVIDER, threadId }),
-        );
-      }
-      return Effect.succeed(ctx);
-    };
-
-    const stopSessionInternal = (ctx: CursorSessionContext) =>
-      Effect.gen(function* () {
-        if (ctx.stopped) return;
-        ctx.stopped = true;
-        yield* settlePendingApprovalsAsCancelled(ctx.pendingApprovals);
-        yield* settlePendingUserInputsAsEmptyAnswers(ctx.pendingUserInputs);
-        if (ctx.notificationFiber) {
-          yield* Fiber.interrupt(ctx.notificationFiber);
-        }
-        yield* Effect.ignore(Scope.close(ctx.scope, Exit.void));
-        sessions.delete(ctx.threadId);
-        yield* offerRuntimeEvent({
-          type: "session.exited",
-          ...(yield* makeEventStamp()),
-          provider: PROVIDER,
-          threadId: ctx.threadId,
-          payload: { exitKind: "graceful" },
-        });
-      });
-
-    const startSession: CursorAdapterShape["startSession"] = (input) =>
-      withThreadLock(
-        input.threadId,
-        Effect.gen(function* () {
-          if (input.provider !== undefined && input.provider !== PROVIDER) {
-            return yield* new ProviderAdapterValidationError({
-              provider: PROVIDER,
-              operation: "startSession",
-              issue: `Expected provider '${PROVIDER}' but received '${input.provider}'.`,
-            });
-          }
-          if (!input.cwd?.trim()) {
-            return yield* new ProviderAdapterValidationError({
-              provider: PROVIDER,
-              operation: "startSession",
-              issue: "cwd is required and must be non-empty.",
-            });
-          }
-
-          const cwd = path.resolve(input.cwd.trim());
-          const cursorModelSelection =
-            input.modelSelection?.instanceId === boundInstanceId ? input.modelSelection : undefined;
-          const existing = sessions.get(input.threadId);
-          if (existing && !existing.stopped) {
-            yield* stopSessionInternal(existing);
-          }
-
-          const pendingApprovals = new Map<ApprovalRequestId, PendingApproval>();
-          const pendingUserInputs = new Map<ApprovalRequestId, PendingUserInput>();
-          const sessionScope = yield* Scope.make("sequential");
-          let sessionScopeTransferred = false;
-          yield* Effect.addFinalizer(() =>
-            sessionScopeTransferred ? Effect.void : Scope.close(sessionScope, Exit.void),
-          );
-          let ctx!: CursorSessionContext;
-
-          const resumeSessionId = parseCursorResume(input.resumeCursor)?.sessionId;
-          const acpNativeLoggers = makeAcpNativeLoggers({
-            nativeEventLogger,
-            provider: PROVIDER,
-            threadId: input.threadId,
-          });
-
-          // Resolve the CursorSettings used to spawn the ACP child. Production
-          // leaves `options.resolveSettings` undefined so we use the value
-          // captured at adapter construction — per-instance isolation is
-          // enforced by the hydration layer rebuilding this adapter whenever
-          // its config changes. Tests set `resolveSettings` to pull the latest
-          // snapshot from `ServerSettingsService` so that mid-suite
-          // `updateSettings({ providers: { cursor: { binaryPath } } })` calls
-          // actually take effect when the next session spawns.
-          const effectiveCursorSettings = options?.resolveSettings
-            ? yield* options.resolveSettings
-            : cursorSettings;
-
-          const mcpSession = McpProviderSession.readMcpProviderSession(input.threadId);
-          const acp = yield* makeCursorAcpRuntime({
-            cursorSettings: effectiveCursorSettings,
-            ...(options?.environment ? { environment: options.environment } : {}),
-            childProcessSpawner,
-            cwd,
-            ...(resumeSessionId ? { resumeSessionId } : {}),
-            clientInfo: { name: "t3-code", version: "0.0.0" },
-            ...(mcpSession
-              ? {
-                  mcpServers: [
-                    {
-                      type: "http" as const,
-                      name: "t3-code",
-                      url: mcpSession.endpoint,
-                      headers: [
-                        {
-                          name: "Authorization",
-                          value: mcpSession.authorizationHeader,
-                        },
-                      ],
-                    },
-                  ],
-                }
-              : {}),
-            ...acpNativeLoggers,
-          }).pipe(
-            Effect.provideService(Crypto.Crypto, crypto),
-            Effect.provideService(Scope.Scope, sessionScope),
-            Effect.mapError(
-              (cause) =>
-                new ProviderAdapterProcessError({
-                  provider: PROVIDER,
-                  threadId: input.threadId,
-                  detail: cause.message,
-                  cause,
-                }),
-            ),
-          );
-          const started = yield* Effect.gen(function* () {
-            yield* acp.handleExtRequest("cursor/ask_question", CursorAskQuestionRequest, (params) =>
-              mapExtensionFailure(
-                Effect.gen(function* () {
-                  yield* logNative(
-                    input.threadId,
-                    "cursor/ask_question",
-                    params,
-                    "acp.cursor.extension",
-                  );
-                  const requestId = ApprovalRequestId.make(yield* randomUUIDv4);
-                  const runtimeRequestId = RuntimeRequestId.make(requestId);
-                  const answers = yield* Deferred.make<ProviderUserInputAnswers>();
-                  pendingUserInputs.set(requestId, { answers });
-                  yield* offerRuntimeEvent({
-                    type: "user-input.requested",
-                    ...(yield* makeEventStamp()),
-                    provider: PROVIDER,
-                    threadId: input.threadId,
-                    turnId: ctx?.activeTurnId,
-                    requestId: runtimeRequestId,
-                    payload: { questions: extractAskQuestions(params) },
-                    raw: {
-                      source: "acp.cursor.extension",
-                      method: "cursor/ask_question",
-                      payload: params,
-                    },
-                  });
-                  const resolved = yield* Deferred.await(answers);
-                  pendingUserInputs.delete(requestId);
-                  yield* offerRuntimeEvent({
-                    type: "user-input.resolved",
-                    ...(yield* makeEventStamp()),
-                    provider: PROVIDER,
-                    threadId: input.threadId,
-                    turnId: ctx?.activeTurnId,
-                    requestId: runtimeRequestId,
-                    payload: { answers: resolved },
-                  });
-                  return { answers: resolved };
-                }),
-              ),
-            );
-            yield* acp.handleExtRequest("cursor/create_plan", CursorCreatePlanRequest, (params) =>
-              mapExtensionFailure(
-                Effect.gen(function* () {
-                  yield* logNative(
-                    input.threadId,
-                    "cursor/create_plan",
-                    params,
-                    "acp.cursor.extension",
-                  );
-                  yield* offerRuntimeEvent({
-                    type: "turn.proposed.completed",
-                    ...(yield* makeEventStamp()),
-                    provider: PROVIDER,
-                    threadId: input.threadId,
-                    turnId: ctx?.activeTurnId,
-                    payload: { planMarkdown: extractPlanMarkdown(params) },
-                    raw: {
-                      source: "acp.cursor.extension",
-                      method: "cursor/create_plan",
-                      payload: params,
-                    },
-                  });
-                  return { accepted: true } as const;
-                }),
-              ),
-            );
-            yield* acp.handleExtNotification(
-              "cursor/update_todos",
-              CursorUpdateTodosRequest,
-              (params) =>
-                mapExtensionFailure(
-                  Effect.gen(function* () {
-                    yield* logNative(
-                      input.threadId,
-                      "cursor/update_todos",
-                      params,
-                      "acp.cursor.extension",
-                    );
-                    if (ctx) {
-                      yield* emitPlanUpdate(
-                        ctx,
-                        extractTodosAsPlan(params),
-                        params,
-                        "acp.cursor.extension",
-                        "cursor/update_todos",
-                      );
-                    }
-                  }),
-                ),
-            );
-            yield* acp.handleRequestPermission((params) =>
-              mapExtensionFailure(
-                Effect.gen(function* () {
-                  yield* logNative(
-                    input.threadId,
-                    "session/request_permission",
-                    params,
-                    "acp.jsonrpc",
-                  );
-                  if (input.runtimeMode === "full-access") {
-                    const autoApprovedOptionId = selectAutoApprovedPermissionOption(params);
-                    if (autoApprovedOptionId !== undefined) {
-                      return {
-                        outcome: {
-                          outcome: "selected" as const,
-                          optionId: autoApprovedOptionId,
-                        },
-                      };
-                    }
-                  }
-                  const permissionRequest = parsePermissionRequest(params);
-                  const requestId = ApprovalRequestId.make(yield* randomUUIDv4);
-                  const runtimeRequestId = RuntimeRequestId.make(requestId);
-                  const decision = yield* Deferred.make<ProviderApprovalDecision>();
-                  pendingApprovals.set(requestId, {
-                    decision,
-                    kind: permissionRequest.kind,
-                  });
-                  yield* offerRuntimeEvent(
-                    makeAcpRequestOpenedEvent({
-                      stamp: yield* makeEventStamp(),
-                      provider: PROVIDER,
-                      threadId: input.threadId,
-                      turnId: ctx?.activeTurnId,
-                      requestId: runtimeRequestId,
-                      permissionRequest,
-                      detail:
-                        permissionRequest.detail ??
-                        encodeJsonStringForDiagnostics(params)?.slice(0, 2000) ??
-                        "[unserializable params]",
-                      args: params,
-                      source: "acp.jsonrpc",
-                      method: "session/request_permission",
-                      rawPayload: params,
-                    }),
-                  );
-                  const resolved = yield* Deferred.await(decision);
-                  pendingApprovals.delete(requestId);
-                  yield* offerRuntimeEvent(
-                    makeAcpRequestResolvedEvent({
-                      stamp: yield* makeEventStamp(),
-                      provider: PROVIDER,
-                      threadId: input.threadId,
-                      turnId: ctx?.activeTurnId,
-                      requestId: runtimeRequestId,
-                      permissionRequest,
-                      decision: resolved,
-                    }),
-                  );
-                  return {
-                    outcome:
-                      resolved === "cancel"
-                        ? ({ outcome: "cancelled" } as const)
-                        : {
-                            outcome: "selected" as const,
-                            optionId: acpPermissionOutcome(resolved),
-                          },
-                  };
-                }),
-              ),
-            );
-            return yield* acp.start();
-          }).pipe(
-            Effect.mapError((error) =>
-              mapAcpToAdapterError(PROVIDER, input.threadId, "session/start", error),
-            ),
-          );
-
-          yield* applyRequestedSessionConfiguration({
-            runtime: acp,
-            runtimeMode: input.runtimeMode,
-            interactionMode: undefined,
-            modelSelection: cursorModelSelection,
-            mapError: ({ cause, method }) =>
-              mapAcpToAdapterError(PROVIDER, input.threadId, method, cause),
-          });
-
-          const now = yield* nowIso;
-          const session: ProviderSession = {
-            provider: PROVIDER,
-            providerInstanceId: boundInstanceId,
-            status: "ready",
-            runtimeMode: input.runtimeMode,
-            cwd,
-            model: cursorModelSelection?.model,
-            threadId: input.threadId,
-            resumeCursor: {
-              schemaVersion: CURSOR_RESUME_VERSION,
-              sessionId: started.sessionId,
-            },
-            createdAt: now,
-            updatedAt: now,
-          };
-
-          ctx = {
-            threadId: input.threadId,
-            session,
-            scope: sessionScope,
-            acp,
-            notificationFiber: undefined,
-            pendingApprovals,
-            pendingUserInputs,
-            turns: [],
-            lastPlanFingerprint: undefined,
-            activeTurnId: undefined,
-            promptsInFlight: 0,
-            stopped: false,
-          };
-
-          const nf = yield* Stream.runDrain(
-            Stream.mapEffect(acp.getEvents(), (event) =>
-              Effect.gen(function* () {
-                switch (event._tag) {
-                  case "EventStreamBarrier":
-                    yield* Deferred.succeed(event.acknowledge, undefined);
-                    return;
-                  case "ModeChanged":
-                    return;
-                  case "AssistantItemStarted":
-                    yield* offerRuntimeEvent(
-                      makeAcpAssistantItemEvent({
-                        stamp: yield* makeEventStamp(),
-                        provider: PROVIDER,
-                        threadId: ctx.threadId,
-                        turnId: ctx.activeTurnId,
-                        itemId: event.itemId,
-                        lifecycle: "item.started",
-                      }),
-                    );
-                    return;
-                  case "AssistantItemCompleted":
-                    yield* offerRuntimeEvent(
-                      makeAcpAssistantItemEvent({
-                        stamp: yield* makeEventStamp(),
-                        provider: PROVIDER,
-                        threadId: ctx.threadId,
-                        turnId: ctx.activeTurnId,
-                        itemId: event.itemId,
-                        lifecycle: "item.completed",
-                      }),
-                    );
-                    return;
-                  case "PlanUpdated":
-                    yield* logNative(
-                      ctx.threadId,
-                      "session/update",
-                      event.rawPayload,
-                      "acp.jsonrpc",
-                    );
-                    yield* emitPlanUpdate(
-                      ctx,
-                      event.payload,
-                      event.rawPayload,
-                      "acp.jsonrpc",
-                      "session/update",
-                    );
-                    return;
-                  case "ToolCallUpdated":
-                    yield* logNative(
-                      ctx.threadId,
-                      "session/update",
-                      event.rawPayload,
-                      "acp.jsonrpc",
-                    );
-                    yield* offerRuntimeEvent(
-                      makeAcpToolCallEvent({
-                        stamp: yield* makeEventStamp(),
-                        provider: PROVIDER,
-                        threadId: ctx.threadId,
-                        turnId: ctx.activeTurnId,
-                        toolCall: event.toolCall,
-                        rawPayload: event.rawPayload,
-                      }),
-                    );
-                    return;
-                  case "ContentDelta":
-                    yield* logNative(
-                      ctx.threadId,
-                      "session/update",
-                      event.rawPayload,
-                      "acp.jsonrpc",
-                    );
-                    yield* offerRuntimeEvent(
-                      makeAcpContentDeltaEvent({
-                        stamp: yield* makeEventStamp(),
-                        provider: PROVIDER,
-                        threadId: ctx.threadId,
-                        turnId: ctx.activeTurnId,
-                        ...(event.itemId ? { itemId: event.itemId } : {}),
-                        text: event.text,
-                        rawPayload: event.rawPayload,
-                      }),
-                    );
-                    return;
-                }
-              }),
-            ),
-          ).pipe(
-            Effect.catch((cause) =>
-              Effect.logError("Failed to process Cursor runtime notification.", { cause }),
-            ),
-            // Fork into the session scope, not the calling fiber. `forkChild`
-            // makes this a child of `startSession`, and Effect interrupts a
-            // fiber's children when it completes, so the consumer died as soon
-            // as `startSession` returned and every later notification was
-            // dropped. The scope is created, stored on the context and closed
-            // on teardown already; only the fork target was wrong.
-            Effect.forkIn(ctx.scope),
-          );
-
-          ctx.notificationFiber = nf;
-          sessions.set(input.threadId, ctx);
-          sessionScopeTransferred = true;
-
-          yield* offerRuntimeEvent({
-            type: "session.started",
-            ...(yield* makeEventStamp()),
-            provider: PROVIDER,
-            threadId: input.threadId,
-            payload: { resume: started.initializeResult },
-          });
-          yield* offerRuntimeEvent({
-            type: "session.state.changed",
-            ...(yield* makeEventStamp()),
-            provider: PROVIDER,
-            threadId: input.threadId,
-            payload: { state: "ready", reason: "Cursor ACP session ready" },
-          });
-          yield* offerRuntimeEvent({
-            type: "thread.started",
-            ...(yield* makeEventStamp()),
-            provider: PROVIDER,
-            threadId: input.threadId,
-            payload: { providerThreadId: started.sessionId },
-          });
-
-          return session;
-        }).pipe(Effect.scoped),
-      );
-
-    const sendTurn: CursorAdapterShape["sendTurn"] = (input) =>
-      Effect.gen(function* () {
-        const ctx = yield* requireSession(input.threadId);
-        // A sendTurn while a prompt is in flight is a steer: the agent folds
-        // the new prompt into the ongoing work, so the active turn id is
-        // reused instead of opening a new turn.
-        const steeringTurnId = ctx.promptsInFlight > 0 ? ctx.activeTurnId : undefined;
-        const turnId = steeringTurnId ?? TurnId.make(yield* randomUUIDv4);
-        // Count this prompt immediately so a superseded in-flight prompt
-        // resolving from here on does not settle the turn; the matching
-        // decrement is the `ensuring` below.
-        ctx.promptsInFlight += 1;
-
-        return yield* Effect.gen(function* () {
-          const turnModelSelection =
-            input.modelSelection?.instanceId === boundInstanceId ? input.modelSelection : undefined;
-          const model = turnModelSelection?.model ?? ctx.session.model;
-          const resolvedModel = resolveCursorAcpBaseModelId(model);
-          yield* applyRequestedSessionConfiguration({
-            runtime: ctx.acp,
-            runtimeMode: ctx.session.runtimeMode,
-            interactionMode: input.interactionMode,
-            modelSelection:
-              model === undefined
-                ? undefined
-                : {
-                    model,
-                    options: turnModelSelection?.options,
-                  },
-            mapError: ({ cause, method }) =>
-              mapAcpToAdapterError(PROVIDER, input.threadId, method, cause),
-          });
-          ctx.activeTurnId = turnId;
-          if (steeringTurnId === undefined) {
-            ctx.lastPlanFingerprint = undefined;
-          }
-          ctx.session = {
-            ...ctx.session,
-            activeTurnId: turnId,
-            updatedAt: yield* nowIso,
-          };
-
-          if (steeringTurnId === undefined) {
-            yield* offerRuntimeEvent({
-              type: "turn.started",
-              ...(yield* makeEventStamp()),
-              provider: PROVIDER,
-              threadId: input.threadId,
-              turnId,
-              payload: { model: resolvedModel },
-            });
-          }
-
-          const promptParts: Array<EffectAcpSchema.ContentBlock> = [];
-          if (input.input?.trim()) {
-            promptParts.push({ type: "text", text: input.input.trim() });
-          }
-          if (input.attachments && input.attachments.length > 0) {
-            for (const attachment of input.attachments) {
-              // Cursor ingests images only. Generic files reach the agent
-              // through the path line ProviderService puts in the prompt.
-              if (attachment.type !== "image") {
-                continue;
-              }
-              const attachmentPath = resolveAttachmentPath({
-                attachmentsDir: serverConfig.attachmentsDir,
-                attachment,
-              });
-              if (!attachmentPath) {
-                return yield* new ProviderAdapterRequestError({
-                  provider: PROVIDER,
-                  method: "session/prompt",
-                  detail: `Invalid attachment id '${attachment.id}'.`,
-                });
-              }
-              const bytes = yield* fileSystem.readFile(attachmentPath).pipe(
-                Effect.mapError(
-                  (cause) =>
-                    new ProviderAdapterRequestError({
-                      provider: PROVIDER,
-                      method: "session/prompt",
-                      detail: cause.message,
-                      cause,
-                    }),
-                ),
-              );
-              promptParts.push({
-                type: "image",
-                data: Buffer.from(bytes).toString("base64"),
-                mimeType: attachment.mimeType,
-              });
-            }
-          }
-
-          if (promptParts.length === 0) {
-            return yield* new ProviderAdapterValidationError({
-              provider: PROVIDER,
-              operation: "sendTurn",
-              issue: "Turn requires non-empty text or attachments.",
-            });
-          }
-
-          const result = yield* ctx.acp
-            .prompt({
-              prompt: promptParts,
-            })
-            .pipe(
-              Effect.mapError((error) =>
-                mapAcpToAdapterError(PROVIDER, input.threadId, "session/prompt", error),
-              ),
-            );
-
-          const turnRecord = ctx.turns.find((turn) => turn.id === turnId);
-          if (turnRecord) {
-            turnRecord.items.push({ prompt: promptParts, result });
-          } else {
-            ctx.turns.push({ id: turnId, items: [{ prompt: promptParts, result }] });
-          }
-          ctx.session = {
-            ...ctx.session,
-            activeTurnId: turnId,
-            updatedAt: yield* nowIso,
-            model: resolvedModel,
-          };
-
-          // Only the last remaining prompt settles the turn — a steer-
-          // superseded prompt resolving (usually cancelled) while another is
-          // in flight or pending must leave the merged turn running.
-          if (ctx.promptsInFlight === 1) {
-            yield* offerRuntimeEvent({
-              type: "turn.completed",
-              ...(yield* makeEventStamp()),
-              provider: PROVIDER,
-              threadId: input.threadId,
-              turnId,
-              payload: {
-                state: result.stopReason === "cancelled" ? "cancelled" : "completed",
-                stopReason: result.stopReason ?? null,
-              },
-            });
-          }
-
-          return {
-            threadId: input.threadId,
-            turnId,
-            resumeCursor: ctx.session.resumeCursor,
-          };
-        }).pipe(
-          Effect.ensuring(
-            Effect.sync(() => {
-              ctx.promptsInFlight = Math.max(0, ctx.promptsInFlight - 1);
-            }),
-          ),
-        );
-      });
-
-    const interruptTurn: CursorAdapterShape["interruptTurn"] = (threadId) =>
-      Effect.gen(function* () {
-        const ctx = yield* requireSession(threadId);
-        yield* settlePendingApprovalsAsCancelled(ctx.pendingApprovals);
-        yield* settlePendingUserInputsAsEmptyAnswers(ctx.pendingUserInputs);
-        yield* Effect.ignore(
-          ctx.acp.cancel.pipe(
-            Effect.mapError((error) =>
-              mapAcpToAdapterError(PROVIDER, threadId, "session/cancel", error),
-            ),
-          ),
-        );
-      });
-
-    const respondToRequest: CursorAdapterShape["respondToRequest"] = (
-      threadId,
-      requestId,
-      decision,
-    ) =>
-      Effect.gen(function* () {
-        const ctx = yield* requireSession(threadId);
-        const pending = ctx.pendingApprovals.get(requestId);
-        if (!pending) {
-          return yield* new ProviderAdapterRequestError({
-            provider: PROVIDER,
-            method: "session/request_permission",
-            detail: `Unknown pending approval request: ${requestId}`,
-          });
-        }
-        yield* Deferred.succeed(pending.decision, decision);
-      });
-
-    const respondToUserInput: CursorAdapterShape["respondToUserInput"] = (
-      threadId,
-      requestId,
-      answers,
-    ) =>
-      Effect.gen(function* () {
-        const ctx = yield* requireSession(threadId);
-        const pending = ctx.pendingUserInputs.get(requestId);
-        if (!pending) {
-          return yield* new ProviderAdapterRequestError({
-            provider: PROVIDER,
-            method: "cursor/ask_question",
-            detail: `Unknown pending user-input request: ${requestId}`,
-          });
-        }
-        yield* Deferred.succeed(pending.answers, answers);
-      });
-
-    const readThread: CursorAdapterShape["readThread"] = (threadId) =>
-      Effect.gen(function* () {
-        const ctx = yield* requireSession(threadId);
-        return { threadId, turns: ctx.turns };
-      });
-
-    const rollbackThread: CursorAdapterShape["rollbackThread"] = (threadId, numTurns) =>
-      Effect.gen(function* () {
-        const ctx = yield* requireSession(threadId);
-        if (!Number.isInteger(numTurns) || numTurns < 1) {
-          return yield* new ProviderAdapterValidationError({
-            provider: PROVIDER,
-            operation: "rollbackThread",
-            issue: "numTurns must be an integer >= 1.",
-          });
-        }
-        const nextLength = Math.max(0, ctx.turns.length - numTurns);
-        ctx.turns.splice(nextLength);
-        return { threadId, turns: ctx.turns };
-      });
-
-    const stopSession: CursorAdapterShape["stopSession"] = (threadId) =>
-      withThreadLock(
-        threadId,
-        Effect.gen(function* () {
-          const ctx = yield* requireSession(threadId);
-          yield* stopSessionInternal(ctx);
-        }),
-      );
-
-    const listSessions: CursorAdapterShape["listSessions"] = () =>
-      Effect.sync(() => Array.from(sessions.values(), (c) => ({ ...c.session })));
-
-    const hasSession: CursorAdapterShape["hasSession"] = (threadId) =>
-      Effect.sync(() => {
-        const c = sessions.get(threadId);
-        return c !== undefined && !c.stopped;
-      });
-
-    const stopAll: CursorAdapterShape["stopAll"] = () =>
-      Effect.forEach(sessions.values(), stopSessionInternal, { discard: true });
-
-    yield* Effect.addFinalizer(() =>
-      Effect.forEach(sessions.values(), stopSessionInternal, { discard: true }).pipe(
-        Effect.catch((cause) =>
-          Effect.logError("Failed to emit Cursor session shutdown event.", { cause }),
-        ),
-        Effect.tap(() => PubSub.shutdown(runtimeEventPubSub)),
-        Effect.tap(() => managedNativeEventLogger?.close() ?? Effect.void),
-      ),
-    );
-
-    const streamEvents = Stream.fromPubSub(runtimeEventPubSub);
-
-    return {
-      provider: PROVIDER,
-      capabilities: { sessionModelSwitch: "in-session" },
-      startSession,
-      sendTurn,
-      interruptTurn,
-      readThread,
-      rollbackThread,
-      respondToRequest,
-      respondToUserInput,
-      stopSession,
-      listSessions,
-      hasSession,
-      stopAll,
-      streamEvents,
-    } satisfies CursorAdapterShape;
-  });
-}
diff --git a/apps/server/src/provider/Layers/CursorProvider.test.ts b/apps/server/src/provider/Layers/CursorProvider.test.ts
index e969a7beab41..3c591f6f0608 100644
--- a/apps/server/src/provider/Layers/CursorProvider.test.ts
+++ b/apps/server/src/provider/Layers/CursorProvider.test.ts
@@ -1,42 +1,22 @@
-import * as NodeOS from "node:os";
-
-import * as NodeServices from "@effect/platform-node/NodeServices";
-import type * as Crypto from "effect/Crypto";
+import type { SDKModel } from "@cursor/sdk";
+import { describe, expect, it } from "@effect/vitest";
 import * as Effect from "effect/Effect";
-import * as FileSystem from "effect/FileSystem";
-import * as Path from "effect/Path";
-import type * as ChildProcessSpawner from "effect/unstable/process/ChildProcessSpawner";
-import { describe, expect, it } from "vite-plus/test";
-import type * as EffectAcpSchema from "effect-acp/schema";
+import * as Schema from "effect/Schema";
 import type { CursorSettings } from "@t3tools/contracts";
+import { CursorSettings as CursorSettingsSchema } from "@t3tools/contracts";
 import { createModelCapabilities } from "@t3tools/shared/model";
 
 import {
+  buildCursorCapabilitiesFromSdkModel,
+  buildCursorDiscoveredModelsFromSdk,
   buildCursorProviderSnapshot,
-  buildCursorCapabilitiesFromConfigOptions,
+  buildInitialCursorProviderSnapshot,
   checkCursorProviderStatus,
-  discoverCursorModelsViaAcp,
   getCursorFallbackModels,
-  getCursorParameterizedModelPickerUnsupportedMessage,
-  parseCursorAboutOutput,
-  parseCursorCliConfigChannel,
-  parseCursorVersionDate,
-  resolveCursorAcpBaseModelId,
-  resolveCursorAcpConfigUpdates,
 } from "./CursorProvider.ts";
+import { CursorSdkCatalogError, makeCursorSdkCatalogTestLayer } from "./CursorSdkCatalog.ts";
 
-const runNode = <A, E>(
-  effect: Effect.Effect<
-    A,
-    E,
-    ChildProcessSpawner.ChildProcessSpawner | Crypto.Crypto | FileSystem.FileSystem | Path.Path
-  >,
-): Promise<A> => Effect.runPromise(effect.pipe(Effect.provide(NodeServices.layer)));
-
-const resolveMockAgentPath = Effect.fn("resolveMockAgentPath")(function* () {
-  const path = yield* Path.Path;
-  return yield* path.fromFileUrl(new URL("../../../scripts/acp-mock-agent.ts", import.meta.url));
-});
+const decodeCursorSettings = Schema.decodeSync(CursorSettingsSchema);
 
 function selectDescriptor(
   id: string,
@@ -63,257 +43,58 @@ function booleanDescriptor(id: string, label: string, currentValue?: boolean) {
   };
 }
 
-const makeMockAgentWrapper = Effect.fn("makeMockAgentWrapper")(function* (
-  extraEnv?: Record<string, string>,
-) {
-  const fileSystem = yield* FileSystem.FileSystem;
-  const path = yield* Path.Path;
-  const mockAgentPath = yield* resolveMockAgentPath();
-  const dir = yield* fileSystem.makeTempDirectory({
-    directory: NodeOS.tmpdir(),
-    prefix: "cursor-provider-mock-",
-  });
-  const wrapperPath = path.join(dir, "fake-agent.sh");
-  const mockAgentCommand = ["node", mockAgentPath].map((arg) => JSON.stringify(arg)).join(" ");
-  const envExports = Object.entries(extraEnv ?? {})
-    .map(([key, value]) => `export ${key}=${JSON.stringify(value)}`)
-    .join("\n");
-  const script = `#!/bin/sh
-${envExports}
-exec ${mockAgentCommand} "$@"
-`;
-  yield* fileSystem.writeFileString(wrapperPath, script);
-  yield* fileSystem.chmod(wrapperPath, 0o755);
-  return wrapperPath;
-});
-
-const makeMockAgentWithAboutWrapper = Effect.fn("makeMockAgentWithAboutWrapper")(function* () {
-  const fileSystem = yield* FileSystem.FileSystem;
-  const path = yield* Path.Path;
-  const mockAgentPath = yield* resolveMockAgentPath();
-  const dir = yield* fileSystem.makeTempDirectory({
-    directory: NodeOS.tmpdir(),
-    prefix: "cursor-provider-about-mock-",
-  });
-  const wrapperPath = path.join(dir, "fake-agent.sh");
-  const mockAgentCommand = ["node", mockAgentPath].map((arg) => JSON.stringify(arg)).join(" ");
-  const script = `#!/bin/sh
-if [ "$1" = "about" ]; then
-  printf 'CLI Version         2026.04.09-f2b0fcd\\n'
-  printf 'User Email          cursor@example.com\\n'
-  exit 0
-fi
-exec ${mockAgentCommand} "$@"
-`;
-  yield* fileSystem.writeFileString(wrapperPath, script);
-  yield* fileSystem.chmod(wrapperPath, 0o755);
-  return wrapperPath;
-});
-
-const waitForFileContent = Effect.fn("waitForFileContent")(function* (
-  filePath: string,
-  attempts = 40,
-) {
-  const fileSystem = yield* FileSystem.FileSystem;
-  for (let attempt = 0; attempt < attempts; attempt += 1) {
-    const content = yield* fileSystem
-      .readFileString(filePath)
-      .pipe(Effect.catch(() => Effect.void));
-    if (content !== undefined) {
-      if (content.trim().length > 0) {
-        return content;
-      }
-    }
-    yield* Effect.sleep("50 millis");
-  }
-  return yield* Effect.die(`Timed out waiting for file content at ${filePath}`);
-});
-
-const makeProviderStatusEnvFixture = Effect.fn("makeProviderStatusEnvFixture")(function* () {
-  const fileSystem = yield* FileSystem.FileSystem;
-  const path = yield* Path.Path;
-  const tempDir = yield* fileSystem.makeTempDirectory({
-    directory: NodeOS.tmpdir(),
-    prefix: "cursor-provider-status-env-",
-  });
-  return {
-    requestLogPath: path.join(tempDir, "requests.ndjson"),
-    wrapperPath: yield* makeMockAgentWithAboutWrapper(),
-  };
-});
-
-const makeExitLogFixture = Effect.fn("makeExitLogFixture")(function* (prefix: string) {
-  const fileSystem = yield* FileSystem.FileSystem;
-  const path = yield* Path.Path;
-  const tempDir = yield* fileSystem.makeTempDirectory({
-    directory: NodeOS.tmpdir(),
-    prefix,
-  });
-  const exitLogPath = path.join(tempDir, "exit.log");
-  return {
-    exitLogPath,
-    wrapperPath: yield* makeMockAgentWrapper({
-      T3_ACP_EXIT_LOG_PATH: exitLogPath,
-    }),
-  };
-});
-
-const parameterizedGpt54ConfigOptions = [
-  {
-    type: "select",
-    currentValue: "gpt-5.4-medium-fast",
-    options: [{ name: "GPT-5.4", value: "gpt-5.4-medium-fast" }],
-    category: "model",
-    id: "model",
-    name: "Model",
-  },
-  {
-    type: "select",
-    currentValue: "medium",
-    options: [
-      { name: "None", value: "none" },
-      { name: "Low", value: "low" },
-      { name: "Medium", value: "medium" },
-      { name: "High", value: "high" },
-      { name: "Extra High", value: "extra-high" },
-    ],
-    category: "thought_level",
-    id: "reasoning",
-    name: "Reasoning",
-  },
-  {
-    type: "select",
-    currentValue: "272k",
-    options: [
-      { name: "272K", value: "272k" },
-      { name: "1M", value: "1m" },
-    ],
-    category: "model_config",
-    id: "context",
-    name: "Context",
-  },
-  {
-    type: "select",
-    currentValue: "false",
-    options: [
-      { name: "Off", value: "false" },
-      { name: "Fast", value: "true" },
-    ],
-    category: "model_config",
-    id: "fast",
-    name: "Fast",
-  },
-] satisfies ReadonlyArray<EffectAcpSchema.SessionConfigOption>;
-
-const parameterizedClaudeConfigOptions = [
-  {
-    type: "select",
-    currentValue: "claude-4.6-opus-high-thinking",
-    options: [{ name: "Opus 4.6", value: "claude-4.6-opus-high-thinking" }],
-    category: "model",
-    id: "model",
-    name: "Model",
-  },
-  {
-    type: "select",
-    currentValue: "high",
-    options: [
-      { name: "Low", value: "low" },
-      { name: "Medium", value: "medium" },
-      { name: "High", value: "high" },
-    ],
-    category: "thought_level",
-    id: "reasoning",
-    name: "Reasoning",
-  },
-  {
-    type: "boolean",
-    currentValue: true,
-    category: "model_config",
-    id: "thinking",
-    name: "Thinking",
-  },
-] satisfies ReadonlyArray<EffectAcpSchema.SessionConfigOption>;
-
-const parameterizedClaudeModelOptionConfigOptions = [
-  {
-    type: "select",
-    currentValue: "claude-opus-4-6",
-    options: [{ name: "Opus 4.6", value: "claude-opus-4-6" }],
-    category: "model",
-    id: "model",
-    name: "Model",
-  },
-  {
-    type: "select",
-    currentValue: "high",
-    options: [
-      { name: "Low", value: "low" },
-      { name: "Medium", value: "medium" },
-      { name: "High", value: "high" },
-    ],
-    category: "thought_level",
-    id: "reasoning",
-    name: "Reasoning",
-  },
-  {
-    type: "select",
-    currentValue: "max",
-    options: [
-      { name: "Low", value: "low" },
-      { name: "Medium", value: "medium" },
-      { name: "High", value: "high" },
-      { name: "Max", value: "max" },
-    ],
-    category: "model_option",
-    id: "effort",
-    name: "Effort",
-  },
-  {
-    type: "select",
-    currentValue: "true",
-    options: [
-      { name: "Off", value: "false" },
-      { name: "Fast", value: "true" },
-    ],
-    category: "model_config",
-    id: "fast",
-    name: "Fast",
-  },
-  {
-    type: "select",
-    currentValue: "true",
-    options: [
-      { name: "Off", value: "false" },
-      { name: ":icon-brain:", value: "true" },
-    ],
-    category: "model_config",
-    id: "thinking",
-    name: "Thinking",
-  },
-] satisfies ReadonlyArray<EffectAcpSchema.SessionConfigOption>;
-
-const baseCursorSettings: CursorSettings = {
+const baseCursorSettings: CursorSettings = decodeCursorSettings({
   enabled: true,
-  binaryPath: "cursor-agent",
-  apiEndpoint: "",
   customModels: [],
-};
-const cursorAcpDiscoveryFailedMessage = [
-  "Cursor ACP model discovery failed.",
-  "Cursor CLI setup may be incomplete; install or enable the Cursor CLI, restart T3 Code, and try again.",
-  "See https://cursor.com/docs/cli/installation.",
-  "Check server logs for ACP details.",
-].join(" ");
-const missingCursorBinaryPath = "/definitely/not/installed/t3-cursor-agent";
-const cursorCliCommandMissingMessage = [
-  `Cursor CLI command \`${missingCursorBinaryPath}\` was not found.`,
-  `Install or enable the Cursor CLI, make sure \`${missingCursorBinaryPath}\` is on PATH, then restart T3 Code.`,
-  "See https://cursor.com/docs/cli/installation.",
-].join(" ");
+});
+
+const sdkParameterizedModel = {
+  id: "claude-opus-4-8",
+  displayName: "Opus 4.8",
+  parameters: [
+    {
+      id: "thinking",
+      displayName: "Thinking",
+      values: [{ value: "false" }, { value: "true" }],
+    },
+    {
+      id: "context",
+      displayName: "Context",
+      values: [
+        { value: "300k", displayName: "300K" },
+        { value: "1m", displayName: "1M" },
+      ],
+    },
+    {
+      id: "effort",
+      displayName: "Effort",
+      values: [
+        { value: "low", displayName: "Low" },
+        { value: "high", displayName: "High" },
+      ],
+    },
+    {
+      id: "fast",
+      displayName: "Fast",
+      values: [{ value: "false" }, { value: "true", displayName: "Fast" }],
+    },
+  ],
+  variants: [
+    {
+      displayName: "Opus 4.8",
+      isDefault: true,
+      params: [
+        { id: "thinking", value: "true" },
+        { id: "context", value: "1m" },
+        { id: "effort", value: "high" },
+        { id: "fast", value: "false" },
+      ],
+    },
+  ],
+} satisfies SDKModel;
 
 describe("getCursorFallbackModels", () => {
-  it("does not publish any built-in cursor models before ACP discovery", () => {
+  it("does not publish any built-in cursor models before SDK discovery", () => {
     expect(
       getCursorFallbackModels({
         customModels: ["internal/cursor-model"],
@@ -322,359 +103,160 @@ describe("getCursorFallbackModels", () => {
   });
 });
 
+describe("buildInitialCursorProviderSnapshot", () => {
+  it.effect("uses SDK-specific pending status copy", () =>
+    Effect.gen(function* () {
+      const provider = yield* buildInitialCursorProviderSnapshot(baseCursorSettings);
+
+      expect(provider).toMatchObject({
+        status: "warning",
+        message: "Checking Cursor SDK availability...",
+      });
+    }),
+  );
+});
+
 describe("buildCursorProviderSnapshot", () => {
-  it("downgrades ready status to warning when ACP model discovery times out", () => {
+  it("downgrades ready status to warning when SDK model discovery returns no models", () => {
     expect(
       buildCursorProviderSnapshot({
         checkedAt: "2026-01-01T00:00:00.000Z",
         cursorSettings: baseCursorSettings,
         parsed: {
-          version: "2026.04.09-f2b0fcd",
+          version: null,
           status: "ready",
-          auth: { status: "authenticated", type: "Team", label: "Cursor Team Subscription" },
+          auth: { status: "authenticated", type: "api-key", label: "Cursor API key" },
         },
-        discoveryWarning: "Cursor ACP model discovery timed out after 15000ms.",
+        discoveryWarning: "Cursor SDK model discovery returned no built-in models.",
       }),
     ).toMatchObject({
       status: "warning",
-      message: "Cursor ACP model discovery timed out after 15000ms.",
+      message: "Cursor SDK model discovery returned no built-in models.",
       models: [],
     });
   });
-
-  it("preserves provider error state while appending discovery warnings", () => {
-    expect(
-      buildCursorProviderSnapshot({
-        checkedAt: "2026-01-01T00:00:00.000Z",
-        cursorSettings: {
-          ...baseCursorSettings,
-          customModels: ["claude-sonnet-4-6"],
-        },
-        parsed: {
-          version: "2026.04.09-f2b0fcd",
-          status: "error",
-          auth: { status: "unauthenticated" },
-          message: "Cursor Agent is not authenticated. Run `agent login` and try again.",
-        },
-        discoveryWarning: cursorAcpDiscoveryFailedMessage,
-      }),
-    ).toMatchObject({
-      status: "error",
-      message: `Cursor Agent is not authenticated. Run \`agent login\` and try again. ${cursorAcpDiscoveryFailedMessage}`,
-      models: [
-        {
-          slug: "claude-sonnet-4-6",
-          isCustom: true,
-        },
-      ],
-    });
-  });
 });
 
-describe("buildCursorCapabilitiesFromConfigOptions", () => {
-  it("derives model capabilities from parameterized Cursor ACP config options", () => {
-    expect(buildCursorCapabilitiesFromConfigOptions(parameterizedGpt54ConfigOptions)).toEqual(
+describe("Cursor SDK model discovery", () => {
+  it("maps native SDK parameter ids and default variant values to model capabilities", () => {
+    expect(buildCursorCapabilitiesFromSdkModel(sdkParameterizedModel)).toEqual(
       createModelCapabilities({
         optionDescriptors: [
-          selectDescriptor("reasoning", "Reasoning", [
+          selectDescriptor("effort", "Effort", [
             { id: "low", label: "Low" },
-            { id: "medium", label: "Medium", isDefault: true },
-            { id: "high", label: "High" },
-            { id: "xhigh", label: "Extra High" },
+            { id: "high", label: "High", isDefault: true },
           ]),
           selectDescriptor("contextWindow", "Context", [
-            { id: "272k", label: "272K", isDefault: true },
-            { id: "1m", label: "1M" },
+            { id: "300k", label: "300K" },
+            { id: "1m", label: "1M", isDefault: true },
           ]),
           booleanDescriptor("fastMode", "Fast", false),
-        ],
-      }),
-    );
-  });
-
-  it("detects boolean thinking toggles from model_config options", () => {
-    expect(buildCursorCapabilitiesFromConfigOptions(parameterizedClaudeConfigOptions)).toEqual(
-      createModelCapabilities({
-        optionDescriptors: [
-          selectDescriptor("reasoning", "Reasoning", [
-            { id: "low", label: "Low" },
-            { id: "medium", label: "Medium" },
-            { id: "high", label: "High", isDefault: true },
-          ]),
           booleanDescriptor("thinking", "Thinking", true),
         ],
       }),
     );
   });
 
-  it("prefers the newer model_option effort control over legacy thought_level", () => {
+  it("filters invalid and duplicate SDK model entries", () => {
     expect(
-      buildCursorCapabilitiesFromConfigOptions(parameterizedClaudeModelOptionConfigOptions),
-    ).toEqual(
-      createModelCapabilities({
-        optionDescriptors: [
-          selectDescriptor("reasoning", "Effort", [
-            { id: "low", label: "Low" },
-            { id: "medium", label: "Medium" },
-            { id: "high", label: "High" },
-            { id: "max", label: "Max", isDefault: true },
-          ]),
-          booleanDescriptor("fastMode", "Fast", true),
-          booleanDescriptor("thinking", "Thinking", true),
-        ],
-      }),
-    );
+      buildCursorDiscoveredModelsFromSdk([
+        sdkParameterizedModel,
+        { ...sdkParameterizedModel, displayName: "Duplicate" },
+        { id: "", displayName: "Invalid" },
+      ]),
+    ).toEqual([
+      {
+        slug: "claude-opus-4-8",
+        name: "Opus 4.8",
+        isCustom: false,
+        capabilities: buildCursorCapabilitiesFromSdkModel(sdkParameterizedModel),
+      },
+    ]);
   });
 });
 
 describe("checkCursorProviderStatus", () => {
-  it("reports the install docs when the Cursor CLI command is missing", async () => {
-    const provider = await runNode(
-      checkCursorProviderStatus({
-        enabled: true,
-        binaryPath: missingCursorBinaryPath,
-        apiEndpoint: "",
-        customModels: [],
-      }),
-    );
-
-    expect(provider).toMatchObject({
-      installed: false,
-      status: "error",
-      auth: { status: "unknown" },
-      message: cursorCliCommandMissingMessage,
-    });
-  });
-
-  it("passes the injected environment to ACP model discovery", async () => {
-    const { requestLogPath, wrapperPath } = await runNode(makeProviderStatusEnvFixture());
-
-    const provider = await runNode(
+  it("uses the SDK catalog when CURSOR_API_KEY is configured", async () => {
+    const provider = await Effect.runPromise(
       checkCursorProviderStatus(
         {
-          enabled: true,
-          binaryPath: wrapperPath,
-          apiEndpoint: "",
-          customModels: [],
-        },
-        {
-          ...process.env,
-          T3_ACP_REQUEST_LOG_PATH: requestLogPath,
+          ...baseCursorSettings,
+          customModels: ["internal/cursor-model"],
         },
+        { CURSOR_API_KEY: "test-cursor-key" },
+      ).pipe(
+        Effect.provide(
+          makeCursorSdkCatalogTestLayer((apiKey) => {
+            expect(apiKey).toBe("test-cursor-key");
+            return Effect.succeed({
+              user: {
+                apiKeyName: "test-key",
+                userEmail: "cursor@example.com",
+                createdAt: "2026-01-01T00:00:00.000Z",
+              },
+              models: [sdkParameterizedModel],
+            });
+          }),
+        ),
       ),
     );
 
-    expect(provider.models.map((model) => model.slug)).toEqual([
-      "default",
-      "composer-2",
-      "gpt-5.4",
-      "claude-opus-4-6",
-    ]);
-    await expect(runNode(waitForFileContent(requestLogPath))).resolves.toContain("initialize");
-  });
-});
-
-describe("discoverCursorModelsViaAcp", () => {
-  it("keeps the ACP probe runtime alive long enough to discover models", async () => {
-    const wrapperPath = await runNode(makeMockAgentWrapper());
-
-    const models = await runNode(
-      discoverCursorModelsViaAcp({
-        enabled: true,
-        binaryPath: wrapperPath,
-        apiEndpoint: "",
-        customModels: [],
-      }).pipe(Effect.scoped),
-    );
-
-    expect(models.map((model) => model.slug)).toEqual([
-      "default",
-      "composer-2",
-      "gpt-5.4",
-      "claude-opus-4-6",
-    ]);
-  });
-
-  it("closes the ACP probe runtime after discovery completes", async () => {
-    const { exitLogPath, wrapperPath } = await runNode(
-      makeExitLogFixture("cursor-provider-exit-log-"),
-    );
-
-    await runNode(
-      discoverCursorModelsViaAcp({
-        enabled: true,
-        binaryPath: wrapperPath,
-        apiEndpoint: "",
-        customModels: [],
-      }),
-    );
-
-    const exitLog = await runNode(waitForFileContent(exitLogPath));
-    expect(exitLog).toContain("SIGTERM");
-  });
-});
-
-describe("parseCursorAboutOutput", () => {
-  it("parses json about output and forwards subscription metadata", () => {
-    expect(
-      parseCursorAboutOutput({
-        code: 0,
-        stdout: JSON.stringify({
-          cliVersion: "2026.04.09-f2b0fcd",
-          subscriptionTier: "Team",
-          userEmail: "jmarminge@gmail.com",
-        }),
-        stderr: "",
-      }),
-    ).toEqual({
-      version: "2026.04.09-f2b0fcd",
+    expect(provider).toMatchObject({
       status: "ready",
       auth: {
         status: "authenticated",
-        email: "jmarminge@gmail.com",
-        type: "Team",
-        label: "Cursor Team Subscription",
+        type: "api-key",
+        label: "Cursor API key (test-key)",
+        email: "cursor@example.com",
       },
+      models: [
+        { slug: "claude-opus-4-8", isCustom: false },
+        { slug: "internal/cursor-model", isCustom: true },
+      ],
     });
   });
 
-  it("treats json about output with a logged-out email as unauthenticated", () => {
-    expect(
-      parseCursorAboutOutput({
-        code: 0,
-        stdout: JSON.stringify({
-          cliVersion: "2026.04.09-f2b0fcd",
-          subscriptionTier: "Team",
-          userEmail: "Not logged in",
-        }),
-        stderr: "",
-      }),
-    ).toEqual({
-      version: "2026.04.09-f2b0fcd",
-      status: "error",
-      auth: {
-        status: "unauthenticated",
-      },
-      message: "Cursor Agent is not authenticated. Run `agent login` and try again.",
-    });
-  });
+  it("surfaces SDK authentication failures", async () => {
+    const provider = await Effect.runPromise(
+      checkCursorProviderStatus(baseCursorSettings, {
+        CURSOR_API_KEY: "invalid-test-key",
+      }).pipe(
+        Effect.provide(
+          makeCursorSdkCatalogTestLayer(() =>
+            Effect.fail(
+              new CursorSdkCatalogError({
+                authenticationFailure: true,
+                cause: new Error("unauthorized"),
+              }),
+            ),
+          ),
+        ),
+      ),
+    );
 
-  it("treats json about output with a null email as unauthenticated", () => {
-    expect(
-      parseCursorAboutOutput({
-        code: 0,
-        stdout: JSON.stringify({
-          cliVersion: "2026.04.09-f2b0fcd",
-          subscriptionTier: null,
-          userEmail: null,
-        }),
-        stderr: "",
-      }),
-    ).toEqual({
-      version: "2026.04.09-f2b0fcd",
+    expect(provider).toMatchObject({
       status: "error",
-      auth: {
-        status: "unauthenticated",
-      },
-      message: "Cursor Agent is not authenticated. Run `agent login` and try again.",
+      auth: { status: "unauthenticated" },
+      message: "Cursor SDK authentication failed. Check CURSOR_API_KEY.",
     });
   });
-});
 
-describe("Cursor parameterized model picker preview gating", () => {
-  it("parses Cursor CLI version dates from build versions", () => {
-    expect(parseCursorVersionDate("2026.04.08-c4e73a3")).toBe(20260408);
-    expect(parseCursorVersionDate("2026.04.09")).toBe(20260409);
-    expect(parseCursorVersionDate("not-a-version")).toBeUndefined();
-  });
-
-  it("parses the Cursor CLI channel from cli-config.json", () => {
-    expect(parseCursorCliConfigChannel('{ "channel": "lab" }')).toBe("lab");
-    expect(parseCursorCliConfigChannel('{ "channel": "stable" }')).toBe("stable");
-    expect(parseCursorCliConfigChannel('{ "version": 1 }')).toBeUndefined();
-    expect(parseCursorCliConfigChannel("not-json")).toBeUndefined();
-  });
-
-  it("returns no warning when the preview requirements are met", () => {
-    expect(
-      getCursorParameterizedModelPickerUnsupportedMessage({
-        version: "2026.04.08-c4e73a3",
-        channel: "lab",
-      }),
-    ).toBeUndefined();
-  });
-
-  it("explains when the Cursor Agent version is too old", () => {
-    expect(
-      getCursorParameterizedModelPickerUnsupportedMessage({
-        version: "2026.04.07-c4e73a3",
-        channel: "lab",
-      }),
-    ).toContain("too old");
-  });
-
-  it("explains when the Cursor Agent channel is not lab", () => {
-    expect(
-      getCursorParameterizedModelPickerUnsupportedMessage({
-        version: "2026.04.08-c4e73a3",
-        channel: "stable",
-      }),
-    ).toContain("lab channel");
-  });
-});
-
-describe("resolveCursorAcpBaseModelId", () => {
-  it("drops bracket traits without rewriting raw ACP model ids", () => {
-    expect(resolveCursorAcpBaseModelId("gpt-5.4[reasoning=medium,context=272k]")).toBe("gpt-5.4");
-    expect(resolveCursorAcpBaseModelId("gpt-5.4-medium-fast")).toBe("gpt-5.4-medium-fast");
-    expect(resolveCursorAcpBaseModelId("claude-4.6-opus-high-thinking")).toBe(
-      "claude-4.6-opus-high-thinking",
+  it("requires a Cursor API key without probing any external Cursor binary", async () => {
+    const provider = await Effect.runPromise(
+      checkCursorProviderStatus(baseCursorSettings).pipe(
+        Effect.provide(
+          makeCursorSdkCatalogTestLayer(() =>
+            Effect.die("SDK catalog must not be used without CURSOR_API_KEY"),
+          ),
+        ),
+      ),
     );
-    expect(resolveCursorAcpBaseModelId("composer-2")).toBe("composer-2");
-    expect(resolveCursorAcpBaseModelId("auto")).toBe("auto");
-  });
-});
 
-describe("resolveCursorAcpConfigUpdates", () => {
-  it("maps Cursor model options onto separate ACP config option updates", () => {
-    expect(
-      resolveCursorAcpConfigUpdates(parameterizedGpt54ConfigOptions, [
-        { id: "reasoning", value: "xhigh" },
-        { id: "fastMode", value: true },
-        { id: "contextWindow", value: "1m" },
-      ]),
-    ).toEqual([
-      { configId: "reasoning", value: "extra-high" },
-      { configId: "context", value: "1m" },
-      { configId: "fast", value: "true" },
-    ]);
-  });
-
-  it("maps boolean thinking toggles when the model exposes them separately", () => {
-    expect(
-      resolveCursorAcpConfigUpdates(parameterizedClaudeConfigOptions, [
-        { id: "thinking", value: false },
-      ]),
-    ).toEqual([{ configId: "thinking", value: false }]);
-  });
-
-  it("maps explicit fastMode: false so the adapter can clear a prior fast selection", () => {
-    expect(
-      resolveCursorAcpConfigUpdates(parameterizedGpt54ConfigOptions, [
-        { id: "fastMode", value: false },
-      ]),
-    ).toEqual([{ configId: "fast", value: "false" }]);
-  });
-
-  it("writes Cursor effort changes through the newer model_option config when available", () => {
-    expect(
-      resolveCursorAcpConfigUpdates(parameterizedClaudeModelOptionConfigOptions, [
-        { id: "reasoning", value: "max" },
-        { id: "thinking", value: false },
-      ]),
-    ).toEqual([
-      { configId: "effort", value: "max" },
-      { configId: "thinking", value: "false" },
-    ]);
+    expect(provider).toMatchObject({
+      installed: true,
+      status: "error",
+      auth: { status: "unauthenticated" },
+      message: "Cursor API key is required. Add CURSOR_API_KEY in provider settings.",
+    });
   });
 });
diff --git a/apps/server/src/provider/Layers/CursorProvider.ts b/apps/server/src/provider/Layers/CursorProvider.ts
index fee4306c4c5c..3e9631c83eab 100644
--- a/apps/server/src/provider/Layers/CursorProvider.ts
+++ b/apps/server/src/provider/Layers/CursorProvider.ts
@@ -1,78 +1,37 @@
-import * as NodeOS from "node:os";
+import type { SDKModel, SDKUser } from "@cursor/sdk";
 import type {
   CursorSettings,
   ModelCapabilities,
-  ProviderOptionSelection,
-  ServerProvider,
+  ProviderOptionDescriptor,
   ServerProviderAuth,
   ServerProviderModel,
   ServerProviderState,
 } from "@t3tools/contracts";
-import type * as EffectAcpSchema from "effect-acp/schema";
-import { causeErrorTag } from "@t3tools/shared/observability";
-import * as Crypto from "effect/Crypto";
+import { createModelCapabilities } from "@t3tools/shared/model";
 import * as DateTime from "effect/DateTime";
 import * as Effect from "effect/Effect";
-import * as Exit from "effect/Exit";
-import * as FileSystem from "effect/FileSystem";
-import * as Layer from "effect/Layer";
 import * as Option from "effect/Option";
-import * as Path from "effect/Path";
 import * as Result from "effect/Result";
-import * as Schema from "effect/Schema";
-import { HttpClient } from "effect/unstable/http";
-import * as ChildProcess from "effect/unstable/process/ChildProcess";
-import * as ChildProcessSpawner from "effect/unstable/process/ChildProcessSpawner";
-import {
-  createModelCapabilities,
-  getProviderOptionBooleanSelectionValue,
-  getProviderOptionStringSelectionValue,
-} from "@t3tools/shared/model";
-import { resolveSpawnCommand } from "@t3tools/shared/shell";
 
+import { cursorSdkParameterPriority, cursorSdkProviderOptionId } from "../cursorSdkModel.ts";
 import {
   buildBooleanOptionDescriptor,
   buildSelectOptionDescriptor,
   buildServerProvider,
-  collectStreamAsString,
-  isCommandMissingCause,
   providerModelsFromSettings,
-  type CommandResult,
   type ServerProviderDraft,
 } from "../providerSnapshot.ts";
-import {
-  enrichProviderSnapshotWithVersionAdvisory,
-  type ProviderMaintenanceCapabilities,
-} from "../providerMaintenance.ts";
-import * as AcpSessionRuntime from "../acp/AcpSessionRuntime.ts";
-import { CursorListAvailableModelsResponse } from "../acp/CursorAcpExtension.ts";
+import { CursorSdkCatalog } from "./CursorSdkCatalog.ts";
 
-const decodeCursorListAvailableModelsResponse = Schema.decodeUnknownEffect(
-  CursorListAvailableModelsResponse,
-);
 const CURSOR_PRESENTATION = {
   displayName: "Cursor",
-  badgeLabel: "Early Access",
   showInteractionModeToggle: true,
 } as const;
 const EMPTY_CAPABILITIES: ModelCapabilities = createModelCapabilities({
   optionDescriptors: [],
 });
 
-const CURSOR_ACP_MODEL_DISCOVERY_TIMEOUT_MS = 15_000;
-const CURSOR_PARAMETERIZED_MODEL_PICKER_MIN_VERSION_DATE = 2026_04_08;
-const CURSOR_CLI_INSTALLATION_DOCS_URL = "https://cursor.com/docs/cli/installation";
-const CURSOR_ACP_MODEL_DISCOVERY_FAILED_MESSAGE = [
-  "Cursor ACP model discovery failed.",
-  "Cursor CLI setup may be incomplete; install or enable the Cursor CLI, restart T3 Code, and try again.",
-  `See ${CURSOR_CLI_INSTALLATION_DOCS_URL}.`,
-  "Check server logs for ACP details.",
-].join(" ");
-export const CURSOR_PARAMETERIZED_MODEL_PICKER_CAPABILITIES = {
-  _meta: {
-    parameterizedModelPicker: true,
-  },
-} satisfies NonNullable<EffectAcpSchema.InitializeRequest["clientCapabilities"]>;
+const CURSOR_SDK_CATALOG_TIMEOUT_MS = 15_000;
 
 export function buildInitialCursorProviderSnapshot(
   cursorSettings: CursorSettings,
@@ -107,496 +66,135 @@ export function buildInitialCursorProviderSnapshot(
         version: null,
         status: "warning",
         auth: { status: "unknown" },
-        message: "Checking Cursor Agent availability...",
+        message: "Checking Cursor SDK availability...",
       },
     });
   });
 }
 
-interface CursorSessionSelectOption {
-  readonly value: string;
-  readonly name: string;
-}
-
-interface CursorAcpDiscoveredModel {
-  readonly slug: string;
-  readonly name: string;
-  readonly capabilities: ModelCapabilities;
-}
-
-function flattenSessionConfigSelectOptions(
-  configOption: EffectAcpSchema.SessionConfigOption | undefined,
-): ReadonlyArray<CursorSessionSelectOption> {
-  if (!configOption || configOption.type !== "select") {
-    return [];
-  }
-  return configOption.options.flatMap((entry) =>
-    "value" in entry
-      ? [
-          {
-            value: entry.value.trim(),
-            name: entry.name.trim(),
-          } satisfies CursorSessionSelectOption,
-        ]
-      : entry.options.map(
-          (option) =>
-            ({
-              value: option.value.trim(),
-              name: option.name.trim(),
-            }) satisfies CursorSessionSelectOption,
-        ),
-  );
-}
-
-function normalizeCursorReasoningValue(value: string | null | undefined): string | undefined {
-  const normalized = value?.trim().toLowerCase();
-  switch (normalized) {
-    case "low":
-    case "medium":
-    case "high":
-    case "max":
-      return normalized;
-    case "xhigh":
-    case "extra-high":
-    case "extra high":
-      return "xhigh";
-    default:
-      return undefined;
-  }
-}
-
-function getCursorConfigOptionCategory(option: EffectAcpSchema.SessionConfigOption): string {
-  return option.category?.trim().toLowerCase() ?? "";
-}
-
-function isCursorEffortConfigOption(option: EffectAcpSchema.SessionConfigOption): boolean {
-  const id = option.id.trim().toLowerCase();
-  const name = option.name.trim().toLowerCase();
-  return (
-    id === "effort" ||
-    id === "reasoning" ||
-    name === "effort" ||
-    name === "reasoning" ||
-    name.includes("effort") ||
-    name.includes("reasoning")
-  );
-}
-
-function findCursorEffortConfigOption(
-  configOptions: ReadonlyArray<EffectAcpSchema.SessionConfigOption>,
-): EffectAcpSchema.SessionConfigOption | undefined {
-  const candidates = configOptions.filter(
-    (option) => option.type === "select" && isCursorEffortConfigOption(option),
-  );
-  return (
-    candidates.find((option) => getCursorConfigOptionCategory(option) === "model_option") ??
-    candidates.find((option) => option.id.trim().toLowerCase() === "effort") ??
-    candidates.find((option) => getCursorConfigOptionCategory(option) === "thought_level") ??
-    candidates[0]
-  );
-}
-
-function isCursorContextConfigOption(option: EffectAcpSchema.SessionConfigOption): boolean {
-  const id = option.id.trim().toLowerCase();
-  const name = option.name.trim().toLowerCase();
-  return id === "context" || id === "context_size" || name.includes("context");
-}
-
-function isCursorFastConfigOption(option: EffectAcpSchema.SessionConfigOption): boolean {
-  const id = option.id.trim().toLowerCase();
-  const name = option.name.trim().toLowerCase();
-  return id === "fast" || name === "fast" || name.includes("fast mode");
-}
-
-function isCursorThinkingConfigOption(option: EffectAcpSchema.SessionConfigOption): boolean {
-  const id = option.id.trim().toLowerCase();
-  const name = option.name.trim().toLowerCase();
-  return id === "thinking" || name.includes("thinking");
-}
-
-function isBooleanLikeConfigOption(option: EffectAcpSchema.SessionConfigOption): boolean {
-  if (option.type === "boolean") {
-    return true;
-  }
-  if (option.type !== "select") {
-    return false;
-  }
-  const values = new Set(
-    flattenSessionConfigSelectOptions(option).map((entry) => entry.value.trim().toLowerCase()),
-  );
-  return values.has("true") && values.has("false");
+export function getCursorFallbackModels(
+  cursorSettings: Pick<CursorSettings, "customModels">,
+): ReadonlyArray<ServerProviderModel> {
+  return providerModelsFromSettings([], cursorSettings.customModels, EMPTY_CAPABILITIES);
 }
 
-function getBooleanCurrentValue(
-  option: EffectAcpSchema.SessionConfigOption | undefined,
-): boolean | undefined {
-  if (!option) {
-    return undefined;
-  }
-  if (option.type === "boolean") {
-    return option.currentValue;
-  }
-  if (option.type !== "select") {
-    return undefined;
-  }
-  const normalized = option.currentValue?.trim().toLowerCase();
-  if (normalized === "true") {
-    return true;
-  }
-  if (normalized === "false") {
-    return false;
+function toTitleCaseWords(value: string): string {
+  const parts: Array<string> = [];
+  for (const part of value.split(/[\s_-]+/g)) {
+    if (part.length > 0) {
+      parts.push(part.charAt(0).toUpperCase() + part.slice(1).toLowerCase());
+    }
   }
-  return undefined;
+  return parts.join(" ");
 }
 
-export function buildCursorCapabilitiesFromConfigOptions(
-  configOptions: ReadonlyArray<EffectAcpSchema.SessionConfigOption> | null | undefined,
-): ModelCapabilities {
-  if (!configOptions || configOptions.length === 0) {
-    return EMPTY_CAPABILITIES;
-  }
-
-  const reasoningConfig = findCursorEffortConfigOption(configOptions);
-  const reasoningEffortLevels =
-    reasoningConfig?.type === "select"
-      ? flattenSessionConfigSelectOptions(reasoningConfig).flatMap((entry) => {
-          const normalizedValue = normalizeCursorReasoningValue(entry.value);
-          if (!normalizedValue) {
-            return [];
-          }
-          return [
-            {
-              value: normalizedValue,
-              label: entry.name,
-              ...(normalizeCursorReasoningValue(reasoningConfig.currentValue) === normalizedValue
-                ? { isDefault: true }
-                : {}),
-            },
-          ];
-        })
-      : [];
-
-  const contextOption = configOptions.find(
-    (option) => option.category === "model_config" && isCursorContextConfigOption(option),
-  );
-  const contextWindowOptions =
-    contextOption?.type === "select"
-      ? flattenSessionConfigSelectOptions(contextOption).map((entry) => {
-          if (contextOption.currentValue === entry.value) {
-            return {
-              value: entry.value,
-              label: entry.name,
-              isDefault: true,
-            };
-          }
-          return {
-            value: entry.value,
-            label: entry.name,
-          };
-        })
-      : [];
-
-  const fastOption = configOptions.find(
-    (option) => option.category === "model_config" && isCursorFastConfigOption(option),
-  );
-  const thinkingOption = configOptions.find(
-    (option) => option.category === "model_config" && isCursorThinkingConfigOption(option),
-  );
-  const fastCurrentValue = getBooleanCurrentValue(fastOption);
-  const thinkingCurrentValue = getBooleanCurrentValue(thinkingOption);
-  const optionDescriptors = [
-    ...(reasoningEffortLevels.length > 0
-      ? [
-          buildSelectOptionDescriptor({
-            id: "reasoning",
-            label: reasoningConfig?.name?.trim() || "Reasoning",
-            options: reasoningEffortLevels,
-          }),
-        ]
-      : []),
-    ...(contextWindowOptions.length > 0
-      ? [
-          buildSelectOptionDescriptor({
-            id: "contextWindow",
-            label: contextOption?.name?.trim() || "Context Window",
-            options: contextWindowOptions,
-          }),
-        ]
-      : []),
-    ...(fastOption && isBooleanLikeConfigOption(fastOption)
-      ? [
-          typeof fastCurrentValue === "boolean"
-            ? buildBooleanOptionDescriptor({
-                id: "fastMode",
-                label: fastOption.name?.trim() || "Fast Mode",
-                currentValue: fastCurrentValue,
-              })
-            : buildBooleanOptionDescriptor({
-                id: "fastMode",
-                label: fastOption.name?.trim() || "Fast Mode",
-              }),
-        ]
-      : []),
-    ...(thinkingOption && isBooleanLikeConfigOption(thinkingOption)
-      ? [
-          typeof thinkingCurrentValue === "boolean"
-            ? buildBooleanOptionDescriptor({
-                id: "thinking",
-                label: thinkingOption.name?.trim() || "Thinking",
-                currentValue: thinkingCurrentValue,
-              })
-            : buildBooleanOptionDescriptor({
-                id: "thinking",
-                label: thinkingOption.name?.trim() || "Thinking",
-              }),
-        ]
-      : []),
-  ];
-
-  return createModelCapabilities({
-    optionDescriptors,
-  });
+function cursorSdkDefaultParameterValue(model: SDKModel, parameterId: string): string | undefined {
+  return model.variants
+    ?.find((variant) => variant.isDefault)
+    ?.params.find((parameter) => parameter.id === parameterId)?.value;
 }
 
-function buildCursorDiscoveredModels(
-  discoveredModels: ReadonlyArray<CursorAcpDiscoveredModel>,
-): ReadonlyArray<ServerProviderModel> {
+export function buildCursorCapabilitiesFromSdkModel(model: SDKModel): ModelCapabilities {
   const seen = new Set<string>();
-  return discoveredModels.flatMap((model) => {
-    if (!model.slug || seen.has(model.slug)) {
-      return [];
+  const optionDescriptors: Array<ProviderOptionDescriptor> = [];
+  const parameters = (model.parameters ?? [])
+    .map((parameter, index) => ({ parameter, index }))
+    .toSorted(
+      (left, right) =>
+        cursorSdkParameterPriority(left.parameter.id) -
+          cursorSdkParameterPriority(right.parameter.id) || left.index - right.index,
+    );
+  for (const { parameter } of parameters) {
+    const nativeId = parameter.id.trim();
+    const id = cursorSdkProviderOptionId(nativeId);
+    if (!nativeId || !id || seen.has(id)) {
+      continue;
     }
-    seen.add(model.slug);
-    return [
-      {
-        slug: model.slug,
-        name: model.name,
-        isCustom: false,
-        capabilities: model.capabilities,
-      } satisfies ServerProviderModel,
-    ];
-  });
-}
+    seen.add(id);
 
-function buildCursorDiscoveredModelsFromAvailableModelsResponse(
-  response: typeof CursorListAvailableModelsResponse.Type,
-): ReadonlyArray<ServerProviderModel> {
-  return buildCursorDiscoveredModels(
-    response.models.flatMap((model) => {
-      const slug = model.value.trim();
-      const name = model.name.trim();
-      if (!slug || !name) {
+    const values = parameter.values.flatMap((entry) => {
+      const value = entry.value.trim();
+      if (!value) {
         return [];
       }
-
       return [
         {
-          slug,
-          name,
-          capabilities: buildCursorCapabilitiesFromConfigOptions(model.configOptions),
+          value,
+          label: entry.displayName?.trim() || value,
         },
       ];
-    }),
-  );
-}
-
-const makeCursorAcpProbeRuntime = (
-  cursorSettings: CursorSettings,
-  environment?: NodeJS.ProcessEnv,
-) =>
-  Effect.gen(function* () {
-    const spawner = yield* ChildProcessSpawner.ChildProcessSpawner;
-    const acpContext = yield* Layer.build(
-      AcpSessionRuntime.layer({
-        spawn: {
-          command: cursorSettings.binaryPath,
-          args: [
-            ...(cursorSettings.apiEndpoint ? (["-e", cursorSettings.apiEndpoint] as const) : []),
-            "acp",
-          ],
-          cwd: process.cwd(),
-          ...(environment ? { env: environment } : {}),
-        },
-        cwd: process.cwd(),
-        clientInfo: { name: "t3-code-provider-probe", version: "0.0.0" },
-        authMethodId: "cursor_login",
-        clientCapabilities: CURSOR_PARAMETERIZED_MODEL_PICKER_CAPABILITIES,
-      }).pipe(Layer.provide(Layer.succeed(ChildProcessSpawner.ChildProcessSpawner, spawner))),
-    );
-    return yield* Effect.service(AcpSessionRuntime.AcpSessionRuntime).pipe(
-      Effect.provide(acpContext),
-    );
-  });
-
-const withCursorAcpProbeRuntime = <A, E, R>(
-  cursorSettings: CursorSettings,
-  useRuntime: (acp: AcpSessionRuntime.AcpSessionRuntime["Service"]) => Effect.Effect<A, E, R>,
-  environment?: NodeJS.ProcessEnv,
-) =>
-  makeCursorAcpProbeRuntime(cursorSettings, environment).pipe(
-    Effect.flatMap(useRuntime),
-    Effect.scoped,
-  );
-
-function normalizeCursorConfigOptionToken(value: string | null | undefined): string {
-  return (
-    value
-      ?.trim()
-      .toLowerCase()
-      .replace(/[\s_-]+/g, "-") ?? ""
-  );
-}
-
-function findCursorSelectOptionValue(
-  configOption: EffectAcpSchema.SessionConfigOption | undefined,
-  matcher: (option: CursorSessionSelectOption) => boolean,
-): string | undefined {
-  return flattenSessionConfigSelectOptions(configOption).find(matcher)?.value;
-}
-
-function findCursorBooleanConfigValue(
-  configOption: EffectAcpSchema.SessionConfigOption | undefined,
-  requested: boolean,
-): string | boolean | undefined {
-  if (!configOption) {
-    return undefined;
-  }
-  if (configOption.type === "boolean") {
-    return requested;
-  }
-  return findCursorSelectOptionValue(
-    configOption,
-    (option) => normalizeCursorConfigOptionToken(option.value) === String(requested),
-  );
-}
-
-export function resolveCursorAcpBaseModelId(model: string | null | undefined): string {
-  const trimmed = model?.trim();
-  const base = trimmed && trimmed.length > 0 ? trimmed : "default";
-  return base.includes("[") ? base.slice(0, base.indexOf("[")) : base;
-}
-
-export function resolveCursorAcpConfigUpdates(
-  configOptions: ReadonlyArray<EffectAcpSchema.SessionConfigOption> | null | undefined,
-  selections: ReadonlyArray<ProviderOptionSelection> | null | undefined,
-): ReadonlyArray<{
-  readonly configId: string;
-  readonly value: string | boolean;
-}> {
-  if (!configOptions || configOptions.length === 0) {
-    return [];
-  }
-
-  const updates: Array<{
-    readonly configId: string;
-    readonly value: string | boolean;
-  }> = [];
-
-  const reasoningOption = findCursorEffortConfigOption(configOptions);
-  const requestedReasoning = normalizeCursorReasoningValue(
-    getProviderOptionStringSelectionValue(selections, "reasoning"),
-  );
-  if (reasoningOption && requestedReasoning) {
-    const value = findCursorSelectOptionValue(reasoningOption, (option) => {
-      const normalizedValue = normalizeCursorReasoningValue(option.value);
-      const normalizedName = normalizeCursorReasoningValue(option.name);
-      return normalizedValue === requestedReasoning || normalizedName === requestedReasoning;
     });
-    if (value) {
-      updates.push({ configId: reasoningOption.id, value });
+    if (values.length === 0) {
+      continue;
     }
-  }
 
-  const contextOption = configOptions.find(
-    (option) => option.category === "model_config" && isCursorContextConfigOption(option),
-  );
-  const requestedContextWindow = getProviderOptionStringSelectionValue(selections, "contextWindow");
-  if (contextOption && requestedContextWindow) {
-    const value = findCursorSelectOptionValue(
-      contextOption,
-      (option) =>
-        normalizeCursorConfigOptionToken(option.value) ===
-          normalizeCursorConfigOptionToken(requestedContextWindow) ||
-        normalizeCursorConfigOptionToken(option.name) ===
-          normalizeCursorConfigOptionToken(requestedContextWindow),
-    );
-    if (value) {
-      updates.push({ configId: contextOption.id, value });
-    }
-  }
-
-  const fastOption = configOptions.find(
-    (option) => option.category === "model_config" && isCursorFastConfigOption(option),
-  );
-  const requestedFastMode = getProviderOptionBooleanSelectionValue(selections, "fastMode");
-  if (fastOption && typeof requestedFastMode === "boolean") {
-    const value = findCursorBooleanConfigValue(fastOption, requestedFastMode);
-    if (value !== undefined) {
-      updates.push({ configId: fastOption.id, value });
+    const label = parameter.displayName?.trim() || toTitleCaseWords(id);
+    const defaultValue = cursorSdkDefaultParameterValue(model, nativeId);
+    const normalizedValues = new Set(values.map((entry) => entry.value.toLowerCase()));
+    if (values.length === 2 && normalizedValues.has("true") && normalizedValues.has("false")) {
+      if (defaultValue === "true" || defaultValue === "false") {
+        optionDescriptors.push(
+          buildBooleanOptionDescriptor({
+            id,
+            label,
+            currentValue: defaultValue === "true",
+          }),
+        );
+      } else {
+        optionDescriptors.push(buildBooleanOptionDescriptor({ id, label }));
+      }
+      continue;
     }
-  }
 
-  const thinkingOption = configOptions.find(
-    (option) => option.category === "model_config" && isCursorThinkingConfigOption(option),
-  );
-  const requestedThinking = getProviderOptionBooleanSelectionValue(selections, "thinking");
-  if (thinkingOption && typeof requestedThinking === "boolean") {
-    const value = findCursorBooleanConfigValue(thinkingOption, requestedThinking);
-    if (value !== undefined) {
-      updates.push({ configId: thinkingOption.id, value });
-    }
+    optionDescriptors.push(
+      buildSelectOptionDescriptor({
+        id,
+        label,
+        options: values.map((entry) => ({
+          ...entry,
+          ...(entry.value === defaultValue ? { isDefault: true } : {}),
+        })),
+      }),
+    );
   }
 
-  return updates;
+  return createModelCapabilities({ optionDescriptors });
 }
 
-const discoverCursorModelsViaListAvailableModels = (
-  cursorSettings: CursorSettings,
-  environment?: NodeJS.ProcessEnv,
-) =>
-  withCursorAcpProbeRuntime(
-    cursorSettings,
-    (acp) =>
-      Effect.gen(function* () {
-        yield* acp.start();
-        const response = yield* acp.request("cursor/list_available_models", {});
-        const decoded = yield* decodeCursorListAvailableModelsResponse(response);
-        return buildCursorDiscoveredModelsFromAvailableModelsResponse(decoded);
-      }),
-    environment,
-  );
-
-export const discoverCursorModelsViaAcp = (
-  cursorSettings: CursorSettings,
-  environment?: NodeJS.ProcessEnv,
-) => discoverCursorModelsViaListAvailableModels(cursorSettings, environment);
-
-export function getCursorFallbackModels(
-  cursorSettings: Pick<CursorSettings, "customModels">,
+export function buildCursorDiscoveredModelsFromSdk(
+  models: ReadonlyArray<SDKModel>,
 ): ReadonlyArray<ServerProviderModel> {
-  return providerModelsFromSettings([], cursorSettings.customModels, EMPTY_CAPABILITIES);
-}
-
-/** Timeout for `agent about` — it's slower than a simple `--version` probe. */
-const ABOUT_TIMEOUT_MS = 8_000;
-
-/** Strip ANSI escape sequences so we can parse plain key-value lines. */
-function stripAnsi(text: string): string {
-  // eslint-disable-next-line no-control-regex
-  return text.replace(/\x1b\[[0-9;]*[A-Za-z]|\x1b\].*?\x07/g, "");
+  const seen = new Set<string>();
+  return models.flatMap((model) => {
+    const slug = model.id.trim();
+    const name = model.displayName.trim();
+    if (!slug || !name || seen.has(slug)) {
+      return [];
+    }
+    seen.add(slug);
+    return [
+      {
+        slug,
+        name,
+        isCustom: false,
+        capabilities: buildCursorCapabilitiesFromSdkModel(model),
+      } satisfies ServerProviderModel,
+    ];
+  });
 }
 
-/**
- * Extract a value from `agent about` key-value output.
- * Lines look like: `CLI Version         2026.03.20-44cb435`
- */
-function extractAboutField(plain: string, key: string): string | undefined {
-  const regex = new RegExp(`^${key}\\s{2,}(.+)$`, "mi");
-  const match = regex.exec(plain);
-  return match?.[1]?.trim();
+function cursorSdkAuth(user: SDKUser): ServerProviderAuth {
+  const email = user.userEmail?.trim();
+  const apiKeyName = user.apiKeyName.trim();
+  return {
+    status: "authenticated",
+    type: "api-key",
+    label: apiKeyName ? `Cursor API key (${apiKeyName})` : "Cursor API key",
+    ...(email ? { email } : {}),
+  };
 }
 
-export interface CursorAboutResult {
+interface CursorProviderProbeResult {
   readonly version: string | null;
   readonly status: Exclude<ServerProviderState, "disabled">;
   readonly auth: ServerProviderAuth;
@@ -614,18 +212,10 @@ function joinProviderMessages(...messages: ReadonlyArray<string | undefined>): s
   return parts.length > 0 ? parts.join(" ") : undefined;
 }
 
-function buildCursorCliCommandMissingMessage(binaryPath: string): string {
-  return [
-    `Cursor CLI command \`${binaryPath}\` was not found.`,
-    `Install or enable the Cursor CLI, make sure \`${binaryPath}\` is on PATH, then restart T3 Code.`,
-    `See ${CURSOR_CLI_INSTALLATION_DOCS_URL}.`,
-  ].join(" ");
-}
-
 export function buildCursorProviderSnapshot(input: {
   readonly checkedAt: string;
   readonly cursorSettings: CursorSettings;
-  readonly parsed: CursorAboutResult;
+  readonly parsed: CursorProviderProbeResult;
   readonly discoveredModels?: ReadonlyArray<ServerProviderModel>;
   readonly discoveryWarning?: string;
 }): ServerProviderDraft {
@@ -650,348 +240,10 @@ export function buildCursorProviderSnapshot(input: {
   });
 }
 
-interface CursorAboutJsonPayload {
-  readonly cliVersion?: unknown;
-  readonly subscriptionTier?: unknown;
-  readonly userEmail?: unknown;
-}
-
-export function parseCursorVersionDate(version: string | null | undefined): number | undefined {
-  const match = version?.trim().match(/^(\d{4})\.(\d{2})\.(\d{2})(?:\b|-|$)/);
-  if (!match) {
-    return undefined;
-  }
-  const [, year, month, day] = match;
-  return Number(`${year}${month}${day}`);
-}
-
-export function parseCursorCliConfigChannel(raw: string): string | undefined {
-  try {
-    const parsed = JSON.parse(raw) as unknown;
-    if (
-      typeof parsed === "object" &&
-      parsed !== null &&
-      "channel" in parsed &&
-      typeof parsed.channel === "string"
-    ) {
-      const channel = parsed.channel.trim().toLowerCase();
-      return channel.length > 0 ? channel : undefined;
-    }
-  } catch {
-    return undefined;
-  }
-  return undefined;
-}
-
-function toTitleCaseWords(value: string): string {
-  const parts: Array<string> = [];
-  for (const part of value.split(/[\s_-]+/g)) {
-    if (part.length > 0) {
-      parts.push(part.charAt(0).toUpperCase() + part.slice(1).toLowerCase());
-    }
-  }
-  return parts.join(" ");
-}
-
-function cursorSubscriptionLabel(subscriptionType: string | undefined): string | undefined {
-  const normalized = subscriptionType?.toLowerCase().replace(/[\s_-]+/g, "");
-  if (!normalized) return undefined;
-
-  switch (normalized) {
-    case "team":
-      return "Team";
-    case "pro":
-      return "Pro";
-    case "free":
-      return "Free";
-    case "business":
-      return "Business";
-    case "enterprise":
-      return "Enterprise";
-    default:
-      return toTitleCaseWords(subscriptionType!);
-  }
-}
-
-function cursorAuthMetadata(
-  subscriptionType: string | undefined,
-): Pick<ServerProviderAuth, "label" | "type"> | undefined {
-  if (!subscriptionType) {
-    return undefined;
-  }
-  const subscriptionLabel = cursorSubscriptionLabel(subscriptionType);
-  return {
-    type: subscriptionType,
-    label: `Cursor ${subscriptionLabel ?? toTitleCaseWords(subscriptionType)} Subscription`,
-  };
-}
-
-function parseCursorAboutJsonPayload(raw: string): CursorAboutJsonPayload | undefined {
-  const trimmed = raw.trim();
-  if (!trimmed.startsWith("{")) {
-    return undefined;
-  }
-  try {
-    const parsed = JSON.parse(trimmed) as unknown;
-    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
-      return undefined;
-    }
-    return parsed as CursorAboutJsonPayload;
-  } catch {
-    return undefined;
-  }
-}
-
-function hasOwn(record: object, key: string): boolean {
-  return Object.prototype.hasOwnProperty.call(record, key);
-}
-
-function isCursorAboutJsonFormatUnsupported(result: CommandResult): boolean {
-  const lowerOutput = `${result.stdout}\n${result.stderr}`.toLowerCase();
-  return (
-    lowerOutput.includes("unknown option '--format'") ||
-    lowerOutput.includes("unexpected argument '--format'") ||
-    lowerOutput.includes("unrecognized option '--format'") ||
-    lowerOutput.includes("unknown argument '--format'")
-  );
-}
-
-const readCursorCliConfigChannel = Effect.fn("readCursorCliConfigChannel")(function* () {
-  const fileSystem = yield* FileSystem.FileSystem;
-  const path = yield* Path.Path;
-  const configPath = path.join(NodeOS.homedir(), ".cursor", "cli-config.json");
-  const raw = yield* fileSystem.readFileString(configPath).pipe(Effect.orElseSucceed(() => ""));
-  return parseCursorCliConfigChannel(raw);
-});
-
-export function getCursorParameterizedModelPickerUnsupportedMessage(input: {
-  readonly version: string | null | undefined;
-  readonly channel: string | null | undefined;
-}): string | undefined {
-  const reasons: Array<string> = [];
-  const versionDate = parseCursorVersionDate(input.version);
-  if (
-    versionDate !== undefined &&
-    versionDate < CURSOR_PARAMETERIZED_MODEL_PICKER_MIN_VERSION_DATE
-  ) {
-    reasons.push(
-      `Cursor Agent CLI version ${input.version} is too old for Cursor ACP parameterized model picker`,
-    );
-  }
-
-  const normalizedChannel = input.channel?.trim().toLowerCase();
-  if (
-    normalizedChannel !== undefined &&
-    normalizedChannel.length > 0 &&
-    normalizedChannel !== "lab"
-  ) {
-    reasons.push(
-      `Cursor Agent CLI channel is ${JSON.stringify(input.channel)}, but parameterized model picker is only available on the lab channel`,
-    );
-  }
-
-  if (reasons.length === 0) {
-    return undefined;
-  }
-
-  return `${reasons.join(". ")}. Run \`agent set-channel lab && agent update\` and use Cursor Agent CLI 2026.04.08 or newer.`;
-}
-
-/**
- * Parse the output of `agent about` to extract version and authentication
- * status in a single probe.
- *
- * Example output (logged in):
- * ```
- * About Cursor CLI
- *
- * CLI Version         2026.03.20-44cb435
- * User Email          user@example.com
- * ```
- *
- * Example output (logged out):
- * ```
- * About Cursor CLI
- *
- * CLI Version         2026.03.20-44cb435
- * User Email          Not logged in
- * ```
- */
-export function parseCursorAboutOutput(result: CommandResult): CursorAboutResult {
-  const jsonPayload = parseCursorAboutJsonPayload(result.stdout);
-  if (jsonPayload) {
-    const version =
-      typeof jsonPayload.cliVersion === "string" ? jsonPayload.cliVersion.trim() : null;
-    const hasUserEmailField = hasOwn(jsonPayload, "userEmail");
-    const userEmail =
-      typeof jsonPayload.userEmail === "string" ? jsonPayload.userEmail.trim() : undefined;
-    const subscriptionType =
-      typeof jsonPayload.subscriptionTier === "string"
-        ? jsonPayload.subscriptionTier.trim()
-        : undefined;
-    const authMetadata = cursorAuthMetadata(subscriptionType);
-
-    if (hasUserEmailField && jsonPayload.userEmail == null) {
-      return {
-        version,
-        status: "error",
-        auth: { status: "unauthenticated" },
-        message: "Cursor Agent is not authenticated. Run `agent login` and try again.",
-      };
-    }
-
-    if (!userEmail) {
-      if (result.code === 0) {
-        return {
-          version,
-          status: "ready",
-          auth: {
-            status: "unknown",
-            ...authMetadata,
-          },
-        };
-      }
-      return {
-        version,
-        status: "warning",
-        auth: { status: "unknown" },
-        message: "Could not verify Cursor Agent authentication status.",
-      };
-    }
-
-    const lowerEmail = userEmail.toLowerCase();
-    if (
-      lowerEmail === "not logged in" ||
-      lowerEmail.includes("login required") ||
-      lowerEmail.includes("authentication required")
-    ) {
-      return {
-        version,
-        status: "error",
-        auth: { status: "unauthenticated" },
-        message: "Cursor Agent is not authenticated. Run `agent login` and try again.",
-      };
-    }
-
-    return {
-      version,
-      status: "ready",
-      auth: {
-        status: "authenticated",
-        email: userEmail,
-        ...authMetadata,
-      },
-    };
-  }
-
-  const combined = `${result.stdout}\n${result.stderr}`;
-  const lowerOutput = combined.toLowerCase();
-
-  // If the command itself isn't recognised, we're on an old CLI version.
-  if (
-    lowerOutput.includes("unknown command") ||
-    lowerOutput.includes("unrecognized command") ||
-    lowerOutput.includes("unexpected argument")
-  ) {
-    return {
-      version: null,
-      status: "warning",
-      auth: { status: "unknown" },
-      message: "The `agent about` command is unavailable in this version of the Cursor Agent CLI.",
-    };
-  }
-
-  const plain = stripAnsi(combined);
-  const version = extractAboutField(plain, "CLI Version") ?? null;
-  const userEmail = extractAboutField(plain, "User Email");
-
-  // Determine auth from the User Email field.
-  if (userEmail === undefined) {
-    // Field missing entirely — can't determine auth.
-    if (result.code === 0) {
-      return { version, status: "ready", auth: { status: "unknown" } };
-    }
-    return {
-      version,
-      status: "warning",
-      auth: { status: "unknown" },
-      message: "Could not verify Cursor Agent authentication status.",
-    };
-  }
-
-  const lowerEmail = userEmail.toLowerCase();
-  if (
-    lowerEmail === "not logged in" ||
-    lowerEmail.includes("login required") ||
-    lowerEmail.includes("authentication required")
-  ) {
-    return {
-      version,
-      status: "error",
-      auth: { status: "unauthenticated" },
-      message: "Cursor Agent is not authenticated. Run `agent login` and try again.",
-    };
-  }
-
-  // Any non-empty email value means authenticated.
-  return {
-    version,
-    status: "ready",
-    auth: { status: "authenticated", email: userEmail },
-  };
-}
-
-const runCursorCommand = (
-  cursorSettings: CursorSettings,
-  args: ReadonlyArray<string>,
-  environment?: NodeJS.ProcessEnv,
-) =>
-  Effect.gen(function* () {
-    const spawner = yield* ChildProcessSpawner.ChildProcessSpawner;
-    const spawnCommand = yield* resolveSpawnCommand(
-      cursorSettings.binaryPath,
-      args,
-      environment ? { env: environment } : {},
-    );
-    const command = ChildProcess.make(spawnCommand.command, spawnCommand.args, {
-      ...(environment ? { env: environment } : { extendEnv: true }),
-      shell: spawnCommand.shell,
-    });
-
-    const child = yield* spawner.spawn(command);
-    const [stdout, stderr, exitCode] = yield* Effect.all(
-      [
-        collectStreamAsString(child.stdout),
-        collectStreamAsString(child.stderr),
-        child.exitCode.pipe(Effect.map(Number)),
-      ],
-      { concurrency: "unbounded" },
-    );
-
-    return { stdout, stderr, code: exitCode } satisfies CommandResult;
-  }).pipe(Effect.scoped);
-
-const runCursorAboutCommand = (cursorSettings: CursorSettings, environment?: NodeJS.ProcessEnv) =>
-  Effect.gen(function* () {
-    const jsonResult = yield* runCursorCommand(
-      cursorSettings,
-      ["about", "--format", "json"],
-      environment,
-    );
-    if (!isCursorAboutJsonFormatUnsupported(jsonResult)) {
-      return jsonResult;
-    }
-    return yield* runCursorCommand(cursorSettings, ["about"], environment);
-  });
-
 export const checkCursorProviderStatus = Effect.fn("checkCursorProviderStatus")(function* (
   cursorSettings: CursorSettings,
   environment?: NodeJS.ProcessEnv,
-): Effect.fn.Return<
-  ServerProviderDraft,
-  never,
-  ChildProcessSpawner.ChildProcessSpawner | Crypto.Crypto | FileSystem.FileSystem | Path.Path
-> {
+): Effect.fn.Return<ServerProviderDraft, never, CursorSdkCatalog> {
   const checkedAt = DateTime.formatIso(yield* DateTime.now);
   const fallbackModels = getCursorFallbackModels(cursorSettings);
 
@@ -1011,35 +263,33 @@ export const checkCursorProviderStatus = Effect.fn("checkCursorProviderStatus")(
     });
   }
 
-  // Single `agent about` probe: returns version + auth status in one call.
-  const aboutProbe = yield* runCursorAboutCommand(cursorSettings, environment).pipe(
-    Effect.timeoutOption(ABOUT_TIMEOUT_MS),
-    Effect.result,
-  );
-
-  if (Result.isFailure(aboutProbe)) {
-    const error = aboutProbe.failure;
-    yield* Effect.logWarning("Cursor Agent CLI health check failed.", {
-      errorTag: error._tag,
-    });
+  const sdkApiKey = environment?.CURSOR_API_KEY?.trim();
+  if (!sdkApiKey) {
     return buildServerProvider({
       presentation: CURSOR_PRESENTATION,
       enabled: cursorSettings.enabled,
       checkedAt,
       models: fallbackModels,
       probe: {
-        installed: !isCommandMissingCause(error),
+        installed: true,
         version: null,
         status: "error",
-        auth: { status: "unknown" },
-        message: isCommandMissingCause(error)
-          ? buildCursorCliCommandMissingMessage(cursorSettings.binaryPath)
-          : "Failed to execute Cursor Agent CLI health check.",
+        auth: { status: "unauthenticated" },
+        message: "Cursor API key is required. Add CURSOR_API_KEY in provider settings.",
       },
     });
   }
 
-  if (Option.isNone(aboutProbe.success)) {
+  const sdkCatalog = yield* CursorSdkCatalog;
+  const catalogResult = yield* sdkCatalog
+    .read(sdkApiKey)
+    .pipe(Effect.timeoutOption(CURSOR_SDK_CATALOG_TIMEOUT_MS), Effect.result);
+
+  if (Result.isFailure(catalogResult)) {
+    yield* Effect.logWarning("Cursor SDK catalog probe failed", {
+      cause: catalogResult.failure.cause,
+    });
+    const authenticationFailure = catalogResult.failure.authenticationFailure;
     return buildServerProvider({
       presentation: CURSOR_PRESENTATION,
       enabled: cursorSettings.enabled,
@@ -1049,20 +299,15 @@ export const checkCursorProviderStatus = Effect.fn("checkCursorProviderStatus")(
         installed: true,
         version: null,
         status: "error",
-        auth: { status: "unknown" },
-        message: "Cursor Agent CLI is installed but timed out while running `agent about`.",
+        auth: { status: authenticationFailure ? "unauthenticated" : "unknown" },
+        message: authenticationFailure
+          ? "Cursor SDK authentication failed. Check CURSOR_API_KEY."
+          : "Cursor SDK catalog request failed. Check server logs for details.",
       },
     });
   }
 
-  const parsed = parseCursorAboutOutput(aboutProbe.success.value);
-  const cursorCliConfigChannel = yield* readCursorCliConfigChannel();
-  const parameterizedModelPickerUnsupportedMessage =
-    getCursorParameterizedModelPickerUnsupportedMessage({
-      version: parsed.version,
-      channel: cursorCliConfigChannel,
-    });
-  if (parameterizedModelPickerUnsupportedMessage) {
+  if (Option.isNone(catalogResult.success)) {
     return buildServerProvider({
       presentation: CURSOR_PRESENTATION,
       enabled: cursorSettings.enabled,
@@ -1070,84 +315,27 @@ export const checkCursorProviderStatus = Effect.fn("checkCursorProviderStatus")(
       models: fallbackModels,
       probe: {
         installed: true,
-        version: parsed.version,
+        version: null,
         status: "error",
-        auth: parsed.auth,
-        message:
-          parsed.auth.status === "unauthenticated" && parsed.message
-            ? `${parameterizedModelPickerUnsupportedMessage} ${parsed.message}`
-            : parameterizedModelPickerUnsupportedMessage,
+        auth: { status: "unknown" },
+        message: `Cursor SDK catalog request timed out after ${CURSOR_SDK_CATALOG_TIMEOUT_MS}ms.`,
       },
     });
   }
-  let discoveredModels = Option.none<ReadonlyArray<ServerProviderModel>>();
-  let discoveryWarning: string | undefined;
-  if (parsed.auth.status !== "unauthenticated") {
-    const discoveryExit = yield* Effect.exit(
-      discoverCursorModelsViaAcp(cursorSettings, environment).pipe(
-        Effect.timeoutOption(CURSOR_ACP_MODEL_DISCOVERY_TIMEOUT_MS),
-      ),
-    );
-    if (Exit.isFailure(discoveryExit)) {
-      yield* Effect.logWarning("Cursor ACP model discovery failed", {
-        errorTag: causeErrorTag(discoveryExit.cause),
-      });
-      discoveryWarning = CURSOR_ACP_MODEL_DISCOVERY_FAILED_MESSAGE;
-    } else if (Option.isNone(discoveryExit.value)) {
-      discoveryWarning = `Cursor ACP model discovery timed out after ${CURSOR_ACP_MODEL_DISCOVERY_TIMEOUT_MS}ms.`;
-    } else if (discoveryExit.value.value.length === 0) {
-      discoveryWarning = "Cursor ACP model discovery returned no built-in models.";
-    } else {
-      discoveredModels = discoveryExit.value;
-    }
-  }
+
+  const snapshot = catalogResult.success.value;
+  const discoveredModels = buildCursorDiscoveredModelsFromSdk(snapshot.models);
   return buildCursorProviderSnapshot({
     checkedAt,
     cursorSettings,
-    parsed,
-    discoveredModels: Option.getOrElse(
-      Option.filter(discoveredModels, (models) => models.length > 0),
-      () => [] as const,
-    ),
-    ...(discoveryWarning ? { discoveryWarning } : {}),
+    parsed: {
+      version: null,
+      status: "ready",
+      auth: cursorSdkAuth(snapshot.user),
+    },
+    discoveredModels,
+    ...(discoveredModels.length === 0
+      ? { discoveryWarning: "Cursor SDK model discovery returned no built-in models." }
+      : {}),
   });
 });
-
-/**
- * Background maintenance enrichment for a Cursor snapshot.
- *
- * Used by `CursorDriver` as the `makeManagedServerProvider.enrichSnapshot`
- * hook: republishes update/version advisory metadata without performing any
- * model or capability discovery. Cursor model data comes exclusively from
- * `cursor/list_available_models` during provider status checks.
- */
-export const enrichCursorSnapshot = (input: {
-  readonly settings: CursorSettings;
-  readonly snapshot: ServerProvider;
-  readonly maintenanceCapabilities: ProviderMaintenanceCapabilities;
-  readonly enableProviderUpdateChecks?: boolean;
-  readonly publishSnapshot: (snapshot: ServerProvider) => Effect.Effect<void>;
-  readonly stampIdentity?: (snapshot: ServerProvider) => ServerProvider;
-  readonly httpClient: HttpClient.HttpClient;
-}): Effect.Effect<void> => {
-  const { settings, snapshot, publishSnapshot } = input;
-  const stampIdentity = input.stampIdentity ?? ((value) => value);
-
-  if (!settings.enabled || snapshot.auth.status === "unauthenticated") {
-    return Effect.void;
-  }
-
-  return enrichProviderSnapshotWithVersionAdvisory(snapshot, input.maintenanceCapabilities, {
-    enableProviderUpdateChecks: input.enableProviderUpdateChecks,
-  }).pipe(
-    Effect.provideService(HttpClient.HttpClient, input.httpClient),
-    Effect.flatMap((enrichedSnapshot) =>
-      publishSnapshot(stampIdentity(enrichedSnapshot)).pipe(Effect.as(enrichedSnapshot)),
-    ),
-    Effect.catchCause((cause) =>
-      Effect.logWarning("Cursor version advisory enrichment failed", {
-        errorTag: causeErrorTag(cause),
-      }).pipe(Effect.asVoid),
-    ),
-  );
-};
diff --git a/apps/server/src/provider/Layers/CursorSdkCatalog.ts b/apps/server/src/provider/Layers/CursorSdkCatalog.ts
new file mode 100644
index 000000000000..1b9a987e7737
--- /dev/null
+++ b/apps/server/src/provider/Layers/CursorSdkCatalog.ts
@@ -0,0 +1,73 @@
+import {
+  AuthenticationError,
+  Cursor,
+  CursorSdkError,
+  type SDKModel,
+  type SDKUser,
+} from "@cursor/sdk";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Schema from "effect/Schema";
+
+export interface CursorSdkCatalogSnapshot {
+  readonly user: SDKUser;
+  readonly models: ReadonlyArray<SDKModel>;
+}
+
+export class CursorSdkCatalogError extends Schema.TaggedErrorClass<CursorSdkCatalogError>()(
+  "CursorSdkCatalogError",
+  {
+    authenticationFailure: Schema.Boolean,
+    cause: Schema.Defect(),
+  },
+) {
+  override get message(): string {
+    return this.authenticationFailure
+      ? "Cursor SDK authentication failed."
+      : "Cursor SDK catalog request failed.";
+  }
+}
+
+export interface CursorSdkCatalogShape {
+  readonly read: (apiKey: string) => Effect.Effect<CursorSdkCatalogSnapshot, CursorSdkCatalogError>;
+}
+
+export class CursorSdkCatalog extends Context.Service<CursorSdkCatalog, CursorSdkCatalogShape>()(
+  "t3/provider/Layers/CursorSdkCatalog",
+) {}
+
+function isAuthenticationFailure(cause: unknown): boolean {
+  return (
+    cause instanceof AuthenticationError ||
+    (cause instanceof CursorSdkError && cause.status === 401)
+  );
+}
+
+const readCursorSdkCatalog = Effect.fn("CursorSdkCatalog.read")(function* (apiKey: string) {
+  return yield* Effect.tryPromise({
+    try: async () => {
+      const [user, models] = await Promise.all([
+        Cursor.me({ apiKey }),
+        Cursor.models.list({ apiKey }),
+      ]);
+      return { user, models } satisfies CursorSdkCatalogSnapshot;
+    },
+    catch: (cause) =>
+      new CursorSdkCatalogError({
+        authenticationFailure: isAuthenticationFailure(cause),
+        cause,
+      }),
+  });
+});
+
+export const CursorSdkCatalogLive = Layer.succeed(
+  CursorSdkCatalog,
+  CursorSdkCatalog.of({ read: readCursorSdkCatalog }),
+);
+
+export function makeCursorSdkCatalogTestLayer(
+  read: CursorSdkCatalogShape["read"],
+): Layer.Layer<CursorSdkCatalog> {
+  return Layer.succeed(CursorSdkCatalog, CursorSdkCatalog.of({ read }));
+}
diff --git a/apps/server/src/provider/Layers/GrokAdapter.test.ts b/apps/server/src/provider/Layers/GrokAdapter.test.ts
deleted file mode 100644
index eeee17d9ac6a..000000000000
--- a/apps/server/src/provider/Layers/GrokAdapter.test.ts
+++ /dev/null
@@ -1,2088 +0,0 @@
-// @effect-diagnostics nodeBuiltinImport:off
-import * as NodePath from "node:path";
-import * as NodeOS from "node:os";
-import * as NodeFSP from "node:fs/promises";
-import * as NodeURL from "node:url";
-
-import * as NodeServices from "@effect/platform-node/NodeServices";
-import { assert, it } from "@effect/vitest";
-import * as Deferred from "effect/Deferred";
-import * as Effect from "effect/Effect";
-import * as Fiber from "effect/Fiber";
-import * as Layer from "effect/Layer";
-import * as Ref from "effect/Ref";
-import * as Schema from "effect/Schema";
-import * as Stream from "effect/Stream";
-import * as TestClock from "effect/testing/TestClock";
-
-import {
-  ApprovalRequestId,
-  GrokSettings,
-  ProviderDriverKind,
-  ProviderInstanceId,
-  ThreadId,
-  TurnId,
-  type ProviderRuntimeEvent,
-} from "@t3tools/contracts";
-
-import { ServerConfig } from "../../config.ts";
-import {
-  grokPromptSettlementBelongsToContext,
-  isGrokEnterPlanModeToolCall,
-  makeGrokAdapter,
-  nextGrokPlanModeActive,
-  selectGrokPermissionOptionId,
-} from "./GrokAdapter.ts";
-const decodeGrokSettings = Schema.decodeSync(GrokSettings);
-
-const __dirname = NodePath.dirname(NodeURL.fileURLToPath(import.meta.url));
-const mockAgentPath = NodePath.join(__dirname, "../../../scripts/acp-mock-agent.ts");
-const mockAgentCommand = process.execPath;
-
-async function makeMockGrokWrapper(extraEnv?: Record<string, string>) {
-  const dir = await NodeFSP.mkdtemp(NodePath.join(NodeOS.tmpdir(), "grok-acp-mock-"));
-  const wrapperPath = NodePath.join(dir, "fake-grok.sh");
-  const envExports = Object.entries(extraEnv ?? {})
-    .map(([key, value]) => `export ${key}=${JSON.stringify(value)}`)
-    .join("\n");
-  const script = `#!/bin/sh
-${envExports}
-exec ${JSON.stringify(mockAgentCommand)} ${JSON.stringify(mockAgentPath)} "$@"
-`;
-  await NodeFSP.writeFile(wrapperPath, script, "utf8");
-  await NodeFSP.chmod(wrapperPath, 0o755);
-  return wrapperPath;
-}
-
-function waitForFileContent(
-  filePath: string,
-  attempts = 40,
-  expectedContent?: string,
-): Effect.Effect<string> {
-  const readAttempt = (remainingAttempts: number): Effect.Effect<string> =>
-    Effect.gen(function* () {
-      if (remainingAttempts <= 0) {
-        return yield* Effect.die(new Error(`Timed out waiting for file content at ${filePath}`));
-      }
-      const raw = yield* Effect.tryPromise(() => NodeFSP.readFile(filePath, "utf8")).pipe(
-        Effect.orElseSucceed(() => ""),
-      );
-      if (
-        raw.trim().length > 0 &&
-        (expectedContent === undefined || raw.includes(expectedContent))
-      ) {
-        return raw;
-      }
-      yield* Effect.sleep("25 millis");
-      return yield* readAttempt(remainingAttempts - 1);
-    });
-  return readAttempt(attempts);
-}
-
-async function readJsonLines(filePath: string) {
-  const raw = await NodeFSP.readFile(filePath, "utf8");
-  return raw
-    .split("\n")
-    .map((line) => line.trim())
-    .filter((line) => line.length > 0)
-    .map((line) => JSON.parse(line) as Record<string, unknown>);
-}
-
-const grokAdapterTestLayer = ServerConfig.layerTest(process.cwd(), {
-  prefix: "t3code-grok-adapter-test-",
-}).pipe(Layer.provideMerge(NodeServices.layer));
-
-const makeTestAdapter = (binaryPath: string, options?: Parameters<typeof makeGrokAdapter>[1]) =>
-  makeGrokAdapter(decodeGrokSettings({ binaryPath }), options).pipe(Effect.orDie);
-
-it("detects enter_plan_mode tool calls from title and rawInput", () => {
-  assert.isTrue(
-    isGrokEnterPlanModeToolCall({
-      title: "enter_plan_mode",
-      data: { toolCallId: "1" },
-    }),
-  );
-  assert.isTrue(
-    isGrokEnterPlanModeToolCall({
-      title: "Plan mode entered",
-      data: { toolCallId: "1", rawInput: { variant: "EnterPlanMode" } },
-    }),
-  );
-  assert.isFalse(
-    isGrokEnterPlanModeToolCall({
-      title: "write",
-      data: { toolCallId: "1", rawInput: { file_path: "/tmp/x", content: "y" } },
-    }),
-  );
-});
-
-it("only sets planModeActive after a successful enter_plan_mode", () => {
-  const enter = {
-    title: "enter_plan_mode",
-    data: { toolCallId: "1" },
-  };
-  assert.isFalse(nextGrokPlanModeActive(false, { ...enter, status: "pending" }));
-  assert.isTrue(nextGrokPlanModeActive(false, { ...enter, status: "inProgress" }));
-  assert.isTrue(nextGrokPlanModeActive(false, { ...enter, status: "completed" }));
-  assert.isFalse(nextGrokPlanModeActive(false, { ...enter, status: "failed" }));
-  assert.isFalse(nextGrokPlanModeActive(true, { ...enter, status: "failed" }));
-  assert.isTrue(
-    nextGrokPlanModeActive(true, {
-      title: "write",
-      status: "completed",
-      data: { toolCallId: "2" },
-    }),
-  );
-});
-
-function grokPermissionRequest(
-  options: ReadonlyArray<{
-    readonly optionId: string;
-    readonly kind: "allow_once" | "allow_always" | "reject_once" | "reject_always";
-  }>,
-) {
-  return {
-    sessionId: "mock-session-1",
-    toolCall: {
-      toolCallId: "tool-call-1",
-      title: "cat package.json",
-      kind: "execute" as const,
-      status: "pending" as const,
-    },
-    options: options.map((option) => ({
-      optionId: option.optionId,
-      name: option.kind,
-      kind: option.kind,
-    })),
-  };
-}
-
-it("maps Always allow to allow_once when Grok omits allow_always", () => {
-  const request = grokPermissionRequest([
-    { optionId: "allow-once", kind: "allow_once" },
-    { optionId: "reject-once", kind: "reject_once" },
-  ]);
-
-  assert.equal(selectGrokPermissionOptionId(request, "acceptForSession"), "allow-once");
-  assert.equal(selectGrokPermissionOptionId(request, "accept"), "allow-once");
-  assert.equal(selectGrokPermissionOptionId(request, "decline"), "reject-once");
-});
-
-it("prefers allow_always when Grok offers it", () => {
-  const request = grokPermissionRequest([
-    { optionId: "allow-once", kind: "allow_once" },
-    { optionId: "allow-always", kind: "allow_always" },
-    { optionId: "reject-once", kind: "reject_once" },
-  ]);
-
-  assert.equal(selectGrokPermissionOptionId(request, "acceptForSession"), "allow-always");
-  assert.equal(selectGrokPermissionOptionId(request, "accept"), "allow-once");
-});
-
-it("requires a settlement to match the live Grok turn", () => {
-  const staleTurnId = TurnId.make("stale-turn");
-  const replacementTurnId = TurnId.make("replacement-turn");
-
-  assert.isFalse(
-    grokPromptSettlementBelongsToContext({
-      liveAcpSessionId: "session-1",
-      expectedAcpSessionId: "session-1",
-      liveActiveTurnId: replacementTurnId,
-      liveSessionActiveTurnId: replacementTurnId,
-      turnId: staleTurnId,
-    }),
-  );
-  assert.isFalse(
-    grokPromptSettlementBelongsToContext({
-      liveAcpSessionId: "replacement-session",
-      expectedAcpSessionId: "stale-session",
-      liveActiveTurnId: staleTurnId,
-      liveSessionActiveTurnId: staleTurnId,
-      turnId: staleTurnId,
-    }),
-  );
-  assert.isTrue(
-    grokPromptSettlementBelongsToContext({
-      liveAcpSessionId: "session-1",
-      expectedAcpSessionId: "session-1",
-      liveActiveTurnId: staleTurnId,
-      liveSessionActiveTurnId: staleTurnId,
-      turnId: staleTurnId,
-    }),
-  );
-});
-
-it.layer(grokAdapterTestLayer)("GrokAdapterLive", (it) => {
-  it.effect("starts a session and maps mock ACP prompt flow to runtime events", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("grok-mock-thread");
-      const wrapperPath = yield* Effect.promise(() => makeMockGrokWrapper());
-      const adapter = yield* makeTestAdapter(wrapperPath);
-
-      const runtimeEvents: ProviderRuntimeEvent[] = [];
-      const turnCompleted = yield* Deferred.make<void>();
-      const runtimeEventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) =>
-        Effect.sync(() => {
-          runtimeEvents.push(event);
-        }).pipe(
-          Effect.andThen(
-            event.type === "turn.completed"
-              ? Deferred.succeed(turnCompleted, undefined)
-              : Effect.void,
-          ),
-        ),
-      ).pipe(Effect.forkChild);
-
-      const session = yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("grok"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-        modelSelection: { instanceId: ProviderInstanceId.make("grok"), model: "grok-mock-alt" },
-      });
-
-      assert.equal(session.provider, "grok");
-      assert.equal(session.model, "grok-mock-alt");
-      assert.deepStrictEqual(session.resumeCursor, {
-        schemaVersion: 1,
-        sessionId: "mock-session-1",
-      });
-
-      yield* adapter.sendTurn({
-        threadId,
-        input: "hello grok",
-        attachments: [],
-      });
-
-      yield* Deferred.await(turnCompleted);
-      yield* Fiber.interrupt(runtimeEventsFiber);
-      const types = runtimeEvents.map((e) => e.type);
-
-      assert.includeMembers(types, [
-        "session.started",
-        "session.state.changed",
-        "thread.started",
-        "turn.started",
-        "item.started",
-        "content.delta",
-        "turn.completed",
-      ] as const);
-
-      const delta = runtimeEvents.find((e) => e.type === "content.delta");
-      assert.isDefined(delta);
-      if (delta?.type === "content.delta") {
-        assert.equal(delta.payload.delta, "hello from mock");
-      }
-
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("closes the ACP child process when a session stops", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("grok-stop-session-close");
-      const tempDir = yield* Effect.promise(() =>
-        NodeFSP.mkdtemp(NodePath.join(NodeOS.tmpdir(), "grok-adapter-exit-log-")),
-      );
-      const exitLogPath = NodePath.join(tempDir, "exit.log");
-
-      const wrapperPath = yield* Effect.promise(() =>
-        makeMockGrokWrapper({
-          T3_ACP_EXIT_LOG_PATH: exitLogPath,
-        }),
-      );
-      const adapter = yield* makeTestAdapter(wrapperPath);
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("grok"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-        modelSelection: { instanceId: ProviderInstanceId.make("grok"), model: "grok-build" },
-      });
-
-      yield* adapter.stopSession(threadId);
-
-      const exitLog = yield* waitForFileContent(exitLogPath);
-      assert.include(exitLog, "SIGTERM");
-    }),
-  );
-
-  it.effect("reports a Grok session running only while the prompt is in flight", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("grok-session-ready-after-prompt");
-      const wrapperPath = yield* Effect.promise(() =>
-        makeMockGrokWrapper({
-          T3_ACP_EMIT_TOOL_CALLS: "1",
-        }),
-      );
-      const adapter = yield* makeTestAdapter(wrapperPath);
-      const requestOpened =
-        yield* Deferred.make<Extract<ProviderRuntimeEvent, { type: "request.opened" }>>();
-      const eventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) =>
-        event.type === "request.opened"
-          ? Deferred.succeed(requestOpened, event).pipe(Effect.ignore)
-          : Effect.void,
-      ).pipe(Effect.forkChild);
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("grok"),
-        cwd: process.cwd(),
-        runtimeMode: "approval-required",
-        modelSelection: { instanceId: ProviderInstanceId.make("grok"), model: "grok-build" },
-      });
-
-      const sendTurnFiber = yield* adapter
-        .sendTurn({ threadId, input: "check lifecycle", attachments: [] })
-        .pipe(Effect.forkChild);
-      const requestOpenedEvent = yield* Deferred.await(requestOpened);
-
-      const runningSessions = yield* adapter.listSessions();
-      const runningSession = runningSessions.find((session) => session.threadId === threadId);
-      assert.equal(runningSession?.status, "running");
-      assert.isDefined(runningSession?.activeTurnId);
-
-      yield* adapter.respondToRequest(
-        threadId,
-        ApprovalRequestId.make(String(requestOpenedEvent.requestId)),
-        "accept",
-      );
-      yield* Fiber.join(sendTurnFiber);
-
-      const readySessions = yield* adapter.listSessions();
-      const readySession = readySessions.find((session) => session.threadId === threadId);
-      assert.equal(readySession?.status, "ready");
-      assert.isUndefined(readySession?.activeTurnId);
-
-      yield* Fiber.interrupt(eventsFiber);
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("restores ready without completing an unstarted turn when preparation fails", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("grok-preparation-failure-while-connecting");
-      const wrapperPath = yield* Effect.promise(() => makeMockGrokWrapper());
-      const adapter = yield* makeTestAdapter(wrapperPath);
-
-      const runtimeEvents: ProviderRuntimeEvent[] = [];
-      const runtimeEventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) =>
-        Effect.sync(() => {
-          runtimeEvents.push(event);
-        }),
-      ).pipe(Effect.forkChild);
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("grok"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-        modelSelection: { instanceId: ProviderInstanceId.make("grok"), model: "grok-build" },
-      });
-
-      const error = yield* Effect.flip(
-        adapter.sendTurn({
-          threadId,
-          input: "prepare invalid attachment",
-          attachments: [
-            {
-              type: "image",
-              id: "missing-image",
-              name: "missing.png",
-              mimeType: "image/png",
-              sizeBytes: 1,
-            },
-          ],
-        }),
-      );
-      for (let yieldAttempt = 0; yieldAttempt < 4; yieldAttempt += 1) {
-        yield* Effect.yieldNow;
-      }
-
-      const turnCompletedEvent = runtimeEvents.find(
-        (event): event is Extract<ProviderRuntimeEvent, { type: "turn.completed" }> =>
-          event.type === "turn.completed",
-      );
-      const readySessions = yield* adapter.listSessions();
-      const readySession = readySessions.find((session) => session.threadId === threadId);
-
-      assert.equal(error._tag, "ProviderAdapterRequestError");
-      assert.isUndefined(turnCompletedEvent);
-      assert.equal(readySession?.status, "ready");
-      assert.isUndefined(readySession?.activeTurnId);
-
-      yield* Fiber.interrupt(runtimeEventsFiber);
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("completes a Grok turn from xAI prompt completion when the prompt RPC hangs", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("grok-xai-prompt-complete-fallback");
-      const wrapperPath = yield* Effect.promise(() =>
-        makeMockGrokWrapper({
-          T3_ACP_EMIT_XAI_PROMPT_COMPLETE_THEN_HANG: "1",
-          T3_ACP_EMIT_FOREIGN_SESSION_UPDATES: "1",
-        }),
-      );
-      const adapter = yield* makeTestAdapter(wrapperPath);
-
-      const runtimeEvents: ProviderRuntimeEvent[] = [];
-      const turnCompleted = yield* Deferred.make<void>();
-      const runtimeEventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) =>
-        Effect.sync(() => {
-          runtimeEvents.push(event);
-        }).pipe(
-          Effect.andThen(
-            event.type === "turn.completed"
-              ? Deferred.succeed(turnCompleted, undefined)
-              : Effect.void,
-          ),
-        ),
-      ).pipe(Effect.forkChild);
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("grok"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-        modelSelection: { instanceId: ProviderInstanceId.make("grok"), model: "grok-build" },
-      });
-
-      const sendTurnResult = yield* adapter.sendTurn({
-        threadId,
-        input: "exercise fallback",
-        attachments: [],
-      });
-
-      yield* Deferred.await(turnCompleted);
-      for (let yieldAttempt = 0; yieldAttempt < 8; yieldAttempt += 1) {
-        yield* Effect.yieldNow;
-      }
-      const readySessions = yield* adapter.listSessions();
-      const readySession = readySessions.find((session) => session.threadId === threadId);
-      const turnCompletedEvent = runtimeEvents.find(
-        (event): event is Extract<ProviderRuntimeEvent, { type: "turn.completed" }> =>
-          event.type === "turn.completed",
-      );
-      const eventTypes = runtimeEvents.map((event) => event.type);
-      const content = runtimeEvents
-        .filter(
-          (event): event is Extract<ProviderRuntimeEvent, { type: "content.delta" }> =>
-            event.type === "content.delta" && String(event.threadId) === String(threadId),
-        )
-        .map((event) => event.payload.delta)
-        .join("");
-      const terminalIndex = runtimeEvents.findIndex(
-        (event) => event.type === "turn.completed" && String(event.threadId) === String(threadId),
-      );
-      const turnOutputTypes = new Set([
-        "content.delta",
-        "item.started",
-        "item.updated",
-        "item.completed",
-        "turn.plan.updated",
-      ]);
-      const outputAfterTerminal = runtimeEvents
-        .slice(terminalIndex + 1)
-        .filter(
-          (event) => String(event.threadId) === String(threadId) && turnOutputTypes.has(event.type),
-        );
-      const toolTitles = runtimeEvents.flatMap((event) =>
-        event.type === "item.updated" && event.payload.title ? [event.payload.title] : [],
-      );
-
-      assert.equal(sendTurnResult.threadId, threadId);
-      assert.include(eventTypes, "turn.completed");
-      assert.equal(content, "hello from mock");
-      assert.isAtLeast(terminalIndex, 0);
-      assert.deepEqual(outputAfterTerminal, []);
-      assert.notInclude(toolTitles, "Child-only tool");
-      assert.equal(turnCompletedEvent?.payload.stopReason, "end_turn");
-      assert.equal(readySession?.status, "ready");
-      assert.isUndefined(readySession?.activeTurnId);
-
-      yield* Fiber.interrupt(runtimeEventsFiber);
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("does not time out a Grok turn before ACP emits progress", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("grok-watchdog-silent-turn");
-      const wrapperPath = yield* Effect.promise(() =>
-        makeMockGrokWrapper({
-          T3_ACP_HANG_PROMPT_FOREVER: "1",
-        }),
-      );
-      const adapter = yield* makeTestAdapter(wrapperPath, {
-        turnInactivityTimeoutMs: 1_000,
-      });
-      const runtimeEvents: ProviderRuntimeEvent[] = [];
-      const turnStarted = yield* Deferred.make<void>();
-      const turnCompleted =
-        yield* Deferred.make<Extract<ProviderRuntimeEvent, { type: "turn.completed" }>>();
-      const runtimeEventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) =>
-        Effect.gen(function* () {
-          if (String(event.threadId) !== String(threadId)) {
-            return;
-          }
-          runtimeEvents.push(event);
-          if (event.type === "turn.started") {
-            yield* Deferred.succeed(turnStarted, undefined).pipe(Effect.ignore);
-          }
-          if (event.type === "turn.completed") {
-            yield* Deferred.succeed(turnCompleted, event).pipe(Effect.ignore);
-          }
-        }),
-      ).pipe(Effect.forkChild);
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("grok"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-      });
-
-      const sendTurnFiber = yield* adapter
-        .sendTurn({ threadId, input: "silence forever", attachments: [] })
-        .pipe(Effect.forkChild);
-      yield* Deferred.await(turnStarted);
-
-      yield* TestClock.adjust("5 seconds");
-      yield* Effect.yieldNow;
-      const steerSendTurnFiber = yield* adapter
-        .sendTurn({ threadId, input: "keep reasoning", attachments: [] })
-        .pipe(Effect.forkChild);
-      for (let yieldAttempt = 0; yieldAttempt < 12; yieldAttempt += 1) {
-        yield* Effect.yieldNow;
-      }
-      yield* TestClock.adjust("5 seconds");
-      yield* Effect.yieldNow;
-      assert.lengthOf(
-        runtimeEvents.filter(
-          (event) => event.type === "turn.completed" && String(event.threadId) === String(threadId),
-        ),
-        0,
-      );
-
-      yield* adapter.interruptTurn(threadId);
-      const completed = yield* Deferred.await(turnCompleted).pipe(
-        Effect.timeout("2 seconds"),
-        TestClock.withLive,
-      );
-      yield* Fiber.join(sendTurnFiber);
-      yield* Fiber.interrupt(steerSendTurnFiber);
-
-      assert.equal(completed.payload.state, "cancelled");
-      const session = (yield* adapter.listSessions()).find(
-        (candidate) => candidate.threadId === threadId,
-      );
-      assert.equal(session?.status, "ready");
-      assert.isUndefined(session?.activeTurnId);
-
-      yield* Fiber.interrupt(runtimeEventsFiber);
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("fails a Grok turn that stalls after ACP content begins", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("grok-watchdog-content-stall");
-      const wrapperPath = yield* Effect.promise(() =>
-        makeMockGrokWrapper({
-          T3_ACP_EMIT_CONTENT_THEN_HANG: "1",
-        }),
-      );
-      const adapter = yield* makeTestAdapter(wrapperPath, {
-        turnInactivityTimeoutMs: 1_000,
-      });
-      const contentDelta = yield* Deferred.make<void>();
-      const turnCompleted =
-        yield* Deferred.make<Extract<ProviderRuntimeEvent, { type: "turn.completed" }>>();
-      const runtimeEvents: ProviderRuntimeEvent[] = [];
-      const runtimeEventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) =>
-        Effect.gen(function* () {
-          if (String(event.threadId) !== String(threadId)) {
-            return;
-          }
-          runtimeEvents.push(event);
-          if (event.type === "content.delta") {
-            yield* Deferred.succeed(contentDelta, undefined).pipe(Effect.ignore);
-          }
-          if (event.type === "turn.completed") {
-            yield* Deferred.succeed(turnCompleted, event).pipe(Effect.ignore);
-          }
-        }),
-      ).pipe(Effect.forkChild);
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("grok"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-      });
-      const sendTurnFiber = yield* adapter
-        .sendTurn({ threadId, input: "start then stall", attachments: [] })
-        .pipe(Effect.forkChild);
-      yield* Deferred.await(contentDelta).pipe(Effect.timeout("2 seconds"), TestClock.withLive);
-
-      yield* TestClock.adjust("999 millis");
-      yield* Effect.yieldNow;
-      assert.lengthOf(
-        runtimeEvents.filter(
-          (event) => event.type === "turn.completed" && String(event.threadId) === String(threadId),
-        ),
-        0,
-      );
-
-      yield* TestClock.adjust("1 millis");
-      for (let yieldAttempt = 0; yieldAttempt < 4; yieldAttempt += 1) {
-        yield* Effect.yieldNow;
-      }
-      const completed = yield* Deferred.await(turnCompleted).pipe(
-        Effect.timeout("2 seconds"),
-        TestClock.withLive,
-      );
-      yield* Fiber.join(sendTurnFiber);
-
-      assert.equal(completed.payload.state, "failed");
-      assert.equal(
-        runtimeEvents.filter(
-          (event) => event.type === "turn.completed" && String(event.threadId) === String(threadId),
-        ).length,
-        1,
-      );
-
-      yield* Fiber.interrupt(runtimeEventsFiber);
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("refreshes Grok liveness when a turn is steered", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("grok-watchdog-steer");
-      const wrapperPath = yield* Effect.promise(() =>
-        makeMockGrokWrapper({
-          T3_ACP_EMIT_CONTENT_THEN_HANG: "1",
-        }),
-      );
-      const adapter = yield* makeTestAdapter(wrapperPath, {
-        turnInactivityTimeoutMs: 1_000,
-      });
-      const contentDelta = yield* Deferred.make<void>();
-      const turnCompleted =
-        yield* Deferred.make<Extract<ProviderRuntimeEvent, { type: "turn.completed" }>>();
-      const runtimeEvents: ProviderRuntimeEvent[] = [];
-      const runtimeEventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) =>
-        Effect.gen(function* () {
-          if (String(event.threadId) !== String(threadId)) {
-            return;
-          }
-          runtimeEvents.push(event);
-          if (event.type === "content.delta") {
-            yield* Deferred.succeed(contentDelta, undefined).pipe(Effect.ignore);
-          }
-          if (event.type === "turn.completed") {
-            yield* Deferred.succeed(turnCompleted, event).pipe(Effect.ignore);
-          }
-        }),
-      ).pipe(Effect.forkChild);
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("grok"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-      });
-      const firstSendTurnFiber = yield* adapter
-        .sendTurn({ threadId, input: "start then steer", attachments: [] })
-        .pipe(Effect.forkChild);
-      yield* Deferred.await(contentDelta).pipe(Effect.timeout("2 seconds"), TestClock.withLive);
-
-      yield* TestClock.adjust("999 millis");
-      const steerSendTurnFiber = yield* adapter
-        .sendTurn({ threadId, input: "continue working", attachments: [] })
-        .pipe(Effect.forkChild);
-      for (let yieldAttempt = 0; yieldAttempt < 12; yieldAttempt += 1) {
-        yield* Effect.yieldNow;
-      }
-
-      yield* TestClock.adjust("1 millis");
-      for (let yieldAttempt = 0; yieldAttempt < 4; yieldAttempt += 1) {
-        yield* Effect.yieldNow;
-      }
-      assert.lengthOf(
-        runtimeEvents.filter(
-          (event) => event.type === "turn.completed" && String(event.threadId) === String(threadId),
-        ),
-        0,
-      );
-
-      yield* Fiber.interrupt(steerSendTurnFiber);
-      yield* adapter.interruptTurn(threadId);
-      const completed = yield* Deferred.await(turnCompleted).pipe(
-        Effect.timeout("2 seconds"),
-        TestClock.withLive,
-      );
-      yield* Fiber.join(firstSendTurnFiber);
-      assert.equal(completed.payload.state, "cancelled");
-
-      yield* Fiber.interrupt(runtimeEventsFiber);
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("refreshes Grok liveness when ACP updates its plan", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("grok-watchdog-plan-stall");
-      const wrapperPath = yield* Effect.promise(() =>
-        makeMockGrokWrapper({
-          T3_ACP_EMIT_PLAN_THEN_HANG: "1",
-        }),
-      );
-      const adapter = yield* makeTestAdapter(wrapperPath, {
-        turnInactivityTimeoutMs: 1_000,
-      });
-      const planUpdated = yield* Deferred.make<void>();
-      const turnCompleted =
-        yield* Deferred.make<Extract<ProviderRuntimeEvent, { type: "turn.completed" }>>();
-      const runtimeEventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) =>
-        Effect.gen(function* () {
-          if (String(event.threadId) !== String(threadId)) {
-            return;
-          }
-          if (event.type === "turn.plan.updated") {
-            yield* Deferred.succeed(planUpdated, undefined).pipe(Effect.ignore);
-          }
-          if (event.type === "turn.completed") {
-            yield* Deferred.succeed(turnCompleted, event).pipe(Effect.ignore);
-          }
-        }),
-      ).pipe(Effect.forkChild);
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("grok"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-      });
-      const sendTurnFiber = yield* adapter
-        .sendTurn({ threadId, input: "update plan then stall", attachments: [] })
-        .pipe(Effect.forkChild);
-      yield* Deferred.await(planUpdated).pipe(Effect.timeout("2 seconds"), TestClock.withLive);
-
-      yield* TestClock.adjust("1 second");
-      for (let yieldAttempt = 0; yieldAttempt < 4; yieldAttempt += 1) {
-        yield* Effect.yieldNow;
-      }
-      const completed = yield* Deferred.await(turnCompleted).pipe(
-        Effect.timeout("2 seconds"),
-        TestClock.withLive,
-      );
-      yield* Fiber.join(sendTurnFiber);
-
-      assert.equal(completed.payload.state, "failed");
-      yield* Fiber.interrupt(runtimeEventsFiber);
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("settles a stalled Grok turn after the active-tool deadline", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("grok-watchdog-active-tool");
-      const wrapperPath = yield* Effect.promise(() =>
-        makeMockGrokWrapper({
-          T3_ACP_EMIT_ACTIVE_TOOL_THEN_HANG: "1",
-        }),
-      );
-      const adapter = yield* makeTestAdapter(wrapperPath, {
-        turnInactivityTimeoutMs: 1_000,
-        activeToolInactivityTimeoutMs: 5_000,
-      });
-      const activeTool = yield* Deferred.make<void>();
-      const turnCompleted =
-        yield* Deferred.make<Extract<ProviderRuntimeEvent, { type: "turn.completed" }>>();
-      const runtimeEvents: ProviderRuntimeEvent[] = [];
-      const runtimeEventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) =>
-        Effect.gen(function* () {
-          if (String(event.threadId) !== String(threadId)) {
-            return;
-          }
-          runtimeEvents.push(event);
-          if (event.type === "item.updated") {
-            yield* Deferred.succeed(activeTool, undefined).pipe(Effect.ignore);
-          }
-          if (event.type === "turn.completed") {
-            yield* Deferred.succeed(turnCompleted, event).pipe(Effect.ignore);
-          }
-        }),
-      ).pipe(Effect.forkChild);
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("grok"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-      });
-      const sendTurnFiber = yield* adapter
-        .sendTurn({ threadId, input: "run a long tool", attachments: [] })
-        .pipe(Effect.forkChild);
-      yield* Deferred.await(activeTool).pipe(Effect.timeout("2 seconds"), TestClock.withLive);
-      for (let yieldAttempt = 0; yieldAttempt < 4; yieldAttempt += 1) {
-        yield* Effect.yieldNow;
-      }
-
-      yield* TestClock.adjust("4999 millis");
-      yield* Effect.yieldNow;
-      assert.lengthOf(
-        runtimeEvents.filter(
-          (event) => event.type === "turn.completed" && String(event.threadId) === String(threadId),
-        ),
-        0,
-      );
-      assert.equal(
-        (yield* adapter.listSessions()).find((candidate) => candidate.threadId === threadId)
-          ?.status,
-        "running",
-      );
-
-      yield* TestClock.adjust("1 millis");
-      for (let yieldAttempt = 0; yieldAttempt < 4; yieldAttempt += 1) {
-        yield* Effect.yieldNow;
-      }
-      const completed = yield* Deferred.await(turnCompleted).pipe(
-        Effect.timeout("2 seconds"),
-        TestClock.withLive,
-      );
-      yield* Fiber.join(sendTurnFiber);
-      assert.equal(completed.payload.state, "failed");
-
-      yield* Fiber.interrupt(runtimeEventsFiber);
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("retains turn transcript when sendTurn is interrupted after prompt success", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("grok-send-turn-interrupt-after-prompt");
-      const wrapperPath = yield* Effect.promise(() =>
-        makeMockGrokWrapper({
-          T3_ACP_EMIT_XAI_PROMPT_COMPLETE_THEN_HANG: "1",
-        }),
-      );
-      const adapter = yield* makeTestAdapter(wrapperPath);
-      const contentDelta = yield* Deferred.make<void>();
-      const runtimeEventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) =>
-        event.type === "content.delta" ? Deferred.succeed(contentDelta, undefined) : Effect.void,
-      ).pipe(Effect.forkChild);
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("grok"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-        modelSelection: { instanceId: ProviderInstanceId.make("grok"), model: "grok-build" },
-      });
-
-      const sendTurnFiber = yield* adapter
-        .sendTurn({
-          threadId,
-          input: "interrupt after prompt",
-          attachments: [],
-        })
-        .pipe(Effect.forkChild);
-
-      yield* Deferred.await(contentDelta);
-      for (let yieldAttempt = 0; yieldAttempt < 6; yieldAttempt += 1) {
-        yield* Effect.yieldNow;
-      }
-      yield* Fiber.interrupt(sendTurnFiber);
-      for (let yieldAttempt = 0; yieldAttempt < 4; yieldAttempt += 1) {
-        yield* Effect.yieldNow;
-      }
-
-      const snapshot = yield* adapter.readThread(threadId);
-      assert.equal(snapshot.turns.length, 1);
-      assert.equal(snapshot.turns[0]?.items.length, 1);
-
-      yield* Fiber.interrupt(runtimeEventsFiber);
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("does not report a synthetic stop reason when xAI omits one", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("grok-xai-prompt-complete-missing-stop-reason");
-      const wrapperPath = yield* Effect.promise(() =>
-        makeMockGrokWrapper({
-          T3_ACP_EMIT_XAI_PROMPT_COMPLETE_THEN_HANG: "1",
-          T3_ACP_OMIT_XAI_PROMPT_COMPLETE_STOP_REASON: "1",
-        }),
-      );
-      const adapter = yield* makeTestAdapter(wrapperPath);
-
-      const runtimeEvents: ProviderRuntimeEvent[] = [];
-      const turnCompleted = yield* Deferred.make<void>();
-      const runtimeEventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) =>
-        Effect.sync(() => {
-          runtimeEvents.push(event);
-        }).pipe(
-          Effect.andThen(
-            event.type === "turn.completed"
-              ? Deferred.succeed(turnCompleted, undefined)
-              : Effect.void,
-          ),
-        ),
-      ).pipe(Effect.forkChild);
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("grok"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-        modelSelection: { instanceId: ProviderInstanceId.make("grok"), model: "grok-build" },
-      });
-
-      yield* adapter.sendTurn({
-        threadId,
-        input: "exercise missing stop reason",
-        attachments: [],
-      });
-
-      yield* Deferred.await(turnCompleted);
-      const turnCompletedEvent = runtimeEvents.find(
-        (event): event is Extract<ProviderRuntimeEvent, { type: "turn.completed" }> =>
-          event.type === "turn.completed",
-      );
-
-      assert.equal(turnCompletedEvent?.payload.state, "completed");
-      assert.isNull(turnCompletedEvent?.payload.stopReason);
-
-      yield* Fiber.interrupt(runtimeEventsFiber);
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("lets Stop unblock a fully silent Grok prompt and accept a follow-up turn", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("grok-stop-after-full-silence");
-      const wrapperPath = yield* Effect.promise(() =>
-        makeMockGrokWrapper({
-          T3_ACP_HANG_FIRST_PROMPT_FOREVER: "1",
-        }),
-      );
-      const adapter = yield* makeTestAdapter(wrapperPath);
-
-      const runtimeEvents: ProviderRuntimeEvent[] = [];
-      const runtimeEventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) =>
-        Effect.sync(() => {
-          runtimeEvents.push(event);
-        }),
-      ).pipe(Effect.forkChild);
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("grok"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-        modelSelection: { instanceId: ProviderInstanceId.make("grok"), model: "grok-build" },
-      });
-
-      yield* Effect.gen(function* () {
-        yield* Effect.sleep("500 millis");
-        yield* adapter.interruptTurn(threadId);
-      }).pipe(Effect.forkChild({ startImmediately: true }));
-
-      yield* adapter.sendTurn({
-        threadId,
-        input: "hang forever",
-        attachments: [],
-      });
-      for (let yieldAttempt = 0; yieldAttempt < 8; yieldAttempt += 1) {
-        yield* Effect.yieldNow;
-      }
-
-      const cancelledEvents = runtimeEvents.filter(
-        (event): event is Extract<ProviderRuntimeEvent, { type: "turn.completed" }> =>
-          event.type === "turn.completed" && String(event.threadId) === String(threadId),
-      );
-      const readySessions = yield* adapter.listSessions();
-      const readySession = readySessions.find((session) => session.threadId === threadId);
-
-      assert.lengthOf(cancelledEvents, 1);
-      assert.equal(cancelledEvents[0]?.payload.state, "cancelled");
-      assert.equal(readySession?.status, "ready");
-      assert.isUndefined(readySession?.activeTurnId);
-
-      const followUpEventsBefore = runtimeEvents.length;
-      yield* adapter.sendTurn({
-        threadId,
-        input: "continue after stop",
-        attachments: [],
-      });
-      for (let yieldAttempt = 0; yieldAttempt < 8; yieldAttempt += 1) {
-        yield* Effect.yieldNow;
-      }
-
-      const followUpCompletedEvents = runtimeEvents
-        .slice(followUpEventsBefore)
-        .filter(
-          (event): event is Extract<ProviderRuntimeEvent, { type: "turn.completed" }> =>
-            event.type === "turn.completed" && String(event.threadId) === String(threadId),
-        );
-      assert.lengthOf(followUpCompletedEvents, 1);
-      assert.equal(followUpCompletedEvents[0]?.payload.state, "completed");
-
-      yield* Fiber.interrupt(runtimeEventsFiber);
-      yield* adapter.stopSession(threadId);
-    }).pipe(TestClock.withLive),
-  );
-
-  it.effect("does not let a cancelled prompt settlement consume the follow-up prompt slot", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("grok-cancelled-settlement-before-follow-up");
-      const tempDir = yield* Effect.promise(() =>
-        NodeFSP.mkdtemp(NodePath.join(NodeOS.tmpdir(), "grok-acp-cancel-race-")),
-      );
-      const requestLogPath = NodePath.join(tempDir, "requests.ndjson");
-      const wrapperPath = yield* Effect.promise(() =>
-        makeMockGrokWrapper({
-          T3_ACP_HANG_FIRST_PROMPT_FOREVER: "1",
-          T3_ACP_REQUEST_LOG_PATH: requestLogPath,
-        }),
-      );
-      const adapter = yield* makeTestAdapter(wrapperPath);
-
-      const runtimeEvents: ProviderRuntimeEvent[] = [];
-      const firstTurnStarted = yield* Deferred.make<TurnId>();
-      const twoTurnsCompleted = yield* Deferred.make<void>();
-      const completedCountRef = yield* Ref.make(0);
-      const runtimeEventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) =>
-        Effect.gen(function* () {
-          runtimeEvents.push(event);
-          if (String(event.threadId) !== String(threadId)) {
-            return;
-          }
-          if (event.type === "turn.started" && event.turnId !== undefined) {
-            yield* Deferred.succeed(firstTurnStarted, event.turnId).pipe(Effect.ignore);
-            return;
-          }
-          if (event.type !== "turn.completed") {
-            return;
-          }
-          const completedCount = yield* Ref.updateAndGet(completedCountRef, (count) => count + 1);
-          if (completedCount === 2) {
-            yield* Deferred.succeed(twoTurnsCompleted, undefined);
-          }
-        }),
-      ).pipe(Effect.forkChild);
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("grok"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-      });
-
-      const firstSendTurnFiber = yield* adapter
-        .sendTurn({ threadId, input: "cancel this prompt", attachments: [] })
-        .pipe(Effect.forkChild);
-      const firstTurnId = yield* Deferred.await(firstTurnStarted).pipe(Effect.timeout("2 seconds"));
-      yield* waitForFileContent(requestLogPath, 80, '"method":"session/prompt"');
-
-      yield* adapter.interruptTurn(threadId, firstTurnId).pipe(Effect.timeout("2 seconds"));
-      const followUp = yield* adapter
-        .sendTurn({ threadId, input: "complete the follow-up", attachments: [] })
-        .pipe(Effect.timeout("2 seconds"));
-      yield* Fiber.join(firstSendTurnFiber).pipe(Effect.timeout("2 seconds"));
-      yield* Deferred.await(twoTurnsCompleted).pipe(Effect.timeout("2 seconds"));
-
-      const turnCompletedEvents = runtimeEvents.filter(
-        (event): event is Extract<ProviderRuntimeEvent, { type: "turn.completed" }> =>
-          event.type === "turn.completed" && String(event.threadId) === String(threadId),
-      );
-      const readySessions = yield* adapter.listSessions();
-      const readySession = readySessions.find((session) => session.threadId === threadId);
-
-      assert.notEqual(String(followUp.turnId), String(firstTurnId));
-      assert.deepEqual(
-        turnCompletedEvents.map((event) => [String(event.turnId), event.payload.state]),
-        [
-          [String(firstTurnId), "cancelled"],
-          [String(followUp.turnId), "completed"],
-        ],
-      );
-      assert.equal(readySession?.status, "ready");
-      assert.isUndefined(readySession?.activeTurnId);
-
-      yield* Fiber.interrupt(runtimeEventsFiber);
-      yield* adapter.stopSession(threadId);
-    }).pipe(TestClock.withLive),
-  );
-
-  it.effect("drops late ACP notifications after a turn is cancelled", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("grok-drop-late-cancelled-notifications");
-      const wrapperPath = yield* Effect.promise(() =>
-        makeMockGrokWrapper({
-          T3_ACP_HANG_PROMPT_FOREVER: "1",
-          T3_ACP_EMIT_LATE_UPDATE_AFTER_CANCEL: "1",
-        }),
-      );
-      const lateNativeUpdate = yield* Deferred.make<void>();
-      const adapter = yield* makeTestAdapter(wrapperPath, {
-        nativeEventLogger: {
-          filePath: "memory://grok-cancelled-native-events",
-          write: (record: unknown) =>
-            JSON.stringify(record).includes("late after cancel")
-              ? Deferred.succeed(lateNativeUpdate, undefined).pipe(Effect.asVoid)
-              : Effect.void,
-          close: () => Effect.void,
-        },
-      });
-
-      const runtimeEvents: ProviderRuntimeEvent[] = [];
-      const turnStarted = yield* Deferred.make<TurnId>();
-      const runtimeEventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) =>
-        Effect.sync(() => {
-          runtimeEvents.push(event);
-        }).pipe(
-          Effect.andThen(
-            event.type === "turn.started" &&
-              event.turnId !== undefined &&
-              String(event.threadId) === String(threadId)
-              ? Deferred.succeed(turnStarted, event.turnId).pipe(Effect.asVoid)
-              : Effect.void,
-          ),
-        ),
-      ).pipe(Effect.forkChild);
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("grok"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-      });
-
-      const sendTurnFiber = yield* adapter
-        .sendTurn({ threadId, input: "cancel before the late update", attachments: [] })
-        .pipe(Effect.forkChild);
-      const turnId = yield* Deferred.await(turnStarted).pipe(Effect.timeout("2 seconds"));
-      yield* adapter.interruptTurn(threadId, turnId).pipe(Effect.timeout("2 seconds"));
-      yield* Fiber.join(sendTurnFiber).pipe(Effect.timeout("2 seconds"));
-      yield* Deferred.await(lateNativeUpdate).pipe(Effect.timeout("2 seconds"));
-      for (let yieldAttempt = 0; yieldAttempt < 8; yieldAttempt += 1) {
-        yield* Effect.yieldNow;
-      }
-
-      const cancelledIndex = runtimeEvents.findIndex(
-        (event) =>
-          event.type === "turn.completed" &&
-          String(event.threadId) === String(threadId) &&
-          String(event.turnId) === String(turnId) &&
-          event.payload.state === "cancelled",
-      );
-      const turnOutputTypes = new Set([
-        "content.delta",
-        "item.started",
-        "item.updated",
-        "item.completed",
-        "turn.plan.updated",
-      ]);
-      const outputAfterCancellation = runtimeEvents
-        .slice(cancelledIndex + 1)
-        .filter(
-          (event) => String(event.threadId) === String(threadId) && turnOutputTypes.has(event.type),
-        );
-
-      assert.isAtLeast(cancelledIndex, 0);
-      assert.deepEqual(outputAfterCancellation, []);
-
-      yield* Fiber.interrupt(runtimeEventsFiber);
-      yield* adapter.stopSession(threadId);
-    }).pipe(TestClock.withLive),
-  );
-
-  it.effect("lets Stop cancel during the xAI completion drain window", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("grok-stop-during-completion-drain");
-      const wrapperPath = yield* Effect.promise(() =>
-        makeMockGrokWrapper({
-          T3_ACP_EMIT_XAI_PROMPT_COMPLETE_THEN_HANG: "1",
-        }),
-      );
-      const adapter = yield* makeTestAdapter(wrapperPath);
-
-      const runtimeEvents: ProviderRuntimeEvent[] = [];
-      const activeTurnIdRef = yield* Ref.make<TurnId | undefined>(undefined);
-      const trailingChunkTurnId = yield* Deferred.make<TurnId>();
-      const runtimeEventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) =>
-        Effect.gen(function* () {
-          runtimeEvents.push(event);
-          if (String(event.threadId) !== String(threadId)) {
-            return;
-          }
-          if (event.type === "turn.started") {
-            yield* Ref.set(activeTurnIdRef, event.turnId);
-          }
-          if (event.type !== "content.delta" || event.payload.delta !== "mock") {
-            return;
-          }
-          const turnId = event.turnId ?? (yield* Ref.get(activeTurnIdRef));
-          if (turnId === undefined) {
-            return;
-          }
-          yield* Deferred.succeed(trailingChunkTurnId, turnId).pipe(Effect.ignore);
-        }),
-      ).pipe(Effect.forkChild);
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("grok"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-        modelSelection: { instanceId: ProviderInstanceId.make("grok"), model: "grok-build" },
-      });
-
-      const sendTurnFiber = yield* adapter
-        .sendTurn({
-          threadId,
-          input: "cancel during completion drain",
-          attachments: [],
-        })
-        .pipe(Effect.forkChild);
-
-      const turnId = yield* Deferred.await(trailingChunkTurnId).pipe(Effect.timeout("2 seconds"));
-      yield* adapter.interruptTurn(threadId, turnId).pipe(Effect.timeout("2 seconds"));
-      yield* Fiber.join(sendTurnFiber).pipe(Effect.timeout("2 seconds"));
-
-      const turnCompletedEvents = runtimeEvents.filter(
-        (event): event is Extract<ProviderRuntimeEvent, { type: "turn.completed" }> =>
-          event.type === "turn.completed" && String(event.threadId) === String(threadId),
-      );
-      const readySessions = yield* adapter.listSessions();
-      const readySession = readySessions.find((session) => session.threadId === threadId);
-
-      assert.lengthOf(turnCompletedEvents, 1);
-      assert.equal(turnCompletedEvents[0]?.payload.state, "cancelled");
-      assert.equal(readySession?.status, "ready");
-      assert.isUndefined(readySession?.activeTurnId);
-
-      yield* Fiber.interrupt(runtimeEventsFiber);
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("settles the in-flight prompt before emitting completion", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("grok-completion-before-next-turn");
-      const wrapperPath = yield* Effect.promise(() => makeMockGrokWrapper());
-      const adapter = yield* makeTestAdapter(wrapperPath);
-      const completedCountRef = yield* Ref.make(0);
-      const secondTurnCompleted = yield* Deferred.make<void>();
-
-      const runtimeEventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) => {
-        if (event.type !== "turn.completed" || String(event.threadId) !== String(threadId)) {
-          return Effect.void;
-        }
-
-        return Ref.modify(completedCountRef, (count) => {
-          const nextCount = count + 1;
-          return [nextCount, nextCount] as const;
-        }).pipe(
-          Effect.flatMap((count) => {
-            if (count === 1) {
-              return adapter
-                .sendTurn({
-                  threadId,
-                  input: "second turn after completion",
-                  attachments: [],
-                })
-                .pipe(Effect.forkChild, Effect.asVoid);
-            }
-            if (count === 2) {
-              return Deferred.succeed(secondTurnCompleted, undefined).pipe(Effect.asVoid);
-            }
-            return Effect.void;
-          }),
-        );
-      }).pipe(Effect.forkChild);
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("grok"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-        modelSelection: { instanceId: ProviderInstanceId.make("grok"), model: "grok-build" },
-      });
-
-      yield* adapter.sendTurn({
-        threadId,
-        input: "first turn",
-        attachments: [],
-      });
-      yield* Deferred.await(secondTurnCompleted);
-
-      const completedCount = yield* Ref.get(completedCountRef);
-      const readySessions = yield* adapter.listSessions();
-      const readySession = readySessions.find((session) => session.threadId === threadId);
-
-      assert.equal(completedCount, 2);
-      assert.equal(readySession?.status, "ready");
-      assert.isUndefined(readySession?.activeTurnId);
-
-      yield* Fiber.interrupt(runtimeEventsFiber);
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("restores a Grok session to ready when the prompt RPC fails", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("grok-prompt-failure-ready");
-      const wrapperPath = yield* Effect.promise(() =>
-        makeMockGrokWrapper({
-          T3_ACP_FAIL_PROMPT: "1",
-        }),
-      );
-      const adapter = yield* makeTestAdapter(wrapperPath);
-      const runtimeEvents: ProviderRuntimeEvent[] = [];
-      const runtimeEventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) =>
-        Effect.sync(() => {
-          runtimeEvents.push(event);
-        }),
-      ).pipe(Effect.forkChild);
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("grok"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-        modelSelection: { instanceId: ProviderInstanceId.make("grok"), model: "grok-build" },
-      });
-
-      const error = yield* Effect.flip(
-        adapter.sendTurn({
-          threadId,
-          input: "fail prompt",
-          attachments: [],
-        }),
-      );
-      const readySessions = yield* adapter.listSessions();
-      const readySession = readySessions.find((session) => session.threadId === threadId);
-      const failedTurnCompleted = runtimeEvents.find(
-        (event) => event.type === "turn.completed" && event.threadId === threadId,
-      );
-
-      assert.equal(error._tag, "ProviderAdapterRequestError");
-      assert.equal(readySession?.status, "ready");
-      assert.isUndefined(readySession?.activeTurnId);
-      assert.equal(failedTurnCompleted?.type, "turn.completed");
-      if (failedTurnCompleted?.type === "turn.completed") {
-        assert.equal(failedTurnCompleted.payload.state, "failed");
-        assert.isString(failedTurnCompleted.payload.errorMessage);
-      }
-
-      yield* Fiber.interrupt(runtimeEventsFiber);
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("surfaces Grok usage limits without clearing the selected model", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("grok-usage-limit-error");
-      const wrapperPath = yield* Effect.promise(() =>
-        makeMockGrokWrapper({
-          T3_ACP_EMIT_XAI_RATE_LIMIT_THEN_HANG: "1",
-        }),
-      );
-      const adapter = yield* makeTestAdapter(wrapperPath);
-      const runtimeEvents: ProviderRuntimeEvent[] = [];
-      const runtimeEventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) =>
-        Effect.sync(() => {
-          runtimeEvents.push(event);
-        }),
-      ).pipe(Effect.forkChild);
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("grok"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-        modelSelection: { instanceId: ProviderInstanceId.make("grok"), model: "grok-build" },
-      });
-
-      const error = yield* Effect.flip(
-        adapter.sendTurn({
-          threadId,
-          input: "hit the usage limit",
-          attachments: [],
-        }),
-      );
-      const readySessions = yield* adapter.listSessions();
-      const readySession = readySessions.find((session) => session.threadId === threadId);
-      const terminalEvents = runtimeEvents.filter(
-        (event) => event.type === "turn.completed" && event.threadId === threadId,
-      );
-
-      assert.equal(error._tag, "ProviderAdapterRequestError");
-      assert.include(error.message, "Grok usage limit reached. Try again later.");
-      assert.equal(readySession?.status, "ready");
-      assert.equal(readySession?.model, "grok-build");
-      assert.isUndefined(readySession?.activeTurnId);
-      assert.lengthOf(terminalEvents, 1);
-      const [terminalEvent] = terminalEvents;
-      assert.equal(terminalEvent?.type, "turn.completed");
-      if (terminalEvent?.type === "turn.completed") {
-        assert.equal(terminalEvent.payload.state, "failed");
-        assert.include(
-          terminalEvent.payload.errorMessage ?? "",
-          "Grok usage limit reached. Try again later.",
-        );
-      }
-
-      yield* Fiber.interrupt(runtimeEventsFiber);
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("ignores replayed session/load updates when resuming a Grok session", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("grok-load-replay-filter");
-      const wrapperPath = yield* Effect.promise(() =>
-        makeMockGrokWrapper({
-          T3_ACP_EMIT_LOAD_REPLAY: "1",
-        }),
-      );
-      const adapter = yield* makeTestAdapter(wrapperPath);
-      const runtimeEvents: ProviderRuntimeEvent[] = [];
-      const runtimeEventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) =>
-        Effect.sync(() => {
-          runtimeEvents.push(event);
-        }),
-      ).pipe(Effect.forkChild);
-
-      const session = yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("grok"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-        modelSelection: { instanceId: ProviderInstanceId.make("grok"), model: "grok-build" },
-        resumeCursor: { schemaVersion: 1, sessionId: "mock-session-1" },
-      });
-
-      yield* adapter.sendTurn({
-        threadId,
-        input: "after resume",
-        attachments: [],
-      });
-
-      assert.deepStrictEqual(session.resumeCursor, {
-        schemaVersion: 1,
-        sessionId: "mock-session-1",
-      });
-      assert.isFalse(
-        runtimeEvents.some(
-          (event) => event.type === "item.completed" && event.payload.title === "Replay tool",
-        ),
-      );
-      assert.isFalse(
-        runtimeEvents.some(
-          (event) =>
-            event.type === "content.delta" && event.payload.delta === "replayed assistant text",
-        ),
-      );
-
-      yield* Fiber.interrupt(runtimeEventsFiber);
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("rejects startSession when provider mismatches", () =>
-    Effect.gen(function* () {
-      const wrapperPath = yield* Effect.promise(() => makeMockGrokWrapper());
-      const adapter = yield* makeTestAdapter(wrapperPath);
-      const threadId = ThreadId.make("grok-provider-mismatch");
-
-      const error = yield* Effect.flip(
-        adapter.startSession({
-          threadId,
-          provider: ProviderDriverKind.make("cursor"),
-          cwd: process.cwd(),
-          runtimeMode: "full-access",
-          modelSelection: { instanceId: ProviderInstanceId.make("grok"), model: "grok-build" },
-        }),
-      );
-
-      assert.equal(error._tag, "ProviderAdapterValidationError");
-    }),
-  );
-
-  it.effect("rejects sendTurn with empty input and no attachments", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("grok-empty-turn");
-
-      const wrapperPath = yield* Effect.promise(() => makeMockGrokWrapper());
-      const adapter = yield* makeTestAdapter(wrapperPath);
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("grok"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-        modelSelection: { instanceId: ProviderInstanceId.make("grok"), model: "grok-build" },
-      });
-
-      const error = yield* Effect.flip(
-        adapter.sendTurn({
-          threadId,
-          input: "   ",
-          attachments: [],
-        }),
-      );
-
-      assert.equal(error._tag, "ProviderAdapterValidationError");
-
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("responds to ACP approvals using provider-supplied option ids", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("grok-custom-approval-option-id");
-      const tempDir = yield* Effect.promise(() =>
-        NodeFSP.mkdtemp(NodePath.join(NodeOS.tmpdir(), "grok-acp-")),
-      );
-      const requestLogPath = NodePath.join(tempDir, "requests.ndjson");
-      const wrapperPath = yield* Effect.promise(() =>
-        makeMockGrokWrapper({
-          T3_ACP_REQUEST_LOG_PATH: requestLogPath,
-          T3_ACP_EMIT_TOOL_CALLS: "1",
-          T3_ACP_ALLOW_ONCE_OPTION_ID: "agent-defined-approval-id",
-        }),
-      );
-      const adapter = yield* makeTestAdapter(wrapperPath);
-      const eventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) =>
-        event.type === "request.opened"
-          ? adapter.respondToRequest(
-              threadId,
-              ApprovalRequestId.make(String(event.requestId)),
-              "accept",
-            )
-          : Effect.void,
-      ).pipe(Effect.forkChild);
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("grok"),
-        cwd: process.cwd(),
-        runtimeMode: "approval-required",
-      });
-      yield* adapter.sendTurn({ threadId, input: "approve this", attachments: [] });
-
-      const requests = yield* Effect.promise(() => readJsonLines(requestLogPath));
-      assert.isTrue(
-        requests.some(
-          (entry) =>
-            !("method" in entry) &&
-            typeof entry.result === "object" &&
-            entry.result !== null &&
-            "outcome" in entry.result &&
-            typeof entry.result.outcome === "object" &&
-            entry.result.outcome !== null &&
-            "optionId" in entry.result.outcome &&
-            entry.result.outcome.optionId === "agent-defined-approval-id",
-        ),
-      );
-
-      yield* Fiber.interrupt(eventsFiber);
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("captures xAI exit_plan_mode as a proposed plan and unblocks the turn", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("grok-xai-exit-plan-mode");
-      const wrapperPath = yield* Effect.promise(() =>
-        makeMockGrokWrapper({ T3_ACP_EMIT_XAI_EXIT_PLAN_MODE: "1" }),
-      );
-      const adapter = yield* makeTestAdapter(wrapperPath);
-      const proposed =
-        yield* Deferred.make<Extract<ProviderRuntimeEvent, { type: "turn.proposed.completed" }>>();
-      const turnCompleted = yield* Deferred.make<void>();
-
-      const eventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) => {
-        if (String(event.threadId) !== String(threadId)) {
-          return Effect.void;
-        }
-        if (event.type === "turn.proposed.completed") {
-          return Deferred.succeed(proposed, event).pipe(Effect.ignore);
-        }
-        if (event.type === "turn.completed") {
-          return Deferred.succeed(turnCompleted, undefined).pipe(Effect.ignore);
-        }
-        return Effect.void;
-      }).pipe(Effect.forkChild);
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("grok"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-      });
-
-      yield* adapter.sendTurn({ threadId, input: "present the plan", attachments: [] });
-
-      const proposedEvent = yield* Deferred.await(proposed);
-      assert.equal(proposedEvent.type, "turn.proposed.completed");
-      assert.equal(proposedEvent.payload.planMarkdown, "# Exit plan\n\n- Step one\n- Step two");
-      assert.equal(proposedEvent.raw?.method, "_x.ai/exit_plan_mode");
-      yield* Deferred.await(turnCompleted);
-
-      yield* Fiber.interrupt(eventsFiber);
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("surfaces plan.md writes as a proposed plan while plan mode is active", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("grok-xai-plan-md-write");
-      const wrapperPath = yield* Effect.promise(() =>
-        makeMockGrokWrapper({ T3_ACP_EMIT_XAI_PLAN_MD_WRITE: "1" }),
-      );
-      const adapter = yield* makeTestAdapter(wrapperPath);
-      const proposed =
-        yield* Deferred.make<Extract<ProviderRuntimeEvent, { type: "turn.proposed.completed" }>>();
-
-      const eventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) => {
-        if (String(event.threadId) !== String(threadId)) {
-          return Effect.void;
-        }
-        if (event.type === "turn.proposed.completed") {
-          return Deferred.succeed(proposed, event).pipe(Effect.ignore);
-        }
-        return Effect.void;
-      }).pipe(Effect.forkChild);
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("grok"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-      });
-
-      yield* adapter.sendTurn({ threadId, input: "write the plan", attachments: [] });
-
-      const proposedEvent = yield* Deferred.await(proposed);
-      assert.equal(
-        proposedEvent.payload.planMarkdown,
-        "# Mock plan\n\n- Write the feature\n- Add a test\n- Ship it",
-      );
-      assert.equal(proposedEvent.raw?.method, "session/update");
-
-      yield* Fiber.interrupt(eventsFiber);
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("keeps a Grok turn running when Always allow has no allow_always option", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("grok-always-allow-without-allow-always");
-      const tempDir = yield* Effect.promise(() =>
-        NodeFSP.mkdtemp(NodePath.join(NodeOS.tmpdir(), "grok-acp-")),
-      );
-      const requestLogPath = NodePath.join(tempDir, "requests.ndjson");
-      const wrapperPath = yield* Effect.promise(() =>
-        makeMockGrokWrapper({
-          T3_ACP_REQUEST_LOG_PATH: requestLogPath,
-          T3_ACP_EMIT_TOOL_CALLS: "1",
-          T3_ACP_OMIT_ALLOW_ALWAYS: "1",
-          T3_ACP_PERMISSION_REQUEST_COUNT: "2",
-        }),
-      );
-      const adapter = yield* makeTestAdapter(wrapperPath);
-      const openedCount = yield* Ref.make(0);
-      const eventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) =>
-        event.type === "request.opened"
-          ? Effect.gen(function* () {
-              yield* Ref.update(openedCount, (count) => count + 1);
-              yield* adapter.respondToRequest(
-                threadId,
-                ApprovalRequestId.make(String(event.requestId)),
-                "acceptForSession",
-              );
-            })
-          : Effect.void,
-      ).pipe(Effect.forkChild);
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("grok"),
-        cwd: process.cwd(),
-        runtimeMode: "approval-required",
-      });
-      yield* adapter.sendTurn({
-        threadId,
-        input: "approve this session",
-        attachments: [],
-      });
-
-      assert.equal(yield* Ref.get(openedCount), 1);
-
-      const requests = yield* Effect.promise(() => readJsonLines(requestLogPath));
-      const permissionResults = requests.filter(
-        (entry) =>
-          !("method" in entry) &&
-          typeof entry.result === "object" &&
-          entry.result !== null &&
-          "outcome" in entry.result &&
-          typeof entry.result.outcome === "object" &&
-          entry.result.outcome !== null &&
-          "optionId" in entry.result.outcome,
-      );
-      assert.equal(permissionResults.length, 2);
-      assert.isTrue(
-        permissionResults.every(
-          (entry) =>
-            typeof entry.result === "object" &&
-            entry.result !== null &&
-            "outcome" in entry.result &&
-            typeof entry.result.outcome === "object" &&
-            entry.result.outcome !== null &&
-            "optionId" in entry.result.outcome &&
-            entry.result.outcome.optionId === "allow-once",
-        ),
-      );
-
-      yield* Fiber.interrupt(eventsFiber);
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("asks before a different command after Always allow this session", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("grok-session-approval-scope");
-      const wrapperPath = yield* Effect.promise(() =>
-        makeMockGrokWrapper({
-          T3_ACP_EMIT_TOOL_CALLS: "1",
-          T3_ACP_OMIT_ALLOW_ALWAYS: "1",
-          T3_ACP_PERMISSION_REQUEST_COUNT: "2",
-          T3_ACP_PERMISSION_TITLE: "Terminal",
-          T3_ACP_SECOND_PERMISSION_COMMAND: "rm server/package.json",
-        }),
-      );
-      const adapter = yield* makeTestAdapter(wrapperPath);
-      const openedCount = yield* Ref.make(0);
-      const eventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) =>
-        event.type === "request.opened"
-          ? Effect.gen(function* () {
-              const count = yield* Ref.updateAndGet(openedCount, (value) => value + 1);
-              yield* adapter.respondToRequest(
-                threadId,
-                ApprovalRequestId.make(String(event.requestId)),
-                count === 1 ? "acceptForSession" : "decline",
-              );
-            })
-          : Effect.void,
-      ).pipe(Effect.forkChild);
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("grok"),
-        cwd: process.cwd(),
-        runtimeMode: "approval-required",
-      });
-      yield* adapter.sendTurn({ threadId, input: "check approval scope", attachments: [] });
-      assert.equal(yield* Ref.get(openedCount), 2);
-      yield* Fiber.interrupt(eventsFiber);
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("captures a plan under the provider instance GROK_HOME", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("grok-instance-plan-home");
-      const grokHome = yield* Effect.promise(() =>
-        NodeFSP.mkdtemp(NodePath.join(NodeOS.tmpdir(), "grok-instance-home-")),
-      );
-      const wrapperPath = yield* Effect.promise(() =>
-        makeMockGrokWrapper({
-          T3_ACP_EMIT_XAI_PLAN_MD_WRITE: "1",
-          T3_ACP_PLAN_ROOT: grokHome,
-        }),
-      );
-      const adapter = yield* makeTestAdapter(wrapperPath, {
-        environment: { ...process.env, GROK_HOME: grokHome },
-      });
-      const plans = yield* Ref.make<ReadonlyArray<string>>([]);
-      const completed = yield* Deferred.make<void>();
-      const eventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) => {
-        if (event.type === "turn.proposed.completed") {
-          return Ref.update(plans, (current) => [...current, event.payload.planMarkdown]);
-        }
-        return event.type === "turn.completed"
-          ? Deferred.succeed(completed, undefined).pipe(Effect.asVoid)
-          : Effect.void;
-      }).pipe(Effect.forkChild);
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("grok"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-      });
-      yield* adapter.sendTurn({ threadId, input: "write the plan", attachments: [] });
-      yield* Deferred.await(completed);
-      assert.deepEqual(yield* Ref.get(plans), [
-        "# Mock plan\n\n- Write the feature\n- Add a test\n- Ship it",
-      ]);
-      yield* Fiber.interrupt(eventsFiber);
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("handles xAI ask_user_question extension requests", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("grok-xai-ask-user-question");
-      const wrapperPath = yield* Effect.promise(() =>
-        makeMockGrokWrapper({ T3_ACP_EMIT_XAI_ASK_USER_QUESTION: "1" }),
-      );
-      const adapter = yield* makeTestAdapter(wrapperPath);
-      const requested =
-        yield* Deferred.make<Extract<ProviderRuntimeEvent, { type: "user-input.requested" }>>();
-      const resolved =
-        yield* Deferred.make<Extract<ProviderRuntimeEvent, { type: "user-input.resolved" }>>();
-
-      const eventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) => {
-        if (String(event.threadId) !== String(threadId)) {
-          return Effect.void;
-        }
-        if (event.type === "user-input.requested") {
-          return Deferred.succeed(requested, event).pipe(Effect.ignore);
-        }
-        if (event.type === "user-input.resolved") {
-          return Deferred.succeed(resolved, event).pipe(Effect.ignore);
-        }
-        return Effect.void;
-      }).pipe(Effect.forkChild);
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("grok"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-      });
-
-      const sendTurnFiber = yield* adapter
-        .sendTurn({ threadId, input: "ask before continuing", attachments: [] })
-        .pipe(Effect.forkChild);
-
-      const requestedEvent = yield* Deferred.await(requested);
-      assert.equal(requestedEvent.payload.questions.length, 1);
-      assert.equal(requestedEvent.payload.questions[0]?.id, "Which scope should Grok use?");
-      assert.equal(requestedEvent.payload.questions[0]?.question, "Which scope should Grok use?");
-      assert.equal(requestedEvent.raw?.method, "_x.ai/ask_user_question");
-
-      yield* adapter.respondToUserInput(
-        threadId,
-        ApprovalRequestId.make(String(requestedEvent.requestId)),
-        {
-          "Which scope should Grok use?": "Workspace",
-        },
-      );
-
-      const resolvedEvent = yield* Deferred.await(resolved);
-      assert.deepEqual(resolvedEvent.payload.answers, {
-        "Which scope should Grok use?": "Workspace",
-      });
-      assert.equal(String(resolvedEvent.turnId), String(requestedEvent.turnId));
-      yield* Fiber.join(sendTurnFiber);
-
-      yield* Fiber.interrupt(eventsFiber);
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("settles a stalled Grok turn after its first activity is user input", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("grok-xai-ask-user-question");
-      const wrapperPath = yield* Effect.promise(() =>
-        makeMockGrokWrapper({ T3_ACP_EMIT_XAI_ASK_USER_QUESTION_THEN_HANG: "1" }),
-      );
-      const adapter = yield* makeTestAdapter(wrapperPath, {
-        turnInactivityTimeoutMs: 1_000,
-      });
-      const requested =
-        yield* Deferred.make<Extract<ProviderRuntimeEvent, { type: "user-input.requested" }>>();
-      const resolved =
-        yield* Deferred.make<Extract<ProviderRuntimeEvent, { type: "user-input.resolved" }>>();
-      const completed =
-        yield* Deferred.make<Extract<ProviderRuntimeEvent, { type: "turn.completed" }>>();
-
-      const eventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) => {
-        if (String(event.threadId) !== String(threadId)) {
-          return Effect.void;
-        }
-        if (event.type === "user-input.requested") {
-          return Deferred.succeed(requested, event).pipe(Effect.ignore);
-        }
-        if (event.type === "user-input.resolved") {
-          return Deferred.succeed(resolved, event).pipe(Effect.ignore);
-        }
-        if (event.type === "turn.completed") {
-          return Deferred.succeed(completed, event).pipe(Effect.ignore);
-        }
-        return Effect.void;
-      }).pipe(Effect.forkChild);
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("grok"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-      });
-
-      const sendTurnFiber = yield* adapter
-        .sendTurn({ threadId, input: "ask before continuing", attachments: [] })
-        .pipe(Effect.forkChild);
-
-      const requestedEvent = yield* Deferred.await(requested);
-      assert.equal(requestedEvent.payload.questions.length, 1);
-      assert.equal(requestedEvent.payload.questions[0]?.id, "Which scope should Grok use?");
-      assert.equal(requestedEvent.payload.questions[0]?.question, "Which scope should Grok use?");
-      assert.equal(requestedEvent.raw?.method, "_x.ai/ask_user_question");
-
-      yield* adapter.respondToUserInput(
-        threadId,
-        ApprovalRequestId.make(String(requestedEvent.requestId)),
-        {
-          "Which scope should Grok use?": "Workspace",
-        },
-      );
-
-      const resolvedEvent = yield* Deferred.await(resolved);
-      assert.deepEqual(resolvedEvent.payload.answers, {
-        "Which scope should Grok use?": "Workspace",
-      });
-      assert.equal(String(resolvedEvent.turnId), String(requestedEvent.turnId));
-
-      yield* TestClock.adjust("1 second");
-      const completedEvent = yield* Deferred.await(completed).pipe(
-        Effect.timeout("2 seconds"),
-        TestClock.withLive,
-      );
-      assert.equal(completedEvent.payload.state, "failed");
-      yield* Fiber.join(sendTurnFiber);
-
-      yield* Fiber.interrupt(eventsFiber);
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("continues streaming events when native notification logging fails", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("grok-native-log-failure");
-      const wrapperPath = yield* Effect.promise(() => makeMockGrokWrapper());
-      const adapter = yield* makeTestAdapter(wrapperPath, {
-        nativeEventLogger: {
-          filePath: "memory://grok-native-events",
-          write: (record: unknown) =>
-            typeof record === "object" &&
-            record !== null &&
-            "event" in record &&
-            typeof record.event === "object" &&
-            record.event !== null &&
-            "kind" in record.event &&
-            record.event.kind === "notification"
-              ? Effect.die(new Error("native log write failed"))
-              : Effect.void,
-          close: () => Effect.void,
-        },
-      });
-      const contentDelta = yield* Deferred.make<void>();
-      const eventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) =>
-        event.type === "content.delta" ? Deferred.succeed(contentDelta, undefined) : Effect.void,
-      ).pipe(Effect.forkChild);
-
-      yield* adapter.startSession({
-        threadId,
-        provider: ProviderDriverKind.make("grok"),
-        cwd: process.cwd(),
-        runtimeMode: "full-access",
-      });
-      yield* adapter.sendTurn({ threadId, input: "keep streaming", attachments: [] });
-      yield* Deferred.await(contentDelta);
-
-      yield* Fiber.interrupt(eventsFiber);
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  // Production calls startSession from a request fiber that finishes as soon as
-  // the session exists. `Effect.forkChild` made the notification consumer a
-  // child of that fiber, and Effect interrupts a fiber's children when it
-  // completes, so the consumer died on return and every later session/update
-  // was dropped: the thread sat on "Working" forever while the provider
-  // streamed its whole turn. Every other test here calls startSession directly
-  // from the test fiber, which never completes, so the consumer survived and
-  // the bug stayed invisible. Running it in a fiber that finishes is what
-  // reproduces production.
-  it.effect("keeps consuming notifications after the startSession fiber completes", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("grok-consumer-outlives-start-session");
-      const wrapperPath = yield* Effect.promise(() => makeMockGrokWrapper());
-      const adapter = yield* makeTestAdapter(wrapperPath);
-
-      const runtimeEvents: ProviderRuntimeEvent[] = [];
-      const turnCompleted = yield* Deferred.make<void>();
-      const runtimeEventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) =>
-        Effect.sync(() => {
-          runtimeEvents.push(event);
-        }).pipe(
-          Effect.andThen(
-            event.type === "turn.completed" && String(event.threadId) === String(threadId)
-              ? Deferred.succeed(turnCompleted, undefined).pipe(Effect.asVoid)
-              : Effect.void,
-          ),
-        ),
-      ).pipe(Effect.forkChild);
-
-      const startSessionFiber = yield* adapter
-        .startSession({
-          threadId,
-          provider: ProviderDriverKind.make("grok"),
-          cwd: process.cwd(),
-          runtimeMode: "full-access",
-        })
-        .pipe(Effect.forkChild);
-      yield* Fiber.join(startSessionFiber).pipe(Effect.timeout("10 seconds"));
-
-      // Forked, and the assertion waits on the projected event rather than on
-      // sendTurn: with the consumer dead the turn never settles, so awaiting it
-      // directly would hang until the suite timeout instead of failing here.
-      const sendTurnFiber = yield* adapter
-        .sendTurn({ threadId, input: "hello grok", attachments: [] })
-        .pipe(Effect.forkChild);
-      yield* Deferred.await(turnCompleted).pipe(Effect.timeout("10 seconds"));
-      yield* Fiber.join(sendTurnFiber).pipe(Effect.timeout("10 seconds"));
-
-      const delta = runtimeEvents.find(
-        (event) => event.type === "content.delta" && String(event.threadId) === String(threadId),
-      );
-      assert.isDefined(
-        delta,
-        "no content.delta was projected after the startSession fiber completed",
-      );
-      if (delta?.type === "content.delta") {
-        assert.equal(delta.payload.delta, "hello from mock");
-      }
-
-      yield* Fiber.interrupt(runtimeEventsFiber);
-      yield* adapter.stopSession(threadId);
-      // Live clock so the timeouts above are real: under the default test clock
-      // they wait on virtual time that never advances, and a regression would
-      // hang until the suite timeout instead of failing here.
-    }).pipe(TestClock.withLive),
-  );
-});
diff --git a/apps/server/src/provider/Layers/GrokAdapter.ts b/apps/server/src/provider/Layers/GrokAdapter.ts
deleted file mode 100644
index 4bec298c628d..000000000000
--- a/apps/server/src/provider/Layers/GrokAdapter.ts
+++ /dev/null
@@ -1,2046 +0,0 @@
-import {
-  ApprovalRequestId,
-  type GrokSettings,
-  EventId,
-  type ProviderApprovalDecision,
-  type ProviderRuntimeEvent,
-  type ProviderSession,
-  type ProviderUserInputAnswers,
-  ProviderDriverKind,
-  ProviderInstanceId,
-  RuntimeRequestId,
-  type ThreadId,
-  TurnId,
-} from "@t3tools/contracts";
-import { HostProcessEnvironment, HostProcessPlatform } from "@t3tools/shared/hostProcess";
-import { getModelSelectionStringOptionValue } from "@t3tools/shared/model";
-import { stableStringify } from "@t3tools/shared/relaySigning";
-import * as Clock from "effect/Clock";
-import * as Crypto from "effect/Crypto";
-import * as DateTime from "effect/DateTime";
-import * as Deferred from "effect/Deferred";
-import * as Duration from "effect/Duration";
-import * as Effect from "effect/Effect";
-import * as Exit from "effect/Exit";
-import * as Fiber from "effect/Fiber";
-import * as FileSystem from "effect/FileSystem";
-import * as Option from "effect/Option";
-import * as Path from "effect/Path";
-import * as PubSub from "effect/PubSub";
-import * as Queue from "effect/Queue";
-import * as Ref from "effect/Ref";
-import * as Schema from "effect/Schema";
-import * as Scope from "effect/Scope";
-import * as Semaphore from "effect/Semaphore";
-import * as Stream from "effect/Stream";
-import * as SynchronizedRef from "effect/SynchronizedRef";
-import * as ChildProcessSpawner from "effect/unstable/process/ChildProcessSpawner";
-import * as EffectAcpErrors from "effect-acp/errors";
-import type * as EffectAcpSchema from "effect-acp/schema";
-
-import { resolveAttachmentPath } from "../../attachmentStore.ts";
-import { ServerConfig } from "../../config.ts";
-import * as McpProviderSession from "../../mcp/McpProviderSession.ts";
-import {
-  ProviderAdapterProcessError,
-  ProviderAdapterRequestError,
-  ProviderAdapterSessionNotFoundError,
-  ProviderAdapterValidationError,
-} from "../Errors.ts";
-import { mapAcpToAdapterError } from "../acp/AcpAdapterSupport.ts";
-import type * as AcpSessionRuntime from "../acp/AcpSessionRuntime.ts";
-import {
-  makeAcpAssistantItemEvent,
-  makeAcpContentDeltaEvent,
-  makeAcpPlanUpdatedEvent,
-  makeAcpRequestOpenedEvent,
-  makeAcpRequestResolvedEvent,
-  makeAcpToolCallEvent,
-} from "../acp/AcpCoreRuntimeEvents.ts";
-import { parsePermissionRequest } from "../acp/AcpRuntimeModel.ts";
-import { makeAcpNativeLoggerFactory } from "../acp/AcpNativeLogging.ts";
-import {
-  applyGrokAcpModelSelection,
-  currentGrokModelIdFromSessionSetup,
-  currentGrokReasoningEffortFromSessionSetup,
-  makeGrokAcpRuntime,
-  normalizeGrokReasoningEffort,
-  resolveGrokAcpBaseModelId,
-} from "../acp/GrokAcpSupport.ts";
-import {
-  extractGrokPlanMarkdownFromToolCallData,
-  extractXAiAskUserQuestions,
-  extractXAiExitPlanMarkdown,
-  makeXAiAskUserQuestionCancelledResponse,
-  makeXAiAskUserQuestionResponse,
-  makeXAiExitPlanModeCapturedResponse,
-  promptResponseHasMissingXAiStopReason,
-  XAiAskUserQuestionRequest,
-  XAiExitPlanModeRequest,
-} from "../acp/XAiAcpExtension.ts";
-import { type GrokAdapterShape } from "../Services/GrokAdapter.ts";
-import { type EventNdjsonLogger, makeEventNdjsonLogger } from "./EventNdjsonLogger.ts";
-
-const encodeUnknownJsonStringExit = Schema.encodeUnknownExit(Schema.fromJsonString(Schema.Unknown));
-
-const PROVIDER = ProviderDriverKind.make("grok");
-const GROK_RESUME_VERSION = 1 as const;
-const NANOS_PER_MILLI = 1_000_000n;
-// ACP does not expose Grok's private `streaming_reasoning` phase. Once it has
-// emitted standard ACP progress, ten silent minutes is long enough to avoid
-// treating legitimate reasoning as a stalled stream.
-const DEFAULT_GROK_TURN_INACTIVITY_TIMEOUT_MS = 10 * 60 * 1_000;
-// A tool can legitimately run without emitting text for much longer than
-// reasoning. It still needs a deadline so a lost tool update cannot leave the
-// turn working forever.
-const DEFAULT_GROK_ACTIVE_TOOL_INACTIVITY_TIMEOUT_MS = 30 * 60 * 1_000;
-
-function encodeJsonStringForDiagnostics(input: unknown): string | undefined {
-  const result = encodeUnknownJsonStringExit(input);
-  return Exit.isSuccess(result) ? result.value : undefined;
-}
-
-export interface GrokAdapterLiveOptions {
-  readonly environment?: NodeJS.ProcessEnv;
-  readonly nativeEventLogPath?: string;
-  readonly nativeEventLogger?: EventNdjsonLogger;
-  readonly instanceId?: ProviderInstanceId;
-  /** Override the conservative ACP turn liveness timeout in focused tests. */
-  readonly turnInactivityTimeoutMs?: number;
-  /** Override the longer active-tool liveness timeout in focused tests. */
-  readonly activeToolInactivityTimeoutMs?: number;
-}
-
-interface PendingApproval {
-  readonly decision: Deferred.Deferred<ProviderApprovalDecision>;
-}
-
-type PendingUserInputResolution =
-  | { readonly _tag: "answered"; readonly answers: ProviderUserInputAnswers }
-  | { readonly _tag: "cancelled" };
-
-interface PendingUserInput {
-  readonly resolution: Deferred.Deferred<PendingUserInputResolution>;
-}
-
-interface GrokTurnLivenessSignal {
-  readonly turnId: TurnId;
-}
-
-interface GrokSessionContext {
-  readonly threadId: ThreadId;
-  readonly acpSessionId: string;
-  session: ProviderSession;
-  readonly scope: Scope.Closeable;
-  readonly acp: AcpSessionRuntime.AcpSessionRuntime["Service"];
-  notificationFiber: Fiber.Fiber<void, never> | undefined;
-  readonly pendingApprovals: Map<ApprovalRequestId, PendingApproval>;
-  readonly pendingUserInputs: Map<ApprovalRequestId, PendingUserInput>;
-  turns: Array<{ id: TurnId; items: Array<unknown> }>;
-  lastPlanFingerprint: string | undefined;
-  /**
-   * Latest plan.md body + turn it was emitted for. Dedupe is turn-scoped so a
-   * later turn re-proposing the same text still gets a new proposed-plan card.
-   */
-  lastKnownProposedPlanMarkdown: string | undefined;
-  lastKnownProposedPlanTurnId: TurnId | undefined;
-  /** True after enter_plan_mode until the turn ends or exit_plan_mode resolves. */
-  planModeActive: boolean;
-  activeTurnId: TurnId | undefined;
-  /** Turns already interrupted; late prompt RPCs must not resurrect them. */
-  interruptedTurnIds: Set<TurnId>;
-  /** Number of sendTurn prompts currently in flight or being prepared.
-   * >0 means a turn is actively running, so a new sendTurn is a steer that
-   * continues it, and only the last remaining prompt settles the turn. */
-  promptsInFlight: number;
-  readonly livenessSignals: Queue.Queue<GrokTurnLivenessSignal>;
-  livenessTurnId: TurnId | undefined;
-  lastTurnActivityAtNanos: bigint | undefined;
-  readonly activeToolCallIds: Set<string>;
-  livenessUpdatesInFlight: number;
-  /** Prompt RPCs that returned before their turn settlement acquired the lock. */
-  promptResponsesReady: number;
-  currentModelId: string | undefined;
-  currentReasoningEffort: string | undefined;
-  stopped: boolean;
-}
-
-function settlePendingApprovalsAsCancelled(
-  pendingApprovals: ReadonlyMap<ApprovalRequestId, PendingApproval>,
-): Effect.Effect<void> {
-  return Effect.forEach(
-    Array.from(pendingApprovals.values()),
-    (pending) => Deferred.succeed(pending.decision, "cancel").pipe(Effect.ignore),
-    { discard: true },
-  );
-}
-
-function settlePendingUserInputsAsCancelled(
-  pendingUserInputs: ReadonlyMap<ApprovalRequestId, PendingUserInput>,
-): Effect.Effect<void> {
-  return Effect.forEach(
-    Array.from(pendingUserInputs.values()),
-    (pending) => Deferred.succeed(pending.resolution, { _tag: "cancelled" }).pipe(Effect.ignore),
-    { discard: true },
-  );
-}
-
-function appendPromptResultToTurn(
-  ctx: GrokSessionContext,
-  turnId: TurnId,
-  promptParts: ReadonlyArray<EffectAcpSchema.ContentBlock>,
-  result: EffectAcpSchema.PromptResponse,
-): void {
-  const existingTurnRecord = ctx.turns.find((turn) => turn.id === turnId);
-  ctx.turns = existingTurnRecord
-    ? ctx.turns.map((turn) =>
-        turn.id === turnId
-          ? { ...turn, items: [...turn.items, { prompt: promptParts, result }] }
-          : turn,
-      )
-    : [...ctx.turns, { id: turnId, items: [{ prompt: promptParts, result }] }];
-}
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-
-const resolveNotificationTurnId = (ctx: GrokSessionContext): TurnId | undefined => ctx.activeTurnId;
-
-const resolveCallbackTurnId = (ctx: GrokSessionContext): TurnId | undefined => ctx.activeTurnId;
-
-function clearProposedPlanFallback(ctx: GrokSessionContext): void {
-  ctx.lastKnownProposedPlanMarkdown = undefined;
-  ctx.lastKnownProposedPlanTurnId = undefined;
-  ctx.planModeActive = false;
-}
-
-/** Detect Grok's enter_plan_mode tool call from ACP tool state. */
-export function isGrokEnterPlanModeToolCall(toolCall: {
-  readonly title?: string;
-  readonly data: Record<string, unknown>;
-}): boolean {
-  const title = toolCall.title?.trim().toLowerCase() ?? "";
-  if (
-    title === "enter_plan_mode" ||
-    title === "plan: enter" ||
-    title === "plan mode entered" ||
-    title.includes("enter_plan_mode")
-  ) {
-    return true;
-  }
-  const rawInput = toolCall.data.rawInput;
-  if (isRecord(rawInput) && rawInput.variant === "EnterPlanMode") {
-    return true;
-  }
-  return false;
-}
-
-/** Failed enter_plan_mode must not leave planModeActive stuck on. */
-export function nextGrokPlanModeActive(
-  currentlyActive: boolean,
-  toolCall: {
-    readonly title?: string;
-    readonly status?: "pending" | "inProgress" | "completed" | "failed";
-    readonly data: Record<string, unknown>;
-  },
-): boolean {
-  if (!isGrokEnterPlanModeToolCall(toolCall)) {
-    return currentlyActive;
-  }
-  if (toolCall.status === "failed") {
-    return false;
-  }
-  if (toolCall.status === "completed" || toolCall.status === "inProgress") {
-    return true;
-  }
-  return currentlyActive;
-}
-
-const resolveSessionCallbackTurnId = (
-  sessions: ReadonlyMap<ThreadId, GrokSessionContext>,
-  threadId: ThreadId,
-): TurnId | undefined => {
-  const ctx = sessions.get(threadId);
-  return ctx ? resolveCallbackTurnId(ctx) : undefined;
-};
-
-function parseGrokResume(raw: unknown): { sessionId: string } | undefined {
-  if (!isRecord(raw)) return undefined;
-  if (raw.schemaVersion !== GROK_RESUME_VERSION) return undefined;
-  if (typeof raw.sessionId !== "string" || !raw.sessionId.trim()) return undefined;
-  return { sessionId: raw.sessionId.trim() };
-}
-
-export function selectGrokPermissionOptionId(
-  request: EffectAcpSchema.RequestPermissionRequest,
-  decision: Exclude<ProviderApprovalDecision, "cancel">,
-): string | undefined {
-  const preferredKind =
-    decision === "acceptForSession"
-      ? "allow_always"
-      : decision === "accept"
-        ? "allow_once"
-        : "reject_once";
-  const preferred = request.options.find((entry) => entry.kind === preferredKind);
-  const preferredId = preferred?.optionId.trim();
-  if (preferredId) {
-    return preferredId;
-  }
-  // Grok 4.6 often omits allow_always. T3 still offers "Always allow this session".
-  if (decision === "acceptForSession") {
-    const once = request.options.find((entry) => entry.kind === "allow_once");
-    const onceId = once?.optionId.trim();
-    if (onceId) {
-      return onceId;
-    }
-  }
-  return undefined;
-}
-
-function selectAutoApprovedPermissionOption(
-  request: EffectAcpSchema.RequestPermissionRequest,
-): string | undefined {
-  return (
-    selectGrokPermissionOptionId(request, "acceptForSession") ??
-    selectGrokPermissionOptionId(request, "accept")
-  );
-}
-
-function completedStopReasonFromPromptResponse(
-  response: EffectAcpSchema.PromptResponse | undefined,
-): EffectAcpSchema.StopReason | null {
-  if (response === undefined || promptResponseHasMissingXAiStopReason(response)) {
-    return null;
-  }
-  return response.stopReason;
-}
-
-export function grokPromptSettlementBelongsToContext(input: {
-  readonly liveAcpSessionId: string;
-  readonly expectedAcpSessionId: string;
-  readonly liveActiveTurnId: TurnId | undefined;
-  readonly liveSessionActiveTurnId: TurnId | undefined;
-  readonly turnId: TurnId;
-}): boolean {
-  return (
-    input.liveAcpSessionId === input.expectedAcpSessionId &&
-    (input.liveActiveTurnId === input.turnId || input.liveSessionActiveTurnId === input.turnId)
-  );
-}
-
-export function makeGrokAdapter(grokSettings: GrokSettings, options?: GrokAdapterLiveOptions) {
-  return Effect.gen(function* () {
-    const boundInstanceId = options?.instanceId ?? ProviderInstanceId.make("grok");
-    const fileSystem = yield* FileSystem.FileSystem;
-    const path = yield* Path.Path;
-    const childProcessSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
-    const serverConfig = yield* Effect.service(ServerConfig);
-    const crypto = yield* Crypto.Crypto;
-    const nativeEventLogger =
-      options?.nativeEventLogger ??
-      (options?.nativeEventLogPath !== undefined
-        ? yield* makeEventNdjsonLogger(options.nativeEventLogPath, { stream: "native" })
-        : undefined);
-    const managedNativeEventLogger =
-      options?.nativeEventLogger === undefined ? nativeEventLogger : undefined;
-    const makeAcpNativeLoggers = yield* makeAcpNativeLoggerFactory();
-    const hostPlatform = yield* HostProcessPlatform;
-    const hostEnvironment = yield* HostProcessEnvironment;
-    const grokPlanPathHost = {
-      platform: hostPlatform,
-      environment: options?.environment ?? hostEnvironment,
-    };
-
-    const sessions = new Map<ThreadId, GrokSessionContext>();
-    const threadLocksRef = yield* SynchronizedRef.make(new Map<string, Semaphore.Semaphore>());
-    const runtimeEventPubSub = yield* PubSub.unbounded<ProviderRuntimeEvent>();
-    const requestedTurnInactivityTimeoutMs = options?.turnInactivityTimeoutMs;
-    const turnInactivityTimeoutMs =
-      typeof requestedTurnInactivityTimeoutMs === "number" &&
-      Number.isFinite(requestedTurnInactivityTimeoutMs)
-        ? Math.max(1, Math.floor(requestedTurnInactivityTimeoutMs))
-        : DEFAULT_GROK_TURN_INACTIVITY_TIMEOUT_MS;
-    const turnInactivityTimeoutNanos = BigInt(turnInactivityTimeoutMs) * NANOS_PER_MILLI;
-    const requestedActiveToolInactivityTimeoutMs = options?.activeToolInactivityTimeoutMs;
-    const activeToolInactivityTimeoutMs =
-      typeof requestedActiveToolInactivityTimeoutMs === "number" &&
-      Number.isFinite(requestedActiveToolInactivityTimeoutMs)
-        ? Math.max(1, Math.floor(requestedActiveToolInactivityTimeoutMs))
-        : DEFAULT_GROK_ACTIVE_TOOL_INACTIVITY_TIMEOUT_MS;
-    const activeToolInactivityTimeoutNanos =
-      BigInt(activeToolInactivityTimeoutMs) * NANOS_PER_MILLI;
-
-    const nowIso = Effect.map(DateTime.now, DateTime.formatIso);
-    const randomUUIDv4 = crypto.randomUUIDv4.pipe(
-      Effect.mapError(
-        (cause) =>
-          new ProviderAdapterRequestError({
-            provider: PROVIDER,
-            method: "crypto/randomUUIDv4",
-            detail: "Failed to generate Grok runtime identifier.",
-            cause,
-          }),
-      ),
-    );
-    const nextEventId = Effect.map(randomUUIDv4, (id) => EventId.make(id));
-    const makeEventStamp = () => Effect.all({ eventId: nextEventId, createdAt: nowIso });
-    const mapAcpCallbackFailure = <A, E, R>(effect: Effect.Effect<A, E, R>) =>
-      effect.pipe(
-        Effect.mapError(
-          (cause) =>
-            new EffectAcpErrors.AcpTransportError({
-              detail: "Failed to process Grok ACP callback.",
-              cause,
-            }),
-        ),
-      );
-
-    const offerRuntimeEvent = (event: ProviderRuntimeEvent) =>
-      PubSub.publish(runtimeEventPubSub, event).pipe(Effect.asVoid);
-
-    const getThreadSemaphore = (threadId: string) =>
-      SynchronizedRef.modifyEffect(threadLocksRef, (current) => {
-        const existing: Option.Option<Semaphore.Semaphore> = Option.fromNullishOr(
-          current.get(threadId),
-        );
-        return Option.match(existing, {
-          onNone: () =>
-            Semaphore.make(1).pipe(
-              Effect.map((semaphore) => {
-                const next = new Map(current);
-                next.set(threadId, semaphore);
-                return [semaphore, next] as const;
-              }),
-            ),
-          onSome: (semaphore) => Effect.succeed([semaphore, current] as const),
-        });
-      });
-
-    const withThreadLock = <A, E, R>(threadId: string, effect: Effect.Effect<A, E, R>) =>
-      Effect.flatMap(getThreadSemaphore(threadId), (semaphore) => semaphore.withPermit(effect));
-
-    const signalTurnLiveness = (ctx: GrokSessionContext, turnId: TurnId) =>
-      Queue.offer(ctx.livenessSignals, { turnId }).pipe(Effect.asVoid);
-
-    const beginTurnLiveness = (ctx: GrokSessionContext, turnId: TurnId) =>
-      Effect.sync(() => {
-        ctx.livenessTurnId = turnId;
-        // Do not start a deadline until ACP has made observable progress.
-        // Grok's private reasoning phase is not present in the ACP stream.
-        ctx.lastTurnActivityAtNanos = undefined;
-        ctx.activeToolCallIds.clear();
-      });
-
-    const clearTurnLiveness = (ctx: GrokSessionContext) => {
-      const turnId = ctx.livenessTurnId;
-      ctx.livenessTurnId = undefined;
-      ctx.lastTurnActivityAtNanos = undefined;
-      ctx.activeToolCallIds.clear();
-      ctx.livenessUpdatesInFlight = 0;
-      ctx.promptResponsesReady = 0;
-      return turnId === undefined ? Effect.void : signalTurnLiveness(ctx, turnId);
-    };
-
-    const recordTurnActivity = Effect.fn("GrokAdapter.recordTurnActivity")(function* (
-      ctx: GrokSessionContext,
-      turnId: TurnId,
-      event: Extract<
-        AcpSessionRuntime.AcpSessionRuntimeEvent,
-        {
-          _tag:
-            | "AssistantItemStarted"
-            | "AssistantItemCompleted"
-            | "PlanUpdated"
-            | "ToolCallUpdated"
-            | "ContentDelta";
-        }
-      >,
-    ) {
-      if (
-        ctx.livenessTurnId !== turnId ||
-        (event._tag === "ContentDelta" && event.text.length === 0)
-      ) {
-        return;
-      }
-      ctx.livenessUpdatesInFlight += 1;
-      try {
-        const activityAtNanos = yield* Clock.monotonicTimeNanos;
-        if (ctx.livenessTurnId !== turnId || ctx.interruptedTurnIds.has(turnId)) {
-          return;
-        }
-        if (event._tag === "ToolCallUpdated") {
-          if (event.toolCall.status === "completed" || event.toolCall.status === "failed") {
-            ctx.activeToolCallIds.delete(event.toolCall.toolCallId);
-          } else {
-            // A tool update without a terminal status receives a longer
-            // deadline so a long-running tool is not mistaken for a stall.
-            ctx.activeToolCallIds.add(event.toolCall.toolCallId);
-          }
-        }
-        ctx.lastTurnActivityAtNanos = activityAtNanos;
-      } finally {
-        // Decrement before signaling. The watchdog treats in-flight updates as a
-        // pause; if it consumed a signal while the counter was still > 0 it would
-        // wait on the next take with no follow-up wake after this decrement.
-        ctx.livenessUpdatesInFlight = Math.max(0, ctx.livenessUpdatesInFlight - 1);
-        yield* signalTurnLiveness(ctx, turnId);
-      }
-    });
-
-    const hasLivenessPause = (ctx: GrokSessionContext) =>
-      ctx.pendingApprovals.size > 0 ||
-      ctx.pendingUserInputs.size > 0 ||
-      ctx.livenessUpdatesInFlight > 0;
-
-    const livenessTimeoutFor = (ctx: GrokSessionContext) =>
-      ctx.activeToolCallIds.size > 0
-        ? {
-            milliseconds: activeToolInactivityTimeoutMs,
-            nanos: activeToolInactivityTimeoutNanos,
-          }
-        : { milliseconds: turnInactivityTimeoutMs, nanos: turnInactivityTimeoutNanos };
-
-    const signalSessionTurnLiveness = (threadId: ThreadId, turnId: TurnId | undefined) => {
-      const ctx = sessions.get(threadId);
-      return ctx && turnId !== undefined ? signalTurnLiveness(ctx, turnId) : Effect.void;
-    };
-
-    const resumeSessionTurnLiveness = Effect.fn("GrokAdapter.resumeSessionTurnLiveness")(function* (
-      threadId: ThreadId,
-      turnId: TurnId | undefined,
-    ) {
-      const ctx = sessions.get(threadId);
-      if (!ctx || turnId === undefined || ctx.livenessTurnId !== turnId) {
-        return;
-      }
-      // An approval or user-input wait can last longer than the watchdog.
-      // Its resolution gives the provider a fresh window to resume output.
-      ctx.lastTurnActivityAtNanos = yield* Clock.monotonicTimeNanos;
-      yield* signalTurnLiveness(ctx, turnId);
-    });
-
-    const refreshSessionTurnLiveness = Effect.fn("GrokAdapter.refreshSessionTurnLiveness")(
-      function* (threadId: ThreadId, turnId: TurnId | undefined) {
-        const ctx = sessions.get(threadId);
-        if (
-          !ctx ||
-          turnId === undefined ||
-          ctx.livenessTurnId !== turnId ||
-          ctx.lastTurnActivityAtNanos === undefined
-        ) {
-          return;
-        }
-        ctx.lastTurnActivityAtNanos = yield* Clock.monotonicTimeNanos;
-        yield* signalTurnLiveness(ctx, turnId);
-      },
-    );
-
-    const markPromptResponseReady = Effect.fn("GrokAdapter.markPromptResponseReady")(function* (
-      threadId: ThreadId,
-      acpSessionId: string,
-      turnId: TurnId,
-    ) {
-      const ctx = sessions.get(threadId);
-      if (
-        ctx &&
-        ctx.acpSessionId === acpSessionId &&
-        !ctx.stopped &&
-        !ctx.interruptedTurnIds.has(turnId) &&
-        ctx.livenessTurnId === turnId &&
-        ctx.activeTurnId === turnId &&
-        ctx.session.activeTurnId === turnId
-      ) {
-        ctx.promptResponsesReady += 1;
-        yield* signalTurnLiveness(ctx, turnId);
-      }
-    });
-
-    const consumePromptResponseReady = (ctx: GrokSessionContext) => {
-      ctx.promptResponsesReady = Math.max(0, ctx.promptResponsesReady - 1);
-    };
-
-    const settlePromptInFlight = (
-      threadId: ThreadId,
-      turnId: TurnId,
-      expectedAcpSessionId: string,
-      options?: {
-        readonly errorMessage?: string;
-        readonly completedStopReason?: EffectAcpSchema.StopReason | null;
-        readonly emitTurnCompletion?: boolean;
-        /** Interrupt/cancel: drop every outstanding prompt slot and settle once. */
-        readonly settleAllPrompts?: boolean;
-      },
-    ) =>
-      Effect.gen(function* () {
-        const liveCtx = sessions.get(threadId);
-        if (!liveCtx) {
-          return;
-        }
-        const settlementBelongsToLiveContext = grokPromptSettlementBelongsToContext({
-          liveAcpSessionId: liveCtx.acpSessionId,
-          expectedAcpSessionId,
-          liveActiveTurnId: liveCtx.activeTurnId,
-          liveSessionActiveTurnId: liveCtx.session.activeTurnId,
-          turnId,
-        });
-        if (!settlementBelongsToLiveContext) {
-          // interruptTurn already consumed every prompt slot for this turn. A
-          // late prompt result must neither emit a second terminal event nor
-          // consume a slot belonging to a newer turn on the same ACP session.
-          if (
-            liveCtx.acpSessionId !== expectedAcpSessionId ||
-            liveCtx.interruptedTurnIds.has(turnId)
-          ) {
-            return;
-          }
-          if (options?.emitTurnCompletion !== false) {
-            if (options?.errorMessage !== undefined) {
-              yield* offerRuntimeEvent({
-                type: "turn.completed",
-                ...(yield* makeEventStamp()),
-                provider: PROVIDER,
-                threadId,
-                turnId,
-                payload: {
-                  state: "failed",
-                  errorMessage: options.errorMessage,
-                },
-              });
-            } else if (options?.completedStopReason !== undefined) {
-              yield* offerRuntimeEvent({
-                type: "turn.completed",
-                ...(yield* makeEventStamp()),
-                provider: PROVIDER,
-                threadId,
-                turnId,
-                payload: {
-                  state: options.completedStopReason === "cancelled" ? "cancelled" : "completed",
-                  stopReason: options.completedStopReason ?? null,
-                },
-              });
-            }
-          }
-          return;
-        }
-        let settleTurnId = turnId;
-        if (options?.settleAllPrompts) {
-          liveCtx.promptsInFlight = 0;
-          if (liveCtx.activeTurnId !== turnId && liveCtx.session.activeTurnId !== turnId) {
-            const fallbackTurnId = liveCtx.activeTurnId ?? liveCtx.session.activeTurnId;
-            if (!fallbackTurnId) {
-              if (liveCtx.session.status === "running" || liveCtx.session.status === "connecting") {
-                const updatedAt = yield* nowIso;
-                const { activeTurnId: _activeTurnId, ...readySession } = liveCtx.session;
-                liveCtx.activeTurnId = undefined;
-                liveCtx.session = {
-                  ...readySession,
-                  status: "ready",
-                  updatedAt,
-                };
-              }
-              yield* clearTurnLiveness(liveCtx);
-              return;
-            }
-            settleTurnId = fallbackTurnId;
-          }
-        } else {
-          const remainingPrompts = Math.max(0, liveCtx.promptsInFlight - 1);
-          if (
-            remainingPrompts > 0 ||
-            liveCtx.activeTurnId !== settleTurnId ||
-            liveCtx.session.activeTurnId !== settleTurnId
-          ) {
-            liveCtx.promptsInFlight = remainingPrompts;
-            return;
-          }
-          liveCtx.promptsInFlight = remainingPrompts;
-        }
-        yield* clearTurnLiveness(liveCtx);
-        const updatedAt = yield* nowIso;
-        const canEmitTurnCompletion =
-          liveCtx.session.status === "running" || liveCtx.session.status === "connecting";
-        const shouldEmitFailedTurn = options?.errorMessage !== undefined && canEmitTurnCompletion;
-        const shouldEmitCompletedTurn =
-          options?.completedStopReason !== undefined && canEmitTurnCompletion;
-        const { activeTurnId: _activeTurnId, ...readySession } = liveCtx.session;
-        liveCtx.activeTurnId = undefined;
-        // Drop turn-scoped plan fallback so a later empty exit_plan cannot
-        // resurrect this turn's markdown as a fresh proposal.
-        clearProposedPlanFallback(liveCtx);
-        liveCtx.session = {
-          ...readySession,
-          status: "ready",
-          updatedAt,
-        };
-        if (options?.emitTurnCompletion === false) {
-          return;
-        }
-        if (shouldEmitFailedTurn) {
-          yield* offerRuntimeEvent({
-            type: "turn.completed",
-            ...(yield* makeEventStamp()),
-            provider: PROVIDER,
-            threadId,
-            turnId: settleTurnId,
-            payload: {
-              state: "failed",
-              errorMessage: options.errorMessage,
-            },
-          });
-        } else if (shouldEmitCompletedTurn) {
-          yield* offerRuntimeEvent({
-            type: "turn.completed",
-            ...(yield* makeEventStamp()),
-            provider: PROVIDER,
-            threadId,
-            turnId: settleTurnId,
-            payload: {
-              state: options.completedStopReason === "cancelled" ? "cancelled" : "completed",
-              stopReason: options.completedStopReason ?? null,
-            },
-          });
-        }
-      });
-
-    const isLiveTurn = (ctx: GrokSessionContext, turnId: TurnId) =>
-      ctx.promptsInFlight > 0 &&
-      ctx.promptsInFlight > ctx.promptResponsesReady &&
-      ctx.activeTurnId === turnId &&
-      ctx.session.activeTurnId === turnId &&
-      (ctx.session.status === "running" || ctx.session.status === "connecting");
-
-    const settleStalledTurn = Effect.fn("GrokAdapter.settleStalledTurn")(function* (
-      ctx: GrokSessionContext,
-      turnId: TurnId,
-    ) {
-      return yield* withThreadLock(
-        ctx.threadId,
-        Effect.gen(function* () {
-          const liveCtx = sessions.get(ctx.threadId);
-          if (
-            liveCtx !== ctx ||
-            ctx.stopped ||
-            !isLiveTurn(ctx, turnId) ||
-            ctx.interruptedTurnIds.has(turnId) ||
-            hasLivenessPause(ctx)
-          ) {
-            return;
-          }
-          const lastActivityAtNanos = ctx.lastTurnActivityAtNanos;
-          if (lastActivityAtNanos === undefined) {
-            return;
-          }
-          const nowNanos = yield* Clock.monotonicTimeNanos;
-          if (
-            ctx.interruptedTurnIds.has(turnId) ||
-            !isLiveTurn(ctx, turnId) ||
-            hasLivenessPause(ctx) ||
-            nowNanos - lastActivityAtNanos < livenessTimeoutFor(ctx).nanos
-          ) {
-            return;
-          }
-
-          // Mark before cancel/drain so notifications already in flight finish
-          // before the terminal event, while late notifications are dropped.
-          ctx.interruptedTurnIds.add(turnId);
-          yield* Effect.ignore(
-            ctx.acp.cancel.pipe(
-              Effect.mapError((error) =>
-                mapAcpToAdapterError(PROVIDER, ctx.threadId, "session/cancel", error),
-              ),
-            ),
-          );
-          yield* Effect.ignore(ctx.acp.drainEvents);
-          yield* settlePromptInFlight(ctx.threadId, turnId, ctx.acpSessionId, {
-            errorMessage: `Grok ACP turn stalled without content or tool progress for ${livenessTimeoutFor(ctx).milliseconds}ms.`,
-            settleAllPrompts: true,
-          });
-        }),
-      );
-    });
-
-    const runTurnLivenessWatchdog = Effect.fn("GrokAdapter.runTurnLivenessWatchdog")(
-      function* (ctx: GrokSessionContext) {
-        while (true) {
-          if (ctx.stopped) {
-            return;
-          }
-          const turnId = ctx.livenessTurnId;
-          if (
-            turnId === undefined ||
-            ctx.interruptedTurnIds.has(turnId) ||
-            !isLiveTurn(ctx, turnId) ||
-            hasLivenessPause(ctx)
-          ) {
-            yield* Queue.take(ctx.livenessSignals);
-            continue;
-          }
-
-          const lastActivityAtNanos = ctx.lastTurnActivityAtNanos;
-          if (lastActivityAtNanos === undefined) {
-            yield* Queue.take(ctx.livenessSignals);
-            continue;
-          }
-          const nowNanos = yield* Clock.monotonicTimeNanos;
-          const remainingNanos = livenessTimeoutFor(ctx).nanos - (nowNanos - lastActivityAtNanos);
-          if (remainingNanos <= 0n) {
-            yield* settleStalledTurn(ctx, turnId);
-            continue;
-          }
-
-          const wakeReason = yield* Effect.raceFirst(
-            Effect.sleep(Duration.nanos(remainingNanos)).pipe(Effect.as("timeout" as const)),
-            Queue.take(ctx.livenessSignals).pipe(Effect.as("activity" as const)),
-          );
-          if (wakeReason === "timeout") {
-            yield* settleStalledTurn(ctx, turnId);
-          }
-        }
-      },
-      Effect.catch(() => Effect.void),
-    );
-
-    const logNative = (threadId: ThreadId, method: string, payload: unknown) =>
-      Effect.gen(function* () {
-        if (!nativeEventLogger) return;
-        const observedAt = yield* nowIso;
-        yield* nativeEventLogger.write(
-          {
-            observedAt,
-            event: {
-              id: yield* randomUUIDv4,
-              kind: "notification",
-              provider: PROVIDER,
-              createdAt: observedAt,
-              method,
-              threadId,
-              payload,
-            },
-          },
-          threadId,
-        );
-      }).pipe(
-        Effect.catchCause((cause) =>
-          Effect.logWarning("Failed to write native Grok notification log.", {
-            cause,
-            threadId,
-            method,
-          }),
-        ),
-      );
-
-    const emitPlanUpdate = (
-      ctx: GrokSessionContext,
-      turnId: TurnId | undefined,
-      stamp: { readonly eventId: EventId; readonly createdAt: string },
-      payload: {
-        readonly explanation?: string | null;
-        readonly plan: ReadonlyArray<{
-          readonly step: string;
-          readonly status: "pending" | "inProgress" | "completed";
-        }>;
-      },
-      rawPayload: unknown,
-      method: string,
-    ) =>
-      Effect.gen(function* () {
-        const fingerprint = `${turnId ?? "no-turn"}:${encodeJsonStringForDiagnostics(payload) ?? "[unserializable payload]"}`;
-        if (ctx.lastPlanFingerprint === fingerprint) {
-          return;
-        }
-        ctx.lastPlanFingerprint = fingerprint;
-        yield* offerRuntimeEvent(
-          makeAcpPlanUpdatedEvent({
-            stamp,
-            provider: PROVIDER,
-            threadId: ctx.threadId,
-            turnId,
-            payload,
-            source: "acp.jsonrpc",
-            method,
-            rawPayload,
-          }),
-        );
-      });
-
-    /** Surface Grok plan.md as T3's proposed-plan card (while writing + on exit). */
-    const emitProposedPlanCompleted = (
-      ctx: GrokSessionContext,
-      turnId: TurnId | undefined,
-      stamp: { readonly eventId: EventId; readonly createdAt: string },
-      planMarkdown: string,
-      raw: { readonly method: string; readonly payload: unknown },
-    ) =>
-      Effect.gen(function* () {
-        const trimmed = planMarkdown.trim();
-        if (trimmed.length === 0) {
-          ctx.lastKnownProposedPlanMarkdown = "";
-          ctx.lastKnownProposedPlanTurnId = turnId;
-          return;
-        }
-        // Turn-scoped dedupe: identical text on a later turn must still emit.
-        if (
-          ctx.lastKnownProposedPlanMarkdown === trimmed &&
-          ctx.lastKnownProposedPlanTurnId === turnId
-        ) {
-          return;
-        }
-        ctx.lastKnownProposedPlanMarkdown = trimmed;
-        ctx.lastKnownProposedPlanTurnId = turnId;
-        yield* offerRuntimeEvent({
-          type: "turn.proposed.completed",
-          ...stamp,
-          provider: PROVIDER,
-          threadId: ctx.threadId,
-          turnId,
-          payload: { planMarkdown: trimmed },
-          raw: {
-            source: "acp.grok.extension",
-            method: raw.method,
-            payload: raw.payload,
-          },
-        });
-      });
-
-    const requireSession = (
-      threadId: ThreadId,
-    ): Effect.Effect<GrokSessionContext, ProviderAdapterSessionNotFoundError> => {
-      const ctx = sessions.get(threadId);
-      if (!ctx || ctx.stopped) {
-        return Effect.fail(
-          new ProviderAdapterSessionNotFoundError({ provider: PROVIDER, threadId }),
-        );
-      }
-      return Effect.succeed(ctx);
-    };
-
-    const stopSessionInternal = (ctx: GrokSessionContext) =>
-      Effect.gen(function* () {
-        if (ctx.stopped) return;
-        ctx.stopped = true;
-        yield* settlePendingApprovalsAsCancelled(ctx.pendingApprovals);
-        yield* settlePendingUserInputsAsCancelled(ctx.pendingUserInputs);
-        if (ctx.notificationFiber) {
-          yield* Fiber.interrupt(ctx.notificationFiber);
-        }
-        yield* Effect.ignore(Scope.close(ctx.scope, Exit.void));
-        sessions.delete(ctx.threadId);
-        yield* offerRuntimeEvent({
-          type: "session.exited",
-          ...(yield* makeEventStamp()),
-          provider: PROVIDER,
-          threadId: ctx.threadId,
-          payload: { exitKind: "graceful" },
-        });
-      });
-
-    const startSession: GrokAdapterShape["startSession"] = (input) =>
-      withThreadLock(
-        input.threadId,
-        Effect.gen(function* () {
-          if (input.provider !== undefined && input.provider !== PROVIDER) {
-            return yield* new ProviderAdapterValidationError({
-              provider: PROVIDER,
-              operation: "startSession",
-              issue: `Expected provider '${PROVIDER}' but received '${input.provider}'.`,
-            });
-          }
-          if (!input.cwd?.trim()) {
-            return yield* new ProviderAdapterValidationError({
-              provider: PROVIDER,
-              operation: "startSession",
-              issue: "cwd is required and must be non-empty.",
-            });
-          }
-
-          const cwd = path.resolve(input.cwd.trim());
-          const grokModelSelection =
-            input.modelSelection?.instanceId === boundInstanceId ? input.modelSelection : undefined;
-          const existing = sessions.get(input.threadId);
-          if (existing && !existing.stopped) {
-            yield* stopSessionInternal(existing);
-          }
-
-          const pendingApprovals = new Map<ApprovalRequestId, PendingApproval>();
-          const pendingUserInputs = new Map<ApprovalRequestId, PendingUserInput>();
-          const sessionApprovedOperations = new Set<string>();
-          const sessionScope = yield* Scope.make("sequential");
-          let sessionScopeTransferred = false;
-          yield* Effect.addFinalizer(() =>
-            sessionScopeTransferred ? Effect.void : Scope.close(sessionScope, Exit.void),
-          );
-
-          const resumeSessionId = parseGrokResume(input.resumeCursor)?.sessionId;
-          const acpNativeLoggers = makeAcpNativeLoggers({
-            nativeEventLogger,
-            provider: PROVIDER,
-            threadId: input.threadId,
-          });
-
-          const mcpSession = McpProviderSession.readMcpProviderSession(input.threadId);
-          const acp = yield* makeGrokAcpRuntime({
-            grokSettings,
-            ...(options?.environment ? { environment: options.environment } : {}),
-            childProcessSpawner,
-            cwd,
-            runtimeMode: input.runtimeMode,
-            ...(resumeSessionId ? { resumeSessionId } : {}),
-            clientInfo: { name: "t3-code", version: "0.0.0" },
-            ...(mcpSession
-              ? {
-                  mcpServers: [
-                    {
-                      type: "http" as const,
-                      name: "t3-code",
-                      url: mcpSession.endpoint,
-                      headers: [
-                        {
-                          name: "Authorization",
-                          value: mcpSession.authorizationHeader,
-                        },
-                      ],
-                    },
-                  ],
-                }
-              : {}),
-            ...acpNativeLoggers,
-          }).pipe(
-            Effect.provideService(Crypto.Crypto, crypto),
-            Effect.provideService(Scope.Scope, sessionScope),
-            Effect.mapError(
-              (cause) =>
-                new ProviderAdapterProcessError({
-                  provider: PROVIDER,
-                  threadId: input.threadId,
-                  detail: cause.message,
-                  cause,
-                }),
-            ),
-          );
-          const started = yield* Effect.gen(function* () {
-            yield* Effect.forEach(
-              ["x.ai/ask_user_question", "_x.ai/ask_user_question"] as const,
-              (method) =>
-                acp.handleExtRequest(method, XAiAskUserQuestionRequest, (params) =>
-                  mapAcpCallbackFailure(
-                    Effect.gen(function* () {
-                      yield* logNative(input.threadId, method, params);
-                      const requestId = ApprovalRequestId.make(yield* randomUUIDv4);
-                      const runtimeRequestId = RuntimeRequestId.make(requestId);
-                      const resolution = yield* Deferred.make<PendingUserInputResolution>();
-                      const turnId = resolveSessionCallbackTurnId(sessions, input.threadId);
-                      pendingUserInputs.set(requestId, { resolution });
-                      yield* signalSessionTurnLiveness(input.threadId, turnId);
-                      yield* offerRuntimeEvent({
-                        type: "user-input.requested",
-                        ...(yield* makeEventStamp()),
-                        provider: PROVIDER,
-                        threadId: input.threadId,
-                        turnId,
-                        requestId: runtimeRequestId,
-                        payload: { questions: extractXAiAskUserQuestions(params) },
-                        raw: {
-                          source: "acp.grok.extension",
-                          method,
-                          payload: params,
-                        },
-                      });
-                      const resolved = yield* Deferred.await(resolution);
-                      pendingUserInputs.delete(requestId);
-                      yield* resumeSessionTurnLiveness(input.threadId, turnId);
-                      const resolvedAnswers = resolved._tag === "answered" ? resolved.answers : {};
-                      yield* offerRuntimeEvent({
-                        type: "user-input.resolved",
-                        ...(yield* makeEventStamp()),
-                        provider: PROVIDER,
-                        threadId: input.threadId,
-                        turnId,
-                        requestId: runtimeRequestId,
-                        payload: { answers: resolvedAnswers },
-                        raw: {
-                          source: "acp.grok.extension",
-                          method,
-                          payload: params,
-                        },
-                      });
-                      switch (resolved._tag) {
-                        case "answered":
-                          return makeXAiAskUserQuestionResponse(params, resolved.answers);
-                        case "cancelled":
-                          return makeXAiAskUserQuestionCancelledResponse();
-                      }
-                    }),
-                  ),
-                ),
-              { discard: true },
-            );
-            // Grok intercepts exit_plan_mode and reverse-requests client approval.
-            // Capture plan into T3 proposed-plan UI and abandon the native gate so
-            // the turn does not hang (Claude ExitPlanMode pattern).
-            yield* Effect.forEach(
-              ["x.ai/exit_plan_mode", "_x.ai/exit_plan_mode"] as const,
-              (method) =>
-                acp.handleExtRequest(method, XAiExitPlanModeRequest, (params) =>
-                  mapAcpCallbackFailure(
-                    Effect.gen(function* () {
-                      yield* logNative(input.threadId, method, params);
-                      const turnId = resolveSessionCallbackTurnId(sessions, input.threadId);
-                      const ctx = sessions.get(input.threadId);
-                      const planMarkdown = extractXAiExitPlanMarkdown(
-                        params,
-                        ctx?.lastKnownProposedPlanMarkdown,
-                      );
-                      if (ctx) {
-                        yield* emitProposedPlanCompleted(
-                          ctx,
-                          turnId,
-                          yield* makeEventStamp(),
-                          planMarkdown,
-                          { method, payload: params },
-                        );
-                        ctx.planModeActive = false;
-                      } else {
-                        yield* offerRuntimeEvent({
-                          type: "turn.proposed.completed",
-                          ...(yield* makeEventStamp()),
-                          provider: PROVIDER,
-                          threadId: input.threadId,
-                          turnId,
-                          payload: { planMarkdown },
-                          raw: {
-                            source: "acp.grok.extension",
-                            method,
-                            payload: params,
-                          },
-                        });
-                      }
-                      return makeXAiExitPlanModeCapturedResponse();
-                    }),
-                  ),
-                ),
-              { discard: true },
-            );
-            yield* acp.handleRequestPermission((params) =>
-              mapAcpCallbackFailure(
-                Effect.gen(function* () {
-                  yield* logNative(input.threadId, "session/request_permission", params);
-                  const permissionRequest = parsePermissionRequest(params);
-                  const command = permissionRequest.toolCall?.command;
-                  const { kind, title, rawInput, locations } = params.toolCall;
-                  let operationInput = rawInput;
-                  if (isRecord(rawInput) && rawInput.variant === "Bash") {
-                    const { description: _description, ...shellInput } = rawInput;
-                    operationInput = shellInput;
-                  }
-                  // Remember the operation, not the tool-call id or every future tool.
-                  // Generic titles without input cannot identify an operation safely.
-                  const approvalKey =
-                    command || (isRecord(rawInput) && Object.keys(rawInput).length > 0)
-                      ? stableStringify({ kind, title, command, input: operationInput, locations })
-                      : undefined;
-                  const alreadyApproved =
-                    approvalKey !== undefined && sessionApprovedOperations.has(approvalKey);
-                  if (input.runtimeMode === "full-access" || alreadyApproved) {
-                    const autoApprovedOptionId =
-                      input.runtimeMode === "full-access"
-                        ? selectAutoApprovedPermissionOption(params)
-                        : selectGrokPermissionOptionId(params, "accept");
-                    if (autoApprovedOptionId !== undefined) {
-                      return {
-                        outcome: {
-                          outcome: "selected" as const,
-                          optionId: autoApprovedOptionId,
-                        },
-                      };
-                    }
-                  }
-                  const requestId = ApprovalRequestId.make(yield* randomUUIDv4);
-                  const runtimeRequestId = RuntimeRequestId.make(requestId);
-                  const decision = yield* Deferred.make<ProviderApprovalDecision>();
-                  const turnId = resolveSessionCallbackTurnId(sessions, input.threadId);
-                  pendingApprovals.set(requestId, { decision });
-                  yield* signalSessionTurnLiveness(input.threadId, turnId);
-                  yield* offerRuntimeEvent(
-                    makeAcpRequestOpenedEvent({
-                      stamp: yield* makeEventStamp(),
-                      provider: PROVIDER,
-                      threadId: input.threadId,
-                      turnId,
-                      requestId: runtimeRequestId,
-                      permissionRequest,
-                      detail:
-                        permissionRequest.detail ??
-                        encodeJsonStringForDiagnostics(params)?.slice(0, 2000) ??
-                        "[unserializable params]",
-                      args: params,
-                      source: "acp.jsonrpc",
-                      method: "session/request_permission",
-                      rawPayload: params,
-                    }),
-                  );
-                  const resolved = yield* Deferred.await(decision);
-                  pendingApprovals.delete(requestId);
-                  yield* resumeSessionTurnLiveness(input.threadId, turnId);
-                  yield* offerRuntimeEvent(
-                    makeAcpRequestResolvedEvent({
-                      stamp: yield* makeEventStamp(),
-                      provider: PROVIDER,
-                      threadId: input.threadId,
-                      turnId,
-                      requestId: runtimeRequestId,
-                      permissionRequest,
-                      decision: resolved,
-                    }),
-                  );
-                  const selectedOptionId =
-                    resolved === "cancel"
-                      ? undefined
-                      : selectGrokPermissionOptionId(params, resolved);
-                  if (
-                    resolved === "acceptForSession" &&
-                    selectedOptionId &&
-                    approvalKey !== undefined
-                  ) {
-                    sessionApprovedOperations.add(approvalKey);
-                  }
-                  return {
-                    outcome: selectedOptionId
-                      ? {
-                          outcome: "selected" as const,
-                          optionId: selectedOptionId,
-                        }
-                      : ({ outcome: "cancelled" } as const),
-                  };
-                }),
-              ),
-            );
-            return yield* acp.start();
-          }).pipe(
-            Effect.mapError((error) =>
-              mapAcpToAdapterError(PROVIDER, input.threadId, "session/start", error),
-            ),
-          );
-
-          const requestedStartModelId = grokModelSelection?.model
-            ? resolveGrokAcpBaseModelId(grokModelSelection.model)
-            : undefined;
-          const currentStartModelId = currentGrokModelIdFromSessionSetup(
-            started.sessionSetupResult,
-          );
-          const currentStartReasoningEffort = currentGrokReasoningEffortFromSessionSetup(
-            started.sessionSetupResult,
-          );
-          const requestedStartReasoningEffort = getModelSelectionStringOptionValue(
-            grokModelSelection,
-            "reasoningEffort",
-          );
-          const boundModelId = yield* applyGrokAcpModelSelection({
-            runtime: acp,
-            currentModelId: currentStartModelId,
-            currentReasoningEffort: currentStartReasoningEffort,
-            requestedModelId: requestedStartModelId,
-            requestedReasoningEffort: requestedStartReasoningEffort,
-            mapError: (cause) =>
-              mapAcpToAdapterError(PROVIDER, input.threadId, "session/set_model", cause),
-          });
-
-          const now = yield* nowIso;
-          const session: ProviderSession = {
-            provider: PROVIDER,
-            providerInstanceId: boundInstanceId,
-            status: "ready",
-            runtimeMode: input.runtimeMode,
-            cwd,
-            ...(boundModelId ? { model: resolveGrokAcpBaseModelId(boundModelId) } : {}),
-            threadId: input.threadId,
-            resumeCursor: {
-              schemaVersion: GROK_RESUME_VERSION,
-              sessionId: started.sessionId,
-            },
-            createdAt: now,
-            updatedAt: now,
-          };
-
-          const ctx: GrokSessionContext = {
-            threadId: input.threadId,
-            acpSessionId: started.sessionId,
-            session,
-            scope: sessionScope,
-            acp,
-            notificationFiber: undefined,
-            pendingApprovals,
-            pendingUserInputs,
-            turns: [],
-            lastPlanFingerprint: undefined,
-            lastKnownProposedPlanMarkdown: undefined,
-            lastKnownProposedPlanTurnId: undefined,
-            planModeActive: false,
-            activeTurnId: undefined,
-            interruptedTurnIds: new Set(),
-            promptsInFlight: 0,
-            livenessSignals: yield* Queue.sliding<GrokTurnLivenessSignal>(1),
-            livenessTurnId: undefined,
-            lastTurnActivityAtNanos: undefined,
-            activeToolCallIds: new Set(),
-            livenessUpdatesInFlight: 0,
-            promptResponsesReady: 0,
-            currentModelId: boundModelId,
-            currentReasoningEffort:
-              requestedStartReasoningEffort !== undefined
-                ? normalizeGrokReasoningEffort(requestedStartReasoningEffort)
-                : currentStartReasoningEffort,
-            stopped: false,
-          };
-
-          const nf = yield* Stream.runDrain(
-            Stream.mapEffect(acp.getEvents(), (event) =>
-              Effect.gen(function* () {
-                if (event._tag === "EventStreamBarrier") {
-                  yield* Deferred.succeed(event.acknowledge, undefined);
-                  return;
-                }
-                if (
-                  event._tag === "PlanUpdated" ||
-                  event._tag === "ToolCallUpdated" ||
-                  event._tag === "ContentDelta"
-                ) {
-                  yield* logNative(ctx.threadId, "session/update", event.rawPayload);
-                }
-
-                if (event._tag === "ModeChanged") {
-                  return;
-                }
-
-                const notificationTurnId = resolveNotificationTurnId(ctx);
-                if (
-                  notificationTurnId === undefined ||
-                  ctx.interruptedTurnIds.has(notificationTurnId)
-                ) {
-                  return;
-                }
-                if (
-                  event._tag === "AssistantItemStarted" ||
-                  event._tag === "AssistantItemCompleted" ||
-                  event._tag === "PlanUpdated" ||
-                  event._tag === "ToolCallUpdated" ||
-                  event._tag === "ContentDelta"
-                ) {
-                  yield* recordTurnActivity(ctx, notificationTurnId, event);
-                }
-                const stamp = yield* makeEventStamp();
-
-                switch (event._tag) {
-                  case "AssistantItemStarted":
-                    yield* offerRuntimeEvent(
-                      makeAcpAssistantItemEvent({
-                        stamp,
-                        provider: PROVIDER,
-                        threadId: ctx.threadId,
-                        turnId: notificationTurnId,
-                        itemId: event.itemId,
-                        lifecycle: "item.started",
-                      }),
-                    );
-                    return;
-                  case "AssistantItemCompleted":
-                    yield* offerRuntimeEvent(
-                      makeAcpAssistantItemEvent({
-                        stamp,
-                        provider: PROVIDER,
-                        threadId: ctx.threadId,
-                        turnId: notificationTurnId,
-                        itemId: event.itemId,
-                        lifecycle: "item.completed",
-                      }),
-                    );
-                    return;
-                  case "PlanUpdated":
-                    yield* emitPlanUpdate(
-                      ctx,
-                      notificationTurnId,
-                      stamp,
-                      event.payload,
-                      event.rawPayload,
-                      "session/update",
-                    );
-                    return;
-                  case "ToolCallUpdated": {
-                    yield* offerRuntimeEvent(
-                      makeAcpToolCallEvent({
-                        stamp,
-                        provider: PROVIDER,
-                        threadId: ctx.threadId,
-                        turnId: notificationTurnId,
-                        toolCall: event.toolCall,
-                        rawPayload: event.rawPayload,
-                      }),
-                    );
-                    ctx.planModeActive = nextGrokPlanModeActive(ctx.planModeActive, event.toolCall);
-                    // Only promote session plan.md writes while plan mode is
-                    // active — avoids treating unrelated plan files as proposals.
-                    // Fresh stamp: must not share eventId with the tool lifecycle event.
-                    if (ctx.planModeActive) {
-                      const planMarkdown = extractGrokPlanMarkdownFromToolCallData(
-                        event.toolCall.data,
-                        grokPlanPathHost,
-                      );
-                      if (planMarkdown !== undefined) {
-                        yield* emitProposedPlanCompleted(
-                          ctx,
-                          notificationTurnId,
-                          yield* makeEventStamp(),
-                          planMarkdown,
-                          {
-                            method: "session/update",
-                            payload: event.rawPayload,
-                          },
-                        );
-                      }
-                    }
-                    return;
-                  }
-                  case "ContentDelta":
-                    yield* offerRuntimeEvent(
-                      makeAcpContentDeltaEvent({
-                        stamp,
-                        provider: PROVIDER,
-                        threadId: ctx.threadId,
-                        turnId: notificationTurnId,
-                        ...(event.itemId ? { itemId: event.itemId } : {}),
-                        text: event.text,
-                        rawPayload: event.rawPayload,
-                      }),
-                    );
-                    return;
-                }
-              }),
-            ),
-          ).pipe(
-            Effect.catch((cause) =>
-              Effect.logError("Failed to process Grok runtime notification.", { cause }),
-            ),
-            // Fork into the session scope, not the calling fiber. `forkChild`
-            // makes this a child of `startSession`, and Effect interrupts a
-            // fiber's children when it completes, so the consumer died as soon
-            // as `startSession` returned and every later notification was
-            // dropped. The scope is created, stored on the context and closed
-            // on teardown already; only the fork target was wrong.
-            Effect.forkIn(ctx.scope),
-          );
-
-          ctx.notificationFiber = nf;
-          sessions.set(input.threadId, ctx);
-          yield* runTurnLivenessWatchdog(ctx).pipe(Effect.forkIn(ctx.scope), Effect.asVoid);
-          sessionScopeTransferred = true;
-
-          yield* offerRuntimeEvent({
-            type: "session.started",
-            ...(yield* makeEventStamp()),
-            provider: PROVIDER,
-            threadId: input.threadId,
-            payload: { resume: started.initializeResult },
-          });
-          yield* offerRuntimeEvent({
-            type: "session.state.changed",
-            ...(yield* makeEventStamp()),
-            provider: PROVIDER,
-            threadId: input.threadId,
-            payload: { state: "ready", reason: "Grok ACP session ready" },
-          });
-          yield* offerRuntimeEvent({
-            type: "thread.started",
-            ...(yield* makeEventStamp()),
-            provider: PROVIDER,
-            threadId: input.threadId,
-            payload: { providerThreadId: started.sessionId },
-          });
-
-          return session;
-        }).pipe(Effect.scoped),
-      );
-
-    const sendTurn: GrokAdapterShape["sendTurn"] = (input) =>
-      Effect.gen(function* () {
-        const prepared = yield* withThreadLock(
-          input.threadId,
-          Effect.gen(function* () {
-            const ctx = yield* requireSession(input.threadId);
-            // A sendTurn while a prompt is in flight is a steer: the agent
-            // folds the new prompt into the ongoing work, so the active turn
-            // id is reused instead of opening a new turn.
-            const steeringTurnId = ctx.promptsInFlight > 0 ? ctx.activeTurnId : undefined;
-            const turnId = steeringTurnId ?? TurnId.make(yield* randomUUIDv4);
-            // Count this prompt immediately so a superseded in-flight prompt
-            // resolving from here on does not settle the turn; decremented on
-            // preparation failure here, and after the prompt below otherwise.
-            ctx.promptsInFlight += 1;
-            // Bind the turn id before cooperative yields so interruptTurn can
-            // settle this prompt even if stop arrives during preparation.
-            ctx.activeTurnId = turnId;
-            // New turn: do not fall back to a previous turn's plan.md body when
-            // exit_plan_mode omits planContent.
-            if (steeringTurnId === undefined) {
-              clearProposedPlanFallback(ctx);
-            }
-            ctx.session = {
-              ...ctx.session,
-              status: steeringTurnId === undefined ? "connecting" : "running",
-              activeTurnId: turnId,
-              updatedAt: yield* nowIso,
-            };
-
-            return yield* Effect.gen(function* () {
-              const turnModelSelection =
-                input.modelSelection?.instanceId === boundInstanceId
-                  ? input.modelSelection
-                  : undefined;
-              const requestedTurnModelId = turnModelSelection?.model
-                ? resolveGrokAcpBaseModelId(turnModelSelection.model)
-                : undefined;
-              const requestedTurnReasoningEffort = getModelSelectionStringOptionValue(
-                turnModelSelection,
-                "reasoningEffort",
-              );
-
-              const text = input.input?.trim();
-              // Grok ingests images only. Generic files reach the agent
-              // through the path line ProviderService puts in the prompt.
-              const imagePromptParts = yield* Effect.forEach(
-                (input.attachments ?? []).filter((attachment) => attachment.type === "image"),
-                (attachment) =>
-                  Effect.gen(function* () {
-                    const attachmentPath = resolveAttachmentPath({
-                      attachmentsDir: serverConfig.attachmentsDir,
-                      attachment,
-                    });
-                    if (!attachmentPath) {
-                      return yield* new ProviderAdapterRequestError({
-                        provider: PROVIDER,
-                        method: "session/prompt",
-                        detail: `Invalid attachment id '${attachment.id}'.`,
-                      });
-                    }
-                    const bytes = yield* fileSystem.readFile(attachmentPath).pipe(
-                      Effect.mapError(
-                        (cause) =>
-                          new ProviderAdapterRequestError({
-                            provider: PROVIDER,
-                            method: "session/prompt",
-                            detail: cause.message,
-                            cause,
-                          }),
-                      ),
-                    );
-                    return {
-                      type: "image",
-                      data: Buffer.from(bytes).toString("base64"),
-                      mimeType: attachment.mimeType,
-                    } satisfies EffectAcpSchema.ContentBlock;
-                  }),
-              );
-              const promptParts: Array<EffectAcpSchema.ContentBlock> = [
-                ...(text ? [{ type: "text" as const, text }] : []),
-                ...imagePromptParts,
-              ];
-
-              if (promptParts.length === 0) {
-                return yield* new ProviderAdapterValidationError({
-                  provider: PROVIDER,
-                  operation: "sendTurn",
-                  issue: "Turn requires non-empty text or attachments.",
-                });
-              }
-
-              const currentModelId = yield* applyGrokAcpModelSelection({
-                runtime: ctx.acp,
-                currentModelId: ctx.currentModelId,
-                currentReasoningEffort: ctx.currentReasoningEffort,
-                requestedModelId: requestedTurnModelId,
-                requestedReasoningEffort: requestedTurnReasoningEffort,
-                mapError: (cause) =>
-                  mapAcpToAdapterError(PROVIDER, input.threadId, "session/set_model", cause),
-              });
-              ctx.currentModelId = currentModelId;
-              if (requestedTurnReasoningEffort !== undefined) {
-                ctx.currentReasoningEffort = normalizeGrokReasoningEffort(
-                  requestedTurnReasoningEffort,
-                );
-              }
-              const displayModel = currentModelId
-                ? resolveGrokAcpBaseModelId(currentModelId)
-                : undefined;
-              for (let yieldAttempt = 0; yieldAttempt < 8; yieldAttempt += 1) {
-                yield* Effect.yieldNow;
-              }
-              if (ctx.interruptedTurnIds.has(turnId)) {
-                yield* settlePromptInFlight(input.threadId, turnId, ctx.acpSessionId, {
-                  completedStopReason: "cancelled",
-                  emitTurnCompletion: false,
-                  settleAllPrompts: true,
-                });
-                return yield* new ProviderAdapterRequestError({
-                  provider: PROVIDER,
-                  method: "session/prompt",
-                  detail: "Grok prompt was interrupted during preparation.",
-                });
-              }
-              if (steeringTurnId === undefined) {
-                ctx.lastPlanFingerprint = undefined;
-              }
-              ctx.session = {
-                ...ctx.session,
-                status: "running",
-                activeTurnId: turnId,
-                updatedAt: yield* nowIso,
-                ...(displayModel ? { model: displayModel } : {}),
-              };
-              if (steeringTurnId === undefined) {
-                yield* beginTurnLiveness(ctx, turnId);
-              } else {
-                yield* refreshSessionTurnLiveness(input.threadId, turnId);
-              }
-
-              if (steeringTurnId === undefined) {
-                yield* offerRuntimeEvent({
-                  type: "turn.started",
-                  ...(yield* makeEventStamp()),
-                  provider: PROVIDER,
-                  threadId: input.threadId,
-                  turnId,
-                  payload: displayModel ? { model: displayModel } : {},
-                });
-              }
-
-              return {
-                acp: ctx.acp,
-                acpSessionId: ctx.acpSessionId,
-                displayModel,
-                promptParts,
-                turnId,
-              };
-            }).pipe(
-              Effect.tapCause(() =>
-                Effect.gen(function* () {
-                  const liveCtx = sessions.get(input.threadId);
-                  if (!liveCtx) {
-                    return;
-                  }
-                  yield* settlePromptInFlight(input.threadId, turnId, liveCtx.acpSessionId, {
-                    errorMessage: "Grok prompt preparation failed.",
-                    emitTurnCompletion: false,
-                  });
-                }),
-              ),
-            );
-          }),
-        );
-        const promptSettled = yield* Ref.make(false);
-        const promptRpcSucceeded = yield* Ref.make(false);
-        const promptResultRef = yield* Ref.make<EffectAcpSchema.PromptResponse | undefined>(
-          undefined,
-        );
-
-        const promptFailureMessageRef = yield* Ref.make<string | undefined>(undefined);
-
-        return yield* Effect.gen(function* () {
-          const result = yield* prepared.acp
-            .prompt({
-              prompt: prepared.promptParts,
-            })
-            .pipe(
-              Effect.tap((promptResult) =>
-                Effect.all(
-                  [
-                    Ref.set(promptRpcSucceeded, true),
-                    Ref.set(promptResultRef, promptResult),
-                    markPromptResponseReady(input.threadId, prepared.acpSessionId, prepared.turnId),
-                  ],
-                  { discard: true },
-                ),
-              ),
-              Effect.tapError((error) =>
-                Ref.set(
-                  promptFailureMessageRef,
-                  mapAcpToAdapterError(PROVIDER, input.threadId, "session/prompt", error).message,
-                ).pipe(Effect.andThen(prepared.acp.drainEvents)),
-              ),
-              Effect.mapError((error) =>
-                mapAcpToAdapterError(PROVIDER, input.threadId, "session/prompt", error),
-              ),
-            );
-
-          return yield* withThreadLock(
-            input.threadId,
-            Effect.gen(function* () {
-              const ctx = yield* requireSession(input.threadId);
-              if (ctx.acpSessionId !== prepared.acpSessionId) {
-                yield* settlePromptInFlight(
-                  input.threadId,
-                  prepared.turnId,
-                  prepared.acpSessionId,
-                  {
-                    errorMessage: "Grok session changed before the turn completed.",
-                    settleAllPrompts: true,
-                  },
-                );
-                yield* Ref.set(promptSettled, true);
-                return yield* new ProviderAdapterRequestError({
-                  provider: PROVIDER,
-                  method: "session/prompt",
-                  detail: "Grok session changed before the turn completed.",
-                });
-              }
-              // Keep prompt settlement atomic with respect to Stop and steering.
-              // interruptTurn marks its target before waiting for this lock, so
-              // cancellation can still win while queued ACP events are drained.
-              for (let yieldAttempt = 0; yieldAttempt < 8; yieldAttempt += 1) {
-                yield* Effect.yieldNow;
-              }
-              yield* prepared.acp.drainEvents;
-              consumePromptResponseReady(ctx);
-              if (ctx.interruptedTurnIds.has(prepared.turnId)) {
-                yield* Ref.set(promptSettled, true);
-                return {
-                  threadId: input.threadId,
-                  turnId: prepared.turnId,
-                  resumeCursor: ctx.session.resumeCursor,
-                };
-              }
-
-              if (
-                ctx.promptsInFlight <= 0 ||
-                ctx.activeTurnId !== prepared.turnId ||
-                ctx.session.activeTurnId !== prepared.turnId
-              ) {
-                yield* Ref.set(promptSettled, true);
-                return {
-                  threadId: input.threadId,
-                  turnId: prepared.turnId,
-                  resumeCursor: ctx.session.resumeCursor,
-                };
-              }
-
-              appendPromptResultToTurn(ctx, prepared.turnId, prepared.promptParts, result);
-              ctx.session = {
-                ...ctx.session,
-                status: "running",
-                activeTurnId: prepared.turnId,
-                updatedAt: yield* nowIso,
-                ...(prepared.displayModel ? { model: prepared.displayModel } : {}),
-              };
-              const remainingPrompts = Math.max(0, ctx.promptsInFlight - 1);
-              ctx.promptsInFlight = remainingPrompts;
-
-              // Only the last remaining prompt settles the turn. A steer-
-              // superseded prompt resolving while another is in flight or
-              // pending must leave the merged turn running.
-              if (
-                remainingPrompts === 0 &&
-                ctx.activeTurnId === prepared.turnId &&
-                ctx.session.activeTurnId === prepared.turnId
-              ) {
-                if (ctx.interruptedTurnIds.has(prepared.turnId)) {
-                  yield* Ref.set(promptSettled, true);
-                  return {
-                    threadId: input.threadId,
-                    turnId: prepared.turnId,
-                    resumeCursor: ctx.session.resumeCursor,
-                  };
-                }
-                const completedAt = yield* nowIso;
-                const { activeTurnId: _completedTurnId, ...readySession } = ctx.session;
-                ctx.activeTurnId = undefined;
-                ctx.session = {
-                  ...readySession,
-                  status: "ready",
-                  updatedAt: completedAt,
-                  ...(prepared.displayModel ? { model: prepared.displayModel } : {}),
-                };
-                yield* clearTurnLiveness(ctx);
-                const completedStopReason = completedStopReasonFromPromptResponse(result);
-                yield* offerRuntimeEvent({
-                  type: "turn.completed",
-                  ...(yield* makeEventStamp()),
-                  provider: PROVIDER,
-                  threadId: input.threadId,
-                  turnId: prepared.turnId,
-                  payload: {
-                    state: result.stopReason === "cancelled" ? "cancelled" : "completed",
-                    stopReason: completedStopReason,
-                  },
-                });
-                ctx.interruptedTurnIds.delete(prepared.turnId);
-                yield* Ref.set(promptSettled, true);
-              } else if (remainingPrompts > 0) {
-                yield* Ref.set(promptSettled, true);
-              }
-
-              return {
-                threadId: input.threadId,
-                turnId: prepared.turnId,
-                resumeCursor: ctx.session.resumeCursor,
-              };
-            }),
-          );
-        }).pipe(
-          Effect.ensuring(
-            Effect.gen(function* () {
-              if (yield* Ref.get(promptSettled)) {
-                return;
-              }
-
-              if (yield* Ref.get(promptRpcSucceeded)) {
-                const promptResult = yield* Ref.get(promptResultRef);
-                if (promptResult === undefined) {
-                  return;
-                }
-                yield* withThreadLock(
-                  input.threadId,
-                  Effect.gen(function* () {
-                    const ctx = yield* requireSession(input.threadId);
-                    if (ctx.acpSessionId !== prepared.acpSessionId) {
-                      yield* settlePromptInFlight(
-                        input.threadId,
-                        prepared.turnId,
-                        prepared.acpSessionId,
-                        {
-                          errorMessage: "Grok session changed before the turn completed.",
-                          settleAllPrompts: true,
-                        },
-                      );
-                      return;
-                    }
-                    if (ctx.interruptedTurnIds.has(prepared.turnId)) {
-                      return;
-                    }
-                    consumePromptResponseReady(ctx);
-                    if (
-                      ctx.promptsInFlight <= 0 ||
-                      ctx.activeTurnId !== prepared.turnId ||
-                      ctx.session.activeTurnId !== prepared.turnId
-                    ) {
-                      return;
-                    }
-                    appendPromptResultToTurn(
-                      ctx,
-                      prepared.turnId,
-                      prepared.promptParts,
-                      promptResult,
-                    );
-                    yield* settlePromptInFlight(
-                      input.threadId,
-                      prepared.turnId,
-                      prepared.acpSessionId,
-                      {
-                        completedStopReason: completedStopReasonFromPromptResponse(promptResult),
-                      },
-                    );
-                  }),
-                );
-                return;
-              }
-
-              const errorMessage = yield* Ref.get(promptFailureMessageRef);
-              yield* withThreadLock(
-                input.threadId,
-                settlePromptInFlight(input.threadId, prepared.turnId, prepared.acpSessionId, {
-                  errorMessage: errorMessage ?? "Grok prompt request failed.",
-                }),
-              );
-            }).pipe(Effect.catch(() => Effect.void)),
-          ),
-        );
-      });
-
-    const interruptTurn: GrokAdapterShape["interruptTurn"] = (threadId, turnId) =>
-      Effect.gen(function* () {
-        const observed = yield* Effect.sync(() => {
-          const ctx = sessions.get(threadId);
-          if (!ctx || ctx.stopped) {
-            return {
-              _tag: "Proceed" as const,
-              acpSessionId: undefined,
-              interruptedTurnId: turnId,
-            };
-          }
-          const activeTurnId = ctx.activeTurnId ?? ctx.session.activeTurnId;
-          if (turnId !== undefined && activeTurnId !== undefined && activeTurnId !== turnId) {
-            return { _tag: "Ignore" as const };
-          }
-          const interruptedTurnId = turnId ?? activeTurnId;
-          if (interruptedTurnId !== undefined) {
-            ctx.interruptedTurnIds.add(interruptedTurnId);
-          }
-          return {
-            _tag: "Proceed" as const,
-            acpSessionId: ctx.acpSessionId,
-            interruptedTurnId,
-          };
-        });
-        if (observed._tag === "Ignore") {
-          return;
-        }
-
-        yield* withThreadLock(
-          threadId,
-          Effect.gen(function* () {
-            const ctx = yield* requireSession(threadId);
-            if (observed.acpSessionId !== undefined && ctx.acpSessionId !== observed.acpSessionId) {
-              return;
-            }
-            const activeTurnId = ctx.activeTurnId ?? ctx.session.activeTurnId;
-            if (turnId !== undefined && activeTurnId !== undefined && activeTurnId !== turnId) {
-              return;
-            }
-            if (
-              observed.interruptedTurnId !== undefined &&
-              activeTurnId !== undefined &&
-              activeTurnId !== observed.interruptedTurnId
-            ) {
-              return;
-            }
-            const interruptedTurnId =
-              observed.interruptedTurnId ?? turnId ?? activeTurnId ?? ctx.session.activeTurnId;
-            yield* settlePendingApprovalsAsCancelled(ctx.pendingApprovals);
-            yield* settlePendingUserInputsAsCancelled(ctx.pendingUserInputs);
-            yield* Effect.ignore(
-              ctx.acp.cancel.pipe(
-                Effect.mapError((error) =>
-                  mapAcpToAdapterError(PROVIDER, threadId, "session/cancel", error),
-                ),
-              ),
-            );
-            if (interruptedTurnId) {
-              ctx.interruptedTurnIds.add(interruptedTurnId);
-              yield* settlePromptInFlight(threadId, interruptedTurnId, ctx.acpSessionId, {
-                completedStopReason: "cancelled",
-                settleAllPrompts: true,
-              });
-            } else if (
-              ctx.promptsInFlight > 0 ||
-              ctx.session.status === "running" ||
-              ctx.session.status === "connecting"
-            ) {
-              const updatedAt = yield* nowIso;
-              ctx.promptsInFlight = 0;
-              ctx.activeTurnId = undefined;
-              const { activeTurnId: _activeTurnId, ...readySession } = ctx.session;
-              ctx.session = {
-                ...readySession,
-                status: "ready",
-                updatedAt,
-              };
-              yield* clearTurnLiveness(ctx);
-            }
-          }),
-        );
-      });
-
-    const respondToRequest: GrokAdapterShape["respondToRequest"] = (
-      threadId,
-      requestId,
-      decision,
-    ) =>
-      Effect.gen(function* () {
-        const ctx = yield* requireSession(threadId);
-        const pending = ctx.pendingApprovals.get(requestId);
-        if (!pending) {
-          return yield* new ProviderAdapterRequestError({
-            provider: PROVIDER,
-            method: "session/request_permission",
-            detail: `Unknown pending approval request: ${requestId}`,
-          });
-        }
-        yield* Deferred.succeed(pending.decision, decision);
-      });
-
-    const respondToUserInput: GrokAdapterShape["respondToUserInput"] = (
-      threadId,
-      requestId,
-      answers,
-    ) =>
-      Effect.gen(function* () {
-        const ctx = yield* requireSession(threadId);
-        const pending = ctx.pendingUserInputs.get(requestId);
-        if (!pending) {
-          return yield* new ProviderAdapterRequestError({
-            provider: PROVIDER,
-            method: "_x.ai/ask_user_question",
-            detail: `Unknown pending user-input request: ${requestId}`,
-          });
-        }
-        yield* Deferred.succeed(pending.resolution, { _tag: "answered", answers });
-      });
-
-    const readThread: GrokAdapterShape["readThread"] = (threadId) =>
-      Effect.gen(function* () {
-        const ctx = yield* requireSession(threadId);
-        return { threadId, turns: ctx.turns };
-      });
-
-    const rollbackThread: GrokAdapterShape["rollbackThread"] = (threadId, numTurns) =>
-      Effect.gen(function* () {
-        yield* requireSession(threadId);
-        if (!Number.isInteger(numTurns) || numTurns < 1) {
-          return yield* new ProviderAdapterValidationError({
-            provider: PROVIDER,
-            operation: "rollbackThread",
-            issue: "numTurns must be an integer >= 1.",
-          });
-        }
-        return yield* new ProviderAdapterRequestError({
-          provider: PROVIDER,
-          method: "thread/rollback",
-          detail: "Grok ACP sessions do not support provider-side rollback yet.",
-        });
-      });
-
-    const stopSession: GrokAdapterShape["stopSession"] = (threadId) =>
-      withThreadLock(
-        threadId,
-        Effect.gen(function* () {
-          const ctx = yield* requireSession(threadId);
-          yield* stopSessionInternal(ctx);
-        }),
-      );
-
-    const listSessions: GrokAdapterShape["listSessions"] = () =>
-      Effect.sync(() => Array.from(sessions.values(), (c) => ({ ...c.session })));
-
-    const hasSession: GrokAdapterShape["hasSession"] = (threadId) =>
-      Effect.sync(() => {
-        const c = sessions.get(threadId);
-        return c !== undefined && !c.stopped;
-      });
-
-    const stopAll: GrokAdapterShape["stopAll"] = () =>
-      Effect.forEach(Array.from(sessions.values()), stopSessionInternal, { discard: true });
-
-    yield* Effect.addFinalizer(() =>
-      Effect.ignore(stopAll()).pipe(
-        Effect.tap(() => PubSub.shutdown(runtimeEventPubSub)),
-        Effect.tap(() => managedNativeEventLogger?.close() ?? Effect.void),
-      ),
-    );
-
-    const streamEvents = Stream.fromPubSub(runtimeEventPubSub);
-
-    return {
-      provider: PROVIDER,
-      capabilities: { sessionModelSwitch: "in-session" },
-      startSession,
-      sendTurn,
-      interruptTurn,
-      readThread,
-      rollbackThread,
-      respondToRequest,
-      respondToUserInput,
-      stopSession,
-      listSessions,
-      hasSession,
-      stopAll,
-      streamEvents,
-    } satisfies GrokAdapterShape;
-  });
-}
diff --git a/apps/server/src/provider/Layers/GrokProvider.ts b/apps/server/src/provider/Layers/GrokProvider.ts
index 44f9369b8250..392e1e031196 100644
--- a/apps/server/src/provider/Layers/GrokProvider.ts
+++ b/apps/server/src/provider/Layers/GrokProvider.ts
@@ -38,7 +38,6 @@ import { discoverGrokSkills } from "../Drivers/GrokSkills.ts";
 
 const GROK_PRESENTATION = {
   displayName: "Grok",
-  badgeLabel: "Early Access",
   showInteractionModeToggle: false,
   requiresNewThreadForModelChange: true,
 } as const;
diff --git a/apps/server/src/provider/Layers/OpenCodeAdapter.test.ts b/apps/server/src/provider/Layers/OpenCodeAdapter.test.ts
deleted file mode 100644
index 9823a68708c2..000000000000
--- a/apps/server/src/provider/Layers/OpenCodeAdapter.test.ts
+++ /dev/null
@@ -1,5024 +0,0 @@
-import * as NodeAssert from "node:assert/strict";
-import * as NodeServices from "@effect/platform-node/NodeServices";
-import { it } from "@effect/vitest";
-import * as Cause from "effect/Cause";
-import * as Context from "effect/Context";
-import * as Effect from "effect/Effect";
-import * as Exit from "effect/Exit";
-import * as Fiber from "effect/Fiber";
-import * as FileSystem from "effect/FileSystem";
-import * as Layer from "effect/Layer";
-import * as Option from "effect/Option";
-import * as Path from "effect/Path";
-import * as Schema from "effect/Schema";
-import * as Scope from "effect/Scope";
-import * as Stream from "effect/Stream";
-import * as TestClock from "effect/testing/TestClock";
-import { beforeEach } from "vite-plus/test";
-import type { PermissionRequest, QuestionRequest } from "@opencode-ai/sdk/v2";
-
-import {
-  ApprovalRequestId,
-  OpenCodeSettings,
-  ProviderDriverKind,
-  ProviderInstanceId,
-  ThreadId,
-} from "@t3tools/contracts";
-import { createModelSelection } from "@t3tools/shared/model";
-import { ServerConfig } from "../../config.ts";
-import { ServerSettingsService } from "../../serverSettings.ts";
-import { ProviderSessionDirectory } from "../Services/ProviderSessionDirectory.ts";
-import type { OpenCodeAdapterShape } from "../Services/OpenCodeAdapter.ts";
-import {
-  OpenCodeRuntime,
-  OpenCodeRuntimeError,
-  type OpenCodeRuntimeShape,
-} from "../opencodeRuntime.ts";
-import {
-  appendOpenCodeAssistantTextDelta,
-  isOpenCodeNotFound,
-  isSameOpenCodeDirectory,
-  makeOpenCodeAdapter,
-  mergeOpenCodeAssistantText,
-} from "./OpenCodeAdapter.ts";
-
-// Test-local service tag so the rest of the file can keep using `yield* OpenCodeAdapter`.
-class OpenCodeAdapter extends Context.Service<OpenCodeAdapter, OpenCodeAdapterShape>()(
-  "t3/provider/Layers/OpenCodeAdapter.test/OpenCodeAdapter",
-) {}
-
-const asThreadId = (value: string): ThreadId => ThreadId.make(value);
-
-type MessageEntry = {
-  info: {
-    id: string;
-    role: "user" | "assistant";
-  };
-  parts: Array<unknown>;
-};
-
-const runtimeMock = {
-  state: {
-    startCalls: [] as string[],
-    sessionCreateUrls: [] as string[],
-    sessionCreateInputs: [] as Array<Record<string, unknown>>,
-    createdSessionIds: [] as string[],
-    authHeaders: [] as Array<string | null>,
-    abortCalls: [] as string[],
-    abortSignals: [] as AbortSignal[],
-    abortImplementation: null as
-      | ((sessionID: string, signal?: AbortSignal) => Promise<void>)
-      | null,
-    closeCalls: [] as string[],
-    revertCalls: [] as Array<{ sessionID: string; messageID?: string }>,
-    messageCalls: [] as Array<{ sessionID: string; messageID: string }>,
-    messageFailures: 0,
-    promptCalls: [] as Array<unknown>,
-    promptAsyncError: null as Error | null,
-    promptAsyncImplementation: null as (() => Promise<void>) | null,
-    autoPromptEcho: true,
-    autoConnect: true,
-    promptEchoEvents: [] as Array<unknown>,
-    closeError: null as Error | null,
-    messages: [] as MessageEntry[],
-    subscribedEvents: [] as Array<unknown | Promise<unknown>>,
-    eventSubscribeObserved: null as (() => void) | null,
-    permissionReplyCalls: [] as Array<{ requestID: string; reply: string }>,
-    questionReplyCalls: [] as Array<{
-      requestID: string;
-      answers: ReadonlyArray<ReadonlyArray<string>>;
-    }>,
-    sessionStatus: "idle" as "idle" | "busy",
-    sessionStatusFailures: 0,
-    sessionStatusCalls: 0,
-    sessionStatusImplementation: null as (() => Promise<unknown>) | null,
-    sessionGetIds: [] as string[],
-    sessionGetObserved: null as ((sessionID: string) => void) | null,
-    missingSessionIds: new Set<string>(),
-    transientErrorSessionIds: new Set<string>(),
-    sessionDirectoryById: new Map<string, string>(),
-    sessionParentById: new Map<string, string>(),
-    pendingPermissions: [] as Array<PermissionRequest>,
-    pendingQuestions: [] as Array<QuestionRequest>,
-    permissionListCalls: 0,
-    questionListCalls: 0,
-    permissionListImplementation: null as (() => Promise<Array<PermissionRequest>>) | null,
-    questionListImplementation: null as (() => Promise<Array<QuestionRequest>>) | null,
-    sessionUpdateCalls: [] as Array<{ sessionID: string; permission: unknown }>,
-    forkCalls: [] as Array<{ sessionID: string; directory?: string }>,
-  },
-  reset() {
-    this.state.startCalls.length = 0;
-    this.state.sessionCreateUrls.length = 0;
-    this.state.sessionCreateInputs.length = 0;
-    this.state.createdSessionIds.length = 0;
-    this.state.authHeaders.length = 0;
-    this.state.abortCalls.length = 0;
-    this.state.abortSignals.length = 0;
-    this.state.abortImplementation = null;
-    this.state.closeCalls.length = 0;
-    this.state.revertCalls.length = 0;
-    this.state.messageCalls.length = 0;
-    this.state.messageFailures = 0;
-    this.state.promptCalls.length = 0;
-    this.state.promptAsyncError = null;
-    this.state.promptAsyncImplementation = null;
-    this.state.autoPromptEcho = true;
-    this.state.autoConnect = true;
-    this.state.promptEchoEvents.length = 0;
-    this.state.closeError = null;
-    this.state.messages = [];
-    this.state.subscribedEvents = [];
-    this.state.eventSubscribeObserved = null;
-    this.state.permissionReplyCalls.length = 0;
-    this.state.questionReplyCalls.length = 0;
-    this.state.sessionStatus = "idle";
-    this.state.sessionStatusFailures = 0;
-    this.state.sessionStatusCalls = 0;
-    this.state.sessionStatusImplementation = null;
-    this.state.sessionGetIds.length = 0;
-    this.state.sessionGetObserved = null;
-    this.state.missingSessionIds.clear();
-    this.state.transientErrorSessionIds.clear();
-    this.state.sessionDirectoryById.clear();
-    this.state.sessionParentById.clear();
-    this.state.pendingPermissions = [];
-    this.state.pendingQuestions = [];
-    this.state.permissionListCalls = 0;
-    this.state.questionListCalls = 0;
-    this.state.permissionListImplementation = null;
-    this.state.questionListImplementation = null;
-    this.state.sessionUpdateCalls.length = 0;
-    this.state.forkCalls.length = 0;
-  },
-};
-
-const OpenCodeRuntimeTestDouble: OpenCodeRuntimeShape = {
-  startOpenCodeServerProcess: ({ binaryPath, serverPassword }) =>
-    Effect.gen(function* () {
-      runtimeMock.state.startCalls.push(binaryPath);
-      const url = "http://127.0.0.1:4301";
-      yield* Effect.addFinalizer(() =>
-        Effect.sync(() => {
-          runtimeMock.state.closeCalls.push(url);
-          if (runtimeMock.state.closeError) {
-            throw runtimeMock.state.closeError;
-          }
-        }),
-      );
-      return {
-        url,
-        version: "1.15.13",
-        ...(serverPassword ? { serverPassword } : {}),
-        exitCode: Effect.never,
-        isRunning: Effect.succeed(true),
-      };
-    }),
-  connectToOpenCodeServer: ({ serverUrl, serverPassword }) =>
-    Effect.gen(function* () {
-      const url = serverUrl ?? "http://127.0.0.1:4301";
-      // Always register a finalizer so the closeCalls/closeError probes fire;
-      // production attaches none for external servers.
-      yield* Effect.addFinalizer(() =>
-        Effect.sync(() => {
-          runtimeMock.state.closeCalls.push(url);
-          if (runtimeMock.state.closeError) {
-            throw runtimeMock.state.closeError;
-          }
-        }),
-      );
-      return {
-        url,
-        version: "1.15.13",
-        ...(serverPassword ? { serverPassword } : {}),
-        exitCode: null,
-        external: Boolean(serverUrl),
-      };
-    }),
-  runOpenCodeCommand: () => Effect.succeed({ stdout: "", stderr: "", code: 0 }),
-  createOpenCodeSdkClient: ({ baseUrl, serverPassword }) =>
-    ({
-      session: {
-        create: async (input: Record<string, unknown>) => {
-          runtimeMock.state.sessionCreateUrls.push(baseUrl);
-          runtimeMock.state.sessionCreateInputs.push(input);
-          runtimeMock.state.authHeaders.push(
-            serverPassword ? `Basic ${btoa(`opencode:${serverPassword}`)}` : null,
-          );
-          return {
-            data: { id: runtimeMock.state.createdSessionIds.shift() ?? `${baseUrl}/session` },
-          };
-        },
-        get: async ({ sessionID }: { sessionID: string }) => {
-          runtimeMock.state.sessionGetIds.push(sessionID);
-          runtimeMock.state.sessionGetObserved?.(sessionID);
-          // The real client is `throwOnError: true`: non-2xx rejects rather
-          // than resolving, so missing → 404 throw, transient → 500 throw.
-          if (runtimeMock.state.transientErrorSessionIds.has(sessionID)) {
-            throw new Error("opencode server error", { cause: { status: 500 } });
-          }
-          if (runtimeMock.state.missingSessionIds.has(sessionID)) {
-            throw new Error(`Session not found: ${sessionID}`, {
-              cause: { status: 404, body: { name: "NotFoundError" } },
-            });
-          }
-          const directory = runtimeMock.state.sessionDirectoryById.get(sessionID);
-          const parentID = runtimeMock.state.sessionParentById.get(sessionID);
-          return {
-            data: {
-              id: sessionID,
-              ...(directory ? { directory } : {}),
-              ...(parentID ? { parentID } : {}),
-            },
-          };
-        },
-        update: async ({ sessionID, permission }: { sessionID: string; permission: unknown }) => {
-          runtimeMock.state.sessionUpdateCalls.push({ sessionID, permission });
-          return { data: { id: sessionID } };
-        },
-        fork: async ({ sessionID, directory }: { sessionID: string; directory?: string }) => {
-          // Fork clones history into a new session bound to the directory.
-          const forkedId = `${sessionID}_fork`;
-          runtimeMock.state.forkCalls.push({ sessionID, ...(directory ? { directory } : {}) });
-          if (directory) {
-            runtimeMock.state.sessionDirectoryById.set(forkedId, directory);
-          }
-          return { data: { id: forkedId, ...(directory ? { directory } : {}) } };
-        },
-        abort: async ({ sessionID }: { sessionID: string }, options?: { signal?: AbortSignal }) => {
-          runtimeMock.state.abortCalls.push(sessionID);
-          if (options?.signal) {
-            runtimeMock.state.abortSignals.push(options.signal);
-          }
-          await runtimeMock.state.abortImplementation?.(sessionID, options?.signal);
-        },
-        status: async () => {
-          runtimeMock.state.sessionStatusCalls += 1;
-          if (runtimeMock.state.sessionStatusImplementation) {
-            return await runtimeMock.state.sessionStatusImplementation();
-          }
-          if (runtimeMock.state.sessionStatusFailures > 0) {
-            runtimeMock.state.sessionStatusFailures -= 1;
-            throw new Error("status failed");
-          }
-          return {
-            data:
-              runtimeMock.state.sessionStatus === "idle"
-                ? {}
-                : { "http://127.0.0.1:9999/session": { type: "busy" as const } },
-          };
-        },
-        promptAsync: async (input: unknown) => {
-          runtimeMock.state.promptCalls.push(input);
-          await runtimeMock.state.promptAsyncImplementation?.();
-          if (runtimeMock.state.promptAsyncError) {
-            throw runtimeMock.state.promptAsyncError;
-          }
-          if (
-            runtimeMock.state.autoPromptEcho &&
-            typeof input === "object" &&
-            input !== null &&
-            "sessionID" in input &&
-            "messageID" in input &&
-            typeof input.sessionID === "string" &&
-            typeof input.messageID === "string"
-          ) {
-            runtimeMock.state.messages.push({
-              info: { id: input.messageID, role: "user" },
-              parts: [],
-            });
-            runtimeMock.state.promptEchoEvents.push({
-              id: `evt-auto-user-${input.messageID}`,
-              type: "message.updated",
-              properties: {
-                sessionID: input.sessionID,
-                info: { id: input.messageID, role: "user" },
-              },
-            });
-          }
-        },
-        messages: async () => ({ data: runtimeMock.state.messages }),
-        message: async ({ sessionID, messageID }: { sessionID: string; messageID: string }) => {
-          runtimeMock.state.messageCalls.push({ sessionID, messageID });
-          if (runtimeMock.state.messageFailures > 0) {
-            runtimeMock.state.messageFailures -= 1;
-            throw new Error("message lookup failed", { cause: { status: 500 } });
-          }
-          const message = runtimeMock.state.messages.find((entry) => entry.info.id === messageID);
-          if (!message) {
-            throw new Error(`Message not found: ${messageID}`, {
-              cause: { status: 404, body: { name: "NotFoundError" } },
-            });
-          }
-          return { data: message };
-        },
-        revert: async ({ sessionID, messageID }: { sessionID: string; messageID?: string }) => {
-          runtimeMock.state.revertCalls.push({
-            sessionID,
-            ...(messageID ? { messageID } : {}),
-          });
-          if (!messageID) {
-            runtimeMock.state.messages = [];
-            return;
-          }
-
-          const targetIndex = runtimeMock.state.messages.findIndex(
-            (entry) => entry.info.id === messageID,
-          );
-          runtimeMock.state.messages =
-            targetIndex >= 0
-              ? runtimeMock.state.messages.slice(0, targetIndex + 1)
-              : runtimeMock.state.messages;
-        },
-      },
-      event: {
-        subscribe: async () => {
-          runtimeMock.state.eventSubscribeObserved?.();
-          return {
-            stream: (async function* () {
-              if (runtimeMock.state.autoConnect) {
-                yield { id: "evt-auto-connected", type: "server.connected", properties: {} };
-              }
-              for (const event of runtimeMock.state.subscribedEvents) {
-                const resolved = await event;
-                while (runtimeMock.state.promptEchoEvents.length > 0) {
-                  yield runtimeMock.state.promptEchoEvents.shift();
-                }
-                yield resolved;
-              }
-            })(),
-          };
-        },
-      },
-      permission: {
-        list: async () => {
-          runtimeMock.state.permissionListCalls += 1;
-          return {
-            data: runtimeMock.state.permissionListImplementation
-              ? await runtimeMock.state.permissionListImplementation()
-              : runtimeMock.state.pendingPermissions,
-          };
-        },
-        reply: async ({ requestID, reply }: { requestID: string; reply: string }) => {
-          runtimeMock.state.permissionReplyCalls.push({ requestID, reply });
-        },
-      },
-      question: {
-        list: async () => {
-          runtimeMock.state.questionListCalls += 1;
-          return {
-            data: runtimeMock.state.questionListImplementation
-              ? await runtimeMock.state.questionListImplementation()
-              : runtimeMock.state.pendingQuestions,
-          };
-        },
-        reply: async ({
-          requestID,
-          answers,
-        }: {
-          requestID: string;
-          answers: ReadonlyArray<ReadonlyArray<string>>;
-        }) => {
-          runtimeMock.state.questionReplyCalls.push({ requestID, answers });
-        },
-      },
-    }) as unknown as ReturnType<OpenCodeRuntimeShape["createOpenCodeSdkClient"]>,
-  loadOpenCodeInventory: () =>
-    Effect.fail(
-      new OpenCodeRuntimeError({
-        operation: "loadOpenCodeInventory",
-        detail: "OpenCodeRuntimeTestDouble.loadOpenCodeInventory not used in this test",
-        cause: null,
-      }),
-    ),
-  loadInventoryFromCli: () =>
-    Effect.fail(
-      new OpenCodeRuntimeError({
-        operation: "loadInventoryFromCli",
-        detail: "OpenCodeRuntimeTestDouble.loadInventoryFromCli not used in this test",
-        cause: null,
-      }),
-    ),
-};
-
-const providerSessionDirectoryTestLayer = Layer.succeed(ProviderSessionDirectory, {
-  upsert: () => Effect.void,
-  getProvider: () =>
-    Effect.die(new Error("ProviderSessionDirectory.getProvider is not used in test")),
-  getBinding: () => Effect.succeed(Option.none()),
-  listThreadIds: () => Effect.succeed([]),
-  listBindings: () => Effect.succeed([]),
-});
-
-// The adapter now receives its settings as a plain argument (the old design
-// read from `ServerSettingsService` internally). The test-only
-// `ServerSettingsService` below is still kept because other dependencies in
-// the layer graph reach for it — but the routing values the assertions
-// probe (serverUrl, serverPassword) must be threaded directly through the
-// decoded `OpenCodeSettings`.
-const openCodeAdapterTestSettings = Schema.decodeSync(OpenCodeSettings)({
-  binaryPath: "fake-opencode",
-  serverUrl: "http://127.0.0.1:9999",
-  serverPassword: "secret-password",
-});
-
-const OpenCodeAdapterTestLayer = Layer.effect(
-  OpenCodeAdapter,
-  makeOpenCodeAdapter(openCodeAdapterTestSettings),
-).pipe(
-  Layer.provideMerge(Layer.succeed(OpenCodeRuntime, OpenCodeRuntimeTestDouble)),
-  Layer.provideMerge(ServerConfig.layerTest(process.cwd(), process.cwd())),
-  Layer.provideMerge(
-    ServerSettingsService.layerTest({
-      providers: {
-        opencode: {
-          binaryPath: "fake-opencode",
-          serverUrl: "http://127.0.0.1:9999",
-          serverPassword: "secret-password",
-        },
-      },
-    }),
-  ),
-  Layer.provideMerge(providerSessionDirectoryTestLayer),
-  Layer.provideMerge(NodeServices.layer),
-);
-
-beforeEach(() => {
-  runtimeMock.reset();
-});
-
-const advanceTestClock = (ms: number) =>
-  TestClock.adjust(`${ms} millis`).pipe(Effect.andThen(Effect.yieldNow));
-
-function promiseWithResolvers<T>() {
-  let resolve!: (value: T | PromiseLike<T>) => void;
-  let reject!: (reason?: unknown) => void;
-  const promise = new Promise<T>((resolvePromise, rejectPromise) => {
-    resolve = resolvePromise;
-    reject = rejectPromise;
-  });
-  return { promise, resolve, reject };
-}
-
-const permissionRequest = (id: string, sessionID: string): PermissionRequest => ({
-  id,
-  sessionID,
-  permission: "bash",
-  patterns: ["pwd"],
-  metadata: {},
-  always: [],
-});
-
-const questionRequest = (id: string, sessionID: string): QuestionRequest => ({
-  id,
-  sessionID,
-  questions: [
-    {
-      header: "Scope",
-      question: "Which scope should OpenCode use?",
-      options: [{ label: "Workspace", description: "Use this workspace." }],
-    },
-  ],
-});
-
-it.layer(OpenCodeAdapterTestLayer)("OpenCodeAdapterLive", (it) => {
-  it.effect("reuses a configured OpenCode server URL instead of spawning a local server", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-
-      const session = yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId: asThreadId("thread-opencode"),
-        runtimeMode: "full-access",
-      });
-
-      NodeAssert.equal(session.provider, "opencode");
-      NodeAssert.equal(session.threadId, "thread-opencode");
-      NodeAssert.deepEqual(runtimeMock.state.startCalls, []);
-      NodeAssert.deepEqual(runtimeMock.state.sessionCreateUrls, ["http://127.0.0.1:9999"]);
-      NodeAssert.deepEqual(runtimeMock.state.authHeaders, [
-        `Basic ${btoa("opencode:secret-password")}`,
-      ]);
-    }),
-  );
-
-  it.effect("fails startup when the OpenCode event stream does not connect", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-opencode-connect-timeout");
-      runtimeMock.state.autoConnect = false;
-
-      const startFiber = yield* adapter
-        .startSession({
-          provider: ProviderDriverKind.make("opencode"),
-          threadId,
-          runtimeMode: "full-access",
-        })
-        .pipe(Effect.result, Effect.forkChild);
-      yield* Effect.yieldNow;
-      yield* advanceTestClock(10_000);
-
-      const result = yield* Fiber.join(startFiber);
-      NodeAssert.equal(result._tag, "Failure");
-      NodeAssert.equal(result.failure._tag, "ProviderAdapterRequestError");
-      NodeAssert.equal(result.failure.method, "event.subscribe");
-      NodeAssert.equal(yield* adapter.hasSession(threadId), false);
-    }),
-  );
-
-  it.effect("closes a connecting session when startup is interrupted", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-opencode-connect-interrupted");
-      const eventSubscribeObserved = promiseWithResolvers<void>();
-      runtimeMock.state.autoConnect = false;
-      runtimeMock.state.eventSubscribeObserved = () => eventSubscribeObserved.resolve(undefined);
-
-      const startFiber = yield* adapter
-        .startSession({
-          provider: ProviderDriverKind.make("opencode"),
-          threadId,
-          runtimeMode: "full-access",
-        })
-        .pipe(Effect.forkChild);
-      yield* Effect.promise(() => eventSubscribeObserved.promise);
-      yield* Effect.yieldNow;
-      yield* Fiber.interrupt(startFiber);
-
-      NodeAssert.deepEqual(runtimeMock.state.closeCalls, ["http://127.0.0.1:9999"]);
-      NodeAssert.deepEqual(runtimeMock.state.abortCalls, ["http://127.0.0.1:9999/session"]);
-      NodeAssert.equal(yield* adapter.hasSession(threadId), false);
-    }),
-  );
-
-  it.effect("stops a connecting session and rejects its waiting send", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-opencode-stop-connecting");
-      const eventSubscribeObserved = promiseWithResolvers<void>();
-      runtimeMock.state.autoConnect = false;
-      runtimeMock.state.eventSubscribeObserved = () => eventSubscribeObserved.resolve(undefined);
-
-      const startFiber = yield* adapter
-        .startSession({
-          provider: ProviderDriverKind.make("opencode"),
-          threadId,
-          runtimeMode: "full-access",
-        })
-        .pipe(Effect.result, Effect.forkChild);
-      yield* Effect.promise(() => eventSubscribeObserved.promise);
-      const connecting = (yield* adapter.listSessions()).find(
-        (session) => session.threadId === threadId,
-      );
-      NodeAssert.equal(connecting?.status, "connecting");
-
-      const sendFiber = yield* adapter
-        .sendTurn({
-          threadId,
-          input: "Must not be sent",
-          modelSelection: createModelSelection(
-            ProviderInstanceId.make("opencode"),
-            "opencode/kimi-k3",
-          ),
-        })
-        .pipe(Effect.exit, Effect.forkChild);
-      yield* Effect.yieldNow;
-      NodeAssert.equal(runtimeMock.state.promptCalls.length, 0);
-
-      yield* adapter.stopSession(threadId);
-      const startResult = yield* Fiber.join(startFiber);
-      const sendResult = yield* Fiber.join(sendFiber);
-      NodeAssert.equal(startResult._tag, "Failure");
-      NodeAssert.equal(sendResult._tag, "Failure");
-      NodeAssert.equal(runtimeMock.state.promptCalls.length, 0);
-      NodeAssert.deepEqual(runtimeMock.state.closeCalls, ["http://127.0.0.1:9999"]);
-      NodeAssert.equal(yield* adapter.hasSession(threadId), false);
-    }),
-  );
-
-  it.effect("aborts a held teardown request before closing the session scope", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-opencode-teardown-timeout");
-      const abortStarted = promiseWithResolvers<void>();
-      runtimeMock.state.abortImplementation = async () => {
-        abortStarted.resolve(undefined);
-        await new Promise<void>(() => {});
-      };
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-      const stopFiber = yield* adapter.stopSession(threadId).pipe(Effect.forkChild);
-      yield* Effect.promise(() => abortStarted.promise);
-
-      yield* advanceTestClock(999);
-      NodeAssert.equal(stopFiber.pollUnsafe(), undefined);
-      NodeAssert.equal(runtimeMock.state.abortSignals.length, 1);
-      NodeAssert.equal(runtimeMock.state.abortSignals[0]?.aborted, false);
-      NodeAssert.deepEqual(runtimeMock.state.closeCalls, []);
-
-      yield* advanceTestClock(1);
-      yield* Fiber.join(stopFiber);
-      NodeAssert.equal(runtimeMock.state.abortSignals[0]?.aborted, true);
-      NodeAssert.deepEqual(runtimeMock.state.closeCalls, ["http://127.0.0.1:9999"]);
-      NodeAssert.equal(yield* adapter.hasSession(threadId), false);
-    }),
-  );
-
-  it.effect("stopAll closes a connecting session and releases startup", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-opencode-stop-all-connecting");
-      const eventSubscribeObserved = promiseWithResolvers<void>();
-      runtimeMock.state.autoConnect = false;
-      runtimeMock.state.eventSubscribeObserved = () => eventSubscribeObserved.resolve(undefined);
-
-      const startFiber = yield* adapter
-        .startSession({
-          provider: ProviderDriverKind.make("opencode"),
-          threadId,
-          runtimeMode: "full-access",
-        })
-        .pipe(Effect.result, Effect.forkChild);
-      yield* Effect.promise(() => eventSubscribeObserved.promise);
-      const sessionCount = (yield* adapter.listSessions()).length;
-
-      yield* adapter.stopAll();
-      const startResult = yield* Fiber.join(startFiber);
-      NodeAssert.equal(startResult._tag, "Failure");
-      NodeAssert.equal(runtimeMock.state.closeCalls.length, sessionCount);
-      NodeAssert.equal(yield* adapter.hasSession(threadId), false);
-    }),
-  );
-
-  it.effect("keeps one session when concurrent starts cross the connection barrier", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-opencode-concurrent-start");
-      const connectionEvent = promiseWithResolvers<unknown>();
-      runtimeMock.state.autoConnect = false;
-      runtimeMock.state.createdSessionIds.push("ses_race_a", "ses_race_b");
-      runtimeMock.state.subscribedEvents = [connectionEvent.promise];
-
-      const firstStart = yield* adapter
-        .startSession({
-          provider: ProviderDriverKind.make("opencode"),
-          threadId,
-          runtimeMode: "full-access",
-        })
-        .pipe(Effect.forkChild);
-      const secondStart = yield* adapter
-        .startSession({
-          provider: ProviderDriverKind.make("opencode"),
-          threadId,
-          runtimeMode: "full-access",
-        })
-        .pipe(Effect.forkChild);
-      yield* Effect.yieldNow;
-      connectionEvent.resolve({
-        id: "evt-concurrent-start-connected",
-        type: "server.connected",
-        properties: {},
-      });
-
-      const [firstSession, secondSession] = yield* Effect.all([
-        Fiber.join(firstStart),
-        Fiber.join(secondStart),
-      ]);
-      const sessions = yield* adapter.listSessions();
-      const threadSessions = sessions.filter((session) => session.threadId === threadId);
-      NodeAssert.equal(threadSessions.length, 1);
-      NodeAssert.deepEqual(firstSession.resumeCursor, secondSession.resumeCursor);
-      NodeAssert.equal(firstSession.status, "ready");
-      NodeAssert.equal(secondSession.status, "ready");
-      const winnerId = (threadSessions[0]?.resumeCursor as { sessionId?: string } | undefined)
-        ?.sessionId;
-      NodeAssert.ok(winnerId === "ses_race_a" || winnerId === "ses_race_b");
-      NodeAssert.deepEqual(runtimeMock.state.abortCalls, [
-        winnerId === "ses_race_a" ? "ses_race_b" : "ses_race_a",
-      ]);
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("reuses a published connecting session after it becomes ready", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-opencode-reuse-connecting");
-      const connectionEvent = promiseWithResolvers<unknown>();
-      const eventSubscribeObserved = promiseWithResolvers<void>();
-      runtimeMock.state.autoConnect = false;
-      runtimeMock.state.eventSubscribeObserved = () => eventSubscribeObserved.resolve(undefined);
-      runtimeMock.state.subscribedEvents = [connectionEvent.promise];
-
-      const owningStart = yield* adapter
-        .startSession({
-          provider: ProviderDriverKind.make("opencode"),
-          threadId,
-          runtimeMode: "full-access",
-        })
-        .pipe(Effect.forkChild);
-      yield* Effect.promise(() => eventSubscribeObserved.promise);
-      const reusedStart = yield* adapter
-        .startSession({
-          provider: ProviderDriverKind.make("opencode"),
-          threadId,
-          runtimeMode: "full-access",
-        })
-        .pipe(Effect.forkChild);
-      yield* Effect.yieldNow;
-      NodeAssert.equal(runtimeMock.state.sessionCreateUrls.length, 1);
-
-      connectionEvent.resolve({
-        id: "evt-reused-start-connected",
-        type: "server.connected",
-        properties: {},
-      });
-      const [ownedSession, reusedSession] = yield* Effect.all([
-        Fiber.join(owningStart),
-        Fiber.join(reusedStart),
-      ]);
-      NodeAssert.equal(ownedSession.status, "ready");
-      NodeAssert.equal(reusedSession.status, "ready");
-      NodeAssert.deepEqual(ownedSession.resumeCursor, reusedSession.resumeCursor);
-
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("does not let an old held stop delete its replacement", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-opencode-old-stop-replacement");
-      const abortStarted = promiseWithResolvers<void>();
-      const abortRelease = promiseWithResolvers<void>();
-      runtimeMock.state.createdSessionIds.push("ses_old", "ses_replacement");
-
-      const oldSession = yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-      runtimeMock.state.abortImplementation = async () => {
-        abortStarted.resolve(undefined);
-        await abortRelease.promise;
-      };
-      const oldStop = yield* adapter.stopSession(threadId).pipe(Effect.forkChild);
-      yield* Effect.promise(() => abortStarted.promise);
-
-      const replacement = yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-      NodeAssert.deepEqual(oldSession.resumeCursor, { schemaVersion: 1, sessionId: "ses_old" });
-      NodeAssert.deepEqual(replacement.resumeCursor, {
-        schemaVersion: 1,
-        sessionId: "ses_replacement",
-      });
-
-      abortRelease.resolve(undefined);
-      yield* Fiber.join(oldStop);
-      const current = (yield* adapter.listSessions()).find(
-        (session) => session.threadId === threadId,
-      );
-      NodeAssert.deepEqual(current?.resumeCursor, replacement.resumeCursor);
-
-      runtimeMock.state.abortImplementation = null;
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("replaces a stopped connecting session while its teardown is held", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-opencode-stopped-connecting-retry");
-      const eventSubscribeObserved = promiseWithResolvers<void>();
-      const abortStarted = promiseWithResolvers<void>();
-      const abortRelease = promiseWithResolvers<void>();
-      runtimeMock.state.autoConnect = false;
-      runtimeMock.state.eventSubscribeObserved = () => eventSubscribeObserved.resolve(undefined);
-      runtimeMock.state.createdSessionIds.push("ses_connecting_old", "ses_connecting_replacement");
-
-      const oldStart = yield* adapter
-        .startSession({
-          provider: ProviderDriverKind.make("opencode"),
-          threadId,
-          runtimeMode: "full-access",
-        })
-        .pipe(Effect.result, Effect.forkChild);
-      yield* Effect.promise(() => eventSubscribeObserved.promise);
-
-      runtimeMock.state.abortImplementation = async () => {
-        abortStarted.resolve(undefined);
-        await abortRelease.promise;
-      };
-      const oldStop = yield* adapter.stopSession(threadId).pipe(Effect.forkChild);
-      yield* Effect.promise(() => abortStarted.promise);
-
-      runtimeMock.state.autoConnect = true;
-      runtimeMock.state.abortImplementation = null;
-      const replacement = yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-      NodeAssert.equal(replacement.status, "ready");
-      NodeAssert.deepEqual(replacement.resumeCursor, {
-        schemaVersion: 1,
-        sessionId: "ses_connecting_replacement",
-      });
-
-      abortRelease.resolve(undefined);
-      const oldStartResult = yield* Fiber.join(oldStart);
-      yield* Fiber.join(oldStop);
-      NodeAssert.equal(oldStartResult._tag, "Failure");
-      const current = (yield* adapter.listSessions()).find(
-        (session) => session.threadId === threadId,
-      );
-      NodeAssert.deepEqual(current?.resumeCursor, replacement.resumeCursor);
-
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("returns a durable resume cursor for a freshly created session", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-opencode-cursor");
-
-      const session = yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-
-      // Without a persisted cursor, a session is created and its id is
-      // surfaced as a resume cursor so the upper layer can persist it.
-      NodeAssert.deepEqual(runtimeMock.state.sessionGetIds, []);
-      NodeAssert.deepEqual(session.resumeCursor, {
-        schemaVersion: 1,
-        sessionId: "http://127.0.0.1:9999/session",
-      });
-
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("resumes the persisted OpenCode session instead of creating a new one", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-opencode-resume");
-
-      const session = yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-        resumeCursor: { schemaVersion: 1, sessionId: "ses_persisted" },
-      });
-
-      // The adapter validates the persisted id with session.get and re-adopts
-      // it — no new session is minted (issue #3604).
-      NodeAssert.deepEqual(runtimeMock.state.sessionGetIds, ["ses_persisted"]);
-      NodeAssert.deepEqual(runtimeMock.state.sessionCreateUrls, []);
-      NodeAssert.deepEqual(session.resumeCursor, {
-        schemaVersion: 1,
-        sessionId: "ses_persisted",
-      });
-      // Resume re-asserts the permission ruleset for the current runtimeMode.
-      NodeAssert.equal(runtimeMock.state.sessionUpdateCalls.length, 1);
-      NodeAssert.equal(runtimeMock.state.sessionUpdateCalls[0]?.sessionID, "ses_persisted");
-      NodeAssert.equal(runtimeMock.state.sessionUpdateCalls[0]?.permission != null, true);
-
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("sends follow-up turns to the resumed session id", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-opencode-resume-turn");
-
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-        resumeCursor: { schemaVersion: 1, sessionId: "ses_persisted" },
-      });
-
-      const result = yield* adapter.sendTurn({
-        threadId,
-        input: "continue where we left off",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "anthropic/sonnet",
-        ),
-      });
-
-      // The prompt targets the resumed id, and the turn re-surfaces the cursor.
-      NodeAssert.deepEqual(
-        (runtimeMock.state.promptCalls[0] as { sessionID: string }).sessionID,
-        "ses_persisted",
-      );
-      NodeAssert.deepEqual(result.resumeCursor, {
-        schemaVersion: 1,
-        sessionId: "ses_persisted",
-      });
-
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("falls back to a fresh session when the persisted session is gone", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-opencode-stale");
-      runtimeMock.state.missingSessionIds.add("ses_stale");
-
-      const session = yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-        resumeCursor: { schemaVersion: 1, sessionId: "ses_stale" },
-      });
-
-      // get probed the stale id, found nothing, then created a new session and
-      // emitted a fresh cursor rather than wedging the thread.
-      NodeAssert.deepEqual(runtimeMock.state.sessionGetIds, ["ses_stale"]);
-      NodeAssert.deepEqual(runtimeMock.state.sessionCreateUrls, ["http://127.0.0.1:9999"]);
-      NodeAssert.deepEqual(session.resumeCursor, {
-        schemaVersion: 1,
-        sessionId: "http://127.0.0.1:9999/session",
-      });
-
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("ignores a malformed or wrong-version resume cursor", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-opencode-badcursor");
-
-      const session = yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-        resumeCursor: { schemaVersion: 99, sessionId: "ses_persisted" },
-      });
-
-      // A foreign/stale-shaped cursor is treated as "no resume": never probed,
-      // a fresh session is created.
-      NodeAssert.deepEqual(runtimeMock.state.sessionGetIds, []);
-      NodeAssert.deepEqual(runtimeMock.state.sessionCreateUrls, ["http://127.0.0.1:9999"]);
-      NodeAssert.deepEqual(session.resumeCursor, {
-        schemaVersion: 1,
-        sessionId: "http://127.0.0.1:9999/session",
-      });
-
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("surfaces a non-not-found resume probe error instead of silently starting fresh", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-opencode-transient");
-      // session.get returns a 500 (not a 404) for this id.
-      runtimeMock.state.transientErrorSessionIds.add("ses_transient");
-
-      const exit = yield* Effect.exit(
-        adapter.startSession({
-          provider: ProviderDriverKind.make("opencode"),
-          threadId,
-          runtimeMode: "full-access",
-          resumeCursor: { schemaVersion: 1, sessionId: "ses_transient" },
-        }),
-      );
-
-      // A transient/transport/auth failure must propagate — NOT be masked as a
-      // brand-new empty session (the #3604 class of silent context loss).
-      NodeAssert.equal(Exit.isFailure(exit), true);
-      NodeAssert.deepEqual(runtimeMock.state.sessionGetIds, ["ses_transient"]);
-      NodeAssert.deepEqual(runtimeMock.state.sessionCreateUrls, []);
-    }),
-  );
-
-  it.effect("re-applies the current runtimeMode permissions when resuming", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-opencode-perms");
-
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        // A different runtimeMode than the original create — resume must not
-        // leave the upstream session on stale permissions.
-        runtimeMode: "approval-required",
-        threadId,
-        resumeCursor: { schemaVersion: 1, sessionId: "ses_perms" },
-      });
-
-      NodeAssert.deepEqual(runtimeMock.state.sessionGetIds, ["ses_perms"]);
-      NodeAssert.deepEqual(runtimeMock.state.sessionCreateUrls, []);
-      NodeAssert.equal(runtimeMock.state.sessionUpdateCalls.length, 1);
-      NodeAssert.equal(runtimeMock.state.sessionUpdateCalls[0]?.sessionID, "ses_perms");
-      NodeAssert.equal(runtimeMock.state.sessionUpdateCalls[0]?.permission != null, true);
-
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect(
-    "forks the resumed session into the requested directory instead of losing context",
-    () =>
-      Effect.gen(function* () {
-        const adapter = yield* OpenCodeAdapter;
-        const threadId = asThreadId("thread-opencode-cwd");
-        // The persisted session still exists but was created in another working dir
-        // (e.g. the thread moved from the project root into a git worktree).
-        runtimeMock.state.sessionDirectoryById.set("ses_otherdir", "/some/other/worktree");
-
-        const session = yield* adapter.startSession({
-          provider: ProviderDriverKind.make("opencode"),
-          threadId,
-          runtimeMode: "full-access",
-          resumeCursor: { schemaVersion: 1, sessionId: "ses_otherdir" },
-        });
-
-        // A cwd change must not mint an empty session: the adapter forks the
-        // persisted session into the requested cwd, carrying history forward.
-        NodeAssert.deepEqual(runtimeMock.state.sessionGetIds, ["ses_otherdir"]);
-        NodeAssert.deepEqual(runtimeMock.state.sessionCreateUrls, []);
-        NodeAssert.equal(runtimeMock.state.forkCalls.length, 1);
-        NodeAssert.equal(runtimeMock.state.forkCalls[0]?.sessionID, "ses_otherdir");
-        NodeAssert.equal(typeof runtimeMock.state.forkCalls[0]?.directory, "string");
-        // Permission ruleset re-asserted on the fork for the current runtimeMode.
-        NodeAssert.equal(runtimeMock.state.sessionUpdateCalls.length, 1);
-        NodeAssert.equal(runtimeMock.state.sessionUpdateCalls[0]?.sessionID, "ses_otherdir_fork");
-        // Durable cursor now points at the history-complete fork in the new directory.
-        NodeAssert.deepEqual(session.resumeCursor, {
-          schemaVersion: 1,
-          sessionId: "ses_otherdir_fork",
-        });
-
-        yield* adapter.stopSession(threadId);
-      }),
-  );
-
-  it.effect("reuses the resumed session when the stored directory differs only lexically", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-opencode-samedir");
-      // Same working tree, different spelling (trailing slash) — must reuse,
-      // not fork.
-      runtimeMock.state.sessionDirectoryById.set("ses_samedir", `${process.cwd()}/`);
-
-      const session = yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-        resumeCursor: { schemaVersion: 1, sessionId: "ses_samedir" },
-      });
-
-      NodeAssert.deepEqual(runtimeMock.state.sessionGetIds, ["ses_samedir"]);
-      NodeAssert.deepEqual(runtimeMock.state.sessionCreateUrls, []);
-      NodeAssert.deepEqual(runtimeMock.state.forkCalls, []);
-      NodeAssert.deepEqual(session.resumeCursor, {
-        schemaVersion: 1,
-        sessionId: "ses_samedir",
-      });
-
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("fails sendTurn for missing sessions through the typed error channel", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const result = yield* adapter
-        .sendTurn({
-          threadId: asThreadId("thread-opencode-missing-send"),
-          input: "hello",
-          attachments: [],
-        })
-        .pipe(Effect.result);
-
-      NodeAssert.equal(result._tag, "Failure");
-      NodeAssert.equal(result.failure._tag, "ProviderAdapterSessionNotFoundError");
-      NodeAssert.equal(result.failure.provider, "opencode");
-      NodeAssert.equal(result.failure.threadId, "thread-opencode-missing-send");
-    }),
-  );
-
-  it.effect("fails stopSession for missing sessions through the typed error channel", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const result = yield* adapter
-        .stopSession(asThreadId("thread-opencode-missing-stop"))
-        .pipe(Effect.result);
-
-      NodeAssert.equal(result._tag, "Failure");
-      NodeAssert.equal(result.failure._tag, "ProviderAdapterSessionNotFoundError");
-      NodeAssert.equal(result.failure.provider, "opencode");
-      NodeAssert.equal(result.failure.threadId, "thread-opencode-missing-stop");
-    }),
-  );
-
-  it.effect("stops a configured-server session without trying to own server lifecycle", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId: asThreadId("thread-opencode"),
-        runtimeMode: "full-access",
-      });
-
-      yield* adapter.stopSession(asThreadId("thread-opencode"));
-
-      NodeAssert.deepEqual(runtimeMock.state.startCalls, []);
-      NodeAssert.deepEqual(
-        runtimeMock.state.abortCalls.includes("http://127.0.0.1:9999/session"),
-        true,
-      );
-    }),
-  );
-
-  it.effect("emits one session.exited event when stopping a session", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-opencode-stop-event");
-      const eventsFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter((event) => event.threadId === threadId),
-        Stream.take(3),
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-      yield* adapter.stopSession(threadId);
-
-      const events = Array.from(yield* Fiber.join(eventsFiber).pipe(Effect.timeout("1 second")));
-      NodeAssert.deepEqual(
-        events.map((event) => event.type),
-        ["session.started", "thread.started", "session.exited"],
-      );
-    }),
-  );
-
-  it.effect("clears session state even when cleanup finalizers throw", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId: asThreadId("thread-stop-all-a"),
-        runtimeMode: "full-access",
-      });
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId: asThreadId("thread-stop-all-b"),
-        runtimeMode: "full-access",
-      });
-
-      runtimeMock.state.closeError = new Error("close failed");
-      // `stopAll` relies on `stopOpenCodeContext`, which is typed as
-      // never-failing. A throwing finalizer surfaces as a defect — `Effect.exit`
-      // captures it so the assertions can still run. The key invariant we're
-      // validating is "the sessions map and close-call probes reflect cleanup
-      // attempts regardless of finalizer outcome".
-      yield* Effect.exit(adapter.stopAll());
-      const sessions = yield* adapter.listSessions();
-
-      NodeAssert.deepEqual(runtimeMock.state.closeCalls, [
-        "http://127.0.0.1:9999",
-        "http://127.0.0.1:9999",
-      ]);
-      NodeAssert.deepEqual(sessions, []);
-    }),
-  );
-
-  it.effect("completes streamEvents when the adapter scope closes", () =>
-    Effect.gen(function* () {
-      const scope = yield* Scope.make("sequential");
-      let scopeClosed = false;
-
-      try {
-        const adapterLayer = Layer.effect(
-          OpenCodeAdapter,
-          makeOpenCodeAdapter(openCodeAdapterTestSettings),
-        ).pipe(
-          Layer.provideMerge(Layer.succeed(OpenCodeRuntime, OpenCodeRuntimeTestDouble)),
-          Layer.provideMerge(ServerConfig.layerTest(process.cwd(), process.cwd())),
-          Layer.provideMerge(ServerSettingsService.layerTest()),
-          Layer.provideMerge(providerSessionDirectoryTestLayer),
-          Layer.provideMerge(NodeServices.layer),
-        );
-        const context = yield* Layer.buildWithScope(adapterLayer, scope);
-        const adapter = yield* Effect.service(OpenCodeAdapter).pipe(Effect.provide(context));
-        const eventsFiber = yield* adapter.streamEvents.pipe(Stream.runCollect, Effect.forkChild);
-
-        yield* Scope.close(scope, Exit.void);
-        scopeClosed = true;
-
-        const exit = yield* Fiber.await(eventsFiber).pipe(Effect.timeout("1 second"));
-        NodeAssert.equal(Exit.hasInterrupts(exit), true);
-      } finally {
-        if (!scopeClosed) {
-          yield* Scope.close(scope, Exit.void).pipe(Effect.ignore);
-        }
-      }
-    }),
-  );
-
-  it.effect("rolls back session state when sendTurn fails before OpenCode accepts the prompt", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId: asThreadId("thread-send-turn-failure"),
-        runtimeMode: "full-access",
-      });
-
-      runtimeMock.state.promptAsyncError = new Error("prompt failed");
-      const error = yield* adapter
-        .sendTurn({
-          threadId: asThreadId("thread-send-turn-failure"),
-          input: "Fix it",
-          modelSelection: {
-            instanceId: ProviderInstanceId.make("opencode"),
-            model: "openai/gpt-5",
-          },
-        })
-        .pipe(Effect.flip);
-      const sessions = yield* adapter.listSessions();
-
-      NodeAssert.equal(error._tag, "ProviderAdapterRequestError");
-      if (error._tag !== "ProviderAdapterRequestError") {
-        throw new Error("Unexpected error type");
-      }
-      NodeAssert.equal(error.detail, "prompt failed");
-      NodeAssert.equal(
-        error.message,
-        "Provider adapter request failed (opencode) for session.promptAsync: prompt failed",
-      );
-      NodeAssert.equal(sessions.length, 1);
-      NodeAssert.equal(sessions[0]?.status, "ready");
-      NodeAssert.equal(sessions[0]?.activeTurnId, undefined);
-      NodeAssert.equal(sessions[0]?.lastError, "prompt failed");
-    }),
-  );
-
-  it.effect("steers a running turn instead of opening a new one on mid-turn sendTurn", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-steer");
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-
-      const turn = yield* adapter.sendTurn({
-        threadId,
-        input: "run 5 commands",
-        modelSelection: {
-          instanceId: ProviderInstanceId.make("opencode"),
-          model: "openai/gpt-5",
-        },
-      });
-
-      // Steer: OpenCode queues the prompt into the busy session, so the
-      // active turn id is reused instead of opening a new turn.
-      const steeredTurn = yield* adapter.sendTurn({
-        threadId,
-        input: "actually run 15",
-        modelSelection: {
-          instanceId: ProviderInstanceId.make("opencode"),
-          model: "openai/gpt-5",
-        },
-      });
-      NodeAssert.equal(String(steeredTurn.turnId), String(turn.turnId));
-
-      const sessions = yield* adapter.listSessions();
-      const session = sessions.find((entry) => entry.threadId === threadId);
-      NodeAssert.equal(session?.status, "running");
-      NodeAssert.equal(String(session?.activeTurnId), String(turn.turnId));
-      NodeAssert.equal(runtimeMock.state.promptCalls.length, 2);
-    }),
-  );
-
-  it.effect("keeps the running turn when a steer prompt fails", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-steer-failure");
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-
-      const turn = yield* adapter.sendTurn({
-        threadId,
-        input: "run 5 commands",
-        modelSelection: {
-          instanceId: ProviderInstanceId.make("opencode"),
-          model: "openai/gpt-5",
-        },
-      });
-
-      runtimeMock.state.promptAsyncError = new Error("steer failed");
-      const error = yield* adapter
-        .sendTurn({
-          threadId,
-          input: "actually run 15",
-          modelSelection: {
-            instanceId: ProviderInstanceId.make("opencode"),
-            model: "openai/gpt-5",
-          },
-        })
-        .pipe(Effect.flip);
-
-      // The original turn keeps running — only the steer prompt failed.
-      NodeAssert.equal(error._tag, "ProviderAdapterRequestError");
-      const sessions = yield* adapter.listSessions();
-      const session = sessions.find((entry) => entry.threadId === threadId);
-      NodeAssert.equal(session?.status, "running");
-      NodeAssert.equal(String(session?.activeTurnId), String(turn.turnId));
-    }),
-  );
-
-  it.effect("does not let an old idle status complete a successful steer", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-steer-idle-admission");
-      const busyBeforeSteer = promiseWithResolvers<unknown>();
-      const idleBeforeSteer = promiseWithResolvers<unknown>();
-      const idleAfterSteer = promiseWithResolvers<unknown>();
-      const statusStarted = promiseWithResolvers<void>();
-      const statusRelease = promiseWithResolvers<void>();
-      const steerStarted = promiseWithResolvers<void>();
-      const steerRelease = promiseWithResolvers<void>();
-      runtimeMock.state.subscribedEvents = [
-        busyBeforeSteer.promise,
-        idleBeforeSteer.promise,
-        idleAfterSteer.promise,
-      ];
-      runtimeMock.state.sessionStatusImplementation = async () => {
-        statusStarted.resolve(undefined);
-        await statusRelease.promise;
-        return { data: {} };
-      };
-      runtimeMock.state.promptAsyncImplementation = async () => {
-        if (runtimeMock.state.promptCalls.length === 3) {
-          steerStarted.resolve(undefined);
-          await steerRelease.promise;
-        }
-      };
-
-      const completedFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter((event) => event.threadId === threadId && event.type === "turn.completed"),
-        Stream.runHead,
-        Effect.forkChild,
-      );
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-      const stoppedTurn = yield* adapter.sendTurn({
-        threadId,
-        input: "Stop this turn",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      yield* adapter.interruptTurn(threadId, stoppedTurn.turnId);
-      const activeTurn = yield* adapter.sendTurn({
-        threadId,
-        input: "Start the next turn",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      busyBeforeSteer.resolve({
-        id: "evt-busy-before-steer",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "busy" },
-        },
-      });
-      idleBeforeSteer.resolve({
-        id: "evt-idle-before-steer",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "idle" },
-        },
-      });
-      yield* Effect.promise(() => statusStarted.promise);
-      const steerFiber = yield* adapter
-        .sendTurn({
-          threadId,
-          input: "Add one more task",
-          modelSelection: createModelSelection(
-            ProviderInstanceId.make("opencode"),
-            "opencode/kimi-k3",
-          ),
-        })
-        .pipe(Effect.forkChild);
-      yield* Effect.promise(() => steerStarted.promise);
-      statusRelease.resolve(undefined);
-      steerRelease.resolve(undefined);
-      yield* Fiber.join(steerFiber);
-
-      const sessions = yield* adapter.listSessions();
-      const session = sessions.find((candidate) => candidate.threadId === threadId);
-      NodeAssert.equal(session?.status, "running");
-      NodeAssert.equal(session?.activeTurnId, activeTurn.turnId);
-
-      idleAfterSteer.resolve({
-        id: "evt-idle-after-steer",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "idle" },
-        },
-      });
-      const completed = Option.getOrUndefined(
-        yield* Fiber.join(completedFiber).pipe(Effect.timeout("1 second")),
-      );
-      NodeAssert.equal(completed?.turnId, activeTurn.turnId);
-    }),
-  );
-
-  it.effect("waits for steer admission before accepting the only idle event", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-steer-admission-only-idle");
-      runtimeMock.state.autoPromptEcho = false;
-      const firstUserMessageEvent = promiseWithResolvers<unknown>();
-      const staleIdleEvent = promiseWithResolvers<unknown>();
-      const userMessageEvent = promiseWithResolvers<unknown>();
-      const idleEvent = promiseWithResolvers<unknown>();
-      const steerStarted = promiseWithResolvers<void>();
-      const steerRelease = promiseWithResolvers<void>();
-      runtimeMock.state.subscribedEvents = [
-        firstUserMessageEvent.promise,
-        staleIdleEvent.promise,
-        userMessageEvent.promise,
-        idleEvent.promise,
-      ];
-      runtimeMock.state.sessionStatusImplementation = async () => ({ data: {} });
-      runtimeMock.state.promptAsyncImplementation = async () => {
-        if (runtimeMock.state.promptCalls.length === 2) {
-          steerStarted.resolve(undefined);
-          await steerRelease.promise;
-        }
-      };
-
-      const completedFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter((event) => event.threadId === threadId && event.type === "turn.completed"),
-        Stream.runHead,
-        Effect.forkChild,
-      );
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-      const activeTurn = yield* adapter.sendTurn({
-        threadId,
-        input: "Start work",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      const steerFiber = yield* adapter
-        .sendTurn({
-          threadId,
-          input: "Add another task",
-          modelSelection: createModelSelection(
-            ProviderInstanceId.make("opencode"),
-            "opencode/kimi-k3",
-          ),
-        })
-        .pipe(Effect.forkChild);
-      yield* Effect.promise(() => steerStarted.promise);
-      const firstMessageId = (runtimeMock.state.promptCalls[0] as { messageID?: string }).messageID;
-      const steerMessageId = (runtimeMock.state.promptCalls[1] as { messageID?: string }).messageID;
-      NodeAssert.match(firstMessageId ?? "", /^msg_[0-9a-f]{12}[0-9A-Za-z]{14}$/);
-      NodeAssert.match(steerMessageId ?? "", /^msg_[0-9a-f]{12}[0-9A-Za-z]{14}$/);
-      firstUserMessageEvent.resolve({
-        id: "evt-delayed-first-user-message",
-        type: "message.updated",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          info: { id: firstMessageId, role: "user" },
-        },
-      });
-      staleIdleEvent.resolve({
-        id: "evt-stale-idle-during-steer",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "idle" },
-        },
-      });
-      userMessageEvent.resolve({
-        id: "evt-steer-user-message",
-        type: "message.updated",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          info: { id: steerMessageId, role: "user" },
-        },
-      });
-      idleEvent.resolve({
-        id: "evt-only-idle-during-steer",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "idle" },
-        },
-      });
-      yield* Effect.yieldNow;
-      NodeAssert.equal(runtimeMock.state.sessionStatusCalls, 0);
-      steerRelease.resolve(undefined);
-      yield* Fiber.join(steerFiber);
-
-      const completed = Option.getOrUndefined(
-        yield* Fiber.join(completedFiber).pipe(Effect.timeout("1 second")),
-      );
-      NodeAssert.equal(completed?.turnId, activeTurn.turnId);
-      NodeAssert.equal(runtimeMock.state.sessionStatusCalls > 0, true);
-    }),
-  );
-
-  it.effect("keeps steer admission until its user message arrives after prompt acceptance", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-steer-message-after-acceptance");
-      runtimeMock.state.autoPromptEcho = false;
-      const firstUserMessageEvent = promiseWithResolvers<unknown>();
-      const staleIdleEvent = promiseWithResolvers<unknown>();
-      const steerUserMessageEvent = promiseWithResolvers<unknown>();
-      const validIdleEvent = promiseWithResolvers<unknown>();
-      runtimeMock.state.subscribedEvents = [
-        firstUserMessageEvent.promise,
-        staleIdleEvent.promise,
-        steerUserMessageEvent.promise,
-        validIdleEvent.promise,
-      ];
-
-      const completedFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter((event) => event.threadId === threadId && event.type === "turn.completed"),
-        Stream.runHead,
-        Effect.forkChild,
-      );
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-      const activeTurn = yield* adapter.sendTurn({
-        threadId,
-        input: "Start work",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      const firstMessageId = (runtimeMock.state.promptCalls[0] as { messageID?: string }).messageID;
-      firstUserMessageEvent.resolve({
-        id: "evt-first-user-message-before-steer",
-        type: "message.updated",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          info: { id: firstMessageId, role: "user" },
-        },
-      });
-      yield* Effect.yieldNow;
-
-      yield* adapter.sendTurn({
-        threadId,
-        input: "Add another task",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      const steerMessageId = (runtimeMock.state.promptCalls[1] as { messageID?: string }).messageID;
-
-      staleIdleEvent.resolve({
-        id: "evt-stale-idle-after-steer-acceptance",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "idle" },
-        },
-      });
-      yield* Effect.yieldNow;
-      const sessionsAfterStaleIdle = yield* adapter.listSessions();
-      const sessionAfterStaleIdle = sessionsAfterStaleIdle.find(
-        (candidate) => candidate.threadId === threadId,
-      );
-      NodeAssert.equal(sessionAfterStaleIdle?.status, "running");
-      NodeAssert.equal(sessionAfterStaleIdle?.activeTurnId, activeTurn.turnId);
-
-      steerUserMessageEvent.resolve({
-        id: "evt-steer-user-message-after-acceptance",
-        type: "message.updated",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          info: { id: steerMessageId, role: "user" },
-        },
-      });
-      validIdleEvent.resolve({
-        id: "evt-valid-idle-after-steer-message",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "idle" },
-        },
-      });
-
-      const completed = Option.getOrUndefined(
-        yield* Fiber.join(completedFiber).pipe(Effect.timeout("1 second")),
-      );
-      NodeAssert.equal(completed?.turnId, activeTurn.turnId);
-    }),
-  );
-
-  it.effect("recovers steer admission when reconnect happens before prompt acceptance", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-steer-reconnect-before-acceptance");
-      const firstUserMessageEvent = promiseWithResolvers<unknown>();
-      const reconnectEvent = promiseWithResolvers<unknown>();
-      const steerStarted = promiseWithResolvers<void>();
-      const steerRelease = promiseWithResolvers<void>();
-      runtimeMock.state.autoPromptEcho = false;
-      runtimeMock.state.subscribedEvents = [firstUserMessageEvent.promise, reconnectEvent.promise];
-      runtimeMock.state.promptAsyncImplementation = async () => {
-        if (runtimeMock.state.promptCalls.length === 2) {
-          steerStarted.resolve(undefined);
-          await steerRelease.promise;
-        }
-      };
-
-      const completedFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter((event) => event.threadId === threadId && event.type === "turn.completed"),
-        Stream.runHead,
-        Effect.forkChild,
-      );
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-      const activeTurn = yield* adapter.sendTurn({
-        threadId,
-        input: "Start work",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      const firstMessageId = (runtimeMock.state.promptCalls[0] as { messageID?: string }).messageID;
-      firstUserMessageEvent.resolve({
-        id: "evt-first-user-before-reconnect-steer",
-        type: "message.updated",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          info: { id: firstMessageId, role: "user" },
-        },
-      });
-      yield* Effect.yieldNow;
-
-      const steerFiber = yield* adapter
-        .sendTurn({
-          threadId,
-          input: "Add another task",
-          modelSelection: createModelSelection(
-            ProviderInstanceId.make("opencode"),
-            "opencode/kimi-k3",
-          ),
-        })
-        .pipe(Effect.forkChild);
-      yield* Effect.promise(() => steerStarted.promise);
-      const steerMessageId = (runtimeMock.state.promptCalls[1] as { messageID?: string }).messageID;
-      NodeAssert.ok(steerMessageId);
-      runtimeMock.state.messages.push({
-        info: { id: steerMessageId, role: "user" },
-        parts: [],
-      });
-      runtimeMock.state.messageFailures = 1;
-      reconnectEvent.resolve({
-        id: "evt-reconnected-during-steer",
-        type: "server.connected",
-        properties: {},
-      });
-      yield* Effect.yieldNow;
-
-      steerRelease.resolve(undefined);
-      yield* Fiber.join(steerFiber);
-      yield* advanceTestClock(250);
-
-      const completed = Option.getOrUndefined(
-        yield* Fiber.join(completedFiber).pipe(Effect.timeout("1 second")),
-      );
-      NodeAssert.equal(completed?.turnId, activeTurn.turnId);
-      NodeAssert.equal(
-        runtimeMock.state.messageCalls.filter((call) => call.messageID === steerMessageId).length,
-        2,
-      );
-      const abortCallsAfterCompletion = runtimeMock.state.abortCalls.length;
-      yield* adapter.interruptTurn(threadId, activeTurn.turnId);
-      NodeAssert.equal(runtimeMock.state.abortCalls.length, abortCallsAfterCompletion);
-    }),
-  );
-
-  it.effect("resolves admission without a prompt echo when busy and idle still arrive", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-admission-without-echo");
-      const busyEvent = promiseWithResolvers<unknown>();
-      const idleEvent = promiseWithResolvers<unknown>();
-      runtimeMock.state.autoPromptEcho = false;
-      runtimeMock.state.subscribedEvents = [busyEvent.promise, idleEvent.promise];
-      runtimeMock.state.sessionStatusImplementation = async () => ({ data: {} });
-      runtimeMock.state.promptAsyncImplementation = async () => {
-        const prompt = runtimeMock.state.promptCalls.at(-1) as { messageID?: string } | undefined;
-        if (prompt?.messageID) {
-          runtimeMock.state.messages.push({
-            info: { id: prompt.messageID, role: "user" },
-            parts: [],
-          });
-        }
-      };
-
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-      const turn = yield* adapter.sendTurn({
-        threadId,
-        input: "Run without an echo event",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      busyEvent.resolve({
-        id: "evt-busy-without-echo",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "busy" },
-        },
-      });
-      idleEvent.resolve({
-        id: "evt-idle-without-echo",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "idle" },
-        },
-      });
-      yield* advanceTestClock(1_000);
-
-      NodeAssert.equal(
-        runtimeMock.state.messageCalls.some(
-          (call) => call.messageID === runtimeMock.state.messages[0]?.info.id,
-        ),
-        true,
-      );
-      NodeAssert.equal(runtimeMock.state.sessionStatusCalls > 0, true);
-      const sessions = yield* adapter.listSessions();
-      const session = sessions.find((candidate) => candidate.threadId === threadId);
-      NodeAssert.equal(session?.status, "ready");
-      NodeAssert.equal(session?.activeTurnId, undefined);
-      NodeAssert.equal(turn.turnId !== undefined, true);
-
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("uses polled busy status to admit output after a stopped turn", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-polled-busy-after-stop");
-      const firstUserMessageEvent = promiseWithResolvers<unknown>();
-      const assistantMessageEvent = promiseWithResolvers<unknown>();
-      const assistantPartEvent = promiseWithResolvers<unknown>();
-      const idleEvent = promiseWithResolvers<unknown>();
-      const busyStatusPolled = promiseWithResolvers<void>();
-      runtimeMock.state.autoPromptEcho = false;
-      runtimeMock.state.subscribedEvents = [
-        firstUserMessageEvent.promise,
-        assistantMessageEvent.promise,
-        assistantPartEvent.promise,
-        idleEvent.promise,
-      ];
-
-      const eventsFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter(
-          (event) =>
-            event.threadId === threadId &&
-            (event.type === "content.delta" || event.type === "turn.completed"),
-        ),
-        Stream.take(2),
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-      const stoppedTurn = yield* adapter.sendTurn({
-        threadId,
-        input: "Stop this turn",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      const stoppedMessageId = (runtimeMock.state.promptCalls.at(-1) as { messageID: string })
-        .messageID;
-      firstUserMessageEvent.resolve({
-        id: "evt-first-user-before-polled-busy-turn",
-        type: "message.updated",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          info: { id: stoppedMessageId, role: "user" },
-        },
-      });
-      yield* Effect.yieldNow;
-      yield* adapter.interruptTurn(threadId, stoppedTurn.turnId);
-
-      runtimeMock.state.sessionStatusCalls = 0;
-      runtimeMock.state.sessionStatusImplementation = async () => {
-        if (runtimeMock.state.sessionStatusCalls === 1) {
-          busyStatusPolled.resolve(undefined);
-          return {
-            data: { "http://127.0.0.1:9999/session": { type: "busy" as const } },
-          };
-        }
-        return { data: {} };
-      };
-      const activeTurn = yield* adapter.sendTurn({
-        threadId,
-        input: "Run without echo or busy events",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      yield* Effect.promise(() => busyStatusPolled.promise);
-      yield* Effect.yieldNow;
-
-      assistantMessageEvent.resolve({
-        id: "evt-assistant-after-polled-busy",
-        type: "message.updated",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          info: { id: "msg-assistant-after-polled-busy", role: "assistant" },
-        },
-      });
-      assistantPartEvent.resolve({
-        id: "evt-part-after-polled-busy",
-        type: "message.part.updated",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          part: {
-            id: "part-after-polled-busy",
-            sessionID: "http://127.0.0.1:9999/session",
-            messageID: "msg-assistant-after-polled-busy",
-            type: "text",
-            text: "Visible output",
-            time: { start: 1 },
-          },
-          time: 1,
-        },
-      });
-      idleEvent.resolve({
-        id: "evt-idle-after-polled-busy",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "idle" },
-        },
-      });
-
-      const events = Array.from(yield* Fiber.join(eventsFiber).pipe(Effect.timeout("1 second")));
-      NodeAssert.deepEqual(
-        events.map((event) => event.type),
-        ["content.delta", "turn.completed"],
-      );
-      const delta = events[0];
-      if (delta?.type === "content.delta") {
-        NodeAssert.equal(delta.payload.delta, "Visible output");
-      }
-      NodeAssert.equal(events[1]?.turnId, activeTurn.turnId);
-      const sessions = yield* adapter.listSessions();
-      const session = sessions.find((candidate) => candidate.threadId === threadId);
-      NodeAssert.equal(session?.status, "ready");
-      NodeAssert.equal(session?.activeTurnId, undefined);
-
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("ignores a stale admission status response after the next turn starts", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-stale-admission-status-after-stop");
-      const idleEvent = promiseWithResolvers<unknown>();
-      const userMessageEvent = promiseWithResolvers<unknown>();
-      const staleStatusStarted = promiseWithResolvers<void>();
-      const staleStatusRelease = promiseWithResolvers<void>();
-      const staleStatusReturned = promiseWithResolvers<void>();
-      const activePromptStarted = promiseWithResolvers<void>();
-      const activePromptRelease = promiseWithResolvers<void>();
-      runtimeMock.state.autoPromptEcho = false;
-      runtimeMock.state.subscribedEvents = [idleEvent.promise, userMessageEvent.promise];
-      runtimeMock.state.sessionStatusImplementation = async () => {
-        if (runtimeMock.state.sessionStatusCalls === 1) {
-          staleStatusStarted.resolve(undefined);
-          await staleStatusRelease.promise;
-          staleStatusReturned.resolve(undefined);
-          return {
-            data: { "http://127.0.0.1:9999/session": { type: "busy" as const } },
-          };
-        }
-        return { data: {} };
-      };
-      runtimeMock.state.promptAsyncImplementation = async () => {
-        if (runtimeMock.state.promptCalls.length === 2) {
-          activePromptStarted.resolve(undefined);
-          await activePromptRelease.promise;
-        }
-      };
-
-      const completedFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter((event) => event.threadId === threadId && event.type === "turn.completed"),
-        Stream.runHead,
-        Effect.forkChild,
-      );
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-      const stoppedTurn = yield* adapter.sendTurn({
-        threadId,
-        input: "Stop while status is pending",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      yield* Effect.promise(() => staleStatusStarted.promise);
-      yield* adapter.interruptTurn(threadId, stoppedTurn.turnId);
-
-      const activeTurnFiber = yield* adapter
-        .sendTurn({
-          threadId,
-          input: "Start while the old status is pending",
-          modelSelection: createModelSelection(
-            ProviderInstanceId.make("opencode"),
-            "opencode/kimi-k3",
-          ),
-        })
-        .pipe(Effect.forkChild);
-      yield* Effect.promise(() => activePromptStarted.promise);
-      const activeMessageId = (runtimeMock.state.promptCalls.at(-1) as { messageID: string })
-        .messageID;
-
-      staleStatusRelease.resolve(undefined);
-      yield* Effect.promise(() => staleStatusReturned.promise);
-      for (let index = 0; index < 2; index += 1) {
-        yield* Effect.yieldNow;
-      }
-      idleEvent.resolve({
-        id: "evt-idle-after-stale-admission-status",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "idle" },
-        },
-      });
-      for (let index = 0; index < 4; index += 1) {
-        yield* Effect.yieldNow;
-      }
-      NodeAssert.equal(activeTurnFiber.pollUnsafe(), undefined);
-      NodeAssert.equal(completedFiber.pollUnsafe(), undefined);
-      const sessionsBeforeAcceptance = yield* adapter.listSessions();
-      const sessionBeforeAcceptance = sessionsBeforeAcceptance.find(
-        (candidate) => candidate.threadId === threadId,
-      );
-      NodeAssert.equal(sessionBeforeAcceptance?.status, "running");
-      NodeAssert.notEqual(sessionBeforeAcceptance?.activeTurnId, stoppedTurn.turnId);
-
-      userMessageEvent.resolve({
-        id: "evt-user-after-stale-admission-status",
-        type: "message.updated",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          info: { id: activeMessageId, role: "user" },
-        },
-      });
-      yield* Effect.yieldNow;
-      activePromptRelease.resolve(undefined);
-      const activeTurn = yield* Fiber.join(activeTurnFiber);
-      yield* advanceTestClock(250);
-
-      const completed = Option.getOrUndefined(
-        yield* Fiber.join(completedFiber).pipe(Effect.timeout("1 second")),
-      );
-      NodeAssert.equal(completed?.turnId, activeTurn.turnId);
-      const sessions = yield* adapter.listSessions();
-      const session = sessions.find((candidate) => candidate.threadId === threadId);
-      NodeAssert.equal(session?.status, "ready");
-      NodeAssert.equal(session?.activeTurnId, undefined);
-
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("reconciles a sole idle when the matching prompt echo arrives later", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-idle-before-delayed-echo");
-      const idleEvent = promiseWithResolvers<unknown>();
-      const userMessageEvent = promiseWithResolvers<unknown>();
-      runtimeMock.state.autoPromptEcho = false;
-      runtimeMock.state.subscribedEvents = [idleEvent.promise, userMessageEvent.promise];
-      runtimeMock.state.sessionStatusImplementation = async () => ({ data: {} });
-
-      const completedFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter((event) => event.threadId === threadId && event.type === "turn.completed"),
-        Stream.runHead,
-        Effect.forkChild,
-      );
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-      const turn = yield* adapter.sendTurn({
-        threadId,
-        input: "Finish before the echo arrives",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      const messageId = (runtimeMock.state.promptCalls[0] as { messageID?: string }).messageID;
-      idleEvent.resolve({
-        id: "evt-idle-before-delayed-echo",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "idle" },
-        },
-      });
-      userMessageEvent.resolve({
-        id: "evt-delayed-matching-echo",
-        type: "message.updated",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          info: { id: messageId, role: "user" },
-        },
-      });
-      yield* advanceTestClock(250);
-
-      const completed = Option.getOrUndefined(
-        yield* Fiber.join(completedFiber).pipe(Effect.timeout("1 second")),
-      );
-      NodeAssert.equal(completed?.turnId, turn.turnId);
-      const sessions = yield* adapter.listSessions();
-      const session = sessions.find((candidate) => candidate.threadId === threadId);
-      NodeAssert.equal(session?.status, "ready");
-      NodeAssert.equal(session?.activeTurnId, undefined);
-
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("reconciles the only idle after a stopped turn when the prompt echo is missing", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-idle-only-without-echo-after-stop");
-      const idleEvent = promiseWithResolvers<unknown>();
-      runtimeMock.state.autoPromptEcho = false;
-      runtimeMock.state.subscribedEvents = [idleEvent.promise];
-      runtimeMock.state.sessionStatusImplementation = async () => ({ data: {} });
-      runtimeMock.state.promptAsyncImplementation = async () => {
-        const prompt = runtimeMock.state.promptCalls.at(-1) as { messageID?: string } | undefined;
-        if (prompt?.messageID) {
-          runtimeMock.state.messages.push({
-            info: { id: prompt.messageID, role: "user" },
-            parts: [],
-          });
-        }
-      };
-
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-      const stoppedTurn = yield* adapter.sendTurn({
-        threadId,
-        input: "Stop this turn",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      yield* adapter.interruptTurn(threadId, stoppedTurn.turnId);
-      const activeTurn = yield* adapter.sendTurn({
-        threadId,
-        input: "Run after the stop",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      const activeMessageId = (
-        runtimeMock.state.promptCalls.at(-1) as { messageID?: string } | undefined
-      )?.messageID;
-      idleEvent.resolve({
-        id: "evt-only-idle-without-echo-after-stop",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "idle" },
-        },
-      });
-      yield* advanceTestClock(1_000);
-
-      NodeAssert.equal(
-        runtimeMock.state.messageCalls.some((call) => call.messageID === activeMessageId),
-        true,
-      );
-      NodeAssert.equal(runtimeMock.state.sessionStatusCalls > 0, true);
-      const sessions = yield* adapter.listSessions();
-      const session = sessions.find((candidate) => candidate.threadId === threadId);
-      NodeAssert.equal(session?.status, "ready");
-      NodeAssert.equal(session?.activeTurnId, undefined);
-      NodeAssert.notEqual(activeTurn.turnId, stoppedTurn.turnId);
-
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("reconciles a sole idle after a stop when the exact prompt echo arrives", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-idle-before-exact-echo-after-stop");
-      const idleEvent = promiseWithResolvers<unknown>();
-      const userMessageEvent = promiseWithResolvers<unknown>();
-      runtimeMock.state.autoPromptEcho = false;
-      runtimeMock.state.subscribedEvents = [idleEvent.promise, userMessageEvent.promise];
-      runtimeMock.state.sessionStatusImplementation = async () => ({ data: {} });
-
-      const completedFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter((event) => event.threadId === threadId && event.type === "turn.completed"),
-        Stream.runHead,
-        Effect.forkChild,
-      );
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-      const stoppedTurn = yield* adapter.sendTurn({
-        threadId,
-        input: "Stop this turn",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      yield* adapter.interruptTurn(threadId, stoppedTurn.turnId);
-      const activeTurn = yield* adapter.sendTurn({
-        threadId,
-        input: "Run after the stop",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      const activeMessageId = (
-        runtimeMock.state.promptCalls.at(-1) as { messageID?: string } | undefined
-      )?.messageID;
-      idleEvent.resolve({
-        id: "evt-only-idle-before-exact-echo-after-stop",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "idle" },
-        },
-      });
-      yield* Effect.yieldNow;
-      const sessionsBeforeEcho = yield* adapter.listSessions();
-      const sessionBeforeEcho = sessionsBeforeEcho.find(
-        (candidate) => candidate.threadId === threadId,
-      );
-      NodeAssert.equal(sessionBeforeEcho?.status, "running");
-      NodeAssert.equal(sessionBeforeEcho?.activeTurnId, activeTurn.turnId);
-
-      userMessageEvent.resolve({
-        id: "evt-exact-prompt-echo-after-stop",
-        type: "message.updated",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          info: { id: activeMessageId, role: "user" },
-        },
-      });
-      yield* advanceTestClock(250);
-
-      const completed = Option.getOrUndefined(
-        yield* Fiber.join(completedFiber).pipe(Effect.timeout("1 second")),
-      );
-      NodeAssert.equal(completed?.turnId, activeTurn.turnId);
-      const sessions = yield* adapter.listSessions();
-      const session = sessions.find((candidate) => candidate.threadId === threadId);
-      NodeAssert.equal(session?.status, "ready");
-      NodeAssert.equal(session?.activeTurnId, undefined);
-
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("recovers an idle before the exact prompt echo while acceptance is held", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-idle-and-echo-before-acceptance-after-stop");
-      const idleEvent = promiseWithResolvers<unknown>();
-      const userMessageEvent = promiseWithResolvers<unknown>();
-      const activePromptStarted = promiseWithResolvers<void>();
-      const activePromptRelease = promiseWithResolvers<void>();
-      runtimeMock.state.autoPromptEcho = false;
-      runtimeMock.state.subscribedEvents = [idleEvent.promise, userMessageEvent.promise];
-      runtimeMock.state.sessionStatusImplementation = async () => ({ data: {} });
-      runtimeMock.state.promptAsyncImplementation = async () => {
-        if (runtimeMock.state.promptCalls.length === 2) {
-          activePromptStarted.resolve(undefined);
-          await activePromptRelease.promise;
-        }
-      };
-
-      const completedFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter((event) => event.threadId === threadId && event.type === "turn.completed"),
-        Stream.runHead,
-        Effect.forkChild,
-      );
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-      const stoppedTurn = yield* adapter.sendTurn({
-        threadId,
-        input: "Stop this turn",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      yield* adapter.interruptTurn(threadId, stoppedTurn.turnId);
-
-      const activeTurnFiber = yield* adapter
-        .sendTurn({
-          threadId,
-          input: "Run after the stop",
-          modelSelection: createModelSelection(
-            ProviderInstanceId.make("opencode"),
-            "opencode/kimi-k3",
-          ),
-        })
-        .pipe(Effect.forkChild);
-      yield* Effect.promise(() => activePromptStarted.promise);
-      const activeMessageId = (runtimeMock.state.promptCalls.at(-1) as { messageID: string })
-        .messageID;
-      idleEvent.resolve({
-        id: "evt-idle-before-held-prompt-acceptance",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "idle" },
-        },
-      });
-      yield* Effect.yieldNow;
-      userMessageEvent.resolve({
-        id: "evt-exact-echo-before-held-prompt-acceptance",
-        type: "message.updated",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          info: { id: activeMessageId, role: "user" },
-        },
-      });
-      yield* Effect.yieldNow;
-      NodeAssert.equal(activeTurnFiber.pollUnsafe(), undefined);
-
-      activePromptRelease.resolve(undefined);
-      const activeTurn = yield* Fiber.join(activeTurnFiber);
-      yield* advanceTestClock(250);
-
-      const completed = Option.getOrUndefined(
-        yield* Fiber.join(completedFiber).pipe(Effect.timeout("1 second")),
-      );
-      NodeAssert.equal(completed?.turnId, activeTurn.turnId);
-      const sessions = yield* adapter.listSessions();
-      const session = sessions.find((candidate) => candidate.threadId === threadId);
-      NodeAssert.equal(session?.status, "ready");
-      NodeAssert.equal(session?.activeTurnId, undefined);
-
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("restores idle reconciliation after a steer prompt fails", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-failed-steer-idle");
-      const busyEvent = promiseWithResolvers<unknown>();
-      const idleEvent = promiseWithResolvers<unknown>();
-      const firstStatusStarted = promiseWithResolvers<void>();
-      const firstStatusRelease = promiseWithResolvers<void>();
-      const steerStarted = promiseWithResolvers<void>();
-      const steerRelease = promiseWithResolvers<void>();
-      runtimeMock.state.subscribedEvents = [busyEvent.promise, idleEvent.promise];
-      runtimeMock.state.sessionStatusImplementation = async () => {
-        if (runtimeMock.state.sessionStatusCalls === 1) {
-          firstStatusStarted.resolve(undefined);
-          await firstStatusRelease.promise;
-        }
-        return { data: {} };
-      };
-      runtimeMock.state.promptAsyncImplementation = async () => {
-        if (runtimeMock.state.promptCalls.length === 3) {
-          steerStarted.resolve(undefined);
-          await steerRelease.promise;
-          throw new Error("steer failed");
-        }
-      };
-
-      const completedFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter((event) => event.threadId === threadId && event.type === "turn.completed"),
-        Stream.runHead,
-        Effect.forkChild,
-      );
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-      const stoppedTurn = yield* adapter.sendTurn({
-        threadId,
-        input: "Stop this turn",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      yield* adapter.interruptTurn(threadId, stoppedTurn.turnId);
-      const activeTurn = yield* adapter.sendTurn({
-        threadId,
-        input: "Start the next turn",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      busyEvent.resolve({
-        id: "evt-failed-steer-busy",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "busy" },
-        },
-      });
-      idleEvent.resolve({
-        id: "evt-failed-steer-idle",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "idle" },
-        },
-      });
-      yield* Effect.promise(() => firstStatusStarted.promise);
-      const steerFiber = yield* Effect.exit(
-        adapter.sendTurn({
-          threadId,
-          input: "This steer fails",
-          modelSelection: createModelSelection(
-            ProviderInstanceId.make("opencode"),
-            "opencode/kimi-k3",
-          ),
-        }),
-      ).pipe(Effect.forkChild);
-      yield* Effect.promise(() => steerStarted.promise);
-      firstStatusRelease.resolve(undefined);
-      steerRelease.resolve(undefined);
-      const steerExit = yield* Fiber.join(steerFiber);
-      NodeAssert.equal(Exit.isFailure(steerExit), true);
-
-      const completed = Option.getOrUndefined(
-        yield* Fiber.join(completedFiber).pipe(Effect.timeout("1 second")),
-      );
-      NodeAssert.equal(completed?.turnId, activeTurn.turnId);
-      NodeAssert.equal(runtimeMock.state.sessionStatusCalls, 2);
-    }),
-  );
-
-  it.effect("accepts the only idle event after a steer fails before creating its message", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-failed-steer-admission-idle");
-      const idleEvent = promiseWithResolvers<unknown>();
-      const steerStarted = promiseWithResolvers<void>();
-      const steerRelease = promiseWithResolvers<void>();
-      runtimeMock.state.subscribedEvents = [idleEvent.promise];
-      runtimeMock.state.sessionStatusImplementation = async () => ({ data: {} });
-      runtimeMock.state.promptAsyncImplementation = async () => {
-        if (runtimeMock.state.promptCalls.length === 2) {
-          steerStarted.resolve(undefined);
-          await steerRelease.promise;
-          throw new Error("steer failed before message creation");
-        }
-      };
-
-      const completedFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter((event) => event.threadId === threadId && event.type === "turn.completed"),
-        Stream.runHead,
-        Effect.forkChild,
-      );
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-      const activeTurn = yield* adapter.sendTurn({
-        threadId,
-        input: "Start work",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      const steerFiber = yield* Effect.exit(
-        adapter.sendTurn({
-          threadId,
-          input: "This steer fails",
-          modelSelection: createModelSelection(
-            ProviderInstanceId.make("opencode"),
-            "opencode/kimi-k3",
-          ),
-        }),
-      ).pipe(Effect.forkChild);
-      yield* Effect.promise(() => steerStarted.promise);
-      idleEvent.resolve({
-        id: "evt-idle-during-failed-admission",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "idle" },
-        },
-      });
-      steerRelease.resolve(undefined);
-      NodeAssert.equal(Exit.isFailure(yield* Fiber.join(steerFiber)), true);
-
-      const completed = Option.getOrUndefined(
-        yield* Fiber.join(completedFiber).pipe(Effect.timeout("1 second")),
-      );
-      NodeAssert.equal(completed?.turnId, activeTurn.turnId);
-    }),
-  );
-
-  it.effect("routes child-session approval requests and replies through the parent thread", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-child-approval");
-      const permissionReply = promiseWithResolvers<unknown>();
-      runtimeMock.state.subscribedEvents = [
-        {
-          id: "evt-child-created",
-          type: "session.created",
-          properties: {
-            sessionID: "ses_child",
-            info: {
-              id: "ses_child",
-              parentID: "http://127.0.0.1:9999/session",
-              title: "Child session",
-            },
-          },
-        },
-        {
-          id: "evt-child-permission",
-          type: "permission.asked",
-          properties: {
-            id: "per_child",
-            sessionID: "ses_child",
-            permission: "external_directory",
-            patterns: ["/tmp/external/*"],
-            metadata: { source: "child" },
-            always: ["/tmp/external/*"],
-          },
-        },
-        permissionReply.promise,
-      ];
-
-      const openedEventsFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter((event) => event.threadId === threadId),
-        Stream.take(3),
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "approval-required",
-      });
-
-      const openedEvents = Array.from(
-        yield* Fiber.join(openedEventsFiber).pipe(Effect.timeout("1 second")),
-      );
-      const opened = openedEvents.find((event) => event.type === "request.opened");
-      NodeAssert.ok(opened);
-      NodeAssert.equal(opened.requestId, "per_child");
-      NodeAssert.equal(
-        opened.raw?.source === "opencode.sdk.event" &&
-          typeof opened.raw.payload === "object" &&
-          opened.raw.payload !== null &&
-          "properties" in opened.raw.payload
-          ? (opened.raw.payload.properties as { sessionID?: string }).sessionID
-          : undefined,
-        "ses_child",
-      );
-
-      yield* adapter.respondToRequest(
-        threadId,
-        ApprovalRequestId.make("per_child"),
-        "acceptForSession",
-      );
-      NodeAssert.deepEqual(runtimeMock.state.permissionReplyCalls, [
-        { requestID: "per_child", reply: "always" },
-      ]);
-
-      const resolvedEventFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter((event) => event.threadId === threadId),
-        Stream.take(1),
-        Stream.runHead,
-        Effect.forkChild,
-      );
-      permissionReply.resolve({
-        id: "evt-child-permission-replied",
-        type: "permission.replied",
-        properties: {
-          sessionID: "ses_child",
-          requestID: "per_child",
-          reply: "always",
-        },
-      });
-      const resolved = yield* Fiber.join(resolvedEventFiber).pipe(Effect.timeout("1 second"));
-      NodeAssert.equal(Option.getOrUndefined(resolved)?.type, "request.resolved");
-
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("routes child-session questions and replies through the parent thread", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-child-question");
-      const questionReply = promiseWithResolvers<unknown>();
-      runtimeMock.state.subscribedEvents = [
-        {
-          id: "evt-child-created",
-          type: "session.created",
-          properties: {
-            sessionID: "ses_child_question",
-            info: {
-              id: "ses_child_question",
-              parentID: "http://127.0.0.1:9999/session",
-              title: "Child session",
-            },
-          },
-        },
-        {
-          id: "evt-child-question",
-          type: "question.asked",
-          properties: {
-            id: "que_child",
-            sessionID: "ses_child_question",
-            questions: [
-              {
-                header: "Scope",
-                question: "Which scope should OpenCode use?",
-                options: [{ label: "Workspace", description: "Use this workspace." }],
-              },
-            ],
-          },
-        },
-        questionReply.promise,
-      ];
-
-      const requestedEventsFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter((event) => event.threadId === threadId),
-        Stream.take(3),
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "approval-required",
-      });
-
-      const requestedEvents = Array.from(
-        yield* Fiber.join(requestedEventsFiber).pipe(Effect.timeout("1 second")),
-      );
-      const requested = requestedEvents.find((event) => event.type === "user-input.requested");
-      NodeAssert.ok(requested);
-      NodeAssert.equal(requested.requestId, "que_child");
-
-      yield* adapter.respondToUserInput(threadId, ApprovalRequestId.make("que_child"), {
-        Scope: "Workspace",
-      });
-      NodeAssert.deepEqual(runtimeMock.state.questionReplyCalls, [
-        { requestID: "que_child", answers: [["Workspace"]] },
-      ]);
-
-      const resolvedEventFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter((event) => event.threadId === threadId),
-        Stream.take(1),
-        Stream.runHead,
-        Effect.forkChild,
-      );
-      questionReply.resolve({
-        id: "evt-child-question-replied",
-        type: "question.replied",
-        properties: {
-          sessionID: "ses_child_question",
-          requestID: "que_child",
-          answers: [["Workspace"]],
-        },
-      });
-      const resolved = yield* Fiber.join(resolvedEventFiber).pipe(Effect.timeout("1 second"));
-      NodeAssert.equal(Option.getOrUndefined(resolved)?.type, "user-input.resolved");
-
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("recovers pending requests from existing nested child sessions on resume", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-resume-child-requests");
-      runtimeMock.state.sessionParentById.set("ses_child", "ses_parent");
-      runtimeMock.state.sessionParentById.set("ses_nested", "ses_child");
-      runtimeMock.state.pendingPermissions = [permissionRequest("per_existing", "ses_nested")];
-      runtimeMock.state.pendingQuestions = [questionRequest("que_existing", "ses_child")];
-
-      const requestsFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter(
-          (event) =>
-            event.threadId === threadId &&
-            (event.type === "request.opened" || event.type === "user-input.requested"),
-        ),
-        Stream.take(2),
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "approval-required",
-        resumeCursor: { schemaVersion: 1, sessionId: "ses_parent" },
-      });
-
-      const requests = Array.from(
-        yield* Fiber.join(requestsFiber).pipe(Effect.timeout("1 second")),
-      );
-      NodeAssert.deepEqual(requests.map((event) => [event.type, event.requestId]).sort(), [
-        ["request.opened", "per_existing"],
-        ["user-input.requested", "que_existing"],
-      ]);
-      yield* adapter.respondToRequest(threadId, ApprovalRequestId.make("per_existing"), "accept");
-      yield* adapter.respondToUserInput(threadId, ApprovalRequestId.make("que_existing"), {
-        Scope: "Workspace",
-      });
-      NodeAssert.deepEqual(runtimeMock.state.permissionReplyCalls, [
-        { requestID: "per_existing", reply: "once" },
-      ]);
-      NodeAssert.deepEqual(runtimeMock.state.questionReplyCalls, [
-        { requestID: "que_existing", answers: [["Workspace"]] },
-      ]);
-    }),
-  );
-
-  it.effect("retries ancestry for one live child request after a transient failure", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-child-request-ancestry-retry");
-      const parentId = "http://127.0.0.1:9999/session";
-      const ancestryAttempted = promiseWithResolvers<void>();
-      runtimeMock.state.sessionParentById.set("ses_existing_child", parentId);
-      runtimeMock.state.transientErrorSessionIds.add("ses_existing_child");
-      runtimeMock.state.sessionGetObserved = (sessionID) => {
-        if (sessionID === "ses_existing_child") {
-          ancestryAttempted.resolve(undefined);
-        }
-      };
-      runtimeMock.state.subscribedEvents = [
-        {
-          id: "evt-existing-child-permission",
-          type: "permission.asked",
-          properties: permissionRequest("per_retry", "ses_existing_child"),
-        },
-      ];
-
-      const eventsFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter(
-          (event) =>
-            event.threadId === threadId &&
-            (event.type === "runtime.warning" || event.type === "request.opened"),
-        ),
-        Stream.take(2),
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "approval-required",
-      });
-      yield* Effect.promise(() => ancestryAttempted.promise);
-      runtimeMock.state.transientErrorSessionIds.delete("ses_existing_child");
-      yield* advanceTestClock(250);
-
-      const events = Array.from(yield* Fiber.join(eventsFiber).pipe(Effect.timeout("1 second")));
-      NodeAssert.deepEqual(
-        events.map((event) => event.type),
-        ["runtime.warning", "request.opened"],
-      );
-      yield* adapter.respondToRequest(threadId, ApprovalRequestId.make("per_retry"), "accept");
-    }),
-  );
-
-  it.effect("does not resurrect a recovered child request after its live reply", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-stale-child-request-recovery");
-      const listStarted = promiseWithResolvers<void>();
-      const listRelease = promiseWithResolvers<void>();
-      const stale = permissionRequest("per_stale", "ses_existing_child");
-      runtimeMock.state.sessionParentById.set("ses_existing_child", "ses_parent");
-      runtimeMock.state.permissionListImplementation = async () => {
-        listStarted.resolve(undefined);
-        await listRelease.promise;
-        return [stale];
-      };
-      runtimeMock.state.subscribedEvents = [
-        {
-          id: "evt-stale-child-replied",
-          type: "permission.replied",
-          properties: {
-            sessionID: "ses_existing_child",
-            requestID: stale.id,
-            reply: "once",
-          },
-        },
-      ];
-
-      const resolvedFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter(
-          (event) =>
-            event.threadId === threadId &&
-            (event.type === "request.opened" || event.type === "request.resolved"),
-        ),
-        Stream.runHead,
-        Effect.forkChild,
-      );
-
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "approval-required",
-        resumeCursor: { schemaVersion: 1, sessionId: "ses_parent" },
-      });
-      yield* Effect.promise(() => listStarted.promise);
-      const resolved = Option.getOrUndefined(
-        yield* Fiber.join(resolvedFiber).pipe(Effect.timeout("1 second")),
-      );
-      NodeAssert.equal(resolved?.type, "request.resolved");
-      listRelease.resolve(undefined);
-      yield* Effect.yieldNow;
-
-      const response = yield* Effect.exit(
-        adapter.respondToRequest(threadId, ApprovalRequestId.make(stale.id), "accept"),
-      );
-      NodeAssert.equal(Exit.isFailure(response), true);
-    }),
-  );
-
-  it.effect("lets a child reply supersede an ask while ancestry lookup is retrying", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-child-terminal-during-ancestry");
-      const ancestryAttempted = promiseWithResolvers<void>();
-      const childId = "ses_terminal_child";
-      const request = permissionRequest("per_terminal", childId);
-      runtimeMock.state.sessionParentById.set(childId, "http://127.0.0.1:9999/session");
-      runtimeMock.state.transientErrorSessionIds.add(childId);
-      runtimeMock.state.sessionGetObserved = (sessionID) => {
-        if (sessionID === childId) {
-          ancestryAttempted.resolve(undefined);
-        }
-      };
-      runtimeMock.state.subscribedEvents = [
-        { id: "evt-terminal-ask", type: "permission.asked", properties: request },
-        {
-          id: "evt-terminal-reply",
-          type: "permission.replied",
-          properties: { sessionID: childId, requestID: request.id, reply: "once" },
-        },
-      ];
-
-      const terminalFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter(
-          (event) =>
-            event.threadId === threadId &&
-            (event.type === "request.opened" || event.type === "request.resolved"),
-        ),
-        Stream.runHead,
-        Effect.forkChild,
-      );
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "approval-required",
-      });
-      yield* Effect.promise(() => ancestryAttempted.promise);
-      runtimeMock.state.transientErrorSessionIds.delete(childId);
-      yield* advanceTestClock(250);
-
-      const terminal = Option.getOrUndefined(
-        yield* Fiber.join(terminalFiber).pipe(Effect.timeout("1 second")),
-      );
-      NodeAssert.equal(terminal?.type, "request.resolved");
-      const response = yield* Effect.exit(
-        adapter.respondToRequest(threadId, ApprovalRequestId.make(request.id), "accept"),
-      );
-      NodeAssert.equal(Exit.isFailure(response), true);
-    }),
-  );
-
-  it.effect("caps terminal ancestry retries after a request finishes", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-terminal-ancestry-retry-cap");
-      const childId = "ses_terminal_retry_cap_child";
-      const request = permissionRequest("per_terminal_retry_cap", childId);
-      const terminalEvent = promiseWithResolvers<unknown>();
-      const askedAttempted = promiseWithResolvers<void>();
-      const terminalAttempted = promiseWithResolvers<void>();
-      let terminalReleased = false;
-      runtimeMock.state.transientErrorSessionIds.add(childId);
-      runtimeMock.state.sessionGetObserved = (sessionID) => {
-        if (sessionID !== childId) {
-          return;
-        }
-        if (terminalReleased) {
-          terminalAttempted.resolve(undefined);
-        } else {
-          askedAttempted.resolve(undefined);
-        }
-      };
-      runtimeMock.state.subscribedEvents = [
-        { id: "evt-terminal-cap-ask", type: "permission.asked", properties: request },
-        terminalEvent.promise,
-      ];
-
-      const unexpectedRequestFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter(
-          (event) =>
-            event.threadId === threadId &&
-            (event.type === "request.opened" || event.type === "request.resolved"),
-        ),
-        Stream.runHead,
-        Effect.forkChild,
-      );
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "approval-required",
-      });
-      yield* Effect.promise(() => askedAttempted.promise);
-      const askedAttempts = runtimeMock.state.sessionGetIds.filter(
-        (sessionID) => sessionID === childId,
-      ).length;
-
-      terminalReleased = true;
-      terminalEvent.resolve({
-        id: "evt-terminal-cap-reply",
-        type: "permission.replied",
-        properties: { sessionID: childId, requestID: request.id, reply: "once" },
-      });
-      yield* Effect.promise(() => terminalAttempted.promise);
-      yield* advanceTestClock(10_000);
-      const callsAfterCap = runtimeMock.state.sessionGetIds.filter(
-        (sessionID) => sessionID === childId,
-      ).length;
-      NodeAssert.equal(callsAfterCap - askedAttempts, 5);
-
-      yield* advanceTestClock(30_000);
-      NodeAssert.equal(
-        runtimeMock.state.sessionGetIds.filter((sessionID) => sessionID === childId).length,
-        callsAfterCap,
-      );
-      NodeAssert.equal(unexpectedRequestFiber.pollUnsafe(), undefined);
-      yield* Fiber.interrupt(unexpectedRequestFiber);
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("reruns recovery when the event stream connects during the startup snapshot", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-connected-recovery-rerun");
-      const firstListStarted = promiseWithResolvers<void>();
-      const firstListRelease = promiseWithResolvers<void>();
-      const pending = permissionRequest("per_connected", "ses_existing_child");
-      runtimeMock.state.sessionParentById.set("ses_existing_child", "ses_parent");
-      runtimeMock.state.permissionListImplementation = async () => {
-        if (runtimeMock.state.permissionListCalls === 1) {
-          firstListStarted.resolve(undefined);
-          await firstListRelease.promise;
-          return [];
-        }
-        return [pending];
-      };
-      runtimeMock.state.subscribedEvents = [
-        { id: "evt-connected", type: "server.connected", properties: {} },
-      ];
-
-      const openedFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter((event) => event.threadId === threadId && event.type === "request.opened"),
-        Stream.runHead,
-        Effect.forkChild,
-      );
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "approval-required",
-        resumeCursor: { schemaVersion: 1, sessionId: "ses_parent" },
-      });
-      yield* Effect.promise(() => firstListStarted.promise);
-      firstListRelease.resolve(undefined);
-
-      const opened = Option.getOrUndefined(
-        yield* Fiber.join(openedFiber).pipe(Effect.timeout("1 second")),
-      );
-      NodeAssert.equal(opened?.requestId, pending.id);
-      NodeAssert.equal(runtimeMock.state.permissionListCalls, 2);
-    }),
-  );
-
-  it.effect("keeps an idle event from completing a turn while its abort request is pending", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-interrupt-idle-race");
-      const idleEvent = promiseWithResolvers<unknown>();
-      const abortStarted = promiseWithResolvers<void>();
-      const abortRelease = promiseWithResolvers<void>();
-      runtimeMock.state.subscribedEvents = [idleEvent.promise];
-      runtimeMock.state.abortImplementation = async () => {
-        abortStarted.resolve(undefined);
-        await abortRelease.promise;
-      };
-
-      const eventsFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter((event) => event.threadId === threadId),
-        Stream.take(4),
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-      const turn = yield* adapter.sendTurn({
-        threadId,
-        input: "Keep working",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-
-      const interruptFiber = yield* adapter
-        .interruptTurn(threadId, turn.turnId)
-        .pipe(Effect.forkChild);
-      yield* Effect.promise(() => abortStarted.promise);
-      idleEvent.resolve({
-        id: "evt-idle-after-stop",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "idle" },
-        },
-      });
-      yield* Effect.yieldNow;
-      abortRelease.resolve(undefined);
-      yield* Fiber.join(interruptFiber);
-
-      const events = Array.from(yield* Fiber.join(eventsFiber).pipe(Effect.timeout("1 second")));
-      NodeAssert.deepEqual(
-        events
-          .filter((event) => event.type === "turn.completed" || event.type === "turn.aborted")
-          .map((event) => event.type),
-        ["turn.aborted"],
-      );
-      const sessions = yield* adapter.listSessions();
-      const session = sessions.find((candidate) => candidate.threadId === threadId);
-      NodeAssert.equal(session?.status, "ready");
-      NodeAssert.equal(session?.activeTurnId, undefined);
-
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("ignores late busy and idle status after an interrupted turn", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-late-status-after-interrupt");
-      const lateBusy = promiseWithResolvers<unknown>();
-      const lateIdle = promiseWithResolvers<unknown>();
-      runtimeMock.state.subscribedEvents = [lateBusy.promise, lateIdle.promise];
-
-      const eventsFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter((event) => event.threadId === threadId),
-        Stream.take(5),
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-      const turn = yield* adapter.sendTurn({
-        threadId,
-        input: "Stop this turn",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      yield* adapter.interruptTurn(threadId, turn.turnId);
-
-      lateBusy.resolve({
-        id: "evt-late-busy-after-interrupt",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "busy" },
-        },
-      });
-      lateIdle.resolve({
-        id: "evt-late-idle-after-interrupt",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "idle" },
-        },
-      });
-      yield* Effect.yieldNow;
-
-      const sessions = yield* adapter.listSessions();
-      const session = sessions.find((candidate) => candidate.threadId === threadId);
-      NodeAssert.equal(session?.status, "ready");
-      NodeAssert.equal(session?.activeTurnId, undefined);
-
-      yield* adapter.stopSession(threadId);
-      const events = Array.from(yield* Fiber.join(eventsFiber).pipe(Effect.timeout("1 second")));
-      NodeAssert.deepEqual(
-        events
-          .filter((event) => event.type === "turn.completed" || event.type === "turn.aborted")
-          .map((event) => event.type),
-        ["turn.aborted"],
-      );
-    }),
-  );
-
-  it.effect("rejects a prompt accepted after its turn was interrupted", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-interrupt-during-prompt-admission");
-      const promptStarted = promiseWithResolvers<void>();
-      const promptRelease = promiseWithResolvers<void>();
-      const lateBusy = promiseWithResolvers<unknown>();
-      const lateMessage = promiseWithResolvers<unknown>();
-      const latePart = promiseWithResolvers<unknown>();
-      const lateIdle = promiseWithResolvers<unknown>();
-      const marker = promiseWithResolvers<unknown>();
-      runtimeMock.state.autoPromptEcho = false;
-      runtimeMock.state.subscribedEvents = [
-        lateBusy.promise,
-        lateMessage.promise,
-        latePart.promise,
-        lateIdle.promise,
-        marker.promise,
-      ];
-      runtimeMock.state.promptAsyncImplementation = async () => {
-        if (runtimeMock.state.promptCalls.length === 1) {
-          promptStarted.resolve(undefined);
-          await promptRelease.promise;
-        }
-      };
-
-      const firstLateOutput = yield* adapter.streamEvents.pipe(
-        Stream.filter(
-          (event) =>
-            event.threadId === threadId &&
-            (event.type === "content.delta" || event.type === "thread.metadata.updated"),
-        ),
-        Stream.runHead,
-        Effect.forkChild,
-      );
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-      const sendFiber = yield* adapter
-        .sendTurn({
-          threadId,
-          input: "This request is still pending",
-          modelSelection: createModelSelection(
-            ProviderInstanceId.make("opencode"),
-            "opencode/kimi-k3",
-          ),
-        })
-        .pipe(Effect.exit, Effect.forkChild);
-      yield* Effect.promise(() => promptStarted.promise);
-
-      yield* adapter.interruptTurn(threadId);
-      NodeAssert.equal(runtimeMock.state.abortCalls.length, 1);
-      const sessionsAfterStop = yield* adapter.listSessions();
-      const sessionAfterStop = sessionsAfterStop.find(
-        (candidate) => candidate.threadId === threadId,
-      );
-      NodeAssert.equal(sessionAfterStop?.status, "ready");
-      NodeAssert.equal(sessionAfterStop?.activeTurnId, undefined);
-
-      promptRelease.resolve(undefined);
-      const sendResult = yield* Fiber.join(sendFiber);
-      lateBusy.resolve({
-        id: "evt-busy-after-late-prompt-acceptance",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "busy" },
-        },
-      });
-      lateMessage.resolve({
-        id: "evt-assistant-after-late-prompt-acceptance",
-        type: "message.updated",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          info: { id: "msg-late-assistant", role: "assistant" },
-        },
-      });
-      latePart.resolve({
-        id: "evt-part-after-late-prompt-acceptance",
-        type: "message.part.updated",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          part: {
-            id: "part-late-assistant",
-            sessionID: "http://127.0.0.1:9999/session",
-            messageID: "msg-late-assistant",
-            type: "text",
-            text: "Late output",
-            time: { start: 1 },
-          },
-          time: 1,
-        },
-      });
-      lateIdle.resolve({
-        id: "evt-idle-after-late-prompt-acceptance",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "idle" },
-        },
-      });
-      marker.resolve({
-        id: "evt-marker-after-late-prompt-acceptance",
-        type: "session.updated",
-        properties: {
-          info: {
-            id: "http://127.0.0.1:9999/session",
-            title: "Late prompt cleaned up",
-          },
-        },
-      });
-
-      const firstOutput = Option.getOrUndefined(
-        yield* Fiber.join(firstLateOutput).pipe(Effect.timeout("1 second")),
-      );
-      NodeAssert.equal(firstOutput?.type, "thread.metadata.updated");
-      NodeAssert.equal(Exit.isFailure(sendResult), true);
-      if (Exit.isFailure(sendResult)) {
-        NodeAssert.equal(Cause.hasInterruptsOnly(sendResult.cause), true);
-      }
-
-      yield* adapter.sendTurn({
-        threadId,
-        input: "Start after late cleanup",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      yield* Effect.yieldNow;
-      NodeAssert.equal(runtimeMock.state.abortCalls.length, 1);
-      const sessionsAfterNextTurn = yield* adapter.listSessions();
-      const sessionAfterNextTurn = sessionsAfterNextTurn.find(
-        (candidate) => candidate.threadId === threadId,
-      );
-      NodeAssert.equal(sessionAfterNextTurn?.status, "running");
-
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("treats MessageAbortedError as the acknowledgment for a pending user stop", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-interrupt-error-race");
-      const abortedEvent = promiseWithResolvers<unknown>();
-      const abortStarted = promiseWithResolvers<void>();
-      const abortRelease = promiseWithResolvers<void>();
-      runtimeMock.state.subscribedEvents = [abortedEvent.promise];
-      runtimeMock.state.abortImplementation = async () => {
-        abortStarted.resolve(undefined);
-        await abortRelease.promise;
-      };
-
-      const eventsFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter((event) => event.threadId === threadId),
-        Stream.take(4),
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-      const turn = yield* adapter.sendTurn({
-        threadId,
-        input: "Keep working",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-
-      const interruptFiber = yield* adapter
-        .interruptTurn(threadId, turn.turnId)
-        .pipe(Effect.forkChild);
-      yield* Effect.promise(() => abortStarted.promise);
-      abortedEvent.resolve({
-        id: "evt-aborted-after-stop",
-        type: "session.error",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          error: { name: "MessageAbortedError", data: { message: "Aborted" } },
-        },
-      });
-      yield* Effect.yieldNow;
-      abortRelease.resolve(undefined);
-      yield* Fiber.join(interruptFiber);
-
-      const events = Array.from(yield* Fiber.join(eventsFiber).pipe(Effect.timeout("1 second")));
-      NodeAssert.deepEqual(
-        events
-          .filter(
-            (event) =>
-              event.type === "turn.completed" ||
-              event.type === "turn.aborted" ||
-              event.type === "runtime.error",
-          )
-          .map((event) => event.type),
-        ["turn.aborted"],
-      );
-
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("does not claim a turn stopped when the abort request fails", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-interrupt-request-failure");
-      runtimeMock.state.abortImplementation = async () => {
-        throw new Error("abort failed");
-      };
-
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-      const turn = yield* adapter.sendTurn({
-        threadId,
-        input: "Keep working",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-
-      const exit = yield* Effect.exit(adapter.interruptTurn(threadId, turn.turnId));
-      NodeAssert.equal(Exit.isFailure(exit), true);
-      const sessions = yield* adapter.listSessions();
-      const session = sessions.find((candidate) => candidate.threadId === threadId);
-      NodeAssert.equal(session?.status, "running");
-      NodeAssert.equal(session?.activeTurnId, turn.turnId);
-    }),
-  );
-
-  it.effect("releases stop and send waiters when a native abort times out", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-interrupt-timeout");
-      const abortStarted = promiseWithResolvers<void>();
-      runtimeMock.state.abortImplementation = async () => {
-        abortStarted.resolve(undefined);
-        await new Promise<void>(() => {});
-      };
-      runtimeMock.state.sessionStatus = "busy";
-
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-      const turn = yield* adapter.sendTurn({
-        threadId,
-        input: "Keep working",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      const unexpectedEventFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter(
-          (event) =>
-            event.threadId === threadId &&
-            (event.type === "turn.completed" || event.type === "turn.aborted"),
-        ),
-        Stream.runHead,
-        Effect.forkChild,
-      );
-      const firstInterrupt = yield* adapter
-        .interruptTurn(threadId, turn.turnId)
-        .pipe(Effect.result, Effect.forkChild);
-      yield* Effect.promise(() => abortStarted.promise);
-      NodeAssert.equal(runtimeMock.state.abortCalls.length, 1);
-      NodeAssert.equal(runtimeMock.state.abortSignals.length, 1);
-      const abortSignal = runtimeMock.state.abortSignals[0];
-      const secondInterrupt = yield* adapter
-        .interruptTurn(threadId, turn.turnId)
-        .pipe(Effect.result, Effect.forkChild);
-      const sendFiber = yield* adapter
-        .sendTurn({
-          threadId,
-          input: "Wait for the stop request",
-          modelSelection: createModelSelection(
-            ProviderInstanceId.make("opencode"),
-            "opencode/kimi-k3",
-          ),
-        })
-        .pipe(Effect.result, Effect.forkChild);
-      yield* Effect.yieldNow;
-      NodeAssert.equal(runtimeMock.state.abortCalls.length, 1);
-
-      yield* advanceTestClock(9_999);
-      NodeAssert.equal(firstInterrupt.pollUnsafe(), undefined);
-      NodeAssert.equal(secondInterrupt.pollUnsafe(), undefined);
-      NodeAssert.equal(sendFiber.pollUnsafe(), undefined);
-      yield* advanceTestClock(1);
-
-      const firstResult = yield* Fiber.join(firstInterrupt);
-      const secondResult = yield* Fiber.join(secondInterrupt);
-      const sendResult = yield* Fiber.join(sendFiber);
-      NodeAssert.equal(firstResult._tag, "Failure");
-      NodeAssert.equal(secondResult._tag, "Failure");
-      NodeAssert.equal(sendResult._tag, "Failure");
-      if (firstResult._tag === "Failure") {
-        NodeAssert.equal(firstResult.failure._tag, "ProviderAdapterRequestError");
-        NodeAssert.equal(
-          firstResult.failure.detail,
-          "OpenCode session abort did not complete within 10 seconds.",
-        );
-      }
-      NodeAssert.equal(abortSignal?.aborted, true);
-      NodeAssert.equal(unexpectedEventFiber.pollUnsafe(), undefined);
-
-      runtimeMock.state.abortImplementation = null;
-      yield* adapter.sendTurn({
-        threadId,
-        input: "Continue after the failed stop request",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      NodeAssert.equal(runtimeMock.state.promptCalls.length, 2);
-
-      yield* Fiber.interrupt(unexpectedEventFiber);
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("shares one abort request across concurrent stops", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-concurrent-interrupt");
-      const abortStarted = promiseWithResolvers<void>();
-      const abortRelease = promiseWithResolvers<void>();
-      runtimeMock.state.abortImplementation = async () => {
-        abortStarted.resolve(undefined);
-        await abortRelease.promise;
-      };
-
-      const eventsFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter((event) => event.threadId === threadId),
-        Stream.take(4),
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-      const turn = yield* adapter.sendTurn({
-        threadId,
-        input: "Keep working",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-
-      const firstInterrupt = yield* adapter
-        .interruptTurn(threadId, turn.turnId)
-        .pipe(Effect.forkChild);
-      const secondInterrupt = yield* adapter
-        .interruptTurn(threadId, turn.turnId)
-        .pipe(Effect.forkChild);
-      yield* Effect.promise(() => abortStarted.promise);
-      yield* Effect.yieldNow;
-      NodeAssert.equal(runtimeMock.state.abortCalls.length, 1);
-
-      abortRelease.resolve(undefined);
-      yield* Fiber.join(firstInterrupt);
-      yield* Fiber.join(secondInterrupt);
-
-      const events = Array.from(yield* Fiber.join(eventsFiber).pipe(Effect.timeout("1 second")));
-      NodeAssert.deepEqual(
-        events
-          .filter((event) => event.type === "turn.completed" || event.type === "turn.aborted")
-          .map((event) => event.type),
-        ["turn.aborted"],
-      );
-
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("accepts a native turnless abort before its request times out", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-turnless-interrupt");
-      const abortEvent = promiseWithResolvers<unknown>();
-      const markerEvent = promiseWithResolvers<unknown>();
-      const abortStarted = promiseWithResolvers<void>();
-      runtimeMock.state.subscribedEvents = [abortEvent.promise, markerEvent.promise];
-      runtimeMock.state.abortImplementation = async () => {
-        abortStarted.resolve(undefined);
-        await new Promise<void>(() => {});
-      };
-
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-        resumeCursor: { schemaVersion: 1, sessionId: "ses_existing" },
-      });
-      const acknowledgmentFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter(
-          (event) =>
-            event.threadId === threadId &&
-            (event.type === "turn.completed" ||
-              event.type === "turn.aborted" ||
-              event.type === "runtime.error" ||
-              event.type === "thread.metadata.updated"),
-        ),
-        Stream.runHead,
-        Effect.forkChild,
-      );
-      const firstInterrupt = yield* adapter.interruptTurn(threadId).pipe(Effect.forkChild);
-      yield* Effect.promise(() => abortStarted.promise);
-      const secondInterrupt = yield* adapter.interruptTurn(threadId).pipe(Effect.forkChild);
-      runtimeMock.state.sessionStatusImplementation = async () => ({
-        data: { ses_existing: { type: "busy" as const } },
-      });
-      const sendFiber = yield* adapter
-        .sendTurn({
-          threadId,
-          input: "Start after the session abort",
-          modelSelection: createModelSelection(
-            ProviderInstanceId.make("opencode"),
-            "opencode/kimi-k3",
-          ),
-        })
-        .pipe(Effect.forkChild);
-      yield* Effect.yieldNow;
-
-      NodeAssert.equal(runtimeMock.state.abortCalls.length, 1);
-      NodeAssert.equal(runtimeMock.state.promptCalls.length, 0);
-
-      abortEvent.resolve({
-        id: "evt-turnless-abort",
-        type: "session.error",
-        properties: {
-          sessionID: "ses_existing",
-          error: { name: "MessageAbortedError", data: { message: "Aborted" } },
-        },
-      });
-      markerEvent.resolve({
-        id: "evt-after-turnless-abort",
-        type: "session.updated",
-        properties: {
-          info: { id: "ses_existing", title: "Turnless abort acknowledged" },
-        },
-      });
-      const acknowledgment = Option.getOrUndefined(yield* Fiber.join(acknowledgmentFiber));
-      NodeAssert.equal(acknowledgment?.type, "thread.metadata.updated");
-      const unexpectedEventFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter(
-          (event) =>
-            event.threadId === threadId &&
-            (event.type === "turn.completed" ||
-              event.type === "turn.aborted" ||
-              event.type === "runtime.error"),
-        ),
-        Stream.runHead,
-        Effect.forkChild,
-      );
-      yield* advanceTestClock(10_000);
-      yield* Fiber.join(firstInterrupt);
-      yield* Fiber.join(secondInterrupt);
-      yield* Fiber.join(sendFiber);
-
-      NodeAssert.equal(runtimeMock.state.promptCalls.length, 1);
-      NodeAssert.equal(runtimeMock.state.abortSignals[0]?.aborted, true);
-      NodeAssert.equal(unexpectedEventFiber.pollUnsafe(), undefined);
-      yield* Fiber.interrupt(unexpectedEventFiber);
-      runtimeMock.state.abortImplementation = null;
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("ignores a native turnless abort after its request succeeds", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-late-turnless-abort");
-      const abortEvent = promiseWithResolvers<unknown>();
-      const markerEvent = promiseWithResolvers<unknown>();
-      runtimeMock.state.subscribedEvents = [abortEvent.promise, markerEvent.promise];
-
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-        resumeCursor: { schemaVersion: 1, sessionId: "ses_existing" },
-      });
-      const acknowledgmentFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter(
-          (event) =>
-            event.threadId === threadId &&
-            (event.type === "turn.completed" ||
-              event.type === "turn.aborted" ||
-              event.type === "runtime.error" ||
-              event.type === "thread.metadata.updated"),
-        ),
-        Stream.runHead,
-        Effect.forkChild,
-      );
-
-      yield* adapter.interruptTurn(threadId);
-      abortEvent.resolve({
-        id: "evt-late-turnless-abort",
-        type: "session.error",
-        properties: {
-          sessionID: "ses_existing",
-          error: { name: "MessageAbortedError", data: { message: "Aborted" } },
-        },
-      });
-      markerEvent.resolve({
-        id: "evt-after-late-turnless-abort",
-        type: "session.updated",
-        properties: {
-          info: { id: "ses_existing", title: "Late turnless abort ignored" },
-        },
-      });
-      const acknowledgment = Option.getOrUndefined(yield* Fiber.join(acknowledgmentFiber));
-
-      NodeAssert.equal(acknowledgment?.type, "thread.metadata.updated");
-      const sessions = yield* adapter.listSessions();
-      const session = sessions.find((candidate) => candidate.threadId === threadId);
-      NodeAssert.equal(session?.status, "ready");
-      NodeAssert.equal(session?.activeTurnId, undefined);
-
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("clears a failed turnless interrupt before the next turn", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-turnless-interrupt-failure");
-      runtimeMock.state.abortImplementation = async () => {
-        throw new Error("abort failed");
-      };
-
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-        resumeCursor: { schemaVersion: 1, sessionId: "ses_existing" },
-      });
-      const interruptExit = yield* Effect.exit(adapter.interruptTurn(threadId));
-      NodeAssert.equal(Exit.isFailure(interruptExit), true);
-
-      runtimeMock.state.abortImplementation = null;
-      yield* adapter.sendTurn({
-        threadId,
-        input: "Start after the failed session abort",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      NodeAssert.equal(runtimeMock.state.promptCalls.length, 1);
-
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("waits for a pending stop before starting the next turn", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-send-during-stop");
-      const abortStarted = promiseWithResolvers<void>();
-      const abortRelease = promiseWithResolvers<void>();
-      runtimeMock.state.abortImplementation = async () => {
-        abortStarted.resolve(undefined);
-        await abortRelease.promise;
-      };
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-      const stoppedTurn = yield* adapter.sendTurn({
-        threadId,
-        input: "First turn",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      const stopFiber = yield* adapter
-        .interruptTurn(threadId, stoppedTurn.turnId)
-        .pipe(Effect.forkChild);
-      yield* Effect.promise(() => abortStarted.promise);
-      const sendFiber = yield* adapter
-        .sendTurn({
-          threadId,
-          input: "Second turn",
-          modelSelection: createModelSelection(
-            ProviderInstanceId.make("opencode"),
-            "opencode/kimi-k3",
-          ),
-        })
-        .pipe(Effect.forkChild);
-      yield* Effect.yieldNow;
-      NodeAssert.equal(runtimeMock.state.promptCalls.length, 1);
-      abortRelease.resolve(undefined);
-      yield* Fiber.join(stopFiber);
-      const nextTurn = yield* Fiber.join(sendFiber);
-
-      NodeAssert.notEqual(nextTurn.turnId, stoppedTurn.turnId);
-      NodeAssert.equal(runtimeMock.state.promptCalls.length, 2);
-    }),
-  );
-
-  it.effect("interrupts a turn waiting on cancellation when the session stops", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-stop-during-cancellation");
-      const firstAbortStarted = promiseWithResolvers<void>();
-      const teardownAbortStarted = promiseWithResolvers<void>();
-      const abortRelease = promiseWithResolvers<void>();
-      runtimeMock.state.abortImplementation = async () => {
-        if (runtimeMock.state.abortCalls.length === 1) {
-          firstAbortStarted.resolve(undefined);
-        } else {
-          teardownAbortStarted.resolve(undefined);
-        }
-        await abortRelease.promise;
-      };
-
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-      const activeTurn = yield* adapter.sendTurn({
-        threadId,
-        input: "First turn",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      const interruptFiber = yield* adapter
-        .interruptTurn(threadId, activeTurn.turnId)
-        .pipe(Effect.forkChild);
-      yield* Effect.promise(() => firstAbortStarted.promise);
-
-      const sendFiber = yield* adapter
-        .sendTurn({
-          threadId,
-          input: "Must not be sent",
-          modelSelection: createModelSelection(
-            ProviderInstanceId.make("opencode"),
-            "opencode/kimi-k3",
-          ),
-        })
-        .pipe(Effect.exit, Effect.forkChild);
-      yield* Effect.yieldNow;
-      NodeAssert.equal(runtimeMock.state.promptCalls.length, 1);
-
-      const stopFiber = yield* adapter.stopSession(threadId).pipe(Effect.forkChild);
-      const sendResult = yield* Fiber.join(sendFiber);
-      NodeAssert.equal(Exit.isFailure(sendResult), true);
-      if (Exit.isFailure(sendResult)) {
-        NodeAssert.equal(Cause.hasInterruptsOnly(sendResult.cause), true);
-      }
-      NodeAssert.equal(runtimeMock.state.promptCalls.length, 1);
-
-      yield* Effect.promise(() => teardownAbortStarted.promise);
-      yield* advanceTestClock(1_000);
-      yield* Fiber.join(stopFiber);
-      NodeAssert.equal(yield* adapter.hasSession(threadId), false);
-
-      abortRelease.resolve(undefined);
-      yield* Fiber.join(interruptFiber);
-      NodeAssert.equal(runtimeMock.state.promptCalls.length, 1);
-      NodeAssert.equal(yield* adapter.hasSession(threadId), false);
-    }),
-  );
-
-  it.effect("rechecks a newer idle after an older status call returns busy", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-newer-idle-during-status");
-      const busyEvent = promiseWithResolvers<unknown>();
-      const staleIdle = promiseWithResolvers<unknown>();
-      const realIdle = promiseWithResolvers<unknown>();
-      const statusStarted = promiseWithResolvers<void>();
-      const statusRelease = promiseWithResolvers<void>();
-      runtimeMock.state.subscribedEvents = [busyEvent.promise, staleIdle.promise, realIdle.promise];
-      runtimeMock.state.sessionStatusImplementation = async () => {
-        if (runtimeMock.state.sessionStatusCalls === 1) {
-          statusStarted.resolve(undefined);
-          await statusRelease.promise;
-          return {
-            data: { "http://127.0.0.1:9999/session": { type: "busy" as const } },
-          };
-        }
-        return { data: {} };
-      };
-
-      const completedFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter((event) => event.threadId === threadId && event.type === "turn.completed"),
-        Stream.runHead,
-        Effect.forkChild,
-      );
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-      const firstTurn = yield* adapter.sendTurn({
-        threadId,
-        input: "First turn",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      yield* adapter.interruptTurn(threadId, firstTurn.turnId);
-      const secondTurn = yield* adapter.sendTurn({
-        threadId,
-        input: "Second turn",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      busyEvent.resolve({
-        id: "evt-new-turn-busy",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "busy" },
-        },
-      });
-      staleIdle.resolve({
-        id: "evt-old-idle",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "idle" },
-        },
-      });
-      yield* Effect.promise(() => statusStarted.promise);
-      realIdle.resolve({
-        id: "evt-new-idle",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "idle" },
-        },
-      });
-      statusRelease.resolve(undefined);
-
-      const completed = Option.getOrUndefined(
-        yield* Fiber.join(completedFiber).pipe(Effect.timeout("1 second")),
-      );
-      NodeAssert.equal(completed?.turnId, secondTurn.turnId);
-      NodeAssert.equal(runtimeMock.state.sessionStatusCalls, 2);
-    }),
-  );
-
-  it.effect("completes after transient status failures without another idle event", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-idle-status-retry");
-      const busyEvent = promiseWithResolvers<unknown>();
-      const idleEvent = promiseWithResolvers<unknown>();
-      const failuresObserved = promiseWithResolvers<void>();
-      runtimeMock.state.subscribedEvents = [busyEvent.promise, idleEvent.promise];
-      runtimeMock.state.sessionStatusImplementation = async () => {
-        if (runtimeMock.state.sessionStatusCalls <= 2) {
-          if (runtimeMock.state.sessionStatusCalls === 2) {
-            failuresObserved.resolve(undefined);
-          }
-          throw new Error("status failed");
-        }
-        return { data: {} };
-      };
-
-      const completedFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter((event) => event.threadId === threadId && event.type === "turn.completed"),
-        Stream.runHead,
-        Effect.forkChild,
-      );
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-      const firstTurn = yield* adapter.sendTurn({
-        threadId,
-        input: "First turn",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      yield* adapter.interruptTurn(threadId, firstTurn.turnId);
-      const secondTurn = yield* adapter.sendTurn({
-        threadId,
-        input: "Second turn",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      busyEvent.resolve({
-        id: "evt-retry-turn-busy",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "busy" },
-        },
-      });
-      idleEvent.resolve({
-        id: "evt-retry-turn-idle",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "idle" },
-        },
-      });
-      yield* Effect.promise(() => failuresObserved.promise);
-      yield* advanceTestClock(250);
-
-      const completed = Option.getOrUndefined(
-        yield* Fiber.join(completedFiber).pipe(Effect.timeout("1 second")),
-      );
-      NodeAssert.equal(completed?.turnId, secondTurn.turnId);
-      NodeAssert.equal(runtimeMock.state.sessionStatusCalls, 3);
-    }),
-  );
-
-  it.effect("keeps idle reconciliation after a delayed abort from the stopped turn", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-stale-abort-during-idle-check");
-      const busyEvent = promiseWithResolvers<unknown>();
-      const idleEvent = promiseWithResolvers<unknown>();
-      const staleAbortEvent = promiseWithResolvers<unknown>();
-      const statusStarted = promiseWithResolvers<void>();
-      const statusRelease = promiseWithResolvers<void>();
-      runtimeMock.state.subscribedEvents = [
-        busyEvent.promise,
-        idleEvent.promise,
-        staleAbortEvent.promise,
-      ];
-      runtimeMock.state.sessionStatusImplementation = async () => {
-        statusStarted.resolve(undefined);
-        await statusRelease.promise;
-        return { data: {} };
-      };
-
-      const completedFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter((event) => event.threadId === threadId && event.type === "turn.completed"),
-        Stream.runHead,
-        Effect.forkChild,
-      );
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-      const stoppedTurn = yield* adapter.sendTurn({
-        threadId,
-        input: "First turn",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      yield* adapter.interruptTurn(threadId, stoppedTurn.turnId);
-      const activeTurn = yield* adapter.sendTurn({
-        threadId,
-        input: "Second turn",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      busyEvent.resolve({
-        id: "evt-stale-abort-busy",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "busy" },
-        },
-      });
-      idleEvent.resolve({
-        id: "evt-stale-abort-idle",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "idle" },
-        },
-      });
-      yield* Effect.promise(() => statusStarted.promise);
-      staleAbortEvent.resolve({
-        id: "evt-delayed-old-abort",
-        type: "session.error",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          error: { name: "MessageAbortedError", data: { message: "Aborted" } },
-        },
-      });
-      statusRelease.resolve(undefined);
-
-      const completed = Option.getOrUndefined(
-        yield* Fiber.join(completedFiber).pipe(Effect.timeout("1 second")),
-      );
-      NodeAssert.equal(completed?.turnId, activeTurn.turnId);
-    }),
-  );
-
-  it.effect("keeps the newer turn running while status lookup keeps failing", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-idle-status-permanent-failure");
-      const busyEvent = promiseWithResolvers<unknown>();
-      const idleEvent = promiseWithResolvers<unknown>();
-      const firstAttemptFailed = promiseWithResolvers<void>();
-      const retryAttemptFailed = promiseWithResolvers<void>();
-      runtimeMock.state.subscribedEvents = [busyEvent.promise, idleEvent.promise];
-      runtimeMock.state.sessionStatusImplementation = async () => {
-        if (runtimeMock.state.sessionStatusCalls === 2) {
-          firstAttemptFailed.resolve(undefined);
-        }
-        if (runtimeMock.state.sessionStatusCalls === 4) {
-          retryAttemptFailed.resolve(undefined);
-        }
-        throw new Error("status remains unavailable");
-      };
-
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-      const stoppedTurn = yield* adapter.sendTurn({
-        threadId,
-        input: "First turn",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      yield* adapter.interruptTurn(threadId, stoppedTurn.turnId);
-      const activeTurn = yield* adapter.sendTurn({
-        threadId,
-        input: "Second turn",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      busyEvent.resolve({
-        id: "evt-permanent-failure-busy",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "busy" },
-        },
-      });
-      idleEvent.resolve({
-        id: "evt-permanent-failure-idle",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "idle" },
-        },
-      });
-      yield* Effect.promise(() => firstAttemptFailed.promise);
-      yield* advanceTestClock(250);
-      yield* Effect.promise(() => retryAttemptFailed.promise);
-
-      const sessions = yield* adapter.listSessions();
-      const session = sessions.find((candidate) => candidate.threadId === threadId);
-      NodeAssert.equal(session?.status, "running");
-      NodeAssert.equal(session?.activeTurnId, activeTurn.turnId);
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("ignores delayed stop events around the next turn startup", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-delayed-interrupt-events");
-      const staleIdleBeforeBusy = promiseWithResolvers<unknown>();
-      const nextBusy = promiseWithResolvers<unknown>();
-      const nextUserMessage = promiseWithResolvers<unknown>();
-      const staleAbort = promiseWithResolvers<unknown>();
-      const staleIdle = promiseWithResolvers<unknown>();
-      const secondStaleIdle = promiseWithResolvers<unknown>();
-      const nextIdle = promiseWithResolvers<unknown>();
-      runtimeMock.state.autoPromptEcho = false;
-      runtimeMock.state.subscribedEvents = [
-        staleIdleBeforeBusy.promise,
-        nextBusy.promise,
-        nextUserMessage.promise,
-        staleAbort.promise,
-        staleIdle.promise,
-        secondStaleIdle.promise,
-        nextIdle.promise,
-      ];
-
-      const eventsFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter((event) => event.threadId === threadId),
-        Stream.take(6),
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-      const firstTurn = yield* adapter.sendTurn({
-        threadId,
-        input: "First turn",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      yield* adapter.interruptTurn(threadId, firstTurn.turnId);
-      const secondTurn = yield* adapter.sendTurn({
-        threadId,
-        input: "Second turn",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-      const secondMessageId = (runtimeMock.state.promptCalls.at(-1) as { messageID: string })
-        .messageID;
-
-      staleIdleBeforeBusy.resolve({
-        id: "evt-delayed-idle-before-busy",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "idle" },
-        },
-      });
-      for (let index = 0; index < 2; index += 1) {
-        yield* Effect.yieldNow;
-      }
-      const sessionsBeforeBusy = yield* adapter.listSessions();
-      const sessionBeforeBusy = sessionsBeforeBusy.find(
-        (candidate) => candidate.threadId === threadId,
-      );
-      NodeAssert.equal(sessionBeforeBusy?.status, "running");
-      NodeAssert.equal(sessionBeforeBusy?.activeTurnId, secondTurn.turnId);
-
-      runtimeMock.state.sessionStatus = "busy";
-      nextBusy.resolve({
-        id: "evt-next-busy",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "busy" },
-        },
-      });
-      nextUserMessage.resolve({
-        id: "evt-next-user-message",
-        type: "message.updated",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          info: { id: secondMessageId, role: "user" },
-        },
-      });
-      staleAbort.resolve({
-        id: "evt-delayed-abort",
-        type: "session.error",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          error: { name: "MessageAbortedError", data: { message: "Aborted" } },
-        },
-      });
-      staleIdle.resolve({
-        id: "evt-delayed-idle",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "idle" },
-        },
-      });
-      secondStaleIdle.resolve({
-        id: "evt-second-delayed-idle",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "idle" },
-        },
-      });
-      for (let index = 0; index < 4; index += 1) {
-        yield* Effect.yieldNow;
-      }
-
-      const sessionsBeforeRealIdle = yield* adapter.listSessions();
-      const sessionBeforeRealIdle = sessionsBeforeRealIdle.find(
-        (candidate) => candidate.threadId === threadId,
-      );
-      NodeAssert.equal(sessionBeforeRealIdle?.status, "running");
-      NodeAssert.equal(sessionBeforeRealIdle?.activeTurnId, secondTurn.turnId);
-
-      runtimeMock.state.sessionStatus = "idle";
-      nextIdle.resolve({
-        id: "evt-next-idle",
-        type: "session.status",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          status: { type: "idle" },
-        },
-      });
-
-      const events = Array.from(yield* Fiber.join(eventsFiber).pipe(Effect.timeout("1 second")));
-      NodeAssert.deepEqual(
-        events
-          .filter(
-            (event) =>
-              event.type === "turn.completed" ||
-              event.type === "turn.aborted" ||
-              event.type === "runtime.error",
-          )
-          .map((event) => ({ type: event.type, turnId: event.turnId })),
-        [
-          { type: "turn.aborted", turnId: firstTurn.turnId },
-          { type: "turn.completed", turnId: secondTurn.turnId },
-        ],
-      );
-
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("keeps a genuine provider error visible during a pending user stop", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-interrupt-provider-error");
-      const errorEvent = promiseWithResolvers<unknown>();
-      const abortStarted = promiseWithResolvers<void>();
-      const abortRelease = promiseWithResolvers<void>();
-      runtimeMock.state.subscribedEvents = [errorEvent.promise];
-      runtimeMock.state.abortImplementation = async () => {
-        abortStarted.resolve(undefined);
-        await abortRelease.promise;
-      };
-
-      const eventsFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter((event) => event.threadId === threadId),
-        Stream.take(5),
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-      const turn = yield* adapter.sendTurn({
-        threadId,
-        input: "Keep working",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode"),
-          "opencode/kimi-k3",
-        ),
-      });
-
-      const interruptFiber = yield* adapter
-        .interruptTurn(threadId, turn.turnId)
-        .pipe(Effect.forkChild);
-      yield* Effect.promise(() => abortStarted.promise);
-      errorEvent.resolve({
-        id: "evt-provider-error-after-stop",
-        type: "session.error",
-        properties: {
-          sessionID: "http://127.0.0.1:9999/session",
-          error: {
-            name: "APIError",
-            data: { message: "Upstream failed", isRetryable: false },
-          },
-        },
-      });
-      yield* Effect.yieldNow;
-      abortRelease.resolve(undefined);
-      yield* Fiber.join(interruptFiber);
-
-      const events = Array.from(yield* Fiber.join(eventsFiber).pipe(Effect.timeout("1 second")));
-      NodeAssert.deepEqual(
-        events
-          .filter(
-            (event) =>
-              event.type === "turn.completed" ||
-              event.type === "turn.aborted" ||
-              event.type === "runtime.error",
-          )
-          .map((event) => event.type),
-        ["turn.completed", "runtime.error"],
-      );
-      const failed = events.find((event) => event.type === "turn.completed");
-      NodeAssert.equal(
-        failed?.type === "turn.completed" ? failed.payload.state : undefined,
-        "failed",
-      );
-
-      yield* adapter.stopSession(threadId);
-    }),
-  );
-
-  it.effect("passes agent and variant options for the adapter's bound custom instance id", () => {
-    const instanceId = ProviderInstanceId.make("opencode_zen");
-    const adapterLayer = Layer.effect(
-      OpenCodeAdapter,
-      makeOpenCodeAdapter(openCodeAdapterTestSettings, { instanceId }),
-    ).pipe(
-      Layer.provideMerge(Layer.succeed(OpenCodeRuntime, OpenCodeRuntimeTestDouble)),
-      Layer.provideMerge(ServerConfig.layerTest(process.cwd(), process.cwd())),
-      Layer.provideMerge(ServerSettingsService.layerTest()),
-      Layer.provideMerge(providerSessionDirectoryTestLayer),
-      Layer.provideMerge(NodeServices.layer),
-    );
-
-    return Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId: asThreadId("thread-custom-instance"),
-        runtimeMode: "full-access",
-      });
-
-      yield* adapter.sendTurn({
-        threadId: asThreadId("thread-custom-instance"),
-        input: "Fix it",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode_zen"),
-          "anthropic/claude-sonnet-4-5",
-          [
-            { id: "agent", value: "github-copilot" },
-            { id: "variant", value: "high" },
-          ],
-        ),
-      });
-
-      const { messageID, ...prompt } = runtimeMock.state.promptCalls.at(-1) as {
-        messageID: string;
-        [key: string]: unknown;
-      };
-      NodeAssert.match(messageID, /^msg_[0-9a-f]{12}[0-9A-Za-z]{14}$/);
-      NodeAssert.deepEqual(prompt, {
-        sessionID: "http://127.0.0.1:9999/session",
-        model: {
-          providerID: "anthropic",
-          modelID: "claude-sonnet-4-5",
-        },
-        agent: "github-copilot",
-        variant: "high",
-        parts: [{ type: "text", text: "Fix it" }],
-      });
-    }).pipe(Effect.provide(adapterLayer));
-  });
-
-  it.effect("uses the bound custom instance id for fallback sendTurn model selection", () => {
-    const instanceId = ProviderInstanceId.make("opencode_zen");
-    const adapterLayer = Layer.effect(
-      OpenCodeAdapter,
-      makeOpenCodeAdapter(openCodeAdapterTestSettings, { instanceId }),
-    ).pipe(
-      Layer.provideMerge(Layer.succeed(OpenCodeRuntime, OpenCodeRuntimeTestDouble)),
-      Layer.provideMerge(ServerConfig.layerTest(process.cwd(), process.cwd())),
-      Layer.provideMerge(ServerSettingsService.layerTest()),
-      Layer.provideMerge(providerSessionDirectoryTestLayer),
-      Layer.provideMerge(NodeServices.layer),
-    );
-
-    return Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-custom-instance-fallback-model");
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("opencode_zen"),
-          "anthropic/claude-sonnet-4-5",
-        ),
-      });
-
-      yield* adapter.sendTurn({
-        threadId,
-        input: "Fix it",
-      });
-
-      const { messageID, ...prompt } = runtimeMock.state.promptCalls.at(-1) as {
-        messageID: string;
-        [key: string]: unknown;
-      };
-      NodeAssert.match(messageID, /^msg_[0-9a-f]{12}[0-9A-Za-z]{14}$/);
-      NodeAssert.deepEqual(prompt, {
-        sessionID: "http://127.0.0.1:9999/session",
-        model: {
-          providerID: "anthropic",
-          modelID: "claude-sonnet-4-5",
-        },
-        parts: [{ type: "text", text: "Fix it" }],
-      });
-    }).pipe(Effect.provide(adapterLayer));
-  });
-
-  it.effect("rejects sendTurn model selections for another instance id", () => {
-    const instanceId = ProviderInstanceId.make("opencode_zen");
-    const adapterLayer = Layer.effect(
-      OpenCodeAdapter,
-      makeOpenCodeAdapter(openCodeAdapterTestSettings, { instanceId }),
-    ).pipe(
-      Layer.provideMerge(Layer.succeed(OpenCodeRuntime, OpenCodeRuntimeTestDouble)),
-      Layer.provideMerge(ServerConfig.layerTest(process.cwd(), process.cwd())),
-      Layer.provideMerge(ServerSettingsService.layerTest()),
-      Layer.provideMerge(providerSessionDirectoryTestLayer),
-      Layer.provideMerge(NodeServices.layer),
-    );
-
-    return Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-custom-instance-wrong-selection");
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-
-      const error = yield* adapter
-        .sendTurn({
-          threadId,
-          input: "Fix it",
-          modelSelection: createModelSelection(
-            ProviderInstanceId.make("opencode"),
-            "anthropic/claude-sonnet-4-5",
-          ),
-        })
-        .pipe(Effect.flip);
-
-      NodeAssert.equal(error._tag, "ProviderAdapterValidationError");
-      if (error._tag !== "ProviderAdapterValidationError") {
-        throw new Error("Unexpected error type");
-      }
-      NodeAssert.equal(
-        error.issue,
-        "OpenCode model selection is bound to instance 'opencode', expected 'opencode_zen'.",
-      );
-      NodeAssert.deepEqual(runtimeMock.state.promptCalls, []);
-    }).pipe(Effect.provide(adapterLayer));
-  });
-
-  it.effect("reverts the full thread when rollback removes every assistant turn", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-rollback-all");
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-
-      runtimeMock.state.messages = [
-        {
-          info: { id: "assistant-1", role: "assistant" },
-          parts: [],
-        },
-        {
-          info: { id: "assistant-2", role: "assistant" },
-          parts: [],
-        },
-      ];
-
-      const snapshot = yield* adapter.rollbackThread(threadId, 2);
-
-      NodeAssert.deepEqual(runtimeMock.state.revertCalls, [
-        { sessionID: "http://127.0.0.1:9999/session" },
-      ]);
-      NodeAssert.deepEqual(snapshot.turns, []);
-    }),
-  );
-
-  it.effect("classifies a confirmed not-found across the shapes the SDK/runtime can produce", () =>
-    Effect.sync(() => {
-      // The real production shape: runOpenCodeSdk wraps the thrown Error
-      // (cause = { body, status }) under OpenCodeRuntimeError.
-      const wrappedError = new Error("Session not found: ses_x", {
-        cause: { body: { name: "NotFoundError" }, status: 404 },
-      });
-      NodeAssert.equal(
-        isOpenCodeNotFound({
-          _tag: "OpenCodeRuntimeError",
-          operation: "session.get",
-          detail: "Session not found: ses_x",
-          cause: wrappedError,
-        }),
-        true,
-      );
-
-      // 404 expressed only via response.status (the bot's flagged shape).
-      NodeAssert.equal(isOpenCodeNotFound({ cause: { response: { status: 404 } } }), true);
-      // 404 via a bare numeric status / statusCode.
-      NodeAssert.equal(isOpenCodeNotFound(new Error("x", { cause: { status: 404 } })), true);
-      NodeAssert.equal(isOpenCodeNotFound({ statusCode: 404 }), true);
-      // OpenCode NotFoundError body name with no status.
-      NodeAssert.equal(isOpenCodeNotFound({ body: { name: "NotFoundError" } }), true);
-
-      // NOT a miss: only structured signals count, never free text. A non-404
-      // error whose message/detail merely contains "not found" must propagate,
-      // not be misread as a missing session and silently start fresh.
-      NodeAssert.equal(
-        isOpenCodeNotFound(new Error("upstream provider not found", { cause: { status: 500 } })),
-        false,
-      );
-      NodeAssert.equal(isOpenCodeNotFound({ detail: "status=500 body={...not found...}" }), false);
-      // An explicit non-404 status seals its subtree: a 500 whose serialized
-      // body echoes a NotFoundError name — or that is itself named
-      // *NotFound* — is a real failure, never a miss.
-      NodeAssert.equal(isOpenCodeNotFound({ status: 500, body: { name: "NotFoundError" } }), false);
-      NodeAssert.equal(isOpenCodeNotFound({ name: "UpstreamNotFoundError", status: 500 }), false);
-      // A "NotFound"-flavored name that isn't OpenCode's exact `NotFoundError`
-      // is not a confirmed miss even without a sealing status.
-      NodeAssert.equal(isOpenCodeNotFound({ name: "UpstreamNotFoundError" }), false);
-      NodeAssert.equal(isOpenCodeNotFound({ cause: { name: "ProviderNotFoundError" } }), false);
-      NodeAssert.equal(
-        isOpenCodeNotFound(
-          new Error("x", { cause: { status: 502, body: { name: "NotFoundError" } } }),
-        ),
-        false,
-      );
-      // Other transient/auth/network failures must propagate too.
-      NodeAssert.equal(isOpenCodeNotFound(new Error("boom", { cause: { status: 500 } })), false);
-      NodeAssert.equal(isOpenCodeNotFound({ cause: { response: { status: 401 } } }), false);
-      NodeAssert.equal(isOpenCodeNotFound(new Error("network error (no response)")), false);
-      NodeAssert.equal(isOpenCodeNotFound(undefined), false);
-    }),
-  );
-
-  it.effect("treats lexically or physically identical directories as the same", () =>
-    Effect.gen(function* () {
-      const fileSystem = yield* FileSystem.FileSystem;
-      const path = yield* Path.Path;
-      const sameDirectory = (left: string, right: string) =>
-        isSameOpenCodeDirectory(fileSystem, path, left, right);
-
-      // Lexical-only differences (trailing slash, dot segments) short-circuit
-      // without touching the filesystem — the paths need not exist.
-      NodeAssert.equal(yield* sameDirectory("/repo/project/", "/repo/project"), true);
-      NodeAssert.equal(yield* sameDirectory("/repo/nested/../project", "/repo/project"), true);
-      // Nonexistent paths degrade to the lexical comparison instead of failing.
-      NodeAssert.equal(yield* sameDirectory("/repo/project", "/repo/other"), false);
-
-      // A symlinked cwd (the macOS `/tmp` → `/private/tmp` shape) resolves to
-      // the directory it points at, so the two spellings compare equal.
-      const base = yield* fileSystem.makeTempDirectoryScoped({ prefix: "t3-opencode-dir-" });
-      const real = path.join(base, "real");
-      const link = path.join(base, "link");
-      yield* fileSystem.makeDirectory(real);
-      yield* fileSystem.symlink(real, link);
-      NodeAssert.equal(yield* sameDirectory(link, real), true);
-      NodeAssert.equal(yield* sameDirectory(link, path.join(base, "other")), false);
-    }).pipe(Effect.scoped),
-  );
-
-  it.effect("appends raw assistant text deltas and reconciles part update snapshots", () =>
-    Effect.sync(() => {
-      const firstUpdate = mergeOpenCodeAssistantText(undefined, "Hello");
-      const overlapDelta = appendOpenCodeAssistantTextDelta(firstUpdate.latestText, "lo world");
-      const secondUpdate = mergeOpenCodeAssistantText(overlapDelta.nextText, "Hellolo world");
-
-      NodeAssert.deepEqual(
-        [firstUpdate.deltaToEmit, overlapDelta.deltaToEmit, secondUpdate.deltaToEmit],
-        ["Hello", "lo world", ""],
-      );
-      NodeAssert.equal(secondUpdate.latestText, "Hellolo world");
-    }),
-  );
-
-  it.effect("does not strip coincidental prefix overlap from OpenCode part deltas", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-opencode-raw-delta");
-      const part = {
-        id: "part-raw-delta",
-        sessionID: "http://127.0.0.1:9999/session",
-        messageID: "msg-raw-delta",
-        type: "text",
-        text: "A B",
-        time: { start: 1 },
-      };
-      runtimeMock.state.subscribedEvents = [
-        {
-          type: "message.updated",
-          properties: {
-            sessionID: "http://127.0.0.1:9999/session",
-            info: {
-              id: "msg-raw-delta",
-              role: "assistant",
-            },
-          },
-        },
-        {
-          type: "message.part.updated",
-          properties: {
-            sessionID: "http://127.0.0.1:9999/session",
-            part,
-            time: 1,
-          },
-        },
-        {
-          type: "message.part.delta",
-          properties: {
-            sessionID: "http://127.0.0.1:9999/session",
-            messageID: "msg-raw-delta",
-            partID: "part-raw-delta",
-            field: "text",
-            delta: "Bonus",
-          },
-        },
-        {
-          type: "message.part.updated",
-          properties: {
-            sessionID: "http://127.0.0.1:9999/session",
-            part: {
-              ...part,
-              text: "A BBonus",
-              time: { start: 1, end: 2 },
-            },
-            time: 2,
-          },
-        },
-      ];
-      const eventsFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter((event) => event.threadId === threadId),
-        Stream.take(5),
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-
-      const events = Array.from(yield* Fiber.join(eventsFiber).pipe(Effect.timeout("1 second")));
-      const deltas = events.filter((event) => event.type === "content.delta");
-      NodeAssert.deepEqual(
-        deltas.map((event) => (event.type === "content.delta" ? event.payload.delta : "")),
-        ["A B", "Bonus"],
-      );
-      NodeAssert.equal(events.at(-1)?.type, "item.completed");
-      const completed = events.at(-1);
-      if (completed?.type === "item.completed") {
-        NodeAssert.equal(completed.payload.detail, "A BBonus");
-      }
-    }),
-  );
-
-  it.effect("lets OpenCode own session title generation and emits title metadata updates", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-opencode-title-sync");
-      runtimeMock.state.subscribedEvents = [
-        {
-          type: "session.updated",
-          properties: {
-            info: {
-              id: "http://127.0.0.1:9999/session",
-              title: "Investigate OpenCode title sync",
-            },
-          },
-        },
-      ];
-
-      const eventsFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter((event) => event.threadId === threadId),
-        Stream.take(3),
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-
-      const events = Array.from(yield* Fiber.join(eventsFiber).pipe(Effect.timeout("1 second")));
-      NodeAssert.equal(runtimeMock.state.sessionCreateInputs.length, 1);
-      NodeAssert.equal("title" in (runtimeMock.state.sessionCreateInputs[0] ?? {}), false);
-
-      const metadataUpdated = events.find((event) => event.type === "thread.metadata.updated");
-      NodeAssert.ok(metadataUpdated);
-      if (metadataUpdated.type === "thread.metadata.updated") {
-        NodeAssert.equal(metadataUpdated.payload.name, "Investigate OpenCode title sync");
-      }
-    }),
-  );
-
-  it.effect("passes the thread title to session.create when provided", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-opencode-title-provided");
-
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-        title: "Investigate reconnect failures",
-      });
-
-      NodeAssert.equal(runtimeMock.state.sessionCreateInputs.length, 1);
-      NodeAssert.equal(
-        runtimeMock.state.sessionCreateInputs[0]?.title,
-        "Investigate reconnect failures",
-      );
-    }),
-  );
-
-  it.effect("does not mirror OpenCode's default placeholder session titles", () =>
-    Effect.gen(function* () {
-      const adapter = yield* OpenCodeAdapter;
-      const threadId = asThreadId("thread-opencode-placeholder-title");
-      runtimeMock.state.subscribedEvents = [
-        {
-          type: "session.updated",
-          properties: {
-            info: {
-              id: "http://127.0.0.1:9999/session",
-              title: "New session - 2026-08-09T10:20:30.456Z",
-            },
-          },
-        },
-        {
-          type: "session.updated",
-          properties: {
-            info: {
-              id: "http://127.0.0.1:9999/session",
-              title: "Investigate reconnect failures",
-            },
-          },
-        },
-      ];
-
-      const eventsFiber = yield* adapter.streamEvents.pipe(
-        Stream.filter((event) => event.threadId === threadId),
-        Stream.take(3),
-        Stream.runCollect,
-        Effect.forkChild,
-      );
-
-      yield* adapter.startSession({
-        provider: ProviderDriverKind.make("opencode"),
-        threadId,
-        runtimeMode: "full-access",
-      });
-
-      const events = Array.from(yield* Fiber.join(eventsFiber).pipe(Effect.timeout("1 second")));
-      const metadataUpdated = events.filter((event) => event.type === "thread.metadata.updated");
-      NodeAssert.equal(metadataUpdated.length, 1);
-      if (metadataUpdated[0]?.type === "thread.metadata.updated") {
-        NodeAssert.equal(metadataUpdated[0].payload.name, "Investigate reconnect failures");
-      }
-    }),
-  );
-
-  it.effect("writes provider-native observability records using the session thread id", () =>
-    Effect.gen(function* () {
-      const nativeEvents: Array<{
-        readonly event?: {
-          readonly provider?: string;
-          readonly threadId?: string;
-          readonly providerThreadId?: string;
-          readonly type?: string;
-        };
-      }> = [];
-      const nativeThreadIds: Array<string | null> = [];
-      runtimeMock.state.subscribedEvents = [
-        {
-          type: "message.updated",
-          properties: {
-            info: {
-              id: "msg-missing-session",
-              role: "assistant",
-            },
-          },
-        },
-        {
-          type: "message.updated",
-          properties: {
-            sessionID: "http://127.0.0.1:9999/other-session",
-            info: {
-              id: "msg-other-session",
-              role: "assistant",
-            },
-          },
-        },
-        {
-          id: "evt-unrelated-child",
-          type: "session.created",
-          properties: {
-            sessionID: "ses_unrelated_child",
-            info: {
-              id: "ses_unrelated_child",
-              parentID: "ses_unrelated_parent",
-              title: "Unrelated child",
-            },
-          },
-        },
-        {
-          id: "evt-unrelated-permission",
-          type: "permission.asked",
-          properties: {
-            id: "per_unrelated",
-            sessionID: "ses_unrelated_child",
-            permission: "bash",
-            patterns: ["pwd"],
-            metadata: {},
-            always: [],
-          },
-        },
-        {
-          id: "evt-unrelated-question",
-          type: "question.asked",
-          properties: {
-            id: "que_unrelated",
-            sessionID: "ses_unrelated_child",
-            questions: [],
-          },
-        },
-        {
-          type: "message.updated",
-          properties: {
-            sessionID: "http://127.0.0.1:9999/session",
-            info: {
-              id: "msg-native-log",
-              role: "assistant",
-            },
-          },
-        },
-      ];
-
-      const nativeEventLogger = {
-        filePath: "memory://opencode-native-events",
-        write: (event: unknown, threadId: ThreadId | null) => {
-          nativeEvents.push(event as (typeof nativeEvents)[number]);
-          nativeThreadIds.push(threadId ?? null);
-          return Effect.void;
-        },
-        close: () => Effect.void,
-      };
-
-      const adapterLayer = Layer.effect(
-        OpenCodeAdapter,
-        makeOpenCodeAdapter(openCodeAdapterTestSettings, {
-          nativeEventLogger,
-        }),
-      ).pipe(
-        Layer.provideMerge(Layer.succeed(OpenCodeRuntime, OpenCodeRuntimeTestDouble)),
-        Layer.provideMerge(ServerConfig.layerTest(process.cwd(), process.cwd())),
-        Layer.provideMerge(
-          ServerSettingsService.layerTest({
-            providers: {
-              opencode: {
-                binaryPath: "fake-opencode",
-                serverUrl: "http://127.0.0.1:9999",
-                serverPassword: "secret-password",
-              },
-            },
-          }),
-        ),
-        Layer.provideMerge(providerSessionDirectoryTestLayer),
-        Layer.provideMerge(NodeServices.layer),
-      );
-
-      const session = yield* Effect.gen(function* () {
-        const adapter = yield* OpenCodeAdapter;
-        const started = yield* adapter.startSession({
-          provider: ProviderDriverKind.make("opencode"),
-          threadId: asThreadId("thread-native-log"),
-          runtimeMode: "full-access",
-        });
-        yield* advanceTestClock(10);
-        return started;
-      }).pipe(Effect.provide(adapterLayer));
-
-      NodeAssert.equal(session.threadId, "thread-native-log");
-      NodeAssert.equal(nativeEvents.length, 1);
-      NodeAssert.equal(
-        nativeEvents.some((record) => record.event?.provider === "opencode"),
-        true,
-      );
-      NodeAssert.equal(
-        nativeEvents.some(
-          (record) => record.event?.providerThreadId === "http://127.0.0.1:9999/session",
-        ),
-        true,
-      );
-      NodeAssert.equal(
-        nativeEvents.some((record) => record.event?.threadId === "thread-native-log"),
-        true,
-      );
-      NodeAssert.equal(
-        nativeEvents.some((record) => record.event?.type === "message.updated"),
-        true,
-      );
-      NodeAssert.equal(
-        nativeThreadIds.every((threadId) => threadId === "thread-native-log"),
-        true,
-      );
-    }),
-  );
-
-  it.effect("keeps the event pump alive when native event logging fails", () =>
-    Effect.gen(function* () {
-      runtimeMock.state.subscribedEvents = [
-        {
-          type: "message.updated",
-          properties: {
-            sessionID: "http://127.0.0.1:9999/session",
-            info: {
-              id: "msg-native-log-failure",
-              role: "assistant",
-            },
-          },
-        },
-      ];
-
-      const nativeEventLogger = {
-        filePath: "memory://opencode-native-events",
-        write: () => Effect.die(new Error("native log write failed")),
-        close: () => Effect.void,
-      };
-
-      const adapterLayer = Layer.effect(
-        OpenCodeAdapter,
-        makeOpenCodeAdapter(openCodeAdapterTestSettings, {
-          nativeEventLogger,
-        }),
-      ).pipe(
-        Layer.provideMerge(Layer.succeed(OpenCodeRuntime, OpenCodeRuntimeTestDouble)),
-        Layer.provideMerge(ServerConfig.layerTest(process.cwd(), process.cwd())),
-        Layer.provideMerge(
-          ServerSettingsService.layerTest({
-            providers: {
-              opencode: {
-                binaryPath: "fake-opencode",
-                serverUrl: "http://127.0.0.1:9999",
-                serverPassword: "secret-password",
-              },
-            },
-          }),
-        ),
-        Layer.provideMerge(providerSessionDirectoryTestLayer),
-        Layer.provideMerge(NodeServices.layer),
-      );
-
-      // Capture closeCalls *inside* the provided layer scope: the adapter's
-      // layer finalizer now tears down any live sessions when the layer
-      // closes (which is exactly what we want for leak prevention), so
-      // inspecting closeCalls after `Effect.provide` completes would observe
-      // the teardown — not the behavior under test. We care that the event
-      // pump kept the session alive while logging was failing.
-      const { sessions, closeCallsDuringRun } = yield* Effect.gen(function* () {
-        const adapter = yield* OpenCodeAdapter;
-        yield* adapter.startSession({
-          provider: ProviderDriverKind.make("opencode"),
-          threadId: asThreadId("thread-native-log-failure"),
-          runtimeMode: "full-access",
-        });
-        yield* advanceTestClock(10);
-        return {
-          sessions: yield* adapter.listSessions(),
-          closeCallsDuringRun: [...runtimeMock.state.closeCalls],
-        };
-      }).pipe(Effect.provide(adapterLayer));
-
-      NodeAssert.equal(sessions.length, 1);
-      NodeAssert.equal(sessions[0]?.threadId, "thread-native-log-failure");
-      NodeAssert.deepEqual(closeCallsDuringRun, []);
-    }),
-  );
-});
diff --git a/apps/server/src/provider/Layers/OpenCodeAdapter.ts b/apps/server/src/provider/Layers/OpenCodeAdapter.ts
deleted file mode 100644
index c049eedb62b5..000000000000
--- a/apps/server/src/provider/Layers/OpenCodeAdapter.ts
+++ /dev/null
@@ -1,3158 +0,0 @@
-import {
-  EventId,
-  type OpenCodeSettings,
-  ProviderDriverKind,
-  ProviderInstanceId,
-  type ProviderRuntimeEvent,
-  type ProviderSession,
-  RuntimeItemId,
-  RuntimeRequestId,
-  ThreadId,
-  type ToolLifecycleItemType,
-  TurnId,
-  type UserInputQuestion,
-} from "@t3tools/contracts";
-import * as Cause from "effect/Cause";
-import * as Crypto from "effect/Crypto";
-import * as DateTime from "effect/DateTime";
-import * as Deferred from "effect/Deferred";
-import * as Effect from "effect/Effect";
-import * as Exit from "effect/Exit";
-import * as FileSystem from "effect/FileSystem";
-import * as Fiber from "effect/Fiber";
-import * as Path from "effect/Path";
-import * as Queue from "effect/Queue";
-import * as Ref from "effect/Ref";
-import * as Schema from "effect/Schema";
-import * as Scope from "effect/Scope";
-import * as Semaphore from "effect/Semaphore";
-import * as Stream from "effect/Stream";
-import type { OpencodeClient, Part, PermissionRequest, QuestionRequest } from "@opencode-ai/sdk/v2";
-import { getModelSelectionStringOptionValue } from "@t3tools/shared/model";
-
-import { resolveAttachmentPath } from "../../attachmentStore.ts";
-import { ServerConfig } from "../../config.ts";
-import * as McpProviderSession from "../../mcp/McpProviderSession.ts";
-import { type EventNdjsonLogger, makeEventNdjsonLogger } from "./EventNdjsonLogger.ts";
-import {
-  ProviderAdapterProcessError,
-  ProviderAdapterRequestError,
-  ProviderAdapterSessionClosedError,
-  ProviderAdapterSessionNotFoundError,
-  ProviderAdapterValidationError,
-} from "../Errors.ts";
-import { type OpenCodeAdapterShape } from "../Services/OpenCodeAdapter.ts";
-import {
-  buildOpenCodePermissionRules,
-  OpenCodeRuntime,
-  OpenCodeRuntimeError,
-  openCodeQuestionId,
-  openCodeRuntimeErrorDetail,
-  parseOpenCodeModelSlug,
-  runOpenCodeSdk,
-  toOpenCodeFileParts,
-  toOpenCodePermissionReply,
-  toOpenCodeQuestionAnswers,
-  type OpenCodeServerConnection,
-} from "../opencodeRuntime.ts";
-import * as Option from "effect/Option";
-
-const PROVIDER = ProviderDriverKind.make("opencode");
-
-/**
- * Version tag stamped into the OpenCode resume cursor. Bump if the cursor
- * shape changes so stale-shaped cursors written by older builds are ignored
- * rather than misread (mirrors GROK_RESUME_VERSION / CURSOR_RESUME_VERSION).
- */
-const OPENCODE_RESUME_VERSION = 1 as const;
-
-/**
- * Decode a persisted resume cursor into the upstream `ses_…` id. Anything
- * that isn't a current-version cursor with a non-empty id means "no resume"
- * rather than an error. Re-adopting the session id IS the resume mechanism —
- * OpenCode scopes a conversation's history by session id.
- */
-function parseOpenCodeResume(raw: unknown): { readonly sessionId: string } | undefined {
-  if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
-    return undefined;
-  }
-  const record = raw as Record<string, unknown>;
-  if (record.schemaVersion !== OPENCODE_RESUME_VERSION) {
-    return undefined;
-  }
-  if (typeof record.sessionId !== "string" || record.sessionId.trim().length === 0) {
-    return undefined;
-  }
-  return { sessionId: record.sessionId.trim() };
-}
-
-/**
- * Whether an error definitively reports a missing session. Only a confirmed
- * miss may silently start a fresh session; any other failure (the SDK client
- * is `throwOnError: true`, so `session.get` rejects on every non-2xx) must
- * propagate, or a transient blip resets a live thread to an empty one — the
- * #3604 silent context loss. Decides on structured signals only, never free
- * text: a numeric 404 or the exact `NotFoundError` name, found via a bounded walk
- * over `cause`/`body`/`error`/`data`. An explicit non-404 status seals its
- * subtree so a wrapped "NotFound" name can't reclassify a real failure.
- * Exported for unit testing.
- */
-export function isOpenCodeNotFound(cause: unknown): boolean {
-  const seen = new Set<unknown>();
-  const queue: Array<unknown> = [cause];
-  for (let steps = 0; queue.length > 0 && steps < 32; steps += 1) {
-    const node = queue.shift();
-    if (node === null || typeof node !== "object" || seen.has(node)) {
-      continue;
-    }
-    seen.add(node);
-    const record = node as Record<string, unknown>;
-
-    const response = record.response;
-    const statuses = [
-      record.status,
-      record.statusCode,
-      response !== null && typeof response === "object"
-        ? (response as { readonly status?: unknown }).status
-        : undefined,
-    ].filter((status): status is number => typeof status === "number");
-    if (statuses.includes(404)) {
-      return true;
-    }
-    if (statuses.length > 0) {
-      continue;
-    }
-
-    const name = record.name;
-    if (typeof name === "string" && name.toLowerCase() === "notfounderror") {
-      return true;
-    }
-
-    for (const key of ["cause", "body", "error", "data"] as const) {
-      if (record[key] !== undefined) {
-        queue.push(record[key]);
-      }
-    }
-  }
-  return false;
-}
-
-/**
- * Whether two directory spellings name the same location. Raw string
- * equality misreads a trailing slash, `.`/`..` segment, or symlinked cwd
- * (macOS `/tmp` → `/private/tmp`) as a cwd change, needlessly forking the
- * session on every resume. Lexically equal paths short-circuit; otherwise
- * both sides go through `realPath`, each falling back to its lexical form
- * on failure (deleted directory, external-server path) — so the probe can
- * only widen matches, never split them. Takes the services as arguments so
- * adapter methods stay service-free. Exported for unit testing.
- */
-export function isSameOpenCodeDirectory(
-  fileSystem: FileSystem.FileSystem,
-  path: Path.Path,
-  left: string,
-  right: string,
-): Effect.Effect<boolean> {
-  const lexicalLeft = path.resolve(left);
-  const lexicalRight = path.resolve(right);
-  if (lexicalLeft === lexicalRight) {
-    return Effect.succeed(true);
-  }
-  const canonicalize = (lexical: string) =>
-    fileSystem.realPath(lexical).pipe(Effect.orElseSucceed(() => lexical));
-  return Effect.zipWith(
-    canonicalize(lexicalLeft),
-    canonicalize(lexicalRight),
-    (canonicalLeft, canonicalRight) => canonicalLeft === canonicalRight,
-  );
-}
-
-interface OpenCodeTurnSnapshot {
-  readonly id: TurnId;
-  readonly items: Array<unknown>;
-}
-
-type OpenCodeSubscribedEvent =
-  Awaited<ReturnType<OpencodeClient["event"]["subscribe"]>> extends {
-    readonly stream: AsyncIterable<infer TEvent>;
-  }
-    ? TEvent
-    : never;
-
-type OpenCodeSessionStatusEvent = Extract<
-  OpenCodeSubscribedEvent,
-  { readonly type: "session.status" }
->;
-
-const OpenCodeSessionStatusMap = Schema.Record(
-  Schema.String,
-  Schema.Struct({ type: Schema.String }),
-);
-const decodeOpenCodeSessionStatusMap = Schema.decodeUnknownOption(OpenCodeSessionStatusMap);
-
-interface OpenCodeCancellation {
-  readonly turnId: TurnId | undefined;
-  readonly completion: Deferred.Deferred<void, ProviderAdapterRequestError>;
-  acknowledged?: boolean;
-  deferredIdleEvent?: OpenCodeSessionStatusEvent;
-}
-
-interface OpenCodeIdleReconciliation {
-  readonly turnId: TurnId;
-  readonly promptGeneration: number;
-  raw: unknown;
-  warned: boolean;
-  dirty: boolean;
-  fiber?: Fiber.Fiber<void, never>;
-}
-
-interface OpenCodePromptAdmission {
-  readonly generation: number;
-  readonly turnId: TurnId;
-  readonly messageId: string;
-  readonly priorAwaitingBusy: boolean;
-  readonly priorIdle: { readonly turnId: TurnId; readonly raw: unknown } | undefined;
-  idleDuringAdmission: { readonly turnId: TurnId; readonly raw: unknown } | undefined;
-  idleObservedAfterMessage: boolean;
-  messageObserved: boolean;
-  busyObserved: boolean;
-  idleStatusConfirmations: number;
-  accepted: boolean;
-  cancelled: boolean;
-  readonly acceptance: Deferred.Deferred<void>;
-  readonly submissionSettled: Deferred.Deferred<void>;
-  promptFiber?: Fiber.Fiber<void, ProviderAdapterRequestError>;
-  recoveryFiber?: Fiber.Fiber<void, never>;
-  recoveryRaw: unknown;
-}
-
-type OpenCodeTerminalRequestEvent = Extract<
-  OpenCodeSubscribedEvent,
-  {
-    readonly type: "permission.replied" | "question.replied" | "question.rejected";
-  }
->;
-
-type OpenCodeAskedRequestEvent = Extract<
-  OpenCodeSubscribedEvent,
-  { readonly type: "permission.asked" | "question.asked" }
->;
-
-type OpenCodeRoutedRequestEvent = OpenCodeAskedRequestEvent | OpenCodeTerminalRequestEvent;
-
-interface OpenCodeRequestRelationRetry {
-  warned: boolean;
-  fiber?: Fiber.Fiber<void, never>;
-}
-
-interface OpenCodePendingRequestRecovery {
-  warned: boolean;
-  rerun: boolean;
-}
-
-function trimText(value: string | undefined | null): string | undefined {
-  const trimmed = value?.trim();
-  return trimmed && trimmed.length > 0 ? trimmed : undefined;
-}
-
-function openCodeEventSessionId(event: OpenCodeSubscribedEvent): string | undefined {
-  const properties = "properties" in event ? event.properties : undefined;
-  if (!properties || typeof properties !== "object") {
-    return undefined;
-  }
-
-  const sessionID = (properties as { readonly sessionID?: unknown }).sessionID;
-  const sessionIDFromProperties = typeof sessionID === "string" ? sessionID : undefined;
-  if (sessionIDFromProperties) {
-    return sessionIDFromProperties;
-  }
-
-  const info = (properties as { readonly info?: { readonly id?: unknown } }).info;
-  return info && typeof info.id === "string" ? info.id : undefined;
-}
-
-function openCodeEventSessionTitle(event: OpenCodeSubscribedEvent): string | undefined {
-  if (event.type !== "session.updated") {
-    return undefined;
-  }
-
-  const title = trimText(event.properties.info.title);
-  // OpenCode mints a placeholder title at session.create when no title was
-  // provided, and re-emits it on every `session.updated`. Mirroring it would
-  // overwrite the thread's real title (openCodeEventSessionTitle feeds the
-  // `thread.metadata.updated` mirror). Ignore OpenCode's auto-generated
-  // placeholders so the thread isn't locked onto them.
-  if (!title || isOpenCodeDefaultTitle(title)) {
-    return undefined;
-  }
-
-  return title;
-}
-
-function isOpenCodeAbortError(error: unknown): boolean {
-  return (
-    typeof error === "object" &&
-    error !== null &&
-    "name" in error &&
-    error.name === "MessageAbortedError"
-  );
-}
-
-function isOpenCodeChildRequestEvent(event: OpenCodeSubscribedEvent): boolean {
-  switch (event.type) {
-    case "permission.asked":
-    case "permission.replied":
-    case "question.asked":
-    case "question.replied":
-    case "question.rejected":
-      return true;
-    default:
-      return false;
-  }
-}
-
-const OPENCODE_DEFAULT_TITLE_PATTERN =
-  /^(New session - |Child session - )\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/;
-
-function isOpenCodeDefaultTitle(title: string): boolean {
-  return OPENCODE_DEFAULT_TITLE_PATTERN.test(title);
-}
-
-interface OpenCodeSessionContext {
-  session: ProviderSession;
-  readonly client: OpencodeClient;
-  readonly server: OpenCodeServerConnection;
-  readonly directory: string;
-  readonly openCodeSessionId: string;
-  readonly relatedSessionIds: Set<string>;
-  readonly resolvedRequestIds: Set<string>;
-  readonly emittedTerminalRequestIds: Set<string>;
-  readonly requestRelationRetries: Map<string, OpenCodeRequestRelationRetry>;
-  readonly pendingPermissions: Map<string, PermissionRequest>;
-  readonly pendingQuestions: Map<string, QuestionRequest>;
-  readonly messageRoleById: Map<string, "user" | "assistant">;
-  readonly partById: Map<string, Part>;
-  readonly emittedTextByPartId: Map<string, string>;
-  readonly completedAssistantPartIds: Set<string>;
-  readonly turns: Array<OpenCodeTurnSnapshot>;
-  activeTurnId: TurnId | undefined;
-  activeAgent: string | undefined;
-  activeVariant: string | undefined;
-  cancellation: OpenCodeCancellation | undefined;
-  interruptedTurnId: TurnId | undefined;
-  reconcileIdleStatus: boolean;
-  awaitingBusyAfterInterruption: boolean;
-  pendingIdleReconciliation: OpenCodeIdleReconciliation | undefined;
-  pendingRequestRecovery: OpenCodePendingRequestRecovery | undefined;
-  promptGeneration: number;
-  promptAdmission: OpenCodePromptAdmission | undefined;
-  readonly promptSemaphore: Semaphore.Semaphore;
-  readonly firstConnection: Deferred.Deferred<void, ProviderAdapterRequestError>;
-  /**
-   * One-shot guard flipped by `stopOpenCodeContext` / `emitUnexpectedExit`.
-   * The session lifecycle is owned by `sessionScope`; this Ref exists only
-   * so concurrent callers can race the transition safely via `getAndSet`.
-   */
-  readonly stopped: Ref.Ref<boolean>;
-  /**
-   * Sole lifecycle handle for the session. Closing this scope:
-   *   - aborts the `AbortController` registered as a finalizer
-   *     (cancels the in-flight `event.subscribe` fetch),
-   *   - interrupts the event-pump and server-exit fibers forked
-   *     via `Effect.forkIn(sessionScope)`,
-   *   - tears down the OpenCode server process for scope-owned servers.
-   */
-  readonly sessionScope: Scope.Closeable;
-}
-
-export interface OpenCodeAdapterLiveOptions {
-  readonly instanceId?: ProviderInstanceId;
-  readonly environment?: NodeJS.ProcessEnv;
-  readonly nativeEventLogPath?: string;
-  readonly nativeEventLogger?: EventNdjsonLogger;
-}
-
-const nowIso = Effect.map(DateTime.now, DateTime.formatIso);
-
-/**
- * Map a tagged OpenCodeRuntimeError produced by {@link runOpenCodeSdk} into
- * the adapter-boundary `ProviderAdapterRequestError`. SDK-method-level call
- * sites pipe through this in `Effect.mapError` so they never build the error
- * shape by hand.
- */
-const toRequestError = (cause: OpenCodeRuntimeError): ProviderAdapterRequestError =>
-  new ProviderAdapterRequestError({
-    provider: PROVIDER,
-    method: cause.operation,
-    detail: cause.detail,
-    cause: cause.cause,
-  });
-
-/**
- * Map a `Cause.squash`-ed failure into a `ProviderAdapterProcessError`. The
- * typed cause is usually an `OpenCodeRuntimeError` (from {@link runOpenCodeSdk}),
- * in which case we preserve its `detail`; otherwise we fall back to
- * {@link openCodeRuntimeErrorDetail} for unknown causes (defects, etc.).
- */
-const toProcessError = (threadId: ThreadId, cause: unknown): ProviderAdapterProcessError =>
-  new ProviderAdapterProcessError({
-    provider: PROVIDER,
-    threadId,
-    detail: OpenCodeRuntimeError.is(cause) ? cause.detail : openCodeRuntimeErrorDetail(cause),
-    cause,
-  });
-
-type EventBaseInput = {
-  readonly threadId: ThreadId;
-  readonly turnId?: TurnId | undefined;
-  readonly itemId?: string | undefined;
-  readonly requestId?: string | undefined;
-  readonly createdAt?: string | undefined;
-  readonly raw?: unknown;
-};
-
-function toToolLifecycleItemType(toolName: string): ToolLifecycleItemType {
-  const normalized = toolName.toLowerCase();
-  if (normalized.includes("bash") || normalized.includes("command")) {
-    return "command_execution";
-  }
-  if (
-    normalized.includes("edit") ||
-    normalized.includes("write") ||
-    normalized.includes("patch") ||
-    normalized.includes("multiedit")
-  ) {
-    return "file_change";
-  }
-  if (normalized.includes("web")) {
-    return "web_search";
-  }
-  if (normalized.includes("mcp")) {
-    return "mcp_tool_call";
-  }
-  if (normalized.includes("image")) {
-    return "image_view";
-  }
-  if (
-    normalized.includes("task") ||
-    normalized.includes("agent") ||
-    normalized.includes("subtask")
-  ) {
-    return "collab_agent_tool_call";
-  }
-  return "dynamic_tool_call";
-}
-
-function mapPermissionToRequestType(
-  permission: string,
-): "command_execution_approval" | "file_read_approval" | "file_change_approval" | "unknown" {
-  switch (permission) {
-    case "bash":
-      return "command_execution_approval";
-    case "read":
-      return "file_read_approval";
-    case "edit":
-      return "file_change_approval";
-    default:
-      return "unknown";
-  }
-}
-
-function mapPermissionDecision(reply: "once" | "always" | "reject"): string {
-  switch (reply) {
-    case "once":
-      return "accept";
-    case "always":
-      return "acceptForSession";
-    case "reject":
-    default:
-      return "decline";
-  }
-}
-
-function resolveTurnSnapshot(
-  context: OpenCodeSessionContext,
-  turnId: TurnId,
-): OpenCodeTurnSnapshot {
-  const existing = context.turns.find((turn) => turn.id === turnId);
-  if (existing) {
-    return existing;
-  }
-
-  const created: OpenCodeTurnSnapshot = { id: turnId, items: [] };
-  context.turns.push(created);
-  return created;
-}
-
-function appendTurnItem(
-  context: OpenCodeSessionContext,
-  turnId: TurnId | undefined,
-  item: unknown,
-): void {
-  if (!turnId) {
-    return;
-  }
-  resolveTurnSnapshot(context, turnId).items.push(item);
-}
-
-const ensureSessionContext = Effect.fn("ensureSessionContext")(function* (
-  sessions: ReadonlyMap<ThreadId, OpenCodeSessionContext>,
-  threadId: ThreadId,
-) {
-  const session = sessions.get(threadId);
-  if (!session) {
-    return yield* new ProviderAdapterSessionNotFoundError({
-      provider: PROVIDER,
-      threadId,
-    });
-  }
-  if (yield* Ref.get(session.stopped)) {
-    return yield* new ProviderAdapterSessionClosedError({
-      provider: PROVIDER,
-      threadId,
-    });
-  }
-  return session;
-});
-
-function normalizeQuestionRequest(request: QuestionRequest): ReadonlyArray<UserInputQuestion> {
-  return request.questions.map((question, index) => ({
-    id: openCodeQuestionId(index, question),
-    header: question.header,
-    question: question.question,
-    options: question.options.map((option) => ({
-      label: option.label,
-      description: option.description,
-    })),
-    ...(question.multiple ? { multiSelect: true } : {}),
-  }));
-}
-
-function resolveTextStreamKind(part: Part | undefined): "assistant_text" | "reasoning_text" {
-  return part?.type === "reasoning" ? "reasoning_text" : "assistant_text";
-}
-
-function textFromPart(part: Part): string | undefined {
-  switch (part.type) {
-    case "text":
-    case "reasoning":
-      return part.text;
-    default:
-      return undefined;
-  }
-}
-
-function commonPrefixLength(left: string, right: string): number {
-  let index = 0;
-  while (index < left.length && index < right.length && left[index] === right[index]) {
-    index += 1;
-  }
-  return index;
-}
-
-function resolveLatestAssistantText(previousText: string | undefined, nextText: string): string {
-  if (previousText && previousText.length > nextText.length && previousText.startsWith(nextText)) {
-    return previousText;
-  }
-  return nextText;
-}
-
-export function mergeOpenCodeAssistantText(
-  previousText: string | undefined,
-  nextText: string,
-): {
-  readonly latestText: string;
-  readonly deltaToEmit: string;
-} {
-  const latestText = resolveLatestAssistantText(previousText, nextText);
-  return {
-    latestText,
-    deltaToEmit: latestText.slice(commonPrefixLength(previousText ?? "", latestText)),
-  };
-}
-
-export function appendOpenCodeAssistantTextDelta(
-  previousText: string,
-  delta: string,
-): {
-  readonly nextText: string;
-  readonly deltaToEmit: string;
-} {
-  return {
-    nextText: previousText + delta,
-    deltaToEmit: delta,
-  };
-}
-
-const isoFromEpochMs = (value: number) =>
-  DateTime.make(value).pipe(
-    Option.match({
-      onNone: () => undefined,
-      onSome: DateTime.formatIso,
-    }),
-  );
-
-function messageRoleForPart(
-  context: OpenCodeSessionContext,
-  part: Pick<Part, "messageID" | "type">,
-): "assistant" | "user" | undefined {
-  const known = context.messageRoleById.get(part.messageID);
-  if (known) {
-    return known;
-  }
-  return part.type === "tool" ? "assistant" : undefined;
-}
-
-function detailFromToolPart(part: Extract<Part, { type: "tool" }>): string | undefined {
-  switch (part.state.status) {
-    case "completed":
-      return part.state.output;
-    case "error":
-      return part.state.error;
-    case "running":
-      return part.state.title;
-    default:
-      return undefined;
-  }
-}
-
-function toolStateCreatedAt(part: Extract<Part, { type: "tool" }>): string | undefined {
-  switch (part.state.status) {
-    case "running":
-      return isoFromEpochMs(part.state.time.start);
-    case "completed":
-    case "error":
-      return isoFromEpochMs(part.state.time.end);
-    default:
-      return undefined;
-  }
-}
-
-function sessionErrorMessage(error: unknown): string {
-  if (!error || typeof error !== "object") {
-    return "OpenCode session failed.";
-  }
-  const data = "data" in error && error.data && typeof error.data === "object" ? error.data : null;
-  const message = data && "message" in data ? data.message : null;
-  return typeof message === "string" && message.trim().length > 0
-    ? message
-    : "OpenCode session failed.";
-}
-
-function updateProviderSession(
-  context: OpenCodeSessionContext,
-  patch: Partial<ProviderSession>,
-  options?: {
-    readonly clearActiveTurnId?: boolean;
-    readonly clearLastError?: boolean;
-  },
-): Effect.Effect<ProviderSession> {
-  return Effect.gen(function* () {
-    return applyProviderSessionUpdate(context, patch, options, yield* nowIso);
-  });
-}
-
-function applyProviderSessionUpdate(
-  context: OpenCodeSessionContext,
-  patch: Partial<ProviderSession>,
-  options:
-    | {
-        readonly clearActiveTurnId?: boolean;
-        readonly clearLastError?: boolean;
-      }
-    | undefined,
-  updatedAt: string,
-): ProviderSession {
-  const nextSession = {
-    ...context.session,
-    ...patch,
-    updatedAt,
-  } as ProviderSession & Record<string, unknown>;
-  const mutableSession = nextSession as Record<string, unknown>;
-  if (options?.clearActiveTurnId) {
-    delete mutableSession.activeTurnId;
-  }
-  if (options?.clearLastError) {
-    delete mutableSession.lastError;
-  }
-  context.session = nextSession;
-  return nextSession;
-}
-
-const failPendingOpenCodeCancellation = Effect.fn("failPendingOpenCodeCancellation")(function* (
-  context: OpenCodeSessionContext,
-  detail: string,
-) {
-  const cancellation = context.cancellation;
-  if (!cancellation) {
-    return;
-  }
-  context.cancellation = undefined;
-  yield* Deferred.fail(
-    cancellation.completion,
-    new ProviderAdapterRequestError({
-      provider: PROVIDER,
-      method: "session.abort",
-      detail,
-    }),
-  ).pipe(Effect.ignore);
-});
-
-const abortOpenCodeSessionForTeardown = (context: OpenCodeSessionContext) =>
-  runOpenCodeSdk("session.abort", (signal) =>
-    context.client.session.abort({ sessionID: context.openCodeSessionId }, { signal }),
-  ).pipe(Effect.timeout("1 second"), Effect.ignore({ log: true }));
-
-const cancelPendingOpenCodePrompt = Effect.fn("cancelPendingOpenCodePrompt")(function* (
-  context: OpenCodeSessionContext,
-) {
-  const admission = context.promptAdmission;
-  if (!admission) {
-    return;
-  }
-  admission.cancelled = true;
-  if (admission.promptFiber) {
-    yield* Fiber.interrupt(admission.promptFiber);
-  }
-  yield* Deferred.await(admission.submissionSettled);
-});
-
-const closeStartingOpenCodeContext = Effect.fn("closeStartingOpenCodeContext")(function* (
-  context: OpenCodeSessionContext,
-  abortRemote: boolean,
-) {
-  if (yield* Ref.getAndSet(context.stopped, true)) {
-    return;
-  }
-  yield* Deferred.fail(
-    context.firstConnection,
-    new ProviderAdapterRequestError({
-      provider: PROVIDER,
-      method: "event.subscribe",
-      detail: "OpenCode session startup ended before the event stream connected.",
-    }),
-  ).pipe(Effect.ignore);
-  yield* cancelPendingOpenCodePrompt(context);
-  yield* failPendingOpenCodeCancellation(context, "OpenCode session startup was cancelled.");
-  context.promptAdmission = undefined;
-  if (abortRemote) {
-    yield* abortOpenCodeSessionForTeardown(context);
-  }
-  yield* Scope.close(context.sessionScope, Exit.void).pipe(Effect.ignore);
-});
-
-const stopOpenCodeContext = Effect.fn("stopOpenCodeContext")(function* (
-  context: OpenCodeSessionContext,
-) {
-  // Race-safe one-shot: first caller flips the flag, everyone else no-ops.
-  if (yield* Ref.getAndSet(context.stopped, true)) {
-    return false;
-  }
-  yield* Deferred.fail(
-    context.firstConnection,
-    new ProviderAdapterRequestError({
-      provider: PROVIDER,
-      method: "event.subscribe",
-      detail: "OpenCode session stopped before the event stream connected.",
-    }),
-  ).pipe(Effect.ignore);
-  yield* cancelPendingOpenCodePrompt(context);
-  const cancellation = context.cancellation;
-  context.cancellation = undefined;
-  if (cancellation) {
-    yield* Deferred.succeed(cancellation.completion, undefined).pipe(Effect.ignore);
-  }
-  context.promptAdmission = undefined;
-
-  // Best-effort remote abort. The scope close below tears down the local
-  // handles (event-pump fiber, server-exit fiber, event-subscribe fetch),
-  // but we still want to tell OpenCode that this session is done.
-  yield* abortOpenCodeSessionForTeardown(context);
-
-  // Closing the session scope interrupts every fiber forked into it and
-  // runs each finalizer we registered — the `AbortController.abort()` call,
-  // the child-process termination, etc.
-  yield* Scope.close(context.sessionScope, Exit.void);
-  return true;
-});
-
-export function makeOpenCodeAdapter(
-  openCodeSettings: OpenCodeSettings,
-  options?: OpenCodeAdapterLiveOptions,
-) {
-  return Effect.gen(function* () {
-    const boundInstanceId = options?.instanceId ?? ProviderInstanceId.make("opencode");
-    const serverConfig = yield* ServerConfig;
-    const openCodeRuntime = yield* OpenCodeRuntime;
-    const crypto = yield* Crypto.Crypto;
-    const fileSystem = yield* FileSystem.FileSystem;
-    const path = yield* Path.Path;
-    const sameDirectory = (left: string, right: string) =>
-      isSameOpenCodeDirectory(fileSystem, path, left, right);
-    const nativeEventLogger =
-      options?.nativeEventLogger ??
-      (options?.nativeEventLogPath !== undefined
-        ? yield* makeEventNdjsonLogger(options.nativeEventLogPath, {
-            stream: "native",
-          })
-        : undefined);
-    // Only close loggers we created. If the caller passed one in via
-    // `options.nativeEventLogger`, they own its lifecycle.
-    const managedNativeEventLogger =
-      options?.nativeEventLogger === undefined ? nativeEventLogger : undefined;
-    const runtimeEvents = yield* Queue.unbounded<ProviderRuntimeEvent>();
-    const sessions = new Map<ThreadId, OpenCodeSessionContext>();
-    const deleteContextIfCurrent = (context: OpenCodeSessionContext) => {
-      if (sessions.get(context.session.threadId) === context) {
-        sessions.delete(context.session.threadId);
-      }
-    };
-    const awaitOpenCodeContextReady = Effect.fn("awaitOpenCodeContextReady")(function* (
-      context: OpenCodeSessionContext,
-    ) {
-      yield* Deferred.await(context.firstConnection);
-      const current = yield* ensureSessionContext(sessions, context.session.threadId);
-      if (current !== context) {
-        return yield* new ProviderAdapterSessionClosedError({
-          provider: PROVIDER,
-          threadId: context.session.threadId,
-        });
-      }
-      return current;
-    });
-    const randomUUIDv4 = crypto.randomUUIDv4.pipe(
-      Effect.mapError(
-        (cause) =>
-          new ProviderAdapterRequestError({
-            provider: PROVIDER,
-            method: "crypto/randomUUIDv4",
-            detail: "Failed to generate OpenCode runtime identifier.",
-            cause,
-          }),
-      ),
-    );
-    let messageIdEpochMillis = -1;
-    let messageIdCounter = 0;
-    // T3 supplies the message ID to match prompt admission events. Keep OpenCode's sortable native shape so equal-time messages retain their upstream order.
-    const makeOpenCodeMessageId = Effect.fn("makeOpenCodeMessageId")(function* () {
-      const epochMillis = DateTime.toEpochMillis(yield* DateTime.now);
-      if (epochMillis !== messageIdEpochMillis) {
-        messageIdEpochMillis = epochMillis;
-        messageIdCounter = 0;
-      }
-      messageIdCounter += 1;
-      const encodedTime = BigInt.asUintN(
-        48,
-        BigInt(epochMillis) * 0x1000n + BigInt(messageIdCounter),
-      )
-        .toString(16)
-        .padStart(12, "0");
-      const randomBytes = yield* crypto.randomBytes(14).pipe(
-        Effect.mapError(
-          (cause) =>
-            new ProviderAdapterRequestError({
-              provider: PROVIDER,
-              method: "crypto/randomBytes",
-              detail: "Failed to generate an OpenCode message identifier.",
-              cause,
-            }),
-        ),
-      );
-      const alphabet = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
-      const random = Array.from(randomBytes, (byte) => alphabet[byte % alphabet.length]).join("");
-      return `msg_${encodedTime}${random}`;
-    });
-    const buildEventBase = (input: EventBaseInput) =>
-      Effect.all({
-        eventId: randomUUIDv4.pipe(Effect.map(EventId.make)),
-        createdAt: input.createdAt === undefined ? nowIso : Effect.succeed(input.createdAt),
-      }).pipe(
-        Effect.map(({ eventId, createdAt }) => ({
-          eventId,
-          provider: PROVIDER,
-          threadId: input.threadId,
-          createdAt,
-          ...(input.turnId ? { turnId: input.turnId } : {}),
-          ...(input.itemId ? { itemId: RuntimeItemId.make(input.itemId) } : {}),
-          ...(input.requestId ? { requestId: RuntimeRequestId.make(input.requestId) } : {}),
-          ...(input.raw !== undefined
-            ? {
-                raw: {
-                  source: "opencode.sdk.event" as const,
-                  payload: input.raw,
-                },
-              }
-            : {}),
-        })),
-      );
-
-    // Layer-level finalizer: when the adapter layer shuts down, stop every
-    // session. Each session's `Scope.close` tears down its spawned OpenCode
-    // server (via the `ChildProcessSpawner` finalizer installed in
-    // `startOpenCodeServerProcess`) and interrupts the forked event/exit
-    // fibers. Consumers that can't reason about Effect scopes therefore
-    // cannot leak OpenCode child processes by forgetting to call `stopAll`.
-    yield* Effect.addFinalizer(() =>
-      Effect.gen(function* () {
-        const contexts = [...sessions.values()];
-        sessions.clear();
-        // `ignoreCause` swallows both typed failures (none here) and defects
-        // from throwing scope finalizers so a sibling's death can't interrupt
-        // the remaining cleanups.
-        yield* Effect.forEach(
-          contexts,
-          (context) => Effect.ignoreCause(stopOpenCodeContext(context)),
-          { concurrency: "unbounded", discard: true },
-        );
-        // Close the logger AFTER session teardown so any final lifecycle
-        // events emitted during shutdown still get written. `close` flushes
-        // the `Logger.batched` window and closes each per-thread
-        // `RotatingFileSink` handle owned by the logger's internal scope.
-        if (managedNativeEventLogger !== undefined) {
-          yield* managedNativeEventLogger.close();
-        }
-      }).pipe(Effect.ensuring(Queue.shutdown(runtimeEvents))),
-    );
-
-    const emit = (event: ProviderRuntimeEvent) =>
-      Queue.offer(runtimeEvents, event).pipe(Effect.asVoid);
-    const writeNativeEvent = (
-      threadId: ThreadId,
-      event: {
-        readonly observedAt: string;
-        readonly event: Record<string, unknown>;
-      },
-    ) => (nativeEventLogger ? nativeEventLogger.write(event, threadId) : Effect.void);
-    const writeNativeEventBestEffort = (
-      threadId: ThreadId,
-      event: {
-        readonly observedAt: string;
-        readonly event: Record<string, unknown>;
-      },
-    ) => writeNativeEvent(threadId, event).pipe(Effect.catchCause(() => Effect.void));
-
-    const cancelIdleReconciliation = Effect.fn("cancelIdleReconciliation")(function* (
-      context: OpenCodeSessionContext,
-    ) {
-      const pending = context.pendingIdleReconciliation;
-      context.pendingIdleReconciliation = undefined;
-      if (pending?.fiber) {
-        yield* Fiber.interrupt(pending.fiber);
-      }
-    });
-
-    const completeOpenCodeTurn = Effect.fn("completeOpenCodeTurn")(function* (
-      context: OpenCodeSessionContext,
-      turnId: TurnId,
-      promptGeneration: number,
-      raw: unknown,
-    ) {
-      const updatedAt = yield* nowIso;
-      const stopped = yield* Ref.get(context.stopped);
-      if (
-        stopped ||
-        context.activeTurnId !== turnId ||
-        context.promptGeneration !== promptGeneration ||
-        context.cancellation?.turnId === turnId
-      ) {
-        return;
-      }
-      const pendingIdleReconciliation = context.pendingIdleReconciliation;
-      if (
-        pendingIdleReconciliation?.turnId === turnId &&
-        pendingIdleReconciliation.promptGeneration === promptGeneration
-      ) {
-        context.pendingIdleReconciliation = undefined;
-      }
-      context.activeTurnId = undefined;
-      context.activeAgent = undefined;
-      context.activeVariant = undefined;
-      context.interruptedTurnId = undefined;
-      context.awaitingBusyAfterInterruption = false;
-      context.reconcileIdleStatus = false;
-      applyProviderSessionUpdate(
-        context,
-        { status: "ready" },
-        { clearActiveTurnId: true },
-        updatedAt,
-      );
-      if (pendingIdleReconciliation?.fiber) {
-        yield* Fiber.interrupt(pendingIdleReconciliation.fiber);
-      }
-      yield* emit({
-        ...(yield* buildEventBase({
-          threadId: context.session.threadId,
-          turnId,
-          raw,
-        })),
-        type: "turn.completed",
-        payload: {
-          state: "completed",
-        },
-      });
-    });
-
-    const scheduleIdleReconciliation = Effect.fn("scheduleIdleReconciliation")(function* (
-      context: OpenCodeSessionContext,
-      turnId: TurnId,
-      raw: unknown,
-    ) {
-      const existing = context.pendingIdleReconciliation;
-      if (existing?.turnId === turnId && existing.promptGeneration === context.promptGeneration) {
-        existing.raw = raw;
-        existing.dirty = true;
-        return;
-      }
-      yield* cancelIdleReconciliation(context);
-
-      const pending: OpenCodeIdleReconciliation = {
-        turnId,
-        promptGeneration: context.promptGeneration,
-        raw,
-        warned: false,
-        dirty: false,
-      };
-      context.pendingIdleReconciliation = pending;
-      const reconcile = Effect.gen(function* () {
-        let retryCount = 0;
-        while (context.pendingIdleReconciliation === pending) {
-          if (
-            context.activeTurnId !== turnId ||
-            context.awaitingBusyAfterInterruption ||
-            context.promptGeneration !== pending.promptGeneration
-          ) {
-            context.pendingIdleReconciliation = undefined;
-            return;
-          }
-          const result = yield* runOpenCodeSdk("session.status", (signal) =>
-            context.client.session.status(undefined, { signal }),
-          ).pipe(
-            Effect.timeout("1 second"),
-            Effect.retry({ times: 1 }),
-            Effect.match({
-              onFailure: (cause) => ({ type: "unknown" as const, cause }),
-              onSuccess: (response) => {
-                const data = Option.getOrUndefined(decodeOpenCodeSessionStatusMap(response.data));
-                if (data === undefined) {
-                  return { type: "unknown" as const, cause: undefined };
-                }
-                const status = data[context.openCodeSessionId];
-                if (status === undefined || status.type === "idle") {
-                  return { type: "idle" as const };
-                }
-                if (status.type === "busy" || status.type === "retry") {
-                  return { type: "busy" as const };
-                }
-                return { type: "unknown" as const, cause: undefined };
-              },
-            }),
-          );
-
-          if (
-            context.pendingIdleReconciliation !== pending ||
-            context.activeTurnId !== turnId ||
-            context.promptGeneration !== pending.promptGeneration
-          ) {
-            return;
-          }
-          if (result.type === "idle") {
-            context.pendingIdleReconciliation = undefined;
-            yield* completeOpenCodeTurn(context, turnId, pending.promptGeneration, pending.raw);
-            return;
-          }
-          if (result.type === "busy") {
-            if (pending.dirty) {
-              pending.dirty = false;
-              continue;
-            }
-            context.pendingIdleReconciliation = undefined;
-            return;
-          }
-          if (!pending.warned) {
-            pending.warned = true;
-            yield* emit({
-              ...(yield* buildEventBase({ threadId: context.session.threadId, turnId })),
-              type: "runtime.warning",
-              payload: {
-                message: "OpenCode turn completion is waiting for session status.",
-                detail:
-                  result.cause === undefined
-                    ? "session.status returned missing or invalid status data."
-                    : openCodeRuntimeErrorDetail(result.cause),
-              },
-            });
-          }
-          const delayMs = Math.min(250 * 2 ** retryCount, 5_000);
-          retryCount += 1;
-          yield* Effect.sleep(`${delayMs} millis`);
-        }
-      }).pipe(
-        Effect.catchCause(() => Effect.void),
-        Effect.ensuring(
-          Effect.sync(() => {
-            if (context.pendingIdleReconciliation === pending) {
-              context.pendingIdleReconciliation = undefined;
-            }
-          }),
-        ),
-      );
-      pending.fiber = yield* reconcile.pipe(Effect.forkIn(context.sessionScope));
-    });
-
-    const failPromptAdmissionRecovery = Effect.fn("failPromptAdmissionRecovery")(function* (
-      context: OpenCodeSessionContext,
-      promptAdmission: OpenCodePromptAdmission,
-    ) {
-      if (
-        context.promptAdmission !== promptAdmission ||
-        context.activeTurnId !== promptAdmission.turnId ||
-        context.promptGeneration !== promptAdmission.generation
-      ) {
-        return;
-      }
-      const detail =
-        "OpenCode accepted the prompt, but T3 Code could not confirm its message or session status.";
-      const abortExit = yield* Effect.exit(
-        runOpenCodeSdk("session.abort", (signal) =>
-          context.client.session.abort({ sessionID: context.openCodeSessionId }, { signal }),
-        ).pipe(Effect.timeout("1 second")),
-      );
-      if (Exit.isFailure(abortExit)) {
-        yield* emitUnexpectedExit(
-          context,
-          `${detail} The cleanup abort also failed: ${openCodeRuntimeErrorDetail(Cause.squash(abortExit.cause))}`,
-        );
-        deleteContextIfCurrent(context);
-        return;
-      }
-      context.promptAdmission = undefined;
-      context.activeTurnId = undefined;
-      context.activeAgent = undefined;
-      context.activeVariant = undefined;
-      context.awaitingBusyAfterInterruption = false;
-      context.reconcileIdleStatus = false;
-      yield* updateProviderSession(
-        context,
-        { status: "error", lastError: detail },
-        { clearActiveTurnId: true },
-      );
-      yield* emit({
-        ...(yield* buildEventBase({
-          threadId: context.session.threadId,
-          turnId: promptAdmission.turnId,
-          raw: promptAdmission.recoveryRaw,
-        })),
-        type: "turn.completed",
-        payload: {
-          state: "failed",
-          errorMessage: detail,
-        },
-      });
-      yield* emit({
-        ...(yield* buildEventBase({
-          threadId: context.session.threadId,
-          turnId: promptAdmission.turnId,
-          raw: promptAdmission.recoveryRaw,
-        })),
-        type: "runtime.error",
-        payload: {
-          message: detail,
-          class: "transport_error",
-        },
-      });
-    });
-
-    const schedulePromptAdmissionRecovery = Effect.fn("schedulePromptAdmissionRecovery")(function* (
-      context: OpenCodeSessionContext,
-      raw: unknown,
-    ) {
-      const promptAdmission = context.promptAdmission;
-      if (!promptAdmission || promptAdmission.cancelled) {
-        return;
-      }
-      if (raw !== undefined) {
-        promptAdmission.recoveryRaw = raw;
-      }
-      if (promptAdmission.recoveryFiber) {
-        return;
-      }
-      const recover = Effect.gen(function* () {
-        yield* Deferred.await(promptAdmission.acceptance);
-        for (let retryCount = 0; retryCount < 5; retryCount += 1) {
-          if (
-            context.promptAdmission !== promptAdmission ||
-            context.activeTurnId !== promptAdmission.turnId ||
-            context.promptGeneration !== promptAdmission.generation ||
-            promptAdmission.cancelled ||
-            (yield* Ref.get(context.stopped))
-          ) {
-            return;
-          }
-
-          if (!promptAdmission.messageObserved) {
-            const response = yield* runOpenCodeSdk("session.message", (signal) =>
-              context.client.session.message(
-                {
-                  sessionID: context.openCodeSessionId,
-                  messageID: promptAdmission.messageId,
-                },
-                { signal },
-              ),
-            ).pipe(Effect.timeout("1 second"), Effect.option);
-            const stopped = yield* Ref.get(context.stopped);
-            if (
-              stopped ||
-              sessions.get(context.session.threadId) !== context ||
-              context.promptAdmission !== promptAdmission ||
-              context.activeTurnId !== promptAdmission.turnId ||
-              context.promptGeneration !== promptAdmission.generation ||
-              promptAdmission.cancelled
-            ) {
-              return;
-            }
-            const message = Option.isSome(response) ? response.value.data : undefined;
-            if (message?.info.id === promptAdmission.messageId && message.info.role === "user") {
-              promptAdmission.messageObserved = true;
-              context.messageRoleById.set(promptAdmission.messageId, "user");
-            }
-          }
-
-          const statusResponse = yield* runOpenCodeSdk("session.status", (signal) =>
-            context.client.session.status(undefined, { signal }),
-          ).pipe(Effect.timeout("1 second"), Effect.option);
-          const stopped = yield* Ref.get(context.stopped);
-          if (
-            stopped ||
-            sessions.get(context.session.threadId) !== context ||
-            context.promptAdmission !== promptAdmission ||
-            context.activeTurnId !== promptAdmission.turnId ||
-            context.promptGeneration !== promptAdmission.generation ||
-            promptAdmission.cancelled
-          ) {
-            return;
-          }
-          const statusData = Option.isSome(statusResponse)
-            ? Option.getOrUndefined(decodeOpenCodeSessionStatusMap(statusResponse.value.data))
-            : undefined;
-          const status = statusData?.[context.openCodeSessionId];
-          const isIdle =
-            statusData !== undefined && (status === undefined || status.type === "idle");
-          const isBusy = status?.type === "busy" || status?.type === "retry";
-          if (isBusy) {
-            promptAdmission.busyObserved = true;
-            promptAdmission.idleStatusConfirmations = 0;
-            context.awaitingBusyAfterInterruption = false;
-            context.promptAdmission = undefined;
-            return;
-          }
-
-          const idle = promptAdmission.idleDuringAdmission ?? promptAdmission.priorIdle;
-          if (
-            isIdle &&
-            idle !== undefined &&
-            (promptAdmission.messageObserved || promptAdmission.busyObserved)
-          ) {
-            context.promptAdmission = undefined;
-            context.awaitingBusyAfterInterruption = false;
-            yield* scheduleIdleReconciliation(context, promptAdmission.turnId, idle.raw);
-            return;
-          }
-          if (isIdle && promptAdmission.messageObserved) {
-            promptAdmission.idleStatusConfirmations += 1;
-            if (promptAdmission.idleStatusConfirmations >= 2) {
-              context.promptAdmission = undefined;
-              context.awaitingBusyAfterInterruption = false;
-              yield* completeOpenCodeTurn(
-                context,
-                promptAdmission.turnId,
-                promptAdmission.generation,
-                {
-                  type: "session.status.recovered",
-                  status: statusData,
-                },
-              );
-              return;
-            }
-          } else if (!isIdle) {
-            promptAdmission.idleStatusConfirmations = 0;
-          }
-          if (
-            isIdle &&
-            promptAdmission.messageObserved &&
-            promptAdmission.recoveryRaw !== undefined
-          ) {
-            context.promptAdmission = undefined;
-            context.awaitingBusyAfterInterruption = false;
-            yield* scheduleIdleReconciliation(
-              context,
-              promptAdmission.turnId,
-              promptAdmission.recoveryRaw,
-            );
-            return;
-          }
-
-          const delayMs = Math.min(250 * 2 ** retryCount, 2_000);
-          yield* Effect.sleep(`${delayMs} millis`);
-        }
-        yield* failPromptAdmissionRecovery(context, promptAdmission);
-      }).pipe(
-        Effect.catchCause(() => Effect.void),
-        Effect.ensuring(
-          Effect.sync(() => {
-            delete promptAdmission.recoveryFiber;
-          }),
-        ),
-      );
-      promptAdmission.recoveryFiber = yield* recover.pipe(Effect.forkIn(context.sessionScope));
-    });
-
-    const interruptOpenCodeTurn = Effect.fn("interruptOpenCodeTurn")(function* (
-      context: OpenCodeSessionContext,
-      turnId: TurnId,
-      raw?: unknown,
-    ) {
-      if (context.interruptedTurnId === turnId) {
-        return;
-      }
-      yield* cancelIdleReconciliation(context);
-      context.interruptedTurnId = turnId;
-      context.reconcileIdleStatus = true;
-      context.awaitingBusyAfterInterruption = false;
-      const cancellation =
-        context.cancellation?.turnId === turnId ? context.cancellation : undefined;
-      if (cancellation) {
-        context.cancellation = undefined;
-      }
-      if (context.activeTurnId === turnId) {
-        context.activeTurnId = undefined;
-        context.activeAgent = undefined;
-        context.activeVariant = undefined;
-        yield* updateProviderSession(
-          context,
-          { status: "ready" },
-          { clearActiveTurnId: true, clearLastError: true },
-        );
-      }
-      yield* emit({
-        ...(yield* buildEventBase({
-          threadId: context.session.threadId,
-          turnId,
-          raw,
-        })),
-        type: "turn.aborted",
-        payload: {
-          reason: "Interrupted by user.",
-        },
-      });
-      if (cancellation) {
-        yield* Deferred.succeed(cancellation.completion, undefined).pipe(Effect.ignore);
-      }
-    });
-
-    const emitUnexpectedExit = Effect.fn("emitUnexpectedExit")(function* (
-      context: OpenCodeSessionContext,
-      message: string,
-    ) {
-      // Atomic one-shot: two fibers can race here (the event-pump on stream
-      // failure and the server-exit watcher). `getAndSet` flips the flag in
-      // a single step so the loser observes `true` and returns; a plain
-      // `Ref.get` would let both racers slip past and emit duplicates.
-      if (yield* Ref.getAndSet(context.stopped, true)) {
-        return;
-      }
-      yield* Deferred.fail(
-        context.firstConnection,
-        new ProviderAdapterRequestError({
-          provider: PROVIDER,
-          method: "event.subscribe",
-          detail: "OpenCode session exited before the event stream connected.",
-        }),
-      ).pipe(Effect.ignore);
-      yield* failPendingOpenCodeCancellation(
-        context,
-        "OpenCode session exited during cancellation.",
-      );
-      context.promptAdmission = undefined;
-      const turnId = context.activeTurnId;
-      deleteContextIfCurrent(context);
-      // Emit lifecycle events BEFORE tearing down the scope. Both call sites
-      // run this inside a fiber forked via `Effect.forkIn(context.sessionScope)`;
-      // closing that scope triggers the fiber-interrupt finalizer, so any
-      // subsequent yield point would unwind and silently drop these emits.
-      yield* emit({
-        ...(yield* buildEventBase({
-          threadId: context.session.threadId,
-          turnId,
-        })),
-        type: "runtime.error",
-        payload: {
-          message,
-          class: "transport_error",
-        },
-      }).pipe(Effect.ignore);
-      yield* emit({
-        ...(yield* buildEventBase({
-          threadId: context.session.threadId,
-          turnId,
-        })),
-        type: "session.exited",
-        payload: {
-          reason: message,
-          recoverable: false,
-          exitKind: "error",
-        },
-      }).pipe(Effect.ignore);
-      // Inline the teardown that `stopOpenCodeContext` would do; we can't
-      // delegate to it because our `getAndSet` above already flipped the
-      // one-shot guard, so the call would no-op.
-      yield* abortOpenCodeSessionForTeardown(context);
-      yield* Scope.close(context.sessionScope, Exit.void);
-    });
-
-    /** Emit content.delta and item.completed events for an assistant text part. */
-    const emitAssistantTextDelta = Effect.fn("emitAssistantTextDelta")(function* (
-      context: OpenCodeSessionContext,
-      part: Part,
-      turnId: TurnId | undefined,
-      raw: unknown,
-    ) {
-      const text = textFromPart(part);
-      if (text === undefined) {
-        return;
-      }
-      const previousText = context.emittedTextByPartId.get(part.id);
-      const { latestText, deltaToEmit } = mergeOpenCodeAssistantText(previousText, text);
-      context.emittedTextByPartId.set(part.id, latestText);
-      if (latestText !== text) {
-        context.partById.set(
-          part.id,
-          (part.type === "text" || part.type === "reasoning"
-            ? { ...part, text: latestText }
-            : part) satisfies Part,
-        );
-      }
-      if (deltaToEmit.length > 0) {
-        yield* emit({
-          ...(yield* buildEventBase({
-            threadId: context.session.threadId,
-            turnId,
-            itemId: part.id,
-            createdAt:
-              (part.type === "text" || part.type === "reasoning") && part.time !== undefined
-                ? isoFromEpochMs(part.time.start)
-                : undefined,
-            raw,
-          })),
-          type: "content.delta",
-          payload: {
-            streamKind: resolveTextStreamKind(part),
-            delta: deltaToEmit,
-          },
-        });
-      }
-
-      if (
-        part.type === "text" &&
-        part.time?.end !== undefined &&
-        !context.completedAssistantPartIds.has(part.id)
-      ) {
-        context.completedAssistantPartIds.add(part.id);
-        yield* emit({
-          ...(yield* buildEventBase({
-            threadId: context.session.threadId,
-            turnId,
-            itemId: part.id,
-            createdAt: isoFromEpochMs(part.time.end),
-            raw,
-          })),
-          type: "item.completed",
-          payload: {
-            itemType: "assistant_message",
-            status: "completed",
-            title: "Assistant message",
-            ...(latestText.length > 0 ? { detail: latestText } : {}),
-          },
-        });
-      }
-    });
-
-    const isRelatedOpenCodeSession = Effect.fn("isRelatedOpenCodeSession")(function* (
-      context: OpenCodeSessionContext,
-      candidateSessionId: string,
-    ) {
-      if (context.relatedSessionIds.has(candidateSessionId)) {
-        return true;
-      }
-
-      const seen = new Set<string>();
-      const getSession = (sessionID: string) =>
-        runOpenCodeSdk("session.get", () => context.client.session.get({ sessionID })).pipe(
-          Effect.catchIf(
-            (cause) => isOpenCodeNotFound(cause),
-            () => Effect.succeed(undefined),
-          ),
-        );
-      let sessionId: string | undefined = candidateSessionId;
-      for (let depth = 0; sessionId !== undefined && depth < 32; depth += 1) {
-        if (context.relatedSessionIds.has(sessionId)) {
-          context.relatedSessionIds.add(candidateSessionId);
-          return true;
-        }
-        if (seen.has(sessionId)) {
-          return false;
-        }
-        seen.add(sessionId);
-        const currentSessionId: string = sessionId;
-        const response = yield* getSession(currentSessionId);
-        if (response === undefined) {
-          return false;
-        }
-        if (!response.data) {
-          return yield* new OpenCodeRuntimeError({
-            operation: "session.get",
-            detail: `OpenCode session.get returned no session payload for '${currentSessionId}'.`,
-          });
-        }
-        sessionId = response.data.parentID;
-      }
-      return false;
-    });
-
-    const emitPendingOpenCodeRequest = Effect.fn("emitPendingOpenCodeRequest")(function* (
-      context: OpenCodeSessionContext,
-      event: OpenCodeAskedRequestEvent,
-      raw: unknown,
-    ) {
-      if (context.resolvedRequestIds.has(event.properties.id)) {
-        return;
-      }
-      if (event.type === "permission.asked") {
-        const request = event.properties;
-        if (context.pendingPermissions.has(request.id)) {
-          return;
-        }
-        context.pendingPermissions.set(request.id, request);
-        yield* emit({
-          ...(yield* buildEventBase({
-            threadId: context.session.threadId,
-            turnId: context.activeTurnId,
-            requestId: request.id,
-            raw,
-          })),
-          type: "request.opened",
-          payload: {
-            requestType: mapPermissionToRequestType(request.permission),
-            detail: request.patterns.length > 0 ? request.patterns.join("\n") : request.permission,
-            args: request.metadata,
-          },
-        });
-        return;
-      }
-
-      const request = event.properties;
-      if (context.pendingQuestions.has(request.id)) {
-        return;
-      }
-      context.pendingQuestions.set(request.id, request);
-      yield* emit({
-        ...(yield* buildEventBase({
-          threadId: context.session.threadId,
-          turnId: context.activeTurnId,
-          requestId: request.id,
-          raw,
-        })),
-        type: "user-input.requested",
-        payload: { questions: normalizeQuestionRequest(request) },
-      });
-    });
-
-    const resolvePendingOpenCodeRequest = Effect.fn("resolvePendingOpenCodeRequest")(function* (
-      context: OpenCodeSessionContext,
-      requestId: string,
-    ) {
-      context.resolvedRequestIds.add(requestId);
-      const retry = context.requestRelationRetries.get(requestId);
-      context.requestRelationRetries.delete(requestId);
-      if (retry?.fiber) {
-        yield* Fiber.interrupt(retry.fiber);
-      }
-    });
-
-    const emitTerminalOpenCodeRequest = Effect.fn("emitTerminalOpenCodeRequest")(function* (
-      context: OpenCodeSessionContext,
-      event: OpenCodeTerminalRequestEvent,
-    ) {
-      const requestId = event.properties.requestID;
-      if (context.emittedTerminalRequestIds.has(requestId)) {
-        return;
-      }
-      context.emittedTerminalRequestIds.add(requestId);
-      if (event.type === "permission.replied") {
-        yield* emit({
-          ...(yield* buildEventBase({
-            threadId: context.session.threadId,
-            turnId: context.activeTurnId,
-            requestId,
-            raw: event,
-          })),
-          type: "request.resolved",
-          payload: {
-            requestType: "unknown",
-            decision: mapPermissionDecision(event.properties.reply),
-          },
-        });
-        return;
-      }
-
-      const request = context.pendingQuestions.get(requestId);
-      const answers =
-        event.type === "question.replied" && request
-          ? Object.fromEntries(
-              request.questions.map((question, index) => [
-                openCodeQuestionId(index, question),
-                event.properties.answers[index]?.join(", ") ?? "",
-              ]),
-            )
-          : {};
-      yield* emit({
-        ...(yield* buildEventBase({
-          threadId: context.session.threadId,
-          turnId: context.activeTurnId,
-          requestId,
-          raw: event,
-        })),
-        type: "user-input.resolved",
-        payload: { answers },
-      });
-    });
-
-    const scheduleRequestRelationRetry = Effect.fn("scheduleRequestRelationRetry")(function* (
-      context: OpenCodeSessionContext,
-      event: OpenCodeRoutedRequestEvent,
-      raw: unknown = event,
-    ) {
-      const isAskedEvent = event.type === "permission.asked" || event.type === "question.asked";
-      const requestId = isAskedEvent ? event.properties.id : event.properties.requestID;
-      if (context.requestRelationRetries.has(requestId)) {
-        return;
-      }
-      if (isAskedEvent && context.resolvedRequestIds.has(requestId)) {
-        return;
-      }
-      const retry: OpenCodeRequestRelationRetry = { warned: false };
-      context.requestRelationRetries.set(requestId, retry);
-      const run = Effect.gen(function* () {
-        let retryCount = 0;
-        while (context.requestRelationRetries.get(requestId) === retry) {
-          const relation = yield* isRelatedOpenCodeSession(
-            context,
-            event.properties.sessionID,
-          ).pipe(
-            Effect.match({
-              onFailure: (cause) => ({ type: "unknown" as const, cause }),
-              onSuccess: (related) => ({ type: "known" as const, related }),
-            }),
-          );
-          if (context.requestRelationRetries.get(requestId) !== retry) {
-            return;
-          }
-          if (relation.type === "known") {
-            context.requestRelationRetries.delete(requestId);
-            if (relation.related) {
-              if (isAskedEvent) {
-                yield* emitPendingOpenCodeRequest(context, event, raw);
-              } else {
-                yield* emitTerminalOpenCodeRequest(context, event);
-              }
-            }
-            return;
-          }
-          if (!retry.warned) {
-            retry.warned = true;
-            yield* emit({
-              ...(yield* buildEventBase({
-                threadId: context.session.threadId,
-                requestId,
-              })),
-              type: "runtime.warning",
-              payload: {
-                message: "OpenCode request routing is waiting for session ancestry.",
-                detail: openCodeRuntimeErrorDetail(relation.cause),
-              },
-            });
-          }
-          const delayMs = Math.min(250 * 2 ** retryCount, 5_000);
-          retryCount += 1;
-          if (!isAskedEvent && retryCount >= 5) {
-            return;
-          }
-          yield* Effect.sleep(`${delayMs} millis`);
-        }
-      }).pipe(
-        Effect.catchCause(() => Effect.void),
-        Effect.ensuring(
-          Effect.sync(() => {
-            if (context.requestRelationRetries.get(requestId) === retry) {
-              context.requestRelationRetries.delete(requestId);
-            }
-          }),
-        ),
-      );
-      retry.fiber = yield* run.pipe(Effect.forkIn(context.sessionScope));
-    });
-
-    const schedulePendingRequestRecovery = Effect.fn("schedulePendingRequestRecovery")(function* (
-      context: OpenCodeSessionContext,
-    ) {
-      if (context.pendingRequestRecovery) {
-        context.pendingRequestRecovery.rerun = true;
-        return;
-      }
-      const recovery: OpenCodePendingRequestRecovery = { warned: false, rerun: false };
-      context.pendingRequestRecovery = recovery;
-      const run = Effect.gen(function* () {
-        let retryCount = 0;
-        while (context.pendingRequestRecovery === recovery) {
-          const responses = yield* Effect.all({
-            permissions: runOpenCodeSdk("permission.list", () => context.client.permission.list()),
-            questions: runOpenCodeSdk("question.list", () => context.client.question.list()),
-          }).pipe(
-            Effect.match({
-              onFailure: (cause) => ({ type: "failure" as const, cause }),
-              onSuccess: (value) => ({ type: "success" as const, value }),
-            }),
-          );
-          if (context.pendingRequestRecovery !== recovery) {
-            return;
-          }
-          if (responses.type === "failure") {
-            if (!recovery.warned) {
-              recovery.warned = true;
-              yield* emit({
-                ...(yield* buildEventBase({ threadId: context.session.threadId })),
-                type: "runtime.warning",
-                payload: {
-                  message: "OpenCode pending request recovery failed and will retry.",
-                  detail: openCodeRuntimeErrorDetail(responses.cause),
-                },
-              });
-            }
-            const delayMs = Math.min(250 * 2 ** retryCount, 5_000);
-            retryCount += 1;
-            yield* Effect.sleep(`${delayMs} millis`);
-            continue;
-          }
-          const permissions = responses.value.permissions.data;
-          const questions = responses.value.questions.data;
-          if (permissions === undefined || questions === undefined) {
-            if (!recovery.warned) {
-              recovery.warned = true;
-              yield* emit({
-                ...(yield* buildEventBase({ threadId: context.session.threadId })),
-                type: "runtime.warning",
-                payload: {
-                  message: "OpenCode pending request recovery returned no data and will retry.",
-                },
-              });
-            }
-            const delayMs = Math.min(250 * 2 ** retryCount, 5_000);
-            retryCount += 1;
-            yield* Effect.sleep(`${delayMs} millis`);
-            continue;
-          }
-          yield* Effect.forEach(
-            permissions,
-            (request) =>
-              scheduleRequestRelationRetry(
-                context,
-                { id: `recovered:${request.id}`, type: "permission.asked", properties: request },
-                { type: "permission.asked", properties: request, recovered: true },
-              ),
-            { discard: true },
-          );
-          yield* Effect.forEach(
-            questions,
-            (request) =>
-              scheduleRequestRelationRetry(
-                context,
-                { id: `recovered:${request.id}`, type: "question.asked", properties: request },
-                { type: "question.asked", properties: request, recovered: true },
-              ),
-            { discard: true },
-          );
-          if (recovery.rerun) {
-            recovery.rerun = false;
-            recovery.warned = false;
-            continue;
-          }
-          context.pendingRequestRecovery = undefined;
-          return;
-        }
-      }).pipe(
-        Effect.catchCause(() => Effect.void),
-        Effect.ensuring(
-          Effect.sync(() => {
-            if (context.pendingRequestRecovery === recovery) {
-              context.pendingRequestRecovery = undefined;
-            }
-          }),
-        ),
-      );
-      yield* run.pipe(Effect.forkIn(context.sessionScope));
-    });
-
-    const handleSubscribedEvent = Effect.fn("handleSubscribedEvent")(function* (
-      context: OpenCodeSessionContext,
-      event: OpenCodeSubscribedEvent,
-    ) {
-      if (event.type === "server.connected") {
-        if (
-          (yield* Ref.get(context.stopped)) ||
-          sessions.get(context.session.threadId) !== context
-        ) {
-          return;
-        }
-        const isFirstConnection = !(yield* Deferred.isDone(context.firstConnection));
-        if (isFirstConnection) {
-          const updatedAt = yield* nowIso;
-          if (
-            (yield* Ref.get(context.stopped)) ||
-            sessions.get(context.session.threadId) !== context
-          ) {
-            return;
-          }
-          applyProviderSessionUpdate(context, { status: "ready" }, undefined, updatedAt);
-          if (!(yield* Deferred.succeed(context.firstConnection, undefined))) {
-            return;
-          }
-        }
-        yield* schedulePendingRequestRecovery(context);
-        if (!isFirstConnection) {
-          yield* schedulePromptAdmissionRecovery(context, event);
-        }
-        return;
-      }
-      const terminalRequestId =
-        event.type === "permission.replied" ||
-        event.type === "question.replied" ||
-        event.type === "question.rejected"
-          ? event.properties.requestID
-          : undefined;
-      if (terminalRequestId !== undefined) {
-        yield* resolvePendingOpenCodeRequest(context, terminalRequestId);
-      }
-      if (event.type === "session.created" || event.type === "session.updated") {
-        const session = event.properties.info;
-        if (session.parentID && context.relatedSessionIds.has(session.parentID)) {
-          context.relatedSessionIds.add(session.id);
-        }
-      } else if (event.type === "session.deleted") {
-        context.relatedSessionIds.delete(event.properties.info.id);
-      }
-
-      const payloadSessionId = openCodeEventSessionId(event);
-      const isParentEvent = payloadSessionId === context.openCodeSessionId;
-      let isKnownPendingTerminalEvent = false;
-      if (
-        payloadSessionId !== undefined &&
-        !context.relatedSessionIds.has(payloadSessionId) &&
-        isOpenCodeChildRequestEvent(event)
-      ) {
-        if (event.type === "permission.asked") {
-          yield* scheduleRequestRelationRetry(context, event);
-        } else if (event.type === "question.asked") {
-          yield* scheduleRequestRelationRetry(context, event);
-        } else if (
-          event.type === "permission.replied" ||
-          event.type === "question.replied" ||
-          event.type === "question.rejected"
-        ) {
-          const requestId = event.properties.requestID;
-          isKnownPendingTerminalEvent =
-            context.pendingPermissions.has(requestId) || context.pendingQuestions.has(requestId);
-          if (!isKnownPendingTerminalEvent) {
-            yield* scheduleRequestRelationRetry(context, event);
-            return;
-          }
-        }
-      }
-      const isChildRequestEvent =
-        payloadSessionId !== undefined &&
-        isOpenCodeChildRequestEvent(event) &&
-        (context.relatedSessionIds.has(payloadSessionId) || isKnownPendingTerminalEvent);
-      if (!isParentEvent && !isChildRequestEvent) {
-        return;
-      }
-
-      const turnId = context.activeTurnId;
-      yield* writeNativeEventBestEffort(context.session.threadId, {
-        observedAt: yield* nowIso,
-        event: {
-          provider: PROVIDER,
-          threadId: context.session.threadId,
-          providerThreadId: context.openCodeSessionId,
-          type: event.type,
-          ...(turnId ? { turnId } : {}),
-          ...(!isParentEvent && payloadSessionId ? { childSessionId: payloadSessionId } : {}),
-          payload: event,
-        },
-      });
-
-      const suppressInterruptedParentOutput =
-        isParentEvent &&
-        ((context.activeTurnId === undefined &&
-          (context.interruptedTurnId !== undefined || context.reconcileIdleStatus)) ||
-          context.awaitingBusyAfterInterruption) &&
-        (event.type === "message.part.delta" ||
-          event.type === "message.part.updated" ||
-          (event.type === "message.updated" && event.properties.info.role === "assistant"));
-      if (suppressInterruptedParentOutput) {
-        return;
-      }
-
-      switch (event.type) {
-        case "session.updated": {
-          const title = openCodeEventSessionTitle(event);
-          if (title) {
-            yield* emit({
-              ...(yield* buildEventBase({
-                threadId: context.session.threadId,
-                raw: event,
-              })),
-              type: "thread.metadata.updated",
-              payload: {
-                name: title,
-                metadata: {
-                  sessionID: context.openCodeSessionId,
-                },
-              },
-            });
-          }
-          break;
-        }
-
-        case "message.updated": {
-          const promptAdmission = context.promptAdmission;
-          if (
-            event.properties.info.role === "user" &&
-            promptAdmission?.messageId === event.properties.info.id
-          ) {
-            promptAdmission.messageObserved = true;
-            if (promptAdmission.accepted) {
-              const idle = promptAdmission.idleDuringAdmission;
-              context.awaitingBusyAfterInterruption = false;
-              context.promptAdmission = undefined;
-              if (promptAdmission.recoveryFiber) {
-                yield* Fiber.interrupt(promptAdmission.recoveryFiber);
-              }
-              if (idle) {
-                yield* scheduleIdleReconciliation(context, idle.turnId, idle.raw);
-              }
-            }
-          }
-          context.messageRoleById.set(event.properties.info.id, event.properties.info.role);
-          if (event.properties.info.role === "assistant") {
-            for (const part of context.partById.values()) {
-              if (part.messageID !== event.properties.info.id) {
-                continue;
-              }
-              yield* emitAssistantTextDelta(context, part, turnId, event);
-            }
-          }
-          break;
-        }
-
-        case "message.removed": {
-          context.messageRoleById.delete(event.properties.messageID);
-          break;
-        }
-
-        case "message.part.delta": {
-          const existingPart = context.partById.get(event.properties.partID);
-          if (!existingPart) {
-            break;
-          }
-          const role = messageRoleForPart(context, existingPart);
-          if (role !== "assistant") {
-            break;
-          }
-          const streamKind = resolveTextStreamKind(existingPart);
-          const delta = event.properties.delta;
-          if (delta.length === 0) {
-            break;
-          }
-          const previousText =
-            context.emittedTextByPartId.get(event.properties.partID) ??
-            textFromPart(existingPart) ??
-            "";
-          const { nextText, deltaToEmit } = appendOpenCodeAssistantTextDelta(previousText, delta);
-          if (deltaToEmit.length === 0) {
-            break;
-          }
-          context.emittedTextByPartId.set(event.properties.partID, nextText);
-          if (existingPart.type === "text" || existingPart.type === "reasoning") {
-            context.partById.set(event.properties.partID, {
-              ...existingPart,
-              text: nextText,
-            });
-          }
-          yield* emit({
-            ...(yield* buildEventBase({
-              threadId: context.session.threadId,
-              turnId,
-              itemId: event.properties.partID,
-              raw: event,
-            })),
-            type: "content.delta",
-            payload: {
-              streamKind,
-              delta: deltaToEmit,
-            },
-          });
-          break;
-        }
-
-        case "message.part.updated": {
-          const part = event.properties.part;
-          context.partById.set(part.id, part);
-          const messageRole = messageRoleForPart(context, part);
-
-          if (messageRole === "assistant") {
-            yield* emitAssistantTextDelta(context, part, turnId, event);
-          }
-
-          if (part.type === "tool") {
-            const itemType = toToolLifecycleItemType(part.tool);
-            const title =
-              part.state.status === "running" ? (part.state.title ?? part.tool) : part.tool;
-            const detail = detailFromToolPart(part);
-            const payload = {
-              itemType,
-              ...(part.state.status === "error"
-                ? { status: "failed" as const }
-                : part.state.status === "completed"
-                  ? { status: "completed" as const }
-                  : { status: "inProgress" as const }),
-              ...(title ? { title } : {}),
-              ...(detail ? { detail } : {}),
-              data: {
-                tool: part.tool,
-                state: part.state,
-              },
-            };
-            const runtimeEvent: ProviderRuntimeEvent = {
-              ...(yield* buildEventBase({
-                threadId: context.session.threadId,
-                turnId,
-                itemId: part.callID,
-                createdAt: toolStateCreatedAt(part),
-                raw: event,
-              })),
-              type:
-                part.state.status === "pending"
-                  ? "item.started"
-                  : part.state.status === "completed" || part.state.status === "error"
-                    ? "item.completed"
-                    : "item.updated",
-              payload,
-            };
-            appendTurnItem(context, turnId, part);
-            yield* emit(runtimeEvent);
-          }
-          break;
-        }
-
-        case "permission.asked": {
-          yield* emitPendingOpenCodeRequest(context, event, event);
-          break;
-        }
-
-        case "permission.replied": {
-          context.pendingPermissions.delete(event.properties.requestID);
-          yield* emitTerminalOpenCodeRequest(context, event);
-          break;
-        }
-
-        case "question.asked": {
-          yield* emitPendingOpenCodeRequest(context, event, event);
-          break;
-        }
-
-        case "question.replied": {
-          yield* emitTerminalOpenCodeRequest(context, event);
-          context.pendingQuestions.delete(event.properties.requestID);
-          break;
-        }
-
-        case "question.rejected": {
-          context.pendingQuestions.delete(event.properties.requestID);
-          yield* emitTerminalOpenCodeRequest(context, event);
-          break;
-        }
-
-        case "session.status": {
-          if (event.properties.status.type === "busy") {
-            if (turnId === undefined) {
-              break;
-            }
-            yield* cancelIdleReconciliation(context);
-            context.awaitingBusyAfterInterruption = false;
-            if (context.promptAdmission?.turnId === turnId) {
-              context.promptAdmission.busyObserved = true;
-              yield* schedulePromptAdmissionRecovery(context, event);
-            }
-            yield* updateProviderSession(context, {
-              status: "running",
-              activeTurnId: turnId,
-            });
-          }
-
-          if (event.properties.status.type === "retry") {
-            yield* emit({
-              ...(yield* buildEventBase({
-                threadId: context.session.threadId,
-                turnId,
-                raw: event,
-              })),
-              type: "runtime.warning",
-              payload: {
-                message: event.properties.status.message,
-                detail: event.properties.status,
-              },
-            });
-            break;
-          }
-
-          if (event.properties.status.type === "idle" && turnId) {
-            if (context.cancellation?.turnId === turnId) {
-              context.cancellation.deferredIdleEvent = event;
-              break;
-            }
-            if (context.promptAdmission?.turnId === turnId) {
-              context.promptAdmission.idleDuringAdmission = { turnId, raw: event };
-              context.promptAdmission.idleObservedAfterMessage =
-                context.promptAdmission.messageObserved;
-              yield* schedulePromptAdmissionRecovery(context, event);
-              break;
-            }
-            if (context.awaitingBusyAfterInterruption) {
-              break;
-            }
-            if (context.reconcileIdleStatus) {
-              yield* scheduleIdleReconciliation(context, turnId, event);
-              break;
-            }
-            yield* completeOpenCodeTurn(context, turnId, context.promptGeneration, event);
-          }
-          break;
-        }
-
-        case "session.error": {
-          const message = sessionErrorMessage(event.properties.error);
-          const activeTurnId = context.activeTurnId;
-          const cancellation = context.cancellation;
-          if (isOpenCodeAbortError(event.properties.error)) {
-            if (cancellation !== undefined && cancellation.turnId === undefined) {
-              cancellation.acknowledged = true;
-              context.cancellation = undefined;
-              context.reconcileIdleStatus = true;
-              yield* Deferred.succeed(cancellation.completion, undefined).pipe(Effect.ignore);
-              break;
-            }
-            if (activeTurnId !== undefined && cancellation?.turnId === activeTurnId) {
-              yield* interruptOpenCodeTurn(context, activeTurnId, event);
-              break;
-            }
-            if (context.interruptedTurnId !== undefined || context.reconcileIdleStatus) {
-              break;
-            }
-          }
-          yield* cancelIdleReconciliation(context);
-          if (activeTurnId !== undefined && cancellation?.turnId === activeTurnId) {
-            context.cancellation = undefined;
-            yield* Deferred.succeed(cancellation.completion, undefined).pipe(Effect.ignore);
-          }
-          context.activeTurnId = undefined;
-          context.activeAgent = undefined;
-          context.activeVariant = undefined;
-          context.reconcileIdleStatus = false;
-          yield* updateProviderSession(
-            context,
-            {
-              status: "error",
-              lastError: message,
-            },
-            { clearActiveTurnId: true },
-          );
-          if (activeTurnId) {
-            yield* emit({
-              ...(yield* buildEventBase({
-                threadId: context.session.threadId,
-                turnId: activeTurnId,
-                raw: event,
-              })),
-              type: "turn.completed",
-              payload: {
-                state: "failed",
-                errorMessage: message,
-              },
-            });
-          }
-          yield* emit({
-            ...(yield* buildEventBase({
-              threadId: context.session.threadId,
-              raw: event,
-            })),
-            type: "runtime.error",
-            payload: {
-              message,
-              class: "provider_error",
-              detail: event.properties.error,
-            },
-          });
-          break;
-        }
-
-        default:
-          break;
-      }
-    });
-
-    const startEventPump = Effect.fn("startEventPump")(function* (context: OpenCodeSessionContext) {
-      // One AbortController per session scope. The finalizer fires when
-      // the scope closes (explicit stop, unexpected exit, or layer
-      // shutdown) and cancels the in-flight `event.subscribe` fetch so
-      // the async iterable unwinds cleanly.
-      const eventsAbortController = new AbortController();
-      yield* Scope.addFinalizer(
-        context.sessionScope,
-        Effect.sync(() => eventsAbortController.abort()),
-      );
-
-      // Fibers forked into `context.sessionScope` are interrupted
-      // automatically when the scope closes — no bookkeeping required.
-      yield* Effect.flatMap(
-        runOpenCodeSdk("event.subscribe", () =>
-          context.client.event.subscribe(undefined, {
-            signal: eventsAbortController.signal,
-          }),
-        ),
-        (subscription) =>
-          Stream.fromAsyncIterable(
-            subscription.stream,
-            (cause) =>
-              new OpenCodeRuntimeError({
-                operation: "event.subscribe",
-                detail: openCodeRuntimeErrorDetail(cause),
-                cause,
-              }),
-          ).pipe(Stream.runForEach((event) => handleSubscribedEvent(context, event))),
-      ).pipe(
-        Effect.exit,
-        Effect.flatMap((exit) =>
-          Effect.gen(function* () {
-            // Expected paths: caller aborted the fetch or the session
-            // has already been marked stopped. Treat as a clean exit.
-            if (eventsAbortController.signal.aborted || (yield* Ref.get(context.stopped))) {
-              return;
-            }
-            if (Exit.isFailure(exit)) {
-              yield* emitUnexpectedExit(
-                context,
-                openCodeRuntimeErrorDetail(Cause.squash(exit.cause)),
-              );
-            }
-          }),
-        ),
-        Effect.forkIn(context.sessionScope),
-      );
-
-      if (!context.server.external && context.server.exitCode !== null) {
-        yield* context.server.exitCode.pipe(
-          Effect.flatMap((code) =>
-            Effect.gen(function* () {
-              if (yield* Ref.get(context.stopped)) {
-                return;
-              }
-              yield* emitUnexpectedExit(context, `OpenCode server exited unexpectedly (${code}).`);
-            }),
-          ),
-          Effect.forkIn(context.sessionScope),
-        );
-      }
-    });
-
-    const startSession: OpenCodeAdapterShape["startSession"] = Effect.fn("startSession")(
-      function* (input) {
-        const binaryPath = openCodeSettings.binaryPath;
-        const serverUrl = openCodeSettings.serverUrl;
-        const serverPassword = openCodeSettings.serverPassword;
-        const directory = input.cwd ?? serverConfig.cwd;
-        const resumeSessionId = parseOpenCodeResume(input.resumeCursor)?.sessionId;
-        const existing = sessions.get(input.threadId);
-        if (existing) {
-          if (existing.session.status === "connecting" && !(yield* Ref.get(existing.stopped))) {
-            return (yield* awaitOpenCodeContextReady(existing)).session;
-          }
-          yield* stopOpenCodeContext(existing);
-          deleteContextIfCurrent(existing);
-        }
-
-        const started = yield* Effect.gen(function* () {
-          const sessionScope = yield* Scope.make();
-          const startedExit = yield* Effect.exit(
-            Effect.gen(function* () {
-              // The runtime binds the server's lifetime to the Scope.Scope
-              // we provide below — closing `sessionScope` kills the child
-              // process automatically. No manual `server.close()` needed.
-              const server = yield* openCodeRuntime.connectToOpenCodeServer({
-                binaryPath,
-                directory,
-                serverUrl,
-                ...(serverPassword ? { serverPassword } : {}),
-                ...(options?.environment ? { environment: options.environment } : {}),
-              });
-              const client = openCodeRuntime.createOpenCodeSdkClient({
-                baseUrl: server.url,
-                directory,
-                ...(server.serverPassword ? { serverPassword: server.serverPassword } : {}),
-              });
-              const mcpSession = McpProviderSession.readMcpProviderSession(input.threadId);
-              if (mcpSession && !server.external) {
-                yield* runOpenCodeSdk("mcp.add", () =>
-                  client.mcp.add({
-                    name: "t3-code",
-                    config: {
-                      type: "remote",
-                      url: mcpSession.endpoint,
-                      headers: {
-                        Authorization: mcpSession.authorizationHeader,
-                      },
-                      oauth: false,
-                    },
-                  }),
-                );
-              }
-              // Resume: re-adopt the session named by the durable cursor —
-              // OpenCode scopes history by session id. The probe recovers only
-              // a confirmed not-found (start fresh); transport/auth/server
-              // errors propagate instead of masking as a new empty session.
-              const resolved = yield* Effect.gen(function* () {
-                const adopted = resumeSessionId
-                  ? yield* runOpenCodeSdk("session.get", () =>
-                      client.session.get({ sessionID: resumeSessionId }),
-                    ).pipe(
-                      Effect.map((response) => response.data),
-                      Effect.catchIf(
-                        (cause) => isOpenCodeNotFound(cause),
-                        () => Effect.void,
-                      ),
-                    )
-                  : undefined;
-
-                // Reuse in place only when the session still matches the
-                // requested cwd; on a cwd change it is forked below instead.
-                const reusable =
-                  adopted &&
-                  (!adopted.directory || (yield* sameDirectory(adopted.directory, directory)))
-                    ? adopted
-                    : undefined;
-
-                if (reusable) {
-                  // Resume skips `session.create`, so re-assert the ruleset —
-                  // a runtime-mode change would otherwise leave the session on
-                  // its original permissions.
-                  yield* runOpenCodeSdk("session.update", () =>
-                    client.session.update({
-                      sessionID: reusable.id,
-                      permission: buildOpenCodePermissionRules(input.runtimeMode),
-                    }),
-                  );
-                  return { openCodeSession: reusable, created: false };
-                }
-
-                // The session lives under a different cwd (e.g. the thread
-                // moved into a git worktree). Fork it into the requested
-                // directory instead of minting an empty one — the fork carries
-                // the full history, so the follow-up keeps its context (#3604).
-                if (adopted) {
-                  yield* Effect.logInfo(
-                    `OpenCode session '${adopted.id}' was created under a different working directory; forking into '${directory}' to preserve conversation history.`,
-                  );
-                  const forkedSession = yield* runOpenCodeSdk("session.fork", () =>
-                    client.session.fork({ sessionID: adopted.id, directory }),
-                  );
-                  const forked = forkedSession.data;
-                  if (!forked) {
-                    return yield* new OpenCodeRuntimeError({
-                      operation: "session.fork",
-                      detail: "OpenCode session.fork returned no session payload.",
-                    });
-                  }
-                  yield* runOpenCodeSdk("session.update", () =>
-                    client.session.update({
-                      sessionID: forked.id,
-                      permission: buildOpenCodePermissionRules(input.runtimeMode),
-                    }),
-                  );
-                  return { openCodeSession: forked, created: true };
-                }
-
-                if (resumeSessionId) {
-                  yield* Effect.logWarning(
-                    `OpenCode session '${resumeSessionId}' no longer exists; starting a fresh session.`,
-                  );
-                }
-                const createdSession = yield* runOpenCodeSdk("session.create", () =>
-                  client.session.create({
-                    ...(input.title ? { title: input.title } : {}),
-                    permission: buildOpenCodePermissionRules(input.runtimeMode),
-                  }),
-                );
-                if (!createdSession.data) {
-                  return yield* new OpenCodeRuntimeError({
-                    operation: "session.create",
-                    detail: "OpenCode session.create returned no session payload.",
-                  });
-                }
-                return { openCodeSession: createdSession.data, created: true };
-              });
-
-              return {
-                sessionScope,
-                server,
-                client,
-                openCodeSession: resolved.openCodeSession,
-                created: resolved.created,
-              };
-            }).pipe(Effect.provideService(Scope.Scope, sessionScope)),
-          );
-          if (Exit.isFailure(startedExit)) {
-            yield* Scope.close(sessionScope, Exit.void).pipe(Effect.ignore);
-            return yield* toProcessError(input.threadId, Cause.squash(startedExit.cause));
-          }
-          return startedExit.value;
-        });
-
-        const createdAt = yield* nowIso;
-        const session: ProviderSession = {
-          provider: PROVIDER,
-          providerInstanceId: boundInstanceId,
-          status: "connecting",
-          runtimeMode: input.runtimeMode,
-          cwd: directory,
-          ...(input.modelSelection ? { model: input.modelSelection.model } : {}),
-          threadId: input.threadId,
-          // ProviderService persists this cursor and feeds it back into
-          // `startSession` after the in-memory session is lost (reaper /
-          // restart), so follow-ups continue the same conversation (#3604).
-          resumeCursor: {
-            schemaVersion: OPENCODE_RESUME_VERSION,
-            sessionId: started.openCodeSession.id,
-          },
-          createdAt,
-          updatedAt: createdAt,
-        };
-
-        const context: OpenCodeSessionContext = {
-          session,
-          client: started.client,
-          server: started.server,
-          directory,
-          openCodeSessionId: started.openCodeSession.id,
-          relatedSessionIds: new Set([started.openCodeSession.id]),
-          resolvedRequestIds: new Set(),
-          emittedTerminalRequestIds: new Set(),
-          requestRelationRetries: new Map(),
-          pendingPermissions: new Map(),
-          pendingQuestions: new Map(),
-          partById: new Map(),
-          emittedTextByPartId: new Map(),
-          messageRoleById: new Map(),
-          completedAssistantPartIds: new Set(),
-          turns: [],
-          activeTurnId: undefined,
-          activeAgent: undefined,
-          activeVariant: undefined,
-          cancellation: undefined,
-          interruptedTurnId: undefined,
-          reconcileIdleStatus: false,
-          awaitingBusyAfterInterruption: false,
-          pendingIdleReconciliation: undefined,
-          pendingRequestRecovery: undefined,
-          promptGeneration: 0,
-          promptAdmission: undefined,
-          promptSemaphore: Semaphore.makeUnsafe(1),
-          firstConnection: Deferred.makeUnsafe<void, ProviderAdapterRequestError>(),
-          stopped: yield* Ref.make(false),
-          sessionScope: started.sessionScope,
-        };
-        const raceWinner = sessions.get(input.threadId);
-        if (raceWinner) {
-          // Another start published first. A newly created remote session
-          // belongs to this loser; a resumed session is shared upstream state.
-          yield* closeStartingOpenCodeContext(context, started.created);
-          return (yield* awaitOpenCodeContextReady(raceWinner)).session;
-        }
-        sessions.set(input.threadId, context);
-        const cleanupStartingContext = closeStartingOpenCodeContext(context, started.created).pipe(
-          Effect.ensuring(Effect.sync(() => deleteContextIfCurrent(context))),
-        );
-        const connectionExit = yield* Effect.gen(function* () {
-          yield* startEventPump(context);
-          yield* Deferred.await(context.firstConnection).pipe(
-            Effect.timeout("10 seconds"),
-            Effect.mapError(
-              (cause) =>
-                new ProviderAdapterRequestError({
-                  provider: PROVIDER,
-                  method: "event.subscribe",
-                  detail: "OpenCode event stream did not connect within 10 seconds.",
-                  cause,
-                }),
-            ),
-          );
-        }).pipe(
-          Effect.onInterrupt(() => cleanupStartingContext),
-          Effect.exit,
-        );
-        if (Exit.isFailure(connectionExit)) {
-          yield* cleanupStartingContext;
-          return yield* Effect.failCause(connectionExit.cause);
-        }
-        yield* awaitOpenCodeContextReady(context);
-        if (!started.created) {
-          yield* schedulePendingRequestRecovery(context);
-        }
-
-        yield* emit({
-          ...(yield* buildEventBase({ threadId: input.threadId })),
-          type: "session.started",
-          payload: {
-            message: "OpenCode session started",
-          },
-        });
-        yield* emit({
-          ...(yield* buildEventBase({ threadId: input.threadId })),
-          type: "thread.started",
-          payload: {
-            providerThreadId: started.openCodeSession.id,
-          },
-        });
-
-        return context.session;
-      },
-    );
-
-    const sendTurn: OpenCodeAdapterShape["sendTurn"] = Effect.fn("sendTurn")(function* (input) {
-      const context = yield* ensureSessionContext(sessions, input.threadId);
-      yield* awaitOpenCodeContextReady(context);
-      const modelSelection =
-        input.modelSelection ??
-        (context.session.model
-          ? { instanceId: boundInstanceId, model: context.session.model }
-          : undefined);
-      if (modelSelection !== undefined && modelSelection.instanceId !== boundInstanceId) {
-        return yield* new ProviderAdapterValidationError({
-          provider: PROVIDER,
-          operation: "sendTurn",
-          issue: `OpenCode model selection is bound to instance '${modelSelection?.instanceId}', expected '${boundInstanceId}'.`,
-        });
-      }
-      const parsedModel = parseOpenCodeModelSlug(modelSelection?.model);
-      if (!parsedModel) {
-        return yield* new ProviderAdapterValidationError({
-          provider: PROVIDER,
-          operation: "sendTurn",
-          issue: "OpenCode model selection must use the 'provider/model' format.",
-        });
-      }
-
-      const text = input.input?.trim();
-      // OpenCode ingests images, text, and PDFs natively; formats its model
-      // paths reject ride only as the prompt's file path line.
-      const fileParts = toOpenCodeFileParts({
-        attachments: input.attachments,
-        resolveAttachmentPath: (attachment) =>
-          resolveAttachmentPath({
-            attachmentsDir: serverConfig.attachmentsDir,
-            attachment,
-          }),
-      });
-      if ((!text || text.length === 0) && fileParts.length === 0) {
-        return yield* new ProviderAdapterValidationError({
-          provider: PROVIDER,
-          operation: "sendTurn",
-          issue: "OpenCode turns require text input or at least one attachment.",
-        });
-      }
-
-      return yield* context.promptSemaphore.withPermit(
-        Effect.gen(function* () {
-          const freshTurnId = TurnId.make(`opencode-turn-${yield* randomUUIDv4}`);
-          const messageId = yield* makeOpenCodeMessageId();
-          const pendingCancellation = context.cancellation;
-          if (pendingCancellation) {
-            const cancellationResult = yield* Deferred.await(pendingCancellation.completion).pipe(
-              Effect.result,
-            );
-            if ((yield* Ref.get(context.stopped)) || sessions.get(input.threadId) !== context) {
-              return yield* Effect.interrupt;
-            }
-            if (cancellationResult._tag === "Failure") {
-              return yield* cancellationResult.failure;
-            }
-          }
-          if (sessions.get(input.threadId) !== context || (yield* Ref.get(context.stopped))) {
-            return yield* Effect.interrupt;
-          }
-          // A sendTurn while a turn is active is a steer. OpenCode queues the
-          // prompt into the running session, so the active turn id is reused.
-          const steeringTurnId = context.activeTurnId;
-          const turnId = steeringTurnId ?? freshTurnId;
-          const agent = getModelSelectionStringOptionValue(modelSelection, "agent");
-          const variant = getModelSelectionStringOptionValue(modelSelection, "variant");
-          const pendingIdleReconciliation = context.pendingIdleReconciliation;
-          const priorAwaitingBusy = context.awaitingBusyAfterInterruption;
-          const priorIdleCandidate = pendingIdleReconciliation
-            ? {
-                turnId: pendingIdleReconciliation.turnId,
-                raw: pendingIdleReconciliation.raw,
-              }
-            : undefined;
-          context.pendingIdleReconciliation = undefined;
-          const promptGeneration = context.promptGeneration + 1;
-          const promptAdmission: OpenCodePromptAdmission = {
-            generation: promptGeneration,
-            turnId,
-            messageId,
-            priorAwaitingBusy,
-            priorIdle: priorIdleCandidate,
-            idleDuringAdmission: undefined,
-            idleObservedAfterMessage: false,
-            messageObserved: false,
-            busyObserved: false,
-            idleStatusConfirmations: 0,
-            accepted: false,
-            cancelled: false,
-            acceptance: Deferred.makeUnsafe<void>(),
-            submissionSettled: Deferred.makeUnsafe<void>(),
-            recoveryRaw: undefined,
-          };
-          context.promptGeneration = promptGeneration;
-          context.promptAdmission = promptAdmission;
-
-          context.activeTurnId = turnId;
-          context.activeAgent = agent ?? (input.interactionMode === "plan" ? "plan" : undefined);
-          context.activeVariant = variant;
-          if (steeringTurnId === undefined) {
-            context.awaitingBusyAfterInterruption = context.interruptedTurnId !== undefined;
-          }
-          if (pendingIdleReconciliation?.fiber) {
-            yield* Fiber.interrupt(pendingIdleReconciliation.fiber);
-          }
-          yield* updateProviderSession(
-            context,
-            {
-              status: "running",
-              activeTurnId: turnId,
-              model: modelSelection?.model ?? context.session.model,
-            },
-            { clearLastError: true },
-          );
-
-          if (steeringTurnId === undefined) {
-            yield* emit({
-              ...(yield* buildEventBase({ threadId: input.threadId, turnId })),
-              type: "turn.started",
-              payload: {
-                model: modelSelection?.model ?? context.session.model,
-                ...(variant ? { effort: variant } : {}),
-              },
-            });
-          }
-
-          if (promptAdmission.cancelled || (yield* Ref.get(context.stopped))) {
-            yield* Deferred.succeed(promptAdmission.submissionSettled, undefined).pipe(
-              Effect.ignore,
-            );
-            const cancellation = context.cancellation;
-            if (cancellation?.turnId === turnId) {
-              yield* Deferred.await(cancellation.completion).pipe(Effect.result);
-            }
-            return yield* Effect.interrupt;
-          }
-
-          let promptTimedOut = false;
-          const promptEffect = runOpenCodeSdk("session.promptAsync", (signal) =>
-            context.client.session.promptAsync(
-              {
-                sessionID: context.openCodeSessionId,
-                messageID: messageId,
-                model: parsedModel,
-                ...(context.activeAgent ? { agent: context.activeAgent } : {}),
-                ...(context.activeVariant ? { variant: context.activeVariant } : {}),
-                parts: [...(text ? [{ type: "text" as const, text }] : []), ...fileParts],
-              },
-              { signal },
-            ),
-          ).pipe(
-            Effect.timeout("10 seconds"),
-            Effect.catchTags({
-              OpenCodeRuntimeError: (cause) => Effect.fail(toRequestError(cause)),
-              TimeoutError: (cause) => {
-                promptTimedOut = true;
-                return Effect.fail(
-                  new ProviderAdapterRequestError({
-                    provider: PROVIDER,
-                    method: "session.promptAsync",
-                    detail: "OpenCode prompt submission did not complete within 10 seconds.",
-                    cause,
-                  }),
-                );
-              },
-            }),
-            Effect.tapError((requestError) =>
-              context.promptAdmission !== promptAdmission || context.activeTurnId !== turnId
-                ? Effect.void
-                : Effect.gen(function* () {
-                    if (!promptTimedOut) {
-                      if (steeringTurnId !== undefined) {
-                        context.promptAdmission = undefined;
-                        context.awaitingBusyAfterInterruption = promptAdmission.priorAwaitingBusy;
-                        const idle =
-                          promptAdmission.idleDuringAdmission ?? promptAdmission.priorIdle;
-                        if (idle) {
-                          yield* scheduleIdleReconciliation(context, idle.turnId, idle.raw);
-                        }
-                        return;
-                      }
-                      context.promptAdmission = undefined;
-                      context.activeTurnId = undefined;
-                      context.activeAgent = undefined;
-                      context.activeVariant = undefined;
-                      yield* updateProviderSession(
-                        context,
-                        {
-                          status: "ready",
-                          model: modelSelection?.model ?? context.session.model,
-                          lastError: requestError.detail,
-                        },
-                        { clearActiveTurnId: true },
-                      );
-                      yield* emit({
-                        ...(yield* buildEventBase({ threadId: input.threadId, turnId })),
-                        type: "turn.aborted",
-                        payload: { reason: requestError.detail },
-                      });
-                      return;
-                    }
-                    const cleanupExit = yield* Effect.exit(
-                      runOpenCodeSdk("session.abort", (signal) =>
-                        context.client.session.abort(
-                          { sessionID: context.openCodeSessionId },
-                          { signal },
-                        ),
-                      ).pipe(Effect.timeout("1 second")),
-                    );
-                    if (Exit.isFailure(cleanupExit)) {
-                      yield* emit({
-                        ...(yield* buildEventBase({ threadId: input.threadId, turnId })),
-                        type: "runtime.warning",
-                        payload: {
-                          message:
-                            "OpenCode prompt submission failed and its cleanup abort did not complete.",
-                          detail: openCodeRuntimeErrorDetail(Cause.squash(cleanupExit.cause)),
-                        },
-                      });
-                      yield* schedulePromptAdmissionRecovery(context, {
-                        requestError,
-                        cleanupError: Cause.squash(cleanupExit.cause),
-                      });
-                      return;
-                    }
-                    context.promptAdmission = undefined;
-                    context.activeTurnId = undefined;
-                    context.activeAgent = undefined;
-                    context.activeVariant = undefined;
-                    context.awaitingBusyAfterInterruption = false;
-                    context.reconcileIdleStatus = false;
-                    yield* updateProviderSession(
-                      context,
-                      {
-                        status: "ready",
-                        model: modelSelection?.model ?? context.session.model,
-                        lastError: requestError.detail,
-                      },
-                      { clearActiveTurnId: true },
-                    );
-                    yield* emit({
-                      ...(yield* buildEventBase({
-                        threadId: input.threadId,
-                        turnId,
-                      })),
-                      type: "turn.aborted",
-                      payload: {
-                        reason: requestError.detail,
-                      },
-                    });
-                  }),
-            ),
-            Effect.onExit((exit) =>
-              Effect.gen(function* () {
-                yield* Deferred.succeed(promptAdmission.submissionSettled, undefined).pipe(
-                  Effect.ignore,
-                );
-                if (Exit.isFailure(exit)) {
-                  yield* Deferred.succeed(promptAdmission.acceptance, undefined).pipe(
-                    Effect.ignore,
-                  );
-                }
-              }),
-            ),
-            Effect.asVoid,
-          );
-          const promptFiber = yield* promptEffect.pipe(Effect.forkIn(context.sessionScope));
-          promptAdmission.promptFiber = promptFiber;
-          const promptExit = yield* Effect.exit(Fiber.join(promptFiber));
-          delete promptAdmission.promptFiber;
-
-          const intentionallyCancelled =
-            promptAdmission.cancelled ||
-            (yield* Ref.get(context.stopped)) ||
-            sessions.get(input.threadId) !== context;
-          if (Exit.isFailure(promptExit) && !intentionallyCancelled) {
-            return yield* Effect.failCause(promptExit.cause);
-          }
-          const cancelled =
-            intentionallyCancelled ||
-            context.activeTurnId !== turnId ||
-            context.promptGeneration !== promptAdmission.generation;
-          if (cancelled) {
-            const cancellation = context.cancellation;
-            if (cancellation?.turnId === turnId) {
-              yield* Deferred.await(cancellation.completion).pipe(Effect.result);
-            }
-            if (context.promptAdmission === promptAdmission) {
-              context.promptAdmission = undefined;
-            }
-            return yield* Effect.interrupt;
-          }
-          promptAdmission.accepted = true;
-          yield* Deferred.succeed(promptAdmission.acceptance, undefined).pipe(Effect.ignore);
-          if (
-            context.promptAdmission === promptAdmission &&
-            context.activeTurnId === turnId &&
-            context.promptGeneration === promptAdmission.generation &&
-            promptAdmission.messageObserved
-          ) {
-            context.awaitingBusyAfterInterruption = false;
-            const idle = promptAdmission.idleDuringAdmission;
-            if (idle && !promptAdmission.idleObservedAfterMessage) {
-              yield* schedulePromptAdmissionRecovery(context, idle.raw);
-            } else {
-              context.promptAdmission = undefined;
-            }
-            if (idle && promptAdmission.idleObservedAfterMessage) {
-              yield* scheduleIdleReconciliation(context, turnId, idle.raw);
-            }
-          } else {
-            yield* schedulePromptAdmissionRecovery(context, promptAdmission.recoveryRaw);
-          }
-
-          const stopped = yield* Ref.get(context.stopped);
-          const finalCancellation = context.cancellation;
-          if (
-            stopped ||
-            sessions.get(input.threadId) !== context ||
-            promptAdmission.cancelled ||
-            context.activeTurnId !== turnId ||
-            context.promptGeneration !== promptAdmission.generation ||
-            finalCancellation?.turnId === turnId
-          ) {
-            if (finalCancellation?.turnId === turnId) {
-              yield* Deferred.await(finalCancellation.completion).pipe(Effect.result);
-            }
-            if (context.promptAdmission === promptAdmission) {
-              context.promptAdmission = undefined;
-            }
-            return yield* Effect.interrupt;
-          }
-
-          return {
-            threadId: input.threadId,
-            turnId,
-            // Re-surface the durable cursor on every turn so the persisted binding
-            // is refreshed alongside last-seen/runtime state (mirrors Grok/Codex).
-            ...(context.session.resumeCursor !== undefined
-              ? { resumeCursor: context.session.resumeCursor }
-              : {}),
-          };
-        }),
-      );
-    });
-
-    const interruptTurn: OpenCodeAdapterShape["interruptTurn"] = Effect.fn("interruptTurn")(
-      function* (threadId, turnId) {
-        const context = yield* ensureSessionContext(sessions, threadId);
-        const activeTurnId = context.activeTurnId;
-        if (turnId !== undefined && activeTurnId !== turnId) {
-          return;
-        }
-        const interruptedTurnId = turnId ?? activeTurnId;
-        yield* cancelIdleReconciliation(context);
-        if (interruptedTurnId && context.interruptedTurnId === interruptedTurnId) {
-          return;
-        }
-        const existingCancellation = context.cancellation;
-        if (
-          existingCancellation !== undefined &&
-          existingCancellation.turnId === interruptedTurnId
-        ) {
-          return yield* Deferred.await(existingCancellation.completion);
-        }
-        const cancellation: OpenCodeCancellation = {
-          turnId: interruptedTurnId,
-          completion: Deferred.makeUnsafe<void, ProviderAdapterRequestError>(),
-        };
-        context.cancellation = cancellation;
-        const promptAdmission = context.promptAdmission;
-        if (promptAdmission !== undefined && promptAdmission.turnId === interruptedTurnId) {
-          promptAdmission.cancelled = true;
-          if (promptAdmission.promptFiber) {
-            yield* Fiber.interrupt(promptAdmission.promptFiber);
-          }
-          yield* Deferred.await(promptAdmission.submissionSettled);
-        }
-
-        const abortOutcome = yield* Effect.raceFirst(
-          runOpenCodeSdk("session.abort", (signal) =>
-            context.client.session.abort({ sessionID: context.openCodeSessionId }, { signal }),
-          ).pipe(
-            Effect.timeout("10 seconds"),
-            Effect.catchTags({
-              OpenCodeRuntimeError: (cause) => Effect.fail(toRequestError(cause)),
-              TimeoutError: (cause) =>
-                Effect.fail(
-                  new ProviderAdapterRequestError({
-                    provider: PROVIDER,
-                    method: "session.abort",
-                    detail: "OpenCode session abort did not complete within 10 seconds.",
-                    cause,
-                  }),
-                ),
-            }),
-            Effect.exit,
-            Effect.map((exit) => ({ source: "request" as const, exit })),
-          ),
-          Deferred.await(cancellation.completion).pipe(
-            Effect.exit,
-            Effect.map((exit) => ({ source: "event" as const, exit })),
-          ),
-        );
-        if (abortOutcome.source === "event") {
-          return Exit.isFailure(abortOutcome.exit)
-            ? yield* Effect.failCause(abortOutcome.exit.cause)
-            : undefined;
-        }
-        const abortExit = abortOutcome.exit;
-        if (Exit.isFailure(abortExit)) {
-          if (interruptedTurnId && context.interruptedTurnId === interruptedTurnId) {
-            yield* Deferred.succeed(cancellation.completion, undefined).pipe(Effect.ignore);
-            return;
-          }
-          if (cancellation.turnId === undefined && cancellation.acknowledged) {
-            if (context.cancellation === cancellation) {
-              context.cancellation = undefined;
-              context.reconcileIdleStatus = true;
-            }
-            yield* Deferred.succeed(cancellation.completion, undefined).pipe(Effect.ignore);
-            return;
-          }
-          if (context.cancellation === cancellation) {
-            context.cancellation = undefined;
-            if (cancellation.turnId !== undefined && cancellation.deferredIdleEvent) {
-              yield* scheduleIdleReconciliation(
-                context,
-                cancellation.turnId,
-                cancellation.deferredIdleEvent,
-              );
-            }
-          }
-          yield* Deferred.done(cancellation.completion, abortExit).pipe(Effect.ignore);
-          return yield* Effect.failCause(abortExit.cause);
-        }
-
-        if (context.cancellation === cancellation) {
-          if (cancellation.turnId !== undefined) {
-            yield* interruptOpenCodeTurn(context, cancellation.turnId);
-          } else {
-            context.cancellation = undefined;
-            context.reconcileIdleStatus = true;
-          }
-        }
-        yield* Deferred.succeed(cancellation.completion, undefined).pipe(Effect.ignore);
-      },
-    );
-
-    const respondToRequest: OpenCodeAdapterShape["respondToRequest"] = Effect.fn(
-      "respondToRequest",
-    )(function* (threadId, requestId, decision) {
-      const context = yield* ensureSessionContext(sessions, threadId);
-      if (!context.pendingPermissions.has(requestId)) {
-        return yield* new ProviderAdapterRequestError({
-          provider: PROVIDER,
-          method: "permission.reply",
-          detail: `Unknown pending permission request: ${requestId}`,
-        });
-      }
-
-      yield* runOpenCodeSdk("permission.reply", () =>
-        context.client.permission.reply({
-          requestID: requestId,
-          reply: toOpenCodePermissionReply(decision),
-        }),
-      ).pipe(Effect.mapError(toRequestError));
-    });
-
-    const respondToUserInput: OpenCodeAdapterShape["respondToUserInput"] = Effect.fn(
-      "respondToUserInput",
-    )(function* (threadId, requestId, answers) {
-      const context = yield* ensureSessionContext(sessions, threadId);
-      const request = context.pendingQuestions.get(requestId);
-      if (!request) {
-        return yield* new ProviderAdapterRequestError({
-          provider: PROVIDER,
-          method: "question.reply",
-          detail: `Unknown pending user-input request: ${requestId}`,
-        });
-      }
-
-      yield* runOpenCodeSdk("question.reply", () =>
-        context.client.question.reply({
-          requestID: requestId,
-          answers: toOpenCodeQuestionAnswers(request, answers),
-        }),
-      ).pipe(Effect.mapError(toRequestError));
-    });
-
-    const stopSession: OpenCodeAdapterShape["stopSession"] = Effect.fn("stopSession")(
-      function* (threadId) {
-        const context = sessions.get(threadId);
-        if (!context) {
-          return yield* new ProviderAdapterSessionNotFoundError({
-            provider: PROVIDER,
-            threadId,
-          });
-        }
-        const stopped = yield* stopOpenCodeContext(context);
-        deleteContextIfCurrent(context);
-        if (!stopped) {
-          return;
-        }
-        yield* emit({
-          ...(yield* buildEventBase({ threadId })),
-          type: "session.exited",
-          payload: {
-            reason: "Session stopped.",
-            recoverable: false,
-            exitKind: "graceful",
-          },
-        });
-      },
-    );
-
-    const listSessions: OpenCodeAdapterShape["listSessions"] = () =>
-      Effect.sync(() => [...sessions.values()].map((context) => context.session));
-
-    const hasSession: OpenCodeAdapterShape["hasSession"] = (threadId) =>
-      Effect.sync(() => sessions.has(threadId));
-
-    const readThread: OpenCodeAdapterShape["readThread"] = Effect.fn("readThread")(
-      function* (threadId) {
-        const context = yield* ensureSessionContext(sessions, threadId);
-        const messages = yield* runOpenCodeSdk("session.messages", () =>
-          context.client.session.messages({
-            sessionID: context.openCodeSessionId,
-          }),
-        ).pipe(Effect.mapError(toRequestError));
-
-        const turns: Array<OpenCodeTurnSnapshot> = [];
-        for (const entry of messages.data ?? []) {
-          if (entry.info.role === "assistant") {
-            turns.push({
-              id: TurnId.make(entry.info.id),
-              items: [entry.info, ...entry.parts],
-            });
-          }
-        }
-
-        return {
-          threadId,
-          turns,
-        };
-      },
-    );
-
-    const rollbackThread: OpenCodeAdapterShape["rollbackThread"] = Effect.fn("rollbackThread")(
-      function* (threadId, numTurns) {
-        const context = yield* ensureSessionContext(sessions, threadId);
-        const messages = yield* runOpenCodeSdk("session.messages", () =>
-          context.client.session.messages({
-            sessionID: context.openCodeSessionId,
-          }),
-        ).pipe(Effect.mapError(toRequestError));
-
-        const assistantMessages = (messages.data ?? []).filter(
-          (entry) => entry.info.role === "assistant",
-        );
-        const targetIndex = assistantMessages.length - numTurns - 1;
-        const target = targetIndex >= 0 ? assistantMessages[targetIndex] : null;
-        yield* runOpenCodeSdk("session.revert", () =>
-          context.client.session.revert({
-            sessionID: context.openCodeSessionId,
-            ...(target ? { messageID: target.info.id } : {}),
-          }),
-        ).pipe(Effect.mapError(toRequestError));
-
-        return yield* readThread(threadId);
-      },
-    );
-
-    const stopAll: OpenCodeAdapterShape["stopAll"] = () =>
-      Effect.gen(function* () {
-        const contexts = [...sessions.values()];
-        sessions.clear();
-        // `stopOpenCodeContext` is typed as never-failing — SDK aborts are
-        // already `Effect.ignore`'d inside it. `ignoreCause` here also
-        // swallows defects from throwing finalizers so one bad close can't
-        // interrupt the sibling fibers. Same pattern as the layer finalizer.
-        yield* Effect.forEach(
-          contexts,
-          (context) => Effect.ignoreCause(stopOpenCodeContext(context)),
-          { concurrency: "unbounded", discard: true },
-        );
-      });
-
-    return {
-      provider: PROVIDER,
-      capabilities: {
-        sessionModelSwitch: "in-session",
-      },
-      startSession,
-      sendTurn,
-      interruptTurn,
-      respondToRequest,
-      respondToUserInput,
-      stopSession,
-      listSessions,
-      hasSession,
-      readThread,
-      rollbackThread,
-      stopAll,
-      get streamEvents() {
-        return Stream.fromQueue(runtimeEvents);
-      },
-    } satisfies OpenCodeAdapterShape;
-  });
-}
diff --git a/apps/server/src/provider/Layers/ProviderAdapterRegistry.test.ts b/apps/server/src/provider/Layers/ProviderAdapterRegistry.test.ts
deleted file mode 100644
index 280601275a7e..000000000000
--- a/apps/server/src/provider/Layers/ProviderAdapterRegistry.test.ts
+++ /dev/null
@@ -1,196 +0,0 @@
-import {
-  defaultInstanceIdForDriver,
-  ProviderDriverKind,
-  type ServerProvider,
-} from "@t3tools/contracts";
-import { it, assert, vi } from "@effect/vitest";
-
-import * as Effect from "effect/Effect";
-import * as Layer from "effect/Layer";
-import * as PubSub from "effect/PubSub";
-import * as Stream from "effect/Stream";
-
-import type * as ClaudeAdapter from "../Services/ClaudeAdapter.ts";
-import type * as CodexAdapter from "../Services/CodexAdapter.ts";
-import type * as CursorAdapter from "../Services/CursorAdapter.ts";
-import type * as OpenCodeAdapter from "../Services/OpenCodeAdapter.ts";
-import * as ProviderAdapterRegistry from "../Services/ProviderAdapterRegistry.ts";
-import * as ProviderInstanceRegistry from "../Services/ProviderInstanceRegistry.ts";
-import type { ProviderInstance } from "../ProviderDriver.ts";
-import { makeManualOnlyProviderMaintenanceCapabilities } from "../providerMaintenance.ts";
-import type * as TextGeneration from "../../textGeneration/TextGeneration.ts";
-import * as ProviderAdapterRegistryLayer from "./ProviderAdapterRegistry.ts";
-import * as NodeServices from "@effect/platform-node/NodeServices";
-
-const CODEX_DRIVER = ProviderDriverKind.make("codex");
-const CLAUDE_AGENT_DRIVER = ProviderDriverKind.make("claudeAgent");
-const OPENCODE_DRIVER = ProviderDriverKind.make("opencode");
-const CURSOR_DRIVER = ProviderDriverKind.make("cursor");
-
-const fakeCodexAdapter: CodexAdapter.CodexAdapterShape = {
-  provider: CODEX_DRIVER,
-  capabilities: { sessionModelSwitch: "in-session" },
-  startSession: vi.fn(),
-  sendTurn: vi.fn(),
-  interruptTurn: vi.fn(),
-  respondToRequest: vi.fn(),
-  respondToUserInput: vi.fn(),
-  stopSession: vi.fn(),
-  listSessions: vi.fn(),
-  hasSession: vi.fn(),
-  readThread: vi.fn(),
-  rollbackThread: vi.fn(),
-  uploadFeedback: vi.fn(),
-  stopAll: vi.fn(),
-  streamEvents: Stream.empty,
-};
-
-const fakeClaudeAdapter: ClaudeAdapter.ClaudeAdapterShape = {
-  provider: CLAUDE_AGENT_DRIVER,
-  capabilities: { sessionModelSwitch: "in-session" },
-  startSession: vi.fn(),
-  sendTurn: vi.fn(),
-  interruptTurn: vi.fn(),
-  respondToRequest: vi.fn(),
-  respondToUserInput: vi.fn(),
-  stopSession: vi.fn(),
-  listSessions: vi.fn(),
-  hasSession: vi.fn(),
-  readThread: vi.fn(),
-  rollbackThread: vi.fn(),
-  stopAll: vi.fn(),
-  streamEvents: Stream.empty,
-};
-
-const fakeOpenCodeAdapter: OpenCodeAdapter.OpenCodeAdapterShape = {
-  provider: OPENCODE_DRIVER,
-  capabilities: { sessionModelSwitch: "in-session" },
-  startSession: vi.fn(),
-  sendTurn: vi.fn(),
-  interruptTurn: vi.fn(),
-  respondToRequest: vi.fn(),
-  respondToUserInput: vi.fn(),
-  stopSession: vi.fn(),
-  listSessions: vi.fn(),
-  hasSession: vi.fn(),
-  readThread: vi.fn(),
-  rollbackThread: vi.fn(),
-  stopAll: vi.fn(),
-  streamEvents: Stream.empty,
-};
-
-const fakeCursorAdapter: CursorAdapter.CursorAdapterShape = {
-  provider: CURSOR_DRIVER,
-  capabilities: { sessionModelSwitch: "in-session" },
-  startSession: vi.fn(),
-  sendTurn: vi.fn(),
-  interruptTurn: vi.fn(),
-  respondToRequest: vi.fn(),
-  respondToUserInput: vi.fn(),
-  stopSession: vi.fn(),
-  listSessions: vi.fn(),
-  hasSession: vi.fn(),
-  readThread: vi.fn(),
-  rollbackThread: vi.fn(),
-  stopAll: vi.fn(),
-  streamEvents: Stream.empty,
-};
-
-// ProviderAdapterRegistryLive is now a facade over ProviderInstanceRegistry —
-// it walks `listInstances` once at boot and surfaces the default-instance
-// adapter keyed by its driver kind. To test the facade we supply four fake
-// instances whose `instanceId === defaultInstanceIdForDriver(driverKind)` so
-// they pass the default-instance filter.
-const makeFakeInstance = (
-  driverKindString: "codex" | "claudeAgent" | "cursor" | "opencode",
-  adapter: ProviderInstance["adapter"],
-): ProviderInstance => {
-  const driverKind = ProviderDriverKind.make(driverKindString);
-  return {
-    instanceId: defaultInstanceIdForDriver(driverKind),
-    driverKind,
-    continuationIdentity: {
-      driverKind,
-      continuationKey: `${driverKind}:instance:${defaultInstanceIdForDriver(driverKind)}`,
-    },
-    displayName: undefined,
-    enabled: true,
-    snapshot: {
-      maintenanceCapabilities: makeManualOnlyProviderMaintenanceCapabilities({
-        provider: driverKind,
-        packageName: null,
-      }),
-      getSnapshot: Effect.succeed({} as unknown as ServerProvider),
-      refresh: Effect.succeed({} as unknown as ServerProvider),
-      streamChanges: Stream.empty,
-    },
-    adapter,
-    textGeneration: {} as unknown as TextGeneration.TextGeneration["Service"],
-  };
-};
-
-const fakeInstances: ReadonlyArray<ProviderInstance> = [
-  makeFakeInstance("codex", fakeCodexAdapter),
-  makeFakeInstance("claudeAgent", fakeClaudeAdapter),
-  makeFakeInstance("opencode", fakeOpenCodeAdapter),
-  makeFakeInstance("cursor", fakeCursorAdapter),
-];
-
-const fakeInstanceRegistryLayer = Layer.succeed(ProviderInstanceRegistry.ProviderInstanceRegistry, {
-  getInstance: (instanceId) =>
-    Effect.succeed(fakeInstances.find((instance) => instance.instanceId === instanceId)),
-  listInstances: Effect.succeed(fakeInstances),
-  listUnavailable: Effect.succeed([]),
-  streamChanges: Stream.empty,
-  // Tests never drive changes through this fake; acquire a throwaway
-  // subscription on an unused PubSub so the shape is satisfied.
-  subscribeChanges: Effect.flatMap(PubSub.unbounded<void>(), (pubsub) => PubSub.subscribe(pubsub)),
-});
-
-const layer = Layer.mergeAll(
-  Layer.provide(
-    ProviderAdapterRegistryLayer.ProviderAdapterRegistryLive,
-    fakeInstanceRegistryLayer,
-  ),
-  NodeServices.layer,
-);
-
-it.layer(layer)("ProviderAdapterRegistryLive", (it) => {
-  it("resolves adapters and routing metadata from provider instances", () =>
-    Effect.gen(function* () {
-      const registry = yield* ProviderAdapterRegistry.ProviderAdapterRegistry;
-      const claudeInstanceId = defaultInstanceIdForDriver(CLAUDE_AGENT_DRIVER);
-
-      const adapter = yield* registry.getByInstance(claudeInstanceId);
-      assert.strictEqual(adapter, fakeClaudeAdapter);
-
-      const info = yield* registry.getInstanceInfo(claudeInstanceId);
-      assert.deepStrictEqual(info, {
-        instanceId: claudeInstanceId,
-        driverKind: CLAUDE_AGENT_DRIVER,
-        displayName: undefined,
-        accentColor: undefined,
-        enabled: true,
-        continuationIdentity: {
-          driverKind: CLAUDE_AGENT_DRIVER,
-          continuationKey: "claudeAgent:instance:claudeAgent",
-        },
-      });
-
-      const instances = yield* registry.listInstances();
-      assert.deepStrictEqual(instances, [
-        defaultInstanceIdForDriver(CODEX_DRIVER),
-        claudeInstanceId,
-        defaultInstanceIdForDriver(OPENCODE_DRIVER),
-        defaultInstanceIdForDriver(CURSOR_DRIVER),
-      ]);
-
-      const providers = yield* registry.listProviders();
-      assert.deepStrictEqual(providers, [
-        CODEX_DRIVER,
-        CLAUDE_AGENT_DRIVER,
-        OPENCODE_DRIVER,
-        CURSOR_DRIVER,
-      ]);
-    }));
-});
diff --git a/apps/server/src/provider/Layers/ProviderAdapterRegistry.ts b/apps/server/src/provider/Layers/ProviderAdapterRegistry.ts
deleted file mode 100644
index b492399b10b1..000000000000
--- a/apps/server/src/provider/Layers/ProviderAdapterRegistry.ts
+++ /dev/null
@@ -1,117 +0,0 @@
-/**
- * ProviderAdapterRegistryLive — facade over `ProviderInstanceRegistry`.
- *
- * `ProviderAdapterRegistry` historically mapped one `ProviderDriverKind` to one
- * adapter via the four `<X>AdapterLive` singleton Layers. The per-instance
- * refactor moved adapter construction inside each `ProviderDriver.create()`:
- * adapters are now bundled on the `ProviderInstance` that the
- * `ProviderInstanceRegistry` owns.
- *
- * This facade fulfills the `ProviderAdapterRegistryShape` contract by doing
- * dynamic look-ups against `ProviderInstanceRegistry` on every call. That
- * means settings-driven hot-reload shows up here automatically — adding a
- * new instance via settings makes `getByInstance` resolve immediately
- * without rebuilding the facade.
- *
- * @module ProviderAdapterRegistryLive
- */
-import {
-  defaultInstanceIdForDriver,
-  ProviderInstanceId,
-  type ProviderDriverKind,
-} from "@t3tools/contracts";
-import * as Effect from "effect/Effect";
-import * as Layer from "effect/Layer";
-
-import { ProviderUnsupportedError } from "../Errors.ts";
-import { ProviderInstanceRegistry } from "../Services/ProviderInstanceRegistry.ts";
-import {
-  ProviderAdapterRegistry,
-  type ProviderAdapterRegistryShape,
-} from "../Services/ProviderAdapterRegistry.ts";
-
-const makeProviderAdapterRegistry = Effect.fn("makeProviderAdapterRegistry")(function* () {
-  const registry = yield* ProviderInstanceRegistry;
-
-  const getByInstance: ProviderAdapterRegistryShape["getByInstance"] = (instanceId) =>
-    registry.getInstance(instanceId).pipe(
-      Effect.flatMap((instance) =>
-        instance === undefined
-          ? Effect.fail(
-              new ProviderUnsupportedError({
-                provider: instanceId,
-              }),
-            )
-          : Effect.succeed(instance.adapter),
-      ),
-    );
-
-  const getInstanceInfo: ProviderAdapterRegistryShape["getInstanceInfo"] = (instanceId) =>
-    registry.getInstance(instanceId).pipe(
-      Effect.flatMap((instance) =>
-        instance === undefined
-          ? Effect.fail(
-              new ProviderUnsupportedError({
-                provider: instanceId,
-              }),
-            )
-          : Effect.succeed({
-              instanceId: instance.instanceId,
-              driverKind: instance.driverKind,
-              displayName: instance.displayName,
-              accentColor: instance.accentColor,
-              enabled: instance.enabled,
-              continuationIdentity: instance.continuationIdentity,
-            }),
-      ),
-    );
-
-  const listInstances: ProviderAdapterRegistryShape["listInstances"] = () =>
-    registry.listInstances.pipe(
-      Effect.map((instances) => instances.map((instance) => instance.instanceId)),
-    );
-
-  const listProviders: ProviderAdapterRegistryShape["listProviders"] = () =>
-    registry.listInstances.pipe(
-      Effect.map((instances) => {
-        const kinds = new Set<ProviderDriverKind>();
-        for (const instance of instances) {
-          const defaultId = defaultInstanceIdForDriver(instance.driverKind);
-          if (instance.instanceId === defaultId) {
-            // Only the default-instance rows show up through the legacy
-            // shim — custom instances like `codex_personal` have no
-            // `ProviderDriverKind` equivalent.
-            kinds.add(instance.driverKind);
-          }
-        }
-        return Array.from(kinds);
-      }),
-    );
-
-  return {
-    getByInstance,
-    getInstanceInfo,
-    listInstances,
-    listProviders,
-    // Proxy directly — the facade has no state of its own; the instance
-    // registry already coalesces adds/removes/rebuilds into one emission.
-    streamChanges: registry.streamChanges,
-    subscribeChanges: registry.subscribeChanges,
-  } satisfies ProviderAdapterRegistryShape;
-});
-
-export const ProviderAdapterRegistryLive = Layer.effect(
-  ProviderAdapterRegistry,
-  makeProviderAdapterRegistry(),
-);
-
-// Exposed for tests that want to build a facade over a pre-assembled
-// `ProviderInstanceRegistry` without pulling in the whole boot graph.
-export { makeProviderAdapterRegistry };
-
-// Re-export for consumers that need the accessor shape. The service tag
-// itself lives in `Services/ProviderAdapterRegistry.ts`.
-export { ProviderAdapterRegistry } from "../Services/ProviderAdapterRegistry.ts";
-// Re-export for consumers (including tests) that construct a
-// `ProviderInstanceId` before calling `getByInstance`.
-export { ProviderInstanceId };
diff --git a/apps/server/src/provider/Layers/ProviderInstanceRegistryHydration.ts b/apps/server/src/provider/Layers/ProviderInstanceRegistryHydration.ts
index 0fd88b4262a6..0b28cd1bbe36 100644
--- a/apps/server/src/provider/Layers/ProviderInstanceRegistryHydration.ts
+++ b/apps/server/src/provider/Layers/ProviderInstanceRegistryHydration.ts
@@ -56,6 +56,14 @@ import { BUILT_IN_DRIVERS, type BuiltInDriversEnv } from "../builtInDrivers.ts";
 import { ProviderInstanceRegistry } from "../Services/ProviderInstanceRegistry.ts";
 import { ProviderInstanceRegistryMutator } from "../Services/ProviderInstanceRegistryMutator.ts";
 import { ProviderInstanceRegistryMutableLayer } from "./ProviderInstanceRegistryLive.ts";
+import {
+  type ProviderOrchestrationAdapterInfrastructure,
+  ProviderOrchestrationAdapterInfrastructureLive,
+} from "./ProviderOrchestrationAdapterInfrastructure.ts";
+
+type ProviderInstanceRegistryHydrationEnv =
+  | Exclude<BuiltInDriversEnv, ProviderOrchestrationAdapterInfrastructure>
+  | ServerSettingsService;
 
 /**
  * Synthesize a `ProviderInstanceConfigMap` from a `ServerSettings` snapshot.
@@ -152,7 +160,7 @@ const SettingsWatcherLive = Layer.effectDiscard(
 export const ProviderInstanceRegistryHydrationLive: Layer.Layer<
   ProviderInstanceRegistry,
   never,
-  BuiltInDriversEnv | ServerSettingsService
+  ProviderInstanceRegistryHydrationEnv
 > = Layer.unwrap(
   Effect.gen(function* () {
     const serverSettings = yield* ServerSettingsService;
@@ -167,8 +175,8 @@ export const ProviderInstanceRegistryHydrationLive: Layer.Layer<
     const mutableLayer = ProviderInstanceRegistryMutableLayer({
       drivers: BUILT_IN_DRIVERS,
       configMap: initialConfigMap,
-    });
+    }).pipe(Layer.provide(ProviderOrchestrationAdapterInfrastructureLive));
 
     return SettingsWatcherLive.pipe(Layer.provideMerge(mutableLayer));
   }),
-) as Layer.Layer<ProviderInstanceRegistry, never, BuiltInDriversEnv | ServerSettingsService>;
+) as Layer.Layer<ProviderInstanceRegistry, never, ProviderInstanceRegistryHydrationEnv>;
diff --git a/apps/server/src/provider/Layers/ProviderInstanceRegistryLive.test.ts b/apps/server/src/provider/Layers/ProviderInstanceRegistryLive.test.ts
index 524b35d5d3f8..8c8d8e23c5fa 100644
--- a/apps/server/src/provider/Layers/ProviderInstanceRegistryLive.test.ts
+++ b/apps/server/src/provider/Layers/ProviderInstanceRegistryLive.test.ts
@@ -45,7 +45,7 @@ import type { BuiltInDriversEnv } from "../builtInDrivers.ts";
 import { ServerConfig } from "../../config.ts";
 import { ServerSettingsService } from "../../serverSettings.ts";
 import { ClaudeDriver } from "../Drivers/ClaudeDriver.ts";
-import { CodexDriver } from "../Drivers/CodexDriver.ts";
+import { CodexDriver, type CodexDriverEnv } from "../Drivers/CodexDriver.ts";
 import { CursorDriver } from "../Drivers/CursorDriver.ts";
 import { GrokDriver } from "../Drivers/GrokDriver.ts";
 import { OpenCodeDriver } from "../Drivers/OpenCodeDriver.ts";
@@ -53,6 +53,7 @@ import * as ModelManifest from "../ModelManifest.ts";
 import { OpenCodeRuntimeLive } from "../opencodeRuntime.ts";
 import { NoOpProviderEventLoggers, ProviderEventLoggers } from "./ProviderEventLoggers.ts";
 import { makeProviderInstanceRegistry } from "./ProviderInstanceRegistryLive.ts";
+import { ProviderOrchestrationAdapterInfrastructureLive } from "./ProviderOrchestrationAdapterInfrastructure.ts";
 
 const TestHttpClientLive = Layer.succeed(
   HttpClient.HttpClient,
@@ -114,8 +115,6 @@ const makeClaudeConfig = (overrides: Partial<ClaudeSettings>): ClaudeSettings =>
 
 const makeCursorConfig = (overrides: Partial<CursorSettings>): CursorSettings => ({
   enabled: false,
-  binaryPath: "cursor-agent",
-  apiEndpoint: "",
   customModels: [],
   ...overrides,
 });
@@ -142,16 +141,20 @@ describe("ProviderInstanceRegistryLive — multi-instance codex slice", () => {
   // `NodeServices.layer` through `Layer.provideMerge` to satisfy that
   // dependency while still surfacing NodeServices to the test body (the
   // codex driver's `create` yields `ChildProcessSpawner` directly).
-  const testLayer = ServerConfig.layerTest(process.cwd(), {
+  const baseLayer = ServerConfig.layerTest(process.cwd(), {
     prefix: "provider-instance-registry-test",
   }).pipe(
     Layer.provideMerge(NodeServices.layer),
     Layer.provideMerge(BackgroundPolicyAlwaysRunLayer),
     Layer.provideMerge(ServerSettingsService.layerTest()),
     Layer.provideMerge(TestHttpClientLive),
+    Layer.provideMerge(ServerSettingsService.layerTest()),
     Layer.provideMerge(Layer.succeed(ProviderEventLoggers, NoOpProviderEventLoggers)),
     Layer.provideMerge(ModelManifest.layerTest),
   );
+  const testLayer = ProviderOrchestrationAdapterInfrastructureLive.pipe(
+    Layer.provideMerge(baseLayer),
+  );
 
   it.live("boots two independent codex instances from a ProviderInstanceConfigMap", () =>
     Effect.gen(function* () {
@@ -182,7 +185,7 @@ describe("ProviderInstanceRegistryLive — multi-instance codex slice", () => {
         },
       };
 
-      const { registry } = yield* makeProviderInstanceRegistry({
+      const { registry } = yield* makeProviderInstanceRegistry<CodexDriverEnv>({
         drivers: [CodexDriver],
         configMap,
       });
@@ -201,7 +204,7 @@ describe("ProviderInstanceRegistryLive — multi-instance codex slice", () => {
       const work = yield* registry.getInstance(workId);
       expect(personal).toBeDefined();
       expect(work).toBeDefined();
-      expect(personal!.adapter).not.toBe(work!.adapter);
+      expect(personal!.orchestrationAdapter).not.toBe(work!.orchestrationAdapter);
       expect(personal!.textGeneration).not.toBe(work!.textGeneration);
       expect(personal!.snapshot).not.toBe(work!.snapshot);
 
@@ -274,7 +277,7 @@ describe("ProviderInstanceRegistryLive — multi-instance codex slice", () => {
           },
         };
 
-        const { registry } = yield* makeProviderInstanceRegistry({
+        const { registry } = yield* makeProviderInstanceRegistry<CodexDriverEnv>({
           drivers: [CodexDriver],
           configMap,
         });
@@ -308,16 +311,20 @@ describe("ProviderInstanceRegistryLive — all drivers slice", () => {
   // surfaced; that merged layer then provides `ServerConfig.layerTest`'s
   // `FileSystem` dep while keeping everything else surfaced to the test.
   const infraLayer = OpenCodeRuntimeLive.pipe(Layer.provideMerge(NodeServices.layer));
-  const testLayer = ServerConfig.layerTest(process.cwd(), {
+  const baseLayer = ServerConfig.layerTest(process.cwd(), {
     prefix: "provider-instance-registry-all-drivers-test",
   }).pipe(
     Layer.provideMerge(infraLayer),
     Layer.provideMerge(BackgroundPolicyAlwaysRunLayer),
     Layer.provideMerge(ServerSettingsService.layerTest()),
     Layer.provideMerge(TestHttpClientLive),
+    Layer.provideMerge(ServerSettingsService.layerTest()),
     Layer.provideMerge(Layer.succeed(ProviderEventLoggers, NoOpProviderEventLoggers)),
     Layer.provideMerge(ModelManifest.layerTest),
   );
+  const testLayer = ProviderOrchestrationAdapterInfrastructureLive.pipe(
+    Layer.provideMerge(baseLayer),
+  );
 
   it.live("boots one instance of every shipped driver from a single config map", () =>
     Effect.gen(function* () {
@@ -405,16 +412,16 @@ describe("ProviderInstanceRegistryLive — all drivers slice", () => {
       expect(openCode?.displayName).toBe("OpenCode");
 
       // Every instance owns its own set of closures — no sharing across
-      // drivers. `adapter` / `textGeneration` / `snapshot` are all
+      // drivers. `orchestrationAdapter` / `textGeneration` / `snapshot` are all
       // distinct references even when two instances happen to share a
       // trait (e.g. Cursor + others all use a stub-or-real
       // `textGeneration`; they must still be different object values).
       const adapters = [
-        codex!.adapter,
-        claude!.adapter,
-        cursor!.adapter,
-        grok!.adapter,
-        openCode!.adapter,
+        codex!.orchestrationAdapter,
+        claude!.orchestrationAdapter,
+        cursor!.orchestrationAdapter,
+        grok!.orchestrationAdapter,
+        openCode!.orchestrationAdapter,
       ];
       expect(new Set(adapters).size).toBe(adapters.length);
       const textGenerations = [
diff --git a/apps/server/src/provider/Layers/ProviderOrchestrationAdapterInfrastructure.ts b/apps/server/src/provider/Layers/ProviderOrchestrationAdapterInfrastructure.ts
new file mode 100644
index 000000000000..747654fe39f6
--- /dev/null
+++ b/apps/server/src/provider/Layers/ProviderOrchestrationAdapterInfrastructure.ts
@@ -0,0 +1,36 @@
+import * as Layer from "effect/Layer";
+
+import {
+  ClaudeAgentSdkQueryRunner,
+  claudeAgentSdkQueryRunnerLiveLayer,
+} from "../../orchestration-v2/Adapters/ClaudeAdapterV2.ts";
+import {
+  CodexAppServerClientFactory,
+  codexAppServerClientFactoryFromSettingsLayer,
+} from "../../orchestration-v2/Adapters/CodexAdapterV2.ts";
+import {
+  CursorAgentSdkRunner,
+  cursorAgentSdkRunnerLiveLayer,
+} from "../../orchestration-v2/Adapters/CursorAgentSdk.ts";
+import { IdAllocatorV2, layer as idAllocatorLayer } from "../../orchestration-v2/IdAllocator.ts";
+import { layer as providerContinuationRequestsLayer } from "../../orchestration-v2/ProviderContinuationRequests.ts";
+
+export type ProviderOrchestrationAdapterInfrastructure =
+  | ClaudeAgentSdkQueryRunner
+  | CodexAppServerClientFactory
+  | CursorAgentSdkRunner
+  | IdAllocatorV2;
+
+/**
+ * Infrastructure shared by the V2 adapters materialized inside provider
+ * instances. `providerContinuationRequestsLayer` must be the same layer
+ * reference the orchestration runtime provides to its continuation worker so
+ * Effect layer memoization yields one shared queue.
+ */
+export const ProviderOrchestrationAdapterInfrastructureLive = Layer.mergeAll(
+  claudeAgentSdkQueryRunnerLiveLayer,
+  codexAppServerClientFactoryFromSettingsLayer,
+  cursorAgentSdkRunnerLiveLayer,
+  idAllocatorLayer,
+  providerContinuationRequestsLayer,
+);
diff --git a/apps/server/src/provider/Layers/ProviderRegistry.test.ts b/apps/server/src/provider/Layers/ProviderRegistry.test.ts
index fb336e61b21c..1bcb53b478c4 100644
--- a/apps/server/src/provider/Layers/ProviderRegistry.test.ts
+++ b/apps/server/src/provider/Layers/ProviderRegistry.test.ts
@@ -41,7 +41,9 @@ import { ProviderInstanceRegistryHydrationLive } from "./ProviderInstanceRegistr
 import {
   haveProvidersChanged,
   mergeProviderSnapshot,
+  mergeProviderSnapshots,
   ProviderRegistryLive,
+  selectProvidersByKind,
 } from "./ProviderRegistry.ts";
 import * as ServerConfig from "../../config.ts";
 import * as ServerSettingsModule from "../../serverSettings.ts";
@@ -910,7 +912,7 @@ it.layer(Layer.mergeAll(NodeServices.layer, ServerSettingsModule.layerTest(), Te
               ),
               streamChanges: Stream.empty,
             },
-            adapter: {} as ProviderInstance["adapter"],
+            orchestrationAdapter: {} as ProviderInstance["orchestrationAdapter"],
             textGeneration: {} as ProviderInstance["textGeneration"],
           } satisfies ProviderInstance;
           const instanceRegistryLayer = Layer.succeed(
@@ -1031,7 +1033,7 @@ it.layer(Layer.mergeAll(NodeServices.layer, ServerSettingsModule.layerTest(), Te
                 ),
                 streamChanges: Stream.empty,
               },
-              adapter: {} as ProviderInstance["adapter"],
+              orchestrationAdapter: {} as ProviderInstance["orchestrationAdapter"],
               textGeneration: {} as ProviderInstance["textGeneration"],
             },
             {
@@ -1054,7 +1056,7 @@ it.layer(Layer.mergeAll(NodeServices.layer, ServerSettingsModule.layerTest(), Te
                 ),
                 streamChanges: Stream.empty,
               },
-              adapter: {} as ProviderInstance["adapter"],
+              orchestrationAdapter: {} as ProviderInstance["orchestrationAdapter"],
               textGeneration: {} as ProviderInstance["textGeneration"],
             },
           ] satisfies ReadonlyArray<ProviderInstance>;
@@ -1121,6 +1123,70 @@ it.layer(Layer.mergeAll(NodeServices.layer, ServerSettingsModule.layerTest(), Te
         }),
       );
 
+      it("persists merged provider snapshots for the providers that were refreshed", () => {
+        const previousProviders = [
+          {
+            instanceId: ProviderInstanceId.make("cursor"),
+            driver: ProviderDriverKind.make("cursor"),
+            status: "ready",
+            enabled: true,
+            installed: true,
+            auth: { status: "authenticated" },
+            checkedAt: "2026-04-14T00:00:00.000Z",
+            version: "2026.04.09-f2b0fcd",
+            models: [
+              {
+                slug: "claude-opus-4-6",
+                name: "Opus 4.6",
+                isCustom: false,
+                capabilities: createModelCapabilities({
+                  optionDescriptors: [
+                    selectDescriptor("reasoning", "Reasoning", [
+                      { id: "high", label: "High", isDefault: true },
+                    ]),
+                    booleanDescriptor("fastMode", "Fast Mode"),
+                    booleanDescriptor("thinking", "Thinking"),
+                  ],
+                }),
+              },
+            ],
+            slashCommands: [],
+            skills: [],
+          },
+          {
+            instanceId: ProviderInstanceId.make("codex"),
+            driver: ProviderDriverKind.make("codex"),
+            status: "ready",
+            enabled: true,
+            installed: true,
+            auth: { status: "authenticated" },
+            checkedAt: "2026-04-14T00:00:00.000Z",
+            version: "1.0.0",
+            models: [],
+            slashCommands: [],
+            skills: [],
+          },
+        ] as const satisfies ReadonlyArray<ServerProvider>;
+        const refreshedCursor = {
+          ...previousProviders[0],
+          checkedAt: "2026-04-14T00:01:00.000Z",
+          models: [],
+        } satisfies ServerProvider;
+
+        const mergedProviders = mergeProviderSnapshots(previousProviders, [refreshedCursor]);
+        const persistedProviders = selectProvidersByKind(
+          mergedProviders,
+          new Set([ProviderDriverKind.make("cursor")]),
+        );
+
+        assert.deepStrictEqual(persistedProviders, [
+          {
+            ...refreshedCursor,
+            models: [...previousProviders[0].models],
+          },
+        ]);
+      });
+
       it.effect("persists the merged snapshot when a live update has empty models", () =>
         Effect.gen(function* () {
           const cursorDriver = ProviderDriverKind.make("cursor");
@@ -1175,7 +1241,7 @@ it.layer(Layer.mergeAll(NodeServices.layer, ServerSettingsModule.layerTest(), Te
               refresh: Effect.succeed(refreshedProvider),
               streamChanges: Stream.fromPubSub(changes),
             },
-            adapter: {} as ProviderInstance["adapter"],
+            orchestrationAdapter: {} as ProviderInstance["orchestrationAdapter"],
             textGeneration: {} as ProviderInstance["textGeneration"],
           } satisfies ProviderInstance;
           const instanceRegistryLayer = Layer.succeed(
@@ -1304,7 +1370,7 @@ it.layer(Layer.mergeAll(NodeServices.layer, ServerSettingsModule.layerTest(), Te
                 refresh: Effect.succeed(authoritativeProvider),
                 streamChanges: Stream.fromPubSub(changes),
               },
-              adapter: {} as ProviderInstance["adapter"],
+              orchestrationAdapter: {} as ProviderInstance["orchestrationAdapter"],
               textGeneration: {} as ProviderInstance["textGeneration"],
             } satisfies ProviderInstance;
             const instanceRegistryLayer = Layer.succeed(
@@ -1411,7 +1477,7 @@ it.layer(Layer.mergeAll(NodeServices.layer, ServerSettingsModule.layerTest(), Te
               refresh: Effect.die(new Error("simulated refresh failure")),
               streamChanges: Stream.empty,
             },
-            adapter: {} as ProviderInstance["adapter"],
+            orchestrationAdapter: {} as ProviderInstance["orchestrationAdapter"],
             textGeneration: {} as ProviderInstance["textGeneration"],
           } satisfies ProviderInstance;
           const instanceRegistryLayer = Layer.succeed(
@@ -1504,7 +1570,7 @@ it.layer(Layer.mergeAll(NodeServices.layer, ServerSettingsModule.layerTest(), Te
               refresh: Effect.succeed(provider),
               streamChanges: Stream.empty,
             },
-            adapter: {} as ProviderInstance["adapter"],
+            orchestrationAdapter: {} as ProviderInstance["orchestrationAdapter"],
             textGeneration: {} as ProviderInstance["textGeneration"],
           });
           const codexInstance = makeInstance(codexProvider);
diff --git a/apps/server/src/provider/Layers/ProviderService.test.ts b/apps/server/src/provider/Layers/ProviderService.test.ts
deleted file mode 100644
index cc25bf7b22a3..000000000000
--- a/apps/server/src/provider/Layers/ProviderService.test.ts
+++ /dev/null
@@ -1,2296 +0,0 @@
-// @effect-diagnostics nodeBuiltinImport:off
-import * as NodeFS from "node:fs";
-import * as NodeOS from "node:os";
-import * as NodePath from "node:path";
-
-import type {
-  ProviderApprovalDecision,
-  ProviderRuntimeEvent,
-  ProviderSendTurnInput,
-  ProviderSession,
-  ProviderTurnStartResult,
-  ProviderUploadFeedbackInput,
-  ProviderUploadFeedbackResult,
-} from "@t3tools/contracts";
-import {
-  ApprovalRequestId,
-  EventId,
-  ProviderDriverKind,
-  ProviderInstanceId,
-  ProviderSessionStartInput,
-  ThreadId,
-  TurnId,
-} from "@t3tools/contracts";
-import { createModelSelection } from "@t3tools/shared/model";
-import { it, assert, describe, vi } from "@effect/vitest";
-
-import * as Cause from "effect/Cause";
-import * as Deferred from "effect/Deferred";
-import * as Effect from "effect/Effect";
-import * as Exit from "effect/Exit";
-import * as Fiber from "effect/Fiber";
-import * as Layer from "effect/Layer";
-import * as Metric from "effect/Metric";
-import * as Option from "effect/Option";
-import * as PubSub from "effect/PubSub";
-import * as Ref from "effect/Ref";
-import * as Scope from "effect/Scope";
-import * as Stream from "effect/Stream";
-import * as TestClock from "effect/testing/TestClock";
-import * as SqlClient from "effect/unstable/sql/SqlClient";
-
-import {
-  ProviderAdapterRequestError,
-  ProviderAdapterSessionNotFoundError,
-  ProviderUnsupportedError,
-  ProviderValidationError,
-  type ProviderAdapterError,
-} from "../Errors.ts";
-import type { ProviderAdapterShape } from "../Services/ProviderAdapter.ts";
-import * as ProviderAdapterRegistry from "../Services/ProviderAdapterRegistry.ts";
-import * as ProviderService from "../Services/ProviderService.ts";
-import * as ProviderSessionDirectory from "../Services/ProviderSessionDirectory.ts";
-import { makeProviderServiceLive } from "./ProviderService.ts";
-import * as ProviderEventLoggers from "./ProviderEventLoggers.ts";
-import { ProviderSessionDirectoryLive } from "./ProviderSessionDirectory.ts";
-import * as NodeServices from "@effect/platform-node/NodeServices";
-import * as ProviderSessionRuntime from "../../persistence/ProviderSessionRuntime.ts";
-import {
-  makeSqlitePersistenceLive,
-  SqlitePersistenceMemory,
-} from "../../persistence/Layers/Sqlite.ts";
-import * as ServerConfig from "../../config.ts";
-import * as ServerSettings from "../../serverSettings.ts";
-import * as AnalyticsService from "../../telemetry/AnalyticsService.ts";
-import { makeAdapterRegistryMock } from "../testUtils/providerAdapterRegistryMock.ts";
-
-const defaultServerSettingsLayer = ServerSettings.ServerSettingsService.layerTest();
-const serverConfigTestLayer = ServerConfig.layerTest(process.cwd(), process.cwd()).pipe(
-  Layer.provide(NodeServices.layer),
-);
-
-const asRequestId = (value: string): ApprovalRequestId => ApprovalRequestId.make(value);
-const asEventId = (value: string): EventId => EventId.make(value);
-const asThreadId = (value: string): ThreadId => ThreadId.make(value);
-const asTurnId = (value: string): TurnId => TurnId.make(value);
-const codexInstanceId = ProviderInstanceId.make("codex");
-const claudeAgentInstanceId = ProviderInstanceId.make("claudeAgent");
-const CODEX_DRIVER = ProviderDriverKind.make("codex");
-const CLAUDE_AGENT_DRIVER = ProviderDriverKind.make("claudeAgent");
-const CURSOR_DRIVER = ProviderDriverKind.make("cursor");
-
-type LegacyProviderRuntimeEvent = {
-  readonly type: string;
-  readonly eventId: EventId;
-  readonly provider: ProviderDriverKind;
-  readonly createdAt: string;
-  readonly threadId: ThreadId;
-  readonly turnId?: string | undefined;
-  readonly itemId?: string | undefined;
-  readonly requestId?: string | undefined;
-  readonly payload?: unknown | undefined;
-  readonly [key: string]: unknown;
-};
-
-function makeFakeCodexAdapter(provider: ProviderDriverKind = CODEX_DRIVER) {
-  const sessions = new Map<ThreadId, ProviderSession>();
-  const runtimeEventPubSub = Effect.runSync(PubSub.unbounded<ProviderRuntimeEvent>());
-
-  const startSession = vi.fn((input: ProviderSessionStartInput) =>
-    Effect.sync(() => {
-      const now = "2026-01-01T00:00:00.000Z";
-      const session: ProviderSession = {
-        provider,
-        ...(input.providerInstanceId !== undefined
-          ? { providerInstanceId: input.providerInstanceId }
-          : {}),
-        status: "ready",
-        runtimeMode: input.runtimeMode,
-        threadId: input.threadId,
-        resumeCursor: input.resumeCursor ?? {
-          opaque: `resume-${String(input.threadId)}`,
-        },
-        cwd: input.cwd ?? process.cwd(),
-        createdAt: now,
-        updatedAt: now,
-      };
-      sessions.set(session.threadId, session);
-      return session;
-    }),
-  );
-
-  const sendTurn = vi.fn(
-    (
-      input: ProviderSendTurnInput,
-    ): Effect.Effect<ProviderTurnStartResult, ProviderAdapterError> => {
-      if (!sessions.has(input.threadId)) {
-        return Effect.fail(
-          new ProviderAdapterSessionNotFoundError({
-            provider,
-            threadId: input.threadId,
-          }),
-        );
-      }
-
-      return Effect.succeed({
-        threadId: input.threadId,
-        turnId: TurnId.make(`turn-${String(input.threadId)}`),
-      });
-    },
-  );
-
-  const interruptTurn = vi.fn(
-    (_threadId: ThreadId, _turnId?: TurnId): Effect.Effect<void, ProviderAdapterError> =>
-      Effect.void,
-  );
-
-  const respondToRequest = vi.fn(
-    (
-      _threadId: ThreadId,
-      _requestId: string,
-      _decision: ProviderApprovalDecision,
-    ): Effect.Effect<void, ProviderAdapterError> => Effect.void,
-  );
-
-  const respondToUserInput = vi.fn(
-    (
-      _threadId: ThreadId,
-      _requestId: string,
-      _answers: Record<string, unknown>,
-    ): Effect.Effect<void, ProviderAdapterError> => Effect.void,
-  );
-
-  const stopSession = vi.fn(
-    (threadId: ThreadId): Effect.Effect<void, ProviderAdapterError> =>
-      Effect.sync(() => {
-        sessions.delete(threadId);
-      }),
-  );
-
-  const listSessions = vi.fn(
-    (): Effect.Effect<ReadonlyArray<ProviderSession>> =>
-      Effect.sync(() => Array.from(sessions.values())),
-  );
-
-  const hasSession = vi.fn(
-    (threadId: ThreadId): Effect.Effect<boolean> => Effect.succeed(sessions.has(threadId)),
-  );
-
-  const readThread = vi.fn(
-    (
-      threadId: ThreadId,
-    ): Effect.Effect<
-      {
-        threadId: ThreadId;
-        turns: ReadonlyArray<{ id: TurnId; items: readonly [] }>;
-      },
-      ProviderAdapterError
-    > =>
-      Effect.succeed({
-        threadId,
-        turns: [{ id: asTurnId("turn-1"), items: [] }],
-      }),
-  );
-
-  const rollbackThread = vi.fn(
-    (
-      threadId: ThreadId,
-      _numTurns: number,
-    ): Effect.Effect<{ threadId: ThreadId; turns: readonly [] }, ProviderAdapterError> =>
-      Effect.succeed({ threadId, turns: [] }),
-  );
-
-  const uploadFeedback = vi.fn(
-    (
-      input: ProviderUploadFeedbackInput,
-    ): Effect.Effect<ProviderUploadFeedbackResult, ProviderAdapterError> =>
-      Effect.succeed({ feedbackId: `feedback-${input.threadId}` }),
-  );
-
-  const stopAll = vi.fn(
-    (): Effect.Effect<void, ProviderAdapterError> =>
-      Effect.sync(() => {
-        sessions.clear();
-      }),
-  );
-
-  const adapter: ProviderAdapterShape<ProviderAdapterError> = {
-    provider,
-    capabilities: {
-      sessionModelSwitch: "in-session",
-    },
-    startSession,
-    sendTurn,
-    interruptTurn,
-    respondToRequest,
-    respondToUserInput,
-    stopSession,
-    listSessions,
-    hasSession,
-    readThread,
-    rollbackThread,
-    ...(provider === CODEX_DRIVER ? { uploadFeedback } : {}),
-    stopAll,
-    get streamEvents() {
-      return Stream.fromPubSub(runtimeEventPubSub);
-    },
-  };
-
-  const emit = (event: LegacyProviderRuntimeEvent): void => {
-    Effect.runSync(PubSub.publish(runtimeEventPubSub, event as unknown as ProviderRuntimeEvent));
-  };
-
-  const updateSession = (
-    threadId: ThreadId,
-    update: (session: ProviderSession) => ProviderSession,
-  ): void => {
-    const existing = sessions.get(threadId);
-    if (!existing) {
-      return;
-    }
-    sessions.set(threadId, update(existing));
-  };
-
-  return {
-    adapter,
-    emit,
-    updateSession,
-    startSession,
-    sendTurn,
-    interruptTurn,
-    respondToRequest,
-    respondToUserInput,
-    stopSession,
-    listSessions,
-    hasSession,
-    readThread,
-    rollbackThread,
-    uploadFeedback,
-    stopAll,
-  };
-}
-
-const advanceTestClock = (ms: number) =>
-  TestClock.adjust(`${ms} millis`).pipe(Effect.andThen(Effect.yieldNow));
-
-const hasMetricSnapshot = (
-  snapshots: ReadonlyArray<Metric.Metric.Snapshot>,
-  id: string,
-  attributes: Readonly<Record<string, string>>,
-) =>
-  snapshots.some(
-    (snapshot) =>
-      snapshot.id === id &&
-      Object.entries(attributes).every(([key, value]) => snapshot.attributes?.[key] === value),
-  );
-
-function makeProviderServiceLayer() {
-  const codex = makeFakeCodexAdapter();
-  const claude = makeFakeCodexAdapter(CLAUDE_AGENT_DRIVER);
-  const cursor = makeFakeCodexAdapter(CURSOR_DRIVER);
-  const registry = makeAdapterRegistryMock({
-    [ProviderDriverKind.make("codex")]: codex.adapter,
-    [ProviderDriverKind.make("claudeAgent")]: claude.adapter,
-    [ProviderDriverKind.make("cursor")]: cursor.adapter,
-  });
-
-  const providerAdapterLayer = Layer.succeed(
-    ProviderAdapterRegistry.ProviderAdapterRegistry,
-    registry,
-  );
-  const runtimeRepositoryLayer = ProviderSessionRuntime.layer.pipe(
-    Layer.provide(SqlitePersistenceMemory),
-  );
-  const directoryLayer = ProviderSessionDirectoryLive.pipe(Layer.provide(runtimeRepositoryLayer));
-
-  const layer = it.layer(
-    Layer.mergeAll(
-      makeProviderServiceLive().pipe(
-        Layer.provide(providerAdapterLayer),
-        Layer.provide(directoryLayer),
-        Layer.provide(defaultServerSettingsLayer),
-        Layer.provide(serverConfigTestLayer),
-        Layer.provideMerge(AnalyticsService.layerTest),
-        Layer.provide(
-          Layer.succeed(
-            ProviderEventLoggers.ProviderEventLoggers,
-            ProviderEventLoggers.NoOpProviderEventLoggers,
-          ),
-        ),
-      ),
-      directoryLayer,
-
-      runtimeRepositoryLayer,
-      NodeServices.layer,
-    ),
-  );
-
-  return {
-    codex,
-    claude,
-    cursor,
-    layer,
-  };
-}
-
-it.effect("ProviderServiceLive catches stopAll failures during shutdown", () =>
-  Effect.gen(function* () {
-    const codex = makeFakeCodexAdapter();
-    codex.stopAll.mockImplementation(() =>
-      Effect.fail(
-        new ProviderAdapterRequestError({
-          provider: String(CODEX_DRIVER),
-          method: "stopAll",
-          detail: "simulated stopAll failure",
-        }),
-      ),
-    );
-    const registry = makeAdapterRegistryMock({
-      [CODEX_DRIVER]: codex.adapter,
-    });
-    const providerAdapterLayer = Layer.succeed(
-      ProviderAdapterRegistry.ProviderAdapterRegistry,
-      registry,
-    );
-    const runtimeRepositoryLayer = ProviderSessionRuntime.layer.pipe(
-      Layer.provide(SqlitePersistenceMemory),
-    );
-    const directoryLayer = ProviderSessionDirectoryLive.pipe(Layer.provide(runtimeRepositoryLayer));
-    const providerLayer = Layer.mergeAll(
-      makeProviderServiceLive().pipe(
-        Layer.provide(providerAdapterLayer),
-        Layer.provide(directoryLayer),
-        Layer.provide(defaultServerSettingsLayer),
-        Layer.provide(serverConfigTestLayer),
-        Layer.provideMerge(AnalyticsService.layerTest),
-        Layer.provide(
-          Layer.succeed(
-            ProviderEventLoggers.ProviderEventLoggers,
-            ProviderEventLoggers.NoOpProviderEventLoggers,
-          ),
-        ),
-      ),
-      directoryLayer,
-      runtimeRepositoryLayer,
-      NodeServices.layer,
-    );
-    const scope = yield* Scope.make();
-    const runtimeServices = yield* Layer.build(providerLayer).pipe(Scope.provide(scope));
-
-    yield* ProviderService.ProviderService.pipe(Effect.provide(runtimeServices));
-    const closeExit = yield* Scope.close(scope, Exit.void).pipe(Effect.exit);
-
-    assert.equal(Exit.isSuccess(closeExit), true);
-    assert.equal(codex.stopAll.mock.calls.length, 1);
-  }),
-);
-
-it.effect("ProviderServiceLive rejects new sessions for disabled providers", () =>
-  Effect.gen(function* () {
-    const codex = makeFakeCodexAdapter();
-    const claude = makeFakeCodexAdapter(CLAUDE_AGENT_DRIVER);
-    const registryBase = makeAdapterRegistryMock({
-      [CODEX_DRIVER]: codex.adapter,
-      [CLAUDE_AGENT_DRIVER]: claude.adapter,
-    });
-    const registry: ProviderAdapterRegistry.ProviderAdapterRegistry["Service"] = {
-      ...registryBase,
-      getInstanceInfo: (instanceId) =>
-        instanceId === claudeAgentInstanceId
-          ? Effect.succeed({
-              instanceId,
-              driverKind: CLAUDE_AGENT_DRIVER,
-              displayName: undefined,
-              enabled: false,
-              continuationIdentity: {
-                driverKind: CLAUDE_AGENT_DRIVER,
-                continuationKey: "claudeAgent:instance:claudeAgent",
-              },
-            })
-          : registryBase.getInstanceInfo(instanceId),
-    };
-    const providerAdapterLayer = Layer.succeed(
-      ProviderAdapterRegistry.ProviderAdapterRegistry,
-      registry,
-    );
-    const runtimeRepositoryLayer = ProviderSessionRuntime.layer.pipe(
-      Layer.provide(SqlitePersistenceMemory),
-    );
-    const directoryLayer = ProviderSessionDirectoryLive.pipe(Layer.provide(runtimeRepositoryLayer));
-    const providerLayer = makeProviderServiceLive().pipe(
-      Layer.provide(providerAdapterLayer),
-      Layer.provide(directoryLayer),
-      Layer.provide(defaultServerSettingsLayer),
-      Layer.provide(serverConfigTestLayer),
-      Layer.provide(AnalyticsService.layerTest),
-      Layer.provide(
-        Layer.succeed(
-          ProviderEventLoggers.ProviderEventLoggers,
-          ProviderEventLoggers.NoOpProviderEventLoggers,
-        ),
-      ),
-    );
-
-    const failure = yield* Effect.flip(
-      Effect.gen(function* () {
-        const provider = yield* ProviderService.ProviderService;
-        return yield* provider.startSession(asThreadId("thread-disabled"), {
-          provider: ProviderDriverKind.make("claudeAgent"),
-          providerInstanceId: claudeAgentInstanceId,
-          threadId: asThreadId("thread-disabled"),
-          runtimeMode: "full-access",
-        });
-      }).pipe(Effect.provide(providerLayer)),
-    );
-
-    assert.instanceOf(failure, ProviderValidationError);
-    assert.include(failure.issue, "Provider instance 'claudeAgent' is disabled");
-    assert.equal(claude.startSession.mock.calls.length, 0);
-  }).pipe(Effect.provide(NodeServices.layer)),
-);
-
-it.effect(
-  "ProviderServiceLive allows enabled custom instances when legacy driver is disabled",
-  () =>
-    Effect.gen(function* () {
-      const instanceId = ProviderInstanceId.make("codex_personal");
-      const driverKind = CODEX_DRIVER;
-      const codex = makeFakeCodexAdapter();
-      const unsupported = () =>
-        new ProviderUnsupportedError({
-          provider: driverKind,
-        });
-      const registry: ProviderAdapterRegistry.ProviderAdapterRegistry["Service"] = {
-        getByInstance: (requestedInstanceId) =>
-          requestedInstanceId === instanceId
-            ? Effect.succeed(codex.adapter)
-            : Effect.fail(unsupported()),
-        getInstanceInfo: (requestedInstanceId) =>
-          requestedInstanceId === instanceId
-            ? Effect.succeed({
-                instanceId,
-                driverKind,
-                displayName: "Codex Personal",
-                enabled: true,
-                continuationIdentity: {
-                  driverKind,
-                  continuationKey: "codex:/Users/example/.codex",
-                },
-              })
-            : Effect.fail(unsupported()),
-        listInstances: () => Effect.succeed([instanceId]),
-        listProviders: () => Effect.succeed([driverKind] as const),
-        streamChanges: Stream.empty,
-        subscribeChanges: Effect.flatMap(PubSub.unbounded<void>(), (pubsub) =>
-          PubSub.subscribe(pubsub),
-        ),
-      };
-      const providerAdapterLayer = Layer.succeed(
-        ProviderAdapterRegistry.ProviderAdapterRegistry,
-        registry,
-      );
-      const serverSettingsLayer = ServerSettings.ServerSettingsService.layerTest({
-        providers: {
-          codex: {
-            enabled: false,
-          },
-        },
-      });
-      const runtimeRepositoryLayer = ProviderSessionRuntime.layer.pipe(
-        Layer.provide(SqlitePersistenceMemory),
-      );
-      const directoryLayer = ProviderSessionDirectoryLive.pipe(
-        Layer.provide(runtimeRepositoryLayer),
-      );
-      const providerLayer = makeProviderServiceLive().pipe(
-        Layer.provide(providerAdapterLayer),
-        Layer.provide(directoryLayer),
-        Layer.provide(serverSettingsLayer),
-        Layer.provide(serverConfigTestLayer),
-        Layer.provide(AnalyticsService.layerTest),
-        Layer.provide(
-          Layer.succeed(
-            ProviderEventLoggers.ProviderEventLoggers,
-            ProviderEventLoggers.NoOpProviderEventLoggers,
-          ),
-        ),
-      );
-
-      const session = yield* Effect.gen(function* () {
-        const provider = yield* ProviderService.ProviderService;
-        return yield* provider.startSession(asThreadId("thread-enabled-custom"), {
-          provider: driverKind,
-          providerInstanceId: instanceId,
-          threadId: asThreadId("thread-enabled-custom"),
-          runtimeMode: "full-access",
-        });
-      }).pipe(Effect.provide(providerLayer));
-
-      assert.equal(session.providerInstanceId, instanceId);
-      assert.equal(codex.startSession.mock.calls.length, 1);
-    }).pipe(Effect.provide(NodeServices.layer)),
-);
-
-it.effect("ProviderServiceLive rejects new sessions for disabled custom instances", () =>
-  Effect.gen(function* () {
-    const instanceId = ProviderInstanceId.make("codex_personal");
-    const driverKind = ProviderDriverKind.make("codex");
-    const codex = makeFakeCodexAdapter();
-    const unsupported = () =>
-      new ProviderUnsupportedError({
-        provider: ProviderDriverKind.make("codex"),
-      });
-    const registry: ProviderAdapterRegistry.ProviderAdapterRegistry["Service"] = {
-      getByInstance: (requestedInstanceId) =>
-        requestedInstanceId === instanceId
-          ? Effect.succeed(codex.adapter)
-          : Effect.fail(unsupported()),
-      getInstanceInfo: (requestedInstanceId) =>
-        requestedInstanceId === instanceId
-          ? Effect.succeed({
-              instanceId,
-              driverKind,
-              displayName: "Codex Personal",
-              enabled: false,
-              continuationIdentity: {
-                driverKind,
-                continuationKey: "codex:/Users/example/.codex",
-              },
-            })
-          : Effect.fail(unsupported()),
-      listInstances: () => Effect.succeed([instanceId]),
-      listProviders: () => Effect.succeed([CODEX_DRIVER] as const),
-      streamChanges: Stream.empty,
-      subscribeChanges: Effect.flatMap(PubSub.unbounded<void>(), (pubsub) =>
-        PubSub.subscribe(pubsub),
-      ),
-    };
-    const providerAdapterLayer = Layer.succeed(
-      ProviderAdapterRegistry.ProviderAdapterRegistry,
-      registry,
-    );
-    const runtimeRepositoryLayer = ProviderSessionRuntime.layer.pipe(
-      Layer.provide(SqlitePersistenceMemory),
-    );
-    const directoryLayer = ProviderSessionDirectoryLive.pipe(Layer.provide(runtimeRepositoryLayer));
-    const providerLayer = makeProviderServiceLive().pipe(
-      Layer.provide(providerAdapterLayer),
-      Layer.provide(directoryLayer),
-      Layer.provide(defaultServerSettingsLayer),
-      Layer.provide(serverConfigTestLayer),
-      Layer.provide(AnalyticsService.layerTest),
-      Layer.provide(
-        Layer.succeed(
-          ProviderEventLoggers.ProviderEventLoggers,
-          ProviderEventLoggers.NoOpProviderEventLoggers,
-        ),
-      ),
-    );
-
-    const failure = yield* Effect.flip(
-      Effect.gen(function* () {
-        const provider = yield* ProviderService.ProviderService;
-        return yield* provider.startSession(asThreadId("thread-disabled-instance"), {
-          provider: ProviderDriverKind.make("codex"),
-          providerInstanceId: instanceId,
-          threadId: asThreadId("thread-disabled-instance"),
-          runtimeMode: "full-access",
-        });
-      }).pipe(Effect.provide(providerLayer)),
-    );
-
-    assert.instanceOf(failure, ProviderValidationError);
-    assert.include(failure.issue, "Provider instance 'codex_personal' is disabled");
-    assert.equal(codex.startSession.mock.calls.length, 0);
-  }).pipe(Effect.provide(NodeServices.layer)),
-);
-
-const routing = makeProviderServiceLayer();
-
-it.effect(
-  "ProviderServiceLive uploads feedback through the adapter that recovered the session",
-  () =>
-    Effect.gen(function* () {
-      const original = makeFakeCodexAdapter();
-      const replacement = makeFakeCodexAdapter();
-      const baseRegistry = makeAdapterRegistryMock({ [CODEX_DRIVER]: original.adapter });
-      let swapAfterFirstLookup = false;
-      let feedbackLookupCount = 0;
-      const registry: ProviderAdapterRegistry.ProviderAdapterRegistry["Service"] = {
-        ...baseRegistry,
-        getByInstance: (instanceId) => {
-          if (instanceId !== codexInstanceId) {
-            return baseRegistry.getByInstance(instanceId);
-          }
-          const useReplacement = swapAfterFirstLookup && feedbackLookupCount++ > 0;
-          return Effect.succeed(useReplacement ? replacement.adapter : original.adapter);
-        },
-      };
-      const runtimeRepositoryLayer = ProviderSessionRuntime.layer.pipe(
-        Layer.provide(SqlitePersistenceMemory),
-      );
-      const directoryLayer = ProviderSessionDirectoryLive.pipe(
-        Layer.provide(runtimeRepositoryLayer),
-      );
-      const providerLayer = makeProviderServiceLive().pipe(
-        Layer.provide(Layer.succeed(ProviderAdapterRegistry.ProviderAdapterRegistry, registry)),
-        Layer.provide(directoryLayer),
-        Layer.provide(defaultServerSettingsLayer),
-        Layer.provide(serverConfigTestLayer),
-        Layer.provide(AnalyticsService.layerTest),
-        Layer.provide(
-          Layer.succeed(
-            ProviderEventLoggers.ProviderEventLoggers,
-            ProviderEventLoggers.NoOpProviderEventLoggers,
-          ),
-        ),
-      );
-
-      yield* Effect.gen(function* () {
-        const provider = yield* ProviderService.ProviderService;
-        const threadId = asThreadId("thread-feedback-adapter-replacement");
-        yield* provider.startSession(threadId, {
-          provider: CODEX_DRIVER,
-          providerInstanceId: codexInstanceId,
-          threadId,
-          runtimeMode: "full-access",
-        });
-        yield* original.stopSession(threadId);
-        original.uploadFeedback.mockClear();
-        replacement.uploadFeedback.mockClear();
-        swapAfterFirstLookup = true;
-
-        const result = yield* provider.uploadFeedback({ threadId });
-
-        assert.deepStrictEqual(result, { feedbackId: `feedback-${threadId}` });
-        assert.strictEqual(original.uploadFeedback.mock.calls.length, 0);
-        assert.deepStrictEqual(replacement.uploadFeedback.mock.calls, [[{ threadId }]]);
-      }).pipe(Effect.provide(providerLayer));
-    }).pipe(Effect.provide(NodeServices.layer)),
-);
-
-it.effect("ProviderServiceLive writes canonical events to the emitting thread segment", () =>
-  Effect.gen(function* () {
-    const codex = makeFakeCodexAdapter();
-    const canonicalEvents: ProviderRuntimeEvent[] = [];
-    const canonicalThreadIds: Array<string | null> = [];
-    const registry = makeAdapterRegistryMock({
-      [ProviderDriverKind.make("codex")]: codex.adapter,
-    });
-    const runtimeRepositoryLayer = ProviderSessionRuntime.layer.pipe(
-      Layer.provide(SqlitePersistenceMemory),
-    );
-    const directoryLayer = ProviderSessionDirectoryLive.pipe(Layer.provide(runtimeRepositoryLayer));
-    const providerLayer = makeProviderServiceLive({
-      canonicalEventLogger: {
-        filePath: "memory://provider-canonical-events",
-        write: (event, threadId) => {
-          canonicalEvents.push(event as ProviderRuntimeEvent);
-          canonicalThreadIds.push(threadId ?? null);
-          return Effect.void;
-        },
-        close: () => Effect.void,
-      },
-    }).pipe(
-      Layer.provide(Layer.succeed(ProviderAdapterRegistry.ProviderAdapterRegistry, registry)),
-      Layer.provide(directoryLayer),
-      Layer.provide(defaultServerSettingsLayer),
-      Layer.provide(serverConfigTestLayer),
-      Layer.provide(AnalyticsService.layerTest),
-      Layer.provide(
-        Layer.succeed(
-          ProviderEventLoggers.ProviderEventLoggers,
-          ProviderEventLoggers.NoOpProviderEventLoggers,
-        ),
-      ),
-    );
-
-    yield* Effect.gen(function* () {
-      yield* ProviderService.ProviderService;
-      yield* advanceTestClock(10);
-      codex.emit({
-        eventId: asEventId("evt-canonical-thread-segment"),
-        provider: ProviderDriverKind.make("codex"),
-        threadId: asThreadId("thread-canonical-thread-segment"),
-        createdAt: "2026-01-01T00:00:00.000Z",
-        type: "turn.completed",
-        payload: {
-          state: "completed",
-        },
-      });
-      yield* advanceTestClock(20);
-    }).pipe(Effect.provide(providerLayer));
-
-    assert.equal(canonicalEvents.length, 1);
-    assert.equal(canonicalEvents[0]?.threadId, "thread-canonical-thread-segment");
-    assert.deepEqual(canonicalThreadIds, ["thread-canonical-thread-segment"]);
-  }).pipe(Effect.provide(NodeServices.layer)),
-);
-
-it.effect("ProviderServiceLive keeps persisted resumable sessions on startup", () =>
-  Effect.gen(function* () {
-    const tempDir = NodeFS.mkdtempSync(NodePath.join(NodeOS.tmpdir(), "t3-provider-service-"));
-    const dbPath = NodePath.join(tempDir, "orchestration.sqlite");
-
-    const codex = makeFakeCodexAdapter();
-    const registry = makeAdapterRegistryMock({
-      [ProviderDriverKind.make("codex")]: codex.adapter,
-    });
-
-    const persistenceLayer = makeSqlitePersistenceLive(dbPath);
-    const runtimeRepositoryLayer = ProviderSessionRuntime.layer.pipe(
-      Layer.provide(persistenceLayer),
-    );
-    const directoryLayer = ProviderSessionDirectoryLive.pipe(Layer.provide(runtimeRepositoryLayer));
-
-    yield* Effect.gen(function* () {
-      const directory = yield* ProviderSessionDirectory.ProviderSessionDirectory;
-      yield* directory.upsert({
-        provider: ProviderDriverKind.make("codex"),
-        providerInstanceId: codexInstanceId,
-        threadId: ThreadId.make("thread-stale"),
-      });
-    }).pipe(Effect.provide(directoryLayer));
-
-    const providerLayer = makeProviderServiceLive().pipe(
-      Layer.provide(Layer.succeed(ProviderAdapterRegistry.ProviderAdapterRegistry, registry)),
-      Layer.provide(directoryLayer),
-      Layer.provide(defaultServerSettingsLayer),
-      Layer.provide(serverConfigTestLayer),
-      Layer.provide(AnalyticsService.layerTest),
-      Layer.provide(
-        Layer.succeed(
-          ProviderEventLoggers.ProviderEventLoggers,
-          ProviderEventLoggers.NoOpProviderEventLoggers,
-        ),
-      ),
-    );
-
-    yield* ProviderService.ProviderService.pipe(Effect.provide(providerLayer));
-
-    const persistedProvider = yield* Effect.gen(function* () {
-      const directory = yield* ProviderSessionDirectory.ProviderSessionDirectory;
-      return yield* directory.getProvider(asThreadId("thread-stale"));
-    }).pipe(Effect.provide(directoryLayer));
-    assert.equal(persistedProvider, "codex");
-
-    const runtime = yield* Effect.gen(function* () {
-      const repository = yield* ProviderSessionRuntime.ProviderSessionRuntimeRepository;
-      return yield* repository.getByThreadId({
-        threadId: asThreadId("thread-stale"),
-      });
-    }).pipe(Effect.provide(runtimeRepositoryLayer));
-    assert.equal(Option.isSome(runtime), true);
-
-    const legacyTableRows = yield* Effect.gen(function* () {
-      const sql = yield* SqlClient.SqlClient;
-      return yield* sql<{ readonly name: string }>`
-        SELECT name
-        FROM sqlite_master
-        WHERE type = 'table' AND name = 'provider_sessions'
-      `;
-    }).pipe(Effect.provide(persistenceLayer));
-    assert.equal(legacyTableRows.length, 0);
-
-    NodeFS.rmSync(tempDir, { recursive: true, force: true });
-  }).pipe(Effect.provide(NodeServices.layer)),
-);
-
-it.effect(
-  "ProviderServiceLive restores rollback routing after restart using persisted thread mapping",
-  () =>
-    Effect.gen(function* () {
-      const tempDir = NodeFS.mkdtempSync(
-        NodePath.join(NodeOS.tmpdir(), "t3-provider-service-restart-"),
-      );
-      const dbPath = NodePath.join(tempDir, "orchestration.sqlite");
-      const persistenceLayer = makeSqlitePersistenceLive(dbPath);
-      const runtimeRepositoryLayer = ProviderSessionRuntime.layer.pipe(
-        Layer.provide(persistenceLayer),
-      );
-
-      const firstCodex = makeFakeCodexAdapter();
-      const firstRegistry = makeAdapterRegistryMock({
-        [ProviderDriverKind.make("codex")]: firstCodex.adapter,
-      });
-
-      const firstDirectoryLayer = ProviderSessionDirectoryLive.pipe(
-        Layer.provide(runtimeRepositoryLayer),
-      );
-      const firstProviderLayer = makeProviderServiceLive().pipe(
-        Layer.provide(
-          Layer.succeed(ProviderAdapterRegistry.ProviderAdapterRegistry, firstRegistry),
-        ),
-        Layer.provide(firstDirectoryLayer),
-        Layer.provide(defaultServerSettingsLayer),
-        Layer.provide(serverConfigTestLayer),
-        Layer.provide(AnalyticsService.layerTest),
-        Layer.provide(
-          Layer.succeed(
-            ProviderEventLoggers.ProviderEventLoggers,
-            ProviderEventLoggers.NoOpProviderEventLoggers,
-          ),
-        ),
-      );
-      const updatedResumeCursor = {
-        threadId: asThreadId("thread-1"),
-        resume: "resume-session-1",
-        resumeSessionAt: "assistant-message-1",
-        turnCount: 1,
-      };
-
-      const startedSession = yield* Effect.gen(function* () {
-        const provider = yield* ProviderService.ProviderService;
-        const threadId = asThreadId("thread-1");
-        const session = yield* provider.startSession(threadId, {
-          provider: ProviderDriverKind.make("codex"),
-          providerInstanceId: codexInstanceId,
-          cwd: "/tmp/project",
-          runtimeMode: "full-access",
-          threadId,
-        });
-        firstCodex.updateSession(threadId, (existing) => ({
-          ...existing,
-          status: "ready",
-          resumeCursor: updatedResumeCursor,
-          updatedAt: "2026-01-01T00:00:01.000Z",
-        }));
-        return session;
-      }).pipe(Effect.provide(firstProviderLayer));
-
-      const persistedAfterStopAll = yield* Effect.gen(function* () {
-        const repository = yield* ProviderSessionRuntime.ProviderSessionRuntimeRepository;
-        return yield* repository.getByThreadId({
-          threadId: startedSession.threadId,
-        });
-      }).pipe(Effect.provide(runtimeRepositoryLayer));
-      assert.equal(Option.isSome(persistedAfterStopAll), true);
-      if (Option.isSome(persistedAfterStopAll)) {
-        assert.equal(persistedAfterStopAll.value.status, "stopped");
-        assert.deepEqual(persistedAfterStopAll.value.resumeCursor, updatedResumeCursor);
-      }
-
-      const secondCodex = makeFakeCodexAdapter();
-      const secondRegistry = makeAdapterRegistryMock({
-        [ProviderDriverKind.make("codex")]: secondCodex.adapter,
-      });
-      const secondDirectoryLayer = ProviderSessionDirectoryLive.pipe(
-        Layer.provide(runtimeRepositoryLayer),
-      );
-      const secondProviderLayer = makeProviderServiceLive().pipe(
-        Layer.provide(
-          Layer.succeed(ProviderAdapterRegistry.ProviderAdapterRegistry, secondRegistry),
-        ),
-        Layer.provide(secondDirectoryLayer),
-        Layer.provide(defaultServerSettingsLayer),
-        Layer.provide(serverConfigTestLayer),
-        Layer.provide(AnalyticsService.layerTest),
-        Layer.provide(
-          Layer.succeed(
-            ProviderEventLoggers.ProviderEventLoggers,
-            ProviderEventLoggers.NoOpProviderEventLoggers,
-          ),
-        ),
-      );
-
-      secondCodex.startSession.mockClear();
-      secondCodex.rollbackThread.mockClear();
-
-      yield* Effect.gen(function* () {
-        const provider = yield* ProviderService.ProviderService;
-        yield* provider.rollbackConversation({
-          threadId: startedSession.threadId,
-          numTurns: 1,
-        });
-      }).pipe(Effect.provide(secondProviderLayer));
-
-      assert.equal(secondCodex.startSession.mock.calls.length, 1);
-      const resumedStartInput = secondCodex.startSession.mock.calls[0]?.[0];
-      assert.equal(typeof resumedStartInput === "object" && resumedStartInput !== null, true);
-      if (resumedStartInput && typeof resumedStartInput === "object") {
-        const startPayload = resumedStartInput as {
-          provider?: string;
-          cwd?: string;
-          resumeCursor?: unknown;
-          threadId?: string;
-        };
-        assert.equal(startPayload.provider, "codex");
-        assert.equal(startPayload.cwd, "/tmp/project");
-        assert.deepEqual(startPayload.resumeCursor, updatedResumeCursor);
-        assert.equal(startPayload.threadId, startedSession.threadId);
-      }
-      assert.equal(secondCodex.rollbackThread.mock.calls.length, 1);
-      const rollbackCall = secondCodex.rollbackThread.mock.calls[0];
-      assert.equal(typeof rollbackCall?.[0], "string");
-      assert.equal(rollbackCall?.[1], 1);
-
-      NodeFS.rmSync(tempDir, { recursive: true, force: true });
-    }).pipe(Effect.provide(NodeServices.layer)),
-);
-
-routing.layer("ProviderServiceLive routing", (it) => {
-  it.effect("routes provider operations and rollback conversation", () =>
-    Effect.gen(function* () {
-      const provider = yield* ProviderService.ProviderService;
-
-      const session = yield* provider.startSession(asThreadId("thread-1"), {
-        provider: ProviderDriverKind.make("codex"),
-        providerInstanceId: codexInstanceId,
-        threadId: asThreadId("thread-1"),
-        cwd: "/tmp/project",
-        runtimeMode: "full-access",
-      });
-      assert.equal(session.provider, "codex");
-
-      const sessions = yield* provider.listSessions();
-      assert.equal(sessions.length, 1);
-
-      yield* provider.sendTurn({
-        threadId: session.threadId,
-        input: "hello",
-        attachments: [],
-      });
-      assert.equal(routing.codex.sendTurn.mock.calls.length, 1);
-
-      yield* provider.interruptTurn({ threadId: session.threadId });
-      assert.deepEqual(routing.codex.interruptTurn.mock.calls, [[session.threadId, undefined]]);
-
-      yield* provider.respondToRequest({
-        threadId: session.threadId,
-        requestId: asRequestId("req-1"),
-        decision: "accept",
-      });
-      assert.deepEqual(routing.codex.respondToRequest.mock.calls, [
-        [session.threadId, asRequestId("req-1"), "accept"],
-      ]);
-
-      yield* provider.respondToUserInput({
-        threadId: session.threadId,
-        requestId: asRequestId("req-user-input-1"),
-        answers: {
-          sandbox_mode: "workspace-write",
-        },
-      });
-      assert.deepEqual(routing.codex.respondToUserInput.mock.calls, [
-        [
-          session.threadId,
-          asRequestId("req-user-input-1"),
-          {
-            sandbox_mode: "workspace-write",
-          },
-        ],
-      ]);
-
-      yield* provider.rollbackConversation({
-        threadId: session.threadId,
-        numTurns: 0,
-      });
-
-      yield* provider.stopSession({ threadId: session.threadId });
-      routing.codex.startSession.mockClear();
-      routing.codex.sendTurn.mockClear();
-
-      yield* provider.sendTurn({
-        threadId: session.threadId,
-        input: "after-stop",
-        attachments: [],
-      });
-
-      assert.equal(routing.codex.startSession.mock.calls.length, 1);
-      const resumedStartInput = routing.codex.startSession.mock.calls[0]?.[0];
-      assert.equal(typeof resumedStartInput === "object" && resumedStartInput !== null, true);
-      if (resumedStartInput && typeof resumedStartInput === "object") {
-        const startPayload = resumedStartInput as {
-          provider?: string;
-          cwd?: string;
-          resumeCursor?: unknown;
-          threadId?: string;
-        };
-        assert.equal(startPayload.provider, "codex");
-        assert.equal(startPayload.cwd, "/tmp/project");
-        assert.deepEqual(startPayload.resumeCursor, session.resumeCursor);
-        assert.equal(startPayload.threadId, session.threadId);
-      }
-      assert.equal(routing.codex.sendTurn.mock.calls.length, 1);
-    }),
-  );
-
-  it.effect("routes feedback to the Codex adapter and returns its feedback ID", () =>
-    Effect.gen(function* () {
-      const provider = yield* ProviderService.ProviderService;
-      const threadId = asThreadId("thread-feedback-route");
-      yield* provider.startSession(threadId, {
-        provider: CODEX_DRIVER,
-        providerInstanceId: codexInstanceId,
-        threadId,
-        runtimeMode: "full-access",
-      });
-      routing.codex.uploadFeedback.mockClear();
-
-      const result = yield* provider.uploadFeedback({
-        threadId,
-        reason: "The agent stopped early.",
-      });
-
-      assert.deepStrictEqual(result, { feedbackId: `feedback-${threadId}` });
-      assert.deepStrictEqual(routing.codex.uploadFeedback.mock.calls, [
-        [{ threadId, reason: "The agent stopped early." }],
-      ]);
-    }),
-  );
-
-  it.effect("recovers a stopped Codex session before uploading feedback", () =>
-    Effect.gen(function* () {
-      const provider = yield* ProviderService.ProviderService;
-      const threadId = asThreadId("thread-feedback-recover");
-      yield* provider.startSession(threadId, {
-        provider: CODEX_DRIVER,
-        providerInstanceId: codexInstanceId,
-        threadId,
-        cwd: "/tmp/feedback-project",
-        runtimeMode: "full-access",
-      });
-      yield* routing.codex.stopSession(threadId);
-      routing.codex.startSession.mockClear();
-      routing.codex.uploadFeedback.mockClear();
-
-      const result = yield* provider.uploadFeedback({ threadId });
-
-      assert.deepStrictEqual(result, { feedbackId: `feedback-${threadId}` });
-      assert.strictEqual(routing.codex.startSession.mock.calls.length, 1);
-      assert.deepStrictEqual(routing.codex.uploadFeedback.mock.calls, [[{ threadId }]]);
-    }),
-  );
-
-  it.effect("rejects feedback for providers that do not support uploads", () =>
-    Effect.gen(function* () {
-      const provider = yield* ProviderService.ProviderService;
-      const threadId = asThreadId("thread-feedback-claude");
-      yield* provider.startSession(threadId, {
-        provider: CLAUDE_AGENT_DRIVER,
-        providerInstanceId: claudeAgentInstanceId,
-        threadId,
-        runtimeMode: "full-access",
-      });
-
-      const error = yield* provider.uploadFeedback({ threadId }).pipe(Effect.flip);
-
-      assert.instanceOf(error, ProviderValidationError);
-      assert.include(error.issue, "does not support feedback uploads");
-      routing.claude.startSession.mockClear();
-    }),
-  );
-
-  it.effect("does not restart an unsupported provider before rejecting feedback", () =>
-    Effect.gen(function* () {
-      const provider = yield* ProviderService.ProviderService;
-      const threadId = asThreadId("thread-feedback-unsupported-stopped");
-      yield* provider.startSession(threadId, {
-        provider: CLAUDE_AGENT_DRIVER,
-        providerInstanceId: claudeAgentInstanceId,
-        threadId,
-        runtimeMode: "full-access",
-      });
-      yield* routing.claude.stopSession(threadId);
-      routing.claude.startSession.mockClear();
-
-      const error = yield* provider.uploadFeedback({ threadId }).pipe(Effect.flip);
-
-      assert.instanceOf(error, ProviderValidationError);
-      assert.include(error.issue, "does not support feedback uploads");
-      assert.strictEqual(routing.claude.startSession.mock.calls.length, 0);
-    }),
-  );
-
-  it.effect("appends attachment file paths to the turn input text", () =>
-    Effect.gen(function* () {
-      const provider = yield* ProviderService.ProviderService;
-
-      const session = yield* provider.startSession(asThreadId("thread-attach"), {
-        provider: ProviderDriverKind.make("codex"),
-        providerInstanceId: codexInstanceId,
-        threadId: asThreadId("thread-attach"),
-        cwd: "/tmp/project",
-        runtimeMode: "full-access",
-      });
-
-      const attachment = {
-        type: "image" as const,
-        id: "thread-attach-12345678-1234-1234-1234-123456789abc",
-        name: "screenshot.png",
-        mimeType: "image/png",
-        sizeBytes: 123,
-      };
-
-      routing.codex.sendTurn.mockClear();
-      yield* provider.sendTurn({
-        threadId: session.threadId,
-        input: "use this screenshot",
-        attachments: [attachment],
-      });
-
-      const turnInput = routing.codex.sendTurn.mock.calls[0]?.[0] as ProviderSendTurnInput;
-      assert.equal(typeof turnInput.input, "string");
-      const turnText = turnInput.input ?? "";
-      assert.equal(turnText.startsWith("use this screenshot"), true);
-      assert.include(turnText, '[Attached image "screenshot.png" is saved at: ');
-      assert.equal(turnText.endsWith(`${attachment.id}.png]`), true);
-
-      // An attachment-only turn stays valid and the injected line becomes the
-      // whole input text, so the agent still learns the path.
-      routing.codex.sendTurn.mockClear();
-      yield* provider.sendTurn({
-        threadId: session.threadId,
-        attachments: [attachment],
-      });
-      const imageOnlyInput = routing.codex.sendTurn.mock.calls[0]?.[0] as ProviderSendTurnInput;
-      assert.equal(imageOnlyInput.input?.startsWith('[Attached image "screenshot.png"'), true);
-
-      const fileAttachment = {
-        type: "file" as const,
-        id: "thread-attach-12345678-1234-1234-1234-123456789abc-pdf",
-        name: "report.pdf",
-        mimeType: "application/pdf",
-        sizeBytes: 456,
-      };
-
-      routing.codex.sendTurn.mockClear();
-      yield* provider.sendTurn({
-        threadId: session.threadId,
-        input: "summarize the report",
-        attachments: [attachment, fileAttachment],
-      });
-      const mixedInput = routing.codex.sendTurn.mock.calls[0]?.[0] as ProviderSendTurnInput;
-      assert.include(mixedInput.input ?? "", '[Attached file "report.pdf" is saved at: ');
-      assert.include(mixedInput.input ?? "", `${fileAttachment.id}.pdf]`);
-      // Every attachment reaches the adapter; each adapter decides what its
-      // provider ingests natively.
-      assert.deepEqual(mixedInput.attachments, [attachment, fileAttachment]);
-
-      routing.codex.sendTurn.mockClear();
-      yield* provider.sendTurn({ threadId: session.threadId, attachments: [fileAttachment] });
-      const fileOnlyInput = routing.codex.sendTurn.mock.calls[0]?.[0] as ProviderSendTurnInput;
-      assert.include(fileOnlyInput.input ?? "", '[Attached file "report.pdf" is saved at: ');
-      assert.deepEqual(fileOnlyInput.attachments, [fileAttachment]);
-
-      yield* provider.stopSession({ threadId: session.threadId });
-    }),
-  );
-
-  it.effect("recovers stale persisted sessions for rollback by resuming thread identity", () =>
-    Effect.gen(function* () {
-      const provider = yield* ProviderService.ProviderService;
-
-      const initial = yield* provider.startSession(asThreadId("thread-1"), {
-        provider: ProviderDriverKind.make("codex"),
-        providerInstanceId: codexInstanceId,
-        threadId: asThreadId("thread-1"),
-        cwd: "/tmp/project",
-        runtimeMode: "full-access",
-      });
-      yield* routing.codex.stopSession(initial.threadId);
-      routing.codex.startSession.mockClear();
-      routing.codex.rollbackThread.mockClear();
-
-      yield* provider.rollbackConversation({
-        threadId: initial.threadId,
-        numTurns: 1,
-      });
-
-      assert.equal(routing.codex.startSession.mock.calls.length, 1);
-      const resumedStartInput = routing.codex.startSession.mock.calls[0]?.[0];
-      assert.equal(typeof resumedStartInput === "object" && resumedStartInput !== null, true);
-      if (resumedStartInput && typeof resumedStartInput === "object") {
-        const startPayload = resumedStartInput as {
-          provider?: string;
-          cwd?: string;
-          resumeCursor?: unknown;
-          threadId?: string;
-        };
-        assert.equal(startPayload.provider, "codex");
-        assert.equal(startPayload.cwd, "/tmp/project");
-        assert.deepEqual(startPayload.resumeCursor, initial.resumeCursor);
-        assert.equal(startPayload.threadId, initial.threadId);
-      }
-      assert.equal(routing.codex.rollbackThread.mock.calls.length, 1);
-      const rollbackCall = routing.codex.rollbackThread.mock.calls[0];
-      assert.equal(rollbackCall?.[1], 1);
-    }),
-  );
-
-  it.effect("preserves the persisted binding when stopping a session", () =>
-    Effect.gen(function* () {
-      const provider = yield* ProviderService.ProviderService;
-      const runtimeRepository = yield* ProviderSessionRuntime.ProviderSessionRuntimeRepository;
-
-      const initial = yield* provider.startSession(asThreadId("thread-reap-preserve"), {
-        provider: ProviderDriverKind.make("codex"),
-        providerInstanceId: codexInstanceId,
-        threadId: asThreadId("thread-reap-preserve"),
-        cwd: "/tmp/project-reap-preserve",
-        runtimeMode: "full-access",
-      });
-
-      yield* provider.stopSession({ threadId: initial.threadId });
-
-      const persistedAfterStop = yield* runtimeRepository.getByThreadId({
-        threadId: initial.threadId,
-      });
-      assert.equal(Option.isSome(persistedAfterStop), true);
-      if (Option.isSome(persistedAfterStop)) {
-        assert.equal(persistedAfterStop.value.status, "stopped");
-        assert.deepEqual(persistedAfterStop.value.resumeCursor, initial.resumeCursor);
-      }
-
-      routing.codex.startSession.mockClear();
-      routing.codex.sendTurn.mockClear();
-
-      yield* provider.sendTurn({
-        threadId: initial.threadId,
-        input: "resume after reap",
-        attachments: [],
-      });
-
-      assert.equal(routing.codex.startSession.mock.calls.length, 1);
-      const resumedStartInput = routing.codex.startSession.mock.calls[0]?.[0];
-      assert.equal(typeof resumedStartInput === "object" && resumedStartInput !== null, true);
-      if (resumedStartInput && typeof resumedStartInput === "object") {
-        const startPayload = resumedStartInput as {
-          provider?: string;
-          cwd?: string;
-          resumeCursor?: unknown;
-          threadId?: string;
-        };
-        assert.equal(startPayload.provider, "codex");
-        assert.equal(startPayload.cwd, "/tmp/project-reap-preserve");
-        assert.deepEqual(startPayload.resumeCursor, initial.resumeCursor);
-        assert.equal(startPayload.threadId, initial.threadId);
-      }
-      assert.equal(routing.codex.sendTurn.mock.calls.length, 1);
-    }),
-  );
-
-  it.effect("routes explicit claudeAgent provider session starts to the claude adapter", () =>
-    Effect.gen(function* () {
-      const provider = yield* ProviderService.ProviderService;
-
-      const session = yield* provider.startSession(asThreadId("thread-claude"), {
-        provider: ProviderDriverKind.make("claudeAgent"),
-        providerInstanceId: claudeAgentInstanceId,
-        threadId: asThreadId("thread-claude"),
-        cwd: "/tmp/project-claude",
-        runtimeMode: "full-access",
-      });
-
-      assert.equal(session.provider, "claudeAgent");
-      assert.equal(routing.claude.startSession.mock.calls.length, 1);
-      const startInput = routing.claude.startSession.mock.calls[0]?.[0];
-      assert.equal(typeof startInput === "object" && startInput !== null, true);
-      if (startInput && typeof startInput === "object") {
-        const startPayload = startInput as {
-          provider?: string;
-          providerInstanceId?: ProviderInstanceId;
-          cwd?: string;
-        };
-        assert.equal(startPayload.provider, "claudeAgent");
-        assert.equal(startPayload.providerInstanceId, claudeAgentInstanceId);
-        assert.equal(startPayload.cwd, "/tmp/project-claude");
-      }
-    }),
-  );
-
-  it.effect("dies when an active session conflicts with its persisted binding", () =>
-    Effect.gen(function* () {
-      const provider = yield* ProviderService.ProviderService;
-      const directory = yield* ProviderSessionDirectory.ProviderSessionDirectory;
-      const threadId = asThreadId("thread-binding-mismatch");
-
-      yield* provider.startSession(threadId, {
-        provider: ProviderDriverKind.make("codex"),
-        providerInstanceId: codexInstanceId,
-        threadId,
-        cwd: "/tmp/project-binding-mismatch",
-        runtimeMode: "full-access",
-      });
-      yield* directory.upsert({
-        threadId,
-        provider: ProviderDriverKind.make("claudeAgent"),
-        providerInstanceId: claudeAgentInstanceId,
-        runtimeMode: "full-access",
-      });
-
-      const exit = yield* Effect.exit(provider.listSessions());
-      assert.equal(Exit.hasDies(exit), true);
-      yield* directory.upsert({
-        threadId,
-        provider: ProviderDriverKind.make("codex"),
-        providerInstanceId: codexInstanceId,
-        runtimeMode: "full-access",
-      });
-    }),
-  );
-
-  it.effect("stops stale sessions in other providers after a successful replacement start", () =>
-    Effect.gen(function* () {
-      const provider = yield* ProviderService.ProviderService;
-      const threadId = asThreadId("thread-provider-replacement");
-
-      const codexSession = yield* provider.startSession(threadId, {
-        provider: ProviderDriverKind.make("codex"),
-        providerInstanceId: codexInstanceId,
-        threadId,
-        cwd: "/tmp/project-provider-replacement",
-        runtimeMode: "full-access",
-      });
-
-      routing.codex.stopSession.mockClear();
-      routing.claude.stopSession.mockClear();
-
-      const claudeSession = yield* provider.startSession(threadId, {
-        provider: ProviderDriverKind.make("claudeAgent"),
-        providerInstanceId: claudeAgentInstanceId,
-        threadId,
-        cwd: "/tmp/project-provider-replacement",
-        runtimeMode: "full-access",
-      });
-
-      assert.equal(codexSession.provider, "codex");
-      assert.equal(claudeSession.provider, "claudeAgent");
-      assert.deepEqual(routing.codex.stopSession.mock.calls, [[threadId]]);
-      assert.equal(routing.claude.stopSession.mock.calls.length, 0);
-
-      const sessions = yield* provider.listSessions();
-      assert.deepEqual(
-        sessions
-          .filter((session) => session.threadId === threadId)
-          .map((session) => session.provider),
-        ["claudeAgent"],
-      );
-    }),
-  );
-
-  it.effect("recovers stale sessions for sendTurn using persisted cwd", () =>
-    Effect.gen(function* () {
-      const provider = yield* ProviderService.ProviderService;
-
-      const initial = yield* provider.startSession(asThreadId("thread-1"), {
-        provider: ProviderDriverKind.make("codex"),
-        providerInstanceId: codexInstanceId,
-        threadId: asThreadId("thread-1"),
-        cwd: "/tmp/project-send-turn",
-        runtimeMode: "full-access",
-      });
-
-      yield* routing.codex.stopAll();
-      routing.codex.startSession.mockClear();
-      routing.codex.sendTurn.mockClear();
-
-      yield* provider.sendTurn({
-        threadId: initial.threadId,
-        input: "resume",
-        attachments: [],
-      });
-
-      assert.equal(routing.codex.startSession.mock.calls.length, 1);
-      const resumedStartInput = routing.codex.startSession.mock.calls[0]?.[0];
-      assert.equal(typeof resumedStartInput === "object" && resumedStartInput !== null, true);
-      if (resumedStartInput && typeof resumedStartInput === "object") {
-        const startPayload = resumedStartInput as {
-          provider?: string;
-          cwd?: string;
-          resumeCursor?: unknown;
-          threadId?: string;
-        };
-        assert.equal(startPayload.provider, "codex");
-        assert.equal(startPayload.cwd, "/tmp/project-send-turn");
-        assert.deepEqual(startPayload.resumeCursor, initial.resumeCursor);
-        assert.equal(startPayload.threadId, initial.threadId);
-      }
-      assert.equal(routing.codex.sendTurn.mock.calls.length, 1);
-    }),
-  );
-
-  it.effect("recovers stale claudeAgent sessions for sendTurn using persisted cwd", () =>
-    Effect.gen(function* () {
-      const provider = yield* ProviderService.ProviderService;
-
-      const initial = yield* provider.startSession(asThreadId("thread-claude-send-turn"), {
-        provider: ProviderDriverKind.make("claudeAgent"),
-        providerInstanceId: claudeAgentInstanceId,
-        threadId: asThreadId("thread-claude-send-turn"),
-        cwd: "/tmp/project-claude-send-turn",
-        modelSelection: createModelSelection(
-          ProviderInstanceId.make("claudeAgent"),
-          "claude-opus-4-6",
-          [{ id: "effort", value: "max" }],
-        ),
-        runtimeMode: "full-access",
-      });
-
-      yield* routing.claude.stopAll();
-      routing.claude.startSession.mockClear();
-      routing.claude.sendTurn.mockClear();
-
-      yield* provider.sendTurn({
-        threadId: initial.threadId,
-        input: "resume with claude",
-        attachments: [],
-      });
-
-      assert.equal(routing.claude.startSession.mock.calls.length, 1);
-      const resumedStartInput = routing.claude.startSession.mock.calls[0]?.[0];
-      assert.equal(typeof resumedStartInput === "object" && resumedStartInput !== null, true);
-      if (resumedStartInput && typeof resumedStartInput === "object") {
-        const startPayload = resumedStartInput as {
-          provider?: string;
-          cwd?: string;
-          modelSelection?: unknown;
-          resumeCursor?: unknown;
-          threadId?: string;
-        };
-        assert.equal(startPayload.provider, "claudeAgent");
-        assert.equal(startPayload.cwd, "/tmp/project-claude-send-turn");
-        assert.deepEqual(
-          startPayload.modelSelection,
-          createModelSelection(ProviderInstanceId.make("claudeAgent"), "claude-opus-4-6", [
-            { id: "effort", value: "max" },
-          ]),
-        );
-        assert.deepEqual(startPayload.resumeCursor, initial.resumeCursor);
-        assert.equal(startPayload.threadId, initial.threadId);
-      }
-      assert.equal(routing.claude.sendTurn.mock.calls.length, 1);
-    }),
-  );
-
-  it.effect("lists no sessions after adapter runtime clears", () =>
-    Effect.gen(function* () {
-      const provider = yield* ProviderService.ProviderService;
-
-      yield* provider.startSession(asThreadId("thread-1"), {
-        provider: ProviderDriverKind.make("codex"),
-        providerInstanceId: codexInstanceId,
-        threadId: asThreadId("thread-1"),
-        runtimeMode: "full-access",
-      });
-      yield* provider.startSession(asThreadId("thread-2"), {
-        provider: ProviderDriverKind.make("codex"),
-        providerInstanceId: codexInstanceId,
-        threadId: asThreadId("thread-2"),
-        runtimeMode: "full-access",
-      });
-
-      yield* routing.codex.stopAll();
-      yield* routing.claude.stopAll();
-
-      const remaining = yield* provider.listSessions();
-      assert.equal(remaining.length, 0);
-    }),
-  );
-
-  it.effect("persists runtime status transitions in provider_session_runtime", () =>
-    Effect.gen(function* () {
-      const provider = yield* ProviderService.ProviderService;
-      const runtimeRepository = yield* ProviderSessionRuntime.ProviderSessionRuntimeRepository;
-
-      const threadId = asThreadId("thread-runtime-status");
-      const session = yield* provider.startSession(threadId, {
-        provider: ProviderDriverKind.make("codex"),
-        providerInstanceId: codexInstanceId,
-        threadId,
-        runtimeMode: "full-access",
-      });
-      yield* provider.sendTurn({
-        threadId: session.threadId,
-        input: "hello",
-        attachments: [],
-      });
-
-      const runningRuntime = yield* runtimeRepository.getByThreadId({
-        threadId: session.threadId,
-      });
-      assert.equal(Option.isSome(runningRuntime), true);
-      if (Option.isSome(runningRuntime)) {
-        assert.equal(runningRuntime.value.status, "running");
-        assert.deepEqual(runningRuntime.value.resumeCursor, session.resumeCursor);
-        const payload = runningRuntime.value.runtimePayload;
-        assert.equal(payload !== null && typeof payload === "object", true);
-        if (payload !== null && typeof payload === "object" && !Array.isArray(payload)) {
-          const runtimePayload = payload as {
-            cwd: string;
-            model: string | null;
-            activeTurnId: string | null;
-            lastError: string | null;
-            lastRuntimeEvent: string | null;
-          };
-          assert.equal(runtimePayload.cwd, session.cwd);
-          assert.equal(runtimePayload.model, null);
-          assert.equal(runtimePayload.activeTurnId, `turn-${String(session.threadId)}`);
-          assert.equal(runtimePayload.lastError, null);
-          assert.equal(runtimePayload.lastRuntimeEvent, "provider.sendTurn");
-        }
-      }
-    }),
-  );
-
-  it.effect("does not persist running after a concurrent send is interrupted", () =>
-    Effect.gen(function* () {
-      const provider = yield* ProviderService.ProviderService;
-      const runtimeRepository = yield* ProviderSessionRuntime.ProviderSessionRuntimeRepository;
-      const sendStarted = yield* Deferred.make<void>();
-      const interrupted = yield* Deferred.make<void>();
-      routing.codex.sendTurn.mockImplementationOnce(() =>
-        Effect.gen(function* () {
-          yield* Deferred.succeed(sendStarted, undefined);
-          yield* Deferred.await(interrupted);
-          return yield* Effect.interrupt;
-        }),
-      );
-      routing.codex.interruptTurn.mockImplementationOnce(() =>
-        Deferred.succeed(interrupted, undefined).pipe(Effect.asVoid),
-      );
-
-      const threadId = asThreadId("thread-interrupted-send-directory");
-      const session = yield* provider.startSession(threadId, {
-        provider: ProviderDriverKind.make("codex"),
-        providerInstanceId: codexInstanceId,
-        threadId,
-        runtimeMode: "full-access",
-      });
-      const sendExitFiber = yield* provider
-        .sendTurn({
-          threadId: session.threadId,
-          input: "hold this prompt",
-          attachments: [],
-        })
-        .pipe(Effect.exit, Effect.forkChild);
-      yield* Deferred.await(sendStarted);
-      yield* provider.interruptTurn({ threadId: session.threadId });
-      const sendExit = yield* Fiber.join(sendExitFiber);
-
-      assert.equal(Exit.isFailure(sendExit), true);
-      if (Exit.isFailure(sendExit)) {
-        assert.equal(Cause.hasInterruptsOnly(sendExit.cause), true);
-      }
-      const persisted = yield* runtimeRepository.getByThreadId({
-        threadId: session.threadId,
-      });
-      assert.equal(Option.isSome(persisted), true);
-      if (Option.isSome(persisted)) {
-        // The directory folds both adapter "ready" and "running" into its
-        // runtime "running" state. The payload proves sendTurn did not upsert.
-        assert.equal(persisted.value.status, "running");
-        const payload = persisted.value.runtimePayload;
-        assert.equal(payload !== null && typeof payload === "object", true);
-        if (payload !== null && typeof payload === "object" && !Array.isArray(payload)) {
-          const runtimePayload = payload as {
-            activeTurnId?: string | null;
-            lastRuntimeEvent?: string | null;
-          };
-          assert.equal(runtimePayload.activeTurnId ?? null, null);
-          assert.notEqual(runtimePayload.lastRuntimeEvent, "provider.sendTurn");
-        }
-      }
-    }),
-  );
-
-  it.effect("reuses persisted resume cursor when startSession is called after a restart", () =>
-    Effect.gen(function* () {
-      const tempDir = NodeFS.mkdtempSync(
-        NodePath.join(NodeOS.tmpdir(), "t3-provider-service-start-"),
-      );
-      const dbPath = NodePath.join(tempDir, "orchestration.sqlite");
-      const persistenceLayer = makeSqlitePersistenceLive(dbPath);
-      const runtimeRepositoryLayer = ProviderSessionRuntime.layer.pipe(
-        Layer.provide(persistenceLayer),
-      );
-
-      const firstClaude = makeFakeCodexAdapter(CLAUDE_AGENT_DRIVER);
-      const firstRegistry = makeAdapterRegistryMock({
-        [ProviderDriverKind.make("claudeAgent")]: firstClaude.adapter,
-      });
-      const firstDirectoryLayer = ProviderSessionDirectoryLive.pipe(
-        Layer.provide(runtimeRepositoryLayer),
-      );
-      const firstProviderLayer = makeProviderServiceLive().pipe(
-        Layer.provide(
-          Layer.succeed(ProviderAdapterRegistry.ProviderAdapterRegistry, firstRegistry),
-        ),
-        Layer.provide(firstDirectoryLayer),
-        Layer.provide(defaultServerSettingsLayer),
-        Layer.provide(serverConfigTestLayer),
-        Layer.provide(AnalyticsService.layerTest),
-        Layer.provide(
-          Layer.succeed(
-            ProviderEventLoggers.ProviderEventLoggers,
-            ProviderEventLoggers.NoOpProviderEventLoggers,
-          ),
-        ),
-      );
-
-      const initial = yield* Effect.gen(function* () {
-        const provider = yield* ProviderService.ProviderService;
-        return yield* provider.startSession(asThreadId("thread-claude-start"), {
-          provider: ProviderDriverKind.make("claudeAgent"),
-          providerInstanceId: claudeAgentInstanceId,
-          threadId: asThreadId("thread-claude-start"),
-          cwd: "/tmp/project-claude-start",
-          runtimeMode: "full-access",
-        });
-      }).pipe(Effect.provide(firstProviderLayer));
-
-      yield* Effect.gen(function* () {
-        const provider = yield* ProviderService.ProviderService;
-        yield* provider.listSessions();
-      }).pipe(Effect.provide(firstProviderLayer));
-
-      const secondClaude = makeFakeCodexAdapter(CLAUDE_AGENT_DRIVER);
-      const secondRegistry = makeAdapterRegistryMock({
-        [ProviderDriverKind.make("claudeAgent")]: secondClaude.adapter,
-      });
-      const secondDirectoryLayer = ProviderSessionDirectoryLive.pipe(
-        Layer.provide(runtimeRepositoryLayer),
-      );
-      const secondProviderLayer = makeProviderServiceLive().pipe(
-        Layer.provide(
-          Layer.succeed(ProviderAdapterRegistry.ProviderAdapterRegistry, secondRegistry),
-        ),
-        Layer.provide(secondDirectoryLayer),
-        Layer.provide(defaultServerSettingsLayer),
-        Layer.provide(serverConfigTestLayer),
-        Layer.provide(AnalyticsService.layerTest),
-        Layer.provide(
-          Layer.succeed(
-            ProviderEventLoggers.ProviderEventLoggers,
-            ProviderEventLoggers.NoOpProviderEventLoggers,
-          ),
-        ),
-      );
-
-      secondClaude.startSession.mockClear();
-
-      yield* Effect.gen(function* () {
-        const provider = yield* ProviderService.ProviderService;
-        yield* provider.startSession(initial.threadId, {
-          provider: ProviderDriverKind.make("claudeAgent"),
-          providerInstanceId: claudeAgentInstanceId,
-          threadId: initial.threadId,
-          cwd: "/tmp/project-claude-start",
-          runtimeMode: "full-access",
-        });
-      }).pipe(Effect.provide(secondProviderLayer));
-
-      assert.equal(secondClaude.startSession.mock.calls.length, 1);
-      const resumedStartInput = secondClaude.startSession.mock.calls[0]?.[0];
-      assert.equal(typeof resumedStartInput === "object" && resumedStartInput !== null, true);
-      if (resumedStartInput && typeof resumedStartInput === "object") {
-        const startPayload = resumedStartInput as {
-          provider?: string;
-          cwd?: string;
-          resumeCursor?: unknown;
-          threadId?: string;
-        };
-        assert.equal(startPayload.provider, "claudeAgent");
-        assert.equal(startPayload.cwd, "/tmp/project-claude-start");
-        assert.deepEqual(startPayload.resumeCursor, initial.resumeCursor);
-        assert.equal(startPayload.threadId, initial.threadId);
-      }
-
-      NodeFS.rmSync(tempDir, { recursive: true, force: true });
-    }).pipe(Effect.provide(NodeServices.layer)),
-  );
-
-  it.effect(
-    "reuses persisted cwd when startSession resumes a claude session without cwd input",
-    () =>
-      Effect.gen(function* () {
-        const tempDir = NodeFS.mkdtempSync(
-          NodePath.join(NodeOS.tmpdir(), "t3-provider-service-cwd-"),
-        );
-        const dbPath = NodePath.join(tempDir, "orchestration.sqlite");
-        const persistenceLayer = makeSqlitePersistenceLive(dbPath);
-        const runtimeRepositoryLayer = ProviderSessionRuntime.layer.pipe(
-          Layer.provide(persistenceLayer),
-        );
-
-        const firstClaude = makeFakeCodexAdapter(CLAUDE_AGENT_DRIVER);
-        const firstRegistry = makeAdapterRegistryMock({
-          [ProviderDriverKind.make("claudeAgent")]: firstClaude.adapter,
-        });
-        const firstDirectoryLayer = ProviderSessionDirectoryLive.pipe(
-          Layer.provide(runtimeRepositoryLayer),
-        );
-        const firstProviderLayer = makeProviderServiceLive().pipe(
-          Layer.provide(
-            Layer.succeed(ProviderAdapterRegistry.ProviderAdapterRegistry, firstRegistry),
-          ),
-          Layer.provide(firstDirectoryLayer),
-          Layer.provide(defaultServerSettingsLayer),
-          Layer.provide(serverConfigTestLayer),
-          Layer.provide(AnalyticsService.layerTest),
-          Layer.provide(
-            Layer.succeed(
-              ProviderEventLoggers.ProviderEventLoggers,
-              ProviderEventLoggers.NoOpProviderEventLoggers,
-            ),
-          ),
-        );
-
-        const initial = yield* Effect.gen(function* () {
-          const provider = yield* ProviderService.ProviderService;
-          return yield* provider.startSession(asThreadId("thread-claude-cwd"), {
-            provider: ProviderDriverKind.make("claudeAgent"),
-            providerInstanceId: claudeAgentInstanceId,
-            threadId: asThreadId("thread-claude-cwd"),
-            cwd: "/tmp/project-claude-cwd",
-            runtimeMode: "full-access",
-          });
-        }).pipe(Effect.provide(firstProviderLayer));
-
-        const secondClaude = makeFakeCodexAdapter(CLAUDE_AGENT_DRIVER);
-        const secondRegistry = makeAdapterRegistryMock({
-          [ProviderDriverKind.make("claudeAgent")]: secondClaude.adapter,
-        });
-        const secondDirectoryLayer = ProviderSessionDirectoryLive.pipe(
-          Layer.provide(runtimeRepositoryLayer),
-        );
-        const secondProviderLayer = makeProviderServiceLive().pipe(
-          Layer.provide(
-            Layer.succeed(ProviderAdapterRegistry.ProviderAdapterRegistry, secondRegistry),
-          ),
-          Layer.provide(secondDirectoryLayer),
-          Layer.provide(defaultServerSettingsLayer),
-          Layer.provide(serverConfigTestLayer),
-          Layer.provide(AnalyticsService.layerTest),
-          Layer.provide(
-            Layer.succeed(
-              ProviderEventLoggers.ProviderEventLoggers,
-              ProviderEventLoggers.NoOpProviderEventLoggers,
-            ),
-          ),
-        );
-
-        secondClaude.startSession.mockClear();
-
-        yield* Effect.gen(function* () {
-          const provider = yield* ProviderService.ProviderService;
-          yield* provider.startSession(initial.threadId, {
-            provider: ProviderDriverKind.make("claudeAgent"),
-            providerInstanceId: claudeAgentInstanceId,
-            threadId: initial.threadId,
-            runtimeMode: "full-access",
-          });
-        }).pipe(Effect.provide(secondProviderLayer));
-
-        assert.equal(secondClaude.startSession.mock.calls.length, 1);
-        const resumedStartInput = secondClaude.startSession.mock.calls[0]?.[0];
-        assert.equal(typeof resumedStartInput === "object" && resumedStartInput !== null, true);
-        if (resumedStartInput && typeof resumedStartInput === "object") {
-          const startPayload = resumedStartInput as {
-            provider?: string;
-            cwd?: string;
-            resumeCursor?: unknown;
-            threadId?: string;
-          };
-          assert.equal(startPayload.provider, "claudeAgent");
-          assert.equal(startPayload.cwd, "/tmp/project-claude-cwd");
-          assert.deepEqual(startPayload.resumeCursor, initial.resumeCursor);
-          assert.equal(startPayload.threadId, initial.threadId);
-        }
-
-        NodeFS.rmSync(tempDir, { recursive: true, force: true });
-      }).pipe(Effect.provide(NodeServices.layer)),
-  );
-});
-
-const fanout = makeProviderServiceLayer();
-fanout.layer("ProviderServiceLive fanout", (it) => {
-  it.effect("fans out adapter turn completion events", () =>
-    Effect.gen(function* () {
-      const provider = yield* ProviderService.ProviderService;
-      const session = yield* provider.startSession(asThreadId("thread-1"), {
-        provider: ProviderDriverKind.make("codex"),
-        providerInstanceId: codexInstanceId,
-        threadId: asThreadId("thread-1"),
-        runtimeMode: "full-access",
-      });
-
-      const eventsRef = yield* Ref.make<Array<ProviderRuntimeEvent>>([]);
-      const consumer = yield* Stream.runForEach(provider.streamEvents, (event) =>
-        Ref.update(eventsRef, (current) => [...current, event]),
-      ).pipe(Effect.forkChild);
-      yield* advanceTestClock(50);
-
-      const completedEvent: LegacyProviderRuntimeEvent = {
-        type: "turn.completed",
-        eventId: asEventId("evt-1"),
-        provider: ProviderDriverKind.make("codex"),
-        createdAt: "2026-01-01T00:00:00.000Z",
-        threadId: session.threadId,
-        turnId: asTurnId("turn-1"),
-        status: "completed",
-      };
-
-      fanout.codex.emit(completedEvent);
-      yield* advanceTestClock(50);
-
-      const events = yield* Ref.get(eventsRef);
-      yield* Fiber.interrupt(consumer);
-
-      assert.equal(
-        events.some((entry) => entry.type === "turn.completed"),
-        true,
-      );
-      assert.equal(
-        events.some(
-          (entry) =>
-            entry.type === "turn.completed" && entry.providerInstanceId === codexInstanceId,
-        ),
-        true,
-      );
-    }),
-  );
-
-  it.effect("fans out canonical runtime events in emission order", () =>
-    Effect.gen(function* () {
-      const provider = yield* ProviderService.ProviderService;
-      const session = yield* provider.startSession(asThreadId("thread-seq"), {
-        provider: ProviderDriverKind.make("codex"),
-        providerInstanceId: codexInstanceId,
-        threadId: asThreadId("thread-seq"),
-        runtimeMode: "full-access",
-      });
-
-      const receivedRef = yield* Ref.make<Array<ProviderRuntimeEvent>>([]);
-      const consumer = yield* Stream.take(provider.streamEvents, 3).pipe(
-        Stream.runForEach((event) => Ref.update(receivedRef, (current) => [...current, event])),
-        Effect.forkChild,
-      );
-      yield* advanceTestClock(50);
-
-      fanout.codex.emit({
-        type: "tool.started",
-        eventId: asEventId("evt-seq-1"),
-        provider: ProviderDriverKind.make("codex"),
-        createdAt: "2026-01-01T00:00:00.000Z",
-        threadId: session.threadId,
-        turnId: asTurnId("turn-1"),
-        toolKind: "command",
-        title: "Ran command",
-      });
-      fanout.codex.emit({
-        type: "tool.completed",
-        eventId: asEventId("evt-seq-2"),
-        provider: ProviderDriverKind.make("codex"),
-        createdAt: "2026-01-01T00:00:00.000Z",
-        threadId: session.threadId,
-        turnId: asTurnId("turn-1"),
-        toolKind: "command",
-        title: "Ran command",
-      });
-      fanout.codex.emit({
-        type: "turn.completed",
-        eventId: asEventId("evt-seq-3"),
-        provider: ProviderDriverKind.make("codex"),
-        createdAt: "2026-01-01T00:00:00.000Z",
-        threadId: session.threadId,
-        turnId: asTurnId("turn-1"),
-        status: "completed",
-      });
-
-      yield* Fiber.join(consumer);
-      const received = yield* Ref.get(receivedRef);
-      assert.deepEqual(
-        received.map((event) => event.eventId),
-        [asEventId("evt-seq-1"), asEventId("evt-seq-2"), asEventId("evt-seq-3")],
-      );
-    }),
-  );
-
-  it.effect("keeps subscriber delivery ordered and isolates failing subscribers", () =>
-    Effect.gen(function* () {
-      const provider = yield* ProviderService.ProviderService;
-      const session = yield* provider.startSession(asThreadId("thread-1"), {
-        provider: ProviderDriverKind.make("codex"),
-        providerInstanceId: codexInstanceId,
-        threadId: asThreadId("thread-1"),
-        runtimeMode: "full-access",
-      });
-
-      const receivedByHealthy: string[] = [];
-      const expectedEventIds = new Set<string>(["evt-ordered-1", "evt-ordered-2", "evt-ordered-3"]);
-      const healthyFiber = yield* Stream.take(provider.streamEvents, 3).pipe(
-        Stream.runForEach((event) =>
-          Effect.sync(() => {
-            receivedByHealthy.push(event.eventId);
-          }),
-        ),
-        Effect.forkChild,
-      );
-      const failingFiber = yield* Stream.take(provider.streamEvents, 1).pipe(
-        Stream.runForEach(() => Effect.fail("listener crash")),
-        Effect.forkChild,
-      );
-      yield* advanceTestClock(50);
-
-      const events: ReadonlyArray<LegacyProviderRuntimeEvent> = [
-        {
-          type: "tool.completed",
-          eventId: asEventId("evt-ordered-1"),
-          provider: ProviderDriverKind.make("codex"),
-          createdAt: "2026-01-01T00:00:00.000Z",
-          threadId: session.threadId,
-          turnId: asTurnId("turn-1"),
-          toolKind: "command",
-          title: "Ran command",
-          detail: "echo one",
-        },
-        {
-          type: "message.delta",
-          eventId: asEventId("evt-ordered-2"),
-          provider: ProviderDriverKind.make("codex"),
-          createdAt: "2026-01-01T00:00:00.000Z",
-          threadId: session.threadId,
-          turnId: asTurnId("turn-1"),
-          delta: "hello",
-        },
-        {
-          type: "turn.completed",
-          eventId: asEventId("evt-ordered-3"),
-          provider: ProviderDriverKind.make("codex"),
-          createdAt: "2026-01-01T00:00:00.000Z",
-          threadId: session.threadId,
-          turnId: asTurnId("turn-1"),
-          status: "completed",
-        },
-      ];
-
-      for (const event of events) {
-        fanout.codex.emit(event);
-      }
-      const failingResult = yield* Effect.result(Fiber.join(failingFiber));
-      assert.equal(failingResult._tag, "Failure");
-      yield* Fiber.join(healthyFiber);
-
-      assert.deepEqual(
-        receivedByHealthy.filter((eventId) => expectedEventIds.has(eventId)).slice(0, 3),
-        ["evt-ordered-1", "evt-ordered-2", "evt-ordered-3"],
-      );
-    }),
-  );
-
-  it.effect("records provider metrics with the routed provider label", () =>
-    Effect.gen(function* () {
-      const provider = yield* ProviderService.ProviderService;
-
-      const session = yield* provider.startSession(asThreadId("thread-metrics"), {
-        provider: ProviderDriverKind.make("claudeAgent"),
-        providerInstanceId: claudeAgentInstanceId,
-        threadId: asThreadId("thread-metrics"),
-        cwd: "/tmp/project",
-        runtimeMode: "full-access",
-      });
-
-      yield* provider.interruptTurn({ threadId: session.threadId });
-      yield* provider.respondToRequest({
-        threadId: session.threadId,
-        requestId: asRequestId("req-metrics-1"),
-        decision: "accept",
-      });
-      yield* provider.respondToUserInput({
-        threadId: session.threadId,
-        requestId: asRequestId("req-metrics-2"),
-        answers: {
-          sandbox_mode: "workspace-write",
-        },
-      });
-      yield* provider.rollbackConversation({
-        threadId: session.threadId,
-        numTurns: 1,
-      });
-      yield* provider.stopSession({ threadId: session.threadId });
-
-      const snapshots = yield* Metric.snapshot;
-
-      assert.equal(
-        hasMetricSnapshot(snapshots, "t3_provider_turns_total", {
-          provider: ProviderDriverKind.make("claudeAgent"),
-          operation: "interrupt",
-          outcome: "success",
-        }),
-        true,
-      );
-      assert.equal(
-        hasMetricSnapshot(snapshots, "t3_provider_turns_total", {
-          provider: ProviderDriverKind.make("claudeAgent"),
-          operation: "approval-response",
-          outcome: "success",
-        }),
-        true,
-      );
-      assert.equal(
-        hasMetricSnapshot(snapshots, "t3_provider_turns_total", {
-          provider: ProviderDriverKind.make("claudeAgent"),
-          operation: "user-input-response",
-          outcome: "success",
-        }),
-        true,
-      );
-      assert.equal(
-        hasMetricSnapshot(snapshots, "t3_provider_turns_total", {
-          provider: ProviderDriverKind.make("claudeAgent"),
-          operation: "rollback",
-          outcome: "success",
-        }),
-        true,
-      );
-      assert.equal(
-        hasMetricSnapshot(snapshots, "t3_provider_sessions_total", {
-          provider: ProviderDriverKind.make("claudeAgent"),
-          operation: "stop",
-          outcome: "success",
-        }),
-        true,
-      );
-    }),
-  );
-
-  it.effect(
-    "records sendTurn metrics with the resolved provider when modelSelection is omitted",
-    () =>
-      Effect.gen(function* () {
-        const provider = yield* ProviderService.ProviderService;
-
-        const session = yield* provider.startSession(asThreadId("thread-send-metrics"), {
-          provider: ProviderDriverKind.make("claudeAgent"),
-          providerInstanceId: claudeAgentInstanceId,
-          threadId: asThreadId("thread-send-metrics"),
-          cwd: "/tmp/project-send-metrics",
-          runtimeMode: "full-access",
-        });
-
-        yield* provider.sendTurn({
-          threadId: session.threadId,
-          input: "hello",
-          attachments: [],
-        });
-
-        const snapshots = yield* Metric.snapshot;
-
-        assert.equal(
-          hasMetricSnapshot(snapshots, "t3_provider_turns_total", {
-            provider: ProviderDriverKind.make("claudeAgent"),
-            operation: "send",
-            outcome: "success",
-          }),
-          true,
-        );
-        assert.equal(
-          hasMetricSnapshot(snapshots, "t3_provider_turn_duration", {
-            provider: ProviderDriverKind.make("claudeAgent"),
-            operation: "send",
-          }),
-          true,
-        );
-      }),
-  );
-});
-
-const validation = makeProviderServiceLayer();
-validation.layer("ProviderServiceLive validation", (it) => {
-  it.effect("rejects session starts without an explicit provider instance id", () =>
-    Effect.gen(function* () {
-      const provider = yield* ProviderService.ProviderService;
-
-      validation.codex.startSession.mockClear();
-      const failure = yield* Effect.flip(
-        provider.startSession(asThreadId("thread-missing-instance-id"), {
-          provider: ProviderDriverKind.make("codex"),
-          threadId: asThreadId("thread-missing-instance-id"),
-          runtimeMode: "full-access",
-        }),
-      );
-
-      assert.instanceOf(failure, ProviderValidationError);
-      assert.include(failure.issue, "Provider instance id is required for provider 'codex'.");
-      assert.equal(validation.codex.startSession.mock.calls.length, 0);
-    }),
-  );
-
-  it.effect("rejects mismatched provider kind and provider instance id", () =>
-    Effect.gen(function* () {
-      const provider = yield* ProviderService.ProviderService;
-
-      validation.codex.startSession.mockClear();
-      validation.claude.startSession.mockClear();
-      const failure = yield* Effect.flip(
-        provider.startSession(asThreadId("thread-instance-mismatch"), {
-          provider: ProviderDriverKind.make("codex"),
-          providerInstanceId: claudeAgentInstanceId,
-          threadId: asThreadId("thread-instance-mismatch"),
-          runtimeMode: "full-access",
-        }),
-      );
-
-      assert.instanceOf(failure, ProviderValidationError);
-      assert.include(
-        failure.issue,
-        "Provider instance 'claudeAgent' belongs to driver 'claudeAgent', not 'codex'.",
-      );
-      assert.equal(validation.codex.startSession.mock.calls.length, 0);
-      assert.equal(validation.claude.startSession.mock.calls.length, 0);
-    }),
-  );
-
-  it.effect("returns ProviderValidationError for invalid input payloads", () =>
-    Effect.gen(function* () {
-      const provider = yield* ProviderService.ProviderService;
-
-      const failure = yield* Effect.result(
-        provider.startSession(asThreadId("thread-validation"), {
-          threadId: asThreadId("thread-validation"),
-          provider: "invalid-provider",
-          runtimeMode: "full-access",
-        } as never),
-      );
-
-      assert.equal(failure._tag, "Failure");
-      if (failure._tag !== "Failure") {
-        return;
-      }
-      assert.equal(failure.failure._tag, "ProviderValidationError");
-      if (failure.failure._tag !== "ProviderValidationError") {
-        return;
-      }
-      assert.equal(failure.failure.operation, "ProviderService.startSession");
-      assert.equal(failure.failure.issue.includes("invalid-provider"), true);
-    }),
-  );
-
-  it.effect("accepts startSession when adapter has not emitted provider thread id yet", () =>
-    Effect.gen(function* () {
-      const provider = yield* ProviderService.ProviderService;
-      const runtimeRepository = yield* ProviderSessionRuntime.ProviderSessionRuntimeRepository;
-
-      validation.codex.startSession.mockImplementationOnce((input: ProviderSessionStartInput) =>
-        Effect.sync(() => {
-          const now = "2026-01-01T00:00:00.000Z";
-          return {
-            provider: ProviderDriverKind.make("codex"),
-            status: "ready",
-            threadId: input.threadId,
-            runtimeMode: input.runtimeMode,
-            cwd: input.cwd ?? process.cwd(),
-            createdAt: now,
-            updatedAt: now,
-          } satisfies ProviderSession;
-        }),
-      );
-
-      const session = yield* provider.startSession(asThreadId("thread-missing"), {
-        provider: ProviderDriverKind.make("codex"),
-        providerInstanceId: codexInstanceId,
-        threadId: asThreadId("thread-missing"),
-        cwd: "/tmp/project",
-        runtimeMode: "full-access",
-      });
-
-      assert.equal(session.threadId, asThreadId("thread-missing"));
-
-      const runtime = yield* runtimeRepository.getByThreadId({
-        threadId: session.threadId,
-      });
-      assert.equal(Option.isSome(runtime), true);
-      if (Option.isSome(runtime)) {
-        assert.equal(runtime.value.threadId, session.threadId);
-      }
-    }),
-  );
-});
-
-describe("agent browser access", () => {
-  const revokedThreads: Array<ThreadId> = [];
-
-  const startSessionWith = (enableAgentBrowserAccess: boolean, threadId: ThreadId) =>
-    Effect.gen(function* () {
-      const issued: Array<ThreadId> = [];
-      const codex = makeFakeCodexAdapter();
-      const providerAdapterLayer = Layer.succeed(
-        ProviderAdapterRegistry.ProviderAdapterRegistry,
-        makeAdapterRegistryMock({ [CODEX_DRIVER]: codex.adapter }),
-      );
-      const runtimeRepositoryLayer = ProviderSessionRuntime.layer.pipe(
-        Layer.provide(SqlitePersistenceMemory),
-      );
-      const directoryLayer = ProviderSessionDirectoryLive.pipe(
-        Layer.provide(runtimeRepositoryLayer),
-      );
-      const providerLayer = makeProviderServiceLive({
-        issueMcpCredential: (request) =>
-          Effect.sync(() => {
-            issued.push(request.threadId);
-            return undefined;
-          }),
-        revokeMcpCredential: (revoked) => Effect.sync(() => void revokedThreads.push(revoked)),
-      }).pipe(
-        Layer.provide(providerAdapterLayer),
-        Layer.provide(directoryLayer),
-        Layer.provide(ServerSettings.ServerSettingsService.layerTest({ enableAgentBrowserAccess })),
-        Layer.provide(serverConfigTestLayer),
-        Layer.provide(AnalyticsService.layerTest),
-        Layer.provide(
-          Layer.succeed(
-            ProviderEventLoggers.ProviderEventLoggers,
-            ProviderEventLoggers.NoOpProviderEventLoggers,
-          ),
-        ),
-      );
-
-      yield* Effect.gen(function* () {
-        const provider = yield* ProviderService.ProviderService;
-        return yield* provider.startSession(threadId, {
-          provider: CODEX_DRIVER,
-          providerInstanceId: codexInstanceId,
-          threadId,
-          runtimeMode: "full-access",
-        });
-      }).pipe(Effect.provide(providerLayer));
-
-      return issued;
-    });
-
-  // Credential issuance is the observable that matters: it is the only place a
-  // credential is minted, and `/mcp` accepts nothing else, so withholding it is
-  // what actually denies every provider and external MCP client.
-  it.effect("requests no MCP credential when agent browser access is off", () =>
-    Effect.gen(function* () {
-      const issued = yield* startSessionWith(false, asThreadId("thread-browser-off"));
-
-      assert.deepEqual(issued, []);
-    }).pipe(Effect.provide(NodeServices.layer)),
-  );
-
-  it.effect("revokes an already-issued credential when access is off", () =>
-    Effect.gen(function* () {
-      const threadId = asThreadId("thread-browser-revoke");
-      revokedThreads.length = 0;
-
-      yield* startSessionWith(false, threadId);
-
-      // Clearing the in-memory map is not enough: a token issued before the
-      // toggle flipped stays valid against `/mcp` for its whole liveness
-      // window, and later turns refresh it.
-      assert.deepEqual(revokedThreads, [threadId]);
-    }).pipe(Effect.provide(NodeServices.layer)),
-  );
-
-  it.effect("requests an MCP credential when agent browser access is on", () =>
-    Effect.gen(function* () {
-      const threadId = asThreadId("thread-browser-on");
-
-      const issued = yield* startSessionWith(true, threadId);
-
-      assert.deepEqual(issued, [threadId]);
-    }).pipe(Effect.provide(NodeServices.layer)),
-  );
-});
diff --git a/apps/server/src/provider/Layers/ProviderService.ts b/apps/server/src/provider/Layers/ProviderService.ts
deleted file mode 100644
index 38928c159c86..000000000000
--- a/apps/server/src/provider/Layers/ProviderService.ts
+++ /dev/null
@@ -1,1248 +0,0 @@
-/**
- * ProviderServiceLive - Cross-provider orchestration layer.
- *
- * Routes validated transport/API calls to provider adapters through
- * `ProviderAdapterRegistry` and `ProviderSessionDirectory`, and exposes a
- * unified provider event stream for subscribers.
- *
- * It does not implement provider protocol details (adapter concern).
- *
- * @module ProviderServiceLive
- */
-import {
-  ModelSelection,
-  NonNegativeInt,
-  ThreadId,
-  ProviderInterruptTurnInput,
-  ProviderRespondToRequestInput,
-  ProviderRespondToUserInputInput,
-  ProviderSendTurnInput,
-  ProviderSessionStartInput,
-  ProviderStopSessionInput,
-  ProviderUploadFeedbackInput,
-  type ProviderInstanceId,
-  type ProviderDriverKind,
-  type ProviderRuntimeEvent,
-  type ProviderSession,
-} from "@t3tools/contracts";
-import { causeErrorTag } from "@t3tools/shared/observability";
-import * as DateTime from "effect/DateTime";
-import * as Effect from "effect/Effect";
-import * as Layer from "effect/Layer";
-import * as Option from "effect/Option";
-import * as PubSub from "effect/PubSub";
-import * as Ref from "effect/Ref";
-import * as Schema from "effect/Schema";
-import * as SchemaIssue from "effect/SchemaIssue";
-import * as Stream from "effect/Stream";
-
-import { resolveAttachmentPath } from "../../attachmentStore.ts";
-import * as ServerConfig from "../../config.ts";
-import {
-  increment,
-  providerMetricAttributes,
-  providerRuntimeEventsTotal,
-  providerSessionsTotal,
-  providerTurnDuration,
-  providerTurnsTotal,
-  providerTurnMetricAttributes,
-  withMetrics,
-} from "../../observability/Metrics.ts";
-import { type ProviderAdapterError, ProviderValidationError } from "../Errors.ts";
-import type { ProviderAdapterShape } from "../Services/ProviderAdapter.ts";
-import * as ProviderAdapterRegistry from "../Services/ProviderAdapterRegistry.ts";
-import * as ProviderService from "../Services/ProviderService.ts";
-import * as ProviderSessionDirectory from "../Services/ProviderSessionDirectory.ts";
-import { type EventNdjsonLogger } from "./EventNdjsonLogger.ts";
-import * as ProviderEventLoggers from "./ProviderEventLoggers.ts";
-import * as AnalyticsService from "../../telemetry/AnalyticsService.ts";
-import * as McpProviderSession from "../../mcp/McpProviderSession.ts";
-import * as McpSessionRegistry from "../../mcp/McpSessionRegistry.ts";
-import * as ServerSettings from "../../serverSettings.ts";
-const isModelSelection = Schema.is(ModelSelection);
-
-/**
- * Hook for tests that want to override the canonical event logger pulled
- * from `ProviderEventLoggers`. Production wiring leaves this undefined and
- * reads the logger off the tag.
- */
-export interface ProviderServiceLiveOptions {
-  readonly canonicalEventLogger?: EventNdjsonLogger;
-  /**
-   * Overrides MCP credential issuance. The real issuer reads a module-global
-   * registry that only a running MCP server installs, which makes the
-   * agent-browser-access gate unobservable from a unit test; this seam lets a
-   * test see whether a credential was requested at all.
-   */
-  readonly issueMcpCredential?: typeof McpSessionRegistry.issueActiveMcpCredential;
-  /** Same seam as `issueMcpCredential`, for observing the deny path's revoke. */
-  readonly revokeMcpCredential?: typeof McpSessionRegistry.revokeActiveMcpThread;
-}
-
-type ProviderServiceMethod<Name extends keyof ProviderService.ProviderService["Service"]> =
-  ProviderService.ProviderService["Service"][Name];
-
-const ProviderRollbackConversationInput = Schema.Struct({
-  threadId: ThreadId,
-  numTurns: NonNegativeInt,
-});
-
-function toValidationError(
-  operation: string,
-  issue: string,
-  cause?: unknown,
-): ProviderValidationError {
-  return new ProviderValidationError({
-    operation,
-    issue,
-    ...(cause !== undefined ? { cause } : {}),
-  });
-}
-
-const decodeInputOrValidationError = <S extends Schema.Top>(input: {
-  readonly operation: string;
-  readonly schema: S;
-  readonly payload: unknown;
-}) => {
-  const decodeProviderRequestInput = Schema.decodeUnknownEffect(input.schema);
-  return decodeProviderRequestInput(input.payload).pipe(
-    Effect.mapError(
-      (schemaError) =>
-        new ProviderValidationError({
-          operation: input.operation,
-          issue: SchemaIssue.makeFormatterDefault()(schemaError.issue),
-          cause: schemaError,
-        }),
-    ),
-  );
-};
-
-function toRuntimeStatus(session: ProviderSession): "starting" | "running" | "stopped" | "error" {
-  switch (session.status) {
-    case "connecting":
-      return "starting";
-    case "error":
-      return "error";
-    case "closed":
-      return "stopped";
-    case "ready":
-    case "running":
-    default:
-      return "running";
-  }
-}
-
-function toRuntimePayloadFromSession(
-  session: ProviderSession,
-  extra?: {
-    readonly modelSelection?: unknown;
-    readonly lastRuntimeEvent?: string;
-    readonly lastRuntimeEventAt?: string;
-  },
-): Record<string, unknown> {
-  return {
-    cwd: session.cwd ?? null,
-    model: session.model ?? null,
-    activeTurnId: session.activeTurnId ?? null,
-    lastError: session.lastError ?? null,
-    ...(extra?.modelSelection !== undefined ? { modelSelection: extra.modelSelection } : {}),
-    ...(extra?.lastRuntimeEvent !== undefined ? { lastRuntimeEvent: extra.lastRuntimeEvent } : {}),
-    ...(extra?.lastRuntimeEventAt !== undefined
-      ? { lastRuntimeEventAt: extra.lastRuntimeEventAt }
-      : {}),
-  };
-}
-
-function readPersistedModelSelection(
-  runtimePayload: ProviderSessionDirectory.ProviderRuntimeBinding["runtimePayload"],
-): ModelSelection | undefined {
-  if (!runtimePayload || typeof runtimePayload !== "object" || Array.isArray(runtimePayload)) {
-    return undefined;
-  }
-  const raw = "modelSelection" in runtimePayload ? runtimePayload.modelSelection : undefined;
-  return isModelSelection(raw) ? raw : undefined;
-}
-
-function readPersistedCwd(
-  runtimePayload: ProviderSessionDirectory.ProviderRuntimeBinding["runtimePayload"],
-): string | undefined {
-  if (!runtimePayload || typeof runtimePayload !== "object" || Array.isArray(runtimePayload)) {
-    return undefined;
-  }
-  const rawCwd = "cwd" in runtimePayload ? runtimePayload.cwd : undefined;
-  if (typeof rawCwd !== "string") return undefined;
-  const trimmed = rawCwd.trim();
-  return trimmed.length > 0 ? trimmed : undefined;
-}
-
-const dieOnMissingBindingInstanceId = (
-  operation: string,
-  payload: {
-    readonly providerInstanceId?: ProviderInstanceId | undefined;
-    readonly provider?: ProviderDriverKind | undefined;
-  },
-): ProviderInstanceId => {
-  if (payload.providerInstanceId !== undefined) {
-    return payload.providerInstanceId;
-  }
-  throw new Error(
-    payload.provider
-      ? `${operation}: provider instance id is required for provider '${payload.provider}'.`
-      : `${operation}: provider instance id is required.`,
-  );
-};
-
-const correlateRuntimeEventWithInstance = (
-  source: {
-    readonly instanceId: ProviderInstanceId;
-    readonly provider: ProviderDriverKind;
-  },
-  event: ProviderRuntimeEvent,
-): ProviderRuntimeEvent => {
-  if (event.provider !== source.provider) {
-    throw new Error(
-      `ProviderService.streamEvents: provider instance '${source.instanceId}' is backed by driver '${source.provider}' but emitted driver '${event.provider}'.`,
-    );
-  }
-  if (event.providerInstanceId !== undefined && event.providerInstanceId !== source.instanceId) {
-    throw new Error(
-      `ProviderService.streamEvents: provider instance '${source.instanceId}' emitted event for instance '${event.providerInstanceId}'.`,
-    );
-  }
-  return { ...event, providerInstanceId: source.instanceId };
-};
-
-const makeProviderService = Effect.fn("makeProviderService")(function* (
-  options?: ProviderServiceLiveOptions,
-) {
-  const analytics = yield* Effect.service(AnalyticsService.AnalyticsService);
-  const serverConfig = yield* ServerConfig.ServerConfig;
-  const eventLoggers = yield* ProviderEventLoggers.ProviderEventLoggers;
-  // Options-provided logger wins (test overrides); otherwise we take whatever
-  // the `ProviderEventLoggers` tag exposes — `undefined` means "no canonical
-  // log writer is attached", which downstream code already handles as a
-  // no-op.
-  const canonicalEventLogger = options?.canonicalEventLogger ?? eventLoggers.canonical;
-
-  const registry = yield* ProviderAdapterRegistry.ProviderAdapterRegistry;
-  const directory = yield* ProviderSessionDirectory.ProviderSessionDirectory;
-  const serverSettings = yield* ServerSettings.ServerSettingsService;
-  const issueMcpCredential =
-    options?.issueMcpCredential ?? McpSessionRegistry.issueActiveMcpCredential;
-  const revokeMcpCredential =
-    options?.revokeMcpCredential ?? McpSessionRegistry.revokeActiveMcpThread;
-  const runtimeEventPubSub = yield* PubSub.unbounded<ProviderRuntimeEvent>();
-  const nowIso = Effect.map(DateTime.now, DateTime.formatIso);
-  /**
-   * Attach the `t3-code` MCP server to the session that is about to start.
-   *
-   * This is the only place a credential is minted, so withholding one here is
-   * what disables agent browser access everywhere: every adapter already
-   * treats a missing session as "no MCP server", and the `/mcp` endpoint
-   * accepts nothing but tokens issued from this path.
-   */
-  /**
-   * Deny on an unreadable settings file rather than letting the read failure
-   * escape: adding `ServerSettingsError` to `ProviderServiceError` would widen
-   * a union every caller handles, for a branch that only decides whether one
-   * optional toolset is attached. Denying is the safe direction — an explicit
-   * "off" silently becoming "on" would violate the user's stated choice,
-   * whereas the reverse costs an agent one toolset and is visible immediately.
-   */
-  const agentBrowserAccessEnabled = serverSettings.getSettings.pipe(
-    Effect.map((settings) => settings.enableAgentBrowserAccess),
-    Effect.catch((cause) =>
-      Effect.logWarning(
-        "Could not read server settings; withholding agent browser access for this session.",
-        { cause },
-      ).pipe(Effect.as(false)),
-    ),
-  );
-
-  const prepareMcpSession = (threadId: ThreadId, providerInstanceId: ProviderInstanceId) =>
-    Effect.gen(function* () {
-      if (!(yield* agentBrowserAccessEnabled)) {
-        // Revoke as well as clear. Every other prepare path reaches
-        // `issueActiveMcpCredential`, which revokes the thread first, so
-        // skipping it here would leave a previously issued bearer token valid
-        // against `/mcp` for the rest of its liveness window — and later turns
-        // would keep refreshing it. A session restart (runtime mode, cwd,
-        // model) re-prepares without stopping, so it relies on this.
-        yield* revokeMcpCredential(threadId);
-        yield* Effect.sync(() => McpProviderSession.clearMcpProviderSession(threadId));
-        return undefined;
-      }
-      const credential = yield* issueMcpCredential({ threadId, providerInstanceId });
-      if (credential) {
-        yield* Effect.sync(() => McpProviderSession.setMcpProviderSession(credential.config));
-      }
-      return credential;
-    });
-  const clearMcpSession = (threadId: ThreadId) =>
-    McpSessionRegistry.revokeActiveMcpThread(threadId).pipe(
-      Effect.tap(() => Effect.sync(() => McpProviderSession.clearMcpProviderSession(threadId))),
-    );
-
-  const publishRuntimeEvent = (event: ProviderRuntimeEvent): Effect.Effect<void> =>
-    Effect.succeed(event).pipe(
-      Effect.tap((canonicalEvent) =>
-        canonicalEventLogger
-          ? canonicalEventLogger.write(canonicalEvent, canonicalEvent.threadId)
-          : Effect.void,
-      ),
-      Effect.flatMap((canonicalEvent) => PubSub.publish(runtimeEventPubSub, canonicalEvent)),
-      Effect.asVoid,
-    );
-
-  const requireBindingInstanceId = (
-    operation: string,
-    payload: {
-      readonly providerInstanceId?: ProviderInstanceId | undefined;
-      readonly provider?: ProviderDriverKind | undefined;
-    },
-  ): Effect.Effect<ProviderInstanceId, ProviderValidationError> =>
-    payload.providerInstanceId !== undefined
-      ? Effect.succeed(payload.providerInstanceId)
-      : Effect.fail(
-          toValidationError(
-            operation,
-            payload.provider
-              ? `Provider instance id is required for provider '${payload.provider}'.`
-              : "Provider instance id is required.",
-          ),
-        );
-
-  const upsertSessionBinding = (
-    session: ProviderSession,
-    threadId: ThreadId,
-    extra?: {
-      readonly modelSelection?: unknown;
-      readonly lastRuntimeEvent?: string;
-      readonly lastRuntimeEventAt?: string;
-    },
-  ) =>
-    Effect.gen(function* () {
-      const providerInstanceId = yield* requireBindingInstanceId(
-        "ProviderService.upsertSessionBinding",
-        session,
-      );
-      yield* directory.upsert({
-        threadId,
-        provider: session.provider,
-        providerInstanceId,
-        runtimeMode: session.runtimeMode,
-        status: toRuntimeStatus(session),
-        ...(session.resumeCursor !== undefined ? { resumeCursor: session.resumeCursor } : {}),
-        runtimePayload: toRuntimePayloadFromSession(session, extra),
-      });
-    });
-
-  const processRuntimeEvent = (
-    source: {
-      readonly instanceId: ProviderInstanceId;
-      readonly provider: ProviderDriverKind;
-    },
-    event: ProviderRuntimeEvent,
-  ): Effect.Effect<void> =>
-    Effect.sync(() => correlateRuntimeEventWithInstance(source, event)).pipe(
-      Effect.flatMap((canonicalEvent) =>
-        increment(providerRuntimeEventsTotal, {
-          provider: canonicalEvent.provider,
-          eventType: canonicalEvent.type,
-        }).pipe(Effect.andThen(publishRuntimeEvent(canonicalEvent))),
-      ),
-    );
-
-  // `subscribedAdapters` is our source-of-truth for "which instance adapters
-  // are currently wired into the runtime event bus". It both tracks the set
-  // of live subscriptions (so `reconcileInstanceSubscriptions` can diff and
-  // fork only the *new* or *rebuilt* ones) and serves as the dynamic adapter
-  // list consumed by `stopStaleSessionsForThread`, `listSessions`, and
-  // `runStopAll` — replacing the pre-Slice-D startup snapshot so hot-added
-  // instances become visible to those call sites as soon as settings edits
-  // land.
-  const subscribedAdapters = yield* Ref.make(
-    new Map<ProviderInstanceId, ProviderAdapterShape<ProviderAdapterError>>(),
-  );
-
-  const getAdapterEntries = Ref.get(subscribedAdapters).pipe(
-    Effect.map((map) => Array.from(map.entries())),
-  );
-
-  // Rebuild the map of id → adapter from the registry and fork a new event
-  // subscription for every instance that is either brand new or whose adapter
-  // identity changed (indicating the underlying `ProviderInstance` was torn
-  // down and rebuilt by `ProviderInstanceRegistry.reconcile`). Orphaned
-  // fibers for removed/replaced instances exit on their own because their
-  // adapter's `streamEvents` source terminates when the old scope closes.
-  const reconcileInstanceSubscriptions = Effect.gen(function* () {
-    const previous = yield* Ref.get(subscribedAdapters);
-    const currentIds = yield* registry.listInstances();
-    const next = new Map<ProviderInstanceId, ProviderAdapterShape<ProviderAdapterError>>();
-    for (const id of currentIds) {
-      const adapterOption = yield* registry
-        .getByInstance(id)
-        .pipe(Effect.tapError(Effect.logWarning), Effect.option);
-      if (Option.isNone(adapterOption)) continue;
-      const adapter = adapterOption.value;
-      next.set(id, adapter);
-      if (previous.get(id) !== adapter) {
-        yield* Stream.runForEach(adapter.streamEvents, (event) =>
-          processRuntimeEvent(
-            {
-              instanceId: id,
-              provider: adapter.provider,
-            },
-            event,
-          ),
-        ).pipe(Effect.forkScoped);
-      }
-    }
-    yield* Ref.set(subscribedAdapters, next);
-  });
-
-  const instanceChanges = yield* registry.subscribeChanges;
-  yield* reconcileInstanceSubscriptions;
-  yield* Stream.runForEach(
-    Stream.fromSubscription(instanceChanges),
-    () => reconcileInstanceSubscriptions,
-  ).pipe(Effect.forkScoped);
-
-  const recoverSessionForThread = Effect.fn("recoverSessionForThread")(function* (input: {
-    readonly binding: ProviderSessionDirectory.ProviderRuntimeBinding;
-    readonly operation: string;
-  }) {
-    const bindingInstanceId = yield* requireBindingInstanceId(input.operation, input.binding);
-    yield* Effect.annotateCurrentSpan({
-      "provider.operation": "recover-session",
-      "provider.kind": input.binding.provider,
-      "provider.instance_id": bindingInstanceId,
-      "provider.thread_id": input.binding.threadId,
-    });
-    return yield* Effect.gen(function* () {
-      const adapter = yield* registry.getByInstance(bindingInstanceId);
-      const hasResumeCursor =
-        input.binding.resumeCursor !== null && input.binding.resumeCursor !== undefined;
-      const hasActiveSession = yield* adapter.hasSession(input.binding.threadId);
-      if (hasActiveSession) {
-        const activeSessions = yield* adapter.listSessions();
-        const existing = activeSessions.find(
-          (session) => session.threadId === input.binding.threadId,
-        );
-        if (existing) {
-          yield* upsertSessionBinding(
-            { ...existing, providerInstanceId: bindingInstanceId },
-            input.binding.threadId,
-          );
-          yield* analytics.record("provider.session.recovered", {
-            provider: existing.provider,
-            strategy: "adopt-existing",
-            hasResumeCursor: existing.resumeCursor !== undefined,
-          });
-          return { adapter, session: existing } as const;
-        }
-      }
-
-      if (!hasResumeCursor) {
-        return yield* toValidationError(
-          input.operation,
-          `Cannot recover thread '${input.binding.threadId}' because no provider resume state is persisted.`,
-        );
-      }
-
-      const persistedCwd = readPersistedCwd(input.binding.runtimePayload);
-      const persistedModelSelection = readPersistedModelSelection(input.binding.runtimePayload);
-
-      yield* prepareMcpSession(input.binding.threadId, bindingInstanceId);
-      const resumed = yield* adapter
-        .startSession({
-          threadId: input.binding.threadId,
-          provider: input.binding.provider,
-          providerInstanceId: bindingInstanceId,
-          ...(persistedCwd ? { cwd: persistedCwd } : {}),
-          ...(persistedModelSelection ? { modelSelection: persistedModelSelection } : {}),
-          ...(hasResumeCursor ? { resumeCursor: input.binding.resumeCursor } : {}),
-          runtimeMode: input.binding.runtimeMode ?? "full-access",
-        })
-        .pipe(Effect.onError(() => clearMcpSession(input.binding.threadId)));
-      if (resumed.provider !== adapter.provider) {
-        yield* clearMcpSession(input.binding.threadId);
-        return yield* toValidationError(
-          input.operation,
-          `Adapter/provider mismatch while recovering thread '${input.binding.threadId}'. Expected '${adapter.provider}', received '${resumed.provider}'.`,
-        );
-      }
-
-      yield* upsertSessionBinding(
-        { ...resumed, providerInstanceId: bindingInstanceId },
-        input.binding.threadId,
-      );
-      yield* analytics.record("provider.session.recovered", {
-        provider: resumed.provider,
-        strategy: "resume-thread",
-        hasResumeCursor: resumed.resumeCursor !== undefined,
-      });
-      return { adapter, session: resumed } as const;
-    }).pipe(
-      withMetrics({
-        counter: providerSessionsTotal,
-        attributes: providerMetricAttributes(input.binding.provider, {
-          operation: "recover",
-        }),
-      }),
-    );
-  });
-
-  const resolveRoutableSession = Effect.fn("resolveRoutableSession")(function* (input: {
-    readonly threadId: ThreadId;
-    readonly operation: string;
-    readonly allowRecovery: boolean;
-  }) {
-    const bindingOption = yield* directory.getBinding(input.threadId);
-    const binding = Option.getOrUndefined(bindingOption);
-    if (!binding) {
-      return yield* toValidationError(
-        input.operation,
-        `Cannot route thread '${input.threadId}' because no persisted provider binding exists.`,
-      );
-    }
-    const instanceId = yield* requireBindingInstanceId(input.operation, binding);
-    const adapter = yield* registry.getByInstance(instanceId);
-
-    const hasRequestedSession = yield* adapter.hasSession(input.threadId);
-    if (hasRequestedSession) {
-      return {
-        adapter,
-        instanceId,
-        threadId: input.threadId,
-        runtimeMode: binding.runtimeMode,
-        isActive: true,
-      } as const;
-    }
-
-    if (!input.allowRecovery) {
-      return {
-        adapter,
-        instanceId,
-        threadId: input.threadId,
-        runtimeMode: binding.runtimeMode,
-        isActive: false,
-      } as const;
-    }
-
-    const recovered = yield* recoverSessionForThread({
-      binding,
-      operation: input.operation,
-    });
-    return {
-      adapter: recovered.adapter,
-      instanceId,
-      threadId: input.threadId,
-      runtimeMode: recovered.session.runtimeMode,
-      isActive: true,
-    } as const;
-  });
-
-  const stopStaleSessionsForThread = Effect.fn("stopStaleSessionsForThread")(function* (input: {
-    readonly threadId: ThreadId;
-    readonly currentInstanceId: ProviderInstanceId;
-  }) {
-    const currentAdapters = yield* getAdapterEntries;
-    yield* Effect.forEach(
-      currentAdapters,
-      ([instanceId, adapter]) =>
-        instanceId === input.currentInstanceId
-          ? Effect.void
-          : Effect.gen(function* () {
-              const hasSession = yield* adapter.hasSession(input.threadId);
-              if (!hasSession) {
-                return;
-              }
-
-              yield* adapter.stopSession(input.threadId).pipe(
-                Effect.tap(() =>
-                  analytics.record("provider.session.stopped", {
-                    provider: adapter.provider,
-                  }),
-                ),
-                Effect.catchCause((cause) =>
-                  Effect.logWarning("provider.session.stop-stale-failed", {
-                    threadId: input.threadId,
-                    provider: adapter.provider,
-                    cause,
-                  }),
-                ),
-              );
-            }),
-      { discard: true },
-    );
-  });
-
-  const startSession: ProviderServiceMethod<"startSession"> = Effect.fn("startSession")(
-    function* (threadId, rawInput) {
-      const parsed = yield* decodeInputOrValidationError({
-        operation: "ProviderService.startSession",
-        schema: ProviderSessionStartInput,
-        payload: rawInput,
-      });
-
-      const resolvedInstanceId = yield* requireBindingInstanceId(
-        "ProviderService.startSession",
-        parsed,
-      );
-      let metricProvider = parsed.provider ?? String(resolvedInstanceId);
-      yield* Effect.annotateCurrentSpan({
-        "provider.operation": "start-session",
-        "provider.instance_id": resolvedInstanceId,
-        "provider.thread_id": threadId,
-        "provider.runtime_mode": parsed.runtimeMode,
-      });
-      return yield* Effect.gen(function* () {
-        const instanceInfo = yield* registry.getInstanceInfo(resolvedInstanceId);
-        const resolvedProvider = instanceInfo.driverKind;
-        metricProvider = resolvedProvider;
-        if (parsed.provider !== undefined && parsed.provider !== resolvedProvider) {
-          return yield* toValidationError(
-            "ProviderService.startSession",
-            `Provider instance '${resolvedInstanceId}' belongs to driver '${resolvedProvider}', not '${parsed.provider}'.`,
-          );
-        }
-        const input = {
-          ...parsed,
-          threadId,
-          provider: resolvedProvider,
-        };
-        if (!instanceInfo.enabled) {
-          return yield* toValidationError(
-            "ProviderService.startSession",
-            `Provider instance '${resolvedInstanceId}' is disabled in T3 Code settings.`,
-          );
-        }
-        const persistedBinding = Option.getOrUndefined(yield* directory.getBinding(threadId));
-        const effectiveResumeCursor =
-          input.resumeCursor ??
-          (persistedBinding?.providerInstanceId === resolvedInstanceId
-            ? persistedBinding.resumeCursor
-            : undefined);
-        const effectiveCwd =
-          input.cwd ??
-          (persistedBinding?.providerInstanceId === resolvedInstanceId
-            ? readPersistedCwd(persistedBinding.runtimePayload)
-            : undefined);
-        yield* Effect.annotateCurrentSpan({
-          "provider.kind": resolvedProvider,
-          "provider.resume_cursor.source":
-            input.resumeCursor !== undefined
-              ? "request"
-              : effectiveResumeCursor !== undefined &&
-                  persistedBinding?.providerInstanceId === resolvedInstanceId
-                ? "persisted"
-                : "none",
-          "provider.resume_cursor.present": effectiveResumeCursor !== undefined,
-          "provider.cwd.source":
-            input.cwd !== undefined
-              ? "request"
-              : effectiveCwd !== undefined &&
-                  persistedBinding?.providerInstanceId === resolvedInstanceId
-                ? "persisted"
-                : "none",
-          "provider.cwd.effective": effectiveCwd ?? "",
-        });
-        const adapter = yield* registry.getByInstance(resolvedInstanceId);
-        yield* prepareMcpSession(threadId, resolvedInstanceId);
-        const session = yield* adapter
-          .startSession({
-            ...input,
-            providerInstanceId: resolvedInstanceId,
-            ...(effectiveCwd !== undefined ? { cwd: effectiveCwd } : {}),
-            ...(effectiveResumeCursor !== undefined ? { resumeCursor: effectiveResumeCursor } : {}),
-          })
-          .pipe(Effect.onError(() => clearMcpSession(threadId)));
-
-        if (session.provider !== adapter.provider) {
-          yield* clearMcpSession(threadId);
-          return yield* toValidationError(
-            "ProviderService.startSession",
-            `Adapter/provider mismatch: requested '${adapter.provider}', received '${session.provider}'.`,
-          );
-        }
-        const sessionWithInstance = {
-          ...session,
-          providerInstanceId: resolvedInstanceId,
-        };
-
-        yield* stopStaleSessionsForThread({
-          threadId,
-          currentInstanceId: resolvedInstanceId,
-        });
-        yield* upsertSessionBinding(sessionWithInstance, threadId, {
-          modelSelection: input.modelSelection,
-        });
-        yield* analytics.record("provider.session.started", {
-          provider: sessionWithInstance.provider,
-          runtimeMode: input.runtimeMode,
-          hasResumeCursor: sessionWithInstance.resumeCursor !== undefined,
-          hasCwd: typeof effectiveCwd === "string" && effectiveCwd.trim().length > 0,
-          hasModel:
-            typeof input.modelSelection?.model === "string" &&
-            input.modelSelection.model.trim().length > 0,
-        });
-
-        // Changing runtime mode restarts the session, so the transition is only
-        // observable here, by diffing against the mode the previous session for
-        // this thread was bound to. Recording it separately is what makes the
-        // "started supervised, switched to full access" funnel answerable.
-        const previousRuntimeMode = persistedBinding?.runtimeMode;
-        if (previousRuntimeMode !== undefined && previousRuntimeMode !== input.runtimeMode) {
-          yield* analytics.record("provider.runtime_mode.changed", {
-            provider: sessionWithInstance.provider,
-            from: previousRuntimeMode,
-            to: input.runtimeMode,
-          });
-        }
-
-        return sessionWithInstance;
-      }).pipe(
-        withMetrics({
-          counter: providerSessionsTotal,
-          attributes: () =>
-            providerMetricAttributes(metricProvider, {
-              operation: "start",
-            }),
-        }),
-      );
-    },
-  );
-
-  const sendTurn: ProviderServiceMethod<"sendTurn"> = Effect.fn("sendTurn")(function* (rawInput) {
-    const parsed = yield* decodeInputOrValidationError({
-      operation: "ProviderService.sendTurn",
-      schema: ProviderSendTurnInput,
-      payload: rawInput,
-    });
-
-    const attachments = parsed.attachments ?? [];
-    if (!parsed.input && attachments.length === 0) {
-      return yield* toValidationError(
-        "ProviderService.sendTurn",
-        "Either input text or at least one attachment is required",
-      );
-    }
-
-    // Every attachment gets an on-disk path in the prompt so the model's tools
-    // can dereference the actual file. All attachments then go to the adapter,
-    // and each adapter decides what its provider ingests natively: OpenCode
-    // sends generic files as file parts, the others send images only and rely
-    // on the path line for everything else. Unresolvable ids are skipped here
-    // and surface as adapter errors when the file is read.
-    const attachmentPathLines = attachments.flatMap((attachment) => {
-      const attachmentPath = resolveAttachmentPath({
-        attachmentsDir: serverConfig.attachmentsDir,
-        attachment,
-      });
-      return attachmentPath === null
-        ? []
-        : [`[Attached ${attachment.type} "${attachment.name}" is saved at: ${attachmentPath}]`];
-    });
-    const inputTextWithAttachmentPaths =
-      attachmentPathLines.length === 0
-        ? parsed.input
-        : [parsed.input, attachmentPathLines.join("\n")]
-            .filter((part): part is string => typeof part === "string" && part.length > 0)
-            .join("\n\n");
-
-    const input = {
-      ...parsed,
-      ...(inputTextWithAttachmentPaths !== undefined
-        ? { input: inputTextWithAttachmentPaths }
-        : {}),
-    };
-    yield* Effect.annotateCurrentSpan({
-      "provider.operation": "send-turn",
-      "provider.thread_id": input.threadId,
-      "provider.interaction_mode": input.interactionMode,
-      "provider.attachment_count": attachments.length,
-    });
-    let metricProvider = "unknown";
-    let metricModel = input.modelSelection?.model;
-    return yield* Effect.gen(function* () {
-      const routed = yield* resolveRoutableSession({
-        threadId: input.threadId,
-        operation: "ProviderService.sendTurn",
-        allowRecovery: true,
-      });
-      metricProvider = routed.adapter.provider;
-      metricModel = input.modelSelection?.model;
-      yield* Effect.annotateCurrentSpan({
-        "provider.kind": routed.adapter.provider,
-        ...(input.modelSelection?.model ? { "provider.model": input.modelSelection.model } : {}),
-      });
-      // A turn is the clearest sign a session is still alive. The MCP
-      // credential is minted once at session start and cannot be rotated into
-      // an already-spawned agent process, so we keep the existing token valid
-      // rather than issuing a new one: sessions that go a long time between
-      // browser tool calls used to lose the toolkit outright.
-      yield* McpSessionRegistry.touchActiveMcpThread(input.threadId);
-      const turn = yield* routed.adapter.sendTurn(input);
-      yield* directory.upsert({
-        threadId: input.threadId,
-        provider: routed.adapter.provider,
-        providerInstanceId: routed.instanceId,
-        status: "running",
-        ...(turn.resumeCursor !== undefined ? { resumeCursor: turn.resumeCursor } : {}),
-        runtimePayload: {
-          ...(input.modelSelection !== undefined ? { modelSelection: input.modelSelection } : {}),
-          activeTurnId: turn.turnId,
-          lastRuntimeEvent: "provider.sendTurn",
-          lastRuntimeEventAt: yield* nowIso,
-        },
-      });
-      yield* analytics.record("provider.turn.sent", {
-        provider: routed.adapter.provider,
-        model: input.modelSelection?.model,
-        interactionMode: input.interactionMode,
-        // Session-start events alone skew runtime mode toward users who toggle
-        // often, since every toggle restarts the session. Recording it per turn
-        // gives a usage-weighted view and lets it cross with interactionMode.
-        runtimeMode: routed.runtimeMode,
-        attachmentCount: attachments.length,
-        hasInput: typeof input.input === "string" && input.input.trim().length > 0,
-      });
-      return turn;
-    }).pipe(
-      withMetrics({
-        counter: providerTurnsTotal,
-        timer: providerTurnDuration,
-        attributes: () =>
-          providerTurnMetricAttributes({
-            provider: metricProvider,
-            model: metricModel,
-            extra: {
-              operation: "send",
-            },
-          }),
-      }),
-    );
-  });
-
-  const interruptTurn: ProviderServiceMethod<"interruptTurn"> = Effect.fn("interruptTurn")(
-    function* (rawInput) {
-      const input = yield* decodeInputOrValidationError({
-        operation: "ProviderService.interruptTurn",
-        schema: ProviderInterruptTurnInput,
-        payload: rawInput,
-      });
-      let metricProvider = "unknown";
-      return yield* Effect.gen(function* () {
-        const routed = yield* resolveRoutableSession({
-          threadId: input.threadId,
-          operation: "ProviderService.interruptTurn",
-          allowRecovery: true,
-        });
-        metricProvider = routed.adapter.provider;
-        yield* Effect.annotateCurrentSpan({
-          "provider.operation": "interrupt-turn",
-          "provider.kind": routed.adapter.provider,
-          "provider.thread_id": input.threadId,
-          "provider.turn_id": input.turnId,
-        });
-        yield* routed.adapter.interruptTurn(routed.threadId, input.turnId);
-        yield* analytics.record("provider.turn.interrupted", {
-          provider: routed.adapter.provider,
-        });
-      }).pipe(
-        withMetrics({
-          counter: providerTurnsTotal,
-          outcomeAttributes: () =>
-            providerMetricAttributes(metricProvider, {
-              operation: "interrupt",
-            }),
-        }),
-      );
-    },
-  );
-
-  const respondToRequest: ProviderServiceMethod<"respondToRequest"> = Effect.fn("respondToRequest")(
-    function* (rawInput) {
-      const input = yield* decodeInputOrValidationError({
-        operation: "ProviderService.respondToRequest",
-        schema: ProviderRespondToRequestInput,
-        payload: rawInput,
-      });
-      let metricProvider = "unknown";
-      return yield* Effect.gen(function* () {
-        const routed = yield* resolveRoutableSession({
-          threadId: input.threadId,
-          operation: "ProviderService.respondToRequest",
-          allowRecovery: true,
-        });
-        metricProvider = routed.adapter.provider;
-        yield* Effect.annotateCurrentSpan({
-          "provider.operation": "respond-to-request",
-          "provider.kind": routed.adapter.provider,
-          "provider.thread_id": input.threadId,
-          "provider.request_id": input.requestId,
-        });
-        yield* routed.adapter.respondToRequest(routed.threadId, input.requestId, input.decision);
-        yield* analytics.record("provider.request.responded", {
-          provider: routed.adapter.provider,
-          decision: input.decision,
-        });
-      }).pipe(
-        withMetrics({
-          counter: providerTurnsTotal,
-          outcomeAttributes: () =>
-            providerMetricAttributes(metricProvider, {
-              operation: "approval-response",
-            }),
-        }),
-      );
-    },
-  );
-
-  const respondToUserInput: ProviderServiceMethod<"respondToUserInput"> = Effect.fn(
-    "respondToUserInput",
-  )(function* (rawInput) {
-    const input = yield* decodeInputOrValidationError({
-      operation: "ProviderService.respondToUserInput",
-      schema: ProviderRespondToUserInputInput,
-      payload: rawInput,
-    });
-    let metricProvider = "unknown";
-    return yield* Effect.gen(function* () {
-      const routed = yield* resolveRoutableSession({
-        threadId: input.threadId,
-        operation: "ProviderService.respondToUserInput",
-        allowRecovery: true,
-      });
-      metricProvider = routed.adapter.provider;
-      yield* Effect.annotateCurrentSpan({
-        "provider.operation": "respond-to-user-input",
-        "provider.kind": routed.adapter.provider,
-        "provider.thread_id": input.threadId,
-        "provider.request_id": input.requestId,
-      });
-      yield* routed.adapter.respondToUserInput(routed.threadId, input.requestId, input.answers);
-    }).pipe(
-      withMetrics({
-        counter: providerTurnsTotal,
-        outcomeAttributes: () =>
-          providerMetricAttributes(metricProvider, {
-            operation: "user-input-response",
-          }),
-      }),
-    );
-  });
-
-  const stopSession: ProviderServiceMethod<"stopSession"> = Effect.fn("stopSession")(
-    function* (rawInput) {
-      const input = yield* decodeInputOrValidationError({
-        operation: "ProviderService.stopSession",
-        schema: ProviderStopSessionInput,
-        payload: rawInput,
-      });
-      let metricProvider = "unknown";
-      return yield* Effect.gen(function* () {
-        const routed = yield* resolveRoutableSession({
-          threadId: input.threadId,
-          operation: "ProviderService.stopSession",
-          allowRecovery: false,
-        });
-        metricProvider = routed.adapter.provider;
-        yield* Effect.annotateCurrentSpan({
-          "provider.operation": "stop-session",
-          "provider.kind": routed.adapter.provider,
-          "provider.thread_id": input.threadId,
-        });
-        if (routed.isActive) {
-          yield* routed.adapter.stopSession(routed.threadId);
-        }
-        yield* clearMcpSession(input.threadId);
-        yield* directory.upsert({
-          threadId: input.threadId,
-          provider: routed.adapter.provider,
-          providerInstanceId: routed.instanceId,
-          status: "stopped",
-          runtimePayload: {
-            activeTurnId: null,
-          },
-        });
-        yield* analytics.record("provider.session.stopped", {
-          provider: routed.adapter.provider,
-        });
-      }).pipe(
-        withMetrics({
-          counter: providerSessionsTotal,
-          outcomeAttributes: () =>
-            providerMetricAttributes(metricProvider, {
-              operation: "stop",
-            }),
-        }),
-      );
-    },
-  );
-
-  const listSessions: ProviderServiceMethod<"listSessions"> = Effect.fn("listSessions")(
-    function* () {
-      const currentAdapters = yield* getAdapterEntries;
-      const sessionsByProvider = yield* Effect.forEach(currentAdapters, ([instanceId, adapter]) =>
-        adapter.listSessions().pipe(
-          Effect.map((sessions) =>
-            sessions.map((session) => ({
-              ...session,
-              providerInstanceId: instanceId,
-            })),
-          ),
-        ),
-      );
-      const activeSessions = sessionsByProvider.flatMap((sessions) => sessions);
-      const persistedBindings = yield* directory.listThreadIds().pipe(
-        Effect.flatMap((threadIds) =>
-          Effect.forEach(
-            threadIds,
-            (threadId) =>
-              directory
-                .getBinding(threadId)
-                .pipe(
-                  Effect.orElseSucceed(() =>
-                    Option.none<ProviderSessionDirectory.ProviderRuntimeBinding>(),
-                  ),
-                ),
-            { concurrency: "unbounded" },
-          ),
-        ),
-        Effect.orElseSucceed(
-          () => [] as Array<Option.Option<ProviderSessionDirectory.ProviderRuntimeBinding>>,
-        ),
-      );
-      const bindingsByThreadId = new Map<
-        ThreadId,
-        ProviderSessionDirectory.ProviderRuntimeBinding
-      >();
-      for (const bindingOption of persistedBindings) {
-        const binding = Option.getOrUndefined(bindingOption);
-        if (binding) {
-          bindingsByThreadId.set(binding.threadId, binding);
-        }
-      }
-
-      const sessions: ProviderSession[] = [];
-      for (const session of activeSessions) {
-        const binding = bindingsByThreadId.get(session.threadId);
-        if (!binding) {
-          sessions.push(session);
-          continue;
-        }
-
-        const overrides: {
-          resumeCursor?: ProviderSession["resumeCursor"];
-          runtimeMode?: ProviderSession["runtimeMode"];
-          providerInstanceId?: ProviderSession["providerInstanceId"];
-        } = {};
-        overrides.providerInstanceId = dieOnMissingBindingInstanceId(
-          "ProviderService.listSessions",
-          binding,
-        );
-        if (binding.provider !== session.provider) {
-          return yield* Effect.die(
-            new Error(
-              `ProviderService.listSessions: thread '${session.threadId}' is active on provider '${session.provider}' but persisted binding names provider '${binding.provider}'.`,
-            ),
-          );
-        }
-        if (overrides.providerInstanceId !== session.providerInstanceId) {
-          return yield* Effect.die(
-            new Error(
-              `ProviderService.listSessions: thread '${session.threadId}' is active on provider instance '${session.providerInstanceId}' but persisted binding names '${overrides.providerInstanceId}'.`,
-            ),
-          );
-        }
-        if (session.resumeCursor === undefined && binding.resumeCursor !== undefined) {
-          overrides.resumeCursor = binding.resumeCursor;
-        }
-        if (binding.runtimeMode !== undefined) {
-          overrides.runtimeMode = binding.runtimeMode;
-        }
-        sessions.push(Object.assign({}, session, overrides));
-      }
-      return sessions;
-    },
-  );
-
-  const getCapabilities: ProviderServiceMethod<"getCapabilities"> = (instanceId) =>
-    registry.getByInstance(instanceId).pipe(Effect.map((adapter) => adapter.capabilities));
-
-  const getInstanceInfo: ProviderServiceMethod<"getInstanceInfo"> = (instanceId) =>
-    registry.getInstanceInfo(instanceId);
-
-  const rollbackConversation: ProviderServiceMethod<"rollbackConversation"> = Effect.fn(
-    "rollbackConversation",
-  )(function* (rawInput) {
-    const input = yield* decodeInputOrValidationError({
-      operation: "ProviderService.rollbackConversation",
-      schema: ProviderRollbackConversationInput,
-      payload: rawInput,
-    });
-    if (input.numTurns === 0) {
-      return;
-    }
-    let metricProvider = "unknown";
-    return yield* Effect.gen(function* () {
-      const routed = yield* resolveRoutableSession({
-        threadId: input.threadId,
-        operation: "ProviderService.rollbackConversation",
-        allowRecovery: true,
-      });
-      metricProvider = routed.adapter.provider;
-      yield* Effect.annotateCurrentSpan({
-        "provider.operation": "rollback-conversation",
-        "provider.kind": routed.adapter.provider,
-        "provider.thread_id": input.threadId,
-        "provider.rollback_turns": input.numTurns,
-      });
-      yield* routed.adapter.rollbackThread(routed.threadId, input.numTurns);
-      yield* analytics.record("provider.conversation.rolled_back", {
-        provider: routed.adapter.provider,
-        turns: input.numTurns,
-      });
-    }).pipe(
-      withMetrics({
-        counter: providerTurnsTotal,
-        outcomeAttributes: () =>
-          providerMetricAttributes(metricProvider, {
-            operation: "rollback",
-          }),
-      }),
-    );
-  });
-
-  const uploadFeedback: ProviderServiceMethod<"uploadFeedback"> = Effect.fn("uploadFeedback")(
-    function* (rawInput) {
-      const input = yield* decodeInputOrValidationError({
-        operation: "ProviderService.uploadFeedback",
-        schema: ProviderUploadFeedbackInput,
-        payload: rawInput,
-      });
-      let routed = yield* resolveRoutableSession({
-        threadId: input.threadId,
-        operation: "ProviderService.uploadFeedback",
-        allowRecovery: false,
-      });
-      if (routed.adapter.uploadFeedback === undefined) {
-        return yield* toValidationError(
-          "ProviderService.uploadFeedback",
-          `Provider '${routed.adapter.provider}' does not support feedback uploads.`,
-        );
-      }
-      if (!routed.isActive) {
-        routed = yield* resolveRoutableSession({
-          threadId: input.threadId,
-          operation: "ProviderService.uploadFeedback",
-          allowRecovery: true,
-        });
-      }
-      const uploadFeedback = routed.adapter.uploadFeedback;
-      if (uploadFeedback === undefined) {
-        return yield* toValidationError(
-          "ProviderService.uploadFeedback",
-          `Provider '${routed.adapter.provider}' does not support feedback uploads.`,
-        );
-      }
-      yield* Effect.annotateCurrentSpan({
-        "provider.operation": "upload-feedback",
-        "provider.kind": routed.adapter.provider,
-        "provider.thread_id": input.threadId,
-      });
-      return yield* uploadFeedback(input);
-    },
-  );
-
-  const runStopAll = Effect.fn("runStopAll")(function* () {
-    const threadIds = yield* directory.listThreadIds();
-    const currentAdapters = yield* getAdapterEntries;
-    const activeSessions = yield* Effect.forEach(currentAdapters, ([instanceId, adapter]) =>
-      adapter.listSessions().pipe(
-        Effect.map((sessions) =>
-          sessions.map((session) => ({
-            ...session,
-            providerInstanceId: instanceId,
-          })),
-        ),
-      ),
-    ).pipe(Effect.map((sessionsByAdapter) => sessionsByAdapter.flatMap((sessions) => sessions)));
-    yield* Effect.forEach(activeSessions, (session) =>
-      Effect.flatMap(nowIso, (lastRuntimeEventAt) =>
-        upsertSessionBinding(session, session.threadId, {
-          lastRuntimeEvent: "provider.stopAll",
-          lastRuntimeEventAt,
-        }),
-      ),
-    ).pipe(Effect.asVoid);
-    yield* Effect.forEach(currentAdapters, ([, adapter]) => adapter.stopAll()).pipe(Effect.asVoid);
-    yield* McpSessionRegistry.revokeAllActiveMcpCredentials();
-    McpProviderSession.clearAllMcpProviderSessions();
-    const bindings = yield* directory.listBindings().pipe(Effect.orElseSucceed(() => []));
-    yield* Effect.forEach(bindings, (binding) =>
-      Effect.gen(function* () {
-        const providerInstanceId = dieOnMissingBindingInstanceId(
-          "ProviderService.stopAll",
-          binding,
-        );
-        return yield* directory.upsert({
-          threadId: binding.threadId,
-          provider: binding.provider,
-          providerInstanceId,
-          status: "stopped",
-          runtimePayload: {
-            activeTurnId: null,
-            lastRuntimeEvent: "provider.stopAll",
-            lastRuntimeEventAt: yield* nowIso,
-          },
-        });
-      }),
-    ).pipe(Effect.asVoid);
-    yield* analytics.record("provider.sessions.stopped_all", {
-      sessionCount: threadIds.length,
-    });
-    yield* analytics.flush;
-  });
-
-  yield* Effect.addFinalizer(() =>
-    runStopAll().pipe(
-      Effect.catchCause((cause) =>
-        Effect.logWarning("failed to stop provider service", {
-          errorTag: causeErrorTag(cause),
-        }),
-      ),
-    ),
-  );
-
-  return {
-    startSession,
-    sendTurn,
-    interruptTurn,
-    respondToRequest,
-    respondToUserInput,
-    stopSession,
-    listSessions,
-    getCapabilities,
-    getInstanceInfo,
-    rollbackConversation,
-    uploadFeedback,
-    // Each access creates a fresh PubSub subscription so that multiple
-    // consumers (ProviderRuntimeIngestion, CheckpointReactor, etc.) each
-    // independently receive all runtime events.
-    get streamEvents(): ProviderServiceMethod<"streamEvents"> {
-      return Stream.fromPubSub(runtimeEventPubSub);
-    },
-  } satisfies ProviderService.ProviderService["Service"];
-});
-
-export const ProviderServiceLive = Layer.effect(
-  ProviderService.ProviderService,
-  makeProviderService(),
-);
-
-export function makeProviderServiceLive(options?: ProviderServiceLiveOptions) {
-  return Layer.effect(ProviderService.ProviderService, makeProviderService(options));
-}
diff --git a/apps/server/src/provider/Layers/ProviderSessionDirectory.test.ts b/apps/server/src/provider/Layers/ProviderSessionDirectory.test.ts
deleted file mode 100644
index 079b7f10ebfd..000000000000
--- a/apps/server/src/provider/Layers/ProviderSessionDirectory.test.ts
+++ /dev/null
@@ -1,271 +0,0 @@
-// @effect-diagnostics nodeBuiltinImport:off
-import * as NodeFS from "node:fs";
-import * as NodeOS from "node:os";
-import * as NodePath from "node:path";
-
-import * as NodeServices from "@effect/platform-node/NodeServices";
-import { ProviderDriverKind, ThreadId } from "@t3tools/contracts";
-import { it, assert } from "@effect/vitest";
-import { assertSome } from "@effect/vitest/utils";
-import * as Effect from "effect/Effect";
-import * as Layer from "effect/Layer";
-import * as Option from "effect/Option";
-import * as SqlClient from "effect/unstable/sql/SqlClient";
-
-import {
-  makeSqlitePersistenceLive,
-  SqlitePersistenceMemory,
-} from "../../persistence/Layers/Sqlite.ts";
-import * as ProviderSessionRuntime from "../../persistence/ProviderSessionRuntime.ts";
-import { ProviderSessionDirectory } from "../Services/ProviderSessionDirectory.ts";
-import { ProviderSessionDirectoryLive } from "./ProviderSessionDirectory.ts";
-
-function makeDirectoryLayer<E, R>(persistenceLayer: Layer.Layer<SqlClient.SqlClient, E, R>) {
-  const runtimeRepositoryLayer = ProviderSessionRuntime.layer.pipe(Layer.provide(persistenceLayer));
-  return Layer.mergeAll(
-    runtimeRepositoryLayer,
-    ProviderSessionDirectoryLive.pipe(Layer.provide(runtimeRepositoryLayer)),
-    NodeServices.layer,
-  );
-}
-
-it.layer(makeDirectoryLayer(SqlitePersistenceMemory))("ProviderSessionDirectoryLive", (it) => {
-  it("upserts and reads thread bindings", () =>
-    Effect.gen(function* () {
-      const directory = yield* ProviderSessionDirectory;
-      const runtimeRepository = yield* ProviderSessionRuntime.ProviderSessionRuntimeRepository;
-
-      const initialThreadId = ThreadId.make("thread-1");
-
-      yield* directory.upsert({
-        provider: ProviderDriverKind.make("codex"),
-        threadId: initialThreadId,
-      });
-
-      const provider = yield* directory.getProvider(initialThreadId);
-      assert.equal(provider, "codex");
-      const resolvedBinding = yield* directory.getBinding(initialThreadId);
-      assertSome(resolvedBinding, {
-        threadId: initialThreadId,
-        provider: ProviderDriverKind.make("codex"),
-      });
-      if (Option.isSome(resolvedBinding)) {
-        assert.equal(resolvedBinding.value.threadId, initialThreadId);
-      }
-
-      const nextThreadId = ThreadId.make("thread-2");
-
-      yield* directory.upsert({
-        provider: ProviderDriverKind.make("codex"),
-        threadId: nextThreadId,
-      });
-      const updatedBinding = yield* directory.getBinding(nextThreadId);
-      assert.equal(Option.isSome(updatedBinding), true);
-      if (Option.isSome(updatedBinding)) {
-        assert.equal(updatedBinding.value.threadId, nextThreadId);
-      }
-
-      const runtime = yield* runtimeRepository.getByThreadId({ threadId: nextThreadId });
-      assert.equal(Option.isSome(runtime), true);
-      if (Option.isSome(runtime)) {
-        assert.equal(runtime.value.threadId, nextThreadId);
-        assert.equal(runtime.value.status, "running");
-        assert.equal(runtime.value.providerName, "codex");
-      }
-
-      const threadIds = yield* directory.listThreadIds();
-      assert.deepEqual(threadIds, [nextThreadId]);
-    }));
-
-  it("persists runtime fields and merges payload updates", () =>
-    Effect.gen(function* () {
-      const directory = yield* ProviderSessionDirectory;
-      const runtimeRepository = yield* ProviderSessionRuntime.ProviderSessionRuntimeRepository;
-
-      const threadId = ThreadId.make("thread-runtime");
-
-      yield* directory.upsert({
-        provider: ProviderDriverKind.make("codex"),
-        threadId,
-        status: "starting",
-        resumeCursor: {
-          threadId: "provider-thread-runtime",
-        },
-        runtimePayload: {
-          cwd: "/tmp/project",
-          model: "gpt-5-codex",
-        },
-      });
-
-      yield* directory.upsert({
-        provider: ProviderDriverKind.make("codex"),
-        threadId,
-        status: "running",
-        runtimePayload: {
-          activeTurnId: "turn-1",
-        },
-      });
-
-      const runtime = yield* runtimeRepository.getByThreadId({ threadId });
-      assert.equal(Option.isSome(runtime), true);
-      if (Option.isSome(runtime)) {
-        assert.equal(runtime.value.threadId, threadId);
-        assert.equal(runtime.value.status, "running");
-        assert.deepEqual(runtime.value.resumeCursor, {
-          threadId: "provider-thread-runtime",
-        });
-        assert.deepEqual(runtime.value.runtimePayload, {
-          cwd: "/tmp/project",
-          model: "gpt-5-codex",
-          activeTurnId: "turn-1",
-        });
-      }
-    }));
-
-  it("lists persisted bindings with metadata in oldest-first order", () =>
-    Effect.gen(function* () {
-      const directory = yield* ProviderSessionDirectory;
-      const runtimeRepository = yield* ProviderSessionRuntime.ProviderSessionRuntimeRepository;
-
-      const olderThreadId = ThreadId.make("thread-runtime-older");
-      const newerThreadId = ThreadId.make("thread-runtime-newer");
-
-      yield* runtimeRepository.upsert({
-        threadId: newerThreadId,
-        providerName: "codex",
-        providerInstanceId: null,
-        adapterKey: "codex",
-        runtimeMode: "full-access",
-        status: "running",
-        lastSeenAt: "2026-04-14T12:05:00.000Z",
-        resumeCursor: {
-          opaque: "resume-newer",
-        },
-        runtimePayload: {
-          cwd: "/tmp/newer",
-        },
-      });
-
-      yield* runtimeRepository.upsert({
-        threadId: olderThreadId,
-        providerName: "claudeAgent",
-        providerInstanceId: null,
-        adapterKey: "claudeAgent",
-        runtimeMode: "approval-required",
-        status: "starting",
-        lastSeenAt: "2026-04-14T12:00:00.000Z",
-        resumeCursor: {
-          opaque: "resume-older",
-        },
-        runtimePayload: {
-          cwd: "/tmp/older",
-        },
-      });
-
-      const bindings = yield* directory.listBindings();
-
-      assert.deepEqual(bindings, [
-        {
-          threadId: olderThreadId,
-          provider: ProviderDriverKind.make("claudeAgent"),
-          adapterKey: "claudeAgent",
-          runtimeMode: "approval-required",
-          status: "starting",
-          lastSeenAt: "2026-04-14T12:00:00.000Z",
-          resumeCursor: {
-            opaque: "resume-older",
-          },
-          runtimePayload: {
-            cwd: "/tmp/older",
-          },
-        },
-        {
-          threadId: newerThreadId,
-          provider: ProviderDriverKind.make("codex"),
-          adapterKey: "codex",
-          runtimeMode: "full-access",
-          status: "running",
-          lastSeenAt: "2026-04-14T12:05:00.000Z",
-          resumeCursor: {
-            opaque: "resume-newer",
-          },
-          runtimePayload: {
-            cwd: "/tmp/newer",
-          },
-        },
-      ]);
-    }));
-
-  it("resets adapterKey to the new provider when provider changes without an explicit adapter key", () =>
-    Effect.gen(function* () {
-      const directory = yield* ProviderSessionDirectory;
-      const runtimeRepository = yield* ProviderSessionRuntime.ProviderSessionRuntimeRepository;
-      const threadId = ThreadId.make("thread-provider-change");
-
-      yield* runtimeRepository.upsert({
-        threadId,
-        providerName: "claudeAgent",
-        providerInstanceId: null,
-        adapterKey: "claudeAgent",
-        runtimeMode: "full-access",
-        status: "running",
-        lastSeenAt: "2026-01-01T00:00:00.000Z",
-        resumeCursor: null,
-        runtimePayload: null,
-      });
-
-      yield* directory.upsert({
-        provider: ProviderDriverKind.make("codex"),
-        threadId,
-      });
-
-      const runtime = yield* runtimeRepository.getByThreadId({ threadId });
-      assert.equal(Option.isSome(runtime), true);
-      if (Option.isSome(runtime)) {
-        assert.equal(runtime.value.providerName, "codex");
-        assert.equal(runtime.value.adapterKey, "codex");
-      }
-    }));
-
-  it("rehydrates persisted mappings across layer restart", () =>
-    Effect.gen(function* () {
-      const tempDir = NodeFS.mkdtempSync(NodePath.join(NodeOS.tmpdir(), "t3-provider-directory-"));
-      const dbPath = NodePath.join(tempDir, "orchestration.sqlite");
-      const directoryLayer = makeDirectoryLayer(makeSqlitePersistenceLive(dbPath));
-
-      const threadId = ThreadId.make("thread-restart");
-
-      yield* Effect.gen(function* () {
-        const directory = yield* ProviderSessionDirectory;
-        yield* directory.upsert({
-          provider: ProviderDriverKind.make("codex"),
-          threadId,
-        });
-      }).pipe(Effect.provide(directoryLayer));
-
-      yield* Effect.gen(function* () {
-        const directory = yield* ProviderSessionDirectory;
-        const sql = yield* SqlClient.SqlClient;
-        const provider = yield* directory.getProvider(threadId);
-        assert.equal(provider, "codex");
-
-        const resolvedBinding = yield* directory.getBinding(threadId);
-        assertSome(resolvedBinding, {
-          threadId,
-          provider: ProviderDriverKind.make("codex"),
-        });
-        if (Option.isSome(resolvedBinding)) {
-          assert.equal(resolvedBinding.value.threadId, threadId);
-        }
-
-        const legacyTableRows = yield* sql<{ readonly name: string }>`
-          SELECT name
-          FROM sqlite_master
-          WHERE type = 'table' AND name = 'provider_sessions'
-        `;
-        assert.equal(legacyTableRows.length, 0);
-      }).pipe(Effect.provide(directoryLayer));
-
-      NodeFS.rmSync(tempDir, { recursive: true, force: true });
-    }));
-});
diff --git a/apps/server/src/provider/Layers/ProviderSessionDirectory.ts b/apps/server/src/provider/Layers/ProviderSessionDirectory.ts
deleted file mode 100644
index 23075bd9a06e..000000000000
--- a/apps/server/src/provider/Layers/ProviderSessionDirectory.ts
+++ /dev/null
@@ -1,201 +0,0 @@
-import { defaultInstanceIdForDriver, ProviderDriverKind, type ThreadId } from "@t3tools/contracts";
-import * as DateTime from "effect/DateTime";
-import * as Effect from "effect/Effect";
-import * as Layer from "effect/Layer";
-import * as Option from "effect/Option";
-import * as Schema from "effect/Schema";
-
-import * as ProviderSessionRuntime from "../../persistence/ProviderSessionRuntime.ts";
-import { ProviderSessionDirectoryPersistenceError, ProviderValidationError } from "../Errors.ts";
-import {
-  ProviderSessionDirectory,
-  type ProviderRuntimeBinding,
-  type ProviderRuntimeBindingWithMetadata,
-  type ProviderSessionDirectoryShape,
-} from "../Services/ProviderSessionDirectory.ts";
-const decodeProviderDriverKindValue = Schema.decodeUnknownEffect(ProviderDriverKind);
-
-function toPersistenceError(operation: string) {
-  return (cause: unknown) =>
-    new ProviderSessionDirectoryPersistenceError({
-      operation,
-      detail: `Failed to execute ${operation}.`,
-      cause,
-    });
-}
-
-function decodeProviderDriverKind(
-  providerName: string,
-  operation: string,
-): Effect.Effect<ProviderDriverKind, ProviderSessionDirectoryPersistenceError> {
-  return decodeProviderDriverKindValue(providerName).pipe(
-    Effect.mapError(
-      (cause) =>
-        new ProviderSessionDirectoryPersistenceError({
-          operation,
-          detail: `Unknown persisted provider '${providerName}'.`,
-          cause,
-        }),
-    ),
-  );
-}
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-
-function mergeRuntimePayload(
-  existing: unknown | null,
-  next: unknown | null | undefined,
-): unknown | null {
-  if (next === undefined) {
-    return existing ?? null;
-  }
-  if (isRecord(existing) && isRecord(next)) {
-    return { ...existing, ...next };
-  }
-  return next;
-}
-
-function toRuntimeBinding(
-  runtime: ProviderSessionRuntime.ProviderSessionRuntime,
-  operation: string,
-): Effect.Effect<ProviderRuntimeBindingWithMetadata, ProviderSessionDirectoryPersistenceError> {
-  return decodeProviderDriverKind(runtime.providerName, operation).pipe(
-    Effect.map(
-      (provider) =>
-        ({
-          threadId: runtime.threadId,
-          provider,
-          // Migration boundary only: rows written before the instance split
-          // have a null provider_instance_id. Promote them as they leave
-          // persistence so hot routing code never has to infer an instance
-          // from a driver kind.
-          providerInstanceId: runtime.providerInstanceId ?? defaultInstanceIdForDriver(provider),
-          adapterKey: runtime.adapterKey,
-          runtimeMode: runtime.runtimeMode,
-          status: runtime.status,
-          resumeCursor: runtime.resumeCursor,
-          runtimePayload: runtime.runtimePayload,
-          lastSeenAt: runtime.lastSeenAt,
-        }) satisfies ProviderRuntimeBindingWithMetadata,
-    ),
-  );
-}
-
-const makeProviderSessionDirectory = Effect.gen(function* () {
-  const repository = yield* ProviderSessionRuntime.ProviderSessionRuntimeRepository;
-
-  const getBinding = (threadId: ThreadId) =>
-    repository.getByThreadId({ threadId }).pipe(
-      Effect.mapError(toPersistenceError("ProviderSessionDirectory.getBinding:getByThreadId")),
-      Effect.flatMap((runtime) =>
-        Option.match(runtime, {
-          onNone: () => Effect.succeed(Option.none<ProviderRuntimeBinding>()),
-          onSome: (value) =>
-            toRuntimeBinding(value, "ProviderSessionDirectory.getBinding").pipe(
-              Effect.map((binding) => Option.some(binding)),
-            ),
-        }),
-      ),
-    );
-
-  const upsert: ProviderSessionDirectoryShape["upsert"] = Effect.fn(function* (binding) {
-    const existing = yield* repository
-      .getByThreadId({ threadId: binding.threadId })
-      .pipe(Effect.mapError(toPersistenceError("ProviderSessionDirectory.upsert:getByThreadId")));
-
-    const existingRuntime = Option.getOrUndefined(existing);
-    const resolvedThreadId = binding.threadId ?? existingRuntime?.threadId;
-    if (!resolvedThreadId) {
-      return yield* new ProviderValidationError({
-        operation: "ProviderSessionDirectory.upsert",
-        issue: "threadId must be a non-empty string.",
-      });
-    }
-
-    const now = DateTime.formatIso(yield* DateTime.now);
-    const providerChanged =
-      existingRuntime !== undefined && existingRuntime.providerName !== binding.provider;
-    const providerInstanceId =
-      binding.providerInstanceId ?? (!providerChanged ? existingRuntime?.providerInstanceId : null);
-    if (providerInstanceId === null || providerInstanceId === undefined) {
-      return yield* new ProviderValidationError({
-        operation: "ProviderSessionDirectory.upsert",
-        issue: "providerInstanceId is required for provider session runtime bindings.",
-      });
-    }
-    yield* repository
-      .upsert({
-        threadId: resolvedThreadId,
-        providerName: binding.provider,
-        providerInstanceId,
-        adapterKey:
-          binding.adapterKey ??
-          (providerChanged ? binding.provider : (existingRuntime?.adapterKey ?? binding.provider)),
-        runtimeMode: binding.runtimeMode ?? existingRuntime?.runtimeMode ?? "full-access",
-        status: binding.status ?? existingRuntime?.status ?? "running",
-        lastSeenAt: now,
-        resumeCursor:
-          binding.resumeCursor !== undefined
-            ? binding.resumeCursor
-            : (existingRuntime?.resumeCursor ?? null),
-        runtimePayload: mergeRuntimePayload(
-          existingRuntime?.runtimePayload ?? null,
-          binding.runtimePayload,
-        ),
-      })
-      .pipe(Effect.mapError(toPersistenceError("ProviderSessionDirectory.upsert:upsert")));
-  });
-
-  const getProvider: ProviderSessionDirectoryShape["getProvider"] = (threadId) =>
-    getBinding(threadId).pipe(
-      Effect.flatMap((binding) =>
-        Option.match(binding, {
-          onSome: (value) => Effect.succeed(value.provider),
-          onNone: () =>
-            Effect.fail(
-              new ProviderSessionDirectoryPersistenceError({
-                operation: "ProviderSessionDirectory.getProvider",
-                detail: `No persisted provider binding found for thread '${threadId}'.`,
-              }),
-            ),
-        }),
-      ),
-    );
-
-  const listThreadIds: ProviderSessionDirectoryShape["listThreadIds"] = () =>
-    repository.list().pipe(
-      Effect.mapError(toPersistenceError("ProviderSessionDirectory.listThreadIds:list")),
-      Effect.map((rows) => rows.map((row) => row.threadId)),
-    );
-
-  const listBindings: ProviderSessionDirectoryShape["listBindings"] = () =>
-    repository.list().pipe(
-      Effect.mapError(toPersistenceError("ProviderSessionDirectory.listBindings:list")),
-      Effect.flatMap((rows) =>
-        Effect.forEach(
-          rows,
-          (row) => toRuntimeBinding(row, "ProviderSessionDirectory.listBindings"),
-          { concurrency: "unbounded" },
-        ),
-      ),
-    );
-
-  return {
-    upsert,
-    getProvider,
-    getBinding,
-    listThreadIds,
-    listBindings,
-  } satisfies ProviderSessionDirectoryShape;
-});
-
-export const ProviderSessionDirectoryLive = Layer.effect(
-  ProviderSessionDirectory,
-  makeProviderSessionDirectory,
-);
-
-export function makeProviderSessionDirectoryLive() {
-  return Layer.effect(ProviderSessionDirectory, makeProviderSessionDirectory);
-}
diff --git a/apps/server/src/provider/Layers/ProviderSessionReaper.test.ts b/apps/server/src/provider/Layers/ProviderSessionReaper.test.ts
deleted file mode 100644
index 0b1bc9e149f7..000000000000
--- a/apps/server/src/provider/Layers/ProviderSessionReaper.test.ts
+++ /dev/null
@@ -1,639 +0,0 @@
-import * as NodeServices from "@effect/platform-node/NodeServices";
-import {
-  ProjectId,
-  ThreadId,
-  TurnId,
-  ProviderDriverKind,
-  ProviderInstanceId,
-} from "@t3tools/contracts";
-import * as Clock from "effect/Clock";
-import * as DateTime from "effect/DateTime";
-import * as Effect from "effect/Effect";
-import * as Exit from "effect/Exit";
-import * as Layer from "effect/Layer";
-import * as ManagedRuntime from "effect/ManagedRuntime";
-import * as Option from "effect/Option";
-import * as Scope from "effect/Scope";
-import * as Stream from "effect/Stream";
-import { afterEach, describe, expect, it, vi } from "vite-plus/test";
-
-import { ProjectionSnapshotQuery } from "../../orchestration/Services/ProjectionSnapshotQuery.ts";
-import { SqlitePersistenceMemory } from "../../persistence/Layers/Sqlite.ts";
-import * as ProviderSessionRuntime from "../../persistence/ProviderSessionRuntime.ts";
-import { ProviderValidationError } from "../Errors.ts";
-import { ProviderSessionReaper } from "../Services/ProviderSessionReaper.ts";
-import { ProviderService, type ProviderServiceShape } from "../Services/ProviderService.ts";
-import { ProviderSessionDirectoryLive } from "./ProviderSessionDirectory.ts";
-import { makeProviderSessionReaperLive } from "./ProviderSessionReaper.ts";
-
-const defaultModelSelection = {
-  instanceId: ProviderInstanceId.make("codex"),
-  model: "gpt-5-codex",
-} as const;
-
-async function waitFor(
-  predicate: () => boolean | Promise<boolean>,
-  timeoutMs = 2_000,
-): Promise<void> {
-  const deadline = (await Effect.runPromise(Clock.currentTimeMillis)) + timeoutMs;
-  const poll = async (): Promise<void> => {
-    if (await predicate()) {
-      return;
-    }
-    if ((await Effect.runPromise(Clock.currentTimeMillis)) >= deadline) {
-      throw new Error("Timed out waiting for expectation.");
-    }
-    await Effect.runPromise(Effect.yieldNow);
-    return poll();
-  };
-
-  return poll();
-}
-
-const drainFibers = Effect.forEach(Array.from({ length: 10 }), () => Effect.yieldNow, {
-  discard: true,
-});
-
-const unsupported = () => Effect.die(new Error("Unsupported provider call in test")) as never;
-
-function makeReadModel(
-  threads: ReadonlyArray<{
-    readonly id: ThreadId;
-    readonly session: {
-      readonly threadId: ThreadId;
-      readonly status: "starting" | "running" | "ready" | "interrupted" | "stopped" | "error";
-      readonly providerName: "codex" | "claudeAgent";
-      readonly runtimeMode: "approval-required" | "full-access" | "auto-accept-edits";
-      readonly activeTurnId: TurnId | null;
-      readonly lastError: string | null;
-      readonly updatedAt: string;
-    } | null;
-    readonly backgroundLiveness?: "working" | "monitoring" | null;
-  }>,
-) {
-  const now = "2026-01-01T00:00:00.000Z";
-  const projectId = ProjectId.make("project-provider-session-reaper");
-
-  return {
-    snapshotSequence: 0,
-    updatedAt: now,
-    projects: [
-      {
-        id: projectId,
-        title: "Provider Reaper Project",
-        workspaceRoot: "/tmp/provider-reaper-project",
-        defaultModelSelection,
-        scripts: [],
-        createdAt: now,
-        updatedAt: now,
-        deletedAt: null,
-      },
-    ],
-    threads: threads.map((thread) => ({
-      id: thread.id,
-      projectId,
-      title: `Thread ${thread.id}`,
-      modelSelection: defaultModelSelection,
-      interactionMode: "default" as const,
-      runtimeMode: "full-access" as const,
-      branch: null,
-      worktreePath: null,
-      createdAt: now,
-      updatedAt: now,
-      archivedAt: null,
-      settledOverride: null,
-      settledAt: null,
-      latestUserMessageAt: null,
-      hasPendingApprovals: false,
-      hasPendingUserInput: false,
-      hasActionableProposedPlan: false,
-      latestTurn: null,
-      messages: [],
-      session: thread.session,
-      backgroundLiveness: thread.backgroundLiveness ?? null,
-      activities: [],
-      proposedPlans: [],
-      checkpoints: [],
-      deletedAt: null,
-    })),
-  };
-}
-
-describe("ProviderSessionReaper", () => {
-  let runtime: ManagedRuntime.ManagedRuntime<
-    ProviderSessionReaper | ProviderSessionRuntime.ProviderSessionRuntimeRepository,
-    unknown
-  > | null = null;
-  let scope: Scope.Closeable | null = null;
-
-  afterEach(async () => {
-    if (scope) {
-      await Effect.runPromise(Scope.close(scope, Exit.void));
-    }
-    scope = null;
-    if (runtime) {
-      await runtime.dispose();
-    }
-    runtime = null;
-  });
-
-  // Shared start sequence so each test adds no manual Effect runners
-  // (no-manual-effect-runtime-in-tests tracks this file's legacy count).
-  async function startReaper() {
-    const reaper = await runtime!.runPromise(Effect.service(ProviderSessionReaper));
-    scope = await Effect.runPromise(Scope.make("sequential"));
-    await Effect.runPromise(reaper.start().pipe(Scope.provide(scope)));
-  }
-
-  async function createHarness(input: {
-    readonly readModel: ReturnType<typeof makeReadModel>;
-    readonly stopSessionImplementation?: (input: {
-      readonly threadId: ThreadId;
-    }) => ReturnType<ProviderServiceShape["stopSession"]>;
-  }) {
-    const stoppedThreadIds = new Set<ThreadId>();
-    const stopSession = vi.fn<ProviderServiceShape["stopSession"]>(
-      (request) =>
-        (input.stopSessionImplementation
-          ? input.stopSessionImplementation(request)
-          : Effect.sync(() => {
-              stoppedThreadIds.add(request.threadId);
-            })) as ReturnType<ProviderServiceShape["stopSession"]>,
-    );
-
-    const providerService: ProviderServiceShape = {
-      startSession: () => unsupported(),
-      sendTurn: () => unsupported(),
-      interruptTurn: () => unsupported(),
-      respondToRequest: () => unsupported(),
-      respondToUserInput: () => unsupported(),
-      stopSession,
-      listSessions: () => Effect.succeed([]),
-      getCapabilities: () => Effect.succeed({ sessionModelSwitch: "in-session" }),
-      getInstanceInfo: (instanceId) => {
-        const driverKind = ProviderDriverKind.make(String(instanceId));
-        return Effect.succeed({
-          instanceId,
-          driverKind,
-          displayName: undefined,
-          enabled: true,
-          continuationIdentity: {
-            driverKind,
-            continuationKey: `${driverKind}:instance:${instanceId}`,
-          },
-        });
-      },
-      rollbackConversation: () => unsupported(),
-      uploadFeedback: () => unsupported(),
-      streamEvents: Stream.empty,
-    };
-
-    const runtimeRepositoryLayer = ProviderSessionRuntime.layer.pipe(
-      Layer.provide(SqlitePersistenceMemory),
-    );
-    const providerSessionDirectoryLayer = ProviderSessionDirectoryLive.pipe(
-      Layer.provide(runtimeRepositoryLayer),
-    );
-    const layer = makeProviderSessionReaperLive({
-      inactivityThresholdMs: 1_000,
-      sweepIntervalMs: 60_000,
-    }).pipe(
-      Layer.provideMerge(providerSessionDirectoryLayer),
-      Layer.provideMerge(runtimeRepositoryLayer),
-      Layer.provideMerge(Layer.succeed(ProviderService, providerService)),
-      Layer.provideMerge(
-        Layer.succeed(ProjectionSnapshotQuery, {
-          getCommandReadModel: () => Effect.die("unused"),
-          getSnapshot: () => Effect.die("unused"),
-          getShellSnapshot: () => Effect.die("unused"),
-          getArchivedShellSnapshot: () => Effect.die("unused"),
-          getSnapshotSequence: () =>
-            Effect.succeed({ snapshotSequence: input.readModel.snapshotSequence }),
-          getCounts: () => Effect.die("unused"),
-          getActiveProjectByWorkspaceRoot: () => Effect.die("unused"),
-          getProjectShellById: () => Effect.die("unused"),
-          getFirstActiveThreadIdByProjectId: () => Effect.die("unused"),
-          getThreadCheckpointContext: () => Effect.die("unused"),
-          getFullThreadDiffContext: () => Effect.die("unused"),
-          getThreadShellById: (threadId) =>
-            Effect.succeed(
-              input.readModel.threads.find((thread) => thread.id === threadId)
-                ? Option.some(input.readModel.threads.find((thread) => thread.id === threadId)!)
-                : Option.none(),
-            ),
-          getThreadDetailById: () => Effect.die("unused"),
-          getThreadDetailSnapshot: () => Effect.die("unused"),
-          searchThreads: () => Effect.succeed({ matches: [] }),
-        }),
-      ),
-      Layer.provideMerge(NodeServices.layer),
-    );
-
-    runtime = ManagedRuntime.make(layer);
-    return { stopSession, stoppedThreadIds };
-  }
-
-  it("reaps stale persisted sessions without active turns", async () => {
-    const threadId = ThreadId.make("thread-reaper-stale");
-    const now = "2026-01-01T00:00:00.000Z";
-    const harness = await createHarness({
-      readModel: makeReadModel([
-        {
-          id: threadId,
-          session: {
-            threadId,
-            status: "ready",
-            providerName: "claudeAgent",
-            runtimeMode: "full-access",
-            activeTurnId: null,
-            lastError: null,
-            updatedAt: now,
-          },
-        },
-      ]),
-    });
-    const repository = await runtime!.runPromise(
-      Effect.service(ProviderSessionRuntime.ProviderSessionRuntimeRepository),
-    );
-
-    await runtime!.runPromise(
-      repository.upsert({
-        threadId,
-        providerName: "claudeAgent",
-        providerInstanceId: null,
-        adapterKey: "claudeAgent",
-        runtimeMode: "full-access",
-        status: "running",
-        lastSeenAt: "2026-04-14T00:00:00.000Z",
-        resumeCursor: {
-          opaque: "resume-stale",
-        },
-        runtimePayload: null,
-      }),
-    );
-
-    await startReaper();
-
-    await waitFor(() => harness.stopSession.mock.calls.length === 1);
-
-    expect(harness.stopSession.mock.calls[0]?.[0]).toEqual({ threadId });
-    expect(harness.stoppedThreadIds.has(threadId)).toBe(true);
-  });
-
-  it("skips stale sessions when the thread still has an active turn", async () => {
-    const threadId = ThreadId.make("thread-reaper-active-turn");
-    const turnId = TurnId.make("turn-reaper-active");
-    const now = "2026-01-01T00:00:00.000Z";
-    const harness = await createHarness({
-      readModel: makeReadModel([
-        {
-          id: threadId,
-          session: {
-            threadId,
-            status: "running",
-            providerName: "claudeAgent",
-            runtimeMode: "full-access",
-            activeTurnId: turnId,
-            lastError: null,
-            updatedAt: now,
-          },
-        },
-      ]),
-    });
-    const repository = await runtime!.runPromise(
-      Effect.service(ProviderSessionRuntime.ProviderSessionRuntimeRepository),
-    );
-
-    await runtime!.runPromise(
-      repository.upsert({
-        threadId,
-        providerName: "claudeAgent",
-        providerInstanceId: null,
-        adapterKey: "claudeAgent",
-        runtimeMode: "full-access",
-        status: "running",
-        lastSeenAt: "2026-04-14T00:00:00.000Z",
-        resumeCursor: {
-          opaque: "resume-active-turn",
-        },
-        runtimePayload: null,
-      }),
-    );
-
-    await startReaper();
-    await Effect.runPromise(drainFibers);
-
-    expect(harness.stopSession).not.toHaveBeenCalled();
-    const remaining = await runtime!.runPromise(repository.getByThreadId({ threadId }));
-    expect(Option.isSome(remaining)).toBe(true);
-  });
-
-  it("skips stale sessions while background work is still live", async () => {
-    const threadId = ThreadId.make("thread-reaper-background-work");
-    const now = "2026-01-01T00:00:00.000Z";
-    const harness = await createHarness({
-      readModel: makeReadModel([
-        {
-          id: threadId,
-          session: {
-            threadId,
-            status: "ready",
-            providerName: "claudeAgent",
-            runtimeMode: "full-access",
-            activeTurnId: null,
-            lastError: null,
-            updatedAt: now,
-          },
-          backgroundLiveness: "working",
-        },
-      ]),
-    });
-    const repository = await runtime!.runPromise(
-      Effect.service(ProviderSessionRuntime.ProviderSessionRuntimeRepository),
-    );
-
-    await runtime!.runPromise(
-      repository.upsert({
-        threadId,
-        providerName: "claudeAgent",
-        providerInstanceId: null,
-        adapterKey: "claudeAgent",
-        runtimeMode: "full-access",
-        status: "running",
-        lastSeenAt: "2026-04-14T00:00:00.000Z",
-        resumeCursor: {
-          opaque: "resume-background-work",
-        },
-        runtimePayload: null,
-      }),
-    );
-
-    await startReaper();
-    await Effect.runPromise(drainFibers);
-
-    expect(harness.stopSession).not.toHaveBeenCalled();
-    const remaining = await runtime!.runPromise(repository.getByThreadId({ threadId }));
-    expect(Option.isSome(remaining)).toBe(true);
-  });
-
-  it("does not reap sessions that are still within the inactivity threshold", async () => {
-    const threadId = ThreadId.make("thread-reaper-fresh");
-    const now = DateTime.formatIso(await Effect.runPromise(DateTime.now));
-    const harness = await createHarness({
-      readModel: makeReadModel([
-        {
-          id: threadId,
-          session: {
-            threadId,
-            status: "ready",
-            providerName: "claudeAgent",
-            runtimeMode: "full-access",
-            activeTurnId: null,
-            lastError: null,
-            updatedAt: now,
-          },
-        },
-      ]),
-    });
-    const repository = await runtime!.runPromise(
-      Effect.service(ProviderSessionRuntime.ProviderSessionRuntimeRepository),
-    );
-
-    await runtime!.runPromise(
-      repository.upsert({
-        threadId,
-        providerName: "claudeAgent",
-        providerInstanceId: null,
-        adapterKey: "claudeAgent",
-        runtimeMode: "full-access",
-        status: "running",
-        lastSeenAt: now,
-        resumeCursor: {
-          opaque: "resume-fresh",
-        },
-        runtimePayload: null,
-      }),
-    );
-
-    await startReaper();
-    await Effect.runPromise(drainFibers);
-
-    expect(harness.stopSession).not.toHaveBeenCalled();
-    const remaining = await runtime!.runPromise(repository.getByThreadId({ threadId }));
-    expect(Option.isSome(remaining)).toBe(true);
-  });
-
-  it("skips persisted sessions that are already marked stopped", async () => {
-    const threadId = ThreadId.make("thread-reaper-stopped");
-    const now = "2026-01-01T00:00:00.000Z";
-    const harness = await createHarness({
-      readModel: makeReadModel([
-        {
-          id: threadId,
-          session: {
-            threadId,
-            status: "stopped",
-            providerName: "claudeAgent",
-            runtimeMode: "full-access",
-            activeTurnId: null,
-            lastError: null,
-            updatedAt: now,
-          },
-        },
-      ]),
-    });
-    const repository = await runtime!.runPromise(
-      Effect.service(ProviderSessionRuntime.ProviderSessionRuntimeRepository),
-    );
-
-    await runtime!.runPromise(
-      repository.upsert({
-        threadId,
-        providerName: "claudeAgent",
-        providerInstanceId: null,
-        adapterKey: "claudeAgent",
-        runtimeMode: "full-access",
-        status: "stopped",
-        lastSeenAt: "2026-04-14T00:00:00.000Z",
-        resumeCursor: {
-          opaque: "resume-stopped",
-        },
-        runtimePayload: null,
-      }),
-    );
-
-    await startReaper();
-    await Effect.runPromise(drainFibers);
-
-    expect(harness.stopSession).not.toHaveBeenCalled();
-    const remaining = await runtime!.runPromise(repository.getByThreadId({ threadId }));
-    expect(Option.isSome(remaining)).toBe(true);
-  });
-
-  it("continues reaping other sessions when one stop attempt fails", async () => {
-    const failedThreadId = ThreadId.make("thread-reaper-stop-failure");
-    const reapedThreadId = ThreadId.make("thread-reaper-stop-success");
-    const now = "2026-01-01T00:00:00.000Z";
-    const harness = await createHarness({
-      readModel: makeReadModel([
-        {
-          id: failedThreadId,
-          session: {
-            threadId: failedThreadId,
-            status: "ready",
-            providerName: "claudeAgent",
-            runtimeMode: "full-access",
-            activeTurnId: null,
-            lastError: null,
-            updatedAt: now,
-          },
-        },
-        {
-          id: reapedThreadId,
-          session: {
-            threadId: reapedThreadId,
-            status: "ready",
-            providerName: "codex",
-            runtimeMode: "full-access",
-            activeTurnId: null,
-            lastError: null,
-            updatedAt: now,
-          },
-        },
-      ]),
-      stopSessionImplementation: (request) =>
-        request.threadId === failedThreadId
-          ? Effect.fail(
-              new ProviderValidationError({
-                operation: "ProviderSessionReaper.test",
-                issue: "simulated stop failure",
-              }),
-            )
-          : Effect.void,
-    });
-    const repository = await runtime!.runPromise(
-      Effect.service(ProviderSessionRuntime.ProviderSessionRuntimeRepository),
-    );
-
-    await runtime!.runPromise(
-      repository.upsert({
-        threadId: failedThreadId,
-        providerName: "claudeAgent",
-        providerInstanceId: null,
-        adapterKey: "claudeAgent",
-        runtimeMode: "full-access",
-        status: "running",
-        lastSeenAt: "2026-04-14T00:00:00.000Z",
-        resumeCursor: {
-          opaque: "resume-failure",
-        },
-        runtimePayload: null,
-      }),
-    );
-    await runtime!.runPromise(
-      repository.upsert({
-        threadId: reapedThreadId,
-        providerName: "codex",
-        providerInstanceId: null,
-        adapterKey: "codex",
-        runtimeMode: "full-access",
-        status: "running",
-        lastSeenAt: "2026-04-14T00:01:00.000Z",
-        resumeCursor: {
-          opaque: "resume-success",
-        },
-        runtimePayload: null,
-      }),
-    );
-
-    await startReaper();
-
-    await waitFor(() => harness.stopSession.mock.calls.length === 2);
-
-    expect(harness.stopSession.mock.calls.map(([request]) => request.threadId)).toEqual([
-      failedThreadId,
-      reapedThreadId,
-    ]);
-  });
-
-  it("continues reaping other sessions when one stop attempt defects", async () => {
-    const defectThreadId = ThreadId.make("thread-reaper-stop-defect");
-    const reapedThreadId = ThreadId.make("thread-reaper-stop-after-defect");
-    const now = "2026-01-01T00:00:00.000Z";
-    const harness = await createHarness({
-      readModel: makeReadModel([
-        {
-          id: defectThreadId,
-          session: {
-            threadId: defectThreadId,
-            status: "ready",
-            providerName: "claudeAgent",
-            runtimeMode: "full-access",
-            activeTurnId: null,
-            lastError: null,
-            updatedAt: now,
-          },
-        },
-        {
-          id: reapedThreadId,
-          session: {
-            threadId: reapedThreadId,
-            status: "ready",
-            providerName: "codex",
-            runtimeMode: "full-access",
-            activeTurnId: null,
-            lastError: null,
-            updatedAt: now,
-          },
-        },
-      ]),
-      stopSessionImplementation: (request) =>
-        request.threadId === defectThreadId
-          ? Effect.die(new Error("simulated stop defect"))
-          : Effect.void,
-    });
-    const repository = await runtime!.runPromise(
-      Effect.service(ProviderSessionRuntime.ProviderSessionRuntimeRepository),
-    );
-
-    await runtime!.runPromise(
-      repository.upsert({
-        threadId: defectThreadId,
-        providerName: "claudeAgent",
-        providerInstanceId: null,
-        adapterKey: "claudeAgent",
-        runtimeMode: "full-access",
-        status: "running",
-        lastSeenAt: "2026-04-14T00:00:00.000Z",
-        resumeCursor: {
-          opaque: "resume-defect",
-        },
-        runtimePayload: null,
-      }),
-    );
-    await runtime!.runPromise(
-      repository.upsert({
-        threadId: reapedThreadId,
-        providerName: "codex",
-        providerInstanceId: null,
-        adapterKey: "codex",
-        runtimeMode: "full-access",
-        status: "running",
-        lastSeenAt: "2026-04-14T00:01:00.000Z",
-        resumeCursor: {
-          opaque: "resume-after-defect",
-        },
-        runtimePayload: null,
-      }),
-    );
-
-    await startReaper();
-
-    await waitFor(() => harness.stopSession.mock.calls.length === 2);
-
-    expect(harness.stopSession.mock.calls.map(([request]) => request.threadId)).toEqual([
-      defectThreadId,
-      reapedThreadId,
-    ]);
-  });
-});
diff --git a/apps/server/src/provider/Layers/ProviderSessionReaper.ts b/apps/server/src/provider/Layers/ProviderSessionReaper.ts
deleted file mode 100644
index 15d4f925c39e..000000000000
--- a/apps/server/src/provider/Layers/ProviderSessionReaper.ts
+++ /dev/null
@@ -1,152 +0,0 @@
-import * as Clock from "effect/Clock";
-import * as Duration from "effect/Duration";
-import * as Effect from "effect/Effect";
-import * as Layer from "effect/Layer";
-import * as Option from "effect/Option";
-import * as Schedule from "effect/Schedule";
-
-import { ProjectionSnapshotQuery } from "../../orchestration/Services/ProjectionSnapshotQuery.ts";
-import { ProviderSessionDirectory } from "../Services/ProviderSessionDirectory.ts";
-import {
-  ProviderSessionReaper,
-  type ProviderSessionReaperShape,
-} from "../Services/ProviderSessionReaper.ts";
-import { forkParked } from "../../serverActivation.ts";
-import { ProviderService } from "../Services/ProviderService.ts";
-
-const DEFAULT_INACTIVITY_THRESHOLD_MS = 30 * 60 * 1000;
-const DEFAULT_SWEEP_INTERVAL_MS = 5 * 60 * 1000;
-
-export interface ProviderSessionReaperLiveOptions {
-  readonly inactivityThresholdMs?: number;
-  readonly sweepIntervalMs?: number;
-}
-
-const makeProviderSessionReaper = (options?: ProviderSessionReaperLiveOptions) =>
-  Effect.gen(function* () {
-    const providerService = yield* ProviderService;
-    const directory = yield* ProviderSessionDirectory;
-    const projectionSnapshotQuery = yield* ProjectionSnapshotQuery;
-
-    const inactivityThresholdMs = Math.max(
-      1,
-      options?.inactivityThresholdMs ?? DEFAULT_INACTIVITY_THRESHOLD_MS,
-    );
-    const sweepIntervalMs = Math.max(1, options?.sweepIntervalMs ?? DEFAULT_SWEEP_INTERVAL_MS);
-
-    const sweep = Effect.gen(function* () {
-      const bindings = yield* directory.listBindings();
-      const now = yield* Clock.currentTimeMillis;
-      let reapedCount = 0;
-
-      for (const binding of bindings) {
-        if (binding.status === "stopped") {
-          continue;
-        }
-
-        const lastSeenMs = Date.parse(binding.lastSeenAt);
-        if (Number.isNaN(lastSeenMs)) {
-          yield* Effect.logWarning("provider.session.reaper.invalid-last-seen", {
-            threadId: binding.threadId,
-            provider: binding.provider,
-            lastSeenAt: binding.lastSeenAt,
-          });
-          continue;
-        }
-
-        const idleDurationMs = now - lastSeenMs;
-        if (idleDurationMs < inactivityThresholdMs) {
-          continue;
-        }
-
-        const thread = yield* projectionSnapshotQuery
-          .getThreadShellById(binding.threadId)
-          .pipe(Effect.map(Option.getOrUndefined));
-        if (thread?.session?.activeTurnId != null) {
-          yield* Effect.logDebug("provider.session.reaper.skipped-active-turn", {
-            threadId: binding.threadId,
-            activeTurnId: thread.session.activeTurnId,
-            idleDurationMs,
-          });
-          continue;
-        }
-
-        // The turn can settle while background work runs on (subagent
-        // fleets, workflow runs, Monitor watch loops). Those live inside the
-        // provider process, so stopping the session would kill them silently,
-        // and nothing bumps lastSeenAt between turns.
-        if (thread?.backgroundLiveness != null) {
-          yield* Effect.logDebug("provider.session.reaper.skipped-background-work", {
-            threadId: binding.threadId,
-            backgroundLiveness: thread.backgroundLiveness,
-            idleDurationMs,
-          });
-          continue;
-        }
-
-        const reaped = yield* providerService.stopSession({ threadId: binding.threadId }).pipe(
-          Effect.tap(() =>
-            Effect.logInfo("provider.session.reaped", {
-              threadId: binding.threadId,
-              provider: binding.provider,
-              idleDurationMs,
-              reason: "inactivity_threshold",
-            }),
-          ),
-          Effect.as(true),
-          Effect.catchCause((cause) =>
-            Effect.logWarning("provider.session.reaper.stop-failed", {
-              threadId: binding.threadId,
-              provider: binding.provider,
-              idleDurationMs,
-              cause,
-            }).pipe(Effect.as(false)),
-          ),
-        );
-
-        if (reaped) {
-          reapedCount += 1;
-        }
-      }
-
-      if (reapedCount > 0) {
-        yield* Effect.logInfo("provider.session.reaper.sweep-complete", {
-          reapedCount,
-          totalBindings: bindings.length,
-        });
-      }
-    });
-
-    const start: ProviderSessionReaperShape["start"] = () =>
-      Effect.gen(function* () {
-        yield* forkParked(
-          sweep.pipe(
-            Effect.catch((error: unknown) =>
-              Effect.logWarning("provider.session.reaper.sweep-failed", {
-                error,
-              }),
-            ),
-            Effect.catchDefect((defect: unknown) =>
-              Effect.logWarning("provider.session.reaper.sweep-defect", {
-                defect,
-              }),
-            ),
-            Effect.repeat(Schedule.spaced(Duration.millis(sweepIntervalMs))),
-          ),
-        );
-
-        yield* Effect.logInfo("provider.session.reaper.started", {
-          inactivityThresholdMs,
-          sweepIntervalMs,
-        });
-      });
-
-    return {
-      start,
-    } satisfies ProviderSessionReaperShape;
-  });
-
-export const makeProviderSessionReaperLive = (options?: ProviderSessionReaperLiveOptions) =>
-  Layer.effect(ProviderSessionReaper, makeProviderSessionReaper(options));
-
-export const ProviderSessionReaperLive = makeProviderSessionReaperLive();
diff --git a/apps/server/src/provider/NativeProtocolLogging.ts b/apps/server/src/provider/NativeProtocolLogging.ts
new file mode 100644
index 000000000000..a85833b0e862
--- /dev/null
+++ b/apps/server/src/provider/NativeProtocolLogging.ts
@@ -0,0 +1,40 @@
+import { errorTag } from "@t3tools/shared/observability";
+
+export function structuralProtocolMethod(value: string): string {
+  return value.length <= 128 && /^[A-Za-z][A-Za-z0-9._:/-]*$/.test(value) ? value : "unknown";
+}
+
+/**
+ * Retain only bounded structural metadata for native protocol diagnostics.
+ * Provider payload values may contain prompts, credentials, or arbitrarily
+ * large tool output and must never be copied into the observability stream.
+ */
+export function summarizeNativeProtocolPayload(
+  payload: unknown,
+): Readonly<Record<string, unknown>> {
+  if (payload === null) return { valueType: "null" };
+  if (typeof payload === "string") {
+    return { valueType: "string", byteLength: new TextEncoder().encode(payload).byteLength };
+  }
+  if (payload instanceof Uint8Array) {
+    return { valueType: "bytes", byteLength: payload.byteLength };
+  }
+  if (Array.isArray(payload)) {
+    return { valueType: "array", itemCount: payload.length };
+  }
+  if (typeof payload !== "object") {
+    return { valueType: typeof payload };
+  }
+
+  try {
+    const record = payload as Record<string, unknown>;
+    return {
+      valueType: "object",
+      fieldCount: Object.keys(record).length,
+      ...(typeof record._tag === "string" ? { messageTag: errorTag(record) } : {}),
+      ...(typeof record.tag === "string" ? { method: structuralProtocolMethod(record.tag) } : {}),
+    };
+  } catch {
+    return { valueType: "object" };
+  }
+}
diff --git a/apps/server/src/provider/ProviderDriver.ts b/apps/server/src/provider/ProviderDriver.ts
index c738882c23a4..50205103e3bc 100644
--- a/apps/server/src/provider/ProviderDriver.ts
+++ b/apps/server/src/provider/ProviderDriver.ts
@@ -2,8 +2,8 @@
  * ProviderDriver / ProviderInstance — driver SPI as plain values.
  *
  * `ProviderDriver` is a record, not a Context.Service. The thing it produces
- * (`ProviderInstance`) is also a record — three captured closures
- * (`snapshot`, `adapter`, `textGeneration`), an id, and a driver kind. There
+ * (`ProviderInstance`) is also a record of captured closures
+ * (`snapshot`, `orchestrationAdapter`, `textGeneration`), an id, and a driver kind. There
  * are intentionally no per-driver Context tags because tags are
  * singleton-per-runtime and we need many instances of the same driver.
  *
@@ -30,9 +30,9 @@ import type * as Effect from "effect/Effect";
 import type * as Schema from "effect/Schema";
 import type * as Scope from "effect/Scope";
 
-import type * as TextGeneration from "../textGeneration/TextGeneration.ts";
-import type { ProviderAdapterError, ProviderDriverError } from "./Errors.ts";
-import type { ProviderAdapterShape } from "./Services/ProviderAdapter.ts";
+import type { TextGenerationShape } from "../textGeneration/TextGeneration.ts";
+import type { ProviderAdapterV2Shape } from "../orchestration-v2/ProviderAdapter.ts";
+import type { ProviderDriverError } from "./Errors.ts";
 import type { ServerProviderShape } from "./Services/ServerProvider.ts";
 
 /**
@@ -69,8 +69,8 @@ export interface ProviderInstance {
   readonly accentColor?: string | undefined;
   readonly enabled: boolean;
   readonly snapshot: ServerProviderShape;
-  readonly adapter: ProviderAdapterShape<ProviderAdapterError>;
-  readonly textGeneration: TextGeneration.TextGeneration["Service"];
+  readonly orchestrationAdapter: ProviderAdapterV2Shape;
+  readonly textGeneration: TextGenerationShape;
 }
 
 export interface ProviderContinuationIdentity {
diff --git a/apps/server/src/provider/Services/ClaudeAdapter.ts b/apps/server/src/provider/Services/ClaudeAdapter.ts
deleted file mode 100644
index ed9bd7081bc7..000000000000
--- a/apps/server/src/provider/Services/ClaudeAdapter.ts
+++ /dev/null
@@ -1,19 +0,0 @@
-/**
- * ClaudeAdapter — shape type for the Claude provider adapter.
- *
- * Historically this module exposed a `Context.Service` tag so consumers
- * could inject the adapter through the Effect layer graph. The driver
- * model ({@link ../Drivers/ClaudeDriver}) bundles one adapter per
- * instance as a captured closure instead, so the tag is gone — we only
- * retain the shape interface as a naming anchor for the driver bundle.
- *
- * @module ClaudeAdapter
- */
-import type { ProviderAdapterError } from "../Errors.ts";
-import type { ProviderAdapterShape } from "./ProviderAdapter.ts";
-
-/**
- * ClaudeAdapterShape — per-instance Claude adapter contract. Carries
- * a branded driver kind as the nominal discriminant.
- */
-export interface ClaudeAdapterShape extends ProviderAdapterShape<ProviderAdapterError> {}
diff --git a/apps/server/src/provider/Services/CodexAdapter.ts b/apps/server/src/provider/Services/CodexAdapter.ts
deleted file mode 100644
index a0d9c0c28e9e..000000000000
--- a/apps/server/src/provider/Services/CodexAdapter.ts
+++ /dev/null
@@ -1,23 +0,0 @@
-/**
- * CodexAdapter — shape type for the Codex provider adapter.
- *
- * Historically this module exposed a `Context.Service` tag so consumers
- * could inject the adapter through the Effect layer graph. The driver
- * model ({@link ../Drivers/CodexDriver}) bundles one adapter per
- * instance as a captured closure instead, so the tag is gone — we only
- * retain the shape interface as a naming anchor for the driver bundle.
- *
- * @module CodexAdapter
- */
-import type { ProviderAdapterError } from "../Errors.ts";
-import type { ProviderAdapterShape } from "./ProviderAdapter.ts";
-
-/**
- * CodexAdapterShape — per-instance Codex adapter contract. Carries
- * a branded driver kind as the nominal discriminant.
- */
-export interface CodexAdapterShape extends ProviderAdapterShape<ProviderAdapterError> {
-  readonly uploadFeedback: NonNullable<
-    ProviderAdapterShape<ProviderAdapterError>["uploadFeedback"]
-  >;
-}
diff --git a/apps/server/src/provider/Services/CursorAdapter.ts b/apps/server/src/provider/Services/CursorAdapter.ts
deleted file mode 100644
index 83581f0a4545..000000000000
--- a/apps/server/src/provider/Services/CursorAdapter.ts
+++ /dev/null
@@ -1,19 +0,0 @@
-/**
- * CursorAdapter — shape type for the Cursor provider adapter.
- *
- * Historically this module exposed a `Context.Service` tag so consumers
- * could inject the adapter through the Effect layer graph. The driver
- * model ({@link ../Drivers/CursorDriver}) bundles one adapter per
- * instance as a captured closure instead, so the tag is gone — we only
- * retain the shape interface as a naming anchor for the driver bundle.
- *
- * @module CursorAdapter
- */
-import type { ProviderAdapterError } from "../Errors.ts";
-import type { ProviderAdapterShape } from "./ProviderAdapter.ts";
-
-/**
- * CursorAdapterShape — per-instance Cursor adapter contract. Carries
- * a branded driver kind as the nominal discriminant.
- */
-export interface CursorAdapterShape extends ProviderAdapterShape<ProviderAdapterError> {}
diff --git a/apps/server/src/provider/Services/GrokAdapter.ts b/apps/server/src/provider/Services/GrokAdapter.ts
deleted file mode 100644
index 73254cefe393..000000000000
--- a/apps/server/src/provider/Services/GrokAdapter.ts
+++ /dev/null
@@ -1,16 +0,0 @@
-/**
- * GrokAdapter — shape type for the Grok provider adapter.
- *
- * The driver model ({@link ../Drivers/GrokDriver}) bundles one adapter per
- * instance as a captured closure, so this module only retains the shape
- * interface as a naming anchor for the driver bundle.
- *
- * @module GrokAdapter
- */
-import type { ProviderAdapterError } from "../Errors.ts";
-import type { ProviderAdapterShape } from "./ProviderAdapter.ts";
-
-/**
- * GrokAdapterShape — per-instance Grok adapter contract.
- */
-export interface GrokAdapterShape extends ProviderAdapterShape<ProviderAdapterError> {}
diff --git a/apps/server/src/provider/Services/OpenCodeAdapter.ts b/apps/server/src/provider/Services/OpenCodeAdapter.ts
deleted file mode 100644
index e3ad97904d18..000000000000
--- a/apps/server/src/provider/Services/OpenCodeAdapter.ts
+++ /dev/null
@@ -1,19 +0,0 @@
-/**
- * OpenCodeAdapter — shape type for the OpenCode provider adapter.
- *
- * Historically this module exposed a `Context.Service` tag so consumers
- * could inject the adapter through the Effect layer graph. The driver
- * model ({@link ../Drivers/OpenCodeDriver}) bundles one adapter per
- * instance as a captured closure instead, so the tag is gone — we only
- * retain the shape interface as a naming anchor for the driver bundle.
- *
- * @module OpenCodeAdapter
- */
-import type { ProviderAdapterError } from "../Errors.ts";
-import type { ProviderAdapterShape } from "./ProviderAdapter.ts";
-
-/**
- * OpenCodeAdapterShape — per-instance OpenCode adapter contract. Carries
- * a branded driver kind as the nominal discriminant.
- */
-export interface OpenCodeAdapterShape extends ProviderAdapterShape<ProviderAdapterError> {}
diff --git a/apps/server/src/provider/Services/ProviderAdapter.ts b/apps/server/src/provider/Services/ProviderAdapter.ts
deleted file mode 100644
index 634745832b37..000000000000
--- a/apps/server/src/provider/Services/ProviderAdapter.ts
+++ /dev/null
@@ -1,135 +0,0 @@
-/**
- * ProviderAdapter - Provider-specific runtime adapter contract.
- *
- * Defines the provider-native session/protocol operations that `ProviderService`
- * routes to after resolving the target provider. Implementations should focus
- * on provider behavior only and avoid cross-provider orchestration concerns.
- *
- * @module ProviderAdapter
- */
-import type {
-  ApprovalRequestId,
-  ProviderApprovalDecision,
-  ProviderDriverKind,
-  ProviderUserInputAnswers,
-  ProviderRuntimeEvent,
-  ProviderSendTurnInput,
-  ProviderSession,
-  ProviderSessionStartInput,
-  ProviderUploadFeedbackInput,
-  ProviderUploadFeedbackResult,
-  ThreadId,
-  ProviderTurnStartResult,
-  TurnId,
-} from "@t3tools/contracts";
-import type * as Effect from "effect/Effect";
-import type * as Stream from "effect/Stream";
-
-export type ProviderSessionModelSwitchMode = "in-session" | "unsupported";
-
-export interface ProviderAdapterCapabilities {
-  /**
-   * Declares whether changing the model on an existing session is supported.
-   */
-  readonly sessionModelSwitch: ProviderSessionModelSwitchMode;
-}
-
-export interface ProviderThreadTurnSnapshot {
-  readonly id: TurnId;
-  readonly items: ReadonlyArray<unknown>;
-}
-
-export interface ProviderThreadSnapshot {
-  readonly threadId: ThreadId;
-  readonly turns: ReadonlyArray<ProviderThreadTurnSnapshot>;
-}
-
-export interface ProviderAdapterShape<TError> {
-  /**
-   * Provider kind implemented by this adapter.
-   */
-  readonly provider: ProviderDriverKind;
-  readonly capabilities: ProviderAdapterCapabilities;
-
-  /**
-   * Start a provider-backed session.
-   */
-  readonly startSession: (
-    input: ProviderSessionStartInput,
-  ) => Effect.Effect<ProviderSession, TError>;
-
-  /**
-   * Send a turn to an active provider session.
-   */
-  readonly sendTurn: (
-    input: ProviderSendTurnInput,
-  ) => Effect.Effect<ProviderTurnStartResult, TError>;
-
-  /**
-   * Interrupt an active turn.
-   */
-  readonly interruptTurn: (threadId: ThreadId, turnId?: TurnId) => Effect.Effect<void, TError>;
-
-  /**
-   * Respond to an interactive approval request.
-   */
-  readonly respondToRequest: (
-    threadId: ThreadId,
-    requestId: ApprovalRequestId,
-    decision: ProviderApprovalDecision,
-  ) => Effect.Effect<void, TError>;
-
-  /**
-   * Respond to a structured user-input request.
-   */
-  readonly respondToUserInput: (
-    threadId: ThreadId,
-    requestId: ApprovalRequestId,
-    answers: ProviderUserInputAnswers,
-  ) => Effect.Effect<void, TError>;
-
-  /**
-   * Stop one provider session.
-   */
-  readonly stopSession: (threadId: ThreadId) => Effect.Effect<void, TError>;
-
-  /**
-   * List currently active provider sessions for this adapter.
-   */
-  readonly listSessions: () => Effect.Effect<ReadonlyArray<ProviderSession>>;
-
-  /**
-   * Check whether this adapter owns an active session id.
-   */
-  readonly hasSession: (threadId: ThreadId) => Effect.Effect<boolean>;
-
-  /**
-   * Read a provider thread snapshot.
-   */
-  readonly readThread: (threadId: ThreadId) => Effect.Effect<ProviderThreadSnapshot, TError>;
-
-  /**
-   * Roll back a provider thread by N turns.
-   */
-  readonly rollbackThread: (
-    threadId: ThreadId,
-    numTurns: number,
-  ) => Effect.Effect<ProviderThreadSnapshot, TError>;
-
-  /**
-   * Upload a thread to the provider when the adapter supports feedback.
-   */
-  readonly uploadFeedback?: (
-    input: ProviderUploadFeedbackInput,
-  ) => Effect.Effect<ProviderUploadFeedbackResult, TError>;
-
-  /**
-   * Stop all sessions owned by this adapter.
-   */
-  readonly stopAll: () => Effect.Effect<void, TError>;
-
-  /**
-   * Canonical runtime event stream emitted by this adapter.
-   */
-  readonly streamEvents: Stream.Stream<ProviderRuntimeEvent>;
-}
diff --git a/apps/server/src/provider/Services/ProviderAdapterRegistry.ts b/apps/server/src/provider/Services/ProviderAdapterRegistry.ts
deleted file mode 100644
index 5b755c42eedc..000000000000
--- a/apps/server/src/provider/Services/ProviderAdapterRegistry.ts
+++ /dev/null
@@ -1,100 +0,0 @@
-/**
- * ProviderAdapterRegistry - Lookup boundary for provider adapter implementations.
- *
- * Maps a `ProviderInstanceId` (the new per-instance routing key) or a
- * `ProviderDriverKind` (legacy single-instance-per-driver key) to the concrete
- * adapter service (Codex, Claude, etc). It does not own session lifecycle
- * or routing rules; `ProviderService` uses this registry together with
- * `ProviderSessionDirectory`.
- *
- * During the driver/instance migration this tag exposes both flavours:
- *
- *   - `getByInstance` / `listInstances` — new per-instance routing. Callers
- *     that already know an `instanceId` (threads, sessions, events)
- *     should prefer these.
- *     (`defaultInstanceIdForDriver(kind) === kind`), matching the pre-Slice-D
- *     behaviour. New code should not grow additional callers of the kind-keyed
- *     methods; they exist so the settings UI, WS refresh RPC, and a handful
- *     of legacy persisted rows can still be routed during the rollout.
- *
- * @module ProviderAdapterRegistry
- */
-import type { ProviderDriverKind, ProviderInstanceId } from "@t3tools/contracts";
-import * as Context from "effect/Context";
-import type * as Effect from "effect/Effect";
-import type * as PubSub from "effect/PubSub";
-import type * as Scope from "effect/Scope";
-import type * as Stream from "effect/Stream";
-
-import type { ProviderAdapterError, ProviderUnsupportedError } from "../Errors.ts";
-import type { ProviderAdapterShape } from "./ProviderAdapter.ts";
-import type { ProviderContinuationIdentity } from "../ProviderDriver.ts";
-
-export interface ProviderInstanceRoutingInfo {
-  readonly instanceId: ProviderInstanceId;
-  readonly driverKind: ProviderDriverKind;
-  readonly displayName: string | undefined;
-  readonly accentColor?: string | undefined;
-  readonly enabled: boolean;
-  readonly continuationIdentity: ProviderContinuationIdentity;
-}
-
-/**
- * ProviderAdapterRegistryShape - Service API for adapter lookup.
- */
-export interface ProviderAdapterRegistryShape {
-  /**
-   * Resolve the adapter for a specific instance id. Returns
-   * `ProviderUnsupportedError` if no such instance is currently registered
-   * (which covers "never configured" *and* "configured but the driver is
-   * unavailable in this build" — both surface the same failure to callers
-   * that expect a working adapter).
-   */
-  readonly getByInstance: (
-    instanceId: ProviderInstanceId,
-  ) => Effect.Effect<ProviderAdapterShape<ProviderAdapterError>, ProviderUnsupportedError>;
-
-  readonly getInstanceInfo: (
-    instanceId: ProviderInstanceId,
-  ) => Effect.Effect<ProviderInstanceRoutingInfo, ProviderUnsupportedError>;
-
-  /**
-   * List all live instance ids. Excludes unavailable/shadow instances —
-   * callers of this method want something they can pass to `getByInstance`.
-   */
-  readonly listInstances: () => Effect.Effect<ReadonlyArray<ProviderInstanceId>>;
-
-  /**
-   * Legacy: list provider kinds whose default instance is currently
-   * registered.
-   *
-   * @deprecated Prefer `listInstances`. Retained for migration-era call
-   * sites that iterate providers to build UI/metrics.
-   */
-  readonly listProviders: () => Effect.Effect<ReadonlyArray<ProviderDriverKind>>;
-
-  /**
-   * Change notification stream mirroring `ProviderInstanceRegistry.streamChanges`.
-   * Emits one `void` tick whenever the set of live instances changes
-   * (instance added, removed, or rebuilt after a settings edit). Consumers
-   * that fan out `adapter.streamEvents` per instance — e.g. `ProviderService`'s
-   * runtime event bus — re-pull `listInstances` on each tick and fork new
-   * subscriptions for instances they haven't seen yet.
-   */
-  readonly streamChanges: Stream.Stream<void>;
-
-  /**
-   * Acquire a change subscription synchronously in the caller's current fiber.
-   * Consumers that must avoid missing a publish between initial reconciliation
-   * and watcher startup should use this, then fork `Stream.fromSubscription`.
-   */
-  readonly subscribeChanges: Effect.Effect<PubSub.Subscription<void>, never, Scope.Scope>;
-}
-
-/**
- * ProviderAdapterRegistry - Service tag for provider adapter lookup.
- */
-export class ProviderAdapterRegistry extends Context.Service<
-  ProviderAdapterRegistry,
-  ProviderAdapterRegistryShape
->()("t3/provider/Services/ProviderAdapterRegistry") {}
diff --git a/apps/server/src/provider/Services/ProviderService.ts b/apps/server/src/provider/Services/ProviderService.ts
deleted file mode 100644
index 545641d2e866..000000000000
--- a/apps/server/src/provider/Services/ProviderService.ts
+++ /dev/null
@@ -1,130 +0,0 @@
-/**
- * ProviderService - Service interface for provider sessions, turns, and checkpoints.
- *
- * Acts as the cross-provider facade used by transports (WebSocket/RPC). It
- * resolves provider adapters through `ProviderAdapterRegistry`, routes
- * session-scoped calls via `ProviderSessionDirectory`, and exposes one unified
- * provider event stream to callers.
- *
- * Uses Effect `Context.Service` for dependency injection and returns typed
- * domain errors for validation, session, codex, and checkpoint workflows.
- *
- * @module ProviderService
- */
-import type {
-  ProviderInterruptTurnInput,
-  ProviderInstanceId,
-  ProviderRespondToRequestInput,
-  ProviderRespondToUserInputInput,
-  ProviderRuntimeEvent,
-  ProviderSendTurnInput,
-  ProviderSession,
-  ProviderSessionStartInput,
-  ProviderStopSessionInput,
-  ProviderUploadFeedbackInput,
-  ProviderUploadFeedbackResult,
-  ThreadId,
-  ProviderTurnStartResult,
-} from "@t3tools/contracts";
-import * as Context from "effect/Context";
-import type * as Effect from "effect/Effect";
-import type * as Stream from "effect/Stream";
-
-import type { ProviderServiceError } from "../Errors.ts";
-import type { ProviderAdapterCapabilities } from "./ProviderAdapter.ts";
-import type { ProviderInstanceRoutingInfo } from "./ProviderAdapterRegistry.ts";
-
-/**
- * ProviderServiceShape - Service API for provider session and turn orchestration.
- */
-export interface ProviderServiceShape {
-  /**
-   * Start a provider session.
-   */
-  readonly startSession: (
-    threadId: ThreadId,
-    input: ProviderSessionStartInput,
-  ) => Effect.Effect<ProviderSession, ProviderServiceError>;
-
-  /**
-   * Send a provider turn.
-   */
-  readonly sendTurn: (
-    input: ProviderSendTurnInput,
-  ) => Effect.Effect<ProviderTurnStartResult, ProviderServiceError>;
-
-  /**
-   * Interrupt a running provider turn.
-   */
-  readonly interruptTurn: (
-    input: ProviderInterruptTurnInput,
-  ) => Effect.Effect<void, ProviderServiceError>;
-
-  /**
-   * Respond to a provider approval request.
-   */
-  readonly respondToRequest: (
-    input: ProviderRespondToRequestInput,
-  ) => Effect.Effect<void, ProviderServiceError>;
-
-  /**
-   * Respond to a provider structured user-input request.
-   */
-  readonly respondToUserInput: (
-    input: ProviderRespondToUserInputInput,
-  ) => Effect.Effect<void, ProviderServiceError>;
-
-  /**
-   * Stop a provider session.
-   */
-  readonly stopSession: (
-    input: ProviderStopSessionInput,
-  ) => Effect.Effect<void, ProviderServiceError>;
-
-  /**
-   * List active provider sessions.
-   *
-   * Aggregates runtime session lists from all registered adapters.
-   */
-  readonly listSessions: () => Effect.Effect<ReadonlyArray<ProviderSession>>;
-
-  /**
-   * Read capabilities for the adapter bound to a configured provider instance.
-   */
-  readonly getCapabilities: (
-    instanceId: ProviderInstanceId,
-  ) => Effect.Effect<ProviderAdapterCapabilities, ProviderServiceError>;
-
-  readonly getInstanceInfo: (
-    instanceId: ProviderInstanceId,
-  ) => Effect.Effect<ProviderInstanceRoutingInfo, ProviderServiceError>;
-
-  /**
-   * Roll back provider conversation state by a number of turns.
-   */
-  readonly rollbackConversation: (input: {
-    readonly threadId: ThreadId;
-    readonly numTurns: number;
-  }) => Effect.Effect<void, ProviderServiceError>;
-
-  /**
-   * Upload a thread and return the provider's shareable feedback identifier.
-   */
-  readonly uploadFeedback: (
-    input: ProviderUploadFeedbackInput,
-  ) => Effect.Effect<ProviderUploadFeedbackResult, ProviderServiceError>;
-
-  /**
-   * Canonical provider runtime event stream.
-   *
-   * Fan-out is owned by ProviderService (not by a standalone event-bus service).
-   */
-  readonly streamEvents: Stream.Stream<ProviderRuntimeEvent>;
-}
-
-/**
- * ProviderService - Service tag for provider orchestration.
- */
-export class ProviderService extends Context.Service<ProviderService, ProviderServiceShape>()(
-  "t3/provider/Services/ProviderService",
-) {}
diff --git a/apps/server/src/provider/Services/ProviderSessionDirectory.ts b/apps/server/src/provider/Services/ProviderSessionDirectory.ts
deleted file mode 100644
index f2dd4323f7a3..000000000000
--- a/apps/server/src/provider/Services/ProviderSessionDirectory.ts
+++ /dev/null
@@ -1,70 +0,0 @@
-import type {
-  ProviderInstanceId,
-  ProviderDriverKind,
-  ProviderSessionRuntimeStatus,
-  RuntimeMode,
-  ThreadId,
-} from "@t3tools/contracts";
-import * as Option from "effect/Option";
-import * as Context from "effect/Context";
-import type * as Effect from "effect/Effect";
-
-import type {
-  ProviderSessionDirectoryPersistenceError,
-  ProviderValidationError,
-} from "../Errors.ts";
-
-export interface ProviderRuntimeBinding {
-  readonly threadId: ThreadId;
-  readonly provider: ProviderDriverKind;
-  /**
-   * Routing key for the configured provider instance that owns this
-   * session. The persistence layer promotes legacy null rows before
-   * exposing bindings; runtime callers must not infer this from `provider`.
-   */
-  readonly providerInstanceId?: ProviderInstanceId;
-  readonly adapterKey?: string;
-  readonly status?: ProviderSessionRuntimeStatus;
-  readonly resumeCursor?: unknown | null;
-  readonly runtimePayload?: unknown | null;
-  readonly runtimeMode?: RuntimeMode;
-}
-
-export interface ProviderRuntimeBindingWithMetadata extends ProviderRuntimeBinding {
-  readonly lastSeenAt: string;
-}
-
-export type ProviderSessionDirectoryReadError = ProviderSessionDirectoryPersistenceError;
-
-export type ProviderSessionDirectoryWriteError =
-  | ProviderValidationError
-  | ProviderSessionDirectoryPersistenceError;
-
-export interface ProviderSessionDirectoryShape {
-  readonly upsert: (
-    binding: ProviderRuntimeBinding,
-  ) => Effect.Effect<void, ProviderSessionDirectoryWriteError>;
-
-  readonly getProvider: (
-    threadId: ThreadId,
-  ) => Effect.Effect<ProviderDriverKind, ProviderSessionDirectoryReadError>;
-
-  readonly getBinding: (
-    threadId: ThreadId,
-  ) => Effect.Effect<Option.Option<ProviderRuntimeBinding>, ProviderSessionDirectoryReadError>;
-
-  readonly listThreadIds: () => Effect.Effect<
-    ReadonlyArray<ThreadId>,
-    ProviderSessionDirectoryPersistenceError
-  >;
-
-  readonly listBindings: () => Effect.Effect<
-    ReadonlyArray<ProviderRuntimeBindingWithMetadata>,
-    ProviderSessionDirectoryPersistenceError
-  >;
-}
-
-export class ProviderSessionDirectory extends Context.Service<
-  ProviderSessionDirectory,
-  ProviderSessionDirectoryShape
->()("t3/provider/Services/ProviderSessionDirectory") {}
diff --git a/apps/server/src/provider/Services/ProviderSessionReaper.ts b/apps/server/src/provider/Services/ProviderSessionReaper.ts
deleted file mode 100644
index 7c4627eca896..000000000000
--- a/apps/server/src/provider/Services/ProviderSessionReaper.ts
+++ /dev/null
@@ -1,15 +0,0 @@
-import * as Context from "effect/Context";
-import type * as Effect from "effect/Effect";
-import type * as Scope from "effect/Scope";
-
-export interface ProviderSessionReaperShape {
-  /**
-   * Start the background provider session reaper within the provided scope.
-   */
-  readonly start: () => Effect.Effect<void, never, Scope.Scope>;
-}
-
-export class ProviderSessionReaper extends Context.Service<
-  ProviderSessionReaper,
-  ProviderSessionReaperShape
->()("t3/provider/Services/ProviderSessionReaper") {}
diff --git a/apps/server/src/provider/T3OrchestrationInstructions.test.ts b/apps/server/src/provider/T3OrchestrationInstructions.test.ts
new file mode 100644
index 000000000000..98be0be78c2c
--- /dev/null
+++ b/apps/server/src/provider/T3OrchestrationInstructions.test.ts
@@ -0,0 +1,47 @@
+import { assert, describe, it } from "@effect/vitest";
+
+import {
+  T3_CODE_ORCHESTRATION_INSTRUCTIONS,
+  t3OrchestrationPromptForFirstRun,
+  t3OrchestrationSystemPrompt,
+} from "./T3OrchestrationInstructions.ts";
+
+describe("T3 orchestration provider instructions", () => {
+  it("distinguishes delegated subagents from ordinary top-level threads", () => {
+    assert.include(T3_CODE_ORCHESTRATION_INSTRUCTIONS, "use `delegate_task`");
+    assert.include(T3_CODE_ORCHESTRATION_INSTRUCTIONS, "ordinary top-level T3 conversations");
+    assert.include(T3_CODE_ORCHESTRATION_INSTRUCTIONS, "Never use them merely");
+    assert.include(T3_CODE_ORCHESTRATION_INSTRUCTIONS, "different provider");
+  });
+
+  it("documents structured schedules instead of JSON strings", () => {
+    assert.include(T3_CODE_ORCHESTRATION_INSTRUCTIONS, "structured object, never as JSON text");
+    assert.include(T3_CODE_ORCHESTRATION_INSTRUCTIONS, '"everyMs":3600000');
+    assert.include(T3_CODE_ORCHESTRATION_INSTRUCTIONS, "bindToCurrentThread=false");
+  });
+
+  it("injects prompt fallback only for an MCP-enabled first run", () => {
+    const prompt = "Inspect the repository.";
+    const injected = t3OrchestrationPromptForFirstRun({
+      prompt,
+      runOrdinal: 1,
+      hasT3Mcp: true,
+    });
+
+    assert.include(injected, "<t3_code_orchestration_instructions>");
+    assert.include(injected, `<user_request>\n${prompt}\n</user_request>`);
+    assert.equal(
+      t3OrchestrationPromptForFirstRun({ prompt, runOrdinal: 2, hasT3Mcp: true }),
+      prompt,
+    );
+    assert.equal(
+      t3OrchestrationPromptForFirstRun({ prompt, runOrdinal: 1, hasT3Mcp: false }),
+      prompt,
+    );
+  });
+
+  it("only exposes the system prompt when the T3 MCP server is attached", () => {
+    assert.equal(t3OrchestrationSystemPrompt(false), undefined);
+    assert.equal(t3OrchestrationSystemPrompt(true), T3_CODE_ORCHESTRATION_INSTRUCTIONS);
+  });
+});
diff --git a/apps/server/src/provider/T3OrchestrationInstructions.ts b/apps/server/src/provider/T3OrchestrationInstructions.ts
new file mode 100644
index 000000000000..83816ddf626f
--- /dev/null
+++ b/apps/server/src/provider/T3OrchestrationInstructions.ts
@@ -0,0 +1,35 @@
+export const T3_CODE_ORCHESTRATION_INSTRUCTIONS = `
+
+## T3 Code orchestration
+
+The \`t3-code\` MCP server provides app-owned orchestration. Treat these concepts distinctly:
+
+- A delegated task/subagent is child work owned by the current thread. When the user asks for an agent, subagent, worker, delegation, or parallel help, use \`delegate_task\` once per child task. This remains true when targeting a different provider. Use \`orchestrator_capabilities\` to discover provider/model IDs, retain each returned \`taskId\`, and use \`task_status\` or \`task_cancel\` to manage it. The returned \`childThreadId\` is backing storage for the subagent; do not replace delegation with ordinary thread creation.
+- \`create_threads\` and \`t3_thread_start\` create ordinary top-level T3 conversations. Use them only when the user explicitly asks for separate/new/top-level threads or conversations. Never use them merely because the user said "subagent" or requested parallel delegated work.
+- \`schedule_task\` creates persistent recurring work in the app scheduler. Pass \`schedule\` as a structured object, never as JSON text: \`{"type":"interval","everyMs":3600000}\` for an interval, or \`{"type":"fixed_time","timeOfDay":"09:00","weekdays":[1,2,3,4,5]}\` for a wall-clock schedule. By default runs return to the current thread; set \`bindToCurrentThread=false\` only when the user wants a fresh thread for every run. After scheduling, report the returned cadence and next run time.
+
+Tool names may include an MCP prefix (for example \`mcp__t3-code__delegate_task\`); the semantics are the same. Keep polling/wait loops bounded, do not duplicate active work, and use stable \`clientRequestId\` values when retrying mutations.
+`;
+
+/**
+ * Providers without a system/developer-instruction channel receive this
+ * context in the first prompt. Keep the wrapper explicit so it cannot be
+ * mistaken for text authored by the user.
+ */
+export function prependT3OrchestrationInstructions(prompt: string): string {
+  return `<t3_code_orchestration_instructions>${T3_CODE_ORCHESTRATION_INSTRUCTIONS.trim()}</t3_code_orchestration_instructions>\n\n<user_request>\n${prompt}\n</user_request>`;
+}
+
+export function t3OrchestrationPromptForFirstRun(input: {
+  readonly prompt: string;
+  readonly runOrdinal: number;
+  readonly hasT3Mcp: boolean;
+}): string {
+  return input.runOrdinal === 1 && input.hasT3Mcp
+    ? prependT3OrchestrationInstructions(input.prompt)
+    : input.prompt;
+}
+
+export function t3OrchestrationSystemPrompt(hasT3Mcp: boolean): string | undefined {
+  return hasT3Mcp ? T3_CODE_ORCHESTRATION_INSTRUCTIONS : undefined;
+}
diff --git a/apps/server/src/provider/acp/AcpAdapterSupport.test.ts b/apps/server/src/provider/acp/AcpAdapterSupport.test.ts
deleted file mode 100644
index 0aebe0ca6d82..000000000000
--- a/apps/server/src/provider/acp/AcpAdapterSupport.test.ts
+++ /dev/null
@@ -1,28 +0,0 @@
-import { describe, expect, it } from "vite-plus/test";
-import * as EffectAcpErrors from "effect-acp/errors";
-import { ProviderDriverKind } from "@t3tools/contracts";
-
-import { acpPermissionOutcome, mapAcpToAdapterError } from "./AcpAdapterSupport.ts";
-
-describe("AcpAdapterSupport", () => {
-  it("maps ACP approval decisions to permission outcomes", () => {
-    expect(acpPermissionOutcome("accept")).toBe("allow-once");
-    expect(acpPermissionOutcome("acceptForSession")).toBe("allow-always");
-    expect(acpPermissionOutcome("decline")).toBe("reject-once");
-  });
-
-  it("maps ACP request errors to provider adapter request errors", () => {
-    const error = mapAcpToAdapterError(
-      ProviderDriverKind.make("cursor"),
-      "thread-1" as never,
-      "session/prompt",
-      new EffectAcpErrors.AcpRequestError({
-        code: -32602,
-        errorMessage: "Invalid params",
-      }),
-    );
-
-    expect(error._tag).toBe("ProviderAdapterRequestError");
-    expect(error.message).toContain("Invalid params");
-  });
-});
diff --git a/apps/server/src/provider/acp/AcpAdapterSupport.ts b/apps/server/src/provider/acp/AcpAdapterSupport.ts
deleted file mode 100644
index cde110e6dd99..000000000000
--- a/apps/server/src/provider/acp/AcpAdapterSupport.ts
+++ /dev/null
@@ -1,56 +0,0 @@
-import {
-  type ProviderApprovalDecision,
-  type ProviderDriverKind,
-  type ThreadId,
-} from "@t3tools/contracts";
-import * as Schema from "effect/Schema";
-import * as EffectAcpErrors from "effect-acp/errors";
-
-import {
-  ProviderAdapterRequestError,
-  ProviderAdapterSessionClosedError,
-  type ProviderAdapterError,
-} from "../Errors.ts";
-const isAcpProcessExitedError = Schema.is(EffectAcpErrors.AcpProcessExitedError);
-const isAcpRequestError = Schema.is(EffectAcpErrors.AcpRequestError);
-
-export function mapAcpToAdapterError(
-  provider: ProviderDriverKind,
-  threadId: ThreadId,
-  method: string,
-  error: EffectAcpErrors.AcpError,
-): ProviderAdapterError {
-  if (isAcpProcessExitedError(error)) {
-    return new ProviderAdapterSessionClosedError({
-      provider,
-      threadId,
-      cause: error,
-    });
-  }
-  if (isAcpRequestError(error)) {
-    return new ProviderAdapterRequestError({
-      provider,
-      method,
-      detail: error.message,
-      cause: error,
-    });
-  }
-  return new ProviderAdapterRequestError({
-    provider,
-    method,
-    detail: error.message,
-    cause: error,
-  });
-}
-
-export function acpPermissionOutcome(decision: ProviderApprovalDecision): string {
-  switch (decision) {
-    case "acceptForSession":
-      return "allow-always";
-    case "accept":
-      return "allow-once";
-    case "decline":
-    default:
-      return "reject-once";
-  }
-}
diff --git a/apps/server/src/provider/acp/AcpJsonRpcConnection.test.ts b/apps/server/src/provider/acp/AcpJsonRpcConnection.test.ts
index 93ffc63806f6..f0f907ee2b4b 100644
--- a/apps/server/src/provider/acp/AcpJsonRpcConnection.test.ts
+++ b/apps/server/src/provider/acp/AcpJsonRpcConnection.test.ts
@@ -6,6 +6,7 @@ import * as NodeFS from "node:fs";
 
 import * as NodeServices from "@effect/platform-node/NodeServices";
 import { it } from "@effect/vitest";
+import * as Deferred from "effect/Deferred";
 import * as Effect from "effect/Effect";
 import * as Fiber from "effect/Fiber";
 import * as Option from "effect/Option";
@@ -22,6 +23,17 @@ const mockAgentCommand = "node";
 const mockAgentArgs = [mockAgentPath];
 
 describe("AcpSessionRuntime", () => {
+  it("selects explicit or agent-managed authentication without choosing terminal auth", () => {
+    const methods = [
+      { id: "browser", name: "Browser", type: "terminal" as const },
+      { id: "api-key", name: "API key" },
+    ];
+
+    expect(AcpSessionRuntime.selectAcpAgentAuthMethod(methods)?.id).toBe("api-key");
+    expect(AcpSessionRuntime.selectAcpAgentAuthMethod(methods, "browser")?.id).toBe("browser");
+    expect(AcpSessionRuntime.selectAcpAgentAuthMethod(methods, "missing")).toBeUndefined();
+  });
+
   it.effect("merges custom initialize client capabilities into the ACP handshake", () => {
     const requestEvents: Array<AcpSessionRuntime.AcpSessionRequestLogEvent> = [];
     return Effect.gen(function* () {
@@ -65,6 +77,82 @@ describe("AcpSessionRuntime", () => {
     );
   });
 
+  it.effect("does not authenticate when an advertised method is not required", () => {
+    const requestEvents: Array<AcpSessionRuntime.AcpSessionRequestLogEvent> = [];
+    return Effect.gen(function* () {
+      const runtime = yield* AcpSessionRuntime.AcpSessionRuntime;
+      yield* runtime.start();
+
+      expect(
+        requestEvents.filter((event) => event.status === "started").map((event) => event.method),
+      ).toEqual(["initialize", "session/new"]);
+    }).pipe(
+      Effect.provide(
+        AcpSessionRuntime.layer({
+          authMethodId: "test",
+          spawn: {
+            command: mockAgentCommand,
+            args: mockAgentArgs,
+            env: { T3_ACP_AUTH_METHOD_ID: "test" },
+          },
+          cwd: process.cwd(),
+          clientInfo: { name: "t3-test", version: "0.0.0" },
+          requestLogger: (event) =>
+            Effect.sync(() => {
+              requestEvents.push(event);
+            }),
+        }),
+      ),
+      Effect.scoped,
+      Effect.provide(NodeServices.layer),
+    );
+  });
+
+  it.effect("authenticates and retries once after session creation returns auth_required", () => {
+    const requestEvents: Array<AcpSessionRuntime.AcpSessionRequestLogEvent> = [];
+    return Effect.gen(function* () {
+      const runtime = yield* AcpSessionRuntime.AcpSessionRuntime;
+      const started = yield* runtime.start();
+
+      expect(started.sessionId).toBe("mock-session-1");
+      expect(
+        requestEvents.filter((event) => event.status === "started").map((event) => event.method),
+      ).toEqual(["initialize", "session/new", "authenticate", "session/new"]);
+      expect(
+        requestEvents.filter(
+          (event) => event.method === "session/new" && event.status === "failed",
+        ),
+      ).toHaveLength(1);
+      expect(
+        requestEvents.filter(
+          (event) => event.method === "session/new" && event.status === "succeeded",
+        ),
+      ).toHaveLength(1);
+    }).pipe(
+      Effect.provide(
+        AcpSessionRuntime.layer({
+          authMethodId: "test",
+          spawn: {
+            command: mockAgentCommand,
+            args: mockAgentArgs,
+            env: {
+              T3_ACP_AUTH_METHOD_ID: "test",
+              T3_ACP_REQUIRE_AUTH: "1",
+            },
+          },
+          cwd: process.cwd(),
+          clientInfo: { name: "t3-test", version: "0.0.0" },
+          requestLogger: (event) =>
+            Effect.sync(() => {
+              requestEvents.push(event);
+            }),
+        }),
+      ),
+      Effect.scoped,
+      Effect.provide(NodeServices.layer),
+    );
+  });
+
   it.effect("starts a session, prompts, and emits normalized events against the mock agent", () =>
     Effect.gen(function* () {
       const runtime = yield* AcpSessionRuntime.AcpSessionRuntime;
@@ -228,8 +316,9 @@ describe("AcpSessionRuntime", () => {
     ),
   );
 
-  it.effect("releases a fully silent prompt when session/cancel is requested", () =>
-    Effect.gen(function* () {
+  it.effect("releases a fully silent prompt and forwards configured cancel metadata", () => {
+    const protocolEvents: Array<EffectAcpProtocol.AcpProtocolLogEvent> = [];
+    return Effect.gen(function* () {
       const runtime = yield* AcpSessionRuntime.AcpSessionRuntime;
       yield* runtime.start();
 
@@ -241,6 +330,19 @@ describe("AcpSessionRuntime", () => {
 
       yield* TestClock.adjust("500 millis");
       yield* runtime.cancel;
+      yield* Effect.yieldNow;
+      yield* Effect.yieldNow;
+
+      expect(
+        protocolEvents.some(
+          (event) =>
+            event.direction === "outgoing" &&
+            event.stage === "raw" &&
+            typeof event.payload === "string" &&
+            event.payload.includes('"method":"session/cancel"') &&
+            event.payload.includes('"cancelTrigger":"ctrl_c"'),
+        ),
+      ).toBe(true);
 
       const firstPromptResult = yield* Fiber.join(promptFiber);
       expect(firstPromptResult).toMatchObject({ stopReason: "cancelled" });
@@ -262,12 +364,20 @@ describe("AcpSessionRuntime", () => {
           cwd: process.cwd(),
           clientInfo: { name: "t3-test", version: "0.0.0" },
           authMethodId: "test",
+          cancelMeta: { cancelTrigger: "ctrl_c" },
+          protocolLogging: {
+            logOutgoing: true,
+            logger: (event) =>
+              Effect.sync(() => {
+                protocolEvents.push(event);
+              }),
+          },
         }),
       ),
       Effect.scoped,
       Effect.provide(NodeServices.layer),
-    ),
-  );
+    );
+  });
 
   it.effect("segments assistant text around ACP tool calls", () =>
     Effect.gen(function* () {
@@ -429,6 +539,112 @@ describe("AcpSessionRuntime", () => {
     );
   });
 
+  it.effect("supports negotiated ACP session list, fork, resume, and close methods", () => {
+    const requestEvents: Array<AcpSessionRuntime.AcpSessionRequestLogEvent> = [];
+    return Effect.gen(function* () {
+      const runtime = yield* AcpSessionRuntime.AcpSessionRuntime;
+      const started = yield* runtime.start();
+      expect(started.initializeResult.agentCapabilities?.sessionCapabilities).toMatchObject({
+        list: {},
+        fork: {},
+        resume: {},
+        close: {},
+      });
+
+      const listed = yield* runtime.listSessions();
+      expect(listed.sessions.map((session) => session.sessionId)).toEqual(["mock-session-1"]);
+
+      const forked = yield* runtime.forkSession(started.sessionId);
+      expect(forked.sessionId).toBe("mock-session-1-fork");
+      yield* runtime.prompt({ prompt: [{ type: "text", text: "on fork" }] });
+
+      const resumed = yield* runtime.resumeSession(started.sessionId);
+      expect(resumed.sessionId).toBe("mock-session-1");
+      yield* runtime.closeSession();
+
+      expect(
+        requestEvents.find(
+          (event) => event.method === "session/prompt" && event.status === "started",
+        )?.payload,
+      ).toMatchObject({ sessionId: "mock-session-1-fork" });
+      expect(
+        requestEvents.filter((event) => event.status === "started").map((event) => event.method),
+      ).toEqual(
+        expect.arrayContaining(["session/list", "session/fork", "session/resume", "session/close"]),
+      );
+    }).pipe(
+      Effect.provide(
+        AcpSessionRuntime.layer({
+          authMethodId: "test",
+          spawn: {
+            command: mockAgentCommand,
+            args: mockAgentArgs,
+            env: {
+              T3_ACP_SESSION_LIFECYCLE: "1",
+            },
+          },
+          cwd: process.cwd(),
+          clientInfo: { name: "t3-test", version: "0.0.0" },
+          requestLogger: (event) =>
+            Effect.sync(() => {
+              requestEvents.push(event);
+            }),
+        }),
+      ),
+      Effect.scoped,
+      Effect.provide(NodeServices.layer),
+    );
+  });
+
+  it.effect("rejects unauthenticated ACP session lifecycle requests", () =>
+    Effect.gen(function* () {
+      const runtime = yield* AcpSessionRuntime.AcpSessionRuntime;
+      yield* runtime.start();
+
+      const listError = yield* runtime.listSessions().pipe(Effect.flip);
+      expect(listError._tag).toBe("AcpRequestError");
+      if (listError._tag === "AcpRequestError") {
+        expect(listError.code).toBe(-32000);
+      }
+
+      const forkError = yield* runtime.forkSession("mock-session-1").pipe(Effect.flip);
+      expect(forkError._tag).toBe("AcpRequestError");
+      if (forkError._tag === "AcpRequestError") {
+        expect(forkError.code).toBe(-32000);
+      }
+
+      const resumeError = yield* runtime.resumeSession("mock-session-1").pipe(Effect.flip);
+      expect(resumeError._tag).toBe("AcpRequestError");
+      if (resumeError._tag === "AcpRequestError") {
+        expect(resumeError.code).toBe(-32000);
+      }
+
+      const closeError = yield* runtime.closeSession().pipe(Effect.flip);
+      expect(closeError._tag).toBe("AcpRequestError");
+      if (closeError._tag === "AcpRequestError") {
+        expect(closeError.code).toBe(-32000);
+      }
+    }).pipe(
+      Effect.provide(
+        AcpSessionRuntime.layer({
+          spawn: {
+            command: mockAgentCommand,
+            args: mockAgentArgs,
+            env: {
+              T3_ACP_REQUIRE_AUTH: "1",
+              T3_ACP_SESSION_LIFECYCLE: "1",
+            },
+          },
+          cwd: process.cwd(),
+          resumeSessionId: "mock-session-1",
+          clientInfo: { name: "t3-test", version: "0.0.0" },
+        }),
+      ),
+      Effect.scoped,
+      Effect.provide(NodeServices.layer),
+    ),
+  );
+
   it.effect("skips no-op session config writes when the requested value is already active", () => {
     const requestEvents: Array<AcpSessionRuntime.AcpSessionRequestLogEvent> = [];
     return Effect.gen(function* () {
@@ -575,6 +791,56 @@ describe("AcpSessionRuntime", () => {
     ),
   );
 
+  it.effect("keeps active-session updates while loading a different session", () =>
+    Effect.gen(function* () {
+      const loadStarted = yield* Deferred.make<void>();
+      const runtime = yield* AcpSessionRuntime.make({
+        authMethodId: "test",
+        spawn: {
+          command: mockAgentCommand,
+          args: mockAgentArgs,
+          env: {
+            T3_ACP_DELAY_LOAD_SESSION_AFTER_REPLAY: "1",
+            T3_ACP_LOAD_SESSION_DELAY_MS: "250",
+          },
+        },
+        cwd: process.cwd(),
+        sessionLoadTimeout: "2 seconds",
+        clientInfo: { name: "t3-test", version: "0.0.0" },
+        requestLogger: (event) =>
+          event.method === "session/load" && event.status === "started"
+            ? Deferred.succeed(loadStarted, undefined).pipe(Effect.asVoid)
+            : Effect.void,
+      });
+      yield* runtime.start();
+
+      const eventsFiber = yield* Stream.runCollect(Stream.take(runtime.getEvents(), 4)).pipe(
+        Effect.forkChild({ startImmediately: true }),
+      );
+      const loadFiber = yield* runtime
+        .loadSession("mock-session-2")
+        .pipe(Effect.forkChild({ startImmediately: true }));
+      yield* Deferred.await(loadStarted);
+
+      yield* runtime.prompt({
+        prompt: [{ type: "text", text: "active session prompt" }],
+      });
+      const events = Array.from(yield* Fiber.join(eventsFiber).pipe(Effect.timeout("2 seconds")));
+      expect(events.map((event) => event._tag)).toEqual([
+        "PlanUpdated",
+        "AssistantItemStarted",
+        "ContentDelta",
+        "AssistantItemCompleted",
+      ]);
+      expect(
+        events.some((event) => event._tag === "ContentDelta" && event.text === "hello from mock"),
+      ).toBe(true);
+
+      const loaded = yield* Fiber.join(loadFiber).pipe(Effect.timeout("2 seconds"));
+      expect(loaded.sessionId).toBe("mock-session-2");
+    }).pipe(Effect.scoped, Effect.provide(NodeServices.layer), TestClock.withLive),
+  );
+
   it.effect("completes session/load after replay becomes idle while its RPC stays pending", () =>
     Effect.gen(function* () {
       const runtime = yield* AcpSessionRuntime.AcpSessionRuntime;
@@ -614,6 +880,40 @@ describe("AcpSessionRuntime", () => {
     ),
   );
 
+  it.effect("completes ad-hoc loadSession after replay becomes idle while RPC stays pending", () =>
+    Effect.gen(function* () {
+      const runtime = yield* AcpSessionRuntime.AcpSessionRuntime;
+      yield* runtime.start();
+      const loaded = yield* runtime.loadSession("mock-session-1").pipe(Effect.timeout("2 seconds"));
+
+      expect(loaded.sessionId).toBe("mock-session-1");
+      expect(loaded.sessionSetupResult._meta).toMatchObject({
+        t3SessionLoadReady: "replay_idle",
+      });
+    }).pipe(
+      Effect.provide(
+        AcpSessionRuntime.layer({
+          authMethodId: "test",
+          spawn: {
+            command: mockAgentCommand,
+            args: mockAgentArgs,
+            env: {
+              T3_ACP_HANG_LOAD_SESSION_AFTER_REPLAY: "1",
+              T3_ACP_LOAD_SESSION_DELAY_MS: "10000",
+            },
+          },
+          cwd: process.cwd(),
+          sessionLoadReplayIdleGap: "50 millis",
+          sessionLoadTimeout: "1 second",
+          clientInfo: { name: "t3-test", version: "0.0.0" },
+        }),
+      ),
+      Effect.scoped,
+      Effect.provide(NodeServices.layer),
+      TestClock.withLive,
+    ),
+  );
+
   it.effect("rejects invalid config option values before sending session/set_config_option", () => {
     const tempDir = NodeFS.mkdtempSync(NodePath.join(NodeOS.tmpdir(), "acp-runtime-"));
     const requestLogPath = NodePath.join(tempDir, "requests.ndjson");
diff --git a/apps/server/src/provider/acp/AcpNativeLogging.ts b/apps/server/src/provider/acp/AcpNativeLogging.ts
index 06bff3aa6113..79e925766ccf 100644
--- a/apps/server/src/provider/acp/AcpNativeLogging.ts
+++ b/apps/server/src/provider/acp/AcpNativeLogging.ts
@@ -1,5 +1,5 @@
 import type { ProviderDriverKind, ThreadId } from "@t3tools/contracts";
-import { causeErrorTag, errorTag } from "@t3tools/shared/observability";
+import { causeErrorTag } from "@t3tools/shared/observability";
 import * as Cause from "effect/Cause";
 import * as Crypto from "effect/Crypto";
 import * as DateTime from "effect/DateTime";
@@ -7,46 +7,18 @@ import * as Effect from "effect/Effect";
 import type * as EffectAcpProtocol from "effect-acp/protocol";
 
 import type { EventNdjsonLogger } from "../Layers/EventNdjsonLogger.ts";
+import {
+  structuralProtocolMethod,
+  summarizeNativeProtocolPayload,
+} from "../NativeProtocolLogging.ts";
 import type * as AcpSessionRuntime from "./AcpSessionRuntime.ts";
 
-function structuralMethod(value: string): string {
-  return value.length <= 128 && /^[A-Za-z][A-Za-z0-9._:/-]*$/.test(value) ? value : "unknown";
-}
-
-function summarizePayload(payload: unknown): Readonly<Record<string, unknown>> {
-  if (payload === null) return { valueType: "null" };
-  if (typeof payload === "string") {
-    return { valueType: "string", byteLength: new TextEncoder().encode(payload).byteLength };
-  }
-  if (payload instanceof Uint8Array) {
-    return { valueType: "bytes", byteLength: payload.byteLength };
-  }
-  if (Array.isArray(payload)) {
-    return { valueType: "array", itemCount: payload.length };
-  }
-  if (typeof payload !== "object") {
-    return { valueType: typeof payload };
-  }
-
-  try {
-    const record = payload as Record<string, unknown>;
-    return {
-      valueType: "object",
-      fieldCount: Object.keys(record).length,
-      ...(typeof record._tag === "string" ? { messageTag: errorTag(record) } : {}),
-      ...(typeof record.tag === "string" ? { method: structuralMethod(record.tag) } : {}),
-    };
-  } catch {
-    return { valueType: "object" };
-  }
-}
-
 function formatRequestLogPayload(event: AcpSessionRuntime.AcpSessionRequestLogEvent) {
   return {
-    method: structuralMethod(event.method),
+    method: structuralProtocolMethod(event.method),
     status: event.status,
-    request: summarizePayload(event.payload),
-    ...(event.result !== undefined ? { result: summarizePayload(event.result) } : {}),
+    request: summarizeNativeProtocolPayload(event.payload),
+    ...(event.result !== undefined ? { result: summarizeNativeProtocolPayload(event.result) } : {}),
     ...(event.cause !== undefined
       ? {
           errorTag: causeErrorTag(event.cause),
@@ -56,11 +28,11 @@ function formatRequestLogPayload(event: AcpSessionRuntime.AcpSessionRequestLogEv
   };
 }
 
-function formatProtocolLogPayload(event: EffectAcpProtocol.AcpProtocolLogEvent) {
+export function formatAcpProtocolLogPayload(event: EffectAcpProtocol.AcpProtocolLogEvent) {
   return {
     direction: event.direction,
     stage: event.stage,
-    payload: summarizePayload(event.payload),
+    payload: summarizeNativeProtocolPayload(event.payload),
   };
 }
 
@@ -119,7 +91,7 @@ export const makeAcpNativeLoggerFactory = Effect.fn("makeAcpNativeLoggerFactory"
               logger: (event: EffectAcpProtocol.AcpProtocolLogEvent) =>
                 writeNativeAcpLog({
                   kind: "protocol",
-                  payload: formatProtocolLogPayload(event),
+                  payload: formatAcpProtocolLogPayload(event),
                 }),
             } satisfies NonNullable<AcpSessionRuntime.AcpSessionRuntimeOptions["protocolLogging"]>,
           }
diff --git a/apps/server/src/provider/acp/AcpRegistrySupport.test.ts b/apps/server/src/provider/acp/AcpRegistrySupport.test.ts
new file mode 100644
index 000000000000..b4363dda715f
--- /dev/null
+++ b/apps/server/src/provider/acp/AcpRegistrySupport.test.ts
@@ -0,0 +1,263 @@
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import { describe, expect, it } from "@effect/vitest";
+import { AcpRegistrySettings } from "@t3tools/contracts";
+import { HostProcessArchitecture, HostProcessPlatform } from "@t3tools/shared/hostProcess";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Layer from "effect/Layer";
+import * as Schema from "effect/Schema";
+import { HttpClient, HttpClientResponse } from "effect/unstable/http";
+
+import {
+  makeAcpRegistryResolver,
+  resolveAcpRegistryDistribution,
+  resolveAcpRegistryPlatformTarget,
+  type AcpRegistryAgent,
+} from "./AcpRegistrySupport.ts";
+
+const registryUrl = "https://registry.test/registry.json";
+const archiveUrl = "https://registry.test/example-agent.bin";
+const decodeAcpRegistrySettings = Schema.decodeSync(AcpRegistrySettings);
+
+function makeAgent(distribution: AcpRegistryAgent["distribution"]): AcpRegistryAgent {
+  return {
+    id: "example-agent",
+    name: "Example Agent",
+    version: "1.2.3",
+    description: "ACP Registry test agent",
+    distribution,
+  };
+}
+
+function makeRegistry(agent: AcpRegistryAgent): string {
+  return JSON.stringify({ version: "1.0.0", agents: [agent] });
+}
+
+function settings(input: Partial<AcpRegistrySettings> = {}): AcpRegistrySettings {
+  return decodeAcpRegistrySettings({
+    agentId: "example-agent",
+    ...input,
+  });
+}
+
+function resolverLayer(execute: Parameters<typeof HttpClient.make>[0]) {
+  return Layer.mergeAll(
+    NodeServices.layer,
+    Layer.succeed(HostProcessPlatform, "linux"),
+    Layer.succeed(HostProcessArchitecture, "x64"),
+    Layer.succeed(HttpClient.HttpClient, HttpClient.make(execute)),
+  );
+}
+
+describe("AcpRegistrySupport", () => {
+  it("maps supported Node platforms to ACP Registry target keys", () => {
+    expect(resolveAcpRegistryPlatformTarget("darwin", "arm64")).toBe("darwin-aarch64");
+    expect(resolveAcpRegistryPlatformTarget("linux", "x64")).toBe("linux-x86_64");
+    expect(resolveAcpRegistryPlatformTarget("win32", "arm64")).toBe("windows-aarch64");
+    expect(resolveAcpRegistryPlatformTarget("freebsd", "x64")).toBeUndefined();
+    expect(resolveAcpRegistryPlatformTarget("linux", "ia32")).toBeUndefined();
+  });
+
+  it("selects the preferred compatible distribution", () => {
+    const agent = makeAgent({
+      binary: {
+        "linux-x86_64": {
+          archive: archiveUrl,
+          cmd: "./bin/example-agent",
+          args: ["acp"],
+        },
+      },
+      npx: {
+        package: "@example/acp@1.2.3",
+        args: ["--stdio"],
+      },
+    });
+
+    expect(
+      resolveAcpRegistryDistribution({
+        agent,
+        preference: "auto",
+        platformTarget: "linux-x86_64",
+      }),
+    ).toMatchObject({ kind: "binary", args: ["acp"] });
+    expect(
+      resolveAcpRegistryDistribution({
+        agent,
+        preference: "npx",
+        platformTarget: "linux-x86_64",
+      }),
+    ).toEqual({
+      kind: "npx",
+      packageName: "@example/acp@1.2.3",
+      args: ["--stdio"],
+      env: {},
+    });
+    expect(
+      resolveAcpRegistryDistribution({
+        agent,
+        preference: "binary",
+        platformTarget: "darwin-aarch64",
+      }),
+    ).toBeUndefined();
+  });
+
+  it.effect("resolves command overrides while preserving registry args and environment", () => {
+    const agent = makeAgent({
+      binary: {
+        "linux-x86_64": {
+          archive: archiveUrl,
+          cmd: "./bin/example-agent",
+          args: ["acp", "--stdio"],
+          env: { REGISTRY_VALUE: "registry", OVERRIDE_ME: "registry" },
+        },
+      },
+    });
+    const requests: Array<string> = [];
+    return Effect.gen(function* () {
+      const fileSystem = yield* FileSystem.FileSystem;
+      const cacheDir = yield* fileSystem.makeTempDirectoryScoped({
+        prefix: "t3-acp-registry-override-",
+      });
+      const resolver = yield* makeAcpRegistryResolver({ cacheDir, registryUrl });
+      const resolved = yield* resolver.resolve(
+        settings({ commandPath: "/opt/example-agent" }),
+        "/workspace",
+        { HOST_VALUE: "host", OVERRIDE_ME: "host" },
+      );
+
+      expect(resolved.distribution).toBe("binary");
+      expect(resolved.spawn).toEqual({
+        command: "/opt/example-agent",
+        args: ["acp", "--stdio"],
+        cwd: "/workspace",
+        env: {
+          HOST_VALUE: "host",
+          OVERRIDE_ME: "registry",
+          REGISTRY_VALUE: "registry",
+        },
+      });
+      expect(requests).toEqual([registryUrl]);
+    }).pipe(
+      Effect.scoped,
+      Effect.provide(
+        resolverLayer((request) => {
+          requests.push(request.url);
+          return Effect.succeed(
+            HttpClientResponse.fromWeb(request, new Response(makeRegistry(agent))),
+          );
+        }),
+      ),
+    );
+  });
+
+  it.effect("installs and reuses a registry binary in the managed cache", () => {
+    const agent = makeAgent({
+      binary: {
+        "linux-x86_64": {
+          archive: archiveUrl,
+          cmd: "./bin/example-agent",
+          args: ["acp"],
+        },
+      },
+    });
+    const binaryBytes = new TextEncoder().encode("#!/bin/sh\necho example\n");
+    const requests: Array<string> = [];
+    return Effect.gen(function* () {
+      const fileSystem = yield* FileSystem.FileSystem;
+      const cacheDir = yield* fileSystem.makeTempDirectoryScoped({
+        prefix: "t3-acp-registry-install-",
+      });
+      const resolver = yield* makeAcpRegistryResolver({ cacheDir, registryUrl });
+      const first = yield* resolver.resolve(settings(), "/workspace");
+      const second = yield* resolver.resolve(settings(), "/workspace");
+
+      expect(first.spawn.command).toBe(second.spawn.command);
+      expect(first.spawn.command).toContain(
+        "/acp-registry/agents/example-agent/1.2.3/linux-x86_64/bin/example-agent",
+      );
+      expect(yield* fileSystem.readFileString(first.spawn.command)).toBe(
+        "#!/bin/sh\necho example\n",
+      );
+      expect(requests).toEqual([registryUrl, archiveUrl]);
+    }).pipe(
+      Effect.scoped,
+      Effect.provide(
+        resolverLayer((request) => {
+          requests.push(request.url);
+          const response =
+            request.url === registryUrl
+              ? new Response(makeRegistry(agent))
+              : new Response(binaryBytes.buffer as ArrayBuffer);
+          return Effect.succeed(HttpClientResponse.fromWeb(request, response));
+        }),
+      ),
+    );
+  });
+
+  it.effect("falls back to a valid cached registry index when refresh fails", () => {
+    const agent = makeAgent({
+      npx: {
+        package: "@example/acp@1.2.3",
+        args: ["--stdio"],
+      },
+    });
+    return Effect.gen(function* () {
+      const fileSystem = yield* FileSystem.FileSystem;
+      const cacheDir = yield* fileSystem.makeTempDirectoryScoped({
+        prefix: "t3-acp-registry-cache-",
+      });
+      const registryDirectory = `${cacheDir}/acp-registry`;
+      yield* fileSystem.makeDirectory(registryDirectory, { recursive: true });
+      yield* fileSystem.writeFileString(`${registryDirectory}/registry.json`, makeRegistry(agent));
+      const resolver = yield* makeAcpRegistryResolver({ cacheDir, registryUrl });
+      const resolved = yield* resolver.resolve(settings(), "/workspace");
+
+      expect(resolved.spawn).toMatchObject({
+        command: "npx",
+        args: ["--yes", "@example/acp@1.2.3", "--stdio"],
+      });
+    }).pipe(
+      Effect.scoped,
+      Effect.provide(
+        resolverLayer((request) =>
+          Effect.succeed(
+            HttpClientResponse.fromWeb(request, new Response("unavailable", { status: 503 })),
+          ),
+        ),
+      ),
+    );
+  });
+
+  it.effect("rejects unsafe command paths before downloading an archive", () => {
+    const agent = makeAgent({
+      binary: {
+        "linux-x86_64": {
+          archive: archiveUrl,
+          cmd: "../outside",
+        },
+      },
+    });
+    const requests: Array<string> = [];
+    return Effect.gen(function* () {
+      const fileSystem = yield* FileSystem.FileSystem;
+      const cacheDir = yield* fileSystem.makeTempDirectoryScoped({
+        prefix: "t3-acp-registry-invalid-",
+      });
+      const resolver = yield* makeAcpRegistryResolver({ cacheDir, registryUrl });
+      const error = yield* resolver.resolve(settings(), "/workspace").pipe(Effect.flip);
+
+      expect(error.reason).toBe("archive_invalid");
+      expect(requests).toEqual([registryUrl]);
+    }).pipe(
+      Effect.scoped,
+      Effect.provide(
+        resolverLayer((request) => {
+          requests.push(request.url);
+          return Effect.succeed(
+            HttpClientResponse.fromWeb(request, new Response(makeRegistry(agent))),
+          );
+        }),
+      ),
+    );
+  });
+});
diff --git a/apps/server/src/provider/acp/AcpRegistrySupport.ts b/apps/server/src/provider/acp/AcpRegistrySupport.ts
new file mode 100644
index 000000000000..3c7e33d4a6a2
--- /dev/null
+++ b/apps/server/src/provider/acp/AcpRegistrySupport.ts
@@ -0,0 +1,633 @@
+import {
+  type AcpRegistryDistributionPreference,
+  type AcpRegistrySettings,
+} from "@t3tools/contracts";
+import { HostProcessArchitecture, HostProcessPlatform } from "@t3tools/shared/hostProcess";
+import * as Clock from "effect/Clock";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+import * as PlatformError from "effect/PlatformError";
+import * as Ref from "effect/Ref";
+import * as Schema from "effect/Schema";
+import * as Semaphore from "effect/Semaphore";
+import { HttpClient, HttpClientRequest, HttpClientResponse } from "effect/unstable/http";
+import { ChildProcess, ChildProcessSpawner } from "effect/unstable/process";
+
+import { collectUint8StreamText } from "../../stream/collectUint8StreamText.ts";
+import type { AcpSpawnInput } from "./AcpSessionRuntime.ts";
+
+export const ACP_REGISTRY_URL =
+  "https://cdn.agentclientprotocol.com/registry/v1/latest/registry.json";
+
+const AcpRegistryPackageDistribution = Schema.Struct({
+  package: Schema.String,
+  args: Schema.optionalKey(Schema.Array(Schema.String)),
+  env: Schema.optionalKey(Schema.Record(Schema.String, Schema.String)),
+});
+
+const AcpRegistryBinaryTarget = Schema.Struct({
+  archive: Schema.String,
+  cmd: Schema.String,
+  args: Schema.optionalKey(Schema.Array(Schema.String)),
+  env: Schema.optionalKey(Schema.Record(Schema.String, Schema.String)),
+});
+
+const AcpRegistryAgent = Schema.Struct({
+  id: Schema.String,
+  name: Schema.String,
+  version: Schema.String,
+  description: Schema.String,
+  distribution: Schema.Struct({
+    binary: Schema.optionalKey(Schema.Record(Schema.String, AcpRegistryBinaryTarget)),
+    npx: Schema.optionalKey(AcpRegistryPackageDistribution),
+    uvx: Schema.optionalKey(AcpRegistryPackageDistribution),
+  }),
+});
+export type AcpRegistryAgent = typeof AcpRegistryAgent.Type;
+
+const AcpRegistryIndex = Schema.Struct({
+  version: Schema.String,
+  agents: Schema.Array(AcpRegistryAgent),
+});
+export type AcpRegistryIndex = typeof AcpRegistryIndex.Type;
+
+const decodeRegistryIndex = Schema.decodeUnknownEffect(AcpRegistryIndex);
+const decodeJson = Schema.decodeUnknownEffect(Schema.fromJsonString(Schema.Unknown));
+
+export const AcpRegistryErrorReason = Schema.Literals([
+  "agent_not_configured",
+  "agent_not_found",
+  "archive_invalid",
+  "download_failed",
+  "install_failed",
+  "registry_unavailable",
+  "unsupported_distribution",
+  "unsupported_platform",
+]);
+export type AcpRegistryErrorReason = typeof AcpRegistryErrorReason.Type;
+
+export class AcpRegistryError extends Schema.TaggedErrorClass<AcpRegistryError>()(
+  "AcpRegistryError",
+  {
+    reason: AcpRegistryErrorReason,
+    detail: Schema.String,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return this.detail;
+  }
+}
+
+const isAcpRegistryError = Schema.is(AcpRegistryError);
+
+export type AcpRegistryPlatformTarget =
+  | "darwin-aarch64"
+  | "darwin-x86_64"
+  | "linux-aarch64"
+  | "linux-x86_64"
+  | "windows-aarch64"
+  | "windows-x86_64";
+
+export function resolveAcpRegistryPlatformTarget(
+  platform: NodeJS.Platform,
+  architecture: NodeJS.Architecture,
+): AcpRegistryPlatformTarget | undefined {
+  const os =
+    platform === "darwin"
+      ? "darwin"
+      : platform === "linux"
+        ? "linux"
+        : platform === "win32"
+          ? "windows"
+          : undefined;
+  const arch = architecture === "arm64" ? "aarch64" : architecture === "x64" ? "x86_64" : undefined;
+  return os && arch ? (`${os}-${arch}` as AcpRegistryPlatformTarget) : undefined;
+}
+
+export type AcpRegistryDistributionKind = "binary" | "npx" | "uvx";
+
+export interface ResolvedAcpRegistryDistribution {
+  readonly kind: AcpRegistryDistributionKind;
+  readonly args: ReadonlyArray<string>;
+  readonly env: Readonly<Record<string, string>>;
+  readonly binaryTarget?: typeof AcpRegistryBinaryTarget.Type;
+  readonly packageName?: string;
+}
+
+export function resolveAcpRegistryDistribution(input: {
+  readonly agent: AcpRegistryAgent;
+  readonly preference: AcpRegistryDistributionPreference;
+  readonly platformTarget: AcpRegistryPlatformTarget | undefined;
+}): ResolvedAcpRegistryDistribution | undefined {
+  const { agent, platformTarget } = input;
+  const binary = platformTarget ? agent.distribution.binary?.[platformTarget] : undefined;
+  const candidates: ReadonlyArray<AcpRegistryDistributionKind> =
+    input.preference === "auto" ? ["binary", "npx", "uvx"] : [input.preference];
+
+  for (const kind of candidates) {
+    if (kind === "binary" && binary) {
+      return {
+        kind,
+        args: binary.args ?? [],
+        env: binary.env ?? {},
+        binaryTarget: binary,
+      };
+    }
+    if (kind === "npx" && agent.distribution.npx) {
+      return {
+        kind,
+        args: agent.distribution.npx.args ?? [],
+        env: agent.distribution.npx.env ?? {},
+        packageName: agent.distribution.npx.package,
+      };
+    }
+    if (kind === "uvx" && agent.distribution.uvx) {
+      return {
+        kind,
+        args: agent.distribution.uvx.args ?? [],
+        env: agent.distribution.uvx.env ?? {},
+        packageName: agent.distribution.uvx.package,
+      };
+    }
+  }
+  return undefined;
+}
+
+export interface ResolvedAcpRegistryAgent {
+  readonly agent: AcpRegistryAgent;
+  readonly distribution: AcpRegistryDistributionKind;
+  readonly spawn: AcpSpawnInput;
+}
+
+export interface AcpRegistryResolverShape {
+  readonly resolve: (
+    settings: AcpRegistrySettings,
+    cwd: string,
+    environment?: NodeJS.ProcessEnv,
+  ) => Effect.Effect<ResolvedAcpRegistryAgent, AcpRegistryError>;
+}
+
+const INSTALL_LOCK_RETRY_COUNT = 300;
+const INSTALL_LOCK_RETRY_DELAY = "100 millis";
+const INSTALL_LOCK_STALE_MS = 5 * 60 * 1_000;
+const MAX_ARCHIVE_BYTES = 512 * 1024 * 1024;
+
+function isAlreadyExists(error: PlatformError.PlatformError): boolean {
+  return error.reason._tag === "AlreadyExists";
+}
+
+function normalizeRegistryCommandPath(command: string): ReadonlyArray<string> | undefined {
+  const normalized = command.trim().replaceAll("\\", "/").replace(/^\.\//u, "");
+  const segments = normalized.split("/").filter((segment) => segment.length > 0);
+  if (
+    segments.length === 0 ||
+    normalized.startsWith("/") ||
+    /^[a-zA-Z]:/u.test(normalized) ||
+    segments.some((segment) => segment === "." || segment === "..")
+  ) {
+    return undefined;
+  }
+  return segments;
+}
+
+function validateArchiveEntries(output: string): boolean {
+  return output
+    .split(/\r?\n/u)
+    .map((entry) => entry.trim())
+    .filter((entry) => entry.length > 0)
+    .every((entry) => normalizeRegistryCommandPath(entry) !== undefined);
+}
+
+type ArchiveKind = "raw" | "tar_bz2" | "tar_gz" | "zip";
+
+function archiveKind(url: string): ArchiveKind {
+  const pathname = new URL(url).pathname.toLowerCase();
+  if (pathname.endsWith(".tar.gz") || pathname.endsWith(".tgz")) return "tar_gz";
+  if (pathname.endsWith(".tar.bz2") || pathname.endsWith(".tbz2")) return "tar_bz2";
+  if (pathname.endsWith(".zip")) return "zip";
+  return "raw";
+}
+
+function archiveFileName(kind: ArchiveKind): string {
+  switch (kind) {
+    case "tar_gz":
+      return "agent.tar.gz";
+    case "tar_bz2":
+      return "agent.tar.bz2";
+    case "zip":
+      return "agent.zip";
+    case "raw":
+      return "agent.bin";
+  }
+}
+
+export const makeAcpRegistryResolver = Effect.fn("AcpRegistryResolver.make")(function* (input: {
+  readonly cacheDir: string;
+  readonly registryUrl?: string;
+}): Effect.fn.Return<
+  AcpRegistryResolverShape,
+  never,
+  | ChildProcessSpawner.ChildProcessSpawner
+  | FileSystem.FileSystem
+  | HttpClient.HttpClient
+  | Path.Path
+> {
+  const fileSystem = yield* FileSystem.FileSystem;
+  const path = yield* Path.Path;
+  const httpClient = yield* HttpClient.HttpClient;
+  const spawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+  const platform = yield* HostProcessPlatform;
+  const architecture = yield* HostProcessArchitecture;
+  const platformTarget = resolveAcpRegistryPlatformTarget(platform, architecture);
+  const registryUrl = input.registryUrl ?? ACP_REGISTRY_URL;
+  const registryDirectory = path.join(input.cacheDir, "acp-registry");
+  const registryCachePath = path.join(registryDirectory, "registry.json");
+  const installsDirectory = path.join(registryDirectory, "agents");
+  const registryRef = yield* Ref.make<AcpRegistryIndex | undefined>(undefined);
+  const registrySemaphore = yield* Semaphore.make(1);
+  const installSemaphore = yield* Semaphore.make(1);
+
+  const decodeRegistryText = Effect.fn("AcpRegistryResolver.decodeRegistryText")(function* (
+    text: string,
+  ) {
+    const decoded = yield* decodeJson(text).pipe(
+      Effect.mapError(
+        (cause) =>
+          new AcpRegistryError({
+            reason: "registry_unavailable",
+            detail: "ACP Registry returned invalid JSON.",
+            cause,
+          }),
+      ),
+    );
+    return yield* decodeRegistryIndex(decoded).pipe(
+      Effect.mapError(
+        (cause) =>
+          new AcpRegistryError({
+            reason: "registry_unavailable",
+            detail: "ACP Registry returned an invalid index.",
+            cause,
+          }),
+      ),
+    );
+  });
+
+  const readCachedRegistry = fileSystem
+    .readFileString(registryCachePath)
+    .pipe(Effect.flatMap(decodeRegistryText), Effect.option);
+
+  const writeRegistryCache = (text: string) =>
+    fileSystem
+      .makeDirectory(registryDirectory, { recursive: true })
+      .pipe(
+        Effect.andThen(fileSystem.writeFileString(`${registryCachePath}.${process.pid}.tmp`, text)),
+        Effect.andThen(
+          fileSystem.rename(`${registryCachePath}.${process.pid}.tmp`, registryCachePath),
+        ),
+        Effect.ignore,
+      );
+
+  const fetchRegistry = Effect.gen(function* () {
+    const response = yield* httpClient.execute(HttpClientRequest.get(registryUrl)).pipe(
+      Effect.flatMap(HttpClientResponse.filterStatusOk),
+      Effect.mapError(
+        (cause) =>
+          new AcpRegistryError({
+            reason: "registry_unavailable",
+            detail: `Could not fetch ACP Registry index from ${registryUrl}.`,
+            cause,
+          }),
+      ),
+    );
+    const text = yield* response.text.pipe(
+      Effect.mapError(
+        (cause) =>
+          new AcpRegistryError({
+            reason: "registry_unavailable",
+            detail: "Could not read ACP Registry response body.",
+            cause,
+          }),
+      ),
+    );
+    const registry = yield* decodeRegistryText(text);
+    yield* writeRegistryCache(text);
+    return registry;
+  });
+
+  const loadRegistry = registrySemaphore.withPermits(1)(
+    Effect.gen(function* () {
+      const memoized = yield* Ref.get(registryRef);
+      if (memoized !== undefined) return memoized;
+      const registry = yield* fetchRegistry.pipe(
+        Effect.catch((networkError) =>
+          readCachedRegistry.pipe(
+            Effect.flatMap(
+              Option.match({
+                onNone: () => Effect.fail(networkError),
+                onSome: Effect.succeed,
+              }),
+            ),
+          ),
+        ),
+      );
+      yield* Ref.set(registryRef, registry);
+      return registry;
+    }),
+  );
+
+  const runCommand = Effect.fn("AcpRegistryResolver.runCommand")(function* (
+    command: string,
+    args: ReadonlyArray<string>,
+    cwd?: string,
+  ) {
+    const child = yield* spawner.spawn(
+      ChildProcess.make(command, args, {
+        ...(cwd ? { cwd } : {}),
+        shell: false,
+      }),
+    );
+    const [stdout, stderr, exitCode] = yield* Effect.all(
+      [
+        collectUint8StreamText({ stream: child.stdout }),
+        collectUint8StreamText({ stream: child.stderr }),
+        child.exitCode,
+      ],
+      { concurrency: "unbounded" },
+    );
+    if (Number(exitCode) !== 0) {
+      return yield* new AcpRegistryError({
+        reason: "install_failed",
+        detail: `ACP Registry install command '${command}' exited with code ${Number(exitCode)}: ${stderr.text.trim()}`,
+      });
+    }
+    return stdout.text;
+  });
+
+  const acquireInstallLock = Effect.fn("AcpRegistryResolver.acquireInstallLock")(function* (
+    lockPath: string,
+  ) {
+    for (let attempt = 0; attempt < INSTALL_LOCK_RETRY_COUNT; attempt += 1) {
+      const acquired = yield* fileSystem.writeFileString(lockPath, "", { flag: "wx" }).pipe(
+        Effect.as(true),
+        Effect.catch((error) =>
+          isAlreadyExists(error) ? Effect.succeed(false) : Effect.fail(error),
+        ),
+      );
+      if (acquired) return;
+      const now = yield* Clock.currentTimeMillis;
+      const lockInfo = yield* fileSystem.stat(lockPath).pipe(Effect.option);
+      const mtime = Option.flatMap(lockInfo, (info) => info.mtime);
+      if (Option.isSome(mtime) && now - mtime.value.getTime() > INSTALL_LOCK_STALE_MS) {
+        yield* fileSystem.remove(lockPath, { force: true });
+        continue;
+      }
+      yield* Effect.sleep(INSTALL_LOCK_RETRY_DELAY);
+    }
+    return yield* new AcpRegistryError({
+      reason: "install_failed",
+      detail: `Timed out waiting for ACP Registry install lock ${lockPath}.`,
+    });
+  });
+
+  const assertExecutableInRoot = Effect.fn("AcpRegistryResolver.assertExecutableInRoot")(function* (
+    root: string,
+    executablePath: string,
+  ) {
+    const rootRealPath = yield* fileSystem.realPath(root);
+    const executableRealPath = yield* fileSystem.realPath(executablePath);
+    const relative = path.relative(rootRealPath, executableRealPath);
+    if (relative.startsWith("..") || path.isAbsolute(relative)) {
+      return yield* new AcpRegistryError({
+        reason: "archive_invalid",
+        detail: "ACP Registry archive command resolves outside its installation directory.",
+      });
+    }
+    return executableRealPath;
+  });
+
+  const installBinary = Effect.fn("AcpRegistryResolver.installBinary")(function* (
+    agent: AcpRegistryAgent,
+    target: typeof AcpRegistryBinaryTarget.Type,
+  ) {
+    if (platformTarget === undefined) {
+      return yield* new AcpRegistryError({
+        reason: "unsupported_platform",
+        detail: `ACP Registry does not support platform ${platform}-${architecture}.`,
+      });
+    }
+    const commandSegments = normalizeRegistryCommandPath(target.cmd);
+    if (commandSegments === undefined) {
+      return yield* new AcpRegistryError({
+        reason: "archive_invalid",
+        detail: `ACP Registry agent ${agent.id} declares an unsafe command path '${target.cmd}'.`,
+      });
+    }
+    const installRoot = path.join(installsDirectory, agent.id, agent.version, platformTarget);
+    const executablePath = path.join(installRoot, ...commandSegments);
+    if (yield* fileSystem.exists(executablePath).pipe(Effect.orElseSucceed(() => false))) {
+      return yield* assertExecutableInRoot(installRoot, executablePath).pipe(
+        Effect.mapError((cause) =>
+          isAcpRegistryError(cause)
+            ? cause
+            : new AcpRegistryError({
+                reason: "install_failed",
+                detail: `Could not validate cached ACP Registry agent ${agent.id}.`,
+                cause,
+              }),
+        ),
+      );
+    }
+
+    yield* fileSystem.makeDirectory(path.dirname(installRoot), { recursive: true }).pipe(
+      Effect.mapError(
+        (cause) =>
+          new AcpRegistryError({
+            reason: "install_failed",
+            detail: `Could not create ACP Registry cache for ${agent.id}.`,
+            cause,
+          }),
+      ),
+    );
+    const lockPath = `${installRoot}.lock`;
+    yield* acquireInstallLock(lockPath).pipe(
+      Effect.mapError((cause) =>
+        isAcpRegistryError(cause)
+          ? cause
+          : new AcpRegistryError({
+              reason: "install_failed",
+              detail: `Could not acquire install lock for ACP Registry agent ${agent.id}.`,
+              cause,
+            }),
+      ),
+    );
+
+    return yield* Effect.gen(function* () {
+      if (yield* fileSystem.exists(executablePath).pipe(Effect.orElseSucceed(() => false))) {
+        return yield* assertExecutableInRoot(installRoot, executablePath);
+      }
+      const temporaryRoot = yield* fileSystem.makeTempDirectoryScoped({
+        directory: path.dirname(installRoot),
+        prefix: `.${agent.id}-install-`,
+      });
+      const extractionRoot = path.join(temporaryRoot, "extracted");
+      yield* fileSystem.makeDirectory(extractionRoot, { recursive: true });
+      const kind = archiveKind(target.archive);
+      const archivePath = path.join(temporaryRoot, archiveFileName(kind));
+      const response = yield* httpClient.execute(HttpClientRequest.get(target.archive)).pipe(
+        Effect.flatMap(HttpClientResponse.filterStatusOk),
+        Effect.mapError(
+          (cause) =>
+            new AcpRegistryError({
+              reason: "download_failed",
+              detail: `Could not download ACP Registry agent ${agent.id} ${agent.version}.`,
+              cause,
+            }),
+        ),
+      );
+      const bytes = new Uint8Array(
+        yield* response.arrayBuffer.pipe(
+          Effect.mapError(
+            (cause) =>
+              new AcpRegistryError({
+                reason: "download_failed",
+                detail: `Could not read ACP Registry agent ${agent.id} download.`,
+                cause,
+              }),
+          ),
+        ),
+      );
+      if (bytes.byteLength > MAX_ARCHIVE_BYTES) {
+        return yield* new AcpRegistryError({
+          reason: "archive_invalid",
+          detail: `ACP Registry agent ${agent.id} archive exceeds ${MAX_ARCHIVE_BYTES} bytes.`,
+        });
+      }
+      yield* fileSystem.writeFile(archivePath, bytes);
+
+      if (kind === "raw") {
+        const targetPath = path.join(extractionRoot, ...commandSegments);
+        yield* fileSystem.makeDirectory(path.dirname(targetPath), { recursive: true });
+        yield* fileSystem.rename(archivePath, targetPath);
+      } else {
+        const listArgs =
+          kind === "tar_gz"
+            ? ["-tzf", archivePath]
+            : kind === "tar_bz2"
+              ? ["-tjf", archivePath]
+              : platform === "win32"
+                ? ["-tf", archivePath]
+                : undefined;
+        const entries =
+          listArgs === undefined
+            ? yield* runCommand("unzip", ["-Z1", archivePath])
+            : yield* runCommand("tar", listArgs);
+        if (!validateArchiveEntries(entries)) {
+          return yield* new AcpRegistryError({
+            reason: "archive_invalid",
+            detail: `ACP Registry agent ${agent.id} archive contains an unsafe path.`,
+          });
+        }
+        if (kind === "zip" && platform !== "win32") {
+          yield* runCommand("unzip", ["-q", archivePath, "-d", extractionRoot]);
+        } else {
+          const extractFlag = kind === "tar_gz" ? "-xzf" : kind === "tar_bz2" ? "-xjf" : "-xf";
+          yield* runCommand("tar", [extractFlag, archivePath, "-C", extractionRoot]);
+        }
+      }
+
+      const stagedExecutable = path.join(extractionRoot, ...commandSegments);
+      if (!(yield* fileSystem.exists(stagedExecutable).pipe(Effect.orElseSucceed(() => false)))) {
+        return yield* new AcpRegistryError({
+          reason: "archive_invalid",
+          detail: `ACP Registry archive for ${agent.id} did not contain '${target.cmd}'.`,
+        });
+      }
+      if (platform !== "win32") yield* fileSystem.chmod(stagedExecutable, 0o755);
+      yield* assertExecutableInRoot(extractionRoot, stagedExecutable);
+      yield* fileSystem.remove(installRoot, { recursive: true, force: true });
+      yield* fileSystem.rename(extractionRoot, installRoot);
+      return yield* assertExecutableInRoot(installRoot, executablePath);
+    }).pipe(
+      Effect.scoped,
+      Effect.ensuring(fileSystem.remove(lockPath, { force: true }).pipe(Effect.ignore)),
+      Effect.mapError((cause) =>
+        isAcpRegistryError(cause)
+          ? cause
+          : new AcpRegistryError({
+              reason: "install_failed",
+              detail: `Could not install ACP Registry agent ${agent.id}.`,
+              cause,
+            }),
+      ),
+    );
+  });
+
+  const resolve: AcpRegistryResolverShape["resolve"] = (settings, cwd, environment) =>
+    Effect.gen(function* () {
+      const agentId = settings.agentId.trim();
+      if (agentId.length === 0) {
+        return yield* new AcpRegistryError({
+          reason: "agent_not_configured",
+          detail: "ACP Registry provider requires a registry agent ID.",
+        });
+      }
+      const registry = yield* loadRegistry;
+      const agent = registry.agents.find((candidate) => candidate.id === agentId);
+      if (agent === undefined) {
+        return yield* new AcpRegistryError({
+          reason: "agent_not_found",
+          detail: `ACP Registry does not contain agent '${agentId}'.`,
+        });
+      }
+      const distribution = resolveAcpRegistryDistribution({
+        agent,
+        preference: settings.distribution,
+        platformTarget,
+      });
+      if (distribution === undefined) {
+        return yield* new AcpRegistryError({
+          reason:
+            platformTarget === undefined ? "unsupported_platform" : "unsupported_distribution",
+          detail: `ACP Registry agent ${agent.id} has no ${settings.distribution === "auto" ? "compatible" : settings.distribution} distribution for ${platform}-${architecture}.`,
+        });
+      }
+
+      let command: string;
+      let args: ReadonlyArray<string>;
+      const commandOverride = settings.commandPath.trim();
+      if (commandOverride.length > 0) {
+        command = commandOverride;
+        args = distribution.args;
+      } else if (distribution.kind === "npx") {
+        command = "npx";
+        args = ["--yes", distribution.packageName!, ...distribution.args];
+      } else if (distribution.kind === "uvx") {
+        command = "uvx";
+        args = [distribution.packageName!, ...distribution.args];
+      } else {
+        command = yield* installSemaphore.withPermits(1)(
+          installBinary(agent, distribution.binaryTarget!),
+        );
+        args = distribution.args;
+      }
+
+      return {
+        agent,
+        distribution: distribution.kind,
+        spawn: {
+          command,
+          args,
+          cwd,
+          env: {
+            ...environment,
+            ...distribution.env,
+          },
+        },
+      } satisfies ResolvedAcpRegistryAgent;
+    });
+
+  return { resolve };
+});
diff --git a/apps/server/src/provider/acp/AcpRuntimeModel.test.ts b/apps/server/src/provider/acp/AcpRuntimeModel.test.ts
index 9e5075a5f70a..6c1602f6a89a 100644
--- a/apps/server/src/provider/acp/AcpRuntimeModel.test.ts
+++ b/apps/server/src/provider/acp/AcpRuntimeModel.test.ts
@@ -9,6 +9,7 @@ import {
   parsePermissionRequest,
   parseSessionModeState,
   parseSessionUpdateEvent,
+  sessionUpdateCountsAsLoadReplayActivity,
   sessionUpdateIsReplay,
   syntheticLoadSessionResponseFromInitialize,
   toolCallProgressLength,
@@ -86,6 +87,98 @@ describe("AcpRuntimeModel", () => {
     ).toBe(false);
   });
 
+  it("ignores Grok keepalive chunks when tracking session/load replay activity", () => {
+    expect(
+      sessionUpdateCountsAsLoadReplayActivity({
+        sessionId: "session-1",
+        update: {
+          sessionUpdate: "agent_message_chunk",
+          content: { type: "text", text: "" },
+        },
+      } satisfies EffectAcpSchema.SessionNotification),
+    ).toBe(false);
+    expect(
+      sessionUpdateCountsAsLoadReplayActivity({
+        _meta: { isReplay: true },
+        sessionId: "session-1",
+        update: {
+          sessionUpdate: "tool_call",
+          toolCallId: "replay-tool",
+          title: "Replay",
+          kind: "search",
+          status: "completed",
+        },
+      } satisfies EffectAcpSchema.SessionNotification),
+    ).toBe(true);
+  });
+
+  it("ignores load-replay activity from other sessions while a load gate is active", () => {
+    expect(
+      sessionUpdateCountsAsLoadReplayActivity(
+        {
+          sessionId: "session-other",
+          update: {
+            sessionUpdate: "agent_message_chunk",
+            content: { type: "text", text: "unrelated" },
+          },
+        } satisfies EffectAcpSchema.SessionNotification,
+        "session-loading",
+      ),
+    ).toBe(false);
+    expect(
+      sessionUpdateCountsAsLoadReplayActivity(
+        {
+          sessionId: "session-loading",
+          update: {
+            sessionUpdate: "agent_message_chunk",
+            content: { type: "text", text: "replay" },
+          },
+        } satisfies EffectAcpSchema.SessionNotification,
+        "session-loading",
+      ),
+    ).toBe(true);
+  });
+
+  it("counts mode/config/session/usage updates as load-replay activity", () => {
+    expect(
+      sessionUpdateCountsAsLoadReplayActivity({
+        sessionId: "session-1",
+        update: {
+          sessionUpdate: "current_mode_update",
+          currentModeId: "code",
+        },
+      } satisfies EffectAcpSchema.SessionNotification),
+    ).toBe(true);
+    expect(
+      sessionUpdateCountsAsLoadReplayActivity({
+        sessionId: "session-1",
+        update: {
+          sessionUpdate: "config_option_update",
+          configOptions: [],
+        },
+      } satisfies EffectAcpSchema.SessionNotification),
+    ).toBe(true);
+    expect(
+      sessionUpdateCountsAsLoadReplayActivity({
+        sessionId: "session-1",
+        update: {
+          sessionUpdate: "session_info_update",
+          title: "Restored",
+        },
+      } satisfies EffectAcpSchema.SessionNotification),
+    ).toBe(true);
+    expect(
+      sessionUpdateCountsAsLoadReplayActivity({
+        sessionId: "session-1",
+        update: {
+          sessionUpdate: "usage_update",
+          used: 1,
+          size: 10,
+        },
+      } satisfies EffectAcpSchema.SessionNotification),
+    ).toBe(true);
+  });
+
   it("builds a synthetic load response from initialize model state", () => {
     const response = syntheticLoadSessionResponseFromInitialize({
       protocolVersion: 1,
diff --git a/apps/server/src/provider/acp/AcpRuntimeModel.ts b/apps/server/src/provider/acp/AcpRuntimeModel.ts
index 8fd7af3c5610..dcc388d17129 100644
--- a/apps/server/src/provider/acp/AcpRuntimeModel.ts
+++ b/apps/server/src/provider/acp/AcpRuntimeModel.ts
@@ -111,6 +111,7 @@ export type AcpParsedSessionEvent =
     };
 
 type AcpSessionSetupResponse =
+  | EffectAcpSchema.ForkSessionResponse
   | EffectAcpSchema.LoadSessionResponse
   | EffectAcpSchema.NewSessionResponse
   | EffectAcpSchema.ResumeSessionResponse;
@@ -680,8 +681,38 @@ export function sessionUpdateIsReplay(params: EffectAcpSchema.SessionNotificatio
   return isRecord(meta) && meta.isReplay === true;
 }
 
+/** Replay chunks and substantive updates during session/load; not Grok keepalives. */
+export function sessionUpdateCountsAsLoadReplayActivity(
+  params: EffectAcpSchema.SessionNotification,
+  gatedSessionId?: string,
+): boolean {
+  if (gatedSessionId !== undefined && params.sessionId !== gatedSessionId) {
+    return false;
+  }
+  if (sessionUpdateIsReplay(params)) return true;
+  const update = params.update;
+  switch (update.sessionUpdate) {
+    case "agent_message_chunk":
+    case "agent_thought_chunk":
+      return update.content.type === "text" && update.content.text.length > 0;
+    case "tool_call":
+    case "tool_call_update":
+    case "plan":
+    case "available_commands_update":
+    case "current_mode_update":
+    case "config_option_update":
+    case "session_info_update":
+    case "usage_update":
+      return true;
+    default:
+      return false;
+  }
+}
+
 export interface SessionLoadGate {
   readonly active: boolean;
+  /** Only notifications for this session refresh load-replay idle activity. */
+  readonly sessionId: string;
   readonly lastActivityAtMillis: number | undefined;
   readonly idleGap: Duration.Duration;
   readonly initializeResult: EffectAcpSchema.InitializeResponse;
diff --git a/apps/server/src/provider/acp/AcpSessionRuntime.processTree.test.ts b/apps/server/src/provider/acp/AcpSessionRuntime.processTree.test.ts
new file mode 100644
index 000000000000..aba92ae2a7e7
--- /dev/null
+++ b/apps/server/src/provider/acp/AcpSessionRuntime.processTree.test.ts
@@ -0,0 +1,1090 @@
+// @effect-diagnostics nodeBuiltinImport:off
+import * as NodeChildProcess from "node:child_process";
+import * as NodeFS from "node:fs";
+import * as NodePath from "node:path";
+import * as NodeURL from "node:url";
+
+import { describe, expect, it } from "@effect/vitest";
+import { HostProcessPlatform } from "@t3tools/shared/hostProcess";
+import * as Clock from "effect/Clock";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as Scope from "effect/Scope";
+
+import {
+  capturePosixOwnershipLedger,
+  isSafeCgroupPath,
+  makeLinuxCgroupController,
+  makePosixProcessTreeController,
+  observePosixOwnershipLedger,
+  observePosixOwnershipLedgerContinuously,
+  parseCgroup2Mount,
+  parseCgroup2Mounts,
+  parseUnifiedCgroupPath,
+  posixProcessIsZombie,
+  resolveLinuxCgroupTargetCommand,
+  signalLinuxCgroupRootTerm,
+  sweepStaleLinuxCgroupSiblings,
+  terminateLinuxCgroupLease,
+  terminatePosixOwnedProcessTree,
+  wrapCommandForLinuxCgroup,
+  type AcpOwnedPosixProcess,
+  type AcpLinuxCgroupLease,
+  type AcpPosixOwnershipRoot,
+  type AcpPosixProcessIdentity,
+  type AcpPosixProcessTreeController,
+} from "./AcpSessionRuntime.ts";
+
+const threadSpawnHelperSource = NodeURL.fileURLToPath(
+  new URL("../../../scripts/acp-thread-spawn-helper.c", import.meta.url),
+);
+
+const identity = (
+  pid: number,
+  ppid: number,
+  pgid: number,
+  sid: number,
+  startTime = String(pid),
+  state = "S",
+): AcpPosixProcessIdentity => ({
+  executable: `/proc/${pid}/exe`,
+  pgid,
+  pid,
+  ppid,
+  sid,
+  startTime,
+  state,
+});
+
+function makeController(input: {
+  readonly processes: ReadonlyArray<AcpPosixProcessIdentity>;
+  readonly onProcess?: (
+    processes: Map<number, AcpPosixProcessIdentity>,
+    pid: number,
+    signal: NodeJS.Signals,
+  ) => void;
+}) {
+  const processes = new Map(input.processes.map((process) => [process.pid, process]));
+  const signals: Array<string> = [];
+  const controller: AcpPosixProcessTreeController = {
+    childPidsOf: (pid) =>
+      [...processes.values()]
+        .filter((process) => process.ppid === pid)
+        .map((process) => process.pid),
+    childrenOf: (pid) => [...processes.values()].filter((process) => process.ppid === pid),
+    identity: (pid) => processes.get(pid),
+    snapshot: () => [...processes.values()],
+    signalProcess: (pid, signal) => {
+      signals.push(`process:${pid}:${signal}`);
+      if (input.onProcess) return input.onProcess(processes, pid, signal);
+      processes.delete(pid);
+    },
+  };
+  return { controller, processes, signals };
+}
+
+const server = () => identity(process.pid, 1, process.pid, process.pid, "server");
+
+function processExists(pid: number): boolean {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+describe("terminatePosixOwnedProcessTree", () => {
+  it("parses unified cgroup paths and escaped cgroup2 mountinfo", () => {
+    expect(parseUnifiedCgroupPath("0::/user.slice/app.scope\n")).toBe("/user.slice/app.scope");
+    expect(parseUnifiedCgroupPath("0::/one\n0::/two\n")).toBeUndefined();
+    expect(isSafeCgroupPath("/user.slice/app.scope")).toBe(true);
+    expect(isSafeCgroupPath("/user.slice/../escape")).toBe(false);
+    expect(isSafeCgroupPath("/user.slice/app.scope (deleted)")).toBe(false);
+    expect(
+      parseCgroup2Mount(
+        "42 31 0:37 /user.slice /sys/fs/cgroup/user\\040mount rw - cgroup2 cgroup2 rw\n",
+      ),
+    ).toEqual({ mountPoint: "/sys/fs/cgroup/user mount", root: "/user.slice" });
+    expect(parseCgroup2Mount("42 31 0:37 / /sys/fs/cgroup rw - tmpfs tmpfs rw\n")).toBeUndefined();
+    expect(
+      parseCgroup2Mounts(
+        "41 31 0:36 /other /sys/fs/cgroup/other rw - cgroup2 cgroup2 rw\n" +
+          "42 31 0:37 /user.slice /sys/fs/cgroup/user rw - cgroup2 cgroup2 rw\n",
+      ),
+    ).toHaveLength(2);
+  });
+
+  it.live("sweeps empty t3-acp sibling leases owned by dead pids only", () =>
+    Effect.sync(() => {
+      const scratchRoot = NodePath.join(process.cwd(), "tmp");
+      NodeFS.mkdirSync(scratchRoot, { recursive: true });
+      const parent = NodeFS.mkdtempSync(NodePath.join(scratchRoot, "acp-cgroup-stale-siblings-"));
+      // Temp dirs are not cgroupfs: rmdir fails when control files exist, so the
+      // test injects populated/remove while still exercising the real selection
+      // and path-safety logic against a real parent directory tree.
+      const populatedByPath = new Map<string, "0" | "1">();
+      const writeSibling = (name: string, populated: "0" | "1" | null) => {
+        const path = NodePath.join(parent, name);
+        NodeFS.mkdirSync(path);
+        if (populated !== null) populatedByPath.set(path, populated);
+        return path;
+      };
+      const deadPid = 2_147_483_646;
+      // Synthetic live foreign pid (not this process, still reported alive by the probe).
+      const liveForeignPid = 2_147_483_645;
+      const staleEmpty = writeSibling(`t3-acp-${deadPid}-aaaa`, "0");
+      const currentPidSibling = writeSibling(`t3-acp-${process.pid}-bbbb`, "0");
+      const liveForeignSibling = writeSibling(`t3-acp-${liveForeignPid}-cccc`, "0");
+      const stalePopulated = writeSibling(`t3-acp-${deadPid}-dddd`, "1");
+      const unrelated = writeSibling("other-lease", "0");
+      const isProcessAlive = (pid: number) => pid === process.pid || pid === liveForeignPid;
+      try {
+        sweepStaleLinuxCgroupSiblings(parent, {
+          isProcessAlive,
+          readPopulated: (path) => populatedByPath.get(path),
+          remove: (path) => {
+            populatedByPath.delete(path);
+            NodeFS.rmdirSync(path);
+          },
+        });
+        expect(NodeFS.existsSync(staleEmpty)).toBe(false);
+        expect(NodeFS.existsSync(currentPidSibling)).toBe(true);
+        expect(NodeFS.existsSync(liveForeignSibling)).toBe(true);
+        expect(NodeFS.existsSync(stalePopulated)).toBe(true);
+        expect(NodeFS.existsSync(unrelated)).toBe(true);
+        // Missing populated state must not remove a sibling.
+        writeSibling(`t3-acp-${deadPid}-eeee`, null);
+        sweepStaleLinuxCgroupSiblings(parent, {
+          isProcessAlive,
+          readPopulated: (path) => populatedByPath.get(path),
+          remove: (path) => {
+            populatedByPath.delete(path);
+            NodeFS.rmdirSync(path);
+          },
+        });
+        expect(NodeFS.existsSync(NodePath.join(parent, `t3-acp-${deadPid}-eeee`))).toBe(true);
+        expect(NodeFS.existsSync(currentPidSibling)).toBe(true);
+      } finally {
+        NodeFS.rmSync(parent, { recursive: true, force: true });
+      }
+    }),
+  );
+
+  it.live("preserves exact argv and strips wrapper-only environment before exec", () =>
+    Effect.gen(function* () {
+      if ((yield* HostProcessPlatform) !== "linux") return;
+      const lease = makeLinuxCgroupController().create();
+      if (lease === undefined) return;
+      const scratchRoot = NodePath.join(process.cwd(), "tmp");
+      NodeFS.mkdirSync(scratchRoot, { recursive: true });
+      const scratch = NodeFS.mkdtempSync(NodePath.join(scratchRoot, "acp-cgroup-wrapper-"));
+      const linkedNode = NodePath.join(scratch, "T3 Code AppImage 'quoted'");
+      const bareGrok = NodePath.join(scratch, "grok");
+      const relativeBin = NodePath.join(scratch, "relative-bin");
+      const directoryBin = NodePath.join(scratch, "directory-bin");
+      const validBin = NodePath.join(scratch, "valid-bin");
+      const outputPath = NodePath.join(scratch, "argv.json");
+      NodeFS.mkdirSync(relativeBin);
+      NodeFS.mkdirSync(NodePath.join(directoryBin, "grok"), { recursive: true });
+      NodeFS.mkdirSync(validBin);
+      NodeFS.symlinkSync(process.execPath, linkedNode);
+      NodeFS.symlinkSync(process.execPath, bareGrok);
+      NodeFS.symlinkSync(process.execPath, NodePath.join(relativeBin, "grok"));
+      NodeFS.symlinkSync(process.execPath, NodePath.join(validBin, "grok"));
+      expect(resolveLinuxCgroupTargetCommand("grok", scratch, { PATH: scratch })).toBe(bareGrok);
+      expect(resolveLinuxCgroupTargetCommand("grok", scratch, { PATH: "" })).toBe(bareGrok);
+      // Undefined PATH uses Node's default search path (/usr/bin:/bin), not cwd alone
+      // (bareGrok lives only in cwd / PATH=scratch).
+      expect(resolveLinuxCgroupTargetCommand("grok", scratch, { PATH: undefined })).toBeUndefined();
+      expect(resolveLinuxCgroupTargetCommand("node", scratch, { PATH: undefined })).toBeDefined();
+      expect(resolveLinuxCgroupTargetCommand("grok", scratch, { PATH: "relative-bin" })).toBe(
+        NodePath.join(relativeBin, "grok"),
+      );
+      expect(
+        resolveLinuxCgroupTargetCommand("grok", scratch, {
+          PATH: `directory-bin${NodePath.delimiter}valid-bin`,
+        }),
+      ).toBe(NodePath.join(validBin, "grok"));
+      const target = [
+        'const fs = require("node:fs");',
+        "fs.writeFileSync(process.argv[1], JSON.stringify({",
+        "  args: process.argv.slice(2),",
+        "  electron: process.env.ELECTRON_RUN_AS_NODE,",
+        "  wrapper: process.env.T3_ACP_CGROUP_WRAPPER,",
+        "}));",
+      ].join("\n");
+      const wrapped = wrapCommandForLinuxCgroup(lease, linkedNode, [
+        "-e",
+        target,
+        outputPath,
+        "space value",
+        "single'quote",
+        'double"quote',
+      ]);
+      try {
+        const result = NodeChildProcess.spawnSync(wrapped.command, wrapped.args, {
+          encoding: "utf8",
+          env: {
+            ...process.env,
+            ELECTRON_RUN_AS_NODE: "1",
+            T3_ACP_CGROUP_WRAPPER: "1",
+          },
+        });
+        expect(result.status, result.stderr).toBe(0);
+        expect(NodeFS.readFileSync(outputPath, "utf8")).toBe(
+          '{"args":["space value","single\'quote","double\\"quote"]}',
+        );
+      } finally {
+        yield* terminateLinuxCgroupLease(lease).pipe(Effect.ignore);
+        NodeFS.rmSync(scratch, { recursive: true, force: true });
+      }
+    }),
+  );
+
+  it.live("kills a post-TERM detached double fork without touching an unrelated sentinel", () =>
+    Effect.gen(function* () {
+      if ((yield* HostProcessPlatform) !== "linux") return;
+      const controller = makeLinuxCgroupController();
+      const lease = controller.create();
+      if (lease === undefined) return;
+      expect(parseUnifiedCgroupPath(NodeFS.readFileSync("/proc/self/cgroup", "utf8"))).not.toBe(
+        lease.relativePath,
+      );
+      const scratchRoot = NodePath.join(process.cwd(), "tmp");
+      NodeFS.mkdirSync(scratchRoot, { recursive: true });
+      const scratch = NodeFS.mkdtempSync(NodePath.join(scratchRoot, "acp-cgroup-kill-"));
+      const readyPath = NodePath.join(scratch, "ready");
+      const childPath = NodePath.join(scratch, "child");
+      const childProgram = "setInterval(() => {}, 1000);";
+      const launcherProgram = [
+        'const fs = require("node:fs");',
+        'const cp = require("node:child_process");',
+        "const child = cp.spawn(process.execPath, ['-e', process.argv[2]], { detached: true, stdio: 'ignore' });",
+        "fs.writeFileSync(process.argv[1], String(child.pid));",
+        "child.unref();",
+      ].join("\n");
+      const providerProgram = [
+        'const fs = require("node:fs");',
+        'const cp = require("node:child_process");',
+        "fs.writeFileSync(process.argv[1], String(process.pid));",
+        "process.on('SIGTERM', () => {",
+        "  const launcher = cp.spawn(process.execPath, ['-e', process.argv[3], process.argv[2], process.argv[4]], { detached: true, stdio: 'ignore' });",
+        "  launcher.unref();",
+        "  process.exit(0);",
+        "});",
+        "setInterval(() => {}, 1000);",
+      ].join("\n");
+      const wrapped = wrapCommandForLinuxCgroup(lease, process.execPath, [
+        "-e",
+        providerProgram,
+        readyPath,
+        childPath,
+        launcherProgram,
+        childProgram,
+      ]);
+      const provider = NodeChildProcess.spawn(wrapped.command, wrapped.args, {
+        detached: true,
+        env: { ...process.env, ELECTRON_RUN_AS_NODE: "1", T3_ACP_CGROUP_WRAPPER: "1" },
+        stdio: "ignore",
+      });
+      provider.unref();
+      const sentinel = NodeChildProcess.spawn(process.execPath, ["-e", childProgram], {
+        detached: true,
+        stdio: "ignore",
+      });
+      sentinel.unref();
+      let detachedChildPid: number | undefined;
+      try {
+        yield* Effect.gen(function* () {
+          while (!NodeFS.existsSync(readyPath)) yield* Effect.sleep("10 millis");
+        }).pipe(Effect.timeout("2 seconds"));
+        process.kill(provider.pid!, "SIGTERM");
+        detachedChildPid = yield* Effect.gen(function* () {
+          while (true) {
+            try {
+              const pid = Number(NodeFS.readFileSync(childPath, "utf8"));
+              if (Number.isSafeInteger(pid) && pid > 1) return pid;
+            } catch {
+              // The TERM-time launcher has not published its child yet.
+            }
+            yield* Effect.sleep("10 millis");
+          }
+        }).pipe(Effect.timeout("2 seconds"));
+        expect(processExists(detachedChildPid)).toBe(true);
+        yield* terminateLinuxCgroupLease(lease);
+        expect(processExists(sentinel.pid!)).toBe(true);
+        yield* Effect.gen(function* () {
+          while (processExists(detachedChildPid!)) yield* Effect.sleep("10 millis");
+        }).pipe(Effect.timeout("2 seconds"));
+        expect(NodeFS.existsSync(lease.path)).toBe(false);
+
+        const replacement = controller.create();
+        expect(replacement?.path).not.toBe(lease.path);
+        if (replacement !== undefined) {
+          NodeFS.mkdirSync(NodePath.join(replacement.path, "nested"));
+          yield* terminateLinuxCgroupLease(replacement);
+          expect(NodeFS.existsSync(replacement.path)).toBe(false);
+        }
+      } finally {
+        yield* terminateLinuxCgroupLease(lease).pipe(Effect.ignore);
+        try {
+          process.kill(-provider.pid!, "SIGKILL");
+        } catch {
+          // The contained provider already exited.
+        }
+        try {
+          process.kill(-sentinel.pid!, "SIGKILL");
+        } catch {
+          // The unrelated sentinel already exited.
+        }
+        if (detachedChildPid !== undefined && processExists(detachedChildPid)) {
+          try {
+            process.kill(detachedChildPid, "SIGKILL");
+          } catch {
+            // The detached child already exited.
+          }
+        }
+        NodeFS.rmSync(scratch, { recursive: true, force: true });
+      }
+    }),
+  );
+
+  it.live("re-kills repopulated cgroups and verifies root removal after retryable errors", () =>
+    Effect.gen(function* () {
+      let exists = true;
+      let killCalls = 0;
+      let populated = false;
+      let removeCalls = 0;
+      const lease: AcpLinuxCgroupLease = {
+        contains: () => false,
+        exists: () => exists,
+        path: "/test/t3-acp-repopulation",
+        relativePath: "/test/t3-acp-repopulation",
+        kill: () => {
+          killCalls += 1;
+          populated = false;
+        },
+        populated: () => populated,
+        remove: () => {
+          removeCalls += 1;
+          if (removeCalls === 1) {
+            populated = true;
+            const error = new Error("repopulated") as NodeJS.ErrnoException;
+            error.code = "EBUSY";
+            throw error;
+          }
+          if (removeCalls === 2) {
+            const error = new Error("nested path vanished") as NodeJS.ErrnoException;
+            error.code = "ENOENT";
+            throw error;
+          }
+          exists = false;
+        },
+      };
+
+      yield* terminateLinuxCgroupLease(lease);
+      expect(killCalls).toBeGreaterThanOrEqual(3);
+      expect(removeCalls).toBe(3);
+      expect(exists).toBe(false);
+      yield* terminateLinuxCgroupLease(lease);
+      expect(removeCalls).toBe(3);
+    }),
+  );
+
+  it.live("reports persistent retryable removal failures as removal failures", () =>
+    Effect.gen(function* () {
+      const removeError = Object.assign(new Error("cgroup remains busy"), {
+        code: "EBUSY",
+      });
+      const lease: AcpLinuxCgroupLease = {
+        contains: () => false,
+        exists: () => true,
+        path: "/test/t3-acp-busy",
+        relativePath: "/test/t3-acp-busy",
+        kill: () => undefined,
+        populated: () => false,
+        remove: () => {
+          throw removeError;
+        },
+      };
+
+      const error = yield* Effect.flip(terminateLinuxCgroupLease(lease));
+      expect(error.detail).toBe("Failed to remove ACP cgroup /test/t3-acp-busy");
+      expect(error.cause).toBe(removeError);
+    }),
+  );
+
+  it("sends TERM only to the exact captured root while it remains in the child cgroup", () => {
+    const fixture = makeController({
+      processes: [server(), identity(100, process.pid, 100, 100, "owned")],
+    });
+    const ownedRoot: AcpOwnedPosixProcess = {
+      ...identity(100, process.pid, 100, 100, "owned"),
+      parentExecutable: server().executable,
+      parentStartTime: server().startTime,
+    };
+    const root: AcpPosixOwnershipRoot = { captureAttempted: true, value: ownedRoot };
+    const lease: AcpLinuxCgroupLease = {
+      contains: () => true,
+      exists: () => true,
+      path: "/test/t3-acp-root",
+      relativePath: "/test/t3-acp-root",
+      kill: () => undefined,
+      populated: () => true,
+      remove: () => undefined,
+    };
+    signalLinuxCgroupRootTerm({ controller: fixture.controller, lease, root });
+    expect(fixture.signals).toEqual(["process:100:SIGTERM"]);
+
+    const reused = makeController({
+      processes: [server(), identity(100, process.pid, 100, 100, "reused")],
+    });
+    signalLinuxCgroupRootTerm({ controller: reused.controller, lease, root });
+    expect(reused.signals).toEqual([]);
+
+    const migrated = makeController({
+      processes: [server(), identity(100, process.pid, 100, 100, "owned")],
+    });
+    signalLinuxCgroupRootTerm({
+      controller: migrated.controller,
+      lease: { ...lease, contains: () => false },
+      root,
+    });
+    expect(migrated.signals).toEqual([]);
+  });
+
+  it.live("finds a child forked by a non-leader pthread", () =>
+    Effect.gen(function* () {
+      if ((yield* HostProcessPlatform) !== "linux") return;
+      const scratchRoot = NodePath.join(process.cwd(), "tmp");
+      NodeFS.mkdirSync(scratchRoot, { recursive: true });
+      const scratch = NodeFS.mkdtempSync(NodePath.join(scratchRoot, "acp-pthread-spawn-"));
+      const binary = NodePath.join(scratch, "helper");
+      const pidPath = NodePath.join(scratch, "pids");
+      expect(NodeFS.statSync(threadSpawnHelperSource).isFile()).toBe(true);
+      const compile = NodeChildProcess.spawnSync(
+        "cc",
+        ["-pthread", threadSpawnHelperSource, "-o", binary],
+        {
+          encoding: "utf8",
+        },
+      );
+      if ((compile.error as NodeJS.ErrnoException | undefined)?.code === "ENOENT") {
+        NodeFS.rmSync(scratch, { recursive: true, force: true });
+        return;
+      }
+      expect(compile.status, compile.stderr).toBe(0);
+      const helper = NodeChildProcess.spawn(binary, [pidPath], { detached: true, stdio: "ignore" });
+      helper.unref();
+      try {
+        const published = yield* Effect.gen(function* () {
+          while (true) {
+            try {
+              const ids = NodeFS.readFileSync(pidPath, "utf8").trim().split(/\s+/).map(Number);
+              if (ids.length === 2 && ids.every(Number.isSafeInteger)) return ids;
+            } catch {
+              // The worker has not published its TID and child yet.
+            }
+            yield* Effect.sleep("10 millis");
+          }
+        }).pipe(Effect.timeout("2 seconds"));
+        const [workerTid, childPid] = published;
+        expect(workerTid).not.toBe(helper.pid);
+        expect(makePosixProcessTreeController("linux").childrenOf(helper.pid!)).toContainEqual(
+          expect.objectContaining({ pid: childPid, ppid: helper.pid }),
+        );
+      } finally {
+        try {
+          process.kill(-helper.pid!, "SIGKILL");
+        } catch {
+          // The isolated fixture already exited.
+        }
+        NodeFS.rmSync(scratch, { recursive: true, force: true });
+      }
+    }),
+  );
+
+  it.live("keeps ownership across a fork-before-exec executable transition", () =>
+    Effect.gen(function* () {
+      const beforeExec = { ...identity(110, 100, 110, 110), executable: "/provider/fork" };
+      const fixture = makeController({
+        processes: [server(), identity(100, process.pid, 100, 100), beforeExec],
+      });
+      const frontier = new Map<number, AcpOwnedPosixProcess>();
+      const childQueues = new Map<number, Array<number>>();
+      const ledger = new Map<string, AcpOwnedPosixProcess>();
+      const root: AcpPosixOwnershipRoot = { value: undefined };
+      observePosixOwnershipLedger({
+        childQueues,
+        controller: fixture.controller,
+        frontier,
+        ledger,
+        root,
+        rootPid: 100,
+      });
+      fixture.processes.set(110, { ...beforeExec, executable: "/usr/bin/bash" });
+      observePosixOwnershipLedger({
+        childQueues,
+        controller: fixture.controller,
+        frontier,
+        ledger,
+        root,
+        rootPid: 100,
+      });
+
+      expect([...ledger.values()].find((process) => process.pid === 110)?.executable).toBe(
+        "/usr/bin/bash",
+      );
+      yield* terminatePosixOwnedProcessTree({
+        controller: fixture.controller,
+        grace: 0,
+        ledger,
+        rootPid: 100,
+      });
+      expect(fixture.signals).toContain("process:110:SIGTERM");
+      expect(fixture.processes.has(110)).toBe(false);
+    }),
+  );
+
+  it("never adopts a replacement PID after initial root capture failed", () => {
+    const fixture = makeController({ processes: [server()] });
+    const frontier = new Map<number, AcpOwnedPosixProcess>();
+    const childQueues = new Map<number, Array<number>>();
+    const ledger = new Map<string, AcpOwnedPosixProcess>();
+    const root: AcpPosixOwnershipRoot = { value: undefined };
+    const capture = () => {
+      try {
+        observePosixOwnershipLedger({
+          childQueues,
+          controller: fixture.controller,
+          frontier,
+          ledger,
+          root,
+          rootPid: 100,
+        });
+        return undefined;
+      } catch (error) {
+        return error;
+      }
+    };
+    expect(capture()).toMatchObject({
+      detail: "ACP process 100 exited before its ownership ledger was captured",
+    });
+    fixture.processes.set(100, identity(100, process.pid, 100, 100, "reused"));
+    expect(capture()).toMatchObject({
+      detail: "ACP process 100 exited before its ownership ledger was captured",
+    });
+    expect(ledger.size).toBe(0);
+  });
+
+  it.live("rotates more than 64 live parents without scanning retained tombstones", () =>
+    Effect.gen(function* () {
+      const parents = Array.from({ length: 130 }, (_, index) =>
+        identity(1_000 + index, 100, 1_000 + index, 1_000 + index),
+      );
+      let childListReads = 0;
+      let identityCalls = 0;
+      let snapshotCalls = 0;
+      const fixture = makeController({
+        processes: [server(), identity(100, process.pid, 100, 100)],
+      });
+      const controller: AcpPosixProcessTreeController = {
+        ...fixture.controller,
+        childPidsOf: (pid) => {
+          childListReads += 1;
+          return fixture.controller.childPidsOf(pid);
+        },
+        identity: (pid) => {
+          identityCalls += 1;
+          return fixture.controller.identity(pid);
+        },
+        snapshot: () => {
+          snapshotCalls += 1;
+          return fixture.controller.snapshot();
+        },
+      };
+      const frontier = new Map<number, AcpOwnedPosixProcess>();
+      const childQueues = new Map<number, Array<number>>();
+      const ledger = new Map<string, AcpOwnedPosixProcess>();
+      const root: AcpPosixOwnershipRoot = { value: undefined };
+      for (let index = 0; index < 5_000; index += 1) {
+        const tombstone = identity(100_000 + index, 1, 100_000 + index, 100_000 + index);
+        ledger.set(`${tombstone.pid}:${tombstone.startTime}`, {
+          ...tombstone,
+          parentExecutable: undefined,
+          parentStartTime: "",
+        });
+      }
+      observePosixOwnershipLedger({
+        childQueues,
+        controller,
+        frontier,
+        ledger,
+        root,
+        rootPid: 100,
+      });
+      for (const parent of parents) {
+        fixture.processes.set(parent.pid, parent);
+        fixture.processes.set(
+          parent.pid + 10_000,
+          identity(parent.pid + 10_000, parent.pid, parent.pgid, parent.sid),
+        );
+      }
+      let passes = 0;
+      while (
+        !parents.every((parent) =>
+          [...ledger.values()].some((owned) => owned.pid === parent.pid + 10_000),
+        ) &&
+        passes < 40
+      ) {
+        childListReads = 0;
+        identityCalls = 0;
+        observePosixOwnershipLedger({
+          childQueues,
+          controller,
+          frontier,
+          ledger,
+          maxProcesses: 64,
+          root,
+          rootPid: 100,
+        });
+        expect(identityCalls + childListReads).toBeLessThanOrEqual(64);
+        passes += 1;
+      }
+
+      const missing = parents.filter(
+        (parent) => ![...ledger.values()].some((owned) => owned.pid === parent.pid + 10_000),
+      );
+      expect(missing, `missing after ${passes} passes`).toEqual([]);
+      expect(passes).toBeGreaterThan(2);
+      yield* terminatePosixOwnedProcessTree({
+        controller,
+        grace: 0,
+        ledger,
+        rootPid: 100,
+      });
+      expect(snapshotCalls).toBe(10);
+      expect(fixture.processes.size).toBe(1);
+    }),
+  );
+
+  it.live("polls only known descendants and stops with its scope", () =>
+    Effect.gen(function* () {
+      let childrenCalls = 0;
+      let identityCalls = 0;
+      let snapshotCalls = 0;
+      const fixture = makeController({
+        processes: [server(), identity(100, process.pid, 100, 100), identity(110, 100, 110, 110)],
+      });
+      const controller: AcpPosixProcessTreeController = {
+        ...fixture.controller,
+        childPidsOf: (pid) => {
+          childrenCalls += 1;
+          return fixture.controller.childPidsOf(pid);
+        },
+        identity: (pid) => {
+          identityCalls += 1;
+          return fixture.controller.identity(pid);
+        },
+        snapshot: () => {
+          snapshotCalls += 1;
+          return fixture.controller.snapshot();
+        },
+      };
+      const scope = yield* Scope.make();
+      const frontier = new Map<number, AcpOwnedPosixProcess>();
+      const childQueues = new Map<number, Array<number>>();
+      let ledgerValuesCalls = 0;
+      const ledger = new (class extends Map<string, AcpOwnedPosixProcess> {
+        override values(): MapIterator<AcpOwnedPosixProcess> {
+          ledgerValuesCalls += 1;
+          return super.values();
+        }
+      })();
+      const root: AcpPosixOwnershipRoot = { value: undefined };
+      for (let index = 0; index < 5_000; index += 1) {
+        const tombstone = identity(10_000 + index, 1, 10_000 + index, 10_000 + index);
+        ledger.set(`${tombstone.pid}:${tombstone.startTime}`, {
+          ...tombstone,
+          parentExecutable: undefined,
+          parentStartTime: "",
+        });
+      }
+      yield* observePosixOwnershipLedgerContinuously({
+        childQueues,
+        controller,
+        frontier,
+        ledger,
+        root,
+        rootPid: 100,
+      }).pipe(Effect.forkIn(scope));
+      const timerStartedAt = yield* Clock.currentTimeMillis;
+      yield* Effect.sleep(0);
+      const timerDelay = (yield* Clock.currentTimeMillis) - timerStartedAt;
+      yield* Effect.sleep("80 millis");
+
+      expect(timerDelay).toBeLessThan(250);
+      expect(ledgerValuesCalls).toBe(0);
+      expect(snapshotCalls).toBe(0);
+      expect(childrenCalls).toBeGreaterThan(0);
+      expect(childrenCalls).toBeLessThanOrEqual(12);
+      const callsAtClose = identityCalls + childrenCalls;
+      yield* Scope.close(scope, Exit.void);
+      yield* Effect.sleep("60 millis");
+      expect(identityCalls + childrenCalls).toBe(callsAtClose);
+    }),
+  );
+
+  it.live("terminates nested owned groups bottom-up and catches a TERM fork race", () =>
+    Effect.gen(function* () {
+      let forked = false;
+      const fixture = makeController({
+        processes: [
+          server(),
+          identity(100, process.pid, 100, 100),
+          identity(110, 100, 110, 110),
+          identity(115, 110, 115, 110),
+          identity(120, 110, 120, 120),
+          identity(121, 120, 120, 120),
+        ],
+        onProcess: (processes, pid, signal) => {
+          if (signal === "SIGTERM" && pid === 121 && !forked) {
+            forked = true;
+            processes.set(122, identity(122, 110, 122, 122));
+          }
+          processes.delete(pid);
+        },
+      });
+
+      yield* terminatePosixOwnedProcessTree({
+        controller: fixture.controller,
+        grace: 0,
+        rootPid: 100,
+      });
+
+      expect(fixture.processes.has(100)).toBe(false);
+      expect(fixture.processes.has(122)).toBe(false);
+      expect(fixture.signals.indexOf("process:121:SIGTERM")).toBeLessThan(
+        fixture.signals.indexOf("process:120:SIGTERM"),
+      );
+      expect(fixture.signals.indexOf("process:115:SIGTERM")).toBeLessThan(
+        fixture.signals.indexOf("process:110:SIGTERM"),
+      );
+    }),
+  );
+
+  it.live("falls back to exact PIDs for unknown group members and a missing leader", () =>
+    Effect.gen(function* () {
+      const unrelated = identity(999, 1, 110, 110, "unrelated");
+      const fixture = makeController({
+        processes: [
+          server(),
+          identity(100, process.pid, 100, 100),
+          identity(110, 100, 110, 110),
+          identity(111, 110, 110, 110),
+          unrelated,
+        ],
+        onProcess: (processes, pid) => {
+          processes.delete(pid);
+          if (pid === 111) processes.delete(110);
+        },
+      });
+
+      yield* terminatePosixOwnedProcessTree({
+        controller: fixture.controller,
+        grace: 0,
+        rootPid: 100,
+      });
+
+      expect(fixture.signals).toContain("process:111:SIGTERM");
+      expect(fixture.processes.get(999)).toEqual(unrelated);
+    }),
+  );
+
+  it.live("re-admits a still-owned child after PID reuse and never signals the T3 session", () =>
+    Effect.gen(function* () {
+      const reused = identity(110, 100, 110, 110, "reused");
+      const fixture = makeController({
+        processes: [
+          server(),
+          identity(100, process.pid, 100, 100),
+          identity(110, 100, 110, 110, "owned"),
+          identity(120, 100, 120, process.pid),
+        ],
+        onProcess: (processes, pid) => {
+          if (pid === 110) processes.set(110, reused);
+          else processes.delete(pid);
+        },
+      });
+
+      const result = yield* Effect.exit(
+        terminatePosixOwnedProcessTree({
+          controller: fixture.controller,
+          grace: 0,
+          rootPid: 100,
+        }),
+      );
+
+      // PID 110 morphs to a new identity under the owned root and never exits, so
+      // teardown fails closed after re-admitting and re-signalling the live child.
+      expect(Exit.isFailure(result)).toBe(true);
+      expect(fixture.processes.get(110)).toEqual(reused);
+      expect(
+        fixture.signals.filter((entry) => entry.startsWith("process:110:")).length,
+      ).toBeGreaterThan(0);
+      expect(fixture.signals.some((entry) => entry.includes(":120:"))).toBe(false);
+    }),
+  );
+
+  it.live("does not treat zombie residual entries as teardown survivors", () =>
+    Effect.gen(function* () {
+      expect(posixProcessIsZombie({ ...identity(1, 0, 1, 1), state: "Z" })).toBe(true);
+      expect(posixProcessIsZombie({ ...identity(1, 0, 1, 1), state: "S" })).toBe(false);
+      const withoutState: AcpPosixProcessIdentity = {
+        executable: "/proc/1/exe",
+        pgid: 1,
+        pid: 1,
+        ppid: 0,
+        sid: 1,
+        startTime: "1",
+      };
+      expect(posixProcessIsZombie(withoutState)).toBe(false);
+
+      const root = identity(100, process.pid, 100, 100);
+      const zombieChild = identity(110, 100, 110, 110, "110", "Z");
+      const fixture = makeController({
+        processes: [server(), root, zombieChild],
+        onProcess: (processes, pid) => {
+          // Kill leaves a zombie with the same pid/starttime until reaped.
+          const current = processes.get(pid);
+          if (current === undefined) return;
+          processes.set(pid, { ...current, state: "Z" });
+        },
+      });
+      yield* terminatePosixOwnedProcessTree({
+        controller: fixture.controller,
+        grace: 0,
+        rootPid: 100,
+      });
+      // Zombies remain visible but must not fail residual teardown.
+      expect(fixture.processes.get(100)?.state).toBe("Z");
+      expect(fixture.processes.get(110)?.state).toBe("Z");
+    }),
+  );
+
+  it("admits a live child after a free PID was previously reserved by a dead entry", () => {
+    const staleChild: AcpOwnedPosixProcess = {
+      ...identity(200, 100, 200, 200, "stale-child"),
+      parentExecutable: `/proc/100/exe`,
+      parentStartTime: "100",
+    };
+    const liveChild = identity(200, 100, 200, 200, "live-child");
+    const root = identity(100, process.pid, 100, 100);
+    const ownedRoot: AcpOwnedPosixProcess = {
+      ...root,
+      parentExecutable: `/proc/${process.pid}/exe`,
+      parentStartTime: "server",
+    };
+    const ledger = new Map<string, AcpOwnedPosixProcess>([
+      [`100:${root.startTime}`, ownedRoot],
+      [`200:${staleChild.startTime}`, staleChild],
+    ]);
+    const controller = makeController({
+      processes: [server(), root],
+    }).controller;
+
+    // First capture: PID 200 is free, so the dead reservation is dropped.
+    capturePosixOwnershipLedger({
+      controller,
+      ledger,
+      rootPid: 100,
+      table: [root],
+    });
+    expect([...ledger.values()].some((entry) => entry.pid === 200)).toBe(false);
+
+    // Second capture: a new process reuses PID 200 under the owned parent.
+    capturePosixOwnershipLedger({
+      controller: makeController({ processes: [server(), root, liveChild] }).controller,
+      ledger,
+      rootPid: 100,
+      table: [root, liveChild],
+    });
+
+    const admitted = [...ledger.values()].find((entry) => entry.pid === 200);
+    expect(admitted?.startTime).toBe("live-child");
+  });
+
+  it("admits a live child when a stale ledger entry still occupies the reused PID", () => {
+    const staleChild: AcpOwnedPosixProcess = {
+      ...identity(200, 100, 200, 200, "stale-child"),
+      parentExecutable: `/proc/100/exe`,
+      parentStartTime: "100",
+    };
+    const liveChild = identity(200, 100, 200, 200, "live-child");
+    const root = identity(100, process.pid, 100, 100);
+    const ownedRoot: AcpOwnedPosixProcess = {
+      ...root,
+      parentExecutable: `/proc/${process.pid}/exe`,
+      parentStartTime: "server",
+    };
+    const ledger = new Map<string, AcpOwnedPosixProcess>([
+      [`100:${root.startTime}`, ownedRoot],
+      [`200:${staleChild.startTime}`, staleChild],
+    ]);
+
+    capturePosixOwnershipLedger({
+      controller: makeController({ processes: [server(), root, liveChild] }).controller,
+      ledger,
+      rootPid: 100,
+      table: [root, liveChild],
+    });
+
+    expect([...ledger.values()].some((entry) => entry.startTime === "stale-child")).toBe(false);
+    const admitted = [...ledger.values()].find((entry) => entry.pid === 200);
+    expect(admitted?.startTime).toBe("live-child");
+  });
+
+  it.live("signals children forked under a still-live parent during the same pass", () =>
+    Effect.gen(function* () {
+      let forked = false;
+      const fixture = makeController({
+        processes: [
+          server(),
+          identity(100, process.pid, 100, 100),
+          identity(110, 100, 110, 110),
+          identity(111, 110, 111, 111),
+        ],
+        onProcess: (processes, pid) => {
+          // Bottom-up: signal 111 first while 110 is still live, then fork 112
+          // under 110 so the same pass must enqueue and signal 112.
+          if (pid === 111 && !forked) {
+            forked = true;
+            processes.set(112, identity(112, 110, 112, 112));
+          }
+          processes.delete(pid);
+        },
+      });
+
+      yield* terminatePosixOwnedProcessTree({
+        controller: fixture.controller,
+        grace: 0,
+        rootPid: 100,
+      });
+
+      expect(forked).toBe(true);
+      expect(fixture.processes.has(112)).toBe(false);
+      expect(fixture.signals.some((entry) => entry.startsWith("process:112:"))).toBe(true);
+    }),
+  );
+
+  it.live("detects an owned child first observed in the final survivor snapshot", () =>
+    Effect.gen(function* () {
+      const lateChild = identity(111, 110, 111, 111);
+      const fixture = makeController({
+        processes: [server(), identity(100, process.pid, 100, 100), identity(110, 100, 110, 110)],
+        onProcess: (processes, pid) => {
+          // Leave the descendant parent alive through teardown so it can fork
+          // immediately after the last signal pass.
+          if (pid !== 110) processes.delete(pid);
+        },
+      });
+      let snapshotCalls = 0;
+      const controller: AcpPosixProcessTreeController = {
+        ...fixture.controller,
+        snapshot: () => {
+          snapshotCalls += 1;
+          // Two TERM discovery passes, the root TERM pass, and two KILL passes
+          // precede the final survivor snapshot.
+          if (snapshotCalls === 6) fixture.processes.set(lateChild.pid, lateChild);
+          return fixture.controller.snapshot();
+        },
+      };
+
+      const error = yield* Effect.flip(
+        terminatePosixOwnedProcessTree({
+          controller,
+          discoveryPasses: 2,
+          grace: 0,
+          rootPid: 100,
+        }),
+      );
+
+      expect(snapshotCalls).toBe(6);
+      expect(error.detail).toContain("110, 111");
+    }),
+  );
+
+  it.live("retains the ledger across root exit and an explicit failure for finalizer retry", () =>
+    Effect.gen(function* () {
+      let ignoreSignals = true;
+      const ledger = new Map<string, AcpOwnedPosixProcess>();
+      const frontier = new Map<number, AcpOwnedPosixProcess>();
+      const childQueues = new Map<number, Array<number>>();
+      const root: AcpPosixOwnershipRoot = { value: undefined };
+      const fixture = makeController({
+        processes: [
+          server(),
+          identity(100, process.pid, 100, 100),
+          identity(110, 100, 110, 110),
+          identity(111, 110, 110, 110),
+        ],
+        onProcess: (processes, pid) => {
+          if (ignoreSignals && pid === 100) processes.delete(100);
+          if (!ignoreSignals) processes.delete(pid);
+        },
+      });
+      observePosixOwnershipLedger({
+        childQueues,
+        controller: fixture.controller,
+        frontier,
+        ledger,
+        root,
+        rootPid: 100,
+      });
+
+      const explicit = yield* Effect.exit(
+        terminatePosixOwnedProcessTree({
+          controller: fixture.controller,
+          grace: 0,
+          ledger,
+          rootPid: 100,
+        }),
+      );
+      expect(Exit.isFailure(explicit)).toBe(true);
+      expect(fixture.processes.has(100)).toBe(false);
+      expect(fixture.processes.has(111)).toBe(true);
+
+      fixture.processes.set(112, identity(112, 110, 112, 112));
+      observePosixOwnershipLedger({
+        childQueues,
+        controller: fixture.controller,
+        frontier,
+        ledger,
+        root,
+        rootPid: 100,
+      });
+      ignoreSignals = false;
+      yield* terminatePosixOwnedProcessTree({
+        controller: fixture.controller,
+        grace: 0,
+        ledger,
+        rootPid: 100,
+      });
+      expect(fixture.processes.has(110)).toBe(false);
+      expect(fixture.processes.has(111)).toBe(false);
+      expect(fixture.processes.has(112)).toBe(false);
+    }),
+  );
+
+  it("fails closed where a stable POSIX identity provider is unavailable", () => {
+    try {
+      makePosixProcessTreeController("darwin");
+      throw new Error("Expected Darwin process ownership to fail closed");
+    } catch (error) {
+      expect(error).toMatchObject({
+        detail: "Detached ACP descendant ownership is unsupported on darwin",
+      });
+    }
+  });
+});
diff --git a/apps/server/src/provider/acp/AcpSessionRuntime.ts b/apps/server/src/provider/acp/AcpSessionRuntime.ts
index 2a4cb6a2337b..c3086509b7b8 100644
--- a/apps/server/src/provider/acp/AcpSessionRuntime.ts
+++ b/apps/server/src/provider/acp/AcpSessionRuntime.ts
@@ -1,3 +1,8 @@
+// @effect-diagnostics nodeBuiltinImport:off
+import * as NodeCrypto from "node:crypto";
+import * as NodeFS from "node:fs";
+import * as NodePath from "node:path";
+
 import * as Cause from "effect/Cause";
 import * as Clock from "effect/Clock";
 import * as Context from "effect/Context";
@@ -5,11 +10,13 @@ import * as Crypto from "effect/Crypto";
 import * as Deferred from "effect/Deferred";
 import * as Duration from "effect/Duration";
 import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
 import * as Fiber from "effect/Fiber";
 import * as Layer from "effect/Layer";
 import * as Option from "effect/Option";
 import * as Queue from "effect/Queue";
 import * as Ref from "effect/Ref";
+import * as Schema from "effect/Schema";
 import * as Scope from "effect/Scope";
 import * as Semaphore from "effect/Semaphore";
 import * as Stream from "effect/Stream";
@@ -20,6 +27,7 @@ import * as EffectAcpErrors from "effect-acp/errors";
 import type * as EffectAcpSchema from "effect-acp/schema";
 import type * as EffectAcpProtocol from "effect-acp/protocol";
 import { resolveSpawnCommand } from "@t3tools/shared/shell";
+import { HostProcessPlatform } from "@t3tools/shared/hostProcess";
 
 import {
   collectSessionConfigOptionValues,
@@ -30,6 +38,7 @@ import {
   toolCallProgressLength,
   parseSessionModeState,
   parseSessionUpdateEvent,
+  sessionUpdateCountsAsLoadReplayActivity,
   sessionUpdateIsReplay,
   waitForSessionLoadReplayIdle,
   type SessionLoadGate,
@@ -71,12 +80,24 @@ export interface AcpSessionRuntimeOptions {
   readonly resumeSessionId?: string;
   readonly sessionLoadTimeout?: Duration.Input;
   readonly sessionLoadReplayIdleGap?: Duration.Input;
+  readonly interruptPromptOnCancel?: boolean;
+  /** Optional provider metadata forwarded on `session/cancel`. */
+  readonly cancelMeta?: EffectAcpSchema.CancelNotification["_meta"];
+  readonly ownDetachedProcessGroup?: boolean;
+  readonly ownDescendantProcessGroups?: boolean;
+  readonly processGroupPlatform?: NodeJS.Platform;
+  readonly processGroupTerminationGrace?: Duration.Input;
+  readonly windowsProcessTreeTerminator?: (
+    pid: number,
+  ) => Effect.Effect<void, AcpProcessGroupTerminationError>;
+  readonly posixProcessTreeController?: AcpPosixProcessTreeController;
+  readonly linuxCgroupController?: AcpLinuxCgroupController | null;
   readonly clientCapabilities?: EffectAcpSchema.InitializeRequest["clientCapabilities"];
   readonly clientInfo: {
     readonly name: string;
     readonly version: string;
   };
-  readonly authMethodId: string;
+  readonly authMethodId?: string;
   readonly mcpServers?: ReadonlyArray<EffectAcpSchema.McpServer>;
   readonly requestLogger?: (event: AcpSessionRequestLogEvent) => Effect.Effect<void, never>;
   readonly protocolLogging?: {
@@ -84,6 +105,10 @@ export interface AcpSessionRuntimeOptions {
     readonly logOutgoing?: boolean;
     readonly logger?: (event: EffectAcpProtocol.AcpProtocolLogEvent) => Effect.Effect<void, never>;
   };
+  readonly onIncomingRequest?: EffectAcpClient.AcpClientOptions["onIncomingRequest"];
+  readonly onTermination?: (error: EffectAcpErrors.AcpError) => Effect.Effect<void>;
+  readonly onOutgoingResponseFailure?: EffectAcpClient.AcpClientOptions["onOutgoingResponseFailure"];
+  readonly onOutgoingResponse?: EffectAcpClient.AcpClientOptions["onOutgoingResponse"];
 }
 
 export interface AcpSessionRequestLogEvent {
@@ -94,16 +119,964 @@ export interface AcpSessionRequestLogEvent {
   readonly cause?: Cause.Cause<EffectAcpErrors.AcpError>;
 }
 
+export class AcpProcessGroupTerminationError extends Schema.TaggedErrorClass<AcpProcessGroupTerminationError>()(
+  "AcpProcessGroupTerminationError",
+  {
+    detail: Schema.String,
+    pid: Schema.optionalKey(Schema.Int),
+    exitCode: Schema.optionalKey(Schema.Number),
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return this.detail;
+  }
+}
+
+const isAcpProcessGroupTerminationError = Schema.is(AcpProcessGroupTerminationError);
+
+export interface AcpPosixProcessIdentity {
+  readonly executable: string | undefined;
+  readonly pgid: number;
+  readonly pid: number;
+  readonly ppid: number;
+  readonly sid: number;
+  /**
+   * Linux `/proc/<pid>/stat` state when known (`R`/`S`/`D`/`Z`/…). Omitted on
+   * platforms or fixtures that do not surface it. Zombies (`Z`) are already
+   * dead and must not count as residual teardown survivors.
+   */
+  readonly state?: string;
+  readonly startTime: string;
+}
+
+export interface AcpPosixProcessTreeController {
+  readonly childPidsOf: (pid: number) => ReadonlyArray<number>;
+  readonly childrenOf: (pid: number) => ReadonlyArray<AcpPosixProcessIdentity>;
+  readonly identity: (pid: number) => AcpPosixProcessIdentity | undefined;
+  readonly snapshot: () => ReadonlyArray<AcpPosixProcessIdentity>;
+  readonly signalProcess: (pid: number, signal: NodeJS.Signals) => void;
+}
+
+export interface AcpLinuxCgroupLease {
+  readonly contains: (pid: number) => boolean;
+  readonly exists: () => boolean;
+  readonly path: string;
+  readonly relativePath: string;
+  readonly kill: () => void;
+  readonly populated: () => boolean;
+  readonly remove: () => void;
+}
+
+export interface AcpLinuxCgroupController {
+  readonly create: () => AcpLinuxCgroupLease | undefined;
+}
+
+export interface AcpPosixOwnershipRoot {
+  captureAttempted?: boolean;
+  value: AcpOwnedPosixProcess | undefined;
+}
+
+function decodeMountInfoPath(value: string): string {
+  return value.replace(/\\([0-7]{3})/g, (_match, octal: string) =>
+    String.fromCharCode(Number.parseInt(octal, 8)),
+  );
+}
+
+export function parseUnifiedCgroupPath(contents: string): string | undefined {
+  const matches = [...contents.matchAll(/^0::(\/.*)$/gm)];
+  return matches.length === 1 ? matches[0]![1] : undefined;
+}
+
+export function isSafeCgroupPath(value: string): boolean {
+  return (
+    value.startsWith("/") &&
+    !value.includes("(deleted)") &&
+    NodePath.posix.normalize(value) === value
+  );
+}
+
+export function parseCgroup2Mounts(
+  contents: string,
+): ReadonlyArray<{ readonly mountPoint: string; readonly root: string }> {
+  const mounts: Array<{ readonly mountPoint: string; readonly root: string }> = [];
+  for (const line of contents.split("\n")) {
+    const [mount, filesystem] = line.split(" - ");
+    if (mount === undefined || filesystem?.split(" ")[0] !== "cgroup2") continue;
+    const fields = mount.split(" ");
+    if (fields.length < 5) continue;
+    mounts.push({
+      mountPoint: decodeMountInfoPath(fields[4]!),
+      root: decodeMountInfoPath(fields[3]!),
+    });
+  }
+  return mounts;
+}
+
+export function parseCgroup2Mount(
+  contents: string,
+): { readonly mountPoint: string; readonly root: string } | undefined {
+  return parseCgroup2Mounts(contents)[0];
+}
+
+export function wrapCommandForLinuxCgroup(
+  lease: AcpLinuxCgroupLease,
+  command: string,
+  args: ReadonlyArray<string>,
+): { readonly command: string; readonly args: ReadonlyArray<string> } {
+  return {
+    command: process.execPath,
+    args: [
+      "-e",
+      [
+        'const fs = require("node:fs");',
+        "try {",
+        '  fs.writeFileSync(process.argv[1] + "/cgroup.procs", String(process.pid) + "\\n");',
+        '  const actual = fs.readFileSync("/proc/self/cgroup", "utf8").split("\\n").find((line) => line.startsWith("0::"))?.slice(3);',
+        "  if (actual !== process.argv[2]) process.exit(126);",
+        "  const env = { ...process.env };",
+        "  delete env.ELECTRON_RUN_AS_NODE;",
+        "  delete env.T3_ACP_CGROUP_WRAPPER;",
+        "  process.execve(process.argv[3], process.argv.slice(3), env);",
+        "} catch { process.exit(125); }",
+      ].join("\n"),
+      lease.path,
+      lease.relativePath,
+      command,
+      ...args,
+    ],
+  };
+}
+
+export function resolveLinuxCgroupTargetCommand(
+  command: string,
+  cwd: string,
+  environment: NodeJS.ProcessEnv,
+): string | undefined {
+  // Match Node spawn PATH fallback when PATH is undefined. An explicitly empty
+  // PATH stays empty (lookup only via empty-segment → cwd).
+  const pathEnv = environment.PATH === undefined ? "/usr/bin:/bin" : environment.PATH;
+  const candidates = command.includes(NodePath.sep)
+    ? [NodePath.resolve(cwd, command)]
+    : pathEnv
+        .split(NodePath.delimiter)
+        .map((entry) =>
+          NodePath.join(
+            entry.length === 0
+              ? cwd
+              : NodePath.isAbsolute(entry)
+                ? entry
+                : NodePath.resolve(cwd, entry),
+            command,
+          ),
+        );
+  for (const candidate of candidates) {
+    try {
+      if (!NodeFS.statSync(candidate).isFile()) continue;
+      NodeFS.accessSync(candidate, NodeFS.constants.X_OK);
+      return candidate;
+    } catch {
+      // Try the next PATH entry.
+    }
+  }
+  return undefined;
+}
+
+const STALE_ACP_CGROUP_SIBLING = /^t3-acp-(\d+)-/;
+
+export interface SweepStaleLinuxCgroupSiblingsOptions {
+  readonly currentPid?: number;
+  readonly isProcessAlive?: (pid: number) => boolean;
+  readonly readPopulated?: (siblingPath: string) => "0" | "1" | undefined;
+  readonly remove?: (siblingPath: string) => void;
+}
+
+function defaultCgroupOwnerIsAlive(pid: number): boolean {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (cause) {
+    return (cause as NodeJS.ErrnoException | undefined)?.code !== "ESRCH";
+  }
+}
+
+function defaultReadCgroupPopulated(siblingPath: string): "0" | "1" | undefined {
+  const state = /(?:^|\n)populated ([01])(?:\n|$)/.exec(
+    NodeFS.readFileSync(NodePath.join(siblingPath, "cgroup.events"), "utf8"),
+  )?.[1];
+  return state === "0" || state === "1" ? state : undefined;
+}
+
+/** Best-effort removal of empty `t3-acp-<dead-pid>-*` sibling leases under a parent cgroup. */
+export function sweepStaleLinuxCgroupSiblings(
+  parentPath: string,
+  options: SweepStaleLinuxCgroupSiblingsOptions = {},
+): void {
+  const currentPid = options.currentPid ?? process.pid;
+  const isProcessAlive = options.isProcessAlive ?? defaultCgroupOwnerIsAlive;
+  const readPopulated = options.readPopulated ?? defaultReadCgroupPopulated;
+  const remove = options.remove ?? ((siblingPath: string) => NodeFS.rmdirSync(siblingPath));
+  try {
+    for (const entry of NodeFS.readdirSync(parentPath, { withFileTypes: true })) {
+      try {
+        if (!entry.isDirectory()) continue;
+        const match = STALE_ACP_CGROUP_SIBLING.exec(entry.name);
+        if (match === null) continue;
+        const ownerPid = Number(match[1]);
+        if (!Number.isSafeInteger(ownerPid) || ownerPid <= 1 || ownerPid === currentPid) continue;
+        if (isProcessAlive(ownerPid)) continue;
+        const siblingPath = NodePath.join(parentPath, entry.name);
+        if (NodePath.dirname(siblingPath) !== parentPath) continue;
+        if (readPopulated(siblingPath) !== "0") continue;
+        remove(siblingPath);
+      } catch {
+        // Ignore unreadable or busy siblings; never fail lease creation.
+      }
+    }
+  } catch {
+    // Ignore readdir failures on the parent path.
+  }
+}
+
+function tryCreateLinuxCgroupLease(
+  currentRelative: string,
+  mount: { readonly mountPoint: string; readonly root: string },
+): AcpLinuxCgroupLease | undefined {
+  if (
+    !isSafeCgroupPath(mount.root) ||
+    !isSafeCgroupPath(mount.mountPoint) ||
+    !(
+      mount.root === "/" ||
+      currentRelative === mount.root ||
+      currentRelative.startsWith(`${mount.root}/`)
+    )
+  ) {
+    return undefined;
+  }
+  const mountRelative =
+    mount.root === "/" ? currentRelative : currentRelative.slice(mount.root.length);
+  const currentPath = NodePath.resolve(mount.mountPoint, `.${mountRelative}`);
+  const resolvedMount = NodePath.resolve(mount.mountPoint);
+  if (currentPath !== resolvedMount && !currentPath.startsWith(`${resolvedMount}${NodePath.sep}`)) {
+    return undefined;
+  }
+  sweepStaleLinuxCgroupSiblings(currentPath);
+  const childName = `t3-acp-${process.pid}-${NodeCrypto.randomUUID().replaceAll("-", "")}`;
+  const childPath = NodePath.join(currentPath, childName);
+  const childRelative = NodePath.posix.join(currentRelative, childName);
+  if (NodePath.dirname(childPath) !== currentPath) return undefined;
+  try {
+    NodeFS.mkdirSync(childPath, { mode: 0o700 });
+    NodeFS.accessSync(NodePath.join(childPath, "cgroup.procs"), NodeFS.constants.W_OK);
+    NodeFS.accessSync(NodePath.join(childPath, "cgroup.kill"), NodeFS.constants.W_OK);
+    NodeFS.accessSync(NodePath.join(childPath, "cgroup.events"), NodeFS.constants.R_OK);
+    if (NodeFS.readFileSync(NodePath.join(childPath, "cgroup.type"), "utf8").trim() !== "domain") {
+      throw new Error("ACP cgroup is not a domain cgroup");
+    }
+    if (typeof process.execve !== "function") throw new Error("process.execve is unavailable");
+  } catch {
+    try {
+      NodeFS.rmdirSync(childPath);
+    } catch {
+      // The unavailable cgroup was never used for a child process.
+    }
+    return undefined;
+  }
+  return {
+    contains: (pid) =>
+      parseUnifiedCgroupPath(NodeFS.readFileSync(`/proc/${pid}/cgroup`, "utf8")) === childRelative,
+    exists: () => NodeFS.existsSync(childPath),
+    path: childPath,
+    relativePath: childRelative,
+    kill: () => NodeFS.writeFileSync(NodePath.join(childPath, "cgroup.kill"), "1\n"),
+    populated: () => {
+      const state = /(?:^|\n)populated ([01])(?:\n|$)/.exec(
+        NodeFS.readFileSync(NodePath.join(childPath, "cgroup.events"), "utf8"),
+      )?.[1];
+      if (state === undefined) throw new Error("ACP cgroup.events has no populated state");
+      return state === "1";
+    },
+    remove: () => {
+      const directories = (path: string): ReadonlyArray<string> =>
+        NodeFS.readdirSync(path, { withFileTypes: true }).flatMap((entry) =>
+          entry.isDirectory()
+            ? [...directories(NodePath.join(path, entry.name)), NodePath.join(path, entry.name)]
+            : [],
+        );
+      for (const directory of directories(childPath)) NodeFS.rmdirSync(directory);
+      NodeFS.rmdirSync(childPath);
+    },
+  };
+}
+
+export function makeLinuxCgroupController(): AcpLinuxCgroupController {
+  return {
+    create: () => {
+      let currentRelative: string | undefined;
+      let mounts: ReadonlyArray<{ readonly mountPoint: string; readonly root: string }> = [];
+      try {
+        currentRelative = parseUnifiedCgroupPath(NodeFS.readFileSync("/proc/self/cgroup", "utf8"));
+        mounts = parseCgroup2Mounts(NodeFS.readFileSync("/proc/self/mountinfo", "utf8"));
+      } catch {
+        return undefined;
+      }
+      if (
+        currentRelative === undefined ||
+        !currentRelative.startsWith("/") ||
+        mounts.length === 0
+      ) {
+        return undefined;
+      }
+      if (!isSafeCgroupPath(currentRelative)) return undefined;
+      // Prefer the first mount that successfully creates a writable child cgroup.
+      // Multi-mount hosts often list a read-only view before the delegated one.
+      for (const mount of mounts) {
+        const lease = tryCreateLinuxCgroupLease(currentRelative, mount);
+        if (lease !== undefined) return lease;
+      }
+      return undefined;
+    },
+  };
+}
+
+// OS-state polls (cgroup emptiness, process trees) must use wall time. Under
+// TestClock, Effect.sleep never resolves unless the test advances the clock.
+const wallClock = Clock.Clock.defaultValue();
+const withWallClock = <A, E, R>(effect: Effect.Effect<A, E, R>): Effect.Effect<A, E, R> =>
+  Effect.provideService(effect, Clock.Clock, wallClock);
+
+export function terminateLinuxCgroupLease(
+  lease: AcpLinuxCgroupLease,
+): Effect.Effect<void, AcpProcessGroupTerminationError> {
+  const failure = (name: string, cause: unknown) =>
+    new AcpProcessGroupTerminationError({
+      cause,
+      detail: `Failed to ${name} ACP cgroup ${lease.path}`,
+    });
+  return Effect.gen(function* () {
+    let lastRemovalFailure: { readonly cause: unknown } | null = null;
+    for (let attempt = 0; attempt < 200; attempt += 1) {
+      if (!lease.exists()) return;
+      try {
+        lease.kill();
+      } catch (cause) {
+        const code = (cause as NodeJS.ErrnoException | undefined)?.code;
+        if (code !== "ENOENT") return yield* failure("kill", cause);
+        if (!lease.exists()) return;
+        yield* Effect.sleep("10 millis");
+        continue;
+      }
+      let populated: boolean;
+      try {
+        populated = lease.populated();
+      } catch (cause) {
+        const code = (cause as NodeJS.ErrnoException | undefined)?.code;
+        if (code === "ENOENT" && !lease.exists()) return;
+        if (code === "ENOENT") {
+          yield* Effect.sleep("10 millis");
+          continue;
+        }
+        return yield* failure("read state for", cause);
+      }
+      if (populated) {
+        lastRemovalFailure = null;
+        yield* Effect.sleep("10 millis");
+        continue;
+      }
+      try {
+        lease.remove();
+        lastRemovalFailure = null;
+      } catch (cause) {
+        const code = (cause as NodeJS.ErrnoException | undefined)?.code;
+        if (code === "ENOENT" && !lease.exists()) return;
+        if (code !== "EBUSY" && code !== "ENOTEMPTY" && code !== "ENOENT") {
+          return yield* failure("remove", cause);
+        }
+        lastRemovalFailure = { cause };
+      }
+      if (!lease.exists()) return;
+      yield* Effect.sleep("10 millis");
+    }
+    if (lastRemovalFailure !== null) {
+      return yield* failure("remove", lastRemovalFailure.cause);
+    }
+    return yield* new AcpProcessGroupTerminationError({
+      detail: `ACP cgroup ${lease.path} remained present after cgroup cleanup`,
+    });
+  }).pipe(withWallClock);
+}
+
+export function signalLinuxCgroupRootTerm(input: {
+  readonly controller: AcpPosixProcessTreeController;
+  readonly lease: AcpLinuxCgroupLease;
+  readonly root: AcpPosixOwnershipRoot;
+}): void {
+  const root = input.root.value;
+  if (root === undefined) return;
+  try {
+    const observed = input.controller.identity(root.pid);
+    if (!samePosixProcessIdentity(root, observed) || !input.lease.contains(root.pid)) return;
+    input.controller.signalProcess(root.pid, "SIGTERM");
+  } catch {
+    // TERM is optional. cgroup.kill remains the authoritative teardown.
+  }
+}
+
+function readLinuxProcessIdentity(pid: number): AcpPosixProcessIdentity | undefined {
+  try {
+    const stat = NodeFS.readFileSync(`/proc/${pid}/stat`, "utf8");
+    const commandEnd = stat.lastIndexOf(")");
+    if (commandEnd < 0) return undefined;
+    const fields = stat
+      .slice(commandEnd + 2)
+      .trim()
+      .split(/\s+/);
+    // After comm: state, ppid, pgrp, session, … starttime (field 22 / index 19).
+    const state = fields[0];
+    const ppid = Number(fields[1]);
+    const pgid = Number(fields[2]);
+    const sid = Number(fields[3]);
+    const startTime = fields[19];
+    if (
+      state === undefined ||
+      !Number.isSafeInteger(ppid) ||
+      !Number.isSafeInteger(pgid) ||
+      !Number.isSafeInteger(sid) ||
+      startTime === undefined
+    ) {
+      return undefined;
+    }
+    let executable: string | undefined;
+    try {
+      executable = NodeFS.readlinkSync(`/proc/${pid}/exe`);
+    } catch {
+      executable = undefined;
+    }
+    return { executable, pgid, pid, ppid, sid, startTime, state };
+  } catch {
+    return undefined;
+  }
+}
+
+/** Linux zombies keep pid/starttime until reaped; they are not live survivors. */
+export function posixProcessIsZombie(process: AcpPosixProcessIdentity): boolean {
+  return process.state === "Z";
+}
+
+function readLinuxChildPids(pid: number): ReadonlyArray<number> {
+  const childPids = new Set<number>();
+  let taskIds: ReadonlyArray<string> = [];
+  try {
+    taskIds = NodeFS.readdirSync(`/proc/${pid}/task`).filter((entry) =>
+      /^[1-9][0-9]*$/.test(entry),
+    );
+  } catch {
+    return [];
+  }
+  for (const taskId of taskIds) {
+    try {
+      for (const childPid of NodeFS.readFileSync(`/proc/${pid}/task/${taskId}/children`, "utf8")
+        .trim()
+        .split(/\s+/)
+        .filter(Boolean)
+        .map(Number)) {
+        childPids.add(childPid);
+      }
+    } catch {
+      // The task exited while its children were being read.
+    }
+  }
+  return [...childPids];
+}
+
+function makeLinuxProcessTreeController(): AcpPosixProcessTreeController {
+  return {
+    childPidsOf: readLinuxChildPids,
+    childrenOf: (pid) =>
+      readLinuxChildPids(pid).flatMap((childPid) => {
+        const identity = readLinuxProcessIdentity(childPid);
+        return identity === undefined ? [] : [identity];
+      }),
+    identity: readLinuxProcessIdentity,
+    snapshot: () =>
+      NodeFS.readdirSync("/proc", { withFileTypes: true }).flatMap((entry) => {
+        if (!entry.isDirectory() || !/^[1-9][0-9]*$/.test(entry.name)) return [];
+        const identity = readLinuxProcessIdentity(Number(entry.name));
+        return identity === undefined ? [] : [identity];
+      }),
+    signalProcess: (pid, signal) => process.kill(pid, signal),
+  };
+}
+
+export function observePosixOwnershipLedger(input: {
+  readonly childQueues: Map<number, Array<number>>;
+  readonly controller: AcpPosixProcessTreeController;
+  readonly frontier: Map<number, AcpOwnedPosixProcess>;
+  readonly ledger: Map<string, AcpOwnedPosixProcess>;
+  readonly maxProcesses?: number;
+  readonly root: AcpPosixOwnershipRoot;
+  readonly rootPid: number;
+}): void {
+  let rootIdentity: AcpPosixProcessIdentity | undefined = input.root.value;
+  if (rootIdentity === undefined) {
+    if (input.root.captureAttempted === true) {
+      throw new AcpProcessGroupTerminationError({
+        detail: `ACP process ${input.rootPid} exited before its ownership ledger was captured`,
+      });
+    }
+    input.root.captureAttempted = true;
+    rootIdentity = input.controller.identity(input.rootPid);
+    if (rootIdentity === undefined) {
+      throw new AcpProcessGroupTerminationError({
+        detail: `ACP process ${input.rootPid} exited before its ownership ledger was captured`,
+      });
+    }
+    const parent = input.controller.identity(rootIdentity.ppid);
+    const ownedRoot = {
+      ...rootIdentity,
+      parentExecutable: parent?.executable,
+      parentStartTime: parent?.startTime ?? "",
+    };
+    input.ledger.set(processIdentityKey(rootIdentity), ownedRoot);
+    input.frontier.set(rootIdentity.pid, ownedRoot);
+    input.root.value = ownedRoot;
+  }
+  const maxProcesses = Math.max(1, input.maxProcesses ?? Number.POSITIVE_INFINITY);
+  let remainingBudget = maxProcesses;
+  const pending = [...input.frontier.entries()];
+  const visited = new Set<number>();
+  while (pending.length > 0 && remainingBudget > 0) {
+    const entry = pending.shift();
+    if (entry === undefined) continue;
+    const [parentPid, parent] = entry;
+    input.frontier.delete(parentPid);
+    if (visited.has(parent.pid)) continue;
+    visited.add(parent.pid);
+    remainingBudget -= 1;
+    const observedParent = input.controller.identity(parent.pid);
+    if (!samePosixProcessIdentity(parent, observedParent)) {
+      input.childQueues.delete(parent.pid);
+      continue;
+    }
+    const refreshedParent = { ...parent, ...observedParent };
+    input.ledger.set(processIdentityKey(refreshedParent), refreshedParent);
+    input.frontier.set(refreshedParent.pid, refreshedParent);
+    let queuedChildren = input.childQueues.get(refreshedParent.pid);
+    if (queuedChildren === undefined) {
+      if (remainingBudget === 0) continue;
+      remainingBudget -= 1;
+      queuedChildren = [...input.controller.childPidsOf(refreshedParent.pid)];
+    }
+    while (queuedChildren.length > 0 && remainingBudget > 0) {
+      const childPid = queuedChildren.shift();
+      if (childPid === undefined) continue;
+      remainingBudget -= 1;
+      const child = input.controller.identity(childPid);
+      if (child === undefined) continue;
+      if (child.ppid !== parent.pid) continue;
+      let reservedPid = input.frontier.get(child.pid);
+      if (reservedPid !== undefined && !samePosixProcessIdentity(reservedPid, child)) {
+        // PID reused under an owned parent; drop the stale reservation.
+        input.frontier.delete(child.pid);
+        for (const [key, owned] of input.ledger.entries()) {
+          if (owned.pid === child.pid) input.ledger.delete(key);
+        }
+        reservedPid = undefined;
+      }
+      const childKey = processIdentityKey(child);
+      const owned =
+        reservedPid === undefined
+          ? {
+              ...child,
+              parentExecutable: refreshedParent.executable,
+              parentStartTime: refreshedParent.startTime,
+            }
+          : { ...reservedPid, ...child };
+      input.ledger.set(childKey, owned);
+      input.frontier.set(child.pid, owned);
+    }
+    if (queuedChildren.length === 0) input.childQueues.delete(refreshedParent.pid);
+    else input.childQueues.set(refreshedParent.pid, queuedChildren);
+  }
+}
+
+export function observePosixOwnershipLedgerContinuously(input: {
+  readonly childQueues: Map<number, Array<number>>;
+  readonly controller: AcpPosixProcessTreeController;
+  readonly frontier: Map<number, AcpOwnedPosixProcess>;
+  readonly ledger: Map<string, AcpOwnedPosixProcess>;
+  readonly root: AcpPosixOwnershipRoot;
+  readonly rootPid: number;
+}): Effect.Effect<never> {
+  return Effect.forever(
+    Effect.gen(function* () {
+      const startedAt = yield* Clock.currentTimeMillis;
+      yield* Effect.sync(() => observePosixOwnershipLedger({ ...input, maxProcesses: 64 })).pipe(
+        Effect.exit,
+      );
+      const targetInterval = input.frontier.size <= 32 ? 25 : input.frontier.size <= 128 ? 50 : 100;
+      const completedAt = yield* Clock.currentTimeMillis;
+      yield* Effect.sleep(`${Math.max(5, targetInterval - (completedAt - startedAt))} millis`);
+    }),
+  ).pipe(withWallClock);
+}
+
+export function makePosixProcessTreeController(
+  platform: NodeJS.Platform,
+): AcpPosixProcessTreeController {
+  if (platform === "linux") return makeLinuxProcessTreeController();
+  throw new AcpProcessGroupTerminationError({
+    detail: `Detached ACP descendant ownership is unsupported on ${platform}`,
+  });
+}
+
+function samePosixProcessIdentity(
+  expected: AcpPosixProcessIdentity,
+  observed: AcpPosixProcessIdentity | undefined,
+): boolean {
+  return (
+    observed !== undefined &&
+    observed.pid === expected.pid &&
+    observed.startTime === expected.startTime
+  );
+}
+
+export interface AcpOwnedPosixProcess extends AcpPosixProcessIdentity {
+  readonly parentExecutable: string | undefined;
+  readonly parentStartTime: string;
+}
+
+function processIdentityKey(process: AcpPosixProcessIdentity): string {
+  return `${process.pid}:${process.startTime}`;
+}
+
+function processDepth(
+  process: AcpPosixProcessIdentity,
+  ledgerByPid: ReadonlyMap<number, AcpOwnedPosixProcess>,
+): number {
+  let depth = 0;
+  let current = process;
+  const seen = new Set<number>();
+  while (!seen.has(current.pid)) {
+    seen.add(current.pid);
+    const parent = ledgerByPid.get(current.ppid);
+    if (parent === undefined) break;
+    depth += 1;
+    current = parent;
+  }
+  return depth;
+}
+
+export function capturePosixOwnershipLedger(input: {
+  readonly controller: AcpPosixProcessTreeController;
+  readonly ledger: Map<string, AcpOwnedPosixProcess>;
+  readonly root?: AcpPosixOwnershipRoot;
+  readonly rootPid: number;
+  readonly table?: ReadonlyArray<AcpPosixProcessIdentity>;
+}): ReadonlyArray<AcpPosixProcessIdentity> {
+  let table: ReadonlyArray<AcpPosixProcessIdentity>;
+  if (input.table === undefined) {
+    try {
+      table = input.controller.snapshot();
+    } catch (cause) {
+      throw new AcpProcessGroupTerminationError({
+        cause,
+        detail: `Failed to snapshot ACP process tree ${input.rootPid}`,
+      });
+    }
+  } else {
+    table = input.table;
+  }
+  const byPid = new Map(table.map((process) => [process.pid, process]));
+  let rootIdentity: AcpPosixProcessIdentity | undefined =
+    input.root?.value ??
+    [...input.ledger.values()].find((process) => process.pid === input.rootPid);
+  if (rootIdentity === undefined) {
+    rootIdentity = byPid.get(input.rootPid);
+    if (rootIdentity === undefined) {
+      throw new AcpProcessGroupTerminationError({
+        detail: `ACP process ${input.rootPid} exited before its ownership ledger was captured`,
+      });
+    }
+    const ownedRoot = {
+      ...rootIdentity,
+      parentExecutable: byPid.get(rootIdentity.ppid)?.executable,
+      parentStartTime: byPid.get(rootIdentity.ppid)?.startTime ?? "",
+    };
+    input.ledger.set(processIdentityKey(rootIdentity), ownedRoot);
+    if (input.root !== undefined) input.root.value = ownedRoot;
+  }
+  // Drop non-root ledger entries whose PID is free or whose identity no longer
+  // matches the live process at that PID. Either case can block admission of a
+  // legitimate child after PID reuse. Keep the root reservation even if the
+  // root briefly disappears mid-teardown (finalizer retry still needs it).
+  for (const [key, owned] of input.ledger.entries()) {
+    if (owned.pid === input.rootPid) continue;
+    const live = byPid.get(owned.pid);
+    if (live === undefined || !samePosixProcessIdentity(owned, live)) {
+      input.ledger.delete(key);
+    }
+  }
+  const children = new Map<number, Array<AcpPosixProcessIdentity>>();
+  const retainedByPid = new Map(
+    [...input.ledger.values()]
+      .filter((owned) => samePosixProcessIdentity(owned, byPid.get(owned.pid)))
+      .map((owned) => [owned.pid, owned]),
+  );
+  for (const process of table) {
+    const siblings = children.get(process.ppid) ?? [];
+    siblings.push(process);
+    children.set(process.ppid, siblings);
+  }
+  const pending = [...input.ledger.values()].filter((owned) =>
+    samePosixProcessIdentity(owned, byPid.get(owned.pid)),
+  );
+  const visited = new Set<number>();
+  while (pending.length > 0) {
+    const parent = pending.shift();
+    if (parent === undefined || visited.has(parent.pid)) continue;
+    visited.add(parent.pid);
+    const observedParent = byPid.get(parent.pid);
+    if (!samePosixProcessIdentity(parent, observedParent)) continue;
+    const refreshedParent = { ...parent, ...observedParent };
+    input.ledger.set(processIdentityKey(parent), refreshedParent);
+    for (const process of children.get(refreshedParent.pid) ?? []) {
+      const reservedPid = retainedByPid.get(process.pid);
+      if (reservedPid !== undefined && !samePosixProcessIdentity(reservedPid, process)) continue;
+      const owned =
+        reservedPid === undefined
+          ? {
+              ...process,
+              parentExecutable: refreshedParent.executable,
+              parentStartTime: refreshedParent.startTime,
+            }
+          : { ...reservedPid, ...process };
+      input.ledger.set(processIdentityKey(process), owned);
+      retainedByPid.set(process.pid, owned);
+      pending.push(owned);
+    }
+  }
+  return table;
+}
+
+export function terminatePosixOwnedProcessTree(input: {
+  readonly controller: AcpPosixProcessTreeController;
+  readonly discoveryPasses?: number;
+  readonly grace?: Duration.Input;
+  readonly ledger?: Map<string, AcpOwnedPosixProcess>;
+  readonly root?: AcpPosixOwnershipRoot;
+  readonly rootPid: number;
+}): Effect.Effect<void, AcpProcessGroupTerminationError> {
+  // This portable fallback can only admit processes whose exact parent chain is
+  // visible before it breaks. A descendant that double-forks before discovery
+  // requires pre-exec cgroup containment for a hard ownership guarantee.
+  const ledger = input.ledger ?? new Map<string, AcpOwnedPosixProcess>();
+
+  const fail = (detail: string, cause?: unknown) =>
+    new AcpProcessGroupTerminationError({ detail, ...(cause === undefined ? {} : { cause }) });
+  const snapshot = () => {
+    try {
+      return input.controller.snapshot();
+    } catch (cause) {
+      throw fail(`Failed to snapshot ACP process tree ${input.rootPid}`, cause);
+    }
+  };
+  const discover = (table: ReadonlyArray<AcpPosixProcessIdentity>) =>
+    capturePosixOwnershipLedger({
+      controller: input.controller,
+      ledger,
+      ...(input.root === undefined ? {} : { root: input.root }),
+      rootPid: input.rootPid,
+      table,
+    });
+  const signalPhase = (signal: NodeJS.Signals, includeRoot: boolean) => {
+    const table = snapshot();
+    discover(table);
+    const byPid = new Map(table.map((entry) => [entry.pid, entry]));
+    const current = input.controller.identity(process.pid);
+    if (current === undefined) throw fail("Cannot identify the current T3 process group");
+    const ledgerByPid = new Map(
+      [...ledger.values()].map((process) => [process.pid, process] as const),
+    );
+    const pending = [...ledger.values()].filter(
+      (candidate) =>
+        (includeRoot || candidate.pid !== input.rootPid) &&
+        samePosixProcessIdentity(candidate, byPid.get(candidate.pid)),
+    );
+    const retainedByPid = new Map(
+      [...ledger.values()]
+        .filter((owned) => samePosixProcessIdentity(owned, byPid.get(owned.pid)))
+        .map((owned) => [owned.pid, owned]),
+    );
+    const signalled = new Set<number>();
+    while (pending.length > 0) {
+      pending.sort(
+        (left, right) => processDepth(right, ledgerByPid) - processDepth(left, ledgerByPid),
+      );
+      const candidate = pending.shift();
+      if (candidate === undefined || signalled.has(candidate.pid)) continue;
+      const observed = input.controller.identity(candidate.pid);
+      if (
+        candidate.pid <= 1 ||
+        candidate.pid === process.pid ||
+        observed === undefined ||
+        observed.pgid === current.pgid ||
+        observed.sid === current.sid ||
+        !samePosixProcessIdentity(candidate, observed)
+      ) {
+        continue;
+      }
+      for (const child of input.controller.childrenOf(candidate.pid)) {
+        if (child.ppid !== candidate.pid) continue;
+        const reservedPid = retainedByPid.get(child.pid);
+        if (reservedPid !== undefined && !samePosixProcessIdentity(reservedPid, child)) continue;
+        const owned =
+          reservedPid === undefined
+            ? {
+                ...child,
+                parentExecutable: observed.executable,
+                parentStartTime: observed.startTime,
+              }
+            : { ...reservedPid, ...child };
+        ledger.set(processIdentityKey(child), owned);
+        ledgerByPid.set(child.pid, owned);
+        retainedByPid.set(child.pid, owned);
+        // Signal newly discovered children in this same pass (fork-during-kill).
+        if (
+          (includeRoot || child.pid !== input.rootPid) &&
+          !signalled.has(child.pid) &&
+          samePosixProcessIdentity(owned, input.controller.identity(child.pid))
+        ) {
+          pending.push(owned);
+        }
+      }
+      try {
+        // Linux starttime prevents PID reuse across observations, but Node does
+        // not expose pidfd_send_signal. A final read-to-kill race remains.
+        input.controller.signalProcess(candidate.pid, signal);
+        signalled.add(candidate.pid);
+      } catch (cause) {
+        if (samePosixProcessIdentity(candidate, input.controller.identity(candidate.pid))) {
+          throw fail(`Failed to signal ACP process ${candidate.pid}`, cause);
+        }
+      }
+    }
+  };
+
+  return Effect.gen(function* () {
+    const passes = Math.max(2, Math.min(input.discoveryPasses ?? 4, 8));
+    for (let pass = 0; pass < passes; pass += 1) {
+      yield* Effect.try({
+        try: () => signalPhase("SIGTERM", false),
+        catch: (cause) => cause as AcpProcessGroupTerminationError,
+      });
+      yield* Effect.sleep("10 millis");
+    }
+    yield* Effect.try({
+      try: () => signalPhase("SIGTERM", true),
+      catch: (cause) => cause as AcpProcessGroupTerminationError,
+    });
+    const grace = input.grace ?? "1 second";
+    if (grace !== 0) yield* Effect.sleep(grace);
+    for (let pass = 0; pass < passes; pass += 1) {
+      yield* Effect.try({
+        try: () => signalPhase("SIGKILL", true),
+        catch: (cause) => cause as AcpProcessGroupTerminationError,
+      });
+      yield* Effect.sleep("10 millis");
+    }
+    const finalTable = snapshot();
+    discover(finalTable);
+    const survivors = new Map(finalTable.map((entry) => [entry.pid, entry]));
+    const residual = [...ledger.values()].filter((owned) => {
+      const observed = survivors.get(owned.pid);
+      if (!samePosixProcessIdentity(owned, observed) || observed === undefined) {
+        return false;
+      }
+      // Already-killed zombies still appear in /proc until reaped; not live.
+      return !posixProcessIsZombie(observed);
+    });
+    if (residual.length > 0) {
+      return yield* fail(
+        `ACP process tree ${input.rootPid} retained owned processes: ${residual.map((entry) => entry.pid).join(", ")}`,
+      );
+    }
+  }).pipe(withWallClock);
+}
+
+export function windowsTaskkillResultIsSuccess(exitCode: number, _output?: string): boolean {
+  return exitCode === 0;
+}
+
+export const terminateWindowsProcessTreeWithTaskkill = (
+  spawner: ChildProcessSpawner.ChildProcessSpawner["Service"],
+  pid: number,
+): Effect.Effect<void, AcpProcessGroupTerminationError> =>
+  Effect.scoped(
+    Effect.gen(function* () {
+      const taskkill = yield* spawner.spawn(
+        ChildProcess.make("taskkill", ["/PID", String(pid), "/T", "/F"]),
+      );
+      const outputFiber = yield* Stream.decodeText(taskkill.all).pipe(
+        Stream.mkString,
+        Effect.forkScoped,
+      );
+      const exitCode = Number(yield* taskkill.exitCode);
+      const output = yield* Fiber.join(outputFiber);
+      // A missing leader cannot prove that inherited descendants exited.
+      if (windowsTaskkillResultIsSuccess(exitCode, output)) return;
+      const trimmedOutput = output.trim();
+      return yield* new AcpProcessGroupTerminationError({
+        detail: `taskkill exited ${exitCode} for ACP process tree ${pid}`,
+        pid,
+        exitCode,
+        ...(trimmedOutput.length === 0
+          ? {}
+          : { cause: trimmedOutput.length > 500 ? trimmedOutput.slice(0, 500) : trimmedOutput }),
+      });
+    }),
+  ).pipe(
+    Effect.mapError((cause) =>
+      isAcpProcessGroupTerminationError(cause)
+        ? cause
+        : new AcpProcessGroupTerminationError({
+            cause,
+            detail: `Failed to run taskkill for ACP process tree ${pid}`,
+            pid,
+          }),
+    ),
+  );
+
+export function selectAcpAgentAuthMethod(
+  authMethods: ReadonlyArray<EffectAcpSchema.AuthMethod> | undefined,
+  preferredMethodId?: string,
+): EffectAcpSchema.AuthMethod | undefined {
+  const preferred = preferredMethodId?.trim();
+  if (preferred) {
+    return authMethods?.find((method) => method.id === preferred);
+  }
+  return authMethods?.find((method) => !("type" in method));
+}
+
+function isAcpAuthenticationRequired(error: EffectAcpErrors.AcpError): boolean {
+  return error._tag === "AcpRequestError" && error.code === -32000;
+}
+
 export interface AcpSessionRuntimeStartResult {
   readonly sessionId: string;
   readonly initializeResult: EffectAcpSchema.InitializeResponse;
   readonly sessionSetupResult:
+    | EffectAcpSchema.ForkSessionResponse
     | EffectAcpSchema.LoadSessionResponse
     | EffectAcpSchema.NewSessionResponse
     | EffectAcpSchema.ResumeSessionResponse;
   readonly modelConfigId: string | undefined;
 }
 
+export interface AcpSessionActivationOptions {
+  readonly mcpServers?: ReadonlyArray<EffectAcpSchema.McpServer>;
+}
+
 export class AcpSessionRuntime extends Context.Service<
   AcpSessionRuntime,
   {
@@ -195,6 +1168,24 @@ export class AcpSessionRuntime extends Context.Service<
     readonly getModeState: Effect.Effect<AcpSessionModeState | undefined>;
     /** Latest configuration options observed from session setup and configuration writes. */
     readonly getConfigOptions: Effect.Effect<ReadonlyArray<EffectAcpSchema.SessionConfigOption>>;
+    readonly loadSession: (
+      sessionId: string,
+      options?: AcpSessionActivationOptions,
+    ) => Effect.Effect<AcpSessionRuntimeStartResult, EffectAcpErrors.AcpError>;
+    readonly resumeSession: (
+      sessionId: string,
+      options?: AcpSessionActivationOptions,
+    ) => Effect.Effect<AcpSessionRuntimeStartResult, EffectAcpErrors.AcpError>;
+    readonly forkSession: (
+      sessionId: string,
+      options?: AcpSessionActivationOptions,
+    ) => Effect.Effect<AcpSessionRuntimeStartResult, EffectAcpErrors.AcpError>;
+    readonly listSessions: (
+      cursor?: string,
+    ) => Effect.Effect<EffectAcpSchema.ListSessionsResponse, EffectAcpErrors.AcpError>;
+    readonly closeSession: (
+      sessionId?: string,
+    ) => Effect.Effect<EffectAcpSchema.CloseSessionResponse, EffectAcpErrors.AcpError>;
     /**
      * Sends a prompt turn to the active session.
      * @see https://agentclientprotocol.com/protocol/schema#session/prompt
@@ -207,6 +1198,13 @@ export class AcpSessionRuntime extends Context.Service<
      * @see https://agentclientprotocol.com/protocol/schema#session/cancel
      */
     readonly cancel: Effect.Effect<void, EffectAcpErrors.AcpError>;
+    readonly processContainment:
+      | "cgroup-v2"
+      | "process-ledger-reduced-guarantee"
+      | "process-group"
+      | "none";
+    /** Terminates the opt-in detached ACP process group and all inherited work. */
+    readonly terminateProcessGroup?: Effect.Effect<void, AcpProcessGroupTerminationError>;
     /**
      * Selects the active mode through the negotiated `mode` configuration option.
      * This is a no-op when the requested mode is already active.
@@ -253,7 +1251,17 @@ export class AcpSessionRuntime extends Context.Service<
       payload: unknown,
     ) => Effect.Effect<void, EffectAcpErrors.AcpError>;
   }
->()("t3/provider/acp/AcpSessionRuntime") {}
+>()("t3/provider/acp/AcpSessionRuntime") {
+  static layer(
+    options: AcpSessionRuntimeOptions,
+  ): Layer.Layer<
+    AcpSessionRuntime,
+    EffectAcpErrors.AcpError,
+    ChildProcessSpawner.ChildProcessSpawner | Crypto.Crypto
+  > {
+    return Layer.effect(AcpSessionRuntime, make(options));
+  }
+}
 
 interface AcpStartedState extends AcpSessionRuntimeStartResult {}
 
@@ -302,6 +1310,7 @@ export const make = (
     const configOptionsRef = yield* Ref.make(sessionConfigOptionsFromSetup(undefined));
     const startStateRef = yield* Ref.make<AcpStartState>({ _tag: "NotStarted" });
     const promptSerializationSemaphore = yield* Semaphore.make(1);
+    const sessionLoadSemaphore = yield* Semaphore.make(1);
     const activePromptFiberRef = yield* Ref.make<
       Option.Option<Fiber.Fiber<EffectAcpSchema.PromptResponse, EffectAcpErrors.AcpError>>
     >(Option.none());
@@ -343,12 +1352,70 @@ export const make = (
       options.spawn.args,
       options.spawn.env ? { env: options.spawn.env, extendEnv: true } : {},
     );
+    const linuxCgroupLease =
+      options.ownDescendantProcessGroups === true && options.processGroupPlatform === "linux"
+        ? yield* Effect.sync(() => {
+            try {
+              if (options.linuxCgroupController === null) return undefined;
+              return (options.linuxCgroupController ?? makeLinuxCgroupController()).create();
+            } catch {
+              return undefined;
+            }
+          })
+        : undefined;
+    // This is lifecycle containment for inherited provider work. It is not a
+    // security boundary against a provider that can modify its delegated cgroup.
+    if (linuxCgroupLease !== undefined) {
+      yield* Scope.addFinalizer(
+        runtimeScope,
+        Effect.uninterruptible(terminateLinuxCgroupLease(linuxCgroupLease)).pipe(
+          Effect.ignoreCause({ log: true }),
+        ),
+      );
+    }
+    const containedTargetCommand =
+      linuxCgroupLease === undefined || NodePath.isAbsolute(spawnCommand.command)
+        ? spawnCommand.command
+        : yield* Effect.gen(function* () {
+            const resolved = resolveLinuxCgroupTargetCommand(
+              spawnCommand.command,
+              options.spawn.cwd ?? options.cwd,
+              { ...process.env, ...options.spawn.env },
+            );
+            if (resolved !== undefined) return resolved;
+            return yield* new EffectAcpErrors.AcpSpawnError({
+              command: options.spawn.command,
+              cause: new Error("Contained ACP command was not found on PATH"),
+            });
+          });
+    const containedSpawnCommand =
+      linuxCgroupLease === undefined
+        ? spawnCommand
+        : {
+            ...wrapCommandForLinuxCgroup(
+              linuxCgroupLease,
+              containedTargetCommand,
+              spawnCommand.args,
+            ),
+            shell: false,
+          };
+    const spawnEnvironment =
+      linuxCgroupLease === undefined
+        ? options.spawn.env
+        : {
+            ...options.spawn.env,
+            ELECTRON_RUN_AS_NODE: "1",
+            T3_ACP_CGROUP_WRAPPER: "1",
+          };
     const child = yield* spawner
       .spawn(
-        ChildProcess.make(spawnCommand.command, spawnCommand.args, {
+        ChildProcess.make(containedSpawnCommand.command, containedSpawnCommand.args, {
           ...(options.spawn.cwd ? { cwd: options.spawn.cwd } : {}),
-          ...(options.spawn.env ? { env: options.spawn.env, extendEnv: true } : {}),
-          shell: spawnCommand.shell,
+          ...(spawnEnvironment ? { env: spawnEnvironment, extendEnv: true } : {}),
+          ...(options.ownDetachedProcessGroup === undefined
+            ? {}
+            : { detached: options.ownDetachedProcessGroup }),
+          shell: containedSpawnCommand.shell,
         }),
       )
       .pipe(
@@ -362,6 +1429,155 @@ export const make = (
         ),
       );
 
+    const posixOwnershipLedger = new Map<string, AcpOwnedPosixProcess>();
+    const posixOwnershipFrontier = new Map<number, AcpOwnedPosixProcess>();
+    const posixOwnershipChildQueues = new Map<number, Array<number>>();
+    const posixOwnershipRoot: AcpPosixOwnershipRoot = { value: undefined };
+    const posixController =
+      options.ownDescendantProcessGroups === true
+        ? yield* Effect.try({
+            try: () => {
+              if (options.posixProcessTreeController !== undefined) {
+                return options.posixProcessTreeController;
+              }
+              if (options.processGroupPlatform === undefined) {
+                throw new AcpProcessGroupTerminationError({
+                  detail: "POSIX ACP descendant ownership requires a supported host platform",
+                });
+              }
+              return makePosixProcessTreeController(options.processGroupPlatform);
+            },
+            catch: (cause) =>
+              new EffectAcpErrors.AcpSpawnError({ command: options.spawn.command, cause }),
+          })
+        : undefined;
+    if (posixController !== undefined) {
+      const observeOwnership = () =>
+        observePosixOwnershipLedger({
+          childQueues: posixOwnershipChildQueues,
+          controller: posixController,
+          frontier: posixOwnershipFrontier,
+          ledger: posixOwnershipLedger,
+          root: posixOwnershipRoot,
+          rootPid: Number(child.pid),
+        });
+      yield* Effect.try({
+        try: observeOwnership,
+        catch: (cause) =>
+          new EffectAcpErrors.AcpSpawnError({ command: options.spawn.command, cause }),
+      });
+      yield* observePosixOwnershipLedgerContinuously({
+        childQueues: posixOwnershipChildQueues,
+        controller: posixController,
+        frontier: posixOwnershipFrontier,
+        ledger: posixOwnershipLedger,
+        root: posixOwnershipRoot,
+        rootPid: Number(child.pid),
+      }).pipe(Effect.forkIn(runtimeScope));
+    }
+
+    const signalOwnedProcessGroup = (signal: NodeJS.Signals) =>
+      Effect.try({
+        try: () => {
+          process.kill(-Number(child.pid), signal);
+          return true;
+        },
+        catch: (cause) =>
+          new AcpProcessGroupTerminationError({
+            cause,
+            detail: `Failed to signal ACP process group ${child.pid} with ${signal}`,
+          }),
+      }).pipe(
+        Effect.catch((error) => {
+          const cause = error.cause as NodeJS.ErrnoException | undefined;
+          return cause?.code === "ESRCH" ? Effect.succeed(false) : Effect.fail(error);
+        }),
+      );
+    const terminateWindowsProcessTree =
+      options.windowsProcessTreeTerminator ??
+      ((pid: number) => terminateWindowsProcessTreeWithTaskkill(spawner, pid));
+    const terminatePosixProcessTree = (grace: Duration.Input, platformOverride?: NodeJS.Platform) =>
+      Effect.gen(function* () {
+        const platform = platformOverride ?? options.processGroupPlatform;
+        if (platform === undefined || platform === "win32") {
+          return yield* new AcpProcessGroupTerminationError({
+            detail: "POSIX ACP descendant ownership requires a supported host platform",
+          });
+        }
+        const controller = yield* Effect.try({
+          try: () => posixController ?? makePosixProcessTreeController(platform),
+          catch: (cause) =>
+            isAcpProcessGroupTerminationError(cause)
+              ? cause
+              : new AcpProcessGroupTerminationError({
+                  cause,
+                  detail: `Failed to initialize ACP descendant ownership on ${platform}`,
+                }),
+        });
+        yield* terminatePosixOwnedProcessTree({
+          controller,
+          grace,
+          ledger: posixOwnershipLedger,
+          root: posixOwnershipRoot,
+          rootPid: Number(child.pid),
+        });
+      });
+    const terminateOwnedProcessGroupImpl = Effect.gen(function* () {
+      if (options.ownDetachedProcessGroup !== true) return;
+      if (options.processGroupPlatform === undefined) {
+        return yield* new AcpProcessGroupTerminationError({
+          detail: "Detached ACP process-group ownership requires a host platform",
+        });
+      }
+      if (options.processGroupPlatform === "win32") {
+        return yield* terminateWindowsProcessTree(Number(child.pid));
+      }
+      if (linuxCgroupLease !== undefined) {
+        if (posixController !== undefined) {
+          yield* Effect.sync(() =>
+            signalLinuxCgroupRootTerm({
+              controller: posixController,
+              lease: linuxCgroupLease,
+              root: posixOwnershipRoot,
+            }),
+          );
+        }
+        const grace = options.processGroupTerminationGrace ?? "1 second";
+        if (grace !== 0) yield* Effect.sleep(grace);
+        return yield* terminateLinuxCgroupLease(linuxCgroupLease);
+      }
+      if (options.ownDescendantProcessGroups === true) {
+        return yield* terminatePosixProcessTree(options.processGroupTerminationGrace ?? "1 second");
+      }
+      const groupExisted = yield* signalOwnedProcessGroup("SIGTERM");
+      if (!groupExisted) return;
+      const grace = options.processGroupTerminationGrace ?? "1 second";
+      if (grace !== 0) {
+        yield* Effect.sleep(grace);
+      }
+      yield* signalOwnedProcessGroup("SIGKILL");
+    }).pipe(withWallClock);
+    const terminateProcessGroup = yield* Effect.cached(
+      Effect.uninterruptible(terminateOwnedProcessGroupImpl),
+    );
+    if (options.ownDetachedProcessGroup === true) {
+      const hostPlatform = yield* HostProcessPlatform;
+      const forceTerminateOwnedProcessGroup =
+        hostPlatform === "win32"
+          ? terminateWindowsProcessTreeWithTaskkill(spawner, Number(child.pid))
+          : linuxCgroupLease !== undefined
+            ? terminateLinuxCgroupLease(linuxCgroupLease)
+            : options.ownDescendantProcessGroups === true
+              ? terminatePosixProcessTree(0, hostPlatform)
+              : signalOwnedProcessGroup("SIGKILL").pipe(Effect.asVoid);
+      yield* Scope.addFinalizer(
+        runtimeScope,
+        Effect.uninterruptible(forceTerminateOwnedProcessGroup).pipe(
+          Effect.ignoreCause({ log: true }),
+        ),
+      );
+    }
+
     const acpContext = yield* Layer.build(
       EffectAcpClient.layerChildProcess(child, {
         ...(options.protocolLogging?.logIncoming !== undefined
@@ -371,6 +1587,17 @@ export const make = (
           ? { logOutgoing: options.protocolLogging.logOutgoing }
           : {}),
         ...(options.protocolLogging?.logger ? { logger: options.protocolLogging.logger } : {}),
+        ...(options.onIncomingRequest ? { onIncomingRequest: options.onIncomingRequest } : {}),
+        onTermination: (error) =>
+          (options.onTermination?.(error) ?? Effect.void).pipe(
+            Effect.ensuring(
+              Scope.close(runtimeScope, Exit.fail(error)).pipe(Effect.forkDetach, Effect.asVoid),
+            ),
+          ),
+        ...(options.onOutgoingResponseFailure
+          ? { onOutgoingResponseFailure: options.onOutgoingResponseFailure }
+          : {}),
+        ...(options.onOutgoingResponse ? { onOutgoingResponse: options.onOutgoingResponse } : {}),
       }),
     ).pipe(Effect.provideService(Scope.Scope, runtimeScope));
 
@@ -379,15 +1606,23 @@ export const make = (
     yield* acp.handleSessionUpdate((notification) =>
       Effect.gen(function* () {
         const gate = yield* Ref.get(sessionLoadGateRef);
-        if (Option.isSome(gate) && gate.value.active) {
-          const lastActivityAtMillis = yield* Clock.currentTimeMillis;
-          yield* Ref.set(
-            sessionLoadGateRef,
-            Option.some({
-              ...gate.value,
-              lastActivityAtMillis,
-            }),
-          );
+        // A different session can still have an in-flight prompt while this
+        // load replays history, so quarantine only the loading session.
+        if (
+          Option.isSome(gate) &&
+          gate.value.active &&
+          notification.sessionId === gate.value.sessionId
+        ) {
+          if (sessionUpdateCountsAsLoadReplayActivity(notification, gate.value.sessionId)) {
+            const lastActivityAtMillis = yield* Clock.currentTimeMillis;
+            yield* Ref.set(
+              sessionLoadGateRef,
+              Option.some({
+                ...gate.value,
+                lastActivityAtMillis,
+              }),
+            );
+          }
           return;
         }
         if (sessionUpdateIsReplay(notification)) {
@@ -489,6 +1724,7 @@ export const make = (
     const updateConfigOptions = (
       response:
         | EffectAcpSchema.SetSessionConfigOptionResponse
+        | EffectAcpSchema.ForkSessionResponse
         | EffectAcpSchema.LoadSessionResponse
         | EffectAcpSchema.NewSessionResponse
         | EffectAcpSchema.ResumeSessionResponse,
@@ -499,6 +1735,131 @@ export const make = (
         current ? { ...current, currentModeId: modeId } : current,
       );
 
+    const adoptSession = (
+      sessionId: string,
+      sessionSetupResult:
+        | EffectAcpSchema.ForkSessionResponse
+        | EffectAcpSchema.LoadSessionResponse
+        | EffectAcpSchema.NewSessionResponse
+        | EffectAcpSchema.ResumeSessionResponse,
+    ): Effect.Effect<AcpSessionRuntimeStartResult, EffectAcpErrors.AcpError> =>
+      Effect.gen(function* () {
+        const current = yield* getStartedState;
+        const meta = sessionSetupResult._meta;
+        const syntheticReplayIdle =
+          meta !== null &&
+          typeof meta === "object" &&
+          !Array.isArray(meta) &&
+          (meta as { readonly t3SessionLoadReady?: unknown }).t3SessionLoadReady === "replay_idle";
+        const extractedModelConfigId = extractModelConfigId(sessionSetupResult);
+        const nextModelConfigId =
+          extractedModelConfigId ?? (syntheticReplayIdle ? current.modelConfigId : undefined);
+        const nextModeState = parseSessionModeState(sessionSetupResult);
+        if (nextModeState !== undefined) {
+          yield* Ref.set(modeStateRef, nextModeState);
+        } else if (!syntheticReplayIdle) {
+          yield* Ref.set(modeStateRef, undefined);
+        }
+        // Synthetic replay-idle load responses only carry initialize model/mode
+        // meta; preserve live configOptions so setConfigOption still validates.
+        if (
+          sessionSetupResult.configOptions !== undefined &&
+          sessionSetupResult.configOptions !== null
+        ) {
+          yield* Ref.set(configOptionsRef, sessionConfigOptionsFromSetup(sessionSetupResult));
+        } else if (!syntheticReplayIdle) {
+          yield* Ref.set(configOptionsRef, sessionConfigOptionsFromSetup(sessionSetupResult));
+        }
+        const nextState = {
+          sessionId,
+          initializeResult: current.initializeResult,
+          sessionSetupResult,
+          modelConfigId: nextModelConfigId,
+        } satisfies AcpStartedState;
+        yield* Ref.set(toolCallsRef, new Map());
+        yield* Ref.set(assistantSegmentRef, { nextSegmentIndex: 0 });
+        yield* Ref.set(startStateRef, { _tag: "Started", result: nextState });
+        return nextState;
+      });
+
+    const runLoadSessionWithReplayIdle = (
+      loadPayload: EffectAcpSchema.LoadSessionRequest,
+      initializeResult: EffectAcpSchema.InitializeResponse,
+    ): Effect.Effect<EffectAcpSchema.LoadSessionResponse, EffectAcpErrors.AcpError> =>
+      sessionLoadSemaphore.withPermits(1)(
+        Effect.gen(function* () {
+          const sessionLoadTimeout = Duration.fromInputUnsafe(
+            options.sessionLoadTimeout ?? defaultSessionLoadTimeout,
+          );
+          const sessionLoadReplayIdleGap = Duration.fromInputUnsafe(
+            options.sessionLoadReplayIdleGap ?? defaultSessionLoadReplayIdleGap,
+          );
+
+          yield* Ref.set(
+            sessionLoadGateRef,
+            Option.some({
+              active: true,
+              sessionId: loadPayload.sessionId,
+              lastActivityAtMillis: undefined,
+              idleGap: sessionLoadReplayIdleGap,
+              initializeResult,
+            }),
+          );
+
+          return yield* Effect.gen(function* () {
+            yield* logRequest({
+              method: "session/load",
+              payload: loadPayload,
+              status: "started",
+            });
+
+            const idleFiber = yield* waitForSessionLoadReplayIdle({
+              gateRef: sessionLoadGateRef,
+            }).pipe(Effect.forkIn(runtimeScope));
+            const loaded = yield* Effect.raceFirst(
+              acp.agent.loadSession(loadPayload),
+              Fiber.join(idleFiber),
+            ).pipe(
+              Effect.ensuring(Fiber.interrupt(idleFiber).pipe(Effect.ignore)),
+              Effect.timeoutOption(sessionLoadTimeout),
+              Effect.flatMap((result) =>
+                Option.match(result, {
+                  onNone: () =>
+                    Effect.fail(
+                      new EffectAcpErrors.AcpTransportError({
+                        operation: "call-rpc",
+                        method: "session/load",
+                        detail:
+                          "session/load timed out waiting for RPC response or replay idle gap",
+                        cause: undefined,
+                      }),
+                    ),
+                  onSome: Effect.succeed,
+                }),
+              ),
+              Effect.tap((result) =>
+                logRequest({
+                  method: "session/load",
+                  payload: loadPayload,
+                  status: "succeeded",
+                  result,
+                }),
+              ),
+              Effect.onError((cause) =>
+                logRequest({
+                  method: "session/load",
+                  payload: loadPayload,
+                  status: "failed",
+                  cause,
+                }),
+              ),
+            );
+
+            return loaded;
+          }).pipe(Effect.ensuring(Ref.set(sessionLoadGateRef, Option.none())));
+        }),
+      );
+
     const setConfigOption = (
       configId: string,
       value: string | boolean,
@@ -550,108 +1911,86 @@ export const make = (
         acp.agent.initialize(initializePayload),
       );
 
-      const authenticatePayload = {
-        methodId: options.authMethodId,
-      } satisfies EffectAcpSchema.AuthenticateRequest;
-
-      yield* runLoggedRequest(
-        "authenticate",
-        authenticatePayload,
-        acp.agent.authenticate(authenticatePayload),
-      );
+      const authenticateAfterRequired = (
+        authRequiredError: EffectAcpErrors.AcpError,
+      ): Effect.Effect<void, EffectAcpErrors.AcpError> =>
+        Effect.gen(function* () {
+          const configuredAuthMethodId = options.authMethodId?.trim();
+          const authMethod = selectAcpAgentAuthMethod(
+            initializeResult.authMethods,
+            configuredAuthMethodId,
+          );
+          if (
+            configuredAuthMethodId &&
+            initializeResult.authMethods !== undefined &&
+            authMethod === undefined
+          ) {
+            return yield* new EffectAcpErrors.AcpTransportError({
+              detail: `ACP agent did not advertise configured authentication method "${configuredAuthMethodId}"`,
+              cause: { configuredAuthMethodId, authMethods: initializeResult.authMethods },
+            });
+          }
+          if (authMethod !== undefined && "type" in authMethod) {
+            return yield* new EffectAcpErrors.AcpTransportError({
+              detail: `ACP authentication method "${authMethod.id}" requires ${authMethod.type} authentication, which cannot run inside a headless provider session`,
+              cause: authMethod,
+            });
+          }
 
-      let sessionId: string;
-      let sessionSetupResult:
-        | EffectAcpSchema.LoadSessionResponse
-        | EffectAcpSchema.NewSessionResponse
-        | EffectAcpSchema.ResumeSessionResponse;
-      if (options.resumeSessionId) {
-        const loadPayload = {
-          sessionId: options.resumeSessionId,
-          cwd: options.cwd,
-          mcpServers: options.mcpServers ?? [],
-        } satisfies EffectAcpSchema.LoadSessionRequest;
-        const sessionLoadTimeout = Duration.fromInputUnsafe(
-          options.sessionLoadTimeout ?? defaultSessionLoadTimeout,
-        );
-        const sessionLoadReplayIdleGap = Duration.fromInputUnsafe(
-          options.sessionLoadReplayIdleGap ?? defaultSessionLoadReplayIdleGap,
-        );
+          const authMethodId = authMethod?.id ?? configuredAuthMethodId;
+          if (!authMethodId) {
+            return yield* authRequiredError;
+          }
 
-        yield* Ref.set(
-          sessionLoadGateRef,
-          Option.some({
-            active: true,
-            lastActivityAtMillis: undefined,
-            idleGap: sessionLoadReplayIdleGap,
-            initializeResult,
-          }),
-        );
+          const authenticatePayload = {
+            methodId: authMethodId,
+          } satisfies EffectAcpSchema.AuthenticateRequest;
+          yield* runLoggedRequest(
+            "authenticate",
+            authenticatePayload,
+            acp.agent.authenticate(authenticatePayload),
+          );
+        });
 
-        sessionId = options.resumeSessionId;
-        sessionSetupResult = yield* Effect.gen(function* () {
-          yield* logRequest({
-            method: "session/load",
-            payload: loadPayload,
-            status: "started",
-          });
+      const setupSession = Effect.gen(function* () {
+        let sessionId: string;
+        let sessionSetupResult:
+          | EffectAcpSchema.LoadSessionResponse
+          | EffectAcpSchema.NewSessionResponse
+          | EffectAcpSchema.ResumeSessionResponse;
+        if (options.resumeSessionId) {
+          const loadPayload = {
+            sessionId: options.resumeSessionId,
+            cwd: options.cwd,
+            mcpServers: options.mcpServers ?? [],
+          } satisfies EffectAcpSchema.LoadSessionRequest;
 
-          const idleFiber = yield* waitForSessionLoadReplayIdle({
-            gateRef: sessionLoadGateRef,
-          }).pipe(Effect.forkIn(runtimeScope));
-          const loaded = yield* Effect.raceFirst(
-            acp.agent.loadSession(loadPayload),
-            Fiber.join(idleFiber),
-          ).pipe(
-            Effect.ensuring(Fiber.interrupt(idleFiber).pipe(Effect.ignore)),
-            Effect.timeoutOption(sessionLoadTimeout),
-            Effect.flatMap((result) =>
-              Option.match(result, {
-                onNone: () =>
-                  Effect.fail(
-                    new EffectAcpErrors.AcpTransportError({
-                      operation: "call-rpc",
-                      method: "session/load",
-                      detail: "session/load timed out waiting for RPC response or replay idle gap",
-                      cause: undefined,
-                    }),
-                  ),
-                onSome: Effect.succeed,
-              }),
-            ),
-            Effect.tap((result) =>
-              logRequest({
-                method: "session/load",
-                payload: loadPayload,
-                status: "succeeded",
-                result,
-              }),
-            ),
-            Effect.onError((cause) =>
-              logRequest({
-                method: "session/load",
-                payload: loadPayload,
-                status: "failed",
-                cause,
-              }),
-            ),
+          sessionId = options.resumeSessionId;
+          sessionSetupResult = yield* runLoadSessionWithReplayIdle(loadPayload, initializeResult);
+        } else {
+          const createPayload = {
+            cwd: options.cwd,
+            mcpServers: options.mcpServers ?? [],
+          } satisfies EffectAcpSchema.NewSessionRequest;
+          const created = yield* runLoggedRequest(
+            "session/new",
+            createPayload,
+            acp.agent.createSession(createPayload),
           );
+          sessionId = created.sessionId;
+          sessionSetupResult = created;
+        }
 
-          return loaded;
-        }).pipe(Effect.ensuring(Ref.set(sessionLoadGateRef, Option.none())));
-      } else {
-        const createPayload = {
-          cwd: options.cwd,
-          mcpServers: options.mcpServers ?? [],
-        } satisfies EffectAcpSchema.NewSessionRequest;
-        const created = yield* runLoggedRequest(
-          "session/new",
-          createPayload,
-          acp.agent.createSession(createPayload),
-        );
-        sessionId = created.sessionId;
-        sessionSetupResult = created;
-      }
+        return { sessionId, sessionSetupResult };
+      });
+
+      const { sessionId, sessionSetupResult } = yield* setupSession.pipe(
+        Effect.catch((error) =>
+          isAcpAuthenticationRequired(error)
+            ? authenticateAfterRequired(error).pipe(Effect.andThen(setupSession))
+            : Effect.fail(error),
+        ),
+      );
 
       yield* Ref.set(modeStateRef, parseSessionModeState(sessionSetupResult));
       yield* Ref.set(configOptionsRef, sessionConfigOptionsFromSetup(sessionSetupResult));
@@ -698,6 +2037,14 @@ export const make = (
     });
 
     return {
+      processContainment:
+        linuxCgroupLease !== undefined
+          ? "cgroup-v2"
+          : options.ownDescendantProcessGroups === true
+            ? "process-ledger-reduced-guarantee"
+            : options.ownDetachedProcessGroup === true
+              ? "process-group"
+              : "none",
       handleRequestPermission: acp.handleRequestPermission,
       handleElicitation: acp.handleElicitation,
       handleReadTextFile: acp.handleReadTextFile,
@@ -725,6 +2072,78 @@ export const make = (
       }),
       getModeState: Ref.get(modeStateRef),
       getConfigOptions: Ref.get(configOptionsRef),
+      loadSession: (sessionId, activationOptions) =>
+        start.pipe(
+          Effect.flatMap((started) => {
+            const requestPayload = {
+              sessionId,
+              cwd: options.cwd,
+              mcpServers: activationOptions?.mcpServers ?? options.mcpServers ?? [],
+            } satisfies EffectAcpSchema.LoadSessionRequest;
+            return runLoadSessionWithReplayIdle(requestPayload, started.initializeResult);
+          }),
+          Effect.flatMap((response) => adoptSession(sessionId, response)),
+        ),
+      resumeSession: (sessionId, activationOptions) =>
+        start.pipe(
+          Effect.flatMap(() => {
+            const requestPayload = {
+              sessionId,
+              cwd: options.cwd,
+              mcpServers: activationOptions?.mcpServers ?? options.mcpServers ?? [],
+            } satisfies EffectAcpSchema.ResumeSessionRequest;
+            return runLoggedRequest(
+              "session/resume",
+              requestPayload,
+              acp.agent.resumeSession(requestPayload),
+            );
+          }),
+          Effect.flatMap((response) => adoptSession(sessionId, response)),
+        ),
+      forkSession: (sessionId, activationOptions) =>
+        start.pipe(
+          Effect.flatMap(() => {
+            const requestPayload = {
+              sessionId,
+              cwd: options.cwd,
+              mcpServers: activationOptions?.mcpServers ?? options.mcpServers ?? [],
+            } satisfies EffectAcpSchema.ForkSessionRequest;
+            return runLoggedRequest(
+              "session/fork",
+              requestPayload,
+              acp.agent.forkSession(requestPayload),
+            );
+          }),
+          Effect.flatMap((response) => adoptSession(response.sessionId, response)),
+        ),
+      listSessions: (cursor) => {
+        const requestPayload = {
+          cwd: options.cwd,
+          ...(cursor === undefined ? {} : { cursor }),
+        } satisfies EffectAcpSchema.ListSessionsRequest;
+        return start.pipe(
+          Effect.andThen(
+            runLoggedRequest(
+              "session/list",
+              requestPayload,
+              acp.agent.listSessions(requestPayload),
+            ),
+          ),
+        );
+      },
+      closeSession: (sessionId) =>
+        start.pipe(
+          Effect.flatMap((started) => {
+            const requestPayload = {
+              sessionId: sessionId ?? started.sessionId,
+            } satisfies EffectAcpSchema.CloseSessionRequest;
+            return runLoggedRequest(
+              "session/close",
+              requestPayload,
+              acp.agent.closeSession(requestPayload),
+            );
+          }),
+        ),
       prompt: (payload) =>
         promptSerializationSemaphore.withPermit(
           Effect.gen(function* () {
@@ -769,17 +2188,26 @@ export const make = (
         ),
       cancel: getStartedState.pipe(
         Effect.flatMap((started) =>
-          Effect.gen(function* () {
-            const activePromptFiber = yield* Ref.get(activePromptFiberRef);
-            if (Option.isSome(activePromptFiber)) {
-              yield* Fiber.interrupt(activePromptFiber.value).pipe(Effect.ignore);
-            }
-            yield* acp.agent
-              .cancel({ sessionId: started.sessionId })
-              .pipe(Effect.ignore, Effect.forkIn(runtimeScope));
-          }),
+          options.interruptPromptOnCancel === false
+            ? acp.agent.cancel({
+                sessionId: started.sessionId,
+                ...(options.cancelMeta === undefined ? {} : { _meta: options.cancelMeta }),
+              })
+            : Effect.gen(function* () {
+                const activePromptFiber = yield* Ref.get(activePromptFiberRef);
+                if (Option.isSome(activePromptFiber)) {
+                  yield* Fiber.interrupt(activePromptFiber.value).pipe(Effect.ignore);
+                }
+                yield* acp.agent
+                  .cancel({
+                    sessionId: started.sessionId,
+                    ...(options.cancelMeta === undefined ? {} : { _meta: options.cancelMeta }),
+                  })
+                  .pipe(Effect.ignore, Effect.forkIn(runtimeScope));
+              }),
         ),
       ),
+      ...(options.ownDetachedProcessGroup === true ? { terminateProcessGroup } : {}),
       setMode: (modeId) =>
         Ref.get(modeStateRef).pipe(
           Effect.flatMap((modeState) => {
diff --git a/apps/server/src/provider/acp/CursorAcpCliProbe.test.ts b/apps/server/src/provider/acp/CursorAcpCliProbe.test.ts
deleted file mode 100644
index 6be4faf96701..000000000000
--- a/apps/server/src/provider/acp/CursorAcpCliProbe.test.ts
+++ /dev/null
@@ -1,153 +0,0 @@
-/**
- * Optional integration check against a real `cursor-agent acp` install.
- * Enable with: T3_CURSOR_ACP_PROBE=1 bun run test --filter CursorAcpCliProbe
- */
-import * as NodeServices from "@effect/platform-node/NodeServices";
-import { it } from "@effect/vitest";
-import * as Console from "effect/Console";
-import * as Effect from "effect/Effect";
-import { describe, expect } from "vite-plus/test";
-import type * as EffectAcpSchema from "effect-acp/schema";
-
-import * as AcpSessionRuntime from "./AcpSessionRuntime.ts";
-
-describe.runIf(process.env.T3_CURSOR_ACP_PROBE === "1")("Cursor ACP CLI probe", () => {
-  it.effect("initialize and authenticate against real cursor-agent acp", () =>
-    Effect.gen(function* () {
-      const runtime = yield* AcpSessionRuntime.AcpSessionRuntime;
-      const started = yield* runtime.start();
-      expect(started.initializeResult).toBeDefined();
-    }).pipe(
-      Effect.provide(
-        AcpSessionRuntime.layer({
-          spawn: {
-            command: "cursor-agent",
-            args: ["acp"],
-            cwd: process.cwd(),
-          },
-          cwd: process.cwd(),
-          clientCapabilities: {
-            _meta: {
-              parameterizedModelPicker: true,
-            },
-          },
-          clientInfo: { name: "t3-probe", version: "0.0.0" },
-          authMethodId: "cursor_login",
-        }),
-      ),
-      Effect.scoped,
-      Effect.provide(NodeServices.layer),
-    ),
-  );
-
-  it.effect("session/new returns configOptions with a model selector", () =>
-    Effect.gen(function* () {
-      const runtime = yield* AcpSessionRuntime.AcpSessionRuntime;
-      const started = yield* runtime.start();
-      const result = started.sessionSetupResult;
-      // @effect-diagnostics-next-line preferSchemaOverJson:off
-      yield* Console.log("session/new result:", JSON.stringify(result, null, 2));
-
-      expect(typeof started.sessionId).toBe("string");
-
-      const configOptions = result.configOptions;
-      // @effect-diagnostics-next-line preferSchemaOverJson:off
-      yield* Console.log("session/new configOptions:", JSON.stringify(configOptions, null, 2));
-
-      if (Array.isArray(configOptions)) {
-        const modelConfig = configOptions.find((opt) => opt.category === "model");
-        const parameterizedOptions = configOptions.filter(
-          (opt) =>
-            opt.category === "thought_level" ||
-            opt.category === "model_option" ||
-            opt.category === "model_config",
-        );
-        // @effect-diagnostics-next-line preferSchemaOverJson:off
-        yield* Console.log("Model config option:", JSON.stringify(modelConfig, null, 2));
-        yield* Console.log(
-          "Parameterized model config options:",
-          // @effect-diagnostics-next-line preferSchemaOverJson:off
-          JSON.stringify(parameterizedOptions, null, 2),
-        );
-        expect(modelConfig).toBeDefined();
-        expect(typeof modelConfig?.id).toBe("string");
-      }
-    }).pipe(
-      Effect.provide(
-        AcpSessionRuntime.layer({
-          authMethodId: "cursor_login",
-          spawn: {
-            command: "cursor-agent",
-            args: ["acp"],
-            cwd: process.cwd(),
-          },
-          cwd: process.cwd(),
-          clientCapabilities: {
-            _meta: {
-              parameterizedModelPicker: true,
-            },
-          },
-          clientInfo: { name: "t3-probe", version: "0.0.0" },
-        }),
-      ),
-      Effect.scoped,
-      Effect.provide(NodeServices.layer),
-    ),
-  );
-
-  it.effect("session/set_config_option switches the model in-session", () =>
-    Effect.gen(function* () {
-      const runtime = yield* AcpSessionRuntime.AcpSessionRuntime;
-      const started = yield* runtime.start();
-      const newResult = started.sessionSetupResult;
-
-      const configOptions = newResult.configOptions;
-      let modelConfigId = "model";
-      if (Array.isArray(configOptions)) {
-        const modelConfig = configOptions.find((opt) => opt.category === "model");
-        if (typeof modelConfig?.id === "string") {
-          modelConfigId = modelConfig.id;
-        }
-      }
-
-      const setResult: EffectAcpSchema.SetSessionConfigOptionResponse =
-        yield* runtime.setConfigOption(modelConfigId, "gpt-5.4");
-      // @effect-diagnostics-next-line preferSchemaOverJson:off
-      yield* Console.log("session/set_config_option result:", JSON.stringify(setResult, null, 2));
-
-      if (Array.isArray(setResult.configOptions)) {
-        const modelConfig = setResult.configOptions.find((opt) => opt.category === "model");
-        const parameterizedOptions = setResult.configOptions.filter(
-          (opt) =>
-            opt.category === "thought_level" ||
-            opt.category === "model_option" ||
-            opt.category === "model_config",
-        );
-        if (modelConfig?.type === "select") {
-          expect(modelConfig.currentValue).toBe("gpt-5.4");
-        }
-        expect(parameterizedOptions.length).toBeGreaterThan(0);
-      }
-    }).pipe(
-      Effect.provide(
-        AcpSessionRuntime.layer({
-          authMethodId: "cursor_login",
-          spawn: {
-            command: "cursor-agent",
-            args: ["acp"],
-            cwd: process.cwd(),
-          },
-          cwd: process.cwd(),
-          clientCapabilities: {
-            _meta: {
-              parameterizedModelPicker: true,
-            },
-          },
-          clientInfo: { name: "t3-probe", version: "0.0.0" },
-        }),
-      ),
-      Effect.scoped,
-      Effect.provide(NodeServices.layer),
-    ),
-  );
-});
diff --git a/apps/server/src/provider/acp/CursorAcpExtension.test.ts b/apps/server/src/provider/acp/CursorAcpExtension.test.ts
deleted file mode 100644
index ba070c912952..000000000000
--- a/apps/server/src/provider/acp/CursorAcpExtension.test.ts
+++ /dev/null
@@ -1,154 +0,0 @@
-import { describe, expect, it } from "vite-plus/test";
-
-import {
-  CursorListAvailableModelsResponse,
-  extractAskQuestions,
-  extractPlanMarkdown,
-  extractTodosAsPlan,
-} from "./CursorAcpExtension.ts";
-
-describe("CursorAcpExtension", () => {
-  it("extracts ask-question prompts from the real Cursor ACP payload shape", () => {
-    const questions = extractAskQuestions({
-      toolCallId: "ask-1",
-      title: "Need input",
-      questions: [
-        {
-          id: "language",
-          prompt: "Which language should I use?",
-          options: [
-            { id: "ts", label: "TypeScript" },
-            { id: "rs", label: "Rust" },
-          ],
-          allowMultiple: false,
-        },
-      ],
-    });
-
-    expect(questions).toEqual([
-      {
-        id: "language",
-        header: "Question",
-        question: "Which language should I use?",
-        multiSelect: false,
-        options: [
-          { label: "TypeScript", description: "TypeScript" },
-          { label: "Rust", description: "Rust" },
-        ],
-      },
-    ]);
-  });
-
-  it("defaults ask-question multi-select to false when Cursor omits allowMultiple", () => {
-    const questions = extractAskQuestions({
-      toolCallId: "ask-2",
-      questions: [
-        {
-          id: "mode",
-          prompt: "Which mode should I use?",
-          options: [
-            { id: "agent", label: "Agent" },
-            { id: "plan", label: "Plan" },
-          ],
-        },
-      ],
-    });
-
-    expect(questions).toEqual([
-      {
-        id: "mode",
-        header: "Question",
-        question: "Which mode should I use?",
-        multiSelect: false,
-        options: [
-          { label: "Agent", description: "Agent" },
-          { label: "Plan", description: "Plan" },
-        ],
-      },
-    ]);
-  });
-
-  it("extracts plan markdown from the real Cursor create-plan payload shape", () => {
-    const planMarkdown = extractPlanMarkdown({
-      toolCallId: "plan-1",
-      name: "Refactor parser",
-      overview: "Tighten ACP parsing",
-      plan: "# Plan\n\n1. Add schemas\n2. Remove casts",
-      todos: [
-        { id: "t1", content: "Add schemas", status: "in_progress" },
-        { id: "t2", content: "Remove casts", status: "pending" },
-      ],
-      isProject: false,
-    });
-
-    expect(planMarkdown).toBe("# Plan\n\n1. Add schemas\n2. Remove casts");
-  });
-
-  it("projects todo updates into a plan shape and drops invalid entries", () => {
-    expect(
-      extractTodosAsPlan({
-        toolCallId: "todos-1",
-        todos: [
-          { id: "1", content: "Inspect state", status: "completed" },
-          { id: "2", content: "  Apply fix  ", status: "in_progress" },
-          { id: "3", title: "Fallback title", status: "pending" },
-          { id: "4", content: "Unknown status", status: "weird_status" },
-          { id: "5", content: "   " },
-        ],
-        merge: true,
-      }),
-    ).toEqual({
-      plan: [
-        { step: "Inspect state", status: "completed" },
-        { step: "Apply fix", status: "inProgress" },
-        { step: "Fallback title", status: "pending" },
-        { step: "Unknown status", status: "pending" },
-      ],
-    });
-  });
-
-  it("falls back to the title when content is present but blank", () => {
-    expect(
-      extractTodosAsPlan({
-        toolCallId: "todos-2",
-        todos: [
-          { id: "1", content: "", title: "Titled step", status: "pending" },
-          { id: "2", content: "   ", title: "Whitespace content", status: "in_progress" },
-          { id: "3", content: "", title: "", status: "pending" },
-        ],
-        merge: true,
-      }),
-    ).toEqual({
-      plan: [
-        { step: "Titled step", status: "pending" },
-        { step: "Whitespace content", status: "inProgress" },
-      ],
-    });
-  });
-
-  it("decodes Cursor list_available_models responses with per-model config options", () => {
-    const decoded = CursorListAvailableModelsResponse.make({
-      models: [
-        {
-          value: "gpt-5.4",
-          name: "GPT-5.4",
-          configOptions: [
-            {
-              id: "reasoning",
-              name: "Reasoning",
-              category: "thought_level",
-              type: "select",
-              currentValue: "medium",
-              options: [
-                { value: "low", name: "Low" },
-                { value: "medium", name: "Medium" },
-              ],
-            },
-          ],
-        },
-      ],
-    });
-
-    expect(decoded.models[0]?.configOptions?.[0]?.id).toBe("reasoning");
-  });
-});
diff --git a/apps/server/src/provider/acp/CursorAcpExtension.ts b/apps/server/src/provider/acp/CursorAcpExtension.ts
deleted file mode 100644
index 05fc53f4a6b5..000000000000
--- a/apps/server/src/provider/acp/CursorAcpExtension.ts
+++ /dev/null
@@ -1,113 +0,0 @@
-/**
- * Public Docs: https://cursor.com/docs/cli/acp#cursor-extension-methods
- * Additional reference provided by the Cursor team: https://anysphere.enterprise.slack.com/files/U068SSJE141/F0APT1HSZRP/cursor-acp-extension-method-schemas.md
- */
-import type { UserInputQuestion } from "@t3tools/contracts";
-import * as AcpSchema from "effect-acp/schema";
-import * as Schema from "effect/Schema";
-
-const CursorAskQuestionOption = Schema.Struct({
-  id: Schema.String,
-  label: Schema.String,
-});
-
-const CursorAskQuestion = Schema.Struct({
-  id: Schema.String,
-  prompt: Schema.String,
-  options: Schema.Array(CursorAskQuestionOption),
-  allowMultiple: Schema.optional(Schema.Boolean),
-});
-
-export const CursorAskQuestionRequest = Schema.Struct({
-  toolCallId: Schema.String,
-  title: Schema.optional(Schema.String),
-  questions: Schema.Array(CursorAskQuestion),
-});
-
-const CursorTodoStatus = Schema.String;
-
-const CursorTodo = Schema.Struct({
-  id: Schema.optional(Schema.String),
-  content: Schema.optional(Schema.String),
-  title: Schema.optional(Schema.String),
-  status: Schema.optional(CursorTodoStatus),
-});
-
-const CursorPlanPhase = Schema.Struct({
-  name: Schema.String,
-  todos: Schema.Array(CursorTodo),
-});
-
-export const CursorCreatePlanRequest = Schema.Struct({
-  toolCallId: Schema.String,
-  name: Schema.optional(Schema.String),
-  overview: Schema.optional(Schema.String),
-  plan: Schema.String,
-  todos: Schema.Array(CursorTodo),
-  isProject: Schema.optional(Schema.Boolean),
-  phases: Schema.optional(Schema.Array(CursorPlanPhase)),
-});
-
-export const CursorUpdateTodosRequest = Schema.Struct({
-  toolCallId: Schema.String,
-  todos: Schema.Array(CursorTodo),
-  merge: Schema.Boolean,
-});
-
-const CursorAvailableModel = Schema.Struct({
-  value: Schema.String,
-  name: Schema.String,
-  configOptions: Schema.optional(Schema.Array(AcpSchema.SessionConfigOption)),
-});
-
-export const CursorListAvailableModelsResponse = Schema.Struct({
-  models: Schema.Array(CursorAvailableModel),
-});
-
-export function extractAskQuestions(
-  params: typeof CursorAskQuestionRequest.Type,
-): ReadonlyArray<UserInputQuestion> {
-  return params.questions.map((question) => ({
-    id: question.id,
-    header: "Question",
-    question: question.prompt,
-    multiSelect: question.allowMultiple === true,
-    options:
-      question.options.length > 0
-        ? question.options.map((option) => ({
-            label: option.label,
-            description: option.label,
-          }))
-        : [{ label: "OK", description: "Continue" }],
-  }));
-}
-
-export function extractPlanMarkdown(params: typeof CursorCreatePlanRequest.Type): string {
-  return params.plan || "# Plan\n\n(Cursor did not supply plan text.)";
-}
-
-export function extractTodosAsPlan(params: typeof CursorUpdateTodosRequest.Type): {
-  readonly explanation?: string;
-  readonly plan: ReadonlyArray<{
-    readonly step: string;
-    readonly status: "pending" | "inProgress" | "completed";
-  }>;
-} {
-  const plan = params.todos.flatMap((todo) => {
-    // Fall back to the title when content is missing OR blank. `??` only
-    // covers a missing content, so a present-but-empty content ("" or
-    // whitespace) would shadow a real title and drop the step below.
-    const step = todo.content?.trim() || todo.title?.trim() || "";
-    if (step === "") {
-      return [];
-    }
-    const status: "pending" | "inProgress" | "completed" =
-      todo.status === "completed"
-        ? "completed"
-        : todo.status === "in_progress" || todo.status === "inProgress"
-          ? "inProgress"
-          : "pending";
-    return [{ step, status }];
-  });
-  return { plan };
-}
diff --git a/apps/server/src/provider/acp/CursorAcpSupport.test.ts b/apps/server/src/provider/acp/CursorAcpSupport.test.ts
deleted file mode 100644
index a095fdd679bc..000000000000
--- a/apps/server/src/provider/acp/CursorAcpSupport.test.ts
+++ /dev/null
@@ -1,121 +0,0 @@
-import * as Effect from "effect/Effect";
-import type * as EffectAcpSchema from "effect-acp/schema";
-import { describe, expect, it } from "vite-plus/test";
-
-import { applyCursorAcpModelSelection, buildCursorAcpSpawnInput } from "./CursorAcpSupport.ts";
-
-const parameterizedGpt54ConfigOptions: ReadonlyArray<EffectAcpSchema.SessionConfigOption> = [
-  {
-    id: "model",
-    name: "Model",
-    category: "model",
-    type: "select",
-    currentValue: "gpt-5.4-medium-fast",
-    options: [{ value: "gpt-5.4-medium-fast", name: "GPT-5.4" }],
-  },
-  {
-    id: "reasoning",
-    name: "Reasoning",
-    category: "thought_level",
-    type: "select",
-    currentValue: "medium",
-    options: [
-      { value: "low", name: "Low" },
-      { value: "medium", name: "Medium" },
-      { value: "high", name: "High" },
-      { value: "extra-high", name: "Extra High" },
-    ],
-  },
-  {
-    id: "context",
-    name: "Context",
-    category: "model_config",
-    type: "select",
-    currentValue: "272k",
-    options: [
-      { value: "272k", name: "272K" },
-      { value: "1m", name: "1M" },
-    ],
-  },
-  {
-    id: "fast",
-    name: "Fast",
-    category: "model_config",
-    type: "select",
-    currentValue: "false",
-    options: [
-      { value: "false", name: "Off" },
-      { value: "true", name: "Fast" },
-    ],
-  },
-];
-
-describe("buildCursorAcpSpawnInput", () => {
-  it("builds the default Cursor ACP command", () => {
-    expect(buildCursorAcpSpawnInput(undefined, "/tmp/project")).toEqual({
-      command: "cursor-agent",
-      args: ["acp"],
-      cwd: "/tmp/project",
-    });
-  });
-
-  it("includes the configured api endpoint when present", () => {
-    expect(
-      buildCursorAcpSpawnInput(
-        {
-          binaryPath: "/usr/local/bin/agent",
-          apiEndpoint: "http://localhost:3000",
-        },
-        "/tmp/project",
-      ),
-    ).toEqual({
-      command: "/usr/local/bin/agent",
-      args: ["-e", "http://localhost:3000", "acp"],
-      cwd: "/tmp/project",
-    });
-  });
-});
-
-describe("applyCursorAcpModelSelection", () => {
-  it("sets the base model before applying separate config options", async () => {
-    const calls: Array<
-      | { readonly type: "model"; readonly value: string }
-      | { readonly type: "config"; readonly configId: string; readonly value: string | boolean }
-    > = [];
-
-    const runtime = {
-      getConfigOptions: Effect.succeed(parameterizedGpt54ConfigOptions),
-      setModel: (value: string) =>
-        Effect.sync(() => {
-          calls.push({ type: "model", value });
-        }),
-      setConfigOption: (configId: string, value: string | boolean) =>
-        Effect.sync(() => {
-          calls.push({ type: "config", configId, value });
-        }),
-    };
-
-    await Effect.runPromise(
-      applyCursorAcpModelSelection({
-        runtime,
-        model: "gpt-5.4-medium-fast[reasoning=medium,context=272k]",
-        selections: [
-          { id: "reasoning", value: "xhigh" },
-          { id: "contextWindow", value: "1m" },
-          { id: "fastMode", value: true },
-        ],
-        mapError: ({ step, configId, cause }) =>
-          step === "set-config-option"
-            ? `failed to set config option ${configId}: ${cause.message}`
-            : `failed to set model: ${cause.message}`,
-      }),
-    );
-
-    expect(calls).toEqual([
-      { type: "model", value: "gpt-5.4-medium-fast" },
-      { type: "config", configId: "reasoning", value: "extra-high" },
-      { type: "config", configId: "context", value: "1m" },
-      { type: "config", configId: "fast", value: "true" },
-    ]);
-  });
-});
diff --git a/apps/server/src/provider/acp/CursorAcpSupport.ts b/apps/server/src/provider/acp/CursorAcpSupport.ts
deleted file mode 100644
index 30203ad77b1e..000000000000
--- a/apps/server/src/provider/acp/CursorAcpSupport.ts
+++ /dev/null
@@ -1,115 +0,0 @@
-import { type CursorSettings, type ProviderOptionSelection } from "@t3tools/contracts";
-import * as Crypto from "effect/Crypto";
-import * as Effect from "effect/Effect";
-import * as Layer from "effect/Layer";
-import * as Scope from "effect/Scope";
-import * as ChildProcessSpawner from "effect/unstable/process/ChildProcessSpawner";
-import type * as EffectAcpErrors from "effect-acp/errors";
-
-import {
-  CURSOR_PARAMETERIZED_MODEL_PICKER_CAPABILITIES,
-  resolveCursorAcpBaseModelId,
-  resolveCursorAcpConfigUpdates,
-} from "../Layers/CursorProvider.ts";
-import * as AcpSessionRuntime from "./AcpSessionRuntime.ts";
-
-type CursorAcpRuntimeCursorSettings = Pick<CursorSettings, "apiEndpoint" | "binaryPath">;
-
-export interface CursorAcpRuntimeInput extends Omit<
-  AcpSessionRuntime.AcpSessionRuntimeOptions,
-  "authMethodId" | "clientCapabilities" | "spawn"
-> {
-  readonly childProcessSpawner: ChildProcessSpawner.ChildProcessSpawner["Service"];
-  readonly cursorSettings: CursorAcpRuntimeCursorSettings | null | undefined;
-  readonly environment?: NodeJS.ProcessEnv;
-}
-
-export interface CursorAcpModelSelectionErrorContext {
-  readonly cause: EffectAcpErrors.AcpError;
-  readonly step: "set-config-option" | "set-model";
-  readonly configId?: string;
-}
-
-export function buildCursorAcpSpawnInput(
-  cursorSettings: CursorAcpRuntimeCursorSettings | null | undefined,
-  cwd: string,
-  environment?: NodeJS.ProcessEnv,
-): AcpSessionRuntime.AcpSpawnInput {
-  return {
-    command: cursorSettings?.binaryPath || "cursor-agent",
-    args: [
-      ...(cursorSettings?.apiEndpoint ? (["-e", cursorSettings.apiEndpoint] as const) : []),
-      "acp",
-    ],
-    cwd,
-    ...(environment ? { env: environment } : {}),
-  };
-}
-
-export const makeCursorAcpRuntime = (
-  input: CursorAcpRuntimeInput,
-): Effect.Effect<
-  AcpSessionRuntime.AcpSessionRuntime["Service"],
-  EffectAcpErrors.AcpError,
-  Crypto.Crypto | Scope.Scope
-> =>
-  Effect.gen(function* () {
-    const acpContext = yield* Layer.build(
-      AcpSessionRuntime.layer({
-        ...input,
-        spawn: buildCursorAcpSpawnInput(input.cursorSettings, input.cwd, input.environment),
-        authMethodId: "cursor_login",
-        clientCapabilities: CURSOR_PARAMETERIZED_MODEL_PICKER_CAPABILITIES,
-      }).pipe(
-        Layer.provide(
-          Layer.succeed(ChildProcessSpawner.ChildProcessSpawner, input.childProcessSpawner),
-        ),
-      ),
-    );
-    return yield* Effect.service(AcpSessionRuntime.AcpSessionRuntime).pipe(
-      Effect.provide(acpContext),
-    );
-  });
-
-interface CursorAcpModelSelectionRuntime {
-  readonly getConfigOptions: AcpSessionRuntime.AcpSessionRuntime["Service"]["getConfigOptions"];
-  readonly setConfigOption: (
-    configId: string,
-    value: string | boolean,
-  ) => Effect.Effect<unknown, EffectAcpErrors.AcpError>;
-  readonly setModel: (model: string) => Effect.Effect<unknown, EffectAcpErrors.AcpError>;
-}
-
-export function applyCursorAcpModelSelection<E>(input: {
-  readonly runtime: CursorAcpModelSelectionRuntime;
-  readonly model: string | null | undefined;
-  readonly selections: ReadonlyArray<ProviderOptionSelection> | null | undefined;
-  readonly mapError: (context: CursorAcpModelSelectionErrorContext) => E;
-}): Effect.Effect<void, E> {
-  return Effect.gen(function* () {
-    yield* input.runtime.setModel(resolveCursorAcpBaseModelId(input.model)).pipe(
-      Effect.mapError((cause) =>
-        input.mapError({
-          cause,
-          step: "set-model",
-        }),
-      ),
-    );
-
-    const configUpdates = resolveCursorAcpConfigUpdates(
-      yield* input.runtime.getConfigOptions,
-      input.selections,
-    );
-    for (const update of configUpdates) {
-      yield* input.runtime.setConfigOption(update.configId, update.value).pipe(
-        Effect.mapError((cause) =>
-          input.mapError({
-            cause,
-            step: "set-config-option",
-            configId: update.configId,
-          }),
-        ),
-      );
-    }
-  });
-}
diff --git a/apps/server/src/provider/acp/GrokAcpCliProbe.test.ts b/apps/server/src/provider/acp/GrokAcpCliProbe.test.ts
index ad6eaac1b521..c2d64c48a219 100644
--- a/apps/server/src/provider/acp/GrokAcpCliProbe.test.ts
+++ b/apps/server/src/provider/acp/GrokAcpCliProbe.test.ts
@@ -72,6 +72,27 @@ describe.runIf(process.env.T3_GROK_ACP_PROBE === "1")("Grok ACP CLI probe", () =
     }).pipe(Effect.scoped, Effect.provide(NodeServices.layer)),
   );
 
+  it.effect("switches when another model is advertised and completes a prompt", () =>
+    Effect.gen(function* () {
+      const runtime = yield* makeProbeRuntime;
+      const started = yield* runtime.start();
+      const models = started.sessionSetupResult.models;
+      const targetModel = models?.availableModels.find(
+        ({ modelId }) => modelId !== models.currentModelId,
+      )?.modelId;
+
+      // Model availability is account-dependent. Exercise a real switch when
+      // possible, but a single-model catalog is valid and must still reach the
+      // prompt check below.
+      if (targetModel !== undefined) {
+        yield* runtime.setSessionModel(targetModel).pipe(Effect.timeout("20 seconds"));
+      }
+      const result = yield* runtime
+        .prompt({ prompt: [{ type: "text", text: "Respond with exactly: grok switch ok" }] })
+        .pipe(Effect.timeout("60 seconds"));
+      expect(result.stopReason).toBe("end_turn");
+    }).pipe(Effect.scoped, Effect.provide(NodeServices.layer)),
+  );
   it.effect("session/set_model accepts advertised reasoning effort metadata", () =>
     Effect.gen(function* () {
       const runtime = yield* makeProbeRuntime;
diff --git a/apps/server/src/provider/acp/GrokAcpSupport.test.ts b/apps/server/src/provider/acp/GrokAcpSupport.test.ts
index a85f7174a1c0..333e6b7416dd 100644
--- a/apps/server/src/provider/acp/GrokAcpSupport.test.ts
+++ b/apps/server/src/provider/acp/GrokAcpSupport.test.ts
@@ -5,11 +5,35 @@ import * as EffectAcpErrors from "effect-acp/errors";
 import {
   applyGrokAcpModelSelection,
   buildGrokAcpSpawnInput,
+  grokAcpRuntimeProcessOwnership,
   grokAcpSpawnArgs,
   isValidGrokReasoningEffortToken,
   resolveGrokAcpBaseModelId,
 } from "./GrokAcpSupport.ts";
 
+describe("grokAcpRuntimeProcessOwnership", () => {
+  it("opts Grok into detached process-tree ownership on the injected host platform", () => {
+    expect(grokAcpRuntimeProcessOwnership("linux")).toEqual({
+      ownDescendantProcessGroups: true,
+      ownDetachedProcessGroup: true,
+      processGroupPlatform: "linux",
+    });
+  });
+
+  it("uses the prior provider-group path on Darwin and Windows", () => {
+    expect(grokAcpRuntimeProcessOwnership("darwin")).toEqual({
+      ownDescendantProcessGroups: false,
+      ownDetachedProcessGroup: true,
+      processGroupPlatform: "darwin",
+    });
+    expect(grokAcpRuntimeProcessOwnership("win32")).toEqual({
+      ownDescendantProcessGroups: false,
+      ownDetachedProcessGroup: true,
+      processGroupPlatform: "win32",
+    });
+  });
+});
+
 describe("resolveGrokAcpBaseModelId", () => {
   it("normalizes empty and custom Grok model ids", () => {
     expect(resolveGrokAcpBaseModelId(undefined)).toBe("grok-build");
diff --git a/apps/server/src/provider/acp/GrokAcpSupport.ts b/apps/server/src/provider/acp/GrokAcpSupport.ts
index 001f0adfe7b8..a4cf12c60943 100644
--- a/apps/server/src/provider/acp/GrokAcpSupport.ts
+++ b/apps/server/src/provider/acp/GrokAcpSupport.ts
@@ -1,3 +1,4 @@
+import * as NodeServices from "@effect/platform-node/NodeServices";
 import { type GrokSettings, ProviderDriverKind, type RuntimeMode } from "@t3tools/contracts";
 import * as Crypto from "effect/Crypto";
 import * as Effect from "effect/Effect";
@@ -6,6 +7,7 @@ import * as Scope from "effect/Scope";
 import * as ChildProcessSpawner from "effect/unstable/process/ChildProcessSpawner";
 import * as EffectAcpErrors from "effect-acp/errors";
 import type * as EffectAcpSchema from "effect-acp/schema";
+import { HostProcessPlatform } from "@t3tools/shared/hostProcess";
 import { normalizeModelSlug } from "@t3tools/shared/model";
 
 import * as AcpSessionRuntime from "./AcpSessionRuntime.ts";
@@ -68,6 +70,21 @@ function resolveGrokAuthMethodId(environment: NodeJS.ProcessEnv | undefined): st
     : GROK_AUTH_METHOD_CACHED_TOKEN;
 }
 
+export function grokAcpRuntimeProcessOwnership(
+  processGroupPlatform: NodeJS.Platform,
+): Pick<
+  AcpSessionRuntime.AcpSessionRuntimeOptions,
+  "ownDescendantProcessGroups" | "ownDetachedProcessGroup" | "processGroupPlatform"
+> {
+  return {
+    // macOS keeps the prior provider-group teardown until a stable libproc
+    // identity provider can cover Grok's nested detached tool groups.
+    ownDescendantProcessGroups: processGroupPlatform === "linux",
+    ownDetachedProcessGroup: true,
+    processGroupPlatform,
+  };
+}
+
 export const makeGrokAcpRuntime = (
   input: GrokAcpRuntimeInput,
 ): Effect.Effect<
@@ -76,6 +93,9 @@ export const makeGrokAcpRuntime = (
   Crypto.Crypto | Scope.Scope
 > =>
   Effect.gen(function* () {
+    const processGroupPlatform = yield* HostProcessPlatform.pipe(
+      Effect.provide(NodeServices.layer),
+    );
     const acpContext = yield* Layer.build(
       AcpSessionRuntime.layer({
         ...input,
@@ -86,6 +106,10 @@ export const makeGrokAcpRuntime = (
           input.runtimeMode,
         ),
         authMethodId: resolveGrokAuthMethodId(input.environment),
+        // Current Grok treats Ctrl+C cancellation as a barrier against stale
+        // background-task wake prompts until the next genuine user turn.
+        cancelMeta: { ...input.cancelMeta, cancelTrigger: "ctrl_c" },
+        ...grokAcpRuntimeProcessOwnership(processGroupPlatform),
       }).pipe(
         Layer.provide(
           Layer.succeed(ChildProcessSpawner.ChildProcessSpawner, input.childProcessSpawner),
diff --git a/apps/server/src/provider/acp/XAiAcpExtension.test.ts b/apps/server/src/provider/acp/XAiAcpExtension.test.ts
index 28f5f29f4987..31ccac4a0597 100644
--- a/apps/server/src/provider/acp/XAiAcpExtension.test.ts
+++ b/apps/server/src/provider/acp/XAiAcpExtension.test.ts
@@ -1,50 +1,1080 @@
-// @effect-diagnostics nodeBuiltinImport:off
+// @effect-diagnostics nodeBuiltinImport:off -- plan-path tests resolve the OS home dir.
 import * as NodeOS from "node:os";
-import * as NodePath from "node:path";
-import * as NodeURL from "node:url";
-
-import * as NodeServices from "@effect/platform-node/NodeServices";
 import { it } from "@effect/vitest";
+import * as Deferred from "effect/Deferred";
 import * as Effect from "effect/Effect";
+import * as Fiber from "effect/Fiber";
 import * as Schema from "effect/Schema";
 import { describe, expect } from "vite-plus/test";
 
 import {
+  XAiExitPlanModeRequest,
+  XAI_EMPTY_PLAN_MARKDOWN,
+  makeXAiExitPlanModeCapturedResponse,
+  isGrokPlanMarkdownPath,
+  extractXAiExitPlanMarkdown,
   extractGrokPlanMarkdownFromToolCallData,
+  extractXAiAcpBackgroundToolMutation,
+  extractXAiAcpSubagentEndNotice,
+  extractXAiAcpSubagentUpdate,
   extractXAiAskUserQuestions,
-  extractXAiExitPlanMarkdown,
-  isGrokPlanMarkdownPath,
+  extractXAiBackgroundTaskCompletion,
+  extractXAiKilledBackgroundTasks,
+  extractXAiMonitorTaskId,
+  isGenericAcpToolTitle,
+  isXAiMonitorTool,
+  isXAiPersistentMonitor,
   makeXAiAskUserQuestionCancelledResponse,
   makeXAiAskUserQuestionResponse,
-  makeXAiExitPlanModeCapturedResponse,
   makeXAiPromptCompletionRuntime,
-  XAI_EMPTY_PLAN_MARKDOWN,
+  normalizeXAiAcpToolCallState,
+  registerXAiBackgroundTaskTracking,
+  resolveXAiAcpToolTitle,
+  xAiBackgroundTaskLifecycleMutation,
+  xAiPromptCompleteFromSessionUpdate,
   XAiAskUserQuestionRequest,
-  XAiExitPlanModeRequest,
 } from "./XAiAcpExtension.ts";
 import * as AcpSessionRuntime from "./AcpSessionRuntime.ts";
 
-const __dirname = NodePath.dirname(NodeURL.fileURLToPath(import.meta.url));
-const mockAgentPath = NodePath.join(__dirname, "../../../scripts/acp-mock-agent.ts");
+const decodeXAiAskUserQuestionRequest = Schema.decodeUnknownSync(XAiAskUserQuestionRequest);
 
-const makePromptCompletionRuntime = (env: NodeJS.ProcessEnv) =>
-  Effect.gen(function* () {
-    const runtime = yield* AcpSessionRuntime.make({
-      spawn: {
-        command: process.execPath,
-        args: [mockAgentPath],
-        env,
-      },
-      cwd: process.cwd(),
-      clientInfo: { name: "t3-test", version: "0.0.0" },
-      authMethodId: "test",
+describe("xAiPromptCompleteFromSessionUpdate", () => {
+  it("maps live turn_completed snake_case payloads", () => {
+    expect(
+      xAiPromptCompleteFromSessionUpdate({
+        sessionId: "019f4428-4bf1-7e52-b7c6-c29b506543b1",
+        update: {
+          sessionUpdate: "turn_completed",
+          prompt_id: "t3-xai-prompt-1",
+          stop_reason: "end_turn",
+        },
+      }),
+    ).toEqual({
+      sessionId: "019f4428-4bf1-7e52-b7c6-c29b506543b1",
+      promptId: "t3-xai-prompt-1",
+      stopReason: "end_turn",
     });
-    return yield* makeXAiPromptCompletionRuntime(runtime);
   });
 
-const decodeXAiAskUserQuestionRequest = Schema.decodeUnknownSync(XAiAskUserQuestionRequest);
+  it("ignores non-turn updates and task-completed prompt ids", () => {
+    expect(
+      xAiPromptCompleteFromSessionUpdate({
+        sessionId: "root",
+        update: { sessionUpdate: "hook_execution", prompt_id: "t3-xai-prompt-1" },
+      }),
+    ).toBeNull();
+    expect(
+      xAiPromptCompleteFromSessionUpdate({
+        sessionId: "root",
+        update: {
+          sessionUpdate: "turn_completed",
+          prompt_id: "task-completed-call-abc",
+          stop_reason: "end_turn",
+        },
+      }),
+    ).toBeNull();
+    expect(
+      xAiPromptCompleteFromSessionUpdate({
+        sessionId: "root",
+        update: { sessionUpdate: "turn_completed", stop_reason: "end_turn" },
+      }),
+    ).toBeNull();
+  });
+});
 
 describe("XAiAcpExtension", () => {
+  it("recognizes Grok Task starts as native subagents", () => {
+    expect(
+      extractXAiAcpSubagentUpdate({
+        toolCallId: "task-1",
+        title: "Task",
+        status: "inProgress",
+        data: {
+          rawInput: {
+            description: "Explore server architecture",
+            prompt: "Audit apps/server.",
+            subagent_type: "generalPurpose",
+            model: "composer-2.5-fast",
+          },
+        },
+      }),
+    ).toEqual({
+      nativeTaskId: "task-1",
+      prompt: "Audit apps/server.",
+      title: "Explore server architecture",
+      model: "composer-2.5-fast",
+      status: "running",
+      childSessionId: null,
+      result: null,
+      suppressNormalTool: true,
+    });
+  });
+
+  it("extracts Grok child session lineage from completed Task output", () => {
+    expect(
+      extractXAiAcpSubagentUpdate({
+        toolCallId: "task-1",
+        title: "Task",
+        status: "completed",
+        data: {
+          rawInput: {
+            description: "Explore server architecture",
+            prompt: "Audit apps/server.",
+            subagent_type: "generalPurpose",
+          },
+          rawOutput: {
+            type: "Text",
+            text: [
+              "Server audit complete.",
+              "",
+              "Agent ID: 019f0220-e192-7c41-9e9d-b406bc3459c8 (resume supported)",
+            ].join("\n"),
+          },
+        },
+      }),
+    ).toEqual({
+      nativeTaskId: "task-1",
+      prompt: "Audit apps/server.",
+      title: "Explore server architecture",
+      model: null,
+      status: "completed",
+      childSessionId: "019f0220-e192-7c41-9e9d-b406bc3459c8",
+      result: "Server audit complete.",
+      suppressNormalTool: true,
+    });
+  });
+
+  it("keeps async spawn_subagent ACKs running and binds subagent_id", () => {
+    expect(
+      extractXAiAcpSubagentUpdate({
+        toolCallId: "call-spawn-1",
+        title: "spawn_subagent",
+        status: "completed",
+        data: {
+          rawInput: {
+            description: "Demo subagent wait and ls",
+            prompt: "Wait then ls.",
+            subagent_type: "general-purpose",
+          },
+          rawOutput: {
+            type: "Text",
+            text: [
+              "Subagent started in background.",
+              "subagent_id: 019f44a6-4820-7402-925d-bc862ee711dd",
+              "type: general-purpose",
+              "description: Demo subagent wait and ls",
+              "",
+              'Use get_command_or_subagent_output with task_ids=["019f44a6-4820-7402-925d-bc862ee711dd"] and timeout_ms to wait for results.',
+            ].join("\n"),
+          },
+        },
+      }),
+    ).toEqual({
+      nativeTaskId: "call-spawn-1",
+      prompt: "Wait then ls.",
+      title: "Demo subagent wait and ls",
+      model: null,
+      status: "running",
+      childSessionId: "019f44a6-4820-7402-925d-bc862ee711dd",
+      result: null,
+      suppressNormalTool: true,
+    });
+  });
+
+  it("hydrates subagent completion from get_command_or_subagent_output", () => {
+    expect(
+      extractXAiAcpSubagentUpdate({
+        toolCallId: "call-get-1",
+        title: "get_command_or_subagent_output",
+        status: "completed",
+        data: {
+          rawInput: {
+            task_ids: ["019f44a6-4820-7402-925d-bc862ee711dd"],
+            timeout_ms: 30000,
+          },
+          rawOutput: {
+            type: "Text",
+            text: [
+              "=== Task 019f44a6-4820-7402-925d-bc862ee711dd ===",
+              "Status: completed",
+              "Exit Code: 0",
+              "",
+              "=== Output ===",
+              "SUBAGENT_MARKER: 35 entries",
+            ].join("\n"),
+          },
+        },
+      }),
+    ).toEqual({
+      nativeTaskId: "call-get-1",
+      prompt: "",
+      title: null,
+      model: null,
+      status: "completed",
+      childSessionId: "019f44a6-4820-7402-925d-bc862ee711dd",
+      result: "SUBAGENT_MARKER: 35 entries",
+      suppressNormalTool: true,
+    });
+  });
+
+  it("attributes multi-task get_output envelopes to the result task_id", () => {
+    expect(
+      extractXAiAcpSubagentUpdate({
+        toolCallId: "call-get-multi",
+        title: "get_command_or_subagent_output",
+        status: "completed",
+        data: {
+          rawInput: {
+            task_ids: [
+              "019f44a6-4820-7402-925d-bc862ee711dd",
+              "019f44b0-1b73-7f32-bb1b-1ff696f536e3",
+            ],
+            timeout_ms: 30000,
+          },
+          rawOutput: {
+            type: "TaskOutput",
+            Result: {
+              task_id: "019f44b0-1b73-7f32-bb1b-1ff696f536e3",
+              status: "completed",
+              exit_code: 0,
+              output: "SECOND_SUB_DONE\n",
+            },
+          },
+        },
+      }),
+    ).toMatchObject({
+      childSessionId: "019f44b0-1b73-7f32-bb1b-1ff696f536e3",
+      status: "completed",
+      result: "SECOND_SUB_DONE",
+    });
+  });
+
+  it("does not treat a subagent_id mentioned in result text as the completed identity", () => {
+    const requestedTaskId = "019f44a6-4820-7402-925d-bc862ee711dd";
+    const mentionedTaskId = "019f44b0-1b73-7f32-bb1b-1ff696f536e3";
+    const toolCall = {
+      toolCallId: "call-get-mentioned-id",
+      title: "get_command_or_subagent_output",
+      status: "completed" as const,
+      data: {
+        rawInput: {
+          variant: "TaskOutput",
+          task_ids: [requestedTaskId],
+        },
+        rawOutput: {
+          type: "TaskOutput",
+          Result: {
+            status: "completed",
+            exit_code: 0,
+            output: `Audited subagent_id: ${mentionedTaskId}; no issues found.`,
+          },
+        },
+      },
+    };
+
+    expect(extractXAiAcpSubagentUpdate(toolCall)).toMatchObject({
+      childSessionId: requestedTaskId,
+      status: "completed",
+    });
+    expect(extractXAiBackgroundTaskCompletion(toolCall)).toEqual([
+      {
+        taskId: requestedTaskId,
+        status: "completed",
+        appendOutput: `Audited subagent_id: ${mentionedTaskId}; no issues found.`,
+      },
+    ]);
+  });
+
+  it("hydrates structured ACP TaskOutput tool envelopes", () => {
+    expect(
+      extractXAiAcpSubagentUpdate({
+        toolCallId: "call-get-2",
+        title: "[subagent:general-purpose] Sleep then return SUBAGENT_DONE (019f44b0)",
+        status: "completed",
+        data: {
+          rawInput: {
+            variant: "TaskOutput",
+            task_ids: ["019f44b0-1b73-7f32-bb1b-1ff696f536e3"],
+            timeout_ms: 20000,
+          },
+          rawOutput: {
+            type: "TaskOutput",
+            Result: {
+              task_id: "019f44b0-1b73-7f32-bb1b-1ff696f536e3",
+              status: "completed",
+              exit_code: 0,
+              output:
+                "SUBAGENT_DONE\n\n<subagent_meta>id=019f44b0-1b73-7f32-bb1b-1ff696f536e3</subagent_meta>\n",
+            },
+          },
+        },
+      }),
+    ).toEqual({
+      nativeTaskId: "call-get-2",
+      prompt: "",
+      title: null,
+      model: null,
+      status: "completed",
+      childSessionId: "019f44b0-1b73-7f32-bb1b-1ff696f536e3",
+      result: "SUBAGENT_DONE",
+      suppressNormalTool: true,
+    });
+  });
+
+  it("does not leak raw machine tags when get_output is only meta/result blocks", () => {
+    const metaOnlyToolCall = {
+      toolCallId: "call-get-meta-only",
+      title: "get_command_or_subagent_output",
+      status: "completed" as const,
+      data: {
+        rawInput: {
+          variant: "TaskOutput",
+          task_ids: ["019f44b0-1b73-7f32-bb1b-1ff696f536e3"],
+          timeout_ms: 20000,
+        },
+        rawOutput: {
+          type: "TaskOutput",
+          Result: {
+            task_id: "019f44b0-1b73-7f32-bb1b-1ff696f536e3",
+            status: "completed",
+            exit_code: 0,
+            output:
+              "<subagent_meta>id=019f44b0-1b73-7f32-bb1b-1ff696f536e3</subagent_meta>\n<subagent_result>done</subagent_result>\n",
+          },
+        },
+      },
+    };
+    expect(extractXAiAcpSubagentUpdate(metaOnlyToolCall)).toEqual({
+      nativeTaskId: "call-get-meta-only",
+      prompt: "",
+      title: null,
+      model: null,
+      status: "completed",
+      childSessionId: "019f44b0-1b73-7f32-bb1b-1ff696f536e3",
+      result: null,
+      suppressNormalTool: true,
+    });
+    expect(extractXAiBackgroundTaskCompletion(metaOnlyToolCall)).toEqual([
+      {
+        taskId: "019f44b0-1b73-7f32-bb1b-1ff696f536e3",
+        status: "completed",
+        appendOutput: "",
+      },
+    ]);
+  });
+
+  it("keeps monitor start ACKs running and extracts task ids", () => {
+    const toolCall = {
+      toolCallId: "call-mon-1",
+      title: "monitor",
+      status: "completed" as const,
+      data: {
+        rawInput: {
+          command: "echo mon_line_1",
+          description: "Demo monitor",
+        },
+        rawOutput: {
+          type: "Text",
+          text: "Monitor started (task 019f44a5-87d1-7640-8e35-6a4667ffc873, timeout 36000000ms).\nYou will be notified on each event.",
+        },
+      },
+    };
+    expect(normalizeXAiAcpToolCallState(toolCall).status).toBe("inProgress");
+    expect(extractXAiMonitorTaskId(toolCall)).toBe("019f44a5-87d1-7640-8e35-6a4667ffc873");
+  });
+
+  it("tracks text Monitor ACKs with generic titles and description-only input", () => {
+    const toolCall = {
+      toolCallId: "call-mon-generic-text",
+      title: "Tool",
+      status: "completed" as const,
+      data: {
+        rawInput: {
+          command: "echo mon_line_1",
+          description: "Demo monitor without variant",
+        },
+        rawOutput: {
+          type: "Text",
+          text: "Monitor started (task 019f44a5-87d1-7640-8e35-6a4667ffc873, timeout 36000000ms).\nYou will be notified on each event.",
+        },
+      },
+    };
+
+    const normalized = normalizeXAiAcpToolCallState(toolCall);
+    expect(isXAiMonitorTool(normalized)).toBe(true);
+    expect(normalized.status).toBe("inProgress");
+    expect(extractXAiMonitorTaskId(normalized)).toBe("019f44a5-87d1-7640-8e35-6a4667ffc873");
+  });
+
+  it("completes Monitor variant tools from structured Bash exit codes", () => {
+    const toolCall = {
+      toolCallId: "call-mon-2",
+      title: "Tool",
+      status: "inProgress" as const,
+      data: {
+        rawInput: {
+          variant: "Monitor",
+          command: "echo MON_DONE",
+          description: "Stream mon lines",
+        },
+        rawOutput: {
+          type: "Bash",
+          output: Array.from(new TextEncoder().encode("mon_line_1\nMON_DONE\n")),
+          output_for_prompt: "mon_line_1\nMON_DONE\n",
+          exit_code: 0,
+        },
+      },
+    };
+    expect(isXAiMonitorTool(toolCall)).toBe(true);
+    expect(normalizeXAiAcpToolCallState(toolCall).status).toBe("completed");
+  });
+
+  it("detects Monitor start ACKs from structured rawOutput when title is generic", () => {
+    const toolCall = {
+      toolCallId: "call-mon-generic-title",
+      title: "Tool",
+      status: "completed" as const,
+      data: {
+        rawInput: {
+          command: "echo mon_line",
+          description: "Demo monitor without variant",
+        },
+        rawOutput: {
+          type: "Monitor",
+          taskId: "019f44a5-87d1-7640-8e35-6a4667ffc873",
+          timeoutMs: 36000000,
+          persistent: false,
+        },
+      },
+    };
+    expect(isXAiMonitorTool(toolCall)).toBe(true);
+    expect(normalizeXAiAcpToolCallState(toolCall).status).toBe("inProgress");
+    expect(extractXAiMonitorTaskId(toolCall)).toBe("019f44a5-87d1-7640-8e35-6a4667ffc873");
+  });
+
+  it("completes wake re-reports of finished commands despite generic titles", () => {
+    // Post-settle wake replay: the finished monitor is re-reported with empty
+    // rawInput and a generic title, so monitor detection cannot match; the
+    // structured Bash result with exit_code must still terminalize it.
+    const toolCall = {
+      toolCallId: "call-wake-1",
+      title: "Tool",
+      status: "inProgress" as const,
+      data: {
+        rawInput: {},
+        rawOutput: {
+          type: "Bash",
+          output: Array.from(new TextEncoder().encode("STREAM_1\nSTREAM_DONE\n")),
+          output_for_prompt: "STREAM_1\nSTREAM_DONE\n",
+          exit_code: 0,
+          command: "for i in 1 2; do echo STREAM_$i; done; echo STREAM_DONE",
+        },
+      },
+    };
+    expect(isXAiMonitorTool(toolCall)).toBe(false);
+    const normalized = normalizeXAiAcpToolCallState(toolCall);
+    expect(normalized.status).toBe("completed");
+    expect(normalized.title).toBe("for i in 1 2; do echo STREAM_$i; done; echo STREAM_DONE");
+    expect(
+      normalizeXAiAcpToolCallState({
+        ...toolCall,
+        data: {
+          ...toolCall.data,
+          rawOutput: { ...toolCall.data.rawOutput, exit_code: 2 },
+        },
+      }).status,
+    ).toBe("failed");
+  });
+
+  it("keeps empty successful Bash updates running until native output or turn settlement", () => {
+    const normalized = normalizeXAiAcpToolCallState({
+      toolCallId: "call-bash-permission-ack",
+      title: "Ran command",
+      status: "completed",
+      data: {
+        rawInput: { command: "sleep 40" },
+        rawOutput: { type: "Bash", exit_code: 0 },
+      },
+    });
+    expect(normalized.status).toBe("inProgress");
+  });
+
+  it("keeps structured Monitor start ACKs running and extracts taskId", () => {
+    const toolCall = {
+      toolCallId: "call-mon-3",
+      title: "Start monitor: Wait 30s then list directory",
+      status: "completed" as const,
+      data: {
+        rawInput: {
+          variant: "Monitor",
+          command: "sleep 30 && ls",
+          description: "Wait 30s then list directory",
+        },
+        rawOutput: {
+          type: "Monitor",
+          taskId: "019f44b8-8e98-7c80-a40e-df1e26a5f9e3",
+          timeoutMs: 36000000,
+          persistent: false,
+        },
+      },
+    };
+    expect(normalizeXAiAcpToolCallState(toolCall).status).toBe("inProgress");
+    expect(extractXAiMonitorTaskId(toolCall)).toBe("019f44b8-8e98-7c80-a40e-df1e26a5f9e3");
+  });
+
+  it("replaces generic ACP titles with description / Monitor labels", () => {
+    expect(isGenericAcpToolTitle("Tool")).toBe(true);
+    expect(isGenericAcpToolTitle("Read package.json")).toBe(false);
+    expect(
+      resolveXAiAcpToolTitle({
+        toolCallId: "call-mon-title",
+        title: "Tool",
+        status: "completed",
+        data: {
+          rawInput: {
+            variant: "Monitor",
+            command: "sleep 30 && ls",
+            description: "Wait 30s then list directory",
+          },
+        },
+      }),
+    ).toBe("Monitor: Wait 30s then list directory");
+    const normalized = normalizeXAiAcpToolCallState({
+      toolCallId: "call-mon-title",
+      title: "Tool",
+      status: "completed",
+      data: {
+        rawInput: {
+          variant: "Monitor",
+          command: "sleep 30 && ls",
+          description: "Wait 30s then list directory",
+        },
+        rawOutput: {
+          type: "Monitor",
+          taskId: "019f44b8-8e98-7c80-a40e-df1e26a5f9e3",
+          timeoutMs: 36000000,
+          persistent: false,
+        },
+      },
+    });
+    expect(normalized.title).toBe("Monitor: Wait 30s then list directory");
+    expect(normalized.status).toBe("inProgress");
+    // Non-generic titles from the CLI are preserved.
+    expect(
+      resolveXAiAcpToolTitle({
+        toolCallId: "call-read",
+        title: "Read package.json",
+        status: "inProgress",
+        data: { rawInput: { path: "package.json" } },
+      }),
+    ).toBe("Read package.json");
+  });
+
+  it("hydrates monitor completion from TaskOutput get_command envelopes", () => {
+    expect(
+      extractXAiBackgroundTaskCompletion({
+        toolCallId: "call-get-mon",
+        title: "Wait 30s then list directory",
+        status: "completed",
+        data: {
+          rawInput: {
+            variant: "TaskOutput",
+            task_ids: ["019f44b8-8e98-7c80-a40e-df1e26a5f9e3"],
+          },
+          rawOutput: {
+            type: "TaskOutput",
+            Result: {
+              task_id: "019f44b8-8e98-7c80-a40e-df1e26a5f9e3",
+              command: "[monitor] Wait 30s then list directory",
+              status: "completed",
+              exit_code: 0,
+              output: "agents\nAGENTS.md\nnotes\n",
+            },
+          },
+        },
+      }),
+    ).toEqual([
+      {
+        taskId: "019f44b8-8e98-7c80-a40e-df1e26a5f9e3",
+        status: "completed",
+        appendOutput: "agents\nAGENTS.md\nnotes",
+      },
+    ]);
+  });
+
+  it("hydrates monitor completion from a standalone TaskOutput frame without rawInput", () => {
+    // Post-settle shape observed live (2026-07-12): the final
+    // get_command_or_subagent_output update carries only rawOutput; the frame
+    // is parsed in isolation (no in-turn merge), and this completion is the
+    // ONLY end signal when the agent consumed the output itself (no "Monitor
+    // ended" reminder follows).
+    expect(
+      extractXAiBackgroundTaskCompletion({
+        toolCallId: "call-c29e64dd-ce5d-4eac-a6ca-c20513fefac3-1",
+        title: "[monitor] Stream numbered markers every 3s (019f54a0)",
+        status: "completed",
+        data: {
+          rawOutput: {
+            type: "TaskOutput",
+            Result: {
+              task_id: "019f54a0-06a8-77f2-8214-e24937cad564",
+              command: "[monitor] Stream numbered markers every 3s",
+              status: "completed",
+              exit_code: 0,
+              output: "STREAM_1\nSTREAM_DONE\n",
+            },
+          },
+        },
+      }),
+    ).toMatchObject([
+      {
+        taskId: "019f54a0-06a8-77f2-8214-e24937cad564",
+        status: "completed",
+      },
+    ]);
+  });
+
+  it("hydrates every requested monitor when TaskOutput has no result task_id", () => {
+    expect(
+      extractXAiBackgroundTaskCompletion({
+        toolCallId: "call-get-multi-mon",
+        title: "get_command_or_subagent_output",
+        status: "completed",
+        data: {
+          rawInput: {
+            variant: "TaskOutput",
+            task_ids: [
+              "019f44a6-4820-7402-925d-bc862ee711dd",
+              "019f44b0-1b73-7f32-bb1b-1ff696f536e3",
+            ],
+          },
+          rawOutput: {
+            type: "TaskOutput",
+            Result: {
+              status: "completed",
+              exit_code: 0,
+              output: "BOTH_DONE\n",
+            },
+          },
+        },
+      }),
+    ).toEqual([
+      {
+        taskId: "019f44a6-4820-7402-925d-bc862ee711dd",
+        status: "completed",
+        appendOutput: "BOTH_DONE",
+      },
+      {
+        taskId: "019f44b0-1b73-7f32-bb1b-1ff696f536e3",
+        status: "completed",
+        appendOutput: "BOTH_DONE",
+      },
+    ]);
+  });
+
+  it("keeps every requested monitor running when a completed poll has no terminal task status", () => {
+    expect(
+      extractXAiBackgroundTaskCompletion({
+        toolCallId: "call-get-running-monitors",
+        title: "get_command_or_subagent_output",
+        status: "completed",
+        data: {
+          rawInput: {
+            variant: "TaskOutput",
+            task_ids: [
+              "019f44a6-4820-7402-925d-bc862ee711dd",
+              "019f44b0-1b73-7f32-bb1b-1ff696f536e3",
+            ],
+          },
+          rawOutput: {
+            type: "TaskOutput",
+            Result: {
+              output: "No task has reached a terminal state.",
+            },
+          },
+        },
+      }),
+    ).toEqual([
+      {
+        taskId: "019f44a6-4820-7402-925d-bc862ee711dd",
+        status: "running",
+        appendOutput: "No task has reached a terminal state.",
+      },
+      {
+        taskId: "019f44b0-1b73-7f32-bb1b-1ff696f536e3",
+        status: "running",
+        appendOutput: "No task has reached a terminal state.",
+      },
+    ]);
+  });
+
+  it("treats Exit Code: -1 text envelopes as failed", () => {
+    expect(
+      extractXAiBackgroundTaskCompletion({
+        toolCallId: "call-get-neg",
+        title: "get_command_or_subagent_output",
+        status: "completed",
+        data: {
+          rawInput: {
+            variant: "TaskOutput",
+            task_ids: ["019f44b8-8e98-7c80-a40e-df1e26a5f9e3"],
+          },
+          rawOutput: {
+            type: "Text",
+            text: ["=== Task 019f44b8-8e98-7c80-a40e-df1e26a5f9e3 ===", "Exit Code: -1"].join("\n"),
+          },
+        },
+      }),
+    ).toMatchObject([
+      {
+        taskId: "019f44b8-8e98-7c80-a40e-df1e26a5f9e3",
+        status: "failed",
+      },
+    ]);
+  });
+
+  it("tombstones confirmed kills and ignores failed kill calls", () => {
+    expect(
+      extractXAiKilledBackgroundTasks({
+        toolCallId: "call-kill-1",
+        title: "kill_command_or_subagent",
+        status: "completed",
+        data: {
+          rawInput: {
+            variant: "Kill",
+            task_ids: ["call-bg-1", "call-bg-2", "call-bg-1"],
+          },
+        },
+      }),
+    ).toEqual([
+      { taskId: "call-bg-1", status: "completed", appendOutput: "" },
+      { taskId: "call-bg-2", status: "completed", appendOutput: "" },
+    ]);
+    // Singular task_id shape, matched by variant when the title is generic.
+    expect(
+      extractXAiKilledBackgroundTasks({
+        toolCallId: "call-kill-2",
+        title: "Tool",
+        status: "failed",
+        data: { rawInput: { variant: "kill", task_id: "call-bg-3" } },
+      }),
+    ).toEqual([]);
+    // In-flight kill calls and unrelated tools contribute nothing.
+    expect(
+      extractXAiKilledBackgroundTasks({
+        toolCallId: "call-kill-3",
+        title: "kill_command_or_subagent",
+        status: "inProgress",
+        data: { rawInput: { task_ids: ["call-bg-4"] } },
+      }),
+    ).toEqual([]);
+    expect(
+      extractXAiKilledBackgroundTasks({
+        toolCallId: "call-get",
+        title: "get_command_or_subagent_output",
+        status: "completed",
+        data: { rawInput: { variant: "TaskOutput", task_ids: ["call-bg-5"] } },
+      }),
+    ).toEqual([]);
+  });
+
+  it("maps task lifecycle notifications to background mutations", () => {
+    // task_backgrounded carries the cancelled call's tool_call_id as task_id.
+    expect(
+      xAiBackgroundTaskLifecycleMutation(
+        {
+          sessionId: "session-1",
+          update: {
+            sessionUpdate: "task_backgrounded",
+            tool_call_id: "call-bg-1",
+            task_id: "call-bg-1",
+          },
+        },
+        "running",
+      ),
+    ).toEqual({ sessionId: "session-1", taskId: "call-bg-1", status: "running" });
+    // task_completed nests the id inside task_snapshot.
+    expect(
+      xAiBackgroundTaskLifecycleMutation(
+        {
+          sessionId: "session-1",
+          update: {
+            sessionUpdate: "task_completed",
+            task_snapshot: { task_id: "call-bg-1" },
+          },
+        },
+        "completed",
+      ),
+    ).toEqual({ sessionId: "session-1", taskId: "call-bg-1", status: "completed" });
+    expect(
+      xAiBackgroundTaskLifecycleMutation(
+        { sessionId: "session-1", update: { sessionUpdate: "task_completed" } },
+        "completed",
+      ),
+    ).toBeNull();
+  });
+
+  it.effect("tracks canonical Grok task lifecycle notifications", () =>
+    Effect.gen(function* () {
+      const handlers = new Map<string, (notification: unknown) => Effect.Effect<void>>();
+      const mutations: Array<{
+        readonly sessionId: string;
+        readonly taskId: string;
+        readonly status: "running" | "completed";
+      }> = [];
+      const runtime = {
+        handleExtNotification: (
+          method: string,
+          _schema: unknown,
+          handler: (notification: unknown) => Effect.Effect<void>,
+        ) => {
+          handlers.set(method, handler);
+          return Effect.void;
+        },
+      } as unknown as Pick<AcpSessionRuntime.AcpSessionRuntime["Service"], "handleExtNotification">;
+
+      yield* registerXAiBackgroundTaskTracking(runtime, (mutation) =>
+        Effect.sync(() => mutations.push(mutation)),
+      );
+
+      const backgrounded = handlers.get("x.ai/task_backgrounded");
+      const completed = handlers.get("x.ai/task_completed");
+      expect(backgrounded).toBeDefined();
+      expect(completed).toBeDefined();
+      yield* backgrounded!({
+        sessionId: "session-1",
+        update: {
+          sessionUpdate: "task_backgrounded",
+          tool_call_id: "call-bg-1",
+          task_id: "task-bg-1",
+        },
+      });
+      yield* completed!({
+        sessionId: "session-1",
+        update: {
+          sessionUpdate: "task_completed",
+          task_snapshot: { task_id: "task-bg-1" },
+        },
+      });
+      expect(mutations).toEqual([
+        { sessionId: "session-1", taskId: "task-bg-1", status: "running" },
+        { sessionId: "session-1", taskId: "task-bg-1", status: "completed" },
+      ]);
+      expect(handlers.has("_x.ai/task_backgrounded")).toBe(true);
+      expect(handlers.has("_x.ai/task_completed")).toBe(true);
+    }),
+  );
+
+  it("detects persistent Monitor start ACKs", () => {
+    expect(
+      isXAiPersistentMonitor({
+        toolCallId: "call-mon-persist",
+        title: "Monitor",
+        status: "completed",
+        data: {
+          rawInput: { variant: "Monitor" },
+          rawOutput: {
+            type: "Monitor",
+            taskId: "019f44b8-8e98-7c80-a40e-df1e26a5f9e3",
+            timeoutMs: 36000000,
+            persistent: true,
+          },
+        },
+      }),
+    ).toBe(true);
+    expect(
+      isXAiPersistentMonitor({
+        toolCallId: "call-mon-ephemeral",
+        title: "Monitor",
+        status: "completed",
+        data: {
+          rawInput: { variant: "Monitor" },
+          rawOutput: {
+            type: "Monitor",
+            taskId: "019f44b8-8e98-7c80-a40e-df1e26a5f9e3",
+            timeoutMs: 36000000,
+            persistent: false,
+          },
+        },
+      }),
+    ).toBe(false);
+  });
+
+  it("keeps a standalone TaskOutput completion terminal through normalize", () => {
+    // Must remain offer evidence post-settle: normalize must not demote it to
+    // inProgress the way monitor start ACKs are.
+    expect(
+      normalizeXAiAcpToolCallState({
+        toolCallId: "call-c29e64dd-ce5d-4eac-a6ca-c20513fefac3-1",
+        title: "[monitor] Stream numbered markers every 3s (019f54a0)",
+        status: "completed",
+        data: {
+          rawOutput: {
+            type: "TaskOutput",
+            Result: {
+              task_id: "019f54a0-06a8-77f2-8214-e24937cad564",
+              status: "completed",
+              exit_code: 0,
+              output: "STREAM_DONE\n",
+            },
+          },
+        },
+      }).status,
+    ).toBe("completed");
+  });
+
+  it("parses monitor event lines and end reminders", () => {
+    expect(
+      extractXAiAcpBackgroundToolMutation(
+        '<monitor-event task_id="019f44a5-87d1-7640-8e35-6a4667ffc873">\n[Demo] mon_line_1\n</monitor-event>',
+      ),
+    ).toEqual([
+      {
+        taskId: "019f44a5-87d1-7640-8e35-6a4667ffc873",
+        status: "running",
+        appendOutput: "[Demo] mon_line_1\n",
+      },
+    ]);
+    expect(
+      extractXAiAcpBackgroundToolMutation(
+        [
+          "<system-reminder>",
+          'Monitor "019f44a5-87d1-7640-8e35-6a4667ffc873" ended: [monitor ended: exited (code 0)].',
+          "Description: Demo monitor",
+          "</system-reminder>",
+        ].join("\n"),
+      ),
+    ).toMatchObject([
+      {
+        taskId: "019f44a5-87d1-7640-8e35-6a4667ffc873",
+        status: "completed",
+      },
+    ]);
+    // Description/output may contain "error" without meaning the monitor failed.
+    expect(
+      extractXAiAcpBackgroundToolMutation(
+        [
+          "<system-reminder>",
+          'Monitor "019f44a5-87d1-7640-8e35-6a4667ffc873" ended: [monitor ended: exited (code 0)].',
+          "Description: watch error logs for failed deploys",
+          "error: nothing found",
+          "</system-reminder>",
+        ].join("\n"),
+      ),
+    ).toMatchObject([
+      {
+        taskId: "019f44a5-87d1-7640-8e35-6a4667ffc873",
+        status: "completed",
+      },
+    ]);
+  });
+
+  it("parses every monitor-event and trailing end notice in one chunk", () => {
+    const mutations = extractXAiAcpBackgroundToolMutation(
+      [
+        '<monitor-event task_id="019f44a5-87d1-7640-8e35-6a4667ffc873">',
+        "[Demo] mon_line_1",
+        "</monitor-event>",
+        '<monitor-event task_id="019f44a5-87d1-7640-8e35-6a4667ffc873">',
+        "[Demo] mon_line_2",
+        "</monitor-event>",
+        'Monitor "019f44a5-87d1-7640-8e35-6a4667ffc873" ended: [monitor ended: exited (code 0)].',
+      ].join("\n"),
+    );
+    expect(mutations).toHaveLength(3);
+    expect(mutations[0]).toEqual({
+      taskId: "019f44a5-87d1-7640-8e35-6a4667ffc873",
+      status: "running",
+      appendOutput: "[Demo] mon_line_1\n",
+    });
+    expect(mutations[1]).toEqual({
+      taskId: "019f44a5-87d1-7640-8e35-6a4667ffc873",
+      status: "running",
+      appendOutput: "[Demo] mon_line_2\n",
+    });
+    expect(mutations[2]).toMatchObject({
+      taskId: "019f44a5-87d1-7640-8e35-6a4667ffc873",
+      status: "completed",
+    });
+  });
+
+  it("parses batched monitor event blocks as running mutations", () => {
+    expect(
+      extractXAiAcpBackgroundToolMutation(
+        [
+          "3 monitor events from 1 monitor (use get_command_or_subagent_output to identify each monitor):",
+          "",
+          '<monitor description="Stream STREAM_i every 3s" task_id="019f545d-4d39-7001-b1c8-c7744c448ec1">',
+          "[1] STREAM_7",
+          "[2] STREAM_8",
+          "[3] STREAM_9",
+          "</monitor>",
+        ].join("\n"),
+      ),
+    ).toEqual([
+      {
+        taskId: "019f545d-4d39-7001-b1c8-c7744c448ec1",
+        status: "running",
+        appendOutput: "[1] STREAM_7\n[2] STREAM_8\n[3] STREAM_9\n",
+      },
+    ]);
+  });
+
+  it("parses the subagent completed reminder as an end notice", () => {
+    expect(
+      extractXAiAcpSubagentEndNotice(
+        [
+          "<system-reminder>",
+          'Background subagent "019f5470-bf92-7a90-afb3-5a6cea5b34a3" (general-purpose: "Run sleep then echo token") completed successfully.',
+          "Duration: 28.8s | Tool calls: 1 | Turns: 1",
+          'Use get_task_output("019f5470-bf92-7a90-afb3-5a6cea5b34a3") to see the full output.',
+          "</system-reminder>",
+        ].join("\n"),
+      ),
+    ).toEqual({
+      childSessionId: "019f5470-bf92-7a90-afb3-5a6cea5b34a3",
+      status: "completed",
+    });
+  });
+
+  it("parses a failed subagent reminder as a failed end notice", () => {
+    expect(
+      extractXAiAcpSubagentEndNotice(
+        'Background subagent "019f5470-bf92-7a90-afb3-5a6cea5b34a3" (general-purpose: "Run sleep then echo token") failed.',
+      ),
+    ).toEqual({
+      childSessionId: "019f5470-bf92-7a90-afb3-5a6cea5b34a3",
+      status: "failed",
+    });
+  });
+
+  it("ignores prompt text that merely mentions subagents", () => {
+    expect(
+      extractXAiAcpSubagentEndNotice("Live-test post-settle subagent completion."),
+    ).toBeUndefined();
+    expect(
+      extractXAiAcpSubagentEndNotice(
+        'Background subagent "019f5470-bf92-7a90-afb3-5a6cea5b34a3" (general-purpose: "Run sleep then echo token") is still running.',
+      ),
+    ).toBeUndefined();
+  });
+
+  it("does not treat nested parentheses in the title as the outcome verb", () => {
+    expect(
+      extractXAiAcpSubagentEndNotice(
+        'Background subagent "019f5470-bf92-7a90-afb3-5a6cea5b34a3" (general-purpose: "Check (backend) failed tests") is still running.',
+      ),
+    ).toBeUndefined();
+    expect(
+      extractXAiAcpSubagentEndNotice(
+        'Background subagent "019f5470-bf92-7a90-afb3-5a6cea5b34a3" (general-purpose: "Check (backend) failed tests") completed successfully.',
+      ),
+    ).toEqual({
+      childSessionId: "019f5470-bf92-7a90-afb3-5a6cea5b34a3",
+      status: "completed",
+    });
+  });
+
   it("extracts questions from the real xAI ask_user_question payload shape", () => {
     const questions = extractXAiAskUserQuestions({
       sessionId: "session-1",
@@ -282,82 +1312,403 @@ describe("XAiAcpExtension", () => {
     });
   });
 
-  it.effect("resolves a hung standard prompt from xAI prompt completion", () =>
+  it.effect("settles a hung prompt from a root-session prompt_complete notification", () =>
     Effect.gen(function* () {
-      const runtime = yield* makePromptCompletionRuntime({
-        T3_ACP_EMIT_XAI_PROMPT_COMPLETE_THEN_HANG: "1",
-      });
-      yield* runtime.start();
-
-      const promptResult = yield* runtime.prompt({
-        prompt: [{ type: "text", text: "hi" }],
-      });
-      const promptId = promptResult._meta?.promptId;
+      const handlers = new Map<string, (notification: unknown) => Effect.Effect<void>>();
+      const hungPrompt = yield* Deferred.make<never>();
+      const baseRuntime = {
+        start: () =>
+          Effect.succeed({
+            sessionId: "root-session",
+            initializeResult: {},
+            sessionSetupResult: {},
+            modelConfigId: undefined,
+          }),
+        prompt: () => Deferred.await(hungPrompt),
+        cancel: Effect.void,
+        handleExtNotification: (
+          method: string,
+          _schema: unknown,
+          handler: (notification: unknown) => Effect.Effect<void>,
+        ) => {
+          handlers.set(method, handler);
+          return Effect.void;
+        },
+        handleExtRequest: () => Effect.void,
+      } as unknown as AcpSessionRuntime.AcpSessionRuntime["Service"];
 
-      expect(typeof promptId).toBe("string");
-      expect(promptResult).toMatchObject({
+      const runtime = yield* makeXAiPromptCompletionRuntime(baseRuntime);
+      const promptFiber = yield* runtime
+        .prompt({ prompt: [{ type: "text", text: "hi" }] })
+        .pipe(Effect.forkChild);
+      yield* Effect.yieldNow;
+      const promptCompleteHandler = handlers.get("x.ai/session/prompt_complete");
+      expect(promptCompleteHandler).toBeDefined();
+      yield* promptCompleteHandler!({
+        sessionId: "root-session",
         stopReason: "end_turn",
-        _meta: {
-          sessionId: "mock-session-1",
-          promptId,
-          requestId: promptId,
-        },
       });
-    }).pipe(Effect.scoped, Effect.provide(NodeServices.layer)),
+      const response = yield* Fiber.join(promptFiber);
+      expect(response.stopReason).toBe("end_turn");
+      expect(handlers.has("_x.ai/session/prompt_complete")).toBe(true);
+    }),
   );
 
-  it.effect("fails a hung standard prompt from an xAI rate-limit completion", () =>
+  it.effect("fails a hung prompt from an xAI rate-limit completion (#8358)", () =>
     Effect.gen(function* () {
-      const runtime = yield* makePromptCompletionRuntime({
-        T3_ACP_EMIT_XAI_RATE_LIMIT_THEN_HANG: "1",
-      });
-      yield* runtime.start();
+      const handlers = new Map<string, (notification: unknown) => Effect.Effect<void>>();
+      const hungPrompt = yield* Deferred.make<never>();
+      const baseRuntime = {
+        start: () =>
+          Effect.succeed({
+            sessionId: "root-session",
+            initializeResult: {},
+            sessionSetupResult: {},
+            modelConfigId: undefined,
+          }),
+        prompt: () => Deferred.await(hungPrompt),
+        cancel: Effect.void,
+        handleExtNotification: (
+          method: string,
+          _schema: unknown,
+          handler: (notification: unknown) => Effect.Effect<void>,
+        ) => {
+          handlers.set(method, handler);
+          return Effect.void;
+        },
+        handleExtRequest: () => Effect.void,
+      } as unknown as AcpSessionRuntime.AcpSessionRuntime["Service"];
 
-      const error = yield* Effect.flip(
-        runtime.prompt({
-          prompt: [{ type: "text", text: "hi" }],
-        }),
-      );
+      const runtime = yield* makeXAiPromptCompletionRuntime(baseRuntime);
+      const promptFiber = yield* runtime
+        .prompt({ prompt: [{ type: "text", text: "hi" }] })
+        .pipe(Effect.forkChild);
+      yield* Effect.yieldNow;
 
+      const promptCompleteHandler = handlers.get("x.ai/session/prompt_complete");
+      expect(promptCompleteHandler).toBeDefined();
+      yield* promptCompleteHandler!({
+        sessionId: "root-session",
+        stopReason: "rate_limit",
+      });
+      const error = yield* Fiber.join(promptFiber).pipe(Effect.flip);
       expect(error).toMatchObject({
         _tag: "AcpRequestError",
         code: -32003,
         errorMessage: "Grok usage limit reached. Try again later.",
       });
-    }).pipe(Effect.scoped, Effect.provide(NodeServices.layer)),
+    }),
   );
 
-  it.effect("ignores stale xAI completion from an already settled prompt", () =>
+  it.effect("settles a hung prompt from _x.ai/session/update turn_completed", () =>
     Effect.gen(function* () {
-      const runtime = yield* makePromptCompletionRuntime({
-        T3_ACP_EMIT_STALE_XAI_PROMPT_COMPLETE_BEFORE_SECOND_HANG: "1",
+      const handlers = new Map<string, (notification: unknown) => Effect.Effect<void>>();
+      let capturedMeta: Record<string, unknown> | null | undefined;
+      const hungPrompt = yield* Deferred.make<never>();
+      const baseRuntime = {
+        start: () =>
+          Effect.succeed({
+            sessionId: "root-session",
+            initializeResult: {},
+            sessionSetupResult: {},
+            modelConfigId: undefined,
+          }),
+        prompt: (payload: { readonly _meta?: Record<string, unknown> | null }) => {
+          capturedMeta = payload._meta ?? null;
+          return Deferred.await(hungPrompt);
+        },
+        cancel: Effect.void,
+        handleExtNotification: (
+          method: string,
+          _schema: unknown,
+          handler: (notification: unknown) => Effect.Effect<void>,
+        ) => {
+          handlers.set(method, handler);
+          return Effect.void;
+        },
+        handleExtRequest: () => Effect.void,
+      } as unknown as AcpSessionRuntime.AcpSessionRuntime["Service"];
+
+      const runtime = yield* makeXAiPromptCompletionRuntime(baseRuntime);
+      const promptFiber = yield* runtime
+        .prompt({ prompt: [{ type: "text", text: "hi" }] })
+        .pipe(Effect.forkChild);
+      yield* Effect.yieldNow;
+      const promptId = capturedMeta?.promptId;
+      expect(typeof promptId).toBe("string");
+      const sessionUpdateHandler = handlers.get("_x.ai/session/update");
+      expect(sessionUpdateHandler).toBeDefined();
+      yield* sessionUpdateHandler!({
+        sessionId: "root-session",
+        update: {
+          sessionUpdate: "turn_completed",
+          prompt_id: promptId,
+          stop_reason: "end_turn",
+        },
       });
-      yield* runtime.start();
+      const response = yield* Fiber.join(promptFiber);
+      expect(response.stopReason).toBe("end_turn");
+    }),
+  );
+
+  it.effect("settles a hung prompt from released _x.ai/session_notification turns", () =>
+    Effect.gen(function* () {
+      const handlers = new Map<string, (notification: unknown) => Effect.Effect<void>>();
+      const hungPrompt = yield* Deferred.make<never>();
+      const baseRuntime = {
+        start: () =>
+          Effect.succeed({
+            sessionId: "root-session",
+            initializeResult: {},
+            sessionSetupResult: {},
+            modelConfigId: undefined,
+          }),
+        prompt: () => Deferred.await(hungPrompt),
+        cancel: Effect.void,
+        handleExtNotification: (
+          method: string,
+          _schema: unknown,
+          handler: (notification: unknown) => Effect.Effect<void>,
+        ) => {
+          handlers.set(method, handler);
+          return Effect.void;
+        },
+        handleExtRequest: () => Effect.void,
+      } as unknown as AcpSessionRuntime.AcpSessionRuntime["Service"];
 
-      const firstPromptResult = yield* runtime.prompt({
-        prompt: [{ type: "text", text: "first" }],
+      const runtime = yield* makeXAiPromptCompletionRuntime(baseRuntime);
+      const promptFiber = yield* runtime
+        .prompt({ prompt: [{ type: "text", text: "hi" }] })
+        .pipe(Effect.forkChild);
+      yield* Effect.yieldNow;
+      const sessionNotificationHandler = handlers.get("_x.ai/session_notification");
+      expect(sessionNotificationHandler).toBeDefined();
+      yield* sessionNotificationHandler!({
+        sessionId: "root-session",
+        update: {
+          sessionUpdate: "turn_completed",
+          prompt_id: "t3-xai-prompt-1",
+          stop_reason: "end_turn",
+        },
       });
-      expect(firstPromptResult).toMatchObject({
-        stopReason: "end_turn",
-        _meta: { promptId: "mock-stale-xai-prompt-1" },
+      const response = yield* Fiber.join(promptFiber);
+      expect(response.stopReason).toBe("end_turn");
+      expect(handlers.has("_x.ai/session/update")).toBe(true);
+    }),
+  );
+
+  it.effect("ignores turn_completed for non-pending prompt ids and task completions", () =>
+    Effect.gen(function* () {
+      const handlers = new Map<string, (notification: unknown) => Effect.Effect<void>>();
+      const hungPrompt = yield* Deferred.make<never>();
+      const baseRuntime = {
+        start: () =>
+          Effect.succeed({
+            sessionId: "root-session",
+            initializeResult: {},
+            sessionSetupResult: {},
+            modelConfigId: undefined,
+          }),
+        prompt: () => Deferred.await(hungPrompt),
+        cancel: Effect.void,
+        handleExtNotification: (
+          method: string,
+          _schema: unknown,
+          handler: (notification: unknown) => Effect.Effect<void>,
+        ) => {
+          handlers.set(method, handler);
+          return Effect.void;
+        },
+        handleExtRequest: () => Effect.void,
+      } as unknown as AcpSessionRuntime.AcpSessionRuntime["Service"];
+
+      const runtime = yield* makeXAiPromptCompletionRuntime(baseRuntime);
+      const promptFiber = yield* runtime
+        .prompt({ prompt: [{ type: "text", text: "hi" }] })
+        .pipe(Effect.forkChild);
+      yield* Effect.yieldNow;
+      const sessionUpdateHandler = handlers.get("_x.ai/session/update");
+      expect(sessionUpdateHandler).toBeDefined();
+      yield* sessionUpdateHandler!({
+        sessionId: "root-session",
+        update: {
+          sessionUpdate: "turn_completed",
+          prompt_id: "task-completed-call-abc",
+          stop_reason: "end_turn",
+        },
+      });
+      yield* sessionUpdateHandler!({
+        sessionId: "root-session",
+        update: {
+          sessionUpdate: "turn_completed",
+          prompt_id: "some-other-cli-turn",
+          stop_reason: "end_turn",
+        },
       });
+      yield* Effect.yieldNow;
+      expect(promptFiber.pollUnsafe()).toBeUndefined();
+      yield* Fiber.interrupt(promptFiber);
+    }),
+  );
 
-      const secondPromptResult = yield* runtime.prompt({
-        prompt: [{ type: "text", text: "second" }],
+  it.effect("ignores prompt_complete notifications for foreign session ids", () =>
+    Effect.gen(function* () {
+      const handlers = new Map<string, (notification: unknown) => Effect.Effect<void>>();
+      const hungPrompt = yield* Deferred.make<never>();
+      const baseRuntime = {
+        start: () =>
+          Effect.succeed({
+            sessionId: "root-session",
+            initializeResult: {},
+            sessionSetupResult: {},
+            modelConfigId: undefined,
+          }),
+        prompt: () => Deferred.await(hungPrompt),
+        cancel: Effect.void,
+        handleExtNotification: (
+          method: string,
+          _schema: unknown,
+          handler: (notification: unknown) => Effect.Effect<void>,
+        ) => {
+          handlers.set(method, handler);
+          return Effect.void;
+        },
+        handleExtRequest: () => Effect.void,
+      } as unknown as AcpSessionRuntime.AcpSessionRuntime["Service"];
+
+      const runtime = yield* makeXAiPromptCompletionRuntime(baseRuntime);
+      const promptFiber = yield* runtime
+        .prompt({ prompt: [{ type: "text", text: "hi" }] })
+        .pipe(Effect.forkChild);
+      yield* Effect.yieldNow;
+      const promptCompleteHandler = handlers.get("_x.ai/session/prompt_complete");
+      expect(promptCompleteHandler).toBeDefined();
+      yield* promptCompleteHandler!({
+        sessionId: "child-session",
       });
-      const secondPromptId = secondPromptResult._meta?.promptId;
-      expect(typeof secondPromptId).toBe("string");
-      expect(secondPromptId).not.toBe("mock-stale-xai-prompt-1");
-      expect(secondPromptResult).toMatchObject({
-        stopReason: "end_turn",
-        _meta: {
-          promptId: secondPromptId,
-          requestId: secondPromptId,
+      yield* Effect.yieldNow;
+      expect(promptFiber.pollUnsafe()).toBeUndefined();
+      yield* Fiber.interrupt(promptFiber);
+    }),
+  );
+
+  it.effect(
+    "ignores promptId-less prompt_complete when multiple prompts are pending on the same session",
+    () =>
+      Effect.gen(function* () {
+        const handlers = new Map<string, (notification: unknown) => Effect.Effect<void>>();
+        const hungPrompt = yield* Deferred.make<never>();
+        const baseRuntime = {
+          start: () =>
+            Effect.succeed({
+              sessionId: "root-session",
+              initializeResult: {},
+              sessionSetupResult: {},
+              modelConfigId: undefined,
+            }),
+          prompt: () => Deferred.await(hungPrompt),
+          cancel: Effect.void,
+          handleExtNotification: (
+            method: string,
+            _schema: unknown,
+            handler: (notification: unknown) => Effect.Effect<void>,
+          ) => {
+            handlers.set(method, handler);
+            return Effect.void;
+          },
+          handleExtRequest: () => Effect.void,
+        } as unknown as AcpSessionRuntime.AcpSessionRuntime["Service"];
+
+        const runtime = yield* makeXAiPromptCompletionRuntime(baseRuntime);
+        const firstPromptFiber = yield* runtime
+          .prompt({ prompt: [{ type: "text", text: "first" }] })
+          .pipe(Effect.forkChild);
+        yield* Effect.yieldNow;
+        const secondPromptFiber = yield* runtime
+          .prompt({ prompt: [{ type: "text", text: "second" }] })
+          .pipe(Effect.forkChild);
+        yield* Effect.yieldNow;
+        const promptCompleteHandler = handlers.get("_x.ai/session/prompt_complete");
+        expect(promptCompleteHandler).toBeDefined();
+        yield* promptCompleteHandler!({
+          sessionId: "root-session",
+          stopReason: "end_turn",
+        });
+        yield* Effect.yieldNow;
+        expect(firstPromptFiber.pollUnsafe()).toBeUndefined();
+        expect(secondPromptFiber.pollUnsafe()).toBeUndefined();
+        yield* Fiber.interrupt(firstPromptFiber);
+        yield* Fiber.interrupt(secondPromptFiber);
+      }),
+  );
+
+  it.effect("injects promptId and requestId into prompt _meta", () =>
+    Effect.gen(function* () {
+      let capturedMeta: Record<string, unknown> | null | undefined;
+      const baseRuntime = {
+        start: () => Effect.succeed({ sessionId: "session-1" }),
+        prompt: (payload: { readonly _meta?: Record<string, unknown> | null }) => {
+          capturedMeta = payload._meta ?? null;
+          return Effect.succeed({ stopReason: "end_turn" as const });
         },
+        cancel: Effect.void,
+        handleExtNotification: () => Effect.void,
+        handleExtRequest: () => Effect.void,
+      } as unknown as AcpSessionRuntime.AcpSessionRuntime["Service"];
+
+      const runtime = yield* makeXAiPromptCompletionRuntime(baseRuntime);
+      yield* runtime.prompt({ prompt: [{ type: "text", text: "hi" }] });
+
+      expect(typeof capturedMeta?.promptId).toBe("string");
+      expect(capturedMeta).toMatchObject({
+        promptId: capturedMeta?.promptId,
+        requestId: capturedMeta?.promptId,
       });
-    }).pipe(Effect.scoped, Effect.provide(NodeServices.layer)),
+    }),
+  );
+
+  it.effect("cancels pending completions without restarting a stalled runtime", () =>
+    Effect.gen(function* () {
+      const hungStart = yield* Deferred.make<never>();
+      const hungPrompt = yield* Deferred.make<never>();
+      let startCount = 0;
+      let cancelCalled = false;
+      const baseRuntime = {
+        start: () => {
+          startCount += 1;
+          return startCount === 1
+            ? Effect.succeed({
+                sessionId: "root-session",
+                initializeResult: {},
+                sessionSetupResult: {},
+                modelConfigId: undefined,
+              })
+            : Deferred.await(hungStart);
+        },
+        prompt: () => Deferred.await(hungPrompt),
+        cancel: Effect.sync(() => {
+          cancelCalled = true;
+        }),
+        handleExtNotification: () => Effect.void,
+        handleExtRequest: () => Effect.void,
+      } as unknown as AcpSessionRuntime.AcpSessionRuntime["Service"];
+
+      const runtime = yield* makeXAiPromptCompletionRuntime(baseRuntime);
+      const promptFiber = yield* runtime
+        .prompt({ prompt: [{ type: "text", text: "hi" }] })
+        .pipe(Effect.forkChild);
+      yield* Effect.yieldNow;
+
+      yield* runtime.cancel;
+
+      expect(cancelCalled).toBe(true);
+      expect(startCount).toBe(1);
+      expect((yield* Fiber.join(promptFiber)).stopReason).toBe("cancelled");
+    }),
   );
+});
 
+describe("Grok exit_plan_mode capture (#8358)", () => {
   it("extracts plan markdown from exit_plan_mode payloads", () => {
     const decode = Schema.decodeUnknownSync(XAiExitPlanModeRequest);
     const direct = decode({
@@ -379,7 +1730,6 @@ describe("XAiAcpExtension", () => {
     expect(extractXAiExitPlanMarkdown(wrapped, "")).toBe(XAI_EMPTY_PLAN_MARKDOWN);
     expect(extractXAiExitPlanMarkdown(wrapped)).toBe(XAI_EMPTY_PLAN_MARKDOWN);
   });
-
   it("builds an abandoned exit_plan_mode response that captures the plan", () => {
     expect(makeXAiExitPlanModeCapturedResponse()).toEqual({
       outcome: "abandoned",
@@ -387,7 +1737,6 @@ describe("XAiAcpExtension", () => {
         "The client captured your proposed plan. Stop here and wait for the user's feedback or implementation request in a later turn.",
     });
   });
-
   it("identifies Grok plan.md paths and extracts markdown from tool call data", () => {
     const linuxHost = { platform: "linux" as const, environment: {} };
     const windowsHost = { platform: "win32" as const, environment: {} };
diff --git a/apps/server/src/provider/acp/XAiAcpExtension.ts b/apps/server/src/provider/acp/XAiAcpExtension.ts
index 543edb39bb6d..e2c8e4a576d9 100644
--- a/apps/server/src/provider/acp/XAiAcpExtension.ts
+++ b/apps/server/src/provider/acp/XAiAcpExtension.ts
@@ -1,14 +1,22 @@
+// @effect-diagnostics nodeBuiltinImport:off -- Grok's plan file lives under the OS home dir.
 import * as NodeOS from "node:os";
 
 import type { ProviderUserInputAnswers, UserInputQuestion } from "@t3tools/contracts";
+import * as Cause from "effect/Cause";
 import * as Deferred from "effect/Deferred";
 import * as Effect from "effect/Effect";
+import * as Fiber from "effect/Fiber";
 import * as Ref from "effect/Ref";
 import * as Schema from "effect/Schema";
 import * as EffectAcpErrors from "effect-acp/errors";
 import type * as EffectAcpSchema from "effect-acp/schema";
 
 import type * as AcpSessionRuntime from "./AcpSessionRuntime.ts";
+import type { AcpToolCallState } from "./AcpRuntimeModel.ts";
+
+const xAiStopReasonMissingMetaKey = "xAiStopReasonMissing";
+const xAiRateLimitedErrorCode = -32003;
+const completedXAiPromptIdLimit = 128;
 
 const XAiPromptCompleteNotification = Schema.Struct({
   sessionId: Schema.String,
@@ -19,6 +27,58 @@ const XAiPromptCompleteNotification = Schema.Struct({
 
 type XAiPromptCompleteNotification = typeof XAiPromptCompleteNotification.Type;
 
+/**
+ * Grok persists root turn completion as an extension session update:
+ * `{ params: { sessionId, update: {
+ *   sessionUpdate: "turn_completed", prompt_id, stop_reason } } }`.
+ * The open-source runtime forwards it as `x.ai/session_notification` and
+ * stores/replays it as `_x.ai/session/update`; released 0.2.106 forwards the
+ * underscore alias `_x.ai/session_notification`. Current source also emits
+ * the fire-and-forget canonical `x.ai/session/prompt_complete`, while released
+ * builds use the underscore alias.
+ */
+const XAiSessionUpdateNotification = Schema.Struct({
+  sessionId: Schema.String,
+  update: Schema.Struct({
+    sessionUpdate: Schema.String,
+    prompt_id: Schema.optional(Schema.String),
+    promptId: Schema.optional(Schema.String),
+    stop_reason: Schema.optional(Schema.String),
+    stopReason: Schema.optional(Schema.String),
+  }),
+  _meta: Schema.optional(Schema.Unknown),
+});
+
+type XAiSessionUpdateNotification = typeof XAiSessionUpdateNotification.Type;
+
+const XAI_TASK_COMPLETED_PROMPT_ID_PREFIX = "task-completed-";
+
+/**
+ * Map a Grok `_x.ai/session/update` payload to a prompt-complete shape when it
+ * is a root `turn_completed` for a real prompt id. Returns null for hooks,
+ * background task completions, and other update kinds.
+ */
+export function xAiPromptCompleteFromSessionUpdate(
+  notification: XAiSessionUpdateNotification,
+): XAiPromptCompleteNotification | null {
+  const update = notification.update;
+  if (update.sessionUpdate !== "turn_completed") {
+    return null;
+  }
+  const promptId = nonEmptyString(update.prompt_id) ?? nonEmptyString(update.promptId);
+  // Require prompt id so we never session-fallback match a background task
+  // completion (`task-completed-*`) or an unrelated CLI turn.
+  if (promptId === undefined || promptId.startsWith(XAI_TASK_COMPLETED_PROMPT_ID_PREFIX)) {
+    return null;
+  }
+  const stopReason = nonEmptyString(update.stop_reason) ?? nonEmptyString(update.stopReason);
+  return {
+    sessionId: notification.sessionId,
+    promptId,
+    ...(stopReason === undefined ? {} : { stopReason }),
+  };
+}
+
 interface PendingXAiPromptCompletion {
   readonly sessionId: string;
   readonly promptId: string;
@@ -28,181 +88,758 @@ interface PendingXAiPromptCompletion {
   >;
 }
 
-const completedXAiPromptIdLimit = 128;
-const xAiStopReasonMissingMetaKey = "xAiStopReasonMissing";
-const xAiRateLimitedErrorCode = -32003;
+export interface XAiAcpSubagentUpdate {
+  readonly nativeTaskId: string;
+  readonly prompt: string;
+  readonly title: string | null;
+  readonly model: string | null;
+  readonly status: "running" | "completed" | "failed";
+  readonly childSessionId: string | null;
+  readonly result: string | null;
+  /**
+   * When false, the ACP adapter also projects a normal tool turn item for this
+   * tool call (used for get_command_or_subagent_output hydration). Default true.
+   */
+  readonly suppressNormalTool?: boolean;
+}
 
-const XAiAskUserQuestionOption = Schema.Struct({
-  label: Schema.String,
-  description: Schema.optional(Schema.String),
-  preview: Schema.optional(Schema.String),
-  id: Schema.optional(Schema.String),
-});
+export interface XAiAcpBackgroundToolMutation {
+  readonly taskId: string;
+  readonly status: "running" | "completed" | "failed";
+  readonly appendOutput: string;
+}
 
-const XAiAskUserQuestion = Schema.Struct({
-  id: Schema.optional(Schema.String),
-  question: Schema.String,
-  options: Schema.Array(XAiAskUserQuestionOption),
-  multiSelect: Schema.optional(Schema.NullOr(Schema.Boolean)),
-});
+export interface XAiAcpSubagentEndNotice {
+  readonly childSessionId: string;
+  readonly status: "completed" | "failed";
+}
 
-const XAiAskUserQuestionParams = Schema.Struct({
-  sessionId: Schema.String,
-  toolCallId: Schema.String,
-  questions: Schema.Array(XAiAskUserQuestion),
-  mode: Schema.Literals(["default", "plan"]),
-});
+const XAI_UUID_RE = "[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}";
 
-const XAiWrappedAskUserQuestionParams = Schema.Struct({
-  method: Schema.Literals(["x.ai/ask_user_question", "_x.ai/ask_user_question"]),
-  params: XAiAskUserQuestionParams,
-});
+function unknownRecord(value: unknown): Record<string, unknown> | undefined {
+  return typeof value === "object" && value !== null && !Array.isArray(value)
+    ? (value as Record<string, unknown>)
+    : undefined;
+}
 
-export const XAiAskUserQuestionRequest = Schema.Union([
-  XAiAskUserQuestionParams,
-  XAiWrappedAskUserQuestionParams,
-]);
+function nonEmptyString(value: unknown): string | undefined {
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
+}
 
-type XAiAskUserQuestionRequestParams = typeof XAiAskUserQuestionParams.Type;
-type XAiAskUserQuestionRequest = typeof XAiAskUserQuestionRequest.Type;
+function titleKey(toolCall: AcpToolCallState): string {
+  return (toolCall.title ?? "").trim().toLowerCase();
+}
 
-function trimmed(value: string | undefined): string | undefined {
-  const text = value?.trim();
-  return text && text.length > 0 ? text : undefined;
+function decodeByteText(value: unknown): string | undefined {
+  if (typeof value === "string") return nonEmptyString(value);
+  if (!Array.isArray(value)) return undefined;
+  if (value.length === 0) return undefined;
+  if (!value.every((entry) => typeof entry === "number")) return undefined;
+  try {
+    return nonEmptyString(new TextDecoder().decode(Uint8Array.from(value as number[])));
+  } catch {
+    return undefined;
+  }
 }
 
-function unwrapAskUserQuestionParams(
-  params: XAiAskUserQuestionRequest,
-): XAiAskUserQuestionRequestParams {
-  return "params" in params ? params.params : params;
+function xAiToolOutputText(toolCall: AcpToolCallState): string | undefined {
+  const rawOutput = unknownRecord(toolCall.data.rawOutput);
+  if (rawOutput !== undefined) {
+    const direct =
+      nonEmptyString(rawOutput.text) ??
+      nonEmptyString(rawOutput.output_for_prompt) ??
+      decodeByteText(rawOutput.output);
+    if (direct !== undefined) return direct;
+    const result = unknownRecord(rawOutput.Result) ?? unknownRecord(rawOutput.result);
+    if (result !== undefined) {
+      const nested =
+        nonEmptyString(result.output) ??
+        nonEmptyString(result.text) ??
+        decodeByteText(result.output);
+      if (nested !== undefined) return nested;
+    }
+  }
+  if (typeof toolCall.data.rawOutput === "string") {
+    return nonEmptyString(toolCall.data.rawOutput);
+  }
+  const content = toolCall.data.content;
+  if (!Array.isArray(content)) return undefined;
+  const text = content
+    .flatMap((entry) => {
+      const record = unknownRecord(entry);
+      const nested = unknownRecord(record?.content);
+      return nonEmptyString(nested?.text) ?? nonEmptyString(record?.text) ?? [];
+    })
+    .join("\n")
+    .trim();
+  return text.length > 0 ? text : undefined;
 }
 
-export function extractXAiAskUserQuestions(
-  params: XAiAskUserQuestionRequest,
-): ReadonlyArray<UserInputQuestion> {
-  return unwrapAskUserQuestionParams(params).questions.map((question) => ({
-    id: question.id ?? question.question,
-    header: "Question",
-    question: question.question,
-    multiSelect: question.multiSelect === true,
-    options:
-      question.options.length > 0
-        ? question.options.map((option) => ({
-            label: option.label,
-            description: option.description ?? option.label,
-          }))
-        : [{ label: "OK", description: "Continue" }],
-  }));
+function firstUuidMatch(text: string, pattern: RegExp): string | undefined {
+  const match = pattern.exec(text);
+  return match?.[1];
 }
 
-interface XAiAskUserQuestionAnnotation {
-  readonly preview?: string;
-  readonly notes?: string;
+function extractXAiChildSessionId(output: string | undefined): string | null {
+  if (output === undefined) return null;
+  return (
+    firstUuidMatch(output, new RegExp(`(?:^|\\n)\\s*Agent ID:\\s*(${XAI_UUID_RE})\\b`, "i")) ??
+    firstUuidMatch(output, new RegExp(`(?:^|\\n)\\s*subagent_id:\\s*(${XAI_UUID_RE})\\b`, "i")) ??
+    firstUuidMatch(output, new RegExp(`===\\s*Task\\s+(${XAI_UUID_RE})\\s*===`, "i")) ??
+    null
+  );
 }
 
-interface XAiAskUserQuestionAcceptedResponse {
-  readonly outcome: "accepted";
-  readonly answers: Record<string, ReadonlyArray<string>>;
-  readonly annotations?: Record<string, XAiAskUserQuestionAnnotation>;
+function isXAiAsyncSpawnAck(output: string | undefined): boolean {
+  if (output === undefined) return false;
+  if (/subagent started in background/i.test(output)) return true;
+  return (
+    new RegExp(`subagent_id:\\s*${XAI_UUID_RE}`, "i").test(output) &&
+    /get_command_or_subagent_output/i.test(output)
+  );
 }
 
-interface XAiAskUserQuestionCancelledResponse {
-  readonly outcome: "cancelled";
+function isXAiMonitorStartAck(output: string | undefined): boolean {
+  if (output === undefined) return false;
+  return /monitor started\s*\(\s*task\s+/i.test(output);
 }
 
-export type XAiAskUserQuestionResponse =
-  | XAiAskUserQuestionAcceptedResponse
-  | XAiAskUserQuestionCancelledResponse;
+function isXAiSpawnOrTaskTool(
+  toolCall: AcpToolCallState,
+  rawInput: Record<string, unknown> | undefined,
+): boolean {
+  const title = titleKey(toolCall);
+  if (title === "task" || title === "spawn_subagent" || title.includes("spawn subagent")) {
+    return true;
+  }
+  const variant = nonEmptyString(rawInput?.variant)?.toLowerCase();
+  if (variant === "cursortask" || variant === "task" || variant === "spawn_subagent") {
+    return true;
+  }
+  if (nonEmptyString(rawInput?.subagent_type) !== undefined) return true;
+  if (nonEmptyString(rawInput?.subagentType) !== undefined) return true;
+  return false;
+}
 
-interface NormalizedXAiAnswer {
-  readonly questionText: string;
-  readonly selectedLabels: ReadonlyArray<string>;
-  readonly annotation?: XAiAskUserQuestionAnnotation;
+function isXAiGetSubagentOutputTool(
+  toolCall: AcpToolCallState,
+  rawInput: Record<string, unknown> | undefined,
+): boolean {
+  const title = titleKey(toolCall);
+  if (
+    title === "get_command_or_subagent_output" ||
+    title.includes("get_command_or_subagent_output") ||
+    title === "wait_commands_or_subagents"
+  ) {
+    return true;
+  }
+  const variant = nonEmptyString(rawInput?.variant)?.toLowerCase();
+  if (variant === "taskoutput" || variant === "task_output") return true;
+  const rawOutput = unknownRecord(toolCall.data.rawOutput);
+  const outputType = nonEmptyString(rawOutput?.type)?.toLowerCase();
+  if (outputType === "taskoutput" || outputType === "task_output") return true;
+  // ACP often titles this tool with the finished subagent label.
+  if (title.startsWith("[subagent:") && Array.isArray(rawInput?.task_ids)) return true;
+  return false;
 }
 
-function answerValues(answer: unknown): ReadonlyArray<string> {
-  if (Array.isArray(answer)) {
-    return answer.flatMap((entry) => {
-      const text = typeof entry === "string" ? trimmed(entry) : undefined;
-      return text ? [text] : [];
-    });
+export function isXAiMonitorTool(toolCall: AcpToolCallState): boolean {
+  const title = titleKey(toolCall);
+  if (title === "monitor" || title.startsWith("monitor ")) return true;
+  const rawInput = unknownRecord(toolCall.data.rawInput);
+  const variant = nonEmptyString(rawInput?.variant)?.toLowerCase();
+  if (variant === "monitor") return true;
+  // Live start ACKs often keep a generic title ("Tool") and only mark the
+  // structured envelope as Monitor; title rewrite to description must not
+  // prevent monitor registration / inProgress forcing.
+  const rawOutput = unknownRecord(toolCall.data.rawOutput);
+  const outputType = nonEmptyString(rawOutput?.type)?.toLowerCase();
+  if (outputType === "monitor") return true;
+  // Released clients can wrap the start ACK as plain Text and omit the Monitor
+  // variant. The ACK is still unambiguous and contains the task id required for
+  // background tracking, even after a generic title is rewritten from
+  // rawInput.description.
+  return isXAiMonitorStartAck(xAiToolOutputText(toolCall));
+}
+
+export function extractXAiMonitorTaskId(toolCall: AcpToolCallState): string | undefined {
+  if (!isXAiMonitorTool(toolCall)) return undefined;
+  const rawOutput = unknownRecord(toolCall.data.rawOutput);
+  // Live ACP start ACK: { type: "Monitor", taskId, timeoutMs, persistent }
+  if (rawOutput !== undefined && nonEmptyString(rawOutput.type)?.toLowerCase() === "monitor") {
+    const structured = nonEmptyString(rawOutput.taskId) ?? nonEmptyString(rawOutput.task_id);
+    if (structured !== undefined) return structured;
   }
-  const text = typeof answer === "string" ? trimmed(answer) : undefined;
-  return text ? [text] : [];
+  const output = xAiToolOutputText(toolCall);
+  if (output !== undefined) {
+    const fromAck = firstUuidMatch(
+      output,
+      new RegExp(`monitor started\\s*\\(\\s*task\\s+(${XAI_UUID_RE})\\b`, "i"),
+    );
+    if (fromAck !== undefined) return fromAck;
+  }
+  const rawInput = unknownRecord(toolCall.data.rawInput);
+  return (
+    nonEmptyString(rawInput?.task_id) ??
+    nonEmptyString(rawInput?.taskId) ??
+    (Array.isArray(rawInput?.task_ids) ? nonEmptyString(rawInput.task_ids[0]) : undefined)
+  );
 }
 
-function normalizeAnswerForXAi(
-  question: XAiAskUserQuestionRequestParams["questions"][number],
-  answer: unknown,
-): NormalizedXAiAnswer | undefined {
-  const values = answerValues(answer);
-  if (values.length === 0) {
-    return undefined;
+/**
+ * Live Monitor start ACK `{ type: "Monitor", persistent: true }` (or matching
+ * rawInput). Persistent monitors should not hold root-turn deferred finalize.
+ */
+export function isXAiPersistentMonitor(toolCall: AcpToolCallState): boolean {
+  if (!isXAiMonitorTool(toolCall)) return false;
+  const rawOutput = unknownRecord(toolCall.data.rawOutput);
+  if (rawOutput !== undefined && nonEmptyString(rawOutput.type)?.toLowerCase() === "monitor") {
+    return rawOutput.persistent === true;
   }
+  const rawInput = unknownRecord(toolCall.data.rawInput);
+  return rawInput?.persistent === true;
+}
 
-  const optionByLabel = new Map(question.options.map((option) => [option.label, option]));
-  const resolvedValues = values.map((value) => ({
-    value,
-    option: optionByLabel.get(value),
+/**
+ * When get_command_or_subagent_output / TaskOutput completes registered monitor
+ * task(s), return hydration for each completed background tool id.
+ */
+export function extractXAiBackgroundTaskCompletion(toolCall: AcpToolCallState): ReadonlyArray<{
+  readonly taskId: string;
+  readonly status: "running" | "completed" | "failed";
+  readonly appendOutput: string;
+}> {
+  const rawInput = unknownRecord(toolCall.data.rawInput);
+  if (!isXAiGetSubagentOutputTool(toolCall, rawInput)) return [];
+  // Caller matches taskId against registered background tools (monitors).
+  // Subagent hydration stays on extractXAiAcpSubagentUpdate.
+  const text = xAiToolOutputText(toolCall);
+  const status = statusFromGetOutputTool(toolCall, text);
+  const appendOutput = resultFromGetOutputTool(toolCall, text) ?? "";
+  // Prefer the completed identity from the result/header over the request list
+  // (one call can poll multiple task_ids).
+  const resultTaskId = resultTaskIdFromGetOutputTool(toolCall, text);
+  if (resultTaskId !== undefined) {
+    return [{ taskId: resultTaskId, status, appendOutput }];
+  }
+  const requestIds: string[] = [];
+  const push = (value: unknown) => {
+    const id = nonEmptyString(value);
+    if (id !== undefined && new RegExp(`^${XAI_UUID_RE}$`, "i").test(id)) {
+      requestIds.push(id);
+    }
+  };
+  if (Array.isArray(rawInput?.task_ids)) {
+    for (const entry of rawInput.task_ids) push(entry);
+  }
+  push(rawInput?.task_id);
+  push(rawInput?.taskId);
+  const unique = [...new Set(requestIds)];
+  return unique.map((taskId) => ({ taskId, status, appendOutput }));
+}
+
+/**
+ * A finished kill_command_or_subagent call is the genuine end signal for every
+ * task id it names: the Grok CLI emits no `x.ai/task_completed` for a killed
+ * task. A failed kill is not proof the target stopped, so leave the existing
+ * task state unchanged until a genuine terminal signal arrives.
+ */
+export function extractXAiKilledBackgroundTasks(toolCall: AcpToolCallState): ReadonlyArray<{
+  readonly taskId: string;
+  readonly status: "running" | "completed" | "failed";
+  readonly appendOutput: string;
+}> {
+  const title = titleKey(toolCall);
+  const rawInput = unknownRecord(toolCall.data.rawInput);
+  const variant = nonEmptyString(rawInput?.variant)?.toLowerCase();
+  if (!title.includes("kill_command_or_subagent") && variant !== "kill") return [];
+  if (toolCall.status !== "completed") return [];
+  const taskIds: string[] = [];
+  const push = (value: unknown) => {
+    const id = nonEmptyString(value);
+    if (id !== undefined) taskIds.push(id);
+  };
+  if (Array.isArray(rawInput?.task_ids)) {
+    for (const entry of rawInput.task_ids) push(entry);
+  }
+  push(rawInput?.task_id);
+  push(rawInput?.taskId);
+  return [...new Set(taskIds)].map((taskId) => ({
+    taskId,
+    status: "completed" as const,
+    appendOutput: "",
   }));
-  const selectedLabels = resolvedValues.flatMap(({ option }) => (option ? [option.label] : []));
-  const notes = resolvedValues.flatMap(({ option, value }) => (option ? [] : [value]));
-  const preview =
-    question.multiSelect === true
-      ? undefined
-      : resolvedValues.map(({ option }) => trimmed(option?.preview)).find((value) => value);
+}
 
-  const annotation =
-    preview || notes.length > 0
-      ? {
-          ...(preview ? { preview } : {}),
-          ...(notes.length > 0 ? { notes: notes.join("\n") } : {}),
-        }
-      : undefined;
+const XAiTaskLifecycleNotification = Schema.Struct({
+  sessionId: Schema.String,
+  update: Schema.Struct({
+    sessionUpdate: Schema.String,
+    task_id: Schema.optional(Schema.String),
+    tool_call_id: Schema.optional(Schema.String),
+    task_snapshot: Schema.optional(
+      Schema.Struct({
+        task_id: Schema.optional(Schema.String),
+      }),
+    ),
+  }),
+  _meta: Schema.optional(Schema.Unknown),
+});
 
-  return {
-    questionText: question.question,
-    selectedLabels: selectedLabels.length > 0 ? selectedLabels : ["Other"],
-    ...(annotation ? { annotation } : {}),
-  };
+type XAiTaskLifecycleNotification = typeof XAiTaskLifecycleNotification.Type;
+
+export interface XAiBackgroundTaskLifecycleMutation {
+  readonly sessionId: string;
+  readonly taskId: string;
+  readonly status: "running" | "completed";
 }
 
-function findQuestionAnswer(
-  answers: ProviderUserInputAnswers,
-  question: XAiAskUserQuestionRequestParams["questions"][number],
-): unknown {
-  const key = question.id ?? question.question;
-  return answers[key] ?? answers[question.question];
+export function xAiBackgroundTaskLifecycleMutation(
+  notification: XAiTaskLifecycleNotification,
+  status: "running" | "completed",
+): XAiBackgroundTaskLifecycleMutation | null {
+  const update = notification.update;
+  const taskId =
+    nonEmptyString(update.task_snapshot?.task_id) ??
+    nonEmptyString(update.task_id) ??
+    nonEmptyString(update.tool_call_id);
+  if (taskId === undefined) return null;
+  return { sessionId: notification.sessionId, taskId, status };
 }
 
-export function makeXAiAskUserQuestionResponse(
-  params: XAiAskUserQuestionRequest,
-  answers: ProviderUserInputAnswers,
-): XAiAskUserQuestionAcceptedResponse {
-  const questions = unwrapAskUserQuestionParams(params).questions;
-  const normalized = questions.flatMap((question) => {
-    const entry = normalizeAnswerForXAi(question, findQuestionAnswer(answers, question));
-    return entry ? [entry] : [];
-  });
-  const annotations = Object.fromEntries(
-    normalized.flatMap((entry) =>
-      entry.annotation ? [[entry.questionText, entry.annotation] as const] : [],
-    ),
+/**
+ * Grok task lifecycle notifications use canonical `x.ai/task_*` methods in
+ * current builds; older 0.2.x builds used `_x.ai/task_*`. Interactive cancel
+ * preserves tasks that were already backgrounded (and some older builds could
+ * background the cancelled foreground command), so both spellings must be
+ * tracked. Residual frames then buffer instead of waking synthetic
+ * continuations, and pending-background-work stays truthful until the task
+ * ends (or the model kills it via kill_command_or_subagent).
+ */
+export const registerXAiBackgroundTaskTracking = (
+  runtime: Pick<AcpSessionRuntime.AcpSessionRuntime["Service"], "handleExtNotification">,
+  apply: (mutation: XAiBackgroundTaskLifecycleMutation) => Effect.Effect<void>,
+): Effect.Effect<void, EffectAcpErrors.AcpError> =>
+  Effect.forEach(
+    [
+      ["x.ai/task_backgrounded", "running"],
+      ["_x.ai/task_backgrounded", "running"],
+      ["x.ai/task_completed", "completed"],
+      ["_x.ai/task_completed", "completed"],
+    ] as const,
+    ([method, status]) =>
+      runtime.handleExtNotification(method, XAiTaskLifecycleNotification, (notification) => {
+        const mutation = xAiBackgroundTaskLifecycleMutation(notification, status);
+        return mutation === null ? Effect.void : apply(mutation);
+      }),
+    { discard: true },
   );
 
-  return {
-    outcome: "accepted",
-    answers: Object.fromEntries(
-      normalized.map((entry) => [entry.questionText, entry.selectedLabels]),
-    ),
-    ...(Object.keys(annotations).length > 0 ? { annotations } : {}),
+/**
+ * Grok ACP often sends `title: "Tool"` even when rawInput has a useful
+ * description or variant (especially Monitor). Prefer description/variant so
+ * the timeline matches Claude-style tool names rather than a generic label.
+ */
+export function isGenericAcpToolTitle(title: string | undefined): boolean {
+  const key = (title ?? "").trim().toLowerCase();
+  return key.length === 0 || key === "tool" || key === "tool call" || key === "terminal";
+}
+
+export function resolveXAiAcpToolTitle(toolCall: AcpToolCallState): string | undefined {
+  if (!isGenericAcpToolTitle(toolCall.title)) {
+    return nonEmptyString(toolCall.title);
+  }
+  const rawInput = unknownRecord(toolCall.data.rawInput);
+  const description = nonEmptyString(rawInput?.description);
+  const variant = nonEmptyString(rawInput?.variant)?.toLowerCase();
+  if (description !== undefined) {
+    if (variant === "monitor" && !description.toLowerCase().startsWith("monitor")) {
+      return `Monitor: ${description}`;
+    }
+    return description;
+  }
+  if (variant === "monitor") return "Monitor";
+  if (variant === "task" || variant === "cursortask" || variant === "spawn_subagent") {
+    return "Task";
+  }
+  if (variant === "taskoutput" || variant === "task_output") return "Task output";
+  if (variant !== undefined) {
+    return variant;
+  }
+  const command =
+    nonEmptyString(rawInput?.command) ??
+    nonEmptyString(unknownRecord(toolCall.data.rawOutput)?.command);
+  if (command !== undefined) {
+    return command.length > 80 ? `${command.slice(0, 77)}...` : command;
+  }
+  return nonEmptyString(toolCall.title);
+}
+
+/**
+ * Normalize Grok ACP tool presentation and monitor lifecycle:
+ * - replace generic titles ("Tool") with description / variant labels
+ * - structured Monitor start ACK stays running
+ * - text start ACK stays running
+ * - structured Bash results with exit_code are terminal (any tool: post-settle
+ *   wake re-reports of a finished monitor arrive with empty rawInput and a
+ *   generic title, so monitor detection cannot match; without this they replay
+ *   as running and the timeline row spins forever)
+ */
+export function normalizeXAiAcpToolCallState(toolCall: AcpToolCallState): AcpToolCallState {
+  const resolvedTitle = resolveXAiAcpToolTitle(toolCall);
+  const withTitle =
+    resolvedTitle !== undefined && resolvedTitle !== toolCall.title
+      ? { ...toolCall, title: resolvedTitle }
+      : toolCall;
+
+  const rawOutput = unknownRecord(withTitle.data.rawOutput);
+  const outputType = nonEmptyString(rawOutput?.type)?.toLowerCase();
+  if (outputType === "bash") {
+    // Same key set as the adapter's command projection (commandExitCode).
+    const exitCode = ["exit_code", "exitCode", "code"]
+      .map((key) => rawOutput?.[key])
+      .find((value) => typeof value === "number" && Number.isInteger(value));
+    if (typeof exitCode === "number") {
+      if (exitCode === 0 && (xAiToolOutputText(withTitle)?.trim().length ?? 0) === 0) {
+        return { ...withTitle, status: "inProgress" };
+      }
+      return {
+        ...withTitle,
+        status: exitCode === 0 ? "completed" : "failed",
+      };
+    }
+  }
+  if (!isXAiMonitorTool(withTitle)) {
+    return withTitle;
+  }
+  if (outputType === "monitor") {
+    // Start registration only; process still running in the background.
+    return { ...withTitle, status: "inProgress" };
+  }
+  const output = xAiToolOutputText(withTitle);
+  if (withTitle.status === "completed" && isXAiMonitorStartAck(output)) {
+    return { ...withTitle, status: "inProgress" };
+  }
+  return withTitle;
+}
+
+/**
+ * Parse Grok synthetic monitor traffic that arrives as root text chunks
+ * (`<monitor-event>` lines, batched `<monitor>` event blocks, and
+ * "Monitor ... ended" reminders). Coalesced chunks may contain several events;
+ * return every match so later progress / end notices are not dropped.
+ */
+export function extractXAiAcpBackgroundToolMutation(
+  text: string,
+): ReadonlyArray<XAiAcpBackgroundToolMutation> {
+  const mutations: XAiAcpBackgroundToolMutation[] = [];
+
+  const eventRe = new RegExp(
+    `<monitor-event\\s+task_id=["']?(${XAI_UUID_RE})["']?\\s*>\\s*([\\s\\S]*?)\\s*</monitor-event>`,
+    "gi",
+  );
+  for (const eventMatch of text.matchAll(eventRe)) {
+    if (eventMatch[1] === undefined) continue;
+    const line = (eventMatch[2] ?? "").trim();
+    mutations.push({
+      taskId: eventMatch[1],
+      status: "running",
+      appendOutput: line.length > 0 ? `${line}\n` : "",
+    });
+  }
+
+  // Batched form: "N monitor events from 1 monitor ...:\n<monitor
+  // description="..." task_id="...">\n[1] line\n</monitor>". Still a running
+  // monitor; must track and filter like single-event chatter.
+  const batchedRe = new RegExp(
+    `<monitor\\s[^>]*task_id=["']?(${XAI_UUID_RE})["']?[^>]*>\\s*([\\s\\S]*?)\\s*</monitor>`,
+    "gi",
+  );
+  for (const batchedMatch of text.matchAll(batchedRe)) {
+    if (batchedMatch[1] === undefined) continue;
+    const lines = (batchedMatch[2] ?? "").trim();
+    mutations.push({
+      taskId: batchedMatch[1],
+      status: "running",
+      appendOutput: lines.length > 0 ? `${lines}\n` : "",
+    });
+  }
+
+  const endedRe = new RegExp(`Monitor\\s+["']?(${XAI_UUID_RE})["']?\\s+ended`, "gi");
+  for (const endedMatch of text.matchAll(endedRe)) {
+    if (endedMatch[1] === undefined) continue;
+    // Only the "Monitor … ended …" clause is outcome text. Description/output
+    // after the header can contain words like "error" without meaning failure.
+    const outcomeClause = (endedMatch[0] ?? "").trim();
+    const afterHeader = text.slice((endedMatch.index ?? 0) + endedMatch[0].length);
+    const outcomeTail = afterHeader.split(/\n/)[0] ?? "";
+    const outcome = `${outcomeClause}${outcomeTail}`;
+    const summary = text.replace(/<\/?system-reminder>/gi, "").trim();
+    mutations.push({
+      taskId: endedMatch[1],
+      status:
+        /exited\s*\(\s*code\s*0\s*\)/i.test(outcome) || /ended cleanly/i.test(outcome)
+          ? "completed"
+          : /exited|failed|error|signal/i.test(outcome)
+            ? "failed"
+            : "completed",
+      appendOutput: summary.length > 0 ? `${summary}\n` : "Monitor ended.\n",
+    });
+  }
+
+  return mutations;
+}
+
+/**
+ * Parse Grok's root-session subagent end reminder ("Background subagent
+ * "<uuid>" (general-purpose: "...") completed successfully."). The agent is
+ * free to skip get_command_or_subagent_output hydration, so this reminder can
+ * be the only terminal signal for the subagent row; a row stuck on running
+ * holds deferred finalize (and the whole run) open until harness timeout.
+ */
+function stripLeadingBalancedParenGroup(text: string): string {
+  const trimmed = text.replace(/^\s+/, "");
+  if (!trimmed.startsWith("(")) return trimmed;
+  let depth = 0;
+  for (let index = 0; index < trimmed.length; index += 1) {
+    const char = trimmed[index];
+    if (char === "(") depth += 1;
+    else if (char === ")") {
+      depth -= 1;
+      if (depth === 0) return trimmed.slice(index + 1).replace(/^\s+/, "");
+    }
+  }
+  return trimmed;
+}
+
+export function extractXAiAcpSubagentEndNotice(text: string): XAiAcpSubagentEndNotice | undefined {
+  const match = text.match(new RegExp(`Background subagent\\s+["']?(${XAI_UUID_RE})["']?`, "i"));
+  if (match?.[1] === undefined) return undefined;
+  // Skip the parenthesized descriptor (subagent type and title) so its words
+  // cannot masquerade as the outcome verb. Balance parens so nested titles
+  // like `(general-purpose: "Check (backend) failed")` do not leak.
+  const tail = stripLeadingBalancedParenGroup(text.slice((match.index ?? 0) + match[0].length));
+  if (/completed successfully/i.test(tail)) {
+    return { childSessionId: match[1], status: "completed" };
+  }
+  if (/\b(failed|errored|error|crashed|cancelled|canceled|interrupted|timed out)\b/i.test(tail)) {
+    return { childSessionId: match[1], status: "failed" };
+  }
+  if (/\b(completed|finished|ended)\b/i.test(tail)) {
+    return { childSessionId: match[1], status: "completed" };
+  }
+  return undefined;
+}
+
+function taskIdsFromGetOutputTool(
+  toolCall: AcpToolCallState,
+  rawInput: Record<string, unknown> | undefined,
+): ReadonlyArray<string> {
+  const ids: string[] = [];
+  const push = (value: unknown) => {
+    const text = nonEmptyString(value);
+    if (text !== undefined && new RegExp(`^${XAI_UUID_RE}$`, "i").test(text)) {
+      ids.push(text);
+    }
   };
+  if (Array.isArray(rawInput?.task_ids)) {
+    for (const entry of rawInput.task_ids) push(entry);
+  }
+  push(rawInput?.task_id);
+  push(rawInput?.taskId);
+  const resultId = resultTaskIdFromGetOutputTool(toolCall, xAiToolOutputText(toolCall));
+  if (resultId !== undefined) ids.push(resultId);
+  return [...new Set(ids)];
 }
 
-export function makeXAiAskUserQuestionCancelledResponse(): XAiAskUserQuestionCancelledResponse {
-  return { outcome: "cancelled" };
+/** Identity of the task the get_output envelope actually reports (not the request list). */
+function resultTaskIdFromGetOutputTool(
+  toolCall: AcpToolCallState,
+  output: string | undefined,
+): string | undefined {
+  const rawOutput = unknownRecord(toolCall.data.rawOutput);
+  const result = unknownRecord(rawOutput?.Result) ?? unknownRecord(rawOutput?.result);
+  const structured =
+    nonEmptyString(result?.task_id) ??
+    nonEmptyString(result?.taskId) ??
+    nonEmptyString(rawOutput?.task_id) ??
+    nonEmptyString(rawOutput?.taskId);
+  if (structured !== undefined && new RegExp(`^${XAI_UUID_RE}$`, "i").test(structured)) {
+    return structured;
+  }
+  if (output === undefined) return undefined;
+  const taskHeader = firstUuidMatch(
+    output,
+    new RegExp(`===\\s*Task\\s+(${XAI_UUID_RE})\\s*===`, "i"),
+  );
+  return taskHeader;
+}
+
+function resultFromGetOutputTool(
+  toolCall: AcpToolCallState,
+  output: string | undefined,
+): string | null {
+  const rawOutput = unknownRecord(toolCall.data.rawOutput);
+  const result = unknownRecord(rawOutput?.Result) ?? unknownRecord(rawOutput?.result);
+  const structured =
+    nonEmptyString(result?.output) ??
+    nonEmptyString(result?.text) ??
+    decodeByteText(result?.output);
+  if (structured !== undefined) {
+    // Drop trailing machine meta blocks when present.
+    const cleaned = structured
+      .replace(/<subagent_meta>[\s\S]*?<\/subagent_meta>/gi, "")
+      .replace(/<subagent_result>[\s\S]*?<\/subagent_result>/gi, "")
+      .trim();
+    if (cleaned.length > 0) return cleaned;
+    return null;
+  }
+  if (output === undefined) return null;
+  const marker = output.match(/=== Output ===\s*([\s\S]*)$/i);
+  const body = (marker?.[1] ?? output).trim();
+  return body.length > 0 ? body : null;
+}
+
+function statusFromGetOutputTool(
+  toolCall: AcpToolCallState,
+  output: string | undefined,
+): "running" | "completed" | "failed" {
+  if (toolCall.status === "failed") return "failed";
+  const rawOutput = unknownRecord(toolCall.data.rawOutput);
+  const result = unknownRecord(rawOutput?.Result) ?? unknownRecord(rawOutput?.result);
+  const structuredStatus = nonEmptyString(result?.status)?.toLowerCase();
+  if (structuredStatus === "completed" || structuredStatus === "success") return "completed";
+  if (structuredStatus === "failed" || structuredStatus === "error") return "failed";
+  if (structuredStatus === "running" || structuredStatus === "pending") return "running";
+  if (typeof result?.exit_code === "number") {
+    return result.exit_code === 0 ? "completed" : "failed";
+  }
+  if (output !== undefined) {
+    if (/Status:\s*failed/i.test(output) || /Exit Code:\s*-?(?!0\b)\d+/i.test(output)) {
+      return "failed";
+    }
+    if (/Status:\s*completed/i.test(output) || /Status:\s*success/i.test(output)) {
+      return "completed";
+    }
+    if (/Status:\s*running/i.test(output) || /Status:\s*pending/i.test(output)) {
+      return "running";
+    }
+  }
+  // A completed get_output tool call only means the poll RPC returned. Without
+  // a task-level terminal status or exit code, the requested task is still
+  // running and must remain registered for subsequent polling.
+  return "running";
+}
+
+/**
+ * Recognizes Grok Task / spawn_subagent envelopes and get_command hydration
+ * without teaching the generic ACP adapter about xAI tool names.
+ *
+ * Current Grok CLI returns spawn_subagent immediately with a background ACK
+ * (`subagent_id: ...`). That must stay `running` until child work finishes or
+ * get_command_or_subagent_output reports a terminal status.
+ */
+export function extractXAiAcpSubagentUpdate(
+  toolCall: AcpToolCallState,
+): XAiAcpSubagentUpdate | undefined {
+  const rawInput = unknownRecord(toolCall.data.rawInput);
+  const output = xAiToolOutputText(toolCall);
+
+  if (isXAiGetSubagentOutputTool(toolCall, rawInput)) {
+    const taskIds = taskIdsFromGetOutputTool(toolCall, rawInput);
+    // Prefer the completed task identity from the result/header over the first
+    // requested task_ids entry (one call can poll multiple task_ids).
+    const childSessionId =
+      resultTaskIdFromGetOutputTool(toolCall, output) ??
+      taskIds[0] ??
+      extractXAiChildSessionId(output);
+    if (childSessionId === null) return undefined;
+    // Prefer the durable subagent row as the completion surface (Claude/Codex
+    // style). Suppress the noisy TaskOutput tool card; monitor hydration is
+    // handled separately via extractBackgroundTaskCompletion.
+    return {
+      nativeTaskId: toolCall.toolCallId,
+      prompt: "",
+      title: null,
+      model: null,
+      status: statusFromGetOutputTool(toolCall, output),
+      childSessionId,
+      result: resultFromGetOutputTool(toolCall, output),
+      suppressNormalTool: true,
+    };
+  }
+
+  if (!isXAiSpawnOrTaskTool(toolCall, rawInput)) return undefined;
+
+  const childSessionId = extractXAiChildSessionId(output);
+  const asyncSpawnAck = isXAiAsyncSpawnAck(output);
+  const legacyResult =
+    output
+      ?.replace(new RegExp(`(?:^|\\n)\\s*Agent ID:\\s*${XAI_UUID_RE}[^\\n]*(?:\\n|$)`, "gi"), "\n")
+      .replace(
+        new RegExp(`(?:^|\\n)\\s*subagent_id:\\s*${XAI_UUID_RE}[^\\n]*(?:\\n|$)`, "gi"),
+        "\n",
+      )
+      .trim() || null;
+
+  let status: "running" | "completed" | "failed";
+  if (toolCall.status === "failed") {
+    status = "failed";
+  } else if (asyncSpawnAck) {
+    // Spawn RPC completed, but the child is still running.
+    status = "running";
+  } else if (toolCall.status === "completed") {
+    status = "completed";
+  } else {
+    status = "running";
+  }
+
+  return {
+    nativeTaskId: toolCall.toolCallId,
+    prompt: nonEmptyString(rawInput?.prompt) ?? "",
+    title: nonEmptyString(rawInput?.description) ?? null,
+    model: nonEmptyString(rawInput?.model) ?? null,
+    status,
+    childSessionId,
+    result: asyncSpawnAck ? null : legacyResult,
+    suppressNormalTool: true,
+  };
 }
 
+const XAiAskUserQuestionOption = Schema.Struct({
+  label: Schema.String,
+  description: Schema.optional(Schema.String),
+  preview: Schema.optional(Schema.String),
+  id: Schema.optional(Schema.String),
+});
+
+const XAiAskUserQuestion = Schema.Struct({
+  id: Schema.optional(Schema.String),
+  question: Schema.String,
+  options: Schema.Array(XAiAskUserQuestionOption),
+  multiSelect: Schema.optional(Schema.NullOr(Schema.Boolean)),
+});
+
+const XAiAskUserQuestionParams = Schema.Struct({
+  sessionId: Schema.String,
+  toolCallId: Schema.String,
+  questions: Schema.Array(XAiAskUserQuestion),
+  mode: Schema.Literals(["default", "plan"]),
+});
+
+const XAiWrappedAskUserQuestionParams = Schema.Struct({
+  method: Schema.Literals(["x.ai/ask_user_question", "_x.ai/ask_user_question"]),
+  params: XAiAskUserQuestionParams,
+});
+
+export const XAiAskUserQuestionRequest = Schema.Union([
+  XAiAskUserQuestionParams,
+  XAiWrappedAskUserQuestionParams,
+]);
+
+type XAiAskUserQuestionRequestParams = typeof XAiAskUserQuestionParams.Type;
+type XAiAskUserQuestionRequest = typeof XAiAskUserQuestionRequest.Type;
+
 // ---------------------------------------------------------------------------
 // x.ai/exit_plan_mode — plan approval gate (mirrors Grok Build TUI plan window)
 // ---------------------------------------------------------------------------
@@ -393,104 +1030,220 @@ export function extractGrokPlanMarkdownFromToolCallData(
     }
   }
 
-  const content = data.content;
-  if (Array.isArray(content)) {
-    for (const block of content) {
-      if (!isRecord(block) || block.type !== "diff") {
-        continue;
-      }
-      const path = typeof block.path === "string" ? block.path : undefined;
-      const newText = typeof block.newText === "string" ? block.newText : undefined;
-      const fromDiff = takePlanText(newText, path);
-      if (fromDiff !== undefined) {
-        return fromDiff;
-      }
-    }
+  const content = data.content;
+  if (Array.isArray(content)) {
+    for (const block of content) {
+      if (!isRecord(block) || block.type !== "diff") {
+        continue;
+      }
+      const path = typeof block.path === "string" ? block.path : undefined;
+      const newText = typeof block.newText === "string" ? block.newText : undefined;
+      const fromDiff = takePlanText(newText, path);
+      if (fromDiff !== undefined) {
+        return fromDiff;
+      }
+    }
+  }
+
+  return sawPlanWrite ? "" : undefined;
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+function trimmed(value: string | undefined): string | undefined {
+  const text = value?.trim();
+  return text && text.length > 0 ? text : undefined;
+}
+
+function unwrapAskUserQuestionParams(
+  params: XAiAskUserQuestionRequest,
+): XAiAskUserQuestionRequestParams {
+  return "params" in params ? params.params : params;
+}
+
+export function extractXAiAskUserQuestions(
+  params: XAiAskUserQuestionRequest,
+): ReadonlyArray<UserInputQuestion> {
+  return unwrapAskUserQuestionParams(params).questions.map((question) => ({
+    id: question.id ?? question.question,
+    header: "Question",
+    question: question.question,
+    multiSelect: question.multiSelect === true,
+    options:
+      question.options.length > 0
+        ? question.options.map((option) => ({
+            label: option.label,
+            description: option.description ?? option.label,
+          }))
+        : [{ label: "OK", description: "Continue" }],
+  }));
+}
+
+export function extractXAiAskUserQuestionIdentity(params: XAiAskUserQuestionRequest): {
+  readonly sessionId: string;
+  readonly toolCallId: string;
+} {
+  const unwrapped = unwrapAskUserQuestionParams(params);
+  return {
+    sessionId: unwrapped.sessionId,
+    toolCallId: unwrapped.toolCallId,
+  };
+}
+
+interface XAiAskUserQuestionAnnotation {
+  readonly preview?: string;
+  readonly notes?: string;
+}
+
+interface XAiAskUserQuestionAcceptedResponse {
+  readonly outcome: "accepted";
+  readonly answers: Record<string, ReadonlyArray<string>>;
+  readonly annotations?: Record<string, XAiAskUserQuestionAnnotation>;
+}
+
+interface XAiAskUserQuestionCancelledResponse {
+  readonly outcome: "cancelled";
+}
+
+export type XAiAskUserQuestionResponse =
+  | XAiAskUserQuestionAcceptedResponse
+  | XAiAskUserQuestionCancelledResponse;
+
+interface NormalizedXAiAnswer {
+  readonly questionText: string;
+  readonly selectedLabels: ReadonlyArray<string>;
+  readonly annotation?: XAiAskUserQuestionAnnotation;
+}
+
+function answerValues(answer: unknown): ReadonlyArray<string> {
+  if (Array.isArray(answer)) {
+    return answer.flatMap((entry) => {
+      const text = typeof entry === "string" ? trimmed(entry) : undefined;
+      return text ? [text] : [];
+    });
+  }
+  const text = typeof answer === "string" ? trimmed(answer) : undefined;
+  return text ? [text] : [];
+}
+
+function normalizeAnswerForXAi(
+  question: XAiAskUserQuestionRequestParams["questions"][number],
+  answer: unknown,
+): NormalizedXAiAnswer | undefined {
+  const values = answerValues(answer);
+  if (values.length === 0) {
+    return undefined;
   }
 
-  return sawPlanWrite ? "" : undefined;
+  const optionByLabel = new Map(question.options.map((option) => [option.label, option]));
+  const resolvedValues = values.map((value) => ({
+    value,
+    option: optionByLabel.get(value),
+  }));
+  const selectedLabels = resolvedValues.flatMap(({ option }) => (option ? [option.label] : []));
+  const notes = resolvedValues.flatMap(({ option, value }) => (option ? [] : [value]));
+  const preview =
+    question.multiSelect === true
+      ? undefined
+      : resolvedValues.map(({ option }) => trimmed(option?.preview)).find((value) => value);
+
+  const annotation =
+    preview || notes.length > 0
+      ? {
+          ...(preview ? { preview } : {}),
+          ...(notes.length > 0 ? { notes: notes.join("\n") } : {}),
+        }
+      : undefined;
+
+  return {
+    questionText: question.question,
+    selectedLabels: selectedLabels.length > 0 ? selectedLabels : ["Other"],
+    ...(annotation ? { annotation } : {}),
+  };
 }
 
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
+function findQuestionAnswer(
+  answers: ProviderUserInputAnswers,
+  question: XAiAskUserQuestionRequestParams["questions"][number],
+): unknown {
+  const key = question.id ?? question.question;
+  return answers[key] ?? answers[question.question];
 }
 
-/**
- * Adds Grok's private prompt-completion fallback around a standards-only ACP runtime.
- * The underlying runtime remains unaware of xAI methods and metadata.
- */
-export const makeXAiPromptCompletionRuntime = Effect.fn("makeXAiPromptCompletionRuntime")(
-  function* (runtime: AcpSessionRuntime.AcpSessionRuntime["Service"]) {
-    const activeSessionIdRef = yield* Ref.make<string | undefined>(undefined);
-    const pendingRef = yield* Ref.make<ReadonlyArray<PendingXAiPromptCompletion>>([]);
-    const completedPromptIdsRef = yield* Ref.make<ReadonlyArray<string>>([]);
-    let nextPromptFallbackId = 0;
-    const allocatePromptFallbackId = Effect.sync(() => {
-      nextPromptFallbackId += 1;
-      return `t3-xai-prompt-${nextPromptFallbackId}`;
-    });
+export function makeXAiAskUserQuestionResponse(
+  params: XAiAskUserQuestionRequest,
+  answers: ProviderUserInputAnswers,
+): XAiAskUserQuestionAcceptedResponse {
+  const questions = unwrapAskUserQuestionParams(params).questions;
+  const normalized = questions.flatMap((question) => {
+    const entry = normalizeAnswerForXAi(question, findQuestionAnswer(answers, question));
+    return entry ? [entry] : [];
+  });
+  const annotations = Object.fromEntries(
+    normalized.flatMap((entry) =>
+      entry.annotation ? [[entry.questionText, entry.annotation] as const] : [],
+    ),
+  );
 
-    yield* runtime.handleExtNotification(
-      "_x.ai/session/prompt_complete",
-      XAiPromptCompleteNotification,
-      (notification) =>
-        resolveXAiPromptCompletionFallback({
-          pendingRef,
-          completedPromptIdsRef,
-          notification,
-        }),
-    );
+  return {
+    outcome: "accepted",
+    answers: Object.fromEntries(
+      normalized.map((entry) => [entry.questionText, entry.selectedLabels]),
+    ),
+    ...(Object.keys(annotations).length > 0 ? { annotations } : {}),
+  };
+}
 
-    return {
-      ...runtime,
-      start: () =>
-        runtime
-          .start()
-          .pipe(Effect.tap((started) => Ref.set(activeSessionIdRef, started.sessionId))),
-      prompt: (payload) =>
-        Effect.gen(function* () {
-          const sessionId = yield* Ref.get(activeSessionIdRef);
-          if (sessionId === undefined) {
-            return yield* runtime.prompt(payload);
-          }
+export function makeXAiAskUserQuestionCancelledResponse(): XAiAskUserQuestionCancelledResponse {
+  return { outcome: "cancelled" };
+}
 
-          const promptId = yield* allocatePromptFallbackId;
-          const fallback = yield* registerXAiPromptCompletionFallback(
-            pendingRef,
-            sessionId,
-            promptId,
-          );
-          const requestPayload = {
-            ...payload,
-            _meta: {
-              ...payload._meta,
-              promptId: fallback.promptId,
-              requestId: fallback.promptId,
-            },
-          } satisfies Omit<EffectAcpSchema.PromptRequest, "sessionId">;
+function promptIdFromResponse(response: EffectAcpSchema.PromptResponse): string | undefined {
+  const meta = response._meta;
+  if (meta === null || typeof meta !== "object") {
+    return undefined;
+  }
+  const promptId = meta.promptId ?? meta.requestId;
+  return typeof promptId === "string" && promptId.length > 0 ? promptId : undefined;
+}
 
-          return yield* Effect.raceFirst(
-            runtime.prompt(requestPayload),
-            Deferred.await(fallback.deferred),
-          ).pipe(
-            Effect.tap((response) =>
-              rememberCompletedXAiPromptId(completedPromptIdsRef, response, fallback.promptId),
-            ),
-            Effect.ensuring(unregisterXAiPromptCompletionFallback(pendingRef, fallback.deferred)),
-          );
-        }),
-      cancel: Ref.get(activeSessionIdRef).pipe(
-        Effect.flatMap((sessionId) =>
-          sessionId === undefined
-            ? runtime.cancel
-            : abortPendingPromptCompletions(pendingRef, sessionId).pipe(
-                Effect.andThen(runtime.cancel),
-              ),
-        ),
-      ),
-    } satisfies AcpSessionRuntime.AcpSessionRuntime["Service"];
-  },
-);
+function normalizeXAiStopReason(value: string | undefined): EffectAcpSchema.StopReason {
+  switch (value) {
+    case "cancelled":
+    case "end_turn":
+    case "max_tokens":
+    case "max_turn_requests":
+    case "refusal":
+      return value;
+    default:
+      return "end_turn";
+  }
+}
+
+function promptResponseFromXAi(
+  notification: XAiPromptCompleteNotification,
+): EffectAcpSchema.PromptResponse {
+  const stopReason = normalizeXAiStopReason(notification.stopReason);
+  const meta: Record<string, unknown> = {
+    sessionId: notification.sessionId,
+  };
+  if (notification.stopReason === undefined) {
+    meta[xAiStopReasonMissingMetaKey] = true;
+  }
+  if (notification.promptId !== undefined) {
+    meta.promptId = notification.promptId;
+    meta.requestId = notification.promptId;
+  }
+  if (notification.agentResult !== undefined) {
+    meta.agentResult = notification.agentResult;
+  }
+  return {
+    stopReason,
+    _meta: meta,
+  };
+}
 
 const registerXAiPromptCompletionFallback = (
   pendingRef: Ref.Ref<ReadonlyArray<PendingXAiPromptCompletion>>,
@@ -511,14 +1264,16 @@ const unregisterXAiPromptCompletionFallback = (
 
 const abortPendingPromptCompletions = (
   pendingRef: Ref.Ref<ReadonlyArray<PendingXAiPromptCompletion>>,
-  sessionId: string,
+  sessionId?: string,
 ) =>
   Ref.modify(pendingRef, (pending) => {
     const [toAbort, remaining] = pending.reduce<
       [ReadonlyArray<PendingXAiPromptCompletion>, ReadonlyArray<PendingXAiPromptCompletion>]
     >(
       ([aborting, kept], entry) =>
-        entry.sessionId === sessionId ? [[...aborting, entry], kept] : [aborting, [...kept, entry]],
+        sessionId === undefined || entry.sessionId === sessionId
+          ? [[...aborting, entry], kept]
+          : [aborting, [...kept, entry]],
       [[], []],
     );
     if (toAbort.length === 0) {
@@ -568,7 +1323,15 @@ const resolveXAiPromptCompletionFallback = ({
                   entry.sessionId === notification.sessionId &&
                   entry.promptId === notification.promptId,
               )
-            : pending.findIndex((entry) => entry.sessionId === notification.sessionId);
+            : (() => {
+                const sessionPendingIndexes = pending.flatMap((entry, entryIndex) =>
+                  entry.sessionId === notification.sessionId ? [entryIndex] : [],
+                );
+                if (sessionPendingIndexes.length !== 1) {
+                  return -1;
+                }
+                return sessionPendingIndexes[0] ?? -1;
+              })();
         if (index < 0) {
           return [Effect.void, pending] as const;
         }
@@ -576,55 +1339,32 @@ const resolveXAiPromptCompletionFallback = ({
         if (!entry) {
           return [Effect.void, pending] as const;
         }
-        return [
-          settleXAiPromptCompletion(entry.deferred, notification),
-          [...pending.slice(0, index), ...pending.slice(index + 1)],
-        ] as const;
+        const settle =
+          notification.stopReason === "rate_limit"
+            ? Deferred.fail(
+                entry.deferred,
+                new EffectAcpErrors.AcpRequestError({
+                  code: xAiRateLimitedErrorCode,
+                  errorMessage: "Grok usage limit reached. Try again later.",
+                }),
+              ).pipe(Effect.asVoid)
+            : Deferred.succeed(entry.deferred, promptResponseFromXAi(notification)).pipe(
+                Effect.asVoid,
+              );
+        return [settle, [...pending.slice(0, index), ...pending.slice(index + 1)]] as const;
       }).pipe(Effect.flatten);
     }),
   );
 
-const settleXAiPromptCompletion = (
-  deferred: Deferred.Deferred<EffectAcpSchema.PromptResponse, EffectAcpErrors.AcpRequestError>,
-  notification: XAiPromptCompleteNotification,
-) => {
-  if (notification.stopReason === "rate_limit") {
-    return Deferred.fail(
-      deferred,
-      new EffectAcpErrors.AcpRequestError({
-        code: xAiRateLimitedErrorCode,
-        errorMessage: "Grok usage limit reached. Try again later.",
-      }),
-    ).pipe(Effect.asVoid);
-  }
-  if (notification.stopReason === "error") {
-    return Deferred.fail(
-      deferred,
-      EffectAcpErrors.AcpRequestError.internalError(
-        xAiAgentResultMessage(notification.agentResult) ?? "Grok prompt failed.",
-      ),
-    ).pipe(Effect.asVoid);
-  }
-  return Deferred.succeed(deferred, promptResponseFromXAi(notification)).pipe(Effect.asVoid);
-};
-
-function xAiAgentResultMessage(value: unknown): string | undefined {
-  if (typeof value === "string") {
-    return trimmed(value);
-  }
-  if (value === null || typeof value !== "object") {
-    return undefined;
-  }
-  const message = "message" in value ? value.message : undefined;
-  return typeof message === "string" ? trimmed(message) : undefined;
-}
-
 const rememberCompletedXAiPromptId = (
   completedPromptIdsRef: Ref.Ref<ReadonlyArray<string>>,
   response: EffectAcpSchema.PromptResponse,
   fallbackPromptId: string,
 ) => {
   const promptId = promptIdFromResponse(response) ?? fallbackPromptId;
+  if (promptId.length === 0) {
+    return Effect.void;
+  }
   return Ref.update(completedPromptIdsRef, (completedPromptIds) => {
     if (completedPromptIds.includes(promptId)) {
       return completedPromptIds;
@@ -633,14 +1373,120 @@ const rememberCompletedXAiPromptId = (
   });
 };
 
-function promptIdFromResponse(response: EffectAcpSchema.PromptResponse): string | undefined {
-  const meta = response._meta;
-  if (meta === null || typeof meta !== "object") {
-    return undefined;
-  }
-  const promptId = meta.promptId ?? meta.requestId;
-  return typeof promptId === "string" && promptId.length > 0 ? promptId : undefined;
-}
+/**
+ * Grok-specific ACP runtime wrapper. Races `session/prompt` against root-matched
+ * terminal notifications:
+ * - session notification/update + `turn_completed` + matching `prompt_id`
+ * - `x.ai/session/prompt_complete` (open-source fire-and-forget signal)
+ * - `_x.ai/session/prompt_complete` (released-build alias)
+ *
+ * Pending entries are keyed by root sessionId + T3-injected promptId, so
+ * foreign/child sessions and `task-completed-*` ids do not settle the root turn.
+ */
+export const makeXAiPromptCompletionRuntime = Effect.fn("makeXAiPromptCompletionRuntime")(
+  function* (runtime: AcpSessionRuntime.AcpSessionRuntime["Service"]) {
+    let nextPromptFallbackId = 0;
+    const allocatePromptFallbackId = Effect.sync(() => {
+      nextPromptFallbackId += 1;
+      return `t3-xai-prompt-${nextPromptFallbackId}`;
+    });
+    const pendingXAiPromptCompletionsRef = yield* Ref.make<
+      ReadonlyArray<PendingXAiPromptCompletion>
+    >([]);
+    const completedXAiPromptIdsRef = yield* Ref.make<ReadonlyArray<string>>([]);
+
+    const settleFromPromptComplete = (notification: XAiPromptCompleteNotification) =>
+      resolveXAiPromptCompletionFallback({
+        pendingRef: pendingXAiPromptCompletionsRef,
+        completedPromptIdsRef: completedXAiPromptIdsRef,
+        notification,
+      }).pipe(Effect.catch(() => Effect.void));
+
+    yield* Effect.forEach(
+      ["x.ai/session/prompt_complete", "_x.ai/session/prompt_complete"] as const,
+      (method) =>
+        runtime.handleExtNotification(
+          method,
+          XAiPromptCompleteNotification,
+          settleFromPromptComplete,
+        ),
+      { discard: true },
+    );
+
+    yield* Effect.forEach(
+      ["x.ai/session_notification", "_x.ai/session_notification", "_x.ai/session/update"] as const,
+      (method) =>
+        runtime.handleExtNotification(method, XAiSessionUpdateNotification, (notification) => {
+          const complete = xAiPromptCompleteFromSessionUpdate(notification);
+          if (complete === null) {
+            return Effect.void;
+          }
+          return settleFromPromptComplete(complete);
+        }),
+      { discard: true },
+    );
+
+    return {
+      ...runtime,
+      prompt: (payload) =>
+        Effect.gen(function* () {
+          const started = yield* runtime.start();
+          const promptId = yield* allocatePromptFallbackId;
+          const fallback = yield* registerXAiPromptCompletionFallback(
+            pendingXAiPromptCompletionsRef,
+            started.sessionId,
+            promptId,
+          );
+          const cancelledResponse = promptResponseFromXAi({
+            sessionId: started.sessionId,
+            promptId: fallback.promptId,
+            stopReason: "cancelled",
+            agentResult: null,
+          });
+          const promptRpcFiber = yield* runtime
+            .prompt({
+              ...payload,
+              _meta: {
+                ...payload._meta,
+                promptId: fallback.promptId,
+                requestId: fallback.promptId,
+              },
+            })
+            .pipe(Effect.forkChild);
+          return yield* Effect.raceFirst(
+            Fiber.join(promptRpcFiber).pipe(
+              Effect.catchCause((cause) =>
+                Cause.hasInterruptsOnly(cause)
+                  ? Effect.succeed(cancelledResponse)
+                  : Effect.failCause(cause),
+              ),
+            ),
+            Deferred.await(fallback.deferred),
+          ).pipe(
+            Effect.tap((response) =>
+              rememberCompletedXAiPromptId(completedXAiPromptIdsRef, response, fallback.promptId),
+            ),
+            Effect.ensuring(
+              Effect.gen(function* () {
+                yield* Fiber.interrupt(promptRpcFiber).pipe(Effect.ignore);
+                yield* unregisterXAiPromptCompletionFallback(
+                  pendingXAiPromptCompletionsRef,
+                  fallback.deferred,
+                );
+              }),
+            ),
+          );
+        }),
+      cancel: Effect.gen(function* () {
+        // Do not call start here: cancellation must be able to reach the
+        // underlying runtime when startup is stalled. Pending entries already
+        // carry their session ids, and this runtime owns all of them.
+        yield* abortPendingPromptCompletions(pendingXAiPromptCompletionsRef);
+        yield* runtime.cancel;
+      }),
+    } satisfies AcpSessionRuntime.AcpSessionRuntime["Service"];
+  },
+);
 
 export function promptResponseHasMissingXAiStopReason(
   response: EffectAcpSchema.PromptResponse,
@@ -648,39 +1494,3 @@ export function promptResponseHasMissingXAiStopReason(
   const meta = response._meta;
   return meta !== null && typeof meta === "object" && meta[xAiStopReasonMissingMetaKey] === true;
 }
-
-function promptResponseFromXAi(
-  notification: XAiPromptCompleteNotification,
-): EffectAcpSchema.PromptResponse {
-  const stopReason = normalizeXAiStopReason(notification.stopReason);
-  const meta: Record<string, unknown> = {
-    sessionId: notification.sessionId,
-  };
-  if (notification.stopReason === undefined) {
-    meta[xAiStopReasonMissingMetaKey] = true;
-  }
-  if (notification.promptId !== undefined) {
-    meta.promptId = notification.promptId;
-    meta.requestId = notification.promptId;
-  }
-  if (notification.agentResult !== undefined) {
-    meta.agentResult = notification.agentResult;
-  }
-  return {
-    stopReason,
-    _meta: meta,
-  };
-}
-
-function normalizeXAiStopReason(value: string | undefined): EffectAcpSchema.StopReason {
-  switch (value) {
-    case "cancelled":
-    case "end_turn":
-    case "max_tokens":
-    case "max_turn_requests":
-    case "refusal":
-      return value;
-    default:
-      return "end_turn";
-  }
-}
diff --git a/apps/server/src/provider/builtInDrivers.ts b/apps/server/src/provider/builtInDrivers.ts
index 791a96e1da3c..bbff99705d2b 100644
--- a/apps/server/src/provider/builtInDrivers.ts
+++ b/apps/server/src/provider/builtInDrivers.ts
@@ -20,6 +20,7 @@
  *
  * @module provider/builtInDrivers
  */
+import { AcpRegistryDriver, type AcpRegistryDriverEnv } from "./Drivers/AcpRegistryDriver.ts";
 import { ClaudeDriver, type ClaudeDriverEnv } from "./Drivers/ClaudeDriver.ts";
 import { CodexDriver, type CodexDriverEnv } from "./Drivers/CodexDriver.ts";
 import { CursorDriver, type CursorDriverEnv } from "./Drivers/CursorDriver.ts";
@@ -33,6 +34,7 @@ import type { AnyProviderDriver } from "./ProviderDriver.ts";
  * layer must provide every service in this union.
  */
 export type BuiltInDriversEnv =
+  | AcpRegistryDriverEnv
   | ClaudeDriverEnv
   | CodexDriverEnv
   | CursorDriverEnv
@@ -50,4 +52,5 @@ export const BUILT_IN_DRIVERS: ReadonlyArray<AnyProviderDriver<BuiltInDriversEnv
   CursorDriver,
   GrokDriver,
   OpenCodeDriver,
+  AcpRegistryDriver,
 ];
diff --git a/apps/server/src/provider/cursorSdkModel.ts b/apps/server/src/provider/cursorSdkModel.ts
new file mode 100644
index 000000000000..c64e24b0a060
--- /dev/null
+++ b/apps/server/src/provider/cursorSdkModel.ts
@@ -0,0 +1,52 @@
+import type { ModelSelection as CursorSdkModelSelection, ModelParameterValue } from "@cursor/sdk";
+import type { ModelSelection } from "@t3tools/contracts";
+
+const CURSOR_SDK_PARAMETER_TO_PROVIDER_OPTION: Readonly<Record<string, string>> = {
+  context: "contextWindow",
+  fast: "fastMode",
+};
+
+const PROVIDER_OPTION_TO_CURSOR_SDK_PARAMETER: Readonly<Record<string, string>> = {
+  contextWindow: "context",
+  fastMode: "fast",
+};
+
+export function cursorSdkProviderOptionId(parameterId: string): string {
+  return CURSOR_SDK_PARAMETER_TO_PROVIDER_OPTION[parameterId] ?? parameterId;
+}
+
+export function cursorSdkParameterId(providerOptionId: string): string {
+  return PROVIDER_OPTION_TO_CURSOR_SDK_PARAMETER[providerOptionId] ?? providerOptionId;
+}
+
+export function cursorSdkParameterPriority(parameterId: string): number {
+  switch (parameterId) {
+    case "effort":
+    case "reasoning":
+      return 0;
+    case "context":
+      return 1;
+    case "fast":
+      return 2;
+    case "thinking":
+      return 3;
+    default:
+      return 4;
+  }
+}
+
+export function cursorSdkModelSelection(modelSelection: ModelSelection): CursorSdkModelSelection {
+  return {
+    id: modelSelection.model === "auto" ? "default" : modelSelection.model,
+    ...(modelSelection.options === undefined || modelSelection.options.length === 0
+      ? {}
+      : {
+          params: modelSelection.options.map(
+            (option): ModelParameterValue => ({
+              id: cursorSdkParameterId(option.id),
+              value: String(option.value),
+            }),
+          ),
+        }),
+  };
+}
diff --git a/apps/server/src/provider/providerMaintenanceRunner.test.ts b/apps/server/src/provider/providerMaintenanceRunner.test.ts
index 641c9b52e56c..07728e02b155 100644
--- a/apps/server/src/provider/providerMaintenanceRunner.test.ts
+++ b/apps/server/src/provider/providerMaintenanceRunner.test.ts
@@ -30,10 +30,10 @@ import {
 const isServerProviderUpdateError = Schema.is(ServerProviderUpdateError);
 
 const CODEX_DRIVER = ProviderDriverKind.make("codex");
-const CURSOR_DRIVER = ProviderDriverKind.make("cursor");
+const NATIVE_CLI_DRIVER = ProviderDriverKind.make("nativeCli");
 const OPENCODE_DRIVER = ProviderDriverKind.make("opencode");
 const CODEX_INSTANCE_ID = ProviderInstanceId.make("codex");
-const CURSOR_INSTANCE_ID = ProviderInstanceId.make("cursor");
+const NATIVE_CLI_INSTANCE_ID = ProviderInstanceId.make("nativeCli");
 const OPENCODE_INSTANCE_ID = ProviderInstanceId.make("opencode");
 const encoder = new TextEncoder();
 
@@ -44,13 +44,13 @@ const encoder = new TextEncoder();
 const NonWindowsPlatform = Layer.succeed(HostProcessPlatform, "linux");
 
 function lifecycleFor(provider: ProviderDriverKind): ProviderMaintenanceCapabilities {
-  if (provider === CURSOR_DRIVER) {
+  if (provider === NATIVE_CLI_DRIVER) {
     return makeProviderMaintenanceCapabilities({
       provider,
       packageName: null,
-      updateExecutable: "cursor-agent",
+      updateExecutable: "native-agent",
       updateArgs: ["update"],
-      updateLockKey: "cursor-agent",
+      updateLockKey: "native-agent",
     });
   }
   return makeProviderMaintenanceCapabilities({
@@ -79,10 +79,10 @@ const baseProvider: ServerProvider = {
   skills: [],
 };
 
-const baseCursorProvider: ServerProvider = {
+const baseNativeCliProvider: ServerProvider = {
   ...baseProvider,
-  instanceId: CURSOR_INSTANCE_ID,
-  driver: CURSOR_DRIVER,
+  instanceId: NATIVE_CLI_INSTANCE_ID,
+  driver: NATIVE_CLI_DRIVER,
 };
 
 const baseOpenCodeProvider: ServerProvider = {
@@ -220,13 +220,13 @@ describe("providerMaintenanceRunner", () => {
   it.effect("runs the allowlisted provider update command and records success", () => {
     const calls: Array<{ command: string; args: ReadonlyArray<string> }> = [];
     return Effect.gen(function* () {
-      const { registry, updateStatesRef } = yield* makeRegistry(baseCursorProvider);
+      const { registry, updateStatesRef } = yield* makeRegistry(baseNativeCliProvider);
       const updater = yield* makeTestRunner(registry);
 
-      const result = yield* updater.updateProvider(CURSOR_DRIVER);
+      const result = yield* updater.updateProvider(NATIVE_CLI_DRIVER);
       assert.deepStrictEqual(calls, [
         {
-          command: "cursor-agent",
+          command: "native-agent",
           args: ["update"],
         },
       ]);
diff --git a/apps/server/src/provider/testUtils/providerAdapterRegistryMock.ts b/apps/server/src/provider/testUtils/providerAdapterRegistryMock.ts
deleted file mode 100644
index c696a51c37ee..000000000000
--- a/apps/server/src/provider/testUtils/providerAdapterRegistryMock.ts
+++ /dev/null
@@ -1,99 +0,0 @@
-/**
- * Test helpers for constructing a `ProviderAdapterRegistryShape` mock from a
- * kind-keyed adapter map.
- *
- * Tests historically assembled a `registry` object with only `getByProvider`
- * + `listProviders` populated. Slice D grew the shape with `getByInstance`
- * and `listInstances`; this helper fills both in from a single kind-keyed
- * input so individual fixtures can stay concise.
- *
- * Non-default instance ids (e.g. `codex_personal`) are not addressable via
- * the shim returned here — the legacy test fixtures only ever had
- * single-instance-per-driver data anyway.
- *
- * @module provider/testUtils/providerAdapterRegistryMock
- */
-import {
-  defaultInstanceIdForDriver,
-  ProviderDriverKind,
-  type ProviderInstanceId,
-} from "@t3tools/contracts";
-import * as Effect from "effect/Effect";
-import * as PubSub from "effect/PubSub";
-import * as Record from "effect/Record";
-import * as Result from "effect/Result";
-import * as Stream from "effect/Stream";
-
-import { ProviderUnsupportedError, type ProviderAdapterError } from "../Errors.ts";
-import type { ProviderAdapterShape } from "../Services/ProviderAdapter.ts";
-import type { ProviderAdapterRegistryShape } from "../Services/ProviderAdapterRegistry.ts";
-
-export type KindAdapterMap = Partial<
-  Record<ProviderDriverKind, ProviderAdapterShape<ProviderAdapterError>>
->;
-
-/**
- * Build a `ProviderAdapterRegistryShape` from a kind-keyed adapter map.
- * Every adapter present in the map is addressable via both the legacy
- * `getByProvider(kind)` path and the new `getByInstance(id)` path (where
- * `id = defaultInstanceIdForDriver(kind)`).
- */
-export const makeAdapterRegistryMock = (adapters: KindAdapterMap): ProviderAdapterRegistryShape => {
-  const byInstanceId = new Map<ProviderInstanceId, ProviderAdapterShape<ProviderAdapterError>>();
-  for (const [kind, adapter] of Object.entries(adapters)) {
-    if (!adapter) continue;
-    const driverKind = ProviderDriverKind.make(kind);
-    byInstanceId.set(defaultInstanceIdForDriver(driverKind), adapter);
-  }
-
-  const getByInstance: ProviderAdapterRegistryShape["getByInstance"] = (instanceId) => {
-    const adapter = byInstanceId.get(instanceId);
-    return adapter
-      ? Effect.succeed(adapter)
-      : Effect.fail(
-          new ProviderUnsupportedError({
-            provider: ProviderDriverKind.make(instanceId),
-          }),
-        );
-  };
-
-  return {
-    getByInstance,
-    getInstanceInfo: (instanceId) => {
-      const adapter = byInstanceId.get(instanceId);
-      if (!adapter) {
-        return Effect.fail(
-          new ProviderUnsupportedError({
-            provider: ProviderDriverKind.make(instanceId),
-          }),
-        );
-      }
-      return Effect.succeed({
-        instanceId,
-        driverKind: ProviderDriverKind.make(adapter.provider),
-        displayName: undefined,
-        enabled: true,
-        continuationIdentity: {
-          driverKind: ProviderDriverKind.make(adapter.provider),
-          continuationKey: `${adapter.provider}:instance:${instanceId}`,
-        },
-      });
-    },
-    listInstances: () => Effect.succeed(Array.from(byInstanceId.keys())),
-    listProviders: () =>
-      Effect.succeed(
-        Record.keys(
-          Record.filterMap(adapters, (adapter, kind) =>
-            adapter !== undefined ? Result.succeed(kind) : Result.failVoid,
-          ),
-        ),
-      ),
-    // Static test fixtures don't reload; an empty stream is enough to
-    // satisfy the shape. Tests exercising hot-reload build their own
-    // stream via the real `ProviderInstanceRegistry`.
-    streamChanges: Stream.empty,
-    subscribeChanges: Effect.flatMap(PubSub.unbounded<void>(), (pubsub) =>
-      PubSub.subscribe(pubsub),
-    ),
-  };
-};
diff --git a/apps/server/src/relay/AgentAwarenessRelay.test.ts b/apps/server/src/relay/AgentAwarenessRelay.test.ts
deleted file mode 100644
index 74a4de594a15..000000000000
--- a/apps/server/src/relay/AgentAwarenessRelay.test.ts
+++ /dev/null
@@ -1,725 +0,0 @@
-import * as NodeCrypto from "node:crypto";
-import * as NodeServices from "@effect/platform-node/NodeServices";
-
-import type {
-  EnvironmentId,
-  ExecutionEnvironmentDescriptor,
-  OrchestrationEvent,
-  OrchestrationProjectShell,
-  OrchestrationShellSnapshot,
-  OrchestrationThreadShell,
-  ProjectId,
-  ThreadId,
-  TurnId,
-} from "@t3tools/contracts";
-import type {
-  RelayAgentActivityPublishProofPayload,
-  RelayAgentActivityState,
-} from "@t3tools/contracts/relay";
-import { CommandId, ProviderInstanceId } from "@t3tools/contracts";
-import { RelayClientTracer } from "@t3tools/shared/relayTracing";
-import { RELAY_ACTIVITY_PUBLISH_TYP, verifyRelayJwt } from "@t3tools/shared/relayJwt";
-import { describe, expect, it } from "@effect/vitest";
-import * as Deferred from "effect/Deferred";
-import * as Effect from "effect/Effect";
-import * as Layer from "effect/Layer";
-import * as Option from "effect/Option";
-import * as Queue from "effect/Queue";
-import * as Stream from "effect/Stream";
-import * as Tracer from "effect/Tracer";
-
-import * as ServerSecretStore from "../auth/ServerSecretStore.ts";
-import * as ServerEnvironment from "../environment/ServerEnvironment.ts";
-import {
-  OrchestrationEngineService,
-  type OrchestrationEngineShape,
-} from "../orchestration/Services/OrchestrationEngine.ts";
-import {
-  ProjectionSnapshotQuery,
-  type ProjectionSnapshotQueryShape,
-} from "../orchestration/Services/ProjectionSnapshotQuery.ts";
-import {
-  RELAY_ENVIRONMENT_CREDENTIAL_SECRET,
-  RELAY_ISSUER_SECRET,
-  RELAY_URL_SECRET,
-  PUBLISH_AGENT_ACTIVITY_SECRET,
-} from "../cloud/config.ts";
-import * as AgentAwarenessRelay from "./AgentAwarenessRelay.ts";
-
-const state: RelayAgentActivityState = {
-  environmentId: "env" as RelayAgentActivityState["environmentId"],
-  threadId: "thread" as RelayAgentActivityState["threadId"],
-  projectTitle: "Project",
-  threadTitle: "Thread",
-  modelTitle: "gpt-5.4",
-  phase: "running",
-  headline: "Running",
-  updatedAt: "2026-05-25T00:00:00.000Z",
-  deepLink: "/threads/env/thread",
-};
-
-const encodeSecret = (value: string): Uint8Array => new TextEncoder().encode(value);
-
-function makeMemorySecretStore() {
-  const values = new Map<string, Uint8Array>();
-  const store = {
-    get: ((name) =>
-      Effect.sync(() => {
-        const value = values.get(name);
-        return value === undefined ? Option.none() : Option.some(Uint8Array.from(value));
-      })) satisfies ServerSecretStore.ServerSecretStore["Service"]["get"],
-    set: ((name, value) =>
-      Effect.sync(() => {
-        values.set(name, Uint8Array.from(value));
-      })) satisfies ServerSecretStore.ServerSecretStore["Service"]["set"],
-    create: ((name, value) =>
-      Effect.sync(() => {
-        values.set(name, Uint8Array.from(value));
-      })) satisfies ServerSecretStore.ServerSecretStore["Service"]["create"],
-    getOrCreateRandom: ((name, bytes) =>
-      Effect.sync(() => {
-        const existing = values.get(name);
-        if (existing) {
-          return existing;
-        }
-        const generated = new Uint8Array(bytes);
-        values.set(name, generated);
-        return generated;
-      })) satisfies ServerSecretStore.ServerSecretStore["Service"]["getOrCreateRandom"],
-    remove: ((name) =>
-      Effect.sync(() => {
-        values.delete(name);
-      })) satisfies ServerSecretStore.ServerSecretStore["Service"]["remove"],
-  } satisfies ServerSecretStore.ServerSecretStore["Service"];
-  return {
-    store,
-    setString: (name: string, value: string) => store.set(name, encodeSecret(value)),
-  };
-}
-
-describe.sequential("signRelayAgentActivityPublishProof", () => {
-  it("distinguishes pending link credentials from disabled publication", () => {
-    expect(
-      AgentAwarenessRelay.resolveAgentActivityPublishingStartupState({
-        relayConfigured: false,
-        publishEnabled: false,
-      }),
-    ).toBe("waiting-for-link");
-    expect(
-      AgentAwarenessRelay.resolveAgentActivityPublishingStartupState({
-        relayConfigured: true,
-        publishEnabled: false,
-      }),
-    ).toBe("disabled");
-    expect(
-      AgentAwarenessRelay.resolveAgentActivityPublishingStartupState({
-        relayConfigured: true,
-        publishEnabled: true,
-      }),
-    ).toBe("enabled");
-  });
-
-  it("derives the thread id from the aggregate id for thread events without payload thread ids", () => {
-    const threadId = "thread-aggregate-1" as ThreadId;
-    const now = "2026-05-25T00:00:00.000Z";
-    const event = {
-      type: "thread.activity-appended",
-      sequence: 1,
-      eventId: "evt-aggregate-1",
-      commandId: CommandId.make("cmd-1"),
-      aggregateKind: "thread",
-      aggregateId: threadId,
-      actor: { kind: "server" },
-      payload: {},
-      occurredAt: now,
-    } as unknown as OrchestrationEvent;
-
-    expect(AgentAwarenessRelay.eventThreadId(event)).toBe(threadId);
-  });
-
-  it("does not publish start intents, streaming content, or non-awareness activity events", () => {
-    const now = "2026-05-25T00:00:00.000Z";
-    const base = {
-      sequence: 1,
-      eventId: "evt-1",
-      commandId: CommandId.make("cmd-1"),
-      aggregateKind: "thread",
-      aggregateId: "thread-1" as ThreadId,
-      occurredAt: now,
-    };
-
-    expect(
-      AgentAwarenessRelay.shouldPublishAgentAwarenessEvent({
-        ...base,
-        type: "thread.message-sent",
-        payload: {
-          threadId: "thread-1" as ThreadId,
-          streaming: true,
-        },
-      } as unknown as OrchestrationEvent),
-    ).toBe(false);
-    expect(
-      AgentAwarenessRelay.shouldPublishAgentAwarenessEvent({
-        ...base,
-        type: "thread.activity-appended",
-        payload: {
-          threadId: "thread-1" as ThreadId,
-          activity: {
-            kind: "task.progress",
-          },
-        },
-      } as unknown as OrchestrationEvent),
-    ).toBe(false);
-    expect(
-      AgentAwarenessRelay.shouldPublishAgentAwarenessEvent({
-        ...base,
-        type: "thread.activity-appended",
-        payload: {
-          threadId: "thread-1" as ThreadId,
-          activity: {
-            kind: "approval.requested",
-          },
-        },
-      } as unknown as OrchestrationEvent),
-    ).toBe(true);
-    expect(
-      AgentAwarenessRelay.shouldPublishAgentAwarenessEvent({
-        ...base,
-        type: "thread.message-sent",
-        payload: {
-          threadId: "thread-1" as ThreadId,
-          streaming: false,
-        },
-      } as unknown as OrchestrationEvent),
-    ).toBe(false);
-    expect(
-      AgentAwarenessRelay.shouldPublishAgentAwarenessEvent({
-        ...base,
-        type: "thread.turn-start-requested",
-        payload: {
-          threadId: "thread-1" as ThreadId,
-        },
-      } as unknown as OrchestrationEvent),
-    ).toBe(false);
-  });
-
-  it("deduplicates awareness state updates whose only change is their event timestamp", () => {
-    expect(AgentAwarenessRelay.agentAwarenessPublishIdentity(state)).toBe(
-      AgentAwarenessRelay.agentAwarenessPublishIdentity({
-        ...state,
-        updatedAt: "2026-05-25T00:10:00.000Z",
-      }),
-    );
-    expect(AgentAwarenessRelay.agentAwarenessPublishIdentity(state)).not.toBe(
-      AgentAwarenessRelay.agentAwarenessPublishIdentity({
-        ...state,
-        phase: "completed",
-        headline: "Agent finished",
-      }),
-    );
-  });
-
-  it("requires an explicit opt-in before publishing agent activity", () => {
-    expect(AgentAwarenessRelay.isAgentActivityPublishingEnabled(null)).toBe(false);
-    expect(AgentAwarenessRelay.isAgentActivityPublishingEnabled("false")).toBe(false);
-    expect(AgentAwarenessRelay.isAgentActivityPublishingEnabled("true")).toBe(true);
-  });
-
-  it("redacts failed activity details and caps other relay detail", () => {
-    expect(
-      AgentAwarenessRelay.sanitizeRelayAgentActivityState({
-        ...state,
-        phase: "failed",
-        detail: "Provider process exited with secret token.",
-      }),
-    ).toMatchObject({
-      phase: "failed",
-      detail: "The agent run failed.",
-    });
-    expect(
-      AgentAwarenessRelay.sanitizeRelayAgentActivityState({
-        ...state,
-        detail: "x".repeat(200),
-      })?.detail,
-    ).toHaveLength(160);
-  });
-
-  it("resolves a null publish state when a thread or project snapshot disappeared", () => {
-    const environmentId = "env-1" as EnvironmentId;
-    const threadId = "thread-1" as ThreadId;
-    const thread = {
-      id: threadId,
-      projectId: "project-1" as ProjectId,
-      title: "Deleted thread",
-      modelSelection: { instanceId: ProviderInstanceId.make("codex"), model: "gpt-5.4" },
-      session: null,
-      latestTurn: null,
-      updatedAt: "2026-05-25T00:00:00.000Z",
-      hasPendingApprovals: false,
-      hasPendingUserInput: false,
-    } as OrchestrationThreadShell;
-
-    expect(
-      AgentAwarenessRelay.resolveAgentAwarenessRelayPublishSnapshot({
-        environmentId,
-        threadId,
-        thread: Option.none(),
-        project: Option.none(),
-      }),
-    ).toEqual({
-      projectId: null,
-      state: null,
-      reason: "thread-not-found",
-    });
-
-    expect(
-      AgentAwarenessRelay.resolveAgentAwarenessRelayPublishSnapshot({
-        environmentId,
-        threadId,
-        thread: Option.some(thread),
-        project: Option.none(),
-      }),
-    ).toEqual({
-      projectId: "project-1",
-      state: null,
-      reason: "project-not-found",
-    });
-  });
-
-  it("selects only active shell snapshot threads for startup catch-up", () => {
-    const now = "2026-05-25T00:00:00.000Z";
-    const environmentId = "env-1" as EnvironmentId;
-    const projectId = "project-1" as ProjectId;
-    const activeThreadId = "thread-active" as ThreadId;
-    const idleThreadId = "thread-idle" as ThreadId;
-
-    const baseThread = {
-      projectId,
-      title: "Run remote agent",
-      modelSelection: { instanceId: ProviderInstanceId.make("codex"), model: "gpt-5.4" },
-      runtimeMode: "full-access",
-      interactionMode: "default",
-      branch: null,
-      worktreePath: null,
-      latestTurn: null,
-      createdAt: now,
-      updatedAt: now,
-      archivedAt: null,
-      settledOverride: null,
-      settledAt: null,
-      session: null,
-      latestUserMessageAt: null,
-      hasPendingApprovals: false,
-      hasPendingUserInput: false,
-      hasActionableProposedPlan: false,
-    } satisfies Omit<OrchestrationThreadShell, "id">;
-
-    expect(
-      AgentAwarenessRelay.resolveAgentAwarenessRelayActiveThreadIds({
-        environmentId,
-        projects: [
-          {
-            id: projectId,
-            title: "T3 Code",
-          },
-        ],
-        threads: [
-          {
-            ...baseThread,
-            id: activeThreadId,
-            latestTurn: {
-              turnId: "turn-1" as TurnId,
-              state: "running",
-              requestedAt: now,
-              startedAt: now,
-              completedAt: null,
-              assistantMessageId: null,
-            },
-          },
-          {
-            ...baseThread,
-            id: idleThreadId,
-          },
-          {
-            ...baseThread,
-            id: "thread-missing-project" as ThreadId,
-            projectId: "missing-project" as ProjectId,
-            latestTurn: {
-              turnId: "turn-2" as TurnId,
-              state: "running",
-              requestedAt: now,
-              startedAt: now,
-              completedAt: null,
-              assistantMessageId: null,
-            },
-          },
-        ],
-      }),
-    ).toEqual([activeThreadId]);
-  });
-
-  it("signs the activity publish JWT and rejects tampering", async () => {
-    const keyPair = NodeCrypto.generateKeyPairSync("ed25519", {
-      privateKeyEncoding: { format: "pem", type: "pkcs8" },
-      publicKeyEncoding: { format: "pem", type: "spki" },
-    });
-    const payload = {
-      iss: "t3-env:env",
-      aud: "https://relay.example.test",
-      sub: "env",
-      jti: "nonce-1",
-      iat: 100,
-      exp: 200,
-      environmentId: state.environmentId,
-      threadId: state.threadId,
-      state,
-    } satisfies RelayAgentActivityPublishProofPayload;
-    const proof = await Effect.runPromise(
-      AgentAwarenessRelay.signRelayAgentActivityPublishProof({
-        privateKey: keyPair.privateKey,
-        payload,
-      }),
-    );
-
-    await expect(
-      Effect.runPromise(
-        verifyRelayJwt({
-          publicKey: keyPair.publicKey,
-          token: proof,
-          typ: RELAY_ACTIVITY_PUBLISH_TYP,
-          issuer: "t3-env:env",
-          audience: "https://relay.example.test",
-          nowEpochSeconds: 150,
-        }),
-      ),
-    ).resolves.toMatchObject({ jti: "nonce-1", state });
-    await expect(
-      Effect.runPromise(
-        verifyRelayJwt({
-          publicKey: keyPair.publicKey,
-          token: (() => {
-            const [header, body, signature = ""] = proof.split(".");
-            const corruptedSignature = `${signature.startsWith("a") ? "b" : "a"}${signature.slice(1)}`;
-            return `${header}.${body}.${corruptedSignature}`;
-          })(),
-          typ: RELAY_ACTIVITY_PUBLISH_TYP,
-          issuer: "t3-env:env",
-          audience: "https://relay.example.test",
-          nowEpochSeconds: 150,
-        }),
-      ),
-    ).rejects.toBeDefined();
-  });
-
-  it.effect("keeps the orchestration listener armed until relay config is installed", () =>
-    Effect.scoped(
-      Effect.gen(function* () {
-        const events = yield* Queue.unbounded<OrchestrationEvent>();
-        const threadShellRequested = yield* Deferred.make<void>();
-        const secrets = makeMemorySecretStore();
-        const now = "2026-05-25T00:00:00.000Z";
-        const projectId = "project-1" as ProjectId;
-        const threadId = "thread-1" as ThreadId;
-        const environmentId = "env-1" as EnvironmentId;
-
-        const project = {
-          id: projectId,
-          title: "T3 Code",
-          workspaceRoot: "/workspace",
-          repositoryIdentity: null,
-          defaultModelSelection: null,
-          scripts: [],
-          createdAt: now,
-          updatedAt: now,
-        } satisfies OrchestrationProjectShell;
-
-        const thread = {
-          id: threadId,
-          projectId,
-          title: "Run remote agent",
-          modelSelection: { instanceId: ProviderInstanceId.make("codex"), model: "gpt-5.4" },
-          runtimeMode: "full-access",
-          interactionMode: "default",
-          branch: null,
-          worktreePath: null,
-          latestTurn: {
-            turnId: "turn-1" as TurnId,
-            state: "running",
-            requestedAt: now,
-            startedAt: now,
-            completedAt: null,
-            assistantMessageId: null,
-          },
-          createdAt: now,
-          updatedAt: now,
-          archivedAt: null,
-          settledOverride: null,
-          settledAt: null,
-          session: {
-            threadId,
-            status: "running",
-            providerName: "Codex",
-            runtimeMode: "full-access",
-            activeTurnId: "turn-1" as TurnId,
-            lastError: null,
-            updatedAt: now,
-          },
-          latestUserMessageAt: now,
-          hasPendingApprovals: false,
-          hasPendingUserInput: false,
-          hasActionableProposedPlan: false,
-        } satisfies OrchestrationThreadShell;
-
-        const orchestrationEngine = {
-          readEvents: () => Stream.empty,
-          dispatch: () => Effect.succeed({ sequence: 1 }),
-          streamDomainEvents: Stream.fromQueue(events),
-          latestSequence: Effect.succeed(0),
-        } satisfies OrchestrationEngineShape;
-
-        const snapshotQuery = {
-          getShellSnapshot: () =>
-            Effect.succeed({
-              snapshotSequence: 1,
-              projects: [project],
-              threads: [thread],
-              updatedAt: now,
-            } satisfies OrchestrationShellSnapshot),
-          getThreadShellById: () =>
-            Deferred.succeed(threadShellRequested, undefined).pipe(
-              Effect.ignore,
-              Effect.as(Option.some(thread)),
-            ),
-          getProjectShellById: () => Effect.succeed(Option.some(project)),
-        } as unknown as ProjectionSnapshotQueryShape;
-
-        const descriptor = {
-          environmentId,
-          label: "Test Desktop",
-          platform: {
-            os: "darwin",
-            arch: "arm64",
-          },
-          serverVersion: "0.0.0-test",
-          capabilities: {
-            repositoryIdentity: true,
-          },
-        } satisfies ExecutionEnvironmentDescriptor;
-
-        const layer = Layer.mergeAll(
-          Layer.succeed(ServerSecretStore.ServerSecretStore, secrets.store),
-          Layer.succeed(ServerEnvironment.ServerEnvironment, {
-            getEnvironmentId: Effect.succeed(environmentId),
-            getDescriptor: Effect.succeed(descriptor),
-          }),
-          Layer.succeed(OrchestrationEngineService, orchestrationEngine),
-          Layer.succeed(ProjectionSnapshotQuery, snapshotQuery),
-        );
-
-        yield* Effect.gen(function* () {
-          const relay = yield* AgentAwarenessRelay.AgentAwarenessRelay;
-          yield* relay.start();
-          yield* secrets.setString(RELAY_URL_SECRET, "http://127.0.0.1:1");
-          yield* secrets.setString(RELAY_ENVIRONMENT_CREDENTIAL_SECRET, "relay-credential");
-          yield* secrets.setString(PUBLISH_AGENT_ACTIVITY_SECRET, "true");
-          yield* Queue.offer(events, {
-            type: "thread.activity-appended",
-            sequence: 1,
-            eventId: "evt-1",
-            commandId: CommandId.make("cmd-1"),
-            aggregateKind: "thread",
-            aggregateId: threadId,
-            actor: { kind: "server" },
-            payload: {
-              threadId,
-              activity: {
-                kind: "approval.requested",
-              },
-            },
-            occurredAt: now,
-          } as unknown as OrchestrationEvent);
-
-          yield* Deferred.await(threadShellRequested).pipe(Effect.timeout("2 seconds"));
-        }).pipe(
-          Effect.provide(
-            AgentAwarenessRelay.layer.pipe(
-              Layer.provide(layer),
-              Layer.provideMerge(NodeServices.layer),
-            ),
-          ),
-        );
-      }),
-    ),
-  );
-
-  it.effect("publishes agent activity to the relay transport URL, not the relay issuer", () =>
-    Effect.scoped(
-      Effect.gen(function* () {
-        const originalFetch = globalThis.fetch;
-        const context = yield* Effect.context<never>();
-        const runFork = Effect.runForkWith(context);
-        const events = yield* Queue.unbounded<OrchestrationEvent>();
-        const fetchSeen = yield* Deferred.make<URL>();
-        const userSpans: Array<string> = [];
-        const productSpans: Array<string> = [];
-        const collectingTracer = (spans: Array<string>) =>
-          Tracer.make({
-            span: (options) => {
-              const span = new Tracer.NativeSpan(options);
-              const end = span.end.bind(span);
-              span.end = (endTime, exit) => {
-                end(endTime, exit);
-                spans.push(span.name);
-              };
-              return span;
-            },
-          });
-        const secrets = makeMemorySecretStore();
-        const now = "2026-05-25T00:00:00.000Z";
-        const projectId = "project-1" as ProjectId;
-        const threadId = "thread-1" as ThreadId;
-        const environmentId = "env-1" as EnvironmentId;
-
-        const project = {
-          id: projectId,
-          title: "T3 Code",
-          workspaceRoot: "/workspace",
-          repositoryIdentity: null,
-          defaultModelSelection: null,
-          scripts: [],
-          createdAt: now,
-          updatedAt: now,
-        } satisfies OrchestrationProjectShell;
-
-        const thread = {
-          id: threadId,
-          projectId,
-          title: "Run remote agent",
-          modelSelection: { instanceId: ProviderInstanceId.make("codex"), model: "gpt-5.4" },
-          runtimeMode: "full-access",
-          interactionMode: "default",
-          branch: null,
-          worktreePath: null,
-          latestTurn: {
-            turnId: "turn-1" as TurnId,
-            state: "running",
-            requestedAt: now,
-            startedAt: now,
-            completedAt: null,
-            assistantMessageId: null,
-          },
-          createdAt: now,
-          updatedAt: now,
-          archivedAt: null,
-          settledOverride: null,
-          settledAt: null,
-          session: {
-            threadId,
-            status: "running",
-            providerName: "Codex",
-            runtimeMode: "full-access",
-            activeTurnId: "turn-1" as TurnId,
-            lastError: null,
-            updatedAt: now,
-          },
-          latestUserMessageAt: now,
-          hasPendingApprovals: false,
-          hasPendingUserInput: false,
-          hasActionableProposedPlan: false,
-        } satisfies OrchestrationThreadShell;
-
-        const descriptor = {
-          environmentId,
-          label: "Test Desktop",
-          platform: {
-            os: "darwin",
-            arch: "arm64",
-          },
-          serverVersion: "0.0.0-test",
-          capabilities: {
-            repositoryIdentity: true,
-          },
-        } satisfies ExecutionEnvironmentDescriptor;
-
-        globalThis.fetch = ((input: Parameters<typeof fetch>[0]) => {
-          const url = new URL(
-            typeof input === "string" || input instanceof URL
-              ? input
-              : (input as unknown as { readonly url: string }).url,
-          );
-          runFork(Deferred.succeed(fetchSeen, url));
-          return Promise.resolve(Response.json({ ok: true, deliveries: [] }));
-        }) as unknown as typeof fetch;
-        yield* Effect.addFinalizer(() =>
-          Effect.sync(() => {
-            globalThis.fetch = originalFetch;
-          }),
-        );
-
-        const layer = Layer.mergeAll(
-          Layer.succeed(ServerSecretStore.ServerSecretStore, secrets.store),
-          Layer.succeed(ServerEnvironment.ServerEnvironment, {
-            getEnvironmentId: Effect.succeed(environmentId),
-            getDescriptor: Effect.succeed(descriptor),
-          }),
-          Layer.succeed(OrchestrationEngineService, {
-            readEvents: () => Stream.empty,
-            dispatch: () => Effect.succeed({ sequence: 1 }),
-            streamDomainEvents: Stream.fromQueue(events),
-            latestSequence: Effect.succeed(0),
-          } satisfies OrchestrationEngineShape),
-          Layer.succeed(ProjectionSnapshotQuery, {
-            getShellSnapshot: () =>
-              Effect.succeed({
-                snapshotSequence: 1,
-                projects: [project],
-                threads: [thread],
-                updatedAt: now,
-              } satisfies OrchestrationShellSnapshot),
-            getThreadShellById: () => Effect.succeed(Option.some(thread)),
-            getProjectShellById: () => Effect.succeed(Option.some(project)),
-          } as unknown as ProjectionSnapshotQueryShape),
-        );
-
-        yield* Effect.gen(function* () {
-          const relay = yield* AgentAwarenessRelay.AgentAwarenessRelay;
-          yield* secrets.setString(RELAY_URL_SECRET, "https://transport.example.test");
-          yield* secrets.setString(RELAY_ISSUER_SECRET, "https://issuer.example.test");
-          yield* secrets.setString(RELAY_ENVIRONMENT_CREDENTIAL_SECRET, "relay-credential");
-          yield* secrets.setString(PUBLISH_AGENT_ACTIVITY_SECRET, "true");
-          yield* relay.start();
-          yield* Queue.offer(events, {
-            type: "thread.activity-appended",
-            sequence: 1,
-            eventId: "evt-1",
-            commandId: CommandId.make("cmd-1"),
-            aggregateKind: "thread",
-            aggregateId: threadId,
-            actor: { kind: "server" },
-            payload: {
-              threadId,
-              activity: {
-                kind: "approval.requested",
-              },
-            },
-            occurredAt: now,
-          } as unknown as OrchestrationEvent);
-
-          const url = yield* Deferred.await(fetchSeen).pipe(Effect.timeout("2 seconds"));
-          expect(url.origin).toBe("https://transport.example.test");
-          expect(productSpans).toContain("makePublishProof");
-          expect(userSpans).not.toContain("makePublishProof");
-        }).pipe(
-          Effect.provide(
-            AgentAwarenessRelay.layer.pipe(
-              Layer.provide(layer),
-              Layer.provideMerge(NodeServices.layer),
-            ),
-          ),
-          Effect.provideService(RelayClientTracer, Option.some(collectingTracer(productSpans))),
-          Effect.withTracer(collectingTracer(userSpans)),
-        );
-      }),
-    ),
-  );
-});
diff --git a/apps/server/src/relay/AgentAwarenessRelay.ts b/apps/server/src/relay/AgentAwarenessRelay.ts
index 5127ecf7d359..42884d7b7c58 100644
--- a/apps/server/src/relay/AgentAwarenessRelay.ts
+++ b/apps/server/src/relay/AgentAwarenessRelay.ts
@@ -1,8 +1,8 @@
 import type {
   EnvironmentId,
-  OrchestrationEvent,
-  OrchestrationProjectShell,
-  OrchestrationThreadShell,
+  OrchestrationV2DomainEvent,
+  OrchestrationV2ThreadShell,
+  Project,
   ThreadId,
 } from "@t3tools/contracts";
 import {
@@ -10,7 +10,7 @@ import {
   type RelayAgentActivityPublishProofPayload,
   type RelayAgentActivityState,
 } from "@t3tools/contracts/relay";
-import { projectThreadAwareness } from "@t3tools/shared/agentAwareness";
+import { projectThreadAwarenessV2 } from "@t3tools/shared/agentAwareness";
 import { makeDrainableWorker } from "@t3tools/shared/DrainableWorker";
 import { withRelayClientTracing } from "@t3tools/shared/relayTracing";
 import {
@@ -43,8 +43,8 @@ import {
 } from "../cloud/config.ts";
 import { getOrCreateEnvironmentKeyPairFromSecretStore } from "../cloud/environmentKeys.ts";
 import * as ServerEnvironment from "../environment/ServerEnvironment.ts";
-import * as OrchestrationEngine from "../orchestration/Services/OrchestrationEngine.ts";
-import * as ProjectionSnapshotQuery from "../orchestration/Services/ProjectionSnapshotQuery.ts";
+import * as ThreadManagement from "../orchestration-v2/ThreadManagementService.ts";
+import * as ProjectService from "../project/ProjectService.ts";
 import { forkParked } from "../serverActivation.ts";
 
 export class AgentAwarenessRelay extends Context.Service<
@@ -55,43 +55,15 @@ export class AgentAwarenessRelay extends Context.Service<
   }
 >()("t3/relay/AgentAwarenessRelay") {}
 
-export function eventThreadId(event: OrchestrationEvent): ThreadId | null {
-  const payload = event.payload as { readonly threadId?: unknown };
-  if (typeof payload.threadId === "string") {
-    return payload.threadId as ThreadId;
-  }
-  if (event.aggregateKind === "thread" && typeof event.aggregateId === "string") {
-    return event.aggregateId as ThreadId;
-  }
-  return null;
+export function eventThreadId(event: OrchestrationV2DomainEvent): ThreadId {
+  return event.threadId;
 }
 
-export function shouldPublishAgentAwarenessEvent(event: OrchestrationEvent): boolean {
-  switch (event.type) {
-    case "thread.message-sent":
-    case "thread.turn-start-requested":
-      // These events express intent to start work, but the shell still contains
-      // the previous turn's terminal state until the provider acknowledges the
-      // new turn. Publishing that snapshot can queue a fresh "Done" alert just
-      // before the real running state arrives. Provider lifecycle events publish
-      // the authoritative starting/running state instead.
-      return false;
-    case "thread.proposed-plan-upserted":
-    case "thread.runtime-mode-set":
-    case "thread.interaction-mode-set":
-      return false;
-    case "thread.activity-appended":
-      return (
-        event.payload.activity.kind === "approval.requested" ||
-        event.payload.activity.kind === "approval.resolved" ||
-        event.payload.activity.kind === "provider.approval.respond.failed" ||
-        event.payload.activity.kind === "user-input.requested" ||
-        event.payload.activity.kind === "user-input.resolved" ||
-        event.payload.activity.kind === "runtime.error"
-      );
-    default:
-      return true;
-  }
+export function shouldPublishAgentAwarenessEvent(_event: OrchestrationV2DomainEvent): boolean {
+  // Publishing is identity-deduplicated below. Watching every V2 event keeps
+  // this consumer correct as the shell projection evolves without duplicating
+  // projection-specific relevance rules here.
+  return true;
 }
 
 export function agentAwarenessPublishIdentity(state: RelayAgentActivityState | null): string {
@@ -213,7 +185,7 @@ const makePublishProof = Effect.fn("makePublishProof")(function* (input: {
 
 // Compact, log-safe view of the fields the awareness phase ladder reads.
 export function describeThreadShellForAwareness(
-  thread: Option.Option<OrchestrationThreadShell>,
+  thread: Option.Option<OrchestrationV2ThreadShell>,
 ): Record<string, unknown> {
   if (Option.isNone(thread)) {
     return { found: false };
@@ -221,21 +193,20 @@ export function describeThreadShellForAwareness(
   const shell = thread.value;
   return {
     found: true,
-    sessionStatus: shell.session?.status ?? null,
-    sessionActiveTurnId: shell.session?.activeTurnId ?? null,
-    latestTurnId: shell.latestTurn?.turnId ?? null,
-    latestTurnState: shell.latestTurn?.state ?? null,
-    latestTurnCompletedAt: shell.latestTurn?.completedAt ?? null,
-    hasPendingApprovals: shell.hasPendingApprovals,
-    hasPendingUserInput: shell.hasPendingUserInput,
+    status: shell.status,
+    activityRunStatus: shell.activityRunStatus ?? null,
+    activeRunId: shell.activeRunId ?? null,
+    latestRunId: shell.latestRunId ?? null,
+    pendingRuntimeRequestKind: shell.pendingRuntimeRequest?.kind ?? null,
+    hasActionableProposedPlan: shell.hasActionableProposedPlan,
   };
 }
 
 export function resolveAgentAwarenessRelayPublishSnapshot(input: {
   readonly environmentId: EnvironmentId;
   readonly threadId: ThreadId;
-  readonly thread: Option.Option<OrchestrationThreadShell>;
-  readonly project: Option.Option<OrchestrationProjectShell>;
+  readonly thread: Option.Option<OrchestrationV2ThreadShell>;
+  readonly project: Option.Option<Project>;
 }): {
   readonly projectId: string | null;
   readonly state: RelayAgentActivityState | null;
@@ -258,7 +229,7 @@ export function resolveAgentAwarenessRelayPublishSnapshot(input: {
   return {
     projectId: input.thread.value.projectId,
     state: sanitizeRelayAgentActivityState(
-      projectThreadAwareness({
+      projectThreadAwarenessV2({
         environmentId: input.environmentId,
         project: input.project.value,
         thread: input.thread.value,
@@ -270,8 +241,8 @@ export function resolveAgentAwarenessRelayPublishSnapshot(input: {
 
 export function resolveAgentAwarenessRelayActiveThreadIds(input: {
   readonly environmentId: EnvironmentId;
-  readonly projects: ReadonlyArray<Pick<OrchestrationProjectShell, "id" | "title">>;
-  readonly threads: ReadonlyArray<OrchestrationThreadShell>;
+  readonly projects: ReadonlyArray<Pick<Project, "id" | "title">>;
+  readonly threads: ReadonlyArray<OrchestrationV2ThreadShell>;
 }): ReadonlyArray<ThreadId> {
   const projectById = new Map(input.projects.map((project) => [project.id, project]));
   return input.threads
@@ -281,7 +252,7 @@ export function resolveAgentAwarenessRelayActiveThreadIds(input: {
         return false;
       }
       return (
-        projectThreadAwareness({
+        projectThreadAwarenessV2({
           environmentId: input.environmentId,
           project,
           thread,
@@ -294,8 +265,8 @@ export function resolveAgentAwarenessRelayActiveThreadIds(input: {
 export const make = Effect.gen(function* () {
   const secrets = yield* ServerSecretStore.ServerSecretStore;
   const serverEnvironment = yield* ServerEnvironment.ServerEnvironment;
-  const snapshotQuery = yield* ProjectionSnapshotQuery.ProjectionSnapshotQuery;
-  const orchestrationEngine = yield* OrchestrationEngine.OrchestrationEngineService;
+  const threads = yield* ThreadManagement.ThreadManagementService;
+  const projects = yield* ProjectService.ProjectService;
   const crypto = yield* Crypto.Crypto;
   const cloudLinkKeyPair = yield* getOrCreateEnvironmentKeyPairFromSecretStore(secrets);
   const activeSnapshotPublishedRef = yield* Ref.make(false);
@@ -405,10 +376,17 @@ export const make = Effect.gen(function* () {
         });
       });
 
-    const thread = yield* snapshotQuery.getThreadShellById(threadId);
+    // Per-thread shell read: this publish runs for every activity-relevant
+    // domain event, so materializing the full shell here would make the cost
+    // of one thread's activity proportional to how many threads exist.
+    const threadShell = yield* threads.getThreadShell(threadId);
+    const thread =
+      threadShell === null || threadShell.archivedAt !== null
+        ? Option.none<OrchestrationV2ThreadShell>()
+        : Option.some(threadShell);
     const project = Option.isSome(thread)
-      ? yield* snapshotQuery.getProjectShellById(thread.value.projectId)
-      : Option.none<OrchestrationProjectShell>();
+      ? yield* projects.getById(thread.value.projectId)
+      : Option.none<Project>();
     const snapshot = resolveAgentAwarenessRelayPublishSnapshot({
       environmentId,
       threadId,
@@ -526,11 +504,14 @@ export const make = Effect.gen(function* () {
       return false;
     }
     const environmentId = yield* serverEnvironment.getEnvironmentId;
-    const snapshot = yield* snapshotQuery.getShellSnapshot();
+    const [projectSnapshot, shellSnapshot] = yield* Effect.all([
+      projects.snapshot,
+      threads.getShellSnapshot(),
+    ]);
     const activeThreadIds = resolveAgentAwarenessRelayActiveThreadIds({
       environmentId,
-      projects: snapshot.projects,
-      threads: snapshot.threads,
+      projects: projectSnapshot.projects,
+      threads: shellSnapshot.threads,
     });
     if (activeThreadIds.length === 0) {
       yield* Effect.logDebug("agent activity snapshot has no publishable threads");
@@ -607,13 +588,8 @@ export const make = Effect.gen(function* () {
         ),
       );
       yield* forkParked(
-        Stream.runForEach(orchestrationEngine.streamDomainEvents, (event) => {
+        Stream.runForEach(threads.streamDomainEvents, (event) => {
           const threadId = eventThreadId(event);
-          if (threadId === null) {
-            return Effect.logDebug("agent activity publishing ignored event without thread id", {
-              eventType: event.type,
-            });
-          }
           if (!shouldPublishAgentAwarenessEvent(event)) {
             return Effect.logDebug(
               "agent activity publishing ignored event without activity changes",
diff --git a/apps/server/src/scheduledTasks/Schedule.test.ts b/apps/server/src/scheduledTasks/Schedule.test.ts
new file mode 100644
index 000000000000..aa369975f2b6
--- /dev/null
+++ b/apps/server/src/scheduledTasks/Schedule.test.ts
@@ -0,0 +1,123 @@
+import { describe, expect, it } from "@effect/vitest";
+import * as DateTime from "effect/DateTime";
+
+import {
+  isMissedFixedTimeRun,
+  isSameSchedule,
+  nextScheduledRunAt,
+  parseTimeOfDay,
+} from "./Schedule.ts";
+
+describe("scheduled task schedule calculation", () => {
+  it("parses 24-hour times", () => {
+    expect(parseTimeOfDay("09:30")).toEqual({ hour: 9, minute: 30 });
+    expect(parseTimeOfDay("23:59")).toEqual({ hour: 23, minute: 59 });
+    expect(parseTimeOfDay("25:00")).toBeNull();
+  });
+
+  it("calculates interval schedules from the supplied instant", () => {
+    const next = nextScheduledRunAt(
+      { type: "interval", everyMs: 5 * 60_000 },
+      DateTime.makeUnsafe("2026-07-01T16:00:00.000Z"),
+    );
+    expect(next ? DateTime.formatIso(DateTime.toUtc(next)) : null).toBe("2026-07-01T16:05:00.000Z");
+  });
+
+  it("clamps legacy sub-minute intervals to the one-minute execution floor", () => {
+    const next = nextScheduledRunAt(
+      { type: "interval", everyMs: 1_000 },
+      DateTime.makeUnsafe("2026-07-01T16:00:00.000Z"),
+    );
+    expect(next ? DateTime.formatIso(DateTime.toUtc(next)) : null).toBe("2026-07-01T16:01:00.000Z");
+  });
+
+  it("skips to the next matching fixed-time weekday", () => {
+    const next = nextScheduledRunAt(
+      { type: "fixed_time", timeOfDay: "09:00", weekdays: [1, 2, 3, 4, 5] },
+      DateTime.makeZonedUnsafe(
+        {
+          year: 2026,
+          month: 7,
+          day: 3,
+          hour: 10,
+          minute: 0,
+          second: 0,
+          millisecond: 0,
+        },
+        { timeZone: "America/Los_Angeles", adjustForTimeZone: true },
+      ),
+    );
+    const parts = next ? DateTime.toParts(next) : null;
+    expect(parts?.weekDay).toBe(1);
+    expect(parts?.hour).toBe(9);
+    expect(parts?.minute).toBe(0);
+  });
+
+  it("skips fixed-time runs missed by more than the grace window", () => {
+    const fixedTime = { type: "fixed_time", timeOfDay: "09:00" } as const;
+    const dueAt = DateTime.makeUnsafe("2026-07-01T09:00:00.000Z");
+    const withinGrace = DateTime.makeUnsafe("2026-07-01T09:05:00.000Z");
+    const pastGrace = DateTime.makeUnsafe("2026-07-01T15:00:00.000Z");
+    // A run only slightly late (poll jitter, short sleep) still fires.
+    expect(isMissedFixedTimeRun(fixedTime, dueAt, withinGrace)).toBe(false);
+    // A run hours past its slot is skipped and rescheduled instead.
+    expect(isMissedFixedTimeRun(fixedTime, dueAt, pastGrace)).toBe(true);
+    // Interval schedules always catch up with a single run, never skip.
+    expect(isMissedFixedTimeRun({ type: "interval", everyMs: 60_000 }, dueAt, pastGrace)).toBe(
+      false,
+    );
+  });
+
+  it("compares schedules structurally", () => {
+    expect(
+      isSameSchedule({ type: "interval", everyMs: 60_000 }, { type: "interval", everyMs: 60_000 }),
+    ).toBe(true);
+    expect(
+      isSameSchedule({ type: "interval", everyMs: 60_000 }, { type: "interval", everyMs: 30_000 }),
+    ).toBe(false);
+    expect(
+      isSameSchedule(
+        { type: "fixed_time", timeOfDay: "09:00", weekdays: [1, 2] },
+        { type: "fixed_time", timeOfDay: "09:00", weekdays: [1, 2] },
+      ),
+    ).toBe(true);
+    // Weekday masks are sets: order and duplicates do not change firing.
+    expect(
+      isSameSchedule(
+        { type: "fixed_time", timeOfDay: "09:00", weekdays: [5, 1] },
+        { type: "fixed_time", timeOfDay: "09:00", weekdays: [1, 5, 5] },
+      ),
+    ).toBe(true);
+    // Omitted, empty, and all-seven masks all mean daily.
+    expect(
+      isSameSchedule(
+        { type: "fixed_time", timeOfDay: "09:00" },
+        { type: "fixed_time", timeOfDay: "09:00", weekdays: [0, 1, 2, 3, 4, 5, 6] },
+      ),
+    ).toBe(true);
+    expect(
+      isSameSchedule(
+        { type: "fixed_time", timeOfDay: "09:00", weekdays: [] },
+        { type: "fixed_time", timeOfDay: "09:00" },
+      ),
+    ).toBe(true);
+    expect(
+      isSameSchedule(
+        { type: "fixed_time", timeOfDay: "09:00", weekdays: [1, 2] },
+        { type: "fixed_time", timeOfDay: "09:00", weekdays: [1, 3] },
+      ),
+    ).toBe(false);
+    expect(
+      isSameSchedule(
+        { type: "fixed_time", timeOfDay: "09:00" },
+        { type: "fixed_time", timeOfDay: "09:30" },
+      ),
+    ).toBe(false);
+    expect(
+      isSameSchedule(
+        { type: "interval", everyMs: 60_000 },
+        { type: "fixed_time", timeOfDay: "09:00" },
+      ),
+    ).toBe(false);
+  });
+});
diff --git a/apps/server/src/scheduledTasks/Schedule.ts b/apps/server/src/scheduledTasks/Schedule.ts
new file mode 100644
index 000000000000..952c7e6e8fd5
--- /dev/null
+++ b/apps/server/src/scheduledTasks/Schedule.ts
@@ -0,0 +1,104 @@
+import { MIN_SCHEDULED_TASK_INTERVAL_MS, type ScheduledTaskSchedule } from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+
+const MINUTE_MS = 60_000;
+
+export function parseTimeOfDay(value: string): { hour: number; minute: number } | null {
+  const match = /^([01]?\d|2[0-3]):([0-5]\d)$/.exec(value.trim());
+  if (!match) return null;
+  return { hour: Number(match[1]), minute: Number(match[2]) };
+}
+
+export function nextScheduledRunAt(
+  schedule: ScheduledTaskSchedule,
+  from: DateTime.DateTime,
+): DateTime.DateTime | null {
+  if (schedule.type === "interval") {
+    // Persisted rows created before the one-minute floor remain readable, but
+    // they must not retain their old high-frequency execution rate.
+    return DateTime.add(from, {
+      milliseconds: Math.max(schedule.everyMs, MIN_SCHEDULED_TASK_INTERVAL_MS),
+    });
+  }
+
+  const time = parseTimeOfDay(schedule.timeOfDay);
+  if (time === null) return null;
+  const weekdays =
+    schedule.weekdays && schedule.weekdays.length > 0 ? new Set(schedule.weekdays) : null;
+  for (let offset = 0; offset <= 7; offset += 1) {
+    const candidate = DateTime.setParts(DateTime.add(from, { days: offset }), {
+      hour: time.hour,
+      minute: time.minute,
+      second: 0,
+      millisecond: 0,
+    });
+    if (DateTime.toEpochMillis(candidate) <= DateTime.toEpochMillis(from)) continue;
+    if (weekdays !== null && !weekdays.has(DateTime.toParts(candidate).weekDay)) continue;
+    return candidate;
+  }
+  return null;
+}
+
+/**
+ * Canonical form of a weekday mask, mirroring how `nextScheduledRunAt` reads
+ * it: order and duplicates are irrelevant, and an empty/omitted mask means the
+ * same as explicitly listing all seven days — daily.
+ */
+function weekdayKey(weekdays: ReadonlyArray<number> | undefined): string {
+  const unique = [...new Set(weekdays ?? [])].toSorted((x, y) => x - y);
+  if (unique.length === 0 || unique.length === 7) return "daily";
+  return unique.join(",");
+}
+
+/** Semantic equality for schedules: true iff both fire at the same times. */
+export function isSameSchedule(a: ScheduledTaskSchedule, b: ScheduledTaskSchedule): boolean {
+  if (a.type === "interval") {
+    return b.type === "interval" && a.everyMs === b.everyMs;
+  }
+  return (
+    b.type === "fixed_time" &&
+    a.timeOfDay === b.timeOfDay &&
+    weekdayKey(a.weekdays) === weekdayKey(b.weekdays)
+  );
+}
+
+/**
+ * How late a fixed-time run may fire before it counts as missed. Covers poll
+ * jitter and short sleeps, while a server booted hours after the slot skips
+ * to the next occurrence instead of firing stale work at a random time.
+ */
+export const MISSED_FIXED_TIME_GRACE_MS = 10 * MINUTE_MS;
+
+/**
+ * True when a due fixed-time run was missed by more than the grace window and
+ * should be rescheduled to its next occurrence instead of firing now.
+ * Interval schedules are never considered missed: an overdue interval task
+ * catching up with a single run is the desired behaviour.
+ */
+export function isMissedFixedTimeRun(
+  schedule: ScheduledTaskSchedule,
+  dueAt: DateTime.DateTime,
+  now: DateTime.DateTime,
+): boolean {
+  if (schedule.type !== "fixed_time") return false;
+  return DateTime.toEpochMillis(now) - DateTime.toEpochMillis(dueAt) > MISSED_FIXED_TIME_GRACE_MS;
+}
+
+export function describeSchedule(schedule: ScheduledTaskSchedule): string {
+  if (schedule.type === "interval") {
+    const minutes = schedule.everyMs / MINUTE_MS;
+    if (Number.isInteger(minutes)) {
+      return `Every ${minutes === 1 ? "minute" : `${minutes} minutes`}`;
+    }
+    return `Every ${Math.round(schedule.everyMs / 1000)} seconds`;
+  }
+
+  const weekdayCount = schedule.weekdays?.length ?? 0;
+  const days =
+    weekdayCount === 0
+      ? "day"
+      : weekdayCount === 5 && schedule.weekdays?.every((day) => day >= 1 && day <= 5)
+        ? "weekday"
+        : "selected day";
+  return `At ${schedule.timeOfDay} every ${days}`;
+}
diff --git a/apps/server/src/scheduledTasks/ScheduledTaskService.ts b/apps/server/src/scheduledTasks/ScheduledTaskService.ts
new file mode 100644
index 000000000000..cb59c96afe78
--- /dev/null
+++ b/apps/server/src/scheduledTasks/ScheduledTaskService.ts
@@ -0,0 +1,799 @@
+import {
+  CommandId,
+  MessageId,
+  ScheduledTask,
+  ScheduledTaskError,
+  ScheduledTaskId,
+  ThreadId,
+  type ScheduledTaskDeleteInput,
+  type ScheduledTaskDeleteResult,
+  type ScheduledTaskListResult,
+  type ScheduledTaskMutationResult,
+  type ScheduledTaskRunNowInput,
+  type ScheduledTaskRunNowResult,
+  type ScheduledTaskSetEnabledInput,
+  type ScheduledTaskUpsertInput,
+} from "@t3tools/contracts";
+import * as Cause from "effect/Cause";
+import * as Context from "effect/Context";
+import * as Crypto from "effect/Crypto";
+import * as DateTime from "effect/DateTime";
+import * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as PubSub from "effect/PubSub";
+import * as Ref from "effect/Ref";
+import * as Result from "effect/Result";
+import * as Schema from "effect/Schema";
+import * as Stream from "effect/Stream";
+import * as SqlClient from "effect/unstable/sql/SqlClient";
+
+import * as ThreadLaunchService from "../orchestration-v2/ThreadLaunchService.ts";
+import * as ThreadManagementService from "../orchestration-v2/ThreadManagementService.ts";
+import { isMissedFixedTimeRun, isSameSchedule, nextScheduledRunAt } from "./Schedule.ts";
+
+const decodeTask = Schema.decodeUnknownEffect(ScheduledTask);
+const decodeScheduleJson = Schema.decodeUnknownEffect(
+  Schema.fromJsonString(ScheduledTask.fields.schedule),
+);
+const decodeWorkspaceStrategyJson = Schema.decodeUnknownEffect(
+  Schema.fromJsonString(ScheduledTask.fields.workspaceStrategy),
+);
+const decodeModelSelectionJson = Schema.decodeUnknownEffect(
+  Schema.fromJsonString(ScheduledTask.fields.modelSelection),
+);
+
+interface ScheduledTaskRow {
+  readonly task_id: string;
+  readonly title: string;
+  readonly prompt: string;
+  readonly enabled: number;
+  readonly schedule_json: string;
+  readonly project_id: string;
+  readonly thread_id: string | null;
+  readonly workspace_strategy_json: string;
+  readonly model_selection_json: string;
+  readonly runtime_mode: string;
+  readonly interaction_mode: string;
+  readonly created_by: string;
+  readonly creation_source: string;
+  readonly created_at: string;
+  readonly updated_at: string;
+  readonly next_run_at: string | null;
+  readonly last_run_at: string | null;
+  readonly last_run_status: string;
+  readonly last_run_error: string | null;
+  readonly run_count: number;
+}
+
+export class ScheduledTaskService extends Context.Service<
+  ScheduledTaskService,
+  {
+    readonly list: () => Effect.Effect<ScheduledTaskListResult, ScheduledTaskError>;
+    /** Emits the full task list on subscribe and again after every change (CRUD, run transitions, reschedules). */
+    readonly subscribeList: () => Stream.Stream<ScheduledTaskListResult, ScheduledTaskError>;
+    readonly upsert: (
+      input: ScheduledTaskUpsertInput,
+    ) => Effect.Effect<ScheduledTaskMutationResult, ScheduledTaskError>;
+    /** Partial update flipping only the enabled flag; never touches other fields. */
+    readonly setEnabled: (
+      input: ScheduledTaskSetEnabledInput,
+    ) => Effect.Effect<ScheduledTaskMutationResult, ScheduledTaskError>;
+    readonly delete: (
+      input: ScheduledTaskDeleteInput,
+    ) => Effect.Effect<ScheduledTaskDeleteResult, ScheduledTaskError>;
+    readonly runNow: (
+      input: ScheduledTaskRunNowInput,
+    ) => Effect.Effect<ScheduledTaskRunNowResult, ScheduledTaskError>;
+  }
+>()("t3/scheduledTasks/ScheduledTaskService") {}
+
+function taskError(message: string, input?: { taskId?: ScheduledTaskId; cause?: unknown }) {
+  return new ScheduledTaskError({
+    message,
+    ...(input?.taskId === undefined ? {} : { taskId: input.taskId }),
+    ...(input?.cause === undefined ? {} : { cause: input.cause }),
+  });
+}
+
+function automationPrompt(task: ScheduledTask): string {
+  return `[Triggered by schedule task: ${task.title}]\n\n${task.prompt}`;
+}
+
+function iso(value: DateTime.DateTime): string {
+  return DateTime.formatIso(DateTime.toUtc(value));
+}
+
+const localNow = DateTime.withCurrentZoneLocal(DateTime.nowInCurrentZone);
+
+function nextRunAt(
+  task: Pick<ScheduledTask, "enabled" | "schedule">,
+  from: DateTime.DateTime,
+): string | null {
+  if (!task.enabled) return null;
+  const next = nextScheduledRunAt(task.schedule, from);
+  return next === null ? null : iso(next);
+}
+
+function errorMessage(error: unknown): string {
+  if (Cause.isCause(error)) return Cause.pretty(error);
+  if (error instanceof Error) return error.message;
+  return String(error);
+}
+
+const decodeRow = (row: ScheduledTaskRow) =>
+  Effect.gen(function* () {
+    const id = ScheduledTaskId.make(row.task_id);
+    const schedule = yield* decodeScheduleJson(row.schedule_json);
+    const workspaceStrategy = yield* decodeWorkspaceStrategyJson(row.workspace_strategy_json);
+    const modelSelection = yield* decodeModelSelectionJson(row.model_selection_json);
+    return yield* decodeTask({
+      id,
+      title: row.title,
+      prompt: row.prompt,
+      enabled: row.enabled === 1,
+      schedule,
+      projectId: row.project_id,
+      threadId: row.thread_id,
+      workspaceStrategy,
+      modelSelection,
+      runtimeMode: row.runtime_mode,
+      interactionMode: row.interaction_mode,
+      createdBy: row.created_by,
+      creationSource: row.creation_source,
+      createdAt: row.created_at,
+      updatedAt: row.updated_at,
+      nextRunAt: row.next_run_at,
+      lastRunAt: row.last_run_at,
+      lastRunStatus: row.last_run_status,
+      lastRunError: row.last_run_error,
+      runCount: row.run_count,
+    });
+  }).pipe(
+    Effect.mapError((cause) =>
+      taskError("Could not decode schedule task row.", {
+        taskId: ScheduledTaskId.make(row.task_id),
+        cause,
+      }),
+    ),
+  );
+
+export const layer = Layer.effect(
+  ScheduledTaskService,
+  Effect.gen(function* () {
+    const sql = yield* SqlClient.SqlClient;
+    const crypto = yield* Crypto.Crypto;
+    const threadLaunch = yield* ThreadLaunchService.ThreadLaunchService;
+    const threadManagement = yield* ThreadManagementService.ThreadManagementService;
+    const activeRuns = yield* Ref.make<ReadonlySet<ScheduledTaskId>>(new Set());
+    // Sliding(1) coalesces the dirty-signal: every notification triggers a
+    // full list() re-emit anyway, so a slow subscriber only ever needs the
+    // latest signal — an unbounded backlog would just grow memory.
+    const changesPubSub = yield* PubSub.sliding<void>(1);
+    const notifyChanged = PubSub.publish(changesPubSub, undefined).pipe(Effect.asVoid);
+
+    const selectAllRows = () => sql<ScheduledTaskRow>`
+      SELECT
+        task_id,
+        title,
+        prompt,
+        enabled,
+        schedule_json,
+        project_id,
+        thread_id,
+        workspace_strategy_json,
+        model_selection_json,
+        runtime_mode,
+        interaction_mode,
+        created_by,
+        creation_source,
+        created_at,
+        updated_at,
+        next_run_at,
+        last_run_at,
+        last_run_status,
+        last_run_error,
+        run_count
+      FROM scheduled_tasks
+      ORDER BY updated_at DESC, task_id ASC
+    `;
+
+    // Strict decode for the API surface: a corrupt row is a visible error.
+    const listRows = Effect.fn("ScheduledTaskService.listRows")(function* () {
+      const rows = yield* selectAllRows();
+      return yield* Effect.forEach(rows, decodeRow, { concurrency: 1 });
+    });
+
+    // Lenient decode for the scheduler: one corrupt row must never halt the
+    // poll loop or crash recovery for every other task — skip it and log.
+    const listTasksLenient = Effect.fn("ScheduledTaskService.listTasksLenient")(function* () {
+      const rows = yield* selectAllRows();
+      const tasks: ScheduledTask[] = [];
+      for (const row of rows) {
+        const decoded = yield* Effect.result(decodeRow(row));
+        if (Result.isSuccess(decoded)) {
+          tasks.push(decoded.success);
+        } else {
+          yield* Effect.logWarning("Skipping undecodable schedule task row", {
+            taskId: row.task_id,
+            cause: decoded.failure,
+          });
+        }
+      }
+      return tasks;
+    });
+
+    const getRows = (id: ScheduledTaskId) => sql<ScheduledTaskRow>`
+      SELECT
+        task_id,
+        title,
+        prompt,
+        enabled,
+        schedule_json,
+        project_id,
+        thread_id,
+        workspace_strategy_json,
+        model_selection_json,
+        runtime_mode,
+        interaction_mode,
+        created_by,
+        creation_source,
+        created_at,
+        updated_at,
+        next_run_at,
+        last_run_at,
+        last_run_status,
+        last_run_error,
+        run_count
+      FROM scheduled_tasks
+      WHERE task_id = ${id}
+    `;
+
+    /** Load a task, returning `null` when it does not exist; real load/decode failures propagate. */
+    const findTask = Effect.fn("ScheduledTaskService.findTask")(function* (id: ScheduledTaskId) {
+      const rows = yield* getRows(id).pipe(
+        Effect.mapError((cause) =>
+          taskError("Could not load schedule task.", { taskId: id, cause }),
+        ),
+      );
+      const row = rows[0];
+      if (row === undefined) return null;
+      return yield* decodeRow(row);
+    });
+
+    const loadTask = Effect.fn("ScheduledTaskService.loadTask")(function* (id: ScheduledTaskId) {
+      const task = yield* findTask(id);
+      if (task === null) {
+        return yield* taskError("Schedule task not found.", { taskId: id });
+      }
+      return task;
+    });
+
+    // Run-state columns (last_run_*, run_count) are intentionally absent from
+    // the conflict clause: they are owned by the run transitions below, and a
+    // concurrent settings save must not overwrite an in-flight increment.
+    const saveTask = (task: ScheduledTask) =>
+      sql`
+        INSERT INTO scheduled_tasks (
+          task_id,
+          title,
+          prompt,
+          enabled,
+          schedule_json,
+          project_id,
+          thread_id,
+          workspace_strategy_json,
+          model_selection_json,
+          runtime_mode,
+          interaction_mode,
+          created_by,
+          creation_source,
+          created_at,
+          updated_at,
+          next_run_at,
+          last_run_at,
+          last_run_status,
+          last_run_error,
+          run_count
+        )
+        VALUES (
+          ${task.id},
+          ${task.title},
+          ${task.prompt},
+          ${task.enabled ? 1 : 0},
+          ${JSON.stringify(task.schedule)},
+          ${task.projectId},
+          ${task.threadId},
+          ${JSON.stringify(task.workspaceStrategy)},
+          ${JSON.stringify(task.modelSelection)},
+          ${task.runtimeMode},
+          ${task.interactionMode},
+          ${task.createdBy},
+          ${task.creationSource},
+          ${task.createdAt},
+          ${task.updatedAt},
+          ${task.nextRunAt},
+          ${task.lastRunAt},
+          ${task.lastRunStatus},
+          ${task.lastRunError},
+          ${task.runCount}
+        )
+        ON CONFLICT (task_id)
+        DO UPDATE SET
+          title = excluded.title,
+          prompt = excluded.prompt,
+          enabled = excluded.enabled,
+          schedule_json = excluded.schedule_json,
+          project_id = excluded.project_id,
+          thread_id = excluded.thread_id,
+          workspace_strategy_json = excluded.workspace_strategy_json,
+          model_selection_json = excluded.model_selection_json,
+          runtime_mode = excluded.runtime_mode,
+          interaction_mode = excluded.interaction_mode,
+          creation_source = excluded.creation_source,
+          updated_at = excluded.updated_at,
+          next_run_at = excluded.next_run_at
+      `.pipe(
+        Effect.mapError((cause) =>
+          taskError("Could not save schedule task.", { taskId: task.id, cause }),
+        ),
+      );
+
+    const deleteRow = (id: ScheduledTaskId) =>
+      sql`DELETE FROM scheduled_tasks WHERE task_id = ${id}`.pipe(
+        Effect.mapError((cause) =>
+          taskError("Could not delete schedule task.", { taskId: id, cause }),
+        ),
+      );
+
+    // Run-state transitions use targeted UPDATEs (never the full-row upsert) so
+    // a completing run cannot resurrect a deleted task or clobber concurrent
+    // edits to the task definition.
+    const markRunning = (id: ScheduledTaskId, startedAtIso: string) =>
+      sql`
+        UPDATE scheduled_tasks
+        SET updated_at = ${startedAtIso},
+            last_run_at = ${startedAtIso},
+            last_run_status = 'running',
+            last_run_error = NULL
+        WHERE task_id = ${id}
+      `.pipe(
+        Effect.mapError((cause) =>
+          taskError("Could not mark schedule task as running.", { taskId: id, cause }),
+        ),
+      );
+
+    const markCompleted = (input: {
+      readonly id: ScheduledTaskId;
+      readonly completedAtIso: string;
+      readonly nextRunAtIso: string | null;
+      readonly status: "succeeded" | "failed";
+      readonly error: string | null;
+      readonly startedAtIso: string;
+    }) =>
+      sql`
+        UPDATE scheduled_tasks
+        SET updated_at = ${input.completedAtIso},
+            next_run_at = ${input.nextRunAtIso},
+            last_run_status = ${input.status},
+            last_run_error = ${input.error},
+            run_count = run_count + 1
+        WHERE task_id = ${input.id}
+          AND last_run_status = 'running'
+          AND last_run_at = ${input.startedAtIso}
+      `.pipe(
+        Effect.mapError((cause) =>
+          taskError("Could not record schedule task run.", { taskId: input.id, cause }),
+        ),
+      );
+
+    // Best-effort escape hatch: if anything fails between markRunning and
+    // markCompleted, write a full terminal record so runDueTasks neither skips
+    // the task forever (it filters out 'running' rows) nor re-fires it
+    // immediately: the dispatch may already have gone out, so next_run_at must
+    // advance and run_count must count the attempt.
+    const releaseStuckRun = (task: ScheduledTask, message: string) =>
+      Effect.gen(function* () {
+        const now = yield* localNow;
+        // Compute the next occurrence from the current row so a schedule
+        // edited while the run was in flight is honoured; fall back to the
+        // run's snapshot only if the re-read itself fails.
+        const reread = yield* Effect.result(findTask(task.id));
+        if (Result.isSuccess(reread) && reread.success === null) return; // deleted — nothing to release
+        const source = Result.isSuccess(reread) && reread.success !== null ? reread.success : task;
+        yield* sql`
+          UPDATE scheduled_tasks
+          SET last_run_status = 'failed',
+              last_run_error = ${message},
+              next_run_at = ${nextRunAt(source, now)},
+              updated_at = ${iso(now)},
+              run_count = run_count + 1
+          WHERE task_id = ${task.id} AND last_run_status = 'running'
+        `;
+        yield* notifyChanged;
+      }).pipe(
+        Effect.catch((cause) =>
+          Effect.logWarning("Could not release stuck schedule task run", {
+            taskId: task.id,
+            cause,
+          }),
+        ),
+      );
+
+    const runTask = Effect.fn("ScheduledTaskService.runTask")(function* (
+      task: ScheduledTask,
+      trigger: "scheduled" | "manual",
+    ) {
+      const reserved = yield* Ref.modify(activeRuns, (active) => {
+        if (active.has(task.id)) return [false, active] as const;
+        const next = new Set(active);
+        next.add(task.id);
+        return [true, next] as const;
+      });
+      if (!reserved) {
+        if (trigger === "manual") {
+          return yield* taskError("Schedule task is already running.", { taskId: task.id });
+        }
+        return task;
+      }
+
+      return yield* Effect.gen(function* () {
+        const startedAt = yield* localNow;
+        const startedAtIso = iso(startedAt);
+
+        // The in-memory snapshot may be stale: re-read before touching run
+        // state. The task may have been deleted, paused, or postponed since
+        // the poll loaded it — none of those may fire.
+        const active = yield* findTask(task.id);
+        if (active === null) {
+          // A manual run on a just-deleted task must fail loudly, not report
+          // a successful run that never dispatched.
+          if (trigger === "manual") {
+            return yield* taskError("Schedule task not found.", { taskId: task.id });
+          }
+          return task;
+        }
+        if (
+          trigger === "scheduled" &&
+          (!active.enabled ||
+            active.nextRunAt === null ||
+            DateTime.toEpochMillis(DateTime.makeUnsafe(active.nextRunAt)) >
+              DateTime.toEpochMillis(startedAt))
+        ) {
+          return active;
+        }
+
+        yield* markRunning(active.id, startedAtIso);
+        yield* notifyChanged;
+
+        const fireKey = `${active.id}:${DateTime.toEpochMillis(startedAt)}:${trigger}`;
+        const commandId = CommandId.make(`scheduled-task:${fireKey}`);
+        const messageId = MessageId.make(`scheduled-task-message:${fireKey}`);
+        // Dispatch from the fresh row so prompt/model/binding edits made
+        // after the poll read are honoured.
+        const prompt = automationPrompt(active);
+
+        // Effect.exit (not Effect.result) so defects and interruptions in the
+        // dispatch are also captured and recorded as a failed run instead of
+        // aborting before markCompleted.
+        const result =
+          active.threadId === null
+            ? yield* Effect.exit(
+                threadLaunch.launch({
+                  commandId,
+                  projectId: active.projectId,
+                  title: active.title,
+                  modelSelection: active.modelSelection,
+                  runtimeMode: active.runtimeMode,
+                  interactionMode: active.interactionMode,
+                  workspaceStrategy: active.workspaceStrategy,
+                  initialMessage: {
+                    messageId,
+                    text: prompt,
+                    attachments: [],
+                  },
+                  createdBy: active.createdBy,
+                  creationSource: active.creationSource,
+                }),
+              )
+            : yield* Effect.exit(
+                threadManagement.sendToThread({
+                  projectId: active.projectId,
+                  commandId,
+                  threadId: ThreadId.make(active.threadId),
+                  messageId,
+                  text: prompt,
+                  attachments: [],
+                  modelSelection: active.modelSelection,
+                  mode: "auto",
+                  createdBy: active.createdBy,
+                  creationSource: active.creationSource,
+                }),
+              );
+
+        const completedAt = yield* localNow;
+        const runSucceeded = result._tag === "Success";
+        const lastRunStatus = runSucceeded ? ("succeeded" as const) : ("failed" as const);
+        const lastRunError = runSucceeded ? null : errorMessage(result.cause);
+        // Re-read the task so the next run is computed from the schedule as it
+        // is *now* (the user may have edited or deleted it while we ran).
+        const current = yield* findTask(task.id);
+        const scheduleSource = current ?? task;
+        const completed: ScheduledTask = {
+          ...scheduleSource,
+          updatedAt: iso(completedAt),
+          lastRunAt: startedAtIso,
+          nextRunAt: nextRunAt(scheduleSource, completedAt),
+          lastRunStatus,
+          lastRunError,
+          runCount: scheduleSource.runCount + 1,
+        };
+        if (current !== null) {
+          // startedAtIso in the guard ensures this writes only to the row this
+          // run marked as running — a task deleted mid-run and recreated with
+          // the same id (idempotent commandId replay) must not be stamped.
+          yield* markCompleted({
+            id: task.id,
+            completedAtIso: completed.updatedAt,
+            nextRunAtIso: completed.nextRunAt,
+            status: lastRunStatus,
+            error: lastRunError,
+            startedAtIso,
+          });
+          yield* notifyChanged;
+        }
+        return completed;
+      }).pipe(
+        Effect.onError((cause) => releaseStuckRun(task, errorMessage(cause))),
+        Effect.ensuring(
+          Ref.update(activeRuns, (active) => {
+            const next = new Set(active);
+            next.delete(task.id);
+            return next;
+          }),
+        ),
+      );
+    });
+
+    // A due fixed-time run that is long past its slot (server was off or
+    // asleep) is skipped and re-aimed at its next occurrence, not fired late.
+    const rescheduleMissedRun = Effect.fn("ScheduledTaskService.rescheduleMissedRun")(function* (
+      task: ScheduledTask,
+      now: DateTime.DateTime,
+    ) {
+      const next = nextRunAt(task, now);
+      yield* Effect.logInfo("Skipping missed schedule task run", {
+        taskId: task.id,
+        missedRunAt: task.nextRunAt,
+        rescheduledTo: next,
+      });
+      yield* sql`
+        UPDATE scheduled_tasks
+        SET next_run_at = ${next},
+            updated_at = ${iso(now)}
+        WHERE task_id = ${task.id}
+      `.pipe(
+        Effect.mapError((cause) =>
+          taskError("Could not reschedule missed schedule task run.", { taskId: task.id, cause }),
+        ),
+      );
+      yield* notifyChanged;
+    });
+
+    const runDueTasks = Effect.fn("ScheduledTaskService.runDueTasks")(function* () {
+      const tasks = yield* listTasksLenient().pipe(
+        Effect.mapError((cause) => taskError("Could not list schedule tasks.", { cause })),
+      );
+      const now = yield* localNow;
+      const nowEpochMillis = DateTime.toEpochMillis(now);
+      const due = tasks.flatMap((task) => {
+        if (!task.enabled || task.nextRunAt === null || task.lastRunStatus === "running") {
+          return [];
+        }
+        const dueAt = DateTime.makeUnsafe(task.nextRunAt);
+        return DateTime.toEpochMillis(dueAt) <= nowEpochMillis ? [{ task, dueAt }] : [];
+      });
+      yield* Effect.forEach(
+        due,
+        ({ task, dueAt }) =>
+          (isMissedFixedTimeRun(task.schedule, dueAt, now)
+            ? rescheduleMissedRun(task, now)
+            : runTask(task, "scheduled")
+          ).pipe(
+            Effect.catch((cause) =>
+              Effect.logWarning("Scheduled task run failed", { taskId: task.id, cause }),
+            ),
+          ),
+        { concurrency: 1, discard: true },
+      );
+    });
+
+    // Recover from a crash or hard shutdown mid-run: rows stuck in 'running'
+    // would otherwise be skipped by the due-task filter forever. The dispatch
+    // may already have gone out before the crash, so next_run_at must advance
+    // and run_count must count the attempt — otherwise the first poll after
+    // every restart re-fires the interrupted task (same rationale as
+    // releaseStuckRun). Schedules are JSON, so this is per-row Effect work
+    // rather than a single UPDATE.
+    yield* Effect.gen(function* () {
+      const rows = yield* selectAllRows();
+      const stuck = rows.filter((row) => row.last_run_status === "running");
+      if (stuck.length === 0) return;
+      const now = yield* localNow;
+      yield* Effect.forEach(
+        stuck,
+        (row) =>
+          Effect.gen(function* () {
+            const decoded = yield* Effect.result(decodeRow(row));
+            if (Result.isSuccess(decoded)) {
+              yield* sql`
+                UPDATE scheduled_tasks
+                SET last_run_status = 'failed',
+                    last_run_error = 'Run was interrupted by a server restart.',
+                    next_run_at = ${nextRunAt(decoded.success, now)},
+                    updated_at = ${iso(now)},
+                    run_count = run_count + 1
+                WHERE task_id = ${row.task_id} AND last_run_status = 'running'
+              `;
+              return;
+            }
+            // The schedule cannot be decoded, so the next occurrence cannot
+            // be computed — still release the row so it is not stuck in
+            // 'running' (the lenient poller skips it, so it cannot re-fire).
+            yield* Effect.logWarning(
+              "Recovering undecodable schedule task row without rescheduling",
+              { taskId: row.task_id, cause: decoded.failure },
+            );
+            yield* sql`
+              UPDATE scheduled_tasks
+              SET last_run_status = 'failed',
+                  last_run_error = 'Run was interrupted by a server restart.',
+                  updated_at = ${iso(now)},
+                  run_count = run_count + 1
+              WHERE task_id = ${row.task_id} AND last_run_status = 'running'
+            `;
+          }),
+        { concurrency: 1, discard: true },
+      );
+      yield* notifyChanged;
+    }).pipe(
+      Effect.catch((cause) =>
+        Effect.logWarning("Could not reset interrupted schedule task runs", { cause }),
+      ),
+    );
+
+    yield* runDueTasks().pipe(
+      Effect.catch((cause) => Effect.logWarning("Scheduled task polling failed", { cause })),
+      Effect.delay(Duration.seconds(5)),
+      Effect.forever,
+      Effect.forkScoped,
+    );
+
+    const list: ScheduledTaskService["Service"]["list"] = () =>
+      listRows().pipe(
+        Effect.map((tasks) => ({ tasks })),
+        Effect.mapError((cause) => taskError("Could not list schedule tasks.", { cause })),
+      );
+
+    const subscribeList: ScheduledTaskService["Service"]["subscribeList"] = () =>
+      Stream.unwrap(
+        Effect.gen(function* () {
+          // Subscribe before taking the snapshot so a change landing between
+          // the two is buffered by the subscription rather than dropped.
+          const subscription = yield* PubSub.subscribe(changesPubSub);
+          return Stream.concat(
+            Stream.fromEffect(list()),
+            Stream.fromSubscription(subscription).pipe(Stream.mapEffect(() => list())),
+          );
+        }),
+      );
+
+    const upsert: ScheduledTaskService["Service"]["upsert"] = (input) =>
+      Effect.gen(function* () {
+        const now = yield* localNow;
+        const uuid =
+          input.commandId === undefined
+            ? yield* crypto.randomUUIDv4.pipe(
+                Effect.mapError((cause) =>
+                  taskError("Could not generate schedule task id.", { cause }),
+                ),
+              )
+            : null;
+        const id =
+          input.id ??
+          ScheduledTaskId.make(
+            input.commandId ? `scheduled-task:${input.commandId}` : `scheduled-task:${uuid}`,
+          );
+        // Look up by the *resolved* id so idempotent creates (commandId replays)
+        // keep their run history, and so real load failures propagate instead
+        // of silently resetting an existing row.
+        const existingTask = yield* findTask(id);
+        // Keep the existing next_run_at when the schedule itself is untouched:
+        // editing a title or prompt must not postpone (or resurrect) a due
+        // run — only schedule/enabled changes restart the clock.
+        const scheduleUnchanged =
+          existingTask !== null &&
+          existingTask.enabled === input.enabled &&
+          isSameSchedule(existingTask.schedule, input.schedule);
+        const task: ScheduledTask = {
+          id,
+          title: input.title,
+          prompt: input.prompt,
+          enabled: input.enabled,
+          schedule: input.schedule,
+          projectId: input.projectId,
+          threadId: input.threadId ?? null,
+          workspaceStrategy: input.workspaceStrategy,
+          modelSelection: input.modelSelection,
+          runtimeMode: input.runtimeMode,
+          interactionMode: input.interactionMode,
+          createdBy: existingTask?.createdBy ?? input.createdBy ?? "user",
+          creationSource: input.creationSource ?? "web",
+          createdAt: existingTask?.createdAt ?? iso(now),
+          updatedAt: iso(now),
+          nextRunAt: scheduleUnchanged
+            ? existingTask.nextRunAt
+            : nextRunAt({ enabled: input.enabled, schedule: input.schedule }, now),
+          lastRunAt: existingTask?.lastRunAt ?? null,
+          lastRunStatus: existingTask?.lastRunStatus ?? "never",
+          lastRunError: existingTask?.lastRunError ?? null,
+          runCount: existingTask?.runCount ?? 0,
+        };
+        yield* saveTask(task);
+        yield* notifyChanged;
+        return { task };
+      });
+
+    const setEnabled: ScheduledTaskService["Service"]["setEnabled"] = (input) =>
+      Effect.gen(function* () {
+        const existing = yield* loadTask(input.id);
+        if (existing.enabled === input.enabled) return { task: existing };
+        const now = yield* localNow;
+        const next = nextRunAt({ enabled: input.enabled, schedule: existing.schedule }, now);
+        // RETURNING so a task deleted between the load and this UPDATE is a
+        // visible not-found error, not a false success.
+        const updated = yield* sql<{ task_id: string }>`
+          UPDATE scheduled_tasks
+          SET enabled = ${input.enabled ? 1 : 0},
+              next_run_at = ${next},
+              updated_at = ${iso(now)}
+          WHERE task_id = ${input.id}
+          RETURNING task_id
+        `.pipe(
+          Effect.mapError((cause) =>
+            taskError("Could not update schedule task.", { taskId: input.id, cause }),
+          ),
+        );
+        if (updated.length === 0) {
+          return yield* taskError("Schedule task not found.", { taskId: input.id });
+        }
+        yield* notifyChanged;
+        return {
+          task: { ...existing, enabled: input.enabled, nextRunAt: next, updatedAt: iso(now) },
+        };
+      });
+
+    const deleteTask: ScheduledTaskService["Service"]["delete"] = (input) =>
+      deleteRow(input.id).pipe(Effect.andThen(notifyChanged), Effect.as({ id: input.id }));
+
+    const runNow: ScheduledTaskService["Service"]["runNow"] = (input: ScheduledTaskRunNowInput) =>
+      Effect.gen(function* () {
+        const task = yield* loadTask(input.id);
+        const next = yield* runTask(task, "manual").pipe(
+          Effect.mapError((cause) =>
+            taskError("Could not run schedule task.", { taskId: input.id, cause }),
+          ),
+        );
+        return { task: next };
+      });
+
+    return ScheduledTaskService.of({
+      list,
+      subscribeList,
+      upsert,
+      setEnabled,
+      delete: deleteTask,
+      runNow,
+    });
+  }),
+);
diff --git a/apps/server/src/server.test.ts b/apps/server/src/server.test.ts
deleted file mode 100644
index f609f7f1748c..000000000000
--- a/apps/server/src/server.test.ts
+++ /dev/null
@@ -1,9096 +0,0 @@
-import * as NodeHttpServer from "@effect/platform-node/NodeHttpServer";
-import * as NodeSocket from "@effect/platform-node/NodeSocket";
-import * as NodeServices from "@effect/platform-node/NodeServices";
-import * as NodeCrypto from "node:crypto";
-import { HostProcessEnvironment, HostProcessPlatform } from "@t3tools/shared/hostProcess";
-
-import {
-  AuthAccessTokenType,
-  AuthEnvironmentBootstrapTokenType,
-  AuthTokenExchangeGrantType,
-  CommandId,
-  DEFAULT_SERVER_SETTINGS,
-  type DpopFailureReason,
-  EnvironmentId,
-  EventId,
-  GitCommandError,
-  KeybindingRule,
-  MessageId,
-  ExternalLauncherCommandNotFoundError,
-  OrchestrationThreadDetailSnapshot,
-  type OrchestrationThreadStreamItem,
-  type OrchestrationThreadShell,
-  TerminalNotRunningError,
-  type OrchestrationCommand,
-  type OrchestrationEvent,
-  ORCHESTRATION_WS_METHODS,
-  type PreviewEvent,
-  ProjectId,
-  ProviderDriverKind,
-  ProviderInstanceId,
-  ResolvedKeybindingRule,
-  ThreadId,
-  WS_METHODS,
-  WsRpcGroup,
-  EditorId,
-} from "@t3tools/contracts";
-import {
-  computeDpopAccessTokenHash,
-  computeDpopJwkThumbprint,
-  type DpopPublicJwk,
-} from "@t3tools/shared/dpop";
-import { RELAY_HEALTH_REQUEST_TYP, RELAY_MINT_REQUEST_TYP } from "@t3tools/shared/relayJwt";
-import * as RelayClient from "@t3tools/shared/relayClient";
-import { assert, it } from "@effect/vitest";
-import { assertFailure, assertInclude, assertTrue } from "@effect/vitest/utils";
-import * as Clock from "effect/Clock";
-import * as Config from "effect/Config";
-import * as Deferred from "effect/Deferred";
-import * as DateTime from "effect/DateTime";
-import * as Duration from "effect/Duration";
-import * as Effect from "effect/Effect";
-import * as FileSystem from "effect/FileSystem";
-import * as Fiber from "effect/Fiber";
-import * as Layer from "effect/Layer";
-import * as ManagedRuntime from "effect/ManagedRuntime";
-import * as Option from "effect/Option";
-import * as Path from "effect/Path";
-import * as PubSub from "effect/PubSub";
-import * as Queue from "effect/Queue";
-import * as Ref from "effect/Ref";
-import * as Schema from "effect/Schema";
-import * as Stream from "effect/Stream";
-import * as TestClock from "effect/testing/TestClock";
-import { ChildProcessSpawner } from "effect/unstable/process";
-import {
-  FetchHttpClient,
-  HttpBody,
-  HttpClient,
-  HttpClientRequest,
-  HttpClientResponse,
-  HttpRouter,
-  HttpServer,
-} from "effect/unstable/http";
-import { OtlpSerialization, OtlpTracer } from "effect/unstable/observability";
-import { RpcClient, RpcSerialization } from "effect/unstable/rpc";
-import * as Socket from "effect/unstable/socket/Socket";
-import { vi } from "vite-plus/test";
-
-const TEST_EPOCH = DateTime.makeUnsafe("1970-01-01T00:00:00.000Z");
-const decodeTransferThreadSnapshot = Schema.decodeUnknownEffect(
-  Schema.fromJsonString(OrchestrationThreadDetailSnapshot),
-);
-
-const collectQueueUntil = Effect.fn("TransferBudget.collectQueueUntil")(function* <A>(
-  queue: Queue.Queue<A>,
-  predicate: (value: A) => boolean,
-  waitDescription: string,
-) {
-  return yield* Effect.gen(function* () {
-    const values: A[] = [];
-    while (true) {
-      const value = yield* Queue.take(queue);
-      values.push(value);
-      if (predicate(value)) return values;
-    }
-  }).pipe(
-    Effect.timeoutOrElse({
-      duration: "10 seconds",
-      orElse: () => Effect.die(new Error(`Timed out waiting for ${waitDescription}`)),
-    }),
-  );
-});
-
-import * as BackgroundPolicy from "./background/BackgroundPolicy.ts";
-import * as ServerConfig from "./config.ts";
-import { makeRoutesLayer } from "./server.ts";
-import {
-  isThreadDetailEvent,
-  resolveAvailableEditorsForConfig,
-  resolveFileManagerRevealKindForConfig,
-} from "./ws.ts";
-import * as CheckpointDiffQuery from "./checkpointing/CheckpointDiffQuery.ts";
-import * as GitManager from "./git/GitManager.ts";
-import * as EnvironmentTheme from "./environmentTheme.ts";
-import * as Keybindings from "./keybindings.ts";
-import * as ExternalLauncher from "./process/externalLauncher.ts";
-import * as RemoteOpenTargets from "./environment/RemoteOpenTargets.ts";
-import * as OrchestrationEngine from "./orchestration/Services/OrchestrationEngine.ts";
-import { OrchestrationListenerCallbackError } from "./orchestration/Errors.ts";
-import * as ProjectionSnapshotQuery from "./orchestration/Services/ProjectionSnapshotQuery.ts";
-import { ThreadDeletionReactor } from "./orchestration/Services/ThreadDeletionReactor.ts";
-import { SqlitePersistenceMemory } from "./persistence/Layers/Sqlite.ts";
-import { PersistenceSqlError } from "./persistence/Errors.ts";
-import * as ProviderRegistry from "./provider/Services/ProviderRegistry.ts";
-import * as ProviderService from "./provider/Services/ProviderService.ts";
-import { ProviderAdapterRequestError } from "./provider/Errors.ts";
-import { makeManualOnlyProviderMaintenanceCapabilities } from "./provider/providerMaintenance.ts";
-import * as ServerLifecycleEvents from "./serverLifecycleEvents.ts";
-import * as ServerRuntimeStartup from "./serverRuntimeStartup.ts";
-import * as ServiceLauncherClient from "./cloud/serviceLauncherClient.ts";
-import * as ServerSettings from "./serverSettings.ts";
-import * as TerminalManager from "./terminal/Manager.ts";
-import * as PreviewManager from "./preview/Manager.ts";
-import * as PortScanner from "./preview/PortScanner.ts";
-import * as BrowserTraceCollector from "./observability/BrowserTraceCollector.ts";
-import * as ProjectFaviconResolver from "./project/ProjectFaviconResolver.ts";
-import * as T3ProjectFileLoader from "./project/T3ProjectFileLoader.ts";
-import * as ProjectSetupScriptRunner from "./project/ProjectSetupScriptRunner.ts";
-import * as RepositoryIdentityResolver from "./project/RepositoryIdentityResolver.ts";
-import * as ServerEnvironment from "./environment/ServerEnvironment.ts";
-import * as WorkspaceEntries from "./workspace/WorkspaceEntries.ts";
-import * as WorkspaceFileSystem from "./workspace/WorkspaceFileSystem.ts";
-import * as WorkspacePaths from "./workspace/WorkspacePaths.ts";
-import * as GitVcsDriver from "./vcs/GitVcsDriver.ts";
-import * as VcsDriver from "./vcs/VcsDriver.ts";
-import * as VcsStatusBroadcaster from "./vcs/VcsStatusBroadcaster.ts";
-import * as VcsDriverRegistry from "./vcs/VcsDriverRegistry.ts";
-import * as VcsProvisioningService from "./vcs/VcsProvisioningService.ts";
-import * as GitWorkflowService from "./git/GitWorkflowService.ts";
-import * as ReviewService from "./review/ReviewService.ts";
-import * as SourceControlRepositoryService from "./sourceControl/SourceControlRepositoryService.ts";
-import * as ServerSecretStore from "./auth/ServerSecretStore.ts";
-import * as EnvironmentAuth from "./auth/EnvironmentAuth.ts";
-import * as CloudManagedEndpointRuntime from "./cloud/ManagedEndpointRuntime.ts";
-import * as CloudCliTokenManager from "./cloud/CliTokenManager.ts";
-import * as ProcessDiagnostics from "./diagnostics/ProcessDiagnostics.ts";
-import * as ProcessResourceMonitor from "./diagnostics/ProcessResourceMonitor.ts";
-import * as TraceDiagnostics from "./diagnostics/TraceDiagnostics.ts";
-import * as DesktopTelemetryReceiver from "./resourceTelemetry/DesktopTelemetryReceiver.ts";
-import * as NativeTelemetryClient from "./resourceTelemetry/NativeTelemetryClient.ts";
-import * as ResourceAttribution from "./resourceTelemetry/ResourceAttribution.ts";
-import * as ResourceTelemetry from "./resourceTelemetry/ResourceTelemetry.ts";
-import * as UsageService from "./usage/UsageService.ts";
-import * as AnalyticsService from "./telemetry/AnalyticsService.ts";
-import * as Data from "effect/Data";
-
-import { makeOrchestrationIntegrationHarness } from "../integration/OrchestrationEngineHarness.integration.ts";
-import {
-  countingWsRpcProtocolLayer,
-  makeCountingWsRpcClient,
-  makeWebSocketTransferRecorder,
-  measureHttpGet,
-  transferDelta,
-} from "../integration/NetworkTransferMeasurement.integration.ts";
-import {
-  expectedMeasuredAssistantText,
-  queueMeasuredTransferTurn,
-  seedTransferBudgetHistory,
-  TRANSFER_HISTORY_TURN_COUNT,
-  TRANSFER_MEASURED_TURN_CREATED_AT,
-  TRANSFER_MEASURED_TURN_INDEX,
-  TRANSFER_THREAD_ID,
-  transferModelSelection,
-  waitForTurnQuiesced,
-} from "../integration/TransferBudgetScenario.integration.ts";
-import {
-  formatTransferBudgetReport,
-  formatTransferBudgetResult,
-  type TransferBudgetRun,
-  transferBudgetViolations,
-} from "../integration/TransferBudgetReport.integration.ts";
-
-const defaultProjectId = ProjectId.make("project-default");
-const defaultThreadId = ThreadId.make("thread-default");
-const defaultDesktopBootstrapToken = "test-desktop-bootstrap-token";
-const defaultModelSelection = {
-  instanceId: ProviderInstanceId.make("codex"),
-  model: "gpt-5-codex",
-} as const;
-const testEnvironmentDescriptor = {
-  environmentId: EnvironmentId.make("environment-test"),
-  label: "Test environment",
-  platform: {
-    os: "darwin" as const,
-    arch: "arm64" as const,
-  },
-  serverVersion: "0.0.0-test",
-  capabilities: {
-    repositoryIdentity: true,
-  },
-};
-const makeDefaultOrchestrationReadModel = () => {
-  const now = "2026-01-01T00:00:00.000Z";
-  return {
-    snapshotSequence: 0,
-    updatedAt: now,
-    projects: [
-      {
-        id: defaultProjectId,
-        title: "Default Project",
-        workspaceRoot: "/tmp/default-project",
-        defaultModelSelection,
-        scripts: [],
-        createdAt: now,
-        updatedAt: now,
-        deletedAt: null,
-      },
-    ],
-    threads: [
-      {
-        id: defaultThreadId,
-        projectId: defaultProjectId,
-        title: "Default Thread",
-        modelSelection: defaultModelSelection,
-        interactionMode: "default" as const,
-        runtimeMode: "full-access" as const,
-        branch: null,
-        worktreePath: null,
-        createdAt: now,
-        updatedAt: now,
-        archivedAt: null,
-        settledOverride: null,
-        settledAt: null,
-        latestTurn: null,
-        messages: [],
-        session: null,
-        activities: [],
-        proposedPlans: [],
-        checkpoints: [],
-        deletedAt: null,
-      },
-    ],
-  };
-};
-
-const makeDefaultOrchestrationThreadShell = (
-  overrides: Partial<OrchestrationThreadShell> = {},
-): OrchestrationThreadShell => {
-  const now = "2026-01-01T00:00:00.000Z";
-  return {
-    id: defaultThreadId,
-    projectId: defaultProjectId,
-    title: "Default Thread",
-    modelSelection: defaultModelSelection,
-    runtimeMode: "full-access",
-    interactionMode: "default",
-    branch: null,
-    worktreePath: null,
-    latestTurn: null,
-    createdAt: now,
-    updatedAt: now,
-    archivedAt: null,
-    settledOverride: null,
-    settledAt: null,
-    session: null,
-    latestUserMessageAt: null,
-    hasPendingApprovals: false,
-    hasPendingUserInput: false,
-    hasActionableProposedPlan: false,
-    ...overrides,
-  };
-};
-
-const browserOtlpTracingLayer = Layer.mergeAll(
-  FetchHttpClient.layer,
-  OtlpSerialization.layerJson,
-  Layer.succeed(HttpClient.TracerDisabledWhen, () => true),
-);
-
-const makeAuthTestLayer = () =>
-  EnvironmentAuth.layer.pipe(
-    Layer.provide(SqlitePersistenceMemory),
-    Layer.provide(ServerSecretStore.layer),
-  );
-
-const makeBrowserOtlpPayload = (spanName: string) =>
-  Effect.gen(function* () {
-    const collector = yield* Effect.acquireRelease(
-      Effect.promise(async () => {
-        const NodeHttp = await import("node:http");
-
-        return await new Promise<{
-          readonly close: () => Promise<void>;
-          readonly firstRequest: Promise<{
-            readonly body: string;
-            readonly contentType: string | null;
-          }>;
-          readonly url: string;
-        }>((resolve, reject) => {
-          let resolveFirstRequest:
-            | ((request: { readonly body: string; readonly contentType: string | null }) => void)
-            | undefined;
-          const firstRequest = new Promise<{
-            readonly body: string;
-            readonly contentType: string | null;
-          }>((resolveRequest) => {
-            resolveFirstRequest = resolveRequest;
-          });
-
-          const server = NodeHttp.createServer((request, response) => {
-            const chunks: Buffer[] = [];
-            request.on("data", (chunk) => {
-              chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
-            });
-            request.on("end", () => {
-              resolveFirstRequest?.({
-                body: Buffer.concat(chunks).toString("utf8"),
-                contentType: request.headers["content-type"] ?? null,
-              });
-              resolveFirstRequest = undefined;
-              response.statusCode = 204;
-              response.end();
-            });
-          });
-
-          server.on("error", reject);
-          server.listen(0, "127.0.0.1", () => {
-            const address = server.address();
-            if (!address || typeof address === "string") {
-              reject(new Error("Expected TCP collector address"));
-              return;
-            }
-
-            resolve({
-              url: `http://127.0.0.1:${address.port}/v1/traces`,
-              firstRequest,
-              close: () =>
-                new Promise<void>((resolveClose, rejectClose) => {
-                  server.close((error) => {
-                    if (error) {
-                      rejectClose(error);
-                      return;
-                    }
-                    resolveClose();
-                  });
-                }),
-            });
-          });
-        });
-      }),
-      ({ close }) => Effect.promise(close),
-    );
-
-    const runtime = ManagedRuntime.make(
-      OtlpTracer.layer({
-        url: collector.url,
-        exportInterval: "10 millis",
-        resource: {
-          serviceName: "t3-web",
-          attributes: {
-            "service.runtime": "t3-web",
-            "service.mode": "browser",
-            "service.version": "test",
-          },
-        },
-      }).pipe(Layer.provide(browserOtlpTracingLayer)),
-    );
-
-    try {
-      yield* Effect.promise(() => runtime.runPromise(Effect.void.pipe(Effect.withSpan(spanName))));
-    } finally {
-      yield* Effect.promise(() => runtime.dispose());
-    }
-
-    const request = yield* Effect.raceFirst(
-      Effect.promise(() => collector.firstRequest).pipe(Effect.orDie),
-      Effect.sleep(Duration.seconds(1)).pipe(
-        Effect.andThen(Effect.die(new Error("Timed out waiting for OTLP trace export"))),
-      ),
-    );
-    // @effect-diagnostics-next-line preferSchemaOverJson:off
-    return JSON.parse(request.body) as OtlpTracer.TraceData;
-  });
-
-const buildAppUnderTest = (options?: {
-  config?: Partial<ServerConfig.ServerConfig["Service"]>;
-  layers?: {
-    keybindings?: Partial<Keybindings.Keybindings["Service"]>;
-    environmentTheme?: Partial<EnvironmentTheme.EnvironmentThemeService["Service"]>;
-    providerRegistry?: Partial<ProviderRegistry.ProviderRegistry["Service"]>;
-    providerService?: Partial<ProviderService.ProviderService["Service"]>;
-    serverSettings?: Partial<ServerSettings.ServerSettingsService["Service"]>;
-    externalLauncher?: Partial<ExternalLauncher.ExternalLauncher["Service"]>;
-    vcsDriver?: Partial<VcsDriver.VcsDriver["Service"]>;
-    vcsDriverRegistry?: Partial<VcsDriverRegistry.VcsDriverRegistry["Service"]>;
-    gitVcsDriver?: Partial<GitVcsDriver.GitVcsDriver["Service"]>;
-    gitManager?: Partial<GitManager.GitManager["Service"]>;
-    sourceControlRepositoryService?: Partial<
-      SourceControlRepositoryService.SourceControlRepositoryService["Service"]
-    >;
-    reviewService?: Partial<ReviewService.ReviewService["Service"]>;
-    vcsStatusBroadcaster?: Partial<VcsStatusBroadcaster.VcsStatusBroadcaster["Service"]>;
-    projectSetupScriptRunner?: Partial<
-      ProjectSetupScriptRunner.ProjectSetupScriptRunner["Service"]
-    >;
-    terminalManager?: Partial<TerminalManager.TerminalManager["Service"]>;
-    orchestrationEngine?: Partial<OrchestrationEngine.OrchestrationEngineService["Service"]>;
-    threadDeletionReactor?: Partial<ThreadDeletionReactor["Service"]>;
-    analyticsService?: Partial<AnalyticsService.AnalyticsService["Service"]>;
-    projectionSnapshotQuery?: Partial<ProjectionSnapshotQuery.ProjectionSnapshotQuery["Service"]>;
-    checkpointDiffQuery?: Partial<CheckpointDiffQuery.CheckpointDiffQuery["Service"]>;
-    browserTraceCollector?: Partial<BrowserTraceCollector.BrowserTraceCollector["Service"]>;
-    serverLifecycleEvents?: Partial<ServerLifecycleEvents.ServerLifecycleEvents["Service"]>;
-    serverRuntimeStartup?: Partial<ServerRuntimeStartup.ServerRuntimeStartup["Service"]>;
-    serverEnvironment?: Partial<ServerEnvironment.ServerEnvironment["Service"]>;
-    repositoryIdentityResolver?: Partial<
-      RepositoryIdentityResolver.RepositoryIdentityResolver["Service"]
-    >;
-    cloudManagedEndpointRuntime?: Partial<
-      CloudManagedEndpointRuntime.CloudManagedEndpointRuntime["Service"]
-    >;
-    relayClient?: Partial<RelayClient.RelayClient["Service"]>;
-    cloudCliTokenManager?: Partial<CloudCliTokenManager.CloudCliTokenManager["Service"]>;
-    nativeTelemetryClient?: Partial<NativeTelemetryClient.NativeTelemetryClient["Service"]>;
-    desktopTelemetryReceiver?: Partial<
-      DesktopTelemetryReceiver.DesktopTelemetryReceiver["Service"]
-    >;
-  };
-}) =>
-  Effect.gen(function* () {
-    const fileSystem = yield* FileSystem.FileSystem;
-    const tempBaseDir = yield* fileSystem.makeTempDirectoryScoped({ prefix: "t3-router-test-" });
-    const baseDir = options?.config?.baseDir ?? tempBaseDir;
-    const devUrl = options?.config?.devUrl;
-    const derivedPaths = yield* ServerConfig.deriveServerPaths(baseDir, devUrl);
-    const config: ServerConfig.ServerConfig["Service"] = {
-      logLevel: "Info",
-      traceMinLevel: "Info",
-      traceTimingEnabled: true,
-      traceBatchWindowMs: 200,
-      traceMaxBytes: 10 * 1024 * 1024,
-      traceMaxFiles: 10,
-      otlpTracesUrl: undefined,
-      otlpMetricsUrl: undefined,
-      otlpExportIntervalMs: 10_000,
-      otlpServiceName: "t3-server",
-      mode: "desktop",
-      port: 0,
-      host: "127.0.0.1",
-      cwd: process.cwd(),
-      baseDir,
-      ...derivedPaths,
-      staticDir: undefined,
-      devUrl,
-      devAllowedOrigins: [],
-      noBrowser: true,
-      startupPresentation: "browser",
-      desktopBootstrapToken: defaultDesktopBootstrapToken,
-      autoBootstrapProjectFromCwd: false,
-      logWebSocketEvents: false,
-      tailscaleServeEnabled: false,
-      tailscaleServePort: 443,
-      ...options?.config,
-    };
-    const layerConfig = ServerConfig.layer(config);
-    const defaultVcsDriver: VcsDriver.VcsDriver["Service"] = {
-      capabilities: {
-        kind: "git",
-        supportsWorktrees: true,
-        supportsBookmarks: false,
-        supportsAtomicSnapshot: false,
-        supportsPushDefaultRemote: true,
-        ignoreClassifier: "native",
-      },
-      execute: () =>
-        Effect.succeed({
-          exitCode: ChildProcessSpawner.ExitCode(0),
-          stdout: "",
-          stderr: "",
-          stdoutTruncated: false,
-          stderrTruncated: false,
-        }),
-      detectRepository: () => Effect.succeed(null),
-      isInsideWorkTree: () => Effect.succeed(false),
-      listWorkspaceFiles: () =>
-        Effect.succeed({
-          paths: [],
-          truncated: false,
-          freshness: {
-            source: "live-local",
-            observedAt: TEST_EPOCH,
-            expiresAt: Option.none(),
-          },
-        }),
-      listRemotes: () =>
-        Effect.succeed({
-          remotes: [],
-          freshness: {
-            source: "live-local",
-            observedAt: TEST_EPOCH,
-            expiresAt: Option.none(),
-          },
-        }),
-      filterIgnoredPaths: (_cwd, relativePaths) => Effect.succeed(relativePaths),
-      initRepository: () => Effect.void,
-      ...options?.layers?.vcsDriver,
-    };
-    const vcsDriverRegistryLayer = Layer.mock(VcsDriverRegistry.VcsDriverRegistry)({
-      get: () => Effect.succeed(defaultVcsDriver),
-      detect: (input) =>
-        defaultVcsDriver.detectRepository(input.cwd).pipe(
-          Effect.flatMap((repository) =>
-            repository
-              ? Effect.succeed(repository)
-              : defaultVcsDriver.isInsideWorkTree(input.cwd).pipe(
-                  Effect.map((isInsideWorkTree) =>
-                    isInsideWorkTree
-                      ? {
-                          kind: "git" as const,
-                          rootPath: input.cwd,
-                          metadataPath: null,
-                          freshness: {
-                            source: "live-local" as const,
-                            observedAt: TEST_EPOCH,
-                            expiresAt: Option.none(),
-                          },
-                        }
-                      : null,
-                  ),
-                ),
-          ),
-          Effect.map((repository) =>
-            repository
-              ? ({
-                  kind: repository.kind,
-                  repository,
-                  driver: defaultVcsDriver,
-                } satisfies VcsDriverRegistry.VcsDriverHandle)
-              : null,
-          ),
-        ),
-      resolve: (input) =>
-        Effect.succeed({
-          kind:
-            input.requestedKind === "auto" || !input.requestedKind ? "git" : input.requestedKind,
-          repository: {
-            kind:
-              input.requestedKind === "auto" || !input.requestedKind ? "git" : input.requestedKind,
-            rootPath: input.cwd,
-            metadataPath: null,
-            freshness: {
-              source: "live-local",
-              observedAt: TEST_EPOCH,
-              expiresAt: Option.none(),
-            },
-          },
-          driver: defaultVcsDriver,
-        }),
-      ...options?.layers?.vcsDriverRegistry,
-    });
-    const gitVcsDriverLayer = Layer.mock(GitVcsDriver.GitVcsDriver)({
-      ...options?.layers?.gitVcsDriver,
-    });
-    const gitManagerLayer = Layer.mock(GitManager.GitManager)({
-      ...options?.layers?.gitManager,
-    });
-    const workspaceEntriesLayer = WorkspaceEntries.layer.pipe(
-      Layer.provide(WorkspacePaths.layer),
-      Layer.provideMerge(vcsDriverRegistryLayer),
-    );
-    const workspaceAndProjectServicesLayer = Layer.mergeAll(
-      WorkspacePaths.layer,
-      workspaceEntriesLayer,
-      WorkspaceFileSystem.layer.pipe(
-        Layer.provide(WorkspacePaths.layer),
-        Layer.provide(workspaceEntriesLayer),
-      ),
-      ProjectFaviconResolver.layer.pipe(
-        Layer.provide(WorkspacePaths.layer),
-        Layer.provide(T3ProjectFileLoader.layer),
-      ),
-    );
-    const gitWorkflowLayer = GitWorkflowService.layer.pipe(
-      Layer.provideMerge(vcsDriverRegistryLayer),
-      Layer.provideMerge(gitVcsDriverLayer),
-      Layer.provideMerge(gitManagerLayer),
-    );
-    const vcsProvisioningLayer = VcsProvisioningService.layer.pipe(
-      Layer.provide(vcsDriverRegistryLayer),
-    );
-    const reviewLayer = options?.layers?.reviewService
-      ? Layer.mock(ReviewService.ReviewService)({
-          ...options.layers.reviewService,
-        })
-      : ReviewService.layer.pipe(
-          Layer.provideMerge(gitVcsDriverLayer),
-          Layer.provide(vcsDriverRegistryLayer),
-        );
-    const vcsStatusBroadcasterLayer = options?.layers?.vcsStatusBroadcaster
-      ? Layer.mock(VcsStatusBroadcaster.VcsStatusBroadcaster)({
-          ...options.layers.vcsStatusBroadcaster,
-        })
-      : VcsStatusBroadcaster.layer.pipe(Layer.provide(gitWorkflowLayer));
-    const resourceTelemetryLayer = ResourceTelemetry.layer.pipe(
-      Layer.provide(
-        Layer.mergeAll(
-          NativeTelemetryClient.layerTest(options?.layers?.nativeTelemetryClient),
-          DesktopTelemetryReceiver.layerTest(options?.layers?.desktopTelemetryReceiver),
-          ResourceAttribution.layer,
-        ),
-      ),
-    );
-    const serviceLauncherClientLayer = ServiceLauncherClient.layer.pipe(
-      Layer.provide(Layer.succeed(HostProcessEnvironment, {})),
-    );
-
-    const servedRoutesLayer = HttpRouter.serve(
-      makeRoutesLayer.pipe(Layer.provide(serviceLauncherClientLayer)),
-      {
-        disableListenLog: true,
-        disableLogger: true,
-      },
-    ).pipe(
-      Layer.provide(
-        Layer.mergeAll(
-          Layer.mock(Keybindings.Keybindings)({
-            loadConfigState: Effect.succeed({
-              keybindings: [],
-              issues: [],
-            }),
-            streamChanges: Stream.empty,
-            ...options?.layers?.keybindings,
-          }),
-          Layer.mock(EnvironmentTheme.EnvironmentThemeService)({
-            current: Effect.succeed([]),
-            streamChanges: Stream.empty,
-            ...options?.layers?.environmentTheme,
-          }),
-        ),
-      ),
-      Layer.provide(
-        Layer.mergeAll(
-          Layer.mock(ProviderRegistry.ProviderRegistry)({
-            getProviders: Effect.succeed([]),
-            refresh: () => Effect.succeed([]),
-            refreshInstance: () => Effect.succeed([]),
-            getProviderMaintenanceCapabilitiesForInstance: (_instanceId, provider) =>
-              Effect.succeed(
-                makeManualOnlyProviderMaintenanceCapabilities({ provider, packageName: null }),
-              ),
-            setProviderMaintenanceActionState: () => Effect.succeed([]),
-            streamChanges: Stream.empty,
-            ...options?.layers?.providerRegistry,
-          }),
-          Layer.mock(ProviderService.ProviderService)({
-            uploadFeedback: () => Effect.die("Provider feedback is not stubbed in this test"),
-            ...options?.layers?.providerService,
-          }),
-        ),
-      ),
-      Layer.provide(
-        Layer.mock(ServerSettings.ServerSettingsService)({
-          start: Effect.void,
-          ready: Effect.void,
-          getSettings: Effect.succeed(DEFAULT_SERVER_SETTINGS),
-          updateSettings: () => Effect.succeed(DEFAULT_SERVER_SETTINGS),
-          streamChanges: Stream.empty,
-          ...options?.layers?.serverSettings,
-        }),
-      ),
-      Layer.provide(
-        Layer.mergeAll(
-          Layer.mock(ExternalLauncher.ExternalLauncher)({
-            resolveAvailableEditors: () => Effect.succeed([]),
-            resolveFileManagerRevealKind: () => Effect.sync((): undefined => undefined),
-            ...options?.layers?.externalLauncher,
-          }),
-          Layer.mock(RemoteOpenTargets.RemoteOpenTargets)({
-            resolveTargets: () => Effect.succeed([]),
-          }),
-        ),
-      ),
-      Layer.provide(
-        Layer.mock(ProcessDiagnostics.ProcessDiagnostics)({
-          read: Effect.succeed({
-            serverPid: process.pid,
-            readAt: TEST_EPOCH,
-            processCount: 0,
-            totalRssBytes: 0,
-            totalCpuPercent: 0,
-            processes: [],
-            error: Option.none(),
-          }),
-          signal: (input) =>
-            Effect.succeed({
-              pid: input.pid,
-              signal: input.signal,
-              signaled: true,
-              message: Option.none(),
-            }),
-        }),
-      ),
-      Layer.provide(
-        Layer.mock(ProcessResourceMonitor.ProcessResourceMonitor)({
-          readHistory: (input) =>
-            Effect.succeed({
-              readAt: TEST_EPOCH,
-              windowMs: input.windowMs,
-              bucketMs: input.bucketMs,
-              sampleIntervalMs: 5_000,
-              retainedSampleCount: 0,
-              totalCpuSecondsApprox: 0,
-              buckets: [],
-              topProcesses: [],
-              error: Option.none(),
-            }),
-        }),
-      ),
-      Layer.provide(
-        Layer.mock(TraceDiagnostics.TraceDiagnostics)({
-          read: () =>
-            Effect.succeed({
-              traceFilePath: "",
-              scannedFilePaths: [],
-              readAt: TEST_EPOCH,
-              recordCount: 0,
-              parseErrorCount: 0,
-              firstSpanAt: Option.none(),
-              lastSpanAt: Option.none(),
-              failureCount: 0,
-              interruptionCount: 0,
-              slowSpanThresholdMs: 1_000,
-              slowSpanCount: 0,
-              logLevelCounts: {},
-              topSpansByCount: [],
-              slowestSpans: [],
-              commonFailures: [],
-              latestFailures: [],
-              latestWarningAndErrorLogs: [],
-              partialFailure: Option.none(),
-              error: Option.none(),
-            }),
-        }),
-      ),
-      Layer.provide(gitManagerLayer),
-      Layer.provide(gitVcsDriverLayer),
-      Layer.provide(gitWorkflowLayer),
-      Layer.provide(reviewLayer),
-      Layer.provide(vcsProvisioningLayer),
-      Layer.provide(
-        Layer.mock(SourceControlRepositoryService.SourceControlRepositoryService)({
-          ...options?.layers?.sourceControlRepositoryService,
-        }),
-      ),
-      Layer.provideMerge(vcsStatusBroadcasterLayer),
-      Layer.provide(
-        Layer.mock(ProjectSetupScriptRunner.ProjectSetupScriptRunner)({
-          runForThread: () => Effect.succeed({ status: "no-script" as const }),
-          ...options?.layers?.projectSetupScriptRunner,
-        }),
-      ),
-      Layer.provide(
-        Layer.mock(TerminalManager.TerminalManager)({
-          ...options?.layers?.terminalManager,
-        }),
-      ),
-      Layer.provide(
-        Layer.mergeAll(
-          Layer.mock(PreviewManager.PreviewManager)({
-            open: () => Effect.die("PreviewManager not stubbed in this test"),
-            navigate: () => Effect.die("PreviewManager not stubbed in this test"),
-            resize: () => Effect.die("PreviewManager not stubbed in this test"),
-            reportStatus: () => Effect.void,
-            refresh: () => Effect.void,
-            close: () => Effect.void,
-            list: () => Effect.succeed({ sessions: [], serverEpoch: "test-server", revision: 0 }),
-            events: Stream.empty,
-            subscribeEvents: Effect.flatMap(PubSub.unbounded<PreviewEvent>(), (pubsub) =>
-              PubSub.subscribe(pubsub),
-            ),
-          }),
-          Layer.mock(PortScanner.PortDiscovery)({
-            scan: () => Effect.succeed([]),
-            subscribe: () => Effect.void,
-            retain: Effect.void,
-            registerTerminalProcesses: () => Effect.void,
-            unregisterTerminal: () => Effect.void,
-          }),
-        ),
-      ),
-      Layer.provide(
-        Layer.mergeAll(
-          Layer.mock(OrchestrationEngine.OrchestrationEngineService)({
-            readEvents: () => Stream.empty,
-            dispatch: () => Effect.succeed({ sequence: 0 }),
-            streamDomainEvents: Stream.empty,
-            latestSequence: Effect.succeed(0),
-            ...options?.layers?.orchestrationEngine,
-          }),
-          Layer.mock(ThreadDeletionReactor)({
-            start: () => Effect.void,
-            drainThrough: () => Effect.void,
-            ...options?.layers?.threadDeletionReactor,
-          }),
-        ),
-      ),
-      Layer.provide(
-        Layer.mock(ProjectionSnapshotQuery.ProjectionSnapshotQuery)({
-          getCommandReadModel: () => Effect.succeed(makeDefaultOrchestrationReadModel()),
-          getSnapshot: () => Effect.succeed(makeDefaultOrchestrationReadModel()),
-          getShellSnapshot: () =>
-            Effect.succeed({
-              snapshotSequence: 0,
-              projects: [],
-              threads: [],
-              updatedAt: "1970-01-01T00:00:00.000Z",
-            }),
-          getArchivedShellSnapshot: () =>
-            Effect.succeed({
-              snapshotSequence: 0,
-              projects: [],
-              threads: [],
-              updatedAt: "1970-01-01T00:00:00.000Z",
-            }),
-          searchThreads: () => Effect.succeed({ matches: [] }),
-          getSnapshotSequence: () => Effect.succeed({ snapshotSequence: 0 }),
-          getProjectShellById: () => Effect.succeed(Option.none()),
-          getThreadShellById: () => Effect.succeed(Option.none()),
-          getThreadDetailById: () => Effect.succeed(Option.none()),
-          getThreadDetailSnapshot: () => Effect.succeed(Option.none()),
-          getCounts: () => Effect.succeed({ projectCount: 0, threadCount: 0 }),
-          getActiveProjectByWorkspaceRoot: () => Effect.succeed(Option.none()),
-          getFirstActiveThreadIdByProjectId: () => Effect.succeed(Option.none()),
-          getThreadCheckpointContext: () => Effect.succeed(Option.none()),
-          ...options?.layers?.projectionSnapshotQuery,
-        }),
-      ),
-      Layer.provide(
-        Layer.mock(CheckpointDiffQuery.CheckpointDiffQuery)({
-          getTurnDiff: () =>
-            Effect.succeed({
-              threadId: defaultThreadId,
-              fromTurnCount: 0,
-              toTurnCount: 0,
-              diff: "",
-            }),
-          getFullThreadDiff: () =>
-            Effect.succeed({
-              threadId: defaultThreadId,
-              fromTurnCount: 0,
-              toTurnCount: 0,
-              diff: "",
-            }),
-          ...options?.layers?.checkpointDiffQuery,
-        }),
-      ),
-    );
-
-    const appLayer = servedRoutesLayer.pipe(
-      Layer.provide(resourceTelemetryLayer),
-      Layer.provide(UsageService.layerTest),
-      Layer.provide(
-        Layer.mock(AnalyticsService.AnalyticsService)({
-          record: () => Effect.void,
-          flush: Effect.void,
-          ...options?.layers?.analyticsService,
-        }),
-      ),
-      Layer.provide(
-        Layer.mock(BrowserTraceCollector.BrowserTraceCollector)({
-          record: () => Effect.void,
-          ...options?.layers?.browserTraceCollector,
-        }),
-      ),
-      Layer.provide(
-        Layer.mock(ServerLifecycleEvents.ServerLifecycleEvents)({
-          publish: (event) => Effect.succeed({ ...(event as any), sequence: 1 }),
-          snapshot: Effect.succeed({ sequence: 0, events: [] }),
-          stream: Stream.empty,
-          ...options?.layers?.serverLifecycleEvents,
-        }),
-      ),
-      Layer.provide(
-        Layer.mock(ServerRuntimeStartup.ServerRuntimeStartup)({
-          awaitCommandReady: Effect.void,
-          markHttpListening: Effect.void,
-          enqueueCommand: (effect) => effect,
-          ...options?.layers?.serverRuntimeStartup,
-        }),
-      ),
-      Layer.provide(
-        Layer.mock(BackgroundPolicy.BackgroundPolicy)({
-          reportClientActivity: () => Effect.void,
-          removeRpcClient: () => Effect.void,
-          reportHostPowerState: () => Effect.void,
-          snapshot: Effect.succeed({
-            hostPower: {
-              source: "unknown",
-              idle: "unknown",
-              idleSeconds: null,
-              locked: "unknown",
-              suspended: false,
-              onBattery: "unknown",
-              lowPowerMode: "unknown",
-              thermalState: "unknown",
-              stale: true,
-              updatedAt: TEST_EPOCH,
-            },
-            leases: [],
-            activeForegroundLeaseCount: 0,
-            activeScopeKeys: [],
-            shouldRunOpportunisticWork: false,
-            updatedAt: TEST_EPOCH,
-          }),
-          streamChanges: Stream.empty,
-          subscribe: Effect.succeed({
-            latest: {
-              hostPower: {
-                source: "unknown",
-                idle: "unknown",
-                idleSeconds: null,
-                locked: "unknown",
-                suspended: false,
-                onBattery: "unknown",
-                lowPowerMode: "unknown",
-                thermalState: "unknown",
-                stale: true,
-                updatedAt: TEST_EPOCH,
-              },
-              leases: [],
-              activeForegroundLeaseCount: 0,
-              activeScopeKeys: [],
-              shouldRunOpportunisticWork: false,
-              updatedAt: TEST_EPOCH,
-            },
-            changes: Stream.empty,
-          }),
-          hasDemand: () => Effect.succeed(false),
-          shouldRunScopeWork: () => Effect.succeed(false),
-          shouldRunOpportunisticWork: Effect.succeed(false),
-        }),
-      ),
-      Layer.provide(
-        Layer.mock(ServerEnvironment.ServerEnvironment)({
-          getEnvironmentId: Effect.succeed(testEnvironmentDescriptor.environmentId),
-          getDescriptor: Effect.succeed(testEnvironmentDescriptor),
-          ...options?.layers?.serverEnvironment,
-        }),
-      ),
-      Layer.provide(
-        Layer.mock(RepositoryIdentityResolver.RepositoryIdentityResolver)({
-          resolve: () => Effect.succeed(null),
-          ...options?.layers?.repositoryIdentityResolver,
-        }),
-      ),
-      Layer.provide(
-        Layer.succeed(
-          CloudManagedEndpointRuntime.CloudManagedEndpointRuntime,
-          CloudManagedEndpointRuntime.CloudManagedEndpointRuntime.of({
-            applyConfig: () => Effect.succeed({ status: "disabled" }),
-            ...options?.layers?.cloudManagedEndpointRuntime,
-          }),
-        ),
-      ),
-      Layer.provide(
-        Layer.succeed(
-          RelayClient.RelayClient,
-          RelayClient.RelayClient.of({
-            resolve: Effect.succeed({
-              status: "missing",
-              version: RelayClient.CLOUDFLARED_VERSION,
-            }),
-            install: Effect.die("unused relay-client install"),
-            installWithProgress: () => Effect.die("unused relay-client install"),
-            ...options?.layers?.relayClient,
-          }),
-        ),
-      ),
-      Layer.provide(
-        Layer.mock(CloudCliTokenManager.CloudCliTokenManager)({
-          get: Effect.die(new Error("Unexpected T3 Connect CLI authorization request.")),
-          getExisting: Effect.succeed(Option.none()),
-          hasCredential: Effect.succeed(false),
-          clear: Effect.void,
-          ...options?.layers?.cloudCliTokenManager,
-        }),
-      ),
-      Layer.provideMerge(makeAuthTestLayer()),
-      Layer.provideMerge(ServerSecretStore.layer),
-      Layer.provide(workspaceAndProjectServicesLayer),
-      Layer.provideMerge(FetchHttpClient.layer),
-      Layer.provide(layerConfig),
-    );
-
-    yield* Layer.build(appLayer);
-    return config;
-  });
-
-const parseSessionCookieFromWsUrl = (
-  wsUrl: string,
-): { readonly cookie: string | null; readonly url: string } => {
-  const next = new URL(wsUrl);
-  const cookie = next.hash.startsWith("#cookie=")
-    ? decodeURIComponent(next.hash.slice("#cookie=".length))
-    : null;
-  next.hash = "";
-  return {
-    cookie,
-    url: next.toString(),
-  };
-};
-
-const wsRpcProtocolLayer = (wsUrl: string) => {
-  const { cookie, url } = parseSessionCookieFromWsUrl(wsUrl);
-  const webSocketConstructorLayer = Layer.succeed(
-    Socket.WebSocketConstructor,
-    (socketUrl, protocols) =>
-      new NodeSocket.NodeWS.WebSocket(
-        socketUrl,
-        protocols,
-        cookie ? { headers: { cookie } } : undefined,
-      ) as unknown as globalThis.WebSocket,
-  );
-
-  return RpcClient.layerProtocolSocket().pipe(
-    Layer.provide(Socket.layerWebSocket(url).pipe(Layer.provide(webSocketConstructorLayer))),
-    Layer.provide(RpcSerialization.layerJson),
-  );
-};
-
-const makeWsRpcClient = RpcClient.make(WsRpcGroup);
-type WsRpcClient =
-  typeof makeWsRpcClient extends Effect.Effect<infer Client, any, any> ? Client : never;
-
-const withWsRpcClient = <A, E, R>(
-  wsUrl: string,
-  f: (client: WsRpcClient) => Effect.Effect<A, E, R>,
-) => makeWsRpcClient.pipe(Effect.flatMap(f), Effect.provide(wsRpcProtocolLayer(wsUrl)));
-
-const appendSessionCookieToWsUrl = (url: string, sessionCookieHeader: string) => {
-  const isAbsoluteUrl = /^[a-zA-Z][a-zA-Z\d+.-]*:/.test(url);
-  const next = new URL(url, "http://localhost");
-  next.hash = `cookie=${encodeURIComponent(sessionCookieHeader)}`;
-  return isAbsoluteUrl ? next.toString() : `${next.pathname}${next.search}${next.hash}`;
-};
-
-const getHttpServerUrl = (pathname = "") =>
-  Effect.gen(function* () {
-    const server = yield* HttpServer.HttpServer;
-    const address = server.address as HttpServer.TcpAddress;
-    return `http://127.0.0.1:${address.port}${pathname}`;
-  });
-
-const bootstrapBrowserSession = (
-  credential = defaultDesktopBootstrapToken,
-  options?: {
-    readonly headers?: Record<string, string>;
-  },
-) =>
-  Effect.gen(function* () {
-    const bootstrapUrl = yield* getHttpServerUrl("/api/auth/browser-session");
-    const response = yield* fetchEffect(bootstrapUrl, {
-      method: "POST",
-      headers: {
-        "content-type": "application/json",
-        ...options?.headers,
-      },
-      body: jsonRequestBody({
-        credential,
-      }),
-    });
-    const body = yield* responseJsonEffect<{
-      readonly authenticated: boolean;
-      readonly sessionMethod: string;
-      readonly expiresAt: string;
-    }>(response);
-    return {
-      response,
-      body,
-      cookie: response.headers["set-cookie"],
-    };
-  });
-
-const exchangeAccessToken = (
-  credential = defaultDesktopBootstrapToken,
-  options?: {
-    readonly headers?: Record<string, string>;
-    readonly scope?: string;
-    readonly clientMetadata?: {
-      readonly label?: string;
-      readonly deviceType?: string;
-      readonly os?: string;
-    };
-  },
-) =>
-  Effect.gen(function* () {
-    const tokenUrl = yield* getHttpServerUrl("/oauth/token");
-    const response = yield* fetchEffect(tokenUrl, {
-      method: "POST",
-      headers: {
-        "content-type": "application/x-www-form-urlencoded",
-        ...options?.headers,
-      },
-      body: new URLSearchParams({
-        grant_type: AuthTokenExchangeGrantType,
-        subject_token: credential,
-        subject_token_type: AuthEnvironmentBootstrapTokenType,
-        requested_token_type: AuthAccessTokenType,
-        scope:
-          options?.scope ??
-          "orchestration:read orchestration:operate terminal:operate review:write relay:read access:read access:write relay:write",
-        ...(options?.clientMetadata?.label ? { client_label: options.clientMetadata.label } : {}),
-        ...(options?.clientMetadata?.deviceType
-          ? { client_device_type: options.clientMetadata.deviceType }
-          : {}),
-        ...(options?.clientMetadata?.os ? { client_os: options.clientMetadata.os } : {}),
-      }).toString(),
-    });
-    const body = yield* responseJsonEffect<{
-      readonly access_token?: string;
-      readonly issued_token_type?: string;
-      readonly token_type?: string;
-      readonly expires_in?: number;
-      readonly scope?: string;
-      readonly _tag?: string;
-      readonly code?: string;
-      readonly reason?: string;
-      readonly dpopFailureReason?: DpopFailureReason;
-      readonly traceId?: string;
-    }>(response);
-    return {
-      response,
-      body,
-    };
-  });
-
-const makeDpopProof = (input: {
-  readonly method: string;
-  readonly url: string;
-  readonly iat: number;
-  readonly accessToken?: string;
-  readonly jti?: string;
-  readonly privateKey?: NodeCrypto.KeyObject;
-  readonly publicJwk?: DpopPublicJwk;
-}) => {
-  const keyPair =
-    input.privateKey && input.publicJwk
-      ? { privateKey: input.privateKey, publicJwk: input.publicJwk }
-      : (() => {
-          const { privateKey, publicKey } = NodeCrypto.generateKeyPairSync("ec", {
-            namedCurve: "P-256",
-          });
-          return { privateKey, publicJwk: publicKey.export({ format: "jwk" }) as DpopPublicJwk };
-        })();
-  const header = Buffer.from(
-    JSON.stringify({
-      typ: "dpop+jwt",
-      alg: "ES256",
-      jwk: keyPair.publicJwk,
-    }),
-  ).toString("base64url");
-  const payload = Buffer.from(
-    JSON.stringify({
-      htm: input.method,
-      htu: input.url,
-      jti: input.jti ?? "proof-1",
-      iat: input.iat,
-      ...(input.accessToken ? { ath: computeDpopAccessTokenHash(input.accessToken) } : {}),
-    }),
-  ).toString("base64url");
-  const signature = NodeCrypto.sign("sha256", Buffer.from(`${header}.${payload}`), {
-    key: keyPair.privateKey,
-    dsaEncoding: "ieee-p1363",
-  }).toString("base64url");
-  return {
-    proof: `${header}.${payload}.${signature}`,
-    thumbprint: computeDpopJwkThumbprint(keyPair.publicJwk),
-    privateKey: keyPair.privateKey,
-    publicJwk: keyPair.publicJwk,
-  };
-};
-
-const makeCloudMintCredentialRequest = (input: {
-  readonly privateKey: string;
-  readonly environmentId: EnvironmentId;
-  readonly clientProofKeyThumbprint: string;
-  readonly issuer?: string;
-  readonly audience?: string;
-  readonly subject?: string;
-  readonly jti?: string;
-  readonly nonce: string;
-  readonly issuedAt: string;
-  readonly expiresAt: string;
-  readonly scope?: ReadonlyArray<"environment:connect">;
-}) => {
-  const payload = {
-    iss: input.issuer ?? "https://relay.example.test",
-    aud: input.audience ?? `t3-env:${input.environmentId}`,
-    sub: input.subject ?? "user_123",
-    jti: input.jti ?? "cloud-mint-jti-1",
-    environmentId: input.environmentId,
-    clientProofKeyThumbprint: input.clientProofKeyThumbprint,
-    cnf: {
-      jkt: input.clientProofKeyThumbprint,
-    },
-    nonce: input.nonce,
-    iat: Math.floor(DateTime.makeUnsafe(input.issuedAt).epochMilliseconds / 1_000),
-    exp: Math.floor(DateTime.makeUnsafe(input.expiresAt).epochMilliseconds / 1_000),
-    scope: input.scope ?? ["environment:connect"],
-  } as const;
-  const header = Buffer.from(
-    JSON.stringify({ alg: "EdDSA", typ: RELAY_MINT_REQUEST_TYP }),
-  ).toString("base64url");
-  const encodedPayload = Buffer.from(JSON.stringify(payload)).toString("base64url");
-  const signingInput = `${header}.${encodedPayload}`;
-  return {
-    proof: `${signingInput}.${NodeCrypto.sign(null, Buffer.from(signingInput), input.privateKey).toString("base64url")}`,
-  };
-};
-
-const makeCloudEnvironmentHealthRequest = (input: {
-  readonly privateKey: string;
-  readonly environmentId: EnvironmentId;
-  readonly issuer?: string;
-  readonly audience?: string;
-  readonly subject?: string;
-  readonly jti?: string;
-  readonly nonce: string;
-  readonly issuedAt: string;
-  readonly expiresAt: string;
-  readonly scope?: ReadonlyArray<"environment:status">;
-}) => {
-  const payload = {
-    iss: input.issuer ?? "https://relay.example.test",
-    aud: input.audience ?? `t3-env:${input.environmentId}`,
-    sub: input.subject ?? "user_123",
-    jti: input.jti ?? "cloud-health-jti-1",
-    environmentId: input.environmentId,
-    nonce: input.nonce,
-    iat: Math.floor(DateTime.makeUnsafe(input.issuedAt).epochMilliseconds / 1_000),
-    exp: Math.floor(DateTime.makeUnsafe(input.expiresAt).epochMilliseconds / 1_000),
-    scope: input.scope ?? ["environment:status"],
-  } as const;
-  const header = Buffer.from(
-    JSON.stringify({ alg: "EdDSA", typ: RELAY_HEALTH_REQUEST_TYP }),
-  ).toString("base64url");
-  const encodedPayload = Buffer.from(JSON.stringify(payload)).toString("base64url");
-  const signingInput = `${header}.${encodedPayload}`;
-  return {
-    proof: `${signingInput}.${NodeCrypto.sign(null, Buffer.from(signingInput), input.privateKey).toString("base64url")}`,
-  };
-};
-
-const decodeCompactJwtPayload = <A>(token: string): A => {
-  const encodedPayload = token.split(".")[1];
-  if (!encodedPayload) {
-    throw new Error("JWT does not contain a payload.");
-  }
-  return JSON.parse(Buffer.from(encodedPayload, "base64url").toString("utf8")) as A;
-};
-
-class AuthenticationGetterError extends Data.TaggedError("AuthenticationGetterError")<{
-  readonly message: string;
-}> {}
-
-class TestHttpRequestError extends Data.TaggedError("TestHttpRequestError")<{
-  readonly cause: unknown;
-}> {}
-
-const testRequestUrl = (input: Parameters<typeof fetch>[0]): string => {
-  const value = input.toString();
-  if (!/^https?:\/\//i.test(value)) {
-    return value;
-  }
-  const url = new URL(value);
-  return `${url.pathname}${url.search}`;
-};
-
-const fetchEffect = (input: Parameters<typeof fetch>[0], init?: RequestInit) => {
-  const request = HttpClientRequest.make((init?.method ?? "GET") as "GET" | "POST")(
-    testRequestUrl(input),
-    {
-      headers: init?.headers as Record<string, string> | undefined,
-    },
-  ).pipe(
-    typeof init?.body === "string"
-      ? HttpClientRequest.bodyText(
-          init.body,
-          (init.headers as Record<string, string> | undefined)?.["content-type"] ??
-            "application/json",
-        )
-      : (request) => request,
-  );
-  const effect = HttpClient.execute(request);
-  return (
-    init?.redirect === "manual"
-      ? effect.pipe(Effect.provideService(FetchHttpClient.RequestInit, { redirect: "manual" }))
-      : effect
-  ).pipe(Effect.mapError((cause) => new TestHttpRequestError({ cause })));
-};
-
-const jsonRequestBody = (value: unknown): string => {
-  return JSON.stringify(value);
-};
-
-const responseJsonEffect = <A>(response: HttpClientResponse.HttpClientResponse) =>
-  response.json.pipe(
-    Effect.map((json) => json as A),
-    Effect.mapError((cause) => new TestHttpRequestError({ cause })),
-  );
-
-const responseOk = (response: HttpClientResponse.HttpClientResponse) =>
-  response.status >= 200 && response.status < 300;
-
-const getAuthenticatedSessionCookieHeader = (credential = defaultDesktopBootstrapToken) =>
-  Effect.gen(function* () {
-    const { response, cookie } = yield* bootstrapBrowserSession(credential);
-    if (!responseOk(response)) {
-      return yield* new AuthenticationGetterError({
-        message: `Expected bootstrap session response to succeed, got ${response.status}`,
-      });
-    }
-
-    if (!cookie) {
-      return yield* new AuthenticationGetterError({
-        message: "Expected bootstrap session response to set a cookie.",
-      });
-    }
-
-    return cookie.split(";")[0] ?? cookie;
-  });
-
-const getAuthenticatedBearerSessionToken = (credential = defaultDesktopBootstrapToken) =>
-  Effect.gen(function* () {
-    const { response, body } = yield* exchangeAccessToken(credential);
-    if (!responseOk(response)) {
-      return yield* new AuthenticationGetterError({
-        message: `Expected bearer bootstrap response to succeed, got ${response.status}`,
-      });
-    }
-
-    if (!body.access_token) {
-      return yield* new AuthenticationGetterError({
-        message: "Expected token exchange response to include an access token.",
-      });
-    }
-
-    return body.access_token;
-  });
-
-const extractSessionTokenFromSetCookie = (cookieHeader: string): string => {
-  const [nameValue] = cookieHeader.split(";", 1);
-  const token = nameValue?.split("=", 2)[1];
-  if (!token) {
-    throw new Error("Expected session cookie header to contain a token value.");
-  }
-  return token;
-};
-
-const splitHeaderTokens = (value: string | null | undefined) =>
-  (value ?? "")
-    .split(",")
-    .map((token) => token.trim())
-    .filter((token) => token.length > 0)
-    .toSorted();
-
-const assertBrowserApiCorsResponseHeaders = (
-  headers: Readonly<Record<string, string | undefined>>,
-  options?: {
-    readonly origin?: string;
-    readonly credentials?: boolean;
-  },
-) => {
-  assert.equal(headers["access-control-allow-origin"], options?.origin ?? "*");
-  assert.equal(
-    headers["access-control-allow-credentials"],
-    options?.credentials ? "true" : undefined,
-  );
-};
-
-const assertBrowserApiCorsPreflightHeaders = (
-  headers: Readonly<Record<string, string | undefined>>,
-  options?: {
-    readonly origin?: string;
-    readonly credentials?: boolean;
-  },
-) => {
-  assertBrowserApiCorsResponseHeaders(headers, options);
-  assert.deepEqual(splitHeaderTokens(headers["access-control-allow-methods"] ?? null), [
-    "GET",
-    "OPTIONS",
-    "POST",
-  ]);
-  assert.deepEqual(splitHeaderTokens(headers["access-control-allow-headers"]), [
-    "authorization",
-    "b3",
-    "content-type",
-    "dpop",
-    "traceparent",
-  ]);
-};
-const crossOriginClientOrigin = "http://remote-client.test:3773";
-
-const getWsServerUrl = (
-  pathname = "",
-  options?: { authenticated?: boolean; credential?: string },
-) =>
-  Effect.gen(function* () {
-    const server = yield* HttpServer.HttpServer;
-    const address = server.address as HttpServer.TcpAddress;
-    const baseUrl = `ws://127.0.0.1:${address.port}${pathname}`;
-    if (options?.authenticated === false) {
-      return baseUrl;
-    }
-    return appendSessionCookieToWsUrl(
-      baseUrl,
-      yield* getAuthenticatedSessionCookieHeader(options?.credential),
-    );
-  });
-
-// Mirrors NodeHttpServer.layerTest, which does not expose server options,
-// with the production `websocket: { perMessageDeflate: true }` setting.
-const NodeHttpServerTestWithWsDeflate = HttpServer.layerTestClient.pipe(
-  Layer.provide(
-    Layer.fresh(FetchHttpClient.layer).pipe(
-      Layer.provide(Layer.succeed(FetchHttpClient.RequestInit)({ keepalive: false })),
-    ),
-  ),
-  Layer.provideMerge(
-    Layer.unwrap(
-      Effect.map(
-        Effect.promise(() => import("node:http")),
-        (NodeHttp) =>
-          NodeHttpServer.layer(NodeHttp.createServer, {
-            port: 0,
-            websocket: { perMessageDeflate: true },
-          }),
-      ),
-    ),
-  ),
-);
-
-it.layer(NodeServices.layer)("server router seam", (it) => {
-  it.effect("parks HTTP ingress until command readiness", () =>
-    Effect.gen(function* () {
-      const fileSystem = yield* FileSystem.FileSystem;
-      const path = yield* Path.Path;
-      const staticDir = yield* fileSystem.makeTempDirectoryScoped({ prefix: "t3-router-gate-" });
-      yield* fileSystem.writeFileString(path.join(staticDir, "index.html"), "ready");
-      const entered = yield* Deferred.make<void>();
-      const ready = yield* Deferred.make<void>();
-      const completed = yield* Deferred.make<void>();
-
-      yield* buildAppUnderTest({
-        config: { staticDir },
-        layers: {
-          serverRuntimeStartup: {
-            awaitCommandReady: Deferred.succeed(entered, undefined).pipe(
-              Effect.andThen(Deferred.await(ready)),
-            ),
-          },
-        },
-      });
-      const request = yield* HttpClient.get("/").pipe(
-        Effect.tap(() => Deferred.succeed(completed, undefined)),
-        Effect.forkChild,
-      );
-      yield* Deferred.await(entered);
-      assert.isFalse(yield* Deferred.isDone(completed));
-
-      yield* Deferred.succeed(ready, undefined);
-      assert.equal((yield* Fiber.join(request)).status, 200);
-      assert.isTrue(yield* Deferred.isDone(completed));
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("serves static index content for GET / when staticDir is configured", () =>
-    Effect.gen(function* () {
-      const fileSystem = yield* FileSystem.FileSystem;
-      const path = yield* Path.Path;
-      const staticDir = yield* fileSystem.makeTempDirectoryScoped({ prefix: "t3-router-static-" });
-      const indexPath = path.join(staticDir, "index.html");
-      yield* fileSystem.writeFileString(indexPath, "<html>router-static-ok</html>");
-
-      yield* buildAppUnderTest({ config: { staticDir } });
-
-      const response = yield* HttpClient.get("/");
-      assert.equal(response.status, 200);
-      assert.include(yield* response.text, "router-static-ok");
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("redirects to dev URL when configured", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest({
-        config: { devUrl: new URL("http://127.0.0.1:5173") },
-      });
-
-      const url = yield* getHttpServerUrl("/foo/bar?token=test-token");
-      const response = yield* fetchEffect(url, { redirect: "manual" });
-
-      assert.equal(response.status, 302);
-      assert.equal(response.headers.location, "http://127.0.0.1:5173/foo/bar?token=test-token");
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("serves the public environment descriptor without requiring auth", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const url = yield* getHttpServerUrl("/.well-known/t3/environment");
-      const response = yield* fetchEffect(url);
-      const body = yield* responseJsonEffect<typeof testEnvironmentDescriptor>(response);
-
-      assert.equal(response.status, 200);
-      assert.deepEqual(body, testEnvironmentDescriptor);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("compresses large JSON responses through the composed routes", () =>
-    Effect.gen(function* () {
-      const descriptor = {
-        ...testEnvironmentDescriptor,
-        label: "Test environment".repeat(100),
-      };
-      yield* buildAppUnderTest({
-        layers: {
-          serverEnvironment: {
-            getDescriptor: Effect.succeed(descriptor),
-          },
-        },
-      });
-
-      const url = yield* getHttpServerUrl("/.well-known/t3/environment");
-      const response = yield* fetchEffect(url, {
-        headers: {
-          "accept-encoding": "gzip",
-        },
-      });
-      const body = yield* responseJsonEffect<typeof descriptor>(response);
-
-      assert.equal(response.status, 200);
-      assert.equal(response.headers["content-encoding"], "gzip");
-      assert.equal(response.headers.vary, "Accept-Encoding");
-      assert.deepEqual(body, descriptor);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("includes CORS headers on public environment descriptor responses", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const url = yield* getHttpServerUrl("/.well-known/t3/environment");
-      const response = yield* fetchEffect(url, {
-        headers: {
-          origin: crossOriginClientOrigin,
-        },
-      });
-      const body = yield* responseJsonEffect<typeof testEnvironmentDescriptor>(response);
-
-      assert.equal(response.status, 200);
-      assertBrowserApiCorsResponseHeaders(response.headers);
-      assert.deepEqual(body, testEnvironmentDescriptor);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("reports unauthenticated session state without requiring auth", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const url = yield* getHttpServerUrl("/api/auth/session");
-      const response = yield* fetchEffect(url);
-      const body = yield* responseJsonEffect<{
-        readonly authenticated: boolean;
-        readonly auth: {
-          readonly policy: string;
-          readonly bootstrapMethods: ReadonlyArray<string>;
-          readonly sessionMethods: ReadonlyArray<string>;
-          readonly sessionCookieName: string;
-        };
-      }>(response);
-
-      assert.equal(response.status, 200);
-      assert.equal(body.authenticated, false);
-      assert.equal(body.auth.policy, "desktop-managed-local");
-      assert.deepEqual(body.auth.bootstrapMethods, ["desktop-bootstrap"]);
-      assert.deepEqual(body.auth.sessionMethods, [
-        "browser-session-cookie",
-        "bearer-access-token",
-        "dpop-access-token",
-      ]);
-      // Desktop, so port-scoped: instances scan for a free port and share
-      // 127.0.0.1, and cookies are not scoped by port.
-      assert.isTrue(body.auth.sessionCookieName.startsWith("t3_session_"));
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("bootstraps a browser session and authenticates the session endpoint via cookie", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const {
-        response: bootstrapResponse,
-        body: bootstrapBody,
-        cookie: setCookie,
-      } = yield* bootstrapBrowserSession();
-
-      assert.equal(bootstrapResponse.status, 200);
-      assert.equal(bootstrapBody.authenticated, true);
-      assert.equal(bootstrapBody.sessionMethod, "browser-session-cookie");
-      assert.isUndefined((bootstrapBody as { readonly sessionToken?: string }).sessionToken);
-      assert.isDefined(setCookie);
-
-      const sessionUrl = yield* getHttpServerUrl("/api/auth/session");
-      const sessionResponse = yield* fetchEffect(sessionUrl, {
-        headers: {
-          cookie: setCookie?.split(";")[0] ?? "",
-        },
-      });
-      const sessionBody = yield* responseJsonEffect<{
-        readonly authenticated: boolean;
-        readonly sessionMethod?: string;
-      }>(sessionResponse);
-
-      assert.equal(sessionResponse.status, 200);
-      assert.equal(sessionBody.authenticated, true);
-      assert.equal(sessionBody.sessionMethod, "browser-session-cookie");
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("exchanges a bootstrap grant for a scoped bearer access token", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const { response: tokenResponse, body: tokenBody } = yield* exchangeAccessToken();
-
-      assert.equal(tokenResponse.status, 200);
-      assert.equal(tokenBody.issued_token_type, AuthAccessTokenType);
-      assert.equal(tokenBody.token_type, "Bearer");
-      assert.equal(
-        tokenBody.scope,
-        "orchestration:read orchestration:operate terminal:operate review:write relay:read access:read access:write relay:write",
-      );
-      assert.equal(typeof tokenBody.access_token, "string");
-
-      const sessionUrl = yield* getHttpServerUrl("/api/auth/session");
-      const sessionResponse = yield* fetchEffect(sessionUrl, {
-        headers: {
-          authorization: `Bearer ${tokenBody.access_token ?? ""}`,
-        },
-      });
-      const sessionBody = yield* responseJsonEffect<{
-        readonly authenticated: boolean;
-        readonly sessionMethod?: string;
-        readonly scopes?: ReadonlyArray<string>;
-      }>(sessionResponse);
-
-      assert.equal(sessionResponse.status, 200);
-      assert.equal(sessionBody.authenticated, true);
-      assert.equal(sessionBody.sessionMethod, "bearer-access-token");
-      assert.deepEqual(sessionBody.scopes, [
-        "orchestration:read",
-        "orchestration:operate",
-        "terminal:operate",
-        "review:write",
-        "relay:read",
-        "access:read",
-        "access:write",
-        "relay:write",
-      ]);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("persists token exchange client display metadata for authorized-client listings", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest({
-        config: {
-          host: "0.0.0.0",
-        },
-      });
-
-      const ownerCookie = yield* getAuthenticatedSessionCookieHeader();
-      const pairingResponse = yield* HttpClient.post("/api/auth/pairing-token", {
-        headers: {
-          cookie: ownerCookie,
-        },
-        body: yield* HttpBody.json({}),
-      });
-      const pairingBody = (yield* pairingResponse.json) as {
-        readonly credential: string;
-      };
-
-      const { response } = yield* exchangeAccessToken(pairingBody.credential, {
-        headers: {
-          "user-agent": "undici",
-        },
-        scope: "orchestration:read orchestration:operate terminal:operate review:write",
-        clientMetadata: {
-          label: "T3 Code Mobile",
-          deviceType: "mobile",
-          os: "iOS",
-        },
-      });
-
-      const clientsResponse = yield* HttpClient.get("/api/auth/clients", {
-        headers: {
-          cookie: ownerCookie,
-        },
-      });
-      const clients = (yield* clientsResponse.json) as ReadonlyArray<{
-        readonly current: boolean;
-        readonly client: {
-          readonly label?: string;
-          readonly deviceType: string;
-          readonly ipAddress?: string;
-          readonly os?: string;
-          readonly userAgent?: string;
-        };
-      }>;
-      const mobileClient = clients.find((client) => !client.current);
-
-      assert.equal(pairingResponse.status, 200);
-      assert.equal(response.status, 200);
-      assert.equal(clientsResponse.status, 200);
-      assert.deepInclude(mobileClient?.client, {
-        label: "T3 Code Mobile",
-        deviceType: "mobile",
-        os: "iOS",
-        ipAddress: "127.0.0.1",
-        userAgent: "undici",
-      });
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect(
-    "exchanges a bootstrap credential for a DPoP-bound access token without bearer downgrade",
-    () =>
-      Effect.gen(function* () {
-        yield* buildAppUnderTest();
-
-        const ownerCookie = yield* getAuthenticatedSessionCookieHeader();
-        const credentialResponse = yield* HttpClient.post("/api/auth/pairing-token", {
-          headers: { cookie: ownerCookie },
-          body: yield* HttpBody.json({}),
-        });
-        const credential = (yield* credentialResponse.json) as { readonly credential: string };
-        const tokenUrl = yield* getHttpServerUrl("/oauth/token");
-        const now = yield* DateTime.now;
-        const tokenProof = makeDpopProof({
-          method: "POST",
-          url: tokenUrl,
-          iat: Math.floor(now.epochMilliseconds / 1_000),
-          jti: "token-exchange-proof",
-        });
-        const tokenResponse = yield* fetchEffect(tokenUrl, {
-          method: "POST",
-          headers: {
-            "content-type": "application/x-www-form-urlencoded",
-            dpop: tokenProof.proof,
-          },
-          body: new URLSearchParams({
-            grant_type: "urn:ietf:params:oauth:grant-type:token-exchange",
-            subject_token: credential.credential,
-            subject_token_type: "urn:t3:params:oauth:token-type:environment-bootstrap",
-            requested_token_type: "urn:ietf:params:oauth:token-type:access_token",
-            scope: "orchestration:read orchestration:operate terminal:operate review:write",
-          }).toString(),
-        });
-        const token = yield* responseJsonEffect<{
-          readonly access_token: string;
-          readonly token_type: string;
-        }>(tokenResponse);
-
-        assert.equal(tokenResponse.status, 200);
-        assert.equal(tokenResponse.headers["cache-control"], "no-store");
-        assert.equal(token.token_type, "DPoP");
-
-        const sessionUrl = yield* getHttpServerUrl("/api/auth/session");
-        const bearerResponse = yield* fetchEffect(sessionUrl, {
-          headers: { authorization: `Bearer ${token.access_token}` },
-        });
-        const bearerState = yield* responseJsonEffect<{ readonly authenticated: boolean }>(
-          bearerResponse,
-        );
-        assert.equal(bearerState.authenticated, false);
-
-        const sessionProof = makeDpopProof({
-          method: "GET",
-          url: sessionUrl,
-          iat: Math.floor(now.epochMilliseconds / 1_000),
-          jti: "session-proof",
-          accessToken: token.access_token,
-          privateKey: tokenProof.privateKey,
-          publicJwk: tokenProof.publicJwk,
-        });
-        const dpopResponse = yield* fetchEffect(sessionUrl, {
-          headers: {
-            authorization: `DPoP ${token.access_token}`,
-            dpop: sessionProof.proof,
-          },
-        });
-        const dpopState = yield* responseJsonEffect<{
-          readonly authenticated: boolean;
-          readonly sessionMethod?: string;
-        }>(dpopResponse);
-        assert.equal(dpopState.authenticated, true);
-        assert.equal(dpopState.sessionMethod, "dpop-access-token");
-      }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("reports clock skew for a future-dated DPoP token exchange proof", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const ownerCookie = yield* getAuthenticatedSessionCookieHeader();
-      const credentialResponse = yield* HttpClient.post("/api/auth/pairing-token", {
-        headers: { cookie: ownerCookie },
-        body: yield* HttpBody.json({}),
-      });
-      const credential = (yield* credentialResponse.json) as { readonly credential: string };
-      const tokenUrl = yield* getHttpServerUrl("/oauth/token");
-      const now = yield* DateTime.now;
-      const dpop = makeDpopProof({
-        method: "POST",
-        url: tokenUrl,
-        iat: Math.floor(now.epochMilliseconds / 1_000) + 25,
-      });
-
-      const exchange = yield* exchangeAccessToken(credential.credential, {
-        headers: { dpop: dpop.proof },
-        scope: "orchestration:read orchestration:operate terminal:operate review:write",
-      });
-
-      assert.equal(exchange.response.status, 401);
-      assert.equal(exchange.body._tag, "EnvironmentAuthInvalidError");
-      assert.equal(exchange.body.code, "auth_invalid");
-      assert.equal(exchange.body.reason, "invalid_credential");
-      assert.equal(exchange.body.dpopFailureReason, "time_window");
-      assert.equal(typeof exchange.body.traceId, "string");
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("rejects replayed DPoP proofs across token exchanges", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const ownerCookie = yield* getAuthenticatedSessionCookieHeader();
-      const firstCredentialResponse = yield* HttpClient.post("/api/auth/pairing-token", {
-        headers: {
-          cookie: ownerCookie,
-        },
-        body: yield* HttpBody.json({}),
-      });
-      const firstCredential = (yield* firstCredentialResponse.json) as {
-        readonly credential: string;
-      };
-      const secondCredentialResponse = yield* HttpClient.post("/api/auth/pairing-token", {
-        headers: {
-          cookie: ownerCookie,
-        },
-        body: yield* HttpBody.json({}),
-      });
-      const secondCredential = (yield* secondCredentialResponse.json) as {
-        readonly credential: string;
-      };
-      const tokenUrl = yield* getHttpServerUrl("/oauth/token");
-      const now = yield* DateTime.now;
-      const dpop = makeDpopProof({
-        method: "POST",
-        url: tokenUrl,
-        iat: Math.floor(now.epochMilliseconds / 1_000),
-      });
-
-      const firstBootstrap = yield* exchangeAccessToken(firstCredential.credential, {
-        headers: {
-          dpop: dpop.proof,
-        },
-        scope: "orchestration:read orchestration:operate terminal:operate review:write",
-      });
-      const replayBootstrap = yield* exchangeAccessToken(secondCredential.credential, {
-        headers: {
-          dpop: dpop.proof,
-        },
-        scope: "orchestration:read orchestration:operate terminal:operate review:write",
-      });
-
-      assert.equal(firstBootstrap.response.status, 200);
-      assert.equal(replayBootstrap.response.status, 401);
-      assert.equal(replayBootstrap.body._tag, "EnvironmentAuthInvalidError");
-      assert.equal(replayBootstrap.body.code, "auth_invalid");
-      assert.equal(replayBootstrap.body.reason, "invalid_credential");
-      assert.equal(replayBootstrap.body.dpopFailureReason, "replay");
-      assert.equal(typeof replayBootstrap.body.traceId, "string");
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("ignores forwarded host headers when validating token exchange DPoP URLs", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const ownerCookie = yield* getAuthenticatedSessionCookieHeader();
-      const credentialResponse = yield* HttpClient.post("/api/auth/pairing-token", {
-        headers: {
-          cookie: ownerCookie,
-        },
-        body: yield* HttpBody.json({}),
-      });
-      const credential = (yield* credentialResponse.json) as {
-        readonly credential: string;
-      };
-      const tokenUrl = yield* getHttpServerUrl("/oauth/token");
-      const now = yield* DateTime.now;
-      const dpop = makeDpopProof({
-        method: "POST",
-        url: tokenUrl,
-        iat: Math.floor(now.epochMilliseconds / 1_000),
-      });
-
-      const bootstrap = yield* exchangeAccessToken(credential.credential, {
-        headers: {
-          dpop: dpop.proof,
-          "x-forwarded-host": "environment.example.test",
-        },
-        scope: "orchestration:read orchestration:operate terminal:operate review:write",
-      });
-
-      assert.equal(bootstrap.response.status, 200);
-      assert.equal(bootstrap.body.token_type, "DPoP");
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("rejects token exchange DPoP proofs bound to spoofed forwarded hosts", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const ownerCookie = yield* getAuthenticatedSessionCookieHeader();
-      const credentialResponse = yield* HttpClient.post("/api/auth/pairing-token", {
-        headers: {
-          cookie: ownerCookie,
-        },
-        body: yield* HttpBody.json({}),
-      });
-      const credential = (yield* credentialResponse.json) as {
-        readonly credential: string;
-      };
-      const tokenUrl = yield* getHttpServerUrl("/oauth/token");
-      const spoofedUrl = new URL(tokenUrl);
-      spoofedUrl.hostname = "environment.example.test";
-      const now = yield* DateTime.now;
-      const dpop = makeDpopProof({
-        method: "POST",
-        url: spoofedUrl.href,
-        iat: Math.floor(now.epochMilliseconds / 1_000),
-      });
-
-      const bootstrap = yield* exchangeAccessToken(credential.credential, {
-        headers: {
-          dpop: dpop.proof,
-          "x-forwarded-host": spoofedUrl.host,
-        },
-        scope: "orchestration:read orchestration:operate terminal:operate review:write",
-      });
-
-      assert.equal(bootstrap.response.status, 401);
-      assert.equal(bootstrap.body._tag, "EnvironmentAuthInvalidError");
-      assert.equal(bootstrap.body.code, "auth_invalid");
-      assert.equal(bootstrap.body.reason, "invalid_credential");
-      assert.equal(bootstrap.body.dpopFailureReason, "request_mismatch");
-      assert.equal(typeof bootstrap.body.traceId, "string");
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("rejects cloud link proofs for non-loopback managed endpoint origins", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const ownerCookie = yield* getAuthenticatedSessionCookieHeader();
-      const linkProofUrl = yield* getHttpServerUrl("/api/connect/link-proof");
-      const linkProofResponse = yield* fetchEffect(linkProofUrl, {
-        method: "POST",
-        headers: {
-          cookie: ownerCookie,
-          "content-type": "application/json",
-        },
-        body: jsonRequestBody({
-          challenge: "relay-link-challenge",
-          relayIssuer: "https://relay.example.test",
-          endpoint: {
-            httpBaseUrl: "https://environment.example.test/",
-            wsBaseUrl: "wss://environment.example.test/ws",
-            providerKind: "manual",
-          },
-          origin: {
-            localHttpHost: "192.168.1.42",
-            localHttpPort: 3773,
-          },
-        }),
-      });
-      const body = yield* responseJsonEffect<{
-        readonly _tag?: string;
-        readonly message?: string;
-      }>(linkProofResponse);
-
-      assert.equal(linkProofResponse.status, 400);
-      assert.equal(body._tag, "EnvironmentHttpBadRequestError");
-      assert.equal(body.message, "Invalid managed endpoint origin.");
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("rejects cloud link proofs for unsupported endpoint providers", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const ownerCookie = yield* getAuthenticatedSessionCookieHeader();
-      const linkProofUrl = yield* getHttpServerUrl("/api/connect/link-proof");
-      const serverPort = Number(new URL(linkProofUrl).port);
-      const linkProofResponse = yield* fetchEffect(linkProofUrl, {
-        method: "POST",
-        headers: {
-          cookie: ownerCookie,
-          "content-type": "application/json",
-        },
-        body: jsonRequestBody({
-          challenge: "relay-link-challenge",
-          relayIssuer: "https://relay.example.test",
-          endpoint: {
-            httpBaseUrl: linkProofUrl.replace("/api/connect/link-proof", ""),
-            wsBaseUrl: linkProofUrl
-              .replace("http://", "ws://")
-              .replace("/api/connect/link-proof", "/ws"),
-            // "manual" and "cloudflare_tunnel" are supported; "t3_relay" is not.
-            providerKind: "t3_relay",
-          },
-          origin: {
-            localHttpHost: "127.0.0.1",
-            localHttpPort: serverPort,
-          },
-        }),
-      });
-      const body = yield* responseJsonEffect<{
-        readonly _tag?: string;
-        readonly message?: string;
-      }>(linkProofResponse);
-
-      assert.equal(linkProofResponse.status, 400);
-      assert.equal(body._tag, "EnvironmentHttpBadRequestError");
-      assert.equal(body.message, "Invalid managed endpoint origin.");
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("rejects cloud link proofs requested through a public managed endpoint", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const linkProofUrl = yield* getHttpServerUrl("/api/connect/link-proof");
-      const serverPort = Number(new URL(linkProofUrl).port);
-      const linkProofResponse = yield* HttpClient.post("/api/connect/link-proof", {
-        headers: {
-          cookie: yield* getAuthenticatedSessionCookieHeader(),
-          "content-type": "application/json",
-          host: "environment.example.test",
-          "x-forwarded-host": "environment.example.test",
-          "x-forwarded-proto": "https",
-        },
-        body: HttpBody.text(
-          jsonRequestBody({
-            challenge: "relay-link-challenge",
-            relayIssuer: "https://relay.example.test",
-            endpoint: {
-              httpBaseUrl: "https://environment.example.test/",
-              wsBaseUrl: "wss://environment.example.test/ws",
-              providerKind: "manual",
-            },
-            origin: {
-              localHttpHost: "127.0.0.1",
-              localHttpPort: serverPort,
-            },
-          }),
-          "application/json",
-        ),
-      });
-      const body = (yield* linkProofResponse.json) as {
-        readonly _tag?: string;
-        readonly message?: string;
-      };
-
-      assert.equal(linkProofResponse.status, 400);
-      assert.equal(body._tag, "EnvironmentHttpBadRequestError");
-      assert.equal(body.message, "Invalid managed endpoint origin.");
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect(
-    "rejects cloud link proofs when a public request spoofs loopback forwarded headers",
-    () =>
-      Effect.gen(function* () {
-        yield* buildAppUnderTest();
-
-        const linkProofUrl = yield* getHttpServerUrl("/api/connect/link-proof");
-        const serverPort = Number(new URL(linkProofUrl).port);
-        const linkProofResponse = yield* HttpClient.post("/api/connect/link-proof", {
-          headers: {
-            cookie: yield* getAuthenticatedSessionCookieHeader(),
-            "content-type": "application/json",
-            host: "environment.example.test",
-            "x-forwarded-host": `127.0.0.1:${serverPort}`,
-            "x-forwarded-proto": "http",
-          },
-          body: HttpBody.text(
-            jsonRequestBody({
-              challenge: "relay-link-challenge",
-              relayIssuer: "https://relay.example.test",
-              endpoint: {
-                httpBaseUrl: "https://environment.example.test/",
-                wsBaseUrl: "wss://environment.example.test/ws",
-                providerKind: "manual",
-              },
-              origin: {
-                localHttpHost: "127.0.0.1",
-                localHttpPort: serverPort,
-              },
-            }),
-            "application/json",
-          ),
-        });
-        const body = (yield* linkProofResponse.json) as {
-          readonly _tag?: string;
-          readonly message?: string;
-        };
-
-        assert.equal(linkProofResponse.status, 400);
-        assert.equal(body._tag, "EnvironmentHttpBadRequestError");
-        assert.equal(body.message, "Invalid managed endpoint origin.");
-      }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("rejects cloud link proofs with malformed forwarded request hosts", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const linkProofUrl = yield* getHttpServerUrl("/api/connect/link-proof");
-      const serverPort = Number(new URL(linkProofUrl).port);
-      const linkProofResponse = yield* HttpClient.post("/api/connect/link-proof", {
-        headers: {
-          cookie: yield* getAuthenticatedSessionCookieHeader(),
-          "content-type": "application/json",
-          host: "bad host",
-          "x-forwarded-host": "bad host",
-          "x-forwarded-proto": "https",
-        },
-        body: HttpBody.text(
-          jsonRequestBody({
-            challenge: "relay-link-challenge",
-            relayIssuer: "https://relay.example.test",
-            endpoint: {
-              httpBaseUrl: "https://environment.example.test/",
-              wsBaseUrl: "wss://environment.example.test/ws",
-              providerKind: "manual",
-            },
-            origin: {
-              localHttpHost: "127.0.0.1",
-              localHttpPort: serverPort,
-            },
-          }),
-          "application/json",
-        ),
-      });
-      const body = (yield* linkProofResponse.json) as {
-        readonly _tag?: string;
-        readonly message?: string;
-      };
-
-      assert.equal(linkProofResponse.status, 400);
-      assert.equal(body._tag, "EnvironmentHttpBadRequestError");
-      assert.equal(body.message, "Invalid managed endpoint origin.");
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("rejects local cloud link proofs for a different loopback port", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const ownerCookie = yield* getAuthenticatedSessionCookieHeader();
-      const linkProofUrl = yield* getHttpServerUrl("/api/connect/link-proof");
-      const serverPort = Number(new URL(linkProofUrl).port);
-      const linkProofResponse = yield* fetchEffect(linkProofUrl, {
-        method: "POST",
-        headers: {
-          cookie: ownerCookie,
-          "content-type": "application/json",
-        },
-        body: jsonRequestBody({
-          challenge: "relay-link-challenge",
-          relayIssuer: "https://relay.example.test",
-          endpoint: {
-            httpBaseUrl: "https://environment.example.test/",
-            wsBaseUrl: "wss://environment.example.test/ws",
-            providerKind: "manual",
-          },
-          origin: {
-            localHttpHost: "127.0.0.1",
-            localHttpPort: serverPort === 65_535 ? serverPort - 1 : serverPort + 1,
-          },
-        }),
-      });
-      const body = yield* responseJsonEffect<{
-        readonly _tag?: string;
-        readonly message?: string;
-      }>(linkProofResponse);
-
-      assert.equal(linkProofResponse.status, 400);
-      assert.equal(body._tag, "EnvironmentHttpBadRequestError");
-      assert.equal(body.message, "Invalid managed endpoint origin.");
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("allows standard clients to read managed relay configuration state", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const ownerCookie = yield* getAuthenticatedSessionCookieHeader();
-      const credentialResponse = yield* HttpClient.post("/api/auth/pairing-token", {
-        headers: { cookie: ownerCookie },
-        body: yield* HttpBody.json({}),
-      });
-      const credential = (yield* credentialResponse.json) as { readonly credential: string };
-      const pairedCookie = yield* getAuthenticatedSessionCookieHeader(credential.credential);
-      const linkStateUrl = yield* getHttpServerUrl("/api/connect/link-state");
-      const response = yield* fetchEffect(linkStateUrl, {
-        headers: { cookie: pairedCookie },
-      });
-      const body = yield* responseJsonEffect<{
-        readonly linked?: boolean;
-        readonly publishAgentActivity?: boolean;
-      }>(response);
-
-      assert.equal(response.status, 200);
-      assert.equal(body.linked, false);
-      assert.equal(body.publishAgentActivity, false);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect(
-    "reports relay client status and streams installation progress over environment RPC",
-    () =>
-      Effect.gen(function* () {
-        const installedRelayClient = {
-          status: "available" as const,
-          executablePath: "/tmp/t3/tools/cloudflared",
-          source: "managed" as const,
-          version: RelayClient.CLOUDFLARED_VERSION,
-        };
-        yield* buildAppUnderTest({
-          layers: {
-            relayClient: {
-              resolve: Effect.succeed({
-                status: "missing",
-                version: RelayClient.CLOUDFLARED_VERSION,
-              }),
-              install: Effect.succeed(installedRelayClient),
-              installWithProgress: (report) =>
-                report({ type: "progress", stage: "checking" }).pipe(
-                  Effect.andThen(report({ type: "progress", stage: "downloading" })),
-                  Effect.as(installedRelayClient),
-                ),
-            },
-          },
-        });
-
-        const wsUrl = yield* getWsServerUrl("/ws");
-        const status = yield* Effect.scoped(
-          withWsRpcClient(wsUrl, (client) => client[WS_METHODS.cloudGetRelayClientStatus]({})),
-        );
-        const installEvents = yield* Effect.scoped(
-          withWsRpcClient(wsUrl, (client) =>
-            client[WS_METHODS.cloudInstallRelayClient]({}).pipe(Stream.runCollect),
-          ),
-        );
-
-        assert.equal(status.status, "missing");
-        assert.deepEqual(Array.from(installEvents), [
-          { type: "progress", stage: "checking" },
-          { type: "progress", stage: "downloading" },
-          { type: "complete", status: installedRelayClient },
-        ]);
-      }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("requires relay write scope to update agent activity publication", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const ownerCookie = yield* getAuthenticatedSessionCookieHeader();
-      const preferencesUrl = yield* getHttpServerUrl("/api/connect/preferences");
-      const ownerResponse = yield* fetchEffect(preferencesUrl, {
-        method: "POST",
-        headers: {
-          cookie: ownerCookie,
-          "content-type": "application/json",
-        },
-        body: jsonRequestBody({ publishAgentActivity: true }),
-      });
-      const ownerBody = yield* responseJsonEffect<{
-        readonly publishAgentActivity?: boolean;
-      }>(ownerResponse);
-      assert.equal(ownerResponse.status, 200);
-      assert.equal(ownerBody.publishAgentActivity, true);
-
-      const credentialResponse = yield* HttpClient.post("/api/auth/pairing-token", {
-        headers: { cookie: ownerCookie },
-        body: yield* HttpBody.json({}),
-      });
-      const credential = (yield* credentialResponse.json) as { readonly credential: string };
-      const pairedCookie = yield* getAuthenticatedSessionCookieHeader(credential.credential);
-      const pairedResponse = yield* fetchEffect(preferencesUrl, {
-        method: "POST",
-        headers: {
-          cookie: pairedCookie,
-          "content-type": "application/json",
-        },
-        body: jsonRequestBody({ publishAgentActivity: false }),
-      });
-      const pairedBody = yield* responseJsonEffect<{
-        readonly _tag?: string;
-        readonly requiredScope?: string;
-      }>(pairedResponse);
-      assert.equal(pairedResponse.status, 403);
-      assert.equal(pairedBody._tag, "EnvironmentScopeRequiredError");
-      assert.equal(pairedBody.requiredScope, "relay:write");
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("rejects relay config with an invalid cloud mint public key", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const ownerCookie = yield* getAuthenticatedSessionCookieHeader();
-      const relayConfigUrl = yield* getHttpServerUrl("/api/connect/relay-config");
-      const relayConfigResponse = yield* fetchEffect(relayConfigUrl, {
-        method: "POST",
-        headers: {
-          cookie: ownerCookie,
-          "content-type": "application/json",
-        },
-        body: jsonRequestBody({
-          relayUrl: "https://relay.example.test",
-          cloudUserId: "user_123",
-          environmentCredential: "t3env_test_credential",
-          cloudMintPublicKey: "not-a-public-key",
-          endpointRuntime: null,
-        }),
-      });
-      const body = yield* responseJsonEffect<{
-        readonly _tag?: string;
-        readonly message?: string;
-      }>(relayConfigResponse);
-
-      assert.equal(relayConfigResponse.status, 400);
-      assert.equal(body._tag, "EnvironmentHttpBadRequestError");
-      assert.equal(body.message, "Cloud mint public key must be a valid Ed25519 public key.");
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("rejects relay config with insecure relay metadata or empty credentials", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const cloudKeyPair = NodeCrypto.generateKeyPairSync("ed25519", {
-        privateKeyEncoding: { format: "pem", type: "pkcs8" },
-        publicKeyEncoding: { format: "pem", type: "spki" },
-      });
-      const ownerCookie = yield* getAuthenticatedSessionCookieHeader();
-      const relayConfigUrl = yield* getHttpServerUrl("/api/connect/relay-config");
-      const postRelayConfig = (body: {
-        readonly relayUrl: string;
-        readonly relayIssuer?: string;
-        readonly cloudUserId: string;
-        readonly environmentCredential: string;
-      }) =>
-        fetchEffect(relayConfigUrl, {
-          method: "POST",
-          headers: {
-            cookie: ownerCookie,
-            "content-type": "application/json",
-          },
-          body: jsonRequestBody({
-            ...body,
-            cloudMintPublicKey: cloudKeyPair.publicKey,
-            endpointRuntime: null,
-          }),
-        });
-
-      const insecureRelayUrl = yield* postRelayConfig({
-        relayUrl: "http://relay.example.test",
-        cloudUserId: "user_123",
-        environmentCredential: "t3env_test_credential",
-      });
-      const insecureRelayIssuer = yield* postRelayConfig({
-        relayUrl: "https://relay.example.test",
-        cloudUserId: "user_123",
-        relayIssuer: "http://relay.example.test",
-        environmentCredential: "t3env_test_credential",
-      });
-      const nonOriginRelayUrl = yield* postRelayConfig({
-        relayUrl: "https://relay.example.test/path",
-        cloudUserId: "user_123",
-        environmentCredential: "t3env_test_credential",
-      });
-      const emptyCredential = yield* postRelayConfig({
-        relayUrl: "https://relay.example.test",
-        cloudUserId: "user_123",
-        environmentCredential: "   ",
-      });
-      const insecureRelayUrlBody = yield* responseJsonEffect<{ readonly message?: string }>(
-        insecureRelayUrl,
-      );
-      const insecureRelayIssuerBody = yield* responseJsonEffect<{ readonly message?: string }>(
-        insecureRelayIssuer,
-      );
-      const nonOriginRelayUrlBody = yield* responseJsonEffect<{ readonly message?: string }>(
-        nonOriginRelayUrl,
-      );
-      const emptyCredentialBody = yield* responseJsonEffect<{ readonly message?: string }>(
-        emptyCredential,
-      );
-
-      assert.equal(insecureRelayUrl.status, 400);
-      assert.equal(insecureRelayUrlBody.message, "Relay URL must be a secure absolute HTTPS URL.");
-      assert.equal(insecureRelayIssuer.status, 400);
-      assert.equal(
-        insecureRelayIssuerBody.message,
-        "Relay issuer must be a secure absolute HTTPS URL.",
-      );
-      assert.equal(nonOriginRelayUrl.status, 400);
-      assert.equal(nonOriginRelayUrlBody.message, "Relay URL must be a secure absolute HTTPS URL.");
-      assert.equal(emptyCredential.status, 400);
-      assert.equal(emptyCredentialBody.message, "Relay environment credential is required.");
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("rejects relay config replacement from a different cloud account", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const cloudKeyPair = NodeCrypto.generateKeyPairSync("ed25519", {
-        privateKeyEncoding: { format: "pem", type: "pkcs8" },
-        publicKeyEncoding: { format: "pem", type: "spki" },
-      });
-      const ownerCookie = yield* getAuthenticatedSessionCookieHeader();
-      const relayConfigUrl = yield* getHttpServerUrl("/api/connect/relay-config");
-      const postRelayConfig = (cloudUserId: string, environmentCredential: string) =>
-        fetchEffect(relayConfigUrl, {
-          method: "POST",
-          headers: {
-            cookie: ownerCookie,
-            "content-type": "application/json",
-          },
-          body: jsonRequestBody({
-            relayUrl: "https://relay.example.test",
-            cloudUserId,
-            environmentCredential,
-            cloudMintPublicKey: cloudKeyPair.publicKey,
-            endpointRuntime: null,
-          }),
-        });
-
-      const firstResponse = yield* postRelayConfig("user_123", "t3env_first_credential");
-      const replacementResponse = yield* postRelayConfig("user_456", "t3env_second_credential");
-      const replacementBody = yield* responseJsonEffect<{
-        readonly _tag?: string;
-        readonly message?: string;
-      }>(replacementResponse);
-
-      assert.equal(firstResponse.status, 200);
-      assert.equal(replacementResponse.status, 409);
-      assert.equal(replacementBody._tag, "EnvironmentHttpConflictError");
-      assert.equal(
-        replacementBody.message,
-        "This environment is already linked to a different cloud account. Unlink it before switching accounts.",
-      );
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("reports local cloud link state from persisted relay config", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const cloudKeyPair = NodeCrypto.generateKeyPairSync("ed25519", {
-        privateKeyEncoding: { format: "pem", type: "pkcs8" },
-        publicKeyEncoding: { format: "pem", type: "spki" },
-      });
-      const ownerCookie = yield* getAuthenticatedSessionCookieHeader();
-      const linkStateUrl = yield* getHttpServerUrl("/api/connect/link-state");
-      const relayConfigUrl = yield* getHttpServerUrl("/api/connect/relay-config");
-
-      const initialResponse = yield* fetchEffect(linkStateUrl, {
-        headers: {
-          cookie: ownerCookie,
-        },
-      });
-      const initialBody = yield* responseJsonEffect<{
-        readonly linked?: boolean;
-        readonly cloudUserId?: string | null;
-      }>(initialResponse);
-      assert.equal(initialResponse.status, 200);
-      assert.equal(initialBody.linked, false);
-      assert.equal(initialBody.cloudUserId, null);
-
-      const relayConfigResponse = yield* fetchEffect(relayConfigUrl, {
-        method: "POST",
-        headers: {
-          cookie: ownerCookie,
-          "content-type": "application/json",
-        },
-        body: jsonRequestBody({
-          relayUrl: "https://transport.example.test",
-          relayIssuer: "https://relay.example.test",
-          cloudUserId: "user_123",
-          environmentCredential: "t3env_test_credential",
-          cloudMintPublicKey: cloudKeyPair.publicKey,
-          endpointRuntime: null,
-        }),
-      });
-      assert.equal(relayConfigResponse.status, 200);
-
-      const linkedResponse = yield* fetchEffect(linkStateUrl, {
-        headers: {
-          cookie: ownerCookie,
-        },
-      });
-      const linkedBody = yield* responseJsonEffect<{
-        readonly linked?: boolean;
-        readonly cloudUserId?: string | null;
-        readonly relayUrl?: string | null;
-        readonly relayIssuer?: string | null;
-      }>(linkedResponse);
-
-      assert.equal(linkedResponse.status, 200);
-      assert.equal(linkedBody.linked, true);
-      assert.equal(linkedBody.cloudUserId, "user_123");
-      assert.equal(linkedBody.relayUrl, "https://transport.example.test");
-      assert.equal(linkedBody.relayIssuer, "https://relay.example.test");
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("does not expose internal cloud reconciliation over HTTP", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const reconcileUrl = yield* getHttpServerUrl("/api/connect/reconcile");
-      const response = yield* fetchEffect(reconcileUrl, {
-        method: "POST",
-      });
-
-      assert.equal(response.status, 404);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("unlinks local cloud state and disables the managed endpoint runtime", () =>
-    Effect.gen(function* () {
-      const appliedRuntimeConfigs: Array<unknown> = [];
-      yield* buildAppUnderTest({
-        layers: {
-          cloudManagedEndpointRuntime: {
-            applyConfig: (config) => {
-              appliedRuntimeConfigs.push(config);
-              if (!config) {
-                return Effect.succeed({ status: "disabled" });
-              }
-              return Effect.succeed({
-                status: "running",
-                providerKind: "cloudflare_tunnel",
-                pid: 123,
-                ...(config.tunnelId ? { tunnelId: config.tunnelId } : {}),
-                ...(config.tunnelName ? { tunnelName: config.tunnelName } : {}),
-              });
-            },
-          },
-        },
-      });
-
-      const cloudKeyPair = NodeCrypto.generateKeyPairSync("ed25519", {
-        privateKeyEncoding: { format: "pem", type: "pkcs8" },
-        publicKeyEncoding: { format: "pem", type: "spki" },
-      });
-      const ownerCookie = yield* getAuthenticatedSessionCookieHeader();
-      const relayConfigUrl = yield* getHttpServerUrl("/api/connect/relay-config");
-      const unlinkUrl = yield* getHttpServerUrl("/api/connect/unlink");
-      const linkStateUrl = yield* getHttpServerUrl("/api/connect/link-state");
-
-      const relayConfigResponse = yield* fetchEffect(relayConfigUrl, {
-        method: "POST",
-        headers: {
-          cookie: ownerCookie,
-          "content-type": "application/json",
-        },
-        body: jsonRequestBody({
-          relayUrl: "https://transport.example.test",
-          relayIssuer: "https://relay.example.test",
-          cloudUserId: "user_123",
-          environmentCredential: "t3env_test_credential",
-          cloudMintPublicKey: cloudKeyPair.publicKey,
-          endpointRuntime: {
-            providerKind: "cloudflare_tunnel",
-            connectorToken: "connector-token",
-            tunnelId: "tunnel-id",
-            tunnelName: "tunnel-name",
-          },
-        }),
-      });
-      assert.equal(relayConfigResponse.status, 200);
-
-      const unlinkResponse = yield* fetchEffect(unlinkUrl, {
-        method: "POST",
-        headers: {
-          cookie: ownerCookie,
-        },
-      });
-      const unlinkBody = yield* responseJsonEffect<{
-        readonly ok?: boolean;
-        readonly endpointRuntimeStatus?: { readonly status?: string };
-      }>(unlinkResponse);
-      assert.equal(unlinkResponse.status, 200);
-      assert.equal(unlinkBody.ok, true);
-      assert.equal(unlinkBody.endpointRuntimeStatus?.status, "disabled");
-
-      const linkStateResponse = yield* fetchEffect(linkStateUrl, {
-        headers: {
-          cookie: ownerCookie,
-        },
-      });
-      const linkStateBody = yield* responseJsonEffect<{
-        readonly linked?: boolean;
-        readonly cloudUserId?: string | null;
-        readonly relayUrl?: string | null;
-        readonly relayIssuer?: string | null;
-      }>(linkStateResponse);
-      assert.equal(linkStateResponse.status, 200);
-      assert.equal(linkStateBody.linked, false);
-      assert.equal(linkStateBody.cloudUserId, null);
-      assert.equal(linkStateBody.relayUrl, null);
-      assert.equal(linkStateBody.relayIssuer, null);
-      assert.deepEqual(appliedRuntimeConfigs, [
-        {
-          providerKind: "cloudflare_tunnel",
-          connectorToken: "connector-token",
-          tunnelId: "tunnel-id",
-          tunnelName: "tunnel-name",
-        },
-        null,
-      ]);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("rejects replayed cloud mint requests atomically", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const cloudKeyPair = NodeCrypto.generateKeyPairSync("ed25519", {
-        privateKeyEncoding: { format: "pem", type: "pkcs8" },
-        publicKeyEncoding: { format: "pem", type: "spki" },
-      });
-      const ownerCookie = yield* getAuthenticatedSessionCookieHeader();
-      const relayConfigUrl = yield* getHttpServerUrl("/api/connect/relay-config");
-      const relayConfigResponse = yield* fetchEffect(relayConfigUrl, {
-        method: "POST",
-        headers: {
-          cookie: ownerCookie,
-          "content-type": "application/json",
-        },
-        body: jsonRequestBody({
-          relayUrl: "https://relay.example.test",
-          cloudUserId: "user_123",
-          environmentCredential: "t3env_test_credential",
-          cloudMintPublicKey: cloudKeyPair.publicKey,
-          endpointRuntime: null,
-        }),
-      });
-      assert.equal(relayConfigResponse.status, 200);
-
-      const now = yield* DateTime.now;
-      const request = makeCloudMintCredentialRequest({
-        privateKey: cloudKeyPair.privateKey,
-        environmentId: testEnvironmentDescriptor.environmentId,
-        clientProofKeyThumbprint: "client-proof-key-thumbprint",
-        nonce: "cloud-mint-nonce-1",
-        issuedAt: DateTime.formatIso(now),
-        expiresAt: DateTime.formatIso(DateTime.add(now, { minutes: 5 })),
-      });
-      const mintUrl = yield* getHttpServerUrl("/api/connect/mint-credential");
-      const postMint = () =>
-        fetchEffect(mintUrl, {
-          method: "POST",
-          headers: {
-            "content-type": "application/json",
-          },
-          body: jsonRequestBody(request),
-        });
-
-      const firstResponse = yield* postMint();
-      const replayResponse = yield* postMint();
-      const replayBody = yield* responseJsonEffect<{
-        readonly _tag?: string;
-        readonly message?: string;
-      }>(replayResponse);
-
-      assert.equal(firstResponse.status, 200);
-      assert.equal(replayResponse.status, 409);
-      assert.equal(replayBody._tag, "EnvironmentHttpConflictError");
-      assert.equal(replayBody.message, "Cloud mint request was already consumed.");
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("serves the documented T3 Connect mint credential endpoint", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const cloudKeyPair = NodeCrypto.generateKeyPairSync("ed25519", {
-        privateKeyEncoding: { format: "pem", type: "pkcs8" },
-        publicKeyEncoding: { format: "pem", type: "spki" },
-      });
-      const ownerCookie = yield* getAuthenticatedSessionCookieHeader();
-      const relayConfigUrl = yield* getHttpServerUrl("/api/connect/relay-config");
-      const relayConfigResponse = yield* fetchEffect(relayConfigUrl, {
-        method: "POST",
-        headers: {
-          cookie: ownerCookie,
-          "content-type": "application/json",
-        },
-        body: jsonRequestBody({
-          relayUrl: "https://relay.example.test",
-          cloudUserId: "user_123",
-          environmentCredential: "t3env_test_credential",
-          cloudMintPublicKey: cloudKeyPair.publicKey,
-          endpointRuntime: null,
-        }),
-      });
-      assert.equal(relayConfigResponse.status, 200);
-
-      const now = yield* DateTime.now;
-      const request = makeCloudMintCredentialRequest({
-        privateKey: cloudKeyPair.privateKey,
-        environmentId: testEnvironmentDescriptor.environmentId,
-        clientProofKeyThumbprint: "client-proof-key-thumbprint",
-        jti: "cloud-mint-jti-documented-endpoint",
-        nonce: "cloud-mint-nonce-documented-endpoint",
-        issuedAt: DateTime.formatIso(now),
-        expiresAt: DateTime.formatIso(DateTime.add(now, { minutes: 5 })),
-      });
-      const mintUrl = yield* getHttpServerUrl("/api/t3-connect/mint-credential");
-      const response = yield* fetchEffect(mintUrl, {
-        method: "POST",
-        headers: {
-          "content-type": "application/json",
-        },
-        body: jsonRequestBody(request),
-      });
-
-      assert.equal(response.status, 200);
-      const body = yield* responseJsonEffect<{
-        readonly credential?: string;
-        readonly proof?: string;
-      }>(response);
-      assert.equal(typeof body.credential, "string");
-      assert.equal(typeof body.proof, "string");
-      assert.equal(
-        decodeCompactJwtPayload<{ readonly requestNonce?: string }>(body.proof!).requestNonce,
-        "cloud-mint-nonce-documented-endpoint",
-      );
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("serves signed T3 Connect environment health checks", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const cloudKeyPair = NodeCrypto.generateKeyPairSync("ed25519", {
-        privateKeyEncoding: { format: "pem", type: "pkcs8" },
-        publicKeyEncoding: { format: "pem", type: "spki" },
-      });
-      const ownerCookie = yield* getAuthenticatedSessionCookieHeader();
-      const relayConfigUrl = yield* getHttpServerUrl("/api/connect/relay-config");
-      const relayConfigResponse = yield* fetchEffect(relayConfigUrl, {
-        method: "POST",
-        headers: {
-          cookie: ownerCookie,
-          "content-type": "application/json",
-        },
-        body: jsonRequestBody({
-          relayUrl: "https://relay.example.test",
-          cloudUserId: "user_123",
-          environmentCredential: "t3env_test_credential",
-          cloudMintPublicKey: cloudKeyPair.publicKey,
-          endpointRuntime: null,
-        }),
-      });
-      assert.equal(relayConfigResponse.status, 200);
-
-      const now = yield* DateTime.now;
-      const request = makeCloudEnvironmentHealthRequest({
-        privateKey: cloudKeyPair.privateKey,
-        environmentId: testEnvironmentDescriptor.environmentId,
-        jti: "cloud-health-jti-documented-endpoint",
-        nonce: "cloud-health-nonce-documented-endpoint",
-        issuedAt: DateTime.formatIso(now),
-        expiresAt: DateTime.formatIso(DateTime.add(now, { minutes: 5 })),
-      });
-      const healthUrl = yield* getHttpServerUrl("/api/t3-connect/health");
-      const response = yield* fetchEffect(healthUrl, {
-        method: "POST",
-        headers: {
-          "content-type": "application/json",
-        },
-        body: jsonRequestBody(request),
-      });
-
-      assert.equal(response.status, 200);
-      const body = yield* responseJsonEffect<{
-        readonly status?: string;
-        readonly descriptor?: { readonly environmentId?: string };
-        readonly proof?: string;
-      }>(response);
-      assert.equal(body.status, "online");
-      assert.equal(body.descriptor?.environmentId, testEnvironmentDescriptor.environmentId);
-      assert.equal(typeof body.proof, "string");
-      assert.equal(
-        decodeCompactJwtPayload<{ readonly requestNonce?: string }>(body.proof!).requestNonce,
-        "cloud-health-nonce-documented-endpoint",
-      );
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("rejects replayed cloud health requests atomically", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const cloudKeyPair = NodeCrypto.generateKeyPairSync("ed25519", {
-        privateKeyEncoding: { format: "pem", type: "pkcs8" },
-        publicKeyEncoding: { format: "pem", type: "spki" },
-      });
-      const ownerCookie = yield* getAuthenticatedSessionCookieHeader();
-      const relayConfigUrl = yield* getHttpServerUrl("/api/connect/relay-config");
-      const relayConfigResponse = yield* fetchEffect(relayConfigUrl, {
-        method: "POST",
-        headers: {
-          cookie: ownerCookie,
-          "content-type": "application/json",
-        },
-        body: jsonRequestBody({
-          relayUrl: "https://relay.example.test",
-          cloudUserId: "user_123",
-          environmentCredential: "t3env_test_credential",
-          cloudMintPublicKey: cloudKeyPair.publicKey,
-          endpointRuntime: null,
-        }),
-      });
-      assert.equal(relayConfigResponse.status, 200);
-
-      const now = yield* DateTime.now;
-      const request = makeCloudEnvironmentHealthRequest({
-        privateKey: cloudKeyPair.privateKey,
-        environmentId: testEnvironmentDescriptor.environmentId,
-        jti: "cloud-health-jti-replay",
-        nonce: "cloud-health-nonce-replay",
-        issuedAt: DateTime.formatIso(now),
-        expiresAt: DateTime.formatIso(DateTime.add(now, { minutes: 5 })),
-      });
-      const healthUrl = yield* getHttpServerUrl("/api/t3-connect/health");
-      const postHealth = () =>
-        fetchEffect(healthUrl, {
-          method: "POST",
-          headers: {
-            "content-type": "application/json",
-          },
-          body: jsonRequestBody(request),
-        });
-
-      const firstResponse = yield* postHealth();
-      const replayResponse = yield* postHealth();
-      const replayBody = yield* responseJsonEffect<{
-        readonly _tag?: string;
-        readonly message?: string;
-      }>(replayResponse);
-
-      assert.equal(firstResponse.status, 200);
-      assert.equal(replayResponse.status, 409);
-      assert.equal(replayBody._tag, "EnvironmentHttpConflictError");
-      assert.equal(replayBody.message, "Cloud health request was already consumed.");
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect(
-    "validates cloud proofs against the configured relay issuer, not the transport URL",
-    () =>
-      Effect.gen(function* () {
-        yield* buildAppUnderTest();
-
-        const cloudKeyPair = NodeCrypto.generateKeyPairSync("ed25519", {
-          privateKeyEncoding: { format: "pem", type: "pkcs8" },
-          publicKeyEncoding: { format: "pem", type: "spki" },
-        });
-        const ownerCookie = yield* getAuthenticatedSessionCookieHeader();
-        const relayConfigUrl = yield* getHttpServerUrl("/api/connect/relay-config");
-        const relayConfigResponse = yield* fetchEffect(relayConfigUrl, {
-          method: "POST",
-          headers: {
-            cookie: ownerCookie,
-            "content-type": "application/json",
-          },
-          body: jsonRequestBody({
-            relayUrl: "https://transport.example.test",
-            cloudUserId: "user_123",
-            relayIssuer: "https://relay.example.test",
-            environmentCredential: "t3env_test_credential",
-            cloudMintPublicKey: cloudKeyPair.publicKey,
-            endpointRuntime: null,
-          }),
-        });
-        assert.equal(relayConfigResponse.status, 200);
-
-        const now = yield* DateTime.now;
-        const mintUrl = yield* getHttpServerUrl("/api/t3-connect/mint-credential");
-        const postMint = (request: ReturnType<typeof makeCloudMintCredentialRequest>) =>
-          fetchEffect(mintUrl, {
-            method: "POST",
-            headers: {
-              "content-type": "application/json",
-            },
-            body: jsonRequestBody(request),
-          });
-
-        const acceptedResponse = yield* postMint(
-          makeCloudMintCredentialRequest({
-            privateKey: cloudKeyPair.privateKey,
-            environmentId: testEnvironmentDescriptor.environmentId,
-            clientProofKeyThumbprint: "client-proof-key-thumbprint",
-            issuer: "https://relay.example.test",
-            jti: "cloud-mint-jti-explicit-relay-issuer",
-            nonce: "cloud-mint-nonce-explicit-relay-issuer",
-            issuedAt: DateTime.formatIso(now),
-            expiresAt: DateTime.formatIso(DateTime.add(now, { minutes: 5 })),
-          }),
-        );
-        const rejectedResponse = yield* postMint(
-          makeCloudMintCredentialRequest({
-            privateKey: cloudKeyPair.privateKey,
-            environmentId: testEnvironmentDescriptor.environmentId,
-            clientProofKeyThumbprint: "client-proof-key-thumbprint",
-            issuer: "https://transport.example.test",
-            jti: "cloud-mint-jti-transport-url",
-            nonce: "cloud-mint-nonce-transport-url",
-            issuedAt: DateTime.formatIso(now),
-            expiresAt: DateTime.formatIso(DateTime.add(now, { minutes: 5 })),
-          }),
-        );
-
-        assert.equal(acceptedResponse.status, 200);
-        assert.equal(rejectedResponse.status, 401);
-      }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("fails relay config when the managed endpoint connector cannot start", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest({
-        layers: {
-          cloudManagedEndpointRuntime: {
-            applyConfig: () =>
-              Effect.succeed({
-                status: "failed",
-                providerKind: "cloudflare_tunnel",
-                reason: "cloudflared missing",
-                tunnelId: "tunnel-1",
-              }),
-          },
-        },
-      });
-
-      const cloudKeyPair = NodeCrypto.generateKeyPairSync("ed25519", {
-        privateKeyEncoding: { format: "pem", type: "pkcs8" },
-        publicKeyEncoding: { format: "pem", type: "spki" },
-      });
-      const ownerCookie = yield* getAuthenticatedSessionCookieHeader();
-      const relayConfigUrl = yield* getHttpServerUrl("/api/connect/relay-config");
-      const relayConfigResponse = yield* fetchEffect(relayConfigUrl, {
-        method: "POST",
-        headers: {
-          cookie: ownerCookie,
-          "content-type": "application/json",
-        },
-        body: jsonRequestBody({
-          relayUrl: "https://relay.example.test",
-          cloudUserId: "user_123",
-          environmentCredential: "t3env_test_credential",
-          cloudMintPublicKey: cloudKeyPair.publicKey,
-          endpointRuntime: {
-            providerKind: "cloudflare_tunnel",
-            connectorToken: "connector-token",
-            tunnelId: "tunnel-1",
-          },
-        }),
-      });
-
-      assert.equal(relayConfigResponse.status, 503);
-      const relayConfigBody = yield* responseJsonEffect<{
-        _tag?: string;
-        message?: string;
-        endpointRuntimeStatus?: { status?: string; reason?: string };
-      }>(relayConfigResponse);
-      assert.equal(relayConfigBody._tag, "EnvironmentCloudEndpointUnavailableError");
-      assert.equal(relayConfigBody.message, "Managed endpoint runtime could not be started.");
-      assert.equal(relayConfigBody.endpointRuntimeStatus?.status, "failed");
-      assert.equal(relayConfigBody.endpointRuntimeStatus?.reason, "cloudflared missing");
-
-      const now = yield* DateTime.now;
-      const healthRequest = makeCloudEnvironmentHealthRequest({
-        privateKey: cloudKeyPair.privateKey,
-        environmentId: testEnvironmentDescriptor.environmentId,
-        nonce: "cloud-health-after-failed-runtime",
-        issuedAt: DateTime.formatIso(now),
-        expiresAt: DateTime.formatIso(DateTime.add(now, { minutes: 5 })),
-      });
-      const healthUrl = yield* getHttpServerUrl("/api/t3-connect/health");
-      const healthResponse = yield* fetchEffect(healthUrl, {
-        method: "POST",
-        headers: {
-          "content-type": "application/json",
-        },
-        body: jsonRequestBody(healthRequest),
-      });
-      const healthBody = yield* responseJsonEffect<{
-        _tag?: string;
-        message?: string;
-      }>(healthResponse);
-      assert.equal(healthResponse.status, 500);
-      assert.equal(healthBody._tag, "EnvironmentHttpInternalServerError");
-      assert.equal(
-        healthBody.message,
-        "Cloud mint public key is not installed for this environment.",
-      );
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("rejects cloud mint requests with the wrong issuer or audience", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const cloudKeyPair = NodeCrypto.generateKeyPairSync("ed25519", {
-        privateKeyEncoding: { format: "pem", type: "pkcs8" },
-        publicKeyEncoding: { format: "pem", type: "spki" },
-      });
-      const ownerCookie = yield* getAuthenticatedSessionCookieHeader();
-      const relayConfigUrl = yield* getHttpServerUrl("/api/connect/relay-config");
-      const relayConfigResponse = yield* fetchEffect(relayConfigUrl, {
-        method: "POST",
-        headers: {
-          cookie: ownerCookie,
-          "content-type": "application/json",
-        },
-        body: jsonRequestBody({
-          relayUrl: "https://relay.example.test/",
-          cloudUserId: "user_123",
-          environmentCredential: "t3env_test_credential",
-          cloudMintPublicKey: cloudKeyPair.publicKey,
-          endpointRuntime: null,
-        }),
-      });
-      assert.equal(relayConfigResponse.status, 200);
-
-      const now = yield* DateTime.now;
-      const mintUrl = yield* getHttpServerUrl("/api/connect/mint-credential");
-      const postMint = (request: ReturnType<typeof makeCloudMintCredentialRequest>) =>
-        fetchEffect(mintUrl, {
-          method: "POST",
-          headers: {
-            "content-type": "application/json",
-          },
-          body: jsonRequestBody(request),
-        });
-
-      const wrongIssuer = yield* postMint(
-        makeCloudMintCredentialRequest({
-          privateKey: cloudKeyPair.privateKey,
-          environmentId: testEnvironmentDescriptor.environmentId,
-          clientProofKeyThumbprint: "client-proof-key-thumbprint",
-          issuer: "https://attacker.example.test",
-          jti: "cloud-mint-jti-wrong-issuer",
-          nonce: "cloud-mint-nonce-wrong-issuer",
-          issuedAt: DateTime.formatIso(now),
-          expiresAt: DateTime.formatIso(DateTime.add(now, { minutes: 5 })),
-        }),
-      );
-      const wrongAudience = yield* postMint(
-        makeCloudMintCredentialRequest({
-          privateKey: cloudKeyPair.privateKey,
-          environmentId: testEnvironmentDescriptor.environmentId,
-          clientProofKeyThumbprint: "client-proof-key-thumbprint",
-          audience: "t3-env:other-environment",
-          jti: "cloud-mint-jti-wrong-audience",
-          nonce: "cloud-mint-nonce-wrong-audience",
-          issuedAt: DateTime.formatIso(now),
-          expiresAt: DateTime.formatIso(DateTime.add(now, { minutes: 5 })),
-        }),
-      );
-
-      assert.equal(wrongIssuer.status, 401);
-      assert.equal(wrongAudience.status, 401);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("rejects cloud mint requests for a cloud subject other than the linked user", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const cloudKeyPair = NodeCrypto.generateKeyPairSync("ed25519", {
-        privateKeyEncoding: { format: "pem", type: "pkcs8" },
-        publicKeyEncoding: { format: "pem", type: "spki" },
-      });
-      const ownerCookie = yield* getAuthenticatedSessionCookieHeader();
-      const relayConfigUrl = yield* getHttpServerUrl("/api/connect/relay-config");
-      const relayConfigResponse = yield* fetchEffect(relayConfigUrl, {
-        method: "POST",
-        headers: {
-          cookie: ownerCookie,
-          "content-type": "application/json",
-        },
-        body: jsonRequestBody({
-          relayUrl: "https://relay.example.test/",
-          cloudUserId: "user_123",
-          environmentCredential: "t3env_test_credential",
-          cloudMintPublicKey: cloudKeyPair.publicKey,
-          endpointRuntime: null,
-        }),
-      });
-      assert.equal(relayConfigResponse.status, 200);
-
-      const now = yield* DateTime.now;
-      const mintUrl = yield* getHttpServerUrl("/api/t3-connect/mint-credential");
-      const response = yield* fetchEffect(mintUrl, {
-        method: "POST",
-        headers: {
-          "content-type": "application/json",
-        },
-        body: jsonRequestBody(
-          makeCloudMintCredentialRequest({
-            privateKey: cloudKeyPair.privateKey,
-            environmentId: testEnvironmentDescriptor.environmentId,
-            clientProofKeyThumbprint: "client-proof-key-thumbprint",
-            subject: "user_other",
-            jti: "cloud-mint-jti-wrong-subject",
-            nonce: "cloud-mint-nonce-wrong-subject",
-            issuedAt: DateTime.formatIso(now),
-            expiresAt: DateTime.formatIso(DateTime.add(now, { minutes: 5 })),
-          }),
-        ),
-      });
-
-      assert.equal(response.status, 401);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("rejects cloud mint requests without the exact connect scope", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const cloudKeyPair = NodeCrypto.generateKeyPairSync("ed25519", {
-        privateKeyEncoding: { format: "pem", type: "pkcs8" },
-        publicKeyEncoding: { format: "pem", type: "spki" },
-      });
-      const ownerCookie = yield* getAuthenticatedSessionCookieHeader();
-      const relayConfigUrl = yield* getHttpServerUrl("/api/connect/relay-config");
-      const relayConfigResponse = yield* fetchEffect(relayConfigUrl, {
-        method: "POST",
-        headers: {
-          cookie: ownerCookie,
-          "content-type": "application/json",
-        },
-        body: jsonRequestBody({
-          relayUrl: "https://relay.example.test/",
-          cloudUserId: "user_123",
-          environmentCredential: "t3env_test_credential",
-          cloudMintPublicKey: cloudKeyPair.publicKey,
-          endpointRuntime: null,
-        }),
-      });
-      assert.equal(relayConfigResponse.status, 200);
-
-      const now = yield* DateTime.now;
-      const mintUrl = yield* getHttpServerUrl("/api/t3-connect/mint-credential");
-      const response = yield* fetchEffect(mintUrl, {
-        method: "POST",
-        headers: {
-          "content-type": "application/json",
-        },
-        body: jsonRequestBody(
-          makeCloudMintCredentialRequest({
-            privateKey: cloudKeyPair.privateKey,
-            environmentId: testEnvironmentDescriptor.environmentId,
-            clientProofKeyThumbprint: "client-proof-key-thumbprint",
-            jti: "cloud-mint-jti-duplicate-scope",
-            nonce: "cloud-mint-nonce-duplicate-scope",
-            issuedAt: DateTime.formatIso(now),
-            expiresAt: DateTime.formatIso(DateTime.add(now, { minutes: 5 })),
-            scope: ["environment:connect", "environment:connect"],
-          }),
-        ),
-      });
-
-      assert.equal(response.status, 401);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("rejects cloud health requests with the wrong issuer or audience", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const cloudKeyPair = NodeCrypto.generateKeyPairSync("ed25519", {
-        privateKeyEncoding: { format: "pem", type: "pkcs8" },
-        publicKeyEncoding: { format: "pem", type: "spki" },
-      });
-      const ownerCookie = yield* getAuthenticatedSessionCookieHeader();
-      const relayConfigUrl = yield* getHttpServerUrl("/api/connect/relay-config");
-      const relayConfigResponse = yield* fetchEffect(relayConfigUrl, {
-        method: "POST",
-        headers: {
-          cookie: ownerCookie,
-          "content-type": "application/json",
-        },
-        body: jsonRequestBody({
-          relayUrl: "https://relay.example.test/",
-          cloudUserId: "user_123",
-          environmentCredential: "t3env_test_credential",
-          cloudMintPublicKey: cloudKeyPair.publicKey,
-          endpointRuntime: null,
-        }),
-      });
-      assert.equal(relayConfigResponse.status, 200);
-
-      const now = yield* DateTime.now;
-      const healthUrl = yield* getHttpServerUrl("/api/t3-connect/health");
-      const postHealth = (request: ReturnType<typeof makeCloudEnvironmentHealthRequest>) =>
-        fetchEffect(healthUrl, {
-          method: "POST",
-          headers: {
-            "content-type": "application/json",
-          },
-          body: jsonRequestBody(request),
-        });
-
-      const wrongIssuer = yield* postHealth(
-        makeCloudEnvironmentHealthRequest({
-          privateKey: cloudKeyPair.privateKey,
-          environmentId: testEnvironmentDescriptor.environmentId,
-          issuer: "https://attacker.example.test",
-          jti: "cloud-health-jti-wrong-issuer",
-          nonce: "cloud-health-nonce-wrong-issuer",
-          issuedAt: DateTime.formatIso(now),
-          expiresAt: DateTime.formatIso(DateTime.add(now, { minutes: 5 })),
-        }),
-      );
-      const wrongAudience = yield* postHealth(
-        makeCloudEnvironmentHealthRequest({
-          privateKey: cloudKeyPair.privateKey,
-          environmentId: testEnvironmentDescriptor.environmentId,
-          audience: "t3-env:other-environment",
-          jti: "cloud-health-jti-wrong-audience",
-          nonce: "cloud-health-nonce-wrong-audience",
-          issuedAt: DateTime.formatIso(now),
-          expiresAt: DateTime.formatIso(DateTime.add(now, { minutes: 5 })),
-        }),
-      );
-
-      assert.equal(wrongIssuer.status, 401);
-      assert.equal(wrongAudience.status, 401);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("rejects cloud health requests for a cloud subject other than the linked user", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const cloudKeyPair = NodeCrypto.generateKeyPairSync("ed25519", {
-        privateKeyEncoding: { format: "pem", type: "pkcs8" },
-        publicKeyEncoding: { format: "pem", type: "spki" },
-      });
-      const ownerCookie = yield* getAuthenticatedSessionCookieHeader();
-      const relayConfigUrl = yield* getHttpServerUrl("/api/connect/relay-config");
-      const relayConfigResponse = yield* fetchEffect(relayConfigUrl, {
-        method: "POST",
-        headers: {
-          cookie: ownerCookie,
-          "content-type": "application/json",
-        },
-        body: jsonRequestBody({
-          relayUrl: "https://relay.example.test/",
-          cloudUserId: "user_123",
-          environmentCredential: "t3env_test_credential",
-          cloudMintPublicKey: cloudKeyPair.publicKey,
-          endpointRuntime: null,
-        }),
-      });
-      assert.equal(relayConfigResponse.status, 200);
-
-      const now = yield* DateTime.now;
-      const healthUrl = yield* getHttpServerUrl("/api/t3-connect/health");
-      const response = yield* fetchEffect(healthUrl, {
-        method: "POST",
-        headers: {
-          "content-type": "application/json",
-        },
-        body: jsonRequestBody(
-          makeCloudEnvironmentHealthRequest({
-            privateKey: cloudKeyPair.privateKey,
-            environmentId: testEnvironmentDescriptor.environmentId,
-            subject: "user_other",
-            jti: "cloud-health-jti-wrong-subject",
-            nonce: "cloud-health-nonce-wrong-subject",
-            issuedAt: DateTime.formatIso(now),
-            expiresAt: DateTime.formatIso(DateTime.add(now, { minutes: 5 })),
-          }),
-        ),
-      });
-
-      assert.equal(response.status, 401);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("rejects cloud health requests without the exact status scope", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const cloudKeyPair = NodeCrypto.generateKeyPairSync("ed25519", {
-        privateKeyEncoding: { format: "pem", type: "pkcs8" },
-        publicKeyEncoding: { format: "pem", type: "spki" },
-      });
-      const ownerCookie = yield* getAuthenticatedSessionCookieHeader();
-      const relayConfigUrl = yield* getHttpServerUrl("/api/connect/relay-config");
-      const relayConfigResponse = yield* fetchEffect(relayConfigUrl, {
-        method: "POST",
-        headers: {
-          cookie: ownerCookie,
-          "content-type": "application/json",
-        },
-        body: jsonRequestBody({
-          relayUrl: "https://relay.example.test/",
-          cloudUserId: "user_123",
-          environmentCredential: "t3env_test_credential",
-          cloudMintPublicKey: cloudKeyPair.publicKey,
-          endpointRuntime: null,
-        }),
-      });
-      assert.equal(relayConfigResponse.status, 200);
-
-      const now = yield* DateTime.now;
-      const healthUrl = yield* getHttpServerUrl("/api/t3-connect/health");
-      const response = yield* fetchEffect(healthUrl, {
-        method: "POST",
-        headers: {
-          "content-type": "application/json",
-        },
-        body: jsonRequestBody(
-          makeCloudEnvironmentHealthRequest({
-            privateKey: cloudKeyPair.privateKey,
-            environmentId: testEnvironmentDescriptor.environmentId,
-            jti: "cloud-health-jti-duplicate-scope",
-            nonce: "cloud-health-nonce-duplicate-scope",
-            issuedAt: DateTime.formatIso(now),
-            expiresAt: DateTime.formatIso(DateTime.add(now, { minutes: 5 })),
-            scope: ["environment:status", "environment:status"],
-          }),
-        ),
-      });
-
-      assert.equal(response.status, 401);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("negotiates permessage-deflate with clients that offer it", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const { cookie, url } = parseSessionCookieFromWsUrl(yield* getWsServerUrl("/ws"));
-      const openSocket = (perMessageDeflate: boolean) =>
-        Effect.acquireRelease(
-          Effect.callback<NodeSocket.NodeWS.WebSocket, Error>((resume) => {
-            const socket = new NodeSocket.NodeWS.WebSocket(url, {
-              perMessageDeflate,
-              ...(cookie ? { headers: { cookie } } : {}),
-            });
-            socket.on("open", () => resume(Effect.succeed(socket)));
-            socket.on("error", (error) => resume(Effect.fail(error)));
-          }),
-          (socket) => Effect.sync(() => socket.close()),
-        );
-
-      const compressed = yield* openSocket(true);
-      // The ws client records the negotiated extension only when the server's
-      // 101 response accepted the offer.
-      assert.include(compressed.extensions, "permessage-deflate");
-
-      const plain = yield* openSocket(false);
-      assert.notInclude(plain.extensions, "permessage-deflate");
-    }).pipe(Effect.scoped, Effect.provide(NodeHttpServerTestWithWsDeflate)),
-  );
-
-  it.effect("issues short-lived websocket tickets for authenticated bearer sessions", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const bearerToken = yield* getAuthenticatedBearerSessionToken();
-      const wsTicketUrl = yield* getHttpServerUrl("/api/auth/websocket-ticket");
-      const wsTicketResponse = yield* fetchEffect(wsTicketUrl, {
-        method: "POST",
-        headers: {
-          authorization: `Bearer ${bearerToken}`,
-        },
-      });
-      const wsTicketBody = yield* responseJsonEffect<{
-        readonly ticket: string;
-        readonly expiresAt: string;
-      }>(wsTicketResponse);
-
-      assert.equal(wsTicketResponse.status, 200);
-      assert.equal(typeof wsTicketBody.ticket, "string");
-      assert.isTrue(wsTicketBody.ticket.length > 0);
-      assert.equal(typeof wsTicketBody.expiresAt, "string");
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("does not allow management-only access tokens to operate the environment", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const { response: exchangeResponse, body: tokenBody } = yield* exchangeAccessToken(
-        defaultDesktopBootstrapToken,
-        { scope: "access:write" },
-      );
-      assert.equal(exchangeResponse.status, 200);
-      assert.equal(tokenBody.scope, "access:write");
-      assert.isDefined(tokenBody.access_token);
-
-      const overbroadPairingResponse = yield* HttpClient.post("/api/auth/pairing-token", {
-        headers: {
-          authorization: `Bearer ${tokenBody.access_token ?? ""}`,
-        },
-        body: yield* HttpBody.json({}),
-      });
-      const overbroadPairingBody = (yield* overbroadPairingResponse.json) as {
-        readonly requiredScope: string;
-      };
-      const pairingResponse = yield* HttpClient.post("/api/auth/pairing-token", {
-        headers: {
-          authorization: `Bearer ${tokenBody.access_token ?? ""}`,
-        },
-        body: yield* HttpBody.json({ scopes: ["access:write"] }),
-      });
-      const wsTicketResponse = yield* HttpClient.post("/api/auth/websocket-ticket", {
-        headers: {
-          authorization: `Bearer ${tokenBody.access_token ?? ""}`,
-        },
-      });
-      const wsTicketBody = (yield* wsTicketResponse.json) as { readonly ticket: string };
-      assert.equal(overbroadPairingResponse.status, 403);
-      assert.equal(overbroadPairingBody.requiredScope, "orchestration:read");
-      assert.equal(pairingResponse.status, 200);
-      assert.equal(wsTicketResponse.status, 200);
-      const wsUrl = `${yield* getWsServerUrl("/ws", { authenticated: false })}?wsTicket=${encodeURIComponent(wsTicketBody.ticket)}`;
-      const rpcError = yield* Effect.flip(
-        Effect.scoped(withWsRpcClient(wsUrl, (client) => client[WS_METHODS.serverGetConfig]({}))),
-      );
-      assert.equal(rpcError._tag, "EnvironmentAuthorizationError");
-      if (rpcError._tag === "EnvironmentAuthorizationError") {
-        assert.equal(rpcError.requiredScope, "orchestration:read");
-      }
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("includes CORS headers on remote auth success responses", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const origin = crossOriginClientOrigin;
-      const { response: tokenResponse, body: tokenBody } = yield* exchangeAccessToken(
-        defaultDesktopBootstrapToken,
-        {
-          headers: { origin },
-        },
-      );
-
-      assert.equal(tokenResponse.status, 200);
-      assertBrowserApiCorsResponseHeaders(tokenResponse.headers);
-      assert.equal(tokenBody.token_type, "Bearer");
-      assert.equal(typeof tokenBody.access_token, "string");
-
-      const sessionUrl = yield* getHttpServerUrl("/api/auth/session");
-      const sessionResponse = yield* fetchEffect(sessionUrl, {
-        headers: {
-          authorization: `Bearer ${tokenBody.access_token ?? ""}`,
-          origin,
-        },
-      });
-      const sessionBody = yield* responseJsonEffect<{
-        readonly authenticated: boolean;
-        readonly sessionMethod?: string;
-      }>(sessionResponse);
-
-      assert.equal(sessionResponse.status, 200);
-      assertBrowserApiCorsResponseHeaders(sessionResponse.headers);
-      assert.equal(sessionBody.authenticated, true);
-      assert.equal(sessionBody.sessionMethod, "bearer-access-token");
-
-      const wsTicketUrl = yield* getHttpServerUrl("/api/auth/websocket-ticket");
-      const wsTicketResponse = yield* fetchEffect(wsTicketUrl, {
-        method: "POST",
-        headers: {
-          authorization: `Bearer ${tokenBody.access_token ?? ""}`,
-          origin,
-        },
-      });
-      const wsTicketBody = yield* responseJsonEffect<{
-        readonly ticket: string;
-      }>(wsTicketResponse);
-
-      assert.equal(wsTicketResponse.status, 200);
-      assertBrowserApiCorsResponseHeaders(wsTicketResponse.headers);
-      assert.equal(typeof wsTicketBody.ticket, "string");
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect(
-    "responds to remote auth websocket-ticket preflight requests with authorization CORS headers",
-    () =>
-      Effect.gen(function* () {
-        yield* buildAppUnderTest();
-
-        const wsTicketUrl = yield* getHttpServerUrl("/api/auth/websocket-ticket");
-        const response = yield* fetchEffect(wsTicketUrl, {
-          method: "OPTIONS",
-          headers: {
-            origin: crossOriginClientOrigin,
-            "access-control-request-method": "POST",
-            "access-control-request-headers": "authorization",
-          },
-        });
-
-        assert.equal(response.status, 204);
-        assertBrowserApiCorsPreflightHeaders(response.headers);
-      }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("allows credentialed cloud link proof preflights from the configured dev UI", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest({
-        config: { devUrl: new URL(crossOriginClientOrigin) },
-      });
-
-      const linkProofUrl = yield* getHttpServerUrl("/api/connect/link-proof");
-      const response = yield* fetchEffect(linkProofUrl, {
-        method: "OPTIONS",
-        headers: {
-          origin: crossOriginClientOrigin,
-          "access-control-request-method": "POST",
-          "access-control-request-headers": "content-type",
-        },
-      });
-
-      assert.equal(response.status, 204);
-      assertBrowserApiCorsPreflightHeaders(response.headers, {
-        origin: crossOriginClientOrigin,
-        credentials: true,
-      });
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("allows configured development origins through ServerConfig", () =>
-    Effect.gen(function* () {
-      const tailnetOrigin = "https://host.example.ts.net";
-      yield* buildAppUnderTest({
-        config: {
-          devUrl: new URL(crossOriginClientOrigin),
-          devAllowedOrigins: [tailnetOrigin],
-        },
-      });
-
-      const sessionUrl = yield* getHttpServerUrl("/api/auth/session");
-      const response = yield* fetchEffect(sessionUrl, {
-        method: "OPTIONS",
-        headers: {
-          origin: tailnetOrigin,
-          "access-control-request-method": "GET",
-          "access-control-request-headers": "content-type",
-        },
-      });
-
-      assert.equal(response.status, 204);
-      assertBrowserApiCorsPreflightHeaders(response.headers, {
-        origin: tailnetOrigin,
-        credentials: true,
-      });
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  for (const desktopOrigin of ["t3code://app", "t3code-dev://app"]) {
-    it.effect(`allows credentialed preflights from ${desktopOrigin} in development`, () =>
-      Effect.gen(function* () {
-        yield* buildAppUnderTest({
-          config: { devUrl: new URL(crossOriginClientOrigin) },
-        });
-
-        const sessionUrl = yield* getHttpServerUrl("/api/auth/session");
-        const response = yield* fetchEffect(sessionUrl, {
-          method: "OPTIONS",
-          headers: {
-            origin: desktopOrigin,
-            "access-control-request-method": "GET",
-            "access-control-request-headers": "content-type",
-          },
-        });
-
-        assert.equal(response.status, 204);
-        assertBrowserApiCorsPreflightHeaders(response.headers, {
-          origin: desktopOrigin,
-          credentials: true,
-        });
-      }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-    );
-  }
-
-  it.effect("includes CORS headers on remote websocket-ticket auth failures", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const wsTicketUrl = yield* getHttpServerUrl("/api/auth/websocket-ticket");
-      const response = yield* fetchEffect(wsTicketUrl, {
-        method: "POST",
-        headers: {
-          origin: crossOriginClientOrigin,
-        },
-      });
-      const body = yield* responseJsonEffect<{
-        readonly _tag?: string;
-        readonly code?: string;
-        readonly reason?: string;
-        readonly traceId?: string;
-      }>(response);
-
-      assert.equal(response.status, 401);
-      assertBrowserApiCorsResponseHeaders(response.headers);
-      assert.equal(body._tag, "EnvironmentAuthInvalidError");
-      assert.equal(body.code, "auth_invalid");
-      assert.equal(body.reason, "missing_credential");
-      assert.equal(typeof body.traceId, "string");
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("issues authenticated one-time pairing credentials for additional clients", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const response = yield* HttpClient.post("/api/auth/pairing-token", {
-        headers: {
-          cookie: yield* getAuthenticatedSessionCookieHeader(),
-        },
-        body: yield* HttpBody.json({}),
-      });
-      const body = (yield* response.json) as {
-        readonly credential: string;
-        readonly expiresAt: string;
-      };
-
-      assert.equal(response.status, 200);
-      assert.equal(typeof body.credential, "string");
-      assert.isTrue(body.credential.length > 0);
-      assert.equal(typeof body.expiresAt, "string");
-
-      const bootstrapResult = yield* bootstrapBrowserSession(body.credential);
-      assert.equal(bootstrapResult.response.status, 200);
-
-      const reusedResult = yield* bootstrapBrowserSession(body.credential);
-      assert.equal(reusedResult.response.status, 401);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("issues pairing credentials for bearer sessions with access management scope", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const bearerToken = yield* getAuthenticatedBearerSessionToken();
-      const response = yield* HttpClient.post("/api/auth/pairing-token", {
-        headers: {
-          authorization: `Bearer ${bearerToken}`,
-        },
-        body: yield* HttpBody.json({ label: "Hosted web" }),
-      });
-      const body = (yield* response.json) as {
-        readonly credential: string;
-        readonly label?: string;
-      };
-
-      assert.equal(response.status, 200);
-      assert.isTrue(body.credential.length > 0);
-      assert.equal(body.label, "Hosted web");
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("rejects pairing credentials with an empty scope grant", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const response = yield* HttpClient.post("/api/auth/pairing-token", {
-        headers: {
-          cookie: yield* getAuthenticatedSessionCookieHeader(),
-        },
-        body: yield* HttpBody.json({ scopes: [] }),
-      });
-      const body = (yield* response.json) as {
-        readonly code: string;
-        readonly reason: string;
-      };
-
-      assert.equal(response.status, 400);
-      assert.equal(body.code, "invalid_request");
-      assert.equal(body.reason, "invalid_scope");
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("rejects unauthenticated pairing credential requests", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const response = yield* HttpClient.post("/api/auth/pairing-token", {
-        body: yield* HttpBody.json({}),
-      });
-      assert.equal(response.status, 401);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("lists and revokes pairing links for access management sessions", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest({
-        config: {
-          host: "0.0.0.0",
-        },
-      });
-
-      const ownerCookie = yield* getAuthenticatedSessionCookieHeader();
-      const createdResponse = yield* HttpClient.post("/api/auth/pairing-token", {
-        headers: {
-          cookie: ownerCookie,
-        },
-        body: yield* HttpBody.json({}),
-      });
-      const createdBody = (yield* createdResponse.json) as {
-        readonly id: string;
-        readonly credential: string;
-      };
-
-      const listResponse = yield* HttpClient.get("/api/auth/pairing-links", {
-        headers: {
-          cookie: ownerCookie,
-        },
-      });
-      const listedLinks = (yield* listResponse.json) as ReadonlyArray<{
-        readonly id: string;
-        readonly credential: string;
-      }>;
-
-      const revokeResponse = yield* HttpClient.post("/api/auth/pairing-links/revoke", {
-        headers: {
-          cookie: ownerCookie,
-          "content-type": "application/json",
-        },
-        body: HttpBody.text(jsonRequestBody({ id: createdBody.id }), "application/json"),
-      });
-      const revokedBootstrap = yield* bootstrapBrowserSession(createdBody.credential);
-
-      assert.equal(createdResponse.status, 200);
-      assert.equal(listResponse.status, 200);
-      assert.isTrue(listedLinks.some((entry) => entry.id === createdBody.id));
-      assert.equal(revokeResponse.status, 200);
-      assert.equal(revokedBootstrap.response.status, 401);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("rejects pairing credential requests without access management scope", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest({
-        config: {
-          host: "0.0.0.0",
-        },
-      });
-
-      const ownerResponse = yield* HttpClient.post("/api/auth/pairing-token", {
-        headers: {
-          cookie: yield* getAuthenticatedSessionCookieHeader(),
-        },
-        body: yield* HttpBody.json({}),
-      });
-      const ownerBody = (yield* ownerResponse.json) as {
-        readonly credential: string;
-      };
-      assert.equal(ownerResponse.status, 200);
-
-      const pairedSessionCookie = yield* getAuthenticatedSessionCookieHeader(ownerBody.credential);
-      const pairedResponse = yield* HttpClient.post("/api/auth/pairing-token", {
-        headers: {
-          cookie: pairedSessionCookie,
-        },
-        body: yield* HttpBody.json({}),
-      });
-      const pairedBody = (yield* pairedResponse.json) as {
-        readonly _tag: string;
-        readonly code: string;
-        readonly requiredScope: string;
-        readonly traceId: string;
-      };
-
-      assert.equal(pairedResponse.status, 403);
-      assert.equal(pairedBody._tag, "EnvironmentScopeRequiredError");
-      assert.equal(pairedBody.code, "insufficient_scope");
-      assert.equal(pairedBody.requiredScope, "access:write");
-      assert.equal(typeof pairedBody.traceId, "string");
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("lists paired clients and revokes other sessions while keeping the administrator", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest({
-        config: {
-          host: "0.0.0.0",
-        },
-      });
-
-      const ownerCookie = yield* getAuthenticatedSessionCookieHeader();
-      const pairingTokenUrl = yield* getHttpServerUrl("/api/auth/pairing-token");
-      const ownerPairingResponse = yield* fetchEffect(pairingTokenUrl, {
-        method: "POST",
-        headers: {
-          cookie: ownerCookie,
-          "content-type": "application/json",
-        },
-        body: jsonRequestBody({
-          label: "Julius iPhone",
-        }),
-      });
-      const ownerPairingBody = yield* responseJsonEffect<{
-        readonly credential: string;
-        readonly label?: string;
-      }>(ownerPairingResponse);
-      assert.equal(ownerPairingResponse.status, 200);
-      const pairedSessionBootstrap = yield* bootstrapBrowserSession(ownerPairingBody.credential, {
-        headers: {
-          "user-agent":
-            "Mozilla/5.0 (iPhone; CPU iPhone OS 17_4 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.4 Mobile/15E148 Safari/604.1",
-        },
-      });
-      const pairedSessionCookie = pairedSessionBootstrap.cookie?.split(";")[0];
-      assert.isDefined(pairedSessionCookie);
-
-      const pairedSessionCookieHeader = pairedSessionCookie ?? "";
-      const listBeforeResponse = yield* HttpClient.get("/api/auth/clients", {
-        headers: {
-          cookie: ownerCookie,
-        },
-      });
-      const clientsBefore = (yield* listBeforeResponse.json) as ReadonlyArray<{
-        readonly sessionId: string;
-        readonly current: boolean;
-        readonly client: {
-          readonly label?: string;
-          readonly deviceType: string;
-          readonly ipAddress?: string;
-          readonly os?: string;
-          readonly browser?: string;
-        };
-      }>;
-      const pairedClientBefore = clientsBefore.find((entry) => !entry.current);
-      const pairedSessionId = clientsBefore.find((entry) => !entry.current)?.sessionId;
-
-      const revokeOthersResponse = yield* HttpClient.post("/api/auth/clients/revoke-others", {
-        headers: {
-          cookie: ownerCookie,
-        },
-      });
-      const revokeOthersBody = (yield* revokeOthersResponse.json) as {
-        readonly revokedCount: number;
-      };
-
-      const listAfterResponse = yield* HttpClient.get("/api/auth/clients", {
-        headers: {
-          cookie: ownerCookie,
-        },
-      });
-      const clientsAfter = (yield* listAfterResponse.json) as ReadonlyArray<{
-        readonly sessionId: string;
-        readonly current: boolean;
-      }>;
-
-      const pairedClientPairingResponse = yield* HttpClient.post("/api/auth/pairing-token", {
-        headers: {
-          cookie: pairedSessionCookieHeader,
-        },
-        body: yield* HttpBody.json({}),
-      });
-      const pairedClientPairingBody = (yield* pairedClientPairingResponse.json) as {
-        readonly _tag: string;
-        readonly code: string;
-        readonly reason: string;
-        readonly traceId: string;
-      };
-
-      assert.equal(listBeforeResponse.status, 200);
-      assert.equal(ownerPairingBody.label, "Julius iPhone");
-      assert.lengthOf(clientsBefore, 2);
-      assert.isDefined(pairedSessionId);
-      assert.isDefined(pairedClientBefore);
-      assert.deepInclude(pairedClientBefore?.client, {
-        label: "Julius iPhone",
-        deviceType: "mobile",
-        os: "iOS",
-        browser: "Safari",
-        ipAddress: "127.0.0.1",
-      });
-      assert.equal(revokeOthersResponse.status, 200);
-      assert.equal(revokeOthersBody.revokedCount, 1);
-      assert.equal(listAfterResponse.status, 200);
-      assert.lengthOf(clientsAfter, 1);
-      assert.equal(clientsAfter[0]?.current, true);
-      assert.equal(pairedClientPairingResponse.status, 401);
-      assert.equal(pairedClientPairingBody._tag, "EnvironmentAuthInvalidError");
-      assert.equal(pairedClientPairingBody.code, "auth_invalid");
-      assert.equal(pairedClientPairingBody.reason, "invalid_credential");
-      assert.equal(typeof pairedClientPairingBody.traceId, "string");
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("separates access inventory reads from credential management writes", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest({
-        config: {
-          host: "0.0.0.0",
-        },
-      });
-
-      const ownerCookie = yield* getAuthenticatedSessionCookieHeader();
-      const issueScopedSession = Effect.fnUntraced(function* (
-        scope: "access:read" | "access:write",
-      ) {
-        const pairingResponse = yield* HttpClient.post("/api/auth/pairing-token", {
-          headers: {
-            cookie: ownerCookie,
-          },
-          body: yield* HttpBody.json({ scopes: [scope] }),
-        });
-        assert.equal(pairingResponse.status, 200);
-        const pairingBody = (yield* pairingResponse.json) as {
-          readonly credential: string;
-        };
-        return yield* getAuthenticatedSessionCookieHeader(pairingBody.credential);
-      });
-
-      const readCookie = yield* issueScopedSession("access:read");
-      const readListResponse = yield* HttpClient.get("/api/auth/clients", {
-        headers: {
-          cookie: readCookie,
-        },
-      });
-      const readWriteResponse = yield* HttpClient.post("/api/auth/pairing-token", {
-        headers: {
-          cookie: readCookie,
-        },
-        body: yield* HttpBody.json({}),
-      });
-      const readWriteBody = (yield* readWriteResponse.json) as {
-        readonly requiredScope: string;
-      };
-
-      const writeCookie = yield* issueScopedSession("access:write");
-      const writeListResponse = yield* HttpClient.get("/api/auth/clients", {
-        headers: {
-          cookie: writeCookie,
-        },
-      });
-      const writeListBody = (yield* writeListResponse.json) as {
-        readonly requiredScope: string;
-      };
-
-      assert.equal(readListResponse.status, 200);
-      assert.equal(readWriteResponse.status, 403);
-      assert.equal(readWriteBody.requiredScope, "access:write");
-      assert.equal(writeListResponse.status, 403);
-      assert.equal(writeListBody.requiredScope, "access:read");
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("revokes an individual paired client session", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest({
-        config: {
-          host: "0.0.0.0",
-        },
-      });
-
-      const ownerCookie = yield* getAuthenticatedSessionCookieHeader();
-      const pairingResponse = yield* HttpClient.post("/api/auth/pairing-token", {
-        headers: {
-          cookie: ownerCookie,
-        },
-        body: yield* HttpBody.json({}),
-      });
-      const pairingBody = (yield* pairingResponse.json) as {
-        readonly credential: string;
-      };
-      const pairedSessionCookie = yield* getAuthenticatedSessionCookieHeader(
-        pairingBody.credential,
-      );
-
-      const clientsResponse = yield* HttpClient.get("/api/auth/clients", {
-        headers: {
-          cookie: ownerCookie,
-        },
-      });
-      const clients = (yield* clientsResponse.json) as ReadonlyArray<{
-        readonly sessionId: string;
-        readonly current: boolean;
-      }>;
-      const pairedSessionId = clients.find((entry) => !entry.current)?.sessionId;
-      assert.isDefined(pairedSessionId);
-
-      const revokeResponse = yield* HttpClient.post("/api/auth/clients/revoke", {
-        headers: {
-          cookie: ownerCookie,
-          "content-type": "application/json",
-        },
-        body: HttpBody.text(jsonRequestBody({ sessionId: pairedSessionId }), "application/json"),
-      });
-      const pairedClientPairingResponse = yield* HttpClient.post("/api/auth/pairing-token", {
-        headers: {
-          cookie: pairedSessionCookie,
-        },
-        body: yield* HttpBody.json({}),
-      });
-
-      assert.equal(revokeResponse.status, 200);
-      assert.equal(pairedClientPairingResponse.status, 401);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("allows reusing the desktop bootstrap credential", () =>
-    Effect.gen(function* () {
-      // The desktop-bootstrap grant is delivered over trusted IPC at
-      // backend launch and needs to stay claimable after a renderer
-      // refresh, so it's intentionally reusable (unlike user-facing
-      // one-time pairing credentials).
-      yield* buildAppUnderTest();
-
-      const first = yield* bootstrapBrowserSession();
-      const second = yield* bootstrapBrowserSession();
-
-      assert.equal(first.response.status, 200);
-      assert.equal(second.response.status, 200);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("accepts websocket rpc handshake with a bootstrapped browser session cookie", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const { response: bootstrapResponse, cookie } = yield* bootstrapBrowserSession();
-
-      assert.equal(bootstrapResponse.status, 200);
-      assert.isDefined(cookie);
-
-      const wsUrl = appendSessionCookieToWsUrl(
-        yield* getWsServerUrl("/ws", { authenticated: false }),
-        cookie?.split(";")[0] ?? "",
-      );
-      const response = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) => client[WS_METHODS.serverGetConfig]({})),
-      );
-
-      assert.equal(response.environment.environmentId, testEnvironmentDescriptor.environmentId);
-      assert.equal(response.auth.policy, "desktop-managed-local");
-      assert.equal(response.shellResumeCompletionMarker, true);
-      assert.isUndefined(response.shellRevealInFileManager);
-      assert.isUndefined(response.shellRevealInFileManagerKind);
-      assert.equal(response.threadResumeCompletionMarker, true);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("advertises the usable file manager and its reveal label", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest({
-        layers: {
-          externalLauncher: {
-            resolveAvailableEditors: () => Effect.succeed(["file-manager"]),
-            resolveFileManagerRevealKind: () => Effect.succeed("file-explorer"),
-          },
-        },
-      });
-
-      const { cookie } = yield* bootstrapBrowserSession();
-      const wsUrl = appendSessionCookieToWsUrl(
-        yield* getWsServerUrl("/ws", { authenticated: false }),
-        cookie?.split(";")[0] ?? "",
-      );
-      const response = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) => client[WS_METHODS.serverGetConfig]({})),
-      );
-
-      assert.deepEqual(response.availableEditors, ["file-manager"]);
-      assert.equal(response.shellRevealInFileManager, true);
-      assert.equal(response.shellRevealInFileManagerKind, "file-explorer");
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("does not block server config when editor discovery never resolves", () =>
-    Effect.gen(function* () {
-      const discoveryInterrupted = yield* Deferred.make<void>();
-      const responseFiber = yield* resolveAvailableEditorsForConfig(
-        Effect.never.pipe(
-          Effect.onInterrupt(() => Deferred.succeed(discoveryInterrupted, undefined)),
-        ),
-      ).pipe(Effect.forkChild);
-
-      yield* TestClock.adjust(Duration.seconds(5));
-
-      const availableEditors = yield* Fiber.join(responseFiber);
-      yield* Deferred.await(discoveryInterrupted);
-      assert.deepEqual(availableEditors, []);
-    }),
-  );
-
-  it.effect("does not block server config when file manager reveal discovery never resolves", () =>
-    Effect.gen(function* () {
-      const discoveryInterrupted = yield* Deferred.make<void>();
-      const responseFiber = yield* resolveFileManagerRevealKindForConfig(
-        Effect.never.pipe(
-          Effect.onInterrupt(() => Deferred.succeed(discoveryInterrupted, undefined)),
-        ),
-      ).pipe(Effect.forkChild);
-
-      yield* TestClock.adjust(Duration.seconds(5));
-
-      const revealKind = yield* Fiber.join(responseFiber);
-      yield* Deferred.await(discoveryInterrupted);
-      assert.isUndefined(revealKind);
-    }),
-  );
-
-  it.effect(
-    "rejects websocket rpc handshake when a session token is only provided via query string",
-    () =>
-      Effect.gen(function* () {
-        yield* buildAppUnderTest();
-
-        const { cookie } = yield* bootstrapBrowserSession();
-        assert.isDefined(cookie);
-        const sessionToken = extractSessionTokenFromSetCookie(cookie ?? "");
-        const wsUrl = `${yield* getWsServerUrl("/ws", { authenticated: false })}?token=${encodeURIComponent(sessionToken)}`;
-
-        const error = yield* Effect.flip(
-          Effect.scoped(withWsRpcClient(wsUrl, (client) => client[WS_METHODS.serverGetConfig]({}))),
-        );
-
-        assert.equal(error._tag, "RpcClientError");
-        assertInclude(String(error), "SocketOpenError");
-      }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect(
-    "accepts websocket rpc handshake with a dedicated websocket ticket in the query string",
-    () =>
-      Effect.gen(function* () {
-        yield* buildAppUnderTest();
-
-        const bearerToken = yield* getAuthenticatedBearerSessionToken();
-        const wsTicketUrl = yield* getHttpServerUrl("/api/auth/websocket-ticket");
-        const wsTicketResponse = yield* fetchEffect(wsTicketUrl, {
-          method: "POST",
-          headers: {
-            authorization: `Bearer ${bearerToken}`,
-          },
-        });
-        const wsTicketBody = yield* responseJsonEffect<{
-          readonly ticket: string;
-        }>(wsTicketResponse);
-        const wsUrl = `${yield* getWsServerUrl("/ws", { authenticated: false })}?wsTicket=${encodeURIComponent(wsTicketBody.ticket)}`;
-
-        const response = yield* Effect.scoped(
-          withWsRpcClient(wsUrl, (client) => client[WS_METHODS.serverGetConfig]({})),
-        );
-
-        assert.equal(response.environment.environmentId, testEnvironmentDescriptor.environmentId);
-        assert.equal(response.auth.policy, "desktop-managed-local");
-      }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("proxies browser OTLP trace exports through the server", () =>
-    Effect.gen(function* () {
-      const upstreamRequests: Array<{
-        readonly body: string;
-        readonly contentType: string | null;
-      }> = [];
-      const localTraceRecords: Array<unknown> = [];
-      const payload = {
-        resourceSpans: [
-          {
-            resource: {
-              attributes: [
-                {
-                  key: "service.name",
-                  value: { stringValue: "t3-web" },
-                },
-              ],
-            },
-            scopeSpans: [
-              {
-                scope: {
-                  name: "effect",
-                  version: "4.0.0-beta.43",
-                },
-                spans: [
-                  {
-                    traceId: "11111111111111111111111111111111",
-                    spanId: "2222222222222222",
-                    parentSpanId: "3333333333333333",
-                    name: "RpcClient.server.getSettings",
-                    kind: 3,
-                    startTimeUnixNano: "1000000",
-                    endTimeUnixNano: "2000000",
-                    attributes: [
-                      {
-                        key: "rpc.method",
-                        value: { stringValue: "server.getSettings" },
-                      },
-                    ],
-                    events: [
-                      {
-                        name: "http.request",
-                        timeUnixNano: "1500000",
-                        attributes: [
-                          {
-                            key: "http.status_code",
-                            value: { intValue: "200" },
-                          },
-                        ],
-                      },
-                    ],
-                    links: [],
-                    status: {
-                      code: "STATUS_CODE_OK",
-                    },
-                    flags: 1,
-                  },
-                ],
-              },
-            ],
-          },
-        ],
-      };
-
-      const collector = yield* Effect.acquireRelease(
-        Effect.promise(async () => {
-          const NodeHttp = await import("node:http");
-
-          return await new Promise<{
-            readonly close: () => Promise<void>;
-            readonly url: string;
-          }>((resolve, reject) => {
-            const server = NodeHttp.createServer((request, response) => {
-              const chunks: Buffer[] = [];
-              request.on("data", (chunk) => {
-                chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
-              });
-              request.on("end", () => {
-                upstreamRequests.push({
-                  body: Buffer.concat(chunks).toString("utf8"),
-                  contentType: request.headers["content-type"] ?? null,
-                });
-                response.statusCode = 204;
-                response.end();
-              });
-            });
-
-            server.on("error", reject);
-            server.listen(0, "127.0.0.1", () => {
-              const address = server.address();
-              if (!address || typeof address === "string") {
-                reject(new Error("Expected TCP collector address"));
-                return;
-              }
-
-              resolve({
-                url: `http://127.0.0.1:${address.port}/v1/traces`,
-                close: () =>
-                  new Promise<void>((resolveClose, rejectClose) => {
-                    server.close((error) => {
-                      if (error) {
-                        rejectClose(error);
-                        return;
-                      }
-                      resolveClose();
-                    });
-                  }),
-              });
-            });
-          });
-        }),
-        ({ close }) => Effect.promise(close),
-      );
-
-      yield* buildAppUnderTest({
-        config: {
-          otlpTracesUrl: collector.url,
-        },
-        layers: {
-          browserTraceCollector: {
-            record: (records) =>
-              Effect.sync(() => {
-                localTraceRecords.push(...records);
-              }),
-          },
-        },
-      });
-
-      const response = yield* HttpClient.post("/api/observability/v1/traces", {
-        headers: {
-          cookie: yield* getAuthenticatedSessionCookieHeader(),
-          "content-type": "application/json",
-          origin: "http://localhost:5733",
-        },
-        // @effect-diagnostics-next-line preferSchemaOverJson:off
-        body: HttpBody.text(JSON.stringify(payload), "application/json"),
-      });
-
-      assert.equal(response.status, 204);
-      assert.equal(response.headers["access-control-allow-origin"], "*");
-      assert.deepEqual(localTraceRecords, [
-        {
-          type: "otlp-span",
-          name: "RpcClient.server.getSettings",
-          traceId: "11111111111111111111111111111111",
-          spanId: "2222222222222222",
-          parentSpanId: "3333333333333333",
-          sampled: true,
-          kind: "client",
-          startTimeUnixNano: "1000000",
-          endTimeUnixNano: "2000000",
-          durationMs: 1,
-          attributes: {
-            "rpc.method": "server.getSettings",
-          },
-          resourceAttributes: {
-            "service.name": "t3-web",
-          },
-          scope: {
-            name: "effect",
-            version: "4.0.0-beta.43",
-            attributes: {},
-          },
-          events: [
-            {
-              name: "http.request",
-              timeUnixNano: "1500000",
-              attributes: {
-                "http.status_code": "200",
-              },
-            },
-          ],
-          links: [],
-          status: {
-            code: "STATUS_CODE_OK",
-          },
-        },
-      ]);
-      assert.deepEqual(upstreamRequests, [
-        {
-          body: jsonRequestBody(payload),
-          contentType: "application/json",
-        },
-      ]);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("responds to browser OTLP trace preflight requests with CORS headers", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const response = yield* HttpClient.options("/api/observability/v1/traces", {
-        headers: {
-          origin: "http://localhost:5733",
-          "access-control-request-method": "POST",
-          "access-control-request-headers": "content-type",
-        },
-      });
-
-      assert.equal(response.status, 204);
-      assert.equal(response.headers["access-control-allow-origin"], "*");
-      assert.deepEqual(splitHeaderTokens(response.headers["access-control-allow-methods"]), [
-        "GET",
-        "OPTIONS",
-        "POST",
-      ]);
-      assert.deepEqual(splitHeaderTokens(response.headers["access-control-allow-headers"]), [
-        "authorization",
-        "b3",
-        "content-type",
-        "dpop",
-        "traceparent",
-      ]);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect(
-    "stores browser OTLP trace exports locally when no upstream collector is configured",
-    () =>
-      Effect.gen(function* () {
-        const localTraceRecords: Array<unknown> = [];
-        const payload = yield* makeBrowserOtlpPayload("client.test");
-        const resourceSpan = payload.resourceSpans[0];
-        const scopeSpan = resourceSpan?.scopeSpans[0];
-        const span = scopeSpan?.spans[0];
-
-        assert.notEqual(resourceSpan, undefined);
-        assert.notEqual(scopeSpan, undefined);
-        assert.notEqual(span, undefined);
-        if (!resourceSpan || !scopeSpan || !span) {
-          return;
-        }
-
-        yield* buildAppUnderTest({
-          layers: {
-            browserTraceCollector: {
-              record: (records) =>
-                Effect.sync(() => {
-                  localTraceRecords.push(...records);
-                }),
-            },
-          },
-        });
-
-        const response = yield* HttpClient.post("/api/observability/v1/traces", {
-          headers: {
-            cookie: yield* getAuthenticatedSessionCookieHeader(),
-            "content-type": "application/json",
-          },
-          // @effect-diagnostics-next-line preferSchemaOverJson:off
-          body: HttpBody.text(JSON.stringify(payload), "application/json"),
-        });
-
-        assert.equal(response.status, 204);
-        assert.equal(localTraceRecords.length, 1);
-        const record = localTraceRecords[0] as {
-          readonly type: string;
-          readonly name: string;
-          readonly traceId: string;
-          readonly spanId: string;
-          readonly kind: string;
-          readonly attributes: Readonly<Record<string, unknown>>;
-          readonly events: ReadonlyArray<unknown>;
-          readonly links: ReadonlyArray<unknown>;
-          readonly scope: {
-            readonly name?: string;
-            readonly attributes: Readonly<Record<string, unknown>>;
-          };
-          readonly resourceAttributes: Readonly<Record<string, unknown>>;
-          readonly status?: {
-            readonly code?: string;
-          };
-        };
-
-        assert.equal(record.type, "otlp-span");
-        assert.equal(record.name, span.name);
-        assert.equal(record.traceId, span.traceId);
-        assert.equal(record.spanId, span.spanId);
-        assert.equal(record.kind, "internal");
-        assert.deepEqual(record.attributes, {});
-        assert.deepEqual(record.events, []);
-        assert.deepEqual(record.links, []);
-        assert.equal(record.scope.name, scopeSpan.scope.name);
-        assert.deepEqual(record.scope.attributes, {});
-        assert.equal(record.resourceAttributes["service.name"], "t3-web");
-        assert.equal(record.status?.code, String(span.status.code));
-      }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("routes websocket rpc server.upsertKeybinding", () =>
-    Effect.gen(function* () {
-      const rule: KeybindingRule = {
-        command: "terminal.toggle",
-        key: "ctrl+k",
-      };
-      const resolved: ResolvedKeybindingRule = {
-        command: "terminal.toggle",
-        shortcut: {
-          key: "k",
-          metaKey: false,
-          ctrlKey: true,
-          shiftKey: false,
-          altKey: false,
-          modKey: true,
-        },
-      };
-
-      yield* buildAppUnderTest({
-        layers: {
-          keybindings: {
-            upsertKeybindingRule: () => Effect.succeed([resolved]),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const response = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) => client[WS_METHODS.serverUpsertKeybinding](rule)),
-      );
-
-      assert.deepEqual(response.issues, []);
-      assert.deepEqual(response.keybindings, [resolved]);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("routes websocket rpc server.removeKeybinding", () =>
-    Effect.gen(function* () {
-      const rule: KeybindingRule = {
-        command: "terminal.toggle",
-        key: "ctrl+k",
-      };
-      const resolved: ResolvedKeybindingRule = {
-        command: "terminal.toggle",
-        shortcut: {
-          key: "j",
-          metaKey: false,
-          ctrlKey: false,
-          shiftKey: false,
-          altKey: false,
-          modKey: true,
-        },
-      };
-
-      yield* buildAppUnderTest({
-        layers: {
-          keybindings: {
-            removeKeybindingRule: () => Effect.succeed([resolved]),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const response = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) => client[WS_METHODS.serverRemoveKeybinding](rule)),
-      );
-
-      assert.deepEqual(response.issues, []);
-      assert.deepEqual(response.keybindings, [resolved]);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("uploads Codex thread feedback through websocket rpc", () =>
-    Effect.gen(function* () {
-      const input = {
-        threadId: ThreadId.make("thread-feedback"),
-        reason: "The agent stopped early.",
-      };
-      const uploadFeedback = vi.fn<ProviderService.ProviderService["Service"]["uploadFeedback"]>(
-        () => Effect.succeed({ feedbackId: "codex-thread-feedback" }),
-      );
-      yield* buildAppUnderTest({
-        layers: {
-          providerService: { uploadFeedback },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const response = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) => client[WS_METHODS.providerUploadFeedback](input)),
-      );
-
-      assert.deepStrictEqual(response, { feedbackId: "codex-thread-feedback" });
-      assert.deepStrictEqual(uploadFeedback.mock.calls, [[input]]);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("uploads image bytes through a signed URL issued by websocket rpc", () =>
-    Effect.gen(function* () {
-      const config = yield* buildAppUnderTest();
-      const fileSystem = yield* FileSystem.FileSystem;
-      const path = yield* Path.Path;
-      const wsUrl = yield* getWsServerUrl("/ws");
-
-      yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          Effect.gen(function* () {
-            const issued = yield* client[WS_METHODS.attachmentsCreateUploadUrl]({
-              name: "screenshot.png",
-              mimeType: "image/png",
-              sizeBytes: 6,
-            });
-            const rejected = yield* HttpClient.post(issued.relativeUrl, {
-              body: HttpBody.uint8Array(new Uint8Array([1, 2, 3]), "image/png"),
-            });
-            assert.equal(rejected.status, 400);
-
-            const response = yield* HttpClient.post(issued.relativeUrl, {
-              headers: { origin: crossOriginClientOrigin },
-              body: HttpBody.uint8Array(new Uint8Array([1, 2, 3, 4, 5, 6]), "image/png"),
-            });
-            assert.equal(response.status, 204);
-            assertBrowserApiCorsResponseHeaders(response.headers);
-
-            const attachmentPath = path.join(config.attachmentsDir, `${issued.attachmentId}.png`);
-            assert.isTrue(yield* fileSystem.exists(attachmentPath));
-
-            yield* client[WS_METHODS.attachmentsDelete]({ attachmentId: issued.attachmentId });
-            assert.isFalse(yield* fileSystem.exists(attachmentPath));
-
-            const streamed = yield* client[WS_METHODS.attachmentsCreateUploadUrl]({
-              name: "streamed.png",
-              mimeType: "image/png",
-              sizeBytes: 6,
-            });
-            const streamedResponse = yield* HttpClient.post(streamed.relativeUrl, {
-              body: HttpBody.stream(Stream.make(new Uint8Array([1, 2, 3, 4, 5, 6])), "image/png"),
-            });
-            assert.equal(streamedResponse.status, 204);
-            yield* client[WS_METHODS.attachmentsDelete]({ attachmentId: streamed.attachmentId });
-
-            const uploadedFile = yield* client[WS_METHODS.attachmentsCreateUploadUrl]({
-              type: "file",
-              name: "report.pdf",
-              mimeType: "application/pdf",
-              sizeBytes: 6,
-            });
-            const fileResponse = yield* HttpClient.post(uploadedFile.relativeUrl, {
-              body: HttpBody.stream(
-                Stream.make(new Uint8Array([1, 2, 3]), new Uint8Array([4, 5, 6])),
-                "application/pdf",
-              ),
-            });
-            assert.equal(fileResponse.status, 204);
-            const uploadedFilePath = path.join(
-              config.attachmentsDir,
-              `${uploadedFile.attachmentId}.pdf`,
-            );
-            assert.isTrue(yield* fileSystem.exists(uploadedFilePath));
-
-            // A mint that carries the attachment's display name and mime
-            // serves a real download filename and Content-Type.
-            const download = yield* client[WS_METHODS.assetsCreateUrl]({
-              resource: {
-                _tag: "attachment",
-                attachmentId: uploadedFile.attachmentId,
-                fileName: "report.pdf",
-                mimeType: "application/pdf",
-              },
-            });
-            const downloadResponse = yield* HttpClient.get(download.relativeUrl);
-            assert.equal(downloadResponse.status, 200);
-            assert.equal(
-              downloadResponse.headers["content-disposition"],
-              'attachment; filename="report.pdf"',
-            );
-            assert.equal(downloadResponse.headers["content-type"], "application/pdf");
-
-            // Old clients mint without name or mime and still get a download.
-            const bareDownload = yield* client[WS_METHODS.assetsCreateUrl]({
-              resource: { _tag: "attachment", attachmentId: uploadedFile.attachmentId },
-            });
-            const bareResponse = yield* HttpClient.get(bareDownload.relativeUrl);
-            assert.equal(bareResponse.status, 200);
-            assert.equal(bareResponse.headers["content-disposition"], "attachment");
-            assert.equal(bareResponse.headers["content-type"], "application/octet-stream");
-
-            yield* client[WS_METHODS.attachmentsDelete]({
-              attachmentId: uploadedFile.attachmentId,
-            });
-            assert.isFalse(yield* fileSystem.exists(uploadedFilePath));
-          }),
-        ),
-      );
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("rejects an over-limit chunked upload through the route without hanging", () =>
-    Effect.gen(function* () {
-      const config = yield* buildAppUnderTest();
-      const fileSystem = yield* FileSystem.FileSystem;
-      const wsUrl = yield* getWsServerUrl("/ws");
-
-      yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          Effect.gen(function* () {
-            const issued = yield* client[WS_METHODS.attachmentsCreateUploadUrl]({
-              type: "file",
-              name: "big.bin",
-              mimeType: "application/octet-stream",
-              sizeBytes: 6,
-            });
-            const NodeHttp = yield* Effect.promise(() => import("node:http"));
-            const uploadUrl = new URL(issued.relativeUrl, yield* getHttpServerUrl());
-            const status = yield* Effect.callback<number, Error>((resume) => {
-              let completed = false;
-              const complete = (result: Effect.Effect<number, Error>) => {
-                if (completed) return;
-                completed = true;
-                resume(result);
-              };
-              const request = NodeHttp.request(
-                uploadUrl,
-                {
-                  method: "POST",
-                  headers: {
-                    "content-type": "application/octet-stream",
-                    "transfer-encoding": "chunked",
-                  },
-                },
-                (response) => {
-                  request.end();
-                  response.resume();
-                  response.once("end", () => complete(Effect.succeed(response.statusCode ?? 0)));
-                  response.once("error", (error) => complete(Effect.fail(error)));
-                },
-              );
-              request.once("error", (error) => complete(Effect.fail(error)));
-              request.flushHeaders();
-              request.write(new Uint8Array(4), () => {
-                request.write(new Uint8Array(4));
-              });
-
-              return Effect.sync(() => request.destroy());
-            });
-            assert.equal(status, 400);
-            assert.deepEqual(yield* fileSystem.readDirectory(config.attachmentsDir), []);
-          }),
-        ),
-      );
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("keeps feedback errors structured across websocket rpc", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("thread-feedback-failure");
-      yield* buildAppUnderTest({
-        layers: {
-          providerService: {
-            uploadFeedback: () =>
-              Effect.fail(
-                new ProviderAdapterRequestError({
-                  provider: "codex",
-                  method: "feedback/upload",
-                  detail: "private provider detail",
-                }),
-              ),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const error = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[WS_METHODS.providerUploadFeedback]({ threadId }).pipe(Effect.flip),
-        ),
-      );
-
-      assert.strictEqual(error._tag, "ProviderUploadFeedbackError");
-      if (error._tag === "ProviderUploadFeedbackError") {
-        assert.strictEqual(error.threadId, threadId);
-        assert.strictEqual(error.message, `Failed to upload feedback for thread ${threadId}.`);
-        assert.isDefined(error.cause);
-      }
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("shares one preview automation broker across websocket sessions", () =>
-    Effect.scoped(
-      Effect.gen(function* () {
-        yield* buildAppUnderTest();
-
-        const wsUrl = yield* getWsServerUrl("/ws");
-        const firstConnected = yield* Deferred.make<string>();
-        const firstClosed = yield* Deferred.make<void>();
-        const host = {
-          clientId: "shared-preview-host",
-          environmentId: testEnvironmentDescriptor.environmentId,
-        } as const;
-
-        yield* withWsRpcClient(wsUrl, (client) =>
-          client[WS_METHODS.previewAutomationConnect](host).pipe(
-            Stream.tap((event) =>
-              event.type === "connected"
-                ? Deferred.succeed(firstConnected, event.connectionId)
-                : Effect.void,
-            ),
-            Stream.runDrain,
-            Effect.ensuring(Deferred.succeed(firstClosed, undefined)),
-          ),
-        ).pipe(Effect.forkScoped);
-
-        const firstConnectionId = yield* Deferred.await(firstConnected);
-        const replacementEvent = yield* withWsRpcClient(wsUrl, (client) =>
-          client[WS_METHODS.previewAutomationConnect](host).pipe(Stream.runHead),
-        ).pipe(Effect.map(Option.getOrThrow));
-        const firstStreamClosed = yield* Deferred.await(firstClosed).pipe(
-          Effect.timeoutOption("2 seconds"),
-        );
-
-        assert.equal(replacementEvent.type, "connected");
-        assert.notEqual(replacementEvent.connectionId, firstConnectionId);
-        assert.isTrue(Option.isSome(firstStreamClosed));
-      }),
-    ).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("rejects websocket rpc handshake when session authentication is missing", () =>
-    Effect.gen(function* () {
-      const fs = yield* FileSystem.FileSystem;
-      const path = yield* Path.Path;
-      const workspaceDir = yield* fs.makeTempDirectoryScoped({ prefix: "t3-ws-auth-required-" });
-      yield* fs.writeFileString(
-        path.join(workspaceDir, "needle-file.ts"),
-        "export const needle = 1;",
-      );
-
-      yield* buildAppUnderTest();
-
-      const wsUrl = yield* getWsServerUrl("/ws", { authenticated: false });
-      const result = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[WS_METHODS.projectsSearchEntries]({
-            cwd: workspaceDir,
-            query: "needle",
-            limit: 10,
-          }),
-        ).pipe(Effect.result),
-      );
-
-      assertTrue(result._tag === "Failure");
-      const failureMessage = String(result.failure);
-      assertTrue(
-        failureMessage.includes("SocketOpenError") || failureMessage.includes("SocketCloseError"),
-      );
-      assertTrue(
-        failureMessage.includes("Unauthorized") ||
-          failureMessage.includes("An error occurred during Open"),
-      );
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("routes websocket rpc subscribeServerConfig streams snapshot then update", () =>
-    Effect.gen(function* () {
-      const path = yield* Path.Path;
-      const providers = [
-        {
-          instanceId: ProviderInstanceId.make("codex"),
-          driver: ProviderDriverKind.make("codex"),
-          enabled: true,
-          installed: true,
-          version: "1.0.0",
-          status: "ready" as const,
-          auth: { status: "authenticated" as const },
-          checkedAt: "2026-04-11T00:00:00.000Z",
-          models: [],
-          slashCommands: [],
-          skills: [],
-        },
-      ] as const;
-      const changeEvent = {
-        keybindings: [],
-        issues: [],
-      } as const;
-
-      yield* buildAppUnderTest({
-        config: {
-          otlpTracesUrl: "http://localhost:4318/v1/traces",
-          otlpMetricsUrl: "http://localhost:4318/v1/metrics",
-        },
-        layers: {
-          keybindings: {
-            loadConfigState: Effect.succeed({
-              keybindings: [],
-              issues: [],
-            }),
-            streamChanges: Stream.succeed(changeEvent),
-          },
-          providerRegistry: {
-            getProviders: Effect.succeed(providers),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const events = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[WS_METHODS.subscribeServerConfig]({}).pipe(Stream.take(2), Stream.runCollect),
-        ),
-      );
-
-      const [first, second] = Array.from(events);
-      assert.equal(first?.type, "snapshot");
-      if (first?.type === "snapshot") {
-        assert.equal(first.version, 1);
-        assert.deepEqual(first.config.keybindings, []);
-        assert.deepEqual(first.config.issues, []);
-        assert.deepEqual(first.config.providers, providers);
-        assert.equal(path.basename(first.config.observability.logsDirectoryPath), "logs");
-        assert.equal(first.config.observability.localTracingEnabled, true);
-        assert.equal(first.config.observability.otlpTracesUrl, "http://localhost:4318/v1/traces");
-        assert.equal(first.config.observability.otlpTracesEnabled, true);
-        assert.equal(first.config.observability.otlpMetricsUrl, "http://localhost:4318/v1/metrics");
-        assert.equal(first.config.observability.otlpMetricsEnabled, true);
-        assert.deepEqual(first.config.settings, DEFAULT_SERVER_SETTINGS);
-      }
-      assert.deepEqual(second, {
-        version: 1,
-        type: "keybindingsUpdated",
-        payload: { keybindings: [], issues: [] },
-      });
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("refreshes providers for each subscribeServerConfig connection", () =>
-    Effect.gen(function* () {
-      const refreshCalls = yield* Ref.make(0);
-      const firstRefreshDone = yield* Deferred.make<void>();
-      const secondRefreshDone = yield* Deferred.make<void>();
-
-      yield* buildAppUnderTest({
-        layers: {
-          providerRegistry: {
-            refresh: () =>
-              Ref.updateAndGet(refreshCalls, (count) => count + 1).pipe(
-                Effect.tap((count) =>
-                  Deferred.succeed(
-                    count === 1 ? firstRefreshDone : secondRefreshDone,
-                    undefined,
-                  ).pipe(Effect.ignore),
-                ),
-                Effect.as([]),
-              ),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          Effect.gen(function* () {
-            yield* client[WS_METHODS.subscribeServerConfig]({}).pipe(Stream.runHead);
-            yield* Deferred.await(firstRefreshDone);
-          }),
-        ),
-      );
-      yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          Effect.gen(function* () {
-            yield* client[WS_METHODS.subscribeServerConfig]({}).pipe(Stream.runHead);
-            yield* Deferred.await(secondRefreshDone);
-          }),
-        ),
-      );
-
-      assert.equal(yield* Ref.get(refreshCalls), 2);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("routes websocket resource telemetry through the subscription", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest();
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const snapshot = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[WS_METHODS.subscribeResourceTelemetry]({}).pipe(Stream.runHead),
-        ),
-      );
-
-      assertTrue(Option.isSome(snapshot));
-      assert.equal(snapshot.value.processes.length, 0);
-      assert.equal(snapshot.value.groups.backend.processCount, 0);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  // An already-shipped client decodes this stream against an event union
-  // without environmentThemesUpdated, so an ungated emit would kill its whole
-  // config subscription. Opting in is the only way to receive them.
-  it.effect("subscribeServerConfig sends published themes to an opt-in subscriber", () =>
-    Effect.gen(function* () {
-      const themes = [
-        {
-          id: "nightfall",
-          name: "Nightfall",
-          appearance: "dark" as const,
-          canvas: "#1a1b26",
-          accent: "#7aa2f7",
-        },
-      ] as const;
-
-      yield* buildAppUnderTest({
-        layers: {
-          environmentTheme: {
-            current: Effect.succeed(themes),
-            streamChanges: Stream.succeed(themes),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const events = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[WS_METHODS.subscribeServerConfig]({ environmentThemes: true }).pipe(
-            Stream.take(2),
-            Stream.runCollect,
-          ),
-        ),
-      );
-
-      const [first, second] = Array.from(events);
-      assert.equal(first?.type, "snapshot");
-      // Not in the snapshot as well, or every opt-in client receives the same
-      // array twice on every connect.
-      if (first?.type === "snapshot") assert.equal(first.config.environmentThemes, undefined);
-      assert.equal(second?.type, "environmentThemesUpdated");
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("subscribeServerConfig withholds published themes from other subscribers", () =>
-    Effect.gen(function* () {
-      const themes = [
-        {
-          id: "nightfall",
-          name: "Nightfall",
-          appearance: "dark" as const,
-          canvas: "#1a1b26",
-          accent: "#7aa2f7",
-        },
-      ] as const;
-
-      yield* buildAppUnderTest({
-        layers: {
-          environmentTheme: {
-            current: Effect.succeed(themes),
-            streamChanges: Stream.succeed(themes),
-          },
-          providerRegistry: { streamChanges: Stream.empty },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const events = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[WS_METHODS.subscribeServerConfig]({}).pipe(Stream.take(1), Stream.runCollect),
-        ),
-      );
-
-      const first = Array.from(events)[0];
-      assert.equal(first?.type, "snapshot");
-      if (first?.type === "snapshot") assert.equal(first.config.environmentThemes, undefined);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("routes websocket rpc subscribeServerConfig emits provider status updates", () =>
-    Effect.gen(function* () {
-      const nextProviders = [
-        {
-          instanceId: ProviderInstanceId.make("codex"),
-          driver: ProviderDriverKind.make("codex"),
-          enabled: true,
-          installed: true,
-          version: "1.0.0",
-          status: "ready" as const,
-          auth: { status: "authenticated" as const },
-          checkedAt: "2026-04-11T00:00:00.000Z",
-          models: [],
-          slashCommands: [],
-          skills: [],
-        },
-      ] as const;
-
-      yield* buildAppUnderTest({
-        layers: {
-          keybindings: {
-            loadConfigState: Effect.succeed({
-              keybindings: [],
-              issues: [],
-            }),
-            streamChanges: Stream.empty,
-          },
-          providerRegistry: {
-            getProviders: Effect.succeed([]),
-            streamChanges: Stream.succeed(nextProviders),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const events = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[WS_METHODS.subscribeServerConfig]({}).pipe(Stream.take(2), Stream.runCollect),
-        ),
-      );
-
-      const [first, second] = Array.from(events);
-      assert.equal(first?.type, "snapshot");
-      if (first?.type === "snapshot") {
-        assert.deepEqual(first.config.providers, []);
-      }
-      assert.deepEqual(second, {
-        version: 1,
-        type: "providerStatuses",
-        payload: { providers: nextProviders },
-      });
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect(
-    "routes websocket rpc subscribeServerLifecycle replays snapshot and streams updates",
-    () =>
-      Effect.gen(function* () {
-        const lifecycleEvents = [
-          {
-            version: 1 as const,
-            sequence: 1,
-            type: "welcome" as const,
-            payload: {
-              environment: testEnvironmentDescriptor,
-              cwd: "/tmp/project",
-              projectName: "project",
-            },
-          },
-        ] as const;
-        const liveEvents = Stream.make({
-          version: 1 as const,
-          sequence: 2,
-          type: "ready" as const,
-          payload: { at: "2026-01-01T00:00:00.000Z", environment: testEnvironmentDescriptor },
-        });
-
-        yield* buildAppUnderTest({
-          layers: {
-            serverLifecycleEvents: {
-              snapshot: Effect.succeed({
-                sequence: 1,
-                events: lifecycleEvents,
-              }),
-              stream: liveEvents,
-            },
-          },
-        });
-
-        const wsUrl = yield* getWsServerUrl("/ws");
-        const events = yield* Effect.scoped(
-          withWsRpcClient(wsUrl, (client) =>
-            client[WS_METHODS.subscribeServerLifecycle]({}).pipe(Stream.take(2), Stream.runCollect),
-          ),
-        );
-
-        const [first, second] = Array.from(events);
-        assert.equal(first?.type, "welcome");
-        assert.equal(first?.sequence, 1);
-        assert.equal(second?.type, "ready");
-        assert.equal(second?.sequence, 2);
-      }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("routes websocket rpc projects.searchEntries", () =>
-    Effect.gen(function* () {
-      const fs = yield* FileSystem.FileSystem;
-      const path = yield* Path.Path;
-      const workspaceDir = yield* fs.makeTempDirectoryScoped({ prefix: "t3-ws-project-search-" });
-      yield* fs.writeFileString(
-        path.join(workspaceDir, "needle-file.ts"),
-        "export const needle = 1;",
-      );
-
-      yield* buildAppUnderTest();
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const response = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[WS_METHODS.projectsSearchEntries]({
-            cwd: workspaceDir,
-            query: "needle",
-            limit: 10,
-          }),
-        ),
-      );
-
-      assert.isAtLeast(response.entries.length, 1);
-      assert.isTrue(response.entries.some((entry) => entry.path === "needle-file.ts"));
-      assert.equal(response.truncated, false);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest), TestClock.withLive),
-  );
-
-  it.effect("routes websocket rpc projects.listEntries and projects.readFile", () =>
-    Effect.gen(function* () {
-      const fs = yield* FileSystem.FileSystem;
-      const path = yield* Path.Path;
-      const workspaceDir = yield* fs.makeTempDirectoryScoped({ prefix: "t3-ws-project-files-" });
-      yield* fs.makeDirectory(path.join(workspaceDir, "src"), { recursive: true });
-      yield* fs.writeFileString(
-        path.join(workspaceDir, "src", "index.ts"),
-        "export const answer = 42;\n",
-      );
-
-      yield* buildAppUnderTest();
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const response = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          Effect.all({
-            listing: client[WS_METHODS.projectsListEntries]({ cwd: workspaceDir }),
-            file: client[WS_METHODS.projectsReadFile]({
-              cwd: workspaceDir,
-              relativePath: "src/index.ts",
-            }),
-          }),
-        ),
-      );
-
-      assert.isTrue(response.listing.entries.some((entry) => entry.path === "src/index.ts"));
-      assert.deepEqual(response.file, {
-        relativePath: "src/index.ts",
-        contents: "export const answer = 42;\n",
-        byteLength: 26,
-        truncated: false,
-      });
-    }).pipe(Effect.provide(NodeHttpServer.layerTest), TestClock.withLive),
-  );
-
-  it.effect("routes websocket rpc projects.searchEntries excludes gitignored files", () =>
-    Effect.gen(function* () {
-      const fs = yield* FileSystem.FileSystem;
-      const path = yield* Path.Path;
-      const workspaceDir = yield* fs.makeTempDirectoryScoped({
-        prefix: "t3-ws-project-search-gitignored-",
-      });
-      yield* fs.writeFileString(path.join(workspaceDir, ".gitignore"), ".venv/\n");
-      yield* fs.makeDirectory(path.join(workspaceDir, ".venv", "lib"), { recursive: true });
-      yield* fs.writeFileString(
-        path.join(workspaceDir, ".venv", "lib", "ignored-search-target.ts"),
-        "export const ignored = true;",
-      );
-      yield* fs.makeDirectory(path.join(workspaceDir, "src"), { recursive: true });
-      yield* fs.writeFileString(
-        path.join(workspaceDir, "src", "tracked.ts"),
-        "export const ok = 1;",
-      );
-
-      yield* buildAppUnderTest({
-        layers: {
-          vcsDriver: {
-            isInsideWorkTree: () => Effect.succeed(true),
-            listWorkspaceFiles: () =>
-              Effect.succeed({
-                paths: ["src/tracked.ts"],
-                truncated: false,
-                freshness: {
-                  source: "live-local",
-                  observedAt: TEST_EPOCH,
-                  expiresAt: Option.none(),
-                },
-              }),
-            filterIgnoredPaths: (_cwd, relativePaths) =>
-              Effect.succeed(
-                relativePaths.filter((relativePath) => !relativePath.startsWith(".venv/")),
-              ),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const response = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[WS_METHODS.projectsSearchEntries]({
-            cwd: workspaceDir,
-            query: "ignored-search-target",
-            limit: 10,
-          }),
-        ),
-      );
-
-      assert.equal(response.entries.length, 0);
-      assert.equal(response.truncated, false);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest), TestClock.withLive),
-  );
-
-  it.effect("preserves structured workspace rpc failures", () =>
-    Effect.gen(function* () {
-      const fs = yield* FileSystem.FileSystem;
-      const path = yield* Path.Path;
-      const workspaceDir = yield* fs.makeTempDirectoryScoped({
-        prefix: "t3-ws-workspace-errors-",
-      });
-      const outsideDir = yield* fs.makeTempDirectoryScoped({
-        prefix: "t3-ws-workspace-errors-outside-",
-      });
-      const outsideFile = path.join(outsideDir, "outside.txt");
-      yield* fs.writeFileString(outsideFile, "outside\n");
-      yield* fs.symlink(outsideFile, path.join(workspaceDir, "linked-outside.txt"));
-      const resolvedOutsideFile = yield* fs.realPath(outsideFile);
-
-      yield* buildAppUnderTest();
-
-      const invalidWorkspace = path.join(workspaceDir, "missing-workspace");
-      const missingBrowseParent = path.join(workspaceDir, "missing-browse");
-      const sensitiveQuery = "authorization: Bearer secret-token";
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const results = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          Effect.all({
-            search: client[WS_METHODS.projectsSearchEntries]({
-              cwd: invalidWorkspace,
-              query: sensitiveQuery,
-              limit: 10,
-            }).pipe(Effect.result),
-            list: client[WS_METHODS.projectsListEntries]({ cwd: invalidWorkspace }).pipe(
-              Effect.result,
-            ),
-            read: client[WS_METHODS.projectsReadFile]({
-              cwd: workspaceDir,
-              relativePath: "linked-outside.txt",
-            }).pipe(Effect.result),
-            browse: client[WS_METHODS.filesystemBrowse]({
-              cwd: workspaceDir,
-              partialPath: "./missing-browse/child",
-            }).pipe(Effect.result),
-          }),
-        ),
-      );
-
-      if (
-        results.search._tag !== "Failure" ||
-        results.search.failure._tag !== "ProjectSearchEntriesError"
-      ) {
-        assert.fail("Expected a ProjectSearchEntriesError");
-      }
-      const searchError = results.search.failure;
-      assert.equal(
-        searchError.message,
-        `Failed to search workspace entries in '${invalidWorkspace}'.`,
-      );
-      assert.equal(searchError.cwd, invalidWorkspace);
-      assert.equal(searchError.queryLength, sensitiveQuery.length);
-      assert.notProperty(searchError, "query");
-      assert.notInclude(searchError.message, "Bearer");
-      assert.notInclude(searchError.message, "secret-token");
-      assert.equal(searchError.limit, 10);
-      assert.equal(searchError.failure, "workspace_root_not_found");
-      assert.equal(searchError.normalizedCwd, invalidWorkspace);
-      assert.isDefined(searchError.cause);
-
-      if (
-        results.list._tag !== "Failure" ||
-        results.list.failure._tag !== "ProjectListEntriesError"
-      ) {
-        assert.fail("Expected a ProjectListEntriesError");
-      }
-      const listError = results.list.failure;
-      assert.equal(listError.message, `Failed to list workspace entries in '${invalidWorkspace}'.`);
-      assert.equal(listError.cwd, invalidWorkspace);
-      assert.equal(listError.failure, "workspace_root_not_found");
-      assert.equal(listError.normalizedCwd, invalidWorkspace);
-      assert.isDefined(listError.cause);
-
-      if (results.read._tag !== "Failure" || results.read.failure._tag !== "ProjectReadFileError") {
-        assert.fail("Expected a ProjectReadFileError");
-      }
-      const readError = results.read.failure;
-      assert.equal(
-        readError.message,
-        `Failed to read workspace file 'linked-outside.txt' in '${workspaceDir}'.`,
-      );
-      assert.equal(readError.cwd, workspaceDir);
-      assert.equal(readError.relativePath, "linked-outside.txt");
-      assert.equal(readError.failure, "resolved_path_outside_root");
-      assert.equal(readError.resolvedPath, resolvedOutsideFile);
-      assert.isDefined(readError.cause);
-
-      if (
-        results.browse._tag !== "Failure" ||
-        results.browse.failure._tag !== "FilesystemBrowseError"
-      ) {
-        assert.fail("Expected a FilesystemBrowseError");
-      }
-      const browseError = results.browse.failure;
-      assert.equal(
-        browseError.message,
-        `Failed to browse filesystem path './missing-browse/child' from '${workspaceDir}'.`,
-      );
-      assert.equal(browseError.cwd, workspaceDir);
-      assert.equal(browseError.partialPath, "./missing-browse/child");
-      assert.equal(browseError.failure, "read_directory_failed");
-      assert.equal(browseError.parentPath, missingBrowseParent);
-      assert.isDefined(browseError.cause);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("reports workspace root stat failures without relabeling them as missing", () =>
-    Effect.gen(function* () {
-      if ((yield* HostProcessPlatform) === "win32") return;
-
-      const fs = yield* FileSystem.FileSystem;
-      const path = yield* Path.Path;
-      const blockedRoot = yield* fs.makeTempDirectoryScoped({
-        prefix: "t3-ws-workspace-stat-error-",
-      });
-      const workspaceRoot = path.join(blockedRoot, "workspace");
-      yield* fs.makeDirectory(workspaceRoot);
-      yield* fs.chmod(blockedRoot, 0o000);
-
-      const result = yield* Effect.gen(function* () {
-        yield* buildAppUnderTest();
-        const wsUrl = yield* getWsServerUrl("/ws");
-        return yield* Effect.scoped(
-          withWsRpcClient(wsUrl, (client) =>
-            client[WS_METHODS.projectsListEntries]({ cwd: workspaceRoot }).pipe(Effect.result),
-          ),
-        );
-      }).pipe(Effect.ensuring(fs.chmod(blockedRoot, 0o700).pipe(Effect.ignore)));
-
-      if (result._tag !== "Failure" || result.failure._tag !== "ProjectListEntriesError") {
-        assert.fail("Expected a ProjectListEntriesError");
-      }
-      const error = result.failure;
-      assert.equal(error.failure, "workspace_root_stat_failed");
-      assert.equal(error.normalizedCwd, workspaceRoot);
-      assert.equal(error.detail, "validate-existing");
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("routes websocket rpc projects.writeFile", () =>
-    Effect.gen(function* () {
-      const fs = yield* FileSystem.FileSystem;
-      const path = yield* Path.Path;
-      const workspaceDir = yield* fs.makeTempDirectoryScoped({ prefix: "t3-ws-project-write-" });
-
-      yield* buildAppUnderTest();
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const response = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[WS_METHODS.projectsWriteFile]({
-            cwd: workspaceDir,
-            relativePath: "nested/created.txt",
-            contents: "written-by-rpc",
-          }),
-        ),
-      );
-
-      assert.equal(response.relativePath, "nested/created.txt");
-      const persisted = yield* fs.readFileString(path.join(workspaceDir, "nested", "created.txt"));
-      assert.equal(persisted, "written-by-rpc");
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("creates a missing workspace root during websocket project.create dispatch", () =>
-    Effect.gen(function* () {
-      const fs = yield* FileSystem.FileSystem;
-      const path = yield* Path.Path;
-      const parentDir = yield* fs.makeTempDirectoryScoped({ prefix: "t3-ws-project-create-" });
-      const missingWorkspaceRoot = path.join(parentDir, "nested", "new-project");
-
-      yield* buildAppUnderTest();
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const response = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[ORCHESTRATION_WS_METHODS.dispatchCommand]({
-            type: "project.create",
-            commandId: CommandId.make("cmd-project-create-missing-root"),
-            projectId: ProjectId.make("project-create-missing-root"),
-            title: "New Project",
-            workspaceRoot: missingWorkspaceRoot,
-            createWorkspaceRootIfMissing: true,
-            defaultModelSelection: {
-              instanceId: ProviderInstanceId.make("codex"),
-              model: "gpt-5-codex",
-            },
-            createdAt: "2026-01-01T00:00:00.000Z",
-          }),
-        ),
-      );
-      const stat = yield* fs.stat(missingWorkspaceRoot);
-
-      assert.isAtLeast(response.sequence, 0);
-      assert.equal(stat.type, "Directory");
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("records thread analytics only after a client command succeeds", () =>
-    Effect.gen(function* () {
-      const effects: string[] = [];
-      const analyticsProperties: Array<Readonly<Record<string, unknown>> | undefined> = [];
-      const failedCommandId = CommandId.make("cmd-thread-create-failed");
-
-      yield* buildAppUnderTest({
-        layers: {
-          analyticsService: {
-            record: (event, properties) =>
-              Effect.sync(() => {
-                effects.push(`analytics:${event}`);
-                analyticsProperties.push(properties);
-              }),
-          },
-          orchestrationEngine: {
-            dispatch: (command) =>
-              Effect.sync(() => effects.push(`dispatch:${command.commandId}`)).pipe(
-                Effect.flatMap(() =>
-                  command.commandId === failedCommandId
-                    ? Effect.fail(
-                        new OrchestrationListenerCallbackError({
-                          listener: "domain-event",
-                          detail: "thread creation failed",
-                        }),
-                      )
-                    : Effect.succeed({ sequence: 1 }),
-                ),
-              ),
-          },
-        },
-      });
-
-      const createThreadCommand = (commandId: CommandId, threadId: ThreadId) =>
-        ({
-          type: "thread.create",
-          commandId,
-          threadId,
-          projectId: defaultProjectId,
-          title: "Analytics test",
-          modelSelection: defaultModelSelection,
-          runtimeMode: "full-access",
-          interactionMode: "default",
-          branch: null,
-          worktreePath: null,
-          createdAt: "2026-01-01T00:00:00.000Z",
-        }) as const;
-
-      const wsUrl = yield* getWsServerUrl(
-        "/ws?clientSurface=mobile&clientAppVersion=1.2.3&clientDeviceType=phone&clientOs=iOS&clientOsMajorVersion=18&clientDeviceModel=iPhone+15+Pro&connectionMethod=relay",
-      );
-      yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          Effect.gen(function* () {
-            const failed = yield* client[ORCHESTRATION_WS_METHODS.dispatchCommand](
-              createThreadCommand(failedCommandId, ThreadId.make("thread-create-failed")),
-            ).pipe(Effect.result);
-
-            assert.equal(failed._tag, "Failure");
-            assert.deepEqual(effects, [
-              "analytics:client.connected",
-              "dispatch:cmd-thread-create-failed",
-            ]);
-
-            const succeeded = yield* client[ORCHESTRATION_WS_METHODS.dispatchCommand](
-              createThreadCommand(
-                CommandId.make("cmd-thread-create-succeeded"),
-                ThreadId.make("thread-create-succeeded"),
-              ),
-            );
-
-            assert.equal(succeeded.sequence, 1);
-          }),
-        ),
-      );
-
-      assert.deepEqual(effects, [
-        "analytics:client.connected",
-        "dispatch:cmd-thread-create-failed",
-        "dispatch:cmd-thread-create-succeeded",
-        "analytics:client.thread.started",
-      ]);
-      assert.deepEqual(analyticsProperties, [
-        {
-          surface: "mobile",
-          appVersion: "1.2.3",
-          clientAppVersion: "1.2.3",
-          clientOs: "iOS",
-          os: "iOS",
-          clientDeviceType: "phone",
-          osMajorVersion: 18,
-          clientOsMajorVersion: 18,
-          deviceModel: "iPhone 15 Pro",
-          clientDeviceModel: "iPhone 15 Pro",
-          connectionMethod: "relay",
-        },
-        {
-          surface: "mobile",
-          appVersion: "1.2.3",
-          clientAppVersion: "1.2.3",
-          clientOs: "iOS",
-          os: "iOS",
-          clientDeviceType: "phone",
-          osMajorVersion: 18,
-          clientOsMajorVersion: 18,
-          deviceModel: "iPhone 15 Pro",
-          clientDeviceModel: "iPhone 15 Pro",
-          connectionMethod: "relay",
-        },
-      ]);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("keeps telemetry separate for simultaneous clients", () =>
-    Effect.gen(function* () {
-      const analyticsEvents: Array<{
-        event: string;
-        properties: Readonly<Record<string, unknown>> | undefined;
-      }> = [];
-
-      yield* buildAppUnderTest({
-        layers: {
-          analyticsService: {
-            record: (event, properties) =>
-              Effect.sync(() => analyticsEvents.push({ event, properties })),
-          },
-          orchestrationEngine: {
-            dispatch: () => Effect.succeed({ sequence: 1 }),
-          },
-        },
-      });
-
-      const webUrl = yield* getWsServerUrl(
-        "/ws?clientSurface=web&clientAppVersion=2.0.0&clientDeviceType=desktop&clientOs=Windows&clientWebDeployment=hosted&clientBrowser=Chrome&connectionMethod=direct",
-      );
-      const mobileUrl = yield* getWsServerUrl(
-        "/ws?clientSurface=mobile&clientAppVersion=3.0.0&clientDeviceType=tablet&clientOs=Android&clientOsMajorVersion=15&clientDeviceModel=Pixel+Tablet&connectionMethod=relay",
-      );
-      const turnCommand = (client: string) => ({
-        type: "thread.turn.start" as const,
-        commandId: CommandId.make(`cmd-${client}-turn`),
-        threadId: ThreadId.make(`thread-${client}`),
-        message: {
-          messageId: MessageId.make(`message-${client}`),
-          role: "user" as const,
-          text: "hello",
-          attachments: [],
-        },
-        modelSelection: defaultModelSelection,
-        runtimeMode: "full-access" as const,
-        interactionMode: "default" as const,
-        createdAt: "2026-01-01T00:00:00.000Z",
-      });
-
-      yield* Effect.scoped(
-        withWsRpcClient(webUrl, (webClient) =>
-          withWsRpcClient(mobileUrl, (mobileClient) =>
-            Effect.gen(function* () {
-              yield* mobileClient[ORCHESTRATION_WS_METHODS.dispatchCommand](turnCommand("mobile"));
-              yield* webClient[ORCHESTRATION_WS_METHODS.dispatchCommand](turnCommand("web"));
-            }),
-          ),
-        ),
-      );
-
-      assert.deepEqual(
-        analyticsEvents
-          .filter(({ event }) => event === "client.turn.requested")
-          .map(({ properties }) => properties),
-        [
-          {
-            surface: "mobile",
-            appVersion: "3.0.0",
-            clientAppVersion: "3.0.0",
-            clientOs: "Android",
-            os: "Android",
-            clientDeviceType: "tablet",
-            osMajorVersion: 15,
-            clientOsMajorVersion: 15,
-            deviceModel: "Pixel Tablet",
-            clientDeviceModel: "Pixel Tablet",
-            connectionMethod: "relay",
-          },
-          {
-            surface: "web",
-            appVersion: "2.0.0",
-            clientAppVersion: "2.0.0",
-            clientOs: "Windows",
-            clientDeviceType: "desktop",
-            webDeployment: "hosted",
-            clientBrowser: "Chrome",
-            connectionMethod: "direct",
-          },
-        ],
-      );
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("ignores invalid client telemetry without rejecting the connection", () =>
-    Effect.gen(function* () {
-      const connectedProperties: Array<Readonly<Record<string, unknown>> | undefined> = [];
-
-      yield* buildAppUnderTest({
-        layers: {
-          analyticsService: {
-            record: (event, properties) =>
-              event === "client.connected"
-                ? Effect.sync(() => connectedProperties.push(properties))
-                : Effect.void,
-          },
-        },
-      });
-
-      const invalidUrl = yield* getWsServerUrl(
-        "/ws?clientSurface=watch&clientDeviceType=television&clientOs=Plan9&clientWebDeployment=cdn&clientBrowser=&clientOsMajorVersion=-1&connectionMethod=teleport",
-      );
-      yield* Effect.scoped(
-        withWsRpcClient(invalidUrl, (client) => client[WS_METHODS.serverGetSettings]({})),
-      );
-
-      assert.deepEqual(connectedProperties, [{}]);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("routes websocket rpc projects.writeFile errors", () =>
-    Effect.gen(function* () {
-      const fs = yield* FileSystem.FileSystem;
-      const workspaceDir = yield* fs.makeTempDirectoryScoped({ prefix: "t3-ws-project-write-" });
-
-      yield* buildAppUnderTest();
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const result = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[WS_METHODS.projectsWriteFile]({
-            cwd: workspaceDir,
-            relativePath: "../escape.txt",
-            contents: "nope",
-          }),
-        ).pipe(Effect.result),
-      );
-
-      if (result._tag !== "Failure" || result.failure._tag !== "ProjectWriteFileError") {
-        assert.fail("Expected a ProjectWriteFileError");
-      }
-      const writeError = result.failure;
-      assert.equal(
-        writeError.message,
-        `Failed to write workspace file '../escape.txt' in '${workspaceDir}'.`,
-      );
-      assert.equal(writeError.cwd, workspaceDir);
-      assert.equal(writeError.relativePath, "../escape.txt");
-      assert.equal(writeError.failure, "workspace_path_outside_root");
-      assert.isDefined(writeError.cause);
-      assert.notProperty(writeError, "contents");
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("routes websocket rpc shell.openInEditor", () =>
-    Effect.gen(function* () {
-      let openedInput: { cwd: string; editor: EditorId } | null = null;
-      yield* buildAppUnderTest({
-        layers: {
-          externalLauncher: {
-            launchEditor: (input) =>
-              Effect.sync(() => {
-                openedInput = input;
-              }),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[WS_METHODS.shellOpenInEditor]({
-            cwd: "/tmp/project",
-            editor: "cursor",
-          }),
-        ),
-      );
-
-      assert.deepEqual(openedInput, { cwd: "/tmp/project", editor: "cursor" });
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("routes websocket rpc shell.openInEditor errors", () =>
-    Effect.gen(function* () {
-      const externalLauncherError = new ExternalLauncherCommandNotFoundError({
-        editor: "cursor",
-        command: "cursor",
-      });
-      yield* buildAppUnderTest({
-        layers: {
-          externalLauncher: {
-            launchEditor: () => Effect.fail(externalLauncherError),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const result = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[WS_METHODS.shellOpenInEditor]({
-            cwd: "/tmp/project",
-            editor: "cursor",
-          }),
-        ).pipe(Effect.result),
-      );
-
-      assertFailure(result, externalLauncherError);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("routes websocket rpc git methods", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest({
-        config: {
-          cwd: "/tmp/repo",
-        },
-        layers: {
-          vcsDriver: {
-            isInsideWorkTree: () => Effect.succeed(true),
-          },
-          gitManager: {
-            invalidateLocalStatus: () => Effect.void,
-            invalidateRemoteStatus: () => Effect.void,
-            invalidateStatus: () => Effect.void,
-            localStatus: () =>
-              Effect.succeed({
-                isRepo: true,
-                hasPrimaryRemote: true,
-                isDefaultRef: true,
-                refName: "main",
-                hasWorkingTreeChanges: false,
-                workingTree: { files: [], insertions: 0, deletions: 0 },
-              }),
-            remoteStatus: () =>
-              Effect.succeed({
-                hasUpstream: true,
-                aheadCount: 0,
-                behindCount: 0,
-                pr: null,
-              }),
-            status: () =>
-              Effect.succeed({
-                isRepo: true,
-                hasPrimaryRemote: true,
-                isDefaultRef: true,
-                refName: "main",
-                hasWorkingTreeChanges: false,
-                workingTree: { files: [], insertions: 0, deletions: 0 },
-                hasUpstream: true,
-                aheadCount: 0,
-                behindCount: 0,
-                pr: null,
-              }),
-            runStackedAction: (input, options) =>
-              Effect.gen(function* () {
-                const result = {
-                  action: "commit" as const,
-                  branch: { status: "skipped_not_requested" as const },
-                  commit: {
-                    status: "created" as const,
-                    commitSha: "abc123",
-                    subject: "feat: demo",
-                  },
-                  push: { status: "skipped_not_requested" as const },
-                  pr: { status: "skipped_not_requested" as const },
-                  toast: {
-                    title: "Committed abc123",
-                    description: "feat: demo",
-                    cta: {
-                      kind: "run_action" as const,
-                      label: "Push",
-                      action: {
-                        kind: "push" as const,
-                      },
-                    },
-                  },
-                };
-
-                yield* (
-                  options?.progressReporter?.publish({
-                    actionId: options.actionId ?? input.actionId,
-                    cwd: input.cwd,
-                    action: input.action,
-                    kind: "phase_started",
-                    phase: "commit",
-                    label: "Committing...",
-                  }) ?? Effect.void
-                );
-
-                yield* (
-                  options?.progressReporter?.publish({
-                    actionId: options.actionId ?? input.actionId,
-                    cwd: input.cwd,
-                    action: input.action,
-                    kind: "action_finished",
-                    result,
-                  }) ?? Effect.void
-                );
-
-                return result;
-              }),
-            resolvePullRequest: () =>
-              Effect.succeed({
-                pullRequest: {
-                  number: 1,
-                  title: "Demo PR",
-                  url: "https://example.com/pr/1",
-                  baseBranch: "main",
-                  headBranch: "feature/demo",
-                  state: "open",
-                },
-              }),
-            preparePullRequestThread: () =>
-              Effect.succeed({
-                pullRequest: {
-                  number: 1,
-                  title: "Demo PR",
-                  url: "https://example.com/pr/1",
-                  baseBranch: "main",
-                  headBranch: "feature/demo",
-                  state: "open",
-                },
-                branch: "feature/demo",
-                worktreePath: null,
-                isOnPullRequestHead: true,
-              }),
-          },
-          gitVcsDriver: {
-            pullCurrentBranch: () =>
-              Effect.succeed({
-                status: "pulled",
-                refName: "main",
-                upstreamRef: "origin/main",
-              }),
-            listRefs: () =>
-              Effect.succeed({
-                refs: [
-                  {
-                    name: "main",
-                    current: true,
-                    isDefault: true,
-                    worktreePath: null,
-                  },
-                ],
-                isRepo: true,
-                hasPrimaryRemote: true,
-                nextCursor: null,
-                totalCount: 1,
-              }),
-            createWorktree: () =>
-              Effect.succeed({
-                worktree: { path: "/tmp/wt", refName: "feature/demo" },
-              }),
-            removeWorktree: () => Effect.void,
-            createRef: (input) => Effect.succeed({ refName: input.refName }),
-            switchRef: (input) => Effect.succeed({ refName: input.refName }),
-          },
-          vcsStatusBroadcaster: {
-            refreshStatus: () =>
-              Effect.succeed({
-                isRepo: true,
-                hasPrimaryRemote: true,
-                isDefaultRef: true,
-                refName: "main",
-                hasWorkingTreeChanges: false,
-                workingTree: { files: [], insertions: 0, deletions: 0 },
-                hasUpstream: true,
-                aheadCount: 0,
-                behindCount: 0,
-                pr: null,
-              }),
-          },
-          reviewService: {
-            getDiffPreview: (input) =>
-              Effect.succeed({
-                cwd: input.cwd,
-                generatedAt: DateTime.nowUnsafe(),
-                sources: [
-                  {
-                    id: "working-tree",
-                    kind: "working-tree",
-                    title: "Dirty worktree",
-                    baseRef: "HEAD",
-                    headRef: null,
-                    diff: "dirty-diff",
-                    diffHash: "hash-dirty",
-                    truncated: false,
-                  },
-                  {
-                    id: "branch-range",
-                    kind: "branch-range",
-                    title: "Against main",
-                    baseRef: "main",
-                    headRef: "feature/demo",
-                    diff: "base-diff",
-                    diffHash: "hash-base",
-                    truncated: false,
-                  },
-                ],
-              }),
-            getDiffFileContents: () =>
-              Effect.succeed({
-                oldContents: "before\n",
-                newContents: "after\n",
-              }),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-
-      const pull = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) => client[WS_METHODS.vcsPull]({ cwd: "/tmp/repo" })),
-      );
-      assert.equal(pull.status, "pulled");
-
-      const refreshedStatus = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[WS_METHODS.vcsRefreshStatus]({ cwd: "/tmp/repo" }),
-        ),
-      );
-      assert.equal(refreshedStatus.isRepo, true);
-
-      const stackedEvents = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[WS_METHODS.gitRunStackedAction]({
-            actionId: "action-1",
-            cwd: "/tmp/repo",
-            action: "commit",
-          }).pipe(
-            Stream.runCollect,
-            Effect.map((events) => Array.from(events)),
-          ),
-        ),
-      );
-      const lastStackedEvent = stackedEvents.at(-1);
-      assert.equal(lastStackedEvent?.kind, "action_finished");
-      if (lastStackedEvent?.kind === "action_finished") {
-        assert.equal(lastStackedEvent.result.action, "commit");
-      }
-
-      const resolvedPr = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[WS_METHODS.gitResolvePullRequest]({
-            cwd: "/tmp/repo",
-            reference: "1",
-          }),
-        ),
-      );
-      assert.equal(resolvedPr.pullRequest.number, 1);
-
-      const prepared = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[WS_METHODS.gitPreparePullRequestThread]({
-            cwd: "/tmp/repo",
-            reference: "1",
-            mode: "local",
-          }),
-        ),
-      );
-      assert.equal(prepared.branch, "feature/demo");
-
-      const refs = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) => client[WS_METHODS.vcsListRefs]({ cwd: "/tmp/repo" })),
-      );
-      assert.equal(refs.refs[0]?.name, "main");
-
-      const worktree = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[WS_METHODS.vcsCreateWorktree]({
-            cwd: "/tmp/repo",
-            refName: "main",
-            path: null,
-          }),
-        ),
-      );
-      assert.equal(worktree.worktree.refName, "feature/demo");
-
-      yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[WS_METHODS.vcsRemoveWorktree]({
-            cwd: "/tmp/repo",
-            path: "/tmp/wt",
-          }),
-        ),
-      );
-
-      yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[WS_METHODS.vcsCreateRef]({
-            cwd: "/tmp/repo",
-            refName: "feature/new",
-          }),
-        ),
-      );
-
-      yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[WS_METHODS.vcsSwitchRef]({
-            cwd: "/tmp/repo",
-            refName: "main",
-          }),
-        ),
-      );
-
-      yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[WS_METHODS.vcsInit]({
-            cwd: "/tmp/repo",
-          }),
-        ),
-      );
-
-      const diffPreview = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[WS_METHODS.reviewGetDiffPreview]({ cwd: "/tmp/repo" }),
-        ),
-      );
-      assert.equal(diffPreview.sources[0]?.diff, "dirty-diff");
-
-      const diffFileContents = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[WS_METHODS.reviewGetDiffFileContents]({
-            cwd: "/tmp/repo",
-            sourceKind: "working-tree",
-            changeType: "change",
-            baseRef: "HEAD",
-            headRef: null,
-            oldPath: "README.md",
-            newPath: "README.md",
-          }),
-        ),
-      );
-      assert.equal(diffFileContents.oldContents, "before\n");
-      assert.equal(diffFileContents.newContents, "after\n");
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("routes websocket rpc git.pull errors", () =>
-    Effect.gen(function* () {
-      const gitError = new GitCommandError({
-        operation: "pull",
-        command: "git pull --ff-only",
-        cwd: "/tmp/repo",
-        detail: "upstream missing",
-      });
-      let invalidationCalls = 0;
-      let statusCalls = 0;
-      yield* buildAppUnderTest({
-        layers: {
-          gitVcsDriver: {
-            pullCurrentBranch: () => Effect.fail(gitError),
-          },
-          gitManager: {
-            invalidateLocalStatus: () =>
-              Effect.sync(() => {
-                invalidationCalls += 1;
-              }),
-            invalidateRemoteStatus: () =>
-              Effect.sync(() => {
-                invalidationCalls += 1;
-              }),
-            invalidateStatus: () =>
-              Effect.sync(() => {
-                invalidationCalls += 1;
-              }),
-            localStatus: () =>
-              Effect.succeed({
-                isRepo: true,
-                hasPrimaryRemote: true,
-                isDefaultRef: true,
-                refName: "main",
-                hasWorkingTreeChanges: true,
-                workingTree: { files: [], insertions: 0, deletions: 0 },
-              }),
-            remoteStatus: () =>
-              Effect.sync(() => {
-                statusCalls += 1;
-                return {
-                  hasUpstream: true,
-                  aheadCount: 0,
-                  behindCount: 0,
-                  pr: null,
-                };
-              }),
-            status: () =>
-              Effect.sync(() => {
-                statusCalls += 1;
-                return {
-                  isRepo: true,
-                  hasPrimaryRemote: true,
-                  isDefaultRef: true,
-                  refName: "main",
-                  hasWorkingTreeChanges: true,
-                  workingTree: { files: [], insertions: 0, deletions: 0 },
-                  hasUpstream: true,
-                  aheadCount: 0,
-                  behindCount: 0,
-                  pr: null,
-                };
-              }),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const result = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) => client[WS_METHODS.vcsPull]({ cwd: "/tmp/repo" })).pipe(
-          Effect.result,
-        ),
-      );
-
-      assertFailure(result, gitError);
-      assert.equal(invalidationCalls, 0);
-      assert.equal(statusCalls, 0);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("routes websocket rpc git.runStackedAction errors after refreshing git status", () =>
-    Effect.gen(function* () {
-      const gitError = new GitCommandError({
-        operation: "commit",
-        command: "git commit",
-        cwd: "/tmp/repo",
-        detail: "nothing to commit",
-      });
-      let invalidationCalls = 0;
-      let statusCalls = 0;
-      yield* buildAppUnderTest({
-        layers: {
-          gitManager: {
-            invalidateLocalStatus: () =>
-              Effect.sync(() => {
-                invalidationCalls += 1;
-              }),
-            invalidateRemoteStatus: () =>
-              Effect.sync(() => {
-                invalidationCalls += 1;
-              }),
-            invalidateStatus: () =>
-              Effect.sync(() => {
-                invalidationCalls += 1;
-              }),
-            localStatus: () =>
-              Effect.succeed({
-                isRepo: true,
-                hasPrimaryRemote: true,
-                isDefaultRef: false,
-                refName: "feature/demo",
-                hasWorkingTreeChanges: true,
-                workingTree: { files: [], insertions: 0, deletions: 0 },
-              }),
-            remoteStatus: () =>
-              Effect.sync(() => {
-                statusCalls += 1;
-                return {
-                  hasUpstream: true,
-                  aheadCount: 0,
-                  behindCount: 0,
-                  pr: null,
-                };
-              }),
-            status: () =>
-              Effect.sync(() => {
-                statusCalls += 1;
-                return {
-                  isRepo: true,
-                  hasPrimaryRemote: true,
-                  isDefaultRef: false,
-                  refName: "feature/demo",
-                  hasWorkingTreeChanges: true,
-                  workingTree: { files: [], insertions: 0, deletions: 0 },
-                  hasUpstream: true,
-                  aheadCount: 0,
-                  behindCount: 0,
-                  pr: null,
-                };
-              }),
-            runStackedAction: () => Effect.fail(gitError),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const result = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[WS_METHODS.gitRunStackedAction]({
-            actionId: "action-1",
-            cwd: "/tmp/repo",
-            action: "commit",
-          }).pipe(Stream.runCollect, Effect.result),
-        ),
-      );
-
-      assertFailure(result, gitError);
-      assert.equal(invalidationCalls, 0);
-      assert.equal(statusCalls, 0);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("completes websocket rpc git.pull before background git status refresh finishes", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest({
-        layers: {
-          gitVcsDriver: {
-            pullCurrentBranch: () =>
-              Effect.succeed({
-                status: "pulled" as const,
-                refName: "main",
-                upstreamRef: "origin/main",
-              }),
-          },
-          gitManager: {
-            invalidateLocalStatus: () => Effect.void,
-            invalidateRemoteStatus: () => Effect.void,
-            invalidateStatus: () => Effect.void,
-            localStatus: () =>
-              Effect.succeed({
-                isRepo: true,
-                hasPrimaryRemote: true,
-                isDefaultRef: true,
-                refName: "main",
-                hasWorkingTreeChanges: false,
-                workingTree: { files: [], insertions: 0, deletions: 0 },
-              }),
-            remoteStatus: () =>
-              Effect.sleep(Duration.seconds(2)).pipe(
-                Effect.as({
-                  hasUpstream: true,
-                  aheadCount: 0,
-                  behindCount: 0,
-                  pr: null,
-                }),
-              ),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const startedAt = yield* Clock.currentTimeMillis;
-      const result = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) => client[WS_METHODS.vcsPull]({ cwd: "/tmp/repo" })),
-      );
-      const elapsedMs = (yield* Clock.currentTimeMillis) - startedAt;
-
-      assert.equal(result.status, "pulled");
-      assertTrue(elapsedMs < 1_000);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect(
-    "completes websocket rpc git.runStackedAction before background git status refresh finishes",
-    () =>
-      Effect.gen(function* () {
-        yield* buildAppUnderTest({
-          layers: {
-            vcsDriver: {
-              isInsideWorkTree: () => Effect.succeed(true),
-            },
-            gitManager: {
-              invalidateLocalStatus: () => Effect.void,
-              invalidateRemoteStatus: () => Effect.void,
-              invalidateStatus: () => Effect.void,
-              localStatus: () =>
-                Effect.succeed({
-                  isRepo: true,
-                  hasPrimaryRemote: true,
-                  isDefaultRef: false,
-                  refName: "feature/demo",
-                  hasWorkingTreeChanges: false,
-                  workingTree: { files: [], insertions: 0, deletions: 0 },
-                }),
-              remoteStatus: () =>
-                Effect.sleep(Duration.seconds(2)).pipe(
-                  Effect.as({
-                    hasUpstream: true,
-                    aheadCount: 0,
-                    behindCount: 0,
-                    pr: null,
-                  }),
-                ),
-              runStackedAction: () =>
-                Effect.succeed({
-                  action: "commit" as const,
-                  branch: { status: "skipped_not_requested" as const },
-                  commit: {
-                    status: "created" as const,
-                    commitSha: "abc123",
-                    subject: "feat: demo",
-                  },
-                  push: { status: "skipped_not_requested" as const },
-                  pr: { status: "skipped_not_requested" as const },
-                  toast: {
-                    title: "Committed abc123",
-                    description: "feat: demo",
-                    cta: {
-                      kind: "run_action" as const,
-                      label: "Push",
-                      action: {
-                        kind: "push" as const,
-                      },
-                    },
-                  },
-                }),
-            },
-          },
-        });
-
-        const wsUrl = yield* getWsServerUrl("/ws");
-        const startedAt = yield* Clock.currentTimeMillis;
-        yield* Effect.scoped(
-          withWsRpcClient(wsUrl, (client) =>
-            client[WS_METHODS.gitRunStackedAction]({
-              actionId: "action-1",
-              cwd: "/tmp/repo",
-              action: "commit",
-            }).pipe(Stream.runCollect),
-          ),
-        );
-        const elapsedMs = (yield* Clock.currentTimeMillis) - startedAt;
-
-        assertTrue(elapsedMs < 1_000);
-      }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect(
-    "starts a background local git status refresh after a successful git.runStackedAction",
-    () =>
-      Effect.gen(function* () {
-        const localRefreshStarted = yield* Deferred.make<void>();
-
-        yield* buildAppUnderTest({
-          layers: {
-            vcsDriver: {
-              isInsideWorkTree: () => Effect.succeed(true),
-            },
-            gitManager: {
-              invalidateLocalStatus: () => Effect.void,
-              invalidateRemoteStatus: () => Effect.void,
-              invalidateStatus: () => Effect.void,
-              localStatus: () =>
-                Deferred.succeed(localRefreshStarted, undefined).pipe(
-                  Effect.ignore,
-                  Effect.andThen(
-                    Effect.succeed({
-                      isRepo: true,
-                      hasPrimaryRemote: true,
-                      isDefaultRef: false,
-                      refName: "feature/demo",
-                      hasWorkingTreeChanges: false,
-                      workingTree: { files: [], insertions: 0, deletions: 0 },
-                    }),
-                  ),
-                ),
-              remoteStatus: () =>
-                Effect.sleep(Duration.seconds(2)).pipe(
-                  Effect.as({
-                    hasUpstream: true,
-                    aheadCount: 0,
-                    behindCount: 0,
-                    pr: null,
-                  }),
-                ),
-              runStackedAction: () =>
-                Effect.succeed({
-                  action: "commit" as const,
-                  branch: { status: "skipped_not_requested" as const },
-                  commit: {
-                    status: "created" as const,
-                    commitSha: "abc123",
-                    subject: "feat: demo",
-                  },
-                  push: { status: "skipped_not_requested" as const },
-                  pr: { status: "skipped_not_requested" as const },
-                  toast: {
-                    title: "Committed abc123",
-                    description: "feat: demo",
-                    cta: {
-                      kind: "run_action" as const,
-                      label: "Push",
-                      action: {
-                        kind: "push" as const,
-                      },
-                    },
-                  },
-                }),
-            },
-          },
-        });
-
-        const wsUrl = yield* getWsServerUrl("/ws");
-        yield* Effect.scoped(
-          withWsRpcClient(wsUrl, (client) =>
-            client[WS_METHODS.gitRunStackedAction]({
-              actionId: "action-1",
-              cwd: "/tmp/repo",
-              action: "commit",
-            }).pipe(Stream.runCollect),
-          ),
-        );
-
-        yield* Deferred.await(localRefreshStarted);
-      }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("routes websocket rpc orchestration methods", () =>
-    Effect.gen(function* () {
-      const now = "2026-01-01T00:00:00.000Z";
-      const snapshot = {
-        snapshotSequence: 1,
-        updatedAt: now,
-        projects: [
-          {
-            id: ProjectId.make("project-a"),
-            title: "Project A",
-            workspaceRoot: "/tmp/project-a",
-            defaultModelSelection,
-            scripts: [],
-            createdAt: now,
-            updatedAt: now,
-            deletedAt: null,
-          },
-        ],
-        threads: [
-          {
-            id: ThreadId.make("thread-1"),
-            projectId: ProjectId.make("project-a"),
-            title: "Thread A",
-            modelSelection: defaultModelSelection,
-            interactionMode: "default" as const,
-            runtimeMode: "full-access" as const,
-            branch: null,
-            worktreePath: null,
-            createdAt: now,
-            updatedAt: now,
-            archivedAt: null,
-            settledOverride: null,
-            settledAt: null,
-            latestTurn: null,
-            messages: [],
-            session: null,
-            activities: [],
-            proposedPlans: [],
-            checkpoints: [],
-            deletedAt: null,
-          },
-        ],
-      };
-
-      yield* buildAppUnderTest({
-        layers: {
-          projectionSnapshotQuery: {
-            getSnapshot: () => Effect.succeed(snapshot),
-            searchThreads: () =>
-              Effect.succeed({
-                matches: [
-                  {
-                    threadId: ThreadId.make("thread-1"),
-                    projectId: ProjectId.make("project-a"),
-                    source: "assistant",
-                    snippet: "Search reached the final response.",
-                    messageCreatedAt: now,
-                  },
-                ],
-              }),
-          },
-          orchestrationEngine: {
-            dispatch: () => Effect.succeed({ sequence: 7 }),
-            readEvents: () => Stream.empty,
-          },
-          checkpointDiffQuery: {
-            getTurnDiff: () =>
-              Effect.succeed({
-                threadId: ThreadId.make("thread-1"),
-                fromTurnCount: 0,
-                toTurnCount: 1,
-                diff: "turn-diff",
-              }),
-            getFullThreadDiff: () =>
-              Effect.succeed({
-                threadId: ThreadId.make("thread-1"),
-                fromTurnCount: 0,
-                toTurnCount: 1,
-                diff: "full-diff",
-              }),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const dispatchResult = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[ORCHESTRATION_WS_METHODS.dispatchCommand]({
-            type: "thread.session.stop",
-            commandId: CommandId.make("cmd-1"),
-            threadId: ThreadId.make("thread-1"),
-            createdAt: now,
-          }),
-        ),
-      );
-      assert.equal(dispatchResult.sequence, 7);
-
-      const turnDiffResult = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[ORCHESTRATION_WS_METHODS.getTurnDiff]({
-            threadId: ThreadId.make("thread-1"),
-            fromTurnCount: 0,
-            toTurnCount: 1,
-          }),
-        ),
-      );
-      assert.equal(turnDiffResult.diff, "turn-diff");
-
-      const fullDiffResult = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[ORCHESTRATION_WS_METHODS.getFullThreadDiff]({
-            threadId: ThreadId.make("thread-1"),
-            toTurnCount: 1,
-          }),
-        ),
-      );
-      assert.equal(fullDiffResult.diff, "full-diff");
-
-      const searchResult = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[ORCHESTRATION_WS_METHODS.searchThreads]({
-            query: "final response",
-          }),
-        ),
-      );
-      assert.deepEqual(searchResult.matches, [
-        {
-          threadId: ThreadId.make("thread-1"),
-          projectId: ProjectId.make("project-a"),
-          source: "assistant",
-          snippet: "Search reached the final response.",
-          messageCreatedAt: now,
-        },
-      ]);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("routes websocket rpc orchestration shell snapshot errors", () =>
-    Effect.gen(function* () {
-      const projectionError = new PersistenceSqlError({
-        operation: "ProjectionSnapshotQuery.getShellSnapshot:test",
-        detail: "failed to read projection shell snapshot",
-      });
-      yield* buildAppUnderTest({
-        layers: {
-          projectionSnapshotQuery: {
-            getShellSnapshot: () => Effect.fail(projectionError),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const result = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[ORCHESTRATION_WS_METHODS.subscribeShell]({}).pipe(Stream.runCollect),
-        ).pipe(Effect.result),
-      );
-
-      assertTrue(result._tag === "Failure");
-      assertTrue(result.failure._tag === "OrchestrationGetSnapshotError");
-      assertTrue(result.failure.cause instanceof Error);
-      assert.include(result.failure.cause.message, projectionError.message);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("marks an empty shell catch-up replay as synchronized when requested", () =>
-    Effect.gen(function* () {
-      yield* buildAppUnderTest({
-        layers: {
-          orchestrationEngine: {
-            readEvents: () => Stream.empty,
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const firstItem = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[ORCHESTRATION_WS_METHODS.subscribeShell]({
-            afterSequence: 0,
-            requestCompletionMarker: true,
-          }).pipe(Stream.runHead),
-        ),
-      );
-
-      assert.deepEqual(Option.getOrThrow(firstItem), { kind: "synchronized" });
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("marks a socket thread snapshot as synchronized when requested", () =>
-    Effect.gen(function* () {
-      const thread = makeDefaultOrchestrationReadModel().threads[0]!;
-      yield* buildAppUnderTest({
-        layers: {
-          projectionSnapshotQuery: {
-            getThreadDetailSnapshot: () =>
-              Effect.succeed(Option.some({ snapshotSequence: 1, thread })),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const items = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[ORCHESTRATION_WS_METHODS.subscribeThread]({
-            threadId: defaultThreadId,
-            requestCompletionMarker: true,
-          }).pipe(Stream.take(2), Stream.runCollect),
-        ),
-      );
-
-      assert.equal(items[0]?.kind, "snapshot");
-      assert.deepEqual(items[1], { kind: "synchronized" });
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("buffers shell events published while the fallback snapshot loads", () =>
-    Effect.gen(function* () {
-      const liveEvents = yield* PubSub.unbounded<OrchestrationEvent>();
-      const deletedEvent = {
-        sequence: 2,
-        eventId: EventId.make("event-shell-thread-deleted"),
-        aggregateKind: "thread",
-        aggregateId: defaultThreadId,
-        occurredAt: "2026-01-01T00:00:01.000Z",
-        commandId: null,
-        causationEventId: null,
-        correlationId: null,
-        metadata: {},
-        type: "thread.deleted",
-        payload: {
-          threadId: defaultThreadId,
-          deletedAt: "2026-01-01T00:00:01.000Z",
-        },
-      } satisfies Extract<OrchestrationEvent, { type: "thread.deleted" }>;
-
-      yield* buildAppUnderTest({
-        layers: {
-          orchestrationEngine: {
-            streamDomainEvents: Stream.fromPubSub(liveEvents),
-          },
-          projectionSnapshotQuery: {
-            getShellSnapshot: () =>
-              Effect.gen(function* () {
-                yield* PubSub.publish(liveEvents, deletedEvent);
-                return {
-                  snapshotSequence: 1,
-                  projects: [],
-                  threads: [makeDefaultOrchestrationThreadShell()],
-                  updatedAt: "2026-01-01T00:00:00.000Z",
-                };
-              }),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const items = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[ORCHESTRATION_WS_METHODS.subscribeShell]({
-            requestCompletionMarker: true,
-          }).pipe(Stream.take(3), Stream.runCollect),
-        ),
-      ).pipe(Effect.timeout("2 seconds"));
-
-      assert.equal(items[0]?.kind, "snapshot");
-      assert.equal(items[1]?.kind, "thread-removed");
-      assert.deepEqual(items[2], { kind: "synchronized" });
-    }).pipe(Effect.provide(NodeHttpServer.layerTest), TestClock.withLive),
-  );
-
-  it.effect("buffers thread events published while the initial snapshot loads", () =>
-    Effect.gen(function* () {
-      const thread = makeDefaultOrchestrationReadModel().threads[0]!;
-      const liveEvents = yield* PubSub.unbounded<OrchestrationEvent>();
-      const messageEvent = {
-        sequence: 2,
-        eventId: EventId.make("event-message"),
-        aggregateKind: "thread",
-        aggregateId: defaultThreadId,
-        occurredAt: "2026-01-01T00:00:01.000Z",
-        commandId: null,
-        causationEventId: null,
-        correlationId: null,
-        metadata: {},
-        type: "thread.message-sent",
-        payload: {
-          threadId: defaultThreadId,
-          messageId: MessageId.make("message-1"),
-          role: "user",
-          text: "First message",
-          turnId: null,
-          streaming: false,
-          createdAt: "2026-01-01T00:00:01.000Z",
-          updatedAt: "2026-01-01T00:00:01.000Z",
-        },
-      } satisfies Extract<OrchestrationEvent, { type: "thread.message-sent" }>;
-
-      yield* buildAppUnderTest({
-        layers: {
-          orchestrationEngine: {
-            streamDomainEvents: Stream.fromPubSub(liveEvents),
-          },
-          projectionSnapshotQuery: {
-            getThreadDetailSnapshot: () =>
-              Effect.gen(function* () {
-                yield* Effect.sleep("25 millis");
-                yield* PubSub.publish(liveEvents, messageEvent);
-                return Option.some({ snapshotSequence: 1, thread });
-              }),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const items = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[ORCHESTRATION_WS_METHODS.subscribeThread]({
-            threadId: defaultThreadId,
-          }).pipe(Stream.take(2), Stream.runCollect),
-        ),
-      ).pipe(Effect.timeout("2 seconds"));
-
-      assert.equal(items[0]?.kind, "snapshot");
-      assert.equal(items[1]?.kind, "event");
-      assert.equal(items[1]?.kind === "event" ? items[1].event.sequence : null, 2);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest), TestClock.withLive),
-  );
-
-  it.effect("subscribeThread sends a fresh snapshot instead of replaying a large gap", () =>
-    Effect.gen(function* () {
-      let readEventsCalls = 0;
-      const thread = makeDefaultOrchestrationReadModel().threads[0]!;
-
-      yield* buildAppUnderTest({
-        layers: {
-          orchestrationEngine: {
-            // Head is far ahead of the client's afterSequence (gap > 1000).
-            latestSequence: Effect.succeed(100_000),
-            readEvents: () =>
-              Stream.sync(() => {
-                readEventsCalls += 1;
-                return {} as OrchestrationEvent;
-              }),
-          },
-          projectionSnapshotQuery: {
-            getThreadDetailSnapshot: () =>
-              Effect.succeed(Option.some({ snapshotSequence: 100_000, thread })),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const items = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[ORCHESTRATION_WS_METHODS.subscribeThread]({
-            threadId: defaultThreadId,
-            afterSequence: 5,
-            requestCompletionMarker: true,
-          }).pipe(Stream.take(2), Stream.runCollect),
-        ),
-      );
-
-      const [first, second] = Array.from(items);
-      // Large gap => fresh thread snapshot, and the global replay never starts.
-      assert.equal(first?.kind, "snapshot");
-      if (first?.kind === "snapshot") {
-        assert.equal(first.snapshot.thread.id, defaultThreadId);
-        assert.equal(first.snapshot.snapshotSequence, 100_000);
-      }
-      assert.equal(second?.kind, "synchronized");
-      assert.equal(readEventsCalls, 0);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("subscribeThread replaces a cursor ahead of the authoritative head", () =>
-    Effect.gen(function* () {
-      let readEventsCalls = 0;
-      const thread = makeDefaultOrchestrationReadModel().threads[0]!;
-
-      yield* buildAppUnderTest({
-        layers: {
-          orchestrationEngine: {
-            latestSequence: Effect.succeed(5),
-            readEvents: () =>
-              Stream.sync(() => {
-                readEventsCalls += 1;
-                return {} as OrchestrationEvent;
-              }),
-          },
-          projectionSnapshotQuery: {
-            getThreadDetailSnapshot: () =>
-              Effect.succeed(Option.some({ snapshotSequence: 5, thread })),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const first = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[ORCHESTRATION_WS_METHODS.subscribeThread]({
-            threadId: defaultThreadId,
-            afterSequence: 10,
-          }).pipe(Stream.runHead),
-        ),
-      );
-
-      assert.equal(Option.getOrThrow(first).kind, "snapshot");
-      assert.equal(readEventsCalls, 0);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("subscribeThread bounds catch-up replay to the captured head", () =>
-    Effect.gen(function* () {
-      let replayLimit: number | undefined;
-      const now = "2026-01-01T00:00:00.000Z";
-      const messageEvent = {
-        sequence: 3,
-        eventId: EventId.make("event-replay-message"),
-        aggregateKind: "thread",
-        aggregateId: defaultThreadId,
-        occurredAt: now,
-        commandId: null,
-        causationEventId: null,
-        correlationId: null,
-        metadata: {},
-        type: "thread.message-sent",
-        payload: {
-          threadId: defaultThreadId,
-          messageId: MessageId.make("message-replay"),
-          role: "user",
-          text: "Replayed message",
-          turnId: null,
-          streaming: false,
-          createdAt: now,
-          updatedAt: now,
-        },
-      } satisfies Extract<OrchestrationEvent, { type: "thread.message-sent" }>;
-
-      yield* buildAppUnderTest({
-        layers: {
-          orchestrationEngine: {
-            latestSequence: Effect.succeed(50),
-            readEvents: (_afterSequence, limit) => {
-              replayLimit = limit;
-              return Stream.make(messageEvent);
-            },
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const items = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[ORCHESTRATION_WS_METHODS.subscribeThread]({
-            threadId: defaultThreadId,
-            afterSequence: 0,
-            requestCompletionMarker: true,
-          }).pipe(Stream.take(2), Stream.runCollect),
-        ),
-      );
-
-      const [first, second] = Array.from(items);
-      assert.equal(first?.kind, "event");
-      assert.equal(first?.kind === "event" ? first.event.sequence : null, 3);
-      assert.equal(second?.kind, "synchronized");
-      // The replay is bounded to the head captured before the read, not
-      // Number.MAX_SAFE_INTEGER.
-      assert.equal(replayLimit, 50);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("subscribeShell sends a fresh snapshot instead of replaying a large gap", () =>
-    Effect.gen(function* () {
-      let readEventsCalls = 0;
-      const snapshotThreadId = ThreadId.make("thread-from-snapshot");
-      const now = "2026-01-01T00:00:00.000Z";
-
-      yield* buildAppUnderTest({
-        layers: {
-          orchestrationEngine: {
-            // Head is far ahead of the client's afterSequence (gap > 1000).
-            latestSequence: Effect.succeed(100_000),
-            readEvents: () =>
-              Stream.sync(() => {
-                readEventsCalls += 1;
-                return {
-                  sequence: 1,
-                  eventId: EventId.make("event-should-not-be-read"),
-                  aggregateKind: "thread",
-                  aggregateId: snapshotThreadId,
-                  occurredAt: now,
-                  commandId: null,
-                  causationEventId: null,
-                  correlationId: null,
-                  metadata: {},
-                  type: "thread.created",
-                  payload: {} as never,
-                } satisfies OrchestrationEvent;
-              }),
-          },
-          projectionSnapshotQuery: {
-            getShellSnapshot: () =>
-              Effect.succeed({
-                snapshotSequence: 100_000,
-                projects: [],
-                threads: [makeDefaultOrchestrationThreadShell({ id: snapshotThreadId })],
-                updatedAt: now,
-              }),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const items = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[ORCHESTRATION_WS_METHODS.subscribeShell]({
-            afterSequence: 5,
-            requestCompletionMarker: true,
-          }).pipe(Stream.take(2), Stream.runCollect),
-        ),
-      );
-
-      const [first, second] = Array.from(items);
-      // Large gap => fresh snapshot, and the unbounded replay is never started.
-      assert.equal(first?.kind, "snapshot");
-      if (first?.kind === "snapshot") {
-        assert.equal(first.snapshot.threads[0]?.id, snapshotThreadId);
-      }
-      assert.equal(second?.kind, "synchronized");
-      assert.equal(readEventsCalls, 0);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("subscribeShell replaces a cursor ahead of the authoritative head", () =>
-    Effect.gen(function* () {
-      let readEventsCalls = 0;
-
-      yield* buildAppUnderTest({
-        layers: {
-          orchestrationEngine: {
-            latestSequence: Effect.succeed(5),
-            readEvents: () =>
-              Stream.sync(() => {
-                readEventsCalls += 1;
-                return {} as OrchestrationEvent;
-              }),
-          },
-          projectionSnapshotQuery: {
-            getShellSnapshot: () =>
-              Effect.succeed({
-                snapshotSequence: 5,
-                projects: [],
-                threads: [],
-                updatedAt: "2026-01-01T00:00:00.000Z",
-              }),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const first = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[ORCHESTRATION_WS_METHODS.subscribeShell]({ afterSequence: 10 }).pipe(
-            Stream.runHead,
-          ),
-        ),
-      );
-
-      assert.equal(Option.getOrThrow(first).kind, "snapshot");
-      assert.equal(readEventsCalls, 0);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("subscribeShell coalesces a per-thread burst without stalling other threads", () =>
-    Effect.gen(function* () {
-      const busyThreadId = ThreadId.make("thread-busy");
-      const newThreadId = ThreadId.make("thread-new");
-      const now = "2026-01-01T00:00:00.000Z";
-      const shellFetches: Array<string> = [];
-      let replayLimit: number | undefined;
-
-      const messageEvent = (sequence: number): OrchestrationEvent =>
-        ({
-          sequence,
-          eventId: EventId.make(`event-${sequence}`),
-          aggregateKind: "thread",
-          aggregateId: busyThreadId,
-          occurredAt: now,
-          commandId: null,
-          causationEventId: null,
-          correlationId: null,
-          metadata: {},
-          type: "thread.message-sent",
-          payload: {} as never,
-        }) satisfies OrchestrationEvent;
-
-      const createdEvent: OrchestrationEvent = {
-        sequence: 50,
-        eventId: EventId.make("event-created"),
-        aggregateKind: "thread",
-        aggregateId: newThreadId,
-        occurredAt: now,
-        commandId: null,
-        causationEventId: null,
-        correlationId: null,
-        metadata: {},
-        type: "thread.created",
-        payload: {} as never,
-      };
-
-      yield* buildAppUnderTest({
-        layers: {
-          orchestrationEngine: {
-            latestSequence: Effect.succeed(50),
-            // A burst of message-sent deltas for the busy thread, plus one
-            // thread.created for a different thread, all within one batch.
-            readEvents: (_afterSequence, limit) => {
-              replayLimit = limit;
-              return Stream.fromIterable([
-                ...Array.from({ length: 20 }, (_unused, index) => messageEvent(index + 1)),
-                createdEvent,
-              ]);
-            },
-          },
-          projectionSnapshotQuery: {
-            getThreadShellById: (threadId) =>
-              Effect.sync(() => {
-                shellFetches.push(threadId);
-                return Option.some(makeDefaultOrchestrationThreadShell({ id: threadId }));
-              }),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const items = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[ORCHESTRATION_WS_METHODS.subscribeShell]({
-            afterSequence: 0,
-            requestCompletionMarker: true,
-          }).pipe(Stream.take(3), Stream.runCollect),
-        ),
-      );
-
-      const collected = Array.from(items);
-      const upsertedIds = collected.flatMap((item) =>
-        item.kind === "thread-upserted" ? [item.thread.id] : [],
-      );
-      // Both threads surface, and the busy thread's 20-event burst collapses to
-      // a single shell refetch (not 20). The new thread is not stuck behind it.
-      assert.include(upsertedIds, busyThreadId);
-      assert.include(upsertedIds, newThreadId);
-      assert.equal(collected[2]?.kind, "synchronized");
-      assert.equal(shellFetches.filter((id) => id === busyThreadId).length, 1);
-      assert.equal(replayLimit, 50);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("subscribeShell coalesces live bursts after the synchronization marker", () =>
-    Effect.gen(function* () {
-      const busyThreadId = ThreadId.make("thread-live-busy");
-      const newThreadId = ThreadId.make("thread-live-new");
-      const now = "2026-01-01T00:00:00.000Z";
-      const liveEvents = yield* PubSub.unbounded<OrchestrationEvent>();
-      const synchronized = yield* Deferred.make<void>();
-      const shellFetches: Array<string> = [];
-      const observedLiveThreadIds = new Set<string>();
-
-      const messageEvent = (sequence: number): OrchestrationEvent =>
-        ({
-          sequence,
-          eventId: EventId.make(`event-live-${sequence}`),
-          aggregateKind: "thread",
-          aggregateId: busyThreadId,
-          occurredAt: now,
-          commandId: null,
-          causationEventId: null,
-          correlationId: null,
-          metadata: {},
-          type: "thread.message-sent",
-          payload: {} as never,
-        }) satisfies OrchestrationEvent;
-
-      const createdEvent: OrchestrationEvent = {
-        sequence: 50,
-        eventId: EventId.make("event-live-created"),
-        aggregateKind: "thread",
-        aggregateId: newThreadId,
-        occurredAt: now,
-        commandId: null,
-        causationEventId: null,
-        correlationId: null,
-        metadata: {},
-        type: "thread.created",
-        payload: {} as never,
-      };
-
-      yield* buildAppUnderTest({
-        layers: {
-          orchestrationEngine: {
-            streamDomainEvents: Stream.fromPubSub(liveEvents),
-          },
-          projectionSnapshotQuery: {
-            getThreadShellById: (threadId) =>
-              Effect.sync(() => {
-                shellFetches.push(threadId);
-                return Option.some(makeDefaultOrchestrationThreadShell({ id: threadId }));
-              }),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const items = yield* Effect.scoped(
-        Effect.gen(function* () {
-          const itemsFiber = yield* withWsRpcClient(wsUrl, (client) =>
-            client[ORCHESTRATION_WS_METHODS.subscribeShell]({
-              requestCompletionMarker: true,
-            }).pipe(
-              Stream.tap((item) =>
-                item.kind === "synchronized"
-                  ? Deferred.succeed(synchronized, undefined).pipe(Effect.ignore)
-                  : Effect.void,
-              ),
-              Stream.takeUntil((item) => {
-                if (item.kind === "thread-upserted") {
-                  observedLiveThreadIds.add(item.thread.id);
-                }
-                return (
-                  observedLiveThreadIds.has(busyThreadId) && observedLiveThreadIds.has(newThreadId)
-                );
-              }),
-              Stream.runCollect,
-            ),
-          ).pipe(Effect.forkScoped);
-
-          yield* Deferred.await(synchronized);
-          for (const event of [
-            ...Array.from({ length: 20 }, (_unused, index) => messageEvent(index + 1)),
-            createdEvent,
-          ]) {
-            yield* PubSub.publish(liveEvents, event);
-          }
-
-          return yield* Fiber.join(itemsFiber);
-        }),
-      ).pipe(Effect.timeout("2 seconds"));
-
-      assert.equal(items[0]?.kind, "snapshot");
-      assert.equal(items[1]?.kind, "synchronized");
-      const liveUpsertedIds = Array.from(items)
-        .slice(2)
-        .flatMap((item) => (item.kind === "thread-upserted" ? [item.thread.id] : []));
-      assert.include(liveUpsertedIds, busyThreadId);
-      assert.include(liveUpsertedIds, newThreadId);
-      assert.isBelow(shellFetches.filter((id) => id === busyThreadId).length, 20);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest), TestClock.withLive),
-  );
-
-  it.effect("subscribeShell coalescing still emits a removal for a deleted thread", () =>
-    Effect.gen(function* () {
-      const goneThreadId = ThreadId.make("thread-gone");
-      const now = "2026-01-01T00:00:00.000Z";
-
-      const makeThreadEvent = (
-        sequence: number,
-        type: "thread.deleted" | "thread.message-sent",
-      ): OrchestrationEvent =>
-        ({
-          sequence,
-          eventId: EventId.make(`event-${sequence}`),
-          aggregateKind: "thread",
-          aggregateId: goneThreadId,
-          occurredAt: now,
-          commandId: null,
-          causationEventId: null,
-          correlationId: null,
-          metadata: {},
-          type,
-          payload: type === "thread.deleted" ? { threadId: goneThreadId, deletedAt: now } : {},
-        }) as OrchestrationEvent;
-
-      yield* buildAppUnderTest({
-        layers: {
-          orchestrationEngine: {
-            latestSequence: Effect.succeed(2),
-            // A thread.deleted followed, within the same coalescing window, by a
-            // later refetchable event for the same thread. The later event wins
-            // coalescing; its shell refetch returns none (the row is gone), which
-            // must still surface a removal rather than be swallowed.
-            readEvents: () =>
-              Stream.fromIterable([
-                makeThreadEvent(1, "thread.deleted"),
-                makeThreadEvent(2, "thread.message-sent"),
-              ]),
-          },
-          projectionSnapshotQuery: {
-            getThreadShellById: () => Effect.succeed(Option.none()),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const items = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[ORCHESTRATION_WS_METHODS.subscribeShell]({ afterSequence: 0 }).pipe(
-            Stream.take(1),
-            Stream.runCollect,
-          ),
-        ),
-      );
-
-      const [first] = Array.from(items);
-      assert.equal(first?.kind, "thread-removed");
-      assert.equal(first?.kind === "thread-removed" ? first.threadId : null, goneThreadId);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("subscribeShell retries a transient shell projection refetch failure", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("thread-transient-refetch");
-      const now = "2026-01-01T00:00:00.000Z";
-      let attempts = 0;
-
-      const event: OrchestrationEvent = {
-        sequence: 1,
-        eventId: EventId.make("event-transient-refetch"),
-        aggregateKind: "thread",
-        aggregateId: threadId,
-        occurredAt: now,
-        commandId: null,
-        causationEventId: null,
-        correlationId: null,
-        metadata: {},
-        type: "thread.message-sent",
-        payload: {} as never,
-      };
-
-      yield* buildAppUnderTest({
-        layers: {
-          orchestrationEngine: {
-            latestSequence: Effect.succeed(1),
-            readEvents: () => Stream.make(event),
-          },
-          projectionSnapshotQuery: {
-            getThreadShellById: () =>
-              Effect.suspend(() => {
-                attempts += 1;
-                return attempts === 1
-                  ? Effect.fail(
-                      new PersistenceSqlError({
-                        operation: "test.shell-refetch",
-                        detail: "transient failure",
-                      }),
-                    )
-                  : Effect.succeed(
-                      Option.some(makeDefaultOrchestrationThreadShell({ id: threadId })),
-                    );
-              }),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const items = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[ORCHESTRATION_WS_METHODS.subscribeShell]({ afterSequence: 0 }).pipe(
-            Stream.take(1),
-            Stream.runCollect,
-          ),
-        ),
-      );
-
-      const [first] = Array.from(items);
-      assert.equal(first?.kind, "thread-upserted");
-      assert.equal(first?.kind === "thread-upserted" ? first.thread.id : null, threadId);
-      assert.equal(attempts, 2);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("subscribeShell coalescing still removes a project after a trailing update", () =>
-    Effect.gen(function* () {
-      const projectId = ProjectId.make("project-gone");
-      const now = "2026-01-01T00:00:00.000Z";
-
-      const makeProjectEvent = (
-        sequence: number,
-        type: "project.deleted" | "project.meta-updated",
-      ): OrchestrationEvent =>
-        ({
-          sequence,
-          eventId: EventId.make(`event-project-${sequence}`),
-          aggregateKind: "project",
-          aggregateId: projectId,
-          occurredAt: now,
-          commandId: null,
-          causationEventId: null,
-          correlationId: null,
-          metadata: {},
-          type,
-          payload:
-            type === "project.deleted"
-              ? { projectId, deletedAt: now }
-              : { projectId, title: "Still deleted", updatedAt: now },
-        }) as OrchestrationEvent;
-
-      yield* buildAppUnderTest({
-        layers: {
-          orchestrationEngine: {
-            latestSequence: Effect.succeed(2),
-            readEvents: () =>
-              Stream.fromIterable([
-                makeProjectEvent(1, "project.deleted"),
-                makeProjectEvent(2, "project.meta-updated"),
-              ]),
-          },
-          projectionSnapshotQuery: {
-            getProjectShellById: () => Effect.succeed(Option.none()),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const items = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[ORCHESTRATION_WS_METHODS.subscribeShell]({ afterSequence: 0 }).pipe(
-            Stream.take(1),
-            Stream.runCollect,
-          ),
-        ),
-      );
-
-      const [first] = Array.from(items);
-      assert.equal(first?.kind, "project-removed");
-      assert.equal(first?.kind === "project-removed" ? first.projectId : null, projectId);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("stops the provider session and closes thread terminals after archive", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("thread-archive");
-      const effects: string[] = [];
-      const dispatchedCommands: Array<OrchestrationCommand> = [];
-      const now = "2026-01-01T00:00:00.000Z";
-
-      yield* buildAppUnderTest({
-        layers: {
-          terminalManager: {
-            close: (input) =>
-              Effect.sync(() => {
-                effects.push(`terminal.close:${input.threadId}`);
-              }),
-          },
-          orchestrationEngine: {
-            dispatch: (command) =>
-              Effect.sync(() => {
-                dispatchedCommands.push(command);
-                effects.push(`dispatch:${command.type}`);
-                return { sequence: dispatchedCommands.length };
-              }),
-          },
-          projectionSnapshotQuery: {
-            getThreadShellById: () =>
-              Effect.succeed(
-                Option.some(
-                  makeDefaultOrchestrationThreadShell({
-                    id: threadId,
-                    updatedAt: now,
-                    session: {
-                      threadId,
-                      status: "ready",
-                      providerName: "claudeAgent",
-                      runtimeMode: "full-access",
-                      activeTurnId: null,
-                      lastError: null,
-                      updatedAt: now,
-                    },
-                  }),
-                ),
-              ),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const dispatchResult = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[ORCHESTRATION_WS_METHODS.dispatchCommand]({
-            type: "thread.archive",
-            commandId: CommandId.make("cmd-thread-archive"),
-            threadId,
-          }),
-        ),
-      );
-
-      assert.equal(dispatchResult.sequence, 1);
-      assert.deepEqual(effects, [
-        "dispatch:thread.archive",
-        "dispatch:thread.session.stop",
-        `terminal.close:${threadId}`,
-      ]);
-      const sessionStopCommand = dispatchedCommands[1];
-      assert.equal(sessionStopCommand?.type, "thread.session.stop");
-      if (sessionStopCommand?.type === "thread.session.stop") {
-        assert.equal(sessionStopCommand.threadId, threadId);
-      }
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("checks session status before archiving removes the thread from active lookups", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("thread-archive-precheck");
-      const effects: string[] = [];
-      const dispatchedCommands: Array<OrchestrationCommand> = [];
-      const now = "2026-01-01T00:00:00.000Z";
-      let archived = false;
-
-      yield* buildAppUnderTest({
-        layers: {
-          terminalManager: {
-            close: (input) =>
-              Effect.sync(() => {
-                effects.push(`terminal.close:${input.threadId}`);
-              }),
-          },
-          orchestrationEngine: {
-            dispatch: (command) =>
-              Effect.sync(() => {
-                dispatchedCommands.push(command);
-                effects.push(`dispatch:${command.type}`);
-                if (command.type === "thread.archive") {
-                  archived = true;
-                }
-                return { sequence: dispatchedCommands.length };
-              }),
-          },
-          projectionSnapshotQuery: {
-            getThreadShellById: () =>
-              Effect.sync(() => {
-                effects.push(`query:thread-shell:${archived ? "archived" : "active"}`);
-                return archived
-                  ? Option.none()
-                  : Option.some(
-                      makeDefaultOrchestrationThreadShell({
-                        id: threadId,
-                        updatedAt: now,
-                        session: {
-                          threadId,
-                          status: "ready",
-                          providerName: "claudeAgent",
-                          runtimeMode: "full-access",
-                          activeTurnId: null,
-                          lastError: null,
-                          updatedAt: now,
-                        },
-                      }),
-                    );
-              }),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const dispatchResult = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[ORCHESTRATION_WS_METHODS.dispatchCommand]({
-            type: "thread.archive",
-            commandId: CommandId.make("cmd-thread-archive-precheck"),
-            threadId,
-          }),
-        ),
-      );
-
-      assert.equal(dispatchResult.sequence, 1);
-      assert.deepEqual(effects, [
-        "query:thread-shell:active",
-        "dispatch:thread.archive",
-        "dispatch:thread.session.stop",
-        `terminal.close:${threadId}`,
-      ]);
-      assert.deepEqual(
-        dispatchedCommands.map((command) => command.type),
-        ["thread.archive", "thread.session.stop"],
-      );
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("archives without dispatching session stop when the thread has no session", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("thread-archive-no-session");
-      const effects: string[] = [];
-      const dispatchedCommands: Array<OrchestrationCommand> = [];
-
-      yield* buildAppUnderTest({
-        layers: {
-          terminalManager: {
-            close: (input) =>
-              Effect.sync(() => {
-                effects.push(`terminal.close:${input.threadId}`);
-              }),
-          },
-          orchestrationEngine: {
-            dispatch: (command) =>
-              Effect.sync(() => {
-                dispatchedCommands.push(command);
-                effects.push(`dispatch:${command.type}`);
-                return { sequence: dispatchedCommands.length };
-              }),
-          },
-          projectionSnapshotQuery: {
-            getThreadShellById: () =>
-              Effect.succeed(
-                Option.some(makeDefaultOrchestrationThreadShell({ id: threadId, session: null })),
-              ),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const dispatchResult = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[ORCHESTRATION_WS_METHODS.dispatchCommand]({
-            type: "thread.archive",
-            commandId: CommandId.make("cmd-thread-archive-no-session"),
-            threadId,
-          }),
-        ),
-      );
-
-      assert.equal(dispatchResult.sequence, 1);
-      assert.deepEqual(effects, ["dispatch:thread.archive", `terminal.close:${threadId}`]);
-      assert.deepEqual(
-        dispatchedCommands.map((command) => command.type),
-        ["thread.archive"],
-      );
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect(
-    "archives without dispatching session stop when the thread session is already stopped",
-    () =>
-      Effect.gen(function* () {
-        const threadId = ThreadId.make("thread-archive-stopped-session");
-        const effects: string[] = [];
-        const dispatchedCommands: Array<OrchestrationCommand> = [];
-        const now = "2026-01-01T00:00:00.000Z";
-
-        yield* buildAppUnderTest({
-          layers: {
-            terminalManager: {
-              close: (input) =>
-                Effect.sync(() => {
-                  effects.push(`terminal.close:${input.threadId}`);
-                }),
-            },
-            orchestrationEngine: {
-              dispatch: (command) =>
-                Effect.sync(() => {
-                  dispatchedCommands.push(command);
-                  effects.push(`dispatch:${command.type}`);
-                  return { sequence: dispatchedCommands.length };
-                }),
-            },
-            projectionSnapshotQuery: {
-              getThreadShellById: () =>
-                Effect.succeed(
-                  Option.some(
-                    makeDefaultOrchestrationThreadShell({
-                      id: threadId,
-                      updatedAt: now,
-                      session: {
-                        threadId,
-                        status: "stopped",
-                        providerName: "claudeAgent",
-                        runtimeMode: "full-access",
-                        activeTurnId: null,
-                        lastError: null,
-                        updatedAt: now,
-                      },
-                    }),
-                  ),
-                ),
-            },
-          },
-        });
-
-        const wsUrl = yield* getWsServerUrl("/ws");
-        const dispatchResult = yield* Effect.scoped(
-          withWsRpcClient(wsUrl, (client) =>
-            client[ORCHESTRATION_WS_METHODS.dispatchCommand]({
-              type: "thread.archive",
-              commandId: CommandId.make("cmd-thread-archive-stopped-session"),
-              threadId,
-            }),
-          ),
-        );
-
-        assert.equal(dispatchResult.sequence, 1);
-        assert.deepEqual(effects, ["dispatch:thread.archive", `terminal.close:${threadId}`]);
-        assert.deepEqual(
-          dispatchedCommands.map((command) => command.type),
-          ["thread.archive"],
-        );
-      }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("stops the provider session after settle without closing terminals", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("thread-settle");
-      const effects: string[] = [];
-      const dispatchedCommands: Array<OrchestrationCommand> = [];
-      const now = "2026-01-01T00:00:00.000Z";
-
-      yield* buildAppUnderTest({
-        layers: {
-          terminalManager: {
-            close: (input) =>
-              Effect.sync(() => {
-                effects.push(`terminal.close:${input.threadId}`);
-              }),
-          },
-          orchestrationEngine: {
-            dispatch: (command) =>
-              Effect.sync(() => {
-                dispatchedCommands.push(command);
-                effects.push(`dispatch:${command.type}`);
-                return { sequence: dispatchedCommands.length };
-              }),
-          },
-          projectionSnapshotQuery: {
-            getThreadShellById: () =>
-              Effect.succeed(
-                Option.some(
-                  makeDefaultOrchestrationThreadShell({
-                    id: threadId,
-                    updatedAt: now,
-                    session: {
-                      threadId,
-                      status: "ready",
-                      providerName: "claudeAgent",
-                      runtimeMode: "full-access",
-                      activeTurnId: null,
-                      lastError: null,
-                      updatedAt: now,
-                    },
-                  }),
-                ),
-              ),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const dispatchResult = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[ORCHESTRATION_WS_METHODS.dispatchCommand]({
-            type: "thread.settle",
-            commandId: CommandId.make("cmd-thread-settle"),
-            threadId,
-          }),
-        ),
-      );
-
-      assert.equal(dispatchResult.sequence, 1);
-      assert.deepEqual(effects, ["dispatch:thread.settle", "dispatch:thread.session.stop"]);
-      const sessionStopCommand = dispatchedCommands[1];
-      assert.equal(sessionStopCommand?.type, "thread.session.stop");
-      if (sessionStopCommand?.type === "thread.session.stop") {
-        assert.equal(sessionStopCommand.threadId, threadId);
-        assert.equal(sessionStopCommand.commandId, "session-stop-for-settle:cmd-thread-settle");
-        assert.equal(sessionStopCommand.onlyIfSettled, true);
-      }
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("settles without dispatching session stop when the thread has no session", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("thread-settle-no-session");
-      const effects: string[] = [];
-      const dispatchedCommands: Array<OrchestrationCommand> = [];
-
-      yield* buildAppUnderTest({
-        layers: {
-          terminalManager: {
-            close: (input) =>
-              Effect.sync(() => {
-                effects.push(`terminal.close:${input.threadId}`);
-              }),
-          },
-          orchestrationEngine: {
-            dispatch: (command) =>
-              Effect.sync(() => {
-                dispatchedCommands.push(command);
-                effects.push(`dispatch:${command.type}`);
-                return { sequence: dispatchedCommands.length };
-              }),
-          },
-          projectionSnapshotQuery: {
-            getThreadShellById: () =>
-              Effect.succeed(
-                Option.some(makeDefaultOrchestrationThreadShell({ id: threadId, session: null })),
-              ),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const dispatchResult = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[ORCHESTRATION_WS_METHODS.dispatchCommand]({
-            type: "thread.settle",
-            commandId: CommandId.make("cmd-thread-settle-no-session"),
-            threadId,
-          }),
-        ),
-      );
-
-      assert.equal(dispatchResult.sequence, 1);
-      assert.deepEqual(effects, ["dispatch:thread.settle"]);
-      assert.deepEqual(
-        dispatchedCommands.map((command) => command.type),
-        ["thread.settle"],
-      );
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("archives and still closes terminals when session stop fails", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("thread-archive-stop-failure");
-      const effects: string[] = [];
-      const dispatchedCommands: Array<OrchestrationCommand> = [];
-      const now = "2026-01-01T00:00:00.000Z";
-
-      yield* buildAppUnderTest({
-        layers: {
-          terminalManager: {
-            close: (input) =>
-              Effect.sync(() => {
-                effects.push(`terminal.close:${input.threadId}`);
-              }),
-          },
-          orchestrationEngine: {
-            dispatch: (command) => {
-              dispatchedCommands.push(command);
-              effects.push(`dispatch:${command.type}`);
-              if (command.type === "thread.session.stop") {
-                return Effect.fail(
-                  new OrchestrationListenerCallbackError({
-                    listener: "domain-event",
-                    detail: "simulated archive stop failure",
-                  }),
-                );
-              }
-              return Effect.succeed({ sequence: dispatchedCommands.length });
-            },
-          },
-          projectionSnapshotQuery: {
-            getThreadShellById: () =>
-              Effect.succeed(
-                Option.some(
-                  makeDefaultOrchestrationThreadShell({
-                    id: threadId,
-                    updatedAt: now,
-                    session: {
-                      threadId,
-                      status: "ready",
-                      providerName: "claudeAgent",
-                      runtimeMode: "full-access",
-                      activeTurnId: null,
-                      lastError: null,
-                      updatedAt: now,
-                    },
-                  }),
-                ),
-              ),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const dispatchResult = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[ORCHESTRATION_WS_METHODS.dispatchCommand]({
-            type: "thread.archive",
-            commandId: CommandId.make("cmd-thread-archive-stop-failure"),
-            threadId,
-          }),
-        ),
-      );
-
-      assert.equal(dispatchResult.sequence, 1);
-      assert.deepEqual(effects, [
-        "dispatch:thread.archive",
-        "dispatch:thread.session.stop",
-        `terminal.close:${threadId}`,
-      ]);
-      assert.deepEqual(
-        dispatchedCommands.map((command) => command.type),
-        ["thread.archive", "thread.session.stop"],
-      );
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("archives and still closes terminals when session stop defects", () =>
-    Effect.gen(function* () {
-      const threadId = ThreadId.make("thread-archive-stop-defect");
-      const effects: string[] = [];
-      const dispatchedCommands: Array<OrchestrationCommand> = [];
-      const now = "2026-01-01T00:00:00.000Z";
-
-      yield* buildAppUnderTest({
-        layers: {
-          terminalManager: {
-            close: (input) =>
-              Effect.sync(() => {
-                effects.push(`terminal.close:${input.threadId}`);
-              }),
-          },
-          orchestrationEngine: {
-            dispatch: (command) => {
-              dispatchedCommands.push(command);
-              effects.push(`dispatch:${command.type}`);
-              if (command.type === "thread.session.stop") {
-                return Effect.die(new Error("simulated archive stop defect"));
-              }
-              return Effect.succeed({ sequence: dispatchedCommands.length });
-            },
-          },
-          projectionSnapshotQuery: {
-            getThreadShellById: () =>
-              Effect.succeed(
-                Option.some(
-                  makeDefaultOrchestrationThreadShell({
-                    id: threadId,
-                    updatedAt: now,
-                    session: {
-                      threadId,
-                      status: "ready",
-                      providerName: "claudeAgent",
-                      runtimeMode: "full-access",
-                      activeTurnId: null,
-                      lastError: null,
-                      updatedAt: now,
-                    },
-                  }),
-                ),
-              ),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const dispatchResult = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[ORCHESTRATION_WS_METHODS.dispatchCommand]({
-            type: "thread.archive",
-            commandId: CommandId.make("cmd-thread-archive-stop-defect"),
-            threadId,
-          }),
-        ),
-      );
-
-      assert.equal(dispatchResult.sequence, 1);
-      assert.deepEqual(effects, [
-        "dispatch:thread.archive",
-        "dispatch:thread.session.stop",
-        `terminal.close:${threadId}`,
-      ]);
-      assert.deepEqual(
-        dispatchedCommands.map((command) => command.type),
-        ["thread.archive", "thread.session.stop"],
-      );
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect(
-    "bootstraps first-send worktree turns on the server before dispatching turn start",
-    () =>
-      Effect.gen(function* () {
-        const dispatchedCommands: Array<OrchestrationCommand> = [];
-        const bootstrapGitOperations: string[] = [];
-        const refreshStatus = vi.fn((_: string) =>
-          Effect.succeed({
-            isRepo: true,
-            hasPrimaryRemote: true,
-            isDefaultRef: false,
-            refName: "t3code/bootstrap-refName",
-            hasWorkingTreeChanges: false,
-            workingTree: {
-              files: [],
-              insertions: 0,
-              deletions: 0,
-            },
-            hasUpstream: true,
-            aheadCount: 0,
-            behindCount: 0,
-            pr: null,
-          }),
-        );
-        const remoteExists = vi.fn(
-          (_: Parameters<GitVcsDriver.GitVcsDriver["Service"]["remoteExists"]>[0]) =>
-            Effect.sync(() => {
-              bootstrapGitOperations.push("remote-exists");
-              return true;
-            }),
-        );
-        const fetchRemote = vi.fn(
-          (_: Parameters<GitVcsDriver.GitVcsDriver["Service"]["fetchRemote"]>[0]) =>
-            Effect.sync(() => {
-              bootstrapGitOperations.push("fetch");
-            }),
-        );
-        const fetchedOriginCommit = "0123456789abcdef0123456789abcdef01234567";
-        const resolveRemoteTrackingCommit = vi.fn(
-          (_: Parameters<GitVcsDriver.GitVcsDriver["Service"]["resolveRemoteTrackingCommit"]>[0]) =>
-            Effect.sync(() => {
-              bootstrapGitOperations.push("resolve-remote-commit");
-              return {
-                commitSha: fetchedOriginCommit,
-                remoteRefName: "origin/main",
-              };
-            }),
-        );
-        const createWorktree = vi.fn(
-          (_: Parameters<GitVcsDriver.GitVcsDriver["Service"]["createWorktree"]>[0]) =>
-            Effect.sync(() => {
-              bootstrapGitOperations.push("create-worktree");
-              return {
-                worktree: {
-                  refName: "t3code/bootstrap-refName",
-                  path: "/tmp/bootstrap-worktree",
-                },
-              };
-            }),
-        );
-        const runForThread = vi.fn(
-          (
-            _: Parameters<
-              ProjectSetupScriptRunner.ProjectSetupScriptRunner["Service"]["runForThread"]
-            >[0],
-          ) =>
-            Effect.succeed({
-              status: "started" as const,
-              scriptId: "setup",
-              scriptName: "Setup",
-              terminalId: "setup-setup",
-              cwd: "/tmp/bootstrap-worktree",
-            }),
-        );
-
-        yield* buildAppUnderTest({
-          layers: {
-            gitVcsDriver: {
-              remoteExists,
-              fetchRemote,
-              resolveRemoteTrackingCommit,
-              createWorktree,
-            },
-            vcsStatusBroadcaster: {
-              refreshStatus,
-            },
-            orchestrationEngine: {
-              dispatch: (command) =>
-                Effect.sync(() => {
-                  dispatchedCommands.push(command);
-                  return { sequence: dispatchedCommands.length };
-                }),
-              readEvents: () => Stream.empty,
-            },
-            projectSetupScriptRunner: {
-              runForThread,
-            },
-          },
-        });
-
-        const createdAt = "2026-01-01T00:00:00.000Z";
-        const wsUrl = yield* getWsServerUrl("/ws");
-        const response = yield* Effect.scoped(
-          withWsRpcClient(wsUrl, (client) =>
-            client[ORCHESTRATION_WS_METHODS.dispatchCommand]({
-              type: "thread.turn.start",
-              commandId: CommandId.make("cmd-bootstrap-turn-start"),
-              threadId: ThreadId.make("thread-bootstrap"),
-              message: {
-                messageId: MessageId.make("msg-bootstrap"),
-                role: "user",
-                text: "hello",
-                attachments: [],
-              },
-              modelSelection: defaultModelSelection,
-              runtimeMode: "full-access",
-              interactionMode: "default",
-              bootstrap: {
-                createThread: {
-                  projectId: defaultProjectId,
-                  title: "Bootstrap Thread",
-                  modelSelection: defaultModelSelection,
-                  runtimeMode: "full-access",
-                  interactionMode: "default",
-                  branch: "main",
-                  worktreePath: null,
-                  createdAt,
-                },
-                prepareWorktree: {
-                  projectCwd: "/tmp/project",
-                  baseBranch: "main",
-                  branch: "t3code/bootstrap-refName",
-                  startFromOrigin: true,
-                },
-                runSetupScript: true,
-              },
-              createdAt,
-            }),
-          ),
-        );
-
-        assert.equal(response.sequence, 5);
-        assert.deepEqual(
-          dispatchedCommands.map((command) => command.type),
-          [
-            "thread.create",
-            "thread.meta.update",
-            "thread.activity.append",
-            "thread.activity.append",
-            "thread.turn.start",
-          ],
-        );
-        assert.deepEqual(createWorktree.mock.calls[0]?.[0], {
-          cwd: "/tmp/project",
-          refName: fetchedOriginCommit,
-          newRefName: "t3code/bootstrap-refName",
-          baseRefName: "main",
-          path: null,
-        });
-        assert.deepEqual(fetchRemote.mock.calls[0]?.[0], {
-          cwd: "/tmp/project",
-          remoteName: "origin",
-        });
-        assert.deepEqual(resolveRemoteTrackingCommit.mock.calls[0]?.[0], {
-          cwd: "/tmp/project",
-          refName: "main",
-          fallbackRemoteName: "origin",
-        });
-        assert.deepEqual(bootstrapGitOperations, [
-          "remote-exists",
-          "fetch",
-          "resolve-remote-commit",
-          "create-worktree",
-        ]);
-        assert.deepEqual(runForThread.mock.calls[0]?.[0], {
-          threadId: ThreadId.make("thread-bootstrap"),
-          projectId: defaultProjectId,
-          projectCwd: "/tmp/project",
-          worktreePath: "/tmp/bootstrap-worktree",
-        });
-        assert.deepEqual(refreshStatus.mock.calls[0]?.[0], "/tmp/bootstrap-worktree");
-
-        const setupActivities = dispatchedCommands.filter(
-          (command): command is Extract<OrchestrationCommand, { type: "thread.activity.append" }> =>
-            command.type === "thread.activity.append",
-        );
-        assert.deepEqual(
-          setupActivities.map((command) => command.activity.kind),
-          ["setup-script.requested", "setup-script.started"],
-        );
-        const finalCommand = dispatchedCommands[4];
-        assertTrue(finalCommand?.type === "thread.turn.start");
-        if (finalCommand?.type === "thread.turn.start") {
-          assert.equal(finalCommand.bootstrap, undefined);
-        }
-      }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect(
-    "falls back to the local base branch when startFromOrigin is set but no origin remote exists",
-    () =>
-      Effect.gen(function* () {
-        const dispatchedCommands: Array<OrchestrationCommand> = [];
-        const remoteExists = vi.fn(
-          (_: Parameters<GitVcsDriver.GitVcsDriver["Service"]["remoteExists"]>[0]) =>
-            Effect.succeed(false),
-        );
-        const fetchRemote = vi.fn(
-          (_: Parameters<GitVcsDriver.GitVcsDriver["Service"]["fetchRemote"]>[0]) => Effect.void,
-        );
-        const resolveRemoteTrackingCommit = vi.fn(
-          (_: Parameters<GitVcsDriver.GitVcsDriver["Service"]["resolveRemoteTrackingCommit"]>[0]) =>
-            Effect.succeed({
-              commitSha: "0123456789abcdef0123456789abcdef01234567",
-              remoteRefName: "origin/main",
-            }),
-        );
-        const createWorktree = vi.fn(
-          (_: Parameters<GitVcsDriver.GitVcsDriver["Service"]["createWorktree"]>[0]) =>
-            Effect.succeed({
-              worktree: {
-                refName: "t3code/bootstrap-refName",
-                path: "/tmp/bootstrap-worktree",
-              },
-            }),
-        );
-
-        yield* buildAppUnderTest({
-          layers: {
-            gitVcsDriver: {
-              remoteExists,
-              fetchRemote,
-              resolveRemoteTrackingCommit,
-              createWorktree,
-            },
-            orchestrationEngine: {
-              dispatch: (command) =>
-                Effect.sync(() => {
-                  dispatchedCommands.push(command);
-                  return { sequence: dispatchedCommands.length };
-                }),
-              readEvents: () => Stream.empty,
-            },
-          },
-        });
-
-        const createdAt = "2026-01-01T00:00:00.000Z";
-        const wsUrl = yield* getWsServerUrl("/ws");
-        yield* Effect.scoped(
-          withWsRpcClient(wsUrl, (client) =>
-            client[ORCHESTRATION_WS_METHODS.dispatchCommand]({
-              type: "thread.turn.start",
-              commandId: CommandId.make("cmd-bootstrap-turn-start-no-origin"),
-              threadId: ThreadId.make("thread-bootstrap-no-origin"),
-              message: {
-                messageId: MessageId.make("msg-bootstrap-no-origin"),
-                role: "user",
-                text: "hello",
-                attachments: [],
-              },
-              modelSelection: defaultModelSelection,
-              runtimeMode: "full-access",
-              interactionMode: "default",
-              bootstrap: {
-                createThread: {
-                  projectId: defaultProjectId,
-                  title: "Bootstrap Thread",
-                  modelSelection: defaultModelSelection,
-                  runtimeMode: "full-access",
-                  interactionMode: "default",
-                  branch: "main",
-                  worktreePath: null,
-                  createdAt,
-                },
-                prepareWorktree: {
-                  projectCwd: "/tmp/project",
-                  baseBranch: "main",
-                  branch: "t3code/bootstrap-refName",
-                  startFromOrigin: true,
-                },
-              },
-              createdAt,
-            }),
-          ),
-        );
-
-        assert.deepEqual(remoteExists.mock.calls[0]?.[0], {
-          cwd: "/tmp/project",
-          remoteName: "origin",
-        });
-        assert.equal(fetchRemote.mock.calls.length, 0);
-        assert.equal(resolveRemoteTrackingCommit.mock.calls.length, 0);
-        assert.deepEqual(createWorktree.mock.calls[0]?.[0], {
-          cwd: "/tmp/project",
-          refName: "main",
-          newRefName: "t3code/bootstrap-refName",
-          baseRefName: "main",
-          path: null,
-        });
-      }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("records setup-script failures without aborting bootstrap turn start", () =>
-    Effect.gen(function* () {
-      const dispatchedCommands: Array<OrchestrationCommand> = [];
-      const createWorktree = vi.fn(
-        (_: Parameters<GitVcsDriver.GitVcsDriver["Service"]["createWorktree"]>[0]) =>
-          Effect.succeed({
-            worktree: {
-              refName: "t3code/bootstrap-refName",
-              path: "/tmp/bootstrap-worktree",
-            },
-          }),
-      );
-      const runForThread = vi.fn(
-        (
-          input: Parameters<
-            ProjectSetupScriptRunner.ProjectSetupScriptRunner["Service"]["runForThread"]
-          >[0],
-        ) =>
-          Effect.fail(
-            new ProjectSetupScriptRunner.ProjectSetupScriptOperationError({
-              threadId: input.threadId,
-              worktreePath: input.worktreePath,
-              operation: "openTerminal",
-              cause: { message: "pty unavailable" },
-            }),
-          ),
-      );
-
-      yield* buildAppUnderTest({
-        layers: {
-          gitVcsDriver: {
-            createWorktree,
-          },
-          orchestrationEngine: {
-            dispatch: (command) =>
-              Effect.sync(() => {
-                dispatchedCommands.push(command);
-                return { sequence: dispatchedCommands.length };
-              }),
-            readEvents: () => Stream.empty,
-          },
-          projectSetupScriptRunner: {
-            runForThread,
-          },
-        },
-      });
-
-      const createdAt = "2026-01-01T00:00:00.000Z";
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const response = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[ORCHESTRATION_WS_METHODS.dispatchCommand]({
-            type: "thread.turn.start",
-            commandId: CommandId.make("cmd-bootstrap-turn-start-setup-failure"),
-            threadId: ThreadId.make("thread-bootstrap-setup-failure"),
-            message: {
-              messageId: MessageId.make("msg-bootstrap-setup-failure"),
-              role: "user",
-              text: "hello",
-              attachments: [],
-            },
-            modelSelection: defaultModelSelection,
-            runtimeMode: "full-access",
-            interactionMode: "default",
-            bootstrap: {
-              createThread: {
-                projectId: defaultProjectId,
-                title: "Bootstrap Thread",
-                modelSelection: defaultModelSelection,
-                runtimeMode: "full-access",
-                interactionMode: "default",
-                branch: "main",
-                worktreePath: null,
-                createdAt,
-              },
-              prepareWorktree: {
-                projectCwd: "/tmp/project",
-                baseBranch: "main",
-                branch: "t3code/bootstrap-refName",
-              },
-              runSetupScript: true,
-            },
-            createdAt,
-          }),
-        ),
-      );
-
-      assert.equal(response.sequence, 4);
-      assert.deepEqual(
-        dispatchedCommands.map((command) => command.type),
-        ["thread.create", "thread.meta.update", "thread.activity.append", "thread.turn.start"],
-      );
-      const setupFailureActivity = dispatchedCommands.find(
-        (command): command is Extract<OrchestrationCommand, { type: "thread.activity.append" }> =>
-          command.type === "thread.activity.append",
-      );
-      assert.equal(setupFailureActivity?.activity.kind, "setup-script.failed");
-      assert.deepEqual(setupFailureActivity?.activity.payload, {
-        detail: "pty unavailable",
-        worktreePath: "/tmp/bootstrap-worktree",
-      });
-      assertTrue(dispatchedCommands.every((command) => command.type !== "thread.delete"));
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("does not misattribute setup activity dispatch failures as setup launch failures", () =>
-    Effect.gen(function* () {
-      const dispatchedCommands: Array<OrchestrationCommand> = [];
-      const createWorktree = vi.fn(
-        (_: Parameters<GitVcsDriver.GitVcsDriver["Service"]["createWorktree"]>[0]) =>
-          Effect.succeed({
-            worktree: {
-              refName: "t3code/bootstrap-refName",
-              path: "/tmp/bootstrap-worktree",
-            },
-          }),
-      );
-      const runForThread = vi.fn(
-        (
-          _: Parameters<
-            ProjectSetupScriptRunner.ProjectSetupScriptRunner["Service"]["runForThread"]
-          >[0],
-        ) =>
-          Effect.succeed({
-            status: "started" as const,
-            scriptId: "setup",
-            scriptName: "Setup",
-            terminalId: "setup-setup",
-            cwd: "/tmp/bootstrap-worktree",
-          }),
-      );
-      let setupActivityAppendAttempt = 0;
-
-      yield* buildAppUnderTest({
-        layers: {
-          gitVcsDriver: {
-            createWorktree,
-          },
-          orchestrationEngine: {
-            dispatch: (command) => {
-              if (
-                command.type === "thread.activity.append" &&
-                command.activity.kind.startsWith("setup-script.")
-              ) {
-                setupActivityAppendAttempt += 1;
-                if (setupActivityAppendAttempt === 2) {
-                  return Effect.fail(
-                    new OrchestrationListenerCallbackError({
-                      listener: "domain-event",
-                      detail: "failed to append setup-script.started activity",
-                    }),
-                  );
-                }
-              }
-
-              return Effect.sync(() => {
-                dispatchedCommands.push(command);
-                return { sequence: dispatchedCommands.length };
-              });
-            },
-            readEvents: () => Stream.empty,
-          },
-          projectSetupScriptRunner: {
-            runForThread,
-          },
-        },
-      });
-
-      const createdAt = "2026-01-01T00:00:00.000Z";
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const response = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[ORCHESTRATION_WS_METHODS.dispatchCommand]({
-            type: "thread.turn.start",
-            commandId: CommandId.make("cmd-bootstrap-turn-start-setup-activity-failure"),
-            threadId: ThreadId.make("thread-bootstrap-setup-activity-failure"),
-            message: {
-              messageId: MessageId.make("msg-bootstrap-setup-activity-failure"),
-              role: "user",
-              text: "hello",
-              attachments: [],
-            },
-            modelSelection: defaultModelSelection,
-            runtimeMode: "full-access",
-            interactionMode: "default",
-            bootstrap: {
-              createThread: {
-                projectId: defaultProjectId,
-                title: "Bootstrap Thread",
-                modelSelection: defaultModelSelection,
-                runtimeMode: "full-access",
-                interactionMode: "default",
-                branch: "main",
-                worktreePath: null,
-                createdAt,
-              },
-              prepareWorktree: {
-                projectCwd: "/tmp/project",
-                baseBranch: "main",
-                branch: "t3code/bootstrap-refName",
-              },
-              runSetupScript: true,
-            },
-            createdAt,
-          }),
-        ),
-      );
-
-      assert.equal(response.sequence, 4);
-      assert.deepEqual(
-        dispatchedCommands.map((command) => command.type),
-        ["thread.create", "thread.meta.update", "thread.activity.append", "thread.turn.start"],
-      );
-      const setupActivities = dispatchedCommands.filter(
-        (command): command is Extract<OrchestrationCommand, { type: "thread.activity.append" }> =>
-          command.type === "thread.activity.append",
-      );
-      assert.deepEqual(
-        setupActivities.map((command) => command.activity.kind),
-        ["setup-script.requested"],
-      );
-      assertTrue(
-        setupActivities.every((command) => command.activity.kind !== "setup-script.failed"),
-      );
-      assertTrue(dispatchedCommands.every((command) => command.type !== "thread.delete"));
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("cleans up created bootstrap threads when worktree creation defects", () =>
-    Effect.gen(function* () {
-      const dispatchedCommands: Array<OrchestrationCommand> = [];
-      const fileSystem = yield* FileSystem.FileSystem;
-      const path = yield* Path.Path;
-      const createWorktree = vi.fn(
-        (_: Parameters<GitVcsDriver.GitVcsDriver["Service"]["createWorktree"]>[0]) =>
-          Effect.die(new Error("worktree exploded")),
-      );
-
-      const config = yield* buildAppUnderTest({
-        layers: {
-          gitVcsDriver: {
-            createWorktree,
-          },
-          orchestrationEngine: {
-            dispatch: (command) =>
-              Effect.sync(() => {
-                dispatchedCommands.push(command);
-                return { sequence: dispatchedCommands.length };
-              }),
-            readEvents: () => Stream.empty,
-          },
-        },
-      });
-
-      const createdAt = "2026-01-01T00:00:00.000Z";
-      const wsUrl = yield* getWsServerUrl("/ws");
-      let pendingAttachmentId: string | undefined;
-      const result = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          Effect.gen(function* () {
-            const upload = yield* client[WS_METHODS.attachmentsCreateUploadUrl]({
-              name: "screenshot.png",
-              mimeType: "image/png",
-              sizeBytes: 6,
-            });
-            pendingAttachmentId = upload.attachmentId;
-            const uploadResponse = yield* HttpClient.post(upload.relativeUrl, {
-              body: HttpBody.uint8Array(new Uint8Array([1, 2, 3, 4, 5, 6]), "image/png"),
-            });
-            assert.equal(uploadResponse.status, 204);
-
-            return yield* client[ORCHESTRATION_WS_METHODS.dispatchCommand]({
-              type: "thread.turn.start",
-              commandId: CommandId.make("cmd-bootstrap-turn-start-defect"),
-              threadId: ThreadId.make("thread-bootstrap-defect"),
-              message: {
-                messageId: MessageId.make("msg-bootstrap-defect"),
-                role: "user",
-                text: "hello",
-                attachments: [
-                  {
-                    type: "image",
-                    id: upload.attachmentId,
-                    name: "screenshot.png",
-                    mimeType: "image/png",
-                    sizeBytes: 6,
-                  },
-                ],
-              },
-              modelSelection: defaultModelSelection,
-              runtimeMode: "full-access",
-              interactionMode: "default",
-              bootstrap: {
-                createThread: {
-                  projectId: defaultProjectId,
-                  title: "Bootstrap Thread",
-                  modelSelection: defaultModelSelection,
-                  runtimeMode: "full-access",
-                  interactionMode: "default",
-                  branch: "main",
-                  worktreePath: null,
-                  createdAt,
-                },
-                prepareWorktree: {
-                  projectCwd: "/tmp/project",
-                  baseBranch: "main",
-                  branch: "t3code/bootstrap-refName",
-                },
-                runSetupScript: false,
-              },
-              createdAt,
-            });
-          }),
-        ).pipe(Effect.result),
-      );
-
-      assertTrue(result._tag === "Failure");
-      assertTrue(result.failure._tag === "OrchestrationDispatchCommandError");
-      assert.include(result.failure.message, "worktree exploded");
-      assert.strictEqual(result.failure.bootstrapThreadDisposition, "deleted");
-      assert.deepEqual(
-        dispatchedCommands.map((command) => command.type),
-        ["thread.create", "thread.delete"],
-      );
-      assert.isDefined(pendingAttachmentId);
-      assert.isTrue(
-        yield* fileSystem.exists(path.join(config.attachmentsDir, `${pendingAttachmentId}.png`)),
-      );
-      assert.deepEqual(yield* fileSystem.readDirectory(config.attachmentsDir), [
-        `${pendingAttachmentId}.png`,
-      ]);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("drains deletion cleanup through the re-created thread event", () =>
-    Effect.gen(function* () {
-      // A draft retry reuses the thread id its failed bootstrap deleted. The
-      // deletion reactor stops sessions and closes terminals by that id, so
-      // both thread.create paths use the created event as a fence, then drain
-      // cleanup before handing the new incarnation to resource-owning work.
-      const trace: Array<string> = [];
-      const drainRequested = yield* Deferred.make<void>();
-      const cleanupDone = yield* Deferred.make<void>();
-      yield* buildAppUnderTest({
-        layers: {
-          threadDeletionReactor: {
-            drainThrough: (sequence) =>
-              Effect.gen(function* () {
-                trace.push(`drain:${sequence}`);
-                yield* Deferred.succeed(drainRequested, undefined);
-                yield* Deferred.await(cleanupDone);
-              }),
-          },
-          orchestrationEngine: {
-            dispatch: (command) =>
-              Effect.sync(() => {
-                trace.push(command.type);
-                return { sequence: trace.length };
-              }),
-            readEvents: () => Stream.empty,
-          },
-        },
-      });
-
-      const createdAt = "2026-01-01T00:00:00.000Z";
-      const threadId = ThreadId.make("thread-retry-after-delete");
-      const wsUrl = yield* getWsServerUrl("/ws");
-
-      yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          Effect.gen(function* () {
-            const directCreate = yield* Effect.forkChild(
-              client[ORCHESTRATION_WS_METHODS.dispatchCommand]({
-                type: "thread.create",
-                commandId: CommandId.make("cmd-retry-create"),
-                threadId,
-                projectId: defaultProjectId,
-                title: "Retry",
-                modelSelection: defaultModelSelection,
-                runtimeMode: "full-access",
-                interactionMode: "default",
-                branch: null,
-                worktreePath: null,
-                createdAt,
-              }),
-            );
-            yield* Deferred.await(drainRequested);
-            assert.deepEqual(trace, ["thread.create", "drain:1"]);
-            yield* Deferred.succeed(cleanupDone, undefined);
-            yield* Fiber.join(directCreate);
-          }),
-        ),
-      );
-      assert.deepEqual(trace, ["thread.create", "drain:1"]);
-
-      // Cleanup is already released; the bootstrap path must still drain
-      // between creating the thread and starting its turn.
-      trace.length = 0;
-      yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          Effect.gen(function* () {
-            const bootstrapCreate = yield* Effect.forkChild(
-              client[ORCHESTRATION_WS_METHODS.dispatchCommand]({
-                type: "thread.turn.start",
-                commandId: CommandId.make("cmd-retry-bootstrap"),
-                threadId,
-                message: {
-                  messageId: MessageId.make("msg-retry-bootstrap"),
-                  role: "user",
-                  text: "hello",
-                  attachments: [],
-                },
-                modelSelection: defaultModelSelection,
-                runtimeMode: "full-access",
-                interactionMode: "default",
-                bootstrap: {
-                  createThread: {
-                    projectId: defaultProjectId,
-                    title: "Retry",
-                    modelSelection: defaultModelSelection,
-                    runtimeMode: "full-access",
-                    interactionMode: "default",
-                    branch: null,
-                    worktreePath: null,
-                    createdAt,
-                  },
-                  runSetupScript: false,
-                },
-                createdAt,
-              }),
-            );
-            yield* Fiber.join(bootstrapCreate);
-          }),
-        ),
-      );
-      assert.deepEqual(trace, ["thread.create", "drain:1", "thread.turn.start"]);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("does not report a deleted bootstrap thread when cleanup fails", () =>
-    Effect.gen(function* () {
-      const dispatchedCommands: Array<OrchestrationCommand> = [];
-      const createWorktree = vi.fn(
-        (_: Parameters<GitVcsDriver.GitVcsDriver["Service"]["createWorktree"]>[0]) =>
-          Effect.die(new Error("worktree exploded")),
-      );
-
-      yield* buildAppUnderTest({
-        layers: {
-          gitVcsDriver: {
-            createWorktree,
-          },
-          orchestrationEngine: {
-            dispatch: (command) => {
-              dispatchedCommands.push(command);
-              if (command.type === "thread.delete") {
-                return Effect.fail(
-                  new OrchestrationListenerCallbackError({
-                    listener: "domain-event",
-                    detail: "thread cleanup exploded",
-                  }),
-                );
-              }
-              return Effect.succeed({ sequence: dispatchedCommands.length });
-            },
-            readEvents: () => Stream.empty,
-          },
-        },
-      });
-
-      const createdAt = "2026-01-01T00:00:00.000Z";
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const result = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[ORCHESTRATION_WS_METHODS.dispatchCommand]({
-            type: "thread.turn.start",
-            commandId: CommandId.make("cmd-bootstrap-turn-start-cleanup-defect"),
-            threadId: ThreadId.make("thread-bootstrap-cleanup-defect"),
-            message: {
-              messageId: MessageId.make("msg-bootstrap-cleanup-defect"),
-              role: "user",
-              text: "hello",
-              attachments: [],
-            },
-            modelSelection: defaultModelSelection,
-            runtimeMode: "full-access",
-            interactionMode: "default",
-            bootstrap: {
-              createThread: {
-                projectId: defaultProjectId,
-                title: "Bootstrap Thread",
-                modelSelection: defaultModelSelection,
-                runtimeMode: "full-access",
-                interactionMode: "default",
-                branch: "main",
-                worktreePath: null,
-                createdAt,
-              },
-              prepareWorktree: {
-                projectCwd: "/tmp/project",
-                baseBranch: "main",
-                branch: "t3code/bootstrap-refName",
-              },
-              runSetupScript: false,
-            },
-            createdAt,
-          }),
-        ).pipe(Effect.result),
-      );
-
-      assertTrue(result._tag === "Failure");
-      assertTrue(result.failure._tag === "OrchestrationDispatchCommandError");
-      assert.include(result.failure.message, "worktree exploded");
-      assert.strictEqual(result.failure.bootstrapThreadDisposition, undefined);
-      assert.deepEqual(
-        dispatchedCommands.map((command) => command.type),
-        ["thread.create", "thread.delete"],
-      );
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("routes websocket rpc terminal methods", () =>
-    Effect.gen(function* () {
-      const snapshot = {
-        threadId: "thread-1",
-        terminalId: "default",
-        cwd: "/tmp/project",
-        worktreePath: null,
-        status: "running" as const,
-        pid: 1234,
-        history: "",
-        exitCode: null,
-        exitSignal: null,
-        label: "Primary",
-        updatedAt: "2026-01-01T00:00:00.000Z",
-      };
-
-      yield* buildAppUnderTest({
-        layers: {
-          terminalManager: {
-            open: () => Effect.succeed(snapshot),
-            write: () => Effect.void,
-            resize: () => Effect.void,
-            clear: () => Effect.void,
-            restart: () => Effect.succeed(snapshot),
-            close: () => Effect.void,
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-
-      const opened = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[WS_METHODS.terminalOpen]({
-            threadId: "thread-1",
-            terminalId: "default",
-            cwd: "/tmp/project",
-          }),
-        ),
-      );
-      assert.equal(opened.terminalId, "default");
-
-      yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[WS_METHODS.terminalWrite]({
-            threadId: "thread-1",
-            terminalId: "default",
-            data: "echo hi\n",
-          }),
-        ),
-      );
-
-      yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[WS_METHODS.terminalResize]({
-            threadId: "thread-1",
-            terminalId: "default",
-            cols: 120,
-            rows: 40,
-          }),
-        ),
-      );
-
-      yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[WS_METHODS.terminalClear]({
-            threadId: "thread-1",
-            terminalId: "default",
-          }),
-        ),
-      );
-
-      const restarted = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[WS_METHODS.terminalRestart]({
-            threadId: "thread-1",
-            terminalId: "default",
-            cwd: "/tmp/project",
-            cols: 120,
-            rows: 40,
-          }),
-        ),
-      );
-      assert.equal(restarted.terminalId, "default");
-
-      yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[WS_METHODS.terminalClose]({
-            threadId: "thread-1",
-            terminalId: "default",
-          }),
-        ),
-      );
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-
-  it.effect("routes websocket rpc terminal.write errors", () =>
-    Effect.gen(function* () {
-      const terminalError = new TerminalNotRunningError({
-        threadId: "thread-1",
-        terminalId: "default",
-      });
-      yield* buildAppUnderTest({
-        layers: {
-          terminalManager: {
-            write: () => Effect.fail(terminalError),
-          },
-        },
-      });
-
-      const wsUrl = yield* getWsServerUrl("/ws");
-      const result = yield* Effect.scoped(
-        withWsRpcClient(wsUrl, (client) =>
-          client[WS_METHODS.terminalWrite]({
-            threadId: "thread-1",
-            terminalId: "default",
-            data: "echo fail\n",
-          }),
-        ).pipe(Effect.result),
-      );
-
-      assertFailure(result, terminalError);
-    }).pipe(Effect.provide(NodeHttpServer.layerTest)),
-  );
-});
-
-it.live(
-  "reports thread HTTP and WebSocket transfer budgets",
-  () =>
-    Effect.gen(function* () {
-      const providers = [
-        ProviderDriverKind.make("codex"),
-        ProviderDriverKind.make("claudeAgent"),
-      ] as const;
-
-      const runs = yield* Effect.forEach(
-        providers,
-        (provider) =>
-          Effect.acquireUseRelease(
-            makeOrchestrationIntegrationHarness({ provider }),
-            (harness) =>
-              Effect.gen(function* () {
-                yield* seedTransferBudgetHistory(harness, provider);
-                yield* buildAppUnderTest({
-                  layers: {
-                    orchestrationEngine: harness.engine,
-                    projectionSnapshotQuery: harness.snapshotQuery,
-                  },
-                });
-
-                const baseUrl = yield* getHttpServerUrl();
-                const cookie = yield* getAuthenticatedSessionCookieHeader();
-
-                const recorder = makeWebSocketTransferRecorder();
-                const wsUrl = baseUrl.replace(/^http:/, "ws:") + "/ws";
-                const protocolLayer = countingWsRpcProtocolLayer({
-                  url: wsUrl,
-                  cookie,
-                  recorder,
-                });
-
-                return yield* Effect.scoped(
-                  Effect.gen(function* () {
-                    const client = yield* makeCountingWsRpcClient;
-
-                    const threadSnapshot = yield* measureHttpGet({
-                      url: `${baseUrl}/api/orchestration/threads/${TRANSFER_THREAD_ID}`,
-                      headers: { cookie },
-                    });
-                    assert.equal(threadSnapshot.status, 200);
-                    assert.equal(threadSnapshot.contentEncoding, "gzip");
-                    const decodedThread = yield* decodeTransferThreadSnapshot(
-                      Buffer.from(threadSnapshot.decodedBody).toString("utf8"),
-                    );
-                    assert.equal(
-                      decodedThread.thread.messages.length,
-                      TRANSFER_HISTORY_TURN_COUNT * 2,
-                    );
-
-                    const threadItems = yield* Queue.unbounded<OrchestrationThreadStreamItem>();
-                    yield* client[ORCHESTRATION_WS_METHODS.subscribeThread]({
-                      threadId: TRANSFER_THREAD_ID,
-                      afterSequence: decodedThread.snapshotSequence,
-                      requestCompletionMarker: true,
-                    }).pipe(
-                      Stream.runForEach((item) =>
-                        Queue.offer(threadItems, item).pipe(Effect.asVoid),
-                      ),
-                      Effect.forkScoped,
-                    );
-                    const initialThreadItems = yield* collectQueueUntil(
-                      threadItems,
-                      (item) => item.kind === "synchronized",
-                      `${provider} thread subscription to synchronize`,
-                    );
-                    assert.isFalse(initialThreadItems.some((item) => item.kind === "snapshot"));
-                    assert.include(recorder.negotiatedExtensions(), "permessage-deflate");
-
-                    yield* queueMeasuredTransferTurn(harness, provider);
-                    const turnStartTotals = recorder.totals();
-                    yield* client[ORCHESTRATION_WS_METHODS.dispatchCommand]({
-                      type: "thread.turn.start",
-                      commandId: CommandId.make(`transfer:${provider}:measured-turn`),
-                      threadId: TRANSFER_THREAD_ID,
-                      message: {
-                        messageId: MessageId.make("transfer-user-measured"),
-                        role: "user",
-                        text: "Measure the client-bound transfer for this turn.",
-                        attachments: [],
-                      },
-                      modelSelection: transferModelSelection(provider),
-                      runtimeMode: "approval-required",
-                      interactionMode: "default",
-                      createdAt: TRANSFER_MEASURED_TURN_CREATED_AT,
-                    });
-                    yield* waitForTurnQuiesced(harness, TRANSFER_MEASURED_TURN_INDEX + 1);
-                    const finalThreadSequence = yield* harness.engine
-                      .readEvents(decodedThread.snapshotSequence, 10_000)
-                      .pipe(
-                        Stream.runFold(
-                          () => decodedThread.snapshotSequence,
-                          (sequence, event) =>
-                            event.aggregateId === TRANSFER_THREAD_ID && isThreadDetailEvent(event)
-                              ? Math.max(sequence, event.sequence)
-                              : sequence,
-                        ),
-                      );
-                    assert.isAbove(finalThreadSequence, decodedThread.snapshotSequence);
-
-                    yield* collectQueueUntil(
-                      threadItems,
-                      (item) =>
-                        item.kind === "event" && item.event.sequence === finalThreadSequence,
-                      `${provider} thread stream to reach sequence ${finalThreadSequence}`,
-                    );
-                    const measuredTurnWebSocket = transferDelta(turnStartTotals, recorder.totals());
-
-                    const finalThreadSnapshot = yield* harness.snapshotQuery
-                      .getThreadDetailSnapshot(TRANSFER_THREAD_ID)
-                      .pipe(Effect.map(Option.getOrThrow));
-                    const expectedAssistantText = expectedMeasuredAssistantText(provider);
-                    const measuredAssistant = finalThreadSnapshot.thread.messages.find(
-                      (message) =>
-                        message.role === "assistant" && message.text === expectedAssistantText,
-                    );
-                    assert.isDefined(measuredAssistant);
-                    assert.isTrue(
-                      finalThreadSnapshot.thread.messages.length >= TRANSFER_HISTORY_TURN_COUNT * 2,
-                    );
-                    assert.equal(measuredAssistant?.streaming, false);
-                    assert.equal(finalThreadSnapshot.thread.session?.status, "ready");
-                    assert.equal(
-                      finalThreadSnapshot.thread.checkpoints.length,
-                      TRANSFER_HISTORY_TURN_COUNT + 1,
-                    );
-
-                    return {
-                      provider,
-                      threadSnapshot,
-                      measuredTurnWebSocket,
-                    } satisfies TransferBudgetRun;
-                  }).pipe(Effect.provide(protocolLayer)),
-                );
-              }),
-            (harness) => harness.dispose,
-          ).pipe(Effect.provide(NodeHttpServerTestWithWsDeflate)),
-        { concurrency: 1 },
-      );
-
-      const report = formatTransferBudgetReport(runs);
-      yield* Effect.logInfo(`\n${report}`);
-      const reportPath = yield* Config.string("T3CODE_TRANSFER_BUDGET_REPORT_PATH").pipe(
-        Config.option,
-      );
-      if (Option.isSome(reportPath)) {
-        const fileSystem = yield* FileSystem.FileSystem;
-        yield* fileSystem.writeFileString(reportPath.value, report);
-      }
-      const resultPath = yield* Config.string("T3CODE_TRANSFER_BUDGET_RESULT_PATH").pipe(
-        Config.option,
-      );
-      if (Option.isSome(resultPath)) {
-        const fileSystem = yield* FileSystem.FileSystem;
-        yield* fileSystem.writeFileString(resultPath.value, formatTransferBudgetResult(runs));
-      }
-      assert.deepEqual(transferBudgetViolations(runs), []);
-    }).pipe(Effect.provide(NodeServices.layer)),
-  120_000,
-);
diff --git a/apps/server/src/server.ts b/apps/server/src/server.ts
index c50244d64973..70cfa2f5ab32 100644
--- a/apps/server/src/server.ts
+++ b/apps/server/src/server.ts
@@ -29,13 +29,8 @@ import * as PullRequestService from "./pullRequest/PullRequestService.ts";
 import { layerConfig as SqlitePersistenceLayerLive } from "./persistence/Layers/Sqlite.ts";
 import * as ServerLifecycleEvents from "./serverLifecycleEvents.ts";
 import * as AnalyticsService from "./telemetry/AnalyticsService.ts";
-import { ProviderSessionDirectoryLive } from "./provider/Layers/ProviderSessionDirectory.ts";
-import * as ProviderSessionRuntime from "./persistence/ProviderSessionRuntime.ts";
-import { ProviderAdapterRegistryLive } from "./provider/Layers/ProviderAdapterRegistry.ts";
 import * as ModelManifest from "./provider/ModelManifest.ts";
 import * as ProviderEventLoggers from "./provider/Layers/ProviderEventLoggers.ts";
-import { ProviderServiceLive } from "./provider/Layers/ProviderService.ts";
-import { ProviderSessionReaperLive } from "./provider/Layers/ProviderSessionReaper.ts";
 import * as OpenCodeRuntime from "./provider/opencodeRuntime.ts";
 import * as CheckpointDiffQuery from "./checkpointing/CheckpointDiffQuery.ts";
 import * as CheckpointStore from "./checkpointing/CheckpointStore.ts";
@@ -56,16 +51,11 @@ import * as GitManager from "./git/GitManager.ts";
 import * as EnvironmentTheme from "./environmentTheme.ts";
 import * as Keybindings from "./keybindings.ts";
 import * as ServerRuntimeStartup from "./serverRuntimeStartup.ts";
-import { OrchestrationReactorLive } from "./orchestration/Layers/OrchestrationReactor.ts";
-import { RuntimeReceiptBusLive } from "./orchestration/Layers/RuntimeReceiptBus.ts";
-import { ProviderRuntimeIngestionLive } from "./orchestration/Layers/ProviderRuntimeIngestion.ts";
-import { ProviderCommandReactorLive } from "./orchestration/Layers/ProviderCommandReactor.ts";
-import { CheckpointReactorLive } from "./orchestration/Layers/CheckpointReactor.ts";
-import { ThreadDeletionReactorLive } from "./orchestration/Layers/ThreadDeletionReactor.ts";
 import * as AgentAwarenessRelay from "./relay/AgentAwarenessRelay.ts";
 import { hasCloudPublicConfig } from "./cloud/publicConfig.ts";
 import { ProviderRegistryLive } from "./provider/Layers/ProviderRegistry.ts";
 import * as ServerSettings from "./serverSettings.ts";
+import * as ProjectEnrichmentService from "./project/ProjectEnrichmentService.ts";
 import * as ProjectFaviconResolver from "./project/ProjectFaviconResolver.ts";
 import * as T3ProjectFileLoader from "./project/T3ProjectFileLoader.ts";
 import * as RepositoryIdentityResolver from "./project/RepositoryIdentityResolver.ts";
@@ -83,7 +73,6 @@ import * as ReviewService from "./review/ReviewService.ts";
 import * as SourceControlProviderRegistry from "./sourceControl/SourceControlProviderRegistry.ts";
 import * as SourceControlRateLimit from "./sourceControl/SourceControlRateLimit.ts";
 import * as SourceControlRepositoryService from "./sourceControl/SourceControlRepositoryService.ts";
-import * as ProjectSetupScriptRunner from "./project/ProjectSetupScriptRunner.ts";
 import { ObservabilityLive } from "./observability/Layers/Observability.ts";
 import * as ServerEnvironment from "./environment/ServerEnvironment.ts";
 import * as RemoteOpenTargets from "./environment/RemoteOpenTargets.ts";
@@ -112,12 +101,19 @@ import * as ResourceMonitorBinary from "./resourceTelemetry/ResourceMonitorBinar
 import * as ResourceTelemetry from "./resourceTelemetry/ResourceTelemetry.ts";
 import * as UsageService from "./usage/UsageService.ts";
 import { OrchestrationLayerLive } from "./orchestration/runtimeLayer.ts";
+import {
+  OrchestrationV2ProductionLayerLive,
+  ProjectSetupScriptRunnerLayerLive,
+} from "./orchestration-v2/runtimeLayer.ts";
+import * as ResourceCleanupService from "./orchestration-v2/ResourceCleanupService.ts";
+import * as RunFinalizationService from "./orchestration-v2/RunFinalizationService.ts";
 import {
   clearPersistedServerRuntimeState,
   makePersistedServerRuntimeState,
   persistServerRuntimeState,
 } from "./serverRuntimeState.ts";
-import { orchestrationHttpApiLayer } from "./orchestration/http.ts";
+import { orchestrationHttpApiLayer } from "./orchestration-v2/http.ts";
+import { projectHttpApiLayer } from "./project/http.ts";
 import * as NetService from "@t3tools/shared/Net";
 import * as RelayClient from "@t3tools/shared/relayClient";
 import { disableTailscaleServe, ensureTailscaleServe } from "@t3tools/tailscale";
@@ -245,31 +241,6 @@ const PlatformServicesLive = Layer.unwrap(
   }),
 );
 
-const ReactorLayerLive = Layer.empty.pipe(
-  Layer.provideMerge(OrchestrationReactorLive),
-  Layer.provideMerge(ProviderRuntimeIngestionLive),
-  Layer.provideMerge(ProviderCommandReactorLive),
-  Layer.provideMerge(CheckpointReactorLive),
-  Layer.provideMerge(ThreadDeletionReactorLive),
-  Layer.provideMerge(AgentAwarenessRelay.layer.pipe(Layer.provide(ServerSecretStore.layer))),
-  Layer.provideMerge(RuntimeReceiptBusLive),
-);
-
-const ProviderSessionDirectoryLayerLive = ProviderSessionDirectoryLive.pipe(
-  Layer.provide(ProviderSessionRuntime.layer),
-);
-
-// `ProviderAdapterRegistryLive` is now a facade that resolves kind → adapter
-// by looking up the default `ProviderInstance` per driver in the instance
-// registry. Adapter construction itself moved inside each driver's
-// `create()`; `ProviderEventLoggers.layer` owns the shared native/canonical
-// NDJSON writers and is provided at the outer runtime layer so both
-// `ProviderService` and the per-instance drivers read the same logger pair.
-const ProviderLayerLive = ProviderServiceLive.pipe(
-  Layer.provide(ProviderAdapterRegistryLive),
-  Layer.provideMerge(ProviderSessionDirectoryLayerLive),
-);
-
 const PersistenceLayerLive = Layer.empty.pipe(Layer.provideMerge(SqlitePersistenceLayerLive));
 
 const VcsDriverRegistryLayerLive = VcsDriverRegistry.layer.pipe(
@@ -285,7 +256,7 @@ const SourceControlProviderRegistryLayerLive = SourceControlProviderRegistry.lay
 );
 
 const GitManagerLayerLive = GitManager.layer.pipe(
-  Layer.provideMerge(ProjectSetupScriptRunner.layer),
+  Layer.provideMerge(ProjectSetupScriptRunnerLayerLive),
   Layer.provideMerge(GitVcsDriver.layer),
   Layer.provideMerge(SourceControlProviderRegistryLayerLive),
   Layer.provideMerge(TextGeneration.layer),
@@ -321,9 +292,8 @@ const VcsLayerLive = Layer.empty.pipe(
   Layer.provideMerge(VcsStatusBroadcaster.layer.pipe(Layer.provide(GitWorkflowLayerLive))),
 );
 
-const CheckpointingLayerLive = Layer.empty.pipe(
-  Layer.provideMerge(CheckpointDiffQuery.layer),
-  Layer.provideMerge(CheckpointStore.layer.pipe(Layer.provide(VcsDriverRegistryLayerLive))),
+const CheckpointStoreLayerLive = CheckpointStore.layer.pipe(
+  Layer.provide(VcsDriverRegistryLayerLive),
 );
 
 const PortScannerLayerLive = PortScanner.layer.pipe(Layer.provide(ProcessRunner.layer));
@@ -369,19 +339,25 @@ const CloudManagedEndpointRuntimeLive = Layer.mergeAll(
   ),
 );
 
-const ProviderRuntimeLayerLive = ProviderSessionReaperLive.pipe(
-  Layer.provideMerge(ProviderLayerLive),
-  Layer.provideMerge(OrchestrationLayerLive),
+const OrchestrationV2RuntimeLayerLive = OrchestrationV2ProductionLayerLive.pipe(
+  Layer.provide(CheckpointStoreLayerLive),
+  Layer.provide(GitWorkflowLayerLive),
+  Layer.provide(ResourceCleanupService.live),
+  Layer.provide(RunFinalizationService.observerLive),
+);
+
+const OrchestrationApplicationLayerLive = CheckpointDiffQuery.layer.pipe(
+  Layer.provideMerge(CheckpointStoreLayerLive),
+  Layer.provideMerge(OrchestrationV2RuntimeLayerLive),
 );
 
-const RuntimeCoreDependenciesLive = ReactorLayerLive.pipe(
+const RuntimeCoreDependenciesBaseLive = AgentAwarenessRelay.layer.pipe(
   // Core Services
+  Layer.provideMerge(OrchestrationApplicationLayerLive),
   Layer.provideMerge(ServerSettingsLayerLive),
-  Layer.provideMerge(CheckpointingLayerLive),
   Layer.provideMerge(SourceControlProviderRegistryLayerLive),
   Layer.provideMerge(GitLayerLive),
   Layer.provideMerge(VcsLayerLive),
-  Layer.provideMerge(ProviderRuntimeLayerLive),
   Layer.provideMerge(Layer.mergeAll(TerminalLayerLive, PreviewLayerLive)),
   Layer.provideMerge(PersistenceLayerLive),
   // Both read a user-owned file out of the state directory and stream changes
@@ -394,9 +370,12 @@ const RuntimeCoreDependenciesLive = ReactorLayerLive.pipe(
   // `providerInstances` hydration merges `settings.providers.<kind>`
   // with explicit `providerInstances` entries on boot.
   Layer.provideMerge(ProviderInstanceRegistryHydrationLive),
+);
+
+const RuntimeCoreDependenciesLive = RuntimeCoreDependenciesBaseLive.pipe(
   // Shared native/canonical NDJSON writers used by both the per-instance
-  // drivers (native stream, written from inside each `<X>Adapter`) and
-  // `ProviderService` (canonical stream, written after event normalization).
+  // V2 drivers and the orchestration runtime. Provide resource attribution so
+  // the rewritten telemetry pipeline can account for logical NDJSON writes.
   // Provided once at the runtime level so every consumer sees the same
   // logger instances.
   // `ModelManifest.layer` is the legacy-model classification data, refreshed
@@ -410,6 +389,7 @@ const RuntimeCoreDependenciesLive = ReactorLayerLive.pipe(
   // keeps a single Live for all opencode consumers.
   Layer.provideMerge(OpenCodeRuntime.OpenCodeRuntimeLive),
   Layer.provideMerge(WorkspaceLayerLive),
+  Layer.provideMerge(ProjectEnrichmentService.layer),
   Layer.provideMerge(ProjectFaviconResolverLayerLive),
   Layer.provideMerge(RepositoryIdentityResolver.layer),
   Layer.provideMerge(ServerEnvironment.layer),
@@ -462,6 +442,7 @@ export const makeRoutesLayer = Layer.mergeAll(
       Layer.provide(connectHttpApiLayer),
       Layer.provide(orchestrationHttpApiLayer),
       Layer.provide(pullRequestHttpApiLayer),
+      Layer.provide(projectHttpApiLayer),
       Layer.provide(serverEnvironmentHttpApiLayer),
       Layer.provide(environmentAuthenticatedAuthLayer),
     ),
@@ -471,7 +452,9 @@ export const makeRoutesLayer = Layer.mergeAll(
     staticAndDevRouteLayer,
     websocketRpcRouteLayer,
   ),
-  McpHttpServer.layer.pipe(Layer.provide(McpSessionRegistry.layer)),
+  // The MCP session registry is provided globally (shared with V2 provider
+  // sessions) rather than inline here.
+  McpHttpServer.layer,
 ).pipe(
   // Both transports consume the same service instance, so caches single-flight across clients
   // and mutations observed on WebSocket invalidate patches subsequently read over HTTP.
@@ -686,6 +669,11 @@ export const makeServerLayer = Layer.unwrap(
 
     return serverApplicationLayer.pipe(
       Layer.provideMerge(runtimeServicesLive),
+      Layer.provideMerge(
+        McpSessionRegistry.layer.pipe(
+          Layer.provide(ServerEnvironment.layer.pipe(Layer.provide(ServerSecretStore.layer))),
+        ),
+      ),
       Layer.provide(activationLayer),
       Layer.provideMerge(serverRelayBrokerTracingLayer),
       Layer.provideMerge(HttpServerLive),
diff --git a/apps/server/src/serverActivation.ts b/apps/server/src/serverActivation.ts
index c068d55e7e76..21326973538d 100644
--- a/apps/server/src/serverActivation.ts
+++ b/apps/server/src/serverActivation.ts
@@ -1,6 +1,7 @@
 import * as Context from "effect/Context";
 import * as Deferred from "effect/Deferred";
 import * as Effect from "effect/Effect";
+import type * as Fiber from "effect/Fiber";
 import type * as Scope from "effect/Scope";
 
 export class ServerActivation extends Context.Reference<Effect.Effect<void> | undefined>(
@@ -8,19 +9,24 @@ export class ServerActivation extends Context.Reference<Effect.Effect<void> | un
   { defaultValue: () => undefined },
 ) {}
 
-/** Forks a long-running root before commit and proves it is parked at the activation boundary. */
-export const forkParked = <A, E, R>(
+/** Forks a long-running root before commit, returning it after it reaches the activation boundary. */
+export const forkParkedFiber = <A, E, R>(
   effect: Effect.Effect<A, E, R>,
-): Effect.Effect<void, never, Scope.Scope | R> =>
+): Effect.Effect<Fiber.Fiber<A, E>, never, Scope.Scope | R> =>
   Effect.gen(function* () {
     const activation = yield* ServerActivation;
     if (activation === undefined) {
-      yield* Effect.forkScoped(effect);
-      return;
+      return yield* Effect.forkScoped(effect);
     }
     const parked = yield* Deferred.make<void>();
-    yield* Effect.forkScoped(
+    const fiber = yield* Effect.forkScoped(
       Deferred.succeed(parked, undefined).pipe(Effect.andThen(activation), Effect.andThen(effect)),
     );
     yield* Deferred.await(parked);
+    return fiber;
   });
+
+/** Forks a long-running root before commit and proves it is parked at the activation boundary. */
+export const forkParked = <A, E, R>(
+  effect: Effect.Effect<A, E, R>,
+): Effect.Effect<void, never, Scope.Scope | R> => forkParkedFiber(effect).pipe(Effect.asVoid);
diff --git a/apps/server/src/serverLifecycleEvents.test.ts b/apps/server/src/serverLifecycleEvents.test.ts
index 4f7b75fb4bd3..28ba41125b57 100644
--- a/apps/server/src/serverLifecycleEvents.test.ts
+++ b/apps/server/src/serverLifecycleEvents.test.ts
@@ -46,8 +46,31 @@ it.effect(
       assertTrue(Option.isSome(ready));
       assert.equal(ready.value.sequence, 2);
 
+      yield* lifecycleEvents.publish({
+        version: 1,
+        type: "legacyThreadMigration",
+        payload: {
+          status: "running",
+          totalThreadCount: 12,
+        },
+      });
+      yield* lifecycleEvents.publish({
+        version: 1,
+        type: "legacyThreadMigration",
+        payload: {
+          status: "complete",
+          totalThreadCount: 12,
+        },
+      });
+
       const snapshot = yield* lifecycleEvents.snapshot;
-      assert.equal(snapshot.sequence, 2);
-      assert.deepEqual(snapshot.events.map((event) => event.type).toSorted(), ["ready", "welcome"]);
+      assert.equal(snapshot.sequence, 4);
+      assert.deepEqual(snapshot.events.map((event) => event.type).toSorted(), [
+        "legacyThreadMigration",
+        "ready",
+        "welcome",
+      ]);
+      const migration = snapshot.events.find((event) => event.type === "legacyThreadMigration");
+      assert.equal(migration?.payload.status, "complete");
     }).pipe(Effect.provide(ServerLifecycleEvents.layer)),
 );
diff --git a/apps/server/src/serverLifecycleEvents.ts b/apps/server/src/serverLifecycleEvents.ts
index 855d03490efe..7d394e4dc913 100644
--- a/apps/server/src/serverLifecycleEvents.ts
+++ b/apps/server/src/serverLifecycleEvents.ts
@@ -8,7 +8,8 @@ import * as Stream from "effect/Stream";
 
 type LifecycleEventInput =
   | Omit<Extract<ServerLifecycleStreamEvent, { type: "welcome" }>, "sequence">
-  | Omit<Extract<ServerLifecycleStreamEvent, { type: "ready" }>, "sequence">;
+  | Omit<Extract<ServerLifecycleStreamEvent, { type: "ready" }>, "sequence">
+  | Omit<Extract<ServerLifecycleStreamEvent, { type: "legacyThreadMigration" }>, "sequence">;
 
 interface SnapshotState {
   readonly sequence: number;
@@ -39,10 +40,10 @@ const make = Effect.gen(function* () {
           ...event,
           sequence: nextSequence,
         } satisfies ServerLifecycleStreamEvent;
-        const nextEvents =
-          nextEvent.type === "welcome"
-            ? [nextEvent, ...current.events.filter((entry) => entry.type !== "welcome")]
-            : [nextEvent, ...current.events.filter((entry) => entry.type !== "ready")];
+        const nextEvents = [
+          nextEvent,
+          ...current.events.filter((entry) => entry.type !== nextEvent.type),
+        ];
         return [nextEvent, { sequence: nextSequence, events: nextEvents }] as const;
       }).pipe(Effect.tap((event) => PubSub.publish(pubsub, event))),
     snapshot: Ref.get(state),
diff --git a/apps/server/src/serverRuntimeStartup.reconcile.test.ts b/apps/server/src/serverRuntimeStartup.reconcile.test.ts
deleted file mode 100644
index 485cd5bb08a4..000000000000
--- a/apps/server/src/serverRuntimeStartup.reconcile.test.ts
+++ /dev/null
@@ -1,297 +0,0 @@
-import * as NodeServices from "@effect/platform-node/NodeServices";
-import {
-  type OrchestrationCommand,
-  ProviderDriverKind,
-  ProviderInstanceId,
-  ThreadId,
-  TurnId,
-} from "@t3tools/contracts";
-import { assert, it } from "@effect/vitest";
-import * as Effect from "effect/Effect";
-import * as Option from "effect/Option";
-import * as Stream from "effect/Stream";
-
-import { OrchestrationCommandInvariantError } from "./orchestration/Errors.ts";
-import * as OrchestrationEngine from "./orchestration/Services/OrchestrationEngine.ts";
-import * as ProjectionSnapshotQuery from "./orchestration/Services/ProjectionSnapshotQuery.ts";
-import { ProviderSessionDirectoryPersistenceError } from "./provider/Errors.ts";
-import * as ProviderService from "./provider/Services/ProviderService.ts";
-import * as ProviderSessionDirectory from "./provider/Services/ProviderSessionDirectory.ts";
-import * as ServerRuntimeStartup from "./serverRuntimeStartup.ts";
-
-const providerInstanceId = ProviderInstanceId.make("codex");
-const updatedAt = "2026-08-20T12:00:00.000Z";
-
-const makeThread = (
-  id: string,
-  status: "starting" | "running" | "ready" | "stopped" | "error",
-  activeTurnId: TurnId | null = null,
-  archivedAt: string | null = null,
-) => ({
-  id: ThreadId.make(id),
-  archivedAt,
-  deletedAt: null,
-  session: {
-    threadId: ThreadId.make(id),
-    status,
-    providerName: "codex" as const,
-    providerInstanceId,
-    runtimeMode: "full-access" as const,
-    activeTurnId,
-    lastError: null,
-    updatedAt,
-  },
-});
-
-const makeProviderService = (liveThreadIds: ReadonlyArray<ThreadId> = []) =>
-  ({
-    startSession: () => Effect.die("unused"),
-    sendTurn: () => Effect.die("unused"),
-    interruptTurn: () => Effect.die("unused"),
-    respondToRequest: () => Effect.die("unused"),
-    respondToUserInput: () => Effect.die("unused"),
-    stopSession: () => Effect.die("unused"),
-    listSessions: () => Effect.succeed(liveThreadIds.map((threadId) => ({ threadId }) as never)),
-    getCapabilities: () => Effect.die("unused"),
-    getInstanceInfo: () => Effect.die("unused"),
-    rollbackConversation: () => Effect.die("unused"),
-    uploadFeedback: () => Effect.die("unused"),
-    streamEvents: Stream.empty,
-  }) satisfies ProviderService.ProviderService["Service"];
-
-const queryWithThreads = (threads: ReadonlyArray<ReturnType<typeof makeThread>>) =>
-  ({
-    getCommandReadModel: () => Effect.succeed({ threads } as never),
-  }) as unknown as ProjectionSnapshotQuery.ProjectionSnapshotQuery["Service"];
-
-const runReconciliation = (input: {
-  readonly threads: ReadonlyArray<ReturnType<typeof makeThread>>;
-  readonly liveThreadIds?: ReadonlyArray<ThreadId>;
-  readonly directory: ProviderSessionDirectory.ProviderSessionDirectory["Service"];
-  readonly dispatch: OrchestrationEngine.OrchestrationEngineService["Service"]["dispatch"];
-}) =>
-  ServerRuntimeStartup.reconcileProviderSessions.pipe(
-    Effect.provideService(
-      ProjectionSnapshotQuery.ProjectionSnapshotQuery,
-      queryWithThreads(input.threads),
-    ),
-    Effect.provideService(
-      ProviderService.ProviderService,
-      makeProviderService(input.liveThreadIds),
-    ),
-    Effect.provideService(ProviderSessionDirectory.ProviderSessionDirectory, input.directory),
-    Effect.provideService(OrchestrationEngine.OrchestrationEngineService, {
-      readEvents: () => Stream.empty,
-      dispatch: input.dispatch,
-      streamDomainEvents: Stream.empty,
-      latestSequence: Effect.succeed(0),
-    }),
-    Effect.provide(NodeServices.layer),
-  );
-
-it.effect("reconciles multiple active and archived orphans but skips live sessions", () => {
-  const starting = makeThread("thread-starting", "starting");
-  const running = makeThread("thread-running", "running", TurnId.make("turn-running"));
-  const staleActiveTurn = makeThread(
-    "thread-stale-active-turn",
-    "ready",
-    TurnId.make("turn-stale-active"),
-  );
-  const archived = makeThread(
-    "thread-archived",
-    "running",
-    TurnId.make("turn-archived"),
-    updatedAt,
-  );
-  const live = makeThread("thread-live", "running", TurnId.make("turn-live"));
-  const settled = makeThread("thread-ready", "ready");
-  const dispatched: OrchestrationCommand[] = [];
-  const bindingReads: ThreadId[] = [];
-  const upserts: ProviderSessionDirectory.ProviderRuntimeBinding[] = [];
-
-  return runReconciliation({
-    threads: [starting, running, staleActiveTurn, archived, live, settled],
-    liveThreadIds: [live.id],
-    directory: {
-      getBinding: (candidate) =>
-        Effect.sync(() => bindingReads.push(candidate)).pipe(
-          Effect.as(
-            Option.some({
-              threadId: candidate,
-              provider: ProviderDriverKind.make("codex"),
-              providerInstanceId,
-              status: "running" as const,
-              resumeCursor: { cursor: candidate },
-              runtimePayload: { activeTurnId: "stale", unrelated: candidate },
-            }),
-          ),
-        ),
-      upsert: (binding) => Effect.sync(() => upserts.push(binding)),
-      getProvider: () => Effect.die("unused"),
-      listThreadIds: () => Effect.die("unused"),
-      listBindings: () => Effect.die("unused"),
-    },
-    dispatch: (command) =>
-      Effect.sync(() => dispatched.push(command)).pipe(Effect.as({ sequence: dispatched.length })),
-  }).pipe(
-    Effect.tap(() =>
-      Effect.sync(() => {
-        const orphanIds = [starting.id, running.id, staleActiveTurn.id, archived.id];
-        assert.deepStrictEqual(bindingReads, orphanIds);
-        assert.deepStrictEqual(
-          dispatched.map((command) => command.type === "thread.session.set" && command.threadId),
-          orphanIds,
-        );
-        assert.deepStrictEqual(
-          dispatched.map((command) =>
-            command.type === "thread.session.set"
-              ? {
-                  status: command.session.status,
-                  activeTurnId: command.session.activeTurnId,
-                }
-              : null,
-          ),
-          orphanIds.map(() => ({ status: "error" as const, activeTurnId: null })),
-        );
-        assert.equal(upserts.length, orphanIds.length);
-        for (const binding of upserts) {
-          assert.equal(binding.status, "stopped");
-          assert.deepStrictEqual(binding.runtimePayload, { activeTurnId: null });
-          assert.deepStrictEqual(binding.resumeCursor, { cursor: binding.threadId });
-        }
-      }),
-    ),
-  );
-});
-
-it.effect(
-  "settles projections when directory bindings are absent, corrupt, or fail to upsert",
-  () => {
-    const absent = makeThread("thread-binding-absent", "starting");
-    const corrupt = makeThread("thread-binding-corrupt", "running");
-    const upsertFailure = makeThread("thread-binding-upsert-failure", "running");
-    const dispatched: OrchestrationCommand[] = [];
-    const corruptFailure = new ProviderSessionDirectoryPersistenceError({
-      operation: "ProviderSessionDirectory.getBinding",
-      detail: "corrupt persisted binding",
-    });
-    const writeFailure = new ProviderSessionDirectoryPersistenceError({
-      operation: "ProviderSessionDirectory.upsert",
-      detail: "failed binding write",
-    });
-
-    return runReconciliation({
-      threads: [absent, corrupt, upsertFailure],
-      directory: {
-        getBinding: (candidate) =>
-          candidate === absent.id
-            ? Effect.succeed(Option.none())
-            : candidate === corrupt.id
-              ? Effect.fail(corruptFailure)
-              : Effect.succeed(
-                  Option.some({
-                    threadId: candidate,
-                    provider: ProviderDriverKind.make("codex"),
-                    providerInstanceId,
-                  }),
-                ),
-        upsert: () => Effect.fail(writeFailure),
-        getProvider: () => Effect.die("unused"),
-        listThreadIds: () => Effect.die("unused"),
-        listBindings: () => Effect.die("unused"),
-      },
-      dispatch: (command) =>
-        Effect.sync(() => dispatched.push(command)).pipe(
-          Effect.as({ sequence: dispatched.length }),
-        ),
-    }).pipe(
-      Effect.tap(() =>
-        Effect.sync(() => {
-          assert.deepStrictEqual(
-            dispatched.map((command) => command.type === "thread.session.set" && command.threadId),
-            [absent.id, corrupt.id, upsertFailure.id],
-          );
-        }),
-      ),
-    );
-  },
-);
-
-it.effect("retries failed projections and continues after a persistent failure", () => {
-  const transient = makeThread("thread-dispatch-transient-failure", "running");
-  const persistent = makeThread("thread-dispatch-persistent-failure", "running");
-  const later = makeThread("thread-dispatch-success", "running");
-  const attempted: ThreadId[] = [];
-  let transientAttempts = 0;
-  const failure = new OrchestrationCommandInvariantError({
-    commandType: "thread.session.set",
-    detail: "simulated startup reconciliation failure",
-  });
-
-  return runReconciliation({
-    threads: [transient, persistent, later],
-    directory: {
-      getBinding: () => Effect.succeed(Option.none()),
-      upsert: () => Effect.void,
-      getProvider: () => Effect.die("unused"),
-      listThreadIds: () => Effect.die("unused"),
-      listBindings: () => Effect.die("unused"),
-    },
-    dispatch: (command) => {
-      if (command.type !== "thread.session.set") {
-        return Effect.die("unexpected command");
-      }
-      attempted.push(command.threadId);
-      if (command.threadId === transient.id && transientAttempts++ === 0) {
-        return Effect.fail(failure);
-      }
-      return command.threadId === persistent.id
-        ? Effect.fail(failure)
-        : Effect.succeed({ sequence: attempted.length });
-    },
-  }).pipe(
-    Effect.tap(() =>
-      Effect.sync(() =>
-        assert.deepStrictEqual(attempted, [
-          transient.id,
-          transient.id,
-          persistent.id,
-          persistent.id,
-          later.id,
-        ]),
-      ),
-    ),
-  );
-});
-
-it.effect("does not fail startup when the live provider session inventory cannot be read", () => {
-  let queried = false;
-  return ServerRuntimeStartup.reconcileProviderSessions.pipe(
-    Effect.provideService(ProjectionSnapshotQuery.ProjectionSnapshotQuery, {
-      getCommandReadModel: () =>
-        Effect.sync(() => {
-          queried = true;
-          return { threads: [] } as never;
-        }),
-    } as unknown as ProjectionSnapshotQuery.ProjectionSnapshotQuery["Service"]),
-    Effect.provideService(ProviderService.ProviderService, {
-      ...makeProviderService(),
-      listSessions: () => Effect.die("provider inventory unavailable"),
-    }),
-    Effect.provideService(ProviderSessionDirectory.ProviderSessionDirectory, {
-      getBinding: () => Effect.die("unused"),
-      upsert: () => Effect.die("unused"),
-      getProvider: () => Effect.die("unused"),
-      listThreadIds: () => Effect.die("unused"),
-      listBindings: () => Effect.die("unused"),
-    }),
-    Effect.provideService(OrchestrationEngine.OrchestrationEngineService, {
-      readEvents: () => Stream.empty,
-      dispatch: () => Effect.die("unused"),
-      streamDomainEvents: Stream.empty,
-      latestSequence: Effect.succeed(0),
-    }),
-    Effect.provide(NodeServices.layer),
-    Effect.tap(() => Effect.sync(() => assert.equal(queried, false))),
-  );
-});
diff --git a/apps/server/src/serverRuntimeStartup.test.ts b/apps/server/src/serverRuntimeStartup.test.ts
index e3f7e482b2e0..56f847be2684 100644
--- a/apps/server/src/serverRuntimeStartup.test.ts
+++ b/apps/server/src/serverRuntimeStartup.test.ts
@@ -1,46 +1,99 @@
-import * as NodeServices from "@effect/platform-node/NodeServices";
-import { DEFAULT_MODEL, ProjectId, ProviderInstanceId, ThreadId } from "@t3tools/contracts";
 import { assert, it } from "@effect/vitest";
-import * as Crypto from "effect/Crypto";
+import { DEFAULT_MODEL, ProviderInstanceId } from "@t3tools/contracts";
 import * as Deferred from "effect/Deferred";
 import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
 import * as Fiber from "effect/Fiber";
-import * as Option from "effect/Option";
-import * as PlatformError from "effect/PlatformError";
 import * as Ref from "effect/Ref";
-import * as Stream from "effect/Stream";
 
 import * as ServerConfig from "./config.ts";
-import * as OrchestrationEngine from "./orchestration/Services/OrchestrationEngine.ts";
-import * as ProjectionSnapshotQuery from "./orchestration/Services/ProjectionSnapshotQuery.ts";
-import * as AnalyticsService from "./telemetry/AnalyticsService.ts";
 import * as ServerRuntimeStartup from "./serverRuntimeStartup.ts";
 
-it("uses the canonical Codex default for auto-bootstrapped model selection", () => {
-  assert.deepStrictEqual(ServerRuntimeStartup.getAutoBootstrapDefaultModelSelection(), {
+it("uses the canonical Codex model for auto-bootstrap", () => {
+  assert.deepEqual(ServerRuntimeStartup.getAutoBootstrapDefaultModelSelection(), {
     instanceId: ProviderInstanceId.make("codex"),
     model: DEFAULT_MODEL,
   });
 });
 
-it.effect("enqueueCommand waits for readiness and then drains queued work", () =>
+it.effect("runs projection repair, recovery, worker startup, and bootstrap in order", () =>
+  Effect.gen(function* () {
+    const calls = yield* Ref.make<ReadonlyArray<string>>([]);
+    const record = (label: string) => Ref.update(calls, (current) => [...current, label]);
+
+    const result = yield* ServerRuntimeStartup.runOrderedV2StartupPhases({
+      importLegacyShells: record("import"),
+      verify: record("verify").pipe(Effect.as({ valid: false })),
+      rebuild: record("rebuild").pipe(Effect.as({ valid: true })),
+      recover: record("recover").pipe(Effect.as({ closedRequests: 2 })),
+      startEffectWorker: record("worker"),
+      autoBootstrap: record("bootstrap").pipe(Effect.as({ projectId: "project-1" })),
+    });
+
+    assert.deepEqual(yield* Ref.get(calls), [
+      "import",
+      "verify",
+      "rebuild",
+      "recover",
+      "worker",
+      "bootstrap",
+    ]);
+    assert.deepEqual(result, {
+      recovery: { closedRequests: 2 },
+      bootstrap: { projectId: "project-1" },
+    });
+  }),
+);
+
+it.effect("does not rebuild valid projections", () =>
+  Effect.gen(function* () {
+    const rebuilt = yield* Ref.make(false);
+    yield* ServerRuntimeStartup.runOrderedV2StartupPhases({
+      importLegacyShells: Effect.void,
+      verify: Effect.succeed({ valid: true }),
+      rebuild: Ref.set(rebuilt, true).pipe(Effect.as({ valid: true })),
+      recover: Effect.void,
+      startEffectWorker: Effect.void,
+      autoBootstrap: Effect.void,
+    });
+    assert.isFalse(yield* Ref.get(rebuilt));
+  }),
+);
+
+it.effect("interrupts the effect worker when awareness relay startup fails", () =>
   Effect.scoped(
     Effect.gen(function* () {
-      const executionCount = yield* Ref.make(0);
-      const commandGate = yield* ServerRuntimeStartup.makeCommandGate;
+      const workerInterrupted = yield* Ref.make(false);
+      const workerFiberRef = yield* Ref.make<Fiber.Fiber<void, never> | null>(null);
+
+      const exit = yield* ServerRuntimeStartup.startEffectWorkerWithRelay({
+        runWorker: Effect.never.pipe(Effect.ensuring(Ref.set(workerInterrupted, true))),
+        startRelay: Effect.yieldNow.pipe(
+          Effect.andThen(Effect.die("awareness relay startup failed")),
+        ),
+        workerFiberRef,
+      }).pipe(Effect.exit);
+
+      assert.isTrue(Exit.isFailure(exit));
+      assert.isTrue(yield* Ref.get(workerInterrupted));
+      assert.isNull(yield* Ref.get(workerFiberRef));
+    }),
+  ),
+);
 
-      const queuedCommandFiber = yield* commandGate
-        .enqueueCommand(Ref.updateAndGet(executionCount, (count) => count + 1))
+it.effect("queues commands until startup signals readiness", () =>
+  Effect.scoped(
+    Effect.gen(function* () {
+      const gate = yield* ServerRuntimeStartup.makeCommandGate;
+      const count = yield* Ref.make(0);
+      const queued = yield* gate
+        .enqueueCommand(Ref.updateAndGet(count, (value) => value + 1))
         .pipe(Effect.forkScoped);
 
       yield* Effect.yieldNow;
-      assert.equal(yield* Ref.get(executionCount), 0);
-
-      yield* commandGate.signalCommandReady;
-
-      const result = yield* Fiber.join(queuedCommandFiber);
-      assert.equal(result, 1);
-      assert.equal(yield* Ref.get(executionCount), 1);
+      assert.equal(yield* Ref.get(count), 0);
+      yield* gate.signalCommandReady;
+      assert.equal(yield* Fiber.join(queued), 1);
     }),
   ),
 );
@@ -70,44 +123,6 @@ it.effect("enqueueCommand fails queued work when readiness fails", () =>
   ),
 );
 
-it.effect("launchStartupHeartbeat does not block the caller while counts are loading", () =>
-  Effect.scoped(
-    Effect.gen(function* () {
-      const releaseCounts = yield* Deferred.make<void, never>();
-
-      yield* ServerRuntimeStartup.launchStartupHeartbeat.pipe(
-        Effect.provideService(ProjectionSnapshotQuery.ProjectionSnapshotQuery, {
-          getCommandReadModel: () => Effect.die("unused"),
-          getSnapshot: () => Effect.die("unused"),
-          getShellSnapshot: () => Effect.die("unused"),
-          getArchivedShellSnapshot: () => Effect.die("unused"),
-          getSnapshotSequence: () => Effect.die("unused"),
-          getCounts: () =>
-            Deferred.await(releaseCounts).pipe(
-              Effect.as({
-                projectCount: 2,
-                threadCount: 3,
-              }),
-            ),
-          getActiveProjectByWorkspaceRoot: () => Effect.succeed(Option.none()),
-          getProjectShellById: () => Effect.succeed(Option.none()),
-          getFirstActiveThreadIdByProjectId: () => Effect.succeed(Option.none()),
-          getThreadCheckpointContext: () => Effect.succeed(Option.none()),
-          getFullThreadDiffContext: () => Effect.succeed(Option.none()),
-          getThreadShellById: () => Effect.succeed(Option.none()),
-          getThreadDetailById: () => Effect.succeed(Option.none()),
-          getThreadDetailSnapshot: () => Effect.succeed(Option.none()),
-          searchThreads: () => Effect.succeed({ matches: [] }),
-        }),
-        Effect.provideService(AnalyticsService.AnalyticsService, {
-          record: () => Effect.void,
-          flush: Effect.void,
-        }),
-      );
-    }),
-  ),
-);
-
 it.effect("resolveWelcomeBase derives cwd and project name from server config", () =>
   Effect.gen(function* () {
     const welcome = yield* ServerRuntimeStartup.resolveWelcomeBase.pipe(
@@ -122,160 +137,3 @@ it.effect("resolveWelcomeBase derives cwd and project name from server config",
     });
   }),
 );
-
-it.effect("resolveAutoBootstrapWelcomeTargets returns existing project and thread ids", () => {
-  const bootstrapProjectId = ProjectId.make("project-startup-bootstrap");
-  const bootstrapThreadId = ThreadId.make("thread-startup-bootstrap");
-
-  return Effect.gen(function* () {
-    const dispatchCalls = yield* Ref.make<ReadonlyArray<string>>([]);
-    const targets = yield* ServerRuntimeStartup.resolveAutoBootstrapWelcomeTargets.pipe(
-      Effect.provideService(ServerConfig.ServerConfig, {
-        cwd: "/tmp/startup-project",
-        autoBootstrapProjectFromCwd: true,
-      } as never),
-      Effect.provideService(ProjectionSnapshotQuery.ProjectionSnapshotQuery, {
-        getCommandReadModel: () => Effect.die("unused"),
-        getSnapshot: () => Effect.die("unused"),
-        getShellSnapshot: () => Effect.die("unused"),
-        getArchivedShellSnapshot: () => Effect.die("unused"),
-        getSnapshotSequence: () => Effect.die("unused"),
-        getCounts: () => Effect.die("unused"),
-        getActiveProjectByWorkspaceRoot: () =>
-          Effect.succeed(
-            Option.some({
-              id: bootstrapProjectId,
-              title: "Startup Project",
-              workspaceRoot: "/tmp/startup-project",
-              defaultModelSelection: ServerRuntimeStartup.getAutoBootstrapDefaultModelSelection(),
-              scripts: [],
-              createdAt: "2026-01-01T00:00:00.000Z",
-              updatedAt: "2026-01-01T00:00:00.000Z",
-              deletedAt: null,
-            }),
-          ),
-        getProjectShellById: () => Effect.die("unused"),
-        getFirstActiveThreadIdByProjectId: () => Effect.succeed(Option.some(bootstrapThreadId)),
-        getThreadCheckpointContext: () => Effect.succeed(Option.none()),
-        getFullThreadDiffContext: () => Effect.succeed(Option.none()),
-        getThreadShellById: () => Effect.die("unused"),
-        getThreadDetailById: () => Effect.die("unused"),
-        getThreadDetailSnapshot: () => Effect.die("unused"),
-        searchThreads: () => Effect.succeed({ matches: [] }),
-      }),
-      Effect.provideService(OrchestrationEngine.OrchestrationEngineService, {
-        readEvents: () => Stream.empty,
-        dispatch: (command) =>
-          Ref.update(dispatchCalls, (calls) => [...calls, command.type]).pipe(
-            Effect.as({ sequence: 1 }),
-          ),
-        streamDomainEvents: Stream.empty,
-        latestSequence: Effect.succeed(0),
-      } satisfies OrchestrationEngine.OrchestrationEngineService["Service"]),
-      Effect.provide(NodeServices.layer),
-    );
-
-    assert.deepStrictEqual(targets, {
-      bootstrapProjectId,
-      bootstrapThreadId,
-    });
-    assert.deepStrictEqual(yield* Ref.get(dispatchCalls), []);
-  });
-});
-
-it.effect("resolveAutoBootstrapWelcomeTargets creates a project and thread when missing", () =>
-  Effect.gen(function* () {
-    const dispatchCalls = yield* Ref.make<ReadonlyArray<string>>([]);
-    const targets = yield* ServerRuntimeStartup.resolveAutoBootstrapWelcomeTargets.pipe(
-      Effect.provideService(ServerConfig.ServerConfig, {
-        cwd: "/tmp/startup-project",
-        autoBootstrapProjectFromCwd: true,
-      } as never),
-      Effect.provideService(ProjectionSnapshotQuery.ProjectionSnapshotQuery, {
-        getCommandReadModel: () => Effect.die("unused"),
-        getSnapshot: () => Effect.die("unused"),
-        getShellSnapshot: () => Effect.die("unused"),
-        getArchivedShellSnapshot: () => Effect.die("unused"),
-        getSnapshotSequence: () => Effect.die("unused"),
-        getCounts: () => Effect.die("unused"),
-        getActiveProjectByWorkspaceRoot: () => Effect.succeed(Option.none()),
-        getProjectShellById: () => Effect.die("unused"),
-        getFirstActiveThreadIdByProjectId: () => Effect.succeed(Option.none()),
-        getThreadCheckpointContext: () => Effect.succeed(Option.none()),
-        getFullThreadDiffContext: () => Effect.succeed(Option.none()),
-        getThreadShellById: () => Effect.die("unused"),
-        getThreadDetailById: () => Effect.die("unused"),
-        getThreadDetailSnapshot: () => Effect.die("unused"),
-        searchThreads: () => Effect.succeed({ matches: [] }),
-      }),
-      Effect.provideService(OrchestrationEngine.OrchestrationEngineService, {
-        readEvents: () => Stream.empty,
-        dispatch: (command) =>
-          Ref.update(dispatchCalls, (calls) => [...calls, command.type]).pipe(
-            Effect.as({ sequence: 1 }),
-          ),
-        streamDomainEvents: Stream.empty,
-        latestSequence: Effect.succeed(0),
-      } satisfies OrchestrationEngine.OrchestrationEngineService["Service"]),
-      Effect.provide(NodeServices.layer),
-    );
-
-    assert.equal(typeof targets.bootstrapProjectId, "string");
-    assert.equal(typeof targets.bootstrapThreadId, "string");
-    assert.deepStrictEqual(yield* Ref.get(dispatchCalls), ["project.create", "thread.create"]);
-  }),
-);
-
-it.effect("resolveAutoBootstrapWelcomeTargets preserves typed UUID generation failures", () =>
-  Effect.gen(function* () {
-    const crypto = yield* Crypto.Crypto;
-    const uuidError = PlatformError.systemError({
-      _tag: "Unknown",
-      module: "Crypto",
-      method: "randomUUIDv4",
-      description: "UUID generation unavailable",
-    });
-    const dispatchCalls = yield* Ref.make<ReadonlyArray<string>>([]);
-
-    const error = yield* ServerRuntimeStartup.resolveAutoBootstrapWelcomeTargets.pipe(
-      Effect.provideService(ServerConfig.ServerConfig, {
-        cwd: "/tmp/startup-project",
-        autoBootstrapProjectFromCwd: true,
-      } as never),
-      Effect.provideService(ProjectionSnapshotQuery.ProjectionSnapshotQuery, {
-        getCommandReadModel: () => Effect.die("unused"),
-        getSnapshot: () => Effect.die("unused"),
-        getShellSnapshot: () => Effect.die("unused"),
-        getArchivedShellSnapshot: () => Effect.die("unused"),
-        getSnapshotSequence: () => Effect.die("unused"),
-        getCounts: () => Effect.die("unused"),
-        getActiveProjectByWorkspaceRoot: () => Effect.succeed(Option.none()),
-        getProjectShellById: () => Effect.die("unused"),
-        getFirstActiveThreadIdByProjectId: () => Effect.succeed(Option.none()),
-        getThreadCheckpointContext: () => Effect.succeed(Option.none()),
-        getFullThreadDiffContext: () => Effect.succeed(Option.none()),
-        getThreadShellById: () => Effect.die("unused"),
-        getThreadDetailById: () => Effect.die("unused"),
-        getThreadDetailSnapshot: () => Effect.die("unused"),
-        searchThreads: () => Effect.succeed({ matches: [] }),
-      }),
-      Effect.provideService(OrchestrationEngine.OrchestrationEngineService, {
-        readEvents: () => Stream.empty,
-        dispatch: (command) =>
-          Ref.update(dispatchCalls, (calls) => [...calls, command.type]).pipe(
-            Effect.as({ sequence: 1 }),
-          ),
-        streamDomainEvents: Stream.empty,
-        latestSequence: Effect.succeed(0),
-      } satisfies OrchestrationEngine.OrchestrationEngineService["Service"]),
-      Effect.provideService(Crypto.Crypto, {
-        ...crypto,
-        randomUUIDv4: Effect.fail(uuidError),
-      }),
-      Effect.flip,
-    );
-
-    assert.strictEqual(error, uuidError);
-    assert.deepStrictEqual(yield* Ref.get(dispatchCalls), []);
-  }).pipe(Effect.provide(NodeServices.layer)),
-);
diff --git a/apps/server/src/serverRuntimeStartup.ts b/apps/server/src/serverRuntimeStartup.ts
index 6bea823b19c3..5c43775c7637 100644
--- a/apps/server/src/serverRuntimeStartup.ts
+++ b/apps/server/src/serverRuntimeStartup.ts
@@ -15,30 +15,32 @@ import * as DateTime from "effect/DateTime";
 import * as Deferred from "effect/Deferred";
 import * as Effect from "effect/Effect";
 import * as Exit from "effect/Exit";
+import * as Fiber from "effect/Fiber";
 import * as Layer from "effect/Layer";
-import * as Option from "effect/Option";
 import * as Path from "effect/Path";
 import * as Queue from "effect/Queue";
 import * as Ref from "effect/Ref";
 import * as Schema from "effect/Schema";
-import * as Scope from "effect/Scope";
 
 import * as ServerConfig from "./config.ts";
+import * as ServiceLauncherClient from "./cloud/serviceLauncherClient.ts";
 import * as Keybindings from "./keybindings.ts";
 import * as ExternalLauncher from "./process/externalLauncher.ts";
-import * as OrchestrationEngine from "./orchestration/Services/OrchestrationEngine.ts";
-import * as ProjectionSnapshotQuery from "./orchestration/Services/ProjectionSnapshotQuery.ts";
-import * as OrchestrationReactor from "./orchestration/Services/OrchestrationReactor.ts";
+import * as EffectWorker from "./orchestration-v2/EffectWorker.ts";
+import * as LegacyV1ThreadImporter from "./orchestration-v2/LegacyV1ThreadImporter.ts";
+import * as ProjectionMaintenance from "./orchestration-v2/ProjectionMaintenance.ts";
+import * as ProviderRuntimeRecovery from "./orchestration-v2/ProviderRuntimeRecoveryService.ts";
+import * as ProviderSessionManager from "./orchestration-v2/ProviderSessionManager.ts";
+import * as ThreadLaunch from "./orchestration-v2/ThreadLaunchService.ts";
+import * as ThreadManagement from "./orchestration-v2/ThreadManagementService.ts";
+import * as ProjectService from "./project/ProjectService.ts";
+import * as AgentAwarenessRelay from "./relay/AgentAwarenessRelay.ts";
 import * as ServerLifecycleEvents from "./serverLifecycleEvents.ts";
 import * as ServerSettings from "./serverSettings.ts";
+import { forkParked, forkParkedFiber } from "./serverActivation.ts";
 import * as AnalyticsService from "./telemetry/AnalyticsService.ts";
 import * as ServerEnvironment from "./environment/ServerEnvironment.ts";
 import * as EnvironmentAuth from "./auth/EnvironmentAuth.ts";
-import * as ProviderService from "./provider/Services/ProviderService.ts";
-import * as ProviderSessionDirectory from "./provider/Services/ProviderSessionDirectory.ts";
-import * as ProviderSessionReaper from "./provider/Services/ProviderSessionReaper.ts";
-import { forkParked } from "./serverActivation.ts";
-import * as ServiceLauncherClient from "./cloud/serviceLauncherClient.ts";
 import {
   formatHeadlessServeOutput,
   formatHostForUrl,
@@ -137,11 +139,19 @@ export const makeCommandGate = Effect.gen(function* () {
 
 export const recordStartupHeartbeat = Effect.gen(function* () {
   const analytics = yield* AnalyticsService.AnalyticsService;
-  const projectionSnapshotQuery = yield* ProjectionSnapshotQuery.ProjectionSnapshotQuery;
-
-  const { threadCount, projectCount } = yield* projectionSnapshotQuery.getCounts().pipe(
+  const projects = yield* ProjectService.ProjectService;
+  const threads = yield* ThreadManagement.ThreadManagementService;
+
+  const { threadCount, projectCount } = yield* Effect.all({
+    projects: projects.snapshot,
+    threads: threads.getShellSnapshot(),
+  }).pipe(
+    Effect.map(({ projects: projectSnapshot, threads: shellSnapshot }) => ({
+      projectCount: projectSnapshot.projects.length,
+      threadCount: shellSnapshot.threads.length + shellSnapshot.archivedThreads.length,
+    })),
     Effect.catch((cause) =>
-      Effect.logWarning("failed to gather startup projection counts for telemetry", {
+      Effect.logWarning("failed to gather V2 startup counts for telemetry", {
         cause,
       }).pipe(
         Effect.as({
@@ -171,6 +181,11 @@ export const getAutoBootstrapDefaultModelSelection = (): ModelSelection => ({
   model: DEFAULT_MODEL,
 });
 
+interface AutoBootstrapWelcomeTargets {
+  readonly bootstrapProjectId?: ProjectId;
+  readonly bootstrapThreadId?: ThreadId;
+}
+
 export const resolveWelcomeBase = Effect.gen(function* () {
   const serverConfig = yield* ServerConfig.ServerConfig;
   const segments = serverConfig.cwd.split(/[/\\]/).filter(Boolean);
@@ -186,72 +201,52 @@ export const resolveAutoBootstrapWelcomeTargets = Effect.gen(function* () {
   const crypto = yield* Crypto.Crypto;
   const randomUUID = crypto.randomUUIDv4;
   const serverConfig = yield* ServerConfig.ServerConfig;
-  const projectionReadModelQuery = yield* ProjectionSnapshotQuery.ProjectionSnapshotQuery;
-  const orchestrationEngine = yield* OrchestrationEngine.OrchestrationEngineService;
+  const projects = yield* ProjectService.ProjectService;
+  const threads = yield* ThreadManagement.ThreadManagementService;
+  const threadLaunch = yield* ThreadLaunch.ThreadLaunchService;
   const path = yield* Path.Path;
 
   let bootstrapProjectId: ProjectId | undefined;
   let bootstrapThreadId: ThreadId | undefined;
 
   if (serverConfig.autoBootstrapProjectFromCwd) {
-    yield* Effect.gen(function* () {
-      const existingProject = yield* projectionReadModelQuery.getActiveProjectByWorkspaceRoot(
-        serverConfig.cwd,
-      );
-      let nextProjectId: ProjectId;
-      let nextProjectDefaultModelSelection: ModelSelection;
-
-      if (Option.isNone(existingProject)) {
-        const createdAt = DateTime.formatIso(yield* DateTime.now);
-        nextProjectId = ProjectId.make(yield* randomUUID);
-        const bootstrapProjectTitle = path.basename(serverConfig.cwd) || "project";
-        nextProjectDefaultModelSelection = getAutoBootstrapDefaultModelSelection();
-        yield* orchestrationEngine.dispatch({
-          type: "project.create",
-          commandId: CommandId.make(yield* randomUUID),
-          projectId: nextProjectId,
-          title: bootstrapProjectTitle,
-          workspaceRoot: serverConfig.cwd,
-          defaultModelSelection: nextProjectDefaultModelSelection,
-          createdAt,
-        });
-      } else {
-        nextProjectId = existingProject.value.id;
-        nextProjectDefaultModelSelection =
-          existingProject.value.defaultModelSelection ?? getAutoBootstrapDefaultModelSelection();
-      }
-
-      const existingThreadId =
-        yield* projectionReadModelQuery.getFirstActiveThreadIdByProjectId(nextProjectId);
-      if (Option.isNone(existingThreadId)) {
-        const createdAt = DateTime.formatIso(yield* DateTime.now);
-        const createdThreadId = ThreadId.make(yield* randomUUID);
-        yield* orchestrationEngine.dispatch({
-          type: "thread.create",
-          commandId: CommandId.make(yield* randomUUID),
-          threadId: createdThreadId,
-          projectId: nextProjectId,
-          title: "New thread",
-          modelSelection: nextProjectDefaultModelSelection,
-          interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
-          runtimeMode: "full-access",
-          branch: null,
-          worktreePath: null,
-          createdAt,
-        });
-        bootstrapProjectId = nextProjectId;
-        bootstrapThreadId = createdThreadId;
-      } else {
-        bootstrapProjectId = nextProjectId;
-        bootstrapThreadId = existingThreadId.value;
-      }
+    const defaultModelSelection = getAutoBootstrapDefaultModelSelection();
+    const { project } = yield* projects.bootstrap({
+      commandId: CommandId.make(yield* randomUUID),
+      projectId: ProjectId.make(yield* randomUUID),
+      title: path.basename(serverConfig.cwd) || "project",
+      workspaceRoot: serverConfig.cwd,
+      defaultModelSelection,
     });
+    const shell = yield* threads.getShellSnapshot();
+    const existingThread = shell.threads.find(
+      (thread) =>
+        thread.projectId === project.id && thread.lineage.relationshipToParent !== "subagent",
+    );
+    if (existingThread === undefined) {
+      const launched = yield* threadLaunch.launch({
+        commandId: CommandId.make(yield* randomUUID),
+        projectId: project.id,
+        title: "New thread",
+        modelSelection: project.defaultModelSelection ?? defaultModelSelection,
+        interactionMode: DEFAULT_PROVIDER_INTERACTION_MODE,
+        runtimeMode: "full-access",
+        workspaceStrategy: { type: "root" },
+        createdBy: "system",
+        creationSource: "server",
+      });
+      bootstrapProjectId = project.id;
+      bootstrapThreadId = launched.threadId;
+    } else {
+      bootstrapProjectId = project.id;
+      bootstrapThreadId = existingThread.id;
+    }
   }
 
   return {
     ...(bootstrapProjectId ? { bootstrapProjectId } : {}),
     ...(bootstrapThreadId ? { bootstrapThreadId } : {}),
-  } as const;
+  } satisfies AutoBootstrapWelcomeTargets;
 });
 
 const resolveStartupBrowserTarget = Effect.gen(function* () {
@@ -293,101 +288,90 @@ const runStartupPhase = <A, E, R>(phase: string, effect: Effect.Effect<A, E, R>)
     Effect.withSpan(`server.startup.${phase}`),
   );
 
-const ORPHANED_PROVIDER_SESSION_ERROR =
-  "Provider session did not survive a server restart. Send a new message to continue.";
-
-export const reconcileProviderSessions = Effect.gen(function* () {
-  const crypto = yield* Crypto.Crypto;
-  const directory = yield* ProviderSessionDirectory.ProviderSessionDirectory;
-  const orchestrationEngine = yield* OrchestrationEngine.OrchestrationEngineService;
-  const providerService = yield* ProviderService.ProviderService;
-  const query = yield* ProjectionSnapshotQuery.ProjectionSnapshotQuery;
-
-  const liveThreadIds = new Set(
-    (yield* providerService.listSessions()).map((session) => session.threadId),
-  );
-  const { threads } = yield* query.getCommandReadModel();
-  const orphanedThreads = threads.filter(
-    (thread) =>
-      thread.session !== null &&
-      (thread.session.status === "starting" ||
-        thread.session.status === "running" ||
-        thread.session.activeTurnId !== null) &&
-      !liveThreadIds.has(thread.id),
-  );
-
-  for (const thread of orphanedThreads) {
-    const session = thread.session;
-    if (session === null) {
-      continue;
-    }
-    yield* Effect.gen(function* () {
-      const binding = yield* directory.getBinding(thread.id);
-      if (Option.isSome(binding)) {
-        yield* directory.upsert({
-          ...binding.value,
-          status: "stopped",
-          runtimePayload: { activeTurnId: null },
-        });
-      }
-    }).pipe(
-      Effect.catchCause((cause) =>
-        Cause.hasInterrupts(cause)
-          ? Effect.failCause(cause)
-          : Effect.logWarning("failed to reconcile orphaned provider session directory binding", {
-              threadId: thread.id,
-              cause,
-            }),
-      ),
-    );
-
-    yield* Effect.gen(function* () {
-      const reconciledAt = DateTime.formatIso(yield* DateTime.now);
-      yield* orchestrationEngine.dispatch({
-        type: "thread.session.set",
-        commandId: CommandId.make(yield* crypto.randomUUIDv4),
-        threadId: thread.id,
-        session: {
-          ...session,
-          status: "error",
-          activeTurnId: null,
-          lastError: ORPHANED_PROVIDER_SESSION_ERROR,
-          updatedAt: reconciledAt,
-        },
-        createdAt: reconciledAt,
-      });
-    }).pipe(
-      Effect.retry({ times: 1 }),
-      Effect.catchCause((cause) =>
-        Cause.hasInterrupts(cause)
-          ? Effect.failCause(cause)
-          : Effect.logWarning("failed to settle orphaned provider session projection", {
-              threadId: thread.id,
-              cause,
-            }),
-      ),
-    );
-  }
-}).pipe(
-  Effect.catchCause((cause) =>
-    Cause.hasInterrupts(cause)
-      ? Effect.failCause(cause)
-      : Effect.logWarning("provider session startup reconciliation failed", { cause }),
-  ),
-);
-
 interface StartupOptions {
   readonly activate?: Effect.Effect<void>;
   readonly awaitAuxiliaryParked?: Effect.Effect<void>;
   readonly abort?: (error: ServerRuntimeStartupError) => Effect.Effect<void>;
 }
 
+export const startEffectWorkerWithRelay = Effect.fn(
+  "ServerRuntimeStartup.startEffectWorkerWithRelay",
+)(function* <WorkerContext, RelayContext>(input: {
+  readonly runWorker: Effect.Effect<void, never, WorkerContext>;
+  readonly startRelay: Effect.Effect<void, never, RelayContext>;
+  readonly workerFiberRef: Ref.Ref<Fiber.Fiber<void, never> | null>;
+}) {
+  const workerFiber = yield* forkParkedFiber(input.runWorker);
+  yield* Ref.set(input.workerFiberRef, workerFiber);
+  yield* input.startRelay.pipe(
+    Effect.onExit((exit) => {
+      if (Exit.isSuccess(exit)) {
+        return Effect.void;
+      }
+      return Ref.getAndSet(input.workerFiberRef, null).pipe(
+        Effect.flatMap((ownedWorkerFiber) =>
+          ownedWorkerFiber === null
+            ? Effect.void
+            : Fiber.interrupt(ownedWorkerFiber).pipe(Effect.asVoid),
+        ),
+      );
+    }),
+  );
+});
+
+export function runOrderedV2StartupPhases<
+  Import,
+  Verification extends { readonly valid: boolean },
+  RebuildVerification extends { readonly valid: boolean },
+  Recovery,
+  Bootstrap,
+  ImportError,
+  VerifyError,
+  RebuildError,
+  RecoveryError,
+  WorkerError,
+  BootstrapError,
+  ImportContext,
+  VerifyContext,
+  RebuildContext,
+  RecoveryContext,
+  WorkerContext,
+  BootstrapContext,
+>(input: {
+  readonly importLegacyShells: Effect.Effect<Import, ImportError, ImportContext>;
+  readonly verify: Effect.Effect<Verification, VerifyError, VerifyContext>;
+  readonly rebuild: Effect.Effect<RebuildVerification, RebuildError, RebuildContext>;
+  readonly recover: Effect.Effect<Recovery, RecoveryError, RecoveryContext>;
+  readonly startEffectWorker: Effect.Effect<void, WorkerError, WorkerContext>;
+  readonly autoBootstrap: Effect.Effect<Bootstrap, BootstrapError, BootstrapContext>;
+}) {
+  return Effect.gen(function* () {
+    yield* input.importLegacyShells;
+    const verification = yield* input.verify;
+    if (!verification.valid) {
+      const rebuilt = yield* input.rebuild;
+      if (!rebuilt.valid) {
+        return yield* Effect.die(
+          new Error("V2 orchestration projection rebuild did not produce a valid projection."),
+        );
+      }
+    }
+    const recovery = yield* input.recover;
+    yield* input.startEffectWorker;
+    const bootstrap = yield* input.autoBootstrap;
+    return { recovery, bootstrap } as const;
+  });
+}
+
 export const make = (options?: StartupOptions) =>
   Effect.gen(function* () {
     const serverConfig = yield* ServerConfig.ServerConfig;
     const keybindings = yield* Keybindings.Keybindings;
-    const orchestrationReactor = yield* OrchestrationReactor.OrchestrationReactor;
-    const providerSessionReaper = yield* ProviderSessionReaper.ProviderSessionReaper;
+    const projectionMaintenance = yield* ProjectionMaintenance.ProjectionMaintenanceV2;
+    const legacyV1ThreadImporter = yield* LegacyV1ThreadImporter.LegacyV1ThreadImporter;
+    const providerRuntimeRecovery = yield* ProviderRuntimeRecovery.ProviderRuntimeRecoveryService;
+    const providerSessions = yield* ProviderSessionManager.ProviderSessionManagerV2;
+    const agentAwarenessRelay = yield* AgentAwarenessRelay.AgentAwarenessRelay;
     const lifecycleEvents = yield* ServerLifecycleEvents.ServerLifecycleEvents;
     const serverSettings = yield* ServerSettings.ServerSettingsService;
     const serverEnvironment = yield* ServerEnvironment.ServerEnvironment;
@@ -396,9 +380,33 @@ export const make = (options?: StartupOptions) =>
 
     const commandGate = yield* makeCommandGate;
     const httpListening = yield* Deferred.make<void>();
-    const reactorScope = yield* Scope.make("sequential");
+    const effectWorkerFiber = yield* Ref.make<Fiber.Fiber<void, never> | null>(null);
 
-    yield* Effect.addFinalizer(() => Scope.close(reactorScope, Exit.void));
+    yield* Effect.addFinalizer(() =>
+      Effect.gen(function* () {
+        yield* commandGate.failCommandReady(
+          new ServerRuntimeStartupError({
+            mode: serverConfig.mode,
+            host: serverConfig.host ?? null,
+            port: serverConfig.port,
+            cause: "Server runtime is shutting down.",
+          }),
+        );
+        const workerFiber = yield* Ref.getAndSet(effectWorkerFiber, null);
+        if (workerFiber !== null) {
+          yield* Fiber.interrupt(workerFiber).pipe(Effect.ignore);
+        }
+        yield* providerSessions.shutdown;
+        const reconciliation = yield* providerRuntimeRecovery.reconcile("shutdown");
+        yield* Effect.logInfo("V2 orchestration shutdown reconciliation completed", reconciliation);
+      }).pipe(
+        Effect.catchCause((cause) =>
+          Effect.logWarning("V2 orchestration shutdown reconciliation failed", {
+            cause: Cause.pretty(cause),
+          }),
+        ),
+      ),
+    );
 
     const startup = Effect.gen(function* () {
       yield* Effect.logDebug("startup phase: starting keybindings runtime");
@@ -431,59 +439,120 @@ export const make = (options?: StartupOptions) =>
         ),
       );
 
-      yield* Effect.logDebug("startup phase: parking orchestration roots at activation");
-      yield* runStartupPhase(
-        "reactors.start",
-        Effect.gen(function* () {
-          yield* orchestrationReactor.start().pipe(Scope.provide(reactorScope));
-          yield* providerSessionReaper.start().pipe(Scope.provide(reactorScope));
-        }),
-      );
-
-      yield* runStartupPhase("provider-sessions.reconcile", reconcileProviderSessions);
-
       const welcomeBase = yield* resolveWelcomeBase;
       const environment = yield* serverEnvironment.getDescriptor;
-      yield* Effect.logDebug("startup phase: preparing welcome payload");
-
-      if (serverConfig.autoBootstrapProjectFromCwd) {
-        yield* forkParked(
-          runStartupPhase(
-            "welcome.autobootstrap",
-            Effect.gen(function* () {
-              const bootstrapTargets = yield* resolveAutoBootstrapWelcomeTargets.pipe(
-                Effect.provideService(Crypto.Crypto, crypto),
-              );
-              if (!bootstrapTargets.bootstrapProjectId && !bootstrapTargets.bootstrapThreadId) {
-                return;
-              }
-
-              yield* Effect.logDebug("startup phase: publishing bootstrapped welcome event", {
-                environmentId: environment.environmentId,
-                cwd: welcomeBase.cwd,
-                projectName: welcomeBase.projectName,
-                bootstrapProjectId: bootstrapTargets.bootstrapProjectId,
-                bootstrapThreadId: bootstrapTargets.bootstrapThreadId,
-              });
-              yield* lifecycleEvents.publish({
-                version: 1,
-                type: "welcome",
-                payload: {
-                  environment,
-                  ...welcomeBase,
-                  ...bootstrapTargets,
-                },
-              });
-            }).pipe(
-              Effect.catch((cause) =>
-                Effect.logWarning("startup auto-bootstrap welcome failed", {
-                  cause,
-                }),
-              ),
+      const legacyMigrationThreadCount = yield* legacyV1ThreadImporter.pendingThreadCount;
+      if (legacyMigrationThreadCount > 0) {
+        yield* lifecycleEvents.publish({
+          version: 1,
+          type: "legacyThreadMigration",
+          payload: {
+            status: "running",
+            totalThreadCount: legacyMigrationThreadCount,
+          },
+        });
+      }
+      const { recovery, bootstrap: bootstrapTargets } = yield* runOrderedV2StartupPhases({
+        importLegacyShells: runStartupPhase(
+          "orchestration-v2.legacy-v1.import-shells",
+          legacyV1ThreadImporter.reconcileShells.pipe(
+            Effect.tap((summary) =>
+              summary.importedThreadCount === 0
+                ? Effect.void
+                : Effect.logInfo("Imported legacy v1 thread shells", summary),
             ),
           ),
-        );
-      }
+        ),
+        verify: runStartupPhase(
+          "orchestration-v2.projections.verify",
+          projectionMaintenance.verify.pipe(
+            Effect.tap((verification) =>
+              verification.valid
+                ? Effect.void
+                : Effect.logWarning(
+                    "V2 orchestration projection metadata or structure is invalid; rebuilding",
+                    {
+                      expectedSequence: verification.expectedSequence,
+                      projectionSequence: verification.projectionSequence,
+                      schemaVersion: verification.schemaVersion,
+                      missingThreadCount: verification.missingThreadIds.length,
+                      unexpectedThreadCount: verification.unexpectedThreadIds.length,
+                      unreadableThreadCount: verification.unreadableThreadIds.length,
+                    },
+                  ),
+            ),
+          ),
+        ),
+        rebuild: runStartupPhase(
+          "orchestration-v2.projections.rebuild",
+          projectionMaintenance.rebuild,
+        ),
+        recover: runStartupPhase("orchestration-v2.recovery", providerRuntimeRecovery.recover),
+        startEffectWorker: runStartupPhase(
+          "orchestration-v2.effect-worker.start",
+          startEffectWorkerWithRelay({
+            runWorker: EffectWorker.runDaemon,
+            startRelay: agentAwarenessRelay.start(),
+            workerFiberRef: effectWorkerFiber,
+          }),
+        ),
+        autoBootstrap: (serverConfig.autoBootstrapProjectFromCwd
+          ? runStartupPhase(
+              "welcome.autobootstrap",
+              resolveAutoBootstrapWelcomeTargets.pipe(Effect.provideService(Crypto.Crypto, crypto)),
+            )
+          : Effect.succeed({})
+        ).pipe(Effect.map((targets): AutoBootstrapWelcomeTargets => targets)),
+      });
+      yield* Effect.logInfo("V2 orchestration recovery completed", recovery);
+
+      const importPendingTranscripts = legacyV1ThreadImporter.importPendingTranscripts.pipe(
+        Effect.tap((summary) =>
+          summary.importedThreadCount === 0
+            ? Effect.void
+            : Effect.logInfo("Hydrated legacy v1 thread transcripts", summary),
+        ),
+      );
+      yield* (
+        legacyMigrationThreadCount > 0
+          ? importPendingTranscripts.pipe(
+              Effect.tap(() =>
+                lifecycleEvents.publish({
+                  version: 1,
+                  type: "legacyThreadMigration",
+                  payload: {
+                    status: "complete",
+                    totalThreadCount: legacyMigrationThreadCount,
+                  },
+                }),
+              ),
+            )
+          : importPendingTranscripts
+      ).pipe(forkParked);
+
+      // Off the startup path: the first run after an upgrade deletes the whole
+      // superseded-event and legacy-v1 backlog (potentially millions of rows,
+      // paced in small batches), and nothing at boot depends on it.
+      yield* projectionMaintenance.compactEventStore.pipe(
+        Effect.tap((summary) =>
+          summary.deletedEventCount === 0 && summary.deletedReceiptCount === 0
+            ? Effect.void
+            : Effect.logInfo("Compacted orchestration event store", summary),
+        ),
+        Effect.tap((summary) =>
+          // Freed pages are reused, so the file stops growing regardless; only
+          // an offline VACUUM shrinks it, which is not safe to run on the
+          // synchronous sqlite connection while serving.
+          summary.reclaimableBytes >= 512 * 1024 * 1024
+            ? Effect.logInfo(
+                "state.sqlite has substantial reclaimable free space; an offline VACUUM would shrink the file",
+                { reclaimableBytes: summary.reclaimableBytes },
+              )
+            : Effect.void,
+        ),
+        Effect.catch((cause) => Effect.logWarning("Unable to compact the event store", { cause })),
+        forkParked,
+      );
 
       yield* forkParked(
         Effect.gen(function* () {
@@ -494,12 +563,14 @@ export const make = (options?: StartupOptions) =>
             Effect.ignoreCause({ log: true }),
           );
           if (serverConfig.startupPresentation === "headless") {
+            yield* Effect.logDebug("startup phase: headless access info");
             const accessInfo = yield* issueHeadlessServeAccessInfo();
             yield* runStartupPhase(
               "headless.output",
               Console.log(formatHeadlessServeOutput(accessInfo)),
             );
           } else {
+            yield* Effect.logDebug("startup phase: browser open check");
             const startupBrowserTarget = yield* resolveStartupBrowserTarget;
             if (serverConfig.mode !== "desktop") {
               yield* Effect.logInfo(
@@ -518,21 +589,32 @@ export const make = (options?: StartupOptions) =>
         options?.awaitAuxiliaryParked ?? Effect.void,
       );
 
-      // This is the prepared boundary. Every dependency has been acquired and
-      // every runtime root has confirmed that it is parked before this request.
       const updateOutcome = yield* launcher.prepareTrial;
+
+      yield* Effect.logDebug("startup phase: publishing welcome event", {
+        environmentId: environment.environmentId,
+        cwd: welcomeBase.cwd,
+        projectName: welcomeBase.projectName,
+        bootstrapProjectId: bootstrapTargets.bootstrapProjectId,
+        bootstrapThreadId: bootstrapTargets.bootstrapThreadId,
+      });
       yield* runStartupPhase(
         "welcome.publish",
         lifecycleEvents.publish({
           version: 1,
           type: "welcome",
-          payload: { environment, ...welcomeBase },
+          payload: {
+            environment,
+            ...welcomeBase,
+            ...bootstrapTargets,
+          },
         }),
       );
-      yield* options?.activate ?? Effect.void;
 
+      yield* options?.activate ?? Effect.void;
       yield* Effect.logDebug("Accepting commands");
       yield* commandGate.signalCommandReady;
+      yield* Effect.logDebug("startup phase: publishing ready event");
       yield* runStartupPhase(
         "ready.publish",
         lifecycleEvents.publish({
@@ -566,7 +648,7 @@ export const make = (options?: StartupOptions) =>
             cause: startupExit.cause,
           });
           return Effect.logError("server runtime startup failed", {
-            cause: startupExit.cause,
+            cause: Cause.pretty(startupExit.cause),
           }).pipe(
             Effect.andThen(commandGate.failCommandReady(error)),
             Effect.andThen(options?.abort?.(error) ?? Effect.void),
diff --git a/apps/server/src/textGeneration/CodexTextGeneration.test.ts b/apps/server/src/textGeneration/CodexTextGeneration.test.ts
index 657118fff51c..1d3690c795e1 100644
--- a/apps/server/src/textGeneration/CodexTextGeneration.test.ts
+++ b/apps/server/src/textGeneration/CodexTextGeneration.test.ts
@@ -1,11 +1,13 @@
 import * as NodeServices from "@effect/platform-node/NodeServices";
 import { it } from "@effect/vitest";
 import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
 import * as FileSystem from "effect/FileSystem";
 import * as Layer from "effect/Layer";
 import * as Path from "effect/Path";
 import * as Result from "effect/Result";
 import * as Schema from "effect/Schema";
+import * as Scope from "effect/Scope";
 import { createModelSelection } from "@t3tools/shared/model";
 import { expect } from "vite-plus/test";
 
@@ -400,6 +402,34 @@ it.layer(CodexTextGenerationTestLayer)("CodexTextGeneration", (it) => {
     ),
   );
 
+  it.effect("generates branch names even when the ambient scope is already closed", () =>
+    withFakeCodexEnv(
+      {
+        output: JSON.stringify({
+          branch: "feat/background-generation",
+        }),
+      },
+      (textGeneration) =>
+        Effect.gen(function* () {
+          // Background fibers (e.g. the worktree branch rename fork) can run
+          // after their launching request's scope has closed; temp files must
+          // not be tied to that ambient scope or they are reaped on creation.
+          const closedScope = yield* Scope.make();
+          yield* Scope.close(closedScope, Exit.void);
+
+          const generated = yield* textGeneration
+            .generateBranchName({
+              cwd: process.cwd(),
+              message: "Please update session handling.",
+              modelSelection: DEFAULT_TEST_MODEL_SELECTION,
+            })
+            .pipe(Effect.provideService(Scope.Scope, closedScope));
+
+          expect(generated.branch).toBe("feat/background-generation");
+        }),
+    ),
+  );
+
   it.effect("generates thread titles and trims them for sidebar use", () =>
     withFakeCodexEnv(
       {
diff --git a/apps/server/src/textGeneration/CodexTextGeneration.ts b/apps/server/src/textGeneration/CodexTextGeneration.ts
index 0b870ac1d679..9cf202890edb 100644
--- a/apps/server/src/textGeneration/CodexTextGeneration.ts
+++ b/apps/server/src/textGeneration/CodexTextGeneration.ts
@@ -3,7 +3,6 @@ import * as FileSystem from "effect/FileSystem";
 import * as Option from "effect/Option";
 import * as Path from "effect/Path";
 import * as Schema from "effect/Schema";
-import * as Scope from "effect/Scope";
 import * as Stream from "effect/Stream";
 import { ChildProcess, ChildProcessSpawner } from "effect/unstable/process";
 
@@ -72,17 +71,33 @@ export const makeCodexTextGeneration = Effect.fn("makeCodexTextGeneration")(func
       ),
     );
 
+  const safeUnlink = (filePath: string): Effect.Effect<void, never> =>
+    fileSystem.remove(filePath).pipe(Effect.catch(() => Effect.void));
+
+  const removeTempFileDir = (filePath: string): Effect.Effect<void, never> =>
+    fileSystem
+      .remove(path.dirname(filePath), { recursive: true })
+      .pipe(Effect.catch(() => Effect.void));
+
+  // Deliberately unscoped: text generation runs from background fibers whose
+  // ambient scope may already be closed (a closed scope reaps the temp
+  // directory the moment it is created). Each allocation removes its own
+  // directory on failure; success-path cleanup is explicit in runCodexJson.
   const writeTempFile = (
     operation: string,
     prefix: string,
     content: string,
-  ): Effect.Effect<string, TextGenerationError, Scope.Scope> =>
+  ): Effect.Effect<string, TextGenerationError> =>
     fileSystem
-      .makeTempFileScoped({
+      .makeTempFile({
         prefix: `t3code-${prefix}-${process.pid}-`,
       })
       .pipe(
-        Effect.tap((filePath) => fileSystem.writeFileString(filePath, content)),
+        Effect.tap((filePath) =>
+          fileSystem
+            .writeFileString(filePath, content)
+            .pipe(Effect.onError(() => removeTempFileDir(filePath))),
+        ),
         Effect.mapError(
           (cause) =>
             new TextGenerationError({
@@ -93,9 +108,6 @@ export const makeCodexTextGeneration = Effect.fn("makeCodexTextGeneration")(func
         ),
       );
 
-  const safeUnlink = (filePath: string): Effect.Effect<void, never> =>
-    fileSystem.remove(filePath).pipe(Effect.catch(() => Effect.void));
-
   const encodeJsonForOperation = (
     operation:
       | "generateCommitMessage"
@@ -175,7 +187,9 @@ export const makeCodexTextGeneration = Effect.fn("makeCodexTextGeneration")(func
       toJsonSchemaObject(outputSchemaJson),
     );
     const schemaPath = yield* writeTempFile(operation, "codex-schema", schemaJson);
-    const outputPath = yield* writeTempFile(operation, "codex-output", "");
+    const outputPath = yield* writeTempFile(operation, "codex-output", "").pipe(
+      Effect.onError(() => removeTempFileDir(schemaPath)),
+    );
 
     const runCodexCommand = Effect.fn("runCodexJson.runCodexCommand")(function* () {
       const launchArgs = resolveCodexLaunchArgs(codexConfig.launchArgs, resolvedEnvironment);
@@ -254,7 +268,11 @@ export const makeCodexTextGeneration = Effect.fn("makeCodexTextGeneration")(func
     });
 
     const cleanup = Effect.all(
-      [schemaPath, outputPath, ...cleanupPaths].map((filePath) => safeUnlink(filePath)),
+      [
+        removeTempFileDir(schemaPath),
+        removeTempFileDir(outputPath),
+        ...cleanupPaths.map((filePath) => safeUnlink(filePath)),
+      ],
       {
         concurrency: "unbounded",
       },
diff --git a/apps/server/src/textGeneration/CursorTextGeneration.test.ts b/apps/server/src/textGeneration/CursorTextGeneration.test.ts
index 2dc4720dcadb..42fe44a8ee5b 100644
--- a/apps/server/src/textGeneration/CursorTextGeneration.test.ts
+++ b/apps/server/src/textGeneration/CursorTextGeneration.test.ts
@@ -1,276 +1,162 @@
-// @effect-diagnostics nodeBuiltinImport:off
-import * as NodePath from "node:path";
-import * as NodeOS from "node:os";
-import * as NodeURL from "node:url";
-import * as NodeFS from "node:fs";
-
-import * as NodeServices from "@effect/platform-node/NodeServices";
-import { it } from "@effect/vitest";
-import * as Clock from "effect/Clock";
+import { CursorSettings, ProviderInstanceId } from "@t3tools/contracts";
+import { describe, expect, it } from "@effect/vitest";
 import * as Effect from "effect/Effect";
-import * as Exit from "effect/Exit";
-import * as Layer from "effect/Layer";
 import * as Schema from "effect/Schema";
 import { createModelSelection } from "@t3tools/shared/model";
-import { expect } from "vite-plus/test";
-
-import { CursorSettings, ProviderInstanceId } from "@t3tools/contracts";
+import { beforeEach, vi } from "vite-plus/test";
 
-import * as ServerConfig from "../config.ts";
-import * as TextGeneration from "./TextGeneration.ts";
 import { makeCursorTextGeneration } from "./CursorTextGeneration.ts";
-const decodeCursorSettings = Schema.decodeSync(CursorSettings);
-
-const __dirname = NodePath.dirname(NodeURL.fileURLToPath(import.meta.url));
-const mockAgentPath = NodePath.join(__dirname, "../../scripts/acp-mock-agent.ts");
-
-function shellSingleQuote(value: string): string {
-  return `'${value.replaceAll("'", `'"'"'`)}'`;
-}
-
-const CursorTextGenerationTestLayer = ServerConfig.ServerConfig.layerTest(process.cwd(), {
-  prefix: "t3code-cursor-text-generation-test-",
-}).pipe(Layer.provideMerge(NodeServices.layer));
 
-function makeAcpAgentWrapper(dir: string, env: Record<string, string>): string {
-  const binDir = NodePath.join(dir, "bin");
-  const agentPath = NodePath.join(binDir, "agent");
-  NodeFS.mkdirSync(binDir, { recursive: true });
-  NodeFS.writeFileSync(
-    agentPath,
-    [
-      "#!/bin/sh",
-      ...Object.entries(env).map(([key, value]) => `export ${key}=${shellSingleQuote(value)}`),
-      'if [ "$1" != "acp" ]; then',
-      '  printf "%s\\n" "unexpected args: $*" >&2',
-      "  exit 11",
-      "fi",
-      `exec node ${JSON.stringify(mockAgentPath)}`,
-      "",
-    ].join("\n"),
-    "utf8",
-  );
-  NodeFS.chmodSync(agentPath, 0o755);
-  return agentPath;
-}
-
-function withFakeAcpAgent<A, E, R>(
-  env: Record<string, string>,
-  effectFn: (textGeneration: TextGeneration.TextGeneration["Service"]) => Effect.Effect<A, E, R>,
-) {
-  return Effect.gen(function* () {
-    const tempDir = NodeFS.mkdtempSync(NodePath.join(NodeOS.tmpdir(), "t3code-cursor-text-acp-"));
-    yield* Effect.addFinalizer(() =>
-      Effect.sync(() => {
-        NodeFS.rmSync(tempDir, { recursive: true, force: true });
-      }),
-    );
-    const agentPath = makeAcpAgentWrapper(tempDir, env);
-    const config = decodeCursorSettings({ binaryPath: agentPath });
-    const textGeneration = yield* makeCursorTextGeneration(config);
-    return yield* effectFn(textGeneration);
-  }).pipe(Effect.scoped);
-}
+const cursorSdkMock = vi.hoisted(() => ({
+  prompt: vi.fn(async () => ({
+    id: "run-cursor-text-generation-test",
+    status: "finished" as const,
+    result:
+      '{"subject":"Add generated commit message","body":"- verify cursor sdk text generation"}',
+  })),
+}));
+
+vi.mock("@cursor/sdk", () => ({
+  Agent: {
+    prompt: cursorSdkMock.prompt,
+  },
+}));
 
-function waitForFileContent(path: string): Effect.Effect<string> {
-  return Effect.gen(function* () {
-    const deadline = (yield* Clock.currentTimeMillis) + 5_000;
-    for (;;) {
-      const result = yield* Effect.exit(Effect.sync(() => NodeFS.readFileSync(path, "utf8")));
-      if (Exit.isSuccess(result)) {
-        return result.value;
-      }
-      {
-        if ((yield* Clock.currentTimeMillis) >= deadline) {
-          return yield* Effect.die(result.cause);
-        }
-      }
-      yield* Effect.sleep(25);
-    }
+const decodeCursorSettings = Schema.decodeSync(CursorSettings);
+const cursorSettings = decodeCursorSettings({ enabled: true });
+
+beforeEach(() => {
+  cursorSdkMock.prompt.mockReset();
+  cursorSdkMock.prompt.mockResolvedValue({
+    id: "run-cursor-text-generation-test",
+    status: "finished",
+    result:
+      '{"subject":"Add generated commit message","body":"- verify cursor sdk text generation"}',
   });
-}
-
-it.layer(CursorTextGenerationTestLayer)("CursorTextGeneration", (it) => {
-  it.effect("uses ACP model config options instead of raw CLI model ids", () => {
-    const requestLogDir = NodeFS.mkdtempSync(
-      NodePath.join(NodeOS.tmpdir(), "t3code-cursor-text-log-"),
-    );
-    const requestLogPath = NodePath.join(requestLogDir, "requests.ndjson");
-
-    return withFakeAcpAgent(
-      {
-        T3_ACP_REQUEST_LOG_PATH: requestLogPath,
-        T3_ACP_PROMPT_RESPONSE_TEXT: JSON.stringify({
-          subject: "Add generated commit message",
-          body: "- verify cursor acp model config path",
-        }),
-      },
-      (textGeneration) =>
-        Effect.gen(function* () {
-          const generated = yield* textGeneration.generateCommitMessage({
-            cwd: process.cwd(),
-            branch: "feature/cursor-text-generation",
-            stagedSummary: "M apps/server/src/textGeneration/CursorTextGeneration.ts",
-            stagedPatch:
-              "diff --git a/apps/server/src/textGeneration/CursorTextGeneration.ts b/apps/server/src/textGeneration/CursorTextGeneration.ts",
-            modelSelection: {
-              ...createModelSelection(ProviderInstanceId.make("cursor"), "gpt-5.4", [
-                { id: "reasoning", value: "xhigh" },
-                { id: "fastMode", value: true },
-                { id: "contextWindow", value: "1m" },
-              ]),
-            },
-          });
-
-          expect(generated.subject).toBe("Add generated commit message");
-          expect(generated.body).toBe("- verify cursor acp model config path");
-
-          const requests = NodeFS.readFileSync(requestLogPath, "utf8")
-            .trim()
-            .split("\n")
-            .filter((line) => line.length > 0)
-            .map(
-              (line) => JSON.parse(line) as { method?: string; params?: Record<string, unknown> },
-            );
-
-          expect(
-            requests.find((request) => request.method === "initialize")?.params?.clientCapabilities,
-          ).toMatchObject({
-            _meta: {
-              parameterizedModelPicker: true,
-            },
-          });
-          expect(
-            requests.some(
-              (request) =>
-                request.method === "session/set_config_option" &&
-                request.params?.configId === "model" &&
-                request.params?.value === "gpt-5.4",
-            ),
-          ).toBe(true);
-          expect(
-            requests.some(
-              (request) =>
-                request.method === "session/set_config_option" &&
-                request.params?.configId === "reasoning" &&
-                request.params?.value === "extra-high",
-            ),
-          ).toBe(true);
-          expect(
-            requests.some(
-              (request) =>
-                request.method === "session/set_config_option" &&
-                request.params?.configId === "context" &&
-                request.params?.value === "1m",
-            ),
-          ).toBe(true);
-          expect(
-            requests.some(
-              (request) =>
-                request.method === "session/set_config_option" &&
-                request.params?.configId === "fast" &&
-                request.params?.value === "true",
-            ),
-          ).toBe(true);
-          expect(
-            requests.find((request) => request.method === "session/prompt")?.params?.prompt,
-          ).toEqual(
-            expect.arrayContaining([
-              expect.objectContaining({
-                type: "text",
-                text: expect.stringContaining("Staged patch:"),
-              }),
-            ]),
-          );
+});
 
-          NodeFS.rmSync(requestLogDir, { recursive: true, force: true });
-        }),
-    );
-  });
+describe("CursorTextGeneration", () => {
+  it.effect("uses the Cursor SDK prompt API with model parameters and API key", () =>
+    Effect.gen(function* () {
+      const textGeneration = yield* makeCursorTextGeneration(cursorSettings, {
+        CURSOR_API_KEY: "test-cursor-key",
+      });
+
+      const generated = yield* textGeneration.generateCommitMessage({
+        cwd: process.cwd(),
+        branch: "feature/cursor-text-generation",
+        stagedSummary: "M apps/server/src/textGeneration/CursorTextGeneration.ts",
+        stagedPatch:
+          "diff --git a/apps/server/src/textGeneration/CursorTextGeneration.ts b/apps/server/src/textGeneration/CursorTextGeneration.ts",
+        modelSelection: createModelSelection(ProviderInstanceId.make("cursor"), "gpt-5.4", [
+          { id: "thinking", value: "high" },
+          { id: "contextWindow", value: "1m" },
+          { id: "fastMode", value: true },
+        ]),
+      });
+
+      expect(generated.subject).toBe("Add generated commit message");
+      expect(generated.body).toBe("- verify cursor sdk text generation");
+
+      expect(cursorSdkMock.prompt).toHaveBeenCalledTimes(1);
+      const [prompt, options] = (
+        cursorSdkMock.prompt.mock.calls as unknown as Array<[string, unknown]>
+      )[0]!;
+      expect(prompt).toContain("Staged patch:");
+      expect(options).toEqual({
+        apiKey: "test-cursor-key",
+        mode: "agent",
+        model: {
+          id: "gpt-5.4",
+          params: [
+            { id: "thinking", value: "high" },
+            { id: "context", value: "1m" },
+            { id: "fast", value: "true" },
+          ],
+        },
+        local: {
+          cwd: process.cwd(),
+          autoReview: false,
+          sandboxOptions: { enabled: false },
+          enableAgentRetries: true,
+        },
+      });
+    }),
+  );
 
   it.effect("accepts json objects with extra assistant text around them", () =>
-    withFakeAcpAgent(
-      {
-        T3_ACP_PROMPT_RESPONSE_TEXT:
+    Effect.gen(function* () {
+      cursorSdkMock.prompt.mockResolvedValueOnce({
+        id: "run-cursor-text-generation-test",
+        status: "finished",
+        result:
           'Sure, here is the JSON:\n```json\n{\n  "subject": "Update README dummy comment with attribution and date",\n  "body": ""\n}\n```\nDone.',
-      },
-      (textGeneration) =>
-        Effect.gen(function* () {
-          const generated = yield* textGeneration.generateCommitMessage({
-            cwd: process.cwd(),
-            branch: "feature/cursor-noisy-json",
-            stagedSummary: "M README.md",
-            stagedPatch: "diff --git a/README.md b/README.md",
-            modelSelection: {
-              instanceId: ProviderInstanceId.make("cursor"),
-              model: "composer-2",
-            },
-          });
-
-          expect(generated.subject).toBe("Update README dummy comment with attribution and date");
-          expect(generated.body).toBe("");
-        }),
-    ),
+      });
+      const textGeneration = yield* makeCursorTextGeneration(cursorSettings, {
+        CURSOR_API_KEY: "test-cursor-key",
+      });
+
+      const generated = yield* textGeneration.generateCommitMessage({
+        cwd: process.cwd(),
+        branch: "feature/cursor-noisy-json",
+        stagedSummary: "M README.md",
+        stagedPatch: "diff --git a/README.md b/README.md",
+        modelSelection: {
+          instanceId: ProviderInstanceId.make("cursor"),
+          model: "composer-2",
+        },
+      });
+
+      expect(generated.subject).toBe("Update README dummy comment with attribution and date");
+      expect(generated.body).toBe("");
+    }),
   );
 
-  it.effect("generates thread titles through Cursor ACP text generation", () =>
-    withFakeAcpAgent(
-      {
-        T3_ACP_PROMPT_RESPONSE_TEXT: JSON.stringify({
-          title: '"Trim reconnect spinner status after resume."',
-        }),
-      },
-      (textGeneration) =>
-        Effect.gen(function* () {
-          const generated = yield* textGeneration.generateThreadTitle({
-            cwd: process.cwd(),
-            message: "Fix the reconnect spinner after a resumed session.",
-            modelSelection: {
-              instanceId: ProviderInstanceId.make("cursor"),
-              model: "composer-2",
-            },
-          });
-
-          expect(generated.title).toBe("Trim reconnect spinner status after resume.");
-        }),
-    ),
+  it.effect("generates thread titles through Cursor SDK text generation", () =>
+    Effect.gen(function* () {
+      cursorSdkMock.prompt.mockResolvedValueOnce({
+        id: "run-cursor-title-generation-test",
+        status: "finished",
+        result: '{"title":"\\"Trim reconnect spinner status after resume.\\""}',
+      });
+      const textGeneration = yield* makeCursorTextGeneration(cursorSettings, {
+        CURSOR_API_KEY: "test-cursor-key",
+      });
+
+      const generated = yield* textGeneration.generateThreadTitle({
+        cwd: process.cwd(),
+        message: "Fix the reconnect spinner after a resumed session.",
+        modelSelection: {
+          instanceId: ProviderInstanceId.make("cursor"),
+          model: "composer-2",
+        },
+      });
+
+      expect(generated.title).toBe("Trim reconnect spinner status after resume.");
+    }),
   );
 
-  it.effect("closes the ACP child process after text generation completes", () => {
-    const exitLogDir = NodeFS.mkdtempSync(
-      NodePath.join(NodeOS.tmpdir(), "t3code-cursor-text-exit-log-"),
-    );
-    const exitLogPath = NodePath.join(exitLogDir, "exit.log");
-
-    return withFakeAcpAgent(
-      {
-        T3_ACP_EXIT_LOG_PATH: exitLogPath,
-        T3_ACP_PROMPT_RESPONSE_TEXT: JSON.stringify({
-          subject: "Close runtime after generation",
-          body: "",
+  it.effect("requires CURSOR_API_KEY before calling the SDK", () =>
+    Effect.gen(function* () {
+      const textGeneration = yield* makeCursorTextGeneration(cursorSettings, {});
+
+      const error = yield* Effect.flip(
+        textGeneration.generateCommitMessage({
+          cwd: process.cwd(),
+          branch: "feature/cursor-api-key",
+          stagedSummary: "M README.md",
+          stagedPatch: "diff --git a/README.md b/README.md",
+          modelSelection: {
+            instanceId: ProviderInstanceId.make("cursor"),
+            model: "composer-2",
+          },
         }),
-      },
-      (textGeneration) =>
-        Effect.gen(function* () {
-          const generated = yield* textGeneration.generateCommitMessage({
-            cwd: process.cwd(),
-            branch: "feature/cursor-runtime-close",
-            stagedSummary: "M apps/server/src/textGeneration/CursorTextGeneration.ts",
-            stagedPatch:
-              "diff --git a/apps/server/src/textGeneration/CursorTextGeneration.ts b/apps/server/src/textGeneration/CursorTextGeneration.ts",
-            modelSelection: {
-              instanceId: ProviderInstanceId.make("cursor"),
-              model: "composer-2",
-            },
-          });
-
-          expect(generated.subject).toBe("Close runtime after generation");
+      );
 
-          const exitLog = yield* waitForFileContent(exitLogPath);
-          expect(exitLog).toContain("exit:0");
-
-          NodeFS.rmSync(exitLogDir, { recursive: true, force: true });
-        }),
-    );
-  });
+      expect(error.detail).toBe(
+        "Cursor API key is required. Add CURSOR_API_KEY in provider settings.",
+      );
+      expect(cursorSdkMock.prompt).not.toHaveBeenCalled();
+    }),
+  );
 });
diff --git a/apps/server/src/textGeneration/CursorTextGeneration.ts b/apps/server/src/textGeneration/CursorTextGeneration.ts
index 5ae057b54f63..c51bcf9b8529 100644
--- a/apps/server/src/textGeneration/CursorTextGeneration.ts
+++ b/apps/server/src/textGeneration/CursorTextGeneration.ts
@@ -1,9 +1,7 @@
-import * as Crypto from "effect/Crypto";
+import { Agent, type AgentOptions, type RunResult } from "@cursor/sdk";
 import * as Effect from "effect/Effect";
 import * as Option from "effect/Option";
-import * as Ref from "effect/Ref";
 import * as Schema from "effect/Schema";
-import { ChildProcessSpawner } from "effect/unstable/process";
 
 import { type CursorSettings, type ModelSelection } from "@t3tools/contracts";
 import { sanitizeBranchFragment, sanitizeFeatureBranchName } from "@t3tools/shared/git";
@@ -22,27 +20,58 @@ import {
   sanitizePrTitle,
   sanitizeThreadTitle,
 } from "./TextGenerationUtils.ts";
-import {
-  applyCursorAcpModelSelection,
-  makeCursorAcpRuntime,
-} from "../provider/acp/CursorAcpSupport.ts";
+import { cursorSdkModelSelection } from "../provider/cursorSdkModel.ts";
 
 const CURSOR_TIMEOUT_MS = 180_000;
 
 const isTextGenerationError = Schema.is(TextGenerationError);
+type CursorTextGenerationOperation =
+  | "generateCommitMessage"
+  | "generatePrContent"
+  | "generateBranchName"
+  | "generateThreadTitle";
+
+function emptyCursorSdkResultDetail(result: RunResult): string {
+  switch (result.status) {
+    case "cancelled":
+      return "Cursor SDK request was cancelled.";
+    case "error":
+      return "Cursor SDK request finished with an error and no output.";
+    case "finished":
+      return "Cursor SDK returned empty output.";
+  }
+}
 
 /**
  * Build a Cursor text-generation closure bound to a specific `CursorSettings`
  * payload. See `makeCodexAdapter` for the overall per-instance rationale.
  */
-export const makeCursorTextGeneration = Effect.fn("makeCursorTextGeneration")(function* (
+export const makeCursorTextGeneration = Effect.fn("makeCursorTextGeneration")((
   cursorSettings: CursorSettings,
   environment?: NodeJS.ProcessEnv,
-) {
-  const crypto = yield* Crypto.Crypto;
-  const commandSpawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+) => {
   const resolvedEnvironment = environment ?? process.env;
 
+  const resolveCursorApiKey = (operation: CursorTextGenerationOperation) =>
+    Effect.gen(function* () {
+      if (!cursorSettings.enabled) {
+        return yield* new TextGenerationError({
+          operation,
+          detail: "Cursor is disabled in T3 Code settings.",
+        });
+      }
+
+      const apiKey = resolvedEnvironment.CURSOR_API_KEY?.trim();
+      if (!apiKey) {
+        return yield* new TextGenerationError({
+          operation,
+          detail: "Cursor API key is required. Add CURSOR_API_KEY in provider settings.",
+        });
+      }
+
+      return apiKey;
+    });
+
   const runCursorJson = <S extends Schema.Top>({
     operation,
     cwd,
@@ -50,59 +79,34 @@ export const makeCursorTextGeneration = Effect.fn("makeCursorTextGeneration")(fu
     outputSchemaJson,
     modelSelection,
   }: {
-    operation:
-      | "generateCommitMessage"
-      | "generatePrContent"
-      | "generateBranchName"
-      | "generateThreadTitle";
+    operation: CursorTextGenerationOperation;
     cwd: string;
     prompt: string;
     outputSchemaJson: S;
     modelSelection: ModelSelection;
   }): Effect.Effect<S["Type"], TextGenerationError, S["DecodingServices"]> =>
     Effect.gen(function* () {
-      const outputRef = yield* Ref.make("");
-      const runtime = yield* makeCursorAcpRuntime({
-        cursorSettings,
-        environment: resolvedEnvironment,
-        childProcessSpawner: commandSpawner,
-        cwd,
-        clientInfo: { name: "t3-code-git-text", version: "0.0.0" },
-      }).pipe(Effect.provideService(Crypto.Crypto, crypto));
-
-      yield* runtime.handleSessionUpdate((notification) => {
-        const update = notification.update;
-        if (update.sessionUpdate !== "agent_message_chunk") {
-          return Effect.void;
-        }
-        const content = update.content;
-        if (content.type !== "text") {
-          return Effect.void;
-        }
-        return Ref.update(outputRef, (current) => current + content.text);
-      });
-
-      const promptResult = yield* Effect.gen(function* () {
-        yield* runtime.start();
-        yield* Effect.ignore(runtime.setMode("ask"));
-        yield* applyCursorAcpModelSelection({
-          runtime,
-          model: modelSelection.model,
-          selections: modelSelection.options,
-          mapError: ({ cause, configId, step }) =>
-            new TextGenerationError({
-              operation,
-              detail:
-                step === "set-config-option"
-                  ? `Failed to set Cursor ACP config option "${configId}" for text generation.`
-                  : "Failed to set Cursor ACP base model for text generation.",
-              cause,
-            }),
-        });
+      const apiKey = yield* resolveCursorApiKey(operation);
+      const agentOptions = {
+        apiKey,
+        mode: "agent",
+        model: cursorSdkModelSelection(modelSelection),
+        local: {
+          cwd,
+          autoReview: false,
+          sandboxOptions: { enabled: false },
+          enableAgentRetries: true,
+        },
+      } satisfies AgentOptions;
 
-        return yield* runtime.prompt({
-          prompt: [{ type: "text", text: prompt }],
-        });
+      const promptResult = yield* Effect.tryPromise({
+        try: () => Agent.prompt(prompt, agentOptions),
+        catch: (cause) =>
+          new TextGenerationError({
+            operation,
+            detail: "Cursor SDK request failed.",
+            cause,
+          }),
       }).pipe(
         Effect.timeoutOption(CURSOR_TIMEOUT_MS),
         Effect.flatMap(
@@ -111,31 +115,19 @@ export const makeCursorTextGeneration = Effect.fn("makeCursorTextGeneration")(fu
               Effect.fail(
                 new TextGenerationError({
                   operation,
-                  detail: "Cursor Agent request timed out.",
+                  detail: "Cursor SDK request timed out.",
                 }),
               ),
             onSome: (value) => Effect.succeed(value),
           }),
         ),
-        Effect.mapError((cause) =>
-          isTextGenerationError(cause)
-            ? cause
-            : new TextGenerationError({
-                operation,
-                detail: "Cursor ACP request failed.",
-                cause,
-              }),
-        ),
       );
 
-      const rawResult = (yield* Ref.get(outputRef)).trim();
+      const rawResult = promptResult.result?.trim() ?? "";
       if (!rawResult) {
         return yield* new TextGenerationError({
           operation,
-          detail:
-            promptResult.stopReason === "cancelled"
-              ? "Cursor ACP request was cancelled."
-              : "Cursor Agent returned empty output.",
+          detail: emptyCursorSdkResultDetail(promptResult),
         });
       }
 
@@ -146,7 +138,7 @@ export const makeCursorTextGeneration = Effect.fn("makeCursorTextGeneration")(fu
             Effect.fail(
               new TextGenerationError({
                 operation,
-                detail: "Cursor Agent returned invalid structured output.",
+                detail: "Cursor SDK returned invalid structured output.",
                 cause,
               }),
             ),
@@ -158,11 +150,10 @@ export const makeCursorTextGeneration = Effect.fn("makeCursorTextGeneration")(fu
           ? cause
           : new TextGenerationError({
               operation,
-              detail: "Cursor ACP text generation failed.",
+              detail: "Cursor SDK text generation failed.",
               cause,
             }),
       ),
-      Effect.scoped,
     );
 
   const generateCommitMessage: TextGeneration.TextGeneration["Service"]["generateCommitMessage"] =
@@ -259,10 +250,10 @@ export const makeCursorTextGeneration = Effect.fn("makeCursorTextGeneration")(fu
       } satisfies TextGeneration.ThreadTitleGenerationResult;
     });
 
-  return {
+  return Effect.succeed({
     generateCommitMessage,
     generatePrContent,
     generateBranchName,
     generateThreadTitle,
-  } satisfies TextGeneration.TextGeneration["Service"];
+  } satisfies TextGeneration.TextGeneration["Service"]);
 });
diff --git a/apps/server/src/textGeneration/TextGeneration.test.ts b/apps/server/src/textGeneration/TextGeneration.test.ts
index 9bccb9c1fc5b..9966c37ddad3 100644
--- a/apps/server/src/textGeneration/TextGeneration.test.ts
+++ b/apps/server/src/textGeneration/TextGeneration.test.ts
@@ -38,7 +38,7 @@ const makeStubInstance = (
     displayName: undefined,
     enabled: true,
     snapshot: {} as ProviderInstance["snapshot"],
-    adapter: {} as ProviderInstance["adapter"],
+    orchestrationAdapter: {} as ProviderInstance["orchestrationAdapter"],
     textGeneration,
   }) satisfies ProviderInstance;
 
diff --git a/apps/server/src/vcs/GitVcsDriver.ts b/apps/server/src/vcs/GitVcsDriver.ts
index 6cf4400c62eb..9e8b9615ac9d 100644
--- a/apps/server/src/vcs/GitVcsDriver.ts
+++ b/apps/server/src/vcs/GitVcsDriver.ts
@@ -116,6 +116,12 @@ export interface GitCommitOptions {
   readonly progress?: GitCommitProgress;
 }
 
+export interface GitDeleteLocalBranchInput {
+  readonly cwd: string;
+  readonly refName: string;
+  readonly force?: boolean;
+}
+
 export interface GitPushResult {
   status: "pushed" | "skipped_up_to_date";
   branch: string;
@@ -314,6 +320,9 @@ export class GitVcsDriver extends Context.Service<
     readonly pruneWorktrees: (input: {
       readonly cwd: string;
     }) => Effect.Effect<void, GitCommandError>;
+    readonly deleteLocalBranch: (
+      input: GitDeleteLocalBranchInput,
+    ) => Effect.Effect<void, GitCommandError>;
     readonly renameBranch: (
       input: GitRenameBranchInput,
     ) => Effect.Effect<GitRenameBranchResult, GitCommandError>;
diff --git a/apps/server/src/vcs/GitVcsDriverCore.test.ts b/apps/server/src/vcs/GitVcsDriverCore.test.ts
index 587a3e4abbde..fb3a7155c9c3 100644
--- a/apps/server/src/vcs/GitVcsDriverCore.test.ts
+++ b/apps/server/src/vcs/GitVcsDriverCore.test.ts
@@ -1461,7 +1461,7 @@ it.layer(TestLayer)("GitVcsDriver core integration", (it) => {
       }),
     );
 
-    it.effect("creates and removes a worktree for a new refName", () =>
+    it.effect("creates and removes a worktree and its new local branch", () =>
       Effect.gen(function* () {
         const cwd = yield* makeTmpDir();
         const { initialBranch } = yield* initRepoWithCommit(cwd);
@@ -1484,8 +1484,14 @@ it.layer(TestLayer)("GitVcsDriver core integration", (it) => {
         assert.equal(yield* git(worktreePath, ["branch", "--show-current"]), "feature/worktree");
 
         yield* driver.removeWorktree({ cwd, path: worktreePath });
+        yield* driver.deleteLocalBranch({
+          cwd,
+          refName: "feature/worktree",
+          force: true,
+        });
         const fileSystem = yield* FileSystem.FileSystem;
         assert.equal(yield* fileSystem.exists(worktreePath), false);
+        assert.notInclude(yield* driver.listLocalBranchNames(cwd), "feature/worktree");
       }),
     );
 
diff --git a/apps/server/src/vcs/GitVcsDriverCore.ts b/apps/server/src/vcs/GitVcsDriverCore.ts
index 71e478cbaa3d..eab927d3d95c 100644
--- a/apps/server/src/vcs/GitVcsDriverCore.ts
+++ b/apps/server/src/vcs/GitVcsDriverCore.ts
@@ -3115,6 +3115,20 @@ export const makeGitVcsDriverCore = Effect.fn("makeGitVcsDriverCore")(function*
     });
   });
 
+  const deleteLocalBranch: GitVcsDriver.GitVcsDriver["Service"]["deleteLocalBranch"] = Effect.fn(
+    "deleteLocalBranch",
+  )(function* (input) {
+    yield* executeGit(
+      "GitVcsDriver.deleteLocalBranch",
+      input.cwd,
+      ["branch", input.force === true ? "-D" : "-d", "--", input.refName],
+      {
+        timeoutMs: 10_000,
+        fallbackErrorDetail: "git branch delete failed",
+      },
+    );
+  });
+
   const renameBranch: GitVcsDriver.GitVcsDriver["Service"]["renameBranch"] = Effect.fn(
     "renameBranch",
   )(function* (input) {
@@ -3321,6 +3335,7 @@ export const makeGitVcsDriverCore = Effect.fn("makeGitVcsDriverCore")(function*
     setBranchUpstream: (input) => withListRefsInvalidation(input.cwd, setBranchUpstream(input)),
     removeWorktree: (input) => withListRefsInvalidation(input.cwd, removeWorktree(input)),
     pruneWorktrees: (input) => withListRefsInvalidation(input.cwd, pruneWorktrees(input)),
+    deleteLocalBranch: (input) => withListRefsInvalidation(input.cwd, deleteLocalBranch(input)),
     renameBranch: (input) => withListRefsInvalidation(input.cwd, renameBranch(input)),
     createRef: (input) => withListRefsInvalidation(input.cwd, createRef(input)),
     switchRef: (input) => withListRefsInvalidation(input.cwd, switchRef(input)),
diff --git a/apps/server/src/ws.test.ts b/apps/server/src/ws.test.ts
new file mode 100644
index 000000000000..3d99a454a134
--- /dev/null
+++ b/apps/server/src/ws.test.ts
@@ -0,0 +1,40 @@
+import { assert, it } from "@effect/vitest";
+import * as Deferred from "effect/Deferred";
+import * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as Fiber from "effect/Fiber";
+import * as TestClock from "effect/testing/TestClock";
+
+import { hasCompatibleOrchestrationProtocol, resolveAvailableEditorsForConfig } from "./ws.ts";
+import { ORCHESTRATION_PROTOCOL_VERSION } from "@t3tools/contracts";
+
+it("accepts only the current orchestration protocol before websocket RPC setup", () => {
+  assert.isTrue(
+    hasCompatibleOrchestrationProtocol(
+      new URL(`https://host.test/ws?orchestrationProtocol=${ORCHESTRATION_PROTOCOL_VERSION}`),
+    ),
+  );
+  assert.isFalse(hasCompatibleOrchestrationProtocol(new URL("https://host.test/ws")));
+  assert.isFalse(
+    hasCompatibleOrchestrationProtocol(
+      new URL(`https://host.test/ws?orchestrationProtocol=${ORCHESTRATION_PROTOCOL_VERSION - 1}`),
+    ),
+  );
+});
+
+it.effect("does not block server config when editor discovery never resolves", () =>
+  Effect.gen(function* () {
+    const discoveryInterrupted = yield* Deferred.make<void>();
+    const responseFiber = yield* resolveAvailableEditorsForConfig(
+      Effect.never.pipe(
+        Effect.onInterrupt(() => Deferred.succeed(discoveryInterrupted, undefined)),
+      ),
+    ).pipe(Effect.forkChild);
+
+    yield* TestClock.adjust(Duration.seconds(5));
+
+    const availableEditors = yield* Fiber.join(responseFiber);
+    yield* Deferred.await(discoveryInterrupted);
+    assert.deepEqual(availableEditors, []);
+  }),
+);
diff --git a/apps/server/src/ws.ts b/apps/server/src/ws.ts
index 9983de224f29..cdf098c91f4e 100644
--- a/apps/server/src/ws.ts
+++ b/apps/server/src/ws.ts
@@ -1,18 +1,21 @@
-import * as Cause from "effect/Cause";
-import * as Crypto from "effect/Crypto";
 import * as DateTime from "effect/DateTime";
 import * as Duration from "effect/Duration";
+import * as Encoding from "effect/Encoding";
 import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
 import * as Layer from "effect/Layer";
 import * as Option from "effect/Option";
+import * as Path from "effect/Path";
 import * as Queue from "effect/Queue";
 import * as Ref from "effect/Ref";
 import * as Schema from "effect/Schema";
+import * as Result from "effect/Result";
 import * as Stream from "effect/Stream";
 import {
   DEFAULT_AUTOMATIC_GIT_FETCH_INTERVAL,
   AuthAccessStreamError,
   type AuthAccessStreamEvent,
+  type ApplicationStoredEvent,
   type AuthEnvironmentScope,
   AuthSessionId,
   ClientConnectionMethod,
@@ -26,28 +29,33 @@ import {
   type EditorId,
   type FileManagerRevealKind,
   type OrchestrationClientOrigin,
+  type OrchestrationV2Command,
   type OrchestrationCommand,
   type GitActionProgressEvent,
   type GitManagerServiceError,
-  OrchestrationDispatchCommandError,
-  type OrchestrationEvent,
-  type OrchestrationShellStreamEvent,
-  type OrchestrationShellStreamItem,
-  type OrchestrationThreadStreamItem,
+  type MessageId,
   OrchestrationGetFullThreadDiffError,
-  OrchestrationGetSnapshotError,
   OrchestrationSearchThreadsError,
   OrchestrationGetTurnDiffError,
-  ORCHESTRATION_WS_METHODS,
-  type ProjectId,
+  ORCHESTRATION_V2_WS_METHODS,
+  ORCHESTRATION_PROTOCOL_QUERY_PARAM,
+  ORCHESTRATION_PROTOCOL_VERSION,
+  OrchestrationV2DispatchCommandError,
+  OrchestrationV2GetShellSnapshotError,
+  OrchestrationV2GetThreadProjectionError,
+  OrchestrationV2ThreadLaunchError,
+  type OrchestrationProjectShell,
+  type OrchestrationV2ShellSnapshot,
   type ProjectEntriesFailure,
   type ProjectFileFailure,
   type ProjectFileOperation,
+  type ProjectMutation,
   ProjectListEntriesError,
   ProjectReadFileError,
   ProjectSearchContentsError,
   ProjectSearchEntriesError,
   ProjectWriteFileError,
+  ProjectMutationError,
   ProviderUploadFeedbackError,
   RelayClientInstallFailedError,
   type RelayClientInstallProgressEvent,
@@ -57,6 +65,8 @@ import {
   FilesystemBrowseError,
   AssetWorkspaceContextNotFoundError,
   AssetWorkspaceContextResolutionError,
+  ChatAttachmentId,
+  PersistChatAttachmentsError,
   RpcClientId,
   EnvironmentAuthorizationError,
   ThreadId,
@@ -68,32 +78,59 @@ import {
   WsRpcGroup,
 } from "@t3tools/contracts";
 import { resolveServerBackgroundActivitySettings } from "@t3tools/shared/backgroundActivitySettings";
-import { HttpRouter, HttpServerRequest, HttpServerRespondable } from "effect/unstable/http";
+import {
+  HttpRouter,
+  HttpServerRequest,
+  HttpServerRespondable,
+  HttpServerResponse,
+} from "effect/unstable/http";
 import { RpcSerialization, RpcServer } from "effect/unstable/rpc";
+import * as SqlClient from "effect/unstable/sql/SqlClient";
 
 import * as CheckpointDiffQuery from "./checkpointing/CheckpointDiffQuery.ts";
 import * as ServerConfig from "./config.ts";
 import * as EnvironmentTheme from "./environmentTheme.ts";
 import * as Keybindings from "./keybindings.ts";
 import * as ExternalLauncher from "./process/externalLauncher.ts";
+import * as ThreadManagementService from "./orchestration-v2/ThreadManagementService.ts";
+import { ProviderSessionManagerV2 } from "./orchestration-v2/ProviderSessionManager.ts";
+import * as ThreadLaunchService from "./orchestration-v2/ThreadLaunchService.ts";
+import * as ScheduledTasks from "./scheduledTasks/ScheduledTaskService.ts";
+import {
+  archivedShellStreamItemFromThreadShell,
+  buildActiveShellSnapshot,
+  coalesceShellApplicationEvents,
+  coalesceStoredThreadEvents,
+  composeShellStreamWithEnrichment,
+  shellStreamItemFromEnrichmentRefresh,
+  shellStreamItemFromThreadShell,
+  shellStreamItemsFromInitialSnapshot,
+  shellStreamItemsFromResumeSnapshot,
+} from "./orchestration-v2/ShellStream.ts";
+import { ORCHESTRATION_V2_PROJECTION_SCHEMA_VERSION } from "./orchestration-v2/ProjectionStore.ts";
 import {
-  projectActivityEvent,
-  projectThreadDetailSnapshot,
-} from "./orchestration/ActivityPayloadProjection.ts";
+  decideThreadResume,
+  threadReplayEncodedBytes,
+  THREAD_RESUME_MAX_REPLAY_EVENTS,
+} from "./orchestration-v2/ThreadStream.ts";
 import {
-  cleanupFailedUploadedAttachments,
-  normalizeDispatchCommand,
-} from "./orchestration/Normalizer.ts";
-import * as OrchestrationEngine from "./orchestration/Services/OrchestrationEngine.ts";
+  projectDomainEventForWire,
+  projectThreadProjectionForWire,
+} from "./orchestration-v2/WireProjection.ts";
 import * as ProjectionSnapshotQuery from "./orchestration/Services/ProjectionSnapshotQuery.ts";
-import { ThreadDeletionReactor } from "./orchestration/Services/ThreadDeletionReactor.ts";
+import * as OrchestrationEventStore from "./persistence/Services/OrchestrationEventStore.ts";
+import { userFacingDispatchErrorMessage } from "./orchestration-v2/UserFacingErrors.ts";
+import {
+  attachmentIsPendingUpload,
+  claimPendingAttachments,
+  releaseClaimedAttachments,
+} from "./orchestration-v2/AttachmentClaims.ts";
 import {
   observeRpcEffect as instrumentRpcEffect,
   observeRpcStream as instrumentRpcStream,
   observeRpcStreamEffect as instrumentRpcStreamEffect,
 } from "./observability/RpcInstrumentation.ts";
 import * as ProviderRegistry from "./provider/Services/ProviderRegistry.ts";
-import * as ProviderService from "./provider/Services/ProviderService.ts";
 import * as ProviderMaintenanceRunner from "./provider/providerMaintenanceRunner.ts";
 import * as ServerSelfUpdate from "./cloud/selfUpdate.ts";
 import * as ServerLifecycleEvents from "./serverLifecycleEvents.ts";
@@ -103,6 +140,8 @@ import * as TerminalManager from "./terminal/Manager.ts";
 import * as PreviewAutomationBroker from "./mcp/PreviewAutomationBroker.ts";
 import * as PreviewManager from "./preview/Manager.ts";
 import { issueAssetUrl } from "./assets/AssetAccess.ts";
+import { attachmentRelativePath, createDeterministicAttachmentId } from "./attachmentStore.ts";
+import { parseBase64DataUrl } from "./imageMime.ts";
 import { deletePendingAttachment, issueAttachmentUploadUrl } from "./assets/AttachmentUpload.ts";
 import * as PortScanner from "./preview/PortScanner.ts";
 import * as WorkspaceEntries from "./workspace/WorkspaceEntries.ts";
@@ -113,7 +152,8 @@ import * as VcsStatusBroadcaster from "./vcs/VcsStatusBroadcaster.ts";
 import * as VcsProvisioningService from "./vcs/VcsProvisioningService.ts";
 import * as GitWorkflowService from "./git/GitWorkflowService.ts";
 import * as ReviewService from "./review/ReviewService.ts";
-import * as ProjectSetupScriptRunner from "./project/ProjectSetupScriptRunner.ts";
+import * as ProjectEnrichmentService from "./project/ProjectEnrichmentService.ts";
+import * as ProjectService from "./project/ProjectService.ts";
 import * as ServerEnvironment from "./environment/ServerEnvironment.ts";
 import * as RemoteOpenTargets from "./environment/RemoteOpenTargets.ts";
 import * as BackgroundPolicy from "./background/BackgroundPolicy.ts";
@@ -141,8 +181,8 @@ import * as PairingGrantStore from "./auth/PairingGrantStore.ts";
 import * as SessionStore from "./auth/SessionStore.ts";
 import { failEnvironmentAuthInvalid, failEnvironmentInternal } from "./auth/http.ts";
 import * as RelayClient from "@t3tools/shared/relayClient";
-const isOrchestrationDispatchCommandError = Schema.is(OrchestrationDispatchCommandError);
 
+const EDITOR_DISCOVERY_TIMEOUT = Duration.seconds(5);
 const nowIso = Effect.map(DateTime.now, DateTime.formatIso);
 const CONFIG_DISCOVERY_TIMEOUT = Duration.seconds(5);
 
@@ -167,18 +207,72 @@ function unexpectedCompatibilityError(error: never): never {
   throw new Error(`Unhandled compatibility error: ${String(error)}`);
 }
 
-/** Preserve the setup runner's broader pre-refactor message normalization. */
-function legacySetupFailureDescription(cause: unknown): string {
-  if (
-    typeof cause === "object" &&
-    cause !== null &&
-    "message" in cause &&
-    typeof cause.message === "string"
-  ) {
-    return cause.message;
-  }
-  return String(cause);
-}
+const persistChatAttachments = Effect.fn("ws.assets.persistChatAttachments")(function* (input: {
+  readonly threadId: ThreadId;
+  readonly messageId: MessageId;
+  readonly attachments: ReadonlyArray<{
+    readonly type: "image";
+    readonly name: string;
+    readonly mimeType: string;
+    readonly sizeBytes: number;
+    readonly dataUrl: string;
+  }>;
+}) {
+  const config = yield* ServerConfig.ServerConfig;
+  const fileSystem = yield* FileSystem.FileSystem;
+  const path = yield* Path.Path;
+  return yield* Effect.forEach(
+    input.attachments.map((attachment, index) => ({ attachment, index })),
+    Effect.fn("ws.assets.persistChatAttachment")(function* ({ attachment, index }) {
+      const parsed = parseBase64DataUrl(attachment.dataUrl);
+      if (parsed === null || parsed.mimeType !== attachment.mimeType.toLowerCase()) {
+        return yield* new PersistChatAttachmentsError({
+          message: `Attachment ${attachment.name} has an invalid image payload.`,
+        });
+      }
+      const bytes = yield* Effect.fromResult(Encoding.decodeBase64(parsed.base64)).pipe(
+        Effect.mapError(
+          (cause) =>
+            new PersistChatAttachmentsError({
+              message: `Attachment ${attachment.name} is not valid base64.`,
+              cause,
+            }),
+        ),
+      );
+      if (bytes.byteLength !== attachment.sizeBytes) {
+        return yield* new PersistChatAttachmentsError({
+          message: `Attachment ${attachment.name} size does not match its payload.`,
+        });
+      }
+      const rawId = createDeterministicAttachmentId(input.threadId, `${input.messageId}:${index}`);
+      if (rawId === null) {
+        return yield* new PersistChatAttachmentsError({
+          message: "Could not allocate an attachment identifier.",
+        });
+      }
+      const persisted = {
+        type: "image" as const,
+        id: ChatAttachmentId.make(rawId),
+        name: attachment.name,
+        mimeType: attachment.mimeType,
+        sizeBytes: attachment.sizeBytes,
+      };
+      yield* fileSystem
+        .writeFile(path.join(config.attachmentsDir, attachmentRelativePath(persisted)!), bytes)
+        .pipe(
+          Effect.mapError(
+            (cause) =>
+              new PersistChatAttachmentsError({
+                message: `Could not persist attachment ${attachment.name}.`,
+                cause,
+              }),
+          ),
+        );
+      return persisted;
+    }),
+    { concurrency: 2 },
+  );
+});
 
 function projectEntriesFailureContext(error: WorkspaceEntries.WorkspaceEntriesError): {
   readonly failure: ProjectEntriesFailure;
@@ -284,43 +378,9 @@ function projectFileFailureContext(
   }
 }
 
-function projectSetupScriptCompatibilityDetail(
-  error: ProjectSetupScriptRunner.ProjectSetupScriptRunnerError,
-): string {
-  switch (error._tag) {
-    case "ProjectSetupScriptOperationError":
-      return legacySetupFailureDescription(error.cause);
-    case "ProjectSetupScriptProjectNotFoundError":
-      return "Project was not found for setup script execution.";
-    default:
-      return unexpectedCompatibilityError(error);
-  }
-}
-
-export function isThreadDetailEvent(event: OrchestrationEvent): event is Extract<
-  OrchestrationEvent,
-  {
-    type:
-      | "thread.message-sent"
-      | "thread.proposed-plan-upserted"
-      | "thread.activity-appended"
-      | "thread.turn-diff-completed"
-      | "thread.reverted"
-      | "thread.session-set";
-  }
-> {
-  return (
-    event.type === "thread.message-sent" ||
-    event.type === "thread.proposed-plan-upserted" ||
-    event.type === "thread.activity-appended" ||
-    event.type === "thread.turn-diff-completed" ||
-    event.type === "thread.reverted" ||
-    event.type === "thread.session-set"
-  );
-}
-
 const PROVIDER_STATUS_DEBOUNCE_MS = 200;
 
+const ServerWsRpcGroup = WsRpcGroup;
 // When a resuming client's cursor is more than this many events behind the
 // current head, skip the per-event catch-up replay and send a fresh shell
 // snapshot instead. Replaying each intervening event costs a shell refetch;
@@ -328,13 +388,6 @@ const PROVIDER_STATUS_DEBOUNCE_MS = 200;
 // Matches the event store's default page size (DEFAULT_READ_FROM_SEQUENCE_LIMIT).
 const SHELL_RESUME_MAX_GAP = 1_000;
 
-// Same bound for thread resume. The replay reads the *global* event range and
-// filters per-thread afterwards, so a stale cursor far behind the head would
-// otherwise decode every intervening event's payload — reconnects with cursors
-// hundreds of thousands of events behind have OOM-killed servers on large
-// databases. Past this gap the client is reset with a fresh thread snapshot.
-const THREAD_RESUME_MAX_GAP = 1_000;
-
 function toAuthAccessStreamEvent(
   change: PairingGrantStore.BootstrapCredentialChange | SessionStore.SessionCredentialChange,
   revision: number,
@@ -384,6 +437,13 @@ const MAX_CLIENT_APP_VERSION_LENGTH = 64;
 const MAX_CLIENT_BROWSER_LENGTH = 64;
 const MAX_CLIENT_DEVICE_MODEL_LENGTH = 80;
 
+export function hasCompatibleOrchestrationProtocol(url: URL): boolean {
+  return (
+    url.searchParams.get(ORCHESTRATION_PROTOCOL_QUERY_PARAM) ===
+    String(ORCHESTRATION_PROTOCOL_VERSION)
+  );
+}
+
 // Optional client identity announced on the /ws upgrade URL next to wsTicket.
 // Lenient by design: absent or malformed values degrade to {} so a connection
 // never fails over attribution metadata.
@@ -456,41 +516,62 @@ const makeWsRpcLayer = (
   clientAnalyticsProps: Readonly<Record<string, unknown>>,
   previewAutomationBroker: PreviewAutomationBroker.PreviewAutomationBroker["Service"],
 ) =>
-  WsRpcGroup.toLayer(
+  ServerWsRpcGroup.toLayer(
     Effect.gen(function* () {
       const currentSessionId = currentSession.sessionId;
-      const crypto = yield* Crypto.Crypto;
+      const sql = yield* SqlClient.SqlClient;
+      const threadManagement = yield* ThreadManagementService.ThreadManagementService;
+      const applicationEvents = yield* OrchestrationEventStore.OrchestrationEventStore;
       const projectionSnapshotQuery = yield* ProjectionSnapshotQuery.ProjectionSnapshotQuery;
-      const orchestrationEngine = yield* OrchestrationEngine.OrchestrationEngineService;
-      const threadDeletionReactor = yield* ThreadDeletionReactor;
+      const providerSessionsV2 = yield* ProviderSessionManagerV2;
       const analytics = yield* AnalyticsService.AnalyticsService;
-      // Every command dispatched on this connection carries the connecting
-      // client's origin, including server-generated bootstrap sub-commands:
-      // the client's request caused them.
-      const hasClientOrigin =
-        clientOrigin.surface !== undefined || clientOrigin.appVersion !== undefined;
-      const dispatchFromClient: OrchestrationEngine.OrchestrationEngineShape["dispatch"] = (
-        command,
-      ) =>
-        orchestrationEngine.dispatch(
-          command,
-          hasClientOrigin ? { origin: clientOrigin } : undefined,
-        );
-      const recordClientCommandAnalytics = (command: OrchestrationCommand) => {
+      // Client-origin attribution (#7774): every thread/turn the connecting
+      // client starts is credited to its surface + app version. Best-effort:
+      // attribution must never fail the user's command.
+      const originProps = clientAnalyticsProps;
+      const recordClientCommandAnalytics = (command: OrchestrationV2Command) => {
         switch (command.type) {
-          case "thread.create":
-            return analytics.record("client.thread.started", clientAnalyticsProps);
-          case "thread.turn.start":
-            return command.bootstrap?.createThread
-              ? Effect.andThen(
-                  analytics.record("client.thread.started", clientAnalyticsProps),
-                  analytics.record("client.turn.requested", clientAnalyticsProps),
-                )
-              : analytics.record("client.turn.requested", clientAnalyticsProps);
+          case "message.dispatch":
+            return analytics.record("client.turn.requested", originProps).pipe(Effect.ignore);
           default:
             return Effect.void;
         }
       };
+      const projectEnrichment = yield* ProjectEnrichmentService.ProjectEnrichmentService;
+      const enrichProjectShells = Effect.fn("ws.orchestrationV2.enrichProjectShells")(
+        (projects: ReadonlyArray<OrchestrationProjectShell>) =>
+          Effect.forEach(
+            projects,
+            (project) =>
+              // Non-blocking: emit with cached identity (or null) and schedule
+              // background resolution. subscribeChanges is attached before
+              // loadSnapshot, so later identity completions push refreshed
+              // shells for multi-env grouping without blocking the initial
+              // snapshot or completion marker on slow git probes.
+              projectEnrichment.getAvailable(project.workspaceRoot).pipe(
+                Effect.map((enrichment) => ({
+                  project: {
+                    ...project,
+                    repositoryIdentity: enrichment.repositoryIdentity,
+                  },
+                  repositoryIdentityResolved: enrichment.repositoryIdentityResolved,
+                })),
+              ),
+            { concurrency: 16 },
+          ).pipe(
+            Effect.map((enriched) => ({
+              projects: enriched.map((entry) => entry.project),
+              resolvedRepositoryIdentityRoots: enriched
+                .filter((entry) => entry.repositoryIdentityResolved)
+                .map((entry) => entry.project.workspaceRoot),
+            })),
+          ),
+      );
+      const threadLaunch = yield* ThreadLaunchService.ThreadLaunchService;
+      const scheduledTasks = yield* ScheduledTasks.ScheduledTaskService;
+      const pullRequests = yield* PullRequestService.PullRequestService;
+      const usage = yield* UsageService.UsageService;
+      const projectService = yield* ProjectService.ProjectService;
       const checkpointDiffQuery = yield* CheckpointDiffQuery.CheckpointDiffQuery;
       const keybindings = yield* Keybindings.Keybindings;
       const environmentTheme = yield* EnvironmentTheme.EnvironmentThemeService;
@@ -504,7 +585,6 @@ const makeWsRpcLayer = (
       const previewManager = yield* PreviewManager.PreviewManager;
       const portDiscovery = yield* PortScanner.PortDiscovery;
       const providerRegistry = yield* ProviderRegistry.ProviderRegistry;
-      const providerService = yield* ProviderService.ProviderService;
       const providerMaintenanceRunner = yield* ProviderMaintenanceRunner.ProviderMaintenanceRunner;
       const serverSelfUpdate = yield* ServerSelfUpdate.ServerSelfUpdate;
       const config = yield* ServerConfig.ServerConfig;
@@ -513,7 +593,6 @@ const makeWsRpcLayer = (
       const startup = yield* ServerRuntimeStartup.ServerRuntimeStartup;
       const workspaceEntries = yield* WorkspaceEntries.WorkspaceEntries;
       const workspaceFileSystem = yield* WorkspaceFileSystem.WorkspaceFileSystem;
-      const projectSetupScriptRunner = yield* ProjectSetupScriptRunner.ProjectSetupScriptRunner;
       const serverEnvironment = yield* ServerEnvironment.ServerEnvironment;
       const backgroundPolicy = yield* BackgroundPolicy.BackgroundPolicy;
       const rpcClientIds = yield* Ref.make(new Set<RpcClientId>());
@@ -545,13 +624,11 @@ const makeWsRpcLayer = (
       );
       const sourceControlRepositories =
         yield* SourceControlRepositoryService.SourceControlRepositoryService;
-      const pullRequests = yield* PullRequestService.PullRequestService;
       const bootstrapCredentials = yield* PairingGrantStore.PairingGrantStore;
       const sessions = yield* SessionStore.SessionStore;
       const processDiagnostics = yield* ProcessDiagnostics.ProcessDiagnostics;
       const processResourceMonitor = yield* ProcessResourceMonitor.ProcessResourceMonitor;
       const resourceTelemetry = yield* ResourceTelemetry.ResourceTelemetry;
-      const usage = yield* UsageService.UsageService;
       const relayClient = yield* RelayClient.RelayClient;
       const authorizationError = (requiredScope: AuthEnvironmentScope) =>
         new EnvironmentAuthorizationError({
@@ -606,22 +683,6 @@ const makeWsRpcLayer = (
           authorizeEffect(requiredScopeForRpcMethod(method), effect),
           traceAttributes,
         );
-      const toDispatchCommandError = (cause: unknown, fallbackMessage: string) =>
-        isOrchestrationDispatchCommandError(cause)
-          ? cause
-          : new OrchestrationDispatchCommandError({
-              message: cause instanceof Error ? cause.message : fallbackMessage,
-              cause,
-            });
-      const randomUUID = crypto.randomUUIDv4.pipe(
-        Effect.mapError((cause) =>
-          toDispatchCommandError(cause, "Failed to generate orchestration command identifier."),
-        ),
-      );
-      const serverEventId = randomUUID.pipe(Effect.map(EventId.make));
-      const serverCommandId = (tag: string) =>
-        randomUUID.pipe(Effect.map((uuid) => CommandId.make(`server:${tag}:${uuid}`)));
-
       const loadAuthAccessSnapshot = () =>
         Effect.all({
           pairingLinks: serverAuth.listPairingLinks(),
@@ -635,528 +696,6 @@ const makeWsRpcLayer = (
           ),
         );
 
-      const appendSetupScriptActivity = (input: {
-        readonly threadId: ThreadId;
-        readonly kind: "setup-script.requested" | "setup-script.started" | "setup-script.failed";
-        readonly summary: string;
-        readonly createdAt: string;
-        readonly payload: Record<string, unknown>;
-        readonly tone: "info" | "error";
-      }) =>
-        Effect.all({
-          commandId: serverCommandId("setup-script-activity"),
-          activityId: serverEventId,
-        }).pipe(
-          Effect.flatMap(({ commandId, activityId }) =>
-            dispatchFromClient({
-              type: "thread.activity.append",
-              commandId,
-              threadId: input.threadId,
-              activity: {
-                id: activityId,
-                tone: input.tone,
-                kind: input.kind,
-                summary: input.summary,
-                payload: input.payload,
-                turnId: null,
-                createdAt: input.createdAt,
-              },
-              createdAt: input.createdAt,
-            }),
-          ),
-        );
-
-      const toBootstrapDispatchCommandCauseError = (cause: Cause.Cause<unknown>) => {
-        const error = Cause.squash(cause);
-        return isOrchestrationDispatchCommandError(error)
-          ? error
-          : new OrchestrationDispatchCommandError({
-              message:
-                error instanceof Error ? error.message : "Failed to bootstrap thread turn start.",
-              cause,
-            });
-      };
-
-      const toShellStreamEvent = (
-        event: OrchestrationEvent,
-      ): Effect.Effect<Option.Option<OrchestrationShellStreamEvent>, never, never> => {
-        switch (event.type) {
-          case "project.created":
-          case "project.meta-updated":
-            return projectUpsertOrRemove(event.payload.projectId, event.sequence);
-          case "project.deleted":
-            return Effect.succeed(
-              Option.some({
-                kind: "project-removed" as const,
-                sequence: event.sequence,
-                projectId: event.payload.projectId,
-              }),
-            );
-          case "thread.deleted":
-          case "thread.archived":
-            return Effect.succeed(
-              Option.some({
-                kind: "thread-removed" as const,
-                sequence: event.sequence,
-                threadId: event.payload.threadId,
-              }),
-            );
-          case "thread.unarchived":
-            return threadUpsertOrRemove(event.payload.threadId, event.sequence);
-          default:
-            if (event.aggregateKind !== "thread") {
-              return Effect.succeed(Option.none());
-            }
-            return threadUpsertOrRemove(ThreadId.make(event.aggregateId), event.sequence);
-        }
-      };
-
-      // Coalescing makes each projection read represent every event for that
-      // aggregate in the current window. Retry a typed persistence failure once
-      // so a brief read failure cannot strand the shell at its previous state.
-      // If both attempts fail, log and drop the stream item; treating an error as
-      // a missing row would incorrectly remove a still-active aggregate.
-      const retryShellProjectionRead = <A, E>(
-        aggregateKind: "project" | "thread",
-        aggregateId: string,
-        read: Effect.Effect<A, E>,
-      ): Effect.Effect<Option.Option<A>, never, never> =>
-        read.pipe(
-          Effect.retry({ times: 1 }),
-          Effect.map(Option.some),
-          Effect.tapError((error) =>
-            Effect.logWarning("orchestration shell projection refetch failed", {
-              aggregateKind,
-              aggregateId,
-              error,
-            }),
-          ),
-          Effect.orElseSucceed(() => Option.none()),
-        );
-
-      const projectUpsertOrRemove = (
-        projectId: ProjectId,
-        sequence: number,
-      ): Effect.Effect<Option.Option<OrchestrationShellStreamEvent>, never, never> =>
-        retryShellProjectionRead(
-          "project",
-          projectId,
-          projectionSnapshotQuery.getProjectShellById(projectId),
-        ).pipe(
-          Effect.map(
-            Option.flatMap((project) =>
-              Option.match(project, {
-                onNone: () =>
-                  Option.some<OrchestrationShellStreamEvent>({
-                    kind: "project-removed" as const,
-                    sequence,
-                    projectId,
-                  }),
-                onSome: (nextProject) =>
-                  Option.some<OrchestrationShellStreamEvent>({
-                    kind: "project-upserted" as const,
-                    sequence,
-                    project: nextProject,
-                  }),
-              }),
-            ),
-          ),
-        );
-
-      // Refetch a thread's shell and emit an upsert if it is still active, or a
-      // `thread-removed` if the projection has no active row for it. Emitting a
-      // removal on a `none` (rather than dropping the event) is what keeps
-      // coalescing correct: when a burst collapses a `thread.deleted`/`archived`
-      // into a later refetchable event for the same thread, the refetch returns
-      // `none` for the now-inactive row and this still tells the sidebar to drop
-      // it. A `thread-removed` the client does not have is a harmless no-op. The
-      // projection commits in the same transaction before the event publishes,
-      // so a `none` reliably means the thread is deleted or archived, not
-      // not-yet-persisted.
-      const threadUpsertOrRemove = (
-        threadId: ThreadId,
-        sequence: number,
-      ): Effect.Effect<Option.Option<OrchestrationShellStreamEvent>, never, never> =>
-        retryShellProjectionRead(
-          "thread",
-          threadId,
-          projectionSnapshotQuery.getThreadShellById(threadId),
-        ).pipe(
-          Effect.map(
-            Option.flatMap((thread) =>
-              Option.match(thread, {
-                onNone: () =>
-                  Option.some<OrchestrationShellStreamEvent>({
-                    kind: "thread-removed" as const,
-                    sequence,
-                    threadId,
-                  }),
-                onSome: (nextThread) =>
-                  Option.some<OrchestrationShellStreamEvent>({
-                    kind: "thread-upserted" as const,
-                    sequence,
-                    thread: nextThread,
-                  }),
-              }),
-            ),
-          ),
-        );
-
-      // Turn a batch of domain events into shell stream items, coalescing by
-      // aggregate first. `toShellStreamEvent` re-reads the *current* projected
-      // shell for an aggregate, so within a batch only the latest event per
-      // aggregate matters: a burst of streaming `thread.message-sent` deltas for
-      // one thread collapses into a single shell refetch, and an unrelated
-      // `thread.created` in the same batch is never stuck behind those DB reads.
-      //
-      // Input events arrive in ascending sequence; we keep the last (highest
-      // sequence) event per aggregate, then re-sort ascending before emitting so
-      // the client — which applies shell items strictly by increasing sequence
-      // and drops any `sequence <= snapshotSequence` — never skips a coalesced
-      // item. The refetch runs with bounded concurrency (order-preserving).
-      const SHELL_REFETCH_CONCURRENCY = 8;
-      const coalesceShellEvents = (
-        events: ReadonlyArray<OrchestrationEvent>,
-      ): Effect.Effect<ReadonlyArray<OrchestrationShellStreamEvent>, never, never> =>
-        Effect.gen(function* () {
-          if (events.length === 0) {
-            return [];
-          }
-          const latestByAggregate = new Map<string, OrchestrationEvent>();
-          for (const event of events) {
-            latestByAggregate.set(`${event.aggregateKind}:${event.aggregateId}`, event);
-          }
-          const survivors = Array.from(latestByAggregate.values()).sort(
-            (left, right) => left.sequence - right.sequence,
-          );
-          const shellEvents = yield* Effect.forEach(survivors, toShellStreamEvent, {
-            concurrency: SHELL_REFETCH_CONCURRENCY,
-          });
-          return shellEvents.flatMap((option) => (Option.isSome(option) ? [option.value] : []));
-        });
-
-      // Small time/size window over which to coalesce shell events. The window
-      // bounds the worst-case added latency for a brand-new thread to appear in
-      // the sidebar (imperceptible), while collapsing high-frequency streaming
-      // traffic so it can't serialize the shell stream behind per-event DB reads.
-      const SHELL_COALESCE_WINDOW = Duration.millis(50);
-      const SHELL_COALESCE_MAX_CHUNK = 512;
-      const coalesceShellStream = <E, R>(
-        stream: Stream.Stream<OrchestrationEvent, E, R>,
-      ): Stream.Stream<OrchestrationShellStreamEvent, E, R> =>
-        stream.pipe(
-          Stream.groupedWithin(SHELL_COALESCE_MAX_CHUNK, SHELL_COALESCE_WINDOW),
-          Stream.mapEffect(coalesceShellEvents),
-          Stream.flatMap((items) => Stream.fromIterable(items)),
-        );
-
-      type ShellLiveInput =
-        | { readonly kind: "event"; readonly event: OrchestrationEvent }
-        | { readonly kind: "synchronized" };
-
-      // A completion marker is queued alongside raw live events so it cannot
-      // overtake an event still waiting in the coalescing window. Split each
-      // batch at markers and coalesce only the event segments on either side.
-      const coalesceShellLiveInputs = (
-        inputs: ReadonlyArray<ShellLiveInput>,
-      ): Effect.Effect<ReadonlyArray<OrchestrationShellStreamItem>, never, never> =>
-        Effect.gen(function* () {
-          const output: Array<OrchestrationShellStreamItem> = [];
-          let pendingEvents: Array<OrchestrationEvent> = [];
-
-          for (const input of inputs) {
-            if (input.kind === "event") {
-              pendingEvents.push(input.event);
-              continue;
-            }
-
-            output.push(...(yield* coalesceShellEvents(pendingEvents)));
-            pendingEvents = [];
-            output.push({ kind: "synchronized" });
-          }
-
-          output.push(...(yield* coalesceShellEvents(pendingEvents)));
-          return output;
-        });
-
-      const coalesceShellLiveStream = <E, R>(
-        stream: Stream.Stream<ShellLiveInput, E, R>,
-      ): Stream.Stream<OrchestrationShellStreamItem, E, R> =>
-        stream.pipe(
-          Stream.groupedWithin(SHELL_COALESCE_MAX_CHUNK, SHELL_COALESCE_WINDOW),
-          Stream.mapEffect(coalesceShellLiveInputs),
-          Stream.flatMap((items) => Stream.fromIterable(items)),
-        );
-
-      const dispatchBootstrapTurnStart = (
-        command: Extract<OrchestrationCommand, { type: "thread.turn.start" }>,
-      ): Effect.Effect<{ readonly sequence: number }, OrchestrationDispatchCommandError> =>
-        Effect.gen(function* () {
-          const bootstrap = command.bootstrap;
-          const { bootstrap: _bootstrap, ...finalTurnStartCommand } = command;
-          let createdThread = false;
-          let targetProjectId = bootstrap?.createThread?.projectId;
-          let targetProjectCwd = bootstrap?.prepareWorktree?.projectCwd;
-          let targetWorktreePath = bootstrap?.createThread?.worktreePath ?? null;
-
-          const cleanupCreatedThread = () =>
-            createdThread
-              ? serverCommandId("bootstrap-thread-delete").pipe(
-                  Effect.flatMap((commandId) =>
-                    dispatchFromClient({
-                      type: "thread.delete",
-                      commandId,
-                      threadId: command.threadId,
-                    }),
-                  ),
-                  Effect.as(true),
-                )
-              : Effect.succeed(false);
-
-          const recordSetupScriptLaunchFailure = (input: {
-            readonly error: ProjectSetupScriptRunner.ProjectSetupScriptRunnerError;
-            readonly requestedAt: string;
-            readonly worktreePath: string;
-          }) => {
-            const detail = projectSetupScriptCompatibilityDetail(input.error);
-            return appendSetupScriptActivity({
-              threadId: command.threadId,
-              kind: "setup-script.failed",
-              summary: "Setup script failed to start",
-              createdAt: input.requestedAt,
-              payload: {
-                detail,
-                worktreePath: input.worktreePath,
-              },
-              tone: "error",
-            }).pipe(
-              Effect.ignoreCause({ log: false }),
-              Effect.flatMap(() =>
-                Effect.logWarning("bootstrap turn start failed to launch setup script", {
-                  threadId: command.threadId,
-                  worktreePath: input.worktreePath,
-                  detail,
-                }),
-              ),
-            );
-          };
-
-          const recordSetupScriptStarted = (input: {
-            readonly requestedAt: string;
-            readonly worktreePath: string;
-            readonly scriptId: string;
-            readonly scriptName: string;
-            readonly terminalId: string;
-          }) =>
-            Effect.gen(function* () {
-              const startedAt = yield* nowIso;
-              const payload = {
-                scriptId: input.scriptId,
-                scriptName: input.scriptName,
-                terminalId: input.terminalId,
-                worktreePath: input.worktreePath,
-              };
-              yield* Effect.all([
-                appendSetupScriptActivity({
-                  threadId: command.threadId,
-                  kind: "setup-script.requested",
-                  summary: "Starting setup script",
-                  createdAt: input.requestedAt,
-                  payload,
-                  tone: "info",
-                }),
-                appendSetupScriptActivity({
-                  threadId: command.threadId,
-                  kind: "setup-script.started",
-                  summary: "Setup script started",
-                  createdAt: startedAt,
-                  payload,
-                  tone: "info",
-                }),
-              ]).pipe(
-                Effect.asVoid,
-                Effect.catch((error) =>
-                  Effect.logWarning(
-                    "bootstrap turn start launched setup script but failed to record setup activity",
-                    {
-                      threadId: command.threadId,
-                      worktreePath: input.worktreePath,
-                      scriptId: input.scriptId,
-                      terminalId: input.terminalId,
-                      detail: error.message,
-                    },
-                  ),
-                ),
-              );
-            });
-
-          const runSetupProgram = () =>
-            Effect.gen(function* () {
-              if (!bootstrap?.runSetupScript || !targetWorktreePath) {
-                return;
-              }
-              const worktreePath = targetWorktreePath;
-              const requestedAt = yield* nowIso;
-              yield* projectSetupScriptRunner
-                .runForThread({
-                  threadId: command.threadId,
-                  ...(targetProjectId ? { projectId: targetProjectId } : {}),
-                  ...(targetProjectCwd ? { projectCwd: targetProjectCwd } : {}),
-                  worktreePath,
-                })
-                .pipe(
-                  Effect.matchEffect({
-                    onFailure: (error) =>
-                      recordSetupScriptLaunchFailure({
-                        error,
-                        requestedAt,
-                        worktreePath,
-                      }),
-                    onSuccess: (setupResult) => {
-                      if (setupResult.status !== "started") {
-                        return Effect.void;
-                      }
-                      return recordSetupScriptStarted({
-                        requestedAt,
-                        worktreePath,
-                        scriptId: setupResult.scriptId,
-                        scriptName: setupResult.scriptName,
-                        terminalId: setupResult.terminalId,
-                      });
-                    },
-                  }),
-                );
-            });
-
-          const bootstrapProgram = Effect.gen(function* () {
-            if (bootstrap?.createThread) {
-              const created = yield* dispatchFromClient({
-                type: "thread.create",
-                commandId: yield* serverCommandId("bootstrap-thread-create"),
-                threadId: command.threadId,
-                projectId: bootstrap.createThread.projectId,
-                title: bootstrap.createThread.title,
-                modelSelection: bootstrap.createThread.modelSelection,
-                runtimeMode: bootstrap.createThread.runtimeMode,
-                interactionMode: bootstrap.createThread.interactionMode,
-                branch: bootstrap.createThread.branch,
-                worktreePath: bootstrap.createThread.worktreePath,
-                createdAt: bootstrap.createThread.createdAt,
-              });
-              // The successful create is a fence in the engine command queue:
-              // every delete for the prior incarnation committed before it.
-              // Drain through that event before setup or turn start can own
-              // terminals and provider sessions under the reused thread id.
-              yield* threadDeletionReactor.drainThrough(created.sequence);
-              createdThread = true;
-            }
-
-            if (bootstrap?.prepareWorktree) {
-              let worktreeBaseRef = bootstrap.prepareWorktree.baseBranch;
-              // "Start from origin" is a stored default; repos without an
-              // origin remote fall back to the local base branch instead of
-              // failing the whole bootstrap on `git fetch origin`.
-              const startFromOrigin =
-                bootstrap.prepareWorktree.startFromOrigin === true &&
-                (yield* gitWorkflow.remoteExists({
-                  cwd: bootstrap.prepareWorktree.projectCwd,
-                  remoteName: "origin",
-                }));
-              if (startFromOrigin) {
-                yield* gitWorkflow.fetchRemote({
-                  cwd: bootstrap.prepareWorktree.projectCwd,
-                  remoteName: "origin",
-                });
-                const resolvedRemoteBase = yield* gitWorkflow.resolveRemoteTrackingCommit({
-                  cwd: bootstrap.prepareWorktree.projectCwd,
-                  refName: bootstrap.prepareWorktree.baseBranch,
-                  fallbackRemoteName: "origin",
-                });
-                worktreeBaseRef = resolvedRemoteBase.commitSha;
-              }
-              const worktree = yield* gitWorkflow.createWorktree({
-                cwd: bootstrap.prepareWorktree.projectCwd,
-                refName: worktreeBaseRef,
-                newRefName: bootstrap.prepareWorktree.branch,
-                baseRefName: bootstrap.prepareWorktree.baseBranch,
-                path: null,
-              });
-              targetWorktreePath = worktree.worktree.path;
-              yield* dispatchFromClient({
-                type: "thread.meta.update",
-                commandId: yield* serverCommandId("bootstrap-thread-meta-update"),
-                threadId: command.threadId,
-                branch: worktree.worktree.refName,
-                worktreePath: targetWorktreePath,
-              });
-              yield* refreshGitStatus(targetWorktreePath);
-            }
-
-            yield* runSetupProgram();
-
-            return yield* dispatchFromClient(finalTurnStartCommand);
-          });
-
-          return yield* bootstrapProgram.pipe(
-            Effect.catchCause((cause) => {
-              const dispatchError = toBootstrapDispatchCommandCauseError(cause);
-              if (Cause.hasInterruptsOnly(cause)) {
-                return Effect.fail(dispatchError);
-              }
-              return Effect.uninterruptible(cleanupCreatedThread()).pipe(
-                Effect.matchCauseEffect({
-                  onFailure: (cleanupCause) =>
-                    Effect.logWarning("bootstrap thread cleanup failed", {
-                      threadId: command.threadId,
-                      detail: Cause.pretty(cleanupCause),
-                    }).pipe(Effect.flatMap(() => Effect.fail(dispatchError))),
-                  onSuccess: (threadDeleted) =>
-                    Effect.fail(
-                      threadDeleted
-                        ? new OrchestrationDispatchCommandError({
-                            message: dispatchError.message,
-                            ...(dispatchError.cause !== undefined
-                              ? { cause: dispatchError.cause }
-                              : {}),
-                            bootstrapThreadDisposition: "deleted",
-                          })
-                        : dispatchError,
-                    ),
-                }),
-              );
-            }),
-          );
-        });
-
-      const dispatchNormalizedCommand = (
-        normalizedCommand: OrchestrationCommand,
-      ): Effect.Effect<{ readonly sequence: number }, OrchestrationDispatchCommandError> => {
-        const dispatchEffect =
-          normalizedCommand.type === "thread.turn.start" && normalizedCommand.bootstrap
-            ? dispatchBootstrapTurnStart(normalizedCommand)
-            : dispatchFromClient(normalizedCommand).pipe(
-                Effect.tap(({ sequence }) =>
-                  // Returning from thread.create is the handoff point at which
-                  // clients may start resources for the new incarnation. Use
-                  // its event sequence as the exact deletion-cleanup fence.
-                  normalizedCommand.type === "thread.create"
-                    ? threadDeletionReactor.drainThrough(sequence)
-                    : Effect.void,
-                ),
-                Effect.mapError((cause) =>
-                  toDispatchCommandError(cause, "Failed to dispatch orchestration command"),
-                ),
-              );
-
-        return startup
-          .enqueueCommand(dispatchEffect)
-          .pipe(
-            Effect.mapError((cause) =>
-              toDispatchCommandError(cause, "Failed to dispatch orchestration command"),
-            ),
-          );
-      };
-
       const loadServerConfig = Effect.gen(function* () {
         const keybindingsConfig = yield* keybindings.loadConfigState;
         const providers = yield* providerRegistry.getProviders;
@@ -1216,115 +755,559 @@ const makeWsRpcLayer = (
           .refreshStatus(cwd)
           .pipe(Effect.ignoreCause({ log: true }), Effect.forkDetach, Effect.asVoid);
 
-      return WsRpcGroup.of({
-        [ORCHESTRATION_WS_METHODS.dispatchCommand]: (command) =>
-          observeRpcEffect(
-            ORCHESTRATION_WS_METHODS.dispatchCommand,
-            Effect.gen(function* () {
-              const normalizedCommand = yield* normalizeDispatchCommand(command);
-              // Archive and settle both mean "done with this thread", so a
-              // live provider session must not keep running background work
-              // (PR monitors, dev servers, subagent fleets) after either
-              // lands. The decider rejects settling a starting/running
-              // session, so for settle this only ever stops an idle one; a
-              // stopped session-set does not count as activity, so the stop
-              // cannot un-settle the thread it follows.
-              const parkingCommand =
-                normalizedCommand.type === "thread.archive" ||
-                normalizedCommand.type === "thread.settle"
-                  ? normalizedCommand
-                  : undefined;
-              // Best-effort on purpose: the user's archive/settle must not
-              // fail because this cleanup read blipped, so a failed read
-              // logs and skips the stop instead of propagating.
-              const shouldStopSessionAfterCommand = parkingCommand
-                ? yield* projectionSnapshotQuery.getThreadShellById(parkingCommand.threadId).pipe(
-                    Effect.map(
-                      Option.match({
-                        onNone: () => false,
-                        onSome: (thread) =>
-                          thread.session !== null && thread.session.status !== "stopped",
-                      }),
-                    ),
-                    Effect.catchCause((cause) =>
-                      Effect.logWarning(
-                        "failed to read thread session state before session-stop check",
-                        { threadId: parkingCommand.threadId, cause },
-                      ).pipe(Effect.as(false)),
-                    ),
-                  )
-                : false;
-              const result = yield* dispatchNormalizedCommand(normalizedCommand).pipe(
-                Effect.tapError(() => cleanupFailedUploadedAttachments(command, normalizedCommand)),
+      const subscribeOrchestrationV2Thread = Effect.fn("ws.orchestrationV2.subscribeThread")(
+        function* (input: {
+          readonly threadId: ThreadId;
+          readonly afterSequence?: number;
+          readonly requestCompletionMarker?: boolean;
+        }) {
+          yield* Effect.annotateCurrentSpan({
+            "orchestration_v2.thread_id": input.threadId,
+          });
+          yield* threadManagement.ensureLegacyTranscript(input.threadId).pipe(
+            Effect.mapError(
+              (cause) =>
+                new OrchestrationV2GetThreadProjectionError({
+                  threadId: input.threadId,
+                  message: `Failed to hydrate migrated thread ${input.threadId}`,
+                  cause,
+                }),
+            ),
+          );
+
+          const eventStreamFrom = (afterSequence: number) =>
+            threadManagement
+              .streamStoredEventsFrom({
+                threadId: input.threadId,
+                afterSequence,
+              })
+              .pipe(
+                Stream.map((stored) => ({
+                  kind: "event" as const,
+                  sequence: stored.sequence,
+                  event: projectDomainEventForWire(stored.event),
+                })),
+                Stream.mapError(
+                  (cause) =>
+                    new OrchestrationV2GetThreadProjectionError({
+                      threadId: input.threadId,
+                      message: `Failed while streaming orchestration V2 thread ${input.threadId}`,
+                      cause,
+                    }),
+                ),
               );
-              yield* recordClientCommandAnalytics(normalizedCommand);
-              if (parkingCommand) {
-                const parkingKind = parkingCommand.type === "thread.archive" ? "archive" : "settle";
-                if (shouldStopSessionAfterCommand) {
-                  yield* Effect.gen(function* () {
-                    const stopCommand = yield* normalizeDispatchCommand({
-                      type: "thread.session.stop",
-                      commandId: CommandId.make(
-                        `session-stop-for-${parkingKind}:${parkingCommand.commandId}`,
-                      ),
-                      threadId: parkingCommand.threadId,
-                      createdAt: yield* nowIso,
-                      // A settled thread can be re-engaged before this stop is
-                      // decided; the decider then drops the stop instead of
-                      // killing the new session. Archive stops stay
-                      // unconditional: turn starts on archived threads are
-                      // rejected, so there is no new session to protect.
-                      ...(parkingKind === "settle" ? { onlyIfSettled: true } : {}),
-                    });
 
-                    yield* dispatchNormalizedCommand(stopCommand);
-                  }).pipe(
-                    Effect.catchCause((cause) =>
-                      Effect.logWarning(`failed to stop provider session during ${parkingKind}`, {
-                        threadId: parkingCommand.threadId,
-                        cause,
-                      }),
-                    ),
-                  );
-                }
+          const loadReplayThrough = (afterSequence: number, throughSequence: number) =>
+            applicationEvents
+              .readAgentEvents({
+                threadId: input.threadId,
+                afterSequence,
+                throughSequence,
+                limit: THREAD_RESUME_MAX_REPLAY_EVENTS + 1,
+              })
+              .pipe(
+                Stream.map((stored) => ({
+                  kind: "event" as const,
+                  sequence: stored.sequence,
+                  event: projectDomainEventForWire(stored.event),
+                })),
+                Stream.runCollect,
+                Effect.map((items) => Array.from(items)),
+                Effect.mapError(
+                  (cause) =>
+                    new OrchestrationV2GetThreadProjectionError({
+                      threadId: input.threadId,
+                      message: `Failed while replaying orchestration V2 thread ${input.threadId}`,
+                      cause,
+                    }),
+                ),
+              );
 
-                // Terminals are user-opened panes, not thread background
-                // work: archive removes the thread from view so they close
-                // with it, but a settled thread stays reachable and may be
-                // un-settled, so its terminals stay up.
-                if (parkingCommand.type === "thread.archive") {
-                  yield* terminalManager.close({ threadId: parkingCommand.threadId }).pipe(
-                    Effect.catch((error) =>
-                      Effect.logWarning("failed to close thread terminals after archive", {
-                        threadId: parkingCommand.threadId,
-                        error: error.message,
-                      }),
-                    ),
-                  );
-                }
-              }
-              return result;
-            }).pipe(
-              Effect.mapError((cause) =>
-                isOrchestrationDispatchCommandError(cause)
-                  ? cause
-                  : new OrchestrationDispatchCommandError({
-                      message: "Failed to dispatch orchestration command",
+          const completionMarker =
+            input.requestCompletionMarker === true
+              ? Stream.make({ kind: "synchronized" as const })
+              : Stream.empty;
+
+          const snapshotThenLive = Effect.fn("ws.orchestrationV2.threadSnapshotThenLive")(
+            function* () {
+              const snapshot = yield* threadManagement.getThreadSnapshot(input.threadId).pipe(
+                Effect.mapError(
+                  (cause) =>
+                    new OrchestrationV2GetThreadProjectionError({
+                      threadId: input.threadId,
+                      message: `Failed to load orchestration V2 thread ${input.threadId}`,
                       cause,
                     }),
+                ),
+              );
+              const { snapshotSequence } = snapshot;
+              const projection = projectThreadProjectionForWire(snapshot.projection);
+              return Stream.concat(
+                Stream.concat(
+                  Stream.make({
+                    kind: "snapshot" as const,
+                    snapshotSequence,
+                    projection,
+                  }),
+                  completionMarker,
+                ),
+                eventStreamFrom(snapshotSequence),
+              );
+            },
+          );
+
+          // When the client already holds the projection (cached, or loaded over
+          // HTTP) it passes that snapshot's sequence, and we resume by replaying
+          // persisted events after it instead of re-sending the (potentially
+          // multi-KB) snapshot frame over the socket. The event sink subscribes
+          // to live events before reading the persisted tail, so no event
+          // published during the replay window is lost; overlapping events are
+          // deduped by sequence on the client.
+          if (input.afterSequence !== undefined) {
+            const highWater = yield* applicationEvents.latestAgentSequence(input.threadId).pipe(
+              Effect.mapError(
+                (cause) =>
+                  new OrchestrationV2GetThreadProjectionError({
+                    threadId: input.threadId,
+                    message: `Failed to prepare orchestration V2 thread ${input.threadId} replay`,
+                    cause,
+                  }),
+              ),
+            );
+            const replay = yield* loadReplayThrough(input.afterSequence, highWater);
+            const plan = decideThreadResume({
+              afterSequence: input.afterSequence,
+              highWater,
+              replayEventCount: replay.length,
+              replayEncodedBytes: threadReplayEncodedBytes(replay),
+            });
+            if (plan.mode === "snapshot") {
+              return yield* snapshotThenLive();
+            }
+            return Stream.concat(
+              Stream.concat(Stream.fromIterable(replay), completionMarker),
+              eventStreamFrom(highWater),
+            );
+          }
+
+          return yield* snapshotThenLive();
+        },
+      );
+
+      const subscribeOrchestrationV2Shell = Effect.fn("ws.orchestrationV2.subscribeShell")(
+        function* (input: {
+          readonly afterSequence?: number;
+          readonly requestCompletionMarker?: boolean;
+        }) {
+          const enrichmentChanges = yield* projectEnrichment.subscribeChanges;
+          const loadProjectMetadataSnapshot = Effect.fn(
+            "ws.orchestrationV2.loadProjectMetadataSnapshot",
+          )(function* (snapshotSequence: number) {
+            const projects = yield* projectionSnapshotQuery.getProjectShellsWithoutEnrichment();
+            const enriched = yield* enrichProjectShells(projects);
+            return {
+              snapshot: {
+                schemaVersion: ORCHESTRATION_V2_PROJECTION_SCHEMA_VERSION,
+                snapshotSequence,
+                projects: enriched.projects,
+                threads: [],
+                archivedThreads: [],
+              } as OrchestrationV2ShellSnapshot,
+              resolvedRepositoryIdentityRoots: enriched.resolvedRepositoryIdentityRoots,
+            };
+          });
+          const loadSnapshot = Effect.fn("ws.orchestrationV2.loadShellSnapshot")(function* () {
+            const base = yield* sql.withTransaction(
+              Effect.gen(function* () {
+                const projects = yield* projectionSnapshotQuery.getProjectShellsWithoutEnrichment();
+                const threads = yield* threadManagement.getShellSnapshot({ location: "active" });
+                return buildActiveShellSnapshot({
+                  projects,
+                  threads,
+                  snapshotSequence: yield* applicationEvents.latestApplicationSequence,
+                });
+              }),
+            );
+            const enriched = yield* enrichProjectShells(base.projects);
+            return {
+              snapshot: { ...base, projects: enriched.projects } as OrchestrationV2ShellSnapshot,
+              resolvedRepositoryIdentityRoots: enriched.resolvedRepositoryIdentityRoots,
+            };
+          });
+          const projectItem = Effect.fn("ws.orchestrationV2.projectShellItem")(function* (
+            stored: Extract<ApplicationStoredEvent, { readonly aggregateKind: "project" }>,
+          ) {
+            if (stored.type === "project.deleted") {
+              return {
+                kind: "project.removed" as const,
+                sequence: stored.sequence,
+                projectId: stored.payload.projectId,
+              };
+            }
+            const project = yield* projectionSnapshotQuery.getProjectShellById(
+              stored.payload.projectId,
+            );
+            return Option.match(project, {
+              onNone: () => ({
+                kind: "project.removed" as const,
+                sequence: stored.sequence,
+                projectId: stored.payload.projectId,
+              }),
+              onSome: (value) => ({
+                kind: "project.updated" as const,
+                sequence: stored.sequence,
+                project: value,
+              }),
+            });
+          });
+
+          // Coalescing makes each per-thread shell read represent every event
+          // for that thread in the current window; reading only the affected
+          // threads keeps the cost of a busy stream independent of how many
+          // threads exist overall.
+          const projectShellItems = Effect.fn("ws.orchestrationV2.projectShellItems")(function* (
+            events: ReadonlyArray<ApplicationStoredEvent>,
+          ) {
+            return yield* Effect.forEach(
+              coalesceShellApplicationEvents(events),
+              (stored) =>
+                Effect.gen(function* () {
+                  if ("aggregateKind" in stored) {
+                    return yield* projectItem(stored);
+                  }
+                  const shell = yield* threadManagement.getThreadShell(stored.event.threadId);
+                  return shellStreamItemFromThreadShell({ stored, shell });
+                }),
+              { concurrency: 8 },
+            );
+          });
+
+          const toShellStream = <E, R>(stream: Stream.Stream<ApplicationStoredEvent, E, R>) =>
+            stream.pipe(
+              Stream.groupedWithin(512, Duration.millis(50)),
+              Stream.mapEffect((events) => projectShellItems(Array.from(events))),
+              Stream.flatMap(Stream.fromIterable),
+            );
+
+          const liveFrom = (afterSequence: number) =>
+            toShellStream(applicationEvents.streamApplicationEvents({ afterSequence }));
+
+          const enrichmentRefreshes = Stream.fromSubscription(enrichmentChanges).pipe(
+            Stream.filter((change) => change.repositoryIdentityResolved),
+            Stream.groupedWithin(64, Duration.millis(25)),
+            Stream.mapEffect((changes) =>
+              applicationEvents.latestApplicationSequence.pipe(
+                Effect.flatMap(loadProjectMetadataSnapshot),
+                Effect.map(({ snapshot }) =>
+                  shellStreamItemFromEnrichmentRefresh({
+                    snapshot,
+                    changes: Array.from(changes),
+                  }),
+                ),
               ),
             ),
-            { "rpc.aggregate": "orchestration" },
+          );
+
+          // Always attach the enrichment subscription before the first load so
+          // completions that race HTTP snapshot fetch still push a refresh.
+          // When the client already holds a shell snapshot (cached, or loaded
+          // over HTTP) it passes that snapshot's sequence. We still emit one
+          // compact metadata refresh up front: getAvailable may have been cold on the
+          // HTTP path (null identity), and enrichment PubSub events published
+          // before this subscribe attached are dropped. Rehydrating here fills
+          // repositoryIdentity for cross-environment project grouping even on
+          // afterSequence resumes. Application events after the sequence still
+          // stream as deltas; overlapping events are deduped by sequence on the
+          // client.
+          //
+          // After the unmarked authoritative frame, emit a same-sequence
+          // metadata-only frame for roots that already resolved successfully
+          // (including cached null). Cold/failed roots stay unmarked and use
+          // the PubSub enrichment path when they complete later.
+          const completionMarker =
+            input.requestCompletionMarker === true
+              ? Stream.make({ kind: "synchronized" as const })
+              : Stream.empty;
+          const initialSnapshotItems = (loaded: {
+            readonly snapshot: OrchestrationV2ShellSnapshot;
+            readonly resolvedRepositoryIdentityRoots: ReadonlyArray<string>;
+          }) =>
+            Stream.fromIterable(
+              shellStreamItemsFromInitialSnapshot({
+                snapshot: loaded.snapshot,
+                resolvedRepositoryIdentityRoots: loaded.resolvedRepositoryIdentityRoots,
+              }),
+            );
+          const initialEnrichmentItems = (loaded: {
+            readonly snapshot: OrchestrationV2ShellSnapshot;
+            readonly resolvedRepositoryIdentityRoots: ReadonlyArray<string>;
+          }) =>
+            Stream.fromIterable(
+              shellStreamItemsFromResumeSnapshot({
+                snapshot: loaded.snapshot,
+                resolvedRepositoryIdentityRoots: loaded.resolvedRepositoryIdentityRoots,
+              }),
+            );
+          // Initial unmarked (+ optional same-load marked) always drains first.
+          // Enrichment merges only with the post-prefix tail so a ready marked
+          // refresh cannot interleave before the authoritative initial frame.
+          const completionThenLive = (afterSequence: number) =>
+            Stream.concat(completionMarker, liveFrom(afterSequence));
+
+          const stream = yield* Effect.gen(function* () {
+            if (input.afterSequence === undefined) {
+              const loaded = yield* loadSnapshot();
+              return composeShellStreamWithEnrichment({
+                initial: initialSnapshotItems(loaded),
+                tail: completionThenLive(loaded.snapshot.snapshotSequence),
+                enrichment: enrichmentRefreshes,
+              });
+            }
+
+            const highWater = yield* applicationEvents.latestApplicationSequence;
+            const replayGap = highWater - input.afterSequence;
+            if (replayGap < 0 || replayGap > SHELL_RESUME_MAX_GAP) {
+              const loaded = yield* loadSnapshot();
+              return composeShellStreamWithEnrichment({
+                initial: initialSnapshotItems(loaded),
+                tail: completionThenLive(loaded.snapshot.snapshotSequence),
+                enrichment: enrichmentRefreshes,
+              });
+            }
+
+            const loaded = yield* loadProjectMetadataSnapshot(highWater);
+            const replay = toShellStream(
+              applicationEvents.readApplicationEvents({
+                afterSequence: input.afterSequence,
+                throughSequence: highWater,
+              }),
+            );
+            return composeShellStreamWithEnrichment({
+              initial: initialEnrichmentItems(loaded),
+              tail: Stream.concat(Stream.concat(replay, completionMarker), liveFrom(highWater)),
+              enrichment: enrichmentRefreshes,
+            });
+          }).pipe(
+            Effect.mapError(
+              (cause) =>
+                new OrchestrationV2GetShellSnapshotError({
+                  message: "Failed to prepare the application shell stream",
+                  cause,
+                }),
+            ),
+          );
+
+          return stream.pipe(
+            Stream.mapError(
+              (cause) =>
+                new OrchestrationV2GetShellSnapshotError({
+                  message: "Failed while streaming the application shell",
+                  cause,
+                }),
+            ),
+          );
+        },
+      );
+
+      const getOrchestrationV2ArchivedShellSnapshot = sql
+        .withTransaction(
+          Effect.gen(function* () {
+            const projects = yield* projectionSnapshotQuery.getProjectShellsWithoutEnrichment();
+            const threads = yield* threadManagement.getShellSnapshot({ location: "archive" });
+            return {
+              schemaVersion: threads.schemaVersion,
+              snapshotSequence: yield* applicationEvents.latestApplicationSequence,
+              projects,
+              threads: threads.archivedThreads,
+            } as const;
+          }),
+        )
+        .pipe(
+          Effect.flatMap((snapshot) =>
+            enrichProjectShells(snapshot.projects).pipe(
+              Effect.map(({ projects }) => ({ ...snapshot, projects })),
+            ),
+          ),
+          Effect.mapError(
+            (cause) =>
+              new OrchestrationV2GetShellSnapshotError({
+                message: "Failed to load archived thread snapshot",
+                cause,
+              }),
+          ),
+        );
+
+      const subscribeOrchestrationV2ArchivedShell = Effect.fn(
+        "ws.orchestrationV2.subscribeArchivedShell",
+      )(function* () {
+        const snapshot = yield* getOrchestrationV2ArchivedShellSnapshot;
+        const live = threadManagement
+          .streamStoredEventsFrom({ afterSequence: snapshot.snapshotSequence })
+          .pipe(
+            Stream.groupedWithin(512, Duration.millis(50)),
+            Stream.mapEffect((events) =>
+              Effect.forEach(
+                coalesceStoredThreadEvents(Array.from(events)),
+                (stored) =>
+                  threadManagement
+                    .getThreadShell(stored.event.threadId)
+                    .pipe(
+                      Effect.map((shell) =>
+                        archivedShellStreamItemFromThreadShell({ stored, shell }),
+                      ),
+                    ),
+                { concurrency: 8 },
+              ),
+            ),
+            Stream.flatMap(Stream.fromIterable),
+            Stream.filterMap((item) => (item === null ? Result.failVoid : Result.succeed(item))),
+            Stream.mapError(
+              (cause) =>
+                new OrchestrationV2GetShellSnapshotError({
+                  message: "Failed while streaming archived threads",
+                  cause,
+                }),
+            ),
+          );
+        return Stream.concat(Stream.make({ kind: "snapshot" as const, snapshot }), live);
+      });
+
+      const mutateProject = Effect.fn("ws.projects.mutate")(function* (mutation: ProjectMutation) {
+        switch (mutation.type) {
+          case "project.create":
+            return yield* projectService.create({
+              commandId: mutation.commandId,
+              projectId: mutation.projectId,
+              title: mutation.title,
+              workspaceRoot: mutation.workspaceRoot,
+              ...(mutation.createWorkspaceRootIfMissing === undefined
+                ? {}
+                : { createWorkspaceRootIfMissing: mutation.createWorkspaceRootIfMissing }),
+              ...(mutation.defaultModelSelection === undefined
+                ? {}
+                : { defaultModelSelection: mutation.defaultModelSelection }),
+              ...(mutation.scripts === undefined ? {} : { scripts: mutation.scripts }),
+            });
+          case "project.update":
+            return yield* projectService.update({
+              commandId: mutation.commandId,
+              projectId: mutation.projectId,
+              ...(mutation.title === undefined ? {} : { title: mutation.title }),
+              ...(mutation.workspaceRoot === undefined
+                ? {}
+                : { workspaceRoot: mutation.workspaceRoot }),
+              ...(mutation.defaultModelSelection === undefined
+                ? {}
+                : { defaultModelSelection: mutation.defaultModelSelection }),
+              ...(mutation.scripts === undefined ? {} : { scripts: mutation.scripts }),
+            });
+          case "project.delete": {
+            const snapshot = yield* threadManagement.getShellSnapshot();
+            const projectThreads = [...snapshot.threads, ...snapshot.archivedThreads].filter(
+              (thread) => thread.projectId === mutation.projectId,
+            );
+            if (projectThreads.length > 0 && mutation.force !== true) {
+              return yield* new ProjectMutationError({
+                commandId: mutation.commandId,
+                message: `Project ${mutation.projectId} is not empty.`,
+              });
+            }
+            yield* Effect.forEach(
+              projectThreads,
+              (thread) =>
+                threadManagement.dispatch({
+                  type: "thread.delete",
+                  commandId: CommandId.make(`${mutation.commandId}:delete-thread:${thread.id}`),
+                  threadId: thread.id,
+                }),
+              { concurrency: 1, discard: true },
+            );
+            return yield* projectService.delete({
+              commandId: mutation.commandId,
+              projectId: mutation.projectId,
+            });
+          }
+        }
+      });
+
+      const handlers = ServerWsRpcGroup.of({
+        [ORCHESTRATION_V2_WS_METHODS.dispatchCommand]: (command) =>
+          observeRpcEffect(
+            ORCHESTRATION_V2_WS_METHODS.dispatchCommand,
+            Effect.gen(function* () {
+              // Pending uploads are claimed into the thread's attachment store
+              // at intake; a failed dispatch releases the claimed copies while
+              // the pending upload stays behind as the client's retry source.
+              const claimed =
+                command.type === "message.dispatch" &&
+                command.attachments.some(attachmentIsPendingUpload)
+                  ? yield* claimPendingAttachments({
+                      threadId: command.threadId,
+                      attachments: command.attachments,
+                    })
+                  : null;
+              const effectiveCommand =
+                claimed === null || command.type !== "message.dispatch"
+                  ? command
+                  : { ...command, attachments: claimed.attachments };
+              return yield* startup
+                .enqueueCommand(
+                  threadManagement.dispatch(
+                    ThreadManagementService.withCreationProvenance(effectiveCommand, {
+                      createdBy: "user",
+                      creationSource: "creationSource" in command ? command.creationSource : "web",
+                    }),
+                  ),
+                )
+                .pipe(
+                  Effect.tapError(() =>
+                    claimed === null
+                      ? Effect.void
+                      : releaseClaimedAttachments(claimed.claimedPaths),
+                  ),
+                );
+            }).pipe(
+              Effect.tap(() => recordClientCommandAnalytics(command)),
+              Effect.map((result) => ({ sequence: result.sequence })),
+              Effect.mapError((cause) => {
+                const detail = userFacingDispatchErrorMessage(cause);
+                return new OrchestrationV2DispatchCommandError({
+                  commandId: command.commandId,
+                  commandType: command.type,
+                  message: detail ?? "Failed to dispatch orchestration V2 command",
+                  ...(detail === undefined ? {} : { detail }),
+                  cause,
+                });
+              }),
+            ),
+            {
+              "rpc.aggregate": "orchestrationV2",
+              "orchestration_v2.command_id": command.commandId,
+              "orchestration_v2.command_type": command.type,
+              "orchestration_v2.thread_id":
+                command.type === "thread.fork" || command.type === "thread.merge_back"
+                  ? command.targetThreadId
+                  : command.type === "delegated_task.request" ||
+                      command.type === "delegated_task.wake-policy" ||
+                      command.type === "delegated_task.completion-delivery.acknowledge" ||
+                      command.type === "delegated_task.completion-delivery.dispose" ||
+                      command.type === "thread.created.record"
+                    ? command.parentThreadId
+                    : command.threadId,
+              ...(command.type === "thread.fork" || command.type === "thread.merge_back"
+                ? { "orchestration_v2.source_thread_id": command.sourceThreadId }
+                : {}),
+            },
           ),
-        [ORCHESTRATION_WS_METHODS.getWorkflowScript]: (input) =>
+        [ORCHESTRATION_V2_WS_METHODS.getWorkflowScript]: (input) =>
           observeRpcEffect(
-            ORCHESTRATION_WS_METHODS.getWorkflowScript,
+            ORCHESTRATION_V2_WS_METHODS.getWorkflowScript,
             readWorkflowScript({ scriptPath: input.scriptPath }),
             { "rpc.aggregate": "orchestration" },
           ),
-        [ORCHESTRATION_WS_METHODS.getTurnDiff]: (input) =>
+        [ORCHESTRATION_V2_WS_METHODS.getTurnDiff]: (input) =>
           observeRpcEffect(
-            ORCHESTRATION_WS_METHODS.getTurnDiff,
+            ORCHESTRATION_V2_WS_METHODS.getTurnDiff,
             checkpointDiffQuery.getTurnDiff(input).pipe(
               Effect.mapError(
                 (cause) =>
@@ -1336,9 +1319,9 @@ const makeWsRpcLayer = (
             ),
             { "rpc.aggregate": "orchestration" },
           ),
-        [ORCHESTRATION_WS_METHODS.getFullThreadDiff]: (input) =>
+        [ORCHESTRATION_V2_WS_METHODS.getFullThreadDiff]: (input) =>
           observeRpcEffect(
-            ORCHESTRATION_WS_METHODS.getFullThreadDiff,
+            ORCHESTRATION_V2_WS_METHODS.getFullThreadDiff,
             checkpointDiffQuery.getFullThreadDiff(input).pipe(
               Effect.mapError(
                 (cause) =>
@@ -1350,9 +1333,9 @@ const makeWsRpcLayer = (
             ),
             { "rpc.aggregate": "orchestration" },
           ),
-        [ORCHESTRATION_WS_METHODS.searchThreads]: (input) =>
+        [ORCHESTRATION_V2_WS_METHODS.searchThreads]: (input) =>
           observeRpcEffect(
-            ORCHESTRATION_WS_METHODS.searchThreads,
+            ORCHESTRATION_V2_WS_METHODS.searchThreads,
             projectionSnapshotQuery.searchThreads(input).pipe(
               Effect.mapError(
                 (cause) =>
@@ -1364,259 +1347,188 @@ const makeWsRpcLayer = (
             ),
             { "rpc.aggregate": "orchestration" },
           ),
-        [ORCHESTRATION_WS_METHODS.subscribeShell]: (input) =>
-          observeRpcStreamEffect(
-            ORCHESTRATION_WS_METHODS.subscribeShell,
-            Effect.gen(function* () {
-              // Coalesce the live shell stream per aggregate over a small window
-              // so bursts of high-frequency events (streaming message deltas,
-              // activity appends) collapse into a single shell refetch and never
-              // serialize a brand-new thread's `thread.created` behind hundreds
-              // of per-event DB reads. See coalesceShellStream.
-              // Attach live delivery into a scope-bound buffer BEFORE loading any
-              // snapshot or draining catch-up, otherwise an event published while
-              // the snapshot query is in flight is lost (it is past the snapshot's
-              // sequence but the live subscription is not attached yet). Every
-              // path below emits from this same buffered live tail. Overlapping
-              // events are deduped by sequence on the client.
-              const liveBuffer = yield* Queue.unbounded<ShellLiveInput>();
-              yield* Effect.forkScoped(
-                orchestrationEngine.streamDomainEvents.pipe(
-                  Stream.runForEach((event) =>
-                    Queue.offer(liveBuffer, { kind: "event" as const, event }),
-                  ),
-                ),
-                { startImmediately: true },
-              );
-              const bufferedLiveStream = coalesceShellLiveStream(Stream.fromQueue(liveBuffer));
-
-              const loadSnapshot = projectionSnapshotQuery.getShellSnapshot().pipe(
-                Effect.tapError((cause) =>
-                  Effect.logError("orchestration shell snapshot load failed", { cause }),
-                ),
-                Effect.mapError(
-                  (cause) =>
-                    new OrchestrationGetSnapshotError({
-                      message: "Failed to load orchestration shell snapshot",
-                      cause,
-                    }),
-                ),
-              );
-
-              // Offer the completion marker into the same queue as live events.
-              // Anything buffered while snapshot/replay work was in flight is
-              // therefore delivered before the client is told it is synchronized.
-              const synchronizedThenLive =
-                input.requestCompletionMarker === true
-                  ? Stream.concat(
-                      Stream.fromEffect(
-                        Queue.offer(liveBuffer, { kind: "synchronized" as const }).pipe(
-                          Effect.andThen(Queue.takeAll(liveBuffer)),
-                          Effect.flatMap(coalesceShellLiveInputs),
-                        ),
-                      ).pipe(Stream.flatMap((items) => Stream.fromIterable(items))),
-                      bufferedLiveStream,
-                    )
-                  : bufferedLiveStream;
-
-              // When the client already holds a shell snapshot (cached, or loaded
-              // over HTTP) it passes that snapshot's sequence, and we resume by
-              // replaying shell events after it instead of re-sending the whole
-              // projects/threads list over the socket. If the client is too far
-              // behind, we fall back to a fresh snapshot instead of an unbounded
-              // replay (see below).
-              if (input.afterSequence !== undefined) {
-                const afterSequence = input.afterSequence;
-                const headSequence = yield* orchestrationEngine.latestSequence;
-                const replayGap = headSequence - afterSequence;
-                // Gap too large: replaying every intervening event (each a shell
-                // refetch) is far more expensive than a single O(active-threads)
-                // snapshot. A cursor ahead of this engine's authoritative state
-                // is also invalid, so reset it with a snapshot. Send the snapshot
-                // followed by the buffered live tail, exactly as the
-                // no-afterSequence path does.
-                if (replayGap < 0 || replayGap > SHELL_RESUME_MAX_GAP) {
-                  const snapshot = yield* loadSnapshot;
-                  return Stream.concat(
-                    Stream.make({ kind: "snapshot" as const, snapshot }),
-                    synchronizedThenLive,
-                  );
-                }
-                const catchUpStream = coalesceShellStream(
-                  // Replay only through the head captured above. Newer events
-                  // are already covered by the live subscription, so this bound
-                  // cannot chase a moving event-store head or grow the live
-                  // buffer indefinitely while waiting for an empty page.
-                  orchestrationEngine.readEvents(afterSequence, replayGap),
-                ).pipe(
-                  Stream.mapError(
-                    (cause) =>
-                      new OrchestrationGetSnapshotError({
-                        message: "Failed to replay orchestration shell events",
-                        cause,
-                      }),
-                  ),
-                );
-                return Stream.concat(catchUpStream, synchronizedThenLive);
-              }
-
-              const snapshot = yield* loadSnapshot;
-              return Stream.concat(
-                Stream.make({
-                  kind: "snapshot" as const,
-                  snapshot,
-                }),
-                synchronizedThenLive,
-              );
-            }),
+        [ORCHESTRATION_V2_WS_METHODS.getArchivedShellSnapshot]: (_input) =>
+          observeRpcEffect(
+            ORCHESTRATION_V2_WS_METHODS.getArchivedShellSnapshot,
+            getOrchestrationV2ArchivedShellSnapshot,
             { "rpc.aggregate": "orchestration" },
           ),
-        [ORCHESTRATION_WS_METHODS.getArchivedShellSnapshot]: (_input) =>
+        [ORCHESTRATION_V2_WS_METHODS.getThreadProjection]: (input) =>
           observeRpcEffect(
-            ORCHESTRATION_WS_METHODS.getArchivedShellSnapshot,
-            projectionSnapshotQuery.getArchivedShellSnapshot().pipe(
-              Effect.tapError((cause) =>
-                Effect.logError("orchestration archived shell snapshot load failed", { cause }),
-              ),
+            ORCHESTRATION_V2_WS_METHODS.getThreadProjection,
+            threadManagement.getThreadProjection(input.threadId).pipe(
+              Effect.map(projectThreadProjectionForWire),
               Effect.mapError(
                 (cause) =>
-                  new OrchestrationGetSnapshotError({
-                    message: "Failed to load archived orchestration shell snapshot",
+                  new OrchestrationV2GetThreadProjectionError({
+                    threadId: input.threadId,
+                    message: `Failed to load orchestration V2 thread ${input.threadId}`,
                     cause,
                   }),
               ),
             ),
-            { "rpc.aggregate": "orchestration" },
+            {
+              "rpc.aggregate": "orchestrationV2",
+              "orchestration_v2.thread_id": input.threadId,
+            },
           ),
-        [ORCHESTRATION_WS_METHODS.subscribeThread]: (input) =>
-          observeRpcStreamEffect(
-            ORCHESTRATION_WS_METHODS.subscribeThread,
+        [ORCHESTRATION_V2_WS_METHODS.launchThread]: (input) =>
+          observeRpcEffect(
+            ORCHESTRATION_V2_WS_METHODS.launchThread,
             Effect.gen(function* () {
-              const isThisThreadDetailEvent = (event: OrchestrationEvent) =>
-                event.aggregateKind === "thread" &&
-                event.aggregateId === input.threadId &&
-                isThreadDetailEvent(event);
-
-              const liveStream = orchestrationEngine.streamDomainEvents.pipe(
-                Stream.filter(isThisThreadDetailEvent),
-                Stream.map((event) => ({
-                  kind: "event" as const,
-                  event: projectActivityEvent(event),
-                })),
-              );
-
-              // Attach live delivery before reading either replay or snapshot state.
-              // Otherwise an event published while the snapshot is loading is lost.
-              const liveBuffer = yield* Queue.unbounded<OrchestrationThreadStreamItem>();
-              yield* Effect.forkScoped(
-                liveStream.pipe(Stream.runForEach((item) => Queue.offer(liveBuffer, item))),
-              );
-              const bufferedLiveStream = Stream.fromQueue(liveBuffer);
-
-              // When the client already loaded the snapshot over HTTP it passes
-              // that snapshot's sequence, and we resume the live subscription by
-              // replaying persisted events after it instead of re-sending the
-              // (potentially multi-KB) snapshot frame over the socket.
-              //
-              // The live PubSub subscription must be attached *before* draining
-              // the catch-up replay, otherwise events published during the replay
-              // window are dropped (they are past the persisted tail the replay
-              // read, but the live stream is not yet subscribed). So fork the
-              // live stream into a buffer bound to this stream's scope, then emit
-              // catch-up followed by the buffered/ongoing live events. Overlapping
-              // events are deduped by sequence on the client.
-              //
-              // The replay is bounded to the projection head captured below. The
-              // catch-up range is normally tiny (a fresh HTTP snapshot sequence),
-              // but a stale cached cursor can sit hundreds of thousands of global
-              // events behind — replaying that decodes every intervening event
-              // (including every other thread's tool payloads) only to discard
-              // almost all of them, which has OOM-killed servers on large
-              // databases. A truncated replay would silently drop this thread's
-              // events, so past the gap cap we reset the client with a fresh
-              // thread snapshot instead, exactly like subscribeShell above.
-              if (input.afterSequence !== undefined) {
-                const afterSequence = input.afterSequence;
-                const headSequence = yield* orchestrationEngine.latestSequence;
-                const replayGap = headSequence - afterSequence;
-                if (replayGap >= 0 && replayGap <= THREAD_RESUME_MAX_GAP) {
-                  const catchUpStream = orchestrationEngine
-                    .readEvents(afterSequence, replayGap)
-                    .pipe(
-                      Stream.filter(isThisThreadDetailEvent),
-                      Stream.map((event) => ({
-                        kind: "event" as const,
-                        event: projectActivityEvent(event),
-                      })),
-                      Stream.mapError(
+              const pendingUploads =
+                input.initialMessage?.attachments.some(attachmentIsPendingUpload) ?? false;
+              if (pendingUploads && input.threadId === undefined) {
+                return yield* new OrchestrationV2ThreadLaunchError({
+                  commandId: input.commandId,
+                  projectId: input.projectId,
+                  message: "Uploaded attachments need a thread id at launch.",
+                });
+              }
+              const claimed =
+                pendingUploads && input.threadId !== undefined && input.initialMessage !== undefined
+                  ? yield* claimPendingAttachments({
+                      threadId: input.threadId,
+                      attachments: input.initialMessage.attachments,
+                    }).pipe(
+                      Effect.mapError(
                         (cause) =>
-                          new OrchestrationGetSnapshotError({
-                            message: `Failed to replay thread ${input.threadId} events`,
+                          new OrchestrationV2ThreadLaunchError({
+                            commandId: input.commandId,
+                            projectId: input.projectId,
+                            message: cause.message,
                             cause,
                           }),
                       ),
-                    );
-                  const afterCatchUp =
-                    input.requestCompletionMarker === true
-                      ? Stream.concat(
-                          Stream.fromEffect(
-                            Queue.offer(liveBuffer, { kind: "synchronized" as const }),
-                          ).pipe(Stream.drain),
-                          bufferedLiveStream,
-                        )
-                      : bufferedLiveStream;
-                  return Stream.concat(catchUpStream, afterCatchUp);
-                }
-                // Gap too large (or cursor ahead of authoritative state): fall
-                // through to the snapshot path so the client converges from a
-                // fresh thread detail instead of an unbounded replay.
-              }
-
-              const snapshot = yield* projectionSnapshotQuery
-                .getThreadDetailSnapshot(
-                  input.threadId,
-                  // Windowing the fallback snapshot is opt-in per subscription:
-                  // clients that don't send turnLimit (including all
-                  // pre-pagination clients) get the full thread, since they
-                  // have no way to load older pages.
-                  input.turnLimit === undefined ? undefined : { turnLimit: input.turnLimit },
+                    )
+                  : null;
+              const initialMessage =
+                input.initialMessage === undefined
+                  ? undefined
+                  : claimed === null
+                    ? input.initialMessage
+                    : { ...input.initialMessage, attachments: claimed.attachments };
+              return yield* startup
+                .enqueueCommand(
+                  threadLaunch.launch({
+                    commandId: input.commandId,
+                    ...(input.threadId === undefined ? {} : { threadId: input.threadId }),
+                    ...(input.reuseExistingThread === undefined
+                      ? {}
+                      : { reuseExistingThread: input.reuseExistingThread }),
+                    projectId: input.projectId,
+                    title: input.title,
+                    ...(input.generateTitle === undefined
+                      ? {}
+                      : { generateTitle: input.generateTitle }),
+                    modelSelection: input.modelSelection,
+                    runtimeMode: input.runtimeMode,
+                    interactionMode: input.interactionMode,
+                    workspaceStrategy: input.workspaceStrategy,
+                    ...(initialMessage === undefined
+                      ? {}
+                      : {
+                          initialMessage: {
+                            ...(initialMessage.messageId === undefined
+                              ? {}
+                              : { messageId: initialMessage.messageId }),
+                            text: initialMessage.text,
+                            attachments: initialMessage.attachments,
+                          },
+                        }),
+                    createdBy: "user",
+                    creationSource: input.creationSource ?? "web",
+                  }),
                 )
                 .pipe(
+                  Effect.tapError(() =>
+                    claimed === null
+                      ? Effect.void
+                      : releaseClaimedAttachments(claimed.claimedPaths),
+                  ),
+                  Effect.tap(() =>
+                    analytics
+                      .record("client.thread.started", originProps)
+                      .pipe(
+                        Effect.andThen(
+                          input.initialMessage === undefined
+                            ? Effect.void
+                            : analytics.record("client.turn.requested", originProps),
+                        ),
+                        Effect.ignore,
+                      ),
+                  ),
+                  Effect.map((result) => ({
+                    ...result,
+                    projection: projectThreadProjectionForWire(result.projection),
+                  })),
                   Effect.mapError(
                     (cause) =>
-                      new OrchestrationGetSnapshotError({
-                        message: `Failed to load thread ${input.threadId}`,
+                      new OrchestrationV2ThreadLaunchError({
+                        commandId: input.commandId,
+                        projectId: input.projectId,
+                        message: "Failed to launch thread",
                         cause,
                       }),
                   ),
                 );
-
-              if (Option.isNone(snapshot)) {
-                return yield* new OrchestrationGetSnapshotError({
-                  message: `Thread ${input.threadId} was not found`,
-                  cause: input.threadId,
-                });
-              }
-
-              const afterSnapshot =
-                input.requestCompletionMarker === true
-                  ? Stream.concat(
-                      Stream.fromEffect(
-                        Queue.offer(liveBuffer, { kind: "synchronized" as const }),
-                      ).pipe(Stream.drain),
-                      bufferedLiveStream,
-                    )
-                  : bufferedLiveStream;
-              return Stream.concat(
-                Stream.make({
-                  kind: "snapshot" as const,
-                  snapshot: projectThreadDetailSnapshot(snapshot.value),
-                }),
-                afterSnapshot,
-              );
             }),
+            {
+              "rpc.aggregate": "orchestration",
+              "orchestration_v2.command_id": input.commandId,
+              "orchestration_v2.project_id": input.projectId,
+            },
+          ),
+        [ORCHESTRATION_V2_WS_METHODS.subscribeArchivedShell]: (_input) =>
+          observeRpcStreamEffect(
+            ORCHESTRATION_V2_WS_METHODS.subscribeArchivedShell,
+            subscribeOrchestrationV2ArchivedShell(),
             { "rpc.aggregate": "orchestration" },
           ),
+        [ORCHESTRATION_V2_WS_METHODS.subscribeShell]: (input) =>
+          observeRpcStreamEffect(
+            ORCHESTRATION_V2_WS_METHODS.subscribeShell,
+            subscribeOrchestrationV2Shell(input),
+            {
+              "rpc.aggregate": "orchestrationV2",
+            },
+          ),
+        [ORCHESTRATION_V2_WS_METHODS.subscribeThread]: (input) =>
+          observeRpcStreamEffect(
+            ORCHESTRATION_V2_WS_METHODS.subscribeThread,
+            subscribeOrchestrationV2Thread(input),
+            {
+              "rpc.aggregate": "orchestrationV2",
+              "orchestration_v2.thread_id": input.threadId,
+            },
+          ),
+        [WS_METHODS.scheduledTasksList]: (_input) =>
+          observeRpcEffect(WS_METHODS.scheduledTasksList, scheduledTasks.list(), {
+            "rpc.aggregate": "scheduledTasks",
+          }),
+        [WS_METHODS.scheduledTasksSubscribe]: (_input) =>
+          observeRpcStream(WS_METHODS.scheduledTasksSubscribe, scheduledTasks.subscribeList(), {
+            "rpc.aggregate": "scheduledTasks",
+          }),
+        [WS_METHODS.scheduledTasksUpsert]: (input) =>
+          observeRpcEffect(WS_METHODS.scheduledTasksUpsert, scheduledTasks.upsert(input), {
+            "rpc.aggregate": "scheduledTasks",
+          }),
+        [WS_METHODS.scheduledTasksSetEnabled]: (input) =>
+          observeRpcEffect(WS_METHODS.scheduledTasksSetEnabled, scheduledTasks.setEnabled(input), {
+            "rpc.aggregate": "scheduledTasks",
+            "scheduled_task.id": input.id,
+          }),
+        [WS_METHODS.scheduledTasksDelete]: (input) =>
+          observeRpcEffect(WS_METHODS.scheduledTasksDelete, scheduledTasks.delete(input), {
+            "rpc.aggregate": "scheduledTasks",
+            "scheduled_task.id": input.id,
+          }),
+        [WS_METHODS.scheduledTasksRunNow]: (input) =>
+          observeRpcEffect(WS_METHODS.scheduledTasksRunNow, scheduledTasks.runNow(input), {
+            "rpc.aggregate": "scheduledTasks",
+            "scheduled_task.id": input.id,
+          }),
         [WS_METHODS.serverProbe]: (_input) =>
           observeRpcEffect(WS_METHODS.serverProbe, Effect.succeed({}), {
             "rpc.aggregate": "server",
@@ -1637,13 +1549,50 @@ const makeWsRpcLayer = (
         [WS_METHODS.providerUploadFeedback]: (input) =>
           observeRpcEffect(
             WS_METHODS.providerUploadFeedback,
-            providerService.uploadFeedback(input).pipe(
-              Effect.mapError(
-                (cause) =>
+            Effect.gen(function* () {
+              const projection = yield* threadManagement.getThreadProjection(input.threadId);
+              const providerThread =
+                projection.providerThreads.find(
+                  (candidate) => candidate.id === projection.thread.activeProviderThreadId,
+                ) ?? projection.providerThreads.at(-1);
+              const providerSessionId = providerThread?.providerSessionId ?? null;
+              if (providerThread === undefined || providerSessionId === null) {
+                return yield* Effect.fail(
                   new ProviderUploadFeedbackError({
                     threadId: input.threadId,
-                    cause,
+                    cause: "No provider session has run in this thread yet.",
+                  }),
+                );
+              }
+              const runtime = Option.getOrNull(yield* providerSessionsV2.get(providerSessionId));
+              if (runtime === null) {
+                return yield* Effect.fail(
+                  new ProviderUploadFeedbackError({
+                    threadId: input.threadId,
+                    cause: "The provider session is no longer running. Send a message first.",
+                  }),
+                );
+              }
+              if (runtime.uploadFeedback === undefined) {
+                return yield* Effect.fail(
+                  new ProviderUploadFeedbackError({
+                    threadId: input.threadId,
+                    cause: `Provider '${runtime.driver}' does not support feedback uploads.`,
                   }),
+                );
+              }
+              return yield* runtime.uploadFeedback({
+                providerThread,
+                ...(input.reason === undefined ? {} : { reason: input.reason }),
+              });
+            }).pipe(
+              Effect.mapError((cause) =>
+                Schema.is(ProviderUploadFeedbackError)(cause)
+                  ? cause
+                  : new ProviderUploadFeedbackError({
+                      threadId: input.threadId,
+                      cause,
+                    }),
               ),
             ),
             { "rpc.aggregate": "provider" },
@@ -2029,6 +1978,22 @@ const makeWsRpcLayer = (
             ),
             { "rpc.aggregate": "workspace" },
           ),
+        [WS_METHODS.projectsMutate]: (mutation) =>
+          observeRpcEffect(
+            WS_METHODS.projectsMutate,
+            startup.enqueueCommand(mutateProject(mutation)).pipe(
+              Effect.mapError((cause) =>
+                cause._tag === "ProjectMutationError"
+                  ? cause
+                  : new ProjectMutationError({
+                      commandId: mutation.commandId,
+                      message: "Failed to mutate project.",
+                      cause,
+                    }),
+              ),
+            ),
+            { "rpc.aggregate": "orchestration" },
+          ),
         [WS_METHODS.shellOpenInEditor]: (input) =>
           observeRpcEffect(WS_METHODS.shellOpenInEditor, externalLauncher.launchEditor(input), {
             "rpc.aggregate": "workspace",
@@ -2089,24 +2054,8 @@ const makeWsRpcLayer = (
                     : {}),
                 });
               }
-              const thread = yield* projectionSnapshotQuery
-                .getThreadShellById(input.resource.threadId)
-                .pipe(
-                  Effect.mapError(
-                    (cause) =>
-                      new AssetWorkspaceContextResolutionError({
-                        resource: input.resource,
-                        cause,
-                      }),
-                  ),
-                );
-              if (Option.isNone(thread)) {
-                return yield* new AssetWorkspaceContextNotFoundError({
-                  resource: input.resource,
-                });
-              }
-              const project = yield* projectionSnapshotQuery
-                .getProjectShellById(thread.value.projectId)
+              const thread = yield* threadManagement
+                .getThreadProjection(input.resource.threadId)
                 .pipe(
                   Effect.mapError(
                     (cause) =>
@@ -2116,6 +2065,15 @@ const makeWsRpcLayer = (
                       }),
                   ),
                 );
+              const project = yield* projectService.getById(thread.thread.projectId).pipe(
+                Effect.mapError(
+                  (cause) =>
+                    new AssetWorkspaceContextResolutionError({
+                      resource: input.resource,
+                      cause,
+                    }),
+                ),
+              );
               if (Option.isNone(project)) {
                 return yield* new AssetWorkspaceContextNotFoundError({
                   resource: input.resource,
@@ -2123,11 +2081,17 @@ const makeWsRpcLayer = (
               }
               return yield* issueAssetUrl({
                 resource: input.resource,
-                workspaceRoot: thread.value.worktreePath ?? project.value.workspaceRoot,
+                workspaceRoot: thread.thread.worktreePath ?? project.value.workspaceRoot,
               });
             }),
             { "rpc.aggregate": "workspace" },
           ),
+        [WS_METHODS.assetsPersistChatAttachments]: (input) =>
+          observeRpcEffect(
+            WS_METHODS.assetsPersistChatAttachments,
+            persistChatAttachments(input).pipe(Effect.map((attachments) => ({ attachments }))),
+            { "rpc.aggregate": "orchestration" },
+          ),
         [WS_METHODS.subscribeVcsStatus]: (input) =>
           observeRpcStream(
             WS_METHODS.subscribeVcsStatus,
@@ -2519,6 +2483,7 @@ const makeWsRpcLayer = (
             { "rpc.aggregate": "server" },
           ),
       });
+      return handlers;
     }),
   );
 
@@ -2532,6 +2497,17 @@ export const websocketRpcRouteLayer = Layer.unwrap(
       "/ws",
       Effect.gen(function* () {
         const request = yield* HttpServerRequest.HttpServerRequest;
+        const requestUrl = HttpServerRequest.toURL(request);
+        if (Option.isNone(requestUrl) || !hasCompatibleOrchestrationProtocol(requestUrl.value)) {
+          return HttpServerResponse.jsonUnsafe(
+            {
+              code: "orchestration_protocol_incompatible",
+              message: `Update this client to one that supports orchestration protocol ${ORCHESTRATION_PROTOCOL_VERSION}.`,
+              orchestrationProtocolVersion: ORCHESTRATION_PROTOCOL_VERSION,
+            },
+            { status: 426 },
+          );
+        }
         const serverAuth = yield* EnvironmentAuth.EnvironmentAuth;
         const sessions = yield* SessionStore.SessionStore;
         const analytics = yield* AnalyticsService.AnalyticsService;
@@ -2550,7 +2526,7 @@ export const websocketRpcRouteLayer = Layer.unwrap(
         const clientAnalyticsProps = readClientAnalyticsProps(request);
         yield* sessions.recordClientConnection(session.sessionId, clientOrigin);
         yield* analytics.record("client.connected", clientAnalyticsProps);
-        const rpcWebSocketHttpEffect = yield* RpcServer.toHttpEffectWebsocket(WsRpcGroup, {
+        const rpcWebSocketHttpEffect = yield* RpcServer.toHttpEffectWebsocket(ServerWsRpcGroup, {
           disableTracing: true,
         }).pipe(
           Effect.provide(
diff --git a/apps/server/test/ActivityPayloadProjection.test.ts b/apps/server/test/ActivityPayloadProjection.test.ts
deleted file mode 100644
index 7ac564bb41f3..000000000000
--- a/apps/server/test/ActivityPayloadProjection.test.ts
+++ /dev/null
@@ -1,544 +0,0 @@
-import {
-  EventId,
-  ProjectId,
-  ProviderInstanceId,
-  ThreadId,
-  TurnId,
-  type OrchestrationEvent,
-  type OrchestrationThread,
-  type OrchestrationThreadActivity,
-} from "@t3tools/contracts";
-import { describe, expect, it } from "vite-plus/test";
-
-import { buildThreadFeed, type ThreadFeedActivity } from "../../mobile/src/lib/threadActivity.ts";
-import { deriveLatestContextWindowSnapshot } from "../../web/src/lib/contextWindow.ts";
-import { deriveWorkLogEntries } from "../../web/src/session-logic.ts";
-import {
-  projectActivityEvent,
-  projectActivityPayload,
-  projectThreadDetailSnapshot,
-} from "../src/orchestration/ActivityPayloadProjection.ts";
-
-function makeActivity(
-  id: string,
-  itemType: string,
-  data: Record<string, unknown>,
-): OrchestrationThreadActivity {
-  return {
-    id: EventId.make(id),
-    tone: "tool",
-    kind: "tool.completed",
-    summary: `Completed ${itemType}`,
-    payload: {
-      itemType,
-      title: itemType,
-      detail: `${itemType} detail`,
-      status: "completed",
-      requestKind: "command",
-      data,
-    },
-    turnId: TurnId.make(`turn-${id}`),
-    createdAt: "2026-07-27T00:00:00.000Z",
-  };
-}
-
-function makeThread(activities: ReadonlyArray<OrchestrationThreadActivity>): OrchestrationThread {
-  return {
-    id: ThreadId.make("thread-projection"),
-    projectId: ProjectId.make("project-projection"),
-    title: "Activity projection",
-    modelSelection: {
-      instanceId: ProviderInstanceId.make("codex"),
-      model: "gpt-5.4",
-    },
-    runtimeMode: "full-access",
-    interactionMode: "default",
-    branch: null,
-    worktreePath: null,
-    latestTurn: null,
-    createdAt: "2026-07-27T00:00:00.000Z",
-    updatedAt: "2026-07-27T00:00:00.000Z",
-    archivedAt: null,
-    settledOverride: null,
-    settledAt: null,
-    deletedAt: null,
-    messages: [],
-    proposedPlans: [],
-    activities,
-    checkpoints: [],
-    session: null,
-  };
-}
-
-const fixtures = [
-  makeActivity("command", "command_execution", {
-    item: {
-      command: ["bash", "-lc", "pnpm test"],
-      input: { command: "fallback input", ignored: "input bulk" },
-      result: { command: "fallback result", aggregatedOutput: "x".repeat(10_000) },
-      commandActions: [{ type: "unknown", output: "y".repeat(5_000) }],
-    },
-    command: "fallback data",
-    kind: "execute",
-    toolCallId: "tool-command",
-    rawOutput: {
-      content: "\n```\nfirst useful line\nsecond line",
-      stdout: "unused stdout",
-      ignored: "raw bulk",
-    },
-    ignored: "top-level bulk",
-  }),
-  makeActivity("file-change", "file_change", {
-    item: {
-      changes: [
-        { oldPath: "src/old.ts", newPath: "src/new.ts", patch: "large patch".repeat(1_000) },
-        { filePath: "src/second.ts" },
-      ],
-    },
-    ignored: "top-level bulk",
-  }),
-  makeActivity("dynamic", "dynamic_tool_call", {
-    toolCallId: "tool-dynamic",
-    rawOutput: {
-      stdout: "dynamic summary\nlong output".repeat(1_000),
-    },
-    ignored: "top-level bulk",
-  }),
-  makeActivity("collab", "collab_agent_tool_call", {
-    kind: "delegate",
-    rawOutput: {
-      content: "``` \n```",
-      stdout: "must not be used when content is present",
-    },
-    ignored: "top-level bulk",
-  }),
-  makeActivity("mcp", "mcp_tool_call", {
-    item: {
-      server: "repository",
-      tool: "search",
-      arguments: { query: "activity projection" },
-      aggregatedOutput: "mcp bulk is dropped",
-    },
-    ignored: "top-level bulk",
-  }),
-  makeActivity("search", "web_search", {
-    rawOutput: {
-      totalFiles: 42,
-      truncated: true,
-      content: "ignored because totalFiles wins",
-    },
-    ignored: "top-level bulk",
-  }),
-  makeActivity("image", "image_view", {
-    ignored: "top-level bulk",
-  }),
-] satisfies ReadonlyArray<OrchestrationThreadActivity>;
-
-describe("projectActivityPayload", () => {
-  function comparableActivity(activity: ThreadFeedActivity) {
-    return {
-      ...activity,
-      fullDetail: activity.getFullDetail(),
-      copyText: activity.getCopyText(),
-      getFullDetail: undefined,
-      getCopyText: undefined,
-    };
-  }
-
-  function comparableThreadFeed(activities: ReadonlyArray<OrchestrationThreadActivity>) {
-    return buildThreadFeed(makeThread(activities)).map((entry) =>
-      entry.type === "activity-group"
-        ? {
-            ...entry,
-            activities: entry.activities.map(comparableActivity),
-          }
-        : entry,
-    );
-  }
-
-  it("drops unread bulk while retaining command, file, tool, and summary inputs", () => {
-    const projected = projectActivityPayload(fixtures[0]!);
-    expect(projected.payload).toEqual({
-      itemType: "command_execution",
-      title: "command_execution",
-      detail: "command_execution detail",
-      status: "completed",
-      requestKind: "command",
-      data: {
-        item: {
-          command: ["bash", "-lc", "pnpm test"],
-          input: { command: "fallback input" },
-          result: { command: "fallback result" },
-        },
-        command: "fallback data",
-        toolCallId: "tool-command",
-        kind: "execute",
-        rawOutput: { content: "first useful line" },
-      },
-    });
-
-    expect(projectActivityPayload(fixtures[1]!).payload).toMatchObject({
-      data: {
-        files: [{ path: "src/new.ts" }, { path: "src/old.ts" }, { path: "src/second.ts" }],
-      },
-    });
-  });
-
-  it("slims MCP tool data to the fields the expanded row renders", () => {
-    expect(projectActivityPayload(fixtures[4]!).payload).toEqual({
-      itemType: "mcp_tool_call",
-      title: "mcp_tool_call",
-      detail: "mcp_tool_call detail",
-      status: "completed",
-      requestKind: "command",
-      data: {
-        item: {
-          server: "repository",
-          tool: "search",
-          arguments: { query: "activity projection" },
-        },
-      },
-    });
-  });
-
-  it("keeps current web and mobile derived output identical for every tool item type", () => {
-    for (const activity of fixtures) {
-      const projected = projectActivityPayload(activity);
-      if (activity === fixtures[4]) {
-        // MCP is the one deliberate difference: the expanded row's toolData
-        // loses result bulk but keeps the rendered identity fields.
-        const [entry] = deriveWorkLogEntries([projected]);
-        expect(entry?.toolData).toEqual({
-          server: "repository",
-          tool: "search",
-          arguments: { query: "activity projection" },
-        });
-        continue;
-      }
-      expect(deriveWorkLogEntries([projected])).toEqual(deriveWorkLogEntries([activity]));
-      expect(comparableThreadFeed([projected])).toEqual(comparableThreadFeed([activity]));
-    }
-  });
-
-  it("preserves failed stored tool outcomes for web and mobile clients", () => {
-    const activities = [
-      makeActivity("failed-command", "command_execution", {
-        item: {
-          command: "vp test run",
-          exitCode: 1,
-          status: "failed",
-        },
-      }),
-      makeActivity("failed-mcp", "mcp_tool_call", {
-        item: {
-          server: "simulator",
-          tool: "build",
-          arguments: {},
-          status: "failed",
-        },
-      }),
-    ];
-
-    for (const activity of activities) {
-      const projected = projectActivityPayload(activity);
-      expect(projected.payload).toMatchObject({ status: "failed" });
-
-      const [webEntry] = deriveWorkLogEntries([projected]);
-      expect(webEntry?.toolLifecycleStatus).toBe("failed");
-
-      const [mobileGroup] = buildThreadFeed(makeThread([projected]));
-      expect(mobileGroup).toMatchObject({ type: "activity-group" });
-      if (mobileGroup?.type === "activity-group") {
-        expect(mobileGroup.activities[0]?.status).toBe("failure");
-      }
-    }
-  });
-
-  it("projects snapshot and event transports without mutating their sources", () => {
-    const activity = fixtures[0]!;
-    const thread = makeThread([activity]);
-    const snapshot = { snapshotSequence: 7, thread };
-    const projectedSnapshot = projectThreadDetailSnapshot(snapshot);
-
-    expect(projectedSnapshot.thread.activities[0]).not.toBe(activity);
-    expect(snapshot.thread.activities[0]).toBe(activity);
-
-    const event = {
-      sequence: 8,
-      eventId: EventId.make("event-activity"),
-      aggregateKind: "thread",
-      aggregateId: thread.id,
-      occurredAt: "2026-07-27T00:00:01.000Z",
-      commandId: null,
-      causationEventId: null,
-      correlationId: null,
-      metadata: {},
-      type: "thread.activity-appended",
-      payload: {
-        threadId: thread.id,
-        activity,
-      },
-    } satisfies Extract<OrchestrationEvent, { type: "thread.activity-appended" }>;
-
-    const projectedEvent = projectActivityEvent(event);
-    expect(projectedEvent).not.toBe(event);
-    expect(
-      projectedEvent.type === "thread.activity-appended"
-        ? projectedEvent.payload.activity
-        : undefined,
-    ).toEqual(projectActivityPayload(activity));
-    expect(event.payload.activity).toBe(activity);
-  });
-});
-
-describe("superseded tool.updated snapshot dedup", () => {
-  function makeToolLifecycleActivity(
-    id: string,
-    kind: "tool.updated" | "tool.completed",
-    options: {
-      readonly turn?: string;
-      readonly title?: string;
-      readonly detail?: string;
-      readonly toolCallId?: string;
-    } = {},
-  ): OrchestrationThreadActivity {
-    const { turn = "turn-a", title = "File change", detail, toolCallId } = options;
-    return {
-      id: EventId.make(id),
-      tone: "tool",
-      kind,
-      summary: title,
-      payload: {
-        itemType: "file_change",
-        title,
-        ...(detail ? { detail } : {}),
-        data: {
-          ...(toolCallId ? { toolCallId } : {}),
-          toolName: "Edit",
-          input: { file_path: "src/app.ts" },
-        },
-      },
-      turnId: TurnId.make(turn),
-      createdAt: "2026-07-27T00:00:00.000Z",
-    };
-  }
-
-  function projectedIds(activities: ReadonlyArray<OrchestrationThreadActivity>) {
-    return projectThreadDetailSnapshot({
-      snapshotSequence: 7,
-      thread: makeThread(activities),
-    }).thread.activities.map((activity) => activity.id);
-  }
-
-  it("drops updates a later completion supersedes in the same turn", () => {
-    const update1 = makeToolLifecycleActivity("upd-1", "tool.updated");
-    const update2 = makeToolLifecycleActivity("upd-2", "tool.updated");
-    const completed = makeToolLifecycleActivity("done-1", "tool.completed");
-
-    expect(projectedIds([update1, update2, completed])).toEqual([completed.id]);
-  });
-
-  it("matches on toolCallId when the adapter emits one", () => {
-    const otherCall = makeToolLifecycleActivity("upd-other", "tool.updated", {
-      toolCallId: "call-b",
-    });
-    const update = makeToolLifecycleActivity("upd-a", "tool.updated", { toolCallId: "call-a" });
-    const completed = makeToolLifecycleActivity("done-a", "tool.completed", {
-      toolCallId: "call-a",
-    });
-
-    // Same itemType/title, different call: only call-a's update is superseded.
-    expect(projectedIds([otherCall, update, completed])).toEqual([otherCall.id, completed.id]);
-  });
-
-  it("keeps updates with no matching completion", () => {
-    const inFlight = makeToolLifecycleActivity("upd-live", "tool.updated", { title: "Running" });
-    const other = makeToolLifecycleActivity("upd-other", "tool.updated", { title: "Reading" });
-    const completed = makeToolLifecycleActivity("done-other", "tool.completed", {
-      title: "Reading",
-    });
-
-    expect(projectedIds([inFlight, other, completed])).toEqual([inFlight.id, completed.id]);
-  });
-
-  it("drops interleaved superseded updates even when a parallel call separates them", () => {
-    // Deliberate divergence from the clients' adjacency-based collapse: a
-    // superseded update separated from its completion by an interleaved
-    // parallel call renders as its own in-flight row on full history, and the
-    // snapshot omits it. Its final state still shows via the retained
-    // completion (1.5% of dropped rows on real data; see the projection's doc
-    // comment).
-    const updateA = makeToolLifecycleActivity("upd-a", "tool.updated", { toolCallId: "call-a" });
-    const updateB = makeToolLifecycleActivity("upd-b", "tool.updated", { toolCallId: "call-b" });
-    const completedA = makeToolLifecycleActivity("done-a", "tool.completed", {
-      toolCallId: "call-a",
-    });
-    const completedB = makeToolLifecycleActivity("done-b", "tool.completed", {
-      toolCallId: "call-b",
-    });
-
-    expect(projectedIds([updateA, updateB, completedA, completedB])).toEqual([
-      completedA.id,
-      completedB.id,
-    ]);
-  });
-
-  it("keeps an update whose completion lives in another turn", () => {
-    // A live thread.reverted can discard the completing turn while keeping
-    // the updating one, which would leave the call unrepresented.
-    const update = makeToolLifecycleActivity("upd-kept", "tool.updated", { turn: "turn-kept" });
-    const completed = makeToolLifecycleActivity("done-later", "tool.completed", {
-      turn: "turn-reverted",
-    });
-
-    expect(projectedIds([update, completed])).toEqual([update.id, completed.id]);
-  });
-
-  it("keeps an update that follows its completion", () => {
-    // A later update under the same identity is the next call, still in flight.
-    const completed = makeToolLifecycleActivity("done-first", "tool.completed");
-    const nextCall = makeToolLifecycleActivity("upd-next", "tool.updated");
-
-    expect(projectedIds([completed, nextCall])).toEqual([completed.id, nextCall.id]);
-  });
-
-  it("keeps identity-less rows the clients never collapse", () => {
-    const anonymous: OrchestrationThreadActivity = {
-      id: EventId.make("upd-anon"),
-      tone: "tool",
-      kind: "tool.updated",
-      summary: " ",
-      payload: { data: { toolName: "Edit" } },
-      turnId: TurnId.make("turn-a"),
-      createdAt: "2026-07-27T00:00:00.000Z",
-    };
-    const completed: OrchestrationThreadActivity = {
-      ...anonymous,
-      id: EventId.make("done-anon"),
-      kind: "tool.completed",
-    };
-
-    expect(projectedIds([anonymous, completed])).toEqual([anonymous.id, completed.id]);
-  });
-
-  it("leaves the collapsed work log identical to the full history", () => {
-    const activities = [
-      makeToolLifecycleActivity("upd-1", "tool.updated", { detail: "writing" }),
-      makeToolLifecycleActivity("upd-2", "tool.updated", { detail: "writing" }),
-      makeToolLifecycleActivity("done-1", "tool.completed", { detail: "writing" }),
-    ];
-    const projected = projectThreadDetailSnapshot({
-      snapshotSequence: 7,
-      thread: makeThread(activities),
-    });
-
-    const before = deriveWorkLogEntries(activities);
-    const after = deriveWorkLogEntries(projected.thread.activities);
-    expect(after).toHaveLength(before.length);
-    expect(after.map((entry) => entry.label)).toEqual(before.map((entry) => entry.label));
-  });
-});
-
-describe("context-window snapshot dedup", () => {
-  function makeContextWindowActivity(
-    id: string,
-    usedTokens: number,
-    turn = `turn-${id}`,
-  ): OrchestrationThreadActivity {
-    return {
-      id: EventId.make(id),
-      tone: "info",
-      kind: "context-window.updated",
-      summary: "Context window updated",
-      payload: { usedTokens, maxTokens: 200_000 },
-      turnId: TurnId.make(turn),
-      createdAt: "2026-07-27T00:00:00.000Z",
-    };
-  }
-
-  it("keeps only the latest context-window activity per turn in snapshots", () => {
-    const stale1 = makeContextWindowActivity("ctx-1", 1_000, "turn-a");
-    const latestA = makeContextWindowActivity("ctx-2", 2_000, "turn-a");
-    const latestB = makeContextWindowActivity("ctx-3", 3_000, "turn-b");
-    const tool = fixtures[0]!;
-
-    const projected = projectThreadDetailSnapshot({
-      snapshotSequence: 7,
-      thread: makeThread([stale1, tool, latestA, latestB]),
-    });
-
-    expect(projected.thread.activities.map((activity) => activity.id)).toEqual([
-      tool.id,
-      latestA.id,
-      latestB.id,
-    ]);
-    // The retained rows keep their payloads untouched — the tool-data
-    // projection only rewrites payloads with a `data` record.
-    expect(projected.thread.activities[2]?.payload).toEqual(latestB.payload);
-  });
-
-  it("still resolves a meter value after the client reverts the newest turn", () => {
-    // A live thread.reverted makes the client drop all activities from
-    // discarded turns; each surviving turn must keep a usable row.
-    const olderTurn = makeContextWindowActivity("ctx-old", 1_500, "turn-kept");
-    const revertedTurn = makeContextWindowActivity("ctx-new", 9_000, "turn-reverted");
-
-    const projected = projectThreadDetailSnapshot({
-      snapshotSequence: 7,
-      thread: makeThread([olderTurn, revertedTurn]),
-    });
-    const afterRevert = projected.thread.activities.filter(
-      (activity) => activity.turnId === TurnId.make("turn-kept"),
-    );
-
-    expect(deriveLatestContextWindowSnapshot(afterRevert)).toEqual(
-      deriveLatestContextWindowSnapshot([olderTurn]),
-    );
-  });
-
-  it("matches what the web client derives from the full history", () => {
-    const activities = [
-      makeContextWindowActivity("ctx-1", 1_000),
-      makeContextWindowActivity("ctx-2", 2_000),
-    ];
-    const projected = projectThreadDetailSnapshot({
-      snapshotSequence: 7,
-      thread: makeThread(activities),
-    });
-
-    expect(deriveLatestContextWindowSnapshot(projected.thread.activities)).toEqual(
-      deriveLatestContextWindowSnapshot(activities),
-    );
-  });
-
-  it("does not let a malformed row shadow an earlier valid row in the same turn", () => {
-    const valid = makeContextWindowActivity("ctx-valid", 5_000, "turn-a");
-    const malformed: OrchestrationThreadActivity = {
-      ...makeContextWindowActivity("ctx-broken", 0, "turn-a"),
-      payload: { usedTokens: null },
-    };
-
-    const projected = projectThreadDetailSnapshot({
-      snapshotSequence: 7,
-      thread: makeThread([valid, malformed]),
-    });
-
-    // The malformed row passes through, the valid row survives, and the
-    // client's backward walk resolves the same value as with full history.
-    expect(projected.thread.activities.map((activity) => activity.id)).toEqual([
-      valid.id,
-      malformed.id,
-    ]);
-    expect(deriveLatestContextWindowSnapshot(projected.thread.activities)).toEqual(
-      deriveLatestContextWindowSnapshot([valid, malformed]),
-    );
-  });
-
-  it("applies only payload slimming when there are no context-window activities", () => {
-    const projected = projectThreadDetailSnapshot({
-      snapshotSequence: 7,
-      thread: makeThread([fixtures[4]!]),
-    });
-    expect(projected.thread.activities).toEqual([projectActivityPayload(fixtures[4]!)]);
-  });
-});
diff --git a/apps/web/src/components/AppSidebarLayout.tsx b/apps/web/src/components/AppSidebarLayout.tsx
index a3ba76679689..365f4de512f6 100644
--- a/apps/web/src/components/AppSidebarLayout.tsx
+++ b/apps/web/src/components/AppSidebarLayout.tsx
@@ -16,6 +16,7 @@ import { cn, isMacPlatform } from "../lib/utils";
 import { primaryServerKeybindingsAtom } from "../state/server";
 import { useEnvironmentIdentificationMode, useLegacySidebarEnabled } from "../hooks/useSettings";
 import LegacyThreadSidebar from "./LegacySidebar";
+import { useThreadVisitedMigration } from "../hooks/useThreadVisitedMigration";
 import ThreadSidebar from "./Sidebar";
 import { SettingsSidebarNav } from "./settings/SettingsSidebarNav";
 import { SidebarChromeHeader } from "./sidebar/SidebarChrome";
@@ -141,6 +142,8 @@ export function AppSidebarLayout({ children }: { children: ReactNode }) {
   const legacySidebarEnabled = useLegacySidebarEnabled();
   // Settings routes show the settings nav in place of whichever thread
   // sidebar is active.
+  // Seeds server-side visited tracking from this browser's localStorage the
+  useThreadVisitedMigration();
   const pathname = useLocation({ select: (location) => location.pathname });
   const isOnSettings = pathname === "/settings" || pathname.startsWith("/settings/");
   const isMacosDesktop = isElectron && isMacPlatform(navigator.platform);
diff --git a/apps/web/src/components/BranchToolbar.logic.test.ts b/apps/web/src/components/BranchToolbar.logic.test.ts
index 251b07688121..dba1bca1d265 100644
--- a/apps/web/src/components/BranchToolbar.logic.test.ts
+++ b/apps/web/src/components/BranchToolbar.logic.test.ts
@@ -13,6 +13,7 @@ import {
   resolveBranchToolbarPrBranch,
   resolveBranchToolbarValue,
   resolveLockedWorkspaceLabel,
+  resolveWorkspaceDisplayName,
   resolveLocalCheckoutBranchMismatch,
   resolvePreviousWorktreeLabel,
   resolvePreviousWorktreeSeed,
@@ -504,6 +505,18 @@ describe("resolveLockedWorkspaceLabel", () => {
   });
 });
 
+describe("resolveWorkspaceDisplayName", () => {
+  it("returns the final folder for POSIX and Windows paths", () => {
+    expect(resolveWorkspaceDisplayName("/repo/.t3/worktrees/feature-a")).toBe("feature-a");
+    expect(resolveWorkspaceDisplayName("C:\\code\\project\\feature-b\\")).toBe("feature-b");
+  });
+
+  it("handles missing and root paths", () => {
+    expect(resolveWorkspaceDisplayName(null)).toBeNull();
+    expect(resolveWorkspaceDisplayName("/")).toBe("/");
+  });
+});
+
 describe("deriveLocalBranchNameFromRemoteRef", () => {
   it("strips the remote prefix from a remote ref", () => {
     expect(deriveLocalBranchNameFromRemoteRef("origin/feature/demo")).toBe("feature/demo");
diff --git a/apps/web/src/components/BranchToolbar.logic.ts b/apps/web/src/components/BranchToolbar.logic.ts
index 0a8e07d1958b..092f95e3dfd5 100644
--- a/apps/web/src/components/BranchToolbar.logic.ts
+++ b/apps/web/src/components/BranchToolbar.logic.ts
@@ -74,6 +74,13 @@ export function resolveLockedWorkspaceLabel(activeWorktreePath: string | null):
   return activeWorktreePath ? "Worktree" : "Local checkout";
 }
 
+export function resolveWorkspaceDisplayName(path: string | null): string | null {
+  if (!path) return null;
+  const normalizedPath = path.replace(/[\\/]+$/, "");
+  if (normalizedPath.length === 0) return path;
+  return normalizedPath.split(/[\\/]/).at(-1) ?? normalizedPath;
+}
+
 export interface PreviousWorktreeSeed {
   branch: string | null;
   worktreePath: string;
diff --git a/apps/web/src/components/BranchToolbar.tsx b/apps/web/src/components/BranchToolbar.tsx
index 8a4dc5819923..512d5683a91d 100644
--- a/apps/web/src/components/BranchToolbar.tsx
+++ b/apps/web/src/components/BranchToolbar.tsx
@@ -12,7 +12,7 @@ import {
 import { memo, useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from "react";
 
 import { useComposerDraftStore, type DraftId } from "../composerDraftStore";
-import { useProject, useThread, useThreadShellsForProjectRefs } from "../state/entities";
+import { useProject, useThreadShell, useThreadShellsForProjectRefs } from "../state/entities";
 import { useIsMobile } from "../hooks/useMediaQuery";
 import {
   type EnvMode,
@@ -43,6 +43,8 @@ import { Separator } from "./ui/separator";
 import { ComposerSurface } from "./chat/ComposerSurface";
 
 interface BranchToolbarProps {
+  layout?: "composer" | "panel";
+  panelSection?: "all" | "workspace" | "branch";
   environmentId: EnvironmentId;
   threadId: ThreadId;
   showGitControls: boolean;
@@ -375,6 +377,8 @@ function useLabelsOverflow(element: HTMLDivElement | null): boolean {
 }
 
 export const BranchToolbar = memo(function BranchToolbar({
+  layout = "composer",
+  panelSection = "all",
   environmentId,
   threadId,
   showGitControls,
@@ -395,10 +399,10 @@ export const BranchToolbar = memo(function BranchToolbar({
     () => scopeThreadRef(environmentId, threadId),
     [environmentId, threadId],
   );
+  const serverThread = useThreadShell(threadRef);
   const draftThread = useComposerDraftStore((store) =>
     draftId ? store.getDraftSession(draftId) : store.getDraftThreadByRef(threadRef),
   );
-  const serverThread = useThread(threadRef, { waitForShell: draftThread !== null });
   const setDraftThreadContext = useComposerDraftStore((store) => store.setDraftThreadContext);
   const activeProjectRef = serverThread
     ? scopeProjectRef(serverThread.environmentId, serverThread.projectId)
@@ -466,6 +470,42 @@ export const BranchToolbar = memo(function BranchToolbar({
 
   if (!hasActiveThread || !activeProject) return null;
 
+  if (layout === "panel") {
+    return (
+      <div className="flex w-full flex-col" data-thread-panel-run-context>
+        {panelSection !== "branch" ? (
+          <BranchToolbarEnvModeSelector
+            displayMode="panel"
+            envLocked={envModeLocked}
+            effectiveEnvMode={effectiveEnvMode}
+            activeWorktreePath={activeWorktreePath}
+            workspaceRoot={activeProject.workspaceRoot}
+            onEnvModeChange={onEnvModeChange}
+            previousWorktreeLabel={previousWorktreeLabel}
+            onUsePreviousWorktree={onUsePreviousWorktree}
+          />
+        ) : null}
+        {panelSection !== "workspace" ? (
+          <BranchToolbarBranchSelector
+            displayMode="panel"
+            className="w-full"
+            environmentId={environmentId}
+            threadId={threadId}
+            {...(draftId ? { draftId } : {})}
+            envLocked={envLocked}
+            {...(effectiveEnvModeOverride ? { effectiveEnvModeOverride } : {})}
+            {...(activeThreadBranchOverride !== undefined ? { activeThreadBranchOverride } : {})}
+            {...(onActiveThreadBranchOverrideChange ? { onActiveThreadBranchOverrideChange } : {})}
+            startFromOrigin={startFromOrigin}
+            onStartFromOriginChange={onStartFromOriginChange}
+            {...(onCheckoutPullRequestRequest ? { onCheckoutPullRequestRequest } : {})}
+            {...(onComposerFocusRequest ? { onComposerFocusRequest } : {})}
+          />
+        ) : null}
+      </div>
+    );
+  }
+
   return (
     <ComposerSurface.ContextStrip
       ref={setStripElement}
diff --git a/apps/web/src/components/BranchToolbarBranchSelector.tsx b/apps/web/src/components/BranchToolbarBranchSelector.tsx
index 5fcad2f741db..0a1c8687ea0f 100644
--- a/apps/web/src/components/BranchToolbarBranchSelector.tsx
+++ b/apps/web/src/components/BranchToolbarBranchSelector.tsx
@@ -26,12 +26,19 @@ import { readLocalApi } from "../localApi";
 import { useOpenPrLink } from "../lib/openPullRequestLink";
 import { shouldLoadNextBranchPageAfterScroll } from "../state/paginatedBranches";
 import { usePaginatedBranches } from "../state/queries";
-import { useProject, useThread } from "../state/entities";
+import { useProject, useThreadShell } from "../state/entities";
 import { useEnvironmentQuery } from "../state/query";
 import { threadEnvironment } from "../state/threads";
 import { useAtomCommand } from "../state/use-atom-command";
 import { vcsEnvironment } from "../state/vcs";
 import { cn } from "../lib/utils";
+import {
+  THREAD_DETAILS_PANEL_CHEVRON_CLASS,
+  THREAD_DETAILS_PANEL_ICON_CLASS,
+  THREAD_DETAILS_PANEL_ROW_POPUP_CLASS,
+  THREAD_DETAILS_PANEL_SELECT_ROW_CLASS,
+} from "./chat/threadDetailsPanelStyles";
+import { ThreadDetailsPrRow } from "./chat/ThreadDetailsPrRow";
 import { parsePullRequestReference } from "../pullRequestReference";
 import { getSourceControlPresentation } from "../sourceControlPresentation";
 import {
@@ -68,6 +75,7 @@ import { Tooltip, TooltipPopup, TooltipTrigger } from "./ui/tooltip";
 
 interface BranchToolbarBranchSelectorProps {
   className?: string;
+  displayMode?: "toolbar" | "panel";
   environmentId: EnvironmentId;
   threadId: ThreadId;
   draftId?: DraftId;
@@ -87,6 +95,7 @@ function toBranchActionErrorMessage(error: unknown): string {
 
 export function BranchToolbarBranchSelector({
   className,
+  displayMode = "toolbar",
   environmentId,
   threadId,
   draftId,
@@ -118,11 +127,11 @@ export function BranchToolbarBranchSelector({
     () => scopeThreadRef(environmentId, threadId),
     [environmentId, threadId],
   );
+  const serverThread = useThreadShell(threadRef);
+  const serverSession = serverThread?.runtime ?? null;
   const draftThread = useComposerDraftStore((store) =>
     draftId ? store.getDraftSession(draftId) : store.getDraftThreadByRef(threadRef),
   );
-  const serverThread = useThread(threadRef, { waitForShell: draftThread !== null });
-  const serverSession = serverThread?.session ?? null;
   const setDraftThreadContext = useComposerDraftStore((store) => store.setDraftThreadContext);
 
   const activeProjectRef = serverThread
@@ -627,6 +636,9 @@ export function BranchToolbarBranchSelector({
     ? `Open ${sourceControlPresentation.terminology.singular} #${branchPr.number} (${branchPr.state})`
     : "";
   const openPrLink = useOpenPrLink(threadRef);
+  const panelPrLabel = branchPr
+    ? `#${branchPr.number}${branchPr.title.trim() ? `: ${branchPr.title}` : ""}`
+    : "";
 
   function renderPickerItem(itemValue: string, index: number) {
     if (checkoutPullRequestItemValue && itemValue === checkoutPullRequestItemValue) {
@@ -726,10 +738,13 @@ export function BranchToolbarBranchSelector({
       value={resolvedActiveBranch}
     >
       <div
-        className={cn("flex min-w-0 items-center gap-1", className)}
-        data-composer-context-control
+        className={cn(
+          "flex min-w-0",
+          displayMode === "panel" ? "w-full flex-col items-stretch" : "items-center gap-1",
+          className,
+        )}
       >
-        {branchPr && branchPrStatus ? (
+        {displayMode !== "panel" && branchPr && branchPrStatus ? (
           <Tooltip>
             <TooltipTrigger
               render={
@@ -750,35 +765,65 @@ export function BranchToolbarBranchSelector({
             <TooltipPopup side="top">{branchPrTooltip}</TooltipPopup>
           </Tooltip>
         ) : null}
-        {/* Context menu lives on the wrapper: the disabled Button has
-            pointer-events-none, so the trigger itself never sees right-clicks
-            while refs are loading or a branch action is pending. */}
         <span
           className="flex min-w-0"
           onContextMenu={(event) => handleBranchContextMenu(event, resolvedActiveBranch)}
         >
           <ComboboxTrigger
-            render={<Button variant="ghost" size="xs" />}
-            className="min-w-0 max-w-full text-muted-foreground/70 hover:text-foreground/80"
+            render={<Button variant="ghost" size={displayMode === "panel" ? "sm" : "xs"} />}
+            className={cn(
+              "min-w-0 max-w-full text-muted-foreground/70 hover:text-foreground/80",
+              displayMode === "panel" && THREAD_DETAILS_PANEL_SELECT_ROW_CLASS,
+            )}
             disabled={isInitialBranchesLoadPending || isBranchActionPending}
           >
-            <GitBranchIcon className="size-3 shrink-0 opacity-70" />
+            <GitBranchIcon
+              className={cn(
+                "size-3 shrink-0 opacity-70",
+                displayMode === "panel" && THREAD_DETAILS_PANEL_ICON_CLASS,
+              )}
+            />
             <span
               data-composer-label
-              className="min-w-0 max-w-[240px] group-data-[compact]/composer-context:max-w-0"
+              className={cn(
+                "min-w-0 max-w-[240px] truncate",
+                displayMode === "panel"
+                  ? "max-w-none flex-1 text-left"
+                  : "transition-[max-width,opacity] duration-300 ease-out group-data-[compact]/composer-context:max-w-0 group-data-[compact]/composer-context:opacity-0",
+              )}
             >
-              <span
-                data-composer-label-motion
-                className="block w-full min-w-0 max-w-[240px] origin-left truncate transition-[opacity,transform] duration-180 ease-[cubic-bezier(0.32,0.72,0,1)] group-data-[compact]/composer-context:[transform:translateX(-0.25rem)_scaleX(0.95)] group-data-[compact]/composer-context:opacity-0 motion-reduce:transform-none motion-reduce:transition-opacity"
-              >
-                {triggerLabel}
-              </span>
+              {triggerLabel}
             </span>
-            <ChevronDownIcon className="size-3 shrink-0 opacity-50" />
+            {displayMode === "panel" ? (
+              <span data-slot="select-icon">
+                <ChevronDownIcon className={THREAD_DETAILS_PANEL_CHEVRON_CLASS} />
+              </span>
+            ) : (
+              <ChevronDownIcon className="size-3 shrink-0 opacity-50" />
+            )}
           </ComboboxTrigger>
         </span>
+        {displayMode === "panel" && branchPr && branchPrStatus ? (
+          <ThreadDetailsPrRow
+            environmentId={environmentId}
+            pr={branchPr}
+            status={branchPrStatus}
+            project={activeProject}
+            label={panelPrLabel}
+            openAriaLabel={branchPrTooltip}
+            onOpen={(event) => openPrLink(event, branchPrStatus.url)}
+            onActed={() => branchStatusQuery.refresh()}
+          />
+        ) : null}
       </div>
-      <ComboboxPopup align="end" side="top" className="flex w-80 flex-col">
+      <ComboboxPopup
+        align={displayMode === "panel" ? "start" : "end"}
+        side={displayMode === "panel" ? "bottom" : "top"}
+        className={cn(
+          "flex flex-col",
+          displayMode === "panel" ? THREAD_DETAILS_PANEL_ROW_POPUP_CLASS : "w-80",
+        )}
+      >
         <div className="shrink-0 px-3 pt-2.5">
           <div className="relative -translate-y-px border-b border-border/70 pb-1.5 transition-colors focus-within:border-ring">
             <SearchIcon
diff --git a/apps/web/src/components/BranchToolbarEnvModeSelector.tsx b/apps/web/src/components/BranchToolbarEnvModeSelector.tsx
index 9fc2d4892e27..3c8cd076be76 100644
--- a/apps/web/src/components/BranchToolbarEnvModeSelector.tsx
+++ b/apps/web/src/components/BranchToolbarEnvModeSelector.tsx
@@ -1,10 +1,18 @@
 import { FolderGit2Icon, FolderGitIcon, FolderIcon, HistoryIcon } from "lucide-react";
 import { memo, useMemo } from "react";
+import { cn } from "../lib/utils";
+import {
+  THREAD_DETAILS_PANEL_ICON_CLASS,
+  THREAD_DETAILS_PANEL_LOCKED_ROW_CLASS,
+  THREAD_DETAILS_PANEL_ROW_POPUP_CLASS,
+  THREAD_DETAILS_PANEL_SELECT_ROW_CLASS,
+} from "./chat/threadDetailsPanelStyles";
 
 import {
   resolveCurrentWorkspaceLabel,
   resolveEnvModeLabel,
   resolveLockedWorkspaceLabel,
+  resolveWorkspaceDisplayName,
   type EnvMode,
 } from "./BranchToolbar.logic";
 import {
@@ -16,6 +24,7 @@ import {
   SelectTrigger,
   SelectValue,
 } from "./ui/select";
+import { Tooltip, TooltipPopup, TooltipTrigger } from "./ui/tooltip";
 
 export const PREVIOUS_WORKTREE_SELECT_VALUE = "previous-worktree";
 
@@ -23,7 +32,9 @@ interface BranchToolbarEnvModeSelectorProps {
   envLocked: boolean;
   effectiveEnvMode: EnvMode;
   activeWorktreePath: string | null;
+  workspaceRoot?: string | null;
   onEnvModeChange: (mode: EnvMode) => void;
+  displayMode?: "toolbar" | "panel";
   previousWorktreeLabel?: string | null;
   onUsePreviousWorktree?: () => void;
 }
@@ -32,41 +43,66 @@ export const BranchToolbarEnvModeSelector = memo(function BranchToolbarEnvModeSe
   envLocked,
   effectiveEnvMode,
   activeWorktreePath,
+  workspaceRoot = null,
   onEnvModeChange,
+  displayMode = "toolbar",
   previousWorktreeLabel,
   onUsePreviousWorktree,
 }: BranchToolbarEnvModeSelectorProps) {
+  const workspacePath = displayMode === "panel" ? (activeWorktreePath ?? workspaceRoot) : null;
+  const workspaceDisplayName = resolveWorkspaceDisplayName(workspacePath);
+  const workspaceKind = activeWorktreePath ? "Worktree" : "Project folder";
   const showPreviousWorktree = Boolean(previousWorktreeLabel && onUsePreviousWorktree);
   const envModeItems = useMemo(
     () => [
-      { value: "local", label: resolveCurrentWorkspaceLabel(activeWorktreePath) },
+      {
+        value: "local",
+        label: workspaceDisplayName ?? resolveCurrentWorkspaceLabel(activeWorktreePath),
+      },
       { value: "worktree", label: resolveEnvModeLabel("worktree") },
       ...(showPreviousWorktree && previousWorktreeLabel
         ? [{ value: PREVIOUS_WORKTREE_SELECT_VALUE, label: previousWorktreeLabel }]
         : []),
     ],
-    [activeWorktreePath, previousWorktreeLabel, showPreviousWorktree],
+    [activeWorktreePath, previousWorktreeLabel, showPreviousWorktree, workspaceDisplayName],
   );
 
   if (envLocked) {
-    return (
+    const lockedRow = (
       <span
-        className="inline-flex h-7 shrink-0 items-center gap-1 border border-transparent px-[calc(--spacing(3)-1px)] text-sm font-medium text-muted-foreground/70 sm:h-6 sm:text-xs"
-        data-composer-context-control
+        className={cn(
+          "inline-flex shrink-0 items-center gap-1 border border-transparent px-[calc(--spacing(3)-1px)] text-sm font-medium text-muted-foreground/70 sm:text-xs",
+          displayMode === "panel" && THREAD_DETAILS_PANEL_LOCKED_ROW_CLASS,
+        )}
       >
         {activeWorktreePath ? (
-          <>
-            <FolderGitIcon className="size-3" />
-            {resolveLockedWorkspaceLabel(activeWorktreePath)}
-          </>
+          <FolderGitIcon
+            className={displayMode === "panel" ? THREAD_DETAILS_PANEL_ICON_CLASS : "size-3"}
+          />
         ) : (
-          <>
-            <FolderIcon className="size-3" />
-            {resolveLockedWorkspaceLabel(activeWorktreePath)}
-          </>
+          <FolderIcon
+            className={displayMode === "panel" ? THREAD_DETAILS_PANEL_ICON_CLASS : "size-3"}
+          />
         )}
+        <span className="min-w-0 flex-1 truncate">
+          {workspaceDisplayName ?? resolveLockedWorkspaceLabel(activeWorktreePath)}
+        </span>
+        {displayMode === "panel" ? (
+          <span className="shrink-0 text-[10px] font-normal text-muted-foreground/70">
+            {workspaceKind}
+          </span>
+        ) : null}
       </span>
     );
+
+    if (!workspacePath) return lockedRow;
+
+    return (
+      <Tooltip>
+        <TooltipTrigger render={lockedRow} />
+        <TooltipPopup side="left">{workspacePath}</TooltipPopup>
+      </Tooltip>
+    );
   }
 
   return (
@@ -82,33 +118,61 @@ export const BranchToolbarEnvModeSelector = memo(function BranchToolbarEnvModeSe
       }}
       items={envModeItems}
     >
-      <SelectTrigger
-        variant="ghost"
-        size="xs"
-        className="min-w-0 shrink font-medium"
-        aria-label="Workspace"
-        data-composer-context-control
-      >
-        {effectiveEnvMode === "worktree" ? (
-          <FolderGit2Icon className="size-3" />
-        ) : activeWorktreePath ? (
-          <FolderGitIcon className="size-3" />
-        ) : (
-          <FolderIcon className="size-3" />
-        )}
-        <span
-          data-composer-label
-          className="min-w-0 max-w-[240px] group-data-[compact]/composer-context:max-w-0"
+      <Tooltip>
+        <TooltipTrigger
+          render={
+            <SelectTrigger
+              variant="ghost"
+              size={displayMode === "panel" ? "default" : "xs"}
+              className={cn(
+                "min-w-0 shrink font-medium",
+                displayMode === "panel" && THREAD_DETAILS_PANEL_SELECT_ROW_CLASS,
+              )}
+              aria-label="Workspace"
+            />
+          }
         >
+          {effectiveEnvMode === "worktree" ? (
+            <FolderGit2Icon
+              className={displayMode === "panel" ? THREAD_DETAILS_PANEL_ICON_CLASS : "size-3"}
+            />
+          ) : activeWorktreePath ? (
+            <FolderGitIcon
+              className={displayMode === "panel" ? THREAD_DETAILS_PANEL_ICON_CLASS : "size-3"}
+            />
+          ) : (
+            <FolderIcon
+              className={displayMode === "panel" ? THREAD_DETAILS_PANEL_ICON_CLASS : "size-3"}
+            />
+          )}
           <span
-            data-composer-label-motion
-            className="block w-full min-w-0 max-w-[240px] origin-left truncate transition-[opacity,transform] duration-180 ease-[cubic-bezier(0.32,0.72,0,1)] group-data-[compact]/composer-context:[transform:translateX(-0.25rem)_scaleX(0.95)] group-data-[compact]/composer-context:opacity-0 motion-reduce:transform-none motion-reduce:transition-opacity"
+            data-composer-label
+            className={
+              displayMode === "panel"
+                ? // flex-1 pushes the kind label and chevron cell to the right edge, so the
+                  // chevron lines up with every other row's trigger.
+                  "min-w-0 flex-1 truncate text-left"
+                : "min-w-0 max-w-[240px] truncate transition-[max-width,opacity] duration-300 ease-out group-data-[compact]/composer-context:max-w-0 group-data-[compact]/composer-context:opacity-0"
+            }
           >
             <SelectValue />
           </span>
-        </span>
-      </SelectTrigger>
-      <SelectPopup>
+          {displayMode === "panel" ? (
+            <span className="shrink-0 text-[10px] font-normal text-muted-foreground/70">
+              {effectiveEnvMode === "worktree" && !activeWorktreePath ? "Create" : workspaceKind}
+            </span>
+          ) : null}
+        </TooltipTrigger>
+        {workspacePath ? <TooltipPopup side="left">{workspacePath}</TooltipPopup> : null}
+      </Tooltip>
+      <SelectPopup
+        {...(displayMode === "panel"
+          ? {
+              alignItemWithTrigger: false,
+              popupClassName: THREAD_DETAILS_PANEL_ROW_POPUP_CLASS,
+            }
+          : {})}
+      >
         <SelectGroup>
           <SelectGroupLabel>Workspace</SelectGroupLabel>
           <SelectItem value="local">
diff --git a/apps/web/src/components/BranchToolbarEnvironmentSelector.tsx b/apps/web/src/components/BranchToolbarEnvironmentSelector.tsx
index b5d5751a280b..ceb41fa8dd8b 100644
--- a/apps/web/src/components/BranchToolbarEnvironmentSelector.tsx
+++ b/apps/web/src/components/BranchToolbarEnvironmentSelector.tsx
@@ -3,6 +3,13 @@ import { CloudIcon, MonitorIcon } from "lucide-react";
 import { memo, useMemo } from "react";
 
 import type { EnvironmentOption } from "./BranchToolbar.logic";
+import { cn } from "../lib/utils";
+import {
+  THREAD_DETAILS_PANEL_ICON_CLASS,
+  THREAD_DETAILS_PANEL_LOCKED_ROW_CLASS,
+  THREAD_DETAILS_PANEL_ROW_POPUP_CLASS,
+  THREAD_DETAILS_PANEL_SELECT_ROW_CLASS,
+} from "./chat/threadDetailsPanelStyles";
 import {
   Select,
   SelectGroup,
@@ -17,9 +24,8 @@ interface BranchToolbarEnvironmentSelectorProps {
   envLocked: boolean;
   environmentId: EnvironmentId;
   availableEnvironments: readonly EnvironmentOption[];
-  // Absent when there is only one environment to show: the indicator still
-  // renders (as a static label) so remote projects are always identifiable.
   onEnvironmentChange?: (environmentId: EnvironmentId) => void;
+  displayMode?: "toolbar" | "panel";
 }
 
 export const BranchToolbarEnvironmentSelector = memo(function BranchToolbarEnvironmentSelector({
@@ -27,6 +33,7 @@ export const BranchToolbarEnvironmentSelector = memo(function BranchToolbarEnvir
   environmentId,
   availableEnvironments,
   onEnvironmentChange,
+  displayMode = "toolbar",
 }: BranchToolbarEnvironmentSelectorProps) {
   const activeEnvironment = useMemo(() => {
     return availableEnvironments.find((env) => env.environmentId === environmentId) ?? null;
@@ -49,24 +56,29 @@ export const BranchToolbarEnvironmentSelector = memo(function BranchToolbarEnvir
   if (envLocked || onEnvironmentChange === undefined) {
     return (
       <span
-        className="inline-flex h-7 min-w-0 max-w-full items-center gap-1 border border-transparent px-[calc(--spacing(3)-1px)] text-sm font-medium text-muted-foreground/70 sm:h-6 sm:text-xs"
-        data-composer-context-control
+        className={cn(
+          "inline-flex min-w-0 max-w-full items-center gap-1 border border-transparent px-[calc(--spacing(3)-1px)] text-sm font-medium text-muted-foreground/70 sm:text-xs",
+          displayMode === "panel" && THREAD_DETAILS_PANEL_LOCKED_ROW_CLASS,
+        )}
       >
         {activeEnvironment?.isPrimary ? (
-          <MonitorIcon className="size-3 shrink-0" />
+          <MonitorIcon
+            className={
+              displayMode === "panel" ? THREAD_DETAILS_PANEL_ICON_CLASS : "size-3 shrink-0"
+            }
+          />
         ) : (
-          <CloudIcon className="size-3 shrink-0" />
+          <CloudIcon
+            className={
+              displayMode === "panel" ? THREAD_DETAILS_PANEL_ICON_CLASS : "size-3 shrink-0"
+            }
+          />
         )}
         <span
           data-composer-label
-          className="min-w-0 max-w-[240px] group-data-[compact]/composer-context:max-w-0"
+          className="min-w-0 max-w-[240px] truncate transition-[max-width,opacity] duration-300 ease-out group-data-[compact]/composer-context:max-w-0 group-data-[compact]/composer-context:opacity-0"
         >
-          <span
-            data-composer-label-motion
-            className="block w-full min-w-0 max-w-[240px] origin-left truncate transition-[opacity,transform] duration-180 ease-[cubic-bezier(0.32,0.72,0,1)] group-data-[compact]/composer-context:[transform:translateX(-0.25rem)_scaleX(0.95)] group-data-[compact]/composer-context:opacity-0 motion-reduce:transform-none motion-reduce:transition-opacity"
-          >
-            {activeEnvironment?.label ?? "Run on"}
-          </span>
+          {activeEnvironment?.label ?? "Run on"}
         </span>
       </span>
     );
@@ -81,29 +93,41 @@ export const BranchToolbarEnvironmentSelector = memo(function BranchToolbarEnvir
     >
       <SelectTrigger
         variant="ghost"
-        size="xs"
-        className="min-w-0 max-w-full font-medium"
+        size={displayMode === "panel" ? "default" : "xs"}
+        className={cn(
+          "min-w-0 max-w-full font-medium",
+          displayMode === "panel" && THREAD_DETAILS_PANEL_SELECT_ROW_CLASS,
+        )}
         aria-label="Run on"
-        data-composer-context-control
       >
         {activeEnvironment?.isPrimary ? (
-          <MonitorIcon className="size-3 shrink-0" />
+          <MonitorIcon
+            className={
+              displayMode === "panel" ? THREAD_DETAILS_PANEL_ICON_CLASS : "size-3 shrink-0"
+            }
+          />
         ) : (
-          <CloudIcon className="size-3 shrink-0" />
+          <CloudIcon
+            className={
+              displayMode === "panel" ? THREAD_DETAILS_PANEL_ICON_CLASS : "size-3 shrink-0"
+            }
+          />
         )}
         <span
           data-composer-label
-          className="min-w-0 max-w-[240px] group-data-[compact]/composer-context:max-w-0"
+          className="min-w-0 max-w-[240px] truncate transition-[max-width,opacity] duration-300 ease-out group-data-[compact]/composer-context:max-w-0 group-data-[compact]/composer-context:opacity-0"
         >
-          <span
-            data-composer-label-motion
-            className="block w-full min-w-0 max-w-[240px] origin-left truncate transition-[opacity,transform] duration-180 ease-[cubic-bezier(0.32,0.72,0,1)] group-data-[compact]/composer-context:[transform:translateX(-0.25rem)_scaleX(0.95)] group-data-[compact]/composer-context:opacity-0 motion-reduce:transform-none motion-reduce:transition-opacity"
-          >
-            <SelectValue />
-          </span>
+          <SelectValue />
         </span>
       </SelectTrigger>
-      <SelectPopup>
+      <SelectPopup
+        {...(displayMode === "panel"
+          ? {
+              alignItemWithTrigger: false,
+              popupClassName: THREAD_DETAILS_PANEL_ROW_POPUP_CLASS,
+            }
+          : {})}
+      >
         <SelectGroup>
           <SelectGroupLabel>Run on</SelectGroupLabel>
           {availableEnvironments.map((env) => (
diff --git a/apps/web/src/components/ChatMarkdown.test.tsx b/apps/web/src/components/ChatMarkdown.test.tsx
index 2ca9ad4ae311..716b528ff41d 100644
--- a/apps/web/src/components/ChatMarkdown.test.tsx
+++ b/apps/web/src/components/ChatMarkdown.test.tsx
@@ -1,77 +1,20 @@
-import { EnvironmentId } from "@t3tools/contracts";
-import { renderToStaticMarkup } from "react-dom/server";
-import { describe, expect, it, vi } from "vite-plus/test";
+import { describe, expect, it } from "vite-plus/test";
 
-vi.mock("@effect/atom-react", () => ({ useAtomValue: () => null }));
-vi.mock("../hooks/useTheme", () => ({ useTheme: () => ({ resolvedTheme: "dark" }) }));
-vi.mock("../state/use-atom-query-runner", () => ({ useAtomQueryRunner: () => vi.fn() }));
-vi.mock("../state/use-atom-command", () => ({ useAtomCommand: () => vi.fn() }));
-vi.mock("../state/session", async (importOriginal) => ({
-  ...(await importOriginal<typeof import("../state/session")>()),
-  usePreparedConnection: () => ({ _tag: "Loading" }),
-}));
-vi.mock("../state/entities", () => ({
-  readThreadShell: () => null,
-  useProjects: () => [],
-}));
-vi.mock("../remoteOpen", () => ({
-  useRemoteOpenResolution: () => ({ state: { mode: "local-exec" }, isResolved: true }),
-}));
-vi.mock("../editorPreferences", () => ({
-  useOpenInPreferredEditor: () => vi.fn(),
-  usePreferredEditor: () => [null, vi.fn()],
-}));
-vi.mock("~/lib/openPullRequestLink", () => ({
-  findProjectForChangeRequest: () => undefined,
-  matchesLinkedPullRequestUrl: () => false,
-  parseChangeRequestUrl: () => null,
-  useOpenChangeRequestLink: () => vi.fn(),
-}));
-
-import ChatMarkdown, {
+import {
   canUseMarkdownFileShellActions,
   hasMarkdownFilePrimaryAction,
   orderedListGutterStyle,
   shouldUseMarkdownFileBrowserPrimaryAction,
 } from "./ChatMarkdown";
 
-describe("canUseMarkdownFileShellActions", () => {
-  const environmentId = EnvironmentId.make("environment-1");
-
-  it("allows editor and file manager actions for local environments", () => {
-    expect(canUseMarkdownFileShellActions(environmentId, "local-exec", true)).toBe(true);
-  });
-
-  it("hides shell actions until the environment mode is resolved", () => {
-    expect(canUseMarkdownFileShellActions(environmentId, "local-exec", false)).toBe(false);
-  });
-
-  it("hides editor and file manager actions for remote environments", () => {
-    expect(canUseMarkdownFileShellActions(environmentId, "remote-links", true)).toBe(false);
-    expect(canUseMarkdownFileShellActions(environmentId, "remote-unavailable", true)).toBe(false);
-  });
-
-  it("hides shell actions when no environment owns the markdown", () => {
+describe("markdown file actions", () => {
+  it("only enables shell actions for resolved local execution", () => {
     expect(canUseMarkdownFileShellActions(null, "local-exec", true)).toBe(false);
+    expect(canUseMarkdownFileShellActions("env-local" as never, "local-exec", true)).toBe(true);
+    expect(canUseMarkdownFileShellActions("env-remote" as never, "remote-links", true)).toBe(false);
   });
-});
 
-describe("hasMarkdownFilePrimaryAction", () => {
-  it("keeps the chip interactive when an editor, browser, or panel can open it", () => {
-    expect(
-      hasMarkdownFilePrimaryAction({
-        canOpenInEditor: true,
-        canOpenInBrowser: false,
-        canOpenInPanel: false,
-      }),
-    ).toBe(true);
-    expect(
-      hasMarkdownFilePrimaryAction({
-        canOpenInEditor: false,
-        canOpenInBrowser: true,
-        canOpenInPanel: false,
-      }),
-    ).toBe(true);
+  it("keeps the in-app panel as the ordinary file-chip action", () => {
     expect(
       hasMarkdownFilePrimaryAction({
         canOpenInEditor: false,
@@ -79,72 +22,15 @@ describe("hasMarkdownFilePrimaryAction", () => {
         canOpenInPanel: true,
       }),
     ).toBe(true);
-  });
-
-  it("removes the link affordance when no primary action can open the file", () => {
-    expect(
-      hasMarkdownFilePrimaryAction({
-        canOpenInEditor: false,
-        canOpenInBrowser: false,
-        canOpenInPanel: false,
-      }),
-    ).toBe(false);
-  });
-});
-
-describe("ChatMarkdown file option chips", () => {
-  it("keeps the fallback button text selectable", () => {
-    const html = renderToStaticMarkup(
-      <ChatMarkdown cwd="/tmp/project" text="[Source](/tmp/project/src/main.ts)" />,
-    );
-
-    expect(html).toContain("<button");
-    expect(html).toContain('aria-haspopup="menu"');
-    expect(html).toContain("select-text");
-  });
-});
-
-describe("shouldUseMarkdownFileBrowserPrimaryAction", () => {
-  it("uses the browser when it is the only available primary action", () => {
     expect(
       shouldUseMarkdownFileBrowserPrimaryAction({
-        iconPath: "/tmp/report.html",
-        canOpenInEditor: false,
-        canOpenInBrowser: true,
-        canOpenInPanel: false,
-      }),
-    ).toBe(true);
-  });
-
-  it("preserves the normal editor and panel defaults for HTML files", () => {
-    expect(
-      shouldUseMarkdownFileBrowserPrimaryAction({
-        iconPath: "/tmp/report.html",
+        iconPath: "src/app.ts",
         canOpenInEditor: true,
         canOpenInBrowser: true,
-        canOpenInPanel: false,
-      }),
-    ).toBe(false);
-    expect(
-      shouldUseMarkdownFileBrowserPrimaryAction({
-        iconPath: "/tmp/report.html",
-        canOpenInEditor: false,
-        canOpenInBrowser: true,
         canOpenInPanel: true,
       }),
     ).toBe(false);
   });
-
-  it("continues to open PDF files in the browser by default", () => {
-    expect(
-      shouldUseMarkdownFileBrowserPrimaryAction({
-        iconPath: "/tmp/report.pdf",
-        canOpenInEditor: true,
-        canOpenInBrowser: true,
-        canOpenInPanel: true,
-      }),
-    ).toBe(true);
-  });
 });
 
 describe("orderedListGutterStyle", () => {
@@ -169,123 +55,13 @@ describe("orderedListGutterStyle", () => {
   it("accounts for a non-default start attribute", () => {
     // start=95 + 9 items => last marker is "103", three digits.
     expect(orderedListGutterStyle(9, 95)).toEqual({ "--list-gutter": "4ch" });
-    expect(orderedListGutterStyle(5, "999995")).toEqual({ "--list-gutter": "7ch" });
   });
 
   it("scales further for four-digit markers", () => {
     expect(orderedListGutterStyle(1000, undefined)).toEqual({ "--list-gutter": "5ch" });
   });
 
-  it("uses the widest marker and includes a negative start's minus sign", () => {
-    expect(orderedListGutterStyle(1001, -1000)).toEqual({ "--list-gutter": "6ch" });
-    expect(orderedListGutterStyle(3, -15)).toEqual({ "--list-gutter": "4ch" });
-    expect(orderedListGutterStyle(3, -5)).toBeUndefined();
-  });
-
   it("treats a missing/zero item count as a single item", () => {
     expect(orderedListGutterStyle(0, undefined)).toBeUndefined();
-    expect(orderedListGutterStyle(0, 100)).toEqual({ "--list-gutter": "4ch" });
-  });
-});
-
-describe("ChatMarkdown Windows file links", () => {
-  const environmentId = EnvironmentId.make("env-windows");
-
-  it.each([true, false])("preserves drive paths with parseRawHtml=%s", (parseRawHtml) => {
-    const html = renderToStaticMarkup(
-      <ChatMarkdown
-        cwd="C:/Users/shawn/project"
-        environmentId={environmentId}
-        text="[Open](C:/Users/shawn/project/src/main.ts)"
-        lineBreaks={!parseRawHtml}
-        parseRawHtml={parseRawHtml}
-      />,
-    );
-
-    expect(html).toContain('href="C:/Users/shawn/project/src/main.ts"');
-    expect(html).toContain("chat-markdown-file-link");
-  });
-
-  it.each([true, false])("normalizes backslashes with parseRawHtml=%s", (parseRawHtml) => {
-    const html = renderToStaticMarkup(
-      <ChatMarkdown
-        cwd="C:/Users/shawn/project"
-        environmentId={environmentId}
-        text={String.raw`[Open](C:\Users\shawn\project\src\main.ts)`}
-        lineBreaks={!parseRawHtml}
-        parseRawHtml={parseRawHtml}
-      />,
-    );
-
-    expect(html).toContain('href="C:/Users/shawn/project/src/main.ts"');
-    expect(html).toContain("chat-markdown-file-link");
-  });
-
-  it.each([true, false])(
-    "distinguishes same-named backslash paths with parseRawHtml=%s",
-    (parseRawHtml) => {
-      const html = renderToStaticMarkup(
-        <ChatMarkdown
-          cwd="C:/Users/shawn/project"
-          environmentId={environmentId}
-          text={String.raw`[Source](C:\Users\shawn\project\src\index.ts) and [Test](C:\Users\shawn\project\test\index.ts)`}
-          lineBreaks={!parseRawHtml}
-          parseRawHtml={parseRawHtml}
-        />,
-      );
-
-      expect(html).toContain("index.ts · project/src");
-      expect(html).toContain("index.ts · project/test");
-    },
-  );
-
-  it.each([true, false])(
-    "does not disambiguate the same file in links and inline code with parseRawHtml=%s",
-    (parseRawHtml) => {
-      const path = String.raw`C:\Users\shawn\project\src\main.ts`;
-      const html = renderToStaticMarkup(
-        <ChatMarkdown
-          cwd="C:/Users/shawn/project"
-          environmentId={environmentId}
-          text={`[Source](${path}) and \`${path}\``}
-          lineBreaks={!parseRawHtml}
-          parseRawHtml={parseRawHtml}
-        />,
-      );
-
-      expect(html.match(/chat-markdown-file-link/g)).toHaveLength(2);
-      expect(html).not.toContain("main.ts ·");
-    },
-  );
-
-  it.each([true, false])("preserves reference links with parseRawHtml=%s", (parseRawHtml) => {
-    const html = renderToStaticMarkup(
-      <ChatMarkdown
-        cwd="C:/Users/shawn/project"
-        environmentId={environmentId}
-        text={"[Open][source]\n\n[source]: C:/Users/shawn/project/src/main.ts"}
-        lineBreaks={!parseRawHtml}
-        parseRawHtml={parseRawHtml}
-      />,
-    );
-
-    expect(html).toContain('href="C:/Users/shawn/project/src/main.ts"');
-    expect(html).toContain("chat-markdown-file-link");
-  });
-
-  it.each([true, false])("still rejects unsafe schemes with parseRawHtml=%s", (parseRawHtml) => {
-    const html = renderToStaticMarkup(
-      <ChatMarkdown
-        cwd="C:/Users/shawn/project"
-        environmentId={environmentId}
-        text="[unsafe](javascript:alert(1)) and [unknown](d:alert(1))"
-        lineBreaks={!parseRawHtml}
-        parseRawHtml={parseRawHtml}
-      />,
-    );
-
-    expect(html).not.toContain("javascript:");
-    expect(html).not.toContain("d:alert");
-    expect(html).not.toContain("chat-markdown-file-link");
   });
 });
diff --git a/apps/web/src/components/ChatMarkdown.tsx b/apps/web/src/components/ChatMarkdown.tsx
index c55bfd059092..03fcbd0105ae 100644
--- a/apps/web/src/components/ChatMarkdown.tsx
+++ b/apps/web/src/components/ChatMarkdown.tsx
@@ -93,18 +93,17 @@ import {
 } from "../markdown-clipboard";
 import { remarkNormalizeListItemIndentation } from "../markdown-list-indentation";
 import {
+  shouldOpenMarkdownFileLinkInBrowserByDefault,
+  shouldOpenMarkdownFileLinkInEditor,
   extractMarkdownLinkHrefs,
   isWindowsDrivePathHref,
   normalizeMarkdownLinkDestination,
   resolveInlineCodeFileLinkMeta,
   resolveMarkdownFileLinkMeta,
   rewriteMarkdownFileUriHref,
-  shouldOpenMarkdownFileLinkInBrowserByDefault,
-  shouldOpenMarkdownFileLinkInEditor,
   type MarkdownFileLinkMeta,
 } from "../markdown-links";
 import { readLocalApi } from "../localApi";
-import { useAssetUrlState } from "../assets/assetUrls";
 import { cn } from "../lib/utils";
 import { useRemoteOpenResolution, type RemoteOpenMode } from "../remoteOpen";
 import { useRightPanelStore } from "../rightPanelStore";
@@ -131,8 +130,9 @@ import {
   useOpenChangeRequestLink,
 } from "~/lib/openPullRequestLink";
 import { writeTextToClipboard } from "../hooks/useCopyToClipboard";
-import { isPreviewSupportedInRuntime } from "../previewStateStore";
+import { useAssetUrlState } from "../assets/assetUrls";
 import { resolvePathLinkTarget } from "../terminal-links";
+import { isPreviewSupportedInRuntime } from "../previewStateStore";
 import {
   isBrowserPreviewFile,
   openFileInPreview,
@@ -158,7 +158,7 @@ interface ChatMarkdownProps {
 }
 
 export function canUseMarkdownFileShellActions(
-  environmentId: EnvironmentId | null,
+  environmentId: ScopedThreadRef["environmentId"] | null,
   remoteOpenMode: RemoteOpenMode,
   isRemoteOpenResolved: boolean,
 ): boolean {
@@ -223,13 +223,12 @@ function findTaskListMarkerOffset(markdown: string, listItemStart: number): numb
 }
 
 /**
- * The default `1.25rem` marker gutter (`.chat-markdown ol`) fits markers up to
- * two characters wide. Once a marker reaches three characters (item 100+),
- * `list-style-position: outside` paints it wider than that gutter and clips
- * the leading character against the item's own overflow. Rather than widening
- * the gutter for every list, only lists whose widest marker is 3+ characters
- * get a wider `--list-gutter`. The width includes a negative marker's minus
- * sign.
+ * The default `1.25rem` marker gutter (`.chat-markdown ol`) fits two-digit
+ * decimal markers. Once a list's last item reaches three digits (item 100+),
+ * `list-style-position: outside` paints the marker wider than that gutter and
+ * the leading digit gets clipped by the item's own overflow. Rather than
+ * widening the gutter for every list, only lists whose last marker is 3+
+ * digits get a wider `--list-gutter`, sized to that marker's digit count.
  */
 export function orderedListGutterStyle(
   itemCount: number,
@@ -238,6 +237,7 @@ export function orderedListGutterStyle(
   const parsedStart = Number.parseInt(String(start ?? 1), 10);
   const firstNumber = Number.isNaN(parsedStart) ? 1 : parsedStart;
   const lastNumber = firstNumber + Math.max(itemCount - 1, 0);
+  // The width includes a negative marker's minus sign (#7856).
   const markerWidth = Math.max(String(firstNumber).length, String(lastNumber).length);
   if (markerWidth <= 2) return undefined;
   return { "--list-gutter": `${markerWidth + 1}ch` };
@@ -265,7 +265,6 @@ function rehypePreserveImageSourceMeta() {
       }
       node.children?.forEach(visit);
     };
-
     visit(tree);
   };
 }
@@ -413,9 +412,11 @@ function remarkPreserveCodeMeta() {
 }
 
 /**
- * Preserve Windows drive links as allowed `file:` URLs before sanitization.
- * The same traversal tags inline code while it can still be distinguished
- * from fenced code. Code inside links stays untagged to avoid nested anchors.
+ * Fenced code also lands on the `code` component, and inline vs block is no
+ * longer distinguishable there once both render `<code>` — so inline spans are
+ * tagged on the mdast, where the distinction still exists. Code inside a link
+ * label stays untagged: linkifying it would nest an anchor inside the link's
+ * anchor and steal its clicks.
  */
 function remarkNormalizeLinksAndTagInlineCode() {
   return (tree: MarkdownAstNode) => {
@@ -928,14 +929,12 @@ interface MarkdownFileLinkProps {
   openInEditorMenuLabel: string;
   onOpenInBrowser?: (() => Promise<AtomCommandResult<unknown, unknown>>) | undefined;
   onReveal?: (() => Promise<AtomCommandResult<unknown, unknown>>) | undefined;
-  /** Platform-specific menu label ("Reveal in Finder", ...); required for the
-      reveal item to show. */
   revealLabel?: string | undefined;
   className?: string | undefined;
 }
 
-const MARKDOWN_FILE_CHIP_CLASS_NAME = "chat-markdown-file-link";
-const MARKDOWN_FILE_LINK_CLASS_NAME = `${MARKDOWN_FILE_CHIP_CLASS_NAME} cursor-pointer transition-colors hover:bg-accent/70 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/70`;
+const MARKDOWN_FILE_LINK_CLASS_NAME =
+  "chat-markdown-file-link cursor-pointer transition-colors hover:bg-accent/70 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/70";
 
 function pathParentSegments(path: string): string[] {
   const normalized = path.replaceAll("\\", "/");
@@ -1342,9 +1341,7 @@ const MarkdownFileLink = memo(function MarkdownFileLink({
   className,
 }: MarkdownFileLinkProps) {
   const handleOpenInEditor = useCallback(() => {
-    if (!onOpen) {
-      return;
-    }
+    if (!onOpen) return;
     void (async () => {
       try {
         const result = await onOpen(targetPath);
@@ -1426,42 +1423,19 @@ const MarkdownFileLink = memo(function MarkdownFileLink({
   }, [onOpenInBrowser, targetPath]);
 
   const handleRevealInFileManager = useCallback(() => {
-    if (!onReveal) {
-      return;
-    }
-    void (async () => {
-      try {
-        const result = await onReveal();
-        if (result._tag === "Success" || isAtomCommandInterrupted(result)) {
-          return;
-        }
-        reportMarkdownActionFailure(
-          { operation: "reveal-file-in-file-manager", target: targetPath },
-          result.cause,
-        );
-        const error = squashAtomCommandFailure(result);
-        toastManager.add(
-          stackedThreadToast({
-            type: "error",
-            title: "Unable to reveal file",
-            description: error instanceof Error ? error.message : "An error occurred.",
-          }),
-        );
-      } catch (cause) {
-        reportMarkdownActionFailure(
-          { operation: "reveal-file-in-file-manager", target: targetPath },
-          cause,
-        );
-        toastManager.add(
-          stackedThreadToast({
-            type: "error",
-            title: "Unable to reveal file",
-            description: cause instanceof Error ? cause.message : "An error occurred.",
-          }),
-        );
-      }
-    })();
-  }, [onReveal, targetPath]);
+    if (!onReveal) return;
+    void onReveal().then((result) => {
+      if (result._tag === "Success" || isAtomCommandInterrupted(result)) return;
+      const error = squashAtomCommandFailure(result);
+      toastManager.add(
+        stackedThreadToast({
+          type: "error",
+          title: "Unable to reveal file",
+          description: error instanceof Error ? error.message : "An error occurred.",
+        }),
+      );
+    });
+  }, [onReveal]);
 
   const handleCopy = useCallback(
     (value: string, title: string) => {
@@ -1553,8 +1527,8 @@ const MarkdownFileLink = memo(function MarkdownFileLink({
       handleOpenInBrowser,
       handleOpenInEditor,
       handleRevealInFileManager,
-      onOpenInBrowser,
       onOpen,
+      onOpenInBrowser,
       onReveal,
       openInEditorMenuLabel,
       revealLabel,
@@ -1647,9 +1621,9 @@ const MarkdownFileLink = memo(function MarkdownFileLink({
         side="top"
         className="max-w-[min(40rem,calc(100vw-2rem))] font-mono text-[11px] leading-tight"
       >
-        {/* The full path: the chip already shows the shortened form, and a link
-            to the workspace root collapses to a bare label that repeats it. */}
-        <div className="overflow-x-auto whitespace-nowrap [scrollbar-color:color-mix(in_srgb,var(--contrast-border)_78%,transparent)_transparent] [scrollbar-width:thin] [&::-webkit-scrollbar]:h-1.5 [&::-webkit-scrollbar-thumb]:rounded-full [&::-webkit-scrollbar-thumb]:bg-[color-mix(in_srgb,var(--contrast-border)_78%,transparent)] [&::-webkit-scrollbar-track]:bg-transparent">
+        <div className="overflow-x-auto whitespace-nowrap [scrollbar-color:color-mix(in_srgb,var(--border)_78%,transparent)_transparent] [scrollbar-width:thin] [&::-webkit-scrollbar]:h-1.5 [&::-webkit-scrollbar-thumb]:rounded-full [&::-webkit-scrollbar-thumb]:bg-[color-mix(in_srgb,var(--border)_78%,transparent)] [&::-webkit-scrollbar-track]:bg-transparent">
+          {/* The full path: the chip already shows the shortened form, and a link
+              to the workspace root collapses to a bare label that repeats it. */}
           {targetPath}
         </div>
       </TooltipPopup>
@@ -1682,6 +1656,357 @@ function areMarkdownFileLinkPropsEqual(
   );
 }
 
+interface ChatMarkdownComponentsContext {
+  readonly cwd: string | undefined;
+  readonly imageBaseDir: string | undefined;
+  readonly diffThemeName: DiffThemeName;
+  readonly fileLinkParentSuffixByPath: ReadonlyMap<string, string>;
+  readonly inlineCodeFileLinkMetaByText: ReadonlyMap<string, MarkdownFileLinkMeta>;
+  readonly isStreaming: boolean;
+  readonly markdownFileLinkMetaByHref: ReadonlyMap<string, MarkdownFileLinkMeta>;
+  readonly onTaskListChange: ChatMarkdownProps["onTaskListChange"];
+  readonly onOpenFileInPanel: (workspaceRelativePath: string, line: number | undefined) => void;
+  readonly openInPreferredEditor?:
+    | ((targetPath: string) => Promise<AtomCommandResult<unknown, unknown>>)
+    | undefined;
+  readonly openInEditorMenuLabel: string;
+  readonly revealInFileManagerLabel?: string | undefined;
+  readonly revealMarkdownFileInFileManager?:
+    | ((fileLinkMeta: MarkdownFileLinkMeta) => Promise<AtomCommandResult<unknown, unknown>>)
+    | undefined;
+  readonly openExternalLinkInPreview: (url: string) => Promise<AtomCommandResult<unknown, unknown>>;
+  readonly openMarkdownFileInPreview: (
+    path: string,
+  ) => Promise<AtomCommandResult<unknown, unknown>>;
+  readonly openChangeRequestLink: ReturnType<typeof useOpenChangeRequestLink>;
+  readonly resolveThreadPullRequest: (href: string) => ThreadLinkedPullRequest | null;
+  readonly updateThreadPullRequestLink: (href: string, linked: boolean) => Promise<void>;
+  readonly resolvedTheme: "light" | "dark";
+  readonly skills: ReadonlyArray<Pick<ServerProviderSkill, "name" | "displayName">>;
+  readonly text: string;
+  readonly threadRef: ScopedThreadRef | undefined;
+}
+
+// Module scope so the markdown renderers are not re-declared inside the
+// component render (react/no-unstable-nested-components). Referential
+// stability is unchanged: the caller memoizes the result with the same
+// dependency values as before.
+function createChatMarkdownComponents(ctx: ChatMarkdownComponentsContext): Components {
+  const {
+    cwd,
+    imageBaseDir,
+    diffThemeName,
+    fileLinkParentSuffixByPath,
+    inlineCodeFileLinkMetaByText,
+    isStreaming,
+    markdownFileLinkMetaByHref,
+    onTaskListChange,
+    onOpenFileInPanel,
+    openInPreferredEditor,
+    openInEditorMenuLabel,
+    revealInFileManagerLabel,
+    revealMarkdownFileInFileManager,
+    openExternalLinkInPreview,
+    openMarkdownFileInPreview,
+    openChangeRequestLink,
+    resolveThreadPullRequest,
+    updateThreadPullRequestLink,
+    resolvedTheme,
+    skills,
+    text,
+    threadRef,
+  } = ctx;
+  const fileLinkChip = (
+    fileLinkMeta: MarkdownFileLinkMeta,
+    copyMarkdown: string,
+    className?: string,
+  ) => {
+    const parentSuffix = fileLinkParentSuffixByPath.get(
+      fileLinkMeta.filePath.replaceAll("\\", "/"),
+    );
+    const labelParts = [fileLinkMeta.basename];
+    if (typeof parentSuffix === "string" && parentSuffix.length > 0) {
+      labelParts.push(parentSuffix);
+    }
+    if (fileLinkMeta.line) {
+      labelParts.push(
+        `L${fileLinkMeta.line}${fileLinkMeta.column ? `:C${fileLinkMeta.column}` : ""}`,
+      );
+    }
+
+    return (
+      <MarkdownFileLink
+        href={fileLinkMeta.targetPath}
+        targetPath={fileLinkMeta.targetPath}
+        iconPath={fileLinkMeta.filePath}
+        displayPath={fileLinkMeta.displayPath}
+        workspaceRelativePath={fileLinkMeta.workspaceRelativePath}
+        line={fileLinkMeta.line}
+        label={labelParts.join(" · ")}
+        copyMarkdown={copyMarkdown}
+        theme={resolvedTheme}
+        threadRef={threadRef}
+        onOpen={openInPreferredEditor}
+        onOpenInPanel={onOpenFileInPanel}
+        openInEditorMenuLabel={openInEditorMenuLabel}
+        onReveal={
+          revealMarkdownFileInFileManager
+            ? () => revealMarkdownFileInFileManager(fileLinkMeta)
+            : undefined
+        }
+        revealLabel={revealInFileManagerLabel}
+        onOpenInBrowser={
+          threadRef && isPreviewSupportedInRuntime() && isBrowserPreviewFile(fileLinkMeta.filePath)
+            ? () => openMarkdownFileInPreview(fileLinkMeta.filePath)
+            : undefined
+        }
+        className={className}
+      />
+    );
+  };
+
+  return {
+    p({ node: _node, children, ...props }) {
+      return <p {...props}>{renderSkillInlineMarkdownChildren(children, skills)}</p>;
+    },
+    li({ node, children, ...props }) {
+      const listItemStart = node?.position?.start.offset;
+      const markerOffset =
+        typeof listItemStart === "number" ? findTaskListMarkerOffset(text, listItemStart) : null;
+      return (
+        <li {...props} data-task-marker-offset={markerOffset ?? undefined}>
+          {renderSkillInlineMarkdownChildren(children, skills)}
+        </li>
+      );
+    },
+    input({ node: _node, type, checked, disabled: _disabled, ...props }) {
+      if (type !== "checkbox" || !onTaskListChange) {
+        return (
+          <input
+            {...props}
+            type={type}
+            checked={checked}
+            disabled={_disabled}
+            readOnly={type === "checkbox"}
+          />
+        );
+      }
+      return (
+        <input
+          {...props}
+          type="checkbox"
+          name="markdown-task"
+          aria-label="Toggle task"
+          checked={checked}
+          onChange={(event) => {
+            const markerOffset = Number(
+              event.currentTarget.closest("li")?.dataset.taskMarkerOffset,
+            );
+            if (!Number.isSafeInteger(markerOffset)) return;
+            onTaskListChange({ markerOffset, checked: event.currentTarget.checked });
+          }}
+        />
+      );
+    },
+    img({ node, title, src, alt, ...props }) {
+      const localSrc = node?.properties?.dataLocalSrc;
+      const markdownTitle = node?.properties?.dataMarkdownTitle;
+      const authoredSrc = typeof localSrc === "string" ? localSrc : src;
+      const authoredTitle = typeof markdownTitle === "string" ? markdownTitle : title;
+      const srcString =
+        typeof authoredSrc === "string" ? normalizeMarkdownLinkDestination(authoredSrc) : "";
+      const classifiedSrc =
+        typeof localSrc === "string" ? srcString.replaceAll("\\", "/") : srcString;
+      const altText = alt ?? "";
+      const copyMarkdown = markdownImageCopy(altText, srcString, authoredTitle);
+      const authoredSizeStyle = authoredImageSizeStyle(props.width, props.height);
+      const imageSource = classifyMarkdownImageSource(classifiedSrc, imageBaseDir ?? cwd);
+      if (imageSource._tag === "Direct") {
+        return (
+          <img
+            {...props}
+            src={imageSource.uri}
+            alt={altText}
+            loading="lazy"
+            className={cn(props.className, CHAT_MARKDOWN_IMAGE_SIZE_CLASS_NAME)}
+            style={authoredSizeStyle}
+          />
+        );
+      }
+      if (imageSource._tag === "WorkspaceFile" && threadRef) {
+        return (
+          <ChatMarkdownWorkspaceImage
+            threadRef={threadRef}
+            path={imageSource.path}
+            alt={altText}
+            copyMarkdown={copyMarkdown}
+            srcFragment={markdownImageSourceFragment(classifiedSrc)}
+            style={authoredSizeStyle}
+          />
+        );
+      }
+      return <ChatMarkdownImageFallback alt={altText} copyMarkdown={copyMarkdown} />;
+    },
+    a({ node, href, children, title: _title, ...props }) {
+      const normalizedHref = href ? normalizeMarkdownLinkHrefKey(href) : "";
+      const fileLinkMeta = normalizedHref ? markdownFileLinkMetaByHref.get(normalizedHref) : null;
+      if (!fileLinkMeta) {
+        const faviconHost = resolveExternalWebLinkHost(href);
+        const isSameDocumentLink = href?.startsWith("#") ?? false;
+        const onClick = props.onClick;
+        const canOpenInPreview = Boolean(threadRef) && isPreviewSupportedInRuntime();
+        const link = (
+          <a
+            {...props}
+            href={href}
+            target={isSameDocumentLink ? undefined : "_blank"}
+            rel={isSameDocumentLink ? undefined : "noopener noreferrer"}
+            onClick={(event) => {
+              onClick?.(event);
+              if (isSameDocumentLink && href) {
+                handleMarkdownFragmentClick(event, href);
+                return;
+              }
+              if (href) openChangeRequestLink(event, href);
+            }}
+            onContextMenu={(event) => {
+              if (!href || !faviconHost) return;
+              event.preventDefault();
+              event.stopPropagation();
+              const api = readLocalApi();
+              if (!api) return;
+              const pullRequest = resolveThreadPullRequest(href);
+              const currentPullRequest =
+                threadRef === undefined ? null : readThreadShell(threadRef)?.linkedPullRequest;
+              const threadLinkAction =
+                currentPullRequest != null && matchesLinkedPullRequestUrl(currentPullRequest, href)
+                  ? "unlink-from-thread"
+                  : pullRequest === null
+                    ? undefined
+                    : "link-to-thread";
+              void showExternalLinkContextMenu({
+                href,
+                canOpenInPreview,
+                threadLinkAction,
+                position: { x: event.clientX, y: event.clientY },
+                showContextMenu: (items, position) => api.contextMenu.show(items, position),
+                openInPreview: async (target) => {
+                  const result = await openExternalLinkInPreview(target);
+                  if (result._tag === "Failure" && !isAtomCommandInterrupted(result)) {
+                    reportMarkdownActionFailure(
+                      { operation: "open-link-in-preview", target },
+                      result.cause,
+                    );
+                  }
+                },
+                openExternal: (target) => api.shell.openExternal(target),
+                copyLink: (target) => writeTextToClipboard(target, "link"),
+                updateThreadLink: updateThreadPullRequestLink,
+                reportFailure: (operation, cause) => {
+                  reportMarkdownActionFailure({ operation, target: href }, cause);
+                  if (
+                    operation === "link-pull-request-to-thread" ||
+                    operation === "unlink-pull-request-from-thread"
+                  ) {
+                    toastManager.add(
+                      stackedThreadToast({
+                        type: "error",
+                        title:
+                          operation === "link-pull-request-to-thread"
+                            ? "Unable to link pull request"
+                            : "Unable to unlink pull request",
+                        description: cause instanceof Error ? cause.message : "The request failed.",
+                      }),
+                    );
+                  }
+                },
+              });
+            }}
+          >
+            {faviconHost && hastHasText(node) ? (
+              <MarkdownExternalLinkContent host={faviconHost} plainText={plainHastText(node)}>
+                {children}
+              </MarkdownExternalLinkContent>
+            ) : (
+              children
+            )}
+          </a>
+        );
+        if (!faviconHost || !href) {
+          return link;
+        }
+        return (
+          <Tooltip>
+            <TooltipTrigger render={link} />
+            <TooltipPopup
+              side="top"
+              className="max-w-[min(36rem,calc(100vw-2rem))] whitespace-normal leading-tight wrap-anywhere"
+            >
+              {href}
+            </TooltipPopup>
+          </Tooltip>
+        );
+      }
+
+      return fileLinkChip(
+        fileLinkMeta,
+        `[${fileLinkMeta.basename}](${normalizedHref})`,
+        props.className,
+      );
+    },
+    code({ node, children, className, ...props }) {
+      if (node?.properties?.dataInlineCode != null) {
+        const codeText = nodeToPlainText(children);
+        const fileLinkMeta =
+          inlineCodeFileLinkMetaByText.get(codeText.trim()) ??
+          resolveInlineCodeFileLinkMeta(codeText, cwd);
+        if (fileLinkMeta) {
+          return fileLinkChip(fileLinkMeta, `\`${codeText}\``);
+        }
+      }
+      return (
+        <code {...props} className={className}>
+          {children}
+        </code>
+      );
+    },
+    table({ node: _node, ...props }) {
+      return <MarkdownTable {...props} />;
+    },
+    details({ node: _node, children, open: detailsOpen }) {
+      return <MarkdownDetails open={detailsOpen}>{children}</MarkdownDetails>;
+    },
+    pre({ node, children, ...props }) {
+      const codeBlock = extractCodeBlock(children);
+      if (!codeBlock) {
+        return <pre {...props}>{children}</pre>;
+      }
+
+      const language = extractFenceLanguage(codeBlock.className);
+      const fenceTitle = extractFenceTitle(extractPreCodeMeta(node));
+      return (
+        <MarkdownCodeBlock
+          code={codeBlock.code}
+          language={language}
+          fenceTitle={fenceTitle}
+          theme={resolvedTheme}
+        >
+          <RenderErrorBoundary fallback={<pre {...props}>{children}</pre>}>
+            <Suspense fallback={<pre {...props}>{children}</pre>}>
+              <SuspenseShikiCodeBlock
+                className={codeBlock.className}
+                code={codeBlock.code}
+                themeName={diffThemeName}
+                isStreaming={isStreaming}
+              />
+            </Suspense>
+          </RenderErrorBoundary>
+        </MarkdownCodeBlock>
+      );
+    },
+  };
+}
+
 function ChatMarkdown({
   text,
   cwd,
@@ -1709,27 +2034,21 @@ function ChatMarkdown({
     reportFailure: false,
   });
   const environmentId = threadRef?.environmentId ?? explicitEnvironmentId ?? null;
+  const preparedConnection = usePreparedConnection(environmentId);
   const remoteOpen = useRemoteOpenResolution(environmentId);
   const canUseShellActions = canUseMarkdownFileShellActions(
     environmentId,
     remoteOpen.state.mode,
     remoteOpen.isResolved,
   );
-  const preparedConnection = usePreparedConnection(environmentId);
   const serverConfig = useAtomValue(serverEnvironment.configValueAtom(environmentId));
-  const threadServerConfig = useAtomValue(
-    serverEnvironment.configValueAtom(threadRef?.environmentId ?? environmentId),
-  );
   const projects = useProjects();
   const availableEditors = serverConfig?.availableEditors ?? [];
   const [preferredEditor] = usePreferredEditor(availableEditors);
   const preferredEditorMenuLabel = openInEditorMenuLabel(preferredEditor);
   const openInPreferredEditor = useOpenInPreferredEditor(environmentId, availableEditors);
-  const openInEditor = useAtomCommand(shellEnvironment.openInEditor, {
-    reportFailure: false,
-  });
+  const openInEditor = useAtomCommand(shellEnvironment.openInEditor, { reportFailure: false });
   const revealInFileManagerLabel =
-    environmentId !== null &&
     serverConfig?.shellRevealInFileManager === true &&
     serverConfig.availableEditors.includes("file-manager")
       ? serverConfig.shellRevealInFileManagerKind === undefined
@@ -1807,7 +2126,7 @@ function ChatMarkdown({
       if (
         threadRef === undefined ||
         readThreadShell(threadRef) === null ||
-        threadServerConfig?.environment.capabilities.threadPullRequestLinking !== true
+        serverConfig?.environment.capabilities.threadPullRequestLinking !== true
       ) {
         return null;
       }
@@ -1825,7 +2144,7 @@ function ChatMarkdown({
         url: href,
       };
     },
-    [projects, threadRef, threadServerConfig],
+    [projects, serverConfig, threadRef],
   );
   const updateThreadPullRequestLink = useCallback(
     async (href: string, linked: boolean) => {
@@ -1946,365 +2265,61 @@ function ChatMarkdown({
     },
     [cwd, findWorkspaceBasenameMatch, revealFileInFileManager],
   );
-  /* eslint-disable react/no-unstable-nested-components -- ReactMarkdown requires component
-   * renderers that close over this message's metadata. useMemo keeps them stable until that
-   * metadata changes. */
-  const markdownComponents = useMemo<Components>(() => {
-    const fileLinkChip = (
-      fileLinkMeta: MarkdownFileLinkMeta,
-      copyMarkdown: string,
-      className?: string,
-    ) => {
-      const parentSuffix = fileLinkParentSuffixByPath.get(
-        fileLinkMeta.filePath.replaceAll("\\", "/"),
-      );
-      const labelParts = [fileLinkMeta.basename];
-      if (typeof parentSuffix === "string" && parentSuffix.length > 0) {
-        labelParts.push(parentSuffix);
-      }
-      if (fileLinkMeta.line) {
-        labelParts.push(
-          `L${fileLinkMeta.line}${fileLinkMeta.column ? `:C${fileLinkMeta.column}` : ""}`,
-        );
-      }
-
-      return (
-        <MarkdownFileLink
-          href={fileLinkMeta.targetPath}
-          targetPath={fileLinkMeta.targetPath}
-          iconPath={fileLinkMeta.filePath}
-          displayPath={fileLinkMeta.displayPath}
-          workspaceRelativePath={fileLinkMeta.workspaceRelativePath}
-          line={fileLinkMeta.line}
-          label={labelParts.join(" · ")}
-          copyMarkdown={copyMarkdown}
-          theme={resolvedTheme}
-          threadRef={threadRef}
-          {...(canUseShellActions ? { onOpen: openInPreferredEditor } : {})}
-          onOpenInPanel={openFileInPanel}
-          openInEditorMenuLabel={preferredEditorMenuLabel}
-          onReveal={
-            canUseShellActions && revealInFileManagerLabel !== undefined
-              ? () => revealMarkdownFileInFileManager(fileLinkMeta)
-              : undefined
-          }
-          revealLabel={revealInFileManagerLabel}
-          onOpenInBrowser={
-            threadRef &&
-            isPreviewSupportedInRuntime() &&
-            isBrowserPreviewFile(fileLinkMeta.filePath)
-              ? () => openMarkdownFileInPreview(fileLinkMeta.filePath)
-              : undefined
-          }
-          className={className}
-        />
-      );
-    };
-
-    return {
-      p({ node: _node, children, ...props }) {
-        return <p {...props}>{renderSkillInlineMarkdownChildren(children, skills)}</p>;
-      },
-      blockquote({ node: _node, children, ...props }) {
-        const alert =
-          GITHUB_ALERT_PRESENTATIONS[
-            String((props as Record<string, unknown>)["data-alert"] ?? "")
-          ];
-        if (!alert) {
-          return <blockquote {...props}>{children}</blockquote>;
-        }
-        // Not a <blockquote>: the stylesheet mutes those, and an alert's body is ordinary
-        // text under a colored title — which is how the host renders it.
-        return (
-          <div role="note" className={cn("my-1 border-l-2 pl-3", alert.borderClassName)}>
-            <p className={cn("flex items-center gap-1.5 font-medium", alert.titleClassName)}>
-              <alert.Icon aria-hidden className="size-3.5 shrink-0" />
-              {alert.label}
-            </p>
-            {children}
-          </div>
-        );
-      },
-      ol({ node, start, style, ...props }) {
-        const itemCount =
-          node?.children?.filter((child) => child.type === "element" && child.tagName === "li")
-            .length ?? 0;
-        const gutterStyle = orderedListGutterStyle(itemCount, start);
-        return (
-          <ol {...props} start={start} style={gutterStyle ? { ...style, ...gutterStyle } : style} />
-        );
-      },
-      li({ node, children, ...props }) {
-        const listItemStart = node?.position?.start.offset;
-        const markerOffset =
-          typeof listItemStart === "number" ? findTaskListMarkerOffset(text, listItemStart) : null;
-        return (
-          <li {...props} data-task-marker-offset={markerOffset ?? undefined}>
-            {renderSkillInlineMarkdownChildren(children, skills)}
-          </li>
-        );
-      },
-      input({ node: _node, type, checked, disabled: _disabled, ...props }) {
-        if (type !== "checkbox" || !onTaskListChange) {
-          return (
-            <input
-              {...props}
-              type={type}
-              checked={checked}
-              disabled={_disabled}
-              readOnly={type === "checkbox"}
-            />
-          );
-        }
-        return (
-          <input
-            {...props}
-            type="checkbox"
-            name="markdown-task"
-            aria-label="Toggle task"
-            checked={checked}
-            onChange={(event) => {
-              const markerOffset = Number(
-                event.currentTarget.closest("li")?.dataset.taskMarkerOffset,
-              );
-              if (!Number.isSafeInteger(markerOffset)) return;
-              onTaskListChange({ markerOffset, checked: event.currentTarget.checked });
-            }}
-          />
-        );
-      },
-      a({ node, href, children, title: _title, ...props }) {
-        const normalizedHref = href ? normalizeMarkdownLinkHrefKey(href) : "";
-        const fileLinkMeta = normalizedHref
-          ? (markdownFileLinkMetaByHref.get(normalizedHref) ??
-            resolveMarkdownFileLinkMeta(normalizedHref, cwd))
-          : null;
-        if (!fileLinkMeta) {
-          const faviconHost = resolveExternalWebLinkHost(href);
-          const isSameDocumentLink = href?.startsWith("#") ?? false;
-          const onClick = props.onClick;
-          const canOpenInPreview = Boolean(threadRef) && isPreviewSupportedInRuntime();
-          const link = (
-            <a
-              {...props}
-              href={href}
-              target={isSameDocumentLink ? undefined : "_blank"}
-              rel={isSameDocumentLink ? undefined : "noopener noreferrer"}
-              onClick={(event) => {
-                onClick?.(event);
-                if (isSameDocumentLink && href) {
-                  handleMarkdownFragmentClick(event, href);
-                  return;
-                }
-                // A link to a change request in a workspace project opens beside the
-                // conversation instead of in a browser: it is the thing being talked about, and
-                // the panel it opens offers the browser as one of its actions. Anything else is
-                // an ordinary link and keeps the `_blank` the shell already handles.
-                if (href) openChangeRequestLink(event, href);
-              }}
-              onContextMenu={(event) => {
-                if (!href || !faviconHost) return;
-                event.preventDefault();
-                event.stopPropagation();
-                const api = readLocalApi();
-                if (!api) return;
-                const pullRequest = resolveThreadPullRequest(href);
-                const currentPullRequest =
-                  threadRef === undefined ? null : readThreadShell(threadRef)?.linkedPullRequest;
-                const threadLinkAction =
-                  currentPullRequest != null &&
-                  matchesLinkedPullRequestUrl(currentPullRequest, href)
-                    ? "unlink-from-thread"
-                    : pullRequest === null
-                      ? undefined
-                      : "link-to-thread";
-                void showExternalLinkContextMenu({
-                  href,
-                  canOpenInPreview,
-                  threadLinkAction,
-                  position: { x: event.clientX, y: event.clientY },
-                  showContextMenu: (items, position) => api.contextMenu.show(items, position),
-                  openInPreview: async (target) => {
-                    const result = await openExternalLinkInPreview(target);
-                    if (result._tag === "Failure" && !isAtomCommandInterrupted(result)) {
-                      reportMarkdownActionFailure(
-                        { operation: "open-link-in-preview", target },
-                        result.cause,
-                      );
-                    }
-                  },
-                  openExternal: (target) => api.shell.openExternal(target),
-                  copyLink: (target) => writeTextToClipboard(target, "link"),
-                  updateThreadLink: updateThreadPullRequestLink,
-                  reportFailure: (operation, cause) => {
-                    reportMarkdownActionFailure({ operation, target: href }, cause);
-                    if (
-                      operation === "link-pull-request-to-thread" ||
-                      operation === "unlink-pull-request-from-thread"
-                    ) {
-                      toastManager.add(
-                        stackedThreadToast({
-                          type: "error",
-                          title:
-                            operation === "link-pull-request-to-thread"
-                              ? "Unable to link pull request"
-                              : "Unable to unlink pull request",
-                          description:
-                            cause instanceof Error ? cause.message : "The request failed.",
-                        }),
-                      );
-                    }
-                  },
-                });
-              }}
-            >
-              {faviconHost && hastHasText(node) ? (
-                <MarkdownExternalLinkContent host={faviconHost} plainText={plainHastText(node)}>
-                  {children}
-                </MarkdownExternalLinkContent>
-              ) : (
-                children
-              )}
-            </a>
-          );
-          if (!faviconHost || !href) {
-            return link;
-          }
-          return (
-            <Tooltip>
-              <TooltipTrigger render={link} />
-              <TooltipPopup
-                side="top"
-                className="max-w-[min(36rem,calc(100vw-2rem))] whitespace-normal leading-tight wrap-anywhere"
-              >
-                {href}
-              </TooltipPopup>
-            </Tooltip>
-          );
-        }
-
-        return fileLinkChip(
-          fileLinkMeta,
-          `[${fileLinkMeta.basename}](${normalizedHref})`,
-          props.className,
-        );
-      },
-      code({ node, children, className, ...props }) {
-        if (node?.properties?.dataInlineCode != null) {
-          const codeText = nodeToPlainText(children);
-          const fileLinkMeta =
-            inlineCodeFileLinkMetaByText.get(codeText.trim()) ??
-            resolveInlineCodeFileLinkMeta(codeText, cwd);
-          if (fileLinkMeta) {
-            return fileLinkChip(fileLinkMeta, `\`${codeText}\``);
-          }
-        }
-        return (
-          <code {...props} className={className}>
-            {children}
-          </code>
-        );
-      },
-      img({ node, title, src, alt, ...props }) {
-        const localSrc = node?.properties?.dataLocalSrc;
-        const markdownTitle = node?.properties?.dataMarkdownTitle;
-        const authoredSrc = typeof localSrc === "string" ? localSrc : src;
-        const authoredTitle = typeof markdownTitle === "string" ? markdownTitle : title;
-        const srcString =
-          typeof authoredSrc === "string" ? normalizeMarkdownLinkDestination(authoredSrc) : "";
-        const classifiedSrc =
-          typeof localSrc === "string" ? srcString.replaceAll("\\", "/") : srcString;
-        const altText = alt ?? "";
-        const copyMarkdown = markdownImageCopy(altText, srcString, authoredTitle);
-        const authoredSizeStyle = authoredImageSizeStyle(props.width, props.height);
-        const imageSource = classifyMarkdownImageSource(classifiedSrc, imageBaseDir ?? cwd);
-        if (imageSource._tag === "Direct") {
-          return (
-            <img
-              {...props}
-              src={imageSource.uri}
-              alt={altText}
-              loading="lazy"
-              className={cn(props.className, CHAT_MARKDOWN_IMAGE_SIZE_CLASS_NAME)}
-              style={authoredSizeStyle}
-            />
-          );
-        }
-        if (imageSource._tag === "WorkspaceFile" && threadRef) {
-          return (
-            <ChatMarkdownWorkspaceImage
-              threadRef={threadRef}
-              path={imageSource.path}
-              alt={altText}
-              copyMarkdown={copyMarkdown}
-              srcFragment={markdownImageSourceFragment(classifiedSrc)}
-              style={authoredSizeStyle}
-            />
-          );
-        }
-        return <ChatMarkdownImageFallback alt={altText} copyMarkdown={copyMarkdown} />;
-      },
-      table({ node: _node, ...props }) {
-        return <MarkdownTable {...props} />;
-      },
-      details({ node: _node, children, open: detailsOpen }) {
-        return <MarkdownDetails open={detailsOpen}>{children}</MarkdownDetails>;
-      },
-      pre({ node, children, ...props }) {
-        const codeBlock = extractCodeBlock(children);
-        if (!codeBlock) {
-          return <pre {...props}>{children}</pre>;
-        }
-
-        const language = extractFenceLanguage(codeBlock.className);
-        const fenceTitle = extractFenceTitle(extractPreCodeMeta(node));
-        return (
-          <MarkdownCodeBlock
-            code={codeBlock.code}
-            language={language}
-            fenceTitle={fenceTitle}
-            theme={resolvedTheme}
-          >
-            <RenderErrorBoundary fallback={<pre {...props}>{children}</pre>}>
-              <Suspense fallback={<pre {...props}>{children}</pre>}>
-                <SuspenseShikiCodeBlock
-                  className={codeBlock.className}
-                  code={codeBlock.code}
-                  themeName={diffThemeName}
-                  isStreaming={isStreaming}
-                />
-              </Suspense>
-            </RenderErrorBoundary>
-          </MarkdownCodeBlock>
-        );
-      },
-    };
-  }, [
-    canUseShellActions,
-    cwd,
-    diffThemeName,
-    fileLinkParentSuffixByPath,
-    inlineCodeFileLinkMetaByText,
-    imageBaseDir,
-    isStreaming,
-    markdownFileLinkMetaByHref,
-    onTaskListChange,
-    openFileInPanel,
-    openInPreferredEditor,
-    openChangeRequestLink,
-    openExternalLinkInPreview,
-    openMarkdownFileInPreview,
-    preferredEditorMenuLabel,
-    resolveThreadPullRequest,
-    resolvedTheme,
-    revealMarkdownFileInFileManager,
-    revealInFileManagerLabel,
-    skills,
-    text,
-    threadRef,
-    updateThreadPullRequestLink,
-  ]);
-  /* eslint-enable react/no-unstable-nested-components */
+  const markdownComponents = useMemo<Components>(
+    () =>
+      createChatMarkdownComponents({
+        cwd,
+        imageBaseDir,
+        diffThemeName,
+        fileLinkParentSuffixByPath,
+        inlineCodeFileLinkMetaByText,
+        isStreaming,
+        markdownFileLinkMetaByHref,
+        onTaskListChange,
+        onOpenFileInPanel: openFileInPanel,
+        openInPreferredEditor: canUseShellActions ? openInPreferredEditor : undefined,
+        openInEditorMenuLabel: preferredEditorMenuLabel,
+        revealInFileManagerLabel,
+        revealMarkdownFileInFileManager:
+          canUseShellActions && revealInFileManagerLabel
+            ? revealMarkdownFileInFileManager
+            : undefined,
+        openExternalLinkInPreview,
+        openMarkdownFileInPreview,
+        openChangeRequestLink,
+        resolveThreadPullRequest,
+        updateThreadPullRequestLink,
+        resolvedTheme,
+        skills,
+        text,
+        threadRef,
+      }),
+    [
+      cwd,
+      imageBaseDir,
+      diffThemeName,
+      fileLinkParentSuffixByPath,
+      inlineCodeFileLinkMetaByText,
+      isStreaming,
+      markdownFileLinkMetaByHref,
+      onTaskListChange,
+      canUseShellActions,
+      openFileInPanel,
+      preferredEditorMenuLabel,
+      revealInFileManagerLabel,
+      revealMarkdownFileInFileManager,
+      openInPreferredEditor,
+      openExternalLinkInPreview,
+      openMarkdownFileInPreview,
+      openChangeRequestLink,
+      resolveThreadPullRequest,
+      resolvedTheme,
+      skills,
+      text,
+      threadRef,
+      updateThreadPullRequestLink,
+    ],
+  );
 
   // react-markdown converts unparsed HTML nodes to text when skipHtml is false.
   // Keep that behavior explicit because literal mode depends on escaping the
diff --git a/apps/web/src/components/ChatMarkdown.workspace-images.test.tsx b/apps/web/src/components/ChatMarkdown.workspace-images.test.tsx
index 39ea214d43c3..9ab86d1835d5 100644
--- a/apps/web/src/components/ChatMarkdown.workspace-images.test.tsx
+++ b/apps/web/src/components/ChatMarkdown.workspace-images.test.tsx
@@ -5,6 +5,8 @@ import { beforeEach, describe, expect, it, vi } from "vite-plus/test";
 const testState = vi.hoisted(() => ({
   resources: [] as Array<unknown>,
   assetState: "success" as "success" | "loading" | "failure",
+  editorEnvironmentIds: [] as Array<unknown>,
+  remoteEnvironmentIds: [] as Array<unknown>,
 }));
 
 vi.mock("@effect/atom-react", () => ({ useAtomValue: () => null }));
@@ -23,23 +25,23 @@ vi.mock("../state/session", async (importOriginal) => ({
   ...(await importOriginal<typeof import("../state/session")>()),
   usePreparedConnection: () => ({ _tag: "Loading" }),
 }));
-vi.mock("../state/entities", () => ({
-  readThreadShell: () => null,
-  useProjects: () => [],
-}));
-vi.mock("../remoteOpen", () => ({
-  useRemoteOpenResolution: () => ({ state: { mode: "local-exec" }, isResolved: true }),
-}));
 vi.mock("../editorPreferences", () => ({
-  useOpenInPreferredEditor: () => vi.fn(),
-  usePreferredEditor: () => [null, vi.fn()],
+  useOpenInPreferredEditor: (environmentId: unknown) => {
+    testState.editorEnvironmentIds.push(environmentId);
+    return vi.fn();
+  },
+  usePreferredEditor: () => ["vscode", vi.fn()],
 }));
-vi.mock("~/lib/openPullRequestLink", () => ({
-  findProjectForChangeRequest: () => undefined,
-  matchesLinkedPullRequestUrl: () => false,
-  parseChangeRequestUrl: () => null,
-  useOpenChangeRequestLink: () => vi.fn(),
+vi.mock("../remoteOpen", () => ({
+  useRemoteOpenResolution: (environmentId: unknown) => {
+    testState.remoteEnvironmentIds.push(environmentId);
+    return {
+      isResolved: true,
+      state: { mode: "local-exec", localExecutionUnavailableReason: null },
+    };
+  },
 }));
+vi.mock("~/lib/openPullRequestLink", () => ({ useOpenChangeRequestLink: () => vi.fn() }));
 
 import ChatMarkdown from "./ChatMarkdown";
 import { FileMarkdownPreview } from "./files/FileMarkdownPreview";
@@ -91,6 +93,8 @@ describe("ChatMarkdown workspace images", () => {
   beforeEach(() => {
     testState.resources = [];
     testState.assetState = "success";
+    testState.editorEnvironmentIds = [];
+    testState.remoteEnvironmentIds = [];
   });
 
   it.each([
@@ -113,16 +117,8 @@ describe("ChatMarkdown workspace images", () => {
     ]);
   });
 
-  it("loads every Windows workspace path form through a signed asset URL", () => {
-    const imagePath = "C:/Users/shawn/project/.t3/workspace-image.svg";
-    const html = render(
-      [
-        "![relative](.t3/workspace-image.svg)",
-        `![absolute](${imagePath})`,
-        `![file URL](file:///${imagePath})`,
-        "![UNC file URL](file://server/share/workspace-image.svg)",
-      ].join("\n\n"),
-    );
+  it("loads relative workspace paths through signed asset URLs", () => {
+    const html = render("![relative](.t3/workspace-image.svg)");
 
     expect(testState.resources).toEqual([
       {
@@ -130,31 +126,36 @@ describe("ChatMarkdown workspace images", () => {
         threadId: threadRef.threadId,
         path: "C:\\Users\\shawn\\project\\.t3\\workspace-image.svg",
       },
-      { _tag: "workspace-file", threadId: threadRef.threadId, path: imagePath },
-      { _tag: "workspace-file", threadId: threadRef.threadId, path: imagePath },
-      {
-        _tag: "workspace-file",
-        threadId: threadRef.threadId,
-        path: "\\\\server\\share\\workspace-image.svg",
-      },
     ]);
-    expect(html.match(/https:\/\/signed\.test\/workspace-image\.svg/g)).toHaveLength(4);
-    expect(html.match(/max-w-\[min\(100%,30rem\)\]/g)).toHaveLength(4);
-    expect(html.match(/max-h-\[30rem\]/g)).toHaveLength(4);
-    expect(html).not.toContain("Image unavailable");
+    expect(html).toContain("https://signed.test/workspace-image.svg");
   });
 
-  it("normalizes a drive-absolute src in raw image HTML", () => {
-    const html = render(String.raw`<img src="D:\screens\workspace-image.svg" alt="raw">`);
+  it("preserves Windows drive links through markdown sanitization", () => {
+    const html = render(String.raw`[Open](C:\Users\shawn\project\src\main.ts)`);
+    expect(html).toContain('href="C:/Users/shawn/project/src/main.ts"');
+    expect(html).toContain("chat-markdown-file-link");
+  });
 
+  it("loads drive-absolute markdown and raw HTML images through assets", () => {
+    const html = render(
+      [
+        "![absolute](C:/Users/shawn/project/.t3/workspace-image.svg)",
+        String.raw`<img src="D:\screens\workspace-image.svg" alt="raw">`,
+      ].join("\n\n"),
+    );
     expect(testState.resources).toEqual([
+      {
+        _tag: "workspace-file",
+        threadId: threadRef.threadId,
+        path: "C:/Users/shawn/project/.t3/workspace-image.svg",
+      },
       {
         _tag: "workspace-file",
         threadId: threadRef.threadId,
         path: "D:/screens/workspace-image.svg",
       },
     ]);
-    expect(html).toContain("https://signed.test/workspace-image.svg");
+    expect(html.match(/https:\/\/signed\.test\/workspace-image\.svg/g)).toHaveLength(2);
   });
 
   it("keeps a tall image placeholder and loaded image at the same proportional bounds", () => {
@@ -260,7 +261,6 @@ describe("ChatMarkdown workspace images", () => {
 
   it("uses a static bounded-width placeholder while a signed asset URL loads", () => {
     testState.assetState = "loading";
-
     const html = render("![loading](.t3/workspace-image.svg)");
     const className = /<span[^>]*aria-label="Loading image"[^>]*class="([^"]*)"/.exec(html)?.[1];
 
@@ -269,31 +269,25 @@ describe("ChatMarkdown workspace images", () => {
     expect(className?.split(" ")).toContain("w-64");
   });
 
-  it("never passes a workspace source to a raw image when thread context is unavailable", () => {
-    const html = renderWithoutThread(
-      "![file URL](file:///C:/Users/shawn/project/workspace-image.svg)",
-    );
-
-    expect(testState.resources).toEqual([]);
-    expect(html).toContain("Image unavailable");
-    expect(html).not.toContain("file://");
-  });
-
-  it("blocks unsupported image schemes instead of passing them to a raw image", () => {
-    const html = render("![unsupported](content://media/image/1)");
-
-    expect(testState.resources).toEqual([]);
-    expect(html).toContain("Image unavailable");
-    expect(html).not.toContain("content://");
-  });
-
   it("keeps remote images directly loadable", () => {
     const html = render("![remote](https://example.com/image.png)");
-
     expect(testState.resources).toEqual([]);
     expect(html).toContain('src="https://example.com/image.png"');
-    expect(html).toContain("max-w-[min(100%,30rem)]");
     expect(html).toContain("max-h-[30rem]");
-    expect(html).not.toContain("Image unavailable");
+  });
+
+  it("uses the markdown owner's environment for file actions", () => {
+    const owningEnvironmentId = EnvironmentId.make("env-pull-request");
+
+    renderToStaticMarkup(
+      <ChatMarkdown
+        cwd="/workspace/project"
+        environmentId={owningEnvironmentId}
+        text="[Open](src/main.ts)"
+      />,
+    );
+
+    expect(testState.editorEnvironmentIds).toEqual([owningEnvironmentId]);
+    expect(testState.remoteEnvironmentIds).toEqual([owningEnvironmentId]);
   });
 });
diff --git a/apps/web/src/components/ChatView.logic.test.ts b/apps/web/src/components/ChatView.logic.test.ts
index 6586c62d2f13..32109983f3af 100644
--- a/apps/web/src/components/ChatView.logic.test.ts
+++ b/apps/web/src/components/ChatView.logic.test.ts
@@ -4,38 +4,35 @@ import {
   ProjectId,
   ProviderInstanceId,
   ThreadId,
-  TurnId,
+  RunId,
+  TurnItemId,
+  type OrchestrationV2ProjectedTurnItem,
 } from "@t3tools/contracts";
-import { afterEach, describe, expect, it, vi } from "vite-plus/test";
+import * as DateTime from "effect/DateTime";
+import { describe, expect, it } from "vite-plus/test";
 
-import type { Thread, ThreadShell } from "../types";
+import type { Thread } from "../types";
+import { makeThreadFixture } from "../test-fixtures";
 import {
   MAX_HIDDEN_MOUNTED_PREVIEW_THREADS,
   MAX_HIDDEN_MOUNTED_TERMINAL_THREADS,
   branchMismatchKey,
   buildExpiredTerminalContextToastCopy,
-  buildLoadingThreadFromShell,
-  buildThreadTurnInterruptInput,
   createLocalDispatchSnapshot,
+  deriveCommittedServerUserMessageIds,
   deriveComposerSendState,
   dismissBranchMismatchForSession,
-  ENVIRONMENT_RECONNECT_WARNING_GRACE_MS,
   getStartedThreadModelChangeBlockReason,
-  hasEnvironmentReconnectWarningGraceElapsed,
   hasServerAcknowledgedLocalDispatch,
   isBranchMismatchDismissedForSession,
   reconcileMountedTerminalThreadIds,
   reconcileRetainedMountedThreadIds,
-  resolveBackgroundDraftWorkspaceOptions,
-  resolveDraftPromotionNavigationTarget,
+  resolveEffectiveInteractionMode,
   resolveThreadMetadataUpdateForNextTurn,
   resolveSendEnvMode,
-  resolveDraftHeroState,
-  scheduleEnvironmentReconnectWarning,
   startNewThreadForProject,
-  shouldDockDraftHeroForSubmission,
-  shouldReleaseTimelineAnchorForToolActivity,
   shouldShowBranchMismatchBanner,
+  shouldShowComposerContextStrip,
   shouldShowPlanFollowUpPrompt,
   shouldWriteThreadErrorToCurrentServerThread,
 } from "./ChatView.logic";
@@ -45,186 +42,8 @@ const projectId = ProjectId.make("project-1");
 const threadId = ThreadId.make("thread-1");
 const now = "2026-03-29T00:00:00.000Z";
 
-describe("draft hero submission transition", () => {
-  it("does not dock the composer before a background submission", () => {
-    expect(
-      shouldDockDraftHeroForSubmission({
-        isDraftHeroState: true,
-        activeThreadKey: "environment-local:thread-1",
-        submissionIntent: "background",
-      }),
-    ).toBe(false);
-  });
-
-  it("keeps the composer in the hero layout until navigation after server promotion", () => {
-    expect(
-      resolveDraftHeroState({
-        isLocalDraftThread: false,
-        hasTimelineEntries: true,
-        isWorking: true,
-        draftHeroDockRequested: false,
-        backgroundSubmissionPending: true,
-      }),
-    ).toBe(true);
-  });
-
-  it("does not auto-navigate a background submission after server promotion", () => {
-    expect(
-      resolveDraftPromotionNavigationTarget({
-        serverThreadRef: { environmentId, threadId },
-        serverThreadStarted: true,
-        backgroundSubmissionPending: true,
-      }),
-    ).toBeNull();
-  });
-});
-
-describe("shouldReleaseTimelineAnchorForToolActivity", () => {
-  const activeTurnId = TurnId.make("active-turn");
-  const anchorMessageId = MessageId.make("anchored-message");
-  const activeToolEntry = {
-    id: "tool-entry",
-    kind: "work" as const,
-    createdAt: now,
-    entry: {
-      id: "active-tool",
-      createdAt: now,
-      turnId: activeTurnId,
-      label: "Run command",
-      tone: "tool" as const,
-      command: "git status",
-    },
-  };
-
-  it("releases the send anchor for tool activity in the active turn", () => {
-    expect(
-      shouldReleaseTimelineAnchorForToolActivity({
-        anchorMessageId,
-        liveFollowEnabled: true,
-        runningTurnId: activeTurnId,
-        timelineEntries: [activeToolEntry],
-      }),
-    ).toBe(true);
-  });
-
-  it("keeps the anchor while the user reads history", () => {
-    expect(
-      shouldReleaseTimelineAnchorForToolActivity({
-        anchorMessageId,
-        liveFollowEnabled: false,
-        runningTurnId: activeTurnId,
-        timelineEntries: [activeToolEntry],
-      }),
-    ).toBe(false);
-  });
-
-  it("ignores tool activity from earlier turns", () => {
-    expect(
-      shouldReleaseTimelineAnchorForToolActivity({
-        anchorMessageId,
-        liveFollowEnabled: true,
-        runningTurnId: activeTurnId,
-        timelineEntries: [
-          {
-            ...activeToolEntry,
-            entry: {
-              ...activeToolEntry.entry,
-              turnId: TurnId.make("previous-turn"),
-            },
-          },
-        ],
-      }),
-    ).toBe(false);
-  });
-
-  it("ignores thinking and error rows without tool activity", () => {
-    expect(
-      shouldReleaseTimelineAnchorForToolActivity({
-        anchorMessageId,
-        liveFollowEnabled: true,
-        runningTurnId: activeTurnId,
-        timelineEntries: [
-          {
-            ...activeToolEntry,
-            entry: {
-              id: "thinking-entry",
-              createdAt: now,
-              turnId: activeTurnId,
-              label: "Thinking",
-              tone: "thinking",
-            },
-          },
-          {
-            ...activeToolEntry,
-            id: "error-entry",
-            entry: {
-              id: "error-entry",
-              createdAt: now,
-              turnId: activeTurnId,
-              label: "Provider error",
-              tone: "error",
-            },
-          },
-        ],
-      }),
-    ).toBe(false);
-  });
-
-  it("does nothing without an anchor or running turn", () => {
-    const input = {
-      anchorMessageId,
-      liveFollowEnabled: true,
-      runningTurnId: activeTurnId,
-      timelineEntries: [activeToolEntry],
-    };
-
-    expect(shouldReleaseTimelineAnchorForToolActivity({ ...input, anchorMessageId: null })).toBe(
-      false,
-    );
-    expect(shouldReleaseTimelineAnchorForToolActivity({ ...input, runningTurnId: null })).toBe(
-      false,
-    );
-  });
-});
-
-describe("environment reconnect warning grace", () => {
-  afterEach(() => vi.useRealTimers());
-
-  it("shows a persistent reconnect after the grace period", () => {
-    vi.useFakeTimers();
-    const showWarning = vi.fn();
-
-    scheduleEnvironmentReconnectWarning(showWarning);
-    vi.advanceTimersByTime(ENVIRONMENT_RECONNECT_WARNING_GRACE_MS - 1);
-    expect(showWarning).not.toHaveBeenCalled();
-
-    vi.advanceTimersByTime(1);
-    expect(showWarning).toHaveBeenCalledOnce();
-  });
-
-  it("cancels the warning when the connection recovers during the grace period", () => {
-    vi.useFakeTimers();
-    const showWarning = vi.fn();
-
-    const cancel = scheduleEnvironmentReconnectWarning(showWarning);
-    cancel();
-    vi.advanceTimersByTime(ENVIRONMENT_RECONNECT_WARNING_GRACE_MS);
-
-    expect(showWarning).not.toHaveBeenCalled();
-  });
-
-  it("does not reuse elapsed grace from another environment", () => {
-    const anotherEnvironmentId = EnvironmentId.make("environment-remote");
-
-    expect(hasEnvironmentReconnectWarningGraceElapsed(environmentId, environmentId)).toBe(true);
-    expect(hasEnvironmentReconnectWarningGraceElapsed(anotherEnvironmentId, environmentId)).toBe(
-      false,
-    );
-  });
-});
-
 function makeThread(overrides: Partial<Thread> = {}): Thread {
-  return {
+  return makeThreadFixture({
     id: threadId,
     environmentId,
     projectId,
@@ -235,27 +54,25 @@ function makeThread(overrides: Partial<Thread> = {}): Thread {
     },
     runtimeMode: "full-access",
     interactionMode: "default",
-    session: null,
+    runtime: null,
     messages: [],
     proposedPlans: [],
-    activities: [],
-    checkpoints: [],
     createdAt: now,
     updatedAt: now,
     archivedAt: null,
     settledOverride: null,
     settledAt: null,
     deletedAt: null,
-    latestTurn: null,
+    latestRun: null,
     branch: null,
     worktreePath: null,
     ...overrides,
-  };
+  });
 }
 
 const completedTurn = {
-  turnId: TurnId.make("turn-1"),
-  state: "completed" as const,
+  runId: RunId.make("turn-1"),
+  status: "completed" as const,
   requestedAt: now,
   startedAt: "2026-03-29T00:00:01.000Z",
   completedAt: "2026-03-29T00:00:10.000Z",
@@ -263,58 +80,33 @@ const completedTurn = {
 };
 
 const readySession = {
-  threadId,
-  status: "ready" as const,
+  status: "completed" as const,
   providerName: "codex",
   providerInstanceId: ProviderInstanceId.make("codex"),
-  runtimeMode: "full-access" as const,
-  activeTurnId: null,
+  activeRunId: null,
   lastError: null,
   updatedAt: "2026-03-29T00:00:10.000Z",
 };
 
-describe("buildLoadingThreadFromShell", () => {
-  it("preserves shell metadata and supplies empty detail collections", () => {
-    const shell = {
-      environmentId,
-      id: threadId,
-      projectId,
-      title: "Loading thread",
-      modelSelection: {
-        instanceId: ProviderInstanceId.make("codex"),
-        model: "gpt-5.4",
-      },
-      runtimeMode: "full-access",
-      interactionMode: "default",
-      branch: "main",
-      worktreePath: null,
-      latestTurn: null,
-      createdAt: now,
-      updatedAt: now,
-      archivedAt: null,
-      settledOverride: null,
-      settledAt: null,
-      snoozedUntil: null,
-      snoozedAt: null,
-      session: null,
-      latestUserMessageAt: now,
-      hasPendingApprovals: false,
-      hasPendingUserInput: false,
-      hasActionableProposedPlan: false,
-    } satisfies ThreadShell;
-
-    expect(buildLoadingThreadFromShell(shell)).toMatchObject({
-      environmentId,
-      id: threadId,
-      projectId,
-      title: "Loading thread",
-      branch: "main",
-      deletedAt: null,
-      messages: [],
-      proposedPlans: [],
-      activities: [],
-      checkpoints: [],
-    });
+describe("resolveEffectiveInteractionMode", () => {
+  it("forces build mode when legacy plan mode is disabled", () => {
+    expect(
+      resolveEffectiveInteractionMode({
+        planModeEnabled: false,
+        composerInteractionMode: "plan",
+        threadInteractionMode: "plan",
+      }),
+    ).toBe("default");
+  });
+
+  it("uses the saved mode while legacy plan mode is enabled", () => {
+    expect(
+      resolveEffectiveInteractionMode({
+        planModeEnabled: true,
+        composerInteractionMode: null,
+        threadInteractionMode: "plan",
+      }),
+    ).toBe("plan");
   });
 });
 
@@ -346,30 +138,56 @@ describe("resolveThreadMetadataUpdateForNextTurn", () => {
   });
 });
 
-describe("buildThreadTurnInterruptInput", () => {
-  it("targets the session's active running turn", () => {
-    const activeTurnId = TurnId.make("turn-running");
+describe("shouldShowComposerContextStrip", () => {
+  it("shows git context while composing a new thread", () => {
+    expect(
+      shouldShowComposerContextStrip({
+        isDraftHeroState: true,
+        isGitRepo: true,
+        hasActiveProject: true,
+        persistInActiveThreads: false,
+      }),
+    ).toBe(true);
+  });
 
+  it("keeps git context in an active thread only when requested", () => {
     expect(
-      buildThreadTurnInterruptInput(
-        makeThread({
-          session: {
-            ...readySession,
-            status: "running",
-            activeTurnId,
-          },
-        }),
-      ),
-    ).toEqual({ threadId, turnId: activeTurnId });
-  });
-
-  it("omits a turn id when the session is not running", () => {
-    expect(buildThreadTurnInterruptInput(makeThread({ session: readySession }))).toEqual({
-      threadId,
-    });
+      shouldShowComposerContextStrip({
+        isDraftHeroState: false,
+        isGitRepo: true,
+        hasActiveProject: true,
+        persistInActiveThreads: true,
+      }),
+    ).toBe(true);
+    expect(
+      shouldShowComposerContextStrip({
+        isDraftHeroState: false,
+        isGitRepo: true,
+        hasActiveProject: true,
+        persistInActiveThreads: false,
+      }),
+    ).toBe(false);
   });
-});
 
+  it("hides git context without a git-backed project", () => {
+    expect(
+      shouldShowComposerContextStrip({
+        isDraftHeroState: true,
+        isGitRepo: false,
+        hasActiveProject: true,
+        persistInActiveThreads: true,
+      }),
+    ).toBe(false);
+    expect(
+      shouldShowComposerContextStrip({
+        isDraftHeroState: true,
+        isGitRepo: true,
+        hasActiveProject: false,
+        persistInActiveThreads: true,
+      }),
+    ).toBe(false);
+  });
+});
 describe("deriveComposerSendState", () => {
   it("treats expired terminal pills as non-sendable content", () => {
     const state = deriveComposerSendState({
@@ -501,18 +319,18 @@ describe("getStartedThreadModelChangeBlockReason", () => {
     ).toBeNull();
   });
 
-  it("blocks started-session model changes when either provider requires a new thread", () => {
+  it("blocks started-session model changes for providers that require a new thread", () => {
     expect(
       getStartedThreadModelChangeBlockReason({
         providers,
         hasStartedSession: true,
         currentModelSelection: {
-          instanceId: ProviderInstanceId.make("codex"),
-          model: "gpt-5.4",
+          instanceId: ProviderInstanceId.make("grok"),
+          model: "grok-build",
         },
         nextModelSelection: {
           instanceId: ProviderInstanceId.make("grok"),
-          model: "grok-build",
+          model: "grok-other",
         },
       }),
     ).toEqual({
@@ -530,23 +348,6 @@ describe("resolveSendEnvMode", () => {
   });
 });
 
-describe("resolveBackgroundDraftWorkspaceOptions", () => {
-  it("keeps New worktree selected without reusing the launched worktree", () => {
-    expect(
-      resolveBackgroundDraftWorkspaceOptions({
-        envMode: "worktree",
-        branch: "main",
-        startFromOrigin: true,
-      }),
-    ).toEqual({
-      envMode: "worktree",
-      branch: "main",
-      worktreePath: null,
-      startFromOrigin: true,
-    });
-  });
-});
-
 describe("branchMismatchKey", () => {
   it("builds a key from thread id and both branches", () => {
     expect(branchMismatchKey("thread-1", { threadBranch: "feat/a", currentBranch: "feat/b" })).toBe(
@@ -701,24 +502,19 @@ describe("reconcileRetainedMountedThreadIds", () => {
 });
 
 describe("shouldWriteThreadErrorToCurrentServerThread", () => {
-  it("writes errors for a shell-derived active server thread", () => {
+  it("requires the environment, route thread, and target thread to match", () => {
     const routeThreadRef = { environmentId, threadId };
 
     expect(
       shouldWriteThreadErrorToCurrentServerThread({
-        activeServerThread: { environmentId, id: threadId },
+        serverThread: { environmentId, id: threadId },
         routeThreadRef,
         targetThreadId: threadId,
       }),
     ).toBe(true);
-  });
-
-  it("requires an active server thread matching the environment, route, and target", () => {
-    const routeThreadRef = { environmentId, threadId };
-
     expect(
       shouldWriteThreadErrorToCurrentServerThread({
-        activeServerThread: null,
+        serverThread: null,
         routeThreadRef,
         targetThreadId: threadId,
       }),
@@ -756,39 +552,15 @@ describe("startNewThreadForProject", () => {
 describe("hasServerAcknowledgedLocalDispatch", () => {
   it("does not acknowledge unchanged server state", () => {
     const localDispatch = createLocalDispatchSnapshot(
-      makeThread({ latestTurn: completedTurn, session: readySession }),
+      makeThread({ latestRun: completedTurn, runtime: readySession }),
     );
 
     expect(
       hasServerAcknowledgedLocalDispatch({
         localDispatch,
         phase: "ready",
-        latestTurn: completedTurn,
-        latestUserMessageId: localDispatch.latestUserMessageId,
-        session: readySession,
-        hasPendingApproval: false,
-        hasPendingUserInput: false,
-        threadError: null,
-      }),
-    ).toBe(false);
-  });
-
-  it("keeps a follow-up active while its provider session is starting", () => {
-    const localDispatch = createLocalDispatchSnapshot(
-      makeThread({ latestTurn: completedTurn, session: readySession }),
-    );
-
-    expect(
-      hasServerAcknowledgedLocalDispatch({
-        localDispatch,
-        phase: "connecting",
-        latestTurn: completedTurn,
-        latestUserMessageId: MessageId.make("message-followup"),
-        session: {
-          ...readySession,
-          status: "starting",
-          updatedAt: "2026-03-29T00:01:00.000Z",
-        },
+        latestRun: completedTurn,
+        runtime: readySession,
         hasPendingApproval: false,
         hasPendingUserInput: false,
         threadError: null,
@@ -798,11 +570,11 @@ describe("hasServerAcknowledgedLocalDispatch", () => {
 
   it("acknowledges a settled newer turn", () => {
     const localDispatch = createLocalDispatchSnapshot(
-      makeThread({ latestTurn: completedTurn, session: readySession }),
+      makeThread({ latestRun: completedTurn, runtime: readySession }),
     );
     const newerTurn = {
       ...completedTurn,
-      turnId: TurnId.make("turn-2"),
+      runId: RunId.make("turn-2"),
       requestedAt: "2026-03-29T00:01:00.000Z",
       startedAt: "2026-03-29T00:01:01.000Z",
       completedAt: "2026-03-29T00:01:30.000Z",
@@ -812,9 +584,8 @@ describe("hasServerAcknowledgedLocalDispatch", () => {
       hasServerAcknowledgedLocalDispatch({
         localDispatch,
         phase: "ready",
-        latestTurn: newerTurn,
-        latestUserMessageId: localDispatch.latestUserMessageId,
-        session: { ...readySession, updatedAt: newerTurn.completedAt },
+        latestRun: newerTurn,
+        runtime: { ...readySession, updatedAt: newerTurn.completedAt },
         hasPendingApproval: false,
         hasPendingUserInput: false,
         threadError: null,
@@ -824,12 +595,12 @@ describe("hasServerAcknowledgedLocalDispatch", () => {
 
   it("waits for the matching running turn before acknowledging", () => {
     const localDispatch = createLocalDispatchSnapshot(
-      makeThread({ latestTurn: completedTurn, session: readySession }),
+      makeThread({ latestRun: completedTurn, runtime: readySession }),
     );
     const runningTurn = {
       ...completedTurn,
-      turnId: TurnId.make("turn-2"),
-      state: "running" as const,
+      runId: RunId.make("turn-2"),
+      status: "running" as const,
       requestedAt: "2026-03-29T00:01:00.000Z",
       startedAt: "2026-03-29T00:01:01.000Z",
       completedAt: null,
@@ -839,12 +610,11 @@ describe("hasServerAcknowledgedLocalDispatch", () => {
       hasServerAcknowledgedLocalDispatch({
         localDispatch,
         phase: "running",
-        latestTurn: runningTurn,
-        latestUserMessageId: localDispatch.latestUserMessageId,
-        session: {
+        latestRun: runningTurn,
+        runtime: {
           ...readySession,
           status: "running",
-          activeTurnId: TurnId.make("turn-other"),
+          activeRunId: RunId.make("turn-other"),
         },
         hasPendingApproval: false,
         hasPendingUserInput: false,
@@ -855,12 +625,11 @@ describe("hasServerAcknowledgedLocalDispatch", () => {
       hasServerAcknowledgedLocalDispatch({
         localDispatch,
         phase: "running",
-        latestTurn: runningTurn,
-        latestUserMessageId: localDispatch.latestUserMessageId,
-        session: {
+        latestRun: runningTurn,
+        runtime: {
           ...readySession,
           status: "running",
-          activeTurnId: runningTurn.turnId,
+          activeRunId: runningTurn.runId,
         },
         hasPendingApproval: false,
         hasPendingUserInput: false,
@@ -869,42 +638,29 @@ describe("hasServerAcknowledgedLocalDispatch", () => {
     ).toBe(true);
   });
 
-  it("acknowledges a steering message projected onto the current running turn", () => {
-    const runningTurn = {
+  it("acknowledges a steering message projected onto the current running run", () => {
+    const runningRun = {
       ...completedTurn,
-      state: "running" as const,
+      status: "running" as const,
       completedAt: null,
     };
-    const runningSession = {
+    const runningRuntime = {
       ...readySession,
       status: "running" as const,
-      activeTurnId: runningTurn.turnId,
+      activeRunId: runningRun.runId,
     };
     const localDispatch = createLocalDispatchSnapshot(
-      makeThread({
-        latestTurn: runningTurn,
-        session: runningSession,
-        messages: [
-          {
-            id: MessageId.make("message-before-steer"),
-            role: "user",
-            text: "Initial prompt",
-            turnId: runningTurn.turnId,
-            createdAt: runningTurn.requestedAt,
-            updatedAt: runningTurn.requestedAt,
-            streaming: false,
-          },
-        ],
-      }),
+      makeThread({ latestRun: runningRun, runtime: runningRuntime }),
+      { latestUserMessageId: MessageId.make("message-before-steer") },
     );
 
     expect(
       hasServerAcknowledgedLocalDispatch({
         localDispatch,
         phase: "running",
-        latestTurn: runningTurn,
+        latestRun: runningRun,
         latestUserMessageId: MessageId.make("message-steer"),
-        session: runningSession,
+        runtime: runningRuntime,
         hasPendingApproval: false,
         hasPendingUserInput: false,
         threadError: null,
@@ -917,9 +673,8 @@ describe("hasServerAcknowledgedLocalDispatch", () => {
     const common = {
       localDispatch,
       phase: "ready" as const,
-      latestTurn: null,
-      latestUserMessageId: localDispatch.latestUserMessageId,
-      session: null,
+      latestRun: null,
+      runtime: null,
       hasPendingApproval: false,
       hasPendingUserInput: false,
       threadError: null,
@@ -930,3 +685,103 @@ describe("hasServerAcknowledgedLocalDispatch", () => {
     expect(hasServerAcknowledgedLocalDispatch({ ...common, threadError: "failed" })).toBe(true);
   });
 });
+
+describe("deriveCommittedServerUserMessageIds", () => {
+  it("tracks only committed user turn items, not assistant rows or projection-only messages", () => {
+    const turnStartId = MessageId.make("message-turn-start");
+    const steerId = MessageId.make("message-steer");
+    const assistantId = MessageId.make("message-assistant");
+    const committedAt = DateTime.makeUnsafe("2026-06-26T17:50:15.180Z");
+    const runId = RunId.make("run:thread:thread-1:ordinal:1");
+    const visibleTurnItems: ReadonlyArray<OrchestrationV2ProjectedTurnItem> = [
+      {
+        position: 0,
+        visibility: "local",
+        sourceThreadId: threadId,
+        sourceItemId: TurnItemId.make("turn-item:message-turn-start"),
+        item: {
+          id: TurnItemId.make("turn-item:message-turn-start"),
+          threadId,
+          runId,
+          nodeId: null,
+          providerThreadId: null,
+          providerTurnId: null,
+          nativeItemRef: null,
+          parentItemId: null,
+          ordinal: 1,
+          status: "completed",
+          title: null,
+          startedAt: committedAt,
+          completedAt: committedAt,
+          updatedAt: committedAt,
+          createdBy: "user",
+          creationSource: "web",
+          type: "user_message",
+          messageId: turnStartId,
+          inputIntent: "turn_start",
+          text: "start",
+          attachments: [],
+        },
+      },
+      {
+        position: 1,
+        visibility: "local",
+        sourceThreadId: threadId,
+        sourceItemId: TurnItemId.make("turn-item:message-assistant"),
+        item: {
+          id: TurnItemId.make("turn-item:message-assistant"),
+          threadId,
+          runId,
+          nodeId: null,
+          providerThreadId: null,
+          providerTurnId: null,
+          nativeItemRef: null,
+          parentItemId: null,
+          ordinal: 2,
+          status: "completed",
+          title: null,
+          startedAt: committedAt,
+          completedAt: committedAt,
+          updatedAt: committedAt,
+          type: "assistant_message",
+          messageId: assistantId,
+          text: "working",
+          streaming: false,
+        },
+      },
+      {
+        position: 2,
+        visibility: "local",
+        sourceThreadId: threadId,
+        sourceItemId: TurnItemId.make("turn-item:message-steer"),
+        item: {
+          id: TurnItemId.make("turn-item:message-steer"),
+          threadId,
+          runId,
+          nodeId: null,
+          providerThreadId: null,
+          providerTurnId: null,
+          nativeItemRef: null,
+          parentItemId: null,
+          ordinal: 3,
+          status: "completed",
+          title: null,
+          startedAt: committedAt,
+          completedAt: committedAt,
+          updatedAt: committedAt,
+          createdBy: "user",
+          creationSource: "web",
+          type: "user_message",
+          messageId: steerId,
+          inputIntent: "steer",
+          text: "continue",
+          attachments: [],
+        },
+      },
+    ];
+
+    expect(deriveCommittedServerUserMessageIds(visibleTurnItems)).toEqual(
+      new Set([turnStartId, steerId]),
+    );
+  });
+});
diff --git a/apps/web/src/components/ChatView.logic.ts b/apps/web/src/components/ChatView.logic.ts
index b435e7021c9b..a361f4c3722e 100644
--- a/apps/web/src/components/ChatView.logic.ts
+++ b/apps/web/src/components/ChatView.logic.ts
@@ -4,14 +4,17 @@ import {
   ProjectId,
   type MessageId,
   type ModelSelection,
+  type OrchestrationV2ProjectedTurnItem,
   type ProviderInteractionMode,
   type ProviderDriverKind,
   type ServerProvider,
   type ScopedProjectRef,
   type ScopedThreadRef,
   type ThreadId,
-  type TurnId,
+  type RunId,
 } from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+import { presentThreadShell } from "@t3tools/client-runtime/state/shell";
 import {
   type ChatMessage,
   isImageAttachment,
@@ -22,7 +25,8 @@ import {
 import { type ComposerImageAttachment, type DraftThreadState } from "../composerDraftStore";
 import * as Schema from "effect/Schema";
 import { appAtomRegistry } from "../rpc/atomRegistry";
-import { environmentThreadDetails } from "../state/threads";
+import { environmentThreadShells } from "../state/threads";
+import { waitForAtomValue } from "../state/waitForAtomValue";
 import {
   filterTerminalContextsWithText,
   stripInlineTerminalContextPlaceholders,
@@ -39,6 +43,15 @@ export const ENVIRONMENT_RECONNECT_WARNING_GRACE_MS = 2_000;
 
 export const LastInvokedScriptByProjectSchema = Schema.Record(ProjectId, Schema.String);
 
+export function resolveEffectiveInteractionMode(input: {
+  planModeEnabled: boolean;
+  composerInteractionMode: ProviderInteractionMode | null;
+  threadInteractionMode: ProviderInteractionMode | null | undefined;
+}): ProviderInteractionMode {
+  if (!input.planModeEnabled) return "default";
+  return input.composerInteractionMode ?? input.threadInteractionMode ?? "default";
+}
+
 export function shouldDockDraftHeroForSubmission(input: {
   isDraftHeroState: boolean;
   activeThreadKey: string | null;
@@ -51,31 +64,6 @@ export function shouldDockDraftHeroForSubmission(input: {
   );
 }
 
-export function shouldReleaseTimelineAnchorForToolActivity(input: {
-  anchorMessageId: MessageId | null;
-  liveFollowEnabled: boolean;
-  runningTurnId: TurnId | null;
-  timelineEntries: ReadonlyArray<TimelineEntry>;
-}): boolean {
-  if (input.anchorMessageId === null || !input.liveFollowEnabled || input.runningTurnId === null) {
-    return false;
-  }
-
-  return input.timelineEntries.some((timelineEntry) => {
-    if (timelineEntry.kind !== "work" || timelineEntry.entry.turnId !== input.runningTurnId) {
-      return false;
-    }
-
-    const entry = timelineEntry.entry;
-    return (
-      entry.tone === "tool" ||
-      entry.itemType !== undefined ||
-      entry.requestKind !== undefined ||
-      (entry.command?.trim().length ?? 0) > 0
-    );
-  });
-}
-
 export function resolveDraftHeroState(input: {
   isLocalDraftThread: boolean;
   hasTimelineEntries: boolean;
@@ -159,44 +147,42 @@ export function buildLocalDraftThread(
   draftThread: DraftThreadState,
   fallbackModelSelection: ModelSelection,
 ): Thread {
-  return {
+  const timestamp = DateTime.makeUnsafe(draftThread.createdAt);
+  return presentThreadShell(draftThread.environmentId, {
     id: threadId,
-    environmentId: draftThread.environmentId,
     projectId: draftThread.projectId,
     title: "New thread",
+    providerInstanceId: fallbackModelSelection.instanceId,
     modelSelection: fallbackModelSelection,
     runtimeMode: draftThread.runtimeMode,
     interactionMode: draftThread.interactionMode,
-    session: null,
-    messages: [],
-    createdAt: draftThread.createdAt,
-    updatedAt: draftThread.createdAt,
+    branch: draftThread.branch,
+    worktreePath: draftThread.worktreePath,
+    activeProviderThreadId: null,
+    lineage: { rootThreadId: threadId, parentThreadId: null, relationshipToParent: null },
+    forkedFrom: null,
+    createdBy: "user",
+    creationSource: "web",
+    latestRunId: null,
+    activeRunId: null,
+    status: "idle",
+    pendingRuntimeRequest: null,
+    latestVisibleMessage: null,
+    latestUserMessageAt: null,
+    hasActionableProposedPlan: false,
+    itemCount: 0,
+    visibleItemCount: 0,
+    createdAt: timestamp,
+    updatedAt: timestamp,
     archivedAt: null,
     settledOverride: null,
     settledAt: null,
     deletedAt: null,
-    latestTurn: null,
-    branch: draftThread.branch,
-    worktreePath: draftThread.worktreePath,
-    checkpoints: [],
-    activities: [],
-    proposedPlans: [],
-  };
-}
-
-export function buildLoadingThreadFromShell(shell: ThreadShell): Thread {
-  return {
-    ...shell,
-    messages: [],
-    proposedPlans: [],
-    activities: [],
-    checkpoints: [],
-    deletedAt: null,
-  };
+  });
 }
 
 export function shouldWriteThreadErrorToCurrentServerThread(input: {
-  activeServerThread:
+  serverThread:
     | {
         environmentId: EnvironmentId;
         id: ThreadId;
@@ -207,24 +193,13 @@ export function shouldWriteThreadErrorToCurrentServerThread(input: {
   targetThreadId: ThreadId;
 }): boolean {
   return Boolean(
-    input.activeServerThread &&
+    input.serverThread &&
     input.targetThreadId === input.routeThreadRef.threadId &&
-    input.activeServerThread.environmentId === input.routeThreadRef.environmentId &&
-    input.activeServerThread.id === input.targetThreadId,
+    input.serverThread.environmentId === input.routeThreadRef.environmentId &&
+    input.serverThread.id === input.targetThreadId,
   );
 }
 
-export function buildThreadTurnInterruptInput(thread: Pick<Thread, "id" | "session">): {
-  threadId: ThreadId;
-  turnId?: TurnId;
-} {
-  const runningTurnId = thread.session?.status === "running" ? thread.session.activeTurnId : null;
-  return {
-    threadId: thread.id,
-    ...(runningTurnId !== null ? { turnId: runningTurnId } : {}),
-  };
-}
-
 export function reconcileMountedTerminalThreadIds(input: {
   currentThreadIds: ReadonlyArray<string>;
   openThreadIds: ReadonlyArray<string>;
@@ -333,6 +308,19 @@ export function resolveSendEnvMode(input: {
   return input.isGitRepo ? input.requestedEnvMode : "local";
 }
 
+export function shouldShowComposerContextStrip(input: {
+  isDraftHeroState: boolean;
+  isGitRepo: boolean;
+  hasActiveProject: boolean;
+  persistInActiveThreads: boolean;
+}): boolean {
+  return (
+    input.isGitRepo &&
+    input.hasActiveProject &&
+    (input.isDraftHeroState || input.persistInActiveThreads)
+  );
+}
+
 export function resolveBackgroundDraftWorkspaceOptions(input: {
   envMode: DraftThreadEnvMode;
   branch: string | null;
@@ -475,9 +463,7 @@ export function isBranchMismatchDismissedForSession(key: string | null): boolean
 }
 
 export function threadHasStarted(thread: Thread | null | undefined): boolean {
-  return Boolean(
-    thread && (thread.latestTurn !== null || thread.messages.length > 0 || thread.session !== null),
-  );
+  return Boolean(thread && (thread.latestRun !== null || thread.itemCount > 0 || thread.runtime));
 }
 
 // `threadProvider` is the open branded driver kind carried by the session.
@@ -500,7 +486,7 @@ export function deriveLockedProvider(input: {
   if (!threadHasStarted(input.thread)) {
     return null;
   }
-  const sessionProvider = input.thread?.session?.providerName ?? null;
+  const sessionProvider = input.thread?.runtime?.providerName ?? null;
   if (sessionProvider && isProviderDriverKind(sessionProvider)) {
     return sessionProvider;
   }
@@ -518,6 +504,7 @@ export function deriveLockedProvider(input: {
 export function getStartedThreadModelChangeBlockReason(input: {
   providers: ReadonlyArray<Pick<ServerProvider, "instanceId" | "requiresNewThreadForModelChange">>;
   hasStartedSession: boolean;
+  supportsProviderSwitchingViaHandoff?: boolean;
   currentModelSelection: ModelSelection;
   currentProviderInstanceId?: ModelSelection["instanceId"] | null | undefined;
   nextModelSelection: ModelSelection;
@@ -535,6 +522,15 @@ export function getStartedThreadModelChangeBlockReason(input: {
   ) {
     return null;
   }
+  if (currentModelSelection.instanceId !== input.nextModelSelection.instanceId) {
+    if (input.supportsProviderSwitchingViaHandoff === true) {
+      return null;
+    }
+    return {
+      title: "Start a new chat to switch providers",
+      description: "This thread does not support switching providers after it has started.",
+    };
+  }
   const currentProvider = input.providers.find(
     (snapshot) => snapshot.instanceId === currentModelSelection.instanceId,
   );
@@ -557,44 +553,12 @@ export async function waitForStartedServerThread(
   threadRef: ScopedThreadRef,
   timeoutMs = 1_000,
 ): Promise<boolean> {
-  const threadAtom = environmentThreadDetails.detailAtom(threadRef);
-  const getThread = () => appAtomRegistry.get(threadAtom);
-  const thread = getThread();
-
-  if (threadHasStarted(thread)) {
-    return true;
-  }
-
-  return await new Promise<boolean>((resolve) => {
-    let settled = false;
-    let timeoutId: ReturnType<typeof globalThis.setTimeout> | null = null;
-    const finish = (result: boolean) => {
-      if (settled) {
-        return;
-      }
-      settled = true;
-      if (timeoutId !== null) {
-        globalThis.clearTimeout(timeoutId);
-      }
-      unsubscribe();
-      resolve(result);
-    };
-
-    const unsubscribe = appAtomRegistry.subscribe(threadAtom, (thread) => {
-      if (!threadHasStarted(thread)) {
-        return;
-      }
-      finish(true);
-    });
-
-    if (threadHasStarted(getThread())) {
-      finish(true);
-      return;
-    }
-
-    timeoutId = globalThis.setTimeout(() => {
-      finish(false);
-    }, timeoutMs);
+  const threadAtom = environmentThreadShells.threadShellAtom(threadRef);
+  return waitForAtomValue({
+    registry: appAtomRegistry,
+    atom: threadAtom,
+    predicate: threadHasStarted,
+    timeoutMs,
   });
 }
 
@@ -603,44 +567,60 @@ export interface LocalDispatchSnapshot {
   preparingWorktree: boolean;
   submissionIntent: ComposerSubmissionIntent;
   latestUserMessageId: ChatMessage["id"] | null;
-  latestTurnTurnId: TurnId | null;
-  latestTurnRequestedAt: string | null;
-  latestTurnStartedAt: string | null;
-  latestTurnCompletedAt: string | null;
-  sessionStatus: NonNullable<Thread["session"]>["status"] | null;
-  sessionUpdatedAt: string | null;
+  latestRunId: RunId | null;
+  latestRunRequestedAt: string | null;
+  latestRunStartedAt: string | null;
+  latestRunCompletedAt: string | null;
+  runtimeStatus: NonNullable<Thread["runtime"]>["status"] | null;
+  runtimeUpdatedAt: string | null;
 }
 
 export function createLocalDispatchSnapshot(
   activeThread: Thread | undefined,
   options?: {
     preparingWorktree?: boolean;
+    latestUserMessageId?: ChatMessage["id"] | null;
     submissionIntent?: ComposerSubmissionIntent;
   },
 ): LocalDispatchSnapshot {
-  const latestTurn = activeThread?.latestTurn ?? null;
-  const session = activeThread?.session ?? null;
-  const latestUserMessage = activeThread?.messages.findLast((message) => message.role === "user");
+  const latestRun = activeThread?.latestRun ?? null;
+  const runtime = activeThread?.runtime ?? null;
   return {
     startedAt: new Date().toISOString(),
     preparingWorktree: Boolean(options?.preparingWorktree),
     submissionIntent: options?.submissionIntent ?? "foreground",
-    latestUserMessageId: latestUserMessage?.id ?? null,
-    latestTurnTurnId: latestTurn?.turnId ?? null,
-    latestTurnRequestedAt: latestTurn?.requestedAt ?? null,
-    latestTurnStartedAt: latestTurn?.startedAt ?? null,
-    latestTurnCompletedAt: latestTurn?.completedAt ?? null,
-    sessionStatus: session?.status ?? null,
-    sessionUpdatedAt: session?.updatedAt ?? null,
+    latestUserMessageId: options?.latestUserMessageId ?? null,
+    latestRunId: latestRun?.runId ?? null,
+    latestRunRequestedAt: latestRun?.requestedAt ?? null,
+    latestRunStartedAt: latestRun?.startedAt ?? null,
+    latestRunCompletedAt: latestRun?.completedAt ?? null,
+    runtimeStatus: runtime?.status ?? null,
+    runtimeUpdatedAt: runtime?.updatedAt ?? null,
   };
 }
 
+/**
+ * The timeline renders committed user rows from `visibleTurnItems`, but
+ * `message.updated` can land in `projection.messages` one event earlier than
+ * the matching `turn-item.updated`. Basing optimistic eviction on visible user
+ * turn items avoids dropping steer rows in that gap.
+ */
+export function deriveCommittedServerUserMessageIds(
+  visibleTurnItems: ReadonlyArray<OrchestrationV2ProjectedTurnItem>,
+): ReadonlySet<ChatMessage["id"]> {
+  return new Set(
+    visibleTurnItems.flatMap((row) =>
+      row.item.type === "user_message" ? [row.item.messageId] : [],
+    ),
+  );
+}
+
 export function hasServerAcknowledgedLocalDispatch(input: {
   localDispatch: LocalDispatchSnapshot | null;
   phase: SessionPhase;
-  latestTurn: Thread["latestTurn"] | null;
-  latestUserMessageId: ChatMessage["id"] | null;
-  session: Thread["session"] | null;
+  latestRun: Thread["latestRun"] | null;
+  latestUserMessageId?: ChatMessage["id"] | null;
+  runtime: Thread["runtime"] | null;
   hasPendingApproval: boolean;
   hasPendingUserInput: boolean;
   threadError: string | null | undefined;
@@ -655,34 +635,30 @@ export function hasServerAcknowledgedLocalDispatch(input: {
     return false;
   }
 
-  const latestTurn = input.latestTurn ?? null;
-  const session = input.session ?? null;
+  const latestRun = input.latestRun ?? null;
+  const runtime = input.runtime ?? null;
   const latestUserMessageChanged =
-    input.localDispatch.latestUserMessageId !== input.latestUserMessageId;
-  const latestTurnChanged =
-    input.localDispatch.latestTurnTurnId !== (latestTurn?.turnId ?? null) ||
-    input.localDispatch.latestTurnRequestedAt !== (latestTurn?.requestedAt ?? null) ||
-    input.localDispatch.latestTurnStartedAt !== (latestTurn?.startedAt ?? null) ||
-    input.localDispatch.latestTurnCompletedAt !== (latestTurn?.completedAt ?? null);
+    input.localDispatch.latestUserMessageId !== (input.latestUserMessageId ?? null);
+  const latestRunChanged =
+    input.localDispatch.latestRunId !== (latestRun?.runId ?? null) ||
+    input.localDispatch.latestRunRequestedAt !== (latestRun?.requestedAt ?? null) ||
+    input.localDispatch.latestRunStartedAt !== (latestRun?.startedAt ?? null) ||
+    input.localDispatch.latestRunCompletedAt !== (latestRun?.completedAt ?? null);
 
   if (input.phase === "running") {
-    // Steering adds a user message to the current running turn without
-    // necessarily changing any of the turn timestamps. Treat that projected
-    // message as the server acknowledgment so the composer does not remain
-    // stuck in its local "Sending" state until the turn settles.
     if (latestUserMessageChanged) {
       return true;
     }
-    if (!latestTurnChanged) {
+    if (!latestRunChanged) {
       return false;
     }
-    if (latestTurn?.startedAt === null || latestTurn === null) {
+    if (latestRun?.startedAt === null || latestRun === null) {
       return false;
     }
     if (
-      session?.activeTurnId !== null &&
-      session?.activeTurnId !== undefined &&
-      latestTurn?.turnId !== session.activeTurnId
+      runtime?.activeRunId !== null &&
+      runtime?.activeRunId !== undefined &&
+      latestRun?.runId !== runtime.activeRunId
     ) {
       return false;
     }
@@ -690,8 +666,8 @@ export function hasServerAcknowledgedLocalDispatch(input: {
   }
 
   return (
-    latestTurnChanged ||
-    input.localDispatch.sessionStatus !== (session?.status ?? null) ||
-    input.localDispatch.sessionUpdatedAt !== (session?.updatedAt ?? null)
+    latestRunChanged ||
+    input.localDispatch.runtimeStatus !== (runtime?.status ?? null) ||
+    input.localDispatch.runtimeUpdatedAt !== (runtime?.updatedAt ?? null)
   );
 }
diff --git a/apps/web/src/components/ChatView.tsx b/apps/web/src/components/ChatView.tsx
index 7f953cfd8300..1b527273fdd1 100644
--- a/apps/web/src/components/ChatView.tsx
+++ b/apps/web/src/components/ChatView.tsx
@@ -3,9 +3,11 @@ import {
   type ChatFileAttachment,
   DEFAULT_MODEL,
   defaultInstanceIdForDriver,
+  type ChatAttachment as ContractChatAttachment,
   type EnvironmentId,
   type MessageId,
   type ModelSelection,
+  type OrchestrationV2ThreadProjection,
   type ProjectScript,
   type ProjectId,
   type ProviderApprovalDecision,
@@ -15,7 +17,8 @@ import {
   type ResolvedKeybindingsConfig,
   type ScopedThreadRef,
   type ThreadId,
-  type TurnId,
+  type RunId,
+  type RuntimeRequestId,
   type KeybindingCommand,
   OrchestrationThreadActivity,
   PROVIDER_SEND_TURN_MAX_ATTACHMENTS,
@@ -28,19 +31,34 @@ import {
   connectionStatusTitle,
   type EnvironmentConnectionPresentation,
 } from "@t3tools/client-runtime/connection";
-import { wasBootstrapThreadDeleted } from "@t3tools/client-runtime/errors";
+import { deriveThreadTitleSeed } from "@t3tools/client-runtime/operations";
 import {
   changeRequestAutoSettles,
   effectiveSettled,
   effectiveSnoozed,
   threadWokeAt,
 } from "@t3tools/client-runtime/state/thread-settled";
+import { useThreadActions } from "../hooks/useThreadActions";
+import {
+  resolveDisplayedThreadPr,
+  threadChangeRequestSnapshotsAtom,
+  useLinkedThreadPullRequest,
+} from "./ThreadStatusIndicators";
+import {
+  deriveThreadActivityRun,
+  deriveLatestThreadRun,
+  deriveThreadRuntime,
+} from "@t3tools/client-runtime/state/thread-execution";
+import { resolveThreadProviderSession } from "@t3tools/client-runtime/state/thread-workflows";
 import {
   codexFeedbackMessage,
   parseCodexFeedbackCommand,
+  shouldShowLoadEarlierControl,
   submitCodexFeedback,
   type CodexFeedbackSubmission,
 } from "@t3tools/client-runtime/state/threads";
+import { resolveThreadLastVisitedAt } from "./Sidebar.logic";
+import { derivePendingThreadRequests } from "@t3tools/client-runtime/state/thread-requests";
 import {
   parseScopedThreadKey,
   scopedThreadKey,
@@ -53,13 +71,10 @@ import {
   resolvePromptInjectedEffort,
 } from "@t3tools/shared/model";
 import { CHAT_LIST_ANCHOR_OFFSET } from "@t3tools/shared/chatList";
+import { derivePendingBackgroundWork } from "@t3tools/shared/orchestrationV2PendingBackgroundWork";
 import { projectScriptCwd, projectScriptRuntimeEnv } from "@t3tools/shared/projectScripts";
 import { truncate } from "@t3tools/shared/String";
-import {
-  getTerminalLabel,
-  nextTerminalId,
-  resolveTerminalSessionLabel,
-} from "@t3tools/shared/terminalLabels";
+import { nextTerminalId, resolveTerminalSessionLabel } from "@t3tools/shared/terminalLabels";
 import { Debouncer } from "@tanstack/react-pacer";
 import { useAtomValue } from "@effect/atom-react";
 import {
@@ -84,28 +99,25 @@ import {
   type AtomCommandResult,
 } from "@t3tools/client-runtime/state/runtime";
 import * as Cause from "effect/Cause";
-import * as Schema from "effect/Schema";
 import { AsyncResult } from "effect/unstable/reactivity";
 import { isElectron } from "../env";
 import { readLocalApi } from "../localApi";
 import { useDiffPanelStore } from "../diffPanelStore";
 import {
   collapseExpandedComposerCursor,
-  type ComposerSubmissionIntent,
   parseStandaloneComposerSlashCommand,
 } from "../composer-logic";
 import {
   derivePendingApprovals,
   derivePendingUserInputs,
   derivePhase,
-  deriveTimelineEntries,
-  deriveActiveWorkStartedAt,
+  deriveTimelineEntriesFromVisibleTurnItems,
+  deriveRevertTurnCountByUserMessageId,
   deriveActivePlanState,
-  deriveTurnPlans,
+  deriveActiveWorkStartedAt,
   findLatestProposedPlan,
-  deriveWorkLogEntries,
   hasActionableProposedPlan,
-  isLatestTurnSettled,
+  isLatestRunSettled,
 } from "../session-logic";
 import { type LegendListRef } from "@legendapp/list/react";
 import { getAnchoredTurnMetrics, type TimelineScrollMode } from "./chat/timelineScrollAnchoring";
@@ -137,15 +149,20 @@ import { useTheme } from "../hooks/useTheme";
 import { writeTextToClipboard } from "../hooks/useCopyToClipboard";
 import { useTurnDiffSummaries } from "../hooks/useTurnDiffSummaries";
 import { isCommandPaletteOpen } from "../commandPaletteBus";
-import { buildTemporaryWorktreeBranchName } from "@t3tools/shared/git";
 import { useMediaQuery } from "../hooks/useMediaQuery";
-import { RIGHT_PANEL_INLINE_LAYOUT_MEDIA_QUERY } from "../rightPanelLayout";
+import { useElementWidth } from "../hooks/useElementWidth";
+import { usePreviewPanelInlineSize } from "../hooks/usePreviewPanelInlineSize";
+import {
+  RIGHT_PANEL_INLINE_LAYOUT_MEDIA_QUERY,
+  resolveThreadPanelPresentation,
+} from "../rightPanelLayout";
 import {
   selectActiveRightPanel,
   selectActiveRightPanelSurface,
+  updatePullRequestTabStatus,
+  selectThreadPanelOpen,
   selectThreadRightPanelState,
   type RightPanelSurface,
-  updatePullRequestTabStatus,
   useRightPanelStore,
 } from "../rightPanelStore";
 import {
@@ -153,13 +170,11 @@ import {
   setActivePreviewTab,
   useThreadPreviewState,
 } from "../previewStateStore";
-import { previewRuntimeTabId } from "../browser/previewRuntimeTabId";
 import { addBrowserSurface } from "./preview/addBrowserSurface";
 import { closePreviewSession } from "./preview/closePreviewSession";
 import { ThreadPreviewMiniPlayer } from "./preview/ThreadPreviewMiniPlayer";
 import { subscribePreviewAction } from "./preview/previewActionBus";
 import { getConfiguredPreviewUrls } from "./preview/previewEmptyStateLogic";
-import { makeWorkspaceFileDropHandlers } from "./chat/workspaceFileDrop";
 import {
   selectThreadPreviewMiniPlayer,
   usePreviewMiniPlayerStore,
@@ -169,26 +184,22 @@ import { PullRequestDetailPanel } from "./pullRequest/PullRequestDetailPanel";
 import { PullRequestDetailGhost } from "./pullRequest/PullRequestGhosts";
 import { PullRequestsUnavailableState } from "./pullRequest/PullRequestsUnavailableState";
 import { RightPanelTabs, type PullRequestTabStatus } from "./RightPanelTabs";
-import { AgentsPanel } from "./AgentsPanel";
-import {
-  deriveAgentPanelModel,
-  foldSubagentActivities,
-} from "@t3tools/client-runtime/state/subagentRuntime";
 import { DiffWorkerPoolProvider } from "./DiffWorkerPoolProvider";
 import { BranchToolbar } from "./BranchToolbar";
 import { resolveShortcutCommand, shortcutLabelForCommand } from "../keybindings";
+import { makeWorkspaceFileDropHandlers } from "./chat/workspaceFileDrop";
 import ThreadTerminalDrawer from "./ThreadTerminalDrawer";
 import {
   AlarmClockIcon,
   CheckCircle2Icon,
+  PaperclipIcon,
   ChevronDownIcon,
   GitBranchIcon,
   InfoIcon,
-  Minimize2Icon,
-  PaperclipIcon,
   WifiOffIcon,
 } from "lucide-react";
-import { cn, randomHex } from "~/lib/utils";
+import { cn } from "~/lib/utils";
+import { COLLAPSED_SIDEBAR_TITLEBAR_INSET_CLASS } from "~/workspaceTitlebar";
 import { stackedThreadToast, toastManager } from "./ui/toast";
 import { decodeProjectScriptKeybindingRule } from "~/lib/projectScriptKeybindings";
 import { type NewProjectScriptInput } from "./ProjectScriptsControl";
@@ -199,36 +210,21 @@ import {
   projectScriptIdFromCommand,
 } from "~/projectScripts";
 import { newDraftId, newMessageId, newThreadId } from "~/lib/utils";
-import { useBrowserHistoryStore } from "~/browserHistoryStore";
 import { registerFaviconProjectForThread } from "~/browserFaviconStore";
 import { getProviderModelCapabilities, resolveSelectableProvider } from "../providerModels";
-import {
-  applyProviderInstanceSettings,
-  deriveProviderInstanceEntries,
-  NO_PROVIDER_MODEL_SELECTION,
-} from "../providerInstances";
-import {
-  useClientSettings,
-  useClientSettingsHydrated,
-  useEnvironmentSettings,
-} from "../hooks/useSettings";
+import { NO_PROVIDER_MODEL_SELECTION } from "../providerInstances";
+import { useClientSettings, useEnvironmentSettings } from "../hooks/useSettings";
 import { useNowMinute } from "../hooks/useNowMinute";
 import { useNewThreadHandler } from "../hooks/useHandleNewThread";
-import { useThreadActions } from "../hooks/useThreadActions";
 import { resolveAppModelSelectionForInstance } from "../modelSelection";
-import { confirmTerminalClose, isTerminalCloseConfirmPending } from "../lib/terminalCloseConfirm";
+import { deriveLatestContextWindowSnapshot } from "../lib/contextWindow";
 import { getTerminalFocusOwner } from "../lib/terminalFocus";
-import {
-  preventRepeatedTerminalCloseShortcut,
-  preventTerminalCloseShortcut,
-} from "../lib/terminalCloseShortcut";
+import { preventRepeatedTerminalCloseShortcut } from "../lib/terminalCloseShortcut";
 import { resolveNewDraftStartFromOrigin } from "../lib/chatThreadActions";
 import {
-  derivePhysicalProjectKey,
   deriveLogicalProjectKeyFromSettings,
   selectProjectGroupingSettings,
 } from "../logicalProject";
-import { buildPhysicalToLogicalProjectKeyMap } from "../sidebarProjectGrouping";
 import { buildDraftThreadRouteParams, buildThreadRouteParams } from "../threadRoutes";
 import {
   beginBackgroundDraftSubmissionByRef,
@@ -237,10 +233,8 @@ import {
   type ComposerFileAttachment,
   type ComposerImageAttachment,
   type DraftThreadEnvMode,
-  finalizePromotedDraftThreadByRef,
-  markPromotedDraftThreadByRef,
   useComposerDraftStore,
-  type DraftId,
+  DraftId,
 } from "../composerDraftStore";
 import {
   appendTerminalContextsToPrompt,
@@ -268,38 +262,46 @@ import {
   serverEnvironment,
 } from "../state/server";
 import { terminalEnvironment } from "../state/terminal";
-import { threadEnvironment, useEnvironmentThread } from "../state/threads";
-import {
-  requestOlderThreadTurns,
-  threadHasOlderTurns,
-} from "@t3tools/client-runtime/state/threads";
+import { threadEnvironment } from "../state/threads";
 import { vcsEnvironment } from "../state/vcs";
 import { useEnvironments, usePrimaryEnvironment } from "../state/environments";
 import {
+  resolveThreadDetailRef,
   useProject,
   useProjects,
-  useThread,
-  useThreadRefs,
+  useThreadProjection,
+  useThreadStatus,
+  useThreadHistory,
   useThreadShell,
+  useThreadRefs,
+  useThreadVisibleTurnItems,
+  waitForThreadShell,
 } from "../state/entities";
 import { environmentShell } from "../state/shell";
 import { ChatComposer, type ChatComposerHandle } from "./chat/ChatComposer";
 import { DraftHeroHeadline } from "./chat/DraftHeroHeadline";
 import { ExpandedImageDialog } from "./chat/ExpandedImageDialog";
 import { PullRequestThreadDialog } from "./PullRequestThreadDialog";
-import { MessagesTimeline } from "./chat/MessagesTimeline";
+import { MessagesTimeline, type MessagesTimelineHistoryControls } from "./chat/MessagesTimeline";
 import { resolveTimelineIsAtEnd } from "./chat/MessagesTimeline.logic";
 import { ChatHeader } from "./chat/ChatHeader";
-import { PanelLayoutControls, RightPanelMaximizeControl } from "./chat/PanelLayoutControls";
+import { useRemoteOpenState } from "~/remoteOpen";
+import { shouldShowOpenInPicker } from "./chat/OpenInPicker.logic";
+import { useOpenFavoriteEditorShortcut } from "./chat/OpenInPickerShortcut";
+import {
+  PanelLayoutControls,
+  type PanelLayoutControlsProps,
+  RightPanelMaximizeControl,
+} from "./chat/PanelLayoutControls";
 import { type ExpandedImagePreview } from "./chat/ExpandedImagePreview";
+import { ThreadDetailsPanel, type ThreadDetailsPanelProps } from "./chat/ThreadDetailsPanel";
 import { NoActiveThreadState } from "./NoActiveThreadState";
-import { WorkspacePageHeader } from "./WorkspacePageHeader";
+import { AgentsPanel } from "./AgentsPanel";
 import {
-  resolveEffectiveEnvMode,
-  resolveLocalCheckoutBranchMismatch,
-  shouldShowComposerContextStrip,
-  shouldShowEnvironmentIndicator,
-} from "./BranchToolbar.logic";
+  deriveAgentPanelModel,
+  projectedSubagentsToRuntime,
+} from "@t3tools/client-runtime/state/subagentRuntime";
+import { resolveEffectiveEnvMode, resolveLocalCheckoutBranchMismatch } from "./BranchToolbar.logic";
 import {
   getProviderStatusBannerKey,
   ProviderStatusBanner,
@@ -312,19 +314,11 @@ import {
   shouldShowThreadErrorBanner,
   ThreadErrorBanner,
 } from "./chat/ThreadErrorBanner";
-import {
-  resolveDisplayedThreadPr,
-  threadChangeRequestSnapshotsAtom,
-  useLinkedThreadPullRequest,
-} from "./ThreadStatusIndicators";
-import type { ComposerBannerStackItem } from "./chat/ComposerBannerStack";
+import { resolveThreadPr } from "./ThreadStatusIndicators";
+import { type ComposerBannerStackItem } from "./chat/ComposerBannerStack";
+import { QueuedRunsControl, type EditQueuedRunRequest } from "./chat/QueuedRunsControl";
 import { ComposerSurface } from "./chat/ComposerSurface";
-import {
-  hasAvailableClaudeCompactionProvider,
-  hasDismissedResumeCompaction,
-  shouldOfferResumeCompaction,
-} from "./chat/ContextWindowMeter.logic";
-import { deriveLatestContextWindowSnapshot, formatContextWindowTokens } from "../lib/contextWindow";
+import { resolveThreadSyncPhase } from "../threadSync";
 import {
   DRAFT_HERO_TRANSITION_ANIMATION_ID,
   DRAFT_HERO_TRANSITION_DURATION_MS,
@@ -333,23 +327,19 @@ import {
   MOBILE_DRAFT_HEADLINE_VIEW_TRANSITION_NAME,
   runMobileComposerTransition,
 } from "./chat/draftHeroTransition";
+import type { ComposerDispatchMode } from "./chat/composerDispatch";
 import {
   MAX_HIDDEN_MOUNTED_TERMINAL_THREADS,
   branchMismatchKey,
   buildExpiredTerminalContextToastCopy,
   buildLocalDraftThread,
-  buildLoadingThreadFromShell,
-  buildThreadTurnInterruptInput,
   collectUserMessageBlobPreviewUrls,
   createLocalDispatchSnapshot,
+  deriveCommittedServerUserMessageIds,
   deriveComposerSendState,
   dismissBranchMismatchForSession,
-  hasEnvironmentReconnectWarningGraceElapsed,
-  scheduleEnvironmentReconnectWarning,
   hasServerAcknowledgedLocalDispatch,
   isBranchMismatchDismissedForSession,
-  shouldDockDraftHeroForSubmission,
-  shouldReleaseTimelineAnchorForToolActivity,
   shouldShowBranchMismatchBanner,
   shouldShowPlanFollowUpPrompt,
   getStartedThreadModelChangeBlockReason,
@@ -361,17 +351,15 @@ import {
   deriveLockedProvider,
   readFileAsDataUrl,
   reconcileMountedTerminalThreadIds,
-  resolveBackgroundDraftWorkspaceOptions,
-  resolveDraftHeroState,
+  resolveEffectiveInteractionMode,
   resolveThreadMetadataUpdateForNextTurn,
   resolveSendEnvMode,
   revokeBlobPreviewUrl,
   revokeUserMessagePreviewUrls,
-  shouldWriteThreadErrorToCurrentServerThread,
+  shouldShowComposerContextStrip,
   startNewThreadForProject,
   waitForStartedServerThread,
 } from "./ChatView.logic";
-import type { ThreadSyncPhase } from "../threadSync";
 import { useLocalStorage } from "~/hooks/useLocalStorage";
 import { useComposerHandleContext } from "../composerHandleContext";
 import {
@@ -415,12 +403,23 @@ import {
 } from "../versionSkew";
 import { resolveAssetUrl, useAssetUrls } from "../assets/assetUrls";
 
+const TIMELINE_SCROLL_CANCEL_SENTINEL = Object.freeze({});
 const ATTACHMENT_ONLY_BOOTSTRAP_PROMPT =
   "[User attached one or more files without additional text. Respond using the conversation context and the attached files.]";
 const EMPTY_ACTIVITIES: OrchestrationThreadActivity[] = [];
 const EMPTY_PROVIDERS: ServerProvider[] = [];
+const EMPTY_FEEDBACK_SUBMISSIONS: ReadonlyArray<CodexFeedbackSubmission> = [];
+// During an active turn the thread's updatedAt advances several times per
+// second, and every server-side visit is a full command dispatch plus a
+// broadcast to all shell subscribers. Mid-turn bumps carry no unread signal
+// (unread flips on run completions, which bypass the throttle), so one
+// watermark per interval is plenty.
+const VISIT_DISPATCH_THROTTLE_MS = 10_000;
 const EMPTY_PROVIDER_SKILLS: ServerProvider["skills"] = [];
+const EMPTY_PROJECTION_RUNS: OrchestrationV2ThreadProjection["runs"] = [];
+const EMPTY_ATTACHMENT_IDS: string[] = [];
 const EMPTY_PENDING_USER_INPUT_ANSWERS: Record<string, PendingUserInputDraftAnswer> = {};
+
 function useDraftHeroLayoutTransition(isDraftHeroState: boolean) {
   const transitionGroupRef = useRef<HTMLDivElement | null>(null);
   const composerAnchorRef = useRef<HTMLDivElement | null>(null);
@@ -433,6 +432,7 @@ function useDraftHeroLayoutTransition(isDraftHeroState: boolean) {
   const attachComposerAnchorRef = (element: HTMLDivElement | null) => {
     composerAnchorRef.current = element;
   };
+
   const captureComposerRect = () => {
     previousComposerRectRef.current = composerAnchorRef.current?.getBoundingClientRect() ?? null;
   };
@@ -450,7 +450,6 @@ function useDraftHeroLayoutTransition(isDraftHeroState: boolean) {
 
     animationRef.current?.cancel();
     animationRef.current = null;
-
     const previousComposerRect = previousComposerRectRef.current;
     if (
       stateChanged &&
@@ -479,20 +478,21 @@ function useDraftHeroLayoutTransition(isDraftHeroState: boolean) {
         void animation.finished
           .catch(() => undefined)
           .then(() => {
-            if (animationRef.current !== animation) {
-              return;
-            }
-            animationRef.current = null;
+            if (animationRef.current === animation) animationRef.current = null;
           });
       }
     }
-
     previousStateRef.current = isDraftHeroState;
     previousComposerRectRef.current = nextComposerRect;
   }, [isDraftHeroState]);
 
-  return [attachTransitionGroupRef, attachComposerAnchorRef, captureComposerRect] as const;
+  return {
+    transitionGroupRef: attachTransitionGroupRef,
+    composerAnchorRef: attachComposerAnchorRef,
+    captureComposerRect,
+  } as const;
 }
+
 const PreviewPanel = lazy(() =>
   import("./preview/PreviewPanel").then((module) => ({ default: module.PreviewPanel })),
 );
@@ -551,14 +551,6 @@ function shouldTypeToFocusComposer(event: KeyboardEvent): boolean {
   if (eventPathContainsSelector(event, TYPE_TO_FOCUS_INTERACTIVE_SELECTOR)) return false;
   if (document.querySelector(TYPE_TO_FOCUS_FLOATING_LAYER_SELECTOR)) return false;
 
-  // The right-panel surface launcher claims its shortcut letters while it is
-  // visible (data attribute set in RightPanelTabs); those keys open surfaces
-  // instead of typing into the composer.
-  const launcherKeys = document
-    .querySelector("[data-surface-launcher-keys]")
-    ?.getAttribute("data-surface-launcher-keys");
-  if (launcherKeys && launcherKeys.toLowerCase().includes(event.key.toLowerCase())) return false;
-
   return true;
 }
 
@@ -583,7 +575,6 @@ type ChatViewProps =
       onDiffPanelOpen?: () => void;
       reserveTitleBarControlInset?: boolean;
       forceExpandedMobileComposer?: boolean;
-      threadSyncPhase?: ThreadSyncPhase | null;
       routeKind: "server";
       draftId?: never;
     }
@@ -593,7 +584,6 @@ type ChatViewProps =
       onDiffPanelOpen?: () => void;
       reserveTitleBarControlInset?: boolean;
       forceExpandedMobileComposer?: boolean;
-      threadSyncPhase?: never;
       routeKind: "draft";
       draftId: DraftId;
     };
@@ -608,17 +598,14 @@ type PersistentTerminalLaunchContext = Pick<TerminalLaunchContext, "cwd" | "work
 
 function useLocalDispatchState(input: {
   activeThread: Thread | undefined;
-  activeLatestTurn: Thread["latestTurn"] | null;
+  activeLatestRun: Thread["latestRun"] | null;
+  latestUserMessageId: MessageId | null;
   phase: SessionPhase;
-  activePendingApproval: ApprovalRequestId | null;
-  activePendingUserInput: ApprovalRequestId | null;
+  activePendingApproval: RuntimeRequestId | null;
+  activePendingUserInput: RuntimeRequestId | null;
   threadError: string | null | undefined;
 }) {
   const [localDispatch, setLocalDispatch] = useState<LocalDispatchSnapshot | null>(null);
-  const latestUserMessage = input.activeThread?.messages.findLast(
-    (message) => message.role === "user",
-  );
-  const latestUserMessageId = latestUserMessage?.id ?? null;
 
   const resetLocalDispatch = useCallback(() => {
     setLocalDispatch(null);
@@ -629,51 +616,50 @@ function useLocalDispatchState(input: {
       hasServerAcknowledgedLocalDispatch({
         localDispatch,
         phase: input.phase,
-        latestTurn: input.activeLatestTurn,
-        latestUserMessageId,
-        session: input.activeThread?.session ?? null,
+        latestRun: input.activeLatestRun,
+        latestUserMessageId: input.latestUserMessageId,
+        runtime: input.activeThread?.runtime ?? null,
         hasPendingApproval: input.activePendingApproval !== null,
         hasPendingUserInput: input.activePendingUserInput !== null,
         threadError: input.threadError,
       }),
     [
-      input.activeLatestTurn,
+      input.activeLatestRun,
+      input.latestUserMessageId,
       input.activePendingApproval,
       input.activePendingUserInput,
-      input.activeThread?.session,
+      input.activeThread?.runtime,
       input.phase,
       input.threadError,
-      latestUserMessageId,
       localDispatch,
     ],
   );
   const activeLocalDispatch = serverAcknowledgedLocalDispatch ? null : localDispatch;
   const beginLocalDispatch = useCallback(
-    (options?: { preparingWorktree?: boolean; submissionIntent?: ComposerSubmissionIntent }) => {
+    (options?: { preparingWorktree?: boolean }) => {
       const preparingWorktree = Boolean(options?.preparingWorktree);
       setLocalDispatch((current) => {
         const active = serverAcknowledgedLocalDispatch ? null : current;
         if (active) {
-          const submissionIntent = options?.submissionIntent ?? active.submissionIntent;
-          return active.preparingWorktree === preparingWorktree &&
-            active.submissionIntent === submissionIntent
+          return active.preparingWorktree === preparingWorktree
             ? active
-            : { ...active, preparingWorktree, submissionIntent };
+            : { ...active, preparingWorktree };
         }
-        return createLocalDispatchSnapshot(input.activeThread, options);
+        return createLocalDispatchSnapshot(input.activeThread, {
+          ...options,
+          latestUserMessageId: input.latestUserMessageId,
+        });
       });
     },
-    [input.activeThread, serverAcknowledgedLocalDispatch],
+    [input.activeThread, input.latestUserMessageId, serverAcknowledgedLocalDispatch],
   );
 
   return {
     beginLocalDispatch,
     resetLocalDispatch,
     localDispatchStartedAt: activeLocalDispatch?.startedAt ?? null,
-    latestUserMessageAt: latestUserMessage?.createdAt ?? null,
     isPreparingWorktree: activeLocalDispatch?.preparingWorktree ?? false,
     isSendBusy: activeLocalDispatch !== null,
-    backgroundSubmissionPending: localDispatch?.submissionIntent === "background",
   };
 }
 
@@ -746,8 +732,8 @@ const PersistentThreadTerminalDrawer = memo(function PersistentThreadTerminalDra
   const openTerminal = useAtomCommand(terminalEnvironment.open, "terminal open");
   const writeTerminal = useAtomCommand(terminalEnvironment.write, "terminal write");
   const closeTerminalMutation = useAtomCommand(terminalEnvironment.close, "terminal close");
+  const serverThread = useThreadShell(threadRef);
   const draftThread = useComposerDraftStore((store) => store.getDraftThreadByRef(threadRef));
-  const serverThread = useThread(threadRef, { waitForShell: draftThread !== null });
   const projectRef = serverThread
     ? scopeProjectRef(serverThread.environmentId, serverThread.projectId)
     : draftThread
@@ -1115,8 +1101,8 @@ const PersistentThreadTerminalPanel = memo(function PersistentThreadTerminalPane
   newShortcutLabel,
   closeShortcutLabel,
 }: PersistentThreadTerminalPanelProps) {
+  const serverThread = useThreadShell(threadRef);
   const draftThread = useComposerDraftStore((store) => store.getDraftThreadByRef(threadRef));
-  const serverThread = useThread(threadRef, { waitForShell: draftThread !== null });
   const projectRef = serverThread
     ? scopeProjectRef(serverThread.environmentId, serverThread.projectId)
     : draftThread
@@ -1266,8 +1252,8 @@ function chatActionErrorMessage(error: unknown): string {
  * message near the top while its turn streams, and it keeps LegendList's
  * maintainScrollAtEnd switched off for as long as it is installed — ChatView
  * drives the streaming scrolls itself, but only in "anchoring-new-turn" mode.
- * So every return to the live edge has to release the anchor too, otherwise the
- * timeline settles into "following-end" with nothing following anything.
+ * So every return to the live edge has to release the anchor too, otherwise
+ * the timeline settles into "following-end" with nothing following anything.
  */
 function releaseChatTimelineAnchor<T extends { readonly messageId: MessageId | null }>(
   current: T,
@@ -1285,8 +1271,6 @@ function ChatViewContent(props: ChatViewProps) {
     forceExpandedMobileComposer = false,
   } = props;
   const draftId = routeKind === "draft" ? props.draftId : null;
-  const threadSyncPhase = routeKind === "server" ? (props.threadSyncPhase ?? null) : null;
-  const threadDetailLoading = threadSyncPhase === "loading";
   const handleNewThread = useNewThreadHandler();
   const { settleThread, pinThread, confirmAndUnpinThread } = useThreadActions();
   const routeThreadRef = useMemo(
@@ -1314,15 +1298,19 @@ function ChatViewContent(props: ChatViewProps) {
     reportFailure: false,
   });
   const startThreadTurn = useAtomCommand(threadEnvironment.startTurn, { reportFailure: false });
-  const createAttachmentAssetUrl = useAtomQueryRunner(assetEnvironment.createUrl, {
+  const uploadThreadFeedback = useAtomCommand(threadEnvironment.uploadFeedback, {
     reportFailure: false,
   });
-  const uploadThreadFeedback = useAtomCommand(threadEnvironment.uploadFeedback, {
+  const createAttachmentAssetUrl = useAtomQueryRunner(assetEnvironment.createUrl, {
     reportFailure: false,
   });
   const interruptThreadTurn = useAtomCommand(threadEnvironment.interruptTurn, {
     reportFailure: false,
   });
+  const loadEarlierThreadHistory = useAtomCommand(threadEnvironment.loadEarlierHistory, {
+    label: "load earlier thread history",
+    reportFailure: false,
+  });
   const respondToThreadApproval = useAtomCommand(threadEnvironment.respondToApproval, {
     reportFailure: false,
   });
@@ -1332,6 +1320,9 @@ function ChatViewContent(props: ChatViewProps) {
   const revertThreadCheckpoint = useAtomCommand(threadEnvironment.revertCheckpoint, {
     reportFailure: false,
   });
+  const forkThreadFromRun = useAtomCommand(threadEnvironment.forkFromRun, {
+    reportFailure: false,
+  });
   const openPreview = useAtomCommand(previewEnvironment.open, { reportFailure: false });
   const closePreview = useAtomCommand(previewEnvironment.close, "preview close");
   const { environments } = useEnvironments();
@@ -1341,8 +1332,27 @@ function ChatViewContent(props: ChatViewProps) {
     () => new Map(environments.map((environment) => [environment.environmentId, environment])),
     [environments],
   );
-  const composerDraftTarget: ScopedThreadRef | DraftId =
+  // Queued-message edit mode. While active, the composer is retargeted to a
+  // per-run edit draft so the user's in-progress draft on the thread survives
+  // untouched; `existingAttachments` tracks which stored attachments the edit
+  // keeps (removal is client state until save).
+  const [editingQueuedRun, setEditingQueuedRun] = useState<{
+    readonly threadId: ThreadId;
+    readonly runId: RunId;
+    readonly messageId: MessageId;
+    readonly originalText: string;
+    readonly existingAttachments: ReadonlyArray<ContractChatAttachment>;
+  } | null>(null);
+  const queuedEditDraftTargetFor = useCallback(
+    (runId: RunId) => DraftId.make(`queued-edit:${scopedThreadKey(routeThreadRef)}:${runId}`),
+    [routeThreadRef],
+  );
+  const baseComposerDraftTarget: ScopedThreadRef | DraftId =
     routeKind === "server" ? routeThreadRef : props.draftId;
+  const composerDraftTarget: ScopedThreadRef | DraftId =
+    editingQueuedRun === null
+      ? baseComposerDraftTarget
+      : queuedEditDraftTargetFor(editingQueuedRun.runId);
   const draftThread = useComposerDraftStore((store) =>
     routeKind === "server"
       ? store.getDraftSessionByRef(routeThreadRef)
@@ -1350,34 +1360,82 @@ function ChatViewContent(props: ChatViewProps) {
         ? store.getDraftSession(draftId)
         : null,
   );
-  const routeServerThreadShell = useThreadShell(routeKind === "server" ? routeThreadRef : null);
-  const serverThread = useThread(routeThreadRef, { waitForShell: draftThread !== null });
-  const loadingServerThread = useMemo(
+  const serverThread = useThreadShell(routeThreadRef);
+  const routeThreadDetailRef = resolveThreadDetailRef(routeThreadRef, {
+    shellExists: serverThread !== null,
+    waitForShell: draftThread !== null,
+  });
+  const serverThreadProjection = useThreadProjection(routeThreadDetailRef);
+  const serverProjection = serverThreadProjection?.projection ?? null;
+  const threadStatus = useThreadStatus(routeThreadDetailRef);
+  const threadSyncPhase = resolveThreadSyncPhase({
+    detailExists: serverProjection !== null,
+    shellExists: serverThread !== null,
+    status: threadStatus,
+  });
+  // Latest provider-reported context usage (#8144): the newest turn that has
+  // a report wins; stale turns keep the meter alive between turns.
+  const activeThreadLiveTokenUsage = useMemo(() => {
+    const turns = serverProjection?.providerTurns;
+    if (!turns || turns.length === 0) return null;
+    for (let index = turns.length - 1; index >= 0; index -= 1) {
+      const usage = turns[index]?.tokenUsage;
+      if (usage !== undefined) return usage;
+    }
+    return null;
+  }, [serverProjection?.providerTurns]);
+  // Agents surface (#5219): on orchestration-v2 the panel model comes from the
+  // projected subagent entities — the v2 leg of the spec's mapper swap. The
+  // native-activity fold never runs on this branch.
+  const agentPanelModel = useMemo(
     () =>
-      threadDetailLoading && routeServerThreadShell
-        ? buildLoadingThreadFromShell(routeServerThreadShell)
-        : null,
-    [routeServerThreadShell, threadDetailLoading],
-  );
-  const activeServerThread = serverThread ?? loadingServerThread;
-  // Pagination window state for the routed server thread: drives the
-  // "load earlier turns" header when the loaded window has older history.
-  const routeThreadState = useEnvironmentThread(
-    routeKind === "server" ? routeThreadRef.environmentId : null,
-    routeKind === "server" ? routeThreadRef.threadId : null,
+      deriveAgentPanelModel({
+        agents: [],
+        v2Projection: projectedSubagentsToRuntime(serverProjection?.subagents ?? []),
+      }),
+    [serverProjection?.subagents],
   );
-  const loadEarlierTurns = useMemo(() => {
-    if (routeKind !== "server" || !threadHasOlderTurns(routeThreadState)) {
-      return null;
+  const serverVisibleTurnItems = useThreadVisibleTurnItems(routeThreadDetailRef);
+  const serverThreadHistory = useThreadHistory(routeThreadDetailRef);
+  const threadHistoryControls = useMemo<MessagesTimelineHistoryControls | undefined>(() => {
+    if (routeThreadDetailRef === null || !shouldShowLoadEarlierControl(serverThreadHistory)) {
+      return undefined;
     }
     return {
-      loading: routeThreadState.page._tag === "Some" && routeThreadState.page.value.loadingOlder,
+      hasMoreHistory: serverThreadHistory.hasMoreHistory,
+      loading: serverThreadHistory.loading,
+      error: serverThreadHistory.error,
       onLoadEarlier: () => {
-        requestOlderThreadTurns(routeThreadRef.environmentId, routeThreadRef.threadId);
+        void loadEarlierThreadHistory({
+          environmentId: routeThreadDetailRef.environmentId,
+          input: { threadId: routeThreadDetailRef.threadId },
+        });
       },
     };
-  }, [routeKind, routeThreadRef, routeThreadState]);
+  }, [loadEarlierThreadHistory, routeThreadDetailRef, serverThreadHistory]);
+  const committedServerMessageIds = useMemo(
+    () => deriveCommittedServerUserMessageIds(serverVisibleTurnItems),
+    [serverVisibleTurnItems],
+  );
+  // Queued messages have no turn item until their run starts, so the
+  // turn-item-derived set alone can never retire their optimistic rows —
+  // cancelling such a run would leave a phantom "pending" queue row behind.
+  // Union in the projection's user messages: once the server holds the
+  // message, the optimistic copy is redundant everywhere it could render.
+  const serverAcknowledgedUserMessageIds = useMemo(() => {
+    const ids = new Set(committedServerMessageIds);
+    for (const message of serverProjection?.messages ?? []) {
+      if (message.role === "user") ids.add(message.id);
+    }
+    return ids;
+  }, [committedServerMessageIds, serverProjection]);
   const markThreadVisited = useUiStateStore((store) => store.markThreadVisited);
+  const activeThreadLocalLastVisitedAt = useUiStateStore(
+    (store) => store.threadLastVisitedAtById[routeThreadKey],
+  );
+  const visitThreadMutation = useAtomCommand(threadEnvironment.visit, { reportFailure: false });
+  const lastDispatchedVisitRef = useRef<string | null>(null);
+  const lastVisitDispatchAtRef = useRef(0);
   const settings = useEnvironmentSettings(environmentId);
   // New-thread defaults live in the primary environment's settings.json (the
   // settings UI never writes to remote environments), so read them from the
@@ -1440,17 +1498,15 @@ function ChatViewContent(props: ChatViewProps) {
   const composerElementContextsRef = useRef<ElementContextDraft[]>([]);
   const localComposerRef = useRef<ChatComposerHandle | null>(null);
   const composerRef = useComposerHandleContext() ?? localComposerRef;
-  const [isWorkspaceFileDragActive, setIsWorkspaceFileDragActive] = useState(false);
   const [showScrollToBottom, setShowScrollToBottom] = useState(false);
+  const [isWorkspaceFileDragActive, setIsWorkspaceFileDragActive] = useState(false);
   const [expandedImage, setExpandedImage] = useState<ExpandedImagePreview | null>(null);
   const [optimisticUserMessages, setOptimisticUserMessages] = useState<ChatMessage[]>([]);
   const [feedbackSubmissionsByThreadKey, setFeedbackSubmissionsByThreadKey] = useState<
     Record<string, ReadonlyArray<CodexFeedbackSubmission>>
   >({});
-  const feedbackSubmissions = useMemo(
-    () => feedbackSubmissionsByThreadKey[routeThreadKey] ?? [],
-    [feedbackSubmissionsByThreadKey, routeThreadKey],
-  );
+  const feedbackSubmissions =
+    feedbackSubmissionsByThreadKey[routeThreadKey] ?? EMPTY_FEEDBACK_SUBMISSIONS;
   const feedbackUploading = feedbackSubmissions.some(
     (submission) => submission.status === "uploading",
   );
@@ -1467,10 +1523,7 @@ function ChatViewContent(props: ChatViewProps) {
   const [maximizedRightPanelThreadKey, setMaximizedRightPanelThreadKey] = useState<string | null>(
     null,
   );
-  const [respondingRequestIds, setRespondingRequestIds] = useState<ApprovalRequestId[]>([]);
-  const [respondingUserInputRequestIds, setRespondingUserInputRequestIds] = useState<
-    ApprovalRequestId[]
-  >([]);
+  const [respondingRequestIds, setRespondingRequestIds] = useState<RuntimeRequestId[]>([]);
 
   useEffect(() => {
     setIsWorkspaceFileDragActive(false);
@@ -1482,12 +1535,21 @@ function ChatViewContent(props: ChatViewProps) {
     window.addEventListener("dragend", clearWorkspaceFileDrag);
     return () => window.removeEventListener("dragend", clearWorkspaceFileDrag);
   }, [isWorkspaceFileDragActive]);
+  const [respondingUserInputRequestIds, setRespondingUserInputRequestIds] = useState<
+    RuntimeRequestId[]
+  >([]);
   const [pendingUserInputAnswersByRequestId, setPendingUserInputAnswersByRequestId] = useState<
     Record<string, Record<string, PendingUserInputDraftAnswer>>
   >({});
   const [pendingUserInputQuestionIndexByRequestId, setPendingUserInputQuestionIndexByRequestId] =
     useState<Record<string, number>>({});
-  const shouldUseRightPanelSheet = useMediaQuery(RIGHT_PANEL_INLINE_LAYOUT_MEDIA_QUERY);
+  const shouldUsePlanSidebarSheet = useMediaQuery(RIGHT_PANEL_INLINE_LAYOUT_MEDIA_QUERY);
+  const [workspaceLayoutRef, workspaceLayoutWidth] = useElementWidth<HTMLDivElement>();
+  const previewPanelInlineSize = usePreviewPanelInlineSize();
+  const threadPanelPopoverAnchorRef = useRef<HTMLElement | null>(null);
+  // Tracks whether the user explicitly dismissed the sidebar for the active turn.
+  // When set, the thread-change reset effect will open the sidebar instead of closing it.
+  // Used by "Implement in a new thread" to carry the sidebar-open intent across navigation.
   const [terminalFocusRequestId, setTerminalFocusRequestId] = useState(0);
   const [pullRequestDialogState, setPullRequestDialogState] =
     useState<PullRequestDialogState | null>(null);
@@ -1511,7 +1573,6 @@ function ChatViewContent(props: ChatViewProps) {
   const legendListRef = useRef<LegendListRef | null>(null);
   const [composerOverlayElement, setComposerOverlayElement] = useState<HTMLDivElement | null>(null);
   const [composerOverlayHeight, setComposerOverlayHeight] = useState(0);
-  const [scrollToEndClearance, setScrollToEndClearance] = useState(0);
   const isAtEndRef = useRef(true);
   const attachmentPreviewHandoffByMessageIdRef = useRef<Record<string, string[]>>({});
   const attachmentPreviewPromotionInFlightByMessageIdRef = useRef<Record<string, true>>({});
@@ -1519,6 +1580,25 @@ function ChatViewContent(props: ChatViewProps) {
   const feedbackUploadsInFlightRef = useRef(new Set<string>());
   const terminalUiOpenByThreadRef = useRef<Record<string, boolean>>({});
 
+  useLayoutEffect(() => {
+    if (!composerOverlayElement) return;
+
+    const updateHeight = () => {
+      const nextHeight = Math.ceil(composerOverlayElement.getBoundingClientRect().height);
+      if (nextHeight <= 0) return;
+      setComposerOverlayHeight((currentHeight) =>
+        currentHeight === nextHeight ? currentHeight : nextHeight,
+      );
+    };
+
+    updateHeight();
+    if (typeof ResizeObserver === "undefined") return;
+
+    const observer = new ResizeObserver(updateHeight);
+    observer.observe(composerOverlayElement);
+    return () => observer.disconnect();
+  }, [composerOverlayElement]);
+
   const terminalUiState = useTerminalUiStateStore((state) =>
     selectThreadTerminalUiState(state.terminalUiStateByThreadKey, routeThreadRef),
   );
@@ -1561,7 +1641,7 @@ function ChatViewContent(props: ChatViewProps) {
     ? scopeProjectRef(draftThread.environmentId, draftThread.projectId)
     : null;
   const fallbackDraftProject = useProject(fallbackDraftProjectRef);
-  const localDraftError = activeServerThread
+  const localDraftError = serverThread
     ? null
     : ((draftId ? localDraftErrorsByDraftId[draftId]?.message : null) ?? null);
   const localServerError = localServerErrorsByThreadKey[routeThreadKey]?.message ?? null;
@@ -1570,7 +1650,7 @@ function ChatViewContent(props: ChatViewProps) {
   // a failed send would silently disappear on promotion. When both keys hold
   // an entry, the most recent write wins.
   useEffect(() => {
-    if (!activeServerThread || !draftId) {
+    if (!serverThread || !draftId) {
       return;
     }
     const pendingDraftEntry = localDraftErrorsByDraftId[draftId];
@@ -1599,7 +1679,7 @@ function ChatViewContent(props: ChatViewProps) {
         [routeThreadKey]: pendingDraftEntry,
       };
     });
-  }, [activeServerThread, draftId, localDraftErrorsByDraftId, routeThreadKey]);
+  }, [draftId, localDraftErrorsByDraftId, routeThreadKey, serverThread]);
   const localDraftThread = useMemo(
     () =>
       draftThread
@@ -1611,13 +1691,53 @@ function ChatViewContent(props: ChatViewProps) {
         : undefined,
     [draftThread, fallbackDraftProject?.defaultModelSelection, threadId],
   );
-  // Promotion is data-driven: the draft route keeps rendering while the
-  // server thread (same pre-allocated ref) starts, so live state must not
-  // depend on which route is mounted.
-  const isServerThread = activeServerThread !== null;
-  const activeThread = activeServerThread ?? localDraftThread;
+  const isServerThread = serverThread !== null;
+  const activeThread = isServerThread ? serverThread : localDraftThread;
+  const serverLatestRun = useMemo(
+    () => (serverProjection === null ? null : deriveLatestThreadRun(serverProjection)),
+    [serverProjection],
+  );
+  const serverActivityRun = useMemo(
+    () => (serverProjection === null ? null : deriveThreadActivityRun(serverProjection)),
+    [serverProjection],
+  );
+  const serverRuntime = useMemo(
+    () => (serverProjection === null ? null : deriveThreadRuntime(serverProjection)),
+    [serverProjection],
+  );
+  const activeProviderSession = useMemo(
+    () => (serverProjection === null ? null : resolveThreadProviderSession(serverProjection)),
+    [serverProjection],
+  );
+  const supportsProviderSwitchingViaHandoff =
+    activeProviderSession?.capabilities.sessions.supportsProviderSwitchingViaHandoff === true;
+  const activeLatestRun = isServerThread ? serverLatestRun : (activeThread?.latestRun ?? null);
+  const activeActivityRun = isServerThread ? serverActivityRun : (activeThread?.latestRun ?? null);
+  const activeRuntime = isServerThread ? serverRuntime : (activeThread?.runtime ?? null);
+  const parentSubagentThreadId =
+    activeThread?.lineage.relationshipToParent === "subagent"
+      ? activeThread.lineage.parentThreadId
+      : null;
+  const parentSubagentEnvironmentId = activeThread?.environmentId ?? null;
+  const parentSubagentThreadRef = useMemo(() => {
+    if (parentSubagentEnvironmentId === null || parentSubagentThreadId === null) {
+      return null;
+    }
+    return scopeThreadRef(parentSubagentEnvironmentId, parentSubagentThreadId);
+  }, [parentSubagentEnvironmentId, parentSubagentThreadId]);
+  const parentSubagentThread = useThreadShell(parentSubagentThreadRef);
+  const parentThreadLink = useMemo(
+    () =>
+      parentSubagentThreadRef === null
+        ? null
+        : {
+            threadId: parentSubagentThreadRef.threadId,
+            title: parentSubagentThread?.title ?? "Parent thread",
+          },
+    [parentSubagentThread?.title, parentSubagentThreadRef],
+  );
   const threadError = isServerThread
-    ? (localServerError ?? activeServerThread?.session?.lastError ?? null)
+    ? (localServerError ?? serverRuntime?.lastError ?? null)
     : localDraftError;
   // Dismissals can only mask the shown error, never clear it: a server thread
   // keeps its error in session.lastError, so clearing the local shadow would
@@ -1638,17 +1758,19 @@ function ChatViewContent(props: ChatViewProps) {
   // the branch mismatch banner.
   const [, setThreadErrorBannerDismissTick] = useState(0);
   const runtimeMode = composerRuntimeMode ?? activeThread?.runtimeMode ?? DEFAULT_RUNTIME_MODE;
-  // Plan mode is legacy (Settings → Beta). With the flag off the effective
-  // mode is forced to "default" — even for threads with a stored plan mode —
-  // so nobody is trapped in plan mode while its toggle is hidden. The next
-  // send persists "default" back to the thread.
-  const interactionMode = settings.planModeEnabled
-    ? (composerInteractionMode ?? activeThread?.interactionMode ?? DEFAULT_INTERACTION_MODE)
-    : DEFAULT_INTERACTION_MODE;
+  const interactionMode = resolveEffectiveInteractionMode({
+    planModeEnabled: settings.planModeEnabled,
+    composerInteractionMode,
+    threadInteractionMode: activeThread?.interactionMode,
+  });
   const isLocalDraftThread = !isServerThread && localDraftThread !== undefined;
   const canCheckoutPullRequestIntoThread = isLocalDraftThread;
   const activeThreadId = activeThread?.id ?? null;
-  const activeThreadEnvironmentId = activeThread?.environmentId ?? null;
+  // Prefer the larger of turn-item-committed ids and projection messages so
+  // env lock does not unlock while turn items lag projection hydration.
+  const activeMessageCount = isServerThread
+    ? Math.max(committedServerMessageIds.size, serverProjection?.messages.length ?? 0)
+    : 0;
   const runningTerminalIds = useThreadRunningTerminalIds({
     environmentId: activeThread?.environmentId ?? null,
     threadId: activeThreadId,
@@ -1684,14 +1806,10 @@ function ChatViewContent(props: ChatViewProps) {
     return labels;
   }, [activeThreadKnownSessions]);
   const activeThreadRef = useMemo(
-    () =>
-      activeThreadEnvironmentId && activeThreadId
-        ? scopeThreadRef(activeThreadEnvironmentId, activeThreadId)
-        : null,
-    [activeThreadEnvironmentId, activeThreadId],
+    () => (activeThread ? scopeThreadRef(activeThread.environmentId, activeThread.id) : null),
+    [activeThread],
   );
   const activeThreadKey = activeThreadRef ? scopedThreadKey(activeThreadRef) : null;
-  const changeRequestSnapshotByKey = useAtomValue(threadChangeRequestSnapshotsAtom);
   const [timelineAnchor, setTimelineAnchor] = useState<{
     readonly threadKey: string | null;
     readonly messageId: MessageId | null;
@@ -1700,6 +1818,28 @@ function ChatViewContent(props: ChatViewProps) {
     setTimelineAnchor({ threadKey: activeThreadKey, messageId: null });
   }
   const timelineAnchorMessageId = timelineAnchor.messageId;
+  // Release the turn anchor once its run finishes. LegendList sizes the
+  // anchored end-space filler for the geometry at anchor time and never
+  // recomputes it, so a lingering anchor leaves stale filler height behind
+  // the composer — phantom scroll range on threads whose content fits.
+  const anchorRunSettled = useMemo(() => {
+    if (timelineAnchorMessageId === null) return false;
+    const anchorRun = serverProjection?.runs.find(
+      (run) => run.userMessageId === timelineAnchorMessageId,
+    );
+    if (anchorRun === undefined) return false;
+    return (
+      anchorRun.status !== "preparing" &&
+      anchorRun.status !== "queued" &&
+      anchorRun.status !== "starting" &&
+      anchorRun.status !== "running" &&
+      anchorRun.status !== "waiting"
+    );
+  }, [serverProjection, timelineAnchorMessageId]);
+  useEffect(() => {
+    if (!anchorRunSettled) return;
+    setTimelineAnchor({ threadKey: activeThreadKey, messageId: null });
+  }, [anchorRunSettled, activeThreadKey]);
   const activeRightPanelKind = useRightPanelStore((state) =>
     selectActiveRightPanel(state.byThreadKey, activeThreadRef),
   );
@@ -1713,8 +1853,6 @@ function ChatViewContent(props: ChatViewProps) {
   const [pullRequestTabStatuses, setPullRequestTabStatuses] = useState<
     Record<string, PullRequestTabStatus>
   >({});
-  // Keyed by the surface the panel is showing rather than by a key rebuilt from the status, so
-  // the tab is found again whether or not that surface was opened with an environment on it.
   const activePullRequestSurfaceId =
     activeRightPanelSurface?.kind === "pull-request" ? activeRightPanelSurface.id : undefined;
   const handlePullRequestTabStatusChange = useCallback(
@@ -1728,14 +1866,6 @@ function ChatViewContent(props: ChatViewProps) {
   const activeFileSurface =
     activeRightPanelSurface?.kind === "file" ? activeRightPanelSurface : null;
   const activePreviewState = useThreadPreviewState(activeThreadRef);
-  const activePreviewServerEpoch = activePreviewState.serverEpoch;
-  const resolvePreviewRuntimeTabId = useMemo(
-    () =>
-      activeThreadRef
-        ? (tabId: string) => previewRuntimeTabId(activeThreadRef, activePreviewServerEpoch, tabId)
-        : undefined,
-    [activeThreadRef, activePreviewServerEpoch],
-  );
   const activePreviewMiniPlayer = usePreviewMiniPlayerStore((state) =>
     selectThreadPreviewMiniPlayer(state.byThreadKey, activeThreadRef),
   );
@@ -1754,10 +1884,23 @@ function ChatViewContent(props: ChatViewProps) {
   );
   const previewPanelOpen = activeRightPanelKind === "preview" && isPreviewSupportedInRuntime();
   const rightPanelOpen = rightPanelState.isOpen;
-  const canMaximizeRightPanel = rightPanelOpen && !shouldUseRightPanelSheet;
+  const canMaximizeRightPanel = rightPanelOpen && !shouldUsePlanSidebarSheet;
   const rightPanelMaximized =
     canMaximizeRightPanel && maximizedRightPanelThreadKey === routeThreadKey;
-  const inlineRightPanelOwnsTitleBar = rightPanelOpen && !shouldUseRightPanelSheet;
+  const inlineRightPanelOwnsTitleBar = rightPanelOpen && !shouldUsePlanSidebarSheet;
+  const threadPanelPresentation = resolveThreadPanelPresentation(
+    workspaceLayoutWidth,
+    inlineRightPanelOwnsTitleBar ? previewPanelInlineSize.width : 0,
+    rightPanelMaximized,
+  );
+  const threadPanelOpen = useRightPanelStore((state) =>
+    selectThreadPanelOpen(
+      state.threadPanelVisibilityByThreadKey,
+      activeThreadRef,
+      threadPanelPresentation,
+    ),
+  );
+  const inlineThreadPanelOpen = threadPanelOpen && threadPanelPresentation === "inline";
 
   useEffect(() => {
     if (!activeThreadRef) return;
@@ -1788,28 +1931,6 @@ function ChatViewContent(props: ChatViewProps) {
     const existingThreadKeys = new Set<string>([...serverThreadKeys, ...draftThreadKeys]);
     return openTerminalThreadKeys.filter((nextThreadKey) => existingThreadKeys.has(nextThreadKey));
   }, [draftThreadKeys, openTerminalThreadKeys, serverThreadKeys]);
-  const activeLatestTurn = activeThread?.latestTurn ?? null;
-  const activeRunningTurnId =
-    (activeThread?.session?.status === "running" ? activeThread.session.activeTurnId : null) ??
-    (activeLatestTurn?.state === "running" ? activeLatestTurn.turnId : null);
-  // Reading a finished thread clears the sidebar's Done badge. The visit is
-  // stamped at the turn's completion time — not now/updatedAt — so it clears
-  // exactly the completion the user is looking at: a wake or completion that
-  // lands later still gets its signal (markThreadVisited never moves the
-  // timestamp backwards).
-  useEffect(() => {
-    const completedAt = serverThread?.latestTurn?.completedAt;
-    if (!serverThread?.id || !completedAt) return;
-    markThreadVisited(
-      scopedThreadKey(scopeThreadRef(serverThread.environmentId, serverThread.id)),
-      completedAt,
-    );
-  }, [
-    markThreadVisited,
-    serverThread?.environmentId,
-    serverThread?.id,
-    serverThread?.latestTurn?.completedAt,
-  ]);
   useEffect(() => {
     setMountedTerminalThreadKeys((currentThreadIds) => {
       const nextThreadIds = reconcileMountedTerminalThreadIds({
@@ -1825,7 +1946,32 @@ function ChatViewContent(props: ChatViewProps) {
         : nextThreadIds;
     });
   }, [activeThreadKey, existingOpenTerminalThreadKeys, terminalUiState.terminalOpen]);
-  const latestTurnSettled = isLatestTurnSettled(activeLatestTurn, activeThread?.session ?? null);
+  const latestRunSettled = isLatestRunSettled(activeLatestRun, activeRuntime);
+  const activePlan = useMemo(
+    () => deriveActivePlanState(serverProjection, activeActivityRun?.runId),
+    [activeActivityRun?.runId, serverProjection],
+  );
+  // Tasks progress for the running turn's own plan only — deriveActivePlanState
+  // falls back to older runs' plans, which must not label fresh work.
+  const activeComposerTasksProgress = useMemo(() => {
+    if (
+      isLatestRunSettled(activeActivityRun, activeRuntime) ||
+      !activePlan ||
+      activePlan.runId !== (activeActivityRun?.runId ?? null)
+    ) {
+      return null;
+    }
+    const totalSteps = activePlan.steps.length;
+    if (totalSteps === 0) return null;
+    const completedSteps = activePlan.steps.filter((step) => step.status === "completed").length;
+    const step =
+      activePlan.steps.find((candidate) => candidate.status === "inProgress")?.step ??
+      activePlan.steps.find((candidate) => candidate.status === "pending")?.step ??
+      activePlan.steps.at(-1)!.step;
+    return { step, completedSteps, totalSteps };
+  }, [activeActivityRun, activePlan, activeRuntime]);
+  const activeComposerTaskSteps =
+    activeComposerTasksProgress && activePlan ? activePlan.steps : null;
   const activeProjectRef = useMemo(
     () =>
       activeThread ? scopeProjectRef(activeThread.environmentId, activeThread.projectId) : null,
@@ -1842,8 +1988,6 @@ function ChatViewContent(props: ChatViewProps) {
   const activeProjectKey = activeProject
     ? `${activeProject.environmentId}:${activeProject.workspaceRoot}`
     : null;
-  const projectGroupingSettings = useClientSettings(selectProjectGroupingSettings);
-  const clientSettingsHydrated = useClientSettingsHydrated();
   const [pendingFileSurfaceIdsByProject, setPendingFileSurfaceIdsByProject] = useState<
     ReadonlyMap<string, ReadonlySet<string>>
   >(() => new Map());
@@ -1886,54 +2030,11 @@ function ChatViewContent(props: ChatViewProps) {
     if (!activeThreadRef || !activeProjectRef) return;
     registerFaviconProjectForThread(activeThreadRef, activeProjectRef);
   }, [activeProjectRef, activeThreadRef]);
-  useEffect(() => {
-    if (!clientSettingsHydrated || !activeThreadRef || !activeProject) return;
-    // Reuse the sidebar's grouping so history follows the project rows the user
-    // sees. Deriving the key from the active project alone would miss the
-    // identity a duplicate row borrows from its siblings.
-    const logicalKeyByPhysicalKey = buildPhysicalToLogicalProjectKeyMap({
-      projects: allProjects,
-      settings: projectGroupingSettings,
-      primaryEnvironmentId,
-    });
-    useBrowserHistoryStore
-      .getState()
-      .registerThreadProject(
-        activeThreadRef,
-        logicalKeyByPhysicalKey.get(derivePhysicalProjectKey(activeProject)) ??
-          deriveLogicalProjectKeyFromSettings(activeProject, projectGroupingSettings),
-      );
-  }, [
-    activeProject,
-    activeThreadRef,
-    allProjects,
-    clientSettingsHydrated,
-    primaryEnvironmentId,
-    projectGroupingSettings,
-  ]);
   const activeEnvironment =
     activeThread == null ? null : (environmentById.get(activeThread.environmentId) ?? null);
   const activeEnvironmentConnectionPhase = activeEnvironment?.connection.phase ?? "available";
   const activeEnvironmentUnavailable =
     activeEnvironment !== null && activeEnvironmentConnectionPhase !== "connected";
-  const activeReconnectingEnvironmentId =
-    activeEnvironmentConnectionPhase === "connecting" ||
-    activeEnvironmentConnectionPhase === "reconnecting"
-      ? (activeEnvironment?.environmentId ?? null)
-      : null;
-  const [reconnectWarningGraceElapsedEnvironmentId, setReconnectWarningGraceElapsedEnvironmentId] =
-    useState<EnvironmentId | null>(null);
-  const reconnectWarningGraceElapsed = hasEnvironmentReconnectWarningGraceElapsed(
-    activeReconnectingEnvironmentId,
-    reconnectWarningGraceElapsedEnvironmentId,
-  );
-  useEffect(() => {
-    setReconnectWarningGraceElapsedEnvironmentId(null);
-    if (activeReconnectingEnvironmentId === null) return;
-    return scheduleEnvironmentReconnectWarning(() =>
-      setReconnectWarningGraceElapsedEnvironmentId(activeReconnectingEnvironmentId),
-    );
-  }, [activeReconnectingEnvironmentId]);
   const activeEnvironmentUnavailableLabel = activeEnvironment?.label ?? null;
   const activeEnvironmentUnavailableState = useMemo<EnvironmentUnavailableState | null>(() => {
     if (!activeEnvironmentUnavailable || !activeEnvironmentUnavailableLabel || !activeEnvironment) {
@@ -1962,6 +2063,7 @@ function ChatViewContent(props: ChatViewProps) {
     },
     [retryEnvironment],
   );
+  const projectGroupingSettings = selectProjectGroupingSettings(settings);
   const logicalProjectEnvironments = useMemo(() => {
     if (!activeProject) return [];
     const logicalKey = deriveLogicalProjectKeyFromSettings(activeProject, projectGroupingSettings);
@@ -1995,15 +2097,6 @@ function ChatViewContent(props: ChatViewProps) {
     return envs;
   }, [activeProject, allProjects, projectGroupingSettings, primaryEnvironmentId, environmentById]);
   const hasMultipleEnvironments = logicalProjectEnvironments.length > 1;
-  const activeEnvironmentOption =
-    logicalProjectEnvironments.find(
-      (environment) => environment.environmentId === activeThread?.environmentId,
-    ) ?? null;
-  const showComposerEnvironmentIndicator = shouldShowEnvironmentIndicator({
-    activeEnvironment: activeEnvironmentOption,
-    canPickEnvironment: hasMultipleEnvironments,
-  });
-
   const openPullRequestDialog = useCallback(
     (reference?: string) => {
       if (!canCheckoutPullRequestIntoThread) {
@@ -2109,6 +2202,70 @@ function ChatViewContent(props: ChatViewProps) {
     [openOrReuseProjectDraftThread],
   );
 
+  useEffect(() => {
+    if (!serverThread?.id) return;
+    const threadUpdatedAt = Date.parse(serverThread.updatedAt);
+    if (Number.isNaN(threadUpdatedAt)) return;
+    const effectiveLastVisitedAt = resolveThreadLastVisitedAt(
+      serverThread.lastVisitedAt,
+      activeThreadLocalLastVisitedAt,
+    );
+    const lastVisitedAt = effectiveLastVisitedAt ? Date.parse(effectiveLastVisitedAt) : NaN;
+    if (!Number.isNaN(lastVisitedAt) && lastVisitedAt >= threadUpdatedAt) return;
+
+    if (serverThread.lastVisitedAt !== undefined) {
+      // Server-tracked visited state: record the watermark server-side so it
+      // syncs across every device connected to the environment. Dedupe per
+      // watermark — the effect re-runs before the command's echo lands. The
+      // dedupe also keeps a mark-unread on the open thread sticky: the rewind
+      // leaves updatedAt untouched, so the already-dispatched key skips a
+      // fresh visit until new activity lands or the thread is reopened.
+      const dispatchKey = `${routeThreadKey}:${serverThread.updatedAt}`;
+      if (lastDispatchedVisitRef.current === dispatchKey) return;
+      const dispatch = () => {
+        lastDispatchedVisitRef.current = dispatchKey;
+        lastVisitDispatchAtRef.current = Date.now();
+        void visitThreadMutation({
+          environmentId: serverThread.environmentId,
+          input: { threadId: serverThread.id, visitedAt: serverThread.updatedAt },
+        });
+      };
+      // Unread prominence only flips on run completions (hasUnseenCompletion),
+      // so an unseen completion publishes immediately; mid-turn activity bumps
+      // — several per second while a turn streams — ride a trailing throttle,
+      // each rerun swapping the timer so the trailing dispatch carries the
+      // newest watermark.
+      const latestRunCompletedAtMs = serverThread.latestRun?.completedAt
+        ? Date.parse(serverThread.latestRun.completedAt)
+        : NaN;
+      const hasUnseenCompletion =
+        !Number.isNaN(latestRunCompletedAtMs) &&
+        (Number.isNaN(lastVisitedAt) || latestRunCompletedAtMs > lastVisitedAt);
+      const elapsed = Date.now() - lastVisitDispatchAtRef.current;
+      if (hasUnseenCompletion || elapsed >= VISIT_DISPATCH_THROTTLE_MS) {
+        dispatch();
+        return;
+      }
+      const timer = setTimeout(dispatch, VISIT_DISPATCH_THROTTLE_MS - elapsed);
+      return () => clearTimeout(timer);
+    }
+
+    markThreadVisited(
+      scopedThreadKey(scopeThreadRef(serverThread.environmentId, serverThread.id)),
+      serverThread.updatedAt,
+    );
+  }, [
+    activeThreadLocalLastVisitedAt,
+    markThreadVisited,
+    routeThreadKey,
+    serverThread?.environmentId,
+    serverThread?.id,
+    serverThread?.lastVisitedAt,
+    serverThread?.latestRun?.completedAt,
+    serverThread?.updatedAt,
+    visitThreadMutation,
+  ]);
+
   const selectedProviderByThreadId = composerActiveProvider ?? null;
   const threadProvider =
     activeThread?.modelSelection.instanceId ??
@@ -2119,6 +2276,7 @@ function ChatViewContent(props: ChatViewProps) {
     selectedProvider: selectedProviderByThreadId,
     threadProvider,
   });
+  const modelPickerLockedProvider = supportsProviderSwitchingViaHandoff ? null : lockedProvider;
   // Once a thread selects an environment, never substitute the primary
   // environment's config while the selected environment is still loading.
   const serverConfig = activeThread
@@ -2154,6 +2312,18 @@ function ChatViewContent(props: ChatViewProps) {
     hasMultipleRegisteredEnvironments && activeThread
       ? `${environmentById.get(activeThread.environmentId)?.label ?? serverConfig?.environment.label ?? activeThread.environmentId} server`
       : "server";
+  const reconnectActiveEnvironment = useCallback(() => {
+    if (!activeEnvironmentUnavailableState) return;
+    void handleReconnectActiveEnvironment(activeEnvironmentUnavailableState.environmentId);
+  }, [activeEnvironmentUnavailableState, handleReconnectActiveEnvironment]);
+  const openConnectionSettings = useCallback(() => {
+    void navigate({ to: "/settings/connections" });
+  }, [navigate]);
+  const handleDismissVersionMismatch = useCallback(() => {
+    if (!versionMismatchDismissKey) return;
+    dismissVersionMismatch(versionMismatchDismissKey);
+    setDismissedVersionMismatchKey(versionMismatchDismissKey);
+  }, [setDismissedVersionMismatchKey, versionMismatchDismissKey]);
   const serverUpdateEnvironmentId = activeThread?.environmentId ?? null;
   const versionMismatchSelfUpdate = resolveServerSelfUpdateCapability(serverConfig);
   const serverUpdateState = useAtomValue(
@@ -2184,9 +2354,7 @@ function ChatViewContent(props: ChatViewProps) {
     // While an update runs, transient connect blips are expected (the server
     // restarts) and the update banner already shows progress. Hard failure
     // phases still surface so the Reconnect action stays reachable.
-    const suppressUnavailableBanner =
-      environmentReconnecting &&
-      (updateRunning || (!reconnectingThroughVersionSkew && !reconnectWarningGraceElapsed));
+    const suppressUnavailableBanner = updateRunning && environmentReconnecting;
     if (activeEnvironmentUnavailableState && unavailableConnection && !suppressUnavailableBanner) {
       if (reconnectingThroughVersionSkew) {
         items.push({
@@ -2311,7 +2479,6 @@ function ChatViewContent(props: ChatViewProps) {
     return items;
   }, [
     activeEnvironmentUnavailableState,
-    reconnectWarningGraceElapsed,
     handleReconnectActiveEnvironment,
     navigate,
     setDismissedVersionMismatchKey,
@@ -2329,34 +2496,23 @@ function ChatViewContent(props: ChatViewProps) {
     providerStatuses,
     selectedProviderByThreadId ?? threadProvider,
   );
-  const selectedProvider: ProviderDriverKind = lockedProvider ?? unlockedSelectedProvider;
-  const phase = derivePhase(activeThread?.session ?? null);
-  const threadActivities = activeThread?.activities ?? EMPTY_ACTIVITIES;
-  const activeContextWindow = useMemo(
-    () => deriveLatestContextWindowSnapshot(threadActivities),
-    [threadActivities],
-  );
-  const workLogEntries = useMemo(() => deriveWorkLogEntries(threadActivities), [threadActivities]);
-  const turnPlans = useMemo(() => deriveTurnPlans(threadActivities), [threadActivities]);
-  // Native subagent fold: memoized by activity-list identity, shared by the
-  // Agents surface, live strip, and workflow cards. v2Projection is null
-  // until orchestration-v2 lands (source precedence lives in the derive).
-  // sessionLive derives interruption for agents orphaned by session death.
-  const agentSessionLive = phase !== "disconnected";
-  const agentPanelModel = useMemo(
+  const selectedProvider: ProviderDriverKind =
+    modelPickerLockedProvider ?? unlockedSelectedProvider;
+  const phase = derivePhase(activeRuntime);
+  const pendingRequests = useMemo(
     () =>
-      deriveAgentPanelModel({
-        agents: foldSubagentActivities(threadActivities, { sessionLive: agentSessionLive }),
-      }),
-    [agentSessionLive, threadActivities],
+      serverProjection === null
+        ? { approvals: [], userInputs: [] }
+        : derivePendingThreadRequests(serverProjection),
+    [serverProjection],
   );
   const pendingApprovals = useMemo(
-    () => derivePendingApprovals(threadActivities),
-    [threadActivities],
+    () => derivePendingApprovals(pendingRequests.approvals),
+    [pendingRequests.approvals],
   );
   const pendingUserInputs = useMemo(
-    () => derivePendingUserInputs(threadActivities),
-    [threadActivities],
+    () => derivePendingUserInputs(pendingRequests.userInputs),
+    [pendingRequests.userInputs],
   );
   const activePendingUserInput = pendingUserInputs[0] ?? null;
   const activePendingDraftAnswers = useMemo(
@@ -2389,25 +2545,19 @@ function ChatViewContent(props: ChatViewProps) {
     [activePendingDraftAnswers, activePendingUserInput],
   );
   const activePendingIsResponding = activePendingUserInput
-    ? respondingUserInputRequestIds.includes(activePendingUserInput.requestId)
+    ? activePendingUserInput.responseCapability !== "live" ||
+      respondingUserInputRequestIds.includes(activePendingUserInput.requestId)
     : false;
   const activeProposedPlan = useMemo(() => {
-    if (!latestTurnSettled) {
+    if (!latestRunSettled) {
       return null;
     }
-    return findLatestProposedPlan(
-      activeThread?.proposedPlans ?? [],
-      activeLatestTurn?.turnId ?? null,
-    );
-  }, [activeLatestTurn?.turnId, activeThread?.proposedPlans, latestTurnSettled]);
-  const activePlan = useMemo(
-    () => deriveActivePlanState(threadActivities, activeLatestTurn?.turnId ?? undefined),
-    [activeLatestTurn?.turnId, threadActivities],
-  );
+    return findLatestProposedPlan(serverProjection, activeLatestRun?.runId ?? null);
+  }, [activeLatestRun?.runId, latestRunSettled, serverProjection]);
   const showPlanFollowUpPrompt = shouldShowPlanFollowUpPrompt({
     pendingUserInputCount: pendingUserInputs.length,
     interactionMode,
-    latestTurnSettled,
+    latestTurnSettled: latestRunSettled,
     hasActionableProposedPlan: hasActionableProposedPlan(activeProposedPlan),
     hasComposerAttachments: composerHasAttachments,
   });
@@ -2416,24 +2566,52 @@ function ChatViewContent(props: ChatViewProps) {
     beginLocalDispatch,
     resetLocalDispatch,
     localDispatchStartedAt,
-    latestUserMessageAt,
     isPreparingWorktree,
     isSendBusy,
-    backgroundSubmissionPending,
   } = useLocalDispatchState({
     activeThread,
-    activeLatestTurn,
+    activeLatestRun,
+    latestUserMessageId:
+      serverProjection?.messages.findLast((message) => message.role === "user")?.id ?? null,
     phase,
     activePendingApproval: activePendingApproval?.requestId ?? null,
     activePendingUserInput: activePendingUserInput?.requestId ?? null,
     threadError,
   });
   const isWorking = phase === "running" || isSendBusy || isConnecting || isRevertingCheckpoint;
+  const activeContextWindow = useMemo(
+    () =>
+      deriveLatestContextWindowSnapshot(serverVisibleTurnItems ?? [], activeThreadLiveTokenUsage),
+    [activeThreadLiveTokenUsage, serverVisibleTurnItems],
+  );
+  // Conservative compact gate until the branch grows main's full compaction
+  // preconditions: Claude server threads only, and never mid-turn.
+  const composerCompactDisabled =
+    !isServerThread || selectedProvider !== "claudeAgent" || isWorking;
+  const pendingBackgroundTasks = useMemo(() => {
+    if (serverProjection === null || serverProjection === undefined) {
+      return [];
+    }
+    const latestRun =
+      serverProjection.runs.length === 0
+        ? null
+        : serverProjection.runs.reduce((latest, candidate) =>
+            candidate.ordinal > latest.ordinal ? candidate : latest,
+          );
+    return [
+      ...derivePendingBackgroundWork({
+        latestRun,
+        providerThreads: serverProjection.providerThreads,
+        turnItems: serverProjection.turnItems,
+        activeProviderThreadId: serverProjection.thread.activeProviderThreadId,
+        runs: serverProjection.runs,
+      }),
+    ];
+  }, [serverProjection]);
   const activeWorkStartedAt = deriveActiveWorkStartedAt(
-    activeLatestTurn,
-    activeThread?.session ?? null,
+    activeActivityRun,
+    activeRuntime,
     localDispatchStartedAt,
-    latestUserMessageAt,
   );
   useEffect(() => {
     attachmentPreviewHandoffByMessageIdRef.current = attachmentPreviewHandoffByMessageId;
@@ -2495,7 +2673,16 @@ function ChatViewContent(props: ChatViewProps) {
       return next;
     });
   }, []);
-  const serverMessages = activeThread?.messages;
+  const committedServerAttachmentIds = useMemo(() => {
+    const attachmentIds = new Set<string>();
+    for (const row of serverVisibleTurnItems) {
+      if (row.item.type !== "user_message") continue;
+      for (const attachment of row.item.attachments) {
+        attachmentIds.add(attachment.id);
+      }
+    }
+    return [...attachmentIds];
+  }, [serverVisibleTurnItems]);
   const downloadFileAttachment = useCallback(
     async (attachment: ChatFileAttachment) => {
       const connection = readPreparedConnection(environmentId);
@@ -2540,17 +2727,7 @@ function ChatViewContent(props: ChatViewProps) {
     },
     [createAttachmentAssetUrl, environmentId],
   );
-  const serverAttachmentIds = useMemo(() => {
-    const attachmentIds = new Set<string>();
-    for (const message of serverMessages ?? []) {
-      for (const attachment of message.attachments ?? []) {
-        if (isImageAttachment(attachment)) {
-          attachmentIds.add(attachment.id);
-        }
-      }
-    }
-    return [...attachmentIds];
-  }, [serverMessages]);
+  const serverAttachmentIds = isServerThread ? committedServerAttachmentIds : EMPTY_ATTACHMENT_IDS;
   const serverAttachmentResources = useMemo(
     () =>
       serverAttachmentIds.map((attachmentId) => ({
@@ -2570,31 +2747,16 @@ function ChatViewContent(props: ChatViewProps) {
       ),
     [serverAttachmentIds, serverAttachmentUrls],
   );
-  const displayServerMessages = useMemo<ReadonlyArray<ChatMessage>>(() => {
-    if (!serverMessages) return [];
-    return serverMessages.map((message) => {
-      if (!message.attachments || message.attachments.length === 0) {
-        return message;
-      }
-      return {
-        ...message,
-        attachments: message.attachments.map((attachment) => {
-          const previewUrl = serverAttachmentUrlById.get(attachment.id);
-          return previewUrl ? { ...attachment, previewUrl } : attachment;
-        }),
-      };
-    });
-  }, [serverAttachmentUrlById, serverMessages]);
   useEffect(() => {
-    if (typeof Image === "undefined" || displayServerMessages.length === 0) {
+    if (typeof Image === "undefined" || serverVisibleTurnItems.length === 0) {
       return;
     }
 
     const cleanups: Array<() => void> = [];
-    const userMessagesById = new Map<string, ChatMessage>(
-      displayServerMessages
-        .filter((message) => message.role === "user")
-        .map((message) => [String(message.id), message] as const),
+    const userMessagesById = new Map(
+      serverVisibleTurnItems.flatMap((row) =>
+        row.item.type === "user_message" ? [[String(row.item.messageId), row.item] as const] : [],
+      ),
     );
 
     for (const [messageId, handoffPreviewUrls] of Object.entries(
@@ -2605,12 +2767,16 @@ function ChatViewContent(props: ChatViewProps) {
       }
 
       const serverMessage = userMessagesById.get(messageId);
-      if (!serverMessage?.attachments || serverMessage.attachments.length === 0) {
+      if (serverMessage === undefined || serverMessage.attachments.length === 0) {
         continue;
       }
 
       const serverPreviewUrls = serverMessage.attachments.flatMap((attachment) =>
-        isImageAttachment(attachment) && attachment.previewUrl ? [attachment.previewUrl] : [],
+        attachment.type === "image"
+          ? [serverAttachmentUrlById.get(attachment.id)].filter(
+              (previewUrl): previewUrl is string => previewUrl !== undefined,
+            )
+          : [],
       );
       if (
         serverPreviewUrls.length === 0 ||
@@ -2668,99 +2834,80 @@ function ChatViewContent(props: ChatViewProps) {
         cleanup();
       }
     };
-  }, [attachmentPreviewHandoffByMessageId, clearAttachmentPreviewHandoff, displayServerMessages]);
-  const timelineMessages = useMemo(() => {
-    const messages = displayServerMessages;
-    const serverMessagesWithPreviewHandoff =
-      Object.keys(attachmentPreviewHandoffByMessageId).length === 0
-        ? messages
-        : // Spread only fires for the few messages that actually changed;
-          // unchanged ones early-return their original reference.
-          // In-place mutation would break React's immutable state contract.
-          messages.map((message) => {
-            if (
-              message.role !== "user" ||
-              !message.attachments ||
-              message.attachments.length === 0
-            ) {
-              return message;
-            }
-            const handoffPreviewUrls = attachmentPreviewHandoffByMessageId[message.id];
-            if (!handoffPreviewUrls || handoffPreviewUrls.length === 0) {
-              return message;
-            }
-
-            let changed = false;
-            let imageIndex = 0;
-            const attachments = message.attachments.map((attachment) => {
-              if (!isImageAttachment(attachment)) {
-                return attachment;
-              }
-              const handoffPreviewUrl = handoffPreviewUrls[imageIndex];
-              imageIndex += 1;
-              if (!handoffPreviewUrl || attachment.previewUrl === handoffPreviewUrl) {
-                return attachment;
-              }
-              changed = true;
-              return {
-                ...attachment,
-                previewUrl: handoffPreviewUrl,
-              };
-            });
-
-            return changed ? { ...message, attachments } : message;
-          });
-
-    const localMessages = [
-      ...optimisticUserMessages,
-      ...feedbackSubmissions.flatMap((submission) =>
-        submission.status === "interrupted"
-          ? []
-          : [codexFeedbackMessage(submission), codexFeedbackMessage(submission, "assistant")],
-      ),
-    ];
-    if (localMessages.length === 0) {
-      return serverMessagesWithPreviewHandoff;
-    }
-    const serverIds = new Set(serverMessagesWithPreviewHandoff.map((message) => message.id));
-    const pendingMessages = localMessages.filter((message) => !serverIds.has(message.id));
-    if (pendingMessages.length === 0) {
-      return serverMessagesWithPreviewHandoff;
-    }
-    return [...serverMessagesWithPreviewHandoff, ...pendingMessages];
   }, [
     attachmentPreviewHandoffByMessageId,
-    displayServerMessages,
-    feedbackSubmissions,
-    optimisticUserMessages,
+    clearAttachmentPreviewHandoff,
+    serverAttachmentUrlById,
+    serverVisibleTurnItems,
   ]);
-  const timelineEntries = useMemo(
+  const timelineAttachmentUrlById = useMemo(() => {
+    const urls = new Map(serverAttachmentUrlById);
+    for (const row of serverVisibleTurnItems) {
+      if (row.item.type !== "user_message") continue;
+      const handoffUrls = attachmentPreviewHandoffByMessageId[row.item.messageId];
+      if (handoffUrls === undefined) continue;
+      let imageIndex = 0;
+      for (const attachment of row.item.attachments) {
+        if (attachment.type !== "image") continue;
+        const handoffUrl = handoffUrls[imageIndex];
+        imageIndex += 1;
+        if (handoffUrl !== undefined) urls.set(attachment.id, handoffUrl);
+      }
+    }
+    return urls;
+  }, [attachmentPreviewHandoffByMessageId, serverAttachmentUrlById, serverVisibleTurnItems]);
+  const serverTimelineEntries = useMemo(
+    () =>
+      deriveTimelineEntriesFromVisibleTurnItems({
+        visibleTurnItems: serverVisibleTurnItems,
+        optimisticMessages: optimisticUserMessages,
+        anchoredMessages: feedbackSubmissions.flatMap((submission) =>
+          submission.status === "interrupted"
+            ? []
+            : [
+                { ...codexFeedbackMessage(submission), runId: null },
+                { ...codexFeedbackMessage(submission, "assistant"), runId: null },
+              ],
+        ),
+        attachmentUrlById: timelineAttachmentUrlById,
+        ...(serverProjection === null
+          ? {}
+          : {
+              attempts: serverProjection.attempts,
+              nodes: serverProjection.nodes,
+              plans: serverProjection.plans,
+            }),
+      }),
+    [
+      feedbackSubmissions,
+      optimisticUserMessages,
+      serverVisibleTurnItems,
+      serverProjection,
+      timelineAttachmentUrlById,
+    ],
+  );
+  const draftTimelineEntries = useMemo(
     () =>
-      deriveTimelineEntries(
-        timelineMessages,
-        activeThread?.proposedPlans ?? [],
-        workLogEntries,
-        turnPlans,
+      optimisticUserMessages.map(
+        (message) =>
+          ({
+            id: message.id,
+            kind: "message",
+            createdAt: message.createdAt,
+            message,
+          }) as const,
       ),
-    [activeThread?.proposedPlans, timelineMessages, turnPlans, workLogEntries],
+    [optimisticUserMessages],
   );
+  const timelineEntries = isServerThread ? serverTimelineEntries : draftTimelineEntries;
   const [dockedDraftHeroThreadKey, setDockedDraftHeroThreadKey] = useState<string | null>(null);
   const draftHeroDockRequested =
     activeThreadKey !== null && dockedDraftHeroThreadKey === activeThreadKey;
-  const isDraftHeroState = resolveDraftHeroState({
-    isLocalDraftThread,
-    hasTimelineEntries: timelineEntries.length > 0,
-    isWorking,
-    draftHeroDockRequested,
-    backgroundSubmissionPending,
-  });
-  const [
-    attachDraftHeroTransitionGroupRef,
-    attachDraftHeroComposerAnchorRef,
-    captureDraftHeroComposerRect,
-  ] = useDraftHeroLayoutTransition(isDraftHeroState);
-  const { turnDiffSummaries, inferredCheckpointTurnCountByTurnId } =
-    useTurnDiffSummaries(activeThread);
+  const isDraftHeroState =
+    isLocalDraftThread && timelineEntries.length === 0 && !isWorking && !draftHeroDockRequested;
+  const draftHeroTransition = useDraftHeroLayoutTransition(isDraftHeroState);
+  const captureDraftHeroComposerRect = draftHeroTransition.captureComposerRect;
+  const { turnDiffSummaries } = useTurnDiffSummaries(serverProjection);
   const turnDiffSummaryByAssistantMessageId = useMemo(() => {
     const byMessageId = new Map<MessageId, TurnDiffSummary>();
     for (const summary of turnDiffSummaries) {
@@ -2769,38 +2916,14 @@ function ChatViewContent(props: ChatViewProps) {
     }
     return byMessageId;
   }, [turnDiffSummaries]);
-  const revertTurnCountByUserMessageId = useMemo(() => {
-    const byUserMessageId = new Map<MessageId, number>();
-    for (let index = 0; index < timelineEntries.length; index += 1) {
-      const entry = timelineEntries[index];
-      if (!entry || entry.kind !== "message" || entry.message.role !== "user") {
-        continue;
-      }
-
-      for (let nextIndex = index + 1; nextIndex < timelineEntries.length; nextIndex += 1) {
-        const nextEntry = timelineEntries[nextIndex];
-        if (!nextEntry || nextEntry.kind !== "message") {
-          continue;
-        }
-        if (nextEntry.message.role === "user") {
-          break;
-        }
-        const summary = turnDiffSummaryByAssistantMessageId.get(nextEntry.message.id);
-        if (!summary) {
-          continue;
-        }
-        const turnCount =
-          summary.checkpointTurnCount ?? inferredCheckpointTurnCountByTurnId[summary.turnId];
-        if (typeof turnCount !== "number") {
-          break;
-        }
-        byUserMessageId.set(entry.message.id, Math.max(0, turnCount - 1));
-        break;
-      }
-    }
-
-    return byUserMessageId;
-  }, [inferredCheckpointTurnCountByTurnId, timelineEntries, turnDiffSummaryByAssistantMessageId]);
+  const revertTurnCountByUserMessageId = useMemo(
+    () =>
+      deriveRevertTurnCountByUserMessageId({
+        timelineEntries,
+        checkpoints: turnDiffSummaries,
+      }),
+    [timelineEntries, turnDiffSummaries],
+  );
 
   const gitCwd = activeProject
     ? projectScriptCwd({
@@ -2819,6 +2942,20 @@ function ChatViewContent(props: ChatViewProps) {
   );
   const keybindings = useAtomValue(primaryServerKeybindingsAtom);
   const availableEditors = useAtomValue(primaryServerAvailableEditorsAtom);
+  const remoteOpenState = useRemoteOpenState(activeThread?.environmentId ?? environmentId);
+  const showOpenInPicker = shouldShowOpenInPicker({
+    activeProjectName: activeProject?.title,
+    activeThreadEnvironmentId: activeThread?.environmentId ?? environmentId,
+    primaryEnvironmentId,
+    remoteOpenMode: remoteOpenState.mode,
+  });
+  useOpenFavoriteEditorShortcut({
+    enabled: showOpenInPicker,
+    environmentId: activeThread?.environmentId ?? environmentId,
+    keybindings,
+    availableEditors,
+    openInCwd: gitCwd,
+  });
   // Prefer an instance-id match so a custom Codex instance (e.g.
   // `codex_personal`) surfaces its own status/message in the banner rather
   // than the default Codex's. Falls back to first-match-by-kind when no
@@ -2828,33 +2965,10 @@ function ChatViewContent(props: ChatViewProps) {
       ?.instanceId ?? null;
   const activeProviderInstanceId =
     selectedProviderInstanceId ??
-    activeThread?.session?.providerInstanceId ??
+    activeRuntime?.providerInstanceId ??
     activeThread?.modelSelection.instanceId ??
     activeProject?.defaultModelSelection?.instanceId ??
     null;
-  const compactionProviderAvailable = useMemo(
-    () =>
-      hasAvailableClaudeCompactionProvider({
-        providers: applyProviderInstanceSettings(
-          deriveProviderInstanceEntries(providerStatuses),
-          settings,
-        ),
-        instanceId: activeProviderInstanceId,
-        lockedInstanceId: lockedProvider
-          ? (activeThread?.session?.providerInstanceId ??
-            activeThread?.modelSelection.instanceId ??
-            null)
-          : null,
-      }),
-    [
-      activeProviderInstanceId,
-      activeThread?.modelSelection.instanceId,
-      activeThread?.session?.providerInstanceId,
-      lockedProvider,
-      providerStatuses,
-      settings,
-    ],
-  );
   const activeProviderStatus = useMemo(() => {
     if (activeProviderInstanceId) {
       return (
@@ -2864,25 +2978,6 @@ function ChatViewContent(props: ChatViewProps) {
     const defaultInstanceId = defaultInstanceIdForDriver(selectedProvider);
     return providerStatuses.find((status) => status.instanceId === defaultInstanceId) ?? null;
   }, [activeProviderInstanceId, providerStatuses, selectedProvider]);
-  const [resumeCompactionPermanentlyDismissed, setResumeCompactionPermanentlyDismissed] =
-    useLocalStorage(
-      `t3code:resume-compaction-dismissed:${environmentId}:${activeProviderInstanceId ?? "claudeAgent"}`,
-      false,
-      Schema.Boolean,
-    );
-  const nativeResumeCompactionDismissed = useMemo(
-    () => hasDismissedResumeCompaction(threadActivities),
-    [threadActivities],
-  );
-  useEffect(() => {
-    if (nativeResumeCompactionDismissed && !resumeCompactionPermanentlyDismissed) {
-      setResumeCompactionPermanentlyDismissed(true);
-    }
-  }, [
-    nativeResumeCompactionDismissed,
-    resumeCompactionPermanentlyDismissed,
-    setResumeCompactionPermanentlyDismissed,
-  ]);
   const providerStatusBannerKey = getProviderStatusBannerKey(activeProviderStatus);
   const [dismissedProviderStatusBannerKey, setDismissedProviderStatusBannerKey] = useState<
     string | null
@@ -2907,10 +3002,15 @@ function ChatViewContent(props: ChatViewProps) {
   // Default true while loading to avoid toolbar flicker.
   const isGitRepo = gitStatusQuery.data?.isRepo ?? true;
   const showComposerContextStrip = shouldShowComposerContextStrip({
-    hasActiveProject: activeProject !== null,
+    isDraftHeroState,
     isGitRepo,
-    showEnvironmentIndicator: showComposerEnvironmentIndicator,
+    hasActiveProject: activeProject !== null,
+    persistInActiveThreads: settings.persistComposerContextStrip,
   });
+  const renderComposerContextStrip =
+    isGitRepo &&
+    activeProject !== null &&
+    (routeKind === "draft" || settings.persistComposerContextStrip);
   const initialDiffPanelGitScope =
     gitStatusQuery.data?.hasWorkingTreeChanges === true ? "unstaged" : "branch";
   const diffPanelGitStatusResolutionKey = gitStatusQuery.data ? "resolved" : "pending";
@@ -2952,11 +3052,7 @@ function ChatViewContent(props: ChatViewProps) {
     }
   }, [activeThreadRef, diffOpen, isServerThread, onDiffPanelOpen]);
 
-  const envLocked = Boolean(
-    activeThread &&
-    (activeThread.messages.length > 0 ||
-      (activeThread.session !== null && activeThread.session.status !== "stopped")),
-  );
+  const envLocked = Boolean(activeThread && (activeMessageCount > 0 || activeRuntime !== null));
 
   // Handle environment change for draft threads.  When the user picks a
   // different environment we update the draft context to point at the physical
@@ -2991,11 +3087,10 @@ function ChatViewContent(props: ChatViewProps) {
       const nextError = sanitizeThreadErrorMessage(error);
       const nextEntry: LocalThreadErrorEntry = { message: nextError, at: Date.now() };
       if (
-        shouldWriteThreadErrorToCurrentServerThread({
-          activeServerThread,
-          routeThreadRef,
-          targetThreadId,
-        })
+        serverThread &&
+        targetThreadId === routeThreadRef.threadId &&
+        serverThread.environmentId === routeThreadRef.environmentId &&
+        serverThread.id === targetThreadId
       ) {
         setLocalServerErrorsByThreadKey((existing) => {
           if ((existing[routeThreadKey]?.message ?? null) === nextError) {
@@ -3019,7 +3114,7 @@ function ChatViewContent(props: ChatViewProps) {
         };
       });
     },
-    [activeServerThread, draftId, routeThreadKey, routeThreadRef],
+    [draftId, routeThreadKey, routeThreadRef, serverThread],
   );
 
   const focusComposer = useCallback(() => {
@@ -3030,6 +3125,131 @@ function ChatViewContent(props: ChatViewProps) {
       focusComposer();
     });
   }, [focusComposer]);
+  const editQueuedRunCommand = useAtomCommand(threadEnvironment.editQueuedRun, {
+    reportFailure: false,
+  });
+  const queuedEditSaveInFlightRef = useRef(false);
+  const queuedEditImageResources = useMemo(
+    () =>
+      (editingQueuedRun?.existingAttachments ?? [])
+        .filter((attachment) => attachment.type === "image")
+        .map((attachment) => ({ _tag: "attachment" as const, attachmentId: attachment.id })),
+    [editingQueuedRun],
+  );
+  const queuedEditImageUrls = useAssetUrls(environmentId, queuedEditImageResources);
+  const composerEditingQueuedAttachments = useMemo(() => {
+    if (editingQueuedRun === null) return null;
+    const urlByAttachmentId = new Map(
+      queuedEditImageResources.map((resource, index) => [
+        resource.attachmentId,
+        queuedEditImageUrls[index] ?? null,
+      ]),
+    );
+    return editingQueuedRun.existingAttachments.map((attachment) => ({
+      attachment,
+      url: urlByAttachmentId.get(attachment.id) ?? null,
+    }));
+  }, [editingQueuedRun, queuedEditImageResources, queuedEditImageUrls]);
+  const beginEditingQueuedRun = useCallback(
+    (request: EditQueuedRunRequest) => {
+      if (!activeThread) return;
+      if (editingQueuedRun !== null && editingQueuedRun.runId !== request.runId) {
+        clearComposerDraftContent(queuedEditDraftTargetFor(editingQueuedRun.runId));
+      }
+      const target = queuedEditDraftTargetFor(request.runId);
+      clearComposerDraftContent(target);
+      setComposerDraftPrompt(target, request.text);
+      setEditingQueuedRun({
+        threadId: activeThread.id,
+        runId: request.runId,
+        messageId: request.messageId,
+        originalText: request.text,
+        existingAttachments: request.attachments,
+      });
+      scheduleComposerFocus();
+    },
+    [
+      activeThread,
+      clearComposerDraftContent,
+      editingQueuedRun,
+      queuedEditDraftTargetFor,
+      scheduleComposerFocus,
+      setComposerDraftPrompt,
+    ],
+  );
+  const cancelEditingQueuedRun = useCallback(() => {
+    if (editingQueuedRun === null) return;
+    clearComposerDraftContent(queuedEditDraftTargetFor(editingQueuedRun.runId));
+    setEditingQueuedRun(null);
+    scheduleComposerFocus();
+  }, [
+    clearComposerDraftContent,
+    editingQueuedRun,
+    queuedEditDraftTargetFor,
+    scheduleComposerFocus,
+  ]);
+  const removeEditingQueuedAttachment = useCallback((attachmentId: string) => {
+    setEditingQueuedRun((current) =>
+      current === null
+        ? current
+        : {
+            ...current,
+            existingAttachments: current.existingAttachments.filter(
+              (attachment) => attachment.id !== attachmentId,
+            ),
+          },
+    );
+  }, []);
+  // Exit edit mode when the edited run leaves the queue (it started, or was
+  // cancelled from another client). A dirty edit moves into the thread's own
+  // draft when that draft is empty; otherwise it is dropped with a toast.
+  useEffect(() => {
+    if (editingQueuedRun === null) return;
+    if (activeThread?.id !== editingQueuedRun.threadId) {
+      setEditingQueuedRun(null);
+      return;
+    }
+    if (serverProjection === null) return;
+    const run = serverProjection.runs.find((candidate) => candidate.id === editingQueuedRun.runId);
+    if (run !== undefined && run.status === "queued") return;
+    const store = useComposerDraftStore.getState();
+    const editTarget = queuedEditDraftTargetFor(editingQueuedRun.runId);
+    const editDraft = store.getComposerDraft(editTarget);
+    const editIsDirty =
+      editDraft !== null &&
+      (editDraft.prompt !== editingQueuedRun.originalText || editDraft.images.length > 0);
+    if (
+      editIsDirty &&
+      !composerDraftHasUserContent(store.getComposerDraft(baseComposerDraftTarget))
+    ) {
+      store.moveComposerPromptAndImages(editTarget, baseComposerDraftTarget);
+      toastManager.add(
+        stackedThreadToast({
+          type: "info",
+          title: "Queued message is no longer queued",
+          description: "Your unsaved edit was kept in the composer.",
+        }),
+      );
+    } else {
+      store.clearComposerContent(editTarget);
+      if (editIsDirty) {
+        toastManager.add(
+          stackedThreadToast({
+            type: "warning",
+            title: "Queued message is no longer queued",
+            description: "Your unsaved edit was discarded.",
+          }),
+        );
+      }
+    }
+    setEditingQueuedRun(null);
+  }, [
+    activeThread?.id,
+    baseComposerDraftTarget,
+    editingQueuedRun,
+    queuedEditDraftTargetFor,
+    serverProjection,
+  ]);
   const addTerminalContextToDraft = useCallback(
     (selection: TerminalContextSelection) => {
       composerRef.current?.addTerminalContext(selection);
@@ -3499,6 +3719,10 @@ function ChatViewContent(props: ChatViewProps) {
   const toggleInteractionMode = useCallback(() => {
     handleInteractionModeChange(interactionMode === "plan" ? "default" : "plan");
   }, [handleInteractionModeChange, interactionMode]);
+  const addAgentsSurface = useCallback(() => {
+    if (!activeThreadRef) return;
+    useRightPanelStore.getState().open(activeThreadRef, "agents");
+  }, [activeThreadRef]);
   const createBrowserSurface = useCallback(() => {
     if (!activeThreadRef) return;
     void addBrowserSurface({ threadRef: activeThreadRef, openPreview });
@@ -3508,14 +3732,13 @@ function ChatViewContent(props: ChatViewProps) {
     useRightPanelStore.getState().open(activeThreadRef, "diff");
     onDiffPanelOpen?.();
   }, [activeThreadRef, isGitRepo, isServerThread, onDiffPanelOpen]);
+  const openChangesFromThreadPanel = useCallback(() => {
+    addDiffSurface();
+  }, [addDiffSurface]);
   const addFilesSurface = useCallback(() => {
     if (!activeThreadRef || !activeProject) return;
     useRightPanelStore.getState().open(activeThreadRef, "files");
   }, [activeProject, activeThreadRef]);
-  const addAgentsSurface = useCallback(() => {
-    if (!activeThreadRef) return;
-    useRightPanelStore.getState().open(activeThreadRef, "agents");
-  }, [activeThreadRef]);
   const openFileSurface = useCallback(
     (relativePath: string) => {
       if (!activeThreadRef || !activeProject) return;
@@ -3525,48 +3748,24 @@ function ChatViewContent(props: ChatViewProps) {
   );
   // The thread's own change request, placed against the project it belongs to. Without a
   // project there is nothing to resolve it against, so the caller falls back to the browser.
-  const linkedThreadPullRequest = activeThread?.linkedPullRequest ?? null;
-  const activeProjectRepository = activeProject?.repositoryIdentity?.displayName ?? null;
-  const threadRepository = linkedThreadPullRequest?.repository ?? activeProjectRepository;
+  const threadRepository = activeProject?.repositoryIdentity?.displayName ?? null;
   const openThreadPullRequest = useCallback(
-    (number: number) => {
-      if (!supportsPullRequests || !activeThreadRef) {
-        return;
-      }
-      const projectId = linkedThreadPullRequest?.projectId ?? activeProject?.id;
-      const repository = linkedThreadPullRequest?.repository ?? activeProjectRepository;
-      if (projectId === undefined || repository === null) return;
-      useRightPanelStore.getState().openPullRequest(activeThreadRef, {
-        projectId,
-        repository,
-        number,
-      });
-    },
-    [
-      activeProject,
-      activeProjectRepository,
-      activeThreadRef,
-      linkedThreadPullRequest,
-      supportsPullRequests,
-    ],
-  );
-  const openProjectPullRequest = useCallback(
     (number: number) => {
       if (
         !supportsPullRequests ||
         !activeThreadRef ||
         !activeProject ||
-        activeProjectRepository === null
+        threadRepository === null
       ) {
         return;
       }
       useRightPanelStore.getState().openPullRequest(activeThreadRef, {
         projectId: activeProject.id,
-        repository: activeProjectRepository,
+        repository: threadRepository,
         number,
       });
     },
-    [activeProject, activeProjectRepository, activeThreadRef, supportsPullRequests],
+    [activeProject, activeThreadRef, supportsPullRequests, threadRepository],
   );
   const togglePreviewPanel = useCallback(() => {
     if (!activeThreadRef || !isPreviewSupportedInRuntime()) return;
@@ -3685,24 +3884,6 @@ function ChatViewContent(props: ChatViewProps) {
     },
     [activeRightPanelSurface, activeThreadRef, closeTerminalMutation, storeCloseTerminal],
   );
-  const requestCloseTerminal = useCallback(
-    (terminalId: string) => {
-      const label = activeTerminalLabelsById.get(terminalId) ?? getTerminalLabel(terminalId);
-      void confirmTerminalClose([label]).then((confirmed) => {
-        if (confirmed) closeTerminal(terminalId);
-      });
-    },
-    [activeTerminalLabelsById, closeTerminal],
-  );
-  const requestClosePanelTerminal = useCallback(
-    (terminalId: string) => {
-      const label = activeTerminalLabelsById.get(terminalId) ?? getTerminalLabel(terminalId);
-      void confirmTerminalClose([label]).then((confirmed) => {
-        if (confirmed) closePanelTerminal(terminalId);
-      });
-    },
-    [activeTerminalLabelsById, closePanelTerminal],
-  );
   const activateRightPanelSurface = useCallback(
     (surface: RightPanelSurface) => {
       if (!activeThreadRef) return;
@@ -3727,6 +3908,14 @@ function ChatViewContent(props: ChatViewProps) {
     }
     useRightPanelStore.getState().toggleVisibility(activeThreadRef);
   }, [activeThreadRef, closePreviewPanel, rightPanelOpen]);
+  const toggleThreadPanel = useCallback(() => {
+    if (!activeThreadRef) return;
+    useRightPanelStore.getState().toggleThreadPanel(activeThreadRef, threadPanelPresentation);
+  }, [activeThreadRef, threadPanelPresentation]);
+  const closeThreadPanelPopover = useCallback(() => {
+    if (!activeThreadRef) return;
+    useRightPanelStore.getState().setThreadPanelOpen(activeThreadRef, "popover", false);
+  }, [activeThreadRef]);
   const toggleRightPanelMaximized = useCallback(() => {
     if (!canMaximizeRightPanel) return;
     setMaximizedRightPanelThreadKey((threadKey) =>
@@ -3777,33 +3966,11 @@ function ChatViewContent(props: ChatViewProps) {
   const closeRightPanelSurface = useCallback(
     (surface: RightPanelSurface) => {
       if (!activeThreadRef) return;
-      const finishClose = () => {
-        cleanupRightPanelSurfaces([surface]);
-        useRightPanelStore.getState().closeSurface(activeThreadRef, surface.id);
-        syncActivePreviewSurface();
-      };
-      if (surface.kind !== "terminal") {
-        finishClose();
-        return;
-      }
-      const activeLabel =
-        activeTerminalLabelsById.get(surface.activeTerminalId) ??
-        getTerminalLabel(surface.activeTerminalId);
-      const otherLabels = surface.terminalIds
-        .filter((terminalId) => terminalId !== surface.activeTerminalId)
-        .map(
-          (terminalId) => activeTerminalLabelsById.get(terminalId) ?? getTerminalLabel(terminalId),
-        );
-      void confirmTerminalClose([activeLabel, ...otherLabels]).then((confirmed) => {
-        if (confirmed) finishClose();
-      });
+      cleanupRightPanelSurfaces([surface]);
+      useRightPanelStore.getState().closeSurface(activeThreadRef, surface.id);
+      syncActivePreviewSurface();
     },
-    [
-      activeThreadRef,
-      activeTerminalLabelsById,
-      cleanupRightPanelSurfaces,
-      syncActivePreviewSurface,
-    ],
+    [activeThreadRef, cleanupRightPanelSurfaces, syncActivePreviewSurface],
   );
   const closeOtherRightPanelSurfaces = useCallback(
     (surface: RightPanelSurface) => {
@@ -3972,12 +4139,24 @@ function ChatViewContent(props: ChatViewProps) {
   const positionedTimelineAnchorRef = useRef<MessageId | null>(null);
   const settledTimelineAnchorRef = useRef<MessageId | null>(null);
   const activeTimelineAnchorIndexRef = useRef<number | null>(null);
+  const observedTimelineActivityRef = useRef<{
+    readonly threadKey: string | null;
+    readonly runId: RunId | null;
+  }>({
+    threadKey: activeThreadKey,
+    runId: activeActivityRun?.runId ?? null,
+  });
   const anchorUserScrollGenerationRef = useRef(0);
   const liveFollowUserScrollGenerationRef = useRef<number | null>(0);
-  // Manual navigation stops live-follow without removing anchored end space.
-  // Collapsing that space during a gesture clamps the viewport back to the end.
+  const pendingAnchorScrollRestoreRef = useRef<{
+    readonly messageId: MessageId;
+    readonly offset: number;
+    readonly userScrollGeneration: number;
+  } | null>(null);
+  const anchorScrollRestoreFrameRef = useRef<number | null>(null);
   const cancelTimelineLiveFollowForUserNavigation = useCallback(() => {
     anchorUserScrollGenerationRef.current += 1;
+    const wasProgrammaticScrollMode = timelineScrollModeRef.current !== "free-scrolling";
     timelineScrollModeRef.current = "free-scrolling";
     liveFollowUserScrollGenerationRef.current = null;
     setTimelineLiveFollowEnabled(false);
@@ -3985,6 +4164,35 @@ function ChatViewContent(props: ChatViewProps) {
     positionedTimelineAnchorRef.current = null;
     settledTimelineAnchorRef.current = null;
     activeTimelineAnchorIndexRef.current = null;
+    pendingAnchorScrollRestoreRef.current = null;
+    if (anchorScrollRestoreFrameRef.current !== null) {
+      cancelAnimationFrame(anchorScrollRestoreFrameRef.current);
+      anchorScrollRestoreFrameRef.current = null;
+    }
+    if (wasProgrammaticScrollMode) {
+      // While following or anchoring, our scrollToEnd/scrollToOffset calls can
+      // sit in LegendList's pending-imperative-scroll queue (it defers them
+      // while layout settles) and fire seconds later with stale targets,
+      // yanking the view away after the user scrolled. Starting a new
+      // imperative scroll cancels everything queued; targeting an item that
+      // is not in the data makes the new request itself resolve without ever
+      // scrolling, so this is a pure cancel.
+      void legendListRef.current?.scrollToItem({
+        item: TIMELINE_SCROLL_CANCEL_SENTINEL,
+        animated: false,
+      });
+      // An already-started animated scroll (behavior: smooth) keeps running in
+      // the browser regardless of the queue; a same-position instant write is
+      // the only way to halt it where it is.
+      const scrollNode = legendListRef.current?.getScrollableNode() as
+        | { scrollTop?: number }
+        | null
+        | undefined;
+      const currentScrollTop = scrollNode?.scrollTop;
+      if (scrollNode && typeof currentScrollTop === "number") {
+        scrollNode.scrollTop = currentScrollTop;
+      }
+    }
   }, []);
   const cancelTimelineLiveFollowForUserNavigationRef = useRef(
     cancelTimelineLiveFollowForUserNavigation,
@@ -3993,6 +4201,49 @@ function ChatViewContent(props: ChatViewProps) {
     cancelTimelineLiveFollowForUserNavigationRef.current =
       cancelTimelineLiveFollowForUserNavigation;
   }, [cancelTimelineLiveFollowForUserNavigation]);
+  useEffect(() => {
+    const observed = observedTimelineActivityRef.current;
+    if (observed.threadKey !== activeThreadKey) {
+      observedTimelineActivityRef.current = {
+        threadKey: activeThreadKey,
+        runId: activeActivityRun?.runId ?? null,
+      };
+      return;
+    }
+    if (
+      activeActivityRun === null ||
+      activeActivityRun.status === "queued" ||
+      observed.runId === activeActivityRun.runId
+    ) {
+      return;
+    }
+    const dispatchedUserItem = serverProjection?.visibleTurnItems.find(
+      (row) => row.item.type === "user_message" && row.item.runId === activeActivityRun.runId,
+    );
+    if (dispatchedUserItem?.item.type !== "user_message") {
+      return;
+    }
+    observedTimelineActivityRef.current = {
+      threadKey: activeThreadKey,
+      runId: activeActivityRun.runId,
+    };
+    if (
+      pendingTimelineAnchorRef.current !== null ||
+      timelineScrollModeRef.current === "free-scrolling"
+    ) {
+      return;
+    }
+
+    const messageId = dispatchedUserItem.item.messageId;
+    isAtEndRef.current = true;
+    timelineScrollModeRef.current = "anchoring-new-turn";
+    liveFollowUserScrollGenerationRef.current = anchorUserScrollGenerationRef.current;
+    pendingTimelineAnchorRef.current = messageId;
+    activeTimelineAnchorIndexRef.current = null;
+    showScrollDebouncer.current.cancel();
+    setShowScrollToBottom(false);
+    setTimelineAnchor({ threadKey: activeThreadKey, messageId });
+  }, [activeActivityRun, activeThreadKey, serverProjection]);
   const getActiveTimelineTurnMetrics = useCallback(
     (list?: LegendListRef | null) => {
       const resolvedList = list ?? legendListRef.current;
@@ -4040,6 +4291,7 @@ function ChatViewContent(props: ChatViewProps) {
     },
     [composerOverlayHeight],
   );
+
   // Live-follow stays active after send/thread-open until an actual list scroll
   // gesture opts out.
   const scrollToEnd = useCallback((animated = false) => {
@@ -4048,38 +4300,16 @@ function ChatViewContent(props: ChatViewProps) {
     liveFollowUserScrollGenerationRef.current = anchorUserScrollGenerationRef.current;
     setTimelineLiveFollowEnabled(true);
     pendingTimelineAnchorRef.current = null;
-    positionedTimelineAnchorRef.current = null;
-    settledTimelineAnchorRef.current = null;
     activeTimelineAnchorIndexRef.current = null;
     showScrollDebouncer.current.cancel();
     setShowScrollToBottom(false);
     setTimelineAnchor(releaseChatTimelineAnchor);
+    // The anchored end space must be gone before the scroll measures, or the
+    // list lands short of the real end (#6519).
     requestAnimationFrame(() => {
       void legendListRef.current?.scrollToEnd?.({ animated });
     });
   }, []);
-  useLayoutEffect(() => {
-    if (timelineScrollModeRef.current !== "anchoring-new-turn") {
-      return;
-    }
-
-    if (
-      shouldReleaseTimelineAnchorForToolActivity({
-        anchorMessageId: timelineAnchorMessageId,
-        liveFollowEnabled: timelineLiveFollowEnabled,
-        runningTurnId: activeRunningTurnId,
-        timelineEntries,
-      })
-    ) {
-      scrollToEnd();
-    }
-  }, [
-    activeRunningTurnId,
-    scrollToEnd,
-    timelineAnchorMessageId,
-    timelineEntries,
-    timelineLiveFollowEnabled,
-  ]);
   useEffect(() => {
     let removeListeners: (() => void) | null = null;
     let frame: number | null = null;
@@ -4100,11 +4330,10 @@ function ChatViewContent(props: ChatViewProps) {
           cancelTimelineLiveFollowForUserNavigationRef.current();
         };
         // The gestures below must only break follow when they can actually
-        // move the viewport away from the live edge. Follow now gates
-        // LegendList's maintainScrollAtEnd, so a spurious break while pinned
-        // at the end produces no scroll event, never re-arms, and streaming
-        // silently stops following. Underflowing content can't scroll at all,
-        // so nothing there should break follow.
+        // move the viewport away from the live edge (#5566): a spurious break
+        // while pinned at the end produces no scroll event, never re-arms,
+        // and streaming silently stops following. Underflowing content can't
+        // scroll at all, so nothing there should break follow.
         const contentScrollsUp = () => timelineRealContentOverflowsViewport();
         // The follow re-arm band, not the strict flag: streaming growth makes
         // isAtEnd flicker false for a frame before the follow scroll catches
@@ -4190,12 +4419,6 @@ function ChatViewContent(props: ChatViewProps) {
   }, [activeThread?.id, composerOverlayHeight, timelineRealContentOverflowsViewport]);
 
   const onTimelineAnchorReady = useCallback((messageId: MessageId, anchorIndex: number) => {
-    // Anchored-end space can be remeasured when the turn completes. Once the
-    // user has scrolled away (or returned to ordinary end-following), that
-    // remeasurement must not restart the send-time anchor positioning.
-    if (timelineScrollModeRef.current !== "anchoring-new-turn") {
-      return;
-    }
     if (pendingTimelineAnchorRef.current === messageId) {
       pendingTimelineAnchorRef.current = null;
     }
@@ -4217,23 +4440,75 @@ function ChatViewContent(props: ChatViewProps) {
           }
           return;
         }
-        void list
-          .scrollToIndex({
-            index: anchorIndex,
-            animated: true,
-            viewPosition: 0,
-            viewOffset: CHAT_LIST_ANCHOR_OFFSET,
-          })
-          .then(() => {
-            if (positionedTimelineAnchorRef.current !== messageId) {
-              return;
-            }
-            settledTimelineAnchorRef.current = messageId;
-          });
+        const scrollNode = list.getScrollableNode();
+        let finished = false;
+        const finishAnimatedPositioning = () => {
+          if (finished) {
+            return;
+          }
+          finished = true;
+          window.clearTimeout(fallbackTimer);
+          scrollNode.removeEventListener("scrollend", finishAnimatedPositioning);
+          if (positionedTimelineAnchorRef.current !== messageId) {
+            return;
+          }
+          const scrollOffset = list.getState().scroll;
+          void list.scrollToOffset({ offset: scrollOffset, animated: false });
+          settledTimelineAnchorRef.current = messageId;
+        };
+        const fallbackTimer = window.setTimeout(finishAnimatedPositioning, 750);
+        scrollNode.addEventListener("scrollend", finishAnimatedPositioning, { once: true });
+        void list.scrollToIndex({
+          index: anchorIndex,
+          animated: true,
+          viewPosition: 0,
+          viewOffset: CHAT_LIST_ANCHOR_OFFSET,
+        });
       });
     };
     requestAnimationFrame(() => positionAnchor(12));
   }, []);
+  const onTimelineAnchorSizeChanged = useCallback((messageId: MessageId) => {
+    if (settledTimelineAnchorRef.current !== messageId) {
+      return;
+    }
+    if (liveFollowUserScrollGenerationRef.current === anchorUserScrollGenerationRef.current) {
+      return;
+    }
+    const scrollOffset = legendListRef.current?.getState().scroll;
+    if (scrollOffset === undefined) {
+      return;
+    }
+    if (pendingAnchorScrollRestoreRef.current === null) {
+      pendingAnchorScrollRestoreRef.current = {
+        messageId,
+        offset: scrollOffset,
+        userScrollGeneration: anchorUserScrollGenerationRef.current,
+      };
+    }
+    if (anchorScrollRestoreFrameRef.current !== null) {
+      return;
+    }
+    anchorScrollRestoreFrameRef.current = requestAnimationFrame(() => {
+      anchorScrollRestoreFrameRef.current = null;
+      const pending = pendingAnchorScrollRestoreRef.current;
+      pendingAnchorScrollRestoreRef.current = null;
+      if (
+        pending &&
+        settledTimelineAnchorRef.current === pending.messageId &&
+        pending.userScrollGeneration === anchorUserScrollGenerationRef.current
+      ) {
+        const list = legendListRef.current;
+        const currentScrollOffset = list?.getState().scroll;
+        if (
+          typeof currentScrollOffset === "number" &&
+          Math.abs(currentScrollOffset - pending.offset) <= 2
+        ) {
+          void list?.scrollToOffset({ offset: pending.offset, animated: false });
+        }
+      }
+    });
+  }, []);
 
   const onIsAtEndChange = useCallback((isAtEnd: boolean) => {
     if (
@@ -4253,7 +4528,7 @@ function ChatViewContent(props: ChatViewProps) {
       // Reachable only once manual navigation has already broken follow, so
       // the anchored turn framing is over: the user scrolled back to the live
       // edge and expects the stream to stick to it again, exactly like the
-      // scroll-to-bottom pill.
+      // scroll-to-bottom pill (#6519).
       setTimelineAnchor(releaseChatTimelineAnchor);
       showScrollDebouncer.current.cancel();
       setShowScrollToBottom(false);
@@ -4266,7 +4541,8 @@ function ChatViewContent(props: ChatViewProps) {
 
   // Anchored end space intentionally disables LegendList's normal end-follow so
   // the sent message can stay near the top. T3 only owns streaming adjustments
-  // during that mode; LegendList owns ordinary end-follow everywhere else.
+  // during that mode; LegendList owns ordinary end-follow everywhere else
+  // (#5449, maintainScrollAtEnd gated by liveFollowEnabled in the timeline).
   useEffect(() => {
     if (!activeThread?.id) {
       return;
@@ -4347,17 +4623,18 @@ function ChatViewContent(props: ChatViewProps) {
 
   useEffect(() => {
     if (!activeThread?.id) return;
-    if (activeThread.messages.length === 0) {
+    if (activeMessageCount === 0) {
       return;
     }
-    const serverIds = new Set(activeThread.messages.map((message) => message.id));
-    const removedMessages = optimisticUserMessages.filter((message) => serverIds.has(message.id));
+    const removedMessages = optimisticUserMessages.filter((message) =>
+      serverAcknowledgedUserMessageIds.has(message.id),
+    );
     if (removedMessages.length === 0) {
       return;
     }
     const timer = window.setTimeout(() => {
       setOptimisticUserMessages((existing) =>
-        existing.filter((message) => !serverIds.has(message.id)),
+        existing.filter((message) => !serverAcknowledgedUserMessageIds.has(message.id)),
       );
     }, 0);
     for (const removedMessage of removedMessages) {
@@ -4371,7 +4648,13 @@ function ChatViewContent(props: ChatViewProps) {
     return () => {
       window.clearTimeout(timer);
     };
-  }, [activeThread?.id, activeThread?.messages, handoffAttachmentPreviews, optimisticUserMessages]);
+  }, [
+    activeMessageCount,
+    activeThread?.id,
+    serverAcknowledgedUserMessageIds,
+    handoffAttachmentPreviews,
+    optimisticUserMessages,
+  ]);
 
   useEffect(() => {
     setOptimisticUserMessages((existing) => {
@@ -4397,7 +4680,7 @@ function ChatViewContent(props: ChatViewProps) {
   const canOverrideServerThreadEnvMode = Boolean(
     isServerThread &&
     activeThread &&
-    activeThread.messages.length === 0 &&
+    activeMessageCount === 0 &&
     activeThread.worktreePath === null &&
     !envLocked,
   );
@@ -4434,51 +4717,11 @@ function ChatViewContent(props: ChatViewProps) {
   // partition (same shell, same capability gate, same PR auto-settle input)
   // so the banner and the sidebar row never disagree.
   const activeThreadShell = useThreadShell(isServerThread ? activeThreadRef : null);
-  const activeComposerTasksProgress = useMemo(() => {
-    if (!activeLatestTurn || latestTurnSettled || activePlan?.turnId !== activeLatestTurn.turnId) {
-      return null;
-    }
-    const currentStep =
-      activePlan.steps.find((step) => step.status === "inProgress") ??
-      activePlan.steps.find((step) => step.status === "pending");
-    if (!currentStep) return null;
-    return {
-      step: currentStep.step,
-      completedSteps: activePlan.steps.filter((step) => step.status === "completed").length,
-      totalSteps: activePlan.steps.length,
-    };
-  }, [activeLatestTurn, activePlan, latestTurnSettled]);
-  const activeComposerTaskSteps =
-    activeComposerTasksProgress && activePlan && activePlan.turnId === activeLatestTurn?.turnId
-      ? activePlan.steps
-      : null;
-
-  useLayoutEffect(() => {
-    if (!composerOverlayElement) return;
-
-    const updateHeight = () => {
-      const nextHeight = Math.ceil(composerOverlayElement.getBoundingClientRect().height);
-      if (nextHeight <= 0) return;
-      setComposerOverlayHeight((currentHeight) =>
-        currentHeight === nextHeight ? currentHeight : nextHeight,
-      );
-      setScrollToEndClearance((currentClearance) =>
-        currentClearance === nextHeight ? currentClearance : nextHeight,
-      );
-    };
-
-    updateHeight();
-    if (typeof ResizeObserver === "undefined") return;
-
-    const resizeObserver = new ResizeObserver(updateHeight);
-    resizeObserver.observe(composerOverlayElement);
-    return () => {
-      resizeObserver.disconnect();
-    };
-  }, [composerOverlayElement]);
-
   const autoSettleAfterDays = useClientSettings((settings) => settings.sidebarAutoSettleAfterDays);
   const autoSettleOnMerge = useClientSettings((settings) => settings.sidebarAutoSettleOnMerge);
+  const changeRequestSnapshotByKey = useAtomValue(threadChangeRequestSnapshotsAtom);
+  // The thread's own change request, placed against the project it belongs to.
+  const linkedThreadPullRequest = activeThread?.linkedPullRequest ?? null;
   const linkedPullRequestStatus = useLinkedThreadPullRequest(
     activeThreadRef?.environmentId ?? null,
     linkedThreadPullRequest,
@@ -4499,7 +4742,6 @@ function ChatViewContent(props: ChatViewProps) {
   }, [activeThreadPr, openThreadPullRequest]);
   const pullRequestSurfaceAvailable =
     supportsPullRequests && activeThreadPr !== null && threadRepository !== null;
-  // Primitive slice of the displayed PR for the settle-rule memos below:
   // resolveDisplayedThreadPr returns a fresh object every render, so memoize
   // on the fields the rules read instead of the object identity.
   const activeThreadPrState = activeThreadPr?.state ?? null;
@@ -4516,18 +4758,13 @@ function ChatViewContent(props: ChatViewProps) {
   const supportsPinning = serverConfig?.environment.capabilities.threadPinning === true;
   const activeThreadPinned = supportsPinning && activeThreadShell?.pinnedAt != null;
   const nowMinute = useNowMinute();
-  const snoozeNow = new Date().toISOString();
   const activeThreadSnoozed =
     activeThreadShell !== null &&
     supportsSnooze &&
-    effectiveSnoozed(activeThreadShell, { now: snoozeNow });
+    effectiveSnoozed(activeThreadShell, { now: new Date().toISOString() });
   const [snoozeWakeTick, bumpSnoozeWakeTick] = useState(0);
-  void snoozeWakeTick;
-  const activeThreadWokeAt =
-    activeThreadShell !== null && supportsSnooze
-      ? threadWokeAt(activeThreadShell, { now: snoozeNow })
-      : null;
   useEffect(() => {
+    void snoozeWakeTick;
     if (!activeThreadSnoozed) return;
     const wakeAtMs = Date.parse(activeThreadShell?.snoozedUntil ?? "");
     if (!Number.isFinite(wakeAtMs)) return;
@@ -4537,6 +4774,10 @@ function ChatViewContent(props: ChatViewProps) {
     );
     return () => window.clearTimeout(id);
   }, [activeThreadShell?.snoozedUntil, activeThreadSnoozed, snoozeWakeTick]);
+  const activeThreadWokeAt =
+    activeThreadShell !== null && supportsSnooze
+      ? threadWokeAt(activeThreadShell, { now: new Date().toISOString() })
+      : null;
   const acknowledgeActiveThreadWoke = useCallback(() => {
     if (activeThreadRef === null || activeThreadWokeAt === null) return;
     markThreadVisited(scopedThreadKey(activeThreadRef), activeThreadWokeAt);
@@ -4564,8 +4805,8 @@ function ChatViewContent(props: ChatViewProps) {
     // lands. An unparseable stored visit counts as never-visited: corrupt
     // local data must not eat the wake signal.
     const storedVisitMs = activeThreadLastVisitedAt ? Date.parse(activeThreadLastVisitedAt) : NaN;
-    const completedAtMs = activeLatestTurn?.completedAt
-      ? Date.parse(activeLatestTurn.completedAt)
+    const completedAtMs = activeLatestRun?.completedAt
+      ? Date.parse(activeLatestRun.completedAt)
       : NaN;
     const lastVisitedMs = Math.max(
       Number.isNaN(storedVisitMs) ? -Infinity : storedVisitMs,
@@ -4573,7 +4814,7 @@ function ChatViewContent(props: ChatViewProps) {
     );
     return lastVisitedMs < wokeAtMs;
   }, [
-    activeLatestTurn?.completedAt,
+    activeLatestRun?.completedAt,
     activeThreadLastVisitedAt,
     activeThreadChangeRequest,
     activeThreadShell,
@@ -4589,7 +4830,7 @@ function ChatViewContent(props: ChatViewProps) {
       changeRequest: activeThreadChangeRequest,
     });
   }, [
-    activeThreadChangeRequest,
+    activeThreadPr?.state,
     activeThreadShell,
     autoSettleAfterDays,
     autoSettleOnMerge,
@@ -4664,6 +4905,18 @@ function ChatViewContent(props: ChatViewProps) {
   // Dismissal lives in a module-level set (survives remounts); this tick just
   // forces a re-render so the banner leaves immediately.
   const [, setBranchMismatchDismissTick] = useState(0);
+  const composerHasDraftContent = useComposerDraftStore((store) => {
+    const draft = store.getComposerDraft(composerDraftTarget);
+    return Boolean(
+      draft &&
+      (draft.prompt.trim().length > 0 ||
+        draft.images.length > 0 ||
+        draft.terminalContexts.length > 0 ||
+        draft.elementContexts.length > 0 ||
+        draft.previewAnnotations.length > 0 ||
+        draft.reviewComments.length > 0),
+    );
+  });
   const activeBranchMismatchKey = branchMismatchKey(
     activeThread?.id ?? null,
     localCheckoutBranchMismatch,
@@ -4671,7 +4924,7 @@ function ChatViewContent(props: ChatViewProps) {
   const showBranchMismatchBanner = shouldShowBranchMismatchBanner({
     hasMismatch: localCheckoutBranchMismatch !== null,
     isDismissed: isBranchMismatchDismissedForSession(activeBranchMismatchKey),
-    composerHasContent: composerHasUnsentContent,
+    composerHasContent: composerHasDraftContent,
     wasShownForCurrentMismatch:
       revealedBranchMismatchKey !== null && revealedBranchMismatchKey === activeBranchMismatchKey,
   });
@@ -4751,103 +5004,9 @@ function ChatViewContent(props: ChatViewProps) {
     switchGitRef,
     updateThreadMetadata,
   ]);
-  // Background work (subagent fleets, workflow runs, watch loops) can outlive
-  // the turn; once it settles, the composer stop button is gone, so this
-  // banner is the only visible stop affordance. Stop routes through the
-  // stop-everything interrupt: it kills every live background task before
-  // interrupting, and works by session, so no active turn is needed.
-  const activeBackgroundLiveness =
-    !isWorking && activeThread ? (activeThreadShell?.backgroundLiveness ?? null) : null;
-  const [isStoppingBackgroundWork, setIsStoppingBackgroundWork] = useState(false);
-  useEffect(() => {
-    // "Stopping..." holds until the liveness clears; the interrupt command
-    // returning only means the request was accepted.
-    if (activeBackgroundLiveness === null) {
-      setIsStoppingBackgroundWork(false);
-    }
-  }, [activeBackgroundLiveness]);
-  useEffect(() => {
-    // Per-thread state: switching threads while A's stop is pending must not
-    // disable B's Stop button (review finding).
-    setIsStoppingBackgroundWork(false);
-  }, [activeThreadId]);
-  const handleStopBackgroundWork = useCallback(async () => {
-    if (!activeThread) return;
-    setIsStoppingBackgroundWork(true);
-    const result = await interruptThreadTurn({
-      environmentId,
-      input: buildThreadTurnInterruptInput(activeThread),
-    });
-    if (result._tag === "Failure") {
-      // Every failure clears the pending state — an interrupted command
-      // never reached the server, so liveness would hold "Stopping..."
-      // forever. Only real failures toast.
-      setIsStoppingBackgroundWork(false);
-      if (!isAtomCommandInterrupted(result)) {
-        const error = squashAtomCommandFailure(result);
-        setThreadError(
-          activeThread.id,
-          error instanceof Error ? error.message : "Failed to stop background work.",
-        );
-      }
-    }
-  }, [activeThread, environmentId, interruptThreadTurn, setThreadError]);
-  const backgroundLivenessBannerItem = useMemo<ComposerBannerStackItem | null>(() => {
-    if (activeBackgroundLiveness === null || !activeThread) {
-      return null;
-    }
-    const working = activeBackgroundLiveness === "working";
-    const liveCount = agentPanelModel.liveCount;
-    return {
-      id: `background-liveness:${activeThread.id}`,
-      variant: "default",
-      priority: "activity",
-      icon: (
-        <span
-          className={cn("size-1.5 rounded-full bg-foreground", working && "animate-status-pulse")}
-          aria-hidden="true"
-        />
-      ),
-      title: working
-        ? liveCount > 0
-          ? `${liveCount} ${liveCount === 1 ? "agent" : "agents"} working`
-          : "Background work"
-        : "Monitoring",
-      actions: (
-        <Button
-          size="xs"
-          variant="ghost"
-          disabled={isStoppingBackgroundWork}
-          onClick={() => void handleStopBackgroundWork()}
-        >
-          {isStoppingBackgroundWork ? "Stopping..." : "Stop"}
-        </Button>
-      ),
-    };
-  }, [
-    activeBackgroundLiveness,
-    activeThread,
-    agentPanelModel.liveCount,
-    handleStopBackgroundWork,
-    isStoppingBackgroundWork,
-  ]);
-  // A woken thread announces itself in the open view, not just the sidebar
-  // pill. Dismissing marks the wake as seen (same acknowledgment as the
-  // pill); sending a message clears it as a side effect of the send path.
-  const wokeThreadBannerItem = useMemo<ComposerBannerStackItem | null>(() => {
-    if (!activeThreadWokeVisible) {
-      return null;
-    }
-    return {
-      id: `thread-woke:${activeThread?.id ?? "unknown"}`,
-      variant: "info",
-      icon: <AlarmClockIcon />,
-      title: "This thread woke from snooze",
-      description: "Dismiss to clear the Woke indicator, or send a message to keep going.",
-      dismissLabel: "Dismiss Woke notification",
-      onDismiss: acknowledgeActiveThreadWoke,
-    };
-  }, [acknowledgeActiveThreadWoke, activeThread?.id, activeThreadWokeVisible]);
+  // The stack renders items[0] front-most and tucks the rest behind hover, so
+  // ordering is priority: system banners, then the branch-mismatch notice,
+  // and the informational parked-thread banner last — it must never cover another.
   const parkedThreadBannerItem = useMemo<ComposerBannerStackItem | null>(() => {
     if (!activeThreadSnoozed && !activeThreadSettled) {
       return null;
@@ -4889,107 +5048,6 @@ function ChatViewContent(props: ChatViewProps) {
     isUnsnoozing,
     isUnsettling,
   ]);
-  // Session-scoped dismissals, one key per (thread, snapshot). A set rather
-  // than a single slot so dismissing the banner on one thread does not
-  // resurface it on another thread dismissed earlier.
-  const [dismissedResumeCompactionKeys, setDismissedResumeCompactionKeys] = useState<
-    ReadonlySet<string>
-  >(new Set());
-  const resumeCompactionKey =
-    activeThread && activeContextWindow
-      ? `${activeThread.id}:${activeContextWindow.updatedAt}`
-      : null;
-  const compactDisabled =
-    !activeThread ||
-    !activeProject ||
-    !isServerThread ||
-    selectedProvider !== "claudeAgent" ||
-    !compactionProviderAvailable ||
-    isWorking ||
-    threadDetailLoading ||
-    isPreparingWorktree ||
-    activeEnvironmentUnavailable ||
-    feedbackUploading ||
-    pendingApprovals.length > 0 ||
-    pendingUserInputs.length > 0 ||
-    showPlanFollowUpPrompt ||
-    composerHasUnsentContent;
-  const compactDisabledReason = compactDisabled
-    ? composerHasUnsentContent
-      ? "Send or clear your draft before compacting"
-      : !activeProject
-        ? "Choose a project before compacting"
-        : !compactionProviderAvailable
-          ? "Enable a Claude provider before compacting"
-          : "Compacting is unavailable right now"
-    : null;
-  const resumeCompactionBannerItem = useMemo<ComposerBannerStackItem | null>(() => {
-    if (
-      !activeThread ||
-      !activeContextWindow ||
-      resumeCompactionKey === null ||
-      dismissedResumeCompactionKeys.has(resumeCompactionKey) ||
-      resumeCompactionPermanentlyDismissed ||
-      nativeResumeCompactionDismissed ||
-      pendingUserInputs.length > 0 ||
-      phase === "running" ||
-      !shouldOfferResumeCompaction({
-        provider: selectedProvider,
-        usedTokens: activeContextWindow.usedTokens,
-        updatedAt: activeContextWindow.updatedAt,
-        now: `${nowMinute}:00.000Z`,
-      })
-    ) {
-      return null;
-    }
-
-    const dismiss = () =>
-      setDismissedResumeCompactionKeys((keys) => new Set(keys).add(resumeCompactionKey));
-    const compactAction = (
-      <Button
-        size="xs"
-        variant="outline"
-        disabled={compactDisabled}
-        onClick={() => {
-          if (compactDisabled) return;
-          composerRef.current?.compactContext();
-        }}
-      >
-        Compact
-      </Button>
-    );
-    return {
-      id: `resume-compaction:${resumeCompactionKey}`,
-      variant: "info",
-      icon: <Minimize2Icon />,
-      title: "Resume with less context",
-      description: `${formatContextWindowTokens(activeContextWindow.usedTokens)} tokens from an older session`,
-      actions: compactDisabledReason ? (
-        <Tooltip>
-          <TooltipTrigger render={<span className="inline-flex">{compactAction}</span>} />
-          <TooltipPopup side="top">{compactDisabledReason}</TooltipPopup>
-        </Tooltip>
-      ) : (
-        compactAction
-      ),
-      dismissLabel: "Keep full history",
-      onDismiss: dismiss,
-    };
-  }, [
-    activeContextWindow,
-    activeThread,
-    compactDisabled,
-    compactDisabledReason,
-    composerRef,
-    dismissedResumeCompactionKeys,
-    nativeResumeCompactionDismissed,
-    nowMinute,
-    pendingUserInputs.length,
-    phase,
-    resumeCompactionKey,
-    resumeCompactionPermanentlyDismissed,
-    selectedProvider,
-  ]);
   const handleRestoreThreadBranch = useCallback(() => {
     if (gitStatusQuery.data?.hasWorkingTreeChanges) {
       setBranchRestoreConfirmOpen(true);
@@ -4998,26 +5056,12 @@ function ChatViewContent(props: ChatViewProps) {
     void handleSwitchCheckoutToThread();
   }, [gitStatusQuery.data?.hasWorkingTreeChanges, handleSwitchCheckoutToThread]);
   const composerBannerItems = useMemo<ComposerBannerStackItem[]>(() => {
-    const backgroundLivenessItems =
-      backgroundLivenessBannerItem === null ? [] : [backgroundLivenessBannerItem];
-    const resumeCompactionItems =
-      resumeCompactionBannerItem === null ? [] : [resumeCompactionBannerItem];
-    const wokeThreadItems = wokeThreadBannerItem === null ? [] : [wokeThreadBannerItem];
     const parkedThreadItems = parkedThreadBannerItem === null ? [] : [parkedThreadBannerItem];
     if (!localCheckoutBranchMismatch || !showBranchMismatchBanner || !activeBranchMismatchKey) {
-      return [
-        ...systemComposerBannerItems,
-        ...backgroundLivenessItems,
-        ...resumeCompactionItems,
-        ...wokeThreadItems,
-        ...parkedThreadItems,
-      ];
+      return [...systemComposerBannerItems, ...parkedThreadItems];
     }
     return [
       ...systemComposerBannerItems,
-      ...backgroundLivenessItems,
-      ...resumeCompactionItems,
-      ...wokeThreadItems,
       {
         id: `branch-mismatch:${activeBranchMismatchKey}`,
         variant: "info",
@@ -5061,16 +5105,14 @@ function ChatViewContent(props: ChatViewProps) {
     ];
   }, [
     activeBranchMismatchKey,
-    backgroundLivenessBannerItem,
     handleRestoreThreadBranch,
     isRestoringThreadBranch,
     localCheckoutBranchMismatch,
     parkedThreadBannerItem,
-    resumeCompactionBannerItem,
     showBranchMismatchBanner,
     systemComposerBannerItems,
-    wokeThreadBannerItem,
   ]);
+
   useEffect(() => {
     setPendingServerThreadEnvMode(null);
     setPendingServerThreadBranch(undefined);
@@ -5155,13 +5197,6 @@ function ChatViewContent(props: ChatViewProps) {
         event.stopPropagation();
         return;
       }
-      // While a close confirmation is open, terminal focus has moved to the
-      // dialog, so a deliberate second close shortcut would otherwise fall
-      // through to the native window/tab close accelerator.
-      if (isTerminalCloseConfirmPending() && preventTerminalCloseShortcut(event, keybindings)) {
-        event.stopPropagation();
-        return;
-      }
       if (!activeThreadId || isCommandPaletteOpen()) {
         return;
       }
@@ -5250,10 +5285,10 @@ function ChatViewContent(props: ChatViewProps) {
         return;
       }
 
-      if (command === "rightPanel.toggleMaximized") {
+      if (command === "threadPanel.toggle") {
         event.preventDefault();
         event.stopPropagation();
-        toggleRightPanelMaximized();
+        toggleThreadPanel();
         return;
       }
 
@@ -5289,11 +5324,11 @@ function ChatViewContent(props: ChatViewProps) {
         event.preventDefault();
         event.stopPropagation();
         if (terminalFocusOwner === "right-panel" && activeRightPanelSurface?.kind === "terminal") {
-          requestClosePanelTerminal(activeRightPanelSurface.activeTerminalId);
+          closePanelTerminal(activeRightPanelSurface.activeTerminalId);
           return;
         }
         if (!terminalUiState.terminalOpen) return;
-        requestCloseTerminal(terminalUiState.activeTerminalId);
+        closeTerminal(terminalUiState.activeTerminalId);
         return;
       }
 
@@ -5345,16 +5380,14 @@ function ChatViewContent(props: ChatViewProps) {
     terminalUiState.terminalOpen,
     terminalUiState.activeTerminalId,
     activeThreadId,
-    requestCloseTerminal,
-    requestClosePanelTerminal,
+    closeTerminal,
+    closePanelTerminal,
     createNewTerminal,
     setTerminalOpen,
     runProjectScript,
     splitTerminal,
     splitPanelTerminal,
     keybindings,
-    handleUnsettleActiveThread,
-    isServerThread,
     onToggleDiff,
     pinThread,
     settleThread,
@@ -5362,7 +5395,7 @@ function ChatViewContent(props: ChatViewProps) {
     supportsSettlement,
     confirmAndUnpinThread,
     toggleRightPanel,
-    toggleRightPanelMaximized,
+    toggleThreadPanel,
     toggleTerminalVisibility,
     composerRef,
   ]);
@@ -5389,7 +5422,6 @@ function ChatViewContent(props: ChatViewProps) {
           "This will discard newer messages and turn diffs in this thread.",
           "This action cannot be undone.",
         ].join("\n"),
-        { variant: "destructive" },
       );
       if (!confirmed) {
         return;
@@ -5427,9 +5459,122 @@ function ChatViewContent(props: ChatViewProps) {
     ],
   );
 
+  const onRollbackCheckpoint = useCallback(
+    async (input: { readonly checkpointId: string; readonly scopeId: string }) => {
+      if (!activeThread || isRevertingCheckpoint) return;
+      if (activeEnvironmentUnavailable && activeEnvironmentUnavailableLabel) {
+        setThreadError(
+          activeThread.id,
+          `Reconnect ${activeEnvironmentUnavailableLabel} before reverting checkpoints.`,
+        );
+        return;
+      }
+      if (phase === "running" || isSendBusy || isConnecting) {
+        setThreadError(activeThread.id, "Interrupt the current turn before reverting checkpoints.");
+        return;
+      }
+      const localApi = readLocalApi();
+      const confirmed =
+        localApi == null
+          ? window.confirm("Roll back this thread to the selected checkpoint?")
+          : await localApi.dialogs.confirm(
+              "Roll back this thread to the selected checkpoint?\nThis action cannot be undone.",
+            );
+      if (!confirmed) return;
+
+      setIsRevertingCheckpoint(true);
+      setThreadError(activeThread.id, null);
+      const result = await revertThreadCheckpoint({
+        environmentId,
+        input: {
+          threadId: activeThread.id,
+          checkpointId: input.checkpointId,
+          scopeId: input.scopeId,
+        },
+      });
+      if (result._tag === "Failure" && !isAtomCommandInterrupted(result)) {
+        const error = squashAtomCommandFailure(result);
+        setThreadError(
+          activeThread.id,
+          error instanceof Error ? error.message : "Failed to revert thread state.",
+        );
+      }
+      setIsRevertingCheckpoint(false);
+    },
+    [
+      activeEnvironmentUnavailable,
+      activeEnvironmentUnavailableLabel,
+      activeThread,
+      environmentId,
+      isConnecting,
+      isRevertingCheckpoint,
+      isSendBusy,
+      phase,
+      revertThreadCheckpoint,
+      setThreadError,
+    ],
+  );
+
+  const onOpenRelatedThread = useCallback(
+    (threadId: ThreadId) => {
+      void navigate({
+        to: "/$environmentId/$threadId",
+        params: buildThreadRouteParams(scopeThreadRef(environmentId, threadId)),
+      });
+    },
+    [environmentId, navigate],
+  );
+
+  const onForkFromRun = useCallback(
+    async (input: { readonly sourceThreadId: ThreadId; readonly runId: RunId }) => {
+      if (!activeThread || activeEnvironmentUnavailable) return;
+      const targetThreadId = newThreadId();
+      const targetThreadRef = scopeThreadRef(environmentId, targetThreadId);
+      const result = await forkThreadFromRun({
+        environmentId,
+        input: {
+          sourceThreadId: input.sourceThreadId,
+          targetThreadId,
+          runId: input.runId,
+          title: `${activeThread.title} fork`,
+        },
+      });
+      if (result._tag === "Failure") {
+        if (!isAtomCommandInterrupted(result)) {
+          const error = squashAtomCommandFailure(result);
+          setThreadError(
+            activeThread.id,
+            error instanceof Error ? error.message : "Failed to fork this response.",
+          );
+        }
+        return;
+      }
+      const targetThreadReady = await waitForThreadShell(targetThreadRef);
+      if (!targetThreadReady) {
+        setThreadError(
+          activeThread.id,
+          "The fork was created, but its thread data did not reach this client. Reconnect and try opening it from the sidebar.",
+        );
+        return;
+      }
+      await navigate({
+        to: "/$environmentId/$threadId",
+        params: buildThreadRouteParams(targetThreadRef),
+      });
+    },
+    [
+      activeEnvironmentUnavailable,
+      activeThread,
+      environmentId,
+      forkThreadFromRun,
+      navigate,
+      setThreadError,
+    ],
+  );
+
   const onSend = async (
     e?: { preventDefault: () => void },
-    submissionIntent: ComposerSubmissionIntent = "foreground",
+    dispatchMode: ComposerDispatchMode = "auto",
     directAnnotation?: {
       annotation: PreviewAnnotationPayload;
       image: ComposerImageAttachment | null;
@@ -5450,23 +5595,13 @@ function ChatViewContent(props: ChatViewProps) {
       !activeThread ||
       isSendBusy ||
       isConnecting ||
-      threadDetailLoading ||
+      activeEnvironmentUnavailable ||
       sendInFlightRef.current ||
       feedbackUploadsInFlightRef.current.has(routeThreadKey)
     ) {
       notifyDirectAnnotationAttached();
       return;
     }
-    if (activeEnvironmentUnavailable) {
-      toastManager.add(
-        stackedThreadToast({
-          type: "warning",
-          title: "Not connected: message not sent",
-          description: "Reconnecting to the environment. Try again once it is connected.",
-        }),
-      );
-      return;
-    }
     if (activePendingProgress) {
       if (directAnnotation) {
         notifyDirectAnnotationAttached();
@@ -5526,6 +5661,57 @@ function ChatViewContent(props: ChatViewProps) {
           ]
         : sendContextPreviewAnnotations;
     const promptForSend = promptRef.current;
+    if (editingQueuedRun !== null) {
+      // Edit mode repurposes the composer: sending saves the queued message
+      // in place instead of dispatching a new turn.
+      if (queuedEditSaveInFlightRef.current) return;
+      const editText = promptForSend.trim();
+      const newEditImages = [...composerImages];
+      if (
+        editText.length === 0 &&
+        editingQueuedRun.existingAttachments.length === 0 &&
+        newEditImages.length === 0
+      ) {
+        return;
+      }
+      queuedEditSaveInFlightRef.current = true;
+      try {
+        const uploads = await Promise.all(
+          newEditImages.map(async (image) => ({
+            type: "image" as const,
+            name: image.name,
+            mimeType: image.mimeType,
+            sizeBytes: image.sizeBytes,
+            dataUrl: await readFileAsDataUrl(image.file),
+          })),
+        );
+        const result = await editQueuedRunCommand({
+          environmentId: activeThread.environmentId,
+          input: {
+            threadId: editingQueuedRun.threadId,
+            runId: editingQueuedRun.runId,
+            text: editText.length === 0 ? ATTACHMENT_ONLY_BOOTSTRAP_PROMPT : editText,
+            edit: {
+              messageId: editingQueuedRun.messageId,
+              attachments: [...editingQueuedRun.existingAttachments, ...uploads],
+            },
+          },
+        });
+        if (result._tag === "Failure") {
+          setThreadError(editingQueuedRun.threadId, "Could not save the edited queued message.");
+          return;
+        }
+        setThreadError(editingQueuedRun.threadId, null);
+        promptRef.current = "";
+        clearComposerDraftContent(queuedEditDraftTargetFor(editingQueuedRun.runId));
+        composerRef.current?.resetCursorState();
+        setEditingQueuedRun(null);
+        scheduleComposerFocus();
+      } finally {
+        queuedEditSaveInFlightRef.current = false;
+      }
+      return;
+    }
     const {
       trimmedPrompt: trimmed,
       sendableTerminalContexts: sendableComposerTerminalContexts,
@@ -5551,7 +5737,7 @@ function ChatViewContent(props: ChatViewProps) {
         ? parseCodexFeedbackCommand(trimmed)
         : null;
     if (feedbackCommand) {
-      if (!isServerThread || activeThread.session === null) {
+      if (!isServerThread || activeThread.activeProviderThreadId === null) {
         toastManager.add(
           stackedThreadToast({
             type: "warning",
@@ -5588,11 +5774,8 @@ function ChatViewContent(props: ChatViewProps) {
         },
         upload: () =>
           uploadThreadFeedback({
-            environmentId,
-            input: {
-              threadId: activeThread.id,
-              ...feedbackCommand,
-            },
+            environmentId: activeThread.environmentId,
+            input: { threadId: activeThread.id, ...feedbackCommand },
           }),
       }).finally(() => {
         feedbackUploadsInFlightRef.current.delete(routeThreadKey);
@@ -5636,27 +5819,11 @@ function ChatViewContent(props: ChatViewProps) {
       );
       return;
     }
-    if (
-      !directAnnotation &&
-      showPlanFollowUpPrompt &&
-      activeProposedPlan &&
-      composerImages.length === 0 &&
-      composerFiles.length === 0
-    ) {
+    if (!directAnnotation && showPlanFollowUpPrompt && activeProposedPlan) {
       const followUp = resolvePlanFollowUpSubmission({
         draftText: trimmed,
         planMarkdown: activeProposedPlan.planMarkdown,
       });
-      const outgoingFollowUpText = formatOutgoingPrompt({
-        provider: ctxSelectedProvider,
-        model: ctxSelectedModel,
-        models: ctxSelectedProviderModels,
-        effort: ctxSelectedPromptEffort,
-        text: followUp.text.trim(),
-      });
-      if (composerRef.current?.validateProviderInput(outgoingFollowUpText) === false) {
-        return;
-      }
       promptRef.current = "";
       clearComposerDraftContent(composerDraftTarget);
       composerRef.current?.resetCursorState();
@@ -5666,10 +5833,7 @@ function ChatViewContent(props: ChatViewProps) {
       });
       return;
     }
-    // Legacy plan mode: /plan and /default only act when the beta flag is on;
-    // otherwise they send as plain text like any other message.
     const standaloneSlashCommand =
-      settings.planModeEnabled &&
       composerImages.length === 0 &&
       composerFiles.length === 0 &&
       sendableComposerTerminalContexts.length === 0 &&
@@ -5712,7 +5876,7 @@ function ChatViewContent(props: ChatViewProps) {
       return;
     }
     const threadIdForSend = activeThread.id;
-    const isFirstMessage = !isServerThread || activeThread.messages.length === 0;
+    const isFirstMessage = !isServerThread || activeMessageCount === 0;
     const baseBranchForWorktree =
       isFirstMessage && sendEnvMode === "worktree" && !activeThread.worktreePath
         ? activeThreadBranch
@@ -5727,6 +5891,24 @@ function ChatViewContent(props: ChatViewProps) {
       return;
     }
 
+    sendInFlightRef.current = true;
+    if (isDraftHeroState && activeThreadKey) {
+      let resolveDockStarted: (() => void) | undefined;
+      const dockStarted = new Promise<void>((resolve) => {
+        resolveDockStarted = resolve;
+      });
+      const dockTransition = runMobileComposerTransition(() => {
+        flushSync(() => {
+          captureDraftHeroComposerRect();
+          setDockedDraftHeroThreadKey(activeThreadKey);
+        });
+        resolveDockStarted?.();
+      });
+      void dockTransition.catch(() => resolveDockStarted?.());
+      await dockStarted;
+    }
+    beginLocalDispatch({ preparingWorktree: Boolean(baseBranchForWorktree) });
+
     const composerImagesSnapshot = [...composerImages];
     const composerFilesSnapshot = [...composerFiles];
     const composerAttachmentsSnapshot = [...composerImagesSnapshot, ...composerFilesSnapshot];
@@ -5746,6 +5928,9 @@ function ChatViewContent(props: ChatViewProps) {
       messageTextWithPreviewAnnotations,
       composerReviewCommentsSnapshot,
     );
+    const messageIdForSend = newMessageId();
+    const messageCreatedAt = new Date().toISOString();
+    const shouldQueueBehindActiveRun = phase === "running" && dispatchMode === "queue";
     const outgoingMessageText = formatOutgoingPrompt({
       provider: ctxSelectedProvider,
       model: ctxSelectedModel,
@@ -5805,48 +5990,6 @@ function ChatViewContent(props: ChatViewProps) {
         return;
       }
     }
-
-    const resolvedSubmissionIntent =
-      submissionIntent === "background" && isLocalDraftThread ? "background" : "foreground";
-    if (
-      shouldDockDraftHeroForSubmission({
-        isDraftHeroState,
-        activeThreadKey,
-        submissionIntent: resolvedSubmissionIntent,
-      }) &&
-      activeThreadKey
-    ) {
-      let resolveDockStarted: (() => void) | undefined;
-      const dockStarted = new Promise<void>((resolve) => {
-        resolveDockStarted = resolve;
-      });
-      const dockTransition = runMobileComposerTransition(() => {
-        flushSync(() => {
-          captureDraftHeroComposerRect();
-          setDockedDraftHeroThreadKey(activeThreadKey);
-        });
-        resolveDockStarted?.();
-      });
-      void dockTransition.catch(() => resolveDockStarted?.());
-      await dockStarted;
-    }
-
-    const attachmentCapabilitiesBeforeDispatch = readLiveAttachmentCapabilities();
-    if (attachmentCapabilitiesBeforeDispatch.fileBlockReason !== null) {
-      sendInFlightRef.current = false;
-      setThreadError(threadIdForSend, attachmentCapabilitiesBeforeDispatch.fileBlockReason);
-      setDockedDraftHeroThreadKey((currentThreadKey) =>
-        currentThreadKey === activeThreadKey ? null : currentThreadKey,
-      );
-      return;
-    }
-    beginLocalDispatch({
-      preparingWorktree: Boolean(baseBranchForWorktree),
-      submissionIntent: resolvedSubmissionIntent,
-    });
-
-    const messageIdForSend = newMessageId();
-    const messageCreatedAt = new Date().toISOString();
     const turnAttachmentsPromise = Promise.all(
       composerAttachmentsSnapshot.map(async (attachment) => {
         if (turnUsesAttachmentUploads) {
@@ -5887,10 +6030,10 @@ function ChatViewContent(props: ChatViewProps) {
             downloadable: false,
           },
     );
-    const shouldAnchorFirstMessage =
-      activeThread.latestTurn === null &&
-      !timelineMessages.some((message) => message.role === "user");
-    if (shouldAnchorFirstMessage) {
+    if (!shouldQueueBehindActiveRun) {
+      // A sent turn returns to the live edge and anchors its new transcript
+      // row. Queued input stays in the composer queue and must not move the
+      // timeline away from the provider work already in flight.
       isAtEndRef.current = true;
       timelineScrollModeRef.current = "anchoring-new-turn";
       liveFollowUserScrollGenerationRef.current = anchorUserScrollGenerationRef.current;
@@ -5903,8 +6046,6 @@ function ChatViewContent(props: ChatViewProps) {
         threadKey: scopedThreadKey(scopeThreadRef(activeThread.environmentId, threadIdForSend)),
         messageId: messageIdForSend,
       });
-    } else {
-      scrollToEnd();
     }
     setOptimisticUserMessages((existing) => [
       ...existing,
@@ -5913,10 +6054,15 @@ function ChatViewContent(props: ChatViewProps) {
         role: "user",
         text: outgoingMessageText,
         ...(optimisticAttachments.length > 0 ? { attachments: optimisticAttachments } : {}),
-        turnId: null,
+        runId: null,
         createdAt: messageCreatedAt,
         updatedAt: messageCreatedAt,
         streaming: false,
+        ...(shouldQueueBehindActiveRun
+          ? { inputIntent: "queued_turn" as const }
+          : phase === "running" && dispatchMode === "steer"
+            ? { inputIntent: "steer" as const }
+            : {}),
       },
     ]);
     setThreadError(threadIdForSend, null);
@@ -5937,28 +6083,18 @@ function ChatViewContent(props: ChatViewProps) {
     clearComposerDraftContent(composerDraftTarget);
     composerRef.current?.resetCursorState();
 
-    let firstComposerImageName: string | null = null;
-    if (composerImagesSnapshot.length > 0) {
-      const firstComposerImage = composerImagesSnapshot[0];
-      if (firstComposerImage) {
-        firstComposerImageName = firstComposerImage.name;
-      }
-    }
-    let titleSeed = trimmed;
-    if (!titleSeed) {
-      if (firstComposerImageName) {
-        titleSeed = `Image: ${firstComposerImageName}`;
-      } else if (composerFilesSnapshot[0]) {
-        titleSeed = `File: ${composerFilesSnapshot[0].name}`;
-      } else if (composerTerminalContextsSnapshot.length > 0) {
-        titleSeed = formatTerminalContextLabel(composerTerminalContextsSnapshot[0]!);
-      } else if (composerElementContextsSnapshot.length > 0) {
-        titleSeed = formatElementContextLabel(composerElementContextsSnapshot[0]!);
-      } else {
-        titleSeed = "New thread";
-      }
-    }
-    const title = truncate(titleSeed);
+    const title = deriveThreadTitleSeed({
+      text: trimmed,
+      attachments: composerImagesSnapshot,
+      fallbackLabels: [
+        composerTerminalContextsSnapshot[0] === undefined
+          ? null
+          : formatTerminalContextLabel(composerTerminalContextsSnapshot[0]),
+        composerElementContextsSnapshot[0] === undefined
+          ? null
+          : formatElementContextLabel(composerElementContextsSnapshot[0]),
+      ],
+    });
     const threadCreateModelSelection = createModelSelection(
       ctxSelectedModelSelection.instanceId,
       ctxSelectedModel || activeProject.defaultModelSelection?.model || DEFAULT_MODEL,
@@ -5966,19 +6102,6 @@ function ChatViewContent(props: ChatViewProps) {
     );
 
     let failure: AtomCommandResult<unknown, unknown> | null = null;
-    // Auto-title from first message
-    if (isFirstMessage && isServerThread) {
-      const titleResult = await updateThreadMetadata({
-        environmentId,
-        input: {
-          threadId: threadIdForSend,
-          title,
-        },
-      });
-      if (titleResult._tag === "Failure") {
-        failure = titleResult;
-      }
-    }
 
     if (failure === null && isServerThread) {
       const settingsResult = await persistThreadSettingsForNextTurn({
@@ -6032,7 +6155,6 @@ function ChatViewContent(props: ChatViewProps) {
                     prepareWorktree: {
                       projectCwd: activeProject.workspaceRoot,
                       baseBranch: baseBranchForWorktree,
-                      branch: buildTemporaryWorktreeBranchName(randomHex),
                       ...(startFromOrigin ? { startFromOrigin: true } : {}),
                     },
                     runSetupScript: true,
@@ -6041,13 +6163,6 @@ function ChatViewContent(props: ChatViewProps) {
             }
           : undefined;
       beginLocalDispatch({ preparingWorktree: false });
-      const backgroundThreadRef =
-        resolvedSubmissionIntent === "background"
-          ? scopeThreadRef(activeThread.environmentId, threadIdForSend)
-          : null;
-      if (backgroundThreadRef) {
-        beginBackgroundDraftSubmissionByRef(backgroundThreadRef);
-      }
       const startResult = await startThreadTurn({
         environmentId,
         input: {
@@ -6062,14 +6177,12 @@ function ChatViewContent(props: ChatViewProps) {
           titleSeed: title,
           runtimeMode,
           interactionMode,
+          dispatchMode,
           ...(bootstrap ? { bootstrap } : {}),
           createdAt: messageCreatedAt,
         },
       });
       if (startResult._tag === "Failure") {
-        if (backgroundThreadRef) {
-          clearBackgroundDraftSubmissionByRef(backgroundThreadRef);
-        }
         failure = startResult;
       } else {
         turnStartSucceeded = true;
@@ -6077,53 +6190,6 @@ function ChatViewContent(props: ChatViewProps) {
           releaseDraftAttachments(composerAttachmentsSnapshot);
         }
         acknowledgeActiveThreadWoke();
-        if (backgroundThreadRef) {
-          markPromotedDraftThreadByRef(backgroundThreadRef);
-          try {
-            const nextDraft = await handleNewThread(
-              scopeProjectRef(activeProject.environmentId, activeProject.id),
-              resolveBackgroundDraftWorkspaceOptions({
-                envMode: sendEnvMode,
-                branch: activeThreadBranch,
-                startFromOrigin,
-              }),
-            );
-            if (nextDraft) {
-              finalizePromotedDraftThreadByRef(backgroundThreadRef);
-              toastManager.add(
-                stackedThreadToast({
-                  type: "success",
-                  title: "Started in background",
-                  timeout: 5_000,
-                  actionProps: {
-                    children: "Open",
-                    onClick: () => {
-                      void navigate({
-                        to: "/$environmentId/$threadId",
-                        params: buildThreadRouteParams(backgroundThreadRef),
-                      });
-                    },
-                  },
-                }),
-              );
-            } else {
-              clearBackgroundDraftSubmissionByRef(backgroundThreadRef);
-            }
-          } catch (error) {
-            clearBackgroundDraftSubmissionByRef(backgroundThreadRef);
-            resetLocalDispatch();
-            toastManager.add(
-              stackedThreadToast({
-                type: "warning",
-                title: "Task started in the background",
-                description:
-                  error instanceof Error
-                    ? `Could not open a fresh composer: ${error.message}`
-                    : "Could not open a fresh composer.",
-              }),
-            );
-          }
-        }
       }
     }
 
@@ -6168,20 +6234,6 @@ function ChatViewContent(props: ChatViewProps) {
       }
       if (!isAtomCommandInterrupted(failure)) {
         const error = squashAtomCommandFailure(failure);
-        if (isLocalDraftThread && draftId && wasBootstrapThreadDeleted(error)) {
-          const failedDraftSession = getDraftSession(draftId);
-          if (failedDraftSession?.threadId === threadIdForSend) {
-            setLogicalProjectDraftThreadId(
-              failedDraftSession.logicalProjectKey,
-              scopeProjectRef(failedDraftSession.environmentId, failedDraftSession.projectId),
-              draftId,
-              {
-                threadId: newThreadId(),
-                createdAt: new Date().toISOString(),
-              },
-            );
-          }
-        }
         setThreadError(
           threadIdForSend,
           error instanceof Error ? error.message : "Failed to send message.",
@@ -6201,7 +6253,9 @@ function ChatViewContent(props: ChatViewProps) {
     if (!activeThread) return;
     const result = await interruptThreadTurn({
       environmentId,
-      input: buildThreadTurnInterruptInput(activeThread),
+      input: {
+        threadId: activeThread.id,
+      },
     });
     if (result._tag === "Failure" && !isAtomCommandInterrupted(result)) {
       const error = squashAtomCommandFailure(result);
@@ -6213,8 +6267,13 @@ function ChatViewContent(props: ChatViewProps) {
   };
 
   const onRespondToApproval = useCallback(
-    async (requestId: ApprovalRequestId, decision: ProviderApprovalDecision) => {
+    async (requestId: RuntimeRequestId, decision: ProviderApprovalDecision) => {
       if (!activeThreadId) return;
+      if (
+        pendingApprovals.find((approval) => approval.requestId === requestId)
+          ?.responseCapability !== "live"
+      )
+        return;
 
       setRespondingRequestIds((existing) =>
         existing.includes(requestId) ? existing : [...existing, requestId],
@@ -6237,12 +6296,17 @@ function ChatViewContent(props: ChatViewProps) {
       setRespondingRequestIds((existing) => existing.filter((id) => id !== requestId));
       return result;
     },
-    [activeThreadId, environmentId, respondToThreadApproval, setThreadError],
+    [activeThreadId, environmentId, pendingApprovals, respondToThreadApproval, setThreadError],
   );
 
   const onRespondToUserInput = useCallback(
-    async (requestId: ApprovalRequestId, answers: Record<string, unknown>) => {
+    async (requestId: RuntimeRequestId, answers: Record<string, unknown>) => {
       if (!activeThreadId) return;
+      if (
+        pendingUserInputs.find((input) => input.requestId === requestId)?.responseCapability !==
+        "live"
+      )
+        return;
 
       setRespondingUserInputRequestIds((existing) =>
         existing.includes(requestId) ? existing : [...existing, requestId],
@@ -6265,7 +6329,7 @@ function ChatViewContent(props: ChatViewProps) {
       setRespondingUserInputRequestIds((existing) => existing.filter((id) => id !== requestId));
       return result;
     },
-    [activeThreadId, environmentId, respondToThreadUserInput, setThreadError],
+    [activeThreadId, environmentId, pendingUserInputs, respondToThreadUserInput, setThreadError],
   );
 
   const setActivePendingUserInputQuestionIndex = useCallback(
@@ -6349,7 +6413,11 @@ function ChatViewContent(props: ChatViewProps) {
   );
 
   const onAdvanceActivePendingUserInput = useCallback(() => {
-    if (!activePendingUserInput || !activePendingProgress) {
+    if (
+      !activePendingUserInput ||
+      activePendingUserInput.responseCapability !== "live" ||
+      !activePendingProgress
+    ) {
       return;
     }
     if (activePendingProgress.isLastQuestion) {
@@ -6374,159 +6442,142 @@ function ChatViewContent(props: ChatViewProps) {
     setActivePendingUserInputQuestionIndex(Math.max(activePendingProgress.questionIndex - 1, 0));
   }, [activePendingProgress, setActivePendingUserInputQuestionIndex]);
 
-  const onSubmitPlanFollowUp = useCallback(
-    async ({
-      text,
-      interactionMode: nextInteractionMode,
-    }: {
-      text: string;
-      interactionMode: "default" | "plan";
-    }) => {
-      if (
-        !activeThread ||
-        !isServerThread ||
-        isSendBusy ||
-        isConnecting ||
-        sendInFlightRef.current
-      ) {
-        return;
-      }
+  async function onSubmitPlanFollowUp({
+    text,
+    interactionMode: nextInteractionMode,
+  }: {
+    text: string;
+    interactionMode: "default" | "plan";
+  }) {
+    if (!activeThread || !isServerThread || isSendBusy || isConnecting || sendInFlightRef.current) {
+      return;
+    }
 
-      const trimmed = text.trim();
-      if (!trimmed) {
-        return;
-      }
+    const trimmed = text.trim();
+    if (!trimmed) {
+      return;
+    }
 
-      const sendCtx = composerRef.current?.getSendContext();
-      if (!sendCtx?.providerAvailable) {
-        return;
-      }
-      const {
-        selectedProvider: ctxSelectedProvider,
-        selectedModel: ctxSelectedModel,
-        selectedProviderModels: ctxSelectedProviderModels,
-        selectedPromptEffort: ctxSelectedPromptEffort,
-        selectedModelSelection: ctxSelectedModelSelection,
-      } = sendCtx;
-
-      const threadIdForSend = activeThread.id;
-      const messageIdForSend = newMessageId();
-      const messageCreatedAt = new Date().toISOString();
-      const outgoingMessageText = formatOutgoingPrompt({
-        provider: ctxSelectedProvider,
-        model: ctxSelectedModel,
-        models: ctxSelectedProviderModels,
-        effort: ctxSelectedPromptEffort,
-        text: trimmed,
-      });
+    const sendCtx = composerRef.current?.getSendContext();
+    if (!sendCtx?.providerAvailable) {
+      return;
+    }
+    const {
+      selectedProvider: ctxSelectedProvider,
+      selectedModel: ctxSelectedModel,
+      selectedProviderModels: ctxSelectedProviderModels,
+      selectedPromptEffort: ctxSelectedPromptEffort,
+      selectedModelSelection: ctxSelectedModelSelection,
+    } = sendCtx;
 
-      sendInFlightRef.current = true;
-      beginLocalDispatch({ preparingWorktree: false });
-      setThreadError(threadIdForSend, null);
+    const threadIdForSend = activeThread.id;
+    const messageIdForSend = newMessageId();
+    const messageCreatedAt = new Date().toISOString();
+    const outgoingMessageText = formatOutgoingPrompt({
+      provider: ctxSelectedProvider,
+      model: ctxSelectedModel,
+      models: ctxSelectedProviderModels,
+      effort: ctxSelectedPromptEffort,
+      text: trimmed,
+    });
 
-      scrollToEnd();
+    sendInFlightRef.current = true;
+    beginLocalDispatch({ preparingWorktree: false });
+    setThreadError(threadIdForSend, null);
 
-      setOptimisticUserMessages((existing) => [
-        ...existing,
-        {
-          id: messageIdForSend,
-          role: "user",
-          text: outgoingMessageText,
-          turnId: null,
-          createdAt: messageCreatedAt,
-          updatedAt: messageCreatedAt,
-          streaming: false,
-        },
-      ]);
+    // Position this sent row once LegendList has measured the anchored tail.
+    isAtEndRef.current = true;
+    timelineScrollModeRef.current = "anchoring-new-turn";
+    liveFollowUserScrollGenerationRef.current = anchorUserScrollGenerationRef.current;
+    setTimelineLiveFollowEnabled(true);
+    pendingTimelineAnchorRef.current = messageIdForSend;
+    activeTimelineAnchorIndexRef.current = null;
+    showScrollDebouncer.current.cancel();
+    setShowScrollToBottom(false);
+    setTimelineAnchor({
+      threadKey: scopedThreadKey(scopeThreadRef(activeThread.environmentId, threadIdForSend)),
+      messageId: messageIdForSend,
+    });
 
-      const settingsResult = await persistThreadSettingsForNextTurn({
-        threadId: threadIdForSend,
+    setOptimisticUserMessages((existing) => [
+      ...existing,
+      {
+        id: messageIdForSend,
+        role: "user",
+        text: outgoingMessageText,
+        runId: null,
         createdAt: messageCreatedAt,
-        modelSelection: ctxSelectedModelSelection,
-        ...(localCheckoutBranchMismatch
-          ? { branch: localCheckoutBranchMismatch.currentBranch }
-          : {}),
-        runtimeMode,
-        interactionMode: nextInteractionMode,
-      });
-      let failure: AtomCommandResult<unknown, unknown> | null =
-        settingsResult._tag === "Failure" ? settingsResult : null;
-
-      if (failure === null) {
-        // Keep the mode toggle and plan-follow-up banner in sync immediately
-        // while the same-thread implementation turn is starting.
-        setComposerDraftInteractionMode(
-          scopeThreadRef(activeThread.environmentId, threadIdForSend),
-          nextInteractionMode,
-        );
-
-        const startResult = await startThreadTurn({
-          environmentId,
-          input: {
-            threadId: threadIdForSend,
-            message: {
-              messageId: messageIdForSend,
-              role: "user",
-              text: outgoingMessageText,
-              attachments: [],
-            },
-            modelSelection: ctxSelectedModelSelection,
-            titleSeed: activeThread.title,
-            runtimeMode,
-            interactionMode: nextInteractionMode,
-            ...(nextInteractionMode === "default" && activeProposedPlan
-              ? {
-                  sourceProposedPlan: {
-                    threadId: activeThread.id,
-                    planId: activeProposedPlan.id,
-                  },
-                }
-              : {}),
-            createdAt: messageCreatedAt,
-          },
-        });
-        failure = startResult._tag === "Failure" ? startResult : null;
-      }
+        updatedAt: messageCreatedAt,
+        streaming: false,
+      },
+    ]);
 
-      if (failure === null) {
-        acknowledgeActiveThreadWoke();
-        sendInFlightRef.current = false;
-        return;
-      }
+    const settingsResult = await persistThreadSettingsForNextTurn({
+      threadId: threadIdForSend,
+      createdAt: messageCreatedAt,
+      modelSelection: ctxSelectedModelSelection,
+      ...(localCheckoutBranchMismatch ? { branch: localCheckoutBranchMismatch.currentBranch } : {}),
+      runtimeMode,
+      interactionMode: nextInteractionMode,
+    });
+    let failure: AtomCommandResult<unknown, unknown> | null =
+      settingsResult._tag === "Failure" ? settingsResult : null;
 
-      setOptimisticUserMessages((existing) =>
-        existing.filter((message) => message.id !== messageIdForSend),
+    if (failure === null) {
+      // Keep the mode toggle and plan-follow-up banner in sync immediately
+      // while the same-thread implementation turn is starting.
+      setComposerDraftInteractionMode(
+        scopeThreadRef(activeThread.environmentId, threadIdForSend),
+        nextInteractionMode,
       );
-      if (!isAtomCommandInterrupted(failure)) {
-        const error = squashAtomCommandFailure(failure);
-        setThreadError(
-          threadIdForSend,
-          error instanceof Error ? error.message : "Failed to send plan follow-up.",
-        );
-      }
+
+      const startResult = await startThreadTurn({
+        environmentId,
+        input: {
+          threadId: threadIdForSend,
+          message: {
+            messageId: messageIdForSend,
+            role: "user",
+            text: outgoingMessageText,
+            attachments: [],
+          },
+          modelSelection: ctxSelectedModelSelection,
+          titleSeed: activeThread.title,
+          runtimeMode,
+          interactionMode: nextInteractionMode,
+          ...(nextInteractionMode === "default" && activeProposedPlan
+            ? {
+                sourceProposedPlan: {
+                  threadId: activeThread.id,
+                  planId: activeProposedPlan.id,
+                },
+              }
+            : {}),
+          createdAt: messageCreatedAt,
+        },
+      });
+      failure = startResult._tag === "Failure" ? startResult : null;
+    }
+
+    if (failure === null) {
       sendInFlightRef.current = false;
       resetLocalDispatch();
-    },
-    [
-      activeThread,
-      activeProposedPlan,
-      acknowledgeActiveThreadWoke,
-      beginLocalDispatch,
-      isConnecting,
-      isSendBusy,
-      isServerThread,
-      localCheckoutBranchMismatch,
-      persistThreadSettingsForNextTurn,
-      resetLocalDispatch,
-      runtimeMode,
-      scrollToEnd,
-      setComposerDraftInteractionMode,
-      setThreadError,
-      startThreadTurn,
-      environmentId,
-      composerRef,
-    ],
-  );
+      return;
+    }
+
+    setOptimisticUserMessages((existing) =>
+      existing.filter((message) => message.id !== messageIdForSend),
+    );
+    if (!isAtomCommandInterrupted(failure)) {
+      const error = squashAtomCommandFailure(failure);
+      setThreadError(
+        threadIdForSend,
+        error instanceof Error ? error.message : "Failed to send plan follow-up.",
+      );
+    }
+    sendInFlightRef.current = false;
+    resetLocalDispatch();
+  }
 
   const onImplementPlanInNewThread = useCallback(async () => {
     if (
@@ -6565,9 +6616,6 @@ function ChatViewContent(props: ChatViewProps) {
       effort: ctxSelectedPromptEffort,
       text: implementationPrompt,
     });
-    if (composerRef.current?.validateProviderInput(outgoingImplementationPrompt) === false) {
-      return;
-    }
     const nextThreadTitle = truncate(buildPlanImplementationThreadTitle(planMarkdown));
     const nextThreadModelSelection: ModelSelection = ctxSelectedModelSelection;
 
@@ -6695,14 +6743,15 @@ function ChatViewContent(props: ChatViewProps) {
       }
       const reason = getStartedThreadModelChangeBlockReason({
         providers: providerStatuses,
-        hasStartedSession: activeThread.session !== null,
+        hasStartedSession: activeRuntime !== null,
+        supportsProviderSwitchingViaHandoff,
         currentModelSelection: activeThread.modelSelection,
-        currentProviderInstanceId: activeThread.session?.providerInstanceId ?? null,
+        currentProviderInstanceId: activeRuntime?.providerInstanceId ?? null,
         nextModelSelection: { instanceId, model },
       });
       return reason ? `${reason.description} Start a new thread to use this model.` : null;
     },
-    [activeThread, providerStatuses],
+    [activeRuntime, activeThread, providerStatuses, supportsProviderSwitchingViaHandoff],
   );
 
   const onProviderModelSelect = useCallback(
@@ -6714,6 +6763,7 @@ function ChatViewContent(props: ChatViewProps) {
       const entry = providerStatuses.find((snapshot) => snapshot.instanceId === instanceId);
       const resolvedDriverKind = entry?.driver ?? null;
       if (
+        !supportsProviderSwitchingViaHandoff &&
         lockedProvider !== null &&
         resolvedDriverKind !== null &&
         resolvedDriverKind !== lockedProvider
@@ -6721,9 +6771,13 @@ function ChatViewContent(props: ChatViewProps) {
         scheduleComposerFocus();
         return;
       }
-      if (lockedProvider !== null && activeThread.session?.providerInstanceId) {
+      if (
+        !supportsProviderSwitchingViaHandoff &&
+        lockedProvider !== null &&
+        activeRuntime?.providerInstanceId
+      ) {
         const currentEntry = providerStatuses.find(
-          (snapshot) => snapshot.instanceId === activeThread.session?.providerInstanceId,
+          (snapshot) => snapshot.instanceId === activeRuntime.providerInstanceId,
         );
         if (
           currentEntry?.continuation?.groupKey &&
@@ -6750,9 +6804,10 @@ function ChatViewContent(props: ChatViewProps) {
       };
       const modelChangeBlockReason = getStartedThreadModelChangeBlockReason({
         providers: providerStatuses,
-        hasStartedSession: activeThread.session !== null,
+        hasStartedSession: activeRuntime !== null,
+        supportsProviderSwitchingViaHandoff,
         currentModelSelection: activeThread.modelSelection,
-        currentProviderInstanceId: activeThread.session?.providerInstanceId ?? null,
+        currentProviderInstanceId: activeRuntime?.providerInstanceId ?? null,
         nextModelSelection,
       });
       if (modelChangeBlockReason) {
@@ -6774,7 +6829,9 @@ function ChatViewContent(props: ChatViewProps) {
     },
     [
       activeThread,
+      activeRuntime,
       lockedProvider,
+      supportsProviderSwitchingViaHandoff,
       scheduleComposerFocus,
       setComposerDraftModelSelection,
       setStickyComposerModelSelection,
@@ -6833,9 +6890,9 @@ function ChatViewContent(props: ChatViewProps) {
     setExpandedImage(preview);
   }, []);
   const onOpenTurnDiff = useCallback(
-    (turnId: TurnId, filePath?: string) => {
+    (runId: RunId, filePath?: string) => {
       if (!isServerThread || !activeThreadRef) return;
-      useDiffPanelStore.getState().selectTurn(activeThreadRef, turnId, filePath);
+      useDiffPanelStore.getState().selectTurn(activeThreadRef, runId, filePath);
       useRightPanelStore.getState().open(activeThreadRef, "diff");
       onDiffPanelOpen?.();
     },
@@ -6860,42 +6917,6 @@ function ChatViewContent(props: ChatViewProps) {
     return <NoActiveThreadState />;
   }
 
-  const panelToggleControls = (
-    <PanelLayoutControls
-      terminalAvailable={activeProject !== null}
-      terminalOpen={terminalUiState.terminalOpen}
-      terminalShortcutLabel={shortcutLabelForCommand(keybindings, "terminal.toggle")}
-      rightPanelAvailable={activeProject !== null}
-      rightPanelOpen={rightPanelOpen}
-      rightPanelShortcutLabel={shortcutLabelForCommand(keybindings, "rightPanel.toggle")}
-      // Suppressed while the Agents surface is visible: the roster itself is
-      // on screen, so the toggle badge would be pointing at nothing.
-      liveAgentCount={
-        rightPanelOpen && activeRightPanelSurface?.kind === "agents" ? 0 : agentPanelModel.liveCount
-      }
-      onToggleTerminal={toggleTerminalVisibility}
-      onToggleRightPanel={toggleRightPanel}
-    />
-  );
-  const panelLayoutControls = (
-    <div
-      className={cn(
-        // One inset in both states: the controls move between containers when
-        // the right panel opens, and a different right offset made them jump
-        // sideways on every toggle.
-        "absolute top-[var(--workspace-controls-top)] right-[var(--workspace-controls-right)] z-50 mr-px flex h-[var(--workspace-topbar-height)] items-center gap-1 [-webkit-app-region:no-drag]",
-      )}
-      data-workspace-titlebar-controls
-    >
-      {rightPanelOpen && !shouldUseRightPanelSheet ? (
-        <RightPanelMaximizeControl
-          maximized={rightPanelMaximized}
-          onToggle={toggleRightPanelMaximized}
-        />
-      ) : null}
-      {panelToggleControls}
-    </div>
-  );
   const rightPanelContent = activeThreadRef ? (
     activeRightPanelSurface?.kind === "preview" ? (
       <Suspense fallback={null}>
@@ -6906,7 +6927,7 @@ function ChatViewContent(props: ChatViewProps) {
           configuredUrls={configuredPreviewUrls}
           visible
           onSendAnnotation={(annotation, image) => {
-            void onSend(undefined, "foreground", { annotation, image });
+            void onSend(undefined, "auto", { annotation, image });
           }}
         />
       </Suspense>
@@ -6961,7 +6982,7 @@ function ChatViewContent(props: ChatViewProps) {
         context={
           isThreadOwnPullRequest(
             {
-              projectId: linkedThreadPullRequest?.projectId ?? activeProject?.id ?? null,
+              projectId: activeProject?.id ?? null,
               repository: threadRepository,
               number: activeThreadPr?.number ?? null,
             },
@@ -7007,6 +7028,124 @@ function ChatViewContent(props: ChatViewProps) {
       </Suspense>
     ) : null
   ) : null;
+  const threadDetailsPanelProps: Omit<ThreadDetailsPanelProps, "mode"> = {
+    environmentId: activeThread.environmentId,
+    environmentConnection: activeEnvironment?.connection ?? null,
+    threadId: activeThread.id,
+    ...(draftId ? { draftId } : {}),
+    activeProjectName: activeProject?.title,
+    activeProjectScripts: activeProject?.scripts,
+    preferredScriptId: activeProject
+      ? (lastInvokedScriptByProjectId[activeProject.id] ?? null)
+      : null,
+    keybindings,
+    availableEditors,
+    showOpenInPicker,
+    gitCwd,
+    isGitRepo,
+    envLocked,
+    availableEnvironments: logicalProjectEnvironments,
+    onEnvironmentChange,
+    onEnvModeChange,
+    ...(canOverrideServerThreadEnvMode ? { effectiveEnvModeOverride: envMode } : {}),
+    ...(canOverrideServerThreadEnvMode
+      ? {
+          activeThreadBranchOverride: activeThreadBranch,
+          onActiveThreadBranchOverrideChange: setPendingServerThreadBranch,
+        }
+      : {}),
+    startFromOrigin,
+    onStartFromOriginChange,
+    ...(canCheckoutPullRequestIntoThread
+      ? { onCheckoutPullRequestRequest: openPullRequestDialog }
+      : {}),
+    onComposerFocusRequest: scheduleComposerFocus,
+    ...(isServerThread && isGitRepo ? { onOpenChanges: openChangesFromThreadPanel } : {}),
+    onReconnectEnvironment: reconnectActiveEnvironment,
+    onOpenConnectionSettings: openConnectionSettings,
+    versionMismatch:
+      showVersionMismatchBanner && versionMismatch
+        ? {
+            clientVersion: versionMismatch.clientVersion,
+            serverVersion: versionMismatch.serverVersion,
+            serverLabel: versionMismatchServerLabel,
+          }
+        : null,
+    onDismissVersionMismatch: handleDismissVersionMismatch,
+    onRunProjectScript: runProjectScript,
+    onAddProjectScript: saveProjectScript,
+    onUpdateProjectScript: updateProjectScript,
+    onDeleteProjectScript: deleteProjectScript,
+  };
+  const panelToggleControlProps = {
+    terminalAvailable: activeProject !== null,
+    terminalOpen: terminalUiState.terminalOpen,
+    terminalShortcutLabel: shortcutLabelForCommand(keybindings, "terminal.toggle"),
+    threadPanelOpen,
+    threadPanelPresentation,
+    threadPanelPopoverAnchor: threadPanelPopoverAnchorRef,
+    ...(threadPanelPresentation === "popover"
+      ? {
+          threadPanelPopoverContent: (
+            <ThreadDetailsPanel
+              mode="popover"
+              onClose={closeThreadPanelPopover}
+              {...threadDetailsPanelProps}
+            />
+          ),
+        }
+      : {}),
+    threadPanelShortcutLabel: shortcutLabelForCommand(keybindings, "threadPanel.toggle"),
+    threadPanelHasAttention:
+      activeEnvironmentUnavailableState !== null || showVersionMismatchBanner,
+    rightPanelAvailable: activeProject !== null,
+    rightPanelOpen,
+    rightPanelShortcutLabel: shortcutLabelForCommand(keybindings, "rightPanel.toggle"),
+    // Suppressed while the Agents surface is visible: the roster itself is
+    // on screen, so the toggle badge would be pointing at nothing.
+    liveAgentCount:
+      rightPanelOpen && activeRightPanelSurface?.kind === "agents" ? 0 : agentPanelModel.liveCount,
+    onToggleTerminal: toggleTerminalVisibility,
+    onToggleThreadPanel: toggleThreadPanel,
+    onToggleRightPanel: toggleRightPanel,
+  } satisfies PanelLayoutControlsProps;
+  const panelToggleControls = (
+    <PanelLayoutControls
+      {...panelToggleControlProps}
+      showThreadPanelControl={!inlineRightPanelOwnsTitleBar}
+    />
+  );
+  const threadPanelHeaderControl = (
+    <div
+      className="absolute top-[var(--workspace-controls-top)] right-[var(--workspace-controls-right)] z-50 flex h-[var(--workspace-topbar-height)] items-center [-webkit-app-region:no-drag]"
+      data-workspace-titlebar-controls
+    >
+      <PanelLayoutControls
+        {...panelToggleControlProps}
+        showTerminalControl={false}
+        showRightPanelControl={false}
+      />
+    </div>
+  );
+  const panelLayoutControls = (
+    <div
+      className={cn(
+        // One inset in both states: the controls move between containers when
+        // the right panel opens, and a different right offset made them jump
+        // sideways on every toggle.
+        "absolute top-[var(--workspace-controls-top)] right-[var(--workspace-controls-right)] z-50 mr-px flex h-[var(--workspace-topbar-height)] items-center gap-1 [-webkit-app-region:no-drag]",
+      )}
+      data-workspace-titlebar-controls
+    >
+      {rightPanelOpen && !shouldUsePlanSidebarSheet ? (
+        <RightPanelMaximizeControl
+          maximized={rightPanelMaximized}
+          onToggle={toggleRightPanelMaximized}
+        />
+      ) : null}
+      {panelToggleControls}
+    </div>
+  );
 
   const workspaceFileDropHandlers = makeWorkspaceFileDropHandlers({
     setDragActive: setIsWorkspaceFileDragActive,
@@ -7014,8 +7153,10 @@ function ChatViewContent(props: ChatViewProps) {
   });
 
   return (
-    <div className="relative flex min-h-0 min-w-0 flex-1 overflow-hidden bg-background">
-      {rightPanelOpen && !shouldUseRightPanelSheet ? panelLayoutControls : null}
+    <div
+      ref={workspaceLayoutRef}
+      className="relative flex min-h-0 min-w-0 flex-1 overflow-hidden bg-background"
+    >
       <div
         className={cn(
           "flex min-h-0 min-w-0 flex-col overflow-x-hidden",
@@ -7024,42 +7165,36 @@ function ChatViewContent(props: ChatViewProps) {
         data-chat-column-maximized-away={rightPanelMaximized ? "true" : "false"}
       >
         {/* Top bar */}
-        <WorkspacePageHeader
+        <header
+          ref={threadPanelPopoverAnchorRef}
           data-chat-header
-          electron={isElectron}
-          reserveNativeControls={reserveTitleBarControlInset && !inlineRightPanelOwnsTitleBar}
-          className="relative bg-background"
+          className={cn(
+            "relative bg-background transition-[padding-left] duration-200 ease-linear motion-reduce:transition-none",
+            isElectron
+              ? cn(
+                  "drag-region flex h-[var(--workspace-topbar-height)] min-h-[var(--workspace-topbar-height)] shrink-0 items-center px-3 sm:px-5",
+                  reserveTitleBarControlInset &&
+                    !inlineRightPanelOwnsTitleBar &&
+                    "wco:pr-[var(--workspace-native-controls-inset)]",
+                )
+              : "flex h-[var(--workspace-topbar-height)] min-h-[var(--workspace-topbar-height)] shrink-0 items-center pl-[calc(env(safe-area-inset-left)+0.75rem)] pr-[calc(env(safe-area-inset-right)+0.75rem)] sm:pl-[calc(env(safe-area-inset-left)+1.25rem)] sm:pr-[calc(env(safe-area-inset-right)+1.25rem)]",
+            COLLAPSED_SIDEBAR_TITLEBAR_INSET_CLASS,
+          )}
         >
-          {!rightPanelOpen ? panelLayoutControls : null}
+          {inlineRightPanelOwnsTitleBar
+            ? threadPanelHeaderControl
+            : !rightPanelOpen
+              ? panelLayoutControls
+              : null}
           <ChatHeader
-            {...(!supportsPullRequests || activeProjectRepository === null
-              ? {}
-              : { onOpenPullRequest: openProjectPullRequest })}
             activeThreadEnvironmentId={activeThread.environmentId}
-            activeThreadId={activeThread.id}
-            {...(routeKind === "draft" && draftId ? { draftId } : {})}
             activeThreadTitle={activeThread.title}
-            isServerThread={isServerThread}
-            changeRequest={activeThreadChangeRequest}
             activeProjectName={activeProject?.title}
             activeProjectCwd={activeProject?.workspaceRoot ?? null}
-            activeProjectFaviconPath={activeProject?.faviconPath ?? null}
-            openInCwd={gitCwd}
-            activeProjectScripts={activeProject?.scripts}
-            preferredScriptId={
-              activeProject ? (lastInvokedScriptByProjectId[activeProject.id] ?? null) : null
-            }
-            keybindings={keybindings}
-            availableEditors={availableEditors}
-            rightPanelOpen={rightPanelOpen}
-            gitCwd={gitCwd}
+            rightPanelOpen={inlineRightPanelOwnsTitleBar}
             onNewThreadInProject={handleNewThreadInActiveProject}
-            onRunProjectScript={runProjectScript}
-            onAddProjectScript={saveProjectScript}
-            onUpdateProjectScript={updateProjectScript}
-            onDeleteProjectScript={deleteProjectScript}
           />
-        </WorkspacePageHeader>
+        </header>
 
         <ThreadErrorBanner
           error={visibleThreadError}
@@ -7070,7 +7205,10 @@ function ChatViewContent(props: ChatViewProps) {
           }}
         />
         {/* Main content area with optional plan sidebar */}
-        <div className="flex min-h-0 min-w-0 flex-1">
+        <div
+          className="relative flex min-h-0 min-w-0 flex-1"
+          data-thread-details-inline-reserved={inlineThreadPanelOpen ? "true" : undefined}
+        >
           {/* Chat column */}
           <div
             className="relative flex min-h-0 min-w-0 flex-1 flex-col"
@@ -7105,18 +7243,20 @@ function ChatViewContent(props: ChatViewProps) {
             <div className="relative flex min-h-0 flex-1 flex-col">
               {/* Messages — LegendList handles virtualization and scrolling internally */}
               <MessagesTimeline
-                agentPanelModel={agentPanelModel}
-                onOpenAgents={addAgentsSurface}
                 key={activeThread.id}
                 isWorking={isWorking}
+                activeTurnInProgress={isWorking || !latestRunSettled}
                 listRef={legendListRef}
                 timelineEntries={timelineEntries}
-                latestTurn={activeLatestTurn}
-                runningTurnId={activeRunningTurnId}
+                latestRun={activeActivityRun}
                 turnDiffSummaryByAssistantMessageId={turnDiffSummaryByAssistantMessageId}
                 activeThreadEnvironmentId={activeThread.environmentId}
                 routeThreadKey={routeThreadKey}
                 onOpenTurnDiff={onOpenTurnDiff}
+                onOpenThread={onOpenRelatedThread}
+                parentThreadLink={parentThreadLink}
+                onForkFromRun={onForkFromRun}
+                onRollbackCheckpoint={(input) => void onRollbackCheckpoint(input)}
                 revertTurnCountByUserMessageId={revertTurnCountByUserMessageId}
                 onRevertUserMessage={onRevertUserMessage}
                 isRevertingCheckpoint={isRevertingCheckpoint}
@@ -7127,22 +7267,27 @@ function ChatViewContent(props: ChatViewProps) {
                 timestampFormat={timestampFormat}
                 workspaceRoot={activeWorkspaceRoot}
                 skills={activeProviderStatus?.skills ?? EMPTY_PROVIDER_SKILLS}
+                providerStatuses={providerStatuses}
+                runs={serverProjection?.runs ?? EMPTY_PROJECTION_RUNS}
                 anchorMessageId={timelineAnchorMessageId}
                 onAnchorReady={onTimelineAnchorReady}
+                onAnchorSizeChanged={onTimelineAnchorSizeChanged}
                 contentInsetEndAdjustment={composerOverlayHeight}
                 liveFollowEnabled={timelineLiveFollowEnabled}
                 onIsAtEndChange={onIsAtEndChange}
                 onManualNavigation={cancelTimelineLiveFollowForUserNavigation}
-                hideEmptyPlaceholder={isDraftHeroState || threadDetailLoading}
+                hideEmptyPlaceholder={isDraftHeroState}
                 topFadeEnabled={!hasTimelineTopBanner}
-                loadEarlier={loadEarlierTurns}
+                {...(threadHistoryControls === undefined
+                  ? {}
+                  : { historyControls: threadHistoryControls })}
               />
 
               {/* scroll to end pill — shown when user has scrolled away from the live edge */}
               {showScrollToBottom && (
                 <div
-                  className="pointer-events-none absolute left-1/2 z-30 flex -translate-x-1/2 justify-center py-1.5"
-                  style={{ bottom: scrollToEndClearance + 4 }}
+                  className="chat-scroll-to-bottom pointer-events-none absolute z-30 flex justify-center py-1.5"
+                  style={{ bottom: composerOverlayHeight + 4 }}
                 >
                   <Button
                     aria-label="Scroll to end"
@@ -7158,7 +7303,7 @@ function ChatViewContent(props: ChatViewProps) {
               )}
             </div>
 
-            {/* Input bar — centered hero while a draft has no messages, docked at the bottom otherwise */}
+            {/* Input bar — centered for an empty draft, docked after sending. */}
             <div
               ref={setComposerOverlayElement}
               data-chat-composer-overlay="true"
@@ -7169,19 +7314,17 @@ function ChatViewContent(props: ChatViewProps) {
               }
             >
               <div
-                ref={attachDraftHeroTransitionGroupRef}
-                className="w-full ps-[calc(env(safe-area-inset-left)+0.75rem)] pe-[calc(env(safe-area-inset-right)+0.75rem)] sm:ps-[calc(env(safe-area-inset-left)+1.25rem)] sm:pe-[calc(env(safe-area-inset-right)+1.25rem)]"
+                ref={draftHeroTransition.transitionGroupRef}
+                className="w-full ps-[calc(env(safe-area-inset-left)+0.75rem)] pe-[calc(env(safe-area-inset-right)+0.75rem+var(--thread-details-panel-inset))] sm:ps-[calc(env(safe-area-inset-left)+1.25rem)] sm:pe-[calc(env(safe-area-inset-right)+1.25rem+var(--thread-details-panel-inset))]"
               >
-                <div className="group/composer-stack pointer-events-auto relative z-10">
+                <div className="pointer-events-auto relative z-10">
                   {isDraftHeroState ? (
-                    <div className="absolute inset-x-0 bottom-full z-0">
+                    <div className="absolute inset-x-0 bottom-full">
                       <div
                         className="pb-8 group-has-data-[composer-shoulder-tab]/composer-stack:pb-4"
                         style={
                           forceExpandedMobileComposer
-                            ? {
-                                viewTransitionName: MOBILE_DRAFT_HEADLINE_VIEW_TRANSITION_NAME,
-                              }
+                            ? { viewTransitionName: MOBILE_DRAFT_HEADLINE_VIEW_TRANSITION_NAME }
                             : undefined
                         }
                       >
@@ -7193,7 +7336,8 @@ function ChatViewContent(props: ChatViewProps) {
                     </div>
                   ) : null}
                   <div
-                    className="relative"
+                    ref={draftHeroTransition.composerAnchorRef}
+                    className="relative z-10"
                     style={
                       forceExpandedMobileComposer
                         ? { viewTransitionName: MOBILE_COMPOSER_VIEW_TRANSITION_NAME }
@@ -7202,7 +7346,7 @@ function ChatViewContent(props: ChatViewProps) {
                   >
                     <ComposerSurface.Shell contextStrip={showComposerContextStrip}>
                       <ComposerSurface.Host>
-                        <div ref={attachDraftHeroComposerAnchorRef} className="relative z-10">
+                        <div className="relative z-10">
                           <ChatComposer
                             composerRef={composerRef}
                             composerDraftTarget={composerDraftTarget}
@@ -7223,14 +7367,19 @@ function ChatViewContent(props: ChatViewProps) {
                             phase={phase}
                             isConnecting={isConnecting}
                             isSendBusy={isSendBusy}
-                            sendDisabledReason={
-                              feedbackUploading
-                                ? "Sending feedback"
-                                : threadDetailLoading
-                                  ? "Messages loading"
-                                  : null
-                            }
                             isPreparingWorktree={isPreparingWorktree}
+                            queuedRunsControl={
+                              isServerThread && activeThread ? (
+                                <QueuedRunsControl
+                                  environmentId={activeThread.environmentId}
+                                  threadId={activeThread.id}
+                                  optimisticMessages={optimisticUserMessages}
+                                  editingRunId={editingQueuedRun?.runId ?? null}
+                                  onEditQueuedRun={beginEditingQueuedRun}
+                                  onCancelEdit={cancelEditingQueuedRun}
+                                />
+                              ) : null
+                            }
                             bannerItems={composerBannerItems}
                             environmentUnavailable={activeEnvironmentUnavailableState}
                             activePendingApproval={activePendingApproval}
@@ -7244,22 +7393,24 @@ function ChatViewContent(props: ChatViewProps) {
                             respondingRequestIds={respondingRequestIds}
                             showPlanFollowUpPrompt={showPlanFollowUpPrompt}
                             activeProposedPlan={activeProposedPlan}
-                            activeTasksProgress={activeComposerTasksProgress}
-                            activeTaskSteps={activeComposerTaskSteps}
                             isWorking={isWorking}
                             activeWorkStartedAt={activeWorkStartedAt}
+                            pendingBackgroundTasks={pendingBackgroundTasks}
                             threadSyncPhase={activeEnvironmentUnavailable ? null : threadSyncPhase}
                             runtimeMode={runtimeMode}
                             interactionMode={interactionMode}
-                            lockedProvider={lockedProvider}
+                            lockedProvider={modelPickerLockedProvider}
                             providerStatuses={providerStatuses as ServerProvider[]}
                             activeProjectDefaultModelSelection={
                               activeProject?.defaultModelSelection
                             }
                             activeThreadModelSelection={activeThread?.modelSelection}
                             activeContextWindow={activeContextWindow}
-                            compactDisabled={compactDisabled}
-                            compactDisabledReason={compactDisabledReason}
+                            activeTasksProgress={activeComposerTasksProgress}
+                            activeTaskSteps={activeComposerTaskSteps}
+                            compactDisabled={composerCompactDisabled}
+                            compactDisabledReason={null}
+                            sendDisabledReason={feedbackUploading ? "Sending feedback" : null}
                             resolvedTheme={resolvedTheme}
                             settings={settings}
                             keybindings={keybindings}
@@ -7270,6 +7421,8 @@ function ChatViewContent(props: ChatViewProps) {
                             composerFilesRef={composerFilesRef}
                             composerTerminalContextsRef={composerTerminalContextsRef}
                             composerElementContextsRef={composerElementContextsRef}
+                            shouldAutoScrollRef={isAtEndRef}
+                            scheduleStickToBottom={scrollToEnd}
                             onSend={onSend}
                             onInterrupt={onInterrupt}
                             onImplementPlanInNewThread={onImplementPlanInNewThread}
@@ -7293,44 +7446,64 @@ function ChatViewContent(props: ChatViewProps) {
                             scheduleComposerFocus={scheduleComposerFocus}
                             setThreadError={setThreadError}
                             onExpandImage={onExpandTimelineImage}
+                            editingQueuedAttachments={composerEditingQueuedAttachments}
+                            onRemoveEditingQueuedAttachment={removeEditingQueuedAttachment}
                           />
                         </div>
                       </ComposerSurface.Host>
-                      <div className="min-h-0">
-                        <div
-                          data-terminal-open={terminalUiState.terminalOpen ? "true" : undefined}
-                          className="relative z-0"
-                        >
-                          {showComposerContextStrip && (
-                            <div className="pointer-events-auto">
-                              <BranchToolbar
-                                environmentId={activeThread.environmentId}
-                                threadId={activeThread.id}
-                                showGitControls={isGitRepo}
-                                {...(routeKind === "draft" && draftId ? { draftId } : {})}
-                                onEnvModeChange={onEnvModeChange}
-                                startFromOrigin={startFromOrigin}
-                                onStartFromOriginChange={onStartFromOriginChange}
-                                {...(canOverrideServerThreadEnvMode
-                                  ? { effectiveEnvModeOverride: envMode }
-                                  : {})}
-                                {...(canOverrideServerThreadEnvMode
-                                  ? {
-                                      activeThreadBranchOverride: activeThreadBranch,
-                                      onActiveThreadBranchOverrideChange:
-                                        setPendingServerThreadBranch,
-                                    }
-                                  : {})}
-                                envLocked={envLocked}
-                                onComposerFocusRequest={scheduleComposerFocus}
-                                {...(canCheckoutPullRequestIntoThread
-                                  ? { onCheckoutPullRequestRequest: openPullRequestDialog }
-                                  : {})}
-                                {...(hasMultipleEnvironments ? { onEnvironmentChange } : {})}
-                                availableEnvironments={logicalProjectEnvironments}
-                              />
-                            </div>
-                          )}
+                      <div
+                        aria-hidden={!showComposerContextStrip}
+                        className={cn(
+                          "grid transition-[grid-template-rows,opacity,transform] motion-reduce:transition-none",
+                          showComposerContextStrip
+                            ? "grid-rows-[1fr] translate-y-0 opacity-100"
+                            : "pointer-events-none grid-rows-[0fr] -translate-y-1 opacity-0",
+                        )}
+                        data-composer-context-strip={
+                          showComposerContextStrip ? "expanded" : "collapsed"
+                        }
+                        inert={showComposerContextStrip ? undefined : true}
+                        style={{
+                          transitionDuration: `${DRAFT_HERO_TRANSITION_DURATION_MS}ms`,
+                          transitionTimingFunction: DRAFT_HERO_TRANSITION_EASING,
+                        }}
+                      >
+                        <div className="min-h-0 overflow-hidden">
+                          <div
+                            data-terminal-open={terminalUiState.terminalOpen ? "true" : undefined}
+                            className="relative z-0"
+                          >
+                            {renderComposerContextStrip && (
+                              <div className="pointer-events-auto">
+                                <BranchToolbar
+                                  environmentId={activeThread.environmentId}
+                                  threadId={activeThread.id}
+                                  showGitControls={isGitRepo}
+                                  {...(routeKind === "draft" && draftId ? { draftId } : {})}
+                                  onEnvModeChange={onEnvModeChange}
+                                  startFromOrigin={startFromOrigin}
+                                  onStartFromOriginChange={onStartFromOriginChange}
+                                  {...(canOverrideServerThreadEnvMode
+                                    ? { effectiveEnvModeOverride: envMode }
+                                    : {})}
+                                  {...(canOverrideServerThreadEnvMode
+                                    ? {
+                                        activeThreadBranchOverride: activeThreadBranch,
+                                        onActiveThreadBranchOverrideChange:
+                                          setPendingServerThreadBranch,
+                                      }
+                                    : {})}
+                                  envLocked={envLocked}
+                                  onComposerFocusRequest={scheduleComposerFocus}
+                                  {...(canCheckoutPullRequestIntoThread
+                                    ? { onCheckoutPullRequestRequest: openPullRequestDialog }
+                                    : {})}
+                                  {...(hasMultipleEnvironments ? { onEnvironmentChange } : {})}
+                                  availableEnvironments={logicalProjectEnvironments}
+                                />
+                              </div>
+                            )}
+                          </div>
                         </div>
                       </div>
                     </ComposerSurface.Shell>
@@ -7400,6 +7573,9 @@ function ChatViewContent(props: ChatViewProps) {
             ) : null}
           </div>
           {/* end chat column */}
+          {inlineThreadPanelOpen ? (
+            <ThreadDetailsPanel mode="inline" {...threadDetailsPanelProps} />
+          ) : null}
         </div>
         {/* end horizontal flex container */}
 
@@ -7423,16 +7599,17 @@ function ChatViewContent(props: ChatViewProps) {
         ))}
       </div>
 
-      {!shouldUseRightPanelSheet && rightPanelOpen && activeThreadRef ? (
+      {!shouldUsePlanSidebarSheet && rightPanelOpen && activeThreadRef ? (
         <RightPanelTabs
           mode="inline"
           maximized={rightPanelMaximized}
+          inlineSize={previewPanelInlineSize}
+          layoutControls={panelLayoutControls}
           surfaces={rightPanelState.surfaces}
           activeSurfaceId={activeRightPanelSurface?.id ?? null}
           pendingSurfaceIds={pendingFileSurfaceIds}
           previewSessions={activePreviewState.sessions}
           desktopByTabId={activePreviewState.desktopByTabId}
-          previewRuntimeTabId={resolvePreviewRuntimeTabId}
           terminalLabelsById={activeTerminalLabelsById}
           onActivate={activateRightPanelSurface}
           onCloseSurface={closeRightPanelSurface}
@@ -7458,10 +7635,11 @@ function ChatViewContent(props: ChatViewProps) {
           {rightPanelContent}
         </RightPanelTabs>
       ) : null}
-      {shouldUseRightPanelSheet && rightPanelOpen && activeThreadRef ? (
+      {shouldUsePlanSidebarSheet && rightPanelOpen && activeThreadRef ? (
         <RightPanelSheet open onClose={closePreviewPanel}>
           <RightPanelTabs
             mode="sheet"
+            inlineSize={previewPanelInlineSize}
             // Same effective inset as the closed-state titlebar controls
             // (pr-3 in the tab bar plus this pixel equals the absolute
             // right inset plus mr-px), so the cluster does not creep when
@@ -7472,7 +7650,6 @@ function ChatViewContent(props: ChatViewProps) {
             pendingSurfaceIds={pendingFileSurfaceIds}
             previewSessions={activePreviewState.sessions}
             desktopByTabId={activePreviewState.desktopByTabId}
-            previewRuntimeTabId={resolvePreviewRuntimeTabId}
             terminalLabelsById={activeTerminalLabelsById}
             onActivate={activateRightPanelSurface}
             onCloseSurface={closeRightPanelSurface}
@@ -7499,7 +7676,6 @@ function ChatViewContent(props: ChatViewProps) {
           </RightPanelTabs>
         </RightPanelSheet>
       ) : null}
-
       {expandedImage && (
         <ExpandedImageDialog
           key={`${expandedImage.images[expandedImage.index]?.src ?? "image"}:${expandedImage.index}`}
diff --git a/apps/web/src/components/CommandPalette.logic.test.ts b/apps/web/src/components/CommandPalette.logic.test.ts
index d521c119303d..4f6644ca822e 100644
--- a/apps/web/src/components/CommandPalette.logic.test.ts
+++ b/apps/web/src/components/CommandPalette.logic.test.ts
@@ -1,6 +1,7 @@
 import { describe, expect, it, vi } from "vite-plus/test";
 import { EnvironmentId, ProjectId, ProviderInstanceId, ThreadId } from "@t3tools/contracts";
 import type { Thread } from "../types";
+import { makeThreadFixture } from "../test-fixtures";
 import {
   browseInputEndPaddingClass,
   buildBrowseGroups,
@@ -143,7 +144,7 @@ const LOCAL_ENVIRONMENT_ID = EnvironmentId.make("environment-local");
 const PROJECT_ID = ProjectId.make("project-1");
 
 function makeThread(overrides: Partial<Thread> = {}): Thread {
-  return {
+  return makeThreadFixture({
     id: ThreadId.make("thread-1"),
     environmentId: LOCAL_ENVIRONMENT_ID,
     projectId: PROJECT_ID,
@@ -151,7 +152,7 @@ function makeThread(overrides: Partial<Thread> = {}): Thread {
     modelSelection: { instanceId: ProviderInstanceId.make("codex"), model: "gpt-5" },
     runtimeMode: "full-access",
     interactionMode: "default",
-    session: null,
+    runtime: null,
     messages: [],
     proposedPlans: [],
     createdAt: "2026-03-01T00:00:00.000Z",
@@ -160,13 +161,11 @@ function makeThread(overrides: Partial<Thread> = {}): Thread {
     settledAt: null,
     deletedAt: null,
     updatedAt: "2026-03-01T00:00:00.000Z",
-    latestTurn: null,
+    latestRun: null,
     branch: null,
     worktreePath: null,
-    checkpoints: [],
-    activities: [],
     ...overrides,
-  };
+  });
 }
 
 describe("buildThreadActionItems", () => {
diff --git a/apps/web/src/components/CommandPalette.logic.ts b/apps/web/src/components/CommandPalette.logic.ts
index 688a8a8ea791..e56a1f875a28 100644
--- a/apps/web/src/components/CommandPalette.logic.ts
+++ b/apps/web/src/components/CommandPalette.logic.ts
@@ -174,7 +174,7 @@ export type BuildThreadActionItemsThread = Pick<
   | "id"
   | "modelSelection"
   | "projectId"
-  | "session"
+  | "runtime"
   | "title"
   | "worktreePath"
 > & {
diff --git a/apps/web/src/components/CommandPalette.tsx b/apps/web/src/components/CommandPalette.tsx
index c5ec3f095167..556aa310b84e 100644
--- a/apps/web/src/components/CommandPalette.tsx
+++ b/apps/web/src/components/CommandPalette.tsx
@@ -288,6 +288,16 @@ function remoteProjectSourceIcon(source: AddProjectRemoteSource, className: stri
   }
 }
 
+function projectFaviconIcon(project: Project): ReactNode {
+  return (
+    <ProjectFavicon
+      environmentId={project.environmentId}
+      cwd={project.workspaceRoot}
+      className={ITEM_ICON_CLASS}
+    />
+  );
+}
+
 function remoteProjectInputPlaceholder(flow: AddProjectCloneFlow | null): string | null {
   if (!flow) return null;
   if (flow.step === "confirm") return null;
@@ -1015,7 +1025,7 @@ function OpenCommandPaletteDialog(props: {
             group?.memberProjects.flatMap((member) => [member.title, member.workspaceRoot]) ?? []
           );
         },
-        icon: projectFavicon,
+        icon: projectFaviconIcon,
         runProject: openProjectFromSearch,
       }),
     [openProjectFromSearch, pickerProjects, projectGroupByTargetKey],
@@ -1054,7 +1064,7 @@ function OpenCommandPaletteDialog(props: {
               </span>
             );
           },
-          icon: projectFavicon,
+          icon: projectFaviconIcon,
           runProject: async (project) => {
             const group = projectGroupByTargetKey.get(`${project.environmentId}:${project.id}`);
             const contextualRefBelongsToGroup =
@@ -1093,7 +1103,7 @@ function OpenCommandPaletteDialog(props: {
         renderTrailingContent: (thread) => <ThreadRowTrailingStatus thread={thread} />,
         renderDescription: (thread, { projectTitle }) => {
           const modelInstanceId =
-            thread.session?.providerInstanceId ?? thread.modelSelection.instanceId;
+            thread.runtime?.providerInstanceId ?? thread.modelSelection.instanceId;
           const providerEntry =
             providerEntryByEnvironmentAndInstanceId.get(
               `${thread.environmentId}:${modelInstanceId}`,
@@ -1109,7 +1119,7 @@ function OpenCommandPaletteDialog(props: {
               isCurrent={thread.id === activeThreadId}
               driverKind={providerEntry?.driverKind ?? null}
               providerDisplayName={
-                thread.session?.providerName ?? providerEntry?.displayName ?? modelInstanceId
+                thread.runtime?.providerName ?? providerEntry?.displayName ?? modelInstanceId
               }
             />
           );
diff --git a/apps/web/src/components/DiffPanel.tsx b/apps/web/src/components/DiffPanel.tsx
index 6c4b720e904c..d372e2c25db9 100644
--- a/apps/web/src/components/DiffPanel.tsx
+++ b/apps/web/src/components/DiffPanel.tsx
@@ -6,7 +6,7 @@ import {
   squashAtomCommandFailure,
 } from "@t3tools/client-runtime/state/runtime";
 import { safeErrorLogAttributes } from "@t3tools/client-runtime/errors";
-import type { ScopedThreadRef, TurnId } from "@t3tools/contracts";
+import type { ScopedThreadRef, RunId } from "@t3tools/contracts";
 import {
   ArrowRightIcon,
   CheckIcon,
@@ -39,7 +39,7 @@ import {
 } from "../lib/diffRendering";
 import { areAllDiffFilesCollapsed, toggleAllDiffFiles } from "../lib/diffCollapse";
 import { useTurnDiffSummaries } from "../hooks/useTurnDiffSummaries";
-import { useProject, useThread } from "../state/entities";
+import { useProject, useThreadProjection, useThreadShell } from "../state/entities";
 import { resolveThreadRouteRef } from "../threadRoutes";
 import { useClientSettings } from "../hooks/useSettings";
 import { formatShortTimestamp } from "../timestampFormat";
@@ -115,7 +115,7 @@ export default function DiffPanel({
   const codeViewRef = useRef<AnnotatableCodeViewHandle>(null);
   const lastCompletedTurnRefreshRef = useRef<{
     readonly threadKey: string | null;
-    readonly turnId: TurnId | null;
+    readonly runId: RunId | null;
   } | null>(null);
 
   const routeThreadRef = useParams({
@@ -123,7 +123,8 @@ export default function DiffPanel({
     select: (params) => resolveThreadRouteRef(params),
   });
   const activeThreadId = routeThreadRef?.threadId ?? null;
-  const activeThread = useThread(routeThreadRef);
+  const activeThread = useThreadShell(routeThreadRef);
+  const activeThreadProjection = useThreadProjection(routeThreadRef)?.projection ?? null;
   const activeProjectId = activeThread?.projectId ?? null;
   const activeProject = useProject(
     activeThread && activeProjectId
@@ -161,55 +162,55 @@ export default function DiffPanel({
     ),
   );
   const isGitRepo = gitStatusQuery.data?.isRepo ?? true;
-  const { turnDiffSummaries, inferredCheckpointTurnCountByTurnId } =
-    useTurnDiffSummaries(activeThread);
+  const { turnDiffSummaries, inferredCheckpointTurnCountByRunId } =
+    useTurnDiffSummaries(activeThreadProjection);
   const orderedTurnDiffSummaries = useMemo(
     () =>
       [...turnDiffSummaries].toSorted((left, right) => {
         const leftTurnCount =
-          left.checkpointTurnCount ?? inferredCheckpointTurnCountByTurnId[left.turnId] ?? 0;
+          left.checkpointTurnCount ?? inferredCheckpointTurnCountByRunId[left.runId] ?? 0;
         const rightTurnCount =
-          right.checkpointTurnCount ?? inferredCheckpointTurnCountByTurnId[right.turnId] ?? 0;
+          right.checkpointTurnCount ?? inferredCheckpointTurnCountByRunId[right.runId] ?? 0;
         if (leftTurnCount !== rightTurnCount) {
           return rightTurnCount - leftTurnCount;
         }
         return right.completedAt.localeCompare(left.completedAt);
       }),
-    [inferredCheckpointTurnCountByTurnId, turnDiffSummaries],
+    [inferredCheckpointTurnCountByRunId, turnDiffSummaries],
   );
 
   useEffect(() => {
     if (!routeThreadRef || diffSelection.kind !== "turn") return;
     useDiffPanelStore.getState().reconcileTurnSelection(
       routeThreadRef,
-      orderedTurnDiffSummaries.map((summary) => summary.turnId),
+      orderedTurnDiffSummaries.map((summary) => summary.runId),
     );
   }, [diffSelection, orderedTurnDiffSummaries, routeThreadRef]);
 
-  const selectedTurnId = diffSelection.kind === "turn" ? diffSelection.turnId : null;
+  const selectedRunId = diffSelection.kind === "turn" ? diffSelection.turnId : null;
   const selectedGitScope = diffSelection.kind === "unstaged" ? "unstaged" : "branch";
   const selectedBaseRef = diffSelection.kind === "branch" ? diffSelection.baseRef : null;
   const selectedFilePath = diffSelection.kind === "turn" ? diffSelection.filePath : null;
   const selectedFileRevealRequestId =
     diffSelection.kind === "turn" ? diffSelection.revealRequestId : 0;
   const selectedTurn =
-    selectedTurnId === null
+    selectedRunId === null
       ? undefined
-      : (orderedTurnDiffSummaries.find((summary) => summary.turnId === selectedTurnId) ??
+      : (orderedTurnDiffSummaries.find((summary) => summary.runId === selectedRunId) ??
         orderedTurnDiffSummaries[0]);
   const selectedCheckpointTurnCount =
     selectedTurn &&
-    (selectedTurn.checkpointTurnCount ?? inferredCheckpointTurnCountByTurnId[selectedTurn.turnId]);
+    (selectedTurn.checkpointTurnCount ?? inferredCheckpointTurnCountByRunId[selectedTurn.runId]);
   const latestTurn = orderedTurnDiffSummaries[0];
   const selectedScopeLabel =
-    selectedTurnId === null
+    selectedRunId === null
       ? selectedGitScope === "unstaged"
         ? "Working tree"
         : "Branch changes"
-      : selectedTurn?.turnId === latestTurn?.turnId
+      : selectedTurn?.runId === latestTurn?.runId
         ? "Latest turn"
         : `Turn ${selectedCheckpointTurnCount ?? "?"}`;
-  const reviewSectionId = selectedTurn ? `turn:${selectedTurn.turnId}` : selectedGitScope;
+  const reviewSectionId = selectedTurn ? `turn:${selectedTurn.runId}` : selectedGitScope;
   const collapseScopeKey = routeThreadRef
     ? `${routeThreadRef.environmentId}:${routeThreadRef.threadId}:${reviewSectionId}`
     : null;
@@ -240,12 +241,12 @@ export default function DiffPanel({
       fromTurnCount: selectedCheckpointRange?.fromTurnCount ?? null,
       toTurnCount: selectedCheckpointRange?.toTurnCount ?? null,
       ignoreWhitespace: diffIgnoreWhitespace,
-      cacheScope: selectedTurn ? `turn:${selectedTurn.turnId}` : null,
+      cacheScope: selectedTurn ? `turn:${selectedTurn.runId}` : null,
     },
     { enabled: isGitRepo && selectedTurn !== undefined },
   );
   const primaryBranchDiffPreview = useEnvironmentQuery(
-    selectedTurnId === null && activeThread && activeCwd
+    selectedRunId === null && activeThread && activeCwd
       ? reviewEnvironment.diffPreview({
           environmentId: activeThread.environmentId,
           input: {
@@ -257,7 +258,7 @@ export default function DiffPanel({
       : null,
   );
   const shouldRetryBranchDiffAtEnvironmentCwd =
-    selectedTurnId === null &&
+    selectedRunId === null &&
     primaryBranchDiffPreview.error?.includes("configured workspace root") === true &&
     serverConfig?.cwd !== undefined &&
     serverConfig.cwd !== activeCwd;
@@ -278,7 +279,7 @@ export default function DiffPanel({
     : primaryBranchDiffPreview;
   const refreshBranchDiffPreview = branchDiffPreview.refresh;
   const canRefreshGitDiff =
-    isGitRepo && selectedTurnId === null && activeThread != null && activeCwd != null;
+    isGitRepo && selectedRunId === null && activeThread != null && activeCwd != null;
   const activeThreadRefreshKey = routeThreadRef
     ? `${routeThreadRef.environmentId}:${routeThreadRef.threadId}`
     : null;
@@ -293,7 +294,7 @@ export default function DiffPanel({
   useEffect(() => {
     const current = {
       threadKey: activeThreadRefreshKey,
-      turnId: latestTurn?.turnId ?? null,
+      runId: latestTurn?.runId ?? null,
     };
     const previous = lastCompletedTurnRefreshRef.current;
     if (!canRefreshGitDiff) {
@@ -303,17 +304,17 @@ export default function DiffPanel({
       lastCompletedTurnRefreshRef.current = current;
       return;
     }
-    if (previous.turnId === current.turnId) return;
+    if (previous.runId === current.runId) return;
     refreshBranchDiffPreview();
     lastCompletedTurnRefreshRef.current = current;
-  }, [activeThreadRefreshKey, canRefreshGitDiff, latestTurn?.turnId, refreshBranchDiffPreview]);
+  }, [activeThreadRefreshKey, canRefreshGitDiff, latestTurn?.runId, refreshBranchDiffPreview]);
 
   const selectedGitSource = branchDiffPreview.data?.sources.find(
     (source) => source.kind === (selectedGitScope === "unstaged" ? "working-tree" : "branch-range"),
   );
   const loadDiffFiles = useMemo<FileDiffContentsLoader | undefined>(() => {
     const preview = branchDiffPreview.data;
-    if (selectedTurnId !== null || !activeThread || !preview || !selectedGitSource) {
+    if (selectedRunId !== null || !activeThread || !preview || !selectedGitSource) {
       return undefined;
     }
 
@@ -325,15 +326,9 @@ export default function DiffPanel({
       headRef: selectedGitSource.headRef,
       cacheKey: selectedGitSource.diffHash,
     });
-  }, [
-    activeThread,
-    branchDiffPreview.data,
-    getDiffFileContents,
-    selectedGitSource,
-    selectedTurnId,
-  ]);
+  }, [activeThread, branchDiffPreview.data, getDiffFileContents, selectedGitSource, selectedRunId]);
   const localBranchRefs = useEnvironmentQuery(
-    selectedTurnId === null &&
+    selectedRunId === null &&
       selectedGitScope === "branch" &&
       activeThread &&
       branchDiffPreview.data?.cwd
@@ -350,7 +345,7 @@ export default function DiffPanel({
       : null,
   );
   const remoteBranchRefs = useEnvironmentQuery(
-    selectedTurnId === null &&
+    selectedRunId === null &&
       selectedGitScope === "branch" &&
       activeThread &&
       branchDiffPreview.data?.cwd
@@ -393,9 +388,9 @@ export default function DiffPanel({
   const renderablePatch = useMemo(
     () =>
       getRenderablePatch(selectedPatch, `diff-panel:${resolvedTheme}`, {
-        compactPartialHunkOffsets: selectedTurnId === null,
+        compactPartialHunkOffsets: selectedRunId === null,
       }),
-    [resolvedTheme, selectedPatch, selectedTurnId],
+    [resolvedTheme, selectedPatch, selectedRunId],
   );
   const renderableFiles = useMemo(() => {
     if (!renderablePatch || renderablePatch.kind !== "files") {
@@ -496,9 +491,9 @@ export default function DiffPanel({
     });
   }, [collapseScopeKey, diffFileKeys]);
 
-  const selectTurn = (turnId: TurnId) => {
+  const selectTurn = (runId: RunId) => {
     if (!routeThreadRef) return;
-    useDiffPanelStore.getState().selectTurn(routeThreadRef, turnId);
+    useDiffPanelStore.getState().selectTurn(routeThreadRef, runId);
   };
   const selectGitScope = (scope: "branch" | "unstaged") => {
     if (!routeThreadRef) return;
@@ -523,35 +518,44 @@ export default function DiffPanel({
           <DropdownMenuContent align="start" className="w-60">
             <DropdownMenuItem
               className={
-                selectedTurnId === null && selectedGitScope === "unstaged"
+                selectedRunId === null && selectedGitScope === "unstaged"
                   ? "bg-foreground/[0.08]"
                   : undefined
               }
               onClick={() => selectGitScope("unstaged")}
             >
               <span>Working tree</span>
+              {selectedRunId === null && selectedGitScope === "unstaged" && (
+                <CheckIcon className="ml-auto" />
+              )}
             </DropdownMenuItem>
             <DropdownMenuItem
               className={
-                selectedTurnId === null && selectedGitScope === "branch"
+                selectedRunId === null && selectedGitScope === "branch"
                   ? "bg-foreground/[0.08]"
                   : undefined
               }
               onClick={() => selectGitScope("branch")}
             >
               <span>Branch changes</span>
+              {selectedRunId === null && selectedGitScope === "branch" && (
+                <CheckIcon className="ml-auto" />
+              )}
             </DropdownMenuItem>
             <DropdownMenuItem
               className={
-                selectedTurnId !== null && selectedTurn?.turnId === latestTurn?.turnId
+                selectedRunId !== null && selectedTurn?.runId === latestTurn?.runId
                   ? "bg-foreground/[0.08]"
                   : undefined
               }
               onClick={() => {
-                if (latestTurn) selectTurn(latestTurn.turnId);
+                if (latestTurn) selectTurn(latestTurn.runId);
               }}
             >
               <span>Latest turn</span>
+              {selectedRunId !== null && selectedTurn?.runId === latestTurn?.runId && (
+                <CheckIcon className="ml-auto" />
+              )}
             </DropdownMenuItem>
             <DropdownMenuSub>
               <DropdownMenuSubTrigger>Turn</DropdownMenuSubTrigger>
@@ -559,20 +563,21 @@ export default function DiffPanel({
                 {orderedTurnDiffSummaries.map((summary) => {
                   const turnCount =
                     summary.checkpointTurnCount ??
-                    inferredCheckpointTurnCountByTurnId[summary.turnId] ??
+                    inferredCheckpointTurnCountByRunId[summary.runId] ??
                     "?";
                   return (
                     <DropdownMenuItem
-                      key={summary.turnId}
+                      key={summary.runId}
                       className={
-                        summary.turnId === selectedTurn?.turnId ? "bg-foreground/[0.08]" : undefined
+                        summary.runId === selectedTurn?.runId ? "bg-foreground/[0.08]" : undefined
                       }
-                      onClick={() => selectTurn(summary.turnId)}
+                      onClick={() => selectTurn(summary.runId)}
                     >
                       <span>Turn {turnCount}</span>
                       <span className="ml-auto text-xs tabular-nums text-muted-foreground">
                         {formatShortTimestamp(summary.completedAt, settings.timestampFormat)}
                       </span>
+                      {summary.runId === selectedTurn?.runId && <CheckIcon className="ml-1" />}
                     </DropdownMenuItem>
                   );
                 })}
@@ -580,7 +585,7 @@ export default function DiffPanel({
             </DropdownMenuSub>
           </DropdownMenuContent>
         </DropdownMenu>
-        {selectedTurnId === null && selectedGitScope === "branch" && selectedGitSource?.baseRef && (
+        {selectedRunId === null && selectedGitScope === "branch" && selectedGitSource?.baseRef && (
           <div
             className="flex min-w-0 max-w-full items-center gap-2 overflow-hidden text-xs text-muted-foreground"
             aria-label={`Comparing ${selectedGitSource.headRef ?? "HEAD"} against ${selectedGitSource.baseRef}`}
@@ -839,7 +844,7 @@ export default function DiffPanel({
         <div className="flex flex-1 items-center justify-center px-5 text-center text-xs text-muted-foreground/70">
           Turn diffs are unavailable because this project is not a git repository.
         </div>
-      ) : selectedTurnId !== null && orderedTurnDiffSummaries.length === 0 ? (
+      ) : selectedRunId !== null && orderedTurnDiffSummaries.length === 0 ? (
         <div className="flex flex-1 items-center justify-center px-5 text-center text-xs text-muted-foreground/70">
           No completed turns yet.
         </div>
diff --git a/apps/web/src/components/GitActionsControl.logic.test.ts b/apps/web/src/components/GitActionsControl.logic.test.ts
index f302e976ca70..6d33d412ec8c 100644
--- a/apps/web/src/components/GitActionsControl.logic.test.ts
+++ b/apps/web/src/components/GitActionsControl.logic.test.ts
@@ -3,9 +3,12 @@ import { assert, describe, it } from "vite-plus/test";
 import {
   buildGitActionProgressStages,
   buildMenuItems,
+  formatGitActionElapsed,
   requiresDefaultBranchConfirmation,
   resolveAutoFeatureBranchName,
   resolveDefaultBranchActionDialogCopy,
+  resolveGitActionProgressPresentation,
+  resolveGitActionResultToastTiming,
   resolveLiveThreadBranchUpdate,
   resolveQuickAction,
   resolveThreadBranchUpdate,
@@ -32,8 +35,98 @@ function status(overrides: Partial<VcsStatusResult> = {}): VcsStatusResult {
   };
 }
 
+describe("git action progress presentation", () => {
+  it("keeps the phase on the first row and hook output on the second", () => {
+    assert.deepEqual(
+      resolveGitActionProgressPresentation({
+        isRunning: true,
+        operation: "run_change_request",
+        currentLabel: "Running pre-commit...",
+        lastOutputLine: "Checking formatting and lint rules",
+        phaseStartedAtMs: 1_000,
+        hookStartedAtMs: 2_000,
+      }),
+      {
+        status: "Running pre-commit...",
+        output: "Checking formatting and lint rules",
+        startedAtMs: 2_000,
+      },
+    );
+  });
+
+  it("omits empty output and supplies a brief startup label", () => {
+    assert.deepEqual(
+      resolveGitActionProgressPresentation({
+        isRunning: true,
+        operation: "run_change_request",
+        currentLabel: "Running source control action",
+        lastOutputLine: "  ",
+        phaseStartedAtMs: 1_000,
+        hookStartedAtMs: null,
+      }),
+      {
+        status: "Starting source control action...",
+        output: null,
+        startedAtMs: 1_000,
+      },
+    );
+  });
+
+  it("presents pull progress inline without a second row", () => {
+    assert.deepEqual(
+      resolveGitActionProgressPresentation({
+        isRunning: true,
+        operation: "pull",
+        currentLabel: "Pulling latest changes...",
+        lastOutputLine: null,
+        phaseStartedAtMs: 1_000,
+        hookStartedAtMs: null,
+      }),
+      {
+        status: "Pulling latest changes...",
+        output: null,
+        startedAtMs: 1_000,
+      },
+    );
+  });
+
+  it("does not present unrelated or completed actions", () => {
+    const input = {
+      isRunning: true,
+      operation: "publish_repository",
+      currentLabel: "Publishing repository",
+      lastOutputLine: null,
+      phaseStartedAtMs: 1_000,
+      hookStartedAtMs: null,
+    };
+
+    assert.isNull(resolveGitActionProgressPresentation(input));
+    assert.isNull(resolveGitActionProgressPresentation({ ...input, isRunning: false }));
+  });
+
+  it("formats compact elapsed time without allowing negative values", () => {
+    assert.isNull(formatGitActionElapsed(null, 10_000));
+    assert.equal(formatGitActionElapsed(10_000, 9_000), "0s");
+    assert.equal(formatGitActionElapsed(10_000, 14_900), "4s");
+    assert.equal(formatGitActionElapsed(10_000, 75_000), "1m 5s");
+  });
+});
+
+describe("git action result toast timing", () => {
+  it("keeps errors sticky and dismisses successes after visible time", () => {
+    assert.deepEqual(resolveGitActionResultToastTiming("error"), {
+      timeout: 0,
+      dismissAfterVisibleMs: null,
+    });
+    assert.deepEqual(resolveGitActionResultToastTiming("success"), {
+      timeout: 0,
+      dismissAfterVisibleMs: 10_000,
+    });
+  });
+});
+
 describe("when: ref is clean and has an open PR", () => {
-  it("resolveQuickAction opens the existing PR", () => {
+  it("resolveQuickAction rests in the disabled up-to-date state", () => {
     const quick = resolveQuickAction(
       status({
         pr: {
@@ -47,10 +140,15 @@ describe("when: ref is clean and has an open PR", () => {
       }),
       false,
     );
-    assert.deepInclude(quick, { kind: "open_pr", label: "View PR", disabled: false });
+    assert.deepInclude(quick, {
+      kind: "show_hint",
+      label: "Commit",
+      disabled: true,
+      hint: "Branch is up to date. No action needed.",
+    });
   });
 
-  it("buildMenuItems disables commit/push and enables open PR", () => {
+  it("buildMenuItems disables commit/push and omits the PR entry", () => {
     const items = buildMenuItems(
       status({
         pr: {
@@ -81,13 +179,6 @@ describe("when: ref is clean and has an open PR", () => {
         kind: "open_dialog",
         dialogAction: "push",
       },
-      {
-        id: "pr",
-        label: "View PR",
-        disabled: false,
-        icon: "pr",
-        kind: "open_pr",
-      },
     ]);
   });
 });
@@ -170,7 +261,7 @@ describe("when: ref is clean, ahead, and has an open PR", () => {
     assert.deepInclude(quick, { kind: "run_action", action: "push", label: "Push" });
   });
 
-  it("buildMenuItems enables push and keeps open PR available", () => {
+  it("buildMenuItems enables push and omits the PR entry", () => {
     const items = buildMenuItems(
       status({
         aheadCount: 2,
@@ -202,13 +293,6 @@ describe("when: ref is clean, ahead, and has an open PR", () => {
         kind: "open_dialog",
         dialogAction: "push",
       },
-      {
-        id: "pr",
-        label: "View PR",
-        disabled: false,
-        icon: "pr",
-        kind: "open_pr",
-      },
     ]);
   });
 });
@@ -637,7 +721,7 @@ describe("when: ref has no upstream configured", () => {
     });
   });
 
-  it("resolveQuickAction opens PR when clean, no upstream, no local commits are ahead, and PR exists", () => {
+  it("resolveQuickAction rests disabled when clean, no upstream, no local commits are ahead, and PR exists", () => {
     const quick = resolveQuickAction(
       status({
         hasUpstream: false,
@@ -654,9 +738,10 @@ describe("when: ref has no upstream configured", () => {
       false,
     );
     assert.deepInclude(quick, {
-      kind: "open_pr",
-      label: "View PR",
-      disabled: false,
+      kind: "show_hint",
+      label: "Commit",
+      disabled: true,
+      hint: "Branch is up to date. No action needed.",
     });
   });
 
diff --git a/apps/web/src/components/GitActionsControl.logic.ts b/apps/web/src/components/GitActionsControl.logic.ts
index 96f7af794ace..8d3b7bc30578 100644
--- a/apps/web/src/components/GitActionsControl.logic.ts
+++ b/apps/web/src/components/GitActionsControl.logic.ts
@@ -19,14 +19,14 @@ export interface GitActionMenuItem {
   label: string;
   disabled: boolean;
   icon: GitActionIconName;
-  kind: "open_dialog" | "open_pr";
+  kind: "open_dialog";
   dialogAction?: GitDialogAction;
 }
 
 export interface GitQuickAction {
   label: string;
   disabled: boolean;
-  kind: "run_action" | "run_pull" | "open_pr" | "open_publish" | "show_hint";
+  kind: "run_action" | "run_pull" | "open_publish" | "show_hint";
   action?: GitStackedAction;
   hint?: string;
 }
@@ -37,12 +37,34 @@ export interface DefaultBranchActionDialogCopy {
   continueLabel: string;
 }
 
+export interface GitActionProgressPresentation {
+  readonly status: string;
+  readonly output: string | null;
+  readonly startedAtMs: number | null;
+}
+
+export interface GitActionResultToastTiming {
+  readonly timeout: 0;
+  readonly dismissAfterVisibleMs: number | null;
+}
+
 export type DefaultBranchConfirmableAction =
   | "push"
   | "create_pr"
   | "commit_push"
   | "commit_push_pr";
 
+export const GIT_ACTION_SUCCESS_VISIBLE_MS = 10_000;
+
+export function resolveGitActionResultToastTiming(
+  type: "error" | "success",
+): GitActionResultToastTiming {
+  return {
+    timeout: 0,
+    dismissAfterVisibleMs: type === "success" ? GIT_ACTION_SUCCESS_VISIBLE_MS : null,
+  };
+}
+
 function resolveChangeRequestTerminology(
   gitStatus: VcsStatusResult | null,
 ): ChangeRequestTerminology {
@@ -51,6 +73,53 @@ function resolveChangeRequestTerminology(
     : DEFAULT_CHANGE_REQUEST_TERMINOLOGY;
 }
 
+export function resolveGitActionProgressPresentation(input: {
+  readonly isRunning: boolean;
+  readonly operation: string | null;
+  readonly currentLabel: string | null;
+  readonly lastOutputLine: string | null;
+  readonly phaseStartedAtMs: number | null;
+  readonly hookStartedAtMs: number | null;
+}): GitActionProgressPresentation | null {
+  if (
+    !input.isRunning ||
+    (input.operation !== "run_change_request" && input.operation !== "pull")
+  ) {
+    return null;
+  }
+
+  const currentLabel = input.currentLabel?.trim();
+  const output = input.lastOutputLine?.trim();
+  const isPull = input.operation === "pull";
+  return {
+    status:
+      currentLabel && currentLabel !== "Running source control action"
+        ? currentLabel
+        : isPull
+          ? "Pulling latest changes..."
+          : "Starting source control action...",
+    output: !isPull && output ? output : null,
+    startedAtMs: isPull
+      ? input.phaseStartedAtMs
+      : (input.hookStartedAtMs ?? input.phaseStartedAtMs),
+  };
+}
+
+export function formatGitActionElapsed(startedAtMs: number | null, nowMs: number): string | null {
+  if (startedAtMs === null) {
+    return null;
+  }
+
+  const elapsedSeconds = Math.max(0, Math.floor((nowMs - startedAtMs) / 1_000));
+  if (elapsedSeconds < 60) {
+    return `${elapsedSeconds}s`;
+  }
+
+  const minutes = Math.floor(elapsedSeconds / 60);
+  const seconds = elapsedSeconds % 60;
+  return `${minutes}m ${seconds}s`;
+}
+
 export function buildGitActionProgressStages(input: {
   action: GitStackedAction;
   hasCustomCommitMessage: boolean;
@@ -120,7 +189,6 @@ export function buildMenuItems(
     hasDefaultBranchDelta &&
     !isBehind &&
     (gitStatus.hasUpstream || canPushWithoutUpstream);
-  const canOpenPr = !isBusy && hasOpenPr;
 
   const commitItem: GitActionMenuItem = {
     id: "commit",
@@ -135,32 +203,32 @@ export function buildMenuItems(
     return [commitItem];
   }
 
+  const pushItem: GitActionMenuItem = {
+    id: "push",
+    label: "Push",
+    disabled: !canPush,
+    icon: "push",
+    kind: "open_dialog",
+    dialogAction: "push",
+  };
+
+  // An open change request is surfaced by the standalone attribution row, so
+  // the menu offers no change-request entry at all while one is open.
+  if (hasOpenPr) {
+    return [commitItem, pushItem];
+  }
+
   return [
     commitItem,
+    pushItem,
     {
-      id: "push",
-      label: "Push",
-      disabled: !canPush,
-      icon: "push",
+      id: "pr",
+      label: `Create ${terminology.shortLabel}`,
+      disabled: !canCreatePr,
+      icon: "pr",
       kind: "open_dialog",
-      dialogAction: "push",
+      dialogAction: "create_pr",
     },
-    hasOpenPr
-      ? {
-          id: "pr",
-          label: `View ${terminology.shortLabel}`,
-          disabled: !canOpenPr,
-          icon: "pr",
-          kind: "open_pr",
-        }
-      : {
-          id: "pr",
-          label: `Create ${terminology.shortLabel}`,
-          disabled: !canCreatePr,
-          icon: "pr",
-          kind: "open_dialog",
-          dialogAction: "create_pr",
-        },
   ];
 }
 
@@ -218,9 +286,6 @@ export function resolveQuickAction(
 
   if (!gitStatus.hasUpstream) {
     if (!hasPrimaryRemote) {
-      if (hasOpenPr && !isAhead) {
-        return { label: `View ${terminology.shortLabel}`, disabled: false, kind: "open_pr" };
-      }
       return {
         label: "Publish repository",
         disabled: false,
@@ -229,7 +294,12 @@ export function resolveQuickAction(
     }
     if (!isAhead) {
       if (hasOpenPr) {
-        return { label: `View ${terminology.shortLabel}`, disabled: false, kind: "open_pr" };
+        return {
+          label: "Commit",
+          disabled: true,
+          kind: "show_hint",
+          hint: "Branch is up to date. No action needed.",
+        };
       }
       return {
         label: "Push",
@@ -288,8 +358,15 @@ export function resolveQuickAction(
     };
   }
 
+  // An open change request is surfaced by the standalone attribution row in the
+  // details panel, so the action button rests in its disabled up-to-date state.
   if (hasOpenPr && gitStatus.hasUpstream) {
-    return { label: `View ${terminology.shortLabel}`, disabled: false, kind: "open_pr" };
+    return {
+      label: "Commit",
+      disabled: true,
+      kind: "show_hint",
+      hint: "Branch is up to date. No action needed.",
+    };
   }
 
   if (hasDefaultBranchDelta && !isDefaultRef) {
diff --git a/apps/web/src/components/GitActionsControl.tsx b/apps/web/src/components/GitActionsControl.tsx
index d448a720ebfc..639de47c2604 100644
--- a/apps/web/src/components/GitActionsControl.tsx
+++ b/apps/web/src/components/GitActionsControl.tsx
@@ -5,7 +5,6 @@ import {
   squashAtomCommandFailure,
 } from "@t3tools/client-runtime/state/runtime";
 import type {
-  GitActionProgressEvent,
   GitRunStackedActionResult,
   GitStackedAction,
   SourceControlCloneProtocol,
@@ -25,6 +24,7 @@ import {
   CloudDownloadIcon,
   CloudUploadIcon,
   ExternalLinkIcon,
+  FileDiffIcon,
   GitBranchPlusIcon,
   GitCommitIcon,
   InfoIcon,
@@ -36,15 +36,20 @@ import { AzureDevOpsIcon, BitbucketIcon, GitHubIcon, GitLabIcon } from "~/compon
 import { RadioGroup } from "~/components/ui/radio-group";
 import { Spinner } from "~/components/ui/spinner";
 import { cn } from "~/lib/utils";
+import { openPullRequestLink } from "~/lib/openPullRequestLink";
 import {
-  buildGitActionProgressStages,
   buildMenuItems,
+  formatGitActionElapsed,
+  GIT_ACTION_SUCCESS_VISIBLE_MS,
+  type GitActionProgressPresentation,
   type GitActionIconName,
   type GitActionMenuItem,
   type GitQuickAction,
   type DefaultBranchConfirmableAction,
   requiresDefaultBranchConfirmation,
   resolveDefaultBranchActionDialogCopy,
+  resolveGitActionProgressPresentation,
+  resolveGitActionResultToastTiming,
   resolveLiveThreadBranchUpdate,
   resolveThreadBranchMetadataPatch,
   resolveQuickAction,
@@ -69,7 +74,7 @@ import { Menu, MenuItem, MenuPopup, MenuTrigger } from "~/components/ui/menu";
 import { Popover, PopoverPopup, PopoverTrigger } from "~/components/ui/popover";
 import { ScrollArea } from "~/components/ui/scroll-area";
 import { Textarea } from "~/components/ui/textarea";
-import { stackedThreadToast, toastManager, type ThreadToastData } from "~/components/ui/toast";
+import { stackedThreadToast, toastManager } from "~/components/ui/toast";
 import { Tooltip, TooltipPopup, TooltipTrigger } from "~/components/ui/tooltip";
 import { useOpenInPreferredEditor } from "~/editorPreferences";
 import {
@@ -79,19 +84,28 @@ import {
   useVcsInitAction,
   useVcsPullAction,
 } from "~/lib/sourceControlActions";
-import { useThread } from "~/state/entities";
+import { useThreadShell } from "~/state/entities";
 import { useEnvironmentQuery } from "~/state/query";
 import { serverEnvironment } from "~/state/server";
 import { sourceControlEnvironment } from "~/state/sourceControl";
 import { threadEnvironment } from "~/state/threads";
 import { useAtomCommand } from "~/state/use-atom-command";
-import { vcsEnvironment } from "~/state/vcs";
+import { vcsActionManager, vcsEnvironment } from "~/state/vcs";
 import { randomUUID } from "~/lib/utils";
 import { resolvePathLinkTarget } from "~/terminal-links";
 import { type DraftId, useComposerDraftStore } from "~/composerDraftStore";
 import { readLocalApi } from "~/localApi";
+import {
+  THREAD_DETAILS_PANEL_CHEVRON_CLASS,
+  THREAD_DETAILS_PANEL_ICON_CLASS,
+  THREAD_DETAILS_PANEL_ROW_POPUP_CLASS,
+  THREAD_DETAILS_PANEL_ROW_CLASS,
+  THREAD_DETAILS_PANEL_SPLIT_GROUP_CLASS,
+  THREAD_DETAILS_PANEL_SPLIT_PRIMARY_CLASS,
+  THREAD_DETAILS_PANEL_SPLIT_SECONDARY_CLASS,
+  THREAD_DETAILS_PANEL_SPLIT_SEPARATOR_CLASS,
+} from "./chat/threadDetailsPanelStyles";
 import { getSourceControlPresentation } from "~/sourceControlPresentation";
-import { openPullRequestLink } from "~/lib/openPullRequestLink";
 
 interface GitActionsControlProps {
   gitCwd: string | null;
@@ -102,6 +116,8 @@ interface GitActionsControlProps {
    * place it against, in which case it still opens in the browser.
    */
   onOpenPullRequest?: ((number: number) => void) | undefined;
+  displayMode?: "toolbar" | "panel";
+  onOpenChanges?: () => void;
 }
 
 interface PendingDefaultBranchAction {
@@ -120,18 +136,6 @@ type PublishProviderKind = Extract<
 
 type GitActionToastId = ReturnType<typeof toastManager.add>;
 
-interface ActiveGitActionProgress {
-  toastId: GitActionToastId;
-  toastData: ThreadToastData | undefined;
-  actionId: string;
-  title: string;
-  phaseStartedAtMs: number | null;
-  hookStartedAtMs: number | null;
-  hookName: string | null;
-  lastOutputLine: string | null;
-  currentPhaseLabel: string | null;
-}
-
 interface RunGitActionWithToastInput {
   action: GitStackedAction;
   commitMessage?: string;
@@ -139,10 +143,15 @@ interface RunGitActionWithToastInput {
   skipDefaultBranchPrompt?: boolean;
   statusOverride?: VcsStatusResult | null;
   featureBranch?: boolean;
-  progressToastId?: GitActionToastId;
   filePaths?: string[];
 }
 
+interface InlineGitActionSuccess {
+  readonly title: string;
+  readonly description: string | null;
+  readonly scopeKey: string;
+}
+
 const GIT_STATUS_WINDOW_REFRESH_DEBOUNCE_MS = 250;
 
 type RefreshVcsStatus = (target: {
@@ -244,26 +253,6 @@ function getPublishProviderReadiness(input: {
   return { ready: true, hint: null };
 }
 
-function formatElapsedDescription(startedAtMs: number | null): string | undefined {
-  if (startedAtMs === null) {
-    return undefined;
-  }
-  const elapsedSeconds = Math.max(0, Math.floor((Date.now() - startedAtMs) / 1000));
-  if (elapsedSeconds < 60) {
-    return `Running for ${elapsedSeconds}s`;
-  }
-  const minutes = Math.floor(elapsedSeconds / 60);
-  const seconds = elapsedSeconds % 60;
-  return `Running for ${minutes}m ${seconds}s`;
-}
-
-function resolveProgressDescription(progress: ActiveGitActionProgress): string | undefined {
-  if (progress.lastOutputLine) {
-    return progress.lastOutputLine;
-  }
-  return formatElapsedDescription(progress.hookStartedAtMs ?? progress.phaseStartedAtMs);
-}
-
 function getMenuActionDisabledReason({
   item,
   gitStatus,
@@ -281,7 +270,6 @@ function getMenuActionDisabledReason({
 
   const hasBranch = gitStatus.refName !== null;
   const hasChanges = gitStatus.hasWorkingTreeChanges;
-  const hasOpenPr = gitStatus.pr?.state === "open";
   const isAhead = gitStatus.aheadCount > 0;
   const isBehind = gitStatus.behindCount > 0;
   const terminology = getSourceControlPresentation(gitStatus.sourceControlProvider).terminology;
@@ -312,9 +300,6 @@ function getMenuActionDisabledReason({
     return "Push is currently unavailable.";
   }
 
-  if (hasOpenPr) {
-    return `View ${terminology.singular} is currently unavailable.`;
-  }
   if (!hasBranch) {
     return `Detached HEAD: checkout a refName before creating a ${terminology.singular}.`;
   }
@@ -352,12 +337,13 @@ function GitActionItemIcon({
 function GitQuickActionIcon({
   quickAction,
   SourceControlIcon,
+  className = "size-3.5",
 }: {
   quickAction: GitQuickAction;
   SourceControlIcon: ReturnType<typeof getSourceControlPresentation>["Icon"];
+  className?: string;
 }) {
-  const iconClassName = "size-3.5";
-  if (quickAction.kind === "open_pr") return <SourceControlIcon className={iconClassName} />;
+  const iconClassName = className;
   if (quickAction.kind === "open_publish") return <CloudUploadIcon className={iconClassName} />;
   if (quickAction.kind === "run_pull") return <CloudDownloadIcon className={iconClassName} />;
   if (quickAction.kind === "run_action") {
@@ -372,6 +358,137 @@ function GitQuickActionIcon({
   return <InfoIcon className={iconClassName} />;
 }
 
+function GitActionElapsedTime({
+  startedAtMs,
+  className,
+}: {
+  startedAtMs: number | null;
+  className?: string;
+}) {
+  const [nowMs, setNowMs] = useState(() => Date.now());
+
+  useEffect(() => {
+    if (startedAtMs === null) {
+      return;
+    }
+
+    const intervalId = window.setInterval(() => {
+      setNowMs(Date.now());
+    }, 1_000);
+    return () => window.clearInterval(intervalId);
+  }, [startedAtMs]);
+
+  const elapsed = formatGitActionElapsed(startedAtMs, nowMs);
+  if (!elapsed) {
+    return null;
+  }
+
+  return <p className={className}>{elapsed}</p>;
+}
+
+function GitActionProgressButtonContent({
+  progress,
+  isPanel,
+}: {
+  progress: GitActionProgressPresentation;
+  isPanel: boolean;
+}) {
+  const hasOutput = progress.output !== null;
+
+  return (
+    <div
+      aria-atomic="false"
+      aria-live="polite"
+      className={cn(
+        "grid min-w-0 flex-1 items-center",
+        // Pin the title row to the button's minimum content height (min-height
+        // minus vertical padding and border) so revealing the output row
+        // extends the button downward without re-centering — the title must
+        // not shift. No row gap: the collapsed output row must contribute zero
+        // height so the single-line running button matches the static button
+        // exactly. The panel column gap matches the static row's icon-to-label
+        // distance (gap-2.5 plus the label's ml-0.5). In the panel the elapsed
+        // counter renders outside the button (in the menu-chevron slot), so
+        // there is no trailing column.
+        isPanel
+          ? "grid-cols-[auto_minmax(0,1fr)] grid-rows-[1.75rem] gap-x-3"
+          : "grid-cols-[auto_minmax(0,1fr)_auto] grid-rows-[1.25rem] gap-x-2.5 sm:grid-rows-[1rem]",
+      )}
+      role="status"
+    >
+      <Spinner
+        aria-hidden="true"
+        className="row-start-1 -mx-0.5 size-4 shrink-0 text-muted-foreground"
+      />
+      <p className="row-start-1 min-w-0 truncate text-left">{progress.status}</p>
+      {!isPanel ? (
+        <GitActionElapsedTime
+          startedAtMs={progress.startedAtMs}
+          className="row-start-1 text-[11px] font-normal tabular-nums text-muted-foreground"
+        />
+      ) : null}
+      <div
+        className={cn(
+          "col-start-2 grid min-w-0 transition-[grid-template-rows,opacity] duration-200 ease-out motion-reduce:transition-none",
+          !isPanel && "col-span-2",
+          hasOutput ? "grid-rows-[1fr] opacity-100" : "grid-rows-[0fr] opacity-0",
+        )}
+      >
+        <div className="min-h-0 overflow-hidden">
+          <Tooltip>
+            <TooltipTrigger
+              render={
+                <p className="truncate pt-0.5 text-left text-[11px] font-normal text-muted-foreground" />
+              }
+            >
+              {progress.output}
+            </TooltipTrigger>
+            <TooltipPopup side="bottom" className="max-w-96 break-words">
+              {progress.output}
+            </TooltipPopup>
+          </Tooltip>
+        </div>
+      </div>
+    </div>
+  );
+}
+
+function GitActionSuccessButtonContent({ success }: { success: InlineGitActionSuccess }) {
+  const hasDescription = success.description !== null;
+
+  return (
+    <div
+      aria-live="polite"
+      className="grid min-w-0 flex-1 grid-cols-[auto_minmax(0,1fr)] grid-rows-[1.75rem] items-center gap-x-3"
+      role="status"
+    >
+      <CheckIcon aria-hidden="true" className="size-3.5 shrink-0 text-success" />
+      <p className="min-w-0 truncate text-left">{success.title}</p>
+      <div
+        className={cn(
+          "col-start-2 grid min-w-0 transition-[grid-template-rows,opacity] duration-200 ease-out motion-reduce:transition-none",
+          hasDescription ? "grid-rows-[1fr] opacity-100" : "grid-rows-[0fr] opacity-0",
+        )}
+      >
+        <div className="min-h-0 overflow-hidden">
+          <Tooltip>
+            <TooltipTrigger
+              render={
+                <p className="truncate pt-0.5 text-left text-[11px] font-normal text-muted-foreground" />
+              }
+            >
+              {success.description}
+            </TooltipTrigger>
+            <TooltipPopup side="bottom" className="max-w-96 break-words">
+              {success.description}
+            </TooltipPopup>
+          </Tooltip>
+        </div>
+      </div>
+    </div>
+  );
+}
+
 interface PublishRepositoryDialogProps {
   readonly open: boolean;
   readonly onOpenChange: (open: boolean) => void;
@@ -980,12 +1097,18 @@ export default function GitActionsControl({
   activeThreadRef,
   draftId,
   onOpenPullRequest,
+  displayMode = "toolbar",
+  onOpenChanges,
 }: GitActionsControlProps) {
+  const isPanel = displayMode === "panel";
+  const ActionGroup = isPanel ? "div" : Group;
+  const panelAnchorRef = useRef<HTMLDivElement | null>(null);
   const updateThreadMetadata = useAtomCommand(
     threadEnvironment.updateMetadata,
     "thread branch metadata update",
   );
   const activeEnvironmentId = activeThreadRef?.environmentId ?? null;
+  const successScopeKey = `${activeEnvironmentId ?? ""}\u0000${gitCwd ?? ""}`;
   const serverConfig = useAtomValue(serverEnvironment.configValueAtom(activeEnvironmentId));
   const openInPreferredEditor = useOpenInPreferredEditor(
     activeEnvironmentId,
@@ -995,6 +1118,7 @@ export default function GitActionsControl({
     () => (activeThreadRef ? { threadRef: activeThreadRef } : undefined),
     [activeThreadRef],
   );
+  const activeServerThread = useThreadShell(activeThreadRef);
   const activeDraftThread = useComposerDraftStore((store) =>
     draftId
       ? store.getDraftSession(draftId)
@@ -1002,37 +1126,30 @@ export default function GitActionsControl({
         ? store.getDraftThreadByRef(activeThreadRef)
         : null,
   );
-  const activeServerThread = useThread(activeThreadRef, {
-    waitForShell: activeDraftThread !== null,
-  });
   const setDraftThreadContext = useComposerDraftStore((store) => store.setDraftThreadContext);
   const [isCommitDialogOpen, setIsCommitDialogOpen] = useState(false);
   const [dialogCommitMessage, setDialogCommitMessage] = useState("");
   const [excludedFiles, setExcludedFiles] = useState<ReadonlySet<string>>(new Set());
   const [isEditingFiles, setIsEditingFiles] = useState(false);
   const [isPublishDialogOpen, setIsPublishDialogOpen] = useState(false);
+  const [inlineSuccess, setInlineSuccess] = useState<InlineGitActionSuccess | null>(null);
   const [pendingDefaultBranchAction, setPendingDefaultBranchAction] =
     useState<PendingDefaultBranchAction | null>(null);
-  const activeGitActionProgressRef = useRef<ActiveGitActionProgress | null>(null);
   const sourceControlScope = useMemo(
     () => ({ environmentId: activeEnvironmentId, cwd: gitCwd }),
     [activeEnvironmentId, gitCwd],
   );
+  const vcsActionState = useAtomValue(vcsActionManager.stateAtom(sourceControlScope));
+  const visibleInlineSuccess = inlineSuccess?.scopeKey === successScopeKey ? inlineSuccess : null;
   let runGitActionWithToast: (input: RunGitActionWithToastInput) => Promise<void>;
 
-  const updateActiveProgressToast = useCallback(() => {
-    const progress = activeGitActionProgressRef.current;
-    if (!progress) {
-      return;
-    }
-    toastManager.update(progress.toastId, {
-      type: "loading",
-      title: progress.title,
-      description: resolveProgressDescription(progress),
-      timeout: 0,
-      data: progress.toastData,
-    });
-  }, []);
+  useEffect(() => {
+    if (!inlineSuccess) return;
+    const timeoutId = window.setTimeout(() => {
+      setInlineSuccess(null);
+    }, GIT_ACTION_SUCCESS_VISIBLE_MS);
+    return () => window.clearTimeout(timeoutId);
+  }, [inlineSuccess]);
 
   const persistThreadBranchSync = useCallback(
     (branch: string | null) => {
@@ -1166,6 +1283,7 @@ export default function GitActionsControl({
   const quickActionDisabledReason = quickAction.disabled
     ? (quickAction.hint ?? "This action is currently unavailable.")
     : null;
+  const gitActionProgress = resolveGitActionProgressPresentation(vcsActionState);
   const pendingDefaultBranchActionCopy = pendingDefaultBranchAction
     ? resolveDefaultBranchActionDialogCopy({
         action: pendingDefaultBranchAction.action,
@@ -1175,19 +1293,6 @@ export default function GitActionsControl({
       })
     : null;
 
-  useEffect(() => {
-    const interval = window.setInterval(() => {
-      if (!activeGitActionProgressRef.current) {
-        return;
-      }
-      updateActiveProgressToast();
-    }, 1000);
-
-    return () => {
-      window.clearInterval(interval);
-    };
-  }, [updateActiveProgressToast]);
-
   useEffect(() => {
     if (gitCwd === null) {
       return;
@@ -1268,7 +1373,6 @@ export default function GitActionsControl({
       skipDefaultBranchPrompt = false,
       statusOverride,
       featureBranch = false,
-      progressToastId,
       filePaths,
     }: RunGitActionWithToastInput) => {
       const actionStatus = statusOverride ?? gitStatusForActions;
@@ -1303,106 +1407,10 @@ export default function GitActionsControl({
         return;
       }
       onConfirmed?.();
+      setInlineSuccess(null);
 
-      const progressStages = buildGitActionProgressStages({
-        action,
-        hasCustomCommitMessage: !!commitMessage?.trim(),
-        hasWorkingTreeChanges: !!actionStatus?.hasWorkingTreeChanges,
-        featureBranch,
-        terminology: changeRequestTerminology,
-        shouldPushBeforePr:
-          action === "create_pr" &&
-          (!actionStatus?.hasUpstream || (actionStatus?.aheadCount ?? 0) > 0),
-      });
       const scopedToastData = threadToastData ? { ...threadToastData } : undefined;
       const actionId = randomUUID();
-      const resolvedProgressToastId =
-        progressToastId ??
-        toastManager.add({
-          type: "loading",
-          title: progressStages[0] ?? "Running git action...",
-          description: "Waiting for Git...",
-          timeout: 0,
-          data: scopedToastData,
-        });
-
-      activeGitActionProgressRef.current = {
-        toastId: resolvedProgressToastId,
-        toastData: scopedToastData,
-        actionId,
-        title: progressStages[0] ?? "Running git action...",
-        phaseStartedAtMs: null,
-        hookStartedAtMs: null,
-        hookName: null,
-        lastOutputLine: null,
-        currentPhaseLabel: progressStages[0] ?? "Running git action...",
-      };
-
-      if (progressToastId) {
-        toastManager.update(progressToastId, {
-          type: "loading",
-          title: progressStages[0] ?? "Running git action...",
-          description: "Waiting for Git...",
-          timeout: 0,
-          data: scopedToastData,
-        });
-      }
-
-      const applyProgressEvent = (event: GitActionProgressEvent) => {
-        const progress = activeGitActionProgressRef.current;
-        if (!progress) {
-          return;
-        }
-        if (gitCwd && event.cwd !== gitCwd) {
-          return;
-        }
-        if (progress.actionId !== event.actionId) {
-          return;
-        }
-
-        const now = Date.now();
-        switch (event.kind) {
-          case "action_started":
-            progress.phaseStartedAtMs = now;
-            progress.hookStartedAtMs = null;
-            progress.hookName = null;
-            progress.lastOutputLine = null;
-            break;
-          case "phase_started":
-            progress.title = event.label;
-            progress.currentPhaseLabel = event.label;
-            progress.phaseStartedAtMs = now;
-            progress.hookStartedAtMs = null;
-            progress.hookName = null;
-            progress.lastOutputLine = null;
-            break;
-          case "hook_started":
-            progress.title = `Running ${event.hookName}...`;
-            progress.hookName = event.hookName;
-            progress.hookStartedAtMs = now;
-            progress.lastOutputLine = null;
-            break;
-          case "hook_output":
-            progress.lastOutputLine = event.text;
-            break;
-          case "hook_finished":
-            progress.title = progress.currentPhaseLabel ?? "Committing...";
-            progress.hookName = null;
-            progress.hookStartedAtMs = null;
-            progress.lastOutputLine = null;
-            break;
-          case "action_finished":
-            // Let the resolved mutation update the toast so we keep the
-            // elapsed description visible until the final success state renders.
-            return;
-          case "action_failed":
-            // Let the settled mutation publish the error toast to avoid a
-            // transient intermediate state before the final failure message.
-            return;
-        }
-
-        updateActiveProgressToast();
-      };
 
       const result = await runImmediateGitAction.run({
         actionId,
@@ -1410,23 +1418,21 @@ export default function GitActionsControl({
         ...(commitMessage ? { commitMessage } : {}),
         ...(featureBranch ? { featureBranch } : {}),
         ...(filePaths ? { filePaths } : {}),
-        onProgress: applyProgressEvent,
       });
 
-      activeGitActionProgressRef.current = null;
       if (result._tag === "Failure") {
         if (isAtomCommandInterrupted(result)) {
-          toastManager.close(resolvedProgressToastId);
           return;
         }
 
         const error = squashAtomCommandFailure(result);
-        toastManager.update(
-          resolvedProgressToastId,
+        const errorToastTiming = resolveGitActionResultToastTiming("error");
+        toastManager.add(
           stackedThreadToast({
             type: "error",
             title: "Action failed",
             description: error instanceof Error ? error.message : "An error occurred.",
+            timeout: errorToastTiming.timeout,
             ...(scopedToastData !== undefined ? { data: scopedToastData } : {}),
           }),
         );
@@ -1435,8 +1441,19 @@ export default function GitActionsControl({
 
       const actionResult = result.value;
       syncThreadBranchAfterGitAction(actionResult);
+      if (isPanel) {
+        setInlineSuccess({
+          title: actionResult.toast.title,
+          description: actionResult.toast.description ?? null,
+          scopeKey: successScopeKey,
+        });
+        return;
+      }
+      let resultToastId: GitActionToastId | null = null;
       const closeResultToast = () => {
-        toastManager.close(resolvedProgressToastId);
+        if (resultToastId !== null) {
+          toastManager.close(resultToastId);
+        }
       };
 
       const toastCta = actionResult.toast.cta;
@@ -1466,29 +1483,31 @@ export default function GitActionsControl({
         };
       }
 
+      const successToastTiming = resolveGitActionResultToastTiming("success");
       const successToastData = {
         ...scopedToastData,
-        dismissAfterVisibleMs: 10_000,
+        ...(successToastTiming.dismissAfterVisibleMs !== null
+          ? { dismissAfterVisibleMs: successToastTiming.dismissAfterVisibleMs }
+          : {}),
       };
 
       if (toastActionProps) {
-        toastManager.update(
-          resolvedProgressToastId,
+        resultToastId = toastManager.add(
           stackedThreadToast({
             type: "success",
             title: actionResult.toast.title,
             description: actionResult.toast.description,
-            timeout: 0,
+            timeout: successToastTiming.timeout,
             actionProps: toastActionProps,
             data: successToastData,
           }),
         );
       } else {
-        toastManager.update(resolvedProgressToastId, {
+        resultToastId = toastManager.add({
           type: "success",
           title: actionResult.toast.title,
           description: actionResult.toast.description,
-          timeout: 0,
+          timeout: successToastTiming.timeout,
           data: successToastData,
         });
       }
@@ -1541,35 +1560,26 @@ export default function GitActionsControl({
   };
 
   const runQuickAction = () => {
-    if (quickAction.kind === "open_pr") {
-      void openExistingPr();
-      return;
-    }
     if (quickAction.kind === "open_publish") {
       setIsPublishDialogOpen(true);
       return;
     }
     if (quickAction.kind === "run_pull") {
-      const toastId = toastManager.add({
-        type: "loading",
-        title: "Pulling...",
-        timeout: 0,
-        data: threadToastData,
-      });
       void (async () => {
+        setInlineSuccess(null);
         const result = await pullAction.run();
         if (result._tag === "Failure") {
           if (isAtomCommandInterrupted(result)) {
-            toastManager.close(toastId);
             return;
           }
           const error = squashAtomCommandFailure(result);
-          toastManager.update(
-            toastId,
+          const errorToastTiming = resolveGitActionResultToastTiming("error");
+          toastManager.add(
             stackedThreadToast({
               type: "error",
               title: "Pull failed",
               description: error instanceof Error ? error.message : "An error occurred.",
+              timeout: errorToastTiming.timeout,
               ...(threadToastData !== undefined ? { data: threadToastData } : {}),
             }),
           );
@@ -1577,14 +1587,27 @@ export default function GitActionsControl({
         }
 
         const pullResult = result.value;
-        toastManager.update(toastId, {
+        const title = pullResult.status === "pulled" ? "Pulled" : "Already up to date";
+        const description =
+          pullResult.status === "pulled"
+            ? `Updated ${pullResult.refName} from ${pullResult.upstreamRef ?? "upstream"}`
+            : `${pullResult.refName} is already synchronized.`;
+        if (isPanel) {
+          setInlineSuccess({ title, description, scopeKey: successScopeKey });
+          return;
+        }
+        const successToastTiming = resolveGitActionResultToastTiming("success");
+        toastManager.add({
           type: "success",
-          title: pullResult.status === "pulled" ? "Pulled" : "Already up to date",
-          description:
-            pullResult.status === "pulled"
-              ? `Updated ${pullResult.refName} from ${pullResult.upstreamRef ?? "upstream"}`
-              : `${pullResult.refName} is already synchronized.`,
-          data: threadToastData,
+          title,
+          description,
+          timeout: successToastTiming.timeout,
+          data: {
+            ...threadToastData,
+            ...(successToastTiming.dismissAfterVisibleMs !== null
+              ? { dismissAfterVisibleMs: successToastTiming.dismissAfterVisibleMs }
+              : {}),
+          },
         });
       })();
       return;
@@ -1605,10 +1628,6 @@ export default function GitActionsControl({
 
   const openDialogForMenuItem = (item: GitActionMenuItem) => {
     if (item.disabled) return;
-    if (item.kind === "open_pr") {
-      void openExistingPr();
-      return;
-    }
     if (item.dialogAction === "push") {
       void runGitActionWithToast({ action: "push" });
       return;
@@ -1674,8 +1693,9 @@ export default function GitActionsControl({
     <>
       {!isRepo ? (
         <Button
-          variant="outline"
           size="xs"
+          variant={isPanel ? "ghost" : "outline"}
+          className={isPanel ? THREAD_DETAILS_PANEL_ROW_CLASS : undefined}
           disabled={initAction.isPending}
           onClick={() => {
             void (async () => {
@@ -1701,25 +1721,78 @@ export default function GitActionsControl({
           </span>
         </Button>
       ) : (
-        <Group aria-label="Git actions" className="shrink-0">
-          {quickActionDisabledReason ? (
+        <ActionGroup
+          role="group"
+          aria-label="Git actions"
+          {...(isPanel ? { ref: panelAnchorRef } : {})}
+          className={cn(
+            "shrink-0",
+            isPanel && THREAD_DETAILS_PANEL_SPLIT_GROUP_CLASS,
+            isPanel && gitActionProgress && "bg-black/[0.035] dark:bg-white/[0.055]",
+          )}
+        >
+          {gitActionProgress ? (
+            <Button
+              aria-label={
+                gitActionProgress.output
+                  ? `${gitActionProgress.status} ${gitActionProgress.output}`
+                  : gitActionProgress.status
+              }
+              className={cn(
+                // Vertical padding subtracts the button's 1px border (same idiom
+                // as the size variants' px) so the h-auto single-line height
+                // lands exactly on the fixed height of the static button.
+                isPanel
+                  ? THREAD_DETAILS_PANEL_SPLIT_PRIMARY_CLASS
+                  : "h-auto min-h-7 max-w-72 py-[calc(--spacing(1)-1px)] sm:h-auto sm:min-h-6",
+                isPanel &&
+                  "h-auto min-h-9 py-[calc(--spacing(1)-1px)] disabled:opacity-100 sm:h-auto sm:min-h-9",
+              )}
+              disabled
+              size="xs"
+              variant={isPanel ? "ghost" : "outline"}
+            >
+              <GitActionProgressButtonContent isPanel={isPanel} progress={gitActionProgress} />
+            </Button>
+          ) : isPanel && visibleInlineSuccess ? (
+            <Button
+              className={cn(
+                THREAD_DETAILS_PANEL_SPLIT_PRIMARY_CLASS,
+                "h-auto min-h-9 py-[calc(--spacing(1)-1px)] disabled:opacity-100 sm:h-auto sm:min-h-9",
+              )}
+              disabled
+              size="xs"
+              variant="ghost"
+            >
+              <GitActionSuccessButtonContent success={visibleInlineSuccess} />
+            </Button>
+          ) : quickActionDisabledReason ? (
             <Popover>
               <PopoverTrigger
                 openOnHover
                 render={
                   <Button
                     aria-disabled="true"
-                    className="cursor-not-allowed rounded-e-none border-e-0 ps-[8.5px] opacity-64 before:rounded-e-none"
+                    className={cn(
+                      "cursor-not-allowed rounded-e-none border-e-0 opacity-64 before:rounded-e-none",
+                      isPanel && THREAD_DETAILS_PANEL_SPLIT_PRIMARY_CLASS,
+                    )}
                     size="xs"
-                    variant="outline"
+                    variant={isPanel ? "ghost" : "outline"}
                   />
                 }
               >
                 <GitQuickActionIcon
                   quickAction={quickAction}
                   SourceControlIcon={SourceControlIcon}
+                  {...(isPanel ? { className: THREAD_DETAILS_PANEL_ICON_CLASS } : {})}
                 />
-                <span className="sr-only @3xl/header-actions:not-sr-only @3xl/header-actions:ml-0.5">
+                <span
+                  className={cn(
+                    "sr-only @3xl/header-actions:not-sr-only @3xl/header-actions:ml-0.5",
+                    isPanel && "not-sr-only ml-0.5 truncate",
+                  )}
+                >
                   {quickAction.label}
                 </span>
               </PopoverTrigger>
@@ -1729,110 +1802,172 @@ export default function GitActionsControl({
             </Popover>
           ) : (
             <Button
-              variant="outline"
+              variant={isPanel ? "ghost" : "outline"}
               size="xs"
-              className="ps-[8.5px]"
+              className={isPanel ? THREAD_DETAILS_PANEL_SPLIT_PRIMARY_CLASS : undefined}
               disabled={isGitActionRunning || quickAction.disabled}
               onClick={runQuickAction}
             >
-              <GitQuickActionIcon quickAction={quickAction} SourceControlIcon={SourceControlIcon} />
-              <span className="sr-only @3xl/header-actions:not-sr-only @3xl/header-actions:ml-0.5">
+              <GitQuickActionIcon
+                quickAction={quickAction}
+                SourceControlIcon={SourceControlIcon}
+                {...(isPanel ? { className: THREAD_DETAILS_PANEL_ICON_CLASS } : {})}
+              />
+              <span
+                className={cn(
+                  "sr-only @3xl/header-actions:not-sr-only @3xl/header-actions:ml-0.5",
+                  isPanel && "not-sr-only ml-0.5 truncate",
+                )}
+              >
                 {quickAction.label}
               </span>
             </Button>
           )}
-          <GroupSeparator className="hidden @3xl/header-actions:block" />
-          <Menu
-            onOpenChange={(open) => {
-              if (open) {
-                requestVcsStatusRefresh(refreshVcsStatus, activeEnvironmentId, gitCwd);
-              }
-            }}
-          >
-            <MenuTrigger
-              render={<Button aria-label="Git action options" size="icon-xs" variant="outline" />}
-              disabled={isGitActionRunning}
-            >
-              <ChevronDownIcon aria-hidden="true" className="size-4" />
-            </MenuTrigger>
-            <MenuPopup align="end" className="w-full">
-              {gitActionMenuItems.map((item) => {
-                const disabledReason = getMenuActionDisabledReason({
-                  item,
-                  gitStatus: gitStatusForActions,
-                  isBusy: isGitActionRunning,
-                  hasPrimaryRemote,
-                });
-                if (item.disabled && disabledReason) {
-                  return (
-                    <Popover key={`${item.id}-${item.label}`}>
-                      <PopoverTrigger
-                        openOnHover
-                        nativeButton={false}
-                        render={<span className="block w-max cursor-not-allowed" />}
-                      >
-                        <MenuItem className="w-full" disabled>
-                          <GitActionItemIcon
-                            icon={item.icon}
-                            SourceControlIcon={SourceControlIcon}
-                          />
-                          {item.label}
-                        </MenuItem>
-                      </PopoverTrigger>
-                      <PopoverPopup tooltipStyle side="left" align="center">
-                        {disabledReason}
-                      </PopoverPopup>
-                    </Popover>
-                  );
-                }
-
-                return (
-                  <MenuItem
-                    key={`${item.id}-${item.label}`}
-                    disabled={item.disabled}
-                    onClick={() => {
-                      openDialogForMenuItem(item);
-                    }}
-                  >
-                    <GitActionItemIcon icon={item.icon} SourceControlIcon={SourceControlIcon} />
-                    {item.label}
-                  </MenuItem>
-                );
-              })}
-              {canPublishRepository ? (
-                <MenuItem
+          {isPanel && gitActionProgress ? (
+            // The menu is disabled while an action runs, so its chevron slot
+            // hosts the elapsed counter instead, leaving the full row width to
+            // the status text. Pinned to the title row so it stays put when
+            // the output row expands below.
+            <GitActionElapsedTime
+              startedAtMs={gitActionProgress.startedAtMs}
+              className="flex h-9 shrink-0 items-center self-start pe-2.5 text-[11px] font-normal tabular-nums text-muted-foreground"
+            />
+          ) : (
+            <>
+              {isPanel ? (
+                <span aria-hidden="true" className={THREAD_DETAILS_PANEL_SPLIT_SEPARATOR_CLASS} />
+              ) : (
+                <GroupSeparator className="hidden @3xl/header-actions:block" />
+              )}
+              <Menu
+                onOpenChange={(open) => {
+                  if (open) {
+                    requestVcsStatusRefresh(refreshVcsStatus, activeEnvironmentId, gitCwd);
+                  }
+                }}
+              >
+                <MenuTrigger
+                  render={
+                    <Button
+                      aria-label="Git action options"
+                      size={isPanel ? "sm" : "icon-xs"}
+                      variant={isPanel ? "ghost" : "outline"}
+                      className={cn(isPanel && THREAD_DETAILS_PANEL_SPLIT_SECONDARY_CLASS)}
+                    />
+                  }
                   disabled={isGitActionRunning}
-                  onClick={() => {
-                    setIsPublishDialogOpen(true);
-                  }}
                 >
-                  <CloudUploadIcon />
-                  Publish repository...
-                </MenuItem>
-              ) : null}
-              {gitStatusForActions?.refName === null && (
-                <p className="px-2 py-1.5 text-xs text-warning">
-                  Detached HEAD: create and checkout a refName to enable push and pull request
-                  actions.
-                </p>
-              )}
-              {gitStatusForActions &&
-                gitStatusForActions.refName !== null &&
-                !gitStatusForActions.hasWorkingTreeChanges &&
-                gitStatusForActions.behindCount > 0 &&
-                gitStatusForActions.aheadCount === 0 && (
-                  <p className="px-2 py-1.5 text-xs text-warning">
-                    Behind upstream. Pull/rebase first.
-                  </p>
-                )}
-              {gitStatusError && (
-                <p className="px-2 py-1.5 text-xs text-destructive">{gitStatusError}</p>
-              )}
-            </MenuPopup>
-          </Menu>
-        </Group>
+                  <ChevronDownIcon
+                    aria-hidden="true"
+                    className={isPanel ? THREAD_DETAILS_PANEL_CHEVRON_CLASS : "size-4"}
+                  />
+                </MenuTrigger>
+                <MenuPopup
+                  align="end"
+                  {...(isPanel ? { anchor: panelAnchorRef } : {})}
+                  className={isPanel ? THREAD_DETAILS_PANEL_ROW_POPUP_CLASS : "w-full"}
+                >
+                  {gitActionMenuItems.map((item) => {
+                    const disabledReason = getMenuActionDisabledReason({
+                      item,
+                      gitStatus: gitStatusForActions,
+                      isBusy: isGitActionRunning,
+                      hasPrimaryRemote,
+                    });
+                    if (item.disabled && disabledReason) {
+                      return (
+                        <Popover key={`${item.id}-${item.label}`}>
+                          <PopoverTrigger
+                            openOnHover
+                            nativeButton={false}
+                            render={<span className="block w-max cursor-not-allowed" />}
+                          >
+                            <MenuItem className="w-full" disabled>
+                              <GitActionItemIcon
+                                icon={item.icon}
+                                SourceControlIcon={SourceControlIcon}
+                              />
+                              {item.label}
+                            </MenuItem>
+                          </PopoverTrigger>
+                          <PopoverPopup tooltipStyle side="left" align="center">
+                            {disabledReason}
+                          </PopoverPopup>
+                        </Popover>
+                      );
+                    }
+
+                    return (
+                      <MenuItem
+                        key={`${item.id}-${item.label}`}
+                        disabled={item.disabled}
+                        onClick={() => {
+                          openDialogForMenuItem(item);
+                        }}
+                      >
+                        <GitActionItemIcon icon={item.icon} SourceControlIcon={SourceControlIcon} />
+                        {item.label}
+                      </MenuItem>
+                    );
+                  })}
+                  {canPublishRepository ? (
+                    <MenuItem
+                      disabled={isGitActionRunning}
+                      onClick={() => {
+                        setIsPublishDialogOpen(true);
+                      }}
+                    >
+                      <CloudUploadIcon />
+                      Publish repository...
+                    </MenuItem>
+                  ) : null}
+                  {gitStatusForActions?.refName === null && (
+                    <p className="px-2 py-1.5 text-xs text-warning">
+                      Detached HEAD: create and checkout a refName to enable push and pull request
+                      actions.
+                    </p>
+                  )}
+                  {gitStatusForActions &&
+                    gitStatusForActions.refName !== null &&
+                    !gitStatusForActions.hasWorkingTreeChanges &&
+                    gitStatusForActions.behindCount > 0 &&
+                    gitStatusForActions.aheadCount === 0 && (
+                      <p className="px-2 py-1.5 text-xs text-warning">
+                        Behind upstream. Pull/rebase first.
+                      </p>
+                    )}
+                  {gitStatusError && (
+                    <p className="px-2 py-1.5 text-xs text-destructive">{gitStatusError}</p>
+                  )}
+                </MenuPopup>
+              </Menu>
+            </>
+          )}
+        </ActionGroup>
       )}
 
+      {isPanel && isRepo ? (
+        <Button
+          type="button"
+          variant="ghost"
+          size="sm"
+          className={THREAD_DETAILS_PANEL_ROW_CLASS}
+          disabled={!onOpenChanges}
+          onClick={onOpenChanges}
+        >
+          <FileDiffIcon className={THREAD_DETAILS_PANEL_ICON_CLASS} aria-hidden />
+          <span className="flex-1 text-left">Changes</span>
+          <span className="flex items-center gap-1 font-mono text-[11px] tabular-nums">
+            <span className="text-success">
+              +{gitStatusForActions?.workingTree.insertions ?? 0}
+            </span>
+            <span className="text-destructive">
+              -{gitStatusForActions?.workingTree.deletions ?? 0}
+            </span>
+          </span>
+        </Button>
+      ) : null}
+
       <Dialog
         open={isCommitDialogOpen}
         onOpenChange={(open) => {
diff --git a/apps/web/src/components/LegacySidebar.tsx b/apps/web/src/components/LegacySidebar.tsx
index 189ffaa0fb9e..9e537f320e5c 100644
--- a/apps/web/src/components/LegacySidebar.tsx
+++ b/apps/web/src/components/LegacySidebar.tsx
@@ -451,7 +451,7 @@ export const SidebarThreadRow = memo(function SidebarThreadRow(props: SidebarThr
     [discoveredPorts, navigateToThread, openPreview, threadRef],
   );
   const isThreadRunning =
-    thread.session?.status === "running" && thread.session.activeTurnId != null;
+    thread.runtime?.status === "running" && thread.runtime.activeRunId != null;
   const threadStatus = resolveThreadStatusPill({
     thread: {
       ...thread,
@@ -1812,7 +1812,7 @@ const SidebarProjectItem = memo(function SidebarProjectItem(props: SidebarProjec
         return threadRef && thread ? [{ threadKey, threadRef, thread }] : [];
       });
       const hasRunningThread = selectedThreadEntries.some(
-        ({ thread }) => thread.session?.status === "running" && thread.session.activeTurnId != null,
+        ({ thread }) => thread.runtime?.status === "running" && thread.runtime.activeRunId != null,
       );
 
       const clicked = await api.contextMenu.show(
@@ -1822,7 +1822,7 @@ const SidebarProjectItem = memo(function SidebarProjectItem(props: SidebarProjec
 
       if (clicked === "mark-unread") {
         for (const { threadKey, thread } of selectedThreadEntries) {
-          markThreadUnread(threadKey, thread.latestTurn?.completedAt);
+          markThreadUnread(threadKey, thread.latestRun?.completedAt);
         }
         clearSelection();
         return;
@@ -2200,7 +2200,7 @@ const SidebarProjectItem = memo(function SidebarProjectItem(props: SidebarProjec
       }
 
       if (clicked === "mark-unread") {
-        markThreadUnread(threadKey, thread.latestTurn?.completedAt);
+        markThreadUnread(threadKey, thread.latestRun?.completedAt);
         return;
       }
       if (clicked === "copy-path") {
diff --git a/apps/web/src/components/LegacyThreadMigrationToast.tsx b/apps/web/src/components/LegacyThreadMigrationToast.tsx
new file mode 100644
index 000000000000..720e11c429d0
--- /dev/null
+++ b/apps/web/src/components/LegacyThreadMigrationToast.tsx
@@ -0,0 +1,45 @@
+import { useAtomValue } from "@effect/atom-react";
+import { useEffect, useRef } from "react";
+
+import { primaryServerLegacyThreadMigrationAtom } from "../state/server";
+import { toastManager } from "./ui/toast";
+
+type MigrationToastId = ReturnType<typeof toastManager.add>;
+
+export function LegacyThreadMigrationToast() {
+  const migration = useAtomValue(primaryServerLegacyThreadMigrationAtom);
+  const toastIdRef = useRef<MigrationToastId | null>(null);
+
+  useEffect(() => {
+    if (migration?.status === "running") {
+      if (toastIdRef.current !== null) {
+        return;
+      }
+      toastIdRef.current = toastManager.add({
+        type: "loading",
+        title: "Restoring your threads…",
+        description: `Migrating ${migration.totalThreadCount.toLocaleString()} ${
+          migration.totalThreadCount === 1 ? "thread" : "threads"
+        } from the previous version. You can keep working while this finishes.`,
+        timeout: 0,
+      });
+      return;
+    }
+
+    if (toastIdRef.current !== null) {
+      toastManager.close(toastIdRef.current);
+      toastIdRef.current = null;
+    }
+  }, [migration]);
+
+  useEffect(
+    () => () => {
+      if (toastIdRef.current !== null) {
+        toastManager.close(toastIdRef.current);
+      }
+    },
+    [],
+  );
+
+  return null;
+}
diff --git a/apps/web/src/components/ProjectScriptsControl.test.tsx b/apps/web/src/components/ProjectScriptsControl.test.tsx
index d9f3e7e69f08..8e5c0b9a53a9 100644
--- a/apps/web/src/components/ProjectScriptsControl.test.tsx
+++ b/apps/web/src/components/ProjectScriptsControl.test.tsx
@@ -26,6 +26,28 @@ function renderControl(scripts: ReadonlyArray<ProjectScript>) {
   );
 }
 
+function renderPanelControlWithImportedAction() {
+  return renderToStaticMarkup(
+    <ProjectScriptsControl
+      displayMode="panel"
+      scripts={[]}
+      fileScripts={[
+        {
+          name: "Setup Worktree",
+          command: "vp i",
+          icon: "configure",
+          runOnWorktreeCreate: true,
+        },
+      ]}
+      keybindings={EMPTY_KEYBINDINGS}
+      onRunScript={() => {}}
+      onAddScript={async () => undefined as never}
+      onUpdateScript={async () => undefined as never}
+      onDeleteScript={async () => undefined as never}
+    />,
+  );
+}
+
 function buttonTag(html: string, ariaLabel: string) {
   return html.match(new RegExp(`<button[^>]*aria-label="${ariaLabel}"[^>]*>`))?.[0];
 }
@@ -62,4 +84,16 @@ describe("ProjectScriptsControl compact controls", () => {
       'class="sr-only @3xl/header-actions:not-sr-only @3xl/header-actions:ml-0.5"',
     );
   });
+
+  it("renders available project actions as a full panel row", () => {
+    const html = renderPanelControlWithImportedAction();
+    const primary = buttonTag(html, "Project actions");
+    const menuTrigger = buttonTag(html, "Choose project action");
+
+    expect(primary).toContain("flex-1");
+    expect(primary).toContain("justify-start");
+    expect(menuTrigger).toContain("w-8");
+    expect(html).toContain("h-4 w-px");
+    expect(html).toContain(">Actions</span>");
+  });
 });
diff --git a/apps/web/src/components/ProjectScriptsControl.tsx b/apps/web/src/components/ProjectScriptsControl.tsx
index 304922909b0a..a76ea0662b1e 100644
--- a/apps/web/src/components/ProjectScriptsControl.tsx
+++ b/apps/web/src/components/ProjectScriptsControl.tsx
@@ -7,8 +7,8 @@ import {
   isAtomCommandInterrupted,
   squashAtomCommandFailure,
 } from "@t3tools/client-runtime/state/runtime";
-import { ChevronDownIcon, DownloadIcon, PlusIcon, SettingsIcon } from "lucide-react";
-import { useCallback, useMemo, useState } from "react";
+import { ChevronDownIcon, DownloadIcon, PlusIcon, SettingsIcon, WrenchIcon } from "lucide-react";
+import React, { useCallback, useMemo, useState } from "react";
 
 import { commandForProjectScript, primaryProjectScript } from "~/projectScripts";
 import { shortcutLabelForCommand } from "~/keybindings";
@@ -34,12 +34,24 @@ import {
   MenuTrigger,
 } from "./ui/menu";
 import { Tooltip, TooltipPopup, TooltipTrigger } from "./ui/tooltip";
+import { cn } from "~/lib/utils";
+import {
+  THREAD_DETAILS_PANEL_CHEVRON_CLASS,
+  THREAD_DETAILS_PANEL_ICON_CLASS,
+  THREAD_DETAILS_PANEL_ROW_POPUP_CLASS,
+  THREAD_DETAILS_PANEL_ROW_CLASS,
+  THREAD_DETAILS_PANEL_SPLIT_GROUP_CLASS,
+  THREAD_DETAILS_PANEL_SPLIT_PRIMARY_CLASS,
+  THREAD_DETAILS_PANEL_SPLIT_SECONDARY_CLASS,
+  THREAD_DETAILS_PANEL_SPLIT_SEPARATOR_CLASS,
+} from "./chat/threadDetailsPanelStyles";
 
 export type { NewProjectScriptInput, ProjectScriptActionResult };
 
 const NO_FILE_SCRIPTS: ReadonlyArray<T3ProjectFileScript> = [];
 
 interface ProjectScriptsControlProps {
+  displayMode?: "toolbar" | "panel";
   scripts: ReadonlyArray<ProjectScript>;
   /** Scripts declared in the project's checked-in t3.json, offered for import. */
   fileScripts?: ReadonlyArray<T3ProjectFileScript>;
@@ -55,6 +67,7 @@ interface ProjectScriptsControlProps {
 }
 
 export default function ProjectScriptsControl({
+  displayMode = "toolbar",
   scripts,
   fileScripts = NO_FILE_SCRIPTS,
   keybindings,
@@ -64,6 +77,11 @@ export default function ProjectScriptsControl({
   onUpdateScript,
   onDeleteScript,
 }: ProjectScriptsControlProps) {
+  const isPanel = displayMode === "panel";
+  const ActionGroup = isPanel ? "div" : Group;
+  const panelAnchorRef = React.useRef<HTMLDivElement | null>(null);
+  const addScriptFormId = React.useId();
+  const [editingScriptId, setEditingScriptId] = useState<string | null>(null);
   const [actionsMenuOpen, setActionsMenuOpen] = useState({
     scripts: false,
     imports: false,
@@ -155,14 +173,24 @@ export default function ProjectScriptsControl({
   return (
     <>
       {primaryScript ? (
-        <Group aria-label="Project scripts">
+        <ActionGroup
+          role="group"
+          aria-label="Project scripts"
+          {...(isPanel
+            ? { className: THREAD_DETAILS_PANEL_SPLIT_GROUP_CLASS, ref: panelAnchorRef }
+            : {})}
+        >
           <Tooltip>
             <TooltipTrigger
               render={
                 <Button
                   size="xs"
-                  variant="outline"
-                  className="w-7 px-0 sm:w-6 @3xl/header-actions:w-auto! @3xl/header-actions:px-[calc(--spacing(2)-1px)]"
+                  variant={isPanel ? "ghost" : "outline"}
+                  className={
+                    isPanel
+                      ? THREAD_DETAILS_PANEL_SPLIT_PRIMARY_CLASS
+                      : "w-7 px-0 sm:w-6 @3xl/header-actions:w-auto! @3xl/header-actions:px-[calc(--spacing(2)-1px)]"
+                  }
                   aria-label={`Run ${primaryScript.name}`}
                   // The tooltip wrapper replaces data-slot="button", so themed
                   // toolbar styling needs its own hook.
@@ -171,25 +199,50 @@ export default function ProjectScriptsControl({
                 />
               }
             >
-              <ScriptIcon icon={primaryScript.icon} />
-              <span className="sr-only @3xl/header-actions:not-sr-only @3xl/header-actions:ml-0.5">
+              <ScriptIcon
+                icon={primaryScript.icon}
+                {...(isPanel ? { className: THREAD_DETAILS_PANEL_ICON_CLASS } : {})}
+              />
+              <span
+                className={cn(
+                  "sr-only @3xl/header-actions:not-sr-only @3xl/header-actions:ml-0.5",
+                  isPanel && "not-sr-only ml-0.5 truncate",
+                )}
+              >
                 {primaryScript.name}
               </span>
             </TooltipTrigger>
             <TooltipPopup side="top">Run {primaryScript.name}</TooltipPopup>
           </Tooltip>
-          <GroupSeparator className="hidden @3xl/header-actions:block" />
+          {isPanel ? (
+            <span aria-hidden="true" className={THREAD_DETAILS_PANEL_SPLIT_SEPARATOR_CLASS} />
+          ) : (
+            <GroupSeparator className="hidden @3xl/header-actions:block" />
+          )}
           <Menu
             highlightItemOnHover={false}
             open={actionsMenuOpen.scripts}
             onOpenChange={(open) => setActionsMenuOpen({ scripts: open, imports: false })}
           >
             <MenuTrigger
-              render={<Button size="icon-xs" variant="outline" aria-label="Script actions" />}
+              render={
+                <Button
+                  size={isPanel ? "sm" : "icon-xs"}
+                  variant={isPanel ? "ghost" : "outline"}
+                  className={isPanel ? THREAD_DETAILS_PANEL_SPLIT_SECONDARY_CLASS : undefined}
+                  aria-label="Script actions"
+                />
+              }
             >
-              <ChevronDownIcon className="size-4" />
+              <ChevronDownIcon
+                className={isPanel ? THREAD_DETAILS_PANEL_CHEVRON_CLASS : "size-4"}
+              />
             </MenuTrigger>
-            <MenuPopup align="end">
+            <MenuPopup
+              align="end"
+              {...(isPanel ? { anchor: panelAnchorRef } : {})}
+              className={isPanel ? THREAD_DETAILS_PANEL_ROW_POPUP_CLASS : undefined}
+            >
               {scripts.map((script) => {
                 const shortcutLabel = shortcutLabelForCommand(
                   keybindings,
@@ -236,41 +289,97 @@ export default function ProjectScriptsControl({
               {importMenuItems}
               <MenuItem className={dropdownItemClassName} onClick={openAddDialog}>
                 <PlusIcon className="size-4" />
-                Add action
+                {isPanel ? "Add project script" : "Add action"}
               </MenuItem>
             </MenuPopup>
           </Menu>
-        </Group>
+        </ActionGroup>
       ) : importableScripts.length > 0 ? (
-        <Menu
-          highlightItemOnHover={false}
-          open={actionsMenuOpen.imports}
-          onOpenChange={(open) => setActionsMenuOpen({ scripts: false, imports: open })}
-        >
-          <MenuTrigger render={<Button size="xs" variant="outline" aria-label="Project actions" />}>
-            <PlusIcon className="size-3.5" />
-            <span className="sr-only @3xl/header-actions:not-sr-only @3xl/header-actions:ml-0.5">
-              Add action
-            </span>
-            <ChevronDownIcon className="size-3.5" />
-          </MenuTrigger>
-          <MenuPopup align="end">
-            {importMenuItems}
-            <MenuItem className={dropdownItemClassName} onClick={openAddDialog}>
-              <PlusIcon className="size-4" />
-              Add action
-            </MenuItem>
-          </MenuPopup>
-        </Menu>
+        isPanel ? (
+          <div
+            role="group"
+            aria-label="Project actions"
+            className={THREAD_DETAILS_PANEL_SPLIT_GROUP_CLASS}
+            ref={panelAnchorRef}
+          >
+            <Button
+              size="sm"
+              variant="ghost"
+              className={THREAD_DETAILS_PANEL_SPLIT_PRIMARY_CLASS}
+              aria-label="Project actions"
+              onClick={() => setActionsMenuOpen({ scripts: false, imports: true })}
+            >
+              <WrenchIcon className={THREAD_DETAILS_PANEL_ICON_CLASS} />
+              <span className="ml-0.5 min-w-0 truncate">Actions</span>
+            </Button>
+            <span aria-hidden="true" className={THREAD_DETAILS_PANEL_SPLIT_SEPARATOR_CLASS} />
+            <Menu
+              highlightItemOnHover={false}
+              open={actionsMenuOpen.imports}
+              onOpenChange={(open) => setActionsMenuOpen({ scripts: false, imports: open })}
+            >
+              <MenuTrigger
+                render={
+                  <Button
+                    size="sm"
+                    variant="ghost"
+                    className={THREAD_DETAILS_PANEL_SPLIT_SECONDARY_CLASS}
+                    aria-label="Choose project action"
+                  />
+                }
+              >
+                <ChevronDownIcon className={THREAD_DETAILS_PANEL_CHEVRON_CLASS} />
+              </MenuTrigger>
+              <MenuPopup
+                align="end"
+                anchor={panelAnchorRef}
+                className={THREAD_DETAILS_PANEL_ROW_POPUP_CLASS}
+              >
+                {importMenuItems}
+                <MenuItem className={dropdownItemClassName} onClick={openAddDialog}>
+                  <PlusIcon className="size-4" />
+                  Add action
+                </MenuItem>
+              </MenuPopup>
+            </Menu>
+          </div>
+        ) : (
+          <Menu
+            highlightItemOnHover={false}
+            open={actionsMenuOpen.imports}
+            onOpenChange={(open) => setActionsMenuOpen({ scripts: false, imports: open })}
+          >
+            <MenuTrigger
+              render={<Button size="xs" variant="outline" aria-label="Project actions" />}
+            >
+              <WrenchIcon className="size-3.5" />
+              <span className="sr-only @3xl/header-actions:not-sr-only @3xl/header-actions:ml-0.5">
+                Actions
+              </span>
+              <ChevronDownIcon className="size-3.5" />
+            </MenuTrigger>
+            <MenuPopup align="end">
+              {importMenuItems}
+              <MenuItem className={dropdownItemClassName} onClick={openAddDialog}>
+                <PlusIcon className="size-4" />
+                Add action
+              </MenuItem>
+            </MenuPopup>
+          </Menu>
+        )
       ) : (
         <Tooltip>
           <TooltipTrigger
             render={
               <Button
                 size="xs"
-                variant="outline"
-                className="w-7 px-0 sm:w-6 @3xl/header-actions:w-auto! @3xl/header-actions:px-[calc(--spacing(2)-1px)]"
-                aria-label="Add action"
+                variant={isPanel ? "ghost" : "outline"}
+                className={
+                  isPanel
+                    ? THREAD_DETAILS_PANEL_ROW_CLASS
+                    : "w-7 px-0 sm:w-6 @3xl/header-actions:w-auto! @3xl/header-actions:px-[calc(--spacing(2)-1px)]"
+                }
+                aria-label={isPanel ? "Add project script" : "Add action"}
                 // The tooltip wrapper replaces data-slot="button", so themed
                 // toolbar styling needs its own hook.
                 data-toolbar-control=""
@@ -279,11 +388,16 @@ export default function ProjectScriptsControl({
             }
           >
             <PlusIcon className="size-3.5" />
-            <span className="sr-only @3xl/header-actions:not-sr-only @3xl/header-actions:ml-0.5">
-              Add action
+            <span
+              className={cn(
+                "sr-only @3xl/header-actions:not-sr-only @3xl/header-actions:ml-0.5",
+                isPanel && "not-sr-only ml-0.5",
+              )}
+            >
+              {isPanel ? "Add project script" : "Add action"}
             </span>
           </TooltipTrigger>
-          <TooltipPopup side="top">Add action</TooltipPopup>
+          <TooltipPopup side="top">{isPanel ? "Add project script" : "Add action"}</TooltipPopup>
         </Tooltip>
       )}
 
diff --git a/apps/web/src/components/RightPanelTabs.tsx b/apps/web/src/components/RightPanelTabs.tsx
index 9d057a3d2980..6bacaac8855e 100644
--- a/apps/web/src/components/RightPanelTabs.tsx
+++ b/apps/web/src/components/RightPanelTabs.tsx
@@ -35,6 +35,7 @@ import { ScrollArea } from "~/components/ui/scroll-area";
 import { PanelTabCloseButton } from "~/components/ui/panel-tab-close-button";
 import { faviconUrlForOrigin } from "~/lib/favicon";
 import { useTheme } from "~/hooks/useTheme";
+import type { PreviewPanelInlineSize } from "~/hooks/usePreviewPanelInlineSize";
 import { COLLAPSED_SIDEBAR_TITLEBAR_INSET_CLASS } from "~/workspaceTitlebar";
 
 import { PreviewPanelShell, type PreviewPanelMode } from "./preview/PreviewPanelShell";
@@ -49,6 +50,7 @@ interface RightPanelTabsProps {
   widthStorageKey?: string;
   /** Forwarded to PreviewPanelShell as the initial width before a user resize. */
   defaultWidth?: number;
+  inlineSize?: PreviewPanelInlineSize;
   layoutControls?: ReactNode;
   surfaces: readonly RightPanelSurface[];
   activeSurfaceId: string | null;
@@ -775,6 +777,7 @@ export function RightPanelTabs(props: RightPanelTabsProps) {
       {...(props.maximized !== undefined ? { maximized: props.maximized } : {})}
       {...(props.widthStorageKey !== undefined ? { widthStorageKey: props.widthStorageKey } : {})}
       {...(props.defaultWidth !== undefined ? { defaultWidth: props.defaultWidth } : {})}
+      {...(props.inlineSize ? { inlineSize: props.inlineSize } : {})}
     >
       <div
         className={cn(
diff --git a/apps/web/src/components/Sidebar.logic.test.ts b/apps/web/src/components/Sidebar.logic.test.ts
index 9d1eb6bcd196..a4a2e5ffaa21 100644
--- a/apps/web/src/components/Sidebar.logic.test.ts
+++ b/apps/web/src/components/Sidebar.logic.test.ts
@@ -1,59 +1,58 @@
 import { afterEach, beforeEach, describe, expect, it, vi } from "vite-plus/test";
 import { defaultAnimateLayoutChanges, type AnimateLayoutChanges } from "@dnd-kit/sortable";
 import {
+  THREAD_JUMP_HINT_SHOW_DELAY_MS,
   animatePinnedLayoutChanges,
   archiveSelectedThreadEntries,
   buildBulkTitleRegenerationContextMenuItem,
   buildMultiSelectThreadContextMenuItems,
   createThreadJumpHintVisibilityController,
   filterSidebarProjectScopeItems,
+  filterSidebarV2VisibleThreads,
+  formatWorkingDurationLabel,
+  getFallbackThreadIdAfterDelete,
+  getProjectSortTimestamp,
+  getSidebarForkParentThreadId,
   getSidebarThreadIdsToPrewarm,
   getVisibleSidebarThreadIds,
-  resolveAdjacentThreadId,
-  reduceSidebarProjectScopeMenuState,
-  getFallbackThreadIdAfterDelete,
   getVisibleThreadsForProject,
-  getProjectSortTimestamp,
   hasUnseenCompletion,
   isContextMenuPointerDown,
-  isSidebarNestedLinkClick,
+  isSidebarSubagentThread,
   isTrailingDoubleClick,
   orderItemsByPreferredIds,
+  pinOrderKeyBetween,
+  planPinnedReorder,
+  reduceSidebarProjectScopeMenuState,
+  resolveAdjacentThreadId,
   resolveProjectStatusIndicator,
   resolveSidebarStageBadgeLabel,
-  resolveThreadRowClassName,
   resolveSidebarThreadStatus,
+  resolveSidebarV2TopStatus,
+  resolveThreadLastVisitedAt,
+  resolveThreadRowClassName,
   resolveThreadStatusPill,
   resolveWorkingStartedAt,
   searchSidebarThreadsByTitle,
-  formatWorkingDurationLabel,
-  shouldNavigateAfterProjectRemoval,
   shouldClearThreadSelectionOnMouseDown,
+  shouldNavigateAfterProjectRemoval,
+  shouldShowSidebarV2Duration,
   sortLogicalProjectsForSidebar,
-  sortSettledThreadsForSidebar,
-  pinOrderKeyBetween,
-  planPinnedReorder,
   sortPinnedThreadsForSidebar,
-  sortThreadsForSidebar,
   sortProjectsForSidebar,
   sortScopedProjectsForSidebar,
-  shouldCreateNewThreadInCurrentProject,
-  THREAD_JUMP_HINT_SHOW_DELAY_MS,
+  sortSettledThreadsForSidebar,
+  sortSidebarV2ProjectGroups,
+  sortThreadsForSidebar,
 } from "./Sidebar.logic";
-import {
-  EnvironmentId,
-  OrchestrationLatestTurn,
-  ProjectId,
-  ProviderInstanceId,
-  ThreadId,
-} from "@t3tools/contracts";
-
+import { EnvironmentId, ProjectId, ProviderInstanceId, RunId, ThreadId } from "@t3tools/contracts";
 import {
   DEFAULT_INTERACTION_MODE,
   DEFAULT_RUNTIME_MODE,
   type Project,
   type Thread,
 } from "../types";
+import { makeThreadFixture, type ThreadFixtureOverrides } from "../test-fixtures";
 
 const localEnvironmentId = EnvironmentId.make("environment-local");
 
@@ -274,13 +273,102 @@ describe("resolveSidebarStageBadgeLabel", () => {
   });
 });
 
-function makeLatestTurn(overrides?: {
+describe("sidebar thread lineage helpers", () => {
+  it("keeps only top-level, unarchived threads in the Sidebar V2 project scope", () => {
+    const parentId = ThreadId.make("thread-parent");
+    const projectId = ProjectId.make("project-visible");
+    const environmentId = EnvironmentId.make("environment-visible");
+    const root = makeThreadFixture({
+      id: parentId,
+      environmentId,
+      projectId,
+    });
+    const subagent = makeThreadFixture({
+      id: ThreadId.make("thread-subagent"),
+      environmentId,
+      projectId,
+      lineage: {
+        rootThreadId: parentId,
+        parentThreadId: parentId,
+        relationshipToParent: "subagent",
+      },
+    });
+    const fork = makeThreadFixture({
+      id: ThreadId.make("thread-fork"),
+      environmentId,
+      projectId,
+      lineage: {
+        rootThreadId: parentId,
+        parentThreadId: parentId,
+        relationshipToParent: "fork",
+      },
+    });
+    const archived = makeThreadFixture({
+      id: ThreadId.make("thread-archived"),
+      environmentId,
+      projectId,
+      archivedAt: "2026-01-02T00:00:00.000Z",
+    });
+    const otherProject = makeThreadFixture({
+      id: ThreadId.make("thread-other-project"),
+      environmentId,
+      projectId: ProjectId.make("project-other"),
+    });
+
+    expect(
+      filterSidebarV2VisibleThreads(
+        [root, subagent, fork, archived, otherProject],
+        new Set([`${environmentId}:${projectId}`]),
+      ).map((thread) => thread.id),
+    ).toEqual([parentId, fork.id]);
+  });
+
+  it("identifies subagent threads so the sidebar can hide them", () => {
+    const parentId = ThreadId.make("thread-parent");
+    const subagent = makeThreadFixture({
+      lineage: {
+        rootThreadId: parentId,
+        parentThreadId: parentId,
+        relationshipToParent: "subagent",
+      },
+    });
+
+    expect(isSidebarSubagentThread(subagent)).toBe(true);
+    expect(isSidebarSubagentThread(makeThreadFixture())).toBe(false);
+  });
+
+  it("resolves the parent thread for fork sidebar affordances", () => {
+    const parentId = ThreadId.make("thread-parent");
+    const fallbackParentId = ThreadId.make("thread-fallback-parent");
+    const runFork = makeThreadFixture({
+      forkedFrom: { type: "run", threadId: parentId, runId: "run-1" as never },
+      lineage: {
+        rootThreadId: parentId,
+        parentThreadId: fallbackParentId,
+        relationshipToParent: "fork",
+      },
+    });
+    const lineageFork = makeThreadFixture({
+      lineage: {
+        rootThreadId: parentId,
+        parentThreadId: fallbackParentId,
+        relationshipToParent: "fork",
+      },
+    });
+
+    expect(getSidebarForkParentThreadId(runFork)).toBe(parentId);
+    expect(getSidebarForkParentThreadId(lineageFork)).toBe(fallbackParentId);
+    expect(getSidebarForkParentThreadId(makeThreadFixture())).toBeNull();
+  });
+});
+
+function makeLatestRun(overrides?: {
   completedAt?: string | null;
   startedAt?: string | null;
-}): OrchestrationLatestTurn {
+}): NonNullable<Thread["latestRun"]> {
   return {
-    turnId: "turn-1" as never,
-    state: "completed",
+    runId: "turn-1" as never,
+    status: "completed",
     assistantMessageId: null,
     requestedAt: "2026-03-09T10:00:00.000Z",
     startedAt:
@@ -298,9 +386,9 @@ describe("hasUnseenCompletion", () => {
         hasPendingApprovals: false,
         hasPendingUserInput: false,
         interactionMode: "default",
-        latestTurn: makeLatestTurn(),
+        latestRun: makeLatestRun(),
         lastVisitedAt: "2026-03-09T10:04:00.000Z",
-        session: null,
+        runtime: null,
       }),
     ).toBe(true);
   });
@@ -312,9 +400,9 @@ describe("hasUnseenCompletion", () => {
         hasPendingApprovals: false,
         hasPendingUserInput: false,
         interactionMode: "default",
-        latestTurn: makeLatestTurn(),
+        latestRun: makeLatestRun(),
         lastVisitedAt: undefined,
-        session: null,
+        runtime: null,
       }),
     ).toBe(false);
   });
@@ -442,42 +530,6 @@ describe("isTrailingDoubleClick", () => {
   });
 });
 
-describe("isSidebarNestedLinkClick", () => {
-  const linkTarget = {
-    closest: (selector: string) => (selector === "a[href]" ? ({} as Element) : null),
-  } as unknown as EventTarget;
-
-  it("ignores row clicks that originated on a nested link", () => {
-    expect(isSidebarNestedLinkClick(linkTarget)).toBe(true);
-  });
-
-  it("walks up from a text node to the enclosing link", () => {
-    expect(isSidebarNestedLinkClick({ parentElement: linkTarget } as unknown as EventTarget)).toBe(
-      true,
-    );
-  });
-
-  it("leaves ordinary row clicks alone", () => {
-    expect(isSidebarNestedLinkClick({ closest: () => null } as unknown as EventTarget)).toBe(false);
-    expect(isSidebarNestedLinkClick(null)).toBe(false);
-  });
-});
-
-describe("shouldCreateNewThreadInCurrentProject", () => {
-  it("creates directly on shift+click in a multi-project setup", () => {
-    expect(shouldCreateNewThreadInCurrentProject(true, 2)).toBe(true);
-  });
-
-  it("opens the picker on a plain click in a multi-project setup", () => {
-    expect(shouldCreateNewThreadInCurrentProject(false, 2)).toBe(false);
-  });
-
-  it("creates directly on any click with a single project", () => {
-    expect(shouldCreateNewThreadInCurrentProject(false, 1)).toBe(true);
-    expect(shouldCreateNewThreadInCurrentProject(true, 1)).toBe(true);
-  });
-});
-
 describe("orderItemsByPreferredIds", () => {
   it("keeps preferred ids first, skips stale ids, and preserves the relative order of remaining items", () => {
     const ordered = orderItemsByPreferredIds({
@@ -696,27 +748,25 @@ describe("isContextMenuPointerDown", () => {
 });
 
 describe("resolveSidebarThreadStatus", () => {
-  const session = {
-    threadId: ThreadId.make("thread-1"),
+  const runtime = {
     status: "running" as const,
-    providerName: "Codex",
+    activeRunId: null,
     providerInstanceId: ProviderInstanceId.make("codex"),
-    runtimeMode: DEFAULT_RUNTIME_MODE,
-    activeTurnId: "turn-1" as never,
+    providerName: "Codex",
     lastError: null,
     updatedAt: "2026-03-09T10:00:00.000Z",
   };
 
-  const idle = { hasPendingApprovals: false, hasPendingUserInput: false };
+  const idle = { hasPendingApprovals: false, hasPendingUserInput: false, runtime: null };
 
-  it("prioritizes approval over a running session", () => {
-    expect(resolveSidebarThreadStatus({ ...idle, hasPendingApprovals: true, session })).toBe(
+  it("prioritizes approval over a running runtime", () => {
+    expect(resolveSidebarThreadStatus({ ...idle, hasPendingApprovals: true, runtime })).toBe(
       "approval",
     );
   });
 
-  it("prioritizes awaiting input over a running session, below approval", () => {
-    expect(resolveSidebarThreadStatus({ ...idle, hasPendingUserInput: true, session })).toBe(
+  it("prioritizes awaiting input over a running runtime, below approval", () => {
+    expect(resolveSidebarThreadStatus({ ...idle, hasPendingUserInput: true, runtime })).toBe(
       "input",
     );
     expect(
@@ -724,44 +774,55 @@ describe("resolveSidebarThreadStatus", () => {
         ...idle,
         hasPendingApprovals: true,
         hasPendingUserInput: true,
-        session,
+        runtime,
       }),
     ).toBe("approval");
   });
 
-  it("reports working for running and starting sessions", () => {
-    expect(resolveSidebarThreadStatus({ ...idle, session })).toBe("working");
+  it("reports working for running and starting runtimes", () => {
+    expect(resolveSidebarThreadStatus({ ...idle, runtime })).toBe("working");
     expect(
       resolveSidebarThreadStatus({
         ...idle,
-        session: { ...session, status: "starting" as const },
+        runtime: { ...runtime, status: "starting" as const },
       }),
     ).toBe("working");
   });
 
-  it("reports failed only while the session status is error", () => {
+  it("reports failed only while the latest run failed", () => {
     expect(
       resolveSidebarThreadStatus({
         ...idle,
-        session: { ...session, status: "error" as const, lastError: "boom" },
+        runtime: { ...runtime, status: "failed" as const, lastError: "boom" },
       }),
     ).toBe("failed");
     expect(
       resolveSidebarThreadStatus({
         ...idle,
-        session: { ...session, status: "stopped" as const, lastError: "persisted" },
+        runtime: { ...runtime, status: "completed" as const, lastError: "persisted" },
       }),
     ).toBe("ready");
     expect(
       resolveSidebarThreadStatus({
         ...idle,
-        session: { ...session, status: "ready" as const, lastError: "persisted" },
+        runtime: { ...runtime, status: "idle" as const, lastError: "persisted" },
       }),
-    ).toBe("ready");
+    ).toBe("waiting");
   });
 
-  it("defaults to ready with no session", () => {
-    expect(resolveSidebarThreadStatus({ ...idle, session: null })).toBe("ready");
+  it("defaults to ready with no runtime", () => {
+    expect(resolveSidebarThreadStatus(idle)).toBe("ready");
+  });
+
+  it("keeps a waiting runtime visible ahead of unread and woke presentation", () => {
+    expect(resolveSidebarV2TopStatus({ status: "waiting", isUnread: true, isWoke: true })).toBe(
+      "waiting",
+    );
+  });
+
+  it("keeps Waiting static while Working shows elapsed duration", () => {
+    expect(shouldShowSidebarV2Duration("waiting")).toBe(false);
+    expect(shouldShowSidebarV2Duration("working")).toBe(true);
   });
 });
 
@@ -901,148 +962,18 @@ describe("sortThreadsForSidebar", () => {
   });
 });
 
-describe("pinOrderKeyBetween", () => {
-  it("produces keys that sort between their bounds", () => {
-    const middle = pinOrderKeyBetween(null, null)!;
-    const top = pinOrderKeyBetween(null, middle)!;
-    const bottom = pinOrderKeyBetween(middle, null)!;
-    expect(top < middle).toBe(true);
-    expect(middle < bottom).toBe(true);
-
-    const between = pinOrderKeyBetween(top, middle)!;
-    expect(top < between && between < middle).toBe(true);
-  });
-
-  it("extends into new digits when bounds are adjacent", () => {
-    const key = pinOrderKeyBetween("g", "h")!;
-    expect("g" < key && key < "h").toBe(true);
-  });
-
-  it("stays strictly ordered under repeated top insertion", () => {
-    // Every new pin lands at the head of the arranged run; keys must keep
-    // sorting before the previous head without ever bottoming out.
-    let head: string | null = null;
-    const keys: string[] = [];
-    for (let i = 0; i < 100; i += 1) {
-      const key: string = pinOrderKeyBetween(null, head)!;
-      expect(key).not.toBeNull();
-      if (head !== null) expect(key < head).toBe(true);
-      keys.push(key);
-      head = key;
-    }
-    expect(new Set(keys).size).toBe(100);
-  });
-
-  it("stays strictly ordered under repeated middle insertion", () => {
-    let low = pinOrderKeyBetween(null, null)!;
-    let high = pinOrderKeyBetween(low, null)!;
-    for (let i = 0; i < 100; i += 1) {
-      const key: string = pinOrderKeyBetween(low, high)!;
-      expect(low < key && key < high).toBe(true);
-      if (i % 2 === 0) low = key;
-      else high = key;
-    }
-  });
-
-  it("returns null for corrupt or out-of-order bounds instead of throwing", () => {
-    expect(pinOrderKeyBetween("z", "a")).toBeNull();
-    expect(pinOrderKeyBetween("A!", null)).toBeNull();
-    expect(pinOrderKeyBetween(null, "ma")).toBeNull();
-    expect(pinOrderKeyBetween("m", "m")).toBeNull();
-  });
-});
-
-describe("planPinnedReorder", () => {
-  it("writes only the moved thread when neighbors are keyed", () => {
-    const assignments = planPinnedReorder({
-      orderedIds: ["a", "c", "b"],
-      keysById: new Map([
-        ["a", "f"],
-        ["b", "m"],
-        ["c", "t"],
-      ]),
-      movedId: "c",
-    });
-    expect(assignments).toHaveLength(1);
-    expect(assignments[0]!.id).toBe("c");
-    expect(assignments[0]!.orderKey > "f" && assignments[0]!.orderKey < "m").toBe(true);
-  });
-
-  it("treats list edges as open bounds", () => {
-    const assignments = planPinnedReorder({
-      orderedIds: ["b", "a"],
-      keysById: new Map([
-        ["a", "m"],
-        ["b", null],
-      ]),
-      movedId: "b",
-    });
-    expect(assignments).toHaveLength(1);
-    expect(assignments[0]!.orderKey < "m").toBe(true);
-  });
-
-  it("materializes keys for the whole section when a neighbor is keyless", () => {
-    const assignments = planPinnedReorder({
-      orderedIds: ["b", "a", "c"],
-      keysById: new Map([
-        ["a", null],
-        ["b", "m"],
-        ["c", null],
-      ]),
-      movedId: "b",
-    });
-    expect(assignments.map((entry) => entry.id)).toEqual(["b", "a", "c"]);
-    const keys = assignments.map((entry) => entry.orderKey);
-    expect([...keys].sort()).toEqual(keys);
-    expect(new Set(keys).size).toBe(keys.length);
-  });
-});
-
-describe("sortPinnedThreadsForSidebar", () => {
-  const pinnable = (input: { id: string; createdAt: string; pinOrderKey?: string | null }) => ({
-    id: input.id,
-    createdAt: input.createdAt,
-    pinOrderKey: input.pinOrderKey ?? null,
-  });
-
-  it("sorts keyed threads by key ahead of keyless threads in creation order", () => {
-    const sorted = sortPinnedThreadsForSidebar([
-      pinnable({ id: "keyless-old", createdAt: "2026-03-09T08:00:00.000Z" }),
-      pinnable({ id: "second", createdAt: "2026-03-09T09:00:00.000Z", pinOrderKey: "t" }),
-      pinnable({ id: "keyless-new", createdAt: "2026-03-09T12:00:00.000Z" }),
-      pinnable({ id: "first", createdAt: "2026-03-09T07:00:00.000Z", pinOrderKey: "g" }),
-    ]);
-
-    expect(sorted.map((thread) => thread.id)).toEqual([
-      "first",
-      "second",
-      "keyless-new",
-      "keyless-old",
-    ]);
-  });
-
-  it("breaks equal keys by id so raced writes render identically everywhere", () => {
-    const sorted = sortPinnedThreadsForSidebar([
-      pinnable({ id: "b", createdAt: "2026-03-09T10:00:00.000Z", pinOrderKey: "m" }),
-      pinnable({ id: "a", createdAt: "2026-03-09T11:00:00.000Z", pinOrderKey: "m" }),
-    ]);
-
-    expect(sorted.map((thread) => thread.id)).toEqual(["a", "b"]);
-  });
-});
-
 describe("sortSettledThreadsForSidebar", () => {
   const settled = (input: {
     id: string;
     settledAt?: string | null;
     latestUserMessageAt?: string | null;
-    latestTurn?: OrchestrationLatestTurn | null;
+    latestRun?: Thread["latestRun"];
     updatedAt?: string;
   }) => ({
     id: input.id,
     settledAt: input.settledAt ?? null,
     latestUserMessageAt: input.latestUserMessageAt ?? null,
-    latestTurn: input.latestTurn ?? null,
+    latestRun: input.latestRun ?? null,
     updatedAt: input.updatedAt ?? "2026-03-09T09:00:00.000Z",
   });
 
@@ -1082,7 +1013,7 @@ describe("sortSettledThreadsForSidebar", () => {
       settled({
         id: "completed-later",
         latestUserMessageAt: "2026-03-09T10:00:00.000Z",
-        latestTurn: makeLatestTurn({ completedAt: "2026-03-09T10:30:00.000Z" }),
+        latestRun: makeLatestRun({ completedAt: "2026-03-09T10:30:00.000Z" }),
       }),
     ]);
 
@@ -1100,40 +1031,38 @@ describe("sortSettledThreadsForSidebar", () => {
 });
 
 describe("resolveWorkingStartedAt", () => {
-  const session = {
-    threadId: ThreadId.make("thread-1"),
+  const runtime = {
     status: "running" as const,
     providerName: "Codex",
     providerInstanceId: ProviderInstanceId.make("codex"),
-    runtimeMode: DEFAULT_RUNTIME_MODE,
-    activeTurnId: "turn-1" as never,
+    activeRunId: RunId.make("run-1"),
     lastError: null,
     updatedAt: "2026-03-09T10:02:00.000Z",
   };
 
-  it("uses the running turn's start time", () => {
+  it("uses the running run's start time", () => {
     expect(
       resolveWorkingStartedAt({
-        latestTurn: makeLatestTurn({ completedAt: null }),
-        session,
+        latestRun: makeLatestRun({ completedAt: null }),
+        runtime,
       }),
     ).toBe("2026-03-09T10:00:00.000Z");
   });
 
-  it("uses the request time while a turn awaits adoption", () => {
+  it("uses the request time while a run awaits adoption", () => {
     expect(
       resolveWorkingStartedAt({
-        latestTurn: makeLatestTurn({ startedAt: null, completedAt: null }),
-        session,
+        latestRun: makeLatestRun({ startedAt: null, completedAt: null }),
+        runtime,
       }),
     ).toBe("2026-03-09T10:00:00.000Z");
   });
 
-  it("falls back to the session transition when the latest turn already completed", () => {
+  it("falls back to the runtime transition when the latest run already completed", () => {
     expect(
       resolveWorkingStartedAt({
-        latestTurn: makeLatestTurn(),
-        session,
+        latestRun: makeLatestRun(),
+        runtime,
       }),
     ).toBe("2026-03-09T10:02:00.000Z");
   });
@@ -1141,14 +1070,14 @@ describe("resolveWorkingStartedAt", () => {
   it("skips a malformed startedAt instead of returning it", () => {
     expect(
       resolveWorkingStartedAt({
-        latestTurn: makeLatestTurn({ startedAt: "not-a-date", completedAt: null }),
-        session,
+        latestRun: makeLatestRun({ startedAt: "not-a-date", completedAt: null }),
+        runtime,
       }),
     ).toBe("2026-03-09T10:00:00.000Z");
   });
 
-  it("returns null with neither a running turn nor a session", () => {
-    expect(resolveWorkingStartedAt({ latestTurn: null, session: null })).toBeNull();
+  it("returns null with neither a running run nor a runtime", () => {
+    expect(resolveWorkingStartedAt({ latestRun: null, runtime: null })).toBeNull();
   });
 });
 
@@ -1172,15 +1101,13 @@ describe("resolveThreadStatusPill", () => {
     hasPendingApprovals: false,
     hasPendingUserInput: false,
     interactionMode: "plan" as const,
-    latestTurn: null,
+    latestRun: null,
     lastVisitedAt: undefined,
-    session: {
-      threadId: ThreadId.make("thread-1"),
+    runtime: {
       status: "running" as const,
       providerName: "Codex",
       providerInstanceId: ProviderInstanceId.make("codex"),
-      runtimeMode: DEFAULT_RUNTIME_MODE,
-      activeTurnId: "turn-1" as never,
+      activeRunId: "turn-1" as never,
       lastError: null,
       updatedAt: "2026-03-09T10:00:00.000Z",
     },
@@ -1217,17 +1144,65 @@ describe("resolveThreadStatusPill", () => {
     ).toMatchObject({ label: "Working", pulse: true });
   });
 
+  it("shows waiting for an idle thread with pending background tasks", () => {
+    expect(
+      resolveThreadStatusPill({
+        thread: {
+          ...baseThread,
+          pendingBackgroundTasks: [{ taskId: "bg-1", description: "sleep 20" }],
+          runtime: {
+            ...baseThread.runtime,
+            status: "idle",
+            activeRunId: null,
+          },
+        },
+      }),
+    ).toMatchObject({
+      label: "Waiting",
+      colorClass: "text-sidebar-muted-foreground",
+      dotClass: "bg-sidebar-muted-foreground",
+      pulse: false,
+    });
+  });
+
+  it("keeps an active turn working when background tasks are also present", () => {
+    expect(
+      resolveThreadStatusPill({
+        thread: {
+          ...baseThread,
+          pendingBackgroundTasks: [{ taskId: "bg-1", description: "sleep 20" }],
+        },
+      }),
+    ).toMatchObject({ label: "Working", pulse: true });
+  });
+
+  it("does not show waiting after the background task roster clears", () => {
+    expect(
+      resolveThreadStatusPill({
+        thread: {
+          ...baseThread,
+          pendingBackgroundTasks: [],
+          runtime: {
+            ...baseThread.runtime,
+            status: "idle",
+            activeRunId: null,
+          },
+        },
+      }),
+    ).toBeNull();
+  });
+
   it("shows plan ready when a settled plan turn has a proposed plan ready for follow-up", () => {
     expect(
       resolveThreadStatusPill({
         thread: {
           ...baseThread,
           hasActionableProposedPlan: true,
-          latestTurn: makeLatestTurn(),
-          session: {
-            ...baseThread.session,
-            status: "ready",
-            activeTurnId: null,
+          latestRun: makeLatestRun(),
+          runtime: {
+            ...baseThread.runtime,
+            status: "completed",
+            activeRunId: null,
           },
         },
       }),
@@ -1239,11 +1214,11 @@ describe("resolveThreadStatusPill", () => {
       resolveThreadStatusPill({
         thread: {
           ...baseThread,
-          latestTurn: makeLatestTurn(),
-          session: {
-            ...baseThread.session,
-            status: "ready",
-            activeTurnId: null,
+          latestRun: makeLatestRun(),
+          runtime: {
+            ...baseThread.runtime,
+            status: "completed",
+            activeRunId: null,
           },
         },
       }),
@@ -1256,12 +1231,12 @@ describe("resolveThreadStatusPill", () => {
         thread: {
           ...baseThread,
           interactionMode: "default",
-          latestTurn: makeLatestTurn(),
+          latestRun: makeLatestRun(),
           lastVisitedAt: "2026-03-09T10:04:00.000Z",
-          session: {
-            ...baseThread.session,
-            status: "ready",
-            activeTurnId: null,
+          runtime: {
+            ...baseThread.runtime,
+            status: "completed",
+            activeRunId: null,
           },
         },
       }),
@@ -1339,6 +1314,38 @@ describe("resolveProjectStatusIndicator", () => {
       ]),
     ).toMatchObject({ label: "Plan Ready", dotClass: "bg-violet-500" });
   });
+
+  it("ranks waiting below active work and above plan-ready", () => {
+    const waiting = {
+      label: "Waiting" as const,
+      colorClass: "text-sidebar-muted-foreground",
+      dotClass: "bg-sidebar-muted-foreground",
+      pulse: false,
+    };
+
+    expect(
+      resolveProjectStatusIndicator([
+        waiting,
+        {
+          label: "Working",
+          colorClass: "text-sky-600",
+          dotClass: "bg-sky-500",
+          pulse: true,
+        },
+      ]),
+    ).toMatchObject({ label: "Working" });
+    expect(
+      resolveProjectStatusIndicator([
+        {
+          label: "Plan Ready",
+          colorClass: "text-violet-600",
+          dotClass: "bg-violet-500",
+          pulse: false,
+        },
+        waiting,
+      ]),
+    ).toMatchObject({ label: "Waiting" });
+  });
 });
 
 describe("getVisibleThreadsForProject", () => {
@@ -1412,8 +1419,8 @@ function makeProject(overrides: Partial<Project> = {}): Project {
   };
 }
 
-function makeThread(overrides: Partial<Thread> = {}): Thread {
-  return {
+function makeThread(overrides: ThreadFixtureOverrides = {}): Thread {
+  return makeThreadFixture({
     id: ThreadId.make("thread-1"),
     environmentId: localEnvironmentId,
     projectId: ProjectId.make("project-1"),
@@ -1425,7 +1432,7 @@ function makeThread(overrides: Partial<Thread> = {}): Thread {
     },
     runtimeMode: DEFAULT_RUNTIME_MODE,
     interactionMode: DEFAULT_INTERACTION_MODE,
-    session: null,
+    runtime: null,
     messages: [],
     proposedPlans: [],
     createdAt: "2026-03-09T10:00:00.000Z",
@@ -1434,13 +1441,11 @@ function makeThread(overrides: Partial<Thread> = {}): Thread {
     settledAt: null,
     deletedAt: null,
     updatedAt: "2026-03-09T10:00:00.000Z",
-    latestTurn: null,
+    latestRun: null,
     branch: null,
     worktreePath: null,
-    checkpoints: [],
-    activities: [],
     ...overrides,
-  };
+  });
 }
 
 describe("getFallbackThreadIdAfterDelete", () => {
@@ -1524,7 +1529,7 @@ describe("sortProjectsForSidebar", () => {
             id: "message-1" as never,
             role: "user",
             text: "older project user message",
-            turnId: null,
+            runId: null,
             createdAt: "2026-03-09T10:01:00.000Z",
             updatedAt: "2026-03-09T10:01:00.000Z",
             streaming: false,
@@ -1540,7 +1545,7 @@ describe("sortProjectsForSidebar", () => {
             id: "message-2" as never,
             role: "user",
             text: "newer project user message",
-            turnId: null,
+            runId: null,
             createdAt: "2026-03-09T10:05:00.000Z",
             updatedAt: "2026-03-09T10:05:00.000Z",
             streaming: false,
@@ -1775,3 +1780,205 @@ describe("sortLogicalProjectsForSidebar", () => {
     ).toEqual(["logical-newer", "logical-older"]);
   });
 });
+
+describe("sortSidebarV2ProjectGroups", () => {
+  it("does not let a hidden subagent thread reorder projects", () => {
+    const olderProjectId = ProjectId.make("project-older");
+    const newerProjectId = ProjectId.make("project-newer");
+    const olderRootThreadId = ThreadId.make("thread-older-root");
+    const projects = [
+      {
+        ...makeProject({ id: olderProjectId, title: "A older project" }),
+        projectKey: "logical-older",
+        memberProjectRefs: [{ environmentId: localEnvironmentId, projectId: olderProjectId }],
+      },
+      {
+        ...makeProject({ id: newerProjectId, title: "Z newer project" }),
+        projectKey: "logical-newer",
+        memberProjectRefs: [{ environmentId: localEnvironmentId, projectId: newerProjectId }],
+      },
+    ];
+    const threads = [
+      makeThread({
+        id: olderRootThreadId,
+        projectId: olderProjectId,
+        updatedAt: "2026-03-09T10:01:00.000Z",
+      }),
+      makeThread({
+        id: ThreadId.make("thread-newer-root"),
+        projectId: newerProjectId,
+        updatedAt: "2026-03-09T10:05:00.000Z",
+      }),
+      makeThread({
+        id: ThreadId.make("thread-hidden-subagent"),
+        projectId: olderProjectId,
+        updatedAt: "2026-03-09T10:10:00.000Z",
+        lineage: {
+          rootThreadId: olderRootThreadId,
+          parentThreadId: olderRootThreadId,
+          relationshipToParent: "subagent",
+        },
+      }),
+    ];
+
+    expect(
+      sortSidebarV2ProjectGroups(projects, threads, "updated_at").map(
+        (project) => project.projectKey,
+      ),
+    ).toEqual(["logical-newer", "logical-older"]);
+  });
+});
+
+describe("resolveThreadLastVisitedAt", () => {
+  it("uses the local watermark when the server does not track visits", () => {
+    expect(resolveThreadLastVisitedAt(undefined, "2026-07-30T10:00:00.000Z")).toBe(
+      "2026-07-30T10:00:00.000Z",
+    );
+    expect(resolveThreadLastVisitedAt(undefined, undefined)).toBeUndefined();
+  });
+
+  it("keeps the server watermark authoritative when visited tracking exists", () => {
+    // A rewound server value (mark-unread) must win even over a newer local
+    // watermark left behind by earlier viewing on this device.
+    expect(resolveThreadLastVisitedAt("2026-07-30T10:00:00.000Z", "2026-07-30T10:00:05.000Z")).toBe(
+      "2026-07-30T10:00:00.000Z",
+    );
+    expect(resolveThreadLastVisitedAt("2026-07-30T10:00:00.000Z", undefined)).toBe(
+      "2026-07-30T10:00:00.000Z",
+    );
+  });
+
+  it("treats an explicit server-side null as never visited", () => {
+    expect(resolveThreadLastVisitedAt(null, "2026-07-30T10:00:00.000Z")).toBeUndefined();
+  });
+});
+
+describe("pinOrderKeyBetween", () => {
+  it("produces keys that sort between their bounds", () => {
+    const middle = pinOrderKeyBetween(null, null)!;
+    const top = pinOrderKeyBetween(null, middle)!;
+    const bottom = pinOrderKeyBetween(middle, null)!;
+    expect(top < middle).toBe(true);
+    expect(middle < bottom).toBe(true);
+
+    const between = pinOrderKeyBetween(top, middle)!;
+    expect(top < between && between < middle).toBe(true);
+  });
+
+  it("extends into new digits when bounds are adjacent", () => {
+    const key = pinOrderKeyBetween("g", "h")!;
+    expect("g" < key && key < "h").toBe(true);
+  });
+
+  it("stays strictly ordered under repeated top insertion", () => {
+    // Every new pin lands at the head of the arranged run; keys must keep
+    // sorting before the previous head without ever bottoming out.
+    let head: string | null = null;
+    const keys: string[] = [];
+    for (let i = 0; i < 100; i += 1) {
+      const key: string = pinOrderKeyBetween(null, head)!;
+      expect(key).not.toBeNull();
+      if (head !== null) expect(key < head).toBe(true);
+      keys.push(key);
+      head = key;
+    }
+    expect(new Set(keys).size).toBe(100);
+  });
+
+  it("stays strictly ordered under repeated middle insertion", () => {
+    let low = pinOrderKeyBetween(null, null)!;
+    let high = pinOrderKeyBetween(low, null)!;
+    for (let i = 0; i < 100; i += 1) {
+      const key: string = pinOrderKeyBetween(low, high)!;
+      expect(low < key && key < high).toBe(true);
+      if (i % 2 === 0) low = key;
+      else high = key;
+    }
+  });
+
+  it("returns null for corrupt or out-of-order bounds instead of throwing", () => {
+    expect(pinOrderKeyBetween("z", "a")).toBeNull();
+    expect(pinOrderKeyBetween("A!", null)).toBeNull();
+    expect(pinOrderKeyBetween(null, "ma")).toBeNull();
+    expect(pinOrderKeyBetween("m", "m")).toBeNull();
+  });
+});
+
+describe("planPinnedReorder", () => {
+  it("writes only the moved thread when neighbors are keyed", () => {
+    const assignments = planPinnedReorder({
+      orderedIds: ["a", "c", "b"],
+      keysById: new Map([
+        ["a", "f"],
+        ["b", "m"],
+        ["c", "t"],
+      ]),
+      movedId: "c",
+    });
+    expect(assignments).toHaveLength(1);
+    expect(assignments[0]!.id).toBe("c");
+    expect(assignments[0]!.orderKey > "f" && assignments[0]!.orderKey < "m").toBe(true);
+  });
+
+  it("treats list edges as open bounds", () => {
+    const assignments = planPinnedReorder({
+      orderedIds: ["b", "a"],
+      keysById: new Map([
+        ["a", "m"],
+        ["b", null],
+      ]),
+      movedId: "b",
+    });
+    expect(assignments).toHaveLength(1);
+    expect(assignments[0]!.orderKey < "m").toBe(true);
+  });
+
+  it("materializes keys for the whole section when a neighbor is keyless", () => {
+    const assignments = planPinnedReorder({
+      orderedIds: ["b", "a", "c"],
+      keysById: new Map([
+        ["a", null],
+        ["b", "m"],
+        ["c", null],
+      ]),
+      movedId: "b",
+    });
+    expect(assignments.map((entry) => entry.id)).toEqual(["b", "a", "c"]);
+    const keys = assignments.map((entry) => entry.orderKey);
+    expect([...keys].sort()).toEqual(keys);
+    expect(new Set(keys).size).toBe(keys.length);
+  });
+});
+
+describe("sortPinnedThreadsForSidebar", () => {
+  const pinnable = (input: { id: string; createdAt: string; pinOrderKey?: string | null }) => ({
+    id: input.id,
+    createdAt: input.createdAt,
+    pinOrderKey: input.pinOrderKey ?? null,
+  });
+
+  it("sorts keyed threads by key ahead of keyless threads in creation order", () => {
+    const sorted = sortPinnedThreadsForSidebar([
+      pinnable({ id: "keyless-old", createdAt: "2026-03-09T08:00:00.000Z" }),
+      pinnable({ id: "second", createdAt: "2026-03-09T09:00:00.000Z", pinOrderKey: "t" }),
+      pinnable({ id: "keyless-new", createdAt: "2026-03-09T12:00:00.000Z" }),
+      pinnable({ id: "first", createdAt: "2026-03-09T07:00:00.000Z", pinOrderKey: "g" }),
+    ]);
+
+    expect(sorted.map((thread) => thread.id)).toEqual([
+      "first",
+      "second",
+      "keyless-new",
+      "keyless-old",
+    ]);
+  });
+
+  it("breaks equal keys by id so raced writes render identically everywhere", () => {
+    const sorted = sortPinnedThreadsForSidebar([
+      pinnable({ id: "b", createdAt: "2026-03-09T10:00:00.000Z", pinOrderKey: "m" }),
+      pinnable({ id: "a", createdAt: "2026-03-09T11:00:00.000Z", pinOrderKey: "m" }),
+    ]);
+
+    expect(sorted.map((thread) => thread.id)).toEqual(["a", "b"]);
+  });
+});
diff --git a/apps/web/src/components/Sidebar.logic.ts b/apps/web/src/components/Sidebar.logic.ts
index 7e42a8f8e638..ffc7d6dc44a9 100644
--- a/apps/web/src/components/Sidebar.logic.ts
+++ b/apps/web/src/components/Sidebar.logic.ts
@@ -12,7 +12,7 @@ import {
 import type { SidebarThreadSummary, Thread } from "../types";
 import type { ThreadRouteTarget } from "../threadRoutes";
 import { cn } from "../lib/utils";
-import { isLatestTurnSettled } from "../session-logic";
+import { isLatestRunSettled } from "../session-logic";
 import { resolveServerBackedAppStageLabel } from "../branding.logic";
 
 export const THREAD_SELECTION_SAFE_SELECTOR = "[data-thread-item], [data-thread-selection-safe]";
@@ -77,9 +77,7 @@ export async function archiveSelectedThreadEntries<
     const result = await input.archive(entry, () => {
       didArchive = true;
     });
-    if (didArchive || result._tag === "Success") {
-      archivedThreadKeys.push(entry.threadKey);
-    }
+    if (didArchive || result._tag === "Success") archivedThreadKeys.push(entry.threadKey);
     if (result._tag === "Success") continue;
     const failure = result as Extract<TResult, { readonly _tag: "Failure" }>;
     if (didArchive) {
@@ -107,6 +105,36 @@ export function buildMultiSelectThreadContextMenuItems(input: {
   ];
 }
 
+export function isSidebarSubagentThread(thread: Pick<SidebarThreadSummary, "lineage">): boolean {
+  return thread.lineage.relationshipToParent === "subagent";
+}
+
+export function filterSidebarV2VisibleThreads<
+  T extends Pick<SidebarThreadSummary, "archivedAt" | "lineage"> & {
+    environmentId: string;
+    projectId: string;
+  },
+>(threads: readonly T[], scopedProjectKeys: ReadonlySet<string> | null): T[] {
+  return threads.filter(
+    (thread) =>
+      thread.archivedAt === null &&
+      !isSidebarSubagentThread(thread) &&
+      (scopedProjectKeys === null ||
+        scopedProjectKeys.has(`${thread.environmentId}:${thread.projectId}`)),
+  );
+}
+
+export function getSidebarForkParentThreadId(
+  thread: Pick<SidebarThreadSummary, "forkedFrom" | "lineage">,
+) {
+  if (thread.lineage.relationshipToParent !== "fork") {
+    return null;
+  }
+  return thread.forkedFrom?.type === "run"
+    ? thread.forkedFrom.threadId
+    : thread.lineage.parentThreadId;
+}
+
 export function buildBulkTitleRegenerationContextMenuItem(input: {
   supportedCount: number;
   actionableCount: number;
@@ -128,27 +156,24 @@ export function buildBulkTitleRegenerationContextMenuItem(input: {
 export interface ThreadStatusPill {
   label:
     | "Working"
-    | "Monitoring"
     | "Connecting"
     | "Completed"
     | "Pending Approval"
     | "Awaiting Input"
+    | "Waiting"
     | "Plan Ready";
   colorClass: string;
   dotClass: string;
   pulse: boolean;
 }
 
-// Rollup order mirrors the per-thread resolver exactly: attention states,
-// then active work, then the actionable plan prompt, then passive
-// monitoring. A Monitoring sibling must never hide a Plan Ready thread.
 const THREAD_STATUS_PRIORITY: Record<ThreadStatusPill["label"], number> = {
-  "Pending Approval": 6,
-  "Awaiting Input": 5,
-  Working: 4,
-  Connecting: 4,
-  "Plan Ready": 3,
-  Monitoring: 2,
+  "Pending Approval": 5,
+  "Awaiting Input": 4,
+  Working: 3,
+  Connecting: 3,
+  Waiting: 2.5,
+  "Plan Ready": 2,
   Completed: 1,
 };
 
@@ -158,11 +183,11 @@ type ThreadStatusInput = Pick<
   | "hasPendingApprovals"
   | "hasPendingUserInput"
   | "interactionMode"
-  | "latestTurn"
-  | "session"
-  | "backgroundLiveness"
+  | "latestRun"
+  | "runtime"
 > & {
-  lastVisitedAt?: string | undefined;
+  lastVisitedAt?: string | null | undefined;
+  pendingBackgroundTasks?: SidebarThreadSummary["pendingBackgroundTasks"] | undefined;
 };
 
 export interface ThreadJumpHintVisibilityController {
@@ -257,9 +282,27 @@ export function useThreadJumpHintVisibility(): {
   };
 }
 
+/**
+ * Effective visited watermark for a thread. Servers with visited tracking
+ * project `lastVisitedAt` on the shell and are authoritative — that value is
+ * shared across every device connected to the environment. Pre-tracking
+ * servers omit the field, and the browser's locally persisted watermark keeps
+ * working as before.
+ */
+export function resolveThreadLastVisitedAt(
+  serverLastVisitedAt: string | null | undefined,
+  localLastVisitedAt: string | undefined,
+): string | undefined {
+  // When the server tracks visits it is authoritative — including explicit
+  // rewinds from mark-unread, which a newer browser-local watermark must not
+  // mask. The local value only carries servers without visited tracking.
+  if (serverLastVisitedAt === undefined) return localLastVisitedAt;
+  return serverLastVisitedAt ?? undefined;
+}
+
 export function hasUnseenCompletion(thread: ThreadStatusInput): boolean {
-  if (!thread.latestTurn?.completedAt) return false;
-  const completedAt = Date.parse(thread.latestTurn.completedAt);
+  if (!thread.latestRun?.completedAt) return false;
+  const completedAt = Date.parse(thread.latestRun.completedAt);
   if (Number.isNaN(completedAt)) return false;
   if (!thread.lastVisitedAt) return false;
 
@@ -460,24 +503,21 @@ export function resolveThreadRowClassName(input: {
   );
 }
 
-// ── Sidebar thread status model ─────────────────────────────────────
-// Five visual states, three colors: color is reserved for "act now"
+// ── Sidebar v2 status model ─────────────────────────────────────────
+// Six visual states, three colors: color is reserved for "act now"
 // (approval), "in motion" (working), and "broken" (failed). Ready is the
 // unlabeled resting state — the agent stopped and is waiting on the user,
-// whether it finished, asked a question, or proposed a plan.
+// whether it finished, asked a question, or proposed a plan. Waiting
+// (runtime status "idle") is the agent stopped with background tasks still
+// open: not the user's turn yet, so it renders grey like working, not as a
+// false Done.
 // Unread completion is tracked separately: it describes whether a ready
 // thread needs attention, not what the thread is currently doing.
-export type SidebarThreadStatus =
-  | "approval"
-  | "input"
-  | "working"
-  | "monitoring"
-  | "failed"
-  | "ready";
+export type SidebarThreadStatus = "approval" | "input" | "working" | "waiting" | "failed" | "ready";
 
 type SidebarThreadStatusInput = Pick<
   SidebarThreadSummary,
-  "hasPendingApprovals" | "hasPendingUserInput" | "session" | "backgroundLiveness"
+  "hasPendingApprovals" | "hasPendingUserInput" | "runtime"
 >;
 
 export function resolveSidebarThreadStatus(thread: SidebarThreadStatusInput): SidebarThreadStatus {
@@ -487,23 +527,58 @@ export function resolveSidebarThreadStatus(thread: SidebarThreadStatusInput): Si
   if (thread.hasPendingUserInput) {
     return "input";
   }
-  if (thread.session?.status === "running" || thread.session?.status === "starting") {
+  if (
+    thread.runtime !== null &&
+    ["preparing", "queued", "starting", "running", "waiting"].includes(thread.runtime.status)
+  ) {
     return "working";
   }
-  // A failed session outranks lingering background liveness: the user must
-  // see the failure, not a stale Working (review finding).
-  if (thread.session?.status === "error") {
+  if (thread.runtime?.status === "idle") {
+    return "waiting";
+  }
+  if (thread.runtime?.status === "failed") {
     return "failed";
   }
-  // Background work outlives the turn: fleets read as working; monitoring
-  // only when watch loops are the sole live work.
-  if (thread.backgroundLiveness === "working") {
+  return "ready";
+}
+
+export type SidebarV2TopStatusKind =
+  | "approval"
+  | "done"
+  | "failed"
+  | "input"
+  | "waiting"
+  | "woke"
+  | "working";
+
+export function resolveSidebarV2TopStatus(input: {
+  readonly status: SidebarThreadStatus;
+  readonly isUnread: boolean;
+  readonly isWoke: boolean;
+}): SidebarV2TopStatusKind | null {
+  if (input.status === "working") {
     return "working";
   }
-  if (thread.backgroundLiveness === "monitoring") {
-    return "monitoring";
+  if (input.status === "waiting") {
+    return "waiting";
   }
-  return "ready";
+  if (input.status === "approval") {
+    return "approval";
+  }
+  if (input.status === "input") {
+    return "input";
+  }
+  if (input.status === "failed") {
+    return "failed";
+  }
+  if (input.isWoke) {
+    return "woke";
+  }
+  return input.isUnread ? "done" : null;
+}
+
+export function shouldShowSidebarV2Duration(status: SidebarThreadStatus): boolean {
+  return status === "working";
 }
 
 /** NaN-safe Date.parse for sort comparators: a malformed timestamp must not
@@ -623,13 +698,13 @@ export function reduceSidebarProjectScopeMenuState(
 
 type SettledTimestampInput = Pick<
   SidebarThreadSummary,
-  "settledAt" | "latestUserMessageAt" | "latestTurn" | "updatedAt"
+  "settledAt" | "latestUserMessageAt" | "latestRun" | "updatedAt"
 >;
 
 /** The timestamp a settled row sorts and labels by: settledAt when stamped
     (explicit settles), otherwise last activity — the same candidates
     threadLastActivityAt feeds the auto-settle window (user message plus all
-    latestTurn stamps), so a thread whose last activity was a turn completion
+    latestRun stamps), so a thread whose last activity was a run completion
     doesn't sort by an older message time. updatedAt is the final net. */
 export function resolveSettledTimestamp(thread: SettledTimestampInput): string | null {
   const settledAt = firstValidTimestamp(thread.settledAt);
@@ -638,9 +713,9 @@ export function resolveSettledTimestamp(thread: SettledTimestampInput): string |
   let latestMs = Number.NEGATIVE_INFINITY;
   for (const candidate of [
     thread.latestUserMessageAt,
-    thread.latestTurn?.requestedAt,
-    thread.latestTurn?.startedAt,
-    thread.latestTurn?.completedAt,
+    thread.latestRun?.requestedAt,
+    thread.latestRun?.startedAt,
+    thread.latestRun?.completedAt,
   ]) {
     if (candidate == null) continue;
     const parsed = Date.parse(candidate);
@@ -671,13 +746,13 @@ export function sortSettledThreadsForSidebar<
     last transition when the turn projection lags behind. Malformed
     timestamps fall through to the next candidate, not just missing ones. */
 export function resolveWorkingStartedAt(
-  thread: Pick<SidebarThreadSummary, "latestTurn" | "session">,
+  thread: Pick<SidebarThreadSummary, "latestRun" | "runtime">,
 ): string | null {
-  const turn = thread.latestTurn;
-  if (turn && turn.completedAt === null) {
-    return firstValidTimestamp(turn.startedAt, turn.requestedAt, thread.session?.updatedAt);
+  const run = thread.latestRun;
+  if (run && run.completedAt === null) {
+    return firstValidTimestamp(run.startedAt, run.requestedAt, thread.runtime?.updatedAt);
   }
-  return firstValidTimestamp(thread.session?.updatedAt);
+  return firstValidTimestamp(thread.runtime?.updatedAt);
 }
 
 export function formatWorkingDurationLabel(elapsedMs: number): string {
@@ -711,7 +786,7 @@ export function resolveThreadStatusPill(input: {
     };
   }
 
-  if (thread.session?.status === "running") {
+  if (thread.runtime?.status === "running" || thread.runtime?.status === "waiting") {
     return {
       label: "Working",
       colorClass: "text-sky-600 dark:text-sky-300/80",
@@ -720,7 +795,11 @@ export function resolveThreadStatusPill(input: {
     };
   }
 
-  if (thread.session?.status === "starting") {
+  if (
+    thread.runtime?.status === "preparing" ||
+    thread.runtime?.status === "starting" ||
+    thread.runtime?.status === "queued"
+  ) {
     return {
       label: "Connecting",
       colorClass: "text-sky-600 dark:text-sky-300/80",
@@ -729,12 +808,19 @@ export function resolveThreadStatusPill(input: {
     };
   }
 
-  // An actionable plan prompt outranks lingering background work: it needs
-  // the user's decision, while liveness merely reports (review finding).
+  if ((thread.pendingBackgroundTasks?.length ?? 0) > 0) {
+    return {
+      label: "Waiting",
+      colorClass: "text-sidebar-muted-foreground",
+      dotClass: "bg-sidebar-muted-foreground",
+      pulse: false,
+    };
+  }
+
   const hasPlanReadyPrompt =
     !thread.hasPendingUserInput &&
     thread.interactionMode === "plan" &&
-    isLatestTurnSettled(thread.latestTurn, thread.session) &&
+    isLatestRunSettled(thread.latestRun, thread.runtime) &&
     thread.hasActionableProposedPlan;
   if (hasPlanReadyPrompt) {
     return {
@@ -745,28 +831,6 @@ export function resolveThreadStatusPill(input: {
     };
   }
 
-  // The turn can settle while native background work runs on. Subagent and
-  // workflow fleets read as plain Working; Monitoring is reserved for watch
-  // loops (a parent agent babysitting a PR, tailing checks) with no other
-  // live work. Same recede treatment as Working per inbox-zero.
-  if (thread.backgroundLiveness === "working") {
-    return {
-      label: "Working",
-      colorClass: "text-sky-600 dark:text-sky-300/80",
-      dotClass: "bg-sky-500 dark:bg-sky-300/80",
-      pulse: true,
-    };
-  }
-
-  if (thread.backgroundLiveness === "monitoring") {
-    return {
-      label: "Monitoring",
-      colorClass: "text-sky-600 dark:text-sky-300/80",
-      dotClass: "bg-sky-500 dark:bg-sky-300/80",
-      pulse: false,
-    };
-  }
-
   if (hasUnseenCompletion(thread)) {
     return {
       label: "Completed",
@@ -969,6 +1033,21 @@ export function sortLogicalProjectsForSidebar<
   );
 }
 
+export function sortSidebarV2ProjectGroups<
+  TProject extends LogicalSidebarProject,
+  TThread extends ScopedSidebarThread & Pick<SidebarThreadSummary, "lineage">,
+>(
+  projects: readonly TProject[],
+  threads: readonly TThread[],
+  sortOrder: SidebarProjectSortOrder,
+): TProject[] {
+  return sortLogicalProjectsForSidebar(
+    projects,
+    filterSidebarV2VisibleThreads(threads, null),
+    sortOrder,
+  );
+}
+
 /**
  * Sorts the cross-environment project collection used by landing surfaces.
  * Project ids are only unique within an environment, and archived threads
diff --git a/apps/web/src/components/Sidebar.tsx b/apps/web/src/components/Sidebar.tsx
index a5df7bc53538..40302cffb791 100644
--- a/apps/web/src/components/Sidebar.tsx
+++ b/apps/web/src/components/Sidebar.tsx
@@ -84,13 +84,11 @@ import {
   threadTraversalDirectionFromCommand,
 } from "../keybindings";
 import { useShortcutModifierState } from "../shortcutModifierState";
-import { useTerminalFocus } from "../hooks/useTerminalFocus";
 import { isTerminalFocused } from "../lib/terminalFocus";
 import { isModelPickerOpen } from "../modelPickerVisibility";
 import { selectThreadTerminalUiState, useTerminalUiStateStore } from "../terminalUiStateStore";
 import { isMacPlatform } from "~/lib/utils";
 import { useOpenPrLink } from "../lib/openPullRequestLink";
-import { releaseComposerDraftUploads } from "../lib/composerDraftUploads";
 import { readLocalApi } from "../localApi";
 import { getProjectOrderKey, selectProjectGroupingSettings } from "../logicalProject";
 import {
@@ -124,7 +122,7 @@ import type { SidebarThreadSummary } from "../types";
 import { cn } from "~/lib/utils";
 import { buildThreadActionMenuItems } from "./threadActionMenu.logic";
 import {
-  animatePinnedLayoutChanges,
+  filterSidebarV2VisibleThreads,
   buildBulkTitleRegenerationContextMenuItem,
   filterSidebarProjectScopeItems,
   formatWorkingDurationLabel,
@@ -145,7 +143,6 @@ import {
   sortPinnedThreadsForSidebar,
   sortSettledThreadsForSidebar,
   sortThreadsForSidebar,
-  useThreadJumpHintVisibility,
 } from "./Sidebar.logic";
 import { resolveLocalCheckoutBranchMismatch } from "./BranchToolbar.logic";
 import {
@@ -160,7 +157,6 @@ import {
   threadChangeRequestSnapshotsAtom,
   type ThreadChangeRequestSnapshot,
   type TerminalStatusIndicator,
-  useLinkedThreadPullRequest,
 } from "./ThreadStatusIndicators";
 import {
   resolveSnoozePresets,
@@ -172,10 +168,11 @@ import { ProjectFavicon } from "./ProjectFavicon";
 import { ProviderInstanceIcon } from "./chat/ProviderInstanceIcon";
 import { getTriggerDisplayModelLabel } from "./chat/providerIconUtils";
 import {
-  deriveProviderEntriesByEnvironment,
+  deriveProviderInstanceEntries,
   shouldShowInstanceBadge,
   type ProviderInstanceEntry,
 } from "../providerInstances";
+import { primaryServerProvidersAtom } from "../state/server";
 import { useThreadRunningTerminalIds } from "../state/terminalSessions";
 import { stackedThreadToast, toastManager } from "./ui/toast";
 import { Button } from "./ui/button";
@@ -262,8 +259,6 @@ function WorkingDuration(props: { startedAt: string | null }) {
   );
 }
 
-const EMPTY_PROVIDER_ENTRIES: ReadonlyMap<string, ProviderInstanceEntry> = new Map();
-
 function terminalProcessLabel(count: number): string {
   return `${count} terminal ${count === 1 ? "process" : "processes"} running`;
 }
@@ -348,7 +343,7 @@ function SidebarThreadTooltip({
               <ProviderInstanceIcon
                 driverKind={driverKind}
                 displayName={
-                  providerEntry?.displayName ?? thread.session?.providerName ?? modelInstanceId
+                  providerEntry?.displayName ?? thread.runtime?.providerName ?? modelInstanceId
                 }
                 accentColor={providerEntry?.accentColor}
                 // Initials would swallow a size-3 glyph: accent dot, name in label.
@@ -375,7 +370,7 @@ function SidebarThreadTooltip({
               </div>
             </div>
           ) : null}
-          {thread.session?.lastError ? (
+          {thread.runtime?.lastError ? (
             <div className="flex min-w-0 items-center gap-2 text-red-600 dark:text-red-400">
               <CircleAlertIcon className="size-3 shrink-0 stroke-current" />
               <div className="min-w-0 truncate">Error occurred</div>
@@ -466,7 +461,6 @@ function SortablePinnedThreadRow(props: {
 }) {
   const { listeners, setNodeRef, transform, transition, isDragging } = useSortable({
     id: props.id,
-    animateLayoutChanges: animatePinnedLayoutChanges,
   });
   return props.children({ listeners, setNodeRef, transform, transition, isDragging });
 }
@@ -670,7 +664,6 @@ const SidebarDraftBlock = memo(function SidebarDraftBlock(props: {
       // The /draft/$draftId route redirects home on its own when the draft
       // it renders disappears, so discarding the open draft needs no
       // special-casing here.
-      releaseComposerDraftUploads(draftId);
       clearDraftThread(draftId);
     },
     [clearDraftThread],
@@ -718,8 +711,13 @@ const SidebarThreadRow = memo(function SidebarThreadRow(props: {
   autoSettleOnMerge: boolean;
   // Same contract for thread.snooze/unsnooze.
   snoozeSupported: boolean;
-  // Pinned threads show the same pin marker in active, settled, and snoozed
-  // rows. The marker can unpin the thread when the server supports pinning.
+  // Renders the pin glyph. Pinned cards keep the full settle/snooze quick
+  // actions: settling clears the pin server-side, and snoozing hides the
+  // card until wake with the pin intact underneath. The glyph is also the
+  // in-row pin state cue (the pinned block has no header), so it always
+  // shows while pinned; it only becomes a clickable unpin quick-action once
+  // the pinning capability is confirmed, and stays a passive marker while
+  // the descriptor is not loaded. Pinning itself lives in the context menu.
   pinningSupported: boolean;
   isPinned: boolean;
   // Present only on pinned cards whose server supports reordering: dnd-kit
@@ -802,10 +800,6 @@ const SidebarThreadRow = memo(function SidebarThreadRow(props: {
   const terminalProcessCount = runningTerminalIds.length;
 
   const gitCwd = thread.worktreePath ?? props.projectCwd;
-  const linkedPullRequestStatus = useLinkedThreadPullRequest(
-    thread.environmentId,
-    thread.linkedPullRequest,
-  );
   const gitStatus = useEnvironmentQuery(
     (thread.branch != null || thread.worktreePath !== null) && gitCwd !== null
       ? vcsEnvironment.status({
@@ -820,9 +814,8 @@ const SidebarThreadRow = memo(function SidebarThreadRow(props: {
     gitStatus: gitStatus.data,
     snapshot: changeRequestSnapshot,
     retainTerminalOnBranchMismatch,
-    linkedPullRequest: thread.linkedPullRequest,
-    linkedPullRequestStatus,
   });
+  const prState = pr?.state ?? null;
 
   // Same semantics as the legacy sidebar (never-visited counts as read):
   // switching sidebars must not light up every historical thread as unread.
@@ -851,8 +844,7 @@ const SidebarThreadRow = memo(function SidebarThreadRow(props: {
   // findable. In-flight rows recede the same as read-ready ones (inbox-zero:
   // working threads aren't your problem yet) — only the colored status label
   // stands out.
-  const isInFlight =
-    status === "working" || status === "monitoring" || status === "approval" || status === "input";
+  const isInFlight = status === "working" || status === "approval" || status === "input";
   const shouldRecede =
     (status === "ready" || isInFlight) && !isUnread && !isWoke && !props.isActive && !isSelected;
   // Status hues follow the system-wide convention set by sidebar v1 and the
@@ -870,13 +862,13 @@ const SidebarThreadRow = memo(function SidebarThreadRow(props: {
           // the label at full strength.
           className: cn("text-sky-600 dark:text-sky-400", !props.isActive && "opacity-75"),
         }
-      : status === "monitoring"
+      : status === "waiting"
         ? {
-            // Monitoring is calm background presence, not active progress
-            // (monitoring-pill D6), so it keeps the label at full strength.
-            label: "Monitoring",
+            // Waiting is calm background presence (post-settle background
+            // roster), not active progress, so the label keeps full strength.
+            label: "Waiting",
             icon: null,
-            className: "text-sky-600 dark:text-sky-400",
+            className: "text-muted-foreground",
           }
         : status === "approval"
           ? {
@@ -922,8 +914,6 @@ const SidebarThreadRow = memo(function SidebarThreadRow(props: {
     gitStatus: gitStatus.data,
     snapshot: changeRequestSnapshot,
     retainTerminalOnBranchMismatch,
-    linkedPullRequest: thread.linkedPullRequest,
-    linkedPullRequestStatus,
   });
   const prStatus = prStatusIndicator(pr, prProvider);
   const settledPrHoverClass = pr ? settledPrHoverColorClass(pr.state) : undefined;
@@ -933,23 +923,19 @@ const SidebarThreadRow = memo(function SidebarThreadRow(props: {
       gitStatus: gitStatus.data,
       snapshot: changeRequestSnapshot,
       retainTerminalOnBranchMismatch,
-      linkedPullRequest: thread.linkedPullRequest,
-      linkedPullRequestStatus,
     });
     if (nextSnapshot === undefined) return;
     onChangeRequestSnapshot(threadKey, nextSnapshot);
   }, [
     changeRequestSnapshot,
     gitStatus.data,
-    linkedPullRequestStatus,
     onChangeRequestSnapshot,
     retainTerminalOnBranchMismatch,
     thread.branch,
-    thread.linkedPullRequest,
     threadKey,
   ]);
 
-  const modelInstanceId = thread.session?.providerInstanceId ?? thread.modelSelection.instanceId;
+  const modelInstanceId = thread.runtime?.providerInstanceId ?? thread.modelSelection.instanceId;
   const providerEntry = props.providerEntryByInstanceId.get(modelInstanceId) ?? null;
   const driverKind = providerEntry?.driverKind ?? null;
   const showInstanceBadge =
@@ -1216,31 +1202,6 @@ const SidebarThreadRow = memo(function SidebarThreadRow(props: {
       <TerminalIcon className={cn("size-3.5", terminalStatus.pulse && "animate-status-pulse")} />
     </span>
   ) : null;
-  const pinIndicator = props.isPinned ? (
-    props.pinningSupported ? (
-      <Tooltip>
-        <TooltipTrigger
-          render={
-            <button
-              type="button"
-              aria-label="Unpin thread"
-              onClick={handleUnpinClick}
-              className="inline-flex cursor-pointer items-center rounded-sm text-muted-foreground/65 outline-none transition-colors hover:text-foreground focus-visible:ring-2 focus-visible:ring-ring"
-            />
-          }
-        >
-          <PinIcon aria-hidden className="size-3 shrink-0" />
-        </TooltipTrigger>
-        <TooltipPopup>Unpin thread</TooltipPopup>
-      </Tooltip>
-    ) : (
-      <PinIcon
-        aria-label="Pinned"
-        role="img"
-        className="size-3 shrink-0 text-muted-foreground/65"
-      />
-    )
-  ) : null;
 
   if (variant === "slim") {
     return (
@@ -1282,7 +1243,6 @@ const SidebarThreadRow = memo(function SidebarThreadRow(props: {
               />
             </span>
             {title}
-            {pinIndicator}
             {terminalStatusIcon}
             {isRegeneratingTitle ? (
               <span role="status" className="sr-only">
@@ -1348,24 +1308,17 @@ const SidebarThreadRow = memo(function SidebarThreadRow(props: {
                   </button>
                 )
               ) : !props.settlementSupported ? null : variantAction === "unsettle" ? (
-                <Tooltip>
-                  <TooltipTrigger
-                    render={
-                      <button
-                        type="button"
-                        aria-label="Un-settle thread"
-                        onClick={handleUnsettleClick}
-                        className={cn(
-                          "pointer-events-none absolute inset-y-0 right-0 -mr-1 inline-flex cursor-pointer items-center gap-1 rounded-md bg-transparent px-1.5 text-xs text-muted-foreground opacity-0 transition-opacity hover:text-foreground focus-visible:pointer-events-auto focus-visible:opacity-100 group-hover/sidebar-row:pointer-events-auto group-hover/sidebar-row:opacity-100",
-                          isWoke && "group-hover/sidebar-row:static",
-                        )}
-                      />
-                    }
-                  >
-                    <Undo2Icon className="mb-px size-3.5" />
-                  </TooltipTrigger>
-                  <TooltipPopup side="top">Un-settle thread</TooltipPopup>
-                </Tooltip>
+                <button
+                  type="button"
+                  aria-label="Un-settle thread"
+                  onClick={handleUnsettleClick}
+                  className={cn(
+                    "pointer-events-none absolute inset-y-0 right-0 -mr-1 inline-flex cursor-pointer items-center gap-1 rounded-md bg-transparent px-1.5 text-xs text-muted-foreground opacity-0 transition-opacity hover:text-foreground focus-visible:pointer-events-auto focus-visible:opacity-100 group-hover/sidebar-row:pointer-events-auto group-hover/sidebar-row:opacity-100",
+                    isWoke && "group-hover/sidebar-row:static",
+                  )}
+                >
+                  <Undo2Icon className="mb-px size-3.5" />
+                </button>
               ) : (
                 <button
                   type="button"
@@ -1388,7 +1341,7 @@ const SidebarThreadRow = memo(function SidebarThreadRow(props: {
     );
   }
 
-  const diff = latestTurnDiff(thread);
+  const diff = latestRunDiff(thread);
 
   const sortable = props.sortable;
   return (
@@ -1445,7 +1398,31 @@ const SidebarThreadRow = memo(function SidebarThreadRow(props: {
               ) : (
                 <span className="flex-1" />
               )}
-              {pinIndicator}
+              {props.isPinned ? (
+                props.pinningSupported ? (
+                  <Tooltip>
+                    <TooltipTrigger
+                      render={
+                        <button
+                          type="button"
+                          aria-label="Unpin thread"
+                          onClick={handleUnpinClick}
+                          className="inline-flex cursor-pointer items-center rounded-sm text-muted-foreground/65 outline-none transition-colors hover:text-foreground focus-visible:ring-2 focus-visible:ring-ring"
+                        />
+                      }
+                    >
+                      <PinIcon aria-hidden className="size-3 shrink-0" />
+                    </TooltipTrigger>
+                    <TooltipPopup>Unpin thread</TooltipPopup>
+                  </Tooltip>
+                ) : (
+                  <PinIcon
+                    aria-label="Pinned"
+                    role="img"
+                    className="size-3 shrink-0 text-muted-foreground/65"
+                  />
+                )
+              ) : null}
               {/* The visible state owns this slot's width: status at rest,
                   actions on hover/keyboard focus or while the popover is open. Keeping
                   the hidden state out of flow lets the project label reclaim
@@ -1459,7 +1436,7 @@ const SidebarThreadRow = memo(function SidebarThreadRow(props: {
                     isWokeStatus
                       ? "pointer-events-auto"
                       : "pointer-events-none group-has-[:focus-visible]/sidebar-status-slot:absolute group-has-[:focus-visible]/sidebar-status-slot:right-0 group-has-[:focus-visible]/sidebar-status-slot:opacity-0 group-hover/sidebar-row:absolute group-hover/sidebar-row:right-0 group-hover/sidebar-row:opacity-0",
-                    "flex items-center self-center justify-self-end tabular-nums text-secondary-label transition-opacity",
+                    "self-center justify-self-end tabular-nums text-secondary-label transition-opacity",
                     snoozeMenuOpen && "pointer-events-none absolute right-0 opacity-0",
                   )}
                 >
@@ -1596,7 +1573,7 @@ const SidebarThreadRow = memo(function SidebarThreadRow(props: {
                       driverKind={driverKind}
                       displayName={
                         providerEntry?.displayName ??
-                        thread.session?.providerName ??
+                        thread.runtime?.providerName ??
                         modelInstanceId
                       }
                       accentColor={providerEntry?.accentColor}
@@ -1618,7 +1595,7 @@ const SidebarThreadRow = memo(function SidebarThreadRow(props: {
   );
 });
 
-function latestTurnDiff(
+function latestRunDiff(
   thread: SidebarThreadSummary,
 ): { insertions: number; deletions: number } | null {
   // Shells don't carry checkpoint summaries; diff stats render only when the
@@ -1658,7 +1635,7 @@ const SidebarSearchResultRow = memo(function SidebarSearchResultRow(props: {
     activeThreadBranch: thread.branch,
     currentGitBranch: gitStatus.data?.refName ?? null,
   });
-  const modelInstanceId = thread.session?.providerInstanceId ?? thread.modelSelection.instanceId;
+  const modelInstanceId = thread.runtime?.providerInstanceId ?? thread.modelSelection.instanceId;
   const providerEntry = props.providerEntryByInstanceId.get(modelInstanceId) ?? null;
   const showInstanceBadge =
     providerEntry !== null &&
@@ -1896,18 +1873,15 @@ export default function Sidebar() {
     () => sortLogicalProjectsForSidebar(unsortedProjectGroups, threads, sidebarProjectSortOrder),
     [sidebarProjectSortOrder, threads, unsortedProjectGroups],
   );
-  const serverConfigs = useAtomValue(environmentServerConfigsAtom);
-  // Threads on non-primary environments (T3 Connect, hosted) resolve their
-  // provider entry from their own environment's config: default instance ids
-  // are driver slugs, so a flat map would collide across environments.
-  const providerEntriesByEnvironment = useMemo(
+  const serverProviders = useAtomValue(primaryServerProvidersAtom);
+  const providerEntryByInstanceId = useMemo(
     () =>
-      deriveProviderEntriesByEnvironment(
-        [...serverConfigs].map(
-          ([environmentId, config]) => [environmentId, config.providers] as const,
+      new Map(
+        deriveProviderInstanceEntries(serverProviders).map(
+          (entry) => [entry.instanceId as string, entry] as const,
         ),
       ),
-    [serverConfigs],
+    [serverProviders],
   );
   const projectCwdByKey = useMemo(
     () =>
@@ -2073,6 +2047,7 @@ export default function Sidebar() {
   // the partition works directly off live shells: no archived-snapshot
   // merging, no optimistic holds. Archived threads remain hidden here —
   // archive keeps its original "remove from sidebar" meaning.
+  const serverConfigs = useAtomValue(environmentServerConfigsAtom);
   const {
     pinnedThreads,
     reorderablePinnedKeys,
@@ -2088,12 +2063,9 @@ export default function Sidebar() {
     // memo exactly at the next wake boundary.
     void snoozeWakeTick;
     const preciseNow = new Date().toISOString();
-    const visible = threads.filter(
-      (thread) =>
-        thread.archivedAt === null &&
-        (scopedProjectKeys === null ||
-          scopedProjectKeys.has(`${thread.environmentId}:${thread.projectId}`)),
-    );
+    // Subagent child threads live in the parent's Agents surface, not the
+    // sidebar roster (v2 models them as real threads with lineage).
+    const visible = filterSidebarV2VisibleThreads(threads, scopedProjectKeys);
     const pinned: EnvironmentThreadShell[] = [];
     const active: EnvironmentThreadShell[] = [];
     const snoozed: EnvironmentThreadShell[] = [];
@@ -2110,17 +2082,23 @@ export default function Sidebar() {
       const threadKey = scopedThreadKey(scopeThreadRef(thread.environmentId, thread.id));
       const snapshot = changeRequestSnapshotByKey.get(threadKey);
       const changeRequest =
-        snapshot != null &&
-        (thread.linkedPullRequest == null
-          ? thread.worktreePath === null || snapshot.branch === thread.branch
-          : snapshot.linkedPullRequest?.projectId === thread.linkedPullRequest.projectId &&
-            snapshot.linkedPullRequest.repository === thread.linkedPullRequest.repository &&
-            snapshot.linkedPullRequest.number === thread.linkedPullRequest.number)
-          ? snapshot.pr
+        snapshot != null && (thread.worktreePath === null || snapshot.branch === thread.branch)
+          ? { state: snapshot.pr.state }
           : null;
-      // Snooze outranks settlement and pinning until the thread wakes.
+      // Snooze outranks everything, including a pin: "hide until Tuesday"
+      // temporarily suspends "keep on top". The pin survives underneath —
+      // and so does its pinOrderKey, so on wake the thread reappears at
+      // its exact slot in the pinned block. (For unpinned threads
+      // this is also the snooze-beats-auto-settle rule: the wake time is a
+      // stronger statement about when the thread matters again.)
       if (supportsSnooze && effectiveSnoozed(thread, { now: preciseNow })) {
         snoozed.push(thread);
+        // A pin otherwise overrides the lifecycle: pinned threads never
+        // auto-settle out of sight. (The decider clears settled state on
+        // pin and the pin on settle, so pin-vs-settled conflicts only
+        // arise from stale or raced writes.)
+      } else if (thread.pinnedAt != null) {
+        pinned.push(thread);
       } else if (
         supportsSettlement &&
         effectiveSettled(thread, {
@@ -2131,8 +2109,6 @@ export default function Sidebar() {
         })
       ) {
         settled.push(thread);
-      } else if (thread.pinnedAt != null) {
-        pinned.push(thread);
       } else {
         active.push(thread);
       }
@@ -2366,7 +2342,7 @@ export default function Sidebar() {
     }
     return mapping;
   }, [keybindings, orderedThreadKeys]);
-  const { showThreadJumpHints, updateThreadJumpHintsVisibility } = useThreadJumpHintVisibility();
+  const [showJumpHints, setShowJumpHints] = useState(false);
 
   // Settled threads are live shells, so opening one is plain navigation:
   // history stays readable without un-settling, and sending a message or
@@ -3032,7 +3008,7 @@ export default function Sidebar() {
       if (clicked.value === "mark-unread") {
         for (const threadKey of threadKeys) {
           const thread = threadByKeyRef.current.get(threadKey);
-          markThreadUnread(threadKey, thread?.latestTurn?.completedAt);
+          markThreadUnread(threadKey, thread?.latestRun?.completedAt);
         }
         clearSelection();
         return;
@@ -3140,8 +3116,7 @@ export default function Sidebar() {
               isSnoozed,
               canSnoozeNow: canSnooze(thread, { now: new Date().toISOString() }),
               isRegeneratingTitle,
-              isRunning:
-                thread.session?.status === "running" && thread.session.activeTurnId != null,
+              isRunning: thread.runtime?.status === "running" && thread.runtime.activeRunId != null,
               supports: {
                 settlement: supportsSettlement,
                 snooze: supportsSnooze,
@@ -3222,7 +3197,7 @@ export default function Sidebar() {
             return;
           }
           case "mark-unread":
-            markThreadUnread(threadKey, thread.latestTurn?.completedAt);
+            markThreadUnread(threadKey, thread.latestRun?.completedAt);
             return;
           case "copy-path":
             if (!threadWorkspacePath) {
@@ -3386,22 +3361,14 @@ export default function Sidebar() {
   // match a thread-jump binding. Adding Shift (screenshots) or Alt no
   // longer matches ⌘1..9, so the overlay hides for chords like ⌘⇧4.
   const shortcutModifiers = useShortcutModifierState();
-  const terminalFocused = useTerminalFocus();
   const shouldShowJumpHintsNow = shouldShowThreadJumpHintsForModifiers(
     shortcutModifiers,
     keybindings,
-    {
-      platform: navigator.platform,
-      context: {
-        terminalFocus: terminalFocused,
-        terminalOpen: routeTerminalOpen,
-        modelPickerOpen: isModelPickerOpen(),
-      },
-    },
+    { platform: navigator.platform },
   );
   useEffect(() => {
-    updateThreadJumpHintsVisibility(shouldShowJumpHintsNow);
-  }, [shouldShowJumpHintsNow, updateThreadJumpHintsVisibility]);
+    setShowJumpHints(shouldShowJumpHintsNow);
+  }, [shouldShowJumpHintsNow]);
 
   const attachListAutoAnimateRef = useCallback((node: HTMLUListElement | null) => {
     if (!node) return;
@@ -3586,10 +3553,7 @@ export default function Sidebar() {
                     </span>
                     <ChevronDownIcon className="-mr-px size-4 shrink-0" />
                   </ComboboxTrigger>
-                  <ComboboxPopup
-                    align="start"
-                    className="w-(--anchor-width) min-w-0 overflow-hidden"
-                  >
+                  <ComboboxPopup align="start" className="w-(--anchor-width)">
                     <div className="shrink-0 px-3 pt-2.5">
                       <div className="relative -translate-y-px border-b border-border/70 pb-1.5 transition-colors focus-within:border-ring">
                         <SearchIcon
@@ -3720,10 +3684,7 @@ export default function Sidebar() {
                           ) ?? null
                         }
                         environmentLabel={environmentLabelById.get(thread.environmentId) ?? null}
-                        providerEntryByInstanceId={
-                          providerEntriesByEnvironment.get(thread.environmentId) ??
-                          EMPTY_PROVIDER_ENTRIES
-                        }
+                        providerEntryByInstanceId={providerEntryByInstanceId}
                         isHighlighted={activeSearchResultIndex === index}
                         isRouteActive={routeThreadKey === threadKey}
                         resultId={`sidebar-thread-search-result-${index}`}
@@ -3800,7 +3761,7 @@ export default function Sidebar() {
                           serverConfigs.get(thread.environmentId)?.environment.capabilities
                             .threadPinning === true
                         }
-                        isPinned={thread.pinnedAt != null}
+                        isPinned={section === "pinned"}
                         sortable={sortable}
                         snoozeWakeLabelText={
                           section === "snoozed" && thread.snoozedUntil != null
@@ -3816,9 +3777,7 @@ export default function Sidebar() {
                         wokeAt={threadWokeAt(thread, { now: snoozeNow })}
                         isActive={routeThreadKey === threadKey}
                         openPullRequestsInRightPanel={routeThreadRef !== null}
-                        jumpLabel={
-                          showThreadJumpHints ? (jumpLabelByKey.get(threadKey) ?? null) : null
-                        }
+                        jumpLabel={showJumpHints ? (jumpLabelByKey.get(threadKey) ?? null) : null}
                         currentEnvironmentId={primaryEnvironmentId}
                         environmentLabel={environmentLabelById.get(thread.environmentId) ?? null}
                         projectCwd={
@@ -3834,10 +3793,7 @@ export default function Sidebar() {
                             `${thread.environmentId}:${thread.projectId}`,
                           ) ?? null
                         }
-                        providerEntryByInstanceId={
-                          providerEntriesByEnvironment.get(thread.environmentId) ??
-                          EMPTY_PROVIDER_ENTRIES
-                        }
+                        providerEntryByInstanceId={providerEntryByInstanceId}
                         timestampFormat={timestampFormat}
                         onThreadClick={handleThreadClick}
                         onThreadActivate={navigateToThread}
@@ -3876,45 +3832,36 @@ export default function Sidebar() {
                       routeDraftId={routeDraftIdForRows}
                       onNavigateToDraft={navigateToDraft}
                     />,
-                    pinnedThreads.length > 0 ? (
-                      <li key="pinned-dnd" className="list-none">
-                        <DndContext
-                          sensors={pinnedDndSensors}
-                          collisionDetection={closestCenter}
-                          modifiers={[restrictToVerticalAxis, restrictToFirstScrollableAncestor]}
-                          onDragEnd={handlePinnedDragEnd}
-                        >
-                          <SortableContext
-                            items={orderedPinnedThreads
-                              .map((thread) =>
-                                scopedThreadKey(scopeThreadRef(thread.environmentId, thread.id)),
-                              )
-                              .filter((threadKey) => reorderablePinnedKeys.has(threadKey))}
-                            strategy={verticalListSortingStrategy}
-                          >
-                            <ul
-                              role="list"
-                              aria-label="Pinned threads"
-                              className="flex flex-col gap-px"
-                            >
-                              {orderedPinnedThreads.map((thread) => {
-                                const threadKey = scopedThreadKey(
-                                  scopeThreadRef(thread.environmentId, thread.id),
-                                );
-                                if (!reorderablePinnedKeys.has(threadKey)) {
-                                  return renderThreadRow(thread, "pinned");
-                                }
-                                return (
-                                  <SortablePinnedThreadRow key={threadKey} id={threadKey}>
-                                    {(bag) => renderThreadRow(thread, "pinned", bag)}
-                                  </SortablePinnedThreadRow>
-                                );
-                              })}
-                            </ul>
-                          </SortableContext>
-                        </DndContext>
-                      </li>
-                    ) : null,
+                    <DndContext
+                      key="pinned-dnd"
+                      sensors={pinnedDndSensors}
+                      collisionDetection={closestCenter}
+                      modifiers={[restrictToVerticalAxis, restrictToFirstScrollableAncestor]}
+                      onDragEnd={handlePinnedDragEnd}
+                    >
+                      <SortableContext
+                        items={orderedPinnedThreads
+                          .map((thread) =>
+                            scopedThreadKey(scopeThreadRef(thread.environmentId, thread.id)),
+                          )
+                          .filter((threadKey) => reorderablePinnedKeys.has(threadKey))}
+                        strategy={verticalListSortingStrategy}
+                      >
+                        {orderedPinnedThreads.map((thread) => {
+                          const threadKey = scopedThreadKey(
+                            scopeThreadRef(thread.environmentId, thread.id),
+                          );
+                          if (!reorderablePinnedKeys.has(threadKey)) {
+                            return renderThreadRow(thread, "pinned");
+                          }
+                          return (
+                            <SortablePinnedThreadRow key={threadKey} id={threadKey}>
+                              {(bag) => renderThreadRow(thread, "pinned", bag)}
+                            </SortablePinnedThreadRow>
+                          );
+                        })}
+                      </SortableContext>
+                    </DndContext>,
                   ];
                   if (pinnedThreads.length > 0) {
                     items.push(
@@ -4033,7 +3980,7 @@ export default function Sidebar() {
                   <button
                     type="button"
                     onClick={openAddProjectCommandPalette}
-                    className="inline-flex cursor-pointer items-center gap-1.5 rounded-md border border-sidebar-border px-2.5 py-1 text-[11px] font-medium text-sidebar-muted-foreground transition-colors hover:bg-sidebar-row-hover hover:text-sidebar-foreground"
+                    className="inline-flex items-center gap-1.5 rounded-md border border-sidebar-border px-2.5 py-1 text-[11px] font-medium text-sidebar-muted-foreground transition-colors hover:bg-sidebar-row-hover hover:text-sidebar-foreground"
                   >
                     <PlusIcon className="-mx-0.5 size-3" />
                     Add project
diff --git a/apps/web/src/components/ThreadStatusIndicators.tsx b/apps/web/src/components/ThreadStatusIndicators.tsx
index 843d310dd441..085a84db7b21 100644
--- a/apps/web/src/components/ThreadStatusIndicators.tsx
+++ b/apps/web/src/components/ThreadStatusIndicators.tsx
@@ -17,7 +17,11 @@ import { useThreadRunningTerminalIds } from "../state/terminalSessions";
 import { vcsEnvironment } from "../state/vcs";
 import { useUiStateStore } from "../uiStateStore";
 import { resolveChangeRequestPresentation } from "../sourceControlPresentation";
-import { resolveThreadStatusPill, type ThreadStatusPill } from "./Sidebar.logic";
+import {
+  resolveThreadLastVisitedAt,
+  resolveThreadStatusPill,
+  type ThreadStatusPill,
+} from "./Sidebar.logic";
 import type { SidebarThreadSummary } from "../types";
 import { formatWorktreePathForDisplay } from "../worktreeCleanup";
 import { Tooltip, TooltipPopup, TooltipTrigger } from "./ui/tooltip";
@@ -521,9 +525,10 @@ export function ThreadStatusLabel({
  */
 export function ThreadRowLeadingStatus({ thread }: { thread: SidebarThreadSummary }) {
   const threadRef = scopeThreadRef(thread.environmentId, thread.id);
-  const lastVisitedAt = useUiStateStore(
+  const localLastVisitedAt = useUiStateStore(
     (state) => state.threadLastVisitedAtById[scopedThreadKey(threadRef)],
   );
+  const lastVisitedAt = resolveThreadLastVisitedAt(thread.lastVisitedAt, localLastVisitedAt);
   const threadProject = useProject(
     useMemo(
       () => scopeProjectRef(thread.environmentId, thread.projectId),
diff --git a/apps/web/src/components/chat/ChangedFilesTree.test.tsx b/apps/web/src/components/chat/ChangedFilesTree.test.tsx
index accc6e0872ef..16f12e4eff65 100644
--- a/apps/web/src/components/chat/ChangedFilesTree.test.tsx
+++ b/apps/web/src/components/chat/ChangedFilesTree.test.tsx
@@ -1,4 +1,4 @@
-import { TurnId } from "@t3tools/contracts";
+import { RunId } from "@t3tools/contracts";
 import { renderToStaticMarkup } from "react-dom/server";
 import { describe, expect, it } from "vite-plus/test";
 
@@ -8,7 +8,7 @@ describe("ChangedFilesCard", () => {
   it("keeps its compact header sticky while preserving singular labels", () => {
     const markup = renderToStaticMarkup(
       <ChangedFilesCard
-        turnId={TurnId.make("turn-1")}
+        runId={RunId.make("run-1")}
         files={[{ path: "README.md", kind: "modified", additions: 2, deletions: 1 }]}
         expanded
         showCompactPreview={false}
@@ -43,7 +43,7 @@ describe("ChangedFilesCard", () => {
   it("renders a scope and representative-file preview for a large latest change", () => {
     const markup = renderToStaticMarkup(
       <ChangedFilesCard
-        turnId={TurnId.make("turn-1")}
+        runId={RunId.make("run-1")}
         files={[
           { path: "apps/web/src/App.tsx", kind: "modified", additions: 120, deletions: 20 },
           { path: "apps/web/src/App.test.tsx", kind: "modified", additions: 30, deletions: 2 },
@@ -81,7 +81,7 @@ describe("ChangedFilesCard", () => {
   it("keeps older collapsed changes to a one-line receipt", () => {
     const markup = renderToStaticMarkup(
       <ChangedFilesCard
-        turnId={TurnId.make("turn-1")}
+        runId={RunId.make("run-1")}
         files={[{ path: "apps/web/src/App.tsx", kind: "modified", additions: 120, deletions: 20 }]}
         expanded={false}
         showCompactPreview={false}
@@ -150,7 +150,7 @@ describe("ChangedFilesTree", () => {
     ({ files, visibleLabels, hiddenLabels }) => {
       const markup = renderToStaticMarkup(
         <ChangedFilesTree
-          turnId={TurnId.make("turn-1")}
+          runId={RunId.make("turn-1")}
           files={files}
           allDirectoriesExpanded={false}
           resolvedTheme="light"
@@ -226,7 +226,7 @@ describe("ChangedFilesTree", () => {
     ({ files, visibleLabels }) => {
       const markup = renderToStaticMarkup(
         <ChangedFilesTree
-          turnId={TurnId.make("turn-1")}
+          runId={RunId.make("turn-1")}
           files={files}
           allDirectoriesExpanded
           resolvedTheme="light"
diff --git a/apps/web/src/components/chat/ChangedFilesTree.tsx b/apps/web/src/components/chat/ChangedFilesTree.tsx
index 906bf4c34cb4..b02186f1680b 100644
--- a/apps/web/src/components/chat/ChangedFilesTree.tsx
+++ b/apps/web/src/components/chat/ChangedFilesTree.tsx
@@ -1,4 +1,4 @@
-import { type TurnId } from "@t3tools/contracts";
+import { type RunId } from "@t3tools/contracts";
 import { memo, useCallback, useMemo, useState } from "react";
 import { type TurnDiffFileChange } from "../../types";
 import {
@@ -28,7 +28,7 @@ import {
 const EMPTY_DIRECTORY_OVERRIDES: Record<string, boolean> = {};
 
 export const ChangedFilesCard = memo(function ChangedFilesCard(props: {
-  turnId: TurnId;
+  runId: RunId;
   files: ReadonlyArray<TurnDiffFileChange>;
   expanded: boolean;
   showCompactPreview: boolean;
@@ -36,10 +36,10 @@ export const ChangedFilesCard = memo(function ChangedFilesCard(props: {
   resolvedTheme: "light" | "dark";
   onExpandedChange: (expanded: boolean) => void;
   onToggleAllDirectories: () => void;
-  onOpenTurnDiff: (turnId: TurnId, filePath?: string) => void;
+  onOpenTurnDiff: (runId: RunId, filePath?: string) => void;
 }) {
   const {
-    turnId,
+    runId,
     files,
     expanded,
     showCompactPreview,
@@ -139,7 +139,7 @@ export const ChangedFilesCard = memo(function ChangedFilesCard(props: {
                   size="xs"
                   variant="outline"
                   aria-label="Open diff"
-                  onClick={() => onOpenTurnDiff(turnId, files[0]?.path)}
+                  onClick={() => onOpenTurnDiff(runId, files[0]?.path)}
                 />
               }
             >
@@ -152,8 +152,8 @@ export const ChangedFilesCard = memo(function ChangedFilesCard(props: {
       </div>
       {expanded ? (
         <ChangedFilesTree
-          key={`changed-files-tree:${turnId}`}
-          turnId={turnId}
+          key={`changed-files-tree:${runId}`}
+          runId={runId}
           files={files}
           allDirectoriesExpanded={allDirectoriesExpanded}
           resolvedTheme={resolvedTheme}
@@ -180,7 +180,7 @@ export const ChangedFilesCard = memo(function ChangedFilesCard(props: {
                     <button
                       type="button"
                       className="inline-flex max-w-48 items-center gap-1 rounded-md border border-border/70 bg-background/45 px-1.5 py-1 font-mono text-[10px] text-muted-foreground transition-colors hover:bg-accent/60 hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
-                      onClick={() => onOpenTurnDiff(turnId, file.path)}
+                      onClick={() => onOpenTurnDiff(runId, file.path)}
                     />
                   }
                 >
@@ -210,13 +210,13 @@ export const ChangedFilesCard = memo(function ChangedFilesCard(props: {
 });
 
 export const ChangedFilesTree = memo(function ChangedFilesTree(props: {
-  turnId: TurnId;
+  runId: RunId;
   files: ReadonlyArray<TurnDiffFileChange>;
   allDirectoriesExpanded: boolean;
   resolvedTheme: "light" | "dark";
-  onOpenTurnDiff: (turnId: TurnId, filePath?: string) => void;
+  onOpenTurnDiff: (runId: RunId, filePath?: string) => void;
 }) {
-  const { files, allDirectoriesExpanded, onOpenTurnDiff, resolvedTheme, turnId } = props;
+  const { files, allDirectoriesExpanded, onOpenTurnDiff, resolvedTheme, runId } = props;
   const treeNodes = useMemo(() => buildTurnDiffTree(files), [files]);
   const directoryPathsKey = useMemo(
     () => collectDirectoryPaths(treeNodes).join("\u0000"),
@@ -301,7 +301,7 @@ export const ChangedFilesTree = memo(function ChangedFilesTree(props: {
         type="button"
         className="group flex w-full items-center gap-1.5 rounded-xl py-1 pr-3 text-left transition-colors hover:bg-accent/60 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-1 focus-visible:ring-offset-background"
         style={{ paddingLeft: `${leftPadding}px` }}
-        onClick={() => onOpenTurnDiff(turnId, node.path)}
+        onClick={() => onOpenTurnDiff(runId, node.path)}
       >
         {hasDirectoryNodes || depth > 0 ? (
           <span aria-hidden="true" className="size-3.5 shrink-0" />
diff --git a/apps/web/src/components/chat/ChatComposer.tsx b/apps/web/src/components/chat/ChatComposer.tsx
index 2877f27788ba..4bcc34feba05 100644
--- a/apps/web/src/components/chat/ChatComposer.tsx
+++ b/apps/web/src/components/chat/ChatComposer.tsx
@@ -1,5 +1,5 @@
 import type {
-  ApprovalRequestId,
+  ChatAttachment as ContractChatAttachment,
   EnvironmentId,
   ModelSelection,
   PreviewAnnotationPayload,
@@ -10,6 +10,7 @@ import type {
   ScopedThreadRef,
   ServerProvider,
   ThreadId,
+  RuntimeRequestId,
 } from "@t3tools/contracts";
 import {
   ProviderDriverKind,
@@ -34,7 +35,6 @@ import {
 import { createPortal } from "react-dom";
 import {
   clampCollapsedComposerCursor,
-  type ComposerSubmissionIntent,
   type ComposerTrigger,
   collapseExpandedComposerCursor,
   composerSubmissionIntentForEnter,
@@ -76,6 +76,7 @@ import {
   type ComposerTaskStep,
   type ComposerTasksProgress,
 } from "./ComposerTasksBadge";
+import type { PendingBackgroundWorkTask } from "@t3tools/shared/orchestrationV2PendingBackgroundWork";
 import { ComposerActivityRow, type ComposerActivityStatus } from "./ComposerActivityStatus";
 import type { ThreadSyncPhase } from "../../threadSync";
 import { ComposerBanner } from "./ComposerBanner";
@@ -291,7 +292,12 @@ import { type AppModelOption, getAppModelOptionsForInstance } from "../../modelS
 import type { UnifiedSettings } from "@t3tools/contracts/settings";
 import type { SessionPhase, Thread } from "../../types";
 import type { PendingUserInputDraftAnswer } from "../../pendingUserInput";
-import type { PendingApproval, PendingUserInput } from "../../session-logic";
+import type {
+  LatestProposedPlanState,
+  PendingApproval,
+  PendingUserInput,
+} from "../../session-logic";
+import { resolveComposerDispatchMode, type ComposerDispatchMode } from "./composerDispatch";
 import type { ContextWindowSnapshot } from "../../lib/contextWindow";
 import {
   formatProviderSkillDisplayName,
@@ -318,7 +324,7 @@ const runtimeModeConfig: Record<
   },
   auto: {
     label: "Auto",
-    description: "Supported providers approve routine actions; others still ask.",
+    description: "An AI reviewer approves routine actions; risky ones still ask.",
     icon: SparklesIcon,
   },
   "full-access": {
@@ -374,6 +380,7 @@ const ComposerFooterModeControls = memo(function ComposerFooterModeControls(prop
   showInteractionModeToggle: boolean;
   interactionMode: ProviderInteractionMode;
   runtimeMode: RuntimeMode;
+  showPlanToggle: boolean;
   onToggleInteractionMode: () => void;
   onRuntimeModeChange: (mode: RuntimeMode) => void;
 }) {
@@ -383,7 +390,6 @@ const ComposerFooterModeControls = memo(function ComposerFooterModeControls(prop
     props.interactionMode === "plan"
       ? "Plan mode — click to return to normal build mode"
       : "Default mode — click to enter plan mode";
-
   const interactionModeToggle = props.showInteractionModeToggle ? (
     <>
       <Separator orientation="vertical" className="mx-0.5 hidden h-4 sm:block" />
@@ -394,8 +400,8 @@ const ComposerFooterModeControls = memo(function ComposerFooterModeControls(prop
               className={cn(
                 "shrink-0 whitespace-nowrap",
                 props.interactionMode === "plan"
-                  ? "bg-accent text-accent-foreground hover:bg-accent/80"
-                  : "text-secondary-label hover:text-foreground",
+                  ? "bg-blue-500/10 text-blue-400 hover:bg-blue-500/15 hover:text-blue-300"
+                  : "text-muted-foreground/70 hover:text-foreground/80",
               )}
               type="button"
               onClick={props.onToggleInteractionMode}
@@ -483,7 +489,8 @@ const ComposerFooterPrimaryActions = memo(function ComposerFooterPrimaryActions(
   isEnvironmentUnavailable: boolean;
   hasSendableContent: boolean;
   preserveComposerFocusOnPointerDown?: boolean;
-  showSendWhileRunning?: boolean;
+  isEditingQueuedMessage: boolean;
+  onSubmitMessage: React.MouseEventHandler<HTMLButtonElement>;
   onPreviousPendingQuestion: () => void;
   onInterrupt: () => void;
   onImplementPlanInNewThread: () => void;
@@ -518,7 +525,8 @@ const ComposerFooterPrimaryActions = memo(function ComposerFooterPrimaryActions(
         isPreparingWorktree={props.isPreparingWorktree}
         hasSendableContent={props.hasSendableContent}
         preserveComposerFocusOnPointerDown={props.preserveComposerFocusOnPointerDown ?? false}
-        showSendWhileRunning={props.showSendWhileRunning ?? false}
+        isEditingQueuedMessage={props.isEditingQueuedMessage}
+        onSubmitMessage={props.onSubmitMessage}
         onPreviousPendingQuestion={props.onPreviousPendingQuestion}
         onInterrupt={props.onInterrupt}
         onImplementPlanInNewThread={props.onImplementPlanInNewThread}
@@ -602,8 +610,8 @@ export interface ChatComposerProps {
   phase: SessionPhase;
   isConnecting: boolean;
   isSendBusy: boolean;
-  sendDisabledReason: string | null;
   isPreparingWorktree: boolean;
+  queuedRunsControl?: ReactNode;
   bannerItems: readonly ComposerBannerStackItem[];
   environmentUnavailable: {
     readonly label: string;
@@ -625,16 +633,17 @@ export interface ChatComposerProps {
   activePendingIsResponding: boolean;
   activePendingDraftAnswers: Record<string, PendingUserInputDraftAnswer>;
   activePendingQuestionIndex: number;
-  respondingRequestIds: ApprovalRequestId[];
+  respondingRequestIds: RuntimeRequestId[];
 
   // Plan
   showPlanFollowUpPrompt: boolean;
-  activeProposedPlan: Thread["proposedPlans"][number] | null;
+  activeProposedPlan: LatestProposedPlanState | null;
   activeTasksProgress: ComposerTasksProgress | null;
   activeTaskSteps: readonly ComposerTaskStep[] | null;
   isWorking: boolean;
   activeWorkStartedAt: string | null;
   threadSyncPhase: ThreadSyncPhase | null;
+  pendingBackgroundTasks: ReadonlyArray<PendingBackgroundWorkTask>;
 
   // Mode
   runtimeMode: RuntimeMode;
@@ -666,12 +675,24 @@ export interface ChatComposerProps {
   composerElementContextsRef: React.RefObject<ElementContextDraft[]>;
   composerRef: React.RefObject<ChatComposerHandle | null>;
 
+  // Scroll
+  shouldAutoScrollRef: React.RefObject<boolean>;
+  scheduleStickToBottom: () => void;
+
   // Callbacks
-  onSend: (e?: { preventDefault: () => void }, intent?: ComposerSubmissionIntent) => void;
+  sendDisabledReason: string | null;
+  onSend: (
+    e?: { preventDefault: () => void },
+    dispatchMode?: ComposerDispatchMode,
+    directAnnotation?: {
+      annotation: PreviewAnnotationPayload;
+      image: ComposerImageAttachment | null;
+    },
+  ) => void;
   onInterrupt: () => void;
   onImplementPlanInNewThread: () => void;
   onRespondToApproval: (
-    requestId: ApprovalRequestId,
+    requestId: RuntimeRequestId,
     decision: ProviderApprovalDecision,
   ) => Promise<unknown>;
   onSelectActivePendingUserInputOption: (questionId: string, optionLabel: string) => void;
@@ -695,6 +716,15 @@ export interface ChatComposerProps {
   scheduleComposerFocus: () => void;
   setThreadError: (threadId: ThreadId | null, error: string | null) => void;
   onExpandImage: (preview: ExpandedImagePreview) => void;
+
+  // Queued-message edit mode: attachments already stored on the message being
+  // edited. Rendered in the attachment strip with a remove control; removal is
+  // client state in ChatView until the edit is saved.
+  editingQueuedAttachments: ReadonlyArray<{
+    readonly attachment: ContractChatAttachment;
+    readonly url: string | null;
+  }> | null;
+  onRemoveEditingQueuedAttachment: (attachmentId: string) => void;
 }
 
 // --------------------------------------------------------------------------
@@ -757,6 +787,8 @@ export const ChatComposer = memo(function ChatComposer(props: ChatComposerProps)
     composerFilesRef,
     composerTerminalContextsRef,
     composerElementContextsRef,
+    shouldAutoScrollRef,
+    scheduleStickToBottom,
     onSend,
     onInterrupt,
     onImplementPlanInNewThread,
@@ -774,12 +806,20 @@ export const ChatComposer = memo(function ChatComposer(props: ChatComposerProps)
     scheduleComposerFocus,
     setThreadError,
     onExpandImage,
+    editingQueuedAttachments,
+    onRemoveEditingQueuedAttachment,
   } = props;
-  const activeTasksProgress = props.threadSyncPhase === null ? props.activeTasksProgress : null;
-  const activeTaskSteps = props.threadSyncPhase === null ? props.activeTaskSteps : null;
+  const showTaskProgress =
+    props.threadSyncPhase === null &&
+    (props.isWorking || props.pendingBackgroundTasks.length === 0);
+  const activeTasksProgress = showTaskProgress ? props.activeTasksProgress : null;
+  const activeTaskSteps = showTaskProgress ? props.activeTaskSteps : null;
   // ------------------------------------------------------------------
   // Store subscriptions (prompt / images / terminal contexts)
   // ------------------------------------------------------------------
+  // Non-null while a queued message is loaded for editing. The primary action
+  // must stay "send" (save the edit) in that mode, not the active run's stop.
+  const isEditingQueuedMessage = editingQueuedAttachments !== null;
   const composerDraft = useComposerThreadDraft(composerDraftTarget);
   // Live target key, for async flows that must notice a thread switch that
   // happened while they awaited.
@@ -950,7 +990,7 @@ export const ChatComposer = memo(function ChatComposer(props: ChatComposerProps)
   );
   const selectedProviderByThreadId = composerDraft.activeProvider ?? null;
   const threadProvider =
-    activeThread?.session?.providerInstanceId ??
+    activeThread?.runtime?.providerInstanceId ??
     activeThreadModelSelection?.instanceId ??
     activeProjectDefaultModelSelection?.instanceId ??
     null;
@@ -968,7 +1008,7 @@ export const ChatComposer = memo(function ChatComposer(props: ChatComposerProps)
   const lockedContinuationGroupKey = useMemo((): string | null => {
     if (!lockedProvider || !activeThread) return null;
     const lockedInstanceId =
-      activeThread.session?.providerInstanceId ?? activeThreadModelSelection?.instanceId;
+      activeThread.runtime?.providerInstanceId ?? activeThreadModelSelection?.instanceId;
     if (!lockedInstanceId) return null;
     return (
       providerInstanceEntries.find((entry) => entry.instanceId === lockedInstanceId)
@@ -994,7 +1034,7 @@ export const ChatComposer = memo(function ChatComposer(props: ChatComposerProps)
   const selectedInstanceId = useMemo<ProviderInstanceId>(() => {
     const candidates: Array<string | null | undefined> = [
       composerDraft.activeProvider,
-      activeThread?.session?.providerInstanceId,
+      activeThread?.runtime?.providerInstanceId,
       activeThreadModelSelection?.instanceId,
       activeProjectDefaultModelSelection?.instanceId,
     ];
@@ -1031,7 +1071,7 @@ export const ChatComposer = memo(function ChatComposer(props: ChatComposerProps)
     );
   }, [
     activeProjectDefaultModelSelection?.instanceId,
-    activeThread?.session?.providerInstanceId,
+    activeThread?.runtime?.providerInstanceId,
     activeThreadModelSelection?.instanceId,
     composerDraft.activeProvider,
     lockedContinuationGroupKey,
@@ -1193,6 +1233,7 @@ export const ChatComposer = memo(function ChatComposer(props: ChatComposerProps)
   const attachmentInputRef = useRef<HTMLInputElement>(null);
   const composerFormRef = useRef<HTMLFormElement>(null);
   const composerSurfaceRef = useRef<HTMLDivElement>(null);
+  const composerFormHeightRef = useRef(0);
   const providerInputRejectedRef = useRef(false);
   const composerSelectLockRef = useRef(false);
   const composerMenuOpenRef = useRef(false);
@@ -1276,24 +1317,20 @@ export const ChatComposer = memo(function ChatComposer(props: ChatComposerProps)
           label: "/model",
           description: "Switch response model for this thread",
         },
-        ...(planModeUiEnabled
-          ? ([
-              {
-                id: "slash:plan",
-                type: "slash-command",
-                command: "plan",
-                label: "/plan",
-                description: "Switch this thread into plan mode",
-              },
-              {
-                id: "slash:default",
-                type: "slash-command",
-                command: "default",
-                label: "/default",
-                description: "Switch this thread back to normal build mode",
-              },
-            ] as const)
-          : []),
+        {
+          id: "slash:plan",
+          type: "slash-command",
+          command: "plan",
+          label: "/plan",
+          description: "Switch this thread into plan mode",
+        },
+        {
+          id: "slash:default",
+          type: "slash-command",
+          command: "default",
+          label: "/default",
+          description: "Switch this thread back to normal build mode",
+        },
       ] satisfies ReadonlyArray<Extract<ComposerCommandItem, { type: "slash-command" }>>;
       const slashMenuSkills = getProviderSkillsForSlashMenu(
         selectedProviderStatus?.skills ?? [],
@@ -1726,12 +1763,15 @@ export const ChatComposer = memo(function ChatComposer(props: ChatComposerProps)
       };
     };
 
+    composerFormHeightRef.current = composerForm.getBoundingClientRect().height;
     const initialCompactness = measureFooterCompactness();
     setIsComposerPrimaryActionsCompact(initialCompactness.primaryActionsCompact);
     setIsComposerFooterCompact(initialCompactness.footerCompact);
     if (typeof ResizeObserver === "undefined") return;
 
-    const observer = new ResizeObserver(() => {
+    const observer = new ResizeObserver((entries) => {
+      const [entry] = entries;
+      if (!entry) return;
       const nextCompactness = measureFooterCompactness();
       setIsComposerPrimaryActionsCompact((previous) =>
         previous === nextCompactness.primaryActionsCompact
@@ -1741,13 +1781,25 @@ export const ChatComposer = memo(function ChatComposer(props: ChatComposerProps)
       setIsComposerFooterCompact((previous) =>
         previous === nextCompactness.footerCompact ? previous : nextCompactness.footerCompact,
       );
+      const nextHeight = entry.contentRect.height;
+      const previousHeight = composerFormHeightRef.current;
+      composerFormHeightRef.current = nextHeight;
+      if (previousHeight > 0 && Math.abs(nextHeight - previousHeight) < 0.5) return;
+      if (!shouldAutoScrollRef.current) return;
+      scheduleStickToBottom();
     });
 
     observer.observe(composerForm);
     return () => {
       observer.disconnect();
     };
-  }, [activeThreadId, composerFooterActionLayoutKey, composerFooterHasWideActions]);
+  }, [
+    activeThreadId,
+    composerFooterActionLayoutKey,
+    composerFooterHasWideActions,
+    scheduleStickToBottom,
+    shouldAutoScrollRef,
+  ]);
 
   // ------------------------------------------------------------------
   // Image persist effect
@@ -2106,7 +2158,7 @@ export const ChatComposer = memo(function ChatComposer(props: ChatComposerProps)
   ]);
 
   const submitComposer = useCallback(
-    (event?: { preventDefault: () => void }, intent: ComposerSubmissionIntent = "foreground") => {
+    (event?: { preventDefault: () => void }, dispatchMode?: ComposerDispatchMode) => {
       if (noProviderAvailable || isSendDisabled) {
         event?.preventDefault();
         return;
@@ -2132,7 +2184,10 @@ export const ChatComposer = memo(function ChatComposer(props: ChatComposerProps)
           // ChatView reports its final composed-input preflight through the
           // composer handle before its first asynchronous send step.
           providerInputRejectedRef.current = false;
-          onSend(sendEvent, intent);
+          onSend(
+            sendEvent,
+            dispatchMode ?? resolveComposerDispatchMode({ phase, queueModifier: false }),
+          );
           return !providerInputRejectedRef.current;
         },
       });
@@ -2149,10 +2204,24 @@ export const ChatComposer = memo(function ChatComposer(props: ChatComposerProps)
       isSendDisabled,
       noProviderAvailable,
       onSend,
+      phase,
       promptRef,
       shouldBlurMobileComposerOnSubmit,
     ],
   );
+  const handleSubmitMessage = useCallback(
+    (event: React.MouseEvent<HTMLButtonElement>) => {
+      event.preventDefault();
+      submitComposer(
+        event,
+        resolveComposerDispatchMode({
+          phase,
+          queueModifier: event.metaKey || event.ctrlKey,
+        }),
+      );
+    },
+    [phase, submitComposer],
+  );
   const compactThreadContext = useCallback(() => {
     if (
       compactDisabled ||
@@ -2236,7 +2305,6 @@ export const ChatComposer = memo(function ChatComposer(props: ChatComposerProps)
     event: KeyboardEvent,
   ) => {
     if (key === "Tab" && event.shiftKey) {
-      if (!planModeUiEnabled) return false;
       toggleInteractionMode();
       return true;
     }
@@ -2258,17 +2326,22 @@ export const ChatComposer = memo(function ChatComposer(props: ChatComposerProps)
         return true;
       }
     }
-    const submissionIntent =
-      key === "Enter"
-        ? composerSubmissionIntentForEnter({
-            isMobileViewport,
-            shiftKey: event.shiftKey,
-            modifierKey: event.metaKey || event.ctrlKey,
-            isDraftThread: routeKind === "draft",
-          })
-        : null;
-    if (submissionIntent) {
-      submitComposer(undefined, submissionIntent);
+    if (
+      key === "Enter" &&
+      composerSubmissionIntentForEnter({
+        isMobileViewport,
+        shiftKey: event.shiftKey,
+        modifierKey: false,
+        isDraftThread: false,
+      }) !== null
+    ) {
+      submitComposer(
+        undefined,
+        resolveComposerDispatchMode({
+          phase,
+          queueModifier: event.metaKey || event.ctrlKey,
+        }),
+      );
       return true;
     }
     return false;
@@ -2828,8 +2901,10 @@ export const ChatComposer = memo(function ChatComposer(props: ChatComposerProps)
         ? { kind: "sync", phase: props.threadSyncPhase }
         : isWorking
           ? { kind: "working", startedAt: activeWorkStartedAt }
-          : undefined,
-    [props.threadSyncPhase, isWorking, activeWorkStartedAt],
+          : props.pendingBackgroundTasks.length > 0
+            ? { kind: "waiting", tasks: props.pendingBackgroundTasks }
+            : undefined,
+    [props.threadSyncPhase, isWorking, activeWorkStartedAt, props.pendingBackgroundTasks],
   );
   const hasBannerItems = props.bannerItems.length > 0;
   const hasBlockingComposerTopDrawer =
@@ -2866,13 +2941,14 @@ export const ChatComposer = memo(function ChatComposer(props: ChatComposerProps)
   ) : null;
   const showShoulderTabs =
     !hasBannerItems && !showComposerTopDrawer && !isTasksDrawerOpen && !isComposerCollapsedMobile;
-  const hasShoulderTab =
+  const hasShoulderActivity =
     showShoulderTabs &&
     (activityStatus !== undefined ||
-      (stashQueue.length > 0 && !showInlineStashBadge) ||
       (activeTasksProgress !== null &&
         activeTaskSteps !== null &&
         activeTasksProgress.totalSteps > 0));
+  const showStashMenu =
+    isStashMenuOpen && !composerMenuOpen && !isComposerApprovalState && !isComposerCollapsedMobile;
   const tasksHostActivityStatus =
     activeTasksProgress !== null &&
     activeTasksProgress.totalSteps > 0 &&
@@ -2890,7 +2966,7 @@ export const ChatComposer = memo(function ChatComposer(props: ChatComposerProps)
         activityStatus={activityStatus}
       />
     ) : activityStatus ? (
-      <ComposerActivityRow status={activityStatus} />
+      <ComposerActivityRow status={activityStatus} onInterrupt={onInterrupt} />
     ) : null
   ) : null;
   const activityStackItem: ComposerBannerStackContent | null = activityStackContent
@@ -3415,155 +3491,191 @@ export const ChatComposer = memo(function ChatComposer(props: ChatComposerProps)
       onDragOverCapture={composerMentionDragHandlers.onDragOver}
       onDragLeaveCapture={onComposerMentionDragLeaveCapture}
       onDropCapture={composerMentionDragHandlers.onDrop}
-      className="mx-auto w-full min-w-0 max-w-3xl"
+      className="mx-auto w-full min-w-0 max-w-(--chat-content-max-width)"
       data-chat-composer-form="true"
     >
-      <ComposerBannerStack key={activeThreadId} className="relative z-0" items={bannerStackItems} />
-      {!activityStackItem &&
-      (inlineTasksBadge || (standaloneActivityStatus && !showShoulderTabs)) ? (
-        <ComposerBanner.Attachment>
-          <ComposerBanner.Root data-chat-composer-activity-strip="true">
-            {inlineTasksBadge ??
-              (standaloneActivityStatus ? (
-                <ComposerActivityRow status={standaloneActivityStatus} />
-              ) : null)}
-          </ComposerBanner.Root>
-        </ComposerBanner.Attachment>
-      ) : null}
-      {showComposerTopDrawer && (!isTasksDrawerOpen || hasBlockingComposerTopDrawer) ? (
-        <ComposerBanner.Attachment>
-          <ComposerBanner.Root
-            data-chat-composer-top-drawer="true"
-            variant={activePendingApproval ? "warning" : "info"}
-          >
-            {activePendingApproval ? (
-              <ComposerBanner.Row
-                layout="wrap-actions"
-                data-chat-composer-collapsed-controls="true"
+      <ComposerBanner.Dock>
+        <ComposerBanner.Column className={showStashMenu ? "hidden" : undefined}>
+          {props.queuedRunsControl}
+          <ComposerBannerStack
+            key={activeThreadId}
+            className="relative z-0"
+            items={bannerStackItems}
+          />
+          {!activityStackItem &&
+          (inlineTasksBadge || (standaloneActivityStatus && !showShoulderTabs)) ? (
+            <ComposerBanner.Attachment>
+              <ComposerBanner.Root data-chat-composer-activity-strip="true">
+                {inlineTasksBadge ??
+                  (standaloneActivityStatus ? (
+                    <ComposerActivityRow
+                      status={standaloneActivityStatus}
+                      onInterrupt={onInterrupt}
+                    />
+                  ) : null)}
+              </ComposerBanner.Root>
+            </ComposerBanner.Attachment>
+          ) : null}
+          {showComposerTopDrawer && (!isTasksDrawerOpen || hasBlockingComposerTopDrawer) ? (
+            <ComposerBanner.Attachment>
+              <ComposerBanner.Root
+                data-chat-composer-top-drawer="true"
+                variant={activePendingApproval ? "warning" : "info"}
               >
-                <ComposerBanner.Icon />
-                <ComposerBanner.Content>
-                  <ComposerPendingApprovalPanel
-                    approval={activePendingApproval}
-                    pendingCount={pendingApprovals.length}
-                  />
-                </ComposerBanner.Content>
-                <ComposerBanner.Actions>
-                  <ComposerPendingApprovalActions
-                    requestId={activePendingApproval.requestId}
-                    isResponding={respondingRequestIds.includes(activePendingApproval.requestId)}
-                    options={activePendingApproval.options}
-                    onRespondToApproval={onRespondToApproval}
-                  />
-                </ComposerBanner.Actions>
-              </ComposerBanner.Row>
-            ) : !isComposerCollapsedMobile && pendingUserInputs.length > 0 ? (
-              <ComposerPendingUserInputPanel
-                pendingUserInputs={pendingUserInputs}
-                respondingRequestIds={respondingRequestIds}
-                answers={activePendingDraftAnswers}
-                questionIndex={activePendingQuestionIndex}
-                onToggleOption={onSelectActivePendingUserInputOption}
-                onAdvance={onAdvanceActivePendingUserInput}
-              />
-            ) : !isComposerCollapsedMobile && showPlanFollowUpPrompt && activeProposedPlan ? (
-              <ComposerPlanFollowUpBanner
-                key={activeProposedPlan.id}
-                planTitle={proposedPlanTitle(activeProposedPlan.planMarkdown) ?? null}
-              />
-            ) : isComposerCollapsedMobile && pendingUserInputs.length > 0 ? (
-              <div data-chat-composer-collapsed-controls="true">
-                <ComposerPendingUserInputPanel
-                  pendingUserInputs={pendingUserInputs}
-                  respondingRequestIds={respondingRequestIds}
-                  answers={activePendingDraftAnswers}
-                  questionIndex={activePendingQuestionIndex}
-                  onToggleOption={onSelectActivePendingUserInputOption}
-                  onAdvance={onAdvanceActivePendingUserInput}
-                />
-                <ComposerBanner.Body>
-                  <div
-                    data-chat-composer-mobile-pending-compact="true"
-                    className={cn(
-                      "flex min-w-0 items-center gap-2 rounded-lg border border-border/55 bg-background/55 p-1.5 pl-3 transition-colors hover:bg-background/80",
-                      !activePendingProgress?.activeQuestion?.multiSelect && "p-0",
-                    )}
+                {activePendingApproval ? (
+                  <ComposerBanner.Row
+                    layout="wrap-actions"
+                    data-chat-composer-collapsed-controls="true"
                   >
-                    <button
-                      type="button"
-                      className={cn(
-                        "min-w-0 flex-1 truncate bg-transparent py-1.5 text-left text-sm",
-                        activePendingProgress?.customAnswer
-                          ? "text-foreground"
-                          : "text-placeholder",
-                        !activePendingProgress?.activeQuestion?.multiSelect && "px-3 py-2",
-                      )}
-                      onPointerDown={(event) => event.preventDefault()}
-                      onClick={expandMobileComposer}
-                      aria-label="Write custom answer"
-                    >
-                      {activePendingProgress?.customAnswer || "Write custom answer"}
-                    </button>
-                    {inlineStashBadge}
-                    {activePendingProgress?.activeQuestion?.multiSelect ? (
-                      <ComposerPrimaryActions
-                        compact
-                        pendingAction={pendingPrimaryAction}
-                        isRunning={false}
-                        showPlanFollowUpPrompt={false}
-                        promptHasText={false}
-                        isSendBusy={isSendBusy}
-                        sendDisabledReason={sendDisabledReason}
-                        isConnecting={isConnecting}
-                        isEnvironmentUnavailable={
-                          environmentUnavailable !== null ||
-                          noProviderAvailable ||
-                          projectSelectionRequired
-                        }
-                        isPreparingWorktree={false}
-                        hasSendableContent={false}
-                        preserveComposerFocusOnPointerDown
-                        onPreviousPendingQuestion={onPreviousActivePendingUserInputQuestion}
-                        onInterrupt={handleInterruptPrimaryAction}
-                        onImplementPlanInNewThread={handleImplementPlanInNewThreadPrimaryAction}
+                    <ComposerBanner.Icon />
+                    <ComposerBanner.Content>
+                      <ComposerPendingApprovalPanel
+                        approval={activePendingApproval}
+                        pendingCount={pendingApprovals.length}
                       />
-                    ) : null}
+                    </ComposerBanner.Content>
+                    <ComposerBanner.Actions>
+                      <ComposerPendingApprovalActions
+                        requestId={activePendingApproval.requestId}
+                        isResponding={respondingRequestIds.includes(
+                          activePendingApproval.requestId,
+                        )}
+                        options={activePendingApproval.options}
+                        canRespond={activePendingApproval.responseCapability === "live"}
+                        onRespondToApproval={onRespondToApproval}
+                      />
+                    </ComposerBanner.Actions>
+                  </ComposerBanner.Row>
+                ) : !isComposerCollapsedMobile && pendingUserInputs.length > 0 ? (
+                  <ComposerPendingUserInputPanel
+                    pendingUserInputs={pendingUserInputs}
+                    respondingRequestIds={respondingRequestIds}
+                    answers={activePendingDraftAnswers}
+                    questionIndex={activePendingQuestionIndex}
+                    onToggleOption={onSelectActivePendingUserInputOption}
+                    onAdvance={onAdvanceActivePendingUserInput}
+                  />
+                ) : !isComposerCollapsedMobile && showPlanFollowUpPrompt && activeProposedPlan ? (
+                  <ComposerPlanFollowUpBanner
+                    key={activeProposedPlan.id}
+                    planTitle={proposedPlanTitle(activeProposedPlan.planMarkdown) ?? null}
+                  />
+                ) : isComposerCollapsedMobile && pendingUserInputs.length > 0 ? (
+                  <div data-chat-composer-collapsed-controls="true">
+                    <ComposerPendingUserInputPanel
+                      pendingUserInputs={pendingUserInputs}
+                      respondingRequestIds={respondingRequestIds}
+                      answers={activePendingDraftAnswers}
+                      questionIndex={activePendingQuestionIndex}
+                      onToggleOption={onSelectActivePendingUserInputOption}
+                      onAdvance={onAdvanceActivePendingUserInput}
+                    />
+                    <ComposerBanner.Body>
+                      <div
+                        data-chat-composer-mobile-pending-compact="true"
+                        className={cn(
+                          "flex min-w-0 items-center gap-2 rounded-lg border border-border/55 bg-background/55 p-1.5 pl-3 transition-colors hover:bg-background/80",
+                          !activePendingProgress?.activeQuestion?.multiSelect && "p-0",
+                        )}
+                      >
+                        <button
+                          type="button"
+                          className={cn(
+                            "min-w-0 flex-1 truncate bg-transparent py-1.5 text-left text-sm",
+                            activePendingProgress?.customAnswer
+                              ? "text-foreground"
+                              : "text-muted-foreground/60",
+                            !activePendingProgress?.activeQuestion?.multiSelect && "px-3 py-2",
+                          )}
+                          onPointerDown={(event) => event.preventDefault()}
+                          onClick={expandMobileComposer}
+                          aria-label="Write custom answer"
+                        >
+                          {activePendingProgress?.customAnswer || "Write custom answer"}
+                        </button>
+                        {inlineStashBadge}
+                        {activePendingProgress?.activeQuestion?.multiSelect ? (
+                          <ComposerPrimaryActions
+                            compact
+                            pendingAction={pendingPrimaryAction}
+                            isRunning={false}
+                            showPlanFollowUpPrompt={false}
+                            promptHasText={false}
+                            isSendBusy={isSendBusy}
+                            sendDisabledReason={sendDisabledReason}
+                            isConnecting={isConnecting}
+                            isEnvironmentUnavailable={
+                              environmentUnavailable !== null ||
+                              noProviderAvailable ||
+                              projectSelectionRequired
+                            }
+                            isPreparingWorktree={false}
+                            hasSendableContent={false}
+                            preserveComposerFocusOnPointerDown
+                            onPreviousPendingQuestion={onPreviousActivePendingUserInputQuestion}
+                            onInterrupt={handleInterruptPrimaryAction}
+                            onImplementPlanInNewThread={handleImplementPlanInNewThreadPrimaryAction}
+                          />
+                        ) : null}
+                      </div>
+                    </ComposerBanner.Body>
                   </div>
-                </ComposerBanner.Body>
-              </div>
-            ) : null}
-          </ComposerBanner.Root>
-        </ComposerBanner.Attachment>
-      ) : null}
-      {!activityStackItem &&
-      isTasksDrawerOpen &&
-      !hasBlockingComposerTopDrawer &&
-      activeTasksProgress &&
-      activeTaskSteps ? (
-        <ComposerTasksDrawer
-          onCollapse={toggleTasksDrawer}
-          progress={activeTasksProgress}
-          steps={activeTaskSteps}
-          activityStatus={activityStatus}
-        />
-      ) : null}
-      {hasShoulderTab ? (
-        <ComposerBanner.Dock>
-          {standaloneActivityStatus ? (
-            <ComposerBanner.Root width="content" data-composer-shoulder-tab>
-              <ComposerActivityRow status={standaloneActivityStatus} />
-            </ComposerBanner.Root>
+                ) : null}
+              </ComposerBanner.Root>
+            </ComposerBanner.Attachment>
           ) : null}
-          {activeTasksProgress && activeTaskSteps ? (
-            <ComposerTasksBadge
-              expanded={false}
-              onToggle={toggleTasksDrawer}
+          {!activityStackItem &&
+          isTasksDrawerOpen &&
+          !hasBlockingComposerTopDrawer &&
+          activeTasksProgress &&
+          activeTaskSteps ? (
+            <ComposerTasksDrawer
+              onCollapse={toggleTasksDrawer}
               progress={activeTasksProgress}
               steps={activeTaskSteps}
               activityStatus={activityStatus}
             />
           ) : null}
-          {!showInlineStashBadge ? (
+          {hasShoulderActivity ? (
+            <ComposerBanner.Attachment>
+              {standaloneActivityStatus ? (
+                <ComposerBanner.Root width="content" data-composer-shoulder-tab>
+                  <ComposerActivityRow
+                    status={standaloneActivityStatus}
+                    onInterrupt={onInterrupt}
+                  />
+                </ComposerBanner.Root>
+              ) : null}
+              {activeTasksProgress && activeTaskSteps ? (
+                <ComposerTasksBadge
+                  expanded={false}
+                  onToggle={toggleTasksDrawer}
+                  progress={activeTasksProgress}
+                  steps={activeTaskSteps}
+                  activityStatus={activityStatus}
+                />
+              ) : null}
+            </ComposerBanner.Attachment>
+          ) : null}
+        </ComposerBanner.Column>
+        {showStashMenu ? (
+          <ComposerBanner.Attachment>
+            <ComposerStashMenu
+              entries={stashQueue}
+              stashShortcutLabel={shortcutLabelForCommand(keybindings, "composer.stash", {
+                context: {
+                  terminalFocus: false,
+                  terminalOpen,
+                  modelPickerOpen: false,
+                },
+              })}
+              onRestore={restoreStashEntry}
+              onDelete={deleteStashEntry}
+              onClose={() => setIsStashMenuOpen(false)}
+            />
+          </ComposerBanner.Attachment>
+        ) : showShoulderTabs && !showInlineStashBadge && stashQueue.length > 0 ? (
+          <ComposerBanner.Attachment className="ml-auto w-auto shrink-0">
             <ComposerStashBadge
               count={stashQueue.length}
               menuOpen={isStashMenuOpen}
@@ -3571,9 +3683,9 @@ export const ChatComposer = memo(function ChatComposer(props: ChatComposerProps)
               pulsing={stashPulse.active}
               onToggleMenu={toggleStashMenu}
             />
-          ) : null}
-        </ComposerBanner.Dock>
-      ) : null}
+          </ComposerBanner.Attachment>
+        ) : null}
+      </ComposerBanner.Dock>
       <div className="relative">
         <ComposerSurface.Main className={composerProviderState.composerFrameClassName}>
           <div
@@ -3641,24 +3753,6 @@ export const ChatComposer = memo(function ChatComposer(props: ChatComposerProps)
                 isComposerCollapsedMobile && "hidden",
               )}
             >
-              {isStashMenuOpen && !composerMenuOpen && !isComposerApprovalState && (
-                <ComposerCommandMenuLayer anchor={composerMenuAnchor}>
-                  <ComposerStashMenu
-                    entries={stashQueue}
-                    stashShortcutLabel={shortcutLabelForCommand(keybindings, "composer.stash", {
-                      context: {
-                        terminalFocus: false,
-                        terminalOpen,
-                        modelPickerOpen: false,
-                      },
-                    })}
-                    onRestore={restoreStashEntry}
-                    onDelete={deleteStashEntry}
-                    onClose={() => setIsStashMenuOpen(false)}
-                  />
-                </ComposerCommandMenuLayer>
-              )}
-
               {composerMenuOpen && !isComposerApprovalState && (
                 <ComposerCommandMenuLayer anchor={composerMenuAnchor}>
                   <ComposerCommandMenu
@@ -3730,6 +3824,42 @@ export const ChatComposer = memo(function ChatComposer(props: ChatComposerProps)
                   />
                 )}
 
+              {!isComposerCollapsedMobile &&
+                !isComposerApprovalState &&
+                pendingUserInputs.length === 0 &&
+                editingQueuedAttachments !== null &&
+                editingQueuedAttachments.length > 0 && (
+                  <div className="mb-3 flex flex-wrap gap-2">
+                    {editingQueuedAttachments.map(({ attachment, url }) => (
+                      <div
+                        key={attachment.id}
+                        className="relative h-16 w-16 overflow-hidden rounded-lg border border-border/80 bg-background"
+                      >
+                        {attachment.type === "image" && url ? (
+                          <img
+                            src={url}
+                            alt={attachment.name}
+                            className="h-full w-full object-cover"
+                          />
+                        ) : (
+                          <div className="flex h-full w-full items-center justify-center px-1 text-center text-[10px] text-secondary-label">
+                            {attachment.name}
+                          </div>
+                        )}
+                        <Button
+                          variant="ghost"
+                          size="icon-xs"
+                          className="absolute right-1 top-1 bg-background/80 hover:bg-background/90"
+                          onClick={() => onRemoveEditingQueuedAttachment(attachment.id)}
+                          aria-label={`Remove ${attachment.name}`}
+                        >
+                          <XIcon />
+                        </Button>
+                      </div>
+                    ))}
+                  </div>
+                )}
+
               {!isComposerCollapsedMobile &&
                 !isComposerApprovalState &&
                 pendingUserInputs.length === 0 &&
@@ -4076,6 +4206,7 @@ export const ChatComposer = memo(function ChatComposer(props: ChatComposerProps)
                         }
                         interactionMode={interactionMode}
                         runtimeMode={runtimeMode}
+                        showPlanToggle={false}
                         onToggleInteractionMode={toggleInteractionMode}
                         onRuntimeModeChange={handleRuntimeModeChange}
                       />
@@ -4089,7 +4220,7 @@ export const ChatComposer = memo(function ChatComposer(props: ChatComposerProps)
                   data-chat-composer-primary-actions-compact={
                     isComposerPrimaryActionsCompact ? "true" : "false"
                   }
-                  className="flex shrink-0 flex-nowrap items-center justify-end gap-2"
+                  className="flex min-h-9 shrink-0 flex-nowrap items-center justify-end gap-2 sm:min-h-8"
                 >
                   {fileStagingLimit !== null && pendingUserInputs.length === 0 ? (
                     <>
@@ -4128,6 +4259,7 @@ export const ChatComposer = memo(function ChatComposer(props: ChatComposerProps)
                   <ComposerFooterPrimaryActions
                     compact={isComposerPrimaryActionsCompact}
                     activeContextWindow={activeContextWindow}
+                    sendDisabledReason={sendDisabledReason}
                     activeThreadModelDisplayName={activeThreadModelDisplayName}
                     pendingAction={pendingPrimaryAction}
                     isRunning={phase === "running"}
@@ -4136,7 +4268,6 @@ export const ChatComposer = memo(function ChatComposer(props: ChatComposerProps)
                     }
                     promptHasText={prompt.trim().length > 0}
                     isSendBusy={isSendBusy}
-                    sendDisabledReason={sendDisabledReason}
                     isConnecting={isConnecting}
                     isEnvironmentUnavailable={
                       environmentUnavailable !== null ||
@@ -4146,7 +4277,8 @@ export const ChatComposer = memo(function ChatComposer(props: ChatComposerProps)
                     isPreparingWorktree={isPreparingWorktree}
                     hasSendableContent={composerSendState.hasSendableContent}
                     preserveComposerFocusOnPointerDown={isMobileViewport}
-                    showSendWhileRunning={isMobileViewport}
+                    isEditingQueuedMessage={isEditingQueuedMessage}
+                    onSubmitMessage={handleSubmitMessage}
                     onPreviousPendingQuestion={onPreviousActivePendingUserInputQuestion}
                     onInterrupt={handleInterruptPrimaryAction}
                     onImplementPlanInNewThread={handleImplementPlanInNewThreadPrimaryAction}
diff --git a/apps/web/src/components/chat/ChatHeader.tsx b/apps/web/src/components/chat/ChatHeader.tsx
index dbba327489ac..ebff6760704b 100644
--- a/apps/web/src/components/chat/ChatHeader.tsx
+++ b/apps/web/src/components/chat/ChatHeader.tsx
@@ -1,413 +1,78 @@
-import {
-  type EnvironmentId,
-  type EditorId,
-  type ProjectScript,
-  type ResolvedKeybindingsConfig,
-  type ThreadId,
-} from "@t3tools/contracts";
-import { scopeThreadRef } from "@t3tools/client-runtime/environment";
-import {
-  isAtomCommandInterrupted,
-  squashAtomCommandFailure,
-} from "@t3tools/client-runtime/state/runtime";
-import type { ChangeRequestSettleSource } from "@t3tools/client-runtime/state/thread-settled";
-import { ChevronDownIcon } from "lucide-react";
-import {
-  memo,
-  useCallback,
-  useEffect,
-  useMemo,
-  useRef,
-  useState,
-  type KeyboardEvent as ReactKeyboardEvent,
-  type MouseEvent as ReactMouseEvent,
-} from "react";
-import GitActionsControl from "../GitActionsControl";
-import { isTrailingDoubleClick } from "../Sidebar.logic";
-import { type DraftId } from "~/composerDraftStore";
-import { Tooltip, TooltipPopup, TooltipTrigger } from "../ui/tooltip";
-import { toastManager } from "../ui/toast";
-import ProjectScriptsControl, {
-  type NewProjectScriptInput,
-  type ProjectScriptActionResult,
-} from "../ProjectScriptsControl";
-import { OpenInPicker } from "./OpenInPicker";
-import { useRemoteOpenState, type RemoteOpenMode } from "../../remoteOpen";
-import { usePrimaryEnvironmentId } from "../../state/environments";
-import { useT3ProjectFileScripts } from "~/hooks/useT3ProjectFileScripts";
-import { useThreadActionMenu } from "~/hooks/useThreadActionMenu";
-import { threadEnvironment } from "../../state/threads";
-import { useAtomCommand } from "../../state/use-atom-command";
-import { ProjectFavicon } from "../ProjectFavicon";
-import {
-  WorkspaceBreadcrumb,
-  WorkspaceBreadcrumbItem,
-  WorkspaceBreadcrumbSeparator,
-} from "../WorkspaceBreadcrumb";
+import { type EnvironmentId } from "@t3tools/contracts";
+import { memo } from "react";
+
 import { cn } from "~/lib/utils";
+import { ProjectFavicon } from "../ProjectFavicon";
+import { Tooltip, TooltipPopup, TooltipTrigger } from "../ui/tooltip";
 
 interface ChatHeaderProps {
   activeThreadEnvironmentId: EnvironmentId;
-  activeThreadId: ThreadId;
-  draftId?: DraftId;
   activeThreadTitle: string;
-  /** Drafts have no server thread yet, so the title carries no action menu. */
-  isServerThread: boolean;
-  /** PR feeding the settled classification, resolved by ChatView. */
-  changeRequest: ChangeRequestSettleSource | null;
   activeProjectName: string | undefined;
   activeProjectCwd: string | null;
-  activeProjectFaviconPath: string | null;
-  openInCwd: string | null;
-  activeProjectScripts: ReadonlyArray<ProjectScript> | undefined;
-  preferredScriptId: string | null;
-  keybindings: ResolvedKeybindingsConfig;
-  availableEditors: ReadonlyArray<EditorId>;
   rightPanelOpen: boolean;
-  gitCwd: string | null;
-  readonly onOpenPullRequest?: ((number: number) => void) | undefined;
   onNewThreadInProject: () => void;
-  onRunProjectScript: (script: ProjectScript) => void;
-  onAddProjectScript: (input: NewProjectScriptInput) => Promise<ProjectScriptActionResult>;
-  onUpdateProjectScript: (
-    scriptId: string,
-    input: NewProjectScriptInput,
-  ) => Promise<ProjectScriptActionResult>;
-  onDeleteProjectScript: (scriptId: string) => Promise<ProjectScriptActionResult>;
-}
-
-/**
- * Rename commit rule shared with the sidebar's inline rename: trim, reject
- * empty (the caller toasts), and skip the mutation when nothing changed.
- */
-export function resolveRenameCommit(input: {
-  readonly title: string;
-  readonly originalTitle: string;
-}): { action: "commit"; title: string } | { action: "reject-empty" } | { action: "noop" } {
-  const trimmed = input.title.trim();
-  if (trimmed.length === 0) return { action: "reject-empty" };
-  if (trimmed === input.originalTitle) return { action: "noop" };
-  return { action: "commit", title: trimmed };
-}
-
-// How long a click on the thread title waits before opening the action menu,
-// so a double-click-to-rename can cancel it first. Only the native desktop
-// menu needs this: it swallows input while open, so the wait must cover the
-// OS double-click interval. The browser fallback menu keeps seeing DOM
-// events (the second click dismisses it and dblclick still fires), so it
-// opens immediately.
-const TITLE_MENU_OPEN_DELAY_MS = 500;
-
-export function shouldShowOpenInPicker(input: {
-  readonly activeProjectName: string | undefined;
-  readonly activeThreadEnvironmentId: EnvironmentId;
-  readonly primaryEnvironmentId: EnvironmentId | null;
-  readonly remoteOpenMode: RemoteOpenMode;
-}): boolean {
-  if (!input.activeProjectName) return false;
-  if (
-    input.primaryEnvironmentId !== null &&
-    input.activeThreadEnvironmentId === input.primaryEnvironmentId
-  ) {
-    return true;
-  }
-  // Remote environments get the picker in deep-link mode (or its explicit
-  // "no SSH route" state). Non-primary local backends (e.g. WSL) keep it
-  // hidden, matching pre-remote behavior.
-  return input.remoteOpenMode !== "local-exec";
 }
 
 export const ChatHeader = memo(function ChatHeader({
   activeThreadEnvironmentId,
-  activeThreadId,
-  draftId,
   activeThreadTitle,
-  isServerThread,
-  changeRequest,
   activeProjectName,
   activeProjectCwd,
-  activeProjectFaviconPath,
-  openInCwd,
-  activeProjectScripts,
-  preferredScriptId,
-  keybindings,
-  availableEditors,
   rightPanelOpen,
-  gitCwd,
-  onOpenPullRequest,
   onNewThreadInProject,
-  onRunProjectScript,
-  onAddProjectScript,
-  onUpdateProjectScript,
-  onDeleteProjectScript,
 }: ChatHeaderProps) {
-  const primaryEnvironmentId = usePrimaryEnvironmentId();
-  const fileScripts = useT3ProjectFileScripts(
-    activeThreadEnvironmentId,
-    activeProjectScripts ? activeProjectCwd : null,
-  );
-  const remoteOpenState = useRemoteOpenState(activeThreadEnvironmentId);
-  const showOpenInPicker = shouldShowOpenInPicker({
-    activeProjectName,
-    activeThreadEnvironmentId,
-    primaryEnvironmentId,
-    remoteOpenMode: remoteOpenState.mode,
-  });
-  const activeThreadRef = useMemo(
-    () => scopeThreadRef(activeThreadEnvironmentId, activeThreadId),
-    [activeThreadEnvironmentId, activeThreadId],
-  );
-  const updateThreadMetadata = useAtomCommand(threadEnvironment.updateMetadata, {
-    reportFailure: false,
-  });
-  // Inline rename, keyed by thread: navigating away drops an in-progress
-  // rename instead of committing stale text. Cleared on thread change (not
-  // just hidden) so returning to the thread doesn't revive the old draft.
-  const [renaming, setRenaming] = useState<{ threadId: ThreadId; title: string } | null>(null);
-  if (renaming !== null && renaming.threadId !== activeThreadId) {
-    setRenaming(null);
-  }
-  const renamingTitle = renaming?.threadId === activeThreadId ? renaming.title : null;
-  const renameCommittedRef = useRef(false);
-  const startRename = useCallback(() => {
-    renameCommittedRef.current = false;
-    setRenaming({ threadId: activeThreadId, title: activeThreadTitle });
-  }, [activeThreadId, activeThreadTitle]);
-  const commitRename = useCallback(
-    (title: string) => {
-      setRenaming(null);
-      const resolution = resolveRenameCommit({ title, originalTitle: activeThreadTitle });
-      if (resolution.action === "reject-empty") {
-        toastManager.add({ type: "warning", title: "Thread title cannot be empty" });
-        return;
-      }
-      if (resolution.action === "noop") return;
-      void updateThreadMetadata({
-        environmentId: activeThreadEnvironmentId,
-        input: { threadId: activeThreadId, title: resolution.title },
-      }).then((result) => {
-        if (result._tag === "Failure" && !isAtomCommandInterrupted(result)) {
-          const error = squashAtomCommandFailure(result);
-          toastManager.add({
-            type: "error",
-            title: "Failed to rename thread",
-            description: error instanceof Error ? error.message : "An error occurred.",
-          });
-        }
-      });
-    },
-    [activeThreadEnvironmentId, activeThreadId, activeThreadTitle, updateThreadMetadata],
-  );
-  const { openMenu, closeMenu } = useThreadActionMenu({
-    threadRef: isServerThread ? activeThreadRef : null,
-    projectCwd: activeProjectCwd,
-    changeRequest,
-    onStartRename: startRename,
-  });
-  const titleButtonRef = useRef<HTMLButtonElement | null>(null);
-  const titleMenuTimerRef = useRef<number | null>(null);
-  const cancelPendingTitleMenu = useCallback(() => {
-    if (titleMenuTimerRef.current === null) return;
-    clearTimeout(titleMenuTimerRef.current);
-    titleMenuTimerRef.current = null;
-  }, []);
-  // Drop a pending menu-open when the thread changes or the header unmounts,
-  // so it can never fire for a thread the user already left.
-  useEffect(
-    () => () => {
-      cancelPendingTitleMenu();
-    },
-    [activeThreadId, cancelPendingTitleMenu],
-  );
-  const openTitleMenuNow = useCallback(() => {
-    cancelPendingTitleMenu();
-    const rect = titleButtonRef.current?.getBoundingClientRect();
-    if (!rect) return;
-    openMenu({ x: rect.left, y: rect.bottom + 4 });
-  }, [cancelPendingTitleMenu, openMenu]);
-  const openMenuFromTitle = useCallback(
-    (event: ReactMouseEvent<HTMLButtonElement>) => {
-      // The trailing click of a double-click belongs to rename, not the menu.
-      if (isTrailingDoubleClick(event.detail)) return;
-      // Keyboard activation and the explicit chevron affordance can never be
-      // the first half of a double-click, so they open without waiting.
-      const clickedChevron =
-        (event.target as HTMLElement).closest("[data-thread-title-chevron]") !== null;
-      if (event.detail === 0 || clickedChevron || window.desktopBridge === undefined) {
-        openTitleMenuNow();
-        return;
-      }
-      // Stay pending long enough for dblclick to cancel the open before the
-      // native menu appears and swallows the second click.
-      cancelPendingTitleMenu();
-      titleMenuTimerRef.current = window.setTimeout(() => {
-        titleMenuTimerRef.current = null;
-        openTitleMenuNow();
-      }, TITLE_MENU_OPEN_DELAY_MS);
-    },
-    [cancelPendingTitleMenu, openTitleMenuNow],
-  );
-  const handleTitleDoubleClick = useCallback(
-    (event: ReactMouseEvent) => {
-      if (event.metaKey || event.ctrlKey || event.shiftKey || event.altKey) return;
-      // The chevron is the explicit menu affordance; only the title text renames.
-      if ((event.target as HTMLElement).closest("[data-thread-title-chevron]") !== null) return;
-      cancelPendingTitleMenu();
-      closeMenu();
-      startRename();
-    },
-    [cancelPendingTitleMenu, closeMenu, startRename],
-  );
-  const handleHeaderContextMenu = useCallback(
-    (event: ReactMouseEvent) => {
-      if (!isServerThread || renamingTitle !== null) return;
-      // The right-side controls (git, scripts, open-in) keep their own
-      // behavior; only the breadcrumb area opens the thread menu.
-      if ((event.target as HTMLElement).closest("[data-chat-header-actions]")) return;
-      cancelPendingTitleMenu();
-      event.preventDefault();
-      openMenu({ x: event.clientX, y: event.clientY });
-    },
-    [cancelPendingTitleMenu, isServerThread, openMenu, renamingTitle],
-  );
-  const handleRenameKeyDown = useCallback(
-    (event: ReactKeyboardEvent<HTMLInputElement>) => {
-      if (event.nativeEvent.isComposing || event.keyCode === 229) return;
-      if (event.key === "Enter") {
-        renameCommittedRef.current = true;
-        commitRename(event.currentTarget.value);
-      } else if (event.key === "Escape") {
-        renameCommittedRef.current = true;
-        setRenaming(null);
-      }
-    },
-    [commitRename],
-  );
   return (
     <div
-      className="@container/header-actions flex min-w-0 flex-1 items-center gap-2 sm:gap-3"
-      onContextMenu={handleHeaderContextMenu}
+      className={cn(
+        "flex min-w-0 flex-1 items-center gap-2 sm:gap-3",
+        rightPanelOpen ? "pr-10" : "pr-24",
+      )}
     >
-      <WorkspaceBreadcrumb ariaLabel="Thread breadcrumb" className="flex-1">
+      <div className="flex min-w-0 flex-1 items-center gap-2 overflow-hidden sm:gap-3">
         {/* The project always leads the header: knowing which project a
             thread lives in is priority zero, and the thread title alone
             doesn't answer it. */}
         {activeProjectName ? (
-          <>
-            <WorkspaceBreadcrumbItem>
-              <Tooltip>
-                <TooltipTrigger
-                  render={
-                    <button
-                      type="button"
-                      aria-label={`New thread in ${activeProjectName}`}
-                      onClick={onNewThreadInProject}
-                      className="inline-flex min-w-0 cursor-pointer items-center gap-1.5 rounded-sm text-muted-foreground transition-colors hover:text-foreground focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring"
-                    />
-                  }
-                >
-                  <ProjectFavicon
-                    environmentId={activeThreadEnvironmentId}
-                    cwd={activeProjectCwd ?? ""}
-                    faviconPath={activeProjectFaviconPath}
-                    className="size-3.5"
-                  />
-                  <span className="max-w-40 truncate">{activeProjectName}</span>
-                </TooltipTrigger>
-                <TooltipPopup side="top">New thread in {activeProjectName}</TooltipPopup>
-              </Tooltip>
-            </WorkspaceBreadcrumbItem>
-            <WorkspaceBreadcrumbSeparator />
-          </>
-        ) : null}
-        <WorkspaceBreadcrumbItem current className="flex-1">
-          {renamingTitle !== null ? (
-            <input
-              autoFocus
-              aria-label="Thread title"
-              className="min-w-0 flex-1 rounded-sm bg-transparent text-sm font-medium text-foreground outline-none ring-1 ring-ring/50 focus:ring-ring"
-              defaultValue={renamingTitle}
-              onBlur={(event) => {
-                if (renameCommittedRef.current) return;
-                commitRename(event.currentTarget.value);
-              }}
-              onFocus={(event) => event.currentTarget.select()}
-              onKeyDown={handleRenameKeyDown}
-            />
-          ) : isServerThread ? (
+          <span className="inline-flex shrink-0 items-center gap-2">
             <Tooltip>
               <TooltipTrigger
                 render={
                   <button
-                    ref={titleButtonRef}
                     type="button"
-                    aria-label={`Thread actions for ${activeThreadTitle}`}
-                    aria-haspopup="menu"
-                    onClick={openMenuFromTitle}
-                    onDoubleClick={handleTitleDoubleClick}
-                    onBlur={cancelPendingTitleMenu}
-                    className="group/thread-title inline-flex min-w-0 max-w-full cursor-pointer items-center gap-1 rounded-sm text-left focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring"
+                    aria-label={`New thread in ${activeProjectName}`}
+                    onClick={onNewThreadInProject}
+                    className="inline-flex min-w-0 cursor-pointer items-center gap-1.5 rounded-sm text-muted-foreground transition-colors hover:text-foreground focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring"
                   />
                 }
               >
-                <h2 className="min-w-0 truncate">{activeThreadTitle}</h2>
-                <ChevronDownIcon
-                  aria-hidden
-                  data-thread-title-chevron
-                  className="size-3.5 shrink-0 text-muted-foreground opacity-0 transition-opacity group-hover/thread-title:opacity-100 group-focus-visible/thread-title:opacity-100"
+                <ProjectFavicon
+                  environmentId={activeThreadEnvironmentId}
+                  cwd={activeProjectCwd ?? ""}
+                  className="size-3.5"
                 />
+                <span className="max-w-40 truncate text-sm font-medium">{activeProjectName}</span>
               </TooltipTrigger>
-              <TooltipPopup side="top">{activeThreadTitle}</TooltipPopup>
-            </Tooltip>
-          ) : (
-            <Tooltip>
-              <TooltipTrigger
-                render={
-                  <h2 aria-label={activeThreadTitle} className="min-w-0 flex-1 truncate">
-                    {activeThreadTitle}
-                  </h2>
-                }
-              />
-              <TooltipPopup side="top">{activeThreadTitle}</TooltipPopup>
+              <TooltipPopup side="top">New thread in {activeProjectName}</TooltipPopup>
             </Tooltip>
-          )}
-        </WorkspaceBreadcrumbItem>
-      </WorkspaceBreadcrumb>
-      <div
-        data-chat-header-actions
-        className={cn(
-          "flex shrink-0 items-center justify-end gap-2 @3xl/header-actions:gap-3",
-          rightPanelOpen ? "pr-0" : "pr-16",
-        )}
-      >
-        {activeProjectScripts && (
-          <ProjectScriptsControl
-            scripts={activeProjectScripts}
-            fileScripts={fileScripts}
-            keybindings={keybindings}
-            preferredScriptId={preferredScriptId}
-            onRunScript={onRunProjectScript}
-            onAddScript={onAddProjectScript}
-            onUpdateScript={onUpdateProjectScript}
-            onDeleteScript={onDeleteProjectScript}
-          />
-        )}
-        {showOpenInPicker && (
-          <OpenInPicker
-            environmentId={activeThreadEnvironmentId}
-            keybindings={keybindings}
-            availableEditors={availableEditors}
-            openInCwd={openInCwd}
-          />
-        )}
-        {activeProjectName && (
-          <GitActionsControl
-            gitCwd={gitCwd}
-            activeThreadRef={scopeThreadRef(activeThreadEnvironmentId, activeThreadId)}
-            onOpenPullRequest={onOpenPullRequest}
-            {...(draftId ? { draftId } : {})}
+            <span aria-hidden className="text-muted-foreground/40">
+              /
+            </span>
+          </span>
+        ) : null}
+        <Tooltip>
+          <TooltipTrigger
+            render={
+              <h2
+                aria-label={activeThreadTitle}
+                className="min-w-0 flex-1 truncate text-sm font-medium text-foreground"
+              >
+                {activeThreadTitle}
+              </h2>
+            }
           />
-        )}
+          <TooltipPopup side="top">{activeThreadTitle}</TooltipPopup>
+        </Tooltip>
       </div>
     </div>
   );
diff --git a/apps/web/src/components/chat/ComposerActivityStatus.tsx b/apps/web/src/components/chat/ComposerActivityStatus.tsx
index 23de4fcc344a..c2001154fd56 100644
--- a/apps/web/src/components/chat/ComposerActivityStatus.tsx
+++ b/apps/web/src/components/chat/ComposerActivityStatus.tsx
@@ -1,11 +1,15 @@
 import { LoaderCircleIcon } from "lucide-react";
 import { useEffect, useRef } from "react";
+import type { PendingBackgroundWorkTask } from "@t3tools/shared/orchestrationV2PendingBackgroundWork";
 import { threadSyncLabel, type ThreadSyncPhase } from "../../threadSync";
 import { ComposerBanner } from "./ComposerBanner";
+import { Button } from "../ui/button";
+import { Tooltip, TooltipPopup, TooltipTrigger } from "../ui/tooltip";
 
 export type ComposerActivityStatus =
   | { readonly kind: "working"; readonly startedAt: string | null }
-  | { readonly kind: "sync"; readonly phase: ThreadSyncPhase };
+  | { readonly kind: "sync"; readonly phase: ThreadSyncPhase }
+  | { readonly kind: "waiting"; readonly tasks: ReadonlyArray<PendingBackgroundWorkTask> };
 
 export function ComposerActivityIcon({ status }: { readonly status: ComposerActivityStatus }) {
   if (status.kind !== "sync") return null;
@@ -16,18 +20,61 @@ export function ComposerActivityIcon({ status }: { readonly status: ComposerActi
   );
 }
 
-export function ComposerActivityRow({ status }: { readonly status: ComposerActivityStatus }) {
+export function ComposerActivityRow({
+  status,
+  onInterrupt,
+}: {
+  readonly status: ComposerActivityStatus;
+  readonly onInterrupt?: () => void;
+}) {
   return (
     <ComposerBanner.Row>
       <ComposerActivityIcon status={status} />
       <ComposerBanner.Content>
         <ComposerActivityLabel status={status} />
       </ComposerBanner.Content>
+      {status.kind === "waiting" && onInterrupt ? (
+        <ComposerBanner.Actions>
+          <Button size="xs" variant="ghost" onClick={onInterrupt}>
+            Stop
+          </Button>
+        </ComposerBanner.Actions>
+      ) : null}
     </ComposerBanner.Row>
   );
 }
 
 export function ComposerActivityLabel({ status }: { readonly status: ComposerActivityStatus }) {
+  if (status.kind === "waiting") {
+    const label =
+      status.tasks.length === 1
+        ? "Waiting on background task"
+        : `Waiting on ${status.tasks.length} background tasks`;
+    const descriptions = status.tasks.map((task) => task.description || task.taskId);
+    return (
+      <Tooltip>
+        <TooltipTrigger
+          render={
+            <span
+              className="block min-w-0 truncate text-muted-foreground"
+              data-composer-waiting-status="true"
+              tabIndex={0}
+            >
+              {label}: {descriptions.join(", ")}
+            </span>
+          }
+        />
+        <TooltipPopup side="top">
+          {label}
+          <ul className="list-disc pl-4">
+            {status.tasks.map((task) => (
+              <li key={task.taskId}>{task.description || task.taskId}</li>
+            ))}
+          </ul>
+        </TooltipPopup>
+      </Tooltip>
+    );
+  }
   if (status.kind === "sync") {
     return (
       <span
diff --git a/apps/web/src/components/chat/ComposerBanner.tsx b/apps/web/src/components/chat/ComposerBanner.tsx
index 4e7601ec465e..4680309f08ca 100644
--- a/apps/web/src/components/chat/ComposerBanner.tsx
+++ b/apps/web/src/components/chat/ComposerBanner.tsx
@@ -105,10 +105,10 @@ function Attachment({ className, ...props }: ComponentProps<"div">) {
     <div
       data-slot="composer-banner-attachment"
       className={cn(
-        "mx-auto -mb-[calc(1rem+1px)] w-[calc(100%-2.75rem)] max-w-[45.25rem]",
-        // Adjacent attachments share their outline, including notices outside the form.
+        "-mb-[calc(1rem+1px)] w-full",
+        // Adjacent attachments share their outline.
         "[&+[data-slot=composer-banner-attachment]_[data-composer-banner-surface=attached]]:before:rounded-none [&+[data-slot=composer-banner-attachment]_[data-composer-banner-surface=attached]]:before:border-t-0",
-        "[&+:has([data-chat-composer-form])_[data-chat-composer-form]>[data-slot=composer-banner-attachment]:first-child_[data-composer-banner-surface=attached]]:before:rounded-none [&+:has([data-chat-composer-form])_[data-chat-composer-form]>[data-slot=composer-banner-attachment]:first-child_[data-composer-banner-surface=attached]]:before:border-t-0",
+        "not-first:*:data-[composer-banner-width=content]:w-full",
         className,
       )}
       {...props}
@@ -116,10 +116,25 @@ function Attachment({ className, ...props }: ComponentProps<"div">) {
   );
 }
 
+/** Each column keeps its own outline and meets the same composer edge. */
 function Dock({ className, ...props }: ComponentProps<"div">) {
   return (
-    <Attachment
-      className={cn("flex items-end gap-1 *:data-[composer-banner-width=fill]:flex-1", className)}
+    <div
+      data-slot="composer-banner-dock"
+      className={cn(
+        "mx-auto flex w-[calc(100%-2.75rem)] max-w-[calc(var(--chat-content-max-width)-2.75rem)] items-end gap-1",
+        className,
+      )}
+      {...props}
+    />
+  );
+}
+
+function Column({ className, ...props }: ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="composer-banner-column"
+      className={cn("flex min-w-0 flex-1 flex-col empty:hidden", className)}
       {...props}
     />
   );
@@ -314,6 +329,7 @@ export const ComposerBanner = {
   Peek,
   Attachment,
   Dock,
+  Column,
   Root,
   Row,
   Icon,
diff --git a/apps/web/src/components/chat/ComposerPendingApprovalActions.test.tsx b/apps/web/src/components/chat/ComposerPendingApprovalActions.test.tsx
index 16141270f6f4..ff06fe8f2f9b 100644
--- a/apps/web/src/components/chat/ComposerPendingApprovalActions.test.tsx
+++ b/apps/web/src/components/chat/ComposerPendingApprovalActions.test.tsx
@@ -1,4 +1,4 @@
-import { ApprovalRequestId } from "@t3tools/contracts";
+import { RuntimeRequestId } from "@t3tools/contracts";
 import { renderToStaticMarkup } from "react-dom/server";
 import { describe, expect, it } from "vite-plus/test";
 
@@ -8,8 +8,9 @@ describe("ComposerPendingApprovalActions", () => {
   it("states that the persistent approval lasts for this session", () => {
     const markup = renderToStaticMarkup(
       <ComposerPendingApprovalActions
-        requestId={ApprovalRequestId.make("approval-1")}
+        requestId={RuntimeRequestId.make("approval-1")}
         isResponding={false}
+        canRespond
         onRespondToApproval={async () => undefined}
       />,
     );
@@ -25,8 +26,9 @@ describe("ComposerPendingApprovalActions", () => {
   it("shows only the approval choices advertised by an MCP server", () => {
     const markup = renderToStaticMarkup(
       <ComposerPendingApprovalActions
-        requestId={ApprovalRequestId.make("approval-safari")}
+        requestId={RuntimeRequestId.make("approval-safari")}
         isResponding={false}
+        canRespond
         options={[
           { decision: "decline", label: "Decline" },
           { decision: "acceptAlways", label: "Always allow Safari" },
@@ -45,8 +47,9 @@ describe("ComposerPendingApprovalActions", () => {
     const label = "Allow ".repeat(40).trim();
     const markup = renderToStaticMarkup(
       <ComposerPendingApprovalActions
-        requestId={ApprovalRequestId.make("approval-long-label")}
+        requestId={RuntimeRequestId.make("approval-long-label")}
         isResponding={false}
+        canRespond
         options={[{ decision: "acceptAlways", label }]}
         onRespondToApproval={async () => undefined}
       />,
diff --git a/apps/web/src/components/chat/ComposerPendingApprovalActions.tsx b/apps/web/src/components/chat/ComposerPendingApprovalActions.tsx
index 7482f665bd11..db061530b45d 100644
--- a/apps/web/src/components/chat/ComposerPendingApprovalActions.tsx
+++ b/apps/web/src/components/chat/ComposerPendingApprovalActions.tsx
@@ -1,17 +1,18 @@
 import {
-  type ApprovalRequestId,
   type ProviderApprovalDecision,
   type ProviderApprovalOption,
+  type RuntimeRequestId,
 } from "@t3tools/contracts";
 import { memo } from "react";
 import { Button } from "../ui/button";
 
 interface ComposerPendingApprovalActionsProps {
-  requestId: ApprovalRequestId;
+  requestId: RuntimeRequestId;
   isResponding: boolean;
+  canRespond: boolean;
   options?: ReadonlyArray<ProviderApprovalOption> | undefined;
   onRespondToApproval: (
-    requestId: ApprovalRequestId,
+    requestId: RuntimeRequestId,
     decision: ProviderApprovalDecision,
   ) => Promise<unknown>;
 }
@@ -27,6 +28,7 @@ const DEFAULT_APPROVAL_OPTIONS = [
 export const ComposerPendingApprovalActions = memo(function ComposerPendingApprovalActions({
   requestId,
   isResponding,
+  canRespond,
   options = DEFAULT_APPROVAL_OPTIONS,
   onRespondToApproval,
 }: ComposerPendingApprovalActionsProps) {
@@ -44,7 +46,7 @@ export const ComposerPendingApprovalActions = memo(function ComposerPendingAppro
                 ? " text-foreground"
                 : ""
           }`}
-          disabled={isResponding}
+          disabled={isResponding || !canRespond}
           onClick={() => void onRespondToApproval(requestId, option.decision)}
         >
           <span className="max-w-40 truncate">{option.label}</span>
diff --git a/apps/web/src/components/chat/ComposerPendingApprovalPanel.test.tsx b/apps/web/src/components/chat/ComposerPendingApprovalPanel.test.tsx
index a7ef6bc7d5cb..ab9de7ab512b 100644
--- a/apps/web/src/components/chat/ComposerPendingApprovalPanel.test.tsx
+++ b/apps/web/src/components/chat/ComposerPendingApprovalPanel.test.tsx
@@ -1,4 +1,4 @@
-import { ApprovalRequestId } from "@t3tools/contracts";
+import { RuntimeRequestId } from "@t3tools/contracts";
 import { renderToStaticMarkup } from "react-dom/server";
 import { describe, expect, it } from "vite-plus/test";
 
@@ -10,10 +10,11 @@ describe("ComposerPendingApprovalPanel", () => {
     const markup = renderToStaticMarkup(
       <ComposerPendingApprovalPanel
         approval={{
-          requestId: ApprovalRequestId.make("approval-1"),
+          requestId: RuntimeRequestId.make("approval-1"),
           requestKind: "command",
           createdAt: "2026-07-18T00:00:00.000Z",
           detail,
+          responseCapability: "live",
         }}
         pendingCount={1}
       />,
@@ -39,8 +40,9 @@ describe("ComposerPendingApprovalPanel", () => {
     const markup = renderToStaticMarkup(
       <ComposerPendingApprovalPanel
         approval={{
-          requestId: ApprovalRequestId.make("approval-2"),
+          requestId: RuntimeRequestId.make("approval-2"),
           requestKind: "file-read",
+          responseCapability: "live" as const,
           createdAt: "2026-07-18T00:00:00.000Z",
           detail: "",
         }}
@@ -55,8 +57,9 @@ describe("ComposerPendingApprovalPanel", () => {
     const markup = renderToStaticMarkup(
       <ComposerPendingApprovalPanel
         approval={{
-          requestId: ApprovalRequestId.make("approval-safari"),
+          requestId: RuntimeRequestId.make("approval-safari"),
           requestKind: "mcp-elicitation",
+          responseCapability: "live" as const,
           createdAt: "2026-08-24T00:00:00.000Z",
           appName: "Safari",
           detail: "Allow ChatGPT to use Safari?",
@@ -77,8 +80,9 @@ describe("ComposerPendingApprovalPanel", () => {
     const markup = renderToStaticMarkup(
       <ComposerPendingApprovalPanel
         approval={{
-          requestId: ApprovalRequestId.make("approval-long-app-name"),
+          requestId: RuntimeRequestId.make("approval-long-app-name"),
           requestKind: "mcp-elicitation",
+          responseCapability: "live" as const,
           createdAt: "2026-08-24T00:00:00.000Z",
           appName,
           detail,
diff --git a/apps/web/src/components/chat/ComposerPendingApprovalPanel.tsx b/apps/web/src/components/chat/ComposerPendingApprovalPanel.tsx
index deb5ba54c53c..96c5016f5ff4 100644
--- a/apps/web/src/components/chat/ComposerPendingApprovalPanel.tsx
+++ b/apps/web/src/components/chat/ComposerPendingApprovalPanel.tsx
@@ -47,7 +47,9 @@ export const ComposerPendingApprovalPanel = memo(function ComposerPendingApprova
         data-approval-detail="complete"
         tabIndex={0}
       >
-        {approval.detail || fallbackLabel}
+        {approval.responseCapability === "not_resumable"
+          ? "Provider process is gone — interrupt or restart the run to respond."
+          : approval.detail || fallbackLabel}
       </code>
       {pendingCount > 1 ? (
         <span className="shrink-0 text-[10px] font-medium text-muted-foreground tabular-nums">
diff --git a/apps/web/src/components/chat/ComposerPendingUserInputPanel.test.tsx b/apps/web/src/components/chat/ComposerPendingUserInputPanel.test.tsx
index 817182190b79..40da08659fdd 100644
--- a/apps/web/src/components/chat/ComposerPendingUserInputPanel.test.tsx
+++ b/apps/web/src/components/chat/ComposerPendingUserInputPanel.test.tsx
@@ -1,4 +1,4 @@
-import { ApprovalRequestId } from "@t3tools/contracts";
+import { RuntimeRequestId } from "@t3tools/contracts";
 import { renderToStaticMarkup } from "react-dom/server";
 import { describe, expect, it } from "vite-plus/test";
 
@@ -6,7 +6,8 @@ import { ComposerPendingUserInputPanel } from "./ComposerPendingUserInputPanel";
 import type { PendingUserInput } from "../../session-logic";
 
 const prompt: PendingUserInput = {
-  requestId: ApprovalRequestId.make("request-1"),
+  requestId: RuntimeRequestId.make("request-1"),
+  responseCapability: "live" as const,
   createdAt: "2026-08-15T00:00:00.000Z",
   questions: [
     {
diff --git a/apps/web/src/components/chat/ComposerPendingUserInputPanel.tsx b/apps/web/src/components/chat/ComposerPendingUserInputPanel.tsx
index 596fd93a68b7..630bb5b8e7f4 100644
--- a/apps/web/src/components/chat/ComposerPendingUserInputPanel.tsx
+++ b/apps/web/src/components/chat/ComposerPendingUserInputPanel.tsx
@@ -1,4 +1,4 @@
-import { type ApprovalRequestId } from "@t3tools/contracts";
+import { type RuntimeRequestId } from "@t3tools/contracts";
 import { memo, useCallback, useEffect, useRef, useState } from "react";
 import { type PendingUserInput } from "../../session-logic";
 import {
@@ -12,7 +12,7 @@ import { ComposerBanner } from "./ComposerBanner";
 
 interface PendingUserInputPanelProps {
   pendingUserInputs: PendingUserInput[];
-  respondingRequestIds: ApprovalRequestId[];
+  respondingRequestIds: RuntimeRequestId[];
   answers: Record<string, PendingUserInputDraftAnswer>;
   questionIndex: number;
   onToggleOption: (questionId: string, optionLabel: string) => void;
@@ -59,6 +59,11 @@ const ComposerPendingUserInputCard = memo(function ComposerPendingUserInputCard(
   onToggleOption: (questionId: string, optionLabel: string) => void;
   onAdvance: () => void;
 }) {
+  // V2 runtime requests carry response capability: a provider process that has
+  // gone away cannot accept answers, so the card reads read-only until the run
+  // restarts.
+  const canRespond = prompt.responseCapability === "live";
+  const responseDisabled = isResponding || !canRespond;
   const progress = derivePendingUserInputProgress(prompt.questions, answers, questionIndex);
   const activeQuestion = progress.activeQuestion;
   const autoAdvanceTimerRef = useRef<number | null>(null);
@@ -134,7 +139,7 @@ const ComposerPendingUserInputCard = memo(function ComposerPendingUserInputCard(
   // select prompts keep the existing auto-advance behavior. Collapsed prompts opt
   // out, since the numbers they refer to are not on screen.
   useEffect(() => {
-    if (!activeQuestion || isResponding || isCollapsed) return;
+    if (!activeQuestion || responseDisabled || isCollapsed) return;
     const handler = (event: globalThis.KeyboardEvent) => {
       if (event.metaKey || event.ctrlKey || event.altKey) return;
       const target = event.target;
@@ -158,7 +163,7 @@ const ComposerPendingUserInputCard = memo(function ComposerPendingUserInputCard(
     };
     document.addEventListener("keydown", handler);
     return () => document.removeEventListener("keydown", handler);
-  }, [activeQuestion, handleOptionSelection, isCollapsed, isResponding]);
+  }, [activeQuestion, handleOptionSelection, isCollapsed, responseDisabled]);
 
   if (!activeQuestion) {
     return null;
diff --git a/apps/web/src/components/chat/ComposerPrimaryActions.test.tsx b/apps/web/src/components/chat/ComposerPrimaryActions.test.tsx
index d180f2c699c3..a7450b594d47 100644
--- a/apps/web/src/components/chat/ComposerPrimaryActions.test.tsx
+++ b/apps/web/src/components/chat/ComposerPrimaryActions.test.tsx
@@ -65,28 +65,6 @@ function renderStandaloneStop() {
   );
 }
 
-function renderRunningActions(showSendWhileRunning: boolean, hasSendableContent: boolean) {
-  return renderToStaticMarkup(
-    createElement(ComposerPrimaryActions, {
-      compact: true,
-      pendingAction: null,
-      isRunning: true,
-      showPlanFollowUpPrompt: false,
-      promptHasText: hasSendableContent,
-      isSendBusy: false,
-      sendDisabledReason: null,
-      isConnecting: false,
-      isEnvironmentUnavailable: false,
-      isPreparingWorktree: false,
-      hasSendableContent,
-      showSendWhileRunning,
-      onPreviousPendingQuestion: () => {},
-      onInterrupt: () => {},
-      onImplementPlanInNewThread: () => {},
-    }),
-  );
-}
-
 function renderSendButton(sendDisabledReason: string | null = null) {
   return renderToStaticMarkup(
     createElement(ComposerPrimaryActions, {
@@ -244,27 +222,4 @@ describe("ComposerPrimaryActions", () => {
     expect(markup).not.toContain("stage-nightly");
     expect(markup).toContain("bg-message-action text-message-action-foreground");
   });
-
-  it("only renders stop while running when Enter-to-send is available", () => {
-    const markup = renderRunningActions(false, true);
-
-    expect(markup).toContain('aria-label="Stop generation"');
-    expect(markup).not.toContain('aria-label="Send message"');
-  });
-
-  it("renders send alongside stop while running when Enter-to-send is unavailable", () => {
-    const markup = renderRunningActions(true, true);
-
-    expect(markup).toContain('aria-label="Stop generation"');
-    expect(markup).toContain('aria-label="Send message"');
-    expect(markup).toContain('type="submit"');
-    expect(markup).toContain("size-9 sm:size-8");
-  });
-
-  it("keeps stop as the only action while running with an empty composer", () => {
-    const markup = renderRunningActions(true, false);
-
-    expect(markup).toContain('aria-label="Stop generation"');
-    expect(markup).not.toContain('aria-label="Send message"');
-  });
 });
diff --git a/apps/web/src/components/chat/ComposerPrimaryActions.tsx b/apps/web/src/components/chat/ComposerPrimaryActions.tsx
index 2a27796d92a5..e98b1930e09f 100644
--- a/apps/web/src/components/chat/ComposerPrimaryActions.tsx
+++ b/apps/web/src/components/chat/ComposerPrimaryActions.tsx
@@ -1,11 +1,19 @@
-import { memo, type PointerEventHandler } from "react";
-import { ChevronDownIcon, ChevronLeftIcon } from "lucide-react";
+import { memo, type MouseEventHandler, type PointerEventHandler } from "react";
+import {
+  CheckIcon,
+  ChevronDownIcon,
+  ChevronLeftIcon,
+  CornerUpRightIcon,
+  ListPlusIcon,
+} from "lucide-react";
 import { useEnvironmentIdentificationMode } from "~/hooks/useSettings";
 import { cn } from "~/lib/utils";
+import { useShortcutModifierState } from "../../shortcutModifierState";
 import { StageBackdropButtonArt, useSidebarStageBackdropVariant } from "../SidebarStageBackdrop";
 import { Button } from "../ui/button";
 import { Menu, MenuItem, MenuPopup, MenuTrigger } from "../ui/menu";
 import { Spinner } from "../ui/spinner";
+import { Tooltip, TooltipPopup, TooltipTrigger } from "../ui/tooltip";
 
 interface PendingActionState {
   questionIndex: number;
@@ -28,9 +36,8 @@ interface ComposerPrimaryActionsProps {
   isPreparingWorktree: boolean;
   hasSendableContent: boolean;
   preserveComposerFocusOnPointerDown?: boolean;
-  /** Enter-to-send is disabled on mobile viewports, where stop would otherwise
-   * be the only primary action and a running turn could not be steered. */
-  showSendWhileRunning?: boolean;
+  isEditingQueuedMessage?: boolean;
+  onSubmitMessage?: MouseEventHandler<HTMLButtonElement>;
   onPreviousPendingQuestion: () => void;
   onInterrupt: () => void;
   onImplementPlanInNewThread: () => void;
@@ -71,7 +78,8 @@ export const ComposerPrimaryActions = memo(function ComposerPrimaryActions({
   isPreparingWorktree,
   hasSendableContent,
   preserveComposerFocusOnPointerDown = false,
-  showSendWhileRunning = false,
+  isEditingQueuedMessage = false,
+  onSubmitMessage,
   onPreviousPendingQuestion,
   onInterrupt,
   onImplementPlanInNewThread,
@@ -80,30 +88,38 @@ export const ComposerPrimaryActions = memo(function ComposerPrimaryActions({
     ? { onPointerDown: preventPointerFocus }
     : undefined;
   const environmentIdentificationMode = useEnvironmentIdentificationMode();
+  const shortcutModifiers = useShortcutModifierState();
+  const isQueuing =
+    isRunning &&
+    !isEditingQueuedMessage &&
+    (shortcutModifiers.metaKey || shortcutModifiers.ctrlKey);
   const isSendDisabled = sendDisabledReason !== null;
   const stageBackdropVariant = useSidebarStageBackdropVariant(
     environmentIdentificationMode === "artwork",
   );
 
   const renderStopGenerationButton = (insidePendingAction: boolean) => (
-    <button
-      type="button"
-      className={cn(
-        "flex cursor-pointer items-center justify-center rounded-full bg-destructive/90 text-white shadow-xs shadow-destructive/24 inset-shadow-[0_1px_--theme(--color-white/16%)] transition-all duration-150 hover:bg-destructive hover:scale-105 active:inset-shadow-[0_1px_--theme(--color-black/8%)] active:shadow-none",
-        insidePendingAction
-          ? "size-8 sm:size-7"
-          : showSendWhileRunning && hasSendableContent
-            ? "size-9 sm:size-8"
-            : "size-8 sm:h-8 sm:w-8",
-      )}
-      {...pointerFocusProps}
-      onClick={onInterrupt}
-      aria-label="Stop generation"
-    >
-      <svg width="12" height="12" viewBox="0 0 12 12" fill="currentColor" aria-hidden="true">
-        <rect x="2" y="2" width="8" height="8" rx="1.5" />
-      </svg>
-    </button>
+    <Tooltip key="interrupt">
+      <TooltipTrigger
+        render={
+          <button
+            type="button"
+            className={cn(
+              "flex cursor-pointer items-center justify-center rounded-full bg-destructive/90 text-white shadow-xs shadow-destructive/24 inset-shadow-[0_1px_--theme(--color-white/16%)] transition-all duration-150 hover:bg-destructive hover:scale-105 active:inset-shadow-[0_1px_--theme(--color-black/8%)] active:shadow-none [&_svg]:pointer-events-none",
+              insidePendingAction ? "size-8 sm:size-7" : "size-8 sm:h-8 sm:w-8",
+            )}
+            {...pointerFocusProps}
+            onClick={onInterrupt}
+            aria-label="Stop generation"
+          />
+        }
+      >
+        <svg width="12" height="12" viewBox="0 0 12 12" fill="currentColor" aria-hidden="true">
+          <rect x="2" y="2" width="8" height="8" rx="1.5" />
+        </svg>
+      </TooltipTrigger>
+      <TooltipPopup>Interrupt</TooltipPopup>
+    </Tooltip>
   );
 
   if (pendingAction) {
@@ -218,16 +234,44 @@ export const ComposerPrimaryActions = memo(function ComposerPrimaryActions({
     );
   }
 
+  if (isRunning && !hasSendableContent && !isEditingQueuedMessage) {
+    return renderStopGenerationButton(false);
+  }
+
+  const submitLabel = isEditingQueuedMessage
+    ? "Update queued message"
+    : isQueuing
+      ? "Queue message"
+      : isRunning
+        ? "Steer message"
+        : "Submit message";
+  const submitStatus = isEnvironmentUnavailable
+    ? "Environment disconnected"
+    : (sendDisabledReason ??
+      (isConnecting
+        ? "Connecting"
+        : isPreparingWorktree
+          ? "Preparing worktree"
+          : isSendBusy
+            ? isEditingQueuedMessage
+              ? "Updating queued message"
+              : "Submitting message"
+            : null));
+  const submitTooltip =
+    submitStatus ??
+    (isRunning && !isEditingQueuedMessage ? "Enter to steer, Mod+Enter to queue" : submitLabel);
+
   const sendButton = (
     <button
       type="submit"
       className={cn(
-        "relative isolate flex h-9 w-9 items-center justify-center overflow-hidden rounded-full shadow-xs transition-all duration-150 enabled:cursor-pointer enabled:inset-shadow-[0_1px_--theme(--color-white/16%)] hover:scale-105 active:inset-shadow-[0_1px_--theme(--color-black/8%)] active:shadow-none disabled:pointer-events-none disabled:opacity-30 disabled:shadow-none disabled:hover:scale-100 sm:h-8 sm:w-8",
+        "relative isolate flex h-9 w-9 items-center justify-center overflow-hidden rounded-full shadow-xs transition-all duration-150 enabled:cursor-pointer enabled:inset-shadow-[0_1px_--theme(--color-white/16%)] hover:scale-105 active:inset-shadow-[0_1px_--theme(--color-black/8%)] active:shadow-none disabled:pointer-events-none disabled:opacity-30 disabled:shadow-none disabled:hover:scale-100 sm:h-8 sm:w-8 [&_svg]:pointer-events-none",
         stageBackdropVariant
           ? "bg-transparent text-white enabled:shadow-black/24 enabled:hover:brightness-110"
           : "bg-message-action text-message-action-foreground enabled:shadow-message-action/24 hover:bg-message-action-hover",
       )}
       {...pointerFocusProps}
+      onClick={onSubmitMessage}
       disabled={
         isSendBusy ||
         isSendDisabled ||
@@ -235,27 +279,21 @@ export const ComposerPrimaryActions = memo(function ComposerPrimaryActions({
         isEnvironmentUnavailable ||
         !hasSendableContent
       }
-      aria-label={
-        isEnvironmentUnavailable
-          ? "Environment disconnected"
-          : sendDisabledReason
-            ? sendDisabledReason
-            : isConnecting
-              ? "Connecting"
-              : isPreparingWorktree
-                ? "Preparing worktree"
-                : isSendBusy
-                  ? "Sending"
-                  : "Send message"
-      }
+      aria-label={submitStatus ?? submitLabel}
     >
       {stageBackdropVariant ? (
-        <span className="absolute inset-0 -z-10" aria-hidden="true">
+        <span className="pointer-events-none absolute inset-0 -z-10" aria-hidden="true">
           <StageBackdropButtonArt variant={stageBackdropVariant} />
         </span>
       ) : null}
       {isConnecting || isSendBusy ? (
         <Spinner className="size-3.5" aria-hidden="true" />
+      ) : isEditingQueuedMessage ? (
+        <CheckIcon className="size-4" aria-hidden="true" />
+      ) : isQueuing ? (
+        <ListPlusIcon className="size-4" aria-hidden="true" />
+      ) : isRunning ? (
+        <CornerUpRightIcon className="size-4" aria-hidden="true" />
       ) : (
         <svg width="14" height="14" viewBox="0 0 14 14" fill="none" aria-hidden="true">
           <path
@@ -270,14 +308,10 @@ export const ComposerPrimaryActions = memo(function ComposerPrimaryActions({
     </button>
   );
 
-  if (!isRunning) {
-    return sendButton;
-  }
-
   return (
-    <>
-      {renderStopGenerationButton(false)}
-      {showSendWhileRunning && hasSendableContent ? sendButton : null}
-    </>
+    <Tooltip key="submit">
+      <TooltipTrigger render={<span className="inline-flex" />}>{sendButton}</TooltipTrigger>
+      <TooltipPopup>{submitTooltip}</TooltipPopup>
+    </Tooltip>
   );
 });
diff --git a/apps/web/src/components/chat/ComposerStashMenu.tsx b/apps/web/src/components/chat/ComposerStashMenu.tsx
index d769c9823ab8..647faa1d5c76 100644
--- a/apps/web/src/components/chat/ComposerStashMenu.tsx
+++ b/apps/web/src/components/chat/ComposerStashMenu.tsx
@@ -48,7 +48,7 @@ export const ComposerStashMenu = memo(function ComposerStashMenu(props: {
   const highlightedEntry = entries.find((entry) => entry.id === highlightedId) ?? entries[0];
 
   useEffect(() => {
-    const closeOnOutsidePointer = (event: PointerEvent) => {
+    const closeOnOutsideClick = (event: MouseEvent) => {
       const drawer = drawerRef.current;
       if (
         (drawer && event.composedPath().includes(drawer)) ||
@@ -59,8 +59,10 @@ export const ComposerStashMenu = memo(function ComposerStashMenu(props: {
       }
       onClose();
     };
-    document.addEventListener("pointerdown", closeOnOutsidePointer, true);
-    return () => document.removeEventListener("pointerdown", closeOnOutsidePointer, true);
+    // Finish the clicked control's action before closing this in-flow attachment
+    // moves the other composer controls under the pointer.
+    document.addEventListener("click", closeOnOutsideClick);
+    return () => document.removeEventListener("click", closeOnOutsideClick);
   }, [onClose]);
 
   useEffect(() => {
diff --git a/apps/web/src/components/chat/ComposerSurface.tsx b/apps/web/src/components/chat/ComposerSurface.tsx
index 80a9a6c2d5d4..c960db6957bd 100644
--- a/apps/web/src/components/chat/ComposerSurface.tsx
+++ b/apps/web/src/components/chat/ComposerSurface.tsx
@@ -13,7 +13,7 @@ function Shell({
       data-slot="composer-shell"
       data-with-context={contextStrip || undefined}
       className={cn(
-        "group/composer-surface relative isolate mx-auto w-full max-w-3xl",
+        "group/composer-surface relative isolate mx-auto w-full max-w-(--chat-content-max-width)",
         "[--chat-composer-glass-surface:var(--card)] [--chat-composer-outline:rgb(0_0_0/8%)]",
         "dark:[--chat-composer-glass-surface:color-mix(in_srgb,var(--background)_96%,var(--color-white))] dark:[--chat-composer-highlight:rgb(255_255_255/3%)] dark:[--chat-composer-outline:color-mix(in_srgb,var(--color-white)_5%,transparent)]",
         "[html[data-theme-id]_&]:[--chat-composer-glass-surface:var(--app-theme-surface-raised)] [html[data-theme-id]_&]:[--chat-composer-outline:var(--app-theme-toolbar-border)]",
@@ -84,7 +84,7 @@ function ContextStrip({ className, ...props }: ComponentProps<"div">) {
     <div
       data-slot="composer-context-strip"
       className={cn(
-        "group/composer-context relative isolate mx-auto -mt-4 flex w-[calc(100%-2.75rem)] max-w-181 items-center gap-2 overflow-x-clip overflow-y-visible ps-1 pe-2 pt-5 pb-1",
+        "group/composer-context relative isolate mx-auto -mt-4 flex w-[calc(100%-2.75rem)] max-w-[calc(var(--chat-content-max-width)-2.75rem)] items-center gap-2 overflow-x-clip overflow-y-visible ps-1 pe-2 pt-5 pb-1",
         "before:absolute before:inset-0 before:-z-1 before:rounded-b-[16px] before:border before:border-(--chat-composer-outline) before:mask-[linear-gradient(to_bottom,transparent_0_1rem,black_1rem)] before:shadow-[0_12px_28px_-18px_rgb(0_0_0/40%)]",
         "dark:before:border-white/7 dark:before:bg-[linear-gradient(to_bottom,transparent_0_1rem,rgb(0_0_0/18%)_1rem,transparent_calc(1rem+10px)),linear-gradient(rgb(255_255_255/2%),rgb(255_255_255/2%))] dark:before:shadow-[0_14px_32px_-18px_rgb(0_0_0/75%)]",
         "group-has-data-[composer-banner-surface=attached]/composer-surface:before:bg-[color-mix(in_srgb,var(--chat-composer-glass-surface)_var(--glass-opacity),transparent)] group-has-data-[composer-banner-surface=attached]/composer-surface:before:backdrop-blur-(--glass-blur) group-has-data-[composer-banner-surface=attached]/composer-surface:before:backdrop-saturate-(--glass-saturation)",
diff --git a/apps/web/src/components/chat/ContextWindowMeter.test.tsx b/apps/web/src/components/chat/ContextWindowMeter.test.tsx
deleted file mode 100644
index 90617ca63af1..000000000000
--- a/apps/web/src/components/chat/ContextWindowMeter.test.tsx
+++ /dev/null
@@ -1,62 +0,0 @@
-import { EventId, TurnId } from "@t3tools/contracts";
-import type { ReactNode } from "react";
-import { renderToStaticMarkup } from "react-dom/server";
-import { describe, expect, it, vi } from "vite-plus/test";
-
-import { deriveLatestContextWindowSnapshot } from "~/lib/contextWindow";
-import { ContextWindowMeter } from "./ContextWindowMeter";
-
-vi.mock("../ui/popover", () => ({
-  Popover: ({ children }: { children: ReactNode }) => children,
-  PopoverPopup: ({ children }: { children: ReactNode }) => children,
-  PopoverTrigger: ({ closeDelay, render }: { closeDelay: number; render: ReactNode }) => (
-    <div data-close-delay={closeDelay}>{render}</div>
-  ),
-}));
-
-const usage = deriveLatestContextWindowSnapshot([
-  {
-    id: EventId.make("activity-1"),
-    tone: "info",
-    kind: "context-window.updated",
-    summary: "Context updated",
-    payload: { usedTokens: 100_000, maxTokens: 1_000_000 },
-    turnId: TurnId.make("turn-1"),
-    createdAt: "2026-08-24T12:00:00.000Z",
-  },
-]);
-
-if (!usage) {
-  throw new Error("The context window test fixture did not produce a snapshot.");
-}
-
-describe("ContextWindowMeter", () => {
-  it("keeps the hover popover open while the pointer moves to the compact button", () => {
-    const markup = renderToStaticMarkup(<ContextWindowMeter usage={usage} onCompact={() => {}} />);
-
-    expect(markup).toContain('data-close-delay="150"');
-    expect(markup).toContain("Compact context");
-  });
-
-  it("closes an informational hover popover without delay", () => {
-    const markup = renderToStaticMarkup(<ContextWindowMeter usage={usage} />);
-
-    expect(markup).toContain('data-close-delay="0"');
-    expect(markup).not.toContain("Compact context");
-  });
-
-  it("explains why the compact action is disabled", () => {
-    const markup = renderToStaticMarkup(
-      <ContextWindowMeter
-        usage={usage}
-        onCompact={() => {}}
-        compactDisabled
-        compactDisabledReason="Send or clear your draft before compacting"
-      />,
-    );
-
-    expect(markup).toContain('disabled=""');
-    expect(markup).toContain(">Send or clear your draft before compacting<");
-    expect(markup).not.toContain('aria-label="Send or clear your draft before compacting"');
-  });
-});
diff --git a/apps/web/src/components/chat/MessagesTimeline.logic.test.ts b/apps/web/src/components/chat/MessagesTimeline.logic.test.ts
index bd6ffffe15dc..e897d44e7e2f 100644
--- a/apps/web/src/components/chat/MessagesTimeline.logic.test.ts
+++ b/apps/web/src/components/chat/MessagesTimeline.logic.test.ts
@@ -1,13 +1,134 @@
 import { describe, expect, it } from "vite-plus/test";
+import { RunId, ThreadId, TurnItemId } from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+import type { WorkLogEntry } from "../../session-logic";
 import {
   computeStableMessagesTimelineRows,
   computeMessageDurationStart,
   deriveMessagesTimelineRows,
   normalizeCompactToolLabel,
   resolveAssistantMessageCopyState,
+  resolveTimelineToolPresentation,
   shouldPreserveAssistantLineBreaks,
+  summarizeToolGroup,
 } from "./MessagesTimeline.logic";
 
+describe("summarizeToolGroup", () => {
+  const now = DateTime.makeUnsafe("2026-08-29T00:00:00Z");
+  function work(overrides: Partial<WorkLogEntry> = {}): WorkLogEntry {
+    return {
+      id: "tool",
+      createdAt: "2026-08-29T00:00:00Z",
+      label: "Tool call",
+      tone: "tool",
+      toolLifecycleStatus: "completed",
+      ...overrides,
+    };
+  }
+  function t3(toolName: string, input: unknown = {}, output: unknown = {}): WorkLogEntry {
+    return work({
+      itemType: "dynamic_tool",
+      toolTitle: "Friendly display name",
+      structuredPayload: {
+        id: TurnItemId.make("tool"),
+        threadId: ThreadId.make("parent"),
+        runId: RunId.make("run"),
+        nodeId: null,
+        providerThreadId: null,
+        providerTurnId: null,
+        nativeItemRef: null,
+        parentItemId: null,
+        ordinal: 0,
+        status: "completed",
+        title: "Friendly display name",
+        startedAt: now,
+        completedAt: now,
+        updatedAt: now,
+        type: "dynamic_tool",
+        toolName,
+        input,
+        output,
+      },
+    });
+  }
+
+  it("summarizes commands and thread messages using canonical names despite humanized titles", () => {
+    const entries = [
+      work({ command: "git diff" }),
+      ...["mcp__t3-code__t3_thread_send", "t3_code.t3_thread_send", "t3_thread_send"].map(
+        (toolName, i) =>
+          t3(
+            toolName,
+            { threadId: `thread-${i}` },
+            { messageId: `message-${i}`, threadId: `thread-${i}` },
+          ),
+      ),
+      work({ command: "git status" }),
+    ];
+    expect(summarizeToolGroup(entries)).toEqual({
+      summary: "Ran 2 commands and sent messages to 3 threads",
+      hasFailure: false,
+    });
+  });
+
+  it("prioritizes actions over polling, caps the clauses, and retains an omitted failure", () => {
+    const status = t3("task_status", { taskId: "task-1" }, { taskId: "task-1", status: "running" });
+    expect(
+      summarizeToolGroup([
+        status,
+        status,
+        status,
+        work({ command: "git diff" }),
+        t3(
+          "t3_thread_send",
+          { threadId: "thread-1" },
+          { threadId: "thread-1", messageId: "message-1" },
+        ),
+        t3(
+          "schedule_task",
+          {},
+          { isError: true, content: [{ type: "text", text: "Schedule rejected" }] },
+        ),
+        status,
+      ]),
+    ).toEqual({
+      summary:
+        "1 failed · Ran 1 command, sent 1 message to 1 thread, and performed 5 other actions",
+      hasFailure: true,
+    });
+  });
+
+  it("counts status checks without treating the reported child failure as a failed tool", () => {
+    const status = {
+      ...t3("task_status", { taskId: "task-1" }, { taskId: "task-1", status: "failed" }),
+      detail: "Child failed: command not found",
+    };
+    expect(
+      summarizeToolGroup([
+        t3("delegate_task", {}, { taskId: "task-1" }),
+        t3("delegate_task", {}, { taskId: "task-2" }),
+        status,
+        status,
+        status,
+        status,
+      ]),
+    ).toEqual({
+      summary: "Delegated 2 tasks and checked task status 4 times",
+      hasFailure: false,
+    });
+  });
+
+  it("leaves foreign, unknown, and preview tools generic instead of guessing from display titles", () => {
+    expect(
+      summarizeToolGroup([
+        { ...t3("mcp__github__t3_thread_send"), toolTitle: "t3-code.t3_thread_send" },
+        t3("t3-code.future_tool"),
+        t3("t3-code.preview_snapshot"),
+      ]),
+    ).toEqual({ summary: "Used 3 tools", hasFailure: false });
+  });
+});
+
 describe("shouldPreserveAssistantLineBreaks", () => {
   it("preserves Claude insight formatting without changing regular markdown", () => {
     expect(
@@ -218,6 +339,33 @@ describe("normalizeCompactToolLabel", () => {
   });
 });
 
+describe("resolveTimelineToolPresentation", () => {
+  it("pretty prints Claude and Cursor T3 MCP tool names", () => {
+    expect(resolveTimelineToolPresentation("mcp__t3-code__t3_thread_read")).toEqual({
+      displayName: "Read a T3 thread",
+      logo: "t3-code",
+    });
+  });
+
+  it("pretty prints Codex T3 MCP tool names", () => {
+    expect(resolveTimelineToolPresentation("t3-code.create_threads")).toEqual({
+      displayName: "Create T3 threads",
+      logo: "t3-code",
+    });
+  });
+
+  it("pretty prints bare T3 MCP toolkit names", () => {
+    expect(resolveTimelineToolPresentation("list_scheduled_tasks")).toEqual({
+      displayName: "List scheduled tasks",
+      logo: "t3-code",
+    });
+  });
+
+  it("keeps unknown MCP tools on the generic renderer path", () => {
+    expect(resolveTimelineToolPresentation("mcp__github__search_issues")).toBeNull();
+  });
+});
+
 describe("resolveAssistantMessageCopyState", () => {
   it("returns enabled copy state for completed assistant messages", () => {
     expect(
@@ -284,7 +432,7 @@ describe("deriveMessagesTimelineRows", () => {
             id: "user-1" as never,
             role: "user",
             text: "Write a poem",
-            turnId: null,
+            runId: null,
             createdAt: "2026-01-01T00:00:00Z",
             updatedAt: "2026-01-01T00:00:00Z",
             streaming: false,
@@ -298,7 +446,7 @@ describe("deriveMessagesTimelineRows", () => {
             id: "assistant-thought" as never,
             role: "assistant",
             text: "I should ground this first.",
-            turnId: "turn-1" as never,
+            runId: "turn-1" as never,
             createdAt: "2026-01-01T00:00:10Z",
             updatedAt: "2026-01-01T00:00:11Z",
             streaming: false,
@@ -312,14 +460,14 @@ describe("deriveMessagesTimelineRows", () => {
             id: "assistant-final" as never,
             role: "assistant",
             text: "Here is the poem.",
-            turnId: "turn-1" as never,
+            runId: "turn-1" as never,
             createdAt: "2026-01-01T00:00:20Z",
             updatedAt: "2026-01-01T00:00:30Z",
             streaming: false,
           },
         },
       ],
-      expandedTurnIds: new Set(["turn-1" as never]),
+      expandedRunIds: new Set(["turn-1" as never]),
       isWorking: false,
       turnDiffSummaryByAssistantMessageId: new Map(),
       revertTurnCountByUserMessageId: new Map(),
@@ -346,7 +494,7 @@ describe("deriveMessagesTimelineRows", () => {
             id: "assistant-one" as never,
             role: "assistant",
             text: "Earlier response.",
-            turnId: "turn-1" as never,
+            runId: "turn-1" as never,
             createdAt: "2026-01-01T00:00:10Z",
             updatedAt: "2026-01-01T00:00:11Z",
             streaming: false,
@@ -360,16 +508,16 @@ describe("deriveMessagesTimelineRows", () => {
             id: "assistant-two" as never,
             role: "assistant",
             text: "Active response.",
-            turnId: "turn-2" as never,
+            runId: "turn-2" as never,
             createdAt: "2026-01-01T00:00:20Z",
             updatedAt: "2026-01-01T00:00:30Z",
             streaming: false,
           },
         },
       ],
-      latestTurn: {
-        turnId: "turn-2" as never,
-        state: "running",
+      latestRun: {
+        runId: "turn-2" as never,
+        status: "running",
         startedAt: "2026-01-01T00:00:19Z",
         completedAt: null,
       },
@@ -389,7 +537,7 @@ describe("deriveMessagesTimelineRows", () => {
 
   it("projects assistant diff summaries and user revert counts onto the affected rows", () => {
     const assistantTurnDiffSummary = {
-      turnId: "turn-1" as never,
+      runId: "turn-1" as never,
       completedAt: "2026-01-01T00:00:30Z",
       assistantMessageId: "assistant-1" as never,
       checkpointTurnCount: 2,
@@ -408,7 +556,7 @@ describe("deriveMessagesTimelineRows", () => {
             id: "user-1" as never,
             role: "user",
             text: "Do the thing",
-            turnId: null,
+            runId: null,
             createdAt: "2026-01-01T00:00:00Z",
             updatedAt: "2026-01-01T00:00:00Z",
             streaming: false,
@@ -422,7 +570,7 @@ describe("deriveMessagesTimelineRows", () => {
             id: "assistant-1" as never,
             role: "assistant",
             text: "Done",
-            turnId: "turn-1" as never,
+            runId: "turn-1" as never,
             createdAt: "2026-01-01T00:00:20Z",
             updatedAt: "2026-01-01T00:00:30Z",
             streaming: false,
@@ -449,7 +597,7 @@ describe("deriveMessagesTimelineRows", () => {
     expect(assistantRow?.assistantTurnDiffSummary).toBe(assistantTurnDiffSummary);
   });
 
-  it("keeps the first and terminal assistant messages visible around settled work", () => {
+  it("folds settled-turn commentary and work behind a Worked-for row", () => {
     const timelineEntries = [
       {
         id: "user-entry",
@@ -459,21 +607,21 @@ describe("deriveMessagesTimelineRows", () => {
           id: "user-1" as never,
           role: "user" as const,
           text: "Build it",
-          turnId: null,
+          runId: null,
           createdAt: "2026-01-01T00:00:00Z",
           updatedAt: "2026-01-01T00:00:00Z",
           streaming: false,
         },
       },
       {
-        id: "assistant-first-entry",
+        id: "assistant-thought-entry",
         kind: "message" as const,
         createdAt: "2026-01-01T00:00:05Z",
         message: {
-          id: "assistant-first" as never,
+          id: "assistant-thought" as never,
           role: "assistant" as const,
-          text: "Synthetic deployment checklist\n1. Confirm the deployment is ready.",
-          turnId: "turn-1" as never,
+          text: "Looking around first.",
+          runId: "turn-1" as never,
           createdAt: "2026-01-01T00:00:05Z",
           updatedAt: "2026-01-01T00:00:06Z",
           streaming: false,
@@ -486,11 +634,35 @@ describe("deriveMessagesTimelineRows", () => {
         entry: {
           id: "work-1",
           createdAt: "2026-01-01T00:00:08Z",
-          turnId: "turn-1" as never,
+          runId: "turn-1" as never,
           label: "Ran command",
           tone: "tool" as const,
         },
       },
+      {
+        id: "provider-recovered-entry",
+        kind: "work" as const,
+        createdAt: "2026-01-01T00:00:09Z",
+        entry: {
+          id: "provider-recovered",
+          createdAt: "2026-01-01T00:00:09Z",
+          runId: "turn-1" as never,
+          label: "Provider recovered (2/5 retries)",
+          tone: "info" as const,
+          itemType: "error" as const,
+          toolLifecycleStatus: "completed" as const,
+        },
+      },
+      {
+        id: "thread-created-entry",
+        kind: "event" as const,
+        createdAt: "2026-01-01T00:00:10Z",
+        projectedItem: {
+          item: {
+            type: "thread_created",
+          },
+        } as never,
+      },
       {
         id: "assistant-final-entry",
         kind: "message" as const,
@@ -499,7 +671,7 @@ describe("deriveMessagesTimelineRows", () => {
           id: "assistant-final" as never,
           role: "assistant" as const,
           text: "Done",
-          turnId: "turn-1" as never,
+          runId: "turn-1" as never,
           createdAt: "2026-01-01T00:00:20Z",
           updatedAt: "2026-01-01T00:00:22Z",
           streaming: false,
@@ -518,20 +690,20 @@ describe("deriveMessagesTimelineRows", () => {
       (row): row is Extract<(typeof collapsedRows)[number], { kind: "turn-fold" }> =>
         row.kind === "turn-fold",
     );
-    expect(foldRow?.turnId).toBe("turn-1");
+    expect(foldRow?.runId).toBe("turn-1");
     expect(foldRow?.expanded).toBe(false);
     // User message boundary (00:00:00) → terminal message updatedAt (00:00:22).
     expect(foldRow?.label).toBe("Worked for 22s");
     expect(collapsedRows.map((row) => row.id)).toEqual([
       "user-entry",
-      "assistant-first-entry",
       "turn-fold:turn-1",
+      "thread-created-entry",
       "assistant-final-entry",
     ]);
 
     const expandedRows = deriveMessagesTimelineRows({
       timelineEntries,
-      expandedTurnIds: new Set(["turn-1" as never]),
+      expandedRunIds: new Set(["turn-1" as never]),
       isWorking: false,
       turnDiffSummaryByAssistantMessageId: new Map(),
       revertTurnCountByUserMessageId: new Map(),
@@ -539,76 +711,252 @@ describe("deriveMessagesTimelineRows", () => {
 
     expect(expandedRows.map((row) => row.id)).toEqual([
       "user-entry",
-      "assistant-first-entry",
       "turn-fold:turn-1",
+      "assistant-thought-entry",
       "work-toggle:work-entry-1",
+      "thread-created-entry",
       "assistant-final-entry",
     ]);
     expect(
       expandedRows.find((row) => row.kind === "turn-fold" && row.expanded === true),
     ).toBeDefined();
+    const openedActivity = deriveMessagesTimelineRows({
+      timelineEntries,
+      expandedRunIds: new Set(["turn-1" as never]),
+      expandedWorkGroupIds: new Set(["work-group:work-entry-1"]),
+      isWorking: false,
+      turnDiffSummaryByAssistantMessageId: new Map(),
+      revertTurnCountByUserMessageId: new Map(),
+    });
+    // Expanding the activity preserves the recovery detail; neutral lifecycle markers stay hidden.
+    const expandedWork = openedActivity.find((row) => row.kind === "work");
+    expect(expandedWork?.kind === "work" ? expandedWork.groupedEntries : []).toEqual([
+      expect.objectContaining({ id: "provider-recovered" }),
+    ]);
   });
 
-  it("folds assistant messages between the first and terminal messages", () => {
+  it("keeps persistent cards after the Worked-for row when they arrive before commentary", () => {
     const timelineEntries = [
       {
-        id: "assistant-first-entry",
+        id: "user-entry",
         kind: "message" as const,
-        createdAt: "2026-01-01T00:00:01Z",
+        createdAt: "2026-01-01T00:00:00Z",
         message: {
-          id: "assistant-first" as never,
-          role: "assistant" as const,
-          text: "The main result is ready.",
-          turnId: "turn-1" as never,
-          createdAt: "2026-01-01T00:00:01Z",
-          updatedAt: "2026-01-01T00:00:02Z",
+          id: "user-1" as never,
+          role: "user" as const,
+          text: "Spawn a subagent",
+          runId: null,
+          createdAt: "2026-01-01T00:00:00Z",
+          updatedAt: "2026-01-01T00:00:00Z",
           streaming: false,
         },
       },
       {
-        id: "assistant-middle-entry",
-        kind: "message" as const,
+        id: "subagent-card-entry",
+        kind: "event" as const,
         createdAt: "2026-01-01T00:00:03Z",
+        projectedItem: {
+          item: {
+            type: "subagent",
+            runId: "turn-1",
+          },
+        } as never,
+      },
+      {
+        id: "assistant-commentary-entry",
+        kind: "message" as const,
+        createdAt: "2026-01-01T00:00:05Z",
         message: {
-          id: "assistant-middle" as never,
+          id: "assistant-commentary" as never,
           role: "assistant" as const,
-          text: "I am checking one more detail.",
-          turnId: "turn-1" as never,
-          createdAt: "2026-01-01T00:00:03Z",
-          updatedAt: "2026-01-01T00:00:04Z",
+          text: "I spawned the subagent.",
+          runId: "turn-1" as never,
+          createdAt: "2026-01-01T00:00:05Z",
+          updatedAt: "2026-01-01T00:00:06Z",
           streaming: false,
         },
       },
       {
         id: "assistant-final-entry",
         kind: "message" as const,
-        createdAt: "2026-01-01T00:00:05Z",
+        createdAt: "2026-01-01T00:00:20Z",
         message: {
           id: "assistant-final" as never,
           role: "assistant" as const,
-          text: "Verification finished.",
-          turnId: "turn-1" as never,
-          createdAt: "2026-01-01T00:00:05Z",
-          updatedAt: "2026-01-01T00:00:06Z",
+          text: "Subagent says: Hello.",
+          runId: "turn-1" as never,
+          createdAt: "2026-01-01T00:00:20Z",
+          updatedAt: "2026-01-01T00:00:22Z",
           streaming: false,
         },
       },
     ];
 
-    const rows = deriveMessagesTimelineRows({
+    const collapsedRows = deriveMessagesTimelineRows({
       timelineEntries,
       isWorking: false,
       turnDiffSummaryByAssistantMessageId: new Map(),
       revertTurnCountByUserMessageId: new Map(),
     });
 
-    expect(rows.map((row) => row.id)).toEqual([
-      "assistant-first-entry",
+    expect(collapsedRows.map((row) => row.id)).toEqual([
+      "user-entry",
       "turn-fold:turn-1",
+      "subagent-card-entry",
       "assistant-final-entry",
     ]);
   });
 
+  it("collapses only output from a superseded V2 attempt within the active logical run", () => {
+    const runId = "run-steered" as never;
+    const supersededAttemptId = "attempt-1" as never;
+    const activeAttemptId = "attempt-2" as never;
+    const supersededAttempt = {
+      id: supersededAttemptId,
+      runId,
+      attemptOrdinal: 1,
+      rootNodeId: "node-attempt-1" as never,
+      status: "superseded" as const,
+    };
+    const activeAttempt = {
+      id: activeAttemptId,
+      runId,
+      attemptOrdinal: 2,
+      rootNodeId: "node-attempt-2" as never,
+      status: "running" as const,
+    };
+    const timelineEntries = [
+      {
+        id: "initial-user-entry",
+        kind: "message" as const,
+        createdAt: "2026-01-01T00:00:00Z",
+        attempt: supersededAttempt,
+        message: {
+          id: "initial-user" as never,
+          role: "user" as const,
+          text: "Build it",
+          runId,
+          inputIntent: "turn_start" as const,
+          createdAt: "2026-01-01T00:00:00Z",
+          updatedAt: "2026-01-01T00:00:00Z",
+          streaming: false,
+        },
+      },
+      {
+        id: "superseded-assistant-entry",
+        kind: "message" as const,
+        createdAt: "2026-01-01T00:00:02Z",
+        attempt: supersededAttempt,
+        message: {
+          id: "superseded-assistant" as never,
+          role: "assistant" as const,
+          text: "Partial old response",
+          runId,
+          createdAt: "2026-01-01T00:00:02Z",
+          updatedAt: "2026-01-01T00:00:03Z",
+          streaming: false,
+        },
+      },
+      {
+        id: "superseded-work-entry",
+        kind: "work" as const,
+        createdAt: "2026-01-01T00:00:04Z",
+        attempt: supersededAttempt,
+        entry: {
+          id: "superseded-work",
+          createdAt: "2026-01-01T00:00:04Z",
+          runId,
+          label: "Old command",
+          tone: "tool" as const,
+        },
+      },
+      {
+        id: "superseded-thread-created-entry",
+        kind: "event" as const,
+        createdAt: "2026-01-01T00:00:04.500Z",
+        attempt: supersededAttempt,
+        projectedItem: {
+          item: {
+            type: "thread_created",
+          },
+        } as never,
+      },
+      {
+        id: "steer-user-entry",
+        kind: "message" as const,
+        createdAt: "2026-01-01T00:00:05Z",
+        attempt: activeAttempt,
+        message: {
+          id: "steer-user" as never,
+          role: "user" as const,
+          text: "Change direction",
+          runId,
+          inputIntent: "steer" as const,
+          createdAt: "2026-01-01T00:00:05Z",
+          updatedAt: "2026-01-01T00:00:05Z",
+          streaming: false,
+        },
+      },
+      {
+        id: "active-assistant-entry",
+        kind: "message" as const,
+        createdAt: "2026-01-01T00:00:06Z",
+        attempt: activeAttempt,
+        message: {
+          id: "active-assistant" as never,
+          role: "assistant" as const,
+          text: "Current response",
+          runId,
+          createdAt: "2026-01-01T00:00:06Z",
+          updatedAt: "2026-01-01T00:00:07Z",
+          streaming: true,
+        },
+      },
+    ];
+    const common = {
+      timelineEntries,
+      latestRun: {
+        runId,
+        status: "running" as const,
+        startedAt: "2026-01-01T00:00:00Z",
+        completedAt: null,
+      },
+      isWorking: false,
+      turnDiffSummaryByAssistantMessageId: new Map(),
+      revertTurnCountByUserMessageId: new Map(),
+    };
+
+    const collapsedRows = deriveMessagesTimelineRows(common);
+    expect(collapsedRows.map((row) => row.id)).toEqual([
+      "initial-user-entry",
+      `attempt-fold:${supersededAttemptId}`,
+      "superseded-thread-created-entry",
+      "steer-user-entry",
+      "active-assistant-entry",
+    ]);
+    expect(collapsedRows.find((row) => row.kind === "attempt-fold")).toMatchObject({
+      attemptId: supersededAttemptId,
+      runId,
+      label: "Superseded attempt",
+      expanded: false,
+    });
+
+    const expandedRows = deriveMessagesTimelineRows({
+      ...common,
+      expandedAttemptIds: new Set([supersededAttemptId]),
+    });
+    // The superseded tool entry carries no lifecycle status, so it stays
+    // hidden as a neutral row even when the attempt fold is expanded.
+    expect(expandedRows.map((row) => row.id)).toEqual([
+      "initial-user-entry",
+      `attempt-fold:${supersededAttemptId}`,
+      "superseded-assistant-entry",
+      "superseded-thread-created-entry",
+      "steer-user-entry",
+      "active-assistant-entry",
+    ]);
+  });
+
   it("derives a sane duration for a steer-superseded turn with one instant commentary message", () => {
     // A steer ends the previous turn early: its only message completes the
     // instant it is created, and trailing work entries land after it. The
@@ -624,7 +972,7 @@ describe("deriveMessagesTimelineRows", () => {
             id: "user-1" as never,
             role: "user" as const,
             text: "do it once more",
-            turnId: null,
+            runId: null,
             createdAt: "2026-01-01T00:00:00Z",
             updatedAt: "2026-01-01T00:00:00Z",
             streaming: false,
@@ -638,7 +986,7 @@ describe("deriveMessagesTimelineRows", () => {
             id: "assistant-commentary" as never,
             role: "assistant" as const,
             text: "Kicking off call 1.",
-            turnId: "turn-1" as never,
+            runId: "turn-1" as never,
             createdAt: "2026-01-01T00:00:09Z",
             updatedAt: "2026-01-01T00:00:09Z",
             streaming: false,
@@ -651,7 +999,7 @@ describe("deriveMessagesTimelineRows", () => {
           entry: {
             id: "work-1",
             createdAt: "2026-01-01T00:00:12Z",
-            turnId: "turn-1" as never,
+            runId: "turn-1" as never,
             label: "Ran command",
             tone: "tool" as const,
           },
@@ -664,7 +1012,7 @@ describe("deriveMessagesTimelineRows", () => {
             id: "user-2" as never,
             role: "user" as const,
             text: "actually do 15",
-            turnId: null,
+            runId: null,
             createdAt: "2026-01-01T00:00:14Z",
             updatedAt: "2026-01-01T00:00:14Z",
             streaming: false,
@@ -678,16 +1026,16 @@ describe("deriveMessagesTimelineRows", () => {
             id: "assistant-next" as never,
             role: "assistant" as const,
             text: "One down — adjusting.",
-            turnId: "turn-2" as never,
+            runId: "turn-2" as never,
             createdAt: "2026-01-01T00:00:17Z",
             updatedAt: "2026-01-01T00:00:17Z",
             streaming: true,
           },
         },
       ],
-      latestTurn: {
-        turnId: "turn-2" as never,
-        state: "running",
+      latestRun: {
+        runId: "turn-2" as never,
+        status: "running",
         startedAt: "2026-01-01T00:00:14Z",
         completedAt: null,
       },
@@ -701,7 +1049,7 @@ describe("deriveMessagesTimelineRows", () => {
         row.kind === "turn-fold",
     );
     // User message (00:00:00) → trailing work entry (00:00:12).
-    expect(foldRow?.turnId).toBe("turn-1");
+    expect(foldRow?.runId).toBe("turn-1");
     expect(foldRow?.label).toBe("Worked for 12s");
   });
 
@@ -715,15 +1063,15 @@ describe("deriveMessagesTimelineRows", () => {
           entry: {
             id: "work-1",
             createdAt: "2026-01-01T00:00:05Z",
-            turnId: "turn-1" as never,
+            runId: "turn-1" as never,
             label: "Ran command",
             tone: "tool" as const,
           },
         },
       ],
-      latestTurn: {
-        turnId: "turn-1" as never,
-        state: "interrupted",
+      latestRun: {
+        runId: "turn-1" as never,
+        status: "interrupted",
         startedAt: "2026-01-01T00:00:00Z",
         completedAt: "2026-01-01T00:00:47Z",
       },
@@ -735,15 +1083,85 @@ describe("deriveMessagesTimelineRows", () => {
     expect(rows).toEqual([
       expect.objectContaining({
         kind: "turn-fold",
-        turnId: "turn-1",
+        runId: "turn-1",
         label: "You stopped after 47s",
         expanded: false,
       }),
     ]);
   });
 
+  it("hides the interruption request while keeping intervening work and the result", () => {
+    const runId = "turn-1" as never;
+    const interruptEvent = (type: "run_interrupt_request" | "run_interrupt_result") => ({
+      position: type === "run_interrupt_request" ? 0 : 2,
+      visibility: "local" as const,
+      sourceThreadId: "thread-1" as never,
+      sourceItemId: `item-${type}` as never,
+      item: {
+        id: `item-${type}`,
+        threadId: "thread-1",
+        runId,
+        nodeId: null,
+        providerThreadId: null,
+        providerTurnId: null,
+        nativeItemRef: null,
+        parentItemId: null,
+        ordinal: type === "run_interrupt_request" ? 0 : 2,
+        status: "completed",
+        title: null,
+        startedAt: null,
+        completedAt: null,
+        updatedAt: {},
+        type,
+        message: type === "run_interrupt_request" ? "Stopping" : "Stopped",
+      },
+    });
+    const rows = deriveMessagesTimelineRows({
+      timelineEntries: [
+        {
+          id: "interrupt-request",
+          kind: "event",
+          createdAt: "2026-01-01T00:00:01Z",
+          projectedItem: interruptEvent("run_interrupt_request") as never,
+        },
+        {
+          id: "work-entry",
+          kind: "work",
+          createdAt: "2026-01-01T00:00:02Z",
+          entry: {
+            id: "work-1",
+            createdAt: "2026-01-01T00:00:02Z",
+            runId,
+            label: "Finishing tool output",
+            tone: "tool",
+          },
+        },
+        {
+          id: "interrupt-result",
+          kind: "event",
+          createdAt: "2026-01-01T00:00:03Z",
+          projectedItem: interruptEvent("run_interrupt_result") as never,
+        },
+      ],
+      latestRun: {
+        runId,
+        status: "interrupted",
+        startedAt: "2026-01-01T00:00:00Z",
+        completedAt: "2026-01-01T00:00:03Z",
+      },
+      isWorking: false,
+      turnDiffSummaryByAssistantMessageId: new Map(),
+      revertTurnCountByUserMessageId: new Map(),
+    });
+
+    // The status-less tool entry is neutral and hidden; the interrupt result
+    // stays as the terminal marker.
+    expect(rows.map((row) => row.id)).toEqual(["interrupt-result"]);
+    expect(rows.some((row) => row.kind === "turn-fold")).toBe(false);
+  });
+
   it("keeps the previous turn folded while a newly sent message awaits its turn", () => {
-    // Right after send, isWorking is true but latestTurn still points at the
+    // Right after send, isWorking is true but latestRun still points at the
     // previous, settled turn — it must stay folded through that window.
     const rows = deriveMessagesTimelineRows({
       timelineEntries: [
@@ -754,7 +1172,7 @@ describe("deriveMessagesTimelineRows", () => {
           entry: {
             id: "work-1",
             createdAt: "2026-01-01T00:00:05Z",
-            turnId: "turn-1" as never,
+            runId: "turn-1" as never,
             label: "Ran command",
             tone: "tool" as const,
           },
@@ -767,7 +1185,7 @@ describe("deriveMessagesTimelineRows", () => {
             id: "assistant-final" as never,
             role: "assistant",
             text: "Done",
-            turnId: "turn-1" as never,
+            runId: "turn-1" as never,
             createdAt: "2026-01-01T00:00:20Z",
             updatedAt: "2026-01-01T00:00:22Z",
             streaming: false,
@@ -781,16 +1199,16 @@ describe("deriveMessagesTimelineRows", () => {
             id: "user-followup" as never,
             role: "user",
             text: "yooo",
-            turnId: null,
+            runId: null,
             createdAt: "2026-01-01T00:01:00Z",
             updatedAt: "2026-01-01T00:01:00Z",
             streaming: false,
           },
         },
       ],
-      latestTurn: {
-        turnId: "turn-1" as never,
-        state: "completed",
+      latestRun: {
+        runId: "turn-1" as never,
+        status: "completed",
         startedAt: "2026-01-01T00:00:00Z",
         completedAt: "2026-01-01T00:00:22Z",
       },
@@ -819,7 +1237,7 @@ describe("deriveMessagesTimelineRows", () => {
             id: "assistant-thought" as never,
             role: "assistant",
             text: "Working on it.",
-            turnId: "turn-1" as never,
+            runId: "turn-1" as never,
             createdAt: "2026-01-01T00:00:05Z",
             updatedAt: "2026-01-01T00:00:06Z",
             streaming: false,
@@ -832,15 +1250,17 @@ describe("deriveMessagesTimelineRows", () => {
           entry: {
             id: "work-1",
             createdAt: "2026-01-01T00:00:08Z",
-            turnId: "turn-1" as never,
+            runId: "turn-1" as never,
             label: "Ran command",
+            command: "vp test run",
             tone: "tool" as const,
+            toolLifecycleStatus: "inProgress" as const,
           },
         },
       ],
-      latestTurn: {
-        turnId: "turn-1" as never,
-        state: "running",
+      latestRun: {
+        runId: "turn-1" as never,
+        status: "running",
         startedAt: "2026-01-01T00:00:00Z",
         completedAt: null,
       },
@@ -854,410 +1274,8 @@ describe("deriveMessagesTimelineRows", () => {
       "assistant-thought-entry",
       "work-live:work-entry-1",
     ]);
-  });
-
-  it("keeps adjacent active tool calls in one replacing row", () => {
-    const rows = deriveMessagesTimelineRows({
-      timelineEntries: [
-        {
-          id: "completed-command-entry",
-          kind: "work",
-          createdAt: "2026-01-01T00:00:05Z",
-          entry: {
-            id: "completed-command",
-            createdAt: "2026-01-01T00:00:05Z",
-            turnId: "turn-1" as never,
-            label: "Ran rg",
-            command: "rg toolCall",
-            requestKind: "command",
-            tone: "tool" as const,
-            toolLifecycleStatus: "completed" as const,
-          },
-        },
-        {
-          id: "completed-edit-entry",
-          kind: "work",
-          createdAt: "2026-01-01T00:00:06Z",
-          entry: {
-            id: "completed-edit",
-            createdAt: "2026-01-01T00:00:06Z",
-            turnId: "turn-1" as never,
-            label: "Edited files",
-            requestKind: "file-change",
-            changedFiles: ["src/one.ts", "src/two.ts"],
-            tone: "tool" as const,
-            toolLifecycleStatus: "completed" as const,
-          },
-        },
-        {
-          id: "running-command-entry",
-          kind: "work",
-          createdAt: "2026-01-01T00:00:07Z",
-          entry: {
-            id: "running-command",
-            createdAt: "2026-01-01T00:00:07Z",
-            turnId: "turn-1" as never,
-            label: "Running tests",
-            command: "vp test run",
-            requestKind: "command",
-            tone: "tool" as const,
-            toolLifecycleStatus: "inProgress" as const,
-          },
-        },
-      ],
-      latestTurn: {
-        turnId: "turn-1" as never,
-        state: "running",
-        startedAt: "2026-01-01T00:00:00Z",
-        completedAt: null,
-      },
-      isWorking: true,
-      turnDiffSummaryByAssistantMessageId: new Map(),
-      revertTurnCountByUserMessageId: new Map(),
-    });
-
-    expect(rows.map((row) => row.kind)).toEqual(["work-live"]);
-    expect(rows.find((row) => row.kind === "work-live")).toMatchObject({
-      entry: { id: "running-command" },
-      groupedEntries: [
-        { id: "completed-command" },
-        { id: "completed-edit" },
-        { id: "running-command" },
-      ],
-    });
-  });
-
-  it("summarizes a tool run after commentary starts a new run", () => {
-    const rows = deriveMessagesTimelineRows({
-      timelineEntries: [
-        {
-          id: "completed-command-entry",
-          kind: "work",
-          createdAt: "2026-01-01T00:00:05Z",
-          entry: {
-            id: "completed-command",
-            createdAt: "2026-01-01T00:00:05Z",
-            turnId: "turn-1" as never,
-            label: "Ran rg",
-            command: "rg toolCall",
-            requestKind: "command",
-            tone: "tool" as const,
-            toolLifecycleStatus: "completed" as const,
-          },
-        },
-        {
-          id: "assistant-commentary-entry",
-          kind: "message",
-          createdAt: "2026-01-01T00:00:06Z",
-          message: {
-            id: "assistant-commentary" as never,
-            role: "assistant",
-            text: "Checking another thing.",
-            turnId: "turn-1" as never,
-            createdAt: "2026-01-01T00:00:06Z",
-            updatedAt: "2026-01-01T00:00:06Z",
-            streaming: false,
-          },
-        },
-        {
-          id: "running-command-entry",
-          kind: "work",
-          createdAt: "2026-01-01T00:00:07Z",
-          entry: {
-            id: "running-command",
-            createdAt: "2026-01-01T00:00:07Z",
-            turnId: "turn-1" as never,
-            label: "Running tests",
-            command: "vp test run",
-            requestKind: "command",
-            tone: "tool" as const,
-            toolLifecycleStatus: "inProgress" as const,
-          },
-        },
-      ],
-      latestTurn: {
-        turnId: "turn-1" as never,
-        state: "running",
-        startedAt: "2026-01-01T00:00:00Z",
-        completedAt: null,
-      },
-      isWorking: true,
-      turnDiffSummaryByAssistantMessageId: new Map(),
-      revertTurnCountByUserMessageId: new Map(),
-    });
-
-    expect(rows.map((row) => row.kind)).toEqual(["work-toggle", "message", "work-live"]);
-    expect(rows.find((row) => row.kind === "work-toggle")).toMatchObject({
-      hiddenCount: 1,
-      summary: "Ran 1 command",
-    });
-  });
-
-  it("keeps separated in-progress tool runs visible", () => {
-    const rows = deriveMessagesTimelineRows({
-      timelineEntries: [
-        {
-          id: "first-running-entry",
-          kind: "work",
-          createdAt: "2026-01-01T00:00:05Z",
-          entry: {
-            id: "first-running",
-            createdAt: "2026-01-01T00:00:05Z",
-            turnId: "turn-1" as never,
-            label: "Running first command",
-            command: "rg first",
-            requestKind: "command",
-            tone: "tool" as const,
-            toolLifecycleStatus: "inProgress" as const,
-          },
-        },
-        {
-          id: "assistant-commentary-entry",
-          kind: "message",
-          createdAt: "2026-01-01T00:00:06Z",
-          message: {
-            id: "assistant-commentary" as never,
-            role: "assistant",
-            text: "Starting another command.",
-            turnId: "turn-1" as never,
-            createdAt: "2026-01-01T00:00:06Z",
-            updatedAt: "2026-01-01T00:00:06Z",
-            streaming: false,
-          },
-        },
-        {
-          id: "second-running-entry",
-          kind: "work",
-          createdAt: "2026-01-01T00:00:07Z",
-          entry: {
-            id: "second-running",
-            createdAt: "2026-01-01T00:00:07Z",
-            turnId: "turn-1" as never,
-            label: "Running second command",
-            command: "rg second",
-            requestKind: "command",
-            tone: "tool" as const,
-            toolLifecycleStatus: "inProgress" as const,
-          },
-        },
-      ],
-      latestTurn: {
-        turnId: "turn-1" as never,
-        state: "running",
-        startedAt: "2026-01-01T00:00:00Z",
-        completedAt: null,
-      },
-      isWorking: true,
-      turnDiffSummaryByAssistantMessageId: new Map(),
-      revertTurnCountByUserMessageId: new Map(),
-    });
-
-    expect(rows.map((row) => row.kind)).toEqual(["work-live", "message", "work-live"]);
-    expect(rows.filter((row) => row.kind === "work-live").map((row) => row.entry.id)).toEqual([
-      "first-running",
-      "second-running",
-    ]);
-  });
-
-  it("does not revive stale in-progress tools before a fresh send has a turn id", () => {
-    const rows = deriveMessagesTimelineRows({
-      timelineEntries: [
-        {
-          id: "stale-running-entry",
-          kind: "work",
-          createdAt: "2026-01-01T00:00:05Z",
-          entry: {
-            id: "stale-running",
-            createdAt: "2026-01-01T00:00:05Z",
-            turnId: "turn-1" as never,
-            label: "Running stale command",
-            command: "rg stale",
-            requestKind: "command",
-            tone: "tool" as const,
-            toolLifecycleStatus: "inProgress" as const,
-          },
-        },
-        {
-          id: "user-followup-entry",
-          kind: "message",
-          createdAt: "2026-01-01T00:01:00Z",
-          message: {
-            id: "user-followup" as never,
-            role: "user",
-            text: "continue",
-            turnId: null,
-            createdAt: "2026-01-01T00:01:00Z",
-            updatedAt: "2026-01-01T00:01:00Z",
-            streaming: false,
-          },
-        },
-      ],
-      latestTurn: null,
-      isWorking: true,
-      turnDiffSummaryByAssistantMessageId: new Map(),
-      revertTurnCountByUserMessageId: new Map(),
-    });
-
-    expect(rows.some((row) => row.kind === "work-live")).toBe(false);
-  });
-
-  it("does not revive separated historical task progress", () => {
-    const rows = deriveMessagesTimelineRows({
-      timelineEntries: [
-        {
-          id: "stale-progress-entry",
-          kind: "work",
-          createdAt: "2026-01-01T00:00:05Z",
-          entry: {
-            id: "stale-progress",
-            createdAt: "2026-01-01T00:00:05Z",
-            turnId: "turn-1" as never,
-            label: "Old progress",
-            tone: "thinking" as const,
-            sourceActivityKind: "task.progress" as const,
-          },
-        },
-        {
-          id: "assistant-commentary-entry",
-          kind: "message",
-          createdAt: "2026-01-01T00:00:06Z",
-          message: {
-            id: "assistant-commentary" as never,
-            role: "assistant",
-            text: "Starting another command.",
-            turnId: "turn-1" as never,
-            createdAt: "2026-01-01T00:00:06Z",
-            updatedAt: "2026-01-01T00:00:06Z",
-            streaming: false,
-          },
-        },
-        {
-          id: "running-command-entry",
-          kind: "work",
-          createdAt: "2026-01-01T00:00:07Z",
-          entry: {
-            id: "running-command",
-            createdAt: "2026-01-01T00:00:07Z",
-            turnId: "turn-1" as never,
-            label: "Running command",
-            command: "rg current",
-            requestKind: "command",
-            tone: "tool" as const,
-            toolLifecycleStatus: "inProgress" as const,
-          },
-        },
-      ],
-      latestTurn: {
-        turnId: "turn-1" as never,
-        state: "running",
-        startedAt: "2026-01-01T00:00:00Z",
-        completedAt: null,
-      },
-      isWorking: true,
-      turnDiffSummaryByAssistantMessageId: new Map(),
-      revertTurnCountByUserMessageId: new Map(),
-    });
-
-    expect(rows.filter((row) => row.kind === "work-live").map((row) => row.entry.id)).toEqual([
-      "running-command",
-    ]);
-  });
-
-  it("keeps the latest completed tool call live while the turn is running", () => {
-    const rows = deriveMessagesTimelineRows({
-      timelineEntries: [
-        {
-          id: "latest-command-entry",
-          kind: "work",
-          createdAt: "2026-01-01T00:00:05Z",
-          entry: {
-            id: "latest-command",
-            createdAt: "2026-01-01T00:00:05Z",
-            turnId: "turn-1" as never,
-            label: "Ran rg",
-            command: "rg toolCall",
-            requestKind: "command",
-            tone: "tool" as const,
-            toolLifecycleStatus: "completed" as const,
-          },
-        },
-      ],
-      latestTurn: {
-        turnId: "turn-1" as never,
-        state: "running",
-        startedAt: "2026-01-01T00:00:00Z",
-        completedAt: null,
-      },
-      isWorking: true,
-      turnDiffSummaryByAssistantMessageId: new Map(),
-      revertTurnCountByUserMessageId: new Map(),
-    });
-
-    expect(rows.map((row) => row.kind)).toEqual(["work-live"]);
-    expect(rows.find((row) => row.kind === "work-live")).toMatchObject({
-      entry: { id: "latest-command" },
-      groupedEntries: [{ id: "latest-command" }],
-    });
-  });
-
-  it("does not fold the session's running turn when latestTurn regresses", () => {
-    const rows = deriveMessagesTimelineRows({
-      timelineEntries: [
-        {
-          id: "previous-work-entry",
-          kind: "work",
-          createdAt: "2026-01-01T00:00:05Z",
-          entry: {
-            id: "previous-work",
-            createdAt: "2026-01-01T00:00:05Z",
-            turnId: "turn-1" as never,
-            label: "Read files",
-            tone: "tool" as const,
-          },
-        },
-        {
-          id: "user-followup-entry",
-          kind: "message",
-          createdAt: "2026-01-01T00:01:00Z",
-          message: {
-            id: "user-followup" as never,
-            role: "user",
-            text: "continue",
-            turnId: null,
-            createdAt: "2026-01-01T00:01:00Z",
-            updatedAt: "2026-01-01T00:01:00Z",
-            streaming: false,
-          },
-        },
-        {
-          id: "running-work-entry",
-          kind: "work",
-          createdAt: "2026-01-01T00:01:05Z",
-          entry: {
-            id: "running-work",
-            createdAt: "2026-01-01T00:01:05Z",
-            turnId: "turn-2" as never,
-            label: "Searched files",
-            tone: "tool" as const,
-          },
-        },
-      ],
-      latestTurn: {
-        turnId: "turn-1" as never,
-        state: "completed",
-        startedAt: "2026-01-01T00:00:00Z",
-        completedAt: "2026-01-01T00:00:25Z",
-      },
-      runningTurnId: "turn-2" as never,
-      isWorking: true,
-      turnDiffSummaryByAssistantMessageId: new Map(),
-      revertTurnCountByUserMessageId: new Map(),
-    });
-
-    expect(rows.filter((row) => row.kind === "turn-fold").map((row) => row.turnId)).toEqual([
-      "turn-1",
-    ]);
-    expect(rows.map((row) => row.id)).toContain("work-live:running-work-entry");
+    const liveRow = rows.find((row) => row.kind === "work-live");
+    expect(liveRow?.kind === "work-live" ? liveRow.entry.id : null).toBe("work-1");
   });
 
   it("only shows assistant metadata on the terminal assistant message", () => {
@@ -1271,7 +1289,7 @@ describe("deriveMessagesTimelineRows", () => {
             id: "assistant-thought" as never,
             role: "assistant",
             text: "Checking first.",
-            turnId: "turn-1" as never,
+            runId: "turn-1" as never,
             createdAt: "2026-01-01T00:00:10Z",
             updatedAt: "2026-01-01T00:00:11Z",
             streaming: false,
@@ -1285,14 +1303,14 @@ describe("deriveMessagesTimelineRows", () => {
             id: "assistant-final" as never,
             role: "assistant",
             text: "Done.",
-            turnId: "turn-1" as never,
+            runId: "turn-1" as never,
             createdAt: "2026-01-01T00:00:20Z",
             updatedAt: "2026-01-01T00:00:30Z",
             streaming: false,
           },
         },
       ],
-      expandedTurnIds: new Set(["turn-1" as never]),
+      expandedRunIds: new Set(["turn-1" as never]),
       isWorking: false,
       turnDiffSummaryByAssistantMessageId: new Map(),
       revertTurnCountByUserMessageId: new Map(),
@@ -1317,16 +1335,16 @@ describe("deriveMessagesTimelineRows", () => {
             id: "assistant-thought" as never,
             role: "assistant",
             text: "Working on it.",
-            turnId: "turn-1" as never,
+            runId: "turn-1" as never,
             createdAt: "2026-01-01T00:00:10Z",
             updatedAt: "2026-01-01T00:00:11Z",
             streaming: false,
           },
         },
       ],
-      latestTurn: {
-        turnId: "turn-1" as never,
-        state: "running",
+      latestRun: {
+        runId: "turn-1" as never,
+        status: "running",
         startedAt: "2026-01-01T00:00:00Z",
         completedAt: null,
       },
@@ -1344,10 +1362,53 @@ describe("deriveMessagesTimelineRows", () => {
     expect(assistantRow?.showAssistantCopyButton).toBe(false);
   });
 
-  it.each([
-    ["tools", "tool", "Used 3 tools"],
-    ["tools and status updates", "info", "Used 2 tools and received 1 update"],
-  ] as const)("expands %s through the same activity group", (_, middleTone, summary) => {
+  it("retains a failed command in the summary after a later command succeeds", () => {
+    const rows = deriveMessagesTimelineRows({
+      timelineEntries: [
+        {
+          id: "work-entry-failed",
+          kind: "work" as const,
+          createdAt: "2026-01-01T00:00:01Z",
+          entry: {
+            id: "work-failed",
+            createdAt: "2026-01-01T00:00:01Z",
+            label: "Ran command",
+            command: "ssh host true",
+            detail: "connection refused",
+            tone: "tool" as const,
+            itemType: "command_execution" as const,
+            toolLifecycleStatus: "failed" as const,
+          },
+        },
+        {
+          id: "work-entry-ok",
+          kind: "work" as const,
+          createdAt: "2026-01-01T00:00:02Z",
+          entry: {
+            id: "work-ok",
+            createdAt: "2026-01-01T00:00:02Z",
+            label: "Ran command",
+            command: "true",
+            tone: "tool" as const,
+            itemType: "command_execution" as const,
+            toolLifecycleStatus: "completed" as const,
+          },
+        },
+      ],
+      isWorking: false,
+      turnDiffSummaryByAssistantMessageId: new Map(),
+      revertTurnCountByUserMessageId: new Map(),
+    });
+
+    expect(rows).toHaveLength(1);
+    expect(rows[0]).toMatchObject({
+      kind: "work-toggle",
+      summary: "1 failed · Ran 2 commands",
+      hasFailure: true,
+    });
+  });
+
+  it("collapses contiguous settled tool entries behind a summary toggle", () => {
     const timelineEntries = [
       {
         id: "work-entry-1",
@@ -1359,6 +1420,8 @@ describe("deriveMessagesTimelineRows", () => {
           label: "read",
           detail: "Reading package.json",
           tone: "tool" as const,
+          itemType: "command_execution" as const,
+          toolLifecycleStatus: "completed" as const,
         },
       },
       {
@@ -1368,9 +1431,12 @@ describe("deriveMessagesTimelineRows", () => {
         entry: {
           id: "work-2",
           createdAt: "2026-01-01T00:00:02Z",
-          label: "Status updated",
+          label: "edit",
           detail: "Editing MessagesTimeline.tsx",
-          tone: middleTone,
+          tone: "tool" as const,
+          itemType: "file_change" as const,
+          changedFiles: ["apps/web/src/components/chat/MessagesTimeline.tsx"],
+          toolLifecycleStatus: "completed" as const,
         },
       },
       {
@@ -1383,6 +1449,8 @@ describe("deriveMessagesTimelineRows", () => {
           label: "test",
           detail: "Running tests",
           tone: "tool" as const,
+          itemType: "command_execution" as const,
+          toolLifecycleStatus: "completed" as const,
         },
       },
     ];
@@ -1393,18 +1461,23 @@ describe("deriveMessagesTimelineRows", () => {
       turnDiffSummaryByAssistantMessageId: new Map(),
       revertTurnCountByUserMessageId: new Map(),
     };
-    const collapsedRows = deriveMessagesTimelineRows(baseInput);
-    const expandedRows = deriveMessagesTimelineRows({
-      ...baseInput,
-      expandedWorkGroupIds: new Set(["work-group:work-entry-1"]),
-    });
+    const rows = deriveMessagesTimelineRows(baseInput);
 
-    expect(collapsedRows.map((row) => row.id)).toEqual(["work-toggle:work-entry-1"]);
-    expect(collapsedRows.find((row) => row.kind === "work-toggle")).toMatchObject({
+    expect(rows).toHaveLength(1);
+    expect(rows[0]).toMatchObject({
+      kind: "work-toggle",
+      id: "work-toggle:work-entry-1",
       groupId: "work-group:work-entry-1",
       hiddenCount: 3,
       expanded: false,
-      summary,
+      summary: "Ran 2 commands and changed 1 file",
+      summaryKind: "mixed",
+      hasFailure: false,
+    });
+
+    const expandedRows = deriveMessagesTimelineRows({
+      ...baseInput,
+      expandedWorkGroupIds: new Set(["work-group:work-entry-1"]),
     });
     expect(expandedRows.map((row) => row.id)).toEqual([
       "work-toggle:work-entry-1",
@@ -1412,98 +1485,17 @@ describe("deriveMessagesTimelineRows", () => {
       "work-2",
       "work-3",
     ]);
-    expect(expandedRows.find((row) => row.kind === "work-toggle")).toMatchObject({
-      expanded: true,
+    expect(expandedRows[1]).toMatchObject({
+      kind: "work",
+      isExpandedToolGroupEntry: true,
+      isLastExpandedToolGroupEntry: false,
     });
-  });
-
-  it.each([
-    ["recovered", ["failed", "completed"], false],
-    ["ending in failure", ["completed", "failed"], true],
-    ["failed", ["failed", "failed"], true],
-  ] as const)("uses the final call for %s tool groups", (_, statuses, hasFailure) => {
-    const timelineEntries = statuses.map((status, index) => ({
-      id: `work-entry-${index}`,
-      kind: "work" as const,
-      createdAt: `2026-01-01T00:00:0${index}Z`,
-      entry: {
-        id: `work-${index}`,
-        createdAt: `2026-01-01T00:00:0${index}Z`,
-        label: "Ran command",
-        tone: "tool" as const,
-        itemType: "command_execution" as const,
-        toolLifecycleStatus: status,
-      },
-    }));
-
-    const rows = deriveMessagesTimelineRows({
-      timelineEntries,
-      isWorking: false,
-      turnDiffSummaryByAssistantMessageId: new Map(),
-      revertTurnCountByUserMessageId: new Map(),
-    });
-
-    expect(rows.find((row) => row.kind === "work-toggle")).toMatchObject({
-      hiddenCount: 2,
-      hasFailure,
+    expect(expandedRows[3]).toMatchObject({
+      kind: "work",
+      isExpandedToolGroupEntry: true,
+      isLastExpandedToolGroupEntry: true,
     });
   });
-
-  it.each([
-    ["the later success is hidden", ["failed", "completed", "info"], false],
-    ["the later success is visible", ["failed", "info", "completed"], false],
-    ["an error-toned entry recovers", ["error", "info", "completed"], false],
-    ["the final failure is hidden", ["completed", "failed", "info"], true],
-    ["the final failure is visible", ["failed", "info", "failed"], true],
-    ["the only failure is visible", ["completed", "info", "failed"], true],
-  ] as const)(
-    "uses the final tool call for mixed work groups when %s",
-    (_, statuses, hasFailure) => {
-      const timelineEntries = statuses.map((status, index) => {
-        const id = `work-${index}`;
-        const createdAt = `2026-01-01T00:00:0${index}Z`;
-
-        return {
-          id: `work-entry-${index}`,
-          kind: "work" as const,
-          createdAt,
-          entry:
-            status === "info"
-              ? { id, createdAt, label: "Status updated", tone: "info" as const }
-              : status === "error"
-                ? { id, createdAt, label: "Command failed", tone: "error" as const }
-                : {
-                    id,
-                    createdAt,
-                    label: "Ran command",
-                    tone: "tool" as const,
-                    toolLifecycleStatus: status,
-                  },
-        };
-      });
-
-      const rows = deriveMessagesTimelineRows({
-        timelineEntries,
-        isWorking: false,
-        turnDiffSummaryByAssistantMessageId: new Map(),
-        revertTurnCountByUserMessageId: new Map(),
-      });
-
-      expect(rows.find((row) => row.kind === "work-toggle")).toMatchObject({
-        hiddenCount: statuses.some((status) => status === "error") ? 2 : 3,
-        summary: statuses.some((status) => status === "error")
-          ? "Received 1 update and used 1 tool"
-          : "Used 2 tools and received 1 update",
-        hasFailure,
-      });
-      if (statuses.some((status) => status === "error")) {
-        expect(rows[0]).toMatchObject({
-          kind: "work",
-          groupedEntries: [{ tone: "error", label: "Command failed" }],
-        });
-      }
-    },
-  );
 });
 
 describe("computeStableMessagesTimelineRows", () => {
@@ -1512,7 +1504,7 @@ describe("computeStableMessagesTimelineRows", () => {
       id: "user-1" as never,
       role: "user" as const,
       text: "First",
-      turnId: null,
+      runId: null,
       createdAt: "2026-01-01T00:00:00Z",
       updatedAt: "2026-01-01T00:00:00Z",
       streaming: false,
@@ -1521,7 +1513,7 @@ describe("computeStableMessagesTimelineRows", () => {
       id: "user-2" as never,
       role: "user" as const,
       text: "Second",
-      turnId: null,
+      runId: null,
       createdAt: "2026-01-01T00:00:10Z",
       updatedAt: "2026-01-01T00:00:10Z",
       streaming: false,
@@ -1565,6 +1557,7 @@ describe("computeStableMessagesTimelineRows", () => {
       label: "thinking",
       detail: "Inspecting repository state",
       tone: "thinking" as const,
+      toolLifecycleStatus: "completed" as const,
     };
     const secondWorkEntry = {
       id: "work-2",
@@ -1572,6 +1565,7 @@ describe("computeStableMessagesTimelineRows", () => {
       label: "read",
       detail: "Reading package.json",
       tone: "tool" as const,
+      toolLifecycleStatus: "completed" as const,
     };
 
     const createRows = () =>
@@ -1590,6 +1584,7 @@ describe("computeStableMessagesTimelineRows", () => {
             entry: secondWorkEntry,
           },
         ],
+        expandedWorkGroupIds: new Set(["work-group:entry-work-1"]),
         isWorking: false,
         turnDiffSummaryByAssistantMessageId: new Map(),
         revertTurnCountByUserMessageId: new Map(),
@@ -1615,7 +1610,7 @@ describe("computeStableMessagesTimelineRows", () => {
       id: "user-1" as never,
       role: "user" as const,
       text: "First",
-      turnId: null,
+      runId: null,
       createdAt: "2026-01-01T00:00:00Z",
       updatedAt: "2026-01-01T00:00:00Z",
       streaming: false,
@@ -1624,7 +1619,7 @@ describe("computeStableMessagesTimelineRows", () => {
       id: "user-2" as never,
       role: "user" as const,
       text: "Second",
-      turnId: null,
+      runId: null,
       createdAt: "2026-01-01T00:00:10Z",
       updatedAt: "2026-01-01T00:00:10Z",
       streaming: false,
diff --git a/apps/web/src/components/chat/MessagesTimeline.logic.ts b/apps/web/src/components/chat/MessagesTimeline.logic.ts
index 895141f2bef1..bdaa6f26f55d 100644
--- a/apps/web/src/components/chat/MessagesTimeline.logic.ts
+++ b/apps/web/src/components/chat/MessagesTimeline.logic.ts
@@ -1,6 +1,7 @@
 import * as Equal from "effect/Equal";
 import {
   formatDuration,
+  timelineEntryIsPersistentResourceCard,
   workEntryDisplayIndicatesToolFailure,
   workEntryIndicatesToolNeutralStatus,
   workLogEntryIsToolLike,
@@ -9,39 +10,51 @@ import {
   type WorkLogEntry,
 } from "../../session-logic";
 import { type ChatMessage, type ProposedPlan, type TurnDiffSummary } from "../../types";
-import { type MessageId, type OrchestrationLatestTurn, type TurnId } from "@t3tools/contracts";
-
-export const TIMELINE_MINIMAP_ITEM_SPACING = 8;
-export const TIMELINE_MINIMAP_MIN_ITEMS = 2;
-export const TIMELINE_MINIMAP_MAX_HEIGHT_CSS = "calc(100vh - 18rem)";
-export const TIMELINE_CONTENT_MAX_WIDTH = 768;
-export const TIMELINE_MINIMAP_PERSISTENT_GUTTER = 48;
+import {
+  type MessageId,
+  type OrchestrationV2ProjectedTurnItem,
+  type RunAttemptId,
+  type RunId,
+} from "@t3tools/contracts";
+import type { ThreadRunSummary } from "@t3tools/client-runtime/state/shell";
+import {
+  summarizeT3ToolCalls,
+  type T3ToolSummaryCall,
+} from "@t3tools/client-runtime/t3ToolSummary";
+import {
+  resolveT3McpToolPresentation,
+  resolveT3McpToolSummaryAction,
+  type T3McpToolPresentation,
+  type T3McpToolSummaryAction,
+} from "@t3tools/shared/t3McpToolPresentation";
 
 export function workEntryIsVisibleInGroup(
   entry: WorkLogEntry,
   expandedToolGroupEntry = false,
 ): boolean {
   return (
-    (expandedToolGroupEntry &&
-      (entry.toolLifecycleStatus === "inProgress" ||
-        entry.sourceActivityKind === "task.progress")) ||
+    (expandedToolGroupEntry && entry.toolLifecycleStatus === "inProgress") ||
     !workEntryIndicatesToolNeutralStatus(entry)
   );
 }
+export const TIMELINE_MINIMAP_ITEM_SPACING = 8;
+export const TIMELINE_MINIMAP_MIN_ITEMS = 2;
+export const TIMELINE_MINIMAP_MAX_HEIGHT_CSS = "calc(100vh - 18rem)";
+export const TIMELINE_CONTENT_MAX_WIDTH = 768;
+export const TIMELINE_MINIMAP_PERSISTENT_GUTTER = 48;
 
 export interface TimelineEndState {
   readonly isAtEnd?: boolean;
+  readonly isNearEnd?: boolean;
   readonly contentLength?: number;
   readonly scroll?: number;
   readonly scrollLength?: number;
 }
 
 /**
- * Follow re-arm band above the hard bottom. Strict on purpose: LegendList's
- * isNearEnd fires within half a viewport, which re-armed live-follow while the
- * user was reading history and yanked them back down on the next stream chunk.
- * A small pixel band (instead of the 1px isAtEnd epsilon alone) keeps re-arming
- * reliable while streaming content is still growing under the viewport.
+ * The follow re-arm band (#5566): strict isAtEnd flickers false for a frame
+ * while streaming content grows under the viewport, so follow re-arms within
+ * this distance of the real content bottom instead.
  */
 export const TIMELINE_FOLLOW_REARM_THRESHOLD_PX = 40;
 
@@ -57,7 +70,7 @@ export function resolveTimelineIsAtEnd(
   }
   const { contentLength, scroll, scrollLength } = state;
   if (contentLength === undefined || scroll === undefined || scrollLength === undefined) {
-    return state.isAtEnd;
+    return state.isNearEnd ?? state.isAtEnd;
   }
   // contentLength includes the end inset (composer overlay), so subtract it to
   // measure the distance to the real content bottom.
@@ -171,9 +184,9 @@ export interface TimelineDurationMessage {
   streaming: boolean;
 }
 
-export type TimelineLatestTurn = Pick<
-  OrchestrationLatestTurn,
-  "turnId" | "state" | "startedAt" | "completedAt"
+export type TimelineLatestRun = Pick<
+  ThreadRunSummary,
+  "runId" | "status" | "startedAt" | "completedAt"
 >;
 
 export type MessagesTimelineRow =
@@ -209,7 +222,16 @@ export type MessagesTimelineRow =
       kind: "turn-fold";
       id: string;
       createdAt: string;
-      turnId: TurnId;
+      runId: RunId;
+      label: string;
+      expanded: boolean;
+    }
+  | {
+      kind: "attempt-fold";
+      id: string;
+      createdAt: string;
+      runId: RunId;
+      attemptId: RunAttemptId;
       label: string;
       expanded: boolean;
     }
@@ -218,6 +240,7 @@ export type MessagesTimelineRow =
       id: string;
       createdAt: string;
       message: ChatMessage;
+      projectedItem?: OrchestrationV2ProjectedTurnItem;
       durationStart: string;
       showAssistantMeta: boolean;
       showAssistantCopyButton: boolean;
@@ -225,6 +248,12 @@ export type MessagesTimelineRow =
       assistantTurnDiffSummary?: TurnDiffSummary | undefined;
       revertTurnCount?: number | undefined;
     }
+  | {
+      kind: "event";
+      id: string;
+      createdAt: string;
+      projectedItem: OrchestrationV2ProjectedTurnItem;
+    }
   | {
       kind: "proposed-plan";
       id: string;
@@ -267,31 +296,32 @@ export function normalizeCompactToolLabel(value: string): string {
 }
 
 type ToolGroupAction = "read" | "edit" | "command" | "code-search" | "search" | "other" | "update";
-type ToolGroupSummaryKind = ToolGroupAction | "dynamic-tool" | "agent-tool" | "tone-tool" | "mixed";
+export type ToolGroupSummaryKind =
+  | ToolGroupAction
+  | "dynamic-tool"
+  | "agent-tool"
+  | "tone-tool"
+  | "mixed";
 
 export function workLogEntryIsLocalCodeSearch(entry: WorkLogEntry): boolean {
   return (
-    entry.itemType === "web_search" &&
-    /\bgrep\b/i.test(normalizeCompactToolLabel(entry.toolTitle ?? entry.label))
+    entry.itemType === "file_search" ||
+    (entry.itemType === "web_search" &&
+      /\bgrep\b/i.test(normalizeCompactToolLabel(entry.toolTitle ?? entry.label)))
   );
 }
 
 export function toolGroupAction(entry: WorkLogEntry): ToolGroupAction {
   if (
-    entry.requestKind === "file-read" ||
-    entry.itemType === "image_view" ||
-    (entry.itemType === "dynamic_tool_call" && entry.toolTitle === "Read File")
+    entry.itemType === "dynamic_tool" &&
+    /^read(?:\s+file)?$/i.test(normalizeCompactToolLabel(entry.toolTitle ?? entry.label))
   ) {
     return "read";
   }
-  if (
-    entry.requestKind === "file-change" ||
-    entry.itemType === "file_change" ||
-    (entry.changedFiles?.length ?? 0) > 0
-  ) {
+  if (entry.itemType === "file_change" || (entry.changedFiles?.length ?? 0) > 0) {
     return "edit";
   }
-  if (entry.requestKind === "command" || entry.itemType === "command_execution" || entry.command) {
+  if (entry.itemType === "command_execution" || entry.command) {
     return "command";
   }
   if (workLogEntryIsLocalCodeSearch(entry)) return "code-search";
@@ -336,61 +366,112 @@ function toolGroupActionLabel(action: ToolGroupAction, count: number): string {
   }
 }
 
-/** Immediate, provider-neutral fallback while generated tool summaries are disabled or unavailable. */
-export function summarizeToolGroup(entries: ReadonlyArray<WorkLogEntry>): string {
-  const summaryEntries = omitSupersededLifecycleMarkers(entries, (entry) => entry);
-  const groupedEntries = new Map<ToolGroupAction, WorkLogEntry[]>();
-  for (const entry of summaryEntries) {
-    const action = toolGroupAction(entry);
-    const group = groupedEntries.get(action);
-    if (group) group.push(entry);
-    else groupedEntries.set(action, [entry]);
+function t3ToolSummaryCall(entry: WorkLogEntry): T3ToolSummaryCall {
+  const item = entry.structuredPayload ?? entry.projectedItem?.item;
+  const data =
+    entry.toolData !== null && typeof entry.toolData === "object"
+      ? (entry.toolData as Record<string, unknown>)
+      : undefined;
+  return {
+    input: item?.type === "dynamic_tool" ? item.input : data?.input,
+    output: item?.type === "dynamic_tool" ? item.output : data?.output,
+    // A status/read result may describe a failed child. Only the call's own lifecycle
+    // and MCP error envelope determine whether the orchestration action failed.
+    outcome:
+      entry.toolLifecycleStatus === "failed" ||
+      entry.toolLifecycleStatus === "declined" ||
+      entry.tone === "error"
+        ? "failed"
+        : entry.toolLifecycleStatus === "completed"
+          ? "completed"
+          : "unfinished",
+  };
+}
+
+function summaryActionPriority(action: ToolGroupAction | T3McpToolSummaryAction): number {
+  switch (action) {
+    case "command":
+    case "edit":
+    case "delegate":
+    case "task-cancel":
+    case "thread-create":
+    case "thread-send":
+    case "thread-interrupt":
+    case "schedule-create":
+    case "schedule-update":
+    case "schedule-delete":
+      return 0;
+    case "other":
+    case "update":
+      return 2;
+    default:
+      return 1;
   }
-  const labels = [...groupedEntries].map(([action, actionEntries]) =>
-    toolGroupActionLabel(action, toolGroupActionCount(action, actionEntries)),
-  );
-  const sentenceLabels = labels.map((label, index) =>
-    index === 0 ? label : label.charAt(0).toLowerCase() + label.slice(1),
-  );
-  if (sentenceLabels.length < 2) return sentenceLabels[0] ?? "";
-  if (sentenceLabels.length === 2) return sentenceLabels.join(" and ");
-  return `${sentenceLabels.slice(0, -1).join(", ")}, and ${sentenceLabels.at(-1)}`;
 }
 
-function omitSupersededLifecycleMarkers<T>(
-  entries: readonly T[],
-  workEntryFor: (entry: T) => WorkLogEntry,
-): T[] {
-  const laterTerminalIdentities = new Set<string>();
-  const reversedEntries: T[] = [];
-
-  for (let index = entries.length - 1; index >= 0; index -= 1) {
-    const entry = entries[index]!;
-    const workEntry = workEntryFor(entry);
-    const normalizedLabel = normalizeCompactToolLabel(workEntry.toolTitle ?? workEntry.label);
-    const identity = [
-      workEntry.turnId ?? "no-turn",
-      workEntry.itemType ?? "",
-      normalizedLabel,
-    ].join("\u001f");
-    const isStatuslessIdlessMarker =
-      workEntry.toolCallId === undefined &&
-      workEntry.toolLifecycleStatus === undefined &&
-      (workEntry.sourceActivityKind === "tool.started" ||
-        workEntry.sourceActivityKind === "tool.updated");
-    if (isStatuslessIdlessMarker && laterTerminalIdentities.has(identity)) continue;
-
-    reversedEntries.push(entry);
-    if (
-      workEntry.sourceActivityKind === "tool.completed" ||
-      (workEntry.toolLifecycleStatus !== undefined &&
-        workEntry.toolLifecycleStatus !== "inProgress")
-    ) {
-      laterTerminalIdentities.add(identity);
+/** Summarizes at most two action categories; every omitted call still counts in the remainder. */
+export function summarizeToolGroup(entries: ReadonlyArray<WorkLogEntry>): {
+  summary: string;
+  hasFailure: boolean;
+} {
+  const groups = new Map<
+    ToolGroupAction | T3McpToolSummaryAction,
+    {
+      action: ToolGroupAction;
+      t3Action: T3McpToolSummaryAction | null;
+      entries: WorkLogEntry[];
     }
+  >();
+  for (const entry of entries) {
+    const item = entry.structuredPayload ?? entry.projectedItem?.item;
+    const t3Action = resolveT3McpToolSummaryAction(
+      (item?.type === "dynamic_tool" ? item.toolName : null) ?? entry.toolTitle ?? entry.label,
+    );
+    const action = toolGroupAction(entry);
+    const key = t3Action ?? action;
+    const group = groups.get(key);
+    if (group) group.entries.push(entry);
+    else groups.set(key, { action, t3Action, entries: [entry] });
   }
-
-  return reversedEntries.toReversed();
+  const summaries = [...groups].map(([action, group], index) => ({
+    index,
+    count: group.entries.length,
+    priority: summaryActionPriority(action),
+    ...(group.t3Action
+      ? summarizeT3ToolCalls(group.t3Action, group.entries.map(t3ToolSummaryCall))
+      : {
+          label: toolGroupActionLabel(
+            group.action,
+            toolGroupActionCount(group.action, group.entries),
+          ),
+          failedCount: group.entries.filter(workEntryDisplayIndicatesToolFailure).length,
+          unfinishedCount: 0,
+        }),
+  }));
+  const selected = summaries
+    .toSorted((a, b) => a.priority - b.priority || a.index - b.index)
+    .slice(0, 2)
+    .sort((a, b) => a.index - b.index);
+  const labels = selected.map(({ label }) => label);
+  const remainingCount = entries.length - selected.reduce((count, group) => count + group.count, 0);
+  if (remainingCount > 0) {
+    labels.push(`Performed ${remainingCount} other ${remainingCount === 1 ? "action" : "actions"}`);
+  }
+  const sentenceLabels = labels.map((label, index) =>
+    index === 0 ? label : label.charAt(0).toLowerCase() + label.slice(1),
+  );
+  const summary =
+    sentenceLabels.length < 3
+      ? sentenceLabels.join(" and ")
+      : `${sentenceLabels.slice(0, -1).join(", ")}, and ${sentenceLabels.at(-1)}`;
+  const failedCount = summaries.reduce((count, group) => count + group.failedCount, 0);
+  const unfinishedCount = summaries.reduce((count, group) => count + group.unfinishedCount, 0);
+  const statuses = [
+    ...(failedCount > 0 ? [`${failedCount} failed`] : []),
+    ...(unfinishedCount > 0 ? [`${unfinishedCount} unfinished`] : []),
+  ];
+  // Keep failure counts visible when a narrow timeline truncates the action text.
+  return { summary: [...statuses, summary].join(" · "), hasFailure: failedCount > 0 };
 }
 
 function toolGroupSummaryKind(entries: ReadonlyArray<WorkLogEntry>): ToolGroupSummaryKind {
@@ -402,9 +483,8 @@ function toolGroupSummaryKind(entries: ReadonlyArray<WorkLogEntry>): ToolGroupSu
 
   const fallbackKinds = new Set(
     entries.map((entry): ToolGroupSummaryKind => {
-      if (entry.itemType === "mcp_tool_call") return "other";
-      if (entry.itemType === "dynamic_tool_call") return "dynamic-tool";
-      if (entry.itemType === "collab_agent_tool_call" || entry.taskId) return "agent-tool";
+      if (entry.itemType === "dynamic_tool") return "dynamic-tool";
+      if (entry.itemType === "subagent") return "agent-tool";
       if (entry.tone === "thinking") return "agent-tool";
       if (entry.tone === "tool") return "tone-tool";
       return "other";
@@ -413,15 +493,12 @@ function toolGroupSummaryKind(entries: ReadonlyArray<WorkLogEntry>): ToolGroupSu
   return fallbackKinds.size === 1 ? fallbackKinds.values().next().value! : "mixed";
 }
 
-function workGroupIdentity(timelineEntryId: string, entry: WorkLogEntry): string {
-  return entry.toolCallId
-    ? `tool:${entry.turnId ?? "no-turn"}:${entry.toolCallId}`
-    : timelineEntryId;
+function workGroupId(timelineEntryId: string): string {
+  return `work-group:${timelineEntryId}`;
 }
 
-function workGroupId(timelineEntryId: string, entry: WorkLogEntry): string {
-  return `work-group:${workGroupIdentity(timelineEntryId, entry)}`;
-}
+export type TimelineToolPresentation = T3McpToolPresentation;
+export const resolveTimelineToolPresentation = resolveT3McpToolPresentation;
 
 export function resolveAssistantMessageCopyState({
   text,
@@ -456,8 +533,8 @@ function deriveTerminalAssistantMessageIds(timelineEntries: ReadonlyArray<Timeli
       continue;
     }
 
-    const responseKey = message.turnId
-      ? `turn:${message.turnId}`
+    const responseKey = message.runId
+      ? `turn:${message.runId}`
       : `unkeyed:${nullTurnResponseIndex}`;
     lastAssistantMessageIdByResponseKey.set(responseKey, message.id);
   }
@@ -466,66 +543,117 @@ function deriveTerminalAssistantMessageIds(timelineEntries: ReadonlyArray<Timeli
 }
 
 interface TurnFold {
-  turnId: TurnId;
+  runId: RunId;
   anchorEntryId: string;
   createdAt: string;
   hiddenEntryIds: ReadonlySet<string>;
   label: string;
 }
 
+interface SupersededAttemptFold {
+  readonly runId: RunId;
+  readonly attemptId: RunAttemptId;
+  readonly anchorEntryId: string;
+  readonly createdAt: string;
+  readonly hiddenEntryIds: ReadonlySet<string>;
+}
+
 /**
- * The session's running turn is authoritative when latestTurn briefly lags or
- * regresses behind it. Otherwise, the latest turn counts as unsettled while it
- * is still running (or has not recorded a completion). This is deliberately
- * keyed on turn lifecycle rather than transient working state: right after the
- * user sends a message, the previous turn is still the "active" one until the
- * server creates the new turn, and folding must not flicker through that window.
+ * Groups only provider output owned by an explicitly superseded V2 attempt.
+ * User messages remain visible because they are inputs to the logical run,
+ * including the steer message that started the replacement attempt.
  */
-function deriveUnsettledTurnId(
-  latestTurn: TimelineLatestTurn | null,
-  runningTurnId: TurnId | null,
-): TurnId | null {
-  if (runningTurnId !== null) {
-    return runningTurnId;
+function deriveSupersededAttemptFolds(
+  timelineEntries: ReadonlyArray<TimelineEntry>,
+): ReadonlyMap<string, SupersededAttemptFold> {
+  const entriesByAttemptId = new Map<RunAttemptId, TimelineEntry[]>();
+  for (const entry of timelineEntries) {
+    if (
+      entry.attempt?.status !== "superseded" ||
+      (entry.kind === "message" && entry.message.role === "user") ||
+      timelineEntryIsPersistentResourceCard(entry)
+    ) {
+      continue;
+    }
+    const entries = entriesByAttemptId.get(entry.attempt.id) ?? [];
+    entries.push(entry);
+    entriesByAttemptId.set(entry.attempt.id, entries);
   }
-  if (!latestTurn) {
-    return null;
+
+  const foldsByAnchorEntryId = new Map<string, SupersededAttemptFold>();
+  for (const entries of entriesByAttemptId.values()) {
+    const firstEntry = entries[0];
+    const attempt = firstEntry?.attempt;
+    if (firstEntry === undefined || attempt === undefined) continue;
+    foldsByAnchorEntryId.set(firstEntry.id, {
+      runId: attempt.runId,
+      attemptId: attempt.id,
+      anchorEntryId: firstEntry.id,
+      createdAt: firstEntry.createdAt,
+      hiddenEntryIds: new Set(entries.map((entry) => entry.id)),
+    });
   }
-  const isSettled = latestTurn.completedAt !== null && latestTurn.state !== "running";
-  return isSettled ? null : latestTurn.turnId;
+  return foldsByAnchorEntryId;
 }
 
-function lastUserMessageIndex(timelineEntries: ReadonlyArray<TimelineEntry>): number {
-  return timelineEntries.findLastIndex(
-    (entry) => entry.kind === "message" && entry.message.role === "user",
-  );
+/**
+ * The latest turn counts as unsettled while it is still running (or has not
+ * recorded a completion). This is deliberately keyed on the turn's own
+ * lifecycle rather than transient working state: right after the user sends
+ * a message, the previous turn is still the "active" one until the server
+ * creates the new turn, and folding must not flicker through that window.
+ */
+function deriveUnsettledRunId(latestRun: TimelineLatestRun | null): RunId | null {
+  if (!latestRun) {
+    return null;
+  }
+  const isSettled =
+    latestRun.completedAt !== null &&
+    latestRun.status !== "running" &&
+    latestRun.status !== "starting" &&
+    latestRun.status !== "waiting";
+  return isSettled ? null : latestRun.runId;
 }
 
-function timelineEntryTurnId(entry: TimelineEntry): TurnId | null {
-  if (entry.kind === "message") {
-    return entry.message.role === "assistant" ? (entry.message.turnId ?? null) : null;
+function timelineEntryFoldRunId(entry: TimelineEntry): RunId | null {
+  if (entry.kind === "message" && entry.message.role === "assistant") {
+    return entry.message.runId ?? null;
+  }
+  if (entry.kind === "work") {
+    return entry.entry.runId ?? null;
   }
   if (entry.kind === "turn-plan") {
-    return entry.turnPlan.turnId;
+    return entry.turnPlan.runId;
   }
-  if (entry.kind === "proposed-plan") {
-    return entry.proposedPlan.turnId;
+  if (entry.kind === "event" && timelineEntryIsPersistentResourceCard(entry)) {
+    return entry.projectedItem.item.runId;
   }
-  return entry.kind === "work" ? (entry.entry.turnId ?? null) : null;
+  return null;
 }
 
 /**
- * Settled turns keep their first and terminal assistant messages visible.
- * Everything between them folds behind a "Worked for ..." row anchored at
- * the first hidden entry. Keeping both ends prevents a short follow-up from
- * hiding a substantive opening response while still bounding noisy turns.
+ * Settled turns fold their commentary and tool activity behind a
+ * "Worked for ..." row anchored at the turn's first foldable entry; the
+ * terminal assistant message stays visible below the fold.
  */
 function deriveTurnFolds(input: {
   timelineEntries: ReadonlyArray<TimelineEntry>;
   terminalAssistantMessageIds: ReadonlySet<string>;
-  latestTurn: TimelineLatestTurn | null;
-  unsettledTurnId: TurnId | null;
+  latestRun: TimelineLatestRun | null;
+  unsettledRunId: RunId | null;
 }): ReadonlyMap<string, TurnFold> {
+  const interruptedRunIds = new Set<RunId>();
+  for (const entry of input.timelineEntries) {
+    if (
+      entry.kind === "event" &&
+      entry.projectedItem.item.runId !== null &&
+      (entry.projectedItem.item.type === "run_interrupt_request" ||
+        entry.projectedItem.item.type === "run_interrupt_result")
+    ) {
+      interruptedRunIds.add(entry.projectedItem.item.runId);
+    }
+  }
+
   interface TurnGroup {
     entries: Array<TimelineEntry>;
     terminalEntry: Extract<TimelineEntry, { kind: "message" }> | null;
@@ -538,7 +666,7 @@ function deriveTurnFolds(input: {
      */
     startBoundary: string | null;
   }
-  const groupsByTurnId = new Map<TurnId, TurnGroup>();
+  const groupsByRunId = new Map<RunId, TurnGroup>();
 
   let pendingUserBoundary: string | null = null;
   for (const entry of input.timelineEntries) {
@@ -546,16 +674,11 @@ function deriveTurnFolds(input: {
       pendingUserBoundary = entry.message.createdAt;
       continue;
     }
-    const turnId =
-      entry.kind === "message" && entry.message.role === "assistant"
-        ? (entry.message.turnId ?? null)
-        : entry.kind === "work"
-          ? (entry.entry.turnId ?? null)
-          : null;
-    if (!turnId) {
+    const runId = timelineEntryFoldRunId(entry);
+    if (!runId) {
       continue;
     }
-    let group = groupsByTurnId.get(turnId);
+    let group = groupsByRunId.get(runId);
     if (!group) {
       group = {
         entries: [],
@@ -567,7 +690,7 @@ function deriveTurnFolds(input: {
         startBoundary: pendingUserBoundary,
       };
       pendingUserBoundary = null;
-      groupsByTurnId.set(turnId, group);
+      groupsByRunId.set(runId, group);
     }
     group.entries.push(entry);
     if (entry.kind === "message") {
@@ -581,51 +704,38 @@ function deriveTurnFolds(input: {
   }
 
   const foldsByAnchorEntryId = new Map<string, TurnFold>();
-  for (const [turnId, group] of groupsByTurnId) {
-    if (turnId === input.unsettledTurnId) {
+  for (const [runId, group] of groupsByRunId) {
+    if (runId === input.unsettledRunId || interruptedRunIds.has(runId)) {
       continue;
     }
     if (group.hasStreamingMessage) {
       continue;
     }
-    const firstAssistantEntry = group.entries.find(
-      (entry): entry is Extract<TimelineEntry, { kind: "message" }> => entry.kind === "message",
-    );
     const hiddenEntryIds = new Set<string>();
     for (const entry of group.entries) {
-      if (entry.id === firstAssistantEntry?.id || entry.id === group.terminalEntry?.id) {
-        continue;
-      }
-      // Agent-spawn CTA rows never fold: workflows outlive their launching
-      // turn (dynamic spawns, background execution), and folding the CTA
-      // when the turn settles makes a still-running fleet invisible.
-      if (entry.kind === "work" && entry.entry.agentSpawn !== undefined) {
-        continue;
+      if (entry.id !== group.terminalEntry?.id && !timelineEntryIsPersistentResourceCard(entry)) {
+        hiddenEntryIds.add(entry.id);
       }
-      hiddenEntryIds.add(entry.id);
     }
     if (hiddenEntryIds.size === 0) {
       continue;
     }
 
     const firstEntry = group.entries[0];
-    const firstHiddenEntry = group.entries.find((entry) => hiddenEntryIds.has(entry.id));
     const lastEntry = group.entries.at(-1);
-    if (!firstEntry || !firstHiddenEntry || !lastEntry) {
+    if (!firstEntry || !lastEntry) {
       continue;
     }
 
     const isLatestInterruptedTurn =
-      input.latestTurn?.turnId === turnId && input.latestTurn.state === "interrupted";
+      input.latestRun?.runId === runId && input.latestRun.status === "interrupted";
     // A turn cut short by a steer leaves trailing work entries behind its
     // terminal message — take whichever ended last.
     const lastEntryEnd =
       lastEntry.kind === "message" ? lastEntry.message.updatedAt : lastEntry.createdAt;
     const elapsedMs =
-      input.latestTurn?.turnId === turnId &&
-      input.latestTurn.startedAt &&
-      input.latestTurn.completedAt
-        ? computeElapsedMs(input.latestTurn.startedAt, input.latestTurn.completedAt)
+      input.latestRun?.runId === runId && input.latestRun.startedAt && input.latestRun.completedAt
+        ? computeElapsedMs(input.latestRun.startedAt, input.latestRun.completedAt)
         : computeElapsedMs(
             group.startBoundary ?? firstEntry.createdAt,
             maxIsoTimestamp(group.terminalEntry?.message.updatedAt ?? null, lastEntryEnd) ??
@@ -640,10 +750,10 @@ function deriveTurnFolds(input: {
         ? `Worked for ${duration}`
         : "Worked";
 
-    foldsByAnchorEntryId.set(firstHiddenEntry.id, {
-      turnId,
-      anchorEntryId: firstHiddenEntry.id,
-      createdAt: firstHiddenEntry.createdAt,
+    foldsByAnchorEntryId.set(firstEntry.id, {
+      runId,
+      anchorEntryId: firstEntry.id,
+      createdAt: firstEntry.createdAt,
       hiddenEntryIds,
       label,
     });
@@ -653,9 +763,9 @@ function deriveTurnFolds(input: {
 
 export function deriveMessagesTimelineRows(input: {
   timelineEntries: ReadonlyArray<TimelineEntry>;
-  latestTurn?: TimelineLatestTurn | null;
-  runningTurnId?: TurnId | null;
-  expandedTurnIds?: ReadonlySet<TurnId>;
+  latestRun?: TimelineLatestRun | null;
+  expandedRunIds?: ReadonlySet<RunId>;
+  expandedAttemptIds?: ReadonlySet<RunAttemptId>;
   expandedWorkGroupIds?: ReadonlySet<string>;
   isWorking: boolean;
   turnDiffSummaryByAssistantMessageId: ReadonlyMap<MessageId, TurnDiffSummary>;
@@ -666,98 +776,35 @@ export function deriveMessagesTimelineRows(input: {
     input.timelineEntries.flatMap((entry) => (entry.kind === "message" ? [entry.message] : [])),
   );
   const terminalAssistantMessageIds = deriveTerminalAssistantMessageIds(input.timelineEntries);
-  const unsettledTurnId = deriveUnsettledTurnId(
-    input.latestTurn ?? null,
-    input.runningTurnId ?? null,
-  );
+  const unsettledRunId = deriveUnsettledRunId(input.latestRun ?? null);
+  const supersededFoldsByAnchorEntryId = deriveSupersededAttemptFolds(input.timelineEntries);
   const foldsByAnchorEntryId = deriveTurnFolds({
     timelineEntries: input.timelineEntries,
     terminalAssistantMessageIds,
-    latestTurn: input.latestTurn ?? null,
-    unsettledTurnId,
+    latestRun: input.latestRun ?? null,
+    unsettledRunId,
   });
   const collapsedEntryIds = new Set<string>();
   for (const fold of foldsByAnchorEntryId.values()) {
-    if (!input.expandedTurnIds?.has(fold.turnId)) {
+    if (!input.expandedRunIds?.has(fold.runId)) {
       for (const entryId of fold.hiddenEntryIds) {
         collapsedEntryIds.add(entryId);
       }
     }
   }
-
-  let activeTurnHeaderIndex = input.timelineEntries.length;
-  if (input.isWorking) {
-    const latestUserMessageIndex = lastUserMessageIndex(input.timelineEntries);
-    const firstOwnedAfterUser =
-      unsettledTurnId === null
-        ? -1
-        : input.timelineEntries.findIndex(
-            (entry, index) =>
-              index > latestUserMessageIndex && timelineEntryTurnId(entry) === unsettledTurnId,
-          );
-    activeTurnHeaderIndex =
-      firstOwnedAfterUser >= 0 ? firstOwnedAfterUser : latestUserMessageIndex + 1;
+  const collapsedSupersededEntryIds = new Set<string>();
+  for (const fold of supersededFoldsByAnchorEntryId.values()) {
+    if (!input.expandedAttemptIds?.has(fold.attemptId)) {
+      for (const entryId of fold.hiddenEntryIds) {
+        collapsedSupersededEntryIds.add(entryId);
+      }
+    }
   }
-  const entryBelongsToActiveTurn = (entry: TimelineEntry, index: number) =>
-    input.isWorking &&
-    index >= activeTurnHeaderIndex &&
-    (unsettledTurnId === null || timelineEntryTurnId(entry) === unsettledTurnId);
   const workEntryIsInActiveRun = (entry: WorkLogEntry) =>
     input.isWorking &&
-    unsettledTurnId !== null &&
+    unsettledRunId !== null &&
     entry.toolLifecycleStatus === "inProgress" &&
-    entry.turnId === unsettledTurnId;
-  const activeToolEntries: Array<Extract<TimelineEntry, { kind: "work" }>> = [];
-  for (let index = input.timelineEntries.length - 1; index >= activeTurnHeaderIndex; index -= 1) {
-    const entry = input.timelineEntries[index]!;
-    if (
-      !entryBelongsToActiveTurn(entry, index) ||
-      entry.kind !== "work" ||
-      entry.entry.agentSpawn !== undefined ||
-      entry.entry.tone === "error"
-    ) {
-      break;
-    }
-    activeToolEntries.unshift(entry);
-  }
-  const activeWorkEntryIds = new Set(activeToolEntries.map((entry) => entry.id));
-  const visibleActiveToolEntries = omitSupersededLifecycleMarkers(
-    activeToolEntries.filter((entry) => workEntryIsVisibleInGroup(entry.entry, true)),
-    (entry) => entry.entry,
-  );
-  const activeWorkAnchor = activeToolEntries[0];
-  const latestActiveToolEntry = visibleActiveToolEntries.at(-1);
-  const activeWorkPlacementEntryId = latestActiveToolEntry?.id;
-  const activeWorkRow =
-    activeWorkAnchor && latestActiveToolEntry
-      ? (() => {
-          const groupId = workGroupId(activeWorkAnchor.id, activeWorkAnchor.entry);
-          return {
-            kind: "work-live" as const,
-            id: `work-live:${workGroupIdentity(activeWorkAnchor.id, activeWorkAnchor.entry)}`,
-            createdAt: activeWorkAnchor.createdAt,
-            entry: latestActiveToolEntry.entry,
-            groupedEntries: visibleActiveToolEntries.map((entry) => entry.entry),
-            groupId,
-            expanded: input.expandedWorkGroupIds?.has(groupId) ?? false,
-          };
-        })()
-      : null;
-  const appendActiveWorkRows = () => {
-    if (activeWorkRow === null) return;
-    nextRows.push(activeWorkRow);
-    if (!activeWorkRow.expanded) return;
-    for (const [entryIndex, workEntry] of activeWorkRow.groupedEntries.entries()) {
-      nextRows.push({
-        kind: "work",
-        id: workEntry.id,
-        createdAt: workEntry.createdAt,
-        groupedEntries: [workEntry],
-        isExpandedToolGroupEntry: true,
-        isLastExpandedToolGroupEntry: entryIndex === activeWorkRow.groupedEntries.length - 1,
-      });
-    }
-  };
+    entry.runId === unsettledRunId;
 
   for (let index = 0; index < input.timelineEntries.length; index += 1) {
     const timelineEntry = input.timelineEntries[index];
@@ -765,19 +812,24 @@ export function deriveMessagesTimelineRows(input: {
       continue;
     }
 
-    if (timelineEntry.id === activeWorkPlacementEntryId) {
-      appendActiveWorkRows();
+    // The terminal interrupt result is the useful timeline marker. The
+    // preceding request is transient bookkeeping and duplicates that marker.
+    if (
+      timelineEntry.kind === "event" &&
+      timelineEntry.projectedItem.item.type === "run_interrupt_request"
+    ) {
+      continue;
     }
 
-    const anchoredTurnFold = foldsByAnchorEntryId.get(timelineEntry.id);
-    if (anchoredTurnFold) {
+    const turnFold = foldsByAnchorEntryId.get(timelineEntry.id);
+    if (turnFold) {
       nextRows.push({
         kind: "turn-fold",
-        id: `turn-fold:${anchoredTurnFold.turnId}`,
-        createdAt: anchoredTurnFold.createdAt,
-        turnId: anchoredTurnFold.turnId,
-        label: anchoredTurnFold.label,
-        expanded: input.expandedTurnIds?.has(anchoredTurnFold.turnId) ?? false,
+        id: `turn-fold:${turnFold.runId}`,
+        createdAt: turnFold.createdAt,
+        runId: turnFold.runId,
+        label: turnFold.label,
+        expanded: input.expandedRunIds?.has(turnFold.runId) ?? false,
       });
     }
 
@@ -785,12 +837,25 @@ export function deriveMessagesTimelineRows(input: {
       continue;
     }
 
-    if (activeWorkEntryIds.has(timelineEntry.id)) {
+    const supersededFold = supersededFoldsByAnchorEntryId.get(timelineEntry.id);
+    if (supersededFold) {
+      nextRows.push({
+        kind: "attempt-fold",
+        id: `attempt-fold:${supersededFold.attemptId}`,
+        createdAt: supersededFold.createdAt,
+        runId: supersededFold.runId,
+        attemptId: supersededFold.attemptId,
+        label: "Superseded attempt",
+        expanded: input.expandedAttemptIds?.has(supersededFold.attemptId) ?? false,
+      });
+    }
+
+    if (collapsedSupersededEntryIds.has(timelineEntry.id)) {
       continue;
     }
 
     if (timelineEntry.kind === "work") {
-      if (timelineEntry.entry.agentSpawn !== undefined || timelineEntry.entry.tone === "error") {
+      if (timelineEntry.entry.tone === "error") {
         nextRows.push({
           kind: "work",
           id: timelineEntry.id,
@@ -808,32 +873,38 @@ export function deriveMessagesTimelineRows(input: {
         if (
           !nextEntry ||
           nextEntry.kind !== "work" ||
-          nextEntry.entry.agentSpawn !== undefined ||
           nextEntry.entry.tone === "error" ||
-          activeWorkEntryIds.has(nextEntry.id) ||
           collapsedEntryIds.has(nextEntry.id) ||
-          foldsByAnchorEntryId.has(nextEntry.id)
+          collapsedSupersededEntryIds.has(nextEntry.id) ||
+          foldsByAnchorEntryId.has(nextEntry.id) ||
+          supersededFoldsByAnchorEntryId.has(nextEntry.id) ||
+          (nextEntry.entry.runId ?? null) !== (timelineEntry.entry.runId ?? null) ||
+          nextEntry.attempt?.id !== timelineEntry.attempt?.id
         ) {
           break;
         }
         groupedEntries.push(nextEntry.entry);
         cursor += 1;
       }
-      const visibleGroupedEntries = omitSupersededLifecycleMarkers(
-        groupedEntries.filter((entry) =>
-          workEntryIsVisibleInGroup(entry, workEntryIsInActiveRun(entry)),
-        ),
-        (entry) => entry,
+      const isActiveTail =
+        input.isWorking &&
+        unsettledRunId !== null &&
+        timelineEntry.entry.runId === unsettledRunId &&
+        cursor === input.timelineEntries.length;
+      const visibleGroupedEntries = groupedEntries.filter((entry) =>
+        workEntryIsVisibleInGroup(entry, isActiveTail || workEntryIsInActiveRun(entry)),
       );
       if (visibleGroupedEntries.length > 0) {
         const activeInProgressToolEntries = visibleGroupedEntries.filter(workEntryIsInActiveRun);
-        if (activeInProgressToolEntries.length > 0) {
-          const groupId = workGroupId(timelineEntry.id, timelineEntry.entry);
+        if (isActiveTail || activeInProgressToolEntries.length > 0) {
+          const groupId = workGroupId(timelineEntry.id);
           const expanded = input.expandedWorkGroupIds?.has(groupId) ?? false;
-          const latestActiveToolEntry = activeInProgressToolEntries.at(-1)!;
+          const latestActiveToolEntry = (
+            isActiveTail ? visibleGroupedEntries : activeInProgressToolEntries
+          ).at(-1)!;
           nextRows.push({
             kind: "work-live",
-            id: `work-live:${workGroupIdentity(timelineEntry.id, timelineEntry.entry)}`,
+            id: `work-live:${timelineEntry.id}`,
             createdAt: timelineEntry.createdAt,
             entry: latestActiveToolEntry,
             groupedEntries: visibleGroupedEntries,
@@ -853,10 +924,10 @@ export function deriveMessagesTimelineRows(input: {
             }
           }
         } else {
-          const groupId = workGroupId(timelineEntry.id, timelineEntry.entry);
+          const groupId = workGroupId(timelineEntry.id);
           const expanded = input.expandedWorkGroupIds?.has(groupId) ?? false;
           const summaryKind = toolGroupSummaryKind(visibleGroupedEntries);
-          const latestToolEntry = visibleGroupedEntries.findLast(workLogEntryIsToolLike);
+          const groupSummary = summarizeToolGroup(visibleGroupedEntries);
           nextRows.push({
             kind: "work-toggle",
             id: `work-toggle:${timelineEntry.id}`,
@@ -868,11 +939,9 @@ export function deriveMessagesTimelineRows(input: {
               visibleGroupedEntries.length === 1 &&
               !workLogEntryIsToolLike(visibleGroupedEntries[0]!)
                 ? visibleGroupedEntries[0]!.label
-                : summarizeToolGroup(visibleGroupedEntries),
+                : groupSummary.summary,
             summaryKind,
-            hasFailure:
-              latestToolEntry !== undefined &&
-              workEntryDisplayIndicatesToolFailure(latestToolEntry),
+            hasFailure: groupSummary.hasFailure,
           });
           if (expanded) {
             for (const [entryIndex, workEntry] of visibleGroupedEntries.entries()) {
@@ -912,10 +981,20 @@ export function deriveMessagesTimelineRows(input: {
       continue;
     }
 
+    if (timelineEntry.kind === "event") {
+      nextRows.push({
+        kind: "event",
+        id: timelineEntry.id,
+        createdAt: timelineEntry.createdAt,
+        projectedItem: timelineEntry.projectedItem,
+      });
+      continue;
+    }
+
     const assistantTurnStillInProgress =
       timelineEntry.message.role === "assistant" &&
-      unsettledTurnId !== null &&
-      timelineEntry.message.turnId === unsettledTurnId;
+      unsettledRunId !== null &&
+      timelineEntry.message.runId === unsettledRunId;
 
     const durationStart =
       durationStartByMessageId.get(timelineEntry.message.id) ?? timelineEntry.message.createdAt;
@@ -933,6 +1012,9 @@ export function deriveMessagesTimelineRows(input: {
       id: timelineEntry.id,
       createdAt: timelineEntry.createdAt,
       message: timelineEntry.message,
+      ...(timelineEntry.projectedItem === undefined
+        ? {}
+        : { projectedItem: timelineEntry.projectedItem }),
       durationStart,
       showAssistantMeta,
       showAssistantCopyButton: showAssistantMeta,
@@ -981,16 +1063,33 @@ function isRowUnchanged(a: MessagesTimelineRow, b: MessagesTimelineRow): boolean
       return a.createdAt === bf.createdAt && a.label === bf.label && a.expanded === bf.expanded;
     }
 
+    case "attempt-fold": {
+      const bf = b as typeof a;
+      return a.createdAt === bf.createdAt && a.label === bf.label && a.expanded === bf.expanded;
+    }
+
     case "proposed-plan":
       return a.proposedPlan === (b as typeof a).proposedPlan;
 
     case "turn-plan": {
       const bp = b as typeof a;
-      // Plans rewrite in place: compare the snapshot's identity fields so an
-      // unchanged plan keeps its row reference (virtualization stability).
-      return a.createdAt === bp.createdAt && a.turnPlan.plan === bp.turnPlan.plan;
+      // Plans rewrite in place: compare step snapshots so an unchanged plan
+      // keeps its row reference (virtualization stability).
+      const aSteps = a.turnPlan.plan.steps;
+      const bSteps = bp.turnPlan.plan.steps;
+      return (
+        a.createdAt === bp.createdAt &&
+        aSteps.length === bSteps.length &&
+        aSteps.every(
+          (step, index) =>
+            step.step === bSteps[index]!.step && step.status === bSteps[index]!.status,
+        )
+      );
     }
 
+    case "event":
+      return a.projectedItem === (b as typeof a).projectedItem;
+
     case "work": {
       const bw = b as typeof a;
       return (
@@ -1028,6 +1127,7 @@ function isRowUnchanged(a: MessagesTimelineRow, b: MessagesTimelineRow): boolean
       const bm = b as typeof a;
       return (
         a.message === bm.message &&
+        a.projectedItem === bm.projectedItem &&
         a.durationStart === bm.durationStart &&
         a.showAssistantMeta === bm.showAssistantMeta &&
         a.showAssistantCopyButton === bm.showAssistantCopyButton &&
diff --git a/apps/web/src/components/chat/MessagesTimeline.test.tsx b/apps/web/src/components/chat/MessagesTimeline.test.tsx
index 67060a28d647..4eb0cdee5bbf 100644
--- a/apps/web/src/components/chat/MessagesTimeline.test.tsx
+++ b/apps/web/src/components/chat/MessagesTimeline.test.tsx
@@ -1,10 +1,34 @@
-import { CheckpointRef, EnvironmentId, MessageId, TurnId } from "@t3tools/contracts";
-import { codexFeedbackMessage } from "@t3tools/client-runtime/state/threads";
+import { CheckpointRef, EnvironmentId, MessageId, RunId, ThreadId } from "@t3tools/contracts";
 import { createRef, type ReactNode, type Ref } from "react";
 import { renderToStaticMarkup } from "react-dom/server";
-import { beforeAll, describe, expect, it, vi } from "vite-plus/test";
+import { beforeAll, beforeEach, describe, expect, it, vi } from "vite-plus/test";
 import type { LegendListRef } from "@legendapp/list/react";
 
+const activityTestState = vi.hoisted(() => ({ expanded: false }));
+
+vi.mock("./MessagesTimeline.logic", async (importOriginal) => {
+  const logic = await importOriginal<typeof import("./MessagesTimeline.logic")>();
+  return {
+    ...logic,
+    deriveMessagesTimelineRows(input: Parameters<typeof logic.deriveMessagesTimelineRows>[0]) {
+      const rows = logic.deriveMessagesTimelineRows(input);
+      if (!activityTestState.expanded) return rows;
+      return logic.deriveMessagesTimelineRows({
+        ...input,
+        expandedWorkGroupIds: new Set(
+          rows.flatMap((row) =>
+            row.kind === "work-toggle" || row.kind === "work-live" ? [row.groupId] : [],
+          ),
+        ),
+      });
+    },
+  };
+});
+
+beforeEach(() => {
+  activityTestState.expanded = false;
+});
+
 vi.mock("@legendapp/list/react", async () => {
   const legendListTestId = "legend-list";
 
@@ -19,6 +43,7 @@ vi.mock("@legendapp/list/react", async () => {
       anchorMaxSize?: number;
       anchorOffset?: number;
       onReady?: (info: { anchorIndex: number }) => void;
+      onSizeChanged?: (size: number) => void;
     };
     contentInsetEndAdjustment?: number;
     className?: string;
@@ -42,6 +67,7 @@ vi.mock("@legendapp/list/react", async () => {
     ref?: Ref<LegendListRef>;
   }) => {
     if (props.anchoredEndSpace) {
+      props.anchoredEndSpace.onSizeChanged?.(240);
       props.anchoredEndSpace.onReady?.({ anchorIndex: props.anchoredEndSpace.anchorIndex });
     }
     return (
@@ -177,12 +203,15 @@ const MESSAGE_CREATED_AT = "2026-03-17T19:12:28.000Z";
 function buildProps() {
   return {
     isWorking: false,
+    activeTurnInProgress: false,
     listRef: createRef<LegendListRef | null>(),
-    latestTurn: null,
-    runningTurnId: null,
+    latestRun: null,
     turnDiffSummaryByAssistantMessageId: new Map(),
     routeThreadKey: "environment-local:thread-1",
     onOpenTurnDiff: () => {},
+    onOpenThread: () => {},
+    onForkFromRun: async () => {},
+    onRollbackCheckpoint: () => {},
     revertTurnCountByUserMessageId: new Map(),
     onRevertUserMessage: () => {},
     isRevertingCheckpoint: false,
@@ -194,6 +223,7 @@ function buildProps() {
     workspaceRoot: undefined,
     anchorMessageId: null,
     onAnchorReady: () => {},
+    onAnchorSizeChanged: () => {},
     contentInsetEndAdjustment: 0,
     liveFollowEnabled: true,
     onIsAtEndChange: () => {},
@@ -216,7 +246,7 @@ function buildUserTimelineEntry(text: string) {
       id: MessageId.make("message-1"),
       role: "user" as const,
       text,
-      turnId: null,
+      runId: null,
       createdAt: MESSAGE_CREATED_AT,
       updatedAt: MESSAGE_CREATED_AT,
       streaming: false,
@@ -236,97 +266,176 @@ function buildAssistantTimelineEntry(text: string) {
 }
 
 describe("MessagesTimeline", () => {
-  it("renders a feedback command and its pending response as normal thread messages", () => {
-    const submission = {
-      id: MessageId.make("feedback-command"),
-      command: "/feedback The agent stopped early.",
-      createdAt: MESSAGE_CREATED_AT,
-      status: "uploading" as const,
-    };
-    const messages = [
-      codexFeedbackMessage(submission),
-      codexFeedbackMessage(submission, "assistant"),
-    ];
+  it("preserves arbitrary XML-like tags and comparisons in rendered user messages", async () => {
+    const { MessagesTimeline } = await import("./MessagesTimeline");
     const markup = renderToStaticMarkup(
       <MessagesTimeline
         {...buildProps()}
-        timelineEntries={messages.map((message) => ({
-          id: message.id,
-          kind: "message" as const,
-          createdAt: message.createdAt,
-          message,
-        }))}
+        timelineEntries={[
+          buildUserTimelineEntry(
+            [
+              'Without reading a file, do you have <global-agent-instructions scope="workspace">',
+              'Before <nested data-value="a&b">inside</nested> after',
+              "</global-agent-instructions> in your context?",
+              "Comparison: 2 < 3 and 5 > 4.",
+            ].join("\n"),
+          ),
+        ]}
       />,
     );
 
-    expect(markup).toContain("/feedback The agent stopped early.");
-    expect(markup).toContain("Sending feedback to OpenAI...");
+    expect(markup).toContain("&lt;global-agent-instructions scope=&quot;workspace&quot;&gt;");
+    expect(markup).toContain(
+      "Before &lt;nested data-value=&quot;a&amp;b&quot;&gt;inside&lt;/nested&gt; after",
+    );
+    expect(markup).toContain("&lt;/global-agent-instructions&gt; in your context?");
+    expect(markup).toContain("Comparison: 2 &lt; 3 and 5 &gt; 4.");
   });
 
-  it("renders the returned Codex thread ID in the feedback response", () => {
-    const submission = {
-      id: MessageId.make("feedback-command"),
-      command: "/feedback The agent stopped early.",
-      createdAt: MESSAGE_CREATED_AT,
-      status: "sent" as const,
-      feedbackId: "codex-thread-1",
-    };
-    const messages = [
-      codexFeedbackMessage(submission),
-      codexFeedbackMessage(submission, "assistant"),
-    ];
+  it("preserves XML-like source inside user code spans and fences", async () => {
+    const { MessagesTimeline } = await import("./MessagesTimeline");
     const markup = renderToStaticMarkup(
       <MessagesTimeline
         {...buildProps()}
-        timelineEntries={messages.map((message) => ({
-          id: message.id,
-          kind: "message" as const,
-          createdAt: message.createdAt,
-          message,
-        }))}
+        timelineEntries={[
+          buildUserTimelineEntry(
+            [
+              'Inline `<tag attr="x">`',
+              "",
+              "```xml",
+              '<root><child enabled="true" /></root>',
+              "```",
+            ].join("\n"),
+          ),
+        ]}
       />,
     );
 
-    expect(markup).toContain("Feedback sent to OpenAI.");
-    expect(markup).toContain("codex-thread-1");
+    expect(markup).toContain('<code data-inline-code="">&lt;tag attr=&quot;x&quot;&gt;</code>');
+    expect(markup).toContain("&lt;root&gt;&lt;child enabled=&quot;true&quot; /&gt;&lt;/root&gt;");
   });
 
-  it("renders the worked-for row at assistant response text size", () => {
-    const turnId = TurnId.make("turn-with-fold");
-    const assistantEntry = buildAssistantTimelineEntry("Done.");
+  it("does not render markdown title attributes in user messages", async () => {
+    const { MessagesTimeline } = await import("./MessagesTimeline");
     const markup = renderToStaticMarkup(
       <MessagesTimeline
         {...buildProps()}
-        latestTurn={{
-          turnId,
-          state: "completed",
-          startedAt: "2026-03-17T19:12:20.000Z",
-          completedAt: "2026-03-17T19:12:28.000Z",
-        }}
         timelineEntries={[
-          {
-            id: "work-entry-with-fold",
-            kind: "work",
-            createdAt: "2026-03-17T19:12:22.000Z",
-            entry: {
-              id: "work-with-fold",
-              createdAt: "2026-03-17T19:12:22.000Z",
-              turnId,
-              label: "Ran command",
-              tone: "tool",
-              toolLifecycleStatus: "completed",
-            },
-          },
-          {
-            ...assistantEntry,
-            message: { ...assistantEntry.message, turnId },
-          },
+          buildUserTimelineEntry(
+            '[link](https://example.com "link tip") ![image](https://example.com/image.png "image tip")',
+          ),
+        ]}
+      />,
+    );
+
+    expect(markup).toContain('href="https://example.com"');
+    expect(markup).toContain('src="https://example.com/image.png"');
+    expect(markup).not.toContain('title="link tip"');
+    expect(markup).not.toContain('title="image tip"');
+  });
+
+  it("renders unsafe user HTML as inert source text", async () => {
+    const { MessagesTimeline } = await import("./MessagesTimeline");
+    const markup = renderToStaticMarkup(
+      <MessagesTimeline
+        {...buildProps()}
+        timelineEntries={[
+          buildUserTimelineEntry(
+            '<script>globalThis.__t3Xss = 1</script><img src="x" onerror="globalThis.__t3Xss = 2">',
+          ),
+        ]}
+      />,
+    );
+
+    expect(markup).toContain("&lt;script&gt;globalThis.__t3Xss = 1&lt;/script&gt;");
+    expect(markup).toContain(
+      "&lt;img src=&quot;x&quot; onerror=&quot;globalThis.__t3Xss = 2&quot;&gt;",
+    );
+    expect(markup).not.toMatch(/<script(?:\s|>)/i);
+    expect(markup).not.toMatch(/<img(?:\s|>)/i);
+  });
+
+  it("continues to render sanitized raw HTML in assistant messages", async () => {
+    const { MessagesTimeline } = await import("./MessagesTimeline");
+    const markup = renderToStaticMarkup(
+      <MessagesTimeline
+        {...buildProps()}
+        timelineEntries={[
+          buildAssistantTimelineEntry("<details><summary>More</summary>Details</details>"),
+        ]}
+      />,
+    );
+
+    expect(markup).toContain('data-markdown-details=""');
+    expect(markup).toContain("More");
+    expect(markup).not.toContain("&lt;details&gt;");
+  });
+
+  it("sanitizes executable HTML while preserving supported assistant markup", async () => {
+    const { MessagesTimeline } = await import("./MessagesTimeline");
+    const markup = renderToStaticMarkup(
+      <MessagesTimeline
+        {...buildProps()}
+        timelineEntries={[
+          buildAssistantTimelineEntry(
+            [
+              '<details open onclick="globalThis.__t3Xss = 1">',
+              "<summary>Safe details</summary>",
+              "<script>globalThis.__t3Xss = 2</script>",
+              '<img src="x" onerror="globalThis.__t3Xss = 3">',
+              '<a href="javascript:globalThis.__t3Xss = 4">Unsafe link</a>',
+              "</details>",
+            ].join(""),
+          ),
         ]}
       />,
     );
 
-    expect(markup).toContain("Worked for 8.0s");
-    expect(markup).toContain("px-1 text-sm leading-relaxed text-muted-foreground");
+    expect(markup).toContain('data-markdown-details=""');
+    expect(markup).toContain("Safe details");
+    expect(markup).not.toMatch(/<script(?:\s|>)/i);
+    expect(markup).not.toContain("onclick=");
+    expect(markup).not.toContain("onerror=");
+    expect(markup).not.toContain("javascript:");
+    expect(markup).not.toContain("globalThis.__t3Xss");
+  });
+  it("renders progressive history controls ahead of the bounded timeline", () => {
+    const markup = renderToStaticMarkup(
+      <MessagesTimeline
+        {...buildProps()}
+        timelineEntries={[buildUserTimelineEntry("Recent activity")]}
+        historyControls={{
+          hasMoreHistory: true,
+          loading: false,
+          error: "Earlier activity could not be loaded.",
+          onLoadEarlier: () => {},
+        }}
+      />,
+    );
+
+    expect(markup).toContain('aria-label="Load earlier activity"');
+    expect(markup).toContain("Load earlier activity");
+    expect(markup).toContain("Earlier activity could not be loaded.");
+    expect(markup.indexOf("Load earlier activity")).toBeLessThan(markup.indexOf("Recent activity"));
+  });
+
+  it("keeps an empty bounded timeline actionable while earlier history loads", () => {
+    const markup = renderToStaticMarkup(
+      <MessagesTimeline
+        {...buildProps()}
+        timelineEntries={[]}
+        historyControls={{
+          hasMoreHistory: true,
+          loading: true,
+          error: null,
+          onLoadEarlier: () => {},
+        }}
+      />,
+    );
+
+    expect(markup).toContain("Loading earlier activity…");
+    expect(markup).toContain("disabled");
+    expect(markup).not.toContain("Send a message to start the conversation.");
   });
 
   it("uses the larger leading inset only when the top fade is enabled", () => {
@@ -347,13 +456,13 @@ describe("MessagesTimeline", () => {
 
   it("keeps assistant changed-files headers sticky below the thread header", () => {
     const assistantMessageId = MessageId.make("message-assistant-with-files");
-    const turnId = TurnId.make("turn-with-files");
+    const runId = RunId.make("run-with-files");
     const markup = renderToStaticMarkup(
       <MessagesTimeline
         {...buildProps()}
-        latestTurn={{
-          turnId,
-          state: "completed",
+        latestRun={{
+          runId,
+          status: "completed",
           startedAt: MESSAGE_CREATED_AT,
           completedAt: MESSAGE_CREATED_AT,
         }}
@@ -366,7 +475,7 @@ describe("MessagesTimeline", () => {
               id: assistantMessageId,
               role: "assistant",
               text: "Updated the fixture.",
-              turnId,
+              runId,
               createdAt: MESSAGE_CREATED_AT,
               updatedAt: MESSAGE_CREATED_AT,
               streaming: false,
@@ -378,7 +487,7 @@ describe("MessagesTimeline", () => {
             [
               assistantMessageId,
               {
-                turnId,
+                runId,
                 checkpointTurnCount: 1,
                 checkpointRef: CheckpointRef.make("checkpoint-with-files"),
                 status: "ready",
@@ -402,7 +511,7 @@ describe("MessagesTimeline", () => {
     expect(markup).toContain("1 changed file");
   });
 
-  it("treats only the strict list end as the live edge", async () => {
+  it("treats the follow re-arm band above the content bottom as the live edge", async () => {
     const {
       resolveTimelineIsAtEnd,
       resolveTimelineMinimapHasPersistentGutter,
@@ -441,7 +550,8 @@ describe("MessagesTimeline", () => {
         100,
       ),
     ).toBe(true);
-    // Geometry missing (older state shape): fall back to the strict flag.
+    // Geometry missing (older state shape): fall back to the nearEnd/strict flags.
+    expect(resolveTimelineIsAtEnd({ isNearEnd: true, isAtEnd: false })).toBe(true);
     expect(resolveTimelineIsAtEnd({ isAtEnd: false })).toBe(false);
 
     expect(resolveTimelineMinimapHeightStyle(5)).toBe("min(32px, calc(100vh - 18rem))");
@@ -489,12 +599,18 @@ describe("MessagesTimeline", () => {
     expect(resolveTimelineMinimapInteractiveWidth(40, true)).toBe("22rem");
   });
 
-  it("anchors the first user message using its measured height", () => {
+  it("anchors a sent attachment message using its measured height", () => {
     const onAnchorReady = vi.fn();
-    const firstEntry = {
-      ...buildUserTimelineEntry("First prompt."),
+    const onAnchorSizeChanged = vi.fn();
+    // Since #7897 only the first user row after the live edge may anchor, so
+    // the preceding row is an assistant reply rather than an older prompt.
+    const firstEntry = buildAssistantTimelineEntry("Earlier reply.");
+    const secondEntry = {
+      ...buildUserTimelineEntry("Newest prompt."),
+      id: "entry-2",
       message: {
-        ...buildUserTimelineEntry("First prompt.").message,
+        ...buildUserTimelineEntry("Newest prompt.").message,
+        id: MessageId.make("message-2"),
         attachments: [
           {
             type: "image" as const,
@@ -510,14 +626,15 @@ describe("MessagesTimeline", () => {
     const markup = renderToStaticMarkup(
       <MessagesTimeline
         {...buildProps()}
-        anchorMessageId={firstEntry.message.id}
+        anchorMessageId={secondEntry.message.id}
         onAnchorReady={onAnchorReady}
+        onAnchorSizeChanged={onAnchorSizeChanged}
         contentInsetEndAdjustment={144}
-        timelineEntries={[firstEntry]}
+        timelineEntries={[firstEntry, secondEntry]}
       />,
     );
 
-    expect(markup).toContain('data-anchor-index="0"');
+    expect(markup).toContain('data-anchor-index="1"');
     expect(markup).toContain('data-anchor-offset="16"');
     expect(markup).toContain('data-anchor-on-ready="true"');
     expect(markup).not.toContain("data-anchor-max-size=");
@@ -529,7 +646,8 @@ describe("MessagesTimeline", () => {
     expect(markup).toContain('data-maintain-visible-content-position-size="true"');
     expect(markup).toContain('data-maintain-visible-content-position-restore="true"');
     expect(onAnchorReady).toHaveBeenCalledOnce();
-    expect(onAnchorReady).toHaveBeenCalledWith(firstEntry.message.id, 0);
+    expect(onAnchorReady).toHaveBeenCalledWith(secondEntry.message.id, 1);
+    expect(onAnchorSizeChanged).toHaveBeenCalledWith(secondEntry.message.id, 240);
   });
 
   it("does not reserve end space for a follow-up user message", () => {
@@ -668,19 +786,19 @@ describe("MessagesTimeline", () => {
   });
 
   it("keeps reserved end space when tool work starts while reading history", () => {
-    const turnId = TurnId.make("turn-with-active-tool");
+    const runId = RunId.make("run-with-active-tool");
     const firstEntry = buildUserTimelineEntry("Run the command.");
     const markup = renderToStaticMarkup(
       <MessagesTimeline
         {...buildProps()}
         isWorking
-        latestTurn={{
-          turnId,
-          state: "running",
+        activeTurnInProgress
+        latestRun={{
+          runId,
+          status: "running",
           startedAt: MESSAGE_CREATED_AT,
           completedAt: null,
         }}
-        runningTurnId={turnId}
         anchorMessageId={firstEntry.message.id}
         liveFollowEnabled={false}
         timelineEntries={[
@@ -692,8 +810,7 @@ describe("MessagesTimeline", () => {
             entry: {
               id: "work-active-tool",
               createdAt: MESSAGE_CREATED_AT,
-              turnId,
-              toolCallId: "call-active-tool",
+              runId,
               label: "Run command",
               tone: "tool",
               itemType: "command_execution",
@@ -768,6 +885,8 @@ describe("MessagesTimeline", () => {
     );
 
     expect(markup).toContain("Show full message");
+    // LegendList owns ordinary end-follow (#5449): with live follow on and no
+    // anchored end space, its maintainScrollAtEnd is enabled.
     expect(markup).toContain('data-maintain-scroll-at-end="enabled"');
     expect(markup).toContain('data-maintain-scroll-at-end-animated="false"');
     expect(markup).toContain('data-maintain-scroll-at-end-data-change="true"');
@@ -788,141 +907,236 @@ describe("MessagesTimeline", () => {
 
     expect(markup).not.toContain("Show full message");
     expect(markup).toContain('data-user-message-collapsible="false"');
-    expect(markup).toContain("rounded-2xl bg-message p-3");
+    expect(markup).toContain("rounded-2xl bg-accent p-3");
   });
 
-  it("preserves arbitrary XML-like tags and comparisons in rendered user messages", async () => {
+  it("identifies user-role messages sent by another agent", async () => {
     const { MessagesTimeline } = await import("./MessagesTimeline");
-    const markup = renderToStaticMarkup(
+    const entry = buildUserTimelineEntry("Review this area");
+    const agentMarkup = renderToStaticMarkup(
       <MessagesTimeline
         {...buildProps()}
         timelineEntries={[
-          buildUserTimelineEntry(
-            [
-              'Without reading a file, do you have <global-agent-instructions scope="workspace">',
-              'Before <nested data-value="a&b">inside</nested> after',
-              "</global-agent-instructions> in your context?",
-              "Comparison: 2 < 3 and 5 > 4.",
-            ].join("\n"),
-          ),
+          {
+            ...entry,
+            message: { ...entry.message, createdBy: "agent", creationSource: "provider" },
+          },
         ]}
       />,
     );
-
-    expect(markup).toContain("&lt;global-agent-instructions scope=&quot;workspace&quot;&gt;");
-    expect(markup).toContain(
-      "Before &lt;nested data-value=&quot;a&amp;b&quot;&gt;inside&lt;/nested&gt; after",
+    const userMarkup = renderToStaticMarkup(
+      <MessagesTimeline {...buildProps()} timelineEntries={[entry]} />,
     );
-    expect(markup).toContain("&lt;/global-agent-instructions&gt; in your context?");
-    expect(markup).toContain("Comparison: 2 &lt; 3 and 5 &gt; 4.");
+
+    expect(agentMarkup).toContain('data-user-message-attribution="agent"');
+    expect(agentMarkup).toContain("Sent by another agent");
+    expect(userMarkup).not.toContain("Sent by another agent");
   });
 
-  it("preserves XML-like source inside user code spans and fences", async () => {
+  it("keeps a subagent parent-thread link at the top of an empty timeline", async () => {
     const { MessagesTimeline } = await import("./MessagesTimeline");
     const markup = renderToStaticMarkup(
       <MessagesTimeline
         {...buildProps()}
-        timelineEntries={[
-          buildUserTimelineEntry(
-            [
-              'Inline `<tag attr="x">`',
-              "",
-              "```xml",
-              '<root><child enabled="true" /></root>',
-              "```",
-            ].join("\n"),
-          ),
-        ]}
+        timelineEntries={[]}
+        parentThreadLink={{
+          threadId: ThreadId.make("thread-parent"),
+          title: "Architecture audit",
+        }}
       />,
     );
 
-    expect(markup).toContain('<code data-inline-code="">&lt;tag attr=&quot;x&quot;&gt;</code>');
-    expect(markup).toContain("&lt;root&gt;&lt;child enabled=&quot;true&quot; /&gt;&lt;/root&gt;");
+    expect(markup).toContain('aria-label="Open parent thread"');
+    expect(markup).toContain("Subagent of");
+    expect(markup).toContain("Architecture audit");
+    expect(markup).not.toContain("Send a message to start the conversation");
   });
 
-  it("does not render markdown title attributes in user messages", async () => {
+  it("keeps steer intent visible on committed user messages", async () => {
     const { MessagesTimeline } = await import("./MessagesTimeline");
+    const entry = buildUserTimelineEntry("Adjust the current turn");
     const markup = renderToStaticMarkup(
       <MessagesTimeline
         {...buildProps()}
         timelineEntries={[
-          buildUserTimelineEntry(
-            '[link](https://example.com "link tip") ![image](https://example.com/image.png "image tip")',
-          ),
+          { ...entry, message: { ...entry.message, inputIntent: "steer" as const } },
         ]}
       />,
     );
 
-    expect(markup).toContain('href="https://example.com"');
-    expect(markup).toContain('src="https://example.com/image.png"');
-    expect(markup).not.toContain('title="link tip"');
-    expect(markup).not.toContain('title="image tip"');
+    expect(markup).toContain("data-base-ui-tooltip-trigger");
+    expect(markup).toContain("lucide-redo-2");
+    expect(markup).toContain('data-user-message-intent="steer"');
+    expect(markup).toContain("items-center justify-end gap-1");
+    expect(markup).toContain("gap-1 text-xs leading-none text-muted-foreground");
+    expect(markup.indexOf("Steer")).toBeLessThan(markup.indexOf("Adjust the current turn"));
   });
 
-  it("renders unsafe user HTML as inert source text", async () => {
-    const { MessagesTimeline } = await import("./MessagesTimeline");
+  it("does not add redundant space below a collapsed turn divider", () => {
+    const runId = RunId.make("run-collapsed-spacing");
     const markup = renderToStaticMarkup(
       <MessagesTimeline
         {...buildProps()}
         timelineEntries={[
-          buildUserTimelineEntry(
-            '<script>globalThis.__t3Xss = 1</script><img src="x" onerror="globalThis.__t3Xss = 2">',
-          ),
+          buildUserTimelineEntry("Investigate spacing"),
+          {
+            id: "assistant-commentary-spacing",
+            kind: "message",
+            createdAt: "2026-03-17T19:12:30.000Z",
+            message: {
+              id: MessageId.make("assistant-commentary-spacing"),
+              role: "assistant",
+              text: "Checking the layout.",
+              runId,
+              createdAt: "2026-03-17T19:12:30.000Z",
+              updatedAt: "2026-03-17T19:12:31.000Z",
+              streaming: false,
+            },
+          },
+          {
+            id: "assistant-final-spacing",
+            kind: "message",
+            createdAt: "2026-03-17T19:12:32.000Z",
+            message: {
+              id: MessageId.make("assistant-final-spacing"),
+              role: "assistant",
+              text: "Spacing fixed.",
+              runId,
+              createdAt: "2026-03-17T19:12:32.000Z",
+              updatedAt: "2026-03-17T19:12:33.000Z",
+              streaming: false,
+            },
+          },
         ]}
       />,
     );
 
-    expect(markup).toContain("&lt;script&gt;globalThis.__t3Xss = 1&lt;/script&gt;");
-    expect(markup).toContain(
-      "&lt;img src=&quot;x&quot; onerror=&quot;globalThis.__t3Xss = 2&quot;&gt;",
-    );
-    expect(markup).not.toMatch(/<script(?:\s|>)/i);
-    expect(markup).not.toMatch(/<img(?:\s|>)/i);
+    expect(markup).toContain('class="pb-0" data-timeline-row-id="turn-fold:');
+    expect(markup).toContain('data-timeline-row-kind="turn-fold"');
+    expect(markup).not.toContain("border-b border-border/60");
   });
 
-  it("continues to render sanitized raw HTML in assistant messages", async () => {
+  it("shows a collapsed disclosure for superseded attempt output", async () => {
     const { MessagesTimeline } = await import("./MessagesTimeline");
+    const runId = RunId.make("run-steered");
+    const supersededAttempt = {
+      id: "attempt-1" as never,
+      runId,
+      attemptOrdinal: 1,
+      rootNodeId: "node-attempt-1" as never,
+      status: "superseded" as const,
+    };
+    const activeAttempt = {
+      id: "attempt-2" as never,
+      runId,
+      attemptOrdinal: 2,
+      rootNodeId: "node-attempt-2" as never,
+      status: "running" as const,
+    };
     const markup = renderToStaticMarkup(
       <MessagesTimeline
         {...buildProps()}
+        latestRun={{
+          runId,
+          status: "running",
+          startedAt: MESSAGE_CREATED_AT,
+          completedAt: null,
+        }}
         timelineEntries={[
-          buildAssistantTimelineEntry("<details><summary>More</summary>Details</details>"),
+          {
+            id: "superseded-response-entry",
+            kind: "message",
+            createdAt: MESSAGE_CREATED_AT,
+            attempt: supersededAttempt,
+            message: {
+              id: MessageId.make("superseded-response"),
+              role: "assistant",
+              text: "Partial response from the old attempt",
+              runId,
+              createdAt: MESSAGE_CREATED_AT,
+              updatedAt: MESSAGE_CREATED_AT,
+              streaming: false,
+            },
+          },
+          {
+            id: "active-response-entry",
+            kind: "message",
+            createdAt: "2026-03-17T19:12:29.000Z",
+            attempt: activeAttempt,
+            message: {
+              id: MessageId.make("active-response"),
+              role: "assistant",
+              text: "Current response remains visible",
+              runId,
+              createdAt: "2026-03-17T19:12:29.000Z",
+              updatedAt: "2026-03-17T19:12:29.000Z",
+              streaming: true,
+            },
+          },
         ]}
       />,
     );
 
-    expect(markup).toContain('data-markdown-details=""');
-    expect(markup).toContain("More");
-    expect(markup).not.toContain("&lt;details&gt;");
+    expect(markup).toContain('data-superseded-attempt-id="attempt-1"');
+    expect(markup).toContain('aria-expanded="false"');
+    expect(markup).toContain("Superseded attempt");
+    expect(markup).toContain("Partial output retained");
+    expect(markup).toContain("Current response remains visible");
+    expect(markup).not.toContain("Partial response from the old attempt");
   });
 
-  it("sanitizes executable HTML while preserving supported assistant markup", async () => {
+  it("exposes a per-response fork action for completed assistant items", async () => {
     const { MessagesTimeline } = await import("./MessagesTimeline");
+    const projectedItem = {
+      position: 0,
+      visibility: "local",
+      sourceThreadId: "thread-1",
+      sourceItemId: "assistant-item-1",
+      item: {
+        id: "assistant-item-1",
+        threadId: "thread-1",
+        runId: "run-1",
+        nodeId: null,
+        providerThreadId: null,
+        providerTurnId: null,
+        nativeItemRef: null,
+        parentItemId: null,
+        ordinal: 0,
+        status: "completed",
+        title: null,
+        startedAt: null,
+        completedAt: null,
+        updatedAt: {},
+        type: "assistant_message",
+        messageId: "assistant-message-1",
+        text: "Done",
+        streaming: false,
+      },
+    } as never;
     const markup = renderToStaticMarkup(
       <MessagesTimeline
         {...buildProps()}
         timelineEntries={[
-          buildAssistantTimelineEntry(
-            [
-              '<details open onclick="globalThis.__t3Xss = 1">',
-              "<summary>Safe details</summary>",
-              "<script>globalThis.__t3Xss = 2</script>",
-              '<img src="x" onerror="globalThis.__t3Xss = 3">',
-              '<a href="javascript:globalThis.__t3Xss = 4">Unsafe link</a>',
-              "</details>",
-            ].join(""),
-          ),
+          {
+            id: "assistant-message-1",
+            kind: "message",
+            createdAt: MESSAGE_CREATED_AT,
+            projectedItem,
+            message: {
+              id: MessageId.make("assistant-message-1"),
+              role: "assistant",
+              text: "Done",
+              runId: RunId.make("run-1"),
+              createdAt: MESSAGE_CREATED_AT,
+              updatedAt: MESSAGE_CREATED_AT,
+              streaming: false,
+            },
+          },
         ]}
       />,
     );
 
-    expect(markup).toContain('data-markdown-details=""');
-    expect(markup).toContain("Safe details");
-    expect(markup).not.toMatch(/<script(?:\s|>)/i);
-    expect(markup).not.toContain("onclick=");
-    expect(markup).not.toContain("onerror=");
-    expect(markup).not.toContain("javascript:");
-    expect(markup).not.toContain("globalThis.__t3Xss");
+    expect(markup).toContain('aria-label="Fork from this response"');
   });
 
   it("renders inline terminal labels with the composer chip UI", async () => {
@@ -1015,69 +1229,240 @@ describe("MessagesTimeline", () => {
     expect(markup).toContain("Context compacted");
   });
 
-  it("summarizes changed files in one line", () => {
+  it("does not render the transient V2 interruption request", async () => {
+    const { MessagesTimeline } = await import("./MessagesTimeline");
     const markup = renderToStaticMarkup(
       <MessagesTimeline
         {...buildProps()}
         timelineEntries={[
           {
-            id: "entry-1",
-            kind: "work",
-            createdAt: "2026-03-17T19:12:28.000Z",
-            entry: {
-              id: "work-1",
-              createdAt: "2026-03-17T19:12:28.000Z",
-              label: "Updated files",
-              tone: "tool",
-              changedFiles: ["C:/Users/mike/dev-stuff/t3code/apps/web/src/session-logic.ts"],
-            },
+            id: "interrupt-request",
+            kind: "event",
+            createdAt: MESSAGE_CREATED_AT,
+            projectedItem: {
+              position: 0,
+              visibility: "local",
+              sourceThreadId: "thread-1",
+              sourceItemId: "interrupt-request",
+              item: {
+                id: "interrupt-request",
+                threadId: "thread-1",
+                runId: "run-1",
+                nodeId: null,
+                providerThreadId: null,
+                providerTurnId: null,
+                nativeItemRef: null,
+                parentItemId: null,
+                ordinal: 0,
+                status: "completed",
+                title: null,
+                startedAt: null,
+                completedAt: null,
+                updatedAt: {},
+                type: "run_interrupt_request",
+                message: "Waiting for the provider to stop.",
+              },
+            } as never,
           },
         ]}
-        workspaceRoot="C:/Users/mike/dev-stuff/t3code"
       />,
     );
 
-    expect(markup).toContain("Changed 1 file");
-    expect(markup).not.toContain("C:/Users/mike/dev-stuff/t3code/apps/web/src/session-logic.ts");
+    expect(markup).not.toContain('data-v2-item-type="run_interrupt_request"');
+    expect(markup).not.toContain("Interrupt requested");
+    expect(markup).not.toContain("Waiting for the provider to stop.");
+    expect(markup).not.toContain("Structured details");
   });
 
-  it("keeps mixed-success tool groups neutral", () => {
+  it("renders context handoffs as from → to model endpoints instead of the summary", async () => {
+    const { MessagesTimeline } = await import("./MessagesTimeline");
+    const providerStatuses = [
+      {
+        instanceId: "codex_personal",
+        driver: "codex",
+        enabled: true,
+        installed: true,
+        version: null,
+        status: "ready",
+        auth: {},
+        checkedAt: MESSAGE_CREATED_AT,
+        models: [{ slug: "gpt-5.6-sol", name: "GPT 5.6 Sol", isCustom: false, capabilities: null }],
+        slashCommands: [],
+        skills: [],
+      },
+      {
+        instanceId: "claudeAgent",
+        driver: "claudeAgent",
+        enabled: true,
+        installed: true,
+        version: null,
+        status: "ready",
+        auth: {},
+        checkedAt: MESSAGE_CREATED_AT,
+        models: [
+          { slug: "claude-fable-5", name: "Claude Fable 5", isCustom: false, capabilities: null },
+        ],
+        slashCommands: [],
+        skills: [],
+      },
+    ] as never;
+    const buildHandoffEntry = (item: Record<string, unknown>) => ({
+      id: "handoff-1",
+      kind: "event" as const,
+      createdAt: MESSAGE_CREATED_AT,
+      projectedItem: {
+        position: 0,
+        visibility: "local",
+        sourceThreadId: "thread-1",
+        sourceItemId: "handoff-1",
+        item: {
+          id: "handoff-1",
+          threadId: "thread-1",
+          runId: "run-2",
+          nodeId: null,
+          providerThreadId: null,
+          providerTurnId: null,
+          nativeItemRef: null,
+          parentItemId: null,
+          ordinal: 0,
+          status: "completed",
+          title: "Provider handoff",
+          startedAt: null,
+          completedAt: null,
+          updatedAt: {},
+          type: "handoff",
+          contextHandoffId: "handoff-1",
+          fromProviderThreadIds: ["provider-thread-1"],
+          toProviderThreadId: "provider-thread-2",
+          strategy: "full_thread_summary",
+          summary: "Full conversation context for provider handoff.",
+          ...item,
+        },
+      } as never,
+    });
+
+    const markup = renderToStaticMarkup(
+      <MessagesTimeline
+        {...buildProps()}
+        providerStatuses={providerStatuses}
+        timelineEntries={[
+          buildHandoffEntry({
+            fromProviderInstanceIds: ["codex_personal"],
+            toProviderInstanceId: "claudeAgent",
+            fromModelSelections: [{ instanceId: "codex_personal", model: "gpt-5.6-sol" }],
+            toModel: "claude-fable-5",
+          }),
+        ]}
+      />,
+    );
+
+    expect(markup).toContain("Context handoff");
+    expect(markup).toContain("GPT 5.6 Sol");
+    expect(markup).toContain("Claude Fable 5");
+    expect(markup).not.toContain("Full conversation context");
+    expect(markup).not.toContain("·");
+
+    // Items persisted before models were stamped recover them from the
+    // projection runs: the handoff's run is the target, the newest earlier
+    // run per source instance is the origin.
+    const legacyRuns = [
+      {
+        id: "run-1",
+        ordinal: 1,
+        providerInstanceId: "codex_personal",
+        modelSelection: { instanceId: "codex_personal", model: "gpt-5.6-sol" },
+      },
+      {
+        id: "run-2",
+        ordinal: 2,
+        providerInstanceId: "claudeAgent",
+        modelSelection: { instanceId: "claudeAgent", model: "claude-fable-5" },
+      },
+    ] as never;
+    const legacyMarkup = renderToStaticMarkup(
+      <MessagesTimeline
+        {...buildProps()}
+        providerStatuses={providerStatuses}
+        runs={legacyRuns}
+        timelineEntries={[
+          buildHandoffEntry({
+            fromProviderInstanceIds: ["codex_personal"],
+            toProviderInstanceId: "claudeAgent",
+          }),
+        ]}
+      />,
+    );
+
+    expect(legacyMarkup).toContain("GPT 5.6 Sol");
+    expect(legacyMarkup).toContain("Claude Fable 5");
+    expect(legacyMarkup).not.toContain("Full conversation context");
+
+    // Without run data either (e.g. cross-thread items) it falls back to
+    // provider names.
+    const bareMarkup = renderToStaticMarkup(
+      <MessagesTimeline
+        {...buildProps()}
+        providerStatuses={providerStatuses}
+        timelineEntries={[
+          buildHandoffEntry({
+            fromProviderInstanceIds: ["codex_personal"],
+            toProviderInstanceId: "claudeAgent",
+          }),
+        ]}
+      />,
+    );
+
+    expect(bareMarkup).toContain("Codex Personal");
+    expect(bareMarkup).not.toContain("Full conversation context");
+  });
+
+  it("renders created threads as linked cards outside the work log", async () => {
+    const { MessagesTimeline } = await import("./MessagesTimeline");
     const markup = renderToStaticMarkup(
       <MessagesTimeline
         {...buildProps()}
         timelineEntries={[
           {
-            id: "entry-failed",
-            kind: "work",
-            createdAt: "2026-03-17T19:12:28.000Z",
-            entry: {
-              id: "work-failed",
-              createdAt: "2026-03-17T19:12:28.000Z",
-              label: "Run search",
-              tone: "tool",
-              itemType: "command_execution",
-              toolLifecycleStatus: "failed",
-            },
-          },
-          {
-            id: "entry-completed",
-            kind: "work",
-            createdAt: "2026-03-17T19:12:29.000Z",
-            entry: {
-              id: "work-completed",
-              createdAt: "2026-03-17T19:12:29.000Z",
-              label: "Run tests",
-              tone: "tool",
-              itemType: "command_execution",
-              toolLifecycleStatus: "completed",
-            },
+            id: "thread-created",
+            kind: "event",
+            createdAt: MESSAGE_CREATED_AT,
+            projectedItem: {
+              position: 0,
+              visibility: "local",
+              sourceThreadId: "thread-1",
+              sourceItemId: "thread-created",
+              item: {
+                id: "thread-created",
+                threadId: "thread-1",
+                runId: "run-1",
+                nodeId: "node-1",
+                providerThreadId: null,
+                providerTurnId: null,
+                nativeItemRef: null,
+                parentItemId: null,
+                ordinal: 1,
+                status: "completed",
+                title: "Claude research thread",
+                startedAt: null,
+                completedAt: null,
+                updatedAt: {},
+                type: "thread_created",
+                targetThreadId: "thread-2",
+                targetRunId: "run-2",
+                targetProviderInstanceId: "claude-default",
+                targetModel: "claude-sonnet-4-6",
+              },
+            } as never,
           },
         ]}
       />,
     );
 
-    expect(markup).toContain("Ran 2 commands");
-    expect(markup).not.toContain('aria-label="Tool call failed"');
+    expect(markup).toContain('data-v2-item-type="thread_created"');
+    expect(markup).toContain('aria-label="Open Claude research thread"');
+    expect(markup).toContain("Claude research thread");
+    expect(markup).toContain("claude-default · claude-sonnet-4-6");
+    expect(markup).not.toContain("Work Log");
   });
 
   it("keeps the collapsed summary icon neutral when the group ends in a failure", () => {
@@ -1173,134 +1558,589 @@ describe("MessagesTimeline", () => {
     expect(markup).not.toContain('aria-label="Hidden work includes a failure"');
   });
 
-  it("shows the animated one-line label for a live tool group", () => {
-    const turnId = TurnId.make("turn-live");
+  it("renders live subagent progress on the persistent linked card", async () => {
+    const { MessagesTimeline } = await import("./MessagesTimeline");
     const markup = renderToStaticMarkup(
       <MessagesTimeline
         {...buildProps()}
-        isWorking
-        latestTurn={{
-          turnId,
-          state: "running",
-          startedAt: MESSAGE_CREATED_AT,
-          completedAt: null,
-        }}
-        runningTurnId={turnId}
         timelineEntries={[
           {
-            id: "entry-live",
-            kind: "work",
+            id: "subagent-progress",
+            kind: "event",
             createdAt: MESSAGE_CREATED_AT,
-            entry: {
-              id: "work-live",
-              createdAt: MESSAGE_CREATED_AT,
-              turnId,
-              toolCallId: "call-live",
-              label: "Run tests",
-              tone: "tool",
-              itemType: "command_execution",
-              command: "pnpm test",
-              toolLifecycleStatus: "inProgress",
-            },
+            projectedItem: {
+              position: 0,
+              visibility: "local",
+              sourceThreadId: "thread-1",
+              sourceItemId: "subagent-progress",
+              item: {
+                id: "subagent-progress",
+                threadId: "thread-1",
+                runId: "run-1",
+                nodeId: "node-subagent-1",
+                providerThreadId: "provider-thread-1",
+                providerTurnId: "provider-turn-1",
+                nativeItemRef: null,
+                parentItemId: null,
+                ordinal: 1,
+                status: "running",
+                title: "Package audit",
+                startedAt: null,
+                completedAt: null,
+                updatedAt: {},
+                type: "subagent",
+                subagentId: "node-subagent-1",
+                origin: "provider_native",
+                driver: "claudeAgent",
+                providerInstanceId: "claudeAgent",
+                childThreadId: "thread-subagent-1",
+                prompt: "Inspect the package",
+                progress: "Reading src/index.ts",
+                result: null,
+              },
+            } as never,
           },
         ]}
       />,
     );
 
-    expect(markup).toContain("Running pnpm");
-    expect(markup).toContain("live-activity-focus");
+    expect(markup).toContain('data-v2-item-type="subagent"');
+    expect(markup).toContain('aria-label="Open Package audit"');
+    expect(markup).toContain("Reading src/index.ts");
+    expect(markup).not.toContain("Inspect the package");
+    expect(markup).not.toContain('data-v2-subagent-result-disclosure="true"');
+    expect(markup).not.toContain("Work Log");
   });
 
-  it("scopes a live row failure to the tool named by the row", () => {
-    const turnId = TurnId.make("turn-live");
+  it("discloses the full Codex subagent result without projecting child events", async () => {
+    const { MessagesTimeline } = await import("./MessagesTimeline");
     const markup = renderToStaticMarkup(
       <MessagesTimeline
         {...buildProps()}
-        isWorking
-        latestTurn={{
-          turnId,
-          state: "running",
-          startedAt: MESSAGE_CREATED_AT,
-          completedAt: null,
-        }}
-        runningTurnId={turnId}
         timelineEntries={[
           {
-            id: "entry-failed",
-            kind: "work",
+            id: "codex-subagent-result",
+            kind: "event",
             createdAt: MESSAGE_CREATED_AT,
-            entry: {
-              id: "work-failed",
-              createdAt: MESSAGE_CREATED_AT,
-              turnId,
-              toolCallId: "call-failed",
-              label: "Run lint",
-              tone: "tool",
-              itemType: "command_execution",
-              command: "pnpm lint",
-              toolLifecycleStatus: "failed",
-            },
+            projectedItem: {
+              position: 0,
+              visibility: "local",
+              sourceThreadId: "thread-1",
+              sourceItemId: "codex-subagent-result",
+              item: {
+                id: "codex-subagent-result",
+                threadId: "thread-1",
+                runId: "run-1",
+                nodeId: "node-subagent-1",
+                providerThreadId: "provider-thread-1",
+                providerTurnId: "provider-turn-1",
+                nativeItemRef: null,
+                parentItemId: null,
+                ordinal: 1,
+                status: "completed",
+                title: "Isolation report",
+                startedAt: null,
+                completedAt: null,
+                updatedAt: {},
+                type: "subagent",
+                subagentId: "node-subagent-1",
+                origin: "provider_native",
+                driver: "codex",
+                providerInstanceId: "codex",
+                childThreadId: "thread-subagent-1",
+                prompt: "Explain test isolation",
+                result: "Tests should be isolated.\n\nResult: no shared state.",
+              },
+            } as never,
           },
+        ]}
+      />,
+    );
+
+    expect(markup).toContain('data-v2-item-type="subagent"');
+    expect(markup).toContain('data-v2-subagent-result-disclosure="true"');
+    expect(markup).toContain('data-v2-subagent-result="true"');
+    expect(markup).toContain('aria-label="Show full result for Isolation report"');
+    expect(markup).toContain('aria-label="Open Isolation report"');
+    expect(markup).toContain("Tests should be isolated.");
+    expect(markup).toContain("Result: no shared state.");
+    expect(markup).not.toContain("Explain test isolation");
+  });
+
+  it("keeps live progress when a running subagent streams a partial result", async () => {
+    const { MessagesTimeline } = await import("./MessagesTimeline");
+    const markup = renderToStaticMarkup(
+      <MessagesTimeline
+        {...buildProps()}
+        timelineEntries={[
           {
-            id: "entry-running",
-            kind: "work",
+            id: "subagent-partial-result",
+            kind: "event",
             createdAt: MESSAGE_CREATED_AT,
-            entry: {
-              id: "work-running",
-              createdAt: MESSAGE_CREATED_AT,
-              turnId,
-              toolCallId: "call-running",
-              label: "Run tests",
-              tone: "tool",
-              itemType: "command_execution",
-              command: "pnpm test",
-              toolLifecycleStatus: "inProgress",
-            },
+            projectedItem: {
+              position: 0,
+              visibility: "local",
+              sourceThreadId: "thread-1",
+              sourceItemId: "subagent-partial-result",
+              item: {
+                id: "subagent-partial-result",
+                threadId: "thread-1",
+                runId: "run-1",
+                nodeId: "node-subagent-1",
+                providerThreadId: "provider-thread-1",
+                providerTurnId: "provider-turn-1",
+                nativeItemRef: null,
+                parentItemId: null,
+                ordinal: 1,
+                status: "running",
+                title: "Package audit",
+                startedAt: null,
+                completedAt: null,
+                updatedAt: {},
+                type: "subagent",
+                subagentId: "node-subagent-1",
+                origin: "provider_native",
+                driver: "codex",
+                providerInstanceId: "codex",
+                childThreadId: "thread-subagent-1",
+                prompt: "Inspect the package",
+                progress: "Reading src/index.ts",
+                result: "Partial streamed answer so far",
+              },
+            } as never,
+          },
+        ]}
+      />,
+    );
+
+    expect(markup).toContain('data-v2-item-type="subagent"');
+    expect(markup).toContain('aria-label="Open Package audit"');
+    expect(markup).toContain("Reading src/index.ts");
+    expect(markup).not.toContain("Partial streamed answer so far");
+    expect(markup).not.toContain('data-v2-subagent-result-disclosure="true"');
+  });
+
+  it("shows the streamed result while a subagent runs without progress", async () => {
+    const { MessagesTimeline } = await import("./MessagesTimeline");
+    const markup = renderToStaticMarkup(
+      <MessagesTimeline
+        {...buildProps()}
+        timelineEntries={[
+          {
+            id: "subagent-streamed-result",
+            kind: "event",
+            createdAt: MESSAGE_CREATED_AT,
+            projectedItem: {
+              position: 0,
+              visibility: "local",
+              sourceThreadId: "thread-1",
+              sourceItemId: "subagent-streamed-result",
+              item: {
+                id: "subagent-streamed-result",
+                threadId: "thread-1",
+                runId: "run-1",
+                nodeId: "node-subagent-1",
+                providerThreadId: "provider-thread-1",
+                providerTurnId: "provider-turn-1",
+                nativeItemRef: null,
+                parentItemId: null,
+                ordinal: 1,
+                status: "running",
+                title: "Package audit",
+                startedAt: null,
+                completedAt: null,
+                updatedAt: {},
+                type: "subagent",
+                subagentId: "node-subagent-1",
+                origin: "provider_native",
+                driver: "codex",
+                providerInstanceId: "codex",
+                childThreadId: "thread-subagent-1",
+                prompt: "Inspect the package",
+                progress: null,
+                result: "Streaming answer so far",
+              },
+            } as never,
           },
         ]}
       />,
     );
 
-    expect(markup).toContain("Running pnpm");
-    expect(markup).not.toContain("tool call failed");
+    expect(markup).toContain('data-v2-item-type="subagent"');
+    expect(markup).toContain("Streaming answer so far");
+    expect(markup).not.toContain("Inspect the package");
+    expect(markup).not.toContain('data-v2-subagent-result-disclosure="true"');
   });
 
-  it("keeps terminal command copy live while the parent turn is active", () => {
-    const turnId = TurnId.make("turn-live");
+  it("treats a cancelled subagent result as partial output", async () => {
+    const { MessagesTimeline } = await import("./MessagesTimeline");
+    const markup = renderToStaticMarkup(
+      <MessagesTimeline
+        {...buildProps()}
+        timelineEntries={[
+          {
+            id: "subagent-cancelled-result",
+            kind: "event",
+            createdAt: MESSAGE_CREATED_AT,
+            projectedItem: {
+              position: 0,
+              visibility: "local",
+              sourceThreadId: "thread-1",
+              sourceItemId: "subagent-cancelled-result",
+              item: {
+                id: "subagent-cancelled-result",
+                threadId: "thread-1",
+                runId: "run-1",
+                nodeId: "node-subagent-1",
+                providerThreadId: "provider-thread-1",
+                providerTurnId: "provider-turn-1",
+                nativeItemRef: null,
+                parentItemId: null,
+                ordinal: 1,
+                status: "cancelled",
+                title: "Package audit",
+                startedAt: null,
+                completedAt: null,
+                updatedAt: {},
+                type: "subagent",
+                subagentId: "node-subagent-1",
+                origin: "provider_native",
+                driver: "codex",
+                providerInstanceId: "codex",
+                childThreadId: "thread-subagent-1",
+                prompt: "Inspect the package",
+                progress: "Reading src/index.ts",
+                result: "Partial output before cancel",
+              },
+            } as never,
+          },
+        ]}
+      />,
+    );
+
+    expect(markup).toContain('data-v2-item-type="subagent"');
+    expect(markup).toContain("Partial output before cancel");
+    expect(markup).not.toContain("Reading src/index.ts");
+    expect(markup).not.toContain('data-v2-subagent-result-disclosure="true"');
+  });
+
+  it("falls back to progress when a completed subagent result is whitespace-only", async () => {
+    const { MessagesTimeline } = await import("./MessagesTimeline");
+    const markup = renderToStaticMarkup(
+      <MessagesTimeline
+        {...buildProps()}
+        timelineEntries={[
+          {
+            id: "subagent-blank-result",
+            kind: "event",
+            createdAt: MESSAGE_CREATED_AT,
+            projectedItem: {
+              position: 0,
+              visibility: "local",
+              sourceThreadId: "thread-1",
+              sourceItemId: "subagent-blank-result",
+              item: {
+                id: "subagent-blank-result",
+                threadId: "thread-1",
+                runId: "run-1",
+                nodeId: "node-subagent-1",
+                providerThreadId: "provider-thread-1",
+                providerTurnId: "provider-turn-1",
+                nativeItemRef: null,
+                parentItemId: null,
+                ordinal: 1,
+                status: "completed",
+                title: "Package audit",
+                startedAt: null,
+                completedAt: null,
+                updatedAt: {},
+                type: "subagent",
+                subagentId: "node-subagent-1",
+                origin: "provider_native",
+                driver: "codex",
+                providerInstanceId: "codex",
+                childThreadId: "thread-subagent-1",
+                prompt: "Inspect the package",
+                progress: "Audited 12 packages",
+                result: "  \n\t  ",
+              },
+            } as never,
+          },
+        ]}
+      />,
+    );
+
+    expect(markup).toContain('data-v2-item-type="subagent"');
+    expect(markup).toContain("Audited 12 packages");
+    expect(markup).not.toContain('data-v2-subagent-result-disclosure="true"');
+  });
+
+  it("renders V2 provider retries in the normal work log", () => {
+    activityTestState.expanded = true;
+    const retryItem = {
+      id: "provider-error",
+      threadId: "thread-1",
+      runId: "run-1",
+      nodeId: null,
+      providerThreadId: "provider-thread-1",
+      providerTurnId: "provider-turn-1",
+      nativeItemRef: null,
+      parentItemId: null,
+      ordinal: 99,
+      status: "running",
+      title: "Provider retry",
+      startedAt: {},
+      completedAt: null,
+      updatedAt: {},
+      type: "error",
+      failure: {
+        class: "transport_error",
+        message: "The response stream disconnected.",
+        code: "responseStreamDisconnected",
+        retryable: true,
+      },
+      retry: {
+        attempt: 2,
+        maxAttempts: 5,
+        retryDelayMs: null,
+      },
+    } as const;
+    const projectedItem = {
+      position: 0,
+      visibility: "local",
+      sourceThreadId: "thread-1",
+      sourceItemId: retryItem.id,
+      item: retryItem,
+    } as const;
     const markup = renderToStaticMarkup(
       <MessagesTimeline
         {...buildProps()}
         isWorking
-        latestTurn={{
-          turnId,
-          state: "running",
+        activeTurnInProgress
+        latestRun={{
+          runId: RunId.make("run-1"),
+          status: "running",
           startedAt: MESSAGE_CREATED_AT,
           completedAt: null,
         }}
-        runningTurnId={turnId}
+        timelineEntries={
+          [
+            {
+              id: "provider-error",
+              kind: "work",
+              createdAt: MESSAGE_CREATED_AT,
+              entry: {
+                id: retryItem.id,
+                createdAt: MESSAGE_CREATED_AT,
+                runId: "run-1",
+                label: "Retrying provider (2/5)",
+                detail: retryItem.failure.message,
+                tone: "info",
+                itemType: "error",
+                toolLifecycleStatus: "inProgress",
+                structuredPayload: retryItem,
+                projectedItem,
+              },
+            },
+          ] as never
+        }
+      />,
+    );
+
+    expect(markup).toContain('data-v2-item-type="error"');
+    expect(markup).toContain("Retrying provider (2/5)");
+    expect(markup).toContain("The response stream disconnected.");
+    expect(markup).not.toContain('data-v2-event-disclosure="true"');
+  });
+
+  it("keeps inherited V2 work provenance on the rendered row", async () => {
+    activityTestState.expanded = true;
+    const { MessagesTimeline } = await import("./MessagesTimeline");
+    const item = {
+      id: "command-inherited",
+      threadId: "thread-source",
+      runId: null,
+      nodeId: null,
+      providerThreadId: null,
+      providerTurnId: null,
+      nativeItemRef: null,
+      parentItemId: null,
+      ordinal: 0,
+      status: "completed",
+      title: null,
+      startedAt: null,
+      completedAt: null,
+      updatedAt: {},
+      type: "command_execution",
+      input: "pwd",
+      output: "/workspace",
+      exitCode: 0,
+    } as const;
+    const projectedItem = {
+      position: 0,
+      visibility: "inherited",
+      sourceThreadId: "thread-source",
+      sourceItemId: item.id,
+      item,
+    } as const;
+    const markup = renderToStaticMarkup(
+      <MessagesTimeline
+        {...buildProps()}
+        timelineEntries={
+          [
+            {
+              id: "context-info-entry",
+              kind: "work",
+              createdAt: MESSAGE_CREATED_AT,
+              entry: {
+                id: "context-info",
+                createdAt: MESSAGE_CREATED_AT,
+                label: "Session started",
+                tone: "info",
+              },
+            },
+            {
+              id: item.id,
+              kind: "work",
+              createdAt: MESSAGE_CREATED_AT,
+              entry: {
+                id: item.id,
+                createdAt: MESSAGE_CREATED_AT,
+                runId: null,
+                label: "Ran command",
+                command: item.input,
+                tone: "tool",
+                itemType: item.type,
+                toolLifecycleStatus: "completed",
+                structuredPayload: item,
+                projectedItem,
+              },
+            },
+          ] as never
+        }
+      />,
+    );
+
+    expect(markup).toContain('data-v2-item-type="command_execution"');
+    expect(markup).toContain('data-v2-item-visibility="inherited"');
+    expect(markup).toContain("Inherited");
+    expect(markup).toContain("Received 1 update and ran 1 command");
+  });
+
+  it("renders T3 MCP dynamic tools with the product logo and pretty name", async () => {
+    activityTestState.expanded = true;
+    const { MessagesTimeline } = await import("./MessagesTimeline");
+    const item = {
+      id: "tool-t3-thread-read",
+      threadId: "thread-source",
+      runId: null,
+      nodeId: null,
+      providerThreadId: null,
+      providerTurnId: null,
+      nativeItemRef: null,
+      parentItemId: null,
+      ordinal: 0,
+      status: "completed",
+      title: null,
+      startedAt: null,
+      completedAt: null,
+      updatedAt: {},
+      type: "dynamic_tool",
+      toolName: "mcp__t3-code__t3_thread_read",
+      input: { threadId: "thread-child" },
+      output: { messages: [] },
+    } as const;
+    const projectedItem = {
+      position: 0,
+      visibility: "local",
+      sourceThreadId: "thread-source",
+      sourceItemId: item.id,
+      item,
+    } as const;
+    const markup = renderToStaticMarkup(
+      <MessagesTimeline
+        {...buildProps()}
+        timelineEntries={
+          [
+            {
+              id: "context-info-entry",
+              kind: "work",
+              createdAt: MESSAGE_CREATED_AT,
+              entry: {
+                id: "context-info",
+                createdAt: MESSAGE_CREATED_AT,
+                label: "Session started",
+                tone: "info",
+              },
+            },
+            {
+              id: item.id,
+              kind: "work",
+              createdAt: MESSAGE_CREATED_AT,
+              entry: {
+                id: item.id,
+                createdAt: MESSAGE_CREATED_AT,
+                runId: null,
+                label: item.toolName,
+                tone: "tool",
+                itemType: item.type,
+                toolTitle: item.toolName,
+                toolLifecycleStatus: "completed",
+                toolData: { input: item.input, output: item.output },
+                structuredPayload: item,
+                projectedItem,
+              },
+            },
+          ] as never
+        }
+      />,
+    );
+
+    expect(markup).toContain('data-tool-logo="t3-code"');
+    expect(markup).toContain('src="/apple-touch-icon.png"');
+    expect(markup).toContain("Read a T3 thread");
+    expect(markup).not.toContain("mcp__t3-code__t3_thread_read");
+  });
+
+  it("formats changed file paths from the workspace root", async () => {
+    activityTestState.expanded = true;
+    const { MessagesTimeline } = await import("./MessagesTimeline");
+    const markup = renderToStaticMarkup(
+      <MessagesTimeline
+        {...buildProps()}
         timelineEntries={[
           {
-            id: "entry-failed",
+            id: "context-info-entry",
             kind: "work",
-            createdAt: MESSAGE_CREATED_AT,
+            createdAt: "2026-03-17T19:12:28.000Z",
             entry: {
-              id: "work-failed",
-              createdAt: MESSAGE_CREATED_AT,
-              turnId,
-              toolCallId: "call-failed",
-              label: "Run lint",
+              id: "context-info",
+              createdAt: "2026-03-17T19:12:28.000Z",
+              label: "Session started",
+              tone: "info",
+            },
+          },
+          {
+            id: "entry-1",
+            kind: "work",
+            createdAt: "2026-03-17T19:12:28.000Z",
+            entry: {
+              id: "work-1",
+              createdAt: "2026-03-17T19:12:28.000Z",
+              label: "Updated files",
               tone: "tool",
-              itemType: "command_execution",
-              command: "pnpm lint",
-              toolLifecycleStatus: "failed",
+              itemType: "file_change",
+              toolLifecycleStatus: "completed",
+              changedFiles: ["C:/Users/mike/dev-stuff/t3code/apps/web/src/session-logic.ts"],
             },
           },
         ]}
+        workspaceRoot="C:/Users/mike/dev-stuff/t3code"
       />,
     );
 
-    expect(markup).toContain("Running pnpm");
-    expect(markup).toContain("tool call failed");
+    expect(markup).toContain("t3code/apps/web/src/session-logic.ts");
+    expect(markup).not.toContain("C:/Users/mike/dev-stuff/t3code/apps/web/src/session-logic.ts");
   });
 
   it("renders review comment contexts as structured cards instead of raw tags", () => {
@@ -1325,7 +2165,7 @@ describe("MessagesTimeline", () => {
                 "```",
                 "</review_comment>",
               ].join("\n"),
-              turnId: null,
+              runId: null,
               createdAt: "2026-03-17T19:12:28.000Z",
               updatedAt: "2026-03-17T19:12:28.000Z",
               streaming: false,
@@ -1364,7 +2204,7 @@ describe("MessagesTimeline", () => {
                 "```",
                 "</review_comment>",
               ].join("\n"),
-              turnId: null,
+              runId: null,
               createdAt: "2026-03-17T19:12:28.000Z",
               updatedAt: "2026-03-17T19:12:28.000Z",
               streaming: false,
@@ -1380,7 +2220,85 @@ describe("MessagesTimeline", () => {
     expect(markup).not.toContain('data-testid="file-diff"');
   });
 
-  it("keeps failed lifecycle entries discoverable in mixed activity summaries", () => {
+  it("collapses settled tool runs behind a generated summary toggle", () => {
+    const markup = renderToStaticMarkup(
+      <MessagesTimeline
+        {...buildProps()}
+        timelineEntries={[
+          {
+            id: "entry-1",
+            kind: "work",
+            createdAt: "2026-03-17T19:12:28.000Z",
+            entry: {
+              id: "work-1",
+              createdAt: "2026-03-17T19:12:28.000Z",
+              label: "Ran command",
+              command: "vp lint",
+              tone: "tool",
+              itemType: "command_execution",
+              toolLifecycleStatus: "completed",
+            },
+          },
+          {
+            id: "entry-2",
+            kind: "work",
+            createdAt: "2026-03-17T19:12:29.000Z",
+            entry: {
+              id: "work-2",
+              createdAt: "2026-03-17T19:12:29.000Z",
+              label: "Ran command",
+              command: "vp test run",
+              tone: "tool",
+              itemType: "command_execution",
+              toolLifecycleStatus: "completed",
+            },
+          },
+        ]}
+      />,
+    );
+
+    expect(markup).toContain("Ran 2 commands");
+    expect(markup).toContain('aria-expanded="false"');
+    // Entries stay hidden until the toggle expands the group.
+    expect(markup).not.toContain("vp lint");
+  });
+
+  it("renders an inline task-progress chip for todo-list plans", () => {
+    const markup = renderToStaticMarkup(
+      <MessagesTimeline
+        {...buildProps()}
+        timelineEntries={[
+          {
+            id: "item-todo",
+            kind: "turn-plan",
+            createdAt: "2026-03-17T19:12:28.000Z",
+            turnPlan: {
+              id: "turn-plan:plan-1",
+              createdAt: "2026-03-17T19:12:28.000Z",
+              runId: null,
+              plan: {
+                createdAt: "2026-03-17T19:12:28.000Z",
+                runId: null,
+                explanation: null,
+                steps: [
+                  { step: "Resolve triage instances", status: "inProgress" },
+                  { step: "Show instance badges", status: "pending" },
+                  { step: "Verify the shared dev stack", status: "pending" },
+                ],
+              },
+            },
+          },
+        ]}
+      />,
+    );
+
+    expect(markup).toContain("Resolve triage instances");
+    expect(markup).toContain("0/3");
+    expect(markup).toContain('aria-expanded="false"');
+  });
+
+  it("renders a muted failure marker for failed tool lifecycle entries", () => {
+    activityTestState.expanded = true;
     const markup = renderToStaticMarkup(
       <MessagesTimeline
         {...buildProps()}
@@ -1413,7 +2331,8 @@ describe("MessagesTimeline", () => {
       />,
     );
 
-    expect(markup).toContain('aria-label="Received 1 update and used 1 tool, tool call failed"');
+    expect(markup).toContain("lucide-x");
+    expect(markup).toContain('aria-label="Tool call failed"');
     // Ordinary tool failures render muted, not red.
     expect(markup).not.toContain("text-destructive");
   });
@@ -1443,7 +2362,8 @@ describe("MessagesTimeline", () => {
               createdAt: "2026-03-17T19:12:28.000Z",
               label: "Provider turn start failed",
               tone: "error",
-              sourceActivityKind: "provider.turn.start.failed",
+              itemType: "error",
+              toolLifecycleStatus: "failed",
             },
           },
         ]}
diff --git a/apps/web/src/components/chat/MessagesTimeline.tsx b/apps/web/src/components/chat/MessagesTimeline.tsx
index d8c88c088648..f1d549f8248a 100644
--- a/apps/web/src/components/chat/MessagesTimeline.tsx
+++ b/apps/web/src/components/chat/MessagesTimeline.tsx
@@ -2,20 +2,18 @@ import {
   type ChatFileAttachment,
   type EnvironmentId,
   type MessageId,
+  type OrchestrationV2TurnItem,
+  type RunAttemptId,
   type ScopedThreadRef,
+  type ServerProvider,
   type ServerProviderSkill,
-  type TurnId,
+  type RunId,
+  type ThreadId,
 } from "@t3tools/contracts";
 import { parseScopedThreadKey } from "@t3tools/client-runtime/environment";
-import type { AgentPanelModel } from "@t3tools/client-runtime/state/subagentRuntime";
-import {
-  emptyAgentPanelModel,
-  formatSubagentTokenCount,
-} from "@t3tools/client-runtime/state/subagentRuntime";
-
-const EMPTY_AGENT_PANEL_MODEL = emptyAgentPanelModel();
-const NOOP_OPEN_AGENTS = () => {};
+import { canForkProjectedAssistantItem } from "@t3tools/client-runtime/state/thread-workflows";
 const NOOP_DOWNLOAD_ATTACHMENT = (_attachment: ChatFileAttachment) => {};
+
 import { resolveChatListAnchoredEndSpace } from "@t3tools/shared/chatList";
 import {
   createContext,
@@ -24,7 +22,6 @@ import {
   use,
   useCallback,
   useEffect,
-  useLayoutEffect,
   useMemo,
   useRef,
   useState,
@@ -35,8 +32,11 @@ import {
 import { LegendList, type LegendListRef } from "@legendapp/list/react";
 import { FileDiff } from "@pierre/diffs/react";
 import {
-  deriveTimelineEntries,
+  type TimelineEntry,
+  providerErrorPresentation,
   workEntryDisplayIndicatesToolFailure,
+  workEntryIndicatesToolNeutralStatus,
+  workEntryIndicatesToolSuccess,
   workEntrySignalsSevereFailure,
   workLogEntryIsToolLike,
 } from "../../session-logic";
@@ -57,19 +57,24 @@ import {
   CheckIcon,
   ChevronDownIcon,
   ChevronRightIcon,
+  ChevronUpIcon,
   CircleAlertIcon,
   DownloadIcon,
   EyeIcon,
   FileIcon,
+  GitForkIcon,
   GlobeIcon,
-  HammerIcon,
+  type LucideIcon,
   MessageCircleIcon,
   MousePointerClickIcon,
   PaintbrushIcon,
-  SearchIcon,
+  MinusIcon,
+  Redo2Icon,
   SquarePenIcon,
   TerminalIcon,
   Undo2Icon,
+  HammerIcon,
+  SearchIcon,
   WrenchIcon,
   XIcon,
   ZapIcon,
@@ -79,12 +84,12 @@ import { buildExpandedImagePreview, ExpandedImagePreview } from "./ExpandedImage
 import { ProposedPlanCard } from "./ProposedPlanCard";
 import { ChangedFilesCard } from "./ChangedFilesTree";
 import { shouldAutoExpandChangedFiles } from "./changedFilesPresentation";
-import { keepTimelineEndVisibleAfterOverlayGrowth } from "./timelineScrollAnchoring";
 import { MessageCopyButton } from "./MessageCopyButton";
 import {
   computeStableMessagesTimelineRows,
   deriveMessagesTimelineRows,
   normalizeCompactToolLabel,
+  resolveTimelineToolPresentation,
   resolveAssistantMessageCopyState,
   resolveTimelineIsAtEnd,
   resolveTimelineMinimapHasPersistentGutter,
@@ -94,12 +99,11 @@ import {
   resolveTimelineMinimapInteractiveWidth,
   resolveTimelineMinimapTopPercent,
   shouldPreserveAssistantLineBreaks,
-  toolGroupAction,
   workEntryIsVisibleInGroup,
   type StableMessagesTimelineRowsState,
   type MessagesTimelineRow,
   TIMELINE_MINIMAP_MIN_ITEMS,
-  type TimelineLatestTurn,
+  type TimelineLatestRun,
 } from "./MessagesTimeline.logic";
 import { TerminalContextInlineChip } from "./TerminalContextInlineChip";
 import { Tooltip, TooltipPopup, TooltipTrigger } from "../ui/tooltip";
@@ -119,6 +123,10 @@ import { cn } from "~/lib/utils";
 import { useUiStateStore } from "~/uiStateStore";
 import { type TimestampFormat } from "@t3tools/contracts/settings";
 import { formatChatTimestampTooltip, formatDayAwareTimestamp } from "../../timestampFormat";
+import { V2ItemInspector } from "./V2ItemInspector";
+import { useV2ItemSupport } from "../../state/v2ItemSupport";
+import { isV2LifecycleItem, V2LifecycleRow, type HandoffTimelineRun } from "./V2LifecycleRow";
+import { TimelineSystemDivider } from "./TimelineSystemDivider";
 
 import {
   buildInlineTerminalContextText,
@@ -149,54 +157,40 @@ interface TimelineRowSharedState {
   resolvedTheme: "light" | "dark";
   workspaceRoot: string | undefined;
   skills: ReadonlyArray<Pick<ServerProviderSkill, "name" | "displayName">>;
+  /** Provider snapshots for resolving handoff endpoints to icons + model names. */
+  providerStatuses: ReadonlyArray<ServerProvider>;
+  /** Projection runs, for recovering handoff models on legacy items. */
+  runs: ReadonlyArray<HandoffTimelineRun>;
   activeThreadEnvironmentId: EnvironmentId;
   onRevertUserMessage: (messageId: MessageId) => void;
   onImageExpand: (preview: ExpandedImagePreview) => void;
+  onOpenTurnDiff: (runId: RunId, filePath?: string) => void;
+  onOpenThread: (threadId: OrchestrationV2TurnItem["threadId"]) => void;
+  onForkFromRun: (input: {
+    readonly sourceThreadId: ThreadId;
+    readonly runId: RunId;
+  }) => Promise<void>;
+  onRollbackCheckpoint: (input: {
+    readonly checkpointId: string;
+    readonly scopeId: string;
+  }) => void;
+  onToggleTurnFold: (runId: RunId) => void;
+  onToggleAttemptFold: (attemptId: RunAttemptId) => void;
   onFileDownload: (attachment: ChatFileAttachment) => void;
-  onOpenTurnDiff: (turnId: TurnId, filePath?: string) => void;
-  onToggleTurnFold: (turnId: TurnId) => void;
   onToggleWorkGroup: (groupId: string, anchorKey: string) => void;
-  agentPanelModel: AgentPanelModel;
-  onOpenAgents: () => void;
 }
 
 interface TimelineRowActivityState {
   isWorking: boolean;
   isRevertingCheckpoint: boolean;
-  latestTurnId: TurnId | null;
+  activeTurnInProgress: boolean;
+  latestRunId: RunId | null;
 }
 
 const TimelineRowCtx = createContext<TimelineRowSharedState>(null!);
 const TimelineRowActivityCtx = createContext<TimelineRowActivityState>(null!);
 const TIMELINE_LIST_HEADER = <div className="h-3 sm:h-4" />;
 const TIMELINE_LIST_FADE_HEADER = <div className="h-10 sm:h-12" />;
-
-// Header row shown when older turns exist beyond the loaded window. Plain
-// button, no spinner animation; the label change is the loading indicator.
-function TimelineLoadEarlierHeader({
-  loading,
-  onLoadEarlier,
-  fade,
-}: {
-  loading: boolean;
-  onLoadEarlier: () => void;
-  fade: boolean;
-}) {
-  return (
-    <div className={fade ? "pt-10 sm:pt-12" : "pt-3 sm:pt-4"}>
-      <div className="mx-auto w-full max-w-3xl pb-2">
-        <button
-          type="button"
-          onClick={onLoadEarlier}
-          disabled={loading}
-          className="w-full py-1.5 text-xs text-muted-foreground/60 hover:text-foreground disabled:cursor-default"
-        >
-          {loading ? "Loading earlier turns…" : "Load earlier turns"}
-        </button>
-      </div>
-    </div>
-  );
-}
 const TIMELINE_LIST_FOOTER = <div className="h-3 sm:h-4" />;
 const EMPTY_TIMELINE_SKILLS: ReadonlyArray<Pick<ServerProviderSkill, "name" | "displayName">> = [];
 const TIMELINE_MAINTAIN_SCROLL_AT_END = {
@@ -207,22 +201,42 @@ const TIMELINE_MAINTAIN_SCROLL_AT_END = {
     layout: true,
   },
 } as const;
+const EMPTY_TIMELINE_PROVIDERS: ReadonlyArray<ServerProvider> = [];
+const EMPTY_TIMELINE_RUNS: ReadonlyArray<HandoffTimelineRun> = [];
 
 // ---------------------------------------------------------------------------
 // Props (public API)
 // ---------------------------------------------------------------------------
 
+export interface MessagesTimelineHistoryControls {
+  readonly hasMoreHistory: boolean;
+  readonly loading: boolean;
+  readonly error: string | null;
+  readonly onLoadEarlier: () => void;
+}
+
 interface MessagesTimelineProps {
-  agentPanelModel?: AgentPanelModel;
-  onOpenAgents?: () => void;
   isWorking: boolean;
+  activeTurnInProgress: boolean;
   listRef: React.RefObject<LegendListRef | null>;
-  timelineEntries: ReturnType<typeof deriveTimelineEntries>;
-  latestTurn: TimelineLatestTurn | null;
-  runningTurnId: TurnId | null;
+  timelineEntries: ReadonlyArray<TimelineEntry>;
+  latestRun: TimelineLatestRun | null;
   turnDiffSummaryByAssistantMessageId: Map<MessageId, TurnDiffSummary>;
   routeThreadKey: string;
-  onOpenTurnDiff: (turnId: TurnId, filePath?: string) => void;
+  onOpenTurnDiff: (runId: RunId, filePath?: string) => void;
+  onOpenThread: (threadId: OrchestrationV2TurnItem["threadId"]) => void;
+  parentThreadLink?: {
+    readonly threadId: ThreadId;
+    readonly title: string;
+  } | null;
+  onForkFromRun: (input: {
+    readonly sourceThreadId: ThreadId;
+    readonly runId: RunId;
+  }) => Promise<void>;
+  onRollbackCheckpoint: (input: {
+    readonly checkpointId: string;
+    readonly scopeId: string;
+  }) => void;
   revertTurnCountByUserMessageId: Map<MessageId, number>;
   onRevertUserMessage: (messageId: MessageId) => void;
   isRevertingCheckpoint: boolean;
@@ -234,9 +248,13 @@ interface MessagesTimelineProps {
   timestampFormat: TimestampFormat;
   workspaceRoot: string | undefined;
   skills?: ReadonlyArray<Pick<ServerProviderSkill, "name" | "displayName">>;
+  providerStatuses?: ReadonlyArray<ServerProvider>;
+  runs?: ReadonlyArray<HandoffTimelineRun>;
   anchorMessageId: MessageId | null;
   onAnchorReady: (messageId: MessageId, anchorIndex: number) => void;
+  onAnchorSizeChanged: (messageId: MessageId, size: number) => void;
   contentInsetEndAdjustment: number;
+  onIsAtEndChange: (isAtEnd: boolean) => void;
   /**
    * Whether the timeline should keep pinning to the live edge as content
    * grows. Off while the user is reading history; LegendList's own
@@ -244,12 +262,10 @@ interface MessagesTimelineProps {
    * scroll-mode refs whenever the user drifts near the bottom.
    */
   liveFollowEnabled: boolean;
-  onIsAtEndChange: (isAtEnd: boolean) => void;
   onManualNavigation: () => void;
   hideEmptyPlaceholder?: boolean;
   topFadeEnabled?: boolean;
-  /** Non-null when older turns exist beyond the loaded window. */
-  loadEarlier?: { readonly loading: boolean; readonly onLoadEarlier: () => void } | null;
+  historyControls?: MessagesTimelineHistoryControls;
 }
 
 // ---------------------------------------------------------------------------
@@ -258,15 +274,17 @@ interface MessagesTimelineProps {
 
 export const MessagesTimeline = memo(function MessagesTimeline({
   isWorking,
-  agentPanelModel = EMPTY_AGENT_PANEL_MODEL,
-  onOpenAgents = NOOP_OPEN_AGENTS,
+  activeTurnInProgress,
   listRef,
   timelineEntries,
-  latestTurn,
-  runningTurnId,
+  latestRun,
   turnDiffSummaryByAssistantMessageId,
   routeThreadKey,
   onOpenTurnDiff,
+  onOpenThread,
+  parentThreadLink = null,
+  onForkFromRun,
+  onRollbackCheckpoint,
   revertTurnCountByUserMessageId,
   onRevertUserMessage,
   isRevertingCheckpoint,
@@ -278,34 +296,29 @@ export const MessagesTimeline = memo(function MessagesTimeline({
   timestampFormat,
   workspaceRoot,
   skills = EMPTY_TIMELINE_SKILLS,
+  providerStatuses = EMPTY_TIMELINE_PROVIDERS,
+  runs: runsProp = EMPTY_TIMELINE_RUNS,
   anchorMessageId,
   onAnchorReady,
+  onAnchorSizeChanged,
   contentInsetEndAdjustment,
-  liveFollowEnabled,
   onIsAtEndChange,
+  liveFollowEnabled,
   onManualNavigation,
   hideEmptyPlaceholder = false,
   topFadeEnabled = false,
-  loadEarlier = null,
+  historyControls,
 }: MessagesTimelineProps) {
-  const [expandedTurnIds, setExpandedTurnIds] = useState<ReadonlySet<TurnId>>(new Set());
+  const [expandedRunIds, setExpandedRunIds] = useState<ReadonlySet<RunId>>(new Set());
+  const [expandedAttemptIds, setExpandedAttemptIds] = useState<ReadonlySet<RunAttemptId>>(
+    new Set(),
+  );
   const [expandedWorkGroupIds, setExpandedWorkGroupIds] = useState<ReadonlySet<string>>(new Set());
-  const [disclosureToggleSettling, setDisclosureToggleSettling] = useState(false);
   const [minimapStripMap] = useState(() => new Map<string, HTMLSpanElement>());
+  const [disclosureToggleSettling, setDisclosureToggleSettling] = useState(false);
   const disclosureAnchorKeyRef = useRef<string | null>(null);
   const disclosureSettleFrameRef = useRef<number | null>(null);
   const disclosureSettleSecondFrameRef = useRef<number | null>(null);
-  const previousContentInsetEndAdjustmentRef = useRef(contentInsetEndAdjustment);
-
-  useLayoutEffect(() => {
-    keepTimelineEndVisibleAfterOverlayGrowth({
-      timeline: listRef.current,
-      previousOverlayHeight: previousContentInsetEndAdjustmentRef.current,
-      overlayHeight: contentInsetEndAdjustment,
-      followingEnd: liveFollowEnabled && anchorMessageId === null,
-    });
-    previousContentInsetEndAdjustmentRef.current = contentInsetEndAdjustment;
-  }, [anchorMessageId, contentInsetEndAdjustment, listRef, liveFollowEnabled]);
 
   useEffect(() => {
     return () => {
@@ -318,6 +331,10 @@ export const MessagesTimeline = memo(function MessagesTimeline({
     };
   }, []);
 
+  // A fold toggle inserts/removes rows around the toggled row. Suspending
+  // LegendList's end-scroll maintenance for two frames and anchoring
+  // maintainVisibleContentPosition to the toggled row keeps the trigger
+  // stationary under the pointer instead of the viewport chasing the end.
   const suspendEndScrollMaintenanceForDisclosure = useCallback((anchorKey: string) => {
     disclosureAnchorKeyRef.current = anchorKey;
     setDisclosureToggleSettling(true);
@@ -342,24 +359,15 @@ export const MessagesTimeline = memo(function MessagesTimeline({
     return disclosureAnchorKey === null || row.id === disclosureAnchorKey;
   }, []);
 
-  const maintainVisibleContentPosition = useMemo(
-    () => ({
-      data: true,
-      size: true,
-      shouldRestorePosition: shouldRestoreVisibleContentPosition,
-    }),
-    [shouldRestoreVisibleContentPosition],
-  );
-
   const onToggleTurnFold = useCallback(
-    (turnId: TurnId) => {
-      suspendEndScrollMaintenanceForDisclosure(`turn-fold:${turnId}`);
-      setExpandedTurnIds((existing) => {
+    (runId: RunId) => {
+      suspendEndScrollMaintenanceForDisclosure(`turn-fold:${runId}`);
+      setExpandedRunIds((existing) => {
         const next = new Set(existing);
-        if (next.has(turnId)) {
-          next.delete(turnId);
+        if (next.has(runId)) {
+          next.delete(runId);
         } else {
-          next.add(turnId);
+          next.add(runId);
         }
         return next;
       });
@@ -381,43 +389,58 @@ export const MessagesTimeline = memo(function MessagesTimeline({
     },
     [suspendEndScrollMaintenanceForDisclosure],
   );
+  const onToggleAttemptFold = useCallback(
+    (attemptId: RunAttemptId) => {
+      suspendEndScrollMaintenanceForDisclosure(`attempt-fold:${attemptId}`);
+      setExpandedAttemptIds((existing) => {
+        const next = new Set(existing);
+        if (next.has(attemptId)) {
+          next.delete(attemptId);
+        } else {
+          next.add(attemptId);
+        }
+        return next;
+      });
+    },
+    [suspendEndScrollMaintenanceForDisclosure],
+  );
 
   // An in-session interrupt leaves its turn expanded so the user keeps their
   // place; the next turn (or a reload, since this is local state) folds it.
-  const previousLatestTurnRef = useRef(latestTurn);
+  const previousLatestRunRef = useRef(latestRun);
   useEffect(() => {
-    const previous = previousLatestTurnRef.current;
-    previousLatestTurnRef.current = latestTurn;
-    if (!latestTurn || previous?.turnId === undefined) {
+    const previous = previousLatestRunRef.current;
+    previousLatestRunRef.current = latestRun;
+    if (!latestRun || previous?.runId === undefined) {
       return;
     }
-    if (latestTurn.turnId === previous.turnId) {
-      if (previous.state === "running" && latestTurn.state === "interrupted") {
-        setExpandedTurnIds((existing) => {
+    if (latestRun.runId === previous.runId) {
+      if (previous.status === "running" && latestRun.status === "interrupted") {
+        setExpandedRunIds((existing) => {
           const next = new Set(existing);
-          next.add(latestTurn.turnId);
+          next.add(latestRun.runId);
           return next;
         });
       }
       return;
     }
-    setExpandedTurnIds((existing) => {
-      if (!existing.has(previous.turnId)) {
+    setExpandedRunIds((existing) => {
+      if (!existing.has(previous.runId)) {
         return existing;
       }
       const next = new Set(existing);
-      next.delete(previous.turnId);
+      next.delete(previous.runId);
       return next;
     });
-  }, [latestTurn]);
+  }, [latestRun]);
 
   const rawRows = useMemo(
     () =>
       deriveMessagesTimelineRows({
         timelineEntries,
-        latestTurn,
-        runningTurnId,
-        expandedTurnIds,
+        latestRun,
+        expandedRunIds,
+        expandedAttemptIds,
         expandedWorkGroupIds,
         isWorking,
         turnDiffSummaryByAssistantMessageId,
@@ -425,9 +448,9 @@ export const MessagesTimeline = memo(function MessagesTimeline({
       }),
     [
       timelineEntries,
-      latestTurn,
-      runningTurnId,
-      expandedTurnIds,
+      latestRun,
+      expandedRunIds,
+      expandedAttemptIds,
       expandedWorkGroupIds,
       isWorking,
       turnDiffSummaryByAssistantMessageId,
@@ -435,6 +458,9 @@ export const MessagesTimeline = memo(function MessagesTimeline({
     ],
   );
   const rows = useStableRows(rawRows);
+  // Run status/timestamps churn on every stream event; the shared row context
+  // must not change with them or every timeline row re-renders per event.
+  const runs = useStableHandoffRuns(runsProp);
   const minimapItems = useMemo(() => deriveTimelineMinimapItems(rows), [rows]);
   const [timelineViewportElement, setTimelineViewportElement] = useState<HTMLDivElement | null>(
     null,
@@ -449,12 +475,30 @@ export const MessagesTimeline = memo(function MessagesTimeline({
     },
     [anchorMessageId, onAnchorReady],
   );
+  const handleAnchorSizeChanged = useCallback(
+    (size: number) => {
+      if (anchorMessageId !== null) {
+        onAnchorSizeChanged(anchorMessageId, size);
+      }
+    },
+    [anchorMessageId, onAnchorSizeChanged],
+  );
   const anchoredEndSpace = useMemo(() => {
     const config = resolveChatListAnchoredEndSpace(rows, anchorMessageId, (row) =>
       row.kind === "message" && row.message.role === "user" ? row.message.id : null,
     );
-    return config ? { ...config, onReady: handleAnchorReady } : undefined;
-  }, [anchorMessageId, handleAnchorReady, rows]);
+    return config
+      ? { ...config, onReady: handleAnchorReady, onSizeChanged: handleAnchorSizeChanged }
+      : undefined;
+  }, [anchorMessageId, handleAnchorReady, handleAnchorSizeChanged, rows]);
+  const maintainVisibleContentPosition = useMemo(
+    () => ({
+      data: true,
+      size: true,
+      shouldRestorePosition: shouldRestoreVisibleContentPosition,
+    }),
+    [shouldRestoreVisibleContentPosition],
+  );
 
   const handleScroll = useCallback(() => {
     const state = listRef.current?.getState?.();
@@ -482,9 +526,14 @@ export const MessagesTimeline = memo(function MessagesTimeline({
         rowTop < scrollBottom &&
         rowTop + Math.max(1, rowHeight ?? 1) > scrollTop;
 
-      strip.dataset.inView = inView ? "true" : "false";
+      // Skip no-op attribute writes: this runs for every strip on every scroll
+      // tick, and rewriting an unchanged attribute still dirties style state.
+      const next = inView ? "true" : "false";
+      if (strip.dataset.inView !== next) {
+        strip.dataset.inView = next;
+      }
     }
-  }, [contentInsetEndAdjustment, listRef, minimapItems, minimapStripMap, onIsAtEndChange]);
+  }, [listRef, minimapItems, minimapStripMap, onIsAtEndChange, contentInsetEndAdjustment]);
 
   useEffect(() => {
     const frame = requestAnimationFrame(handleScroll);
@@ -525,15 +574,19 @@ export const MessagesTimeline = memo(function MessagesTimeline({
       resolvedTheme,
       workspaceRoot,
       skills,
+      providerStatuses,
+      runs,
       activeThreadEnvironmentId,
       onRevertUserMessage,
       onImageExpand,
       onFileDownload,
       onOpenTurnDiff,
+      onOpenThread,
+      onForkFromRun,
+      onRollbackCheckpoint,
       onToggleTurnFold,
+      onToggleAttemptFold,
       onToggleWorkGroup,
-      agentPanelModel,
-      onOpenAgents,
     }),
     [
       timestampFormat,
@@ -542,44 +595,87 @@ export const MessagesTimeline = memo(function MessagesTimeline({
       resolvedTheme,
       workspaceRoot,
       skills,
+      providerStatuses,
+      runs,
       activeThreadEnvironmentId,
       onRevertUserMessage,
       onImageExpand,
       onFileDownload,
       onOpenTurnDiff,
+      onOpenThread,
+      onForkFromRun,
+      onRollbackCheckpoint,
       onToggleTurnFold,
+      onToggleAttemptFold,
       onToggleWorkGroup,
-      agentPanelModel,
-      onOpenAgents,
     ],
   );
   const activityState = useMemo<TimelineRowActivityState>(
     () => ({
       isWorking,
       isRevertingCheckpoint,
-      latestTurnId: latestTurn?.turnId ?? null,
+      activeTurnInProgress,
+      latestRunId: latestRun?.runId ?? null,
     }),
-    [isRevertingCheckpoint, isWorking, latestTurn?.turnId],
+    [activeTurnInProgress, isRevertingCheckpoint, isWorking, latestRun?.runId],
   );
+  const listHeader = useMemo(() => {
+    const leadingContent =
+      parentThreadLink === null ? (
+        topFadeEnabled ? (
+          TIMELINE_LIST_FADE_HEADER
+        ) : (
+          TIMELINE_LIST_HEADER
+        )
+      ) : (
+        <div className="messages-timeline-row-frame">
+          <div className="chat-content-lane pt-1 sm:pt-2">
+            <TimelineSystemDivider
+              label="Subagent of"
+              detail={parentThreadLink.title}
+              icon={BotIcon}
+              actionLabel="Open parent thread"
+              onAction={() => onOpenThread(parentThreadLink.threadId)}
+            />
+          </div>
+        </div>
+      );
+    return (
+      <>
+        {parentThreadLink === null ? leadingContent : null}
+        {historyControls ? <TimelineHistoryControl {...historyControls} /> : null}
+        {parentThreadLink !== null ? leadingContent : null}
+      </>
+    );
+  }, [historyControls, onOpenThread, parentThreadLink, topFadeEnabled]);
 
   // Stable renderItem — no closure deps. Row components read shared state
   // from TimelineRowCtx, which propagates through LegendList's memo.
   const renderItem = useCallback(
     ({ item }: { item: MessagesTimelineRow }) => (
-      <div className="mx-auto w-full min-w-0 max-w-3xl overflow-x-clip" data-timeline-root="true">
-        <TimelineRowContent row={item} />
+      <div className="messages-timeline-row-frame">
+        <div className="chat-content-lane overflow-x-clip" data-timeline-root="true">
+          <TimelineRowContent row={item} />
+        </div>
       </div>
     ),
     [],
   );
 
-  if (rows.length === 0 && !isWorking) {
+  if (
+    rows.length === 0 &&
+    !isWorking &&
+    parentThreadLink === null &&
+    historyControls === undefined
+  ) {
     if (hideEmptyPlaceholder) {
       return null;
     }
     return (
       <div className="flex h-full items-center justify-center">
-        <p className="text-placeholder text-sm">Send a message to start the conversation.</p>
+        <p className="text-sm text-muted-foreground/30">
+          Send a message to start the conversation.
+        </p>
       </div>
     );
   }
@@ -598,6 +694,10 @@ export const MessagesTimeline = memo(function MessagesTimeline({
             initialScrollAtEnd
             {...(anchoredEndSpace ? { anchoredEndSpace } : {})}
             contentInsetEndAdjustment={contentInsetEndAdjustment}
+            // LegendList owns ordinary end-follow (#5449): the app only turns
+            // it off while the user reads history (liveFollowEnabled), while a
+            // sent turn anchors near the top (anchoredEndSpace), or for the
+            // two-frame settle window of a fold toggle.
             maintainScrollAtEnd={
               anchoredEndSpace || !liveFollowEnabled || disclosureToggleSettling
                 ? false
@@ -606,22 +706,10 @@ export const MessagesTimeline = memo(function MessagesTimeline({
             maintainVisibleContentPosition={maintainVisibleContentPosition}
             onScroll={handleScroll}
             className={cn(
-              "scrollbar-gutter-both h-full min-h-0 overflow-x-hidden overscroll-y-contain px-3 [overflow-anchor:none] sm:px-5",
+              "messages-timeline-scroll scrollbar-gutter-both h-full min-h-0 overflow-x-hidden overscroll-y-contain px-3 [overflow-anchor:none] sm:px-5",
               topFadeEnabled && "topbar-scroll-fade",
             )}
-            ListHeaderComponent={
-              loadEarlier !== null ? (
-                <TimelineLoadEarlierHeader
-                  loading={loadEarlier.loading}
-                  onLoadEarlier={loadEarlier.onLoadEarlier}
-                  fade={topFadeEnabled}
-                />
-              ) : topFadeEnabled ? (
-                TIMELINE_LIST_FADE_HEADER
-              ) : (
-                TIMELINE_LIST_HEADER
-              )
-            }
+            ListHeaderComponent={listHeader}
             ListFooterComponent={TIMELINE_LIST_FOOTER}
           />
           <TimelineMinimap
@@ -644,6 +732,35 @@ export const MessagesTimeline = memo(function MessagesTimeline({
   );
 });
 
+function TimelineHistoryControl(props: MessagesTimelineHistoryControls) {
+  if (!props.hasMoreHistory && props.error === null) {
+    return null;
+  }
+  return (
+    <div className="messages-timeline-row-frame">
+      <div className="chat-content-lane flex flex-col items-center gap-1.5 py-2">
+        {props.hasMoreHistory ? (
+          <Button
+            size="sm"
+            variant="outline"
+            disabled={props.loading}
+            aria-label="Load earlier activity"
+            onClick={props.onLoadEarlier}
+          >
+            <ChevronUpIcon />
+            {props.loading ? "Loading earlier activity…" : "Load earlier activity"}
+          </Button>
+        ) : null}
+        {props.error !== null ? (
+          <p role="status" className="text-center text-muted-foreground text-xs">
+            {props.error}
+          </p>
+        ) : null}
+      </div>
+    </div>
+  );
+}
+
 function keyExtractor(item: MessagesTimelineRow) {
   return item.id;
 }
@@ -865,17 +982,25 @@ function TimelineMinimap({
             const activeDistance =
               resolvedActiveIndex === null ? null : Math.abs(index - resolvedActiveIndex);
             return (
+              // Compositor-friendly on purpose: in-view state and the hover
+              // fisheye animate constantly (every scroll tick and streaming
+              // update flips a band of strips), so the strip animates only
+              // transform and opacity. Width tiers are a scale-x on a fixed
+              // w-6 box, and the in-view highlight is an opacity-faded bright
+              // overlay — never background-color or width, which would force
+              // main-thread style/layout/paint at 60fps for each transition.
               <span
                 aria-hidden="true"
                 className={cn(
-                  "pointer-events-none absolute left-0 h-0.5 -translate-y-1/2 rounded-full bg-muted-foreground/35 transition-[background-color,width] duration-150 data-[in-view=true]:bg-foreground/90",
+                  "group/strip pointer-events-none absolute left-0 h-0.5 w-6 origin-left -translate-y-1/2 rounded-full transition-transform duration-150",
+                  activeDistance === 0 ? "bg-muted-foreground/75" : "bg-muted-foreground/35",
                   activeDistance === 0
-                    ? "w-6 bg-muted-foreground/75"
+                    ? "scale-x-100"
                     : activeDistance === 1
-                      ? "w-4"
+                      ? "scale-x-[0.667]"
                       : activeDistance === 2
-                        ? "w-2.5"
-                        : "w-2",
+                        ? "scale-x-[0.417]"
+                        : "scale-x-[0.333]",
                 )}
                 data-in-view="false"
                 data-minimap-strip
@@ -888,7 +1013,9 @@ function TimelineMinimap({
                   }
                 }}
                 style={{ top }}
-              />
+              >
+                <span className="absolute inset-0 rounded-full bg-foreground/90 opacity-0 transition-opacity duration-150 group-data-[in-view=true]/strip:opacity-100" />
+              </span>
             );
           })}
           {activeItem ? (
@@ -930,6 +1057,7 @@ function TimelineMinimap({
 // TimelineRowContent — the actual row component
 // ---------------------------------------------------------------------------
 
+type TimelineMessage = Extract<TimelineEntry, { kind: "message" }>["message"];
 type TimelineWorkEntry = Extract<MessagesTimelineRow, { kind: "work" }>["groupedEntries"][number];
 type TimelineRow = MessagesTimelineRow;
 
@@ -951,14 +1079,16 @@ const TimelineRowContent = memo(function TimelineRowContent({ row }: { row: Time
           : isExpandedToolGroupHeader
             ? "pb-0"
             : row.kind === "turn-fold"
-              ? "pb-1.5"
+              ? "pb-0"
               : (row.kind === "message" &&
                     row.message.role === "assistant" &&
                     !row.showAssistantMeta) ||
                   row.kind === "work" ||
                   row.kind === "work-live" ||
                   row.kind === "work-toggle" ||
-                  row.kind === "turn-plan"
+                  row.kind === "turn-plan" ||
+                  row.kind === "event" ||
+                  row.kind === "attempt-fold"
                 ? "pb-2"
                 : "pb-4",
         row.kind === "message" && row.message.role === "assistant" ? "group/assistant" : null,
@@ -977,12 +1107,14 @@ const TimelineRowContent = memo(function TimelineRowContent({ row }: { row: Time
       {row.kind === "work-live" ? <LiveWorkEntryTimelineRow row={row} /> : null}
       {row.kind === "work-toggle" ? <WorkGroupToggleTimelineRow row={row} /> : null}
       {row.kind === "turn-fold" ? <TurnFoldTimelineRow row={row} /> : null}
+      {row.kind === "attempt-fold" ? <AttemptFoldTimelineRow row={row} /> : null}
       {row.kind === "message" && row.message.role === "user" ? <UserTimelineRow row={row} /> : null}
       {row.kind === "message" && row.message.role === "assistant" ? (
         <AssistantTimelineRow row={row} />
       ) : null}
       {row.kind === "proposed-plan" ? <ProposedPlanTimelineRow row={row} /> : null}
       {row.kind === "turn-plan" ? <TurnPlanTimelineRow row={row} /> : null}
+      {row.kind === "event" ? <V2EventTimelineRow row={row} /> : null}
     </div>
   );
 });
@@ -1017,7 +1149,18 @@ function UserTimelineRow({ row }: { row: Extract<TimelineRow, { kind: "message"
 
   return (
     <div className="group flex flex-col items-end gap-1">
-      <div className="relative max-w-[80%] rounded-2xl bg-message p-3 text-message-foreground">
+      {row.message.createdBy === "agent" ? (
+        <p
+          className="me-1 text-[11px] text-muted-foreground/70"
+          data-user-message-attribution="agent"
+        >
+          Sent by another agent
+        </p>
+      ) : null}
+      {row.message.inputIntent && row.message.inputIntent !== "turn_start" ? (
+        <UserMessageIntentMarker intent={row.message.inputIntent} />
+      ) : null}
+      <div className="relative max-w-[80%] rounded-2xl bg-accent p-3">
         {regularImages.length > 0 && (
           <div className="mb-2 grid max-w-[420px] grid-cols-2 gap-2">
             {regularImages.map((image) => (
@@ -1043,7 +1186,7 @@ function UserTimelineRow({ row }: { row: Extract<TimelineRow, { kind: "message"
                     />
                   </button>
                 ) : (
-                  <div className="flex min-h-[72px] items-center justify-center px-2 py-3 text-center text-secondary-label text-[11px]">
+                  <div className="flex min-h-[72px] items-center justify-center px-2 py-3 text-center text-[11px] text-muted-foreground/70">
                     {image.name}
                   </div>
                 )}
@@ -1120,6 +1263,16 @@ function UserTimelineRow({ row }: { row: Extract<TimelineRow, { kind: "message"
           markdownCwd={ctx.markdownCwd}
         />
       </div>
+      {row.projectedItem &&
+      row.projectedItem.item.status !== "completed" &&
+      row.projectedItem.item.status !== "pending" &&
+      row.projectedItem.item.status !== "waiting" ? (
+        <div className="me-1 flex items-center gap-1.5">
+          <span className="rounded-full border border-destructive/25 bg-destructive/8 px-1.5 py-0.5 text-[10px] font-medium text-destructive">
+            {row.projectedItem.item.status}
+          </span>
+        </div>
+      ) : null}
       <div className="flex w-full max-w-[80%] items-center justify-end pe-1 text-xs tabular-nums opacity-0 transition-opacity duration-200 focus-within:opacity-100 group-hover:opacity-100">
         <div className="flex shrink-0 items-center gap-2">
           <Tooltip>
@@ -1142,6 +1295,51 @@ function UserTimelineRow({ row }: { row: Extract<TimelineRow, { kind: "message"
   );
 }
 
+function UserMessageIntentMarker({
+  intent,
+}: {
+  readonly intent: NonNullable<TimelineMessage["inputIntent"]>;
+}) {
+  const presentation =
+    intent === "queued_turn"
+      ? {
+          label: "Queued",
+          icon: null,
+        }
+      : intent === "promoted_queued_to_steer"
+        ? {
+            label: "Steer",
+            icon: Redo2Icon,
+          }
+        : {
+            label: "Steer",
+            icon: Redo2Icon,
+          };
+  const IntentIcon = presentation.icon;
+  return (
+    <Tooltip>
+      <TooltipTrigger
+        render={
+          <div
+            className="me-1 flex items-center justify-end gap-1 text-xs leading-none text-muted-foreground"
+            data-user-message-intent={intent}
+          />
+        }
+      >
+        {IntentIcon ? <IntentIcon aria-hidden="true" className="size-3" /> : null}
+        {presentation.label}
+      </TooltipTrigger>
+      <TooltipPopup side="top">
+        {intent === "queued_turn"
+          ? "Queued behind the active turn"
+          : intent === "promoted_queued_to_steer"
+            ? "Originally queued, then promoted to steer the active turn"
+            : "Steered the active turn"}
+      </TooltipPopup>
+    </Tooltip>
+  );
+}
+
 function RevertUserMessageButton({ messageId }: { messageId: MessageId }) {
   const ctx = use(TimelineRowCtx);
   const activity = use(TimelineRowActivityCtx);
@@ -1172,13 +1370,13 @@ function TurnFoldTimelineRow({ row }: { row: Extract<TimelineRow, { kind: "turn-
   const Icon = row.expanded ? ChevronDownIcon : ChevronRightIcon;
 
   return (
-    <div className="border-b border-border/60 pb-2 pt-1">
+    <div className="pb-2 pt-1">
       <button
         type="button"
         aria-expanded={row.expanded}
         data-scroll-anchor-ignore
-        onClick={() => ctx.onToggleTurnFold(row.turnId)}
-        className="flex cursor-pointer select-none items-center gap-1 rounded-md px-1 text-sm leading-relaxed text-muted-foreground tabular-nums transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-ring/70"
+        onClick={() => ctx.onToggleTurnFold(row.runId)}
+        className="flex cursor-pointer select-none items-center gap-1 rounded-md px-1 text-xs text-muted-foreground tabular-nums transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-ring/70"
       >
         <span>{row.label}</span>
         <Icon className="size-3.5" />
@@ -1187,6 +1385,26 @@ function TurnFoldTimelineRow({ row }: { row: Extract<TimelineRow, { kind: "turn-
   );
 }
 
+function AttemptFoldTimelineRow({ row }: { row: Extract<TimelineRow, { kind: "attempt-fold" }> }) {
+  const ctx = use(TimelineRowCtx);
+  const Icon = row.expanded ? ChevronDownIcon : ChevronRightIcon;
+
+  return (
+    <button
+      type="button"
+      aria-expanded={row.expanded}
+      data-scroll-anchor-ignore
+      data-superseded-attempt-id={row.attemptId}
+      onClick={() => ctx.onToggleAttemptFold(row.attemptId)}
+      className="flex w-full cursor-pointer select-none items-center gap-2 rounded-md border border-border/60 bg-muted/20 px-2.5 py-2 text-left transition-colors hover:bg-muted/35 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-ring/70"
+    >
+      <Icon className="size-3.5 shrink-0 text-muted-foreground" />
+      <span className="text-xs font-medium text-foreground/80">{row.label}</span>
+      <span className="text-[11px] text-muted-foreground">Partial output retained</span>
+    </button>
+  );
+}
+
 function AssistantTimelineRow({ row }: { row: Extract<TimelineRow, { kind: "message" }> }) {
   const ctx = use(TimelineRowCtx);
   const messageText = row.message.text || (row.message.streaming ? "" : "(empty response)");
@@ -1209,8 +1427,16 @@ function AssistantTimelineRow({ row }: { row: Extract<TimelineRow, { kind: "mess
           onOpenTurnDiff={ctx.onOpenTurnDiff}
         />
         {row.showAssistantMeta ? (
-          <div className="mt-1.5 flex items-center gap-2 text-xs tabular-nums opacity-0 transition-opacity duration-200 focus-within:opacity-100 group-hover/assistant:opacity-100">
+          <div className="mt-1.5 flex items-center gap-2 text-xs tabular-nums opacity-60 transition-opacity duration-200 focus-within:opacity-100 group-hover/assistant:opacity-100">
+            {row.projectedItem?.item.type === "assistant_message" ? (
+              <AssistantForkButton projectedItem={row.projectedItem} />
+            ) : null}
             <AssistantCopyButton row={row} />
+            {row.projectedItem && row.projectedItem.item.status !== "completed" ? (
+              <span className="rounded-full border border-border/70 px-1.5 py-0.5 font-mono text-[10px] text-muted-foreground">
+                {row.projectedItem.item.status}
+              </span>
+            ) : null}
             {!row.message.streaming && (
               <Tooltip>
                 <TooltipTrigger
@@ -1230,6 +1456,52 @@ function AssistantTimelineRow({ row }: { row: Extract<TimelineRow, { kind: "mess
   );
 }
 
+function AssistantForkButton({
+  projectedItem,
+}: {
+  readonly projectedItem: NonNullable<Extract<TimelineRow, { kind: "message" }>["projectedItem"]>;
+}) {
+  const ctx = use(TimelineRowCtx);
+  const [busy, setBusy] = useState(false);
+  const support = useV2ItemSupport({
+    environmentId: ctx.activeThreadEnvironmentId,
+    sourceThreadId: projectedItem.sourceThreadId,
+    sourceItemId: projectedItem.sourceItemId,
+  });
+  const canFork = canForkProjectedAssistantItem({
+    projectedItem,
+    capabilities: support.providerSession?.capabilities,
+  });
+
+  if (!canFork || projectedItem.item.runId === null) return null;
+  const runId = projectedItem.item.runId;
+
+  return (
+    <Tooltip>
+      <TooltipTrigger
+        render={
+          <Button
+            type="button"
+            size="xs"
+            variant="ghost"
+            disabled={busy}
+            onClick={() => {
+              setBusy(true);
+              void ctx
+                .onForkFromRun({ sourceThreadId: projectedItem.sourceThreadId, runId })
+                .finally(() => setBusy(false));
+            }}
+            aria-label="Fork from this response"
+          />
+        }
+      >
+        <GitForkIcon className={cn("size-3", busy && "animate-pulse")} />
+      </TooltipTrigger>
+      <TooltipPopup side="top">Fork from this response</TooltipPopup>
+    </Tooltip>
+  );
+}
+
 function AssistantCopyButton({ row }: { row: Extract<TimelineRow, { kind: "message" }> }) {
   const assistantCopyState = resolveAssistantMessageCopyState({
     text: row.message.text ?? null,
@@ -1264,11 +1536,275 @@ function ProposedPlanTimelineRow({
   );
 }
 
-/**
- * Inline folded plan chip: one row per turn that produced plan/todo steps.
- * Collapsed by default, with a segment bar and the current step label,
- * and expands in place to the full step list. Replaces the old plan sidebar.
- */
+type V2EventTone = "muted" | "warning" | "danger" | "success";
+
+function v2EventPresentation(item: OrchestrationV2TurnItem): {
+  readonly label: string;
+  readonly detail: string | null;
+  readonly tone: V2EventTone;
+  readonly icon: LucideIcon;
+} {
+  switch (item.type) {
+    case "error": {
+      const presentation = providerErrorPresentation(item);
+      return {
+        ...presentation,
+        tone:
+          item.status === "completed"
+            ? "success"
+            : item.status === "running"
+              ? "warning"
+              : "danger",
+        icon: CircleAlertIcon,
+      };
+    }
+    case "run_interrupt_request":
+      return {
+        label: "Interrupt requested",
+        detail: item.message,
+        tone: "warning",
+        icon: CircleAlertIcon,
+      };
+    case "run_interrupt_result":
+      return {
+        label: "Run interrupted",
+        detail: item.message,
+        tone: "danger",
+        icon: XIcon,
+      };
+    case "handoff":
+      return {
+        label: "Context handoff",
+        detail:
+          item.summary ??
+          `${item.fromProviderInstanceIds.join(", ")} → ${item.toProviderInstanceId}`,
+        tone: item.status === "failed" ? "danger" : "muted",
+        icon: ZapIcon,
+      };
+    case "fork":
+      return {
+        label: "Conversation fork",
+        detail: `Continues in ${item.targetThreadId}`,
+        tone: "muted",
+        icon: GitForkIcon,
+      };
+    case "compaction": {
+      const tokenSummary =
+        item.beforeTokenCount === undefined && item.afterTokenCount === undefined
+          ? null
+          : `${item.beforeTokenCount ?? "?"} → ${item.afterTokenCount ?? "?"} tokens`;
+      return {
+        label: "Context compacted",
+        detail: item.summary ?? tokenSummary,
+        tone: item.status === "failed" ? "danger" : "muted",
+        icon: MinusIcon,
+      };
+    }
+    case "approval_request":
+      return {
+        label: "Approval requested",
+        detail: item.prompt ?? item.requestKind,
+        tone: item.status === "failed" ? "danger" : "warning",
+        icon: MessageCircleIcon,
+      };
+    case "user_input_request":
+      return {
+        label: "Input requested",
+        detail: item.questions.map((question) => question.question).join("\n"),
+        tone: item.status === "failed" ? "danger" : "warning",
+        icon: MessageCircleIcon,
+      };
+    case "todo_list": {
+      const steps = item.steps.map((step) => `${step.status}: ${step.text}`).join("\n");
+      return {
+        label: "Plan updated",
+        detail: [item.explanation, steps].filter(Boolean).join("\n\n") || null,
+        tone: item.status === "failed" ? "danger" : "success",
+        icon: CheckIcon,
+      };
+    }
+    default:
+      return {
+        label: item.title?.trim() || item.type.replaceAll("_", " "),
+        detail: null,
+        tone: item.status === "failed" ? "danger" : "muted",
+        icon: WrenchIcon,
+      };
+  }
+}
+
+function V2EventTimelineRow({ row }: { row: Extract<TimelineRow, { kind: "event" }> }) {
+  const ctx = use(TimelineRowCtx);
+  const { item, visibility, sourceThreadId } = row.projectedItem;
+  if (isV2LifecycleItem(item)) {
+    return (
+      <V2LifecycleRow
+        item={item}
+        createdAt={row.createdAt}
+        timestampFormat={ctx.timestampFormat}
+        providerStatuses={ctx.providerStatuses}
+        runs={ctx.runs}
+        onOpenThread={ctx.onOpenThread}
+      />
+    );
+  }
+  const presentation = v2EventPresentation(item);
+  const Icon = presentation.icon;
+  if (item.type === "error") {
+    return (
+      <details
+        className={cn(
+          "group rounded-md border",
+          presentation.tone === "warning" && "border-amber-500/25 bg-amber-500/5",
+          presentation.tone === "danger" && "border-destructive/25 bg-destructive/5",
+          presentation.tone === "success" && "border-emerald-500/20 bg-emerald-500/5",
+        )}
+        data-v2-item-type={item.type}
+        data-v2-item-visibility={visibility}
+        data-v2-event-disclosure="true"
+      >
+        <summary className="flex min-w-0 cursor-pointer list-none items-center gap-2 px-2.5 py-1.5 text-xs [&::-webkit-details-marker]:hidden">
+          <Icon
+            className={cn(
+              "size-3.5 shrink-0",
+              presentation.tone === "warning" && "text-amber-600 dark:text-amber-400",
+              presentation.tone === "danger" && "text-destructive",
+              presentation.tone === "success" && "text-emerald-600 dark:text-emerald-400",
+            )}
+          />
+          <span className="shrink-0 font-medium text-foreground/90">{presentation.label}</span>
+          {item.status !== "completed" ? (
+            <span
+              className={cn(
+                "shrink-0 rounded-full border px-1.5 py-0.5 font-mono text-[10px]",
+                item.status === "failed"
+                  ? "border-destructive/40 text-destructive"
+                  : "border-border/70 text-muted-foreground",
+              )}
+            >
+              {item.status}
+            </span>
+          ) : null}
+          {presentation.detail ? (
+            <span className="min-w-0 flex-1 truncate text-muted-foreground/65">
+              {presentation.detail}
+            </span>
+          ) : null}
+          {visibility !== "local" ? (
+            <span className="shrink-0 rounded-full bg-muted px-1.5 py-0.5 text-[10px] text-muted-foreground">
+              {visibility === "inherited" ? "Inherited" : "Synthetic"}
+            </span>
+          ) : null}
+          <ChevronDownIcon className="size-3 shrink-0 text-muted-foreground/60 transition-transform group-open:rotate-180" />
+        </summary>
+        <div className="border-t border-border/45 px-3 py-2 ps-8">
+          {presentation.detail ? (
+            <div className="text-xs leading-relaxed text-muted-foreground">
+              <ChatMarkdown
+                text={presentation.detail}
+                cwd={ctx.markdownCwd}
+                threadRef={ctx.threadRef ?? undefined}
+                skills={ctx.skills}
+                lineBreaks
+              />
+            </div>
+          ) : null}
+          {visibility === "inherited" ? (
+            <p className="mt-1 font-mono text-[10px] text-muted-foreground/65">
+              From {sourceThreadId}
+            </p>
+          ) : null}
+          <div className={presentation.detail ? "mt-2" : undefined}>
+            <V2ItemInspector
+              projectedItem={row.projectedItem}
+              environmentId={ctx.activeThreadEnvironmentId}
+              cwd={ctx.markdownCwd}
+              workspaceRoot={ctx.workspaceRoot}
+              onOpenThread={ctx.onOpenThread}
+              onOpenTurnDiff={ctx.onOpenTurnDiff}
+              onRollbackCheckpoint={ctx.onRollbackCheckpoint}
+            />
+          </div>
+        </div>
+      </details>
+    );
+  }
+  return (
+    <section
+      className={cn(
+        "rounded-lg border px-3 py-2",
+        presentation.tone === "warning" && "border-amber-500/25 bg-amber-500/5",
+        presentation.tone === "danger" && "border-destructive/25 bg-destructive/5",
+        presentation.tone === "success" && "border-emerald-500/20 bg-emerald-500/5",
+        presentation.tone === "muted" && "border-border/60 bg-card/30",
+      )}
+      data-v2-item-type={item.type}
+      data-v2-item-visibility={visibility}
+    >
+      <div className="flex items-start gap-2.5">
+        <Icon
+          className={cn(
+            "mt-0.5 size-3.5 shrink-0",
+            presentation.tone === "warning" && "text-amber-600 dark:text-amber-400",
+            presentation.tone === "danger" && "text-destructive",
+            presentation.tone === "success" && "text-emerald-600 dark:text-emerald-400",
+            presentation.tone === "muted" && "text-muted-foreground",
+          )}
+        />
+        <div className="min-w-0 flex-1">
+          <div className="flex flex-wrap items-center gap-x-2 gap-y-1">
+            <span className="text-xs font-medium text-foreground/90">{presentation.label}</span>
+            {item.status !== "completed" ? (
+              <span
+                className={cn(
+                  "rounded-full border px-1.5 py-0.5 font-mono text-[10px]",
+                  item.status === "failed"
+                    ? "border-destructive/40 text-destructive"
+                    : "border-border/70 text-muted-foreground",
+                )}
+              >
+                {item.status}
+              </span>
+            ) : null}
+            {visibility !== "local" ? (
+              <span className="rounded-full bg-muted px-1.5 py-0.5 text-[10px] text-muted-foreground">
+                {visibility === "inherited" ? "Inherited" : "Synthetic"}
+              </span>
+            ) : null}
+          </div>
+          {presentation.detail ? (
+            <div className="mt-1 text-xs leading-relaxed text-muted-foreground">
+              <ChatMarkdown
+                text={presentation.detail}
+                cwd={ctx.markdownCwd}
+                threadRef={ctx.threadRef ?? undefined}
+                skills={ctx.skills}
+                lineBreaks
+              />
+            </div>
+          ) : null}
+          {visibility === "inherited" ? (
+            <p className="mt-1 font-mono text-[10px] text-muted-foreground/65">
+              From {sourceThreadId}
+            </p>
+          ) : null}
+          <div className="mt-2">
+            <V2ItemInspector
+              projectedItem={row.projectedItem}
+              environmentId={ctx.activeThreadEnvironmentId}
+              cwd={ctx.markdownCwd}
+              workspaceRoot={ctx.workspaceRoot}
+              onOpenThread={ctx.onOpenThread}
+              onOpenTurnDiff={ctx.onOpenTurnDiff}
+              onRollbackCheckpoint={ctx.onRollbackCheckpoint}
+            />
+          </div>
+        </div>
+      </div>
+    </section>
+  );
+}
+
 const TurnPlanTimelineRow = memo(function TurnPlanTimelineRow({
   row,
 }: {
@@ -1346,7 +1882,11 @@ const TurnPlanTimelineRow = memo(function TurnPlanTimelineRow({
                 )}
                 aria-hidden
               >
-                {step.status === "completed" ? "✓" : step.status === "inProgress" ? "●" : "○"}
+                {step.status === "completed"
+                  ? "\u2713"
+                  : step.status === "inProgress"
+                    ? "\u25cf"
+                    : "\u25cb"}
               </span>
               <span
                 className={cn(
@@ -1373,7 +1913,7 @@ const TurnPlanTimelineRow = memo(function TurnPlanTimelineRow({
 // re-render only the affected row, not the entire list.
 // ---------------------------------------------------------------------------
 
-/** Renders one or more already-derived work log rows. Overflow expansion is modeled as LegendList data. */
+/** Renders one or more already-derived work log rows. Overflow expansion is modeled as list data. */
 const WorkGroupSection = memo(function WorkGroupSection({
   groupedEntries,
   isExpandedToolGroupEntry,
@@ -1566,7 +2106,7 @@ const AssistantChangedFilesSection = memo(function AssistantChangedFilesSection(
   turnSummary: TurnDiffSummary | undefined;
   routeThreadKey: string;
   resolvedTheme: "light" | "dark";
-  onOpenTurnDiff: (turnId: TurnId, filePath?: string) => void;
+  onOpenTurnDiff: (runId: RunId, filePath?: string) => void;
 }) {
   if (!turnSummary) return null;
   const checkpointFiles = turnSummary.files;
@@ -1596,30 +2136,28 @@ function AssistantChangedFilesSectionInner({
   checkpointFiles: TurnDiffSummary["files"];
   routeThreadKey: string;
   resolvedTheme: "light" | "dark";
-  onOpenTurnDiff: (turnId: TurnId, filePath?: string) => void;
+  onOpenTurnDiff: (runId: RunId, filePath?: string) => void;
 }) {
   const activity = use(TimelineRowActivityCtx);
-  const isLatestTurn = activity.latestTurnId === turnSummary.turnId;
+  const isLatestRun = activity.latestRunId === turnSummary.runId;
   const persistedExpanded = useUiStateStore(
-    (store) => store.threadChangedFilesExpandedById[routeThreadKey]?.[turnSummary.turnId],
+    (store) => store.threadChangedFilesExpandedById[routeThreadKey]?.[turnSummary.runId],
   );
   const setExpanded = useUiStateStore((store) => store.setThreadChangedFilesExpanded);
-  const [autoExpanded] = useState(() =>
-    shouldAutoExpandChangedFiles(checkpointFiles, isLatestTurn),
-  );
+  const [autoExpanded] = useState(() => shouldAutoExpandChangedFiles(checkpointFiles, isLatestRun));
   const [allDirectoriesExpanded, setAllDirectoriesExpanded] = useState(autoExpanded);
-  const expanded = persistedExpanded ?? (isLatestTurn && autoExpanded);
+  const expanded = persistedExpanded ?? (isLatestRun && autoExpanded);
 
   return (
     <ChangedFilesCard
-      turnId={turnSummary.turnId}
+      runId={turnSummary.runId}
       files={checkpointFiles}
       expanded={expanded}
-      showCompactPreview={isLatestTurn}
+      showCompactPreview={isLatestRun}
       allDirectoriesExpanded={allDirectoriesExpanded}
       resolvedTheme={resolvedTheme}
       onExpandedChange={(nextExpanded) =>
-        setExpanded(routeThreadKey, turnSummary.turnId, nextExpanded)
+        setExpanded(routeThreadKey, turnSummary.runId, nextExpanded)
       }
       onToggleAllDirectories={() => setAllDirectoriesExpanded((current) => !current)}
       onOpenTurnDiff={onOpenTurnDiff}
@@ -1652,7 +2190,7 @@ const UserMessageElementContextChip = memo(function UserMessageElementContextChi
     <Tooltip>
       <TooltipTrigger
         render={
-          <span className="inline-flex max-w-full items-center gap-1 rounded-md border border-border/70 bg-background/70 px-1.5 py-0.5 text-foreground/85 text-xs">
+          <span className="inline-flex max-w-full items-center gap-1 rounded-md border border-border/70 bg-background/70 px-1.5 py-0.5 text-xs text-foreground/85">
             <MousePointerClickIcon className="size-3 shrink-0" />
             <span className="truncate">{props.context.header}</span>
           </span>
@@ -1692,13 +2230,13 @@ function UserMessagePreviewAnnotationCard(props: {
       ) : null}
       <div className="min-w-0 px-2.5 py-2">
         {props.annotation.comment ? (
-          <div className="max-w-80 truncate text-foreground text-xs font-medium">
+          <div className="max-w-80 truncate text-xs font-medium text-foreground/90">
             {props.annotation.comment}
           </div>
         ) : null}
         <div
           className={cn(
-            "flex items-center gap-2 text-secondary-label text-[10px]",
+            "flex items-center gap-2 text-[10px] text-muted-foreground",
             props.annotation.comment && "mt-1",
           )}
         >
@@ -1787,7 +2325,7 @@ const CollapsibleUserMessageBody = memo(function CollapsibleUserMessageBody(prop
               aria-expanded={expanded}
               data-scroll-anchor-ignore
               onClick={() => setExpanded((value) => !value)}
-              className="-ml-1 h-6 rounded-md px-1.5 text-secondary-label text-xs hover:bg-muted/55 hover:text-message-foreground"
+              className="-ml-1 h-6 rounded-md px-1.5 text-xs text-muted-foreground/72 hover:bg-muted/55 hover:text-foreground/85"
             >
               {expanded ? "Show less" : "Show full message"}
             </Button>
@@ -1826,7 +2364,7 @@ const UserMessageBody = memo(function UserMessageBody(props: {
             cwd={props.markdownCwd}
             threadRef={ctx.threadRef ?? undefined}
             skills={props.skills}
-            className="text-message-foreground"
+            className="text-foreground"
             lineBreaks
             parseRawHtml={false}
           />
@@ -1839,7 +2377,7 @@ const UserMessageBody = memo(function UserMessageBody(props: {
   const reviewCommentSegments = parseReviewCommentMessageSegments(props.text);
   if (reviewCommentSegments.some((segment) => segment.kind === "review-comment")) {
     return (
-      <div className="space-y-3 text-message-foreground text-sm leading-relaxed">
+      <div className="space-y-3 text-sm leading-relaxed text-foreground">
         {reviewCommentSegments.map((segment) =>
           segment.kind === "text" ? (
             segment.text.trim().length > 0 ? (
@@ -1849,7 +2387,7 @@ const UserMessageBody = memo(function UserMessageBody(props: {
                   cwd={props.markdownCwd}
                   threadRef={ctx.threadRef ?? undefined}
                   skills={props.skills}
-                  className="text-message-foreground"
+                  className="text-foreground"
                   lineBreaks
                   parseRawHtml={false}
                 />
@@ -1909,7 +2447,7 @@ const UserMessageBody = memo(function UserMessageBody(props: {
         }
 
         return (
-          <div className="whitespace-pre-wrap wrap-break-word text-message-foreground text-sm leading-relaxed">
+          <div className="whitespace-pre-wrap wrap-break-word text-sm leading-relaxed text-foreground">
             {inlineNodes}
           </div>
         );
@@ -1938,7 +2476,7 @@ const UserMessageBody = memo(function UserMessageBody(props: {
           cwd={props.markdownCwd}
           threadRef={ctx.threadRef ?? undefined}
           skills={props.skills}
-          className="text-message-foreground"
+          className="text-foreground"
           lineBreaks
           parseRawHtml={false}
         />,
@@ -1948,7 +2486,7 @@ const UserMessageBody = memo(function UserMessageBody(props: {
     }
 
     return (
-      <div className="whitespace-pre-wrap wrap-break-word text-message-foreground text-sm leading-relaxed">
+      <div className="whitespace-pre-wrap wrap-break-word text-sm leading-relaxed text-foreground">
         {inlineNodes}
       </div>
     );
@@ -1964,7 +2502,7 @@ const UserMessageBody = memo(function UserMessageBody(props: {
       cwd={props.markdownCwd}
       threadRef={ctx.threadRef ?? undefined}
       skills={props.skills}
-      className="text-message-foreground"
+      className="text-foreground"
       lineBreaks
       parseRawHtml={false}
     />
@@ -1982,10 +2520,10 @@ function UserMessageReviewCommentCard({ comment }: { comment: ReviewCommentConte
   return (
     <div className="space-y-2 rounded-lg border border-border/70 bg-background/70 p-3">
       <div className="space-y-1">
-        <div className="text-message-foreground text-xs font-medium">
+        <div className="text-xs font-medium text-foreground">
           {formatWorkspaceRelativePath(comment.filePath, ctx.workspaceRoot)}
         </div>
-        <div className="text-secondary-label text-[11px]">
+        <div className="text-[11px] text-muted-foreground">
           {comment.sectionTitle} · {comment.rangeLabel}
         </div>
       </div>
@@ -2000,7 +2538,7 @@ function UserMessageReviewCommentCard({ comment }: { comment: ReviewCommentConte
           cwd={ctx.markdownCwd}
           threadRef={ctx.threadRef ?? undefined}
           skills={ctx.skills}
-          className="text-message-foreground"
+          className="text-foreground"
         />
       )}
       {renderablePatch?.kind === "files" &&
@@ -2029,6 +2567,38 @@ function UserMessageReviewCommentCard({ comment }: { comment: ReviewCommentConte
 // so LegendList (and React) can skip re-rendering unchanged items.
 // ---------------------------------------------------------------------------
 
+/** Content-stable projection of the runs the handoff rows read. The incoming
+ *  array is rebuilt on every projection event (status/timestamp churn), but
+ *  the returned reference only changes when a run's identity-relevant fields
+ *  (id, ordinal, instance, model) do — keeping TimelineRowCtx stable. */
+function useStableHandoffRuns(
+  runs: ReadonlyArray<HandoffTimelineRun>,
+): ReadonlyArray<HandoffTimelineRun> {
+  const prev = useRef<{
+    signature: string;
+    value: ReadonlyArray<HandoffTimelineRun>;
+  }>({ signature: "", value: EMPTY_TIMELINE_RUNS });
+  return useMemo(() => {
+    const signature = runs
+      .map(
+        (run) =>
+          `${run.id}\0${run.providerInstanceId}\0${run.ordinal}\0${run.modelSelection.instanceId}\0${run.modelSelection.model}`,
+      )
+      .join("\n");
+    if (signature === prev.current.signature) {
+      return prev.current.value;
+    }
+    const value = runs.map((run) => ({
+      id: run.id,
+      ordinal: run.ordinal,
+      providerInstanceId: run.providerInstanceId,
+      modelSelection: run.modelSelection,
+    }));
+    prev.current = { signature, value };
+    return value;
+  }, [runs]);
+}
+
 /** Returns a structurally-shared copy of `rows`: for each row whose content
  *  hasn't changed since last call, the previous object reference is reused. */
 function useStableRows(rows: MessagesTimelineRow[]): MessagesTimelineRow[] {
@@ -2077,10 +2647,10 @@ function WorkEntryIconSvg({ name, className }: { name: WorkEntryIconName; classN
       return <GlobeIcon className={className} aria-hidden />;
     case "hammer":
       return <HammerIcon className={className} aria-hidden />;
-    case "message-circle":
-      return <MessageCircleIcon className={className} aria-hidden />;
     case "search":
       return <SearchIcon className={className} aria-hidden />;
+    case "message-circle":
+      return <MessageCircleIcon className={className} aria-hidden />;
     case "square-pen":
       return <SquarePenIcon className={className} aria-hidden />;
     case "terminal":
@@ -2094,6 +2664,21 @@ function WorkEntryIconSvg({ name, className }: { name: WorkEntryIconName; classN
   }
 }
 
+function T3CodeToolLogo({ className }: { className?: string }) {
+  const logoUrl = `${import.meta.env.BASE_URL}apple-touch-icon.png`;
+  return (
+    <span
+      className={cn(
+        "flex size-4 shrink-0 items-center justify-center overflow-hidden rounded-[4px] bg-background ring-1 ring-border/65",
+        className,
+      )}
+      aria-label="T3 Code MCP tool"
+    >
+      <img alt="" aria-hidden="true" className="size-4 object-cover" src={logoUrl} />
+    </span>
+  );
+}
+
 function workToneIcon(tone: TimelineWorkEntry["tone"]): {
   iconName: WorkEntryIconName;
   className: string;
@@ -2101,24 +2686,24 @@ function workToneIcon(tone: TimelineWorkEntry["tone"]): {
   if (tone === "error") {
     return {
       iconName: "circle-alert",
-      className: "text-foreground",
+      className: "text-foreground/92",
     };
   }
   if (tone === "thinking") {
     return {
       iconName: "bot",
-      className: "text-foreground",
+      className: "text-foreground/92",
     };
   }
   if (tone === "info") {
     return {
       iconName: "check",
-      className: "text-icon-muted",
+      className: "text-muted-foreground",
     };
   }
   return {
     iconName: "zap",
-    className: "text-foreground",
+    className: "text-foreground/92",
   };
 }
 
@@ -2126,15 +2711,27 @@ function workEntryPreview(
   workEntry: Pick<TimelineWorkEntry, "detail" | "command" | "changedFiles">,
   workspaceRoot: string | undefined,
 ) {
+  // Collapsed rows show the tool's INPUT (command, touched files, search
+  // pattern); outputs like stdout and diffs stay behind the expander.
   if (workEntry.command) return workEntry.command;
-  if (workEntry.detail) return workEntry.detail;
-  if ((workEntry.changedFiles?.length ?? 0) === 0) return null;
   const [firstPath] = workEntry.changedFiles ?? [];
-  if (!firstPath) return null;
-  const displayPath = formatWorkspaceRelativePath(firstPath, workspaceRoot);
-  return workEntry.changedFiles!.length === 1
-    ? displayPath
-    : `${displayPath} +${workEntry.changedFiles!.length - 1} more`;
+  if (firstPath) {
+    const displayPath = formatWorkspaceRelativePath(firstPath, workspaceRoot);
+    return workEntry.changedFiles!.length === 1
+      ? displayPath
+      : `${displayPath} +${workEntry.changedFiles!.length - 1} more`;
+  }
+  if (workEntry.detail?.trim()) {
+    const lines = workEntry.detail
+      .trim()
+      .split(/\r?\n/)
+      .map((line) => line.trim())
+      .filter((line) => line.length > 0);
+    if (lines.length > 0) {
+      return lines.slice(0, 3).join(" · ");
+    }
+  }
+  return null;
 }
 
 function workEntryRawCommand(
@@ -2147,6 +2744,51 @@ function workEntryRawCommand(
   return rawCommand === workEntry.command.trim() ? null : rawCommand;
 }
 
+function buildToolCallExpandedBody(
+  workEntry: TimelineWorkEntry,
+  workspaceRoot: string | undefined,
+): string | null {
+  const blocks: string[] = [];
+  if (workEntry.itemType === "dynamic_tool" && workEntry.toolData !== undefined) {
+    blocks.push(`Tool call\n${JSON.stringify(workEntry.toolData, null, 2)}`);
+  }
+  const raw = workEntryRawCommand(workEntry);
+  if (raw?.trim()) {
+    blocks.push(raw.trim());
+  } else if (workEntry.command?.trim()) {
+    blocks.push(workEntry.command.trim());
+  }
+  if (workEntry.detail?.trim()) {
+    blocks.push(workEntry.detail.trim());
+  }
+  const changedFiles = workEntry.changedFiles ?? [];
+  if (changedFiles.length > 0) {
+    blocks.push(
+      changedFiles
+        .map((filePath) => formatWorkspaceRelativePath(filePath, workspaceRoot))
+        .join("\n"),
+    );
+  }
+  if (workEntry.structuredPayload !== undefined) {
+    const structured = JSON.stringify(workEntry.structuredPayload, null, 2);
+    if (structured && !blocks.includes(structured)) {
+      blocks.push(structured);
+    }
+  }
+  if (workEntry.projectedItem?.visibility !== undefined) {
+    const { visibility, sourceThreadId } = workEntry.projectedItem;
+    if (visibility !== "local") {
+      blocks.push(
+        `${visibility === "inherited" ? "Inherited" : "Synthetic"} from ${sourceThreadId}`,
+      );
+    }
+  }
+  return blocks.length > 0 ? blocks.join("\n\n") : null;
+}
+
+const toolCallExpandedBodyClassName =
+  "max-h-64 cursor-text overflow-auto whitespace-pre-wrap break-words font-mono text-secondary-label text-[length:var(--font-size-code,0.6875rem)] leading-relaxed select-text";
+
 type CommandWrapper = "env" | "sudo";
 
 const COMMAND_WRAPPER_OPTIONS_WITH_VALUE: Record<CommandWrapper, ReadonlySet<string>> = {
@@ -2323,8 +2965,8 @@ function liveWorkEntryLabel(
 ): string {
   const command = workEntry.command?.trim();
   if (command) {
-    // This row describes the active parent turn, not the command lifecycle.
-    // Keep its live "Running" copy until the turn or contiguous tool run settles.
+    // This row describes the active tool run, not the command lifecycle.
+    // Keep its live "Running" copy until the contiguous tool run settles.
     const program = commandProgramName(command);
     if (program) return `Running ${program}`;
     return "Running command";
@@ -2333,61 +2975,30 @@ function liveWorkEntryLabel(
   return workEntryPreview(workEntry, workspaceRoot) ?? toolWorkEntryHeading(workEntry);
 }
 
-function buildToolCallExpandedBody(
-  workEntry: TimelineWorkEntry,
-  workspaceRoot: string | undefined,
-): string | null {
-  const blocks: string[] = [];
-  if (workEntry.itemType === "mcp_tool_call" && workEntry.toolData !== undefined) {
-    blocks.push(`MCP call\n${JSON.stringify(workEntry.toolData, null, 2)}`);
-  }
-  const raw = workEntryRawCommand(workEntry);
-  if (raw?.trim()) {
-    blocks.push(raw.trim());
-  } else if (workEntry.command?.trim()) {
-    blocks.push(workEntry.command.trim());
-  }
-  if (workEntry.detail?.trim()) {
-    blocks.push(workEntry.detail.trim());
-  }
-  const changedFiles = workEntry.changedFiles ?? [];
-  if (changedFiles.length > 0) {
-    blocks.push(
-      changedFiles
-        .map((filePath) => formatWorkspaceRelativePath(filePath, workspaceRoot))
-        .join("\n"),
-    );
-  }
-  return blocks.length > 0 ? blocks.join("\n\n") : null;
-}
-
-const toolCallExpandedBodyClassName =
-  "max-h-64 cursor-text overflow-auto whitespace-pre-wrap break-words font-mono text-secondary-label text-[length:var(--font-size-code,0.6875rem)] leading-relaxed select-text";
-
 function workEntryIconName(workEntry: TimelineWorkEntry): WorkEntryIconName {
-  if (
-    workEntry.sourceActivityKind === "user-input.requested" ||
-    workEntry.sourceActivityKind === "user-input.resolved"
-  ) {
+  if (workEntry.itemType === "user_input_request") {
     return "message-circle";
   }
-  const action = toolGroupAction(workEntry);
-  if (action !== "other") return toolGroupSummaryIconName(action);
+  if (workEntry.requestKind === "command") return "terminal";
+  if (workEntry.requestKind === "file-read") return "eye";
+  if (workEntry.requestKind === "file-change") return "square-pen";
+
+  if (workEntry.itemType === "command_execution" || workEntry.command) {
+    return "terminal";
+  }
+  if (workEntry.itemType === "file_change" || (workEntry.changedFiles?.length ?? 0) > 0) {
+    return "square-pen";
+  }
+  if (workEntry.itemType === "web_search") return "globe";
+  if (workEntry.itemType === "file_search") return "eye";
 
   switch (workEntry.itemType) {
-    case "mcp_tool_call":
+    case "dynamic_tool":
       return "wrench";
-    case "dynamic_tool_call":
-      return "hammer";
-    case "collab_agent_tool_call":
+    case "subagent":
       return "bot";
   }
 
-  // Subagent lifecycle rows (grouped by taskId) get agent identity chrome.
-  if (workEntry.taskId) {
-    return "bot";
-  }
-
   return workToneIcon(workEntry.tone).iconName;
 }
 
@@ -2408,147 +3019,48 @@ function toolWorkEntryHeading(workEntry: TimelineWorkEntry): string {
 
 const stopRowToggle = (e: { stopPropagation: () => void }) => e.stopPropagation();
 
-/**
- * A1 spawn CTA: one anchored row per workflow run (or per-turn direct-spawn
- * batch). Live status is derived from the shared agent panel model at render
- * time — the row itself never re-renders a roster; the Agents panel is the
- * only roster. Freezes to past tense when every member settles. Static dot,
- * no animation.
- */
-const AgentSpawnCtaRow = memo(function AgentSpawnCtaRow(props: { workEntry: TimelineWorkEntry }) {
-  const { workEntry } = props;
-  const { agentPanelModel, onOpenAgents } = use(TimelineRowCtx);
-  const spawn = workEntry.agentSpawn;
-  if (!spawn) {
-    return null;
-  }
-
-  const memberIds = new Set(spawn.agentTaskIds);
-  const workflowGroup = spawn.workflowId
-    ? agentPanelModel.workflows.find((group) => group.workflow.id === spawn.workflowId)
-    : undefined;
-  const agents = workflowGroup
-    ? [...workflowGroup.phases.flatMap((phase) => phase.members), ...workflowGroup.unphasedMembers]
-    : agentPanelModel.directAgents.filter((agent) => memberIds.has(agent.id));
-  const agentCount = Math.max(
-    agents.length,
-    Math.max(memberIds.size - (spawn.workflowId ? 1 : 0), 0),
-  );
-
-  const running = agents.filter(
-    (agent) => agent.status === "running" || agent.status === "pending",
-  ).length;
-  const waiting = agents.filter((agent) => agent.status === "waiting").length;
-  const failed = agents.filter((agent) => agent.status === "failed").length;
-  // The coordinator's own status is authoritative for workflows: dynamic
-  // spawns mean the member list can be momentarily all-settled while the
-  // run is still mid-flight (the "completed" lie from live testing). A
-  // workflow is live until the coordinator itself reaches a terminal state.
-  const coordinatorStatus = workflowGroup?.workflow.status;
-  const coordinatorSettled =
-    coordinatorStatus === "completed" ||
-    coordinatorStatus === "failed" ||
-    coordinatorStatus === "cancelled" ||
-    coordinatorStatus === "interrupted";
-  const live = workflowGroup !== undefined ? !coordinatorSettled : running + waiting > 0;
-  // Same rule as the panel footer: providers may aggregate member usage into
-  // the coordinator, so count the coordinator only when no members exist.
-  const totalTokens = agents.reduce(
-    (sum, agent) => sum + (agent.usage?.totalTokens ?? 0),
-    spawn.workflowId && agents.length === 0 ? (workflowGroup?.workflow.usage?.totalTokens ?? 0) : 0,
-  );
-
-  const livePhase = workflowGroup?.phases.find((phase) => phase.state === "running");
-  const workflowName =
-    workflowGroup?.workflow.workflowName ?? workflowGroup?.workflow.title ?? null;
-
-  // One steady in-flight presentation (monitoring-pill rule): waiting and
-  // stalled agents read as working; only settled states differentiate.
-  const working = running + waiting;
-  const dotClass = live ? "bg-info" : failed > 0 ? "bg-destructive" : "bg-success";
-  const lead = live
-    ? `Kicked off ${agentCount} subagent${agentCount === 1 ? "" : "s"}`
-    : `Ran ${agentCount} subagent${agentCount === 1 ? "" : "s"}`;
-  const status = live
-    ? livePhase
-      ? `${livePhase.title} · ${livePhase.activeCount} working`
-      : working > 0
-        ? `${working} working`
-        : "working"
-    : failed > 0
-      ? `${failed} failed`
-      : "✓ completed";
-
-  return (
-    <button
-      type="button"
-      onClick={onOpenAgents}
-      className="flex w-full items-center gap-2 rounded-md border border-border/60 bg-card/50 px-2.5 py-1.5 text-left text-[13px] transition hover:bg-accent/50"
-    >
-      <span aria-hidden className={cn("size-1.5 shrink-0 rounded-full", dotClass)} />
-      <WorkEntryIconSvg name="bot" className="size-3.5 shrink-0 text-muted-foreground" />
-      <span className="min-w-0 truncate">
-        <span className="font-medium">{lead}</span>
-        {workflowName ? <span className="text-muted-foreground"> · {workflowName}</span> : null}
-      </span>
-      <span className="ml-auto flex shrink-0 items-center gap-2 font-mono text-[.7rem] text-muted-foreground">
-        <span>{status}</span>
-        {totalTokens > 0 ? (
-          <span className="tabular-nums">Σ {formatSubagentTokenCount(totalTokens)}</span>
-        ) : null}
-        <span className="text-info-foreground">{live ? "Open Agents ▸" : "View ▸"}</span>
-      </span>
-    </button>
-  );
-});
-
 const SimpleWorkEntryRow = memo(function SimpleWorkEntryRow(props: {
   workEntry: TimelineWorkEntry;
   workspaceRoot: string | undefined;
-  isExpandedToolGroupEntry: boolean;
-}) {
-  const { workEntry, workspaceRoot, isExpandedToolGroupEntry } = props;
-  // Before any hooks: spawn CTA rows render their own component.
-  if (workEntry.agentSpawn) {
-    return <AgentSpawnCtaRow workEntry={workEntry} />;
-  }
-  return (
-    <PlainWorkEntryRow
-      workEntry={workEntry}
-      workspaceRoot={workspaceRoot}
-      isExpandedToolGroupEntry={isExpandedToolGroupEntry}
-    />
-  );
-});
-
-const PlainWorkEntryRow = memo(function PlainWorkEntryRow(props: {
-  workEntry: TimelineWorkEntry;
-  workspaceRoot: string | undefined;
-  isExpandedToolGroupEntry: boolean;
+  isExpandedToolGroupEntry?: boolean;
 }) {
-  const { workEntry, workspaceRoot, isExpandedToolGroupEntry } = props;
+  const { workEntry, workspaceRoot, isExpandedToolGroupEntry = false } = props;
+  const activity = use(TimelineRowActivityCtx);
+  const ctx = use(TimelineRowCtx);
   const [expanded, setExpanded] = useState(false);
   const iconConfig = workToneIcon(workEntry.tone);
-  const showWarningIndicator = workEntry.sourceActivityKind === "runtime.warning";
-  const showFailedIndicator = workEntryDisplayIndicatesToolFailure(workEntry);
-  const entryIconName =
-    showWarningIndicator || showFailedIndicator ? "x" : workEntryIconName(workEntry);
-  const displayText = workEntryPreview(workEntry, workspaceRoot) ?? toolWorkEntryHeading(workEntry);
+  const showWarningIndicator = false;
+  const entryIconName = showWarningIndicator ? "x" : workEntryIconName(workEntry);
+  const toolPresentation = resolveTimelineToolPresentation(workEntry.toolTitle ?? workEntry.label);
+  // Command rows read as the command itself; stdout and the full payload
+  // stay behind the expander instead of leaking into the collapsed line.
+  const command = workEntry.command?.trim().replaceAll(/\s+/g, " ");
+  const heading = command || (toolPresentation?.displayName ?? toolWorkEntryHeading(workEntry));
+  const rawPreview = command ? null : workEntryPreview(workEntry, workspaceRoot);
+  const preview =
+    rawPreview &&
+    normalizeCompactToolLabel(rawPreview).toLowerCase() ===
+      normalizeCompactToolLabel(heading).toLowerCase()
+      ? null
+      : rawPreview;
+  const displayText = preview ? `${heading} - ${preview}` : heading;
   const expandedBody = buildToolCallExpandedBody(workEntry, workspaceRoot);
-  const canExpand = expandedBody !== null;
+  const canExpand = expandedBody !== null || workEntry.projectedItem !== undefined;
+  const showFailedIndicator = workEntryDisplayIndicatesToolFailure(workEntry);
+  const showEntryIcon = !isExpandedToolGroupEntry || showWarningIndicator || showFailedIndicator;
   const showDestructiveRowStyle =
     showFailedIndicator &&
     (workEntrySignalsSevereFailure(workEntry) || !workLogEntryIsToolLike(workEntry));
   // Ordinary tool failures stay muted; only runtime errors and warnings get
   // color. The red treatment is reserved for severe failures.
   const iconWrapperClass = cn(
-    "flex size-6 shrink-0 items-center justify-center",
+    "flex size-5 shrink-0 items-center justify-center",
     showWarningIndicator
       ? "text-warning"
       : showDestructiveRowStyle
         ? "text-destructive"
         : workEntry.tone === "tool" || showFailedIndicator
-          ? "text-icon-muted"
+          ? "text-muted-foreground/65"
           : iconConfig.className,
   );
   const headingClass = showWarningIndicator
@@ -2557,17 +3069,17 @@ const PlainWorkEntryRow = memo(function PlainWorkEntryRow(props: {
       ? "font-medium text-destructive"
       : workLogEntryIsToolLike(workEntry)
         ? "text-secondary-label"
-        : "text-foreground/80";
-  const showEntryIcon = !isExpandedToolGroupEntry || showWarningIndicator || showFailedIndicator;
-  const accessibleDisplayText = showFailedIndicator
-    ? `${displayText}, tool call failed`
-    : displayText;
+        : "font-medium text-foreground/82";
+  const turnSettled = !activity.activeTurnInProgress;
+  const showNeutralIndicator = !turnSettled && workEntryIndicatesToolNeutralStatus(workEntry);
+  const showSuccessIndicator =
+    workEntryIndicatesToolSuccess(workEntry) ||
+    (turnSettled && workEntryIndicatesToolNeutralStatus(workEntry));
   const rowToggleProps = canExpand
     ? {
         role: "button" as const,
         tabIndex: 0 as const,
-        "aria-label": accessibleDisplayText,
-        "aria-expanded": expanded,
+        "aria-label": displayText,
         onClick: () => setExpanded((v) => !v),
         onKeyDown: (e: KeyboardEvent<HTMLDivElement>) => {
           if (e.key === "Enter" || e.key === " ") {
@@ -2586,49 +3098,124 @@ const PlainWorkEntryRow = memo(function PlainWorkEntryRow(props: {
         canExpand &&
           "cursor-pointer hover:bg-accent/20 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-ring/70",
       )}
+      data-tool-logo={toolPresentation?.logo}
+      data-v2-item-type={workEntry.projectedItem?.item.type}
+      data-v2-item-visibility={workEntry.projectedItem?.visibility}
       {...rowToggleProps}
     >
       <div className="flex select-none items-center gap-1.5 transition-[opacity,translate] duration-200">
         <span
           className={cn(iconWrapperClass, !showEntryIcon && "invisible")}
-          role={showFailedIndicator ? "img" : undefined}
-          aria-label={showFailedIndicator ? "Tool call failed" : undefined}
           aria-hidden={!showEntryIcon}
         >
-          <WorkEntryIconSvg
-            name={entryIconName}
-            className="block size-4 shrink-0 stroke-[1.8] opacity-70"
-          />
+          {toolPresentation?.logo === "t3-code" ? (
+            <T3CodeToolLogo />
+          ) : (
+            <WorkEntryIconSvg
+              name={entryIconName}
+              className="block size-3.5 shrink-0 stroke-[1.8] opacity-80"
+            />
+          )}
         </span>
         <div className="flex min-w-0 flex-1 items-center gap-1.5">
           <div className="min-w-0 flex-1 overflow-hidden">
-            <p className="flex min-w-0 w-full items-baseline gap-1.5 text-sm leading-relaxed">
-              <span className={cn("min-w-0 flex-1 truncate", headingClass)}>{displayText}</span>
+            <p className="flex min-w-0 w-full items-baseline gap-1.5 text-[12px] leading-5">
+              <span className={cn("min-w-0 shrink truncate", headingClass)}>{heading}</span>
+              {workEntry.projectedItem?.visibility !== undefined &&
+              workEntry.projectedItem.visibility !== "local" ? (
+                <span className="shrink-0 rounded-full bg-muted px-1.5 py-0.5 text-[9px] leading-none text-muted-foreground">
+                  {workEntry.projectedItem.visibility === "inherited" ? "Inherited" : "Synthetic"}
+                </span>
+              ) : null}
+              {preview && (
+                <span className="min-w-0 flex-1 truncate text-muted-foreground/55">{preview}</span>
+              )}
             </p>
           </div>
-          <span
-            className={cn(
-              "flex size-4 shrink-0 items-center justify-center",
-              !canExpand && "invisible",
-            )}
-            aria-hidden
-          >
-            <ChevronDownIcon
-              className={cn(
-                "size-3 shrink-0 text-icon-muted opacity-70 transition-transform duration-200",
-                expanded && "rotate-180",
-              )}
-            />
-          </span>
+          <div className="flex shrink-0 items-center gap-px text-muted-foreground/55">
+            <span
+              className="flex size-4 shrink-0 items-center justify-center"
+              aria-hidden={!canExpand}
+            >
+              {canExpand ? (
+                <ChevronDownIcon
+                  className={cn(
+                    "size-3 shrink-0 opacity-70 transition-transform duration-200",
+                    expanded && "rotate-180",
+                  )}
+                  aria-hidden
+                />
+              ) : null}
+            </span>
+            <span className="flex size-4 shrink-0 items-center justify-center">
+              {showFailedIndicator ? (
+                <Tooltip>
+                  <TooltipTrigger
+                    render={
+                      <span
+                        className="flex size-4 items-center justify-center"
+                        aria-label="Tool call failed"
+                      />
+                    }
+                  >
+                    <XIcon
+                      className={cn(
+                        "block size-3 shrink-0",
+                        showDestructiveRowStyle ? "text-destructive" : "text-muted-foreground/70",
+                      )}
+                      aria-hidden
+                    />
+                  </TooltipTrigger>
+                  <TooltipPopup>Failed</TooltipPopup>
+                </Tooltip>
+              ) : showSuccessIndicator ? (
+                <Tooltip>
+                  <TooltipTrigger
+                    render={<span className="flex size-4 items-center justify-center" />}
+                  >
+                    <span className="inline-flex size-4 items-center justify-center">
+                      <CheckIcon
+                        className="block size-3 shrink-0 stroke-current"
+                        stroke="currentColor"
+                        aria-hidden
+                      />
+                    </span>
+                  </TooltipTrigger>
+                  <TooltipPopup>Completed</TooltipPopup>
+                </Tooltip>
+              ) : showNeutralIndicator ? (
+                <Tooltip>
+                  <TooltipTrigger
+                    render={<span className="flex size-4 items-center justify-center" />}
+                  >
+                    <MinusIcon className="block size-3 shrink-0 opacity-70" aria-hidden />
+                  </TooltipTrigger>
+                  <TooltipPopup>Empty</TooltipPopup>
+                </Tooltip>
+              ) : null}
+            </span>
+          </div>
         </div>
       </div>
-      {expanded && canExpand && expandedBody ? (
+      {expanded && canExpand ? (
         <div
           className="mt-1 ms-7 cursor-default border-s border-border/45 ps-3 pt-0.5"
           onClick={stopRowToggle}
           onPointerDown={stopRowToggle}
         >
-          <pre className={toolCallExpandedBodyClassName}>{expandedBody}</pre>
+          {workEntry.projectedItem ? (
+            <V2ItemInspector
+              projectedItem={workEntry.projectedItem}
+              environmentId={ctx.activeThreadEnvironmentId}
+              cwd={ctx.markdownCwd}
+              workspaceRoot={workspaceRoot}
+              onOpenThread={ctx.onOpenThread}
+              onOpenTurnDiff={ctx.onOpenTurnDiff}
+              onRollbackCheckpoint={ctx.onRollbackCheckpoint}
+            />
+          ) : expandedBody ? (
+            <pre className={toolCallExpandedBodyClassName}>{expandedBody}</pre>
+          ) : null}
         </div>
       ) : null}
     </div>
diff --git a/apps/web/src/components/chat/OpenInPicker.logic.ts b/apps/web/src/components/chat/OpenInPicker.logic.ts
new file mode 100644
index 000000000000..4d89eafb1d76
--- /dev/null
+++ b/apps/web/src/components/chat/OpenInPicker.logic.ts
@@ -0,0 +1,22 @@
+import type { EnvironmentId } from "@t3tools/contracts";
+
+import type { RemoteOpenMode } from "../../remoteOpen";
+
+export function shouldShowOpenInPicker(input: {
+  readonly activeProjectName: string | undefined;
+  readonly activeThreadEnvironmentId: EnvironmentId;
+  readonly primaryEnvironmentId: EnvironmentId | null;
+  readonly remoteOpenMode: RemoteOpenMode;
+}): boolean {
+  if (!input.activeProjectName) return false;
+  if (
+    input.primaryEnvironmentId !== null &&
+    input.activeThreadEnvironmentId === input.primaryEnvironmentId
+  ) {
+    return true;
+  }
+  // Remote environments get the picker in deep-link mode (or its explicit
+  // "no SSH route" state). Non-primary local backends (e.g. WSL) keep it
+  // hidden, matching pre-remote behavior.
+  return input.remoteOpenMode !== "local-exec";
+}
diff --git a/apps/web/src/components/chat/ChatHeader.test.ts b/apps/web/src/components/chat/OpenInPicker.test.ts
similarity index 73%
rename from apps/web/src/components/chat/ChatHeader.test.ts
rename to apps/web/src/components/chat/OpenInPicker.test.ts
index a200a2069240..96c9795bd5a9 100644
--- a/apps/web/src/components/chat/ChatHeader.test.ts
+++ b/apps/web/src/components/chat/OpenInPicker.test.ts
@@ -1,7 +1,7 @@
 import { EnvironmentId } from "@t3tools/contracts";
 import { describe, expect, it } from "vite-plus/test";
 
-import { resolveRenameCommit, shouldShowOpenInPicker } from "./ChatHeader";
+import { shouldShowOpenInPicker } from "./OpenInPicker.logic";
 
 describe("shouldShowOpenInPicker", () => {
   const primaryEnvironmentId = EnvironmentId.make("environment-primary");
@@ -61,24 +61,3 @@ describe("shouldShowOpenInPicker", () => {
     ).toBe(false);
   });
 });
-
-describe("resolveRenameCommit", () => {
-  it("commits a trimmed changed title", () => {
-    expect(resolveRenameCommit({ title: "  New title ", originalTitle: "Old" })).toEqual({
-      action: "commit",
-      title: "New title",
-    });
-  });
-
-  it("rejects empty and whitespace-only titles", () => {
-    expect(resolveRenameCommit({ title: "   ", originalTitle: "Old" })).toEqual({
-      action: "reject-empty",
-    });
-  });
-
-  it("no-ops when the trimmed title is unchanged", () => {
-    expect(resolveRenameCommit({ title: " Old ", originalTitle: "Old" })).toEqual({
-      action: "noop",
-    });
-  });
-});
diff --git a/apps/web/src/components/chat/OpenInPicker.tsx b/apps/web/src/components/chat/OpenInPicker.tsx
index b9bf831c14d9..4168e80a378f 100644
--- a/apps/web/src/components/chat/OpenInPicker.tsx
+++ b/apps/web/src/components/chat/OpenInPicker.tsx
@@ -4,7 +4,7 @@ import {
   type EnvironmentId,
   type ResolvedKeybindingsConfig,
 } from "@t3tools/contracts";
-import { memo, useCallback, useEffect, useMemo } from "react";
+import { memo, useCallback, useEffect, useMemo, useRef } from "react";
 import { isOpenFavoriteEditorShortcut, shortcutLabelForCommand } from "../../keybindings";
 import { usePreferredEditor } from "../../editorPreferences";
 import { editorLabelForPlatform } from "../../editorLabels";
@@ -47,6 +47,15 @@ import {
 import { cn } from "~/lib/utils";
 import { shellEnvironment } from "~/state/shell";
 import { useAtomCommand } from "~/state/use-atom-command";
+import {
+  THREAD_DETAILS_PANEL_CHEVRON_CLASS,
+  THREAD_DETAILS_PANEL_ICON_CLASS,
+  THREAD_DETAILS_PANEL_ROW_POPUP_CLASS,
+  THREAD_DETAILS_PANEL_SPLIT_GROUP_CLASS,
+  THREAD_DETAILS_PANEL_SPLIT_PRIMARY_CLASS,
+  THREAD_DETAILS_PANEL_SPLIT_SECONDARY_CLASS,
+  THREAD_DETAILS_PANEL_SPLIT_SEPARATOR_CLASS,
+} from "./threadDetailsPanelStyles";
 
 type OpenInOption = {
   label: string;
@@ -180,6 +189,7 @@ export const OpenInPicker = memo(function OpenInPicker({
   openInCwd,
   compact = false,
   enableShortcut = true,
+  displayMode = "toolbar",
 }: {
   environmentId: EnvironmentId;
   keybindings: ResolvedKeybindingsConfig;
@@ -187,7 +197,11 @@ export const OpenInPicker = memo(function OpenInPicker({
   openInCwd: string | null;
   compact?: boolean;
   enableShortcut?: boolean;
+  displayMode?: "toolbar" | "panel";
 }) {
+  const isPanel = displayMode === "panel";
+  const ActionGroup = isPanel ? "div" : Group;
+  const panelAnchorRef = useRef<HTMLDivElement | null>(null);
   const openInEditorMutation = useAtomCommand(shellEnvironment.openInEditor, "open in editor");
   const remote = useRemoteOpenState(environmentId);
   const remoteCapableEditors = useRemoteCapableEditors();
@@ -264,47 +278,70 @@ export const OpenInPicker = memo(function OpenInPicker({
     window.addEventListener("keydown", handler);
     return () => window.removeEventListener("keydown", handler);
   }, [enableShortcut, keybindings, openInCwd, openInEditor, preferredEditor]);
+  const primaryLabel = isPanel ? `Open in ${primaryOption?.label ?? "editor"}` : "Open";
 
   return (
-    <Group aria-label="Open in editor">
+    <ActionGroup
+      aria-label="Open in editor"
+      role="group"
+      {...(isPanel
+        ? { className: THREAD_DETAILS_PANEL_SPLIT_GROUP_CLASS, ref: panelAnchorRef }
+        : {})}
+    >
       <Button
-        aria-label={compact ? "Open file in preferred editor" : undefined}
-        className="ps-[8.5px]"
-        size="xs"
-        variant="outline"
+        aria-label={compact ? "Open file in preferred editor" : primaryLabel}
+        size={isPanel ? "sm" : "xs"}
+        variant={isPanel ? "ghost" : "outline"}
+        className={isPanel ? THREAD_DETAILS_PANEL_SPLIT_PRIMARY_CLASS : "ps-[8.5px]"}
         disabled={!preferredEditor || !openInCwd || remote.mode === "remote-unavailable"}
         onClick={() => openInEditor(preferredEditor)}
       >
         {primaryOption?.Icon && (
           <primaryOption.Icon
             aria-hidden="true"
-            className={cn("size-3.5", getOpenInIconClass(primaryOption.kind))}
+            className={cn(
+              isPanel ? THREAD_DETAILS_PANEL_ICON_CLASS : "size-3.5",
+              getOpenInIconClass(primaryOption.kind),
+            )}
           />
         )}
         <span
-          className={
+          className={cn(
             compact
               ? "sr-only"
-              : "sr-only @3xl/header-actions:not-sr-only @3xl/header-actions:ml-0.5"
-          }
+              : "sr-only @3xl/header-actions:not-sr-only @3xl/header-actions:ml-0.5",
+            isPanel && "not-sr-only ml-0.5 min-w-0 truncate",
+          )}
         >
-          Open
+          {primaryLabel}
         </span>
       </Button>
-      <GroupSeparator {...(!compact ? { className: "hidden @3xl/header-actions:block" } : {})} />
+      {isPanel ? (
+        <span aria-hidden="true" className={THREAD_DETAILS_PANEL_SPLIT_SEPARATOR_CLASS} />
+      ) : (
+        <GroupSeparator {...(!compact ? { className: "hidden @3xl/header-actions:block" } : {})} />
+      )}
       <Menu>
         <MenuTrigger
           render={
             <Button
-              aria-label={compact ? "Choose editor" : "Copy options"}
-              size="icon-xs"
-              variant="outline"
+              aria-label="Choose editor"
+              size={isPanel ? "sm" : "icon-xs"}
+              variant={isPanel ? "ghost" : "outline"}
+              className={isPanel ? THREAD_DETAILS_PANEL_SPLIT_SECONDARY_CLASS : undefined}
             />
           }
         >
-          <ChevronDownIcon aria-hidden="true" className="size-4" />
+          <ChevronDownIcon
+            aria-hidden="true"
+            className={isPanel ? THREAD_DETAILS_PANEL_CHEVRON_CLASS : "size-4"}
+          />
         </MenuTrigger>
-        <MenuPopup align="end">
+        <MenuPopup
+          align="end"
+          {...(isPanel ? { anchor: panelAnchorRef } : {})}
+          className={isPanel ? THREAD_DETAILS_PANEL_ROW_POPUP_CLASS : undefined}
+        >
           {remote.mode === "remote-unavailable" ? (
             <MenuItem disabled>No SSH route to {environmentLabel}</MenuItem>
           ) : (
@@ -326,6 +363,6 @@ export const OpenInPicker = memo(function OpenInPicker({
           )}
         </MenuPopup>
       </Menu>
-    </Group>
+    </ActionGroup>
   );
 });
diff --git a/apps/web/src/components/chat/OpenInPickerShortcut.ts b/apps/web/src/components/chat/OpenInPickerShortcut.ts
new file mode 100644
index 000000000000..91102b40c509
--- /dev/null
+++ b/apps/web/src/components/chat/OpenInPickerShortcut.ts
@@ -0,0 +1,43 @@
+import type { EditorId, EnvironmentId, ResolvedKeybindingsConfig } from "@t3tools/contracts";
+import { useEffect } from "react";
+
+import { usePreferredEditor } from "../../editorPreferences";
+import { isOpenFavoriteEditorShortcut } from "../../keybindings";
+import { shellEnvironment } from "../../state/shell";
+import { useAtomCommand } from "../../state/use-atom-command";
+
+export function useOpenFavoriteEditorShortcut({
+  enabled,
+  environmentId,
+  keybindings,
+  availableEditors,
+  openInCwd,
+}: {
+  enabled: boolean;
+  environmentId: EnvironmentId;
+  keybindings: ResolvedKeybindingsConfig;
+  availableEditors: ReadonlyArray<EditorId>;
+  openInCwd: string | null;
+}) {
+  const openInEditorMutation = useAtomCommand(shellEnvironment.openInEditor, "open in editor");
+  const [preferredEditor] = usePreferredEditor(availableEditors);
+
+  useEffect(() => {
+    if (!enabled) return;
+    const handler = (event: globalThis.KeyboardEvent) => {
+      if (!isOpenFavoriteEditorShortcut(event, keybindings)) return;
+      if (!openInCwd || !preferredEditor) return;
+
+      event.preventDefault();
+      void openInEditorMutation({
+        environmentId,
+        input: {
+          cwd: openInCwd,
+          editor: preferredEditor,
+        },
+      });
+    };
+    window.addEventListener("keydown", handler);
+    return () => window.removeEventListener("keydown", handler);
+  }, [enabled, environmentId, keybindings, openInCwd, openInEditorMutation, preferredEditor]);
+}
diff --git a/apps/web/src/components/chat/PanelLayoutControls.test.tsx b/apps/web/src/components/chat/PanelLayoutControls.test.tsx
index 51ae1a73ad0f..f5fc00a7d4c5 100644
--- a/apps/web/src/components/chat/PanelLayoutControls.test.tsx
+++ b/apps/web/src/components/chat/PanelLayoutControls.test.tsx
@@ -14,6 +14,12 @@ describe("PanelLayoutControls", () => {
         rightPanelAvailable={false}
         rightPanelOpen={false}
         rightPanelShortcutLabel={null}
+        showThreadPanelControl={false}
+        threadPanelOpen={false}
+        threadPanelPresentation="inline"
+        threadPanelShortcutLabel={null}
+        threadPanelHasAttention={false}
+        onToggleThreadPanel={() => {}}
         liveAgentCount={0}
         onToggleTerminal={() => {}}
         onToggleRightPanel={() => {}}
diff --git a/apps/web/src/components/chat/PanelLayoutControls.tsx b/apps/web/src/components/chat/PanelLayoutControls.tsx
index 8e8e640ee83e..4c2608679e79 100644
--- a/apps/web/src/components/chat/PanelLayoutControls.tsx
+++ b/apps/web/src/components/chat/PanelLayoutControls.tsx
@@ -1,14 +1,30 @@
-import { Maximize2Icon, Minimize2Icon, PanelBottomIcon, PanelRightIcon } from "lucide-react";
-import { memo } from "react";
+import {
+  ListFilterIcon,
+  Maximize2Icon,
+  Minimize2Icon,
+  PanelBottomIcon,
+  PanelRightIcon,
+} from "lucide-react";
+import { memo, type ReactElement, type ReactNode, type RefObject } from "react";
 
+import type { ThreadPanelPresentation } from "../../rightPanelLayout";
+import { Popover, PopoverPopup, PopoverTrigger } from "../ui/popover";
 import { Toggle } from "../ui/toggle";
 import { Tooltip, TooltipPopup, TooltipTrigger } from "../ui/tooltip";
 
-interface PanelLayoutControlsProps {
+export interface PanelLayoutControlsProps {
+  showThreadPanelControl?: boolean;
   showTerminalControl?: boolean;
+  showRightPanelControl?: boolean;
   terminalAvailable: boolean;
   terminalOpen: boolean;
   terminalShortcutLabel: string | null;
+  threadPanelOpen: boolean;
+  threadPanelPresentation: ThreadPanelPresentation;
+  threadPanelPopoverAnchor?: RefObject<Element | null>;
+  threadPanelPopoverContent?: ReactNode;
+  threadPanelShortcutLabel: string | null;
+  threadPanelHasAttention: boolean;
   rightPanelAvailable: boolean;
   rightPanelOpen: boolean;
   rightPanelShortcutLabel: string | null;
@@ -16,27 +32,94 @@ interface PanelLayoutControlsProps {
   /** Running + waiting subagents in this thread; badges the right panel toggle. */
   liveAgentCount: number;
   onToggleTerminal: () => void;
+  onToggleThreadPanel: () => void;
   onToggleRightPanel: () => void;
 }
 
 export const PanelLayoutControls = memo(function PanelLayoutControls({
+  showThreadPanelControl = true,
   showTerminalControl = true,
+  showRightPanelControl = true,
   terminalAvailable,
   terminalOpen,
   terminalShortcutLabel,
+  threadPanelOpen,
+  threadPanelPresentation,
+  threadPanelPopoverAnchor,
+  threadPanelPopoverContent,
+  threadPanelShortcutLabel,
+  threadPanelHasAttention,
   rightPanelAvailable,
   rightPanelOpen,
   rightPanelShortcutLabel,
   rightPanelUnavailableLabel = "Right panel is unavailable",
   liveAgentCount,
   onToggleTerminal,
+  onToggleThreadPanel,
   onToggleRightPanel,
 }: PanelLayoutControlsProps) {
+  const threadPanelToggle = (
+    <Toggle
+      className="relative shrink-0 [-webkit-app-region:no-drag]"
+      pressed={threadPanelOpen}
+      aria-label="Toggle thread details panel"
+      variant="ghost"
+      size="sm"
+    >
+      <ListFilterIcon className="size-4" />
+      {threadPanelHasAttention ? (
+        <span
+          className="absolute right-1 top-1 size-1.5 rounded-full bg-warning ring-2 ring-background"
+          aria-hidden="true"
+        />
+      ) : null}
+    </Toggle>
+  );
+  const threadPanelTooltip = (trigger: ReactElement) => (
+    <Tooltip>
+      <TooltipTrigger
+        render={trigger}
+        {...(threadPanelPresentation === "popover" ? {} : { onClick: onToggleThreadPanel })}
+      />
+      <TooltipPopup side="bottom">
+        Toggle thread details
+        {threadPanelShortcutLabel ? ` (${threadPanelShortcutLabel})` : ""}
+      </TooltipPopup>
+    </Tooltip>
+  );
+
   return (
     <div
       className="flex h-full shrink-0 items-center gap-1 [-webkit-app-region:no-drag]"
       data-panel-layout-controls
     >
+      {showThreadPanelControl ? (
+        threadPanelPresentation === "popover" ? (
+          <Popover
+            open={threadPanelOpen}
+            onOpenChange={(open) => {
+              if (open !== threadPanelOpen) onToggleThreadPanel();
+            }}
+          >
+            {threadPanelTooltip(<PopoverTrigger render={threadPanelToggle} />)}
+            <PopoverPopup
+              anchor={threadPanelPopoverAnchor}
+              align="end"
+              alignOffset={0}
+              collisionAvoidance={{ side: "shift", align: "shift", fallbackAxisSide: "none" }}
+              side="bottom"
+              sideOffset={0}
+              positionerClassName="w-[min(var(--thread-details-panel-width),var(--anchor-width))] !transition-none"
+              className="w-full !overflow-visible !rounded-none !border-0 !bg-transparent !shadow-none before:hidden! [--viewport-inline-padding:0] [-webkit-backdrop-filter:none]! [backdrop-filter:none]!"
+              viewportClassName="!overflow-visible p-2"
+            >
+              {threadPanelPopoverContent}
+            </PopoverPopup>
+          </Popover>
+        ) : (
+          threadPanelTooltip(threadPanelToggle)
+        )
+      ) : null}
       {showTerminalControl ? (
         <Tooltip>
           <TooltipTrigger render={<span className="flex shrink-0" />}>
diff --git a/apps/web/src/components/chat/ProposedPlanCard.tsx b/apps/web/src/components/chat/ProposedPlanCard.tsx
index 9746857a8cac..8da45a9e0c4c 100644
--- a/apps/web/src/components/chat/ProposedPlanCard.tsx
+++ b/apps/web/src/components/chat/ProposedPlanCard.tsx
@@ -175,6 +175,7 @@ export const ProposedPlanCard = memo(function ProposedPlanCard({
             <ChatMarkdown
               text={collapsedPreview ?? ""}
               cwd={cwd}
+              environmentId={environmentId}
               threadRef={threadRef}
               isStreaming={false}
             />
@@ -182,6 +183,7 @@ export const ProposedPlanCard = memo(function ProposedPlanCard({
             <ChatMarkdown
               text={displayedPlanMarkdown}
               cwd={cwd}
+              environmentId={environmentId}
               threadRef={threadRef}
               isStreaming={false}
             />
diff --git a/apps/web/src/components/chat/QueuedRunsControl.test.tsx b/apps/web/src/components/chat/QueuedRunsControl.test.tsx
new file mode 100644
index 000000000000..5aa400bb00a7
--- /dev/null
+++ b/apps/web/src/components/chat/QueuedRunsControl.test.tsx
@@ -0,0 +1,171 @@
+import { renderToStaticMarkup } from "react-dom/server";
+import { describe, expect, it, vi } from "vite-plus/test";
+
+const state = vi.hoisted(() => ({
+  projection: null as unknown,
+  workflow: null as unknown,
+}));
+
+vi.mock("@t3tools/client-runtime/environment", () => ({
+  scopeThreadRef: () => ({}) as never,
+}));
+
+vi.mock("@t3tools/client-runtime/state/thread-workflows", () => ({
+  deriveThreadQueueWorkflowState: () => state.workflow,
+}));
+
+vi.mock("../../state/entities", () => ({
+  useThreadProjection: () => state.projection,
+}));
+
+vi.mock("../../state/threads", () => ({
+  threadEnvironment: {
+    cancelQueuedRun: Symbol("cancelQueuedRun"),
+    promoteQueuedRun: Symbol("promoteQueuedRun"),
+    reorderQueuedRun: Symbol("reorderQueuedRun"),
+  },
+}));
+
+vi.mock("../../state/use-atom-command", () => ({
+  useAtomCommand: () => async () => undefined,
+}));
+
+vi.mock("../../assets/assetUrls", () => ({
+  useAssetUrls: (_environmentId: never, resources: ReadonlyArray<{ attachmentId: string }>) =>
+    resources.map((resource) => `https://assets.test/${resource.attachmentId}`),
+}));
+
+import { QueuedRunsControl } from "./QueuedRunsControl";
+
+describe("QueuedRunsControl automatic completion delivery", () => {
+  it("does not render a queue control when only hidden delivery remains", () => {
+    state.projection = {
+      projection: {
+        messages: [
+          {
+            delegatedCompletion: {
+              parentRunId: "run:parent",
+              generation: 1,
+              taskIds: ["task:child"],
+            },
+            id: "message:completion",
+          },
+        ],
+      },
+    };
+    state.workflow = {
+      activeRun: { id: "run:active" },
+      canPromoteToSteer: true,
+      canReorder: true,
+      queuedRuns: [],
+    };
+
+    const html = renderToStaticMarkup(
+      <QueuedRunsControl
+        environmentId={"environment:test" as never}
+        optimisticMessages={[]}
+        threadId={"thread:test" as never}
+        editingRunId={null}
+        onEditQueuedRun={() => undefined}
+        onCancelEdit={() => undefined}
+      />,
+    );
+
+    expect(html).toBe("");
+  });
+});
+
+describe("QueuedRunsControl attachments and edit mode", () => {
+  const workflowWithAttachment = () => ({
+    activeRun: { id: "run:active" },
+    canPromoteToSteer: true,
+    canReorder: true,
+    queuedRuns: [
+      {
+        run: { id: "run:queued", userMessageId: "message:queued" },
+        text: "Queued with a screenshot",
+        attachments: [
+          {
+            type: "image",
+            id: "attachment-1",
+            name: "screenshot.png",
+            mimeType: "image/png",
+            sizeBytes: 128,
+          },
+        ],
+      },
+    ],
+  });
+
+  it("renders an attachment thumbnail on the queued row", () => {
+    state.projection = { projection: { messages: [] } };
+    state.workflow = workflowWithAttachment();
+
+    const html = renderToStaticMarkup(
+      <QueuedRunsControl
+        environmentId={"environment:test" as never}
+        optimisticMessages={[]}
+        threadId={"thread:test" as never}
+        editingRunId={null}
+        onEditQueuedRun={() => undefined}
+        onCancelEdit={() => undefined}
+      />,
+    );
+
+    expect(html).toContain("https://assets.test/attachment-1");
+    expect(html).toContain("Queued with a screenshot");
+    expect(html).toContain("Edit queued message");
+    expect(html).toContain("Reorder queued message");
+    expect(html).not.toContain("Move queued message up");
+  });
+
+  it("drops the optimistic pending row once the projection holds its message", () => {
+    state.projection = {
+      projection: { messages: [{ id: "message:acknowledged", text: "hello" }] },
+    };
+    state.workflow = {
+      activeRun: { id: "run:active" },
+      canPromoteToSteer: true,
+      canReorder: true,
+      queuedRuns: [],
+    };
+
+    const html = renderToStaticMarkup(
+      <QueuedRunsControl
+        environmentId={"environment:test" as never}
+        optimisticMessages={[
+          {
+            id: "message:acknowledged" as never,
+            inputIntent: "queued_turn",
+            text: "hello",
+            attachments: [],
+          },
+        ]}
+        threadId={"thread:test" as never}
+        editingRunId={null}
+        onEditQueuedRun={() => undefined}
+        onCancelEdit={() => undefined}
+      />,
+    );
+
+    expect(html).toBe("");
+  });
+
+  it("keeps the original queued message visible while editing", () => {
+    state.projection = { projection: { messages: [] } };
+    state.workflow = workflowWithAttachment();
+
+    const html = renderToStaticMarkup(
+      <QueuedRunsControl
+        environmentId={"environment:test" as never}
+        optimisticMessages={[]}
+        threadId={"thread:test" as never}
+        editingRunId={"run:queued" as never}
+        onEditQueuedRun={() => undefined}
+        onCancelEdit={() => undefined}
+      />,
+    );
+
+    expect(html).toContain("Queued with a screenshot");
+  });
+});
diff --git a/apps/web/src/components/chat/QueuedRunsControl.tsx b/apps/web/src/components/chat/QueuedRunsControl.tsx
new file mode 100644
index 000000000000..de0511b44e8f
--- /dev/null
+++ b/apps/web/src/components/chat/QueuedRunsControl.tsx
@@ -0,0 +1,451 @@
+import { scopeThreadRef } from "@t3tools/client-runtime/environment";
+import { deriveThreadQueueWorkflowState } from "@t3tools/client-runtime/state/thread-workflows";
+import type {
+  ChatAttachment as ContractChatAttachment,
+  EnvironmentId,
+  MessageId,
+  RunId,
+  ThreadId,
+} from "@t3tools/contracts";
+import {
+  Clock3Icon,
+  CornerUpRightIcon,
+  GripVerticalIcon,
+  ListOrderedIcon,
+  PencilIcon,
+} from "lucide-react";
+import { useId, useMemo, useRef, useState } from "react";
+
+import { useAssetUrls } from "../../assets/assetUrls";
+import { threadEnvironment } from "../../state/threads";
+import { useThreadProjection } from "../../state/entities";
+import { useAtomCommand } from "../../state/use-atom-command";
+import { isImageAttachment, type ChatMessage } from "../../types";
+import { cn } from "~/lib/utils";
+import { ComposerBanner } from "./ComposerBanner";
+import { Button } from "../ui/button";
+import { Tooltip, TooltipPopup, TooltipTrigger } from "../ui/tooltip";
+
+export interface EditQueuedRunRequest {
+  readonly runId: RunId;
+  readonly messageId: MessageId;
+  readonly text: string;
+  readonly attachments: ReadonlyArray<ContractChatAttachment>;
+}
+
+interface QueuedRowThumbnail {
+  readonly key: string;
+  readonly name: string;
+  readonly url: string | null;
+}
+
+const QUEUED_RUN_DRAG_TYPE = "application/x-t3code-queued-run";
+
+export function QueuedRunsControl(props: {
+  readonly environmentId: EnvironmentId;
+  readonly threadId: ThreadId;
+  readonly optimisticMessages: ReadonlyArray<
+    Pick<ChatMessage, "id" | "inputIntent" | "text" | "attachments">
+  >;
+  /** The saved queue entry stays visible while its draft is edited in the composer. */
+  readonly editingRunId: RunId | null;
+  readonly onEditQueuedRun: (request: EditQueuedRunRequest) => void;
+  readonly onCancelEdit: () => void;
+}) {
+  const projection = useThreadProjection(
+    scopeThreadRef(props.environmentId, props.threadId),
+  )?.projection;
+  const reorder = useAtomCommand(threadEnvironment.reorderQueuedRun);
+  const promote = useAtomCommand(threadEnvironment.promoteQueuedRun);
+  const cancel = useAtomCommand(threadEnvironment.cancelQueuedRun);
+  const [expanded, setExpanded] = useState(true);
+  const queueListId = useId();
+  const [busyRunId, setBusyRunId] = useState<RunId | null>(null);
+  // Live drag-reorder state: the dragged run and the queue index the row
+  // would be inserted at (0..queued.length) as of the latest dragover.
+  const [dragState, setDragState] = useState<{
+    readonly runId: RunId;
+    readonly insertIndex: number | null;
+  } | null>(null);
+  // Drags must start from the grip, not from an accidental text-drag on the
+  // row. The grip arms its run id on pointerdown; dragstart verifies it.
+  const dragArmedRunIdRef = useRef<RunId | null>(null);
+  const workflow = useMemo(
+    () => (projection ? deriveThreadQueueWorkflowState(projection) : null),
+    [projection],
+  );
+  const queued = workflow?.queuedRuns ?? [];
+  const activeRun = workflow?.activeRun ?? null;
+  const canReorder = workflow?.canReorder === true;
+  const queuedImageAttachmentIds = useMemo(() => {
+    const ids: string[] = [];
+    for (const { attachments } of workflow?.queuedRuns ?? []) {
+      for (const attachment of attachments) {
+        if (attachment.type === "image") ids.push(attachment.id);
+      }
+    }
+    return ids;
+  }, [workflow]);
+  const queuedImageAttachmentResources = useMemo(
+    () =>
+      queuedImageAttachmentIds.map((attachmentId) => ({
+        _tag: "attachment" as const,
+        attachmentId,
+      })),
+    [queuedImageAttachmentIds],
+  );
+  const queuedImageAttachmentUrls = useAssetUrls(
+    props.environmentId,
+    queuedImageAttachmentResources,
+  );
+  const queuedImageUrlById = useMemo(
+    () =>
+      new Map(
+        queuedImageAttachmentIds.flatMap((attachmentId, index) => {
+          const url = queuedImageAttachmentUrls[index];
+          return url ? [[attachmentId, url] as const] : [];
+        }),
+      ),
+    [queuedImageAttachmentIds, queuedImageAttachmentUrls],
+  );
+  // Once the projection holds the message the optimistic copy is stale no
+  // matter what happened to its run — keying on still-queued runs alone would
+  // resurrect a phantom "pending" row after the run is cancelled or started.
+  const acknowledgedMessageIds = useMemo(
+    () => new Set((projection?.messages ?? []).map((message) => message.id)),
+    [projection],
+  );
+  const optimisticQueued = props.optimisticMessages.filter(
+    (message) => message.inputIntent === "queued_turn" && !acknowledgedMessageIds.has(message.id),
+  );
+  const items = [
+    ...queued.map(({ run, text, attachments }, serverIndex) => ({
+      key: run.id,
+      runId: run.id,
+      messageId: run.userMessageId,
+      serverIndex,
+      text,
+      attachments,
+      thumbnails: attachments
+        .filter((attachment) => attachment.type === "image")
+        .map<QueuedRowThumbnail>((attachment) => ({
+          key: attachment.id,
+          name: attachment.name,
+          url: queuedImageUrlById.get(attachment.id) ?? null,
+        })),
+      pending: false,
+    })),
+    ...optimisticQueued.map((message) => ({
+      key: message.id,
+      runId: null,
+      messageId: null,
+      serverIndex: null,
+      text: message.text,
+      attachments: [] as ReadonlyArray<ContractChatAttachment>,
+      thumbnails: (message.attachments ?? [])
+        .filter(isImageAttachment)
+        .map<QueuedRowThumbnail>((attachment) => ({
+          key: attachment.id,
+          name: attachment.name,
+          url: attachment.previewUrl ?? null,
+        })),
+      pending: true,
+    })),
+  ];
+
+  if (items.length === 0) return null;
+
+  const move = async (runId: RunId, beforeRunId: RunId | null) => {
+    setBusyRunId(runId);
+    try {
+      await reorder({
+        environmentId: props.environmentId,
+        input: { threadId: props.threadId, runId, beforeRunId },
+      });
+    } finally {
+      setBusyRunId(null);
+    }
+  };
+
+  const completeDrag = (runId: RunId, insertIndex: number | null) => {
+    setDragState(null);
+    dragArmedRunIdRef.current = null;
+    if (insertIndex === null || busyRunId !== null) return;
+    const draggedIndex = queued.findIndex(({ run }) => run.id === runId);
+    if (draggedIndex === -1) return;
+    // Inserting immediately before or after itself is a no-op.
+    if (insertIndex === draggedIndex || insertIndex === draggedIndex + 1) return;
+    void move(runId, queued[insertIndex]?.run.id ?? null);
+  };
+
+  const steer = async (queuedRunId: RunId) => {
+    if (activeRun === null) return;
+    setBusyRunId(queuedRunId);
+    try {
+      await promote({
+        environmentId: props.environmentId,
+        input: { threadId: props.threadId, queuedRunId, targetRunId: activeRun.id },
+      });
+    } finally {
+      setBusyRunId(null);
+    }
+  };
+
+  const remove = async (runId: RunId) => {
+    setBusyRunId(runId);
+    try {
+      await cancel({
+        environmentId: props.environmentId,
+        input: { threadId: props.threadId, runId },
+      });
+    } finally {
+      setBusyRunId(null);
+    }
+  };
+
+  return (
+    <ComposerBanner.Attachment>
+      <ComposerBanner.Root
+        role="region"
+        aria-label={`${items.length} queued message${items.length === 1 ? "" : "s"}`}
+        aria-live="polite"
+        data-chat-composer-collapsed-controls="true"
+        className="relative z-0"
+      >
+        <ComposerBanner.Row
+          render={<button type="button" />}
+          aria-label={expanded ? "Collapse queued messages" : "Expand queued messages"}
+          aria-expanded={expanded}
+          aria-controls={queueListId}
+          onPointerDown={(event) => event.preventDefault()}
+          onClick={() => setExpanded((value) => !value)}
+        >
+          <ComposerBanner.Icon>
+            <ListOrderedIcon />
+          </ComposerBanner.Icon>
+          <ComposerBanner.Content className="text-muted-foreground">Queued</ComposerBanner.Content>
+          <ComposerBanner.Actions>
+            <ComposerBanner.Count>{items.length}</ComposerBanner.Count>
+            <ComposerBanner.ToggleIcon expanded={expanded} />
+          </ComposerBanner.Actions>
+        </ComposerBanner.Row>
+        <ComposerBanner.Scroll className={cn("max-h-32", !expanded && "hidden")}>
+          <ComposerBanner.Children render={<ol />} id={queueListId}>
+            {items.map((item) => {
+              const rowRunId = item.runId;
+              const rowServerIndex = item.serverIndex;
+              const isEditing = rowRunId !== null && rowRunId === props.editingRunId;
+              const rowDraggable =
+                rowRunId !== null && rowServerIndex !== null && canReorder && busyRunId === null;
+              return (
+                <ComposerBanner.Row
+                  render={<li />}
+                  key={item.key}
+                  aria-current={isEditing ? "true" : undefined}
+                  className={cn(
+                    "relative rounded-sm",
+                    isEditing && "bg-accent text-accent-foreground",
+                    dragState !== null && dragState.runId === item.runId && "opacity-50",
+                  )}
+                  draggable={rowDraggable}
+                  onDragStart={(event) => {
+                    if (item.runId === null || dragArmedRunIdRef.current !== item.runId) {
+                      event.preventDefault();
+                      return;
+                    }
+                    event.dataTransfer.setData(QUEUED_RUN_DRAG_TYPE, item.runId);
+                    event.dataTransfer.effectAllowed = "move";
+                    setDragState({ runId: item.runId, insertIndex: null });
+                  }}
+                  onDragEnd={() => {
+                    dragArmedRunIdRef.current = null;
+                    setDragState(null);
+                  }}
+                  onDragOver={(event) => {
+                    if (dragState === null || item.serverIndex === null) return;
+                    event.preventDefault();
+                    event.dataTransfer.dropEffect = "move";
+                    const rect = event.currentTarget.getBoundingClientRect();
+                    const insertIndex =
+                      event.clientY < rect.top + rect.height / 2
+                        ? item.serverIndex
+                        : item.serverIndex + 1;
+                    if (dragState.insertIndex !== insertIndex) {
+                      setDragState({ runId: dragState.runId, insertIndex });
+                    }
+                  }}
+                  onDrop={(event) => {
+                    if (dragState === null) return;
+                    event.preventDefault();
+                    completeDrag(dragState.runId, dragState.insertIndex);
+                  }}
+                >
+                  {item.serverIndex !== null && dragState?.insertIndex === item.serverIndex ? (
+                    <span
+                      aria-hidden
+                      className="pointer-events-none absolute inset-x-0 top-0 h-0.5 rounded bg-primary/70"
+                    />
+                  ) : null}
+                  {item.serverIndex === queued.length - 1 &&
+                  dragState?.insertIndex === queued.length ? (
+                    <span
+                      aria-hidden
+                      className="pointer-events-none absolute inset-x-0 bottom-0 h-0.5 rounded bg-primary/70"
+                    />
+                  ) : null}
+                  <ComposerBanner.Icon aria-hidden={false}>
+                    {canReorder && rowRunId !== null && rowServerIndex !== null ? (
+                      <Button
+                        size="icon-xs"
+                        variant="ghost-muted"
+                        aria-label="Reorder queued message (drag, or press the arrow keys)"
+                        className="cursor-grab active:cursor-grabbing disabled:cursor-default"
+                        disabled={busyRunId !== null}
+                        onPointerDown={() => {
+                          dragArmedRunIdRef.current = rowRunId;
+                        }}
+                        onKeyDown={(event) => {
+                          if (busyRunId !== null) return;
+                          if (event.key === "ArrowUp" && rowServerIndex > 0) {
+                            event.preventDefault();
+                            void move(rowRunId, queued[rowServerIndex - 1]?.run.id ?? null);
+                          }
+                          if (event.key === "ArrowDown" && rowServerIndex < queued.length - 1) {
+                            event.preventDefault();
+                            void move(rowRunId, queued[rowServerIndex + 2]?.run.id ?? null);
+                          }
+                        }}
+                      >
+                        <GripVerticalIcon />
+                      </Button>
+                    ) : null}
+                  </ComposerBanner.Icon>
+                  <ComposerBanner.Content className="text-foreground/80">
+                    {isEditing ? <span className="sr-only">Editing queued message: </span> : null}
+                    {item.pending ? (
+                      <Clock3Icon
+                        aria-label="Saving queued message"
+                        className="size-3 shrink-0 text-muted-foreground/60"
+                      />
+                    ) : null}
+                    {item.thumbnails.length > 0 ? (
+                      <span className="flex shrink-0 items-center gap-0.5">
+                        {item.thumbnails.map((thumbnail) => (
+                          <span
+                            key={thumbnail.key}
+                            className="size-4 overflow-hidden rounded border border-border/70 bg-background"
+                          >
+                            {thumbnail.url ? (
+                              <img
+                                src={thumbnail.url}
+                                alt={thumbnail.name}
+                                className="size-full object-cover"
+                              />
+                            ) : (
+                              <span
+                                aria-label={thumbnail.name}
+                                className="block size-full bg-muted/60"
+                              />
+                            )}
+                          </span>
+                        ))}
+                      </span>
+                    ) : null}
+                    <Tooltip>
+                      <TooltipTrigger render={<span className="min-w-0 flex-1 truncate" />}>
+                        {item.text}
+                      </TooltipTrigger>
+                      <TooltipPopup side="top" className="max-w-96 break-words">
+                        {item.text}
+                      </TooltipPopup>
+                    </Tooltip>
+                  </ComposerBanner.Content>
+                  <ComposerBanner.Actions>
+                    {isEditing ? (
+                      <Button
+                        size="xs"
+                        variant="ghost"
+                        aria-label="Cancel editing queued message"
+                        onClick={props.onCancelEdit}
+                      >
+                        Cancel
+                      </Button>
+                    ) : (
+                      <>
+                        <Tooltip>
+                          <TooltipTrigger
+                            render={
+                              <Button
+                                size="icon-xs"
+                                variant="ghost-muted"
+                                aria-label="Edit queued message"
+                                disabled={item.runId === null || busyRunId !== null}
+                                onClick={() => {
+                                  if (item.runId !== null && item.messageId !== null) {
+                                    props.onEditQueuedRun({
+                                      runId: item.runId,
+                                      messageId: item.messageId,
+                                      text: item.text,
+                                      attachments: item.attachments,
+                                    });
+                                  }
+                                }}
+                              />
+                            }
+                          >
+                            <PencilIcon />
+                          </TooltipTrigger>
+                          <TooltipPopup>Edit in the composer</TooltipPopup>
+                        </Tooltip>
+                        <Tooltip>
+                          <TooltipTrigger render={<span className="flex shrink-0" />}>
+                            <Button
+                              size="xs"
+                              variant="ghost-muted"
+                              disabled={
+                                item.runId === null ||
+                                busyRunId !== null ||
+                                !workflow?.canPromoteToSteer
+                              }
+                              onClick={() => {
+                                if (item.runId !== null) {
+                                  void steer(item.runId);
+                                }
+                              }}
+                            >
+                              <CornerUpRightIcon />
+                              Steer
+                            </Button>
+                          </TooltipTrigger>
+                          <TooltipPopup>
+                            {activeRun === null
+                              ? "There is no active run to steer"
+                              : "Send as a steer instead"}
+                          </TooltipPopup>
+                        </Tooltip>
+                        <Tooltip>
+                          <TooltipTrigger
+                            render={
+                              <ComposerBanner.Dismiss
+                                aria-label="Remove queued message"
+                                disabled={item.runId === null || busyRunId !== null}
+                                onClick={() => {
+                                  if (item.runId !== null) void remove(item.runId);
+                                }}
+                              />
+                            }
+                          />
+                          <TooltipPopup>Remove from queue</TooltipPopup>
+                        </Tooltip>
+                      </>
+                    )}
+                  </ComposerBanner.Actions>
+                </ComposerBanner.Row>
+              );
+            })}
+          </ComposerBanner.Children>
+        </ComposerBanner.Scroll>
+      </ComposerBanner.Root>
+    </ComposerBanner.Attachment>
+  );
+}
diff --git a/apps/web/src/components/chat/ThreadAutomationsPanel.tsx b/apps/web/src/components/chat/ThreadAutomationsPanel.tsx
new file mode 100644
index 000000000000..4457d17d013e
--- /dev/null
+++ b/apps/web/src/components/chat/ThreadAutomationsPanel.tsx
@@ -0,0 +1,190 @@
+import { useNavigate } from "@tanstack/react-router";
+import { CalendarClockIcon, PlayIcon, Settings2Icon } from "lucide-react";
+import { useState } from "react";
+import type { EnvironmentId, ScheduledTask, ThreadId } from "@t3tools/contracts";
+import {
+  isAtomCommandInterrupted,
+  squashAtomCommandFailure,
+} from "@t3tools/client-runtime/state/runtime";
+
+import { cn } from "../../lib/utils";
+import { relativeLabel, scheduleLabel } from "../settings/ScheduledTasksSettings";
+import { useEnvironmentQuery } from "../../state/query";
+import { serverEnvironment } from "../../state/server";
+import { useAtomCommand } from "../../state/use-atom-command";
+import { Button } from "../ui/button";
+import { Switch } from "../ui/switch";
+import { stackedThreadToast, toastManager } from "../ui/toast";
+import { Tooltip, TooltipPopup, TooltipTrigger } from "../ui/tooltip";
+import {
+  THREAD_DETAILS_PANEL_ICON_ACTION_CLASS,
+  THREAD_DETAILS_PANEL_ICON_CLASS,
+} from "./threadDetailsPanelStyles";
+
+const STATUS_DOT_CLASS: Record<ScheduledTask["lastRunStatus"], string> = {
+  never: "bg-muted-foreground/40",
+  running: "animate-pulse bg-sky-500",
+  succeeded: "bg-emerald-500",
+  failed: "bg-destructive",
+};
+
+/**
+ * Thread details panel section listing the automations (scheduled tasks) bound
+ * to this thread. Fed by the live scheduled-task subscription, so run status
+ * and next-run times update as the scheduler works — no manual refresh.
+ * Renders nothing when the thread has no bound automations.
+ */
+export function ThreadAutomationsPanel(props: {
+  readonly environmentId: EnvironmentId;
+  readonly threadId: ThreadId;
+}) {
+  const tasksQuery = useEnvironmentQuery(
+    serverEnvironment.scheduledTasksLive({ environmentId: props.environmentId, input: {} }),
+  );
+  const setTaskEnabled = useAtomCommand(serverEnvironment.setScheduledTaskEnabled, {
+    label: "thread automation toggle",
+  });
+  const runTaskNow = useAtomCommand(serverEnvironment.runScheduledTaskNow, {
+    label: "thread automation run now",
+  });
+  const navigate = useNavigate();
+  const [busyTaskId, setBusyTaskId] = useState<string | null>(null);
+
+  const boundTasks = (tasksQuery.data?.tasks ?? []).filter(
+    (task) => task.threadId === props.threadId,
+  );
+  // A load error must not look like "no automations" — this thread may have
+  // tasks whose controls would silently vanish. Only hide the section when we
+  // positively know there is nothing bound to it.
+  if (tasksQuery.error === null && boundTasks.length === 0) return null;
+
+  const reportFailure = (title: string, error: unknown) => {
+    toastManager.add(
+      stackedThreadToast({
+        type: "error",
+        title,
+        description: error instanceof Error ? error.message : String(error),
+      }),
+    );
+  };
+
+  const toggleEnabled = async (task: ScheduledTask, enabled: boolean) => {
+    if (busyTaskId !== null) return;
+    setBusyTaskId(task.id);
+    // Partial update: only the enabled flag changes, so a toggle can never
+    // revert concurrent edits made to the task elsewhere.
+    const result = await setTaskEnabled({
+      environmentId: props.environmentId,
+      input: { id: task.id, enabled },
+    });
+    setBusyTaskId(null);
+    if (result._tag === "Failure" && !isAtomCommandInterrupted(result)) {
+      reportFailure("Could not update automation", squashAtomCommandFailure(result));
+    }
+  };
+
+  const runNow = async (task: ScheduledTask) => {
+    if (busyTaskId !== null) return;
+    setBusyTaskId(task.id);
+    const result = await runTaskNow({
+      environmentId: props.environmentId,
+      input: { id: task.id },
+    });
+    setBusyTaskId(null);
+    if (result._tag === "Failure" && !isAtomCommandInterrupted(result)) {
+      reportFailure("Could not run automation", squashAtomCommandFailure(result));
+    }
+  };
+
+  return (
+    <section
+      aria-labelledby="thread-details-automations-heading"
+      className="border-t border-border/65 px-2 pb-2.5 pt-2"
+      data-thread-automations-panel
+    >
+      <div className="mb-1 flex min-h-8 items-center justify-between gap-2 px-2">
+        <h3
+          id="thread-details-automations-heading"
+          className="text-[11px] font-medium text-muted-foreground"
+        >
+          Automations
+        </h3>
+        <Tooltip>
+          <TooltipTrigger
+            render={
+              <Button
+                size="icon-xs"
+                variant="ghost"
+                className={THREAD_DETAILS_PANEL_ICON_ACTION_CLASS}
+                aria-label="Manage schedule tasks"
+                onClick={() => void navigate({ to: "/settings/scheduled-tasks" })}
+              >
+                <Settings2Icon className="size-3.5" />
+              </Button>
+            }
+          />
+          <TooltipPopup>Manage schedule tasks</TooltipPopup>
+        </Tooltip>
+      </div>
+
+      {tasksQuery.error !== null ? (
+        <p className="px-2.5 py-1.5 text-[11px] text-destructive">
+          Could not load automations: {tasksQuery.error}
+        </p>
+      ) : null}
+
+      <ul className="m-0 list-none p-0">
+        {boundTasks.map((task) => (
+          <li key={task.id} className="group flex items-center gap-2.5 rounded-lg px-2.5 py-1.5">
+            <CalendarClockIcon className={THREAD_DETAILS_PANEL_ICON_CLASS} />
+            <div className="min-w-0 flex-1">
+              <div className="flex items-center gap-1.5">
+                <span
+                  className={cn(
+                    "size-1.5 shrink-0 rounded-full",
+                    STATUS_DOT_CLASS[task.lastRunStatus],
+                  )}
+                  aria-hidden
+                />
+                <span className="truncate text-[13px] font-medium text-foreground/80">
+                  {task.title}
+                </span>
+              </div>
+              <p className="truncate text-[11px] text-muted-foreground">
+                {scheduleLabel(task.schedule)}
+                {task.enabled && task.nextRunAt !== null
+                  ? ` · next ${relativeLabel(task.nextRunAt)}`
+                  : task.enabled
+                    ? ""
+                    : " · paused"}
+              </p>
+            </div>
+            <Tooltip>
+              <TooltipTrigger
+                render={
+                  <Button
+                    size="icon-xs"
+                    variant="ghost"
+                    className={THREAD_DETAILS_PANEL_ICON_ACTION_CLASS}
+                    aria-label={`Run ${task.title} now`}
+                    disabled={busyTaskId !== null || task.lastRunStatus === "running"}
+                    onClick={() => void runNow(task)}
+                  >
+                    <PlayIcon className="size-3.5" />
+                  </Button>
+                }
+              />
+              <TooltipPopup>Run now</TooltipPopup>
+            </Tooltip>
+            <Switch
+              checked={task.enabled}
+              disabled={busyTaskId !== null}
+              aria-label={task.enabled ? `Pause ${task.title}` : `Resume ${task.title}`}
+              onCheckedChange={(enabled) => void toggleEnabled(task, enabled)}
+            />
+          </li>
+        ))}
+      </ul>
+    </section>
+  );
+}
diff --git a/apps/web/src/components/chat/ThreadDetailsPanel.test.tsx b/apps/web/src/components/chat/ThreadDetailsPanel.test.tsx
new file mode 100644
index 000000000000..fc1ff4e3571e
--- /dev/null
+++ b/apps/web/src/components/chat/ThreadDetailsPanel.test.tsx
@@ -0,0 +1,91 @@
+import type { EnvironmentId, T3ProjectFileScript, ThreadId } from "@t3tools/contracts";
+import { renderToStaticMarkup } from "react-dom/server";
+import { beforeEach, describe, expect, it, vi } from "vite-plus/test";
+
+const testState = vi.hoisted(() => ({
+  useT3ProjectFileScripts: vi.fn(),
+  projectScriptsControl: vi.fn(),
+}));
+
+vi.mock("../../hooks/useT3ProjectFileScripts", () => ({
+  useT3ProjectFileScripts: (...args: ReadonlyArray<unknown>) =>
+    testState.useT3ProjectFileScripts(...args),
+}));
+vi.mock("../BranchToolbar", () => ({
+  BranchToolbar: () => null,
+}));
+vi.mock("../ProjectScriptsControl", () => ({
+  default: (props: unknown) => {
+    testState.projectScriptsControl(props);
+    return null;
+  },
+}));
+vi.mock("./ThreadAutomationsPanel", () => ({
+  ThreadAutomationsPanel: () => null,
+}));
+vi.mock("./ThreadRelationshipsControl", () => ({
+  ThreadRelationshipsPanel: () => null,
+}));
+
+import { ThreadDetailsPanel, type ThreadDetailsPanelProps } from "./ThreadDetailsPanel";
+
+describe("ThreadDetailsPanel", () => {
+  beforeEach(() => {
+    testState.useT3ProjectFileScripts.mockReset();
+    testState.projectScriptsControl.mockReset();
+  });
+
+  it("passes checked-in t3.json scripts to the project scripts control", () => {
+    const environmentId = "environment:thread-details" as EnvironmentId;
+    const gitCwd = "/tmp/thread-details-project";
+    const fileScripts = [
+      {
+        name: "Check project",
+        command: "vp check",
+        icon: "test",
+      },
+    ] satisfies ReadonlyArray<T3ProjectFileScript>;
+    testState.useT3ProjectFileScripts.mockReturnValue(fileScripts);
+
+    const props: ThreadDetailsPanelProps = {
+      mode: "popover",
+      environmentId,
+      environmentConnection: null,
+      threadId: "thread:thread-details" as ThreadId,
+      activeProjectName: undefined,
+      activeProjectScripts: [],
+      preferredScriptId: null,
+      keybindings: [],
+      availableEditors: [],
+      showOpenInPicker: false,
+      gitCwd,
+      isGitRepo: false,
+      envLocked: false,
+      availableEnvironments: [],
+      onEnvironmentChange: vi.fn(),
+      onEnvModeChange: vi.fn(),
+      startFromOrigin: false,
+      onStartFromOriginChange: vi.fn(),
+      onComposerFocusRequest: vi.fn(),
+      onReconnectEnvironment: vi.fn(),
+      onOpenConnectionSettings: vi.fn(),
+      versionMismatch: null,
+      onDismissVersionMismatch: vi.fn(),
+      onRunProjectScript: vi.fn(),
+      onAddProjectScript: vi.fn() as ThreadDetailsPanelProps["onAddProjectScript"],
+      onUpdateProjectScript: vi.fn() as ThreadDetailsPanelProps["onUpdateProjectScript"],
+      onDeleteProjectScript: vi.fn() as ThreadDetailsPanelProps["onDeleteProjectScript"],
+    };
+
+    renderToStaticMarkup(<ThreadDetailsPanel {...props} />);
+
+    expect(testState.useT3ProjectFileScripts).toHaveBeenCalledWith(environmentId, gitCwd);
+    expect(testState.projectScriptsControl).toHaveBeenCalledWith(
+      expect.objectContaining({
+        displayMode: "panel",
+        scripts: [],
+        fileScripts,
+      }),
+    );
+  });
+});
diff --git a/apps/web/src/components/chat/ThreadDetailsPanel.tsx b/apps/web/src/components/chat/ThreadDetailsPanel.tsx
new file mode 100644
index 000000000000..60192d9cba43
--- /dev/null
+++ b/apps/web/src/components/chat/ThreadDetailsPanel.tsx
@@ -0,0 +1,280 @@
+import type {
+  EditorId,
+  EnvironmentId,
+  ProjectScript,
+  ResolvedKeybindingsConfig,
+  ThreadId,
+} from "@t3tools/contracts";
+import type { EnvironmentConnectionPresentation } from "@t3tools/client-runtime/connection";
+import { AlertTriangleIcon, XIcon } from "lucide-react";
+
+import type { DraftId } from "../../composerDraftStore";
+import { useT3ProjectFileScripts } from "../../hooks/useT3ProjectFileScripts";
+import type { EnvMode, EnvironmentOption } from "../BranchToolbar.logic";
+import { BranchToolbar } from "../BranchToolbar";
+import { BranchToolbarEnvironmentSelector } from "../BranchToolbarEnvironmentSelector";
+import GitActionsControl from "../GitActionsControl";
+import ProjectScriptsControl, {
+  type NewProjectScriptInput,
+  type ProjectScriptActionResult,
+} from "../ProjectScriptsControl";
+import { Button } from "../ui/button";
+import { ScrollArea } from "../ui/scroll-area";
+import { cn } from "../../lib/utils";
+import { OpenInPicker } from "./OpenInPicker";
+import { ThreadAutomationsPanel } from "./ThreadAutomationsPanel";
+import { ThreadRelationshipsPanel } from "./ThreadRelationshipsControl";
+
+interface VersionMismatchIssue {
+  readonly clientVersion: string;
+  readonly serverVersion: string;
+  readonly serverLabel: string;
+}
+
+export interface ThreadDetailsPanelProps {
+  mode: "inline" | "popover";
+  onClose?: () => void;
+  environmentId: EnvironmentId;
+  environmentConnection: EnvironmentConnectionPresentation | null;
+  threadId: ThreadId;
+  draftId?: DraftId;
+  activeProjectName: string | undefined;
+  activeProjectScripts: ReadonlyArray<ProjectScript> | undefined;
+  preferredScriptId: string | null;
+  keybindings: ResolvedKeybindingsConfig;
+  availableEditors: ReadonlyArray<EditorId>;
+  showOpenInPicker: boolean;
+  gitCwd: string | null;
+  isGitRepo: boolean;
+  envLocked: boolean;
+  availableEnvironments: readonly EnvironmentOption[];
+  onEnvironmentChange: (environmentId: EnvironmentId) => void;
+  onEnvModeChange: (mode: EnvMode) => void;
+  effectiveEnvModeOverride?: EnvMode;
+  activeThreadBranchOverride?: string | null;
+  onActiveThreadBranchOverrideChange?: (branch: string | null) => void;
+  startFromOrigin: boolean;
+  onStartFromOriginChange: (startFromOrigin: boolean) => void;
+  onCheckoutPullRequestRequest?: (reference: string) => void;
+  onComposerFocusRequest: () => void;
+  onOpenChanges?: () => void;
+  onReconnectEnvironment: () => void;
+  onOpenConnectionSettings: () => void;
+  versionMismatch: VersionMismatchIssue | null;
+  onDismissVersionMismatch: () => void;
+  onRunProjectScript: (script: ProjectScript) => void;
+  onAddProjectScript: (input: NewProjectScriptInput) => Promise<ProjectScriptActionResult>;
+  onUpdateProjectScript: (
+    scriptId: string,
+    input: NewProjectScriptInput,
+  ) => Promise<ProjectScriptActionResult>;
+  onDeleteProjectScript: (scriptId: string) => Promise<ProjectScriptActionResult>;
+}
+
+export function ThreadDetailsPanel(props: ThreadDetailsPanelProps) {
+  const fileScripts = useT3ProjectFileScripts(
+    props.environmentId,
+    props.activeProjectScripts ? props.gitCwd : null,
+  );
+  const connectionIssue =
+    props.environmentConnection !== null &&
+    props.environmentConnection.phase !== "connected" &&
+    props.environmentConnection.phase !== "available";
+  const isReconnecting =
+    props.environmentConnection?.phase === "connecting" ||
+    props.environmentConnection?.phase === "reconnecting";
+  const branchToolbarProps = {
+    showGitControls: props.isGitRepo,
+    environmentId: props.environmentId,
+    threadId: props.threadId,
+    ...(props.draftId ? { draftId: props.draftId } : {}),
+    onEnvModeChange: props.onEnvModeChange,
+    startFromOrigin: props.startFromOrigin,
+    onStartFromOriginChange: props.onStartFromOriginChange,
+    ...(props.effectiveEnvModeOverride
+      ? { effectiveEnvModeOverride: props.effectiveEnvModeOverride }
+      : {}),
+    ...(props.activeThreadBranchOverride !== undefined
+      ? { activeThreadBranchOverride: props.activeThreadBranchOverride }
+      : {}),
+    ...(props.onActiveThreadBranchOverrideChange
+      ? { onActiveThreadBranchOverrideChange: props.onActiveThreadBranchOverrideChange }
+      : {}),
+    envLocked: props.envLocked,
+    onComposerFocusRequest: props.onComposerFocusRequest,
+    ...(props.onCheckoutPullRequestRequest
+      ? { onCheckoutPullRequestRequest: props.onCheckoutPullRequestRequest }
+      : {}),
+  };
+
+  const card = (
+    <div
+      className={cn(
+        // A single-track grid, because a grid area is a definite containing block: the card's own
+        // height is "content, clamped by max-height", which percentages treat as indefinite — as
+        // a plain block (or even a flex column) every `h-full`/`max-h-full` down the chain
+        // resolved to nothing, the scroll area's viewport stayed at its content height, and the
+        // card's overflow-hidden clipped the content instead of scrolling it. `minmax(0,1fr)`
+        // still shrink-wraps short content while letting the clamp bite on tall content.
+        "dropdown-glass isolate contain-paint grid max-h-full grid-rows-[minmax(0,1fr)] overflow-hidden rounded-[20px]",
+        // The popup's real ceiling is what base-ui measured for it — the anchor's clipping
+        // ancestors, which is how an open terminal drawer shrinks it — less the popover
+        // viewport's own p-2. The dvh term is the fallback's fallback, from before.
+        props.mode === "popover" &&
+          "max-h-[min(calc(100dvh-6.5rem),calc(var(--available-height,100dvh)-1rem))]",
+      )}
+      data-thread-details-card
+    >
+      <ScrollArea scrollFade className="min-h-0">
+        <section aria-labelledby="thread-details-workspace-heading">
+          <div className="flex min-h-10 items-center justify-between gap-3 px-3.5 pb-1 pt-3">
+            <h3
+              id="thread-details-workspace-heading"
+              className="text-[11px] font-medium text-muted-foreground"
+            >
+              Workspace
+            </h3>
+          </div>
+
+          {connectionIssue ? (
+            <div className="mx-3 mb-2 rounded-xl border border-warning/30 bg-warning/6 p-3">
+              <div className="flex gap-2">
+                <AlertTriangleIcon className="mt-0.5 size-3.5 shrink-0 text-warning" />
+                <div className="min-w-0 flex-1">
+                  <p className="text-xs font-medium">Environment unavailable</p>
+                  <p className="mt-1 text-[11px] leading-relaxed text-muted-foreground">
+                    {props.environmentConnection?.error ??
+                      "Reconnect this environment before sending messages or running actions."}
+                  </p>
+                  <div className="mt-2 flex items-center gap-1.5">
+                    <Button
+                      size="xs"
+                      disabled={isReconnecting}
+                      onClick={props.onReconnectEnvironment}
+                    >
+                      {isReconnecting ? "Reconnecting..." : "Reconnect"}
+                    </Button>
+                    <Button size="xs" variant="ghost" onClick={props.onOpenConnectionSettings}>
+                      Connections
+                    </Button>
+                  </div>
+                </div>
+              </div>
+            </div>
+          ) : null}
+
+          {props.versionMismatch ? (
+            <div className="mx-3 mb-2 flex gap-2 rounded-xl border border-warning/30 bg-warning/6 p-3">
+              <AlertTriangleIcon className="mt-0.5 size-3.5 shrink-0 text-warning" />
+              <div className="min-w-0 flex-1">
+                <p className="text-xs font-medium">Client and server versions differ</p>
+                <p className="mt-1 text-[11px] leading-relaxed text-muted-foreground">
+                  Client {props.versionMismatch.clientVersion} · {props.versionMismatch.serverLabel}{" "}
+                  {props.versionMismatch.serverVersion}
+                </p>
+              </div>
+              <Button
+                size="icon-xs"
+                variant="ghost"
+                aria-label="Dismiss version mismatch warning"
+                onClick={props.onDismissVersionMismatch}
+              >
+                <XIcon className="size-3.5" />
+              </Button>
+            </div>
+          ) : null}
+
+          <div className="flex flex-col px-2 pb-2.5">
+            {props.availableEnvironments.length > 1 ? (
+              <BranchToolbarEnvironmentSelector
+                displayMode="panel"
+                envLocked={props.envLocked}
+                environmentId={props.environmentId}
+                availableEnvironments={props.availableEnvironments}
+                onEnvironmentChange={props.onEnvironmentChange}
+              />
+            ) : null}
+
+            <BranchToolbar layout="panel" panelSection="workspace" {...branchToolbarProps} />
+
+            {props.showOpenInPicker ? (
+              <OpenInPicker
+                environmentId={props.environmentId}
+                keybindings={props.keybindings}
+                availableEditors={props.availableEditors}
+                openInCwd={props.gitCwd}
+                displayMode="panel"
+              />
+            ) : null}
+
+            {props.activeProjectScripts ? (
+              <ProjectScriptsControl
+                displayMode="panel"
+                scripts={props.activeProjectScripts}
+                fileScripts={fileScripts}
+                keybindings={props.keybindings}
+                preferredScriptId={props.preferredScriptId}
+                onRunScript={props.onRunProjectScript}
+                onAddScript={props.onAddProjectScript}
+                onUpdateScript={props.onUpdateProjectScript}
+                onDeleteScript={props.onDeleteProjectScript}
+              />
+            ) : null}
+          </div>
+        </section>
+
+        {props.gitCwd ? (
+          <section
+            aria-labelledby="thread-details-version-control-heading"
+            className="border-t border-border/65"
+          >
+            <div className="px-3.5 pb-1 pt-3">
+              <h3
+                id="thread-details-version-control-heading"
+                className="text-[11px] font-medium text-muted-foreground"
+              >
+                Version Control
+              </h3>
+            </div>
+            <div className="flex flex-col px-2 pb-2.5">
+              {props.isGitRepo ? (
+                <BranchToolbar layout="panel" panelSection="branch" {...branchToolbarProps} />
+              ) : null}
+              {props.activeProjectName ? (
+                <GitActionsControl
+                  displayMode="panel"
+                  gitCwd={props.gitCwd}
+                  activeThreadRef={{ environmentId: props.environmentId, threadId: props.threadId }}
+                  {...(props.draftId ? { draftId: props.draftId } : {})}
+                  {...(props.onOpenChanges ? { onOpenChanges: props.onOpenChanges } : {})}
+                />
+              ) : null}
+            </div>
+          </section>
+        ) : null}
+
+        {!props.draftId ? (
+          <ThreadAutomationsPanel environmentId={props.environmentId} threadId={props.threadId} />
+        ) : null}
+
+        {!props.draftId ? (
+          <ThreadRelationshipsPanel environmentId={props.environmentId} threadId={props.threadId} />
+        ) : null}
+      </ScrollArea>
+    </div>
+  );
+
+  if (props.mode === "popover") {
+    return <div data-thread-details-panel="popover">{card}</div>;
+  }
+
+  return (
+    <aside
+      aria-label="Thread details"
+      className="absolute inset-y-0 right-[var(--app-scrollbar-width)] z-20 w-[var(--thread-details-panel-width)] p-3"
+      data-thread-details-panel="inline"
+    >
+      {card}
+    </aside>
+  );
+}
diff --git a/apps/web/src/components/chat/ThreadDetailsPrRow.tsx b/apps/web/src/components/chat/ThreadDetailsPrRow.tsx
new file mode 100644
index 000000000000..98d0fafe3dda
--- /dev/null
+++ b/apps/web/src/components/chat/ThreadDetailsPrRow.tsx
@@ -0,0 +1,415 @@
+/**
+ * The thread details panel's pull request row: what the branch's pull request is, and the one
+ * thing worth doing to it right now.
+ *
+ * The row itself opens the pull request in the right panel, exactly as it always has. Around
+ * that, the host's richer answer collapses into a single trailing slot, ranked by what unblocks
+ * the merge next: "Resolve" on conflicts, "Ready" on a draft, "Fix" under failing checks, and
+ * "Merge" only once the branch is clean and its checks pass. While checks run the slot reports
+ * that instead — a merge offered mid-run would race the very runs that gate it. Everything else
+ * the host knows (title, state, checks tally, diff size) lives in the row's tooltip, so a hover
+ * answers what previously took opening the panel.
+ *
+ * Until the detail arrives — or where pull requests are not supported at all — the row renders
+ * from the `vcs.status` summary alone, which is the plain row this panel showed before.
+ */
+import type { EnvironmentProject } from "@t3tools/client-runtime/state/shell";
+import type { EnvironmentId, ProjectId, PullRequestRef } from "@t3tools/contracts";
+import { ArrowUpRightIcon, FileDiffIcon, GitBranchIcon, TriangleAlertIcon } from "lucide-react";
+import { useState, type MouseEvent as ReactMouseEvent } from "react";
+
+import { cn } from "~/lib/utils";
+import { useServerConfigs } from "~/state/entities";
+import { pullRequestEnvironment } from "~/state/pullRequests";
+import { useEnvironmentQuery } from "~/state/query";
+
+import {
+  buildFixFindingsHandoff,
+  buildResolveConflictsPrompt,
+  classifyPullRequestChecks,
+  describePullRequestChecks,
+  isPullRequestConflicting,
+  resolveSelectedMergeMethod,
+  allowedPullRequestMergeMethods,
+  resolveThreadPanelPullRequestAction,
+} from "../pullRequest/pullRequestDetail.logic";
+import {
+  PullRequestCheckStatusIcon,
+  PullRequestDiffStat,
+  resolvePullRequestState,
+} from "../pullRequest/pullRequestPresentation";
+import {
+  usePullRequestActionRunner,
+  usePullRequestHandoffs,
+} from "../pullRequest/usePullRequestActions";
+import {
+  ChangeRequestStatusIcon,
+  type PrStatusIndicator,
+  type ThreadPr,
+} from "../ThreadStatusIndicators";
+import {
+  AlertDialog,
+  AlertDialogClose,
+  AlertDialogDescription,
+  AlertDialogFooter,
+  AlertDialogHeader,
+  AlertDialogPopup,
+  AlertDialogTitle,
+} from "../ui/alert-dialog";
+import { Button } from "../ui/button";
+import { Tooltip, TooltipPopup, TooltipTrigger } from "../ui/tooltip";
+import {
+  THREAD_DETAILS_PANEL_ICON_CLASS,
+  THREAD_DETAILS_PANEL_LINK_SPLIT_ACTION_CLASS,
+  THREAD_DETAILS_PANEL_LINK_SPLIT_GROUP_CLASS,
+  THREAD_DETAILS_PANEL_LINK_SPLIT_PRIMARY_CLASS,
+  THREAD_DETAILS_PANEL_ROW_CLASS,
+  THREAD_DETAILS_PANEL_SPLIT_SEPARATOR_CLASS,
+} from "./threadDetailsPanelStyles";
+
+export function ThreadDetailsPrRow({
+  environmentId,
+  pr,
+  status,
+  project,
+  label,
+  openAriaLabel,
+  onOpen,
+  onActed,
+}: {
+  environmentId: EnvironmentId;
+  pr: NonNullable<ThreadPr>;
+  status: PrStatusIndicator;
+  /** The thread's project, which is what the pull request is read through on the host. */
+  project: EnvironmentProject | null;
+  label: string;
+  openAriaLabel: string;
+  onOpen: (event: ReactMouseEvent<HTMLElement>) => void;
+  /** An action changed the pull request on the host, so the vcs status behind the row is stale. */
+  onActed?: () => void;
+}) {
+  const serverConfigs = useServerConfigs();
+  const supportsPullRequests =
+    serverConfigs.get(environmentId)?.environment.capabilities.pullRequests === true;
+  // The identity's own spelling, the way the detail panel is addressed everywhere else.
+  const identity = project?.repositoryIdentity;
+  const repository =
+    identity?.displayName ??
+    (identity?.owner && identity.name ? `${identity.owner}/${identity.name}` : null);
+  const reference: PullRequestRef | null =
+    supportsPullRequests && project !== null && repository !== null
+      ? { projectId: project.id as ProjectId, repository, number: pr.number }
+      : null;
+  const detailQuery = useEnvironmentQuery(
+    reference === null ? null : pullRequestEnvironment.detail({ environmentId, input: reference }),
+  );
+  const detail = detailQuery.data ?? null;
+
+  const { actionPending, perform } = usePullRequestActionRunner({
+    environmentId,
+    reference,
+    onSuccess: () => {
+      detailQuery.refresh();
+      onActed?.();
+    },
+  });
+  const { handoff, startHandoff } = usePullRequestHandoffs({ environmentId, detail });
+  const [confirmingMerge, setConfirmingMerge] = useState(false);
+
+  const rowAction = resolveThreadPanelPullRequestAction(detail);
+  const conflicting = isPullRequestConflicting(detail);
+  const checksState = detail === null ? "none" : classifyPullRequestChecks(detail.checks);
+  const checksRunning = detail?.state === "open" && rowAction === null && checksState === "pending";
+  const selectedMergeMethod = resolveSelectedMergeMethod(
+    allowedPullRequestMergeMethods(detail),
+    "merge",
+  );
+
+  const startResolveConflicts = () => {
+    if (detail === null) return;
+    void startHandoff("conflicts", {
+      prompt: buildResolveConflictsPrompt({
+        number: detail.number,
+        url: detail.url,
+        headBranch: detail.headBranch,
+        baseBranch: detail.baseBranch,
+      }),
+    });
+  };
+
+  const startFixChecks = () => {
+    if (detail === null) return;
+    // The compact row fetches no conversation, so the handoff carries the failing checks alone;
+    // review threads keep arriving through the full panel's richer version of this action.
+    void startHandoff(
+      "findings",
+      buildFixFindingsHandoff({
+        number: detail.number,
+        title: detail.title,
+        url: detail.url,
+        headBranch: detail.headBranch,
+        baseBranch: detail.baseBranch,
+        reviewThreads: [],
+        comments: [],
+        checks: detail.checks,
+        commentsTruncated: false,
+      }),
+    );
+  };
+
+  // Once the host has answered, the glyph knows about drafts and conflicts, which the vcs
+  // summary does not. Draft outranks conflicts in it, same as the detail panel.
+  const statePresentation =
+    detail === null
+      ? null
+      : resolvePullRequestState({
+          state: detail.state,
+          isDraft: detail.isDraft,
+          mergeability: detail.mergeability,
+          baseBranch: detail.baseBranch,
+        });
+  const icon = statePresentation ? (
+    <statePresentation.Icon
+      aria-hidden
+      className={cn("-mx-0.5 size-4 shrink-0", statePresentation.toneClassName)}
+    />
+  ) : (
+    <ChangeRequestStatusIcon className={cn(THREAD_DETAILS_PANEL_ICON_CLASS, status.colorClass)} />
+  );
+
+  // Everything the host reported, at a glance. The row stays one line; the tooltip is where the
+  // rest of the answer lives — styled like the sidebar's thread tooltip, title above icon-led
+  // detail rows, so the two read as one family.
+  const rowTooltip =
+    detail === null || statePresentation === null ? (
+      <TooltipPopup side="top">{status.tooltip}</TooltipPopup>
+    ) : (
+      <TooltipPopup
+        side="top"
+        align="start"
+        sideOffset={4}
+        variant="glass"
+        className="max-w-80 text-left whitespace-normal [&_[data-slot=tooltip-viewport]]:p-0"
+      >
+        <div className="flex min-w-0 max-w-80 flex-col gap-2 p-[var(--floating-content-inset)]">
+          <div className="flex min-w-0 items-baseline gap-1.5 text-xs leading-none">
+            <span className="min-w-0 truncate font-medium text-foreground">{detail.title}</span>
+            <span className="shrink-0 text-muted-foreground">#{detail.number}</span>
+          </div>
+          <div className="grid gap-1.5 pl-0.5 text-xs text-muted-foreground">
+            <div className="flex min-w-0 items-center gap-2">
+              <statePresentation.Icon
+                aria-hidden
+                className={cn("size-3 shrink-0", statePresentation.toneClassName)}
+              />
+              <div className="min-w-0 truncate text-foreground/75">{statePresentation.label}</div>
+            </div>
+            <div className="flex min-w-0 items-center gap-2">
+              <GitBranchIcon className="size-3 shrink-0 stroke-muted-foreground" />
+              <div className="min-w-0 truncate text-foreground/75">
+                {detail.baseBranch} ← {detail.headBranch}
+              </div>
+            </div>
+            {detail.state === "open" && checksState !== "none" ? (
+              <div className="flex min-w-0 items-center gap-2">
+                <PullRequestCheckStatusIcon
+                  status={
+                    checksState === "failing"
+                      ? "failure"
+                      : checksState === "pending"
+                        ? "pending"
+                        : "success"
+                  }
+                />
+                <div className="min-w-0 truncate text-foreground/75">
+                  {describePullRequestChecks(detail.checks)}
+                </div>
+              </div>
+            ) : null}
+            {detail.isDraft && conflicting ? (
+              <div className="flex min-w-0 items-start gap-2 text-destructive">
+                <TriangleAlertIcon aria-hidden className="mt-0.5 size-3 shrink-0 stroke-current" />
+                <div className="min-w-0 flex-1 wrap-break-word leading-5">
+                  Merge conflicts with {detail.baseBranch}
+                </div>
+              </div>
+            ) : null}
+            <div className="flex min-w-0 items-center gap-2">
+              <FileDiffIcon className="size-3 shrink-0 stroke-muted-foreground" />
+              <div className="min-w-0 flex items-baseline gap-1 truncate text-foreground/75">
+                {detail.changedFiles.toLocaleString()}{" "}
+                {detail.changedFiles === 1 ? "file" : "files"}
+                <PullRequestDiffStat additions={detail.additions} deletions={detail.deletions} />
+              </div>
+            </div>
+          </div>
+        </div>
+      </TooltipPopup>
+    );
+
+  const trailingAction =
+    rowAction === "resolve"
+      ? {
+          label: "Resolve",
+          pendingLabel: "Preparing...",
+          pending: handoff === "conflicts",
+          destructive: true,
+          suffix: <ArrowUpRightIcon aria-hidden className="size-3 shrink-0" />,
+          tooltip: "Check the branch out and resolve the conflicts in a new thread",
+          onClick: startResolveConflicts,
+        }
+      : rowAction === "ready"
+        ? {
+            label: "Ready",
+            pendingLabel: "Marking...",
+            pending: actionPending,
+            destructive: false,
+            suffix: null,
+            tooltip: "Mark this pull request as ready for review",
+            onClick: () => void perform("ready"),
+          }
+        : rowAction === "fix"
+          ? {
+              label: "Fix",
+              pendingLabel: "Preparing...",
+              pending: handoff === "findings",
+              destructive: true,
+              suffix: <ArrowUpRightIcon aria-hidden className="size-3 shrink-0" />,
+              tooltip: "Fix the failing checks in a new thread",
+              onClick: startFixChecks,
+            }
+          : rowAction === "merge"
+            ? {
+                label: "Merge",
+                pendingLabel: "Merging...",
+                pending: actionPending,
+                destructive: false,
+                suffix: null,
+                tooltip: `Merge this pull request (${selectedMergeMethod})`,
+                onClick: () => setConfirmingMerge(true),
+              }
+            : null;
+
+  const rowContent = (
+    <>
+      {icon}
+      <span className="min-w-0 flex-1 truncate text-left">{label}</span>
+    </>
+  );
+
+  return (
+    <>
+      {trailingAction || checksRunning ? (
+        <div className={THREAD_DETAILS_PANEL_LINK_SPLIT_GROUP_CLASS}>
+          <Tooltip>
+            <TooltipTrigger
+              render={
+                <Button
+                  type="button"
+                  variant="ghost"
+                  size="sm"
+                  className={THREAD_DETAILS_PANEL_LINK_SPLIT_PRIMARY_CLASS}
+                  aria-label={openAriaLabel}
+                  onClick={onOpen}
+                />
+              }
+            >
+              {rowContent}
+            </TooltipTrigger>
+            {rowTooltip}
+          </Tooltip>
+          <span aria-hidden="true" className={THREAD_DETAILS_PANEL_SPLIT_SEPARATOR_CLASS} />
+          {trailingAction ? (
+            <Tooltip>
+              <TooltipTrigger
+                render={
+                  <Button
+                    type="button"
+                    variant="ghost"
+                    size="sm"
+                    className={cn(
+                      THREAD_DETAILS_PANEL_LINK_SPLIT_ACTION_CLASS,
+                      trailingAction.destructive &&
+                        "text-destructive hover:text-destructive data-pressed:text-destructive",
+                    )}
+                    disabled={actionPending || handoff !== null}
+                    onClick={trailingAction.onClick}
+                  />
+                }
+              >
+                {trailingAction.pending ? trailingAction.pendingLabel : trailingAction.label}
+                {trailingAction.suffix}
+              </TooltipTrigger>
+              <TooltipPopup side="top">{trailingAction.tooltip}</TooltipPopup>
+            </Tooltip>
+          ) : (
+            // Checks are still running: the slot reports that instead of offering a merge that
+            // would race them. Not a button — there is nothing to press until they finish.
+            <Tooltip>
+              <TooltipTrigger
+                render={
+                  <span className="flex h-9 shrink-0 cursor-default items-center gap-1.5 px-2.5 text-[13px] font-medium text-muted-foreground" />
+                }
+              >
+                <PullRequestCheckStatusIcon status="pending" />
+                <span className="tabular-nums">
+                  {detail === null
+                    ? null
+                    : `${detail.checks.filter((check) => check.status === "pending").length}/${detail.checks.length}`}
+                </span>
+              </TooltipTrigger>
+              <TooltipPopup side="top">
+                {detail ? describePullRequestChecks(detail.checks) : "Checks are running"}
+              </TooltipPopup>
+            </Tooltip>
+          )}
+        </div>
+      ) : (
+        <Tooltip>
+          <TooltipTrigger
+            render={
+              <Button
+                type="button"
+                variant="ghost"
+                size="sm"
+                className={THREAD_DETAILS_PANEL_ROW_CLASS}
+                aria-label={openAriaLabel}
+                onClick={onOpen}
+              />
+            }
+          >
+            {rowContent}
+          </TooltipTrigger>
+          {rowTooltip}
+        </Tooltip>
+      )}
+      {rowAction === "merge" ? (
+        <AlertDialog open={confirmingMerge} onOpenChange={(open) => setConfirmingMerge(open)}>
+          <AlertDialogPopup>
+            <AlertDialogHeader>
+              <AlertDialogTitle>Merge pull request?</AlertDialogTitle>
+              <AlertDialogDescription>
+                This merges #{pr.number} using {selectedMergeMethod}.
+              </AlertDialogDescription>
+            </AlertDialogHeader>
+            <AlertDialogFooter>
+              <AlertDialogClose render={<Button variant="outline" size="sm" />}>
+                Cancel
+              </AlertDialogClose>
+              <Button
+                size="sm"
+                disabled={actionPending}
+                onClick={() => {
+                  setConfirmingMerge(false);
+                  void perform("merge", selectedMergeMethod);
+                }}
+              >
+                Merge
+              </Button>
+            </AlertDialogFooter>
+          </AlertDialogPopup>
+        </AlertDialog>
+      ) : null}
+    </>
+  );
+}
diff --git a/apps/web/src/components/chat/ThreadRelationshipsControl.test.tsx b/apps/web/src/components/chat/ThreadRelationshipsControl.test.tsx
new file mode 100644
index 000000000000..2d4ea8cc1f56
--- /dev/null
+++ b/apps/web/src/components/chat/ThreadRelationshipsControl.test.tsx
@@ -0,0 +1,49 @@
+import { describe, expect, it } from "vite-plus/test";
+import { renderToStaticMarkup } from "react-dom/server";
+
+import { resolveThreadLineageWindow, ThreadLineageRowList } from "./ThreadRelationshipsControl";
+
+const rows = Array.from({ length: 20 }, (_, index) => `row-${index}`);
+
+function renderRowList(visibleCount: number) {
+  const { visibleRows, hiddenCount } = resolveThreadLineageWindow(rows, visibleCount);
+  return renderToStaticMarkup(
+    <ThreadLineageRowList hiddenCount={hiddenCount} onShowMore={() => {}}>
+      {visibleRows.map((row) => (
+        <li key={row}>{row}</li>
+      ))}
+    </ThreadLineageRowList>,
+  );
+}
+
+describe("thread lineage row list", () => {
+  it("shows six rows before the first expansion", () => {
+    const { visibleRows, hiddenCount } = resolveThreadLineageWindow(rows, 6);
+
+    expect(visibleRows).toEqual(rows.slice(0, 6));
+    expect(hiddenCount).toBe(14);
+  });
+
+  it("offers one page at a time", () => {
+    expect(renderRowList(6)).toContain("Show 12 more");
+    expect(renderRowList(6 + 12)).toContain("Show 2 more");
+  });
+
+  it("omits the expansion affordance when everything fits", () => {
+    const markup = renderRowList(rows.length);
+
+    expect(markup).not.toContain("more");
+    expect(resolveThreadLineageWindow(rows.slice(0, 6), 6).hiddenCount).toBe(0);
+  });
+
+  it("keeps the rows in a bounded, labelled scroll region and the button outside it", () => {
+    const markup = renderRowList(6);
+    const list = /<ul([^>]*)>/.exec(markup)?.[1] ?? "";
+
+    expect(list).toContain('aria-label="Related threads"');
+    expect(list).toContain("max-h-[13.5rem]");
+    expect(list).toContain("overflow-y-auto");
+    expect(list).toContain("overscroll-contain");
+    expect(markup.indexOf("</ul>")).toBeLessThan(markup.indexOf("<button"));
+  });
+});
diff --git a/apps/web/src/components/chat/ThreadRelationshipsControl.tsx b/apps/web/src/components/chat/ThreadRelationshipsControl.tsx
new file mode 100644
index 000000000000..f2685bc92cad
--- /dev/null
+++ b/apps/web/src/components/chat/ThreadRelationshipsControl.tsx
@@ -0,0 +1,373 @@
+import { scopedThreadKey, scopeThreadRef } from "@t3tools/client-runtime/environment";
+import {
+  deriveThreadRelationshipGraph,
+  immediateThreadRelationships,
+  isParentThreadRelationship,
+  orderWebThreadLineageRows,
+  resolveMergeBackTargetThreadId,
+  type ThreadRelationshipEdge,
+} from "@t3tools/client-runtime/state/thread-relationships";
+import {
+  canDetachThreadProviderSession,
+  resolveLatestMergeBackRun,
+} from "@t3tools/client-runtime/state/thread-workflows";
+import type { EnvironmentId, OrchestrationV2ThreadShell, ThreadId } from "@t3tools/contracts";
+import { useNavigate } from "@tanstack/react-router";
+import {
+  ArrowRightIcon,
+  BotIcon,
+  CornerLeftUpIcon,
+  GitForkIcon,
+  GitMergeIcon,
+  LoaderCircleIcon,
+  MoreHorizontalIcon,
+  PlusIcon,
+  UnplugIcon,
+} from "lucide-react";
+import { useCallback, useMemo, useRef, useState, type ReactNode } from "react";
+
+import { useArchivedThreadSnapshots } from "../../lib/archivedThreadsState";
+import { buildThreadRouteParams } from "../../threadRoutes";
+import { useThreadProjection, useThreadShells } from "../../state/entities";
+import { threadEnvironment } from "../../state/threads";
+import { useAtomCommand } from "../../state/use-atom-command";
+import { cn } from "../../lib/utils";
+import { Button } from "../ui/button";
+import { Menu, MenuItem, MenuPopup, MenuTrigger } from "../ui/menu";
+import { Tooltip, TooltipPopup, TooltipTrigger } from "../ui/tooltip";
+import {
+  THREAD_DETAILS_PANEL_ICON_ACTION_CLASS,
+  THREAD_DETAILS_PANEL_LINK_ROW_CLASS,
+  THREAD_DETAILS_PANEL_LINK_SPLIT_GROUP_CLASS,
+  THREAD_DETAILS_PANEL_LINK_SPLIT_PRIMARY_CLASS,
+  THREAD_DETAILS_PANEL_LINK_SPLIT_SECONDARY_CLASS,
+  THREAD_DETAILS_PANEL_MENU_POPUP_CLASS,
+  THREAD_DETAILS_PANEL_SPLIT_SEPARATOR_CLASS,
+} from "./threadDetailsPanelStyles";
+
+const THREAD_RELATIONSHIP_ICON_CLASS = "size-4 shrink-0 text-muted-foreground";
+
+// Lineage paging: a busy thread can accumulate dozens of forks and subagents,
+// and the panel it lives in already scrolls. Show a workable window, keep the
+// rest behind Show more, and bound what is shown so the sections below Lineage
+// stay reachable.
+const THREAD_LINEAGE_INITIAL_COUNT = 6;
+const THREAD_LINEAGE_PAGE_COUNT = 12;
+
+export function resolveThreadLineageWindow<Row>(
+  rows: ReadonlyArray<Row>,
+  visibleCount: number,
+): { readonly visibleRows: ReadonlyArray<Row>; readonly hiddenCount: number } {
+  const visibleRows = rows.slice(0, visibleCount);
+  return { visibleRows, hiddenCount: rows.length - visibleRows.length };
+}
+
+export function ThreadLineageRowList(props: {
+  readonly hiddenCount: number;
+  readonly onShowMore: () => void;
+  readonly children: ReactNode;
+}) {
+  return (
+    <>
+      {/*
+        Bounded rather than free-growing so Lineage cannot push the rest of the
+        thread details panel out of view. Plain overflow, not a ScrollArea
+        component: this sits inside an already scrolling panel, where a
+        max-height-only virtual viewport measures badly. Every row is a focusable
+        button, so keyboard users reach and scroll the region through the rows
+        themselves and the container needs no extra tab stop of its own.
+      */}
+      <ul
+        aria-label="Related threads"
+        className="m-0 max-h-[13.5rem] list-none overflow-y-auto overscroll-contain p-0"
+      >
+        {props.children}
+      </ul>
+      {props.hiddenCount > 0 ? (
+        <button
+          type="button"
+          onClick={props.onShowMore}
+          className="flex h-9 w-full cursor-pointer items-center gap-2.5 rounded-lg px-2.5 text-left text-[13px] font-medium text-muted-foreground/70 hover:bg-black/[0.055] hover:text-foreground/80 dark:hover:bg-white/[0.075]"
+        >
+          <PlusIcon aria-hidden className="-mx-0.5 size-4 shrink-0" />
+          Show {Math.min(props.hiddenCount, THREAD_LINEAGE_PAGE_COUNT)} more
+        </button>
+      ) : null}
+    </>
+  );
+}
+
+function relationshipLabel(edge: ThreadRelationshipEdge, currentThreadId: ThreadId) {
+  if (edge.kind === "transfer") return "Context transfer";
+  if (edge.kind === "subagent") {
+    return edge.sourceThreadId === currentThreadId ? "Subagent" : "Parent agent";
+  }
+  return edge.sourceThreadId === currentThreadId ? "Fork" : "Parent thread";
+}
+
+function statusDotClass(status: string | null): string {
+  if (status === "running" || status === "in_progress") return "bg-info";
+  if (status === "failed" || status === "error") return "bg-destructive";
+  if (status === "completed") return "bg-success";
+  return "bg-muted-foreground/45";
+}
+
+function relationshipThreadTitle(input: {
+  readonly title: string;
+  readonly isSubagent: boolean;
+}): string {
+  if (!input.isSubagent) return input.title;
+  return input.title.replace(/^Subagent:\s*/i, "");
+}
+
+export function ThreadRelationshipsPanel(props: {
+  readonly environmentId: EnvironmentId;
+  readonly threadId: ThreadId;
+}) {
+  const ref = scopeThreadRef(props.environmentId, props.threadId);
+  const projection = useThreadProjection(ref)?.projection ?? null;
+  const threadShells = useThreadShells();
+  const archived = useArchivedThreadSnapshots([props.environmentId]);
+  const archivedShells = archived.snapshots.find(
+    (entry) => entry.environmentId === props.environmentId,
+  )?.snapshot.threads;
+  const graph = useMemo(() => {
+    const shells: ReadonlyArray<OrchestrationV2ThreadShell> = [
+      ...threadShells
+        .filter((thread) => thread.environmentId === props.environmentId)
+        .map((thread) => thread.source),
+      ...(archivedShells ?? []),
+    ];
+    return deriveThreadRelationshipGraph({ threads: shells, projection });
+  }, [archivedShells, projection, props.environmentId, threadShells]);
+  const navigate = useNavigate();
+  const mergeBack = useAtomCommand(threadEnvironment.mergeBack);
+  const stopSession = useAtomCommand(threadEnvironment.stopSession);
+  const [busyAction, setBusyAction] = useState<"merge" | "detach" | null>(null);
+  const latestMergeBackRun = projection === null ? null : resolveLatestMergeBackRun(projection);
+  const mergeTargetThreadId = resolveMergeBackTargetThreadId(projection);
+  const relationshipRows = useMemo(
+    () =>
+      orderWebThreadLineageRows({
+        graph,
+        rows: immediateThreadRelationships(graph, props.threadId),
+        currentThreadId: props.threadId,
+        mergeTargetThreadId,
+      }),
+    [graph, mergeTargetThreadId, props.threadId],
+  );
+  const canMerge = mergeTargetThreadId !== null && latestMergeBackRun !== null;
+  const canDetach = projection ? canDetachThreadProviderSession(projection) : false;
+
+  const [visibleCount, setVisibleCount] = useState(THREAD_LINEAGE_INITIAL_COUNT);
+  const lineageResetKey = scopedThreadKey(ref);
+  const lastLineageResetKeyRef = useRef(lineageResetKey);
+  if (lastLineageResetKeyRef.current !== lineageResetKey) {
+    lastLineageResetKeyRef.current = lineageResetKey;
+    setVisibleCount(THREAD_LINEAGE_INITIAL_COUNT);
+  }
+  const showMore = useCallback(
+    () => setVisibleCount((count) => count + THREAD_LINEAGE_PAGE_COUNT),
+    [],
+  );
+  const { visibleRows, hiddenCount } = resolveThreadLineageWindow(relationshipRows, visibleCount);
+
+  if (relationshipRows.length === 0) {
+    return null;
+  }
+
+  const openThread = (threadId: ThreadId) => {
+    void navigate({
+      to: "/$environmentId/$threadId",
+      params: buildThreadRouteParams(scopeThreadRef(props.environmentId, threadId)),
+    });
+  };
+
+  const merge = async () => {
+    if (!latestMergeBackRun || mergeTargetThreadId === null || busyAction !== null) return;
+    setBusyAction("merge");
+    const result = await mergeBack({
+      environmentId: props.environmentId,
+      input: {
+        sourceThreadId: props.threadId,
+        targetThreadId: mergeTargetThreadId,
+        runId: latestMergeBackRun.id,
+      },
+    });
+    setBusyAction(null);
+    if (result._tag === "Success") openThread(mergeTargetThreadId);
+  };
+
+  const detach = async () => {
+    if (!canDetach || busyAction !== null) return;
+    setBusyAction("detach");
+    await stopSession({
+      environmentId: props.environmentId,
+      input: { threadId: props.threadId },
+    });
+    setBusyAction(null);
+  };
+
+  const parentTitle =
+    mergeTargetThreadId === null
+      ? null
+      : (graph.nodes.get(mergeTargetThreadId)?.thread?.title ?? null);
+
+  return (
+    <section
+      aria-labelledby="thread-details-lineage-heading"
+      className="border-t border-border/65 px-2 pb-2.5 pt-2"
+      data-thread-relationships-panel
+    >
+      <div className="mb-1 flex min-h-8 items-center justify-between gap-2 px-2">
+        <h3
+          id="thread-details-lineage-heading"
+          className="text-[11px] font-medium text-muted-foreground"
+        >
+          Lineage
+        </h3>
+        <div className="flex shrink-0 items-center gap-1">
+          {canDetach ? (
+            <Menu>
+              <MenuTrigger
+                render={
+                  <Button
+                    size="icon-xs"
+                    variant="ghost"
+                    className={THREAD_DETAILS_PANEL_ICON_ACTION_CLASS}
+                    aria-label="More thread actions"
+                    disabled={busyAction !== null}
+                  />
+                }
+              >
+                <MoreHorizontalIcon className="size-3.5" />
+              </MenuTrigger>
+              <MenuPopup align="end" className={THREAD_DETAILS_PANEL_MENU_POPUP_CLASS}>
+                <MenuItem onClick={() => void detach()}>
+                  <UnplugIcon className="size-3.5" />
+                  Disconnect agent session
+                </MenuItem>
+              </MenuPopup>
+            </Menu>
+          ) : null}
+        </div>
+      </div>
+
+      <ThreadLineageRowList hiddenCount={hiddenCount} onShowMore={showMore}>
+        {visibleRows.map(({ threadId, edge }) => {
+          const node = graph.nodes.get(threadId);
+          const isSubagent = edge.kind === "subagent";
+          const isMergeTarget = threadId === mergeTargetThreadId;
+          const isParent = isParentThreadRelationship(edge, props.threadId);
+          const RelationshipIcon = isParent ? CornerLeftUpIcon : isSubagent ? BotIcon : GitForkIcon;
+          const relationship = relationshipLabel(edge, props.threadId);
+          const threadTitle = relationshipThreadTitle({
+            title: node?.thread?.title ?? threadId,
+            isSubagent,
+          });
+          const relationshipContent = (
+            <>
+              <span className="relative -mx-0.5 grid size-4 shrink-0 place-items-center">
+                <RelationshipIcon className={THREAD_RELATIONSHIP_ICON_CLASS} />
+                <span
+                  className={cn(
+                    "absolute -bottom-1 -right-1 size-2 rounded-full border-2 border-card",
+                    statusDotClass(edge.status),
+                  )}
+                  aria-hidden="true"
+                />
+              </span>
+              <span className="min-w-0 flex-1">
+                <span className="block truncate text-[13px] font-medium leading-4 text-foreground/85">
+                  {threadTitle}
+                </span>
+              </span>
+              <ArrowRightIcon className="size-3 shrink-0 text-muted-foreground opacity-0 transition-opacity group-hover:opacity-100" />
+            </>
+          );
+          return (
+            <li key={threadId} className="group flex h-9 items-center rounded-lg">
+              {isMergeTarget ? (
+                <div className={THREAD_DETAILS_PANEL_LINK_SPLIT_GROUP_CLASS}>
+                  <Tooltip>
+                    <TooltipTrigger
+                      render={
+                        <Button
+                          size="sm"
+                          variant="ghost"
+                          className={THREAD_DETAILS_PANEL_LINK_SPLIT_PRIMARY_CLASS}
+                          disabled={node?.missing === true}
+                          onClick={() => openThread(threadId)}
+                        />
+                      }
+                    >
+                      {relationshipContent}
+                    </TooltipTrigger>
+                    <TooltipPopup side="left">
+                      {node?.missing
+                        ? "This related thread is unavailable"
+                        : `Open ${relationship.toLowerCase()} in this chat`}
+                    </TooltipPopup>
+                  </Tooltip>
+                  <span aria-hidden="true" className={THREAD_DETAILS_PANEL_SPLIT_SEPARATOR_CLASS} />
+                  <Tooltip>
+                    <TooltipTrigger
+                      render={
+                        <Button
+                          size="sm"
+                          variant="ghost"
+                          className={THREAD_DETAILS_PANEL_LINK_SPLIT_SECONDARY_CLASS}
+                          aria-label={
+                            parentTitle
+                              ? `Merge back to ${parentTitle}`
+                              : "Merge back to source conversation"
+                          }
+                          disabled={!canMerge || busyAction !== null}
+                          onClick={() => void merge()}
+                        >
+                          {busyAction === "merge" ? (
+                            <LoaderCircleIcon className="size-3 animate-spin" />
+                          ) : (
+                            <GitMergeIcon className="size-3" />
+                          )}
+                        </Button>
+                      }
+                    />
+                    <TooltipPopup side="left">
+                      {latestMergeBackRun === null
+                        ? "Complete a run in this fork before merging it back"
+                        : parentTitle
+                          ? `Merge this conversation back into ${parentTitle}`
+                          : "Merge this conversation back into its source"}
+                    </TooltipPopup>
+                  </Tooltip>
+                </div>
+              ) : (
+                <Tooltip>
+                  <TooltipTrigger
+                    render={
+                      <Button
+                        size="sm"
+                        variant="ghost"
+                        disabled={node?.missing === true}
+                        onClick={() => openThread(threadId)}
+                        className={THREAD_DETAILS_PANEL_LINK_ROW_CLASS}
+                      />
+                    }
+                  >
+                    {relationshipContent}
+                  </TooltipTrigger>
+                  <TooltipPopup side="left">
+                    {node?.missing
+                      ? "This related thread is unavailable"
+                      : `Open ${relationship.toLowerCase()} in this chat`}
+                  </TooltipPopup>
+                </Tooltip>
+              )}
+            </li>
+          );
+        })}
+      </ThreadLineageRowList>
+    </section>
+  );
+}
diff --git a/apps/web/src/components/chat/TimelineSystemDivider.tsx b/apps/web/src/components/chat/TimelineSystemDivider.tsx
new file mode 100644
index 000000000000..d5a5823c0b91
--- /dev/null
+++ b/apps/web/src/components/chat/TimelineSystemDivider.tsx
@@ -0,0 +1,60 @@
+import type { ReactNode } from "react";
+import type { LucideIcon } from "lucide-react";
+
+import { cn } from "~/lib/utils";
+import { Tooltip, TooltipPopup, TooltipTrigger } from "~/components/ui/tooltip";
+
+export function TimelineSystemDivider(props: {
+  readonly label: string;
+  readonly detail?: ReactNode | null;
+  readonly tone?: "neutral" | "danger";
+  readonly icon?: LucideIcon;
+  readonly showDetailSeparator?: boolean;
+  readonly actionLabel?: string;
+  readonly onAction?: () => void;
+}) {
+  const Icon = props.icon;
+  const content = (
+    <>
+      {Icon ? <Icon className="size-3 shrink-0" /> : null}
+      <span className="font-medium">{props.label}</span>
+      {props.detail ? (
+        <span className="inline-flex min-w-0 max-w-80 items-center truncate opacity-70">
+          {props.showDetailSeparator === false ? null : "·\u00a0"}
+          {props.detail}
+        </span>
+      ) : null}
+    </>
+  );
+
+  return (
+    <div
+      className={cn(
+        "flex min-w-0 items-center gap-2 py-2 text-[11px] text-muted-foreground",
+        props.tone === "danger" && "text-destructive",
+      )}
+    >
+      <span aria-hidden="true" className="h-px flex-1 bg-border/70" />
+      {props.onAction ? (
+        <Tooltip>
+          <TooltipTrigger
+            render={
+              <button
+                type="button"
+                aria-label={props.actionLabel}
+                onClick={props.onAction}
+                className="flex min-w-0 items-center gap-1.5 rounded-full border border-border/70 bg-background px-2.5 py-1 transition-colors hover:bg-muted"
+              />
+            }
+          >
+            {content}
+          </TooltipTrigger>
+          <TooltipPopup side="top">{props.actionLabel}</TooltipPopup>
+        </Tooltip>
+      ) : (
+        <span className="flex min-w-0 items-center gap-1.5 rounded-full px-2 py-1">{content}</span>
+      )}
+      <span aria-hidden="true" className="h-px flex-1 bg-border/70" />
+    </div>
+  );
+}
diff --git a/apps/web/src/components/chat/V2ItemInspector.tsx b/apps/web/src/components/chat/V2ItemInspector.tsx
new file mode 100644
index 000000000000..4b71a6f1990d
--- /dev/null
+++ b/apps/web/src/components/chat/V2ItemInspector.tsx
@@ -0,0 +1,312 @@
+import type {
+  EnvironmentId,
+  OrchestrationV2ProjectedTurnItem,
+  RunId,
+  ThreadId,
+} from "@t3tools/contracts";
+import { ExternalLinkIcon, GitBranchIcon, RotateCcwIcon } from "lucide-react";
+import { memo, type ReactNode } from "react";
+
+import { useV2ItemSupport } from "../../state/v2ItemSupport";
+import { formatWorkspaceRelativePath } from "../../filePathDisplay";
+import { Button } from "../ui/button";
+import ChatMarkdown from "../ChatMarkdown";
+import { resolveExternalWebLinkHref } from "./externalLinkContextMenu";
+
+interface V2ItemInspectorProps {
+  readonly projectedItem: OrchestrationV2ProjectedTurnItem;
+  readonly environmentId: EnvironmentId;
+  readonly cwd?: string | undefined;
+  readonly workspaceRoot?: string | undefined;
+  readonly onOpenThread: (threadId: ThreadId) => void;
+  readonly onOpenTurnDiff: (runId: RunId, filePath?: string) => void;
+  readonly onRollbackCheckpoint?: (input: {
+    readonly checkpointId: string;
+    readonly scopeId: string;
+  }) => void;
+}
+
+function durationLabel(startedAt: unknown, completedAt: unknown): string | null {
+  if (startedAt == null) return null;
+  const start = Date.parse(String(startedAt));
+  const end = completedAt == null ? Date.now() : Date.parse(String(completedAt));
+  if (!Number.isFinite(start) || !Number.isFinite(end)) return null;
+  const milliseconds = Math.max(0, end - start);
+  if (milliseconds < 1_000) return `${milliseconds}ms`;
+  if (milliseconds < 60_000) return `${(milliseconds / 1_000).toFixed(1)}s`;
+  return `${Math.floor(milliseconds / 60_000)}m ${Math.floor((milliseconds % 60_000) / 1_000)}s`;
+}
+
+function DataField(props: { readonly label: string; readonly children: ReactNode }) {
+  return (
+    <div className="min-w-0">
+      <dt className="text-[10px] font-medium tracking-wide uppercase text-muted-foreground/65">
+        {props.label}
+      </dt>
+      <dd className="mt-0.5 min-w-0 break-words font-mono text-[11px] text-foreground/80">
+        {props.children}
+      </dd>
+    </div>
+  );
+}
+
+function StructuredValue({ value }: { readonly value: unknown }) {
+  const text = typeof value === "string" ? value : JSON.stringify(value, null, 2);
+  if (!text) return null;
+  return (
+    <pre className="max-h-80 overflow-auto whitespace-pre-wrap break-words rounded-md border border-border/50 bg-background/60 p-2 font-mono text-[11px] leading-relaxed text-muted-foreground select-text">
+      {text}
+    </pre>
+  );
+}
+
+export const V2ItemInspector = memo(function V2ItemInspector(props: V2ItemInspectorProps) {
+  const { item } = props.projectedItem;
+  const support = useV2ItemSupport({
+    environmentId: props.environmentId,
+    sourceThreadId: props.projectedItem.sourceThreadId,
+    sourceItemId: props.projectedItem.sourceItemId,
+  });
+  const duration = durationLabel(item.startedAt, item.completedAt);
+  const latestAttempt = support.attempts.at(-1) ?? null;
+  const runtimeRequest = support.runtimeRequest;
+
+  return (
+    <div className="space-y-2 text-xs" data-v2-item-inspector={item.type}>
+      <dl className="grid grid-cols-2 gap-x-4 gap-y-2 rounded-md border border-border/45 bg-muted/15 p-2 sm:grid-cols-3">
+        <DataField label="Item">{item.type}</DataField>
+        <DataField label="Status">{item.status}</DataField>
+        {duration ? <DataField label="Duration">{duration}</DataField> : null}
+        {support.run ? <DataField label="Run">{support.run.status}</DataField> : null}
+        {latestAttempt ? (
+          <DataField label="Attempt">
+            {latestAttempt.attemptOrdinal} · {latestAttempt.status} · {latestAttempt.reason}
+          </DataField>
+        ) : null}
+        {support.node ? (
+          <DataField label="Node">
+            {support.node.kind} · {support.node.status}
+          </DataField>
+        ) : null}
+        {support.providerThread ? (
+          <DataField label="Provider thread">
+            {support.providerThread.providerInstanceId} · {support.providerThread.status}
+          </DataField>
+        ) : null}
+        {support.providerTurn ? (
+          <DataField label="Provider turn">{support.providerTurn.status}</DataField>
+        ) : null}
+        {support.providerSession ? (
+          <DataField label="Session">
+            {support.providerSession.status} · {support.providerSession.model ?? "default model"}
+          </DataField>
+        ) : null}
+        {support.providerSession ? (
+          <DataField label="Working directory">{support.providerSession.cwd}</DataField>
+        ) : null}
+        {runtimeRequest ? (
+          <DataField label="Request">
+            {runtimeRequest.status} · {runtimeRequest.responseCapability.type}
+          </DataField>
+        ) : null}
+      </dl>
+
+      {support.attempts.length > 1 ? (
+        <details className="rounded-md border border-border/45 bg-background/40">
+          <summary className="cursor-pointer px-2 py-1.5 text-[11px] font-medium text-muted-foreground">
+            Attempt history · {support.attempts.length}
+          </summary>
+          <ol className="space-y-1 border-t border-border/45 p-2 font-mono text-[11px] text-muted-foreground">
+            {support.attempts.map((attempt) => (
+              <li key={attempt.id} className="flex items-center justify-between gap-3">
+                <span>
+                  Attempt {attempt.attemptOrdinal} · {attempt.reason.replaceAll("_", " ")}
+                </span>
+                <span>{attempt.status}</span>
+              </li>
+            ))}
+          </ol>
+        </details>
+      ) : null}
+
+      {item.type === "reasoning" && item.text ? (
+        <div className="rounded-md border border-border/45 bg-muted/15 p-2 italic text-muted-foreground">
+          <ChatMarkdown
+            text={item.text}
+            cwd={props.cwd}
+            threadRef={{
+              environmentId: props.environmentId,
+              threadId: props.projectedItem.sourceThreadId,
+            }}
+            lineBreaks
+          />
+        </div>
+      ) : null}
+
+      {item.type === "command_execution" ? (
+        <div className="space-y-2">
+          <StructuredValue value={item.input} />
+          {item.output !== undefined ? <StructuredValue value={item.output} /> : null}
+          {item.exitCode !== undefined ? (
+            <p className={item.exitCode === 0 ? "text-emerald-600" : "text-destructive"}>
+              Process exited with code {item.exitCode}
+            </p>
+          ) : null}
+        </div>
+      ) : null}
+
+      {item.type === "file_change" ? (
+        <div className="flex flex-wrap items-center gap-2">
+          <span className="font-mono text-muted-foreground">
+            {formatWorkspaceRelativePath(item.fileName, props.workspaceRoot)}
+          </span>
+          {item.additions !== undefined || item.deletions !== undefined ? (
+            <span>
+              <span className="text-emerald-600">+{item.additions ?? 0}</span>{" "}
+              <span className="text-destructive">-{item.deletions ?? 0}</span>
+            </span>
+          ) : null}
+          {item.runId !== null ? (
+            <Button
+              size="xs"
+              variant="outline"
+              onClick={() => props.onOpenTurnDiff(item.runId!, item.fileName)}
+            >
+              Open diff
+            </Button>
+          ) : null}
+          {item.diffStr ? <StructuredValue value={item.diffStr} /> : null}
+        </div>
+      ) : null}
+
+      {item.type === "file_search" && item.results ? (
+        <ul className="space-y-1 rounded-md border border-border/45 p-2">
+          {item.results.map((result) => (
+            <li key={JSON.stringify(result)}>
+              <span className="font-mono text-foreground/80">
+                {formatWorkspaceRelativePath(result.fileName, props.workspaceRoot)}
+                {result.line === undefined ? "" : `:${result.line}`}
+                {result.column === undefined ? "" : `:${result.column}`}
+              </span>
+              {result.preview ? (
+                <p className="mt-0.5 whitespace-pre-wrap text-muted-foreground">{result.preview}</p>
+              ) : null}
+            </li>
+          ))}
+        </ul>
+      ) : null}
+
+      {item.type === "web_search" && item.results ? (
+        <ul className="space-y-1.5 rounded-md border border-border/45 p-2">
+          {item.results.map((result) => {
+            const safeHref = resolveExternalWebLinkHref(result.url);
+            return (
+              <li key={JSON.stringify(result)}>
+                {safeHref ? (
+                  <a
+                    href={safeHref}
+                    target="_blank"
+                    rel="noreferrer"
+                    className="inline-flex items-center gap-1 font-medium text-foreground hover:underline"
+                  >
+                    {result.title ?? result.url}
+                    <ExternalLinkIcon className="size-3" />
+                  </a>
+                ) : (
+                  <p className="font-medium text-foreground">
+                    {result.title ?? result.url ?? "Search result"}
+                  </p>
+                )}
+                {result.snippet ? <p className="text-muted-foreground">{result.snippet}</p> : null}
+              </li>
+            );
+          })}
+        </ul>
+      ) : null}
+
+      {item.type === "dynamic_tool" ? (
+        <div className="grid gap-2 sm:grid-cols-2">
+          <div>
+            <p className="mb-1 text-[10px] font-medium tracking-wide uppercase text-muted-foreground">
+              Input
+            </p>
+            <StructuredValue value={item.input} />
+          </div>
+          {item.output !== undefined ? (
+            <div>
+              <p className="mb-1 text-[10px] font-medium tracking-wide uppercase text-muted-foreground">
+                Output
+              </p>
+              <StructuredValue value={item.output} />
+            </div>
+          ) : null}
+        </div>
+      ) : null}
+
+      {item.type === "checkpoint" ? (
+        <div className="flex flex-wrap items-center gap-2">
+          <span className="text-muted-foreground">
+            {support.checkpoint?.status ?? item.status} · {item.files.length} files
+          </span>
+          {props.onRollbackCheckpoint && support.checkpoint?.status === "ready" ? (
+            <Button
+              size="xs"
+              variant="outline"
+              onClick={() =>
+                props.onRollbackCheckpoint?.({
+                  checkpointId: item.checkpointId,
+                  scopeId: item.scopeId,
+                })
+              }
+            >
+              <RotateCcwIcon className="size-3" />
+              Roll back
+            </Button>
+          ) : null}
+        </div>
+      ) : null}
+
+      {item.type === "fork" ? (
+        <Button size="xs" variant="outline" onClick={() => props.onOpenThread(item.targetThreadId)}>
+          <GitBranchIcon className="size-3" />
+          Open fork
+        </Button>
+      ) : null}
+
+      {item.type === "subagent" && item.childThreadId !== null ? (
+        <Button size="xs" variant="outline" onClick={() => props.onOpenThread(item.childThreadId!)}>
+          Open subagent thread
+        </Button>
+      ) : null}
+
+      {item.type === "handoff" ? (
+        <div className="space-y-1 rounded-md border border-border/45 p-2 text-muted-foreground">
+          <p>
+            {item.fromProviderInstanceIds.join(", ")} → {item.toProviderInstanceId}
+          </p>
+          <p>
+            {item.strategy.replaceAll("_", " ")} · {support.contextHandoff?.status ?? item.status}
+          </p>
+          {support.contextTransfer ? (
+            <p>
+              Transfer {support.contextTransfer.type.replaceAll("_", " ")} ·{" "}
+              {support.contextTransfer.status}
+            </p>
+          ) : null}
+        </div>
+      ) : null}
+
+      <details
+        className="group/raw rounded-md border border-border/45 bg-background/40"
+        data-v2-structured-details="true"
+      >
+        <summary className="flex cursor-pointer list-none items-center px-2 py-1.5 text-[11px] font-medium text-muted-foreground hover:text-foreground [&::-webkit-details-marker]:hidden">
+          Structured details
+        </summary>
+        <div className="border-t border-border/45 p-2">
+          <StructuredValue value={item} />
+        </div>
+      </details>
+    </div>
+  );
+});
diff --git a/apps/web/src/components/chat/V2LifecycleRow.tsx b/apps/web/src/components/chat/V2LifecycleRow.tsx
new file mode 100644
index 000000000000..079ddc8a62d1
--- /dev/null
+++ b/apps/web/src/components/chat/V2LifecycleRow.tsx
@@ -0,0 +1,358 @@
+import { Fragment } from "react";
+import type {
+  OrchestrationV2Run,
+  OrchestrationV2TurnItem,
+  ProviderInstanceId,
+  ServerProvider,
+  ThreadId,
+} from "@t3tools/contracts";
+import type { TimestampFormat } from "@t3tools/contracts/settings";
+import {
+  ArrowRightLeftIcon,
+  ArrowRightIcon,
+  BotIcon,
+  ChevronDownIcon,
+  ExternalLinkIcon,
+  GitForkIcon,
+  MessageSquareIcon,
+  MinusIcon,
+  type LucideIcon,
+  XIcon,
+} from "lucide-react";
+
+import { getProviderInstanceEntry } from "../../providerInstances";
+import { formatShortTimestamp } from "../../timestampFormat";
+import { PROVIDER_ICON_BY_PROVIDER, getTriggerDisplayModelName } from "./providerIconUtils";
+import { TimelineSystemDivider } from "./TimelineSystemDivider";
+
+const LIFECYCLE_TYPES = new Set<OrchestrationV2TurnItem["type"]>([
+  "run_interrupt_request",
+  "run_interrupt_result",
+  "compaction",
+  "handoff",
+  "fork",
+  "subagent",
+  "thread_created",
+]);
+
+export function isV2LifecycleItem(item: OrchestrationV2TurnItem): boolean {
+  return LIFECYCLE_TYPES.has(item.type);
+}
+
+// Aborted subagents (cancelled/interrupted) keep whatever result text had
+// streamed before the abort, so only completed/failed results are final.
+const FINAL_RESULT_SUBAGENT_STATUSES = new Set<OrchestrationV2TurnItem["status"]>([
+  "completed",
+  "failed",
+]);
+
+// Once a subagent stops, its last streamed result says more than the stale
+// progress line; while it runs, live progress comes first.
+const TERMINAL_SUBAGENT_STATUSES = new Set<OrchestrationV2TurnItem["status"]>([
+  "completed",
+  "failed",
+  "cancelled",
+  "interrupted",
+]);
+
+/**
+ * The subset of a projection run that handoff rows read. Kept minimal so the
+ * timeline can hold a content-stable snapshot: run status/timestamps churn on
+ * every stream event, but these fields only change when a run is added.
+ */
+export type HandoffTimelineRun = Pick<
+  OrchestrationV2Run,
+  "id" | "ordinal" | "providerInstanceId" | "modelSelection"
+>;
+
+export function V2LifecycleRow(props: {
+  readonly item: OrchestrationV2TurnItem;
+  readonly createdAt: string;
+  readonly timestampFormat: TimestampFormat;
+  readonly providerStatuses: ReadonlyArray<ServerProvider>;
+  readonly runs: ReadonlyArray<HandoffTimelineRun>;
+  readonly onOpenThread: (threadId: ThreadId) => void;
+}) {
+  const { item } = props;
+  if (item.type === "run_interrupt_request") {
+    return (
+      <div className="flex justify-end px-1 py-1" data-v2-item-type={item.type}>
+        <div className="flex max-w-[80%] items-center gap-2 text-xs text-destructive">
+          <span aria-hidden="true" className="font-mono">
+            ■
+          </span>
+          <span className="font-medium">Interrupt requested</span>
+          <span aria-hidden="true" className="opacity-50">
+            ·
+          </span>
+          <span className="font-medium">{item.message}</span>
+          <span className="text-[10px] text-muted-foreground">
+            {formatShortTimestamp(props.createdAt, props.timestampFormat)}
+          </span>
+        </div>
+      </div>
+    );
+  }
+  if (item.type === "run_interrupt_result") {
+    return (
+      <TimelineSystemDivider
+        label="Run interrupted"
+        detail={item.message}
+        tone="danger"
+        icon={XIcon}
+      />
+    );
+  }
+  if (item.type === "compaction") {
+    const tokenDetail =
+      item.beforeTokenCount === undefined && item.afterTokenCount === undefined
+        ? null
+        : `${item.beforeTokenCount ?? "?"} → ${item.afterTokenCount ?? "?"} tokens`;
+    return (
+      <TimelineSystemDivider
+        label="Context compacted"
+        detail={item.summary ?? tokenDetail}
+        icon={MinusIcon}
+      />
+    );
+  }
+  if (item.type === "handoff") {
+    // Items persisted before models were stamped only carry instance ids;
+    // recover the models from the thread's runs (the handoff's own run is
+    // the target, the newest earlier run per source instance is the origin).
+    // HandoffEndpoint falls back to the provider display name when neither
+    // source has a model.
+    const handoffRun =
+      item.runId === null ? undefined : props.runs.find((run) => run.id === item.runId);
+    const toModel =
+      item.toModel ??
+      (handoffRun !== undefined && handoffRun.providerInstanceId === item.toProviderInstanceId
+        ? handoffRun.modelSelection.model
+        : undefined);
+    const fromEndpoints: ReadonlyArray<{
+      readonly instanceId: ProviderInstanceId;
+      readonly model?: string | undefined;
+    }> =
+      item.fromModelSelections !== undefined && item.fromModelSelections.length > 0
+        ? item.fromModelSelections
+        : item.fromProviderInstanceIds.map((instanceId) => ({
+            instanceId,
+            model: latestRunModelBefore(props.runs, instanceId, handoffRun?.ordinal),
+          }));
+    return (
+      <TimelineSystemDivider
+        label="Context handoff"
+        icon={ArrowRightLeftIcon}
+        showDetailSeparator={false}
+        tone={item.status === "failed" ? "danger" : "neutral"}
+        detail={
+          <span className="inline-flex min-w-0 items-center gap-1.5">
+            {fromEndpoints.map((endpoint, index) => (
+              <Fragment key={`${endpoint.instanceId}:${endpoint.model ?? ""}`}>
+                {index > 0 ? (
+                  <span aria-hidden="true" className="-ml-1">
+                    ,
+                  </span>
+                ) : null}
+                <HandoffEndpoint
+                  providers={props.providerStatuses}
+                  instanceId={endpoint.instanceId}
+                  model={endpoint.model}
+                />
+              </Fragment>
+            ))}
+            {fromEndpoints.length > 0 ? (
+              <ArrowRightIcon aria-hidden="true" className="size-3 shrink-0" />
+            ) : null}
+            <HandoffEndpoint
+              providers={props.providerStatuses}
+              instanceId={item.toProviderInstanceId}
+              model={toModel}
+            />
+          </span>
+        }
+      />
+    );
+  }
+  if (item.type === "fork") {
+    const relatedThreadId = item.source.type === "run" ? item.source.threadId : item.targetThreadId;
+    return (
+      <TimelineSystemDivider
+        label={item.source.type === "run" ? "Forked from conversation" : "Conversation fork"}
+        icon={GitForkIcon}
+        actionLabel={item.source.type === "run" ? "Open source conversation" : "Open fork"}
+        onAction={() => props.onOpenThread(relatedThreadId)}
+      />
+    );
+  }
+  if (item.type === "thread_created") {
+    return (
+      <RelatedThreadCard
+        itemType={item.type}
+        icon={MessageSquareIcon}
+        title={item.title ?? "Created thread"}
+        detail={`${item.targetProviderInstanceId} · ${item.targetModel}`}
+        badge="created"
+        threadId={item.targetThreadId}
+        onOpenThread={props.onOpenThread}
+      />
+    );
+  }
+  if (item.type === "subagent") {
+    const streamedResult = item.result?.trim() ? item.result : null;
+    const finalResult = FINAL_RESULT_SUBAGENT_STATUSES.has(item.status) ? streamedResult : null;
+    const detail = TERMINAL_SUBAGENT_STATUSES.has(item.status)
+      ? (streamedResult ?? item.progress ?? item.prompt)
+      : (item.progress ?? streamedResult ?? item.prompt);
+    return (
+      <RelatedThreadCard
+        itemType={item.type}
+        icon={BotIcon}
+        title={subagentDisplayTitle(item.title ?? "Subagent")}
+        detail={detail}
+        badge={item.status}
+        threadId={item.childThreadId}
+        expandedDetail={finalResult}
+        onOpenThread={props.onOpenThread}
+      />
+    );
+  }
+  return null;
+}
+
+function RelatedThreadCard(props: {
+  readonly itemType: "subagent" | "thread_created";
+  readonly icon: LucideIcon;
+  readonly title: string;
+  readonly detail: string;
+  readonly expandedDetail?: string | null;
+  readonly badge: string;
+  readonly threadId: ThreadId | null;
+  readonly onOpenThread: (threadId: ThreadId) => void;
+}) {
+  const Icon = props.icon;
+  const threadId = props.threadId;
+  const expandedDetail = props.expandedDetail ?? null;
+  const content = (
+    <>
+      <Icon className="size-3.5 shrink-0 text-muted-foreground" />
+      <span className="min-w-0 flex-1 truncate text-xs font-medium">{props.title}</span>
+      <span className="max-w-[50%] truncate text-xs text-muted-foreground">{props.detail}</span>
+      <span className="rounded-full border border-border/70 px-1.5 py-0.5 font-mono text-[10px] text-muted-foreground">
+        {props.badge}
+      </span>
+    </>
+  );
+
+  if (expandedDetail !== null) {
+    return (
+      <div
+        data-v2-item-type={props.itemType}
+        className="relative min-w-0 overflow-hidden rounded-lg border border-border/60 bg-card/30"
+      >
+        <details className="group" data-v2-subagent-result-disclosure="true">
+          <summary
+            aria-label={`Show full result for ${props.title}`}
+            className="flex min-w-0 cursor-pointer list-none items-center gap-2 px-3 py-2 pr-11 text-left transition-colors hover:bg-muted/50 [&::-webkit-details-marker]:hidden"
+          >
+            {content}
+            <ChevronDownIcon
+              className="size-3 shrink-0 text-muted-foreground transition-transform group-open:rotate-180"
+              aria-hidden="true"
+            />
+          </summary>
+          <div className="border-border/60 border-t px-3 py-2" data-v2-subagent-result="true">
+            <p className="max-h-64 overflow-auto whitespace-pre-wrap break-words text-xs leading-relaxed text-muted-foreground">
+              {expandedDetail}
+            </p>
+          </div>
+        </details>
+        {threadId === null ? null : (
+          <button
+            type="button"
+            aria-label={`Open ${props.title}`}
+            onClick={() => props.onOpenThread(threadId)}
+            className="absolute top-1.5 right-1.5 flex size-7 items-center justify-center rounded-md text-muted-foreground transition-colors hover:bg-muted hover:text-foreground"
+          >
+            <ExternalLinkIcon className="size-3" aria-hidden="true" />
+          </button>
+        )}
+      </div>
+    );
+  }
+
+  return threadId === null ? (
+    <div
+      data-v2-item-type={props.itemType}
+      className="flex min-w-0 items-center gap-2 rounded-lg border border-border/60 bg-card/30 px-3 py-2"
+    >
+      {content}
+    </div>
+  ) : (
+    <button
+      type="button"
+      data-v2-item-type={props.itemType}
+      aria-label={`Open ${props.title}`}
+      onClick={() => props.onOpenThread(threadId)}
+      className="flex w-full min-w-0 items-center gap-2 rounded-lg border border-border/60 bg-card/30 px-3 py-2 text-left transition-colors hover:bg-muted/50"
+    >
+      {content}
+      <ExternalLinkIcon className="size-3 shrink-0 text-muted-foreground" aria-hidden="true" />
+    </button>
+  );
+}
+
+function subagentDisplayTitle(title: string): string {
+  return title.replace(/^Subagent:\s*/i, "");
+}
+
+/**
+ * Model of the newest run for `instanceId` that started before the handoff's
+ * own run. Legacy handoff items don't record their source models, but the
+ * covered runs are still in the projection.
+ */
+function latestRunModelBefore(
+  runs: ReadonlyArray<HandoffTimelineRun>,
+  instanceId: ProviderInstanceId,
+  beforeOrdinal: number | undefined,
+): string | undefined {
+  let latest: HandoffTimelineRun | undefined;
+  for (const run of runs) {
+    if (run.providerInstanceId !== instanceId) continue;
+    if (beforeOrdinal !== undefined && run.ordinal >= beforeOrdinal) continue;
+    if (latest === undefined || run.ordinal > latest.ordinal) latest = run;
+  }
+  return latest?.modelSelection.model;
+}
+
+/**
+ * One side of a context handoff: the provider's brand icon plus the model's
+ * display name. Falls back to the raw model slug when the instance no longer
+ * lists it, and to the instance display name (or id) when no model was
+ * recorded on the item.
+ */
+function HandoffEndpoint(props: {
+  readonly providers: ReadonlyArray<ServerProvider>;
+  readonly instanceId: ProviderInstanceId;
+  readonly model?: string | undefined;
+}) {
+  const entry = getProviderInstanceEntry(props.providers, props.instanceId);
+  const Icon = entry === undefined ? null : (PROVIDER_ICON_BY_PROVIDER[entry.driverKind] ?? null);
+  const model = props.model?.trim();
+  const providerModel =
+    model === undefined || model.length === 0
+      ? undefined
+      : entry?.models.find((candidate) => candidate.slug === model);
+  const label =
+    providerModel !== undefined
+      ? getTriggerDisplayModelName(providerModel)
+      : model !== undefined && model.length > 0
+        ? model
+        : (entry?.displayName ?? props.instanceId);
+  return (
+    <span className="inline-flex min-w-0 items-center gap-1">
+      {Icon === null ? null : <Icon aria-hidden="true" className="size-3 shrink-0" />}
+      <span className="max-w-40 truncate">{label}</span>
+    </span>
+  );
+}
diff --git a/apps/web/src/components/chat/composerDispatch.test.ts b/apps/web/src/components/chat/composerDispatch.test.ts
new file mode 100644
index 000000000000..630b3f15d390
--- /dev/null
+++ b/apps/web/src/components/chat/composerDispatch.test.ts
@@ -0,0 +1,31 @@
+import { describe, expect, it } from "vite-plus/test";
+
+import { resolveComposerDispatchMode } from "./composerDispatch";
+
+describe("resolveComposerDispatchMode", () => {
+  it("starts an ordinary turn while idle", () => {
+    expect(resolveComposerDispatchMode({ phase: "ready", queueModifier: false })).toBe("auto");
+  });
+
+  it("steers by default and reserves Mod+Enter for queueing while running", () => {
+    expect(resolveComposerDispatchMode({ phase: "running", queueModifier: false })).toBe("steer");
+    expect(resolveComposerDispatchMode({ phase: "running", queueModifier: true })).toBe("queue");
+  });
+
+  it("accepts a configured default without changing the queue shortcut", () => {
+    expect(
+      resolveComposerDispatchMode({
+        phase: "running",
+        queueModifier: false,
+        activeTurnDefault: "restart",
+      }),
+    ).toBe("restart");
+    expect(
+      resolveComposerDispatchMode({
+        phase: "running",
+        queueModifier: true,
+        activeTurnDefault: "restart",
+      }),
+    ).toBe("queue");
+  });
+});
diff --git a/apps/web/src/components/chat/composerDispatch.ts b/apps/web/src/components/chat/composerDispatch.ts
new file mode 100644
index 000000000000..d6dd6de422db
--- /dev/null
+++ b/apps/web/src/components/chat/composerDispatch.ts
@@ -0,0 +1,15 @@
+import type { SessionPhase } from "../../types";
+
+export type ComposerDispatchMode = "auto" | "queue" | "steer" | "restart";
+export type ActiveTurnComposerAction = Exclude<ComposerDispatchMode, "auto">;
+
+/** One policy seam for the future configurable active-turn default action. */
+export function resolveComposerDispatchMode(input: {
+  readonly phase: SessionPhase;
+  readonly queueModifier: boolean;
+  readonly activeTurnDefault?: ActiveTurnComposerAction;
+}): ComposerDispatchMode {
+  if (input.phase !== "running") return "auto";
+  if (input.queueModifier) return "queue";
+  return input.activeTurnDefault ?? "steer";
+}
diff --git a/apps/web/src/components/chat/externalLinkContextMenu.test.ts b/apps/web/src/components/chat/externalLinkContextMenu.test.ts
index 9eb924280f8f..b09c439def39 100644
--- a/apps/web/src/components/chat/externalLinkContextMenu.test.ts
+++ b/apps/web/src/components/chat/externalLinkContextMenu.test.ts
@@ -1,6 +1,10 @@
 import { describe, expect, it, vi } from "vite-plus/test";
 
-import { resolveExternalWebLinkHost, showExternalLinkContextMenu } from "./externalLinkContextMenu";
+import {
+  resolveExternalWebLinkHost,
+  resolveExternalWebLinkHref,
+  showExternalLinkContextMenu,
+} from "./externalLinkContextMenu";
 
 function createHarness(
   selection:
@@ -190,4 +194,28 @@ describe("external chat link context menu", () => {
   ])("resolves the external web-link host for %s as %s", (href, expected) => {
     expect(resolveExternalWebLinkHost(href)).toBe(expected);
   });
+
+  it.each([
+    [
+      "https://example.com/docs?topic=security#links",
+      "https://example.com/docs?topic=security#links",
+    ],
+    ["HTTP://EXAMPLE.COM", "http://example.com/"],
+  ])("resolves the safe external web-link href for %s as %s", (href, expected) => {
+    expect(resolveExternalWebLinkHref(href)).toBe(expected);
+  });
+
+  it.each([
+    "javascript:alert(document.domain)",
+    " \nJaVaScRiPt:alert(document.domain)",
+    "data:text/html,<script>alert(document.domain)</script>",
+    "file:///tmp/example.txt",
+    "mailto:hello@example.com",
+    "//example.com/path",
+    "/relative/path",
+    "not a URL",
+    "",
+  ])("rejects unsafe external web-link href %s", (href) => {
+    expect(resolveExternalWebLinkHref(href)).toBeNull();
+  });
 });
diff --git a/apps/web/src/components/chat/externalLinkContextMenu.ts b/apps/web/src/components/chat/externalLinkContextMenu.ts
index b31f27668ade..fe2d693f3077 100644
--- a/apps/web/src/components/chat/externalLinkContextMenu.ts
+++ b/apps/web/src/components/chat/externalLinkContextMenu.ts
@@ -73,17 +73,25 @@ interface ShowExternalLinkContextMenuOptions {
   ) => void;
 }
 
-export function resolveExternalWebLinkHost(href: string | undefined): string | null {
+function resolveExternalWebLink(href: string | null | undefined): URL | null {
   if (!href) return null;
   try {
     const url = new URL(href);
     if (url.protocol !== "http:" && url.protocol !== "https:") return null;
-    return url.hostname || null;
+    return url;
   } catch {
     return null;
   }
 }
 
+export function resolveExternalWebLinkHref(href: string | null | undefined): string | null {
+  return resolveExternalWebLink(href)?.href ?? null;
+}
+
+export function resolveExternalWebLinkHost(href: string | undefined): string | null {
+  return resolveExternalWebLink(href)?.hostname || null;
+}
+
 export async function showExternalLinkContextMenu({
   href,
   position,
diff --git a/apps/web/src/components/chat/threadDetailsPanelStyles.ts b/apps/web/src/components/chat/threadDetailsPanelStyles.ts
new file mode 100644
index 000000000000..87290f906289
--- /dev/null
+++ b/apps/web/src/components/chat/threadDetailsPanelStyles.ts
@@ -0,0 +1,54 @@
+/**
+ * Visual primitives shared by controls when they are rendered in the thread details panel.
+ *
+ * The core control variants intentionally become denser at the `sm` breakpoint. The panel has
+ * its own fixed density, so every size and type override here includes its desktop counterpart.
+ */
+const THREAD_DETAILS_PANEL_RESTING_BUTTON_SURFACE_CLASS =
+  "bg-transparent shadow-none before:shadow-none not-disabled:not-active:not-data-pressed:before:shadow-none";
+
+const THREAD_DETAILS_PANEL_HOVER_SURFACE_CLASS =
+  "hover:!bg-black/[0.055] data-pressed:!bg-black/[0.055] dark:hover:!bg-white/[0.075] dark:data-pressed:!bg-white/[0.075]";
+
+const THREAD_DETAILS_PANEL_ROW_SURFACE_CLASS = `${THREAD_DETAILS_PANEL_RESTING_BUTTON_SURFACE_CLASS} ${THREAD_DETAILS_PANEL_HOVER_SURFACE_CLASS}`;
+
+const THREAD_DETAILS_PANEL_SPLIT_BUTTON_SURFACE_CLASS = `${THREAD_DETAILS_PANEL_RESTING_BUTTON_SURFACE_CLASS} hover:bg-transparent data-pressed:bg-transparent`;
+
+export const THREAD_DETAILS_PANEL_ROW_CLASS = `h-9 w-full justify-start gap-2.5 rounded-lg border-transparent bg-transparent px-2.5 text-[13px] font-medium text-foreground/80 sm:h-9 sm:text-[13px] ${THREAD_DETAILS_PANEL_ROW_SURFACE_CLASS}`;
+
+export const THREAD_DETAILS_PANEL_SELECT_ROW_CLASS = `${THREAD_DETAILS_PANEL_ROW_CLASS} pe-0 before:pointer-events-none before:absolute before:inset-0 [&_[data-slot=select-icon]]:-me-px [&_[data-slot=select-icon]]:relative [&_[data-slot=select-icon]]:flex [&_[data-slot=select-icon]]:h-full [&_[data-slot=select-icon]]:w-8 [&_[data-slot=select-icon]]:shrink-0 [&_[data-slot=select-icon]]:items-center [&_[data-slot=select-icon]]:justify-center [&_[data-slot=select-icon]]:before:absolute [&_[data-slot=select-icon]]:before:-left-px [&_[data-slot=select-icon]]:before:top-1/2 [&_[data-slot=select-icon]]:before:h-4 [&_[data-slot=select-icon]]:before:w-px [&_[data-slot=select-icon]]:before:-translate-y-1/2 [&_[data-slot=select-icon]]:before:bg-border/65 [&_[data-slot=select-icon]>svg]:me-0 [&_[data-slot=select-icon]>svg]:size-4 [&_[data-slot=select-icon]>svg]:text-muted-foreground [&_[data-slot=select-icon]>svg]:opacity-100`;
+
+export const THREAD_DETAILS_PANEL_LINK_ROW_CLASS = `flex h-9 min-w-0 flex-1 cursor-pointer items-center justify-start gap-2.5 rounded-lg border border-transparent bg-transparent px-2.5 text-left text-[13px] font-medium text-foreground/80 disabled:cursor-not-allowed disabled:opacity-55 sm:h-9 sm:text-[13px] ${THREAD_DETAILS_PANEL_ROW_SURFACE_CLASS}`;
+
+// No transition on the group: the halves are Buttons whose background snaps (their base only
+// transitions shadow), so an eased group tint would land frames later and the hover would
+// visibly commit in two steps.
+export const THREAD_DETAILS_PANEL_LINK_SPLIT_GROUP_CLASS = `group/thread-details-link flex w-full items-center rounded-lg ${THREAD_DETAILS_PANEL_HOVER_SURFACE_CLASS}`;
+
+export const THREAD_DETAILS_PANEL_LINK_SPLIT_PRIMARY_CLASS = `flex h-9 min-w-0 flex-1 cursor-pointer items-center justify-start gap-2.5 rounded-e-none border border-transparent px-2.5 text-left text-[13px] font-medium text-foreground/80 disabled:cursor-not-allowed disabled:opacity-55 sm:h-9 sm:text-[13px] ${THREAD_DETAILS_PANEL_SPLIT_BUTTON_SURFACE_CLASS}`;
+
+export const THREAD_DETAILS_PANEL_LINK_SPLIT_SECONDARY_CLASS = `h-9 w-8 shrink-0 rounded-s-none border-transparent px-0 text-[13px] font-medium text-foreground/80 sm:h-9 sm:w-8 sm:text-[13px] ${THREAD_DETAILS_PANEL_SPLIT_BUTTON_SURFACE_CLASS}`;
+
+/** The trailing half of a link split row when it carries a word ("Merge") rather than an icon. */
+export const THREAD_DETAILS_PANEL_LINK_SPLIT_ACTION_CLASS = `h-9 shrink-0 rounded-s-none border-transparent px-2.5 text-[13px] font-medium text-primary sm:h-9 sm:text-[13px] ${THREAD_DETAILS_PANEL_SPLIT_BUTTON_SURFACE_CLASS}`;
+
+export const THREAD_DETAILS_PANEL_LOCKED_ROW_CLASS =
+  "h-9 w-full justify-start gap-2.5 rounded-lg border border-transparent px-2.5 text-[13px] font-medium text-foreground/80 sm:h-9 sm:text-[13px]";
+
+export const THREAD_DETAILS_PANEL_ICON_CLASS = "-mx-0.5 size-4 shrink-0 text-muted-foreground";
+
+export const THREAD_DETAILS_PANEL_CHEVRON_CLASS = "size-4 shrink-0 text-muted-foreground";
+
+export const THREAD_DETAILS_PANEL_ICON_ACTION_CLASS = `size-6 rounded-md border-transparent bg-transparent p-0 sm:size-6 ${THREAD_DETAILS_PANEL_ROW_SURFACE_CLASS}`;
+
+export const THREAD_DETAILS_PANEL_SPLIT_GROUP_CLASS = `group/thread-details-action flex w-full items-center rounded-lg ${THREAD_DETAILS_PANEL_HOVER_SURFACE_CLASS}`;
+
+export const THREAD_DETAILS_PANEL_SPLIT_PRIMARY_CLASS = `h-9 min-w-0 flex-1 justify-start gap-2.5 rounded-e-none border-transparent bg-transparent px-2.5 pr-2 text-[13px] font-medium text-foreground/80 sm:h-9 sm:text-[13px] ${THREAD_DETAILS_PANEL_SPLIT_BUTTON_SURFACE_CLASS}`;
+
+export const THREAD_DETAILS_PANEL_SPLIT_SECONDARY_CLASS = `h-9 w-8 rounded-s-none border-transparent bg-transparent px-0 sm:h-9 sm:w-8 ${THREAD_DETAILS_PANEL_SPLIT_BUTTON_SURFACE_CLASS}`;
+
+export const THREAD_DETAILS_PANEL_SPLIT_SEPARATOR_CLASS = "h-4 w-px shrink-0 bg-border/65";
+
+export const THREAD_DETAILS_PANEL_ROW_POPUP_CLASS = "w-(--anchor-width)";
+
+export const THREAD_DETAILS_PANEL_MENU_POPUP_CLASS = "min-w-60 max-w-(--available-width)";
diff --git a/apps/web/src/components/files/FilePreviewPanel.tsx b/apps/web/src/components/files/FilePreviewPanel.tsx
index bc2ff98f0a2d..bdec681c22c2 100644
--- a/apps/web/src/components/files/FilePreviewPanel.tsx
+++ b/apps/web/src/components/files/FilePreviewPanel.tsx
@@ -911,7 +911,6 @@ export default function FilePreviewPanel({
               availableEditors={availableEditors}
               openInCwd={absolutePath}
               compact
-              enableShortcut={false}
             />
           ) : null}
           {isMarkdown ? (
diff --git a/apps/web/src/components/preview/PreviewPanelShell.tsx b/apps/web/src/components/preview/PreviewPanelShell.tsx
index 7a20c2eaaa03..75d5504a1515 100644
--- a/apps/web/src/components/preview/PreviewPanelShell.tsx
+++ b/apps/web/src/components/preview/PreviewPanelShell.tsx
@@ -1,82 +1,52 @@
-import {
-  type ReactNode,
-  type RefObject,
-  useEffect,
-  useLayoutEffect,
-  useRef,
-  useState,
-} from "react";
+import { type ReactNode, useRef } from "react";
 
 import { isElectron } from "~/env";
-import { useResizableWidth } from "~/hooks/useResizableWidth";
+import {
+  getPreviewPanelMaxWidth,
+  type PreviewPanelInlineSize,
+  usePreviewPanelInlineSize,
+} from "~/hooks/usePreviewPanelInlineSize";
+
+export { getPreviewPanelMaxWidth };
 import { cn } from "~/lib/utils";
 
 import { RightPanelResizeHandle } from "./RightPanelResizeHandle";
 
 export type PreviewPanelMode = "inline" | "sheet" | "sidebar" | "embedded";
 
-const PREVIEW_PANEL_WIDTH_STORAGE_KEY = "t3code:preview-panel-width";
-const PREVIEW_PANEL_MIN_WIDTH = 360;
-/**
- * Upper bound as a fraction of the viewport; only binds on wide screens.
- * On narrow windows the container clamp below is what preserves the
- * sibling column's space.
- */
-const PREVIEW_PANEL_MAX_WIDTH_FRACTION = 0.7;
-const PREVIEW_PANEL_DEFAULT_WIDTH = 540;
-/**
- * Width reserved for the sibling column (chat, pull-request list) sharing the
- * panel's flex row. The viewport fraction alone is not enough: the app
- * sidebar sits outside the row, so on narrow windows (any MacBook, even
- * fullscreen) the remaining 30% of the viewport minus the sidebar left the
- * sibling below its usable width and the composer overflowed.
- */
-const SIBLING_COLUMN_MIN_WIDTH = 360;
-
-export function getPreviewPanelMaxWidth(viewportWidth: number, containerWidth?: number): number {
-  const fractionCap = Math.floor(viewportWidth * PREVIEW_PANEL_MAX_WIDTH_FRACTION);
-  const containerCap =
-    containerWidth === undefined ? Infinity : Math.floor(containerWidth) - SIBLING_COLUMN_MIN_WIDTH;
-  // Never below the panel's own minimum: when the row cannot fit both
-  // columns' minimums the sibling yields, and useResizableWidth's clamp
-  // must not see max < min (it would resolve the inversion to min and,
-  // via drag-end persistence, overwrite the user's stored width).
-  return Math.max(PREVIEW_PANEL_MIN_WIDTH, Math.min(fractionCap, containerCap));
-}
-
 /**
  * Shell for the preview panel. In inline mode the panel is user-resizable
  * via a drag handle on the left edge; width persists per browser. In
  * sheet/sidebar modes the parent owns the size.
  */
-export function PreviewPanelShell(props: {
+interface PreviewPanelShellProps {
   mode: PreviewPanelMode;
   maximized?: boolean;
-  /**
-   * Overrides the localStorage key used to persist the panel width. Callers
-   * embedding this shell for a different surface (e.g. the pull requests
-   * page) should pass their own key so resizing one panel doesn't clobber
-   * the other's remembered width.
-   */
-  widthStorageKey?: string;
-  /** Overrides the initial width (px) before the user has resized the panel. */
-  defaultWidth?: number;
+  inlineSize?: PreviewPanelInlineSize;
   children: ReactNode;
-}) {
+}
+
+export function PreviewPanelShell(props: PreviewPanelShellProps) {
+  if (props.inlineSize) {
+    return <PreviewPanelShellFrame {...props} inlineSize={props.inlineSize} />;
+  }
+
+  return <ResizablePreviewPanelShell {...props} />;
+}
+
+function ResizablePreviewPanelShell(props: PreviewPanelShellProps) {
+  const inlineSize = usePreviewPanelInlineSize();
+  return <PreviewPanelShellFrame {...props} inlineSize={inlineSize} />;
+}
+
+function PreviewPanelShellFrame(
+  props: PreviewPanelShellProps & { inlineSize: PreviewPanelInlineSize },
+) {
   const useDragRegion = isElectron && props.mode !== "sheet" && props.mode !== "embedded";
   const isInline = props.mode === "inline";
-  const hostRef = useRef<HTMLDivElement | null>(null);
-  // Only inline non-maximized mode applies `width`/`maxWidth`; skip the
-  // container measurement (and its re-renders) everywhere else.
-  const maxWidth = useClampedMaxWidth(hostRef, isInline && !props.maximized);
-  const { width, handlers } = useResizableWidth({
-    storageKey: props.widthStorageKey ?? PREVIEW_PANEL_WIDTH_STORAGE_KEY,
-    defaultWidth: props.defaultWidth ?? PREVIEW_PANEL_DEFAULT_WIDTH,
-    minWidth: PREVIEW_PANEL_MIN_WIDTH,
-    maxWidth,
-    edge: "left",
-  });
+  const { width, handlers } = props.inlineSize;
 
+  const hostRef = useRef<HTMLDivElement | null>(null);
   return (
     <div
       ref={hostRef}
@@ -98,54 +68,3 @@ export function PreviewPanelShell(props: {
     </div>
   );
 }
-
-/**
- * Track viewport and flex-row widths to derive an upper bound for the panel.
- * Resize-aware so dragging the OS window narrower (or expanding the app
- * sidebar) re-clamps the stored width on the next render (the hook's clamp
- * picks this up automatically). The row is observed rather than the panel
- * itself because the panel competes with its sibling column for row space.
- * Row measurement only runs when `enabled`; modes without a resize handle
- * never apply the resulting width, so they skip the observer entirely.
- */
-function useClampedMaxWidth(hostRef: RefObject<HTMLDivElement | null>, enabled: boolean): number {
-  const [vw, setVw] = useState(() => (typeof window === "undefined" ? 1280 : window.innerWidth));
-  const [containerWidth, setContainerWidth] = useState<number | undefined>(undefined);
-  useEffect(() => {
-    if (typeof window === "undefined") return;
-    let frame = 0;
-    const onResize = () => {
-      // Coalesce rapid resize events into one rAF tick.
-      if (frame !== 0) return;
-      frame = window.requestAnimationFrame(() => {
-        frame = 0;
-        setVw(window.innerWidth);
-      });
-    };
-    window.addEventListener("resize", onResize);
-    return () => {
-      window.removeEventListener("resize", onResize);
-      if (frame !== 0) window.cancelAnimationFrame(frame);
-    };
-  }, []);
-  useLayoutEffect(() => {
-    if (!enabled) return;
-    const parent = hostRef.current?.parentElement;
-    if (!parent) return;
-    // Measure before first paint: the persisted width must be clamped
-    // against the row on the initial render, not one observer tick later
-    // (the panel would flash over-wide on every mount). clientWidth is
-    // integral, so sub-pixel resize deltas bail out of re-rendering.
-    const measure = () => {
-      setContainerWidth(parent.clientWidth);
-    };
-    measure();
-    if (typeof ResizeObserver === "undefined") return;
-    const observer = new ResizeObserver(measure);
-    observer.observe(parent);
-    return () => {
-      observer.disconnect();
-    };
-  }, [hostRef, enabled]);
-  return getPreviewPanelMaxWidth(vw, containerWidth);
-}
diff --git a/apps/web/src/components/preview/ThreadPreviewMiniPlayer.tsx b/apps/web/src/components/preview/ThreadPreviewMiniPlayer.tsx
index 623928d102ef..74a1315b2ec1 100644
--- a/apps/web/src/components/preview/ThreadPreviewMiniPlayer.tsx
+++ b/apps/web/src/components/preview/ThreadPreviewMiniPlayer.tsx
@@ -17,10 +17,31 @@ import { previewBridge } from "./previewBridge";
 import {
   clampPreviewMiniPlayerPosition,
   clampPreviewMiniPlayerSize,
+  defaultPreviewMiniPlayerPosition,
   PREVIEW_MINI_PLAYER_DEFAULT_SIZE,
   PREVIEW_MINI_PLAYER_EDGE_GAP,
 } from "./previewMiniPlayerLayout";
 
+/**
+ * Where a freshly opened player should land: under the inline thread-details
+ * card when that panel is open (it owns the top-right corner), otherwise the
+ * top-right CSS placement the element already has.
+ */
+function initialPreviewMiniPlayerPosition(root: HTMLElement, parent: HTMLElement) {
+  const fallback = { x: root.offsetLeft, y: root.offsetTop };
+  const card = root
+    .closest('[data-thread-details-inline-reserved="true"]')
+    ?.querySelector('[data-thread-details-panel="inline"] [data-thread-details-card]');
+  if (!(card instanceof HTMLElement)) return fallback;
+  const cardRect = card.getBoundingClientRect();
+  return defaultPreviewMiniPlayerPosition({
+    fallback,
+    parentRect: parent.getBoundingClientRect(),
+    playerWidth: root.offsetWidth,
+    detailsCardRect: { right: cardRect.right, bottom: cardRect.bottom },
+  });
+}
+
 interface DragState {
   readonly pointerId: number;
   readonly pointerX: number;
diff --git a/apps/web/src/components/preview/addBrowserSurface.test.ts b/apps/web/src/components/preview/addBrowserSurface.test.ts
index 4299374b321c..8acba7c70f34 100644
--- a/apps/web/src/components/preview/addBrowserSurface.test.ts
+++ b/apps/web/src/components/preview/addBrowserSurface.test.ts
@@ -32,7 +32,7 @@ const snapshot = (tabId: string): PreviewSessionSnapshot => ({
 
 beforeEach(() => {
   resetPreviewStateForTests();
-  useRightPanelStore.setState({ byThreadKey: {} });
+  useRightPanelStore.setState({ byThreadKey: {}, threadPanelVisibilityByThreadKey: {} });
 });
 
 describe("addBrowserSurface", () => {
diff --git a/apps/web/src/components/preview/previewMiniPlayerLayout.test.ts b/apps/web/src/components/preview/previewMiniPlayerLayout.test.ts
index 98b26e8a0b2b..eb2d16f4fee2 100644
--- a/apps/web/src/components/preview/previewMiniPlayerLayout.test.ts
+++ b/apps/web/src/components/preview/previewMiniPlayerLayout.test.ts
@@ -3,9 +3,37 @@ import { describe, expect, it } from "vite-plus/test";
 import {
   clampPreviewMiniPlayerPosition,
   clampPreviewMiniPlayerSize,
+  defaultPreviewMiniPlayerPosition,
   PREVIEW_MINI_PLAYER_EDGE_GAP,
 } from "./previewMiniPlayerLayout";
 
+describe("defaultPreviewMiniPlayerPosition", () => {
+  it("keeps the top-right fallback when the inline details panel is closed", () => {
+    expect(
+      defaultPreviewMiniPlayerPosition({
+        fallback: { x: 664, y: 16 },
+        parentRect: { left: 300, top: 60 },
+        playerWidth: 320,
+        detailsCardRect: null,
+      }),
+    ).toEqual({ x: 664, y: 16 });
+  });
+
+  it("slides under the inline details card with right edges aligned", () => {
+    expect(
+      defaultPreviewMiniPlayerPosition({
+        fallback: { x: 664, y: 16 },
+        parentRect: { left: 300, top: 60 },
+        playerWidth: 320,
+        detailsCardRect: { right: 1280, bottom: 320 },
+      }),
+    ).toEqual({
+      x: 1280 - 300 - 320,
+      y: 320 - 60 + PREVIEW_MINI_PLAYER_EDGE_GAP,
+    });
+  });
+});
+
 describe("clampPreviewMiniPlayerPosition", () => {
   it("keeps a dragged player within the chat viewport", () => {
     expect(
diff --git a/apps/web/src/components/preview/previewMiniPlayerLayout.ts b/apps/web/src/components/preview/previewMiniPlayerLayout.ts
index abdd5b8ca4d0..9e6a1c6d3142 100644
--- a/apps/web/src/components/preview/previewMiniPlayerLayout.ts
+++ b/apps/web/src/components/preview/previewMiniPlayerLayout.ts
@@ -24,6 +24,27 @@ export function clampPreviewMiniPlayerSize(
   };
 }
 
+/**
+ * Default spot for a freshly opened mini player. Normally the top-right CSS
+ * placement stands (`fallback`), but when the inline thread-details panel is
+ * open its card occupies that corner — slide the player underneath the card,
+ * right edges aligned, so neither surface covers the other. The result still
+ * goes through `clampPreviewMiniPlayerPosition`, which pulls the player back
+ * up when a tall card would push it into the composer.
+ */
+export function defaultPreviewMiniPlayerPosition(input: {
+  readonly fallback: PreviewMiniPlayerPosition;
+  readonly parentRect: { readonly left: number; readonly top: number };
+  readonly playerWidth: number;
+  readonly detailsCardRect: { readonly right: number; readonly bottom: number } | null;
+}): PreviewMiniPlayerPosition {
+  if (input.detailsCardRect === null) return input.fallback;
+  return {
+    x: input.detailsCardRect.right - input.parentRect.left - input.playerWidth,
+    y: input.detailsCardRect.bottom - input.parentRect.top + PREVIEW_MINI_PLAYER_EDGE_GAP,
+  };
+}
+
 export function clampPreviewMiniPlayerPosition(
   position: PreviewMiniPlayerPosition,
   container: PreviewMiniPlayerSize,
diff --git a/apps/web/src/components/pullRequest/pullRequestDetail.logic.test.ts b/apps/web/src/components/pullRequest/pullRequestDetail.logic.test.ts
index 9b9ef610752b..28fcad057019 100644
--- a/apps/web/src/components/pullRequest/pullRequestDetail.logic.test.ts
+++ b/apps/web/src/components/pullRequest/pullRequestDetail.logic.test.ts
@@ -9,6 +9,9 @@ import { describe, expect, it } from "vite-plus/test";
 
 import {
   buildAddSelectionToAgentHandoff,
+  classifyPullRequestChecks,
+  describePullRequestChecks,
+  resolveThreadPanelPullRequestAction,
   buildAskAboutPullRequestHandoff,
   buildExplainPullRequestHandoff,
   buildFixFindingHandoff,
@@ -1247,3 +1250,98 @@ describe("which actions need the host read again after they run", () => {
     }
   });
 });
+
+describe("the compact row's single action slot", () => {
+  const check = (status: PullRequestCheck["status"]): PullRequestCheck => ({
+    name: "ci",
+    status,
+    description: null,
+    url: null,
+  });
+  const openDetail = (
+    overrides: Partial<Parameters<typeof resolveThreadPanelPullRequestAction>[0] & object> = {},
+  ) =>
+    ({
+      state: "open",
+      isDraft: false,
+      mergeability: "mergeable",
+      capabilities: {
+        actions: ["merge", "ready", "draft", "close", "reopen"],
+        mergeMethods: ["merge", "squash"],
+      } as unknown as PullRequestDetailView["capabilities"],
+      viewerPermissions: {
+        actions: ["merge", "ready", "draft", "close", "reopen"],
+      } as unknown as PullRequestDetailView["viewerPermissions"],
+      mergeCapabilities: { merge: true, squash: true, rebase: false },
+      checks: [check("success")],
+      ...overrides,
+    }) as NonNullable<Parameters<typeof resolveThreadPanelPullRequestAction>[0]>;
+
+  it("offers Merge only for a clean pull request whose checks pass", () => {
+    expect(resolveThreadPanelPullRequestAction(openDetail())).toBe("merge");
+    expect(resolveThreadPanelPullRequestAction(openDetail({ checks: [] }))).toBe("merge");
+  });
+
+  it("holds the slot while checks run rather than offering a merge that races them", () => {
+    expect(
+      resolveThreadPanelPullRequestAction(
+        openDetail({ checks: [check("success"), check("pending")] }),
+      ),
+    ).toBeNull();
+  });
+
+  it("ranks conflicts above everything, then draft, then failing checks", () => {
+    expect(
+      resolveThreadPanelPullRequestAction(
+        openDetail({ mergeability: "conflicting", isDraft: true, checks: [check("failure")] }),
+      ),
+    ).toBe("resolve");
+    expect(
+      resolveThreadPanelPullRequestAction(
+        openDetail({ isDraft: true, checks: [check("failure")] }),
+      ),
+    ).toBe("ready");
+    expect(
+      resolveThreadPanelPullRequestAction(
+        openDetail({ checks: [check("failure"), check("pending")] }),
+      ),
+    ).toBe("fix");
+  });
+
+  it("offers nothing the viewer may not do, and nothing on settled pull requests", () => {
+    expect(
+      resolveThreadPanelPullRequestAction(
+        openDetail({
+          viewerPermissions: {
+            actions: [],
+          } as unknown as PullRequestDetailView["viewerPermissions"],
+        }),
+      ),
+    ).toBeNull();
+    expect(resolveThreadPanelPullRequestAction(openDetail({ state: "merged" }))).toBeNull();
+    expect(resolveThreadPanelPullRequestAction(null)).toBeNull();
+  });
+
+  it("describes every live facet of the checks at once", () => {
+    expect(describePullRequestChecks([])).toBe("No checks reported");
+    expect(describePullRequestChecks([check("success"), check("success")])).toBe(
+      "All checks passed",
+    );
+    expect(describePullRequestChecks([check("success"), check("skipped")])).toBe("1 of 2 passing");
+    expect(
+      describePullRequestChecks([
+        ...Array.from({ length: 7 }, () => check("pending")),
+        ...Array.from({ length: 8 }, () => check("success")),
+        check("failure"),
+      ]),
+    ).toBe("7 of 16 running · 1 failed");
+    expect(describePullRequestChecks([check("failure"), check("success")])).toBe("1 of 2 failing");
+  });
+
+  it("reads the checks as one word, failing outranking running", () => {
+    expect(classifyPullRequestChecks([])).toBe("none");
+    expect(classifyPullRequestChecks([check("success"), check("skipped")])).toBe("passing");
+    expect(classifyPullRequestChecks([check("success"), check("pending")])).toBe("pending");
+    expect(classifyPullRequestChecks([check("pending"), check("cancelled")])).toBe("failing");
+  });
+});
diff --git a/apps/web/src/components/pullRequest/pullRequestDetail.logic.ts b/apps/web/src/components/pullRequest/pullRequestDetail.logic.ts
index a616a8395239..e28d693494e6 100644
--- a/apps/web/src/components/pullRequest/pullRequestDetail.logic.ts
+++ b/apps/web/src/components/pullRequest/pullRequestDetail.logic.ts
@@ -5,9 +5,11 @@ import type {
   PullRequestCheck,
   PullRequestComment,
   PullRequestCommit,
+  PullRequestDetail,
   PullRequestDetailView,
   PullRequestMergeability,
   PullRequestReaction,
+  PullRequestMergeMethod,
   PullRequestReviewThread,
   PullRequestState,
   PullRequestUpdateMethod,
@@ -121,6 +123,130 @@ export function describePullRequestState(state: PullRequestState, isDraft: boole
   return isDraft ? "Draft" : "Ready for review";
 }
 
+/** The slice of a detail that decides which actions it offers. */
+export type PullRequestActionableDetail = Pick<
+  PullRequestDetail,
+  "state" | "isDraft" | "mergeability" | "capabilities" | "viewerPermissions" | "mergeCapabilities"
+>;
+
+/**
+ * The host says which strategies it offers at all; the repository narrows that to the ones it
+ * actually allows.
+ */
+export function allowedPullRequestMergeMethods(
+  detail: Pick<PullRequestActionableDetail, "capabilities" | "mergeCapabilities"> | null,
+): ReadonlyArray<PullRequestMergeMethod> {
+  return detail === null
+    ? []
+    : detail.capabilities.mergeMethods.filter((method) => detail.mergeCapabilities[method]);
+}
+
+/** The reader's preference where the repository allows it, and the first allowed method else. */
+export function resolveSelectedMergeMethod(
+  allowedMergeMethods: ReadonlyArray<PullRequestMergeMethod>,
+  preferred: PullRequestMergeMethod,
+): PullRequestMergeMethod {
+  return allowedMergeMethods.includes(preferred) ? preferred : (allowedMergeMethods[0] ?? "merge");
+}
+
+/**
+ * Two questions, both of which have to say yes: whether this host can do it at all, and whether
+ * this account may. A reader with read access on someone else's project sees the pull request and
+ * none of the buttons that would only ever be refused.
+ */
+export function canPerformPullRequestAction(
+  detail: Pick<PullRequestActionableDetail, "capabilities" | "viewerPermissions"> | null,
+  action: PullRequestAction,
+): boolean {
+  return (
+    detail !== null &&
+    detail.capabilities.actions.includes(action) &&
+    detail.viewerPermissions.actions.includes(action)
+  );
+}
+
+export function isPullRequestConflicting(
+  detail: Pick<PullRequestActionableDetail, "state" | "mergeability"> | null,
+): boolean {
+  return detail?.state === "open" && detail.mergeability === "conflicting";
+}
+
+/**
+ * One live action holds the slot. A conflicting change cannot be merged now, so the slot goes to
+ * the thing that would help instead of a Merge button that only ever says no.
+ */
+export function resolvePullRequestPrimaryAction(
+  detail: PullRequestActionableDetail | null,
+): "ready" | "merge" | "resolve" | null {
+  if (detail === null || detail.state !== "open") return null;
+  if (detail.isDraft && canPerformPullRequestAction(detail, "ready")) return "ready";
+  if (!canPerformPullRequestAction(detail, "merge")) return null;
+  if (isPullRequestConflicting(detail)) return "resolve";
+  return allowedPullRequestMergeMethods(detail).length > 0 ? "merge" : null;
+}
+
+/** The checks as one word. Failing outranks running: a red run is already worth acting on. */
+export type PullRequestChecksState = "none" | "pending" | "failing" | "passing";
+
+export function classifyPullRequestChecks(
+  checks: ReadonlyArray<PullRequestCheck>,
+): PullRequestChecksState {
+  if (checks.length === 0) return "none";
+  if (checks.some((check) => check.status === "failure" || check.status === "cancelled")) {
+    return "failing";
+  }
+  if (checks.some((check) => check.status === "pending")) return "pending";
+  return "passing";
+}
+
+/**
+ * The checks with every live facet, unlike the single-facet summary: a run with failures in it
+ * still says how much is in flight — "7 of 16 running · 1 failed" — because both numbers change
+ * what a reader does next.
+ */
+export function describePullRequestChecks(checks: ReadonlyArray<PullRequestCheck>): string {
+  if (checks.length === 0) return "No checks reported";
+  const failed = checks.filter(
+    (check) => check.status === "failure" || check.status === "cancelled",
+  ).length;
+  const pending = checks.filter((check) => check.status === "pending").length;
+  const passed = checks.filter((check) => check.status === "success").length;
+  const parts: string[] = [];
+  if (pending > 0) parts.push(`${pending} of ${checks.length} running`);
+  if (failed > 0) {
+    parts.push(pending > 0 ? `${failed} failed` : `${failed} of ${checks.length} failing`);
+  }
+  if (parts.length === 0) {
+    return passed === checks.length ? "All checks passed" : `${passed} of ${checks.length} passing`;
+  }
+  return parts.join(" · ");
+}
+
+export type ThreadPanelPullRequestAction = "resolve" | "ready" | "fix" | "merge";
+
+/**
+ * Which single action the thread panel's compact pull request row offers, ranked by what
+ * unblocks the merge next: conflicts stop everything, a draft is not up for review yet, failing
+ * checks want fixing, and only a clean open pull request earns Merge. While checks run the slot
+ * stays empty — the row shows their progress instead of an action that would race them.
+ */
+export function resolveThreadPanelPullRequestAction(
+  detail: (PullRequestActionableDetail & Pick<PullRequestDetail, "checks">) | null,
+): ThreadPanelPullRequestAction | null {
+  if (detail === null || detail.state !== "open") return null;
+  if (isPullRequestConflicting(detail)) return "resolve";
+  if (detail.isDraft) {
+    return canPerformPullRequestAction(detail, "ready") ? "ready" : null;
+  }
+  const checks = classifyPullRequestChecks(detail.checks);
+  if (checks === "failing") return "fix";
+  if (checks === "pending") return null;
+  return canPerformPullRequestAction(detail, "merge") &&
+    allowedPullRequestMergeMethods(detail).length > 0
+    ? "merge"
+    : null;
+}
+
 /** Chronological ascending, oldest to newest — reversed for the "newest" reading order. */
 export function orderPullRequestComments<T extends { readonly createdAt: string }>(
   comments: ReadonlyArray<T>,
diff --git a/apps/web/src/components/pullRequest/usePullRequestActions.ts b/apps/web/src/components/pullRequest/usePullRequestActions.ts
new file mode 100644
index 000000000000..8ae6b14bf0df
--- /dev/null
+++ b/apps/web/src/components/pullRequest/usePullRequestActions.ts
@@ -0,0 +1,344 @@
+/**
+ * The actions a pull request offers, extracted from the detail panel so smaller surfaces — the
+ * thread details panel's pull request row — perform them through the very same code. Two callers
+ * running two copies of "merge" or "resolve in a thread" would drift apart one fix at a time;
+ * these hooks are where that behavior lives, and the panels are only where it is rendered.
+ */
+import { scopeProjectRef } from "@t3tools/client-runtime/environment";
+import { squashAtomCommandFailure } from "@t3tools/client-runtime/state/runtime";
+import type {
+  EnvironmentId,
+  PullRequestAction,
+  PullRequestDetail,
+  PullRequestMergeMethod,
+  PullRequestRef,
+} from "@t3tools/contracts";
+import { useState } from "react";
+
+import { type DraftId, useComposerDraftStore } from "~/composerDraftStore";
+import { useNewThreadHandler } from "~/hooks/useHandleNewThread";
+import { usePreparePullRequestThreadAction } from "~/lib/sourceControlActions";
+import type { ReviewCommentContext } from "~/reviewCommentContext";
+import { pullRequestEnvironment } from "~/state/pullRequests";
+import { useAtomCommand } from "~/state/use-atom-command";
+
+import { toastManager } from "../ui/toast";
+import { handoffPrompt, handoffReviewComments, readableFailure } from "./pullRequestDetail.logic";
+
+const ACTION_SUCCESS_LABELS: Record<PullRequestAction, string> = {
+  merge: "Pull request merged",
+  ready: "Marked ready for review",
+  draft: "Converted to draft",
+  close: "Pull request closed",
+  reopen: "Pull request reopened",
+  "update-branch": "Branch updated with the base branch",
+  "enable-auto-merge": "Auto-merge enabled",
+  "disable-auto-merge": "Auto-merge disabled",
+};
+
+/** Said as the thing that did not happen, rather than as the operation that returned an error. */
+const ACTION_FAILURE_LABELS: Record<PullRequestAction, string> = {
+  merge: "Could not merge this pull request",
+  ready: "Could not mark this ready for review",
+  draft: "Could not convert this to a draft",
+  close: "Could not close this pull request",
+  reopen: "Could not reopen this pull request",
+  "update-branch": "Could not update this branch",
+  "enable-auto-merge": "Could not enable auto-merge",
+  "disable-auto-merge": "Could not disable auto-merge",
+};
+
+/** What to try, for the times the host says only that it refused. */
+const ACTION_FAILURE_HINTS: Record<PullRequestAction, string> = {
+  merge:
+    "The host refused the merge. Check that you have write access, that the checks it requires have passed, and that the branch is not conflicting.",
+  ready: "The host refused it. Check that you have write access to this repository.",
+  draft: "The host refused it. Check that you have write access to this repository.",
+  close: "The host refused it. Check that you have write access, or that you opened it.",
+  reopen:
+    "The host refused it. Check that you have write access, and that the branch still exists.",
+  "update-branch":
+    "The host refused it. Check that you have write access, and that the base branch has not diverged in a way the host cannot merge.",
+  "enable-auto-merge":
+    "The host refused it. Check that auto-merge is enabled for this repository and that you have write access.",
+  "disable-auto-merge": "The host refused it. Check that you have write access to this repository.",
+};
+
+/**
+ * Runs one host action against a pull request, with the toasts every surface should say the same
+ * way. `onSuccess` is where the caller re-reads whatever it is showing.
+ */
+export function usePullRequestActionRunner({
+  environmentId,
+  reference,
+  onSuccess,
+}: {
+  environmentId: EnvironmentId;
+  reference: PullRequestRef | null;
+  onSuccess?: (action: PullRequestAction) => void;
+}) {
+  const runAction = useAtomCommand(pullRequestEnvironment.runAction, { reportFailure: false });
+  const [actionPending, setActionPending] = useState(false);
+
+  const perform = async (action: PullRequestAction, method?: PullRequestMergeMethod) => {
+    if (actionPending || reference === null) return;
+    setActionPending(true);
+    const result = await runAction({
+      environmentId,
+      input: { ...reference, action, ...(method ? { mergeMethod: method } : {}) },
+    });
+    setActionPending(false);
+    if (result._tag === "Failure") {
+      // The host's own sentence, because it is the only thing that says why. A merge strategy a
+      // branch policy forbids is refused at completion and nowhere earlier — Azure DevOps
+      // publishes no per-strategy availability to hide the control with — so "action failed"
+      // would leave the reader pressing the same button again.
+      const failure = squashAtomCommandFailure(result);
+      toastManager.add({
+        type: "error",
+        title: ACTION_FAILURE_LABELS[action],
+        description: readableFailure(failure, ACTION_FAILURE_HINTS[action]),
+      });
+      return;
+    }
+    toastManager.add({ type: "success", title: ACTION_SUCCESS_LABELS[action] });
+    onSuccess?.(action);
+  };
+
+  return { actionPending, perform };
+}
+
+export interface PullRequestThreadTask {
+  prompt: string;
+  reviewComments?: ReadonlyArray<ReviewCommentContext>;
+}
+
+/** What a hand-off needs to know about the pull request it is handing over. */
+export type PullRequestHandoffDetail = Pick<
+  PullRequestDetail,
+  "projectId" | "workspaceRoot" | "url"
+>;
+
+/**
+ * What the last hand-off wrote into each draft, kept outside React because the panel that wrote it
+ * is closed by the time the next one opens. It is how a prompt the reader has since edited is told
+ * apart from the one they were handed: only the sentence still exactly as written may be replaced.
+ */
+const lastHandoffPromptByDraft = new Map<DraftId, string>();
+
+/**
+ * The hand-offs from a pull request into a thread: a question that needs nothing checked out, and
+ * a task that needs the branch under the agent's feet first. One `handoff` key holds them all to
+ * one at a time, whatever surface pressed the button.
+ */
+export function usePullRequestHandoffs({
+  environmentId,
+  detail,
+}: {
+  environmentId: EnvironmentId;
+  detail: PullRequestHandoffDetail | null;
+}) {
+  const newThread = useNewThreadHandler();
+  const prepareThread = usePreparePullRequestThreadAction({
+    environmentId,
+    cwd: detail?.workspaceRoot ?? null,
+  });
+  // Which handoff is preparing, keyed so a per-finding button can say "Preparing..." on itself
+  // alone. One at a time whatever the key: they all check the same pull request out.
+  const [handoff, setHandoff] = useState<string | null>(null);
+
+  /**
+   * Opens a thread on this project and leaves the task in its composer for the reader to send.
+   *
+   * Nothing is checked out: asking a question is not a reason to move somebody's working tree or
+   * to make a worktree they did not ask for. The two hand-offs that do need the code call this
+   * after preparing it, so there is one path from "a task" to "a thread holding it".
+   */
+  const openThreadWithTask = async (
+    projectRef: ReturnType<typeof scopeProjectRef>,
+    task: PullRequestThreadTask | null,
+    opened?: { draftId: DraftId },
+  ): Promise<{ draftId: DraftId } | null> => {
+    const session =
+      opened ??
+      (await newThread(projectRef).then(
+        (result) => result,
+        () => null,
+      ));
+    if (session === null) return null;
+    const store = useComposerDraftStore.getState();
+    if (task === null) return session;
+    // The latest press is the ask: it takes over what an earlier hand-off left, prompt and chips
+    // both, rather than stacking a second one under the first. What the reader typed themselves
+    // survives — the composer they are handed is not always a fresh one, and a prompt they have
+    // since edited is theirs rather than the hand-off's.
+    const draft = store.getComposerDraft(session.draftId);
+    const existingComments = draft?.reviewComments ?? [];
+    const prompt = handoffPrompt(
+      {
+        prompt: draft?.prompt ?? "",
+        lastHandoffPrompt: lastHandoffPromptByDraft.get(session.draftId),
+      },
+      task.prompt,
+    );
+    // Remember the hand-off's own contribution, not the merged prompt: only that sentence is
+    // this session's to take back next time, and the reader's text around it is not.
+    lastHandoffPromptByDraft.set(session.draftId, task.prompt);
+    store.setPrompt(session.draftId, prompt);
+    store.setReviewComments(
+      session.draftId,
+      handoffReviewComments(existingComments, task.reviewComments ?? []),
+    );
+    return session;
+  };
+
+  /** A question about the change, which needs a thread and nothing else. */
+  const startAsk = async (kind: string, task: PullRequestThreadTask) => {
+    if (!detail || handoff !== null) return;
+    setHandoff(kind);
+    const projectRef = scopeProjectRef(environmentId, detail.projectId);
+    const opened = await openThreadWithTask(projectRef, task);
+    setHandoff(null);
+    if (opened === null) {
+      toastManager.add({
+        type: "error",
+        title: "Could not open a thread",
+        description: "Try again from the project, or open a thread first.",
+      });
+      return;
+    }
+    toastManager.add({
+      type: "success",
+      title: "Asked in a thread",
+      // "Ask" leaves the composer empty on purpose, so saying the question is in it would send
+      // the reader looking for something that is not there. The chips are what landed.
+      description:
+        task.prompt.length > 0
+          ? "The question is in the composer — read it over, then send."
+          : "The pull request is in the composer — type your question, then send.",
+    });
+  };
+
+  // Every handoff works the same way: check the pull request out into its own worktree, open a
+  // thread there, and — when it carries a task — put that in the composer for the user to read
+  // before sending. Checking out is the whole point of the ones that carry nothing.
+  const startHandoff = async (
+    kind: string,
+    task: PullRequestThreadTask | null,
+    // A worktree leaves whatever is open alone, which is why it is the default. Checking out in
+    // the repository itself is what you want when the point is to run the thing where you
+    // already work — and it moves the branch under everything else that is open there.
+    mode: "worktree" | "local" = "worktree",
+  ) => {
+    if (!detail || handoff !== null) return;
+    setHandoff(kind);
+    // The menu closes on the press and takes its "Preparing..." label with it, so this is the
+    // only thing answering for the checkout. It carries no timeout of its own: a loading toast
+    // never expires, and an explicit one would survive the update and pin the result on screen.
+    const toastId = toastManager.add({
+      type: "loading",
+      title: "Preparing the pull request checkout...",
+    });
+    const projectRef = scopeProjectRef(environmentId, detail.projectId);
+    // The thread is opened before the checkout rather than after it, because the project's setup
+    // script only runs for a checkout that knows which thread it is for — and a worktree with no
+    // dependencies installed is not something anyone can test.
+    const opened = await newThread(projectRef).then(
+      (session) => session,
+      () => null,
+    );
+    if (opened === null) {
+      setHandoff(null);
+      // Without a thread there is nowhere for the checkout to belong: its setup script would not
+      // run and its task would have no composer to land in. Better to stop before touching the
+      // working tree than to prepare a worktree nobody asked for.
+      toastManager.update(toastId, {
+        type: "error",
+        title: "Could not open a thread for the checkout",
+        description: "Try again from the project, or open a thread first.",
+      });
+      return;
+    }
+    const prepared = await prepareThread.run({
+      reference: detail.url,
+      mode,
+      threadId: opened.threadId,
+    });
+    if (prepared._tag === "Failure") {
+      setHandoff(null);
+      // The server says what to do about it — that the branch is already checked out in the main
+      // repository, say — and that sentence is the only way out of the failure.
+      const detailMessage =
+        prepareThread.error instanceof Error ? prepareThread.error.message : null;
+      toastManager.update(toastId, {
+        type: "error",
+        title: "Could not prepare the pull request checkout",
+        ...(detailMessage ? { description: detailMessage } : {}),
+      });
+      return;
+    }
+    // The same thread again, now that there is somewhere to point it at. A local checkout has
+    // no worktree of its own, so the thread runs where the repository already is.
+    const pointed = await newThread(projectRef, {
+      branch: prepared.value.branch,
+      worktreePath: prepared.value.worktreePath,
+      envMode: prepared.value.worktreePath === null ? "local" : "worktree",
+    }).then(
+      (session) => session !== null,
+      () => false,
+    );
+    if (!pointed) {
+      setHandoff(null);
+      // The checkout is on disk; only the thread failed to move onto it. Writing the task now
+      // would send the agent at whatever the thread was already open on — which is the one
+      // outcome worth stopping for, since it reads as success and is not.
+      toastManager.update(toastId, {
+        type: "error",
+        title: "Checked out, but the thread stayed where it was",
+        description: `The checkout is ready on \`${prepared.value.branch}\`. Point a thread at it from the branch picker, then ask again.`,
+      });
+      return;
+    }
+    // Released here whatever happened next: a loading toast never expires on its own, so leaving
+    // this set would spin forever and lock every handoff behind it until a reload.
+    setHandoff(null);
+    // A worktree that was already there and had been worked in keeps whatever it holds, so the
+    // thread opens on older code than the pull request carries. Said once, in place of the
+    // success, because everything else about the handoff did happen.
+    const staleCheckoutToast = {
+      type: "warning",
+      title: "Checked out, but not on the latest commits",
+      description:
+        "The checkout could not be moved onto the pull request's latest commits, so the code there is older than the pull request. Uncommitted work or local commits keep it where it is.",
+    } as const;
+    if (task === null) {
+      toastManager.update(
+        toastId,
+        prepared.value.isOnPullRequestHead
+          ? {
+              type: "success",
+              title: mode === "local" ? "Checked out here" : "Checked out",
+              description:
+                mode === "local"
+                  ? "This repository is on the pull request's branch, with a thread open on it."
+                  : "The pull request is in its own worktree, with a thread open on it.",
+            }
+          : staleCheckoutToast,
+      );
+      return;
+    }
+    await openThreadWithTask(projectRef, task, opened);
+    toastManager.update(
+      toastId,
+      prepared.value.isOnPullRequestHead
+        ? {
+            type: "success",
+            title: "Checkout ready",
+            description: "The task is in the composer — read it over, then send.",
+          }
+        : staleCheckoutToast,
+    );
+  };
+
+  return { handoff, startAsk, startHandoff };
+}
diff --git a/apps/web/src/components/settings/AddProviderInstanceDialog.tsx b/apps/web/src/components/settings/AddProviderInstanceDialog.tsx
index 158908b5e942..260d895ff2bf 100644
--- a/apps/web/src/components/settings/AddProviderInstanceDialog.tsx
+++ b/apps/web/src/components/settings/AddProviderInstanceDialog.tsx
@@ -14,7 +14,7 @@ import { useEnvironmentSettings, useUpdateEnvironmentSettings } from "../../hook
 import { cn } from "../../lib/utils";
 import { normalizeProviderAccentColor } from "../../providerInstances";
 import { Button } from "../ui/button";
-import { ACPRegistryIcon, Gemini, GithubCopilotIcon, PiAgentIcon, type Icon } from "../Icons";
+import { Gemini, GithubCopilotIcon, PiAgentIcon, type Icon } from "../Icons";
 import {
   Dialog,
   DialogDescription,
@@ -88,11 +88,6 @@ const COMING_SOON_DRIVER_OPTIONS: readonly ComingSoonDriverOption[] = [
     label: "Gemini",
     icon: Gemini,
   },
-  {
-    value: ProviderDriverKind.make("acpRegistry"),
-    label: "ACP Registry",
-    icon: ACPRegistryIcon,
-  },
   {
     value: ProviderDriverKind.make("piAgent"),
     label: "Pi Agent",
diff --git a/apps/web/src/components/settings/KeybindingsSettings.logic.test.ts b/apps/web/src/components/settings/KeybindingsSettings.logic.test.ts
index 90eaaef99413..1eadb2af2f89 100644
--- a/apps/web/src/components/settings/KeybindingsSettings.logic.test.ts
+++ b/apps/web/src/components/settings/KeybindingsSettings.logic.test.ts
@@ -151,7 +151,12 @@ describe("KeybindingsSettings.logic", () => {
     ] satisfies ResolvedKeybindingsConfig);
 
     expect(options).toEqual(
-      expect.arrayContaining(["chat.new", "rightPanel.toggleMaximized", "script.setup-db.run"]),
+      expect.arrayContaining([
+        "chat.new",
+        "threadPanel.toggle",
+        "rightPanel.toggleMaximized",
+        "script.setup-db.run",
+      ]),
     );
   });
 
diff --git a/apps/web/src/components/settings/ProviderInstanceCard.test.ts b/apps/web/src/components/settings/ProviderInstanceCard.test.ts
index ed62ff055b09..1d07fc4e87d1 100644
--- a/apps/web/src/components/settings/ProviderInstanceCard.test.ts
+++ b/apps/web/src/components/settings/ProviderInstanceCard.test.ts
@@ -8,7 +8,13 @@ import {
   type ServerProviderModel,
 } from "@t3tools/contracts";
 
-import { deriveProviderModelsForDisplay, ProviderInstanceCard } from "./ProviderInstanceCard";
+import {
+  deriveProviderModelsForDisplay,
+  nextProviderEnvironmentWithFieldValue,
+  providerEnvironmentWithoutNames,
+  ProviderInstanceCard,
+  readProviderEnvironmentVariable,
+} from "./ProviderInstanceCard";
 
 describe("deriveProviderModelsForDisplay", () => {
   it("uses current config custom models instead of stale live custom rows", () => {
@@ -120,3 +126,68 @@ describe("deriveProviderModelsForDisplay", () => {
     }
   });
 });
+
+describe("provider environment helpers", () => {
+  const cursorApiKeyField = {
+    name: "CURSOR_API_KEY",
+    label: "Cursor API key",
+    sensitive: true,
+  };
+
+  it("writes dedicated provider secrets as sensitive environment variables", () => {
+    expect(
+      nextProviderEnvironmentWithFieldValue(
+        [{ name: "EXTRA_FLAG", value: "1", sensitive: false }],
+        cursorApiKeyField,
+        "  cursor-key  ",
+      ),
+    ).toEqual([
+      { name: "EXTRA_FLAG", value: "1", sensitive: false },
+      { name: "CURSOR_API_KEY", value: "cursor-key", sensitive: true },
+    ]);
+  });
+
+  it("replaces redacted provider secrets without preserving redaction markers", () => {
+    expect(
+      nextProviderEnvironmentWithFieldValue(
+        [
+          {
+            name: "CURSOR_API_KEY",
+            value: "",
+            sensitive: true,
+            valueRedacted: true,
+          },
+        ],
+        cursorApiKeyField,
+        "new-key",
+      ),
+    ).toEqual([{ name: "CURSOR_API_KEY", value: "new-key", sensitive: true }]);
+  });
+
+  it("applies the secure field default when replacing an existing non-sensitive value", () => {
+    expect(
+      nextProviderEnvironmentWithFieldValue(
+        [{ name: "OPENAI_API_KEY", value: "old-key", sensitive: false }],
+        {
+          name: "OPENAI_API_KEY",
+          label: "OpenAI API key",
+        },
+        "new-key",
+      ),
+    ).toEqual([{ name: "OPENAI_API_KEY", value: "new-key", sensitive: true }]);
+  });
+
+  it("separates dedicated provider secrets from the generic environment table", () => {
+    const environment = [
+      { name: "CURSOR_API_KEY", value: "cursor-key", sensitive: true },
+      { name: "EXTRA_FLAG", value: "1", sensitive: false },
+    ];
+
+    expect(readProviderEnvironmentVariable(environment, "CURSOR_API_KEY")?.value).toBe(
+      "cursor-key",
+    );
+    expect(providerEnvironmentWithoutNames(environment, new Set(["CURSOR_API_KEY"]))).toEqual([
+      { name: "EXTRA_FLAG", value: "1", sensitive: false },
+    ]);
+  });
+});
diff --git a/apps/web/src/components/settings/ProviderInstanceCard.tsx b/apps/web/src/components/settings/ProviderInstanceCard.tsx
index a82cc2f4adf5..03b03cb35dad 100644
--- a/apps/web/src/components/settings/ProviderInstanceCard.tsx
+++ b/apps/web/src/components/settings/ProviderInstanceCard.tsx
@@ -36,7 +36,7 @@ import { Switch } from "../ui/switch";
 import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from "../ui/table";
 import { stackedThreadToast, toastManager } from "../ui/toast";
 import { Tooltip, TooltipPopup, TooltipTrigger } from "../ui/tooltip";
-import type { DriverOption } from "./providerDriverMeta";
+import type { DriverOption, ProviderEnvironmentFieldDefinition } from "./providerDriverMeta";
 import { providerSettingsTabClassName } from "./providerSettingsTabs";
 import { ProviderSettingsForm } from "./ProviderSettingsForm";
 import { ProviderModelsSection } from "./ProviderModelsSection";
@@ -128,6 +128,55 @@ function nextConfigBlobWithValue(
   return base;
 }
 
+export function readProviderEnvironmentVariable(
+  environment: ReadonlyArray<ProviderInstanceEnvironmentVariable> | undefined,
+  name: string,
+): ProviderInstanceEnvironmentVariable | undefined {
+  return environment?.find((variable) => variable.name === name);
+}
+
+export function providerEnvironmentWithoutNames(
+  environment: ReadonlyArray<ProviderInstanceEnvironmentVariable> | undefined,
+  names: ReadonlySet<string>,
+): ReadonlyArray<ProviderInstanceEnvironmentVariable> {
+  return (environment ?? []).filter((variable) => !names.has(variable.name));
+}
+
+export function nextProviderEnvironmentWithFieldValue(
+  environment: ReadonlyArray<ProviderInstanceEnvironmentVariable> | undefined,
+  field: ProviderEnvironmentFieldDefinition,
+  value: string,
+): ReadonlyArray<ProviderInstanceEnvironmentVariable> {
+  const trimmed = value.trim();
+  const next: ProviderInstanceEnvironmentVariable[] = [];
+  let found = false;
+
+  for (const variable of environment ?? []) {
+    if (variable.name !== field.name) {
+      next.push(variable);
+      continue;
+    }
+    found = true;
+    if (trimmed.length > 0) {
+      next.push({
+        name: variable.name,
+        value: trimmed,
+        sensitive: field.sensitive ?? true,
+      });
+    }
+  }
+
+  if (!found && trimmed.length > 0) {
+    next.push({
+      name: field.name,
+      value: trimmed,
+      sensitive: field.sensitive ?? true,
+    });
+  }
+
+  return next;
+}
+
 export function deriveProviderModelsForDisplay(input: {
   readonly liveModels: ReadonlyArray<ServerProviderModel> | undefined;
   readonly customModels: ReadonlyArray<string>;
@@ -351,6 +400,53 @@ function ProviderEnvironmentSection(props: {
   );
 }
 
+function ProviderEnvironmentFieldRow(props: {
+  readonly field: ProviderEnvironmentFieldDefinition;
+  readonly variable: ProviderInstanceEnvironmentVariable | undefined;
+  readonly idPrefix: string;
+  readonly onCommit: (field: ProviderEnvironmentFieldDefinition, value: string) => void;
+  readonly onRemove: (field: ProviderEnvironmentFieldDefinition) => void;
+}) {
+  const inputId = `${props.idPrefix}-environment-${props.field.name}`;
+  const value = props.variable?.valueRedacted ? "" : (props.variable?.value ?? "");
+  const placeholder = props.variable?.valueRedacted
+    ? "Stored secret - enter a new value to replace"
+    : props.field.placeholder;
+
+  return (
+    <label htmlFor={inputId} className="block">
+      <span className="text-xs font-medium text-foreground">{props.field.label}</span>
+      <div className="mt-1.5 flex min-w-0 items-center gap-2">
+        <DraftInput
+          id={inputId}
+          className="min-w-0 flex-1"
+          type={props.field.sensitive === false ? undefined : "password"}
+          autoComplete="off"
+          value={value}
+          onCommit={(next) => props.onCommit(props.field, next)}
+          placeholder={placeholder}
+          spellCheck={false}
+        />
+        {props.variable ? (
+          <Button
+            type="button"
+            size="icon-sm"
+            variant="ghost"
+            className="size-8 shrink-0 text-muted-foreground hover:text-destructive"
+            onClick={() => props.onRemove(props.field)}
+            aria-label={`Clear ${props.field.label}`}
+          >
+            <XIcon className="size-3.5" />
+          </Button>
+        ) : null}
+      </div>
+      {props.field.description ? (
+        <span className="mt-1 block text-xs text-muted-foreground">{props.field.description}</span>
+      ) : null}
+    </label>
+  );
+}
+
 interface ProviderInstanceCardProps {
   readonly instanceId: ProviderInstanceId;
   readonly instance: ProviderInstanceConfig;
@@ -482,6 +578,12 @@ export function ProviderInstanceCard({
   const visibleTab = driverOption === undefined ? "configuration" : activeTab;
 
   const customModels = readConfigStringArray(instance.config, "customModels");
+  const environmentFields = driverOption?.environmentFields ?? [];
+  const environmentFieldNames = new Set(environmentFields.map((field) => field.name));
+  const genericEnvironment = providerEnvironmentWithoutNames(
+    instance.environment,
+    environmentFieldNames,
+  );
   // Server-returned models may lag behind settings writes. Treat probe
   // models as the source for built-ins only; custom rows come directly
   // from the current instance config so add/remove reflects immediately.
@@ -539,6 +641,23 @@ export function ProviderInstanceCard({
     );
   };
 
+  const updateGenericEnvironment = (
+    environment: ReadonlyArray<ProviderInstanceEnvironmentVariable>,
+  ) => {
+    const dedicatedEnvironment = (instance.environment ?? []).filter((variable) =>
+      environmentFieldNames.has(variable.name),
+    );
+    updateEnvironment([...dedicatedEnvironment, ...environment]);
+  };
+
+  const updateEnvironmentField = (field: ProviderEnvironmentFieldDefinition, value: string) => {
+    updateEnvironment(nextProviderEnvironmentWithFieldValue(instance.environment, field, value));
+  };
+
+  const removeEnvironmentField = (field: ProviderEnvironmentFieldDefinition) => {
+    updateEnvironment(providerEnvironmentWithoutNames(instance.environment, new Set([field.name])));
+  };
+
   const titleIconNode = driverKind ? (
     <ProviderInstanceIcon
       driverKind={driverKind}
@@ -883,9 +1002,23 @@ export function ProviderInstanceCard({
             </div>
 
             <div>
+              {environmentFields.length > 0 ? (
+                <div className="mb-4 grid gap-3">
+                  {environmentFields.map((field) => (
+                    <ProviderEnvironmentFieldRow
+                      key={field.name}
+                      field={field}
+                      variable={readProviderEnvironmentVariable(instance.environment, field.name)}
+                      idPrefix={`provider-instance-${instanceId}`}
+                      onCommit={updateEnvironmentField}
+                      onRemove={removeEnvironmentField}
+                    />
+                  ))}
+                </div>
+              ) : null}
               <ProviderEnvironmentSection
-                environment={instance.environment ?? []}
-                onChange={updateEnvironment}
+                environment={genericEnvironment}
+                onChange={updateGenericEnvironment}
               />
             </div>
 
diff --git a/apps/web/src/components/settings/ProviderSettingsForm.test.ts b/apps/web/src/components/settings/ProviderSettingsForm.test.ts
index af460824c171..ea0d9444873b 100644
--- a/apps/web/src/components/settings/ProviderSettingsForm.test.ts
+++ b/apps/web/src/components/settings/ProviderSettingsForm.test.ts
@@ -37,6 +37,34 @@ describe("ProviderSettingsForm helpers", () => {
     });
   });
 
+  it("uses a dedicated environment field instead of legacy Cursor CLI settings", () => {
+    const cursor = DRIVER_OPTION_BY_VALUE[ProviderDriverKind.make("cursor")];
+
+    expect(cursor).toBeDefined();
+    expect(deriveProviderSettingsFields(cursor!)).toEqual([]);
+    expect(cursor?.environmentFields).toEqual([
+      {
+        name: "CURSOR_API_KEY",
+        label: "Cursor API key",
+        description: "Required by the Cursor Agent SDK.",
+        placeholder: "Paste API key",
+        sensitive: true,
+      },
+    ]);
+  });
+
+  it("exposes ACP Registry as an instance-only configurable driver", () => {
+    const acpRegistry = DRIVER_OPTION_BY_VALUE[ProviderDriverKind.make("acpRegistry")];
+
+    expect(acpRegistry).toBeDefined();
+    expect(acpRegistry?.hasDefaultInstance).toBe(false);
+    expect(deriveProviderSettingsFields(acpRegistry!).map((field) => field.key)).toEqual([
+      "agentId",
+      "commandPath",
+      "authMethodId",
+    ]);
+  });
+
   it("shows the auto-compaction threshold for Claude providers", () => {
     const claude = DRIVER_OPTION_BY_VALUE[ProviderDriverKind.make("claudeAgent")];
     expect(claude).toBeDefined();
diff --git a/apps/web/src/components/settings/ScheduledTasksSettings.tsx b/apps/web/src/components/settings/ScheduledTasksSettings.tsx
new file mode 100644
index 000000000000..a08e60b994a6
--- /dev/null
+++ b/apps/web/src/components/settings/ScheduledTasksSettings.tsx
@@ -0,0 +1,741 @@
+import { useAtomValue } from "@effect/atom-react";
+import { Clock3Icon, PencilIcon, PlayIcon, PlusIcon, Trash2Icon } from "lucide-react";
+import { type ReactNode, useCallback, useEffect, useMemo, useState } from "react";
+import type {
+  ModelSelection,
+  OrchestrationV2ThreadLaunchWorkspaceStrategy,
+  ProjectId,
+  ProviderInteractionMode,
+  RuntimeMode,
+  ScheduledTask,
+  ScheduledTaskId,
+  ScheduledTaskSchedule,
+  ScheduledTaskUpsertInput,
+  ThreadId,
+} from "@t3tools/contracts";
+import { ProviderInstanceId } from "@t3tools/contracts";
+import {
+  isAtomCommandInterrupted,
+  squashAtomCommandFailure,
+} from "@t3tools/client-runtime/state/runtime";
+
+import { cn } from "../../lib/utils";
+import { formatRelativeTime } from "../../timestampFormat";
+import { usePrimarySettings } from "../../hooks/useSettings";
+import { getCustomModelOptionsByInstance } from "../../modelSelection";
+import {
+  applyProviderInstanceSettings,
+  deriveProviderInstanceEntries,
+  sortProviderInstanceEntries,
+} from "../../providerInstances";
+import { usePrimaryEnvironment } from "../../state/environments";
+import { useProjects } from "../../state/entities";
+import { useEnvironmentQuery } from "../../state/query";
+import { primaryServerProvidersAtom, serverEnvironment } from "../../state/server";
+import { useAtomCommand } from "../../state/use-atom-command";
+import { ProviderModelPicker } from "../chat/ProviderModelPicker";
+import { Badge } from "../ui/badge";
+import { Button } from "../ui/button";
+import {
+  Dialog,
+  DialogClose,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogPanel,
+  DialogPopup,
+  DialogTitle,
+} from "../ui/dialog";
+import { Input } from "../ui/input";
+import { Select, SelectItem, SelectPopup, SelectTrigger, SelectValue } from "../ui/select";
+import { Switch } from "../ui/switch";
+import { Textarea } from "../ui/textarea";
+import { stackedThreadToast, toastManager } from "../ui/toast";
+import { Tooltip, TooltipPopup, TooltipTrigger } from "../ui/tooltip";
+import { SettingsPageContainer, SettingsSection, useRelativeTimeTick } from "./settingsLayout";
+
+type ScheduleMode = "fixed" | "interval";
+type WorkspaceMode = "root" | "worktree" | "existing_worktree";
+
+interface DraftState {
+  readonly editingId: string | null;
+  readonly title: string;
+  readonly prompt: string;
+  readonly enabled: boolean;
+  readonly scheduleMode: ScheduleMode;
+  readonly intervalMinutes: string;
+  readonly timeOfDay: string;
+  readonly weekdays: ReadonlySet<number>;
+  readonly projectId: string;
+  readonly threadId: string;
+  readonly workspaceMode: WorkspaceMode;
+  readonly baseRef: string;
+  readonly existingWorktreePath: string;
+  readonly modelKey: string;
+  /** Not editable in the dialog, but preserved so editing an agent-created task keeps its modes. */
+  readonly runtimeMode: RuntimeMode;
+  readonly interactionMode: ProviderInteractionMode;
+  /**
+   * The task's original model selection. The picker only edits
+   * `instanceId:model`; keeping the source object preserves provider options
+   * (reasoning, temperature, …) when the model itself is left unchanged.
+   */
+  readonly baseModelSelection: ModelSelection | null;
+}
+
+/** JS day-of-week (0 = Sunday) rendered Monday-first, matching how people read a week. */
+const WEEKDAY_ORDER = [1, 2, 3, 4, 5, 6, 0] as const;
+const WEEKDAY_LABELS = ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"] as const;
+const WEEKDAY_SHORT = ["Su", "Mo", "Tu", "We", "Th", "Fr", "Sa"] as const;
+const ALL_WEEKDAYS: ReadonlySet<number> = new Set([0, 1, 2, 3, 4, 5, 6]);
+
+const WORKSPACE_MODE_LABELS: Record<WorkspaceMode, string> = {
+  worktree: "Create a new worktree",
+  root: "Use the project checkout",
+  existing_worktree: "Use a specific checkout",
+};
+
+const EMPTY_DRAFT: DraftState = {
+  editingId: null,
+  title: "",
+  prompt: "",
+  enabled: true,
+  scheduleMode: "fixed",
+  intervalMinutes: "15",
+  timeOfDay: "09:00",
+  weekdays: new Set([1, 2, 3, 4, 5]),
+  projectId: "",
+  threadId: "",
+  workspaceMode: "worktree",
+  baseRef: "main",
+  existingWorktreePath: "",
+  modelKey: "",
+  runtimeMode: "full-access",
+  interactionMode: "default",
+  baseModelSelection: null,
+};
+
+/** Labelled field: a caption sitting above its control. */
+function Field({
+  label,
+  hint,
+  htmlFor,
+  children,
+}: {
+  label: string;
+  hint?: string;
+  htmlFor?: string;
+  children: ReactNode;
+}) {
+  return (
+    <div className="space-y-1.5">
+      <label
+        className="flex items-baseline justify-between gap-2 text-xs font-medium text-foreground"
+        htmlFor={htmlFor}
+      >
+        <span>{label}</span>
+        {hint ? (
+          <span className="font-normal text-[11px] text-muted-foreground/80">{hint}</span>
+        ) : null}
+      </label>
+      {children}
+    </div>
+  );
+}
+
+function modelKey(selection: ModelSelection): string {
+  return `${selection.instanceId}:${selection.model}`;
+}
+
+function splitModelKey(value: string): ModelSelection | null {
+  const index = value.indexOf(":");
+  if (index <= 0 || index === value.length - 1) return null;
+  return {
+    instanceId: ProviderInstanceId.make(value.slice(0, index)),
+    model: value.slice(index + 1),
+  };
+}
+
+function scheduleFromDraft(draft: DraftState): ScheduledTaskSchedule {
+  if (draft.scheduleMode === "interval") {
+    const minutes = Math.max(1, Number.parseInt(draft.intervalMinutes, 10) || 1);
+    return { type: "interval", everyMs: minutes * 60_000 };
+  }
+  const selectedEveryDay = draft.weekdays.size === 0 || draft.weekdays.size === 7;
+  return {
+    type: "fixed_time",
+    timeOfDay: draft.timeOfDay || "09:00",
+    ...(selectedEveryDay ? {} : { weekdays: [...draft.weekdays].toSorted() }),
+  };
+}
+
+export function scheduleLabel(schedule: ScheduledTaskSchedule): string {
+  if (schedule.type === "interval") {
+    const minutes = schedule.everyMs / 60_000;
+    return Number.isInteger(minutes)
+      ? `Every ${minutes} min`
+      : `Every ${Math.round(schedule.everyMs / 1000)} sec`;
+  }
+  const weekdays = schedule.weekdays ?? [];
+  const days =
+    weekdays.length === 0
+      ? "Daily"
+      : weekdays.length === 5 && weekdays.every((day) => day >= 1 && day <= 5)
+        ? "Weekdays"
+        : weekdays.map((day) => WEEKDAY_LABELS[day]).join(", ");
+  return `${days} at ${schedule.timeOfDay}`;
+}
+
+/**
+ * Human label for a run timestamp. `formatRelativeTime` only handles the
+ * past, and `nextRunAt` is a future instant — render "in 5m" style labels
+ * for upcoming runs instead of a misleading "just now".
+ */
+export function relativeLabel(value: string | null): string {
+  if (!value) return "Not scheduled";
+  const diffMs = new Date(value).getTime() - Date.now();
+  if (diffMs <= 0) {
+    const relative = formatRelativeTime(value);
+    if (!relative) return "Not scheduled";
+    return relative.suffix ? `${relative.value} ${relative.suffix}` : relative.value;
+  }
+  const minutes = Math.ceil(diffMs / 60_000);
+  if (minutes < 2) return "in under a minute";
+  if (minutes < 60) return `in ${minutes}m`;
+  const hours = Math.round(minutes / 60);
+  if (hours < 24) return `in ${hours}h`;
+  return `in ${Math.round(hours / 24)}d`;
+}
+
+function taskToDraft(task: ScheduledTask): DraftState {
+  const schedule = task.schedule;
+  const weekdays =
+    schedule.type === "fixed_time" && schedule.weekdays && schedule.weekdays.length > 0
+      ? new Set(schedule.weekdays)
+      : new Set(ALL_WEEKDAYS);
+  return {
+    editingId: task.id,
+    title: task.title,
+    prompt: task.prompt,
+    enabled: task.enabled,
+    scheduleMode: schedule.type === "interval" ? "interval" : "fixed",
+    intervalMinutes:
+      schedule.type === "interval"
+        ? String(Math.max(1, Math.round(schedule.everyMs / 60_000)))
+        : "15",
+    timeOfDay: schedule.type === "fixed_time" ? schedule.timeOfDay : "09:00",
+    weekdays,
+    projectId: task.projectId,
+    threadId: task.threadId ?? "",
+    workspaceMode: task.workspaceStrategy.type,
+    baseRef: task.workspaceStrategy.type === "worktree" ? task.workspaceStrategy.baseRef : "main",
+    existingWorktreePath:
+      task.workspaceStrategy.type === "existing_worktree"
+        ? task.workspaceStrategy.worktreePath
+        : "",
+    modelKey: modelKey(task.modelSelection),
+    runtimeMode: task.runtimeMode,
+    interactionMode: task.interactionMode,
+    baseModelSelection: task.modelSelection,
+  };
+}
+
+function statusVariant(status: ScheduledTask["lastRunStatus"]) {
+  if (status === "failed") return "error";
+  if (status === "succeeded") return "success";
+  if (status === "running") return "info";
+  return "outline";
+}
+
+export function ScheduledTasksSettings() {
+  useRelativeTimeTick(15_000);
+  const environment = usePrimaryEnvironment();
+  const projects = useProjects();
+  const settings = usePrimarySettings();
+  const providers = useAtomValue(primaryServerProvidersAtom);
+  // Live subscription: the server pushes a fresh list after every change
+  // (CRUD, run transitions, reschedules), so no manual refresh is needed.
+  const tasksQuery = useEnvironmentQuery(
+    environment
+      ? serverEnvironment.scheduledTasksLive({
+          environmentId: environment.environmentId,
+          input: {},
+        })
+      : null,
+  );
+  const upsertTask = useAtomCommand(serverEnvironment.upsertScheduledTask, {
+    label: "scheduled task upsert",
+  });
+  const deleteTask = useAtomCommand(serverEnvironment.deleteScheduledTask, {
+    label: "scheduled task delete",
+  });
+  const runTaskNow = useAtomCommand(serverEnvironment.runScheduledTaskNow, {
+    label: "scheduled task run now",
+  });
+  const instanceEntries = useMemo(
+    () =>
+      sortProviderInstanceEntries(
+        applyProviderInstanceSettings(deriveProviderInstanceEntries(providers), settings),
+      ),
+    [providers, settings],
+  );
+  const [draft, setDraft] = useState<DraftState>(() => EMPTY_DRAFT);
+  const [dialogOpen, setDialogOpen] = useState(false);
+  const [saving, setSaving] = useState(false);
+  const tasks = tasksQuery.data?.tasks ?? [];
+  const selectedProjectTitle = projects.find((project) => project.id === draft.projectId)?.title;
+
+  // The real model picker is keyed by a `${instanceId}:${model}` string, which
+  // is exactly how the draft stores its selection.
+  const firstInstance = instanceEntries[0];
+  const defaultModelKey =
+    firstInstance && firstInstance.models[0]
+      ? `${firstInstance.instanceId}:${firstInstance.models[0].slug}`
+      : "";
+  const activeSelection = splitModelKey(draft.modelKey || defaultModelKey);
+  const activeInstanceId =
+    activeSelection?.instanceId ?? firstInstance?.instanceId ?? ("" as ProviderInstanceId);
+  const activeModel = activeSelection?.model ?? "";
+  const modelOptionsByInstance = useMemo(
+    () => getCustomModelOptionsByInstance(settings, providers, activeInstanceId, activeModel),
+    [settings, providers, activeInstanceId, activeModel],
+  );
+
+  const openForCreate = useCallback(() => {
+    setDraft({
+      ...EMPTY_DRAFT,
+      projectId: projects[0]?.id ?? "",
+      modelKey: defaultModelKey,
+    });
+    setDialogOpen(true);
+  }, [defaultModelKey, projects]);
+
+  const openForEdit = useCallback((task: ScheduledTask) => {
+    setDraft(taskToDraft(task));
+    setDialogOpen(true);
+  }, []);
+
+  const reportFailure = (title: string, error: unknown) => {
+    toastManager.add(
+      stackedThreadToast({
+        type: "error",
+        title,
+        description: error instanceof Error ? error.message : String(error),
+      }),
+    );
+  };
+
+  const submit = useCallback(async () => {
+    if (!environment || saving) return;
+    const selection = splitModelKey(draft.modelKey || defaultModelKey);
+    if (!draft.title.trim() || !draft.prompt.trim() || !draft.projectId || selection === null) {
+      reportFailure("Schedule task is incomplete", "Add a title, prompt, project, and model.");
+      return;
+    }
+    // Keep the original selection object (with provider options) when the
+    // picker still points at the same instance+model.
+    const modelSelection =
+      draft.baseModelSelection !== null &&
+      draft.baseModelSelection.instanceId === selection.instanceId &&
+      draft.baseModelSelection.model === selection.model
+        ? draft.baseModelSelection
+        : selection;
+    const workspaceStrategy: OrchestrationV2ThreadLaunchWorkspaceStrategy =
+      draft.workspaceMode === "root"
+        ? { type: "root" }
+        : draft.workspaceMode === "existing_worktree"
+          ? { type: "existing_worktree", worktreePath: draft.existingWorktreePath.trim() }
+          : { type: "worktree", baseRef: draft.baseRef.trim() || "main", startFromOrigin: true };
+    const input: ScheduledTaskUpsertInput = {
+      ...(draft.editingId ? { id: draft.editingId as ScheduledTaskId } : {}),
+      title: draft.title.trim(),
+      prompt: draft.prompt.trim(),
+      enabled: draft.enabled,
+      schedule: scheduleFromDraft(draft),
+      projectId: draft.projectId as ProjectId,
+      threadId: draft.threadId ? (draft.threadId as ThreadId) : null,
+      workspaceStrategy,
+      modelSelection,
+      runtimeMode: draft.runtimeMode,
+      interactionMode: draft.interactionMode,
+      creationSource: "web",
+    };
+    setSaving(true);
+    const result = await upsertTask({ environmentId: environment.environmentId, input });
+    setSaving(false);
+    if (result._tag === "Failure") {
+      if (!isAtomCommandInterrupted(result)) {
+        reportFailure("Could not save schedule task", squashAtomCommandFailure(result));
+      }
+      return;
+    }
+    setDialogOpen(false);
+  }, [defaultModelKey, draft, environment, saving, upsertTask]);
+
+  const handleDelete = useCallback(
+    async (task: ScheduledTask) => {
+      if (!environment) return;
+      const result = await deleteTask({
+        environmentId: environment.environmentId,
+        input: { id: task.id },
+      });
+      if (result._tag === "Failure" && !isAtomCommandInterrupted(result)) {
+        reportFailure("Could not delete schedule task", squashAtomCommandFailure(result));
+      }
+    },
+    [deleteTask, environment],
+  );
+
+  const handleRunNow = useCallback(
+    async (task: ScheduledTask) => {
+      if (!environment) return;
+      const result = await runTaskNow({
+        environmentId: environment.environmentId,
+        input: { id: task.id },
+      });
+      if (result._tag === "Failure" && !isAtomCommandInterrupted(result)) {
+        reportFailure("Could not run schedule task", squashAtomCommandFailure(result));
+      }
+    },
+    [environment, runTaskNow],
+  );
+
+  // Keep the draft pointed at a real project once projects load, so a freshly
+  // opened dialog is never stuck on an empty project select.
+  useEffect(() => {
+    if (draft.projectId || projects.length === 0) return;
+    setDraft((current) => ({
+      ...current,
+      projectId: projects[0]?.id ?? "",
+      modelKey: current.modelKey || defaultModelKey,
+    }));
+  }, [defaultModelKey, draft.projectId, projects]);
+
+  return (
+    <SettingsPageContainer className="max-w-3xl">
+      <SettingsSection
+        title="Schedule Tasks"
+        icon={<Clock3Icon className="size-3.5" />}
+        headerAction={
+          <Button size="xs" variant="outline" onClick={openForCreate}>
+            <PlusIcon className="size-3.5" />
+            New
+          </Button>
+        }
+      >
+        {tasksQuery.error ? (
+          <div className="px-5 py-4 text-xs text-destructive">{tasksQuery.error}</div>
+        ) : tasks.length === 0 ? (
+          <div className="flex flex-col items-center gap-3 px-5 py-12 text-center">
+            <div className="grid size-10 place-items-center rounded-full border border-border/70 bg-muted/40 text-muted-foreground">
+              <Clock3Icon className="size-4.5" />
+            </div>
+            <div className="space-y-1">
+              <p className="text-sm font-medium text-foreground">No schedule tasks yet</p>
+              <p className="mx-auto max-w-xs text-xs text-muted-foreground">
+                Create one to run a prompt on a schedule — on an interval or at a fixed time.
+              </p>
+            </div>
+            <Button size="sm" onClick={openForCreate}>
+              <PlusIcon className="size-3.5" />
+              New task
+            </Button>
+          </div>
+        ) : (
+          <div className="divide-y divide-border/60">
+            {tasks.map((task) => (
+              <div key={task.id} className="grid gap-3 px-5 py-4 sm:grid-cols-[minmax(0,1fr)_auto]">
+                <div className="min-w-0 space-y-2">
+                  <div className="flex min-w-0 flex-wrap items-center gap-2">
+                    <h3 className="truncate text-sm font-semibold text-foreground">{task.title}</h3>
+                    <Badge variant={task.enabled ? "success" : "outline"}>
+                      {task.enabled ? "Enabled" : "Paused"}
+                    </Badge>
+                    <Badge variant={statusVariant(task.lastRunStatus)}>{task.lastRunStatus}</Badge>
+                  </div>
+                  <p className="line-clamp-2 text-xs text-muted-foreground">{task.prompt}</p>
+                  <div className="flex flex-wrap gap-x-4 gap-y-1 text-[11px] text-muted-foreground/80">
+                    <span>{scheduleLabel(task.schedule)}</span>
+                    <span>Next: {relativeLabel(task.nextRunAt)}</span>
+                    <span>Runs: {task.runCount}</span>
+                  </div>
+                  {task.lastRunError ? (
+                    <p className="text-[11px] text-destructive">{task.lastRunError}</p>
+                  ) : null}
+                </div>
+                <div className="flex items-start gap-1">
+                  <Tooltip>
+                    <TooltipTrigger
+                      render={
+                        <Button
+                          size="icon-sm"
+                          variant="ghost"
+                          aria-label={`Run ${task.title}`}
+                          onClick={() => void handleRunNow(task)}
+                        >
+                          <PlayIcon className="size-4" />
+                        </Button>
+                      }
+                    />
+                    <TooltipPopup>Run now</TooltipPopup>
+                  </Tooltip>
+                  <Button
+                    size="icon-sm"
+                    variant="ghost"
+                    aria-label={`Edit ${task.title}`}
+                    onClick={() => openForEdit(task)}
+                  >
+                    <PencilIcon className="size-4" />
+                  </Button>
+                  <Button
+                    size="icon-sm"
+                    variant="ghost"
+                    aria-label={`Delete ${task.title}`}
+                    onClick={() => void handleDelete(task)}
+                  >
+                    <Trash2Icon className="size-4" />
+                  </Button>
+                </div>
+              </div>
+            ))}
+          </div>
+        )}
+      </SettingsSection>
+
+      <Dialog open={dialogOpen} onOpenChange={setDialogOpen}>
+        <DialogPopup className="max-w-xl">
+          <DialogHeader>
+            <DialogTitle>{draft.editingId ? "Edit task" : "New task"}</DialogTitle>
+            <DialogDescription>
+              Run a prompt automatically — on an interval or at a fixed time.
+            </DialogDescription>
+          </DialogHeader>
+
+          <DialogPanel className="space-y-5">
+            <Field label="Name" htmlFor="scheduled-task-title">
+              <Input
+                id="scheduled-task-title"
+                placeholder="e.g. Check for Sentry issues"
+                value={draft.title}
+                onChange={(event) =>
+                  setDraft((current) => ({ ...current, title: event.target.value }))
+                }
+              />
+            </Field>
+
+            <div className="grid gap-3 sm:grid-cols-2">
+              <Field label="Project">
+                <Select
+                  value={draft.projectId}
+                  onValueChange={(projectId) =>
+                    setDraft((current) => ({ ...current, projectId: projectId ?? "" }))
+                  }
+                >
+                  <SelectTrigger size="sm">
+                    <SelectValue placeholder="Select a project">{selectedProjectTitle}</SelectValue>
+                  </SelectTrigger>
+                  <SelectPopup>
+                    {projects.map((project) => (
+                      <SelectItem key={project.id} value={project.id}>
+                        {project.title}
+                      </SelectItem>
+                    ))}
+                  </SelectPopup>
+                </Select>
+              </Field>
+
+              <Field label="Workspace">
+                <Select
+                  value={draft.workspaceMode}
+                  onValueChange={(value) =>
+                    setDraft((current) => ({ ...current, workspaceMode: value as WorkspaceMode }))
+                  }
+                >
+                  <SelectTrigger size="sm">
+                    <SelectValue>{WORKSPACE_MODE_LABELS[draft.workspaceMode]}</SelectValue>
+                  </SelectTrigger>
+                  <SelectPopup>
+                    <SelectItem value="worktree">Create a new worktree</SelectItem>
+                    <SelectItem value="root">Use the project checkout</SelectItem>
+                    <SelectItem value="existing_worktree">Use a specific checkout</SelectItem>
+                  </SelectPopup>
+                </Select>
+              </Field>
+            </div>
+
+            {draft.workspaceMode === "worktree" ? (
+              <Field label="Base ref" htmlFor="scheduled-task-base-ref">
+                <Input
+                  id="scheduled-task-base-ref"
+                  value={draft.baseRef}
+                  placeholder="main"
+                  onChange={(event) =>
+                    setDraft((current) => ({ ...current, baseRef: event.target.value }))
+                  }
+                />
+              </Field>
+            ) : null}
+            {draft.workspaceMode === "existing_worktree" ? (
+              <Field label="Checkout path" htmlFor="scheduled-task-checkout">
+                <Input
+                  id="scheduled-task-checkout"
+                  value={draft.existingWorktreePath}
+                  placeholder="/path/to/checkout"
+                  onChange={(event) =>
+                    setDraft((current) => ({
+                      ...current,
+                      existingWorktreePath: event.target.value,
+                    }))
+                  }
+                />
+              </Field>
+            ) : null}
+
+            <Field label="Prompt" htmlFor="scheduled-task-prompt">
+              <Textarea
+                id="scheduled-task-prompt"
+                placeholder="What should the agent do each time this runs?"
+                value={draft.prompt}
+                onChange={(event) =>
+                  setDraft((current) => ({ ...current, prompt: event.target.value }))
+                }
+              />
+            </Field>
+
+            <Field label="Model">
+              <ProviderModelPicker
+                activeInstanceId={activeInstanceId}
+                model={activeModel}
+                lockedProvider={null}
+                instanceEntries={instanceEntries}
+                modelOptionsByInstance={modelOptionsByInstance}
+                triggerVariant="outline"
+                triggerClassName="w-full max-w-none justify-between text-foreground/90 hover:text-foreground"
+                onInstanceModelChange={(instanceId, model) =>
+                  setDraft((current) => ({ ...current, modelKey: `${instanceId}:${model}` }))
+                }
+              />
+            </Field>
+
+            <div className="space-y-3">
+              <div className="flex items-center justify-between gap-2">
+                <span className="text-xs font-medium text-foreground">Schedule</span>
+                <div className="inline-flex items-center gap-0.5 rounded-lg border border-border/70 bg-muted/40 p-0.5">
+                  {(
+                    [
+                      ["fixed", "Daily"],
+                      ["interval", "Interval"],
+                    ] as const
+                  ).map(([mode, label]) => (
+                    <button
+                      key={mode}
+                      type="button"
+                      aria-pressed={draft.scheduleMode === mode}
+                      className={cn(
+                        "rounded-md px-2.5 py-1 text-xs font-medium transition-colors",
+                        draft.scheduleMode === mode
+                          ? "bg-background text-foreground shadow-xs"
+                          : "text-muted-foreground hover:text-foreground",
+                      )}
+                      onClick={() => setDraft((current) => ({ ...current, scheduleMode: mode }))}
+                    >
+                      {label}
+                    </button>
+                  ))}
+                </div>
+              </div>
+
+              {draft.scheduleMode === "fixed" ? (
+                <div className="flex flex-wrap items-center gap-3">
+                  <div className="flex items-center gap-2">
+                    <span className="text-xs text-muted-foreground">Run at</span>
+                    <Input
+                      type="time"
+                      nativeInput
+                      className="w-32"
+                      value={draft.timeOfDay}
+                      onChange={(event) =>
+                        setDraft((current) => ({ ...current, timeOfDay: event.target.value }))
+                      }
+                    />
+                    <span className="text-xs text-muted-foreground">on</span>
+                  </div>
+                  <div className="flex flex-wrap gap-1.5">
+                    {WEEKDAY_ORDER.map((day) => {
+                      const selected = draft.weekdays.has(day);
+                      return (
+                        <button
+                          key={day}
+                          type="button"
+                          aria-pressed={selected}
+                          aria-label={WEEKDAY_LABELS[day]}
+                          className={cn(
+                            "grid size-8 place-items-center rounded-full border text-[11px] font-semibold transition-colors",
+                            selected
+                              ? "border-primary bg-primary text-primary-foreground shadow-xs"
+                              : "border-border text-muted-foreground hover:bg-accent hover:text-foreground",
+                          )}
+                          onClick={() =>
+                            setDraft((current) => {
+                              const weekdays = new Set(current.weekdays);
+                              if (weekdays.has(day)) {
+                                // Keep at least one day selected: an empty set
+                                // would silently persist as a daily schedule.
+                                if (weekdays.size === 1) return current;
+                                weekdays.delete(day);
+                              } else {
+                                weekdays.add(day);
+                              }
+                              return { ...current, weekdays };
+                            })
+                          }
+                        >
+                          {WEEKDAY_SHORT[day]}
+                        </button>
+                      );
+                    })}
+                  </div>
+                </div>
+              ) : (
+                <div className="flex items-center gap-2">
+                  <span className="text-xs text-muted-foreground">Run every</span>
+                  <Input
+                    type="number"
+                    nativeInput
+                    min={1}
+                    className="w-24"
+                    value={draft.intervalMinutes}
+                    onChange={(event) =>
+                      setDraft((current) => ({ ...current, intervalMinutes: event.target.value }))
+                    }
+                  />
+                  <span className="text-xs text-muted-foreground">minutes</span>
+                </div>
+              )}
+            </div>
+
+            <div className="flex items-center justify-between gap-3 rounded-lg border border-border/60 bg-muted/20 px-3 py-2.5">
+              <div className="min-w-0">
+                <div className="text-xs font-medium">Enabled</div>
+                <div className="text-[11px] text-muted-foreground">
+                  Disabled tasks stay saved but do not run.
+                </div>
+              </div>
+              <Switch
+                checked={draft.enabled}
+                onCheckedChange={(enabled) => setDraft((current) => ({ ...current, enabled }))}
+              />
+            </div>
+          </DialogPanel>
+
+          <DialogFooter>
+            <DialogClose render={<Button variant="outline" size="sm" />}>Cancel</DialogClose>
+            <Button size="sm" disabled={saving} onClick={() => void submit()}>
+              {draft.editingId ? "Save task" : "Create task"}
+            </Button>
+          </DialogFooter>
+        </DialogPopup>
+      </Dialog>
+    </SettingsPageContainer>
+  );
+}
diff --git a/apps/web/src/components/settings/SettingsPanels.tsx b/apps/web/src/components/settings/SettingsPanels.tsx
index b486a0eefea4..a1b17eb12ef9 100644
--- a/apps/web/src/components/settings/SettingsPanels.tsx
+++ b/apps/web/src/components/settings/SettingsPanels.tsx
@@ -11,6 +11,7 @@ import {
   type SidebarProjectGroupingMode,
 } from "@t3tools/contracts";
 import { scopeThreadRef } from "@t3tools/client-runtime/environment";
+import { presentThreadShell } from "@t3tools/client-runtime/state/shell";
 import {
   isAtomCommandInterrupted,
   settlePromise,
@@ -575,6 +576,7 @@ export function useSettingsRestore(onRestored?: () => void) {
       settings.fontSizeTerminal,
       settings.glassOpacity,
       settings.enableLegacyTokenStreaming,
+      settings.persistComposerContextStrip,
       settings.enableProviderUpdateChecks,
       settings.sidebarAutoSettleAfterDays,
       settings.sidebarAutoSettleOnMerge,
@@ -655,6 +657,7 @@ export function useSettingsRestore(onRestored?: () => void) {
       appearanceContrast: DEFAULT_UNIFIED_SETTINGS.appearanceContrast,
       timestampFormat: DEFAULT_UNIFIED_SETTINGS.timestampFormat,
       wordWrap: DEFAULT_UNIFIED_SETTINGS.wordWrap,
+      persistComposerContextStrip: DEFAULT_UNIFIED_SETTINGS.persistComposerContextStrip,
       diffIgnoreWhitespace: DEFAULT_UNIFIED_SETTINGS.diffIgnoreWhitespace,
       showSkillsInSlashMenu: DEFAULT_UNIFIED_SETTINGS.showSkillsInSlashMenu,
       environmentIdentificationMode: DEFAULT_UNIFIED_SETTINGS.environmentIdentificationMode,
@@ -1165,6 +1168,58 @@ export function AppearanceSettingsPanel() {
             }
           />
         ) : null}
+
+        <SettingsRow
+          {...searchableSetting("word-wrap")}
+          description="Wrap long lines in code blocks, tables, diffs, and file previews by default."
+          resetAction={
+            settings.wordWrap !== DEFAULT_UNIFIED_SETTINGS.wordWrap ? (
+              <SettingResetButton
+                label="word wrapping"
+                onClick={() =>
+                  updateSettings({
+                    wordWrap: DEFAULT_UNIFIED_SETTINGS.wordWrap,
+                  })
+                }
+              />
+            ) : null
+          }
+          control={
+            <Switch
+              checked={settings.wordWrap}
+              onCheckedChange={(checked) => updateSettings({ wordWrap: Boolean(checked) })}
+              aria-label="Wrap code, tables, diffs, and file previews by default"
+            />
+          }
+        />
+
+        <SettingsRow
+          {...searchableSetting("composer-context")}
+          description="Keep branch and worktree controls below the composer after a thread starts."
+          resetAction={
+            settings.persistComposerContextStrip !==
+            DEFAULT_UNIFIED_SETTINGS.persistComposerContextStrip ? (
+              <SettingResetButton
+                label="composer context"
+                onClick={() =>
+                  updateSettings({
+                    persistComposerContextStrip:
+                      DEFAULT_UNIFIED_SETTINGS.persistComposerContextStrip,
+                  })
+                }
+              />
+            ) : null
+          }
+          control={
+            <Switch
+              checked={settings.persistComposerContextStrip}
+              onCheckedChange={(checked) =>
+                updateSettings({ persistComposerContextStrip: Boolean(checked) })
+              }
+              aria-label="Keep composer context visible in active threads"
+            />
+          }
+        />
       </SettingsSection>
 
       <TypographySection />
@@ -2561,10 +2616,7 @@ export function ArchivedThreadsPanel() {
       ),
     );
     const threads = archivedSnapshots.flatMap(({ environmentId, snapshot }) =>
-      snapshot.threads.map((thread) => ({
-        ...thread,
-        environmentId,
-      })),
+      snapshot.threads.map((thread) => presentThreadShell(environmentId, thread)),
     );
 
     const archivedProjects = Array.from(projectsByEnvironmentAndId.values());
diff --git a/apps/web/src/components/settings/SettingsSidebarNav.tsx b/apps/web/src/components/settings/SettingsSidebarNav.tsx
index 734c2989d917..6277f778179c 100644
--- a/apps/web/src/components/settings/SettingsSidebarNav.tsx
+++ b/apps/web/src/components/settings/SettingsSidebarNav.tsx
@@ -11,6 +11,8 @@ import {
   ArchiveIcon,
   BlocksIcon,
   BotIcon,
+  CalendarClockIcon,
+  FlaskConicalIcon,
   GitBranchIcon,
   KeyboardIcon,
   Link2Icon,
@@ -51,6 +53,7 @@ const SETTINGS_SECTION_ICONS: Readonly<
   "/settings/keybindings": KeyboardIcon,
   "/settings/providers": BotIcon,
   "/settings/integrations": BlocksIcon,
+  "/settings/scheduled-tasks": CalendarClockIcon,
   "/settings/source-control": GitBranchIcon,
   "/settings/connections": Link2Icon,
   "/settings/archived": ArchiveIcon,
diff --git a/apps/web/src/components/settings/providerDriverMeta.ts b/apps/web/src/components/settings/providerDriverMeta.ts
index bfee6a8d6807..45ae5a79921b 100644
--- a/apps/web/src/components/settings/providerDriverMeta.ts
+++ b/apps/web/src/components/settings/providerDriverMeta.ts
@@ -1,4 +1,5 @@
 import {
+  AcpRegistrySettings,
   ClaudeSettings,
   CodexSettings,
   CursorSettings,
@@ -7,7 +8,15 @@ import {
   ProviderDriverKind,
 } from "@t3tools/contracts";
 import type * as Schema from "effect/Schema";
-import { ClaudeAI, CursorIcon, GrokIcon, type Icon, OpenAI, OpenCodeIcon } from "../Icons";
+import {
+  ACPRegistryIcon,
+  ClaudeAI,
+  CursorIcon,
+  GrokIcon,
+  type Icon,
+  OpenAI,
+  OpenCodeIcon,
+} from "../Icons";
 
 type ProviderSettingsSchema = {
   readonly fields: Readonly<Record<string, Schema.Top>>;
@@ -24,6 +33,9 @@ export interface ProviderClientDefinition {
   readonly label: string;
   readonly icon: Icon;
   readonly settingsSchema: ProviderSettingsSchema;
+  readonly environmentFields?: readonly ProviderEnvironmentFieldDefinition[];
+  /** Whether this driver has a built-in default instance backed by legacy settings. */
+  readonly hasDefaultInstance?: boolean;
   /**
    * Optional short label rendered as a `variant="warning"` badge next to
    * the instance title. Used to flag drivers that still ship under an
@@ -34,6 +46,14 @@ export interface ProviderClientDefinition {
   readonly badgeLabel?: string;
 }
 
+export interface ProviderEnvironmentFieldDefinition {
+  readonly name: string;
+  readonly label: string;
+  readonly description?: string;
+  readonly placeholder?: string;
+  readonly sensitive?: boolean;
+}
+
 export const PROVIDER_CLIENT_DEFINITIONS: readonly ProviderClientDefinition[] = [
   {
     value: ProviderDriverKind.make("codex"),
@@ -51,16 +71,31 @@ export const PROVIDER_CLIENT_DEFINITIONS: readonly ProviderClientDefinition[] =
     value: ProviderDriverKind.make("cursor"),
     label: "Cursor",
     icon: CursorIcon,
-    badgeLabel: "Early Access",
     settingsSchema: CursorSettings,
+    environmentFields: [
+      {
+        name: "CURSOR_API_KEY",
+        label: "Cursor API key",
+        description: "Required by the Cursor Agent SDK.",
+        placeholder: "Paste API key",
+        sensitive: true,
+      },
+    ],
   },
   {
     value: ProviderDriverKind.make("grok"),
     label: "Grok",
     icon: GrokIcon,
-    badgeLabel: "Early Access",
     settingsSchema: GrokSettings,
   },
+  {
+    value: ProviderDriverKind.make("acpRegistry"),
+    label: "ACP Registry",
+    icon: ACPRegistryIcon,
+    badgeLabel: "V2 Preview",
+    settingsSchema: AcpRegistrySettings,
+    hasDefaultInstance: false,
+  },
   {
     value: ProviderDriverKind.make("opencode"),
     label: "OpenCode",
diff --git a/apps/web/src/components/settings/settingsSearch.test.ts b/apps/web/src/components/settings/settingsSearch.test.ts
index 9ed854b87d24..4063b0f6d95a 100644
--- a/apps/web/src/components/settings/settingsSearch.test.ts
+++ b/apps/web/src/components/settings/settingsSearch.test.ts
@@ -92,6 +92,10 @@ describe("searchSettings", () => {
       id: "word-wrap",
       to: "/settings/appearance",
     });
+    expect(searchSettings("composer context")[0]).toMatchObject({
+      id: "composer-context",
+      to: "/settings/appearance",
+    });
     expect(searchSettings("environment identification")[0]).toMatchObject({
       id: "environment-identification",
       to: "/settings/appearance",
diff --git a/apps/web/src/components/settings/settingsSearch.ts b/apps/web/src/components/settings/settingsSearch.ts
index b924f5f6a510..882cac3f8705 100644
--- a/apps/web/src/components/settings/settingsSearch.ts
+++ b/apps/web/src/components/settings/settingsSearch.ts
@@ -6,6 +6,7 @@ export type SettingsPath =
   | "/settings/keybindings"
   | "/settings/providers"
   | "/settings/integrations"
+  | "/settings/scheduled-tasks"
   | "/settings/source-control"
   | "/settings/connections"
   | "/settings/archived";
@@ -30,6 +31,7 @@ export const SETTINGS_SECTION_LABELS: Readonly<Record<SettingsPath, string>> = {
   "/settings/keybindings": "Keybindings",
   "/settings/providers": "Providers",
   "/settings/integrations": "Integrations",
+  "/settings/scheduled-tasks": "Schedule Tasks",
   "/settings/source-control": "Source Control",
   "/settings/connections": "Connections",
   "/settings/archived": "Archive",
@@ -106,6 +108,11 @@ export const SETTINGS_SEARCH_ITEMS = [
     title: "Word wrap",
     to: "/settings/appearance",
   },
+  {
+    id: "composer-context",
+    title: "Composer context",
+    to: "/settings/appearance",
+  },
   {
     id: "project-grouping",
     title: "Project grouping",
diff --git a/apps/web/src/components/ui/popover.tsx b/apps/web/src/components/ui/popover.tsx
index 9534112e4e72..de0f83834ffc 100644
--- a/apps/web/src/components/ui/popover.tsx
+++ b/apps/web/src/components/ui/popover.tsx
@@ -19,20 +19,24 @@ function PopoverTrigger({ className, children, ...props }: PopoverPrimitive.Trig
 function PopoverPopup({
   children,
   className,
+  positionerClassName,
   viewportClassName,
   side = "bottom",
   align = "center",
   sideOffset = 4,
   alignOffset = 0,
+  collisionAvoidance,
   tooltipStyle = false,
   anchor,
   ...props
 }: PopoverPrimitive.Popup.Props & {
+  positionerClassName?: string;
   viewportClassName?: string;
   side?: PopoverPrimitive.Positioner.Props["side"];
   align?: PopoverPrimitive.Positioner.Props["align"];
   sideOffset?: PopoverPrimitive.Positioner.Props["sideOffset"];
   alignOffset?: PopoverPrimitive.Positioner.Props["alignOffset"];
+  collisionAvoidance?: PopoverPrimitive.Positioner.Props["collisionAvoidance"];
   tooltipStyle?: boolean;
   anchor?: PopoverPrimitive.Positioner.Props["anchor"];
 }) {
@@ -42,7 +46,11 @@ function PopoverPopup({
         align={align}
         alignOffset={alignOffset}
         anchor={anchor}
-        className="z-[130] h-(--positioner-height) w-(--positioner-width) max-w-(--available-width) transition-transform data-instant:transition-none"
+        collisionAvoidance={collisionAvoidance}
+        className={cn(
+          "z-[130] h-(--positioner-height) w-(--positioner-width) max-w-(--available-width) transition-[top,left,right,bottom,transform] data-instant:transition-none",
+          positionerClassName,
+        )}
         data-slot="popover-positioner"
         side={side}
         sideOffset={sideOffset}
diff --git a/apps/web/src/connection/runtime.ts b/apps/web/src/connection/runtime.ts
index b63d01999036..6fc111e77709 100644
--- a/apps/web/src/connection/runtime.ts
+++ b/apps/web/src/connection/runtime.ts
@@ -1,6 +1,9 @@
 import { Connection } from "@t3tools/client-runtime/connection";
 import { shellSnapshotLoaderLayer } from "@t3tools/client-runtime/state/shell";
-import { threadSnapshotLoaderLayer } from "@t3tools/client-runtime/state/threads";
+import {
+  boundedThreadSnapshotLoaderLayer,
+  threadHistoryControllerLayer,
+} from "@t3tools/client-runtime/state/threads";
 import { pullRequestDiffLoaderLayer } from "@t3tools/client-runtime/state/pull-requests";
 import * as Layer from "effect/Layer";
 import { Atom } from "effect/unstable/reactivity";
@@ -17,8 +20,9 @@ const providedConnectionPlatformLayer = connectionPlatformLayer.pipe(
 );
 
 const snapshotLoaderLayer = Layer.mergeAll(
-  threadSnapshotLoaderLayer,
+  boundedThreadSnapshotLoaderLayer,
   shellSnapshotLoaderLayer,
+  threadHistoryControllerLayer,
   pullRequestDiffLoaderLayer,
 );
 
diff --git a/apps/web/src/connection/storage.ts b/apps/web/src/connection/storage.ts
index 4ae476c1d11f..c2efacfbf9ae 100644
--- a/apps/web/src/connection/storage.ts
+++ b/apps/web/src/connection/storage.ts
@@ -6,6 +6,10 @@ import {
   ConnectionTargetStore,
   EMPTY_CONNECTION_CATALOG_DOCUMENT,
   EnvironmentCacheStore,
+  ORCHESTRATION_CACHE_SCHEMA_VERSION,
+  StoredOrchestrationShellSnapshot,
+  StoredOrchestrationThreadSnapshot,
+  decodeOrDiscardOrchestrationCache,
   registerConnectionInCatalog,
   removeCatalogValue,
   removeConnectionFromCatalog,
@@ -17,14 +21,7 @@ import {
   CredentialStore,
   ProfileStore,
 } from "@t3tools/client-runtime/connection";
-import {
-  EnvironmentId,
-  OrchestrationShellSnapshot,
-  OrchestrationThreadDetailSnapshot,
-  ServerConfig,
-  ThreadId,
-  VcsListRefsResult,
-} from "@t3tools/contracts";
+import { EnvironmentId, ServerConfig, ThreadId, VcsListRefsResult } from "@t3tools/contracts";
 import * as Context from "effect/Context";
 import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
@@ -41,26 +38,9 @@ const THREAD_STORE_NAME = "thread";
 const SERVER_CONFIG_STORE_NAME = "server-config";
 const VCS_REFS_STORE_NAME = "vcs-refs";
 const CATALOG_KEY = "document";
-const SHELL_SNAPSHOT_CACHE_SCHEMA_VERSION = 1;
-
-const StoredShellSnapshot = Schema.Struct({
-  schemaVersion: Schema.Literal(SHELL_SNAPSHOT_CACHE_SCHEMA_VERSION),
-  environmentId: EnvironmentId,
-  snapshot: OrchestrationShellSnapshot,
-});
+const StoredShellSnapshot = StoredOrchestrationShellSnapshot;
 const StoredShellSnapshotJson = Schema.fromJsonString(StoredShellSnapshot);
-// v2 stores the snapshot sequence alongside the thread so a warm cache can
-// resume via `afterSequence` instead of re-downloading the full thread body.
-// v3 adds windowed (paginated) snapshots carrying `page` metadata. The bump
-// exists for rollback safety: a pre-pagination client would decode a windowed
-// v2 record, silently drop the unknown `page` field, and treat the partial
-// thread as complete forever. Older entries fail to decode → cold cache.
-const StoredThreadSnapshot = Schema.Struct({
-  schemaVersion: Schema.Literal(3),
-  environmentId: EnvironmentId,
-  threadId: ThreadId,
-  snapshot: OrchestrationThreadDetailSnapshot,
-});
+const StoredThreadSnapshot = StoredOrchestrationThreadSnapshot;
 const StoredThreadSnapshotJson = Schema.fromJsonString(StoredThreadSnapshot);
 const StoredServerConfig = Schema.Struct({
   schemaVersion: Schema.Literal(1),
@@ -472,25 +452,24 @@ export const connectionStorageLayer = Layer.effectContext(
             if (typeof raw !== "string") {
               return Effect.succeed(Option.none());
             }
-            return decodeStoredShellSnapshot(raw).pipe(
-              Effect.mapError((cause) => persistenceError("load-shell", cause)),
-              Effect.map((stored) =>
-                stored.environmentId === environmentId
-                  ? Option.some(stored.snapshot)
-                  : Option.none(),
+            return decodeOrDiscardOrchestrationCache(
+              decodeStoredShellSnapshot(raw).pipe(
+                Effect.mapError((cause) => persistenceError("load-shell", cause)),
+                Effect.map((stored) =>
+                  stored.environmentId === environmentId
+                    ? Option.some(stored.snapshot)
+                    : Option.none(),
+                ),
               ),
+              removeDatabaseValue(database, SHELL_STORE_NAME, environmentId),
             );
           }),
-          Effect.mapError((cause) =>
-            cause._tag === "ConnectionPersistenceError"
-              ? cause
-              : persistenceError("load-shell", cause),
-          ),
+          Effect.mapError((cause) => persistenceError("load-shell", cause)),
         ),
       saveShell: (environmentId, snapshot) =>
         Effect.gen(function* () {
           const encoded = yield* encodeStoredShellSnapshot({
-            schemaVersion: SHELL_SNAPSHOT_CACHE_SCHEMA_VERSION,
+            schemaVersion: ORCHESTRATION_CACHE_SCHEMA_VERSION,
             environmentId,
             snapshot,
           }).pipe(Effect.mapError((cause) => persistenceError("save-shell", cause)));
@@ -546,33 +525,36 @@ export const connectionStorageLayer = Layer.effectContext(
             if (typeof raw !== "string") {
               return Effect.succeed(Option.none());
             }
-            return decodeStoredThreadSnapshot(raw).pipe(
-              Effect.mapError((cause) => persistenceError("load-thread", cause)),
-              Effect.map((stored) =>
-                stored.environmentId === environmentId && stored.threadId === threadId
-                  ? Option.some(stored.snapshot)
-                  : Option.none(),
+            return decodeOrDiscardOrchestrationCache(
+              decodeStoredThreadSnapshot(raw).pipe(
+                Effect.mapError((cause) => persistenceError("load-thread", cause)),
+                Effect.map((stored) =>
+                  stored.environmentId === environmentId && stored.threadId === threadId
+                    ? Option.some(stored.snapshot)
+                    : Option.none(),
+                ),
+              ),
+              removeDatabaseValue(
+                database,
+                THREAD_STORE_NAME,
+                threadCacheKey(environmentId, threadId),
               ),
             );
           }),
-          Effect.mapError((cause) =>
-            cause._tag === "ConnectionPersistenceError"
-              ? cause
-              : persistenceError("load-thread", cause),
-          ),
+          Effect.mapError((cause) => persistenceError("load-thread", cause)),
         ),
       saveThread: (environmentId, snapshot) =>
         Effect.gen(function* () {
           const encoded = yield* encodeStoredThreadSnapshot({
-            schemaVersion: 3,
+            schemaVersion: ORCHESTRATION_CACHE_SCHEMA_VERSION,
             environmentId,
-            threadId: snapshot.thread.id,
+            threadId: snapshot.projection.thread.id,
             snapshot,
           }).pipe(Effect.mapError((cause) => persistenceError("save-thread", cause)));
           yield* writeDatabaseValue(
             database,
             THREAD_STORE_NAME,
-            threadCacheKey(environmentId, snapshot.thread.id),
+            threadCacheKey(environmentId, snapshot.projection.thread.id),
             encoded,
           );
         }).pipe(
diff --git a/apps/web/src/diffFileActions.test.ts b/apps/web/src/diffFileActions.test.ts
index c5d3571a9c1e..4a51e54f283d 100644
--- a/apps/web/src/diffFileActions.test.ts
+++ b/apps/web/src/diffFileActions.test.ts
@@ -12,7 +12,7 @@ const THREAD_REF = scopeThreadRef(
 
 describe("openDiffFilePrimaryAction", () => {
   beforeEach(() => {
-    useRightPanelStore.setState({ byThreadKey: {} });
+    useRightPanelStore.setState({ byThreadKey: {}, threadPanelVisibilityByThreadKey: {} });
   });
 
   it("opens diff files in the thread file viewer", () => {
diff --git a/apps/web/src/diffPanelStore.test.ts b/apps/web/src/diffPanelStore.test.ts
index 7e7c95921f05..405135f491cc 100644
--- a/apps/web/src/diffPanelStore.test.ts
+++ b/apps/web/src/diffPanelStore.test.ts
@@ -1,5 +1,5 @@
 import { scopeThreadRef } from "@t3tools/client-runtime/environment";
-import { EnvironmentId, ThreadId, TurnId } from "@t3tools/contracts";
+import { EnvironmentId, ThreadId, RunId } from "@t3tools/contracts";
 import { beforeEach, describe, expect, it } from "vite-plus/test";
 
 import { selectThreadDiffPanelSelection, useDiffPanelStore } from "./diffPanelStore";
@@ -35,29 +35,15 @@ describe("diffPanelStore", () => {
     expect(useDiffPanelStore.getState().diffRenderMode).toBe("split");
   });
 
-  it("defaults each thread to branch changes when the working tree is clean", () => {
+  it("defaults each thread to branch changes with automatic base selection", () => {
     expect(
       selectThreadDiffPanelSelection(useDiffPanelStore.getState().byThreadKey, THREAD_REF),
     ).toEqual({ kind: "branch", baseRef: null });
   });
 
-  it("defaults each thread to working changes when the working tree is dirty", () => {
-    expect(
-      selectThreadDiffPanelSelection(useDiffPanelStore.getState().byThreadKey, THREAD_REF, true),
-    ).toEqual({ kind: "unstaged" });
-  });
-
-  it("preserves an explicit scope selection when the working tree state changes", () => {
-    useDiffPanelStore.getState().selectGitScope(THREAD_REF, "branch");
-
-    expect(
-      selectThreadDiffPanelSelection(useDiffPanelStore.getState().byThreadKey, THREAD_REF, true),
-    ).toEqual({ kind: "branch", baseRef: null });
-  });
-
   it("clears incompatible selection fields when changing scopes", () => {
     const store = useDiffPanelStore.getState();
-    store.selectTurn(THREAD_REF, TurnId.make("turn-1"), "src/app.ts");
+    store.selectTurn(THREAD_REF, RunId.make("turn-1"), "src/app.ts");
     store.selectGitScope(THREAD_REF, "unstaged");
 
     expect(
@@ -71,7 +57,7 @@ describe("diffPanelStore", () => {
   });
 
   it("increments the reveal request when opening the same turn file again", () => {
-    const turnId = TurnId.make("turn-1");
+    const turnId = RunId.make("turn-1");
     useDiffPanelStore.getState().selectTurn(THREAD_REF, turnId, "src/app.ts");
     useDiffPanelStore.getState().selectTurn(THREAD_REF, turnId, "src/app.ts");
 
@@ -91,8 +77,8 @@ describe("diffPanelStore", () => {
   });
 
   it("reconciles a missing turn selection to the latest available turn", () => {
-    const missingTurnId = TurnId.make("turn-missing");
-    const latestTurnId = TurnId.make("turn-latest");
+    const missingTurnId = RunId.make("turn-missing");
+    const latestTurnId = RunId.make("turn-latest");
     useDiffPanelStore.getState().selectTurn(THREAD_REF, missingTurnId, "src/app.ts");
     useDiffPanelStore.getState().reconcileTurnSelection(THREAD_REF, [latestTurnId]);
 
diff --git a/apps/web/src/diffPanelStore.ts b/apps/web/src/diffPanelStore.ts
index ebb560a23832..da4231bd0ebf 100644
--- a/apps/web/src/diffPanelStore.ts
+++ b/apps/web/src/diffPanelStore.ts
@@ -1,5 +1,5 @@
 import { scopedThreadKey } from "@t3tools/client-runtime/environment";
-import type { ScopedThreadRef, TurnId } from "@t3tools/contracts";
+import type { RunId, ScopedThreadRef } from "@t3tools/contracts";
 import { create } from "zustand";
 import { createJSONStorage, persist } from "zustand/middleware";
 
@@ -8,7 +8,7 @@ import { resolveStorage } from "./lib/storage";
 export type DiffPanelSelection =
   | { kind: "branch"; baseRef: string | null }
   | { kind: "unstaged" }
-  | { kind: "turn"; turnId: TurnId; filePath: string | null; revealRequestId: number };
+  | { kind: "turn"; turnId: RunId; filePath: string | null; revealRequestId: number };
 
 export type DiffRenderMode = "stacked" | "split";
 
@@ -22,8 +22,8 @@ interface DiffPanelStoreState {
   setDiffRenderMode: (mode: DiffRenderMode) => void;
   selectGitScope: (ref: ScopedThreadRef, scope: "branch" | "unstaged") => void;
   selectBranchBaseRef: (ref: ScopedThreadRef, baseRef: string | null) => void;
-  selectTurn: (ref: ScopedThreadRef, turnId: TurnId, filePath?: string) => void;
-  reconcileTurnSelection: (ref: ScopedThreadRef, availableTurnIds: ReadonlyArray<TurnId>) => void;
+  selectTurn: (ref: ScopedThreadRef, turnId: RunId, filePath?: string) => void;
+  reconcileTurnSelection: (ref: ScopedThreadRef, availableTurnIds: ReadonlyArray<RunId>) => void;
   removeThread: (ref: ScopedThreadRef) => void;
 }
 
@@ -125,7 +125,7 @@ export const useDiffPanelStore = create<DiffPanelStoreState>()(
     }),
     {
       name: "t3code:diff-panel-state:v1",
-      version: 1,
+      version: 2,
       storage: createJSONStorage(() =>
         resolveStorage(typeof window !== "undefined" ? window.localStorage : undefined),
       ),
diff --git a/apps/web/src/hooks/useElementWidth.ts b/apps/web/src/hooks/useElementWidth.ts
new file mode 100644
index 000000000000..d3f60eeea159
--- /dev/null
+++ b/apps/web/src/hooks/useElementWidth.ts
@@ -0,0 +1,25 @@
+import { useLayoutEffect, useState } from "react";
+
+export function useElementWidth<T extends HTMLElement>() {
+  const [element, setElement] = useState<T | null>(null);
+  const [width, setWidth] = useState<number | null>(null);
+
+  useLayoutEffect(() => {
+    if (!element) return;
+
+    const update = (nextWidth: number) => {
+      setWidth((currentWidth) => (currentWidth === nextWidth ? currentWidth : nextWidth));
+    };
+
+    update(element.getBoundingClientRect().width);
+    if (typeof ResizeObserver === "undefined") return;
+
+    const observer = new ResizeObserver(([entry]) => {
+      if (entry) update(entry.contentRect.width);
+    });
+    observer.observe(element);
+    return () => observer.disconnect();
+  }, [element]);
+
+  return [setElement, width] as const;
+}
diff --git a/apps/web/src/hooks/useHandleNewThread.ts b/apps/web/src/hooks/useHandleNewThread.ts
index 78e17a76b374..77f4caaa11e2 100644
--- a/apps/web/src/hooks/useHandleNewThread.ts
+++ b/apps/web/src/hooks/useHandleNewThread.ts
@@ -23,7 +23,7 @@ import {
   selectProjectGroupingSettings,
 } from "../logicalProject";
 import { resolveDefaultThreadEnvMode } from "@t3tools/shared/threadEnvMode";
-import { readThreadShell, useProjects, useThread } from "../state/entities";
+import { readThreadShell, useProjects, useServerConfigs, useThreadShell } from "../state/entities";
 import {
   resolveNewDraftStartFromOrigin,
   resolveNewThreadModelSelectionOverride,
@@ -482,7 +482,7 @@ export function useHandleNewThread() {
     select: (params) => resolveThreadRouteTarget(params),
   });
   const routeThreadRef = routeTarget?.kind === "server" ? routeTarget.threadRef : null;
-  const activeThread = useThread(routeThreadRef);
+  const activeThread = useThreadShell(routeThreadRef);
   const getDraftThread = useComposerDraftStore((store) => store.getDraftThread);
   const activeDraftThread = useComposerDraftStore(() =>
     routeTarget
diff --git a/apps/web/src/hooks/usePreviewPanelInlineSize.ts b/apps/web/src/hooks/usePreviewPanelInlineSize.ts
new file mode 100644
index 000000000000..24868d17e8f6
--- /dev/null
+++ b/apps/web/src/hooks/usePreviewPanelInlineSize.ts
@@ -0,0 +1,91 @@
+import { type RefObject, useEffect, useLayoutEffect, useState } from "react";
+
+import { type ResizableWidthHandlers, useResizableWidth } from "./useResizableWidth";
+
+export interface PreviewPanelInlineSize {
+  readonly width: number;
+  readonly handlers: ResizableWidthHandlers;
+}
+
+const PREVIEW_PANEL_WIDTH_STORAGE_KEY = "t3code:preview-panel-width";
+const PREVIEW_PANEL_MIN_WIDTH = 360;
+/**
+ * Upper bound as a fraction of the viewport; only binds on wide screens.
+ * On narrow windows the container clamp below is what preserves the
+ * sibling column's usable width.
+ */
+const PREVIEW_PANEL_MAX_WIDTH_FRACTION = 0.7;
+/**
+ * Floor for the column beside the panel: below this the chat column's
+ * composer overflows, so the panel yields instead.
+ */
+const SIBLING_COLUMN_MIN_WIDTH = 360;
+const PREVIEW_PANEL_DEFAULT_WIDTH = 540;
+
+export function usePreviewPanelInlineSize(
+  hostRef?: RefObject<HTMLElement | null>,
+): PreviewPanelInlineSize {
+  const maxWidth = useViewportClampedMaxWidth(hostRef);
+  return useResizableWidth({
+    storageKey: PREVIEW_PANEL_WIDTH_STORAGE_KEY,
+    defaultWidth: PREVIEW_PANEL_DEFAULT_WIDTH,
+    minWidth: PREVIEW_PANEL_MIN_WIDTH,
+    maxWidth,
+    edge: "left",
+  });
+}
+
+/**
+ * Keep the resizable panel's upper bound in sync with the window AND the row
+ * it sits in. Resize-aware so dragging the OS window narrower (or expanding
+ * the app sidebar) re-clamps the stored width on the next render.
+ */
+function useViewportClampedMaxWidth(hostRef?: RefObject<HTMLElement | null>): number {
+  const [vw, setVw] = useState(() => (typeof window === "undefined" ? 1280 : window.innerWidth));
+  const [containerWidth, setContainerWidth] = useState<number | undefined>(undefined);
+  useEffect(() => {
+    if (typeof window === "undefined") return;
+    let frame = 0;
+    const onResize = () => {
+      if (frame !== 0) return;
+      frame = window.requestAnimationFrame(() => {
+        frame = 0;
+        setVw(window.innerWidth);
+      });
+    };
+    window.addEventListener("resize", onResize);
+    return () => {
+      window.removeEventListener("resize", onResize);
+      if (frame !== 0) window.cancelAnimationFrame(frame);
+    };
+  }, []);
+  useLayoutEffect(() => {
+    const parent = hostRef?.current?.parentElement;
+    if (!parent) return;
+    // Measure before first paint: the persisted width must be clamped against
+    // the row on the initial render, not one observer tick later (the panel
+    // would flash over-wide on every mount). clientWidth is integral, so
+    // sub-pixel resize deltas bail out of re-rendering.
+    const measure = () => {
+      setContainerWidth(parent.clientWidth);
+    };
+    measure();
+    if (typeof ResizeObserver === "undefined") return;
+    const observer = new ResizeObserver(measure);
+    observer.observe(parent);
+    return () => {
+      observer.disconnect();
+    };
+  }, [hostRef]);
+  return getPreviewPanelMaxWidth(vw, containerWidth);
+}
+export function getPreviewPanelMaxWidth(viewportWidth: number, containerWidth?: number): number {
+  const fractionCap = Math.floor(viewportWidth * PREVIEW_PANEL_MAX_WIDTH_FRACTION);
+  const containerCap =
+    containerWidth === undefined ? Infinity : Math.floor(containerWidth) - SIBLING_COLUMN_MIN_WIDTH;
+  // Never below the panel's own minimum: when the row cannot fit both
+  // columns' minimums the sibling yields, and useResizableWidth's clamp must
+  // not see max < min (it would resolve the inversion to min and, via
+  // drag-end persistence, overwrite the user's stored width).
+  return Math.max(PREVIEW_PANEL_MIN_WIDTH, Math.min(fractionCap, containerCap));
+}
diff --git a/apps/web/src/hooks/useThreadActionMenu.ts b/apps/web/src/hooks/useThreadActionMenu.ts
index 1602e5cf816d..493c98f7662e 100644
--- a/apps/web/src/hooks/useThreadActionMenu.ts
+++ b/apps/web/src/hooks/useThreadActionMenu.ts
@@ -141,7 +141,7 @@ export function useThreadActionMenu(input: {
           isSnoozed: supports.snooze && effectiveSnoozed(thread, { now: now.toISOString() }),
           canSnoozeNow: canSnooze(thread, { now: now.toISOString() }),
           isRegeneratingTitle,
-          isRunning: thread.session?.status === "running" && thread.session.activeTurnId != null,
+          isRunning: thread.runtime?.status === "running" && thread.runtime.activeRunId != null,
           supports,
           snoozePresets,
         });
@@ -232,7 +232,10 @@ export function useThreadActionMenu(input: {
             );
             return;
           case "mark-unread":
-            markThreadUnread(scopedThreadKey(threadRef), thread.latestTurn?.completedAt);
+            markThreadUnread(
+              scopedThreadKey(threadRef),
+              thread.latestRun?.completedAt ?? undefined,
+            );
             return;
           case "copy-path": {
             const workspacePath = thread.worktreePath ?? projectCwd;
diff --git a/apps/web/src/hooks/useThreadActions.ts b/apps/web/src/hooks/useThreadActions.ts
index 527081dcf7ac..390f26be97e0 100644
--- a/apps/web/src/hooks/useThreadActions.ts
+++ b/apps/web/src/hooks/useThreadActions.ts
@@ -27,13 +27,14 @@ import {
   readEnvironmentSupportsPinReorder,
   readEnvironmentSupportsSettlement,
   readEnvironmentSupportsSnooze,
+  readEnvironmentSupportsVisitedTracking,
   readEnvironmentThreadRefs,
   readProject,
   readThreadShell,
   readThreadShells,
 } from "../state/entities";
-import { useTerminalUiStateStore } from "../terminalUiStateStore";
 import { useUiStateStore } from "../uiStateStore";
+import { useTerminalUiStateStore } from "../terminalUiStateStore";
 import { buildThreadRouteParams, resolveThreadRouteRef } from "../threadRoutes";
 import { formatWorktreePathForDisplay, getOrphanedWorktreePathForThread } from "../worktreeCleanup";
 import { stackedThreadToast, toastManager } from "../components/ui/toast";
@@ -156,6 +157,32 @@ export async function requestThreadUnpinConfirmation(input: {
   );
 }
 
+/**
+ * Marks a thread unread. Servers with visited tracking own the unread marker
+ * (thread.mark-unread rewinds the server-side visited watermark, syncing the
+ * marker to every device); older servers keep the browser-local marker.
+ */
+export function useMarkThreadUnread() {
+  const markThreadUnreadMutation = useAtomCommand(threadEnvironment.markUnread, {
+    reportFailure: false,
+  });
+  const markThreadUnreadLocal = useUiStateStore((state) => state.markThreadUnread);
+  return useCallback(
+    (target: ScopedThreadRef) => {
+      if (readEnvironmentSupportsVisitedTracking(target.environmentId)) {
+        void markThreadUnreadMutation({
+          environmentId: target.environmentId,
+          input: { threadId: target.threadId },
+        });
+        return;
+      }
+      const thread = readThreadShell(target);
+      markThreadUnreadLocal(scopedThreadKey(target), thread?.latestRun?.completedAt);
+    },
+    [markThreadUnreadLocal, markThreadUnreadMutation],
+  );
+}
+
 export function useThreadActions() {
   const closeTerminal = useAtomCommand(terminalEnvironment.close);
   const archiveThreadMutation = useAtomCommand(threadEnvironment.archive, {
@@ -188,6 +215,7 @@ export function useThreadActions() {
   const unsnoozeThreadMutation = useAtomCommand(threadEnvironment.unsnooze, {
     reportFailure: false,
   });
+  const markThreadUnread = useMarkThreadUnread();
   const stopThreadSession = useAtomCommand(threadEnvironment.stopSession);
   const removeWorktree = useAtomCommand(vcsEnvironment.removeWorktree, {
     reportFailure: false,
@@ -233,7 +261,7 @@ export function useThreadActions() {
       const resolved = resolveThreadTarget(target);
       if (!resolved) return AsyncResult.success(undefined);
       const { thread, threadRef } = resolved;
-      if (thread.session?.status === "running" && thread.session.activeTurnId != null) {
+      if (thread.runtime?.status === "running" && thread.runtime.activeRunId != null) {
         return AsyncResult.failure(
           Cause.fail(
             new ThreadArchiveBlockedError({
@@ -355,7 +383,7 @@ export function useThreadActions() {
         shouldDeleteWorktree = confirmationResult.value;
       }
 
-      if (thread.session && thread.session.status !== "stopped") {
+      if (thread.runtime !== null) {
         await stopThreadSession({
           environmentId: threadRef.environmentId,
           input: { threadId: threadRef.threadId },
@@ -752,12 +780,14 @@ export function useThreadActions() {
       unpinThread,
       confirmAndUnpinThread,
       reorderPinnedThread,
+      markThreadUnread,
     }),
     [
       archiveThread,
       confirmAndDeleteThread,
       confirmAndUnpinThread,
       deleteThread,
+      markThreadUnread,
       pinThread,
       reorderPinnedThread,
       settleThread,
diff --git a/apps/web/src/hooks/useThreadVisitedMigration.ts b/apps/web/src/hooks/useThreadVisitedMigration.ts
new file mode 100644
index 000000000000..812e3b0c91ef
--- /dev/null
+++ b/apps/web/src/hooks/useThreadVisitedMigration.ts
@@ -0,0 +1,45 @@
+import { scopeThreadRef, scopedThreadKey } from "@t3tools/client-runtime/environment";
+import { useEffect } from "react";
+
+import { useThreadShells } from "../state/entities";
+import { threadEnvironment } from "../state/threads";
+import { useAtomCommand } from "../state/use-atom-command";
+import { useUiStateStore } from "../uiStateStore";
+
+// Module-level so each thread is considered once per page load. The visit
+// command is idempotent server-side (the server keeps max(stored, supplied)),
+// so repeats across page loads are harmless — this only avoids re-dispatching
+// within a session.
+const migratedThreadKeys = new Set<string>();
+
+/**
+ * One-way migration of the browser-local visited watermarks into servers with
+ * visited tracking. Before tracking existed, "Done" lived in this browser's
+ * localStorage; pushing those watermarks up seeds the server value so other
+ * devices see the same read state. The server never rewinds a newer visit, so
+ * this cannot clobber progress made elsewhere.
+ */
+export function useThreadVisitedMigration(): void {
+  const threads = useThreadShells();
+  const visitThreadMutation = useAtomCommand(threadEnvironment.visit, { reportFailure: false });
+  useEffect(() => {
+    for (const thread of threads) {
+      // Field absent → the environment's server has no visited tracking; keep
+      // the local value in play and reconsider if the server upgrades.
+      if (thread.lastVisitedAt === undefined) continue;
+      const threadKey = scopedThreadKey(scopeThreadRef(thread.environmentId, thread.id));
+      if (migratedThreadKeys.has(threadKey)) continue;
+      migratedThreadKeys.add(threadKey);
+      const local = useUiStateStore.getState().threadLastVisitedAtById[threadKey];
+      if (!local) continue;
+      const localMs = Date.parse(local);
+      if (!Number.isFinite(localMs)) continue;
+      const serverMs = thread.lastVisitedAt === null ? null : Date.parse(thread.lastVisitedAt);
+      if (serverMs !== null && Number.isFinite(serverMs) && serverMs >= localMs) continue;
+      void visitThreadMutation({
+        environmentId: thread.environmentId,
+        input: { threadId: thread.id, visitedAt: local },
+      });
+    }
+  }, [threads, visitThreadMutation]);
+}
diff --git a/apps/web/src/hooks/useTurnDiffSummaries.ts b/apps/web/src/hooks/useTurnDiffSummaries.ts
index f51acc15cc0f..e3720206818c 100644
--- a/apps/web/src/hooks/useTurnDiffSummaries.ts
+++ b/apps/web/src/hooks/useTurnDiffSummaries.ts
@@ -1,19 +1,21 @@
 import { useMemo } from "react";
-import { inferCheckpointTurnCountByTurnId } from "../session-logic";
-import type { Thread, TurnDiffSummary } from "../types";
+import { deriveThreadCheckpointSummaries } from "@t3tools/client-runtime/state/thread-checkpoints";
+import type { OrchestrationV2ThreadProjection } from "@t3tools/contracts";
+import { inferCheckpointTurnCountByRunId } from "../session-logic";
+import type { TurnDiffSummary } from "../types";
 
-export function useTurnDiffSummaries(activeThread: Thread | null | undefined) {
+export function useTurnDiffSummaries(projection: OrchestrationV2ThreadProjection | null) {
   const turnDiffSummaries = useMemo<ReadonlyArray<TurnDiffSummary>>(() => {
-    if (!activeThread) {
+    if (projection === null) {
       return [];
     }
-    return activeThread.checkpoints;
-  }, [activeThread]);
+    return deriveThreadCheckpointSummaries(projection);
+  }, [projection]);
 
-  const inferredCheckpointTurnCountByTurnId = useMemo(
-    () => inferCheckpointTurnCountByTurnId(turnDiffSummaries),
+  const inferredCheckpointTurnCountByRunId = useMemo(
+    () => inferCheckpointTurnCountByRunId(turnDiffSummaries),
     [turnDiffSummaries],
   );
 
-  return { turnDiffSummaries, inferredCheckpointTurnCountByTurnId };
+  return { turnDiffSummaries, inferredCheckpointTurnCountByRunId };
 }
diff --git a/apps/web/src/index.css b/apps/web/src/index.css
index 7653ce9bd9ef..1100bc4951d8 100644
--- a/apps/web/src/index.css
+++ b/apps/web/src/index.css
@@ -111,6 +111,9 @@ html[data-mobile-composer-route-transition="true"]::view-transition-old(t3-mobil
   --workspace-native-controls-inset: 0px;
   --workspace-titlebar-control-size: 1.75rem;
   --workspace-titlebar-control-gap: 0.75rem;
+  --chat-content-max-width: 46rem;
+  --thread-details-panel-width: 19.5rem;
+  --thread-details-panel-inset: 0px;
 
   @variant dark {
     --appearance-contrast-target: white;
@@ -763,6 +766,182 @@ html[data-mobile-composer-route-transition="true"]::view-transition-old(t3-mobil
     outline: none;
   }
 
+  .surface-subheader {
+    @apply flex h-10 min-h-10 shrink-0 items-center border-b border-border/60 bg-background;
+  }
+
+  [data-preview-panel-mode="inline"] [data-right-panel-surface-content] [data-surface-subheader] {
+    height: calc(var(--spacing) * 7);
+    min-height: calc(var(--spacing) * 7);
+    margin-bottom: calc(var(--spacing) * 3);
+    border-bottom-color: transparent;
+  }
+
+  .chat-content-lane {
+    margin-inline: auto;
+    width: 100%;
+    min-width: 0;
+    max-width: var(--chat-content-max-width);
+  }
+
+  [data-thread-details-inline-reserved="true"] {
+    --thread-details-panel-inset: var(--thread-details-panel-width);
+  }
+
+  .messages-timeline-row-frame {
+    padding-inline-start: 0.75rem;
+    padding-inline-end: calc(0.75rem + var(--thread-details-panel-inset));
+  }
+
+  .chat-scroll-to-bottom {
+    inset-inline-start: 0;
+    inset-inline-end: var(--thread-details-panel-inset);
+  }
+
+  .alert-glass {
+    --alert-glass-tint: transparent;
+
+    background:
+      linear-gradient(
+        color-mix(in srgb, var(--alert-glass-tint) 4%, transparent),
+        color-mix(in srgb, var(--alert-glass-tint) 4%, transparent)
+      ),
+      color-mix(in srgb, var(--background) var(--glass-opacity), transparent) !important;
+    -webkit-backdrop-filter: blur(var(--glass-blur)) saturate(var(--glass-saturation));
+    backdrop-filter: blur(var(--glass-blur)) saturate(var(--glass-saturation));
+  }
+
+  .alert-glass[data-variant="error"] {
+    --alert-glass-tint: var(--destructive);
+  }
+
+  .alert-glass[data-variant="info"] {
+    --alert-glass-tint: var(--info);
+  }
+
+  .alert-glass[data-variant="success"] {
+    --alert-glass-tint: var(--success);
+  }
+
+  .alert-glass[data-variant="warning"] {
+    --alert-glass-tint: var(--warning);
+  }
+
+  .glass-opacity-slider {
+    --glass-slider-progress: 0%;
+    --glass-slider-fill-offset: 0.5rem;
+    --glass-slider-fill-position: calc(
+      var(--glass-slider-progress) + var(--glass-slider-fill-offset)
+    );
+    appearance: none;
+    height: 1.5rem;
+    background: transparent;
+    cursor: pointer;
+  }
+
+  .glass-opacity-slider::-webkit-slider-runnable-track {
+    height: 0.375rem;
+    border-radius: 9999px;
+    background: linear-gradient(
+      to right,
+      var(--primary) 0 var(--glass-slider-fill-position),
+      color-mix(in srgb, var(--muted-foreground) 22%, transparent) var(--glass-slider-fill-position)
+        100%
+    );
+    box-shadow: inset 0 0 0 1px color-mix(in srgb, var(--border) 55%, transparent);
+  }
+
+  .glass-opacity-slider::-moz-range-track {
+    height: 0.375rem;
+    border-radius: 9999px;
+    background: color-mix(in srgb, var(--muted-foreground) 22%, transparent);
+    box-shadow: inset 0 0 0 1px color-mix(in srgb, var(--border) 55%, transparent);
+  }
+
+  .glass-opacity-slider::-moz-range-progress {
+    height: 0.375rem;
+    border-radius: 9999px;
+    background: var(--primary);
+  }
+
+  .glass-opacity-slider::-webkit-slider-thumb {
+    appearance: none;
+    width: 1rem;
+    height: 1rem;
+    margin-top: -0.3125rem;
+    border: 2px solid var(--primary);
+    border-radius: 9999px;
+    background: var(--background);
+    box-shadow: 0 1px 2px color-mix(in srgb, var(--foreground) 12%, transparent);
+    transition:
+      transform 120ms ease,
+      box-shadow 120ms ease;
+  }
+
+  .glass-opacity-slider::-moz-range-thumb {
+    width: 1rem;
+    height: 1rem;
+    border: 2px solid var(--primary);
+    border-radius: 9999px;
+    background: var(--background);
+    box-shadow: 0 1px 2px color-mix(in srgb, var(--foreground) 12%, transparent);
+    transition:
+      transform 120ms ease,
+      box-shadow 120ms ease;
+  }
+
+  .glass-opacity-slider:hover::-webkit-slider-thumb {
+    transform: scale(1.08);
+    box-shadow: 0 1px 3px color-mix(in srgb, var(--foreground) 20%, transparent);
+  }
+
+  .glass-opacity-slider:hover::-moz-range-thumb {
+    transform: scale(1.08);
+    box-shadow: 0 1px 3px color-mix(in srgb, var(--foreground) 20%, transparent);
+  }
+
+  .glass-opacity-slider:active::-webkit-slider-thumb {
+    transform: scale(0.94);
+  }
+
+  .glass-opacity-slider:active::-moz-range-thumb {
+    transform: scale(0.94);
+  }
+
+  .glass-opacity-slider:focus-visible {
+    outline: none;
+  }
+
+  .glass-opacity-slider:focus-visible::-webkit-slider-thumb {
+    box-shadow:
+      0 0 0 3px var(--background),
+      0 0 0 5px var(--ring);
+  }
+
+  .glass-opacity-slider:focus-visible::-moz-range-thumb {
+    box-shadow:
+      0 0 0 3px var(--background),
+      0 0 0 5px var(--ring);
+  }
+
+  @media (forced-colors: active) {
+    .glass-opacity-slider {
+      appearance: auto;
+      accent-color: Highlight;
+    }
+
+    .glass-opacity-slider::-webkit-slider-runnable-track,
+    .glass-opacity-slider::-webkit-slider-thumb {
+      all: revert;
+    }
+
+    .glass-opacity-slider::-moz-range-track,
+    .glass-opacity-slider::-moz-range-progress,
+    .glass-opacity-slider::-moz-range-thumb {
+      all: revert;
+    }
+  }
+
   .settings-slider {
     --settings-slider-progress: 0%;
     --settings-slider-fill-offset: 0.5rem;
@@ -877,6 +1056,13 @@ html[data-mobile-composer-route-transition="true"]::view-transition-old(t3-mobil
       all: revert;
     }
   }
+
+  @media (min-width: 40rem) {
+    .messages-timeline-row-frame {
+      padding-inline-start: 1.25rem;
+      padding-inline-end: calc(1.25rem + var(--thread-details-panel-inset));
+    }
+  }
 }
 
 /* Safe-area inset utilities for surfaces that opt into edge-to-edge rendering.
@@ -1074,7 +1260,6 @@ html[data-mobile-composer-route-transition="true"]::view-transition-old(t3-mobil
    compatibility overrides so both navigation implementations receive the
    same palette. Success, info, provider, and channel identity colors remain
    independent; error, warning, and update roles are themeable below. */
-
 /* The non-empty marker adds enough specificity to outrank the generated root
    dark variant without reintroducing raw `.dark` selectors. */
 html[data-theme-id]:not([data-theme-id=""]) {
diff --git a/apps/web/src/keybindings.test.ts b/apps/web/src/keybindings.test.ts
index b6b98d7389b3..d59610205cab 100644
--- a/apps/web/src/keybindings.test.ts
+++ b/apps/web/src/keybindings.test.ts
@@ -558,6 +558,13 @@ describe("chat/editor shortcuts", () => {
         platform: "Linux",
       }),
     );
+    assert.isFalse(
+      isOpenFavoriteEditorShortcut(
+        event({ key: "o", metaKey: true, repeat: true }),
+        DEFAULT_BINDINGS,
+        { platform: "MacIntel" },
+      ),
+    );
   });
 
   it("matches commandPalette.toggle shortcut outside terminal focus", () => {
@@ -577,6 +584,38 @@ describe("chat/editor shortcuts", () => {
     );
   });
 
+  it("resolves a user-configured thread panel shortcut without assigning a default", () => {
+    const bindings = compile([
+      { shortcut: modShortcut("b", { shiftKey: true }), command: "threadPanel.toggle" },
+    ]);
+
+    assert.strictEqual(
+      resolveShortcutCommand(event({ key: "b", metaKey: true, shiftKey: true }), bindings, {
+        platform: "MacIntel",
+      }),
+      "threadPanel.toggle",
+    );
+  });
+
+  it("matches themeEditor.toggle on macOS and Windows", () => {
+    assert.strictEqual(
+      resolveShortcutCommand(
+        event({ key: "t", metaKey: true, altKey: true, shiftKey: true }),
+        DEFAULT_BINDINGS,
+        { platform: "MacIntel" },
+      ),
+      "themeEditor.toggle",
+    );
+    assert.strictEqual(
+      resolveShortcutCommand(
+        event({ key: "t", ctrlKey: true, altKey: true, shiftKey: true }),
+        DEFAULT_BINDINGS,
+        { platform: "Win32" },
+      ),
+      "themeEditor.toggle",
+    );
+  });
+
   it("matches filePicker.toggle shortcut outside terminal focus", () => {
     assert.strictEqual(
       resolveShortcutCommand(event({ key: "p", metaKey: true }), DEFAULT_BINDINGS, {
@@ -611,25 +650,6 @@ describe("chat/editor shortcuts", () => {
     );
   });
 
-  it("matches themeEditor.toggle on macOS and Windows", () => {
-    assert.strictEqual(
-      resolveShortcutCommand(
-        event({ key: "t", metaKey: true, altKey: true, shiftKey: true }),
-        DEFAULT_BINDINGS,
-        { platform: "MacIntel" },
-      ),
-      "themeEditor.toggle",
-    );
-    assert.strictEqual(
-      resolveShortcutCommand(
-        event({ key: "t", ctrlKey: true, altKey: true, shiftKey: true }),
-        DEFAULT_BINDINGS,
-        { platform: "Win32" },
-      ),
-      "themeEditor.toggle",
-    );
-  });
-
   it("matches diff.toggle shortcut outside terminal focus", () => {
     assert.isTrue(
       isDiffToggleShortcut(event({ key: "d", metaKey: true }), DEFAULT_BINDINGS, {
diff --git a/apps/web/src/keybindings.ts b/apps/web/src/keybindings.ts
index eb4637df21be..6c5dbf82a713 100644
--- a/apps/web/src/keybindings.ts
+++ b/apps/web/src/keybindings.ts
@@ -14,6 +14,7 @@ export interface ShortcutEventLike {
   type?: string;
   code?: string;
   key: string;
+  repeat?: boolean;
   metaKey: boolean;
   ctrlKey: boolean;
   shiftKey: boolean;
@@ -456,7 +457,10 @@ export function isOpenFavoriteEditorShortcut(
   keybindings: ResolvedKeybindingsConfig,
   options?: ShortcutMatchOptions,
 ): boolean {
-  return matchesCommandShortcut(event, keybindings, "editor.openFavorite", options);
+  return (
+    event.repeat !== true &&
+    matchesCommandShortcut(event, keybindings, "editor.openFavorite", options)
+  );
 }
 
 export function isTerminalClearShortcut(
diff --git a/apps/web/src/lib/contextWindow.test.ts b/apps/web/src/lib/contextWindow.test.ts
index b87c0664403e..ecacd84b148d 100644
--- a/apps/web/src/lib/contextWindow.test.ts
+++ b/apps/web/src/lib/contextWindow.test.ts
@@ -1,86 +1,64 @@
 import { describe, expect, it } from "vite-plus/test";
-import { EventId, type OrchestrationThreadActivity, TurnId } from "@t3tools/contracts";
-
+import * as DateTime from "effect/DateTime";
 import { deriveLatestContextWindowSnapshot, formatContextWindowTokens } from "./contextWindow";
 
-function makeActivity(id: string, kind: string, payload: unknown): OrchestrationThreadActivity {
-  return {
-    id: EventId.make(id),
-    tone: "info",
-    kind,
-    summary: kind,
-    payload,
-    turnId: TurnId.make("turn-1"),
-    createdAt: "2026-03-23T00:00:00.000Z",
-  };
-}
-
-describe("contextWindow", () => {
-  it("derives the latest valid context window snapshot", () => {
+describe("V2 context window presentation", () => {
+  it("uses retained compaction token data when available", () => {
     const snapshot = deriveLatestContextWindowSnapshot([
-      makeActivity("activity-1", "context-window.updated", {
-        usedTokens: 1000,
-      }),
-      makeActivity("activity-2", "tool.started", {}),
-      makeActivity("activity-3", "context-window.updated", {
-        usedTokens: 14_000,
-        maxTokens: 258_000,
-        compactsAutomatically: true,
-        autoCompactThreshold: 200_000,
-      }),
+      {
+        item: {
+          id: "compaction-1" as never,
+          threadId: "thread-1" as never,
+          runId: null,
+          nodeId: null,
+          providerThreadId: null,
+          providerTurnId: null,
+          nativeItemRef: null,
+          parentItemId: null,
+          ordinal: 1,
+          status: "completed",
+          title: null,
+          startedAt: null,
+          completedAt: null,
+          updatedAt: DateTime.makeUnsafe("2026-06-20T00:00:00.000Z"),
+          type: "compaction",
+          driver: null,
+          beforeTokenCount: 10_000,
+          afterTokenCount: 2_000,
+        },
+      },
     ]);
-
-    expect(snapshot).not.toBeNull();
-    expect(snapshot?.usedTokens).toBe(14_000);
-    expect(snapshot?.totalProcessedTokens).toBeNull();
-    expect(snapshot?.maxTokens).toBe(258_000);
-    expect(snapshot?.compactsAutomatically).toBe(true);
-    expect(snapshot?.autoCompactThreshold).toBe(200_000);
+    expect(snapshot?.usedTokens).toBe(2_000);
+    expect(snapshot?.totalProcessedTokens).toBe(10_000);
   });
 
-  it("ignores malformed payloads", () => {
-    const snapshot = deriveLatestContextWindowSnapshot([
-      makeActivity("activity-1", "context-window.updated", {}),
-    ]);
-
-    expect(snapshot).toBeNull();
+  it("formats compact token values", () => {
+    expect(formatContextWindowTokens(1_500)).toBe("1.5k");
   });
+});
 
-  it("keeps valid zero-usage snapshots", () => {
-    const snapshot = deriveLatestContextWindowSnapshot([
-      makeActivity("activity-1", "context-window.updated", {
-        usedTokens: 0,
-        maxTokens: 100_000,
-      }),
-    ]);
-
-    expect(snapshot).toMatchObject({
-      usedTokens: 0,
-      maxTokens: 100_000,
-      remainingTokens: 100_000,
-      usedPercentage: 0,
-      remainingPercentage: 100,
+describe("live provider-turn usage (#8144)", () => {
+  it("prefers the provider's live report over compaction items", () => {
+    const snapshot = deriveLatestContextWindowSnapshot([], {
+      usedTokens: 42_000,
+      maxTokens: 200_000,
+      inputTokens: 40_000,
+      outputTokens: 2_000,
+      updatedAt: "2026-08-27T00:00:00.000Z",
     });
+    expect(snapshot).not.toBeNull();
+    expect(snapshot?.usedTokens).toBe(42_000);
+    expect(snapshot?.maxTokens).toBe(200_000);
+    expect(snapshot?.remainingTokens).toBe(158_000);
+    expect(snapshot?.usedPercentage).toBe(21);
   });
 
-  it("formats compact token counts", () => {
-    expect(formatContextWindowTokens(999)).toBe("999");
-    expect(formatContextWindowTokens(1400)).toBe("1.4k");
-    expect(formatContextWindowTokens(14_000)).toBe("14k");
-    expect(formatContextWindowTokens(258_000)).toBe("258k");
-  });
-
-  it("includes total processed tokens when available", () => {
-    const snapshot = deriveLatestContextWindowSnapshot([
-      makeActivity("activity-1", "context-window.updated", {
-        usedTokens: 81_659,
-        totalProcessedTokens: 748_126,
-        maxTokens: 258_400,
-        lastUsedTokens: 81_659,
-      }),
-    ]);
-
-    expect(snapshot?.usedTokens).toBe(81_659);
-    expect(snapshot?.totalProcessedTokens).toBe(748_126);
+  it("handles a report without a known context window", () => {
+    const snapshot = deriveLatestContextWindowSnapshot([], {
+      usedTokens: 42_000,
+      updatedAt: "2026-08-27T00:00:00.000Z",
+    });
+    expect(snapshot?.maxTokens).toBeNull();
+    expect(snapshot?.usedPercentage).toBeNull();
   });
 });
diff --git a/apps/web/src/lib/contextWindow.ts b/apps/web/src/lib/contextWindow.ts
index 3ba24cb2c2b4..fa90ad8865bf 100644
--- a/apps/web/src/lib/contextWindow.ts
+++ b/apps/web/src/lib/contextWindow.ts
@@ -1,17 +1,14 @@
-import type { OrchestrationThreadActivity, ThreadTokenUsageSnapshot } from "@t3tools/contracts";
-
-function asRecord(value: unknown): Record<string, unknown> | null {
-  return value && typeof value === "object" ? (value as Record<string, unknown>) : null;
-}
+import type {
+  OrchestrationV2ProviderTurnTokenUsage,
+  OrchestrationV2TurnItem,
+  ThreadTokenUsageSnapshot,
+} from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
 
 function asFiniteNumber(value: unknown): number | null {
   return typeof value === "number" && Number.isFinite(value) ? value : null;
 }
 
-function asBoolean(value: unknown): boolean | null {
-  return typeof value === "boolean" ? value : null;
-}
-
 type NullableContextWindowUsage = {
   readonly [Key in keyof ThreadTokenUsageSnapshot]: undefined extends ThreadTokenUsageSnapshot[Key]
     ? Exclude<ThreadTokenUsageSnapshot[Key], undefined> | null
@@ -47,22 +44,56 @@ export function formatProviderDisplayName(provider: string | null | undefined):
   }
 }
 
+/** Prefers the provider's live usage report (#8144); falls back to the last compaction item. */
 export function deriveLatestContextWindowSnapshot(
-  activities: ReadonlyArray<OrchestrationThreadActivity>,
+  entries: ReadonlyArray<{
+    readonly item: OrchestrationV2TurnItem;
+  }>,
+  liveUsage?: OrchestrationV2ProviderTurnTokenUsage | null,
 ): ContextWindowSnapshot | null {
-  for (let index = activities.length - 1; index >= 0; index -= 1) {
-    const activity = activities[index];
-    if (!activity || activity.kind !== "context-window.updated") {
+  if (liveUsage != null) {
+    const usedTokens = Math.max(0, liveUsage.usedTokens);
+    const maxTokens = liveUsage.maxTokens ?? null;
+    const usedPercentage =
+      maxTokens !== null && maxTokens > 0 ? Math.min(100, (usedTokens / maxTokens) * 100) : null;
+    const remainingTokens =
+      maxTokens !== null ? Math.max(0, Math.round(maxTokens - usedTokens)) : null;
+    const remainingPercentage = usedPercentage !== null ? Math.max(0, 100 - usedPercentage) : null;
+    return {
+      usedTokens,
+      totalProcessedTokens: null,
+      maxTokens,
+      remainingTokens,
+      usedPercentage,
+      remainingPercentage,
+      inputTokens: liveUsage.inputTokens ?? null,
+      cachedInputTokens: liveUsage.cachedInputTokens ?? null,
+      outputTokens: liveUsage.outputTokens ?? null,
+      reasoningOutputTokens: liveUsage.reasoningOutputTokens ?? null,
+      lastUsedTokens: null,
+      lastInputTokens: null,
+      lastCachedInputTokens: null,
+      lastOutputTokens: null,
+      lastReasoningOutputTokens: null,
+      toolUses: null,
+      durationMs: null,
+      compactsAutomatically: true,
+      autoCompactThreshold: null,
+      updatedAt: liveUsage.updatedAt,
+    };
+  }
+  for (let index = entries.length - 1; index >= 0; index -= 1) {
+    const entry = entries[index];
+    if (!entry || entry.item.type !== "compaction") {
       continue;
     }
-
-    const payload = asRecord(activity.payload);
-    const usedTokens = asFiniteNumber(payload?.usedTokens);
+    const payload = entry.item;
+    const usedTokens = asFiniteNumber(payload.afterTokenCount);
     if (usedTokens === null || usedTokens < 0) {
       continue;
     }
 
-    const maxTokens = asFiniteNumber(payload?.maxTokens);
+    const maxTokens = null;
     const usedPercentage =
       maxTokens !== null && maxTokens > 0 ? Math.min(100, (usedTokens / maxTokens) * 100) : null;
     const remainingTokens =
@@ -71,25 +102,25 @@ export function deriveLatestContextWindowSnapshot(
 
     return {
       usedTokens,
-      totalProcessedTokens: asFiniteNumber(payload?.totalProcessedTokens),
+      totalProcessedTokens: asFiniteNumber(payload.beforeTokenCount),
       maxTokens,
       remainingTokens,
       usedPercentage,
       remainingPercentage,
-      inputTokens: asFiniteNumber(payload?.inputTokens),
-      cachedInputTokens: asFiniteNumber(payload?.cachedInputTokens),
-      outputTokens: asFiniteNumber(payload?.outputTokens),
-      reasoningOutputTokens: asFiniteNumber(payload?.reasoningOutputTokens),
-      lastUsedTokens: asFiniteNumber(payload?.lastUsedTokens),
-      lastInputTokens: asFiniteNumber(payload?.lastInputTokens),
-      lastCachedInputTokens: asFiniteNumber(payload?.lastCachedInputTokens),
-      lastOutputTokens: asFiniteNumber(payload?.lastOutputTokens),
-      lastReasoningOutputTokens: asFiniteNumber(payload?.lastReasoningOutputTokens),
-      toolUses: asFiniteNumber(payload?.toolUses),
-      durationMs: asFiniteNumber(payload?.durationMs),
-      compactsAutomatically: asBoolean(payload?.compactsAutomatically) ?? false,
-      autoCompactThreshold: asFiniteNumber(payload?.autoCompactThreshold),
-      updatedAt: activity.createdAt,
+      inputTokens: null,
+      cachedInputTokens: null,
+      outputTokens: null,
+      reasoningOutputTokens: null,
+      lastUsedTokens: null,
+      lastInputTokens: null,
+      lastCachedInputTokens: null,
+      lastOutputTokens: null,
+      lastReasoningOutputTokens: null,
+      toolUses: null,
+      durationMs: null,
+      compactsAutomatically: true,
+      autoCompactThreshold: null,
+      updatedAt: DateTime.formatIso(payload.startedAt ?? payload.updatedAt),
     };
   }
 
diff --git a/apps/web/src/lib/orchestrationV2Timeline.test.ts b/apps/web/src/lib/orchestrationV2Timeline.test.ts
new file mode 100644
index 000000000000..c94a3816a8aa
--- /dev/null
+++ b/apps/web/src/lib/orchestrationV2Timeline.test.ts
@@ -0,0 +1,54 @@
+import { describe, expect, it } from "vite-plus/test";
+
+import {
+  removeAndRenumberTimelineItem,
+  upsertTimelineItemAtStablePosition,
+} from "./orchestrationV2Timeline";
+
+describe("removeAndRenumberTimelineItem", () => {
+  it("closes the position gap before a streamed item is reinserted", () => {
+    const remaining = removeAndRenumberTimelineItem(
+      [
+        { position: 0, sourceItemId: "first" },
+        { position: 1, sourceItemId: "streaming" },
+        { position: 2, sourceItemId: "last" },
+      ],
+      "streaming",
+    );
+
+    expect(remaining).toEqual([
+      { position: 0, sourceItemId: "first" },
+      { position: 1, sourceItemId: "last" },
+    ]);
+    expect(new Set(remaining.map((row) => row.position)).size).toBe(remaining.length);
+  });
+});
+
+describe("upsertTimelineItemAtStablePosition", () => {
+  it("replaces a streaming item without moving it behind newer items", () => {
+    const updated = upsertTimelineItemAtStablePosition(
+      [
+        { position: 0, sourceItemId: "reasoning", text: "partial" },
+        { position: 1, sourceItemId: "subagent", text: "running" },
+      ],
+      { position: 2, sourceItemId: "reasoning", text: "completed" },
+    );
+
+    expect(updated).toEqual([
+      { position: 0, sourceItemId: "reasoning", text: "completed" },
+      { position: 1, sourceItemId: "subagent", text: "running" },
+    ]);
+  });
+
+  it("appends a genuinely new item at the next position", () => {
+    const updated = upsertTimelineItemAtStablePosition(
+      [{ position: 0, sourceItemId: "reasoning" }],
+      { position: 99, sourceItemId: "assistant" },
+    );
+
+    expect(updated).toEqual([
+      { position: 0, sourceItemId: "reasoning" },
+      { position: 1, sourceItemId: "assistant" },
+    ]);
+  });
+});
diff --git a/apps/web/src/lib/orchestrationV2Timeline.ts b/apps/web/src/lib/orchestrationV2Timeline.ts
new file mode 100644
index 000000000000..8be8b77b8c9f
--- /dev/null
+++ b/apps/web/src/lib/orchestrationV2Timeline.ts
@@ -0,0 +1,22 @@
+export function removeAndRenumberTimelineItem<
+  Id,
+  Row extends { readonly position: number; readonly sourceItemId: Id },
+>(rows: ReadonlyArray<Row>, sourceItemId: Id): Array<Row> {
+  return rows
+    .filter((row) => row.sourceItemId !== sourceItemId)
+    .map((row, position) => ({ ...row, position }));
+}
+
+export function upsertTimelineItemAtStablePosition<
+  Id,
+  Row extends { readonly position: number; readonly sourceItemId: Id },
+>(rows: ReadonlyArray<Row>, item: Row): Array<Row> {
+  const existingIndex = rows.findIndex((row) => row.sourceItemId === item.sourceItemId);
+  if (existingIndex === -1) {
+    return [...rows, { ...item, position: rows.length }];
+  }
+
+  return rows.map((row, index) =>
+    index === existingIndex ? { ...item, position: row.position } : row,
+  );
+}
diff --git a/apps/web/src/lib/threadSort.test.ts b/apps/web/src/lib/threadSort.test.ts
index ca9a5986c664..9ae3c3386cd3 100644
--- a/apps/web/src/lib/threadSort.test.ts
+++ b/apps/web/src/lib/threadSort.test.ts
@@ -7,13 +7,14 @@ import {
   ThreadId,
 } from "@t3tools/contracts";
 import type { Thread } from "../types";
+import { makeThreadFixture, type ThreadFixtureOverrides } from "../test-fixtures";
 import { getLatestThreadForProject, sortThreads } from "./threadSort";
 
 const LOCAL_ENVIRONMENT_ID = EnvironmentId.make("environment-local");
 const PROJECT_ID = ProjectId.make("project-1");
 
-function makeThread(overrides: Partial<Thread> = {}): Thread {
-  return {
+function makeThread(overrides: ThreadFixtureOverrides = {}): Thread {
+  return makeThreadFixture({
     id: ThreadId.make("thread-1"),
     environmentId: LOCAL_ENVIRONMENT_ID,
     projectId: PROJECT_ID,
@@ -21,7 +22,7 @@ function makeThread(overrides: Partial<Thread> = {}): Thread {
     modelSelection: { instanceId: ProviderInstanceId.make("codex"), model: "gpt-5.4" },
     runtimeMode: DEFAULT_RUNTIME_MODE,
     interactionMode: "default",
-    session: null,
+    runtime: null,
     messages: [],
     proposedPlans: [],
     createdAt: "2026-03-09T10:00:00.000Z",
@@ -30,13 +31,11 @@ function makeThread(overrides: Partial<Thread> = {}): Thread {
     settledAt: null,
     deletedAt: null,
     updatedAt: "2026-03-09T10:00:00.000Z",
-    latestTurn: null,
+    latestRun: null,
     branch: null,
     worktreePath: null,
-    checkpoints: [],
-    activities: [],
     ...overrides,
-  };
+  });
 }
 
 describe("sortThreads", () => {
@@ -51,7 +50,7 @@ describe("sortThreads", () => {
               id: "message-1" as never,
               role: "user",
               text: "older",
-              turnId: null,
+              runId: null,
               createdAt: "2026-03-09T10:01:00.000Z",
               updatedAt: "2026-03-09T10:01:00.000Z",
               streaming: false,
@@ -67,7 +66,7 @@ describe("sortThreads", () => {
               id: "message-2" as never,
               role: "user",
               text: "newer",
-              turnId: null,
+              runId: null,
               createdAt: "2026-03-09T10:06:00.000Z",
               updatedAt: "2026-03-09T10:06:00.000Z",
               streaming: false,
@@ -95,7 +94,7 @@ describe("sortThreads", () => {
               id: "message-1" as never,
               role: "assistant",
               text: "assistant only",
-              turnId: null,
+              runId: null,
               createdAt: "2026-03-09T10:02:00.000Z",
               updatedAt: "2026-03-09T10:02:00.000Z",
               streaming: false,
diff --git a/apps/web/src/orchestrationEventEffects.ts b/apps/web/src/orchestrationEventEffects.ts
deleted file mode 100644
index 34e33ace831c..000000000000
--- a/apps/web/src/orchestrationEventEffects.ts
+++ /dev/null
@@ -1,94 +0,0 @@
-import type { OrchestrationEvent, ThreadId } from "@t3tools/contracts";
-
-export interface OrchestrationBatchEffects {
-  promoteDraftThreadIds: ThreadId[];
-  clearDeletedThreadIds: ThreadId[];
-  removeTerminalUiStateThreadIds: ThreadId[];
-  needsProviderInvalidation: boolean;
-}
-
-export function deriveOrchestrationBatchEffects(
-  events: readonly OrchestrationEvent[],
-): OrchestrationBatchEffects {
-  const threadLifecycleEffects = new Map<
-    ThreadId,
-    {
-      clearPromotedDraft: boolean;
-      clearDeletedThread: boolean;
-      removeTerminalUiState: boolean;
-    }
-  >();
-  let needsProviderInvalidation = false;
-
-  for (const event of events) {
-    switch (event.type) {
-      case "thread.turn-diff-completed":
-      case "thread.reverted": {
-        needsProviderInvalidation = true;
-        break;
-      }
-
-      case "thread.created": {
-        threadLifecycleEffects.set(event.payload.threadId, {
-          clearPromotedDraft: true,
-          clearDeletedThread: false,
-          removeTerminalUiState: false,
-        });
-        break;
-      }
-
-      case "thread.deleted": {
-        threadLifecycleEffects.set(event.payload.threadId, {
-          clearPromotedDraft: false,
-          clearDeletedThread: true,
-          removeTerminalUiState: true,
-        });
-        break;
-      }
-
-      case "thread.archived": {
-        threadLifecycleEffects.set(event.payload.threadId, {
-          clearPromotedDraft: false,
-          clearDeletedThread: false,
-          removeTerminalUiState: true,
-        });
-        break;
-      }
-
-      case "thread.unarchived": {
-        threadLifecycleEffects.set(event.payload.threadId, {
-          clearPromotedDraft: false,
-          clearDeletedThread: false,
-          removeTerminalUiState: false,
-        });
-        break;
-      }
-
-      default: {
-        break;
-      }
-    }
-  }
-
-  const promoteDraftThreadIds: ThreadId[] = [];
-  const clearDeletedThreadIds: ThreadId[] = [];
-  const removeTerminalUiStateThreadIds: ThreadId[] = [];
-  for (const [threadId, effect] of threadLifecycleEffects) {
-    if (effect.clearPromotedDraft) {
-      promoteDraftThreadIds.push(threadId);
-    }
-    if (effect.clearDeletedThread) {
-      clearDeletedThreadIds.push(threadId);
-    }
-    if (effect.removeTerminalUiState) {
-      removeTerminalUiStateThreadIds.push(threadId);
-    }
-  }
-
-  return {
-    promoteDraftThreadIds,
-    clearDeletedThreadIds,
-    removeTerminalUiStateThreadIds,
-    needsProviderInvalidation,
-  };
-}
diff --git a/apps/web/src/providerInstances.test.ts b/apps/web/src/providerInstances.test.ts
index b64a5e25d508..906b8298a194 100644
--- a/apps/web/src/providerInstances.test.ts
+++ b/apps/web/src/providerInstances.test.ts
@@ -8,6 +8,7 @@ import {
   isProviderInstancePickerReady,
   isProviderInstancePickerVisible,
   resolveDefaultProviderModelSelection,
+  resolveProviderCatalogAvailability,
   resolveSelectableProviderInstance,
   resolveProviderDriverKindForInstanceSelection,
 } from "./providerInstances";
@@ -71,6 +72,46 @@ describe("isProviderInstancePickerReady", () => {
   });
 });
 
+describe("resolveProviderCatalogAvailability", () => {
+  const [entry] = deriveProviderInstanceEntries([
+    provider({ provider: ProviderDriverKind.make("codex"), instanceId: "codex" }),
+  ]);
+
+  it("keeps the initial reactive config state distinct from an empty catalogue", () => {
+    expect(
+      resolveProviderCatalogAvailability({
+        catalogLoaded: false,
+        entries: [],
+        selectedEntry: undefined,
+      }),
+    ).toBe("loading");
+    expect(
+      resolveProviderCatalogAvailability({
+        catalogLoaded: true,
+        entries: [],
+        selectedEntry: undefined,
+      }),
+    ).toBe("unconfigured");
+  });
+
+  it("distinguishes a selected provider from configured but unusable providers", () => {
+    expect(
+      resolveProviderCatalogAvailability({
+        catalogLoaded: true,
+        entries: entry ? [entry] : [],
+        selectedEntry: entry,
+      }),
+    ).toBe("ready");
+    expect(
+      resolveProviderCatalogAvailability({
+        catalogLoaded: true,
+        entries: entry ? [entry] : [],
+        selectedEntry: undefined,
+      }),
+    ).toBe("unavailable");
+  });
+});
+
 describe("isProviderInstancePickerVisible", () => {
   it("keeps enabled instances in the rail and removes disabled instances", () => {
     const [enabledEntry, disabledEntry] = deriveProviderInstanceEntries([
diff --git a/apps/web/src/providerInstances.ts b/apps/web/src/providerInstances.ts
index ef60d554dd78..214caf5a048c 100644
--- a/apps/web/src/providerInstances.ts
+++ b/apps/web/src/providerInstances.ts
@@ -65,6 +65,24 @@ export interface ProviderInstanceEntry {
   readonly models: ReadonlyArray<ServerProviderModel>;
 }
 
+export type ProviderCatalogAvailability = "loading" | "ready" | "unavailable" | "unconfigured";
+
+/**
+ * Keep a provider catalogue that has not arrived yet distinct from a loaded
+ * catalogue with no usable entries. Environment config streams are reactive:
+ * treating their initial `null` as a final empty list strands otherwise
+ * recoverable threads behind a misleading "no providers" state.
+ */
+export function resolveProviderCatalogAvailability(input: {
+  readonly catalogLoaded: boolean;
+  readonly entries: ReadonlyArray<ProviderInstanceEntry>;
+  readonly selectedEntry: ProviderInstanceEntry | undefined;
+}): ProviderCatalogAvailability {
+  if (!input.catalogLoaded) return "loading";
+  if (input.selectedEntry !== undefined) return "ready";
+  return input.entries.length === 0 ? "unconfigured" : "unavailable";
+}
+
 /**
  * Whether an instance can currently contribute models to an interactive picker.
  *
diff --git a/apps/web/src/rightPanelLayout.test.ts b/apps/web/src/rightPanelLayout.test.ts
new file mode 100644
index 000000000000..803fb8657dcc
--- /dev/null
+++ b/apps/web/src/rightPanelLayout.test.ts
@@ -0,0 +1,19 @@
+import { describe, expect, it } from "vite-plus/test";
+
+import { resolveThreadPanelPresentation } from "./rightPanelLayout";
+
+describe("resolveThreadPanelPresentation", () => {
+  it("uses the stable workspace width minus the real right panel width", () => {
+    expect(resolveThreadPanelPresentation(null, 0, false)).toBe("inline");
+    expect(resolveThreadPanelPresentation(1_104, 0, false)).toBe("inline");
+    expect(resolveThreadPanelPresentation(1_103, 0, false)).toBe("popover");
+
+    expect(resolveThreadPanelPresentation(1_400, 0, false)).toBe("inline");
+    expect(resolveThreadPanelPresentation(1_400, 540, false)).toBe("popover");
+    expect(resolveThreadPanelPresentation(1_644, 540, false)).toBe("inline");
+  });
+
+  it("uses a popover while the real right panel is maximized", () => {
+    expect(resolveThreadPanelPresentation(2_000, 0, true)).toBe("popover");
+  });
+});
diff --git a/apps/web/src/rightPanelLayout.ts b/apps/web/src/rightPanelLayout.ts
index 5528072e57b3..2183ee7ee8e8 100644
--- a/apps/web/src/rightPanelLayout.ts
+++ b/apps/web/src/rightPanelLayout.ts
@@ -1,3 +1,17 @@
 export const RIGHT_PANEL_INLINE_LAYOUT_MEDIA_QUERY = "(max-width: 980px)";
+export const THREAD_PANEL_INLINE_MIN_WIDTH = 1_104;
 export const RIGHT_PANEL_SHEET_CLASS_NAME =
   "w-[min(42vw,28rem)] min-w-80 max-w-[28rem] p-0 max-[760px]:w-[min(88vw,24rem)] max-[760px]:min-w-0 wco:mt-[env(titlebar-area-height)] wco:h-[calc(100%-env(titlebar-area-height))] wco:max-h-[calc(100%-env(titlebar-area-height))]";
+
+export type ThreadPanelPresentation = "inline" | "popover";
+
+export function resolveThreadPanelPresentation(
+  workspaceWidth: number | null,
+  occupiedRightPanelWidth: number,
+  rightPanelMaximized: boolean,
+): ThreadPanelPresentation {
+  if (workspaceWidth === null) return "inline";
+
+  const chatPaneWidth = rightPanelMaximized ? 0 : workspaceWidth - occupiedRightPanelWidth;
+  return chatPaneWidth < THREAD_PANEL_INLINE_MIN_WIDTH ? "popover" : "inline";
+}
diff --git a/apps/web/src/rightPanelStore.test.ts b/apps/web/src/rightPanelStore.test.ts
index b6997554efbc..ae9aa59daf01 100644
--- a/apps/web/src/rightPanelStore.test.ts
+++ b/apps/web/src/rightPanelStore.test.ts
@@ -8,8 +8,9 @@ import {
   selectActiveRightPanel,
   selectActiveRightPanelSurface,
   selectSelectedRightPanelSurface,
+  selectThreadPanelOpen,
+  selectThreadPanelVisibility,
   selectThreadRightPanelState,
-  updatePullRequestTabStatus,
   useRightPanelStore,
 } from "./rightPanelStore";
 
@@ -17,7 +18,7 @@ const refA = scopeThreadRef("env-1" as EnvironmentId, ThreadId.make("thread-A"))
 const refB = scopeThreadRef("env-1" as EnvironmentId, ThreadId.make("thread-B"));
 
 beforeEach(() => {
-  useRightPanelStore.setState({ byThreadKey: {} });
+  useRightPanelStore.setState({ byThreadKey: {}, threadPanelVisibilityByThreadKey: {} });
 });
 
 describe("rightPanelStore", () => {
@@ -42,6 +43,7 @@ describe("rightPanelStore", () => {
           surfaces: [{ id: "browser:tab-a", kind: "preview", resourceId: "tab-a" }],
         },
       },
+      threadPanelVisibilityByThreadKey: {},
     });
   });
 
@@ -72,6 +74,7 @@ describe("rightPanelStore", () => {
           ],
         },
       },
+      threadPanelVisibilityByThreadKey: {},
     });
   });
 
@@ -102,6 +105,7 @@ describe("rightPanelStore", () => {
           ],
         },
       },
+      threadPanelVisibilityByThreadKey: {},
     });
   });
 
@@ -145,6 +149,7 @@ describe("rightPanelStore", () => {
           ],
         },
       },
+      threadPanelVisibilityByThreadKey: {},
     });
   });
 
@@ -174,7 +179,10 @@ describe("rightPanelStore", () => {
           "env-1:thread-A": panelState,
         },
       }),
-    ).toEqual({ byThreadKey: { "env-1:thread-A": panelState } });
+    ).toEqual({
+      byThreadKey: { "env-1:thread-A": panelState },
+      threadPanelVisibilityByThreadKey: {},
+    });
   });
 
   it("drops persisted plan surfaces and does not reopen an empty panel", () => {
@@ -209,9 +217,80 @@ describe("rightPanelStore", () => {
           surfaces: [{ id: "diff", kind: "diff" }],
         },
       },
+      threadPanelVisibilityByThreadKey: {},
+    });
+  });
+
+  it("persists inline preference without restoring an open popover", () => {
+    expect(
+      migratePersistedRightPanelState({
+        threadPanelVisibilityByThreadKey: {
+          "env-1:thread-A": { inlineOpen: false, popoverOpen: true },
+          "env-1:thread-B": { inlineOpen: true, popoverOpen: true },
+        },
+      }),
+    ).toEqual({
+      byThreadKey: {},
+      threadPanelVisibilityByThreadKey: {
+        "env-1:thread-A": { inlineOpen: false, popoverOpen: false },
+      },
     });
   });
 
+  it("tracks inline and popover visibility independently", () => {
+    const store = useRightPanelStore.getState();
+
+    expect(selectThreadPanelOpen(store.threadPanelVisibilityByThreadKey, refA, "inline")).toBe(
+      true,
+    );
+    expect(selectThreadPanelOpen(store.threadPanelVisibilityByThreadKey, refA, "popover")).toBe(
+      false,
+    );
+
+    store.setThreadPanelOpen(refA, "inline", false);
+    store.toggleThreadPanel(refA, "popover");
+
+    expect(
+      selectThreadPanelVisibility(
+        useRightPanelStore.getState().threadPanelVisibilityByThreadKey,
+        refA,
+      ),
+    ).toEqual({ inlineOpen: false, popoverOpen: true });
+    expect(
+      selectThreadPanelVisibility(
+        useRightPanelStore.getState().threadPanelVisibilityByThreadKey,
+        refB,
+      ),
+    ).toEqual({ inlineOpen: true, popoverOpen: false });
+  });
+
+  it("closes the popover atomically when the real right panel opens", () => {
+    useRightPanelStore.getState().setThreadPanelOpen(refA, "popover", true);
+    useRightPanelStore.getState().open(refA, "diff");
+
+    expect(
+      selectThreadPanelVisibility(
+        useRightPanelStore.getState().threadPanelVisibilityByThreadKey,
+        refA,
+      ),
+    ).toEqual({ inlineOpen: true, popoverOpen: false });
+  });
+
+  it("keeps an open popover visible by promoting it to inline when the real panel closes", () => {
+    const store = useRightPanelStore.getState();
+    store.open(refA, "diff");
+    store.setThreadPanelOpen(refA, "inline", false);
+    store.setThreadPanelOpen(refA, "popover", true);
+    store.close(refA);
+
+    expect(
+      selectThreadPanelVisibility(
+        useRightPanelStore.getState().threadPanelVisibilityByThreadKey,
+        refA,
+      ),
+    ).toEqual({ inlineOpen: true, popoverOpen: true });
+  });
+
   it("open sets the active panel for a thread", () => {
     useRightPanelStore.getState().open(refA, "preview");
     expect(selectActiveRightPanel(useRightPanelStore.getState().byThreadKey, refA)).toBe("preview");
@@ -420,127 +499,6 @@ describe("rightPanelStore", () => {
     expect(state.activeSurfaceId).toBe(pullRequestSurfaceId(first));
   });
 
-  it("keeps one pull request read from two servers as two tabs", () => {
-    const local = {
-      environmentId: "local",
-      projectId: "project-a",
-      repository: "pingdotgg/t3code",
-      number: 4909,
-    };
-    const remote = { ...local, environmentId: "remote" };
-
-    useRightPanelStore.getState().openPullRequest(refA, local);
-    useRightPanelStore.getState().openPullRequest(refA, remote);
-
-    const state = selectThreadRightPanelState(useRightPanelStore.getState().byThreadKey, refA);
-    expect(state.surfaces.map((surface) => surface.id)).toEqual([
-      pullRequestSurfaceId(local),
-      pullRequestSurfaceId(remote),
-    ]);
-  });
-
-  it("keeps the page's panel tabs reachable when the set of connected servers changes", () => {
-    // The pull-requests page keys its one shared panel by a fixed sentinel environment, not by
-    // whichever capable server happens to sort first (see PULL_REQUESTS_PANEL_ENVIRONMENT_ID in
-    // _chat.pull-requests.tsx) — a server disconnecting must not move every open tab to a store
-    // key nobody wrote them under.
-    const panelId = ThreadId.make("pull-requests-panel");
-    const stableRef = scopeThreadRef("pull-requests-panel" as EnvironmentId, panelId);
-    const fromServerA = {
-      environmentId: "server-a",
-      projectId: "project-a",
-      repository: "pingdotgg/t3code",
-      number: 1,
-    };
-    const fromServerB = {
-      environmentId: "server-b",
-      projectId: "project-b",
-      repository: "pingdotgg/t3code",
-      number: 2,
-    };
-
-    // Both servers connected: tabs from each open under the one stable ref.
-    useRightPanelStore.getState().openPullRequest(stableRef, fromServerA);
-    useRightPanelStore.getState().openPullRequest(stableRef, fromServerB);
-
-    // Server A disconnects. The stable ref does not depend on which servers remain connected, so
-    // the same lookup still finds both tabs.
-    const state = selectThreadRightPanelState(useRightPanelStore.getState().byThreadKey, stableRef);
-    expect(state.surfaces.map((surface) => surface.id)).toEqual([
-      pullRequestSurfaceId(fromServerA),
-      pullRequestSurfaceId(fromServerB),
-    ]);
-
-    // The bug this guards against: a ref keyed by the first capable environment instead of a
-    // fixed sentinel changes identity when that environment drops out, and a lookup under the new
-    // key finds nothing even though the tabs are still sitting under the old one.
-    const refWhileBothConnected = scopeThreadRef("server-a" as EnvironmentId, panelId);
-    const refAfterServerADisconnects = scopeThreadRef("server-b" as EnvironmentId, panelId);
-    expect(refWhileBothConnected).not.toEqual(refAfterServerADisconnects);
-    expect(
-      selectThreadRightPanelState(
-        useRightPanelStore.getState().byThreadKey,
-        refAfterServerADisconnects,
-      ).surfaces,
-    ).toEqual([]);
-  });
-
-  describe("updatePullRequestTabStatus", () => {
-    const status = (isDraft: boolean) => ({
-      projectId: "project-a",
-      repository: "pingdotgg/t3code",
-      number: 4909,
-      state: "open" as const,
-      isDraft,
-    });
-
-    // Regression for the tab wearing no state: this failed when the status was written under a
-    // key rebuilt from the pull request while the tab strip reads it under the surface's own id.
-    it("keys a status under the same id a surface opened from an environment carries", () => {
-      const target = {
-        environmentId: "remote",
-        projectId: "project-a",
-        repository: "pingdotgg/t3code",
-        number: 4909,
-      };
-      useRightPanelStore.getState().openPullRequest(refA, target);
-      const surface = selectSelectedRightPanelSurface(
-        useRightPanelStore.getState().byThreadKey,
-        refA,
-      );
-      expect(surface).not.toBeNull();
-
-      const statuses = updatePullRequestTabStatus({}, surface!.id, status(false));
-      expect(statuses[surface!.id]).toEqual(status(false));
-    });
-
-    it("keys a status under the same id a thread surface with no environment carries", () => {
-      const target = { projectId: "project-a", repository: "pingdotgg/t3code", number: 4909 };
-      useRightPanelStore.getState().openPullRequest(refA, target);
-      const surface = selectSelectedRightPanelSurface(
-        useRightPanelStore.getState().byThreadKey,
-        refA,
-      );
-      expect(surface).not.toBeNull();
-
-      const statuses = updatePullRequestTabStatus({}, surface!.id, status(false));
-      expect(statuses[surface!.id]).toEqual(status(false));
-    });
-
-    it("returns the identical map when the tab's state and draft flag are unchanged", () => {
-      const first = updatePullRequestTabStatus({}, "pull-request:1", status(false));
-      const second = updatePullRequestTabStatus(first, "pull-request:1", status(false));
-      expect(second).toBe(first);
-    });
-
-    it("replaces the entry when the draft flag changes", () => {
-      const first = updatePullRequestTabStatus({}, "pull-request:1", status(false));
-      const second = updatePullRequestTabStatus(first, "pull-request:1", status(true));
-      expect(second).not.toBe(first);
-      expect(second["pull-request:1"]).toEqual(status(true));
-    });
-  });
-
   it("tracks one surface per terminal session", () => {
     useRightPanelStore.getState().openTerminal(refA, "term-1");
     useRightPanelStore.getState().openTerminal(refA, "term-2");
diff --git a/apps/web/src/rightPanelStore.ts b/apps/web/src/rightPanelStore.ts
index 27d5ded5d272..686432393ee7 100644
--- a/apps/web/src/rightPanelStore.ts
+++ b/apps/web/src/rightPanelStore.ts
@@ -13,6 +13,7 @@ import { create } from "zustand";
 import { createJSONStorage, persist } from "zustand/middleware";
 
 import { resolveStorage } from "./lib/storage";
+import type { ThreadPanelPresentation } from "./rightPanelLayout";
 
 export const RIGHT_PANEL_KINDS = [
   "diff",
@@ -82,8 +83,14 @@ export interface ThreadRightPanelState {
   surfaces: RightPanelSurface[];
 }
 
+export interface ThreadPanelVisibility {
+  inlineOpen: boolean;
+  popoverOpen: boolean;
+}
+
 interface RightPanelStoreState {
   byThreadKey: Record<string, ThreadRightPanelState>;
+  threadPanelVisibilityByThreadKey: Record<string, ThreadPanelVisibility>;
   open: (
     ref: ScopedThreadRef,
     kind: Exclude<RightPanelKind, "file" | "terminal" | "pull-request">,
@@ -117,6 +124,12 @@ interface RightPanelStoreState {
     ref: ScopedThreadRef,
     kind: Exclude<RightPanelKind, "file" | "terminal" | "pull-request">,
   ) => void;
+  setThreadPanelOpen: (
+    ref: ScopedThreadRef,
+    presentation: ThreadPanelPresentation,
+    open: boolean,
+  ) => void;
+  toggleThreadPanel: (ref: ScopedThreadRef, presentation: ThreadPanelPresentation) => void;
   removeThread: (ref: ScopedThreadRef) => void;
 }
 
@@ -126,6 +139,11 @@ const EMPTY_THREAD_STATE: ThreadRightPanelState = {
   surfaces: [],
 };
 
+const DEFAULT_THREAD_PANEL_VISIBILITY: ThreadPanelVisibility = {
+  inlineOpen: true,
+  popoverOpen: false,
+};
+
 const singletonSurface = (
   kind: Exclude<RightPanelKind, "file" | "preview" | "terminal" | "pull-request">,
 ): RightPanelSurface => {
@@ -224,7 +242,7 @@ const upsertSurface = (
   activeSurfaceId: activate ? surface.id : current.activeSurfaceId,
 });
 
-const updateThread = (
+const updateThreadStateMap = (
   byThreadKey: Record<string, ThreadRightPanelState>,
   threadKey: string,
   updater: (current: ThreadRightPanelState) => ThreadRightPanelState,
@@ -240,6 +258,63 @@ const updateThread = (
   return { ...byThreadKey, [threadKey]: next };
 };
 
+const updateThreadPanelVisibilityMap = (
+  byThreadKey: Record<string, ThreadPanelVisibility>,
+  threadKey: string,
+  updater: (current: ThreadPanelVisibility) => ThreadPanelVisibility,
+): Record<string, ThreadPanelVisibility> => {
+  const current = byThreadKey[threadKey] ?? DEFAULT_THREAD_PANEL_VISIBILITY;
+  const next = updater(current);
+  if (next.inlineOpen && !next.popoverOpen) {
+    if (!(threadKey in byThreadKey)) return byThreadKey;
+    const { [threadKey]: _removed, ...rest } = byThreadKey;
+    return rest;
+  }
+  if (next === current) return byThreadKey;
+  return { ...byThreadKey, [threadKey]: next };
+};
+
+type RightPanelStoreData = Pick<
+  RightPanelStoreState,
+  "byThreadKey" | "threadPanelVisibilityByThreadKey"
+>;
+
+/**
+ * Applies a real right-panel mutation and its thread-panel transition atomically.
+ * This is the only path real panel actions use, so visibility never has to be
+ * reconciled after the fact in React.
+ */
+const updateThread = (
+  state: RightPanelStoreData,
+  ref: ScopedThreadRef,
+  updater: (current: ThreadRightPanelState) => ThreadRightPanelState,
+): RightPanelStoreData => {
+  const threadKey = scopedThreadKey(ref);
+  const current = state.byThreadKey[threadKey] ?? EMPTY_THREAD_STATE;
+  const byThreadKey = updateThreadStateMap(state.byThreadKey, threadKey, updater);
+  const next = byThreadKey[threadKey] ?? EMPTY_THREAD_STATE;
+  let threadPanelVisibilityByThreadKey = state.threadPanelVisibilityByThreadKey;
+
+  if (!current.isOpen && next.isOpen) {
+    threadPanelVisibilityByThreadKey = updateThreadPanelVisibilityMap(
+      threadPanelVisibilityByThreadKey,
+      threadKey,
+      (visibility) => (visibility.popoverOpen ? { ...visibility, popoverOpen: false } : visibility),
+    );
+  } else if (current.isOpen && !next.isOpen) {
+    threadPanelVisibilityByThreadKey = updateThreadPanelVisibilityMap(
+      threadPanelVisibilityByThreadKey,
+      threadKey,
+      (visibility) =>
+        visibility.popoverOpen && !visibility.inlineOpen
+          ? { ...visibility, inlineOpen: true }
+          : visibility,
+    );
+  }
+
+  return { byThreadKey, threadPanelVisibilityByThreadKey };
+};
+
 function normalizeRevealLine(line: number | undefined): number | null {
   if (line === undefined || !Number.isFinite(line)) return null;
   return Math.max(1, Math.trunc(line));
@@ -247,9 +322,10 @@ function normalizeRevealLine(line: number | undefined): number | null {
 
 export function migratePersistedRightPanelState(persistedState: unknown): {
   byThreadKey: Record<string, ThreadRightPanelState>;
+  threadPanelVisibilityByThreadKey: Record<string, ThreadPanelVisibility>;
 } {
   if (!persistedState || typeof persistedState !== "object") {
-    return { byThreadKey: {} };
+    return { byThreadKey: {}, threadPanelVisibilityByThreadKey: {} };
   }
   const byThreadKey =
     "byThreadKey" in persistedState &&
@@ -357,42 +433,56 @@ export function migratePersistedRightPanelState(persistedState: unknown): {
             }),
         )
       : {};
-  return { byThreadKey };
+  const threadPanelVisibilityByThreadKey =
+    "threadPanelVisibilityByThreadKey" in persistedState &&
+    persistedState.threadPanelVisibilityByThreadKey &&
+    typeof persistedState.threadPanelVisibilityByThreadKey === "object"
+      ? Object.fromEntries(
+          Object.entries(
+            persistedState.threadPanelVisibilityByThreadKey as Record<string, unknown>,
+          ).flatMap(([threadKey, value]) => {
+            if (!value || typeof value !== "object" || !("inlineOpen" in value)) return [];
+            return value.inlineOpen === false
+              ? [[threadKey, { inlineOpen: false, popoverOpen: false }]]
+              : [];
+          }),
+        )
+      : {};
+  return { byThreadKey, threadPanelVisibilityByThreadKey };
 }
 
 export const useRightPanelStore = create<RightPanelStoreState>()(
   persist(
     (set) => ({
       byThreadKey: {},
+      threadPanelVisibilityByThreadKey: {},
       open: (ref, kind) =>
-        set((state) => ({
-          byThreadKey: updateThread(state.byThreadKey, scopedThreadKey(ref), (current) => {
+        set((state) =>
+          updateThread(state, ref, (current) => {
             if (kind === "preview") {
               const existing = current.surfaces.find((surface) => surface.kind === "preview");
               return upsertSurface(current, existing ?? browserSurface(null));
             }
             return upsertSurface(current, singletonSurface(kind));
           }),
-        })),
+        ),
       openBrowser: (ref, tabId) =>
-        set((state) => ({
-          byThreadKey: updateThread(state.byThreadKey, scopedThreadKey(ref), (current) => {
+        set((state) =>
+          updateThread(state, ref, (current) => {
             const surface = browserSurface(tabId);
             const withoutPlaceholder = tabId
               ? current.surfaces.filter((entry) => entry.id !== "browser:new")
               : current.surfaces;
             return upsertSurface({ ...current, surfaces: withoutPlaceholder }, surface);
           }),
-        })),
+        ),
       openPullRequest: (ref, target) =>
-        set((state) => ({
-          byThreadKey: updateThread(state.byThreadKey, scopedThreadKey(ref), (current) => {
-            return upsertSurface(current, pullRequestSurface(target));
-          }),
-        })),
+        set((state) =>
+          updateThread(state, ref, (current) => upsertSurface(current, pullRequestSurface(target))),
+        ),
       openFile: (ref, relativePath, line) =>
-        set((state) => ({
-          byThreadKey: updateThread(state.byThreadKey, scopedThreadKey(ref), (current) => {
+        set((state) =>
+          updateThread(state, ref, (current) => {
             const withoutStandaloneExplorer = current.surfaces.filter(
               (surface) => surface.kind !== "files",
             );
@@ -416,16 +506,16 @@ export const useRightPanelStore = create<RightPanelStoreState>()(
                 : [...withoutStandaloneExplorer, surface],
             };
           }),
-        })),
+        ),
       openTerminal: (ref, terminalId) =>
-        set((state) => ({
-          byThreadKey: updateThread(state.byThreadKey, scopedThreadKey(ref), (current) =>
+        set((state) =>
+          updateThread(state, ref, (current) =>
             upsertSurface(current, terminalSurface(terminalId)),
           ),
-        })),
+        ),
       splitTerminal: (ref, surfaceId, terminalId, direction = "horizontal") =>
-        set((state) => ({
-          byThreadKey: updateThread(state.byThreadKey, scopedThreadKey(ref), (current) => ({
+        set((state) =>
+          updateThread(state, ref, (current) => ({
             ...current,
             isOpen: true,
             activeSurfaceId: surfaceId,
@@ -442,10 +532,10 @@ export const useRightPanelStore = create<RightPanelStoreState>()(
               };
             }),
           })),
-        })),
+        ),
       activateTerminal: (ref, surfaceId, terminalId) =>
-        set((state) => ({
-          byThreadKey: updateThread(state.byThreadKey, scopedThreadKey(ref), (current) => ({
+        set((state) =>
+          updateThread(state, ref, (current) => ({
             ...current,
             activeSurfaceId: surfaceId,
             surfaces: current.surfaces.map((surface) =>
@@ -456,10 +546,10 @@ export const useRightPanelStore = create<RightPanelStoreState>()(
                 : surface,
             ),
           })),
-        })),
+        ),
       closeTerminal: (ref, surfaceId, terminalId) =>
-        set((state) => ({
-          byThreadKey: updateThread(state.byThreadKey, scopedThreadKey(ref), (current) => {
+        set((state) =>
+          updateThread(state, ref, (current) => {
             const surface = current.surfaces.find(
               (entry) => entry.id === surfaceId && entry.kind === "terminal",
             );
@@ -495,18 +585,18 @@ export const useRightPanelStore = create<RightPanelStoreState>()(
               ),
             };
           }),
-        })),
+        ),
       activateSurface: (ref, surfaceId) =>
-        set((state) => ({
-          byThreadKey: updateThread(state.byThreadKey, scopedThreadKey(ref), (current) =>
+        set((state) =>
+          updateThread(state, ref, (current) =>
             current.surfaces.some((surface) => surface.id === surfaceId)
               ? { ...current, isOpen: true, activeSurfaceId: surfaceId }
               : current,
           ),
-        })),
+        ),
       closeSurface: (ref, surfaceId) =>
-        set((state) => ({
-          byThreadKey: updateThread(state.byThreadKey, scopedThreadKey(ref), (current) => {
+        set((state) =>
+          updateThread(state, ref, (current) => {
             const index = current.surfaces.findIndex((surface) => surface.id === surfaceId);
             if (index < 0) return current;
             const surfaces = current.surfaces.filter((surface) => surface.id !== surfaceId);
@@ -521,10 +611,10 @@ export const useRightPanelStore = create<RightPanelStoreState>()(
               activeSurfaceId: fallback?.id ?? null,
             };
           }),
-        })),
+        ),
       closeOtherSurfaces: (ref, surfaceId) =>
-        set((state) => ({
-          byThreadKey: updateThread(state.byThreadKey, scopedThreadKey(ref), (current) => {
+        set((state) =>
+          updateThread(state, ref, (current) => {
             const surface = current.surfaces.find((entry) => entry.id === surfaceId);
             if (!surface || current.surfaces.length === 1) return current;
             return {
@@ -534,10 +624,10 @@ export const useRightPanelStore = create<RightPanelStoreState>()(
               activeSurfaceId: surface.id,
             };
           }),
-        })),
+        ),
       closeSurfacesToRight: (ref, surfaceId) =>
-        set((state) => ({
-          byThreadKey: updateThread(state.byThreadKey, scopedThreadKey(ref), (current) => {
+        set((state) =>
+          updateThread(state, ref, (current) => {
             const index = current.surfaces.findIndex((surface) => surface.id === surfaceId);
             if (index < 0 || index === current.surfaces.length - 1) return current;
             const surfaces = current.surfaces.slice(0, index + 1);
@@ -550,18 +640,18 @@ export const useRightPanelStore = create<RightPanelStoreState>()(
               activeSurfaceId: activeStillExists ? current.activeSurfaceId : surfaceId,
             };
           }),
-        })),
+        ),
       closeAllSurfaces: (ref) =>
-        set((state) => ({
-          byThreadKey: updateThread(state.byThreadKey, scopedThreadKey(ref), (current) =>
+        set((state) =>
+          updateThread(state, ref, (current) =>
             current.surfaces.length === 0
               ? current
               : { ...current, isOpen: false, surfaces: [], activeSurfaceId: null },
           ),
-        })),
+        ),
       reconcileBrowserSurfaces: (ref, tabIds) =>
-        set((state) => ({
-          byThreadKey: updateThread(state.byThreadKey, scopedThreadKey(ref), (current) => {
+        set((state) =>
+          updateThread(state, ref, (current) => {
             const validIds = new Set(tabIds.map((tabId) => `browser:${tabId}`));
             const nonBrowser = current.surfaces.filter((surface) => surface.kind !== "preview");
             const existingBrowser = current.surfaces.filter(
@@ -587,10 +677,10 @@ export const useRightPanelStore = create<RightPanelStoreState>()(
                 : (fallbackBrowser?.id ?? surfaces[0]?.id ?? null),
             };
           }),
-        })),
+        ),
       reconcileFileSurfaces: (ref, workspaceAvailable) =>
-        set((state) => ({
-          byThreadKey: updateThread(state.byThreadKey, scopedThreadKey(ref), (current) => {
+        set((state) =>
+          updateThread(state, ref, (current) => {
             if (workspaceAvailable) return current;
             const surfaces = current.surfaces.filter(
               (surface) => surface.kind !== "files" && surface.kind !== "file",
@@ -608,29 +698,29 @@ export const useRightPanelStore = create<RightPanelStoreState>()(
                 : (surfaces.at(-1)?.id ?? null),
             };
           }),
-        })),
+        ),
       show: (ref) =>
-        set((state) => ({
-          byThreadKey: updateThread(state.byThreadKey, scopedThreadKey(ref), (current) =>
+        set((state) =>
+          updateThread(state, ref, (current) =>
             current.isOpen ? current : { ...current, isOpen: true },
           ),
-        })),
+        ),
       close: (ref) =>
-        set((state) => ({
-          byThreadKey: updateThread(state.byThreadKey, scopedThreadKey(ref), (current) =>
+        set((state) =>
+          updateThread(state, ref, (current) =>
             current.isOpen ? { ...current, isOpen: false } : current,
           ),
-        })),
+        ),
       toggleVisibility: (ref) =>
-        set((state) => ({
-          byThreadKey: updateThread(state.byThreadKey, scopedThreadKey(ref), (current) => ({
+        set((state) =>
+          updateThread(state, ref, (current) => ({
             ...current,
             isOpen: !current.isOpen,
           })),
-        })),
+        ),
       toggle: (ref, kind) =>
-        set((state) => ({
-          byThreadKey: updateThread(state.byThreadKey, scopedThreadKey(ref), (current) => {
+        set((state) =>
+          updateThread(state, ref, (current) => {
             const active = current.surfaces.find(
               (surface) => surface.id === current.activeSurfaceId,
             );
@@ -643,13 +733,42 @@ export const useRightPanelStore = create<RightPanelStoreState>()(
             }
             return upsertSurface(current, singletonSurface(kind));
           }),
+        ),
+      setThreadPanelOpen: (ref, presentation, open) =>
+        set((state) => ({
+          threadPanelVisibilityByThreadKey: updateThreadPanelVisibilityMap(
+            state.threadPanelVisibilityByThreadKey,
+            scopedThreadKey(ref),
+            (visibility) => {
+              const key = presentation === "inline" ? "inlineOpen" : "popoverOpen";
+              return visibility[key] === open ? visibility : { ...visibility, [key]: open };
+            },
+          ),
+        })),
+      toggleThreadPanel: (ref, presentation) =>
+        set((state) => ({
+          threadPanelVisibilityByThreadKey: updateThreadPanelVisibilityMap(
+            state.threadPanelVisibilityByThreadKey,
+            scopedThreadKey(ref),
+            (visibility) =>
+              presentation === "inline"
+                ? { ...visibility, inlineOpen: !visibility.inlineOpen }
+                : { ...visibility, popoverOpen: !visibility.popoverOpen },
+          ),
         })),
       removeThread: (ref) =>
         set((state) => {
           const threadKey = scopedThreadKey(ref);
-          if (!(threadKey in state.byThreadKey)) return state;
-          const { [threadKey]: _removed, ...rest } = state.byThreadKey;
-          return { byThreadKey: rest };
+          if (
+            !(threadKey in state.byThreadKey) &&
+            !(threadKey in state.threadPanelVisibilityByThreadKey)
+          ) {
+            return state;
+          }
+          const { [threadKey]: _removedPanel, ...byThreadKey } = state.byThreadKey;
+          const { [threadKey]: _removedVisibility, ...threadPanelVisibilityByThreadKey } =
+            state.threadPanelVisibilityByThreadKey;
+          return { byThreadKey, threadPanelVisibilityByThreadKey };
         }),
     }),
     {
@@ -664,6 +783,12 @@ export const useRightPanelStore = create<RightPanelStoreState>()(
             ([threadKey]) => !isPullRequestsPanelKey(threadKey),
           ),
         ),
+        threadPanelVisibilityByThreadKey: Object.fromEntries(
+          Object.entries(state.threadPanelVisibilityByThreadKey).flatMap(
+            ([threadKey, visibility]) =>
+              visibility.inlineOpen ? [] : [[threadKey, { inlineOpen: false, popoverOpen: false }]],
+          ),
+        ),
       }),
       migrate: migratePersistedRightPanelState,
     },
@@ -678,6 +803,23 @@ export function selectThreadRightPanelState(
   return byThreadKey[scopedThreadKey(ref)] ?? EMPTY_THREAD_STATE;
 }
 
+export function selectThreadPanelVisibility(
+  byThreadKey: Record<string, ThreadPanelVisibility>,
+  ref: ScopedThreadRef | null | undefined,
+): ThreadPanelVisibility {
+  if (!ref) return DEFAULT_THREAD_PANEL_VISIBILITY;
+  return byThreadKey[scopedThreadKey(ref)] ?? DEFAULT_THREAD_PANEL_VISIBILITY;
+}
+
+export function selectThreadPanelOpen(
+  byThreadKey: Record<string, ThreadPanelVisibility>,
+  ref: ScopedThreadRef | null | undefined,
+  presentation: ThreadPanelPresentation,
+): boolean {
+  const visibility = selectThreadPanelVisibility(byThreadKey, ref);
+  return presentation === "inline" ? visibility.inlineOpen : visibility.popoverOpen;
+}
+
 export function selectActiveRightPanel(
   byThreadKey: Record<string, ThreadRightPanelState>,
   ref: ScopedThreadRef | null | undefined,
diff --git a/apps/web/src/routeTree.gen.ts b/apps/web/src/routeTree.gen.ts
index f7c47ace6840..65158c062c9f 100644
--- a/apps/web/src/routeTree.gen.ts
+++ b/apps/web/src/routeTree.gen.ts
@@ -16,6 +16,7 @@ import { Route as ConnectRouteImport } from './routes/connect'
 import { Route as ChatRouteImport } from './routes/_chat'
 import { Route as ChatIndexRouteImport } from './routes/_chat.index'
 import { Route as SettingsSourceControlRouteImport } from './routes/settings.source-control'
+import { Route as SettingsScheduledTasksRouteImport } from './routes/settings.scheduled-tasks'
 import { Route as SettingsProvidersRouteImport } from './routes/settings.providers'
 import { Route as SettingsKeybindingsRouteImport } from './routes/settings.keybindings'
 import { Route as SettingsIntegrationsRouteImport } from './routes/settings.integrations'
@@ -64,6 +65,11 @@ const SettingsSourceControlRoute = SettingsSourceControlRouteImport.update({
   path: '/source-control',
   getParentRoute: () => SettingsRoute,
 } as any)
+const SettingsScheduledTasksRoute = SettingsScheduledTasksRouteImport.update({
+  id: '/scheduled-tasks',
+  path: '/scheduled-tasks',
+  getParentRoute: () => SettingsRoute,
+} as any)
 const SettingsProvidersRoute = SettingsProvidersRouteImport.update({
   id: '/providers',
   path: '/providers',
@@ -148,6 +154,7 @@ export interface FileRoutesByFullPath {
   '/settings/integrations': typeof SettingsIntegrationsRoute
   '/settings/keybindings': typeof SettingsKeybindingsRoute
   '/settings/providers': typeof SettingsProvidersRoute
+  '/settings/scheduled-tasks': typeof SettingsScheduledTasksRoute
   '/settings/source-control': typeof SettingsSourceControlRoute
   '/$environmentId/$threadId': typeof ChatEnvironmentIdThreadIdRoute
   '/draft/$draftId': typeof ChatDraftDraftIdRoute
@@ -168,6 +175,7 @@ export interface FileRoutesByTo {
   '/settings/integrations': typeof SettingsIntegrationsRoute
   '/settings/keybindings': typeof SettingsKeybindingsRoute
   '/settings/providers': typeof SettingsProvidersRoute
+  '/settings/scheduled-tasks': typeof SettingsScheduledTasksRoute
   '/settings/source-control': typeof SettingsSourceControlRoute
   '/': typeof ChatIndexRoute
   '/$environmentId/$threadId': typeof ChatEnvironmentIdThreadIdRoute
@@ -191,6 +199,7 @@ export interface FileRoutesById {
   '/settings/integrations': typeof SettingsIntegrationsRoute
   '/settings/keybindings': typeof SettingsKeybindingsRoute
   '/settings/providers': typeof SettingsProvidersRoute
+  '/settings/scheduled-tasks': typeof SettingsScheduledTasksRoute
   '/settings/source-control': typeof SettingsSourceControlRoute
   '/_chat/': typeof ChatIndexRoute
   '/_chat/$environmentId/$threadId': typeof ChatEnvironmentIdThreadIdRoute
@@ -215,6 +224,7 @@ export interface FileRouteTypes {
     | '/settings/integrations'
     | '/settings/keybindings'
     | '/settings/providers'
+    | '/settings/scheduled-tasks'
     | '/settings/source-control'
     | '/$environmentId/$threadId'
     | '/draft/$draftId'
@@ -235,6 +245,7 @@ export interface FileRouteTypes {
     | '/settings/integrations'
     | '/settings/keybindings'
     | '/settings/providers'
+    | '/settings/scheduled-tasks'
     | '/settings/source-control'
     | '/'
     | '/$environmentId/$threadId'
@@ -257,6 +268,7 @@ export interface FileRouteTypes {
     | '/settings/integrations'
     | '/settings/keybindings'
     | '/settings/providers'
+    | '/settings/scheduled-tasks'
     | '/settings/source-control'
     | '/_chat/'
     | '/_chat/$environmentId/$threadId'
@@ -324,6 +336,13 @@ declare module '@tanstack/react-router' {
       preLoaderRoute: typeof SettingsSourceControlRouteImport
       parentRoute: typeof SettingsRoute
     }
+    '/settings/scheduled-tasks': {
+      id: '/settings/scheduled-tasks'
+      path: '/scheduled-tasks'
+      fullPath: '/settings/scheduled-tasks'
+      preLoaderRoute: typeof SettingsScheduledTasksRouteImport
+      parentRoute: typeof SettingsRoute
+    }
     '/settings/providers': {
       id: '/settings/providers'
       path: '/providers'
@@ -443,6 +462,7 @@ interface SettingsRouteChildren {
   SettingsIntegrationsRoute: typeof SettingsIntegrationsRoute
   SettingsKeybindingsRoute: typeof SettingsKeybindingsRoute
   SettingsProvidersRoute: typeof SettingsProvidersRoute
+  SettingsScheduledTasksRoute: typeof SettingsScheduledTasksRoute
   SettingsSourceControlRoute: typeof SettingsSourceControlRoute
 }
 
@@ -455,6 +475,7 @@ const SettingsRouteChildren: SettingsRouteChildren = {
   SettingsIntegrationsRoute: SettingsIntegrationsRoute,
   SettingsKeybindingsRoute: SettingsKeybindingsRoute,
   SettingsProvidersRoute: SettingsProvidersRoute,
+  SettingsScheduledTasksRoute: SettingsScheduledTasksRoute,
   SettingsSourceControlRoute: SettingsSourceControlRoute,
 }
 
diff --git a/apps/web/src/routes/__root.tsx b/apps/web/src/routes/__root.tsx
index 4476616a1885..008f6b8ec52f 100644
--- a/apps/web/src/routes/__root.tsx
+++ b/apps/web/src/routes/__root.tsx
@@ -19,6 +19,7 @@ import { ConnectOnboardingDialog } from "../components/cloud/ConnectOnboardingDi
 import { RelayClientInstallDialog } from "../components/cloud/RelayClientInstallDialog";
 import { SshPasswordPromptDialog } from "../components/desktop/SshPasswordPromptDialog";
 import { ProviderUpdateLaunchNotification } from "../components/ProviderUpdateLaunchNotification";
+import { LegacyThreadMigrationToast } from "../components/LegacyThreadMigrationToast";
 import { SlowRpcRequestToastCoordinator } from "../components/SlowRpcRequestToastCoordinator";
 import { ThemeEditorHost } from "../components/settings/ThemeEditorHost";
 import { useDefaultThemeAdoption } from "../hooks/useDefaultTheme";
@@ -144,6 +145,7 @@ function RootRouteView() {
         <SshPasswordPromptDialog />
         <ConfirmDialogHost />
         <SlowRpcRequestToastCoordinator />
+        {primaryEnvironmentAuthenticated ? <LegacyThreadMigrationToast /> : null}
         <HostedStaticEnvironmentBootstrap />
         {primaryEnvironmentAuthenticated ? <EventRouter /> : null}
         {primaryEnvironmentAuthenticated ? <PlanAgentSelectionHeal /> : null}
diff --git a/apps/web/src/routes/_chat.$environmentId.$threadId.tsx b/apps/web/src/routes/_chat.$environmentId.$threadId.tsx
index 5ac4665cf8a3..271f50739682 100644
--- a/apps/web/src/routes/_chat.$environmentId.$threadId.tsx
+++ b/apps/web/src/routes/_chat.$environmentId.$threadId.tsx
@@ -5,14 +5,8 @@ import ChatView from "../components/ChatView";
 import { threadHasStarted } from "../components/ChatView.logic";
 import { finalizePromotedDraftThreadByRef, useComposerDraftStore } from "../composerDraftStore";
 import { resolveThreadRouteRef, resolveThreadRouteRenderState } from "../threadRoutes";
-import { resolveThreadSyncPhase } from "../threadSync";
 import { SidebarInset } from "~/components/ui/sidebar";
-import {
-  useEnvironmentThreadRefs,
-  useThreadDetail,
-  useThreadShell,
-  useThreadStatus,
-} from "../state/entities";
+import { useEnvironmentThreadRefs, useThreadShell } from "../state/entities";
 import { useEnvironmentQuery } from "../state/query";
 import { environmentShell } from "../state/shell";
 
@@ -25,8 +19,6 @@ function ChatThreadRouteView() {
     threadRef === null ? null : environmentShell.stateAtom(threadRef.environmentId),
   );
   const serverThreadShell = useThreadShell(threadRef);
-  const serverThreadDetail = useThreadDetail(threadRef);
-  const serverThreadStatus = useThreadStatus(threadRef);
   const environmentThreadRefs = useEnvironmentThreadRefs(threadRef?.environmentId ?? null);
   const bootstrapComplete = shell.data?.snapshot._tag === "Some";
   const environmentHasServerThreads = environmentThreadRefs.length > 0;
@@ -44,17 +36,11 @@ function ChatThreadRouteView() {
   });
   const renderState = resolveThreadRouteRenderState({
     bootstrapComplete,
-    serverThreadShellExists: serverThreadShell !== null,
-    serverThreadDetailExists: serverThreadDetail !== null,
-    serverThreadDetailDeleted: serverThreadStatus === "deleted",
+    serverThreadExists: serverThreadShell !== null,
+    serverThreadDeleted: serverThreadShell?.deletedAt != null,
     draftThreadExists,
   });
-  const threadSyncPhase = resolveThreadSyncPhase({
-    detailExists: serverThreadDetail !== null,
-    shellExists: serverThreadShell !== null,
-    status: serverThreadStatus,
-  });
-  const serverThreadStarted = threadHasStarted(serverThreadDetail);
+  const serverThreadStarted = threadHasStarted(serverThreadShell);
   const environmentHasAnyThreads = environmentHasServerThreads || environmentHasDraftThreads;
 
   useEffect(() => {
@@ -74,20 +60,17 @@ function ChatThreadRouteView() {
     finalizePromotedDraftThreadByRef(threadRef);
   }, [draftThread, serverThreadStarted, threadRef]);
 
-  if (!threadRef) {
+  if (!threadRef || renderState !== "ready") {
     return null;
   }
 
   return (
     <SidebarInset className="h-svh min-h-0 overflow-hidden overscroll-y-none bg-background text-foreground md:h-dvh">
-      {renderState === "ready" || (renderState === "loading" && serverThreadShell !== null) ? (
-        <ChatView
-          environmentId={threadRef.environmentId}
-          threadId={threadRef.threadId}
-          routeKind="server"
-          threadSyncPhase={threadSyncPhase}
-        />
-      ) : null}
+      <ChatView
+        environmentId={threadRef.environmentId}
+        threadId={threadRef.threadId}
+        routeKind="server"
+      />
     </SidebarInset>
   );
 }
diff --git a/apps/web/src/routes/_chat.draft.$draftId.tsx b/apps/web/src/routes/_chat.draft.$draftId.tsx
index d067c6a8da9c..e6649db33175 100644
--- a/apps/web/src/routes/_chat.draft.$draftId.tsx
+++ b/apps/web/src/routes/_chat.draft.$draftId.tsx
@@ -14,7 +14,7 @@ import {
 import { SidebarInset } from "../components/ui/sidebar";
 import { waitForDraftHeroTransition } from "../components/chat/draftHeroTransition";
 import { buildThreadRouteParams } from "../threadRoutes";
-import { useThread, useThreadRefs } from "../state/entities";
+import { useThreadRefs, useThreadShell } from "../state/entities";
 
 function DraftChatThreadRouteView() {
   const navigate = useNavigate();
@@ -30,7 +30,7 @@ function DraftChatThreadRouteView() {
       ) ?? null)
     : null;
   const serverThreadRef = draftSession?.promotedTo ?? inferredThreadRef;
-  const serverThread = useThread(serverThreadRef);
+  const serverThread = useThreadShell(serverThreadRef);
   const serverThreadStarted = threadHasStarted(serverThread);
   const backgroundSubmissionPending = useBackgroundDraftSubmissionPending(serverThreadRef);
   const canonicalThreadRef = resolveDraftPromotionNavigationTarget({
diff --git a/apps/web/src/routes/_chat.pull-requests.tsx b/apps/web/src/routes/_chat.pull-requests.tsx
index f8894ea57775..5954ccefc64c 100644
--- a/apps/web/src/routes/_chat.pull-requests.tsx
+++ b/apps/web/src/routes/_chat.pull-requests.tsx
@@ -1294,9 +1294,15 @@ function PullRequestsRouteView() {
   const panelToggleControls = (
     <PanelLayoutControls
       showTerminalControl={false}
+      showThreadPanelControl={false}
       terminalAvailable={false}
       terminalOpen={false}
       terminalShortcutLabel={null}
+      threadPanelOpen={false}
+      threadPanelPresentation="inline"
+      threadPanelShortcutLabel={null}
+      threadPanelHasAttention={false}
+      onToggleThreadPanel={() => undefined}
       rightPanelAvailable={rightPanelAvailable}
       rightPanelOpen={rightPanelState.isOpen}
       rightPanelShortcutLabel={null}
diff --git a/apps/web/src/routes/settings.scheduled-tasks.tsx b/apps/web/src/routes/settings.scheduled-tasks.tsx
new file mode 100644
index 000000000000..b896e6ebc889
--- /dev/null
+++ b/apps/web/src/routes/settings.scheduled-tasks.tsx
@@ -0,0 +1,7 @@
+import { createFileRoute } from "@tanstack/react-router";
+
+import { ScheduledTasksSettings } from "../components/settings/ScheduledTasksSettings";
+
+export const Route = createFileRoute("/settings/scheduled-tasks")({
+  component: ScheduledTasksSettings,
+});
diff --git a/apps/web/src/session-logic.command-output.test.ts b/apps/web/src/session-logic.command-output.test.ts
deleted file mode 100644
index 570629046a60..000000000000
--- a/apps/web/src/session-logic.command-output.test.ts
+++ /dev/null
@@ -1,85 +0,0 @@
-import { EventId, TurnId, type OrchestrationThreadActivity } from "@t3tools/contracts";
-import { describe, expect, it } from "vite-plus/test";
-
-import { deriveWorkLogEntries } from "./session-logic";
-
-function makeCommandActivity(
-  id: string,
-  payload: Record<string, unknown>,
-): OrchestrationThreadActivity {
-  return {
-    id: EventId.make(id),
-    createdAt: "2026-07-17T10:00:00.000Z",
-    kind: "tool.completed",
-    summary: "Ran command",
-    tone: "tool",
-    payload,
-    turnId: TurnId.make("turn-1"),
-  };
-}
-
-describe("deriveWorkLogEntries command output", () => {
-  it("uses Codex aggregated output instead of repeating the command", () => {
-    const [entry] = deriveWorkLogEntries([
-      makeCommandActivity("codex-command", {
-        itemType: "command_execution",
-        title: "Ran command",
-        detail: "/bin/zsh -lc \"printf 'hello\\n'\"",
-        data: {
-          item: {
-            type: "commandExecution",
-            command: "/bin/zsh -lc \"printf 'hello\\n'\"",
-            commandActions: [{ command: "printf 'hello\\n'", type: "unknown" }],
-            aggregatedOutput: "hello\n<exited with exit code 0>",
-            status: "completed",
-          },
-        },
-      }),
-    ]);
-
-    expect(entry).toMatchObject({
-      command: "printf 'hello\\n'",
-      rawCommand: "/bin/zsh -lc \"printf 'hello\\n'\"",
-      detail: "hello",
-    });
-  });
-
-  it("uses a projected Claude output summary instead of repeating the command", () => {
-    const [entry] = deriveWorkLogEntries([
-      makeCommandActivity("claude-command", {
-        itemType: "command_execution",
-        title: "Ran command",
-        detail: "printf hello",
-        data: {
-          kind: "execute",
-          command: "printf hello",
-          rawOutput: {
-            content: "hello from claude",
-          },
-        },
-      }),
-    ]);
-
-    expect(entry).toMatchObject({
-      command: "printf hello",
-      detail: "hello from claude",
-    });
-  });
-
-  it("drops duplicated command detail when the command has no output", () => {
-    const [entry] = deriveWorkLogEntries([
-      makeCommandActivity("empty-command", {
-        itemType: "command_execution",
-        title: "Ran command",
-        detail: "true",
-        data: {
-          kind: "execute",
-          command: "true",
-        },
-      }),
-    ]);
-
-    expect(entry?.command).toBe("true");
-    expect(entry?.detail).toBeUndefined();
-  });
-});
diff --git a/apps/web/src/session-logic.test.ts b/apps/web/src/session-logic.test.ts
index 5a2b998704f3..e93f3edd1583 100644
--- a/apps/web/src/session-logic.test.ts
+++ b/apps/web/src/session-logic.test.ts
@@ -1,2357 +1,837 @@
 import {
-  classifyTaskAgentKind,
-  EventId,
   MessageId,
+  NodeId,
+  PlanId,
+  ProviderInstanceId,
+  ProviderThreadId,
+  RunAttemptId,
+  RunId,
   ThreadId,
-  TurnId,
-  type OrchestrationThreadActivity,
+  TurnItemId,
+  type OrchestrationV2ProjectedTurnItem,
+  type OrchestrationV2ExecutionNode,
+  type OrchestrationV2RunAttempt,
+  type OrchestrationV2TurnItem,
 } from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
 import { describe, expect, it } from "vite-plus/test";
 
 import {
-  deriveActiveWorkStartedAt,
-  deriveActivePlanState,
-  deriveTurnPlans,
-  derivePendingApprovals,
-  derivePendingUserInputs,
-  deriveTimelineEntries,
-  deriveWorkLogEntries,
+  deriveTimelineEntriesFromVisibleTurnItems,
+  deriveRevertTurnCountByUserMessageId,
   findLatestProposedPlan,
-  hasActionableProposedPlan,
-  isLatestTurnSettled,
+  isLatestRunSettled,
+  providerErrorPresentation,
+  type TimelineEntry,
   workEntryIndicatesToolFailure,
-  workEntryIndicatesToolNeutralStatus,
+  workEntryDisplayIndicatesToolFailure,
   workEntryIndicatesToolSuccess,
 } from "./session-logic";
+import { makeThreadProjectionFixture } from "./test-fixtures";
+import type { ChatMessage } from "./types";
 
-let nextActivityId = 0;
-
-function makeActivity(overrides: {
-  id?: string;
-  createdAt?: string;
-  kind?: string;
-  summary?: string;
-  tone?: OrchestrationThreadActivity["tone"];
-  payload?: Record<string, unknown>;
-  turnId?: string;
-  sequence?: number;
-}): OrchestrationThreadActivity {
-  // Fixtures model post-ingestion rows: ingestion stamps agentKind on every
-  // task.* payload. Pass an explicit agentKind to model legacy rows.
-  const rawPayload = overrides.payload ?? {};
-  const payload =
-    overrides.kind?.startsWith("task.") && !("agentKind" in rawPayload)
-      ? {
-          ...rawPayload,
-          agentKind: classifyTaskAgentKind({
-            taskType: typeof rawPayload.taskType === "string" ? rawPayload.taskType : undefined,
-            agentId: typeof rawPayload.agentId === "string" ? rawPayload.agentId : undefined,
-          }),
-        }
-      : rawPayload;
-  return {
-    id: EventId.make(overrides.id ?? `activity-${nextActivityId++}`),
-    createdAt: overrides.createdAt ?? "2026-02-23T00:00:00.000Z",
-    kind: overrides.kind ?? "tool.started",
-    summary: overrides.summary ?? "Tool call",
-    tone: overrides.tone ?? "tool",
-    payload,
-    turnId: overrides.turnId ? TurnId.make(overrides.turnId) : null,
-    ...(overrides.sequence !== undefined ? { sequence: overrides.sequence } : {}),
-  };
-}
-
-describe("derivePendingApprovals", () => {
-  it("tracks open approvals and removes resolved ones", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "approval-open",
-        createdAt: "2026-02-23T00:00:01.000Z",
-        kind: "approval.requested",
-        summary: "Command approval requested",
-        tone: "approval",
-        payload: {
-          requestId: "req-1",
-          requestKind: "command",
-          detail: "bun run lint",
+describe("V2 session presentation", () => {
+  it("uses run status as the settlement boundary", () => {
+    const runId = RunId.make("run-1");
+    expect(
+      isLatestRunSettled(
+        {
+          runId,
+          status: "completed",
+          startedAt: "2026-06-20T00:00:00.000Z",
+          completedAt: "2026-06-20T00:01:00.000Z",
         },
-      }),
-      makeActivity({
-        id: "approval-close",
-        createdAt: "2026-02-23T00:00:02.000Z",
-        kind: "approval.resolved",
-        summary: "Approval resolved",
-        tone: "info",
-        payload: { requestId: "req-2" },
-      }),
-      makeActivity({
-        id: "approval-closed-request",
-        createdAt: "2026-02-23T00:00:01.500Z",
-        kind: "approval.requested",
-        summary: "File-change approval requested",
-        tone: "approval",
-        payload: { requestId: "req-2", requestKind: "file-change" },
-      }),
-    ];
-
-    expect(derivePendingApprovals(activities)).toEqual([
-      {
-        requestId: "req-1",
-        requestKind: "command",
-        createdAt: "2026-02-23T00:00:01.000Z",
-        detail: "bun run lint",
-      },
-    ]);
+        null,
+      ),
+    ).toBe(true);
+    expect(
+      isLatestRunSettled(
+        { runId, status: "running", startedAt: null, completedAt: null },
+        { status: "running", activeRunId: runId },
+      ),
+    ).toBe(false);
+    expect(
+      isLatestRunSettled(
+        { runId, status: "queued", startedAt: null, completedAt: null },
+        { status: "running", activeRunId: RunId.make("run-active") },
+      ),
+    ).toBe(false);
   });
 
-  it("maps canonical requestType payloads into pending approvals", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "approval-open-request-type",
-        createdAt: "2026-02-23T00:00:01.000Z",
-        kind: "approval.requested",
-        summary: "Command approval requested",
-        tone: "approval",
-        payload: {
-          requestId: "req-request-type",
-          requestType: "command_execution_approval",
-          detail: "pwd",
-        },
-      }),
-    ];
-
-    expect(derivePendingApprovals(activities)).toEqual([
-      {
-        requestId: "req-request-type",
-        requestKind: "command",
-        createdAt: "2026-02-23T00:00:01.000Z",
-        detail: "pwd",
+  it("labels provider retry progress, delay, recovery, and exhaustion", () => {
+    const now = DateTime.makeUnsafe("2026-06-20T00:00:00.000Z");
+    const retryItem = {
+      id: TurnItemId.make("item-provider-retry"),
+      threadId: ThreadId.make("thread-provider-retry"),
+      runId: RunId.make("run-provider-retry"),
+      nodeId: null,
+      providerThreadId: null,
+      providerTurnId: null,
+      nativeItemRef: null,
+      parentItemId: null,
+      ordinal: 1,
+      status: "running" as const,
+      title: "Provider retry",
+      startedAt: now,
+      completedAt: null,
+      updatedAt: now,
+      type: "error" as const,
+      failure: {
+        class: "provider_error" as const,
+        message: "Claude API overloaded.",
+        code: "api_error_529",
+        retryable: true,
       },
-    ]);
-  });
-
-  it("keeps app access approvals and persistence choices from remote activities", () => {
-    const options = [
-      { decision: "decline", label: "Decline" },
-      { decision: "acceptAlways", label: "Always allow Safari" },
-      { decision: "accept", label: "Approve" },
-    ];
-    const activities = [
-      makeActivity({
-        kind: "approval.requested",
-        summary: "App access approval requested",
-        tone: "approval",
-        payload: {
-          requestId: "req-safari",
-          requestType: "mcp_elicitation_approval",
-          detail: "Allow ChatGPT to use Safari?",
-          appName: "Safari",
-          options,
-        },
-      }),
-    ];
-
-    expect(derivePendingApprovals(activities)).toEqual([
-      {
-        requestId: "req-safari",
-        requestKind: "mcp-elicitation",
-        createdAt: "2026-02-23T00:00:00.000Z",
-        detail: "Allow ChatGPT to use Safari?",
-        appName: "Safari",
-        options,
+      retry: {
+        attempt: 2,
+        maxAttempts: 10,
+        retryDelayMs: 1_500,
       },
-    ]);
-  });
+    } satisfies Extract<OrchestrationV2TurnItem, { readonly type: "error" }>;
 
-  it("derives dynamic tool requests as actionable generic approvals", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "approval-open-dynamic-tool",
-        createdAt: "2026-02-23T00:00:01.000Z",
-        kind: "approval.requested",
-        summary: "Approval requested",
-        tone: "approval",
-        payload: {
-          requestId: "req-dynamic-tool",
-          requestType: "dynamic_tool_call",
-          detail: "Search the web",
-        },
+    expect(providerErrorPresentation(retryItem)).toEqual({
+      label: "Retrying provider (2/10)",
+      detail: "Claude API overloaded. Retrying in 1.5s.",
+    });
+    expect(
+      providerErrorPresentation({
+        ...retryItem,
+        status: "completed",
+        completedAt: now,
       }),
-    ];
-
-    expect(derivePendingApprovals(activities)).toEqual([
+    ).toMatchObject({ label: "Provider recovered (2/10 retries)" });
+    expect(
+      providerErrorPresentation({
+        ...retryItem,
+        status: "failed",
+        retry: { ...retryItem.retry, attempt: 10 },
+        completedAt: now,
+      }),
+    ).toMatchObject({ label: "Provider error after 10/10 retries" });
+  });
+
+  it("selects the latest proposed plan for a run", () => {
+    const runId = RunId.make("run-1");
+    const planId = PlanId.make("plan-1");
+    const nodeId = NodeId.make("node-plan");
+    const now = DateTime.makeUnsafe("2026-06-20T00:00:01.000Z");
+    const baseProjection = makeThreadProjectionFixture();
+    const plan = findLatestProposedPlan(
       {
-        requestId: "req-dynamic-tool",
-        requestKind: "command",
-        createdAt: "2026-02-23T00:00:01.000Z",
-        detail: "Search the web",
-      },
-    ]);
-  });
-
-  it("clears stale pending approvals when provider reports unknown pending request", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "approval-open-stale",
-        createdAt: "2026-02-23T00:00:01.000Z",
-        kind: "approval.requested",
-        summary: "Command approval requested",
-        tone: "approval",
-        payload: {
-          requestId: "req-stale-1",
-          requestKind: "command",
-        },
-      }),
-      makeActivity({
-        id: "approval-failed-stale",
-        createdAt: "2026-02-23T00:00:02.000Z",
-        kind: "provider.approval.respond.failed",
-        summary: "Provider approval response failed",
-        tone: "error",
-        payload: {
-          requestId: "req-stale-1",
-          detail: "Unknown pending permission request: req-stale-1",
-        },
-      }),
-    ];
-
-    expect(derivePendingApprovals(activities)).toEqual([]);
-  });
-
-  it("clears stale pending approvals when the backend marks them stale after restart", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "approval-open-stale-restart",
-        createdAt: "2026-02-23T00:00:01.000Z",
-        kind: "approval.requested",
-        summary: "Command approval requested",
-        tone: "approval",
-        payload: {
-          requestId: "req-stale-restart-1",
-          requestKind: "command",
-        },
-      }),
-      makeActivity({
-        id: "approval-failed-stale-restart",
-        createdAt: "2026-02-23T00:00:02.000Z",
-        kind: "provider.approval.respond.failed",
-        summary: "Provider approval response failed",
-        tone: "error",
-        payload: {
-          requestId: "req-stale-restart-1",
-          detail:
-            "Stale pending approval request: req-stale-restart-1. Provider callback state does not survive app restarts or recovered sessions. Restart the turn to continue.",
-        },
-      }),
-    ];
-
-    expect(derivePendingApprovals(activities)).toEqual([]);
-  });
-});
-
-describe("derivePendingUserInputs", () => {
-  it("tracks open structured prompts and removes resolved ones", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "user-input-open",
-        createdAt: "2026-02-23T00:00:01.000Z",
-        kind: "user-input.requested",
-        summary: "User input requested",
-        tone: "info",
-        payload: {
-          requestId: "req-user-input-1",
-          questions: [
-            {
-              id: "sandbox_mode",
-              header: "Sandbox",
-              question: "Which mode should be used?",
-              options: [
-                {
-                  label: "workspace-write",
-                  description: "Allow workspace writes only",
-                },
-              ],
-              multiSelect: true,
-            },
-          ],
-        },
-      }),
-      makeActivity({
-        id: "user-input-resolved",
-        createdAt: "2026-02-23T00:00:02.000Z",
-        kind: "user-input.resolved",
-        summary: "User input submitted",
-        tone: "info",
-        payload: {
-          requestId: "req-user-input-2",
-          answers: {
-            sandbox_mode: "workspace-write",
+        ...baseProjection,
+        plans: [
+          {
+            id: planId,
+            threadId: baseProjection.thread.id,
+            nodeId,
+            kind: "proposed_plan" as const,
+            markdown: "Plan",
+            status: "active" as const,
+            runId,
           },
-        },
-      }),
-      makeActivity({
-        id: "user-input-open-2",
-        createdAt: "2026-02-23T00:00:01.500Z",
-        kind: "user-input.requested",
-        summary: "User input requested",
-        tone: "info",
-        payload: {
-          requestId: "req-user-input-2",
-          questions: [
-            {
-              id: "approval",
-              header: "Approval",
-              question: "Continue?",
-              options: [
-                {
-                  label: "yes",
-                  description: "Continue execution",
-                },
-              ],
-              multiSelect: false,
-            },
-          ],
-        },
-      }),
-    ];
-
-    expect(derivePendingUserInputs(activities)).toEqual([
-      {
-        requestId: "req-user-input-1",
-        createdAt: "2026-02-23T00:00:01.000Z",
-        questions: [
+        ],
+        turnItems: [
           {
-            id: "sandbox_mode",
-            header: "Sandbox",
-            question: "Which mode should be used?",
-            options: [
-              {
-                label: "workspace-write",
-                description: "Allow workspace writes only",
-              },
-            ],
-            multiSelect: true,
+            id: TurnItemId.make("item-plan"),
+            threadId: baseProjection.thread.id,
+            nodeId,
+            providerThreadId: null,
+            providerTurnId: null,
+            nativeItemRef: null,
+            parentItemId: null,
+            ordinal: 0,
+            status: "completed" as const,
+            title: null,
+            startedAt: now,
+            completedAt: now,
+            updatedAt: now,
+            type: "proposed_plan" as const,
+            planId,
+            markdown: "Plan",
+            streaming: false,
+            runId,
           },
         ],
+        updatedAt: now,
       },
-    ]);
+      runId,
+    );
+    expect(plan?.planMarkdown).toBe("Plan");
   });
 
-  it("clears stale pending user-input prompts when the provider reports an orphaned request", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "user-input-open-stale",
-        createdAt: "2026-02-23T00:00:01.000Z",
-        kind: "user-input.requested",
-        summary: "User input requested",
-        tone: "info",
-        payload: {
-          requestId: "req-user-input-stale-1",
-          questions: [
-            {
-              id: "sandbox_mode",
-              header: "Sandbox",
-              question: "Which mode should be used?",
-              options: [
-                {
-                  label: "workspace-write",
-                  description: "Allow workspace writes only",
-                },
-              ],
-              multiSelect: false,
-            },
-          ],
-        },
-      }),
-      makeActivity({
-        id: "user-input-failed-stale",
-        createdAt: "2026-02-23T00:00:02.000Z",
-        kind: "provider.user-input.respond.failed",
-        summary: "Provider user input response failed",
-        tone: "error",
-        payload: {
-          requestId: "req-user-input-stale-1",
-          detail:
-            "Provider adapter request failed (codex) for item/tool/requestUserInput: Unknown pending Codex user input request: req-user-input-stale-1",
-        },
-      }),
+  it("assigns run rollback to the turn-start message instead of a later steer", () => {
+    const runId = RunId.make("run-steered");
+    const turnStartMessageId = MessageId.make("message-turn-start");
+    const steerMessageId = MessageId.make("message-steer");
+    const assistantMessageId = MessageId.make("message-assistant");
+    const messages: ChatMessage[] = [
+      {
+        id: turnStartMessageId,
+        role: "user",
+        text: "Start",
+        runId,
+        inputIntent: "turn_start",
+        streaming: false,
+        createdAt: "2026-06-20T00:00:00.000Z",
+        updatedAt: "2026-06-20T00:00:00.000Z",
+      },
+      {
+        id: steerMessageId,
+        role: "user",
+        text: "Steer",
+        runId,
+        inputIntent: "steer",
+        streaming: false,
+        createdAt: "2026-06-20T00:00:01.000Z",
+        updatedAt: "2026-06-20T00:00:01.000Z",
+      },
+      {
+        id: assistantMessageId,
+        role: "assistant",
+        text: "Done",
+        runId,
+        streaming: false,
+        createdAt: "2026-06-20T00:00:02.000Z",
+        updatedAt: "2026-06-20T00:00:02.000Z",
+      },
     ];
-
-    expect(derivePendingUserInputs(activities)).toEqual([]);
-  });
-});
-
-describe("deriveActivePlanState", () => {
-  it("returns the latest plan update for the active turn", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "plan-old",
-        createdAt: "2026-02-23T00:00:01.000Z",
-        kind: "turn.plan.updated",
-        summary: "Plan updated",
-        tone: "info",
-        turnId: "turn-1",
-        payload: {
-          explanation: "Initial plan",
-          plan: [{ step: "Inspect code", status: "pending" }],
-        },
-      }),
-      makeActivity({
-        id: "plan-latest",
-        createdAt: "2026-02-23T00:00:02.000Z",
-        kind: "turn.plan.updated",
-        summary: "Plan updated",
-        tone: "info",
-        turnId: "turn-1",
-        payload: {
-          explanation: "Refined plan",
-          plan: [{ step: "Implement Codex user input", status: "inProgress" }],
-        },
+    const timelineEntries: TimelineEntry[] = messages.map(
+      (message): TimelineEntry => ({
+        id: message.id,
+        kind: "message",
+        createdAt: message.createdAt,
+        message,
       }),
-    ];
-
-    expect(deriveActivePlanState(activities, TurnId.make("turn-1"))).toEqual({
-      createdAt: "2026-02-23T00:00:02.000Z",
-      turnId: "turn-1",
-      explanation: "Refined plan",
-      steps: [{ step: "Implement Codex user input", status: "inProgress" }],
-    });
-  });
+    );
 
-  it("falls back to the most recent plan from a previous turn", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "plan-from-turn-1",
-        createdAt: "2026-02-23T00:00:01.000Z",
-        kind: "turn.plan.updated",
-        summary: "Plan updated",
-        tone: "info",
-        turnId: "turn-1",
-        payload: {
-          plan: [{ step: "Write tests", status: "completed" }],
+    const targets = deriveRevertTurnCountByUserMessageId({
+      timelineEntries,
+      checkpoints: [
+        {
+          runId,
+          checkpointTurnCount: 1,
+          checkpointRef: "checkpoint-run-1" as never,
+          status: "ready",
+          files: [],
+          assistantMessageId,
+          completedAt: "2026-06-20T00:00:03.000Z",
         },
-      }),
-    ];
-
-    // Current turn is turn-2, which has no plan activity — should fall back to turn-1's plan
-    const result = deriveActivePlanState(activities, TurnId.make("turn-2"));
-    expect(result).toEqual({
-      createdAt: "2026-02-23T00:00:01.000Z",
-      turnId: "turn-1",
-      steps: [{ step: "Write tests", status: "completed" }],
+      ],
     });
-  });
 
-  it("starts timing again after a plan is cleared and recreated", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "plan-old-start",
-        createdAt: "2026-02-23T00:00:01.000Z",
-        kind: "turn.plan.updated",
-        summary: "Plan updated",
-        tone: "info",
-        turnId: "turn-1",
-        payload: { plan: [{ step: "Check", status: "inProgress" }] },
-      }),
-      makeActivity({
-        id: "plan-old-complete",
-        createdAt: "2026-02-23T00:00:05.000Z",
-        kind: "turn.plan.updated",
-        summary: "Plan updated",
-        tone: "info",
-        turnId: "turn-1",
-        payload: { plan: [{ step: "Check", status: "completed" }] },
-      }),
-      makeActivity({
-        id: "plan-clear",
-        createdAt: "2026-02-23T00:00:06.000Z",
-        kind: "turn.plan.updated",
-        summary: "Plan updated",
-        tone: "info",
-        turnId: "turn-1",
-        payload: { plan: [] },
-      }),
-      makeActivity({
-        id: "plan-new-start",
-        createdAt: "2026-02-23T00:00:10.000Z",
-        kind: "turn.plan.updated",
-        summary: "Plan updated",
-        tone: "info",
-        turnId: "turn-1",
-        payload: { plan: [{ step: "Check", status: "inProgress" }] },
-      }),
-      makeActivity({
-        id: "plan-new-complete",
-        createdAt: "2026-02-23T00:00:13.000Z",
-        kind: "turn.plan.updated",
-        summary: "Plan updated",
-        tone: "info",
-        turnId: "turn-1",
-        payload: { plan: [{ step: "Check", status: "completed" }] },
-      }),
-    ];
+    expect([...targets]).toEqual([[turnStartMessageId, 0]]);
+    expect(targets.has(steerMessageId)).toBe(false);
+  });
+
+  it("uses visible turn item order and keeps provider errors in the work log", () => {
+    const now = DateTime.makeUnsafe("2026-06-20T00:00:00.000Z");
+    const threadId = ThreadId.make("thread-visible");
+    const runId = RunId.make("run-visible");
+    const base = (id: string, ordinal: number) => ({
+      id: TurnItemId.make(id),
+      threadId,
+      runId,
+      nodeId: null,
+      providerThreadId: null,
+      providerTurnId: null,
+      nativeItemRef: null,
+      parentItemId: null,
+      ordinal,
+      status: "completed" as const,
+      title: null,
+      startedAt: now,
+      completedAt: now,
+      updatedAt: now,
+    });
+    const userItem = {
+      ...base("item-user", 0),
+      type: "user_message" as const,
+      messageId: MessageId.make("message-user"),
+      inputIntent: "turn_start" as const,
+      text: "Start",
+      attachments: [],
+      createdBy: "user" as const,
+      creationSource: "web" as const,
+    } satisfies OrchestrationV2TurnItem;
+    const requestItem = {
+      ...base("item-interrupt-request", 1),
+      type: "run_interrupt_request" as const,
+      message: "Stopping",
+    } satisfies OrchestrationV2TurnItem;
+    const commandItem = {
+      ...base("item-command", 2),
+      type: "command_execution" as const,
+      input: "sleep 1",
+      output: "done",
+      exitCode: 0,
+    } satisfies OrchestrationV2TurnItem;
+    const resultItem = {
+      ...base("item-interrupt-result", 3),
+      type: "run_interrupt_result" as const,
+      message: "Stopped",
+    } satisfies OrchestrationV2TurnItem;
+    const todoItem = {
+      ...base("item-todo", 4),
+      type: "todo_list" as const,
+      planId: PlanId.make("plan-visible"),
+      explanation: "Keep task detail in the Tasks panel",
+      steps: [
+        { id: "step-1", text: "First", status: "completed" as const },
+        { id: "step-2", text: "Second", status: "pending" as const },
+      ],
+    } satisfies OrchestrationV2TurnItem;
+    const errorItem = {
+      ...base("item-error", 5),
+      status: "failed" as const,
+      type: "error" as const,
+      failure: {
+        class: "validation_error" as const,
+        message: "Invalid reasoning effort.",
+        code: "invalid_request",
+        retryable: false,
+      },
+    } satisfies OrchestrationV2TurnItem;
+    const threadCreatedItem = {
+      ...base("item-thread-created", 6),
+      type: "thread_created" as const,
+      title: "Follow-up thread",
+      targetThreadId: ThreadId.make("thread-follow-up"),
+      targetRunId: RunId.make("run-follow-up"),
+      targetProviderInstanceId: ProviderInstanceId.make("claude-default"),
+      targetModel: "claude-sonnet-4-6",
+    } satisfies OrchestrationV2TurnItem;
+    const workspacePreparationItem = {
+      ...base("item-workspace-preparation", 7),
+      type: "command_execution" as const,
+      title: "Workspace ready",
+      input: "Preparing workspace",
+      output: "Workspace preparation completed.",
+      exitCode: 0,
+    } satisfies OrchestrationV2TurnItem;
+    const visibleTurnItems: ReadonlyArray<OrchestrationV2ProjectedTurnItem> = [
+      userItem,
+      requestItem,
+      commandItem,
+      resultItem,
+      todoItem,
+      errorItem,
+      threadCreatedItem,
+      workspacePreparationItem,
+    ].map((item, position) => ({
+      position,
+      visibility: "local" as const,
+      sourceThreadId: threadId,
+      sourceItemId: item.id,
+      item,
+    }));
+
+    const entries = deriveTimelineEntriesFromVisibleTurnItems({
+      visibleTurnItems,
+      optimisticMessages: [],
+    });
 
-    expect(deriveActivePlanState(activities, TurnId.make("turn-1"))?.steps).toEqual([
-      { durationMs: 3_000, step: "Check", status: "completed" },
+    expect(entries.map((entry) => [entry.kind, entry.id])).toEqual([
+      ["message", userItem.messageId],
+      ["event", requestItem.id],
+      ["work", commandItem.id],
+      ["event", resultItem.id],
+      ["turn-plan", todoItem.id],
+      ["work", errorItem.id],
+      ["event", threadCreatedItem.id],
     ]);
+    const commandEntry = entries[2];
+    const userEntry = entries[0];
+    expect(userEntry?.kind).toBe("message");
+    if (userEntry?.kind === "message") {
+      expect(userEntry.projectedItem).toBe(visibleTurnItems[0]);
+      expect(userEntry.message.inputIntent).toBe("turn_start");
+      expect(userEntry.message.createdBy).toBe("user");
+      expect(userEntry.message.creationSource).toBe("web");
+    }
+    expect(commandEntry?.kind).toBe("work");
+    if (commandEntry?.kind === "work") {
+      expect(commandEntry.entry.projectedItem).toBe(visibleTurnItems[2]);
+      expect(commandEntry.entry.structuredPayload).toBe(commandItem);
+    }
+    const todoEntry = entries[4];
+    expect(todoEntry?.kind).toBe("turn-plan");
+    if (todoEntry?.kind === "turn-plan") {
+      expect(todoEntry.turnPlan.id).toBe("turn-plan:plan-visible");
+      expect(todoEntry.turnPlan.plan.explanation).toBe("Keep task detail in the Tasks panel");
+      expect(todoEntry.turnPlan.plan.steps).toEqual([
+        { step: "First", status: "completed" },
+        { step: "Second", status: "pending" },
+      ]);
+    }
+    const errorEntry = entries[5];
+    expect(errorEntry?.kind).toBe("work");
+    if (errorEntry?.kind === "work") {
+      expect(errorEntry.entry.projectedItem).toBe(visibleTurnItems[5]);
+      expect(errorEntry.entry.label).toBe("Provider error");
+      expect(errorEntry.entry.detail).toBe("Invalid reasoning effort.");
+      expect(errorEntry.entry.tone).toBe("info");
+      expect(errorEntry.entry.toolLifecycleStatus).toBe("failed");
+    }
+    const threadCreatedEntry = entries[6];
+    expect(threadCreatedEntry?.kind).toBe("event");
+    if (threadCreatedEntry?.kind === "event") {
+      expect(threadCreatedEntry.projectedItem.item.type).toBe("thread_created");
+    }
   });
-});
-
-describe("deriveTurnPlans", () => {
-  it("keeps one entry per turn, anchored at the first snapshot with the latest steps", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "plan-1a",
-        createdAt: "2026-02-23T00:00:01.000Z",
-        kind: "turn.plan.updated",
-        summary: "Plan updated",
-        tone: "info",
-        turnId: "turn-1",
-        payload: {
-          plan: [{ step: "Inspect code", status: "inProgress" }],
-        },
-      }),
-      makeActivity({
-        id: "plan-1b",
-        createdAt: "2026-02-23T00:00:05.000Z",
-        kind: "turn.plan.updated",
-        summary: "Plan updated",
-        tone: "info",
-        turnId: "turn-1",
-        payload: {
-          plan: [{ step: "Inspect code", status: "completed" }],
-        },
-      }),
-      makeActivity({
-        id: "plan-2a",
-        createdAt: "2026-02-23T00:01:00.000Z",
-        kind: "turn.plan.updated",
-        summary: "Plan updated",
-        tone: "info",
-        turnId: "turn-2",
-        payload: {
-          plan: [{ step: "Ship it", status: "pending" }],
-        },
-      }),
-    ];
 
-    const turnPlans = deriveTurnPlans(activities);
-    expect(turnPlans).toHaveLength(2);
-    expect(turnPlans[0]).toMatchObject({
-      id: "turn-plan:turn-1",
-      createdAt: "2026-02-23T00:00:01.000Z",
-      turnId: "turn-1",
+  it("keeps failed tool items tool-toned so groups still summarize", () => {
+    const failedCommand = {
+      id: TurnItemId.make("item-failed-command"),
+      threadId: ThreadId.make("thread-1"),
+      runId: RunId.make("run-1"),
+      nodeId: null,
+      providerThreadId: null,
+      providerTurnId: null,
+      nativeItemRef: null,
+      parentItemId: null,
+      ordinal: 0,
+      status: "failed" as const,
+      title: null,
+      startedAt: null,
+      completedAt: null,
+      updatedAt: DateTime.nowUnsafe(),
+      type: "command_execution" as const,
+      input: "ssh host true",
+      output: "connection refused",
+      exitCode: 255,
+    } satisfies OrchestrationV2TurnItem;
+    const entries = deriveTimelineEntriesFromVisibleTurnItems({
+      visibleTurnItems: [
+        {
+          position: 0,
+          visibility: "local" as const,
+          sourceThreadId: ThreadId.make("thread-1"),
+          sourceItemId: failedCommand.id,
+          item: failedCommand,
+        } as never,
+      ],
+      optimisticMessages: [],
     });
-    expect(turnPlans[0]?.plan.steps).toEqual([
-      { durationMs: 4_000, step: "Inspect code", status: "completed" },
-    ]);
-    expect(turnPlans[1]?.plan.steps).toEqual([{ step: "Ship it", status: "pending" }]);
+    const entry = entries[0];
+    expect(entry?.kind).toBe("work");
+    if (entry?.kind === "work") {
+      // An exit-code failure is still an ordinary tool row: the failed
+      // lifecycle status carries the marker, and an "error" tone here would
+      // knock the whole group out of the "Ran N commands" summary.
+      expect(entry.entry.tone).toBe("tool");
+      expect(entry.entry.toolLifecycleStatus).toBe("failed");
+    }
   });
 
-  it("skips activities without parseable steps", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "plan-bad",
-        createdAt: "2026-02-23T00:00:01.000Z",
-        kind: "turn.plan.updated",
-        summary: "Plan updated",
-        tone: "info",
-        turnId: "turn-1",
-        payload: { plan: [] },
-      }),
-    ];
-    expect(deriveTurnPlans(activities)).toEqual([]);
-  });
+  it("waits for a dispatched turn item before adding queued input to the timeline", () => {
+    const projection = makeThreadProjectionFixture();
+    const now = DateTime.makeUnsafe("2026-06-20T00:00:00.000Z");
+    const runId = RunId.make("run-dispatched-queued");
+    const messageId = MessageId.make("message-dispatched-queued");
+    const optimisticMessage = {
+      id: messageId,
+      role: "user" as const,
+      text: "Queued input",
+      runId: null,
+      inputIntent: "queued_turn" as const,
+      streaming: false,
+      createdAt: DateTime.formatIso(now),
+      updatedAt: DateTime.formatIso(now),
+    };
 
-  it("tracks repeated step labels independently", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "plan-1a",
-        createdAt: "2026-02-23T00:00:01.000Z",
-        kind: "turn.plan.updated",
-        summary: "Plan updated",
-        tone: "info",
-        turnId: "turn-1",
-        payload: {
-          plan: [
-            { step: "Check", status: "inProgress" },
-            { step: "Check", status: "pending" },
-          ],
-        },
-      }),
-      makeActivity({
-        id: "plan-1b",
-        createdAt: "2026-02-23T00:00:05.000Z",
-        kind: "turn.plan.updated",
-        summary: "Plan updated",
-        tone: "info",
-        turnId: "turn-1",
-        payload: {
-          plan: [
-            { step: "Check", status: "completed" },
-            { step: "Check", status: "inProgress" },
-          ],
-        },
-      }),
-      makeActivity({
-        id: "plan-1c",
-        createdAt: "2026-02-23T00:00:11.000Z",
-        kind: "turn.plan.updated",
-        summary: "Plan updated",
-        tone: "info",
-        turnId: "turn-1",
-        payload: {
-          plan: [
-            { step: "Check", status: "completed" },
-            { step: "Check", status: "completed" },
-          ],
+    expect(
+      deriveTimelineEntriesFromVisibleTurnItems({
+        visibleTurnItems: [],
+        optimisticMessages: [optimisticMessage],
+      }),
+    ).toEqual([]);
+
+    const dispatchedItem = {
+      id: TurnItemId.make("item-dispatched-queued"),
+      threadId: projection.thread.id,
+      runId,
+      nodeId: null,
+      providerThreadId: null,
+      providerTurnId: null,
+      nativeItemRef: null,
+      parentItemId: null,
+      ordinal: 200,
+      status: "completed" as const,
+      title: null,
+      startedAt: now,
+      completedAt: now,
+      updatedAt: now,
+      type: "user_message" as const,
+      messageId,
+      inputIntent: "turn_start" as const,
+      text: "Queued input",
+      attachments: [],
+      createdBy: "user" as const,
+      creationSource: "web" as const,
+    } satisfies OrchestrationV2TurnItem;
+    const promotedEntries = deriveTimelineEntriesFromVisibleTurnItems({
+      visibleTurnItems: [
+        {
+          position: 0,
+          visibility: "local",
+          sourceThreadId: projection.thread.id,
+          sourceItemId: dispatchedItem.id,
+          item: dispatchedItem,
         },
-      }),
-    ];
-
-    expect(deriveTurnPlans(activities)[0]?.plan.steps).toEqual([
-      { durationMs: 4_000, step: "Check", status: "completed" },
-      { durationMs: 6_000, step: "Check", status: "completed" },
-    ]);
+      ],
+      optimisticMessages: [optimisticMessage],
+    });
+    expect(promotedEntries.map((entry) => entry.id)).toEqual([messageId]);
+    expect(promotedEntries[0]?.kind).toBe("message");
+    if (promotedEntries[0]?.kind === "message") {
+      expect(promotedEntries[0].message.inputIntent).toBe("turn_start");
+    }
   });
 
-  it("derives fallback durations in completion order", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "plan-start",
-        createdAt: "2026-02-23T00:00:01.000Z",
-        kind: "turn.plan.updated",
-        summary: "Plan updated",
-        tone: "info",
-        turnId: "turn-1",
-        payload: {
-          plan: [
-            { step: "First", status: "pending" },
-            { step: "Second", status: "pending" },
-          ],
-        },
-      }),
-      makeActivity({
-        id: "plan-second-complete",
-        createdAt: "2026-02-23T00:00:06.000Z",
-        kind: "turn.plan.updated",
-        summary: "Plan updated",
-        tone: "info",
-        turnId: "turn-1",
-        payload: {
-          plan: [
-            { step: "First", status: "pending" },
-            { step: "Second", status: "completed" },
-          ],
-        },
-      }),
-      makeActivity({
-        id: "plan-first-complete",
-        createdAt: "2026-02-23T00:00:11.000Z",
-        kind: "turn.plan.updated",
-        summary: "Plan updated",
-        tone: "info",
-        turnId: "turn-1",
-        payload: {
-          plan: [
-            { step: "First", status: "completed" },
-            { step: "Second", status: "completed" },
-          ],
-        },
-      }),
-    ];
+  it("anchors feedback before later committed turns without reordering canonical history", () => {
+    const threadId = ThreadId.make("thread-feedback-order");
+    const messageItem = (input: {
+      readonly id: string;
+      readonly role: "user" | "assistant";
+      readonly createdAt: string;
+      readonly ordinal: number;
+    }): OrchestrationV2TurnItem => {
+      const timestamp = DateTime.makeUnsafe(input.createdAt);
+      const common = {
+        id: TurnItemId.make(`item-${input.id}`),
+        threadId,
+        runId: RunId.make(`run-${input.ordinal}`),
+        nodeId: null,
+        providerThreadId: null,
+        providerTurnId: null,
+        nativeItemRef: null,
+        parentItemId: null,
+        ordinal: input.ordinal,
+        status: "completed" as const,
+        title: null,
+        startedAt: timestamp,
+        completedAt: timestamp,
+        updatedAt: timestamp,
+        messageId: MessageId.make(input.id),
+        text: input.id,
+      };
+      return input.role === "user"
+        ? {
+            ...common,
+            type: "user_message",
+            inputIntent: "turn_start",
+            attachments: [],
+            createdBy: "user",
+            creationSource: "web",
+          }
+        : { ...common, type: "assistant_message", streaming: false };
+    };
+    const canonicalItems = [
+      messageItem({ id: "old-user", role: "user", createdAt: "2026-08-29T00:00:01Z", ordinal: 1 }),
+      messageItem({
+        id: "old-assistant",
+        role: "assistant",
+        createdAt: "2026-08-29T00:00:02Z",
+        ordinal: 2,
+      }),
+      messageItem({
+        id: "later-user",
+        role: "user",
+        createdAt: "2026-08-29T00:00:05Z",
+        ordinal: 3,
+      }),
+      messageItem({
+        id: "later-assistant",
+        role: "assistant",
+        createdAt: "2026-08-29T00:00:04Z",
+        ordinal: 4,
+      }),
+    ];
+    const visibleTurnItems = canonicalItems.map((item, position) => ({
+      position,
+      visibility: "local" as const,
+      sourceThreadId: threadId,
+      sourceItemId: item.id,
+      item,
+    }));
+    const feedback = (id: string, role: "user" | "assistant"): ChatMessage => ({
+      id: MessageId.make(id),
+      role,
+      text: id,
+      runId: null,
+      streaming: false,
+      createdAt: "2026-08-29T00:00:03Z",
+      updatedAt: "2026-08-29T00:00:03Z",
+    });
+    const entries = deriveTimelineEntriesFromVisibleTurnItems({
+      visibleTurnItems,
+      anchoredMessages: [
+        feedback("feedback-user", "user"),
+        feedback("feedback-assistant", "assistant"),
+        feedback("later-user", "user"),
+      ],
+      optimisticMessages: [
+        { ...feedback("optimistic-user", "user"), createdAt: "2026-08-29T00:00:00Z" },
+      ],
+    });
 
-    expect(deriveTurnPlans(activities)[0]?.plan.steps).toEqual([
-      { durationMs: 5_000, step: "First", status: "completed" },
-      { durationMs: 5_000, step: "Second", status: "completed" },
+    expect(entries.map((entry) => entry.id)).toEqual([
+      "old-user",
+      "old-assistant",
+      "feedback-user",
+      "feedback-assistant",
+      "later-user",
+      "later-assistant",
+      "optimistic-user",
     ]);
-  });
-
-  it("drops a turn's chip when a later snapshot clears the plan", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "plan-set",
-        createdAt: "2026-02-23T00:00:01.000Z",
-        kind: "turn.plan.updated",
-        summary: "Plan updated",
-        tone: "info",
-        turnId: "turn-1",
-        payload: { plan: [{ step: "Inspect code", status: "inProgress" }] },
-      }),
-      makeActivity({
-        id: "plan-clear",
-        createdAt: "2026-02-23T00:00:02.000Z",
-        kind: "turn.plan.updated",
-        summary: "Plan updated",
-        tone: "info",
-        turnId: "turn-1",
-        payload: { plan: [] },
-      }),
-    ];
-    expect(deriveTurnPlans(activities)).toEqual([]);
-  });
-});
-
-describe("findLatestProposedPlan", () => {
-  it("prefers the latest proposed plan for the active turn", () => {
     expect(
-      findLatestProposedPlan(
-        [
-          {
-            id: "plan:thread-1:turn:turn-1",
-            turnId: TurnId.make("turn-1"),
-            planMarkdown: "# Older",
-            implementedAt: null,
-            implementationThreadId: null,
-            createdAt: "2026-02-23T00:00:01.000Z",
-            updatedAt: "2026-02-23T00:00:01.000Z",
-          },
-          {
-            id: "plan:thread-1:turn:turn-1",
-            turnId: TurnId.make("turn-1"),
-            planMarkdown: "# Latest",
-            implementedAt: null,
-            implementationThreadId: null,
-            createdAt: "2026-02-23T00:00:01.000Z",
-            updatedAt: "2026-02-23T00:00:02.000Z",
-          },
-          {
-            id: "plan:thread-1:turn:turn-2",
-            turnId: TurnId.make("turn-2"),
-            planMarkdown: "# Different turn",
-            implementedAt: null,
-            implementationThreadId: null,
-            createdAt: "2026-02-23T00:00:03.000Z",
-            updatedAt: "2026-02-23T00:00:03.000Z",
-          },
-        ],
-        TurnId.make("turn-1"),
-      ),
-    ).toEqual({
-      id: "plan:thread-1:turn:turn-1",
-      turnId: "turn-1",
-      planMarkdown: "# Latest",
-      implementedAt: null,
-      implementationThreadId: null,
-      createdAt: "2026-02-23T00:00:01.000Z",
-      updatedAt: "2026-02-23T00:00:02.000Z",
-    });
+      entries
+        .filter((entry) => entry.id.startsWith("feedback-"))
+        .every((entry) => entry.kind === "message" && entry.projectedItem === undefined),
+    ).toBe(true);
   });
 
-  it("falls back to the most recently updated proposed plan", () => {
-    const latestPlan = findLatestProposedPlan(
-      [
-        {
-          id: "plan:thread-1:turn:turn-1",
-          turnId: TurnId.make("turn-1"),
-          planMarkdown: "# First",
-          implementedAt: null,
-          implementationThreadId: null,
-          createdAt: "2026-02-23T00:00:01.000Z",
-          updatedAt: "2026-02-23T00:00:01.000Z",
-        },
+  it("uses projected plan status and file contents in timeline entries", () => {
+    const now = DateTime.makeUnsafe("2026-06-20T00:00:00.000Z");
+    const threadId = ThreadId.make("thread-timeline-artifacts");
+    const runId = RunId.make("run-timeline-artifacts");
+    const nodeId = NodeId.make("node-timeline-artifacts");
+    const planId = PlanId.make("plan-timeline-artifacts");
+    const base = {
+      threadId,
+      runId,
+      nodeId,
+      providerThreadId: null,
+      providerTurnId: null,
+      nativeItemRef: null,
+      parentItemId: null,
+      status: "completed" as const,
+      title: null,
+      startedAt: now,
+      completedAt: now,
+      updatedAt: now,
+    };
+    const planItem = {
+      ...base,
+      id: TurnItemId.make("item-proposed-plan"),
+      ordinal: 0,
+      type: "proposed_plan" as const,
+      planId,
+      markdown: "Finished plan",
+      streaming: false,
+    } satisfies OrchestrationV2TurnItem;
+    const fileItem = {
+      ...base,
+      id: TurnItemId.make("item-file-change"),
+      ordinal: 1,
+      type: "file_change" as const,
+      fileName: "src/example.ts",
+      newStr: "export const answer = 42;\n",
+    } satisfies OrchestrationV2TurnItem;
+    const visibleTurnItems: ReadonlyArray<OrchestrationV2ProjectedTurnItem> = [
+      planItem,
+      fileItem,
+    ].map((item, position) => ({
+      position,
+      visibility: "local",
+      sourceThreadId: threadId,
+      sourceItemId: item.id,
+      item,
+    }));
+
+    const entries = deriveTimelineEntriesFromVisibleTurnItems({
+      visibleTurnItems,
+      optimisticMessages: [],
+      plans: [
         {
-          id: "plan:thread-1:turn:turn-2",
-          turnId: TurnId.make("turn-2"),
-          planMarkdown: "# Latest",
-          implementedAt: null,
-          implementationThreadId: null,
-          createdAt: "2026-02-23T00:00:02.000Z",
-          updatedAt: "2026-02-23T00:00:03.000Z",
+          id: planId,
+          threadId,
+          runId,
+          nodeId,
+          kind: "proposed_plan",
+          markdown: "",
+          status: "completed",
+          detailInTurnItem: true,
         },
       ],
-      null,
-    );
-
-    expect(latestPlan?.planMarkdown).toBe("# Latest");
-  });
-});
+    });
 
-describe("hasActionableProposedPlan", () => {
-  it("returns true for an unimplemented proposed plan", () => {
-    expect(
-      hasActionableProposedPlan({
-        id: "plan-1",
-        turnId: TurnId.make("turn-1"),
-        planMarkdown: "# Plan",
-        implementedAt: null,
-        implementationThreadId: null,
-        createdAt: "2026-02-23T00:00:00.000Z",
-        updatedAt: "2026-02-23T00:00:01.000Z",
-      }),
-    ).toBe(true);
+    expect(entries[0]?.kind).toBe("proposed-plan");
+    if (entries[0]?.kind === "proposed-plan") {
+      expect(entries[0].proposedPlan.status).toBe("completed");
+      expect(entries[0].proposedPlan.planMarkdown).toBe("Finished plan");
+    }
+    expect(entries[1]?.kind).toBe("work");
+    if (entries[1]?.kind === "work") {
+      expect(entries[1].entry.detail).toBe(fileItem.newStr);
+    }
   });
 
-  it("returns false for a proposed plan already implemented elsewhere", () => {
-    expect(
-      hasActionableProposedPlan({
-        id: "plan-1",
-        turnId: TurnId.make("turn-1"),
-        planMarkdown: "# Plan",
-        implementedAt: "2026-02-23T00:00:02.000Z",
-        implementationThreadId: ThreadId.make("thread-implement"),
-        createdAt: "2026-02-23T00:00:00.000Z",
-        updatedAt: "2026-02-23T00:00:02.000Z",
+  it("resolves attempt identity through V2 execution nodes", () => {
+    const now = DateTime.makeUnsafe("2026-06-20T00:00:00.000Z");
+    const threadId = ThreadId.make("thread-attempts");
+    const runId = RunId.make("run-steered");
+    const supersededRootNodeId = NodeId.make("node-attempt-1-root");
+    const supersededChildNodeId = NodeId.make("node-attempt-1-child");
+    const activeRootNodeId = NodeId.make("node-attempt-2-root");
+    const supersededAttemptId = RunAttemptId.make("attempt-1");
+    const activeAttemptId = RunAttemptId.make("attempt-2");
+    const providerInstanceId = ProviderInstanceId.make("codex-default");
+    const providerThreadId = ProviderThreadId.make("provider-thread-attempts");
+    const attempts: ReadonlyArray<OrchestrationV2RunAttempt> = [
+      {
+        id: supersededAttemptId,
+        runId,
+        attemptOrdinal: 1,
+        rootNodeId: supersededRootNodeId,
+        providerInstanceId,
+        providerThreadId,
+        providerTurnId: null,
+        reason: "initial",
+        status: "superseded",
+        startedAt: now,
+        completedAt: now,
+      },
+      {
+        id: activeAttemptId,
+        runId,
+        attemptOrdinal: 2,
+        rootNodeId: activeRootNodeId,
+        providerInstanceId,
+        providerThreadId,
+        providerTurnId: null,
+        reason: "steering_restart",
+        status: "running",
+        startedAt: now,
+        completedAt: null,
+      },
+    ];
+    const node = (
+      id: OrchestrationV2ExecutionNode["id"],
+      rootNodeId: OrchestrationV2ExecutionNode["rootNodeId"],
+      parentNodeId: OrchestrationV2ExecutionNode["parentNodeId"],
+    ): OrchestrationV2ExecutionNode => ({
+      id,
+      threadId,
+      runId,
+      parentNodeId,
+      rootNodeId,
+      kind: id === rootNodeId ? "root_turn" : "assistant_message",
+      status: "running",
+      countsForRun: true,
+      providerThreadId,
+      providerTurnId: null,
+      nativeItemRef: null,
+      runtimeRequestId: null,
+      checkpointScopeId: null,
+      startedAt: now,
+      completedAt: null,
+    });
+    const nodes = [
+      node(supersededRootNodeId, supersededRootNodeId, null),
+      node(supersededChildNodeId, supersededRootNodeId, supersededRootNodeId),
+      node(activeRootNodeId, activeRootNodeId, null),
+    ];
+    const assistantItem = (
+      id: string,
+      messageId: string,
+      nodeId: NodeId,
+      text: string,
+      ordinal: number,
+    ): OrchestrationV2TurnItem => ({
+      id: TurnItemId.make(id),
+      threadId,
+      runId,
+      nodeId,
+      providerThreadId,
+      providerTurnId: null,
+      nativeItemRef: null,
+      parentItemId: null,
+      ordinal,
+      status: "running",
+      title: null,
+      startedAt: now,
+      completedAt: null,
+      updatedAt: now,
+      type: "assistant_message",
+      messageId: MessageId.make(messageId),
+      text,
+      streaming: true,
+    });
+    const items = [
+      assistantItem(
+        "item-superseded",
+        "message-superseded",
+        supersededChildNodeId,
+        "Partial old response",
+        0,
+      ),
+      assistantItem("item-active", "message-active", activeRootNodeId, "Current response", 1),
+    ];
+    const visibleTurnItems: ReadonlyArray<OrchestrationV2ProjectedTurnItem> = items.map(
+      (item, position) => ({
+        position,
+        visibility: "local",
+        sourceThreadId: threadId,
+        sourceItemId: item.id,
+        item,
       }),
-    ).toBe(false);
-  });
-});
-
-describe("workEntryIndicatesToolFailure", () => {
-  const base = {
-    id: "w1",
-    createdAt: "2026-01-01T00:00:00.000Z",
-    label: "Read",
-  };
+    );
 
-  it("is true for error tone", () => {
-    expect(
-      workEntryIndicatesToolFailure({
-        ...base,
-        tone: "error",
-        detail: "nothing special",
-      }),
-    ).toBe(true);
-  });
+    const entries = deriveTimelineEntriesFromVisibleTurnItems({
+      visibleTurnItems,
+      optimisticMessages: [],
+      attempts,
+      nodes,
+    });
 
-  it("is true when lifecycle says failed even if detail is empty", () => {
-    expect(
-      workEntryIndicatesToolFailure({
-        ...base,
-        tone: "tool",
-        toolLifecycleStatus: "failed",
-      }),
-    ).toBe(true);
+    expect(entries.map((entry) => [entry.attempt?.id, entry.attempt?.status])).toEqual([
+      [supersededAttemptId, "superseded"],
+      [activeAttemptId, "running"],
+    ]);
   });
+});
 
-  it("detects file-not-found style tool output with completed lifecycle", () => {
-    expect(
-      workEntryIndicatesToolFailure({
-        ...base,
-        tone: "tool",
-        toolLifecycleStatus: "completed",
-        detail: "File not found: C:\\foo\\nonexistent.ts",
-      }),
-    ).toBe(true);
-  });
+describe("work-log failure policy (#7999/#7893)", () => {
+  const toolEntry = (overrides: Record<string, unknown>) =>
+    ({
+      id: "entry-1",
+      createdAt: "2026-08-27T00:00:00.000Z",
+      label: "Ran command",
+      tone: "tool",
+      ...overrides,
+    }) as never;
 
-  it("detects glob no files and PowerShell command errors", () => {
+  it("flags success-status rows whose output text reports a failure", () => {
     expect(
-      workEntryIndicatesToolFailure({
-        ...base,
-        label: "Glob",
-        tone: "tool",
-        detail: "No files found",
-      }),
+      workEntryIndicatesToolFailure(
+        toolEntry({ toolLifecycleStatus: "completed", detail: "bash: foo: command not found" }),
+      ),
     ).toBe(true);
     expect(
-      workEntryIndicatesToolFailure({
-        ...base,
-        label: "Bash",
-        tone: "tool",
-        detail:
-          "The term 'this_is_not_a_command' is not recognized as the name of a cmdlet, function, script file, or operable program.",
-      }),
+      workEntryIndicatesToolFailure(
+        toolEntry({ toolLifecycleStatus: "completed", detail: "<exited with exit code 2>" }),
+      ),
     ).toBe(true);
   });
 
-  it("is false for successful completed tools", () => {
-    expect(
-      workEntryIndicatesToolFailure({
-        ...base,
-        tone: "tool",
-        toolLifecycleStatus: "completed",
-        detail: "Found 3 matching files",
-      }),
-    ).toBe(false);
-  });
-
-  it("treats successful tool rows as success candidates", () => {
-    expect(
-      workEntryIndicatesToolSuccess({
-        ...base,
-        tone: "tool",
-        toolLifecycleStatus: "completed",
-        detail: "ok",
-      }),
-    ).toBe(true);
-    expect(
-      workEntryIndicatesToolSuccess({
-        ...base,
-        tone: "tool",
-        toolLifecycleStatus: "inProgress",
-        detail: "…",
-      }),
-    ).toBe(false);
-    expect(workEntryIndicatesToolSuccess({ ...base, tone: "thinking", detail: "…" })).toBe(false);
-    expect(
-      workEntryIndicatesToolNeutralStatus({
-        ...base,
-        tone: "tool",
-        toolLifecycleStatus: "inProgress",
-        detail: "…",
-      }),
-    ).toBe(true);
-    expect(
-      workEntryIndicatesToolNeutralStatus({
-        ...base,
-        tone: "tool",
-        toolLifecycleStatus: "completed",
-        detail: "ok",
-      }),
-    ).toBe(false);
+  it("keeps the rendered row calm when only the command mentions failure text", () => {
+    const entry = toolEntry({
+      toolLifecycleStatus: "completed",
+      command: "rg 'command not found' src/",
+    });
+    expect(workEntryIndicatesToolFailure(entry)).toBe(true);
+    expect(workEntryDisplayIndicatesToolFailure(entry)).toBe(false);
   });
 
-  it("does not run heuristics on non-tool info rows", () => {
-    expect(
-      workEntryIndicatesToolFailure({
-        ...base,
-        label: "Context compacted",
-        tone: "info",
-        detail: "File not found in conversation",
-      }),
-    ).toBe(false);
+  it("does not call a clean completed row failed", () => {
+    const entry = toolEntry({ toolLifecycleStatus: "completed", detail: "3 files changed" });
+    expect(workEntryIndicatesToolFailure(entry)).toBe(false);
+    expect(workEntryIndicatesToolSuccess(entry)).toBe(true);
   });
-});
 
-describe("deriveWorkLogEntries", () => {
-  it("keeps the latest task progress without emitting plan-update log entries", () => {
-    const activities = [
-      makeActivity({ id: "before", kind: "tool.completed", summary: "Read files", sequence: 0 }),
-      makeActivity({
-        id: "plan-1",
-        kind: "turn.plan.updated",
-        summary: "Plan updated",
-        turnId: "turn-1",
-        sequence: 1,
-        payload: { plan: [{ step: "Verify the composer", status: "inProgress" }] },
-      }),
-      makeActivity({
-        id: "plan-2",
-        kind: "turn.plan.updated",
-        summary: "Plan updated",
-        turnId: "turn-1",
-        sequence: 2,
-        payload: { plan: [{ step: "Verify the composer", status: "completed" }] },
-      }),
-      makeActivity({ id: "after", kind: "tool.completed", summary: "Ran tests", sequence: 3 }),
-    ];
-    expect(deriveWorkLogEntries(activities).map((entry) => entry.id)).toEqual(["before", "after"]);
-    expect(deriveTurnPlans(activities)).toHaveLength(1);
-    expect(deriveTurnPlans(activities)[0]?.plan.steps).toMatchObject([
-      { step: "Verify the composer", status: "completed" },
-    ]);
-  });
-
-  it("omits tool started entries and keeps completed entries", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "tool-complete",
-        createdAt: "2026-02-23T00:00:03.000Z",
-        summary: "Tool call complete",
-        kind: "tool.completed",
-      }),
-      makeActivity({
-        id: "tool-start",
-        createdAt: "2026-02-23T00:00:02.000Z",
-        summary: "Tool call",
-        kind: "tool.started",
-      }),
-    ];
-
-    const entries = deriveWorkLogEntries(activities);
-    expect(entries.map((entry) => entry.id)).toEqual(["tool-complete"]);
-  });
-
-  it("drops runtime warnings with no displayable content, keeps ones with a preview", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "warning-noise",
-        createdAt: "2026-02-23T00:00:01.000Z",
-        kind: "runtime.warning",
-        summary: "Claude system message 'background_tasks_changed' (no displayable text content)",
-        tone: "info",
-      }),
-      makeActivity({
-        id: "warning-signal",
-        createdAt: "2026-02-23T00:00:02.000Z",
-        kind: "runtime.warning",
-        summary: "Reconnecting... 2/5",
-        tone: "info",
-      }),
-    ];
-
-    const entries = deriveWorkLogEntries(activities);
-    expect(entries.map((entry) => entry.id)).toEqual(["warning-signal"]);
-  });
-
-  it("omits task.started but shows task.progress and task.completed", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "task-start",
-        createdAt: "2026-02-23T00:00:01.000Z",
-        kind: "task.started",
-        summary: "default task started",
-        tone: "info",
-      }),
-      makeActivity({
-        id: "task-progress",
-        createdAt: "2026-02-23T00:00:02.000Z",
-        kind: "task.progress",
-        summary: "Updating files",
-        tone: "info",
-      }),
-      makeActivity({
-        id: "task-complete",
-        createdAt: "2026-02-23T00:00:03.000Z",
-        kind: "task.completed",
-        summary: "Task completed",
-        tone: "info",
-      }),
-    ];
-
-    const entries = deriveWorkLogEntries(activities);
-    expect(entries.map((entry) => entry.id)).toEqual(["task-progress", "task-complete"]);
-  });
-
-  it("uses payload summary as label for task entries when available", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "task-progress-with-summary",
-        createdAt: "2026-02-23T00:00:02.000Z",
-        kind: "task.progress",
-        summary: "Reasoning update",
-        tone: "info",
-        payload: { summary: "Searching for API endpoints" },
-      }),
-    ];
-
-    const entries = deriveWorkLogEntries(activities);
-    expect(entries[0]?.label).toBe("Searching for API endpoints");
-  });
-
-  it("uses payload detail as label for task.completed and preserves error tone", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "task-completed-failed",
-        createdAt: "2026-02-23T00:00:03.000Z",
-        kind: "task.completed",
-        summary: "Task failed",
-        tone: "error",
-        payload: { detail: "Failed to deploy changes" },
-      }),
-    ];
-
-    const entries = deriveWorkLogEntries(activities);
-    expect(entries[0]?.label).toBe("Failed to deploy changes");
-    expect(entries[0]?.tone).toBe("error");
-  });
-
-  it("keeps tool entries from every turn and tags each with its turn id", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "turn-1-tool",
-        turnId: "turn-1",
-        summary: "Tool call complete",
-        kind: "tool.completed",
-      }),
-      makeActivity({
-        id: "turn-2-tool",
-        turnId: "turn-2",
-        summary: "Tool call complete",
-        kind: "tool.completed",
-      }),
-    ];
-
-    const entries = deriveWorkLogEntries(activities);
-    expect(entries.map((entry) => entry.id)).toEqual(["turn-1-tool", "turn-2-tool"]);
-    expect(entries.map((entry) => entry.turnId)).toEqual([
-      TurnId.make("turn-1"),
-      TurnId.make("turn-2"),
-    ]);
-  });
-
-  it("omits checkpoint captured info entries", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "checkpoint",
-        createdAt: "2026-02-23T00:00:01.000Z",
-        summary: "Checkpoint captured",
-        tone: "info",
-      }),
-      makeActivity({
-        id: "tool-complete",
-        createdAt: "2026-02-23T00:00:02.000Z",
-        summary: "Ran command",
-        tone: "tool",
-        kind: "tool.completed",
-      }),
-    ];
-
-    const entries = deriveWorkLogEntries(activities);
-    expect(entries.map((entry) => entry.id)).toEqual(["tool-complete"]);
-  });
-
-  it("omits ExitPlanMode lifecycle entries once the plan card is shown", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "exit-plan-updated",
-        createdAt: "2026-02-23T00:00:01.000Z",
-        kind: "tool.updated",
-        summary: "Tool call",
-        payload: {
-          detail: 'ExitPlanMode: {"allowedPrompts":[{"tool":"Bash","prompt":"run tests"}]}',
-        },
-      }),
-      makeActivity({
-        id: "exit-plan-completed",
-        createdAt: "2026-02-23T00:00:02.000Z",
-        kind: "tool.completed",
-        summary: "Tool call",
-        payload: {
-          detail: "ExitPlanMode: {}",
-        },
-      }),
-      makeActivity({
-        id: "real-work-log",
-        createdAt: "2026-02-23T00:00:03.000Z",
-        kind: "tool.completed",
-        summary: "Ran command",
-        payload: {
-          itemType: "command_execution",
-          detail: "Bash: bun test",
-        },
-      }),
-    ];
-
-    const entries = deriveWorkLogEntries(activities);
-    expect(entries.map((entry) => entry.id)).toEqual(["real-work-log"]);
-  });
-
-  it("orders work log by activity sequence when present", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "second",
-        createdAt: "2026-02-23T00:00:03.000Z",
-        sequence: 2,
-        summary: "Tool call complete",
-        kind: "tool.completed",
-      }),
-      makeActivity({
-        id: "first",
-        createdAt: "2026-02-23T00:00:04.000Z",
-        sequence: 1,
-        summary: "Tool call complete",
-        kind: "tool.completed",
-      }),
-    ];
-
-    const entries = deriveWorkLogEntries(activities);
-    expect(entries.map((entry) => entry.id)).toEqual(["first", "second"]);
-  });
-
-  it("extracts command text for command tool activities", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "command-tool",
-        kind: "tool.completed",
-        summary: "Ran command",
-        payload: {
-          itemType: "command_execution",
-          data: {
-            item: {
-              command: ["bun", "run", "lint"],
-            },
-          },
-        },
-      }),
-    ];
-
-    const [entry] = deriveWorkLogEntries(activities);
-    expect(entry?.command).toBe("bun run lint");
-  });
-
-  it("extracts failed tool lifecycle status from item payloads", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "tool-failed",
-        kind: "tool.updated",
-        summary: "Glob",
-        tone: "tool",
-        payload: {
-          itemType: "mcp_tool_call",
-          status: "failed",
-          detail: "No files found",
-        },
-      }),
-    ];
-
-    const [entry] = deriveWorkLogEntries(activities);
-    expect(entry?.toolLifecycleStatus).toBe("failed");
-  });
-
-  it("defaults tool.completed entries to completed lifecycle status", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "tool-done",
-        kind: "tool.completed",
-        summary: "Glob",
-        tone: "tool",
-        payload: {
-          itemType: "mcp_tool_call",
-          detail: "Found 3 files",
-        },
-      }),
-    ];
-
-    const [entry] = deriveWorkLogEntries(activities);
-    expect(entry?.toolLifecycleStatus).toBe("completed");
-  });
-
-  it("preserves MCP server, tool, arguments, and results for expanded display", () => {
-    const item = {
-      type: "mcpToolCall",
-      server: "t3-code",
-      tool: "preview_status",
-      arguments: {},
-      status: "completed",
-      result: { content: [{ type: "text", text: "attached" }] },
-    };
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "mcp-tool-done",
-        kind: "tool.completed",
-        summary: "t3-code · preview_status",
-        payload: {
-          itemType: "mcp_tool_call",
-          title: "t3-code · preview_status",
-          data: { item },
-        },
-      }),
-    ];
-
-    const [entry] = deriveWorkLogEntries(activities);
-    expect(entry?.toolTitle).toBe("t3-code · preview_status");
-    expect(entry?.toolData).toEqual(item);
-  });
-
-  it("keeps MCP payloads while collapsing lifecycle updates", () => {
-    const item = {
-      type: "mcpToolCall",
-      server: "t3-code",
-      tool: "preview_snapshot",
-      arguments: { interactiveOnly: true },
-      status: "completed",
-    };
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "mcp-tool-progress",
-        kind: "tool.updated",
-        summary: "t3-code · preview_snapshot",
-        payload: {
-          itemType: "mcp_tool_call",
-          toolCallId: "call-1",
-          data: { item },
-        },
-      }),
-      makeActivity({
-        id: "mcp-tool-complete",
-        kind: "tool.completed",
-        summary: "t3-code · preview_snapshot",
-        payload: {
-          itemType: "mcp_tool_call",
-          toolCallId: "call-1",
-        },
-      }),
-    ];
-
-    const [entry] = deriveWorkLogEntries(activities);
-    expect(entry?.toolData).toEqual(item);
-    expect(entry?.toolCallId).toBe("call-1");
-  });
-
-  it("collapses interleaved lifecycle updates by tool call id", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "tool-a-progress",
-        createdAt: "2026-02-23T00:00:01.000Z",
-        turnId: "turn-1",
-        kind: "tool.updated",
-        summary: "Tool A",
-        payload: {
-          itemType: "command_execution",
-          toolCallId: "call-a",
-          status: "inProgress",
-          data: { command: "vp test run" },
-        },
-      }),
-      makeActivity({
-        id: "tool-b-progress",
-        createdAt: "2026-02-23T00:00:02.000Z",
-        turnId: "turn-1",
-        kind: "tool.updated",
-        summary: "Tool B",
-        payload: {
-          itemType: "command_execution",
-          toolCallId: "call-b",
-          status: "inProgress",
-          data: { command: "vp lint" },
-        },
-      }),
-      makeActivity({
-        id: "tool-a-complete",
-        createdAt: "2026-02-23T00:00:03.000Z",
-        turnId: "turn-1",
-        kind: "tool.completed",
-        summary: "Tool A completed",
-        payload: {
-          itemType: "command_execution",
-          toolCallId: "call-a",
-          status: "completed",
-        },
-      }),
-      makeActivity({
-        id: "tool-b-complete",
-        createdAt: "2026-02-23T00:00:04.000Z",
-        turnId: "turn-1",
-        kind: "tool.completed",
-        summary: "Tool B completed",
-        payload: {
-          itemType: "command_execution",
-          toolCallId: "call-b",
-          status: "completed",
-        },
-      }),
-    ];
-
-    expect(deriveWorkLogEntries(activities)).toMatchObject([
-      {
-        id: "tool-a-complete",
-        command: "vp test run",
-        toolCallId: "call-a",
-        toolLifecycleStatus: "completed",
-      },
-      {
-        id: "tool-b-complete",
-        command: "vp lint",
-        toolCallId: "call-b",
-        toolLifecycleStatus: "completed",
-      },
-    ]);
-  });
-
-  it("does not merge reused tool call ids across turns", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "turn-1-tool",
-        createdAt: "2026-02-23T00:00:01.000Z",
-        turnId: "turn-1",
-        kind: "tool.updated",
-        summary: "Tool",
-        payload: {
-          itemType: "command_execution",
-          toolCallId: "reused-call",
-          status: "inProgress",
-        },
-      }),
-      makeActivity({
-        id: "turn-2-tool",
-        createdAt: "2026-02-23T00:00:02.000Z",
-        turnId: "turn-2",
-        kind: "tool.completed",
-        summary: "Tool completed",
-        payload: {
-          itemType: "command_execution",
-          toolCallId: "reused-call",
-          status: "completed",
-        },
-      }),
-    ];
-
-    expect(deriveWorkLogEntries(activities)).toHaveLength(2);
-  });
-
-  it("unwraps PowerShell command wrappers for displayed command text", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "command-tool-windows-wrapper",
-        kind: "tool.completed",
-        summary: "Ran command",
-        payload: {
-          itemType: "command_execution",
-          data: {
-            item: {
-              command: "\"C:\\Program Files\\PowerShell\\7\\pwsh.exe\" -Command 'bun run lint'",
-            },
-          },
-        },
-      }),
-    ];
-
-    const [entry] = deriveWorkLogEntries(activities);
-    expect(entry?.command).toBe("bun run lint");
-    expect(entry?.rawCommand).toBe(
-      "\"C:\\Program Files\\PowerShell\\7\\pwsh.exe\" -Command 'bun run lint'",
-    );
-  });
-
-  it("unwraps PowerShell command wrappers from argv-style command payloads", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "command-tool-windows-wrapper-argv",
-        kind: "tool.completed",
-        summary: "Ran command",
-        payload: {
-          itemType: "command_execution",
-          data: {
-            item: {
-              command: ["C:\\Program Files\\PowerShell\\7\\pwsh.exe", "-Command", "rg -n foo ."],
-            },
-          },
-        },
-      }),
-    ];
-
-    const [entry] = deriveWorkLogEntries(activities);
-    expect(entry?.command).toBe("rg -n foo .");
-    expect(entry?.rawCommand).toBe(
-      '"C:\\Program Files\\PowerShell\\7\\pwsh.exe" -Command "rg -n foo ."',
-    );
-  });
-
-  it("extracts command text from command detail when structured command metadata is missing", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "command-tool-windows-detail-fallback",
-        kind: "tool.completed",
-        summary: "Ran command",
-        payload: {
-          itemType: "command_execution",
-          detail:
-            '"C:\\Program Files\\PowerShell\\7\\pwsh.exe" -NoLogo -NoProfile -Command \'rg -n -F "new Date()" .\' <exited with exit code 0>',
-        },
-      }),
-    ];
-
-    const [entry] = deriveWorkLogEntries(activities);
-    expect(entry?.command).toBe('rg -n -F "new Date()" .');
-    expect(entry?.rawCommand).toBe(
-      `"C:\\Program Files\\PowerShell\\7\\pwsh.exe" -NoLogo -NoProfile -Command 'rg -n -F "new Date()" .'`,
-    );
-  });
-
-  it("does not unwrap shell commands when no wrapper flag is present", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "command-tool-shell-script",
-        kind: "tool.completed",
-        summary: "Ran command",
-        payload: {
-          itemType: "command_execution",
-          data: {
-            item: {
-              command: "bash script.sh",
-            },
-          },
-        },
-      }),
-    ];
-
-    const [entry] = deriveWorkLogEntries(activities);
-    expect(entry?.command).toBe("bash script.sh");
-    expect(entry?.rawCommand).toBeUndefined();
-  });
-
-  it("keeps compact Codex tool metadata used for icons and labels", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "tool-with-metadata",
-        kind: "tool.completed",
-        summary: "bash",
-        payload: {
-          itemType: "command_execution",
-          title: "bash",
-          status: "completed",
-          detail: '{ "dev": "vite dev --port 3000" } <exited with exit code 0>',
-          data: {
-            item: {
-              command: ["bun", "run", "dev"],
-              result: {
-                content: '{ "dev": "vite dev --port 3000" } <exited with exit code 0>',
-                exitCode: 0,
-              },
-            },
-          },
-        },
-      }),
-    ];
-
-    const [entry] = deriveWorkLogEntries(activities);
-    expect(entry).toMatchObject({
-      command: "bun run dev",
-      detail: '{ "dev": "vite dev --port 3000" }',
-      itemType: "command_execution",
-      toolTitle: "bash",
-    });
-  });
-
-  it("extracts changed file paths for file-change tool activities", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "file-tool",
-        kind: "tool.completed",
-        summary: "File change",
-        payload: {
-          itemType: "file_change",
-          data: {
-            item: {
-              changes: [
-                { path: "apps/web/src/components/ChatView.tsx" },
-                { filename: "apps/web/src/session-logic.ts" },
-              ],
-            },
-          },
-        },
-      }),
-    ];
-
-    const [entry] = deriveWorkLogEntries(activities);
-    expect(entry?.changedFiles).toEqual([
-      "apps/web/src/components/ChatView.tsx",
-      "apps/web/src/session-logic.ts",
-    ]);
-  });
-
-  it("drops duplicated tool detail when it only repeats the title", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "read-file-generic",
-        kind: "tool.completed",
-        summary: "Read File",
-        payload: {
-          itemType: "dynamic_tool_call",
-          title: "Read File",
-          detail: "Read File",
-        },
-      }),
-    ];
-
-    const [entry] = deriveWorkLogEntries(activities);
-    expect(entry?.toolTitle).toBe("Read File");
-    expect(entry?.detail).toBeUndefined();
-  });
-
-  it("uses grep raw output summaries instead of repeating the generic tool label", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "grep-update",
-        createdAt: "2026-02-23T00:00:01.000Z",
-        kind: "tool.updated",
-        summary: "grep",
-        payload: {
-          itemType: "web_search",
-          title: "grep",
-          detail: "grep",
-          data: {
-            toolCallId: "tool-grep-1",
-            kind: "search",
-            rawInput: {},
-          },
-        },
-      }),
-      makeActivity({
-        id: "grep-complete",
-        createdAt: "2026-02-23T00:00:02.000Z",
-        kind: "tool.completed",
-        summary: "grep",
-        payload: {
-          itemType: "web_search",
-          title: "grep",
-          detail: "grep",
-          data: {
-            toolCallId: "tool-grep-1",
-            kind: "search",
-            rawOutput: {
-              totalFiles: 19,
-              truncated: false,
-            },
-          },
-        },
-      }),
-    ];
-
-    const entries = deriveWorkLogEntries(activities);
-    expect(entries).toHaveLength(1);
-    expect(entries[0]).toMatchObject({
-      id: "grep-complete",
-      toolTitle: "grep",
-      detail: "19 files",
-      itemType: "web_search",
-    });
-  });
-
-  it("uses completed read-file output previews and still collapses the same tool call", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "read-update",
-        createdAt: "2026-02-23T00:00:01.000Z",
-        kind: "tool.updated",
-        summary: "Read File",
-        payload: {
-          itemType: "dynamic_tool_call",
-          title: "Read File",
-          detail: "Read File",
-          data: {
-            toolCallId: "tool-read-1",
-            kind: "read",
-            rawInput: {},
-          },
-        },
-      }),
-      makeActivity({
-        id: "read-complete",
-        createdAt: "2026-02-23T00:00:02.000Z",
-        kind: "tool.completed",
-        summary: "Read File",
-        payload: {
-          itemType: "dynamic_tool_call",
-          title: "Read File",
-          detail: "Read File",
-          data: {
-            toolCallId: "tool-read-1",
-            kind: "read",
-            rawOutput: {
-              content:
-                'import * as Effect from "effect/Effect"\nimport * as Layer from "effect/Layer"\n',
-            },
-          },
-        },
-      }),
-    ];
-
-    const entries = deriveWorkLogEntries(activities);
-    expect(entries).toHaveLength(1);
-    expect(entries[0]).toMatchObject({
-      id: "read-complete",
-      toolTitle: "Read File",
-      detail: 'import * as Effect from "effect/Effect"',
-      itemType: "dynamic_tool_call",
-    });
-  });
-
-  it("does not use command stdout as the detail when Cursor omits the command input", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "cursor-command-complete",
-        createdAt: "2026-04-16T22:40:42.221Z",
-        kind: "tool.completed",
-        summary: "Ran command",
-        payload: {
-          itemType: "command_execution",
-          title: "Ran command",
-          data: {
-            toolCallId: "toolu_vrtx_01WypXgRM8PPygBtrVAZwzy5",
-            kind: "execute",
-            rawInput: {},
-            rawOutput: {
-              exitCode: 0,
-              stdout: "total 960\napps\npackages\n",
-              stderr: "",
-            },
-          },
-        },
-      }),
-    ];
-
-    const [entry] = deriveWorkLogEntries(activities);
-    expect(entry).toMatchObject({
-      id: "cursor-command-complete",
-      label: "Ran command",
-      itemType: "command_execution",
-      toolTitle: "Ran command",
-    });
-    expect(entry?.detail).toBeUndefined();
-    expect(entry?.command).toBeUndefined();
-  });
-
-  it("collapses legacy completed tool rows that are missing tool metadata", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "legacy-read-update",
-        createdAt: "2026-02-23T00:00:01.000Z",
-        kind: "tool.updated",
-        summary: "Read File",
-        payload: {
-          itemType: "dynamic_tool_call",
-          title: "Read File",
-          detail: "Read File",
-          data: {
-            toolCallId: "tool-read-legacy",
-            kind: "read",
-            rawInput: {},
-          },
-        },
-      }),
-      makeActivity({
-        id: "legacy-read-complete",
-        createdAt: "2026-02-23T00:00:02.000Z",
-        kind: "tool.completed",
-        summary: "Read File",
-        payload: {
-          itemType: "dynamic_tool_call",
-          title: "Read File",
-          detail: "Read File",
-        },
-      }),
-    ];
-
-    const entries = deriveWorkLogEntries(activities);
-    expect(entries).toHaveLength(1);
-    expect(entries[0]).toMatchObject({
-      id: "legacy-read-complete",
-      toolTitle: "Read File",
-      itemType: "dynamic_tool_call",
-    });
-    expect(entries[0]?.detail).toBeUndefined();
-  });
-
-  it("collapses repeated lifecycle updates for the same tool call into one entry", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "tool-update-1",
-        createdAt: "2026-02-23T00:00:01.000Z",
-        kind: "tool.updated",
-        summary: "Tool call",
-        payload: {
-          itemType: "dynamic_tool_call",
-          title: "Tool call",
-          detail: 'Read: {"file_path":"/tmp/app.ts"}',
-        },
-      }),
-      makeActivity({
-        id: "tool-update-2",
-        createdAt: "2026-02-23T00:00:02.000Z",
-        kind: "tool.updated",
-        summary: "Tool call",
-        payload: {
-          itemType: "dynamic_tool_call",
-          title: "Tool call",
-          detail: 'Read: {"file_path":"/tmp/app.ts"}',
-          data: {
-            item: {
-              command: ["sed", "-n", "1,40p", "/tmp/app.ts"],
-            },
-          },
-        },
-      }),
-      makeActivity({
-        id: "tool-complete",
-        createdAt: "2026-02-23T00:00:03.000Z",
-        kind: "tool.completed",
-        summary: "Tool call completed",
-        payload: {
-          itemType: "dynamic_tool_call",
-          title: "Tool call",
-          detail: 'Read: {"file_path":"/tmp/app.ts"}',
-        },
-      }),
-    ];
-
-    const entries = deriveWorkLogEntries(activities);
-
-    expect(entries).toHaveLength(1);
-    expect(entries[0]).toMatchObject({
-      id: "tool-complete",
-      createdAt: "2026-02-23T00:00:03.000Z",
-      label: "Tool call completed",
-      detail: 'Read: {"file_path":"/tmp/app.ts"}',
-      command: "sed -n 1,40p /tmp/app.ts",
-      itemType: "dynamic_tool_call",
-      toolTitle: "Tool call",
-    });
-  });
-
-  it("keeps separate tool entries when an identical call starts after the prior one completed", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "tool-1-update",
-        createdAt: "2026-02-23T00:00:01.000Z",
-        kind: "tool.updated",
-        summary: "Tool call",
-        payload: {
-          itemType: "dynamic_tool_call",
-          title: "Tool call",
-          detail: 'Read: {"file_path":"/tmp/app.ts"}',
-        },
-      }),
-      makeActivity({
-        id: "tool-1-complete",
-        createdAt: "2026-02-23T00:00:02.000Z",
-        kind: "tool.completed",
-        summary: "Tool call completed",
-        payload: {
-          itemType: "dynamic_tool_call",
-          title: "Tool call",
-          detail: 'Read: {"file_path":"/tmp/app.ts"}',
-        },
-      }),
-      makeActivity({
-        id: "tool-2-update",
-        createdAt: "2026-02-23T00:00:03.000Z",
-        kind: "tool.updated",
-        summary: "Tool call",
-        payload: {
-          itemType: "dynamic_tool_call",
-          title: "Tool call",
-          detail: 'Read: {"file_path":"/tmp/app.ts"}',
-        },
-      }),
-      makeActivity({
-        id: "tool-2-complete",
-        createdAt: "2026-02-23T00:00:04.000Z",
-        kind: "tool.completed",
-        summary: "Tool call completed",
-        payload: {
-          itemType: "dynamic_tool_call",
-          title: "Tool call",
-          detail: 'Read: {"file_path":"/tmp/app.ts"}',
-        },
-      }),
-    ];
-
-    const entries = deriveWorkLogEntries(activities);
-
-    expect(entries.map((entry) => entry.id)).toEqual(["tool-1-complete", "tool-2-complete"]);
-  });
-
-  it("collapses same-timestamp lifecycle rows even when completed sorts before updated by id", () => {
-    const activities: OrchestrationThreadActivity[] = [
-      makeActivity({
-        id: "z-update-earlier",
-        createdAt: "2026-02-23T00:00:01.000Z",
-        kind: "tool.updated",
-        summary: "Tool call",
-        payload: {
-          itemType: "dynamic_tool_call",
-          title: "Tool call",
-          detail: 'Read: {"file_path":"/tmp/app.ts"}',
-        },
-      }),
-      makeActivity({
-        id: "a-complete-same-timestamp",
-        createdAt: "2026-02-23T00:00:02.000Z",
-        kind: "tool.completed",
-        summary: "Tool call",
-        payload: {
-          itemType: "dynamic_tool_call",
-          title: "Tool call",
-          detail: 'Read: {"file_path":"/tmp/app.ts"}',
-        },
-      }),
-      makeActivity({
-        id: "z-update-same-timestamp",
-        createdAt: "2026-02-23T00:00:02.000Z",
-        kind: "tool.updated",
-        summary: "Tool call",
-        payload: {
-          itemType: "dynamic_tool_call",
-          title: "Tool call",
-          detail: 'Read: {"file_path":"/tmp/app.ts"}',
-        },
-      }),
-    ];
-
-    const entries = deriveWorkLogEntries(activities);
-
-    expect(entries).toHaveLength(1);
-    expect(entries[0]?.id).toBe("a-complete-same-timestamp");
-  });
-});
-
-describe("deriveTimelineEntries", () => {
-  it("includes proposed plans alongside messages and work entries in chronological order", () => {
-    const entries = deriveTimelineEntries(
-      [
-        {
-          id: MessageId.make("message-1"),
-          role: "assistant",
-          text: "hello",
-          createdAt: "2026-02-23T00:00:01.000Z",
-          turnId: null,
-          updatedAt: "2026-02-23T00:00:01.000Z",
-          streaming: false,
-        },
-      ],
-      [
-        {
-          id: "plan:thread-1:turn:turn-1",
-          turnId: TurnId.make("turn-1"),
-          planMarkdown: "# Ship it",
-          implementedAt: null,
-          implementationThreadId: null,
-          createdAt: "2026-02-23T00:00:02.000Z",
-          updatedAt: "2026-02-23T00:00:02.000Z",
-        },
-      ],
-      [
-        {
-          id: "work-1",
-          createdAt: "2026-02-23T00:00:03.000Z",
-          label: "Ran tests",
-          tone: "tool",
-        },
-      ],
-    );
-
-    expect(entries.map((entry) => entry.kind)).toEqual(["message", "proposed-plan", "work"]);
-    expect(entries[1]).toMatchObject({
-      kind: "proposed-plan",
-      proposedPlan: {
-        planMarkdown: "# Ship it",
-        implementedAt: null,
-        implementationThreadId: null,
-      },
-    });
-  });
-});
-
-describe("deriveWorkLogEntries context window handling", () => {
-  it("excludes context window updates from the work log", () => {
-    const entries = deriveWorkLogEntries([
-      makeActivity({
-        id: "context-1",
-        turnId: "turn-1",
-        kind: "context-window.updated",
-        summary: "Context window updated",
-        tone: "info",
-      }),
-      makeActivity({
-        id: "tool-1",
-        turnId: "turn-1",
-        kind: "tool.completed",
-        summary: "Ran command",
-        tone: "tool",
-      }),
-    ]);
-
-    expect(entries).toHaveLength(1);
-    expect(entries[0]?.label).toBe("Ran command");
-  });
-
-  it("keeps context compaction activities as normal work log entries", () => {
-    const entries = deriveWorkLogEntries([
-      makeActivity({
-        id: "compaction-1",
-        turnId: "turn-1",
-        kind: "context-compaction",
-        summary: "Context compacted",
-        tone: "info",
-      }),
-    ]);
-
-    expect(entries).toHaveLength(1);
-    expect(entries[0]?.label).toBe("Context compacted");
-  });
-});
-
-describe("isLatestTurnSettled", () => {
-  const latestTurn = {
-    turnId: TurnId.make("turn-1"),
-    startedAt: "2026-02-27T21:10:00.000Z",
-    completedAt: "2026-02-27T21:10:06.000Z",
-  } as const;
-
-  it("returns false while the same turn is still active in a running session", () => {
-    expect(
-      isLatestTurnSettled(latestTurn, {
-        status: "running",
-        activeTurnId: TurnId.make("turn-1"),
-      }),
-    ).toBe(false);
-  });
-
-  it("returns false while any turn is running to avoid stale latest-turn banners", () => {
-    expect(
-      isLatestTurnSettled(latestTurn, {
-        status: "running",
-        activeTurnId: TurnId.make("turn-2"),
-      }),
-    ).toBe(false);
-  });
-
-  it("returns true once the session is no longer running that turn", () => {
-    expect(
-      isLatestTurnSettled(latestTurn, {
-        status: "ready",
-        activeTurnId: null,
-      }),
-    ).toBe(true);
-  });
-
-  it("returns false when turn timestamps are incomplete", () => {
-    expect(
-      isLatestTurnSettled(
-        {
-          turnId: TurnId.make("turn-1"),
-          startedAt: null,
-          completedAt: "2026-02-27T21:10:06.000Z",
-        },
-        null,
-      ),
-    ).toBe(false);
-  });
-});
-
-describe("deriveActiveWorkStartedAt", () => {
-  const latestTurn = {
-    turnId: TurnId.make("turn-1"),
-    startedAt: "2026-02-27T21:10:00.000Z",
-    completedAt: "2026-02-27T21:10:06.000Z",
-  } as const;
-
-  it("prefers the in-flight turn start when the latest turn is not settled", () => {
-    expect(
-      deriveActiveWorkStartedAt(
-        latestTurn,
-        {
-          status: "running",
-          activeTurnId: TurnId.make("turn-1"),
-        },
-        "2026-02-27T21:11:00.000Z",
-      ),
-    ).toBe("2026-02-27T21:10:00.000Z");
-  });
-
-  it("uses the new send start while the session is running a different turn", () => {
-    expect(
-      deriveActiveWorkStartedAt(
-        latestTurn,
-        {
-          status: "running",
-          activeTurnId: TurnId.make("turn-2"),
-        },
-        "2026-02-27T21:11:00.000Z",
-      ),
-    ).toBe("2026-02-27T21:11:00.000Z");
-  });
-
-  it("falls back to the latest user message while a running turn is being acknowledged", () => {
-    expect(
-      deriveActiveWorkStartedAt(
-        latestTurn,
-        {
-          status: "running",
-          activeTurnId: TurnId.make("turn-2"),
-        },
-        null,
-        "2026-02-27T21:11:00.000Z",
-      ),
-    ).toBe("2026-02-27T21:11:00.000Z");
-  });
-
-  it("falls back to sendStartedAt once the latest turn is settled", () => {
-    expect(
-      deriveActiveWorkStartedAt(
-        latestTurn,
-        {
-          status: "ready",
-          activeTurnId: null,
-        },
-        "2026-02-27T21:11:00.000Z",
-      ),
-    ).toBe("2026-02-27T21:11:00.000Z");
-  });
-
-  it("uses sendStartedAt for a fresh send after the prior turn completed", () => {
-    expect(
-      deriveActiveWorkStartedAt(
-        {
-          turnId: TurnId.make("turn-1"),
-          startedAt: "2026-02-27T21:10:00.000Z",
-          completedAt: "2026-02-27T21:10:06.000Z",
-        },
-        null,
-        "2026-02-27T21:11:00.000Z",
-      ),
-    ).toBe("2026-02-27T21:11:00.000Z");
-  });
-});
-
-describe("deriveWorkLogEntries quiet-timeline guarantee", () => {
-  it("N concurrent subagents produce exactly N lifecycle rows, zero attributed tool rows", () => {
-    const activities: OrchestrationThreadActivity[] = [];
-    for (let agent = 0; agent < 5; agent += 1) {
-      const taskId = `task-${agent}`;
-      // Progress ticks (several per agent) + attributed tool rows.
-      for (let tick = 0; tick < 4; tick += 1) {
-        activities.push(
-          makeActivity({
-            kind: "task.progress",
-            summary: `agent ${agent} tick ${tick}`,
-            tone: "info",
-            payload: { taskId, summary: `working ${tick}`, role: "explorer" },
-            turnId: "turn-batch",
-            sequence: agent * 20 + tick,
-          }),
-        );
-        activities.push(
-          makeActivity({
-            kind: "tool.completed",
-            summary: "Read",
-            payload: { itemType: "dynamic_tool_call", agentId: taskId },
-            sequence: agent * 20 + 10 + tick,
-          }),
-        );
-      }
-      activities.push(
-        makeActivity({
-          kind: "task.completed",
-          summary: "Task completed",
-          tone: "info",
-          payload: {
-            taskId,
-            status: "completed",
-            summary: `agent ${agent} done`,
-            role: "explorer",
-          },
-          turnId: "turn-batch",
-          sequence: agent * 20 + 19,
-        }),
-      );
-    }
-
-    const entries = deriveWorkLogEntries(activities);
-    // A1 CTA design: all direct spawns in one turn collapse into ONE
-    // call-to-action row carrying the batch's agent ids.
-    const spawnRows = entries.filter((entry) => entry.agentSpawn !== undefined);
-    expect(spawnRows).toHaveLength(1);
-    expect(spawnRows[0]!.agentSpawn!.agentTaskIds).toHaveLength(5);
-    expect(spawnRows[0]!.agentSpawn!.workflowId).toBeNull();
-    // No agent-attributed tool rows leak into the main log.
-    expect(entries.some((entry) => entry.sourceActivityKind?.startsWith("tool."))).toBe(false);
-  });
-
-  it("a workflow run and its members collapse into one CTA row keyed to the coordinator", () => {
-    const entries = deriveWorkLogEntries([
-      makeActivity({
-        kind: "task.progress",
-        summary: "coordinator",
-        tone: "info",
-        payload: { taskId: "wf-1", taskType: "local_workflow", workflowName: "math-check" },
-        sequence: 1,
-      }),
-      makeActivity({
-        kind: "task.progress",
-        summary: "member",
-        tone: "info",
-        payload: { taskId: "wf-1:wf:0", status: "running", parentAgentId: "wf-1" },
-        sequence: 2,
-      }),
-      makeActivity({
-        kind: "task.completed",
-        summary: "member done",
-        tone: "info",
-        payload: { taskId: "wf-1:wf:1", status: "completed", parentAgentId: "wf-1" },
-        sequence: 3,
-      }),
-    ]);
-    const spawnRows = entries.filter((entry) => entry.agentSpawn !== undefined);
-    expect(spawnRows).toHaveLength(1);
-    expect(spawnRows[0]!.agentSpawn!.workflowId).toBe("wf-1");
-    expect(spawnRows[0]!.agentSpawn!.agentTaskIds).toEqual(
-      expect.arrayContaining(["wf-1", "wf-1:wf:0", "wf-1:wf:1"]),
-    );
-  });
-
-  it("keeps unattributed tool rows (over-hiding loses the only signal)", () => {
-    const entries = deriveWorkLogEntries([
-      makeActivity({
-        kind: "tool.completed",
-        summary: "Bash",
-        payload: { itemType: "command_execution", command: "ls" },
-      }),
-    ]);
-    expect(entries).toHaveLength(1);
-  });
-
-  it("folds timelineBypass agent rows into one CTA (Codex children, workflow members)", () => {
-    // Codex children carry their parent's spawn turn (spawnTurnId stamping),
-    // which is what batches a fleet into one CTA.
-    const entries = deriveWorkLogEntries([
-      makeActivity({
-        kind: "task.progress",
-        summary: "child work",
-        tone: "info",
-        payload: { taskId: "child-1", timelineBypass: true },
-        turnId: "turn-spawn",
-      }),
-      makeActivity({
-        kind: "task.progress",
-        summary: "child work again",
-        tone: "info",
-        payload: { taskId: "child-2", timelineBypass: true },
-        turnId: "turn-spawn",
-      }),
-    ]);
-    // Not suppressed outright (a Codex fleet's rows are ALL bypassed and
-    // still need a CTA anchor) — but never more than the batch's single row.
-    expect(entries).toHaveLength(1);
-    expect(entries[0]!.agentSpawn?.agentTaskIds).toEqual(["child-1", "child-2"]);
-  });
-
-  it("timelineBypass non-agent rows (background shells) stay suppressed", () => {
-    const entries = deriveWorkLogEntries([
-      makeActivity({
-        kind: "task.progress",
-        summary: "stall",
-        tone: "info",
-        payload: { taskId: "sh-1", taskType: "local_bash", timelineBypass: true },
-      }),
-    ]);
-    expect(entries).toHaveLength(0);
-  });
-
-  it("drops task.updated and tool.progress from the work log (fold input only)", () => {
-    const entries = deriveWorkLogEntries([
-      makeActivity({
-        kind: "task.updated",
-        summary: "Task running",
-        tone: "info",
-        payload: { taskId: "task-1", status: "running" },
-      }),
-      makeActivity({
-        kind: "tool.progress",
-        summary: "Read",
-        tone: "info",
-        payload: { taskId: "task-1", toolName: "Read" },
-      }),
-    ]);
-    expect(entries).toHaveLength(0);
-  });
-});
-
-describe("rerun workflows", () => {
-  it("turn-less direct spawns do not collapse into one global batch", () => {
-    // Rows that lost their turn id (defensive path) group per task, so two
-    // unrelated turn-less spawns never merge into one immortal CTA.
-    const entries = deriveWorkLogEntries([
-      makeActivity({
-        kind: "task.started",
-        summary: "Task started",
-        payload: { taskId: "loose-1", taskType: "local_agent", role: "a" },
-        sequence: 1,
-      }),
-      makeActivity({
-        kind: "task.started",
-        summary: "Task started",
-        payload: { taskId: "loose-2", taskType: "local_agent", role: "b" },
-        sequence: 2,
-      }),
-    ]);
-    const spawnRows = entries.filter((entry) => entry.agentSpawn !== undefined);
-    expect(spawnRows).toHaveLength(2);
-    expect(spawnRows.map((row) => row.agentSpawn!.agentTaskIds)).toEqual([
-      ["loose-1"],
-      ["loose-2"],
-    ]);
-  });
-
-  it("each workflow run gets its own CTA row (distinct coordinator ids)", () => {
-    const entries = deriveWorkLogEntries([
-      makeActivity({
-        kind: "task.progress",
-        summary: "run 1",
-        tone: "info",
-        payload: { taskId: "wf-run1", taskType: "local_workflow", workflowName: "math-check" },
-        turnId: "turn-1",
-        sequence: 1,
-      }),
-      makeActivity({
-        kind: "task.completed",
-        summary: "run 1 done",
-        tone: "info",
-        payload: { taskId: "wf-run1", status: "completed", taskType: "local_workflow" },
-        turnId: "turn-1",
-        sequence: 2,
-      }),
-      makeActivity({
-        kind: "task.progress",
-        summary: "run 2",
-        tone: "info",
-        payload: { taskId: "wf-run2", taskType: "local_workflow", workflowName: "math-check" },
-        turnId: "turn-2",
-        sequence: 3,
-      }),
-    ]);
-    const spawnRows = entries.filter((entry) => entry.agentSpawn !== undefined);
-    expect(spawnRows.map((row) => row.agentSpawn!.workflowId)).toEqual(["wf-run1", "wf-run2"]);
-    expect(spawnRows.map((row) => row.turnId)).toEqual(["turn-1", "turn-2"]);
-  });
-});
-
-describe("session activity performance", () => {
-  it("reuses entries for unchanged activities", () => {
-    const activities = ["status", "diff", "log"].map((command, index) =>
-      makeActivity({
-        id: `stable-tool-${index}`,
-        kind: "tool.completed",
-        sequence: index,
-        payload: {
-          itemType: "command_execution",
-          data: { toolCallId: `stable-tool-${index}`, item: { command: ["git", command] } },
-        },
-      }),
-    );
-
-    const initialEntries = deriveWorkLogEntries(activities.slice(0, 2));
-    const appendedEntries = deriveWorkLogEntries(activities);
-    expect(appendedEntries[0]).toBe(initialEntries[0]);
-    expect(appendedEntries[1]).toBe(initialEntries[1]);
-  });
-
-  it("reuses entries when appending to 20,000 ordered tool activities", () => {
-    const activities = Array.from({ length: 20_000 }, (_, index) =>
-      makeActivity({
-        id: `benchmark-tool-${index}`,
-        createdAt: new Date(1_700_000_000_000 + index).toISOString(),
-        kind: "tool.completed",
-        summary: "Ran command",
-        sequence: index,
-        payload: {
-          itemType: "command_execution",
-          title: "Ran command",
-          data: {
-            toolCallId: `benchmark-tool-${index}`,
-            item: { command: ["git", "status"] },
-          },
-        },
-      }),
-    );
-    const initialEntries = deriveWorkLogEntries(activities);
-    expect(initialEntries).toHaveLength(20_000);
-    const updatedActivities = [
-      ...activities,
-      makeActivity({
-        id: "benchmark-tool-appended",
-        createdAt: new Date(1_700_000_000_000 + activities.length).toISOString(),
-        kind: "tool.completed",
-        summary: "Ran command",
-        sequence: activities.length,
-        payload: {
-          itemType: "command_execution",
-          title: "Ran command",
-          data: { toolCallId: "benchmark-tool-appended", item: { command: ["git", "diff"] } },
-        },
-      }),
-    ];
-
-    const updatedEntries = deriveWorkLogEntries(updatedActivities);
-    expect(updatedEntries).toHaveLength(20_001);
-    expect(initialEntries.every((entry, index) => updatedEntries[index] === entry)).toBe(true);
-    expect(updatedEntries.at(-1)).toMatchObject({
-      id: "benchmark-tool-appended",
-      command: "git diff",
-      toolLifecycleStatus: "completed",
-    });
+  it("recovered failure text no longer counts as success", () => {
+    const entry = toolEntry({ toolLifecycleStatus: "completed", detail: "ENOENT: no such file" });
+    expect(workEntryIndicatesToolSuccess(entry)).toBe(false);
   });
 });
diff --git a/apps/web/src/session-logic.ts b/apps/web/src/session-logic.ts
index 5796cda979b8..ede265247269 100644
--- a/apps/web/src/session-logic.ts
+++ b/apps/web/src/session-logic.ts
@@ -1,30 +1,25 @@
-import * as Option from "effect/Option";
-import * as Arr from "effect/Array";
-import * as Schema from "effect/Schema";
-import { isBackgroundTaskActivity } from "@t3tools/client-runtime/state/subagentRuntime";
 import {
-  ApprovalRequestId,
-  isToolLifecycleItemType,
-  type OrchestrationLatestTurn,
-  type OrchestrationThreadActivity,
-  type OrchestrationProposedPlanId,
   ProviderDriverKind,
-  ProviderApprovalOption,
-  ProviderRequestKind,
-  type ToolLifecycleItemType,
-  type UserInputQuestion,
+  type OrchestrationV2ExecutionNode,
+  type OrchestrationV2PlanArtifact,
+  type OrchestrationV2ProjectedTurnItem,
+  type OrchestrationV2RunAttempt,
+  type OrchestrationV2ThreadProjection,
+  type OrchestrationV2TurnItem,
+  type PlanId,
+  type RunId,
   type ThreadId,
-  type TurnId,
 } from "@t3tools/contracts";
-
+import type { ThreadCheckpointSummary } from "@t3tools/client-runtime/state/thread-checkpoints";
 import type {
-  ChatMessage,
-  ProposedPlan,
-  SessionPhase,
-  Thread,
-  ThreadSession,
-  TurnDiffSummary,
-} from "./types";
+  ThreadPendingApproval,
+  ThreadPendingUserInput,
+} from "@t3tools/client-runtime/state/thread-requests";
+import type { ThreadRunSummary, ThreadRuntimeSummary } from "@t3tools/client-runtime/state/shell";
+import { turnItemIsWorkspacePreparation } from "@t3tools/client-runtime/state/turn-item-presentation";
+
+import type { ChatMessage, ProposedPlan, SessionPhase, TurnDiffSummary } from "./types";
+import * as DateTime from "effect/DateTime";
 
 export type ProviderPickerKind = ProviderDriverKind;
 
@@ -32,7 +27,6 @@ export const PROVIDER_OPTIONS: Array<{
   value: ProviderPickerKind;
   label: string;
   available: boolean;
-  /** Shown on the model picker sidebar when relevant */
   pickerSidebarBadge?: "new" | "soon";
 }> = [
   { value: ProviderDriverKind.make("codex"), label: "Codex", available: true },
@@ -49,12 +43,7 @@ export const PROVIDER_OPTIONS: Array<{
     available: true,
     pickerSidebarBadge: "new",
   },
-  {
-    value: ProviderDriverKind.make("grok"),
-    label: "Grok",
-    available: true,
-    pickerSidebarBadge: "new",
-  },
+  { value: ProviderDriverKind.make("grok"), label: "Grok", available: true },
 ];
 
 export type WorkLogToolLifecycleStatus =
@@ -65,137 +54,108 @@ export type WorkLogToolLifecycleStatus =
   | "stopped";
 
 export interface WorkLogEntry {
-  id: string;
-  createdAt: string;
-  turnId?: TurnId | null;
-  /** Stable provider identity across in-progress and completed lifecycle updates. */
-  toolCallId?: string;
-  label: string;
-  detail?: string;
-  command?: string;
-  rawCommand?: string;
-  changedFiles?: ReadonlyArray<string>;
-  tone: "thinking" | "tool" | "info" | "error";
-  toolTitle?: string;
-  toolData?: unknown;
-  itemType?: ToolLifecycleItemType;
-  requestKind?: PendingApproval["requestKind"];
-  /** From runtime item / task payload `status` when present (e.g. tool.updated). */
-  toolLifecycleStatus?: WorkLogToolLifecycleStatus;
-  /** Originating orchestration activity kind (e.g. `user-input.requested`) for row chrome. */
-  sourceActivityKind?: OrchestrationThreadActivity["kind"];
-  /** Grouping key for subagent lifecycle rows (one row per agent). */
-  taskId?: string;
-  /** Agent role (subagent_type) for labeled timeline rows. */
-  agentRole?: string;
-  /**
-   * Present on agent-spawn CTA rows: one per workflow run or per-turn batch
-   * of direct spawns. The row renders as a call-to-action ("Kicked off N
-   * subagents") whose live status is derived from the agent panel model at
-   * render time; clicking opens the Agents panel.
-   */
-  agentSpawn?: {
-    /** Workflow coordinator taskId, or null for a direct-spawn batch. */
-    workflowId: string | null;
-    agentTaskIds: ReadonlyArray<string>;
-  };
-}
-
-const workLogCollapseKey = Symbol();
-
-interface DerivedWorkLogEntry extends WorkLogEntry {
-  sourceActivityKind: OrchestrationThreadActivity["kind"];
-  [workLogCollapseKey]?: string;
-  toolCallId?: string;
-  isWorkflowCoordinator?: boolean;
-  /** Shell/monitor/plan tasks: ordinary work-log rows, never spawn CTAs. */
-  isBackgroundTask?: boolean;
-}
-
-const derivedWorkLogEntryByActivity = new WeakMap<
-  OrchestrationThreadActivity,
-  DerivedWorkLogEntry
->();
-
-export interface PendingApproval {
-  requestId: ApprovalRequestId;
-  requestKind: ProviderRequestKind;
-  createdAt: string;
-  detail?: string;
-  appName?: string;
-  options?: ReadonlyArray<ProviderApprovalOption>;
-}
-
-const isProviderRequestKind = Schema.is(ProviderRequestKind);
-const isProviderApprovalOption = Schema.is(ProviderApprovalOption);
-
-export interface PendingUserInput {
-  requestId: ApprovalRequestId;
-  createdAt: string;
-  questions: ReadonlyArray<UserInputQuestion>;
-}
+  readonly id: string;
+  readonly createdAt: string;
+  readonly runId?: RunId | null;
+  readonly label: string;
+  readonly detail?: string;
+  readonly command?: string;
+  readonly rawCommand?: string;
+  readonly changedFiles?: ReadonlyArray<string>;
+  readonly tone: "thinking" | "tool" | "info" | "error";
+  readonly toolTitle?: string;
+  readonly toolData?: unknown;
+  readonly requestKind?: string;
+  readonly itemType?: OrchestrationV2TurnItem["type"];
+  readonly toolLifecycleStatus?: WorkLogToolLifecycleStatus;
+  readonly structuredPayload?: OrchestrationV2TurnItem;
+  readonly sourceItemType?: OrchestrationV2TurnItem["type"];
+  readonly projectedItem?: OrchestrationV2ProjectedTurnItem;
+}
+
+export type PendingApproval = ThreadPendingApproval;
+export type PendingUserInput = ThreadPendingUserInput;
 
 export interface ActivePlanState {
-  createdAt: string;
-  turnId: TurnId | null;
-  explanation?: string | null;
-  steps: Array<{
-    durationMs?: number;
-    step: string;
-    status: "pending" | "inProgress" | "completed";
+  readonly createdAt: string;
+  readonly runId: RunId | null;
+  readonly explanation?: string | null;
+  readonly steps: Array<{
+    readonly step: string;
+    readonly status: "pending" | "inProgress" | "completed";
   }>;
 }
 
+export interface TurnPlanEntry {
+  /** Stable per-plan row id (plans rewrite in place; the row must not churn). */
+  readonly id: string;
+  readonly createdAt: string;
+  readonly runId: RunId | null;
+  readonly plan: ActivePlanState;
+}
+
 export interface LatestProposedPlanState {
-  id: OrchestrationProposedPlanId;
-  createdAt: string;
-  updatedAt: string;
-  turnId: TurnId | null;
-  planMarkdown: string;
-  implementedAt: string | null;
-  implementationThreadId: ThreadId | null;
+  readonly id: PlanId;
+  readonly createdAt: string;
+  readonly updatedAt: string;
+  readonly runId: RunId | null;
+  readonly planMarkdown: string;
+  readonly status: OrchestrationV2PlanArtifact["status"];
 }
 
-export type TimelineEntry =
+export type TimelineAttempt = Pick<
+  OrchestrationV2RunAttempt,
+  "id" | "runId" | "attemptOrdinal" | "rootNodeId" | "status"
+>;
+
+export type TimelineEntry = (
   | {
-      id: string;
-      kind: "message";
-      createdAt: string;
-      message: ChatMessage;
+      readonly id: string;
+      readonly kind: "message";
+      readonly createdAt: string;
+      readonly message: ChatMessage;
+      readonly projectedItem?: OrchestrationV2ProjectedTurnItem;
     }
   | {
-      id: string;
-      kind: "proposed-plan";
-      createdAt: string;
-      proposedPlan: ProposedPlan;
+      readonly id: string;
+      readonly kind: "proposed-plan";
+      readonly createdAt: string;
+      readonly proposedPlan: ProposedPlan;
     }
   | {
-      id: string;
-      kind: "turn-plan";
-      createdAt: string;
-      turnPlan: TurnPlanEntry;
+      readonly id: string;
+      readonly kind: "work";
+      readonly createdAt: string;
+      readonly entry: WorkLogEntry;
     }
   | {
-      id: string;
-      kind: "work";
-      createdAt: string;
-      entry: WorkLogEntry;
-    };
+      readonly id: string;
+      readonly kind: "event";
+      readonly createdAt: string;
+      readonly projectedItem: OrchestrationV2ProjectedTurnItem;
+    }
+  | {
+      readonly id: string;
+      readonly kind: "turn-plan";
+      readonly createdAt: string;
+      readonly turnPlan: TurnPlanEntry;
+    }
+) & {
+  /** V2 identity resolved from the item's execution node, when locally available. */
+  readonly attempt?: TimelineAttempt;
+};
 
 export function workLogEntryIsToolLike(entry: WorkLogEntry): boolean {
-  if (entry.tone === "tool" || entry.tone === "thinking" || entry.tone === "error") {
-    return true;
-  }
-  if (entry.command !== undefined && entry.command.trim().length > 0) {
-    return true;
-  }
-  if (entry.requestKind !== undefined) {
-    return true;
-  }
-  return entry.itemType !== undefined && isToolLifecycleItemType(entry.itemType);
+  return (
+    entry.tone === "tool" ||
+    entry.tone === "thinking" ||
+    entry.tone === "error" ||
+    entry.command !== undefined ||
+    entry.requestKind !== undefined
+  );
 }
 
-/** Heuristic: providers often emit successful lifecycle status while error text lives in `detail` / `command`. */
+/** Heuristic: providers often emit successful item status while error text lives in `detail` / `command`. */
 function toolDetailTextLooksLikeFailure(text: string): boolean {
   const t = text.toLowerCase();
   if (t.includes("file not found")) {
@@ -279,59 +239,27 @@ export function workEntryDisplayIndicatesToolFailure(entry: WorkLogEntry): boole
   return workEntryIndicatesToolFailureFromOutput(entry, false);
 }
 
-/** Severe failures keep the red treatment ordinary tool failures lost: runtime
- *  errors and orchestration `*.failed` activities (provider.turn.start.failed,
- *  checkpoint.capture.failed, ...) mean the turn or a core side effect broke,
- *  not that a command exited nonzero. */
+/** Severe failures keep the red treatment ordinary tool failures lost: provider
+ *  runtime errors mean the turn or a core side effect broke, not that a
+ *  command exited nonzero. */
 export function workEntrySignalsSevereFailure(entry: WorkLogEntry): boolean {
-  return (
-    entry.sourceActivityKind === "runtime.error" ||
-    entry.sourceActivityKind?.endsWith(".failed") === true
-  );
+  return entry.itemType === "error";
 }
 
-/** Tool/command row completed without failure (blue check affordance). */
 export function workEntryIndicatesToolSuccess(entry: WorkLogEntry): boolean {
-  if (!workLogEntryIsToolLike(entry)) {
-    return false;
-  }
-  if (workEntryIndicatesToolFailure(entry)) {
-    return false;
-  }
-  if (entry.tone === "thinking") {
-    return false;
-  }
-  const ls = entry.toolLifecycleStatus;
-  if (ls === "failed" || ls === "declined") {
-    return false;
-  }
-  if (ls === "inProgress") {
-    return false;
-  }
-  if (ls === "stopped") {
-    return false;
-  }
-  return true;
+  return (
+    workLogEntryIsToolLike(entry) &&
+    !workEntryIndicatesToolFailure(entry) &&
+    entry.toolLifecycleStatus === "completed"
+  );
 }
 
-/** Tool-like row with neither clear success nor failure (empty, incomplete, in progress, etc.). */
 export function workEntryIndicatesToolNeutralStatus(entry: WorkLogEntry): boolean {
-  // Spawn CTA rows are never neutral-hidden: mid-run they derive from
-  // task.progress (tone "thinking") and the neutral filter was swallowing
-  // them exactly while the fleet ran — the one moment they matter most.
-  if (entry.agentSpawn !== undefined) {
-    return false;
-  }
-  if (!workLogEntryIsToolLike(entry)) {
-    return false;
-  }
-  if (workEntryIndicatesToolFailure(entry)) {
-    return false;
-  }
-  if (workEntryIndicatesToolSuccess(entry)) {
-    return false;
-  }
-  return true;
+  return (
+    workLogEntryIsToolLike(entry) &&
+    !workEntryIndicatesToolFailure(entry) &&
+    !workEntryIndicatesToolSuccess(entry)
+  );
 }
 
 export function formatDuration(durationMs: number): string {
@@ -339,7 +267,6 @@ export function formatDuration(durationMs: number): string {
   if (durationMs < 1_000) return `${Math.max(1, Math.round(durationMs))}ms`;
   if (durationMs < 10_000) {
     const tenths = Math.round(durationMs / 100) / 10;
-    // 9.95s+ rounds up to the next bucket — render "10s", not "10.0s".
     return tenths >= 10 ? "10s" : `${tenths.toFixed(1)}s`;
   }
   if (durationMs < 60_000) return `${Math.round(durationMs / 1_000)}s`;
@@ -354,1554 +281,561 @@ export function formatElapsed(startIso: string, endIso: string | undefined): str
   if (!endIso) return null;
   const startedAt = Date.parse(startIso);
   const endedAt = Date.parse(endIso);
-  if (Number.isNaN(startedAt) || Number.isNaN(endedAt) || endedAt < startedAt) {
-    return null;
-  }
+  if (Number.isNaN(startedAt) || Number.isNaN(endedAt) || endedAt < startedAt) return null;
   return formatDuration(endedAt - startedAt);
 }
 
-type LatestTurnTiming = Pick<OrchestrationLatestTurn, "turnId" | "startedAt" | "completedAt">;
-type SessionActivityState = Pick<NonNullable<Thread["session"]>, "status" | "activeTurnId">;
-
-export function isLatestTurnSettled(
-  latestTurn: LatestTurnTiming | null,
-  session: SessionActivityState | null,
+export function isLatestRunSettled(
+  latestRun: Pick<ThreadRunSummary, "runId" | "startedAt" | "completedAt" | "status"> | null,
+  runtime: Pick<ThreadRuntimeSummary, "status" | "activeRunId"> | null,
 ): boolean {
-  if (!latestTurn?.startedAt) return false;
-  if (!latestTurn.completedAt) return false;
-  if (!session) return true;
-  if (session.status === "running") return false;
-  return true;
+  if (latestRun === null) return false;
+  if (
+    latestRun.status === "preparing" ||
+    latestRun.status === "queued" ||
+    latestRun.status === "starting" ||
+    latestRun.status === "running" ||
+    latestRun.status === "waiting"
+  )
+    return false;
+  return runtime?.activeRunId !== latestRun.runId;
 }
 
 export function deriveActiveWorkStartedAt(
-  latestTurn: LatestTurnTiming | null,
-  session: SessionActivityState | null,
+  latestRun: Pick<ThreadRunSummary, "runId" | "startedAt" | "completedAt" | "status"> | null,
+  runtime: Pick<ThreadRuntimeSummary, "status" | "activeRunId"> | null,
   sendStartedAt: string | null,
-  latestUserMessageAt: string | null = null,
 ): string | null {
-  const runningTurnId = session?.status === "running" ? session.activeTurnId : null;
-  if (runningTurnId !== null) {
-    if (latestTurn?.turnId === runningTurnId) {
-      return latestTurn.startedAt ?? sendStartedAt ?? latestUserMessageAt;
-    }
-    return sendStartedAt ?? latestUserMessageAt;
-  }
-  if (!isLatestTurnSettled(latestTurn, session)) {
-    return latestTurn?.startedAt ?? sendStartedAt;
-  }
-  return sendStartedAt;
-}
-
-function requestKindFromRequestType(requestType: unknown): PendingApproval["requestKind"] | null {
-  switch (requestType) {
-    case "command_execution_approval":
-    case "exec_command_approval":
-    case "dynamic_tool_call":
-      return "command";
-    case "file_read_approval":
-      return "file-read";
-    case "file_change_approval":
-    case "apply_patch_approval":
-      return "file-change";
-    case "mcp_elicitation_approval":
-      return "mcp-elicitation";
-    default:
-      return null;
+  if (runtime?.activeRunId !== null && runtime?.activeRunId !== undefined) {
+    return latestRun?.runId === runtime.activeRunId
+      ? (latestRun.startedAt ?? sendStartedAt)
+      : sendStartedAt;
   }
-}
-
-function isStalePendingRequestFailureDetail(detail: string | undefined): boolean {
-  const normalized = detail?.toLowerCase();
-  if (!normalized) {
-    return false;
-  }
-  return (
-    normalized.includes("stale pending approval request") ||
-    normalized.includes("stale pending user-input request") ||
-    normalized.includes("unknown pending approval request") ||
-    normalized.includes("unknown pending permission request") ||
-    normalized.includes("unknown pending user-input request") ||
-    normalized.includes("unknown pending user input request") ||
-    normalized.includes("unknown pending codex user input request")
-  );
+  return isLatestRunSettled(latestRun, runtime)
+    ? sendStartedAt
+    : (latestRun?.startedAt ?? sendStartedAt);
 }
 
 export function derivePendingApprovals(
-  activities: ReadonlyArray<OrchestrationThreadActivity>,
-): PendingApproval[] {
-  const openByRequestId = new Map<ApprovalRequestId, PendingApproval>();
-  const ordered = [...activities].toSorted(compareActivitiesByOrder);
-
-  for (const activity of ordered) {
-    const payload =
-      activity.payload && typeof activity.payload === "object"
-        ? (activity.payload as Record<string, unknown>)
-        : null;
-    const requestId =
-      payload && typeof payload.requestId === "string"
-        ? ApprovalRequestId.make(payload.requestId)
-        : null;
-    const requestKind =
-      payload && isProviderRequestKind(payload.requestKind)
-        ? payload.requestKind
-        : payload
-          ? requestKindFromRequestType(payload.requestType)
-          : null;
-    const detail = payload && typeof payload.detail === "string" ? payload.detail : undefined;
-    const appName = payload && typeof payload.appName === "string" ? payload.appName : undefined;
-    const options = Array.isArray(payload?.options)
-      ? payload.options.filter(isProviderApprovalOption)
-      : undefined;
-
-    if (activity.kind === "approval.requested" && requestId && requestKind) {
-      openByRequestId.set(requestId, {
-        requestId,
-        requestKind,
-        createdAt: activity.createdAt,
-        ...(detail ? { detail } : {}),
-        ...(appName ? { appName } : {}),
-        ...(options && options.length > 0 ? { options } : {}),
-      });
-      continue;
-    }
-
-    if (activity.kind === "approval.resolved" && requestId) {
-      openByRequestId.delete(requestId);
-      continue;
-    }
-
-    if (
-      activity.kind === "provider.approval.respond.failed" &&
-      requestId &&
-      isStalePendingRequestFailureDetail(detail)
-    ) {
-      openByRequestId.delete(requestId);
-      continue;
-    }
-  }
-
-  return [...openByRequestId.values()].toSorted((left, right) =>
-    left.createdAt.localeCompare(right.createdAt),
-  );
-}
-
-function parseUserInputQuestions(
-  payload: Record<string, unknown> | null,
-): ReadonlyArray<UserInputQuestion> | null {
-  const questions = payload?.questions;
-  if (!Array.isArray(questions)) {
-    return null;
-  }
-  const parsed = questions
-    .map<UserInputQuestion | null>((entry) => {
-      if (!entry || typeof entry !== "object") return null;
-      const question = entry as Record<string, unknown>;
-      if (
-        typeof question.id !== "string" ||
-        typeof question.header !== "string" ||
-        typeof question.question !== "string" ||
-        !Array.isArray(question.options)
-      ) {
-        return null;
-      }
-      const options = question.options
-        .map<UserInputQuestion["options"][number] | null>((option) => {
-          if (!option || typeof option !== "object") return null;
-          const optionRecord = option as Record<string, unknown>;
-          if (
-            typeof optionRecord.label !== "string" ||
-            typeof optionRecord.description !== "string"
-          ) {
-            return null;
-          }
-          return {
-            label: optionRecord.label,
-            description: optionRecord.description,
-          };
-        })
-        .filter((option): option is UserInputQuestion["options"][number] => option !== null);
-      if (options.length === 0) {
-        return null;
-      }
-      return {
-        id: question.id,
-        header: question.header,
-        question: question.question,
-        options,
-        multiSelect: question.multiSelect === true,
-      };
-    })
-    .filter((question): question is UserInputQuestion => question !== null);
-  return parsed.length > 0 ? parsed : null;
+  approvals: ReadonlyArray<ThreadPendingApproval>,
+): ThreadPendingApproval[] {
+  return [...approvals].toSorted((left, right) => left.createdAt.localeCompare(right.createdAt));
 }
 
 export function derivePendingUserInputs(
-  activities: ReadonlyArray<OrchestrationThreadActivity>,
-): PendingUserInput[] {
-  const openByRequestId = new Map<ApprovalRequestId, PendingUserInput>();
-  const ordered = [...activities].toSorted(compareActivitiesByOrder);
-
-  for (const activity of ordered) {
-    const payload =
-      activity.payload && typeof activity.payload === "object"
-        ? (activity.payload as Record<string, unknown>)
-        : null;
-    const requestId =
-      payload && typeof payload.requestId === "string"
-        ? ApprovalRequestId.make(payload.requestId)
-        : null;
-    const detail = payload && typeof payload.detail === "string" ? payload.detail : undefined;
-
-    if (activity.kind === "user-input.requested" && requestId) {
-      const questions = parseUserInputQuestions(payload);
-      if (!questions) {
-        continue;
-      }
-      openByRequestId.set(requestId, {
-        requestId,
-        createdAt: activity.createdAt,
-        questions,
-      });
-      continue;
-    }
-
-    if (activity.kind === "user-input.resolved" && requestId) {
-      openByRequestId.delete(requestId);
-      continue;
-    }
-
-    if (
-      activity.kind === "provider.user-input.respond.failed" &&
-      requestId &&
-      isStalePendingRequestFailureDetail(detail)
-    ) {
-      openByRequestId.delete(requestId);
-    }
-  }
-
-  return [...openByRequestId.values()].toSorted((left, right) =>
-    left.createdAt.localeCompare(right.createdAt),
-  );
+  inputs: ReadonlyArray<ThreadPendingUserInput>,
+): ThreadPendingUserInput[] {
+  return [...inputs].toSorted((left, right) => left.createdAt.localeCompare(right.createdAt));
 }
 
-function planStateFromActivity(activity: OrchestrationThreadActivity): ActivePlanState | null {
-  const payload =
-    activity.payload && typeof activity.payload === "object"
-      ? (activity.payload as Record<string, unknown>)
-      : null;
-  const rawPlan = payload?.plan;
-  if (!Array.isArray(rawPlan)) {
-    return null;
-  }
-  const steps: Array<{
-    step: string;
-    status: "pending" | "inProgress" | "completed";
-  }> = [];
-  for (const entry of rawPlan) {
-    if (!entry || typeof entry !== "object") {
-      continue;
-    }
-    const record = entry as Record<string, unknown>;
-    if (typeof record.step !== "string") {
-      continue;
-    }
-    const status =
-      record.status === "completed" || record.status === "inProgress" ? record.status : "pending";
-    steps.push({
-      step: record.step,
-      status,
-    });
-  }
-  if (steps.length === 0) {
-    return null;
-  }
-  return {
-    createdAt: activity.createdAt,
-    turnId: activity.turnId,
-    ...(payload && "explanation" in payload
-      ? { explanation: payload.explanation as string | null }
-      : {}),
-    steps,
-  };
-}
-
-function addPlanStepDurations(
-  plan: ActivePlanState,
-  activities: ReadonlyArray<OrchestrationThreadActivity>,
-): ActivePlanState {
-  const timings = new Map<string, { completedAt?: number; startedAt?: number }>();
-  let planStartedAt: number | undefined;
-
-  const keyedSteps = (steps: ActivePlanState["steps"]) => {
-    const occurrences = new Map<string, number>();
-    return steps.map((step) => {
-      const occurrence = occurrences.get(step.step) ?? 0;
-      occurrences.set(step.step, occurrence + 1);
-      return { key: `${step.step}:${occurrence}`, step };
-    });
-  };
-
-  for (const activity of activities) {
-    const snapshot = planStateFromActivity(activity);
-    const activityAt = Date.parse(activity.createdAt);
-    if (!snapshot || Number.isNaN(activityAt)) continue;
-    planStartedAt ??= activityAt;
-
-    for (const { key, step } of keyedSteps(snapshot.steps)) {
-      const timing = timings.get(key) ?? {};
-      if (step.status === "inProgress" && timing.startedAt === undefined) {
-        timing.startedAt = activityAt;
-      }
-      if (step.status === "completed" && timing.completedAt === undefined) {
-        timing.completedAt = activityAt;
-      }
-      timings.set(key, timing);
-    }
-  }
-
-  const durationByKey = new Map<string, number>();
-  let previousCompletedAt = planStartedAt;
-  for (const [key, timing] of [...timings.entries()].toSorted(
-    (left, right) => (left[1].completedAt ?? Infinity) - (right[1].completedAt ?? Infinity),
-  )) {
-    const completedAt = timing.completedAt;
-    const startedAt = timing.startedAt ?? previousCompletedAt;
-    if (completedAt === undefined) continue;
-    if (startedAt !== undefined && completedAt > startedAt) {
-      durationByKey.set(key, completedAt - startedAt);
-    }
-    previousCompletedAt = completedAt;
-  }
-
+export function deriveActivePlanState(
+  projection: OrchestrationV2ThreadProjection | null,
+  latestRunId: RunId | undefined,
+): ActivePlanState | null {
+  if (projection === null) return null;
+  const plans = projection.plans.filter((plan) => plan.kind === "todo_list");
+  const plan =
+    [...plans].toReversed().find((candidate) => candidate.runId === latestRunId) ??
+    plans.at(-1) ??
+    null;
+  if (plan === null || plan.steps.length === 0) return null;
   return {
-    ...plan,
-    steps: keyedSteps(plan.steps).map(({ key, step }) => {
-      if (step.status !== "completed") return step;
-      const durationMs = durationByKey.get(key);
-      return durationMs === undefined ? step : { ...step, durationMs };
-    }),
+    createdAt: planItemTime(projection, plan.id),
+    runId: plan.runId,
+    explanation: plan.explanation ?? null,
+    steps: plan.steps.map(({ text, status }) => ({
+      step: text,
+      status: status === "running" ? "inProgress" : status,
+    })),
   };
 }
 
-export function deriveActivePlanState(
-  activities: ReadonlyArray<OrchestrationThreadActivity>,
-  latestTurnId: TurnId | undefined,
-): ActivePlanState | null {
-  const ordered = [...activities].toSorted(compareActivitiesByOrder);
-  const allPlanActivities = ordered.filter((activity) => activity.kind === "turn.plan.updated");
-  // Prefer plan from the current turn; fall back to the most recent plan from any turn
-  // so that TodoWrite tasks persist across follow-up messages.
-  const latest = Option.firstSomeOf([
-    ...(latestTurnId
-      ? Arr.findLast(allPlanActivities, (activity) => activity.turnId === latestTurnId)
-      : Option.none()),
-    Arr.last(allPlanActivities),
-  ]).pipe(Option.getOrNull);
-  if (!latest) {
-    return null;
-  }
-  const plan = planStateFromActivity(latest);
-  if (!plan) return null;
-  const matchingActivities = allPlanActivities.filter(
-    (activity) => activity.turnId === latest.turnId,
-  );
-  const latestClearIndex = matchingActivities.findLastIndex(
-    (activity) => planStateFromActivity(activity) === null,
+function planItemTime(projection: OrchestrationV2ThreadProjection, planId: PlanId): string {
+  const item = projection.turnItems.findLast(
+    (candidate) =>
+      (candidate.type === "proposed_plan" || candidate.type === "todo_list") &&
+      candidate.planId === planId,
   );
-  return addPlanStepDurations(plan, matchingActivities.slice(latestClearIndex + 1));
+  return DateTime.formatIso(item?.updatedAt ?? projection.updatedAt);
 }
 
-export interface TurnPlanEntry {
-  /** Stable per-turn row id (plans rewrite constantly; the row must not churn). */
-  id: string;
-  /** Anchor timestamp: the turn's FIRST plan activity, so the chip renders where planning began. */
-  createdAt: string;
-  turnId: TurnId | null;
-  plan: ActivePlanState;
-}
-
-/**
- * One inline plan chip per turn that produced plan/todo steps: the latest
- * snapshot for the turn, anchored at the first snapshot's timestamp. Turn-less
- * plan activities collapse into a single chip keyed by thread order.
- */
-export function deriveTurnPlans(
-  activities: ReadonlyArray<OrchestrationThreadActivity>,
-): TurnPlanEntry[] {
-  const ordered = [...activities].toSorted(compareActivitiesByOrder);
-  const byTurn = new Map<
-    string,
-    { activities: OrchestrationThreadActivity[]; entry: TurnPlanEntry }
-  >();
-  for (const activity of ordered) {
-    if (activity.kind !== "turn.plan.updated") {
-      continue;
-    }
-    const plan = planStateFromActivity(activity);
-    const key = activity.turnId ?? "no-turn";
-    if (!plan) {
-      // A later snapshot with no steps clears the turn's plan; keeping the
-      // stale entry would freeze the chip on a withdrawn plan.
-      byTurn.delete(key);
-      continue;
-    }
-    const existing = byTurn.get(key);
-    if (existing) {
-      existing.entry.plan = plan;
-      existing.activities.push(activity);
-    } else {
-      byTurn.set(key, {
-        activities: [activity],
-        entry: {
-          id: `turn-plan:${key}`,
-          createdAt: activity.createdAt,
-          turnId: activity.turnId,
-          plan,
-        },
-      });
-    }
-  }
-  return [...byTurn.values()].map(({ activities: planActivities, entry }) => ({
-    ...entry,
-    plan: addPlanStepDurations(entry.plan, planActivities),
-  }));
+function toLatestProposedPlanState(
+  projection: OrchestrationV2ThreadProjection,
+  plan: Extract<OrchestrationV2PlanArtifact, { readonly kind: "proposed_plan" }>,
+): LatestProposedPlanState {
+  const updatedAt = planItemTime(projection, plan.id);
+  return {
+    id: plan.id,
+    createdAt: updatedAt,
+    updatedAt,
+    runId: plan.runId,
+    planMarkdown: plan.markdown,
+    status: plan.status,
+  };
 }
 
 export function findLatestProposedPlan(
-  proposedPlans: ReadonlyArray<ProposedPlan>,
-  latestTurnId: TurnId | string | null | undefined,
+  projection: OrchestrationV2ThreadProjection | null,
+  latestRunId: RunId | string | null | undefined,
 ): LatestProposedPlanState | null {
-  if (latestTurnId) {
-    const matchingTurnPlan = [...proposedPlans]
-      .filter((proposedPlan) => proposedPlan.turnId === latestTurnId)
-      .toSorted(
-        (left, right) =>
-          left.updatedAt.localeCompare(right.updatedAt) || left.id.localeCompare(right.id),
-      )
-      .at(-1);
-    if (matchingTurnPlan) {
-      return toLatestProposedPlanState(matchingTurnPlan);
-    }
-  }
-
-  const latestPlan = [...proposedPlans]
+  if (projection === null) return null;
+  const plans = projection.plans.filter((plan) => plan.kind === "proposed_plan");
+  const candidates = latestRunId ? plans.filter((plan) => plan.runId === latestRunId) : plans;
+  const plan = [...(candidates.length > 0 ? candidates : plans)]
     .toSorted(
       (left, right) =>
-        left.updatedAt.localeCompare(right.updatedAt) || left.id.localeCompare(right.id),
+        planItemTime(projection, left.id).localeCompare(planItemTime(projection, right.id)) ||
+        left.id.localeCompare(right.id),
     )
     .at(-1);
-  if (!latestPlan) {
-    return null;
-  }
-
-  return toLatestProposedPlanState(latestPlan);
-}
-
-export function hasActionableProposedPlan(
-  proposedPlan: LatestProposedPlanState | Pick<ProposedPlan, "implementedAt"> | null,
-): boolean {
-  return proposedPlan !== null && proposedPlan.implementedAt === null;
-}
-
-/**
- * Quiet-timeline guarantee: the work log carries the parent's narrative plus
- * at most one row per agent. Everything an agent does internally lives in the
- * Agents surface:
- * - timelineBypass rows (Codex children, workflow members) never render here;
- * - tool rows attributed to an owning agent (payload.agentId) are re-homed;
- * - task.progress ticks collapse into one row per taskId;
- * - task.updated is fold input only (status patches are not narrative).
- * Unattributed rows always stay: over-hiding loses the only terminal signal.
- */
-/** Agent (non-background) task.started rows seed spawn CTA batches. */
-function isAgentTaskStartedActivity(activity: OrchestrationThreadActivity): boolean {
-  const payload =
-    activity.payload && typeof activity.payload === "object"
-      ? (activity.payload as Record<string, unknown>)
-      : null;
-  if (!payload || typeof payload.taskId !== "string") {
-    return false;
-  }
-  return !isBackgroundTaskActivity(payload);
-}
-
-function isAgentInternalActivity(activity: OrchestrationThreadActivity): boolean {
-  const payload =
-    activity.payload && typeof activity.payload === "object"
-      ? (activity.payload as Record<string, unknown>)
-      : null;
-  if (!payload) {
-    return false;
-  }
-  const isTaskRow =
-    activity.kind === "task.started" ||
-    activity.kind === "task.progress" ||
-    activity.kind === "task.updated" ||
-    activity.kind === "task.completed";
-  // Task rows classify by the server stamp: a subagent's own background
-  // shell (agentId + "background") is agent-internal, but a nested AGENT
-  // (agentId + "agent") stays visible so its rows can anchor a spawn CTA
-  // (review finding: hiding on agentId alone removed nested agents and
-  // their anchors). Bypassed agent lifecycle rows also pass — collapse
-  // folds every such row into its batch's single CTA row, which is how
-  // Codex children (whose rows are ALL bypassed) get an anchor at the
-  // spawn point.
-  if (isTaskRow) {
-    const ownedByAgent = typeof payload.agentId === "string" && payload.agentId.trim().length > 0;
-    if (ownedByAgent || payload.timelineBypass === true) {
-      const isAgentTaskRow =
-        activity.kind !== "task.updated" &&
-        typeof payload.taskId === "string" &&
-        !isBackgroundTaskActivity(payload);
-      return !isAgentTaskRow;
-    }
-    return false;
-  }
-  if (payload.timelineBypass === true) {
-    return true;
-  }
-  // Non-task rows (attributed tool activity) owned by an agent are internal.
-  return typeof payload.agentId === "string" && payload.agentId.trim().length > 0;
-}
-
-export function deriveWorkLogEntries(
-  activities: ReadonlyArray<OrchestrationThreadActivity>,
-): WorkLogEntry[] {
-  const ordered = [...activities].toSorted(compareActivitiesByOrder);
-  const entries: DerivedWorkLogEntry[] = [];
-  for (const activity of ordered) {
-    if (activity.kind === "tool.started") continue;
-    // Agent task.started rows are CTA seeds: they carry the true spawn turn,
-    // which is the batch key (completions of background subagents arrive
-    // under later synthetic turns and must not start new batches). They
-    // collapse into the batch's single CTA row, never render standalone.
-    if (activity.kind === "task.started" && !isAgentTaskStartedActivity(activity)) continue;
-    if (activity.kind === "task.updated") continue;
-    if (activity.kind === "tool.progress") continue;
-    if (activity.kind === "context-window.updated") continue;
-    if (activity.kind === "turn.plan.updated") continue;
-    if (activity.summary === "Checkpoint captured") continue;
-    if (isNoContentRuntimeWarning(activity)) continue;
-    if (isPlanBoundaryToolActivity(activity)) continue;
-    if (isAgentInternalActivity(activity)) continue;
-    entries.push(toDerivedWorkLogEntry(activity));
-  }
-  return collapseDerivedWorkLogEntries(entries);
-}
-
-/** Adapters forward unknown wire-only SDK messages (background_tasks_changed,
- *  commands_changed, ...) as runtime warnings. The suffix comes from
- *  describeUnknownSdkMessage in the Claude adapter; a row with no displayable
- *  text carries nothing a user can act on, so it does not render. */
-function isNoContentRuntimeWarning(activity: OrchestrationThreadActivity): boolean {
-  return (
-    activity.kind === "runtime.warning" &&
-    activity.summary.endsWith("(no displayable text content)")
-  );
-}
-
-function isPlanBoundaryToolActivity(activity: OrchestrationThreadActivity): boolean {
-  if (activity.kind !== "tool.updated" && activity.kind !== "tool.completed") {
-    return false;
-  }
-
-  const payload =
-    activity.payload && typeof activity.payload === "object"
-      ? (activity.payload as Record<string, unknown>)
-      : null;
-  return typeof payload?.detail === "string" && payload.detail.startsWith("ExitPlanMode:");
-}
-
-function extractWorkLogToolLifecycleStatus(
-  payload: Record<string, unknown> | null,
-): WorkLogToolLifecycleStatus | undefined {
-  if (!payload) {
-    return undefined;
-  }
-  const s = payload.status;
-  if (
-    s === "inProgress" ||
-    s === "completed" ||
-    s === "failed" ||
-    s === "declined" ||
-    s === "stopped"
-  ) {
-    return s;
-  }
-  return undefined;
-}
-
-function toDerivedWorkLogEntry(activity: OrchestrationThreadActivity): DerivedWorkLogEntry {
-  const cachedEntry = derivedWorkLogEntryByActivity.get(activity);
-  if (cachedEntry) {
-    return cachedEntry;
-  }
-  const payload =
-    activity.payload && typeof activity.payload === "object"
-      ? (activity.payload as Record<string, unknown>)
-      : null;
-  const commandPreview = extractToolCommand(payload);
-  const changedFiles = extractChangedFiles(payload);
-  const title = extractToolTitle(payload);
-  const isTaskActivity =
-    activity.kind === "task.started" ||
-    activity.kind === "task.progress" ||
-    activity.kind === "task.completed";
-  const taskSummary =
-    isTaskActivity && typeof payload?.summary === "string" && payload.summary.length > 0
-      ? payload.summary
-      : null;
-  const taskDetailAsLabel =
-    isTaskActivity &&
-    !taskSummary &&
-    typeof payload?.detail === "string" &&
-    payload.detail.length > 0
-      ? payload.detail
-      : null;
-  const taskLabel = taskSummary || taskDetailAsLabel;
-  const detail = isTaskActivity
-    ? !taskDetailAsLabel &&
-      payload &&
-      typeof payload.detail === "string" &&
-      payload.detail.length > 0
-      ? stripTrailingExitCode(payload.detail).output
-      : null
-    : extractToolDetail(payload, title ?? activity.summary);
-  const toolCallId = isTaskActivity ? null : extractToolCallId(payload);
-  const entry: DerivedWorkLogEntry = {
-    id: activity.id,
-    createdAt: activity.createdAt,
-    turnId: activity.turnId,
-    label: taskLabel || activity.summary,
-    tone:
-      activity.kind === "task.progress"
-        ? "thinking"
-        : activity.tone === "approval"
-          ? "info"
-          : activity.tone,
-    sourceActivityKind: activity.kind,
-  };
-  const itemType = extractWorkLogItemType(payload);
-  const requestKind = extractWorkLogRequestKind(payload);
-  if (detail) {
-    entry.detail = detail;
-  }
-  if (commandPreview.command) {
-    entry.command = commandPreview.command;
-  }
-  if (commandPreview.rawCommand) {
-    entry.rawCommand = commandPreview.rawCommand;
-  }
-  if (changedFiles.length > 0) {
-    entry.changedFiles = changedFiles;
-  }
-  if (title) {
-    entry.toolTitle = title;
-  }
-  if (itemType === "mcp_tool_call") {
-    const data = asRecord(payload?.data);
-    if (data?.item !== undefined) {
-      entry.toolData = data.item;
-    }
-  }
-  if (itemType) {
-    entry.itemType = itemType;
-  }
-  if (requestKind) {
-    entry.requestKind = requestKind;
-  }
-  if (toolCallId) {
-    entry.toolCallId = toolCallId;
-  }
-  let toolLifecycleStatus = extractWorkLogToolLifecycleStatus(payload);
-  if (!toolLifecycleStatus && activity.kind === "tool.completed") {
-    toolLifecycleStatus = "completed";
-  }
-  if (toolLifecycleStatus) {
-    entry.toolLifecycleStatus = toolLifecycleStatus;
-  }
-  if (isTaskActivity && typeof payload?.taskId === "string" && payload.taskId.length > 0) {
-    entry.taskId = payload.taskId;
-  }
-  if (isTaskActivity && typeof payload?.role === "string" && payload.role.length > 0) {
-    entry.agentRole = payload.role;
-  }
-  if (
-    isTaskActivity &&
-    (payload?.taskType === "local_workflow" ||
-      (typeof payload?.workflowName === "string" && payload.workflowName.length > 0))
-  ) {
-    entry.isWorkflowCoordinator = true;
-  }
-  if (isTaskActivity && payload && isBackgroundTaskActivity(payload)) {
-    entry.isBackgroundTask = true;
-  }
-  const collapseKey = deriveToolLifecycleCollapseKey(entry);
-  if (collapseKey) {
-    entry[workLogCollapseKey] = collapseKey;
-  }
-  derivedWorkLogEntryByActivity.set(activity, entry);
-  return entry;
-}
-
-/**
- * Spawn-group key for a subagent lifecycle row. Workflow members and their
- * coordinator share the coordinator's group; direct spawns batch per turn.
- * One CTA row per group (A1 design): "Kicked off N subagents".
- */
-function agentSpawnGroupKey(entry: DerivedWorkLogEntry): string {
-  const taskId = entry.taskId ?? "";
-  const workflowSlot = taskId.indexOf(":wf:");
-  if (workflowSlot !== -1) {
-    return `wf:${taskId.slice(0, workflowSlot)}`;
-  }
-  if (entry.agentSpawn?.workflowId) {
-    return `wf:${entry.agentSpawn.workflowId}`;
-  }
-  if (entry.isWorkflowCoordinator) {
-    return `wf:${taskId}`;
-  }
-  // No turn id means no batch signal at all: fall back to one group per
-  // task. Unrelated turn-less spawns (separate fleets whose rows lost their
-  // turn) must not collapse into one immortal "direct:no-turn" CTA
-  // accumulating every agent the thread ever ran (review finding). Adapters
-  // stamp spawn turns (Codex spawnTurnId; Claude rows ride real turns), so
-  // this path is defensive.
-  return entry.turnId ? `direct:${entry.turnId}` : `direct:task:${taskId}`;
-}
-
-function toolLifecycleCollapseMapKey(entry: DerivedWorkLogEntry): string | undefined {
-  if (
-    entry.sourceActivityKind !== "tool.updated" &&
-    entry.sourceActivityKind !== "tool.completed"
-  ) {
-    return undefined;
-  }
-  return entry.toolCallId ? `tool:${entry.turnId ?? "no-turn"}:${entry.toolCallId}` : undefined;
-}
-
-function collapseDerivedWorkLogEntries(
-  entries: ReadonlyArray<DerivedWorkLogEntry>,
-): DerivedWorkLogEntry[] {
-  const collapsed: DerivedWorkLogEntry[] = [];
-  // Subagent rows collapse by spawn group, not adjacency: a workflow run (or
-  // a turn's batch of direct spawns) is ONE narrative event in the chat — a
-  // CTA row that opens the Agents panel — no matter how many agents it
-  // contains or how their progress rows interleave (quiet-timeline
-  // guarantee).
-  const spawnRowIndex = new Map<string, number>();
-  // Batch membership is decided once, at the FIRST row seen for a taskId.
-  // Claude background subagents settle between turns, so their completion
-  // rows carry fresh synthetic turn ids (or none) — keying each row by its
-  // own turn splintered one batch into a stream of "Kicked off N subagents"
-  // rows (live-test finding, thread 7ac7ef05).
-  const groupKeyByTaskId = new Map<string, string>();
-  const toolLifecycleRowIndex = new Map<string, number>();
-  for (const entry of entries) {
-    const isTaskRow =
-      entry.taskId !== undefined &&
-      !entry.isBackgroundTask &&
-      (entry.sourceActivityKind === "task.started" ||
-        entry.sourceActivityKind === "task.progress" ||
-        entry.sourceActivityKind === "task.completed");
-    if (isTaskRow && entry.taskId !== undefined) {
-      const rememberedKey = groupKeyByTaskId.get(entry.taskId);
-      const groupKey = rememberedKey ?? agentSpawnGroupKey(entry);
-      if (rememberedKey === undefined) {
-        groupKeyByTaskId.set(entry.taskId, groupKey);
-      }
-      const workflowId = groupKey.startsWith("wf:") ? groupKey.slice(3) : null;
-      const existingIndex = spawnRowIndex.get(groupKey);
-      if (existingIndex !== undefined) {
-        const existing = collapsed[existingIndex]!;
-        const agentTaskIds = existing.agentSpawn?.agentTaskIds.includes(entry.taskId)
-          ? existing.agentSpawn.agentTaskIds
-          : [...(existing.agentSpawn?.agentTaskIds ?? []), entry.taskId];
-        collapsed[existingIndex] = {
-          ...mergeDerivedWorkLogEntries(existing, entry),
-          // The CTA row keeps the group's ANCHOR identity, not the last
-          // agent's: id/createdAt/turnId stay pinned to the spawn point so
-          // the row renders where the run launched instead of drifting to
-          // the newest progress tick (mid-run it drifted below the whole
-          // conversation, reading as "no visualization"), and the stable id
-          // keeps React state/virtualization sane.
-          id: existing.id,
-          createdAt: existing.createdAt,
-          turnId: existing.turnId ?? null,
-          ...(existing.taskId !== undefined ? { taskId: existing.taskId } : {}),
-          label: existing.label,
-          agentSpawn: { workflowId, agentTaskIds },
-        };
-        continue;
-      }
-      spawnRowIndex.set(groupKey, collapsed.length);
-      collapsed.push({
-        ...entry,
-        agentSpawn: { workflowId, agentTaskIds: [entry.taskId] },
-      });
-      continue;
-    }
-    const lifecycleKey = toolLifecycleCollapseMapKey(entry);
-    if (lifecycleKey !== undefined) {
-      const matchingLifecycleIndex = toolLifecycleRowIndex.get(lifecycleKey);
-      const matchingEntry =
-        matchingLifecycleIndex === undefined ? undefined : collapsed[matchingLifecycleIndex];
-      if (
-        matchingLifecycleIndex !== undefined &&
-        matchingEntry &&
-        shouldCollapseToolLifecycleEntries(matchingEntry, entry)
-      ) {
-        collapsed[matchingLifecycleIndex] = mergeDerivedWorkLogEntries(matchingEntry, entry);
-        continue;
-      }
-      toolLifecycleRowIndex.delete(lifecycleKey);
-    }
-    const previous = collapsed.at(-1);
-    if (previous && shouldCollapseToolLifecycleEntries(previous, entry)) {
-      const previousIndex = collapsed.length - 1;
-      const previousKey = toolLifecycleCollapseMapKey(previous);
-      if (previousKey !== undefined) toolLifecycleRowIndex.delete(previousKey);
-      const merged = mergeDerivedWorkLogEntries(previous, entry);
-      collapsed[previousIndex] = merged;
-      const mergedKey = toolLifecycleCollapseMapKey(merged);
-      if (mergedKey !== undefined) toolLifecycleRowIndex.set(mergedKey, previousIndex);
-      continue;
-    }
-    collapsed.push(entry);
-    if (lifecycleKey !== undefined) {
-      toolLifecycleRowIndex.set(lifecycleKey, collapsed.length - 1);
-    }
-  }
-  return collapsed;
+  return plan === undefined ? null : toLatestProposedPlanState(projection, plan);
 }
 
-function shouldCollapseToolLifecycleEntries(
-  previous: DerivedWorkLogEntry,
-  next: DerivedWorkLogEntry,
-): boolean {
-  if (
-    previous.sourceActivityKind !== "tool.updated" &&
-    previous.sourceActivityKind !== "tool.completed"
-  ) {
-    return false;
-  }
-  if (next.sourceActivityKind !== "tool.updated" && next.sourceActivityKind !== "tool.completed") {
-    return false;
-  }
-  if (previous.turnId !== next.turnId) {
-    return false;
-  }
-  if (previous.sourceActivityKind === "tool.completed") {
-    return false;
-  }
-  if (
-    previous[workLogCollapseKey] !== undefined &&
-    previous[workLogCollapseKey] === next[workLogCollapseKey]
-  ) {
-    return true;
-  }
+export function findSidebarProposedPlan(input: {
+  readonly threads: ReadonlyArray<{
+    readonly id: ThreadId;
+    readonly projection: OrchestrationV2ThreadProjection;
+  }>;
+  readonly latestRun: Pick<ThreadRunSummary, "runId" | "sourcePlanRef"> | null;
+  readonly latestRunSettled: boolean;
+  readonly threadId: ThreadId | string | null | undefined;
+}): LatestProposedPlanState | null {
+  if (!input.latestRunSettled && input.latestRun?.sourcePlanRef !== undefined) {
+    const source = input.latestRun.sourcePlanRef;
+    const sourceProjection = input.threads.find(
+      (thread) => thread.id === source.threadId,
+    )?.projection;
+    const plan = sourceProjection?.plans.find(
+      (candidate) => candidate.kind === "proposed_plan" && candidate.id === source.planId,
+    );
+    if (sourceProjection !== undefined && plan?.kind === "proposed_plan") {
+      return toLatestProposedPlanState(sourceProjection, plan);
+    }
+  }
+  const activeProjection = input.threads.find((thread) => thread.id === input.threadId)?.projection;
+  return findLatestProposedPlan(activeProjection ?? null, input.latestRun?.runId);
+}
+
+export function hasActionableProposedPlan(plan: LatestProposedPlanState | null): boolean {
+  return plan?.status === "active";
+}
+
+const STANDALONE_V2_ITEM_TYPES = new Set<OrchestrationV2ProjectedTurnItem["item"]["type"]>([
+  "approval_request",
+  "compaction",
+  "fork",
+  "handoff",
+  "run_interrupt_request",
+  "run_interrupt_result",
+  "subagent",
+  "thread_created",
+  "user_input_request",
+]);
+
+const PERSISTENT_RESOURCE_V2_ITEM_TYPES = new Set<OrchestrationV2TurnItem["type"]>([
+  "fork",
+  "subagent",
+  "thread_created",
+]);
+
+export function timelineEntryIsPersistentResourceCard(entry: TimelineEntry): boolean {
   return (
-    previous.toolCallId !== undefined &&
-    next.toolCallId === undefined &&
-    previous.itemType === next.itemType &&
-    normalizeCompactToolLabel(previous.toolTitle ?? previous.label) ===
-      normalizeCompactToolLabel(next.toolTitle ?? next.label)
+    entry.kind === "event" && PERSISTENT_RESOURCE_V2_ITEM_TYPES.has(entry.projectedItem.item.type)
   );
 }
 
-function mergeDerivedWorkLogEntries(
-  previous: DerivedWorkLogEntry,
-  next: DerivedWorkLogEntry,
-): DerivedWorkLogEntry {
-  const changedFiles = mergeChangedFiles(previous.changedFiles, next.changedFiles);
-  const detail = next.detail ?? previous.detail;
-  const command = next.command ?? previous.command;
-  const rawCommand = next.rawCommand ?? previous.rawCommand;
-  const toolTitle = next.toolTitle ?? previous.toolTitle;
-  const itemType = next.itemType ?? previous.itemType;
-  const requestKind = next.requestKind ?? previous.requestKind;
-  const collapseKey = next[workLogCollapseKey] ?? previous[workLogCollapseKey];
-  const toolCallId = next.toolCallId ?? previous.toolCallId;
-  const toolLifecycleStatus = next.toolLifecycleStatus ?? previous.toolLifecycleStatus;
-  const toolData = next.toolData ?? previous.toolData;
-  return {
-    ...previous,
-    ...next,
-    ...(detail ? { detail } : {}),
-    ...(command ? { command } : {}),
-    ...(rawCommand ? { rawCommand } : {}),
-    ...(changedFiles.length > 0 ? { changedFiles } : {}),
-    ...(toolTitle ? { toolTitle } : {}),
-    ...(itemType ? { itemType } : {}),
-    ...(requestKind ? { requestKind } : {}),
-    ...(collapseKey ? { [workLogCollapseKey]: collapseKey } : {}),
-    ...(toolCallId ? { toolCallId } : {}),
-    ...(toolLifecycleStatus !== undefined ? { toolLifecycleStatus } : {}),
-    ...(toolData !== undefined ? { toolData } : {}),
-  };
-}
-
-function mergeChangedFiles(
-  previous: ReadonlyArray<string> | undefined,
-  next: ReadonlyArray<string> | undefined,
-): string[] {
-  const merged = [...(previous ?? []), ...(next ?? [])];
-  if (merged.length === 0) {
-    return [];
-  }
-  return [...new Set(merged)];
-}
-
-function deriveToolLifecycleCollapseKey(entry: DerivedWorkLogEntry): string | undefined {
-  // Subagent lifecycle rows collapse by agent identity: one row per agent,
-  // progress ticks fold into it, the terminal row wins the label.
-  if (
-    entry.taskId &&
-    (entry.sourceActivityKind === "task.progress" || entry.sourceActivityKind === "task.completed")
-  ) {
-    return `task${entry.taskId}`;
-  }
-  if (
-    entry.sourceActivityKind !== "tool.updated" &&
-    entry.sourceActivityKind !== "tool.completed"
-  ) {
-    return undefined;
-  }
-  if (entry.toolCallId) {
-    return `tool:${entry.turnId ?? "no-turn"}:${entry.toolCallId}`;
-  }
-  const normalizedLabel = normalizeCompactToolLabel(entry.toolTitle ?? entry.label);
-  const detail = entry.detail?.trim() ?? "";
-  const itemType = entry.itemType ?? "";
-  if (normalizedLabel.length === 0 && detail.length === 0 && itemType.length === 0) {
-    return undefined;
-  }
-  return [itemType, normalizedLabel, detail].join("\u001f");
-}
-
-function normalizeCompactToolLabel(value: string): string {
-  return value.replace(/\s+(?:complete|completed)\s*$/i, "").trim();
-}
-
-function toLatestProposedPlanState(proposedPlan: ProposedPlan): LatestProposedPlanState {
-  return {
-    id: proposedPlan.id,
-    createdAt: proposedPlan.createdAt,
-    updatedAt: proposedPlan.updatedAt,
-    turnId: proposedPlan.turnId,
-    planMarkdown: proposedPlan.planMarkdown,
-    implementedAt: proposedPlan.implementedAt,
-    implementationThreadId: proposedPlan.implementationThreadId,
-  };
-}
-
-function asRecord(value: unknown): Record<string, unknown> | null {
-  return value && typeof value === "object" ? (value as Record<string, unknown>) : null;
-}
-
-function asTrimmedString(value: unknown): string | null {
-  if (typeof value !== "string") {
-    return null;
-  }
-  const trimmed = value.trim();
-  return trimmed.length > 0 ? trimmed : null;
-}
-
-function asNumber(value: unknown): number | null {
-  return typeof value === "number" && Number.isFinite(value) ? value : null;
-}
-
-function trimMatchingOuterQuotes(value: string): string {
-  const trimmed = value.trim();
-  if (
-    (trimmed.startsWith("'") && trimmed.endsWith("'")) ||
-    (trimmed.startsWith('"') && trimmed.endsWith('"'))
-  ) {
-    const unquoted = trimmed.slice(1, -1).trim();
-    return unquoted.length > 0 ? unquoted : trimmed;
-  }
-  return trimmed;
-}
-
-function executableBasename(value: string): string | null {
-  const trimmed = trimMatchingOuterQuotes(value);
-  if (trimmed.length === 0) {
-    return null;
+function projectedItemCreatedAt(row: OrchestrationV2ProjectedTurnItem): string {
+  return DateTime.formatIso(row.item.startedAt ?? row.item.updatedAt);
+}
+
+function projectedWorkEntryStatus(
+  item: OrchestrationV2TurnItem,
+): NonNullable<WorkLogEntry["toolLifecycleStatus"]> {
+  switch (item.status) {
+    case "pending":
+    case "running":
+    case "waiting":
+      return "inProgress";
+    case "completed":
+      return "completed";
+    case "failed":
+      return "failed";
+    case "cancelled":
+    case "interrupted":
+      return "stopped";
+  }
+}
+
+function projectedWorkEntryTone(item: OrchestrationV2TurnItem): WorkLogEntry["tone"] {
+  if (item.type === "error") return "info";
+  if (item.type === "reasoning") return "thinking";
+  switch (item.type) {
+    case "command_execution":
+    case "file_change":
+    case "file_search":
+    case "web_search":
+    case "dynamic_tool":
+    case "subagent":
+      return "tool";
+    default:
+      return "info";
   }
-  const normalized = trimmed.replace(/\\/g, "/");
-  const segments = normalized.split("/");
-  const last = segments.at(-1)?.trim() ?? "";
-  return last.length > 0 ? last.toLowerCase() : null;
 }
 
-function splitExecutableAndRest(value: string): { executable: string; rest: string } | null {
-  const trimmed = value.trim();
-  if (trimmed.length === 0) {
-    return null;
-  }
-
-  if (trimmed.startsWith('"') || trimmed.startsWith("'")) {
-    const quote = trimmed.charAt(0);
-    const closeIndex = trimmed.indexOf(quote, 1);
-    if (closeIndex <= 0) {
-      return null;
-    }
-    return {
-      executable: trimmed.slice(0, closeIndex + 1),
-      rest: trimmed.slice(closeIndex + 1).trim(),
-    };
-  }
-
-  const firstWhitespace = trimmed.search(/\s/);
-  if (firstWhitespace < 0) {
+export function providerErrorPresentation(
+  item: Extract<OrchestrationV2TurnItem, { readonly type: "error" }>,
+): { readonly label: string; readonly detail: string } {
+  if (item.retry === undefined) {
     return {
-      executable: trimmed,
-      rest: "",
+      label: item.title?.trim() || "Provider error",
+      detail: item.failure.message,
     };
   }
-
+  const progress =
+    item.retry.maxAttempts === null
+      ? `${item.retry.attempt}`
+      : `${item.retry.attempt}/${item.retry.maxAttempts}`;
+  const label =
+    item.status === "running"
+      ? `Retrying provider (${progress})`
+      : item.status === "completed"
+        ? `Provider recovered (${progress} retries)`
+        : item.status === "failed"
+          ? `Provider error after ${progress} retries`
+          : `Provider retry stopped (${progress})`;
+  const retryDelay =
+    item.status === "running" && item.retry.retryDelayMs !== null && item.retry.retryDelayMs > 0
+      ? item.retry.retryDelayMs < 1_000
+        ? ` Retrying in ${item.retry.retryDelayMs}ms.`
+        : ` Retrying in ${(item.retry.retryDelayMs / 1_000).toFixed(1).replace(/\.0$/u, "")}s.`
+      : "";
   return {
-    executable: trimmed.slice(0, firstWhitespace),
-    rest: trimmed.slice(firstWhitespace).trim(),
+    label,
+    detail: `${item.failure.message}${retryDelay}`,
   };
 }
 
-const SHELL_WRAPPER_SPECS = [
-  {
-    executables: ["pwsh", "pwsh.exe", "powershell", "powershell.exe"],
-    wrapperFlagPattern: /(?:^|\s)-command\s+/i,
-  },
-  {
-    executables: ["cmd", "cmd.exe"],
-    wrapperFlagPattern: /(?:^|\s)\/c\s+/i,
-  },
-  {
-    executables: ["bash", "sh", "zsh"],
-    wrapperFlagPattern: /(?:^|\s)-(?:l)?c\s+/i,
-  },
-] as const;
-
-function findShellWrapperSpec(shell: string) {
-  return SHELL_WRAPPER_SPECS.find((spec) =>
-    (spec.executables as ReadonlyArray<string>).includes(shell),
-  );
-}
-
-function unwrapCommandRemainder(value: string, wrapperFlagPattern: RegExp): string | null {
-  const match = wrapperFlagPattern.exec(value);
-  if (!match) {
-    return null;
-  }
-
-  const command = value.slice(match.index + match[0].length).trim();
-  if (command.length === 0) {
-    return null;
-  }
-
-  const unwrapped = trimMatchingOuterQuotes(command);
-  return unwrapped.length > 0 ? unwrapped : null;
-}
-
-function unwrapKnownShellCommandWrapper(value: string): string {
-  const split = splitExecutableAndRest(value);
-  if (!split || split.rest.length === 0) {
-    return value;
-  }
-
-  const shell = executableBasename(split.executable);
-  if (!shell) {
-    return value;
-  }
-
-  const spec = findShellWrapperSpec(shell);
-  if (!spec) {
-    return value;
-  }
-
-  return unwrapCommandRemainder(split.rest, spec.wrapperFlagPattern) ?? value;
-}
-
-function formatCommandArrayPart(value: string): string {
-  return /[\s"'`]/.test(value) ? `"${value.replace(/"/g, '\\"')}"` : value;
-}
-
-function formatCommandValue(value: unknown): string | null {
-  const direct = asTrimmedString(value);
-  if (direct) {
-    return direct;
-  }
-  if (!Array.isArray(value)) {
-    return null;
-  }
-  const parts: Array<string> = [];
-  for (const entry of value) {
-    const part = asTrimmedString(entry);
-    if (part !== null) {
-      parts.push(part);
+function projectedWorkEntry(row: OrchestrationV2ProjectedTurnItem): WorkLogEntry {
+  const { item } = row;
+  const title = item.title?.trim() || null;
+  const common = {
+    id: item.id,
+    createdAt: projectedItemCreatedAt(row),
+    runId: item.runId,
+    tone: projectedWorkEntryTone(item),
+    itemType: item.type,
+    toolLifecycleStatus: projectedWorkEntryStatus(item),
+    structuredPayload: item,
+    projectedItem: row,
+  } as const;
+
+  switch (item.type) {
+    case "reasoning":
+      return {
+        ...common,
+        label: title ?? "Thinking",
+        ...(item.text ? { detail: item.text } : {}),
+      };
+    case "command_execution":
+      return {
+        ...common,
+        label: title ?? "Ran command",
+        command: item.input,
+        rawCommand: item.input,
+        ...(item.output ? { detail: item.output } : {}),
+        toolTitle: title ?? "Command",
+        toolData: item,
+      };
+    case "file_change": {
+      const detail = item.diffStr ?? item.newStr;
+      return {
+        ...common,
+        label: title ?? `Changed ${item.fileName}`,
+        changedFiles: [item.fileName],
+        ...(detail ? { detail } : {}),
+        toolTitle: title ?? "File change",
+        toolData: item,
+      };
     }
+    case "file_search":
+      return {
+        ...common,
+        label: title ?? "Searched files",
+        ...(item.pattern ? { detail: item.pattern } : {}),
+        toolTitle: title ?? "File search",
+        toolData: item,
+      };
+    case "web_search":
+      return {
+        ...common,
+        label: title ?? "Searched the web",
+        ...(item.patterns?.length ? { detail: item.patterns.join(", ") } : {}),
+        toolTitle: title ?? "Web search",
+        toolData: item,
+      };
+    case "checkpoint":
+      return {
+        ...common,
+        label: title ?? "Checkpoint captured",
+        changedFiles: item.files.map((file) => file.path),
+        toolData: item,
+      };
+    case "error": {
+      const presentation = providerErrorPresentation(item);
+      return {
+        ...common,
+        ...presentation,
+        toolData: item,
+      };
+    }
+    case "dynamic_tool":
+      return {
+        ...common,
+        label: title ?? item.toolName ?? "Tool call",
+        toolTitle: title ?? item.toolName ?? "Tool",
+        toolData: { input: item.input, output: item.output },
+      };
+    default:
+      return {
+        ...common,
+        label: title ?? item.type.replaceAll("_", " "),
+        toolData: item,
+      };
   }
-  if (parts.length === 0) {
-    return null;
-  }
-  return parts.map((part) => formatCommandArrayPart(part)).join(" ");
-}
-
-function normalizeCommandValue(value: unknown): string | null {
-  const formatted = formatCommandValue(value);
-  return formatted ? unwrapKnownShellCommandWrapper(formatted) : null;
-}
-
-function toRawToolCommand(value: unknown, normalizedCommand: string | null): string | null {
-  const formatted = formatCommandValue(value);
-  if (!formatted || normalizedCommand === null) {
-    return null;
-  }
-  return formatted === normalizedCommand ? null : formatted;
 }
 
-function extractToolCommand(payload: Record<string, unknown> | null): {
-  command: string | null;
-  rawCommand: string | null;
-} {
-  const data = asRecord(payload?.data);
-  const item = asRecord(data?.item);
-  const itemResult = asRecord(item?.result);
-  const itemInput = asRecord(item?.input);
-  const itemType = asTrimmedString(payload?.itemType);
-  const detail = asTrimmedString(payload?.detail);
-  const candidates: unknown[] = [
-    item?.command,
-    itemInput?.command,
-    itemResult?.command,
-    data?.command,
-    itemType === "command_execution" && detail ? stripTrailingExitCode(detail).output : null,
-  ];
-
-  for (const candidate of candidates) {
-    const command = normalizeCommandValue(candidate);
-    if (!command) {
-      continue;
+/**
+ * Builds the web timeline in the exact order committed by `visibleTurnItems`.
+ * Committed rows are presented directly from their projected item. Queued
+ * input is absent by construction until dispatch creates its user turn item.
+ * Persistent client-owned messages are inserted by timestamp without sorting
+ * the canonical sequence. True optimistic sends remain appended afterward.
+ */
+export function deriveTimelineEntriesFromVisibleTurnItems(input: {
+  readonly visibleTurnItems: ReadonlyArray<OrchestrationV2ProjectedTurnItem>;
+  readonly optimisticMessages: ReadonlyArray<ChatMessage>;
+  readonly anchoredMessages?: ReadonlyArray<ChatMessage>;
+  readonly attachmentUrlById?: ReadonlyMap<string, string>;
+  readonly attempts?: ReadonlyArray<OrchestrationV2RunAttempt>;
+  readonly nodes?: ReadonlyArray<OrchestrationV2ExecutionNode>;
+  readonly plans?: ReadonlyArray<OrchestrationV2PlanArtifact>;
+}): TimelineEntry[] {
+  const committedMessageIds = new Set<string>();
+  const entries: TimelineEntry[] = [];
+  const attemptByRootNodeId = new Map(
+    (input.attempts ?? []).map((attempt) => [attempt.rootNodeId, attempt] as const),
+  );
+  const nodeById = new Map((input.nodes ?? []).map((node) => [node.id, node] as const));
+  const planById = new Map((input.plans ?? []).map((plan) => [plan.id, plan] as const));
+
+  const resolveAttempt = (item: OrchestrationV2TurnItem): TimelineAttempt | undefined => {
+    if (item.nodeId === null || item.runId === null) return undefined;
+    let nodeId: OrchestrationV2ExecutionNode["id"] | null = item.nodeId;
+    const visited = new Set<OrchestrationV2ExecutionNode["id"]>();
+    while (nodeId !== null && !visited.has(nodeId)) {
+      visited.add(nodeId);
+      const directAttempt = attemptByRootNodeId.get(nodeId);
+      if (directAttempt?.runId === item.runId) return directAttempt;
+      const node = nodeById.get(nodeId);
+      if (node === undefined) return undefined;
+      const rootAttempt = attemptByRootNodeId.get(node.rootNodeId);
+      if (rootAttempt?.runId === item.runId) return rootAttempt;
+      nodeId = node.parentNodeId;
     }
-    return {
-      command,
-      rawCommand: toRawToolCommand(candidate, command),
-    };
-  }
-
-  return {
-    command: null,
-    rawCommand: null,
+    return undefined;
   };
-}
-
-function extractToolTitle(payload: Record<string, unknown> | null): string | null {
-  return asTrimmedString(payload?.title);
-}
-
-function extractToolCallId(payload: Record<string, unknown> | null): string | null {
-  const data = asRecord(payload?.data);
-  return asTrimmedString(payload?.toolCallId) ?? asTrimmedString(data?.toolCallId);
-}
-
-function normalizeInlinePreview(value: string): string {
-  return value.replace(/\s+/g, " ").trim();
-}
 
-function truncateInlinePreview(value: string, maxLength = 84): string {
-  if (value.length <= maxLength) {
-    return value;
-  }
-  return `${value.slice(0, maxLength - 1).trimEnd()}…`;
-}
-
-function normalizePreviewForComparison(value: string | null | undefined): string | null {
-  const normalized = asTrimmedString(value);
-  if (!normalized) {
-    return null;
-  }
-  return normalizeCompactToolLabel(normalizeInlinePreview(normalized)).toLowerCase();
-}
-
-function summarizeToolTextOutput(value: string): string | null {
-  const lines: Array<string> = [];
-  for (const rawLine of value.split(/\r?\n/u)) {
-    const line = normalizeInlinePreview(rawLine);
-    if (line.length > 0) {
-      lines.push(line);
+  for (const row of input.visibleTurnItems) {
+    const { item } = row;
+    if (turnItemIsWorkspacePreparation(item)) continue;
+    const createdAt = projectedItemCreatedAt(row);
+    const attempt = resolveAttempt(item);
+    const attemptMetadata = attempt === undefined ? {} : { attempt };
+    if (item.type === "user_message" || item.type === "assistant_message") {
+      const message: ChatMessage = {
+        id: item.messageId,
+        role: item.type === "user_message" ? "user" : "assistant",
+        text: item.text,
+        ...(item.type === "user_message" && item.attachments.length > 0
+          ? {
+              attachments: item.attachments.map((attachment) => {
+                const previewUrl = input.attachmentUrlById?.get(attachment.id);
+                return previewUrl ? { ...attachment, previewUrl } : attachment;
+              }),
+            }
+          : {}),
+        runId: item.runId,
+        streaming: item.type === "assistant_message" && item.streaming,
+        ...(item.type === "user_message"
+          ? { createdBy: item.createdBy, creationSource: item.creationSource }
+          : {}),
+        createdAt,
+        updatedAt: DateTime.formatIso(item.updatedAt),
+        ...(item.type === "user_message" ? { inputIntent: item.inputIntent } : {}),
+      };
+      committedMessageIds.add(message.id);
+      entries.push({
+        id: message.id,
+        kind: "message",
+        createdAt,
+        message,
+        projectedItem: row,
+        ...attemptMetadata,
+      });
+      continue;
     }
-  }
-  const firstLine = lines.find((line) => line !== "```");
-  if (firstLine) {
-    return truncateInlinePreview(firstLine);
-  }
-  if (lines.length > 1) {
-    return `${lines.length.toLocaleString()} lines`;
-  }
-  return null;
-}
-
-function summarizeToolRawOutput(payload: Record<string, unknown> | null): string | null {
-  const data = asRecord(payload?.data);
-  const rawOutput = asRecord(data?.rawOutput);
-  if (!rawOutput) {
-    return null;
-  }
 
-  const totalFiles = asNumber(rawOutput.totalFiles);
-  if (totalFiles !== null) {
-    const suffix = rawOutput.truncated === true ? "+" : "";
-    return `${totalFiles.toLocaleString()} file${totalFiles === 1 ? "" : "s"}${suffix}`;
-  }
-
-  const content = asTrimmedString(rawOutput.content);
-  if (content) {
-    return summarizeToolTextOutput(content);
-  }
-
-  const stdout = asTrimmedString(rawOutput.stdout);
-  if (stdout) {
-    return summarizeToolTextOutput(stdout);
-  }
-
-  return null;
-}
-
-function extractAcpTextContent(value: unknown): string | null {
-  if (!Array.isArray(value)) {
-    return null;
-  }
-
-  const chunks: string[] = [];
-  for (const entryValue of value) {
-    const entry = asRecord(entryValue);
-    if (entry?.type !== "content") {
+    if (item.type === "proposed_plan") {
+      const plan = planById.get(item.planId);
+      const proposedPlan = {
+        id: item.planId,
+        runId: item.runId,
+        planMarkdown: item.markdown,
+        status: plan?.kind === "proposed_plan" ? plan.status : ("active" as const),
+        createdAt,
+        updatedAt: DateTime.formatIso(item.updatedAt),
+      };
+      entries.push({
+        id: item.id,
+        kind: "proposed-plan",
+        createdAt,
+        proposedPlan,
+        ...attemptMetadata,
+      });
       continue;
     }
-    const content = asRecord(entry.content);
-    if (content?.type !== "text") {
+
+    if (item.type === "todo_list") {
+      // One inline plan chip per todo list; the item rewrites in place as
+      // steps progress, so the chip stays anchored where planning began. A
+      // snapshot with no steps means the plan was withdrawn — no chip.
+      const artifact = planById.get(item.planId);
+      const steps = artifact?.kind === "todo_list" ? artifact.steps : item.steps;
+      const explanation =
+        (artifact?.kind === "todo_list" ? artifact.explanation : undefined) ?? item.explanation;
+      if (steps.length === 0) continue;
+      entries.push({
+        id: item.id,
+        kind: "turn-plan",
+        createdAt,
+        turnPlan: {
+          id: `turn-plan:${item.planId}`,
+          createdAt,
+          runId: item.runId,
+          plan: {
+            createdAt,
+            runId: item.runId,
+            explanation: explanation ?? null,
+            steps: steps.map(({ text, status }) => ({
+              step: text,
+              status: status === "running" ? "inProgress" : status,
+            })),
+          },
+        },
+        ...attemptMetadata,
+      });
       continue;
     }
-    const text = asTrimmedString(content.text);
-    if (text) {
-      chunks.push(text);
-    }
-  }
-
-  return chunks.length > 0 ? chunks.join("\n") : null;
-}
-
-function extractToolOutput(payload: Record<string, unknown> | null): string | null {
-  const data = asRecord(payload?.data);
-  const item = asRecord(data?.item);
-  const itemResult = asRecord(item?.result);
-  const rawOutput = asRecord(data?.rawOutput);
-
-  const outputStreams: string[] = [];
-  const stdout = asTrimmedString(rawOutput?.stdout);
-  const stderr = asTrimmedString(rawOutput?.stderr);
-  if (stdout) {
-    outputStreams.push(stdout);
-  }
-  if (stderr) {
-    outputStreams.push(stderr);
-  }
 
-  const candidates: unknown[] = [
-    item?.aggregatedOutput,
-    itemResult?.content,
-    data?.rawOutput,
-    rawOutput?.content,
-    outputStreams.length > 0 ? outputStreams.join("\n") : null,
-    rawOutput?.output,
-    extractAcpTextContent(data?.content),
-  ];
-
-  for (const candidate of candidates) {
-    const text = asTrimmedString(candidate);
-    if (!text) {
+    if (STANDALONE_V2_ITEM_TYPES.has(item.type)) {
+      entries.push({
+        id: item.id,
+        kind: "event",
+        createdAt,
+        projectedItem: row,
+        ...attemptMetadata,
+      });
       continue;
     }
-    const output = stripTrailingExitCode(text).output;
-    if (output) {
-      return output;
-    }
-  }
 
-  return null;
-}
-
-function isCommandToolDetail(payload: Record<string, unknown> | null, heading: string): boolean {
-  const data = asRecord(payload?.data);
-  const kind = asTrimmedString(data?.kind)?.toLowerCase();
-  const title = asTrimmedString(payload?.title ?? heading)?.toLowerCase();
-  return (
-    extractWorkLogItemType(payload) === "command_execution" ||
-    kind === "execute" ||
-    title === "terminal" ||
-    title === "ran command"
-  );
-}
-
-function extractToolDetail(
-  payload: Record<string, unknown> | null,
-  heading: string,
-): string | null {
-  const rawDetail = asTrimmedString(payload?.detail);
-  const detail = rawDetail ? stripTrailingExitCode(rawDetail).output : null;
-  const normalizedHeading = normalizePreviewForComparison(heading);
-  const normalizedDetail = normalizePreviewForComparison(detail);
-  const commandTool = isCommandToolDetail(payload, heading);
-  const commandPreview = commandTool
-    ? extractToolCommand(payload)
-    : { command: null, rawCommand: null };
-  const command = commandPreview.command;
-  const normalizedCommand = normalizePreviewForComparison(command);
-  const normalizedRawCommand = normalizePreviewForComparison(commandPreview.rawCommand);
-
-  if (
-    detail &&
-    normalizedHeading !== normalizedDetail &&
-    (!commandTool ||
-      (normalizedCommand !== normalizedDetail && normalizedRawCommand !== normalizedDetail))
-  ) {
-    return detail;
+    entries.push({
+      id: item.id,
+      kind: "work",
+      createdAt,
+      entry: projectedWorkEntry(row),
+      ...attemptMetadata,
+    });
   }
 
-  if (commandTool) {
-    if (!command) {
-      return null;
-    }
-
-    const output = extractToolOutput(payload);
-    const normalizedOutput = normalizePreviewForComparison(output);
-    if (
-      output &&
-      normalizedOutput !== normalizedHeading &&
-      normalizedOutput !== normalizedCommand
-    ) {
-      return output;
+  const retainedMessageIds = new Set(committedMessageIds);
+  for (const message of input.anchoredMessages ?? []) {
+    if (retainedMessageIds.has(message.id)) continue;
+    retainedMessageIds.add(message.id);
+    const entry: TimelineEntry = {
+      id: message.id,
+      kind: "message",
+      createdAt: message.createdAt,
+      message,
+    };
+    const insertionIndex = entries.findIndex(
+      (candidate) => candidate.createdAt > message.createdAt,
+    );
+    if (insertionIndex === -1) {
+      entries.push(entry);
+    } else {
+      entries.splice(insertionIndex, 0, entry);
     }
-    return null;
   }
 
-  const rawOutputSummary = summarizeToolRawOutput(payload);
-  if (rawOutputSummary) {
-    const normalizedRawOutputSummary = normalizePreviewForComparison(rawOutputSummary);
-    if (normalizedRawOutputSummary !== normalizedHeading) {
-      return rawOutputSummary;
+  for (const message of input.optimisticMessages) {
+    if (message.inputIntent !== "queued_turn" && !retainedMessageIds.has(message.id)) {
+      retainedMessageIds.add(message.id);
+      entries.push({
+        id: message.id,
+        kind: "message",
+        createdAt: message.createdAt,
+        message,
+      });
     }
   }
 
-  return null;
+  return entries;
 }
 
-function stripTrailingExitCode(value: string): {
-  output: string | null;
-  exitCode?: number | undefined;
-} {
-  const trimmed = value.trim();
-  const match = /^(?<output>[\s\S]*?)(?:\s*<exited with exit code (?<code>\d+)>)\s*$/i.exec(
-    trimmed,
+export function inferCheckpointTurnCountByRunId(
+  summaries: ReadonlyArray<ThreadCheckpointSummary>,
+): Record<string, number> {
+  return Object.fromEntries(
+    summaries.flatMap((summary) =>
+      summary.runId === null ? [] : [[summary.runId, summary.checkpointTurnCount] as const],
+    ),
   );
-  if (!match?.groups) {
-    return {
-      output: trimmed.length > 0 ? trimmed : null,
-    };
-  }
-  const exitCode = Number.parseInt(match.groups.code ?? "", 10);
-  const normalizedOutput = match.groups.output?.trim() ?? "";
-  return {
-    output: normalizedOutput.length > 0 ? normalizedOutput : null,
-    ...(Number.isInteger(exitCode) ? { exitCode } : {}),
-  };
-}
-
-function extractWorkLogItemType(
-  payload: Record<string, unknown> | null,
-): WorkLogEntry["itemType"] | undefined {
-  if (typeof payload?.itemType === "string" && isToolLifecycleItemType(payload.itemType)) {
-    return payload.itemType;
-  }
-  return undefined;
 }
 
-function extractWorkLogRequestKind(
-  payload: Record<string, unknown> | null,
-): WorkLogEntry["requestKind"] | undefined {
-  if (
-    payload?.requestKind === "command" ||
-    payload?.requestKind === "file-read" ||
-    payload?.requestKind === "file-change"
-  ) {
-    return payload.requestKind;
-  }
-  return requestKindFromRequestType(payload?.requestType) ?? undefined;
-}
-
-function pushChangedFile(target: string[], seen: Set<string>, value: unknown) {
-  const normalized = asTrimmedString(value);
-  if (!normalized || seen.has(normalized)) {
-    return;
-  }
-  seen.add(normalized);
-  target.push(normalized);
-}
-
-function collectChangedFiles(value: unknown, target: string[], seen: Set<string>, depth: number) {
-  if (depth > 4 || target.length >= 12) {
-    return;
-  }
-  if (Array.isArray(value)) {
-    for (const entry of value) {
-      collectChangedFiles(entry, target, seen, depth + 1);
-      if (target.length >= 12) {
-        return;
-      }
+export function deriveRevertTurnCountByUserMessageId(input: {
+  readonly timelineEntries: ReadonlyArray<TimelineEntry>;
+  readonly checkpoints: ReadonlyArray<ThreadCheckpointSummary>;
+}): Map<ChatMessage["id"], number> {
+  const readyCheckpointByRunId = new Map<RunId, ThreadCheckpointSummary>();
+  for (const checkpoint of input.checkpoints) {
+    if (checkpoint.status === "ready") {
+      readyCheckpointByRunId.set(checkpoint.runId, checkpoint);
     }
-    return;
   }
-
-  const record = asRecord(value);
-  if (!record) {
-    return;
-  }
-
-  pushChangedFile(target, seen, record.path);
-  pushChangedFile(target, seen, record.filePath);
-  pushChangedFile(target, seen, record.relativePath);
-  pushChangedFile(target, seen, record.filename);
-  pushChangedFile(target, seen, record.newPath);
-  pushChangedFile(target, seen, record.oldPath);
-
-  for (const nestedKey of [
-    "item",
-    "result",
-    "input",
-    "data",
-    "changes",
-    "files",
-    "edits",
-    "patch",
-    "patches",
-    "operations",
-  ]) {
-    if (!(nestedKey in record)) {
+  const byUserMessageId = new Map<ChatMessage["id"], number>();
+  for (const entry of input.timelineEntries) {
+    if (entry.kind !== "message" || entry.message.role !== "user") continue;
+    if (entry.message.inputIntent !== "turn_start" && entry.message.inputIntent !== "queued_turn") {
       continue;
     }
-    collectChangedFiles(record[nestedKey], target, seen, depth + 1);
-    if (target.length >= 12) {
-      return;
-    }
-  }
-}
-
-function extractChangedFiles(payload: Record<string, unknown> | null): string[] {
-  const changedFiles: string[] = [];
-  const seen = new Set<string>();
-  collectChangedFiles(asRecord(payload?.data), changedFiles, seen, 0);
-  return changedFiles;
-}
-
-function compareActivitiesByOrder(
-  left: OrchestrationThreadActivity,
-  right: OrchestrationThreadActivity,
-): number {
-  if (left.sequence !== undefined && right.sequence !== undefined) {
-    if (left.sequence !== right.sequence) {
-      return left.sequence - right.sequence;
-    }
-  } else if (left.sequence !== undefined) {
-    return 1;
-  } else if (right.sequence !== undefined) {
-    return -1;
-  }
-
-  const createdAtComparison = left.createdAt.localeCompare(right.createdAt);
-  if (createdAtComparison !== 0) {
-    return createdAtComparison;
-  }
-
-  const lifecycleRankComparison =
-    compareActivityLifecycleRank(left.kind) - compareActivityLifecycleRank(right.kind);
-  if (lifecycleRankComparison !== 0) {
-    return lifecycleRankComparison;
+    if (entry.message.runId === null) continue;
+    const checkpoint = readyCheckpointByRunId.get(entry.message.runId);
+    if (checkpoint === undefined) continue;
+    byUserMessageId.set(entry.message.id, Math.max(0, checkpoint.checkpointTurnCount - 1));
   }
-
-  return left.id.localeCompare(right.id);
-}
-
-function compareActivityLifecycleRank(kind: string): number {
-  if (kind.endsWith(".started") || kind === "tool.started") {
-    return 0;
-  }
-  if (kind.endsWith(".progress") || kind.endsWith(".updated")) {
-    return 1;
-  }
-  if (kind.endsWith(".completed") || kind.endsWith(".resolved")) {
-    return 2;
-  }
-  return 1;
+  return byUserMessageId;
 }
 
-export function deriveTimelineEntries(
-  messages: ReadonlyArray<ChatMessage>,
-  proposedPlans: ReadonlyArray<ProposedPlan>,
-  workEntries: ReadonlyArray<WorkLogEntry>,
-  turnPlans: ReadonlyArray<TurnPlanEntry> = [],
-): TimelineEntry[] {
-  const messageRows: TimelineEntry[] = messages.map((message) => ({
-    id: message.id,
-    kind: "message",
-    createdAt: message.createdAt,
-    message,
-  }));
-  const proposedPlanRows: TimelineEntry[] = proposedPlans.map((proposedPlan) => ({
-    id: proposedPlan.id,
-    kind: "proposed-plan",
-    createdAt: proposedPlan.createdAt,
-    proposedPlan,
-  }));
-  const turnPlanRows: TimelineEntry[] = turnPlans.map((turnPlan) => ({
-    id: turnPlan.id,
-    kind: "turn-plan",
-    createdAt: turnPlan.createdAt,
-    turnPlan,
-  }));
-  const workRows: TimelineEntry[] = workEntries.map((entry) => ({
-    id: entry.id,
-    kind: "work",
-    createdAt: entry.createdAt,
-    entry,
-  }));
-  return [...messageRows, ...proposedPlanRows, ...turnPlanRows, ...workRows].toSorted((a, b) =>
-    a.createdAt.localeCompare(b.createdAt),
-  );
-}
-
-export function inferCheckpointTurnCountByTurnId(
-  summaries: ReadonlyArray<TurnDiffSummary>,
-): Record<TurnId, number> {
-  const sorted = [...summaries].toSorted((a, b) => a.completedAt.localeCompare(b.completedAt));
-  const result: Record<TurnId, number> = {};
-  for (let index = 0; index < sorted.length; index += 1) {
-    const summary = sorted[index];
-    if (!summary) continue;
-    result[summary.turnId] = index + 1;
-  }
-  return result;
-}
-
-export function derivePhase(session: ThreadSession | null): SessionPhase {
+export function derivePhase(runtime: ThreadRuntimeSummary | null): SessionPhase {
+  if (runtime === null) return "disconnected";
   if (
-    !session ||
-    session.status === "stopped" ||
-    session.status === "interrupted" ||
-    session.status === "error"
-  ) {
-    return "disconnected";
-  }
-  if (session.status === "starting") return "connecting";
-  if (session.status === "running") return "running";
+    runtime.status === "preparing" ||
+    runtime.status === "starting" ||
+    runtime.status === "queued"
+  )
+    return "connecting";
+  if (runtime.status === "running" || runtime.status === "waiting") return "running";
   return "ready";
 }
+
+export type { TurnDiffSummary };
diff --git a/apps/web/src/state/entities.ts b/apps/web/src/state/entities.ts
index 7bca31182379..3471499435d1 100644
--- a/apps/web/src/state/entities.ts
+++ b/apps/web/src/state/entities.ts
@@ -5,32 +5,23 @@ import type {
   EnvironmentThreadShell,
 } from "@t3tools/client-runtime/state/shell";
 import {
+  EMPTY_THREAD_HISTORY_META,
   type EnvironmentThreadStatus,
-  mergeEnvironmentThread,
+  type ThreadHistoryMeta,
 } from "@t3tools/client-runtime/state/threads";
-import type {
-  OrchestrationMessage,
-  OrchestrationProposedPlan,
-  OrchestrationSession,
-  OrchestrationThreadActivity,
-  ScopedProjectRef,
-  ScopedThreadRef,
-  ServerConfig,
-} from "@t3tools/contracts";
-import type { EnvironmentId, ThreadId } from "@t3tools/contracts";
+import type { ScopedProjectRef, ScopedThreadRef, ServerConfig } from "@t3tools/contracts";
+import type { EnvironmentId, OrchestrationV2ProjectedTurnItem, ThreadId } from "@t3tools/contracts";
 import { Atom } from "effect/unstable/reactivity";
-import { useMemo } from "react";
 import { appAtomRegistry } from "../rpc/atomRegistry";
 import { environmentProjects } from "./projects";
 import { environmentServerConfigsAtom } from "./server";
 import { allEnvironmentShellsBootstrappedAtom } from "./shell";
 import { environmentThreadDetails, environmentThreadShells } from "./threads";
+import { waitForAtomValue } from "./waitForAtomValue";
 
 const EMPTY_PROJECT_REFS: ReadonlyArray<ScopedProjectRef> = Object.freeze([]);
 const EMPTY_THREAD_REFS: ReadonlyArray<ScopedThreadRef> = Object.freeze([]);
-const EMPTY_MESSAGES: ReadonlyArray<OrchestrationMessage> = Object.freeze([]);
-const EMPTY_ACTIVITIES: ReadonlyArray<OrchestrationThreadActivity> = Object.freeze([]);
-const EMPTY_PROPOSED_PLANS: ReadonlyArray<OrchestrationProposedPlan> = Object.freeze([]);
+const EMPTY_VISIBLE_TURN_ITEMS: ReadonlyArray<OrchestrationV2ProjectedTurnItem> = Object.freeze([]);
 
 const EMPTY_PROJECT_ATOM = Atom.make<EnvironmentProject | null>(null).pipe(
   Atom.withLabel("web-project:empty"),
@@ -44,23 +35,17 @@ const EMPTY_THREAD_REFS_ATOM = Atom.make(EMPTY_THREAD_REFS).pipe(
 const EMPTY_THREAD_SHELL_ATOM = Atom.make<EnvironmentThreadShell | null>(null).pipe(
   Atom.withLabel("web-thread-shell:empty"),
 );
-const EMPTY_THREAD_DETAIL_ATOM = Atom.make<EnvironmentThread | null>(null).pipe(
-  Atom.withLabel("web-thread-detail:empty"),
+const EMPTY_THREAD_PROJECTION_ATOM = Atom.make<EnvironmentThread | null>(null).pipe(
+  Atom.withLabel("web-thread-projection:empty"),
 );
 const EMPTY_THREAD_STATUS_ATOM = Atom.make<EnvironmentThreadStatus>("empty").pipe(
   Atom.withLabel("web-thread-status:empty"),
 );
-const EMPTY_MESSAGES_ATOM = Atom.make(EMPTY_MESSAGES).pipe(
-  Atom.withLabel("web-thread-messages:empty"),
-);
-const EMPTY_ACTIVITIES_ATOM = Atom.make(EMPTY_ACTIVITIES).pipe(
-  Atom.withLabel("web-thread-activities:empty"),
-);
-const EMPTY_PROPOSED_PLANS_ATOM = Atom.make(EMPTY_PROPOSED_PLANS).pipe(
-  Atom.withLabel("web-thread-proposed-plans:empty"),
+const EMPTY_VISIBLE_TURN_ITEMS_ATOM = Atom.make(EMPTY_VISIBLE_TURN_ITEMS).pipe(
+  Atom.withLabel("web-thread-visible-turn-items:empty"),
 );
-const EMPTY_SESSION_ATOM = Atom.make<OrchestrationSession | null>(null).pipe(
-  Atom.withLabel("web-thread-session:empty"),
+const EMPTY_THREAD_HISTORY_ATOM = Atom.make<ThreadHistoryMeta>(EMPTY_THREAD_HISTORY_META).pipe(
+  Atom.withLabel("web-thread-history:empty"),
 );
 
 export const activeEnvironmentIdAtom = Atom.make<EnvironmentId | null>(null).pipe(
@@ -140,9 +125,9 @@ export function useThreadShell(ref: ScopedThreadRef | null): EnvironmentThreadSh
   );
 }
 
-export function useThreadDetail(ref: ScopedThreadRef | null): EnvironmentThread | null {
+export function useThreadProjection(ref: ScopedThreadRef | null): EnvironmentThread | null {
   return useAtomValue(
-    ref === null ? EMPTY_THREAD_DETAIL_ATOM : environmentThreadDetails.detailAtom(ref),
+    ref === null ? EMPTY_THREAD_PROJECTION_ATOM : environmentThreadDetails.threadAtom(ref),
   );
 }
 
@@ -152,6 +137,12 @@ export function useThreadStatus(ref: ScopedThreadRef | null): EnvironmentThreadS
   );
 }
 
+export function useThreadHistory(ref: ScopedThreadRef | null): ThreadHistoryMeta {
+  return useAtomValue(
+    ref === null ? EMPTY_THREAD_HISTORY_ATOM : environmentThreadDetails.historyAtom(ref),
+  );
+}
+
 export function resolveThreadDetailRef(
   ref: ScopedThreadRef | null,
   options: {
@@ -162,55 +153,13 @@ export function resolveThreadDetailRef(
   return ref !== null && (!options.waitForShell || options.shellExists) ? ref : null;
 }
 
-/** Detail collections composed with shell-authoritative thread/workspace metadata. */
-export function useThread(
-  ref: ScopedThreadRef | null,
-  options?: {
-    /**
-     * Client-reserved draft thread ids do not exist on the server until the
-     * first send. Waiting for the shell index avoids polling the detail
-     * endpoint for an intentionally missing thread during that window.
-     */
-    waitForShell?: boolean;
-  },
-): EnvironmentThread | null {
-  const shell = useThreadShell(ref);
-  const detail = useThreadDetail(
-    resolveThreadDetailRef(ref, {
-      shellExists: shell !== null,
-      waitForShell: options?.waitForShell === true,
-    }),
-  );
-  return useMemo(() => mergeEnvironmentThread(detail, shell), [detail, shell]);
-}
-
-export function useThreadMessages(
-  ref: ScopedThreadRef | null,
-): ReadonlyArray<OrchestrationMessage> {
-  return useAtomValue(
-    ref === null ? EMPTY_MESSAGES_ATOM : environmentThreadDetails.messagesAtom(ref),
-  );
-}
-
-export function useThreadActivities(
+export function useThreadVisibleTurnItems(
   ref: ScopedThreadRef | null,
-): ReadonlyArray<OrchestrationThreadActivity> {
+): ReadonlyArray<OrchestrationV2ProjectedTurnItem> {
   return useAtomValue(
-    ref === null ? EMPTY_ACTIVITIES_ATOM : environmentThreadDetails.activitiesAtom(ref),
-  );
-}
-
-export function useThreadProposedPlans(
-  ref: ScopedThreadRef | null,
-): ReadonlyArray<OrchestrationProposedPlan> {
-  return useAtomValue(
-    ref === null ? EMPTY_PROPOSED_PLANS_ATOM : environmentThreadDetails.proposedPlansAtom(ref),
-  );
-}
-
-export function useThreadSession(ref: ScopedThreadRef | null): OrchestrationSession | null {
-  return useAtomValue(
-    ref === null ? EMPTY_SESSION_ATOM : environmentThreadDetails.sessionAtom(ref),
+    ref === null
+      ? EMPTY_VISIBLE_TURN_ITEMS_ATOM
+      : environmentThreadDetails.visibleTurnItemsAtom(ref),
   );
 }
 
@@ -222,23 +171,13 @@ export function readThreadShell(ref: ScopedThreadRef): EnvironmentThreadShell |
   return appAtomRegistry.get(environmentThreadShells.threadShellAtom(ref));
 }
 
-/** Whether the environment's server understands thread.settle/unsettle.
-    False for pre-settlement servers (capability defaults false on decode),
-    so clients under version skew fall back instead of erroring. */
-export function readEnvironmentSupportsSettlement(environmentId: EnvironmentId): boolean {
-  return (
-    appAtomRegistry.get(environmentServerConfigsAtom).get(environmentId)?.environment.capabilities
-      .threadSettlement === true
-  );
-}
-
-/** Whether the environment's server understands thread.snooze/unsnooze.
-    Same version-skew contract as settlement. */
-export function readEnvironmentSupportsSnooze(environmentId: EnvironmentId): boolean {
-  return (
-    appAtomRegistry.get(environmentServerConfigsAtom).get(environmentId)?.environment.capabilities
-      .threadSnooze === true
-  );
+export function waitForThreadShell(ref: ScopedThreadRef, timeoutMs = 5_000): Promise<boolean> {
+  return waitForAtomValue({
+    registry: appAtomRegistry,
+    atom: environmentThreadShells.threadShellAtom(ref),
+    predicate: (thread) => thread !== null,
+    timeoutMs,
+  });
 }
 
 /** Whether the environment's server understands thread.pin/unpin.
@@ -268,8 +207,38 @@ export function readEnvironmentSupportsPinReorder(environmentId: EnvironmentId):
   );
 }
 
-export function readThreadDetail(ref: ScopedThreadRef): EnvironmentThread | null {
-  return appAtomRegistry.get(environmentThreadDetails.detailAtom(ref));
+export function readThreadProjection(ref: ScopedThreadRef): EnvironmentThread | null {
+  return appAtomRegistry.get(environmentThreadDetails.threadAtom(ref));
+}
+
+/** Whether the environment's server understands thread.settle/unsettle.
+    False for pre-settlement servers (capability defaults false on decode),
+    so clients under version skew fall back instead of erroring. */
+export function readEnvironmentSupportsSettlement(environmentId: EnvironmentId): boolean {
+  return (
+    appAtomRegistry.get(environmentServerConfigsAtom).get(environmentId)?.environment.capabilities
+      .threadSettlement === true
+  );
+}
+
+/** Whether the environment's server understands thread.snooze/unsnooze.
+    Same version-skew contract as settlement. */
+export function readEnvironmentSupportsSnooze(environmentId: EnvironmentId): boolean {
+  return (
+    appAtomRegistry.get(environmentServerConfigsAtom).get(environmentId)?.environment.capabilities
+      .threadSnooze === true
+  );
+}
+
+/** Whether the environment's server understands thread.visit/mark-unread and
+    projects lastVisitedAt on thread shells. Same version-skew contract as
+    settlement: against older servers, clients keep the browser-local visited
+    state instead. */
+export function readEnvironmentSupportsVisitedTracking(environmentId: EnvironmentId): boolean {
+  return (
+    appAtomRegistry.get(environmentServerConfigsAtom).get(environmentId)?.environment.capabilities
+      .threadVisitedTracking === true
+  );
 }
 
 export function readEnvironmentThreadRefs(
diff --git a/apps/web/src/state/queries.ts b/apps/web/src/state/queries.ts
index 094db94c4dcf..91ee86b337da 100644
--- a/apps/web/src/state/queries.ts
+++ b/apps/web/src/state/queries.ts
@@ -11,10 +11,8 @@ import {
 import { type VcsRefTarget } from "@t3tools/client-runtime/state/vcs";
 import type {
   EnvironmentId,
-  OrchestrationThread,
   ProjectContentMatch,
   ProjectEntryKind,
-  ThreadId,
   VcsListRefsResult,
   VcsRef,
 } from "@t3tools/contracts";
@@ -28,7 +26,6 @@ import { orchestrationEnvironment } from "./orchestration";
 import { isPaginatedBranchesNextPagePending } from "./paginatedBranches";
 import { projectContentSearch, projectEnvironment } from "./projects";
 import { useEnvironmentQuery } from "./query";
-import { useEnvironmentThread } from "./threads";
 import { vcsEnvironment } from "./vcs";
 
 const PROJECT_PATH_SEARCH_DEBOUNCE_MS = 120;
@@ -55,14 +52,6 @@ const threadSearchResultsAtom = createThreadSearchResultsAtomFamily({
   labelPrefix: "web:thread-search",
 });
 
-export interface ThreadDetailView {
-  readonly data: OrchestrationThread | null;
-  readonly error: string | null;
-  readonly isPending: boolean;
-  readonly isDeleted: boolean;
-}
-
-/** Shared with the pull requests page, which debounces its search the same way. */
 export function useDebouncedValue<A>(value: A, delayMs: number): A {
   const [debounced, setDebounced] = useState(value);
 
@@ -103,19 +92,6 @@ export function useThreadSearch(
   };
 }
 
-export function useThreadDetail(
-  environmentId: EnvironmentId | null,
-  threadId: ThreadId | null,
-): ThreadDetailView {
-  const state = useEnvironmentThread(environmentId, threadId);
-  return {
-    data: Option.getOrNull(state.data),
-    error: Option.getOrNull(state.error),
-    isPending: state.status === "synchronizing",
-    isDeleted: state.status === "deleted",
-  };
-}
-
 export function useBranches(target: VcsRefTarget) {
   const query = target.query?.trim() ?? "";
   return useEnvironmentQuery(
diff --git a/apps/web/src/state/server.ts b/apps/web/src/state/server.ts
index 991abc3bc2e2..92b48c410285 100644
--- a/apps/web/src/state/server.ts
+++ b/apps/web/src/state/server.ts
@@ -4,6 +4,7 @@ import {
   type EnvironmentTheme,
   type ServerConfig,
   type ServerConfigStreamEvent,
+  type ServerLifecycleLegacyThreadMigrationPayload,
   type ServerLifecycleWelcomePayload,
   type ServerProvider,
   type ServerSettings,
@@ -79,6 +80,18 @@ export const primaryServerWelcomeAtom = Atom.make(
   (get): ServerLifecycleWelcomePayload | null => get(primaryServerStateAtom).welcome,
 ).pipe(Atom.withLabel("web-primary-server-welcome"));
 
+export const primaryServerLegacyThreadMigrationAtom = Atom.make(
+  (get): ServerLifecycleLegacyThreadMigrationPayload | null => {
+    const environmentId = get(primaryEnvironmentIdAtom);
+    if (environmentId === null) {
+      return null;
+    }
+    return Option.getOrNull(
+      AsyncResult.value(get(serverEnvironment.legacyThreadMigration({ environmentId, input: {} }))),
+    );
+  },
+).pipe(Atom.withLabel("web-primary-server-legacy-thread-migration"));
+
 export const primaryServerSettingsAtom = Atom.make(
   (get): ServerSettings => get(primaryServerConfigAtom)?.settings ?? DEFAULT_SERVER_SETTINGS,
 ).pipe(Atom.withLabel("web-primary-server-settings"));
diff --git a/apps/web/src/state/sourceControlActions.ts b/apps/web/src/state/sourceControlActions.ts
index 297ae5717df1..5f0b7e9330f1 100644
--- a/apps/web/src/state/sourceControlActions.ts
+++ b/apps/web/src/state/sourceControlActions.ts
@@ -191,7 +191,7 @@ export function useVcsPullAction(scope: SourceControlActionScope) {
   }, [pull, scope]);
   return useAction({
     kind: "pull",
-    label: "Pulling latest changes",
+    label: "Pulling latest changes...",
     scope,
     action,
     onSuccess: status.refresh,
diff --git a/apps/web/src/state/threads.ts b/apps/web/src/state/threads.ts
index fd936f99ff23..d64a6ac2163d 100644
--- a/apps/web/src/state/threads.ts
+++ b/apps/web/src/state/threads.ts
@@ -38,8 +38,9 @@ export function useEnvironmentThread(
       ? environmentThreads.stateAtom(environmentId, threadId)
       : EMPTY_THREAD_STATE_ATOM,
   );
-  return Option.getOrElse(
+  const state = Option.getOrElse(
     AsyncResult.value(result),
     () => EMPTY_ENVIRONMENT_THREAD_STATE,
   ) as EnvironmentThreadState;
+  return state;
 }
diff --git a/apps/web/src/state/v2ItemSupport.ts b/apps/web/src/state/v2ItemSupport.ts
new file mode 100644
index 000000000000..269baab3319f
--- /dev/null
+++ b/apps/web/src/state/v2ItemSupport.ts
@@ -0,0 +1,62 @@
+import { useAtomValue } from "@effect/atom-react";
+import {
+  EMPTY_V2_ITEM_SUPPORT,
+  resolveV2ItemSupport,
+  v2ItemSupportEqual,
+  type V2ItemSupport,
+} from "@t3tools/client-runtime/state/item-support";
+import type { EnvironmentId, ThreadId, TurnItemId } from "@t3tools/contracts";
+import { scopeThreadRef } from "@t3tools/client-runtime/environment";
+import { Atom } from "effect/unstable/reactivity";
+
+import { environmentThreadDetails } from "./threads";
+
+function supportKey(input: {
+  readonly environmentId: EnvironmentId;
+  readonly threadId: ThreadId;
+  readonly itemId: TurnItemId;
+}): string {
+  return JSON.stringify(input);
+}
+
+function parseSupportKey(key: string): {
+  readonly environmentId: EnvironmentId;
+  readonly threadId: ThreadId;
+  readonly itemId: TurnItemId;
+} {
+  return JSON.parse(key) as {
+    readonly environmentId: EnvironmentId;
+    readonly threadId: ThreadId;
+    readonly itemId: TurnItemId;
+  };
+}
+
+const itemSupportAtomFamily = Atom.family((key: string) => {
+  const target = parseSupportKey(key);
+  const ref = scopeThreadRef(target.environmentId, target.threadId);
+  let previous = EMPTY_V2_ITEM_SUPPORT;
+  return Atom.make((get): V2ItemSupport => {
+    const scoped = get(environmentThreadDetails.threadAtom(ref));
+    if (scoped === null) return EMPTY_V2_ITEM_SUPPORT;
+    const next = resolveV2ItemSupport(scoped.projection, target.itemId);
+    if (v2ItemSupportEqual(previous, next)) return previous;
+    previous = next;
+    return next;
+  }).pipe(Atom.withLabel(`web-v2-item-support:${key}`));
+});
+
+export function useV2ItemSupport(input: {
+  readonly environmentId: EnvironmentId;
+  readonly sourceThreadId: ThreadId;
+  readonly sourceItemId: TurnItemId;
+}): V2ItemSupport {
+  return useAtomValue(
+    itemSupportAtomFamily(
+      supportKey({
+        environmentId: input.environmentId,
+        threadId: input.sourceThreadId,
+        itemId: input.sourceItemId,
+      }),
+    ),
+  );
+}
diff --git a/apps/web/src/state/waitForAtomValue.test.ts b/apps/web/src/state/waitForAtomValue.test.ts
new file mode 100644
index 000000000000..8b8f88a0a63b
--- /dev/null
+++ b/apps/web/src/state/waitForAtomValue.test.ts
@@ -0,0 +1,57 @@
+import { Atom, AtomRegistry } from "effect/unstable/reactivity";
+import { describe, expect, it, vi } from "vite-plus/test";
+
+import { waitForAtomValue } from "./waitForAtomValue";
+
+describe("waitForAtomValue", () => {
+  it("returns immediately when the current value is ready", async () => {
+    const registry = AtomRegistry.make();
+    const atom = Atom.make("ready");
+
+    await expect(
+      waitForAtomValue({
+        registry,
+        atom,
+        predicate: (value) => value === "ready",
+        timeoutMs: 1_000,
+      }),
+    ).resolves.toBe(true);
+
+    registry.dispose();
+  });
+
+  it("waits until a subscribed atom becomes ready", async () => {
+    const registry = AtomRegistry.make();
+    const atom = Atom.make("pending");
+    const result = waitForAtomValue({
+      registry,
+      atom,
+      predicate: (value) => value === "ready",
+      timeoutMs: 1_000,
+    });
+
+    registry.set(atom, "ready");
+
+    await expect(result).resolves.toBe(true);
+    registry.dispose();
+  });
+
+  it("returns false and unsubscribes when readiness times out", async () => {
+    vi.useFakeTimers();
+    const registry = AtomRegistry.make();
+    const atom = Atom.make("pending");
+    const result = waitForAtomValue({
+      registry,
+      atom,
+      predicate: (value) => value === "ready",
+      timeoutMs: 1_000,
+    });
+
+    await vi.advanceTimersByTimeAsync(1_000);
+
+    await expect(result).resolves.toBe(false);
+    registry.set(atom, "ready");
+    registry.dispose();
+    vi.useRealTimers();
+  });
+});
diff --git a/apps/web/src/state/waitForAtomValue.ts b/apps/web/src/state/waitForAtomValue.ts
new file mode 100644
index 000000000000..c47283336509
--- /dev/null
+++ b/apps/web/src/state/waitForAtomValue.ts
@@ -0,0 +1,56 @@
+import type { Atom, AtomRegistry } from "effect/unstable/reactivity";
+
+export async function waitForAtomValue<A>(input: {
+  readonly registry: AtomRegistry.AtomRegistry;
+  readonly atom: Atom.Atom<A>;
+  readonly predicate: (value: A) => boolean;
+  readonly timeoutMs: number;
+}): Promise<boolean> {
+  const read = () => input.registry.get(input.atom);
+  if (input.predicate(read())) {
+    return true;
+  }
+
+  return await new Promise<boolean>((resolve) => {
+    let settled = false;
+    let timeoutId: ReturnType<typeof globalThis.setTimeout> | null = null;
+    let unsubscribe: (() => void) | null = null;
+    let unsubscribeWhenReady = false;
+
+    const finish = (result: boolean) => {
+      if (settled) {
+        return;
+      }
+      settled = true;
+      if (timeoutId !== null) {
+        globalThis.clearTimeout(timeoutId);
+      }
+      if (unsubscribe === null) {
+        unsubscribeWhenReady = true;
+      } else {
+        unsubscribe();
+      }
+      resolve(result);
+    };
+
+    unsubscribe = input.registry.subscribe(input.atom, (value) => {
+      if (input.predicate(value)) {
+        finish(true);
+      }
+    });
+    if (unsubscribeWhenReady) {
+      unsubscribe();
+      return;
+    }
+
+    // Close the gap between the initial read and subscription registration.
+    if (input.predicate(read())) {
+      finish(true);
+      return;
+    }
+
+    timeoutId = globalThis.setTimeout(() => {
+      finish(false);
+    }, input.timeoutMs);
+  });
+}
diff --git a/apps/web/src/test-fixtures.ts b/apps/web/src/test-fixtures.ts
new file mode 100644
index 000000000000..cf1b228c2a20
--- /dev/null
+++ b/apps/web/src/test-fixtures.ts
@@ -0,0 +1,136 @@
+import { presentThreadShell } from "@t3tools/client-runtime/state/shell";
+import {
+  EnvironmentId,
+  ProjectId,
+  ProviderInstanceId,
+  ThreadId,
+  type OrchestrationV2ThreadProjection,
+} from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+
+import type { ChatMessage, Thread } from "./types";
+
+const DEFAULT_TIMESTAMP = "2026-01-01T00:00:00.000Z";
+
+export type ThreadFixtureOverrides = Partial<Thread> & {
+  /** Test-only fallback data for the generic thread-sort contract. */
+  readonly messages?: ReadonlyArray<ChatMessage>;
+  /** Accepted while older unit cases are migrated; never consumed by production code. */
+  readonly proposedPlans?: ReadonlyArray<unknown>;
+};
+
+export function makeThreadProjectionFixture(): OrchestrationV2ThreadProjection {
+  const now = DateTime.makeUnsafe(DEFAULT_TIMESTAMP);
+  const id = ThreadId.make("thread-test");
+  const providerInstanceId = ProviderInstanceId.make("codex");
+  return {
+    thread: {
+      id,
+      projectId: ProjectId.make("project-test"),
+      title: "Thread",
+      providerInstanceId,
+      modelSelection: { instanceId: providerInstanceId, model: "gpt-5.4" },
+      runtimeMode: "full-access",
+      interactionMode: "default",
+      branch: null,
+      worktreePath: null,
+      activeProviderThreadId: null,
+      lineage: { rootThreadId: id, parentThreadId: null, relationshipToParent: null },
+      forkedFrom: null,
+      createdBy: "user",
+      creationSource: "web",
+      createdAt: now,
+      updatedAt: now,
+      archivedAt: null,
+      settledOverride: null,
+      settledAt: null,
+      lastVisitedAt: null,
+      deletedAt: null,
+    },
+    runs: [],
+    attempts: [],
+    nodes: [],
+    subagents: [],
+    providerSessions: [],
+    providerThreads: [],
+    providerTurns: [],
+    runtimeRequests: [],
+    messages: [],
+    plans: [],
+    turnItems: [],
+    checkpointScopes: [],
+    checkpoints: [],
+    contextHandoffs: [],
+    contextTransfers: [],
+    visibleTurnItems: [],
+    updatedAt: now,
+  };
+}
+
+/** Creates a structurally complete V2 shell for UI unit tests. */
+export function makeThreadFixture(overrides: ThreadFixtureOverrides = {}): Thread {
+  const environmentId = overrides.environmentId ?? EnvironmentId.make("environment-test");
+  const id = overrides.id ?? ThreadId.make("thread-test");
+  const projectId = overrides.projectId ?? ProjectId.make("project-test");
+  const providerInstanceId =
+    overrides.providerInstanceId ??
+    overrides.modelSelection?.instanceId ??
+    ProviderInstanceId.make("codex");
+  const modelSelection = overrides.modelSelection ?? {
+    instanceId: providerInstanceId,
+    model: "gpt-5.4",
+  };
+  const createdAt = DateTime.makeUnsafe(DEFAULT_TIMESTAMP);
+  const updatedAt = DateTime.makeUnsafe(DEFAULT_TIMESTAMP);
+  const archivedAt =
+    overrides.archivedAt === null || overrides.archivedAt === undefined
+      ? null
+      : DateTime.makeUnsafe(overrides.archivedAt);
+  const deletedAt =
+    overrides.deletedAt === null || overrides.deletedAt === undefined
+      ? null
+      : DateTime.makeUnsafe(overrides.deletedAt);
+  const shell = presentThreadShell(environmentId, {
+    id,
+    projectId,
+    title: overrides.title ?? "Thread",
+    providerInstanceId,
+    modelSelection,
+    runtimeMode: overrides.runtimeMode ?? "full-access",
+    interactionMode: overrides.interactionMode ?? "default",
+    branch: overrides.branch ?? null,
+    worktreePath: overrides.worktreePath ?? null,
+    activeProviderThreadId: overrides.activeProviderThreadId ?? null,
+    lineage: overrides.lineage ?? {
+      rootThreadId: id,
+      parentThreadId: null,
+      relationshipToParent: null,
+    },
+    forkedFrom: overrides.forkedFrom ?? null,
+    createdBy: "user",
+    creationSource: "web",
+    latestRunId: overrides.latestRun?.runId ?? null,
+    activeRunId: overrides.runtime?.activeRunId ?? null,
+    status: overrides.runtime?.status ?? "idle",
+    pendingRuntimeRequest: null,
+    latestVisibleMessage: null,
+    latestUserMessageAt:
+      overrides.latestUserMessageAt === null || overrides.latestUserMessageAt === undefined
+        ? null
+        : DateTime.makeUnsafe(overrides.latestUserMessageAt),
+    hasActionableProposedPlan: overrides.hasActionableProposedPlan ?? false,
+    itemCount: overrides.itemCount ?? 0,
+    visibleItemCount: overrides.visibleItemCount ?? 0,
+    createdAt,
+    updatedAt,
+    archivedAt,
+    settledOverride: overrides.settledOverride ?? null,
+    settledAt:
+      overrides.settledAt === null || overrides.settledAt === undefined
+        ? null
+        : DateTime.makeUnsafe(overrides.settledAt),
+    deletedAt,
+  });
+
+  return { ...shell, ...overrides };
+}
diff --git a/apps/web/src/threadRoutes.test.ts b/apps/web/src/threadRoutes.test.ts
index 3edb2f38dc85..34380d126689 100644
--- a/apps/web/src/threadRoutes.test.ts
+++ b/apps/web/src/threadRoutes.test.ts
@@ -94,34 +94,31 @@ describe("threadRoutes", () => {
     ).toBeNull();
   });
 
-  it("keeps shell-only server threads in the loading state", () => {
+  it("renders authoritative server-thread shells when bootstrap is complete", () => {
     expect(
       resolveThreadRouteRenderState({
         bootstrapComplete: true,
-        serverThreadShellExists: true,
-        serverThreadDetailExists: false,
-        serverThreadDetailDeleted: false,
+        serverThreadExists: true,
+        serverThreadDeleted: false,
         draftThreadExists: false,
       }),
-    ).toBe("loading");
+    ).toBe("ready");
   });
 
-  it("renders server details and local drafts when they are ready", () => {
+  it("renders server threads and local drafts when they are ready", () => {
     expect(
       resolveThreadRouteRenderState({
         bootstrapComplete: true,
-        serverThreadShellExists: true,
-        serverThreadDetailExists: true,
-        serverThreadDetailDeleted: false,
+        serverThreadExists: true,
+        serverThreadDeleted: false,
         draftThreadExists: false,
       }),
     ).toBe("ready");
     expect(
       resolveThreadRouteRenderState({
         bootstrapComplete: true,
-        serverThreadShellExists: false,
-        serverThreadDetailExists: false,
-        serverThreadDetailDeleted: false,
+        serverThreadExists: false,
+        serverThreadDeleted: false,
         draftThreadExists: true,
       }),
     ).toBe("ready");
@@ -131,30 +128,27 @@ describe("threadRoutes", () => {
     expect(
       resolveThreadRouteRenderState({
         bootstrapComplete: false,
-        serverThreadShellExists: false,
-        serverThreadDetailExists: false,
-        serverThreadDetailDeleted: false,
+        serverThreadExists: false,
+        serverThreadDeleted: false,
         draftThreadExists: false,
       }),
     ).toBe("loading");
     expect(
       resolveThreadRouteRenderState({
         bootstrapComplete: true,
-        serverThreadShellExists: false,
-        serverThreadDetailExists: false,
-        serverThreadDetailDeleted: false,
+        serverThreadExists: false,
+        serverThreadDeleted: false,
         draftThreadExists: false,
       }),
     ).toBe("missing");
   });
 
-  it("redirects deleted shell-only threads", () => {
+  it("redirects deleted server threads", () => {
     expect(
       resolveThreadRouteRenderState({
         bootstrapComplete: true,
-        serverThreadShellExists: true,
-        serverThreadDetailExists: false,
-        serverThreadDetailDeleted: true,
+        serverThreadExists: true,
+        serverThreadDeleted: true,
         draftThreadExists: false,
       }),
     ).toBe("missing");
diff --git a/apps/web/src/threadRoutes.ts b/apps/web/src/threadRoutes.ts
index fd5bc39d836a..8d6c036669c6 100644
--- a/apps/web/src/threadRoutes.ts
+++ b/apps/web/src/threadRoutes.ts
@@ -22,21 +22,20 @@ export type ThreadRouteRenderState = "loading" | "ready" | "missing";
 
 export function resolveThreadRouteRenderState(input: {
   bootstrapComplete: boolean;
-  serverThreadShellExists: boolean;
-  serverThreadDetailExists: boolean;
-  serverThreadDetailDeleted: boolean;
+  serverThreadExists: boolean;
+  serverThreadDeleted: boolean;
   draftThreadExists: boolean;
 }): ThreadRouteRenderState {
   if (!input.bootstrapComplete) {
     return "loading";
   }
-  if (input.serverThreadDetailExists || input.draftThreadExists) {
+  if (input.draftThreadExists) {
     return "ready";
   }
-  if (input.serverThreadDetailDeleted) {
+  if (input.serverThreadDeleted) {
     return "missing";
   }
-  return input.serverThreadShellExists ? "loading" : "missing";
+  return input.serverThreadExists ? "ready" : "missing";
 }
 
 export function buildThreadRouteParams(ref: ScopedThreadRef): {
diff --git a/apps/web/src/types.ts b/apps/web/src/types.ts
index 776631428d24..05855ee631f5 100644
--- a/apps/web/src/types.ts
+++ b/apps/web/src/types.ts
@@ -2,21 +2,24 @@ import type {
   ChatFileAttachment as ContractChatFileAttachment,
   ChatImageAttachment as ContractChatImageAttachment,
   ChatUnknownAttachment as ContractChatUnknownAttachment,
-  OrchestrationCheckpointFile,
-  OrchestrationCheckpointSummary,
-  OrchestrationLatestTurn,
-  OrchestrationMessage,
-  OrchestrationProposedPlan,
-  OrchestrationSession,
+  MessageId,
+  OrchestrationV2Actor,
+  OrchestrationV2CreationSource,
+  OrchestrationV2PlanArtifact,
+  OrchestrationV2UserMessageInputIntent,
+  PlanId,
   ProjectScript as ContractProjectScript,
   ProviderInteractionMode,
+  RunId,
   RuntimeMode,
 } from "@t3tools/contracts";
 import type {
   EnvironmentProject,
-  EnvironmentThread,
   EnvironmentThreadShell,
+  ThreadRunSummary,
+  ThreadRuntimeSummary,
 } from "@t3tools/client-runtime/state/shell";
+import type { ThreadCheckpointSummary } from "@t3tools/client-runtime/state/thread-checkpoints";
 
 export type SessionPhase = "disconnected" | "connecting" | "ready" | "running";
 export const DEFAULT_RUNTIME_MODE: RuntimeMode = "full-access";
@@ -59,21 +62,38 @@ export function isFileAttachment(attachment: ChatAttachment): attachment is Chat
   return attachment.type === "file";
 }
 
-export interface ChatMessage extends Omit<OrchestrationMessage, "attachments"> {
+export interface ChatMessage {
+  readonly id: MessageId;
+  readonly role: "user" | "assistant" | "system";
+  readonly text: string;
   readonly attachments?: ReadonlyArray<ChatAttachment> | undefined;
+  readonly runId: RunId | null;
+  readonly streaming: boolean;
+  readonly createdBy?: OrchestrationV2Actor;
+  readonly creationSource?: OrchestrationV2CreationSource;
+  readonly createdAt: string;
+  readonly updatedAt: string;
+  readonly inputIntent?: OrchestrationV2UserMessageInputIntent | undefined;
 }
 
-export type ProposedPlan = OrchestrationProposedPlan;
-export type TurnDiffFileChange = OrchestrationCheckpointFile;
-export type TurnDiffSummary = OrchestrationCheckpointSummary;
+export interface ProposedPlan {
+  readonly id: PlanId;
+  readonly runId: RunId | null;
+  readonly planMarkdown: string;
+  readonly status: OrchestrationV2PlanArtifact["status"];
+  readonly createdAt: string;
+  readonly updatedAt: string;
+}
+export type TurnDiffFileChange = ThreadCheckpointSummary["files"][number];
+export type TurnDiffSummary = ThreadCheckpointSummary;
 
 export type Project = EnvironmentProject;
-export type Thread = EnvironmentThread;
+export type Thread = EnvironmentThreadShell;
 export type ThreadShell = EnvironmentThreadShell;
 
 export interface ThreadTurnState {
-  latestTurn: OrchestrationLatestTurn | null;
+  latestRun: ThreadRunSummary | null;
 }
 
 export type SidebarThreadSummary = EnvironmentThreadShell;
-export type ThreadSession = OrchestrationSession;
+export type ThreadSession = ThreadRuntimeSummary;
diff --git a/apps/web/src/uiStateStore.test.ts b/apps/web/src/uiStateStore.test.ts
index 304502873539..8c64d67f0e8e 100644
--- a/apps/web/src/uiStateStore.test.ts
+++ b/apps/web/src/uiStateStore.test.ts
@@ -320,5 +320,6 @@ describe("uiStateStore persistence", () => {
       localStorageStub.getItem(PERSISTED_STATE_KEY) ?? "{}",
     ) as PersistedUiState;
     expect(resolveProjectExpanded(persisted.projectExpandedById ?? {}, ["unknown"])).toBe(true);
+    expect(persisted).not.toHaveProperty("threadPanelOpen");
   });
 });
diff --git a/apps/web/src/worktreeCleanup.test.ts b/apps/web/src/worktreeCleanup.test.ts
index 897343578896..7e531db8c574 100644
--- a/apps/web/src/worktreeCleanup.test.ts
+++ b/apps/web/src/worktreeCleanup.test.ts
@@ -2,12 +2,13 @@ import { EnvironmentId, ProjectId, ProviderInstanceId, ThreadId } from "@t3tools
 import { describe, expect, it } from "vite-plus/test";
 
 import { DEFAULT_INTERACTION_MODE, DEFAULT_RUNTIME_MODE, type Thread } from "./types";
+import { makeThreadFixture } from "./test-fixtures";
 import { formatWorktreePathForDisplay, getOrphanedWorktreePathForThread } from "./worktreeCleanup";
 
 const localEnvironmentId = EnvironmentId.make("environment-local");
 
 function makeThread(overrides: Partial<Thread> = {}): Thread {
-  return {
+  return makeThreadFixture({
     id: ThreadId.make("thread-1"),
     environmentId: localEnvironmentId,
     projectId: ProjectId.make("project-1"),
@@ -18,10 +19,8 @@ function makeThread(overrides: Partial<Thread> = {}): Thread {
     },
     runtimeMode: DEFAULT_RUNTIME_MODE,
     interactionMode: DEFAULT_INTERACTION_MODE,
-    session: null,
+    runtime: null,
     messages: [],
-    checkpoints: [],
-    activities: [],
     proposedPlans: [],
     createdAt: "2026-02-13T00:00:00.000Z",
     updatedAt: "2026-02-13T00:00:00.000Z",
@@ -29,11 +28,11 @@ function makeThread(overrides: Partial<Thread> = {}): Thread {
     settledOverride: null,
     settledAt: null,
     deletedAt: null,
-    latestTurn: null,
+    latestRun: null,
     branch: null,
     worktreePath: null,
     ...overrides,
-  };
+  });
 }
 
 describe("getOrphanedWorktreePathForThread", () => {
diff --git a/docs/README.md b/docs/README.md
index 997ac6689fa5..952eae562649 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -11,6 +11,7 @@
 - [Mobile appearance](./user/mobile-appearance.md)
 - [Environment themes](./user/environment-theme.md)
 - [Remote access](./user/remote-access.md)
+- [Appearance](./user/appearance.md)
 - [Keeping app and server in sync](./user/updating.md)
 - [Source control integrations](./user/source-control.md)
 - [Background service (Linux)](./user/background-service.md)
@@ -46,3 +47,13 @@ policy in [CONTRIBUTING.md](../CONTRIBUTING.md); agent rules in [AGENTS.md](../A
 - [Observability](./operations/observability.md)
 - [Relay observability](./operations/relay-observability.md)
 - [Mobile app store screenshots](./operations/mobile-app-store-screenshots.md)
+- [Getting started](./getting-started/quick-start.md)
+- [Architecture](./architecture/overview.md)
+- [T3 Connect](./cloud/t3-connect-clerk.md)
+- [Integrations](./integrations/source-control-providers.md)
+- [Mobile](./mobile/app.md)
+- [Operations](./operations/ci.md)
+- Providers: [Codex](./providers/codex.md), [Claude](./providers/claude.md),
+  [Cursor](./providers/cursor.md)
+- [Reference](./reference/encyclopedia.md)
+- [User guides](./user/keybindings.md)
diff --git a/docs/internals/context-handoffs.md b/docs/internals/context-handoffs.md
new file mode 100644
index 000000000000..965a4623f796
--- /dev/null
+++ b/docs/internals/context-handoffs.md
@@ -0,0 +1,19 @@
+# Context handoffs
+
+Portable provider and fork handoffs are textual summaries. They do not claim native provider context
+parity.
+
+`ContextHandoffServiceV2` includes user messages, assistant messages, command executions, file
+changes, checkpoints, and prior handoffs. It skips other turn item types. For text-bearing items,
+`compactText` replaces every whitespace run with one space, trims the result, and returns at most
+240 characters. A truncated value contains the first 237 characters followed by `...`. File changes
+carry the filename, while checkpoints carry only the number of files.
+
+Provider handoffs use either the full eligible app history or the delta since that provider last
+participated. Fork merge-back handoffs summarize eligible delta items from the child. Neither path
+reconstructs provider-native session state, tool state, approvals, or omitted text.
+
+Legacy v1 continuation uses a separate algorithm. It considers only user and assistant messages,
+walks backward from the newest message, and builds a transcript suffix within a 32,000-character
+budget. Do not describe that migration budget as the limit for portable handoffs, and do not describe
+the 240-character prefix as a migration rule.
diff --git a/docs/internals/legacy-orchestration-migration.md b/docs/internals/legacy-orchestration-migration.md
new file mode 100644
index 000000000000..b59aae970158
--- /dev/null
+++ b/docs/internals/legacy-orchestration-migration.md
@@ -0,0 +1,36 @@
+# Legacy orchestration migration
+
+Orchestration v2 imports v1 threads in place. It creates v2 thread shell events first and imports
+the complete user and assistant transcript lazily when a client reads or continues the thread. The
+v1 projection tables remain the import source and provide a read-only recovery source if an import
+needs investigation.
+
+## Imported data
+
+The shell import preserves the project and thread identifiers, title, provider and model selection,
+runtime and interaction modes, branch, worktree path, creation and update times, archive and delete
+times, settlement override and timestamps, snooze timestamps, pin timestamp and order, and linked
+pull request. The metadata repair path fills snooze, pin order, `unsettledAt`, and linked pull request
+fields for threads imported before those fields were covered.
+
+Transcript import reads user and assistant rows from `projection_thread_messages`. It preserves
+message identifiers, text, supported attachments, timestamps, role, and ordering. A message that was
+still streaming becomes an interrupted turn item.
+
+The importer does not translate provider session identity, native provider runs, checkpoints and
+diffs, activities and tool calls, approvals, or proposed plans. V2 therefore must not present those
+records as migrated history.
+
+## First continuation
+
+A migrated thread has no active provider thread. Its first continuation creates a fresh provider
+session and sends a legacy handoff built only from user and assistant messages. The handoff selects
+the newest transcript suffix within a 32,000-character budget, including section labels and the
+import notice. This budget is separate from portable provider handoffs.
+
+## Recovery
+
+There is no supported whole-thread export API. Recovery uses an untouched copy of the environment's
+`userdata` directory and opens that copy with SQLite's read-only mode. The user guide documents the
+queries against `projection_threads` and `projection_thread_messages`. Never start a server against
+the recovery copy because startup can run migrations and write new state.
diff --git a/docs/internals/performance-regressions.md b/docs/internals/performance-regressions.md
new file mode 100644
index 000000000000..2b4905fd87f9
--- /dev/null
+++ b/docs/internals/performance-regressions.md
@@ -0,0 +1,32 @@
+# Performance regression checks
+
+The v2 transport has a focused regression command:
+
+```bash
+vp run test:perf:v2-wire
+```
+
+It exercises the real v2 projection and client reducers. This matters because the older
+built-app benchmark fixtures seed v1 orchestration events; running those fixtures against a v2
+client can produce reassuring timings while missing the active transport path.
+
+The v2 checks pin these invariants:
+
+- Client cold opens use a recent timeline window capped at 75 rows and about 1 MiB of encoded
+  timeline data.
+- The bounded snapshot does not retain the full duplicate conversation-message table.
+- Older activity is fetched in bounded HTTP pages and merged without disturbing the live scroll
+  window.
+- Resume catch-up replays at most 128 thread events and 1 MiB of projected event JSON before
+  replacing stale state with a current snapshot.
+- Oversized dynamic-tool results and detail strings are reduced only at the wire boundary; the
+  persisted event remains complete.
+- The initial shell contains active navigation rows only. Archived rows use the dedicated archive
+  query, and transcript message bodies stay in thread detail regardless of message size.
+- Shell resume sends deltas plus compact repository-enrichment metadata, not another full project
+  and thread snapshot.
+- Known idle sends and interrupts do not fetch a full thread projection before dispatch.
+
+When changing projection schemas, paging, shell synchronization, or thread state, run this command
+alongside the focused package typechecks and a real-client pass on every affected surface. Payload
+budgets belong in these tests rather than logs or one-off recordings so regressions fail locally.
diff --git a/docs/orchestration-v2/README.md b/docs/orchestration-v2/README.md
new file mode 100644
index 000000000000..b38e99435624
--- /dev/null
+++ b/docs/orchestration-v2/README.md
@@ -0,0 +1,166 @@
+# Orchestration V2
+
+This document set describes the target architecture for the next orchestration model. It is not a patch plan for the current implementation and it intentionally ignores migration/backward compatibility. Those concerns should be handled after the target model is coherent.
+
+V2 is an orchestrator rewrite, not a rewrite of the whole app domain platform. Existing non-orchestration domains, persistence/migration infrastructure, websocket/RPC infrastructure, and projection streaming semantics should be retained unless V2 exposes a concrete orchestration-specific gap.
+
+V2 is designed around the real provider behavior observed in the Codex app-server probes, but it is not Codex-specific. Codex is treated as the richest protocol we currently have; weaker providers are adapted into the same model with app-owned ids and explicit capability flags.
+
+## Documents
+
+- [Core Graph And Data Model](./core-graph-and-data-model.md)
+- [Entity IDs And Correlation](./entity-ids-and-correlation.md)
+- [Feature Lifecycles](./feature-lifecycles.md)
+- [Thread Lineage And Context Transfer](./thread-lineage-and-context-transfer.md)
+- [Provider Switching And Context Handoff](./provider-switching-and-context.md)
+- [Orchestrator MCP Server](./orchestrator-mcp-server.md)
+- [Provider Capability System](./provider-capability-system.md)
+- [Testing Strategy](./testing-strategy.md)
+
+## Primary Goals
+
+- Preserve provider-native lifecycle fidelity without leaking provider ids into app identity.
+- Model root turns, subagents, tools, approvals, plans, and checkpoints as one execution graph.
+- Make root-run completion the only event that completes a user-visible turn.
+- Support forking from normal threads and completed subagent/provider threads.
+- Support changing providers between runs as a first-class context handoff.
+- Model forks, provider handoffs, merge-back, and subagents through shared thread lineage and context transfer primitives.
+- Support providers with weak or missing ids through deterministic app-owned id allocation.
+- Make feature behavior capability-driven, not provider-name-driven.
+
+## Key Invariants
+
+1. App ids are primary. Provider ids are refs.
+2. Provider events are never rewritten to look like another provider event.
+3. Child execution completion never closes the parent run.
+4. Checkpoints attach to checkpointable execution scopes. Root-run checkpoints advance app run history; child/subagent checkpoints are nested and do not advance the parent run count.
+5. Rollback is expressed in app run count and reconciled with provider conversation state.
+6. Every command targets app ids; adapters translate to provider refs at the edge.
+7. Missing provider capability is represented explicitly and handled by policy.
+8. Provider switches create explicit context handoff artifacts; they are not hidden prompt hacks.
+9. Forks record app-level lineage first. Provider-native forks and portable context handoffs are lazy resolution strategies chosen when a run starts.
+10. Tests should prefer replay-backed integration coverage over mocked unit tests. The only normal substitute in orchestration tests is the provider runtime transport.
+
+## Conceptual Layers
+
+```text
+Native provider protocol
+  -> Rotating raw provider diagnostics
+  -> Provider adapter / normalizer
+  -> V2 orchestration event store using existing persistence patterns
+  -> Runtime execution graph
+  -> Conversation projection
+  -> UI / API views
+```
+
+Raw provider diagnostics store what the provider actually sent or received for debugging and replay capture. The durable app state is the normalized orchestration state: events/entities, correlation refs, projections, and command receipts. The runtime graph stores what provider behavior means. The conversation projection stores what users see.
+
+V2 should integrate with the existing orchestration command/event/projection infrastructure patterns rather than creating an unrelated event system. The V2-specific work is the graph model, provider lifecycle semantics, adapter contracts, normalizers, policies, and projections.
+
+While V1 is still present, V2 should own a V2 event schema and V2 event table. It should not force V2 semantics through the old `OrchestrationEvent` TypeScript union. The old union is a V1 semantic model, not the target V2 event vocabulary. A later migration can replace V1 with V2, but the target model should stay V2-native.
+
+## Minimal Mental Model
+
+```text
+AppThread
+  Run 1
+    root ExecutionNode
+      tool ExecutionNode
+      approval ExecutionNode
+      subagent ExecutionNode
+        ProviderThread
+          child root ExecutionNode
+  Run 2
+    root ExecutionNode
+```
+
+An app thread is the user-visible conversation. A run is the counted user-visible turn. Execution nodes are the tree of work inside the run. Provider threads are provider-native conversation handles that can be attached to app threads or nested execution nodes.
+
+Provider switches do not create new app threads. They create or reactivate provider threads and attach context handoff summaries to the next run.
+
+Forks do create new app threads, but they should not force provider selection at fork time. Forking records thread lineage and a pending source point. The first run on the fork resolves that source point through native provider fork when possible or portable context transfer when needed.
+
+## Probe-Derived Requirements
+
+The Codex app-server probes showed several protocol realities that the V2 model must preserve:
+
+- `thread/status/changed` can become idle before or around completion, but `turn/completed` is the authoritative turn terminal event.
+- `turn/interrupt` completes as a request first; the interrupted terminal state arrives later through `turn/completed`.
+- Approval requests are provider-initiated JSON-RPC requests scoped to provider thread, turn, and item.
+- `thread/rollback` returns an authoritative provider thread snapshot after rollback.
+- Subagent child `turn/completed` events can occur before the parent/root turn completes.
+- Child provider turns are real provider turns and must not be remapped onto the parent provider turn id.
+
+These observations are why V2 separates app runs, provider turns, and execution nodes.
+
+## Existing Platform Boundaries
+
+V2 should reuse existing app infrastructure where that infrastructure is not the source of the orchestration bug class:
+
+- Command dispatch should keep the existing serialized/idempotent command handling and command receipt pattern.
+- Projection streams should keep the existing snapshot-plus-cursor semantics used by the current API.
+- Persistence should keep the existing SQLite/migration/repository infrastructure and projection-stream semantics.
+- Raw provider frames should continue to be diagnostic log data, with bounded retention through rotating logs.
+- Replay tests should replace only the provider transport/process boundary.
+
+V2 may add V2-native orchestration events, projection tables, command policies, and provider execution services. It should not add a durable raw-provider-event database or a separate generic event bus unless the existing infrastructure cannot satisfy a documented V2 requirement.
+
+V2 command dispatch returns the last committed stored-event sequence for accepted commands. Duplicate command ids must return the same receipt-backed result without re-running provider side effects. This is the API-level boundary the frontend uses for reconnect/recovery cursors.
+
+## Tracked Follow-Up: Durable Effect Outbox
+
+The current app pipeline uses domain events plus reactors to trigger provider side effects:
+
+```text
+command
+  -> domain event(s)
+  -> projection
+  -> reactor observes event
+  -> provider side effect
+  -> provider output ingestion
+  -> domain event(s)
+```
+
+This is valid, but it can become hard to trace because the provider side effect is implicit in a live subscription. If V2 needs stronger restart/recovery/debuggability, introduce a durable effect outbox for orchestration side effects:
+
+```text
+command
+  -> transaction:
+       append domain event(s)
+       append provider effect request(s)
+  -> projection
+  -> stream to UI
+
+effect worker
+  -> claim effect request
+  -> call provider
+  -> ingest provider output
+  -> append domain event(s)
+  -> mark effect request completed/failed
+```
+
+Example effect request:
+
+```ts
+type ProviderEffectRequest = {
+  id: ProviderEffectRequestId;
+  kind:
+    | "provider.turn.start"
+    | "provider.turn.interrupt"
+    | "provider.runtime-request.respond"
+    | "provider.thread.rollback"
+    | "provider.thread.fork";
+  status: "pending" | "running" | "completed" | "failed" | "cancelled";
+  threadId: ThreadId;
+  runId: RunId | null;
+  nodeId: NodeId | null;
+  provider: ProviderKind;
+  payload: unknown;
+  causationEventId: EventId;
+  commandId: CommandId | null;
+  attempts: number;
+  lastError: string | null;
+};
+```
+
+This should be treated as an infrastructure improvement, not a prerequisite for the first V2 slice. The first V2 implementation can use the existing reactor pattern, but it should keep the provider side-effect boundary clear enough that moving to an outbox later does not require redesigning the graph or provider adapters.
diff --git a/docs/orchestration-v2/core-graph-and-data-model.md b/docs/orchestration-v2/core-graph-and-data-model.md
new file mode 100644
index 000000000000..056f22cfa248
--- /dev/null
+++ b/docs/orchestration-v2/core-graph-and-data-model.md
@@ -0,0 +1,679 @@
+# Core Graph And Data Model
+
+## Overview
+
+V2 models orchestration as a graph with a small number of durable entity types:
+
+```text
+Project
+  AppThread
+    Run
+      ExecutionNode tree
+    ProviderThread handles
+    Context transfers and handoffs
+    Checkpoints
+```
+
+The central separation is:
+
+- `AppThread`: the user-visible conversation in T3 Code.
+- `Run`: a counted user-visible turn on an app thread.
+- `ExecutionNode`: a unit of provider/runtime work inside a run.
+- `ProviderThread`: a provider-native conversation handle.
+- `ProviderSession`: a live or resumable provider process/runtime.
+- `ContextTransfer`: a provider-neutral relationship/source-point record used by forks, provider switches, merge-back, and subagents.
+- `ContextHandoff`: a materialized portable context artifact used when native transfer is unavailable or insufficient.
+
+Provider-specific lifecycle is preserved in provider refs and diagnostic raw-provider logs. App behavior is driven by app-owned ids, V2-native orchestration events, and graph relationships.
+
+V2 events are durable because they are the app state transition log. Raw provider frames are not durable app state. They may be attached by optional correlation ids such as `rawEventId`, but the canonical durable row is the normalized V2 event.
+
+Every committed V2 event has a store-assigned monotonically increasing `sequence`. Projection snapshots and websocket streams use that sequence as the cursor boundary:
+
+```text
+read snapshot at sequence N
+  -> stream committed V2 events where sequence > N
+```
+
+The sequence belongs to the stored event envelope, not the provider event and not the domain payload. Provider-native ordering is preserved separately through provider refs and diagnostic logs. Clients should treat the snapshot's `snapshotSequence` as the authoritative cursor and apply only subsequent events with a greater sequence.
+
+## Entity Summary
+
+```text
+AppThread
+  id: ThreadId
+  projectId: ProjectId
+  title
+  providerBinding
+  activeProviderThreadId?
+  lineage?
+  status projection
+
+Run
+  id: RunId
+  threadId: ThreadId
+  ordinal: number
+  status
+  rootNodeId
+  attempts[]
+  providerThreadId
+  contextHandoffId?
+  userMessageId
+  checkpoint?
+
+ExecutionNode
+  id: NodeId
+  threadId: ThreadId
+  runId: RunId | null
+  parentNodeId: NodeId | null
+  rootNodeId: NodeId
+  kind
+  status
+  providerThreadId?
+  providerTurnId?
+  itemId?
+  countsForRun
+  checkpointScopeId?
+
+CheckpointScope
+  id: CheckpointScopeId
+  threadId
+  runId?
+  nodeId
+  parentScopeId?
+  kind
+  advancesAppRunCount
+
+ProviderSession
+  id: ProviderSessionId
+  provider
+  status
+  cwd
+  capabilities
+
+ProviderThread
+  id: ProviderThreadId
+  providerSessionId?
+  appThreadId?
+  nativeThreadRef?
+  nativeConversationHeadRef?
+  coveredRunRange?
+  contextHandoffIds[]
+  forkSource?
+
+ContextTransfer
+  id: ContextTransferId
+  type
+  sourceThreadId
+  targetThreadId
+  sourcePoint
+  basePoint?
+  sourceProvider?
+  targetProvider?
+  status
+  resolution?
+
+ContextHandoff
+  id: ContextHandoffId
+  transferId
+  kind
+  payload
+  status
+
+ProviderTurn
+  id: ProviderTurnId
+  providerThreadId
+  nativeTurnRef?
+  nodeId
+  runAttemptId?
+  status
+
+RuntimeRequest
+  id: RuntimeRequestId
+  nodeId
+  providerRequestRef?
+  kind
+  status
+```
+
+## AppThread
+
+An `AppThread` is the stable user-facing conversation. It owns messages, runs, checkpoints, and UI state. It does not have to map one-to-one with a provider-native thread forever.
+
+```ts
+type AppThread = {
+  id: ThreadId;
+  projectId: ProjectId;
+  title: string;
+  defaultProvider: ProviderKind;
+  modelSelection: ModelSelection;
+  runtimeMode: RuntimeMode;
+  interactionMode: InteractionMode;
+  branch: string | null;
+  worktreePath: string | null;
+  activeProviderThreadId: ProviderThreadId | null;
+  lineage: AppThreadLineage | null;
+  createdAt: string;
+  updatedAt: string;
+  archivedAt: string | null;
+  deletedAt: string | null;
+};
+```
+
+`activeProviderThreadId` points to the provider-native conversation currently backing the app thread. Forking, provider migration, or recovery may create new provider threads while preserving the same app thread, depending on the operation.
+
+`defaultProvider` is only the currently selected default for future runs. Historical runs retain their own provider and provider thread bindings.
+
+`lineage` is intentionally lightweight browsing metadata. Operational source points, lazy native fork resolution, portable context handoffs, merge-back deltas, and subagent result transfers live in `ContextTransfer` rows because an app thread can participate in more than one transfer over time.
+
+```ts
+type AppThreadLineage = {
+  parentThreadId: ThreadId | null;
+  relationshipToParent: "fork" | "subagent" | null;
+  rootThreadId: ThreadId;
+};
+```
+
+## Run
+
+A `Run` is the counted user-visible turn. This replaces using provider turn ids as the app-level lifecycle boundary.
+
+```ts
+type Run = {
+  id: RunId;
+  threadId: ThreadId;
+  ordinal: number;
+  provider: ProviderKind;
+  providerThreadId: ProviderThreadId | null;
+  userMessageId: MessageId;
+  rootNodeId: NodeId | null;
+  activeAttemptId: RunAttemptId | null;
+  status:
+    | "queued"
+    | "starting"
+    | "running"
+    | "waiting"
+    | "completed"
+    | "interrupted"
+    | "failed"
+    | "cancelled"
+    | "rolled_back";
+  requestedAt: string;
+  startedAt: string | null;
+  completedAt: string | null;
+  checkpointId: CheckpointId | null;
+  contextHandoffId: ContextHandoffId | null;
+  sourcePlanRef?: {
+    threadId: ThreadId;
+    planId: ProposedPlanId;
+  };
+};
+```
+
+Only a run with `countsForConversation = true` contributes to the user-visible turn count and checkpoint count.
+
+`providerThreadId` is the provider-native conversation used for this run. This makes mixed-provider app threads explicit: run 1 may be Codex, run 2 may be Claude, and run 3 may return to the original Codex provider thread.
+
+`contextHandoffId` points to a materialized handoff artifact consumed by this run. A run may also be associated with a broader `ContextTransfer` through the transfer's target/source fields. The handoff is the payload; the transfer is the durable relationship and policy record.
+
+## RunAttempt
+
+A `RunAttempt` represents one provider execution attempt for an app run. Most runs have exactly one attempt. Steering, retries, provider recovery, or provider-switch recovery may create more than one attempt.
+
+```ts
+type RunAttempt = {
+  id: RunAttemptId;
+  runId: RunId;
+  attemptOrdinal: number;
+  rootNodeId: NodeId;
+  provider: ProviderKind;
+  providerThreadId: ProviderThreadId;
+  providerTurnId: ProviderTurnId | null;
+  reason: "initial" | "steering_restart" | "retry" | "provider_recovery";
+  status:
+    | "pending"
+    | "running"
+    | "completed"
+    | "interrupted"
+    | "failed"
+    | "cancelled"
+    | "superseded";
+  startedAt: string | null;
+  completedAt: string | null;
+};
+```
+
+Run attempts let app-level steering work even for providers that cannot steer an active native turn. The app can interrupt the active provider turn and create a replacement attempt under the same `RunId`.
+
+Only one attempt is the final selected attempt for run completion and checkpointing. Superseded/interrupted attempts remain in the execution graph for audit/debugging.
+
+## ExecutionNode
+
+An `ExecutionNode` is the generic unit of runtime work. It is the bridge between provider events and app behavior.
+
+```ts
+type ExecutionNode = {
+  id: NodeId;
+  threadId: ThreadId;
+  runId: RunId | null;
+  parentNodeId: NodeId | null;
+  rootNodeId: NodeId;
+  kind:
+    | "root_turn"
+    | "assistant_message"
+    | "reasoning"
+    | "plan"
+    | "todo_list"
+    | "tool_call"
+    | "approval_request"
+    | "user_input_request"
+    | "subagent"
+    | "hook"
+    | "system";
+  status:
+    | "pending"
+    | "running"
+    | "waiting"
+    | "completed"
+    | "interrupted"
+    | "failed"
+    | "cancelled"
+    | "rolled_back";
+  countsForRun: boolean;
+  providerThreadId: ProviderThreadId | null;
+  providerTurnId: ProviderTurnId | null;
+  nativeItemRef: ProviderRef | null;
+  runtimeRequestId: RuntimeRequestId | null;
+  checkpointScopeId: CheckpointScopeId | null;
+  startedAt: string | null;
+  completedAt: string | null;
+};
+```
+
+The root node of a run is the only node allowed to complete the run. Subagent nodes, tool nodes, approval nodes, and plan nodes may complete independently.
+
+## CheckpointScope
+
+A `CheckpointScope` describes a unit of filesystem state that can be checkpointed. Root runs and child execution nodes can both have checkpoint scopes.
+
+```ts
+type CheckpointScope = {
+  id: CheckpointScopeId;
+  threadId: ThreadId;
+  runId: RunId | null;
+  nodeId: NodeId;
+  parentScopeId: CheckpointScopeId | null;
+  providerThreadId: ProviderThreadId | null;
+  kind: "root_run" | "subagent" | "tool" | "provider_thread" | "manual";
+  ordinalWithinParent: number;
+  advancesAppRunCount: boolean;
+  cwd: string;
+  createdAt: string;
+};
+```
+
+Root run scopes have `advancesAppRunCount = true`. Child scopes, such as subagents, have `advancesAppRunCount = false` and are nested under the parent run's scope.
+
+## ProviderSession
+
+A `ProviderSession` is a live provider runtime process/session, such as a Codex app-server process or a Claude SDK session.
+
+```ts
+type ProviderSession = {
+  id: ProviderSessionId;
+  provider: ProviderKind;
+  status: "starting" | "ready" | "running" | "waiting" | "stopped" | "error";
+  cwd: string;
+  model: string | null;
+  capabilities: ProviderCapabilities;
+  createdAt: string;
+  updatedAt: string;
+  lastError: string | null;
+};
+```
+
+A provider session may host one or more provider threads if the provider supports it. If a provider only supports one active conversation per process, V2 still models that as one provider thread attached to the session.
+
+The session entity is durable metadata for a live-or-recoverable runtime, not the runtime handle itself. The in-memory process/client handle may disappear because the server restarted, an idle reaper released it, or the provider process crashed. In all cases, the app keeps the `ProviderSession`, `ProviderThread`, and native resume refs in durable state, then recreates the live runtime through the normal provider session manager path.
+
+Provider runtime ids and ordinals must not depend on adapter process memory. If a value is persisted or must survive recovery, it is allocated by the orchestrator/correlation/id services or derived from durable provider refs.
+
+## ProviderThread
+
+A `ProviderThread` is a provider-native conversation handle. It is addressable even when it is nested under a subagent execution node.
+
+```ts
+type ProviderThread = {
+  id: ProviderThreadId;
+  provider: ProviderKind;
+  providerSessionId: ProviderSessionId | null;
+  appThreadId: ThreadId | null;
+  ownerNodeId: NodeId | null;
+  nativeThreadRef: string | null;
+  nativeConversationHeadRef: ProviderRef | null;
+  status: "not_loaded" | "idle" | "active" | "archived" | "closed" | "error";
+  firstRunOrdinal: number | null;
+  lastRunOrdinal: number | null;
+  handoffIds: ContextHandoffId[];
+  forkedFrom: ProviderThreadForkSource | null;
+  createdAt: string;
+  updatedAt: string;
+};
+```
+
+`appThreadId` is set when the provider thread backs a first-class app thread. `ownerNodeId` is set when the provider thread is nested under an execution node, such as a subagent. A provider thread can later be forked or promoted into a first-class app thread.
+
+A provider thread may have gaps in its native run coverage. Example: runs 1-5 use Codex provider thread A, runs 6-8 use Claude provider thread B, and run 9 returns to Codex thread A with a handoff summary covering runs 6-8. In that case, Codex thread A remains the same provider thread, but it has an explicit `ContextHandoff` before run 9.
+
+## ContextTransfer
+
+A `ContextTransfer` records a source/target relationship and how context should move between them. It is the shared primitive for user forks, provider switching, merge-back, and subagents.
+
+```ts
+type ContextTransfer = {
+  id: ContextTransferId;
+  type: "fork" | "provider_handoff" | "merge_back" | "subagent_spawn" | "subagent_result";
+  sourceThreadId: ThreadId;
+  targetThreadId: ThreadId;
+  sourcePoint: ContextSourcePoint;
+  basePoint: ContextSourcePoint | null;
+  sourceProvider: ProviderKind | null;
+  targetProvider: ProviderKind | null;
+  status:
+    | "pending"
+    | "resolved_native"
+    | "resolved_portable"
+    | "failed"
+    | "consumed"
+    | "superseded";
+  resolution: ContextTransferResolution | null;
+  createdBy: "user" | "agent" | "system";
+  createdAt: string;
+  consumedAt: string | null;
+};
+```
+
+```ts
+type ContextSourcePoint = {
+  threadId: ThreadId;
+  runId: RunId | null;
+  checkpointId: CheckpointId | null;
+  turnItemId: TurnItemId | null;
+  providerThreadRef: NativeThreadRef | null;
+  providerTurnRef: NativeTurnRef | null;
+};
+
+type ContextTransferResolution =
+  | { strategy: "native_fork"; providerThreadRef: NativeThreadRef }
+  | { strategy: "portable_context"; contextHandoffId: ContextHandoffId }
+  | { strategy: "delta_context"; contextHandoffId: ContextHandoffId }
+  | { strategy: "checkpoint_context"; contextHandoffId: ContextHandoffId };
+```
+
+Creating a transfer should be cheap. Expensive context handoffs are materialized lazily when the target run starts and the selected provider is known.
+
+## ContextHandoff
+
+A `ContextHandoff` is a first-class artifact created when portable provider context must be bridged. It is most common when changing providers between runs, but it also applies when provider resume fails and a replacement provider thread must be seeded from app history.
+
+In the broader transfer model, `ContextTransfer` records source, target, and lifecycle. `ContextHandoff` is the materialized payload consumed by a run when native transfer cannot satisfy the relationship.
+
+```ts
+type ContextHandoff = {
+  id: ContextHandoffId;
+  transferId: ContextTransferId;
+  threadId: ThreadId;
+  targetRunId: RunId;
+  fromProviderThreadIds: ProviderThreadId[];
+  toProviderThreadId: ProviderThreadId;
+  coveredRunOrdinals: {
+    from: number;
+    to: number;
+  };
+  strategy:
+    | "delta_since_target_last_seen"
+    | "full_thread_summary"
+    | "checkpoint_summary"
+    | "manual_context";
+  status: "pending" | "ready" | "failed" | "superseded";
+  summaryMessageId: MessageId | null;
+  summaryText: string;
+  createdByProvider: ProviderKind | null;
+  createdAt: string;
+  updatedAt: string;
+};
+```
+
+The handoff is not just prompt text. It is part of the graph and can be inspected, regenerated, superseded, or audited.
+
+The preferred return-to-provider strategy is `delta_since_target_last_seen`: resume the previous provider thread and summarize only the runs that happened while that provider was inactive. Use `full_thread_summary` when resume fails, provider settings are incompatible, or the accumulated handoffs would create poor context quality.
+
+## ProviderTurn
+
+A `ProviderTurn` is the normalized handle for a provider-native turn.
+
+```ts
+type ProviderTurn = {
+  id: ProviderTurnId;
+  providerThreadId: ProviderThreadId;
+  nodeId: NodeId;
+  runAttemptId: RunAttemptId | null;
+  nativeTurnRef: string | null;
+  ordinal: number;
+  status: "pending" | "running" | "completed" | "interrupted" | "failed" | "cancelled";
+  startedAt: string | null;
+  completedAt: string | null;
+};
+```
+
+Codex has strong native turn ids. Weaker providers may only have ordinals. Both map into `ProviderTurnId`.
+
+## RuntimeRequest
+
+Requests represent provider-originated callbacks that require app/user response.
+
+```ts
+type RuntimeRequest = {
+  id: RuntimeRequestId;
+  nodeId: NodeId;
+  providerTurnId: ProviderTurnId | null;
+  nativeRequestRef: string | null;
+  kind:
+    | "command"
+    | "file-read"
+    | "file-change"
+    | "dynamic_tool_call"
+    | "user_input"
+    | "auth_refresh";
+  status: "pending" | "resolved" | "expired" | "cancelled";
+  responseCapability:
+    | { type: "live"; providerSessionId: ProviderSessionId }
+    | { type: "not_resumable"; reason: string };
+  createdAt: string;
+  resolvedAt: string | null;
+};
+```
+
+The permission kinds are the same canonical domain values used by V1 `ProviderRequestKind`.
+Adapters map provider-native callback names such as Codex `item/commandExecution/requestApproval`
+and Claude tool permission names into these app-level values.
+
+Requests may remain visible after restart, but they are only respondable if their `responseCapability` is live.
+
+## Messages
+
+Messages are part of the conversation projection, not the raw provider graph. They link back to runs and nodes when possible.
+
+```ts
+type ConversationMessage = {
+  id: MessageId;
+  threadId: ThreadId;
+  runId: RunId | null;
+  nodeId: NodeId | null;
+  role: "user" | "assistant" | "system";
+  text: string;
+  attachments: Attachment[];
+  streaming: boolean;
+  createdAt: string;
+  updatedAt: string;
+};
+```
+
+Provider message chunks are collected through items/content events and projected into messages. The projection may hide child/subagent messages by default while preserving them in the graph.
+
+## Plans, Questions, And Todo Lists
+
+V2 treats these as structured turn items or execution nodes.
+
+```ts
+type PlanArtifact = {
+  id: PlanId;
+  threadId: ThreadId;
+  runId: RunId | null;
+  nodeId: NodeId;
+  kind: "proposed_plan" | "todo_list" | "questions";
+  status: "draft" | "active" | "completed" | "superseded";
+  markdown?: string;
+  steps?: Array<{ id: string; text: string; status: "pending" | "running" | "completed" }>;
+  questions?: UserInputQuestion[];
+};
+```
+
+Codex `turn/plan/updated` maps to a `todo_list` artifact. Plan-mode final plan items map to `proposed_plan`. User-input question requests map to `questions` plus a `RuntimeRequest`.
+
+## Checkpoint
+
+Checkpoints attach to checkpoint scopes. A root run checkpoint is the user-visible conversation checkpoint. A child checkpoint records nested filesystem state for a subagent, tool, or provider thread without advancing the parent run count.
+
+```ts
+type Checkpoint = {
+  id: CheckpointId;
+  threadId: ThreadId;
+  scopeId: CheckpointScopeId;
+  runId: RunId | null;
+  nodeId: NodeId;
+  parentCheckpointId: CheckpointId | null;
+  ordinalWithinScope: number;
+  appRunOrdinal: number | null;
+  ref: string;
+  status: "ready" | "missing" | "error" | "stale";
+  files: CheckpointFileSummary[];
+  capturedAt: string;
+};
+```
+
+A child/subagent provider turn can create a child checkpoint. It does not create an app-run checkpoint unless it is running as a first-class app run in a forked/promoted thread.
+
+## Raw Provider Diagnostics
+
+Raw provider diagnostics are append-only evidence for debugging, support, and replay fixture generation. They should be written to bounded rotating log files, not treated as canonical durable SQLite state.
+
+```ts
+type RawProviderEvent = {
+  id: RawEventId;
+  provider: ProviderKind;
+  providerSessionId: ProviderSessionId;
+  sequence: number;
+  direction: "incoming" | "outgoing";
+  messageKind: "request" | "response" | "notification" | "error";
+  method: string | null;
+  jsonRpcId: string | number | null;
+  payload: unknown;
+  observedAt: string;
+};
+```
+
+No domain behavior should depend on parsing historic UI events if raw provider diagnostics are available. Production behavior should depend on normalized orchestration events/entities and provider refs. Raw provider frames are evidence and replay input, not the source of truth for normal app state.
+
+Normalized V2 entities should preserve enough correlation metadata to explain and route behavior:
+
+- provider kind.
+- provider session/thread/turn refs.
+- provider item/request refs when available.
+- native id strength.
+- diagnostic log location or raw frame reference when useful.
+
+The replay framework can use raw provider transcripts as input without requiring production SQLite to store every raw frame.
+
+## Projections
+
+V2 should expose separate projections:
+
+- Thread shell: fast sidebar list.
+- Thread detail: messages, runs, activities, checkpoints, plans.
+- Execution graph: debug/developer view of nodes and provider refs.
+- Provider sessions: live runtime/process state.
+- Pending requests: actionable approvals/user input.
+
+The UI can remain simple while the graph remains precise.
+
+Projection streaming should use the existing app snapshot-plus-cursor contract. A thread-detail subscription should return a projection snapshot at sequence `N`, then stream only events after `N`. The frontend should not receive events already reflected in the snapshot. Reconnects may reset from a fresh snapshot instead of replaying local client state; the fresh snapshot and its `snapshotSequence` become the new cursor boundary.
+
+## Turn Item Projection
+
+The frontend should not reconstruct display order by merging `messages`, `plans`, checkpoints, approvals, and activities itself. V2 exposes an ordered `turnItems` projection for thread detail rendering.
+
+`turnItems` are projection records, not the canonical source of truth. The canonical graph remains normalized in runs, attempts, nodes, requests, messages, plans, and checkpoints. Provider-native item refs live directly on nodes and turn items where correlation is needed.
+
+Forked threads also expose a derived `visibleTurnItems` projection. `turnItems` remains the canonical
+items emitted on that app thread. `visibleTurnItems` is the user-visible ordered read model: it may
+reference inherited source items through the fork source point, include synthetic lifecycle markers
+such as "forked from conversation", and then continue with local target-thread items. This keeps
+storage normalized while giving thread detail views and tests one backend-owned surface to assert.
+
+Known common tools should have structured item variants so the frontend can render stable custom components without parsing provider text:
+
+```ts
+type TurnItem =
+  | UserMessage
+  | AssistantMessage
+  | Reasoning
+  | Plan
+  | FileChange
+  | CommandExecution
+  | FileSearch
+  | WebSearch
+  | ApprovalRequest
+  | Checkpoint
+  | Compaction
+  | Handoff
+  | Fork
+  | DynamicTool;
+```
+
+Examples:
+
+```ts
+type FileChange = {
+  type: "file_change";
+  fileName: string;
+  additions?: number;
+  deletions?: number;
+  diffStr?: string;
+  oldStr?: string;
+  newStr?: string;
+};
+
+type CommandExecution = {
+  type: "command_execution";
+  input: string;
+  status: TurnItemStatus;
+  output?: string;
+  exitCode?: number;
+};
+
+type DynamicTool = {
+  type: "dynamic_tool";
+  toolName: string | null;
+  input: unknown;
+  output?: unknown;
+};
+```
+
+Compaction, handoff, and fork are orchestration lifecycle items, not dynamic tools:
+
+- `compaction`: one item can transition from `running` with title like "Compacting context..." to `completed` with title like "Compacted context".
+- `handoff`: records the context bridge from one or more source provider threads/providers to a target provider thread/provider.
+- `fork`: records that the user or system created a new app thread from a run, node, or provider thread.
+
+The UI can render known variants with deterministic components and render `dynamic_tool` as expandable JSON input/output. Each turn item keeps refs back to `runId`, `nodeId`, `providerTurnId`, and `nativeItemRef` so debug views can jump from the display stream back into the graph and provider logs.
diff --git a/docs/orchestration-v2/entity-ids-and-correlation.md b/docs/orchestration-v2/entity-ids-and-correlation.md
new file mode 100644
index 000000000000..ce65526cc76b
--- /dev/null
+++ b/docs/orchestration-v2/entity-ids-and-correlation.md
@@ -0,0 +1,231 @@
+# Entity IDs And Correlation
+
+## Principle
+
+Provider ids are evidence. App ids are identity.
+
+Every durable entity uses an app-owned id as its primary key. Provider-native ids are stored as optional refs and used only for correlation, debugging, replay, and command routing.
+
+## ID Families
+
+```text
+ThreadId              app-visible conversation thread
+RunId                 counted app turn
+NodeId                execution graph node
+ProviderSessionId     live/resumable provider runtime session
+ProviderThreadId      app handle for provider-native conversation
+ProviderTurnId        app handle for provider-native turn
+RuntimeRequestId      app handle for provider callback/request
+RawEventId            optional raw provider diagnostic frame id
+CheckpointId          app checkpoint id
+PlanId                app plan/todo/question artifact id
+```
+
+Provider ids never replace these ids.
+
+## Provider Refs
+
+Provider refs are metadata on runtime entities and events.
+
+```ts
+type ProviderRefs = {
+  provider: ProviderKind;
+  nativeSessionRef?: string;
+  nativeThreadRef?: string;
+  nativeTurnRef?: string;
+  nativeItemRef?: string;
+  nativeRequestRef?: string;
+  rawEventId?: RawEventId;
+  method?: string;
+};
+```
+
+Codex can populate most of these fields. Other providers may populate only a subset.
+
+## Correlation Scope
+
+Correlation is always scoped. Never match a native id globally without a provider/session/thread scope.
+
+Preferred matching keys:
+
+```text
+ProviderThread:
+  provider + providerSessionId + nativeThreadRef
+
+ProviderTurn:
+  providerThreadId + nativeTurnRef
+  or providerThreadId + turnOrdinal
+
+Node / TurnItem:
+  providerTurnId + nativeItemRef
+  or providerTurnId + itemOrdinal
+
+RuntimeRequest:
+  providerSessionId + nativeRequestRef
+  or providerTurnId + requestOrdinal
+```
+
+If a provider recycles ids, the provider adapter must widen the scope until the mapping is unambiguous.
+
+## Mapping Store
+
+V2 needs a durable correlation table or equivalent event-sourced binding stream.
+
+```ts
+type IdentityBinding = {
+  id: IdentityBindingId;
+  appEntityKind: "provider_thread" | "provider_turn" | "node" | "item" | "request" | "message";
+  appEntityId: string;
+  provider: ProviderKind;
+  providerSessionId: ProviderSessionId;
+  nativeKind: string | null;
+  nativeRef: string | null;
+  scope: {
+    threadId: ThreadId | null;
+    runId: RunId | null;
+    parentNodeId: NodeId | null;
+    providerThreadId: ProviderThreadId | null;
+    providerTurnId: ProviderTurnId | null;
+  };
+  correlation: "native_exact" | "native_scoped" | "ordinal" | "fingerprint" | "synthetic";
+  firstRawEventId?: RawEventId;
+  lastRawEventId?: RawEventId;
+  createdAt: string;
+  updatedAt: string;
+};
+```
+
+This is not meant to be a large identity subsystem. It is the minimal durable place that says, "this native thing corresponds to this app thing." Raw event references are optional diagnostic pointers; the binding itself must not require production SQLite to retain raw provider frames forever.
+
+## ID Allocation Rules
+
+1. If the provider gives a stable native id, reuse the existing binding or allocate a new app id and bind it.
+2. If the provider gives no stable id, allocate by scoped ordinal.
+3. If ordinals are insufficient, add a fingerprint inside the scope.
+4. Once allocated, never change the app id for that entity.
+5. Never infer parent/root completion by string matching ids.
+
+## Scoped Ordinals
+
+Weak providers need deterministic ordinals.
+
+```text
+runOrdinalWithinThread
+providerTurnOrdinalWithinProviderThread
+nodeOrdinalWithinParent
+itemOrdinalWithinProviderTurn
+requestOrdinalWithinProviderTurn
+messageOrdinalWithinNode
+```
+
+Ordinals are assigned by the normalizer when provider frames are processed. They must be replay-deterministic for a given provider transcript.
+
+## Fingerprints
+
+Fingerprints are only fallback correlation tools. They should include scope and stable structure, not large mutable text.
+
+Examples:
+
+```text
+ProviderTurn fingerprint:
+  providerThreadId + runId + providerTurnOrdinalWithinProviderThread
+
+Node / TurnItem fingerprint:
+  providerTurnId + itemKind + itemOrdinalWithinProviderTurn + toolName?
+
+RuntimeRequest fingerprint:
+  providerTurnId + requestKind + nativeItemRef? + requestOrdinalWithinProviderTurn
+```
+
+Do not use complete assistant text as a primary fingerprint. Text is mutable, can stream in chunks, and can be duplicated.
+
+## Runtime Events
+
+Normalized runtime events should carry both app ids and provider refs.
+
+```ts
+type RuntimeEvent = {
+  id: RuntimeEventId;
+  type: RuntimeEventType;
+  threadId: ThreadId;
+  runId: RunId | null;
+  nodeId: NodeId | null;
+  parentNodeId: NodeId | null;
+  providerSessionId: ProviderSessionId | null;
+  providerThreadId: ProviderThreadId | null;
+  providerTurnId: ProviderTurnId | null;
+  nativeItemRef: string | null;
+  requestId: RuntimeRequestId | null;
+  providerRefs: ProviderRefs;
+  payload: unknown;
+  createdAt: string;
+};
+```
+
+Downstream systems should use app ids. Provider refs are preserved for inspection and adapter routing.
+
+## Command Routing
+
+UI and orchestration commands target app ids.
+
+```text
+approval.respond(RuntimeRequestId)
+interrupt.run(RunId)
+interrupt.node(NodeId)
+fork.fromNode(NodeId)
+rollback.toRun(ThreadId, runOrdinal)
+```
+
+The provider command layer resolves app ids to provider refs at the edge. If the provider ref is missing or no longer live, the command fails with a typed capability/state error.
+
+Examples:
+
+```text
+RuntimeRequestId -> nativeRequestRef + providerSessionId
+RunId -> root NodeId -> ProviderTurnId -> nativeTurnRef
+NodeId -> ProviderThreadId -> nativeThreadRef
+```
+
+## Pending Requests After Restart
+
+Pending request records may survive restart, but provider callback state usually does not.
+
+V2 should distinguish historical pending-looking requests from respondable requests:
+
+```ts
+type ResponseCapability =
+  | { type: "live"; providerSessionId: ProviderSessionId }
+  | { type: "not_resumable"; reason: string };
+```
+
+The UI can show that a request expired and the user must restart or rerun the turn.
+
+## Subagent Correlation
+
+Subagents are represented through parent-child execution nodes.
+
+For Codex:
+
+```text
+collabAgentToolCall item
+  -> ExecutionNode(kind="subagent" or "tool_call")
+receiverThreadIds[]
+  -> ProviderThread records
+child turn/started and turn/completed
+  -> child ProviderTurn and child ExecutionNode
+```
+
+The child provider turn keeps its own provider refs. It is linked to the parent through `parentNodeId`, not by replacing its turn id with the parent turn id.
+
+For weak providers, the adapter may create a child node by ordinal under the active parent node.
+
+## Replay Determinism
+
+Given the same provider transcript and same initial app state, normalization must produce the same ids.
+
+Requirements:
+
+- Identity bindings are persisted as events or durable rows.
+- Generated ids can be random if the binding is persisted before downstream projection.
+- Fixture replay may use deterministic id generation to make assertions easier.
+- Reprocessing the same provider frame should find the existing binding, not allocate another entity.
diff --git a/docs/orchestration-v2/feature-lifecycles.md b/docs/orchestration-v2/feature-lifecycles.md
new file mode 100644
index 000000000000..164455b4e22f
--- /dev/null
+++ b/docs/orchestration-v2/feature-lifecycles.md
@@ -0,0 +1,535 @@
+# Feature Lifecycles
+
+This document describes how core user-facing features should work in V2. These flows describe target behavior, not current implementation constraints.
+
+## Creating Threads
+
+Creating an app thread is separate from starting provider work.
+
+```text
+thread.create
+  -> AppThread created
+  -> no provider session required yet
+  -> no provider thread required yet unless eager provider creation is enabled
+```
+
+Provider thread creation may be lazy:
+
+```text
+first run starts
+  -> ensure ProviderSession
+  -> ensure ProviderThread
+  -> send provider turn
+```
+
+If the provider supports empty thread creation, V2 may create a provider thread early. If not, the provider thread is created at first run start.
+
+## Starting A Run
+
+When the user sends a message:
+
+```text
+thread.message.send
+  -> ConversationMessage(role=user)
+  -> Run(status=queued, ordinal=N)
+  -> root ExecutionNode(kind=root_turn, countsForRun=true)
+  -> enqueue provider command
+```
+
+When provider execution begins:
+
+```text
+provider turn accepted/started
+  -> ProviderTurn allocated or correlated
+  -> root node status=running
+  -> run status=running
+```
+
+When the root provider turn completes:
+
+```text
+root provider turn/completed
+  -> finalize assistant streams
+  -> finalize plans/todos/questions
+  -> root node terminal
+  -> capture checkpoint if applicable
+  -> run terminal
+```
+
+Only the root node can complete the run.
+
+## Steering And Queueing Messages
+
+V2 should support three classes of follow-up input:
+
+```text
+steer active run in place
+steer active run by restart
+queue next run
+```
+
+Steering is an app-level intent to change the active run's instructions. Provider-native steering is only one implementation strategy.
+
+If the provider supports active-run steering, the app sends a steer command to the provider and keeps the same run active.
+
+If the provider does not support active-run steering, the app interrupts the active provider turn, finalizes the interrupted attempt, and starts a replacement provider turn for the same app-level steering intent. This may be represented as either:
+
+- the same `RunId` with a new root attempt node, if the UI should treat steering as revising the active run, or
+- a new `RunId` linked by `supersedesRunId`, if preserving the interrupted attempt as a counted turn is important.
+
+The preferred default is the same `RunId` with a new root attempt node until the first attempt has produced a user-meaningful terminal assistant response or checkpoint.
+
+Queueing creates a new run after the active run.
+
+Recommended command shape:
+
+```ts
+type MessageDispatchMode =
+  | { type: "steer_active"; targetRunId: RunId }
+  | { type: "restart_active"; targetRunId: RunId }
+  | { type: "queue_after_active" }
+  | { type: "start_immediately" };
+```
+
+Policy:
+
+- If the provider supports active-run steering, send steer to the provider and attach the message to the active run.
+- If not, interrupt the active provider turn and restart the active run with the steering message included.
+- If the user explicitly requests a new turn, queue even if steering is available.
+- If no run is active, start immediately.
+
+The model supports this because `Run` and `ProviderTurn` are separate. A single app run may have multiple provider-turn attempts when the first attempt was interrupted for steering.
+
+```ts
+type RunAttempt = {
+  id: RunAttemptId;
+  runId: RunId;
+  attemptOrdinal: number;
+  rootNodeId: NodeId;
+  providerThreadId: ProviderThreadId;
+  providerTurnId: ProviderTurnId | null;
+  reason: "initial" | "steering_restart" | "retry" | "provider_recovery";
+  status: "running" | "completed" | "interrupted" | "failed" | "cancelled";
+};
+```
+
+Only the selected/final attempt completes the run and creates the run checkpoint. Earlier interrupted steering attempts remain in the execution graph for audit/debugging.
+
+## Follow-Up Turns
+
+A normal follow-up after a completed run creates a new run.
+
+```text
+previous Run completed
+user sends follow-up
+  -> new Run ordinal=N+1
+  -> new root node
+  -> same AppThread
+  -> same ProviderThread if resumable
+```
+
+If the previous provider thread cannot be resumed due to runtime error, missing native state, or incompatible provider settings, the provider thread is marked unavailable and the app creates a replacement provider thread from reconstructed context.
+
+The replacement path is an error recovery flow, not a provider capability branch.
+
+## Changing Providers Between Runs
+
+Changing providers is a first-class context handoff. It does not fork the app thread and it does not rewrite prior provider history.
+
+```text
+user selects a different provider for next run
+  -> create Run with target provider
+  -> resolve or create target ProviderThread
+  -> create ContextHandoff if target provider thread lacks current app context
+  -> inject handoff summary into provider context
+  -> send user message as the new root turn
+```
+
+Example:
+
+```text
+runs 1-5: Codex provider thread C1
+switch to Claude
+  -> summarize runs 1-5 for Claude
+  -> create Claude provider thread L1
+runs 6-8: Claude provider thread L1
+switch back to Codex
+  -> resume Codex provider thread C1 if possible
+  -> summarize runs 6-8 for Codex
+  -> send run 9 to C1 with the delta handoff
+```
+
+The default policy when returning to a provider is to resume the previous provider thread and bridge only the off-provider delta. This preserves native continuity for that provider's own earlier work while informing it about what happened elsewhere.
+
+Fallback policy: create a fresh provider thread with a full app-thread summary when:
+
+- the previous provider thread cannot be resumed,
+- the provider's context is likely too stale or polluted by repeated handoffs,
+- model/runtime settings changed incompatibly,
+- the user explicitly requests a clean provider context.
+
+The fallback should be explicit in the graph:
+
+```text
+new ProviderThread
+  forked/reconstructed from AppThread summary
+  ContextHandoff(strategy=full_thread_summary)
+```
+
+Provider switching should never concatenate hidden summaries into arbitrary prompts without recording the handoff. The handoff text is part of the run input contract and must be auditable.
+
+## Forking Threads
+
+Forking creates a new app thread from a source point. It should not require provider selection and it should not eagerly create provider runtime state.
+
+```text
+thread.fork
+  -> create target AppThread
+  -> record AppThread lineage
+  -> create ContextTransfer(type=fork, status=pending)
+  -> no ProviderSession required
+  -> no ProviderThread required
+  -> no portable context handoff required
+```
+
+The first run on the fork resolves the pending transfer:
+
+```text
+first message on fork selects provider P
+  -> if source provider is P and native fork is available:
+       resolve by provider-native fork
+     else:
+       materialize portable context
+  -> create/resume target ProviderThread
+  -> send resolved context + user message
+```
+
+The preferred first implementation should fork only from stable source points: completed runs, checkpoints, or idle provider threads with known coverage. Forking from an active run should use the latest completed checkpoint or be rejected until active-run semantics are deliberately designed.
+
+## Merge-Back From Forks
+
+Merge-back brings fork exploration into a source thread without copying the entire fork transcript into the main provider context.
+
+```text
+source thread forked at point S
+fork thread explores through point F
+user sends next source-thread message with merge-back intent
+  -> create ContextTransfer(type=merge_back, basePoint=S, sourcePoint=F)
+  -> build delta context lazily
+  -> inject delta with the next source-thread user message
+```
+
+The delta should describe what changed since the fork point: decisions, files changed, commands/tests run, conclusions, and unresolved issues. It should not include provider protocol noise or full transcript content unless needed.
+
+## Interruption
+
+Interruption targets a run or a node.
+
+```text
+interrupt.run(RunId)
+  -> resolve root node
+  -> resolve provider turn/thread refs
+  -> provider interrupt command if supported
+  -> mark interrupt requested
+```
+
+Terminal state arrives from provider lifecycle:
+
+```text
+provider interrupt request returns
+  -> command acknowledged only
+provider emits root turn/completed status=interrupted
+  -> root node interrupted
+  -> run interrupted
+  -> checkpoint policy runs
+```
+
+The app should not mark the run terminal solely because the interrupt request returned.
+
+If the provider does not support interruption:
+
+- best case: stop provider session and mark run interrupted or cancelled by policy.
+- worst case: mark interrupt unsupported and leave run active until provider exits.
+
+## Resumption
+
+Resumption has three related meanings:
+
+1. Resume an app thread in the UI from persisted projection.
+2. Resume a provider-native conversation/session.
+3. Recover or recreate a live provider runtime process while preserving app and provider-thread continuity.
+
+V2 always supports app-thread resumption from stored events/projections. Provider-thread resumption is a required provider adapter primitive. Every provider harness must expose a cursor/session/thread handle that can be used to resume prior provider state.
+
+Provider runtime recovery is also a core primitive, not a test-only hook. The same recovery path is used when:
+
+- the user restarts the app/server and all provider processes are gone,
+- an idle-session reaper intentionally releases provider processes,
+- a provider process crashes or loses network and policy allows retry.
+
+```text
+open app thread
+  -> load AppThread, Runs, Messages, ExecutionGraph summary
+  -> if provider work must continue, resume the relevant ProviderThread
+```
+
+Provider resume flow:
+
+```text
+resolve activeProviderThreadId
+resolve nativeThreadRef / nativeConversationHeadRef resume cursor
+start ProviderSession
+provider resume
+bind new ProviderSessionId to ProviderThread
+```
+
+Provider runtime recovery flow:
+
+```text
+provider runtime unavailable
+  -> mark ProviderSession stopped/error with reason
+  -> remove live runtime handle from ProviderSessionManager
+  -> keep ProviderThread and nativeThreadRef durable
+  -> on next work, open a new provider runtime
+  -> resume the active ProviderThread before starting/retrying work
+```
+
+Idle cleanup and crash recovery must use production lifecycle APIs. Tests may recreate the outermost layer/runtime or drive the same reaper/recovery service with deterministic clock and replayed provider transport, but they must not use test-only session restart methods.
+
+If provider resume fails:
+
+- preserve historical graph.
+- mark provider thread not loaded or error.
+- create replacement provider thread from reconstructed app context when the user continues.
+- mark pending live requests as not resumable.
+
+Provider resume failure is a runtime/recovery condition. It should not be modeled as "provider does not support resume."
+
+## Forking
+
+Forking creates a new first-class `AppThread` from a stable source.
+
+Supported fork sources:
+
+```ts
+type ForkSource =
+  | { type: "run"; threadId: ThreadId; runId: RunId }
+  | { type: "node"; nodeId: NodeId }
+  | {
+      type: "provider_thread";
+      providerThreadId: ProviderThreadId;
+      providerTurnId?: ProviderTurnId;
+    };
+```
+
+Stable fork boundaries:
+
+- completed run
+- interrupted or failed run with a provider snapshot/checkpoint
+- completed subagent node with a provider thread
+- provider thread snapshot returned by the provider
+- checkpoint boundary
+
+Unstable boundaries:
+
+- streaming message delta
+- active tool call
+- pending approval
+- active subagent turn, unless live fork support is explicitly implemented
+
+Forking from a subagent:
+
+```text
+subagent node selected
+  -> resolve ProviderThread owned by node
+  -> provider fork/resume if supported
+  -> create new AppThread
+  -> attach forked ProviderThread
+  -> copy/link checkpoint baseline
+```
+
+If the provider cannot fork native threads, V2 may synthesize a fork by creating a new app thread with projected messages/context, but that should be marked as lower fidelity by capability.
+
+## Checkpointing
+
+Checkpoints attach to checkpoint scopes. Root runs and child execution nodes can both be checkpointed.
+
+Pre-run baseline:
+
+```text
+before root execution starts
+  -> ensure root checkpoint for current app run ordinal - 1
+```
+
+Post-root-run checkpoint:
+
+```text
+root node terminal
+  -> drain/finalize streams
+  -> capture root checkpoint for app run ordinal
+  -> compute diff from prior root checkpoint
+  -> mark run terminal with checkpoint
+```
+
+Child/subagent checkpoint:
+
+```text
+child checkpointable node starts
+  -> create child CheckpointScope under parent scope
+child node terminal
+  -> drain/finalize child streams/items
+  -> capture child checkpoint for that scope
+  -> compute diff from parent/previous child checkpoint
+  -> mark child node checkpointed
+```
+
+Interrupted/failed runs:
+
+- If filesystem state is meaningful and safe to capture, capture with status reflecting terminal state.
+- If not, store a missing/error checkpoint summary.
+- Child/subagent checkpoints are allowed, but they do not advance the parent app run count.
+- Root run checkpointing should include or reference child checkpoint summaries so the run has a complete audit trail.
+
+Rollback:
+
+```text
+rollback.toRun(threadId, targetRunOrdinal)
+  -> restore filesystem checkpoint targetRunOrdinal
+  -> compute provider turns to roll back if provider supports rollback
+  -> call provider rollback
+  -> reconcile returned provider snapshot if available
+  -> mark later runs rolled_back
+  -> delete or mark stale later checkpoint refs
+```
+
+Codex `thread/rollback` returns an authoritative provider thread snapshot. Other providers may require a synthetic provider thread restart from context.
+
+Nested rollback:
+
+```text
+rollback.node(nodeId, checkpointId)
+  -> restore child checkpoint if scope cwd/ref is available
+  -> roll back provider thread for that child scope if supported
+  -> mark descendant child checkpoints stale/rolled_back
+  -> preserve parent run checkpoint history unless parent filesystem state changed
+```
+
+If a child checkpoint mutates the same workspace as the parent, restoring it may dirty the parent run's workspace state. The UI/API should make that explicit.
+
+## Approvals
+
+Approvals are runtime requests scoped to execution nodes.
+
+```text
+provider requestApproval
+  -> RuntimeRequest(kind=...)
+  -> approval ExecutionNode
+  -> thread pending request projection
+  -> optional thread status waiting
+```
+
+User response:
+
+```text
+approval.respond(RuntimeRequestId)
+  -> resolve live provider callback
+  -> send provider response
+  -> RuntimeRequest resolved
+  -> approval node completed/cancelled
+```
+
+Rules:
+
+- Approval ids are app-owned.
+- Provider request ids are refs.
+- Pending approvals from subagents are still actionable if the provider exposes live response capability.
+- Approval response should fail with `not_resumable` if provider callback state is gone.
+
+## Ask Questions / User Input
+
+Ask-questions is a user-input request, not a plan by itself.
+
+```text
+provider requests user input
+  -> RuntimeRequest(kind=user_input)
+  -> ExecutionNode(kind=user_input_request)
+  -> Question artifact
+  -> run status=waiting
+```
+
+On answer:
+
+```text
+user-input.respond(RuntimeRequestId, answers)
+  -> provider callback
+  -> request resolved
+  -> node completed
+  -> run resumes/runs
+```
+
+If the provider does not support structured questions, the adapter may project a plain assistant message and no respondable request.
+
+## Plans And Todo Lists
+
+V2 separates three concepts:
+
+- Proposed plan: a durable plan artifact the user can accept/implement.
+- Todo list: live execution progress for the current run.
+- Ask questions: structured user-input request.
+
+Codex examples:
+
+```text
+turn/plan/updated
+  -> PlanArtifact(kind=todo_list)
+  -> activity/projection update
+
+item/plan/delta or plan item completed
+  -> PlanArtifact(kind=proposed_plan)
+
+item/tool/requestUserInput
+  -> PlanArtifact(kind=questions)
+  -> RuntimeRequest(kind=user_input)
+```
+
+Rules:
+
+- Root run todo lists update the main plan/progress UI.
+- Child/subagent todo lists are nested under their execution node.
+- Child plans do not replace root plans unless promoted/forked.
+- Proposed plan implementation creates a new run or a new thread depending on user action.
+
+## Activities
+
+Activities are a projection of execution graph events.
+
+Examples:
+
+```text
+tool.started
+approval.requested
+approval.resolved
+plan.updated
+checkpoint.captured
+subagent.started
+subagent.completed
+runtime.warning
+```
+
+Activities should keep `nodeId` and `runId` so the UI can group them correctly.
+
+## Completion Barriers
+
+Before a run is marked terminal, V2 should pass a finalization barrier:
+
+```text
+root provider turn terminal
+  -> flush assistant text buffers
+  -> close active assistant messages
+  -> finalize plan/todo artifacts
+  -> close open non-live child nodes if provider marked them done
+  -> capture checkpoint
+  -> publish run terminal
+```
+
+This prevents early checkpoint capture and incomplete plan state.
diff --git a/docs/orchestration-v2/orchestrator-mcp-server.md b/docs/orchestration-v2/orchestrator-mcp-server.md
new file mode 100644
index 000000000000..3aa9a6cb401a
--- /dev/null
+++ b/docs/orchestration-v2/orchestrator-mcp-server.md
@@ -0,0 +1,413 @@
+# Orchestrator MCP Server
+
+## Purpose
+
+T3 exposes V2 orchestration through its app-owned MCP endpoint. A provider
+agent can use this endpoint to:
+
+- create an app-owned sub-agent on any supported provider instance;
+- wait for or poll the sub-agent's durable result;
+- cancel an active delegated task; and
+- create one or more ordinary top-level T3 threads;
+- list and incrementally read project threads;
+- send or steer follow-up messages; and
+- wait for or interrupt ordinary thread runs.
+
+These are T3 orchestration operations, not provider-native sub-agent APIs.
+Delegated tasks always create a T3 child thread and run. The child receives
+only the supplied task prompt, plus an optional role instruction supplied in
+the same tool call. Parent conversation history is not copied into the child.
+
+`ThreadManagementService` is the shared server application boundary for V2
+WebSocket commands and MCP. It owns project-scoped lookup, listing, send-mode
+selection, durable send postconditions, wait polling, and interrupt selection;
+`OrchestratorV2` remains the lower-level command/event processor. Transport
+adapters only authenticate, resolve transport-specific inputs, and shape
+responses.
+
+## Transport And Authentication
+
+The orchestration tools share the existing authenticated HTTP MCP endpoint:
+
+```text
+http://127.0.0.1:<server-port>/mcp
+```
+
+The provider-visible server key is `t3-code`. The endpoint registers both the
+preview toolkit and the orchestration toolkit.
+
+Before `ProviderSessionManager` opens a new V2 provider session, it asks
+`McpSessionRegistry` for a credential scoped to:
+
+- the T3 environment;
+- the parent T3 thread;
+- the concrete provider instance; and
+- the provider session.
+
+The credential grants `preview` and `orchestration` capabilities. Credentials
+expire after a maximum lifetime, expire when idle, and are revoked when the
+provider session is released. The raw token is not persisted in orchestration
+state.
+
+The MCP HTTP server resolves the bearer token and supplies the resulting
+`McpInvocationScope` to tool handlers. Orchestration handlers additionally
+check the `orchestration` capability before reading or mutating state.
+
+## Provider Injection
+
+### Codex V2
+
+Codex app-server receives the remote MCP server through command-line config
+overrides:
+
+```text
+-c mcp_servers.t3-code.url=http://127.0.0.1:<port>/mcp
+-c mcp_servers.t3-code.bearer_token_env_var="T3_MCP_BEARER_TOKEN"
+```
+
+The provider-session token is placed in `T3_MCP_BEARER_TOKEN`. Both the
+production Codex launcher and the injectable test launcher use the same
+projection helper.
+
+### Claude Agent SDK V2
+
+Claude receives an HTTP MCP server in its query options:
+
+```ts
+{
+  mcpServers: {
+    "t3-code": {
+      type: "http",
+      url: "http://127.0.0.1:<port>/mcp",
+      headers: {
+        Authorization: "Bearer <provider-session-token>",
+      },
+    },
+  },
+  allowedTools: [
+    // existing allowed tools
+    "mcp__t3-code__*",
+  ],
+}
+```
+
+The adapter logs only whether MCP configuration exists; it does not log the
+server headers or token.
+
+### Cursor Agent SDK V2
+
+Cursor receives the same authenticated HTTP MCP endpoint through the SDK's
+`mcpServers` agent and send options. The adapter passes the authorization header
+to the SDK but projects only redacted option metadata into protocol diagnostics.
+
+### Grok ACP V2
+
+Grok receives the authenticated HTTP MCP endpoint through the ACP
+`session/new`, `session/load`, and `session/fork` `mcpServers` field. The shared
+ACP adapter owns standard protocol behavior; the Grok flavor adds xAI extension
+requests such as structured user questions.
+
+ACP does not define native subagents or active steering. Grok therefore uses
+orchestrator-owned child threads and implements steering through
+cancel-and-restart. Its current driver also lacks `session/fork`, so app forks
+use portable context transfer. These are orchestrator policies, not
+provider-specific MCP tools.
+
+### ACP Registry V2
+
+The `acpRegistry` driver is the generic flavor of the same shared ACP adapter.
+Each provider instance names an agent from the official ACP Registry. At
+session startup the driver resolves the current platform distribution, uses a
+managed binary cache or the declared `npx`/`uvx` package, and then negotiates
+standard ACP capabilities during `initialize`. A local executable may override
+the managed command without changing the registry-declared arguments or
+environment.
+
+Capabilities such as session loading, session forking, models, modes, and MCP
+transport are enabled only when the selected agent advertises them. Missing
+features degrade through V2 policy: steering uses interrupt-and-restart,
+forking uses portable context when native `session/fork` is unavailable, and
+subagents use orchestrator-owned child threads. Registry agents do not receive
+provider-specific extensions; those remain in flavors such as Grok.
+
+### Initial Provider Support
+
+The V2 provider adapters are Codex, Claude Agent SDK, Cursor Agent SDK, and
+Grok plus generic registry agents over ACP.
+Capability discovery still reports other registered provider instances, but marks them
+unavailable for orchestration when no V2 adapter exists. This keeps provider
+selection model-visible without allowing a request that cannot run.
+
+## Tool Surface
+
+The server exposes eleven orchestration tools.
+
+### `orchestrator_capabilities`
+
+Returns:
+
+- the inherited provider instance and model;
+- the parent runtime and interaction modes;
+- registered provider instances and advertised models;
+- whether each provider can run a child task; and
+- feature flags for polling, cancellation, and batch thread creation.
+
+Unavailable providers include model-visible constraints such as missing V2
+adapter support, disabled state, missing executable, or missing authentication.
+
+### `delegate_task`
+
+Creates a T3-owned child thread and immediately dispatches the supplied task
+prompt.
+
+```ts
+type DelegateTaskInput = {
+  task: string;
+  target?: {
+    providerInstanceId?: string;
+    driverKind?: string;
+    model?: string;
+  };
+  title?: string;
+  role?: "implementation" | "research" | "review" | "design" | "test" | "general";
+  mode?: "async" | "wait";
+  timeoutMs?: number;
+  clientRequestId?: string;
+  runtimeMode?: "inherit" | "approval-required" | "auto-accept-edits" | "full-access";
+  interactionMode?: "inherit" | "plan" | "default";
+};
+```
+
+Provider, model, runtime mode, and interaction mode inherit from the parent
+when omitted. Selecting a different provider without a model uses that
+provider's first advertised model.
+
+Delegation requires an active parent run owned by the MCP credential's
+provider session. The request becomes the V2 command
+`delegated_task.request`.
+
+`mode: "async"` returns the current durable state immediately.
+`mode: "wait"` polls the same durable state until it becomes terminal or the
+timeout expires. A wait timeout does not cancel the child; the result sets
+`waitTimedOut: true`, and the caller can continue with `task_status`.
+
+```ts
+type DelegateTaskResult = {
+  taskId: string;
+  childThreadId: string;
+  childRunId: string | null;
+  childNodeId: string;
+  status: "queued" | "running" | "waiting" | "completed" | "failed" | "cancelled" | "interrupted";
+  providerInstanceId: string;
+  model: string | null;
+  summary: string | null;
+  resultContextTransferId: string | null;
+  waitTimedOut: boolean;
+};
+```
+
+### `task_status`
+
+Reads a delegated task from the parent thread's durable projection. A task ID
+from another parent thread is rejected. Terminal results include the child
+summary and the durable `subagent_result` context transfer ID when available.
+
+### `task_cancel`
+
+Interrupts the active child run through the normal V2 `run.interrupt` command.
+It is idempotent for terminal tasks and accepts an optional cancellation
+reason.
+
+### `create_threads`
+
+Creates between one and twenty ordinary top-level T3 threads:
+
+```ts
+type CreateThreadsInput = {
+  threads: Array<{
+    prompt?: string;
+    title?: string;
+    target?: {
+      providerInstanceId?: string;
+      driverKind?: string;
+      model?: string;
+    };
+    runtimeMode?: "inherit" | "approval-required" | "auto-accept-edits" | "full-access";
+    interactionMode?: "inherit" | "plan" | "default";
+  }>;
+  clientRequestId?: string;
+};
+```
+
+Each entry independently resolves provider, model, and modes. The new threads
+inherit the parent's project, branch, and worktree path, but they have no
+sub-agent lineage. Entries with a prompt immediately dispatch a run; entries
+without a prompt remain idle.
+
+### `t3_thread_start`
+
+Creates one ordinary top-level thread and immediately dispatches its first
+prompt. It is the single-thread convenience form of `create_threads` and
+returns the created thread and run IDs. Use `clientRequestId` when a caller may
+retry the request.
+
+### `t3_thread_list`
+
+Lists durable thread shells in the calling thread's project, newest first.
+Callers can filter by title, run status, and whether app-owned sub-agent threads
+are included. Results are bounded and offset-paginated. Deleted threads and
+threads from other projects are never exposed.
+
+### `t3_thread_read`
+
+Reads a project-scoped thread's durable state, recent runs, and visible
+timeline. The default `messages` view returns user messages, assistant
+messages, and proposed plans. The `activity` view also returns summarized tool,
+reasoning, checkpoint, handoff, and runtime-request items. Large item text is
+bounded and reports whether it was truncated. `afterPosition` and
+`nextPosition` support incremental reads.
+
+Thread and message results include required `createdBy` and `creationSource`
+provenance. MCP-created threads and user-role messages use `createdBy: "agent"`
+and `creationSource: "mcp"`; provider output uses `creationSource: "provider"`.
+Actor and ingress are separate so agent-authored user-role messages remain
+distinguishable from human-authored messages.
+
+### `t3_thread_send`
+
+Sends a message to an ordinary or delegated thread in the calling project:
+
+- `auto` starts an idle thread, steers a fully active turn, or queues behind a
+  turn that is not yet steerable;
+- `queue` creates a separate follow-up run after active work;
+- `steer` requires a steerable active provider turn; and
+- `restart` requires an active provider turn and uses the orchestrator's
+  interrupt-and-restart path.
+
+The target runtime and interaction modes may not be broader than the caller's.
+Stable command and message IDs are derived from `clientRequestId` for
+idempotent retries.
+
+### `t3_thread_wait`
+
+Waits for a selected run to become `completed`, `failed`, `cancelled`,
+`interrupted`, or `rolled_back`. Without `runId`, it pins the latest run at call
+time; an idle thread returns immediately. A timeout reports the latest durable
+status and does not cancel work.
+
+### `t3_thread_interrupt`
+
+Interrupts a selected active run through the normal V2 `run.interrupt` command.
+Without `runId`, it selects the newest interruptible run. A terminal run is
+returned unchanged, and a thread with no active provider turn returns
+`no_active_run`.
+
+## Delegated Task Lifecycle
+
+The MCP server is a command ingress into V2. It does not call provider adapters
+directly.
+
+```text
+provider model
+  -> MCP tools/call delegate_task
+  -> authenticated OrchestratorMcpService
+  -> shared ThreadManagementService
+  -> V2 delegated_task.request command
+  -> child thread + child run
+  -> parent app_owned subagent projection
+  -> parent/child execution nodes
+  -> consumed subagent_spawn context transfer
+  -> normal provider effect and runtime ingestion
+  -> child run reaches a terminal state
+  -> parent subagent/node/turn item finalized
+  -> consumed subagent_result context transfer
+  -> wait result or later task_status result
+```
+
+The child thread has lineage relationship `subagent` and points back to the
+parent node. The parent gets an `app_owned` sub-agent projection and a
+sub-agent turn item so the existing debug UI can render progress.
+
+Terminal provider events trigger finalization. The event stream first replays
+persisted events and then follows live events, so finalization also runs after
+a server restart. An existing `subagent_result` transfer makes finalization
+idempotent.
+
+The result summary prefers the latest assistant content from the child run and
+falls back to a terminal-status message when no assistant text exists.
+
+## Policy And Idempotency
+
+- A child runtime mode may stay equal to or become narrower than the parent
+  mode. It may not escalate privileges.
+- A child interaction mode may stay equal to or narrow from `default` to
+  `plan`. It may not escalate from `plan` to `default`.
+- General thread management is limited to the calling thread's project. Send
+  additionally enforces the same runtime and interaction privilege ceiling as
+  child creation.
+- Provider instances must be enabled, installed, available, authenticated, and
+  backed by a V2 adapter.
+- A requested model must be advertised by the selected provider when the
+  provider publishes a model list.
+- `clientRequestId` derives stable command, thread, and message IDs within the
+  provider session. Retrying the same call returns the same durable work.
+- Calls without `clientRequestId` receive a generated request key and create
+  new work.
+
+Expected denials use the typed `OrchestratorMcpFailure` result:
+
+```text
+capability_denied
+parent_not_active
+provider_unavailable
+model_unavailable
+runtime_mode_escalation_denied
+interaction_mode_escalation_denied
+task_not_found
+task_not_cancellable
+thread_not_found
+run_not_found
+thread_not_sendable
+thread_not_interruptible
+invalid_request
+orchestration_error
+```
+
+## Code Ownership
+
+- Shared schemas: `packages/contracts/src/orchestratorMcp.ts`
+- MCP service: `apps/server/src/mcp/OrchestratorMcpService.ts`
+- Tool definitions and handlers:
+  `apps/server/src/mcp/toolkits/orchestrator/`
+- HTTP registration and authentication:
+  `apps/server/src/mcp/McpHttpServer.ts`
+- Credential lifecycle: `apps/server/src/mcp/McpSessionRegistry.ts`
+- Provider injection:
+  `apps/server/src/orchestration-v2/ProviderSessionManager.ts` and V2 adapters
+- Durable delegated-task command and finalization:
+  `apps/server/src/orchestration-v2/Orchestrator.ts`
+
+## Verification
+
+The integration test uses the real MCP toolkit registration, V2 orchestrator,
+SQL persistence, event ingestion, projections, and checkpoints. Only the
+external provider adapters are deterministic test implementations.
+
+Coverage includes:
+
+- capability discovery;
+- cross-provider delegated completion;
+- prompt-only child context;
+- parent and child lineage projections;
+- spawn and result context transfers;
+- async status polling;
+- cancellation;
+- batch ordinary-thread creation;
+- project-scoped thread listing and timeline reads;
+- ordinary-thread send, wait, steering, and interruption;
+- inheritance and per-thread provider overrides; and
+- idempotent retries.
+
+Provider adapter tests separately verify Codex, Claude, Cursor, Grok, and ACP
+Registry behavior and MCP injection. The provider-session manager test verifies
+that credentials exist before an adapter opens and are revoked when it closes.
diff --git a/docs/orchestration-v2/provider-capability-system.md b/docs/orchestration-v2/provider-capability-system.md
new file mode 100644
index 000000000000..dc544b1af106
--- /dev/null
+++ b/docs/orchestration-v2/provider-capability-system.md
@@ -0,0 +1,284 @@
+# Provider Capability System
+
+V2 must not assume every provider can do what Codex can do. Provider behavior should be expressed through capabilities and policies, not provider-name conditionals spread across orchestration.
+
+## Capability Shape
+
+```ts
+type ProviderCapabilities = {
+  sessions: SessionCapabilities;
+  threads: ThreadCapabilities;
+  turns: TurnCapabilities;
+  streaming: StreamingCapabilities;
+  tools: ToolCapabilities;
+  approvals: ApprovalCapabilities;
+  planning: PlanningCapabilities;
+  subagents: SubagentCapabilities;
+  context: ContextCapabilities;
+  checkpointing: CheckpointCapabilities;
+  identity: IdentityCapabilities;
+};
+```
+
+Capabilities should be versioned and emitted by each adapter at session start.
+
+## Session Capabilities
+
+```ts
+type SessionCapabilities = {
+  supportsMultipleProviderThreadsPerSession: boolean;
+  supportsModelSwitchInSession: boolean;
+  supportsProviderSwitchingViaHandoff: boolean;
+  supportsRuntimeModeSwitchInSession: boolean;
+  pendingRequestsSurviveRestart: boolean;
+};
+```
+
+Policy examples:
+
+- If model switching is unsupported, start a new provider session.
+- If pending requests do not survive restart, mark old requests `not_resumable`.
+
+Provider-thread resumption is not a capability. It is a required adapter primitive. Adapters must be able to start from a stored provider cursor/session/thread handle or return a runtime resume failure.
+
+## Thread Capabilities
+
+```ts
+type ThreadCapabilities = {
+  canCreateEmptyThread: boolean;
+  canReadThreadSnapshot: boolean;
+  canRollbackThread: boolean;
+  canForkThread: boolean;
+  canForkFromTurn: boolean;
+  canForkFromSubagentThread: boolean;
+  exposesNativeThreadId: boolean;
+};
+```
+
+Codex can expose strong thread ids and rollback snapshots. Claude may support native forking through its own model/session primitives. Other providers may only support synthetic app forks.
+
+## Turn Capabilities
+
+```ts
+type TurnCapabilities = {
+  exposesNativeTurnId: boolean;
+  emitsTurnStarted: boolean;
+  emitsTurnCompleted: boolean;
+  supportsInterrupt: boolean;
+  supportsActiveSteering: boolean;
+  supportsSteeringByInterruptRestart: boolean;
+  supportsQueuedMessages: boolean;
+  terminalStatusQuality: "strong" | "weak" | "none";
+};
+```
+
+If `terminalStatusQuality` is weak, V2 should use adapter policy to infer terminal state, but still mark correlation strength accordingly.
+
+`supportsActiveSteering` means the provider can modify an in-flight turn directly. `supportsSteeringByInterruptRestart` means V2 can implement app-level steering by interrupting the active turn and starting a replacement attempt. Most providers should support the latter if they support interruption and normal follow-up turns.
+
+## Streaming Capabilities
+
+```ts
+type StreamingCapabilities = {
+  streamsAssistantText: boolean;
+  streamsReasoning: boolean;
+  streamsToolOutput: boolean;
+  streamsPlanText: boolean;
+  emitsMessageCompleted: boolean;
+};
+```
+
+If message completion is not emitted, the normalizer closes assistant messages at root run terminal.
+
+## Tool Capabilities
+
+```ts
+type ToolCapabilities = {
+  exposesToolItemIds: boolean;
+  emitsToolStarted: boolean;
+  emitsToolCompleted: boolean;
+  emitsToolOutput: boolean;
+  supportsMcpTools: boolean;
+  supportsDynamicToolCallbacks: boolean;
+};
+```
+
+Weak providers may produce only textual tool summaries. The adapter can still create ordered `turnItems` and execution nodes by scoped ordinal.
+
+## Approval Capabilities
+
+```ts
+type ApprovalCapabilities = {
+  supportsCommandApproval: boolean;
+  supportsFileReadApproval: boolean;
+  supportsFileChangeApproval: boolean;
+  supportsApplyPatchApproval: boolean;
+  approvalsHaveNativeRequestIds: boolean;
+  approvalCallbacksAreLiveOnly: boolean;
+  approvalsCanOriginateFromSubagents: boolean;
+};
+```
+
+The UI should show pending approvals from any execution node, including subagents, if they are respondable.
+
+## Planning Capabilities
+
+```ts
+type PlanningCapabilities = {
+  emitsPlanUpdated: boolean;
+  emitsTodoList: boolean;
+  emitsProposedPlan: boolean;
+  supportsStructuredQuestions: boolean;
+  planDeltasHaveItemIds: boolean;
+};
+```
+
+Mapping policy:
+
+- `emitsTodoList`: update live run progress.
+- `emitsProposedPlan`: create accept/implementable plan artifacts.
+- `supportsStructuredQuestions`: create respondable user-input requests.
+
+If a provider only emits plain assistant text, the app should not pretend it has structured plans.
+
+## Subagent Capabilities
+
+```ts
+type SubagentCapabilities = {
+  supportsSubagents: boolean;
+  exposesSubagentThreadIds: boolean;
+  emitsSubagentLifecycle: boolean;
+  canWaitForSubagents: boolean;
+  canCloseSubagents: boolean;
+  canForkSubagentThread: boolean;
+};
+```
+
+When `exposesSubagentThreadIds` is true, subagent provider threads become addressable `ProviderThread` records. When false, subagents can still be shown as nested execution nodes if the provider exposes enough lifecycle information.
+
+## Context Handoff Capabilities
+
+Context handoff controls provider switching and provider-thread reconstruction.
+
+```ts
+type ContextCapabilities = {
+  acceptsSystemContext: boolean;
+  acceptsDeveloperContext: boolean;
+  acceptsSyntheticUserContext: boolean;
+  canGenerateSummaries: boolean;
+  canConsumeHandoffSummaries: boolean;
+  supportsDeltaHandoff: boolean;
+  supportsFullThreadHandoff: boolean;
+  maxRecommendedHandoffChars: number | null;
+};
+```
+
+Policy examples:
+
+- If `supportsDeltaHandoff` is available, return to a previous provider thread with a summary of only off-provider runs.
+- If delta handoff is unsupported or low quality, create a new provider thread with a full thread summary.
+- If the provider cannot accept explicit context, provider switching should require synthetic user context or be marked unsupported.
+- If no provider can generate summaries, use the app's configured summarization provider or a local summarizer capability.
+
+## Checkpoint Capabilities
+
+Checkpointing is primarily app-owned, but provider conversation rollback is provider-dependent.
+
+```ts
+type CheckpointCapabilities = {
+  appCanCheckpointFilesystem: boolean;
+  supportsNestedCheckpointScopes: boolean;
+  providerCanRollbackConversation: boolean;
+  providerRollbackReturnsSnapshot: boolean;
+  providerCanReadConversationSnapshot: boolean;
+};
+```
+
+If provider rollback is unsupported, filesystem rollback can still happen, but provider conversation state must be restarted or marked divergent. Nested checkpoint scopes are app-owned; providers only affect whether their nested provider conversations can be rolled back to match restored filesystem state.
+
+## Identity Capabilities
+
+```ts
+type IdentityCapabilities = {
+  nativeThreadIds: "strong" | "weak" | "none";
+  nativeTurnIds: "strong" | "weak" | "none";
+  nativeItemIds: "strong" | "weak" | "none";
+  nativeRequestIds: "strong" | "weak" | "none";
+};
+```
+
+This controls how the normalizer correlates events:
+
+- `strong`: use native id as scoped provider ref.
+- `weak`: use native id plus ordinal/fingerprint.
+- `none`: allocate by scoped ordinal.
+
+## Degradation Policies
+
+Every feature should declare what happens when capability is missing.
+
+Examples:
+
+```text
+interrupt unsupported
+  -> stop session if allowed, otherwise mark unsupported
+
+active steering unsupported
+  -> interrupt active turn and restart the run as a steering replacement attempt
+
+fork unsupported
+  -> synthetic fork from app projection if policy allows
+
+rollback unsupported
+  -> restore filesystem checkpoint, restart provider context, mark provider state divergent
+
+nested checkpoint unsupported
+  -> capture only root-run checkpoint and record child filesystem activity as uncheckpointed
+
+provider switch return unsupported
+  -> create fresh provider thread with full app-thread summary
+
+structured approvals unsupported
+  -> provider runs under configured sandbox policy; no approval UI
+
+plan_updated unsupported
+  -> no live todo UI; rely on assistant messages
+```
+
+The UI should not hide unsupported behavior behind provider-specific errors. It should receive typed capability results.
+
+## Adapter Contract
+
+Each provider adapter should expose:
+
+```ts
+type ProviderAdapter = {
+  getCapabilities(): ProviderCapabilities;
+  startSession(input): ProviderSession;
+  ensureProviderThread(input): ProviderThread;
+  sendRun(input): ProviderTurnStartResult;
+  steerRun?(input): void;
+  interrupt(input): void;
+  respondToRequest(input): void;
+  readThreadSnapshot?(input): ProviderThreadSnapshot;
+  rollbackThread?(input): ProviderThreadSnapshot | void;
+  forkThread?(input): ProviderThread;
+  streamEvents(): Stream<ProviderAdapterEvent>;
+};
+```
+
+Optional methods are guarded by capabilities. The orchestration layer should not call optional methods without checking capability or going through a policy wrapper.
+
+Raw provider frames should be logged by the provider transport/runtime as bounded diagnostics. Adapter streams should expose normalized provider events that the V2 normalizer can turn into app orchestration events.
+
+## Capability-Driven UI
+
+The UI should receive capability-informed affordances:
+
+- show or hide fork action by fork source.
+- show interrupt as available, destructive fallback, or unavailable.
+- show approvals as respondable or expired.
+- show plan/todo panels only when structured plan artifacts exist.
+- show rollback only when app checkpoint exists, and annotate provider rollback support.
+
+This keeps the product predictable across Codex, Claude, Cursor, OpenCode, and future providers.
diff --git a/docs/orchestration-v2/provider-switching-and-context.md b/docs/orchestration-v2/provider-switching-and-context.md
new file mode 100644
index 000000000000..17515dda2133
--- /dev/null
+++ b/docs/orchestration-v2/provider-switching-and-context.md
@@ -0,0 +1,233 @@
+# Provider Switching And Context Handoff
+
+Provider switching is a first-class V2 feature. An app thread may contain runs from multiple providers while preserving each provider's native conversation handles and the app's canonical conversation history.
+
+This document describes the provider-switching specialization of the broader [Thread Lineage And Context Transfer](./thread-lineage-and-context-transfer.md) model. Provider switching is a context transfer where the source and target app thread are usually the same thread. Forking, merge-back, and subagents use the same source-point/resolution concepts with different product lifecycles.
+
+## Recommendation
+
+When returning to a provider that was used earlier, default to resuming that provider's previous provider thread and inject a delta summary covering the runs that happened while the provider was inactive.
+
+Create a fresh provider thread with a full app-thread summary only when resuming the prior provider thread fails, settings are incompatible, or delta handoff is likely to produce poor context.
+
+This gives the best default tradeoff:
+
+- preserves native continuity for provider-specific prior work,
+- avoids repeatedly summarizing everything,
+- lets each provider keep its own tool/history affordances,
+- makes cross-provider context explicit and auditable,
+- keeps a clean fallback when old provider context is stale.
+
+## Example
+
+```text
+runs 1-5: Codex, ProviderThread C1
+switch to Claude for run 6
+  -> ContextHandoff H1 covers runs 1-5
+  -> create ProviderThread L1
+  -> run 6 uses L1 with H1
+runs 6-8: Claude, ProviderThread L1
+switch back to Codex for run 9
+  -> ContextHandoff H2 covers runs 6-8
+  -> resume ProviderThread C1
+  -> run 9 uses C1 with H2
+```
+
+ProviderThread C1 is not expected to natively contain Claude's runs. It contains Codex's native conversation plus explicit handoff artifacts that summarize external progress.
+
+## Why Not Always Create A Fresh Provider Thread?
+
+Always creating a fresh provider thread is simpler but loses useful provider-native continuity:
+
+- prior hidden reasoning/context that is only available in the provider thread,
+- provider-side thread metadata,
+- native tool state where available,
+- continuity for provider-specific behavior.
+
+It also forces every switch to depend on full summarization quality. Full summaries are useful fallback artifacts, but they should not be the default when a previous provider thread can be safely resumed.
+
+## Why Not Resume Without Summary?
+
+Because the app thread moved on while the provider was inactive. The resumed provider would not know what another provider did. That creates wrong answers, stale plans, and unsafe file assumptions.
+
+Returning to a provider requires a handoff summary unless no runs happened since that provider last participated.
+
+## Provider Thread Coverage
+
+Provider threads have native coverage and handoff coverage.
+
+```ts
+type ProviderThreadCoverage = {
+  providerThreadId: ProviderThreadId;
+  nativeRunOrdinals: number[];
+  handoffIds: ContextHandoffId[];
+};
+```
+
+For the example above:
+
+```text
+C1 native runs: 1,2,3,4,5,9
+C1 handoffs: H2 covering 6-8
+
+L1 native runs: 6,7,8
+L1 handoffs: H1 covering 1-5
+```
+
+The app thread remains the source of truth for full history.
+
+## Handoff Artifact
+
+A handoff is explicit graph data. In the broader model, `ContextTransfer` records source, target, relationship type, and resolution status. `ContextHandoff` is the materialized portable context artifact used when the transfer cannot be satisfied by native provider continuity.
+
+```ts
+type ContextHandoff = {
+  id: ContextHandoffId;
+  transferId: ContextTransferId;
+  threadId: ThreadId;
+  targetRunId: RunId;
+  fromProviderThreadIds: ProviderThreadId[];
+  toProviderThreadId: ProviderThreadId;
+  coveredRunOrdinals: { from: number; to: number };
+  strategy:
+    | "delta_since_target_last_seen"
+    | "full_thread_summary"
+    | "checkpoint_summary"
+    | "manual_context";
+  summaryText: string;
+  status: "pending" | "ready" | "failed" | "superseded";
+  createdByProvider: ProviderKind | null;
+  createdAt: string;
+  updatedAt: string;
+};
+```
+
+The handoff should be linked to the run that consumes it. If the same summary is regenerated, the old handoff is superseded rather than mutated invisibly.
+
+## Switch Flow
+
+```text
+start run with target provider P
+  -> find current app thread history
+  -> find best ProviderThread for P
+  -> decide handoff strategy
+  -> generate ContextHandoff if needed
+  -> ensure ProviderSession for P
+  -> ensure/resume/create target ProviderThread
+  -> send provider turn with handoff context + user message
+```
+
+The user message remains the actual run input. The handoff context is a separate preamble/system/developer/synthetic-user context depending on provider capability.
+
+## Strategy Selection
+
+Recommended strategy order:
+
+1. No handoff: target provider thread already has current app run coverage.
+2. Delta handoff into existing provider thread: target provider thread can resume and only missed a run range.
+3. Full thread handoff into existing provider thread: target provider can resume, but delta chain is too complex.
+4. Full thread handoff into new provider thread: target provider resume failed, settings are incompatible, or old context is stale.
+5. Unsupported: provider cannot accept handoff context and no safe reconstruction path exists.
+
+## Staleness Policy
+
+The app should be able to decide that returning to an old provider thread is no longer appropriate.
+
+Possible staleness signals:
+
+- too many off-provider runs since last use,
+- too many chained handoffs,
+- target provider model/runtime mode changed incompatibly,
+- provider thread resume failed,
+- prior provider thread was rolled back or forked in a conflicting way,
+- user selected "clean context",
+- handoff summary would exceed provider context policy.
+
+When stale, create a new provider thread with `full_thread_summary`.
+
+## Summarization Source
+
+Summaries can be generated by:
+
+- the provider being left,
+- the provider being entered,
+- a configured summarization provider,
+- a local deterministic summarizer for structured artifacts.
+
+The summary generator is not necessarily the target provider. The handoff records `createdByProvider` so quality and provenance can be inspected later.
+
+## What The Summary Should Contain
+
+The summary should be app-thread canonical, not provider transcript-only.
+
+Include:
+
+- user goals and constraints,
+- decisions made,
+- files changed,
+- commands/tests run,
+- plans/todo state,
+- unresolved approvals/questions,
+- current checkpoint/diff summary,
+- known failures,
+- relevant subagent results.
+
+Do not include:
+
+- irrelevant provider protocol noise,
+- hidden chain-of-thought,
+- stale tool output that is superseded by later runs,
+- large diffs when a file summary is enough.
+
+## Checkpoint Interaction
+
+Provider switching does not change checkpoint ownership. Checkpoints still attach to app runs.
+
+However, handoff generation should reference the latest checkpoint and diff summary so the next provider has a correct workspace-state picture.
+
+```text
+run N completed
+  -> checkpoint N captured
+switch provider for run N+1
+  -> handoff includes summary through checkpoint N
+```
+
+## Rollback Interaction
+
+Rollback invalidates handoffs that cover rolled-back runs.
+
+```text
+rollback to run 5
+  -> runs 6+ marked rolled_back
+  -> handoffs covering 6+ marked superseded
+  -> provider threads whose native/handoff coverage includes 6+ marked divergent or rolled back by capability
+```
+
+If the active provider supports provider rollback, call it. Otherwise, create a new provider thread from the retained app-thread summary when work resumes.
+
+## Forking Interaction
+
+Forking from a mixed-provider app thread should record app-thread lineage and a source point without requiring provider selection at fork time. Provider context is resolved lazily when the first run starts on the fork.
+
+Examples:
+
+- Fork from run 5 on Codex, first fork run uses Codex: prefer Codex native fork if the source refs are strong.
+- Fork from run 5 on Codex, first fork run uses Claude: build portable context lazily at first dispatch.
+- Fork from app checkpoint with no provider-native thread: create target provider thread with checkpoint/full-thread context.
+- Fork from subagent provider thread: use the subagent's provider thread directly if stable, otherwise fall back to portable context.
+
+## Data Model Changes
+
+Provider switching requires:
+
+- `Run.provider`
+- `Run.providerThreadId`
+- `Run.contextHandoffId`
+- `ContextTransfer`
+- `ProviderThread.firstRunOrdinal`
+- `ProviderThread.lastRunOrdinal`
+- `ProviderThread.handoffIds`
+- `ContextHandoff`
+- provider capabilities for handoff support
+
+The app does not need separate conversation threads for provider switches. It needs multiple provider threads attached to the same app thread.
diff --git a/docs/orchestration-v2/testing-strategy.md b/docs/orchestration-v2/testing-strategy.md
new file mode 100644
index 000000000000..7d9185bee4b6
--- /dev/null
+++ b/docs/orchestration-v2/testing-strategy.md
@@ -0,0 +1,233 @@
+# Testing Strategy
+
+V2 should be validated with a small number of high-value integration tests rather than a large suite of unit tests that mock away the behavior being tested.
+
+The goal is not "no test doubles ever." The goal is that test doubles exist only at true process, network, clock, id, and filesystem boundaries. Core orchestration behavior must run for real.
+
+## Testing Principle
+
+The default V2 test shape is:
+
+```text
+command dispatch
+  -> real Orchestrator
+  -> real ProviderAdapter
+  -> replayed ProviderRuntime transport
+  -> real adapter normalizer
+  -> real V2 event store/sink using production persistence semantics
+  -> real V2 projection/projector
+  -> real Checkpoint policy
+  -> assertions
+```
+
+The replay framework replaces the external provider process or network stream. It does not replace the adapter, normalizer, command/event infrastructure, projection reducers/projectors, checkpoint policy, or business logic.
+
+Raw provider frames in replay transcripts are realistic transport evidence. In production, equivalent raw frames are diagnostic log data with bounded retention. Integration tests should still use real normalized orchestration persistence/projections so replay input exercises the same adapter and orchestration paths as live provider output.
+
+## Allowed Test Substitutes
+
+Allowed substitutes:
+
+- provider runtime transport, backed by deterministic replay transcripts.
+- Effect runtime time, controlled in tests with `TestClock` from `effect/testing`.
+- Effect `Random`, provided with a deterministic test implementation for stable UUIDs/numbers.
+- temporary filesystem/worktree.
+- temporary database or in-memory database with the same repository interfaces.
+- fake process supervisor only when it is testing process failure behavior directly.
+
+Not allowed in integration tests:
+
+- mocked orchestrator.
+- mocked provider adapter.
+- mocked provider event normalizer.
+- mocked command/event infrastructure or V2 event sink.
+- mocked projection reducer.
+- mocked checkpoint service behavior.
+- mocked provider capability policy.
+- pre-normalized domain events used as the input for adapter tests.
+- custom clock/id services that duplicate Effect's `Clock`, `DateTime`, or `Random` services.
+
+Pure reducer tests are still valid, but they should be few and targeted. They should test projection invariants directly, not replace integration coverage.
+
+Production code should read time through Effect runtime APIs, such as `DateTime.now` and `Clock.currentTimeMillis`, not through `Date.now` or ad hoc wrappers. Production code should allocate random values through `effect/Random`, not through direct `crypto.randomUUID`, `Math.random`, or a custom global id generator.
+
+Tests should provide Effect test services:
+
+```ts
+import { TestClock } from "effect/testing";
+```
+
+The id allocator can still expose domain-specific helpers such as `newRunId` or `newNodeId`, but those helpers should be implemented on top of `Random` so test layers can produce deterministic values without mocking orchestration logic.
+
+## Generic Replay Runtime
+
+Replay must be provider-neutral. Codex NDJSON fixtures are one provider's transcript format, not the framework itself.
+
+```ts
+type ProviderReplayTranscript = {
+  provider: ProviderKind;
+  protocol: string;
+  version: string;
+  scenario: string;
+  entries: ProviderReplayEntry[];
+};
+
+type ProviderReplayEntry =
+  | {
+      type: "expect_outbound";
+      label?: string;
+      frame: unknown;
+    }
+  | {
+      type: "emit_inbound";
+      label?: string;
+      frame: unknown;
+      afterMs?: number;
+    }
+  | {
+      type: "runtime_exit";
+      status: "success" | "error" | "cancelled";
+      error?: unknown;
+    };
+```
+
+The replay runtime owns deterministic transport semantics:
+
+- ordered inbound event emission.
+- outbound command assertion.
+- pause/resume and timing control.
+- runtime exit/error simulation.
+- resume cursor/session restoration.
+- transcript metadata validation.
+
+The replay runtime must not know what a turn, plan, approval, subagent, or checkpoint means. Provider adapters interpret provider-specific frames.
+
+Recovery tests use replay only at the provider transport boundary. App restart is tested by tearing down and recreating the outermost orchestrator/server layer against durable persistence. Idle cleanup and crash recovery are tested through production lifecycle services such as the session reaper or runtime recovery policy. Tests must not add adapter or orchestrator methods whose only purpose is to restart sessions for assertions.
+
+## Provider Transcript Formats
+
+Each provider can have its own raw frame format inside the generic replay envelope.
+
+Examples:
+
+```text
+Codex replay transcript
+  -> JSON-RPC app-server requests/responses/notifications
+  -> consumed by CodexAdapter
+
+Claude replay transcript
+  -> Claude Agent SDK query() outbound options and yielded SDKMessage chunks
+  -> consumed by ClaudeAdapter
+
+Cursor replay transcript
+  -> Cursor Agent SDK open/send calls and ordered onDelta/run results
+  -> consumed by CursorAdapter
+
+OpenCode replay transcript
+  -> OpenCode SDK requests/responses plus ordered SSE events
+  -> consumed by OpenCodeAdapter
+
+ACP replay transcript
+  -> logical JSON-RPC requests/responses/notifications over a strict NDJSON peer
+  -> consumed by AcpAdapter and a provider flavor (Grok or ACP Registry)
+```
+
+Fixtures should preserve raw provider evidence as closely as possible. Expected V2 events or projections are assertions, not fixture input.
+
+For Claude, the initial replay boundary is the async iterable returned by the Agent SDK `query()`
+call. A transcript should include the `query` prompt/options we sent and then replay the raw
+`SDKMessage` chunks in provider order. This intentionally tests the V2 adapter against real Claude
+SDK output; it does not test the SDK's own subprocess or transport parser.
+
+ACP fixtures run against a child-process replay peer that validates every outbound frame and
+serves recorded inbound frames. This replaces only the external ACP driver transport; the shared
+runtime, adapter normalization, orchestration, persistence, and projections remain production code.
+The generic ACP Registry harness retargets protocol-standard ACP transcripts;
+provider-extension transcripts remain scoped to the flavor that owns the extension.
+
+OpenCode fixtures replace the SDK client at its HTTP/SSE boundary. They must preserve races between
+request responses and SSE events, because user messages and terminal `session.status` events can
+arrive before the corresponding `promptAsync` or `abort` response. Subagent fixtures must retain
+both parent and child session ids so root-only terminal behavior remains testable.
+
+Provider transcript recorders live with the server orchestration testkit, not with provider client
+packages. Use `bun run record:codex-replay -- --scenario <name>` for Codex app-server transcripts
+and `bun run record:claude-replay -- --scenario <name>` for Claude Agent SDK transcripts. Use
+`pnpm --filter t3 record:cursor-replay -- --scenario <name>` for Cursor Agent SDK transcripts.
+
+## Contract Test Levels
+
+Recommended levels:
+
+1. Schema tests for V2 contracts.
+2. Pure projection tests for hard invariants.
+3. Provider adapter replay tests from raw transcript to V2 domain events.
+4. Full orchestration integration tests from commands through replay runtime to final projection.
+
+The fourth level is the most important one. It is the test that catches lifecycle mismatches such as child turns closing parent runs or checkpoints being captured too early.
+
+## First Ten Integration Tests
+
+V2 should start with roughly ten strong tests:
+
+1. `simple`: sending one message creates one run, one root node, one provider turn, one assistant response, and one root checkpoint.
+2. `multi_turn`: follow-up messages create monotonically ordered app runs on the same app thread.
+3. `message_steering`: steering attaches to the active run intent instead of becoming an unrelated run.
+4. `turn_interrupt`: interrupt acknowledgement does not complete the run until the provider terminal event arrives.
+5. `steering_restart_fallback`: a provider without native steering interrupts the active attempt and creates a replacement attempt under the same run.
+6. `subagent`: child provider turns create nested execution nodes and never complete the parent run.
+7. `subagent_checkpoint`: child/subagent nodes create nested checkpoint scopes without advancing the app run count.
+8. `thread_rollback`: rollback targets checkpoint scopes and reconciles provider rollback snapshots.
+9. `approval_request`: provider approval callbacks become durable runtime requests and are resolved through the real adapter path.
+10. `provider_switch_return`: switching away from a provider creates a context handoff, and switching back resumes the prior provider thread with a delta handoff.
+
+Additional tests should be added only when they protect a new invariant or reproduce a real failure mode.
+
+## Fixture Rules
+
+- Fixtures are raw provider transcripts, not mocked domain events.
+- Fixtures should include enough outbound expectations to prove the app sent the correct provider commands.
+- Fixtures should include protocol metadata, provider version, model, cwd policy, and capture timestamp.
+- Fixture playback must be deterministic under Effect `TestClock` and deterministic `Random` layers.
+- When a provider transcript is generated from a real run, keep the original provider frame ordering.
+- Redaction should preserve ids, method names, lifecycle ordering, and correlation structure.
+- Fixture transcripts are test input and diagnostic evidence. They do not imply production stores all raw provider frames in SQLite.
+
+## Assertions
+
+Assertions should prefer final projections and durable normalized orchestration events over incidental implementation calls.
+
+Good assertions:
+
+- duplicate command dispatch returns the original receipt sequence without replaying provider transport.
+- stored-event sequence monotonicity.
+- snapshot sequence plus stream-after-sequence behavior.
+- run status and ordinal.
+- active/final run attempt.
+- execution node parent/child structure.
+- provider thread and provider turn correlation.
+- checkpoint scope hierarchy.
+- pending/resolved runtime requests.
+- handoff coverage and strategy.
+- replay transcript frame count and normalized event count when relevant.
+
+Weak assertions:
+
+- exact internal function call counts.
+- private helper invocation order.
+- mocked callback arguments below the adapter/runtime boundary.
+
+## Implementation Order
+
+Testing infrastructure should be built before production rewrites:
+
+1. V2 contract schemas.
+2. Effect service definitions.
+3. provider runtime transport abstraction.
+4. generic replay runtime.
+5. Codex, Claude, Cursor, OpenCode, and ACP transcript loaders for app-owned provider replay fixtures.
+6. projection reducer tests for core invariants.
+7. full command-to-projection integration tests.
+8. production layers.
+
+This keeps the architecture executable while it is being built and prevents tests from validating only simplified mocks.
diff --git a/docs/orchestration-v2/thread-lineage-and-context-transfer.md b/docs/orchestration-v2/thread-lineage-and-context-transfer.md
new file mode 100644
index 000000000000..a55d68e7041e
--- /dev/null
+++ b/docs/orchestration-v2/thread-lineage-and-context-transfer.md
@@ -0,0 +1,286 @@
+# Thread Lineage And Context Transfer
+
+Forking, provider handoff, merge-back, and subagents are separate product features, but they should share one orchestration model. The common primitive is not "fork" and not "summary". It is:
+
+```text
+thread relationship
+  + source point
+  + optional context transfer resolution
+```
+
+The app should preserve lineage cheaply and resolve expensive provider/context work lazily when a run actually needs it.
+
+## Product Use Cases
+
+### Fork To Explore
+
+A user forks an existing app thread to explore a tangent without polluting the source thread's context.
+
+```text
+source AppThread
+  -> user forks from stable source point
+  -> new idle AppThread
+  -> no provider chosen yet
+  -> first message chooses provider/model
+```
+
+If the first run on the fork uses the same provider as the source and the provider supports native fork, use the provider-native fork path. If it uses a different provider, materialize portable context at first dispatch.
+
+### Continue Same Thread With A Different Agent
+
+A user continues the same app thread with another provider. This is not a new app thread, but it is still a context transfer.
+
+```text
+AppThread runs 1-5 with Codex
+user sends run 6 with Claude
+  -> resolve context transfer from Codex-backed source state to Claude
+  -> start Claude provider thread with handoff context + user message
+```
+
+The app thread remains the canonical conversation. Provider-native threads are backing handles with explicit coverage.
+
+### Merge A Fork Back Into Its Source
+
+A user explores deeply in a fork, then brings the result back to the source thread.
+
+```text
+source thread at source point S
+fork explores runs F1-Fn
+user sends next message in source thread with "bring this back"
+  -> build delta from S to fork latest stable point
+  -> inject delta context with the source-thread user message
+```
+
+This is not a full source-thread provider switch. It is a targeted context transfer from the fork back to the original thread.
+
+### Subagents
+
+Subagents are the same family of operation with a different creator and lifecycle contract.
+
+Native subagents:
+
+- the provider spawns the child through its native capability;
+- the app observes native child refs/events;
+- the child is modeled as a child execution node and, when useful, as a related app subthread.
+
+Cross-provider T3 subagents:
+
+- the parent agent calls an app-owned tool;
+- the app creates a child app thread/run with a relationship to the parent;
+- the child result is transferred back to the parent as a subagent result context transfer.
+
+The shared model should make user forks and agent-created subthreads feel like the same graph shape with different `createdBy` and lifecycle policy.
+
+## Core Concepts
+
+### Thread Relationship
+
+Thread relationship describes why a target thread or run exists relative to another thread.
+
+```ts
+type ThreadRelationshipKind =
+  | "fork"
+  | "provider_handoff"
+  | "merge_back"
+  | "subagent_spawn"
+  | "subagent_result";
+```
+
+Relationships are product-level and provider-neutral. A fork is not the same thing as a provider-native fork. A provider-native fork is one possible resolution strategy for a fork relationship.
+
+### Source Point
+
+Source point describes the exact state being transferred.
+
+```ts
+type ContextSourcePoint = {
+  threadId: ThreadId;
+  runId?: RunId;
+  checkpointId?: CheckpointId;
+  turnItemId?: TurnItemId;
+  providerThreadRef?: NativeThreadRef;
+  providerTurnRef?: NativeTurnRef;
+};
+```
+
+Stable source points should prefer completed runs/checkpoints. Active runs are harder because provider chunks may still arrive and checkpoints may not be final.
+
+### Context Transfer
+
+Context transfer is the durable operational record that connects source and target. It is cheap to create and may stay unresolved until first use.
+
+```ts
+type ContextTransfer = {
+  id: ContextTransferId;
+  type: ThreadRelationshipKind;
+  sourceThreadId: ThreadId;
+  targetThreadId: ThreadId;
+  sourcePoint: ContextSourcePoint;
+  basePoint?: ContextSourcePoint;
+  sourceProvider?: ProviderKind;
+  targetProvider?: ProviderKind;
+  status:
+    | "pending"
+    | "resolved_native"
+    | "resolved_portable"
+    | "failed"
+    | "consumed"
+    | "superseded";
+  resolution?: ContextTransferResolution;
+  createdBy: "user" | "agent" | "system";
+  createdAt: string;
+  consumedAt?: string;
+};
+```
+
+`basePoint` is used for delta transfers, especially merge-back. For a fork merge-back, `basePoint` is the original fork source point and `sourcePoint` is the fork's latest stable point.
+
+### Context Handoff
+
+Context handoff is the expensive materialized context artifact. It is created lazily only when native transfer is unavailable or insufficient.
+
+```ts
+type ContextHandoff = {
+  id: ContextHandoffId;
+  transferId: ContextTransferId;
+  kind: "portable_context" | "delta_context" | "checkpoint_context";
+  payload: PortableContextPayload;
+  createdAt: string;
+};
+```
+
+Context handoffs should be auditable app artifacts, not hidden prompt concatenation.
+
+### Resolution Strategy
+
+Resolution decides how the target provider/thread receives the source context.
+
+```ts
+type ContextTransferResolution =
+  | {
+      strategy: "native_fork";
+      providerThreadRef: NativeThreadRef;
+    }
+  | {
+      strategy: "portable_context";
+      contextHandoffId: ContextHandoffId;
+    }
+  | {
+      strategy: "delta_context";
+      contextHandoffId: ContextHandoffId;
+    }
+  | {
+      strategy: "checkpoint_context";
+      contextHandoffId: ContextHandoffId;
+    };
+```
+
+Same-provider forks should prefer `native_fork` when the source native refs are strong and the adapter supports it. Cross-provider handoff and merge-back usually require a context handoff.
+
+## Lazy Resolution
+
+Fork creation should be cheap:
+
+```text
+thread.fork
+  -> create target AppThread
+  -> record thread relationship / ContextTransfer(status=pending)
+  -> do not create provider session
+  -> do not create provider thread
+  -> do not build portable context
+```
+
+First dispatch on a pending fork resolves the transfer:
+
+```text
+first run on fork chooses provider P
+  -> find pending fork ContextTransfer
+  -> if source provider == P and native fork is supported:
+       resolve native fork
+     else:
+       materialize portable context
+  -> create/resume provider thread
+  -> send handoff/native context + user message
+```
+
+This avoids forcing users to choose an agent at fork time and avoids generating summaries that may never be used.
+
+## Runtime Entry Point
+
+Run startup should have one provider-neutral hook:
+
+```ts
+resolveStartContext({
+  threadId,
+  provider,
+  message,
+}): StartContextResolution
+```
+
+This hook checks pending context transfers targeting the thread/run and chooses a strategy:
+
+1. No transfer needed: target provider already has current coverage.
+2. Native transfer: same provider and adapter supports native fork/resume.
+3. Portable transfer: build a context handoff and inject it into the run.
+4. Delta transfer: build the changes between `basePoint` and `sourcePoint`.
+5. Unsupported: fail explicitly before provider work starts.
+
+Provider adapters own native details. The orchestrator owns the relationship, source point, durable transfer record, and command receipts.
+
+For Codex, native `thread/fork` forks the latest native thread state. When the app source point is an earlier completed provider turn, the Codex adapter resolves that provider-specific detail by forking first, then rolling back the forked native thread by the number of later terminal provider turns. The orchestrator still passes a provider-neutral source point and source provider-turn history; it does not encode Codex rollback policy.
+
+## Data Ownership
+
+`AppThread` should store lightweight browsing lineage:
+
+```ts
+type AppThreadLineage = {
+  parentThreadId: ThreadId | null;
+  relationshipToParent: "fork" | "subagent" | null;
+  rootThreadId: ThreadId;
+};
+```
+
+Operational transfer details should live in `ContextTransfer`, not directly on `AppThread`, because a thread can participate in many transfers:
+
+- created by fork;
+- later switched to another provider;
+- later merged back to its source;
+- later spawned subagents.
+
+## Checkpoint And Active-Run Policy
+
+The first implementation should prefer stable source points:
+
+- completed run checkpoint;
+- explicit checkpoint;
+- idle provider thread with known coverage.
+
+Forking or handoff from an active run should either:
+
+- use the latest completed checkpoint, or
+- be rejected until active-run semantics are designed.
+
+Do not silently fork from partially streamed provider state. That weakens correlation and makes replay/recovery difficult.
+
+## Current Implementation Boundary
+
+The first backend slice implements lazy same-provider fork resolution:
+
+- `thread.fork` creates a target app thread with fork lineage and a pending `ContextTransfer`.
+- `thread.fork` does not create a provider session, provider thread, provider turn, or portable context artifact.
+- The first dispatch on the fork resolves the pending transfer. For Codex-to-Codex forks with strong native refs and `thread/fork` support, the orchestrator uses the provider-native fork path and records `resolved_native` then `consumed`.
+- Cross-provider or otherwise non-native fork transfers materialize a portable `ContextHandoff`
+  lazily on the target thread's first dispatch.
+- Active source runs are rejected for explicit run/checkpoint forks; `latest_stable` resolves to the latest completed checkpointed run.
+
+This keeps the runtime aligned with the architecture while making portable context explicit and
+auditable through `ContextTransfer` and `ContextHandoff` records.
+
+## Relationship To Provider Switching
+
+Provider switching is a context transfer where `sourceThreadId === targetThreadId` and the target provider differs from the current active provider.
+
+Returning to a prior provider is also a context transfer, usually a delta from the provider's last covered run range to the current app-thread point.
+
+The [Provider Switching And Context Handoff](./provider-switching-and-context.md) document describes strategy selection for that specific feature. This document defines the broader model shared by provider switching, forks, merge-back, and subagents.
diff --git a/docs/user/activity-log.md b/docs/user/activity-log.md
new file mode 100644
index 000000000000..cd909b3c9be6
--- /dev/null
+++ b/docs/user/activity-log.md
@@ -0,0 +1,17 @@
+# Activity log
+
+On web and desktop, consecutive tool calls appear as an expandable summary. Open it to inspect
+each command or tool result.
+
+T3 Orchestrator summaries describe the actions taken, such as **Ran 2 commands and sent messages
+to 3 threads**. Repeated messages to the same destinations show both counts: **Sent 5 messages to
+2 threads**. Thread creation counts the threads returned by the tool, including batches.
+
+Groups with many kinds of activity show up to two specific action categories and a count of the
+remaining actions. Commands, file changes, and orchestration changes take priority over reads and
+status checks. Expand the group for the full list.
+
+Failed calls are counted separately and do not count as successful messages or creations. Waiting
+on a thread does not mean it finished, and an interrupt or cancellation request does not mean the
+thread stopped. When tool details are unavailable, summaries use a broader description instead of
+guessing how many threads were affected.
diff --git a/docs/user/appearance.md b/docs/user/appearance.md
new file mode 100644
index 000000000000..21102873af24
--- /dev/null
+++ b/docs/user/appearance.md
@@ -0,0 +1,11 @@
+# Appearance
+
+Open **Settings → Appearance** to change how T3 Code presents the interface.
+
+## Composer context
+
+Git-backed projects show branch and worktree controls below the composer while you create a thread.
+The controls retreat as the composer docks after you send the first message.
+
+Turn on **Composer context** to keep those controls visible after the thread starts. This preference
+applies to the web and desktop clients.
diff --git a/docs/user/composer.md b/docs/user/composer.md
index 357616d8ed3e..c72a4419e3b0 100644
--- a/docs/user/composer.md
+++ b/docs/user/composer.md
@@ -32,6 +32,26 @@ uploaded. Stashed files stay uploaded on the server for 24 hours. If you restore
 that, the file comes back with **Attach again** next to it. Attach the file again or remove it, then
 send.
 
+## Queued messages
+
+On web and desktop, the composer shows **Interrupt** while the agent is working and the draft is
+empty. Adding text or attachments replaces it with a steer arrow. Click it to send a message into
+the active turn, or press `Enter` on desktop. Hold `Cmd` on macOS or `Ctrl` on Windows and Linux to
+switch the button to a queue icon. Click while holding that key, or press `Cmd+Enter` or
+`Ctrl+Enter` on desktop, to queue the message for after the active turn.
+
+Queued messages appear above the composer. Rows show a thumbnail of any attached image alongside
+the text. Drag a row by its handle to reorder it, use the handle's arrow keys, promote the message
+to a steer, or remove it.
+
+The pencil on a queued row opens that message in the composer for editing. The original message
+stays in the queue until you save, and its row is highlighted while you edit. The message's
+attachments appear above the text with a remove control, and new images can be added the usual way.
+The checkmark saves the queued message in place; **Cancel** on its row leaves it unchanged. Whatever
+you had typed in the composer before starting the edit is restored afterwards. If the queued
+message starts or is removed while you are editing, the edit ends: changed content moves into the
+composer when it is empty, and is discarded otherwise.
+
 ## Commands and skills
 
 Type `/` to open the command menu. Type `$` to find and add a skill. Skill rows show their source,
diff --git a/docs/user/cursor.md b/docs/user/cursor.md
new file mode 100644
index 000000000000..4c18b010fcbf
--- /dev/null
+++ b/docs/user/cursor.md
@@ -0,0 +1,68 @@
+# Cursor
+
+Cursor V2 runs through the official [`@cursor/sdk`](https://cursor.com/docs/api/sdk/typescript)
+TypeScript package. It does not use Cursor's ACP transport for V2 execution.
+
+## Prerequisites
+
+- Node.js 22.13 or newer. The repository's supported Node version satisfies this requirement.
+- A Cursor API key in `CURSOR_API_KEY`. Provider-instance environment variables override the host
+  environment in the same way as the other providers.
+- A model accepted by the Cursor SDK. `auto` is sent to the SDK as its `default` model selection.
+
+The adapter currently uses the SDK's local-agent runtime so runs operate in the selected T3 Code
+workspace. Cursor cloud agents need repository and cloud-environment configuration that T3 Code does
+not expose yet.
+
+## V2 Capability Mapping
+
+The adapter supports:
+
+- creating and resuming local Cursor agent threads;
+- changing the model and model parameters between turns;
+- assistant text, reasoning, tool output, plans, and todo streaming;
+- thread-scoped T3 Code MCP tools;
+- image attachments;
+- interruption, queued app messages, and orchestrator-owned interrupt/restart steering;
+- provider conversation snapshots through `Agent.messages.list()`;
+- Cursor `task` subagents, projected as read-only child app threads with their tool activity and
+  final result.
+
+The public SDK does not currently expose native agent fork, conversation rollback, active steering,
+or interactive approval callbacks. Direct active steering is advertised as unsupported, while V2
+steering uses the orchestrator's interrupt-and-restart path and preserves the app run identity across
+provider turns. Same-provider Cursor forks use the orchestrator's portable full-thread context
+handoff into a fresh Cursor agent. The SDK has in-process custom callback tools, but the V2 adapter
+intentionally uses the authenticated, thread-scoped MCP server instead.
+
+Portable handoffs summarize eligible timeline items and can omit the end of long messages. Read
+[Context in portable handoffs](./portable-handoffs.md) before using a fork for work whose exact
+instructions must carry forward.
+
+Cursor task events include an `agentId`, but the local SDK does not register that identifier as a
+resumable agent: `Agent.resume()` returns `AgentNotFoundError`. The adapter therefore does not attach
+a provider thread to native task projections or advertise subagent thread IDs. Sending a new message
+from a projected child starts a new Cursor agent rather than pretending to resume the task runtime.
+
+Runtime modes map to the controls the local SDK exposes: full access disables its sandbox, while
+restricted modes and explicit non-full-access sandbox policies enable it. Explicit approval policy
+overrides also control Cursor Auto-review. Auto-review is not represented as an interactive T3 Code
+approval flow.
+
+The existing Cursor binary path and API endpoint settings belong to the CLI/ACP integration. Cursor
+V2 execution does not launch that binary, and the SDK does not expose an API endpoint override.
+
+## Replay And Live Testing
+
+Cursor replay fixtures preserve the SDK boundary: agent open/resume, sends, ordered `onDelta`
+updates, terminal results, cancellation, message snapshots, and close. The real V2 adapter,
+orchestrator, event store, projections, and checkpoint logic still run in tests.
+
+Record a fixture against the real SDK with:
+
+```bash
+pnpm --filter t3 record:cursor-replay -- --scenario simple
+```
+
+Use `--out <path>` to record a temporary probe without replacing a checked-in fixture. Supported
+scenarios are listed by the recorder when an invalid scenario is supplied.
diff --git a/docs/user/portable-handoffs.md b/docs/user/portable-handoffs.md
new file mode 100644
index 000000000000..9555b2f426c0
--- /dev/null
+++ b/docs/user/portable-handoffs.md
@@ -0,0 +1,19 @@
+# Context in portable handoffs
+
+T3 Code sometimes starts a fresh provider session instead of resuming a provider's native session.
+This happens when you switch providers, continue through portable restart steering, or use a fork
+that the provider cannot resume itself.
+
+The new provider receives a text handoff. This handoff is useful context, but it is not a copy of
+the original provider session. For each included user message, assistant message, command, or prior
+handoff, T3 Code collapses whitespace and keeps up to 240 characters from the beginning. File
+changes appear by filename, and checkpoints appear with a file count. Other timeline items may not
+appear in the handoff.
+
+Text near the end of a long message can be omitted. Before switching providers or continuing a
+portable fork, put the current goal, hard constraints, and any unresolved failure in a short message.
+You can also paste the exact detail again after the new provider starts.
+
+This 240-character rule is different from migration of older threads. A migrated thread gives its
+first fresh provider session the newest transcript suffix within a separate 32,000-character budget.
+See [Threads from older T3 Code versions](./thread-migration.md) for that migration path.
diff --git a/docs/user/thread-migration.md b/docs/user/thread-migration.md
new file mode 100644
index 000000000000..6c573f26a0d2
--- /dev/null
+++ b/docs/user/thread-migration.md
@@ -0,0 +1,61 @@
+# Threads from older T3 Code versions
+
+When a server first starts with the current orchestration system, it brings its existing threads
+forward automatically. You do not need to run an import command.
+
+The migrated thread keeps its title, project, provider and model selection, permission and
+interaction modes, branch or worktree, archive state, settlement state, snooze and pin state, and
+linked pull request. T3 Code also brings over user and assistant messages, their timestamps, and
+supported attachments. Large histories may appear in stages while the server imports transcripts.
+
+The migration does not recreate the old provider's live session. It also does not convert old run
+records, checkpoints and diffs, tool activity, approval history, or proposed plan history into the
+new format. These items may be absent from a migrated timeline even though the conversation text is
+present.
+
+## Continuing a migrated thread
+
+The first new message starts a fresh provider session. T3 Code gives that session the newest part of
+the old user and assistant transcript, up to 32,000 characters. Earlier text remains visible in the
+thread, but the provider does not receive it automatically.
+
+Before continuing a long or important thread, read the recent transcript and include any older
+requirements the agent still needs in your next message. Starting a new thread and pasting a short
+handoff is also a good choice when the old conversation contains conflicting instructions.
+
+## Keeping a recovery copy
+
+T3 Code does not currently have a whole-thread export command. Before a major server update, stop
+the server and copy its `userdata` directory to a safe location. The default is
+`~/.t3/userdata`; a server started with `--home-dir <path>` uses `<path>/userdata`.
+
+If a migrated transcript is missing from the app, keep that copy unchanged. You can inspect the
+old transcript without starting a server against it:
+
+```sh
+sqlite3 -readonly /path/to/recovery-copy/state.sqlite
+```
+
+At the SQLite prompt, list recent legacy threads:
+
+```sql
+.headers on
+.mode tabs
+SELECT thread_id, title, updated_at
+FROM projection_threads
+ORDER BY updated_at DESC;
+```
+
+Then print one transcript, replacing `<thread-id>` with the value from the first query:
+
+```sql
+SELECT role, text, created_at
+FROM projection_thread_messages
+WHERE thread_id = '<thread-id>'
+  AND role IN ('user', 'assistant')
+ORDER BY created_at, message_id;
+```
+
+Open only the copied database. Do not edit it or point a newer or older server at your recovery
+copy. If the affected environment is remote, make and inspect the copy on the machine that runs
+that environment.
diff --git a/docs/user/updating.md b/docs/user/updating.md
index 564d05fd431f..0130ac761d74 100644
--- a/docs/user/updating.md
+++ b/docs/user/updating.md
@@ -20,6 +20,10 @@ connection will disappear briefly and work that is still running may be interrup
 
 The update does not remove saved threads, settings, or project files.
 
+Updates from the previous orchestration system preserve conversation transcripts but cannot carry
+every kind of runtime history forward. Read [Threads from older T3 Code versions](./thread-migration.md)
+before continuing an important older thread.
+
 ## Choose the Action You See
 
 | Action                     | What to do                                                                                                                                                                  |
diff --git a/oxlint-plugin-t3code/rules/no-mobile-uniwind-theme-escape-hatches.ts b/oxlint-plugin-t3code/rules/no-mobile-uniwind-theme-escape-hatches.ts
index 5e6a7111e816..555e58ba052c 100644
--- a/oxlint-plugin-t3code/rules/no-mobile-uniwind-theme-escape-hatches.ts
+++ b/oxlint-plugin-t3code/rules/no-mobile-uniwind-theme-escape-hatches.ts
@@ -25,6 +25,8 @@ const THEME_INTEROP_ALLOWLIST = new Set([
   "features/threads/NewTaskDraftScreen.tsx",
   "features/threads/ThreadComposer.tsx",
   "features/threads/ThreadFeed.tsx",
+  "features/threads/ThreadQueueControl.tsx",
+  "features/threads/ThreadRelationshipsBanner.tsx",
   "features/threads/ThreadSettingsSheet.tsx",
   "features/threads/git/GitOverviewSheet.tsx",
   "features/threads/thread-list-items.tsx",
diff --git a/package.json b/package.json
index 3fc66d0dd021..a71c96408571 100644
--- a/package.json
+++ b/package.json
@@ -27,6 +27,7 @@
     "lint": "vp lint --report-unused-disable-directives",
     "lint:mobile": "node scripts/mobile-native-static-check.ts",
     "test": "vp run -r test",
+    "test:perf:v2-wire": "vp test run apps/server/src/orchestration-v2/WireProjection.test.ts apps/server/src/orchestration-v2/threadHistoryPaging.test.ts apps/server/src/orchestration-v2/ThreadStream.test.ts apps/server/src/orchestration-v2/ShellStream.test.ts packages/contracts/src/environmentHttp.test.ts packages/contracts/src/orchestrationV2.test.ts packages/client-runtime/src/operations/commands.test.ts packages/client-runtime/src/state/boundedThreadSnapshotHttp.test.ts packages/client-runtime/src/state/threadHistoryController.test.ts packages/client-runtime/src/state/threadHistoryMerge.test.ts packages/client-runtime/src/state/threadDetail.test.ts packages/client-runtime/src/state/threads-sync.test.ts packages/client-runtime/src/state/shellReducer.test.ts",
     "test:resource-monitor": "cargo test --locked --manifest-path native/resource-monitor/Cargo.toml",
     "test:desktop-smoke": "vp run --filter @t3tools/desktop smoke-test",
     "fmt": "vp fmt",
diff --git a/packages/client-runtime/package.json b/packages/client-runtime/package.json
index b14bb8738e26..3a96192efb7a 100644
--- a/packages/client-runtime/package.json
+++ b/packages/client-runtime/package.json
@@ -43,6 +43,10 @@
       "types": "./src/providerSkills.ts",
       "default": "./src/providerSkills.ts"
     },
+    "./t3ToolSummary": {
+      "types": "./src/t3ToolSummary.ts",
+      "default": "./src/t3ToolSummary.ts"
+    },
     "./relay": {
       "types": "./src/relay/index.ts",
       "default": "./src/relay/index.ts"
@@ -75,6 +79,10 @@
       "types": "./src/state/git.ts",
       "default": "./src/state/git.ts"
     },
+    "./state/item-support": {
+      "types": "./src/state/itemSupport.ts",
+      "default": "./src/state/itemSupport.ts"
+    },
     "./state/models": {
       "types": "./src/state/models.ts",
       "default": "./src/state/models.ts"
@@ -83,6 +91,10 @@
       "types": "./src/state/orchestration.ts",
       "default": "./src/state/orchestration.ts"
     },
+    "./state/orchestration-v2-projection": {
+      "types": "./src/state/orchestrationV2Projection.ts",
+      "default": "./src/state/orchestrationV2Projection.ts"
+    },
     "./state/presentation": {
       "types": "./src/state/presentation.ts",
       "default": "./src/state/presentation.ts"
@@ -147,6 +159,26 @@
       "types": "./src/state/threadSort.ts",
       "default": "./src/state/threadSort.ts"
     },
+    "./state/thread-relationships": {
+      "types": "./src/state/threadRelationships.ts",
+      "default": "./src/state/threadRelationships.ts"
+    },
+    "./state/thread-checkpoints": {
+      "types": "./src/state/threadCheckpoints.ts",
+      "default": "./src/state/threadCheckpoints.ts"
+    },
+    "./state/thread-execution": {
+      "types": "./src/state/threadExecution.ts",
+      "default": "./src/state/threadExecution.ts"
+    },
+    "./state/thread-requests": {
+      "types": "./src/state/threadRequests.ts",
+      "default": "./src/state/threadRequests.ts"
+    },
+    "./state/thread-workflows": {
+      "types": "./src/state/threadWorkflows.ts",
+      "default": "./src/state/threadWorkflows.ts"
+    },
     "./state/thread-settled": {
       "types": "./src/state/threadSettled.ts",
       "default": "./src/state/threadSettled.ts"
@@ -155,6 +187,10 @@
       "types": "./src/state/threadSearch.ts",
       "default": "./src/state/threadSearch.ts"
     },
+    "./state/turn-item-presentation": {
+      "types": "./src/state/turnItemPresentation.ts",
+      "default": "./src/state/turnItemPresentation.ts"
+    },
     "./state/vcs": {
       "types": "./src/state/vcs.ts",
       "default": "./src/state/vcs.ts"
diff --git a/packages/client-runtime/src/connection/compatibility.test.ts b/packages/client-runtime/src/connection/compatibility.test.ts
new file mode 100644
index 000000000000..5fc4faf8db0c
--- /dev/null
+++ b/packages/client-runtime/src/connection/compatibility.test.ts
@@ -0,0 +1,57 @@
+import {
+  EnvironmentId,
+  ORCHESTRATION_PROTOCOL_VERSION,
+  type ExecutionEnvironmentDescriptor,
+} from "@t3tools/contracts";
+import { describe, expect, it } from "vite-plus/test";
+
+import {
+  appendOrchestrationProtocol,
+  orchestrationProtocolCompatibilityError,
+} from "./compatibility.ts";
+
+const descriptor = (orchestrationProtocolVersion?: number): ExecutionEnvironmentDescriptor => ({
+  environmentId: EnvironmentId.make("environment-remote"),
+  label: "Build Mac",
+  platform: { os: "darwin", arch: "arm64" },
+  serverVersion: "9.0.0",
+  ...(orchestrationProtocolVersion === undefined ? {} : { orchestrationProtocolVersion }),
+  capabilities: { repositoryIdentity: true },
+});
+
+describe("orchestration protocol compatibility", () => {
+  it("accepts the current protocol and announces it without disturbing socket credentials", () => {
+    expect(
+      orchestrationProtocolCompatibilityError(descriptor(ORCHESTRATION_PROTOCOL_VERSION)),
+    ).toBeNull();
+
+    const socketUrl = new URL(
+      appendOrchestrationProtocol("wss://host.test/ws?wsTicket=secret&connectionMethod=relay"),
+    );
+    expect(socketUrl.searchParams.get("orchestrationProtocol")).toBe(
+      String(ORCHESTRATION_PROTOCOL_VERSION),
+    );
+    expect(socketUrl.searchParams.get("wsTicket")).toBe("secret");
+    expect(socketUrl.searchParams.get("connectionMethod")).toBe("relay");
+  });
+
+  it("blocks a host that predates negotiation with host-specific upgrade guidance", () => {
+    const error = orchestrationProtocolCompatibilityError(descriptor());
+
+    expect(error).toMatchObject({ reason: "unsupported" });
+    expect(error?.message).toContain("Update T3 Code on Build Mac");
+    expect(error?.message).toContain(`protocol ${ORCHESTRATION_PROTOCOL_VERSION}`);
+  });
+
+  it("blocks a different explicit protocol instead of attempting to decode it", () => {
+    const error = orchestrationProtocolCompatibilityError(
+      descriptor(ORCHESTRATION_PROTOCOL_VERSION + 1),
+    );
+
+    expect(error).toMatchObject({ reason: "unsupported" });
+    expect(error?.message).toContain(
+      `host uses orchestration protocol ${ORCHESTRATION_PROTOCOL_VERSION + 1}`,
+    );
+    expect(error?.message).toContain(`client requires ${ORCHESTRATION_PROTOCOL_VERSION}`);
+  });
+});
diff --git a/packages/client-runtime/src/connection/compatibility.ts b/packages/client-runtime/src/connection/compatibility.ts
new file mode 100644
index 000000000000..e0c4b6f38c24
--- /dev/null
+++ b/packages/client-runtime/src/connection/compatibility.ts
@@ -0,0 +1,27 @@
+import {
+  ORCHESTRATION_PROTOCOL_QUERY_PARAM,
+  ORCHESTRATION_PROTOCOL_VERSION,
+  type ExecutionEnvironmentDescriptor,
+} from "@t3tools/contracts";
+
+import { ConnectionBlockedError } from "./model.ts";
+
+export function orchestrationProtocolCompatibilityError(
+  descriptor: ExecutionEnvironmentDescriptor,
+): ConnectionBlockedError | null {
+  if (descriptor.orchestrationProtocolVersion === ORCHESTRATION_PROTOCOL_VERSION) {
+    return null;
+  }
+  const hostProtocol = descriptor.orchestrationProtocolVersion;
+  const detail =
+    hostProtocol === undefined
+      ? `Update T3 Code on ${descriptor.label} before reconnecting. This host predates orchestration protocol ${ORCHESTRATION_PROTOCOL_VERSION}.`
+      : `Update T3 Code on ${descriptor.label} and this client before reconnecting. The host uses orchestration protocol ${hostProtocol}, while this client requires ${ORCHESTRATION_PROTOCOL_VERSION}.`;
+  return new ConnectionBlockedError({ reason: "unsupported", detail });
+}
+
+export function appendOrchestrationProtocol(socketUrl: string): string {
+  const url = new URL(socketUrl);
+  url.searchParams.set(ORCHESTRATION_PROTOCOL_QUERY_PARAM, String(ORCHESTRATION_PROTOCOL_VERSION));
+  return url.toString();
+}
diff --git a/packages/client-runtime/src/connection/registry.test.ts b/packages/client-runtime/src/connection/registry.test.ts
index 2d0ce41daf7c..c7cb79063263 100644
--- a/packages/client-runtime/src/connection/registry.test.ts
+++ b/packages/client-runtime/src/connection/registry.test.ts
@@ -1,7 +1,7 @@
 import {
   type DesktopSshEnvironmentTarget,
   EnvironmentId,
-  type OrchestrationShellSnapshot,
+  type OrchestrationV2ShellSnapshot,
 } from "@t3tools/contracts";
 import { describe, expect, it } from "@effect/vitest";
 import * as Context from "effect/Context";
@@ -50,6 +50,7 @@ import * as EnvironmentRegistry from "./registry.ts";
 import * as RpcSession from "../rpc/session.ts";
 import * as EnvironmentSupervisor from "./supervisor.ts";
 import * as ConnectionWakeups from "./wakeups.ts";
+import { v2ShellSnapshot } from "../state/orchestrationV2TestFixtures.ts";
 
 const TARGET = new PrimaryConnectionTarget({
   environmentId: EnvironmentId.make("environment-1"),
@@ -116,11 +117,9 @@ const SSH_PROFILE = new SshConnectionProfile({
   target: SSH_TARGET,
 });
 
-const CACHED_SNAPSHOT: OrchestrationShellSnapshot = {
+const CACHED_SNAPSHOT: OrchestrationV2ShellSnapshot = {
+  ...v2ShellSnapshot,
   snapshotSequence: 1,
-  projects: [],
-  threads: [],
-  updatedAt: "2026-06-06T00:00:00.000Z",
 };
 
 interface SessionControl {
diff --git a/packages/client-runtime/src/connection/resolver.test.ts b/packages/client-runtime/src/connection/resolver.test.ts
index 68f4d11030b5..2c370fc9dd44 100644
--- a/packages/client-runtime/src/connection/resolver.test.ts
+++ b/packages/client-runtime/src/connection/resolver.test.ts
@@ -1,4 +1,8 @@
-import { EnvironmentId, type DesktopSshEnvironmentTarget } from "@t3tools/contracts";
+import {
+  EnvironmentId,
+  ORCHESTRATION_PROTOCOL_VERSION,
+  type DesktopSshEnvironmentTarget,
+} from "@t3tools/contracts";
 import { RelayEnvironmentConnectScope } from "@t3tools/contracts/relay";
 import { RelayClientTracer } from "@t3tools/shared/relayTracing";
 import { describe, expect, it } from "@effect/vitest";
@@ -30,6 +34,7 @@ import {
   type ConnectionTarget,
 } from "./model.ts";
 import * as ConnectionProfileStore from "./profileStore.ts";
+import { remoteHttpClientLayer } from "../rpc/http.ts";
 
 const ENVIRONMENT_ID = EnvironmentId.make("environment-1");
 const ENDPOINT = {
@@ -97,6 +102,7 @@ const makeDependencies = Effect.fn("TestConnectionResolver.makeDependencies")((o
   readonly authorizeDpop?: RemoteEnvironmentAuthorization.RemoteEnvironmentAuthorization["Service"]["authorizeDpop"];
   readonly primaryBearerToken?: string;
   readonly prepareSsh?: ClientCapabilities.SshEnvironmentGateway["Service"]["prepare"];
+  readonly descriptorProtocolVersion?: number | null | undefined;
 }) => {
   const profiles = new Map(
     (options?.profiles ?? []).map((profile) => [profile.connectionId, profile]),
@@ -162,6 +168,21 @@ const makeDependencies = Effect.fn("TestConnectionResolver.makeDependencies")((o
   });
 
   const dependencies = Layer.mergeAll(
+    remoteHttpClientLayer((() =>
+      Promise.resolve(
+        Response.json({
+          environmentId: ENVIRONMENT_ID,
+          label: "Compatible environment",
+          platform: { os: "linux", arch: "x64" },
+          serverVersion: "0.0.0-test",
+          ...(options?.descriptorProtocolVersion === undefined
+            ? { orchestrationProtocolVersion: ORCHESTRATION_PROTOCOL_VERSION }
+            : options.descriptorProtocolVersion === null
+              ? {}
+              : { orchestrationProtocolVersion: options.descriptorProtocolVersion }),
+          capabilities: { repositoryIdentity: true },
+        }),
+      )) satisfies typeof fetch),
     Layer.succeed(ConnectionProfileStore.ConnectionProfileStore, profileStore),
     Layer.succeed(ConnectionCredentialStore.ConnectionCredentialStore, credentialStore),
     Layer.succeed(
@@ -208,6 +229,24 @@ const makeDependencies = Effect.fn("TestConnectionResolver.makeDependencies")((o
 });
 
 describe("ConnectionResolver", () => {
+  it.effect("blocks an old host during discovery before opening orchestration RPC", () =>
+    Effect.gen(function* () {
+      const brokerLayer = yield* makeDependencies({ descriptorProtocolVersion: null });
+      const broker = yield* ConnectionResolver.ConnectionResolver.pipe(Effect.provide(brokerLayer));
+      const target = new PrimaryConnectionTarget({
+        environmentId: ENVIRONMENT_ID,
+        label: "Primary",
+        httpBaseUrl: "http://127.0.0.1:3777",
+        wsBaseUrl: "ws://127.0.0.1:3777",
+      });
+
+      const error = yield* Effect.flip(broker.prepare(catalogEntry(target)));
+
+      expect(error).toMatchObject({ reason: "unsupported" });
+      expect(error.message).toContain("Update T3 Code on Compatible environment");
+    }),
+  );
+
   it.effect("prepares a primary environment without remote capabilities", () =>
     Effect.gen(function* () {
       const brokerLayer = yield* makeDependencies();
@@ -224,7 +263,7 @@ describe("ConnectionResolver", () => {
         label: "Primary",
         httpBaseUrl: "http://127.0.0.1:3777",
         socketUrl:
-          "ws://127.0.0.1:3777/ws?clientSurface=web&clientDeviceType=desktop&connectionMethod=direct",
+          "ws://127.0.0.1:3777/ws?clientSurface=web&clientDeviceType=desktop&connectionMethod=direct&orchestrationProtocol=2",
         httpAuthorization: null,
         target,
       });
@@ -262,7 +301,7 @@ describe("ConnectionResolver", () => {
       });
 
       expect(yield* broker.prepare(catalogEntry(target))).toMatchObject({
-        socketUrl: "ws://127.0.0.1:3777/ws?wsTicket=desktop",
+        socketUrl: "ws://127.0.0.1:3777/ws?wsTicket=desktop&orchestrationProtocol=2",
         httpAuthorization: { _tag: "Bearer", token: "desktop-bearer" },
         target,
       });
diff --git a/packages/client-runtime/src/connection/resolver.ts b/packages/client-runtime/src/connection/resolver.ts
index a786ed9f9d8d..d28dc534a09c 100644
--- a/packages/client-runtime/src/connection/resolver.ts
+++ b/packages/client-runtime/src/connection/resolver.ts
@@ -6,6 +6,7 @@ import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
 import * as Option from "effect/Option";
 import * as Schema from "effect/Schema";
+import * as HttpClient from "effect/unstable/http/HttpClient";
 
 import { appendClientConnectionParams } from "../authorization/remote.ts";
 import * as RemoteEnvironmentAuthorization from "../authorization/service.ts";
@@ -22,6 +23,7 @@ import {
   credentialMissingError,
   environmentMismatchError,
   mapManagedRelayError,
+  mapRemoteEnvironmentError,
   profileMissingError,
 } from "./errors.ts";
 import type {
@@ -34,6 +36,11 @@ import type {
 } from "./model.ts";
 import { ConnectionBlockedError, type ConnectionAttemptError } from "./model.ts";
 import * as ConnectionProfileStore from "./profileStore.ts";
+import {
+  appendOrchestrationProtocol,
+  orchestrationProtocolCompatibilityError,
+} from "./compatibility.ts";
+import { fetchRemoteEnvironmentDescriptor } from "../environment/descriptor.ts";
 
 export class ConnectionResolver extends Context.Service<
   ConnectionResolver,
@@ -256,6 +263,7 @@ export const make = Effect.gen(function* () {
   const bearer = yield* makeBearerBroker();
   const relay = yield* makeRelayBroker();
   const ssh = yield* makeSshBroker();
+  const httpClient = yield* HttpClient.HttpClient;
 
   const prepare = Effect.fn("clientRuntime.connection.broker.prepare")(function* (
     entry: ConnectionCatalogEntry,
@@ -265,16 +273,38 @@ export const make = Effect.gen(function* () {
       "connection.environment.id": target.environmentId,
       "connection.target.kind": target._tag,
     });
-    switch (target._tag) {
-      case "PrimaryConnectionTarget":
-        return yield* primary(target);
-      case "BearerConnectionTarget":
-        return yield* bearer({ ...entry, target });
-      case "RelayConnectionTarget":
-        return yield* relay(target);
-      case "SshConnectionTarget":
-        return yield* ssh({ ...entry, target });
+    const prepared = yield* (() => {
+      switch (target._tag) {
+        case "PrimaryConnectionTarget":
+          return primary(target);
+        case "BearerConnectionTarget":
+          return bearer({ ...entry, target });
+        case "RelayConnectionTarget":
+          return relay(target);
+        case "SshConnectionTarget":
+          return ssh({ ...entry, target });
+      }
+    })();
+    const descriptor = yield* fetchRemoteEnvironmentDescriptor({
+      httpBaseUrl: prepared.httpBaseUrl,
+    }).pipe(
+      Effect.mapError(mapRemoteEnvironmentError),
+      Effect.provideService(HttpClient.HttpClient, httpClient),
+    );
+    if (descriptor.environmentId !== target.environmentId) {
+      return yield* environmentMismatchError({
+        expected: target.environmentId,
+        actual: descriptor.environmentId,
+      });
+    }
+    const compatibilityError = orchestrationProtocolCompatibilityError(descriptor);
+    if (compatibilityError !== null) {
+      return yield* compatibilityError;
     }
+    return {
+      ...prepared,
+      socketUrl: appendOrchestrationProtocol(prepared.socketUrl),
+    };
   });
 
   return ConnectionResolver.of({ prepare });
diff --git a/packages/client-runtime/src/operations/commands.test.ts b/packages/client-runtime/src/operations/commands.test.ts
index 0cb1650066c4..90064ccec224 100644
--- a/packages/client-runtime/src/operations/commands.test.ts
+++ b/packages/client-runtime/src/operations/commands.test.ts
@@ -1,13 +1,26 @@
 import {
+  CheckpointId,
+  CheckpointRef,
+  CheckpointScopeId,
   CommandId,
   EnvironmentId,
-  ORCHESTRATION_WS_METHODS,
+  MessageId,
+  NodeId,
+  ORCHESTRATION_V2_WS_METHODS,
+  PlanId,
   ProjectId,
+  ProviderInstanceId,
+  RunId,
   ThreadId,
-  type ClientOrchestrationCommand,
+  WS_METHODS,
+  type OrchestrationV2Command,
+  type OrchestrationV2ThreadLaunchInput,
+  type OrchestrationV2ThreadProjection,
+  type ProjectMutation,
 } from "@t3tools/contracts";
 import { describe, expect, it } from "@effect/vitest";
 import * as Crypto from "effect/Crypto";
+import * as DateTime from "effect/DateTime";
 import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
 import * as Option from "effect/Option";
@@ -21,12 +34,22 @@ import {
 import * as EnvironmentSupervisor from "../connection/supervisor.ts";
 import * as RpcSession from "../rpc/session.ts";
 import type { WsRpcProtocolClient } from "../rpc/protocol.ts";
+import { v2Now, v2Projection, v2ThreadId } from "../state/orchestrationV2TestFixtures.ts";
 import {
   archiveThread,
   createProject,
+  interruptThreadTurn,
+  forkThreadFromRun,
+  mergeThreadBack,
+  cancelQueuedRun,
+  editQueuedRun,
+  promoteQueuedRun,
+  reorderQueuedRun,
+  revertThreadCheckpoint,
   settleThread,
-  stopThreadSession,
+  startThreadTurn,
   unsettleThread,
+  updateThreadMetadata,
 } from "./commands.ts";
 
 const TEST_CRYPTO_LAYER = Layer.succeed(
@@ -44,14 +67,51 @@ const TARGET = new PrimaryConnectionTarget({
   wsBaseUrl: "wss://environment.example.test",
 });
 
-const makeSupervisor = Effect.fn("TestEnvironmentCommands.makeSupervisor")(function* (
-  dispatched: ClientOrchestrationCommand[],
-) {
+const makeSupervisor = Effect.fn("TestEnvironmentCommands.makeSupervisor")(function* (input: {
+  readonly commands: OrchestrationV2Command[];
+  readonly projects: ProjectMutation[];
+  readonly launches?: OrchestrationV2ThreadLaunchInput[];
+  readonly projection?: OrchestrationV2ThreadProjection;
+  readonly projectionRequests?: ThreadId[];
+}) {
   const client = {
-    [ORCHESTRATION_WS_METHODS.dispatchCommand]: (command: ClientOrchestrationCommand) =>
+    [ORCHESTRATION_V2_WS_METHODS.dispatchCommand]: (command: OrchestrationV2Command) =>
       Effect.sync(() => {
-        dispatched.push(command);
-        return { sequence: dispatched.length };
+        input.commands.push(command);
+        return { sequence: input.commands.length };
+      }),
+    [ORCHESTRATION_V2_WS_METHODS.getThreadProjection]: (requestInput: {
+      readonly threadId: ThreadId;
+    }) =>
+      Effect.sync(() => {
+        input.projectionRequests?.push(requestInput.threadId);
+        return input.projection ?? v2Projection;
+      }),
+    [ORCHESTRATION_V2_WS_METHODS.launchThread]: (launchInput: OrchestrationV2ThreadLaunchInput) =>
+      Effect.sync(() => {
+        input.launches?.push(launchInput);
+        return {
+          threadId: launchInput.threadId ?? v2ThreadId,
+          projection: input.projection ?? v2Projection,
+          resumed: false,
+        };
+      }),
+    [WS_METHODS.projectsMutate]: (mutation: ProjectMutation) =>
+      Effect.sync(() => {
+        input.projects.push(mutation);
+        return {
+          id: mutation.projectId,
+          title: mutation.type === "project.create" ? mutation.title : "Project",
+          workspaceRoot:
+            mutation.type === "project.create" ? mutation.workspaceRoot : "/workspace/project",
+          repositoryIdentity: null,
+          faviconPath: null,
+          defaultModelSelection: null,
+          scripts: [],
+          createdAt: "2026-06-06T00:00:00.000Z",
+          updatedAt: "2026-06-06T00:00:00.000Z",
+          deletedAt: null,
+        };
       }),
   } as unknown as WsRpcProtocolClient;
   const session: RpcSession.RpcSession = {
@@ -72,70 +132,382 @@ const makeSupervisor = Effect.fn("TestEnvironmentCommands.makeSupervisor")(funct
   } satisfies EnvironmentSupervisor.EnvironmentSupervisor["Service"]);
 });
 
-describe("environment commands", () => {
-  it.effect("adds generated command metadata", () =>
+describe("V2 environment commands", () => {
+  it.effect("routes projects through the event-sourced project transport", () =>
     Effect.gen(function* () {
-      const dispatched: ClientOrchestrationCommand[] = [];
-      const supervisor = yield* makeSupervisor(dispatched);
+      const projects: ProjectMutation[] = [];
+      const supervisor = yield* makeSupervisor({ commands: [], projects });
 
-      const result = yield* createProject({
+      yield* createProject({
         projectId: ProjectId.make("project-1"),
         title: "Project",
         workspaceRoot: "/workspace/project",
-        createdAt: "2026-06-06T00:00:00.000Z",
+        createWorkspaceRootIfMissing: true,
       }).pipe(Effect.provideService(EnvironmentSupervisor.EnvironmentSupervisor, supervisor));
 
-      expect(result).toEqual({ sequence: 1 });
-      expect(dispatched).toEqual([
+      expect(projects).toEqual([
         {
           type: "project.create",
           commandId: "00000000-0000-4000-8000-000000000000",
           projectId: "project-1",
           title: "Project",
           workspaceRoot: "/workspace/project",
-          createdAt: "2026-06-06T00:00:00.000Z",
+          createWorkspaceRootIfMissing: true,
         },
       ]);
     }).pipe(Effect.provide(TEST_CRYPTO_LAYER)),
   );
 
-  it.effect("preserves caller metadata for idempotent queued commands", () =>
+  it.effect("preserves caller command ids for idempotent V2 commands", () =>
     Effect.gen(function* () {
-      const dispatched: ClientOrchestrationCommand[] = [];
-      const supervisor = yield* makeSupervisor(dispatched);
+      const commands: OrchestrationV2Command[] = [];
+      const supervisor = yield* makeSupervisor({ commands, projects: [] });
 
-      yield* stopThreadSession({
+      yield* archiveThread({
         commandId: CommandId.make("queued-command"),
         threadId: ThreadId.make("thread-1"),
-        createdAt: "2026-06-06T00:01:00.000Z",
       }).pipe(Effect.provideService(EnvironmentSupervisor.EnvironmentSupervisor, supervisor));
 
-      expect(dispatched).toEqual([
+      expect(commands).toEqual([
+        { type: "thread.archive", commandId: "queued-command", threadId: "thread-1" },
+      ]);
+    }).pipe(Effect.provide(TEST_CRYPTO_LAYER)),
+  );
+
+  it.effect("resolves run ordinal zero to the persisted thread-start checkpoint", () =>
+    Effect.gen(function* () {
+      const scopeId = CheckpointScopeId.make("checkpoint-scope-root");
+      const checkpointId = CheckpointId.make("checkpoint-thread-start");
+      const projection: OrchestrationV2ThreadProjection = {
+        ...v2Projection,
+        checkpoints: [
+          {
+            id: checkpointId,
+            threadId: v2ThreadId,
+            scopeId,
+            runId: null,
+            nodeId: NodeId.make("node-run-1"),
+            parentCheckpointId: null,
+            ordinalWithinScope: 0,
+            appRunOrdinal: null,
+            ref: CheckpointRef.make("refs/t3/thread-start"),
+            status: "ready",
+            files: [],
+            capturedAt: v2Now,
+          },
+        ],
+      };
+      const commands: OrchestrationV2Command[] = [];
+      const supervisor = yield* makeSupervisor({ commands, projects: [], projection });
+
+      yield* revertThreadCheckpoint({
+        commandId: CommandId.make("rollback-thread-start"),
+        threadId: v2ThreadId,
+        turnCount: 0,
+      }).pipe(Effect.provideService(EnvironmentSupervisor.EnvironmentSupervisor, supervisor));
+
+      expect(commands).toEqual([
         {
-          type: "thread.session.stop",
-          commandId: "queued-command",
-          threadId: "thread-1",
-          createdAt: "2026-06-06T00:01:00.000Z",
+          type: "checkpoint.rollback",
+          commandId: "rollback-thread-start",
+          threadId: v2ThreadId,
+          scopeId,
+          checkpointId,
         },
       ]);
     }).pipe(Effect.provide(TEST_CRYPTO_LAYER)),
   );
 
-  it.effect("does not add timestamps to commands without createdAt", () =>
+  it.effect("preserves plan implementation provenance on V2 runs", () =>
     Effect.gen(function* () {
-      const dispatched: ClientOrchestrationCommand[] = [];
-      const supervisor = yield* makeSupervisor(dispatched);
+      const commands: OrchestrationV2Command[] = [];
+      const supervisor = yield* makeSupervisor({ commands, projects: [] });
 
-      yield* archiveThread({
-        commandId: CommandId.make("archive-command"),
-        threadId: ThreadId.make("thread-1"),
+      yield* startThreadTurn({
+        commandId: CommandId.make("implement-plan"),
+        threadId: v2ThreadId,
+        message: {
+          messageId: MessageId.make("message-implementation"),
+          role: "user",
+          text: "Implement the plan",
+          attachments: [],
+        },
+        modelSelection: {
+          instanceId: ProviderInstanceId.make("codex"),
+          model: "gpt-5.4",
+        },
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        titleSeed: "Implement the plan",
+        sourceProposedPlan: {
+          threadId: ThreadId.make("thread-plan"),
+          planId: PlanId.make("plan-1"),
+        },
       }).pipe(Effect.provideService(EnvironmentSupervisor.EnvironmentSupervisor, supervisor));
 
-      expect(dispatched).toEqual([
+      expect(commands).toHaveLength(1);
+      expect(commands[0]).toMatchObject({
+        type: "message.dispatch",
+        commandId: "implement-plan",
+        threadId: v2ThreadId,
+        titleSeed: "Implement the plan",
+        sourcePlanRef: { threadId: "thread-plan", planId: "plan-1" },
+        dispatchMode: { type: "start_immediately" },
+      });
+    }).pipe(Effect.provide(TEST_CRYPTO_LAYER)),
+  );
+
+  it.effect("preserves an existing worktree and branch during first-message launch", () =>
+    Effect.gen(function* () {
+      const launches: OrchestrationV2ThreadLaunchInput[] = [];
+      const supervisor = yield* makeSupervisor({ commands: [], projects: [], launches });
+
+      yield* startThreadTurn({
+        commandId: CommandId.make("launch-existing-worktree"),
+        threadId: v2ThreadId,
+        message: {
+          messageId: MessageId.make("message-existing-worktree"),
+          role: "user",
+          text: "Continue here",
+          attachments: [],
+        },
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        titleSeed: "Continue here",
+        bootstrap: {
+          createThread: {
+            projectId: ProjectId.make("project-1"),
+            title: "Thread",
+            modelSelection: v2Projection.thread.modelSelection,
+            runtimeMode: "full-access",
+            interactionMode: "default",
+            branch: "feature",
+            worktreePath: "/workspace/project-worktrees/feature",
+            createdAt: "2026-06-20T00:00:00.000Z",
+          },
+        },
+      }).pipe(Effect.provideService(EnvironmentSupervisor.EnvironmentSupervisor, supervisor));
+
+      expect(launches[0]).toMatchObject({
+        threadId: v2ThreadId,
+        title: "Continue here",
+        generateTitle: true,
+        workspaceStrategy: {
+          type: "existing_worktree",
+          worktreePath: "/workspace/project-worktrees/feature",
+          branch: "feature",
+        },
+      });
+    }).pipe(Effect.provide(TEST_CRYPTO_LAYER)),
+  );
+
+  it.effect("provisions an origin-based worktree for an existing empty thread", () =>
+    Effect.gen(function* () {
+      const launches: OrchestrationV2ThreadLaunchInput[] = [];
+      const supervisor = yield* makeSupervisor({ commands: [], projects: [], launches });
+
+      yield* startThreadTurn({
+        commandId: CommandId.make("launch-existing-thread-worktree"),
+        threadId: v2ThreadId,
+        message: {
+          messageId: MessageId.make("message-existing-thread-worktree"),
+          role: "user",
+          text: "Move to a worktree",
+          attachments: [],
+        },
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        bootstrap: {
+          prepareWorktree: {
+            projectCwd: "/workspace/project",
+            baseBranch: "main",
+            branch: "feature",
+            startFromOrigin: true,
+          },
+        },
+      }).pipe(Effect.provideService(EnvironmentSupervisor.EnvironmentSupervisor, supervisor));
+
+      expect(launches[0]).toMatchObject({
+        threadId: v2ThreadId,
+        reuseExistingThread: true,
+        projectId: v2Projection.thread.projectId,
+        workspaceStrategy: {
+          type: "worktree",
+          baseRef: "main",
+          branch: "feature",
+          startFromOrigin: true,
+        },
+      });
+    }).pipe(Effect.provide(TEST_CRYPTO_LAYER)),
+  );
+
+  it.effect("maps explicit active-run delivery modes to V2 dispatch semantics", () =>
+    Effect.gen(function* () {
+      const activeRunId = RunId.make("run-active");
+      const now = DateTime.makeUnsafe("2026-06-20T01:00:00.000Z");
+      const projection: OrchestrationV2ThreadProjection = {
+        ...v2Projection,
+        runs: [
+          {
+            id: activeRunId,
+            threadId: v2ThreadId,
+            ordinal: 1,
+            providerInstanceId: v2Projection.thread.providerInstanceId,
+            modelSelection: v2Projection.thread.modelSelection,
+            providerThreadId: null,
+            userMessageId: MessageId.make("message-active"),
+            rootNodeId: null,
+            activeAttemptId: null,
+            status: "running",
+            requestedAt: now,
+            startedAt: now,
+            completedAt: null,
+            checkpointId: null,
+            contextHandoffId: null,
+          },
+        ],
+      };
+      const commands: OrchestrationV2Command[] = [];
+      const supervisor = yield* makeSupervisor({ commands, projects: [], projection });
+
+      for (const [mode, expectedType] of [
+        ["queue", "queue_after_active"],
+        ["steer", "steer_active"],
+        ["restart", "restart_active"],
+      ] as const) {
+        yield* startThreadTurn({
+          commandId: CommandId.make(`command-${mode}`),
+          threadId: v2ThreadId,
+          message: {
+            messageId: MessageId.make(`message-${mode}`),
+            role: "user",
+            text: mode,
+            attachments: [],
+          },
+          runtimeMode: "full-access",
+          interactionMode: "default",
+          dispatchMode: mode,
+        }).pipe(Effect.provideService(EnvironmentSupervisor.EnvironmentSupervisor, supervisor));
+
+        expect(commands.at(-1)).toMatchObject({
+          type: "message.dispatch",
+          dispatchMode: {
+            type: expectedType,
+            ...(mode === "queue" ? {} : { targetRunId: activeRunId }),
+          },
+        });
+      }
+    }).pipe(Effect.provide(TEST_CRYPTO_LAYER)),
+  );
+
+  it.effect(
+    "dispatches V2-native relationship and queue commands without compatibility shaping",
+    () =>
+      Effect.gen(function* () {
+        const commands: OrchestrationV2Command[] = [];
+        const supervisor = yield* makeSupervisor({ commands, projects: [] });
+        const provide = Effect.provideService(
+          EnvironmentSupervisor.EnvironmentSupervisor,
+          supervisor,
+        );
+
+        yield* forkThreadFromRun({
+          commandId: CommandId.make("fork"),
+          sourceThreadId: v2ThreadId,
+          targetThreadId: ThreadId.make("thread-fork"),
+          runId: RunId.make("run-1"),
+        }).pipe(provide);
+        yield* mergeThreadBack({
+          commandId: CommandId.make("merge"),
+          sourceThreadId: ThreadId.make("thread-fork"),
+          targetThreadId: v2ThreadId,
+          runId: RunId.make("run-2"),
+        }).pipe(provide);
+        yield* reorderQueuedRun({
+          commandId: CommandId.make("reorder"),
+          threadId: v2ThreadId,
+          runId: RunId.make("run-3"),
+          beforeRunId: RunId.make("run-4"),
+        }).pipe(provide);
+        yield* promoteQueuedRun({
+          commandId: CommandId.make("promote"),
+          threadId: v2ThreadId,
+          queuedRunId: RunId.make("run-3"),
+          targetRunId: RunId.make("run-active"),
+        }).pipe(provide);
+        yield* cancelQueuedRun({
+          commandId: CommandId.make("cancel"),
+          threadId: v2ThreadId,
+          runId: RunId.make("run-3"),
+        }).pipe(provide);
+        yield* editQueuedRun({
+          commandId: CommandId.make("edit"),
+          threadId: v2ThreadId,
+          runId: RunId.make("run-3"),
+          text: "updated queued text",
+        }).pipe(provide);
+        yield* editQueuedRun({
+          commandId: CommandId.make("edit-attachments"),
+          threadId: v2ThreadId,
+          runId: RunId.make("run-3"),
+          text: "updated queued text with attachments",
+          edit: {
+            messageId: MessageId.make("message-3"),
+            attachments: [
+              {
+                type: "image",
+                id: "attachment-kept",
+                name: "kept.png",
+                mimeType: "image/png",
+                sizeBytes: 64,
+              },
+            ],
+          },
+        }).pipe(provide);
+
+        expect(commands).toMatchObject([
+          { type: "thread.fork", sourcePoint: { type: "run", runId: "run-1" } },
+          { type: "thread.merge_back", sourcePoint: { type: "run", runId: "run-2" } },
+          { type: "queued-run.reorder", runId: "run-3", beforeRunId: "run-4" },
+          {
+            type: "queued-message.promote-to-steer",
+            queuedRunId: "run-3",
+            targetRunId: "run-active",
+          },
+          { type: "queued-run.cancel", runId: "run-3" },
+          { type: "queued-run.edit", runId: "run-3", text: "updated queued text" },
+          {
+            type: "queued-run.edit",
+            runId: "run-3",
+            text: "updated queued text with attachments",
+            attachments: [{ id: "attachment-kept" }],
+          },
+        ]);
+        // A text-only edit must not send an attachments replacement list.
+        expect(commands[5]).not.toHaveProperty("attachments");
+      }).pipe(Effect.provide(TEST_CRYPTO_LAYER)),
+  );
+
+  it.effect("uses provider.switch when model selection changes provider instance", () =>
+    Effect.gen(function* () {
+      const commands: OrchestrationV2Command[] = [];
+      const supervisor = yield* makeSupervisor({ commands, projects: [] });
+
+      yield* updateThreadMetadata({
+        commandId: CommandId.make("switch-provider"),
+        threadId: v2ThreadId,
+        modelSelection: {
+          instanceId: ProviderInstanceId.make("claude"),
+          model: "claude-sonnet-4-6",
+        },
+      }).pipe(Effect.provideService(EnvironmentSupervisor.EnvironmentSupervisor, supervisor));
+
+      expect(commands).toEqual([
         {
-          type: "thread.archive",
-          commandId: "archive-command",
-          threadId: "thread-1",
+          type: "provider.switch",
+          commandId: "switch-provider",
+          threadId: v2ThreadId,
+          modelSelection: { instanceId: "claude", model: "claude-sonnet-4-6" },
         },
       ]);
     }).pipe(Effect.provide(TEST_CRYPTO_LAYER)),
@@ -143,8 +515,8 @@ describe("environment commands", () => {
 
   it.effect("dispatches settle and unsettle commands without timestamps", () =>
     Effect.gen(function* () {
-      const dispatched: ClientOrchestrationCommand[] = [];
-      const supervisor = yield* makeSupervisor(dispatched);
+      const dispatched: OrchestrationV2Command[] = [];
+      const supervisor = yield* makeSupervisor({ commands: dispatched, projects: [] });
 
       yield* settleThread({
         commandId: CommandId.make("settle-command"),
@@ -171,4 +543,67 @@ describe("environment commands", () => {
       ]);
     }).pipe(Effect.provide(TEST_CRYPTO_LAYER)),
   );
+
+  it.effect("dispatches an explicit idle start without fetching the full projection", () =>
+    Effect.gen(function* () {
+      const commands: OrchestrationV2Command[] = [];
+      const projectionRequests: ThreadId[] = [];
+      const supervisor = yield* makeSupervisor({
+        commands,
+        projects: [],
+        projectionRequests,
+      });
+
+      yield* startThreadTurn({
+        commandId: CommandId.make("direct-start"),
+        threadId: v2ThreadId,
+        message: {
+          messageId: MessageId.make("direct-start-message"),
+          role: "user",
+          text: "continue",
+          attachments: [],
+        },
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        dispatchMode: "start",
+      }).pipe(Effect.provideService(EnvironmentSupervisor.EnvironmentSupervisor, supervisor));
+
+      expect(projectionRequests).toEqual([]);
+      expect(commands).toMatchObject([
+        {
+          type: "message.dispatch",
+          threadId: v2ThreadId,
+          dispatchMode: { type: "start_immediately" },
+        },
+      ]);
+    }).pipe(Effect.provide(TEST_CRYPTO_LAYER)),
+  );
+
+  it.effect("interrupts a known run without fetching the full projection", () =>
+    Effect.gen(function* () {
+      const commands: OrchestrationV2Command[] = [];
+      const projectionRequests: ThreadId[] = [];
+      const supervisor = yield* makeSupervisor({
+        commands,
+        projects: [],
+        projectionRequests,
+      });
+
+      yield* interruptThreadTurn({
+        commandId: CommandId.make("direct-interrupt"),
+        threadId: v2ThreadId,
+        runId: RunId.make("active-run"),
+      }).pipe(Effect.provideService(EnvironmentSupervisor.EnvironmentSupervisor, supervisor));
+
+      expect(projectionRequests).toEqual([]);
+      expect(commands).toEqual([
+        {
+          type: "run.interrupt",
+          commandId: "direct-interrupt",
+          threadId: v2ThreadId,
+          runId: "active-run",
+        },
+      ]);
+    }).pipe(Effect.provide(TEST_CRYPTO_LAYER)),
+  );
 });
diff --git a/packages/client-runtime/src/operations/commands.ts b/packages/client-runtime/src/operations/commands.ts
index cb74f117b772..3e1262c5dde1 100644
--- a/packages/client-runtime/src/operations/commands.ts
+++ b/packages/client-runtime/src/operations/commands.ts
@@ -1,333 +1,858 @@
 import {
+  type ThreadLinkedPullRequest,
   CommandId,
-  ORCHESTRATION_WS_METHODS,
-  type ClientOrchestrationCommand,
+  ORCHESTRATION_V2_WS_METHODS,
+  OrchestrationV2CheckpointUnavailableError,
+  WS_METHODS,
+  type ChatAttachment,
+  type MessageId,
+  type ModelSelection,
+  type OrchestrationV2Command,
+  type OrchestrationV2CreationSource,
+  type PlanId,
+  type ProjectId,
+  type ProjectScript,
+  type ProviderApprovalDecision,
+  type ProviderInteractionMode,
+  type ProviderUserInputAnswers,
+  type RunId,
+  type RuntimeMode,
+  type RuntimeRequestId,
+  type ThreadId,
+  type UploadChatAttachment,
 } from "@t3tools/contracts";
 import * as Crypto from "effect/Crypto";
-import * as DateTime from "effect/DateTime";
 import * as Effect from "effect/Effect";
 
-import type { EnvironmentSupervisor } from "../connection/supervisor.ts";
-import {
-  type EnvironmentRpcFailure,
-  type EnvironmentRpcSuccess,
-  type EnvironmentRpcUnavailableError,
-  request,
-} from "../rpc/client.ts";
-
-type CommandType = ClientOrchestrationCommand["type"];
-type CommandOf<T extends CommandType> = Extract<ClientOrchestrationCommand, { readonly type: T }>;
-type CommandInput<T extends CommandType> = Omit<
-  CommandOf<T>,
-  "type" | "commandId" | "createdAt"
-> & {
-  readonly commandId?: CommandId;
-} & ("createdAt" extends keyof CommandOf<T>
-    ? {
-        readonly createdAt?: CommandOf<T>["createdAt"];
-      }
-    : {});
-
-export type CreateProjectInput = CommandInput<"project.create">;
-export type UpdateProjectInput = CommandInput<"project.meta.update">;
-export type DeleteProjectInput = CommandInput<"project.delete">;
-export type CreateThreadInput = CommandInput<"thread.create">;
-export type DeleteThreadInput = CommandInput<"thread.delete">;
-export type ArchiveThreadInput = CommandInput<"thread.archive">;
-export type UnarchiveThreadInput = CommandInput<"thread.unarchive">;
-export type SettleThreadInput = CommandInput<"thread.settle">;
-export type UnsettleThreadInput = CommandInput<"thread.unsettle">;
-export type SnoozeThreadInput = CommandInput<"thread.snooze">;
-export type UnsnoozeThreadInput = CommandInput<"thread.unsnooze">;
-export type PinThreadInput = CommandInput<"thread.pin">;
-export type UnpinThreadInput = CommandInput<"thread.unpin">;
-export type ReorderPinnedThreadInput = CommandInput<"thread.pin.reorder">;
-export type UpdateThreadMetadataInput = CommandInput<"thread.meta.update">;
-export type SetThreadRuntimeModeInput = CommandInput<"thread.runtime-mode.set">;
-export type SetThreadInteractionModeInput = CommandInput<"thread.interaction-mode.set">;
-export type StartThreadTurnInput = CommandInput<"thread.turn.start">;
-export type InterruptThreadTurnInput = CommandInput<"thread.turn.interrupt">;
-export type RespondToThreadApprovalInput = CommandInput<"thread.approval.respond">;
-export type RespondToThreadUserInputInput = CommandInput<"thread.user-input.respond">;
-export type RevertThreadCheckpointInput = CommandInput<"thread.checkpoint.revert">;
-export type StopThreadSessionInput = CommandInput<"thread.session.stop">;
-
-type DispatchTag = typeof ORCHESTRATION_WS_METHODS.dispatchCommand;
-type CommandEffect = Effect.Effect<
-  EnvironmentRpcSuccess<DispatchTag>,
-  EnvironmentRpcFailure<DispatchTag> | EnvironmentRpcUnavailableError,
-  Crypto.Crypto | EnvironmentSupervisor
->;
-
-function commandId(input: { readonly commandId?: CommandId }) {
-  return Effect.gen(function* () {
-    if (input.commandId !== undefined) {
-      return input.commandId;
-    }
-    const crypto = yield* Crypto.Crypto;
-    return yield* crypto.randomUUIDv4.pipe(Effect.orDie, Effect.map(CommandId.make));
-  });
-}
+import { request } from "../rpc/client.ts";
 
-function timestampedCommandMetadata(input: {
+interface CommandMetadata {
   readonly commandId?: CommandId;
   readonly createdAt?: string;
-}) {
-  return Effect.all({
-    commandId: commandId(input),
-    createdAt:
-      input.createdAt === undefined
-        ? DateTime.now.pipe(Effect.map(DateTime.formatIso))
-        : Effect.succeed(input.createdAt),
-  });
+  readonly creationSource?: OrchestrationV2CreationSource;
 }
 
-function dispatch(command: ClientOrchestrationCommand) {
-  return request(ORCHESTRATION_WS_METHODS.dispatchCommand, command);
+export interface CreateProjectInput extends CommandMetadata {
+  readonly projectId: ProjectId;
+  readonly title: string;
+  readonly workspaceRoot: string;
+  readonly createWorkspaceRootIfMissing?: boolean;
+  readonly defaultModelSelection?: ModelSelection | null;
+  readonly scripts?: ReadonlyArray<ProjectScript>;
 }
 
-export const createProject: (input: CreateProjectInput) => CommandEffect = Effect.fn(
-  "EnvironmentCommands.createProject",
-)(function* (input) {
-  const metadata = yield* timestampedCommandMetadata(input);
-  return yield* dispatch({
-    ...input,
+export interface UpdateProjectInput extends CommandMetadata {
+  readonly projectId: ProjectId;
+  readonly title?: string;
+  readonly workspaceRoot?: string;
+  readonly defaultModelSelection?: ModelSelection | null;
+  readonly scripts?: ReadonlyArray<ProjectScript>;
+}
+
+export interface DeleteProjectInput extends CommandMetadata {
+  readonly projectId: ProjectId;
+  readonly force?: boolean;
+}
+
+export interface CreateThreadInput extends CommandMetadata {
+  readonly threadId: ThreadId;
+  readonly projectId: ProjectId;
+  readonly title: string;
+  readonly modelSelection: ModelSelection;
+  readonly runtimeMode: RuntimeMode;
+  readonly interactionMode: ProviderInteractionMode;
+  readonly branch: string | null;
+  readonly worktreePath: string | null;
+}
+
+export interface ThreadCommandInput extends CommandMetadata {
+  readonly threadId: ThreadId;
+}
+
+export type DeleteThreadInput = ThreadCommandInput;
+export type ArchiveThreadInput = ThreadCommandInput;
+export type UnarchiveThreadInput = ThreadCommandInput;
+export type SettleThreadInput = ThreadCommandInput;
+
+export interface UnsettleThreadInput extends ThreadCommandInput {
+  readonly reason: "user";
+}
+
+export interface PinThreadInput extends ThreadCommandInput {
+  /** Initial slot in the user-arranged pinned order; omit to pin keyless. */
+  readonly orderKey?: string;
+}
+export type UnpinThreadInput = ThreadCommandInput;
+
+export interface ReorderPinnedThreadInput extends ThreadCommandInput {
+  /** Fractional-index key that sorts between the drop position's neighbors. */
+  readonly orderKey: string;
+}
+
+export interface SnoozeThreadInput extends ThreadCommandInput {
+  readonly snoozedUntil: string;
+}
+
+export interface UnsnoozeThreadInput extends ThreadCommandInput {
+  readonly reason: "user";
+}
+
+export interface VisitThreadInput extends ThreadCommandInput {
+  /** Watermark of the thread state the viewer has seen (ISO timestamp). */
+  readonly visitedAt: string;
+}
+
+export type MarkThreadUnreadInput = ThreadCommandInput;
+
+export interface UpdateThreadMetadataInput extends ThreadCommandInput {
+  readonly title?: string;
+  readonly modelSelection?: ModelSelection;
+  readonly branch?: string | null;
+  readonly worktreePath?: string | null;
+  /** Kick off an async title regeneration for the thread. */
+  readonly regenerateTitle?: boolean;
+  /** Link (object) or unlink (null) a pull request (#8160). */
+  readonly linkedPullRequest?: ThreadLinkedPullRequest | null;
+}
+
+export interface SetThreadRuntimeModeInput extends ThreadCommandInput {
+  readonly runtimeMode: RuntimeMode;
+}
+
+export interface SetThreadInteractionModeInput extends ThreadCommandInput {
+  readonly interactionMode: ProviderInteractionMode;
+}
+
+interface StartThreadBootstrap {
+  readonly createThread?: {
+    readonly projectId: ProjectId;
+    readonly title: string;
+    readonly modelSelection: ModelSelection;
+    readonly runtimeMode: RuntimeMode;
+    readonly interactionMode: ProviderInteractionMode;
+    readonly branch: string | null;
+    readonly worktreePath: string | null;
+    readonly createdAt: string;
+  };
+  readonly prepareWorktree?: {
+    readonly projectCwd: string;
+    readonly baseBranch: string;
+    readonly branch?: string;
+    readonly startFromOrigin?: boolean;
+  };
+  readonly runSetupScript?: boolean;
+}
+
+export interface StartThreadTurnInput extends ThreadCommandInput {
+  readonly message: {
+    readonly messageId: MessageId;
+    readonly role: "user";
+    readonly text: string;
+    readonly attachments: ReadonlyArray<ChatAttachment | UploadChatAttachment>;
+  };
+  readonly modelSelection?: ModelSelection;
+  readonly titleSeed?: string;
+  readonly runtimeMode: RuntimeMode;
+  readonly interactionMode: ProviderInteractionMode;
+  readonly bootstrap?: StartThreadBootstrap;
+  readonly sourceProposedPlan?: { readonly threadId: ThreadId; readonly planId: PlanId };
+  readonly dispatchMode?: "auto" | "queue" | "steer" | "restart" | "start";
+}
+
+export interface InterruptThreadTurnInput extends ThreadCommandInput {
+  readonly runId?: RunId;
+  /** Temporary caller compatibility while UI naming moves from turns to runs. */
+  readonly turnId?: string;
+}
+
+export interface RespondToThreadApprovalInput extends ThreadCommandInput {
+  readonly requestId: RuntimeRequestId;
+  readonly decision: ProviderApprovalDecision;
+}
+
+export interface RespondToThreadUserInputInput extends ThreadCommandInput {
+  readonly requestId: RuntimeRequestId;
+  readonly answers: ProviderUserInputAnswers;
+}
+
+export interface RevertThreadCheckpointInput extends ThreadCommandInput {
+  readonly checkpointId?: string;
+  readonly scopeId?: string;
+  readonly turnCount?: number;
+}
+
+export type StopThreadSessionInput = ThreadCommandInput;
+
+export interface ForkThreadFromRunInput extends CommandMetadata {
+  readonly sourceThreadId: ThreadId;
+  readonly targetThreadId: ThreadId;
+  readonly runId: RunId;
+  readonly title?: string;
+}
+
+export interface MergeThreadBackInput extends CommandMetadata {
+  readonly sourceThreadId: ThreadId;
+  readonly targetThreadId: ThreadId;
+  readonly runId: RunId;
+}
+
+export interface ReorderQueuedRunInput extends ThreadCommandInput {
+  readonly runId: RunId;
+  readonly beforeRunId: RunId | null;
+}
+
+export interface PromoteQueuedRunInput extends ThreadCommandInput {
+  readonly queuedRunId: RunId;
+  readonly targetRunId: RunId;
+}
+
+export interface CancelQueuedRunInput extends ThreadCommandInput {
+  readonly runId: RunId;
+}
+
+export interface EditQueuedRunInput extends ThreadCommandInput {
+  readonly runId: RunId;
+  readonly text: string;
+  /**
+   * Full replacement attachment list for the queued message. Omitted =
+   * text-only edit that leaves attachments untouched. `dataUrl` entries are
+   * persisted against `messageId` (the queued run's user message) before
+   * dispatch, so `messageId` is required whenever attachments are present.
+   */
+  readonly edit?: {
+    readonly messageId: MessageId;
+    readonly attachments: ReadonlyArray<ChatAttachment | UploadChatAttachment>;
+  };
+}
+
+const allocateCommandId = Effect.fn("EnvironmentCommands.allocateCommandId")(function* (
+  input: CommandMetadata,
+) {
+  if (input.commandId !== undefined) return input.commandId;
+  const crypto = yield* Crypto.Crypto;
+  return CommandId.make(yield* crypto.randomUUIDv4.pipe(Effect.orDie));
+});
+
+const dispatch = (command: OrchestrationV2Command) =>
+  request(ORCHESTRATION_V2_WS_METHODS.dispatchCommand, command);
+
+const getProjection = (threadId: ThreadId) =>
+  request(ORCHESTRATION_V2_WS_METHODS.getThreadProjection, { threadId });
+
+const persistAttachments = Effect.fn("EnvironmentCommands.persistAttachments")(function* (
+  threadId: ThreadId,
+  messageId: MessageId,
+  attachments: ReadonlyArray<ChatAttachment | UploadChatAttachment>,
+) {
+  const stored = attachments.filter(
+    (attachment): attachment is ChatAttachment => "id" in attachment,
+  );
+  const uploads = attachments.filter(
+    (attachment): attachment is UploadChatAttachment => "dataUrl" in attachment,
+  );
+  if (uploads.length === 0) return stored;
+  const result = yield* request(WS_METHODS.assetsPersistChatAttachments, {
+    threadId,
+    messageId,
+    attachments: uploads,
+  });
+  if (stored.length === 0) return result.attachments;
+  const byUpload = new Map(
+    uploads.map((attachment, index) => [attachment, result.attachments[index]]),
+  );
+  return attachments.flatMap((attachment) => {
+    if ("id" in attachment) return [attachment];
+    const persisted = byUpload.get(attachment);
+    return persisted === undefined ? [] : [persisted];
+  });
+});
+
+const mutateProject = Effect.fn("EnvironmentCommands.mutateProject")(function* (
+  mutation:
+    | {
+        readonly type: "project.create";
+        readonly commandId: CommandId;
+        readonly projectId: ProjectId;
+        readonly title: string;
+        readonly workspaceRoot: string;
+        readonly createWorkspaceRootIfMissing?: boolean;
+        readonly defaultModelSelection?: ModelSelection | null;
+        readonly scripts?: ReadonlyArray<ProjectScript>;
+      }
+    | {
+        readonly type: "project.update";
+        readonly commandId: CommandId;
+        readonly projectId: ProjectId;
+        readonly title?: string;
+        readonly workspaceRoot?: string;
+        readonly defaultModelSelection?: ModelSelection | null;
+        readonly scripts?: ReadonlyArray<ProjectScript>;
+      }
+    | {
+        readonly type: "project.delete";
+        readonly commandId: CommandId;
+        readonly projectId: ProjectId;
+        readonly force?: boolean;
+      },
+) {
+  return yield* request(WS_METHODS.projectsMutate, mutation);
+});
+
+export const createProject = Effect.fn("EnvironmentCommands.createProject")(function* (
+  input: CreateProjectInput,
+) {
+  return yield* mutateProject({
     type: "project.create",
-    commandId: metadata.commandId,
-    createdAt: metadata.createdAt,
+    commandId: yield* allocateCommandId(input),
+    projectId: input.projectId,
+    title: input.title,
+    workspaceRoot: input.workspaceRoot,
+    ...(input.createWorkspaceRootIfMissing === undefined
+      ? {}
+      : { createWorkspaceRootIfMissing: input.createWorkspaceRootIfMissing }),
+    ...(input.defaultModelSelection === undefined
+      ? {}
+      : { defaultModelSelection: input.defaultModelSelection }),
+    ...(input.scripts === undefined ? {} : { scripts: input.scripts }),
   });
 });
 
-export const updateProject: (input: UpdateProjectInput) => CommandEffect = Effect.fn(
-  "EnvironmentCommands.updateProject",
-)(function* (input) {
-  return yield* dispatch({
-    ...input,
-    type: "project.meta.update",
-    commandId: yield* commandId(input),
+export const updateProject = Effect.fn("EnvironmentCommands.updateProject")(function* (
+  input: UpdateProjectInput,
+) {
+  return yield* mutateProject({
+    type: "project.update",
+    commandId: yield* allocateCommandId(input),
+    projectId: input.projectId,
+    ...(input.title === undefined ? {} : { title: input.title }),
+    ...(input.workspaceRoot === undefined ? {} : { workspaceRoot: input.workspaceRoot }),
+    ...(input.defaultModelSelection === undefined
+      ? {}
+      : { defaultModelSelection: input.defaultModelSelection }),
+    ...(input.scripts === undefined ? {} : { scripts: input.scripts }),
   });
 });
 
-export const deleteProject: (input: DeleteProjectInput) => CommandEffect = Effect.fn(
-  "EnvironmentCommands.deleteProject",
-)(function* (input) {
-  return yield* dispatch({
-    ...input,
+export const deleteProject = Effect.fn("EnvironmentCommands.deleteProject")(function* (
+  input: DeleteProjectInput,
+) {
+  return yield* mutateProject({
     type: "project.delete",
-    commandId: yield* commandId(input),
+    commandId: yield* allocateCommandId(input),
+    projectId: input.projectId,
+    ...(input.force === undefined ? {} : { force: input.force }),
   });
 });
 
-export const createThread: (input: CreateThreadInput) => CommandEffect = Effect.fn(
-  "EnvironmentCommands.createThread",
-)(function* (input) {
-  const metadata = yield* timestampedCommandMetadata(input);
+export const createThread = Effect.fn("EnvironmentCommands.createThread")(function* (
+  input: CreateThreadInput,
+) {
   return yield* dispatch({
-    ...input,
     type: "thread.create",
-    commandId: metadata.commandId,
-    createdAt: metadata.createdAt,
+    commandId: yield* allocateCommandId(input),
+    createdBy: "user",
+    creationSource: input.creationSource ?? "web",
+    threadId: input.threadId,
+    projectId: input.projectId,
+    title: input.title,
+    modelSelection: input.modelSelection,
+    runtimeMode: input.runtimeMode,
+    interactionMode: input.interactionMode,
+    branch: input.branch,
+    worktreePath: input.worktreePath,
   });
 });
 
-export const deleteThread: (input: DeleteThreadInput) => CommandEffect = Effect.fn(
-  "EnvironmentCommands.deleteThread",
-)(function* (input) {
-  return yield* dispatch({
-    ...input,
-    type: "thread.delete",
-    commandId: yield* commandId(input),
-  });
+function simpleThreadCommand(
+  type:
+    | "thread.delete"
+    | "thread.archive"
+    | "thread.unarchive"
+    | "thread.settle"
+    | "thread.pin"
+    | "thread.unpin",
+  input: ThreadCommandInput,
+) {
+  return allocateCommandId(input).pipe(
+    Effect.flatMap((commandId) => dispatch({ type, commandId, threadId: input.threadId })),
+  );
+}
+
+export const deleteThread = Effect.fn("EnvironmentCommands.deleteThread")(function* (
+  input: DeleteThreadInput,
+) {
+  return yield* simpleThreadCommand("thread.delete", input);
 });
 
-export const archiveThread: (input: ArchiveThreadInput) => CommandEffect = Effect.fn(
-  "EnvironmentCommands.archiveThread",
-)(function* (input) {
-  return yield* dispatch({
-    ...input,
-    type: "thread.archive",
-    commandId: yield* commandId(input),
-  });
+export const archiveThread = Effect.fn("EnvironmentCommands.archiveThread")(function* (
+  input: ArchiveThreadInput,
+) {
+  return yield* simpleThreadCommand("thread.archive", input);
+});
+
+export const unarchiveThread = Effect.fn("EnvironmentCommands.unarchiveThread")(function* (
+  input: UnarchiveThreadInput,
+) {
+  return yield* simpleThreadCommand("thread.unarchive", input);
 });
 
-export const unarchiveThread: (input: UnarchiveThreadInput) => CommandEffect = Effect.fn(
-  "EnvironmentCommands.unarchiveThread",
-)(function* (input) {
+export const settleThread = Effect.fn("EnvironmentCommands.settleThread")(function* (
+  input: SettleThreadInput,
+) {
+  return yield* simpleThreadCommand("thread.settle", input);
+});
+
+export const pinThread = Effect.fn("EnvironmentCommands.pinThread")(function* (
+  input: PinThreadInput,
+) {
+  const commandId = yield* allocateCommandId(input);
   return yield* dispatch({
-    ...input,
-    type: "thread.unarchive",
-    commandId: yield* commandId(input),
+    type: "thread.pin",
+    commandId,
+    threadId: input.threadId,
+    ...(input.orderKey === undefined ? {} : { orderKey: input.orderKey }),
   });
 });
 
-export const settleThread: (input: SettleThreadInput) => CommandEffect = Effect.fn(
-  "EnvironmentCommands.settleThread",
-)(function* (input) {
+export const reorderPinnedThread = Effect.fn("EnvironmentCommands.reorderPinnedThread")(function* (
+  input: ReorderPinnedThreadInput,
+) {
+  const commandId = yield* allocateCommandId(input);
   return yield* dispatch({
-    ...input,
-    type: "thread.settle",
-    commandId: yield* commandId(input),
+    type: "thread.pin.reorder",
+    commandId,
+    threadId: input.threadId,
+    orderKey: input.orderKey,
   });
 });
 
-export const unsettleThread: (input: UnsettleThreadInput) => CommandEffect = Effect.fn(
-  "EnvironmentCommands.unsettleThread",
-)(function* (input) {
+export const unpinThread = Effect.fn("EnvironmentCommands.unpinThread")(function* (
+  input: UnpinThreadInput,
+) {
+  return yield* simpleThreadCommand("thread.unpin", input);
+});
+
+export const unsettleThread = Effect.fn("EnvironmentCommands.unsettleThread")(function* (
+  input: UnsettleThreadInput,
+) {
   return yield* dispatch({
-    ...input,
     type: "thread.unsettle",
-    commandId: yield* commandId(input),
+    commandId: yield* allocateCommandId(input),
+    threadId: input.threadId,
+    reason: input.reason,
   });
 });
 
-export const snoozeThread: (input: SnoozeThreadInput) => CommandEffect = Effect.fn(
-  "EnvironmentCommands.snoozeThread",
-)(function* (input) {
+export const snoozeThread = Effect.fn("EnvironmentCommands.snoozeThread")(function* (
+  input: SnoozeThreadInput,
+) {
   return yield* dispatch({
-    ...input,
     type: "thread.snooze",
-    commandId: yield* commandId(input),
+    commandId: yield* allocateCommandId(input),
+    threadId: input.threadId,
+    snoozedUntil: input.snoozedUntil,
   });
 });
 
-export const unsnoozeThread: (input: UnsnoozeThreadInput) => CommandEffect = Effect.fn(
-  "EnvironmentCommands.unsnoozeThread",
-)(function* (input) {
+export const unsnoozeThread = Effect.fn("EnvironmentCommands.unsnoozeThread")(function* (
+  input: UnsnoozeThreadInput,
+) {
   return yield* dispatch({
-    ...input,
     type: "thread.unsnooze",
-    commandId: yield* commandId(input),
+    commandId: yield* allocateCommandId(input),
+    threadId: input.threadId,
+    reason: input.reason,
   });
 });
 
-export const pinThread: (input: PinThreadInput) => CommandEffect = Effect.fn(
-  "EnvironmentCommands.pinThread",
-)(function* (input) {
+export const visitThread = Effect.fn("EnvironmentCommands.visitThread")(function* (
+  input: VisitThreadInput,
+) {
   return yield* dispatch({
-    ...input,
-    type: "thread.pin",
-    commandId: yield* commandId(input),
+    type: "thread.visit",
+    commandId: yield* allocateCommandId(input),
+    threadId: input.threadId,
+    visitedAt: input.visitedAt,
   });
 });
 
-export const unpinThread: (input: UnpinThreadInput) => CommandEffect = Effect.fn(
-  "EnvironmentCommands.unpinThread",
-)(function* (input) {
+export const markThreadUnread = Effect.fn("EnvironmentCommands.markThreadUnread")(function* (
+  input: MarkThreadUnreadInput,
+) {
   return yield* dispatch({
-    ...input,
-    type: "thread.unpin",
-    commandId: yield* commandId(input),
+    type: "thread.mark-unread",
+    commandId: yield* allocateCommandId(input),
+    threadId: input.threadId,
   });
 });
 
-export const reorderPinnedThread: (input: ReorderPinnedThreadInput) => CommandEffect = Effect.fn(
-  "EnvironmentCommands.reorderPinnedThread",
-)(function* (input) {
-  return yield* dispatch({
-    ...input,
-    type: "thread.pin.reorder",
-    commandId: yield* commandId(input),
-  });
-});
+export const updateThreadMetadata = Effect.fn("EnvironmentCommands.updateThreadMetadata")(
+  function* (input: UpdateThreadMetadataInput) {
+    const commandId = yield* allocateCommandId(input);
+    let result = null;
+    if (
+      input.title !== undefined ||
+      input.branch !== undefined ||
+      input.worktreePath !== undefined ||
+      input.regenerateTitle !== undefined ||
+      input.linkedPullRequest !== undefined
+    ) {
+      result = yield* dispatch({
+        type: "thread.metadata.update",
+        commandId,
+        threadId: input.threadId,
+        ...(input.title === undefined ? {} : { title: input.title }),
+        ...(input.branch === undefined ? {} : { branch: input.branch }),
+        ...(input.worktreePath === undefined ? {} : { worktreePath: input.worktreePath }),
+        ...(input.regenerateTitle === undefined ? {} : { regenerateTitle: input.regenerateTitle }),
+        ...(input.linkedPullRequest === undefined
+          ? {}
+          : { linkedPullRequest: input.linkedPullRequest }),
+      });
+    }
+    if (input.modelSelection !== undefined) {
+      const projection = yield* getProjection(input.threadId);
+      const type =
+        projection.thread.providerInstanceId === input.modelSelection.instanceId
+          ? ("thread.model-selection.set" as const)
+          : ("provider.switch" as const);
+      result = yield* dispatch({
+        type,
+        commandId: result === null ? commandId : CommandId.make(`${commandId}:model-selection`),
+        threadId: input.threadId,
+        modelSelection: input.modelSelection,
+      });
+    }
+    return result ?? { sequence: 0 };
+  },
+);
+
+export const setThreadRuntimeMode = Effect.fn("EnvironmentCommands.setThreadRuntimeMode")(
+  function* (input: SetThreadRuntimeModeInput) {
+    return yield* dispatch({
+      type: "thread.runtime-mode.set",
+      commandId: yield* allocateCommandId(input),
+      threadId: input.threadId,
+      runtimeMode: input.runtimeMode,
+    });
+  },
+);
 
-export const updateThreadMetadata: (input: UpdateThreadMetadataInput) => CommandEffect = Effect.fn(
-  "EnvironmentCommands.updateThreadMetadata",
-)(function* (input) {
+export const setThreadInteractionMode = Effect.fn("EnvironmentCommands.setThreadInteractionMode")(
+  function* (input: SetThreadInteractionModeInput) {
+    return yield* dispatch({
+      type: "thread.interaction-mode.set",
+      commandId: yield* allocateCommandId(input),
+      threadId: input.threadId,
+      interactionMode: input.interactionMode,
+    });
+  },
+);
+
+export const startThreadTurn = Effect.fn("EnvironmentCommands.startThreadTurn")(function* (
+  input: StartThreadTurnInput,
+) {
+  const commandId = yield* allocateCommandId(input);
+  const attachments = yield* persistAttachments(
+    input.threadId,
+    input.message.messageId,
+    input.message.attachments,
+  );
+  const bootstrap = input.bootstrap?.createThread;
+  const prepareWorktree = input.bootstrap?.prepareWorktree;
+  if (bootstrap !== undefined || prepareWorktree !== undefined) {
+    const existingProjection =
+      bootstrap === undefined ? yield* getProjection(input.threadId) : null;
+    const thread = bootstrap ?? existingProjection!.thread;
+    const workspaceStrategy =
+      prepareWorktree !== undefined
+        ? {
+            type: "worktree" as const,
+            baseRef: prepareWorktree.baseBranch,
+            ...(prepareWorktree.branch === undefined ? {} : { branch: prepareWorktree.branch }),
+            ...(prepareWorktree.startFromOrigin === undefined
+              ? {}
+              : { startFromOrigin: prepareWorktree.startFromOrigin }),
+          }
+        : bootstrap?.worktreePath
+          ? {
+              type: "existing_worktree" as const,
+              worktreePath: bootstrap.worktreePath,
+              ...(bootstrap.branch === null ? {} : { branch: bootstrap.branch }),
+            }
+          : {
+              type: "root" as const,
+              ...(bootstrap?.branch === null || bootstrap?.branch === undefined
+                ? {}
+                : { branch: bootstrap.branch }),
+            };
+    return yield* request(ORCHESTRATION_V2_WS_METHODS.launchThread, {
+      commandId,
+      creationSource: input.creationSource ?? "web",
+      threadId: input.threadId,
+      ...(bootstrap === undefined ? { reuseExistingThread: true } : {}),
+      projectId: thread.projectId,
+      title: input.titleSeed ?? thread.title,
+      generateTitle: input.titleSeed !== undefined,
+      modelSelection: input.modelSelection ?? thread.modelSelection,
+      runtimeMode: input.runtimeMode,
+      interactionMode: input.interactionMode,
+      workspaceStrategy,
+      initialMessage: {
+        messageId: input.message.messageId,
+        text: input.message.text,
+        attachments,
+      },
+    });
+  }
+
+  const requestedMode = input.dispatchMode ?? "auto";
+  if (requestedMode === "start") {
+    return yield* dispatch({
+      type: "message.dispatch",
+      commandId,
+      createdBy: "user",
+      creationSource: input.creationSource ?? "web",
+      threadId: input.threadId,
+      messageId: input.message.messageId,
+      text: input.message.text,
+      attachments,
+      ...(input.modelSelection === undefined ? {} : { modelSelection: input.modelSelection }),
+      ...(input.sourceProposedPlan === undefined
+        ? {}
+        : { sourcePlanRef: input.sourceProposedPlan }),
+      dispatchMode: { type: "start_immediately" },
+    });
+  }
+
+  const projection = yield* getProjection(input.threadId);
+  const activeRun = projection.runs.findLast(
+    (run) =>
+      run.status === "preparing" ||
+      run.status === "starting" ||
+      run.status === "running" ||
+      run.status === "waiting",
+  );
+  const activeProviderThread =
+    activeRun === undefined
+      ? undefined
+      : projection.providerThreads.find((thread) => thread.id === activeRun.providerThreadId);
+  const activeProviderSession =
+    activeProviderThread?.providerSessionId === null ||
+    activeProviderThread?.providerSessionId === undefined
+      ? undefined
+      : projection.providerSessions.find(
+          (session) => session.id === activeProviderThread.providerSessionId,
+        );
+  const turnCapabilities = activeProviderSession?.capabilities.turns;
+  const dispatchMode =
+    activeRun === undefined
+      ? ({ type: "start_immediately" } as const)
+      : requestedMode === "steer"
+        ? ({ type: "steer_active", targetRunId: activeRun.id } as const)
+        : requestedMode === "restart"
+          ? ({ type: "restart_active", targetRunId: activeRun.id } as const)
+          : requestedMode === "queue"
+            ? ({ type: "queue_after_active" } as const)
+            : turnCapabilities?.supportsActiveSteering === true
+              ? ({ type: "steer_active", targetRunId: activeRun.id } as const)
+              : turnCapabilities?.supportsQueuedMessages === true
+                ? ({ type: "queue_after_active" } as const)
+                : turnCapabilities?.supportsSteeringByInterruptRestart === true
+                  ? ({ type: "restart_active", targetRunId: activeRun.id } as const)
+                  : ({ type: "queue_after_active" } as const);
   return yield* dispatch({
-    ...input,
-    type: "thread.meta.update",
-    commandId: yield* commandId(input),
+    type: "message.dispatch",
+    commandId,
+    createdBy: "user",
+    creationSource: input.creationSource ?? "web",
+    threadId: input.threadId,
+    messageId: input.message.messageId,
+    text: input.message.text,
+    attachments,
+    ...(input.titleSeed === undefined || projection.messages.length > 0
+      ? {}
+      : { titleSeed: input.titleSeed }),
+    ...(input.modelSelection === undefined ? {} : { modelSelection: input.modelSelection }),
+    ...(input.sourceProposedPlan === undefined ? {} : { sourcePlanRef: input.sourceProposedPlan }),
+    dispatchMode,
   });
 });
 
-export const setThreadRuntimeMode: (input: SetThreadRuntimeModeInput) => CommandEffect = Effect.fn(
-  "EnvironmentCommands.setThreadRuntimeMode",
-)(function* (input) {
-  const metadata = yield* timestampedCommandMetadata(input);
+export const interruptThreadTurn = Effect.fn("EnvironmentCommands.interruptThreadTurn")(function* (
+  input: InterruptThreadTurnInput,
+) {
+  let runId = input.runId ?? (input.turnId as RunId | undefined);
+  if (runId === undefined) {
+    const projection = yield* getProjection(input.threadId);
+    runId = projection.runs.findLast(
+      (run) =>
+        run.status === "preparing" ||
+        run.status === "starting" ||
+        run.status === "running" ||
+        run.status === "waiting",
+    )?.id;
+  }
+  if (runId === undefined) return { sequence: 0 };
   return yield* dispatch({
-    ...input,
-    type: "thread.runtime-mode.set",
-    commandId: metadata.commandId,
-    createdAt: metadata.createdAt,
+    type: "run.interrupt",
+    commandId: yield* allocateCommandId(input),
+    threadId: input.threadId,
+    runId,
   });
 });
 
-export const setThreadInteractionMode: (input: SetThreadInteractionModeInput) => CommandEffect =
-  Effect.fn("EnvironmentCommands.setThreadInteractionMode")(function* (input) {
-    const metadata = yield* timestampedCommandMetadata(input);
+export const respondToThreadApproval = Effect.fn("EnvironmentCommands.respondToThreadApproval")(
+  function* (input: RespondToThreadApprovalInput) {
     return yield* dispatch({
-      ...input,
-      type: "thread.interaction-mode.set",
-      commandId: metadata.commandId,
-      createdAt: metadata.createdAt,
+      type: "runtime-request.respond",
+      commandId: yield* allocateCommandId(input),
+      threadId: input.threadId,
+      requestId: input.requestId,
+      decision: input.decision,
     });
-  });
+  },
+);
+
+export const respondToThreadUserInput = Effect.fn("EnvironmentCommands.respondToThreadUserInput")(
+  function* (input: RespondToThreadUserInputInput) {
+    return yield* dispatch({
+      type: "runtime-request.respond",
+      commandId: yield* allocateCommandId(input),
+      threadId: input.threadId,
+      requestId: input.requestId,
+      answers: input.answers,
+    });
+  },
+);
 
-export const startThreadTurn: (input: StartThreadTurnInput) => CommandEffect = Effect.fn(
-  "EnvironmentCommands.startThreadTurn",
-)(function* (input) {
-  const metadata = yield* timestampedCommandMetadata(input);
+export const revertThreadCheckpoint = Effect.fn("EnvironmentCommands.revertThreadCheckpoint")(
+  function* (input: RevertThreadCheckpointInput) {
+    const projection = yield* getProjection(input.threadId);
+    const checkpoint =
+      projection.checkpoints.find(
+        (candidate) => candidate.id === input.checkpointId && candidate.scopeId === input.scopeId,
+      ) ??
+      projection.checkpoints.findLast((candidate) =>
+        input.turnCount === 0
+          ? candidate.ordinalWithinScope === 0 && candidate.appRunOrdinal === null
+          : candidate.appRunOrdinal === input.turnCount,
+      );
+    if (checkpoint === undefined || checkpoint.status !== "ready") {
+      const target =
+        input.checkpointId === undefined
+          ? `run ordinal ${input.turnCount ?? "unknown"}`
+          : `checkpoint ${input.checkpointId}`;
+      return yield* new OrchestrationV2CheckpointUnavailableError({
+        threadId: input.threadId,
+        target,
+      });
+    }
+    return yield* dispatch({
+      type: "checkpoint.rollback",
+      commandId: yield* allocateCommandId(input),
+      threadId: input.threadId,
+      scopeId: checkpoint.scopeId,
+      checkpointId: checkpoint.id,
+    });
+  },
+);
+
+export const stopThreadSession = Effect.fn("EnvironmentCommands.stopThreadSession")(function* (
+  input: StopThreadSessionInput,
+) {
+  const projection = yield* getProjection(input.threadId);
+  const commandId = yield* allocateCommandId(input);
+  let result = { sequence: 0 };
+  for (const session of projection.providerSessions) {
+    result = yield* dispatch({
+      type: "provider-session.detach",
+      commandId: CommandId.make(`${commandId}:detach:${session.id}`),
+      threadId: input.threadId,
+      providerSessionId: session.id,
+      reason: "client-requested",
+    });
+  }
+  return result;
+});
+
+export const forkThreadFromRun = Effect.fn("EnvironmentCommands.forkThreadFromRun")(function* (
+  input: ForkThreadFromRunInput,
+) {
   return yield* dispatch({
-    ...input,
-    type: "thread.turn.start",
-    commandId: metadata.commandId,
-    createdAt: metadata.createdAt,
+    type: "thread.fork",
+    commandId: yield* allocateCommandId(input),
+    createdBy: "user",
+    creationSource: input.creationSource ?? "web",
+    sourceThreadId: input.sourceThreadId,
+    targetThreadId: input.targetThreadId,
+    sourcePoint: { type: "run", runId: input.runId },
+    ...(input.title === undefined ? {} : { title: input.title }),
   });
 });
 
-export const interruptThreadTurn: (input: InterruptThreadTurnInput) => CommandEffect = Effect.fn(
-  "EnvironmentCommands.interruptThreadTurn",
-)(function* (input) {
-  const metadata = yield* timestampedCommandMetadata(input);
+export const mergeThreadBack = Effect.fn("EnvironmentCommands.mergeThreadBack")(function* (
+  input: MergeThreadBackInput,
+) {
   return yield* dispatch({
-    ...input,
-    type: "thread.turn.interrupt",
-    commandId: metadata.commandId,
-    createdAt: metadata.createdAt,
+    type: "thread.merge_back",
+    commandId: yield* allocateCommandId(input),
+    createdBy: "user",
+    creationSource: input.creationSource ?? "web",
+    sourceThreadId: input.sourceThreadId,
+    targetThreadId: input.targetThreadId,
+    sourcePoint: { type: "run", runId: input.runId },
   });
 });
 
-export const respondToThreadApproval: (input: RespondToThreadApprovalInput) => CommandEffect =
-  Effect.fn("EnvironmentCommands.respondToThreadApproval")(function* (input) {
-    const metadata = yield* timestampedCommandMetadata(input);
-    return yield* dispatch({
-      ...input,
-      type: "thread.approval.respond",
-      commandId: metadata.commandId,
-      createdAt: metadata.createdAt,
-    });
+export const reorderQueuedRun = Effect.fn("EnvironmentCommands.reorderQueuedRun")(function* (
+  input: ReorderQueuedRunInput,
+) {
+  return yield* dispatch({
+    type: "queued-run.reorder",
+    commandId: yield* allocateCommandId(input),
+    threadId: input.threadId,
+    runId: input.runId,
+    beforeRunId: input.beforeRunId,
   });
+});
 
-export const respondToThreadUserInput: (input: RespondToThreadUserInputInput) => CommandEffect =
-  Effect.fn("EnvironmentCommands.respondToThreadUserInput")(function* (input) {
-    const metadata = yield* timestampedCommandMetadata(input);
-    return yield* dispatch({
-      ...input,
-      type: "thread.user-input.respond",
-      commandId: metadata.commandId,
-      createdAt: metadata.createdAt,
-    });
+export const promoteQueuedRun = Effect.fn("EnvironmentCommands.promoteQueuedRun")(function* (
+  input: PromoteQueuedRunInput,
+) {
+  return yield* dispatch({
+    type: "queued-message.promote-to-steer",
+    commandId: yield* allocateCommandId(input),
+    threadId: input.threadId,
+    queuedRunId: input.queuedRunId,
+    targetRunId: input.targetRunId,
   });
+});
 
-export const revertThreadCheckpoint: (input: RevertThreadCheckpointInput) => CommandEffect =
-  Effect.fn("EnvironmentCommands.revertThreadCheckpoint")(function* (input) {
-    const metadata = yield* timestampedCommandMetadata(input);
-    return yield* dispatch({
-      ...input,
-      type: "thread.checkpoint.revert",
-      commandId: metadata.commandId,
-      createdAt: metadata.createdAt,
-    });
+export const cancelQueuedRun = Effect.fn("EnvironmentCommands.cancelQueuedRun")(function* (
+  input: CancelQueuedRunInput,
+) {
+  return yield* dispatch({
+    type: "queued-run.cancel",
+    commandId: yield* allocateCommandId(input),
+    threadId: input.threadId,
+    runId: input.runId,
   });
+});
 
-export const stopThreadSession: (input: StopThreadSessionInput) => CommandEffect = Effect.fn(
-  "EnvironmentCommands.stopThreadSession",
-)(function* (input) {
-  const metadata = yield* timestampedCommandMetadata(input);
+export const editQueuedRun = Effect.fn("EnvironmentCommands.editQueuedRun")(function* (
+  input: EditQueuedRunInput,
+) {
+  const attachments =
+    input.edit === undefined
+      ? undefined
+      : yield* persistAttachments(input.threadId, input.edit.messageId, input.edit.attachments);
   return yield* dispatch({
-    ...input,
-    type: "thread.session.stop",
-    commandId: metadata.commandId,
-    createdAt: metadata.createdAt,
+    type: "queued-run.edit",
+    commandId: yield* allocateCommandId(input),
+    threadId: input.threadId,
+    runId: input.runId,
+    text: input.text,
+    ...(attachments === undefined ? {} : { attachments }),
   });
 });
diff --git a/packages/client-runtime/src/operations/index.ts b/packages/client-runtime/src/operations/index.ts
index b7307fbb81fe..2bafb27be27b 100644
--- a/packages/client-runtime/src/operations/index.ts
+++ b/packages/client-runtime/src/operations/index.ts
@@ -1,2 +1,3 @@
 export * from "./commands.ts";
 export * from "./projects.ts";
+export * from "./threadTitle.ts";
diff --git a/packages/client-runtime/src/operations/projects.test.ts b/packages/client-runtime/src/operations/projects.test.ts
index cbbd121959d5..341593f929f2 100644
--- a/packages/client-runtime/src/operations/projects.test.ts
+++ b/packages/client-runtime/src/operations/projects.test.ts
@@ -250,13 +250,12 @@ describe("add project shared logic", () => {
     );
   });
 
-  it("builds the existing project.create command shape", () => {
+  it("builds the V2 project.create mutation", () => {
     expect(
       buildProjectCreateCommand({
         commandId: CommandId.make("command"),
         projectId: ProjectId.make("project"),
         workspaceRoot: "/work/repo",
-        createdAt: "2026-01-01T00:00:00.000Z",
       }),
     ).toMatchObject({
       type: "project.create",
diff --git a/packages/client-runtime/src/operations/projects.ts b/packages/client-runtime/src/operations/projects.ts
index 3f5fc3667f31..3944e6978403 100644
--- a/packages/client-runtime/src/operations/projects.ts
+++ b/packages/client-runtime/src/operations/projects.ts
@@ -2,7 +2,7 @@ import type { EnvironmentConnectionPhase } from "../connection/presentation.ts";
 import type {
   CommandId,
   EnvironmentId,
-  OrchestrationCommand,
+  ProjectMutation,
   ProjectId,
   SourceControlDiscoveryResult,
   SourceControlProviderKind,
@@ -301,8 +301,7 @@ export function buildProjectCreateCommand(input: {
   readonly commandId: CommandId;
   readonly projectId: ProjectId;
   readonly workspaceRoot: string;
-  readonly createdAt: string;
-}): Extract<OrchestrationCommand, { type: "project.create" }> {
+}): Extract<ProjectMutation, { type: "project.create" }> {
   return {
     type: "project.create",
     commandId: input.commandId,
@@ -311,6 +310,5 @@ export function buildProjectCreateCommand(input: {
     workspaceRoot: input.workspaceRoot,
     createWorkspaceRootIfMissing: true,
     defaultModelSelection: null,
-    createdAt: input.createdAt,
   };
 }
diff --git a/packages/client-runtime/src/operations/threadTitle.test.ts b/packages/client-runtime/src/operations/threadTitle.test.ts
new file mode 100644
index 000000000000..ab7aaff7ff49
--- /dev/null
+++ b/packages/client-runtime/src/operations/threadTitle.test.ts
@@ -0,0 +1,47 @@
+import { describe, expect, it } from "@effect/vitest";
+
+import { deriveThreadTitleSeed } from "./threadTitle.ts";
+
+describe("deriveThreadTitleSeed", () => {
+  it("prefers normalized message text", () => {
+    expect(
+      deriveThreadTitleSeed({
+        text: "  Investigate\n  login   failures  ",
+        attachments: [{ name: "login-error.png" }],
+        fallbackLabels: ["Terminal 1"],
+      }),
+    ).toBe("Investigate login failures");
+  });
+
+  it("uses the first attachment name when text is empty", () => {
+    expect(
+      deriveThreadTitleSeed({
+        text: " \n ",
+        attachments: [{ name: "login-error.png" }, { name: "other.png" }],
+      }),
+    ).toBe("Image: login-error.png");
+  });
+
+  it("uses the first non-empty fallback label after text and attachments", () => {
+    expect(
+      deriveThreadTitleSeed({
+        text: "",
+        attachments: [],
+        fallbackLabels: [null, "  ", "Terminal 1"],
+      }),
+    ).toBe("Terminal 1");
+  });
+
+  it("falls back to New thread", () => {
+    expect(deriveThreadTitleSeed({ text: "", attachments: [] })).toBe("New thread");
+  });
+
+  it("applies the shared title truncation", () => {
+    expect(
+      deriveThreadTitleSeed({
+        text: "x".repeat(60),
+        attachments: [],
+      }),
+    ).toBe(`${"x".repeat(50)}...`);
+  });
+});
diff --git a/packages/client-runtime/src/operations/threadTitle.ts b/packages/client-runtime/src/operations/threadTitle.ts
new file mode 100644
index 000000000000..36771e875f85
--- /dev/null
+++ b/packages/client-runtime/src/operations/threadTitle.ts
@@ -0,0 +1,32 @@
+import { truncate } from "@t3tools/shared/String";
+
+export interface ThreadTitleSeedInput {
+  readonly text: string;
+  readonly attachments: ReadonlyArray<{ readonly name: string }>;
+  readonly fallbackLabels?: ReadonlyArray<string | null | undefined>;
+}
+
+function normalizeTitleSeed(value: string): string {
+  return value.trim().replace(/\s+/gu, " ");
+}
+
+export function deriveThreadTitleSeed(input: ThreadTitleSeedInput): string {
+  const text = normalizeTitleSeed(input.text);
+  if (text.length > 0) {
+    return truncate(text);
+  }
+
+  const attachmentName = normalizeTitleSeed(input.attachments[0]?.name ?? "");
+  if (attachmentName.length > 0) {
+    return truncate(`Image: ${attachmentName}`);
+  }
+
+  for (const label of input.fallbackLabels ?? []) {
+    const normalized = normalizeTitleSeed(label ?? "");
+    if (normalized.length > 0) {
+      return truncate(normalized);
+    }
+  }
+
+  return "New thread";
+}
diff --git a/packages/client-runtime/src/platform/index.ts b/packages/client-runtime/src/platform/index.ts
index 0c937549771f..1006aa347a9b 100644
--- a/packages/client-runtime/src/platform/index.ts
+++ b/packages/client-runtime/src/platform/index.ts
@@ -1,4 +1,5 @@
 export * from "./capabilities.ts";
 export * from "./persistence.ts";
+export * from "./orchestrationCache.ts";
 export * from "./source.ts";
 export * from "./storageDocument.ts";
diff --git a/packages/client-runtime/src/platform/orchestrationCache.test.ts b/packages/client-runtime/src/platform/orchestrationCache.test.ts
new file mode 100644
index 000000000000..33b30f8f675b
--- /dev/null
+++ b/packages/client-runtime/src/platform/orchestrationCache.test.ts
@@ -0,0 +1,143 @@
+import { describe, expect, it } from "@effect/vitest";
+import {
+  CommandId,
+  EnvironmentId,
+  MessageId,
+  RuntimeRequestId,
+  type OrchestrationV2ShellSnapshot,
+} from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import * as Schema from "effect/Schema";
+
+import {
+  ORCHESTRATION_CACHE_SCHEMA_VERSION,
+  StoredOrchestrationShellSnapshot,
+  StoredOrchestrationThreadSnapshot,
+  decodeOrDiscardOrchestrationCache,
+} from "./orchestrationCache.ts";
+import {
+  v2Now,
+  v2Projection,
+  v2ShellSnapshot,
+  v2ThreadShell,
+  v2ThreadId,
+} from "../state/orchestrationV2TestFixtures.ts";
+
+const environmentId = EnvironmentId.make("environment-cache-test");
+const StoredShellSnapshotJson = Schema.fromJsonString(StoredOrchestrationShellSnapshot);
+const StoredThreadSnapshotJson = Schema.fromJsonString(StoredOrchestrationThreadSnapshot);
+const encodeStoredShellSnapshot = Schema.encodeSync(StoredOrchestrationShellSnapshot);
+const decodeStoredShellSnapshotSync = Schema.decodeUnknownSync(StoredOrchestrationShellSnapshot);
+const encodeStoredShellSnapshotJson = Schema.encodeSync(StoredShellSnapshotJson);
+const decodeStoredShellSnapshotJson = Schema.decodeUnknownSync(StoredShellSnapshotJson);
+const encodeStoredThreadSnapshotJson = Schema.encodeSync(StoredThreadSnapshotJson);
+const decodeStoredThreadSnapshotJson = Schema.decodeUnknownSync(StoredThreadSnapshotJson);
+
+class TestCacheDecodeError extends Schema.TaggedErrorClass<TestCacheDecodeError>()(
+  "TestCacheDecodeError",
+  {
+    message: Schema.String,
+  },
+) {}
+
+const shellSnapshotWithSummaries: OrchestrationV2ShellSnapshot = {
+  ...v2ShellSnapshot,
+  threads: [
+    {
+      ...v2ThreadShell,
+      pendingRuntimeRequest: {
+        id: RuntimeRequestId.make("runtime-request-v2"),
+        kind: "command",
+        createdAt: v2Now,
+      },
+      latestVisibleMessage: {
+        id: MessageId.make("message-v2"),
+        role: "assistant",
+        text: "Done",
+        updatedAt: v2Now,
+      },
+      latestUserMessageAt: v2Now,
+      settledAt: v2Now,
+      titleRegeneration: {
+        requestId: CommandId.make("title-regeneration-v2"),
+        startedAt: v2Now,
+      },
+    },
+  ],
+};
+
+describe("orchestration cache envelopes", () => {
+  it.effect("round-trips V2 shell and thread cache envelopes as JSON", () =>
+    Effect.sync(() => {
+      const encodedShell = encodeStoredShellSnapshotJson({
+        schemaVersion: ORCHESTRATION_CACHE_SCHEMA_VERSION,
+        environmentId,
+        snapshot: shellSnapshotWithSummaries,
+      });
+      const shell = decodeStoredShellSnapshotJson(encodedShell);
+      const encodedThread = encodeStoredThreadSnapshotJson({
+        schemaVersion: ORCHESTRATION_CACHE_SCHEMA_VERSION,
+        environmentId,
+        threadId: v2ThreadId,
+        snapshot: { snapshotSequence: 4, projection: v2Projection },
+      });
+      const thread = decodeStoredThreadSnapshotJson(encodedThread);
+      const [threadShell] = shell.snapshot.threads;
+
+      expect(threadShell?.latestVisibleMessage?.text).toBe("Done");
+      expect(
+        threadShell?.latestVisibleMessage === null ||
+          threadShell?.latestVisibleMessage === undefined
+          ? null
+          : DateTime.formatIso(threadShell.latestVisibleMessage.updatedAt),
+      ).toBe("2026-06-20T00:00:00.000Z");
+      expect(
+        threadShell?.latestUserMessageAt === null || threadShell?.latestUserMessageAt === undefined
+          ? null
+          : DateTime.formatIso(threadShell.latestUserMessageAt),
+      ).toBe("2026-06-20T00:00:00.000Z");
+      expect(
+        threadShell?.settledAt === null || threadShell?.settledAt === undefined
+          ? null
+          : DateTime.formatIso(threadShell.settledAt),
+      ).toBe("2026-06-20T00:00:00.000Z");
+      expect(
+        threadShell?.titleRegeneration === null || threadShell?.titleRegeneration === undefined
+          ? null
+          : DateTime.formatIso(threadShell.titleRegeneration.startedAt),
+      ).toBe("2026-06-20T00:00:00.000Z");
+      expect(DateTime.formatIso(thread.snapshot.projection.thread.updatedAt)).toBe(
+        "2026-06-20T00:00:00.000Z",
+      );
+      expect(thread.snapshot.projection).toEqual(v2Projection);
+      expect(thread.snapshot.snapshotSequence).toBe(4);
+    }),
+  );
+
+  it.effect("discards V1-versioned cache envelopes after a decode failure", () =>
+    Effect.gen(function* () {
+      let discardCount = 0;
+      const encodedShell = encodeStoredShellSnapshot({
+        schemaVersion: ORCHESTRATION_CACHE_SCHEMA_VERSION,
+        environmentId,
+        snapshot: v2ShellSnapshot,
+      });
+      const decoded = Effect.try({
+        try: () => decodeStoredShellSnapshotSync({ ...encodedShell, schemaVersion: 1 }),
+        catch: (cause) => new TestCacheDecodeError({ message: String(cause) }),
+      }).pipe(Effect.map(Option.some));
+
+      const result = yield* decodeOrDiscardOrchestrationCache(
+        decoded,
+        Effect.sync(() => {
+          discardCount += 1;
+        }),
+      );
+
+      expect(Option.isNone(result)).toBe(true);
+      expect(discardCount).toBe(1);
+    }),
+  );
+});
diff --git a/packages/client-runtime/src/platform/orchestrationCache.ts b/packages/client-runtime/src/platform/orchestrationCache.ts
new file mode 100644
index 000000000000..e39fe6c1dfe6
--- /dev/null
+++ b/packages/client-runtime/src/platform/orchestrationCache.ts
@@ -0,0 +1,36 @@
+import {
+  EnvironmentId,
+  OrchestrationV2ShellSnapshotJson,
+  OrchestrationV2ThreadDetailSnapshot,
+  OrchestrationV2ThreadProjectionJson,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import * as Schema from "effect/Schema";
+
+export const ORCHESTRATION_CACHE_SCHEMA_VERSION = 3 as const;
+
+export const StoredOrchestrationShellSnapshot = Schema.Struct({
+  schemaVersion: Schema.Literal(ORCHESTRATION_CACHE_SCHEMA_VERSION),
+  environmentId: EnvironmentId,
+  snapshot: OrchestrationV2ShellSnapshotJson,
+});
+
+export const StoredOrchestrationThreadSnapshot = Schema.Struct({
+  schemaVersion: Schema.Literal(ORCHESTRATION_CACHE_SCHEMA_VERSION),
+  environmentId: EnvironmentId,
+  threadId: ThreadId,
+  snapshot: OrchestrationV2ThreadDetailSnapshot.mapFields((fields) => ({
+    ...fields,
+    projection: OrchestrationV2ThreadProjectionJson,
+  })),
+});
+
+/** Invalid orchestration caches are disposable and must never block live synchronization. */
+export function decodeOrDiscardOrchestrationCache<A, E, R, E2, R2>(
+  decode: Effect.Effect<Option.Option<A>, E, R>,
+  discard: Effect.Effect<void, E2, R2>,
+) {
+  return decode.pipe(Effect.catch(() => discard.pipe(Effect.as(Option.none<A>()))));
+}
diff --git a/packages/client-runtime/src/platform/persistence.ts b/packages/client-runtime/src/platform/persistence.ts
index 14a322bcd303..34bb8c629d11 100644
--- a/packages/client-runtime/src/platform/persistence.ts
+++ b/packages/client-runtime/src/platform/persistence.ts
@@ -1,7 +1,7 @@
 import {
   type EnvironmentId,
-  type OrchestrationShellSnapshot,
-  type OrchestrationThreadDetailSnapshot,
+  type OrchestrationV2ShellSnapshot,
+  type OrchestrationV2ThreadDetailSnapshot,
   type ServerConfig,
   type ThreadId,
   type VcsListRefsResult,
@@ -60,21 +60,21 @@ export class EnvironmentCacheStore extends Context.Service<
   {
     readonly loadShell: (
       environmentId: EnvironmentId,
-    ) => Effect.Effect<Option.Option<OrchestrationShellSnapshot>, ConnectionPersistenceError>;
+    ) => Effect.Effect<Option.Option<OrchestrationV2ShellSnapshot>, ConnectionPersistenceError>;
     readonly saveShell: (
       environmentId: EnvironmentId,
-      snapshot: OrchestrationShellSnapshot,
+      snapshot: OrchestrationV2ShellSnapshot,
     ) => Effect.Effect<void, ConnectionPersistenceError>;
     readonly loadThread: (
       environmentId: EnvironmentId,
       threadId: ThreadId,
     ) => Effect.Effect<
-      Option.Option<OrchestrationThreadDetailSnapshot>,
+      Option.Option<OrchestrationV2ThreadDetailSnapshot>,
       ConnectionPersistenceError
     >;
     readonly saveThread: (
       environmentId: EnvironmentId,
-      snapshot: OrchestrationThreadDetailSnapshot,
+      snapshot: OrchestrationV2ThreadDetailSnapshot,
     ) => Effect.Effect<void, ConnectionPersistenceError>;
     readonly removeThread: (
       environmentId: EnvironmentId,
diff --git a/packages/client-runtime/src/rpc/client.ts b/packages/client-runtime/src/rpc/client.ts
index bfe57a6c0dd5..f1a5c38272f1 100644
--- a/packages/client-runtime/src/rpc/client.ts
+++ b/packages/client-runtime/src/rpc/client.ts
@@ -1,4 +1,4 @@
-import { ORCHESTRATION_WS_METHODS, WS_METHODS } from "@t3tools/contracts";
+import { ORCHESTRATION_V2_WS_METHODS, WS_METHODS } from "@t3tools/contracts";
 import * as Cause from "effect/Cause";
 import * as Context from "effect/Context";
 import type * as Duration from "effect/Duration";
@@ -40,11 +40,12 @@ export type EnvironmentRpcTag = keyof WsRpcProtocolClient & string;
 type RpcMethod<TTag extends EnvironmentRpcTag> = WsRpcProtocolClient[TTag];
 
 export type EnvironmentSubscriptionRpcTag =
-  | typeof ORCHESTRATION_WS_METHODS.subscribeShell
-  | typeof ORCHESTRATION_WS_METHODS.subscribeThread
+  | typeof ORCHESTRATION_V2_WS_METHODS.subscribeShell
+  | typeof ORCHESTRATION_V2_WS_METHODS.subscribeThread
   | typeof WS_METHODS.subscribeAuthAccess
   | typeof WS_METHODS.subscribeServerConfig
   | typeof WS_METHODS.subscribeServerLifecycle
+  | typeof WS_METHODS.scheduledTasksSubscribe
   | typeof WS_METHODS.subscribeTerminalEvents
   | typeof WS_METHODS.subscribeTerminalMetadata
   | typeof WS_METHODS.subscribePreviewEvents
diff --git a/packages/client-runtime/src/state/archivedThreads.test.ts b/packages/client-runtime/src/state/archivedThreads.test.ts
index aa16b9cadcd7..4928b1f81104 100644
--- a/packages/client-runtime/src/state/archivedThreads.test.ts
+++ b/packages/client-runtime/src/state/archivedThreads.test.ts
@@ -1,4 +1,4 @@
-import { EnvironmentId, type OrchestrationShellSnapshot } from "@t3tools/contracts";
+import { EnvironmentId, type OrchestrationV2ArchivedShellSnapshot } from "@t3tools/contracts";
 import * as Cause from "effect/Cause";
 import { AsyncResult, Atom, AtomRegistry } from "effect/unstable/reactivity";
 import { expect, it } from "vite-plus/test";
@@ -22,7 +22,7 @@ it("does not expose an archived snapshot failure message", () => {
   const snapshotsAtom = createArchivedThreadSnapshotsAtomFamily<Error>({
     getSnapshotAtom: () =>
       Atom.make(
-        AsyncResult.failure<OrchestrationShellSnapshot, Error>(
+        AsyncResult.failure<OrchestrationV2ArchivedShellSnapshot, Error>(
           Cause.fail(new Error("credential=secret-value")),
         ),
       ),
diff --git a/packages/client-runtime/src/state/archivedThreads.ts b/packages/client-runtime/src/state/archivedThreads.ts
index 8c64f1ae506d..8b71479b45ec 100644
--- a/packages/client-runtime/src/state/archivedThreads.ts
+++ b/packages/client-runtime/src/state/archivedThreads.ts
@@ -1,4 +1,4 @@
-import { EnvironmentId, type OrchestrationShellSnapshot } from "@t3tools/contracts";
+import { EnvironmentId, type OrchestrationV2ArchivedShellSnapshot } from "@t3tools/contracts";
 import * as Arr from "effect/Array";
 import { pipe } from "effect/Function";
 import * as Option from "effect/Option";
@@ -7,7 +7,7 @@ import { AsyncResult, Atom } from "effect/unstable/reactivity";
 
 export interface ArchivedSnapshotEntry {
   readonly environmentId: EnvironmentId;
-  readonly snapshot: OrchestrationShellSnapshot;
+  readonly snapshot: OrchestrationV2ArchivedShellSnapshot;
 }
 
 export interface ArchivedThreadSnapshotsState {
@@ -40,7 +40,7 @@ export function parseArchivedThreadsEnvironmentKey(key: string): ReadonlyArray<E
 export function createArchivedThreadSnapshotsAtomFamily<E>(options: {
   readonly getSnapshotAtom: (
     environmentId: EnvironmentId,
-  ) => Atom.Atom<AsyncResult.AsyncResult<OrchestrationShellSnapshot, E>>;
+  ) => Atom.Atom<AsyncResult.AsyncResult<OrchestrationV2ArchivedShellSnapshot, E>>;
   readonly labelPrefix: string;
 }) {
   return Atom.family((environmentKey: string) =>
diff --git a/packages/client-runtime/src/state/boundedThreadSnapshotHttp.test.ts b/packages/client-runtime/src/state/boundedThreadSnapshotHttp.test.ts
new file mode 100644
index 000000000000..1ac5b7e6b529
--- /dev/null
+++ b/packages/client-runtime/src/state/boundedThreadSnapshotHttp.test.ts
@@ -0,0 +1,214 @@
+import { ThreadId } from "@t3tools/contracts";
+import { describe, expect, it } from "@effect/vitest";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+
+import { PrimaryConnectionTarget, type PreparedConnection } from "../connection/model.ts";
+import { remoteHttpClientLayer } from "../rpc/http.ts";
+import { boundedThreadSnapshotLoaderLayer } from "./boundedThreadSnapshotHttp.ts";
+import { ThreadSnapshotLoader } from "./threadSnapshotHttp.ts";
+
+const TARGET = new PrimaryConnectionTarget({
+  environmentId: "environment-bounded" as never,
+  label: "Bounded",
+  httpBaseUrl: "https://environment.example.test",
+  wsBaseUrl: "wss://environment.example.test",
+});
+
+const PREPARED: PreparedConnection = {
+  environmentId: TARGET.environmentId,
+  label: TARGET.label,
+  httpBaseUrl: TARGET.httpBaseUrl,
+  socketUrl: TARGET.wsBaseUrl,
+  httpAuthorization: null,
+  target: TARGET,
+};
+
+const THREAD_ID = ThreadId.make("thread-bounded");
+const NOW = "2026-06-20T00:00:00.000Z";
+
+const FULL_SNAPSHOT_BODY = {
+  snapshotSequence: 9,
+  projection: {
+    thread: {
+      createdBy: "user",
+      creationSource: "web",
+      id: String(THREAD_ID),
+      projectId: "project-1",
+      title: "Full fallback thread",
+      providerInstanceId: "codex",
+      modelSelection: { instanceId: "codex", model: "gpt-5" },
+      runtimeMode: "full-access",
+      interactionMode: "default",
+      branch: null,
+      worktreePath: null,
+      activeProviderThreadId: null,
+      lineage: {
+        parentThreadId: null,
+        relationshipToParent: null,
+        rootThreadId: String(THREAD_ID),
+      },
+      forkedFrom: null,
+      createdAt: NOW,
+      updatedAt: NOW,
+      archivedAt: null,
+      deletedAt: null,
+      settledOverride: null,
+      settledAt: null,
+    },
+    runs: [],
+    attempts: [],
+    nodes: [],
+    subagents: [],
+    providerSessions: [],
+    providerThreads: [],
+    providerTurns: [],
+    runtimeRequests: [],
+    messages: [],
+    plans: [],
+    turnItems: [],
+    checkpointScopes: [],
+    checkpoints: [],
+    contextHandoffs: [],
+    contextTransfers: [],
+    visibleTurnItems: [],
+    updatedAt: NOW,
+  },
+};
+
+describe("boundedThreadSnapshotLoader", () => {
+  it.effect("falls back to full HTTP snapshot when bounded returns a plain route 404", () => {
+    const fetchFn = ((input: RequestInfo | URL) => {
+      const url = String(input);
+      if (url.includes(`/api/orchestration/threads/${THREAD_ID}/bounded`)) {
+        // Generic HTML/route 404: not a structured thread_not_found payload.
+        return Promise.resolve(
+          new Response("Not Found", {
+            status: 404,
+            headers: { "content-type": "text/plain" },
+          }),
+        );
+      }
+      expect(url).toContain(`/api/orchestration/threads/${THREAD_ID}`);
+      expect(url.includes("/bounded")).toBe(false);
+      return Promise.resolve(
+        new Response(JSON.stringify(FULL_SNAPSHOT_BODY), {
+          status: 200,
+          headers: { "content-type": "application/json" },
+        }),
+      );
+    }) satisfies typeof fetch;
+
+    return Effect.gen(function* () {
+      const loader = yield* ThreadSnapshotLoader;
+      const result = yield* loader.load(PREPARED, THREAD_ID);
+      expect(result._tag).toBe("present");
+      if (result._tag === "present") {
+        expect(result.snapshot.snapshotSequence).toBe(9);
+        expect(result.snapshot.projection.thread.title).toBe("Full fallback thread");
+        expect(result.history).toBeUndefined();
+      }
+    }).pipe(
+      Effect.provide(
+        Layer.provide(boundedThreadSnapshotLoaderLayer, remoteHttpClientLayer(fetchFn)),
+      ),
+    );
+  });
+
+  it.effect("treats structured EnvironmentResourceNotFoundError from bounded as missing", () => {
+    const fetchFn = ((input: RequestInfo | URL) => {
+      const url = String(input);
+      expect(url).toContain(`/api/orchestration/threads/${THREAD_ID}/bounded`);
+      return Promise.resolve(
+        Response.json(
+          {
+            _tag: "EnvironmentResourceNotFoundError",
+            code: "not_found",
+            reason: "thread_not_found",
+            traceId: "trace-bounded-missing",
+          },
+          { status: 404 },
+        ),
+      );
+    }) satisfies typeof fetch;
+
+    return Effect.gen(function* () {
+      const loader = yield* ThreadSnapshotLoader;
+      const result = yield* loader.load(PREPARED, THREAD_ID);
+      expect(result).toEqual({ _tag: "missing" });
+    }).pipe(
+      Effect.provide(
+        Layer.provide(boundedThreadSnapshotLoaderLayer, remoteHttpClientLayer(fetchFn)),
+      ),
+    );
+  });
+
+  it.effect("treats structured missing from full fallback as missing", () => {
+    let fullCalls = 0;
+    const fetchFn = ((input: RequestInfo | URL) => {
+      const url = String(input);
+      if (url.includes("/bounded")) {
+        return Promise.resolve(
+          new Response("Not Found", {
+            status: 404,
+            headers: { "content-type": "text/plain" },
+          }),
+        );
+      }
+      fullCalls += 1;
+      return Promise.resolve(
+        Response.json(
+          {
+            _tag: "EnvironmentResourceNotFoundError",
+            code: "not_found",
+            reason: "thread_not_found",
+            traceId: "trace-full-missing",
+          },
+          { status: 404 },
+        ),
+      );
+    }) satisfies typeof fetch;
+
+    return Effect.gen(function* () {
+      const loader = yield* ThreadSnapshotLoader;
+      const result = yield* loader.load(PREPARED, THREAD_ID);
+      expect(result).toEqual({ _tag: "missing" });
+      expect(fullCalls).toBe(1);
+    }).pipe(
+      Effect.provide(
+        Layer.provide(boundedThreadSnapshotLoaderLayer, remoteHttpClientLayer(fetchFn)),
+      ),
+    );
+  });
+
+  it.effect(
+    "uses socket fallback directly when the bounded endpoint has a transient failure",
+    () => {
+      let fullCalls = 0;
+      const fetchFn = ((input: RequestInfo | URL) => {
+        const url = String(input);
+        if (url.includes("/bounded")) {
+          return Promise.resolve(new Response("Service Unavailable", { status: 503 }));
+        }
+        fullCalls += 1;
+        return Promise.resolve(
+          new Response(JSON.stringify(FULL_SNAPSHOT_BODY), {
+            status: 200,
+            headers: { "content-type": "application/json" },
+          }),
+        );
+      }) satisfies typeof fetch;
+
+      return Effect.gen(function* () {
+        const loader = yield* ThreadSnapshotLoader;
+        const result = yield* loader.load(PREPARED, THREAD_ID);
+        expect(result).toEqual({ _tag: "unavailable" });
+        expect(fullCalls).toBe(0);
+      }).pipe(
+        Effect.provide(
+          Layer.provide(boundedThreadSnapshotLoaderLayer, remoteHttpClientLayer(fetchFn)),
+        ),
+      );
+    },
+  );
+});
diff --git a/packages/client-runtime/src/state/boundedThreadSnapshotHttp.ts b/packages/client-runtime/src/state/boundedThreadSnapshotHttp.ts
new file mode 100644
index 000000000000..92ed1751ea12
--- /dev/null
+++ b/packages/client-runtime/src/state/boundedThreadSnapshotHttp.ts
@@ -0,0 +1,160 @@
+import type { ThreadId } from "@t3tools/contracts";
+import * as Cause from "effect/Cause";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import { HttpClient } from "effect/unstable/http";
+
+import type { PreparedConnection } from "../connection/model.ts";
+import { environmentEndpointUrl } from "../environment/endpoint.ts";
+import { ManagedRelayDpopSigner } from "../relay/managedRelay.ts";
+import { executeEnvironmentHttpRequest, makeEnvironmentHttpApiClient } from "../rpc/http.ts";
+import {
+  buildEnvironmentAuthHeaders,
+  withEnvironmentCredentials,
+  withOrchestrationProtocolHeader,
+} from "./environmentHttpAuth.ts";
+import {
+  fetchEnvironmentThreadSnapshot,
+  ThreadSnapshotLoader,
+  type ThreadSnapshotLoadResult,
+} from "./threadSnapshotHttp.ts";
+
+// Same cold-open budget as the full snapshot path; bounded payloads should fit.
+const DEFAULT_BOUNDED_THREAD_SNAPSHOT_TIMEOUT_MS = 6_000;
+
+/** Load a bounded recent-window thread snapshot over HTTP. */
+export const fetchEnvironmentBoundedThreadSnapshot = Effect.fn(
+  "clientRuntime.state.fetchEnvironmentBoundedThreadSnapshot",
+)(function* (input: {
+  readonly prepared: PreparedConnection;
+  readonly threadId: ThreadId;
+  readonly signer: Option.Option<ManagedRelayDpopSigner["Service"]>;
+  readonly timeoutMs?: number;
+}) {
+  const requestUrl = environmentEndpointUrl(
+    input.prepared.httpBaseUrl,
+    `/api/orchestration/threads/${input.threadId}/bounded`,
+  );
+  const client = yield* makeEnvironmentHttpApiClient(input.prepared.httpBaseUrl);
+  const headers = yield* buildEnvironmentAuthHeaders(
+    input.prepared.httpAuthorization,
+    "GET",
+    requestUrl,
+    input.signer,
+  );
+  return yield* executeEnvironmentHttpRequest(
+    requestUrl,
+    input.timeoutMs ?? DEFAULT_BOUNDED_THREAD_SNAPSHOT_TIMEOUT_MS,
+    withEnvironmentCredentials(
+      input.prepared.httpAuthorization,
+      client.orchestration.threadBoundedSnapshot({
+        params: { threadId: input.threadId },
+        headers: withOrchestrationProtocolHeader(headers),
+      }),
+    ),
+  );
+});
+
+/**
+ * Shared ThreadSnapshotLoader for clients that render progressive history.
+ * Seeds from the bounded HTTP snapshot when available. Older servers that lack
+ * the bounded route (plain/generic 404) fall back to the existing full HTTP
+ * thread snapshot. Structured EnvironmentResourceNotFoundError from either
+ * endpoint still means missing. Transient failures report `unavailable` so the
+ * socket path remains a last resort for connectivity issues.
+ */
+export const boundedThreadSnapshotLoaderLayer: Layer.Layer<
+  ThreadSnapshotLoader,
+  never,
+  HttpClient.HttpClient
+> = Layer.effect(
+  ThreadSnapshotLoader,
+  Effect.gen(function* () {
+    const httpClient = yield* HttpClient.HttpClient;
+    const signer = yield* Effect.serviceOption(ManagedRelayDpopSigner);
+    return ThreadSnapshotLoader.of({
+      load: (prepared: PreparedConnection, threadId: ThreadId) => {
+        const loadFullFallback = fetchEnvironmentThreadSnapshot({
+          prepared,
+          threadId,
+          signer,
+        }).pipe(
+          Effect.map(
+            (snapshot): ThreadSnapshotLoadResult => ({
+              _tag: "present",
+              snapshot,
+            }),
+          ),
+          Effect.provideService(HttpClient.HttpClient, httpClient),
+          Effect.catchTags({
+            EnvironmentResourceNotFoundError: () =>
+              Effect.logDebug(
+                "Full thread snapshot not found over HTTP after bounded fallback; treating the thread as deleted.",
+              ).pipe(
+                Effect.annotateLogs({ threadId }),
+                Effect.as({ _tag: "missing" } satisfies ThreadSnapshotLoadResult),
+              ),
+          }),
+          Effect.catchCause((cause) =>
+            Effect.logWarning(
+              "Could not load the full thread snapshot over HTTP after bounded fallback; using the socket snapshot instead.",
+            ).pipe(
+              Effect.annotateLogs({ threadId, cause: Cause.pretty(cause) }),
+              Effect.as({ _tag: "unavailable" } satisfies ThreadSnapshotLoadResult),
+            ),
+          ),
+        );
+
+        return fetchEnvironmentBoundedThreadSnapshot({ prepared, threadId, signer }).pipe(
+          Effect.map(
+            (bounded): ThreadSnapshotLoadResult => ({
+              _tag: "present",
+              snapshot: {
+                snapshotSequence: bounded.snapshotSequence,
+                projection: bounded.projection,
+                latestLocalTurnOrdinal: bounded.latestLocalTurnOrdinal,
+              },
+              history: {
+                historyCursor: bounded.historyCursor,
+                hasMoreHistory: bounded.hasMoreHistory,
+                latestLocalTurnOrdinal: bounded.latestLocalTurnOrdinal,
+              },
+            }),
+          ),
+          Effect.provideService(HttpClient.HttpClient, httpClient),
+          Effect.catchTags({
+            EnvironmentResourceNotFoundError: () =>
+              Effect.logDebug(
+                "Bounded thread snapshot not found over HTTP; treating the thread as deleted.",
+              ).pipe(
+                Effect.annotateLogs({ threadId }),
+                Effect.as({ _tag: "missing" } satisfies ThreadSnapshotLoadResult),
+              ),
+            RemoteEnvironmentAuthInvalidJsonError: (error) =>
+              Effect.logDebug(
+                "Bounded thread snapshot returned an invalid response; trying the full HTTP thread snapshot for an older server.",
+              ).pipe(
+                Effect.annotateLogs({ threadId, cause: error.message }),
+                Effect.andThen(loadFullFallback),
+              ),
+            RemoteEnvironmentAuthUndeclaredStatusError: (error) =>
+              error.status === 404
+                ? Effect.logDebug(
+                    "Bounded thread snapshot route was not found; trying the full HTTP thread snapshot for an older server.",
+                  ).pipe(Effect.annotateLogs({ threadId }), Effect.andThen(loadFullFallback))
+                : Effect.fail(error),
+          }),
+          Effect.catchCause((cause) =>
+            Effect.logWarning(
+              "Could not load the bounded thread snapshot over HTTP; using the socket snapshot instead.",
+            ).pipe(
+              Effect.annotateLogs({ threadId, cause: Cause.pretty(cause) }),
+              Effect.as({ _tag: "unavailable" } satisfies ThreadSnapshotLoadResult),
+            ),
+          ),
+        );
+      },
+    });
+  }),
+);
diff --git a/packages/client-runtime/src/state/entities.test.ts b/packages/client-runtime/src/state/entities.test.ts
index d3bb6680208a..fc6291f767ea 100644
--- a/packages/client-runtime/src/state/entities.test.ts
+++ b/packages/client-runtime/src/state/entities.test.ts
@@ -1,52 +1,29 @@
 import {
   EnvironmentId,
-  ProjectId,
-  ProviderInstanceId,
-  ThreadId,
-  type OrchestrationShellSnapshot,
-  type OrchestrationThread,
+  MessageId,
+  NodeId,
+  ProviderSessionId,
+  RunId,
+  RuntimeRequestId,
+  TurnItemId,
 } from "@t3tools/contracts";
-import { describe, expect, it } from "@effect/vitest";
-import * as Option from "effect/Option";
-import { AsyncResult, Atom, AtomRegistry } from "effect/unstable/reactivity";
+import * as DateTime from "effect/DateTime";
+import { describe, expect, it } from "vite-plus/test";
 
-import { PrimaryConnectionTarget } from "../connection/model.ts";
 import {
-  InvalidScopedProjectKeyError,
   InvalidScopedProjectRefCollectionKeyError,
   InvalidScopedThreadKeyError,
-  parseProjectKey,
   parseProjectRefCollectionKey,
   parseThreadKey,
 } from "./entities.ts";
-import type { EnvironmentShellState } from "./shell.ts";
-import { EMPTY_ENVIRONMENT_THREAD_STATE, type EnvironmentThreadState } from "./threads.ts";
-import { createEnvironmentProjectAtoms } from "./projectEntities.ts";
-import { createEnvironmentSnapshotAtom } from "./snapshots.ts";
-import { createEnvironmentThreadDetailAtoms } from "./threadDetail.ts";
-import { mergeEnvironmentThread } from "./threadDetail.ts";
-import { createEnvironmentThreadShellAtoms } from "./threadShell.ts";
-
-const ENVIRONMENT_ID = EnvironmentId.make("environment-1");
-const PROJECT_ID = ProjectId.make("project-1");
-const OTHER_PROJECT_ID = ProjectId.make("project-2");
-const THREAD_ID = ThreadId.make("thread-1");
-const OTHER_THREAD_ID = ThreadId.make("thread-2");
+import { presentThreadShell } from "./models.ts";
+import { v2Projection, v2ThreadShell } from "./orchestrationV2TestFixtures.ts";
+import { deriveLatestThreadRun, deriveThreadRuntime } from "./threadExecution.ts";
+import { derivePendingThreadRequests } from "./threadRequests.ts";
 
-describe("scoped entity keys", () => {
-  it("preserves an invalid project key as structured error data", () => {
-    const key = "missing-project-key-separator";
-    let error: unknown;
-
-    try {
-      parseProjectKey(key);
-    } catch (cause) {
-      error = cause;
-    }
-
-    expect(error).toEqual(new InvalidScopedProjectKeyError({ key }));
-  });
+const environmentId = EnvironmentId.make("environment-v2");
 
+describe("scoped entity keys", () => {
   it("preserves an invalid thread key as structured error data", () => {
     const key = "missing-thread-key-separator";
     let error: unknown;
@@ -83,290 +60,450 @@ describe("scoped entity keys", () => {
   });
 });
 
-const THREAD_SHELL = {
-  id: THREAD_ID,
-  projectId: PROJECT_ID,
-  title: "Thread",
-  modelSelection: { instanceId: ProviderInstanceId.make("codex"), model: "gpt-5.4" },
-  runtimeMode: "full-access",
-  interactionMode: "default",
-  branch: null,
-  worktreePath: null,
-  latestTurn: null,
-  createdAt: "2026-06-01T00:00:00.000Z",
-  updatedAt: "2026-06-01T00:00:00.000Z",
-  archivedAt: null,
-  settledOverride: null,
-  settledAt: null,
-  session: null,
-  latestUserMessageAt: null,
-  hasPendingApprovals: false,
-  hasPendingUserInput: false,
-  hasActionableProposedPlan: false,
-} as const;
-
-const SNAPSHOT: OrchestrationShellSnapshot = {
-  snapshotSequence: 1,
-  updatedAt: "2026-06-01T00:00:00.000Z",
-  projects: [
-    {
-      id: PROJECT_ID,
-      title: "Project",
-      workspaceRoot: "/repo",
-      repositoryIdentity: null,
-      defaultModelSelection: null,
-      scripts: [],
-      createdAt: "2026-06-01T00:00:00.000Z",
-      updatedAt: "2026-06-01T00:00:00.000Z",
-    },
-    {
-      id: OTHER_PROJECT_ID,
-      title: "Other project",
-      workspaceRoot: "/other-repo",
-      repositoryIdentity: null,
-      defaultModelSelection: null,
-      scripts: [],
-      createdAt: "2026-06-01T00:00:00.000Z",
-      updatedAt: "2026-06-01T00:00:00.000Z",
-    },
-  ],
-  threads: [
-    THREAD_SHELL,
-    {
-      ...THREAD_SHELL,
-      id: OTHER_THREAD_ID,
-      projectId: OTHER_PROJECT_ID,
-      title: "Other thread",
-    },
-  ],
-};
-
-function shellState(snapshot: OrchestrationShellSnapshot): EnvironmentShellState {
-  return {
-    snapshot: Option.some(snapshot),
-    status: "live",
-    error: Option.none(),
-  };
-}
-
-function makeHarness() {
-  const shellStateAtoms = Atom.family((_environmentId: EnvironmentId) =>
-    Atom.make(AsyncResult.success(shellState(SNAPSHOT))),
-  );
-  const threadStateAtoms = Atom.family((_key: string) =>
-    Atom.make(AsyncResult.success(EMPTY_ENVIRONMENT_THREAD_STATE)),
-  );
-  const catalogValueAtom = Atom.make({
-    isReady: true,
-    entries: new Map([
-      [
-        ENVIRONMENT_ID,
-        {
-          target: new PrimaryConnectionTarget({
-            environmentId: ENVIRONMENT_ID,
-            label: "Environment",
-            httpBaseUrl: "https://example.test",
-            wsBaseUrl: "wss://example.test",
-          }),
-          profile: Option.none(),
-        },
-      ],
-    ]),
+describe("V2 client presentation", () => {
+  it("presents shell timestamps and status without constructing V1 state", () => {
+    const shell = presentThreadShell(environmentId, v2ThreadShell);
+    expect(shell.environmentId).toBe(environmentId);
+    expect(shell.createdAt).toBe("2026-06-20T00:00:00.000Z");
+    expect(shell.runtime).toBeNull();
+    expect(shell.source).toBe(v2ThreadShell);
+  });
+
+  it("presents provider errors carried by failed thread shells", () => {
+    const runId = RunId.make("run-failed");
+    const shell = presentThreadShell(environmentId, {
+      ...v2ThreadShell,
+      latestRunId: runId,
+      status: "failed",
+      lastError: "provider process exited",
+    });
+
+    expect(shell.runtime).toMatchObject({
+      status: "failed",
+      lastError: "provider process exited",
+    });
+  });
+
+  it("preserves shell run timestamps for sidebar activity clocks", () => {
+    const runId = RunId.make("run-working-clock");
+    const requestedAt = DateTime.makeUnsafe("2026-06-20T01:00:00.000Z");
+    const startedAt = DateTime.makeUnsafe("2026-06-20T01:00:02.000Z");
+    const shell = presentThreadShell(environmentId, {
+      ...v2ThreadShell,
+      latestRunId: runId,
+      latestRunRequestedAt: requestedAt,
+      latestRunStartedAt: startedAt,
+      latestRunCompletedAt: null,
+      activeRunId: runId,
+      status: "running",
+      updatedAt: DateTime.makeUnsafe("2026-06-20T01:04:45.000Z"),
+    });
+
+    expect(shell.latestRun).toMatchObject({
+      runId,
+      status: "running",
+      requestedAt: "2026-06-20T01:00:00.000Z",
+      startedAt: "2026-06-20T01:00:02.000Z",
+      completedAt: null,
+    });
   });
-  const snapshotAtom = createEnvironmentSnapshotAtom(shellStateAtoms);
-  const projects = createEnvironmentProjectAtoms({
-    catalogValueAtom,
-    snapshotAtom,
+
+  it("parks presented runtime at idle when a settled shell has pending background tasks", () => {
+    const runId = RunId.make("run-completed");
+    const shell = presentThreadShell(environmentId, {
+      ...v2ThreadShell,
+      latestRunId: runId,
+      activeRunId: null,
+      status: "completed",
+      pendingBackgroundTasks: [{ taskId: "bg-1", description: "sleep 20" }],
+    });
+
+    expect(shell.latestRun).toMatchObject({ runId, status: "completed" });
+    expect(shell.runtime).toMatchObject({
+      status: "idle",
+      activeRunId: null,
+    });
+    expect(shell.pendingBackgroundTasks).toEqual([{ taskId: "bg-1", description: "sleep 20" }]);
   });
-  const threadShells = createEnvironmentThreadShellAtoms({
-    catalogValueAtom,
-    snapshotAtom,
+
+  it("keeps terminal runtime completed when there are no pending background tasks", () => {
+    const runId = RunId.make("run-completed");
+    const shell = presentThreadShell(environmentId, {
+      ...v2ThreadShell,
+      latestRunId: runId,
+      activeRunId: null,
+      status: "completed",
+      pendingBackgroundTasks: [],
+    });
+
+    expect(shell.latestRun).toMatchObject({ runId, status: "completed" });
+    expect(shell.runtime).toMatchObject({
+      status: "completed",
+      activeRunId: null,
+    });
   });
-  const threadDetails = createEnvironmentThreadDetailAtoms((environmentId, threadId) =>
-    threadStateAtoms(`${environmentId}\u0000${threadId}`),
-  );
-
-  return {
-    registry: AtomRegistry.make(),
-    shellStateAtom: shellStateAtoms(ENVIRONMENT_ID),
-    threadStateAtom: (threadId: ThreadId) => threadStateAtoms(`${ENVIRONMENT_ID}\u0000${threadId}`),
-    projects,
-    threadShells,
-    threadDetails,
-  };
-}
-
-describe("environment entity projections", () => {
-  it("composes detail collections with authoritative shell workspace metadata", () => {
-    const messages: OrchestrationThread["messages"] = [];
-    const detail = {
-      ...THREAD_SHELL,
-      environmentId: ENVIRONMENT_ID,
-      title: "Cached thread",
-      branch: "stale-branch",
-      worktreePath: "/repo/stale-worktree",
-      deletedAt: null,
-      messages,
-      proposedPlans: [],
-      activities: [],
-      checkpoints: [],
-    } satisfies OrchestrationThread & { readonly environmentId: EnvironmentId };
-    const shell = {
-      ...THREAD_SHELL,
-      environmentId: ENVIRONMENT_ID,
-      title: "Current thread",
-      branch: "current-branch",
-      worktreePath: "/repo/current-worktree",
-    };
 
-    const merged = mergeEnvironmentThread(detail, shell);
+  it("keeps runtime running when there is no background roster", () => {
+    const runId = RunId.make("run-running");
+    const shell = presentThreadShell(environmentId, {
+      ...v2ThreadShell,
+      latestRunId: runId,
+      activeRunId: runId,
+      status: "running",
+      pendingBackgroundTasks: [],
+    });
 
-    expect(merged).toMatchObject({
-      title: "Current thread",
-      branch: "current-branch",
-      worktreePath: "/repo/current-worktree",
+    expect(shell.latestRun).toMatchObject({ runId, status: "running" });
+    expect(shell.runtime).toMatchObject({
+      status: "running",
+      activeRunId: runId,
     });
-    expect(merged?.messages).toBe(messages);
   });
 
-  it("preserves untouched project and thread identities across unrelated shell updates", () => {
-    const harness = makeHarness();
-    const projectRefsAtom = harness.projects.environmentProjectRefsAtom(ENVIRONMENT_ID);
-    const threadRefsAtom = harness.threadShells.environmentThreadRefsAtom(ENVIRONMENT_ID);
-    const projectsAtom = harness.projects.projectsAtom;
-    const projectAtom = harness.projects.projectAtom({
-      environmentId: ENVIRONMENT_ID,
-      projectId: PROJECT_ID,
+  it("keeps an older active run visible over a newer cancelled run", () => {
+    const activeRunId = RunId.make("run-active");
+    const cancelledRunId = RunId.make("run-cancelled");
+    const shell = presentThreadShell(environmentId, {
+      ...v2ThreadShell,
+      latestRunId: cancelledRunId,
+      latestRunStartedAt: null,
+      latestRunCompletedAt: DateTime.makeUnsafe("2026-06-20T01:05:00.000Z"),
+      activeRunId,
+      activityRunStatus: "running",
+      status: "cancelled",
+      pendingBackgroundTasks: [],
     });
-    const threadAtom = harness.threadShells.threadShellAtom({
-      environmentId: ENVIRONMENT_ID,
-      threadId: THREAD_ID,
+
+    expect(shell.latestRun).toMatchObject({ runId: cancelledRunId, status: "cancelled" });
+    expect(shell.runtime).toMatchObject({
+      status: "running",
+      activeRunId,
+    });
+  });
+
+  it("keeps an older waiting run visible over a newer cancelled run", () => {
+    const shell = presentThreadShell(environmentId, {
+      ...v2ThreadShell,
+      latestRunId: RunId.make("run-cancelled"),
+      activeRunId: null,
+      activityRunStatus: "waiting",
+      status: "cancelled",
+      pendingBackgroundTasks: [],
+    });
+
+    expect(shell.runtime).toMatchObject({ status: "waiting", activeRunId: null });
+  });
+
+  it("keeps a post-settlement background roster ahead of activity status", () => {
+    const activeRunId = RunId.make("run-active");
+    const shell = presentThreadShell(environmentId, {
+      ...v2ThreadShell,
+      latestRunId: RunId.make("run-cancelled"),
+      activeRunId,
+      activityRunStatus: "running",
+      status: "cancelled",
+      pendingBackgroundTasks: [{ taskId: "bg-activity", description: "background work" }],
     });
-    const projectRefs = harness.registry.get(projectRefsAtom);
-    const threadRefs = harness.registry.get(threadRefsAtom);
-    const projects = harness.registry.get(projectsAtom);
-    const project = harness.registry.get(projectAtom);
-    const thread = harness.registry.get(threadAtom);
-
-    harness.registry.set(
-      harness.shellStateAtom,
-      AsyncResult.success(
-        shellState({
-          ...SNAPSHOT,
-          snapshotSequence: 2,
-          threads: SNAPSHOT.threads.map((candidate) =>
-            candidate.id === OTHER_THREAD_ID
-              ? { ...candidate, title: "Renamed other thread" }
-              : candidate,
-          ),
-        }),
-      ),
-    );
 
-    expect(harness.registry.get(projectRefsAtom)).toBe(projectRefs);
-    expect(harness.registry.get(threadRefsAtom)).toBe(threadRefs);
-    expect(harness.registry.get(projectsAtom)).toBe(projects);
-    expect(harness.registry.get(projectAtom)).toBe(project);
-    expect(harness.registry.get(threadAtom)).toBe(thread);
+    expect(shell.runtime).toMatchObject({ status: "idle", activeRunId });
   });
 
-  it("preserves project-scoped thread collections across unrelated project updates", () => {
-    const harness = makeHarness();
-    const projectRef = {
-      environmentId: ENVIRONMENT_ID,
-      projectId: PROJECT_ID,
+  it("parks runtime idle over stale shell running when the roster is nonempty", () => {
+    const runId = RunId.make("run-stale-running");
+    const shell = presentThreadShell(environmentId, {
+      ...v2ThreadShell,
+      latestRunId: runId,
+      activeRunId: runId,
+      // Stale: server already projected a post-settlement roster, but shell
+      // status still says running (packaged orchestrator-v2 bug).
+      status: "running",
+      pendingBackgroundTasks: [{ taskId: "bg-1", description: "sleep 20" }],
+    });
+
+    expect(shell.latestRun).toMatchObject({ runId, status: "running" });
+    expect(shell.runtime).toMatchObject({
+      status: "idle",
+      activeRunId: runId,
+    });
+    expect(shell.pendingBackgroundTasks).toEqual([{ taskId: "bg-1", description: "sleep 20" }]);
+  });
+
+  it("parks runtime idle over stale checkpoint waiting when the roster is nonempty", () => {
+    const runId = RunId.make("run-stale-waiting");
+    const shell = presentThreadShell(environmentId, {
+      ...v2ThreadShell,
+      latestRunId: runId,
+      activeRunId: runId,
+      // Stale: checkpoint-oriented waiting masks post-settlement background work.
+      status: "waiting",
+      pendingBackgroundTasks: [{ taskId: "bg-2", description: "background bash" }],
+    });
+
+    expect(shell.latestRun).toMatchObject({ runId, status: "waiting" });
+    expect(shell.runtime).toMatchObject({
+      status: "idle",
+      activeRunId: runId,
+    });
+    expect(shell.pendingBackgroundTasks).toEqual([
+      { taskId: "bg-2", description: "background bash" },
+    ]);
+  });
+
+  it("derives execution summaries without wrapping or copying the projection", () => {
+    const runId = RunId.make("run-1");
+    const now = DateTime.makeUnsafe("2026-06-20T01:00:00.000Z");
+    const projection = {
+      ...v2Projection,
+      runs: [
+        {
+          id: runId,
+          threadId: v2Projection.thread.id,
+          ordinal: 1,
+          providerInstanceId: v2Projection.thread.providerInstanceId,
+          modelSelection: v2Projection.thread.modelSelection,
+          providerThreadId: null,
+          userMessageId: MessageId.make("message-user"),
+          rootNodeId: null,
+          activeAttemptId: null,
+          status: "running" as const,
+          requestedAt: now,
+          startedAt: now,
+          completedAt: null,
+          checkpointId: null,
+          contextHandoffId: null,
+        },
+      ],
+      messages: [
+        {
+          id: MessageId.make("message-user"),
+          threadId: v2Projection.thread.id,
+          runId,
+          nodeId: null,
+          role: "user" as const,
+          text: "Hello",
+          attachments: [],
+          streaming: false,
+          createdBy: "user" as const,
+          creationSource: "web" as const,
+          createdAt: now,
+          updatedAt: now,
+        },
+      ],
+      updatedAt: now,
     };
-    const refsByProjectAtom =
-      harness.threadShells.environmentThreadRefsByProjectAtom(ENVIRONMENT_ID);
-    const threadsAtom = harness.threadShells.threadShellsForProjectRefsAtom([projectRef]);
-    const refs = harness.registry.get(refsByProjectAtom).get(PROJECT_ID);
-    const threads = harness.registry.get(threadsAtom);
-
-    expect(threads).toHaveLength(1);
-    expect(threads[0]?.id).toBe(THREAD_ID);
-
-    harness.registry.set(
-      harness.shellStateAtom,
-      AsyncResult.success(
-        shellState({
-          ...SNAPSHOT,
-          snapshotSequence: 2,
-          threads: SNAPSHOT.threads.map((thread) =>
-            thread.id === OTHER_THREAD_ID ? { ...thread, title: "Updated elsewhere" } : thread,
-          ),
-        }),
-      ),
-    );
 
-    expect(harness.registry.get(refsByProjectAtom).get(PROJECT_ID)).toBe(refs);
-    expect(harness.registry.get(threadsAtom)).toBe(threads);
+    expect(deriveLatestThreadRun(projection)).toMatchObject({
+      runId,
+      status: "running",
+      requestedAt: "2026-06-20T01:00:00.000Z",
+      assistantMessageId: null,
+    });
+    expect(deriveThreadRuntime(projection)).toMatchObject({
+      status: "running",
+      activeRunId: runId,
+      providerInstanceId: projection.thread.providerInstanceId,
+    });
   });
 
-  it("updates only the requested thread detail and preserves untouched field identities", () => {
-    const harness = makeHarness();
-    const threadRef = {
-      environmentId: ENVIRONMENT_ID,
-      threadId: THREAD_ID,
+  it("parks waiting runtime for a post-settlement roster without hiding active running work", () => {
+    const runId = RunId.make("run-background-presentation");
+    const now = DateTime.makeUnsafe("2026-06-20T01:00:00.000Z");
+    const run = {
+      id: runId,
+      threadId: v2Projection.thread.id,
+      ordinal: 1,
+      providerInstanceId: v2Projection.thread.providerInstanceId,
+      modelSelection: v2Projection.thread.modelSelection,
+      providerThreadId: null,
+      userMessageId: MessageId.make("message-background-presentation"),
+      rootNodeId: null,
+      activeAttemptId: null,
+      status: "waiting" as const,
+      requestedAt: now,
+      startedAt: now,
+      completedAt: null,
+      checkpointId: null,
+      contextHandoffId: null,
     };
-    const otherThreadRef = {
-      environmentId: ENVIRONMENT_ID,
-      threadId: OTHER_THREAD_ID,
+    const backgroundItem = {
+      id: TurnItemId.make("item-background-command"),
+      threadId: v2Projection.thread.id,
+      runId,
+      nodeId: null,
+      providerThreadId: null,
+      providerTurnId: null,
+      nativeItemRef: null,
+      parentItemId: null,
+      ordinal: 0,
+      status: "running" as const,
+      title: "Background command",
+      startedAt: now,
+      completedAt: null,
+      updatedAt: now,
+      type: "command_execution" as const,
+      input: "sleep 20",
     };
-    const threadDetailAtom = harness.threadDetails.detailAtom(threadRef);
-    const messagesAtom = harness.threadDetails.messagesAtom(threadRef);
-    const activitiesAtom = harness.threadDetails.activitiesAtom(threadRef);
-    const statusAtom = harness.threadDetails.statusAtom(threadRef);
-    const otherThreadDetailAtom = harness.threadDetails.detailAtom(otherThreadRef);
-    const otherValue = harness.registry.get(otherThreadDetailAtom);
-    const detail = {
-      ...THREAD_SHELL,
-      deletedAt: null,
-      messages: [],
-      proposedPlans: [],
-      activities: [],
-      checkpoints: [],
-    } satisfies OrchestrationThread;
-
-    harness.registry.set(
-      harness.threadStateAtom(THREAD_ID),
-      AsyncResult.success<EnvironmentThreadState>({
-        data: Option.some(detail),
-        status: "live",
-        error: Option.none(),
-        page: Option.none(),
+
+    expect(
+      deriveThreadRuntime({
+        ...v2Projection,
+        runs: [run],
+        turnItems: [backgroundItem],
       }),
-    );
+    ).toMatchObject({
+      status: "idle",
+      activeRunId: null,
+    });
+    expect(
+      deriveThreadRuntime({
+        ...v2Projection,
+        runs: [{ ...run, status: "running" as const }],
+        turnItems: [backgroundItem],
+      }),
+    ).toMatchObject({
+      status: "running",
+      activeRunId: runId,
+    });
+  });
 
-    const scopedDetail = harness.registry.get(threadDetailAtom);
-    const messages = harness.registry.get(messagesAtom);
-    const activities = harness.registry.get(activitiesAtom);
-
-    expect(scopedDetail).toEqual({ ...detail, environmentId: ENVIRONMENT_ID });
-    expect(harness.registry.get(statusAtom)).toBe("live");
-    expect(harness.registry.get(otherThreadDetailAtom)).toBe(otherValue);
-
-    harness.registry.set(
-      harness.threadStateAtom(THREAD_ID),
-      AsyncResult.success<EnvironmentThreadState>({
-        data: Option.some({
-          ...detail,
-          session: {
-            threadId: THREAD_ID,
-            status: "ready",
-            providerName: "codex",
-            runtimeMode: "full-access",
-            activeTurnId: null,
-            lastError: null,
-            updatedAt: "2026-06-01T00:01:00.000Z",
+  it("joins pending request entities to their native turn-item display data", () => {
+    const now = DateTime.makeUnsafe("2026-06-20T01:00:00.000Z");
+    const requestId = RuntimeRequestId.make("request-approval");
+    const item = {
+      id: TurnItemId.make("item-approval"),
+      threadId: v2Projection.thread.id,
+      runId: null,
+      nodeId: NodeId.make("node-root"),
+      providerThreadId: null,
+      providerTurnId: null,
+      nativeItemRef: null,
+      parentItemId: null,
+      ordinal: 0,
+      status: "completed" as const,
+      title: null,
+      startedAt: now,
+      completedAt: now,
+      updatedAt: now,
+      type: "approval_request" as const,
+      requestId,
+      requestKind: "command" as const,
+      prompt: "Allow command?",
+    };
+    const projection = {
+      ...v2Projection,
+      runtimeRequests: [
+        {
+          id: requestId,
+          nodeId: NodeId.make("node-root"),
+          providerTurnId: null,
+          nativeRequestRef: null,
+          kind: "command" as const,
+          status: "pending" as const,
+          responseCapability: {
+            type: "not_resumable" as const,
+            reason: "provider disconnected",
           },
-        }),
-        status: "live",
-        error: Option.none(),
-        page: Option.none(),
-      }),
-    );
+          createdAt: now,
+          resolvedAt: null,
+        },
+      ],
+      turnItems: [item],
+      updatedAt: now,
+    };
+
+    expect(derivePendingThreadRequests(projection).approvals).toEqual([
+      {
+        requestId,
+        requestKind: "command",
+        createdAt: "2026-06-20T01:00:00.000Z",
+        detail: "Allow command?",
+        responseCapability: "not_resumable",
+      },
+    ]);
+    expect(derivePendingThreadRequests(projection).userInputs).toEqual([]);
+  });
+
+  it("preserves structured-question selection mode and defaults legacy payloads", () => {
+    const now = DateTime.makeUnsafe("2026-06-20T01:00:00.000Z");
+    const multiRequestId = RuntimeRequestId.make("request-multi-select");
+    const legacyRequestId = RuntimeRequestId.make("request-legacy-single-select");
+    const runtimeRequests = [multiRequestId, legacyRequestId].map((id) => ({
+      id,
+      nodeId: NodeId.make(`node-${id}`),
+      providerTurnId: null,
+      nativeRequestRef: null,
+      kind: "user_input" as const,
+      status: "pending" as const,
+      responseCapability: {
+        type: "live" as const,
+        providerSessionId: ProviderSessionId.make("provider-session-questions"),
+      },
+      createdAt: now,
+      resolvedAt: null,
+    }));
+    const common = {
+      threadId: v2Projection.thread.id,
+      runId: null,
+      providerThreadId: null,
+      providerTurnId: null,
+      nativeItemRef: null,
+      parentItemId: null,
+      ordinal: 0,
+      status: "completed" as const,
+      title: null,
+      startedAt: now,
+      completedAt: now,
+      updatedAt: now,
+      type: "user_input_request" as const,
+    };
+    const projection = {
+      ...v2Projection,
+      runtimeRequests,
+      turnItems: [
+        {
+          ...common,
+          id: TurnItemId.make("item-multi-select"),
+          nodeId: NodeId.make("node-request-multi-select"),
+          requestId: multiRequestId,
+          questions: [
+            {
+              id: "regions",
+              header: "Regions",
+              question: "Which regions?",
+              options: [
+                { label: "US", description: "United States" },
+                { label: "EU", description: "European Union" },
+              ],
+              multiSelect: true,
+            },
+          ],
+        },
+        {
+          ...common,
+          id: TurnItemId.make("item-legacy-single-select"),
+          nodeId: NodeId.make("node-request-legacy-single-select"),
+          requestId: legacyRequestId,
+          questions: [
+            {
+              id: "target",
+              header: "Target",
+              question: "Which target?",
+              options: [{ label: "Staging", description: "Staging environment" }],
+            },
+          ],
+        },
+      ],
+      updatedAt: now,
+    };
 
-    expect(harness.registry.get(messagesAtom)).toBe(messages);
-    expect(harness.registry.get(activitiesAtom)).toBe(activities);
+    expect(
+      derivePendingThreadRequests(projection).userInputs.map((input) => ({
+        requestId: input.requestId,
+        multiSelect: input.questions[0]?.multiSelect,
+      })),
+    ).toEqual([
+      { requestId: multiRequestId, multiSelect: true },
+      { requestId: legacyRequestId, multiSelect: false },
+    ]);
   });
 });
diff --git a/packages/client-runtime/src/state/environmentHttpAuth.test.ts b/packages/client-runtime/src/state/environmentHttpAuth.test.ts
new file mode 100644
index 000000000000..ca7ad6ddb8e0
--- /dev/null
+++ b/packages/client-runtime/src/state/environmentHttpAuth.test.ts
@@ -0,0 +1,22 @@
+import {
+  ORCHESTRATION_PROTOCOL_HEADER,
+  ORCHESTRATION_PROTOCOL_VERSION_TEXT,
+} from "@t3tools/contracts";
+import { describe, expect, it } from "vite-plus/test";
+
+import { withOrchestrationProtocolHeader } from "./environmentHttpAuth.ts";
+
+describe("orchestration HTTP compatibility header", () => {
+  it("announces the current protocol without replacing bearer or DPoP authentication", () => {
+    expect(
+      withOrchestrationProtocolHeader({
+        authorization: "DPoP access-token",
+        dpop: "signed-proof",
+      }),
+    ).toEqual({
+      authorization: "DPoP access-token",
+      dpop: "signed-proof",
+      [ORCHESTRATION_PROTOCOL_HEADER]: ORCHESTRATION_PROTOCOL_VERSION_TEXT,
+    });
+  });
+});
diff --git a/packages/client-runtime/src/state/environmentHttpAuth.ts b/packages/client-runtime/src/state/environmentHttpAuth.ts
index 097708066200..b51742949682 100644
--- a/packages/client-runtime/src/state/environmentHttpAuth.ts
+++ b/packages/client-runtime/src/state/environmentHttpAuth.ts
@@ -1,5 +1,9 @@
 import * as Effect from "effect/Effect";
 import * as Option from "effect/Option";
+import {
+  ORCHESTRATION_PROTOCOL_HEADER,
+  ORCHESTRATION_PROTOCOL_VERSION_TEXT,
+} from "@t3tools/contracts";
 import { FetchHttpClient, type HttpMethod } from "effect/unstable/http";
 
 import type { PreparedHttpAuthorization } from "../connection/model.ts";
@@ -11,6 +15,17 @@ export interface EnvironmentHttpAuthHeaders {
   readonly dpop?: string;
 }
 
+export function withOrchestrationProtocolHeader(
+  headers: EnvironmentHttpAuthHeaders,
+): EnvironmentHttpAuthHeaders & {
+  readonly [ORCHESTRATION_PROTOCOL_HEADER]: typeof ORCHESTRATION_PROTOCOL_VERSION_TEXT;
+} {
+  return {
+    ...headers,
+    [ORCHESTRATION_PROTOCOL_HEADER]: ORCHESTRATION_PROTOCOL_VERSION_TEXT,
+  };
+}
+
 /**
  * Primary/local environments with no bearer or DPoP credential authenticate the
  * browser via a session cookie. A cross-origin `fetch` does not send cookies by
diff --git a/packages/client-runtime/src/state/itemSupport.test.ts b/packages/client-runtime/src/state/itemSupport.test.ts
new file mode 100644
index 000000000000..552230746ec0
--- /dev/null
+++ b/packages/client-runtime/src/state/itemSupport.test.ts
@@ -0,0 +1,205 @@
+import {
+  NodeId,
+  ProviderDriverKind,
+  ProviderInstanceId,
+  ProviderSessionId,
+  ProviderThreadId,
+  ProviderTurnId,
+  RunAttemptId,
+  RunId,
+  RuntimeRequestId,
+  TurnItemId,
+  type OrchestrationV2TurnItem,
+} from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+import { describe, expect, it } from "vite-plus/test";
+
+import { v2Projection, v2ThreadId } from "./orchestrationV2TestFixtures.ts";
+import { EMPTY_V2_ITEM_SUPPORT, resolveV2ItemSupport, v2ItemSupportEqual } from "./itemSupport.ts";
+
+const now = DateTime.makeUnsafe("2026-06-20T00:00:00.000Z");
+const runId = RunId.make("run-1");
+const nodeId = NodeId.make("node-1");
+const itemId = TurnItemId.make("item-1");
+const requestId = RuntimeRequestId.make("request-1");
+const providerInstanceId = ProviderInstanceId.make("codex");
+const providerThreadId = ProviderThreadId.make("provider-thread-1");
+const providerTurnId = ProviderTurnId.make("provider-turn-1");
+
+const commandItem: OrchestrationV2TurnItem = {
+  id: itemId,
+  threadId: v2ThreadId,
+  runId,
+  nodeId,
+  providerThreadId,
+  providerTurnId,
+  nativeItemRef: null,
+  parentItemId: null,
+  ordinal: 0,
+  status: "running",
+  title: null,
+  startedAt: now,
+  completedAt: null,
+  updatedAt: now,
+  type: "command_execution",
+  input: "vp check",
+};
+
+describe("resolveV2ItemSupport", () => {
+  it("retains identity while linking a turn item to its execution and provider entities", () => {
+    const run = {
+      id: runId,
+      threadId: v2ThreadId,
+      ordinal: 1,
+      providerInstanceId,
+      modelSelection: { instanceId: providerInstanceId, model: "gpt-5.4" },
+      providerThreadId,
+      userMessageId: "message-1" as never,
+      rootNodeId: nodeId,
+      activeAttemptId: RunAttemptId.make("attempt-2"),
+      status: "running" as const,
+      requestedAt: now,
+      startedAt: now,
+      completedAt: null,
+      checkpointId: null,
+      contextHandoffId: null,
+    };
+    const attempts = [
+      {
+        id: RunAttemptId.make("attempt-1"),
+        runId,
+        attemptOrdinal: 1,
+        rootNodeId: nodeId,
+        providerInstanceId,
+        providerThreadId,
+        providerTurnId,
+        reason: "initial" as const,
+        status: "superseded" as const,
+        startedAt: now,
+        completedAt: now,
+      },
+      {
+        id: RunAttemptId.make("attempt-2"),
+        runId,
+        attemptOrdinal: 2,
+        rootNodeId: nodeId,
+        providerInstanceId,
+        providerThreadId,
+        providerTurnId,
+        reason: "steering_restart" as const,
+        status: "running" as const,
+        startedAt: now,
+        completedAt: null,
+      },
+    ];
+    const node = {
+      id: nodeId,
+      threadId: v2ThreadId,
+      runId,
+      parentNodeId: null,
+      rootNodeId: nodeId,
+      kind: "tool_call" as const,
+      status: "running" as const,
+      countsForRun: true,
+      providerThreadId,
+      providerTurnId,
+      nativeItemRef: null,
+      runtimeRequestId: requestId,
+      checkpointScopeId: null,
+      startedAt: now,
+      completedAt: null,
+    };
+    const providerThread = {
+      id: providerThreadId,
+      driver: ProviderDriverKind.make("codex"),
+      providerInstanceId,
+      providerSessionId: null,
+      appThreadId: v2ThreadId,
+      ownerNodeId: nodeId,
+      nativeThreadRef: null,
+      nativeConversationHeadRef: null,
+      status: "active" as const,
+      firstRunOrdinal: 1,
+      lastRunOrdinal: 1,
+      handoffIds: [],
+      forkedFrom: null,
+      createdAt: now,
+      updatedAt: now,
+    };
+    const providerTurn = {
+      id: providerTurnId,
+      providerThreadId,
+      nodeId,
+      runAttemptId: attempts[1]!.id,
+      nativeTurnRef: null,
+      ordinal: 1,
+      status: "running" as const,
+      startedAt: now,
+      completedAt: null,
+    };
+    const runtimeRequest = {
+      id: requestId,
+      nodeId,
+      providerTurnId,
+      nativeRequestRef: null,
+      kind: "dynamic_tool_call" as const,
+      status: "pending" as const,
+      responseCapability: {
+        type: "live" as const,
+        providerSessionId: ProviderSessionId.make("session-1"),
+      },
+      createdAt: now,
+      resolvedAt: null,
+    };
+    const projection = {
+      ...v2Projection,
+      runs: [run],
+      attempts,
+      nodes: [node],
+      providerThreads: [providerThread],
+      providerTurns: [providerTurn],
+      runtimeRequests: [runtimeRequest],
+      turnItems: [commandItem],
+    };
+
+    const support = resolveV2ItemSupport(projection, itemId);
+    expect(support.item).toBe(commandItem);
+    expect(support.run).toBe(run);
+    expect(support.attempts).toEqual(attempts);
+    expect(support.attempts[0]).toBe(attempts[0]);
+    expect(support.node).toBe(node);
+    expect(support.providerThread).toBe(providerThread);
+    expect(support.providerTurn).toBe(providerTurn);
+    expect(support.runtimeRequest).toBe(runtimeRequest);
+  });
+
+  it("resolves synthetic items from the authoritative visible sequence", () => {
+    const projection = {
+      ...v2Projection,
+      visibleTurnItems: [
+        {
+          position: 0,
+          visibility: "synthetic" as const,
+          sourceThreadId: v2ThreadId,
+          sourceItemId: itemId,
+          item: commandItem,
+        },
+      ],
+    };
+    expect(resolveV2ItemSupport(projection, itemId).item).toBe(commandItem);
+  });
+
+  it("returns the stable empty support for unknown items", () => {
+    expect(resolveV2ItemSupport(v2Projection, itemId)).toBe(EMPTY_V2_ITEM_SUPPORT);
+  });
+
+  it("compares support structurally while retaining entity identity semantics", () => {
+    expect(v2ItemSupportEqual(EMPTY_V2_ITEM_SUPPORT, { ...EMPTY_V2_ITEM_SUPPORT })).toBe(true);
+    expect(
+      v2ItemSupportEqual(EMPTY_V2_ITEM_SUPPORT, {
+        ...EMPTY_V2_ITEM_SUPPORT,
+        attempts: [{ id: "attempt" } as never],
+      }),
+    ).toBe(false);
+  });
+});
diff --git a/packages/client-runtime/src/state/itemSupport.ts b/packages/client-runtime/src/state/itemSupport.ts
new file mode 100644
index 000000000000..936ac4d9c4e0
--- /dev/null
+++ b/packages/client-runtime/src/state/itemSupport.ts
@@ -0,0 +1,138 @@
+import type { OrchestrationV2ThreadProjection, TurnItemId } from "@t3tools/contracts";
+
+type Projection = OrchestrationV2ThreadProjection;
+
+export interface V2ItemSupport {
+  readonly item: Projection["turnItems"][number] | null;
+  readonly run: Projection["runs"][number] | null;
+  readonly attempts: ReadonlyArray<Projection["attempts"][number]>;
+  readonly node: Projection["nodes"][number] | null;
+  readonly providerSession: Projection["providerSessions"][number] | null;
+  readonly providerThread: Projection["providerThreads"][number] | null;
+  readonly providerTurn: Projection["providerTurns"][number] | null;
+  readonly runtimeRequest: Projection["runtimeRequests"][number] | null;
+  readonly checkpoint: Projection["checkpoints"][number] | null;
+  readonly subagent: Projection["subagents"][number] | null;
+  readonly contextHandoff: Projection["contextHandoffs"][number] | null;
+  readonly contextTransfer: Projection["contextTransfers"][number] | null;
+}
+
+export const EMPTY_V2_ITEM_SUPPORT: V2ItemSupport = Object.freeze({
+  item: null,
+  run: null,
+  attempts: Object.freeze([]),
+  node: null,
+  providerSession: null,
+  providerThread: null,
+  providerTurn: null,
+  runtimeRequest: null,
+  checkpoint: null,
+  subagent: null,
+  contextHandoff: null,
+  contextTransfer: null,
+});
+
+/**
+ * Resolves the relational V2 entities that enrich one projected item. The
+ * caller supplies the item's source-thread projection, including for inherited
+ * rows, so every returned entity retains its original projection identity.
+ */
+export function resolveV2ItemSupport(projection: Projection, itemId: TurnItemId): V2ItemSupport {
+  const item =
+    projection.turnItems.find((candidate) => candidate.id === itemId) ??
+    projection.visibleTurnItems.find((candidate) => candidate.sourceItemId === itemId)?.item ??
+    null;
+  if (item === null) return EMPTY_V2_ITEM_SUPPORT;
+
+  const run =
+    item.runId === null
+      ? null
+      : (projection.runs.find((candidate) => candidate.id === item.runId) ?? null);
+  const attempts =
+    item.runId === null
+      ? EMPTY_V2_ITEM_SUPPORT.attempts
+      : projection.attempts.filter((candidate) => candidate.runId === item.runId);
+  const node =
+    item.nodeId === null
+      ? null
+      : (projection.nodes.find((candidate) => candidate.id === item.nodeId) ?? null);
+  const providerThread =
+    item.providerThreadId === null || item.providerThreadId === undefined
+      ? null
+      : (projection.providerThreads.find((candidate) => candidate.id === item.providerThreadId) ??
+        null);
+  const providerSession =
+    providerThread?.providerSessionId == null
+      ? null
+      : (projection.providerSessions.find(
+          (candidate) => candidate.id === providerThread.providerSessionId,
+        ) ?? null);
+  const providerTurn =
+    item.providerTurnId === null
+      ? null
+      : (projection.providerTurns.find((candidate) => candidate.id === item.providerTurnId) ??
+        null);
+  const requestId =
+    item.type === "approval_request" || item.type === "user_input_request"
+      ? item.requestId
+      : node?.runtimeRequestId;
+  const runtimeRequest =
+    requestId == null
+      ? null
+      : (projection.runtimeRequests.find((candidate) => candidate.id === requestId) ?? null);
+  const checkpoint =
+    item.type === "checkpoint"
+      ? (projection.checkpoints.find((candidate) => candidate.id === item.checkpointId) ?? null)
+      : null;
+  const subagent =
+    item.type === "subagent"
+      ? (projection.subagents.find((candidate) => candidate.id === item.subagentId) ?? null)
+      : null;
+  const contextHandoff =
+    item.type === "handoff"
+      ? (projection.contextHandoffs.find((candidate) => candidate.id === item.contextHandoffId) ??
+        null)
+      : null;
+  const contextTransfer =
+    contextHandoff?.transferId == null
+      ? null
+      : (projection.contextTransfers.find(
+          (candidate) => candidate.id === contextHandoff.transferId,
+        ) ?? null);
+
+  return {
+    item,
+    run,
+    attempts,
+    node,
+    providerSession,
+    providerThread,
+    providerTurn,
+    runtimeRequest,
+    checkpoint,
+    subagent,
+    contextHandoff,
+    contextTransfer,
+  };
+}
+
+function sameEntities<A>(left: ReadonlyArray<A>, right: ReadonlyArray<A>): boolean {
+  return left.length === right.length && left.every((value, index) => value === right[index]);
+}
+
+export function v2ItemSupportEqual(left: V2ItemSupport, right: V2ItemSupport): boolean {
+  return (
+    left.item === right.item &&
+    left.run === right.run &&
+    sameEntities(left.attempts, right.attempts) &&
+    left.node === right.node &&
+    left.providerSession === right.providerSession &&
+    left.providerThread === right.providerThread &&
+    left.providerTurn === right.providerTurn &&
+    left.runtimeRequest === right.runtimeRequest &&
+    left.checkpoint === right.checkpoint &&
+    left.subagent === right.subagent &&
+    left.contextHandoff === right.contextHandoff &&
+    left.contextTransfer === right.contextTransfer
+  );
+}
diff --git a/packages/client-runtime/src/state/models.ts b/packages/client-runtime/src/state/models.ts
index b601b59bfad0..94e082c9869c 100644
--- a/packages/client-runtime/src/state/models.ts
+++ b/packages/client-runtime/src/state/models.ts
@@ -1,25 +1,160 @@
 import type {
+  ThreadLinkedPullRequest,
   EnvironmentId,
-  OrchestrationMessage,
+  MessageId,
   OrchestrationProjectShell,
-  OrchestrationShellSnapshot,
-  OrchestrationThread,
-  OrchestrationThreadShell,
+  OrchestrationV2RunStatus,
+  OrchestrationV2ShellSnapshot,
+  OrchestrationV2ThreadProjection,
+  OrchestrationV2ThreadShell,
+  PlanId,
+  ProjectId,
+  ProviderInstanceId,
+  RunId,
   ThreadId,
 } from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
 
 export interface EnvironmentProject extends OrchestrationProjectShell {
   readonly environmentId: EnvironmentId;
 }
 
-export interface EnvironmentThreadShell extends OrchestrationThreadShell {
+/**
+ * A pristine V2 thread projection paired with the environment that produced it.
+ *
+ * The projection stays nested so the server projection and all structurally
+ * shared collections retain their identities. Rich consumers read V2 state
+ * directly instead of a second presentation-shaped thread graph.
+ */
+export interface EnvironmentThread {
   readonly environmentId: EnvironmentId;
+  readonly projection: OrchestrationV2ThreadProjection;
 }
 
-export type EnvironmentMessage = OrchestrationMessage;
+export interface ThreadRunSummary {
+  readonly runId: RunId;
+  readonly status: OrchestrationV2RunStatus;
+  readonly requestedAt: string | null;
+  readonly startedAt: string | null;
+  readonly completedAt: string | null;
+  readonly assistantMessageId: MessageId | null;
+  readonly sourcePlanRef?: {
+    readonly threadId: ThreadId;
+    readonly planId: PlanId;
+  };
+}
+
+export interface ThreadRuntimeSummary {
+  readonly status: OrchestrationV2RunStatus | "idle";
+  readonly activeRunId: RunId | null;
+  readonly providerInstanceId: ProviderInstanceId;
+  readonly providerName: string | null;
+  readonly lastError: string | null;
+  readonly updatedAt: string;
+}
+
+export function threadRuntimeIsActive(runtime: ThreadRuntimeSummary | null | undefined): boolean {
+  return runtime !== null && runtime !== undefined && threadRunStatusIsActive(runtime.status);
+}
 
-export interface EnvironmentThread extends OrchestrationThread {
+export function threadRunStatusIsActive(status: ThreadRuntimeSummary["status"]): boolean {
+  return (
+    status === "preparing" ||
+    status === "queued" ||
+    status === "starting" ||
+    status === "running" ||
+    status === "waiting"
+  );
+}
+
+export interface EnvironmentThreadShell {
   readonly environmentId: EnvironmentId;
+  readonly id: ThreadId;
+  readonly projectId: ProjectId;
+  readonly title: string;
+  readonly providerInstanceId: ProviderInstanceId;
+  readonly modelSelection: OrchestrationV2ThreadShell["modelSelection"];
+  readonly runtimeMode: OrchestrationV2ThreadShell["runtimeMode"];
+  readonly interactionMode: OrchestrationV2ThreadShell["interactionMode"];
+  readonly branch: string | null;
+  readonly worktreePath: string | null;
+  readonly lineage: OrchestrationV2ThreadShell["lineage"];
+  readonly forkedFrom: OrchestrationV2ThreadShell["forkedFrom"];
+  readonly activeProviderThreadId: OrchestrationV2ThreadShell["activeProviderThreadId"];
+  readonly latestRun: ThreadRunSummary | null;
+  readonly runtime: ThreadRuntimeSummary | null;
+  readonly latestUserMessageAt: string | null;
+  readonly hasPendingApprovals: boolean;
+  readonly hasPendingUserInput: boolean;
+  readonly hasActionableProposedPlan: boolean;
+  readonly pendingBackgroundTasks: ReadonlyArray<
+    NonNullable<OrchestrationV2ThreadShell["pendingBackgroundTasks"]>[number]
+  >;
+  readonly itemCount: number;
+  readonly visibleItemCount: number;
+  readonly createdAt: string;
+  readonly updatedAt: string;
+  readonly archivedAt: string | null;
+  readonly settledOverride: "settled" | "active" | null;
+  readonly settledAt: string | null;
+  readonly snoozedUntil: string | null;
+  readonly snoozedAt: string | null;
+  readonly pinnedAt: string | null;
+  /** Slot in the user-arranged pinned order; null for keyless (legacy) pins. */
+  readonly pinOrderKey: string | null;
+  /**
+   * Pull request the user linked to the thread (#8160). The v2 server does not
+   * project this yet, so it stays undefined on v2 environments; UI treats
+   * undefined and null alike.
+   */
+  readonly linkedPullRequest?: ThreadLinkedPullRequest | null;
+  /**
+   * Server-tracked visited watermark. `undefined` means the environment's
+   * server predates visited tracking and clients should fall back to any
+   * local visited state they keep.
+   */
+  readonly lastVisitedAt?: string | null;
+  /** Pending title regeneration marker; null when no request is in flight. */
+  readonly titleRegeneration?: { readonly requestId: string; readonly startedAt: string } | null;
+  readonly deletedAt: string | null;
+  readonly source: OrchestrationV2ThreadShell;
+}
+
+function iso(value: DateTime.Utc): string {
+  return DateTime.formatIso(value);
+}
+
+function nullableIso(value: DateTime.Utc | null): string | null {
+  return value === null ? null : iso(value);
+}
+
+function terminalRunStatus(status: OrchestrationV2RunStatus): boolean {
+  return (
+    status === "completed" ||
+    status === "interrupted" ||
+    status === "failed" ||
+    status === "cancelled" ||
+    status === "rolled_back"
+  );
+}
+
+// Park runtime at idle when the post-settlement background roster is nonempty
+// so #4415 waiting-presentation Waiting (session.idle) can consume CTM runtime.
+// The server suppresses the roster while an interruptible activity run exists,
+// so a remaining roster is stronger than checkpoint-oriented waiting.
+// latestRun keeps the latest run's status for history presentation.
+function shellRuntime(thread: OrchestrationV2ThreadShell): ThreadRuntimeSummary | null {
+  if (thread.latestRunId === null && thread.activeProviderThreadId === null) return null;
+  const hasPendingBackgroundTasks = (thread.pendingBackgroundTasks?.length ?? 0) > 0;
+  const status = hasPendingBackgroundTasks ? "idle" : (thread.activityRunStatus ?? thread.status);
+  return {
+    status,
+    activeRunId: thread.activeRunId,
+    providerInstanceId: thread.providerInstanceId,
+    providerName: null,
+    lastError: thread.lastError ?? null,
+    updatedAt: iso(thread.updatedAt),
+  };
 }
 
 export function scopeProject(
@@ -29,25 +164,85 @@ export function scopeProject(
   return { ...project, environmentId };
 }
 
-export function scopeThreadShell(
+export function presentThreadShell(
   environmentId: EnvironmentId,
-  thread: OrchestrationThreadShell,
+  thread: OrchestrationV2ThreadShell,
 ): EnvironmentThreadShell {
-  return { ...thread, environmentId };
+  const updatedAt = iso(thread.updatedAt);
+  const latestRun =
+    thread.latestRunId === null
+      ? null
+      : ({
+          runId: thread.latestRunId,
+          status: thread.status === "idle" ? "completed" : thread.status,
+          requestedAt: nullableIso(thread.latestRunRequestedAt ?? null),
+          startedAt: nullableIso(thread.latestRunStartedAt ?? null),
+          completedAt:
+            thread.latestRunCompletedAt === undefined
+              ? thread.status === "idle" || terminalRunStatus(thread.status)
+                ? updatedAt
+                : null
+              : nullableIso(thread.latestRunCompletedAt),
+          assistantMessageId: null,
+        } satisfies ThreadRunSummary);
+  return {
+    environmentId,
+    id: thread.id,
+    projectId: thread.projectId,
+    title: thread.title,
+    providerInstanceId: thread.providerInstanceId,
+    modelSelection: thread.modelSelection,
+    runtimeMode: thread.runtimeMode,
+    interactionMode: thread.interactionMode,
+    branch: thread.branch,
+    worktreePath: thread.worktreePath,
+    linkedPullRequest: thread.linkedPullRequest ?? null,
+    lineage: thread.lineage,
+    forkedFrom: thread.forkedFrom,
+    activeProviderThreadId: thread.activeProviderThreadId,
+    latestRun,
+    runtime: shellRuntime(thread),
+    latestUserMessageAt: nullableIso(thread.latestUserMessageAt),
+    hasPendingApprovals:
+      thread.pendingRuntimeRequest !== null &&
+      thread.pendingRuntimeRequest.kind !== "user_input" &&
+      thread.pendingRuntimeRequest.kind !== "auth_refresh",
+    hasPendingUserInput: thread.pendingRuntimeRequest?.kind === "user_input",
+    hasActionableProposedPlan: thread.hasActionableProposedPlan,
+    pendingBackgroundTasks: thread.pendingBackgroundTasks ?? [],
+    itemCount: thread.itemCount,
+    visibleItemCount: thread.visibleItemCount,
+    createdAt: iso(thread.createdAt),
+    updatedAt,
+    archivedAt: nullableIso(thread.archivedAt),
+    settledOverride: thread.settledOverride,
+    settledAt: nullableIso(thread.settledAt),
+    snoozedUntil: nullableIso(thread.snoozedUntil ?? null),
+    snoozedAt: nullableIso(thread.snoozedAt ?? null),
+    pinnedAt: nullableIso(thread.pinnedAt ?? null),
+    pinOrderKey: thread.pinOrderKey ?? null,
+    ...(thread.lastVisitedAt === undefined
+      ? {}
+      : { lastVisitedAt: nullableIso(thread.lastVisitedAt) }),
+    titleRegeneration:
+      thread.titleRegeneration == null
+        ? null
+        : {
+            requestId: thread.titleRegeneration.requestId,
+            startedAt: iso(thread.titleRegeneration.startedAt),
+          },
+    deletedAt: nullableIso(thread.deletedAt),
+    source: thread,
+  };
 }
 
-export function scopeThread(
-  environmentId: EnvironmentId,
-  thread: OrchestrationThread,
-): EnvironmentThread {
-  return { ...thread, environmentId };
-}
+export const scopeThreadShell = presentThreadShell;
 
 export function selectEnvironmentThreadShell(
-  snapshot: OrchestrationShellSnapshot | null,
+  snapshot: OrchestrationV2ShellSnapshot | null,
   environmentId: EnvironmentId,
   threadId: ThreadId,
 ): EnvironmentThreadShell | null {
   const thread = snapshot?.threads.find((candidate) => candidate.id === threadId) ?? null;
-  return thread ? scopeThreadShell(environmentId, thread) : null;
+  return thread ? presentThreadShell(environmentId, thread) : null;
 }
diff --git a/packages/client-runtime/src/state/orchestration.ts b/packages/client-runtime/src/state/orchestration.ts
index ba80275bffb3..728c08593731 100644
--- a/packages/client-runtime/src/state/orchestration.ts
+++ b/packages/client-runtime/src/state/orchestration.ts
@@ -1,37 +1,62 @@
-import { ORCHESTRATION_WS_METHODS } from "@t3tools/contracts";
+import { ORCHESTRATION_V2_WS_METHODS } from "@t3tools/contracts";
 import { Atom } from "effect/unstable/reactivity";
 
-import { createEnvironmentRpcQueryAtomFamily } from "./runtime.ts";
+import {
+  createEnvironmentRpcCommand,
+  createEnvironmentRpcQueryAtomFamily,
+  createEnvironmentRpcSubscriptionAtomFamily,
+} from "./runtime.ts";
 import type { EnvironmentRegistry } from "../connection/registry.ts";
 
 export function createOrchestrationEnvironmentAtoms<R, E>(
   runtime: Atom.AtomRuntime<EnvironmentRegistry | R, E>,
 ) {
   return {
+    v2: {
+      dispatchCommand: createEnvironmentRpcCommand(runtime, {
+        label: "environment-data:orchestration-v2:dispatch-command",
+        tag: ORCHESTRATION_V2_WS_METHODS.dispatchCommand,
+      }),
+      threadProjection: createEnvironmentRpcQueryAtomFamily(runtime, {
+        label: "environment-data:orchestration-v2:thread-projection",
+        tag: ORCHESTRATION_V2_WS_METHODS.getThreadProjection,
+        staleTimeMs: 0,
+        idleTtlMs: 0,
+      }),
+      shell: createEnvironmentRpcSubscriptionAtomFamily(runtime, {
+        label: "environment-data:orchestration-v2:shell",
+        tag: ORCHESTRATION_V2_WS_METHODS.subscribeShell,
+      }),
+      thread: createEnvironmentRpcSubscriptionAtomFamily(runtime, {
+        label: "environment-data:orchestration-v2:thread",
+        tag: ORCHESTRATION_V2_WS_METHODS.subscribeThread,
+        idleTtlMs: 0,
+      }),
+    },
     turnDiff: createEnvironmentRpcQueryAtomFamily(runtime, {
       label: "environment-data:orchestration:turn-diff",
-      tag: ORCHESTRATION_WS_METHODS.getTurnDiff,
+      tag: ORCHESTRATION_V2_WS_METHODS.getTurnDiff,
     }),
     workflowScript: createEnvironmentRpcQueryAtomFamily(runtime, {
       label: "environment-data:orchestration:workflow-script",
-      tag: ORCHESTRATION_WS_METHODS.getWorkflowScript,
+      tag: ORCHESTRATION_V2_WS_METHODS.getWorkflowScript,
       // Scripts are immutable per run: cache generously.
       staleTimeMs: 300_000,
       idleTtlMs: 300_000,
     }),
     fullThreadDiff: createEnvironmentRpcQueryAtomFamily(runtime, {
       label: "environment-data:orchestration:full-thread-diff",
-      tag: ORCHESTRATION_WS_METHODS.getFullThreadDiff,
+      tag: ORCHESTRATION_V2_WS_METHODS.getFullThreadDiff,
     }),
     threadSearch: createEnvironmentRpcQueryAtomFamily(runtime, {
       label: "environment-data:orchestration:thread-search",
-      tag: ORCHESTRATION_WS_METHODS.searchThreads,
+      tag: ORCHESTRATION_V2_WS_METHODS.searchThreads,
       staleTimeMs: 30_000,
       idleTtlMs: 60_000,
     }),
     archivedShellSnapshot: createEnvironmentRpcQueryAtomFamily(runtime, {
       label: "environment-data:orchestration:archived-shell-snapshot",
-      tag: ORCHESTRATION_WS_METHODS.getArchivedShellSnapshot,
+      tag: ORCHESTRATION_V2_WS_METHODS.getArchivedShellSnapshot,
     }),
   };
 }
diff --git a/packages/client-runtime/src/state/orchestrationV2Projection.test.ts b/packages/client-runtime/src/state/orchestrationV2Projection.test.ts
new file mode 100644
index 000000000000..fc685949600d
--- /dev/null
+++ b/packages/client-runtime/src/state/orchestrationV2Projection.test.ts
@@ -0,0 +1,314 @@
+import { describe, expect, it } from "vite-plus/test";
+import {
+  type OrchestrationV2DomainEvent,
+  type OrchestrationV2Run,
+  type OrchestrationV2ThreadProjection,
+  type OrchestrationV2TurnItem,
+  MessageId,
+  ProjectId,
+  ProviderInstanceId,
+  NodeId,
+  ProviderThreadId,
+  ProviderTurnId,
+  RunId,
+  ThreadId,
+  TurnItemId,
+} from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+
+import { applyOrchestrationV2ProjectionEvent } from "./orchestrationV2Projection.ts";
+
+const now = DateTime.makeUnsafe("2026-06-20T00:00:00.000Z");
+const threadId = ThreadId.make("thread-reducer");
+const runId = RunId.make("run-reducer");
+const run = {
+  id: runId,
+  threadId,
+  ordinal: 1,
+  providerInstanceId: ProviderInstanceId.make("codex"),
+  modelSelection: { instanceId: ProviderInstanceId.make("codex"), model: "gpt-5.4" },
+  providerThreadId: null,
+  userMessageId: MessageId.make("message-reducer"),
+  rootNodeId: null,
+  activeAttemptId: null,
+  status: "completed",
+  requestedAt: now,
+  startedAt: now,
+  completedAt: now,
+  checkpointId: null,
+  contextHandoffId: null,
+} satisfies OrchestrationV2Run;
+
+function commandItem(id: string, output = "done", ordinal = 1): OrchestrationV2TurnItem {
+  return {
+    id: TurnItemId.make(id),
+    threadId,
+    runId,
+    nodeId: null,
+    providerThreadId: null,
+    providerTurnId: null,
+    nativeItemRef: null,
+    parentItemId: null,
+    ordinal,
+    status: "completed",
+    title: null,
+    startedAt: now,
+    completedAt: now,
+    updatedAt: now,
+    type: "command_execution",
+    input: "pwd",
+    output,
+    exitCode: 0,
+  };
+}
+const emptyProjection = {
+  thread: {
+    id: threadId,
+    projectId: ProjectId.make("project-reducer"),
+    title: "Reducer",
+    providerInstanceId: ProviderInstanceId.make("codex"),
+    modelSelection: { instanceId: ProviderInstanceId.make("codex"), model: "gpt-5.4" },
+    runtimeMode: "full-access",
+    interactionMode: "default",
+    branch: null,
+    worktreePath: null,
+    activeProviderThreadId: null,
+    lineage: { rootThreadId: threadId, parentThreadId: null, relationshipToParent: null },
+    forkedFrom: null,
+    createdBy: "user",
+    creationSource: "web",
+    createdAt: now,
+    updatedAt: now,
+    archivedAt: null,
+    settledOverride: null,
+    settledAt: null,
+    lastVisitedAt: null,
+    deletedAt: null,
+  },
+  runs: [],
+  attempts: [],
+  nodes: [],
+  subagents: [],
+  providerSessions: [],
+  providerThreads: [],
+  providerTurns: [],
+  runtimeRequests: [],
+  messages: [],
+  plans: [],
+  turnItems: [],
+  checkpointScopes: [],
+  checkpoints: [],
+  contextHandoffs: [],
+  contextTransfers: [],
+  visibleTurnItems: [],
+  updatedAt: now,
+} as OrchestrationV2ThreadProjection;
+
+describe("applyOrchestrationV2ProjectionEvent", () => {
+  it("keeps live token usage when the terminal provider turn omits it", () => {
+    const providerTurnId = ProviderTurnId.make("provider-turn-reducer");
+    const running = {
+      id: providerTurnId,
+      providerThreadId: ProviderThreadId.make("provider-thread-reducer"),
+      nodeId: NodeId.make("provider-node-reducer"),
+      runAttemptId: null,
+      nativeTurnRef: null,
+      ordinal: 1,
+      status: "running" as const,
+      startedAt: now,
+      completedAt: null,
+      tokenUsage: {
+        usedTokens: 50_000,
+        maxTokens: 200_000,
+        updatedAt: "2026-08-29T00:00:00.000Z",
+      },
+    };
+    const projection = { ...emptyProjection, providerTurns: [running] };
+    const event = {
+      id: "event-provider-turn-terminal",
+      type: "provider-turn.updated",
+      threadId,
+      driver: "codex",
+      occurredAt: now,
+      payload: {
+        ...running,
+        status: "completed",
+        completedAt: now,
+        tokenUsage: undefined,
+      },
+    } as OrchestrationV2DomainEvent;
+
+    const next = applyOrchestrationV2ProjectionEvent(projection, event);
+
+    expect(next?.providerTurns[0]?.status).toBe("completed");
+    expect(next?.providerTurns[0]?.tokenUsage).toEqual(running.tokenUsage);
+  });
+
+  it("applies thread lifecycle payloads instead of leaving stale metadata", () => {
+    const archivedAt = DateTime.makeUnsafe("2026-06-20T01:00:00.000Z");
+    const event = {
+      id: "event-archive",
+      type: "thread.archived",
+      threadId,
+      occurredAt: archivedAt,
+      payload: { ...emptyProjection.thread, archivedAt, updatedAt: archivedAt },
+    } as OrchestrationV2DomainEvent;
+
+    const next = applyOrchestrationV2ProjectionEvent(emptyProjection, event);
+    expect(next?.thread.archivedAt).toEqual(archivedAt);
+    expect(next?.updatedAt).toEqual(archivedAt);
+  });
+
+  it("ignores events for another thread", () => {
+    const event = {
+      id: "event-other",
+      type: "thread.deleted",
+      threadId: ThreadId.make("thread-other"),
+      occurredAt: now,
+      payload: { ...emptyProjection.thread, id: ThreadId.make("thread-other"), deletedAt: now },
+    } as OrchestrationV2DomainEvent;
+
+    expect(applyOrchestrationV2ProjectionEvent(emptyProjection, event)).toBe(emptyProjection);
+  });
+
+  it("preserves visible row identity when run updates do not change membership", () => {
+    const item = commandItem("item-stable");
+    const visibleTurnItems = [
+      {
+        position: 0,
+        visibility: "local" as const,
+        sourceThreadId: threadId,
+        sourceItemId: item.id,
+        item,
+      },
+    ];
+    const projection = {
+      ...emptyProjection,
+      runs: [run],
+      turnItems: [item],
+      visibleTurnItems,
+    };
+    const event = {
+      id: "event-run-update",
+      type: "run.updated",
+      threadId,
+      runId,
+      occurredAt: now,
+      payload: { ...run, status: "completed" },
+    } as OrchestrationV2DomainEvent;
+
+    const next = applyOrchestrationV2ProjectionEvent(projection, event);
+    expect(next?.visibleTurnItems).toBe(visibleTurnItems);
+    expect(next?.visibleTurnItems[0]).toBe(visibleTurnItems[0]);
+  });
+
+  it("replaces only the updated visible item when membership is unchanged", () => {
+    const first = commandItem("item-first", "first");
+    const second = commandItem("item-second", "second");
+    const firstRow = {
+      position: 0,
+      visibility: "local" as const,
+      sourceThreadId: threadId,
+      sourceItemId: first.id,
+      item: first,
+    };
+    const secondRow = {
+      position: 1,
+      visibility: "local" as const,
+      sourceThreadId: threadId,
+      sourceItemId: second.id,
+      item: second,
+    };
+    const updated = commandItem("item-first", "streamed output");
+    const projection = {
+      ...emptyProjection,
+      runs: [run],
+      turnItems: [first, second],
+      visibleTurnItems: [firstRow, secondRow],
+    };
+    const event = {
+      id: "event-item-update",
+      type: "turn-item.updated",
+      threadId,
+      runId,
+      occurredAt: now,
+      payload: updated,
+    } as OrchestrationV2DomainEvent;
+
+    const next = applyOrchestrationV2ProjectionEvent(projection, event);
+    expect(next?.visibleTurnItems).not.toBe(projection.visibleTurnItems);
+    expect(next?.visibleTurnItems[0]).not.toBe(firstRow);
+    expect(next?.visibleTurnItems[0]?.item).toBe(updated);
+    expect(next?.visibleTurnItems[1]).toBe(secondRow);
+  });
+
+  it("inserts live turn items by authoritative ordinal", () => {
+    const queuedFuture = commandItem("item-queued-future", "queued", 300);
+    const activeAssistant = commandItem("item-active-assistant", "done", 201);
+    const queuedRow = {
+      position: 0,
+      visibility: "local" as const,
+      sourceThreadId: threadId,
+      sourceItemId: queuedFuture.id,
+      item: queuedFuture,
+    };
+    const projection = {
+      ...emptyProjection,
+      runs: [run],
+      turnItems: [queuedFuture],
+      visibleTurnItems: [queuedRow],
+    };
+    const event = {
+      id: "event-active-assistant",
+      type: "turn-item.updated",
+      threadId,
+      runId,
+      occurredAt: now,
+      payload: activeAssistant,
+    } as OrchestrationV2DomainEvent;
+
+    const next = applyOrchestrationV2ProjectionEvent(projection, event);
+    expect(next?.visibleTurnItems.map((row) => row.item.id)).toEqual([
+      activeAssistant.id,
+      queuedFuture.id,
+    ]);
+    expect(next?.visibleTurnItems.map((row) => row.position)).toEqual([0, 1]);
+  });
+
+  it("removes only hidden local items while preserving inherited rows", () => {
+    const inherited = commandItem("item-inherited");
+    const local = commandItem("item-local");
+    const inheritedRow = {
+      position: 0,
+      visibility: "inherited" as const,
+      sourceThreadId: ThreadId.make("thread-source"),
+      sourceItemId: inherited.id,
+      item: inherited,
+    };
+    const localRow = {
+      position: 1,
+      visibility: "local" as const,
+      sourceThreadId: threadId,
+      sourceItemId: local.id,
+      item: local,
+    };
+    const projection = {
+      ...emptyProjection,
+      runs: [run],
+      turnItems: [local],
+      visibleTurnItems: [inheritedRow, localRow],
+    };
+    const event = {
+      id: "event-run-rollback",
+      type: "run.updated",
+      threadId,
+      runId,
+      occurredAt: now,
+      payload: { ...run, status: "rolled_back" },
+    } as OrchestrationV2DomainEvent;
+
+    const next = applyOrchestrationV2ProjectionEvent(projection, event);
+    expect(next?.visibleTurnItems).toEqual([inheritedRow]);
+    expect(next?.visibleTurnItems[0]).toBe(inheritedRow);
+  });
+});
diff --git a/packages/client-runtime/src/state/orchestrationV2Projection.ts b/packages/client-runtime/src/state/orchestrationV2Projection.ts
new file mode 100644
index 000000000000..e4e2dbaff8a2
--- /dev/null
+++ b/packages/client-runtime/src/state/orchestrationV2Projection.ts
@@ -0,0 +1,257 @@
+import type {
+  OrchestrationV2DomainEvent,
+  OrchestrationV2ThreadProjection,
+  OrchestrationV2TurnItem,
+} from "@t3tools/contracts";
+import { isOrchestrationV2TurnItemVisible } from "@t3tools/shared/orchestrationV2Timeline";
+
+export type ApplyOrchestrationV2ProjectionEventOptions = {
+  readonly partialTimeline?: boolean;
+  readonly latestLocalTurnOrdinal?: number | null;
+};
+
+function upsertEntity<T extends { readonly id: unknown }>(
+  items: ReadonlyArray<T>,
+  item: T,
+): ReadonlyArray<T> {
+  const index = items.findIndex((candidate) => candidate.id === item.id);
+  if (index === -1) return [...items, item];
+  const next = [...items];
+  next[index] = item;
+  return next;
+}
+
+function removeVisibleItem(
+  rows: OrchestrationV2ThreadProjection["visibleTurnItems"],
+  sourceItemId: OrchestrationV2TurnItem["id"],
+): OrchestrationV2ThreadProjection["visibleTurnItems"] {
+  const index = rows.findIndex((row) => row.sourceItemId === sourceItemId);
+  if (index === -1) return rows;
+  return renumberVisibleItems([...rows.slice(0, index), ...rows.slice(index + 1)]);
+}
+
+function renumberVisibleItems(
+  rows: OrchestrationV2ThreadProjection["visibleTurnItems"],
+): OrchestrationV2ThreadProjection["visibleTurnItems"] {
+  return rows.map((row, position) => (row.position === position ? row : { ...row, position }));
+}
+
+function shouldShowLocalTurnItem(
+  projection: OrchestrationV2ThreadProjection,
+  item: OrchestrationV2TurnItem,
+): boolean {
+  return isOrchestrationV2TurnItemVisible({
+    item,
+    runs: projection.runs,
+    attempts: projection.attempts,
+    items: projection.turnItems,
+  });
+}
+
+function activeVisibleTurnItems(
+  projection: OrchestrationV2ThreadProjection,
+): OrchestrationV2ThreadProjection["visibleTurnItems"] {
+  const rows = projection.visibleTurnItems;
+  let next: Array<(typeof rows)[number]> | null = null;
+  for (let index = 0; index < rows.length; index += 1) {
+    const row = rows[index]!;
+    const keep = row.visibility !== "local" || shouldShowLocalTurnItem(projection, row.item);
+    if (!keep) {
+      next ??= rows.slice(0, index);
+      continue;
+    }
+    next?.push(row);
+  }
+  return next === null ? rows : renumberVisibleItems(next);
+}
+
+function oldestLocalTurnOrdinal(
+  rows: OrchestrationV2ThreadProjection["visibleTurnItems"],
+): number | null {
+  let oldest: number | null = null;
+  for (const row of rows) {
+    if (row.visibility !== "local") continue;
+    if (oldest === null || row.item.ordinal < oldest) {
+      oldest = row.item.ordinal;
+    }
+  }
+  return oldest;
+}
+
+function shouldDropMissingPartialTurnItem(
+  projection: OrchestrationV2ThreadProjection,
+  item: OrchestrationV2TurnItem,
+  latestLocalTurnOrdinal: number | null | undefined,
+): boolean {
+  if (projection.visibleTurnItems.some((row) => row.sourceItemId === item.id)) {
+    return false;
+  }
+  if (
+    latestLocalTurnOrdinal !== null &&
+    latestLocalTurnOrdinal !== undefined &&
+    item.ordinal <= latestLocalTurnOrdinal
+  ) {
+    return true;
+  }
+  const oldest = oldestLocalTurnOrdinal(projection.visibleTurnItems);
+  return oldest !== null && item.ordinal < oldest;
+}
+
+function upsertVisibleTurnItem(
+  projection: OrchestrationV2ThreadProjection,
+  item: OrchestrationV2TurnItem,
+  partialTimeline: boolean,
+  latestLocalTurnOrdinal: number | null | undefined,
+): OrchestrationV2ThreadProjection["visibleTurnItems"] {
+  const rows = projection.visibleTurnItems;
+  const index = rows.findIndex((row) => row.sourceItemId === item.id);
+  const next = {
+    position: 0,
+    visibility: "local" as const,
+    sourceThreadId: item.threadId,
+    sourceItemId: item.id,
+    item,
+  };
+  const previous = index === -1 ? undefined : rows[index]!;
+  if (
+    previous !== undefined &&
+    previous.visibility === next.visibility &&
+    previous.sourceThreadId === next.sourceThreadId &&
+    previous.sourceItemId === next.sourceItemId &&
+    previous.item === item
+  ) {
+    return rows;
+  }
+  if (
+    index === -1 &&
+    partialTimeline &&
+    shouldDropMissingPartialTurnItem(projection, item, latestLocalTurnOrdinal)
+  ) {
+    return rows;
+  }
+  const updated = index === -1 ? [...rows] : [...rows.slice(0, index), ...rows.slice(index + 1)];
+  const insertionIndex = updated.findIndex(
+    (row) =>
+      row.visibility === "local" &&
+      (row.item.ordinal > item.ordinal ||
+        (row.item.ordinal === item.ordinal &&
+          String(row.item.id).localeCompare(String(item.id)) > 0)),
+  );
+  updated.splice(insertionIndex === -1 ? updated.length : insertionIndex, 0, next);
+  return renumberVisibleItems(updated);
+}
+
+/** Applies one committed event to a matching thread projection. */
+export function applyOrchestrationV2ProjectionEvent(
+  projection: OrchestrationV2ThreadProjection | null,
+  event: OrchestrationV2DomainEvent,
+  options?: ApplyOrchestrationV2ProjectionEventOptions,
+): OrchestrationV2ThreadProjection | null {
+  if (projection === null || event.threadId !== projection.thread.id) return projection;
+
+  const partialTimeline = options?.partialTimeline === true;
+  const latestLocalTurnOrdinal = options?.latestLocalTurnOrdinal;
+  const base = { ...projection, updatedAt: event.occurredAt };
+  switch (event.type) {
+    case "thread.created":
+    case "thread.archived":
+    case "thread.unarchived":
+    case "thread.deleted":
+    case "thread.settled":
+    case "thread.unsettled":
+    case "thread.snoozed":
+    case "thread.unsnoozed":
+    case "thread.pinned":
+    case "thread.unpinned":
+    case "thread.pin-reordered":
+    case "thread.metadata-updated":
+    case "thread.runtime-mode-updated":
+    case "thread.interaction-mode-updated":
+    case "thread.model-selection-updated":
+    case "thread.provider-switched":
+      return { ...base, thread: event.payload };
+    // Visited tracking is read state, not activity: skip the updatedAt bump.
+    case "thread.visited":
+    case "thread.marked-unread":
+      return { ...projection, thread: event.payload };
+    case "run.created":
+    case "run.updated": {
+      const next = { ...base, runs: upsertEntity(base.runs, event.payload) };
+      return { ...next, visibleTurnItems: activeVisibleTurnItems(next) };
+    }
+    case "run-attempt.created":
+    case "run-attempt.updated": {
+      const next = { ...base, attempts: upsertEntity(base.attempts, event.payload) };
+      return { ...next, visibleTurnItems: activeVisibleTurnItems(next) };
+    }
+    case "node.updated":
+      return { ...base, nodes: upsertEntity(base.nodes, event.payload) };
+    case "subagent.updated":
+      return { ...base, subagents: upsertEntity(base.subagents, event.payload) };
+    case "provider-session.attached":
+    case "provider-session.updated":
+      return {
+        ...base,
+        providerSessions: upsertEntity(base.providerSessions, event.payload),
+      };
+    case "provider-session.detached":
+      return {
+        ...base,
+        providerSessions: base.providerSessions.filter(
+          (session) => session.id !== event.payload.providerSessionId,
+        ),
+      };
+    case "provider-thread.updated":
+      return { ...base, providerThreads: upsertEntity(base.providerThreads, event.payload) };
+    case "provider-turn.updated":
+      return {
+        ...base,
+        providerTurns: upsertEntity(base.providerTurns, {
+          ...event.payload,
+          ...((event.payload.tokenUsage ??
+            base.providerTurns.find((turn) => turn.id === event.payload.id)?.tokenUsage) ===
+          undefined
+            ? {}
+            : {
+                tokenUsage:
+                  event.payload.tokenUsage ??
+                  base.providerTurns.find((turn) => turn.id === event.payload.id)?.tokenUsage,
+              }),
+        }),
+      };
+    case "runtime-request.updated":
+      return { ...base, runtimeRequests: upsertEntity(base.runtimeRequests, event.payload) };
+    case "message.updated":
+      return { ...base, messages: upsertEntity(base.messages, event.payload) };
+    case "plan.updated":
+      return { ...base, plans: upsertEntity(base.plans, event.payload) };
+    case "turn-item.updated": {
+      if (
+        partialTimeline &&
+        !projection.turnItems.some((candidate) => candidate.id === event.payload.id) &&
+        shouldDropMissingPartialTurnItem(projection, event.payload, latestLocalTurnOrdinal)
+      ) {
+        return projection;
+      }
+      const next = { ...base, turnItems: upsertEntity(base.turnItems, event.payload) };
+      const visible = { ...next, visibleTurnItems: activeVisibleTurnItems(next) };
+      return {
+        ...next,
+        visibleTurnItems: shouldShowLocalTurnItem(next, event.payload)
+          ? upsertVisibleTurnItem(visible, event.payload, partialTimeline, latestLocalTurnOrdinal)
+          : removeVisibleItem(visible.visibleTurnItems, event.payload.id),
+      };
+    }
+    case "checkpoint-scope.created":
+      return { ...base, checkpointScopes: upsertEntity(base.checkpointScopes, event.payload) };
+    case "checkpoint.captured":
+      return { ...base, checkpoints: upsertEntity(base.checkpoints, event.payload) };
+    case "checkpoint.rollback-requested":
+      return base;
+    case "context-handoff.updated":
+      return { ...base, contextHandoffs: upsertEntity(base.contextHandoffs, event.payload) };
+    case "context-transfer.created":
+    case "context-transfer.updated":
+      return { ...base, contextTransfers: upsertEntity(base.contextTransfers, event.payload) };
+  }
+}
diff --git a/packages/client-runtime/src/state/orchestrationV2TestFixtures.ts b/packages/client-runtime/src/state/orchestrationV2TestFixtures.ts
new file mode 100644
index 000000000000..16aae13305ff
--- /dev/null
+++ b/packages/client-runtime/src/state/orchestrationV2TestFixtures.ts
@@ -0,0 +1,110 @@
+import {
+  ProjectId,
+  ProviderInstanceId,
+  ThreadId,
+  type OrchestrationProjectShell,
+  type OrchestrationV2ShellSnapshot,
+  type OrchestrationV2ThreadProjection,
+  type OrchestrationV2ThreadShell,
+} from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+
+export const v2Now = DateTime.makeUnsafe("2026-06-20T00:00:00.000Z");
+export const v2ProjectId = ProjectId.make("project-v2");
+export const v2ThreadId = ThreadId.make("thread-v2");
+export const v2ProviderInstanceId = ProviderInstanceId.make("codex");
+
+export const v2Project: OrchestrationProjectShell = {
+  id: v2ProjectId,
+  title: "Project",
+  workspaceRoot: "/workspace/project",
+  repositoryIdentity: null,
+  defaultModelSelection: null,
+  scripts: [],
+  createdAt: "2026-06-20T00:00:00.000Z",
+  updatedAt: "2026-06-20T00:00:00.000Z",
+};
+
+export const v2ThreadShell: OrchestrationV2ThreadShell = {
+  id: v2ThreadId,
+  projectId: v2ProjectId,
+  title: "Thread",
+  providerInstanceId: v2ProviderInstanceId,
+  modelSelection: { instanceId: v2ProviderInstanceId, model: "gpt-5.4" },
+  runtimeMode: "full-access",
+  interactionMode: "default",
+  branch: null,
+  worktreePath: null,
+  activeProviderThreadId: null,
+  lineage: { rootThreadId: v2ThreadId, parentThreadId: null, relationshipToParent: null },
+  forkedFrom: null,
+  createdBy: "user",
+  creationSource: "web",
+  latestRunId: null,
+  activeRunId: null,
+  status: "idle",
+  pendingRuntimeRequest: null,
+  latestVisibleMessage: null,
+  latestUserMessageAt: null,
+  hasActionableProposedPlan: false,
+  itemCount: 0,
+  visibleItemCount: 0,
+  createdAt: v2Now,
+  updatedAt: v2Now,
+  archivedAt: null,
+  settledOverride: null,
+  settledAt: null,
+  lastVisitedAt: null,
+  deletedAt: null,
+};
+
+export const v2Projection: OrchestrationV2ThreadProjection = {
+  thread: {
+    id: v2ThreadShell.id,
+    projectId: v2ThreadShell.projectId,
+    title: v2ThreadShell.title,
+    providerInstanceId: v2ThreadShell.providerInstanceId,
+    modelSelection: v2ThreadShell.modelSelection,
+    runtimeMode: v2ThreadShell.runtimeMode,
+    interactionMode: v2ThreadShell.interactionMode,
+    branch: v2ThreadShell.branch,
+    worktreePath: v2ThreadShell.worktreePath,
+    activeProviderThreadId: v2ThreadShell.activeProviderThreadId,
+    lineage: v2ThreadShell.lineage,
+    forkedFrom: v2ThreadShell.forkedFrom,
+    createdBy: v2ThreadShell.createdBy,
+    creationSource: v2ThreadShell.creationSource,
+    createdAt: v2Now,
+    updatedAt: v2Now,
+    archivedAt: null,
+    settledOverride: null,
+    settledAt: null,
+    lastVisitedAt: null,
+    deletedAt: null,
+  },
+  runs: [],
+  attempts: [],
+  nodes: [],
+  subagents: [],
+  providerSessions: [],
+  providerThreads: [],
+  providerTurns: [],
+  runtimeRequests: [],
+  messages: [],
+  plans: [],
+  turnItems: [],
+  checkpointScopes: [],
+  checkpoints: [],
+  contextHandoffs: [],
+  contextTransfers: [],
+  visibleTurnItems: [],
+  updatedAt: v2Now,
+};
+
+export const v2ShellSnapshot: OrchestrationV2ShellSnapshot = {
+  schemaVersion: 1,
+  snapshotSequence: 0,
+  projects: [v2Project],
+  threads: [v2ThreadShell],
+  archivedThreads: [],
+};
diff --git a/packages/client-runtime/src/state/projectEntities.ts b/packages/client-runtime/src/state/projectEntities.ts
index 4d51b4d427e9..ca440b07d2b2 100644
--- a/packages/client-runtime/src/state/projectEntities.ts
+++ b/packages/client-runtime/src/state/projectEntities.ts
@@ -1,7 +1,7 @@
 import type {
   EnvironmentId,
   OrchestrationProjectShell,
-  OrchestrationShellSnapshot,
+  OrchestrationV2ShellSnapshot,
   ProjectId,
   ScopedProjectRef,
 } from "@t3tools/contracts";
@@ -19,7 +19,7 @@ export function createEnvironmentProjectAtoms(input: {
   readonly catalogValueAtom: Atom.Atom<EnvironmentCatalogState>;
   readonly snapshotAtom: (
     environmentId: EnvironmentId,
-  ) => Atom.Atom<OrchestrationShellSnapshot | null>;
+  ) => Atom.Atom<OrchestrationV2ShellSnapshot | null>;
 }) {
   const environmentProjectsAtom = Atom.family((environmentId: EnvironmentId) =>
     Atom.make(
diff --git a/packages/client-runtime/src/state/server.ts b/packages/client-runtime/src/state/server.ts
index 547fa4a3af28..f399a1d998d5 100644
--- a/packages/client-runtime/src/state/server.ts
+++ b/packages/client-runtime/src/state/server.ts
@@ -482,7 +482,7 @@ export function serverConfigStateChanges(
 export function projectServerWelcome(
   current: Option.Option<ServerLifecycleWelcomePayload>,
   event: {
-    readonly type: "welcome" | "ready";
+    readonly type: "welcome" | "ready" | "legacyThreadMigration";
     readonly payload: unknown;
   },
 ): readonly [
@@ -757,6 +757,18 @@ export function createServerEnvironmentAtoms<R, E>(
       label: "environment-data:server:process-resource-history",
       tag: WS_METHODS.serverGetProcessResourceHistory,
     }),
+    /** Live scheduled-task list: snapshot on subscribe, fresh list after every server-side change. */
+    scheduledTasksLive: createEnvironmentRpcSubscriptionAtomFamily(runtime, {
+      label: "environment-data:server:scheduled-tasks:live",
+      tag: WS_METHODS.scheduledTasksSubscribe,
+    }),
+    // A cold transcript scan is measured in seconds, so keep the result around
+    // long enough that switching windows or re-rendering does not rescan.
+    usageSummary: createEnvironmentRpcQueryAtomFamily(runtime, {
+      label: "environment-data:server:usage-summary",
+      tag: WS_METHODS.serverGetUsageSummary,
+      staleTimeMs: 60_000,
+    }),
     resourceTelemetry: createEnvironmentRpcSubscriptionAtomFamily(runtime, {
       label: "environment-data:server:resource-telemetry",
       tag: WS_METHODS.subscribeResourceTelemetry,
@@ -767,13 +779,6 @@ export function createServerEnvironmentAtoms<R, E>(
       tag: WS_METHODS.serverGetResourceTelemetryHistory,
       staleTimeMs: 5_000,
     }),
-    // A cold transcript scan is measured in seconds, so keep the result around
-    // long enough that switching windows or re-rendering does not rescan.
-    usageSummary: createEnvironmentRpcQueryAtomFamily(runtime, {
-      label: "environment-data:server:usage-summary",
-      tag: WS_METHODS.serverGetUsageSummary,
-      staleTimeMs: 60_000,
-    }),
     configProjection,
     welcome: createEnvironmentRpcSubscriptionAtomFamily(runtime, {
       label: "environment-data:server:welcome",
@@ -783,6 +788,18 @@ export function createServerEnvironmentAtoms<R, E>(
           Stream.mapAccum(Option.none<ServerLifecycleWelcomePayload>, projectServerWelcome),
         ),
     }),
+    legacyThreadMigration: createEnvironmentRpcSubscriptionAtomFamily(runtime, {
+      label: "environment-data:server:legacy-thread-migration",
+      tag: WS_METHODS.subscribeServerLifecycle,
+      transform: (stream) =>
+        stream.pipe(
+          Stream.filterMap((event) =>
+            event.type === "legacyThreadMigration"
+              ? Result.succeed(event.payload)
+              : Result.failVoid,
+          ),
+        ),
+    }),
     refreshProviders: createEnvironmentRpcCommand(runtime, {
       label: "environment-data:server:refresh-providers",
       tag: WS_METHODS.serverRefreshProviders,
@@ -820,6 +837,31 @@ export function createServerEnvironmentAtoms<R, E>(
       label: "environment-data:server:signal-process",
       tag: WS_METHODS.serverSignalProcess,
     }),
+    upsertScheduledTask: createEnvironmentRpcCommand(runtime, {
+      label: "environment-data:server:scheduled-task:upsert",
+      tag: WS_METHODS.scheduledTasksUpsert,
+      scheduler: configScheduler,
+      concurrency: configConcurrency,
+    }),
+    setScheduledTaskEnabled: createEnvironmentRpcCommand(runtime, {
+      label: "environment-data:server:scheduled-task:set-enabled",
+      tag: WS_METHODS.scheduledTasksSetEnabled,
+      scheduler: configScheduler,
+      concurrency: configConcurrency,
+    }),
+    deleteScheduledTask: createEnvironmentRpcCommand(runtime, {
+      label: "environment-data:server:scheduled-task:delete",
+      tag: WS_METHODS.scheduledTasksDelete,
+      scheduler: configScheduler,
+      concurrency: configConcurrency,
+    }),
+    // Deliberately not on the config lane: run-now blocks until the run is
+    // dispatched, and a slow run must not stall settings/keybinding/provider
+    // mutations (or other scheduled-task edits) queued behind it.
+    runScheduledTaskNow: createEnvironmentRpcCommand(runtime, {
+      label: "environment-data:server:scheduled-task:run-now",
+      tag: WS_METHODS.scheduledTasksRunNow,
+    }),
     retryResourceTelemetry: createEnvironmentRpcCommand(runtime, {
       label: "environment-data:server:retry-resource-telemetry",
       tag: WS_METHODS.serverRetryResourceTelemetry,
diff --git a/packages/client-runtime/src/state/shell-sync.test.ts b/packages/client-runtime/src/state/shell-sync.test.ts
index 40e9bd80dc5b..f37f04de130c 100644
--- a/packages/client-runtime/src/state/shell-sync.test.ts
+++ b/packages/client-runtime/src/state/shell-sync.test.ts
@@ -1,14 +1,18 @@
 import {
   EnvironmentId,
-  ORCHESTRATION_WS_METHODS,
-  type OrchestrationShellSnapshot,
-  type OrchestrationShellStreamItem,
+  ORCHESTRATION_V2_WS_METHODS,
+  type OrchestrationV2ShellSnapshot,
+  type OrchestrationV2ShellStreamItem,
 } from "@t3tools/contracts";
 import { describe, expect, it } from "@effect/vitest";
+import * as Deferred from "effect/Deferred";
 import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as Fiber from "effect/Fiber";
 import * as Option from "effect/Option";
 import * as Queue from "effect/Queue";
 import * as Ref from "effect/Ref";
+import * as Scope from "effect/Scope";
 import * as Stream from "effect/Stream";
 import * as SubscriptionRef from "effect/SubscriptionRef";
 
@@ -23,6 +27,7 @@ import * as Persistence from "../platform/persistence.ts";
 import * as RpcSession from "../rpc/session.ts";
 import type { WsRpcProtocolClient } from "../rpc/protocol.ts";
 import { makeEnvironmentShellState, ShellSnapshotLoader } from "./shell.ts";
+import { v2Project, v2ShellSnapshot } from "./orchestrationV2TestFixtures.ts";
 
 const TARGET = new PrimaryConnectionTarget({
   environmentId: EnvironmentId.make("environment-1"),
@@ -40,11 +45,9 @@ const PREPARED: PreparedConnection = {
   target: TARGET,
 };
 
-const LIVE_SHELL_SNAPSHOT: OrchestrationShellSnapshot = {
+const LIVE_SHELL_SNAPSHOT: OrchestrationV2ShellSnapshot = {
+  ...v2ShellSnapshot,
   snapshotSequence: 1,
-  projects: [],
-  threads: [],
-  updatedAt: "2026-06-06T00:00:00.000Z",
 };
 
 function session(client: WsRpcProtocolClient): RpcSession.RpcSession {
@@ -60,9 +63,9 @@ function session(client: WsRpcProtocolClient): RpcSession.RpcSession {
 describe("environment shell synchronization", () => {
   it.effect("publishes live state before persistence and preserves it when ready", () =>
     Effect.gen(function* () {
-      const events = yield* Queue.unbounded<OrchestrationShellStreamItem>();
+      const events = yield* Queue.unbounded<OrchestrationV2ShellStreamItem>();
       const client = {
-        [ORCHESTRATION_WS_METHODS.subscribeShell]: () => Stream.fromQueue(events),
+        [ORCHESTRATION_V2_WS_METHODS.subscribeShell]: () => Stream.fromQueue(events),
       } as unknown as WsRpcProtocolClient;
       const supervisorState = yield* SubscriptionRef.make(AVAILABLE_CONNECTION_STATE);
       const activeSession = yield* SubscriptionRef.make<Option.Option<RpcSession.RpcSession>>(
@@ -79,7 +82,7 @@ describe("environment shell synchronization", () => {
       } satisfies EnvironmentSupervisor.EnvironmentSupervisor["Service"]);
       const cache = Persistence.EnvironmentCacheStore.of({
         loadShell: () => Effect.succeed(Option.none()),
-        saveShell: () => Effect.never,
+        saveShell: () => Effect.void,
         loadThread: () => Effect.succeed(Option.none()),
         saveThread: () => Effect.void,
         removeThread: () => Effect.void,
@@ -150,34 +153,30 @@ describe("environment shell synchronization", () => {
     }),
   );
 
-  it.effect("requests a full socket snapshot when the HTTP refresh fails", () =>
+  it.effect("refreshes a warm shell cache from HTTP before resuming", () =>
     Effect.gen(function* () {
-      const cachedSnapshot: OrchestrationShellSnapshot = {
+      const cachedSnapshot: OrchestrationV2ShellSnapshot = {
+        ...v2ShellSnapshot,
         snapshotSequence: 5,
-        projects: [],
-        threads: [{ id: "cached-thread" } as never],
-        updatedAt: "2026-06-06T00:00:00.000Z",
       };
-      const resetSnapshot: OrchestrationShellSnapshot = {
-        ...cachedSnapshot,
-        snapshotSequence: 9_999,
-        threads: [],
-        updatedAt: "2026-06-07T00:00:00.000Z",
+      const events = yield* Queue.unbounded<OrchestrationV2ShellStreamItem>();
+      const capturedAfterSequence = yield* SubscriptionRef.make<number | undefined>(undefined);
+      const capturedCompletionMarker = yield* Ref.make(false);
+      const loaderCalls = yield* SubscriptionRef.make(0);
+      const httpSnapshot: OrchestrationV2ShellSnapshot = {
+        ...v2ShellSnapshot,
+        snapshotSequence: 9,
       };
-      const events = yield* Queue.unbounded<OrchestrationShellStreamItem>();
-      const wakeups = yield* Queue.unbounded<ConnectionWakeups.ConnectionWakeup>();
-      const subscribeInputs = yield* Queue.unbounded<{
-        readonly afterSequence?: number;
-        readonly requestCompletionMarker?: boolean;
-      }>();
-      const loaderCalls = yield* Ref.make(0);
       const client = {
-        [ORCHESTRATION_WS_METHODS.subscribeShell]: (input: {
+        [ORCHESTRATION_V2_WS_METHODS.subscribeShell]: (input: {
           readonly afterSequence?: number;
-          readonly requestCompletionMarker?: boolean;
+          readonly requestCompletionMarker?: true;
         }) =>
           Stream.unwrap(
-            Queue.offer(subscribeInputs, input).pipe(Effect.as(Stream.fromQueue(events))),
+            Effect.all([
+              Ref.set(capturedCompletionMarker, input.requestCompletionMarker === true),
+              SubscriptionRef.set(capturedAfterSequence, input.afterSequence),
+            ]).pipe(Effect.as(Stream.fromQueue(events))),
           ),
       } as unknown as WsRpcProtocolClient;
       const supervisorState = yield* SubscriptionRef.make(AVAILABLE_CONNECTION_STATE);
@@ -208,53 +207,48 @@ describe("environment shell synchronization", () => {
         clear: () => Effect.void,
       });
       const snapshotLoader = ShellSnapshotLoader.of({
-        load: () => Ref.update(loaderCalls, (count) => count + 1).pipe(Effect.as(Option.none())),
+        load: () =>
+          SubscriptionRef.update(loaderCalls, (count) => count + 1).pipe(
+            Effect.as(Option.some(httpSnapshot)),
+          ),
       });
       const shellState = yield* makeEnvironmentShellState().pipe(
         Effect.provideService(EnvironmentSupervisor.EnvironmentSupervisor, supervisor),
         Effect.provideService(Persistence.EnvironmentCacheStore, cache),
         Effect.provideService(ShellSnapshotLoader, snapshotLoader),
-        Effect.provideService(
-          ConnectionWakeups.ConnectionWakeups,
-          ConnectionWakeups.ConnectionWakeups.of({ changes: Stream.fromQueue(wakeups) }),
-        ),
       );
 
-      const subscribeInput = yield* Queue.take(subscribeInputs);
-      expect(subscribeInput.afterSequence).toBeUndefined();
-      expect(subscribeInput.requestCompletionMarker).toBe(true);
-      expect(yield* Ref.get(loaderCalls)).toBe(1);
+      // Wait until the subscription is established from the warm cache.
+      yield* SubscriptionRef.changes(capturedAfterSequence).pipe(
+        Stream.filter((value) => value !== undefined),
+        Stream.runHead,
+      );
+
+      expect(yield* SubscriptionRef.get(capturedAfterSequence)).toBe(9);
+      expect(yield* Ref.get(capturedCompletionMarker)).toBe(true);
+      expect(yield* SubscriptionRef.get(loaderCalls)).toBe(1);
       const synchronizing = yield* SubscriptionRef.get(shellState);
       expect(synchronizing.status).toBe("synchronizing");
-      expect(Option.getOrThrow(synchronizing.snapshot)).toEqual(cachedSnapshot);
+      expect(Option.getOrThrow(synchronizing.snapshot)).toEqual(httpSnapshot);
 
-      yield* Queue.offer(events, { kind: "snapshot", snapshot: resetSnapshot });
       yield* Queue.offer(events, { kind: "synchronized" });
       yield* SubscriptionRef.changes(shellState).pipe(
         Stream.filter((value) => value.status === "live"),
         Stream.runHead,
       );
-
-      const live = yield* SubscriptionRef.get(shellState);
-      expect(Option.getOrThrow(live.snapshot)).toEqual(resetSnapshot);
-      expect(yield* Ref.get(loaderCalls)).toBe(1);
-
-      yield* Queue.offer(wakeups, "application-active");
-      const resumedInput = yield* Queue.take(subscribeInputs);
-      expect(resumedInput.afterSequence).toBe(resetSnapshot.snapshotSequence);
-      expect(resumedInput.requestCompletionMarker).toBe(true);
-      expect(yield* Ref.get(loaderCalls)).toBe(1);
     }),
   );
 
   it.effect("resubscribes from the in-memory shell cursor when the app becomes active", () =>
     Effect.gen(function* () {
-      const events = yield* Queue.unbounded<OrchestrationShellStreamItem>();
+      const events = yield* Queue.unbounded<OrchestrationV2ShellStreamItem>();
       const wakeups = yield* Queue.unbounded<ConnectionWakeups.ConnectionWakeup>();
       const loaderCalls = yield* Ref.make(0);
       const capturedAfterSequences = yield* Ref.make<ReadonlyArray<number | undefined>>([]);
       const client = {
-        [ORCHESTRATION_WS_METHODS.subscribeShell]: (input: { readonly afterSequence?: number }) =>
+        [ORCHESTRATION_V2_WS_METHODS.subscribeShell]: (input: {
+          readonly afterSequence?: number;
+        }) =>
           Stream.unwrap(
             Ref.update(capturedAfterSequences, (captured) => [
               ...captured,
@@ -263,7 +257,9 @@ describe("environment shell synchronization", () => {
           ),
       } as unknown as WsRpcProtocolClient;
       const supervisorState = yield* SubscriptionRef.make(AVAILABLE_CONNECTION_STATE);
-      const activeSession = yield* SubscriptionRef.make(Option.some(session(client)));
+      const activeSession = yield* SubscriptionRef.make<Option.Option<RpcSession.RpcSession>>(
+        Option.some(session(client)),
+      );
       const supervisor = EnvironmentSupervisor.EnvironmentSupervisor.of({
         target: TARGET,
         state: supervisorState,
@@ -361,4 +357,423 @@ describe("environment shell synchronization", () => {
       expect(yield* Ref.get(loaderCalls)).toBe(2);
     }),
   );
+
+  it.effect("flushes the latest live snapshot without blocking connection state updates", () =>
+    Effect.gen(function* () {
+      const events = yield* Queue.unbounded<OrchestrationV2ShellStreamItem>();
+      const saved = yield* Ref.make<ReadonlyArray<OrchestrationV2ShellSnapshot>>([]);
+      const saveStarted = yield* Deferred.make<void>();
+      const releaseSave = yield* Deferred.make<void>();
+      const client = {
+        [ORCHESTRATION_V2_WS_METHODS.subscribeShell]: () => Stream.fromQueue(events),
+      } as unknown as WsRpcProtocolClient;
+      const supervisorState = yield* SubscriptionRef.make(AVAILABLE_CONNECTION_STATE);
+      const activeSession = yield* SubscriptionRef.make<Option.Option<RpcSession.RpcSession>>(
+        Option.some(session(client)),
+      );
+      const supervisor = EnvironmentSupervisor.EnvironmentSupervisor.of({
+        target: TARGET,
+        state: supervisorState,
+        session: activeSession,
+        prepared: yield* SubscriptionRef.make(Option.some(PREPARED)),
+        connect: Effect.void,
+        disconnect: Effect.void,
+        retryNow: Effect.void,
+      } satisfies EnvironmentSupervisor.EnvironmentSupervisor["Service"]);
+      const cache = Persistence.EnvironmentCacheStore.of({
+        loadShell: () => Effect.succeed(Option.none()),
+        saveShell: (_environmentId, snapshot) =>
+          Deferred.succeed(saveStarted, undefined).pipe(
+            Effect.andThen(Deferred.await(releaseSave)),
+            Effect.andThen(Ref.update(saved, (values) => [...values, snapshot])),
+          ),
+        loadThread: () => Effect.succeed(Option.none()),
+        saveThread: () => Effect.void,
+        removeThread: () => Effect.void,
+        loadServerConfig: () => Effect.succeed(Option.none()),
+        saveServerConfig: () => Effect.void,
+        loadVcsRefs: () => Effect.succeed(Option.none()),
+        saveVcsRefs: () => Effect.void,
+        removeVcsRefs: () => Effect.void,
+        clearVcsRefs: () => Effect.void,
+        clear: () => Effect.void,
+      });
+      const snapshotLoader = ShellSnapshotLoader.of({
+        load: () => Effect.succeed(Option.none()),
+      });
+
+      const shellState = yield* makeEnvironmentShellState().pipe(
+        Effect.provideService(EnvironmentSupervisor.EnvironmentSupervisor, supervisor),
+        Effect.provideService(Persistence.EnvironmentCacheStore, cache),
+        Effect.provideService(ShellSnapshotLoader, snapshotLoader),
+      );
+
+      yield* SubscriptionRef.set(supervisorState, {
+        desired: true,
+        network: "online",
+        phase: "connecting",
+        stage: "synchronizing",
+        attempt: 1,
+        generation: 0,
+        lastFailure: null,
+        retryAt: null,
+      });
+      yield* Queue.offer(events, {
+        kind: "snapshot",
+        snapshot: LIVE_SHELL_SNAPSHOT,
+      });
+      yield* Queue.offer(events, { kind: "synchronized" });
+      yield* SubscriptionRef.changes(shellState).pipe(
+        Stream.filter((state) => state.status === "live"),
+        Stream.runHead,
+      );
+
+      yield* SubscriptionRef.set(supervisorState, {
+        desired: true,
+        network: "online",
+        phase: "connecting",
+        stage: "synchronizing",
+        attempt: 2,
+        generation: 1,
+        lastFailure: null,
+        retryAt: null,
+      });
+      yield* SubscriptionRef.set(supervisorState, {
+        desired: false,
+        network: "online",
+        phase: "available",
+        stage: null,
+        attempt: 2,
+        generation: 2,
+        lastFailure: null,
+        retryAt: null,
+      });
+      yield* Deferred.await(saveStarted);
+
+      yield* SubscriptionRef.set(supervisorState, {
+        desired: true,
+        network: "online",
+        phase: "connecting",
+        stage: "synchronizing",
+        attempt: 3,
+        generation: 3,
+        lastFailure: null,
+        retryAt: null,
+      });
+      for (let index = 0; index < 100; index += 1) {
+        if ((yield* SubscriptionRef.get(shellState)).status === "synchronizing") break;
+        yield* Effect.yieldNow;
+      }
+
+      expect((yield* SubscriptionRef.get(shellState)).status).toBe("synchronizing");
+      expect(yield* Ref.get(saved)).toEqual([]);
+
+      yield* Deferred.succeed(releaseSave, undefined);
+      for (let index = 0; index < 100; index += 1) {
+        if ((yield* Ref.get(saved)).length > 0) break;
+        yield* Effect.yieldNow;
+      }
+
+      expect(yield* Ref.get(saved)).toEqual([LIVE_SHELL_SNAPSHOT]);
+    }),
+  );
+
+  it.effect("re-persists same-sequence enrichment when an older in-flight save completes", () =>
+    Effect.gen(function* () {
+      const repositoryIdentity = {
+        canonicalKey: "github.com/example/repo",
+        locator: {
+          source: "git-remote" as const,
+          remoteName: "origin",
+          remoteUrl: "https://github.com/example/repo.git",
+        },
+      };
+      const unenrichedSnapshot: OrchestrationV2ShellSnapshot = {
+        ...LIVE_SHELL_SNAPSHOT,
+        snapshotSequence: 1,
+        projects: [{ ...v2Project, repositoryIdentity: null }],
+      };
+      const enrichedSnapshot: OrchestrationV2ShellSnapshot = {
+        ...LIVE_SHELL_SNAPSHOT,
+        snapshotSequence: 1,
+        projects: [{ ...v2Project, repositoryIdentity }],
+      };
+
+      const events = yield* Queue.unbounded<OrchestrationV2ShellStreamItem>();
+      const saved = yield* Ref.make<ReadonlyArray<OrchestrationV2ShellSnapshot>>([]);
+      const unenrichedSaveStarted = yield* Deferred.make<void>();
+      const releaseUnenrichedSave = yield* Deferred.make<void>();
+      const client = {
+        [ORCHESTRATION_V2_WS_METHODS.subscribeShell]: () => Stream.fromQueue(events),
+      } as unknown as WsRpcProtocolClient;
+      const supervisorState = yield* SubscriptionRef.make(AVAILABLE_CONNECTION_STATE);
+      const activeSession = yield* SubscriptionRef.make<Option.Option<RpcSession.RpcSession>>(
+        Option.some(session(client)),
+      );
+      const supervisor = EnvironmentSupervisor.EnvironmentSupervisor.of({
+        target: TARGET,
+        state: supervisorState,
+        session: activeSession,
+        prepared: yield* SubscriptionRef.make(Option.some(PREPARED)),
+        connect: Effect.void,
+        disconnect: Effect.void,
+        retryNow: Effect.void,
+      } satisfies EnvironmentSupervisor.EnvironmentSupervisor["Service"]);
+      const cache = Persistence.EnvironmentCacheStore.of({
+        loadShell: () => Effect.succeed(Option.none()),
+        saveShell: (_environmentId, snapshot) =>
+          Effect.gen(function* () {
+            if (snapshot.projects[0]?.repositoryIdentity == null) {
+              yield* Deferred.succeed(unenrichedSaveStarted, undefined);
+              yield* Deferred.await(releaseUnenrichedSave);
+            }
+            yield* Ref.update(saved, (values) => [...values, snapshot]);
+          }),
+        loadThread: () => Effect.succeed(Option.none()),
+        saveThread: () => Effect.void,
+        removeThread: () => Effect.void,
+        loadServerConfig: () => Effect.succeed(Option.none()),
+        saveServerConfig: () => Effect.void,
+        loadVcsRefs: () => Effect.succeed(Option.none()),
+        saveVcsRefs: () => Effect.void,
+        removeVcsRefs: () => Effect.void,
+        clearVcsRefs: () => Effect.void,
+        clear: () => Effect.void,
+      });
+      const snapshotLoader = ShellSnapshotLoader.of({
+        load: () => Effect.succeed(Option.none()),
+      });
+
+      const shellState = yield* makeEnvironmentShellState().pipe(
+        Effect.provideService(EnvironmentSupervisor.EnvironmentSupervisor, supervisor),
+        Effect.provideService(Persistence.EnvironmentCacheStore, cache),
+        Effect.provideService(ShellSnapshotLoader, snapshotLoader),
+      );
+
+      yield* SubscriptionRef.set(supervisorState, {
+        desired: true,
+        network: "online",
+        phase: "connecting",
+        stage: "synchronizing",
+        attempt: 1,
+        generation: 0,
+        lastFailure: null,
+        retryAt: null,
+      });
+      yield* Queue.offer(events, {
+        kind: "snapshot",
+        snapshot: unenrichedSnapshot,
+      });
+      yield* Queue.offer(events, { kind: "synchronized" });
+      yield* SubscriptionRef.changes(shellState).pipe(
+        Stream.filter((state) => state.status === "live"),
+        Stream.runHead,
+      );
+
+      // Disconnect flush starts an immediate persist of the unenriched snapshot
+      // (debounced path needs TestClock advancement; flush does not).
+      yield* SubscriptionRef.set(supervisorState, {
+        desired: false,
+        network: "online",
+        phase: "available",
+        stage: null,
+        attempt: 1,
+        generation: 1,
+        lastFailure: null,
+        retryAt: null,
+      });
+      yield* Deferred.await(unenrichedSaveStarted);
+
+      // Same sequence, different content. Session stays open so the stream can
+      // still apply enrichment while the older save is in flight.
+      yield* Queue.offer(events, {
+        kind: "snapshot",
+        snapshot: enrichedSnapshot,
+      });
+      yield* SubscriptionRef.changes(shellState).pipe(
+        Stream.filter(
+          (state) =>
+            Option.isSome(state.snapshot) &&
+            state.snapshot.value.projects[0]?.repositoryIdentity != null,
+        ),
+        Stream.runHead,
+      );
+
+      // Completing the older same-sequence save must re-persist the latest object.
+      yield* Deferred.succeed(releaseUnenrichedSave, undefined);
+      for (let index = 0; index < 100; index += 1) {
+        const values = yield* Ref.get(saved);
+        if (values.length > 0 && values.at(-1)?.projects[0]?.repositoryIdentity != null) {
+          break;
+        }
+        yield* Effect.yieldNow;
+      }
+
+      const finalSaved = (yield* Ref.get(saved)).at(-1);
+      expect(finalSaved?.snapshotSequence).toBe(1);
+      expect(finalSaved?.projects[0]?.repositoryIdentity).toEqual(repositoryIdentity);
+    }),
+  );
+
+  it.effect("scope teardown flush stays stable while a save is blocked", () =>
+    Effect.gen(function* () {
+      const lateSnapshot: OrchestrationV2ShellSnapshot = {
+        ...LIVE_SHELL_SNAPSHOT,
+        snapshotSequence: 2,
+        projects: [{ ...v2Project, title: "Late stream event" }],
+      };
+      const events = yield* Queue.unbounded<OrchestrationV2ShellStreamItem>();
+      const saved = yield* Ref.make<ReadonlyArray<OrchestrationV2ShellSnapshot>>([]);
+      const saveStarted = yield* Deferred.make<void>();
+      const releaseSave = yield* Deferred.make<void>();
+      const client = {
+        [ORCHESTRATION_V2_WS_METHODS.subscribeShell]: () => Stream.fromQueue(events),
+      } as unknown as WsRpcProtocolClient;
+      const supervisorState = yield* SubscriptionRef.make(AVAILABLE_CONNECTION_STATE);
+      const activeSession = yield* SubscriptionRef.make<Option.Option<RpcSession.RpcSession>>(
+        Option.some(session(client)),
+      );
+      const supervisor = EnvironmentSupervisor.EnvironmentSupervisor.of({
+        target: TARGET,
+        state: supervisorState,
+        session: activeSession,
+        prepared: yield* SubscriptionRef.make(Option.some(PREPARED)),
+        connect: Effect.void,
+        disconnect: Effect.void,
+        retryNow: Effect.void,
+      } satisfies EnvironmentSupervisor.EnvironmentSupervisor["Service"]);
+      const cache = Persistence.EnvironmentCacheStore.of({
+        loadShell: () => Effect.succeed(Option.none()),
+        saveShell: (_environmentId, snapshot) =>
+          Deferred.succeed(saveStarted, undefined).pipe(
+            Effect.andThen(Deferred.await(releaseSave)),
+            Effect.andThen(Ref.update(saved, (values) => [...values, snapshot])),
+          ),
+        loadThread: () => Effect.succeed(Option.none()),
+        saveThread: () => Effect.void,
+        removeThread: () => Effect.void,
+        loadServerConfig: () => Effect.succeed(Option.none()),
+        saveServerConfig: () => Effect.void,
+        loadVcsRefs: () => Effect.succeed(Option.none()),
+        saveVcsRefs: () => Effect.void,
+        removeVcsRefs: () => Effect.void,
+        clearVcsRefs: () => Effect.void,
+        clear: () => Effect.void,
+      });
+      const snapshotLoader = ShellSnapshotLoader.of({
+        load: () => Effect.succeed(Option.none()),
+      });
+
+      const scope = yield* Scope.make();
+      const shellState = yield* makeEnvironmentShellState().pipe(
+        Effect.provideService(EnvironmentSupervisor.EnvironmentSupervisor, supervisor),
+        Effect.provideService(Persistence.EnvironmentCacheStore, cache),
+        Effect.provideService(ShellSnapshotLoader, snapshotLoader),
+        Scope.provide(scope),
+      );
+
+      yield* SubscriptionRef.set(supervisorState, {
+        desired: true,
+        network: "online",
+        phase: "connecting",
+        stage: "synchronizing",
+        attempt: 1,
+        generation: 0,
+        lastFailure: null,
+        retryAt: null,
+      });
+      yield* Queue.offer(events, {
+        kind: "snapshot",
+        snapshot: LIVE_SHELL_SNAPSHOT,
+      });
+      yield* Queue.offer(events, { kind: "synchronized" });
+      yield* SubscriptionRef.changes(shellState).pipe(
+        Stream.filter((state) => state.status === "live"),
+        Stream.runHead,
+      );
+
+      // Close scope so the finalizer flush blocks on save. Workers must be
+      // interrupted before that flush; late stream events must not extend it.
+      const closeFiber = yield* Effect.forkChild(Scope.close(scope, Exit.void));
+      yield* Deferred.await(saveStarted);
+      yield* Queue.offer(events, {
+        kind: "snapshot",
+        snapshot: lateSnapshot,
+      });
+      for (let index = 0; index < 50; index += 1) {
+        yield* Effect.yieldNow;
+      }
+      yield* Deferred.succeed(releaseSave, undefined);
+      yield* Fiber.join(closeFiber);
+
+      const values = yield* Ref.get(saved);
+      expect(values.length).toBeGreaterThan(0);
+      expect(values.every((snapshot) => snapshot.snapshotSequence === 1)).toBe(true);
+      expect(values.every((snapshot) => snapshot.projects[0]?.title !== "Late stream event")).toBe(
+        true,
+      );
+    }),
+  );
+
+  it.effect("applies authoritative lower-sequence HTTP resets over client-ahead cache", () =>
+    Effect.gen(function* () {
+      const cachedSnapshot: OrchestrationV2ShellSnapshot = {
+        ...v2ShellSnapshot,
+        snapshotSequence: 20,
+        projects: [{ ...v2Project, title: "Client ahead" }],
+      };
+      const httpSnapshot: OrchestrationV2ShellSnapshot = {
+        ...v2ShellSnapshot,
+        snapshotSequence: 4,
+        projects: [{ ...v2Project, title: "Server reset" }],
+      };
+      const events = yield* Queue.unbounded<OrchestrationV2ShellStreamItem>();
+      const client = {
+        [ORCHESTRATION_V2_WS_METHODS.subscribeShell]: () => Stream.fromQueue(events),
+      } as unknown as WsRpcProtocolClient;
+      const supervisorState = yield* SubscriptionRef.make(AVAILABLE_CONNECTION_STATE);
+      const supervisor = EnvironmentSupervisor.EnvironmentSupervisor.of({
+        target: TARGET,
+        state: supervisorState,
+        session: yield* SubscriptionRef.make(Option.some(session(client))),
+        prepared: yield* SubscriptionRef.make(Option.some(PREPARED)),
+        connect: Effect.void,
+        disconnect: Effect.void,
+        retryNow: Effect.void,
+      } satisfies EnvironmentSupervisor.EnvironmentSupervisor["Service"]);
+      const cache = Persistence.EnvironmentCacheStore.of({
+        loadShell: () => Effect.succeed(Option.some(cachedSnapshot)),
+        saveShell: () => Effect.void,
+        loadThread: () => Effect.succeed(Option.none()),
+        saveThread: () => Effect.void,
+        removeThread: () => Effect.void,
+        loadServerConfig: () => Effect.succeed(Option.none()),
+        saveServerConfig: () => Effect.void,
+        loadVcsRefs: () => Effect.succeed(Option.none()),
+        saveVcsRefs: () => Effect.void,
+        removeVcsRefs: () => Effect.void,
+        clearVcsRefs: () => Effect.void,
+        clear: () => Effect.void,
+      });
+      const snapshotLoader = ShellSnapshotLoader.of({
+        load: () => Effect.succeed(Option.some(httpSnapshot)),
+      });
+      const shellState = yield* makeEnvironmentShellState().pipe(
+        Effect.provideService(EnvironmentSupervisor.EnvironmentSupervisor, supervisor),
+        Effect.provideService(Persistence.EnvironmentCacheStore, cache),
+        Effect.provideService(ShellSnapshotLoader, snapshotLoader),
+      );
+
+      yield* SubscriptionRef.changes(shellState).pipe(
+        Stream.filter(
+          (state) => Option.isSome(state.snapshot) && state.snapshot.value.snapshotSequence === 4,
+        ),
+        Stream.runHead,
+      );
+
+      const state = yield* SubscriptionRef.get(shellState);
+      expect(Option.getOrThrow(state.snapshot).snapshotSequence).toBe(4);
+      expect(Option.getOrThrow(state.snapshot).projects[0]?.title).toBe("Server reset");
+    }),
+  );
 });
diff --git a/packages/client-runtime/src/state/shell.test.ts b/packages/client-runtime/src/state/shell.test.ts
index f1326e0a5cbe..90ee256c8ee0 100644
--- a/packages/client-runtime/src/state/shell.test.ts
+++ b/packages/client-runtime/src/state/shell.test.ts
@@ -2,11 +2,13 @@ import type { ServerConfig } from "@t3tools/contracts";
 import { EnvironmentId } from "@t3tools/contracts";
 import { describe, expect, it } from "@effect/vitest";
 import * as Option from "effect/Option";
+import * as DateTime from "effect/DateTime";
 import { Atom, AtomRegistry } from "effect/unstable/reactivity";
 
 import { PrimaryConnectionTarget } from "../connection/model.ts";
 import type { EnvironmentShellState } from "./shell.ts";
 import { createEnvironmentServerConfigsAtom, createEnvironmentShellSummaryAtom } from "./shell.ts";
+import { v2ThreadShell } from "./orchestrationV2TestFixtures.ts";
 
 const ENVIRONMENT_ID = EnvironmentId.make("environment-1");
 const OTHER_ENVIRONMENT_ID = EnvironmentId.make("environment-2");
@@ -34,10 +36,16 @@ function shellState(input: {
       input.updatedAt === undefined
         ? Option.none()
         : Option.some({
+            schemaVersion: 1,
             snapshotSequence: input.snapshotSequence ?? 1,
-            updatedAt: input.updatedAt,
             projects: [],
-            threads: [],
+            threads: [
+              {
+                ...v2ThreadShell,
+                updatedAt: DateTime.makeUnsafe(input.updatedAt),
+              },
+            ],
+            archivedThreads: [],
           }),
     status: input.status,
     error: input.error === undefined ? Option.none() : Option.some(input.error),
diff --git a/packages/client-runtime/src/state/shell.ts b/packages/client-runtime/src/state/shell.ts
index c150bbb75b8c..7f38cfad03ed 100644
--- a/packages/client-runtime/src/state/shell.ts
+++ b/packages/client-runtime/src/state/shell.ts
@@ -1,11 +1,12 @@
 import {
-  ORCHESTRATION_WS_METHODS,
+  ORCHESTRATION_V2_WS_METHODS,
   type EnvironmentId,
-  type OrchestrationShellSnapshot,
-  type OrchestrationShellStreamItem,
+  type OrchestrationV2ShellSnapshot,
+  type OrchestrationV2ShellStreamItem,
   type ServerConfig,
 } from "@t3tools/contracts";
 import * as Cause from "effect/Cause";
+import * as DateTime from "effect/DateTime";
 import * as Effect from "effect/Effect";
 import * as Option from "effect/Option";
 import * as Queue from "effect/Queue";
@@ -23,14 +24,14 @@ import { EnvironmentCacheStore } from "../platform/persistence.ts";
 import { subscribeDynamic } from "../rpc/client.ts";
 import type { RpcSession } from "../rpc/session.ts";
 import { ShellSnapshotLoader } from "./shellSnapshotHttp.ts";
-import { applyShellStreamEvent } from "./shellReducer.ts";
+import { applyShellStreamEvent, mergeShellSnapshotProjects } from "./shellReducer.ts";
 import type { EnvironmentCatalogState } from "./connections.ts";
 import { followStreamInEnvironment } from "./runtime.ts";
 
 export type EnvironmentShellStatus = "empty" | "cached" | "synchronizing" | "live";
 
 export interface EnvironmentShellState {
-  readonly snapshot: Option.Option<OrchestrationShellSnapshot>;
+  readonly snapshot: Option.Option<OrchestrationV2ShellSnapshot>;
   readonly status: EnvironmentShellStatus;
   readonly error: Option.Option<string>;
 }
@@ -42,7 +43,7 @@ const EMPTY_SHELL_STATE: EnvironmentShellState = {
 };
 
 function shellStatusForSnapshot(
-  snapshot: Option.Option<OrchestrationShellSnapshot>,
+  snapshot: Option.Option<OrchestrationV2ShellSnapshot>,
 ): EnvironmentShellStatus {
   return Option.isSome(snapshot) ? "cached" : "empty";
 }
@@ -62,7 +63,7 @@ export const makeEnvironmentShellState = Effect.fn("EnvironmentShellState.make")
           environmentId,
           ...safeErrorLogAttributes(error),
         }),
-        Effect.as(Option.none<OrchestrationShellSnapshot>()),
+        Effect.as(Option.none<OrchestrationV2ShellSnapshot>()),
       ),
     ),
   );
@@ -74,23 +75,48 @@ export const makeEnvironmentShellState = Effect.fn("EnvironmentShellState.make")
   const awaitingCompletion = yield* Ref.make(false);
   const lastAuthoritativeSession = yield* Ref.make<RpcSession | null>(null);
   const activeSubscriptionSession = yield* Ref.make<RpcSession | null>(null);
-  const persistence = yield* Queue.sliding<OrchestrationShellSnapshot>(1);
+  const latestLiveSnapshot = yield* Ref.make<Option.Option<OrchestrationV2ShellSnapshot>>(
+    Option.none(),
+  );
+  const persistence = yield* Queue.sliding<OrchestrationV2ShellSnapshot>(1);
 
   const persist = Effect.fn("EnvironmentShellState.persist")(function* (
-    snapshot: OrchestrationShellSnapshot,
+    snapshot: OrchestrationV2ShellSnapshot,
   ) {
-    yield* cache.saveShell(environmentId, snapshot).pipe(
-      Effect.catch((error) =>
-        Effect.logWarning("Could not persist environment shell cache.").pipe(
-          Effect.annotateLogs({
-            environmentId,
-            ...safeErrorLogAttributes(error),
-          }),
+    let nextSnapshot = snapshot;
+    while (true) {
+      yield* cache.saveShell(environmentId, nextSnapshot).pipe(
+        Effect.catch((error) =>
+          Effect.logWarning("Could not persist environment shell cache.").pipe(
+            Effect.annotateLogs({
+              environmentId,
+              ...safeErrorLogAttributes(error),
+            }),
+          ),
         ),
-      ),
-    );
+      );
+
+      const latestSnapshot = yield* Ref.get(latestLiveSnapshot);
+      // Same sequence can still mean newer content (e.g. repository enrichment).
+      if (Option.isNone(latestSnapshot) || latestSnapshot.value === nextSnapshot) {
+        return;
+      }
+      nextSnapshot = latestSnapshot.value;
+    }
   });
 
+  const flushLiveShellSnapshot = Effect.gen(function* () {
+    const snapshot = yield* Ref.get(latestLiveSnapshot);
+    if (Option.isNone(snapshot)) {
+      return;
+    }
+    yield* persist(snapshot.value);
+  });
+
+  // Register before scoped worker fibers so reverse finalizer order interrupts
+  // those fibers first and this flush sees a stable latestLiveSnapshot.
+  yield* Effect.addFinalizer(() => flushLiveShellSnapshot);
+
   yield* Stream.fromQueue(persistence).pipe(
     Stream.debounce("500 millis"),
     Stream.runForEach(persist),
@@ -104,6 +130,8 @@ export const makeEnvironmentShellState = Effect.fn("EnvironmentShellState.make")
         status: shellStatusForSnapshot(current.snapshot),
       })),
     ),
+    Effect.andThen(flushLiveShellSnapshot.pipe(Effect.forkScoped)),
+    Effect.asVoid,
   );
   const setSynchronizing = SubscriptionRef.update(state, (current) => ({
     ...current,
@@ -136,7 +164,7 @@ export const makeEnvironmentShellState = Effect.fn("EnvironmentShellState.make")
     );
 
   const applyItem = Effect.fn("EnvironmentShellState.applyItem")(function* (
-    item: OrchestrationShellStreamItem,
+    item: OrchestrationV2ShellStreamItem,
   ) {
     if (item.kind === "synchronized") {
       yield* Ref.set(awaitingCompletion, false);
@@ -151,7 +179,15 @@ export const makeEnvironmentShellState = Effect.fn("EnvironmentShellState.make")
     const current = yield* SubscriptionRef.get(state);
     const nextSnapshot =
       item.kind === "snapshot"
-        ? item.snapshot
+        ? mergeShellSnapshotProjects(
+            Option.getOrNull(current.snapshot),
+            item.snapshot,
+            item.resolvedRepositoryIdentityRoots === undefined
+              ? undefined
+              : {
+                  resolvedRepositoryIdentityRoots: item.resolvedRepositoryIdentityRoots,
+                },
+          )
         : Option.match(current.snapshot, {
             onNone: () => null,
             onSome: (snapshot) =>
@@ -163,6 +199,7 @@ export const makeEnvironmentShellState = Effect.fn("EnvironmentShellState.make")
       return;
     }
 
+    yield* Ref.set(latestLiveSnapshot, Option.some(nextSnapshot));
     const waiting = yield* Ref.get(awaitingCompletion);
     yield* SubscriptionRef.set(state, {
       snapshot: Option.some(nextSnapshot),
@@ -187,7 +224,7 @@ export const makeEnvironmentShellState = Effect.fn("EnvironmentShellState.make")
   yield* setSynchronizing;
   yield* Effect.forkScoped(
     subscribeDynamic(
-      ORCHESTRATION_WS_METHODS.subscribeShell,
+      ORCHESTRATION_V2_WS_METHODS.subscribeShell,
       Effect.fn("EnvironmentShellState.makeSubscribeInput")(function* (session) {
         yield* Ref.set(activeSubscriptionSession, session);
         const supportsCompletionMarker = yield* session.initialConfig.pipe(
@@ -347,8 +384,20 @@ export function createEnvironmentShellSummaryAtom(input: {
         continue;
       }
       hasSnapshot = true;
-      const updatedAt = state.snapshot.value.updatedAt;
-      if (latestSnapshotUpdatedAt === null || updatedAt > latestSnapshotUpdatedAt) {
+      const snapshot = state.snapshot.value;
+      const updatedAt = snapshot.threads.concat(snapshot.archivedThreads).reduce<string | null>(
+        (latest, thread) => {
+          const value = DateTime.formatIso(thread.updatedAt);
+          return latest === null || value > latest ? value : latest;
+        },
+        snapshot.projects.reduce<string | null>((latest, project) => {
+          return latest === null || project.updatedAt > latest ? project.updatedAt : latest;
+        }, null),
+      );
+      if (
+        updatedAt !== null &&
+        (latestSnapshotUpdatedAt === null || updatedAt > latestSnapshotUpdatedAt)
+      ) {
         latestSnapshotUpdatedAt = updatedAt;
       }
     }
diff --git a/packages/client-runtime/src/state/shellReducer.test.ts b/packages/client-runtime/src/state/shellReducer.test.ts
index fdccc4c47dd8..2527aca1cac2 100644
--- a/packages/client-runtime/src/state/shellReducer.test.ts
+++ b/packages/client-runtime/src/state/shellReducer.test.ts
@@ -1,185 +1,432 @@
+import { ProjectId, ThreadId } from "@t3tools/contracts";
 import { describe, expect, it } from "vite-plus/test";
 
-import { ProjectId, ProviderInstanceId, ThreadId } from "@t3tools/contracts";
-import type { OrchestrationShellSnapshot, OrchestrationShellStreamEvent } from "@t3tools/contracts";
+import { v2Project, v2ShellSnapshot, v2ThreadShell } from "./orchestrationV2TestFixtures.ts";
+import { applyShellStreamEvent, mergeShellSnapshotProjects } from "./shellReducer.ts";
 
-import { applyShellStreamEvent } from "./shellReducer.ts";
-
-const baseSnapshot: OrchestrationShellSnapshot = {
-  snapshotSequence: 0,
-  projects: [],
-  threads: [],
-  updatedAt: "2026-04-01T00:00:00.000Z",
+const repositoryIdentity = {
+  canonicalKey: "github.com/example/repo",
+  locator: {
+    source: "git-remote" as const,
+    remoteName: "origin",
+    remoteUrl: "https://github.com/example/repo.git",
+  },
 };
 
-const stubProject = {
-  id: ProjectId.make("project-1"),
-  title: "Test Project",
-  workspaceRoot: "/workspace/test",
-  repositoryIdentity: null,
-  defaultModelSelection: null,
-  scripts: [],
-  createdAt: "2026-04-01T00:00:00.000Z",
-  updatedAt: "2026-04-01T00:00:00.000Z",
-} as const;
-
-const stubThread = {
-  id: ThreadId.make("thread-1"),
-  projectId: ProjectId.make("project-1"),
-  title: "Test Thread",
-  modelSelection: { instanceId: ProviderInstanceId.make("codex"), model: "gpt-5.4" },
-  runtimeMode: "full-access" as const,
-  interactionMode: "default" as const,
-  branch: null,
-  worktreePath: null,
-  latestTurn: null,
-  createdAt: "2026-04-01T00:00:00.000Z",
-  updatedAt: "2026-04-01T00:00:00.000Z",
-  archivedAt: null,
-  settledOverride: null,
-  settledAt: null,
-  latestUserMessageAt: null,
-  hasPendingApprovals: false,
-  hasPendingUserInput: false,
-  hasActionableProposedPlan: false,
-  session: null,
-} as const;
+const otherIdentity = {
+  canonicalKey: "github.com/example/other",
+  locator: {
+    source: "git-remote" as const,
+    remoteName: "origin",
+    remoteUrl: "https://github.com/example/other.git",
+  },
+};
 
 describe("applyShellStreamEvent", () => {
-  it("ignores stale project upserts without mutating the snapshot", () => {
-    const snapshotWithProject: OrchestrationShellSnapshot = {
-      ...baseSnapshot,
+  it("ignores stale project updates without mutating the snapshot", () => {
+    const snapshotWithProject = {
+      ...v2ShellSnapshot,
       snapshotSequence: 4,
-      projects: [stubProject],
+      projects: [v2Project],
     };
 
     for (const sequence of [3, 4]) {
       const next = applyShellStreamEvent(snapshotWithProject, {
-        kind: "project-upserted",
+        kind: "project.updated",
         sequence,
-        project: { ...stubProject, title: "Stale Title" },
+        project: { ...v2Project, title: "Stale Title" },
       });
 
       expect(next).toBe(snapshotWithProject);
       expect(next.snapshotSequence).toBe(4);
-      expect(next.projects[0]?.title).toBe("Test Project");
+      expect(next.projects[0]?.title).toBe(v2Project.title);
     }
   });
 
-  describe("project-upserted", () => {
-    it("adds a new project", () => {
-      const event: OrchestrationShellStreamEvent = {
-        kind: "project-upserted",
-        sequence: 1,
-        project: stubProject,
-      };
+  it("applies project updates and removals", () => {
+    const updated = applyShellStreamEvent(v2ShellSnapshot, {
+      kind: "project.updated",
+      sequence: 1,
+      project: { ...v2Project, title: "Updated" },
+    });
+    expect(updated.projects[0]?.title).toBe("Updated");
+    expect(updated.snapshotSequence).toBe(1);
 
-      const next = applyShellStreamEvent(baseSnapshot, event);
+    const removed = applyShellStreamEvent(updated, {
+      kind: "project.removed",
+      sequence: 2,
+      projectId: ProjectId.make(v2Project.id),
+    });
+    expect(removed.projects).toEqual([]);
+  });
 
-      expect(next.projects).toHaveLength(1);
-      expect(next.projects[0]?.id).toBe("project-1");
-      expect(next.snapshotSequence).toBe(1);
+  it("keeps prior repositoryIdentity when a delta arrives with null identity", () => {
+    const withIdentity = applyShellStreamEvent(v2ShellSnapshot, {
+      kind: "project.updated",
+      sequence: 1,
+      project: { ...v2Project, repositoryIdentity },
     });
+    expect(withIdentity.projects[0]?.repositoryIdentity).toEqual(repositoryIdentity);
 
-    it("updates an existing project", () => {
-      const snapshotWithProject: OrchestrationShellSnapshot = {
-        ...baseSnapshot,
-        projects: [stubProject],
-      };
+    const withoutIdentity = applyShellStreamEvent(withIdentity, {
+      kind: "project.updated",
+      sequence: 2,
+      project: { ...v2Project, title: "Still same root", repositoryIdentity: null },
+    });
+    expect(withoutIdentity.projects[0]?.title).toBe("Still same root");
+    expect(withoutIdentity.projects[0]?.repositoryIdentity).toEqual(repositoryIdentity);
+  });
 
-      const updatedProject = { ...stubProject, title: "Updated Title" };
-      const event: OrchestrationShellStreamEvent = {
-        kind: "project-upserted",
-        sequence: 2,
-        project: updatedProject,
-      };
+  it("does not keep prior repositoryIdentity after a workspace root move", () => {
+    const withIdentity = applyShellStreamEvent(v2ShellSnapshot, {
+      kind: "project.updated",
+      sequence: 1,
+      project: { ...v2Project, repositoryIdentity },
+    });
 
-      const next = applyShellStreamEvent(snapshotWithProject, event);
+    const moved = applyShellStreamEvent(withIdentity, {
+      kind: "project.updated",
+      sequence: 2,
+      project: {
+        ...v2Project,
+        workspaceRoot: "/tmp/other-root",
+        repositoryIdentity: null,
+      },
+    });
+    expect(moved.projects[0]?.workspaceRoot).toBe("/tmp/other-root");
+    expect(moved.projects[0]?.repositoryIdentity).toBeNull();
+  });
 
-      expect(next.projects).toHaveLength(1);
-      expect(next.projects[0]?.title).toBe("Updated Title");
-      expect(next.snapshotSequence).toBe(2);
+  it("merges full snapshot projects without dropping known repositoryIdentity", () => {
+    const previous = {
+      ...v2ShellSnapshot,
+      projects: [{ ...v2Project, repositoryIdentity }],
+    };
+    const next = mergeShellSnapshotProjects(previous, {
+      ...v2ShellSnapshot,
+      snapshotSequence: 2,
+      projects: [{ ...v2Project, title: "Refreshed", repositoryIdentity: null }],
     });
+    expect(next.projects[0]?.title).toBe("Refreshed");
+    expect(next.projects[0]?.repositoryIdentity).toEqual(repositoryIdentity);
   });
 
-  describe("project-removed", () => {
-    it("removes a project by id", () => {
-      const snapshotWithProject: OrchestrationShellSnapshot = {
-        ...baseSnapshot,
-        projects: [stubProject],
-      };
+  it("authoritative lower-sequence reset replaces client-ahead structural state", () => {
+    const previous = {
+      ...v2ShellSnapshot,
+      snapshotSequence: 9,
+      projects: [{ ...v2Project, title: "Client ahead", repositoryIdentity }],
+      threads: [{ ...v2ThreadShell, title: "Local-only thread" }],
+    };
+    const next = mergeShellSnapshotProjects(previous, {
+      ...v2ShellSnapshot,
+      snapshotSequence: 3,
+      projects: [{ ...v2Project, title: "Server reset", repositoryIdentity: null }],
+      threads: [{ ...v2ThreadShell, title: "Server thread" }],
+    });
 
-      const event: OrchestrationShellStreamEvent = {
-        kind: "project-removed",
-        sequence: 3,
-        projectId: ProjectId.make("project-1"),
-      };
+    expect(next.snapshotSequence).toBe(3);
+    expect(next.projects[0]?.title).toBe("Server reset");
+    expect(next.projects[0]?.repositoryIdentity).toEqual(repositoryIdentity);
+    expect(next.threads[0]?.title).toBe("Server thread");
+  });
 
-      const next = applyShellStreamEvent(snapshotWithProject, event);
+  it("client-ahead survives lower marked enrichment then still resets on unmarked authoritative", () => {
+    const previous = {
+      ...v2ShellSnapshot,
+      snapshotSequence: 20,
+      projects: [{ ...v2Project, title: "Client ahead", repositoryIdentity }],
+      threads: [{ ...v2ThreadShell, title: "Local-only thread" }],
+    };
+    const serverSnapshot = {
+      ...v2ShellSnapshot,
+      snapshotSequence: 3,
+      projects: [{ ...v2Project, title: "Server reset", repositoryIdentity: null }],
+      threads: [{ ...v2ThreadShell, title: "Server thread" }],
+    };
 
-      expect(next.projects).toHaveLength(0);
-      expect(next.snapshotSequence).toBe(3);
+    // Lower-sequence marked enrichment is identity-only and must not replace structure.
+    const afterEnrichment = mergeShellSnapshotProjects(previous, serverSnapshot, {
+      resolvedRepositoryIdentityRoots: [v2Project.workspaceRoot],
     });
+    expect(afterEnrichment.snapshotSequence).toBe(20);
+    expect(afterEnrichment.projects[0]?.title).toBe("Client ahead");
+    expect(afterEnrichment.projects[0]?.repositoryIdentity).toBeNull();
+    expect(afterEnrichment.threads[0]?.title).toBe("Local-only thread");
+
+    // Unmarked authoritative at the same lower sequence still performs the reset.
+    const afterAuthoritative = mergeShellSnapshotProjects(afterEnrichment, serverSnapshot);
+    expect(afterAuthoritative.snapshotSequence).toBe(3);
+    expect(afterAuthoritative.projects[0]?.title).toBe("Server reset");
+    expect(afterAuthoritative.projects[0]?.repositoryIdentity).toBeNull();
+    expect(afterAuthoritative.threads[0]?.title).toBe("Server thread");
   });
 
-  describe("thread-upserted", () => {
-    it("adds a new thread", () => {
-      const event: OrchestrationShellStreamEvent = {
-        kind: "thread-upserted",
-        sequence: 4,
-        thread: stubThread,
-      };
+  it("authoritative null retains identity then same-sequence marked enrichment clears it", () => {
+    const previous = {
+      ...v2ShellSnapshot,
+      snapshotSequence: 9,
+      projects: [{ ...v2Project, title: "Client ahead", repositoryIdentity }],
+      threads: [{ ...v2ThreadShell, title: "Local-only thread" }],
+    };
+    const serverSnapshot = {
+      ...v2ShellSnapshot,
+      snapshotSequence: 3,
+      projects: [{ ...v2Project, title: "Server reset", repositoryIdentity: null }],
+      threads: [{ ...v2ThreadShell, title: "Server thread" }],
+    };
 
-      const next = applyShellStreamEvent(baseSnapshot, event);
+    const afterAuthoritative = mergeShellSnapshotProjects(previous, serverSnapshot);
+    expect(afterAuthoritative.snapshotSequence).toBe(3);
+    expect(afterAuthoritative.projects[0]?.title).toBe("Server reset");
+    expect(afterAuthoritative.projects[0]?.repositoryIdentity).toEqual(repositoryIdentity);
+    expect(afterAuthoritative.threads[0]?.title).toBe("Server thread");
 
-      expect(next.threads).toHaveLength(1);
-      expect(next.threads[0]?.id).toBe("thread-1");
-      expect(next.snapshotSequence).toBe(4);
+    const afterEnrichment = mergeShellSnapshotProjects(afterAuthoritative, serverSnapshot, {
+      resolvedRepositoryIdentityRoots: [v2Project.workspaceRoot],
     });
+    expect(afterEnrichment.snapshotSequence).toBe(3);
+    expect(afterEnrichment.projects[0]?.title).toBe("Server reset");
+    expect(afterEnrichment.projects[0]?.repositoryIdentity).toBeNull();
+    expect(afterEnrichment.threads[0]?.title).toBe("Server thread");
+  });
 
-    it("updates an existing thread", () => {
-      const snapshotWithThread: OrchestrationShellSnapshot = {
-        ...baseSnapshot,
-        threads: [stubThread],
-      };
+  it("takes identity from a lower-sequence enrichment without reverting live thread state", () => {
+    const previous = {
+      ...v2ShellSnapshot,
+      snapshotSequence: 5,
+      projects: [{ ...v2Project, repositoryIdentity: null }],
+      threads: [{ ...v2ThreadShell, title: "Newest title" }],
+    };
+    const next = mergeShellSnapshotProjects(
+      previous,
+      {
+        ...v2ShellSnapshot,
+        snapshotSequence: 4,
+        projects: [{ ...v2Project, repositoryIdentity }],
+        threads: [{ ...v2ThreadShell, title: "Stale title" }],
+      },
+      { resolvedRepositoryIdentityRoots: [v2Project.workspaceRoot] },
+    );
 
-      const updatedThread = { ...stubThread, title: "Updated Thread" };
-      const event: OrchestrationShellStreamEvent = {
-        kind: "thread-upserted",
-        sequence: 5,
-        thread: updatedThread,
-      };
+    expect(next.snapshotSequence).toBe(5);
+    expect(next.threads[0]?.title).toBe("Newest title");
+    expect(next.projects[0]?.repositoryIdentity).toEqual(repositoryIdentity);
+  });
 
-      const next = applyShellStreamEvent(snapshotWithThread, event);
+  it("treats higher-sequence compact enrichment as metadata-only", () => {
+    const previous = {
+      ...v2ShellSnapshot,
+      snapshotSequence: 5,
+      projects: [{ ...v2Project, repositoryIdentity: null }],
+      threads: [{ ...v2ThreadShell, title: "Newest title" }],
+    };
+    const next = mergeShellSnapshotProjects(
+      previous,
+      {
+        ...v2ShellSnapshot,
+        snapshotSequence: 8,
+        projects: [{ ...v2Project, repositoryIdentity }],
+        threads: [],
+        archivedThreads: [],
+      },
+      { resolvedRepositoryIdentityRoots: [v2Project.workspaceRoot] },
+    );
 
-      expect(next.threads).toHaveLength(1);
-      expect(next.threads[0]?.title).toBe("Updated Thread");
-    });
+    expect(next.snapshotSequence).toBe(5);
+    expect(next.threads[0]?.title).toBe("Newest title");
+    expect(next.projects[0]?.repositoryIdentity).toEqual(repositoryIdentity);
+  });
+
+  it("lower-sequence enrichment cannot resurrect empty structural state", () => {
+    const previous = {
+      ...v2ShellSnapshot,
+      snapshotSequence: 7,
+      projects: [],
+      threads: [],
+      archivedThreads: [],
+    };
+    const next = mergeShellSnapshotProjects(
+      previous,
+      {
+        ...v2ShellSnapshot,
+        snapshotSequence: 4,
+        projects: [{ ...v2Project, repositoryIdentity }],
+        threads: [v2ThreadShell],
+      },
+      { resolvedRepositoryIdentityRoots: [v2Project.workspaceRoot] },
+    );
+
+    expect(next.snapshotSequence).toBe(7);
+    expect(next.projects).toEqual([]);
+    expect(next.threads).toEqual([]);
+  });
+
+  it("resolved null clears identity only for the marked root", () => {
+    const otherProject = {
+      ...v2Project,
+      id: ProjectId.make("project-other"),
+      workspaceRoot: "/workspace/other",
+      repositoryIdentity: otherIdentity,
+    };
+    const previous = {
+      ...v2ShellSnapshot,
+      snapshotSequence: 5,
+      projects: [{ ...v2Project, repositoryIdentity }, otherProject],
+    };
+    const next = mergeShellSnapshotProjects(
+      previous,
+      {
+        ...v2ShellSnapshot,
+        snapshotSequence: 4,
+        projects: [
+          { ...v2Project, repositoryIdentity: null },
+          { ...otherProject, repositoryIdentity: null },
+        ],
+      },
+      { resolvedRepositoryIdentityRoots: [v2Project.workspaceRoot] },
+    );
+
+    expect(next.snapshotSequence).toBe(5);
+    expect(next.projects).toHaveLength(2);
+    expect(next.projects[0]?.repositoryIdentity).toBeNull();
+    expect(next.projects[1]?.repositoryIdentity).toEqual(otherIdentity);
+  });
+
+  it("unrelated unresolved roots retain identity in the same enrichment snapshot", () => {
+    const otherProject = {
+      ...v2Project,
+      id: ProjectId.make("project-other"),
+      workspaceRoot: "/workspace/other",
+      repositoryIdentity: otherIdentity,
+    };
+    const previous = {
+      ...v2ShellSnapshot,
+      snapshotSequence: 3,
+      projects: [{ ...v2Project, repositoryIdentity }, otherProject],
+      threads: [{ ...v2ThreadShell, title: "Current thread" }],
+    };
+    const next = mergeShellSnapshotProjects(
+      previous,
+      {
+        ...v2ShellSnapshot,
+        snapshotSequence: 3,
+        projects: [
+          { ...v2Project, repositoryIdentity },
+          { ...otherProject, repositoryIdentity: null },
+        ],
+        threads: [{ ...v2ThreadShell, title: "Stale thread" }],
+      },
+      { resolvedRepositoryIdentityRoots: [v2Project.workspaceRoot] },
+    );
+
+    expect(next.threads[0]?.title).toBe("Current thread");
+    expect(next.projects[0]?.repositoryIdentity).toEqual(repositoryIdentity);
+    expect(next.projects[1]?.repositoryIdentity).toEqual(otherIdentity);
   });
 
-  describe("thread-removed", () => {
-    it("removes a thread by id", () => {
-      const snapshotWithThread: OrchestrationShellSnapshot = {
-        ...baseSnapshot,
-        threads: [stubThread],
-      };
+  it("clears identity for multiple roots resolved in one enrichment batch", () => {
+    const otherProject = {
+      ...v2Project,
+      id: ProjectId.make("project-other"),
+      workspaceRoot: "/workspace/other",
+      repositoryIdentity: otherIdentity,
+    };
+    const previous = {
+      ...v2ShellSnapshot,
+      snapshotSequence: 3,
+      projects: [{ ...v2Project, repositoryIdentity }, otherProject],
+    };
+    const next = mergeShellSnapshotProjects(
+      previous,
+      {
+        ...v2ShellSnapshot,
+        snapshotSequence: 3,
+        projects: [
+          { ...v2Project, repositoryIdentity: null },
+          { ...otherProject, repositoryIdentity: null },
+        ],
+      },
+      {
+        resolvedRepositoryIdentityRoots: [v2Project.workspaceRoot, otherProject.workspaceRoot],
+      },
+    );
 
-      const event: OrchestrationShellStreamEvent = {
-        kind: "thread-removed",
-        sequence: 6,
-        threadId: ThreadId.make("thread-1"),
-      };
+    expect(next.projects.map((project) => project.repositoryIdentity)).toEqual([null, null]);
+  });
 
-      const next = applyShellStreamEvent(snapshotWithThread, event);
+  it("does not replace a live identity with one from an unmarked lower-sequence enrichment", () => {
+    const liveIdentity = {
+      canonicalKey: "github.com/example/live",
+      locator: {
+        source: "git-remote" as const,
+        remoteName: "origin",
+        remoteUrl: "https://github.com/example/live.git",
+      },
+    };
+    const staleIdentity = {
+      canonicalKey: "github.com/example/stale",
+      locator: {
+        source: "git-remote" as const,
+        remoteName: "origin",
+        remoteUrl: "https://github.com/example/stale.git",
+      },
+    };
+    const next = mergeShellSnapshotProjects(
+      {
+        ...v2ShellSnapshot,
+        snapshotSequence: 5,
+        projects: [{ ...v2Project, repositoryIdentity: liveIdentity }],
+      },
+      {
+        ...v2ShellSnapshot,
+        snapshotSequence: 4,
+        projects: [{ ...v2Project, repositoryIdentity: staleIdentity }],
+      },
+      { resolvedRepositoryIdentityRoots: [] },
+    );
+
+    expect(next.snapshotSequence).toBe(5);
+    expect(next.projects[0]?.repositoryIdentity).toEqual(liveIdentity);
+  });
 
-      expect(next.threads).toHaveLength(0);
-      expect(next.snapshotSequence).toBe(6);
+  it("keeps archive deltas out of the normal shell cache", () => {
+    const archived = applyShellStreamEvent(v2ShellSnapshot, {
+      kind: "thread.updated",
+      sequence: 3,
+      location: "archive",
+      thread: { ...v2ThreadShell, archivedAt: v2ThreadShell.updatedAt },
     });
+    expect(archived.threads).toEqual([]);
+    expect(archived.archivedThreads).toEqual([]);
+
+    const active = applyShellStreamEvent(archived, {
+      kind: "thread.updated",
+      sequence: 4,
+      location: "active",
+      thread: v2ThreadShell,
+    });
+    expect(active.threads).toHaveLength(1);
+    expect(active.archivedThreads).toEqual([]);
+  });
+
+  it("removes a thread from either collection", () => {
+    const next = applyShellStreamEvent(v2ShellSnapshot, {
+      kind: "thread.removed",
+      sequence: 5,
+      location: "active",
+      threadId: ThreadId.make(v2ThreadShell.id),
+    });
+    expect(next.threads).toEqual([]);
+    expect(next.snapshotSequence).toBe(5);
   });
 
-  it("returns original snapshot for unrecognized event kinds", () => {
-    const unknownEvent = { kind: "unknown-future-event", sequence: 99 } as any;
-    const next = applyShellStreamEvent(baseSnapshot, unknownEvent);
-    expect(next).toBe(baseSnapshot);
+  it("leaves unknown future events unchanged", () => {
+    const next = applyShellStreamEvent(v2ShellSnapshot, {
+      kind: "future.event",
+      sequence: 99,
+    } as never);
+
+    expect(next).toBe(v2ShellSnapshot);
   });
 });
diff --git a/packages/client-runtime/src/state/shellReducer.ts b/packages/client-runtime/src/state/shellReducer.ts
index 3d3b22a1289f..3272cdc95944 100644
--- a/packages/client-runtime/src/state/shellReducer.ts
+++ b/packages/client-runtime/src/state/shellReducer.ts
@@ -1,43 +1,148 @@
-import * as Arr from "effect/Array";
-import type { OrchestrationShellSnapshot, OrchestrationShellStreamEvent } from "@t3tools/contracts";
+import type {
+  OrchestrationProjectShell,
+  OrchestrationV2ShellSnapshot,
+  OrchestrationV2ShellStreamItem,
+} from "@t3tools/contracts";
+
+function upsertById<T extends { readonly id: unknown }>(
+  items: ReadonlyArray<T>,
+  item: T,
+): ReadonlyArray<T> {
+  const index = items.findIndex((candidate) => candidate.id === item.id);
+  if (index === -1) return [...items, item];
+  return items.map((candidate, candidateIndex) => (candidateIndex === index ? item : candidate));
+}
+
+function retainRepositoryIdentity(
+  previous: OrchestrationProjectShell | undefined,
+  next: OrchestrationProjectShell,
+): OrchestrationProjectShell {
+  if (
+    next.repositoryIdentity == null &&
+    previous?.repositoryIdentity != null &&
+    previous.workspaceRoot === next.workspaceRoot
+  ) {
+    return { ...next, repositoryIdentity: previous.repositoryIdentity };
+  }
+  return next;
+}
+
+export interface MergeShellSnapshotOptions {
+  /**
+   * Metadata-only enrichment refresh: structure and sequence never change;
+   * listed roots accept identity exactly (including null).
+   * Omit this options object for authoritative HTTP/initial WebSocket snapshots.
+   */
+  readonly resolvedRepositoryIdentityRoots: ReadonlyArray<string>;
+}
 
 /**
- * Reduce a single shell stream event into an existing snapshot, returning a new
- * snapshot with the event's changes applied. This is a pure reducer that both
- * web and mobile can use to keep their local shell snapshot in sync.
+ * Merge an incoming full shell snapshot into prior client state.
+ *
+ * Authoritative snapshots (no options) replace structure and sequence even when
+ * lower than cache, while retaining a prior non-null identity when the candidate
+ * is still unresolved/null for the same root.
  *
- * Returns the original snapshot reference unchanged if the event is not
- * recognized (forward-compatible).
+ * Enrichment snapshots (options present) only patch repository identity for
+ * matching current projects. They never replace projects, threads, archives,
+ * or sequence, regardless of the incoming snapshot sequence.
  */
+export function mergeShellSnapshotProjects(
+  previous: OrchestrationV2ShellSnapshot | null | undefined,
+  next: OrchestrationV2ShellSnapshot,
+  options?: MergeShellSnapshotOptions,
+): OrchestrationV2ShellSnapshot {
+  if (previous === null || previous === undefined) {
+    return next;
+  }
+
+  const isEnrichment = options !== undefined;
+  const resolvedRootSet = isEnrichment ? new Set(options.resolvedRepositoryIdentityRoots) : null;
+
+  if (isEnrichment) {
+    const nextById = new Map(next.projects.map((project) => [project.id, project] as const));
+    return {
+      ...previous,
+      projects: previous.projects.map((project) => {
+        const candidate = nextById.get(project.id);
+        if (candidate === undefined || candidate.workspaceRoot !== project.workspaceRoot) {
+          return project;
+        }
+        if (resolvedRootSet?.has(project.workspaceRoot) === true) {
+          return { ...project, repositoryIdentity: candidate.repositoryIdentity };
+        }
+        if (project.repositoryIdentity == null && candidate.repositoryIdentity != null) {
+          return { ...project, repositoryIdentity: candidate.repositoryIdentity };
+        }
+        return project;
+      }),
+    };
+  }
+
+  const previousById = new Map(previous.projects.map((project) => [project.id, project] as const));
+  return {
+    ...next,
+    projects: next.projects.map((project) => {
+      const prior = previousById.get(project.id);
+      if (resolvedRootSet?.has(project.workspaceRoot) === true) {
+        return project;
+      }
+      return retainRepositoryIdentity(prior, project);
+    }),
+  };
+}
+
+/** Applies one committed V2 shell delta while preserving active/archive exclusivity. */
 export function applyShellStreamEvent(
-  snapshot: OrchestrationShellSnapshot,
-  event: OrchestrationShellStreamEvent,
-): OrchestrationShellSnapshot {
+  snapshot: OrchestrationV2ShellSnapshot,
+  event: Exclude<
+    OrchestrationV2ShellStreamItem,
+    { readonly kind: "snapshot" } | { readonly kind: "synchronized" }
+  >,
+): OrchestrationV2ShellSnapshot {
   if (event.sequence <= snapshot.snapshotSequence) return snapshot;
 
   switch (event.kind) {
-    case "project-upserted": {
-      const projects = snapshot.projects.some((p) => p.id === event.project.id)
-        ? Arr.map(snapshot.projects, (p) => (p.id === event.project.id ? event.project : p))
-        : Arr.append(snapshot.projects, event.project);
-      return { ...snapshot, projects, snapshotSequence: event.sequence };
+    case "project.updated": {
+      // Enrichment is async. A project mutation can land with null
+      // repositoryIdentity while an earlier snapshot already resolved it.
+      // Keep the prior identity for the same workspace root so multi-env
+      // grouping does not split until a full snapshot refresh arrives.
+      const previous = snapshot.projects.find((project) => project.id === event.project.id);
+      const project = retainRepositoryIdentity(previous, event.project);
+      return {
+        ...snapshot,
+        projects: upsertById(snapshot.projects, project),
+        snapshotSequence: event.sequence,
+      };
     }
-    case "project-removed":
+    case "project.removed":
+      return {
+        ...snapshot,
+        projects: snapshot.projects.filter((project) => project.id !== event.projectId),
+        snapshotSequence: event.sequence,
+      };
+    case "thread.updated": {
+      const withoutThread = (threads: OrchestrationV2ShellSnapshot["threads"]) =>
+        threads.filter((thread) => thread.id !== event.thread.id);
       return {
         ...snapshot,
-        projects: Arr.filter(snapshot.projects, (p) => p.id !== event.projectId),
+        threads:
+          event.location === "active"
+            ? upsertById(withoutThread(snapshot.threads), event.thread)
+            : withoutThread(snapshot.threads),
+        // The archive has its own bounded query/subscription. Older servers may
+        // still send archive-located deltas here; remove them from the normal
+        // shell instead of growing its persisted cache again.
+        archivedThreads: withoutThread(snapshot.archivedThreads),
         snapshotSequence: event.sequence,
       };
-    case "thread-upserted": {
-      const threads = snapshot.threads.some((t) => t.id === event.thread.id)
-        ? Arr.map(snapshot.threads, (t) => (t.id === event.thread.id ? event.thread : t))
-        : Arr.append(snapshot.threads, event.thread);
-      return { ...snapshot, threads, snapshotSequence: event.sequence };
     }
-    case "thread-removed":
+    case "thread.removed":
       return {
         ...snapshot,
-        threads: Arr.filter(snapshot.threads, (t) => t.id !== event.threadId),
+        threads: snapshot.threads.filter((thread) => thread.id !== event.threadId),
+        archivedThreads: snapshot.archivedThreads.filter((thread) => thread.id !== event.threadId),
         snapshotSequence: event.sequence,
       };
     default:
diff --git a/packages/client-runtime/src/state/shellSnapshotHttp.ts b/packages/client-runtime/src/state/shellSnapshotHttp.ts
index b0a492a1305f..6b64f785203e 100644
--- a/packages/client-runtime/src/state/shellSnapshotHttp.ts
+++ b/packages/client-runtime/src/state/shellSnapshotHttp.ts
@@ -1,4 +1,4 @@
-import type { OrchestrationShellSnapshot } from "@t3tools/contracts";
+import type { OrchestrationV2ShellSnapshot } from "@t3tools/contracts";
 import * as Cause from "effect/Cause";
 import * as Context from "effect/Context";
 import * as Effect from "effect/Effect";
@@ -10,7 +10,11 @@ import type { PreparedConnection } from "../connection/model.ts";
 import { environmentEndpointUrl } from "../environment/endpoint.ts";
 import { ManagedRelayDpopSigner } from "../relay/managedRelay.ts";
 import { executeEnvironmentHttpRequest, makeEnvironmentHttpApiClient } from "../rpc/http.ts";
-import { buildEnvironmentAuthHeaders, withEnvironmentCredentials } from "./environmentHttpAuth.ts";
+import {
+  buildEnvironmentAuthHeaders,
+  withEnvironmentCredentials,
+  withOrchestrationProtocolHeader,
+} from "./environmentHttpAuth.ts";
 
 // Bounded so a pathologically slow endpoint cannot block the (cheaper) socket
 // fallback for long. The cached shell renders while this runs.
@@ -42,7 +46,7 @@ export const fetchEnvironmentShellSnapshot = Effect.fn(
     input.timeoutMs ?? DEFAULT_SHELL_SNAPSHOT_TIMEOUT_MS,
     withEnvironmentCredentials(
       input.prepared.httpAuthorization,
-      client.orchestration.shellSnapshot({ headers }),
+      client.orchestration.shellSnapshot({ headers: withOrchestrationProtocolHeader(headers) }),
     ),
   );
 });
@@ -58,7 +62,7 @@ export class ShellSnapshotLoader extends Context.Service<
   {
     readonly load: (
       prepared: PreparedConnection,
-    ) => Effect.Effect<Option.Option<OrchestrationShellSnapshot>>;
+    ) => Effect.Effect<Option.Option<OrchestrationV2ShellSnapshot>>;
   }
 >()("@t3tools/client-runtime/state/shellSnapshotHttp/ShellSnapshotLoader") {}
 
@@ -76,14 +80,14 @@ export const shellSnapshotLoaderLayer: Layer.Layer<
     return ShellSnapshotLoader.of({
       load: (prepared: PreparedConnection) =>
         fetchEnvironmentShellSnapshot({ prepared, signer }).pipe(
-          Effect.map(Option.some<OrchestrationShellSnapshot>),
+          Effect.map(Option.some<OrchestrationV2ShellSnapshot>),
           Effect.provideService(HttpClient.HttpClient, httpClient),
           Effect.catchCause((cause) =>
             Effect.logWarning(
               "Could not load the environment shell snapshot over HTTP; using the socket snapshot instead.",
             ).pipe(
               Effect.annotateLogs({ cause: Cause.pretty(cause) }),
-              Effect.as(Option.none<OrchestrationShellSnapshot>()),
+              Effect.as(Option.none<OrchestrationV2ShellSnapshot>()),
             ),
           ),
         ),
diff --git a/packages/client-runtime/src/state/snapshots.ts b/packages/client-runtime/src/state/snapshots.ts
index 0000dcb12ce9..f265fb3c47e7 100644
--- a/packages/client-runtime/src/state/snapshots.ts
+++ b/packages/client-runtime/src/state/snapshots.ts
@@ -1,4 +1,4 @@
-import type { EnvironmentId, OrchestrationShellSnapshot } from "@t3tools/contracts";
+import type { EnvironmentId, OrchestrationV2ShellSnapshot } from "@t3tools/contracts";
 import * as Option from "effect/Option";
 import { AsyncResult, Atom } from "effect/unstable/reactivity";
 
@@ -10,7 +10,7 @@ export function createEnvironmentSnapshotAtom<E>(
   ) => Atom.Atom<AsyncResult.AsyncResult<EnvironmentShellState, E>>,
 ) {
   return Atom.family((environmentId: EnvironmentId) =>
-    Atom.make((get): OrchestrationShellSnapshot | null =>
+    Atom.make((get): OrchestrationV2ShellSnapshot | null =>
       Option.match(AsyncResult.value(get(shellStateAtom(environmentId))), {
         onNone: () => null,
         onSome: (state) => Option.getOrNull(state.snapshot),
diff --git a/packages/client-runtime/src/state/subagentRuntime.ts b/packages/client-runtime/src/state/subagentRuntime.ts
index c1ea1cc2b15d..7e11bed8d5e7 100644
--- a/packages/client-runtime/src/state/subagentRuntime.ts
+++ b/packages/client-runtime/src/state/subagentRuntime.ts
@@ -17,6 +17,7 @@
  * folding (completion can create an agent; a late start only fills
  * metadata).
  */
+import * as DateTime from "effect/DateTime";
 import type { OrchestrationThreadActivity } from "@t3tools/contracts";
 
 export type RuntimeSubagentStatus =
@@ -717,6 +718,69 @@ export function emptyAgentPanelModel(): AgentPanelModel {
   return EMPTY_PANEL_MODEL;
 }
 
+/**
+ * The v2 leg of the mapper swap (#5219 spec): project orchestration-v2
+ * subagent entities into the same runtime shape the native fold produced.
+ * The panel/CTA components never see which source fed them.
+ */
+export function projectedSubagentsToRuntime(
+  subagents: ReadonlyArray<{
+    readonly id: string;
+    readonly title: string | null;
+    readonly prompt: string;
+    readonly model: string | null;
+    readonly status:
+      | "pending"
+      | "running"
+      | "waiting"
+      | "completed"
+      | "failed"
+      | "cancelled"
+      | "interrupted";
+    readonly progress?: string | undefined;
+    readonly result: string | null;
+    readonly startedAt: DateTime.Utc | null;
+    readonly completedAt: DateTime.Utc | null;
+    readonly updatedAt: DateTime.Utc;
+  }>,
+): ReadonlyArray<RuntimeSubagent> {
+  return subagents.map((subagent) => {
+    const updatedAt = DateTime.formatIso(subagent.updatedAt);
+    const startedAt = subagent.startedAt === null ? null : DateTime.formatIso(subagent.startedAt);
+    return {
+      id: subagent.id,
+      kind: "subagent" as const,
+      title:
+        subagent.title ??
+        (subagent.prompt.length > 80 ? `${subagent.prompt.slice(0, 77)}...` : subagent.prompt),
+      role: null,
+      model: subagent.model,
+      effort: null,
+      status: subagent.status,
+      activationCount: 1,
+      usage: null,
+      progress: subagent.progress ?? null,
+      lastToolName: null,
+      result: subagent.result,
+      error: subagent.status === "failed" ? (subagent.result ?? null) : null,
+      outputFile: null,
+      parentAgentId: null,
+      agentIndex: null,
+      phaseIndex: null,
+      phaseTitle: null,
+      attempt: null,
+      workflowName: null,
+      phases: [],
+      runHandles: null,
+      recentActivity: [],
+      firstSeenAt: startedAt ?? updatedAt,
+      startedAt,
+      completedAt: subagent.completedAt === null ? null : DateTime.formatIso(subagent.completedAt),
+      updatedAt,
+    } satisfies RuntimeSubagent;
+  });
+}
+
 /**
  * Source-neutral view model. When the orchestration-v2 subagent projection
  * exists for the thread, pass it as v2Projection and it wins outright — the
diff --git a/packages/client-runtime/src/state/threadCheckpoints.ts b/packages/client-runtime/src/state/threadCheckpoints.ts
new file mode 100644
index 000000000000..6d4ad38b87a6
--- /dev/null
+++ b/packages/client-runtime/src/state/threadCheckpoints.ts
@@ -0,0 +1,52 @@
+import type {
+  CheckpointId,
+  CheckpointRef,
+  CheckpointScopeId,
+  MessageId,
+  OrchestrationV2ThreadProjection,
+  RunId,
+} from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+
+export interface ThreadCheckpointSummary {
+  readonly checkpointId?: CheckpointId;
+  readonly scopeId?: CheckpointScopeId;
+  readonly runId: RunId;
+  readonly checkpointTurnCount: number;
+  readonly checkpointRef: CheckpointRef;
+  readonly status: "ready" | "missing" | "error" | "stale";
+  readonly files: ReadonlyArray<{
+    readonly path: string;
+    readonly kind: string;
+    readonly additions: number;
+    readonly deletions: number;
+  }>;
+  readonly assistantMessageId: MessageId | null;
+  readonly completedAt: string;
+}
+
+/** Derives the checkpoint/diff rows needed by review UIs from native V2 entities. */
+export function deriveThreadCheckpointSummaries(
+  projection: OrchestrationV2ThreadProjection,
+): ReadonlyArray<ThreadCheckpointSummary> {
+  return projection.checkpoints.flatMap((checkpoint) => {
+    if (checkpoint.appRunOrdinal === null || checkpoint.runId === null) return [];
+    const assistantMessageId =
+      projection.messages.findLast(
+        (message) => message.runId === checkpoint.runId && message.role === "assistant",
+      )?.id ?? null;
+    return [
+      {
+        checkpointId: checkpoint.id,
+        scopeId: checkpoint.scopeId,
+        runId: checkpoint.runId,
+        checkpointTurnCount: checkpoint.appRunOrdinal,
+        checkpointRef: checkpoint.ref,
+        status: checkpoint.status,
+        files: checkpoint.files,
+        assistantMessageId,
+        completedAt: DateTime.formatIso(checkpoint.capturedAt),
+      },
+    ];
+  });
+}
diff --git a/packages/client-runtime/src/state/threadCommands.ts b/packages/client-runtime/src/state/threadCommands.ts
index c540644289df..e1762d8b76bd 100644
--- a/packages/client-runtime/src/state/threadCommands.ts
+++ b/packages/client-runtime/src/state/threadCommands.ts
@@ -1,4 +1,7 @@
+import type { ThreadId } from "@t3tools/contracts";
 import * as Crypto from "effect/Crypto";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
 import { Atom } from "effect/unstable/reactivity";
 import { WS_METHODS } from "@t3tools/contracts";
 
@@ -9,9 +12,16 @@ import {
 } from "./runtime.ts";
 import {
   type ArchiveThreadInput,
+  type CancelQueuedRunInput,
   type CreateThreadInput,
   type DeleteThreadInput,
+  type EditQueuedRunInput,
   type InterruptThreadTurnInput,
+  type MarkThreadUnreadInput,
+  type ForkThreadFromRunInput,
+  type MergeThreadBackInput,
+  type PromoteQueuedRunInput,
+  type ReorderQueuedRunInput,
   type RespondToThreadApprovalInput,
   type RespondToThreadUserInputInput,
   type RevertThreadCheckpointInput,
@@ -28,10 +38,18 @@ import {
   type UnsettleThreadInput,
   type UnsnoozeThreadInput,
   type UpdateThreadMetadataInput,
+  type VisitThreadInput,
   archiveThread,
+  cancelQueuedRun,
   createThread,
   deleteThread,
+  editQueuedRun,
   interruptThreadTurn,
+  forkThreadFromRun,
+  markThreadUnread,
+  mergeThreadBack,
+  promoteQueuedRun,
+  reorderQueuedRun,
   respondToThreadApproval,
   respondToThreadUserInput,
   revertThreadCheckpoint,
@@ -48,14 +66,31 @@ import {
   unsettleThread,
   unsnoozeThread,
   updateThreadMetadata,
+  visitThread,
 } from "../operations/commands.ts";
 import type { EnvironmentRegistry } from "../connection/registry.ts";
+import { EnvironmentSupervisor } from "../connection/supervisor.ts";
+import {
+  ThreadHistoryController,
+  type ThreadHistoryLoadEarlierResult,
+} from "./threadHistoryController.ts";
+
+export type LoadEarlierThreadHistoryInput = {
+  readonly threadId: ThreadId;
+};
 
 export type {
   ArchiveThreadInput,
+  CancelQueuedRunInput,
   CreateThreadInput,
   DeleteThreadInput,
+  EditQueuedRunInput,
   InterruptThreadTurnInput,
+  MarkThreadUnreadInput,
+  ForkThreadFromRunInput,
+  MergeThreadBackInput,
+  PromoteQueuedRunInput,
+  ReorderQueuedRunInput,
   RespondToThreadApprovalInput,
   RespondToThreadUserInputInput,
   RevertThreadCheckpointInput,
@@ -67,11 +102,13 @@ export type {
   SnoozeThreadInput,
   StartThreadTurnInput,
   StopThreadSessionInput,
+  ThreadCommandInput,
   UnarchiveThreadInput,
   UnpinThreadInput,
   UnsettleThreadInput,
   UnsnoozeThreadInput,
   UpdateThreadMetadataInput,
+  VisitThreadInput,
 } from "../operations/commands.ts";
 
 export function createThreadEnvironmentAtoms<R, E>(
@@ -150,6 +187,18 @@ export function createThreadEnvironmentAtoms<R, E>(
       scheduler,
       concurrency,
     }),
+    visit: createEnvironmentCommand(runtime, {
+      label: "environment-data:commands:thread:visit",
+      execute: (input: VisitThreadInput) => visitThread(input),
+      scheduler,
+      concurrency,
+    }),
+    markUnread: createEnvironmentCommand(runtime, {
+      label: "environment-data:commands:thread:mark-unread",
+      execute: (input: MarkThreadUnreadInput) => markThreadUnread(input),
+      scheduler,
+      concurrency,
+    }),
     updateMetadata: createEnvironmentCommand(runtime, {
       label: "environment-data:commands:thread:update-metadata",
       execute: (input: UpdateThreadMetadataInput) => updateThreadMetadata(input),
@@ -204,6 +253,69 @@ export function createThreadEnvironmentAtoms<R, E>(
       scheduler,
       concurrency,
     }),
+    forkFromRun: createEnvironmentCommand(runtime, {
+      label: "environment-data:commands:thread:fork-from-run",
+      execute: (input: ForkThreadFromRunInput) => forkThreadFromRun(input),
+      scheduler,
+      concurrency: {
+        mode: "serial",
+        key: ({ environmentId, input }) => JSON.stringify([environmentId, input.sourceThreadId]),
+      },
+    }),
+    mergeBack: createEnvironmentCommand(runtime, {
+      label: "environment-data:commands:thread:merge-back",
+      execute: (input: MergeThreadBackInput) => mergeThreadBack(input),
+      scheduler,
+      concurrency: {
+        mode: "serial",
+        key: ({ environmentId, input }) =>
+          JSON.stringify([environmentId, input.sourceThreadId, input.targetThreadId]),
+      },
+    }),
+    reorderQueuedRun: createEnvironmentCommand(runtime, {
+      label: "environment-data:commands:thread:reorder-queued-run",
+      execute: (input: ReorderQueuedRunInput) => reorderQueuedRun(input),
+      scheduler,
+      concurrency,
+    }),
+    promoteQueuedRun: createEnvironmentCommand(runtime, {
+      label: "environment-data:commands:thread:promote-queued-run",
+      execute: (input: PromoteQueuedRunInput) => promoteQueuedRun(input),
+      scheduler,
+      concurrency,
+    }),
+    cancelQueuedRun: createEnvironmentCommand(runtime, {
+      label: "environment-data:commands:thread:cancel-queued-run",
+      execute: (input: CancelQueuedRunInput) => cancelQueuedRun(input),
+      scheduler,
+      concurrency,
+    }),
+    editQueuedRun: createEnvironmentCommand(runtime, {
+      label: "environment-data:commands:thread:edit-queued-run",
+      execute: (input: EditQueuedRunInput) => editQueuedRun(input),
+      scheduler,
+      concurrency,
+    }),
+    loadEarlierHistory: createEnvironmentCommand(runtime, {
+      label: "environment-data:commands:thread:load-earlier-history",
+      execute: (input: LoadEarlierThreadHistoryInput) =>
+        Effect.gen(function* () {
+          const supervisor = yield* EnvironmentSupervisor;
+          const controller = yield* Effect.serviceOption(ThreadHistoryController);
+          if (Option.isNone(controller)) {
+            return { _tag: "noop" } satisfies ThreadHistoryLoadEarlierResult;
+          }
+          return yield* controller.value.loadEarlier(
+            supervisor.target.environmentId,
+            input.threadId,
+          );
+        }),
+      scheduler,
+      concurrency: {
+        mode: "serial",
+        key: ({ environmentId, input }) => JSON.stringify([environmentId, input.threadId]),
+      },
+    }),
     uploadFeedback: createEnvironmentRpcCommand(runtime, {
       label: "environment-data:commands:thread:upload-feedback",
       tag: WS_METHODS.providerUploadFeedback,
diff --git a/packages/client-runtime/src/state/threadDetail.test.ts b/packages/client-runtime/src/state/threadDetail.test.ts
new file mode 100644
index 000000000000..7b0d27538824
--- /dev/null
+++ b/packages/client-runtime/src/state/threadDetail.test.ts
@@ -0,0 +1,98 @@
+import { EnvironmentId, ThreadId, type ScopedThreadRef } from "@t3tools/contracts";
+import * as Option from "effect/Option";
+import { AsyncResult, Atom, AtomRegistry } from "effect/unstable/reactivity";
+import { describe, expect, it } from "vite-plus/test";
+
+import { v2Projection } from "./orchestrationV2TestFixtures.ts";
+import { EMPTY_THREAD_HISTORY_META } from "./threadHistoryMerge.ts";
+import { createEnvironmentThreadDetailAtoms } from "./threadDetail.ts";
+import type { EnvironmentThreadState } from "./threads.ts";
+
+const ref: ScopedThreadRef = {
+  environmentId: EnvironmentId.make("environment-detail"),
+  threadId: ThreadId.make(v2Projection.thread.id),
+};
+
+function threadState(
+  partial: Pick<EnvironmentThreadState, "data" | "status" | "error"> &
+    Partial<Pick<EnvironmentThreadState, "history">>,
+): EnvironmentThreadState {
+  return { ...partial, history: partial.history ?? EMPTY_THREAD_HISTORY_META };
+}
+
+describe("createEnvironmentThreadDetailAtoms", () => {
+  it("adds environment scope while preserving the pristine projection", () => {
+    const initial: AsyncResult.AsyncResult<EnvironmentThreadState, never> = AsyncResult.success(
+      threadState({
+        data: Option.some(v2Projection),
+        status: "cached",
+        error: Option.none(),
+      }),
+    );
+    const sourceAtom = Atom.make(initial);
+    const details = createEnvironmentThreadDetailAtoms(() => sourceAtom);
+    const registry = AtomRegistry.make();
+
+    const thread = registry.get(details.threadAtom(ref));
+    expect(thread).toEqual({ environmentId: ref.environmentId, projection: v2Projection });
+    expect(thread?.projection).toBe(v2Projection);
+    expect(registry.get(details.visibleTurnItemsAtom(ref))).toBe(v2Projection.visibleTurnItems);
+    expect(registry.get(details.statusAtom(ref))).toBe("cached");
+    expect(registry.get(details.historyAtom(ref))).toBe(EMPTY_THREAD_HISTORY_META);
+
+    registry.set(
+      sourceAtom,
+      AsyncResult.success(
+        threadState({
+          data: Option.some(v2Projection),
+          status: "synchronizing",
+          error: Option.none(),
+        }),
+      ),
+    );
+
+    expect(registry.get(details.threadAtom(ref))).toBe(thread);
+    expect(registry.get(details.statusAtom(ref))).toBe("synchronizing");
+
+    const progressiveHistory = {
+      ...EMPTY_THREAD_HISTORY_META,
+      historyCursor: "cursor-1",
+      hasMoreHistory: true,
+    };
+    registry.set(
+      sourceAtom,
+      AsyncResult.success(
+        threadState({
+          data: Option.some(v2Projection),
+          status: "live",
+          error: Option.some("Stream interrupted."),
+          history: progressiveHistory,
+        }),
+      ),
+    );
+
+    expect(registry.get(details.threadAtom(ref))).toBe(thread);
+    expect(registry.get(details.visibleTurnItemsAtom(ref))).toBe(v2Projection.visibleTurnItems);
+    expect(registry.get(details.statusAtom(ref))).toBe("live");
+    expect(registry.get(details.errorAtom(ref))).toBe("Stream interrupted.");
+    expect(registry.get(details.historyAtom(ref))).toBe(progressiveHistory);
+
+    registry.set(
+      sourceAtom,
+      AsyncResult.success(
+        threadState({
+          data: Option.none(),
+          status: "deleted",
+          error: Option.none(),
+        }),
+      ),
+    );
+
+    expect(registry.get(details.threadAtom(ref))).toBeNull();
+    expect(registry.get(details.visibleTurnItemsAtom(ref))).toEqual([]);
+    expect(registry.get(details.statusAtom(ref))).toBe("deleted");
+    expect(registry.get(details.errorAtom(ref))).toBeNull();
+    expect(registry.get(details.historyAtom(ref))).toBe(EMPTY_THREAD_HISTORY_META);
+    registry.dispose();
+  });
+});
diff --git a/packages/client-runtime/src/state/threadDetail.ts b/packages/client-runtime/src/state/threadDetail.ts
index 5a2ffa442e04..e596dccacafb 100644
--- a/packages/client-runtime/src/state/threadDetail.ts
+++ b/packages/client-runtime/src/state/threadDetail.ts
@@ -1,71 +1,15 @@
-import type {
-  OrchestrationCheckpointSummary,
-  OrchestrationLatestTurn,
-  OrchestrationMessage,
-  OrchestrationProposedPlan,
-  OrchestrationSession,
-  OrchestrationThread,
-  OrchestrationThreadActivity,
-  ScopedThreadRef,
-} from "@t3tools/contracts";
+import type { OrchestrationV2ThreadProjection, ScopedThreadRef } from "@t3tools/contracts";
 import * as Option from "effect/Option";
 import { AsyncResult, Atom } from "effect/unstable/reactivity";
 
-import type { EnvironmentThread, EnvironmentThreadShell } from "./models.ts";
-import { scopeThread } from "./models.ts";
+import type { EnvironmentThread } from "./models.ts";
 import { EMPTY_ENVIRONMENT_THREAD_STATE, type EnvironmentThreadState } from "./threadState.ts";
 import { parseThreadKey, threadKey } from "./entities.ts";
 import { THREAD_STATE_IDLE_TTL_MS } from "./threadRetention.ts";
 
-const EMPTY_MESSAGES: ReadonlyArray<OrchestrationMessage> = Object.freeze([]);
-const EMPTY_ACTIVITIES: ReadonlyArray<OrchestrationThreadActivity> = Object.freeze([]);
-const EMPTY_PROPOSED_PLANS: ReadonlyArray<OrchestrationProposedPlan> = Object.freeze([]);
-const EMPTY_CHECKPOINTS: ReadonlyArray<OrchestrationCheckpointSummary> = Object.freeze([]);
-
-/**
- * Combine detail-only collections with the shell's authoritative thread metadata.
- *
- * Shell and detail subscriptions are intentionally independent. A cached detail can
- * therefore briefly outlive a newer shell snapshot after reconnecting. Workspace
- * consumers must use the shell branch/worktree/project fields so they do not target
- * a stale checkout while retaining messages, activities, plans, and checkpoints
- * from the detail subscription.
- */
-export function mergeEnvironmentThread(
-  detail: EnvironmentThread | null,
-  shell: EnvironmentThreadShell | null,
-): EnvironmentThread | null {
-  if (detail === null || shell === null) {
-    return detail;
-  }
-  if (detail.environmentId !== shell.environmentId || detail.id !== shell.id) {
-    return detail;
-  }
-
-  return {
-    ...detail,
-    environmentId: shell.environmentId,
-    id: shell.id,
-    projectId: shell.projectId,
-    title: shell.title,
-    modelSelection: shell.modelSelection,
-    runtimeMode: shell.runtimeMode,
-    interactionMode: shell.interactionMode,
-    branch: shell.branch,
-    worktreePath: shell.worktreePath,
-    latestTurn: shell.latestTurn,
-    createdAt: shell.createdAt,
-    updatedAt: shell.updatedAt,
-    archivedAt: shell.archivedAt,
-    settledOverride: shell.settledOverride,
-    settledAt: shell.settledAt,
-    snoozedUntil: shell.snoozedUntil,
-    snoozedAt: shell.snoozedAt,
-    pinnedAt: shell.pinnedAt,
-    pinOrderKey: shell.pinOrderKey,
-    session: shell.session,
-  };
-}
+const EMPTY_VISIBLE_TURN_ITEMS: OrchestrationV2ThreadProjection["visibleTurnItems"] = Object.freeze(
+  [],
+);
 
 export function createEnvironmentThreadDetailAtoms<E>(
   threadStateAtom: (
@@ -86,106 +30,55 @@ export function createEnvironmentThreadDetailAtoms<E>(
     );
   });
 
-  const threadDetailAtomFamily = Atom.family((key: string) => {
+  const threadAtomFamily = Atom.family((key: string) => {
     const ref = parseThreadKey(key);
-    let previousSource: OrchestrationThread | null = null;
+    let previousProjection: OrchestrationV2ThreadProjection | null = null;
     let previousValue: EnvironmentThread | null = null;
     return Atom.make((get) => {
-      const source = Option.getOrNull(get(threadStateValueAtomFamily(key)).data);
-      if (source === previousSource) {
-        return previousValue;
-      }
-      previousSource = source;
-      previousValue = source === null ? null : scopeThread(ref.environmentId, source);
+      const projection = Option.getOrNull(get(threadStateValueAtomFamily(key)).data);
+      if (projection === previousProjection) return previousValue;
+      previousProjection = projection;
+      previousValue = projection === null ? null : { environmentId: ref.environmentId, projection };
       return previousValue;
-    }).pipe(
-      Atom.setIdleTTL(THREAD_STATE_IDLE_TTL_MS),
-      Atom.withLabel(`environment-thread-detail:${key}`),
-    );
+    }).pipe(Atom.setIdleTTL(THREAD_STATE_IDLE_TTL_MS), Atom.withLabel(`environment-thread:${key}`));
   });
 
-  const threadStatusAtomFamily = Atom.family((key: string) =>
-    Atom.make((get) => get(threadStateValueAtomFamily(key)).status).pipe(
-      Atom.setIdleTTL(THREAD_STATE_IDLE_TTL_MS),
-      Atom.withLabel(`environment-thread-status:${key}`),
-    ),
-  );
-
-  const threadErrorAtomFamily = Atom.family((key: string) =>
-    Atom.make((get) => Option.getOrNull(get(threadStateValueAtomFamily(key)).error)).pipe(
-      Atom.setIdleTTL(THREAD_STATE_IDLE_TTL_MS),
-      Atom.withLabel(`environment-thread-error:${key}`),
-    ),
-  );
-
-  const threadMessagesAtomFamily = Atom.family((key: string) =>
+  const visibleTurnItemsAtomFamily = Atom.family((key: string) =>
     Atom.make(
-      (get): ReadonlyArray<OrchestrationMessage> =>
-        get(threadDetailAtomFamily(key))?.messages ?? EMPTY_MESSAGES,
+      (get): OrchestrationV2ThreadProjection["visibleTurnItems"] =>
+        Option.getOrNull(get(threadStateValueAtomFamily(key)).data)?.visibleTurnItems ??
+        EMPTY_VISIBLE_TURN_ITEMS,
     ).pipe(
       Atom.setIdleTTL(THREAD_STATE_IDLE_TTL_MS),
-      Atom.withLabel(`environment-thread-messages:${key}`),
+      Atom.withLabel(`environment-thread-visible-turn-items:${key}`),
     ),
   );
 
-  const threadActivitiesAtomFamily = Atom.family((key: string) =>
-    Atom.make(
-      (get): ReadonlyArray<OrchestrationThreadActivity> =>
-        get(threadDetailAtomFamily(key))?.activities ?? EMPTY_ACTIVITIES,
-    ).pipe(
-      Atom.setIdleTTL(THREAD_STATE_IDLE_TTL_MS),
-      Atom.withLabel(`environment-thread-activities:${key}`),
-    ),
-  );
-
-  const threadProposedPlansAtomFamily = Atom.family((key: string) =>
-    Atom.make(
-      (get): ReadonlyArray<OrchestrationProposedPlan> =>
-        get(threadDetailAtomFamily(key))?.proposedPlans ?? EMPTY_PROPOSED_PLANS,
-    ).pipe(
-      Atom.setIdleTTL(THREAD_STATE_IDLE_TTL_MS),
-      Atom.withLabel(`environment-thread-proposed-plans:${key}`),
-    ),
-  );
-
-  const threadCheckpointsAtomFamily = Atom.family((key: string) =>
-    Atom.make(
-      (get): ReadonlyArray<OrchestrationCheckpointSummary> =>
-        get(threadDetailAtomFamily(key))?.checkpoints ?? EMPTY_CHECKPOINTS,
-    ).pipe(
+  const statusAtomFamily = Atom.family((key: string) =>
+    Atom.make((get) => get(threadStateValueAtomFamily(key)).status).pipe(
       Atom.setIdleTTL(THREAD_STATE_IDLE_TTL_MS),
-      Atom.withLabel(`environment-thread-checkpoints:${key}`),
+      Atom.withLabel(`environment-thread-status:${key}`),
     ),
   );
-
-  const threadSessionAtomFamily = Atom.family((key: string) =>
-    Atom.make(
-      (get): OrchestrationSession | null => get(threadDetailAtomFamily(key))?.session ?? null,
-    ).pipe(
+  const errorAtomFamily = Atom.family((key: string) =>
+    Atom.make((get) => Option.getOrNull(get(threadStateValueAtomFamily(key)).error)).pipe(
       Atom.setIdleTTL(THREAD_STATE_IDLE_TTL_MS),
-      Atom.withLabel(`environment-thread-session:${key}`),
+      Atom.withLabel(`environment-thread-error:${key}`),
     ),
   );
-
-  const threadLatestTurnAtomFamily = Atom.family((key: string) =>
-    Atom.make(
-      (get): OrchestrationLatestTurn | null => get(threadDetailAtomFamily(key))?.latestTurn ?? null,
-    ).pipe(
+  const historyAtomFamily = Atom.family((key: string) =>
+    Atom.make((get) => get(threadStateValueAtomFamily(key)).history).pipe(
       Atom.setIdleTTL(THREAD_STATE_IDLE_TTL_MS),
-      Atom.withLabel(`environment-thread-latest-turn:${key}`),
+      Atom.withLabel(`environment-thread-history:${key}`),
     ),
   );
 
   return {
     stateAtom: (ref: ScopedThreadRef) => threadStateValueAtomFamily(threadKey(ref)),
-    detailAtom: (ref: ScopedThreadRef) => threadDetailAtomFamily(threadKey(ref)),
-    statusAtom: (ref: ScopedThreadRef) => threadStatusAtomFamily(threadKey(ref)),
-    errorAtom: (ref: ScopedThreadRef) => threadErrorAtomFamily(threadKey(ref)),
-    messagesAtom: (ref: ScopedThreadRef) => threadMessagesAtomFamily(threadKey(ref)),
-    activitiesAtom: (ref: ScopedThreadRef) => threadActivitiesAtomFamily(threadKey(ref)),
-    proposedPlansAtom: (ref: ScopedThreadRef) => threadProposedPlansAtomFamily(threadKey(ref)),
-    checkpointsAtom: (ref: ScopedThreadRef) => threadCheckpointsAtomFamily(threadKey(ref)),
-    sessionAtom: (ref: ScopedThreadRef) => threadSessionAtomFamily(threadKey(ref)),
-    latestTurnAtom: (ref: ScopedThreadRef) => threadLatestTurnAtomFamily(threadKey(ref)),
+    threadAtom: (ref: ScopedThreadRef) => threadAtomFamily(threadKey(ref)),
+    visibleTurnItemsAtom: (ref: ScopedThreadRef) => visibleTurnItemsAtomFamily(threadKey(ref)),
+    statusAtom: (ref: ScopedThreadRef) => statusAtomFamily(threadKey(ref)),
+    errorAtom: (ref: ScopedThreadRef) => errorAtomFamily(threadKey(ref)),
+    historyAtom: (ref: ScopedThreadRef) => historyAtomFamily(threadKey(ref)),
   };
 }
diff --git a/packages/client-runtime/src/state/threadExecution.test.ts b/packages/client-runtime/src/state/threadExecution.test.ts
new file mode 100644
index 000000000000..ff11855bc6af
--- /dev/null
+++ b/packages/client-runtime/src/state/threadExecution.test.ts
@@ -0,0 +1,114 @@
+import { MessageId, RunId, type OrchestrationV2RunStatus } from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+import { describe, expect, it } from "vite-plus/test";
+
+import { v2Projection } from "./orchestrationV2TestFixtures.ts";
+import {
+  deriveLatestThreadRun,
+  deriveThreadActivityRun,
+  deriveThreadRuntime,
+  threadRuntimeHasInterruptibleRun,
+} from "./threadExecution.ts";
+
+const now = DateTime.makeUnsafe("2026-07-28T10:00:00.000Z");
+
+function run(id: string, ordinal: number, status: OrchestrationV2RunStatus) {
+  return {
+    id: RunId.make(id),
+    threadId: v2Projection.thread.id,
+    ordinal,
+    providerInstanceId: v2Projection.thread.providerInstanceId,
+    modelSelection: v2Projection.thread.modelSelection,
+    providerThreadId: null,
+    userMessageId: MessageId.make(`message-${id}`),
+    rootNodeId: null,
+    activeAttemptId: null,
+    status,
+    requestedAt: now,
+    startedAt: status === "queued" ? null : now,
+    completedAt: null,
+    checkpointId: null,
+    contextHandoffId: null,
+  };
+}
+
+describe("thread execution presentation", () => {
+  it("keeps live activity attached to an executing run when a newer run is queued", () => {
+    const runningRun = run("run-running", 1, "running");
+    const queuedRun = run("run-queued", 2, "queued");
+    const projection = { ...v2Projection, runs: [queuedRun, runningRun], updatedAt: now };
+
+    expect(deriveLatestThreadRun(projection)?.runId).toBe(queuedRun.id);
+    expect(deriveThreadActivityRun(projection)).toMatchObject({
+      runId: runningRun.id,
+      status: "running",
+    });
+
+    const runtime = deriveThreadRuntime(projection);
+    expect(runtime).toMatchObject({
+      status: "running",
+      activeRunId: runningRun.id,
+    });
+    expect(threadRuntimeHasInterruptibleRun(runtime)).toBe(true);
+  });
+
+  it("does not expose a queued-only run as interruptible", () => {
+    const queuedRun = run("run-queued", 1, "queued");
+    const projection = { ...v2Projection, runs: [queuedRun], updatedAt: now };
+
+    expect(deriveThreadActivityRun(projection)).toMatchObject({
+      runId: queuedRun.id,
+      status: "queued",
+    });
+
+    const runtime = deriveThreadRuntime(projection);
+    expect(runtime).toMatchObject({
+      status: "queued",
+      activeRunId: null,
+    });
+    expect(threadRuntimeHasInterruptibleRun(runtime)).toBe(false);
+  });
+
+  it("keeps checkpoint-wait activity visible without exposing a non-functional interrupt", () => {
+    const waitingRun = run("run-waiting", 1, "waiting");
+    const projection = { ...v2Projection, runs: [waitingRun], updatedAt: now };
+
+    expect(deriveThreadActivityRun(projection)).toMatchObject({
+      runId: waitingRun.id,
+      status: "waiting",
+    });
+
+    const runtime = deriveThreadRuntime(projection);
+    expect(runtime).toMatchObject({
+      status: "waiting",
+      activeRunId: null,
+    });
+    expect(threadRuntimeHasInterruptibleRun(runtime)).toBe(false);
+  });
+
+  it("does not expose a stale active run after the runtime parks at idle", () => {
+    const runtime = {
+      status: "idle" as const,
+      activeRunId: RunId.make("run-stale"),
+      providerInstanceId: v2Projection.thread.providerInstanceId,
+      providerName: null,
+      lastError: null,
+      updatedAt: DateTime.formatIso(now),
+    };
+
+    expect(threadRuntimeHasInterruptibleRun(runtime)).toBe(false);
+  });
+
+  it.each(["preparing", "starting"] as const)("keeps an active %s run interruptible", (status) => {
+    const runtime = {
+      status,
+      activeRunId: RunId.make(`run-${status}`),
+      providerInstanceId: v2Projection.thread.providerInstanceId,
+      providerName: null,
+      lastError: null,
+      updatedAt: DateTime.formatIso(now),
+    };
+
+    expect(threadRuntimeHasInterruptibleRun(runtime)).toBe(true);
+  });
+});
diff --git a/packages/client-runtime/src/state/threadExecution.ts b/packages/client-runtime/src/state/threadExecution.ts
new file mode 100644
index 000000000000..62ad3a0ea52d
--- /dev/null
+++ b/packages/client-runtime/src/state/threadExecution.ts
@@ -0,0 +1,104 @@
+import type { OrchestrationV2ThreadProjection } from "@t3tools/contracts";
+import { derivePendingBackgroundWork } from "@t3tools/shared/orchestrationV2PendingBackgroundWork";
+import * as DateTime from "effect/DateTime";
+
+import {
+  threadRuntimeIsActive,
+  type ThreadRunSummary,
+  type ThreadRuntimeSummary,
+} from "./models.ts";
+
+const ACTIVITY_RUN_STATUSES = new Set(["preparing", "starting", "running", "waiting"]);
+const INTERRUPTIBLE_RUN_STATUSES = new Set(["preparing", "starting", "running"]);
+
+function latestMatchingRun(
+  projection: OrchestrationV2ThreadProjection,
+  predicate: (run: OrchestrationV2ThreadProjection["runs"][number]) => boolean,
+): OrchestrationV2ThreadProjection["runs"][number] | null {
+  return projection.runs.reduce<OrchestrationV2ThreadProjection["runs"][number] | null>(
+    (latest, candidate) =>
+      predicate(candidate) && (latest === null || candidate.ordinal > latest.ordinal)
+        ? candidate
+        : latest,
+    null,
+  );
+}
+
+function summarizeThreadRun(
+  projection: OrchestrationV2ThreadProjection,
+  run: OrchestrationV2ThreadProjection["runs"][number],
+): ThreadRunSummary {
+  return {
+    runId: run.id,
+    status: run.status,
+    requestedAt: DateTime.formatIso(run.requestedAt),
+    startedAt: run.startedAt === null ? null : DateTime.formatIso(run.startedAt),
+    completedAt: run.completedAt === null ? null : DateTime.formatIso(run.completedAt),
+    assistantMessageId:
+      projection.messages.findLast(
+        (message) => message.runId === run.id && message.role === "assistant",
+      )?.id ?? null,
+    ...(run.sourcePlanRef === undefined ? {} : { sourcePlanRef: run.sourcePlanRef }),
+  };
+}
+
+export function deriveLatestThreadRun(
+  projection: OrchestrationV2ThreadProjection,
+): ThreadRunSummary | null {
+  const run = latestMatchingRun(projection, () => true);
+  return run === null ? null : summarizeThreadRun(projection, run);
+}
+
+/**
+ * Returns the run that owns live provider work, falling back to the newest run
+ * once the thread is idle. A newer queued run must not make an older executing
+ * run look settled in clients that render per-run activity.
+ */
+export function deriveThreadActivityRun(
+  projection: OrchestrationV2ThreadProjection,
+): ThreadRunSummary | null {
+  const run =
+    latestMatchingRun(projection, (candidate) => ACTIVITY_RUN_STATUSES.has(candidate.status)) ??
+    latestMatchingRun(projection, () => true);
+  return run === null ? null : summarizeThreadRun(projection, run);
+}
+
+export function deriveThreadRuntime(
+  projection: OrchestrationV2ThreadProjection,
+): ThreadRuntimeSummary | null {
+  const latestRun = deriveLatestThreadRun(projection);
+  const latestRunProjection = latestMatchingRun(projection, () => true);
+  const activityRun = deriveThreadActivityRun(projection);
+  const providerSession = projection.providerSessions.findLast(
+    (session) => session.providerInstanceId === projection.thread.providerInstanceId,
+  );
+  if (latestRun === null && projection.thread.activeProviderThreadId === null) return null;
+  const activeRunId =
+    latestMatchingRun(projection, (run) => INTERRUPTIBLE_RUN_STATUSES.has(run.status))?.id ?? null;
+  const hasPendingBackgroundTasks =
+    derivePendingBackgroundWork({
+      latestRun: latestRunProjection,
+      providerThreads: projection.providerThreads,
+      turnItems: projection.turnItems,
+      activeProviderThreadId: projection.thread.activeProviderThreadId,
+      runs: projection.runs,
+    }).length > 0;
+  return {
+    status: hasPendingBackgroundTasks ? "idle" : (activityRun?.status ?? "idle"),
+    activeRunId,
+    providerInstanceId: projection.thread.providerInstanceId,
+    providerName: providerSession?.driver ?? null,
+    lastError: providerSession?.lastError ?? null,
+    updatedAt: DateTime.formatIso(projection.updatedAt),
+  };
+}
+
+export function threadRuntimeHasInterruptibleRun(
+  runtime: ThreadRuntimeSummary | null | undefined,
+): boolean {
+  return (
+    threadRuntimeIsActive(runtime) &&
+    runtime?.activeRunId !== null &&
+    runtime?.activeRunId !== undefined
+  );
+}
diff --git a/packages/client-runtime/src/state/threadFeedback.test.ts b/packages/client-runtime/src/state/threadFeedback.test.ts
index 14ce5185f4ad..5a9048c3bef9 100644
--- a/packages/client-runtime/src/state/threadFeedback.test.ts
+++ b/packages/client-runtime/src/state/threadFeedback.test.ts
@@ -4,12 +4,27 @@ import * as Cause from "effect/Cause";
 import { AsyncResult } from "effect/unstable/reactivity";
 
 import {
+  beginCodexFeedbackSubmission,
   codexFeedbackMessage,
   parseCodexFeedbackCommand,
   submitCodexFeedback,
   type CodexFeedbackSubmission,
 } from "./threadFeedback.ts";
 
+describe("beginCodexFeedbackSubmission", () => {
+  it("allows only one upload per thread until the active upload releases its guard", () => {
+    const inFlight = new Set<string>();
+    const finish = beginCodexFeedbackSubmission(inFlight, "environment:thread");
+
+    expect(finish).not.toBeNull();
+    expect(beginCodexFeedbackSubmission(inFlight, "environment:thread")).toBeNull();
+    expect(beginCodexFeedbackSubmission(inFlight, "environment:other-thread")).not.toBeNull();
+
+    finish?.();
+    expect(beginCodexFeedbackSubmission(inFlight, "environment:thread")).not.toBeNull();
+  });
+});
+
 describe("parseCodexFeedbackCommand", () => {
   it("accepts feedback without a reason", () => {
     expect(parseCodexFeedbackCommand(" /feedback ")).toEqual({});
diff --git a/packages/client-runtime/src/state/threadFeedback.ts b/packages/client-runtime/src/state/threadFeedback.ts
index 29abb2689310..0da5e44eac4e 100644
--- a/packages/client-runtime/src/state/threadFeedback.ts
+++ b/packages/client-runtime/src/state/threadFeedback.ts
@@ -32,6 +32,15 @@ export function parseCodexFeedbackCommand(text: string): { readonly reason?: str
   return reason ? { reason } : {};
 }
 
+export function beginCodexFeedbackSubmission(
+  submissionsInFlight: Set<string>,
+  threadKey: string,
+): (() => void) | null {
+  if (submissionsInFlight.has(threadKey)) return null;
+  submissionsInFlight.add(threadKey);
+  return () => submissionsInFlight.delete(threadKey);
+}
+
 export function codexFeedbackMessage(
   submission: CodexFeedbackSubmission,
   role: "user" | "assistant" = "user",
diff --git a/packages/client-runtime/src/state/threadHistoryController.test.ts b/packages/client-runtime/src/state/threadHistoryController.test.ts
new file mode 100644
index 000000000000..642dc25e8d10
--- /dev/null
+++ b/packages/client-runtime/src/state/threadHistoryController.test.ts
@@ -0,0 +1,66 @@
+import type { EnvironmentId, ThreadId } from "@t3tools/contracts";
+import { describe, expect, it } from "@effect/vitest";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+
+import {
+  ThreadHistoryController,
+  threadHistoryControllerLayer,
+  type ThreadHistoryHandler,
+  type ThreadHistoryLoadEarlierResult,
+} from "./threadHistoryController.ts";
+
+const ENV = "env-history" as EnvironmentId;
+const THREAD = "thread-history" as ThreadId;
+
+function handler(
+  tag: string,
+): ThreadHistoryHandler & { readonly tag: string; readonly calls: number } {
+  const state = { tag, calls: 0 };
+  return {
+    get tag() {
+      return state.tag;
+    },
+    get calls() {
+      return state.calls;
+    },
+    loadEarlier: () => {
+      state.calls += 1;
+      return Effect.succeed({ _tag: "loaded" } satisfies ThreadHistoryLoadEarlierResult);
+    },
+  };
+}
+
+describe("ThreadHistoryController", () => {
+  it.effect("does not let an older finalizer delete a newer registration", () =>
+    Effect.gen(function* () {
+      const controller = yield* ThreadHistoryController;
+      const older = handler("older");
+      const newer = handler("newer");
+
+      const olderRegistration = yield* controller.register(ENV, THREAD, older);
+      const newerRegistration = yield* controller.register(ENV, THREAD, newer);
+
+      // Older fiber finalizes after the newer handler is already registered.
+      yield* controller.unregister(olderRegistration);
+
+      const result = yield* controller.loadEarlier(ENV, THREAD);
+      expect(result).toEqual({ _tag: "loaded" });
+      expect(newer.calls).toBe(1);
+      expect(older.calls).toBe(0);
+
+      yield* controller.unregister(newerRegistration);
+      expect(yield* controller.loadEarlier(ENV, THREAD)).toEqual({ _tag: "noop" });
+    }).pipe(Effect.provide(threadHistoryControllerLayer)),
+  );
+
+  it.effect("unregister removes only its own matching registration", () =>
+    Effect.gen(function* () {
+      const controller = yield* ThreadHistoryController;
+      const first = handler("first");
+      const registration = yield* controller.register(ENV, THREAD, first);
+      yield* controller.unregister(registration);
+      expect(yield* controller.loadEarlier(ENV, THREAD)).toEqual({ _tag: "noop" });
+    }).pipe(Effect.provide(Layer.fresh(threadHistoryControllerLayer))),
+  );
+});
diff --git a/packages/client-runtime/src/state/threadHistoryController.ts b/packages/client-runtime/src/state/threadHistoryController.ts
new file mode 100644
index 000000000000..4fde44b108bf
--- /dev/null
+++ b/packages/client-runtime/src/state/threadHistoryController.ts
@@ -0,0 +1,93 @@
+import type { EnvironmentId, ThreadId } from "@t3tools/contracts";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Ref from "effect/Ref";
+
+import { threadKey } from "./entities.ts";
+
+export type ThreadHistoryLoadEarlierResult =
+  | { readonly _tag: "loaded" }
+  | { readonly _tag: "noop" }
+  | { readonly _tag: "busy" }
+  | { readonly _tag: "error"; readonly message: string };
+
+export type ThreadHistoryHandler = {
+  readonly loadEarlier: () => Effect.Effect<ThreadHistoryLoadEarlierResult>;
+};
+
+/**
+ * Opaque registration token returned by `register`. Finalizers must pass the
+ * same token so an older fiber cannot delete a newer handler for the key.
+ */
+export type ThreadHistoryRegistration = {
+  readonly environmentId: EnvironmentId;
+  readonly threadId: ThreadId;
+  readonly handler: ThreadHistoryHandler;
+};
+
+/**
+ * Per-thread registration for progressive history loads. Thread state fibers
+ * register while active; mobile UI dispatches through `loadEarlier`.
+ */
+export class ThreadHistoryController extends Context.Service<
+  ThreadHistoryController,
+  {
+    readonly register: (
+      environmentId: EnvironmentId,
+      threadId: ThreadId,
+      handler: ThreadHistoryHandler,
+    ) => Effect.Effect<ThreadHistoryRegistration>;
+    readonly unregister: (registration: ThreadHistoryRegistration) => Effect.Effect<void>;
+    readonly loadEarlier: (
+      environmentId: EnvironmentId,
+      threadId: ThreadId,
+    ) => Effect.Effect<ThreadHistoryLoadEarlierResult>;
+  }
+>()("@t3tools/client-runtime/state/threadHistoryController") {}
+
+export const threadHistoryControllerLayer: Layer.Layer<ThreadHistoryController> = Layer.effect(
+  ThreadHistoryController,
+  Effect.gen(function* () {
+    const handlers = yield* Ref.make(new Map<string, ThreadHistoryHandler>());
+    return ThreadHistoryController.of({
+      register: (environmentId, threadId, handler) =>
+        Ref.update(handlers, (current) => {
+          const next = new Map(current);
+          next.set(threadKey({ environmentId, threadId }), handler);
+          return next;
+        }).pipe(
+          Effect.as({
+            environmentId,
+            threadId,
+            handler,
+          } satisfies ThreadHistoryRegistration),
+        ),
+      unregister: (registration) =>
+        Ref.update(handlers, (current) => {
+          const key = threadKey({
+            environmentId: registration.environmentId,
+            threadId: registration.threadId,
+          });
+          // Only remove when this registration still owns the slot. An older
+          // fiber finalizer must not delete a newer handler for the same key.
+          if (current.get(key) !== registration.handler) {
+            return current;
+          }
+          const next = new Map(current);
+          next.delete(key);
+          return next;
+        }),
+      loadEarlier: (environmentId, threadId) =>
+        Ref.get(handlers).pipe(
+          Effect.flatMap((current) => {
+            const handler = current.get(threadKey({ environmentId, threadId }));
+            if (handler === undefined) {
+              return Effect.succeed({ _tag: "noop" } satisfies ThreadHistoryLoadEarlierResult);
+            }
+            return handler.loadEarlier();
+          }),
+        ),
+    });
+  }),
+);
diff --git a/packages/client-runtime/src/state/threadHistoryHttp.ts b/packages/client-runtime/src/state/threadHistoryHttp.ts
new file mode 100644
index 000000000000..50ef38f6851c
--- /dev/null
+++ b/packages/client-runtime/src/state/threadHistoryHttp.ts
@@ -0,0 +1,49 @@
+import type { ThreadId } from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+
+import type { PreparedConnection } from "../connection/model.ts";
+import { environmentEndpointUrl } from "../environment/endpoint.ts";
+import { ManagedRelayDpopSigner } from "../relay/managedRelay.ts";
+import { executeEnvironmentHttpRequest, makeEnvironmentHttpApiClient } from "../rpc/http.ts";
+import {
+  buildEnvironmentAuthHeaders,
+  withEnvironmentCredentials,
+  withOrchestrationProtocolHeader,
+} from "./environmentHttpAuth.ts";
+
+const DEFAULT_THREAD_HISTORY_TIMEOUT_MS = 6_000;
+
+export const fetchEnvironmentThreadHistoryPage = Effect.fn(
+  "clientRuntime.state.fetchEnvironmentThreadHistoryPage",
+)(function* (input: {
+  readonly prepared: PreparedConnection;
+  readonly threadId: ThreadId;
+  readonly cursor: string;
+  readonly signer: Option.Option<ManagedRelayDpopSigner["Service"]>;
+  readonly timeoutMs?: number;
+}) {
+  const requestUrl = environmentEndpointUrl(
+    input.prepared.httpBaseUrl,
+    `/api/orchestration/threads/${input.threadId}/history`,
+  );
+  const client = yield* makeEnvironmentHttpApiClient(input.prepared.httpBaseUrl);
+  const headers = yield* buildEnvironmentAuthHeaders(
+    input.prepared.httpAuthorization,
+    "GET",
+    requestUrl,
+    input.signer,
+  );
+  return yield* executeEnvironmentHttpRequest(
+    requestUrl,
+    input.timeoutMs ?? DEFAULT_THREAD_HISTORY_TIMEOUT_MS,
+    withEnvironmentCredentials(
+      input.prepared.httpAuthorization,
+      client.orchestration.threadHistoryPage({
+        params: { threadId: input.threadId },
+        query: { cursor: input.cursor },
+        headers: withOrchestrationProtocolHeader(headers),
+      }),
+    ),
+  );
+});
diff --git a/packages/client-runtime/src/state/threadHistoryMerge.test.ts b/packages/client-runtime/src/state/threadHistoryMerge.test.ts
new file mode 100644
index 000000000000..0952e3eedd52
--- /dev/null
+++ b/packages/client-runtime/src/state/threadHistoryMerge.test.ts
@@ -0,0 +1,416 @@
+import type { OrchestrationV2ProjectedTurnItem } from "@t3tools/contracts";
+import { describe, expect, it } from "@effect/vitest";
+import * as DateTime from "effect/DateTime";
+
+import { v2Projection, v2ThreadId } from "./orchestrationV2TestFixtures.ts";
+import {
+  applyHistoryPageMeta,
+  clearActiveHistoryLoading,
+  isActiveHistoryRequestCursor,
+  mergeOlderHistoryIntoProjection,
+  shouldShowLoadEarlierControl,
+} from "./threadHistoryMerge.ts";
+import { applyOrchestrationV2ProjectionEvent } from "./orchestrationV2Projection.ts";
+
+const NOW = DateTime.makeUnsafe("2026-06-20T00:00:00.000Z");
+
+function row(index: number): OrchestrationV2ProjectedTurnItem {
+  const id = `item-${index}` as never;
+  return {
+    position: index,
+    visibility: "local",
+    sourceThreadId: v2ThreadId,
+    sourceItemId: id,
+    item: {
+      id,
+      type: "command_execution",
+      threadId: v2ThreadId,
+      runId: null,
+      nodeId: null,
+      providerThreadId: null,
+      providerTurnId: null,
+      nativeItemRef: null,
+      parentItemId: null,
+      ordinal: index + 1,
+      status: "completed",
+      title: `Command ${index}`,
+      input: `cmd-${index}`,
+      output: `out-${index}`,
+      exitCode: 0,
+      startedAt: NOW,
+      completedAt: NOW,
+      updatedAt: NOW,
+    },
+  };
+}
+
+describe("threadHistoryMerge", () => {
+  it("prepends older rows and dedupes by source identity", () => {
+    const recent = [row(2), row(3)];
+    const projection = {
+      ...v2Projection,
+      turnItems: recent.map((entry) => entry.item),
+      visibleTurnItems: recent.map((entry, position) => ({ ...entry, position })),
+    };
+    const older = [row(0), row(1), row(2)];
+    const merged = mergeOlderHistoryIntoProjection(projection, older);
+    expect(merged.visibleTurnItems.map((entry) => entry.sourceItemId)).toEqual([
+      "item-0",
+      "item-1",
+      "item-2",
+      "item-3",
+    ]);
+    expect(merged.visibleTurnItems.map((entry) => entry.position)).toEqual([0, 1, 2, 3]);
+    expect(merged.turnItems.map((item) => item.id)).toEqual([
+      "item-2",
+      "item-3",
+      "item-0",
+      "item-1",
+    ]);
+  });
+
+  it("retains live rows that arrived after the older page was fetched", () => {
+    const live = [row(5), row(6)];
+    const projection = {
+      ...v2Projection,
+      turnItems: live.map((entry) => entry.item),
+      visibleTurnItems: live.map((entry, position) => ({ ...entry, position })),
+    };
+    const older = [row(3), row(4)];
+    const merged = mergeOlderHistoryIntoProjection(projection, older);
+    expect(merged.visibleTurnItems.map((entry) => entry.sourceItemId)).toEqual([
+      "item-3",
+      "item-4",
+      "item-5",
+      "item-6",
+    ]);
+  });
+
+  it("does not resurrect a local item hidden while an older page was in flight", () => {
+    const stalePageRow = row(1);
+    const currentItem = {
+      ...stalePageRow.item,
+      output: "newer live output",
+      updatedAt: DateTime.makeUnsafe("2026-06-20T00:00:01.000Z"),
+    };
+    const projection = {
+      ...v2Projection,
+      turnItems: [currentItem],
+      visibleTurnItems: [],
+    };
+
+    const merged = mergeOlderHistoryIntoProjection(projection, [stalePageRow]);
+
+    expect(merged).toBe(projection);
+    expect(merged.turnItems).toEqual([currentItem]);
+    expect(merged.visibleTurnItems).toEqual([]);
+  });
+
+  it("marks history expanded after a successful page", () => {
+    const next = applyHistoryPageMeta(
+      {
+        historyCursor: "cursor-a",
+        hasMoreHistory: true,
+        loading: true,
+        error: null,
+        expanded: false,
+        latestLocalTurnOrdinal: 42,
+      },
+      { nextCursor: "cursor-b", hasMoreHistory: true },
+    );
+    expect(next).toEqual({
+      historyCursor: "cursor-b",
+      hasMoreHistory: true,
+      loading: false,
+      error: null,
+      expanded: true,
+      latestLocalTurnOrdinal: 42,
+    });
+  });
+
+  it("only applies history responses for the active request cursor", () => {
+    expect(isActiveHistoryRequestCursor("cursor-a", { historyCursor: "cursor-a" })).toBe(true);
+    expect(isActiveHistoryRequestCursor("cursor-a", { historyCursor: "cursor-b" })).toBe(false);
+    expect(isActiveHistoryRequestCursor("cursor-a", { historyCursor: null })).toBe(false);
+  });
+
+  it("clears loading on interrupt only for the active request cursor", () => {
+    const loading = {
+      historyCursor: "cursor-a",
+      hasMoreHistory: true,
+      loading: true,
+      error: null,
+      expanded: false,
+      latestLocalTurnOrdinal: 10,
+    };
+    expect(clearActiveHistoryLoading("cursor-a", loading)).toEqual({
+      ...loading,
+      loading: false,
+    });
+    // Stale cursor must not mutate replacement progressive meta.
+    expect(
+      clearActiveHistoryLoading("cursor-a", { ...loading, historyCursor: "cursor-b" }),
+    ).toEqual({ ...loading, historyCursor: "cursor-b" });
+    // Already idle: identity-preserving no-op shape.
+    const idle = { ...loading, loading: false };
+    expect(clearActiveHistoryLoading("cursor-a", idle)).toBe(idle);
+  });
+
+  it("shows the load-earlier control when history remains or a local error is set", () => {
+    expect(
+      shouldShowLoadEarlierControl({
+        historyCursor: "c",
+        hasMoreHistory: true,
+        loading: false,
+        error: null,
+        expanded: false,
+        latestLocalTurnOrdinal: null,
+      }),
+    ).toBe(true);
+    expect(
+      shouldShowLoadEarlierControl({
+        historyCursor: null,
+        hasMoreHistory: false,
+        loading: false,
+        error: "Could not load earlier activity.",
+        expanded: true,
+        latestLocalTurnOrdinal: null,
+      }),
+    ).toBe(true);
+    expect(
+      shouldShowLoadEarlierControl({
+        historyCursor: null,
+        hasMoreHistory: false,
+        loading: false,
+        error: null,
+        expanded: false,
+        latestLocalTurnOrdinal: null,
+      }),
+    ).toBe(false);
+  });
+
+  it("retains merged older rows when a live turn-item update arrives", () => {
+    const recent = [row(2), row(3)];
+    const projection = {
+      ...v2Projection,
+      turnItems: recent.map((entry) => entry.item),
+      visibleTurnItems: recent.map((entry, position) => ({ ...entry, position })),
+    };
+    const merged = mergeOlderHistoryIntoProjection(projection, [row(0), row(1)]);
+    const liveItem = {
+      ...row(3).item,
+      output: "streamed",
+    };
+    const next = applyOrchestrationV2ProjectionEvent(merged, {
+      id: "event-live-item" as never,
+      type: "turn-item.updated",
+      threadId: v2ThreadId,
+      occurredAt: NOW,
+      payload: liveItem,
+    } as never);
+    expect(next?.visibleTurnItems.map((entry) => entry.sourceItemId)).toEqual([
+      "item-0",
+      "item-1",
+      "item-2",
+      "item-3",
+    ]);
+    expect(next?.visibleTurnItems[3]?.item).toEqual(liveItem);
+  });
+
+  it("keeps a history-page interrupt result visible when its request was retained at cold open", () => {
+    // Cold bounded window: only a recent filler. Request was retained in
+    // turnItems (not visible). Result arrives later via load-earlier merge.
+    const runId = "run-interrupt-cold" as never;
+    const nodeId = "node-interrupt-cold" as never;
+    const recent = row(5);
+    const requestItem = {
+      id: "item-interrupt-request" as never,
+      type: "run_interrupt_request" as const,
+      threadId: v2ThreadId,
+      runId,
+      nodeId,
+      providerThreadId: null,
+      providerTurnId: null,
+      nativeItemRef: null,
+      parentItemId: null,
+      ordinal: 1,
+      status: "completed" as const,
+      title: null,
+      message: "Stopping",
+      startedAt: NOW,
+      completedAt: NOW,
+      updatedAt: NOW,
+    };
+    const resultItem = {
+      id: "item-interrupt-result" as never,
+      type: "run_interrupt_result" as const,
+      threadId: v2ThreadId,
+      runId,
+      nodeId,
+      providerThreadId: null,
+      providerTurnId: null,
+      nativeItemRef: null,
+      parentItemId: null,
+      ordinal: 2,
+      status: "completed" as const,
+      title: null,
+      message: "Stopped",
+      startedAt: NOW,
+      completedAt: NOW,
+      updatedAt: NOW,
+    };
+    const resultRow = {
+      position: 0,
+      visibility: "local" as const,
+      sourceThreadId: v2ThreadId,
+      sourceItemId: resultItem.id,
+      item: resultItem,
+    };
+    const coldOpen = {
+      ...v2Projection,
+      runs: [
+        {
+          id: runId,
+          threadId: v2ThreadId,
+          ordinal: 1,
+          providerInstanceId: "codex" as never,
+          modelSelection: { instanceId: "codex" as never, model: "gpt-5" },
+          providerThreadId: null,
+          userMessageId: "message-1" as never,
+          rootNodeId: nodeId,
+          activeAttemptId: null,
+          status: "running" as const,
+          requestedAt: NOW,
+          startedAt: NOW,
+          completedAt: null,
+          checkpointId: null,
+          contextHandoffId: null,
+        },
+      ],
+      attempts: [
+        {
+          id: "attempt-1" as never,
+          runId,
+          attemptOrdinal: 1,
+          rootNodeId: nodeId,
+          providerInstanceId: "codex" as never,
+          providerThreadId: "provider-thread-1" as never,
+          providerTurnId: null,
+          reason: "initial" as const,
+          status: "running" as const,
+          startedAt: NOW,
+          completedAt: null,
+        },
+      ],
+      // Request retained from full projection; no result yet in the window.
+      turnItems: [requestItem, recent.item],
+      visibleTurnItems: [{ ...recent, position: 0 }],
+    };
+
+    const requestMerged = mergeOlderHistoryIntoProjection(coldOpen, [
+      {
+        position: 0,
+        visibility: "local",
+        sourceThreadId: v2ThreadId,
+        sourceItemId: requestItem.id,
+        item: requestItem,
+      },
+    ]);
+    expect(requestMerged.visibleTurnItems.map((entry) => String(entry.sourceItemId))).toEqual([
+      "item-interrupt-request",
+      "item-5",
+    ]);
+
+    const rolledBackRequestMerged = mergeOlderHistoryIntoProjection(
+      {
+        ...coldOpen,
+        runs: coldOpen.runs.map((run) => ({
+          ...run,
+          status: "rolled_back" as const,
+          completedAt: NOW,
+        })),
+      },
+      [
+        {
+          position: 0,
+          visibility: "local",
+          sourceThreadId: v2ThreadId,
+          sourceItemId: requestItem.id,
+          item: requestItem,
+        },
+      ],
+    );
+    expect(
+      rolledBackRequestMerged.visibleTurnItems.map((entry) => String(entry.sourceItemId)),
+    ).toEqual(["item-5"]);
+
+    const merged = mergeOlderHistoryIntoProjection(coldOpen, [resultRow]);
+    expect(merged.visibleTurnItems.map((entry) => String(entry.sourceItemId))).toEqual([
+      "item-interrupt-result",
+      "item-5",
+    ]);
+    expect(merged.turnItems.some((item) => item.type === "run_interrupt_request")).toBe(true);
+    expect(merged.turnItems.some((item) => item.type === "run_interrupt_result")).toBe(true);
+
+    const attemptSuperseded = applyOrchestrationV2ProjectionEvent(
+      merged,
+      {
+        id: "event-attempt-superseded" as never,
+        type: "run-attempt.updated",
+        threadId: v2ThreadId,
+        runId,
+        occurredAt: NOW,
+        payload: {
+          id: "attempt-1" as never,
+          runId,
+          attemptOrdinal: 1,
+          rootNodeId: nodeId,
+          providerInstanceId: "codex" as never,
+          providerThreadId: "provider-thread-1" as never,
+          providerTurnId: null,
+          reason: "initial",
+          status: "superseded",
+          startedAt: NOW,
+          completedAt: NOW,
+        },
+      } as never,
+      { partialTimeline: true },
+    );
+
+    expect(attemptSuperseded?.visibleTurnItems.map((entry) => String(entry.sourceItemId))).toEqual([
+      "item-interrupt-result",
+      "item-5",
+    ]);
+
+    // Without the cold-open retained request, the same update would hide the result.
+    const withoutRequest = {
+      ...merged,
+      turnItems: merged.turnItems.filter((item) => item.type !== "run_interrupt_request"),
+    };
+    const hidden = applyOrchestrationV2ProjectionEvent(
+      withoutRequest,
+      {
+        id: "event-attempt-superseded-missing" as never,
+        type: "run-attempt.updated",
+        threadId: v2ThreadId,
+        runId,
+        occurredAt: NOW,
+        payload: {
+          id: "attempt-1" as never,
+          runId,
+          attemptOrdinal: 1,
+          rootNodeId: nodeId,
+          providerInstanceId: "codex" as never,
+          providerThreadId: "provider-thread-1" as never,
+          providerTurnId: null,
+          reason: "initial",
+          status: "superseded",
+          startedAt: NOW,
+          completedAt: NOW,
+        },
+      } as never,
+      { partialTimeline: true },
+    );
+    expect(hidden?.visibleTurnItems.map((entry) => String(entry.sourceItemId))).toEqual(["item-5"]);
+  });
+});
diff --git a/packages/client-runtime/src/state/threadHistoryMerge.ts b/packages/client-runtime/src/state/threadHistoryMerge.ts
new file mode 100644
index 000000000000..6210686ec077
--- /dev/null
+++ b/packages/client-runtime/src/state/threadHistoryMerge.ts
@@ -0,0 +1,156 @@
+import type {
+  OrchestrationV2ProjectedTurnItem,
+  OrchestrationV2ThreadProjection,
+  OrchestrationV2TurnItem,
+} from "@t3tools/contracts";
+import { isOrchestrationV2TurnItemVisible } from "@t3tools/shared/orchestrationV2Timeline";
+
+export type ThreadHistoryMeta = {
+  readonly historyCursor: string | null;
+  readonly hasMoreHistory: boolean;
+  readonly loading: boolean;
+  readonly error: string | null;
+  /** True after at least one older page was merged; skip monolithic cache growth. */
+  readonly expanded: boolean;
+  /**
+   * Max local turn ordinal known for partial progressive windows. Null when
+   * unknown (legacy cache) or when history meta is cleared for a full snapshot.
+   */
+  readonly latestLocalTurnOrdinal: number | null;
+};
+
+export const EMPTY_THREAD_HISTORY_META: ThreadHistoryMeta = {
+  historyCursor: null,
+  hasMoreHistory: false,
+  loading: false,
+  error: null,
+  expanded: false,
+  latestLocalTurnOrdinal: null,
+};
+
+/** Whether a history-page response still matches the cursor that started it. */
+export function isActiveHistoryRequestCursor(
+  requestCursor: string,
+  history: { readonly historyCursor: string | null },
+): boolean {
+  return history.historyCursor === requestCursor;
+}
+
+/**
+ * Clear history loading after an interrupted load-earlier only when the
+ * request cursor is still active. Does not touch stream/status/error.
+ */
+export function clearActiveHistoryLoading(
+  requestCursor: string,
+  history: ThreadHistoryMeta,
+): ThreadHistoryMeta {
+  if (!isActiveHistoryRequestCursor(requestCursor, history) || !history.loading) {
+    return history;
+  }
+  return { ...history, loading: false };
+}
+
+function projectedItemKey(row: OrchestrationV2ProjectedTurnItem): string {
+  return `${row.sourceThreadId}:${row.sourceItemId}`;
+}
+
+function renumberVisible(
+  rows: ReadonlyArray<OrchestrationV2ProjectedTurnItem>,
+): OrchestrationV2ProjectedTurnItem[] {
+  return rows.map((row, position) => (row.position === position ? row : { ...row, position }));
+}
+
+/**
+ * Merge an older history page into the live projection. Dedupes by
+ * sourceThreadId + sourceItemId, keeps chronological order (older first), and
+ * preserves newer live rows already present in state.
+ */
+export function mergeOlderHistoryIntoProjection(
+  projection: OrchestrationV2ThreadProjection,
+  olderItems: ReadonlyArray<OrchestrationV2ProjectedTurnItem>,
+): OrchestrationV2ThreadProjection {
+  if (olderItems.length === 0) {
+    return projection;
+  }
+
+  const existingKeys = new Set(projection.visibleTurnItems.map(projectedItemKey));
+  const turnItemById = new Map<string, OrchestrationV2TurnItem>();
+  for (const item of projection.turnItems) {
+    turnItemById.set(String(item.id), item);
+  }
+  const prepended: OrchestrationV2ProjectedTurnItem[] = [];
+  for (const pageRow of olderItems) {
+    let row = pageRow;
+    const key = projectedItemKey(row);
+    if (existingKeys.has(key)) {
+      continue;
+    }
+    if (row.visibility === "local" || row.sourceThreadId === projection.thread.id) {
+      const currentItem = turnItemById.get(String(row.sourceItemId));
+      if (currentItem !== undefined) {
+        // A live event may have hidden this item while the page was in flight.
+        // Do not resurrect the stale page copy. Retained interrupt requests are
+        // the exception: they intentionally exist outside the bounded visible
+        // window and should become visible when their history page arrives.
+        if (currentItem.type !== "run_interrupt_request") {
+          continue;
+        }
+        if (
+          !isOrchestrationV2TurnItemVisible({
+            item: currentItem,
+            runs: projection.runs,
+            attempts: projection.attempts,
+            items: projection.turnItems,
+          })
+        ) {
+          continue;
+        }
+        row = { ...row, item: currentItem };
+      }
+    }
+    existingKeys.add(key);
+    prepended.push(row);
+  }
+  if (prepended.length === 0) {
+    return projection;
+  }
+
+  const visibleTurnItems = renumberVisible([...prepended, ...projection.visibleTurnItems]);
+
+  for (const row of prepended) {
+    if (row.visibility === "local" || row.sourceThreadId === projection.thread.id) {
+      if (!turnItemById.has(String(row.sourceItemId))) {
+        turnItemById.set(String(row.sourceItemId), row.item);
+      }
+    }
+  }
+
+  return {
+    ...projection,
+    turnItems: [...turnItemById.values()],
+    visibleTurnItems,
+  };
+}
+
+export function applyHistoryPageMeta(
+  current: ThreadHistoryMeta,
+  page: {
+    readonly nextCursor: string | null;
+    readonly hasMoreHistory: boolean;
+  },
+): ThreadHistoryMeta {
+  return {
+    historyCursor: page.nextCursor,
+    hasMoreHistory: page.hasMoreHistory,
+    loading: false,
+    error: null,
+    expanded: true,
+    // Preserve the partial-timeline watermark across load-earlier pages.
+    latestLocalTurnOrdinal: current.latestLocalTurnOrdinal,
+  };
+}
+
+/** Whether a client timeline should render its load-earlier control. */
+export function shouldShowLoadEarlierControl(history: ThreadHistoryMeta): boolean {
+  return history.hasMoreHistory || history.error !== null;
+}
diff --git a/packages/client-runtime/src/state/threadReducer.test.ts b/packages/client-runtime/src/state/threadReducer.test.ts
deleted file mode 100644
index 2042b2168c88..000000000000
--- a/packages/client-runtime/src/state/threadReducer.test.ts
+++ /dev/null
@@ -1,949 +0,0 @@
-import { describe, expect, it } from "vite-plus/test";
-
-import {
-  CheckpointRef,
-  CommandId,
-  EventId,
-  MessageId,
-  ProjectId,
-  ProviderInstanceId,
-  ThreadId,
-  TurnId,
-} from "@t3tools/contracts";
-import type { OrchestrationThread } from "@t3tools/contracts";
-
-import { applyThreadDetailEvent } from "./threadReducer.ts";
-
-const baseEventFields = {
-  eventId: EventId.make("event-1"),
-  commandId: null,
-  causationEventId: null,
-  correlationId: null,
-  metadata: {},
-} as const;
-
-const baseThread: OrchestrationThread = {
-  id: ThreadId.make("thread-1"),
-  projectId: ProjectId.make("project-1"),
-  title: "Test Thread",
-  modelSelection: { instanceId: ProviderInstanceId.make("codex"), model: "gpt-5.4" },
-  runtimeMode: "full-access",
-  interactionMode: "default",
-  branch: null,
-  worktreePath: null,
-  latestTurn: null,
-  createdAt: "2026-04-01T00:00:00.000Z",
-  updatedAt: "2026-04-01T00:00:00.000Z",
-  archivedAt: null,
-  settledOverride: null,
-  settledAt: null,
-  deletedAt: null,
-  messages: [],
-  proposedPlans: [],
-  activities: [],
-  checkpoints: [],
-  session: null,
-};
-
-describe("applyThreadDetailEvent", () => {
-  describe("project events", () => {
-    it("returns unchanged for project.created", () => {
-      const result = applyThreadDetailEvent(baseThread, {
-        ...baseEventFields,
-        sequence: 1,
-        occurredAt: "2026-04-01T01:00:00.000Z",
-        aggregateKind: "project",
-        aggregateId: ProjectId.make("project-1"),
-        type: "project.created",
-        payload: {
-          projectId: ProjectId.make("project-1"),
-          title: "T3 Code",
-          workspaceRoot: "/repo",
-          repositoryIdentity: null,
-          defaultModelSelection: null,
-          scripts: [],
-          createdAt: "2026-04-01T01:00:00.000Z",
-          updatedAt: "2026-04-01T01:00:00.000Z",
-          deletedAt: null,
-        },
-      } as any);
-      expect(result.kind).toBe("unchanged");
-    });
-  });
-
-  describe("thread.created", () => {
-    it("creates a fresh thread", () => {
-      const result = applyThreadDetailEvent(baseThread, {
-        ...baseEventFields,
-        sequence: 1,
-        occurredAt: "2026-04-01T01:00:00.000Z",
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-2"),
-        type: "thread.created",
-        payload: {
-          threadId: ThreadId.make("thread-2"),
-          projectId: ProjectId.make("project-1"),
-          title: "New Thread",
-          modelSelection: { instanceId: ProviderInstanceId.make("codex"), model: "gpt-5.4" },
-          runtimeMode: "full-access",
-          interactionMode: "default",
-          branch: "main",
-          worktreePath: null,
-          createdAt: "2026-04-01T01:00:00.000Z",
-          updatedAt: "2026-04-01T01:00:00.000Z",
-        },
-      });
-
-      expect(result.kind).toBe("updated");
-      if (result.kind === "updated") {
-        expect(result.thread.id).toBe("thread-2");
-        expect(result.thread.title).toBe("New Thread");
-        expect(result.thread.branch).toBe("main");
-        expect(result.thread.messages).toEqual([]);
-        expect(result.thread.session).toBeNull();
-      }
-    });
-  });
-
-  describe("thread.deleted", () => {
-    it("returns deleted signal", () => {
-      const result = applyThreadDetailEvent(baseThread, {
-        ...baseEventFields,
-        sequence: 2,
-        occurredAt: "2026-04-01T02:00:00.000Z",
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-1"),
-        type: "thread.deleted",
-        payload: {
-          threadId: ThreadId.make("thread-1"),
-          deletedAt: "2026-04-01T02:00:00.000Z",
-        },
-      });
-      expect(result.kind).toBe("deleted");
-    });
-  });
-
-  describe("thread.archived / thread.unarchived", () => {
-    it("sets archivedAt and clears title regeneration", () => {
-      const regeneratingThread: OrchestrationThread = {
-        ...baseThread,
-        titleRegeneration: {
-          requestId: CommandId.make("regenerate-title"),
-          startedAt: "2026-04-01T02:00:00.000Z",
-        },
-      };
-      const result = applyThreadDetailEvent(regeneratingThread, {
-        ...baseEventFields,
-        sequence: 3,
-        occurredAt: "2026-04-01T03:00:00.000Z",
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-1"),
-        type: "thread.archived",
-        payload: {
-          threadId: ThreadId.make("thread-1"),
-          archivedAt: "2026-04-01T03:00:00.000Z",
-          updatedAt: "2026-04-01T03:00:00.000Z",
-        },
-      });
-
-      expect(result.kind).toBe("updated");
-      if (result.kind === "updated") {
-        expect(result.thread.archivedAt).toBe("2026-04-01T03:00:00.000Z");
-        expect(result.thread.titleRegeneration).toBeNull();
-      }
-    });
-
-    it("clears archivedAt", () => {
-      const archivedThread = { ...baseThread, archivedAt: "2026-04-01T03:00:00.000Z" };
-      const result = applyThreadDetailEvent(archivedThread, {
-        ...baseEventFields,
-        sequence: 4,
-        occurredAt: "2026-04-01T04:00:00.000Z",
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-1"),
-        type: "thread.unarchived",
-        payload: {
-          threadId: ThreadId.make("thread-1"),
-          updatedAt: "2026-04-01T04:00:00.000Z",
-        },
-      });
-
-      expect(result.kind).toBe("updated");
-      if (result.kind === "updated") {
-        expect(result.thread.archivedAt).toBeNull();
-      }
-    });
-  });
-
-  describe("thread.settled / thread.unsettled", () => {
-    it("sets the settled override and timestamp", () => {
-      const settledAt = "2026-04-01T05:00:00.000Z";
-      const result = applyThreadDetailEvent(baseThread, {
-        ...baseEventFields,
-        sequence: 5,
-        occurredAt: settledAt,
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-1"),
-        type: "thread.settled",
-        payload: {
-          threadId: ThreadId.make("thread-1"),
-          settledAt,
-          updatedAt: settledAt,
-        },
-      });
-
-      expect(result.kind).toBe("updated");
-      if (result.kind === "updated") {
-        expect(result.thread.settledOverride).toBe("settled");
-        expect(result.thread.settledAt).toBe(settledAt);
-      }
-    });
-
-    it.each([
-      ["user", "active"],
-      ["activity", null],
-    ] as const)("unsettles for %s with override %s", (reason, settledOverride) => {
-      const settledThread: OrchestrationThread = {
-        ...baseThread,
-        settledOverride: "settled",
-        settledAt: "2026-04-01T05:00:00.000Z",
-      };
-      const updatedAt = "2026-04-01T06:00:00.000Z";
-      const result = applyThreadDetailEvent(settledThread, {
-        ...baseEventFields,
-        sequence: 6,
-        occurredAt: updatedAt,
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-1"),
-        type: "thread.unsettled",
-        payload: {
-          threadId: ThreadId.make("thread-1"),
-          reason,
-          updatedAt,
-        },
-      });
-
-      expect(result.kind).toBe("updated");
-      if (result.kind === "updated") {
-        expect(result.thread.settledOverride).toBe(settledOverride);
-        expect(result.thread.settledAt).toBeNull();
-      }
-    });
-  });
-
-  describe("thread.pinned / thread.unpinned", () => {
-    it("sets pinnedAt", () => {
-      const pinnedAt = "2026-04-01T05:00:00.000Z";
-      const result = applyThreadDetailEvent(baseThread, {
-        ...baseEventFields,
-        sequence: 5,
-        occurredAt: pinnedAt,
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-1"),
-        type: "thread.pinned",
-        payload: {
-          threadId: ThreadId.make("thread-1"),
-          pinnedAt,
-          updatedAt: pinnedAt,
-        },
-      });
-
-      expect(result.kind).toBe("updated");
-      if (result.kind === "updated") {
-        expect(result.thread.pinnedAt).toBe(pinnedAt);
-      }
-    });
-
-    it("clears pinnedAt", () => {
-      const pinnedThread: OrchestrationThread = {
-        ...baseThread,
-        pinnedAt: "2026-04-01T05:00:00.000Z",
-      };
-      const updatedAt = "2026-04-01T06:00:00.000Z";
-      const result = applyThreadDetailEvent(pinnedThread, {
-        ...baseEventFields,
-        sequence: 6,
-        occurredAt: updatedAt,
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-1"),
-        type: "thread.unpinned",
-        payload: {
-          threadId: ThreadId.make("thread-1"),
-          updatedAt,
-        },
-      });
-
-      expect(result.kind).toBe("updated");
-      if (result.kind === "updated") {
-        expect(result.thread.pinnedAt).toBeNull();
-      }
-    });
-  });
-
-  describe("thread.meta-updated", () => {
-    it("patches title and branch", () => {
-      const result = applyThreadDetailEvent(baseThread, {
-        ...baseEventFields,
-        sequence: 5,
-        occurredAt: "2026-04-01T05:00:00.000Z",
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-1"),
-        type: "thread.meta-updated",
-        payload: {
-          threadId: ThreadId.make("thread-1"),
-          title: "Updated Title",
-          branch: "feature/demo",
-          updatedAt: "2026-04-01T05:00:00.000Z",
-        },
-      });
-
-      expect(result.kind).toBe("updated");
-      if (result.kind === "updated") {
-        expect(result.thread.title).toBe("Updated Title");
-        expect(result.thread.branch).toBe("feature/demo");
-        // Model selection should be unchanged since it wasn't in the payload
-        expect(result.thread.modelSelection).toEqual(baseThread.modelSelection);
-      }
-    });
-
-    it("sets and clears a linked pull request", () => {
-      const linkedPullRequest = {
-        projectId: ProjectId.make("project-1"),
-        repository: "pingdotgg/t3code",
-        number: 42,
-        url: "https://github.com/pingdotgg/t3code/pull/42",
-      };
-      const linked = applyThreadDetailEvent(baseThread, {
-        ...baseEventFields,
-        sequence: 5,
-        occurredAt: "2026-04-01T05:00:00.000Z",
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-1"),
-        type: "thread.meta-updated",
-        payload: {
-          threadId: ThreadId.make("thread-1"),
-          linkedPullRequest,
-          updatedAt: "2026-04-01T05:00:00.000Z",
-        },
-      });
-
-      expect(linked.kind).toBe("updated");
-      if (linked.kind !== "updated") return;
-      expect(linked.thread.linkedPullRequest).toEqual(linkedPullRequest);
-
-      const cleared = applyThreadDetailEvent(linked.thread, {
-        ...baseEventFields,
-        sequence: 6,
-        occurredAt: "2026-04-01T06:00:00.000Z",
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-1"),
-        type: "thread.meta-updated",
-        payload: {
-          threadId: ThreadId.make("thread-1"),
-          linkedPullRequest: null,
-          updatedAt: "2026-04-01T06:00:00.000Z",
-        },
-      });
-
-      expect(cleared.kind).toBe("updated");
-      if (cleared.kind === "updated") {
-        expect(cleared.thread.linkedPullRequest).toBeNull();
-      }
-    });
-  });
-
-  describe("thread.message-sent", () => {
-    it("appends a new message", () => {
-      const result = applyThreadDetailEvent(baseThread, {
-        ...baseEventFields,
-        sequence: 6,
-        occurredAt: "2026-04-01T06:00:00.000Z",
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-1"),
-        type: "thread.message-sent",
-        payload: {
-          threadId: ThreadId.make("thread-1"),
-          messageId: MessageId.make("msg-1"),
-          role: "user",
-          text: "Hello, world!",
-          turnId: null,
-          streaming: false,
-          createdAt: "2026-04-01T06:00:00.000Z",
-          updatedAt: "2026-04-01T06:00:00.000Z",
-        },
-      });
-
-      expect(result.kind).toBe("updated");
-      if (result.kind === "updated") {
-        expect(result.thread.messages).toHaveLength(1);
-        expect(result.thread.messages[0]?.text).toBe("Hello, world!");
-      }
-    });
-
-    it("appends text for streaming messages", () => {
-      const threadWithMessage: OrchestrationThread = {
-        ...baseThread,
-        messages: [
-          {
-            id: MessageId.make("msg-2"),
-            role: "assistant",
-            text: "Hello",
-            turnId: TurnId.make("turn-1"),
-            streaming: true,
-            createdAt: "2026-04-01T06:00:00.000Z",
-            updatedAt: "2026-04-01T06:00:00.000Z",
-          },
-        ],
-      };
-
-      const result = applyThreadDetailEvent(threadWithMessage, {
-        ...baseEventFields,
-        sequence: 7,
-        occurredAt: "2026-04-01T06:01:00.000Z",
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-1"),
-        type: "thread.message-sent",
-        payload: {
-          threadId: ThreadId.make("thread-1"),
-          messageId: MessageId.make("msg-2"),
-          role: "assistant",
-          text: ", world!",
-          turnId: TurnId.make("turn-1"),
-          streaming: true,
-          createdAt: "2026-04-01T06:00:00.000Z",
-          updatedAt: "2026-04-01T06:01:00.000Z",
-        },
-      });
-
-      expect(result.kind).toBe("updated");
-      if (result.kind === "updated") {
-        expect(result.thread.messages).toHaveLength(1);
-        expect(result.thread.messages[0]?.text).toBe("Hello, world!");
-      }
-    });
-
-    it("updates latestTurn for assistant messages with a turn", () => {
-      const result = applyThreadDetailEvent(baseThread, {
-        ...baseEventFields,
-        sequence: 8,
-        occurredAt: "2026-04-01T07:00:00.000Z",
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-1"),
-        type: "thread.message-sent",
-        payload: {
-          threadId: ThreadId.make("thread-1"),
-          messageId: MessageId.make("msg-3"),
-          role: "assistant",
-          text: "Done.",
-          turnId: TurnId.make("turn-1"),
-          streaming: false,
-          createdAt: "2026-04-01T07:00:00.000Z",
-          updatedAt: "2026-04-01T07:00:00.000Z",
-        },
-      });
-
-      expect(result.kind).toBe("updated");
-      if (result.kind === "updated") {
-        expect(result.thread.latestTurn?.turnId).toBe("turn-1");
-        expect(result.thread.latestTurn?.state).toBe("completed");
-        expect(result.thread.latestTurn?.assistantMessageId).toBe("msg-3");
-      }
-    });
-
-    it("keeps latestTurn running for interim assistant messages while the session runs the turn", () => {
-      const threadWithRunningSession: OrchestrationThread = {
-        ...baseThread,
-        session: {
-          threadId: ThreadId.make("thread-1"),
-          status: "running",
-          providerName: "claude",
-          runtimeMode: "full-access",
-          activeTurnId: TurnId.make("turn-1"),
-          lastError: null,
-          updatedAt: "2026-04-01T06:59:00.000Z",
-        },
-        latestTurn: {
-          turnId: TurnId.make("turn-1"),
-          state: "running",
-          requestedAt: "2026-04-01T06:59:00.000Z",
-          startedAt: "2026-04-01T06:59:00.000Z",
-          completedAt: null,
-          assistantMessageId: null,
-        },
-      };
-
-      const result = applyThreadDetailEvent(threadWithRunningSession, {
-        ...baseEventFields,
-        sequence: 8,
-        occurredAt: "2026-04-01T07:00:00.000Z",
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-1"),
-        type: "thread.message-sent",
-        payload: {
-          threadId: ThreadId.make("thread-1"),
-          messageId: MessageId.make("msg-3"),
-          role: "assistant",
-          text: "Interim commentary between tool calls.",
-          turnId: TurnId.make("turn-1"),
-          streaming: false,
-          createdAt: "2026-04-01T07:00:00.000Z",
-          updatedAt: "2026-04-01T07:00:00.000Z",
-        },
-      });
-
-      expect(result.kind).toBe("updated");
-      if (result.kind === "updated") {
-        expect(result.thread.latestTurn?.state).toBe("running");
-        expect(result.thread.latestTurn?.completedAt).toBeNull();
-      }
-    });
-  });
-
-  describe("thread.session-set", () => {
-    it("settles a running latestTurn when the session leaves the running status", () => {
-      const threadWithRunningTurn: OrchestrationThread = {
-        ...baseThread,
-        latestTurn: {
-          turnId: TurnId.make("turn-1"),
-          state: "running",
-          requestedAt: "2026-04-01T07:00:00.000Z",
-          startedAt: "2026-04-01T07:00:00.000Z",
-          completedAt: null,
-          assistantMessageId: MessageId.make("msg-3"),
-        },
-      };
-
-      const result = applyThreadDetailEvent(threadWithRunningTurn, {
-        ...baseEventFields,
-        sequence: 9,
-        occurredAt: "2026-04-01T08:00:00.000Z",
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-1"),
-        type: "thread.session-set",
-        payload: {
-          threadId: ThreadId.make("thread-1"),
-          session: {
-            threadId: ThreadId.make("thread-1"),
-            status: "ready",
-            providerName: "claude",
-            runtimeMode: "full-access",
-            activeTurnId: null,
-            lastError: null,
-            updatedAt: "2026-04-01T08:00:00.000Z",
-          },
-        },
-      });
-
-      expect(result.kind).toBe("updated");
-      if (result.kind === "updated") {
-        expect(result.thread.latestTurn?.state).toBe("completed");
-        expect(result.thread.latestTurn?.completedAt).toBe("2026-04-01T08:00:00.000Z");
-      }
-    });
-
-    it("updates session and latestTurn for a running session", () => {
-      const result = applyThreadDetailEvent(baseThread, {
-        ...baseEventFields,
-        sequence: 9,
-        occurredAt: "2026-04-01T08:00:00.000Z",
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-1"),
-        type: "thread.session-set",
-        payload: {
-          threadId: ThreadId.make("thread-1"),
-          session: {
-            threadId: ThreadId.make("thread-1"),
-            status: "running",
-            providerName: "codex",
-            runtimeMode: "full-access",
-            activeTurnId: TurnId.make("turn-1"),
-            lastError: null,
-            updatedAt: "2026-04-01T08:00:00.000Z",
-          },
-        },
-      });
-
-      expect(result.kind).toBe("updated");
-      if (result.kind === "updated") {
-        expect(result.thread.session?.status).toBe("running");
-        expect(result.thread.latestTurn?.turnId).toBe("turn-1");
-        expect(result.thread.latestTurn?.state).toBe("running");
-      }
-    });
-  });
-
-  describe("thread.session-stop-requested", () => {
-    it("marks session as stopped", () => {
-      const threadWithSession: OrchestrationThread = {
-        ...baseThread,
-        session: {
-          threadId: ThreadId.make("thread-1"),
-          status: "running",
-          providerName: "codex",
-          runtimeMode: "full-access",
-          activeTurnId: TurnId.make("turn-1"),
-          lastError: null,
-          updatedAt: "2026-04-01T08:00:00.000Z",
-        },
-      };
-
-      const result = applyThreadDetailEvent(threadWithSession, {
-        ...baseEventFields,
-        sequence: 10,
-        occurredAt: "2026-04-01T09:00:00.000Z",
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-1"),
-        type: "thread.session-stop-requested",
-        payload: {
-          threadId: ThreadId.make("thread-1"),
-          createdAt: "2026-04-01T09:00:00.000Z",
-        },
-      });
-
-      expect(result.kind).toBe("updated");
-      if (result.kind === "updated") {
-        expect(result.thread.session?.status).toBe("stopped");
-        expect(result.thread.session?.activeTurnId).toBeNull();
-      }
-    });
-
-    it("returns unchanged when no session exists", () => {
-      const result = applyThreadDetailEvent(baseThread, {
-        ...baseEventFields,
-        sequence: 10,
-        occurredAt: "2026-04-01T09:00:00.000Z",
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-1"),
-        type: "thread.session-stop-requested",
-        payload: {
-          threadId: ThreadId.make("thread-1"),
-          createdAt: "2026-04-01T09:00:00.000Z",
-        },
-      });
-      expect(result.kind).toBe("unchanged");
-    });
-  });
-
-  describe("thread.proposed-plan-upserted", () => {
-    it("adds a proposed plan", () => {
-      const result = applyThreadDetailEvent(baseThread, {
-        ...baseEventFields,
-        sequence: 11,
-        occurredAt: "2026-04-01T10:00:00.000Z",
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-1"),
-        type: "thread.proposed-plan-upserted",
-        payload: {
-          threadId: ThreadId.make("thread-1"),
-          proposedPlan: {
-            id: "plan-1",
-            turnId: TurnId.make("turn-1"),
-            planMarkdown: "## Plan\n- Do stuff",
-            implementedAt: null,
-            implementationThreadId: null,
-            createdAt: "2026-04-01T10:00:00.000Z",
-            updatedAt: "2026-04-01T10:00:00.000Z",
-          },
-        },
-      });
-
-      expect(result.kind).toBe("updated");
-      if (result.kind === "updated") {
-        expect(result.thread.proposedPlans).toHaveLength(1);
-        expect(result.thread.proposedPlans[0]?.id).toBe("plan-1");
-      }
-    });
-  });
-
-  describe("thread.activity-appended", () => {
-    it("adds an activity", () => {
-      const result = applyThreadDetailEvent(baseThread, {
-        ...baseEventFields,
-        sequence: 12,
-        occurredAt: "2026-04-01T11:00:00.000Z",
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-1"),
-        type: "thread.activity-appended",
-        payload: {
-          threadId: ThreadId.make("thread-1"),
-          activity: {
-            id: EventId.make("activity-1"),
-            tone: "tool",
-            kind: "file-edit",
-            summary: "Edited src/index.ts",
-            payload: {},
-            turnId: TurnId.make("turn-1"),
-            createdAt: "2026-04-01T11:00:00.000Z",
-          },
-        },
-      });
-
-      expect(result.kind).toBe("updated");
-      if (result.kind === "updated") {
-        expect(result.thread.activities).toHaveLength(1);
-        expect(result.thread.activities[0]?.kind).toBe("file-edit");
-      }
-    });
-
-    it("preserves the complete activity history when live events arrive", () => {
-      const existingActivities = Array.from({ length: 129 }, (_, index) => ({
-        id: EventId.make(`activity-${index}`),
-        tone: "tool" as const,
-        kind: "command",
-        summary: `Ran command ${index}`,
-        payload: {},
-        turnId: TurnId.make("turn-1"),
-        sequence: index,
-        createdAt: "2026-04-01T11:00:00.000Z",
-      }));
-      const result = applyThreadDetailEvent(
-        { ...baseThread, activities: existingActivities },
-        {
-          ...baseEventFields,
-          sequence: 130,
-          occurredAt: "2026-04-01T11:01:00.000Z",
-          aggregateKind: "thread",
-          aggregateId: ThreadId.make("thread-1"),
-          type: "thread.activity-appended",
-          payload: {
-            threadId: ThreadId.make("thread-1"),
-            activity: {
-              id: EventId.make("activity-129"),
-              tone: "tool",
-              kind: "command",
-              summary: "Ran command 129",
-              payload: {},
-              turnId: TurnId.make("turn-1"),
-              sequence: 129,
-              createdAt: "2026-04-01T11:01:00.000Z",
-            },
-          },
-        },
-      );
-
-      expect(result.kind).toBe("updated");
-      if (result.kind === "updated") {
-        expect(result.thread.activities).toHaveLength(130);
-        expect(result.thread.activities[0]?.id).toBe("activity-0");
-      }
-    });
-
-    it("replaces earlier resolvable context-window updates for the same turn", () => {
-      const contextWindowActivity = (id: string, sequence: number, usedTokens: unknown) => ({
-        id: EventId.make(id),
-        tone: "info" as const,
-        kind: "context-window.updated",
-        summary: "Context window updated",
-        payload: { usedTokens },
-        turnId: TurnId.make("turn-1"),
-        sequence,
-        createdAt: "2026-04-01T11:00:00.000Z",
-      });
-      const otherTurnActivity = contextWindowActivity("activity-other-turn", 2, 500);
-      const existingActivities = [
-        contextWindowActivity("activity-cw-1", 1, 1_000),
-        { ...otherTurnActivity, turnId: TurnId.make("turn-0") },
-        // Malformed row (no usedTokens): must survive, and must not be
-        // treated as the latest value by consumers.
-        contextWindowActivity("activity-cw-malformed", 3, undefined),
-        contextWindowActivity("activity-cw-2", 4, 2_000),
-      ];
-
-      const result = applyThreadDetailEvent(
-        { ...baseThread, activities: existingActivities },
-        {
-          ...baseEventFields,
-          sequence: 20,
-          occurredAt: "2026-04-01T11:02:00.000Z",
-          aggregateKind: "thread",
-          aggregateId: ThreadId.make("thread-1"),
-          type: "thread.activity-appended",
-          payload: {
-            threadId: ThreadId.make("thread-1"),
-            activity: contextWindowActivity("activity-cw-3", 5, 3_000),
-          },
-        },
-      );
-
-      expect(result.kind).toBe("updated");
-      if (result.kind === "updated") {
-        const ids = result.thread.activities.map((activity) => activity.id);
-        // Same-turn resolvable rows collapse to the newest; the other turn's
-        // row and the malformed row are untouched.
-        expect(ids).toEqual(["activity-other-turn", "activity-cw-malformed", "activity-cw-3"]);
-      }
-    });
-
-    it("does not collapse context-window history for a malformed update", () => {
-      const resolvable = {
-        id: EventId.make("activity-cw-resolvable"),
-        tone: "info" as const,
-        kind: "context-window.updated",
-        summary: "Context window updated",
-        payload: { usedTokens: 1_000 },
-        turnId: TurnId.make("turn-1"),
-        sequence: 1,
-        createdAt: "2026-04-01T11:00:00.000Z",
-      };
-
-      const result = applyThreadDetailEvent(
-        { ...baseThread, activities: [resolvable] },
-        {
-          ...baseEventFields,
-          sequence: 21,
-          occurredAt: "2026-04-01T11:03:00.000Z",
-          aggregateKind: "thread",
-          aggregateId: ThreadId.make("thread-1"),
-          type: "thread.activity-appended",
-          payload: {
-            threadId: ThreadId.make("thread-1"),
-            activity: {
-              ...resolvable,
-              id: EventId.make("activity-cw-broken"),
-              payload: { usedTokens: Number.NaN },
-              sequence: 2,
-            },
-          },
-        },
-      );
-
-      expect(result.kind).toBe("updated");
-      if (result.kind === "updated") {
-        // The resolvable row must survive so consumers can still derive a
-        // usage value by walking backwards past the malformed row.
-        const ids = result.thread.activities.map((activity) => activity.id);
-        expect(ids).toEqual(["activity-cw-resolvable", "activity-cw-broken"]);
-      }
-    });
-  });
-
-  describe("thread.turn-diff-completed", () => {
-    it("adds a checkpoint and updates latestTurn", () => {
-      const result = applyThreadDetailEvent(baseThread, {
-        ...baseEventFields,
-        sequence: 13,
-        occurredAt: "2026-04-01T12:00:00.000Z",
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-1"),
-        type: "thread.turn-diff-completed",
-        payload: {
-          threadId: ThreadId.make("thread-1"),
-          turnId: TurnId.make("turn-1"),
-          checkpointTurnCount: 1,
-          checkpointRef: CheckpointRef.make("ref-1"),
-          status: "ready",
-          files: [],
-          assistantMessageId: MessageId.make("msg-3"),
-          completedAt: "2026-04-01T12:00:00.000Z",
-        },
-      });
-
-      expect(result.kind).toBe("updated");
-      if (result.kind === "updated") {
-        expect(result.thread.checkpoints).toHaveLength(1);
-        expect(result.thread.latestTurn?.turnId).toBe("turn-1");
-        expect(result.thread.latestTurn?.state).toBe("completed");
-      }
-    });
-  });
-
-  describe("thread.reverted", () => {
-    it("filters entities to retained turns", () => {
-      const threadWithData: OrchestrationThread = {
-        ...baseThread,
-        messages: [
-          {
-            id: MessageId.make("msg-1"),
-            role: "user",
-            text: "First",
-            turnId: null,
-            streaming: false,
-            createdAt: "2026-04-01T01:00:00.000Z",
-            updatedAt: "2026-04-01T01:00:00.000Z",
-          },
-          {
-            id: MessageId.make("msg-2"),
-            role: "assistant",
-            text: "Response 1",
-            turnId: TurnId.make("turn-1"),
-            streaming: false,
-            createdAt: "2026-04-01T02:00:00.000Z",
-            updatedAt: "2026-04-01T02:00:00.000Z",
-          },
-          {
-            id: MessageId.make("msg-3"),
-            role: "assistant",
-            text: "Response 2",
-            turnId: TurnId.make("turn-2"),
-            streaming: false,
-            createdAt: "2026-04-01T03:00:00.000Z",
-            updatedAt: "2026-04-01T03:00:00.000Z",
-          },
-        ],
-        checkpoints: [
-          {
-            turnId: TurnId.make("turn-1"),
-            checkpointTurnCount: 1,
-            checkpointRef: CheckpointRef.make("ref-1"),
-            status: "ready",
-            files: [],
-            assistantMessageId: MessageId.make("msg-2"),
-            completedAt: "2026-04-01T02:00:00.000Z",
-          },
-          {
-            turnId: TurnId.make("turn-2"),
-            checkpointTurnCount: 2,
-            checkpointRef: CheckpointRef.make("ref-2"),
-            status: "ready",
-            files: [],
-            assistantMessageId: MessageId.make("msg-3"),
-            completedAt: "2026-04-01T03:00:00.000Z",
-          },
-        ],
-      };
-
-      const result = applyThreadDetailEvent(threadWithData, {
-        ...baseEventFields,
-        sequence: 14,
-        occurredAt: "2026-04-01T04:00:00.000Z",
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-1"),
-        type: "thread.reverted",
-        payload: {
-          threadId: ThreadId.make("thread-1"),
-          turnCount: 1,
-        },
-      });
-
-      expect(result.kind).toBe("updated");
-      if (result.kind === "updated") {
-        // turn-2 checkpoint is filtered out (turnCount 2 > revert target 1)
-        expect(result.thread.checkpoints).toHaveLength(1);
-        expect(result.thread.checkpoints[0]?.turnId).toBe("turn-1");
-        // msg-3 (turn-2) is filtered, msg-1 (no turn) and msg-2 (turn-1) remain
-        expect(result.thread.messages).toHaveLength(2);
-        expect(result.thread.latestTurn?.turnId).toBe("turn-1");
-      }
-    });
-  });
-
-  describe("no-op events", () => {
-    it("returns unchanged for approval-response-requested", () => {
-      const result = applyThreadDetailEvent(baseThread, {
-        ...baseEventFields,
-        sequence: 15,
-        occurredAt: "2026-04-01T13:00:00.000Z",
-        aggregateKind: "thread",
-        aggregateId: ThreadId.make("thread-1"),
-        type: "thread.approval-response-requested",
-        payload: {
-          threadId: ThreadId.make("thread-1"),
-          requestId: "req-1",
-          decision: "approve",
-          createdAt: "2026-04-01T13:00:00.000Z",
-        },
-      } as any);
-      expect(result.kind).toBe("unchanged");
-    });
-  });
-});
diff --git a/packages/client-runtime/src/state/threadReducer.ts b/packages/client-runtime/src/state/threadReducer.ts
deleted file mode 100644
index 10d5898c8fe8..000000000000
--- a/packages/client-runtime/src/state/threadReducer.ts
+++ /dev/null
@@ -1,680 +0,0 @@
-import { pipe } from "effect/Function";
-import * as Arr from "effect/Array";
-import * as O from "effect/Order";
-import type {
-  MessageId,
-  OrchestrationCheckpointSummary,
-  OrchestrationEvent,
-  OrchestrationLatestTurn,
-  OrchestrationMessage,
-  OrchestrationSession,
-  OrchestrationThread,
-  OrchestrationThreadActivity,
-  TurnId,
-} from "@t3tools/contracts";
-
-export type ThreadDetailReducerResult =
-  | { readonly kind: "updated"; readonly thread: OrchestrationThread }
-  | { readonly kind: "deleted" }
-  | { readonly kind: "unchanged" };
-
-const proposedPlanOrder = O.combine<OrchestrationThread["proposedPlans"][number]>(
-  O.mapInput(O.String, (p) => p.createdAt),
-  O.mapInput(O.String, (p) => p.id),
-);
-
-const checkpointOrder = O.mapInput(
-  O.Number,
-  (cp: OrchestrationThread["checkpoints"][number]) =>
-    cp.checkpointTurnCount ?? Number.MAX_SAFE_INTEGER,
-);
-
-const activityOrder = O.combineAll<OrchestrationThreadActivity>([
-  O.mapInput(O.Number, (a) => a.sequence ?? Number.MAX_SAFE_INTEGER),
-  O.mapInput(O.String, (a) => a.createdAt),
-  O.mapInput(O.String, (a) => a.id),
-]);
-
-/**
- * Matches the validity rule in `deriveLatestContextWindowSnapshot` (and the
- * server's snapshot-side `dropStaleContextWindowActivities`): rows without a
- * finite, non-negative `usedTokens` are skipped during the consumer's backward
- * walk, so they must not replace an earlier resolvable row here.
- */
-function isResolvableContextWindowActivity(activity: OrchestrationThreadActivity): boolean {
-  if (activity.kind !== "context-window.updated") {
-    return false;
-  }
-  const payload =
-    activity.payload && typeof activity.payload === "object"
-      ? (activity.payload as Record<string, unknown>)
-      : null;
-  const usedTokens = payload?.usedTokens;
-  return typeof usedTokens === "number" && Number.isFinite(usedTokens) && usedTokens >= 0;
-}
-
-/**
- * Apply a single orchestration event to an `OrchestrationThread`, returning
- * the updated thread, a deletion signal, or an "unchanged" marker when the
- * event doesn't affect this thread.
- *
- * This is a pure reducer operating on contract types. UI-specific mapping
- * (e.g. resolving attachment preview URLs, normalising model slugs, adding
- * scoped fields like `environmentId`) is the caller's responsibility.
- */
-export function applyThreadDetailEvent(
-  thread: OrchestrationThread,
-  event: OrchestrationEvent,
-): ThreadDetailReducerResult {
-  switch (event.type) {
-    // ── Project events (irrelevant to thread detail) ────────────────
-    case "project.created":
-    case "project.meta-updated":
-    case "project.deleted":
-      return { kind: "unchanged" };
-
-    // ── Thread lifecycle ────────────────────────────────────────────
-    case "thread.created":
-      return {
-        kind: "updated",
-        thread: {
-          id: event.payload.threadId,
-          projectId: event.payload.projectId,
-          title: event.payload.title,
-          modelSelection: event.payload.modelSelection,
-          runtimeMode: event.payload.runtimeMode,
-          interactionMode: event.payload.interactionMode,
-          branch: event.payload.branch,
-          worktreePath: event.payload.worktreePath,
-          latestTurn: null,
-          createdAt: event.payload.createdAt,
-          updatedAt: event.payload.updatedAt,
-          archivedAt: null,
-          settledOverride: null,
-          settledAt: null,
-          unsettledAt: null,
-          snoozedUntil: null,
-          snoozedAt: null,
-          deletedAt: null,
-          messages: [],
-          proposedPlans: [],
-          activities: [],
-          checkpoints: [],
-          session: null,
-        },
-      };
-
-    case "thread.deleted":
-      return { kind: "deleted" };
-
-    case "thread.archived":
-      return {
-        kind: "updated",
-        thread: {
-          ...thread,
-          archivedAt: event.payload.archivedAt,
-          titleRegeneration: null,
-          updatedAt: event.payload.updatedAt,
-        },
-      };
-
-    case "thread.unarchived":
-      return {
-        kind: "updated",
-        thread: { ...thread, archivedAt: null, updatedAt: event.payload.updatedAt },
-      };
-
-    case "thread.settled":
-      return {
-        kind: "updated",
-        thread: {
-          ...thread,
-          settledOverride: "settled",
-          settledAt: event.payload.settledAt,
-          unsettledAt: null,
-          updatedAt: event.payload.updatedAt,
-        },
-      };
-
-    case "thread.unsettled":
-      return {
-        kind: "updated",
-        thread: {
-          ...thread,
-          settledOverride: event.payload.reason === "user" ? "active" : null,
-          settledAt: null,
-          // A thread already pinned active keeps its re-entry stamp: the
-          // activity reset that clears the pin must not reorder the list.
-          unsettledAt:
-            thread.settledOverride === "active"
-              ? (thread.unsettledAt ?? null)
-              : event.payload.updatedAt,
-          updatedAt: event.payload.updatedAt,
-        },
-      };
-
-    case "thread.snoozed":
-      return {
-        kind: "updated",
-        thread: {
-          ...thread,
-          snoozedUntil: event.payload.snoozedUntil,
-          snoozedAt: event.payload.snoozedAt,
-          updatedAt: event.payload.updatedAt,
-        },
-      };
-
-    case "thread.unsnoozed":
-      return {
-        kind: "updated",
-        thread: {
-          ...thread,
-          snoozedUntil: null,
-          snoozedAt: null,
-          updatedAt: event.payload.updatedAt,
-        },
-      };
-
-    case "thread.pinned":
-      return {
-        kind: "updated",
-        thread: {
-          ...thread,
-          pinnedAt: event.payload.pinnedAt,
-          ...(event.payload.pinOrderKey !== undefined
-            ? { pinOrderKey: event.payload.pinOrderKey }
-            : {}),
-          updatedAt: event.payload.updatedAt,
-        },
-      };
-
-    case "thread.unpinned":
-      return {
-        kind: "updated",
-        thread: {
-          ...thread,
-          pinnedAt: null,
-          pinOrderKey: null,
-          updatedAt: event.payload.updatedAt,
-        },
-      };
-
-    case "thread.pin-reordered":
-      return {
-        kind: "updated",
-        thread: {
-          ...thread,
-          pinOrderKey: event.payload.orderKey,
-          updatedAt: event.payload.updatedAt,
-        },
-      };
-
-    // ── Thread metadata ─────────────────────────────────────────────
-    case "thread.meta-updated":
-      return {
-        kind: "updated",
-        thread: {
-          ...thread,
-          ...(event.payload.title !== undefined ? { title: event.payload.title } : {}),
-          ...(event.payload.titleRegeneration !== undefined
-            ? { titleRegeneration: event.payload.titleRegeneration }
-            : {}),
-          ...(event.payload.modelSelection !== undefined
-            ? { modelSelection: event.payload.modelSelection }
-            : {}),
-          ...(event.payload.branch !== undefined ? { branch: event.payload.branch } : {}),
-          ...(event.payload.worktreePath !== undefined
-            ? { worktreePath: event.payload.worktreePath }
-            : {}),
-          ...(event.payload.linkedPullRequest !== undefined
-            ? { linkedPullRequest: event.payload.linkedPullRequest }
-            : {}),
-          updatedAt: event.payload.updatedAt,
-        },
-      };
-
-    case "thread.runtime-mode-set":
-      return {
-        kind: "updated",
-        thread: {
-          ...thread,
-          runtimeMode: event.payload.runtimeMode,
-          updatedAt: event.payload.updatedAt,
-        },
-      };
-
-    case "thread.interaction-mode-set":
-      return {
-        kind: "updated",
-        thread: {
-          ...thread,
-          interactionMode: event.payload.interactionMode,
-          updatedAt: event.payload.updatedAt,
-        },
-      };
-
-    // ── Turn lifecycle ──────────────────────────────────────────────
-    case "thread.turn-start-requested":
-      return {
-        kind: "updated",
-        thread: {
-          ...thread,
-          ...(event.payload.modelSelection !== undefined
-            ? { modelSelection: event.payload.modelSelection }
-            : {}),
-          runtimeMode: event.payload.runtimeMode,
-          interactionMode: event.payload.interactionMode,
-          updatedAt: event.occurredAt,
-        },
-      };
-
-    case "thread.turn-interrupt-requested": {
-      if (event.payload.turnId === undefined) {
-        return { kind: "unchanged" };
-      }
-      const latestTurn = thread.latestTurn;
-      if (latestTurn === null || latestTurn.turnId !== event.payload.turnId) {
-        return { kind: "unchanged" };
-      }
-      return {
-        kind: "updated",
-        thread: {
-          ...thread,
-          latestTurn: {
-            ...latestTurn,
-            state: "interrupted",
-            startedAt: latestTurn.startedAt ?? event.payload.createdAt,
-            completedAt: latestTurn.completedAt ?? event.payload.createdAt,
-          },
-          updatedAt: event.occurredAt,
-        },
-      };
-    }
-
-    // ── Messages ────────────────────────────────────────────────────
-    case "thread.message-sent": {
-      const message: OrchestrationMessage = {
-        id: event.payload.messageId,
-        role: event.payload.role,
-        text: event.payload.text,
-        ...(event.payload.attachments !== undefined
-          ? { attachments: event.payload.attachments }
-          : {}),
-        turnId: event.payload.turnId,
-        streaming: event.payload.streaming,
-        createdAt: event.payload.createdAt,
-        updatedAt: event.payload.updatedAt,
-      };
-
-      const existingMessage = thread.messages.find((entry) => entry.id === message.id);
-      const messages = existingMessage
-        ? Arr.map(thread.messages, (entry) =>
-            entry.id !== message.id
-              ? entry
-              : {
-                  ...entry,
-                  text: message.streaming
-                    ? `${entry.text}${message.text}`
-                    : message.text.length > 0
-                      ? message.text
-                      : entry.text,
-                  streaming: message.streaming,
-                  ...(message.turnId !== undefined ? { turnId: message.turnId } : {}),
-                  ...(message.streaming ? {} : { updatedAt: message.updatedAt }),
-                  ...(message.attachments !== undefined
-                    ? { attachments: message.attachments }
-                    : {}),
-                },
-          )
-        : Arr.append(thread.messages, message);
-      // Update latestTurn for assistant messages bound to a turn. A completed
-      // assistant message only settles the turn once the session is no longer
-      // running it — providers may emit several assistant messages per turn
-      // (commentary between tool calls), and the turn must stay unsettled
-      // until the provider reports turn end.
-      const turnStillRunning =
-        event.payload.turnId !== null &&
-        thread.session?.status === "running" &&
-        thread.session.activeTurnId === event.payload.turnId;
-      const settlesTurn = !event.payload.streaming && !turnStillRunning;
-      const latestTurn: OrchestrationThread["latestTurn"] =
-        event.payload.role === "assistant" &&
-        event.payload.turnId !== null &&
-        (thread.latestTurn === null || thread.latestTurn.turnId === event.payload.turnId)
-          ? {
-              turnId: event.payload.turnId,
-              state: settlesTurn
-                ? thread.latestTurn?.state === "interrupted"
-                  ? "interrupted"
-                  : thread.latestTurn?.state === "error"
-                    ? "error"
-                    : "completed"
-                : "running",
-              requestedAt:
-                thread.latestTurn?.turnId === event.payload.turnId
-                  ? thread.latestTurn.requestedAt
-                  : event.payload.createdAt,
-              startedAt:
-                thread.latestTurn?.turnId === event.payload.turnId
-                  ? (thread.latestTurn.startedAt ?? event.payload.createdAt)
-                  : event.payload.createdAt,
-              completedAt: settlesTurn
-                ? event.payload.updatedAt
-                : thread.latestTurn?.turnId === event.payload.turnId
-                  ? (thread.latestTurn.completedAt ?? null)
-                  : null,
-              assistantMessageId: event.payload.messageId,
-            }
-          : thread.latestTurn;
-
-      // Rebind checkpoint assistant message IDs for assistant messages.
-      const checkpoints =
-        event.payload.role === "assistant" && event.payload.turnId !== null
-          ? rebindCheckpointAssistantMessage(
-              thread.checkpoints,
-              event.payload.turnId,
-              event.payload.messageId,
-            )
-          : thread.checkpoints;
-
-      return {
-        kind: "updated",
-        thread: {
-          ...thread,
-          messages,
-          checkpoints,
-          latestTurn,
-          updatedAt: event.occurredAt,
-        },
-      };
-    }
-
-    // ── Session ─────────────────────────────────────────────────────
-    case "thread.session-set": {
-      // Leaving the "running" session status is the turn-end signal: settle a
-      // still-running latest turn so its duration reflects the whole turn.
-      const settledTurnState = settledTurnStateForSessionStatus(event.payload.session.status);
-      const latestTurn: OrchestrationLatestTurn | null =
-        event.payload.session.status === "running" && event.payload.session.activeTurnId !== null
-          ? {
-              turnId: event.payload.session.activeTurnId,
-              state: "running",
-              requestedAt:
-                thread.latestTurn?.turnId === event.payload.session.activeTurnId
-                  ? thread.latestTurn.requestedAt
-                  : event.payload.session.updatedAt,
-              startedAt:
-                thread.latestTurn?.turnId === event.payload.session.activeTurnId
-                  ? (thread.latestTurn.startedAt ?? event.payload.session.updatedAt)
-                  : event.payload.session.updatedAt,
-              completedAt: null,
-              assistantMessageId:
-                thread.latestTurn?.turnId === event.payload.session.activeTurnId
-                  ? thread.latestTurn.assistantMessageId
-                  : null,
-            }
-          : thread.latestTurn !== null &&
-              thread.latestTurn.state === "running" &&
-              settledTurnState !== null
-            ? {
-                ...thread.latestTurn,
-                state: settledTurnState,
-                // A running turn's completedAt can only hold a mid-turn
-                // placeholder checkpoint timestamp — the session leaving
-                // "running" is the authoritative turn end.
-                completedAt: event.payload.session.updatedAt,
-              }
-            : thread.latestTurn;
-
-      return {
-        kind: "updated",
-        thread: {
-          ...thread,
-          session: event.payload.session,
-          latestTurn,
-          updatedAt: event.occurredAt,
-        },
-      };
-    }
-
-    case "thread.session-stop-requested":
-      return thread.session === null
-        ? { kind: "unchanged" }
-        : {
-            kind: "updated",
-            thread: {
-              ...thread,
-              session: {
-                ...thread.session,
-                status: "stopped",
-                activeTurnId: null,
-                updatedAt: event.payload.createdAt,
-              },
-              updatedAt: event.occurredAt,
-            },
-          };
-
-    // ── Proposed plans ──────────────────────────────────────────────
-    case "thread.proposed-plan-upserted": {
-      const proposedPlan = event.payload.proposedPlan;
-
-      const proposedPlans = pipe(
-        thread.proposedPlans,
-        Arr.filter((entry) => entry.id !== proposedPlan.id),
-        Arr.append(proposedPlan),
-        Arr.sort(proposedPlanOrder),
-      );
-
-      return {
-        kind: "updated",
-        thread: { ...thread, proposedPlans, updatedAt: event.occurredAt },
-      };
-    }
-
-    // ── Checkpoints / turn diffs ────────────────────────────────────
-    case "thread.turn-diff-completed": {
-      const checkpoint: OrchestrationCheckpointSummary = {
-        turnId: event.payload.turnId,
-        checkpointTurnCount: event.payload.checkpointTurnCount,
-        checkpointRef: event.payload.checkpointRef,
-        status: event.payload.status,
-        files: event.payload.files,
-        assistantMessageId: event.payload.assistantMessageId,
-        completedAt: event.payload.completedAt,
-      };
-
-      const existing = thread.checkpoints.find((entry) => entry.turnId === checkpoint.turnId);
-      // Don't overwrite a non-missing checkpoint with a missing one.
-      if (existing && existing.status !== "missing" && checkpoint.status === "missing") {
-        return { kind: "unchanged" };
-      }
-
-      const checkpoints = pipe(
-        thread.checkpoints,
-        Arr.filter((entry) => entry.turnId !== checkpoint.turnId),
-        Arr.append(checkpoint),
-        Arr.sort(checkpointOrder),
-      );
-
-      // Mid-turn diff updates produce placeholder checkpoints; record the
-      // checkpoint, but don't settle a turn its session is still running.
-      const diffTurnStillRunning =
-        thread.session?.status === "running" &&
-        thread.session.activeTurnId === event.payload.turnId;
-      const latestTurn =
-        !diffTurnStillRunning &&
-        (thread.latestTurn === null || thread.latestTurn.turnId === event.payload.turnId)
-          ? {
-              turnId: event.payload.turnId,
-              state: checkpointStatusToTurnState(event.payload.status),
-              requestedAt: thread.latestTurn?.requestedAt ?? event.payload.completedAt,
-              startedAt: thread.latestTurn?.startedAt ?? event.payload.completedAt,
-              completedAt: event.payload.completedAt,
-              assistantMessageId: event.payload.assistantMessageId,
-            }
-          : thread.latestTurn;
-
-      return {
-        kind: "updated",
-        thread: { ...thread, checkpoints, latestTurn, updatedAt: event.occurredAt },
-      };
-    }
-
-    // ── Revert ──────────────────────────────────────────────────────
-    case "thread.reverted": {
-      const checkpoints = pipe(
-        thread.checkpoints,
-        Arr.filter(
-          (entry) =>
-            entry.checkpointTurnCount !== undefined &&
-            entry.checkpointTurnCount <= event.payload.turnCount,
-        ),
-        Arr.sort(checkpointOrder),
-      );
-
-      const retainedTurnIds = new Set(Arr.map(checkpoints, (entry) => entry.turnId));
-      const messages = retainMessagesAfterRevert(thread.messages, retainedTurnIds);
-      const proposedPlans = pipe(
-        thread.proposedPlans,
-        Arr.filter((plan) => plan.turnId === null || retainedTurnIds.has(plan.turnId)),
-      );
-      const activities = pipe(
-        thread.activities,
-        Arr.filter((activity) => activity.turnId === null || retainedTurnIds.has(activity.turnId)),
-      );
-      const latestCheckpoint = checkpoints.at(-1) ?? null;
-
-      return {
-        kind: "updated",
-        thread: {
-          ...thread,
-          checkpoints,
-          messages,
-          proposedPlans,
-          activities,
-          latestTurn:
-            latestCheckpoint === null
-              ? null
-              : {
-                  turnId: latestCheckpoint.turnId,
-                  state: checkpointStatusToTurnState(
-                    latestCheckpoint.status as "ready" | "missing" | "error",
-                  ),
-                  requestedAt: latestCheckpoint.completedAt,
-                  startedAt: latestCheckpoint.completedAt,
-                  completedAt: latestCheckpoint.completedAt,
-                  assistantMessageId: latestCheckpoint.assistantMessageId ?? null,
-                },
-          updatedAt: event.occurredAt,
-        },
-      };
-    }
-
-    // ── Activities ──────────────────────────────────────────────────
-    case "thread.activity-appended": {
-      const activity = event.payload.activity;
-      // A resolvable context-window update supersedes earlier resolvable ones
-      // for the same turn: consumers only read the latest value (walking the
-      // array backwards), and providers stream these updates continuously, so
-      // retaining the history grows the thread by thousands of rows over a
-      // long session. Mirrors the server-side snapshot rule in
-      // dropStaleContextWindowActivities; retention stays per turn so a
-      // thread.reverted that discards turns can still resolve a value from
-      // the turns that survive.
-      const supersedesContextWindow = isResolvableContextWindowActivity(activity);
-      const activities = pipe(
-        thread.activities,
-        Arr.filter(
-          (entry) =>
-            entry.id !== activity.id &&
-            !(
-              supersedesContextWindow &&
-              entry.turnId === activity.turnId &&
-              isResolvableContextWindowActivity(entry)
-            ),
-        ),
-        Arr.append(activity),
-        Arr.sort(activityOrder),
-      );
-
-      return {
-        kind: "updated",
-        thread: { ...thread, activities, updatedAt: event.occurredAt },
-      };
-    }
-
-    // ── Events that don't mutate thread state directly ──────────────
-    case "thread.approval-response-requested":
-    case "thread.user-input-response-requested":
-    case "thread.checkpoint-revert-requested":
-      return { kind: "unchanged" };
-  }
-
-  // Forward-compatible: ignore unrecognized event types.
-  return { kind: "unchanged" };
-}
-
-// ── Helpers ──────────────────────────────────────────────────────────
-
-/**
- * Turn state to settle a still-running latest turn with when its session
- * leaves the "running" status, or null while the session is (re)starting or
- * running and the turn must stay unsettled.
- */
-function settledTurnStateForSessionStatus(
-  status: OrchestrationSession["status"],
-): "completed" | "interrupted" | "error" | null {
-  switch (status) {
-    case "idle":
-    case "ready":
-      return "completed";
-    case "error":
-      return "error";
-    case "interrupted":
-    case "stopped":
-      return "interrupted";
-    case "starting":
-    case "running":
-      return null;
-  }
-}
-
-function checkpointStatusToTurnState(
-  status: "ready" | "missing" | "error",
-): OrchestrationLatestTurn["state"] {
-  switch (status) {
-    case "ready":
-      return "completed";
-    case "error":
-      return "error";
-    case "missing":
-      return "completed";
-  }
-}
-
-function rebindCheckpointAssistantMessage(
-  checkpoints: ReadonlyArray<OrchestrationCheckpointSummary>,
-  turnId: TurnId,
-  messageId: MessageId,
-): OrchestrationCheckpointSummary[] {
-  return Arr.map(checkpoints, (entry) =>
-    entry.turnId === turnId ? { ...entry, assistantMessageId: messageId } : entry,
-  );
-}
-
-function retainMessagesAfterRevert(
-  messages: ReadonlyArray<OrchestrationMessage>,
-  retainedTurnIds: ReadonlySet<string>,
-): OrchestrationMessage[] {
-  // Keep messages that belong to a retained turn, plus system messages and
-  // messages without a turn binding (pre-turn-0 user messages).
-  return Arr.filter(messages, (message) => {
-    if (message.role === "system") {
-      return true;
-    }
-    if (message.turnId === null) {
-      return true;
-    }
-    return retainedTurnIds.has(message.turnId);
-  });
-}
diff --git a/packages/client-runtime/src/state/threadRelationships.test.ts b/packages/client-runtime/src/state/threadRelationships.test.ts
new file mode 100644
index 000000000000..e24c3c572d5b
--- /dev/null
+++ b/packages/client-runtime/src/state/threadRelationships.test.ts
@@ -0,0 +1,421 @@
+import { describe, expect, it } from "vite-plus/test";
+import { ThreadId } from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+
+import {
+  deriveThreadRelationshipGraph,
+  immediateThreadRelationships,
+  orderWebThreadLineageRows,
+  relatedThreadIds,
+  resolveMergeBackTargetThreadId,
+  walkThreadRelationships,
+} from "./threadRelationships.ts";
+
+describe("thread relationships", () => {
+  it("keeps an older activity run visible over a newer cancelled run", () => {
+    const parent = ThreadId.make("thread-parent");
+    const child = ThreadId.make("thread-child");
+    const graph = deriveThreadRelationshipGraph({
+      threads: [
+        {
+          id: child,
+          title: "Active child",
+          activityRunStatus: "running",
+          status: "cancelled",
+          forkedFrom: { type: "run", threadId: parent, runId: "run-parent" },
+          lineage: {
+            rootThreadId: parent,
+            parentThreadId: parent,
+            relationshipToParent: "subagent",
+          },
+        },
+      ] as never,
+      projection: null,
+    });
+
+    expect(graph.edges).toEqual([
+      expect.objectContaining({ targetThreadId: child, status: "running" }),
+    ]);
+  });
+
+  it("keeps missing parents and cycles navigable without recursive traversal", () => {
+    const root = ThreadId.make("thread-root");
+    const child = ThreadId.make("thread-child");
+    const missing = ThreadId.make("thread-missing");
+    const graph = deriveThreadRelationshipGraph({
+      threads: [
+        {
+          id: root,
+          title: "Root",
+          status: "completed",
+          forkedFrom: { type: "run", threadId: child, runId: "run-cycle" },
+          lineage: { rootThreadId: root, parentThreadId: child, relationshipToParent: "fork" },
+        },
+        {
+          id: child,
+          title: "Child",
+          status: "completed",
+          forkedFrom: { type: "run", threadId: missing, runId: "run-missing" },
+          lineage: { rootThreadId: root, parentThreadId: missing, relationshipToParent: "fork" },
+        },
+      ] as never,
+      projection: null,
+    });
+
+    expect(graph.nodes.get(missing)?.missing).toBe(true);
+    expect(relatedThreadIds(graph, root)).toEqual([child]);
+    expect(relatedThreadIds(graph, child)).toEqual([root, missing]);
+    expect(
+      walkThreadRelationships(graph, root).map(({ threadId, depth }) => [threadId, depth]),
+    ).toEqual([
+      [child, 1],
+      [missing, 2],
+    ]);
+    expect(immediateThreadRelationships(graph, root).map(({ threadId }) => threadId)).toEqual([
+      child,
+    ]);
+  });
+
+  it("combines subagent and transfer edges with archived shell state", () => {
+    const parent = ThreadId.make("thread-parent");
+    const child = ThreadId.make("thread-child");
+    const transferTarget = ThreadId.make("thread-transfer");
+    const graph = deriveThreadRelationshipGraph({
+      threads: [
+        {
+          id: parent,
+          title: "Parent",
+          status: "completed",
+          archivedAt: null,
+          forkedFrom: null,
+          lineage: { rootThreadId: parent, parentThreadId: null, relationshipToParent: null },
+        },
+        {
+          id: child,
+          title: "Subagent",
+          status: "completed",
+          archivedAt: "2026-06-24T00:00:00.000Z",
+          forkedFrom: null,
+          lineage: {
+            rootThreadId: parent,
+            parentThreadId: parent,
+            relationshipToParent: "subagent",
+          },
+        },
+      ] as never,
+      projection: {
+        thread: { id: parent },
+        subagents: [{ childThreadId: child, status: "completed" }],
+        contextTransfers: [
+          {
+            sourceThreadId: child,
+            targetThreadId: transferTarget,
+            status: "completed",
+          },
+        ],
+      } as never,
+    });
+
+    expect(graph.nodes.get(child)?.thread?.archivedAt).not.toBeNull();
+    expect(graph.nodes.get(transferTarget)?.missing).toBe(true);
+    expect(graph.edges).toEqual(
+      expect.arrayContaining([
+        expect.objectContaining({
+          sourceThreadId: parent,
+          targetThreadId: child,
+          kind: "subagent",
+        }),
+        expect.objectContaining({
+          sourceThreadId: child,
+          targetThreadId: transferTarget,
+          kind: "transfer",
+        }),
+      ]),
+    );
+  });
+
+  it("keeps the live shell when an archived snapshot contains the same thread id", () => {
+    const parent = ThreadId.make("thread-parent");
+    const staleParent = ThreadId.make("thread-stale-parent");
+    const child = ThreadId.make("thread-child");
+    const liveChild = {
+      id: child,
+      title: "Live child",
+      status: "running",
+      archivedAt: null,
+      forkedFrom: { type: "run", threadId: parent, runId: "run-live" },
+      lineage: {
+        rootThreadId: parent,
+        parentThreadId: parent,
+        relationshipToParent: "fork",
+      },
+    } as const;
+    const staleArchivedChild = {
+      ...liveChild,
+      title: "Stale archived child",
+      status: "completed",
+      archivedAt: "2026-06-24T00:00:00.000Z",
+      forkedFrom: { type: "run", threadId: staleParent, runId: "run-stale" },
+      lineage: {
+        rootThreadId: staleParent,
+        parentThreadId: staleParent,
+        relationshipToParent: "fork",
+      },
+    } as const;
+
+    const graph = deriveThreadRelationshipGraph({
+      threads: [liveChild, staleArchivedChild] as never,
+      projection: null,
+    });
+
+    expect(graph.nodes.get(child)?.thread).toMatchObject({
+      title: "Live child",
+      status: "running",
+      archivedAt: null,
+    });
+    expect(graph.edges).toEqual([
+      expect.objectContaining({
+        sourceThreadId: parent,
+        targetThreadId: child,
+      }),
+    ]);
+    expect(graph.nodes.has(staleParent)).toBe(false);
+  });
+
+  it("resolves merge-back only for forks and prefers the recorded fork source", () => {
+    const source = ThreadId.make("thread-source");
+    const fallbackParent = ThreadId.make("thread-parent");
+    const fork = ThreadId.make("thread-fork");
+
+    expect(
+      resolveMergeBackTargetThreadId({
+        thread: {
+          id: fork,
+          forkedFrom: { type: "run", threadId: source, runId: "run-source" },
+          lineage: {
+            rootThreadId: source,
+            parentThreadId: fallbackParent,
+            relationshipToParent: "fork",
+          },
+        },
+      } as never),
+    ).toBe(source);
+    expect(
+      resolveMergeBackTargetThreadId({
+        thread: {
+          id: fork,
+          forkedFrom: null,
+          lineage: {
+            rootThreadId: source,
+            parentThreadId: fallbackParent,
+            relationshipToParent: "fork",
+          },
+        },
+      } as never),
+    ).toBe(fallbackParent);
+    expect(
+      resolveMergeBackTargetThreadId({
+        thread: {
+          id: fork,
+          forkedFrom: null,
+          lineage: {
+            rootThreadId: source,
+            parentThreadId: fallbackParent,
+            relationshipToParent: "subagent",
+          },
+        },
+      } as never),
+    ).toBeNull();
+  });
+});
+
+const current = ThreadId.make("thread-current");
+
+function forkShell(input: {
+  readonly id: ThreadId;
+  readonly parentThreadId: ThreadId | null;
+  readonly createdAt?: string;
+  readonly updatedAt?: string;
+  readonly status?: string;
+}) {
+  return {
+    id: input.id,
+    title: input.id,
+    status: input.status ?? "completed",
+    archivedAt: null,
+    forkedFrom:
+      input.parentThreadId === null
+        ? null
+        : { type: "run", threadId: input.parentThreadId, runId: `run-${input.id}` },
+    lineage: {
+      rootThreadId: input.parentThreadId ?? input.id,
+      parentThreadId: input.parentThreadId,
+      relationshipToParent: input.parentThreadId === null ? null : "fork",
+    },
+    createdAt: input.createdAt === undefined ? undefined : DateTime.makeUnsafe(input.createdAt),
+    updatedAt: DateTime.makeUnsafe(input.updatedAt ?? "2026-06-20T00:00:00.000Z"),
+  };
+}
+
+function orderedLineageIds(input: {
+  readonly threads: ReadonlyArray<unknown>;
+  readonly mergeTargetThreadId?: ThreadId | null;
+  readonly projection?: unknown;
+}): ReadonlyArray<ThreadId> {
+  const graph = deriveThreadRelationshipGraph({
+    threads: input.threads as never,
+    projection: (input.projection ?? null) as never,
+  });
+  return orderWebThreadLineageRows({
+    graph,
+    rows: immediateThreadRelationships(graph, current),
+    currentThreadId: current,
+    mergeTargetThreadId: input.mergeTargetThreadId ?? null,
+  }).map(({ threadId }) => threadId);
+}
+
+describe("web thread lineage ordering", () => {
+  it("orders sibling forks newest created first", () => {
+    const oldest = ThreadId.make("thread-fork-oldest");
+    const middle = ThreadId.make("thread-fork-middle");
+    const newest = ThreadId.make("thread-fork-newest");
+
+    expect(
+      orderedLineageIds({
+        threads: [
+          forkShell({ id: current, parentThreadId: null, createdAt: "2026-06-01T00:00:00.000Z" }),
+          forkShell({
+            id: oldest,
+            parentThreadId: current,
+            createdAt: "2026-06-02T00:00:00.000Z",
+          }),
+          forkShell({
+            id: middle,
+            parentThreadId: current,
+            createdAt: "2026-06-03T00:00:00.000Z",
+          }),
+          forkShell({
+            id: newest,
+            parentThreadId: current,
+            createdAt: "2026-06-04T00:00:00.000Z",
+          }),
+        ],
+      }),
+    ).toEqual([newest, middle, oldest]);
+  });
+
+  it("does not reorder when related-thread activity arrives", () => {
+    const first = ThreadId.make("thread-fork-a");
+    const second = ThreadId.make("thread-fork-b");
+    const third = ThreadId.make("thread-fork-c");
+    const before = orderedLineageIds({
+      threads: [
+        forkShell({ id: current, parentThreadId: null, createdAt: "2026-06-01T00:00:00.000Z" }),
+        forkShell({ id: first, parentThreadId: current, createdAt: "2026-06-02T00:00:00.000Z" }),
+        forkShell({ id: second, parentThreadId: current, createdAt: "2026-06-03T00:00:00.000Z" }),
+        forkShell({ id: third, parentThreadId: current, createdAt: "2026-06-04T00:00:00.000Z" }),
+      ],
+    });
+
+    // The shell snapshot arrives ordered by `updated_at`, and a client-side
+    // `thread.updated` re-appends the shell it replaces, so both the input
+    // order and the mutable timestamps move under us while the panel is open.
+    const after = orderedLineageIds({
+      threads: [
+        forkShell({
+          id: second,
+          parentThreadId: current,
+          createdAt: "2026-06-03T00:00:00.000Z",
+          updatedAt: "2026-07-30T00:00:00.000Z",
+          status: "running",
+        }),
+        forkShell({ id: third, parentThreadId: current, createdAt: "2026-06-04T00:00:00.000Z" }),
+        forkShell({ id: current, parentThreadId: null, createdAt: "2026-06-01T00:00:00.000Z" }),
+        forkShell({
+          id: first,
+          parentThreadId: current,
+          createdAt: "2026-06-02T00:00:00.000Z",
+          updatedAt: "2026-07-31T00:00:00.000Z",
+          status: "failed",
+        }),
+      ],
+    });
+
+    expect(before).toEqual([third, second, first]);
+    expect(after).toEqual(before);
+  });
+
+  it("pins the parent first and a distinct merge-back target second", () => {
+    // The panel keeps its two action rows in place regardless of creation time:
+    // parent first, then a merge-back target that is not the parent. The two
+    // diverge while a shell update and its projection disagree about the fork
+    // source, which is exactly when a moving row would misfire a merge.
+    const parent = ThreadId.make("thread-parent");
+    const mergeTarget = ThreadId.make("thread-merge-target");
+    const newestFork = ThreadId.make("thread-newest-fork");
+
+    expect(
+      orderedLineageIds({
+        threads: [
+          forkShell({ id: parent, parentThreadId: null, createdAt: "2026-06-01T00:00:00.000Z" }),
+          forkShell({
+            id: current,
+            parentThreadId: parent,
+            createdAt: "2026-06-02T00:00:00.000Z",
+          }),
+          forkShell({
+            id: mergeTarget,
+            parentThreadId: current,
+            createdAt: "2026-06-03T00:00:00.000Z",
+          }),
+          forkShell({
+            id: newestFork,
+            parentThreadId: current,
+            createdAt: "2026-06-09T00:00:00.000Z",
+          }),
+        ],
+        mergeTargetThreadId: mergeTarget,
+      }),
+    ).toEqual([parent, mergeTarget, newestFork]);
+  });
+
+  it("sinks missing nodes and shells without a decoded createdAt", () => {
+    const missingTransfer = ThreadId.make("thread-missing-transfer");
+    const undated = ThreadId.make("thread-undated-fork");
+    const dated = ThreadId.make("thread-dated-fork");
+
+    expect(
+      orderedLineageIds({
+        threads: [
+          forkShell({ id: current, parentThreadId: null, createdAt: "2026-06-01T00:00:00.000Z" }),
+          forkShell({ id: undated, parentThreadId: current }),
+          forkShell({ id: dated, parentThreadId: current, createdAt: "2026-06-02T00:00:00.000Z" }),
+        ],
+        projection: {
+          thread: { id: current },
+          subagents: [],
+          contextTransfers: [
+            { sourceThreadId: current, targetThreadId: missingTransfer, status: "completed" },
+          ],
+        },
+      }),
+    ).toEqual([dated, missingTransfer, undated]);
+  });
+
+  it("breaks equal creation times by thread id", () => {
+    const first = ThreadId.make("thread-fork-a");
+    const second = ThreadId.make("thread-fork-b");
+    const third = ThreadId.make("thread-fork-c");
+
+    expect(
+      orderedLineageIds({
+        threads: [
+          forkShell({ id: current, parentThreadId: null, createdAt: "2026-06-01T00:00:00.000Z" }),
+          forkShell({ id: third, parentThreadId: current, createdAt: "2026-06-02T00:00:00.000Z" }),
+          forkShell({ id: first, parentThreadId: current, createdAt: "2026-06-02T00:00:00.000Z" }),
+          forkShell({ id: second, parentThreadId: current, createdAt: "2026-06-02T00:00:00.000Z" }),
+        ],
+      }),
+    ).toEqual([first, second, third]);
+  });
+});
diff --git a/packages/client-runtime/src/state/threadRelationships.ts b/packages/client-runtime/src/state/threadRelationships.ts
new file mode 100644
index 000000000000..c7ed61d709f4
--- /dev/null
+++ b/packages/client-runtime/src/state/threadRelationships.ts
@@ -0,0 +1,236 @@
+import type {
+  OrchestrationV2ThreadProjection,
+  OrchestrationV2ThreadShell,
+  ThreadId,
+} from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+
+export type ThreadRelationshipKind = "parent" | "fork" | "subagent" | "transfer";
+
+export interface ThreadRelationshipNode {
+  readonly threadId: ThreadId;
+  readonly thread: OrchestrationV2ThreadShell | null;
+  readonly missing: boolean;
+}
+
+export interface ThreadRelationshipEdge {
+  readonly sourceThreadId: ThreadId;
+  readonly targetThreadId: ThreadId;
+  readonly kind: ThreadRelationshipKind;
+  readonly status: string | null;
+}
+
+export interface ThreadRelationshipGraph {
+  readonly nodes: ReadonlyMap<ThreadId, ThreadRelationshipNode>;
+  readonly edges: ReadonlyArray<ThreadRelationshipEdge>;
+}
+
+export interface ThreadRelationshipWalkRow {
+  readonly threadId: ThreadId;
+  readonly fromThreadId: ThreadId;
+  readonly depth: number;
+  readonly edge: ThreadRelationshipEdge;
+}
+
+export function resolveMergeBackTargetThreadId(
+  projection: Pick<OrchestrationV2ThreadProjection, "thread"> | null,
+): ThreadId | null {
+  if (projection?.thread.lineage.relationshipToParent !== "fork") return null;
+  return projection.thread.forkedFrom?.type === "run"
+    ? projection.thread.forkedFrom.threadId
+    : projection.thread.lineage.parentThreadId;
+}
+
+function edgeKey(edge: ThreadRelationshipEdge): string {
+  return `${edge.sourceThreadId}\u001f${edge.targetThreadId}\u001f${edge.kind}`;
+}
+
+export function deriveThreadRelationshipGraph(input: {
+  readonly threads: ReadonlyArray<OrchestrationV2ThreadShell>;
+  readonly projection: OrchestrationV2ThreadProjection | null;
+}): ThreadRelationshipGraph {
+  const threadsById = new Map<ThreadId, OrchestrationV2ThreadShell>();
+  for (const thread of input.threads) {
+    // Callers order shells from most to least authoritative. In particular,
+    // live shells precede archived snapshots, which may still contain a stale
+    // copy during archive refresh.
+    if (!threadsById.has(thread.id)) {
+      threadsById.set(thread.id, thread);
+    }
+  }
+  const threads = [...threadsById.values()];
+  const nodes = new Map<ThreadId, ThreadRelationshipNode>(
+    threads.map((thread) => [thread.id, { threadId: thread.id, thread, missing: false }]),
+  );
+  const edgesByKey = new Map<string, ThreadRelationshipEdge>();
+  const ensureNode = (threadId: ThreadId) => {
+    if (!nodes.has(threadId)) {
+      nodes.set(threadId, { threadId, thread: null, missing: true });
+    }
+  };
+  const addEdge = (edge: ThreadRelationshipEdge) => {
+    ensureNode(edge.sourceThreadId);
+    ensureNode(edge.targetThreadId);
+    edgesByKey.set(edgeKey(edge), edge);
+  };
+
+  for (const thread of threads) {
+    const parentThreadId =
+      thread.forkedFrom?.type === "run"
+        ? thread.forkedFrom.threadId
+        : thread.lineage.parentThreadId;
+    if (parentThreadId === null) continue;
+    addEdge({
+      sourceThreadId: parentThreadId,
+      targetThreadId: thread.id,
+      kind: thread.lineage.relationshipToParent === "subagent" ? "subagent" : "fork",
+      status: thread.activityRunStatus ?? thread.status,
+    });
+  }
+
+  if (input.projection !== null) {
+    const ownerThreadId = input.projection.thread.id;
+    for (const subagent of input.projection.subagents) {
+      if (subagent.childThreadId === null) continue;
+      addEdge({
+        sourceThreadId: ownerThreadId,
+        targetThreadId: subagent.childThreadId,
+        kind: "subagent",
+        status: subagent.status,
+      });
+    }
+    for (const transfer of input.projection.contextTransfers) {
+      if (transfer.sourceThreadId === transfer.targetThreadId) continue;
+      addEdge({
+        sourceThreadId: transfer.sourceThreadId,
+        targetThreadId: transfer.targetThreadId,
+        kind: "transfer",
+        status: transfer.status,
+      });
+    }
+  }
+
+  return { nodes, edges: [...edgesByKey.values()] };
+}
+
+export function relatedThreadIds(
+  graph: ThreadRelationshipGraph,
+  threadId: ThreadId,
+): ReadonlyArray<ThreadId> {
+  const ids = new Set<ThreadId>();
+  for (const edge of graph.edges) {
+    if (edge.sourceThreadId === threadId) ids.add(edge.targetThreadId);
+    if (edge.targetThreadId === threadId) ids.add(edge.sourceThreadId);
+  }
+  return [...ids];
+}
+
+export function walkThreadRelationships(
+  graph: ThreadRelationshipGraph,
+  threadId: ThreadId,
+): ReadonlyArray<ThreadRelationshipWalkRow> {
+  const visited = new Set<ThreadId>([threadId]);
+  const pending: Array<{ readonly threadId: ThreadId; readonly depth: number }> = [
+    { threadId, depth: 0 },
+  ];
+  const rows: ThreadRelationshipWalkRow[] = [];
+
+  for (let index = 0; index < pending.length; index += 1) {
+    const current = pending[index];
+    if (current === undefined) continue;
+    for (const edge of graph.edges) {
+      const relatedId =
+        edge.sourceThreadId === current.threadId
+          ? edge.targetThreadId
+          : edge.targetThreadId === current.threadId
+            ? edge.sourceThreadId
+            : null;
+      if (relatedId === null || visited.has(relatedId)) continue;
+      visited.add(relatedId);
+      const depth = current.depth + 1;
+      rows.push({ threadId: relatedId, fromThreadId: current.threadId, depth, edge });
+      pending.push({ threadId: relatedId, depth });
+    }
+  }
+
+  return rows;
+}
+
+export function immediateThreadRelationships(
+  graph: ThreadRelationshipGraph,
+  threadId: ThreadId,
+): ReadonlyArray<ThreadRelationshipWalkRow> {
+  const visited = new Set<ThreadId>();
+  const rows: ThreadRelationshipWalkRow[] = [];
+
+  for (const edge of graph.edges) {
+    const relatedId =
+      edge.sourceThreadId === threadId
+        ? edge.targetThreadId
+        : edge.targetThreadId === threadId
+          ? edge.sourceThreadId
+          : null;
+    if (relatedId === null || visited.has(relatedId)) continue;
+    visited.add(relatedId);
+    rows.push({ threadId: relatedId, fromThreadId: threadId, depth: 1, edge });
+  }
+
+  return rows;
+}
+
+/** True when `edge` reaches `currentThreadId` from its parent or owning agent. */
+export function isParentThreadRelationship(
+  edge: ThreadRelationshipEdge,
+  currentThreadId: ThreadId,
+): boolean {
+  return edge.kind !== "transfer" && edge.targetThreadId === currentThreadId;
+}
+
+function threadCreatedAtMillis(node: ThreadRelationshipNode | undefined): number | null {
+  // `createdAt` is typed as a DateTime, but the value reaches here from a
+  // decoded shell that may be missing (a related thread we have no shell for).
+  const createdAt: unknown = node?.thread?.createdAt;
+  if (!DateTime.isDateTime(createdAt)) return null;
+  const millis = DateTime.toEpochMillis(createdAt);
+  return Number.isFinite(millis) ? millis : null;
+}
+
+/**
+ * Orders the web thread-details Lineage rows for display.
+ *
+ * Web-specific by design: the panel pins the parent row first and a distinct
+ * merge-back target second so their actions stay where the user expects, and
+ * only then falls back to newest-created-first. Mobile does not share that
+ * exception, so this is not the canonical relationship order and should not be
+ * reused as one.
+ *
+ * Ordering below the pins is `createdAt` descending, which is immutable, so
+ * rows never move when messages or status changes arrive on a related thread.
+ * Threads whose shell is missing (or whose `createdAt` did not decode) sink to
+ * the bottom. Ties break by thread id ascending so the order is total.
+ */
+export function orderWebThreadLineageRows(input: {
+  readonly graph: ThreadRelationshipGraph;
+  readonly rows: ReadonlyArray<ThreadRelationshipWalkRow>;
+  readonly currentThreadId: ThreadId;
+  readonly mergeTargetThreadId: ThreadId | null;
+}): ReadonlyArray<ThreadRelationshipWalkRow> {
+  const pinRank = (row: ThreadRelationshipWalkRow): number => {
+    if (isParentThreadRelationship(row.edge, input.currentThreadId)) return 0;
+    if (row.threadId === input.mergeTargetThreadId) return 1;
+    return 2;
+  };
+
+  return input.rows.toSorted((left, right) => {
+    const rankDelta = pinRank(left) - pinRank(right);
+    if (rankDelta !== 0) return rankDelta;
+    const leftCreatedAt = threadCreatedAtMillis(input.graph.nodes.get(left.threadId));
+    const rightCreatedAt = threadCreatedAtMillis(input.graph.nodes.get(right.threadId));
+    if (leftCreatedAt !== rightCreatedAt) {
+      if (leftCreatedAt === null) return 1;
+      if (rightCreatedAt === null) return -1;
+      return rightCreatedAt - leftCreatedAt;
+    }
+    return left.threadId < right.threadId ? -1 : left.threadId > right.threadId ? 1 : 0;
+  });
+}
diff --git a/packages/client-runtime/src/state/threadRequests.ts b/packages/client-runtime/src/state/threadRequests.ts
new file mode 100644
index 000000000000..4a87f785f5fe
--- /dev/null
+++ b/packages/client-runtime/src/state/threadRequests.ts
@@ -0,0 +1,90 @@
+import type {
+  OrchestrationV2ThreadProjection,
+  ProviderApprovalOption,
+  ProviderRequestKind,
+  RuntimeRequestId,
+} from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+
+export interface ThreadPendingApproval {
+  readonly requestId: RuntimeRequestId;
+  readonly requestKind: ProviderRequestKind;
+  readonly createdAt: string;
+  readonly detail?: string;
+  /** App requesting access for mcp-elicitation approvals (#8058). */
+  readonly appName?: string;
+  /** Approval choices advertised by the provider (#8058); defaults apply when absent. */
+  readonly options?: ReadonlyArray<ProviderApprovalOption>;
+  readonly responseCapability: "live" | "not_resumable";
+}
+
+export interface ThreadUserInputQuestion {
+  readonly id: string;
+  readonly header: string;
+  readonly question: string;
+  readonly options: ReadonlyArray<{
+    readonly label: string;
+    readonly description: string;
+  }>;
+  readonly multiSelect: boolean;
+}
+
+export interface ThreadPendingUserInput {
+  readonly requestId: RuntimeRequestId;
+  readonly createdAt: string;
+  readonly questions: ReadonlyArray<ThreadUserInputQuestion>;
+  readonly responseCapability: "live" | "not_resumable";
+}
+
+export interface PendingThreadRequests {
+  readonly approvals: ReadonlyArray<ThreadPendingApproval>;
+  readonly userInputs: ReadonlyArray<ThreadPendingUserInput>;
+}
+
+/** Joins pending request entities to the request items that carry display data. */
+export function derivePendingThreadRequests(
+  projection: OrchestrationV2ThreadProjection,
+): PendingThreadRequests {
+  const approvals: ThreadPendingApproval[] = [];
+  const userInputs: ThreadPendingUserInput[] = [];
+
+  for (const request of projection.runtimeRequests) {
+    if (request.status !== "pending") continue;
+    const responseCapability = request.responseCapability.type;
+    if (request.kind === "user_input") {
+      const item = projection.turnItems.findLast(
+        (candidate) =>
+          candidate.type === "user_input_request" && candidate.requestId === request.id,
+      );
+      if (item === undefined || item.type !== "user_input_request") continue;
+      userInputs.push({
+        requestId: request.id,
+        createdAt: DateTime.formatIso(request.createdAt),
+        questions: item.questions.map((question) => ({
+          ...question,
+          multiSelect: question.multiSelect ?? false,
+        })),
+        responseCapability,
+      });
+      continue;
+    }
+
+    if (request.kind === "auth_refresh" || request.kind === "dynamic_tool_call") continue;
+    const item = projection.turnItems.findLast(
+      (candidate) => candidate.type === "approval_request" && candidate.requestId === request.id,
+    );
+    approvals.push({
+      requestId: request.id,
+      requestKind: request.kind,
+      createdAt: DateTime.formatIso(request.createdAt),
+      ...(item?.type === "approval_request" && item.prompt ? { detail: item.prompt } : {}),
+      ...(item?.type === "approval_request" && item.appName ? { appName: item.appName } : {}),
+      ...(item?.type === "approval_request" && item.options !== undefined
+        ? { options: item.options }
+        : {}),
+      responseCapability,
+    });
+  }
+
+  return { approvals, userInputs };
+}
diff --git a/packages/client-runtime/src/state/threadSettled.ts b/packages/client-runtime/src/state/threadSettled.ts
index 8ccf0d230efd..37f3d28fc71e 100644
--- a/packages/client-runtime/src/state/threadSettled.ts
+++ b/packages/client-runtime/src/state/threadSettled.ts
@@ -1,5 +1,42 @@
 // @effect-diagnostics globalDate:off -- UI snooze presets use local calendar boundaries and Intl labels.
 import type { OrchestrationThreadShell } from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+
+interface SettlementRunLike {
+  readonly turnId?: unknown;
+  readonly assistantMessageId?: unknown;
+  readonly status?: string;
+  readonly state?: string;
+  readonly requestedAt?: string | null;
+  readonly startedAt?: string | null;
+  readonly completedAt?: string | null;
+}
+
+interface SettlementRuntimeLike {
+  readonly threadId?: unknown;
+  readonly providerName?: unknown;
+  readonly runtimeMode?: unknown;
+  readonly activeTurnId?: unknown;
+  readonly lastError?: unknown;
+  readonly status: string;
+  readonly updatedAt?: string;
+}
+
+interface QueuedThreadShell {
+  readonly latestUserMessageAt?: string | null;
+  readonly latestTurn?: SettlementRunLike | null;
+  readonly latestRun?: SettlementRunLike | null;
+  readonly session?: SettlementRuntimeLike | null;
+  readonly runtime?: SettlementRuntimeLike | null;
+}
+
+interface SettlementThreadShell extends QueuedThreadShell {
+  readonly createdAt: string;
+  readonly settledOverride: "settled" | "active" | null;
+  readonly settledAt: string | null;
+  readonly hasPendingApprovals: boolean;
+  readonly hasPendingUserInput: boolean;
+}
 
 export type ChangeRequestStateLike = "open" | "closed" | "merged";
 
@@ -14,10 +51,9 @@ export interface ChangeRequestSettleSource {
 }
 
 /** What the settle rules need to know about the thread's own timeline. */
-export type ThreadActivitySource = Pick<
-  OrchestrationThreadShell,
-  "createdAt" | "latestUserMessageAt" | "latestTurn"
->;
+export interface ThreadActivitySource extends QueuedThreadShell {
+  readonly createdAt: string;
+}
 
 /**
  * Latest USER-initiated activity: messages and the turn requests they start,
@@ -28,7 +64,7 @@ export type ThreadActivitySource = Pick<
  */
 function threadUserActivityAnchorAt(thread: ThreadActivitySource): string {
   const messageAt = thread.latestUserMessageAt;
-  const requestedAt = thread.latestTurn?.requestedAt;
+  const requestedAt = (thread.latestRun ?? thread.latestTurn)?.requestedAt;
   let anchor = thread.createdAt;
   for (const candidate of [messageAt, requestedAt]) {
     if (candidate != null && Date.parse(candidate) > Date.parse(anchor)) {
@@ -71,14 +107,13 @@ export function changeRequestAutoSettles(
 
 const DAY_MS = 24 * 60 * 60 * 1_000;
 
-export function threadLastActivityAt(
-  shell: Pick<OrchestrationThreadShell, "latestUserMessageAt" | "latestTurn">,
-): string | null {
+export function threadLastActivityAt(shell: SettlementThreadShell): string | null {
+  const latestRun = shell.latestRun ?? shell.latestTurn ?? null;
   const candidates = [
     shell.latestUserMessageAt,
-    shell.latestTurn?.requestedAt,
-    shell.latestTurn?.startedAt,
-    shell.latestTurn?.completedAt,
+    latestRun?.requestedAt,
+    latestRun?.startedAt,
+    latestRun?.completedAt,
   ];
   let latest: string | null = null;
   let latestTimestamp = Number.NEGATIVE_INFINITY;
@@ -114,9 +149,16 @@ export const QUEUED_TURN_START_GRACE_MS = 2 * 60 * 1_000;
  * within the adoption grace window.
  */
 export function hasQueuedTurnStart(
-  shell: Pick<OrchestrationThreadShell, "latestUserMessageAt" | "latestTurn" | "session">,
+  shell: QueuedThreadShell,
   options: { readonly now: string },
 ): boolean {
+  if (
+    shell.runtime?.status === "preparing" ||
+    shell.runtime?.status === "queued" ||
+    shell.runtime?.status === "starting"
+  ) {
+    return true;
+  }
   if (shell.latestUserMessageAt == null) return false;
   // A failed session start clears the queued state: the failure is already
   // visible (status edge / error).
@@ -130,7 +172,7 @@ export function hasQueuedTurnStart(
   // that would otherwise hold the queued state for the whole skew. Mirrors
   // the decider's guard.
   if (Math.abs(nowMs - messageAt) > QUEUED_TURN_START_GRACE_MS) return false;
-  const turn = shell.latestTurn;
+  const turn = shell.latestRun ?? shell.latestTurn ?? null;
   if (turn === null) return true;
   return [turn.requestedAt, turn.startedAt, turn.completedAt].every(
     (candidate) => candidate == null || Date.parse(candidate) < messageAt,
@@ -145,14 +187,18 @@ export function hasQueuedTurnStart(
  * the UI can disable/reject before a round trip.
  */
 export function canSettle(
-  shell: Pick<
-    OrchestrationThreadShell,
-    "hasPendingApprovals" | "hasPendingUserInput" | "session" | "latestUserMessageAt" | "latestTurn"
-  >,
+  shell: SettlementThreadShell,
   options: { readonly now: string },
 ): boolean {
   if (shell.hasPendingApprovals || shell.hasPendingUserInput) return false;
   if (shell.session?.status === "starting" || shell.session?.status === "running") return false;
+  if (
+    shell.runtime !== null &&
+    shell.runtime !== undefined &&
+    ["preparing", "queued", "starting", "running", "waiting"].includes(shell.runtime.status)
+  ) {
+    return false;
+  }
   // Queued work is as blocked-on-progress as a live session: settling it
   // (or auto-settling it on a closed PR) would hide a just-requested turn.
   if (hasQueuedTurnStart(shell, options)) return false;
@@ -165,15 +211,12 @@ export function canSettle(
  * "active" in the data model and is only suppressed from the inbox until
  * its wake time passes or the thread demands attention.
  */
-export type ThreadSnoozeShell = Pick<
-  OrchestrationThreadShell,
-  | "snoozedUntil"
-  | "snoozedAt"
-  | "hasPendingApprovals"
-  | "hasPendingUserInput"
-  | "session"
-  | "latestTurn"
->;
+export interface ThreadSnoozeShell extends QueuedThreadShell {
+  readonly snoozedUntil?: string | null;
+  readonly snoozedAt?: string | null;
+  readonly hasPendingApprovals: boolean;
+  readonly hasPendingUserInput: boolean;
+}
 
 /**
  * A snoozed thread "raises its hand" when something happens that outranks
@@ -186,21 +229,24 @@ export type ThreadSnoozeShell = Pick<
  */
 export function threadRaisedHandWhileSnoozed(shell: ThreadSnoozeShell): boolean {
   if (shell.hasPendingApprovals || shell.hasPendingUserInput) return true;
+  const runtime = shell.runtime ?? shell.session ?? null;
+  const latestRun = shell.latestRun ?? shell.latestTurn ?? null;
   // Only a FRESH failure raises the hand: a thread snoozed while already
   // failed stays snoozed — that snooze was the user saying "I saw it, not
   // now". session.updatedAt stamps the status edge, so an error newer than
   // the snooze is new information.
   if (
-    shell.session?.status === "error" &&
-    (shell.snoozedAt == null || Date.parse(shell.session.updatedAt) > Date.parse(shell.snoozedAt))
+    (runtime?.status === "error" || runtime?.status === "failed") &&
+    (shell.snoozedAt == null ||
+      (runtime.updatedAt != null && Date.parse(runtime.updatedAt) > Date.parse(shell.snoozedAt)))
   ) {
     return true;
   }
   if (
     shell.snoozedAt != null &&
-    shell.latestTurn?.state === "completed" &&
-    shell.latestTurn.completedAt != null &&
-    Date.parse(shell.latestTurn.completedAt) > Date.parse(shell.snoozedAt)
+    (latestRun?.state === "completed" || latestRun?.status === "completed") &&
+    latestRun.completedAt != null &&
+    Date.parse(latestRun.completedAt) > Date.parse(shell.snoozedAt)
   ) {
     return true;
   }
@@ -217,8 +263,14 @@ export function threadRaisedHandWhileSnoozed(shell: ThreadSnoozeShell): boolean
  */
 export function canSnooze(
   shell: Pick<
-    OrchestrationThreadShell,
-    "hasPendingApprovals" | "hasPendingUserInput" | "latestUserMessageAt" | "latestTurn" | "session"
+    ThreadSnoozeShell,
+    | "hasPendingApprovals"
+    | "hasPendingUserInput"
+    | "latestUserMessageAt"
+    | "latestTurn"
+    | "latestRun"
+    | "session"
+    | "runtime"
   >,
   options: { readonly now: string },
 ): boolean {
@@ -269,15 +321,17 @@ export function threadWokeAt(
   // indicator the user already cleared by visiting (snoozedUntil is newer
   // than that visit's lastVisitedAt).
   if (threadRaisedHandWhileSnoozed(shell)) {
+    const latestRun = shell.latestRun ?? shell.latestTurn ?? null;
+    const runtime = shell.runtime ?? shell.session ?? null;
     if (
       shell.snoozedAt != null &&
-      shell.latestTurn?.state === "completed" &&
-      shell.latestTurn.completedAt != null &&
-      Date.parse(shell.latestTurn.completedAt) > Date.parse(shell.snoozedAt)
+      (latestRun?.state === "completed" || latestRun?.status === "completed") &&
+      latestRun.completedAt != null &&
+      Date.parse(latestRun.completedAt) > Date.parse(shell.snoozedAt)
     ) {
-      return shell.latestTurn.completedAt;
+      return latestRun.completedAt;
     }
-    return shell.session?.updatedAt ?? shell.snoozedAt ?? null;
+    return runtime?.updatedAt ?? shell.snoozedAt ?? null;
   }
   // No raised hand: woke iff the timer elapsed (still-snoozed → null).
   return wakeAtMs <= Date.parse(options.now) ? shell.snoozedUntil : null;
@@ -298,7 +352,7 @@ export function threadWokeAt(
  * user-input request), so an override never goes stale silently.
  */
 export function effectiveSettled(
-  shell: OrchestrationThreadShell,
+  shell: SettlementThreadShell,
   options: {
     readonly now: string;
     readonly autoSettleAfterDays: number | null;
@@ -309,6 +363,13 @@ export function effectiveSettled(
   // Blocked work must remain visible even when a user explicitly settled it.
   if (shell.hasPendingApprovals || shell.hasPendingUserInput) return false;
   if (shell.session?.status === "starting" || shell.session?.status === "running") return false;
+  if (
+    shell.runtime !== null &&
+    shell.runtime !== undefined &&
+    ["preparing", "queued", "starting", "running", "waiting"].includes(shell.runtime.status)
+  ) {
+    return false;
+  }
   if (hasQueuedTurnStart(shell, { now: options.now })) {
     // The queued-turn blocker alone is forgivable: it is clock-derived, and
     // list callers pass a coarser `now` than the settle action used. When
@@ -321,7 +382,7 @@ export function effectiveSettled(
     const serverAdjudicated =
       shell.settledOverride === "settled" &&
       shell.settledAt !== null &&
-      shell.latestUserMessageAt !== null &&
+      shell.latestUserMessageAt != null &&
       Date.parse(shell.settledAt) >= Date.parse(shell.latestUserMessageAt);
     if (!serverAdjudicated) return false;
   }
@@ -377,7 +438,7 @@ function snoozeTimeOfDayLabel(date: Date): string {
 }
 
 function snoozeAtHour(base: Date, hour: number): Date {
-  const next = new Date(base);
+  const next = DateTime.toDate(DateTime.makeUnsafe(base));
   next.setHours(hour, 0, 0, 0);
   return next;
 }
@@ -386,7 +447,7 @@ function snoozeAtHour(base: Date, hour: number): Date {
 // land on the wrong local day across DST transitions (a spring-forward day
 // is 23 hours, so 23:30 + 24h skips the whole next day).
 function addSnoozeDays(base: Date, days: number): Date {
-  const next = new Date(base);
+  const next = DateTime.toDate(DateTime.makeUnsafe(base));
   next.setDate(next.getDate() + days);
   return next;
 }
@@ -397,8 +458,8 @@ function addSnoozeDays(base: Date, days: number): Date {
  * choices start at "Tomorrow".
  */
 export function resolveSnoozePresets(now: Date): ReadonlyArray<SnoozePreset> {
-  const inAnHour = new Date(now.getTime() + HOUR_MS);
-  const inThreeHours = new Date(now.getTime() + 3 * HOUR_MS);
+  const inAnHour = DateTime.toDate(DateTime.makeUnsafe(now.getTime() + HOUR_MS));
+  const inThreeHours = DateTime.toDate(DateTime.makeUnsafe(now.getTime() + 3 * HOUR_MS));
   const presets: SnoozePreset[] = [
     {
       id: "hour",
diff --git a/packages/client-runtime/src/state/threadShell.ts b/packages/client-runtime/src/state/threadShell.ts
index 65cee0427eb0..3d96fd0ed4ad 100644
--- a/packages/client-runtime/src/state/threadShell.ts
+++ b/packages/client-runtime/src/state/threadShell.ts
@@ -1,7 +1,7 @@
 import type {
   EnvironmentId,
-  OrchestrationShellSnapshot,
-  OrchestrationThreadShell,
+  OrchestrationV2ShellSnapshot,
+  OrchestrationV2ThreadShell,
   ProjectId,
   ScopedProjectRef,
   ScopedThreadRef,
@@ -10,7 +10,7 @@ import type {
 import { Atom } from "effect/unstable/reactivity";
 
 import type { EnvironmentThreadShell } from "./models.ts";
-import { scopeThreadShell } from "./models.ts";
+import { presentThreadShell } from "./models.ts";
 import type { EnvironmentCatalogState } from "./connections.ts";
 import {
   arrayElementsEqual,
@@ -21,9 +21,9 @@ import {
   threadRefsEqual,
 } from "./entities.ts";
 
-const EMPTY_THREADS: ReadonlyArray<OrchestrationThreadShell> = Object.freeze([]);
+const EMPTY_THREADS: ReadonlyArray<OrchestrationV2ThreadShell> = Object.freeze([]);
 const EMPTY_SCOPED_THREAD_REFS: ReadonlyArray<ScopedThreadRef> = Object.freeze([]);
-const EMPTY_THREAD_INDEX: ReadonlyMap<ThreadId, OrchestrationThreadShell> = new Map();
+const EMPTY_THREAD_INDEX: ReadonlyMap<ThreadId, OrchestrationV2ThreadShell> = new Map();
 const EMPTY_THREAD_REFS_BY_PROJECT: ReadonlyMap<
   ProjectId,
   ReadonlyArray<ScopedThreadRef>
@@ -33,17 +33,17 @@ export function createEnvironmentThreadShellAtoms(input: {
   readonly catalogValueAtom: Atom.Atom<EnvironmentCatalogState>;
   readonly snapshotAtom: (
     environmentId: EnvironmentId,
-  ) => Atom.Atom<OrchestrationShellSnapshot | null>;
+  ) => Atom.Atom<OrchestrationV2ShellSnapshot | null>;
 }) {
   const environmentThreadsAtom = Atom.family((environmentId: EnvironmentId) =>
     Atom.make(
-      (get): ReadonlyArray<OrchestrationThreadShell> =>
+      (get): ReadonlyArray<OrchestrationV2ThreadShell> =>
         get(input.snapshotAtom(environmentId))?.threads ?? EMPTY_THREADS,
     ).pipe(Atom.withLabel(`environment-threads:${environmentId}`)),
   );
 
   const environmentThreadIndexAtom = Atom.family((environmentId: EnvironmentId) =>
-    Atom.make((get): ReadonlyMap<ThreadId, OrchestrationThreadShell> => {
+    Atom.make((get): ReadonlyMap<ThreadId, OrchestrationV2ThreadShell> => {
       const threads = get(environmentThreadsAtom(environmentId));
       if (threads.length === 0) {
         return EMPTY_THREAD_INDEX;
@@ -102,7 +102,7 @@ export function createEnvironmentThreadShellAtoms(input: {
 
   const threadShellAtomFamily = Atom.family((key: string) => {
     const ref = parseThreadKey(key);
-    let previousSource: OrchestrationThreadShell | null = null;
+    let previousSource: OrchestrationV2ThreadShell | null = null;
     let previousValue: EnvironmentThreadShell | null = null;
     return Atom.make((get) => {
       const source = get(environmentThreadIndexAtom(ref.environmentId)).get(ref.threadId) ?? null;
@@ -110,7 +110,7 @@ export function createEnvironmentThreadShellAtoms(input: {
         return previousValue;
       }
       previousSource = source;
-      previousValue = source === null ? null : scopeThreadShell(ref.environmentId, source);
+      previousValue = source === null ? null : presentThreadShell(ref.environmentId, source);
       return previousValue;
     }).pipe(Atom.withLabel(`environment-thread-shell:${key}`));
   });
diff --git a/packages/client-runtime/src/state/threadSnapshotHttp.ts b/packages/client-runtime/src/state/threadSnapshotHttp.ts
index 6acc3b5d8a4f..c1aead302adc 100644
--- a/packages/client-runtime/src/state/threadSnapshotHttp.ts
+++ b/packages/client-runtime/src/state/threadSnapshotHttp.ts
@@ -1,4 +1,4 @@
-import type { OrchestrationThreadDetailSnapshot, ThreadId } from "@t3tools/contracts";
+import type { OrchestrationV2ThreadDetailSnapshot, ThreadId } from "@t3tools/contracts";
 import * as Cause from "effect/Cause";
 import * as Context from "effect/Context";
 import * as Effect from "effect/Effect";
@@ -14,28 +14,46 @@ import {
   makeEnvironmentHttpApiClient,
   type RemoteEnvironmentRequestError,
 } from "../rpc/http.ts";
-import { buildEnvironmentAuthHeaders, withEnvironmentCredentials } from "./environmentHttpAuth.ts";
+import {
+  buildEnvironmentAuthHeaders,
+  withEnvironmentCredentials,
+  withOrchestrationProtocolHeader,
+} from "./environmentHttpAuth.ts";
 
 // Bounded so a pathologically slow endpoint cannot block the (cheaper) socket
 // fallback for long. The cached thread renders while this runs, so the wait only
 // delays the transition to live data on the first open, not the initial paint.
 const DEFAULT_THREAD_SNAPSHOT_TIMEOUT_MS = 6_000;
 
+/** Progressive history metadata returned by a bounded snapshot loader. */
+export type ThreadSnapshotHistoryMeta = {
+  readonly historyCursor: string | null;
+  readonly hasMoreHistory: boolean;
+  /** Max local turn ordinal from the full projection; optional on older servers. */
+  readonly latestLocalTurnOrdinal?: number | null;
+};
+
+/**
+ * Outcome of an HTTP thread-detail snapshot load.
+ *
+ * - `present`: snapshot body is available (seed projection, resume via socket).
+ * - `missing`: server definitively reported the thread does not exist (404).
+ * - `unavailable`: transport/timeout/5xx/etc.; fall back to the socket path.
+ */
+export type ThreadSnapshotLoadResult =
+  | {
+      readonly _tag: "present";
+      readonly snapshot: OrchestrationV2ThreadDetailSnapshot;
+      readonly history?: ThreadSnapshotHistoryMeta;
+    }
+  | { readonly _tag: "missing" }
+  | { readonly _tag: "unavailable" };
+
 /**
  * Load a thread's detail snapshot over HTTP instead of embedding it in the
  * WebSocket subscription's first frame. The response is gzip-compressible by
  * the transport and keeps the (potentially multi-KB) snapshot off the socket.
  */
-/**
- * Optional turn window for a snapshot fetch. Only send a window to servers
- * that advertise `threadSnapshotPagination`; older servers reject unknown
- * query parameters.
- */
-export interface ThreadSnapshotWindow {
-  readonly turnLimit: number;
-  readonly beforeCursor?: string;
-}
-
 export const fetchEnvironmentThreadSnapshot = Effect.fn(
   "clientRuntime.state.fetchEnvironmentThreadSnapshot",
 )(function* (input: {
@@ -43,7 +61,6 @@ export const fetchEnvironmentThreadSnapshot = Effect.fn(
   readonly threadId: ThreadId;
   readonly signer: Option.Option<ManagedRelayDpopSigner["Service"]>;
   readonly timeoutMs?: number;
-  readonly window?: ThreadSnapshotWindow;
 }) {
   const requestUrl = environmentEndpointUrl(
     input.prepared.httpBaseUrl,
@@ -63,13 +80,7 @@ export const fetchEnvironmentThreadSnapshot = Effect.fn(
       input.prepared.httpAuthorization,
       client.orchestration.threadSnapshot({
         params: { threadId: input.threadId },
-        payload: {
-          ...(input.window !== undefined ? { turnLimit: input.window.turnLimit } : {}),
-          ...(input.window?.beforeCursor !== undefined
-            ? { beforeCursor: input.window.beforeCursor }
-            : {}),
-        },
-        headers,
+        headers: withOrchestrationProtocolHeader(headers),
       }),
     ),
   );
@@ -78,10 +89,12 @@ export const fetchEnvironmentThreadSnapshot = Effect.fn(
 export type FetchEnvironmentThreadSnapshotError = RemoteEnvironmentRequestError;
 
 /**
- * Loads a thread's detail snapshot over HTTP, returning `Option.none()` when it
- * cannot be loaded (so the caller falls back to the socket-embedded snapshot).
- * Decouples the thread state machine from the underlying HTTP + DPoP details and
- * keeps them out of test contexts.
+ * Loads a thread's detail snapshot over HTTP.
+ *
+ * Distinguishes a definitive missing thread (HTTP 404) from transient snapshot
+ * unavailability so the thread state machine can mark the thread deleted without
+ * opening a socket subscription, while still falling back to the socket when the
+ * HTTP path is merely unavailable.
  */
 export class ThreadSnapshotLoader extends Context.Service<
   ThreadSnapshotLoader,
@@ -89,8 +102,7 @@ export class ThreadSnapshotLoader extends Context.Service<
     readonly load: (
       prepared: PreparedConnection,
       threadId: ThreadId,
-      window?: ThreadSnapshotWindow,
-    ) => Effect.Effect<Option.Option<OrchestrationThreadDetailSnapshot>>;
+    ) => Effect.Effect<ThreadSnapshotLoadResult>;
   }
 >()("@t3tools/client-runtime/state/threadSnapshotHttp/ThreadSnapshotLoader") {}
 
@@ -107,26 +119,24 @@ export const threadSnapshotLoaderLayer: Layer.Layer<
     // connections work without one).
     const signer = yield* Effect.serviceOption(ManagedRelayDpopSigner);
     return ThreadSnapshotLoader.of({
-      load: (prepared: PreparedConnection, threadId: ThreadId, window?: ThreadSnapshotWindow) =>
-        fetchEnvironmentThreadSnapshot({
-          prepared,
-          threadId,
-          signer,
-          ...(window !== undefined ? { window } : {}),
-        }).pipe(
-          Effect.map(Option.some<OrchestrationThreadDetailSnapshot>),
+      load: (prepared: PreparedConnection, threadId: ThreadId) =>
+        fetchEnvironmentThreadSnapshot({ prepared, threadId, signer }).pipe(
+          Effect.map(
+            (snapshot): ThreadSnapshotLoadResult => ({
+              _tag: "present",
+              snapshot,
+            }),
+          ),
           Effect.provideService(HttpClient.HttpClient, httpClient),
-          // A genuinely missing thread (404) is expected — the socket
-          // subscription is the source of truth for thread existence and will
-          // surface the deletion — so don't treat it as an error worth warning
-          // about; just defer to the socket path.
+          // A genuinely missing thread (404) is definitive: do not fall back to
+          // the socket or retry. Callers mark the thread deleted and clear cache.
           Effect.catchTags({
             EnvironmentResourceNotFoundError: () =>
               Effect.logDebug(
-                "Thread snapshot not found over HTTP; deferring to the socket subscription.",
+                "Thread snapshot not found over HTTP; treating the thread as deleted.",
               ).pipe(
                 Effect.annotateLogs({ threadId }),
-                Effect.as(Option.none<OrchestrationThreadDetailSnapshot>()),
+                Effect.as({ _tag: "missing" } satisfies ThreadSnapshotLoadResult),
               ),
           }),
           Effect.catchCause((cause) =>
@@ -134,7 +144,7 @@ export const threadSnapshotLoaderLayer: Layer.Layer<
               "Could not load the thread snapshot over HTTP; using the socket snapshot instead.",
             ).pipe(
               Effect.annotateLogs({ threadId, cause: Cause.pretty(cause) }),
-              Effect.as(Option.none<OrchestrationThreadDetailSnapshot>()),
+              Effect.as({ _tag: "unavailable" } satisfies ThreadSnapshotLoadResult),
             ),
           ),
         ),
diff --git a/packages/client-runtime/src/state/threadSort.test.ts b/packages/client-runtime/src/state/threadSort.test.ts
index f4ea270a001e..14da7dee5300 100644
--- a/packages/client-runtime/src/state/threadSort.test.ts
+++ b/packages/client-runtime/src/state/threadSort.test.ts
@@ -1,12 +1,24 @@
 import { describe, expect, it } from "vite-plus/test";
 
 import {
+  activeThreadAnchorTimestampMs,
   planPinnedMove,
   sortPinnedThreadsByOrderKey,
   sortThreads,
   type ThreadSortInput,
 } from "./threadSort.ts";
 
+describe("activeThreadAnchorTimestampMs", () => {
+  it("uses the later unsettle time when an old thread re-enters the active list", () => {
+    expect(
+      activeThreadAnchorTimestampMs({
+        createdAt: "2026-01-01T00:00:00.000Z",
+        unsettledAt: "2026-08-01T00:00:00.000Z",
+      }),
+    ).toBe(Date.parse("2026-08-01T00:00:00.000Z"));
+  });
+});
+
 type TestThread = { readonly id: string } & ThreadSortInput;
 
 function makeThread(overrides: Partial<TestThread> = {}): TestThread {
diff --git a/packages/client-runtime/src/state/threadState.ts b/packages/client-runtime/src/state/threadState.ts
index 8ba9696ec576..d534f50ce916 100644
--- a/packages/client-runtime/src/state/threadState.ts
+++ b/packages/client-runtime/src/state/threadState.ts
@@ -1,40 +1,25 @@
-import type { OrchestrationThread } from "@t3tools/contracts";
+import type { OrchestrationV2ThreadProjection } from "@t3tools/contracts";
 import * as Option from "effect/Option";
 
-export type EnvironmentThreadStatus = "empty" | "cached" | "synchronizing" | "live" | "deleted";
+import { EMPTY_THREAD_HISTORY_META, type ThreadHistoryMeta } from "./threadHistoryMerge.ts";
 
-/**
- * Pagination state for a windowed thread. Present only when the loaded thread
- * is a window (the server returned `page` metadata); absent means the thread is
- * fully loaded — either the server predates pagination or the window reached
- * the top.
- */
-export interface EnvironmentThreadPageState {
-  /** Opaque exclusive cursor for the next older slice; null when fully loaded. */
-  readonly beforeCursor: string | null;
-  readonly hasMore: boolean;
-  /** True while an older page fetch is in flight. */
-  readonly loadingOlder: boolean;
-}
+export type EnvironmentThreadStatus = "empty" | "cached" | "synchronizing" | "live" | "deleted";
 
 export interface EnvironmentThreadState {
-  readonly data: Option.Option<OrchestrationThread>;
+  readonly data: Option.Option<OrchestrationV2ThreadProjection>;
   readonly status: EnvironmentThreadStatus;
   readonly error: Option.Option<string>;
-  readonly page: Option.Option<EnvironmentThreadPageState>;
+  /**
+   * Progressive history cursor for bounded hydration. Absent/cleared on full
+   * snapshot paths. Errors here are thread/history-local and must not be
+   * promoted into the environment disconnect path.
+   */
+  readonly history: ThreadHistoryMeta;
 }
 
 export const EMPTY_ENVIRONMENT_THREAD_STATE: EnvironmentThreadState = {
   data: Option.none(),
   status: "empty",
   error: Option.none(),
-  page: Option.none(),
+  history: EMPTY_THREAD_HISTORY_META,
 };
-
-/** Whether the thread has older turns that can be loaded with more pages. */
-export function threadHasOlderTurns(state: EnvironmentThreadState): boolean {
-  return Option.match(state.page, {
-    onNone: () => false,
-    onSome: (page) => page.hasMore,
-  });
-}
diff --git a/packages/client-runtime/src/state/threadWorkflows.test.ts b/packages/client-runtime/src/state/threadWorkflows.test.ts
new file mode 100644
index 000000000000..dfd1fe7fd92b
--- /dev/null
+++ b/packages/client-runtime/src/state/threadWorkflows.test.ts
@@ -0,0 +1,354 @@
+import { describe, expect, it } from "vite-plus/test";
+
+import {
+  canDetachThreadProviderSession,
+  canForkProjectedAssistantItem,
+  deriveThreadQueueWorkflowState,
+  resolveLatestMergeBackRun,
+} from "./threadWorkflows.ts";
+
+const capabilities = (input?: {
+  readonly queued?: boolean;
+  readonly steer?: boolean;
+  readonly restartSteer?: boolean;
+  readonly nativeFork?: boolean;
+  readonly portableFork?: boolean;
+}) =>
+  ({
+    turns: {
+      supportsQueuedMessages: input?.queued ?? false,
+      supportsActiveSteering: input?.steer ?? false,
+      supportsSteeringByInterruptRestart: input?.restartSteer ?? false,
+    },
+    threads: {
+      canForkThread: input?.nativeFork ?? false,
+      canForkFromTurn: input?.nativeFork ?? false,
+    },
+    identity: { nativeThreadIds: input?.nativeFork ? "strong" : "none" },
+    context: { supportsFullThreadHandoff: input?.portableFork ?? false },
+  }) as never;
+
+describe("thread workflows", () => {
+  it("sorts queued messages and gates reorder and promotion from capabilities", () => {
+    const state = deriveThreadQueueWorkflowState({
+      thread: { id: "thread", activeProviderThreadId: "provider-thread" },
+      runs: [
+        {
+          id: "active",
+          status: "running",
+          providerThreadId: "provider-thread",
+          activeAttemptId: "attempt-active",
+          ordinal: 1,
+        },
+        { id: "later", status: "queued", userMessageId: "message-later", ordinal: 3 },
+        {
+          id: "first",
+          status: "queued",
+          userMessageId: "message-first",
+          ordinal: 2,
+          queuePosition: 1,
+        },
+      ],
+      messages: [
+        {
+          id: "message-first",
+          text: "First",
+          attachments: [
+            {
+              type: "image",
+              id: "attachment-first",
+              name: "first.png",
+              mimeType: "image/png",
+              sizeBytes: 64,
+            },
+          ],
+        },
+        { id: "message-later", text: "Later" },
+      ],
+      providerTurns: [
+        {
+          id: "provider-turn-active",
+          runAttemptId: "attempt-active",
+          status: "running",
+        },
+      ],
+      providerThreads: [
+        {
+          id: "provider-thread",
+          appThreadId: "thread",
+          providerSessionId: "provider-session",
+        },
+      ],
+      providerSessions: [
+        {
+          id: "provider-session",
+          status: "running",
+          capabilities: capabilities({ queued: true, restartSteer: true }),
+        },
+      ],
+    } as never);
+
+    expect(state.queuedRuns.map(({ run, text }) => [run.id, text])).toEqual([
+      ["first", "First"],
+      ["later", "Later"],
+    ]);
+    expect(state.queuedRuns.map(({ attachments }) => attachments.map(({ id }) => id))).toEqual([
+      ["attachment-first"],
+      [],
+    ]);
+    expect(state.activeRun?.id).toBe("active");
+    expect(state.canReorder).toBe(true);
+    expect(state.canPromoteToSteer).toBe(true);
+  });
+
+  it("hides automatic completion delivery from the visible queue", () => {
+    const state = deriveThreadQueueWorkflowState({
+      thread: { id: "thread", activeProviderThreadId: null },
+      runs: [
+        {
+          id: "automatic",
+          status: "queued",
+          userMessageId: "message-automatic",
+          ordinal: 2,
+          queuePosition: 1,
+        },
+        {
+          id: "visible",
+          status: "queued",
+          userMessageId: "message-visible",
+          ordinal: 3,
+          queuePosition: 2,
+        },
+      ],
+      messages: [
+        {
+          id: "message-automatic",
+          text: "A delegated task reached a terminal state.",
+          delegatedCompletion: {
+            generation: 1,
+            parentRunId: "run:parent",
+            taskIds: ["task:child"],
+          },
+        },
+        { id: "message-visible", text: "Visible queued message" },
+      ],
+      providerTurns: [],
+      providerThreads: [],
+      providerSessions: [],
+    } as never);
+
+    expect(state.queuedRuns.map(({ run, text }) => [run.id, text])).toEqual([
+      ["visible", "Visible queued message"],
+    ]);
+  });
+
+  it("removes only the promoted head from the visible queue", () => {
+    const state = deriveThreadQueueWorkflowState({
+      thread: { id: "thread", activeProviderThreadId: "provider-thread" },
+      runs: [
+        {
+          id: "promoted",
+          status: "starting",
+          userMessageId: "message-promoted",
+          providerThreadId: "provider-thread",
+          ordinal: 2,
+          queuePosition: null,
+        },
+        {
+          id: "still-queued",
+          status: "queued",
+          userMessageId: "message-still-queued",
+          providerThreadId: "provider-thread",
+          ordinal: 3,
+          queuePosition: 2,
+        },
+      ],
+      messages: [
+        { id: "message-promoted", text: "Run now" },
+        { id: "message-still-queued", text: "Wait longer" },
+      ],
+      providerTurns: [],
+      providerThreads: [],
+      providerSessions: [],
+    } as never);
+
+    expect(state.activeRun?.id).toBe("promoted");
+    expect(state.queuedRuns.map(({ run, text }) => [run.id, text])).toEqual([
+      ["still-queued", "Wait longer"],
+    ]);
+  });
+
+  it.each(["preparing", "starting", "waiting"] as const)(
+    "does not promote queued work into a %s run",
+    (status) => {
+      const state = deriveThreadQueueWorkflowState({
+        thread: { id: "thread", activeProviderThreadId: "provider-thread" },
+        runs: [
+          {
+            id: "active",
+            status,
+            providerThreadId: "provider-thread",
+            activeAttemptId: "attempt-active",
+            ordinal: 1,
+          },
+          { id: "queued", status: "queued", userMessageId: "message", ordinal: 2 },
+        ],
+        messages: [{ id: "message", text: "Queued" }],
+        providerTurns: [
+          {
+            id: "provider-turn-active",
+            runAttemptId: "attempt-active",
+            status: status === "waiting" ? "completed" : "starting",
+          },
+        ],
+        providerThreads: [
+          {
+            id: "provider-thread",
+            appThreadId: "thread",
+            providerSessionId: "provider-session",
+          },
+        ],
+        providerSessions: [
+          {
+            id: "provider-session",
+            status: "running",
+            capabilities: capabilities({ queued: true, steer: true }),
+          },
+        ],
+      } as never);
+
+      expect(state.canPromoteToSteer).toBe(false);
+    },
+  );
+
+  it("does not promote queued work until the running provider turn is projected", () => {
+    const state = deriveThreadQueueWorkflowState({
+      thread: { id: "thread", activeProviderThreadId: "provider-thread" },
+      runs: [
+        {
+          id: "active",
+          status: "running",
+          providerThreadId: "provider-thread",
+          activeAttemptId: "attempt-active",
+          ordinal: 1,
+        },
+        { id: "queued", status: "queued", userMessageId: "message", ordinal: 2 },
+      ],
+      messages: [{ id: "message", text: "Queued" }],
+      providerTurns: [],
+      providerThreads: [
+        {
+          id: "provider-thread",
+          appThreadId: "thread",
+          providerSessionId: "provider-session",
+        },
+      ],
+      providerSessions: [
+        {
+          id: "provider-session",
+          status: "running",
+          capabilities: capabilities({ queued: true, steer: true }),
+        },
+      ],
+    } as never);
+
+    expect(state.canPromoteToSteer).toBe(false);
+  });
+
+  it("does not expose known unsupported queue or fork actions", () => {
+    const projection = {
+      thread: { id: "thread", activeProviderThreadId: "provider-thread" },
+      runs: [{ id: "queued", status: "queued", userMessageId: "message", ordinal: 1 }],
+      messages: [],
+      providerThreads: [
+        {
+          id: "provider-thread",
+          appThreadId: "thread",
+          providerSessionId: "provider-session",
+        },
+      ],
+      providerSessions: [
+        {
+          id: "provider-session",
+          status: "ready",
+          capabilities: capabilities(),
+        },
+      ],
+    } as never;
+    const queue = deriveThreadQueueWorkflowState(projection);
+    const projectedItem = {
+      item: { type: "assistant_message", runId: "run", status: "completed" },
+    } as never;
+
+    expect(queue.canReorder).toBe(false);
+    expect(queue.canPromoteToSteer).toBe(false);
+    expect(canForkProjectedAssistantItem({ projectedItem, capabilities: capabilities() })).toBe(
+      false,
+    );
+    expect(canDetachThreadProviderSession(projection)).toBe(true);
+  });
+
+  it("allows native, portable, and capability-unknown exact-run forks", () => {
+    const projectedItem = {
+      item: { type: "assistant_message", runId: "run", status: "completed" },
+    } as never;
+
+    expect(
+      canForkProjectedAssistantItem({
+        projectedItem,
+        capabilities: capabilities({ nativeFork: true }),
+      }),
+    ).toBe(true);
+    expect(
+      canForkProjectedAssistantItem({
+        projectedItem,
+        capabilities: capabilities({ portableFork: true }),
+      }),
+    ).toBe(true);
+    expect(canForkProjectedAssistantItem({ projectedItem })).toBe(true);
+    expect(
+      canForkProjectedAssistantItem({
+        projectedItem: {
+          item: { type: "assistant_message", runId: "run", status: "running" },
+        } as never,
+      }),
+    ).toBe(false);
+  });
+
+  it("merges the newest provider-finished run while checkpoint capture is pending", () => {
+    const projection = {
+      runs: [
+        { id: "newest-queued", status: "queued", ordinal: 3 },
+        { id: "older-completed", status: "completed", ordinal: 1 },
+        { id: "newest-finished", status: "waiting", ordinal: 2 },
+      ],
+    } as never;
+
+    expect(resolveLatestMergeBackRun(projection)?.id).toBe("newest-finished");
+  });
+
+  it("does not let a stale completed run later in storage order hide the waiting checkpoint", () => {
+    const projection = {
+      runs: [
+        { id: "newest-finished", status: "waiting", ordinal: 2 },
+        { id: "older-completed", status: "completed", ordinal: 1 },
+      ],
+    } as never;
+
+    expect(resolveLatestMergeBackRun(projection)?.id).toBe("newest-finished");
+  });
+
+  it.each(["preparing", "starting", "running"] as const)(
+    "does not merge older history while a newer run is %s",
+    (status) => {
+      const projection = {
+        runs: [
+          { id: "older-completed", status: "completed", ordinal: 1 },
+          { id: "newer-active", status, ordinal: 2 },
+        ],
+      } as never;
+
+      expect(resolveLatestMergeBackRun(projection)).toBeNull();
+    },
+  );
+});
diff --git a/packages/client-runtime/src/state/threadWorkflows.ts b/packages/client-runtime/src/state/threadWorkflows.ts
new file mode 100644
index 000000000000..29bcc1f459de
--- /dev/null
+++ b/packages/client-runtime/src/state/threadWorkflows.ts
@@ -0,0 +1,152 @@
+import type {
+  ChatAttachment,
+  OrchestrationV2ProjectedTurnItem,
+  OrchestrationV2ProviderCapabilities,
+  OrchestrationV2ThreadProjection,
+} from "@t3tools/contracts";
+import { copySorted } from "@t3tools/shared/Array";
+
+type Projection = OrchestrationV2ThreadProjection;
+type Run = Projection["runs"][number];
+type ProviderSession = Projection["providerSessions"][number];
+
+const ACTIVE_RUN_STATUSES = new Set<Run["status"]>(["preparing", "starting", "running", "waiting"]);
+const MERGE_BACK_RUN_STATUSES = new Set<Run["status"]>(["waiting", "completed"]);
+const MERGE_BACK_BLOCKING_RUN_STATUSES = new Set<Run["status"]>([
+  "preparing",
+  "starting",
+  "running",
+]);
+
+export interface QueuedThreadRun {
+  readonly run: Run;
+  readonly text: string;
+  readonly attachments: ReadonlyArray<ChatAttachment>;
+}
+
+export interface ThreadQueueWorkflowState {
+  readonly activeRun: Run | null;
+  readonly queuedRuns: ReadonlyArray<QueuedThreadRun>;
+  readonly canReorder: boolean;
+  readonly canPromoteToSteer: boolean;
+}
+
+export function resolveActiveThreadRun(projection: Projection): Run | null {
+  return projection.runs.findLast((run) => ACTIVE_RUN_STATUSES.has(run.status)) ?? null;
+}
+
+/**
+ * A successfully finished provider turn remains in `waiting` while its
+ * checkpoint is captured. Keep that newest turn available for merge-back
+ * instead of falling through to an older fully checkpointed run.
+ */
+export function resolveLatestMergeBackRun(projection: Projection): Run | null {
+  const latestProviderFinishedRun = projection.runs.reduce<Run | null>(
+    (latest, run) =>
+      MERGE_BACK_RUN_STATUSES.has(run.status) && (latest === null || run.ordinal > latest.ordinal)
+        ? run
+        : latest,
+    null,
+  );
+  if (latestProviderFinishedRun === null) return null;
+
+  const hasNewerActiveRun = projection.runs.some(
+    (run) =>
+      run.ordinal > latestProviderFinishedRun.ordinal &&
+      MERGE_BACK_BLOCKING_RUN_STATUSES.has(run.status),
+  );
+  return hasNewerActiveRun ? null : latestProviderFinishedRun;
+}
+
+export function resolveThreadProviderSession(projection: Projection): ProviderSession | null {
+  const activeRun = resolveActiveThreadRun(projection);
+  const providerThreadId = activeRun?.providerThreadId ?? projection.thread.activeProviderThreadId;
+  const activeProviderThread =
+    providerThreadId === null
+      ? null
+      : (projection.providerThreads.find((thread) => thread.id === providerThreadId) ?? null);
+  const attachedProviderThread =
+    activeProviderThread ??
+    projection.providerThreads.find(
+      (thread) => thread.appThreadId === projection.thread.id && thread.providerSessionId !== null,
+    ) ??
+    null;
+  const sessionId = attachedProviderThread?.providerSessionId ?? null;
+  if (sessionId !== null) {
+    return projection.providerSessions.find((session) => session.id === sessionId) ?? null;
+  }
+  return (
+    projection.providerSessions.findLast(
+      (session) => session.status !== "stopped" && session.status !== "error",
+    ) ?? null
+  );
+}
+
+export function deriveThreadQueueWorkflowState(projection: Projection): ThreadQueueWorkflowState {
+  const activeRun = resolveActiveThreadRun(projection);
+  const session = resolveThreadProviderSession(projection);
+  const capabilities = session?.capabilities.turns;
+  const hasSteerableProviderTurn =
+    activeRun?.status === "running" &&
+    activeRun.activeAttemptId !== null &&
+    projection.providerTurns.some(
+      (turn) => turn.runAttemptId === activeRun.activeAttemptId && turn.status === "running",
+    );
+  const automaticCompletionMessageIds = new Set(
+    projection.messages
+      .filter((message) => message.delegatedCompletion !== undefined)
+      .map((message) => message.id),
+  );
+  const queuedRuns = copySorted(
+    projection.runs.filter(
+      (run) => run.status === "queued" && !automaticCompletionMessageIds.has(run.userMessageId),
+    ),
+    (left, right) =>
+      (left.queuePosition ?? left.ordinal) - (right.queuePosition ?? right.ordinal) ||
+      left.ordinal - right.ordinal,
+  ).map((run) => {
+    const message = projection.messages.find((candidate) => candidate.id === run.userMessageId);
+    return {
+      run,
+      text: message?.text ?? "Queued message",
+      attachments: message?.attachments ?? [],
+    };
+  });
+
+  return {
+    activeRun,
+    queuedRuns,
+    canReorder: capabilities?.supportsQueuedMessages === true,
+    canPromoteToSteer:
+      hasSteerableProviderTurn &&
+      (capabilities?.supportsActiveSteering === true ||
+        capabilities?.supportsSteeringByInterruptRestart === true),
+  };
+}
+
+export function canForkProjectedAssistantItem(input: {
+  readonly projectedItem: OrchestrationV2ProjectedTurnItem;
+  readonly capabilities?: OrchestrationV2ProviderCapabilities | undefined;
+}): boolean {
+  const item = input.projectedItem.item;
+  if (item.type !== "assistant_message" || item.runId === null || item.status !== "completed") {
+    return false;
+  }
+  if (input.capabilities === undefined) {
+    // Historical and inherited rows may outlive their provider-session record.
+    // Keep the portable server-side fallback available when capability evidence
+    // is absent; a known incapable provider is rejected below.
+    return true;
+  }
+  const capabilities = input.capabilities;
+  const canForkNatively =
+    capabilities.threads.canForkThread &&
+    capabilities.threads.canForkFromTurn &&
+    capabilities.identity.nativeThreadIds === "strong";
+  return canForkNatively || capabilities.context.supportsFullThreadHandoff;
+}
+
+export function canDetachThreadProviderSession(projection: Projection): boolean {
+  const session = resolveThreadProviderSession(projection);
+  return session !== null && session.status !== "stopped" && session.status !== "error";
+}
diff --git a/packages/client-runtime/src/state/threads-pagination.test.ts b/packages/client-runtime/src/state/threads-pagination.test.ts
deleted file mode 100644
index 62cad18f89e0..000000000000
--- a/packages/client-runtime/src/state/threads-pagination.test.ts
+++ /dev/null
@@ -1,543 +0,0 @@
-import {
-  EnvironmentId,
-  EventId,
-  ORCHESTRATION_WS_METHODS,
-  ProjectId,
-  ProviderInstanceId,
-  ThreadId,
-  TurnId,
-  type OrchestrationMessage,
-  type OrchestrationThread,
-  type OrchestrationThreadDetailSnapshot,
-  type OrchestrationThreadStreamItem,
-} from "@t3tools/contracts";
-import { describe, expect, it } from "@effect/vitest";
-import * as Deferred from "effect/Deferred";
-import * as Effect from "effect/Effect";
-import * as Option from "effect/Option";
-import * as Queue from "effect/Queue";
-import * as Ref from "effect/Ref";
-import * as Stream from "effect/Stream";
-import * as SubscriptionRef from "effect/SubscriptionRef";
-
-import type { WsRpcProtocolClient } from "../rpc/protocol.ts";
-import {
-  AVAILABLE_CONNECTION_STATE,
-  PrimaryConnectionTarget,
-  type PreparedConnection,
-  type SupervisorConnectionState,
-} from "../connection/model.ts";
-import * as EnvironmentSupervisor from "../connection/supervisor.ts";
-import * as Persistence from "../platform/persistence.ts";
-import * as RpcSession from "../rpc/session.ts";
-import type { ThreadSnapshotWindow } from "./threadSnapshotHttp.ts";
-import {
-  INITIAL_THREAD_USER_TURN_LIMIT,
-  makeEnvironmentThreadState,
-  requestOlderThreadTurns,
-  ThreadSnapshotLoader,
-  type EnvironmentThreadState,
-} from "./threads.ts";
-
-const TARGET = new PrimaryConnectionTarget({
-  environmentId: EnvironmentId.make("environment-1"),
-  label: "Test environment",
-  httpBaseUrl: "https://environment.example.test",
-  wsBaseUrl: "wss://environment.example.test",
-});
-const THREAD_ID = ThreadId.make("thread-1");
-const PREPARED: PreparedConnection = {
-  environmentId: TARGET.environmentId,
-  label: TARGET.label,
-  httpBaseUrl: TARGET.httpBaseUrl,
-  socketUrl: TARGET.wsBaseUrl,
-  httpAuthorization: null,
-  target: TARGET,
-};
-
-function message(id: string, turnId: string, createdAt: string): OrchestrationMessage {
-  return {
-    id: id as OrchestrationMessage["id"],
-    role: "assistant",
-    text: `text of ${id}`,
-    turnId: TurnId.make(turnId),
-    streaming: false,
-    createdAt,
-    updatedAt: createdAt,
-  };
-}
-
-const OLDER_MESSAGE = message("message-old", "turn-1", "2026-04-01T00:00:00.000Z");
-const RECENT_MESSAGE = message("message-recent", "turn-2", "2026-04-01T01:00:00.000Z");
-
-// Reverts retain turns via checkpoints with checkpointTurnCount <= the revert's
-// turnCount, so both fixture turns carry one: reverting to turnCount 1 keeps
-// turn-1 (the older page's turn) and discards turn-2 (the loaded window's).
-function checkpoint(turnId: string, turnCount: number): OrchestrationThread["checkpoints"][number] {
-  return {
-    turnId: TurnId.make(turnId),
-    checkpointTurnCount: turnCount,
-    checkpointRef:
-      `checkpoint-${turnCount}` as OrchestrationThread["checkpoints"][number]["checkpointRef"],
-    status: "ready",
-    files: [],
-    assistantMessageId: null,
-    completedAt: "2026-04-01T01:00:00.000Z",
-  };
-}
-
-const BASE_THREAD: OrchestrationThread = {
-  id: THREAD_ID,
-  projectId: ProjectId.make("project-1"),
-  title: "Windowed thread",
-  modelSelection: {
-    instanceId: ProviderInstanceId.make("codex"),
-    model: "gpt-5.4",
-  },
-  runtimeMode: "full-access",
-  interactionMode: "default",
-  branch: "main",
-  worktreePath: null,
-  latestTurn: null,
-  createdAt: "2026-04-01T00:00:00.000Z",
-  updatedAt: "2026-04-01T00:00:00.000Z",
-  archivedAt: null,
-  settledOverride: null,
-  settledAt: null,
-  deletedAt: null,
-  messages: [RECENT_MESSAGE],
-  proposedPlans: [],
-  activities: [],
-  checkpoints: [checkpoint("turn-2", 2)],
-  session: null,
-};
-
-const WINDOWED_SNAPSHOT: OrchestrationThreadDetailSnapshot = {
-  snapshotSequence: 10,
-  thread: BASE_THREAD,
-  page: { beforeCursor: "cursor-1", hasMore: true, snapshotSequence: 10 },
-};
-
-const OLDER_PAGE: OrchestrationThreadDetailSnapshot = {
-  snapshotSequence: 10,
-  thread: {
-    ...BASE_THREAD,
-    messages: [OLDER_MESSAGE],
-    checkpoints: [checkpoint("turn-1", 1)],
-  },
-  page: { beforeCursor: null, hasMore: false, snapshotSequence: 10 },
-};
-
-type LoaderResponse = Option.Option<OrchestrationThreadDetailSnapshot>;
-
-const makeHarness = Effect.fn("TestThreadPagination.makeHarness")(function* (options?: {
-  readonly paginationCapability?: boolean;
-  readonly initialResponse?: LoaderResponse;
-  /** Cached snapshot returned by the cache store (simulates a warm cache). */
-  readonly cached?: OrchestrationThreadDetailSnapshot;
-}) {
-  const inputs = yield* Queue.unbounded<OrchestrationThreadStreamItem>();
-  const observed = yield* Queue.unbounded<EnvironmentThreadState>();
-  const loaderWindows = yield* Ref.make<ReadonlyArray<ThreadSnapshotWindow | undefined>>([]);
-  const lastSubscribeInput = yield* Ref.make<Record<string, unknown> | undefined>(undefined);
-  const savedThreads = yield* Ref.make<ReadonlyArray<OrchestrationThreadDetailSnapshot>>([]);
-  // Older-page responses resolve through deferreds so tests can interleave
-  // live events with an in-flight page fetch.
-  const pendingPageResponses = yield* Queue.unbounded<Deferred.Deferred<LoaderResponse>>();
-  const supervisorState = yield* SubscriptionRef.make<SupervisorConnectionState>(
-    AVAILABLE_CONNECTION_STATE,
-  );
-  const client = {
-    [ORCHESTRATION_WS_METHODS.subscribeThread]: (input: Record<string, unknown>) =>
-      Stream.unwrap(Ref.set(lastSubscribeInput, input).pipe(Effect.as(Stream.fromQueue(inputs)))),
-  } as unknown as WsRpcProtocolClient;
-  const session: RpcSession.RpcSession = {
-    client,
-    initialConfig: Effect.succeed({
-      threadSnapshotPagination: options?.paginationCapability !== false,
-    } as never),
-    ready: Effect.void,
-    probe: Effect.void,
-    closed: Effect.never,
-  };
-  const supervisorSession = yield* SubscriptionRef.make<Option.Option<RpcSession.RpcSession>>(
-    Option.some(session),
-  );
-  const prepared = yield* SubscriptionRef.make<Option.Option<PreparedConnection>>(
-    Option.some(PREPARED),
-  );
-  const snapshotLoader = ThreadSnapshotLoader.of({
-    load: (_prepared, _threadId, window) =>
-      Ref.update(loaderWindows, (current) => [...current, window]).pipe(
-        Effect.andThen(
-          window?.beforeCursor === undefined
-            ? Effect.succeed(
-                options?.initialResponse ?? Option.none<OrchestrationThreadDetailSnapshot>(),
-              )
-            : Deferred.make<LoaderResponse>().pipe(
-                Effect.tap((deferred) => Queue.offer(pendingPageResponses, deferred)),
-                Effect.flatMap(Deferred.await),
-              ),
-        ),
-      ),
-  });
-  const supervisor = EnvironmentSupervisor.EnvironmentSupervisor.of({
-    target: TARGET,
-    state: supervisorState,
-    session: supervisorSession,
-    prepared,
-    connect: Effect.void,
-    disconnect: Effect.void,
-    retryNow: Effect.void,
-  } satisfies EnvironmentSupervisor.EnvironmentSupervisor["Service"]);
-  const cache = Persistence.EnvironmentCacheStore.of({
-    loadShell: () => Effect.succeed(Option.none()),
-    saveShell: () => Effect.void,
-    loadThread: () =>
-      Effect.succeed(options?.cached !== undefined ? Option.some(options.cached) : Option.none()),
-    saveThread: (_environmentId, thread) =>
-      Ref.update(savedThreads, (current) => [...current, thread]),
-    removeThread: () => Effect.void,
-    loadServerConfig: () => Effect.succeed(Option.none()),
-    saveServerConfig: () => Effect.void,
-    loadVcsRefs: () => Effect.succeed(Option.none()),
-    saveVcsRefs: () => Effect.void,
-    removeVcsRefs: () => Effect.void,
-    clearVcsRefs: () => Effect.void,
-    clear: () => Effect.void,
-  });
-  const threadState = yield* makeEnvironmentThreadState(THREAD_ID).pipe(
-    Effect.provideService(EnvironmentSupervisor.EnvironmentSupervisor, supervisor),
-    Effect.provideService(Persistence.EnvironmentCacheStore, cache),
-    Effect.provideService(ThreadSnapshotLoader, snapshotLoader),
-  );
-  yield* SubscriptionRef.changes(threadState).pipe(
-    Stream.runForEach((state) => Queue.offer(observed, state)),
-    Effect.forkScoped,
-  );
-
-  const awaitState = (predicate: (state: EnvironmentThreadState) => boolean) =>
-    Queue.take(observed).pipe(Effect.repeat({ until: predicate }));
-  const resolveNextPage = (response: LoaderResponse) =>
-    Queue.take(pendingPageResponses).pipe(
-      Effect.flatMap((deferred) => Deferred.succeed(deferred, response)),
-    );
-
-  return {
-    inputs,
-    observed,
-    awaitState,
-    resolveNextPage,
-    loaderWindows,
-    lastSubscribeInput,
-    savedThreads,
-    threadState,
-  };
-});
-
-const hasMessage = (state: EnvironmentThreadState, id: string): boolean =>
-  Option.match(state.data, {
-    onNone: () => false,
-    onSome: (thread) => thread.messages.some((entry) => entry.id === id),
-  });
-
-const titleEvent = (title: string, sequence: number): OrchestrationThreadStreamItem => ({
-  kind: "event",
-  event: {
-    eventId: EventId.make(`event-title-${sequence}`),
-    sequence,
-    occurredAt: "2026-04-01T01:30:00.000Z",
-    commandId: null,
-    causationEventId: null,
-    correlationId: null,
-    metadata: {},
-    aggregateKind: "thread",
-    aggregateId: THREAD_ID,
-    type: "thread.meta-updated",
-    payload: {
-      threadId: THREAD_ID,
-      title,
-      updatedAt: "2026-04-01T01:30:00.000Z",
-    },
-  },
-});
-
-// Reverting to turnCount 1 retains only turns whose checkpoint count is <= 1:
-// turn-1 survives, turn-2 (the loaded window's newest turn) is discarded.
-const revertEvent = (sequence: number): OrchestrationThreadStreamItem => ({
-  kind: "event",
-  event: {
-    eventId: EventId.make(`event-revert-${sequence}`),
-    sequence,
-    occurredAt: "2026-04-01T02:00:00.000Z",
-    commandId: null,
-    causationEventId: null,
-    correlationId: null,
-    metadata: {},
-    aggregateKind: "thread",
-    aggregateId: THREAD_ID,
-    type: "thread.reverted",
-    payload: {
-      threadId: THREAD_ID,
-      turnCount: 1,
-    },
-  },
-});
-
-describe("thread pagination state", () => {
-  it.effect("windows the initial load when the server advertises pagination", () =>
-    Effect.gen(function* () {
-      const harness = yield* makeHarness({ initialResponse: Option.some(WINDOWED_SNAPSHOT) });
-      const state = yield* harness.awaitState((value) => Option.isSome(value.page));
-      expect(Option.getOrThrow(state.page)).toEqual({
-        beforeCursor: "cursor-1",
-        hasMore: true,
-        loadingOlder: false,
-      });
-      const windows = yield* Ref.get(harness.loaderWindows);
-      expect(windows[0]?.turnLimit).toBe(INITIAL_THREAD_USER_TURN_LIMIT);
-      const subscribeInput = yield* Ref.get(harness.lastSubscribeInput);
-      expect(subscribeInput?.turnLimit).toBe(INITIAL_THREAD_USER_TURN_LIMIT);
-    }),
-  );
-
-  it.effect("does not send a window to servers without the capability", () =>
-    Effect.gen(function* () {
-      const harness = yield* makeHarness({
-        paginationCapability: false,
-        initialResponse: Option.some({ snapshotSequence: 10, thread: BASE_THREAD }),
-      });
-      const state = yield* harness.awaitState((value) => Option.isSome(value.data));
-      expect(Option.isNone(state.page)).toBe(true);
-      const windows = yield* Ref.get(harness.loaderWindows);
-      expect(windows[0]).toBeUndefined();
-      const subscribeInput = yield* Ref.get(harness.lastSubscribeInput);
-      expect(subscribeInput?.turnLimit).toBeUndefined();
-    }),
-  );
-
-  it.effect("merges an older page below the loaded window and clears the cursor", () =>
-    Effect.gen(function* () {
-      const harness = yield* makeHarness({ initialResponse: Option.some(WINDOWED_SNAPSHOT) });
-      yield* harness.awaitState((value) => Option.isSome(value.page));
-
-      expect(requestOlderThreadTurns(TARGET.environmentId, THREAD_ID)).toBe(true);
-      yield* harness.awaitState((value) =>
-        Option.match(value.page, { onNone: () => false, onSome: (page) => page.loadingOlder }),
-      );
-      yield* harness.resolveNextPage(Option.some(OLDER_PAGE));
-
-      const state = yield* harness.awaitState((value) => hasMessage(value, "message-old"));
-      const thread = Option.getOrThrow(state.data);
-      // Older rows land before the loaded window's rows.
-      expect(thread.messages.map((entry) => entry.id)).toEqual(["message-old", "message-recent"]);
-      expect(Option.getOrThrow(state.page)).toEqual({
-        beforeCursor: null,
-        hasMore: false,
-        loadingOlder: false,
-      });
-    }),
-  );
-
-  it.effect("discards an in-flight older page when a revert rewrites history", () =>
-    Effect.gen(function* () {
-      const harness = yield* makeHarness({ initialResponse: Option.some(WINDOWED_SNAPSHOT) });
-      yield* harness.awaitState((value) => Option.isSome(value.page));
-
-      requestOlderThreadTurns(TARGET.environmentId, THREAD_ID);
-      yield* harness.awaitState((value) =>
-        Option.match(value.page, { onNone: () => false, onSome: (page) => page.loadingOlder }),
-      );
-      // Revert lands while the page fetch is in flight and removes turn-2.
-      yield* Queue.offer(harness.inputs, revertEvent(11));
-      yield* harness.awaitState((value) => !hasMessage(value, "message-recent"));
-      yield* harness.resolveNextPage(Option.some(OLDER_PAGE));
-
-      const state = yield* harness.awaitState((value) =>
-        Option.match(value.page, { onNone: () => false, onSome: (page) => !page.loadingOlder }),
-      );
-      // The stale page was dropped: no resurrected rows, cursor unchanged.
-      expect(hasMessage(state, "message-old")).toBe(false);
-      expect(Option.getOrThrow(state.page).beforeCursor).toBe("cursor-1");
-    }),
-  );
-
-  it.effect("discards an in-flight older page when a fresh snapshot replaces the thread", () =>
-    Effect.gen(function* () {
-      const harness = yield* makeHarness({ initialResponse: Option.some(WINDOWED_SNAPSHOT) });
-      yield* harness.awaitState((value) => Option.isSome(value.page));
-
-      requestOlderThreadTurns(TARGET.environmentId, THREAD_ID);
-      yield* harness.awaitState((value) =>
-        Option.match(value.page, { onNone: () => false, onSome: (page) => page.loadingOlder }),
-      );
-      yield* Queue.offer(harness.inputs, {
-        kind: "snapshot",
-        snapshot: {
-          snapshotSequence: 20,
-          thread: { ...BASE_THREAD, title: "Replaced thread" },
-          page: { beforeCursor: "cursor-2", hasMore: true, snapshotSequence: 20 },
-        },
-      });
-      yield* harness.awaitState((value) =>
-        Option.match(value.data, {
-          onNone: () => false,
-          onSome: (thread) => thread.title === "Replaced thread",
-        }),
-      );
-      yield* harness.resolveNextPage(Option.some(OLDER_PAGE));
-
-      const state = yield* harness.awaitState((value) =>
-        Option.match(value.page, { onNone: () => false, onSome: (page) => !page.loadingOlder }),
-      );
-      expect(hasMessage(state, "message-old")).toBe(false);
-      // The replacement snapshot's cursor wins over the discarded page's.
-      expect(Option.getOrThrow(state.page).beforeCursor).toBe("cursor-2");
-    }),
-  );
-
-  it.effect("discards an older page read from a projection behind the loaded state", () =>
-    Effect.gen(function* () {
-      const harness = yield* makeHarness({ initialResponse: Option.some(WINDOWED_SNAPSHOT) });
-      yield* harness.awaitState((value) => Option.isSome(value.page));
-
-      requestOlderThreadTurns(TARGET.environmentId, THREAD_ID);
-      yield* harness.awaitState((value) =>
-        Option.match(value.page, { onNone: () => false, onSome: (page) => page.loadingOlder }),
-      );
-      yield* harness.resolveNextPage(Option.some({ ...OLDER_PAGE, snapshotSequence: 5 }));
-
-      const state = yield* harness.awaitState((value) =>
-        Option.match(value.page, { onNone: () => false, onSome: (page) => !page.loadingOlder }),
-      );
-      expect(hasMessage(state, "message-old")).toBe(false);
-      expect(Option.getOrThrow(state.page).beforeCursor).toBe("cursor-1");
-    }),
-  );
-
-  it.effect("a merged history page never advances the live-event dedupe sequence", () =>
-    Effect.gen(function* () {
-      const harness = yield* makeHarness({ initialResponse: Option.some(WINDOWED_SNAPSHOT) });
-      yield* harness.awaitState((value) => Option.isSome(value.page));
-
-      requestOlderThreadTurns(TARGET.environmentId, THREAD_ID);
-      yield* harness.awaitState((value) =>
-        Option.match(value.page, { onNone: () => false, onSome: (page) => page.loadingOlder }),
-      );
-      // The page was captured at a newer projection sequence (12) than the
-      // loaded state (10); merging it must not swallow events 11-12.
-      yield* harness.resolveNextPage(
-        Option.some({
-          ...OLDER_PAGE,
-          snapshotSequence: 12,
-          page: { beforeCursor: null, hasMore: false, snapshotSequence: 12 },
-        }),
-      );
-      yield* harness.awaitState((value) => hasMessage(value, "message-old"));
-
-      // Event at sequence 11 must still apply after the merge: the revert
-      // discards turn-2, so the loaded window's row disappears while the
-      // merged older turn-1 row survives. If the merge had advanced the
-      // dedupe sequence to the page's 12, this event would be swallowed.
-      yield* Queue.offer(harness.inputs, revertEvent(11));
-      const state = yield* harness.awaitState(
-        (value) => !hasMessage(value, "message-recent") && hasMessage(value, "message-old"),
-      );
-      expect(hasMessage(state, "message-old")).toBe(true);
-    }),
-  );
-
-  it.effect("parks a page read ahead of the live state until events catch up", () =>
-    Effect.gen(function* () {
-      // A page whose thread watermark is ahead of the loaded state may
-      // contain streaming content the subscription has not delivered yet
-      // (e.g. an out-of-window subagent turn mid-stream); merging it
-      // immediately and then replaying those deltas would duplicate text.
-      // The page parks until the live state reaches the watermark.
-      const harness = yield* makeHarness({ initialResponse: Option.some(WINDOWED_SNAPSHOT) });
-      yield* harness.awaitState((value) => Option.isSome(value.page));
-
-      requestOlderThreadTurns(TARGET.environmentId, THREAD_ID);
-      yield* harness.awaitState((value) =>
-        Option.match(value.page, { onNone: () => false, onSome: (page) => page.loadingOlder }),
-      );
-      // Page watermark 11 > loaded sequence 10: must park, not merge.
-      yield* harness.resolveNextPage(
-        Option.some({
-          ...OLDER_PAGE,
-          snapshotSequence: 11,
-          page: { beforeCursor: null, hasMore: false, snapshotSequence: 11, threadSequence: 11 },
-        }),
-      );
-
-      // A live event at sequence 11 arrives; only then does the page merge.
-      yield* Queue.offer(harness.inputs, titleEvent("Advanced past watermark", 11));
-      const state = yield* harness.awaitState((value) => hasMessage(value, "message-old"));
-      expect(hasMessage(state, "message-recent")).toBe(true);
-      expect(Option.getOrThrow(state.page).loadingOlder).toBe(false);
-    }),
-  );
-
-  it.effect("a revert keeps the page cursor and triggers no refresh fetch", () =>
-    Effect.gen(function* () {
-      // Cursors are an (anchor, turnId) keyset derived from event content, so
-      // they survive the revert projector's row rewrite: the machine keeps
-      // the stored cursor and performs no snapshot re-fetch. The revert
-      // reducer's turn filtering alone handles loaded history.
-      const harness = yield* makeHarness({ initialResponse: Option.some(WINDOWED_SNAPSHOT) });
-      yield* harness.awaitState((value) => Option.isSome(value.page));
-
-      yield* Queue.offer(harness.inputs, revertEvent(11));
-      const state = yield* harness.awaitState((value) => !hasMessage(value, "message-recent"));
-
-      expect(Option.getOrThrow(state.page).beforeCursor).toBe("cursor-1");
-      const windows = yield* Ref.get(harness.loaderWindows);
-      // Only the initial load hit the loader — no post-revert refresh fetch.
-      expect(windows.length).toBe(1);
-    }),
-  );
-
-  it.effect("drops a windowed cache when the server lacks the pagination capability", () =>
-    Effect.gen(function* () {
-      // Resuming a windowed cache via afterSequence against a pre-pagination
-      // server would render only the window forever with no way to load the
-      // rest: the machine must discard the cache and take a full snapshot.
-      const fullSnapshot: OrchestrationThreadDetailSnapshot = {
-        snapshotSequence: 20,
-        thread: { ...BASE_THREAD, title: "Full reload" },
-      };
-      const harness = yield* makeHarness({
-        paginationCapability: false,
-        cached: WINDOWED_SNAPSHOT,
-        initialResponse: Option.some(fullSnapshot),
-      });
-
-      const state = yield* harness.awaitState((value) =>
-        Option.match(value.data, {
-          onNone: () => false,
-          onSome: (thread) => thread.title === "Full reload",
-        }),
-      );
-      expect(Option.isNone(state.page)).toBe(true);
-      // The subscription resumed from the fresh full snapshot, not the
-      // discarded windowed cache's watermark, and sent no window fields.
-      const subscribeInput = yield* Ref.get(harness.lastSubscribeInput);
-      expect(subscribeInput?.turnLimit).toBeUndefined();
-      expect(subscribeInput?.afterSequence).toBe(20);
-    }),
-  );
-
-  it.effect("keeps a windowed cache when the server supports pagination", () =>
-    Effect.gen(function* () {
-      const harness = yield* makeHarness({ cached: WINDOWED_SNAPSHOT });
-      const state = yield* harness.awaitState((value) => Option.isSome(value.page));
-      expect(Option.getOrThrow(state.page).beforeCursor).toBe("cursor-1");
-      // Wait for the subscription (recorded when the WS method is invoked)
-      // before asserting its input.
-      const subscribeInput = yield* Ref.get(harness.lastSubscribeInput).pipe(
-        Effect.repeat({ until: (input) => input !== undefined }),
-      );
-      expect(subscribeInput?.afterSequence).toBe(10);
-    }),
-  );
-});
diff --git a/packages/client-runtime/src/state/threads-sync.test.ts b/packages/client-runtime/src/state/threads-sync.test.ts
index c2df434e8e77..fcb7edc4b6da 100644
--- a/packages/client-runtime/src/state/threads-sync.test.ts
+++ b/packages/client-runtime/src/state/threads-sync.test.ts
@@ -1,16 +1,16 @@
 import {
   EnvironmentId,
   EventId,
-  ORCHESTRATION_WS_METHODS,
-  ProjectId,
-  ProviderInstanceId,
+  ORCHESTRATION_V2_WS_METHODS,
   ThreadId,
-  TurnId,
-  type OrchestrationThread,
-  type OrchestrationThreadDetailSnapshot,
-  type OrchestrationThreadStreamItem,
+  TurnItemId,
+  type OrchestrationV2ThreadDetailSnapshot,
+  type OrchestrationV2ThreadProjection,
+  type OrchestrationV2ThreadStreamItem,
+  type OrchestrationV2TurnItem,
 } from "@t3tools/contracts";
 import { describe, expect, it } from "@effect/vitest";
+import * as DateTime from "effect/DateTime";
 import * as Effect from "effect/Effect";
 import * as Option from "effect/Option";
 import * as Queue from "effect/Queue";
@@ -30,11 +30,13 @@ import * as ConnectionWakeups from "../connection/wakeups.ts";
 import * as EnvironmentSupervisor from "../connection/supervisor.ts";
 import * as Persistence from "../platform/persistence.ts";
 import * as RpcSession from "../rpc/session.ts";
+import { v2Projection, v2ThreadId } from "./orchestrationV2TestFixtures.ts";
 import {
   EMPTY_ENVIRONMENT_THREAD_STATE,
   makeEnvironmentThreadState,
   ThreadSnapshotLoader,
   type EnvironmentThreadState,
+  type ThreadSnapshotLoadResult,
 } from "./threads.ts";
 
 const TARGET = new PrimaryConnectionTarget({
@@ -43,7 +45,7 @@ const TARGET = new PrimaryConnectionTarget({
   httpBaseUrl: "https://environment.example.test",
   wsBaseUrl: "wss://environment.example.test",
 });
-const THREAD_ID = ThreadId.make("thread-1");
+const THREAD_ID = v2ThreadId;
 const CACHED_SNAPSHOT_SEQUENCE = 7;
 const PREPARED: PreparedConnection = {
   environmentId: TARGET.environmentId,
@@ -53,65 +55,22 @@ const PREPARED: PreparedConnection = {
   httpAuthorization: null,
   target: TARGET,
 };
-const BASE_THREAD: OrchestrationThread = {
-  id: THREAD_ID,
-  projectId: ProjectId.make("project-1"),
-  title: "Cached thread",
-  modelSelection: {
-    instanceId: ProviderInstanceId.make("codex"),
-    model: "gpt-5.4",
-  },
-  runtimeMode: "full-access",
-  interactionMode: "default",
-  branch: "main",
-  worktreePath: null,
-  latestTurn: null,
-  createdAt: "2026-04-01T00:00:00.000Z",
-  updatedAt: "2026-04-01T00:00:00.000Z",
-  archivedAt: null,
-  settledOverride: null,
-  settledAt: null,
-  deletedAt: null,
-  messages: [],
-  proposedPlans: [],
-  activities: [],
-  checkpoints: [],
-  session: null,
-};
-const ACTIVE_THREAD: OrchestrationThread = {
-  ...BASE_THREAD,
-  latestTurn: {
-    turnId: TurnId.make("turn-1"),
-    state: "running",
-    requestedAt: "2026-04-01T00:01:00.000Z",
-    startedAt: "2026-04-01T00:01:00.000Z",
-    completedAt: null,
-    assistantMessageId: null,
-  },
-  session: {
-    threadId: THREAD_ID,
-    status: "running",
-    providerName: "codex",
-    runtimeMode: "full-access",
-    activeTurnId: TurnId.make("turn-1"),
-    lastError: null,
-    updatedAt: "2026-04-01T00:01:00.000Z",
-  },
+const BASE_PROJECTION: OrchestrationV2ThreadProjection = {
+  ...v2Projection,
+  thread: { ...v2Projection.thread, title: "Cached thread" },
 };
 
-type TestThreadInput = OrchestrationThreadStreamItem | Error;
+type TestThreadInput = OrchestrationV2ThreadStreamItem | Error;
 
 function testSession(
   client: WsRpcProtocolClient,
-  options?: { readonly completionMarker?: boolean },
+  config?: { readonly completionMarker?: boolean },
 ): RpcSession.RpcSession {
   return {
     client,
-    initialConfig: Effect.succeed(
-      options?.completionMarker === true
-        ? ({ threadResumeCompletionMarker: true } as never)
-        : ({} as never),
-    ),
+    initialConfig: Effect.succeed({
+      threadResumeCompletionMarker: config?.completionMarker === true,
+    } as never),
     ready: Effect.void,
     probe: Effect.void,
     closed: Effect.never,
@@ -130,8 +89,13 @@ function awaitThreadState(
 }
 
 const makeHarness = Effect.fn("TestEnvironmentThreads.makeHarness")(function* (options?: {
-  readonly cached?: OrchestrationThread;
-  readonly httpSnapshot?: Option.Option<OrchestrationThreadDetailSnapshot>;
+  readonly cached?: OrchestrationV2ThreadProjection;
+  readonly cachedHistory?: {
+    readonly historyCursor: string | null;
+    readonly hasMoreHistory: boolean;
+    readonly latestLocalTurnOrdinal?: number | null;
+  };
+  readonly httpSnapshot?: ThreadSnapshotLoadResult;
   readonly completionMarker?: boolean;
 }) {
   const inputs = yield* Queue.unbounded<TestThreadInput>();
@@ -141,10 +105,10 @@ const makeHarness = Effect.fn("TestEnvironmentThreads.makeHarness")(function* (o
   const subscriptionCount = yield* Ref.make(0);
   const loaderCalls = yield* Ref.make(0);
   const lastSubscribeAfterSequence = yield* Ref.make<number | undefined>(undefined);
-  const lastRequestCompletionMarker = yield* Ref.make<boolean | undefined>(undefined);
-  const savedThreads = yield* Ref.make<ReadonlyArray<OrchestrationThreadDetailSnapshot>>([]);
-  const removedThreads = yield* Ref.make<ReadonlyArray<ThreadId>>([]);
+  const lastRequestCompletionMarker = yield* Ref.make(false);
   const wakeups = yield* Queue.unbounded<ConnectionWakeups.ConnectionWakeup>();
+  const savedThreads = yield* Ref.make<ReadonlyArray<OrchestrationV2ThreadDetailSnapshot>>([]);
+  const removedThreads = yield* Ref.make<ReadonlyArray<ThreadId>>([]);
   const supervisorState = yield* SubscriptionRef.make<SupervisorConnectionState>(
     AVAILABLE_CONNECTION_STATE,
   );
@@ -155,25 +119,22 @@ const makeHarness = Effect.fn("TestEnvironmentThreads.makeHarness")(function* (o
       ),
     );
   const client = {
-    [ORCHESTRATION_WS_METHODS.subscribeThread]: (input: {
+    [ORCHESTRATION_V2_WS_METHODS.subscribeThread]: (input: {
       readonly afterSequence?: number;
-      readonly requestCompletionMarker?: boolean;
+      readonly requestCompletionMarker?: true;
     }) =>
       Stream.unwrap(
         Ref.updateAndGet(subscriptionCount, (count) => count + 1).pipe(
           Effect.andThen(Ref.set(lastSubscribeAfterSequence, input.afterSequence)),
-          Effect.andThen(Ref.set(lastRequestCompletionMarker, input.requestCompletionMarker)),
+          Effect.andThen(
+            Ref.set(lastRequestCompletionMarker, input.requestCompletionMarker === true),
+          ),
           Effect.as(streamFrom(inputs)),
         ),
       ),
   } as unknown as WsRpcProtocolClient;
   const supervisorSession = yield* SubscriptionRef.make<Option.Option<RpcSession.RpcSession>>(
-    Option.some(
-      testSession(
-        client,
-        options?.completionMarker === true ? { completionMarker: true } : undefined,
-      ),
-    ),
+    Option.some(testSession(client, options)),
   );
   const prepared = yield* SubscriptionRef.make<Option.Option<PreparedConnection>>(
     Option.some(PREPARED),
@@ -183,8 +144,9 @@ const makeHarness = Effect.fn("TestEnvironmentThreads.makeHarness")(function* (o
       Ref.update(loaderCalls, (count) => count + 1).pipe(
         Effect.as(
           threadId === THREAD_ID
-            ? (options?.httpSnapshot ?? Option.none<OrchestrationThreadDetailSnapshot>())
-            : Option.none<OrchestrationThreadDetailSnapshot>(),
+            ? (options?.httpSnapshot ??
+                ({ _tag: "unavailable" } satisfies ThreadSnapshotLoadResult))
+            : ({ _tag: "unavailable" } satisfies ThreadSnapshotLoadResult),
         ),
       ),
   });
@@ -205,12 +167,23 @@ const makeHarness = Effect.fn("TestEnvironmentThreads.makeHarness")(function* (o
         threadId === THREAD_ID && options?.cached !== undefined
           ? Option.some({
               snapshotSequence: CACHED_SNAPSHOT_SEQUENCE,
-              thread: options.cached,
+              projection: options.cached,
+              ...(options.cachedHistory === undefined
+                ? {}
+                : {
+                    historyCursor: options.cachedHistory.historyCursor,
+                    hasMoreHistory: options.cachedHistory.hasMoreHistory,
+                    ...(options.cachedHistory.latestLocalTurnOrdinal === undefined
+                      ? {}
+                      : {
+                          latestLocalTurnOrdinal: options.cachedHistory.latestLocalTurnOrdinal,
+                        }),
+                  }),
             })
           : Option.none(),
       ),
-    saveThread: (_environmentId, thread) =>
-      Ref.update(savedThreads, (current) => [...current, thread]),
+    saveThread: (_environmentId, snapshot) =>
+      Ref.update(savedThreads, (current) => [...current, snapshot]),
     removeThread: (_environmentId, threadId) =>
       Ref.update(removedThreads, (current) => [...current, threadId]),
     loadServerConfig: () => Effect.succeed(Option.none()),
@@ -253,81 +226,66 @@ const makeHarness = Effect.fn("TestEnvironmentThreads.makeHarness")(function* (o
     wakeups,
     replaceSession: SubscriptionRef.set(
       supervisorSession,
-      Option.some(
-        testSession(
-          client,
-          options?.completionMarker === true ? { completionMarker: true } : undefined,
-        ),
-      ),
+      Option.some(testSession(client, options)),
     ),
   };
 });
 
-const snapshot = (thread: OrchestrationThread): OrchestrationThreadStreamItem => ({
+const snapshot = (
+  projection: OrchestrationV2ThreadProjection,
+  snapshotSequence = 1,
+): OrchestrationV2ThreadStreamItem => ({
   kind: "snapshot",
-  snapshot: {
-    snapshotSequence: 1,
-    thread,
-  },
+  snapshotSequence,
+  projection,
 });
 
-const synchronized = (): OrchestrationThreadStreamItem => ({ kind: "synchronized" });
+const synchronized = (): OrchestrationV2ThreadStreamItem => ({ kind: "synchronized" });
 
-const titleUpdated = (title: string, sequence = 2): OrchestrationThreadStreamItem => ({
-  kind: "event",
-  event: {
-    eventId: EventId.make("event-title"),
+const titleUpdated = (title: string, sequence = 2): OrchestrationV2ThreadStreamItem => {
+  const occurredAt = DateTime.makeUnsafe("2026-06-20T01:00:00.000Z");
+  return {
+    kind: "event",
     sequence,
-    occurredAt: "2026-04-01T01:00:00.000Z",
-    commandId: null,
-    causationEventId: null,
-    correlationId: null,
-    metadata: {},
-    aggregateKind: "thread",
-    aggregateId: THREAD_ID,
-    type: "thread.meta-updated",
-    payload: {
+    event: {
+      id: EventId.make("event-title"),
+      type: "thread.metadata-updated",
       threadId: THREAD_ID,
-      title,
-      updatedAt: "2026-04-01T01:00:00.000Z",
+      occurredAt,
+      payload: { ...v2Projection.thread, title, updatedAt: occurredAt },
     },
-  },
-});
+  };
+};
 
-const deleted = (): OrchestrationThreadStreamItem => ({
-  kind: "event",
-  event: {
-    eventId: EventId.make("event-deleted"),
-    sequence: 3,
-    occurredAt: "2026-04-01T02:00:00.000Z",
-    commandId: null,
-    causationEventId: null,
-    correlationId: null,
-    metadata: {},
-    aggregateKind: "thread",
-    aggregateId: THREAD_ID,
-    type: "thread.deleted",
-    payload: {
+const deleted = (sequence = 3): OrchestrationV2ThreadStreamItem => {
+  const occurredAt = DateTime.makeUnsafe("2026-06-20T02:00:00.000Z");
+  return {
+    kind: "event",
+    sequence,
+    event: {
+      id: EventId.make("event-deleted"),
+      type: "thread.deleted",
       threadId: THREAD_ID,
-      deletedAt: "2026-04-01T02:00:00.000Z",
+      occurredAt,
+      payload: { ...v2Projection.thread, updatedAt: occurredAt, deletedAt: occurredAt },
     },
-  },
-});
+  };
+};
 
 describe("EnvironmentThreads", () => {
   it.effect("publishes cached data immediately from a warm cache", () =>
     Effect.gen(function* () {
-      const harness = yield* makeHarness({ cached: BASE_THREAD });
+      const harness = yield* makeHarness({ cached: BASE_PROJECTION });
       const state = yield* awaitThreadState(harness.observed, (value) => Option.isSome(value.data));
 
-      expect(Option.getOrThrow(state.data)).toEqual(BASE_THREAD);
+      expect(Option.getOrThrow(state.data)).toEqual(BASE_PROJECTION);
       expect(Option.isNone(state.error)).toBe(true);
     }),
   );
 
   it.effect("resumes a warm cache via afterSequence without an HTTP fetch", () =>
     Effect.gen(function* () {
-      const harness = yield* makeHarness({ cached: BASE_THREAD });
+      const harness = yield* makeHarness({ cached: BASE_PROJECTION });
 
       // The warm cache reaches live from the cached data, and a live event
       // applies on top of it.
@@ -337,7 +295,7 @@ describe("EnvironmentThreads", () => {
         (value) =>
           value.status === "live" &&
           Option.isSome(value.data) &&
-          value.data.value.title === "Live title",
+          value.data.value.thread.title === "Live title",
       );
 
       // The subscription resumed from the cached sequence and never fetched the
@@ -349,8 +307,8 @@ describe("EnvironmentThreads", () => {
 
   it.effect("reduces live events and persists the latest thread", () =>
     Effect.gen(function* () {
-      const harness = yield* makeHarness({ cached: BASE_THREAD });
-      yield* Queue.offer(harness.inputs, snapshot(BASE_THREAD));
+      const harness = yield* makeHarness({ cached: BASE_PROJECTION });
+      yield* Queue.offer(harness.inputs, snapshot(BASE_PROJECTION));
       yield* Queue.offer(harness.inputs, titleUpdated("Live title"));
 
       const state = yield* awaitThreadState(
@@ -358,47 +316,30 @@ describe("EnvironmentThreads", () => {
         (value) =>
           value.status === "live" &&
           Option.isSome(value.data) &&
-          value.data.value.title === "Live title",
+          value.data.value.thread.title === "Live title",
       );
       yield* TestClock.adjust("500 millis");
       yield* Effect.yieldNow;
 
-      expect(Option.getOrThrow(state.data).title).toBe("Live title");
-      expect((yield* Ref.get(harness.savedThreads)).at(-1)?.thread.title).toBe("Live title");
-      expect((yield* Ref.get(harness.savedThreads)).at(-1)?.snapshotSequence).toBe(2);
-    }),
-  );
-
-  it.effect("does not persist active thread snapshots during streaming or teardown", () =>
-    Effect.gen(function* () {
-      const savedThreads = yield* Effect.scoped(
-        Effect.gen(function* () {
-          const harness = yield* makeHarness({ cached: ACTIVE_THREAD });
-          yield* awaitThreadState(
-            harness.observed,
-            (value) =>
-              value.status === "live" &&
-              Option.isSome(value.data) &&
-              value.data.value.session?.status === "running",
-          );
-
-          yield* TestClock.adjust("500 millis");
-          yield* Effect.yieldNow;
-
-          expect(yield* Ref.get(harness.savedThreads)).toEqual([]);
-          return harness.savedThreads;
-        }),
+      expect(Option.getOrThrow(state.data).thread.title).toBe("Live title");
+      expect((yield* Ref.get(harness.savedThreads)).at(-1)?.projection.thread.title).toBe(
+        "Live title",
       );
-
-      expect(yield* Ref.get(savedThreads)).toEqual([]);
+      expect((yield* Ref.get(harness.savedThreads)).at(-1)?.snapshotSequence).toBe(2);
     }),
   );
 
   it.effect("seeds the thread from the HTTP snapshot and resumes live events", () =>
     Effect.gen(function* () {
-      const httpThread: OrchestrationThread = { ...BASE_THREAD, title: "HTTP title" };
+      const httpProjection: OrchestrationV2ThreadProjection = {
+        ...BASE_PROJECTION,
+        thread: { ...BASE_PROJECTION.thread, title: "HTTP title" },
+      };
       const harness = yield* makeHarness({
-        httpSnapshot: Option.some({ snapshotSequence: 1, thread: httpThread }),
+        httpSnapshot: {
+          _tag: "present",
+          snapshot: { snapshotSequence: 1, projection: httpProjection },
+        },
       });
       // No socket snapshot is pushed; only a live event arrives over the socket.
       // It can only be applied if the HTTP snapshot already seeded the thread.
@@ -409,10 +350,10 @@ describe("EnvironmentThreads", () => {
         (value) =>
           value.status === "live" &&
           Option.isSome(value.data) &&
-          value.data.value.title === "Live title",
+          value.data.value.thread.title === "Live title",
       );
 
-      expect(Option.getOrThrow(state.data).title).toBe("Live title");
+      expect(Option.getOrThrow(state.data).thread.title).toBe("Live title");
       // Cold cache: the full snapshot was loaded over HTTP and the socket
       // resumed from that snapshot's sequence.
       expect(yield* Ref.get(harness.loaderCalls)).toBeGreaterThanOrEqual(1);
@@ -420,81 +361,626 @@ describe("EnvironmentThreads", () => {
     }),
   );
 
-  it.effect("ignores replayed thread events at or below the snapshot sequence", () =>
+  it.effect("installs bounded snapshot history meta and resumes via afterSequence", () =>
     Effect.gen(function* () {
-      const harness = yield* makeHarness({ cached: BASE_THREAD });
-      yield* Queue.offer(harness.inputs, snapshot(BASE_THREAD));
-      yield* Queue.offer(harness.inputs, titleUpdated("Replayed title", 1));
-      yield* Queue.offer(harness.inputs, titleUpdated("Live title", 2));
+      const httpProjection: OrchestrationV2ThreadProjection = {
+        ...BASE_PROJECTION,
+        thread: { ...BASE_PROJECTION.thread, title: "Bounded title" },
+      };
+      const harness = yield* makeHarness({
+        httpSnapshot: {
+          _tag: "present",
+          snapshot: { snapshotSequence: 11, projection: httpProjection },
+          history: {
+            historyCursor: "opaque-cursor",
+            hasMoreHistory: true,
+          },
+        },
+      });
+      yield* Queue.offer(harness.inputs, titleUpdated("Live after bounded", 12));
 
       const state = yield* awaitThreadState(
         harness.observed,
         (value) =>
           value.status === "live" &&
           Option.isSome(value.data) &&
-          value.data.value.title === "Live title",
+          value.data.value.thread.title === "Live after bounded" &&
+          value.history.hasMoreHistory,
       );
 
-      expect(Option.getOrThrow(state.data).title).toBe("Live title");
+      expect(state.history).toMatchObject({
+        historyCursor: "opaque-cursor",
+        hasMoreHistory: true,
+        loading: false,
+        error: null,
+        expanded: false,
+      });
+      expect(yield* Ref.get(harness.lastSubscribeAfterSequence)).toBe(11);
+      // Bounded HTTP success must not require a socket snapshot frame.
+      expect(Option.getOrThrow(state.data).thread.title).toBe("Live after bounded");
     }),
   );
 
-  it.effect("removes cached data when the thread is deleted", () =>
+  it.effect("persists progressive history meta with a settled bounded snapshot", () =>
     Effect.gen(function* () {
-      const harness = yield* makeHarness({ cached: BASE_THREAD });
-      yield* Queue.offer(harness.inputs, snapshot(BASE_THREAD));
-      yield* Queue.offer(harness.inputs, deleted());
+      const httpProjection: OrchestrationV2ThreadProjection = {
+        ...BASE_PROJECTION,
+        thread: { ...BASE_PROJECTION.thread, title: "Bounded cache title" },
+      };
+      const harness = yield* makeHarness({
+        httpSnapshot: {
+          _tag: "present",
+          snapshot: { snapshotSequence: 4, projection: httpProjection },
+          history: {
+            historyCursor: "cursor-oldest",
+            hasMoreHistory: true,
+          },
+        },
+      });
+      // Bounded install alone (settled) must enqueue progressive meta with the
+      // projection. Never persist the partial window as a complete full snapshot.
+      yield* awaitThreadState(
+        harness.observed,
+        (value) =>
+          Option.isSome(value.data) &&
+          value.data.value.thread.title === "Bounded cache title" &&
+          value.history.historyCursor === "cursor-oldest",
+      );
+      yield* TestClock.adjust("500 millis");
+      yield* Effect.yieldNow;
+
+      const savedAll = yield* Ref.get(harness.savedThreads);
+      expect(savedAll.length).toBeGreaterThanOrEqual(1);
+      const first = savedAll[0];
+      expect(first?.snapshotSequence).toBe(4);
+      expect(first?.projection.thread.title).toBe("Bounded cache title");
+      expect(first?.historyCursor).toBe("cursor-oldest");
+      expect(first?.hasMoreHistory).toBe(true);
+      // No earlier complete-looking entry without progressive meta.
+      expect(
+        savedAll.some(
+          (entry) =>
+            entry.projection.thread.title === "Bounded cache title" &&
+            entry.historyCursor === undefined &&
+            entry.hasMoreHistory === undefined,
+        ),
+      ).toBe(false);
 
+      // A later live update still carries the progressive cursor.
+      yield* Queue.offer(harness.inputs, titleUpdated("Settled bounded", 5));
+      yield* awaitThreadState(
+        harness.observed,
+        (value) =>
+          value.status === "live" &&
+          Option.isSome(value.data) &&
+          value.data.value.thread.title === "Settled bounded",
+      );
+      yield* TestClock.adjust("500 millis");
+      yield* Effect.yieldNow;
+
+      const saved = (yield* Ref.get(harness.savedThreads)).at(-1);
+      expect(saved?.snapshotSequence).toBe(5);
+      expect(saved?.projection.thread.title).toBe("Settled bounded");
+      expect(saved?.historyCursor).toBe("cursor-oldest");
+      expect(saved?.hasMoreHistory).toBe(true);
+    }),
+  );
+
+  it.effect("warm resume restores progressive history meta and skips HTTP", () =>
+    Effect.gen(function* () {
+      const harness = yield* makeHarness({
+        cached: {
+          ...BASE_PROJECTION,
+          thread: { ...BASE_PROJECTION.thread, title: "Cached bounded" },
+        },
+        cachedHistory: {
+          historyCursor: "warm-cursor",
+          hasMoreHistory: true,
+        },
+      });
+
+      // Apply a live event so the subscription is known to have resumed from cache.
+      yield* Queue.offer(
+        harness.inputs,
+        titleUpdated("Cached bounded live", CACHED_SNAPSHOT_SEQUENCE + 1),
+      );
       const state = yield* awaitThreadState(
         harness.observed,
-        (value) => value.status === "deleted",
+        (value) =>
+          value.status === "live" &&
+          Option.isSome(value.data) &&
+          value.data.value.thread.title === "Cached bounded live" &&
+          value.history.hasMoreHistory,
       );
 
-      expect(Option.isNone(state.data)).toBe(true);
-      expect(yield* Ref.get(harness.removedThreads)).toEqual([THREAD_ID]);
+      expect(state.history).toMatchObject({
+        historyCursor: "warm-cursor",
+        hasMoreHistory: true,
+        expanded: false,
+      });
+      // Warm progressive cache must not re-download; resume via afterSequence.
+      expect(yield* Ref.get(harness.loaderCalls)).toBe(0);
+      expect(yield* Ref.get(harness.lastSubscribeAfterSequence)).toBe(CACHED_SNAPSHOT_SEQUENCE);
     }),
   );
 
-  it.effect("does not resurrect a deleted thread when the app returns to the foreground", () =>
+  it.effect("legacy warm cache without history meta stays complete (no false load-earlier)", () =>
+    Effect.gen(function* () {
+      const harness = yield* makeHarness({ cached: BASE_PROJECTION });
+      const state = yield* awaitThreadState(harness.observed, (value) => Option.isSome(value.data));
+      expect(state.history).toMatchObject({
+        historyCursor: null,
+        hasMoreHistory: false,
+        expanded: false,
+      });
+      expect(yield* Ref.get(harness.loaderCalls)).toBe(0);
+    }),
+  );
+
+  it.effect("socket snapshot clears progressive history meta left from a bounded window", () =>
     Effect.gen(function* () {
       const harness = yield* makeHarness({
-        cached: BASE_THREAD,
-        completionMarker: true,
-        httpSnapshot: Option.some({
-          snapshotSequence: 4,
-          thread: { ...BASE_THREAD, title: "Stale HTTP thread" },
-        }),
+        cached: {
+          ...BASE_PROJECTION,
+          thread: { ...BASE_PROJECTION.thread, title: "Warm progressive" },
+        },
+        cachedHistory: {
+          historyCursor: "stale-cursor",
+          hasMoreHistory: true,
+        },
       });
-      yield* Queue.offer(harness.inputs, snapshot(BASE_THREAD));
-      yield* Queue.offer(harness.inputs, deleted());
-      yield* awaitThreadState(harness.observed, (value) => value.status === "deleted");
 
+      yield* Queue.offer(
+        harness.inputs,
+        snapshot(
+          {
+            ...BASE_PROJECTION,
+            thread: { ...BASE_PROJECTION.thread, title: "Full socket snapshot" },
+          },
+          CACHED_SNAPSHOT_SEQUENCE + 1,
+        ),
+      );
+
+      const state = yield* awaitThreadState(
+        harness.observed,
+        (value) =>
+          value.status === "live" &&
+          Option.isSome(value.data) &&
+          value.data.value.thread.title === "Full socket snapshot" &&
+          value.history.historyCursor === null &&
+          value.history.hasMoreHistory === false,
+      );
+
+      expect(state.history).toMatchObject({
+        historyCursor: null,
+        hasMoreHistory: false,
+        expanded: false,
+        loading: false,
+        error: null,
+      });
+
+      // Settled full snapshot persistence must not keep the stale cursor.
+      yield* TestClock.adjust("500 millis");
+      yield* Effect.yieldNow;
+      const saved = (yield* Ref.get(harness.savedThreads)).at(-1);
+      expect(saved?.projection.thread.title).toBe("Full socket snapshot");
+      expect(saved?.historyCursor).toBeUndefined();
+      expect(saved?.hasMoreHistory).toBeUndefined();
+    }),
+  );
+
+  it.effect("live events preserve progressive history meta under atomic setThread", () =>
+    Effect.gen(function* () {
+      const harness = yield* makeHarness({
+        httpSnapshot: {
+          _tag: "present",
+          snapshot: {
+            snapshotSequence: 8,
+            projection: {
+              ...BASE_PROJECTION,
+              thread: { ...BASE_PROJECTION.thread, title: "Bounded seed" },
+            },
+          },
+          history: {
+            historyCursor: "keep-me",
+            hasMoreHistory: true,
+          },
+        },
+      });
+
+      yield* Queue.offer(harness.inputs, titleUpdated("Live preserves meta", 9));
+      const state = yield* awaitThreadState(
+        harness.observed,
+        (value) =>
+          value.status === "live" &&
+          Option.isSome(value.data) &&
+          value.data.value.thread.title === "Live preserves meta",
+      );
+
+      expect(state.history).toMatchObject({
+        historyCursor: "keep-me",
+        hasMoreHistory: true,
+        expanded: false,
+      });
+    }),
+  );
+
+  it.effect("bounded HTTP install sets projection and progressive meta atomically", () =>
+    Effect.gen(function* () {
+      // One setThread with explicit history (not applyItem reset + later meta).
+      const harness = yield* makeHarness({
+        httpSnapshot: {
+          _tag: "present",
+          snapshot: {
+            snapshotSequence: 2,
+            projection: {
+              ...BASE_PROJECTION,
+              thread: { ...BASE_PROJECTION.thread, title: "Bounded atomic install" },
+            },
+          },
+          history: {
+            historyCursor: "post-install-cursor",
+            hasMoreHistory: true,
+          },
+        },
+      });
+
+      const state = yield* awaitThreadState(
+        harness.observed,
+        (value) =>
+          Option.isSome(value.data) &&
+          value.data.value.thread.title === "Bounded atomic install" &&
+          value.history.historyCursor === "post-install-cursor" &&
+          value.history.hasMoreHistory === true,
+      );
+
+      expect(state.history).toMatchObject({
+        historyCursor: "post-install-cursor",
+        hasMoreHistory: true,
+        loading: false,
+        error: null,
+        expanded: false,
+      });
+      expect(yield* Ref.get(harness.lastSubscribeAfterSequence)).toBe(2);
+    }),
+  );
+
+  it.effect("dropped partial-timeline turn item is a true applyItem no-op", () =>
+    Effect.gen(function* () {
+      const recent = {
+        id: TurnItemId.make("item-window"),
+        threadId: THREAD_ID,
+        runId: null,
+        nodeId: null,
+        providerThreadId: null,
+        providerTurnId: null,
+        nativeItemRef: null,
+        parentItemId: null,
+        ordinal: 10,
+        status: "completed" as const,
+        title: null,
+        startedAt: DateTime.makeUnsafe("2026-06-20T00:00:00.000Z"),
+        completedAt: DateTime.makeUnsafe("2026-06-20T00:00:00.000Z"),
+        updatedAt: DateTime.makeUnsafe("2026-06-20T00:00:00.000Z"),
+        type: "command_execution" as const,
+        input: "pwd",
+        output: "ok",
+        exitCode: 0,
+      } satisfies OrchestrationV2TurnItem;
+      const recentRow = {
+        position: 0,
+        visibility: "local" as const,
+        sourceThreadId: THREAD_ID,
+        sourceItemId: recent.id,
+        item: recent,
+      };
+      const boundedProjection: OrchestrationV2ThreadProjection = {
+        ...BASE_PROJECTION,
+        thread: { ...BASE_PROJECTION.thread, title: "Partial noop" },
+        turnItems: [recent],
+        visibleTurnItems: [recentRow],
+      };
+      const harness = yield* makeHarness({
+        httpSnapshot: {
+          _tag: "present",
+          snapshot: {
+            snapshotSequence: 5,
+            projection: boundedProjection,
+            latestLocalTurnOrdinal: 10,
+          },
+          history: {
+            historyCursor: "partial-cursor",
+            hasMoreHistory: true,
+            latestLocalTurnOrdinal: 10,
+          },
+        },
+      });
+
+      const seeded = yield* awaitThreadState(
+        harness.observed,
+        (value) =>
+          value.status === "live" &&
+          Option.isSome(value.data) &&
+          value.data.value.thread.title === "Partial noop" &&
+          value.history.historyCursor === "partial-cursor",
+      );
+      const seededProjection = Option.getOrThrow(seeded.data);
+      yield* TestClock.adjust("500 millis");
+      yield* Effect.yieldNow;
+      const savedBefore = (yield* Ref.get(harness.savedThreads)).length;
+
+      const older = {
+        ...recent,
+        id: TurnItemId.make("item-old-outside"),
+        ordinal: 3,
+        output: "must-not-append",
+      } satisfies OrchestrationV2TurnItem;
+      yield* Queue.offer(harness.inputs, {
+        kind: "event",
+        sequence: 6,
+        event: {
+          id: EventId.make("event-old-partial"),
+          type: "turn-item.updated",
+          threadId: THREAD_ID,
+          occurredAt: DateTime.makeUnsafe("2026-06-20T01:00:00.000Z"),
+          payload: older,
+        },
+      });
+
+      // Allow the event to be processed without requiring a state transition.
+      for (let attempt = 0; attempt < 30; attempt += 1) {
+        yield* Effect.yieldNow;
+      }
+      // Drive a later unrelated title update so we know the stream continued.
+      yield* Queue.offer(harness.inputs, titleUpdated("After dropped event", 7));
+      const after = yield* awaitThreadState(
+        harness.observed,
+        (value) =>
+          value.status === "live" &&
+          Option.isSome(value.data) &&
+          value.data.value.thread.title === "After dropped event",
+      );
+
+      // The dropped event must not have appended the old item.
+      expect(Option.getOrThrow(after.data).turnItems.map((item) => String(item.id))).toEqual([
+        String(recent.id),
+      ]);
+      // Watermark unchanged (only advanced on successful newer turn-item applies).
+      expect(after.history.latestLocalTurnOrdinal).toBe(10);
+      // No persistence enqueue from the dropped event itself.
+      const savedAfterDrop = (yield* Ref.get(harness.savedThreads)).length;
+      expect(savedAfterDrop).toBe(savedBefore);
+      // Seeded projection reference path: event path kept partial meta intact.
+      expect(after.history.historyCursor).toBe("partial-cursor");
+      expect(after.history.hasMoreHistory).toBe(true);
+      // Title event applied; drop itself did not clear progressive meta.
+      expect(seededProjection.turnItems.map((item) => String(item.id))).toEqual([
+        String(recent.id),
+      ]);
+    }),
+  );
+
+  it.effect("installs and advances latestLocalTurnOrdinal for partial progressive windows", () =>
+    Effect.gen(function* () {
+      const harness = yield* makeHarness({
+        httpSnapshot: {
+          _tag: "present",
+          snapshot: {
+            snapshotSequence: 3,
+            projection: {
+              ...BASE_PROJECTION,
+              thread: { ...BASE_PROJECTION.thread, title: "Watermark seed" },
+            },
+            latestLocalTurnOrdinal: 15,
+          },
+          history: {
+            historyCursor: "wm-cursor",
+            hasMoreHistory: true,
+            latestLocalTurnOrdinal: 15,
+          },
+        },
+      });
+
+      const seeded = yield* awaitThreadState(
+        harness.observed,
+        (value) =>
+          Option.isSome(value.data) &&
+          value.data.value.thread.title === "Watermark seed" &&
+          value.history.latestLocalTurnOrdinal === 15,
+      );
+      expect(seeded.history.latestLocalTurnOrdinal).toBe(15);
+
+      yield* TestClock.adjust("500 millis");
+      yield* Effect.yieldNow;
+      const savedSeed = (yield* Ref.get(harness.savedThreads)).at(-1);
+      expect(savedSeed?.latestLocalTurnOrdinal).toBe(15);
+
+      const newer = {
+        id: TurnItemId.make("item-newer-live"),
+        threadId: THREAD_ID,
+        runId: null,
+        nodeId: null,
+        providerThreadId: null,
+        providerTurnId: null,
+        nativeItemRef: null,
+        parentItemId: null,
+        ordinal: 22,
+        status: "completed" as const,
+        title: null,
+        startedAt: DateTime.makeUnsafe("2026-06-20T00:00:00.000Z"),
+        completedAt: DateTime.makeUnsafe("2026-06-20T00:00:00.000Z"),
+        updatedAt: DateTime.makeUnsafe("2026-06-20T00:00:00.000Z"),
+        type: "command_execution" as const,
+        input: "echo newer",
+        output: "newer",
+        exitCode: 0,
+      } satisfies OrchestrationV2TurnItem;
+
+      yield* Queue.offer(harness.inputs, {
+        kind: "event",
+        sequence: 4,
+        event: {
+          id: EventId.make("event-newer-item"),
+          type: "turn-item.updated",
+          threadId: THREAD_ID,
+          occurredAt: DateTime.makeUnsafe("2026-06-20T01:00:00.000Z"),
+          payload: newer,
+        },
+      });
+
+      const advanced = yield* awaitThreadState(
+        harness.observed,
+        (value) =>
+          value.status === "live" &&
+          Option.isSome(value.data) &&
+          value.history.latestLocalTurnOrdinal === 22 &&
+          value.data.value.turnItems.some((item) => String(item.id) === String(newer.id)),
+      );
+      expect(advanced.history.latestLocalTurnOrdinal).toBe(22);
+      expect(advanced.history.historyCursor).toBe("wm-cursor");
+    }),
+  );
+
+  it.effect("warm resume restores latestLocalTurnOrdinal from progressive cache", () =>
+    Effect.gen(function* () {
+      const harness = yield* makeHarness({
+        cached: {
+          ...BASE_PROJECTION,
+          thread: { ...BASE_PROJECTION.thread, title: "Warm watermark" },
+        },
+        cachedHistory: {
+          historyCursor: "warm-wm-cursor",
+          hasMoreHistory: true,
+          latestLocalTurnOrdinal: 33,
+        },
+      });
+
+      const state = yield* awaitThreadState(
+        harness.observed,
+        (value) =>
+          Option.isSome(value.data) &&
+          value.data.value.thread.title === "Warm watermark" &&
+          value.history.latestLocalTurnOrdinal === 33,
+      );
+      expect(state.history).toMatchObject({
+        historyCursor: "warm-wm-cursor",
+        hasMoreHistory: true,
+        latestLocalTurnOrdinal: 33,
+        expanded: false,
+      });
       expect(yield* Ref.get(harness.loaderCalls)).toBe(0);
+    }),
+  );
+
+  it.effect("marks a cold definitive HTTP miss deleted without socket subscribe or retry", () =>
+    Effect.gen(function* () {
+      const harness = yield* makeHarness({
+        httpSnapshot: { _tag: "missing" },
+      });
+
+      const state = yield* awaitThreadState(
+        harness.observed,
+        (value) => value.status === "deleted",
+      );
+
+      expect(Option.isNone(state.data)).toBe(true);
+      expect(Option.isNone(state.error)).toBe(true);
+      expect(yield* Ref.get(harness.loaderCalls)).toBeGreaterThanOrEqual(1);
+      expect(yield* Ref.get(harness.removedThreads)).toEqual([THREAD_ID]);
+      expect(yield* Ref.get(harness.subscriptionCount)).toBe(0);
+
+      // A definitive miss must not schedule the expected-failure retry path.
+      yield* TestClock.adjust("1 second");
+      for (let attempt = 0; attempt < 20; attempt += 1) {
+        yield* Effect.yieldNow;
+      }
+      yield* harness.replaceSession;
       yield* Queue.offer(harness.wakeups, "application-active");
-      for (let attempt = 0; attempt < 100; attempt += 1) {
-        if ((yield* Ref.get(harness.subscriptionCount)) >= 2) break;
+      for (let attempt = 0; attempt < 20; attempt += 1) {
         yield* Effect.yieldNow;
       }
+      expect(yield* Ref.get(harness.subscriptionCount)).toBe(0);
+      expect(yield* Ref.get(harness.retryCount)).toBe(0);
+      expect(yield* Ref.get(harness.loaderCalls)).toBe(1);
+      expect((yield* Ref.get(harness.latest)).status).toBe("deleted");
+    }),
+  );
 
-      const latest = yield* Ref.get(harness.latest);
-      expect(yield* Ref.get(harness.subscriptionCount)).toBe(2);
-      expect(yield* Ref.get(harness.loaderCalls)).toBe(0);
-      expect(latest.status).toBe("deleted");
-      expect(Option.isNone(latest.data)).toBe(true);
+  it.effect("falls back to the socket when the HTTP snapshot is only unavailable", () =>
+    Effect.gen(function* () {
+      const harness = yield* makeHarness({
+        httpSnapshot: { _tag: "unavailable" },
+      });
+
+      yield* Queue.offer(
+        harness.inputs,
+        snapshot({
+          ...BASE_PROJECTION,
+          thread: { ...BASE_PROJECTION.thread, title: "Socket title" },
+        }),
+      );
+
+      const state = yield* awaitThreadState(
+        harness.observed,
+        (value) =>
+          value.status === "live" &&
+          Option.isSome(value.data) &&
+          value.data.value.thread.title === "Socket title",
+      );
+
+      expect(Option.getOrThrow(state.data).thread.title).toBe("Socket title");
+      expect(yield* Ref.get(harness.loaderCalls)).toBeGreaterThanOrEqual(1);
+      expect(yield* Ref.get(harness.subscriptionCount)).toBe(1);
+      expect(yield* Ref.get(harness.removedThreads)).toEqual([]);
+    }),
+  );
+
+  it.effect("ignores replayed thread events at or below the snapshot sequence", () =>
+    Effect.gen(function* () {
+      const harness = yield* makeHarness({ cached: BASE_PROJECTION });
+      yield* Queue.offer(harness.inputs, snapshot(BASE_PROJECTION));
+      yield* Queue.offer(harness.inputs, titleUpdated("Replayed title", 1));
+      yield* Queue.offer(harness.inputs, titleUpdated("Live title", 2));
+
+      const state = yield* awaitThreadState(
+        harness.observed,
+        (value) =>
+          value.status === "live" &&
+          Option.isSome(value.data) &&
+          value.data.value.thread.title === "Live title",
+      );
+
+      expect(Option.getOrThrow(state.data).thread.title).toBe("Live title");
+    }),
+  );
+
+  it.effect("removes cached data when the thread is deleted", () =>
+    Effect.gen(function* () {
+      const harness = yield* makeHarness({ cached: BASE_PROJECTION });
+      yield* Queue.offer(harness.inputs, snapshot(BASE_PROJECTION));
+      yield* Queue.offer(harness.inputs, deleted());
+
+      const state = yield* awaitThreadState(
+        harness.observed,
+        (value) => value.status === "deleted",
+      );
+
+      expect(Option.isNone(state.data)).toBe(true);
+      expect(yield* Ref.get(harness.removedThreads)).toEqual([THREAD_ID]);
     }),
   );
 
   it.effect("preserves data after a domain failure and resumes on a replacement session", () =>
     Effect.gen(function* () {
-      const harness = yield* makeHarness({ cached: BASE_THREAD });
-      yield* Queue.offer(harness.inputs, snapshot(BASE_THREAD));
+      const harness = yield* makeHarness({ cached: BASE_PROJECTION });
+      yield* Queue.offer(harness.inputs, snapshot(BASE_PROJECTION));
       yield* Queue.offer(harness.inputs, new Error("stream failed"));
 
       const state = yield* awaitThreadState(harness.observed, (value) =>
         Option.isSome(value.error),
       );
 
-      expect(Option.getOrThrow(state.data)).toEqual(BASE_THREAD);
+      expect(Option.getOrThrow(state.data)).toEqual(BASE_PROJECTION);
       expect(Option.getOrThrow(state.error)).toBe("stream failed");
       expect(yield* Ref.get(harness.retryCount)).toBe(0);
 
@@ -508,8 +994,8 @@ describe("EnvironmentThreads", () => {
       yield* Queue.offer(
         harness.inputs,
         snapshot({
-          ...BASE_THREAD,
-          title: "Recovered thread",
+          ...BASE_PROJECTION,
+          thread: { ...BASE_PROJECTION.thread, title: "Recovered thread" },
         }),
       );
       const recovered = yield* awaitThreadState(
@@ -517,7 +1003,7 @@ describe("EnvironmentThreads", () => {
         (value) =>
           value.status === "live" &&
           Option.isSome(value.data) &&
-          value.data.value.title === "Recovered thread",
+          value.data.value.thread.title === "Recovered thread",
       );
 
       expect(Option.isNone(recovered.error)).toBe(true);
@@ -546,8 +1032,8 @@ describe("EnvironmentThreads", () => {
       yield* Queue.offer(
         harness.inputs,
         snapshot({
-          ...BASE_THREAD,
-          title: "Materialized thread",
+          ...BASE_PROJECTION,
+          thread: { ...BASE_PROJECTION.thread, title: "Materialized thread" },
         }),
       );
 
@@ -556,7 +1042,7 @@ describe("EnvironmentThreads", () => {
         (value) =>
           value.status === "live" &&
           Option.isSome(value.data) &&
-          value.data.value.title === "Materialized thread",
+          value.data.value.thread.title === "Materialized thread",
       );
 
       expect(Option.isNone(recovered.error)).toBe(true);
@@ -567,7 +1053,7 @@ describe("EnvironmentThreads", () => {
 
   it.effect("does not overwrite a live snapshot when the supervisor becomes ready", () =>
     Effect.gen(function* () {
-      const harness = yield* makeHarness({ cached: BASE_THREAD });
+      const harness = yield* makeHarness({ cached: BASE_PROJECTION });
       yield* SubscriptionRef.set(harness.supervisorState, {
         desired: true,
         network: "online",
@@ -578,7 +1064,7 @@ describe("EnvironmentThreads", () => {
         lastFailure: null,
         retryAt: null,
       });
-      yield* Queue.offer(harness.inputs, snapshot(BASE_THREAD));
+      yield* Queue.offer(harness.inputs, snapshot(BASE_PROJECTION));
       yield* awaitThreadState(harness.observed, (value) => value.status === "live");
 
       yield* SubscriptionRef.set(harness.supervisorState, {
@@ -601,7 +1087,7 @@ describe("EnvironmentThreads", () => {
 
   it.effect("keeps replayed updates synchronizing until the completion marker arrives", () =>
     Effect.gen(function* () {
-      const harness = yield* makeHarness({ cached: BASE_THREAD, completionMarker: true });
+      const harness = yield* makeHarness({ cached: BASE_PROJECTION, completionMarker: true });
       yield* awaitThreadState(
         harness.observed,
         (value) => value.status === "synchronizing" && Option.isSome(value.data),
@@ -617,7 +1103,7 @@ describe("EnvironmentThreads", () => {
         (value) =>
           value.status === "synchronizing" &&
           Option.isSome(value.data) &&
-          value.data.value.title === "Caught-up title",
+          value.data.value.thread.title === "Caught-up title",
       );
       expect(catchingUp.status).toBe("synchronizing");
 
@@ -626,13 +1112,13 @@ describe("EnvironmentThreads", () => {
         harness.observed,
         (value) => value.status === "live" && Option.isSome(value.data),
       );
-      expect(Option.getOrThrow(live.data).title).toBe("Caught-up title");
+      expect(Option.getOrThrow(live.data).thread.title).toBe("Caught-up title");
     }),
   );
 
   it.effect("resumes replacement sessions from the latest applied sequence", () =>
     Effect.gen(function* () {
-      const harness = yield* makeHarness({ cached: BASE_THREAD, completionMarker: true });
+      const harness = yield* makeHarness({ cached: BASE_PROJECTION, completionMarker: true });
       yield* Queue.offer(
         harness.inputs,
         titleUpdated("Latest title", CACHED_SNAPSHOT_SEQUENCE + 1),
@@ -643,7 +1129,7 @@ describe("EnvironmentThreads", () => {
         (value) =>
           value.status === "live" &&
           Option.isSome(value.data) &&
-          value.data.value.title === "Latest title",
+          value.data.value.thread.title === "Latest title",
       );
 
       yield* harness.replaceSession;
@@ -660,7 +1146,7 @@ describe("EnvironmentThreads", () => {
 
   it.effect("resubscribes on app foreground from the latest applied sequence", () =>
     Effect.gen(function* () {
-      const harness = yield* makeHarness({ cached: BASE_THREAD, completionMarker: true });
+      const harness = yield* makeHarness({ cached: BASE_PROJECTION, completionMarker: true });
       yield* Queue.offer(
         harness.inputs,
         titleUpdated("Latest title", CACHED_SNAPSHOT_SEQUENCE + 1),
@@ -671,7 +1157,7 @@ describe("EnvironmentThreads", () => {
         (value) =>
           value.status === "live" &&
           Option.isSome(value.data) &&
-          value.data.value.title === "Latest title",
+          value.data.value.thread.title === "Latest title",
       );
 
       yield* Queue.offer(harness.wakeups, "application-active");
@@ -695,7 +1181,7 @@ describe("EnvironmentThreads", () => {
         harness.observed,
         (value) => value.status === "live" && Option.isSome(value.data),
       );
-      expect(Option.getOrThrow(live.data).title).toBe("Latest title");
+      expect(Option.getOrThrow(live.data).thread.title).toBe("Latest title");
 
       yield* Queue.offer(harness.wakeups, "application-active-probe");
       for (let attempt = 0; attempt < 100; attempt += 1) {
diff --git a/packages/client-runtime/src/state/threads.ts b/packages/client-runtime/src/state/threads.ts
index 39561afdb416..4b86460bada6 100644
--- a/packages/client-runtime/src/state/threads.ts
+++ b/packages/client-runtime/src/state/threads.ts
@@ -1,21 +1,20 @@
 import {
-  ORCHESTRATION_WS_METHODS,
+  ORCHESTRATION_V2_WS_METHODS,
   type EnvironmentId as EnvironmentIdType,
-  type OrchestrationThread,
-  type OrchestrationThreadDetailPage,
-  type OrchestrationThreadDetailSnapshot,
-  type OrchestrationThreadStreamItem,
+  type OrchestrationV2ThreadDetailSnapshot,
+  type OrchestrationV2ThreadProjection,
+  type OrchestrationV2ThreadStreamItem,
   type ThreadId as ThreadIdType,
 } from "@t3tools/contracts";
 import * as Cause from "effect/Cause";
-import * as Context from "effect/Context";
 import * as Effect from "effect/Effect";
 import * as Option from "effect/Option";
 import * as Queue from "effect/Queue";
 import * as Ref from "effect/Ref";
-import * as Semaphore from "effect/Semaphore";
+import * as Result from "effect/Result";
 import * as Stream from "effect/Stream";
 import * as SubscriptionRef from "effect/SubscriptionRef";
+import { HttpClient } from "effect/unstable/http";
 import { Atom } from "effect/unstable/reactivity";
 
 import { EnvironmentRegistry } from "../connection/registry.ts";
@@ -23,112 +22,99 @@ import { connectionProjectionPhase } from "../connection/model.ts";
 import { EnvironmentSupervisor } from "../connection/supervisor.ts";
 import * as ConnectionWakeups from "../connection/wakeups.ts";
 import { EnvironmentCacheStore } from "../platform/persistence.ts";
+import { ManagedRelayDpopSigner } from "../relay/managedRelay.ts";
 import { subscribeDynamic } from "../rpc/client.ts";
-import { ThreadSnapshotLoader, type ThreadSnapshotWindow } from "./threadSnapshotHttp.ts";
 import { parseThreadKey, threadKey } from "./entities.ts";
-import { applyThreadDetailEvent } from "./threadReducer.ts";
-import { THREAD_STATE_IDLE_TTL_MS } from "./threadRetention.ts";
+import { applyOrchestrationV2ProjectionEvent } from "./orchestrationV2Projection.ts";
 import { followStreamInEnvironment } from "./runtime.ts";
+import {
+  ThreadHistoryController,
+  type ThreadHistoryLoadEarlierResult,
+} from "./threadHistoryController.ts";
+import { fetchEnvironmentThreadHistoryPage } from "./threadHistoryHttp.ts";
+import {
+  applyHistoryPageMeta,
+  clearActiveHistoryLoading,
+  EMPTY_THREAD_HISTORY_META,
+  isActiveHistoryRequestCursor,
+  mergeOlderHistoryIntoProjection,
+  type ThreadHistoryMeta,
+} from "./threadHistoryMerge.ts";
+import { THREAD_STATE_IDLE_TTL_MS } from "./threadRetention.ts";
+import { ThreadSnapshotLoader, type ThreadSnapshotLoadResult } from "./threadSnapshotHttp.ts";
 import {
   EMPTY_ENVIRONMENT_THREAD_STATE,
-  type EnvironmentThreadPageState,
   type EnvironmentThreadState,
   type EnvironmentThreadStatus,
 } from "./threadState.ts";
 
-function statusWithoutLiveData(data: Option.Option<OrchestrationThread>): EnvironmentThreadStatus {
+function statusWithoutLiveData(
+  data: Option.Option<OrchestrationV2ThreadProjection>,
+): EnvironmentThreadStatus {
   return Option.isSome(data) ? "cached" : "empty";
 }
 
-/**
- * Turn window sizes for paginated thread loads: the initial page covers the
- * last 10 user-anchored turns (subagent/fan-out turns ride along), each
- * "load earlier" tap fetches 20 more. Sized so first paint on the heaviest
- * observed threads stays around 100K gzipped while median threads load fully.
- */
-export const INITIAL_THREAD_USER_TURN_LIMIT = 10;
-export const OLDER_THREAD_PAGE_USER_TURN_LIMIT = 20;
-
-function pageStateFromSnapshot(
-  page: OrchestrationThreadDetailPage | undefined,
-): Option.Option<EnvironmentThreadPageState> {
-  return page === undefined
-    ? Option.none()
-    : Option.some({
-        beforeCursor: page.beforeCursor,
-        hasMore: page.hasMore,
-        loadingOlder: false,
-      });
+function formatThreadError(cause: Cause.Cause<unknown>): string {
+  const error = Cause.squash(cause);
+  return error instanceof Error && error.message.trim().length > 0
+    ? error.message
+    : "Could not synchronize the thread.";
 }
 
-interface ThreadOlderTurnRequestRegistry {
-  /**
-   * Registers the live state machine for a thread. Returns the deregistration
-   * cleanup; registration lives exactly as long as the machine's scope, and a
-   * successor machine for the same thread simply replaces the entry.
-   */
-  readonly register: (key: string, handler: () => void) => () => void;
-  readonly request: (key: string) => boolean;
+function formatHistoryError(error: unknown): string {
+  if (error instanceof Error && error.message.trim().length > 0) {
+    return error.message;
+  }
+  return "Could not load earlier activity.";
 }
 
-function makeThreadOlderTurnRequestRegistry(): ThreadOlderTurnRequestRegistry {
-  const handlers = new Map<string, () => void>();
+function historyMetaFromCachedSnapshot(
+  snapshot: OrchestrationV2ThreadDetailSnapshot,
+): ThreadHistoryMeta {
+  const historyCursor = snapshot.historyCursor ?? null;
+  const hasMoreHistory = snapshot.hasMoreHistory ?? false;
   return {
-    register: (key, handler) => {
-      handlers.set(key, handler);
-      return () => {
-        if (handlers.get(key) === handler) {
-          handlers.delete(key);
-        }
-      };
-    },
-    request: (key) => {
-      const handler = handlers.get(key);
-      if (handler === undefined) {
-        return false;
-      }
-      handler();
-      return true;
-    },
+    historyCursor,
+    hasMoreHistory,
+    loading: false,
+    error: null,
+    // Cache never stores expanded progressive history (load-earlier growth).
+    expanded: false,
+    latestLocalTurnOrdinal: snapshot.latestLocalTurnOrdinal ?? null,
   };
 }
 
-const defaultOlderTurnRequestRegistry = makeThreadOlderTurnRequestRegistry();
-
-/**
- * Channel from UI actions to the live per-thread state machines. The machines
- * resolve it from the Effect environment (overridable in tests); the default
- * instance is shared with the sync `requestOlderThreadTurns` entry point so
- * the apps get working wiring without providing anything.
- */
-export class ThreadOlderTurnRequests extends Context.Reference<ThreadOlderTurnRequestRegistry>(
-  "@t3tools/client-runtime/state/threads/ThreadOlderTurnRequests",
-  { defaultValue: () => defaultOlderTurnRequestRegistry },
-) {}
-
-/**
- * Asks the live state machine for `threadId` to fetch the next older page.
- * Returns false when no machine is live or no fetch was started (no cursor,
- * already loading); callers render from `EnvironmentThreadState.page` and can
- * treat false as "nothing to do".
- */
-export function requestOlderThreadTurns(
-  environmentId: EnvironmentIdType,
-  threadId: ThreadIdType,
-): boolean {
-  return defaultOlderTurnRequestRegistry.request(threadKey({ environmentId, threadId }));
-}
-
-function formatThreadError(cause: Cause.Cause<unknown>): string {
-  const error = Cause.squash(cause);
-  return error instanceof Error && error.message.trim().length > 0
-    ? error.message
-    : "Could not synchronize the thread.";
+function snapshotToPersist(
+  snapshotSequence: number,
+  projection: OrchestrationV2ThreadProjection,
+  history: ThreadHistoryMeta,
+): OrchestrationV2ThreadDetailSnapshot {
+  // Persist progressive meta with the bounded window so warm resume restores the
+  // history cursor instead of looking like a complete full-projection cache hit.
+  if (history.hasMoreHistory || history.historyCursor !== null) {
+    return {
+      snapshotSequence,
+      projection,
+      historyCursor: history.historyCursor,
+      hasMoreHistory: history.hasMoreHistory,
+      latestLocalTurnOrdinal: history.latestLocalTurnOrdinal,
+    };
+  }
+  return { snapshotSequence, projection };
 }
 
-function shouldPersistThread(thread: OrchestrationThread): boolean {
-  const status = thread.session?.status;
-  return status !== "starting" && status !== "running";
+function shouldPersistThread(
+  thread: OrchestrationV2ThreadProjection,
+  history: ThreadHistoryMeta,
+): boolean {
+  // After the user loads older pages the in-memory timeline can grow large.
+  // Keep those expanded projections out of the monolithic cache.
+  if (history.expanded) {
+    return false;
+  }
+  return !thread.runs.some(
+    (run) => run.status === "preparing" || run.status === "starting" || run.status === "running",
+  );
 }
 
 export const makeEnvironmentThreadState = Effect.fn("EnvironmentThreadState.make")(function* (
@@ -137,6 +123,9 @@ export const makeEnvironmentThreadState = Effect.fn("EnvironmentThreadState.make
   const supervisor = yield* EnvironmentSupervisor;
   const cache = yield* EnvironmentCacheStore;
   const snapshotLoader = yield* ThreadSnapshotLoader;
+  const historyController = yield* Effect.serviceOption(ThreadHistoryController);
+  const httpClient = yield* Effect.serviceOption(HttpClient.HttpClient);
+  const dpopSigner = yield* Effect.serviceOption(ManagedRelayDpopSigner);
   const wakeups = yield* Effect.serviceOption(ConnectionWakeups.ConnectionWakeups);
   const environmentId = supervisor.target.environmentId;
   const cached = yield* cache.loadThread(environmentId, threadId).pipe(
@@ -147,18 +136,20 @@ export const makeEnvironmentThreadState = Effect.fn("EnvironmentThreadState.make
           threadId,
           error: error.message,
         }),
-        Effect.as(Option.none<OrchestrationThreadDetailSnapshot>()),
+        Effect.as(Option.none<OrchestrationV2ThreadDetailSnapshot>()),
       ),
     ),
   );
-  const cachedThread = Option.map(cached, (snapshot) => snapshot.thread);
+  const cachedThread = Option.map(cached, (snapshot) => snapshot.projection);
+  const cachedHistory = Option.match(cached, {
+    onNone: () => EMPTY_THREAD_HISTORY_META,
+    onSome: historyMetaFromCachedSnapshot,
+  });
   const state = yield* SubscriptionRef.make<EnvironmentThreadState>({
     data: cachedThread,
     status: statusWithoutLiveData(cachedThread),
     error: Option.none(),
-    // A cached windowed snapshot restores its page cursor so "load earlier"
-    // works while rendering from cache; a cached full snapshot has no page.
-    page: Option.flatMap(cached, (snapshot) => pageStateFromSnapshot(snapshot.page)),
+    history: cachedHistory,
   });
   // Seed the resume cursor from the cached snapshot so a warm cache can catch up
   // via `afterSequence` instead of re-downloading the full thread body.
@@ -166,29 +157,10 @@ export const makeEnvironmentThreadState = Effect.fn("EnvironmentThreadState.make
     Option.match(cached, { onNone: () => 0, onSome: (snapshot) => snapshot.snapshotSequence }),
   );
   const awaitingCompletion = yield* Ref.make(false);
-  // Bumped whenever loaded history may have been rewritten out from under an
-  // in-flight older-page fetch (snapshot replacement, revert, deletion). A
-  // page response captured under an older epoch is discarded, not merged.
-  const historyEpoch = yield* Ref.make(0);
-  // Serializes stream-item application against older-page staleness checks +
-  // merges. Without it, a revert or snapshot processed between loadOlderTurns'
-  // epoch check and its merge could still slip resurrected history in.
-  const applyLock = yield* Semaphore.make(1);
-  // Whether the connected server accepts windowed reads; set per subscription
-  // from the session config. Gates loadOlderTurns so a reconnect to a
-  // pre-pagination server never sends unsupported window parameters.
-  const paginationSupported = yield* Ref.make(false);
-  // An older page whose thread watermark is ahead of the live state, parked
-  // until the subscription catches up (see mergeOlderPage's caller). At most
-  // one can exist because loadOlderTurns no-ops while loadingOlder is true.
-  const pendingOlderPage = yield* Ref.make<{
-    readonly snapshot: OrchestrationThreadDetailSnapshot;
-    readonly epoch: number;
-  } | null>(null);
-  const persistence = yield* Queue.sliding<OrchestrationThreadDetailSnapshot>(1);
+  const persistence = yield* Queue.sliding<OrchestrationV2ThreadDetailSnapshot>(1);
 
   const persist = Effect.fn("EnvironmentThreadState.persist")(function* (
-    snapshot: OrchestrationThreadDetailSnapshot,
+    snapshot: OrchestrationV2ThreadDetailSnapshot,
   ) {
     yield* cache.saveThread(environmentId, snapshot).pipe(
       Effect.catch((error) =>
@@ -229,12 +201,6 @@ export const makeEnvironmentThreadState = Effect.fn("EnvironmentThreadState.make
   );
   const setDisconnected = Effect.gen(function* () {
     yield* Ref.set(awaitingCompletion, false);
-    // The capability belongs to the session that advertised it. During a
-    // reconnect, a new prepared connection can exist before the new session's
-    // config arrives; leaving the old value would let loadOlderTurns send
-    // window parameters to a server that may not accept them (review
-    // finding). makeSubscribeInput re-sets it from the next session's config.
-    yield* Ref.set(paginationSupported, false);
     yield* SubscriptionRef.update(state, (current) => ({
       ...current,
       status: current.status === "deleted" ? current.status : statusWithoutLiveData(current.data),
@@ -253,52 +219,58 @@ export const makeEnvironmentThreadState = Effect.fn("EnvironmentThreadState.make
     );
 
   const setThread = Effect.fn("EnvironmentThreadState.setThread")(function* (
-    thread: OrchestrationThread,
-    // "keep" preserves the current page state (live events touch only loaded
-    // recent turns); a snapshot or merged page passes its own page state.
-    page: Option.Option<EnvironmentThreadPageState> | "keep",
+    thread: OrchestrationV2ThreadProjection,
+    options?: {
+      /** Socket/full snapshots: drop progressive meta with the new timeline. */
+      readonly resetHistory?: boolean;
+      /**
+       * Explicit progressive meta installed atomically with the projection
+       * (bounded HTTP). Wins over resetHistory when both are supplied.
+       */
+      readonly history?: ThreadHistoryMeta;
+    },
   ) {
     const waiting = yield* Ref.get(awaitingCompletion);
-    yield* SubscriptionRef.update(state, (current) => ({
-      data: Option.some(thread),
-      status: waiting ? ("synchronizing" as const) : ("live" as const),
-      error: Option.none(),
-      page: page === "keep" ? current.page : page,
-    }));
-    // Active threads can update many times per second and retain large tool
-    // payloads. The server remains the source of truth while a turn is active;
-    // persist once it settles so cache encoding stays off the streaming path.
-    if (shouldPersistThread(thread)) {
+    // Atomic with concurrent history meta updates: never get-then-set the whole
+    // state when only the projection changes. Bounded installs pass history so
+    // projection + cursor persist together in one enqueue.
+    const next = yield* SubscriptionRef.updateAndGet(state, (previous) => {
+      const history =
+        options?.history !== undefined
+          ? options.history
+          : options?.resetHistory === true
+            ? EMPTY_THREAD_HISTORY_META
+            : previous.history;
+      return {
+        ...previous,
+        data: Option.some(thread),
+        status: waiting ? ("synchronizing" as const) : ("live" as const),
+        error: Option.none(),
+        history,
+      };
+    });
+    // Active projections can update many times per second and retain large tool
+    // payloads. Persist once the run settles so cache encoding stays off the
+    // streaming path. Progressive meta rides along when the window is incomplete.
+    if (shouldPersistThread(thread, next.history)) {
       const snapshotSequence = yield* SubscriptionRef.get(lastSequence);
-      const currentPage = yield* SubscriptionRef.get(state).pipe(Effect.map((value) => value.page));
-      yield* Queue.offer(persistence, {
-        snapshotSequence,
-        thread,
-        // Persist the window boundary with the window's content so a cache
-        // restore can keep paging from where the loaded history ends.
-        ...Option.match(currentPage, {
-          onNone: () => ({}),
-          onSome: (value) =>
-            ({
-              page: {
-                beforeCursor: value.beforeCursor,
-                hasMore: value.hasMore,
-                snapshotSequence,
-              },
-            }) as const,
-        }),
-      });
+      yield* Queue.offer(persistence, snapshotToPersist(snapshotSequence, thread, next.history));
     }
   });
 
+  const patchHistoryMeta = (patch: (history: ThreadHistoryMeta) => ThreadHistoryMeta) =>
+    SubscriptionRef.update(state, (current) => ({
+      ...current,
+      history: patch(current.history),
+    }));
+
   const setDeleted = Effect.fn("EnvironmentThreadState.setDeleted")(function* () {
     yield* Ref.set(awaitingCompletion, false);
-    yield* Ref.update(historyEpoch, (epoch) => epoch + 1);
     yield* SubscriptionRef.set(state, {
       data: Option.none(),
       status: "deleted",
       error: Option.none(),
-      page: Option.none(),
+      history: EMPTY_THREAD_HISTORY_META,
     });
     yield* cache.removeThread(environmentId, threadId).pipe(
       Effect.catch((error) =>
@@ -313,9 +285,8 @@ export const makeEnvironmentThreadState = Effect.fn("EnvironmentThreadState.make
     );
   });
 
-  // Body of applyItem, running under applyLock.
-  const applyItemLocked = Effect.fn("EnvironmentThreadState.applyItemLocked")(function* (
-    item: OrchestrationThreadStreamItem,
+  const applyItem = Effect.fn("EnvironmentThreadState.applyItem")(function* (
+    item: OrchestrationV2ThreadStreamItem,
   ) {
     if (item.kind === "synchronized") {
       yield* Ref.set(awaitingCompletion, false);
@@ -328,209 +299,244 @@ export const makeEnvironmentThreadState = Effect.fn("EnvironmentThreadState.make
     }
 
     if (item.kind === "snapshot") {
-      // A fresh snapshot replaces all loaded history, including older
-      // pages: a turn reverted while disconnected would otherwise survive
-      // in the preserved history with no event left to remove it. The
-      // epoch bump discards any older-page fetch racing this snapshot.
-      yield* Ref.update(historyEpoch, (epoch) => epoch + 1);
-      yield* SubscriptionRef.set(lastSequence, item.snapshot.snapshotSequence);
-      yield* setThread(item.snapshot.thread, pageStateFromSnapshot(item.snapshot.page));
+      yield* SubscriptionRef.set(lastSequence, item.snapshotSequence);
+      // True socket/full snapshots replace the full timeline; progressive cursor
+      // state from a prior bounded window must not stick around. Bounded HTTP
+      // installs call setThread with explicit history and never route here.
+      yield* setThread(item.projection, { resetHistory: true });
       return;
     }
 
     const sequence = yield* SubscriptionRef.get(lastSequence);
-    if (item.event.sequence <= sequence) {
+    if (item.sequence <= sequence) {
       return;
     }
-    yield* SubscriptionRef.set(lastSequence, item.event.sequence);
+    yield* SubscriptionRef.set(lastSequence, item.sequence);
 
-    const current = yield* SubscriptionRef.get(state);
-    if (Option.isNone(current.data)) {
-      if (item.event.type === "thread.deleted") {
-        yield* setDeleted();
-      }
-      return;
-    }
-    if (item.event.type === "thread.reverted") {
-      // A revert rewrites loaded history (whole turns disappear), so an
-      // older-page fetch in flight may straddle the removed range; the epoch
-      // bump discards it. The stored page cursor stays valid: cursors are an
-      // (anchor, turnId) keyset derived from event content, which survives
-      // the revert projector's row rewrite, so no refresh is needed — the
-      // revert reducer's turn filtering fully handles loaded history.
-      yield* Ref.update(historyEpoch, (epoch) => epoch + 1);
-    }
-    const result = applyThreadDetailEvent(current.data.value, item.event);
-    if (result.kind === "updated") {
-      yield* setThread(result.thread, "keep");
-    } else if (result.kind === "deleted") {
-      yield* setDeleted();
-    }
-    // The event may have advanced the live state past a parked page's
-    // watermark; merge it as soon as that happens.
-    yield* tryMergePendingOlderPage();
-  });
+    const waiting = yield* Ref.get(awaitingCompletion);
+    // Apply against the latest projection/history in one update so a concurrent
+    // loadEarlier merge (or history-meta patch) cannot be clobbered by a stale
+    // get-then-set rebuild.
+    type EventApplyResult =
+      | { readonly _tag: "noop" }
+      | { readonly _tag: "delete" }
+      | {
+          readonly _tag: "applied";
+          readonly projection: OrchestrationV2ThreadProjection;
+          readonly history: ThreadHistoryMeta;
+        };
 
-  // Merges a parked older page once the live state has caught up to the
-  // page's thread watermark, or discards it if history was rewritten
-  // (epoch advanced) while it waited. Must run under applyLock.
-  const tryMergePendingOlderPage = Effect.fn("EnvironmentThreadState.tryMergePendingOlderPage")(
-    function* () {
-      const pending = yield* Ref.get(pendingOlderPage);
-      if (pending === null) {
-        return;
-      }
-      const epochNow = yield* Ref.get(historyEpoch);
-      if (epochNow !== pending.epoch) {
-        yield* Ref.set(pendingOlderPage, null);
-        yield* SubscriptionRef.update(state, (value) => ({
-          ...value,
-          page: Option.map(value.page, (existing) => ({ ...existing, loadingOlder: false })),
-        }));
-        return;
-      }
-      const watermark = pending.snapshot.page?.threadSequence;
-      const loadedSequence = yield* SubscriptionRef.get(lastSequence);
-      if (watermark !== undefined && watermark > loadedSequence) {
-        return;
-      }
-      yield* Ref.set(pendingOlderPage, null);
-      yield* mergeOlderPage(pending.snapshot);
-    },
-  );
+    const result = yield* SubscriptionRef.modify(
+      state,
+      (current): readonly [EventApplyResult, EnvironmentThreadState] => {
+        if (current.status === "deleted") {
+          return [{ _tag: "noop" }, current];
+        }
+        if (Option.isNone(current.data)) {
+          return [
+            item.event.type === "thread.deleted" ? { _tag: "delete" } : { _tag: "noop" },
+            current,
+          ];
+        }
+        if (item.event.type === "thread.deleted") {
+          return [{ _tag: "delete" }, current];
+        }
 
-  const applyItem = Effect.fn("EnvironmentThreadState.applyItem")(function* (
-    item: OrchestrationThreadStreamItem,
-  ) {
-    yield* applyLock.withPermits(1)(applyItemLocked(item));
-  });
+        // Incomplete progressive windows only (hasMore or open cursor). Do not
+        // use expanded: it remains true after the last page as a cache marker.
+        // Full/web and fully-loaded timelines keep default append-on-miss.
+        const partial =
+          current.history.hasMoreHistory || current.history.historyCursor !== null
+            ? {
+                partialTimeline: true as const,
+                latestLocalTurnOrdinal: current.history.latestLocalTurnOrdinal,
+              }
+            : undefined;
+        const next = applyOrchestrationV2ProjectionEvent(current.data.value, item.event, partial);
+        // True no-op when the reducer deliberately returns the current projection
+        // reference (e.g. dropped old partial-timeline turn-item). Do not clear
+        // stream error/status or enqueue persistence.
+        if (next === null || next === current.data.value) {
+          return [{ _tag: "noop" }, current];
+        }
 
-  // Merges an older disjoint page below the currently loaded window. All four
-  // windowed collections prepend; identity dedupe guards the (server-bug or
-  // cursor-misuse) case of overlapping pages so a row never renders twice.
-  const mergeOlderPage = Effect.fn("EnvironmentThreadState.mergeOlderPage")(function* (
-    snapshot: OrchestrationThreadDetailSnapshot,
-  ) {
-    // The merge is built inside the update callback so it composes with
-    // whatever thread value is current at commit time. The applyLock already
-    // serializes this against event application; the atomic build is defense
-    // in depth against future callers outside the lock.
-    let merged: OrchestrationThread | null = null;
-    yield* SubscriptionRef.update(state, (value) => {
-      if (Option.isNone(value.data)) {
-        return value;
-      }
-      const loaded = value.data.value;
-      const older = snapshot.thread;
-      const mergeById = <T extends { readonly id: string }>(
-        olderRows: ReadonlyArray<T>,
-        loadedRows: ReadonlyArray<T>,
-      ): ReadonlyArray<T> => {
-        const seen = new Set(loadedRows.map((row) => row.id));
-        return [...olderRows.filter((row) => !seen.has(row.id)), ...loadedRows];
-      };
-      const seenCheckpoints = new Set(loaded.checkpoints.map((row) => row.turnId));
-      merged = {
-        // Thread metadata stays the loaded (newer) snapshot's; only the
-        // windowed collections gain rows from the older page.
-        ...loaded,
-        messages: mergeById(older.messages, loaded.messages),
-        activities: mergeById(older.activities, loaded.activities),
-        proposedPlans: mergeById(older.proposedPlans, loaded.proposedPlans),
-        checkpoints: [
-          ...older.checkpoints.filter((row) => !seenCheckpoints.has(row.turnId)),
-          ...loaded.checkpoints,
-        ],
-      };
-      return {
-        ...value,
-        data: Option.some(merged),
-        page: pageStateFromSnapshot(snapshot.page),
-      };
-    });
-    // Persist the widened window under the *loaded* watermark: the merged
-    // content is only known consistent with the state it merged into, not
-    // with the page's own (possibly newer) sequence.
-    if (merged !== null && shouldPersistThread(merged)) {
+        let history = current.history;
+        if (partial !== undefined && item.event.type === "turn-item.updated") {
+          const ordinal = item.event.payload.ordinal;
+          const watermark = history.latestLocalTurnOrdinal;
+          if (watermark === null || ordinal > watermark) {
+            history = { ...history, latestLocalTurnOrdinal: ordinal };
+          }
+        }
+
+        const updated: EnvironmentThreadState = {
+          ...current,
+          data: Option.some(next),
+          status: waiting ? "synchronizing" : "live",
+          error: Option.none(),
+          history,
+        };
+        return [{ _tag: "applied", projection: next, history: updated.history }, updated];
+      },
+    );
+
+    if (result._tag === "delete") {
+      yield* setDeleted();
+      return;
+    }
+    if (result._tag === "applied" && shouldPersistThread(result.projection, result.history)) {
       const snapshotSequence = yield* SubscriptionRef.get(lastSequence);
-      yield* Queue.offer(persistence, {
-        snapshotSequence,
-        thread: merged,
-        ...(snapshot.page === undefined ? {} : { page: { ...snapshot.page, snapshotSequence } }),
-      });
+      yield* Queue.offer(
+        persistence,
+        snapshotToPersist(snapshotSequence, result.projection, result.history),
+      );
     }
   });
 
-  const loadOlderTurns = Effect.fn("EnvironmentThreadState.loadOlderTurns")(function* () {
-    // Gated on the connected server's capability: a reconnect to a
-    // pre-pagination server must never receive window parameters.
-    if (!(yield* Ref.get(paginationSupported))) {
-      return;
-    }
+  const loadEarlier = Effect.fn("EnvironmentThreadState.loadEarlier")(function* () {
     const current = yield* SubscriptionRef.get(state);
-    const page = Option.getOrNull(current.page);
-    if (page === null || page.loadingOlder || !page.hasMore || page.beforeCursor === null) {
-      return;
+    if (
+      current.status === "deleted" ||
+      Option.isNone(current.data) ||
+      !current.history.hasMoreHistory ||
+      current.history.historyCursor === null
+    ) {
+      return { _tag: "noop" } satisfies ThreadHistoryLoadEarlierResult;
     }
-    const prepared = Option.getOrNull(yield* SubscriptionRef.get(supervisor.prepared));
-    if (prepared === null) {
-      return;
+    if (current.history.loading) {
+      return { _tag: "busy" } satisfies ThreadHistoryLoadEarlierResult;
     }
-    const epochAtStart = yield* Ref.get(historyEpoch);
-    yield* SubscriptionRef.update(state, (value) => ({
-      ...value,
-      page: Option.map(value.page, (existing) => ({ ...existing, loadingOlder: true })),
-    }));
-    const window: ThreadSnapshotWindow = {
-      turnLimit: OLDER_THREAD_PAGE_USER_TURN_LIMIT,
-      beforeCursor: page.beforeCursor,
-    };
-    const response = yield* snapshotLoader.load(prepared, threadId, window);
-    // Staleness check and merge run under the same lock as stream-item
-    // application, so a revert/snapshot cannot land between them (TOCTOU
-    // review finding) — anything that rewrites history bumps the epoch
-    // before this permit is acquired.
-    yield* applyLock.withPermits(1)(
-      Effect.gen(function* () {
-        const epochNow = yield* Ref.get(historyEpoch);
-        const loadedSequence = yield* SubscriptionRef.get(lastSequence);
-        // A page carrying a sequence older than the loaded state was read
-        // from a projection behind what we render; merging it could
-        // resurrect turns a newer snapshot or revert already removed.
-        const stale =
-          epochNow !== epochAtStart ||
-          Option.match(response, {
-            onNone: () => false,
-            onSome: (snapshot) => snapshot.snapshotSequence < loadedSequence,
-          });
-        if (Option.isNone(response) || stale) {
-          yield* SubscriptionRef.update(state, (value) => ({
-            ...value,
-            page: Option.map(value.page, (existing) => ({ ...existing, loadingOlder: false })),
-          }));
-          return;
+
+    // Capture the cursor that initiated this request. Completions/failures must
+    // no-op if a socket or new bounded snapshot replaced progressive meta mid-flight.
+    const requestCursor = current.history.historyCursor;
+    yield* patchHistoryMeta((history) =>
+      isActiveHistoryRequestCursor(requestCursor, history)
+        ? { ...history, loading: true, error: null }
+        : history,
+    );
+
+    const runLoad = Effect.gen(function* () {
+      const preparedOption = yield* SubscriptionRef.get(supervisor.prepared);
+      if (Option.isNone(preparedOption) || Option.isNone(httpClient)) {
+        const message = "Environment is not connected.";
+        const stillCurrent = yield* SubscriptionRef.modify(
+          state,
+          (latest): readonly [boolean, EnvironmentThreadState] => {
+            if (!isActiveHistoryRequestCursor(requestCursor, latest.history)) {
+              return [false, latest];
+            }
+            return [
+              true,
+              {
+                ...latest,
+                history: { ...latest.history, loading: false, error: message },
+              },
+            ];
+          },
+        );
+        if (!stillCurrent) {
+          return { _tag: "noop" } satisfies ThreadHistoryLoadEarlierResult;
         }
-        // A page read AHEAD of the live state may include content (e.g.
-        // streaming deltas of an out-of-window turn) the subscription has
-        // not delivered yet; merging now and then replaying those events
-        // would duplicate them. Park the page until the live state reaches
-        // the page's thread-scoped watermark; loadingOlder stays true so
-        // the UI shows progress and no second fetch starts. Pages from
-        // pre-watermark servers (threadSequence absent) merge immediately,
-        // preserving the old behavior.
-        const watermark = response.value.page?.threadSequence;
-        if (watermark !== undefined && watermark > loadedSequence) {
-          yield* Ref.set(pendingOlderPage, {
-            snapshot: response.value,
-            epoch: epochNow,
-          });
-          return;
+        return {
+          _tag: "error",
+          message,
+        } satisfies ThreadHistoryLoadEarlierResult;
+      }
+
+      const pageResult = yield* fetchEnvironmentThreadHistoryPage({
+        prepared: preparedOption.value,
+        threadId,
+        cursor: requestCursor,
+        signer: dpopSigner,
+      }).pipe(Effect.provideService(HttpClient.HttpClient, httpClient.value), Effect.result);
+
+      if (Result.isFailure(pageResult)) {
+        const message = formatHistoryError(pageResult.failure);
+        // Only mark error when this request's cursor is still active. Leave
+        // stream/status/error alone so concurrent live updates stay intact.
+        const stillCurrent = yield* SubscriptionRef.modify(
+          state,
+          (latest): readonly [boolean, EnvironmentThreadState] => {
+            if (!isActiveHistoryRequestCursor(requestCursor, latest.history)) {
+              return [false, latest];
+            }
+            return [
+              true,
+              {
+                ...latest,
+                history: { ...latest.history, loading: false, error: message },
+              },
+            ];
+          },
+        );
+        if (!stillCurrent) {
+          return { _tag: "noop" } satisfies ThreadHistoryLoadEarlierResult;
         }
-        yield* mergeOlderPage(response.value);
-      }),
+        return { _tag: "error", message } satisfies ThreadHistoryLoadEarlierResult;
+      }
+
+      const page = pageResult.success;
+      const waiting = yield* Ref.get(awaitingCompletion);
+      // Single atomic merge against whatever is current after the await so a
+      // concurrent applyItem cannot be clobbered by a stale get/set pair.
+      return yield* SubscriptionRef.modify(
+        state,
+        (latest): readonly [ThreadHistoryLoadEarlierResult, EnvironmentThreadState] => {
+          // Stale page: socket/full snapshot or newer bounded install changed the
+          // progressive cursor while this request was in flight. Never mutate the
+          // replacement meta (including deleted/empty installs).
+          if (!isActiveHistoryRequestCursor(requestCursor, latest.history)) {
+            return [{ _tag: "noop" }, latest];
+          }
+          if (Option.isNone(latest.data) || latest.status === "deleted") {
+            return [
+              { _tag: "noop" },
+              {
+                ...latest,
+                history: EMPTY_THREAD_HISTORY_META,
+              },
+            ];
+          }
+
+          const merged = mergeOlderHistoryIntoProjection(latest.data.value, page.items);
+          const history = applyHistoryPageMeta(latest.history, page);
+          return [
+            { _tag: "loaded" },
+            {
+              ...latest,
+              data: Option.some(merged),
+              status: waiting
+                ? ("synchronizing" as const)
+                : latest.status === "live"
+                  ? ("live" as const)
+                  : latest.status,
+              history,
+            },
+          ];
+        },
+      );
+    });
+
+    // On Effect interruption only: clear loading when this request cursor is
+    // still active. Never mutate stream status/error from the interrupt path.
+    return yield* runLoad.pipe(
+      Effect.onInterrupt(() =>
+        SubscriptionRef.update(state, (latest) => ({
+          ...latest,
+          history: clearActiveHistoryLoading(requestCursor, latest.history),
+        })),
+      ),
     );
   });
 
+  if (Option.isSome(historyController)) {
+    const registration = yield* historyController.value.register(environmentId, threadId, {
+      loadEarlier: () => loadEarlier(),
+    });
+    yield* Effect.addFinalizer(() => historyController.value.unregister(registration));
+  }
+
   yield* SubscriptionRef.changes(supervisor.state).pipe(
     Stream.runForEach((connectionState) => {
       switch (connectionProjectionPhase(connectionState)) {
@@ -554,43 +560,24 @@ export const makeEnvironmentThreadState = Effect.fn("EnvironmentThreadState.make
   yield* setSynchronizing;
   yield* Effect.forkScoped(
     subscribeDynamic(
-      ORCHESTRATION_WS_METHODS.subscribeThread,
+      ORCHESTRATION_V2_WS_METHODS.subscribeThread,
       Effect.fn("EnvironmentThreadState.makeSubscribeInput")(function* (session) {
-        const config = yield* session.initialConfig.pipe(
-          Effect.orElseSucceed(
-            () =>
-              ({}) as {
-                threadResumeCompletionMarker?: boolean;
-                threadSnapshotPagination?: boolean;
-              },
-          ),
+        let current = yield* SubscriptionRef.get(state);
+        // A prior definitive miss (or delete event) already cleared this thread.
+        // Park the subscription attempt without opening the socket so we do not
+        // retry forever against a known-missing id.
+        if (current.status === "deleted") {
+          return yield* Effect.never;
+        }
+
+        const supportsCompletionMarker = yield* session.initialConfig.pipe(
+          Effect.map((config) => config.threadResumeCompletionMarker === true),
+          Effect.orElseSucceed(() => false),
         );
-        const supportsCompletionMarker = config.threadResumeCompletionMarker === true;
-        // Windowed loads are gated on the server capability: pre-pagination
-        // servers reject unknown query params, and a windowed WS fallback to
-        // such a server would silently hide history.
-        const supportsPagination = config.threadSnapshotPagination === true;
-        yield* Ref.set(paginationSupported, supportsPagination);
         yield* Ref.set(awaitingCompletion, supportsCompletionMarker);
         yield* setSynchronizing;
 
-        let current = yield* SubscriptionRef.get(state);
-        // A windowed cache resuming against a server without pagination is a
-        // trap: afterSequence resume keeps only the window, and the missing
-        // older turns can never be loaded (the server has no cursor reads).
-        // Drop the window marker and treat the data as needing a full reload.
-        if (!supportsPagination && Option.isSome(current.page)) {
-          yield* Ref.update(historyEpoch, (epoch) => epoch + 1);
-          yield* SubscriptionRef.update(state, (value) => ({
-            ...value,
-            data: Option.none(),
-            status: value.status === "deleted" ? value.status : ("empty" as const),
-            page: Option.none(),
-          }));
-          yield* SubscriptionRef.set(lastSequence, 0);
-          current = yield* SubscriptionRef.get(state);
-        }
-        if (Option.isNone(current.data) && current.status !== "deleted") {
+        if (Option.isNone(current.data)) {
           const prepared = yield* SubscriptionRef.get(supervisor.prepared).pipe(
             Effect.flatMap(
               Option.match({
@@ -605,14 +592,41 @@ export const makeEnvironmentThreadState = Effect.fn("EnvironmentThreadState.make
               }),
             ),
           );
-          const httpSnapshot = yield* snapshotLoader.load(
+          const httpResult: ThreadSnapshotLoadResult = yield* snapshotLoader.load(
             prepared,
             threadId,
-            supportsPagination ? { turnLimit: INITIAL_THREAD_USER_TURN_LIMIT } : undefined,
           );
-          if (Option.isSome(httpSnapshot)) {
-            yield* applyItem({ kind: "snapshot", snapshot: httpSnapshot.value });
-            current = yield* SubscriptionRef.get(state);
+          switch (httpResult._tag) {
+            case "present": {
+              // Atomic projection + progressive meta so a settled bounded window
+              // never persists as a complete full-timeline cache entry. Socket
+              // snapshots still go through applyItem (resetHistory).
+              yield* SubscriptionRef.set(lastSequence, httpResult.snapshot.snapshotSequence);
+              const history: ThreadHistoryMeta =
+                httpResult.history !== undefined
+                  ? {
+                      historyCursor: httpResult.history.historyCursor,
+                      hasMoreHistory: httpResult.history.hasMoreHistory,
+                      loading: false,
+                      error: null,
+                      expanded: false,
+                      latestLocalTurnOrdinal: httpResult.history.latestLocalTurnOrdinal ?? null,
+                    }
+                  : EMPTY_THREAD_HISTORY_META;
+              yield* setThread(httpResult.snapshot.projection, { history });
+              current = yield* SubscriptionRef.get(state);
+              break;
+            }
+            case "missing": {
+              // Definitive HTTP 404: clear any stale cache and do not open or
+              // retry a socket subscription for this attempt.
+              yield* setDeleted();
+              return yield* Effect.never;
+            }
+            case "unavailable": {
+              // Transient HTTP failure: fall through to the socket path.
+              break;
+            }
           }
         }
 
@@ -630,10 +644,6 @@ export const makeEnvironmentThreadState = Effect.fn("EnvironmentThreadState.make
           threadId,
           ...(canResume ? { afterSequence: sequence } : {}),
           ...(supportsCompletionMarker ? { requestCompletionMarker: true as const } : {}),
-          // The WS fallback snapshot (sent when afterSequence is missing or
-          // the gap is too large) should be windowed the same as the HTTP
-          // path; without this a resume failure re-downloads the full thread.
-          ...(supportsPagination ? { turnLimit: INITIAL_THREAD_USER_TURN_LIMIT } : {}),
         };
       }),
       {
@@ -644,46 +654,14 @@ export const makeEnvironmentThreadState = Effect.fn("EnvironmentThreadState.make
     ).pipe(Stream.runForEach(applyItem)),
   );
 
-  // Expose loadOlderTurns to UI actions through the request registry.
-  // Requests funnel through a sliding queue drained serially, so mashing
-  // "load earlier" coalesces (loadOlderTurns itself no-ops while a fetch is
-  // in flight).
-  const olderTurnRequestRegistry = yield* ThreadOlderTurnRequests;
-  const olderTurnRequests = yield* Queue.sliding<void>(1);
-  yield* Stream.fromQueue(olderTurnRequests).pipe(
-    Stream.runForEach(() => loadOlderTurns()),
-    Effect.forkScoped,
-  );
-  const deregister = olderTurnRequestRegistry.register(
-    threadKey({ environmentId, threadId }),
-    () => {
-      Queue.offerUnsafe(olderTurnRequests, undefined);
-    },
-  );
-  yield* Effect.addFinalizer(() => Effect.sync(deregister));
-
   yield* Effect.addFinalizer(() =>
     Effect.all([SubscriptionRef.get(state), SubscriptionRef.get(lastSequence)]).pipe(
       Effect.flatMap(([current, snapshotSequence]) =>
         Option.match(current.data, {
           onNone: () => Effect.void,
-          onSome: (thread) =>
-            shouldPersistThread(thread)
-              ? persist({
-                  snapshotSequence,
-                  thread,
-                  ...Option.match(current.page, {
-                    onNone: () => ({}),
-                    onSome: (page) =>
-                      ({
-                        page: {
-                          beforeCursor: page.beforeCursor,
-                          hasMore: page.hasMore,
-                          snapshotSequence,
-                        },
-                      }) as const,
-                  }),
-                })
+          onSome: (projection) =>
+            shouldPersistThread(projection, current.history)
+              ? persist(snapshotToPersist(snapshotSequence, projection, current.history))
               : Effect.void,
         }),
       ),
@@ -726,11 +704,13 @@ export function createEnvironmentThreadStateAtoms<R, E>(
 
 export * from "./archivedThreads.ts";
 export * from "./checkpointDiff.ts";
+export * from "./boundedThreadSnapshotHttp.ts";
+export * from "./threadHistoryController.ts";
+export * from "./threadHistoryMerge.ts";
 export * from "./threadSnapshotHttp.ts";
 export * from "./composerPathSearch.ts";
 export * from "./threadCommands.ts";
 export * from "./threadFeedback.ts";
 export * from "./threadDetail.ts";
-export * from "./threadReducer.ts";
 export * from "./threadShell.ts";
 export * from "./threadState.ts";
diff --git a/packages/client-runtime/src/state/turnItemPresentation.test.ts b/packages/client-runtime/src/state/turnItemPresentation.test.ts
new file mode 100644
index 000000000000..af2b9fcbe83b
--- /dev/null
+++ b/packages/client-runtime/src/state/turnItemPresentation.test.ts
@@ -0,0 +1,36 @@
+import { RunId, ThreadId, TurnItemId, type OrchestrationV2TurnItem } from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
+import { describe, expect, it } from "vite-plus/test";
+
+import { turnItemIsWorkspacePreparation } from "./turnItemPresentation.ts";
+
+function command(input: string): OrchestrationV2TurnItem {
+  const now = DateTime.makeUnsafe("2026-08-03T00:00:00.000Z");
+  return {
+    id: TurnItemId.make("item-command"),
+    threadId: ThreadId.make("thread-1"),
+    runId: RunId.make("run-1"),
+    nodeId: null,
+    providerThreadId: null,
+    providerTurnId: null,
+    nativeItemRef: null,
+    parentItemId: null,
+    ordinal: 1,
+    status: "completed",
+    title: "Workspace ready",
+    startedAt: now,
+    completedAt: now,
+    updatedAt: now,
+    type: "command_execution",
+    input,
+    output: "Workspace preparation completed.",
+    exitCode: 0,
+  };
+}
+
+describe("turnItemIsWorkspacePreparation", () => {
+  it("identifies the synthetic workspace preparation command", () => {
+    expect(turnItemIsWorkspacePreparation(command("Preparing workspace"))).toBe(true);
+    expect(turnItemIsWorkspacePreparation(command("prepare workspace"))).toBe(false);
+  });
+});
diff --git a/packages/client-runtime/src/state/turnItemPresentation.ts b/packages/client-runtime/src/state/turnItemPresentation.ts
new file mode 100644
index 000000000000..fe306c92ae34
--- /dev/null
+++ b/packages/client-runtime/src/state/turnItemPresentation.ts
@@ -0,0 +1,8 @@
+import type { OrchestrationV2TurnItem } from "@t3tools/contracts";
+
+const WORKSPACE_PREPARATION_INPUT = "Preparing workspace";
+
+/** Workspace setup is client bookkeeping; preparation failures have their own error item. */
+export function turnItemIsWorkspacePreparation(item: OrchestrationV2TurnItem): boolean {
+  return item.type === "command_execution" && item.input === WORKSPACE_PREPARATION_INPUT;
+}
diff --git a/packages/client-runtime/src/state/vcsAction.test.ts b/packages/client-runtime/src/state/vcsAction.test.ts
index b936246dc823..a2cda45df035 100644
--- a/packages/client-runtime/src/state/vcsAction.test.ts
+++ b/packages/client-runtime/src/state/vcsAction.test.ts
@@ -203,7 +203,7 @@ describe("vcsActionState", () => {
     });
   });
 
-  it("clears running presentation state once the action finishes", () => {
+  it("keeps running presentation state until the finished action settles", () => {
     const initial = beginVcsActionState({
       operation: "run_change_request",
       label: "Running source control action",
@@ -232,18 +232,18 @@ describe("vcsActionState", () => {
     );
 
     expect(finished).toMatchObject({
-      isRunning: false,
+      isRunning: true,
       operation: "run_change_request",
       actionId,
       action,
-      currentLabel: null,
-      currentPhaseLabel: null,
+      currentLabel: "Pushing...",
+      currentPhaseLabel: "Pushing...",
       lastOutputLine: null,
       error: null,
     });
   });
 
-  it("retains a terminal action error for presentation", () => {
+  it("keeps running presentation state and retains a terminal action error until settle", () => {
     const initial = beginVcsActionState({
       operation: "run_change_request",
       label: "Running source control action",
@@ -262,7 +262,7 @@ describe("vcsActionState", () => {
     );
 
     expect(failed).toMatchObject({
-      isRunning: false,
+      isRunning: true,
       operation: "run_change_request",
       actionId,
       action,
@@ -583,11 +583,16 @@ describe("vcsActionState", () => {
         const targetKey = { environmentId, cwd };
         const successfulActionId = "invalidate-success";
         const failedActionId = "invalidate-failure";
+        const interruptedActionId = "invalidate-interrupted";
         const successfulTransportActionId = createVcsActionTransportId(
           targetKey,
           successfulActionId,
         );
         const failedTransportActionId = createVcsActionTransportId(targetKey, failedActionId);
+        const interruptedTransportActionId = createVcsActionTransportId(
+          targetKey,
+          interruptedActionId,
+        );
         const client = {
           [WS_METHODS.gitRunStackedAction]: (input: { readonly actionId: string }) =>
             input.actionId === successfulTransportActionId
@@ -600,16 +605,18 @@ describe("vcsActionState", () => {
                     result,
                   }),
                 )
-              : Stream.make(
-                  progress({
-                    kind: "action_failed",
-                    actionId: failedTransportActionId,
-                    cwd,
-                    action,
-                    phase: "push",
-                    message: "push failed after creating the branch",
-                  }),
-                ),
+              : input.actionId === interruptedTransportActionId
+                ? Stream.fromEffect(Effect.interrupt)
+                : Stream.make(
+                    progress({
+                      kind: "action_failed",
+                      actionId: failedTransportActionId,
+                      cwd,
+                      action,
+                      phase: "push",
+                      message: "push failed after creating the branch",
+                    }),
+                  ),
         } as unknown as WsRpcProtocolClient;
         const supervisor = EnvironmentSupervisor.EnvironmentSupervisor.of({
           target,
@@ -659,6 +666,7 @@ describe("vcsActionState", () => {
         );
 
         expect(AsyncResult.isSuccess(successfulResult)).toBe(true);
+        expect(registry.get(manager.stateAtom(targetKey))).toEqual(EMPTY_VCS_ACTION_STATE);
         expect(registry.get(state).revision).toBe(1);
         expect(removed).toEqual([`${environmentId}:*`]);
 
@@ -670,8 +678,29 @@ describe("vcsActionState", () => {
         );
 
         expect(AsyncResult.isFailure(failedResult)).toBe(true);
+        expect(registry.get(manager.stateAtom(targetKey))).toMatchObject({
+          isRunning: false,
+          operation: "run_change_request",
+          actionId: failedActionId,
+          error: "Source control action 'commit_push' failed during push.",
+        });
         expect(registry.get(state).revision).toBe(2);
         expect(removed).toEqual([`${environmentId}:*`, `${environmentId}:*`]);
+
+        const interruptedResult = yield* Effect.promise(() =>
+          manager.runStackedAction(targetKey).run(registry, {
+            actionId: interruptedActionId,
+            action,
+          }),
+        );
+
+        expect(AsyncResult.isFailure(interruptedResult)).toBe(true);
+        if (AsyncResult.isFailure(interruptedResult)) {
+          expect(Cause.hasInterruptsOnly(interruptedResult.cause)).toBe(true);
+        }
+        expect(registry.get(manager.stateAtom(targetKey))).toEqual(EMPTY_VCS_ACTION_STATE);
+        expect(registry.get(state).revision).toBe(3);
+        expect(removed).toEqual([`${environmentId}:*`, `${environmentId}:*`, `${environmentId}:*`]);
       }),
     ),
   );
diff --git a/packages/client-runtime/src/state/vcsAction.ts b/packages/client-runtime/src/state/vcsAction.ts
index f0c3791e35b2..7823a28a75b2 100644
--- a/packages/client-runtime/src/state/vcsAction.ts
+++ b/packages/client-runtime/src/state/vcsAction.ts
@@ -388,14 +388,17 @@ export function applyVcsActionProgressEvent(
       };
     case "action_finished":
       return {
-        ...EMPTY_VCS_ACTION_STATE,
+        ...current,
+        isRunning: true,
         actionId: event.actionId,
         action: event.action,
         operation: "run_change_request",
+        error: null,
       };
     case "action_failed":
       return {
-        ...EMPTY_VCS_ACTION_STATE,
+        ...current,
+        isRunning: true,
         actionId: event.actionId,
         action: event.action,
         operation: "run_change_request",
@@ -464,6 +467,12 @@ export function createVcsActionManager<R, E>(
           ...(input.featureBranch ? { featureBranch: true } : {}),
           ...(input.filePaths?.length ? { filePaths: [...input.filePaths] } : {}),
         };
+        const clearOwnedState = Effect.sync(() => {
+          const current = registry.get(stateAtom);
+          if (current.actionId === input.actionId) {
+            registry.set(stateAtom, EMPTY_VCS_ACTION_STATE);
+          }
+        });
         return consumeVcsActionProgress(
           runStreamInEnvironment(
             target.environmentId,
@@ -492,6 +501,7 @@ export function createVcsActionManager<R, E>(
           },
         ).pipe(
           Effect.ensuring(invalidateCachedVcsRefs(registry, target)),
+          Effect.tap(() => clearOwnedState),
           Effect.tapError((error) =>
             Effect.sync(() => {
               const current = registry.get(stateAtom);
@@ -503,6 +513,7 @@ export function createVcsActionManager<R, E>(
               }
             }),
           ),
+          Effect.onInterrupt(() => clearOwnedState),
         );
       },
     });
diff --git a/packages/client-runtime/src/t3ToolSummary.test.ts b/packages/client-runtime/src/t3ToolSummary.test.ts
new file mode 100644
index 000000000000..7f00c42345cd
--- /dev/null
+++ b/packages/client-runtime/src/t3ToolSummary.test.ts
@@ -0,0 +1,156 @@
+import { describe, expect, it } from "vite-plus/test";
+
+import { summarizeT3ToolCalls, type T3ToolSummaryCall } from "./t3ToolSummary.ts";
+
+function completed(input: unknown, output?: unknown): T3ToolSummaryCall {
+  return { input, output, outcome: "completed" };
+}
+
+describe("summarizeT3ToolCalls", () => {
+  it("counts messages and distinct destinations across delivery modes, deduplicating retries", () => {
+    const calls = Array.from({ length: 5 }, (_, i) =>
+      completed(
+        { threadId: `thread-${i % 2}`, mode: ["auto", "queue", "steer", "restart"][i % 4] },
+        { messageId: `message-${i}`, threadId: `thread-${i % 2}` },
+      ),
+    );
+    expect(summarizeT3ToolCalls("thread-send", [...calls, calls[0]!])).toEqual({
+      label: "Sent 5 messages to 2 threads",
+      failedCount: 0,
+      unfinishedCount: 0,
+    });
+  });
+
+  it("reads provider result envelopes without treating JSON in the message as result data", () => {
+    const result = { messageId: "message-1", threadId: "actual-thread" };
+    const json = JSON.stringify(result);
+    const outputs = [
+      result,
+      { structuredContent: result },
+      [{ type: "text", text: json }],
+      { content: [{ text: { text: json } }], isError: false },
+      json,
+    ];
+    const calls = outputs.map((output) =>
+      completed(
+        {
+          toolName: "t3_thread_send",
+          args: { threadId: "input-thread", message: '{"threadId":"fake"}' },
+        },
+        output,
+      ),
+    );
+    expect(summarizeT3ToolCalls("thread-send", calls).label).toBe("Sent 1 message to 1 thread");
+    expect(
+      summarizeT3ToolCalls("thread-send", [
+        completed({ toolName: "t3_thread_send", args: { threadId: "input-thread" } }),
+        completed({ threadId: "input-thread" }),
+      ]).label,
+    ).toBe("Sent 2 messages to 1 thread");
+  });
+
+  it("falls back to message counts when a destination is missing or a result is malformed", () => {
+    expect(
+      summarizeT3ToolCalls("thread-send", [
+        completed({ threadId: "known" }),
+        completed({ message: '{"threadId":"not-a-destination"}' }, "{truncated"),
+        completed(undefined, "Message sent"),
+      ]).label,
+    ).toBe("Sent 3 messages");
+  });
+
+  it("counts batch-created threads, excludes rollbacks, and deduplicates returned thread IDs", () => {
+    const threads = Array.from({ length: 4 }, (_, i) => ({
+      threadId: `thread-${i}`,
+      status: "running",
+    }));
+    expect(
+      summarizeT3ToolCalls("thread-create", [
+        completed(
+          {},
+          { threads: [...threads, { threadId: "rolled-back", status: "rolled_back" }] },
+        ),
+        completed({}, { threadId: "thread-0", status: "running" }),
+      ]).label,
+    ).toBe("Created 4 threads");
+    expect(
+      summarizeT3ToolCalls("thread-create", [
+        completed({ threads: [{ title: "Requested, not confirmed" }] }),
+      ]).label,
+    ).toBe("Requested thread creation 1 time");
+  });
+
+  it("excludes failed and unfinished sends even if the provider reports completed", () => {
+    const calls: T3ToolSummaryCall[] = [
+      completed({ threadId: "success" }, { messageId: "ok", threadId: "success" }),
+      completed(
+        { threadId: "failed" },
+        { isError: true, structuredContent: { threadId: "failed" } },
+      ),
+      completed({ threadId: "failed" }, [
+        { type: "text", text: JSON.stringify({ _tag: "OrchestratorMcpFailure" }) },
+      ]),
+      { input: { threadId: "cancelled" }, output: undefined, outcome: "unfinished" },
+    ];
+    expect(summarizeT3ToolCalls("thread-send", calls)).toEqual({
+      label: "Sent 1 message to 1 thread",
+      failedCount: 2,
+      unfinishedCount: 1,
+    });
+    expect(summarizeT3ToolCalls("thread-send", [calls[1]!])).toEqual({
+      label: "Tried to send 1 message to 1 thread",
+      failedCount: 1,
+      unfinishedCount: 0,
+    });
+  });
+
+  it("does not confuse a child's failure or wait timeout with failure of the orchestration call", () => {
+    const failedChild = { taskId: "task-1", status: "failed", summary: "command not found" };
+    expect(
+      summarizeT3ToolCalls("delegate", [completed({}, failedChild), completed({}, failedChild)]),
+    ).toEqual({
+      label: "Delegated 1 task",
+      failedCount: 0,
+      unfinishedCount: 0,
+    });
+    expect(
+      summarizeT3ToolCalls(
+        "task-status",
+        Array.from({ length: 4 }, () => completed({ taskId: "task-1" }, failedChild)),
+      ).label,
+    ).toBe("Checked task status 4 times");
+    expect(
+      summarizeT3ToolCalls("thread-wait", [
+        completed({ threadId: "thread-1" }, { threadId: "thread-1", timedOut: true }),
+      ]),
+    ).toEqual({
+      label: "Waited on 1 thread",
+      failedCount: 0,
+      unfinishedCount: 0,
+    });
+  });
+
+  it("describes control requests without claiming that a thread stopped or a task was deleted", () => {
+    expect(
+      summarizeT3ToolCalls("thread-interrupt", [
+        completed(
+          { threadId: "thread-1" },
+          { threadId: "thread-1", status: "interrupt_requested" },
+        ),
+      ]).label,
+    ).toBe("Requested interrupts for 1 thread");
+    expect(
+      summarizeT3ToolCalls("task-cancel", [
+        completed({ taskId: "task-1" }, { taskId: "task-1", status: "cancel_requested" }),
+      ]).label,
+    ).toBe("Requested cancellation of 1 task");
+    expect(
+      summarizeT3ToolCalls("schedule-delete", [
+        completed(
+          { scheduledTaskId: "schedule-1" },
+          { scheduledTaskId: "schedule-1", deleted: false },
+        ),
+      ]).label,
+    ).toBe("Requested deletion of 1 scheduled task");
+  });
+});
diff --git a/packages/client-runtime/src/t3ToolSummary.ts b/packages/client-runtime/src/t3ToolSummary.ts
new file mode 100644
index 000000000000..87649ee6096e
--- /dev/null
+++ b/packages/client-runtime/src/t3ToolSummary.ts
@@ -0,0 +1,191 @@
+import type { T3McpToolSummaryAction } from "@t3tools/shared/t3McpToolPresentation";
+
+export interface T3ToolSummaryCall {
+  readonly input: unknown;
+  readonly output: unknown;
+  readonly outcome: "completed" | "failed" | "unfinished";
+}
+
+function asRecord(value: unknown): Record<string, unknown> | undefined {
+  return value !== null && typeof value === "object" && !Array.isArray(value)
+    ? (value as Record<string, unknown>)
+    : undefined;
+}
+
+function id(value: unknown): string | undefined {
+  return typeof value === "string" && value.trim() !== "" ? value : undefined;
+}
+
+interface ToolResult {
+  readonly data?: Record<string, unknown>;
+  readonly failed: boolean;
+}
+
+/** Reads the structured/JSON MCP result envelopes retained by the provider adapters. */
+function readResult(value: unknown, depth = 0): ToolResult {
+  if (depth > 4) return { failed: false };
+  if (typeof value === "string") {
+    try {
+      return readResult(JSON.parse(value), depth + 1);
+    } catch {
+      return { failed: false };
+    }
+  }
+  if (Array.isArray(value)) {
+    let data: ToolResult["data"];
+    let failed = false;
+    for (const block of value) {
+      const text = asRecord(block)?.text;
+      const result = readResult(asRecord(text)?.text ?? text, depth + 1);
+      data ??= result.data;
+      failed ||= result.failed;
+    }
+    return { ...(data ? { data } : {}), failed };
+  }
+  const record = asRecord(value);
+  if (!record) return { failed: false };
+  const failed =
+    record.isError === true ||
+    record.is_error === true ||
+    record._tag === "OrchestratorMcpFailure" ||
+    record.error != null;
+  const content = record.structuredContent ?? record.content;
+  if (content !== undefined) {
+    const result = readResult(content, depth + 1);
+    return { ...(result.data ? { data: result.data } : {}), failed: failed || result.failed };
+  }
+  return { data: record, failed };
+}
+
+function readInput(value: unknown): Record<string, unknown> | undefined {
+  const input = readResult(value).data;
+  // Cursor retains its MCP args envelope; other adapters retain the arguments directly.
+  return input && typeof input.toolName === "string" ? asRecord(input.args) : input;
+}
+
+function countEntities(ids: ReadonlyArray<string | undefined>): number {
+  return (
+    new Set(ids.filter((value) => value !== undefined)).size +
+    ids.filter((value) => value === undefined).length
+  );
+}
+
+function quantity(count: number, noun: string): string {
+  return `${count} ${noun}${count === 1 ? "" : "s"}`;
+}
+
+/** Counts successful effects separately from failed or unfinished tool calls. */
+export function summarizeT3ToolCalls(
+  action: T3McpToolSummaryAction,
+  calls: ReadonlyArray<T3ToolSummaryCall>,
+): { label: string; failedCount: number; unfinishedCount: number } {
+  const results = calls.map((call) => {
+    const result = readResult(call.output);
+    return {
+      input: readInput(call.input),
+      output: result.data,
+      outcome: result.failed ? ("failed" as const) : call.outcome,
+    };
+  });
+  const completed = results.filter((call) => call.outcome === "completed");
+  const failedCount = results.filter((call) => call.outcome === "failed").length;
+  const unfinishedCount = results.filter((call) => call.outcome === "unfinished").length;
+  const selected = completed.length > 0 ? completed : results;
+  const times = quantity(selected.length, "time");
+  const phrase = (past: string, infinitive: string, object: string) =>
+    `${completed.length > 0 ? past : `Tried to ${infinitive}`} ${object}`;
+  const entityIds = (key: string) =>
+    selected.map((call) => id(call.output?.[key]) ?? id(call.input?.[key]));
+  const threadIds = selected.map(
+    (call) =>
+      id(call.output?.threadId) ??
+      id(asRecord(call.output?.thread)?.threadId) ??
+      id(call.input?.threadId),
+  );
+  let label: string;
+  switch (action) {
+    case "thread-send": {
+      const messages = countEntities(selected.map((call) => id(call.output?.messageId)));
+      const targetsKnown = threadIds.every((value) => value !== undefined);
+      const threads = new Set(threadIds).size;
+      const object = targetsKnown
+        ? messages === threads && messages > 1
+          ? `messages to ${quantity(threads, "thread")}`
+          : `${quantity(messages, "message")} to ${quantity(threads, "thread")}`
+        : quantity(messages, "message");
+      label = phrase("Sent", "send", object);
+      break;
+    }
+    case "thread-create": {
+      const createdIds: string[] = [];
+      const resultsKnown =
+        completed.length > 0 &&
+        completed.every((call) => {
+          const threads = Array.isArray(call.output?.threads) ? call.output.threads : [call.output];
+          return threads.every((thread) => {
+            const record = asRecord(thread);
+            if (record?.status === "rolled_back") return true;
+            const threadId = id(record?.threadId);
+            if (!threadId) return false;
+            createdIds.push(threadId);
+            return true;
+          });
+        });
+      label = resultsKnown
+        ? `Created ${quantity(new Set(createdIds).size, "thread")}`
+        : `Requested thread creation ${times}`;
+      break;
+    }
+    case "delegate":
+      label = phrase("Delegated", "delegate", quantity(countEntities(entityIds("taskId")), "task"));
+      break;
+    case "thread-read":
+    case "thread-wait": {
+      const targets = threadIds.every((value) => value !== undefined)
+        ? quantity(new Set(threadIds).size, "thread")
+        : `threads ${times}`;
+      label =
+        action === "thread-read"
+          ? phrase("Read", "read", targets)
+          : phrase("Waited on", "wait on", targets);
+      break;
+    }
+    case "thread-list":
+      label = phrase("Listed", "list", `threads ${times}`);
+      break;
+    case "thread-interrupt":
+      label = `Requested interrupts for ${quantity(countEntities(threadIds), "thread")}`;
+      break;
+    case "task-status":
+      label = phrase("Checked", "check", `task status ${times}`);
+      break;
+    case "task-cancel":
+      label = `Requested cancellation of ${quantity(countEntities(entityIds("taskId")), "task")}`;
+      break;
+    case "schedule-create":
+      label = phrase(
+        "Scheduled",
+        "schedule",
+        quantity(countEntities(entityIds("scheduledTaskId")), "task"),
+      );
+      break;
+    case "schedule-list":
+      label = phrase("Listed", "list", `scheduled tasks ${times}`);
+      break;
+    case "schedule-update":
+      label = phrase(
+        "Updated",
+        "update",
+        quantity(countEntities(entityIds("scheduledTaskId")), "scheduled task"),
+      );
+      break;
+    case "schedule-delete":
+      // A successful delete can report deleted:false; it still represents a deletion request.
+      label = `Requested deletion of ${quantity(countEntities(entityIds("scheduledTaskId")), "scheduled task")}`;
+      break;
+    case "capabilities":
+      label = phrase("Checked", "check", `orchestration capabilities ${times}`);
+      break;
+  }
+  return { label, failedCount, unfinishedCount };
+}
diff --git a/packages/contracts/package.json b/packages/contracts/package.json
index 1e28168d972f..0c8bd85226c3 100644
--- a/packages/contracts/package.json
+++ b/packages/contracts/package.json
@@ -18,6 +18,10 @@
     "./relay": {
       "types": "./src/relay.ts",
       "import": "./src/relay.ts"
+    },
+    "./legacy-orchestration": {
+      "types": "./src/orchestration.ts",
+      "import": "./src/orchestration.ts"
     }
   },
   "scripts": {
diff --git a/packages/contracts/src/applicationEvent.test.ts b/packages/contracts/src/applicationEvent.test.ts
new file mode 100644
index 000000000000..32171b8d5420
--- /dev/null
+++ b/packages/contracts/src/applicationEvent.test.ts
@@ -0,0 +1,63 @@
+import { describe, expect, it } from "@effect/vitest";
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+
+import { ApplicationProjectEvent } from "./applicationEvent.ts";
+
+const decodeApplicationProjectEvent = Schema.decodeUnknownEffect(ApplicationProjectEvent);
+
+describe("application project events", () => {
+  it.effect("decodes project events without the legacy thread event contract", () =>
+    Effect.gen(function* () {
+      const event = yield* decodeApplicationProjectEvent({
+        sequence: 12,
+        eventId: "event-project-12",
+        aggregateKind: "project",
+        aggregateId: "project-1",
+        occurredAt: "2026-06-24T12:00:00.000Z",
+        commandId: "command-project-12",
+        causationEventId: null,
+        correlationId: "command-project-12",
+        metadata: {},
+        type: "project.created",
+        payload: {
+          projectId: "project-1",
+          title: "Project",
+          workspaceRoot: "/tmp/project",
+          defaultModelSelection: null,
+          scripts: [],
+          createdAt: "2026-06-24T12:00:00.000Z",
+          updatedAt: "2026-06-24T12:00:00.000Z",
+        },
+      });
+
+      expect(event.type).toBe("project.created");
+      expect(event.payload.projectId).toBe("project-1");
+    }),
+  );
+
+  it.effect("rejects a project event carrying a thread aggregate", () =>
+    Effect.gen(function* () {
+      const result = yield* Effect.result(
+        decodeApplicationProjectEvent({
+          sequence: 12,
+          eventId: "event-project-12",
+          aggregateKind: "thread",
+          aggregateId: "project-1",
+          occurredAt: "2026-06-24T12:00:00.000Z",
+          commandId: null,
+          causationEventId: null,
+          correlationId: null,
+          metadata: {},
+          type: "project.deleted",
+          payload: {
+            projectId: "project-1",
+            deletedAt: "2026-06-24T12:00:00.000Z",
+          },
+        }),
+      );
+
+      expect(result._tag).toBe("Failure");
+    }),
+  );
+});
diff --git a/packages/contracts/src/applicationEvent.ts b/packages/contracts/src/applicationEvent.ts
new file mode 100644
index 000000000000..a868d76c1364
--- /dev/null
+++ b/packages/contracts/src/applicationEvent.ts
@@ -0,0 +1,120 @@
+import * as Schema from "effect/Schema";
+
+import {
+  ApprovalRequestId,
+  ClientSurface,
+  CommandId,
+  EventId,
+  IsoDateTime,
+  NonNegativeInt,
+  ProjectId,
+  ProviderItemId,
+  TrimmedNonEmptyString,
+} from "./baseSchemas.ts";
+import { RepositoryIdentity, ThreadEnvMode } from "./environment.ts";
+import { ModelSelection } from "./modelSelection.ts";
+import type { OrchestrationV2StoredEvent } from "./orchestrationV2.ts";
+import { ProjectScript } from "./project.ts";
+
+/**
+ * Which client dispatched the command that produced this event (#7774).
+ * Stamped by the orchestration engine on client-dispatched commands; absent on
+ * provider/server-originated events and on commands from clients too old to
+ * report it.
+ */
+export const OrchestrationClientOrigin = Schema.Struct({
+  surface: Schema.optional(ClientSurface),
+  appVersion: Schema.optional(TrimmedNonEmptyString),
+});
+export type OrchestrationClientOrigin = typeof OrchestrationClientOrigin.Type;
+
+/** Metadata retained by the shared application event source. */
+export const ApplicationEventMetadata = Schema.Struct({
+  providerTurnId: Schema.optional(TrimmedNonEmptyString),
+  providerItemId: Schema.optional(ProviderItemId),
+  adapterKey: Schema.optional(TrimmedNonEmptyString),
+  requestId: Schema.optional(ApprovalRequestId),
+  ingestedAt: Schema.optional(IsoDateTime),
+  origin: Schema.optional(OrchestrationClientOrigin),
+});
+export type ApplicationEventMetadata = typeof ApplicationEventMetadata.Type;
+
+export const ApplicationProjectCreatedPayload = Schema.Struct({
+  projectId: ProjectId,
+  title: TrimmedNonEmptyString,
+  workspaceRoot: TrimmedNonEmptyString,
+  repositoryIdentity: Schema.optional(Schema.NullOr(RepositoryIdentity)),
+  defaultModelSelection: Schema.NullOr(ModelSelection),
+  // Per-project override for where new threads start; optional so persisted
+  // events from older servers still decode.
+  defaultThreadEnvMode: Schema.optional(Schema.NullOr(ThreadEnvMode)),
+  // Optional so persisted events from older servers still decode.
+  faviconPath: Schema.optional(Schema.NullOr(TrimmedNonEmptyString)),
+  scripts: Schema.Array(ProjectScript),
+  createdAt: IsoDateTime,
+  updatedAt: IsoDateTime,
+});
+export type ApplicationProjectCreatedPayload = typeof ApplicationProjectCreatedPayload.Type;
+
+export const ApplicationProjectMetaUpdatedPayload = Schema.Struct({
+  projectId: ProjectId,
+  title: Schema.optional(TrimmedNonEmptyString),
+  workspaceRoot: Schema.optional(TrimmedNonEmptyString),
+  repositoryIdentity: Schema.optional(Schema.NullOr(RepositoryIdentity)),
+  defaultModelSelection: Schema.optional(Schema.NullOr(ModelSelection)),
+  // Absent = leave unchanged; null = clear the override.
+  defaultThreadEnvMode: Schema.optional(Schema.NullOr(ThreadEnvMode)),
+  faviconPath: Schema.optional(Schema.NullOr(TrimmedNonEmptyString)),
+  scripts: Schema.optional(Schema.Array(ProjectScript)),
+  updatedAt: IsoDateTime,
+});
+export type ApplicationProjectMetaUpdatedPayload = typeof ApplicationProjectMetaUpdatedPayload.Type;
+
+export const ApplicationProjectDeletedPayload = Schema.Struct({
+  projectId: ProjectId,
+  deletedAt: IsoDateTime,
+});
+export type ApplicationProjectDeletedPayload = typeof ApplicationProjectDeletedPayload.Type;
+
+const ApplicationProjectEventBaseFields = {
+  sequence: NonNegativeInt,
+  eventId: EventId,
+  aggregateKind: Schema.Literal("project"),
+  aggregateId: ProjectId,
+  occurredAt: IsoDateTime,
+  commandId: Schema.NullOr(CommandId),
+  causationEventId: Schema.NullOr(EventId),
+  correlationId: Schema.NullOr(CommandId),
+  metadata: ApplicationEventMetadata,
+} as const;
+
+export const ApplicationProjectCreatedEvent = Schema.Struct({
+  ...ApplicationProjectEventBaseFields,
+  type: Schema.Literal("project.created"),
+  payload: ApplicationProjectCreatedPayload,
+});
+export type ApplicationProjectCreatedEvent = typeof ApplicationProjectCreatedEvent.Type;
+
+export const ApplicationProjectMetaUpdatedEvent = Schema.Struct({
+  ...ApplicationProjectEventBaseFields,
+  type: Schema.Literal("project.meta-updated"),
+  payload: ApplicationProjectMetaUpdatedPayload,
+});
+export type ApplicationProjectMetaUpdatedEvent = typeof ApplicationProjectMetaUpdatedEvent.Type;
+
+export const ApplicationProjectDeletedEvent = Schema.Struct({
+  ...ApplicationProjectEventBaseFields,
+  type: Schema.Literal("project.deleted"),
+  payload: ApplicationProjectDeletedPayload,
+});
+export type ApplicationProjectDeletedEvent = typeof ApplicationProjectDeletedEvent.Type;
+
+export const ApplicationProjectEvent = Schema.Union([
+  ApplicationProjectCreatedEvent,
+  ApplicationProjectMetaUpdatedEvent,
+  ApplicationProjectDeletedEvent,
+]);
+export type ApplicationProjectEvent = typeof ApplicationProjectEvent.Type;
+
+/** Events exposed by the retained application event source. */
+export type ApplicationStoredEvent = ApplicationProjectEvent | OrchestrationV2StoredEvent;
diff --git a/packages/contracts/src/assets.test.ts b/packages/contracts/src/assets.test.ts
index c47c53b2a84e..9e4ba486b48a 100644
--- a/packages/contracts/src/assets.test.ts
+++ b/packages/contracts/src/assets.test.ts
@@ -5,7 +5,7 @@ import { AttachmentCreateUploadUrlInput } from "./assets.ts";
 import {
   PROVIDER_SEND_TURN_MAX_FILE_BYTES,
   PROVIDER_SEND_TURN_MAX_IMAGE_BYTES,
-} from "./orchestration.ts";
+} from "./chatAttachment.ts";
 
 const isUploadInput = Schema.is(AttachmentCreateUploadUrlInput);
 
diff --git a/packages/contracts/src/assets.ts b/packages/contracts/src/assets.ts
index 1a2b50fc6e7c..456c56ab879a 100644
--- a/packages/contracts/src/assets.ts
+++ b/packages/contracts/src/assets.ts
@@ -5,8 +5,8 @@ import {
   PROVIDER_SEND_TURN_MAX_FILE_BYTES,
   PROVIDER_SEND_TURN_MAX_IMAGE_BYTES,
   PROVIDER_SEND_TURN_SUPPORTED_IMAGE_MIME_TYPES,
-  ProjectFaviconPath,
-} from "./orchestration.ts";
+} from "./chatAttachment.ts";
+import { ProjectFaviconPath } from "./orchestration.ts";
 
 const ASSET_PATH_MAX_LENGTH = 1024;
 
diff --git a/packages/contracts/src/baseSchemas.ts b/packages/contracts/src/baseSchemas.ts
index aa6360a04edd..501b03b59db6 100644
--- a/packages/contracts/src/baseSchemas.ts
+++ b/packages/contracts/src/baseSchemas.ts
@@ -80,6 +80,12 @@ export const MessageId = makeEntityId("MessageId");
 export type MessageId = typeof MessageId.Type;
 export const TurnId = makeEntityId("TurnId");
 export type TurnId = typeof TurnId.Type;
+export const RunId = makeEntityId("RunId");
+export type RunId = typeof RunId.Type;
+export const RunAttemptId = makeEntityId("RunAttemptId");
+export type RunAttemptId = typeof RunAttemptId.Type;
+export const NodeId = makeEntityId("NodeId");
+export type NodeId = typeof NodeId.Type;
 export const AuthSessionId = makeEntityId("AuthSessionId");
 export type AuthSessionId = typeof AuthSessionId.Type;
 export const RpcClientId = NonNegativeInt.pipe(Schema.brand("RpcClientId"));
@@ -117,15 +123,37 @@ export type ClientConnectionMethod = typeof ClientConnectionMethod.Type;
 
 export const ProviderItemId = makeEntityId("ProviderItemId");
 export type ProviderItemId = typeof ProviderItemId.Type;
+export const ProviderSessionId = makeEntityId("ProviderSessionId");
+export type ProviderSessionId = typeof ProviderSessionId.Type;
+export const ProviderThreadId = makeEntityId("ProviderThreadId");
+export type ProviderThreadId = typeof ProviderThreadId.Type;
+export const ProviderTurnId = makeEntityId("ProviderTurnId");
+export type ProviderTurnId = typeof ProviderTurnId.Type;
 export const RuntimeSessionId = makeEntityId("RuntimeSessionId");
 export type RuntimeSessionId = typeof RuntimeSessionId.Type;
 export const RuntimeItemId = makeEntityId("RuntimeItemId");
 export type RuntimeItemId = typeof RuntimeItemId.Type;
+export const TurnItemId = makeEntityId("TurnItemId");
+export type TurnItemId = typeof TurnItemId.Type;
 export const RuntimeRequestId = makeEntityId("RuntimeRequestId");
 export type RuntimeRequestId = typeof RuntimeRequestId.Type;
 export const RuntimeTaskId = makeEntityId("RuntimeTaskId");
 export type RuntimeTaskId = typeof RuntimeTaskId.Type;
+export const ScheduledTaskId = makeEntityId("ScheduledTaskId");
+export type ScheduledTaskId = typeof ScheduledTaskId.Type;
 export const ApprovalRequestId = makeEntityId("ApprovalRequestId");
 export type ApprovalRequestId = typeof ApprovalRequestId.Type;
 export const CheckpointRef = makeEntityId("CheckpointRef");
 export type CheckpointRef = typeof CheckpointRef.Type;
+export const CheckpointId = makeEntityId("CheckpointId");
+export type CheckpointId = typeof CheckpointId.Type;
+export const CheckpointScopeId = makeEntityId("CheckpointScopeId");
+export type CheckpointScopeId = typeof CheckpointScopeId.Type;
+export const ContextHandoffId = makeEntityId("ContextHandoffId");
+export type ContextHandoffId = typeof ContextHandoffId.Type;
+export const ContextTransferId = makeEntityId("ContextTransferId");
+export type ContextTransferId = typeof ContextTransferId.Type;
+export const RawEventId = makeEntityId("RawEventId");
+export type RawEventId = typeof RawEventId.Type;
+export const PlanId = makeEntityId("PlanId");
+export type PlanId = typeof PlanId.Type;
diff --git a/packages/contracts/src/chatAttachment.ts b/packages/contracts/src/chatAttachment.ts
new file mode 100644
index 000000000000..fd744c098427
--- /dev/null
+++ b/packages/contracts/src/chatAttachment.ts
@@ -0,0 +1,114 @@
+import * as Schema from "effect/Schema";
+
+import { MessageId, NonNegativeInt, ThreadId, TrimmedNonEmptyString } from "./baseSchemas.ts";
+
+export const PROVIDER_SEND_TURN_MAX_INPUT_CHARS = 120_000;
+export const PROVIDER_SEND_TURN_MAX_ATTACHMENTS = 8;
+export const PROVIDER_SEND_TURN_MAX_IMAGE_BYTES = 10 * 1024 * 1024;
+export const PROVIDER_SEND_TURN_MAX_FILE_BYTES = 50 * 1024 * 1024;
+export const PROVIDER_SEND_TURN_SUPPORTED_IMAGE_MIME_TYPES = [
+  "image/gif",
+  "image/jpeg",
+  "image/png",
+  "image/webp",
+] as const;
+const PROVIDER_SEND_TURN_SUPPORTED_IMAGE_MIME_TYPE_SET = new Set<string>(
+  PROVIDER_SEND_TURN_SUPPORTED_IMAGE_MIME_TYPES,
+);
+
+/** Whether a pasted or picked image mime type can be sent on a provider turn. */
+export function isProviderSendTurnSupportedImageMimeType(mimeType: string): boolean {
+  return PROVIDER_SEND_TURN_SUPPORTED_IMAGE_MIME_TYPE_SET.has(mimeType.toLowerCase());
+}
+const PROVIDER_SEND_TURN_MAX_IMAGE_DATA_URL_CHARS = 14_000_000;
+const CHAT_ATTACHMENT_ID_MAX_CHARS = 128;
+
+export const ChatAttachmentId = TrimmedNonEmptyString.check(
+  Schema.isMaxLength(CHAT_ATTACHMENT_ID_MAX_CHARS),
+  Schema.isPattern(/^[a-z0-9_-]+$/i),
+);
+export type ChatAttachmentId = typeof ChatAttachmentId.Type;
+
+export const ChatImageAttachment = Schema.Struct({
+  type: Schema.Literal("image"),
+  id: ChatAttachmentId,
+  name: TrimmedNonEmptyString.check(Schema.isMaxLength(255)),
+  mimeType: TrimmedNonEmptyString.check(Schema.isMaxLength(100), Schema.isPattern(/^image\//i)),
+  sizeBytes: NonNegativeInt.check(Schema.isLessThanOrEqualTo(PROVIDER_SEND_TURN_MAX_IMAGE_BYTES)),
+});
+export type ChatImageAttachment = typeof ChatImageAttachment.Type;
+
+export const ChatFileAttachment = Schema.Struct({
+  type: Schema.Literal("file"),
+  id: ChatAttachmentId,
+  name: TrimmedNonEmptyString.check(Schema.isMaxLength(255)),
+  mimeType: TrimmedNonEmptyString.check(Schema.isMaxLength(100)),
+  sizeBytes: NonNegativeInt.check(
+    Schema.isGreaterThanOrEqualTo(1),
+    Schema.isLessThanOrEqualTo(PROVIDER_SEND_TURN_MAX_FILE_BYTES),
+  ),
+});
+export type ChatFileAttachment = typeof ChatFileAttachment.Type;
+
+/**
+ * Catch-all for attachment types this build does not know. Attachments ride on
+ * persisted events and thread streams, so a newer server or client must be able
+ * to introduce a type without making older readers fail to decode the whole
+ * message. Decoders keep the shared base fields; consumers skip these or render
+ * them as unsupported. Mirrors how `OrchestrationThreadActivity` keeps `kind`
+ * open. The known discriminators are excluded so a malformed image or file
+ * attachment fails its own schema instead of sliding through here with its
+ * size and mime constraints unchecked.
+ */
+export const ChatUnknownAttachment = Schema.Struct({
+  type: TrimmedNonEmptyString.check(
+    Schema.isMaxLength(50),
+    Schema.isPattern(/^(?!(?:image|file)$)/),
+  ),
+  id: ChatAttachmentId,
+  name: TrimmedNonEmptyString.check(Schema.isMaxLength(255)),
+  mimeType: TrimmedNonEmptyString.check(Schema.isMaxLength(100)),
+  sizeBytes: NonNegativeInt,
+});
+export type ChatUnknownAttachment = typeof ChatUnknownAttachment.Type;
+
+export const UploadChatImageAttachment = Schema.Struct({
+  type: Schema.Literal("image"),
+  name: TrimmedNonEmptyString.check(Schema.isMaxLength(255)),
+  mimeType: TrimmedNonEmptyString.check(Schema.isMaxLength(100), Schema.isPattern(/^image\//i)),
+  sizeBytes: NonNegativeInt.check(Schema.isLessThanOrEqualTo(PROVIDER_SEND_TURN_MAX_IMAGE_BYTES)),
+  dataUrl: TrimmedNonEmptyString.check(
+    Schema.isMaxLength(PROVIDER_SEND_TURN_MAX_IMAGE_DATA_URL_CHARS),
+  ),
+});
+export type UploadChatImageAttachment = typeof UploadChatImageAttachment.Type;
+
+export const ChatAttachment = Schema.Union([
+  ChatImageAttachment,
+  ChatFileAttachment,
+  ChatUnknownAttachment,
+]);
+export type ChatAttachment = typeof ChatAttachment.Type;
+
+export const UploadChatAttachment = Schema.Union([UploadChatImageAttachment]);
+export type UploadChatAttachment = typeof UploadChatAttachment.Type;
+
+export const PersistChatAttachmentsInput = Schema.Struct({
+  threadId: ThreadId,
+  messageId: MessageId,
+  attachments: Schema.Array(UploadChatAttachment),
+});
+export type PersistChatAttachmentsInput = typeof PersistChatAttachmentsInput.Type;
+
+export const PersistChatAttachmentsResult = Schema.Struct({
+  attachments: Schema.Array(ChatAttachment),
+});
+export type PersistChatAttachmentsResult = typeof PersistChatAttachmentsResult.Type;
+
+export class PersistChatAttachmentsError extends Schema.TaggedErrorClass<PersistChatAttachmentsError>()(
+  "PersistChatAttachmentsError",
+  {
+    message: Schema.String,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {}
diff --git a/packages/contracts/src/checkpointDiff.ts b/packages/contracts/src/checkpointDiff.ts
new file mode 100644
index 000000000000..9621765e64e6
--- /dev/null
+++ b/packages/contracts/src/checkpointDiff.ts
@@ -0,0 +1,65 @@
+import * as Schema from "effect/Schema";
+import * as SchemaIssue from "effect/SchemaIssue";
+import * as Struct from "effect/Struct";
+
+import { NonNegativeInt, ThreadId, TrimmedNonEmptyString } from "./baseSchemas.ts";
+
+export const TurnCountRange = Schema.Struct({
+  fromTurnCount: NonNegativeInt,
+  toTurnCount: NonNegativeInt,
+}).check(
+  Schema.makeFilter(
+    (input) =>
+      input.fromTurnCount <= input.toTurnCount ||
+      new SchemaIssue.InvalidValue({
+        message: "fromTurnCount must be less than or equal to toTurnCount",
+      }),
+    { identifier: "OrchestrationTurnDiffRange" },
+  ),
+);
+
+export const ThreadTurnDiff = TurnCountRange.mapFields(
+  Struct.assign({
+    threadId: ThreadId,
+    diff: Schema.String,
+  }),
+  { unsafePreserveChecks: true },
+);
+
+export const OrchestrationGetTurnDiffInput = TurnCountRange.mapFields(
+  Struct.assign({
+    threadId: ThreadId,
+    ignoreWhitespace: Schema.optionalKey(Schema.Boolean),
+  }),
+  { unsafePreserveChecks: true },
+);
+export type OrchestrationGetTurnDiffInput = typeof OrchestrationGetTurnDiffInput.Type;
+
+export const OrchestrationGetTurnDiffResult = ThreadTurnDiff;
+export type OrchestrationGetTurnDiffResult = typeof OrchestrationGetTurnDiffResult.Type;
+
+export const OrchestrationGetFullThreadDiffInput = Schema.Struct({
+  threadId: ThreadId,
+  toTurnCount: NonNegativeInt,
+  ignoreWhitespace: Schema.optionalKey(Schema.Boolean),
+});
+export type OrchestrationGetFullThreadDiffInput = typeof OrchestrationGetFullThreadDiffInput.Type;
+
+export const OrchestrationGetFullThreadDiffResult = ThreadTurnDiff;
+export type OrchestrationGetFullThreadDiffResult = typeof OrchestrationGetFullThreadDiffResult.Type;
+
+export class OrchestrationGetTurnDiffError extends Schema.TaggedErrorClass<OrchestrationGetTurnDiffError>()(
+  "OrchestrationGetTurnDiffError",
+  {
+    message: TrimmedNonEmptyString,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {}
+
+export class OrchestrationGetFullThreadDiffError extends Schema.TaggedErrorClass<OrchestrationGetFullThreadDiffError>()(
+  "OrchestrationGetFullThreadDiffError",
+  {
+    message: TrimmedNonEmptyString,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {}
diff --git a/packages/contracts/src/environment.ts b/packages/contracts/src/environment.ts
index 805e9da23ebb..4710596fa3d3 100644
--- a/packages/contracts/src/environment.ts
+++ b/packages/contracts/src/environment.ts
@@ -3,6 +3,12 @@ import * as Schema from "effect/Schema";
 
 import { EnvironmentId, ProjectId, ThreadId, TrimmedNonEmptyString } from "./baseSchemas.ts";
 
+/** Wire version for orchestration snapshots, streams, commands, and RPC payloads. */
+export const ORCHESTRATION_PROTOCOL_VERSION = 2;
+export const ORCHESTRATION_PROTOCOL_VERSION_TEXT = "2";
+export const ORCHESTRATION_PROTOCOL_QUERY_PARAM = "orchestrationProtocol";
+export const ORCHESTRATION_PROTOCOL_HEADER = "x-t3-orchestration-protocol";
+
 export const ExecutionEnvironmentPlatformOs = Schema.Literals([
   "darwin",
   "linux",
@@ -80,6 +86,11 @@ export const ExecutionEnvironmentCapabilities = Schema.Struct({
   /** Server understands regenerateTitle on thread.meta.update. Absent on
       older servers, so clients hide the action instead of sending it. */
   threadTitleRegeneration: Schema.optionalKey(Schema.Boolean),
+  /** Server understands thread.visit / thread.mark-unread commands and
+      projects lastVisitedAt on thread shells. Same version-skew contract as
+      threadSettlement: clients keep their local visited state against
+      servers that lack this. */
+  threadVisitedTracking: Schema.optionalKey(Schema.Boolean),
   /** Server persists a pull request reference on thread.meta.update. */
   threadPullRequestLinking: Schema.optionalKey(Schema.Boolean),
   /** The update path clients should offer for this server. Absent on
@@ -103,6 +114,8 @@ export const ExecutionEnvironmentDescriptor = Schema.Struct({
   label: TrimmedNonEmptyString,
   platform: ExecutionEnvironmentPlatform,
   serverVersion: TrimmedNonEmptyString,
+  /** Absent on hosts from before explicit orchestration protocol negotiation. */
+  orchestrationProtocolVersion: Schema.optionalKey(Schema.Int),
   capabilities: ExecutionEnvironmentCapabilities,
 });
 export type ExecutionEnvironmentDescriptor = typeof ExecutionEnvironmentDescriptor.Type;
diff --git a/packages/contracts/src/environmentHttp.ts b/packages/contracts/src/environmentHttp.ts
index a895697e36b0..f223bde3b545 100644
--- a/packages/contracts/src/environmentHttp.ts
+++ b/packages/contracts/src/environmentHttp.ts
@@ -24,20 +24,24 @@ import {
   AuthWebSocketTicketResult,
   ServerAuthSessionMethod,
 } from "./auth.ts";
+import {
+  ExecutionEnvironmentDescriptor,
+  ORCHESTRATION_PROTOCOL_HEADER,
+  ORCHESTRATION_PROTOCOL_VERSION_TEXT,
+} from "./environment.ts";
 import {
   DpopFailureReason,
   AuthSessionId,
   ThreadId,
   TrimmedNonEmptyString,
 } from "./baseSchemas.ts";
-import { ExecutionEnvironmentDescriptor } from "./environment.ts";
 import {
-  ClientOrchestrationCommand,
-  DispatchResult,
-  OrchestrationReadModel,
-  OrchestrationShellSnapshot,
-  OrchestrationThreadDetailSnapshot,
-} from "./orchestration.ts";
+  OrchestrationV2ShellSnapshot,
+  OrchestrationV2ThreadBoundedSnapshot,
+  OrchestrationV2ThreadDetailSnapshot,
+  OrchestrationV2ThreadHistoryPage,
+} from "./orchestrationV2.ts";
+import { Project, ProjectMutation, ProjectSnapshot } from "./project.ts";
 import {
   PullRequestDiffInput,
   PullRequestDiffResult,
@@ -59,6 +63,12 @@ const OptionalBearerHeaders = Schema.Struct({
   dpop: Schema.optionalKey(Schema.String),
 });
 
+const OrchestrationProtocolHeaders = Schema.Struct({
+  authorization: Schema.optionalKey(Schema.String),
+  dpop: Schema.optionalKey(Schema.String),
+  [ORCHESTRATION_PROTOCOL_HEADER]: Schema.Literal(ORCHESTRATION_PROTOCOL_VERSION_TEXT),
+});
+
 const OptionalDpopProofHeaders = Schema.Struct({
   dpop: Schema.optionalKey(Schema.String),
 });
@@ -67,6 +77,7 @@ export const EnvironmentRequestInvalidReason = Schema.Literals([
   "invalid_scope",
   "scope_not_granted",
   "invalid_command",
+  "invalid_history_cursor",
 ]);
 export type EnvironmentRequestInvalidReason = typeof EnvironmentRequestInvalidReason.Type;
 
@@ -92,9 +103,12 @@ export const EnvironmentInternalErrorReason = Schema.Literals([
   "pairing_link_revoke_failed",
   "client_sessions_load_failed",
   "client_session_revoke_failed",
+  "project_snapshot_failed",
+  "project_mutation_failed",
   "orchestration_snapshot_failed",
   "orchestration_thread_snapshot_failed",
-  "orchestration_dispatch_failed",
+  "orchestration_thread_bounded_snapshot_failed",
+  "orchestration_thread_history_failed",
   "internal_error",
 ]);
 export type EnvironmentInternalErrorReason = typeof EnvironmentInternalErrorReason.Type;
@@ -323,6 +337,10 @@ const EnvironmentSessionRevokeErrors = [
   EnvironmentOperationForbiddenError,
   EnvironmentInternalError,
 ] as const;
+const EnvironmentProjectSnapshotErrors = [
+  EnvironmentScopeRequiredError,
+  EnvironmentInternalError,
+] as const;
 const EnvironmentOrchestrationSnapshotErrors = [
   EnvironmentScopeRequiredError,
   EnvironmentInternalError,
@@ -332,7 +350,7 @@ const EnvironmentOrchestrationThreadSnapshotErrors = [
   EnvironmentResourceNotFoundError,
   EnvironmentInternalError,
 ] as const;
-const EnvironmentOrchestrationDispatchErrors = [
+const EnvironmentProjectMutationErrors = [
   EnvironmentRequestInvalidError,
   EnvironmentScopeRequiredError,
   EnvironmentInternalError,
@@ -494,46 +512,65 @@ const EnvironmentOrchestrationThreadSnapshotParams = Schema.Struct({
   threadId: ThreadId,
 });
 
-// Query-string window for windowed thread snapshots (GET payloads must encode
-// to strings). Both fields optional: omitting them keeps the full-snapshot
-// behavior, so pagination stays opt-in per request.
-const EnvironmentOrchestrationThreadSnapshotQuery = {
-  turnLimit: Schema.optional(
-    Schema.FiniteFromString.check(Schema.isInt(), Schema.isGreaterThanOrEqualTo(1)),
-  ),
-  beforeCursor: Schema.optional(TrimmedNonEmptyString),
-};
+const EnvironmentOrchestrationThreadHistoryQuery = Schema.Struct({
+  cursor: TrimmedNonEmptyString,
+});
+
+const EnvironmentOrchestrationThreadHistoryErrors = [
+  EnvironmentRequestInvalidError,
+  EnvironmentScopeRequiredError,
+  EnvironmentResourceNotFoundError,
+  EnvironmentInternalError,
+] as const;
 
 export class EnvironmentOrchestrationHttpApi extends HttpApiGroup.make("orchestration")
   .add(
-    HttpApiEndpoint.get("snapshot", "/api/orchestration/snapshot", {
-      headers: OptionalBearerHeaders,
-      success: OrchestrationReadModel,
+    HttpApiEndpoint.get("shellSnapshot", "/api/orchestration/shell", {
+      headers: OrchestrationProtocolHeaders,
+      success: OrchestrationV2ShellSnapshot,
       error: EnvironmentOrchestrationSnapshotErrors,
     }).middleware(EnvironmentAuthenticatedAuth),
   )
   .add(
-    HttpApiEndpoint.get("shellSnapshot", "/api/orchestration/shell", {
-      headers: OptionalBearerHeaders,
-      success: OrchestrationShellSnapshot,
-      error: EnvironmentOrchestrationSnapshotErrors,
+    HttpApiEndpoint.get("threadSnapshot", "/api/orchestration/threads/:threadId", {
+      headers: OrchestrationProtocolHeaders,
+      params: EnvironmentOrchestrationThreadSnapshotParams,
+      success: OrchestrationV2ThreadDetailSnapshot,
+      error: EnvironmentOrchestrationThreadSnapshotErrors,
     }).middleware(EnvironmentAuthenticatedAuth),
   )
   .add(
-    HttpApiEndpoint.get("threadSnapshot", "/api/orchestration/threads/:threadId", {
-      headers: OptionalBearerHeaders,
+    HttpApiEndpoint.get("threadBoundedSnapshot", "/api/orchestration/threads/:threadId/bounded", {
+      headers: OrchestrationProtocolHeaders,
       params: EnvironmentOrchestrationThreadSnapshotParams,
-      payload: EnvironmentOrchestrationThreadSnapshotQuery,
-      success: OrchestrationThreadDetailSnapshot,
+      success: OrchestrationV2ThreadBoundedSnapshot,
       error: EnvironmentOrchestrationThreadSnapshotErrors,
     }).middleware(EnvironmentAuthenticatedAuth),
   )
   .add(
-    HttpApiEndpoint.post("dispatch", "/api/orchestration/dispatch", {
+    HttpApiEndpoint.get("threadHistoryPage", "/api/orchestration/threads/:threadId/history", {
+      headers: OrchestrationProtocolHeaders,
+      params: EnvironmentOrchestrationThreadSnapshotParams,
+      query: EnvironmentOrchestrationThreadHistoryQuery,
+      success: OrchestrationV2ThreadHistoryPage,
+      error: EnvironmentOrchestrationThreadHistoryErrors,
+    }).middleware(EnvironmentAuthenticatedAuth),
+  ) {}
+
+export class EnvironmentProjectsHttpApi extends HttpApiGroup.make("projects")
+  .add(
+    HttpApiEndpoint.get("snapshot", "/api/projects", {
+      headers: OptionalBearerHeaders,
+      success: ProjectSnapshot,
+      error: EnvironmentProjectSnapshotErrors,
+    }).middleware(EnvironmentAuthenticatedAuth),
+  )
+  .add(
+    HttpApiEndpoint.post("mutate", "/api/projects/mutate", {
       headers: OptionalBearerHeaders,
-      payload: ClientOrchestrationCommand,
-      success: DispatchResult,
-      error: EnvironmentOrchestrationDispatchErrors,
+      payload: ProjectMutation,
+      success: Project,
+      error: EnvironmentProjectMutationErrors,
     }).middleware(EnvironmentAuthenticatedAuth),
   ) {}
 
@@ -619,4 +656,5 @@ export class EnvironmentHttpApi extends HttpApi.make("environment")
   .add(EnvironmentAuthHttpApi)
   .add(EnvironmentOrchestrationHttpApi)
   .add(EnvironmentPullRequestsHttpApi)
+  .add(EnvironmentProjectsHttpApi)
   .add(EnvironmentConnectHttpApi) {}
diff --git a/packages/contracts/src/index.ts b/packages/contracts/src/index.ts
index c6daef8687ba..cfe24f5ffd22 100644
--- a/packages/contracts/src/index.ts
+++ b/packages/contracts/src/index.ts
@@ -11,6 +11,10 @@ export * from "./terminal.ts";
 export * from "./provider.ts";
 export * from "./providerInstance.ts";
 export * from "./providerRuntime.ts";
+export * from "./providerPolicy.ts";
+export * from "./modelSelection.ts";
+export * from "./chatAttachment.ts";
+export * from "./checkpointDiff.ts";
 export * from "./model.ts";
 export * from "./keybindings.ts";
 export * from "./server.ts";
@@ -20,6 +24,11 @@ export * from "./vcs.ts";
 export * from "./sourceControl.ts";
 export * from "./pullRequest.ts";
 export * from "./orchestration.ts";
+export * from "./orchestrationProject.ts";
+export * from "./orchestrationV2.ts";
+export * from "./applicationEvent.ts";
+export * from "./orchestratorMcp.ts";
+export * from "./orchestration.ts";
 export * from "./t3ProjectFile.ts";
 export * from "./editor.ts";
 export * from "./project.ts";
@@ -30,4 +39,7 @@ export * from "./preview.ts";
 export * from "./previewAutomation.ts";
 export * from "./resourceTelemetry.ts";
 export * from "./usage.ts";
+export * from "./scheduledTask.ts";
+export * from "./worktreeMcp.ts";
+export * from "./resourceTelemetry.ts";
 export * from "./rpc.ts";
diff --git a/packages/contracts/src/ipc.ts b/packages/contracts/src/ipc.ts
index 19300aac328d..7d4276d413fc 100644
--- a/packages/contracts/src/ipc.ts
+++ b/packages/contracts/src/ipc.ts
@@ -77,16 +77,13 @@ import {
   PreviewAutomationWaitForInput,
 } from "./previewAutomation.ts";
 import type {
-  ClientOrchestrationCommand,
-  OrchestrationGetFullThreadDiffInput,
-  OrchestrationGetFullThreadDiffResult,
-  OrchestrationGetTurnDiffInput,
-  OrchestrationGetTurnDiffResult,
-  OrchestrationShellSnapshot,
-  OrchestrationShellStreamItem,
-  OrchestrationSubscribeThreadInput,
-  OrchestrationThreadStreamItem,
-} from "./orchestration.ts";
+  OrchestrationV2Command,
+  OrchestrationV2DispatchCommandResult,
+  OrchestrationV2GetThreadProjectionInput,
+  OrchestrationV2ShellStreamItem,
+  OrchestrationV2ThreadProjection,
+  OrchestrationV2ThreadStreamItem,
+} from "./orchestrationV2.ts";
 import { EnvironmentId } from "./baseSchemas.ts";
 import { AuthAccessTokenResult, AuthSessionState, AuthWebSocketTicketResult } from "./auth.ts";
 import { AdvertisedEndpoint } from "./remoteAccess.ts";
@@ -1343,6 +1340,7 @@ export interface EnvironmentApi {
       callback: (status: VcsStatusResult) => void,
       options?: {
         onResubscribe?: () => void;
+        onError?: (message: string) => void;
       },
     ) => () => void;
   };
@@ -1358,24 +1356,26 @@ export interface EnvironmentApi {
       input: ReviewDiffFileContentsInput,
     ) => Promise<ReviewDiffFileContentsResult>;
   };
-  orchestration: {
-    dispatchCommand: (command: ClientOrchestrationCommand) => Promise<{ sequence: number }>;
-    getTurnDiff: (input: OrchestrationGetTurnDiffInput) => Promise<OrchestrationGetTurnDiffResult>;
-    getFullThreadDiff: (
-      input: OrchestrationGetFullThreadDiffInput,
-    ) => Promise<OrchestrationGetFullThreadDiffResult>;
-    getArchivedShellSnapshot: () => Promise<OrchestrationShellSnapshot>;
+  orchestrationV2: {
+    dispatchCommand: (
+      command: OrchestrationV2Command,
+    ) => Promise<OrchestrationV2DispatchCommandResult>;
+    getThreadProjection: (
+      input: OrchestrationV2GetThreadProjectionInput,
+    ) => Promise<OrchestrationV2ThreadProjection>;
     subscribeShell: (
-      callback: (event: OrchestrationShellStreamItem) => void,
+      callback: (event: OrchestrationV2ShellStreamItem) => void,
       options?: {
         onResubscribe?: () => void;
+        onError?: (message: string) => void;
       },
     ) => () => void;
     subscribeThread: (
-      input: OrchestrationSubscribeThreadInput,
-      callback: (event: OrchestrationThreadStreamItem) => void,
+      input: OrchestrationV2GetThreadProjectionInput,
+      callback: (event: OrchestrationV2ThreadStreamItem) => void,
       options?: {
         onResubscribe?: () => void;
+        onError?: (message: string) => void;
       },
     ) => () => void;
   };
diff --git a/packages/contracts/src/keybindings.test.ts b/packages/contracts/src/keybindings.test.ts
index 9bc9af9d97fd..a7539353a491 100644
--- a/packages/contracts/src/keybindings.test.ts
+++ b/packages/contracts/src/keybindings.test.ts
@@ -42,6 +42,11 @@ it.effect("parses keybinding rules", () =>
     });
     assert.strictEqual(parsedRightPanelToggle.command, "rightPanel.toggle");
 
+    const parsedThreadPanelToggle = yield* decode(KeybindingRule, {
+      key: "mod+shift+b",
+      command: "threadPanel.toggle",
+    });
+    assert.strictEqual(parsedThreadPanelToggle.command, "threadPanel.toggle");
     const parsedRightPanelToggleMaximized = yield* decode(KeybindingRule, {
       key: "mod+shift+m",
       command: "rightPanel.toggleMaximized",
diff --git a/packages/contracts/src/keybindings.ts b/packages/contracts/src/keybindings.ts
index eb132d5d2844..b6f2826f9871 100644
--- a/packages/contracts/src/keybindings.ts
+++ b/packages/contracts/src/keybindings.ts
@@ -57,6 +57,7 @@ export const STATIC_KEYBINDING_COMMANDS = [
   "terminal.new",
   "terminal.close",
   "rightPanel.toggle",
+  "threadPanel.toggle",
   "rightPanel.toggleMaximized",
   "diff.toggle",
   "preview.toggle",
diff --git a/packages/contracts/src/model.ts b/packages/contracts/src/model.ts
index 9fcd0d266dd6..1c8c16a0638b 100644
--- a/packages/contracts/src/model.ts
+++ b/packages/contracts/src/model.ts
@@ -131,6 +131,7 @@ const CODEX_DRIVER_KIND = ProviderDriverKind.make("codex");
 const CLAUDE_DRIVER_KIND = ProviderDriverKind.make("claudeAgent");
 const CURSOR_DRIVER_KIND = ProviderDriverKind.make("cursor");
 const GROK_DRIVER_KIND = ProviderDriverKind.make("grok");
+const ACP_REGISTRY_DRIVER_KIND = ProviderDriverKind.make("acpRegistry");
 const OPENCODE_DRIVER_KIND = ProviderDriverKind.make("opencode");
 
 export const DEFAULT_MODEL = "gpt-5.6-sol";
@@ -152,6 +153,7 @@ export const DEFAULT_MODEL_BY_PROVIDER: Partial<Record<ProviderDriverKind, strin
   [CLAUDE_DRIVER_KIND]: "claude-sonnet-5",
   [CURSOR_DRIVER_KIND]: "auto",
   [GROK_DRIVER_KIND]: "grok-build",
+  [ACP_REGISTRY_DRIVER_KIND]: "default",
   [OPENCODE_DRIVER_KIND]: "openai/gpt-5",
 };
 
@@ -221,5 +223,6 @@ export const PROVIDER_DISPLAY_NAMES: Partial<Record<ProviderDriverKind, string>>
   [CLAUDE_DRIVER_KIND]: "Claude",
   [CURSOR_DRIVER_KIND]: "Cursor",
   [GROK_DRIVER_KIND]: "Grok",
+  [ACP_REGISTRY_DRIVER_KIND]: "ACP Registry",
   [OPENCODE_DRIVER_KIND]: "OpenCode",
 };
diff --git a/packages/contracts/src/modelSelection.ts b/packages/contracts/src/modelSelection.ts
new file mode 100644
index 000000000000..a131111a78cd
--- /dev/null
+++ b/packages/contracts/src/modelSelection.ts
@@ -0,0 +1,63 @@
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import * as SchemaTransformation from "effect/SchemaTransformation";
+
+import { TrimmedNonEmptyString } from "./baseSchemas.ts";
+import { ProviderOptionSelections } from "./model.ts";
+import { ProviderInstanceId } from "./providerInstance.ts";
+
+/**
+ * Selection of a model on a configured provider instance.
+ *
+ * `instanceId` is the routing key. The provider driver, credentials,
+ * environment, and continuation identity are resolved by the provider
+ * instance registry rather than encoded into the selection itself.
+ */
+const ModelSelectionWire = Schema.Struct({
+  instanceId: ProviderInstanceId,
+  model: TrimmedNonEmptyString,
+  options: Schema.optionalKey(ProviderOptionSelections),
+});
+
+const ModelSelectionSource = Schema.Struct({
+  provider: Schema.optional(Schema.Unknown),
+  instanceId: Schema.optional(Schema.Unknown),
+  model: Schema.Unknown,
+  options: Schema.optional(Schema.Unknown),
+});
+
+/**
+ * The decoder still accepts the historical `{ provider, model }` shape while
+ * V1 persistence remains readable. Runtime code only receives the canonical
+ * instance-based representation.
+ */
+export const ModelSelection = ModelSelectionSource.pipe(
+  Schema.decodeTo(
+    ModelSelectionWire,
+    SchemaTransformation.transformOrFail({
+      decode: (raw) => {
+        const instanceIdSource =
+          raw.instanceId !== undefined
+            ? raw.instanceId
+            : typeof raw.provider === "string"
+              ? raw.provider
+              : undefined;
+        const base: Record<string, unknown> = {
+          instanceId: instanceIdSource,
+          model: raw.model,
+        };
+        if (raw.options !== undefined) base.options = raw.options;
+        return Effect.succeed(base as typeof ModelSelectionWire.Encoded);
+      },
+      encode: (value) => {
+        const base: Record<string, unknown> = {
+          instanceId: value.instanceId,
+          model: value.model,
+        };
+        if (value.options !== undefined) base.options = value.options;
+        return Effect.succeed(base as typeof ModelSelectionSource.Encoded);
+      },
+    }),
+  ),
+);
+export type ModelSelection = typeof ModelSelection.Type;
diff --git a/packages/contracts/src/orchestration.test.ts b/packages/contracts/src/orchestration.test.ts
index 4ae91d27c184..3f59d4e6ecd4 100644
--- a/packages/contracts/src/orchestration.test.ts
+++ b/packages/contracts/src/orchestration.test.ts
@@ -4,10 +4,7 @@ import * as Exit from "effect/Exit";
 import * as Schema from "effect/Schema";
 
 import {
-  DEFAULT_PROVIDER_INTERACTION_MODE,
-  DEFAULT_RUNTIME_MODE,
   ClientOrchestrationCommand,
-  ModelSelection,
   OrchestrationCommand,
   OrchestrationDispatchCommandError,
   OrchestrationEvent,
@@ -28,9 +25,13 @@ import {
   ThreadCreatedPayload,
   ThreadTurnDiff,
   ThreadTurnStartRequestedPayload,
+} from "./orchestration.ts";
+import {
   isProviderSendTurnSupportedImageMimeType,
   PROVIDER_SEND_TURN_MAX_FILE_BYTES,
-} from "./orchestration.ts";
+} from "./chatAttachment.ts";
+import { ModelSelection } from "./modelSelection.ts";
+import { DEFAULT_PROVIDER_INTERACTION_MODE, DEFAULT_RUNTIME_MODE } from "./providerPolicy.ts";
 import { ProviderInstanceId } from "./providerInstance.ts";
 
 const decodeTurnDiffInput = Schema.decodeUnknownEffect(OrchestrationGetTurnDiffInput);
diff --git a/packages/contracts/src/orchestration.ts b/packages/contracts/src/orchestration.ts
index 7ca7175ad175..f51cc77fcf75 100644
--- a/packages/contracts/src/orchestration.ts
+++ b/packages/contracts/src/orchestration.ts
@@ -1,10 +1,6 @@
 import * as Effect from "effect/Effect";
 import * as Schema from "effect/Schema";
-import * as SchemaIssue from "effect/SchemaIssue";
-import * as SchemaTransformation from "effect/SchemaTransformation";
 import * as Struct from "effect/Struct";
-import { ProviderOptionSelections } from "./model.ts";
-import { RepositoryIdentity, ThreadEnvMode } from "./environment.ts";
 import {
   ApprovalRequestId,
   CheckpointRef,
@@ -16,266 +12,56 @@ import {
   NonNegativeInt,
   PositiveInt,
   ProjectId,
-  ProviderItemId,
   ThreadId,
   TrimmedNonEmptyString,
   TrimmedString,
   TurnId,
 } from "./baseSchemas.ts";
+import { ChatAttachment, UploadChatAttachment } from "./chatAttachment.ts";
+import { ModelSelection } from "./modelSelection.ts";
+import {
+  DEFAULT_PROVIDER_INTERACTION_MODE,
+  DEFAULT_RUNTIME_MODE,
+  ProviderApprovalDecision,
+  ProviderInteractionMode,
+  ProviderUserInputAnswers,
+  RuntimeMode,
+} from "./providerPolicy.ts";
 import { ProviderInstanceId } from "./providerInstance.ts";
+import { Project, ProjectScript, ProjectScriptIcon } from "./project.ts";
+import { RepositoryIdentity, ThreadEnvMode } from "./environment.ts";
+import { OrchestrationProjectShell } from "./orchestrationProject.ts";
+import {
+  ApplicationEventMetadata,
+  ApplicationProjectCreatedEvent,
+  ApplicationProjectDeletedEvent,
+  ApplicationProjectMetaUpdatedEvent,
+} from "./applicationEvent.ts";
+
+export { OrchestrationProjectShell } from "./orchestrationProject.ts";
+
+export {
+  ApplicationProjectCreatedPayload as ProjectCreatedPayload,
+  ApplicationProjectDeletedPayload as ProjectDeletedPayload,
+  ApplicationProjectMetaUpdatedPayload as ProjectMetaUpdatedPayload,
+  OrchestrationClientOrigin,
+} from "./applicationEvent.ts";
+
+export {
+  OrchestrationGetFullThreadDiffError,
+  OrchestrationGetFullThreadDiffInput,
+  OrchestrationGetFullThreadDiffResult,
+  OrchestrationGetTurnDiffError,
+  OrchestrationGetTurnDiffInput,
+  OrchestrationGetTurnDiffResult,
+  ThreadTurnDiff,
+  TurnCountRange,
+} from "./checkpointDiff.ts";
 
-export const ORCHESTRATION_WS_METHODS = {
-  dispatchCommand: "orchestration.dispatchCommand",
-  getWorkflowScript: "orchestration.getWorkflowScript",
-  getTurnDiff: "orchestration.getTurnDiff",
-  getFullThreadDiff: "orchestration.getFullThreadDiff",
-  searchThreads: "orchestration.searchThreads",
-  getArchivedShellSnapshot: "orchestration.getArchivedShellSnapshot",
-  subscribeShell: "orchestration.subscribeShell",
-  subscribeThread: "orchestration.subscribeThread",
-} as const;
-
-export const ProviderApprovalPolicy = Schema.Literals([
-  "untrusted",
-  "on-failure",
-  "on-request",
-  "never",
-]);
-export type ProviderApprovalPolicy = typeof ProviderApprovalPolicy.Type;
-export const ProviderSandboxMode = Schema.Literals([
-  "read-only",
-  "workspace-write",
-  "danger-full-access",
-]);
-export type ProviderSandboxMode = typeof ProviderSandboxMode.Type;
-
-/**
- * `ModelSelection` — selection of a model on a configured provider instance.
- *
- * The routing key is `instanceId` (a user-defined slug identifying one
- * configured provider instance). Drivers, credentials, working-directory
- * bindings, and any other per-instance state are recovered from the
- * runtime registry via the instance id.
- *
- * Wire legacy: persisted selections produced before the driver/instance
- * split carried a `provider: <driver-id>` field instead. The schema absorbs
- * that shape via a pre-decoding transform — `{provider, model}` is promoted
- * to `{instanceId: defaultInstanceIdForDriver(provider), model}`. No
- * post-decode compatibility code lives in the runtime; the transform is the
- * only compat surface.
- */
-const ModelSelectionWire = Schema.Struct({
-  instanceId: ProviderInstanceId,
-  model: TrimmedNonEmptyString,
-  options: Schema.optionalKey(ProviderOptionSelections),
-});
-
-// Source shape for persisted legacy payloads. Fields are typed as
-// `Schema.Unknown` so malformed drafts still make it into the transform and
-// fail validation through the target schema (with proper error messages)
-// rather than at the source-struct layer where the error is less actionable.
-const ModelSelectionSource = Schema.Struct({
-  provider: Schema.optional(Schema.Unknown),
-  instanceId: Schema.optional(Schema.Unknown),
-  model: Schema.Unknown,
-  options: Schema.optional(Schema.Unknown),
-});
-
-export const ModelSelection = ModelSelectionSource.pipe(
-  Schema.decodeTo(
-    ModelSelectionWire,
-    SchemaTransformation.transformOrFail({
-      decode: (raw) => {
-        // Resolve the routing key: prefer an explicit `instanceId`; fall
-        // back to promoting the legacy `provider` slug (the canonical
-        // `defaultInstanceIdForDriver` mapping) so persisted rollout-era
-        // payloads decode without data loss. The target schema brands the
-        // string as `ProviderInstanceId`.
-        const instanceIdSource =
-          raw.instanceId !== undefined
-            ? raw.instanceId
-            : typeof raw.provider === "string"
-              ? raw.provider
-              : undefined;
-        const base: Record<string, unknown> = {
-          instanceId: instanceIdSource,
-          model: raw.model,
-        };
-        if (raw.options !== undefined) base.options = raw.options;
-        return Effect.succeed(base as typeof ModelSelectionWire.Encoded);
-      },
-      encode: (value) => {
-        const base: Record<string, unknown> = {
-          model: value.model,
-          instanceId: value.instanceId,
-        };
-        if (value.options !== undefined) base.options = value.options;
-        return Effect.succeed(base as typeof ModelSelectionSource.Encoded);
-      },
-    }),
-  ),
-);
-export type ModelSelection = typeof ModelSelection.Type;
-
-export const RuntimeMode = Schema.Literals([
-  "approval-required",
-  "auto-accept-edits",
-  "auto",
-  "full-access",
-]);
-export type RuntimeMode = typeof RuntimeMode.Type;
-export const DEFAULT_RUNTIME_MODE: RuntimeMode = "full-access";
-export const ProviderInteractionMode = Schema.Literals(["default", "plan"]);
-export type ProviderInteractionMode = typeof ProviderInteractionMode.Type;
-export const DEFAULT_PROVIDER_INTERACTION_MODE: ProviderInteractionMode = "default";
-export const ProviderRequestKind = Schema.Literals([
-  "command",
-  "file-read",
-  "file-change",
-  "mcp-elicitation",
-]);
-export type ProviderRequestKind = typeof ProviderRequestKind.Type;
-export const AssistantDeliveryMode = Schema.Literals(["buffered", "streaming"]);
-export type AssistantDeliveryMode = typeof AssistantDeliveryMode.Type;
-export const ProviderApprovalDecision = Schema.Literals([
-  "accept",
-  "acceptForSession",
-  "acceptAlways",
-  "decline",
-  "cancel",
-]);
-export type ProviderApprovalDecision = typeof ProviderApprovalDecision.Type;
-export const ProviderApprovalOption = Schema.Struct({
-  decision: ProviderApprovalDecision,
-  label: TrimmedNonEmptyString,
-});
-export type ProviderApprovalOption = typeof ProviderApprovalOption.Type;
-export const ProviderUserInputAnswers = Schema.Record(Schema.String, Schema.Unknown);
-export type ProviderUserInputAnswers = typeof ProviderUserInputAnswers.Type;
-
-export const PROVIDER_SEND_TURN_MAX_INPUT_CHARS = 120_000;
-export const PROVIDER_SEND_TURN_MAX_ATTACHMENTS = 8;
-export const PROVIDER_SEND_TURN_MAX_IMAGE_BYTES = 10 * 1024 * 1024;
-export const PROVIDER_SEND_TURN_MAX_FILE_BYTES = 50 * 1024 * 1024;
-export const PROVIDER_SEND_TURN_SUPPORTED_IMAGE_MIME_TYPES = [
-  "image/gif",
-  "image/jpeg",
-  "image/png",
-  "image/webp",
-] as const;
-const PROVIDER_SEND_TURN_SUPPORTED_IMAGE_MIME_TYPE_SET = new Set<string>(
-  PROVIDER_SEND_TURN_SUPPORTED_IMAGE_MIME_TYPES,
-);
-
-/** Whether a pasted or picked image mime type can be sent on a provider turn. */
-export function isProviderSendTurnSupportedImageMimeType(mimeType: string): boolean {
-  return PROVIDER_SEND_TURN_SUPPORTED_IMAGE_MIME_TYPE_SET.has(mimeType.toLowerCase());
-}
-const PROVIDER_SEND_TURN_MAX_IMAGE_DATA_URL_CHARS = 14_000_000;
-const CHAT_ATTACHMENT_ID_MAX_CHARS = 128;
 // Correlation id is command id by design in this model.
 export const CorrelationId = CommandId;
 export type CorrelationId = typeof CorrelationId.Type;
 
-const ChatAttachmentId = TrimmedNonEmptyString.check(
-  Schema.isMaxLength(CHAT_ATTACHMENT_ID_MAX_CHARS),
-  Schema.isPattern(/^[a-z0-9_-]+$/i),
-);
-export type ChatAttachmentId = typeof ChatAttachmentId.Type;
-
-export const ChatImageAttachment = Schema.Struct({
-  type: Schema.Literal("image"),
-  id: ChatAttachmentId,
-  name: TrimmedNonEmptyString.check(Schema.isMaxLength(255)),
-  mimeType: TrimmedNonEmptyString.check(Schema.isMaxLength(100), Schema.isPattern(/^image\//i)),
-  sizeBytes: NonNegativeInt.check(Schema.isLessThanOrEqualTo(PROVIDER_SEND_TURN_MAX_IMAGE_BYTES)),
-});
-export type ChatImageAttachment = typeof ChatImageAttachment.Type;
-
-export const ChatFileAttachment = Schema.Struct({
-  type: Schema.Literal("file"),
-  id: ChatAttachmentId,
-  name: TrimmedNonEmptyString.check(Schema.isMaxLength(255)),
-  mimeType: TrimmedNonEmptyString.check(Schema.isMaxLength(100)),
-  sizeBytes: NonNegativeInt.check(
-    Schema.isGreaterThanOrEqualTo(1),
-    Schema.isLessThanOrEqualTo(PROVIDER_SEND_TURN_MAX_FILE_BYTES),
-  ),
-});
-export type ChatFileAttachment = typeof ChatFileAttachment.Type;
-
-/**
- * Catch-all for attachment types this build does not know. Attachments ride on
- * persisted events and thread streams, so a newer server or client must be able
- * to introduce a type without making older readers fail to decode the whole
- * message. Decoders keep the shared base fields; consumers skip these or render
- * them as unsupported. Mirrors how `OrchestrationThreadActivity` keeps `kind`
- * open. The known discriminators are excluded so a malformed image or file
- * attachment fails its own schema instead of sliding through here with its
- * size and mime constraints unchecked.
- */
-export const ChatUnknownAttachment = Schema.Struct({
-  type: TrimmedNonEmptyString.check(
-    Schema.isMaxLength(50),
-    Schema.isPattern(/^(?!(?:image|file)$)/),
-  ),
-  id: ChatAttachmentId,
-  name: TrimmedNonEmptyString.check(Schema.isMaxLength(255)),
-  mimeType: TrimmedNonEmptyString.check(Schema.isMaxLength(100)),
-  sizeBytes: NonNegativeInt,
-});
-export type ChatUnknownAttachment = typeof ChatUnknownAttachment.Type;
-
-const UploadChatImageAttachment = Schema.Struct({
-  type: Schema.Literal("image"),
-  name: TrimmedNonEmptyString.check(Schema.isMaxLength(255)),
-  mimeType: TrimmedNonEmptyString.check(Schema.isMaxLength(100), Schema.isPattern(/^image\//i)),
-  sizeBytes: NonNegativeInt.check(Schema.isLessThanOrEqualTo(PROVIDER_SEND_TURN_MAX_IMAGE_BYTES)),
-  dataUrl: TrimmedNonEmptyString.check(
-    Schema.isMaxLength(PROVIDER_SEND_TURN_MAX_IMAGE_DATA_URL_CHARS),
-  ),
-});
-export type UploadChatImageAttachment = typeof UploadChatImageAttachment.Type;
-
-export const ChatAttachment = Schema.Union([
-  ChatImageAttachment,
-  ChatFileAttachment,
-  ChatUnknownAttachment,
-]);
-export type ChatAttachment = typeof ChatAttachment.Type;
-const UploadChatAttachment = Schema.Union([UploadChatImageAttachment]);
-export type UploadChatAttachment = typeof UploadChatAttachment.Type;
-
-export const ProjectScriptIcon = Schema.Literals([
-  "play",
-  "test",
-  "lint",
-  "configure",
-  "build",
-  "debug",
-]);
-export type ProjectScriptIcon = typeof ProjectScriptIcon.Type;
-
-export const ProjectScript = Schema.Struct({
-  id: TrimmedNonEmptyString,
-  name: TrimmedNonEmptyString,
-  command: TrimmedNonEmptyString,
-  icon: ProjectScriptIcon,
-  runOnWorktreeCreate: Schema.Boolean,
-  /**
-   * URL to open in the in-app browser preview when this script runs (or
-   * when the user explicitly requests a preview). Optional; only honored on
-   * the desktop build.
-   */
-  previewUrl: Schema.optional(TrimmedNonEmptyString),
-  /**
-   * When true, automatically open the preview panel pointed at `previewUrl`
-   * the moment this script starts. Ignored without `previewUrl` or on web.
-   */
-  autoOpenPreview: Schema.optional(Schema.Boolean),
-});
-export type ProjectScript = typeof ProjectScript.Type;
-
 export const ProjectFaviconPath = TrimmedNonEmptyString.check(
   Schema.isMaxLength(1024),
   Schema.isPattern(/\.(?:avif|gif|ico|jpe?g|png|svg|webp)$/i),
@@ -495,21 +281,6 @@ export const OrchestrationReadModel = Schema.Struct({
 });
 export type OrchestrationReadModel = typeof OrchestrationReadModel.Type;
 
-export const OrchestrationProjectShell = Schema.Struct({
-  id: ProjectId,
-  title: TrimmedNonEmptyString,
-  workspaceRoot: TrimmedNonEmptyString,
-  repositoryIdentity: Schema.optional(Schema.NullOr(RepositoryIdentity)),
-  defaultModelSelection: Schema.NullOr(ModelSelection),
-  defaultThreadEnvMode: Schema.optional(Schema.NullOr(ThreadEnvMode)),
-  // Optional on the wire so cached snapshots from older servers still decode.
-  faviconPath: Schema.optional(Schema.NullOr(ProjectFaviconPath)),
-  scripts: Schema.Array(ProjectScript),
-  createdAt: IsoDateTime,
-  updatedAt: IsoDateTime,
-});
-export type OrchestrationProjectShell = typeof OrchestrationProjectShell.Type;
-
 export const OrchestrationThreadShell = Schema.Struct({
   id: ThreadId,
   projectId: ProjectId,
@@ -609,47 +380,8 @@ export const OrchestrationShellStreamItem = Schema.Union([
 ]);
 export type OrchestrationShellStreamItem = typeof OrchestrationShellStreamItem.Type;
 
-export const OrchestrationSubscribeShellInput = Schema.Struct({
-  /**
-   * When provided, the server skips the initial full shell snapshot and instead
-   * replays shell events after this sequence before streaming live events.
-   * Clients that already hold a cached (or HTTP-loaded) shell snapshot pass its
-   * sequence here so the subscription resumes without re-sending the entire
-   * projects/threads list (overlapping events are deduped by sequence on the
-   * client).
-   */
-  afterSequence: Schema.optionalKey(NonNegativeInt),
-  /**
-   * Requests an explicit marker after the subscription has emitted its initial
-   * snapshot or catch-up replay and before it begins emitting live events.
-   */
-  requestCompletionMarker: Schema.optionalKey(Schema.Boolean),
-});
-export type OrchestrationSubscribeShellInput = typeof OrchestrationSubscribeShellInput.Type;
-
 export const OrchestrationSubscribeThreadInput = Schema.Struct({
   threadId: ThreadId,
-  /**
-   * When provided, the server skips the initial snapshot frame and instead
-   * replays events after this sequence before streaming live events. Clients
-   * that load the snapshot over HTTP pass the snapshot's sequence here so the
-   * live subscription resumes without a gap (overlapping events are deduped by
-   * sequence on the client).
-   */
-  afterSequence: Schema.optionalKey(NonNegativeInt),
-  /**
-   * Requests an explicit marker after the subscription has emitted its initial
-   * snapshot or catch-up replay and before it begins emitting live events.
-   */
-  requestCompletionMarker: Schema.optionalKey(Schema.Boolean),
-  /**
-   * When provided, the fallback snapshot frame (sent when `afterSequence` is
-   * missing or the catch-up gap is too large) is windowed to the last
-   * `turnLimit` user-anchored turns and carries `page` metadata. Absent means
-   * the fallback snapshot is the full thread, preserving pre-pagination client
-   * behavior. Live events are unaffected either way.
-   */
-  turnLimit: Schema.optionalKey(PositiveInt),
 });
 export type OrchestrationSubscribeThreadInput = typeof OrchestrationSubscribeThreadInput.Type;
 
@@ -709,10 +441,11 @@ export const ProjectCreateCommand = Schema.Struct({
   workspaceRoot: TrimmedNonEmptyString,
   createWorkspaceRootIfMissing: Schema.optional(Schema.Boolean),
   defaultModelSelection: Schema.optional(Schema.NullOr(ModelSelection)),
+  scripts: Schema.optional(Schema.Array(ProjectScript)),
   createdAt: IsoDateTime,
 });
 
-const ProjectMetaUpdateCommand = Schema.Struct({
+export const ProjectMetaUpdateCommand = Schema.Struct({
   type: Schema.Literal("project.meta.update"),
   commandId: CommandId,
   projectId: ProjectId,
@@ -725,13 +458,20 @@ const ProjectMetaUpdateCommand = Schema.Struct({
   scripts: Schema.optional(Schema.Array(ProjectScript)),
 });
 
-const ProjectDeleteCommand = Schema.Struct({
+export const ProjectDeleteCommand = Schema.Struct({
   type: Schema.Literal("project.delete"),
   commandId: CommandId,
   projectId: ProjectId,
   force: Schema.optional(Schema.Boolean),
 });
 
+export const ProjectOrchestrationCommand = Schema.Union([
+  ProjectCreateCommand,
+  ProjectMetaUpdateCommand,
+  ProjectDeleteCommand,
+]);
+export type ProjectOrchestrationCommand = typeof ProjectOrchestrationCommand.Type;
+
 const ThreadCreateCommand = Schema.Struct({
   type: Schema.Literal("thread.create"),
   commandId: CommandId,
@@ -1161,36 +901,6 @@ export const OrchestrationAggregateKind = Schema.Literals(["project", "thread"])
 export type OrchestrationAggregateKind = typeof OrchestrationAggregateKind.Type;
 export const OrchestrationActorKind = Schema.Literals(["client", "server", "provider"]);
 
-export const ProjectCreatedPayload = Schema.Struct({
-  projectId: ProjectId,
-  title: TrimmedNonEmptyString,
-  workspaceRoot: TrimmedNonEmptyString,
-  repositoryIdentity: Schema.optional(Schema.NullOr(RepositoryIdentity)),
-  defaultModelSelection: Schema.NullOr(ModelSelection),
-  // Optional so persisted events from older servers still decode.
-  faviconPath: Schema.optional(Schema.NullOr(ProjectFaviconPath)),
-  scripts: Schema.Array(ProjectScript),
-  createdAt: IsoDateTime,
-  updatedAt: IsoDateTime,
-});
-
-export const ProjectMetaUpdatedPayload = Schema.Struct({
-  projectId: ProjectId,
-  title: Schema.optional(TrimmedNonEmptyString),
-  workspaceRoot: Schema.optional(TrimmedNonEmptyString),
-  repositoryIdentity: Schema.optional(Schema.NullOr(RepositoryIdentity)),
-  defaultModelSelection: Schema.optional(Schema.NullOr(ModelSelection)),
-  defaultThreadEnvMode: Schema.optional(Schema.NullOr(ThreadEnvMode)),
-  faviconPath: Schema.optional(Schema.NullOr(ProjectFaviconPath)),
-  scripts: Schema.optional(Schema.Array(ProjectScript)),
-  updatedAt: IsoDateTime,
-});
-
-export const ProjectDeletedPayload = Schema.Struct({
-  projectId: ProjectId,
-  deletedAt: IsoDateTime,
-});
-
 export const ThreadCreatedPayload = Schema.Struct({
   threadId: ThreadId,
   projectId: ProjectId,
@@ -1389,26 +1099,7 @@ export const ThreadActivityAppendedPayload = Schema.Struct({
   activity: OrchestrationThreadActivity,
 });
 
-/**
- * Which client connection dispatched the command that produced an event.
- * Stamped by the orchestration engine on client-dispatched commands; absent on
- * provider/server-originated events and on commands from clients too old to
- * report it.
- */
-export const OrchestrationClientOrigin = Schema.Struct({
-  surface: Schema.optional(ClientSurface),
-  appVersion: Schema.optional(TrimmedNonEmptyString),
-});
-export type OrchestrationClientOrigin = typeof OrchestrationClientOrigin.Type;
-
-export const OrchestrationEventMetadata = Schema.Struct({
-  providerTurnId: Schema.optional(TrimmedNonEmptyString),
-  providerItemId: Schema.optional(ProviderItemId),
-  adapterKey: Schema.optional(TrimmedNonEmptyString),
-  requestId: Schema.optional(ApprovalRequestId),
-  ingestedAt: Schema.optional(IsoDateTime),
-  origin: Schema.optional(OrchestrationClientOrigin),
-});
+export const OrchestrationEventMetadata = ApplicationEventMetadata;
 export type OrchestrationEventMetadata = typeof OrchestrationEventMetadata.Type;
 
 const EventBaseFields = {
@@ -1424,21 +1115,9 @@ const EventBaseFields = {
 } as const;
 
 export const OrchestrationEvent = Schema.Union([
-  Schema.Struct({
-    ...EventBaseFields,
-    type: Schema.Literal("project.created"),
-    payload: ProjectCreatedPayload,
-  }),
-  Schema.Struct({
-    ...EventBaseFields,
-    type: Schema.Literal("project.meta-updated"),
-    payload: ProjectMetaUpdatedPayload,
-  }),
-  Schema.Struct({
-    ...EventBaseFields,
-    type: Schema.Literal("project.deleted"),
-    payload: ProjectDeletedPayload,
-  }),
+  ApplicationProjectCreatedEvent,
+  ApplicationProjectMetaUpdatedEvent,
+  ApplicationProjectDeletedEvent,
   Schema.Struct({
     ...EventBaseFields,
     type: Schema.Literal("thread.created"),
@@ -1590,28 +1269,6 @@ export type OrchestrationThreadStreamItem = typeof OrchestrationThreadStreamItem
 export const OrchestrationCommandReceiptStatus = Schema.Literals(["accepted", "rejected"]);
 export type OrchestrationCommandReceiptStatus = typeof OrchestrationCommandReceiptStatus.Type;
 
-export const TurnCountRange = Schema.Struct({
-  fromTurnCount: NonNegativeInt,
-  toTurnCount: NonNegativeInt,
-}).check(
-  Schema.makeFilter(
-    (input) =>
-      input.fromTurnCount <= input.toTurnCount ||
-      new SchemaIssue.InvalidValue({
-        message: "fromTurnCount must be less than or equal to toTurnCount",
-      }),
-    { identifier: "OrchestrationTurnDiffRange" },
-  ),
-);
-
-export const ThreadTurnDiff = TurnCountRange.mapFields(
-  Struct.assign({
-    threadId: ThreadId,
-    diff: Schema.String,
-  }),
-  { unsafePreserveChecks: true },
-);
-
 export const ProviderSessionRuntimeStatus = Schema.Literals([
   "starting",
   "running",
@@ -1646,33 +1303,6 @@ export type ProjectionPendingApprovalStatus = typeof ProjectionPendingApprovalSt
 export const ProjectionPendingApprovalDecision = Schema.NullOr(ProviderApprovalDecision);
 export type ProjectionPendingApprovalDecision = typeof ProjectionPendingApprovalDecision.Type;
 
-export const DispatchResult = Schema.Struct({
-  sequence: NonNegativeInt,
-});
-export type DispatchResult = typeof DispatchResult.Type;
-
-export const OrchestrationGetTurnDiffInput = TurnCountRange.mapFields(
-  Struct.assign({
-    threadId: ThreadId,
-    ignoreWhitespace: Schema.optionalKey(Schema.Boolean),
-  }),
-  { unsafePreserveChecks: true },
-);
-export type OrchestrationGetTurnDiffInput = typeof OrchestrationGetTurnDiffInput.Type;
-
-export const OrchestrationGetTurnDiffResult = ThreadTurnDiff;
-export type OrchestrationGetTurnDiffResult = typeof OrchestrationGetTurnDiffResult.Type;
-
-export const OrchestrationGetFullThreadDiffInput = Schema.Struct({
-  threadId: ThreadId,
-  toTurnCount: NonNegativeInt,
-  ignoreWhitespace: Schema.optionalKey(Schema.Boolean),
-});
-export type OrchestrationGetFullThreadDiffInput = typeof OrchestrationGetFullThreadDiffInput.Type;
-
-export const OrchestrationGetFullThreadDiffResult = ThreadTurnDiff;
-export type OrchestrationGetFullThreadDiffResult = typeof OrchestrationGetFullThreadDiffResult.Type;
-
 export const OrchestrationThreadSearchSource = Schema.Literals(["user", "assistant"]);
 export type OrchestrationThreadSearchSource = typeof OrchestrationThreadSearchSource.Type;
 
@@ -1698,91 +1328,8 @@ export const OrchestrationSearchThreadsResult = Schema.Struct({
 });
 export type OrchestrationSearchThreadsResult = typeof OrchestrationSearchThreadsResult.Type;
 
-export const OrchestrationGetWorkflowScriptInput = Schema.Struct({
-  threadId: ThreadId,
-  /** Absolute path from the workflow's runHandles.scriptPath. The server
-   * re-derives containment; the client value is a hint, never trusted. */
-  scriptPath: TrimmedNonEmptyString,
-});
-export type OrchestrationGetWorkflowScriptInput = typeof OrchestrationGetWorkflowScriptInput.Type;
-
-export const OrchestrationGetWorkflowScriptResult = Schema.Struct({
-  scriptPath: TrimmedNonEmptyString,
-  contents: Schema.String,
-  truncated: Schema.Boolean,
-});
-export type OrchestrationGetWorkflowScriptResult = typeof OrchestrationGetWorkflowScriptResult.Type;
-
-const WORKFLOW_SCRIPT_ERROR_MESSAGES = {
-  "invalid-path": "Workflow scripts must be absolute .js paths.",
-  "root-unavailable": "Script root unavailable.",
-  "not-found": "Script not found.",
-  "outside-root": "Script path is outside the workflow scripts root.",
-  "not-js": "Resolved script is not a .js file.",
-  "not-regular-file": "Script is not a regular file.",
-  "changed-during-read": "Script changed between resolution and open.",
-  "read-failed": "Script read failed.",
-} as const;
-
-export class OrchestrationGetWorkflowScriptError extends Schema.TaggedErrorClass<OrchestrationGetWorkflowScriptError>()(
-  "OrchestrationGetWorkflowScriptError",
-  {
-    reason: Schema.Literals([
-      "invalid-path",
-      "root-unavailable",
-      "not-found",
-      "outside-root",
-      "not-js",
-      "not-regular-file",
-      "changed-during-read",
-      "read-failed",
-    ]),
-    scriptPath: Schema.String,
-    cause: Schema.optional(Schema.Defect()),
-  },
-) {
-  override get message(): string {
-    return WORKFLOW_SCRIPT_ERROR_MESSAGES[this.reason];
-  }
-}
-
-export const OrchestrationRpcSchemas = {
-  dispatchCommand: {
-    input: ClientOrchestrationCommand,
-    output: DispatchResult,
-  },
-  getWorkflowScript: {
-    input: OrchestrationGetWorkflowScriptInput,
-    output: OrchestrationGetWorkflowScriptResult,
-  },
-  getTurnDiff: {
-    input: OrchestrationGetTurnDiffInput,
-    output: OrchestrationGetTurnDiffResult,
-  },
-  getFullThreadDiff: {
-    input: OrchestrationGetFullThreadDiffInput,
-    output: OrchestrationGetFullThreadDiffResult,
-  },
-  searchThreads: {
-    input: OrchestrationSearchThreadsInput,
-    output: OrchestrationSearchThreadsResult,
-  },
-  getArchivedShellSnapshot: {
-    input: Schema.Struct({}),
-    output: OrchestrationShellSnapshot,
-  },
-  subscribeThread: {
-    input: OrchestrationSubscribeThreadInput,
-    output: OrchestrationThreadStreamItem,
-  },
-  subscribeShell: {
-    input: OrchestrationSubscribeShellInput,
-    output: OrchestrationShellStreamItem,
-  },
-} as const;
-
-export class OrchestrationGetSnapshotError extends Schema.TaggedErrorClass<OrchestrationGetSnapshotError>()(
-  "OrchestrationGetSnapshotError",
+export class OrchestrationSearchThreadsError extends Schema.TaggedErrorClass<OrchestrationSearchThreadsError>()(
+  "OrchestrationSearchThreadsError",
   {
     message: TrimmedNonEmptyString,
     cause: Schema.optional(Schema.Defect()),
@@ -1797,27 +1344,3 @@ export class OrchestrationDispatchCommandError extends Schema.TaggedErrorClass<O
     bootstrapThreadDisposition: Schema.optional(Schema.Literal("deleted")),
   },
 ) {}
-
-export class OrchestrationGetTurnDiffError extends Schema.TaggedErrorClass<OrchestrationGetTurnDiffError>()(
-  "OrchestrationGetTurnDiffError",
-  {
-    message: TrimmedNonEmptyString,
-    cause: Schema.optional(Schema.Defect()),
-  },
-) {}
-
-export class OrchestrationGetFullThreadDiffError extends Schema.TaggedErrorClass<OrchestrationGetFullThreadDiffError>()(
-  "OrchestrationGetFullThreadDiffError",
-  {
-    message: TrimmedNonEmptyString,
-    cause: Schema.optional(Schema.Defect()),
-  },
-) {}
-
-export class OrchestrationSearchThreadsError extends Schema.TaggedErrorClass<OrchestrationSearchThreadsError>()(
-  "OrchestrationSearchThreadsError",
-  {
-    message: TrimmedNonEmptyString,
-    cause: Schema.optional(Schema.Defect()),
-  },
-) {}
diff --git a/packages/contracts/src/orchestrationProject.ts b/packages/contracts/src/orchestrationProject.ts
new file mode 100644
index 000000000000..682042bf4788
--- /dev/null
+++ b/packages/contracts/src/orchestrationProject.ts
@@ -0,0 +1,24 @@
+import * as Schema from "effect/Schema";
+
+import { IsoDateTime, ProjectId, TrimmedNonEmptyString } from "./baseSchemas.ts";
+import { RepositoryIdentity, ThreadEnvMode } from "./environment.ts";
+import { ModelSelection } from "./modelSelection.ts";
+import { ProjectScript } from "./project.ts";
+
+/** Project summary shared by the V2 shell and application project APIs. */
+export const OrchestrationProjectShell = Schema.Struct({
+  id: ProjectId,
+  title: TrimmedNonEmptyString,
+  workspaceRoot: TrimmedNonEmptyString,
+  repositoryIdentity: Schema.optional(Schema.NullOr(RepositoryIdentity)),
+  defaultModelSelection: Schema.NullOr(ModelSelection),
+  // Per-project override for where new threads start. Null/absent means
+  // "no override": clients fall back to t3.json, then the global setting.
+  defaultThreadEnvMode: Schema.optional(Schema.NullOr(ThreadEnvMode)),
+  // Optional on the wire so cached snapshots from older servers still decode.
+  faviconPath: Schema.optional(Schema.NullOr(TrimmedNonEmptyString)),
+  scripts: Schema.Array(ProjectScript),
+  createdAt: IsoDateTime,
+  updatedAt: IsoDateTime,
+});
+export type OrchestrationProjectShell = typeof OrchestrationProjectShell.Type;
diff --git a/packages/contracts/src/orchestrationV2.test.ts b/packages/contracts/src/orchestrationV2.test.ts
new file mode 100644
index 000000000000..21ec7e75e214
--- /dev/null
+++ b/packages/contracts/src/orchestrationV2.test.ts
@@ -0,0 +1,772 @@
+import { describe, expect, it } from "@effect/vitest";
+import * as DateTime from "effect/DateTime";
+import * as Schema from "effect/Schema";
+
+import {
+  CheckpointId,
+  CheckpointRef,
+  CheckpointScopeId,
+  ContextTransferId,
+  CommandId,
+  EventId,
+  MessageId,
+  NodeId,
+  ProjectId,
+  ProviderInstanceId,
+  ProviderReplayTranscript,
+  ProviderThreadId,
+  RunId,
+  ThreadId,
+  TurnItemId,
+} from "./index.ts";
+import {
+  OrchestrationV2Checkpoint,
+  OrchestrationV2CheckpointScope,
+  OrchestrationV2Command,
+  OrchestrationV2DomainEvent,
+  OrchestrationV2ProviderThread,
+  OrchestrationV2ProviderThreadJson,
+  OrchestrationV2ShellSnapshot,
+  OrchestrationV2Subagent,
+  OrchestrationV2ThreadProjection,
+  OrchestrationV2ThreadShell,
+  OrchestrationV2TurnItem,
+} from "./orchestrationV2.ts";
+
+const now = DateTime.makeUnsafe("2026-04-20T00:00:00.000Z");
+const LegacyShellStreamItem = Schema.Union([
+  Schema.Struct({ kind: Schema.Literal("synchronized") }),
+  Schema.Struct({
+    kind: Schema.Literal("snapshot"),
+    snapshot: OrchestrationV2ShellSnapshot,
+  }),
+]);
+const decodeLegacyShellStreamItem = Schema.decodeUnknownSync(LegacyShellStreamItem);
+const decodeOrchestrationV2Command = Schema.decodeUnknownSync(OrchestrationV2Command);
+const decodeOrchestrationV2TurnItem = Schema.decodeUnknownSync(OrchestrationV2TurnItem);
+const decodeOrchestrationV2CheckpointScope = Schema.decodeUnknownSync(
+  OrchestrationV2CheckpointScope,
+);
+const decodeOrchestrationV2Checkpoint = Schema.decodeUnknownSync(OrchestrationV2Checkpoint);
+const decodeOrchestrationV2DomainEvent = Schema.decodeUnknownSync(OrchestrationV2DomainEvent);
+const decodeProviderReplayTranscript = Schema.decodeUnknownSync(ProviderReplayTranscript);
+const decodeOrchestrationV2Subagent = Schema.decodeUnknownSync(OrchestrationV2Subagent);
+const decodeOrchestrationV2ThreadProjection = Schema.decodeUnknownSync(
+  OrchestrationV2ThreadProjection,
+);
+const decodeOrchestrationV2ProviderThreadJson = Schema.decodeUnknownSync(
+  OrchestrationV2ProviderThreadJson,
+);
+const decodeOrchestrationV2ProviderThread = Schema.decodeUnknownSync(OrchestrationV2ProviderThread);
+const decodeOrchestrationV2ThreadShell = Schema.decodeUnknownSync(OrchestrationV2ThreadShell);
+
+describe("orchestration V2 contracts", () => {
+  it("lets legacy snapshot decoders ignore enrichment metadata", () => {
+    const decoded = decodeLegacyShellStreamItem({
+      kind: "snapshot",
+      snapshot: {
+        schemaVersion: 1,
+        snapshotSequence: 0,
+        projects: [],
+        threads: [],
+        archivedThreads: [],
+      },
+      resolvedRepositoryIdentityRoots: ["/workspace/project"],
+    });
+
+    expect(decoded.kind).toBe("snapshot");
+    expect("resolvedRepositoryIdentityRoots" in decoded).toBe(false);
+  });
+
+  it("decodes nested checkpoint scopes without making child scopes advance app run count", () => {
+    const rootScope = decodeOrchestrationV2CheckpointScope({
+      id: "scope-root-1",
+      threadId: "thread-1",
+      runId: "run-1",
+      nodeId: "node-root-1",
+      parentScopeId: null,
+      providerThreadId: "provider-thread-1",
+      kind: "root_run",
+      ordinalWithinParent: 1,
+      advancesAppRunCount: true,
+      cwd: "/tmp/project",
+      createdAt: now,
+    });
+    const childScope = decodeOrchestrationV2CheckpointScope({
+      id: "scope-child-1",
+      threadId: "thread-1",
+      runId: "run-1",
+      nodeId: "node-child-1",
+      parentScopeId: rootScope.id,
+      providerThreadId: "provider-thread-child-1",
+      kind: "subagent",
+      ordinalWithinParent: 1,
+      advancesAppRunCount: false,
+      cwd: "/tmp/project",
+      createdAt: now,
+    });
+
+    expect(rootScope.advancesAppRunCount).toBe(true);
+    expect(childScope.parentScopeId).toBe(rootScope.id);
+    expect(childScope.advancesAppRunCount).toBe(false);
+  });
+
+  it("decodes checkpoint captures that attach to scopes, nodes, and optional app run ordinals", () => {
+    const checkpoint = decodeOrchestrationV2Checkpoint({
+      id: "checkpoint-1",
+      threadId: "thread-1",
+      scopeId: "scope-child-1",
+      runId: "run-1",
+      nodeId: "node-child-1",
+      parentCheckpointId: "checkpoint-root-1",
+      ordinalWithinScope: 1,
+      appRunOrdinal: null,
+      ref: "git-ref-1",
+      status: "ready",
+      files: [{ path: "package.json", kind: "modified", additions: 2, deletions: 1 }],
+      capturedAt: now,
+    });
+
+    expect(checkpoint.appRunOrdinal).toBeNull();
+    expect(checkpoint.scopeId).toBe(CheckpointScopeId.make("scope-child-1"));
+    expect(checkpoint.parentCheckpointId).toBe(CheckpointId.make("checkpoint-root-1"));
+  });
+
+  it("decodes command and domain event shapes for command-to-projection tests", () => {
+    const command = decodeOrchestrationV2Command({
+      type: "message.dispatch",
+      createdBy: "user",
+      creationSource: "web",
+      commandId: "command-1",
+      threadId: "thread-1",
+      messageId: "message-1",
+      text: "hello",
+      attachments: [],
+      dispatchMode: { type: "start_immediately" },
+    });
+    const event = decodeOrchestrationV2DomainEvent({
+      id: "event-1",
+      type: "run.created",
+      threadId: "thread-1",
+      runId: "run-1",
+      occurredAt: now,
+      payload: {
+        id: "run-1",
+        threadId: "thread-1",
+        ordinal: 1,
+        providerInstanceId: "codex",
+        modelSelection: {
+          instanceId: "codex",
+          model: "gpt-5.4",
+        },
+        providerThreadId: "provider-thread-1",
+        userMessageId: "message-1",
+        rootNodeId: null,
+        activeAttemptId: null,
+        status: "queued",
+        requestedAt: now,
+        startedAt: null,
+        completedAt: null,
+        checkpointId: null,
+        contextHandoffId: null,
+      },
+    });
+
+    expect(command.commandId).toBe(CommandId.make("command-1"));
+    expect(event.id).toBe(EventId.make("event-1"));
+    if (event.type !== "run.created") {
+      throw new Error(`Expected run.created, received ${event.type}.`);
+    }
+    expect(event.payload.id).toBe(RunId.make("run-1"));
+  });
+
+  it("decodes app-owned delegated task commands", () => {
+    const command = decodeOrchestrationV2Command({
+      type: "delegated_task.request",
+      createdBy: "user",
+      creationSource: "web",
+      commandId: "command-delegate-1",
+      parentThreadId: "thread-parent-1",
+      parentRunId: "run-parent-1",
+      parentNodeId: "node-parent-1",
+      task: "Inspect the API boundary.",
+      title: "API inspection",
+      modelSelection: {
+        instanceId: "claudeAgent",
+        model: "claude-sonnet-4-6",
+      },
+      runtimeMode: "approval-required",
+      interactionMode: "plan",
+    });
+
+    expect(command.type).toBe("delegated_task.request");
+    if (command.type !== "delegated_task.request") {
+      throw new Error("expected delegated_task.request");
+    }
+    expect(command.parentThreadId).toBe(ThreadId.make("thread-parent-1"));
+    expect(command.parentRunId).toBe(RunId.make("run-parent-1"));
+    expect(command.parentNodeId).toBe(NodeId.make("node-parent-1"));
+  });
+
+  it("decodes delegated task wake-policy commands", () => {
+    const command = decodeOrchestrationV2Command({
+      type: "delegated_task.wake-policy",
+      commandId: "command-delegate-wake-policy-1",
+      parentThreadId: "thread-parent-1",
+      taskId: "node-subagent-1",
+      completionWake: "always",
+    });
+
+    expect(command.type).toBe("delegated_task.wake-policy");
+    if (command.type !== "delegated_task.wake-policy") {
+      throw new Error("expected delegated_task.wake-policy");
+    }
+    expect(command.parentThreadId).toBe(ThreadId.make("thread-parent-1"));
+    expect(command.taskId).toBe(NodeId.make("node-subagent-1"));
+    expect(command.completionWake).toBe("always");
+
+    // The policy carries the whole decision, so it is required and closed.
+    expect(() =>
+      decodeOrchestrationV2Command({
+        type: "delegated_task.wake-policy",
+        commandId: "command-delegate-wake-policy-2",
+        parentThreadId: "thread-parent-1",
+        taskId: "node-subagent-1",
+      }),
+    ).toThrow();
+    expect(() =>
+      decodeOrchestrationV2Command({
+        type: "delegated_task.wake-policy",
+        commandId: "command-delegate-wake-policy-3",
+        parentThreadId: "thread-parent-1",
+        taskId: "node-subagent-1",
+        completionWake: "sometimes",
+      }),
+    ).toThrow();
+  });
+
+  it("decodes durable created-thread timeline records", () => {
+    const command = decodeOrchestrationV2Command({
+      type: "thread.created.record",
+      commandId: "command-thread-record-1",
+      parentThreadId: "thread-parent-1",
+      parentRunId: "run-parent-1",
+      parentNodeId: "node-parent-1",
+      targetThreadId: "thread-child-1",
+      targetRunId: "run-child-1",
+    });
+    const item = decodeOrchestrationV2TurnItem({
+      id: "turn-item-thread-created-1",
+      type: "thread_created",
+      threadId: "thread-parent-1",
+      runId: "run-parent-1",
+      nodeId: "node-parent-1",
+      providerThreadId: "provider-thread-parent-1",
+      providerTurnId: null,
+      nativeItemRef: null,
+      parentItemId: null,
+      ordinal: 4,
+      status: "completed",
+      title: "Child thread",
+      targetThreadId: "thread-child-1",
+      targetRunId: "run-child-1",
+      targetProviderInstanceId: "claude-default",
+      targetModel: "claude-sonnet-4-6",
+      startedAt: now,
+      completedAt: now,
+      updatedAt: now,
+    });
+
+    expect(command.type).toBe("thread.created.record");
+    if (command.type !== "thread.created.record") {
+      throw new Error("expected thread.created.record");
+    }
+    expect(command.targetThreadId).toBe(ThreadId.make("thread-child-1"));
+    expect(item.type).toBe("thread_created");
+    if (item.type !== "thread_created") {
+      throw new Error("expected thread_created");
+    }
+    expect(item.targetRunId).toBe(RunId.make("run-child-1"));
+  });
+
+  it("decodes provider-neutral replay transcripts", () => {
+    const transcript = decodeProviderReplayTranscript({
+      provider: "codex",
+      protocol: "codex.app-server",
+      version: "0.120.0",
+      scenario: "simple",
+      metadata: {
+        source: "real-probe",
+      },
+      entries: [
+        {
+          type: "expect_outbound",
+          label: "initialize",
+          frame: { id: 1, method: "initialize" },
+        },
+        {
+          type: "emit_inbound",
+          label: "initialize-result",
+          frame: { id: 1, result: { ok: true } },
+        },
+        {
+          type: "runtime_exit",
+          status: "success",
+        },
+      ],
+    });
+
+    expect(transcript.entries).toHaveLength(3);
+    expect(transcript.protocol).toBe("codex.app-server");
+  });
+
+  it("decodes strictly typed turn items for known tools and dynamic fallback tools", () => {
+    const fileChange = decodeOrchestrationV2TurnItem({
+      id: "turn-item-file-change-1",
+      type: "file_change",
+      threadId: "thread-1",
+      runId: "run-1",
+      nodeId: "node-file-change-1",
+      providerThreadId: "provider-thread-1",
+      providerTurnId: "provider-turn-1",
+      nativeItemRef: { driver: "codex", nativeId: "item-file-change-1", strength: "strong" },
+      parentItemId: null,
+      ordinal: 3,
+      status: "completed",
+      title: "Edited package.json",
+      fileName: "package.json",
+      additions: 4,
+      deletions: 2,
+      diffStr: "@@ fixture diff",
+      startedAt: now,
+      completedAt: now,
+      updatedAt: now,
+    });
+    const dynamicTool = decodeOrchestrationV2TurnItem({
+      id: "turn-item-dynamic-1",
+      type: "dynamic_tool",
+      threadId: "thread-1",
+      runId: "run-1",
+      nodeId: "node-dynamic-1",
+      providerThreadId: "provider-thread-1",
+      providerTurnId: "provider-turn-1",
+      nativeItemRef: { driver: "codex", nativeId: "item-dynamic-1", strength: "strong" },
+      parentItemId: null,
+      ordinal: 4,
+      status: "completed",
+      title: "Custom tool",
+      toolName: "custom.lookup",
+      input: { query: "fixture" },
+      output: { ok: true },
+      startedAt: now,
+      completedAt: now,
+      updatedAt: now,
+    });
+
+    expect(fileChange.type).toBe("file_change");
+    if (fileChange.type !== "file_change") {
+      throw new Error("expected file_change");
+    }
+    expect(fileChange.fileName).toBe("package.json");
+    expect(fileChange.additions).toBe(4);
+    expect(dynamicTool.id).toBe(TurnItemId.make("turn-item-dynamic-1"));
+  });
+
+  it("decodes bounded provider failures as expected error turn items", () => {
+    const errorItem = decodeOrchestrationV2TurnItem({
+      id: "turn-item-error-1",
+      type: "error",
+      threadId: "thread-1",
+      runId: "run-1",
+      nodeId: "node-root-1",
+      providerThreadId: "provider-thread-1",
+      providerTurnId: "provider-turn-1",
+      nativeItemRef: null,
+      parentItemId: null,
+      ordinal: 199,
+      status: "failed",
+      title: "Provider error",
+      failure: {
+        class: "validation_error",
+        message: "Invalid reasoning effort.",
+        code: "invalid_request",
+        retryable: false,
+      },
+      startedAt: now,
+      completedAt: now,
+      updatedAt: now,
+    });
+
+    expect(errorItem.type).toBe("error");
+    if (errorItem.type !== "error") throw new Error("expected error item");
+    expect(errorItem.failure.message).toBe("Invalid reasoning effort.");
+    expect(() =>
+      decodeOrchestrationV2TurnItem({
+        ...errorItem,
+        failure: { ...errorItem.failure, message: "x".repeat(4_097) },
+      }),
+    ).toThrow();
+  });
+
+  it("decodes provider-native subagent lifecycle records and timeline items", () => {
+    const subagent = decodeOrchestrationV2Subagent({
+      id: "node-subagent-1",
+      threadId: "thread-1",
+      runId: "run-1",
+      parentNodeId: "node-root-1",
+      origin: "provider_native",
+      createdBy: "agent",
+      driver: "codex",
+      providerInstanceId: "codex",
+      providerThreadId: "provider-thread-subagent-1",
+      childThreadId: null,
+      nativeTaskRef: {
+        driver: "codex",
+        nativeId: "native-task-1",
+        strength: "strong",
+      },
+      prompt: "Inspect package.json",
+      title: "Package audit",
+      model: "gpt-5.4",
+      status: "completed",
+      progress: "Inspecting package metadata",
+      result: "Package is private.",
+      startedAt: now,
+      completedAt: now,
+      updatedAt: now,
+    });
+    const turnItem = decodeOrchestrationV2TurnItem({
+      id: "turn-item-subagent-1",
+      type: "subagent",
+      threadId: "thread-1",
+      runId: "run-1",
+      nodeId: subagent.id,
+      providerThreadId: subagent.providerThreadId,
+      providerTurnId: "provider-turn-1",
+      nativeItemRef: subagent.nativeTaskRef,
+      parentItemId: null,
+      ordinal: 2,
+      status: "completed",
+      title: subagent.title,
+      subagentId: subagent.id,
+      origin: subagent.origin,
+      driver: subagent.driver,
+      providerInstanceId: subagent.providerInstanceId,
+      childThreadId: subagent.childThreadId,
+      prompt: subagent.prompt,
+      progress: subagent.progress,
+      result: subagent.result,
+      startedAt: now,
+      completedAt: now,
+      updatedAt: now,
+    });
+
+    expect(subagent.origin).toBe("provider_native");
+    expect(subagent.progress).toBe("Inspecting package metadata");
+    expect(subagent.childThreadId).toBeNull();
+    expect(turnItem.type).toBe("subagent");
+    if (turnItem.type !== "subagent") throw new Error("expected subagent item");
+    expect(turnItem.progress).toBe("Inspecting package metadata");
+  });
+
+  it("decodes app-owned subagent parent-wake policies", () => {
+    const appOwnedSubagent = {
+      id: "node-subagent-2",
+      threadId: "thread-1",
+      runId: "run-1",
+      parentNodeId: "node-root-1",
+      origin: "app_owned",
+      createdBy: "agent",
+      driver: "codex",
+      providerInstanceId: "codex",
+      providerThreadId: null,
+      childThreadId: "thread-child-1",
+      nativeTaskRef: null,
+      prompt: "Inspect the API boundary.",
+      title: "API inspection",
+      model: "gpt-5.4",
+      status: "running",
+      result: null,
+      startedAt: now,
+      completedAt: null,
+      updatedAt: now,
+    };
+    const decode = Schema.decodeUnknownSync(OrchestrationV2Subagent);
+
+    // Legacy records predate the field and must behave as settled_only.
+    expect(decode(appOwnedSubagent).completionWake).toBeUndefined();
+    expect(decode({ ...appOwnedSubagent, completionWake: "always" }).completionWake).toBe("always");
+    expect(decode({ ...appOwnedSubagent, completionWake: "settled_only" }).completionWake).toBe(
+      "settled_only",
+    );
+    expect(() => decode({ ...appOwnedSubagent, completionWake: "sometimes" })).toThrow();
+  });
+
+  it("decodes thread projections with an ordered turn item rendering stream", () => {
+    const projection = decodeOrchestrationV2ThreadProjection({
+      thread: {
+        createdBy: "user",
+        creationSource: "web",
+        id: "thread-1",
+        projectId: "project-1",
+        title: "Thread",
+        providerInstanceId: "codex",
+        modelSelection: { instanceId: ProviderInstanceId.make("codex"), model: "gpt-5-codex" },
+        runtimeMode: "full-access",
+        interactionMode: "default",
+        branch: null,
+        worktreePath: null,
+        activeProviderThreadId: null,
+        lineage: {
+          parentThreadId: null,
+          relationshipToParent: null,
+          rootThreadId: "thread-1",
+        },
+        forkedFrom: null,
+        createdAt: now,
+        updatedAt: now,
+        archivedAt: null,
+        deletedAt: null,
+      },
+      runs: [],
+      attempts: [],
+      nodes: [],
+      subagents: [],
+      providerSessions: [],
+      providerThreads: [],
+      providerTurns: [],
+      runtimeRequests: [],
+      messages: [],
+      plans: [],
+      turnItems: [
+        {
+          id: "turn-item-command-1",
+          type: "command_execution",
+          threadId: "thread-1",
+          runId: "run-1",
+          nodeId: "node-command-1",
+          providerThreadId: "provider-thread-1",
+          providerTurnId: "provider-turn-1",
+          nativeItemRef: { driver: "codex", nativeId: "item-command-1", strength: "strong" },
+          parentItemId: null,
+          ordinal: 1,
+          status: "completed",
+          title: "Ran command",
+          input: "bun typecheck",
+          output: "Tasks: 10 successful",
+          exitCode: 0,
+          startedAt: now,
+          completedAt: now,
+          updatedAt: now,
+        },
+      ],
+      visibleTurnItems: [
+        {
+          position: 0,
+          visibility: "local",
+          sourceThreadId: "thread-1",
+          sourceItemId: "turn-item-command-1",
+          item: {
+            id: "turn-item-command-1",
+            type: "command_execution",
+            threadId: "thread-1",
+            runId: "run-1",
+            nodeId: "node-command-1",
+            providerThreadId: "provider-thread-1",
+            providerTurnId: "provider-turn-1",
+            nativeItemRef: { driver: "codex", nativeId: "item-command-1", strength: "strong" },
+            parentItemId: null,
+            ordinal: 1,
+            status: "completed",
+            title: "Ran command",
+            input: "bun typecheck",
+            output: "Tasks: 10 successful",
+            exitCode: 0,
+            startedAt: now,
+            completedAt: now,
+            updatedAt: now,
+          },
+        },
+      ],
+      checkpointScopes: [],
+      checkpoints: [],
+      contextHandoffs: [],
+      contextTransfers: [],
+      updatedAt: now,
+    });
+
+    expect(projection.turnItems.map((item) => item.type)).toEqual(["command_execution"]);
+  });
+
+  it("decodes orchestration lifecycle turn items for compaction, handoff, and fork UI", () => {
+    const compaction = decodeOrchestrationV2TurnItem({
+      id: "turn-item-compaction-1",
+      type: "compaction",
+      threadId: "thread-1",
+      runId: "run-1",
+      nodeId: "node-compaction-1",
+      providerThreadId: "provider-thread-1",
+      providerTurnId: "provider-turn-1",
+      nativeItemRef: null,
+      parentItemId: null,
+      ordinal: 5,
+      status: "running",
+      title: "Compacting context...",
+      driver: "codex",
+      beforeTokenCount: 180000,
+      startedAt: now,
+      completedAt: null,
+      updatedAt: now,
+    });
+    const handoff = decodeOrchestrationV2TurnItem({
+      id: "turn-item-handoff-1",
+      type: "handoff",
+      threadId: "thread-1",
+      runId: "run-2",
+      nodeId: null,
+      providerThreadId: "provider-thread-claude-1",
+      providerTurnId: null,
+      nativeItemRef: null,
+      parentItemId: null,
+      ordinal: 6,
+      status: "completed",
+      title: "Handed off to Claude",
+      contextHandoffId: "handoff-1",
+      fromProviderThreadIds: ["provider-thread-codex-1"],
+      toProviderThreadId: "provider-thread-claude-1",
+      fromProviderInstanceIds: ["codex"],
+      toProviderInstanceId: "claudeAgent",
+      strategy: "delta_since_target_last_seen",
+      summary: "Codex completed the setup work.",
+      startedAt: now,
+      completedAt: now,
+      updatedAt: now,
+    });
+    const fork = decodeOrchestrationV2TurnItem({
+      id: "turn-item-fork-1",
+      type: "fork",
+      threadId: "thread-1",
+      runId: "run-2",
+      nodeId: "node-subagent-1",
+      providerThreadId: "provider-thread-child-1",
+      providerTurnId: null,
+      nativeItemRef: null,
+      parentItemId: null,
+      ordinal: 7,
+      status: "completed",
+      title: "Forked subagent thread",
+      source: { type: "node", nodeId: "node-subagent-1" },
+      targetThreadId: "thread-fork-1",
+      startedAt: now,
+      completedAt: now,
+      updatedAt: now,
+    });
+
+    expect(compaction.type).toBe("compaction");
+    expect(compaction.status).toBe("running");
+    expect(handoff.type).toBe("handoff");
+    if (handoff.type !== "handoff") {
+      throw new Error("expected handoff");
+    }
+    expect(handoff.toProviderInstanceId).toBe("claudeAgent");
+    expect(fork.type).toBe("fork");
+  });
+
+  it("exports the V2 branded ids through the public contracts entrypoint", () => {
+    expect(ThreadId.make("thread-1")).toBe("thread-1");
+    expect(ProjectId.make("project-1")).toBe("project-1");
+    expect(MessageId.make("message-1")).toBe("message-1");
+    expect(NodeId.make("node-1")).toBe("node-1");
+    expect(ProviderThreadId.make("provider-thread-1")).toBe("provider-thread-1");
+    expect(CheckpointRef.make("git-ref-1")).toBe("git-ref-1");
+    expect(ContextTransferId.make("context-transfer-1")).toBe("context-transfer-1");
+  });
+
+  it("decodes historical provider-thread JSON without pendingBackgroundTasks as empty roster", () => {
+    const providerThread = decodeOrchestrationV2ProviderThreadJson({
+      id: "provider-thread-1",
+      driver: "claude",
+      providerInstanceId: "claudeAgent",
+      providerSessionId: "provider-session-1",
+      appThreadId: "thread-1",
+      ownerNodeId: null,
+      nativeThreadRef: {
+        driver: "claude",
+        nativeId: "native-session-1",
+        strength: "strong",
+      },
+      nativeConversationHeadRef: null,
+      status: "idle",
+      firstRunOrdinal: 1,
+      lastRunOrdinal: 1,
+      handoffIds: [],
+      forkedFrom: null,
+      createdAt: "2026-04-20T00:00:00.000Z",
+      updatedAt: "2026-04-20T00:00:00.000Z",
+    });
+
+    expect(providerThread.pendingBackgroundTasks).toEqual([]);
+
+    const runtimeThread = decodeOrchestrationV2ProviderThread({
+      id: "provider-thread-2",
+      driver: "claude",
+      providerInstanceId: "claudeAgent",
+      providerSessionId: null,
+      appThreadId: "thread-2",
+      ownerNodeId: null,
+      nativeThreadRef: null,
+      nativeConversationHeadRef: null,
+      status: "idle",
+      firstRunOrdinal: null,
+      lastRunOrdinal: null,
+      handoffIds: [],
+      forkedFrom: null,
+      createdAt: now,
+      updatedAt: now,
+    });
+    expect(runtimeThread.pendingBackgroundTasks).toEqual([]);
+  });
+
+  it("decodes historical thread shell JSON without pendingBackgroundTasks as empty roster", () => {
+    const shell = decodeOrchestrationV2ThreadShell({
+      createdBy: "user",
+      creationSource: "web",
+      id: "thread-1",
+      projectId: "project-1",
+      title: "Thread",
+      providerInstanceId: "claudeAgent",
+      modelSelection: {
+        instanceId: ProviderInstanceId.make("claudeAgent"),
+        model: "claude-sonnet",
+      },
+      runtimeMode: "full-access",
+      interactionMode: "default",
+      branch: null,
+      worktreePath: null,
+      lineage: {
+        parentThreadId: null,
+        relationshipToParent: null,
+        rootThreadId: "thread-1",
+      },
+      forkedFrom: null,
+      activeProviderThreadId: "provider-thread-1",
+      latestRunId: "run-1",
+      activeRunId: null,
+      status: "completed",
+      pendingRuntimeRequest: null,
+      latestVisibleMessage: null,
+      latestUserMessageAt: null,
+      hasActionableProposedPlan: false,
+      itemCount: 0,
+      visibleItemCount: 0,
+      createdAt: now,
+      updatedAt: now,
+      archivedAt: null,
+      settledOverride: null,
+      settledAt: null,
+      deletedAt: null,
+    });
+
+    expect(shell.pendingBackgroundTasks).toEqual([]);
+  });
+});
diff --git a/packages/contracts/src/orchestrationV2.ts b/packages/contracts/src/orchestrationV2.ts
new file mode 100644
index 000000000000..d14f1dcebea3
--- /dev/null
+++ b/packages/contracts/src/orchestrationV2.ts
@@ -0,0 +1,2681 @@
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+
+import {
+  CheckpointId,
+  CheckpointRef,
+  CheckpointScopeId,
+  CommandId,
+  ContextHandoffId,
+  ContextTransferId,
+  EventId,
+  IsoDateTime,
+  MessageId,
+  NodeId,
+  NonNegativeInt,
+  PlanId,
+  PositiveInt,
+  ProjectId,
+  ProviderSessionId,
+  ProviderThreadId,
+  ProviderTurnId,
+  RawEventId,
+  RunAttemptId,
+  RunId,
+  RuntimeRequestId,
+  ThreadId,
+  TrimmedNonEmptyString,
+  TurnItemId,
+} from "./baseSchemas.ts";
+import { ChatAttachment } from "./chatAttachment.ts";
+import {
+  OrchestrationGetFullThreadDiffInput,
+  OrchestrationGetFullThreadDiffResult,
+  OrchestrationGetTurnDiffInput,
+  OrchestrationGetTurnDiffResult,
+} from "./checkpointDiff.ts";
+import { ModelSelection } from "./modelSelection.ts";
+import { ThreadLinkedPullRequest } from "./orchestration.ts";
+import {
+  ProviderApprovalDecision,
+  ProviderApprovalOption,
+  ProviderInteractionMode,
+  ProviderRequestKind,
+  ProviderUserInputAnswers,
+  RuntimeMode,
+} from "./providerPolicy.ts";
+import { ProviderDriverKind, ProviderInstanceId } from "./providerInstance.ts";
+import { OrchestrationProjectShell } from "./orchestrationProject.ts";
+
+export const OrchestrationV2Actor = Schema.Literals(["user", "agent", "system"]);
+export type OrchestrationV2Actor = typeof OrchestrationV2Actor.Type;
+
+export const OrchestrationV2CreationSource = Schema.Literals([
+  "web",
+  "mobile",
+  "mcp",
+  "provider",
+  "server",
+]);
+export type OrchestrationV2CreationSource = typeof OrchestrationV2CreationSource.Type;
+
+export const OrchestrationV2ThreadHistoryOrigin = Schema.Literals(["native", "v1_import"]);
+export type OrchestrationV2ThreadHistoryOrigin = typeof OrchestrationV2ThreadHistoryOrigin.Type;
+
+const OrchestrationV2CreationFields = {
+  createdBy: OrchestrationV2Actor,
+  creationSource: OrchestrationV2CreationSource,
+} as const;
+
+export const OrchestrationV2NativeRefStrength = Schema.Literals(["strong", "weak", "none"]);
+export type OrchestrationV2NativeRefStrength = typeof OrchestrationV2NativeRefStrength.Type;
+
+export const OrchestrationV2ProviderRef = Schema.Struct({
+  driver: ProviderDriverKind,
+  nativeId: Schema.NullOr(TrimmedNonEmptyString),
+  strength: OrchestrationV2NativeRefStrength,
+  fingerprint: Schema.optional(TrimmedNonEmptyString),
+  ordinal: Schema.optional(NonNegativeInt),
+});
+export type OrchestrationV2ProviderRef = typeof OrchestrationV2ProviderRef.Type;
+
+export const OrchestrationV2AppThreadLineage = Schema.Struct({
+  parentThreadId: Schema.NullOr(ThreadId),
+  relationshipToParent: Schema.NullOr(Schema.Literals(["fork", "subagent"])),
+  rootThreadId: ThreadId,
+});
+export type OrchestrationV2AppThreadLineage = typeof OrchestrationV2AppThreadLineage.Type;
+
+export const OrchestrationV2ContextTransferType = Schema.Literals([
+  "fork",
+  "provider_handoff",
+  "merge_back",
+  "subagent_spawn",
+  "subagent_result",
+]);
+export type OrchestrationV2ContextTransferType = typeof OrchestrationV2ContextTransferType.Type;
+
+export const OrchestrationV2ContextSourcePoint = Schema.Struct({
+  threadId: ThreadId,
+  runId: Schema.optional(RunId),
+  checkpointId: Schema.optional(CheckpointId),
+  turnItemId: Schema.optional(TurnItemId),
+  providerThreadRef: Schema.optional(OrchestrationV2ProviderRef),
+  providerTurnRef: Schema.optional(OrchestrationV2ProviderRef),
+});
+export type OrchestrationV2ContextSourcePoint = typeof OrchestrationV2ContextSourcePoint.Type;
+
+export const OrchestrationV2ThreadForkSourcePoint = Schema.Union([
+  Schema.Struct({ type: Schema.Literal("latest_stable") }),
+  Schema.Struct({ type: Schema.Literal("run"), runId: RunId }),
+  Schema.Struct({ type: Schema.Literal("checkpoint"), checkpointId: CheckpointId }),
+]);
+export type OrchestrationV2ThreadForkSourcePoint = typeof OrchestrationV2ThreadForkSourcePoint.Type;
+
+export const OrchestrationV2ContextTransferResolution = Schema.Union([
+  Schema.Struct({
+    strategy: Schema.Literal("native_fork"),
+    providerThreadRef: OrchestrationV2ProviderRef,
+  }),
+  Schema.Struct({
+    strategy: Schema.Literal("portable_context"),
+    contextHandoffId: ContextHandoffId,
+  }),
+  Schema.Struct({
+    strategy: Schema.Literal("delta_context"),
+    contextHandoffId: ContextHandoffId,
+  }),
+  Schema.Struct({
+    strategy: Schema.Literal("fork_delta_context"),
+    contextHandoffId: ContextHandoffId,
+  }),
+  Schema.Struct({
+    strategy: Schema.Literal("checkpoint_context"),
+    contextHandoffId: ContextHandoffId,
+  }),
+]);
+export type OrchestrationV2ContextTransferResolution =
+  typeof OrchestrationV2ContextTransferResolution.Type;
+
+export const OrchestrationV2ContextTransfer = Schema.Struct({
+  id: ContextTransferId,
+  type: OrchestrationV2ContextTransferType,
+  sourceThreadId: ThreadId,
+  targetThreadId: ThreadId,
+  sourcePoint: OrchestrationV2ContextSourcePoint,
+  basePoint: Schema.NullOr(OrchestrationV2ContextSourcePoint),
+  sourceProviderInstanceId: Schema.NullOr(ProviderInstanceId),
+  targetProviderInstanceId: Schema.NullOr(ProviderInstanceId),
+  targetRunId: Schema.NullOr(RunId),
+  status: Schema.Literals([
+    "pending",
+    "resolved_native",
+    "resolved_portable",
+    "failed",
+    "consumed",
+    "superseded",
+  ]),
+  resolution: Schema.NullOr(OrchestrationV2ContextTransferResolution),
+  createdBy: OrchestrationV2Actor,
+  error: Schema.NullOr(Schema.String),
+  createdAt: Schema.DateTimeUtc,
+  updatedAt: Schema.DateTimeUtc,
+  consumedAt: Schema.NullOr(Schema.DateTimeUtc),
+});
+export type OrchestrationV2ContextTransfer = typeof OrchestrationV2ContextTransfer.Type;
+
+export const OrchestrationV2SessionCapabilities = Schema.Struct({
+  supportsMultipleProviderThreadsPerSession: Schema.Boolean,
+  supportsModelSwitchInSession: Schema.Boolean,
+  supportsProviderSwitchingViaHandoff: Schema.Boolean,
+  supportsRuntimeModeSwitchInSession: Schema.Boolean,
+  pendingRequestsSurviveRestart: Schema.Boolean,
+});
+export type OrchestrationV2SessionCapabilities = typeof OrchestrationV2SessionCapabilities.Type;
+
+export const OrchestrationV2ThreadCapabilities = Schema.Struct({
+  canCreateEmptyThread: Schema.Boolean,
+  canReadThreadSnapshot: Schema.Boolean,
+  canRollbackThread: Schema.Boolean,
+  canForkThread: Schema.Boolean,
+  canForkFromTurn: Schema.Boolean,
+  canForkFromSubagentThread: Schema.Boolean,
+  exposesNativeThreadId: Schema.Boolean,
+});
+export type OrchestrationV2ThreadCapabilities = typeof OrchestrationV2ThreadCapabilities.Type;
+
+export const OrchestrationV2TurnCapabilities = Schema.Struct({
+  exposesNativeTurnId: Schema.Boolean,
+  emitsTurnStarted: Schema.Boolean,
+  emitsTurnCompleted: Schema.Boolean,
+  supportsInterrupt: Schema.Boolean,
+  supportsActiveSteering: Schema.Boolean,
+  supportsSteeringByInterruptRestart: Schema.Boolean,
+  supportsQueuedMessages: Schema.Boolean,
+  terminalStatusQuality: Schema.Literals(["strong", "weak", "none"]),
+});
+export type OrchestrationV2TurnCapabilities = typeof OrchestrationV2TurnCapabilities.Type;
+
+export const OrchestrationV2StreamingCapabilities = Schema.Struct({
+  streamsAssistantText: Schema.Boolean,
+  streamsReasoning: Schema.Boolean,
+  streamsToolOutput: Schema.Boolean,
+  streamsPlanText: Schema.Boolean,
+  emitsMessageCompleted: Schema.Boolean,
+});
+export type OrchestrationV2StreamingCapabilities = typeof OrchestrationV2StreamingCapabilities.Type;
+
+export const OrchestrationV2ToolCapabilities = Schema.Struct({
+  exposesToolItemIds: Schema.Boolean,
+  emitsToolStarted: Schema.Boolean,
+  emitsToolCompleted: Schema.Boolean,
+  emitsToolOutput: Schema.Boolean,
+  supportsMcpTools: Schema.Boolean,
+  supportsDynamicToolCallbacks: Schema.Boolean,
+});
+export type OrchestrationV2ToolCapabilities = typeof OrchestrationV2ToolCapabilities.Type;
+
+export const OrchestrationV2ApprovalCapabilities = Schema.Struct({
+  supportsCommandApproval: Schema.Boolean,
+  supportsFileReadApproval: Schema.Boolean,
+  supportsFileChangeApproval: Schema.Boolean,
+  supportsApplyPatchApproval: Schema.Boolean,
+  approvalsHaveNativeRequestIds: Schema.Boolean,
+  approvalCallbacksAreLiveOnly: Schema.Boolean,
+  approvalsCanOriginateFromSubagents: Schema.Boolean,
+});
+export type OrchestrationV2ApprovalCapabilities = typeof OrchestrationV2ApprovalCapabilities.Type;
+
+export const OrchestrationV2PlanningCapabilities = Schema.Struct({
+  emitsPlanUpdated: Schema.Boolean,
+  emitsTodoList: Schema.Boolean,
+  emitsProposedPlan: Schema.Boolean,
+  supportsStructuredQuestions: Schema.Boolean,
+  planDeltasHaveItemIds: Schema.Boolean,
+});
+export type OrchestrationV2PlanningCapabilities = typeof OrchestrationV2PlanningCapabilities.Type;
+
+export const OrchestrationV2SubagentCapabilities = Schema.Struct({
+  supportsSubagents: Schema.Boolean,
+  exposesSubagentThreadIds: Schema.Boolean,
+  emitsSubagentLifecycle: Schema.Boolean,
+  canWaitForSubagents: Schema.Boolean,
+  canCloseSubagents: Schema.Boolean,
+  canForkSubagentThread: Schema.Boolean,
+});
+export type OrchestrationV2SubagentCapabilities = typeof OrchestrationV2SubagentCapabilities.Type;
+
+export const OrchestrationV2ContextCapabilities = Schema.Struct({
+  acceptsSystemContext: Schema.Boolean,
+  acceptsDeveloperContext: Schema.Boolean,
+  acceptsSyntheticUserContext: Schema.Boolean,
+  canGenerateSummaries: Schema.Boolean,
+  canConsumeHandoffSummaries: Schema.Boolean,
+  supportsDeltaHandoff: Schema.Boolean,
+  supportsFullThreadHandoff: Schema.Boolean,
+  maxRecommendedHandoffChars: Schema.NullOr(PositiveInt),
+});
+export type OrchestrationV2ContextCapabilities = typeof OrchestrationV2ContextCapabilities.Type;
+
+export const OrchestrationV2CheckpointCapabilities = Schema.Struct({
+  appCanCheckpointFilesystem: Schema.Boolean,
+  supportsNestedCheckpointScopes: Schema.Boolean,
+  providerCanRollbackConversation: Schema.Boolean,
+  providerRollbackReturnsSnapshot: Schema.Boolean,
+  providerCanReadConversationSnapshot: Schema.Boolean,
+});
+export type OrchestrationV2CheckpointCapabilities =
+  typeof OrchestrationV2CheckpointCapabilities.Type;
+
+export const OrchestrationV2IdentityCapabilities = Schema.Struct({
+  nativeThreadIds: OrchestrationV2NativeRefStrength,
+  nativeTurnIds: OrchestrationV2NativeRefStrength,
+  nativeItemIds: OrchestrationV2NativeRefStrength,
+  nativeRequestIds: OrchestrationV2NativeRefStrength,
+});
+export type OrchestrationV2IdentityCapabilities = typeof OrchestrationV2IdentityCapabilities.Type;
+
+export const OrchestrationV2ProviderCapabilities = Schema.Struct({
+  sessions: OrchestrationV2SessionCapabilities,
+  threads: OrchestrationV2ThreadCapabilities,
+  turns: OrchestrationV2TurnCapabilities,
+  streaming: OrchestrationV2StreamingCapabilities,
+  tools: OrchestrationV2ToolCapabilities,
+  approvals: OrchestrationV2ApprovalCapabilities,
+  planning: OrchestrationV2PlanningCapabilities,
+  subagents: OrchestrationV2SubagentCapabilities,
+  context: OrchestrationV2ContextCapabilities,
+  checkpointing: OrchestrationV2CheckpointCapabilities,
+  identity: OrchestrationV2IdentityCapabilities,
+});
+export type OrchestrationV2ProviderCapabilities = typeof OrchestrationV2ProviderCapabilities.Type;
+
+export const OrchestrationV2AppThread = Schema.Struct({
+  ...OrchestrationV2CreationFields,
+  id: ThreadId,
+  projectId: ProjectId,
+  title: TrimmedNonEmptyString,
+  providerInstanceId: ProviderInstanceId,
+  modelSelection: ModelSelection,
+  runtimeMode: RuntimeMode,
+  interactionMode: ProviderInteractionMode,
+  branch: Schema.NullOr(TrimmedNonEmptyString),
+  worktreePath: Schema.NullOr(TrimmedNonEmptyString),
+  /** Pull request the user linked to this thread (#8160); optional so
+      pre-linking servers still decode. */
+  linkedPullRequest: Schema.optional(Schema.NullOr(ThreadLinkedPullRequest)),
+  activeProviderThreadId: Schema.NullOr(ProviderThreadId),
+  historyOrigin: Schema.optional(OrchestrationV2ThreadHistoryOrigin),
+  lineage: OrchestrationV2AppThreadLineage,
+  forkedFrom: Schema.NullOr(
+    Schema.Union([
+      Schema.Struct({ type: Schema.Literal("run"), threadId: ThreadId, runId: RunId }),
+      Schema.Struct({ type: Schema.Literal("node"), nodeId: NodeId }),
+      Schema.Struct({
+        type: Schema.Literal("provider_thread"),
+        providerThreadId: ProviderThreadId,
+        providerTurnId: Schema.optional(ProviderTurnId),
+      }),
+    ]),
+  ),
+  createdAt: Schema.DateTimeUtc,
+  updatedAt: Schema.DateTimeUtc,
+  archivedAt: Schema.NullOr(Schema.DateTimeUtc),
+  settledOverride: Schema.NullOr(Schema.Literals(["settled", "active"])).pipe(
+    Schema.withDecodingDefault(Effect.succeed(null)),
+  ),
+  settledAt: Schema.NullOr(Schema.DateTimeUtc).pipe(
+    Schema.withDecodingDefault(Effect.succeed(null)),
+  ),
+  unsettledAt: Schema.optional(Schema.NullOr(Schema.DateTimeUtc)),
+  snoozedUntil: Schema.optional(Schema.NullOr(Schema.DateTimeUtc)),
+  snoozedAt: Schema.optional(Schema.NullOr(Schema.DateTimeUtc)),
+  pinnedAt: Schema.optional(Schema.NullOr(Schema.DateTimeUtc)),
+  // Fractional-index slot in the user-arranged pinned order. Optional so
+  // payloads from pre-reorder servers still decode.
+  pinOrderKey: Schema.optional(Schema.NullOr(TrimmedNonEmptyString)),
+  lastVisitedAt: Schema.NullOr(Schema.DateTimeUtc).pipe(
+    Schema.withDecodingDefault(Effect.succeed(null)),
+  ),
+  /** In-flight title regeneration marker; cleared when a new title lands. */
+  titleRegeneration: Schema.optional(
+    Schema.NullOr(
+      Schema.Struct({
+        requestId: CommandId,
+        startedAt: Schema.DateTimeUtc,
+      }),
+    ),
+  ),
+  deletedAt: Schema.NullOr(Schema.DateTimeUtc),
+});
+export type OrchestrationV2AppThread = typeof OrchestrationV2AppThread.Type;
+
+export const OrchestrationV2RunStatus = Schema.Literals([
+  "preparing",
+  "queued",
+  "starting",
+  "running",
+  "waiting",
+  "completed",
+  "interrupted",
+  "failed",
+  "cancelled",
+  "rolled_back",
+]);
+export type OrchestrationV2RunStatus = typeof OrchestrationV2RunStatus.Type;
+
+export const OrchestrationV2DelegatedCompletionTaskDeliveryState = Schema.Literals([
+  "pending",
+  "claimed",
+  "acknowledged",
+  "delivered",
+  "disposed",
+]);
+export type OrchestrationV2DelegatedCompletionTaskDeliveryState =
+  typeof OrchestrationV2DelegatedCompletionTaskDeliveryState.Type;
+
+export const OrchestrationV2DelegatedCompletionTaskDelivery = Schema.Struct({
+  state: OrchestrationV2DelegatedCompletionTaskDeliveryState,
+  observedByRunId: Schema.NullOr(RunId),
+});
+export type OrchestrationV2DelegatedCompletionTaskDelivery =
+  typeof OrchestrationV2DelegatedCompletionTaskDelivery.Type;
+
+export const OrchestrationV2DelegatedCompletionDelivery = Schema.Struct({
+  generation: PositiveInt,
+  messageId: MessageId,
+  taskIds: Schema.Array(NodeId),
+});
+export type OrchestrationV2DelegatedCompletionDelivery =
+  typeof OrchestrationV2DelegatedCompletionDelivery.Type;
+
+export const OrchestrationV2DelegatedCompletionCohort = Schema.Struct({
+  disposition: Schema.Literals(["open", "stopped", "disposed"]),
+  nextGeneration: PositiveInt,
+  // Optional for compatibility with cohorts persisted before bounded
+  // follow-up delivery was introduced. Missing means no delivery has settled.
+  settledDeliveryCount: Schema.optional(NonNegativeInt),
+  delivery: Schema.NullOr(OrchestrationV2DelegatedCompletionDelivery),
+});
+export type OrchestrationV2DelegatedCompletionCohort =
+  typeof OrchestrationV2DelegatedCompletionCohort.Type;
+
+export const OrchestrationV2Run = Schema.Struct({
+  id: RunId,
+  threadId: ThreadId,
+  ordinal: PositiveInt,
+  providerInstanceId: ProviderInstanceId,
+  modelSelection: ModelSelection,
+  providerThreadId: Schema.NullOr(ProviderThreadId),
+  userMessageId: MessageId,
+  rootNodeId: Schema.NullOr(NodeId),
+  activeAttemptId: Schema.NullOr(RunAttemptId),
+  status: OrchestrationV2RunStatus,
+  queuePosition: Schema.optional(Schema.NullOr(PositiveInt)),
+  requestedAt: Schema.DateTimeUtc,
+  startedAt: Schema.NullOr(Schema.DateTimeUtc),
+  completedAt: Schema.NullOr(Schema.DateTimeUtc),
+  checkpointId: Schema.NullOr(CheckpointId),
+  contextHandoffId: Schema.NullOr(ContextHandoffId),
+  sourcePlanRef: Schema.optional(
+    Schema.Struct({
+      threadId: ThreadId,
+      planId: PlanId,
+    }),
+  ),
+  delegatedCompletion: Schema.optional(OrchestrationV2DelegatedCompletionCohort),
+});
+export type OrchestrationV2Run = typeof OrchestrationV2Run.Type;
+
+export const OrchestrationV2RunAttempt = Schema.Struct({
+  id: RunAttemptId,
+  runId: RunId,
+  attemptOrdinal: PositiveInt,
+  rootNodeId: NodeId,
+  providerInstanceId: ProviderInstanceId,
+  providerThreadId: ProviderThreadId,
+  providerTurnId: Schema.NullOr(ProviderTurnId),
+  reason: Schema.Literals(["initial", "steering_restart", "retry", "provider_recovery"]),
+  status: Schema.Literals([
+    "pending",
+    "running",
+    "completed",
+    "interrupted",
+    "failed",
+    "cancelled",
+    "superseded",
+  ]),
+  startedAt: Schema.NullOr(Schema.DateTimeUtc),
+  completedAt: Schema.NullOr(Schema.DateTimeUtc),
+});
+export type OrchestrationV2RunAttempt = typeof OrchestrationV2RunAttempt.Type;
+
+export const OrchestrationV2ExecutionNode = Schema.Struct({
+  id: NodeId,
+  threadId: ThreadId,
+  runId: Schema.NullOr(RunId),
+  parentNodeId: Schema.NullOr(NodeId),
+  rootNodeId: NodeId,
+  kind: Schema.Literals([
+    "root_turn",
+    "assistant_message",
+    "reasoning",
+    "plan",
+    "todo_list",
+    "tool_call",
+    "approval_request",
+    "user_input_request",
+    "subagent",
+    "hook",
+    "system",
+  ]),
+  status: Schema.Literals([
+    "pending",
+    "running",
+    "waiting",
+    "completed",
+    "interrupted",
+    "failed",
+    "cancelled",
+    "rolled_back",
+  ]),
+  countsForRun: Schema.Boolean,
+  providerThreadId: Schema.NullOr(ProviderThreadId),
+  providerTurnId: Schema.NullOr(ProviderTurnId),
+  nativeItemRef: Schema.NullOr(OrchestrationV2ProviderRef),
+  runtimeRequestId: Schema.NullOr(RuntimeRequestId),
+  checkpointScopeId: Schema.NullOr(CheckpointScopeId),
+  startedAt: Schema.NullOr(Schema.DateTimeUtc),
+  completedAt: Schema.NullOr(Schema.DateTimeUtc),
+});
+export type OrchestrationV2ExecutionNode = typeof OrchestrationV2ExecutionNode.Type;
+
+export const OrchestrationV2Subagent = Schema.Struct({
+  id: NodeId,
+  threadId: ThreadId,
+  runId: Schema.NullOr(RunId),
+  parentNodeId: NodeId,
+  origin: Schema.Literals(["provider_native", "app_owned"]),
+  createdBy: OrchestrationV2Actor,
+  driver: ProviderDriverKind,
+  providerInstanceId: ProviderInstanceId,
+  providerThreadId: Schema.NullOr(ProviderThreadId),
+  childThreadId: Schema.NullOr(ThreadId),
+  nativeTaskRef: Schema.NullOr(OrchestrationV2ProviderRef),
+  prompt: Schema.String,
+  title: Schema.NullOr(Schema.String),
+  model: Schema.NullOr(Schema.String),
+  // Parent-wake policy for app-owned tasks: "always" offers a continuation on
+  // every terminal (async delegations; queue_after_active sequences it behind
+  // a live parent run), "settled_only" offers only when the parent has no
+  // live run (wait-mode delegations, whose result returns through the
+  // blocking tool call). Absent on legacy records; treated as settled_only.
+  completionWake: Schema.optional(Schema.Literals(["always", "settled_only"])),
+  completionDelivery: Schema.optional(OrchestrationV2DelegatedCompletionTaskDelivery),
+  status: Schema.Literals([
+    "pending",
+    "running",
+    "waiting",
+    "completed",
+    "failed",
+    "cancelled",
+    "interrupted",
+  ]),
+  progress: Schema.optional(Schema.String),
+  result: Schema.NullOr(Schema.String),
+  startedAt: Schema.NullOr(Schema.DateTimeUtc),
+  completedAt: Schema.NullOr(Schema.DateTimeUtc),
+  updatedAt: Schema.DateTimeUtc,
+});
+export type OrchestrationV2Subagent = typeof OrchestrationV2Subagent.Type;
+
+export const OrchestrationV2CheckpointScope = Schema.Struct({
+  id: CheckpointScopeId,
+  threadId: ThreadId,
+  runId: Schema.NullOr(RunId),
+  nodeId: NodeId,
+  parentScopeId: Schema.NullOr(CheckpointScopeId),
+  providerThreadId: Schema.NullOr(ProviderThreadId),
+  kind: Schema.Literals(["root_run", "subagent", "tool", "provider_thread", "manual"]),
+  ordinalWithinParent: NonNegativeInt,
+  advancesAppRunCount: Schema.Boolean,
+  cwd: TrimmedNonEmptyString,
+  createdAt: Schema.DateTimeUtc,
+});
+export type OrchestrationV2CheckpointScope = typeof OrchestrationV2CheckpointScope.Type;
+
+export const OrchestrationV2ProviderSession = Schema.Struct({
+  id: ProviderSessionId,
+  driver: ProviderDriverKind,
+  providerInstanceId: ProviderInstanceId,
+  status: Schema.Literals(["starting", "ready", "running", "waiting", "stopped", "error"]),
+  cwd: TrimmedNonEmptyString,
+  model: Schema.NullOr(TrimmedNonEmptyString),
+  capabilities: OrchestrationV2ProviderCapabilities,
+  createdAt: Schema.DateTimeUtc,
+  updatedAt: Schema.DateTimeUtc,
+  lastError: Schema.NullOr(Schema.String),
+});
+export type OrchestrationV2ProviderSession = typeof OrchestrationV2ProviderSession.Type;
+
+export const OrchestrationV2ProviderSessionDetached = Schema.Struct({
+  providerSessionId: ProviderSessionId,
+  detachedAt: Schema.DateTimeUtc,
+  reason: Schema.optional(Schema.String),
+});
+export type OrchestrationV2ProviderSessionDetached =
+  typeof OrchestrationV2ProviderSessionDetached.Type;
+
+/**
+ * Provider-owned background work that can outlive the root turn (for example a
+ * Claude background Bash task). Associated with the provider thread so shared
+ * runtimes cannot make an unrelated app thread look busy.
+ */
+export const OrchestrationV2PendingBackgroundTask = Schema.Struct({
+  taskId: TrimmedNonEmptyString,
+  description: Schema.optional(TrimmedNonEmptyString),
+  taskType: Schema.optional(TrimmedNonEmptyString),
+});
+export type OrchestrationV2PendingBackgroundTask = typeof OrchestrationV2PendingBackgroundTask.Type;
+
+export const OrchestrationV2ProviderThread = Schema.Struct({
+  id: ProviderThreadId,
+  driver: ProviderDriverKind,
+  providerInstanceId: ProviderInstanceId,
+  providerSessionId: Schema.NullOr(ProviderSessionId),
+  appThreadId: Schema.NullOr(ThreadId),
+  ownerNodeId: Schema.NullOr(NodeId),
+  nativeThreadRef: Schema.NullOr(OrchestrationV2ProviderRef),
+  nativeConversationHeadRef: Schema.NullOr(OrchestrationV2ProviderRef),
+  status: Schema.Literals(["not_loaded", "idle", "active", "archived", "closed", "error"]),
+  firstRunOrdinal: Schema.NullOr(PositiveInt),
+  lastRunOrdinal: Schema.NullOr(PositiveInt),
+  handoffIds: Schema.Array(ContextHandoffId),
+  forkedFrom: Schema.NullOr(
+    Schema.Struct({
+      providerThreadId: ProviderThreadId,
+      providerTurnId: Schema.optional(ProviderTurnId),
+      checkpointId: Schema.optional(CheckpointId),
+    }),
+  ),
+  // Optional Type so adapters can omit empty rosters; historical JSON decodes to [].
+  pendingBackgroundTasks: Schema.optional(Schema.Array(OrchestrationV2PendingBackgroundTask)).pipe(
+    Schema.withDecodingDefault(Effect.succeed([])),
+  ),
+  createdAt: Schema.DateTimeUtc,
+  updatedAt: Schema.DateTimeUtc,
+});
+export type OrchestrationV2ProviderThread = typeof OrchestrationV2ProviderThread.Type;
+
+export const OrchestrationV2ContextHandoff = Schema.Struct({
+  id: ContextHandoffId,
+  transferId: Schema.optional(Schema.NullOr(ContextTransferId)),
+  threadId: ThreadId,
+  targetRunId: RunId,
+  fromProviderThreadIds: Schema.Array(ProviderThreadId),
+  toProviderThreadId: ProviderThreadId,
+  coveredRunOrdinals: Schema.Struct({
+    from: PositiveInt,
+    to: PositiveInt,
+  }),
+  strategy: Schema.Literals([
+    "delta_since_target_last_seen",
+    "fork_delta_summary",
+    "full_thread_summary",
+    "checkpoint_summary",
+    "manual_context",
+  ]),
+  status: Schema.Literals(["pending", "ready", "failed", "superseded"]),
+  summaryMessageId: Schema.NullOr(MessageId),
+  summaryText: Schema.String,
+  detailInTurnItem: Schema.optional(Schema.Literal(true)),
+  createdByProviderInstanceId: Schema.NullOr(ProviderInstanceId),
+  createdAt: Schema.DateTimeUtc,
+  updatedAt: Schema.DateTimeUtc,
+});
+export type OrchestrationV2ContextHandoff = typeof OrchestrationV2ContextHandoff.Type;
+
+/** Live context usage reported by the provider mid-turn (#8144). */
+export const OrchestrationV2ProviderTurnTokenUsage = Schema.Struct({
+  usedTokens: NonNegativeInt,
+  maxTokens: Schema.optional(Schema.NullOr(NonNegativeInt)),
+  inputTokens: Schema.optional(NonNegativeInt),
+  cachedInputTokens: Schema.optional(NonNegativeInt),
+  outputTokens: Schema.optional(NonNegativeInt),
+  reasoningOutputTokens: Schema.optional(NonNegativeInt),
+  /** ISO timestamp of the provider's report; string so wire encoding is stable. */
+  updatedAt: Schema.String,
+});
+export type OrchestrationV2ProviderTurnTokenUsage =
+  typeof OrchestrationV2ProviderTurnTokenUsage.Type;
+
+export const OrchestrationV2ProviderTurn = Schema.Struct({
+  id: ProviderTurnId,
+  providerThreadId: ProviderThreadId,
+  nodeId: NodeId,
+  runAttemptId: Schema.NullOr(RunAttemptId),
+  nativeTurnRef: Schema.NullOr(OrchestrationV2ProviderRef),
+  ordinal: PositiveInt,
+  status: Schema.Literals([
+    "pending",
+    "running",
+    "completed",
+    "interrupted",
+    "failed",
+    "cancelled",
+  ]),
+  startedAt: Schema.NullOr(Schema.DateTimeUtc),
+  completedAt: Schema.NullOr(Schema.DateTimeUtc),
+  tokenUsage: Schema.optional(OrchestrationV2ProviderTurnTokenUsage),
+});
+export type OrchestrationV2ProviderTurn = typeof OrchestrationV2ProviderTurn.Type;
+
+export const OrchestrationV2RuntimeRequest = Schema.Struct({
+  id: RuntimeRequestId,
+  nodeId: NodeId,
+  providerTurnId: Schema.NullOr(ProviderTurnId),
+  nativeRequestRef: Schema.NullOr(OrchestrationV2ProviderRef),
+  kind: Schema.Union([
+    ProviderRequestKind,
+    Schema.Literals(["dynamic_tool_call", "user_input", "auth_refresh"]),
+  ]),
+  status: Schema.Literals(["pending", "resolved", "expired", "cancelled"]),
+  responseCapability: Schema.Union([
+    Schema.Struct({ type: Schema.Literal("live"), providerSessionId: ProviderSessionId }),
+    Schema.Struct({ type: Schema.Literal("not_resumable"), reason: Schema.String }),
+  ]),
+  createdAt: Schema.DateTimeUtc,
+  resolvedAt: Schema.NullOr(Schema.DateTimeUtc),
+});
+export type OrchestrationV2RuntimeRequest = typeof OrchestrationV2RuntimeRequest.Type;
+
+export const OrchestrationV2ConversationMessage = Schema.Struct({
+  ...OrchestrationV2CreationFields,
+  id: MessageId,
+  threadId: ThreadId,
+  runId: Schema.NullOr(RunId),
+  nodeId: Schema.NullOr(NodeId),
+  role: Schema.Literals(["user", "assistant", "system"]),
+  text: Schema.String,
+  attachments: Schema.Array(ChatAttachment),
+  streaming: Schema.Boolean,
+  createdAt: Schema.DateTimeUtc,
+  updatedAt: Schema.DateTimeUtc,
+  delegatedCompletion: Schema.optional(
+    Schema.Struct({
+      parentRunId: RunId,
+      generation: PositiveInt,
+      taskIds: Schema.Array(NodeId),
+    }),
+  ),
+});
+export type OrchestrationV2ConversationMessage = typeof OrchestrationV2ConversationMessage.Type;
+
+export const OrchestrationV2PlanStep = Schema.Struct({
+  id: TrimmedNonEmptyString,
+  text: TrimmedNonEmptyString,
+  status: Schema.Literals(["pending", "running", "completed"]),
+});
+export type OrchestrationV2PlanStep = typeof OrchestrationV2PlanStep.Type;
+
+export const OrchestrationV2UserInputQuestion = Schema.Struct({
+  id: TrimmedNonEmptyString,
+  header: TrimmedNonEmptyString,
+  question: TrimmedNonEmptyString,
+  options: Schema.Array(
+    Schema.Struct({
+      label: TrimmedNonEmptyString,
+      description: TrimmedNonEmptyString,
+    }),
+  ),
+  multiSelect: Schema.optional(Schema.Boolean),
+});
+export type OrchestrationV2UserInputQuestion = typeof OrchestrationV2UserInputQuestion.Type;
+
+const OrchestrationV2PlanArtifactBaseFields = {
+  id: PlanId,
+  threadId: ThreadId,
+  runId: Schema.NullOr(RunId),
+  nodeId: NodeId,
+  status: Schema.Literals(["draft", "active", "completed", "superseded"]),
+  detailInTurnItem: Schema.optional(Schema.Literal(true)),
+} as const;
+
+export const OrchestrationV2PlanArtifact = Schema.Union([
+  Schema.Struct({
+    ...OrchestrationV2PlanArtifactBaseFields,
+    kind: Schema.Literal("proposed_plan"),
+    markdown: Schema.String,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2PlanArtifactBaseFields,
+    kind: Schema.Literal("todo_list"),
+    steps: Schema.Array(OrchestrationV2PlanStep),
+    explanation: Schema.optional(Schema.String),
+  }),
+]);
+export type OrchestrationV2PlanArtifact = typeof OrchestrationV2PlanArtifact.Type;
+
+export const OrchestrationV2CheckpointFileSummary = Schema.Struct({
+  path: TrimmedNonEmptyString,
+  kind: TrimmedNonEmptyString,
+  additions: NonNegativeInt,
+  deletions: NonNegativeInt,
+});
+export type OrchestrationV2CheckpointFileSummary = typeof OrchestrationV2CheckpointFileSummary.Type;
+
+export const OrchestrationV2Checkpoint = Schema.Struct({
+  id: CheckpointId,
+  threadId: ThreadId,
+  scopeId: CheckpointScopeId,
+  runId: Schema.NullOr(RunId),
+  nodeId: NodeId,
+  parentCheckpointId: Schema.NullOr(CheckpointId),
+  ordinalWithinScope: NonNegativeInt,
+  appRunOrdinal: Schema.NullOr(PositiveInt),
+  ref: CheckpointRef,
+  status: Schema.Literals(["ready", "missing", "error", "stale"]),
+  files: Schema.Array(OrchestrationV2CheckpointFileSummary),
+  capturedAt: Schema.DateTimeUtc,
+});
+export type OrchestrationV2Checkpoint = typeof OrchestrationV2Checkpoint.Type;
+
+export const OrchestrationV2CheckpointRollbackRequest = Schema.Struct({
+  scopeId: CheckpointScopeId,
+  checkpointId: CheckpointId,
+  requestedAt: Schema.DateTimeUtc,
+});
+export type OrchestrationV2CheckpointRollbackRequest =
+  typeof OrchestrationV2CheckpointRollbackRequest.Type;
+
+export class OrchestrationV2CheckpointUnavailableError extends Schema.TaggedErrorClass<OrchestrationV2CheckpointUnavailableError>()(
+  "OrchestrationV2CheckpointUnavailableError",
+  {
+    threadId: ThreadId,
+    target: Schema.String,
+  },
+) {
+  override get message(): string {
+    return `Rollback target ${this.target} is unavailable for thread ${this.threadId}.`;
+  }
+}
+
+export const OrchestrationV2TurnItemStatus = Schema.Literals([
+  "pending",
+  "running",
+  "waiting",
+  "completed",
+  "failed",
+  "cancelled",
+  "interrupted",
+]);
+export type OrchestrationV2TurnItemStatus = typeof OrchestrationV2TurnItemStatus.Type;
+
+export const OrchestrationV2ProviderFailureClass = Schema.Literals([
+  "provider_error",
+  "transport_error",
+  "permission_error",
+  "validation_error",
+  "unknown",
+]);
+export type OrchestrationV2ProviderFailureClass = typeof OrchestrationV2ProviderFailureClass.Type;
+
+const OrchestrationV2ProviderFailureMessage = TrimmedNonEmptyString.check(
+  Schema.isMaxLength(4_096),
+);
+const OrchestrationV2ProviderFailureCode = TrimmedNonEmptyString.check(Schema.isMaxLength(128));
+
+/**
+ * Transport-safe failure information suitable for persistence and display.
+ * Producers must redact credentials before constructing this value. The
+ * schema bounds every provider-controlled string as a second line of defense.
+ */
+export const OrchestrationV2ProviderFailure = Schema.Struct({
+  class: OrchestrationV2ProviderFailureClass,
+  message: OrchestrationV2ProviderFailureMessage,
+  code: Schema.NullOr(OrchestrationV2ProviderFailureCode),
+  retryable: Schema.NullOr(Schema.Boolean),
+});
+export type OrchestrationV2ProviderFailure = typeof OrchestrationV2ProviderFailure.Type;
+
+/**
+ * Provider-reported retry progress. Some providers expose all fields (Claude),
+ * while others only expose `willRetry` and encode counters in display text
+ * (Codex), so the protocol-specific values remain nullable.
+ */
+export const OrchestrationV2ProviderRetry = Schema.Struct({
+  attempt: PositiveInt,
+  maxAttempts: Schema.NullOr(PositiveInt),
+  retryDelayMs: Schema.NullOr(NonNegativeInt),
+});
+export type OrchestrationV2ProviderRetry = typeof OrchestrationV2ProviderRetry.Type;
+
+export const OrchestrationV2ProviderThreadDisposition = Schema.Literals(["reusable", "broken"]);
+export type OrchestrationV2ProviderThreadDisposition =
+  typeof OrchestrationV2ProviderThreadDisposition.Type;
+
+export const OrchestrationV2UserMessageInputIntent = Schema.Literals([
+  "turn_start",
+  "queued_turn",
+  "steer",
+  "promoted_queued_to_steer",
+]);
+export type OrchestrationV2UserMessageInputIntent =
+  typeof OrchestrationV2UserMessageInputIntent.Type;
+
+const OrchestrationV2TurnItemBaseFields = {
+  id: TurnItemId,
+  threadId: ThreadId,
+  runId: Schema.NullOr(RunId),
+  nodeId: Schema.NullOr(NodeId),
+  providerThreadId: Schema.NullOr(ProviderThreadId),
+  providerTurnId: Schema.NullOr(ProviderTurnId),
+  nativeItemRef: Schema.NullOr(OrchestrationV2ProviderRef),
+  parentItemId: Schema.NullOr(TurnItemId),
+  ordinal: NonNegativeInt,
+  status: OrchestrationV2TurnItemStatus,
+  title: Schema.NullOr(Schema.String),
+  startedAt: Schema.NullOr(Schema.DateTimeUtc),
+  completedAt: Schema.NullOr(Schema.DateTimeUtc),
+  updatedAt: Schema.DateTimeUtc,
+} as const;
+
+export const OrchestrationV2FileSearchResult = Schema.Struct({
+  fileName: TrimmedNonEmptyString,
+  line: Schema.optional(PositiveInt),
+  column: Schema.optional(PositiveInt),
+  preview: Schema.optional(Schema.String),
+});
+export type OrchestrationV2FileSearchResult = typeof OrchestrationV2FileSearchResult.Type;
+
+export const OrchestrationV2WebSearchResult = Schema.Struct({
+  title: Schema.optional(Schema.String),
+  url: Schema.optional(TrimmedNonEmptyString),
+  snippet: Schema.optional(Schema.String),
+});
+export type OrchestrationV2WebSearchResult = typeof OrchestrationV2WebSearchResult.Type;
+
+export const OrchestrationV2TurnItem = Schema.Union([
+  Schema.Struct({
+    ...OrchestrationV2TurnItemBaseFields,
+    ...OrchestrationV2CreationFields,
+    type: Schema.Literal("user_message"),
+    messageId: MessageId,
+    inputIntent: OrchestrationV2UserMessageInputIntent,
+    text: Schema.String,
+    attachments: Schema.Array(ChatAttachment),
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemBaseFields,
+    type: Schema.Literal("assistant_message"),
+    messageId: MessageId,
+    text: Schema.String,
+    streaming: Schema.Boolean,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemBaseFields,
+    type: Schema.Literal("reasoning"),
+    text: Schema.String,
+    streaming: Schema.Boolean,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemBaseFields,
+    type: Schema.Literal("proposed_plan"),
+    planId: PlanId,
+    markdown: Schema.String,
+    streaming: Schema.Boolean,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemBaseFields,
+    type: Schema.Literal("todo_list"),
+    planId: PlanId,
+    steps: Schema.Array(OrchestrationV2PlanStep),
+    explanation: Schema.optional(Schema.String),
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemBaseFields,
+    type: Schema.Literal("user_input_request"),
+    requestId: RuntimeRequestId,
+    questions: Schema.Array(OrchestrationV2UserInputQuestion),
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemBaseFields,
+    type: Schema.Literal("file_change"),
+    fileName: TrimmedNonEmptyString,
+    additions: Schema.optional(NonNegativeInt),
+    deletions: Schema.optional(NonNegativeInt),
+    diffStr: Schema.optional(Schema.String),
+    oldStr: Schema.optional(Schema.String),
+    newStr: Schema.optional(Schema.String),
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemBaseFields,
+    type: Schema.Literal("command_execution"),
+    input: Schema.String,
+    output: Schema.optional(Schema.String),
+    exitCode: Schema.optional(Schema.Int),
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemBaseFields,
+    type: Schema.Literal("file_search"),
+    pattern: Schema.optional(Schema.String),
+    results: Schema.optional(Schema.Array(OrchestrationV2FileSearchResult)),
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemBaseFields,
+    type: Schema.Literal("web_search"),
+    patterns: Schema.optional(Schema.Array(Schema.String)),
+    results: Schema.optional(Schema.Array(OrchestrationV2WebSearchResult)),
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemBaseFields,
+    type: Schema.Literal("approval_request"),
+    requestId: RuntimeRequestId,
+    requestKind: ProviderRequestKind,
+    prompt: Schema.optional(Schema.String),
+    /** App requesting access, for mcp-elicitation approvals (#8058). */
+    appName: Schema.optional(Schema.String),
+    /** Approval choices advertised by the provider (#8058). */
+    options: Schema.optional(Schema.Array(ProviderApprovalOption)),
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemBaseFields,
+    type: Schema.Literal("checkpoint"),
+    checkpointId: CheckpointId,
+    scopeId: CheckpointScopeId,
+    files: Schema.Array(OrchestrationV2CheckpointFileSummary),
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemBaseFields,
+    type: Schema.Literal("run_interrupt_request"),
+    message: Schema.String,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemBaseFields,
+    type: Schema.Literal("run_interrupt_result"),
+    message: Schema.String,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemBaseFields,
+    type: Schema.Literal("error"),
+    failure: OrchestrationV2ProviderFailure,
+    retry: Schema.optional(OrchestrationV2ProviderRetry),
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemBaseFields,
+    type: Schema.Literal("compaction"),
+    driver: Schema.NullOr(ProviderDriverKind),
+    summary: Schema.optional(Schema.String),
+    beforeTokenCount: Schema.optional(NonNegativeInt),
+    afterTokenCount: Schema.optional(NonNegativeInt),
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemBaseFields,
+    type: Schema.Literal("handoff"),
+    contextHandoffId: ContextHandoffId,
+    fromProviderThreadIds: Schema.Array(ProviderThreadId),
+    toProviderThreadId: ProviderThreadId,
+    fromProviderInstanceIds: Schema.Array(ProviderInstanceId),
+    toProviderInstanceId: ProviderInstanceId,
+    // Model selections active on the covered source runs and the target
+    // model, so timelines can label the handoff by model rather than by
+    // provider instance id. Absent on items persisted before these fields.
+    fromModelSelections: Schema.optional(Schema.Array(ModelSelection)),
+    toModel: Schema.optional(Schema.String),
+    strategy: Schema.Literals([
+      "delta_since_target_last_seen",
+      "fork_delta_summary",
+      "full_thread_summary",
+      "checkpoint_summary",
+      "manual_context",
+    ]),
+    summary: Schema.optional(Schema.String),
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemBaseFields,
+    type: Schema.Literal("fork"),
+    source: Schema.Union([
+      Schema.Struct({ type: Schema.Literal("run"), threadId: ThreadId, runId: RunId }),
+      Schema.Struct({ type: Schema.Literal("node"), nodeId: NodeId }),
+      Schema.Struct({
+        type: Schema.Literal("provider_thread"),
+        providerThreadId: ProviderThreadId,
+        providerTurnId: Schema.optional(ProviderTurnId),
+      }),
+    ]),
+    targetThreadId: ThreadId,
+    providerThreadId: Schema.optional(ProviderThreadId),
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemBaseFields,
+    type: Schema.Literal("thread_created"),
+    targetThreadId: ThreadId,
+    targetRunId: Schema.NullOr(RunId),
+    targetProviderInstanceId: ProviderInstanceId,
+    targetModel: TrimmedNonEmptyString,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemBaseFields,
+    type: Schema.Literal("subagent"),
+    subagentId: NodeId,
+    origin: Schema.Literals(["provider_native", "app_owned"]),
+    driver: ProviderDriverKind,
+    providerInstanceId: ProviderInstanceId,
+    childThreadId: Schema.NullOr(ThreadId),
+    prompt: Schema.String,
+    progress: Schema.optional(Schema.String),
+    result: Schema.NullOr(Schema.String),
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemBaseFields,
+    type: Schema.Literal("dynamic_tool"),
+    toolName: Schema.NullOr(TrimmedNonEmptyString),
+    input: Schema.Unknown,
+    output: Schema.optional(Schema.Unknown),
+  }),
+]);
+export type OrchestrationV2TurnItem = typeof OrchestrationV2TurnItem.Type;
+
+export const OrchestrationV2ProjectedTurnItem = Schema.Struct({
+  position: NonNegativeInt,
+  visibility: Schema.Literals(["local", "inherited", "synthetic"]),
+  sourceThreadId: ThreadId,
+  sourceItemId: TurnItemId,
+  item: OrchestrationV2TurnItem,
+});
+export type OrchestrationV2ProjectedTurnItem = typeof OrchestrationV2ProjectedTurnItem.Type;
+
+export const OrchestrationV2RawProviderEvent = Schema.Struct({
+  id: RawEventId,
+  driver: ProviderDriverKind,
+  providerInstanceId: ProviderInstanceId,
+  providerSessionId: ProviderSessionId,
+  sequence: PositiveInt,
+  direction: Schema.Literals(["incoming", "outgoing"]),
+  messageKind: Schema.Literals(["request", "response", "notification", "error"]),
+  method: Schema.NullOr(TrimmedNonEmptyString),
+  jsonRpcId: Schema.NullOr(Schema.Union([Schema.String, Schema.Number])),
+  payload: Schema.Unknown,
+  observedAt: Schema.DateTimeUtc,
+});
+export type OrchestrationV2RawProviderEvent = typeof OrchestrationV2RawProviderEvent.Type;
+
+const OrchestrationV2EventBase = Schema.Struct({
+  id: EventId,
+  threadId: ThreadId,
+  runId: Schema.optional(RunId),
+  nodeId: Schema.optional(NodeId),
+  driver: Schema.optional(ProviderDriverKind),
+  providerInstanceId: Schema.optional(ProviderInstanceId),
+  rawEventId: Schema.optional(RawEventId),
+  occurredAt: Schema.DateTimeUtc,
+});
+
+export const OrchestrationV2DomainEvent = Schema.Union([
+  Schema.Struct({
+    ...OrchestrationV2EventBase.fields,
+    type: Schema.Literal("thread.created"),
+    payload: OrchestrationV2AppThread,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2EventBase.fields,
+    type: Schema.Literals([
+      "thread.archived",
+      "thread.unarchived",
+      "thread.deleted",
+      "thread.settled",
+      "thread.unsettled",
+      "thread.snoozed",
+      "thread.unsnoozed",
+      "thread.pinned",
+      "thread.unpinned",
+      "thread.pin-reordered",
+      "thread.visited",
+      "thread.marked-unread",
+      "thread.metadata-updated",
+      "thread.runtime-mode-updated",
+      "thread.interaction-mode-updated",
+      "thread.model-selection-updated",
+      "thread.provider-switched",
+    ]),
+    payload: OrchestrationV2AppThread,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2EventBase.fields,
+    type: Schema.Literal("run.created"),
+    payload: OrchestrationV2Run,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2EventBase.fields,
+    type: Schema.Literal("run.updated"),
+    payload: OrchestrationV2Run,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2EventBase.fields,
+    type: Schema.Literal("run-attempt.created"),
+    payload: OrchestrationV2RunAttempt,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2EventBase.fields,
+    type: Schema.Literal("run-attempt.updated"),
+    payload: OrchestrationV2RunAttempt,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2EventBase.fields,
+    type: Schema.Literal("node.updated"),
+    payload: OrchestrationV2ExecutionNode,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2EventBase.fields,
+    type: Schema.Literal("subagent.updated"),
+    payload: OrchestrationV2Subagent,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2EventBase.fields,
+    type: Schema.Literals(["provider-session.attached", "provider-session.updated"]),
+    payload: OrchestrationV2ProviderSession,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2EventBase.fields,
+    type: Schema.Literal("provider-session.detached"),
+    payload: OrchestrationV2ProviderSessionDetached,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2EventBase.fields,
+    type: Schema.Literal("provider-thread.updated"),
+    payload: OrchestrationV2ProviderThread,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2EventBase.fields,
+    type: Schema.Literal("provider-turn.updated"),
+    payload: OrchestrationV2ProviderTurn,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2EventBase.fields,
+    type: Schema.Literal("runtime-request.updated"),
+    payload: OrchestrationV2RuntimeRequest,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2EventBase.fields,
+    type: Schema.Literal("message.updated"),
+    payload: OrchestrationV2ConversationMessage,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2EventBase.fields,
+    type: Schema.Literal("turn-item.updated"),
+    payload: OrchestrationV2TurnItem,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2EventBase.fields,
+    type: Schema.Literal("plan.updated"),
+    payload: OrchestrationV2PlanArtifact,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2EventBase.fields,
+    type: Schema.Literal("checkpoint-scope.created"),
+    payload: OrchestrationV2CheckpointScope,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2EventBase.fields,
+    type: Schema.Literal("checkpoint.captured"),
+    payload: OrchestrationV2Checkpoint,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2EventBase.fields,
+    type: Schema.Literal("checkpoint.rollback-requested"),
+    payload: OrchestrationV2CheckpointRollbackRequest,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2EventBase.fields,
+    type: Schema.Literal("context-handoff.updated"),
+    payload: OrchestrationV2ContextHandoff,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2EventBase.fields,
+    type: Schema.Literal("context-transfer.created"),
+    payload: OrchestrationV2ContextTransfer,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2EventBase.fields,
+    type: Schema.Literal("context-transfer.updated"),
+    payload: OrchestrationV2ContextTransfer,
+  }),
+]);
+export type OrchestrationV2DomainEvent = typeof OrchestrationV2DomainEvent.Type;
+
+export const OrchestrationV2ThreadProjection = Schema.Struct({
+  thread: OrchestrationV2AppThread,
+  runs: Schema.Array(OrchestrationV2Run),
+  attempts: Schema.Array(OrchestrationV2RunAttempt),
+  nodes: Schema.Array(OrchestrationV2ExecutionNode),
+  subagents: Schema.Array(OrchestrationV2Subagent),
+  providerSessions: Schema.Array(OrchestrationV2ProviderSession),
+  providerThreads: Schema.Array(OrchestrationV2ProviderThread),
+  providerTurns: Schema.Array(OrchestrationV2ProviderTurn),
+  runtimeRequests: Schema.Array(OrchestrationV2RuntimeRequest),
+  messages: Schema.Array(OrchestrationV2ConversationMessage),
+  plans: Schema.Array(OrchestrationV2PlanArtifact),
+  turnItems: Schema.Array(OrchestrationV2TurnItem),
+  checkpointScopes: Schema.Array(OrchestrationV2CheckpointScope),
+  checkpoints: Schema.Array(OrchestrationV2Checkpoint),
+  contextHandoffs: Schema.Array(OrchestrationV2ContextHandoff),
+  contextTransfers: Schema.Array(OrchestrationV2ContextTransfer),
+  visibleTurnItems: Schema.Array(OrchestrationV2ProjectedTurnItem),
+  updatedAt: Schema.DateTimeUtc,
+});
+export type OrchestrationV2ThreadProjection = typeof OrchestrationV2ThreadProjection.Type;
+
+export const OrchestrationV2ShellThreadStatus = Schema.Union([
+  Schema.Literal("idle"),
+  OrchestrationV2RunStatus,
+]);
+export type OrchestrationV2ShellThreadStatus = typeof OrchestrationV2ShellThreadStatus.Type;
+
+export const OrchestrationV2PendingRuntimeRequestSummary = Schema.Struct({
+  id: RuntimeRequestId,
+  kind: OrchestrationV2RuntimeRequest.fields.kind,
+  createdAt: Schema.DateTimeUtc,
+});
+export type OrchestrationV2PendingRuntimeRequestSummary =
+  typeof OrchestrationV2PendingRuntimeRequestSummary.Type;
+
+export const OrchestrationV2LatestVisibleMessageSummary = Schema.Struct({
+  id: MessageId,
+  role: OrchestrationV2ConversationMessage.fields.role,
+  text: Schema.String,
+  updatedAt: Schema.DateTimeUtc,
+});
+export type OrchestrationV2LatestVisibleMessageSummary =
+  typeof OrchestrationV2LatestVisibleMessageSummary.Type;
+
+export const OrchestrationV2ThreadShell = Schema.Struct({
+  ...OrchestrationV2CreationFields,
+  id: ThreadId,
+  projectId: ProjectId,
+  title: Schema.String,
+  providerInstanceId: ProviderInstanceId,
+  modelSelection: ModelSelection,
+  runtimeMode: RuntimeMode,
+  interactionMode: ProviderInteractionMode,
+  branch: Schema.NullOr(TrimmedNonEmptyString),
+  worktreePath: Schema.NullOr(TrimmedNonEmptyString),
+  /** Pull request the user linked to this thread (#8160). */
+  linkedPullRequest: Schema.optional(Schema.NullOr(ThreadLinkedPullRequest)),
+  lineage: OrchestrationV2AppThreadLineage,
+  forkedFrom: Schema.NullOr(OrchestrationV2AppThread.fields.forkedFrom),
+  activeProviderThreadId: Schema.NullOr(ProviderThreadId),
+  historyOrigin: Schema.optional(OrchestrationV2ThreadHistoryOrigin),
+  latestRunId: Schema.NullOr(RunId),
+  latestRunRequestedAt: Schema.optional(Schema.NullOr(Schema.DateTimeUtc)),
+  latestRunStartedAt: Schema.optional(Schema.NullOr(Schema.DateTimeUtc)),
+  latestRunCompletedAt: Schema.optional(Schema.NullOr(Schema.DateTimeUtc)),
+  activeRunId: Schema.NullOr(RunId),
+  activityRunStatus: Schema.optional(
+    Schema.NullOr(Schema.Literals(["preparing", "starting", "running", "waiting"])),
+  ),
+  status: OrchestrationV2ShellThreadStatus,
+  lastError: Schema.optional(Schema.NullOr(Schema.String)),
+  pendingRuntimeRequest: Schema.NullOr(OrchestrationV2PendingRuntimeRequestSummary),
+  latestVisibleMessage: Schema.NullOr(OrchestrationV2LatestVisibleMessageSummary),
+  latestUserMessageAt: Schema.NullOr(Schema.DateTimeUtc),
+  hasActionableProposedPlan: Schema.Boolean,
+  // Normalized post-settlement background work for sidebar Waiting pills.
+  // Empty when the latest root run is still active or no pending work remains.
+  pendingBackgroundTasks: Schema.optional(Schema.Array(OrchestrationV2PendingBackgroundTask)).pipe(
+    Schema.withDecodingDefault(Effect.succeed([])),
+  ),
+  itemCount: NonNegativeInt,
+  visibleItemCount: NonNegativeInt,
+  createdAt: Schema.DateTimeUtc,
+  updatedAt: Schema.DateTimeUtc,
+  archivedAt: Schema.NullOr(Schema.DateTimeUtc),
+  settledOverride: Schema.NullOr(Schema.Literals(["settled", "active"])),
+  settledAt: Schema.NullOr(Schema.DateTimeUtc),
+  unsettledAt: Schema.optional(Schema.NullOr(Schema.DateTimeUtc)),
+  snoozedUntil: Schema.optional(Schema.NullOr(Schema.DateTimeUtc)),
+  snoozedAt: Schema.optional(Schema.NullOr(Schema.DateTimeUtc)),
+  /** Omitted by servers that predate thread pinning. */
+  pinnedAt: Schema.optional(Schema.NullOr(Schema.DateTimeUtc)),
+  /** Slot in the user-arranged pinned order; omitted by pre-reorder servers. */
+  pinOrderKey: Schema.optional(Schema.NullOr(TrimmedNonEmptyString)),
+  /**
+   * Omitted by servers that predate server-side visited tracking; clients fall
+   * back to their local visited state when the field is absent.
+   */
+  lastVisitedAt: Schema.optional(Schema.NullOr(Schema.DateTimeUtc)),
+  /** In-flight title regeneration marker; null/absent when no request is pending. */
+  titleRegeneration: Schema.optional(
+    Schema.NullOr(
+      Schema.Struct({
+        requestId: CommandId,
+        startedAt: Schema.DateTimeUtc,
+      }),
+    ),
+  ),
+  deletedAt: Schema.NullOr(Schema.DateTimeUtc),
+});
+export type OrchestrationV2ThreadShell = typeof OrchestrationV2ThreadShell.Type;
+
+export const OrchestrationV2ThreadShellSnapshot = Schema.Struct({
+  schemaVersion: PositiveInt,
+  snapshotSequence: NonNegativeInt,
+  threads: Schema.Array(OrchestrationV2ThreadShell),
+  archivedThreads: Schema.Array(OrchestrationV2ThreadShell),
+});
+export type OrchestrationV2ThreadShellSnapshot = typeof OrchestrationV2ThreadShellSnapshot.Type;
+
+export const OrchestrationV2ShellSnapshot = Schema.Struct({
+  ...OrchestrationV2ThreadShellSnapshot.fields,
+  projects: Schema.Array(OrchestrationProjectShell),
+});
+export type OrchestrationV2ShellSnapshot = typeof OrchestrationV2ShellSnapshot.Type;
+
+export const OrchestrationV2ShellStreamItem = Schema.Union([
+  Schema.Struct({
+    kind: Schema.Literal("synchronized"),
+  }),
+  Schema.Struct({
+    kind: Schema.Literal("snapshot"),
+    snapshot: OrchestrationV2ShellSnapshot,
+    /**
+     * Workspace roots whose repository-identity resolution completed for this
+     * enrichment refresh. Omitted on authoritative HTTP/initial WebSocket
+     * snapshots. Older clients ignore the field.
+     */
+    resolvedRepositoryIdentityRoots: Schema.optionalKey(Schema.Array(Schema.String)),
+  }),
+  Schema.Struct({
+    kind: Schema.Literal("project.updated"),
+    sequence: NonNegativeInt,
+    project: OrchestrationProjectShell,
+  }),
+  Schema.Struct({
+    kind: Schema.Literal("project.removed"),
+    sequence: NonNegativeInt,
+    projectId: ProjectId,
+  }),
+  Schema.Struct({
+    kind: Schema.Literal("thread.updated"),
+    sequence: NonNegativeInt,
+    location: Schema.Literals(["active", "archive"]),
+    thread: OrchestrationV2ThreadShell,
+  }),
+  Schema.Struct({
+    kind: Schema.Literal("thread.removed"),
+    sequence: NonNegativeInt,
+    location: Schema.Literals(["active", "archive"]),
+    threadId: ThreadId,
+  }),
+]);
+export type OrchestrationV2ShellStreamItem = typeof OrchestrationV2ShellStreamItem.Type;
+
+export const OrchestrationV2StoredEvent = Schema.Struct({
+  sequence: NonNegativeInt,
+  commandId: Schema.NullOr(CommandId),
+  event: OrchestrationV2DomainEvent,
+});
+export type OrchestrationV2StoredEvent = typeof OrchestrationV2StoredEvent.Type;
+
+export const OrchestrationV2AppThreadJson = OrchestrationV2AppThread.mapFields((fields) => ({
+  ...fields,
+  createdAt: Schema.DateTimeUtcFromString,
+  updatedAt: Schema.DateTimeUtcFromString,
+  archivedAt: Schema.NullOr(Schema.DateTimeUtcFromString),
+  settledAt: Schema.NullOr(Schema.DateTimeUtcFromString).pipe(
+    Schema.withDecodingDefault(Effect.succeed(null)),
+  ),
+  unsettledAt: Schema.optional(Schema.NullOr(Schema.DateTimeUtcFromString)),
+  snoozedUntil: Schema.optional(Schema.NullOr(Schema.DateTimeUtcFromString)),
+  snoozedAt: Schema.optional(Schema.NullOr(Schema.DateTimeUtcFromString)),
+  pinnedAt: Schema.optional(Schema.NullOr(Schema.DateTimeUtcFromString)),
+  lastVisitedAt: Schema.NullOr(Schema.DateTimeUtcFromString).pipe(
+    Schema.withDecodingDefault(Effect.succeed(null)),
+  ),
+  titleRegeneration: Schema.optional(
+    Schema.NullOr(
+      Schema.Struct({
+        requestId: CommandId,
+        startedAt: Schema.DateTimeUtcFromString,
+      }),
+    ),
+  ),
+  deletedAt: Schema.NullOr(Schema.DateTimeUtcFromString),
+}));
+export type OrchestrationV2AppThreadJson = typeof OrchestrationV2AppThreadJson.Type;
+
+export const OrchestrationV2RunJson = OrchestrationV2Run.mapFields((fields) => ({
+  ...fields,
+  requestedAt: Schema.DateTimeUtcFromString,
+  startedAt: Schema.NullOr(Schema.DateTimeUtcFromString),
+  completedAt: Schema.NullOr(Schema.DateTimeUtcFromString),
+}));
+export type OrchestrationV2RunJson = typeof OrchestrationV2RunJson.Type;
+
+export const OrchestrationV2RunAttemptJson = OrchestrationV2RunAttempt.mapFields((fields) => ({
+  ...fields,
+  startedAt: Schema.NullOr(Schema.DateTimeUtcFromString),
+  completedAt: Schema.NullOr(Schema.DateTimeUtcFromString),
+}));
+export type OrchestrationV2RunAttemptJson = typeof OrchestrationV2RunAttemptJson.Type;
+
+export const OrchestrationV2ExecutionNodeJson = OrchestrationV2ExecutionNode.mapFields(
+  (fields) => ({
+    ...fields,
+    startedAt: Schema.NullOr(Schema.DateTimeUtcFromString),
+    completedAt: Schema.NullOr(Schema.DateTimeUtcFromString),
+  }),
+);
+export type OrchestrationV2ExecutionNodeJson = typeof OrchestrationV2ExecutionNodeJson.Type;
+
+export const OrchestrationV2SubagentJson = OrchestrationV2Subagent.mapFields((fields) => ({
+  ...fields,
+  startedAt: Schema.NullOr(Schema.DateTimeUtcFromString),
+  completedAt: Schema.NullOr(Schema.DateTimeUtcFromString),
+  updatedAt: Schema.DateTimeUtcFromString,
+}));
+export type OrchestrationV2SubagentJson = typeof OrchestrationV2SubagentJson.Type;
+
+export const OrchestrationV2CheckpointScopeJson = OrchestrationV2CheckpointScope.mapFields(
+  (fields) => ({
+    ...fields,
+    createdAt: Schema.DateTimeUtcFromString,
+  }),
+);
+export type OrchestrationV2CheckpointScopeJson = typeof OrchestrationV2CheckpointScopeJson.Type;
+
+export const OrchestrationV2ProviderSessionJson = OrchestrationV2ProviderSession.mapFields(
+  (fields) => ({
+    ...fields,
+    createdAt: Schema.DateTimeUtcFromString,
+    updatedAt: Schema.DateTimeUtcFromString,
+  }),
+);
+export type OrchestrationV2ProviderSessionJson = typeof OrchestrationV2ProviderSessionJson.Type;
+
+export const OrchestrationV2ProviderSessionDetachedJson =
+  OrchestrationV2ProviderSessionDetached.mapFields((fields) => ({
+    ...fields,
+    detachedAt: Schema.DateTimeUtcFromString,
+  }));
+export type OrchestrationV2ProviderSessionDetachedJson =
+  typeof OrchestrationV2ProviderSessionDetachedJson.Type;
+
+export const OrchestrationV2ProviderThreadJson = OrchestrationV2ProviderThread.mapFields(
+  (fields) => ({
+    ...fields,
+    createdAt: Schema.DateTimeUtcFromString,
+    updatedAt: Schema.DateTimeUtcFromString,
+  }),
+);
+export type OrchestrationV2ProviderThreadJson = typeof OrchestrationV2ProviderThreadJson.Type;
+
+export const OrchestrationV2ContextHandoffJson = OrchestrationV2ContextHandoff.mapFields(
+  (fields) => ({
+    ...fields,
+    createdAt: Schema.DateTimeUtcFromString,
+    updatedAt: Schema.DateTimeUtcFromString,
+  }),
+);
+export type OrchestrationV2ContextHandoffJson = typeof OrchestrationV2ContextHandoffJson.Type;
+
+export const OrchestrationV2ContextTransferJson = OrchestrationV2ContextTransfer.mapFields(
+  (fields) => ({
+    ...fields,
+    createdAt: Schema.DateTimeUtcFromString,
+    updatedAt: Schema.DateTimeUtcFromString,
+    consumedAt: Schema.NullOr(Schema.DateTimeUtcFromString),
+  }),
+);
+export type OrchestrationV2ContextTransferJson = typeof OrchestrationV2ContextTransferJson.Type;
+
+export const OrchestrationV2ProviderTurnJson = OrchestrationV2ProviderTurn.mapFields((fields) => ({
+  ...fields,
+  startedAt: Schema.NullOr(Schema.DateTimeUtcFromString),
+  completedAt: Schema.NullOr(Schema.DateTimeUtcFromString),
+}));
+export type OrchestrationV2ProviderTurnJson = typeof OrchestrationV2ProviderTurnJson.Type;
+
+export const OrchestrationV2RuntimeRequestJson = OrchestrationV2RuntimeRequest.mapFields(
+  (fields) => ({
+    ...fields,
+    createdAt: Schema.DateTimeUtcFromString,
+    resolvedAt: Schema.NullOr(Schema.DateTimeUtcFromString),
+  }),
+);
+export type OrchestrationV2RuntimeRequestJson = typeof OrchestrationV2RuntimeRequestJson.Type;
+
+export const OrchestrationV2ConversationMessageJson = OrchestrationV2ConversationMessage.mapFields(
+  (fields) => ({
+    ...fields,
+    createdAt: Schema.DateTimeUtcFromString,
+    updatedAt: Schema.DateTimeUtcFromString,
+  }),
+);
+export type OrchestrationV2ConversationMessageJson =
+  typeof OrchestrationV2ConversationMessageJson.Type;
+
+export const OrchestrationV2CheckpointJson = OrchestrationV2Checkpoint.mapFields((fields) => ({
+  ...fields,
+  capturedAt: Schema.DateTimeUtcFromString,
+}));
+export type OrchestrationV2CheckpointJson = typeof OrchestrationV2CheckpointJson.Type;
+
+export const OrchestrationV2CheckpointRollbackRequestJson =
+  OrchestrationV2CheckpointRollbackRequest.mapFields((fields) => ({
+    ...fields,
+    requestedAt: Schema.DateTimeUtcFromString,
+  }));
+
+const OrchestrationV2TurnItemJsonBaseFields = {
+  ...OrchestrationV2TurnItemBaseFields,
+  startedAt: Schema.NullOr(Schema.DateTimeUtcFromString),
+  completedAt: Schema.NullOr(Schema.DateTimeUtcFromString),
+  updatedAt: Schema.DateTimeUtcFromString,
+} as const;
+
+export const OrchestrationV2TurnItemJson = Schema.Union([
+  Schema.Struct({
+    ...OrchestrationV2TurnItemJsonBaseFields,
+    ...OrchestrationV2CreationFields,
+    type: Schema.Literal("user_message"),
+    messageId: MessageId,
+    inputIntent: OrchestrationV2UserMessageInputIntent,
+    text: Schema.String,
+    attachments: Schema.Array(ChatAttachment),
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemJsonBaseFields,
+    type: Schema.Literal("assistant_message"),
+    messageId: MessageId,
+    text: Schema.String,
+    streaming: Schema.Boolean,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemJsonBaseFields,
+    type: Schema.Literal("reasoning"),
+    text: Schema.String,
+    streaming: Schema.Boolean,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemJsonBaseFields,
+    type: Schema.Literal("proposed_plan"),
+    planId: PlanId,
+    markdown: Schema.String,
+    streaming: Schema.Boolean,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemJsonBaseFields,
+    type: Schema.Literal("todo_list"),
+    planId: PlanId,
+    steps: Schema.Array(OrchestrationV2PlanStep),
+    explanation: Schema.optional(Schema.String),
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemJsonBaseFields,
+    type: Schema.Literal("user_input_request"),
+    requestId: RuntimeRequestId,
+    questions: Schema.Array(OrchestrationV2UserInputQuestion),
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemJsonBaseFields,
+    type: Schema.Literal("file_change"),
+    fileName: TrimmedNonEmptyString,
+    additions: Schema.optional(NonNegativeInt),
+    deletions: Schema.optional(NonNegativeInt),
+    diffStr: Schema.optional(Schema.String),
+    oldStr: Schema.optional(Schema.String),
+    newStr: Schema.optional(Schema.String),
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemJsonBaseFields,
+    type: Schema.Literal("command_execution"),
+    input: Schema.String,
+    output: Schema.optional(Schema.String),
+    exitCode: Schema.optional(Schema.Int),
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemJsonBaseFields,
+    type: Schema.Literal("file_search"),
+    pattern: Schema.optional(Schema.String),
+    results: Schema.optional(Schema.Array(OrchestrationV2FileSearchResult)),
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemJsonBaseFields,
+    type: Schema.Literal("web_search"),
+    patterns: Schema.optional(Schema.Array(Schema.String)),
+    results: Schema.optional(Schema.Array(OrchestrationV2WebSearchResult)),
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemJsonBaseFields,
+    type: Schema.Literal("approval_request"),
+    requestId: RuntimeRequestId,
+    requestKind: ProviderRequestKind,
+    prompt: Schema.optional(Schema.String),
+    /** App requesting access, for mcp-elicitation approvals (#8058). */
+    appName: Schema.optional(Schema.String),
+    /** Approval choices advertised by the provider (#8058). */
+    options: Schema.optional(Schema.Array(ProviderApprovalOption)),
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemJsonBaseFields,
+    type: Schema.Literal("checkpoint"),
+    checkpointId: CheckpointId,
+    scopeId: CheckpointScopeId,
+    files: Schema.Array(OrchestrationV2CheckpointFileSummary),
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemJsonBaseFields,
+    type: Schema.Literal("run_interrupt_request"),
+    message: Schema.String,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemJsonBaseFields,
+    type: Schema.Literal("run_interrupt_result"),
+    message: Schema.String,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemJsonBaseFields,
+    type: Schema.Literal("error"),
+    failure: OrchestrationV2ProviderFailure,
+    retry: Schema.optional(OrchestrationV2ProviderRetry),
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemJsonBaseFields,
+    type: Schema.Literal("compaction"),
+    driver: Schema.NullOr(ProviderDriverKind),
+    summary: Schema.optional(Schema.String),
+    beforeTokenCount: Schema.optional(NonNegativeInt),
+    afterTokenCount: Schema.optional(NonNegativeInt),
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemJsonBaseFields,
+    type: Schema.Literal("handoff"),
+    contextHandoffId: ContextHandoffId,
+    fromProviderThreadIds: Schema.Array(ProviderThreadId),
+    toProviderThreadId: ProviderThreadId,
+    fromProviderInstanceIds: Schema.Array(ProviderInstanceId),
+    toProviderInstanceId: ProviderInstanceId,
+    fromModelSelections: Schema.optional(Schema.Array(ModelSelection)),
+    toModel: Schema.optional(Schema.String),
+    strategy: Schema.Literals([
+      "delta_since_target_last_seen",
+      "fork_delta_summary",
+      "full_thread_summary",
+      "checkpoint_summary",
+      "manual_context",
+    ]),
+    summary: Schema.optional(Schema.String),
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemJsonBaseFields,
+    type: Schema.Literal("fork"),
+    source: Schema.Union([
+      Schema.Struct({ type: Schema.Literal("run"), threadId: ThreadId, runId: RunId }),
+      Schema.Struct({ type: Schema.Literal("node"), nodeId: NodeId }),
+      Schema.Struct({
+        type: Schema.Literal("provider_thread"),
+        providerThreadId: ProviderThreadId,
+        providerTurnId: Schema.optional(ProviderTurnId),
+      }),
+    ]),
+    targetThreadId: ThreadId,
+    providerThreadId: Schema.optional(ProviderThreadId),
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemJsonBaseFields,
+    type: Schema.Literal("thread_created"),
+    targetThreadId: ThreadId,
+    targetRunId: Schema.NullOr(RunId),
+    targetProviderInstanceId: ProviderInstanceId,
+    targetModel: TrimmedNonEmptyString,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemJsonBaseFields,
+    type: Schema.Literal("subagent"),
+    subagentId: NodeId,
+    origin: Schema.Literals(["provider_native", "app_owned"]),
+    driver: ProviderDriverKind,
+    providerInstanceId: ProviderInstanceId,
+    childThreadId: Schema.NullOr(ThreadId),
+    prompt: Schema.String,
+    progress: Schema.optional(Schema.String),
+    result: Schema.NullOr(Schema.String),
+  }),
+  Schema.Struct({
+    ...OrchestrationV2TurnItemJsonBaseFields,
+    type: Schema.Literal("dynamic_tool"),
+    toolName: Schema.NullOr(TrimmedNonEmptyString),
+    input: Schema.Unknown,
+    output: Schema.optional(Schema.Unknown),
+  }),
+]);
+export type OrchestrationV2TurnItemJson = typeof OrchestrationV2TurnItemJson.Type;
+
+export const OrchestrationV2ProjectedTurnItemJson = OrchestrationV2ProjectedTurnItem.mapFields(
+  (fields) => ({
+    ...fields,
+    item: OrchestrationV2TurnItemJson,
+  }),
+);
+export type OrchestrationV2ProjectedTurnItemJson = typeof OrchestrationV2ProjectedTurnItemJson.Type;
+
+export const OrchestrationV2ThreadProjectionJson = OrchestrationV2ThreadProjection.mapFields(
+  (fields) => ({
+    ...fields,
+    thread: OrchestrationV2AppThreadJson,
+    runs: Schema.Array(OrchestrationV2RunJson),
+    attempts: Schema.Array(OrchestrationV2RunAttemptJson),
+    nodes: Schema.Array(OrchestrationV2ExecutionNodeJson),
+    subagents: Schema.Array(OrchestrationV2SubagentJson),
+    providerSessions: Schema.Array(OrchestrationV2ProviderSessionJson),
+    providerThreads: Schema.Array(OrchestrationV2ProviderThreadJson),
+    providerTurns: Schema.Array(OrchestrationV2ProviderTurnJson),
+    runtimeRequests: Schema.Array(OrchestrationV2RuntimeRequestJson),
+    messages: Schema.Array(OrchestrationV2ConversationMessageJson),
+    plans: Schema.Array(OrchestrationV2PlanArtifact),
+    turnItems: Schema.Array(OrchestrationV2TurnItemJson),
+    checkpointScopes: Schema.Array(OrchestrationV2CheckpointScopeJson),
+    checkpoints: Schema.Array(OrchestrationV2CheckpointJson),
+    contextHandoffs: Schema.Array(OrchestrationV2ContextHandoffJson),
+    contextTransfers: Schema.Array(OrchestrationV2ContextTransferJson),
+    visibleTurnItems: Schema.Array(OrchestrationV2ProjectedTurnItemJson),
+    updatedAt: Schema.DateTimeUtcFromString,
+  }),
+);
+export type OrchestrationV2ThreadProjectionJson = typeof OrchestrationV2ThreadProjectionJson.Type;
+
+export const OrchestrationV2PendingRuntimeRequestSummaryJson =
+  OrchestrationV2PendingRuntimeRequestSummary.mapFields((fields) => ({
+    ...fields,
+    createdAt: Schema.DateTimeUtcFromString,
+  }));
+export type OrchestrationV2PendingRuntimeRequestSummaryJson =
+  typeof OrchestrationV2PendingRuntimeRequestSummaryJson.Type;
+
+export const OrchestrationV2LatestVisibleMessageSummaryJson =
+  OrchestrationV2LatestVisibleMessageSummary.mapFields((fields) => ({
+    ...fields,
+    updatedAt: Schema.DateTimeUtcFromString,
+  }));
+export type OrchestrationV2LatestVisibleMessageSummaryJson =
+  typeof OrchestrationV2LatestVisibleMessageSummaryJson.Type;
+
+export const OrchestrationV2ThreadShellJson = OrchestrationV2ThreadShell.mapFields((fields) => ({
+  ...fields,
+  latestRunRequestedAt: Schema.optional(Schema.NullOr(Schema.DateTimeUtcFromString)),
+  latestRunStartedAt: Schema.optional(Schema.NullOr(Schema.DateTimeUtcFromString)),
+  latestRunCompletedAt: Schema.optional(Schema.NullOr(Schema.DateTimeUtcFromString)),
+  pendingRuntimeRequest: Schema.NullOr(OrchestrationV2PendingRuntimeRequestSummaryJson),
+  latestVisibleMessage: Schema.NullOr(OrchestrationV2LatestVisibleMessageSummaryJson),
+  latestUserMessageAt: Schema.NullOr(Schema.DateTimeUtcFromString),
+  createdAt: Schema.DateTimeUtcFromString,
+  updatedAt: Schema.DateTimeUtcFromString,
+  archivedAt: Schema.NullOr(Schema.DateTimeUtcFromString),
+  settledAt: Schema.NullOr(Schema.DateTimeUtcFromString),
+  snoozedUntil: Schema.optional(Schema.NullOr(Schema.DateTimeUtcFromString)),
+  snoozedAt: Schema.optional(Schema.NullOr(Schema.DateTimeUtcFromString)),
+  pinnedAt: Schema.optional(Schema.NullOr(Schema.DateTimeUtcFromString)),
+  lastVisitedAt: Schema.optional(Schema.NullOr(Schema.DateTimeUtcFromString)),
+  titleRegeneration: Schema.optional(
+    Schema.NullOr(
+      Schema.Struct({
+        requestId: CommandId,
+        startedAt: Schema.DateTimeUtcFromString,
+      }),
+    ),
+  ),
+  deletedAt: Schema.NullOr(Schema.DateTimeUtcFromString),
+}));
+export type OrchestrationV2ThreadShellJson = typeof OrchestrationV2ThreadShellJson.Type;
+
+export const OrchestrationV2ShellSnapshotJson = OrchestrationV2ShellSnapshot.mapFields(
+  (fields) => ({
+    ...fields,
+    threads: Schema.Array(OrchestrationV2ThreadShellJson),
+    archivedThreads: Schema.Array(OrchestrationV2ThreadShellJson),
+  }),
+);
+export type OrchestrationV2ShellSnapshotJson = typeof OrchestrationV2ShellSnapshotJson.Type;
+
+const OrchestrationV2JsonEventBaseFields = {
+  ...OrchestrationV2EventBase.fields,
+  occurredAt: Schema.DateTimeUtcFromString,
+} as const;
+
+export const OrchestrationV2RawProviderEventJson = OrchestrationV2RawProviderEvent.mapFields(
+  (fields) => ({
+    ...fields,
+    observedAt: Schema.DateTimeUtcFromString,
+  }),
+);
+export type OrchestrationV2RawProviderEventJson = typeof OrchestrationV2RawProviderEventJson.Type;
+
+export const OrchestrationV2DomainEventJson = Schema.Union([
+  Schema.Struct({
+    ...OrchestrationV2JsonEventBaseFields,
+    type: Schema.Literal("thread.created"),
+    payload: OrchestrationV2AppThreadJson,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2JsonEventBaseFields,
+    type: Schema.Literals([
+      "thread.archived",
+      "thread.unarchived",
+      "thread.deleted",
+      "thread.settled",
+      "thread.unsettled",
+      "thread.snoozed",
+      "thread.unsnoozed",
+      "thread.pinned",
+      "thread.unpinned",
+      "thread.pin-reordered",
+      "thread.visited",
+      "thread.marked-unread",
+      "thread.metadata-updated",
+      "thread.runtime-mode-updated",
+      "thread.interaction-mode-updated",
+      "thread.model-selection-updated",
+      "thread.provider-switched",
+    ]),
+    payload: OrchestrationV2AppThreadJson,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2JsonEventBaseFields,
+    type: Schema.Literal("run.created"),
+    payload: OrchestrationV2RunJson,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2JsonEventBaseFields,
+    type: Schema.Literal("run.updated"),
+    payload: OrchestrationV2RunJson,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2JsonEventBaseFields,
+    type: Schema.Literal("run-attempt.created"),
+    payload: OrchestrationV2RunAttemptJson,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2JsonEventBaseFields,
+    type: Schema.Literal("run-attempt.updated"),
+    payload: OrchestrationV2RunAttemptJson,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2JsonEventBaseFields,
+    type: Schema.Literal("node.updated"),
+    payload: OrchestrationV2ExecutionNodeJson,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2JsonEventBaseFields,
+    type: Schema.Literal("subagent.updated"),
+    payload: OrchestrationV2SubagentJson,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2JsonEventBaseFields,
+    type: Schema.Literals(["provider-session.attached", "provider-session.updated"]),
+    payload: OrchestrationV2ProviderSessionJson,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2JsonEventBaseFields,
+    type: Schema.Literal("provider-session.detached"),
+    payload: OrchestrationV2ProviderSessionDetachedJson,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2JsonEventBaseFields,
+    type: Schema.Literal("provider-thread.updated"),
+    payload: OrchestrationV2ProviderThreadJson,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2JsonEventBaseFields,
+    type: Schema.Literal("provider-turn.updated"),
+    payload: OrchestrationV2ProviderTurnJson,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2JsonEventBaseFields,
+    type: Schema.Literal("runtime-request.updated"),
+    payload: OrchestrationV2RuntimeRequestJson,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2JsonEventBaseFields,
+    type: Schema.Literal("message.updated"),
+    payload: OrchestrationV2ConversationMessageJson,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2JsonEventBaseFields,
+    type: Schema.Literal("turn-item.updated"),
+    payload: OrchestrationV2TurnItemJson,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2JsonEventBaseFields,
+    type: Schema.Literal("plan.updated"),
+    payload: OrchestrationV2PlanArtifact,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2JsonEventBaseFields,
+    type: Schema.Literal("checkpoint-scope.created"),
+    payload: OrchestrationV2CheckpointScopeJson,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2JsonEventBaseFields,
+    type: Schema.Literal("checkpoint.captured"),
+    payload: OrchestrationV2CheckpointJson,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2JsonEventBaseFields,
+    type: Schema.Literal("checkpoint.rollback-requested"),
+    payload: OrchestrationV2CheckpointRollbackRequestJson,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2JsonEventBaseFields,
+    type: Schema.Literal("context-handoff.updated"),
+    payload: OrchestrationV2ContextHandoffJson,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2JsonEventBaseFields,
+    type: Schema.Literal("context-transfer.created"),
+    payload: OrchestrationV2ContextTransferJson,
+  }),
+  Schema.Struct({
+    ...OrchestrationV2JsonEventBaseFields,
+    type: Schema.Literal("context-transfer.updated"),
+    payload: OrchestrationV2ContextTransferJson,
+  }),
+]);
+export type OrchestrationV2DomainEventJson = typeof OrchestrationV2DomainEventJson.Type;
+
+export const OrchestrationV2StoredEventJson = Schema.Struct({
+  sequence: NonNegativeInt,
+  commandId: Schema.NullOr(CommandId),
+  event: OrchestrationV2DomainEventJson,
+});
+export type OrchestrationV2StoredEventJson = typeof OrchestrationV2StoredEventJson.Type;
+
+export const OrchestrationV2Command = Schema.Union([
+  Schema.Struct({
+    type: Schema.Literal("thread.create"),
+    ...OrchestrationV2CreationFields,
+    commandId: CommandId,
+    threadId: ThreadId,
+    projectId: ProjectId,
+    title: TrimmedNonEmptyString,
+    modelSelection: ModelSelection,
+    runtimeMode: RuntimeMode,
+    interactionMode: ProviderInteractionMode,
+    branch: Schema.NullOr(TrimmedNonEmptyString),
+    worktreePath: Schema.NullOr(TrimmedNonEmptyString),
+  }),
+  Schema.Struct({
+    type: Schema.Literal("thread.archive"),
+    commandId: CommandId,
+    threadId: ThreadId,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("thread.unarchive"),
+    commandId: CommandId,
+    threadId: ThreadId,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("thread.delete"),
+    commandId: CommandId,
+    threadId: ThreadId,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("thread.settle"),
+    commandId: CommandId,
+    threadId: ThreadId,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("thread.unsettle"),
+    commandId: CommandId,
+    threadId: ThreadId,
+    reason: Schema.Literal("user"),
+  }),
+  Schema.Struct({
+    type: Schema.Literal("thread.snooze"),
+    commandId: CommandId,
+    threadId: ThreadId,
+    snoozedUntil: IsoDateTime,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("thread.unsnooze"),
+    commandId: CommandId,
+    threadId: ThreadId,
+    reason: Schema.Literal("user"),
+  }),
+  Schema.Struct({
+    type: Schema.Literal("thread.pin"),
+    commandId: CommandId,
+    threadId: ThreadId,
+    // Initial slot in the user-arranged pinned order (see thread.pin.reorder).
+    // Optional: clients on pre-reorder servers omit it, and the pinned block
+    // falls back to creation order for keyless threads.
+    orderKey: Schema.optional(TrimmedNonEmptyString),
+  }),
+  Schema.Struct({
+    type: Schema.Literal("thread.unpin"),
+    commandId: CommandId,
+    threadId: ThreadId,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("thread.pin.reorder"),
+    commandId: CommandId,
+    threadId: ThreadId,
+    // Fractional-index key: pinned threads sort lexicographically by these
+    // keys, so a drag writes one key to one thread — neighbors are never
+    // touched. Clients compute a key that sorts between the dropped
+    // position's neighbors.
+    orderKey: TrimmedNonEmptyString,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("thread.visit"),
+    commandId: CommandId,
+    threadId: ThreadId,
+    /**
+     * Watermark of the thread state the viewer has seen (typically the shell's
+     * updatedAt). The server keeps the maximum of the stored and supplied
+     * values, so replays and out-of-order deliveries cannot move it backwards.
+     */
+    visitedAt: IsoDateTime,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("thread.mark-unread"),
+    commandId: CommandId,
+    threadId: ThreadId,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("thread.metadata.update"),
+    commandId: CommandId,
+    threadId: ThreadId,
+    title: Schema.optional(TrimmedNonEmptyString),
+    /** Kick off (true) or abandon (false) an async title regeneration. */
+    regenerateTitle: Schema.optional(Schema.Boolean),
+    branch: Schema.optional(Schema.NullOr(TrimmedNonEmptyString)),
+    worktreePath: Schema.optional(Schema.NullOr(TrimmedNonEmptyString)),
+    expectedWorktreePath: Schema.optional(Schema.NullOr(TrimmedNonEmptyString)),
+    /** Link (object) or unlink (null) a pull request (#8160); absent leaves it unchanged. */
+    linkedPullRequest: Schema.optional(Schema.NullOr(ThreadLinkedPullRequest)),
+  }),
+  Schema.Struct({
+    type: Schema.Literal("thread.title.regeneration.complete"),
+    commandId: CommandId,
+    threadId: ThreadId,
+    requestId: CommandId,
+    title: Schema.optional(TrimmedNonEmptyString),
+  }),
+  Schema.Struct({
+    type: Schema.Literal("thread.runtime-mode.set"),
+    commandId: CommandId,
+    threadId: ThreadId,
+    runtimeMode: RuntimeMode,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("thread.interaction-mode.set"),
+    commandId: CommandId,
+    threadId: ThreadId,
+    interactionMode: ProviderInteractionMode,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("thread.model-selection.set"),
+    commandId: CommandId,
+    threadId: ThreadId,
+    modelSelection: ModelSelection,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("provider-session.detach"),
+    commandId: CommandId,
+    threadId: ThreadId,
+    providerSessionId: ProviderSessionId,
+    reason: Schema.optional(Schema.String),
+  }),
+  Schema.Struct({
+    type: Schema.Literal("message.dispatch"),
+    ...OrchestrationV2CreationFields,
+    commandId: CommandId,
+    threadId: ThreadId,
+    messageId: MessageId,
+    text: Schema.String,
+    attachments: Schema.Array(ChatAttachment),
+    /** Seed the temporary title and generate a durable replacement for the first message. */
+    titleSeed: Schema.optional(TrimmedNonEmptyString),
+    modelSelection: Schema.optional(ModelSelection),
+    sourcePlanRef: Schema.optional(Schema.Struct({ threadId: ThreadId, planId: PlanId })),
+    delegatedCompletion: Schema.optional(
+      Schema.Struct({
+        parentRunId: RunId,
+        generation: PositiveInt,
+        taskIds: Schema.Array(NodeId),
+      }),
+    ),
+    dispatchMode: Schema.Union([
+      Schema.Struct({ type: Schema.Literal("defer_start") }),
+      Schema.Struct({ type: Schema.Literal("steer_active"), targetRunId: RunId }),
+      Schema.Struct({ type: Schema.Literal("restart_active"), targetRunId: RunId }),
+      Schema.Struct({ type: Schema.Literal("queue_after_active") }),
+      Schema.Struct({ type: Schema.Literal("start_immediately") }),
+    ]),
+  }),
+  Schema.Struct({
+    type: Schema.Literal("prepared-run.release"),
+    commandId: CommandId,
+    threadId: ThreadId,
+    runId: RunId,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("prepared-run.progress"),
+    commandId: CommandId,
+    threadId: ThreadId,
+    runId: RunId,
+    phase: Schema.Literals(["worktree", "setup"]),
+  }),
+  Schema.Struct({
+    type: Schema.Literal("prepared-run.fail"),
+    commandId: CommandId,
+    threadId: ThreadId,
+    runId: RunId,
+    failure: OrchestrationV2ProviderFailure,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("run.interrupt"),
+    commandId: CommandId,
+    threadId: ThreadId,
+    runId: RunId,
+    reason: Schema.optional(Schema.String),
+  }),
+  Schema.Struct({
+    type: Schema.Literal("queued-message.promote-to-steer"),
+    commandId: CommandId,
+    threadId: ThreadId,
+    queuedRunId: RunId,
+    targetRunId: RunId,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("queued-run.reorder"),
+    commandId: CommandId,
+    threadId: ThreadId,
+    runId: RunId,
+    beforeRunId: Schema.NullOr(RunId),
+  }),
+  Schema.Struct({
+    type: Schema.Literal("queued-run.cancel"),
+    commandId: CommandId,
+    threadId: ThreadId,
+    runId: RunId,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("queued-run.edit"),
+    commandId: CommandId,
+    threadId: ThreadId,
+    runId: RunId,
+    text: Schema.String,
+    // Full replacement list. Absent = leave the message's attachments as-is,
+    // so pre-attachment clients editing text keep the original attachments.
+    attachments: Schema.optional(Schema.Array(ChatAttachment)),
+  }),
+  Schema.Struct({
+    type: Schema.Literal("runtime-request.respond"),
+    commandId: CommandId,
+    threadId: ThreadId,
+    requestId: RuntimeRequestId,
+    decision: Schema.optional(ProviderApprovalDecision),
+    answers: Schema.optional(ProviderUserInputAnswers),
+  }),
+  Schema.Struct({
+    type: Schema.Literal("checkpoint.rollback"),
+    commandId: CommandId,
+    threadId: ThreadId,
+    scopeId: CheckpointScopeId,
+    checkpointId: CheckpointId,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("thread.fork"),
+    ...OrchestrationV2CreationFields,
+    commandId: CommandId,
+    sourceThreadId: ThreadId,
+    targetThreadId: ThreadId,
+    sourcePoint: OrchestrationV2ThreadForkSourcePoint,
+    title: Schema.optional(TrimmedNonEmptyString),
+    createdAt: Schema.optional(Schema.DateTimeUtc),
+  }),
+  Schema.Struct({
+    type: Schema.Literal("thread.merge_back"),
+    ...OrchestrationV2CreationFields,
+    commandId: CommandId,
+    sourceThreadId: ThreadId,
+    targetThreadId: ThreadId,
+    sourcePoint: OrchestrationV2ThreadForkSourcePoint,
+    createdAt: Schema.optional(Schema.DateTimeUtc),
+  }),
+  Schema.Struct({
+    type: Schema.Literal("delegated_task.request"),
+    ...OrchestrationV2CreationFields,
+    commandId: CommandId,
+    parentThreadId: ThreadId,
+    parentRunId: RunId,
+    parentNodeId: NodeId,
+    task: TrimmedNonEmptyString,
+    title: Schema.optional(TrimmedNonEmptyString),
+    modelSelection: ModelSelection,
+    runtimeMode: RuntimeMode,
+    interactionMode: ProviderInteractionMode,
+    // Omitted behaves as "settled_only" (no wake while the parent has a live
+    // run); producers that want fire-and-forget wakes must set "always".
+    completionWake: Schema.optional(Schema.Literals(["always", "settled_only"])),
+    createdAt: Schema.optional(Schema.DateTimeUtc),
+  }),
+  Schema.Struct({
+    type: Schema.Literal("delegated_task.wake-policy"),
+    commandId: CommandId,
+    parentThreadId: ThreadId,
+    taskId: NodeId,
+    completionWake: Schema.Literals(["always", "settled_only"]),
+  }),
+  Schema.Struct({
+    type: Schema.Literal("delegated_task.completion-delivery.acknowledge"),
+    commandId: CommandId,
+    parentThreadId: ThreadId,
+    taskId: NodeId,
+    observedByRunId: Schema.NullOr(RunId),
+  }),
+  Schema.Struct({
+    type: Schema.Literal("delegated_task.completion-delivery.dispose"),
+    commandId: CommandId,
+    parentThreadId: ThreadId,
+    taskId: NodeId,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("thread.created.record"),
+    commandId: CommandId,
+    parentThreadId: ThreadId,
+    parentRunId: RunId,
+    parentNodeId: NodeId,
+    targetThreadId: ThreadId,
+    targetRunId: Schema.NullOr(RunId),
+  }),
+  Schema.Struct({
+    type: Schema.Literal("provider.switch"),
+    commandId: CommandId,
+    threadId: ThreadId,
+    modelSelection: ModelSelection,
+  }),
+]);
+export type OrchestrationV2Command = typeof OrchestrationV2Command.Type;
+
+export const ORCHESTRATION_V2_WS_METHODS = {
+  dispatchCommand: "orchestration.dispatchCommand",
+  getTurnDiff: "orchestration.getTurnDiff",
+  getFullThreadDiff: "orchestration.getFullThreadDiff",
+  searchThreads: "orchestration.searchThreads",
+  getArchivedShellSnapshot: "orchestration.getArchivedShellSnapshot",
+  getThreadProjection: "orchestration.getThreadProjection",
+  getWorkflowScript: "orchestration.getWorkflowScript",
+  launchThread: "orchestration.launchThread",
+  subscribeArchivedShell: "orchestration.subscribeArchivedShell",
+  subscribeShell: "orchestration.subscribeShell",
+  subscribeThread: "orchestration.subscribeThread",
+} as const;
+
+export const OrchestrationV2ArchivedShellSnapshot = Schema.Struct({
+  schemaVersion: PositiveInt,
+  snapshotSequence: NonNegativeInt,
+  projects: Schema.Array(OrchestrationProjectShell),
+  threads: Schema.Array(OrchestrationV2ThreadShell),
+});
+export type OrchestrationV2ArchivedShellSnapshot = typeof OrchestrationV2ArchivedShellSnapshot.Type;
+
+export const OrchestrationV2ArchivedShellStreamItem = Schema.Union([
+  Schema.Struct({
+    kind: Schema.Literal("snapshot"),
+    snapshot: OrchestrationV2ArchivedShellSnapshot,
+  }),
+  Schema.Struct({
+    kind: Schema.Literal("thread.updated"),
+    sequence: NonNegativeInt,
+    thread: OrchestrationV2ThreadShell,
+  }),
+  Schema.Struct({
+    kind: Schema.Literal("thread.removed"),
+    sequence: NonNegativeInt,
+    threadId: ThreadId,
+  }),
+]);
+export type OrchestrationV2ArchivedShellStreamItem =
+  typeof OrchestrationV2ArchivedShellStreamItem.Type;
+
+export const OrchestrationV2ThreadLaunchWorkspaceStrategy = Schema.Union([
+  Schema.Struct({
+    type: Schema.Literal("root"),
+    branch: Schema.optional(TrimmedNonEmptyString),
+  }),
+  Schema.Struct({
+    type: Schema.Literal("existing_worktree"),
+    worktreePath: TrimmedNonEmptyString,
+    branch: Schema.optional(TrimmedNonEmptyString),
+  }),
+  Schema.Struct({
+    type: Schema.Literal("worktree"),
+    baseRef: TrimmedNonEmptyString,
+    branch: Schema.optional(TrimmedNonEmptyString),
+    startFromOrigin: Schema.optional(Schema.Boolean),
+  }),
+]);
+export type OrchestrationV2ThreadLaunchWorkspaceStrategy =
+  typeof OrchestrationV2ThreadLaunchWorkspaceStrategy.Type;
+
+export const OrchestrationV2ThreadLaunchInput = Schema.Struct({
+  commandId: CommandId,
+  creationSource: Schema.optional(OrchestrationV2CreationSource),
+  threadId: Schema.optional(ThreadId),
+  reuseExistingThread: Schema.optional(Schema.Boolean),
+  projectId: ProjectId,
+  title: TrimmedNonEmptyString,
+  generateTitle: Schema.optional(Schema.Boolean),
+  modelSelection: ModelSelection,
+  runtimeMode: RuntimeMode,
+  interactionMode: ProviderInteractionMode,
+  workspaceStrategy: OrchestrationV2ThreadLaunchWorkspaceStrategy,
+  initialMessage: Schema.optional(
+    Schema.Struct({
+      messageId: Schema.optional(MessageId),
+      text: Schema.String,
+      attachments: Schema.Array(ChatAttachment),
+    }),
+  ),
+});
+export type OrchestrationV2ThreadLaunchInput = typeof OrchestrationV2ThreadLaunchInput.Type;
+
+export const OrchestrationV2ThreadLaunchResult = Schema.Struct({
+  threadId: ThreadId,
+  projection: OrchestrationV2ThreadProjection,
+  resumed: Schema.Boolean,
+});
+export type OrchestrationV2ThreadLaunchResult = typeof OrchestrationV2ThreadLaunchResult.Type;
+
+export const OrchestrationV2DispatchCommandResult = Schema.Struct({
+  sequence: NonNegativeInt,
+});
+export type OrchestrationV2DispatchCommandResult = typeof OrchestrationV2DispatchCommandResult.Type;
+
+export const OrchestrationV2GetThreadProjectionInput = Schema.Struct({
+  threadId: ThreadId,
+});
+export type OrchestrationV2GetThreadProjectionInput =
+  typeof OrchestrationV2GetThreadProjectionInput.Type;
+
+export const OrchestrationV2SubscribeShellInput = Schema.Struct({
+  /**
+   * When provided, the server skips the initial full shell snapshot and instead
+   * replays shell events after this sequence before streaming live events.
+   * Clients that already hold a cached (or HTTP-loaded) shell snapshot pass its
+   * sequence here so the subscription resumes without re-sending the entire
+   * projects/threads list (overlapping events are deduped by sequence on the
+   * client).
+   */
+  afterSequence: Schema.optionalKey(NonNegativeInt),
+  /** Requests a marker between initial catch-up and live delivery. */
+  requestCompletionMarker: Schema.optionalKey(Schema.Boolean),
+});
+export type OrchestrationV2SubscribeShellInput = typeof OrchestrationV2SubscribeShellInput.Type;
+
+export const OrchestrationV2SubscribeThreadInput = Schema.Struct({
+  threadId: ThreadId,
+  /**
+   * When provided, the server skips the initial snapshot frame and instead
+   * replays events after this sequence before streaming live events. Clients
+   * that load the snapshot over HTTP pass the snapshot's sequence here so the
+   * live subscription resumes without a gap (overlapping events are deduped by
+   * sequence on the client).
+   */
+  afterSequence: Schema.optionalKey(NonNegativeInt),
+  /** Requests a marker between initial catch-up and live delivery. */
+  requestCompletionMarker: Schema.optionalKey(Schema.Boolean),
+});
+export type OrchestrationV2SubscribeThreadInput = typeof OrchestrationV2SubscribeThreadInput.Type;
+
+export const OrchestrationV2ThreadDetailSnapshot = Schema.Struct({
+  snapshotSequence: NonNegativeInt,
+  projection: OrchestrationV2ThreadProjection,
+  /**
+   * Progressive history metadata. Omitted on full-projection caches and older
+   * clients. When present with hasMoreHistory/cursor, the projection is a
+   * bounded window and must not be treated as a complete timeline.
+   */
+  historyCursor: Schema.optionalKey(Schema.NullOr(TrimmedNonEmptyString)),
+  hasMoreHistory: Schema.optionalKey(Schema.Boolean),
+  /**
+   * Max local turn ordinal from the authoritative full projection at snapshot
+   * time. Optional for backward-compatible warm cache entries.
+   */
+  latestLocalTurnOrdinal: Schema.optionalKey(Schema.NullOr(NonNegativeInt)),
+});
+export type OrchestrationV2ThreadDetailSnapshot = typeof OrchestrationV2ThreadDetailSnapshot.Type;
+
+/**
+ * Progressive cold open: full control-plane projection arrays with only a
+ * recent window of timeline rows. `historyCursor` is opaque; clients must not
+ * parse it. Resume live events with `afterSequence = snapshotSequence`.
+ */
+export const OrchestrationV2ThreadBoundedSnapshot = Schema.Struct({
+  snapshotSequence: NonNegativeInt,
+  projection: OrchestrationV2ThreadProjection,
+  historyCursor: Schema.NullOr(TrimmedNonEmptyString),
+  hasMoreHistory: Schema.Boolean,
+  /**
+   * Max local turn ordinal over the authoritative full projection turnItems.
+   * Clients use this as a partial-timeline watermark when the bounded window
+   * has no local rows (inherited-only).
+   */
+  latestLocalTurnOrdinal: Schema.NullOr(NonNegativeInt),
+  /** True only when required live control state alone exceeds the transport budget. */
+  payloadBudgetExceeded: Schema.optional(Schema.Boolean),
+});
+export type OrchestrationV2ThreadBoundedSnapshot = typeof OrchestrationV2ThreadBoundedSnapshot.Type;
+
+/** Older timeline page for progressive history. Rows are chronological. */
+export const OrchestrationV2ThreadHistoryPage = Schema.Struct({
+  snapshotSequence: NonNegativeInt,
+  items: Schema.Array(OrchestrationV2ProjectedTurnItem),
+  nextCursor: Schema.NullOr(TrimmedNonEmptyString),
+  hasMoreHistory: Schema.Boolean,
+});
+export type OrchestrationV2ThreadHistoryPage = typeof OrchestrationV2ThreadHistoryPage.Type;
+
+export const OrchestrationV2ThreadStreamItem = Schema.Union([
+  Schema.Struct({
+    kind: Schema.Literal("synchronized"),
+  }),
+  Schema.Struct({
+    kind: Schema.Literal("snapshot"),
+    snapshotSequence: NonNegativeInt,
+    projection: OrchestrationV2ThreadProjection,
+  }),
+  Schema.Struct({
+    kind: Schema.Literal("event"),
+    sequence: NonNegativeInt,
+    event: OrchestrationV2DomainEvent,
+  }),
+]);
+export type OrchestrationV2ThreadStreamItem = typeof OrchestrationV2ThreadStreamItem.Type;
+
+export class OrchestrationV2DispatchCommandError extends Schema.TaggedErrorClass<OrchestrationV2DispatchCommandError>()(
+  "OrchestrationV2DispatchCommandError",
+  {
+    commandId: CommandId,
+    commandType: Schema.String,
+    message: Schema.String,
+    detail: Schema.optional(Schema.String),
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {}
+
+export class OrchestrationV2GetThreadProjectionError extends Schema.TaggedErrorClass<OrchestrationV2GetThreadProjectionError>()(
+  "OrchestrationV2GetThreadProjectionError",
+  {
+    threadId: ThreadId,
+    message: Schema.String,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {}
+
+export class OrchestrationV2GetShellSnapshotError extends Schema.TaggedErrorClass<OrchestrationV2GetShellSnapshotError>()(
+  "OrchestrationV2GetShellSnapshotError",
+  {
+    message: Schema.String,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {}
+
+export class OrchestrationV2ThreadLaunchError extends Schema.TaggedErrorClass<OrchestrationV2ThreadLaunchError>()(
+  "OrchestrationV2ThreadLaunchError",
+  {
+    commandId: CommandId,
+    projectId: ProjectId,
+    message: Schema.String,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {}
+
+export const OrchestrationV2RpcError = Schema.Union([
+  OrchestrationV2DispatchCommandError,
+  OrchestrationV2GetThreadProjectionError,
+  OrchestrationV2GetShellSnapshotError,
+  OrchestrationV2ThreadLaunchError,
+]);
+export type OrchestrationV2RpcError = typeof OrchestrationV2RpcError.Type;
+
+export const OrchestrationV2GetWorkflowScriptInput = Schema.Struct({
+  threadId: ThreadId,
+  /** Absolute path from the workflow's runHandles.scriptPath. The server
+   * re-derives containment; the client value is a hint, never trusted. */
+  scriptPath: TrimmedNonEmptyString,
+});
+export type OrchestrationV2GetWorkflowScriptInput =
+  typeof OrchestrationV2GetWorkflowScriptInput.Type;
+
+export const OrchestrationV2GetWorkflowScriptResult = Schema.Struct({
+  scriptPath: TrimmedNonEmptyString,
+  contents: Schema.String,
+  truncated: Schema.Boolean,
+});
+export type OrchestrationV2GetWorkflowScriptResult =
+  typeof OrchestrationV2GetWorkflowScriptResult.Type;
+
+const WORKFLOW_SCRIPT_ERROR_MESSAGES = {
+  "invalid-path": "Workflow scripts must be absolute .js paths.",
+  "root-unavailable": "Script root unavailable.",
+  "not-found": "Script not found.",
+  "outside-root": "Script path is outside the workflow scripts root.",
+  "not-js": "Resolved script is not a .js file.",
+  "not-regular-file": "Script is not a regular file.",
+  "changed-during-read": "Script changed between resolution and open.",
+  "read-failed": "Script read failed.",
+} as const;
+
+export class OrchestrationGetWorkflowScriptError extends Schema.TaggedErrorClass<OrchestrationGetWorkflowScriptError>()(
+  "OrchestrationGetWorkflowScriptError",
+  {
+    reason: Schema.Literals([
+      "invalid-path",
+      "root-unavailable",
+      "not-found",
+      "outside-root",
+      "not-js",
+      "not-regular-file",
+      "changed-during-read",
+      "read-failed",
+    ]),
+    scriptPath: Schema.String,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {
+  override get message(): string {
+    return WORKFLOW_SCRIPT_ERROR_MESSAGES[this.reason];
+  }
+}
+
+export const OrchestrationV2RpcSchemas = {
+  dispatchCommand: {
+    input: OrchestrationV2Command,
+    output: OrchestrationV2DispatchCommandResult,
+  },
+  getTurnDiff: {
+    input: OrchestrationGetTurnDiffInput,
+    output: OrchestrationGetTurnDiffResult,
+  },
+  getFullThreadDiff: {
+    input: OrchestrationGetFullThreadDiffInput,
+    output: OrchestrationGetFullThreadDiffResult,
+  },
+  getArchivedShellSnapshot: {
+    input: Schema.Struct({}),
+    output: OrchestrationV2ArchivedShellSnapshot,
+  },
+  getThreadProjection: {
+    input: OrchestrationV2GetThreadProjectionInput,
+    output: OrchestrationV2ThreadProjection,
+  },
+  getWorkflowScript: {
+    input: OrchestrationV2GetWorkflowScriptInput,
+    output: OrchestrationV2GetWorkflowScriptResult,
+  },
+  launchThread: {
+    input: OrchestrationV2ThreadLaunchInput,
+    output: OrchestrationV2ThreadLaunchResult,
+  },
+  subscribeArchivedShell: {
+    input: Schema.Struct({}),
+    output: OrchestrationV2ArchivedShellStreamItem,
+  },
+  subscribeShell: {
+    input: OrchestrationV2SubscribeShellInput,
+    output: OrchestrationV2ShellStreamItem,
+  },
+  subscribeThread: {
+    input: OrchestrationV2SubscribeThreadInput,
+    output: OrchestrationV2ThreadStreamItem,
+  },
+} as const;
+
+export const ProviderReplayEntry = Schema.Union([
+  Schema.Struct({
+    type: Schema.Literal("expect_outbound"),
+    label: Schema.optional(TrimmedNonEmptyString),
+    frame: Schema.Unknown,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("emit_inbound"),
+    label: Schema.optional(TrimmedNonEmptyString),
+    frame: Schema.Unknown,
+    afterMs: Schema.optional(NonNegativeInt),
+  }),
+  Schema.Struct({
+    type: Schema.Literal("runtime_exit"),
+    status: Schema.Literals(["success", "error", "cancelled"]),
+    error: Schema.optional(Schema.Unknown),
+  }),
+]);
+export type ProviderReplayEntry = typeof ProviderReplayEntry.Type;
+
+export const ProviderReplayTranscript = Schema.Struct({
+  provider: TrimmedNonEmptyString,
+  protocol: TrimmedNonEmptyString,
+  version: TrimmedNonEmptyString,
+  scenario: TrimmedNonEmptyString,
+  metadata: Schema.optional(Schema.Record(Schema.String, Schema.Unknown)),
+  entries: Schema.Array(ProviderReplayEntry),
+});
+export type ProviderReplayTranscript = typeof ProviderReplayTranscript.Type;
+
+export const ProviderReplayTranscriptHeader = Schema.Struct({
+  type: Schema.Literal("transcript_start"),
+  provider: TrimmedNonEmptyString,
+  protocol: TrimmedNonEmptyString,
+  version: TrimmedNonEmptyString,
+  scenario: TrimmedNonEmptyString,
+  metadata: Schema.optional(Schema.Record(Schema.String, Schema.Unknown)),
+});
+export type ProviderReplayTranscriptHeader = typeof ProviderReplayTranscriptHeader.Type;
+
+export const ProviderReplayNdjsonRecord = Schema.Union([
+  ProviderReplayTranscriptHeader,
+  ProviderReplayEntry,
+]);
+export type ProviderReplayNdjsonRecord = typeof ProviderReplayNdjsonRecord.Type;
diff --git a/packages/contracts/src/orchestratorMcp.test.ts b/packages/contracts/src/orchestratorMcp.test.ts
new file mode 100644
index 000000000000..c668de287a92
--- /dev/null
+++ b/packages/contracts/src/orchestratorMcp.test.ts
@@ -0,0 +1,168 @@
+import { describe, expect, it } from "@effect/vitest";
+import * as Schema from "effect/Schema";
+
+import {
+  OrchestratorMcpCreateThreadsInput,
+  OrchestratorMcpDelegateTaskInput,
+  OrchestratorMcpDelegateTaskResult,
+  OrchestratorMcpThreadInterruptInput,
+  OrchestratorMcpThreadListInput,
+  OrchestratorMcpThreadReadInput,
+  OrchestratorMcpThreadSendInput,
+  OrchestratorMcpThreadStartInput,
+  OrchestratorMcpThreadWaitInput,
+} from "./orchestratorMcp.ts";
+
+const decodeCreateThreadsInput = Schema.decodeUnknownSync(OrchestratorMcpCreateThreadsInput);
+const decodeDelegateTaskInput = Schema.decodeUnknownSync(OrchestratorMcpDelegateTaskInput);
+const decodeDelegateTaskResult = Schema.decodeUnknownSync(OrchestratorMcpDelegateTaskResult);
+const decodeThreadInterruptInput = Schema.decodeUnknownSync(OrchestratorMcpThreadInterruptInput);
+const decodeThreadListInput = Schema.decodeUnknownSync(OrchestratorMcpThreadListInput);
+const decodeThreadReadInput = Schema.decodeUnknownSync(OrchestratorMcpThreadReadInput);
+const decodeThreadSendInput = Schema.decodeUnknownSync(OrchestratorMcpThreadSendInput);
+const decodeThreadStartInput = Schema.decodeUnknownSync(OrchestratorMcpThreadStartInput);
+const decodeThreadWaitInput = Schema.decodeUnknownSync(OrchestratorMcpThreadWaitInput);
+
+describe("orchestrator MCP contracts", () => {
+  it("decodes cross-provider delegated task requests and durable results", () => {
+    const request = decodeDelegateTaskInput({
+      task: "Inspect the workspace and report the result.",
+      target: {
+        providerInstanceId: "claudeAgent",
+        model: "claude-sonnet-4-6",
+      },
+      mode: "wait",
+      timeoutMs: 5_000,
+      clientRequestId: "delegate-1",
+      runtimeMode: "inherit",
+      interactionMode: "inherit",
+    });
+    const result = decodeDelegateTaskResult({
+      taskId: "node-task-1",
+      childThreadId: "thread-child-1",
+      childRunId: "run-child-1",
+      childNodeId: "node-task-1",
+      status: "completed",
+      providerInstanceId: "claudeAgent",
+      model: "claude-sonnet-4-6",
+      summary: "Workspace inspected.",
+      resultContextTransferId: "context-transfer-result-1",
+      waitTimedOut: false,
+    });
+
+    expect(request.target?.providerInstanceId).toBe("claudeAgent");
+    expect(result.status).toBe("completed");
+    expect(result.summary).toBe("Workspace inspected.");
+  });
+
+  it("decodes target model options in canonical and shorthand shapes", () => {
+    const canonical = decodeDelegateTaskInput({
+      task: "Say hello.",
+      target: {
+        providerInstanceId: "codex",
+        model: "gpt-5.6-luna",
+        options: [{ id: "reasoning", value: "low" }],
+      },
+    });
+    const shorthand = decodeDelegateTaskInput({
+      task: "Say hello.",
+      target: {
+        providerInstanceId: "codex",
+        model: "gpt-5.6-luna",
+        options: { reasoning: "low", fastMode: true },
+      },
+    });
+
+    expect(canonical.target?.options).toEqual([{ id: "reasoning", value: "low" }]);
+    expect(shorthand.target?.options).toEqual([
+      { id: "reasoning", value: "low" },
+      { id: "fastMode", value: true },
+    ]);
+  });
+
+  it("rejects target model options that are not strings or booleans", () => {
+    expect(() =>
+      decodeDelegateTaskInput({
+        task: "Say hello.",
+        target: {
+          providerInstanceId: "codex",
+          model: "gpt-5.6-luna",
+          // Must fail loudly instead of being dropped like legacy persistence.
+          options: { reasoning: 3 },
+        },
+      }),
+    ).toThrow();
+    expect(() =>
+      decodeDelegateTaskInput({
+        task: "Say hello.",
+        target: {
+          providerInstanceId: "codex",
+          model: "gpt-5.6-luna",
+          options: [{ id: "reasoning", value: null }],
+        },
+      }),
+    ).toThrow();
+  });
+
+  it("decodes mixed prompted and empty thread batches", () => {
+    const request = decodeCreateThreadsInput({
+      clientRequestId: "threads-1",
+      threads: [
+        { title: "Inherited empty thread" },
+        {
+          prompt: "Review the API.",
+          target: { driverKind: "claudeAgent" },
+          runtimeMode: "approval-required",
+        },
+      ],
+    });
+
+    expect(request.threads).toHaveLength(2);
+    expect(request.threads[0]?.prompt).toBeUndefined();
+    expect(request.threads[1]?.target?.driverKind).toBe("claudeAgent");
+  });
+
+  it("decodes project-scoped thread orchestration requests", () => {
+    expect(
+      decodeThreadStartInput({
+        prompt: "Run the first loop iteration.",
+        clientRequestId: "start-loop-1",
+      }).prompt,
+    ).toBe("Run the first loop iteration.");
+    expect(
+      decodeThreadListInput({
+        statuses: ["running", "completed"],
+        includeSubagents: false,
+        limit: 25,
+      }).statuses,
+    ).toEqual(["running", "completed"]);
+    expect(
+      decodeThreadReadInput({
+        threadId: "thread-loop-1",
+        view: "activity",
+        afterPosition: 10,
+      }).afterPosition,
+    ).toBe(10);
+    expect(
+      decodeThreadSendInput({
+        threadId: "thread-loop-1",
+        message: "Continue with the next iteration.",
+        mode: "steer",
+        clientRequestId: "send-loop-2",
+      }).mode,
+    ).toBe("steer");
+    expect(
+      decodeThreadWaitInput({
+        threadId: "thread-loop-1",
+        runId: "run-loop-2",
+        timeoutMs: 5_000,
+      }).runId,
+    ).toBe("run-loop-2");
+    expect(
+      decodeThreadInterruptInput({
+        threadId: "thread-loop-1",
+        reason: "Loop converged.",
+      }).reason,
+    ).toBe("Loop converged.");
+  });
+});
diff --git a/packages/contracts/src/orchestratorMcp.ts b/packages/contracts/src/orchestratorMcp.ts
new file mode 100644
index 000000000000..7e62e9351d31
--- /dev/null
+++ b/packages/contracts/src/orchestratorMcp.ts
@@ -0,0 +1,560 @@
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import * as SchemaTransformation from "effect/SchemaTransformation";
+
+import {
+  ContextTransferId,
+  IsoDateTime,
+  MessageId,
+  NodeId,
+  NonNegativeInt,
+  PositiveInt,
+  ProjectId,
+  RunId,
+  ScheduledTaskId,
+  ThreadId,
+  TrimmedNonEmptyString,
+  TurnItemId,
+} from "./baseSchemas.ts";
+import {
+  ScheduledTaskRunStatus,
+  ScheduledTaskSchedule,
+  ScheduledTaskUpsertSchedule,
+} from "./scheduledTask.ts";
+import { ProviderInteractionMode, RuntimeMode } from "./providerPolicy.ts";
+import {
+  OrchestrationV2Actor,
+  OrchestrationV2CreationSource,
+  OrchestrationV2RunStatus,
+  OrchestrationV2TurnItemStatus,
+} from "./orchestrationV2.ts";
+import {
+  ProviderOptionDescriptor,
+  ProviderOptionSelection,
+  ProviderOptionSelectionValue,
+} from "./model.ts";
+import { ProviderDriverKind, ProviderInstanceId } from "./providerInstance.ts";
+
+const OrchestratorMcpPrompt = TrimmedNonEmptyString.check(Schema.isMaxLength(120_000)).annotate({
+  description: "Complete task or message text for the target agent.",
+});
+const OrchestratorMcpTitle = TrimmedNonEmptyString.check(Schema.isMaxLength(512)).annotate({
+  description: "Optional concise display title.",
+});
+const OrchestratorMcpClientRequestId = TrimmedNonEmptyString.check(
+  Schema.isMaxLength(256),
+).annotate({ description: "Stable idempotency key to reuse when retrying this mutation." });
+
+/**
+ * OpenCode 1.15 has been observed serializing nested MCP union objects as JSON
+ * strings. Keep the structured object as the documented form while accepting
+ * that compatibility shape at the tool boundary and decoding it immediately.
+ */
+const OrchestratorMcpScheduleFromJsonString = Schema.fromJsonString(
+  ScheduledTaskUpsertSchedule,
+).annotate({
+  description:
+    "Compatibility-only JSON encoding of the schedule object. Prefer a structured object.",
+});
+
+const OrchestratorMcpSchedule = Schema.Union([
+  ScheduledTaskUpsertSchedule,
+  OrchestratorMcpScheduleFromJsonString,
+]).annotate({
+  description:
+    "Recurring schedule object: {type:'interval', everyMs} or {type:'fixed_time', timeOfDay, weekdays?}. Never stringify it unless the provider requires the compatibility form.",
+});
+
+/**
+ * Shorthand `{ id: value }` record form for target model options. Unlike the
+ * legacy-tolerant `ProviderOptionSelections` persistence schema, this decodes
+ * strictly: a value that is not a string or boolean fails the request rather
+ * than being silently dropped.
+ */
+const OrchestratorMcpTargetOptionsFromRecord = Schema.Record(
+  Schema.String,
+  ProviderOptionSelectionValue,
+).pipe(
+  Schema.decodeTo(
+    Schema.Array(ProviderOptionSelection),
+    SchemaTransformation.transformOrFail({
+      decode: (record) =>
+        Effect.succeed(Object.entries(record).map(([id, value]) => ({ id, value }))),
+      encode: (selections: ReadonlyArray<ProviderOptionSelection>) =>
+        Effect.succeed(
+          Object.fromEntries(selections.map((selection) => [selection.id, selection.value])),
+        ),
+    }),
+  ),
+);
+
+export const OrchestratorMcpTargetOptions = Schema.Union([
+  Schema.Array(ProviderOptionSelection),
+  OrchestratorMcpTargetOptionsFromRecord,
+]);
+export type OrchestratorMcpTargetOptions = typeof OrchestratorMcpTargetOptions.Type;
+
+export const OrchestratorMcpTarget = Schema.Struct({
+  providerInstanceId: Schema.optional(
+    ProviderInstanceId.annotate({
+      description: "Configured provider instance id from orchestrator_capabilities.",
+    }),
+  ),
+  driverKind: Schema.optional(
+    ProviderDriverKind.annotate({
+      description: "Provider driver kind; prefer providerInstanceId when available.",
+    }),
+  ),
+  model: Schema.optional(
+    TrimmedNonEmptyString.annotate({
+      description: "Model id advertised for the selected provider instance.",
+    }),
+  ),
+  /**
+   * Model option selections for the child (for example reasoning effort).
+   * Accepts the canonical `[{ id, value }]` array or the shorthand
+   * `{ id: value }` record; valid ids come from the option descriptors
+   * advertised by orchestrator_capabilities. When omitted, options inherit
+   * from the parent only when the child runs the parent's provider and model.
+   */
+  options: Schema.optional(
+    OrchestratorMcpTargetOptions.annotate({
+      description: "Model option selections advertised by orchestrator_capabilities.",
+    }),
+  ),
+});
+export type OrchestratorMcpTarget = typeof OrchestratorMcpTarget.Type;
+
+export const OrchestratorMcpRuntimeMode = Schema.Union([Schema.Literal("inherit"), RuntimeMode]);
+export type OrchestratorMcpRuntimeMode = typeof OrchestratorMcpRuntimeMode.Type;
+
+export const OrchestratorMcpInteractionMode = Schema.Union([
+  Schema.Literal("inherit"),
+  ProviderInteractionMode,
+]);
+export type OrchestratorMcpInteractionMode = typeof OrchestratorMcpInteractionMode.Type;
+
+export const OrchestratorMcpTaskRole = Schema.Literals([
+  "implementation",
+  "research",
+  "review",
+  "design",
+  "test",
+  "general",
+]);
+export type OrchestratorMcpTaskRole = typeof OrchestratorMcpTaskRole.Type;
+
+export const OrchestratorMcpDelegatedTaskStatus = Schema.Literals([
+  "queued",
+  "running",
+  "waiting",
+  "completed",
+  "failed",
+  "cancelled",
+  "interrupted",
+]);
+export type OrchestratorMcpDelegatedTaskStatus = typeof OrchestratorMcpDelegatedTaskStatus.Type;
+
+export const OrchestratorMcpDelegateTaskInput = Schema.Struct({
+  task: OrchestratorMcpPrompt.annotate({
+    description: "Self-contained task for one delegated child agent/subagent.",
+  }),
+  target: Schema.optional(OrchestratorMcpTarget),
+  title: Schema.optional(OrchestratorMcpTitle),
+  role: Schema.optional(OrchestratorMcpTaskRole),
+  mode: Schema.optional(Schema.Literals(["async", "wait"])),
+  timeoutMs: Schema.optional(Schema.Number),
+  clientRequestId: Schema.optional(OrchestratorMcpClientRequestId),
+  runtimeMode: Schema.optional(OrchestratorMcpRuntimeMode),
+  interactionMode: Schema.optional(OrchestratorMcpInteractionMode),
+});
+export type OrchestratorMcpDelegateTaskInput = typeof OrchestratorMcpDelegateTaskInput.Type;
+
+export const OrchestratorMcpDelegateTaskResult = Schema.Struct({
+  taskId: NodeId,
+  childThreadId: ThreadId,
+  childRunId: Schema.NullOr(RunId),
+  childNodeId: NodeId,
+  status: OrchestratorMcpDelegatedTaskStatus,
+  providerInstanceId: ProviderInstanceId,
+  model: Schema.NullOr(Schema.String),
+  summary: Schema.NullOr(Schema.String),
+  resultContextTransferId: Schema.NullOr(ContextTransferId),
+  waitTimedOut: Schema.Boolean,
+});
+export type OrchestratorMcpDelegateTaskResult = typeof OrchestratorMcpDelegateTaskResult.Type;
+
+export const OrchestratorMcpTaskStatusInput = Schema.Struct({
+  taskId: NodeId,
+});
+export type OrchestratorMcpTaskStatusInput = typeof OrchestratorMcpTaskStatusInput.Type;
+
+export const OrchestratorMcpTaskCancelInput = Schema.Struct({
+  taskId: NodeId,
+  reason: Schema.optional(Schema.String.check(Schema.isMaxLength(2_000))),
+  clientRequestId: Schema.optional(OrchestratorMcpClientRequestId),
+});
+export type OrchestratorMcpTaskCancelInput = typeof OrchestratorMcpTaskCancelInput.Type;
+
+export const OrchestratorMcpTaskCancelResult = Schema.Struct({
+  taskId: NodeId,
+  status: Schema.Literals(["cancel_requested", "completed", "failed", "cancelled", "interrupted"]),
+});
+export type OrchestratorMcpTaskCancelResult = typeof OrchestratorMcpTaskCancelResult.Type;
+
+export const OrchestratorMcpCreateThreadRequest = Schema.Struct({
+  prompt: Schema.optional(OrchestratorMcpPrompt),
+  title: Schema.optional(OrchestratorMcpTitle),
+  target: Schema.optional(OrchestratorMcpTarget),
+  runtimeMode: Schema.optional(OrchestratorMcpRuntimeMode),
+  interactionMode: Schema.optional(OrchestratorMcpInteractionMode),
+});
+export type OrchestratorMcpCreateThreadRequest = typeof OrchestratorMcpCreateThreadRequest.Type;
+
+export const OrchestratorMcpCreateThreadsInput = Schema.Struct({
+  threads: Schema.Array(OrchestratorMcpCreateThreadRequest).check(
+    Schema.isMinLength(1),
+    Schema.isMaxLength(20),
+  ),
+  clientRequestId: Schema.optional(OrchestratorMcpClientRequestId),
+});
+export type OrchestratorMcpCreateThreadsInput = typeof OrchestratorMcpCreateThreadsInput.Type;
+
+export const OrchestratorMcpCreatedThreadStatus = Schema.Union([
+  Schema.Literal("idle"),
+  Schema.Literal("preparing"),
+  Schema.Literal("starting"),
+  OrchestratorMcpDelegatedTaskStatus,
+  Schema.Literal("rolled_back"),
+]);
+export type OrchestratorMcpCreatedThreadStatus = typeof OrchestratorMcpCreatedThreadStatus.Type;
+
+export const OrchestratorMcpCreatedThread = Schema.Struct({
+  threadId: ThreadId,
+  runId: Schema.NullOr(RunId),
+  status: OrchestratorMcpCreatedThreadStatus,
+  title: Schema.String,
+  createdBy: OrchestrationV2Actor,
+  creationSource: OrchestrationV2CreationSource,
+  providerInstanceId: ProviderInstanceId,
+  model: Schema.String,
+});
+export type OrchestratorMcpCreatedThread = typeof OrchestratorMcpCreatedThread.Type;
+
+export const OrchestratorMcpCreateThreadsResult = Schema.Struct({
+  threads: Schema.Array(OrchestratorMcpCreatedThread),
+});
+export type OrchestratorMcpCreateThreadsResult = typeof OrchestratorMcpCreateThreadsResult.Type;
+
+export const OrchestratorMcpThreadStartInput = Schema.Struct({
+  prompt: OrchestratorMcpPrompt,
+  title: Schema.optional(OrchestratorMcpTitle),
+  target: Schema.optional(OrchestratorMcpTarget),
+  clientRequestId: Schema.optional(OrchestratorMcpClientRequestId),
+  runtimeMode: Schema.optional(OrchestratorMcpRuntimeMode),
+  interactionMode: Schema.optional(OrchestratorMcpInteractionMode),
+});
+export type OrchestratorMcpThreadStartInput = typeof OrchestratorMcpThreadStartInput.Type;
+
+export const OrchestratorMcpThreadStatus = Schema.Union([
+  Schema.Literal("idle"),
+  OrchestrationV2RunStatus,
+]);
+export type OrchestratorMcpThreadStatus = typeof OrchestratorMcpThreadStatus.Type;
+
+export const OrchestratorMcpThreadListInput = Schema.Struct({
+  statuses: Schema.optional(
+    Schema.Array(OrchestratorMcpThreadStatus).check(Schema.isMaxLength(10)),
+  ),
+  titleContains: Schema.optional(TrimmedNonEmptyString.check(Schema.isMaxLength(256))),
+  includeSubagents: Schema.optional(Schema.Boolean),
+  cursor: Schema.optional(NonNegativeInt),
+  limit: Schema.optional(PositiveInt.check(Schema.isLessThanOrEqualTo(100))),
+});
+export type OrchestratorMcpThreadListInput = typeof OrchestratorMcpThreadListInput.Type;
+
+export const OrchestratorMcpThreadListItem = Schema.Struct({
+  threadId: ThreadId,
+  title: Schema.String,
+  createdBy: OrchestrationV2Actor,
+  creationSource: OrchestrationV2CreationSource,
+  status: OrchestratorMcpThreadStatus,
+  latestRunId: Schema.NullOr(RunId),
+  providerInstanceId: ProviderInstanceId,
+  model: Schema.String,
+  runtimeMode: RuntimeMode,
+  interactionMode: ProviderInteractionMode,
+  parentThreadId: Schema.NullOr(ThreadId),
+  relationshipToParent: Schema.NullOr(Schema.Literals(["fork", "subagent"])),
+  itemCount: NonNegativeInt,
+  createdAt: IsoDateTime,
+  updatedAt: IsoDateTime,
+});
+export type OrchestratorMcpThreadListItem = typeof OrchestratorMcpThreadListItem.Type;
+
+export const OrchestratorMcpThreadListResult = Schema.Struct({
+  projectId: ProjectId,
+  currentThreadId: ThreadId,
+  threads: Schema.Array(OrchestratorMcpThreadListItem),
+  nextCursor: Schema.NullOr(NonNegativeInt),
+  total: NonNegativeInt,
+});
+export type OrchestratorMcpThreadListResult = typeof OrchestratorMcpThreadListResult.Type;
+
+export const OrchestratorMcpThreadReadInput = Schema.Struct({
+  threadId: ThreadId,
+  view: Schema.optional(Schema.Literals(["messages", "activity"])),
+  afterPosition: Schema.optional(NonNegativeInt),
+  limit: Schema.optional(PositiveInt.check(Schema.isLessThanOrEqualTo(100))),
+  runLimit: Schema.optional(PositiveInt.check(Schema.isLessThanOrEqualTo(50))),
+  maxCharsPerItem: Schema.optional(PositiveInt.check(Schema.isLessThanOrEqualTo(50_000))),
+});
+export type OrchestratorMcpThreadReadInput = typeof OrchestratorMcpThreadReadInput.Type;
+
+export const OrchestratorMcpThreadDetail = Schema.Struct({
+  threadId: ThreadId,
+  projectId: ProjectId,
+  title: Schema.String,
+  createdBy: OrchestrationV2Actor,
+  creationSource: OrchestrationV2CreationSource,
+  status: OrchestratorMcpThreadStatus,
+  latestRunId: Schema.NullOr(RunId),
+  activeRunId: Schema.NullOr(RunId),
+  providerInstanceId: ProviderInstanceId,
+  model: Schema.String,
+  runtimeMode: RuntimeMode,
+  interactionMode: ProviderInteractionMode,
+  branch: Schema.NullOr(Schema.String),
+  worktreePath: Schema.NullOr(Schema.String),
+  parentThreadId: Schema.NullOr(ThreadId),
+  relationshipToParent: Schema.NullOr(Schema.Literals(["fork", "subagent"])),
+  runCount: NonNegativeInt,
+  itemCount: NonNegativeInt,
+  pendingRequestCount: NonNegativeInt,
+  archived: Schema.Boolean,
+  createdAt: IsoDateTime,
+  updatedAt: IsoDateTime,
+});
+export type OrchestratorMcpThreadDetail = typeof OrchestratorMcpThreadDetail.Type;
+
+export const OrchestratorMcpThreadRun = Schema.Struct({
+  runId: RunId,
+  ordinal: PositiveInt,
+  status: OrchestrationV2RunStatus,
+  providerInstanceId: ProviderInstanceId,
+  model: Schema.String,
+  requestedAt: IsoDateTime,
+  startedAt: Schema.NullOr(IsoDateTime),
+  completedAt: Schema.NullOr(IsoDateTime),
+});
+export type OrchestratorMcpThreadRun = typeof OrchestratorMcpThreadRun.Type;
+
+export const OrchestratorMcpThreadTimelineItem = Schema.Struct({
+  position: NonNegativeInt,
+  visibility: Schema.Literals(["local", "inherited", "synthetic"]),
+  sourceThreadId: ThreadId,
+  itemId: TurnItemId,
+  runId: Schema.NullOr(RunId),
+  messageId: Schema.NullOr(MessageId),
+  createdBy: Schema.NullOr(OrchestrationV2Actor),
+  creationSource: Schema.NullOr(OrchestrationV2CreationSource),
+  type: Schema.String,
+  status: OrchestrationV2TurnItemStatus,
+  title: Schema.NullOr(Schema.String),
+  text: Schema.NullOr(Schema.String),
+  textTruncated: Schema.Boolean,
+  updatedAt: IsoDateTime,
+});
+export type OrchestratorMcpThreadTimelineItem = typeof OrchestratorMcpThreadTimelineItem.Type;
+
+export const OrchestratorMcpThreadReadResult = Schema.Struct({
+  thread: OrchestratorMcpThreadDetail,
+  recentRuns: Schema.Array(OrchestratorMcpThreadRun),
+  items: Schema.Array(OrchestratorMcpThreadTimelineItem),
+  nextPosition: Schema.NullOr(NonNegativeInt),
+  hasMore: Schema.Boolean,
+});
+export type OrchestratorMcpThreadReadResult = typeof OrchestratorMcpThreadReadResult.Type;
+
+export const OrchestratorMcpThreadSendInput = Schema.Struct({
+  threadId: ThreadId,
+  message: OrchestratorMcpPrompt,
+  mode: Schema.optional(Schema.Literals(["auto", "queue", "steer", "restart"])),
+  clientRequestId: Schema.optional(OrchestratorMcpClientRequestId),
+});
+export type OrchestratorMcpThreadSendInput = typeof OrchestratorMcpThreadSendInput.Type;
+
+export const OrchestratorMcpThreadSendResult = Schema.Struct({
+  threadId: ThreadId,
+  messageId: MessageId,
+  runId: RunId,
+  status: OrchestrationV2RunStatus,
+  delivery: Schema.Literals(["started", "queued", "steered", "restarted"]),
+});
+export type OrchestratorMcpThreadSendResult = typeof OrchestratorMcpThreadSendResult.Type;
+
+export const OrchestratorMcpThreadWaitInput = Schema.Struct({
+  threadId: ThreadId,
+  runId: Schema.optional(RunId),
+  timeoutMs: Schema.optional(Schema.Number),
+});
+export type OrchestratorMcpThreadWaitInput = typeof OrchestratorMcpThreadWaitInput.Type;
+
+export const OrchestratorMcpThreadWaitResult = Schema.Struct({
+  threadId: ThreadId,
+  runId: Schema.NullOr(RunId),
+  status: OrchestratorMcpThreadStatus,
+  timedOut: Schema.Boolean,
+});
+export type OrchestratorMcpThreadWaitResult = typeof OrchestratorMcpThreadWaitResult.Type;
+
+export const OrchestratorMcpThreadInterruptInput = Schema.Struct({
+  threadId: ThreadId,
+  runId: Schema.optional(RunId),
+  reason: Schema.optional(Schema.String.check(Schema.isMaxLength(2_000))),
+  clientRequestId: Schema.optional(OrchestratorMcpClientRequestId),
+});
+export type OrchestratorMcpThreadInterruptInput = typeof OrchestratorMcpThreadInterruptInput.Type;
+
+export const OrchestratorMcpThreadInterruptResult = Schema.Struct({
+  threadId: ThreadId,
+  runId: Schema.NullOr(RunId),
+  status: Schema.Union([
+    Schema.Literal("interrupt_requested"),
+    Schema.Literal("no_active_run"),
+    Schema.Literals(["completed", "failed", "cancelled", "interrupted", "rolled_back"]),
+  ]),
+});
+export type OrchestratorMcpThreadInterruptResult = typeof OrchestratorMcpThreadInterruptResult.Type;
+
+export const OrchestratorMcpProviderCapability = Schema.Struct({
+  providerInstanceId: ProviderInstanceId,
+  driverKind: ProviderDriverKind,
+  displayName: Schema.NullOr(Schema.String),
+  models: Schema.Array(
+    Schema.Struct({
+      id: Schema.String,
+      label: Schema.NullOr(Schema.String),
+      /** Model options a target may select (for example reasoning effort). */
+      options: Schema.optional(Schema.Array(ProviderOptionDescriptor)),
+    }),
+  ),
+  canRunChildTask: Schema.Boolean,
+  canRunCrossProviderChildTask: Schema.Boolean,
+  constraints: Schema.Array(Schema.String),
+});
+export type OrchestratorMcpProviderCapability = typeof OrchestratorMcpProviderCapability.Type;
+
+export const OrchestratorMcpCapabilitiesResult = Schema.Struct({
+  parentThreadId: ThreadId,
+  inheritedProviderInstanceId: ProviderInstanceId,
+  inheritedModel: Schema.String,
+  runtimeMode: RuntimeMode,
+  interactionMode: ProviderInteractionMode,
+  providers: Schema.Array(OrchestratorMcpProviderCapability),
+  features: Schema.Struct({
+    appOwnedSubagents: Schema.Boolean,
+    asyncPolling: Schema.Boolean,
+    cancellation: Schema.Boolean,
+    batchThreadCreation: Schema.Boolean,
+    threadManagement: Schema.Boolean,
+    incrementalThreadRead: Schema.Boolean,
+    scheduledTasks: Schema.Boolean,
+    maxBatchThreads: Schema.Number,
+  }),
+});
+export type OrchestratorMcpCapabilitiesResult = typeof OrchestratorMcpCapabilitiesResult.Type;
+
+export const OrchestratorMcpScheduleTaskInput = Schema.Struct({
+  prompt: OrchestratorMcpPrompt.annotate({
+    description: "Prompt executed on every scheduled run.",
+  }),
+  schedule: OrchestratorMcpSchedule,
+  title: Schema.optional(OrchestratorMcpTitle),
+  enabled: Schema.optional(
+    Schema.Boolean.annotate({ description: "Whether the schedule starts enabled; defaults true." }),
+  ),
+  /**
+   * When true (the default), the scheduled task fires into the calling thread
+   * on each run instead of launching a fresh thread. This is the recurring
+   * "wake up in this thread" behaviour reserved for agent-created tasks.
+   */
+  bindToCurrentThread: Schema.optional(
+    Schema.Boolean.annotate({
+      description:
+        "True (default) posts each run into this thread; false creates a fresh top-level thread per run.",
+    }),
+  ),
+  clientRequestId: Schema.optional(OrchestratorMcpClientRequestId),
+});
+export type OrchestratorMcpScheduleTaskInput = typeof OrchestratorMcpScheduleTaskInput.Type;
+
+/** Summary of a scheduled task returned by the schedule/list/update tools. */
+export const OrchestratorMcpScheduledTask = Schema.Struct({
+  scheduledTaskId: ScheduledTaskId,
+  title: Schema.String,
+  prompt: Schema.String,
+  enabled: Schema.Boolean,
+  projectId: ProjectId,
+  boundThreadId: Schema.NullOr(ThreadId),
+  schedule: ScheduledTaskSchedule,
+  nextRunAt: Schema.NullOr(IsoDateTime),
+  lastRunStatus: ScheduledTaskRunStatus,
+});
+export type OrchestratorMcpScheduledTask = typeof OrchestratorMcpScheduledTask.Type;
+
+export const OrchestratorMcpScheduleTaskResult = OrchestratorMcpScheduledTask;
+export type OrchestratorMcpScheduleTaskResult = typeof OrchestratorMcpScheduleTaskResult.Type;
+
+export const OrchestratorMcpListScheduledTasksResult = Schema.Struct({
+  tasks: Schema.Array(OrchestratorMcpScheduledTask),
+});
+export type OrchestratorMcpListScheduledTasksResult =
+  typeof OrchestratorMcpListScheduledTasksResult.Type;
+
+export const OrchestratorMcpUpdateScheduledTaskInput = Schema.Struct({
+  scheduledTaskId: ScheduledTaskId,
+  prompt: Schema.optional(OrchestratorMcpPrompt),
+  title: Schema.optional(OrchestratorMcpTitle),
+  schedule: Schema.optional(OrchestratorMcpSchedule),
+  enabled: Schema.optional(Schema.Boolean),
+  bindToCurrentThread: Schema.optional(Schema.Boolean),
+});
+export type OrchestratorMcpUpdateScheduledTaskInput =
+  typeof OrchestratorMcpUpdateScheduledTaskInput.Type;
+
+export const OrchestratorMcpDeleteScheduledTaskInput = Schema.Struct({
+  scheduledTaskId: ScheduledTaskId,
+});
+export type OrchestratorMcpDeleteScheduledTaskInput =
+  typeof OrchestratorMcpDeleteScheduledTaskInput.Type;
+
+export const OrchestratorMcpDeleteScheduledTaskResult = Schema.Struct({
+  scheduledTaskId: ScheduledTaskId,
+  deleted: Schema.Boolean,
+});
+export type OrchestratorMcpDeleteScheduledTaskResult =
+  typeof OrchestratorMcpDeleteScheduledTaskResult.Type;
+
+export class OrchestratorMcpFailure extends Schema.TaggedErrorClass<OrchestratorMcpFailure>()(
+  "OrchestratorMcpFailure",
+  {
+    code: Schema.Literals([
+      "capability_denied",
+      "parent_not_active",
+      "provider_unavailable",
+      "model_unavailable",
+      "runtime_mode_escalation_denied",
+      "interaction_mode_escalation_denied",
+      "task_not_found",
+      "task_not_cancellable",
+      "thread_not_found",
+      "run_not_found",
+      "thread_not_sendable",
+      "thread_not_interruptible",
+      "invalid_request",
+      "orchestration_error",
+    ]),
+    message: Schema.String,
+  },
+) {}
diff --git a/packages/contracts/src/project.ts b/packages/contracts/src/project.ts
index 757c000a065a..5f95ecd154a4 100644
--- a/packages/contracts/src/project.ts
+++ b/packages/contracts/src/project.ts
@@ -1,7 +1,12 @@
 import * as Schema from "effect/Schema";
+import { RepositoryIdentity } from "./environment.ts";
+import { ModelSelection } from "./modelSelection.ts";
 import {
+  CommandId,
+  IsoDateTime,
   NonNegativeInt,
   PositiveInt,
+  ProjectId,
   TrimmedNonEmptyString,
   TrimmedString,
 } from "./baseSchemas.ts";
@@ -11,6 +16,95 @@ const PROJECT_SEARCH_CONTENTS_MAX_LIMIT = 500;
 const PROJECT_WRITE_FILE_PATH_MAX_LENGTH = 512;
 const PROJECT_READ_FILE_PATH_MAX_LENGTH = 512;
 
+export const ProjectScriptIcon = Schema.Literals([
+  "play",
+  "test",
+  "lint",
+  "configure",
+  "build",
+  "debug",
+]);
+export type ProjectScriptIcon = typeof ProjectScriptIcon.Type;
+
+export const ProjectScript = Schema.Struct({
+  id: TrimmedNonEmptyString,
+  name: TrimmedNonEmptyString,
+  command: TrimmedNonEmptyString,
+  icon: ProjectScriptIcon,
+  runOnWorktreeCreate: Schema.Boolean,
+  previewUrl: Schema.optional(TrimmedNonEmptyString),
+  autoOpenPreview: Schema.optional(Schema.Boolean),
+});
+export type ProjectScript = typeof ProjectScript.Type;
+
+export const Project = Schema.Struct({
+  id: ProjectId,
+  title: TrimmedNonEmptyString,
+  workspaceRoot: TrimmedNonEmptyString,
+  repositoryIdentity: Schema.optional(Schema.NullOr(RepositoryIdentity)),
+  faviconPath: Schema.optional(Schema.NullOr(TrimmedNonEmptyString)),
+  defaultModelSelection: Schema.NullOr(ModelSelection),
+  scripts: Schema.Array(ProjectScript),
+  createdAt: IsoDateTime,
+  updatedAt: IsoDateTime,
+  deletedAt: Schema.NullOr(IsoDateTime),
+});
+export type Project = typeof Project.Type;
+
+export const ProjectSnapshot = Schema.Struct({
+  projects: Schema.Array(Project),
+  updatedAt: IsoDateTime,
+});
+export type ProjectSnapshot = typeof ProjectSnapshot.Type;
+
+export const ProjectChange = Schema.Union([
+  Schema.Struct({ type: Schema.Literal("project.upserted"), project: Project }),
+  Schema.Struct({
+    type: Schema.Literal("project.deleted"),
+    projectId: ProjectId,
+    deletedAt: IsoDateTime,
+  }),
+]);
+export type ProjectChange = typeof ProjectChange.Type;
+
+export const ProjectMutation = Schema.Union([
+  Schema.Struct({
+    type: Schema.Literal("project.create"),
+    commandId: CommandId,
+    projectId: ProjectId,
+    title: TrimmedNonEmptyString,
+    workspaceRoot: TrimmedNonEmptyString,
+    createWorkspaceRootIfMissing: Schema.optional(Schema.Boolean),
+    defaultModelSelection: Schema.optional(Schema.NullOr(ModelSelection)),
+    scripts: Schema.optional(Schema.Array(ProjectScript)),
+  }),
+  Schema.Struct({
+    type: Schema.Literal("project.update"),
+    commandId: CommandId,
+    projectId: ProjectId,
+    title: Schema.optional(TrimmedNonEmptyString),
+    workspaceRoot: Schema.optional(TrimmedNonEmptyString),
+    defaultModelSelection: Schema.optional(Schema.NullOr(ModelSelection)),
+    scripts: Schema.optional(Schema.Array(ProjectScript)),
+  }),
+  Schema.Struct({
+    type: Schema.Literal("project.delete"),
+    commandId: CommandId,
+    projectId: ProjectId,
+    force: Schema.optional(Schema.Boolean),
+  }),
+]);
+export type ProjectMutation = typeof ProjectMutation.Type;
+
+export class ProjectMutationError extends Schema.TaggedErrorClass<ProjectMutationError>()(
+  "ProjectMutationError",
+  {
+    commandId: CommandId,
+    message: Schema.String,
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {}
+
 export const ProjectEntryKind = Schema.Literals(["file", "directory"]);
 export type ProjectEntryKind = typeof ProjectEntryKind.Type;
 
diff --git a/packages/contracts/src/provider.ts b/packages/contracts/src/provider.ts
index 42a943923037..fc01e9a5ff78 100644
--- a/packages/contracts/src/provider.ts
+++ b/packages/contracts/src/provider.ts
@@ -9,10 +9,12 @@ import {
   TurnId,
 } from "./baseSchemas.ts";
 import {
-  ChatAttachment,
-  ModelSelection,
   PROVIDER_SEND_TURN_MAX_ATTACHMENTS,
   PROVIDER_SEND_TURN_MAX_INPUT_CHARS,
+  ChatAttachment,
+} from "./chatAttachment.ts";
+import { ModelSelection } from "./modelSelection.ts";
+import {
   ProviderApprovalDecision,
   ProviderApprovalPolicy,
   ProviderInteractionMode,
@@ -20,7 +22,7 @@ import {
   ProviderSandboxMode,
   ProviderUserInputAnswers,
   RuntimeMode,
-} from "./orchestration.ts";
+} from "./providerPolicy.ts";
 import { ProviderInstanceId, ProviderDriverKind } from "./providerInstance.ts";
 
 const ProviderSessionStatus = Schema.Literals([
diff --git a/packages/contracts/src/providerPolicy.ts b/packages/contracts/src/providerPolicy.ts
new file mode 100644
index 000000000000..48b24b0a8cb3
--- /dev/null
+++ b/packages/contracts/src/providerPolicy.ts
@@ -0,0 +1,60 @@
+import * as Schema from "effect/Schema";
+
+import { TrimmedNonEmptyString } from "./baseSchemas.ts";
+
+export const ProviderApprovalPolicy = Schema.Literals([
+  "untrusted",
+  "on-failure",
+  "on-request",
+  "never",
+]);
+export type ProviderApprovalPolicy = typeof ProviderApprovalPolicy.Type;
+
+export const ProviderSandboxMode = Schema.Literals([
+  "read-only",
+  "workspace-write",
+  "danger-full-access",
+]);
+export type ProviderSandboxMode = typeof ProviderSandboxMode.Type;
+
+export const RuntimeMode = Schema.Literals([
+  "approval-required",
+  "auto-accept-edits",
+  "auto",
+  "full-access",
+]);
+export type RuntimeMode = typeof RuntimeMode.Type;
+export const DEFAULT_RUNTIME_MODE: RuntimeMode = "full-access";
+
+export const ProviderInteractionMode = Schema.Literals(["default", "plan"]);
+export type ProviderInteractionMode = typeof ProviderInteractionMode.Type;
+export const DEFAULT_PROVIDER_INTERACTION_MODE: ProviderInteractionMode = "default";
+
+export const ProviderRequestKind = Schema.Literals([
+  "command",
+  "file-read",
+  "file-change",
+  "mcp-elicitation",
+]);
+export type ProviderRequestKind = typeof ProviderRequestKind.Type;
+
+export const AssistantDeliveryMode = Schema.Literals(["buffered", "streaming"]);
+export type AssistantDeliveryMode = typeof AssistantDeliveryMode.Type;
+
+export const ProviderApprovalDecision = Schema.Literals([
+  "accept",
+  "acceptForSession",
+  "acceptAlways",
+  "decline",
+  "cancel",
+]);
+export type ProviderApprovalDecision = typeof ProviderApprovalDecision.Type;
+
+export const ProviderApprovalOption = Schema.Struct({
+  decision: ProviderApprovalDecision,
+  label: TrimmedNonEmptyString,
+});
+export type ProviderApprovalOption = typeof ProviderApprovalOption.Type;
+
+export const ProviderUserInputAnswers = Schema.Record(Schema.String, Schema.Unknown);
+export type ProviderUserInputAnswers = typeof ProviderUserInputAnswers.Type;
diff --git a/packages/contracts/src/providerRuntime.ts b/packages/contracts/src/providerRuntime.ts
index e813c6ce4a35..0dc06a5b21c6 100644
--- a/packages/contracts/src/providerRuntime.ts
+++ b/packages/contracts/src/providerRuntime.ts
@@ -14,7 +14,7 @@ import {
   TurnId,
 } from "./baseSchemas.ts";
 import { ProviderInstanceId, ProviderDriverKind } from "./providerInstance.ts";
-import { ProviderApprovalOption } from "./orchestration.ts";
+import { ProviderApprovalOption } from "./providerPolicy.ts";
 
 const TrimmedNonEmptyStringSchema = TrimmedNonEmptyString;
 const UnknownRecordSchema = Schema.Record(Schema.String, Schema.Unknown);
diff --git a/packages/contracts/src/rpc.test.ts b/packages/contracts/src/rpc.test.ts
index 6a9adebd85d6..3384f82df7cf 100644
--- a/packages/contracts/src/rpc.test.ts
+++ b/packages/contracts/src/rpc.test.ts
@@ -2,7 +2,8 @@ import { describe, expect, it } from "vite-plus/test";
 import * as Exit from "effect/Exit";
 import * as Schema from "effect/Schema";
 
-import { WsSubscribeServerConfigRpc } from "./rpc.ts";
+import { ORCHESTRATION_V2_WS_METHODS } from "./orchestrationV2.ts";
+import { WsRpcGroup, WsSubscribeServerConfigRpc } from "./rpc.ts";
 
 /**
  * The client always sends `environmentThemes`, including to servers built
@@ -29,3 +30,12 @@ describe("subscribeServerConfig payload compatibility", () => {
     expect(decoded).toEqual({});
   });
 });
+
+describe("WebSocket RPC contracts", () => {
+  it("exposes only the V2 orchestration transport surface", () => {
+    const methods = [...WsRpcGroup.requests.keys()];
+
+    expect(methods).toEqual(expect.arrayContaining(Object.values(ORCHESTRATION_V2_WS_METHODS)));
+    expect(methods.filter((method) => method.startsWith("orchestrationV1."))).toEqual([]);
+  });
+});
diff --git a/packages/contracts/src/rpc.ts b/packages/contracts/src/rpc.ts
index 7cd674485f94..536406dcd78d 100644
--- a/packages/contracts/src/rpc.ts
+++ b/packages/contracts/src/rpc.ts
@@ -27,6 +27,15 @@ import {
   AttachmentDeleteInput,
   AttachmentUploadSigningKeyError,
 } from "./assets.ts";
+import {
+  PersistChatAttachmentsError,
+  PersistChatAttachmentsInput,
+  PersistChatAttachmentsResult,
+} from "./chatAttachment.ts";
+import {
+  OrchestrationGetFullThreadDiffError,
+  OrchestrationGetTurnDiffError,
+} from "./checkpointDiff.ts";
 import {
   GitActionProgressEvent,
   VcsSwitchRefInput,
@@ -61,18 +70,9 @@ import {
 } from "./review.ts";
 import { KeybindingsConfigError } from "./keybindings.ts";
 import {
-  ClientOrchestrationCommand,
-  ORCHESTRATION_WS_METHODS,
-  OrchestrationDispatchCommandError,
-  OrchestrationGetFullThreadDiffError,
-  OrchestrationGetFullThreadDiffInput,
-  OrchestrationGetSnapshotError,
   OrchestrationSearchThreadsError,
   OrchestrationSearchThreadsInput,
-  OrchestrationGetTurnDiffError,
-  OrchestrationGetTurnDiffInput,
-  OrchestrationRpcSchemas,
-  OrchestrationGetWorkflowScriptError,
+  OrchestrationSearchThreadsResult,
 } from "./orchestration.ts";
 import {
   ProviderUploadFeedbackError,
@@ -111,6 +111,15 @@ import {
   RelayClientInstallProgressEventSchema,
   RelayClientStatusSchema,
 } from "./relayClient.ts";
+import {
+  ORCHESTRATION_V2_WS_METHODS,
+  OrchestrationGetWorkflowScriptError,
+  OrchestrationV2DispatchCommandError,
+  OrchestrationV2GetShellSnapshotError,
+  OrchestrationV2GetThreadProjectionError,
+  OrchestrationV2RpcSchemas,
+  OrchestrationV2ThreadLaunchError,
+} from "./orchestrationV2.ts";
 import {
   ProjectListEntriesError,
   ProjectListEntriesInput,
@@ -194,6 +203,18 @@ import {
 } from "./resourceTelemetry.ts";
 import { UsageReadError, UsageSummary, UsageSummaryInput } from "./usage.ts";
 import { ServerSettings, ServerSettingsError, ServerSettingsPatch } from "./settings.ts";
+import {
+  ScheduledTaskDeleteInput,
+  ScheduledTaskDeleteResult,
+  ScheduledTaskError,
+  ScheduledTaskListInput,
+  ScheduledTaskListResult,
+  ScheduledTaskRunNowInput,
+  ScheduledTaskRunNowResult,
+  ScheduledTaskSetEnabledInput,
+  ScheduledTaskUpsertInput,
+  ScheduledTaskMutationResult,
+} from "./scheduledTask.ts";
 import {
   SourceControlCloneRepositoryInput,
   SourceControlCloneRepositoryResult,
@@ -205,6 +226,7 @@ import {
   SourceControlRepositoryLookupInput,
 } from "./sourceControl.ts";
 import { VcsError } from "./vcs.ts";
+import { Project, ProjectMutation, ProjectMutationError } from "./project.ts";
 
 export const WS_METHODS = {
   // Project registry methods
@@ -216,6 +238,7 @@ export const WS_METHODS = {
   projectsSearchContents: "projects.searchContents",
   projectsSearchEntries: "projects.searchEntries",
   projectsWriteFile: "projects.writeFile",
+  projectsMutate: "projects.mutate",
 
   // Shell methods
   shellOpenInEditor: "shell.openInEditor",
@@ -223,6 +246,7 @@ export const WS_METHODS = {
   // Filesystem methods
   filesystemBrowse: "filesystem.browse",
   assetsCreateUrl: "assets.createUrl",
+  assetsPersistChatAttachments: "assets.persistChatAttachments",
   attachmentsCreateUploadUrl: "attachments.createUploadUrl",
   attachmentsDelete: "attachments.delete",
 
@@ -292,6 +316,14 @@ export const WS_METHODS = {
   serverGetBackgroundPolicy: "server.getBackgroundPolicy",
   serverGetUsageSummary: "server.getUsageSummary",
 
+  // Scheduled tasks
+  scheduledTasksList: "scheduledTasks.list",
+  scheduledTasksSubscribe: "scheduledTasks.subscribe",
+  scheduledTasksUpsert: "scheduledTasks.upsert",
+  scheduledTasksSetEnabled: "scheduledTasks.setEnabled",
+  scheduledTasksDelete: "scheduledTasks.delete",
+  scheduledTasksRunNow: "scheduledTasks.runNow",
+
   // Cloud environment methods
   cloudGetRelayClientStatus: "cloud.getRelayClientStatus",
   cloudInstallRelayClient: "cloud.installRelayClient",
@@ -666,6 +698,12 @@ export const WsProjectsWriteFileRpc = Rpc.make(WS_METHODS.projectsWriteFile, {
   error: Schema.Union([ProjectWriteFileError, EnvironmentAuthorizationError]),
 });
 
+export const WsProjectsMutateRpc = Rpc.make(WS_METHODS.projectsMutate, {
+  payload: ProjectMutation,
+  success: Project,
+  error: Schema.Union([ProjectMutationError, EnvironmentAuthorizationError]),
+});
+
 export const WsShellOpenInEditorRpc = Rpc.make(WS_METHODS.shellOpenInEditor, {
   payload: LaunchEditorInput,
   error: Schema.Union([ExternalLauncherError, EnvironmentAuthorizationError]),
@@ -683,6 +721,12 @@ export const WsAssetsCreateUrlRpc = Rpc.make(WS_METHODS.assetsCreateUrl, {
   error: Schema.Union([AssetAccessError, EnvironmentAuthorizationError]),
 });
 
+export const WsAssetsPersistChatAttachmentsRpc = Rpc.make(WS_METHODS.assetsPersistChatAttachments, {
+  payload: PersistChatAttachmentsInput,
+  success: PersistChatAttachmentsResult,
+  error: Schema.Union([PersistChatAttachmentsError, EnvironmentAuthorizationError]),
+});
+
 export const WsAttachmentsCreateUploadUrlRpc = Rpc.make(WS_METHODS.attachmentsCreateUploadUrl, {
   payload: AttachmentCreateUploadUrlInput,
   success: AttachmentCreateUploadUrlResult,
@@ -903,67 +947,98 @@ export const WsSubscribeDiscoveredLocalServersRpc = Rpc.make(
   },
 );
 
-export const WsOrchestrationDispatchCommandRpc = Rpc.make(
-  ORCHESTRATION_WS_METHODS.dispatchCommand,
+export const WsOrchestrationV2DispatchCommandRpc = Rpc.make(
+  ORCHESTRATION_V2_WS_METHODS.dispatchCommand,
   {
-    payload: ClientOrchestrationCommand,
-    success: OrchestrationRpcSchemas.dispatchCommand.output,
-    error: Schema.Union([OrchestrationDispatchCommandError, EnvironmentAuthorizationError]),
+    payload: OrchestrationV2RpcSchemas.dispatchCommand.input,
+    success: OrchestrationV2RpcSchemas.dispatchCommand.output,
+    error: Schema.Union([OrchestrationV2DispatchCommandError, EnvironmentAuthorizationError]),
   },
 );
 
-export const WsOrchestrationGetWorkflowScriptRpc = Rpc.make(
-  ORCHESTRATION_WS_METHODS.getWorkflowScript,
+export const WsOrchestrationV2GetTurnDiffRpc = Rpc.make(ORCHESTRATION_V2_WS_METHODS.getTurnDiff, {
+  payload: OrchestrationV2RpcSchemas.getTurnDiff.input,
+  success: OrchestrationV2RpcSchemas.getTurnDiff.output,
+  error: Schema.Union([OrchestrationGetTurnDiffError, EnvironmentAuthorizationError]),
+});
+
+export const WsOrchestrationV2GetFullThreadDiffRpc = Rpc.make(
+  ORCHESTRATION_V2_WS_METHODS.getFullThreadDiff,
   {
-    payload: OrchestrationRpcSchemas.getWorkflowScript.input,
-    success: OrchestrationRpcSchemas.getWorkflowScript.output,
-    error: Schema.Union([OrchestrationGetWorkflowScriptError, EnvironmentAuthorizationError]),
+    payload: OrchestrationV2RpcSchemas.getFullThreadDiff.input,
+    success: OrchestrationV2RpcSchemas.getFullThreadDiff.output,
+    error: Schema.Union([OrchestrationGetFullThreadDiffError, EnvironmentAuthorizationError]),
   },
 );
 
-export const WsOrchestrationGetTurnDiffRpc = Rpc.make(ORCHESTRATION_WS_METHODS.getTurnDiff, {
-  payload: OrchestrationGetTurnDiffInput,
-  success: OrchestrationRpcSchemas.getTurnDiff.output,
-  error: Schema.Union([OrchestrationGetTurnDiffError, EnvironmentAuthorizationError]),
-});
+export const WsOrchestrationV2SearchThreadsRpc = Rpc.make(
+  ORCHESTRATION_V2_WS_METHODS.searchThreads,
+  {
+    payload: OrchestrationSearchThreadsInput,
+    success: OrchestrationSearchThreadsResult,
+    error: Schema.Union([OrchestrationSearchThreadsError, EnvironmentAuthorizationError]),
+  },
+);
 
-export const WsOrchestrationGetFullThreadDiffRpc = Rpc.make(
-  ORCHESTRATION_WS_METHODS.getFullThreadDiff,
+export const WsOrchestrationV2GetArchivedShellSnapshotRpc = Rpc.make(
+  ORCHESTRATION_V2_WS_METHODS.getArchivedShellSnapshot,
   {
-    payload: OrchestrationGetFullThreadDiffInput,
-    success: OrchestrationRpcSchemas.getFullThreadDiff.output,
-    error: Schema.Union([OrchestrationGetFullThreadDiffError, EnvironmentAuthorizationError]),
+    payload: OrchestrationV2RpcSchemas.getArchivedShellSnapshot.input,
+    success: OrchestrationV2RpcSchemas.getArchivedShellSnapshot.output,
+    error: Schema.Union([OrchestrationV2GetShellSnapshotError, EnvironmentAuthorizationError]),
   },
 );
 
-export const WsOrchestrationSearchThreadsRpc = Rpc.make(ORCHESTRATION_WS_METHODS.searchThreads, {
-  payload: OrchestrationSearchThreadsInput,
-  success: OrchestrationRpcSchemas.searchThreads.output,
-  error: Schema.Union([OrchestrationSearchThreadsError, EnvironmentAuthorizationError]),
-});
+export const WsOrchestrationV2GetThreadProjectionRpc = Rpc.make(
+  ORCHESTRATION_V2_WS_METHODS.getThreadProjection,
+  {
+    payload: OrchestrationV2RpcSchemas.getThreadProjection.input,
+    success: OrchestrationV2RpcSchemas.getThreadProjection.output,
+    error: Schema.Union([OrchestrationV2GetThreadProjectionError, EnvironmentAuthorizationError]),
+  },
+);
 
-export const WsOrchestrationGetArchivedShellSnapshotRpc = Rpc.make(
-  ORCHESTRATION_WS_METHODS.getArchivedShellSnapshot,
+export const WsOrchestrationV2GetWorkflowScriptRpc = Rpc.make(
+  ORCHESTRATION_V2_WS_METHODS.getWorkflowScript,
   {
-    payload: OrchestrationRpcSchemas.getArchivedShellSnapshot.input,
-    success: OrchestrationRpcSchemas.getArchivedShellSnapshot.output,
-    error: Schema.Union([OrchestrationGetSnapshotError, EnvironmentAuthorizationError]),
+    payload: OrchestrationV2RpcSchemas.getWorkflowScript.input,
+    success: OrchestrationV2RpcSchemas.getWorkflowScript.output,
+    error: Schema.Union([OrchestrationGetWorkflowScriptError, EnvironmentAuthorizationError]),
   },
 );
 
-export const WsOrchestrationSubscribeShellRpc = Rpc.make(ORCHESTRATION_WS_METHODS.subscribeShell, {
-  payload: OrchestrationRpcSchemas.subscribeShell.input,
-  success: OrchestrationRpcSchemas.subscribeShell.output,
-  error: Schema.Union([OrchestrationGetSnapshotError, EnvironmentAuthorizationError]),
-  stream: true,
+export const WsOrchestrationV2LaunchThreadRpc = Rpc.make(ORCHESTRATION_V2_WS_METHODS.launchThread, {
+  payload: OrchestrationV2RpcSchemas.launchThread.input,
+  success: OrchestrationV2RpcSchemas.launchThread.output,
+  error: Schema.Union([OrchestrationV2ThreadLaunchError, EnvironmentAuthorizationError]),
 });
 
-export const WsOrchestrationSubscribeThreadRpc = Rpc.make(
-  ORCHESTRATION_WS_METHODS.subscribeThread,
+export const WsOrchestrationV2SubscribeArchivedShellRpc = Rpc.make(
+  ORCHESTRATION_V2_WS_METHODS.subscribeArchivedShell,
+  {
+    payload: OrchestrationV2RpcSchemas.subscribeArchivedShell.input,
+    success: OrchestrationV2RpcSchemas.subscribeArchivedShell.output,
+    error: Schema.Union([OrchestrationV2GetShellSnapshotError, EnvironmentAuthorizationError]),
+    stream: true,
+  },
+);
+
+export const WsOrchestrationV2SubscribeShellRpc = Rpc.make(
+  ORCHESTRATION_V2_WS_METHODS.subscribeShell,
+  {
+    payload: OrchestrationV2RpcSchemas.subscribeShell.input,
+    success: OrchestrationV2RpcSchemas.subscribeShell.output,
+    error: Schema.Union([OrchestrationV2GetShellSnapshotError, EnvironmentAuthorizationError]),
+    stream: true,
+  },
+);
+
+export const WsOrchestrationV2SubscribeThreadRpc = Rpc.make(
+  ORCHESTRATION_V2_WS_METHODS.subscribeThread,
   {
-    payload: OrchestrationRpcSchemas.subscribeThread.input,
-    success: OrchestrationRpcSchemas.subscribeThread.output,
-    error: Schema.Union([OrchestrationGetSnapshotError, EnvironmentAuthorizationError]),
+    payload: OrchestrationV2RpcSchemas.subscribeThread.input,
+    success: OrchestrationV2RpcSchemas.subscribeThread.output,
+    error: Schema.Union([OrchestrationV2GetThreadProjectionError, EnvironmentAuthorizationError]),
     stream: true,
   },
 );
@@ -1005,6 +1080,44 @@ export const WsSubscribeServerLifecycleRpc = Rpc.make(WS_METHODS.subscribeServer
   stream: true,
 });
 
+export const WsScheduledTasksListRpc = Rpc.make(WS_METHODS.scheduledTasksList, {
+  payload: ScheduledTaskListInput,
+  success: ScheduledTaskListResult,
+  error: Schema.Union([ScheduledTaskError, EnvironmentAuthorizationError]),
+});
+
+/** Streams the full scheduled-task list: one snapshot on subscribe, then a fresh list after every change. */
+export const WsScheduledTasksSubscribeRpc = Rpc.make(WS_METHODS.scheduledTasksSubscribe, {
+  payload: ScheduledTaskListInput,
+  success: ScheduledTaskListResult,
+  error: Schema.Union([ScheduledTaskError, EnvironmentAuthorizationError]),
+  stream: true,
+});
+
+export const WsScheduledTasksUpsertRpc = Rpc.make(WS_METHODS.scheduledTasksUpsert, {
+  payload: ScheduledTaskUpsertInput,
+  success: ScheduledTaskMutationResult,
+  error: Schema.Union([ScheduledTaskError, EnvironmentAuthorizationError]),
+});
+
+export const WsScheduledTasksSetEnabledRpc = Rpc.make(WS_METHODS.scheduledTasksSetEnabled, {
+  payload: ScheduledTaskSetEnabledInput,
+  success: ScheduledTaskMutationResult,
+  error: Schema.Union([ScheduledTaskError, EnvironmentAuthorizationError]),
+});
+
+export const WsScheduledTasksDeleteRpc = Rpc.make(WS_METHODS.scheduledTasksDelete, {
+  payload: ScheduledTaskDeleteInput,
+  success: ScheduledTaskDeleteResult,
+  error: Schema.Union([ScheduledTaskError, EnvironmentAuthorizationError]),
+});
+
+export const WsScheduledTasksRunNowRpc = Rpc.make(WS_METHODS.scheduledTasksRunNow, {
+  payload: ScheduledTaskRunNowInput,
+  success: ScheduledTaskRunNowResult,
+  error: Schema.Union([ScheduledTaskError, EnvironmentAuthorizationError]),
+});
+
 export const WsSubscribeAuthAccessRpc = Rpc.make(WS_METHODS.subscribeAuthAccess, {
   payload: Schema.Struct({}),
   success: AuthAccessStreamEvent,
@@ -1045,6 +1158,12 @@ export const WsRpcGroup = RpcGroup.make(
   WsServerRetryResourceTelemetryRpc,
   WsServerGetUsageSummaryRpc,
   WsServerSignalProcessRpc,
+  WsScheduledTasksListRpc,
+  WsScheduledTasksSubscribeRpc,
+  WsScheduledTasksUpsertRpc,
+  WsScheduledTasksSetEnabledRpc,
+  WsScheduledTasksDeleteRpc,
+  WsScheduledTasksRunNowRpc,
   WsServerReportClientActivityRpc,
   WsServerReportHostPowerStateRpc,
   WsServerGetBackgroundPolicyRpc,
@@ -1075,9 +1194,11 @@ export const WsRpcGroup = RpcGroup.make(
   WsProjectsSearchContentsRpc,
   WsProjectsSearchEntriesRpc,
   WsProjectsWriteFileRpc,
+  WsProjectsMutateRpc,
   WsShellOpenInEditorRpc,
   WsFilesystemBrowseRpc,
   WsAssetsCreateUrlRpc,
+  WsAssetsPersistChatAttachmentsRpc,
   WsAttachmentsCreateUploadUrlRpc,
   WsAttachmentsDeleteRpc,
   WsProviderUploadFeedbackRpc,
@@ -1121,12 +1242,15 @@ export const WsRpcGroup = RpcGroup.make(
   WsSubscribeAuthAccessRpc,
   WsSubscribeBackgroundPolicyRpc,
   WsSubscribeResourceTelemetryRpc,
-  WsOrchestrationDispatchCommandRpc,
-  WsOrchestrationGetWorkflowScriptRpc,
-  WsOrchestrationGetTurnDiffRpc,
-  WsOrchestrationGetFullThreadDiffRpc,
-  WsOrchestrationSearchThreadsRpc,
-  WsOrchestrationGetArchivedShellSnapshotRpc,
-  WsOrchestrationSubscribeShellRpc,
-  WsOrchestrationSubscribeThreadRpc,
+  WsOrchestrationV2DispatchCommandRpc,
+  WsOrchestrationV2GetWorkflowScriptRpc,
+  WsOrchestrationV2GetTurnDiffRpc,
+  WsOrchestrationV2GetFullThreadDiffRpc,
+  WsOrchestrationV2SearchThreadsRpc,
+  WsOrchestrationV2GetArchivedShellSnapshotRpc,
+  WsOrchestrationV2GetThreadProjectionRpc,
+  WsOrchestrationV2LaunchThreadRpc,
+  WsOrchestrationV2SubscribeArchivedShellRpc,
+  WsOrchestrationV2SubscribeShellRpc,
+  WsOrchestrationV2SubscribeThreadRpc,
 );
diff --git a/packages/contracts/src/scheduledTask.test.ts b/packages/contracts/src/scheduledTask.test.ts
new file mode 100644
index 000000000000..c3373d08abf4
--- /dev/null
+++ b/packages/contracts/src/scheduledTask.test.ts
@@ -0,0 +1,52 @@
+import { describe, expect, it } from "vite-plus/test";
+import * as Schema from "effect/Schema";
+
+import {
+  MIN_SCHEDULED_TASK_INTERVAL_MS,
+  ScheduledTaskSchedule,
+  ScheduledTaskUpsertSchedule,
+} from "./scheduledTask.ts";
+
+const decodeSchedule = Schema.decodeUnknownSync(ScheduledTaskSchedule);
+const decodeUpsertSchedule = Schema.decodeUnknownSync(ScheduledTaskUpsertSchedule);
+
+describe("ScheduledTaskSchedule", () => {
+  it("keeps legacy sub-minute persisted schedules readable", () => {
+    expect(
+      decodeSchedule({
+        type: "interval",
+        everyMs: MIN_SCHEDULED_TASK_INTERVAL_MS - 1,
+      }),
+    ).toEqual({
+      type: "interval",
+      everyMs: MIN_SCHEDULED_TASK_INTERVAL_MS - 1,
+    });
+  });
+
+  it("still rejects corrupt non-positive persisted intervals", () => {
+    expect(() => decodeSchedule({ type: "interval", everyMs: 0 })).toThrow();
+  });
+});
+
+describe("ScheduledTaskUpsertSchedule", () => {
+  it("accepts interval schedules at the one-minute minimum", () => {
+    expect(
+      decodeUpsertSchedule({
+        type: "interval",
+        everyMs: MIN_SCHEDULED_TASK_INTERVAL_MS,
+      }),
+    ).toEqual({
+      type: "interval",
+      everyMs: MIN_SCHEDULED_TASK_INTERVAL_MS,
+    });
+  });
+
+  it("rejects interval schedules more frequent than once per minute", () => {
+    expect(() =>
+      decodeUpsertSchedule({
+        type: "interval",
+        everyMs: MIN_SCHEDULED_TASK_INTERVAL_MS - 1,
+      }),
+    ).toThrow();
+  });
+});
diff --git a/packages/contracts/src/scheduledTask.ts b/packages/contracts/src/scheduledTask.ts
new file mode 100644
index 000000000000..51ea066a3989
--- /dev/null
+++ b/packages/contracts/src/scheduledTask.ts
@@ -0,0 +1,182 @@
+import * as Schema from "effect/Schema";
+
+import {
+  CommandId,
+  IsoDateTime,
+  ProjectId,
+  ScheduledTaskId,
+  ThreadId,
+  TrimmedNonEmptyString,
+} from "./baseSchemas.ts";
+import { ModelSelection } from "./modelSelection.ts";
+import {
+  OrchestrationV2Actor,
+  OrchestrationV2CreationSource,
+  OrchestrationV2ThreadLaunchWorkspaceStrategy,
+} from "./orchestrationV2.ts";
+import { ProviderInteractionMode, RuntimeMode } from "./providerPolicy.ts";
+
+/** 24-hour "HH:MM" wall-clock time. Mirrors `parseTimeOfDay` on the server. */
+const TimeOfDay = TrimmedNonEmptyString.check(
+  Schema.isPattern(/^([01]?\d|2[0-3]):([0-5]\d)$/),
+).annotate({ description: "Local wall-clock time in 24-hour HH:MM form, such as 09:30." });
+
+export const MIN_SCHEDULED_TASK_INTERVAL_MS = 60_000;
+
+const ScheduledTaskIntervalMs = Schema.Int.check(Schema.isGreaterThan(0)).annotate({
+  description: "Positive interval in milliseconds.",
+});
+
+const ScheduledTaskIntervalSchedule = Schema.Struct({
+  type: Schema.Literal("interval").annotate({
+    description: "Select interval scheduling.",
+  }),
+  everyMs: ScheduledTaskIntervalMs,
+}).annotate({
+  description: "Run repeatedly after a fixed number of milliseconds.",
+});
+
+const ScheduledTaskFixedTimeSchedule = Schema.Struct({
+  type: Schema.Literal("fixed_time").annotate({
+    description: "Select a fixed local wall-clock time.",
+  }),
+  timeOfDay: TimeOfDay,
+  weekdays: Schema.optional(
+    Schema.Array(
+      Schema.Int.check(Schema.isBetween({ minimum: 0, maximum: 6 })).annotate({
+        description: "Weekday number where 0 is Sunday and 6 is Saturday.",
+      }),
+    ).annotate({
+      description: "Optional weekdays; omit to run every day.",
+    }),
+  ),
+}).annotate({
+  description: "Run at a fixed local wall-clock time on selected weekdays.",
+});
+
+/**
+ * Read model for persisted schedules. Keep accepting legacy sub-minute rows so
+ * users can list, disable, edit, or delete them after the write minimum changes.
+ */
+export const ScheduledTaskSchedule = Schema.Union([
+  ScheduledTaskIntervalSchedule,
+  ScheduledTaskFixedTimeSchedule,
+]).annotate({
+  description:
+    "Structured recurring schedule. Pass an object with type 'interval' or 'fixed_time'.",
+});
+export type ScheduledTaskSchedule = typeof ScheduledTaskSchedule.Type;
+
+/** Mutation model: newly created or updated interval schedules run at most once per minute. */
+export const ScheduledTaskUpsertSchedule = Schema.Union([
+  Schema.Struct({
+    type: Schema.Literal("interval").annotate({
+      description: "Select interval scheduling.",
+    }),
+    everyMs: ScheduledTaskIntervalMs.check(
+      Schema.isGreaterThanOrEqualTo(MIN_SCHEDULED_TASK_INTERVAL_MS),
+    ).annotate({
+      description: "Interval in milliseconds, with a minimum of 60000 (one minute).",
+    }),
+  }).annotate({
+    description: "Run repeatedly after a fixed number of milliseconds.",
+  }),
+  ScheduledTaskFixedTimeSchedule,
+]).annotate({
+  description: "Writable recurring schedule. Pass an object with type 'interval' or 'fixed_time'.",
+});
+export type ScheduledTaskUpsertSchedule = typeof ScheduledTaskUpsertSchedule.Type;
+
+export const ScheduledTaskRunStatus = Schema.Literals(["never", "running", "succeeded", "failed"]);
+export type ScheduledTaskRunStatus = typeof ScheduledTaskRunStatus.Type;
+
+export const ScheduledTask = Schema.Struct({
+  id: ScheduledTaskId,
+  title: TrimmedNonEmptyString,
+  prompt: TrimmedNonEmptyString,
+  enabled: Schema.Boolean,
+  schedule: ScheduledTaskSchedule,
+  projectId: ProjectId,
+  threadId: Schema.NullOr(ThreadId),
+  workspaceStrategy: OrchestrationV2ThreadLaunchWorkspaceStrategy,
+  modelSelection: ModelSelection,
+  runtimeMode: RuntimeMode,
+  interactionMode: ProviderInteractionMode,
+  createdBy: OrchestrationV2Actor,
+  creationSource: OrchestrationV2CreationSource,
+  createdAt: IsoDateTime,
+  updatedAt: IsoDateTime,
+  nextRunAt: Schema.NullOr(IsoDateTime),
+  lastRunAt: Schema.NullOr(IsoDateTime),
+  lastRunStatus: ScheduledTaskRunStatus,
+  lastRunError: Schema.NullOr(Schema.String),
+  runCount: Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)),
+});
+export type ScheduledTask = typeof ScheduledTask.Type;
+
+export const ScheduledTaskListInput = Schema.Struct({});
+export type ScheduledTaskListInput = typeof ScheduledTaskListInput.Type;
+
+export const ScheduledTaskListResult = Schema.Struct({
+  tasks: Schema.Array(ScheduledTask),
+});
+export type ScheduledTaskListResult = typeof ScheduledTaskListResult.Type;
+
+export const ScheduledTaskUpsertInput = Schema.Struct({
+  id: Schema.optional(ScheduledTaskId),
+  commandId: Schema.optional(CommandId),
+  title: TrimmedNonEmptyString,
+  prompt: TrimmedNonEmptyString,
+  enabled: Schema.Boolean,
+  schedule: ScheduledTaskUpsertSchedule,
+  projectId: ProjectId,
+  threadId: Schema.optional(Schema.NullOr(ThreadId)),
+  workspaceStrategy: OrchestrationV2ThreadLaunchWorkspaceStrategy,
+  modelSelection: ModelSelection,
+  runtimeMode: RuntimeMode,
+  interactionMode: ProviderInteractionMode,
+  createdBy: Schema.optional(OrchestrationV2Actor),
+  creationSource: Schema.optional(OrchestrationV2CreationSource),
+});
+export type ScheduledTaskUpsertInput = typeof ScheduledTaskUpsertInput.Type;
+
+/** Partial update that flips only the enabled flag — never overwrites other fields. */
+export const ScheduledTaskSetEnabledInput = Schema.Struct({
+  id: ScheduledTaskId,
+  enabled: Schema.Boolean,
+});
+export type ScheduledTaskSetEnabledInput = typeof ScheduledTaskSetEnabledInput.Type;
+
+export const ScheduledTaskDeleteInput = Schema.Struct({
+  id: ScheduledTaskId,
+});
+export type ScheduledTaskDeleteInput = typeof ScheduledTaskDeleteInput.Type;
+
+export const ScheduledTaskRunNowInput = Schema.Struct({
+  id: ScheduledTaskId,
+});
+export type ScheduledTaskRunNowInput = typeof ScheduledTaskRunNowInput.Type;
+
+export const ScheduledTaskMutationResult = Schema.Struct({
+  task: ScheduledTask,
+});
+export type ScheduledTaskMutationResult = typeof ScheduledTaskMutationResult.Type;
+
+export const ScheduledTaskDeleteResult = Schema.Struct({
+  id: ScheduledTaskId,
+});
+export type ScheduledTaskDeleteResult = typeof ScheduledTaskDeleteResult.Type;
+
+export const ScheduledTaskRunNowResult = Schema.Struct({
+  task: ScheduledTask,
+});
+export type ScheduledTaskRunNowResult = typeof ScheduledTaskRunNowResult.Type;
+
+export class ScheduledTaskError extends Schema.TaggedErrorClass<ScheduledTaskError>()(
+  "ScheduledTaskError",
+  {
+    message: Schema.String,
+    taskId: Schema.optional(ScheduledTaskId),
+    cause: Schema.optional(Schema.Defect()),
+  },
+) {}
diff --git a/packages/contracts/src/server.ts b/packages/contracts/src/server.ts
index c3f61536fadd..5f2360761d56 100644
--- a/packages/contracts/src/server.ts
+++ b/packages/contracts/src/server.ts
@@ -681,6 +681,13 @@ export const ServerLifecycleWelcomePayload = Schema.Struct({
 });
 export type ServerLifecycleWelcomePayload = typeof ServerLifecycleWelcomePayload.Type;
 
+export const ServerLifecycleLegacyThreadMigrationPayload = Schema.Struct({
+  status: Schema.Union([Schema.Literal("running"), Schema.Literal("complete")]),
+  totalThreadCount: NonNegativeInt,
+});
+export type ServerLifecycleLegacyThreadMigrationPayload =
+  typeof ServerLifecycleLegacyThreadMigrationPayload.Type;
+
 export const ServerLifecycleStreamWelcomeEvent = Schema.Struct({
   version: Schema.Literal(1),
   sequence: NonNegativeInt,
@@ -697,9 +704,19 @@ export const ServerLifecycleStreamReadyEvent = Schema.Struct({
 });
 export type ServerLifecycleStreamReadyEvent = typeof ServerLifecycleStreamReadyEvent.Type;
 
+export const ServerLifecycleStreamLegacyThreadMigrationEvent = Schema.Struct({
+  version: Schema.Literal(1),
+  sequence: NonNegativeInt,
+  type: Schema.Literal("legacyThreadMigration"),
+  payload: ServerLifecycleLegacyThreadMigrationPayload,
+});
+export type ServerLifecycleStreamLegacyThreadMigrationEvent =
+  typeof ServerLifecycleStreamLegacyThreadMigrationEvent.Type;
+
 export const ServerLifecycleStreamEvent = Schema.Union([
   ServerLifecycleStreamWelcomeEvent,
   ServerLifecycleStreamReadyEvent,
+  ServerLifecycleStreamLegacyThreadMigrationEvent,
 ]);
 export type ServerLifecycleStreamEvent = typeof ServerLifecycleStreamEvent.Type;
 
diff --git a/packages/contracts/src/settings.test.ts b/packages/contracts/src/settings.test.ts
index 32851e735a34..8d9fa30ec2d0 100644
--- a/packages/contracts/src/settings.test.ts
+++ b/packages/contracts/src/settings.test.ts
@@ -49,6 +49,15 @@ describe("ClaudeSettings auto-compaction", () => {
   });
 });
 
+describe("ClientSettings composer context strip", () => {
+  it("defaults to draft-only and accepts a persistent strip preference", () => {
+    expect(decodeClientSettings({}).persistComposerContextStrip).toBe(false);
+    expect(
+      decodeClientSettingsPatch({ persistComposerContextStrip: true }).persistComposerContextStrip,
+    ).toBe(true);
+  });
+});
+
 describe("ClientSettings word wrap", () => {
   it("defaults word wrap on", () => {
     expect(decodeClientSettings({}).wordWrap).toBe(true);
@@ -299,6 +308,40 @@ describe("ServerSettings worktree defaults", () => {
   });
 });
 
+describe("ServerSettings Cursor legacy settings", () => {
+  it("ignores obsolete Cursor CLI settings when reading server settings", () => {
+    const decoded = decodeServerSettings({
+      providers: {
+        cursor: {
+          enabled: true,
+          binaryPath: "cursor-agent",
+          apiEndpoint: "http://127.0.0.1:3774",
+        },
+      },
+    });
+
+    expect(decoded.providers.cursor.enabled).toBe(true);
+    expect(decoded.providers.cursor).not.toHaveProperty("binaryPath");
+    expect(decoded.providers.cursor).not.toHaveProperty("apiEndpoint");
+  });
+
+  it("ignores obsolete Cursor CLI settings in patches", () => {
+    const patch = decodeServerSettingsPatch({
+      providers: {
+        cursor: {
+          enabled: true,
+          binaryPath: "cursor-agent",
+          apiEndpoint: "http://127.0.0.1:3774",
+        },
+      },
+    });
+
+    expect(patch.providers?.cursor?.enabled).toBe(true);
+    expect(patch.providers?.cursor).not.toHaveProperty("binaryPath");
+    expect(patch.providers?.cursor).not.toHaveProperty("apiEndpoint");
+  });
+});
+
 describe("ServerSettings.sourceControlWritingStyle", () => {
   it("defaults all style settings for legacy configs", () => {
     const settings = decodeServerSettings({});
diff --git a/packages/contracts/src/settings.ts b/packages/contracts/src/settings.ts
index b6b09574bfe7..6fd2215bc300 100644
--- a/packages/contracts/src/settings.ts
+++ b/packages/contracts/src/settings.ts
@@ -9,7 +9,7 @@ import {
   DEFAULT_TEXT_GENERATION_REASONING_EFFORT,
   ProviderOptionSelections,
 } from "./model.ts";
-import { ModelSelection } from "./orchestration.ts";
+import { ModelSelection } from "./modelSelection.ts";
 import {
   DEFAULT_PREVIEW_APPEARANCE,
   DEFAULT_PREVIEW_ZOOM_FACTOR,
@@ -210,6 +210,9 @@ export const ClientSettingsSchema = Schema.Struct({
   // Grayscale `-webkit-font-smoothing: antialiased` (thinner strokes);
   // disabling restores the platform's heavier default. No effect off macOS.
   fontSmoothing: Schema.Boolean.pipe(Schema.withDecodingDefault(Effect.succeed(true))),
+  persistComposerContextStrip: Schema.Boolean.pipe(
+    Schema.withDecodingDefault(Effect.succeed(false)),
+  ),
   // Model favorites. Historically keyed by provider kind, now
   // widened to `ProviderInstanceId` so users can favorite a specific model
   // on a custom provider instance (e.g. "Codex Personal · gpt-5") without
@@ -457,31 +460,13 @@ export const CursorSettings = makeProviderSettingsSchema(
       Schema.withDecodingDefault(Effect.succeed(false)),
       Schema.annotateKey({ providerSettingsForm: { hidden: true } }),
     ),
-    binaryPath: makeBinaryPathSetting("cursor-agent").pipe(
-      Schema.annotateKey({
-        title: "Binary path",
-        description: "Path to the Cursor agent binary.",
-        providerSettingsForm: { placeholder: "cursor-agent", clearWhenEmpty: "omit" },
-      }),
-    ),
-    apiEndpoint: TrimmedString.pipe(
-      Schema.withDecodingDefault(Effect.succeed("")),
-      Schema.annotateKey({
-        title: "API endpoint",
-        description: "Override the Cursor API endpoint for this instance.",
-        providerSettingsForm: {
-          placeholder: "https://...",
-          clearWhenEmpty: "omit",
-        },
-      }),
-    ),
     customModels: Schema.Array(Schema.String).pipe(
       Schema.withDecodingDefault(Effect.succeed([])),
       Schema.annotateKey({ providerSettingsForm: { hidden: true } }),
     ),
   },
   {
-    order: ["binaryPath", "apiEndpoint"],
+    order: [],
   },
 );
 export type CursorSettings = typeof CursorSettings.Type;
@@ -512,6 +497,56 @@ export const GrokSettings = makeProviderSettingsSchema(
 );
 export type GrokSettings = typeof GrokSettings.Type;
 
+export const AcpRegistryDistributionPreference = Schema.Literals(["auto", "binary", "npx", "uvx"]);
+export type AcpRegistryDistributionPreference = typeof AcpRegistryDistributionPreference.Type;
+
+export const AcpRegistrySettings = makeProviderSettingsSchema(
+  {
+    enabled: Schema.Boolean.pipe(
+      Schema.withDecodingDefault(Effect.succeed(true)),
+      Schema.annotateKey({ providerSettingsForm: { hidden: true } }),
+    ),
+    agentId: TrimmedString.pipe(
+      Schema.withDecodingDefault(Effect.succeed("")),
+      Schema.annotateKey({
+        title: "Registry agent ID",
+        description: "Agent identifier from the official ACP Registry, for example 'devin'.",
+        providerSettingsForm: { placeholder: "devin", clearWhenEmpty: "persist" },
+      }),
+    ),
+    commandPath: TrimmedString.pipe(
+      Schema.withDecodingDefault(Effect.succeed("")),
+      Schema.annotateKey({
+        title: "Executable override",
+        description:
+          "Optional local executable to use instead of installing the registry distribution. Registry arguments and environment are still applied.",
+        providerSettingsForm: { placeholder: "devin", clearWhenEmpty: "omit" },
+      }),
+    ),
+    authMethodId: TrimmedString.pipe(
+      Schema.withDecodingDefault(Effect.succeed("")),
+      Schema.annotateKey({
+        title: "Authentication method",
+        description:
+          "Optional ACP authentication method ID. By default, the first agent-managed method is selected.",
+        providerSettingsForm: { placeholder: "auto", clearWhenEmpty: "omit" },
+      }),
+    ),
+    distribution: AcpRegistryDistributionPreference.pipe(
+      Schema.withDecodingDefault(Effect.succeed("auto")),
+      Schema.annotateKey({ providerSettingsForm: { hidden: true } }),
+    ),
+    customModels: Schema.Array(Schema.String).pipe(
+      Schema.withDecodingDefault(Effect.succeed([])),
+      Schema.annotateKey({ providerSettingsForm: { hidden: true } }),
+    ),
+  },
+  {
+    order: ["agentId", "commandPath", "authMethodId"],
+  },
+);
+export type AcpRegistrySettings = typeof AcpRegistrySettings.Type;
+
 export const OpenCodeSettings = makeProviderSettingsSchema(
   {
     // Off by default (like Cursor and Grok): the binding is not yet stable
@@ -851,8 +886,6 @@ const ClaudeSettingsPatch = Schema.Struct({
 
 const CursorSettingsPatch = Schema.Struct({
   enabled: Schema.optionalKey(Schema.Boolean),
-  binaryPath: Schema.optionalKey(TrimmedString),
-  apiEndpoint: Schema.optionalKey(TrimmedString),
   customModels: Schema.optionalKey(Schema.Array(Schema.String)),
 });
 
@@ -943,6 +976,7 @@ export const ClientSettingsPatch = Schema.Struct({
   fontFamilySans: Schema.optionalKey(FontFamilyPreference),
   fontFamilyTerminal: Schema.optionalKey(FontFamilyPreference),
   fontSmoothing: Schema.optionalKey(Schema.Boolean),
+  persistComposerContextStrip: Schema.optionalKey(Schema.Boolean),
   favorites: Schema.optionalKey(
     Schema.Array(
       Schema.Struct({
diff --git a/packages/contracts/src/t3ProjectFile.test.ts b/packages/contracts/src/t3ProjectFile.test.ts
index ed19c6d69887..3dff66feb9a8 100644
--- a/packages/contracts/src/t3ProjectFile.test.ts
+++ b/packages/contracts/src/t3ProjectFile.test.ts
@@ -1,9 +1,11 @@
 import * as Schema from "effect/Schema";
 import { describe, expect, it } from "vite-plus/test";
 
-import { T3ProjectFile } from "./t3ProjectFile.ts";
+import { T3ProjectFile, type T3ProjectFile as T3ProjectFileType } from "./t3ProjectFile.ts";
 
-const decode = Schema.decodeUnknownSync(T3ProjectFile);
+const decode = Schema.decodeUnknownSync(T3ProjectFile as never) as (
+  input: unknown,
+) => T3ProjectFileType;
 
 describe("T3ProjectFile", () => {
   it("decodes a full project file", () => {
diff --git a/packages/contracts/src/t3ProjectFile.ts b/packages/contracts/src/t3ProjectFile.ts
index 5062a1a370b5..caeab07aa2f8 100644
--- a/packages/contracts/src/t3ProjectFile.ts
+++ b/packages/contracts/src/t3ProjectFile.ts
@@ -2,7 +2,7 @@ import * as Schema from "effect/Schema";
 import * as SchemaTransformation from "effect/SchemaTransformation";
 
 import { ThreadEnvMode } from "./environment.ts";
-import { ProjectScriptIcon } from "./orchestration.ts";
+import { ProjectScriptIcon } from "./project.ts";
 
 /** File name of the checked-in T3 project file, resolved at the workspace root. */
 export const T3_PROJECT_FILE_NAME = "t3.json";
diff --git a/packages/contracts/src/worktreeMcp.ts b/packages/contracts/src/worktreeMcp.ts
new file mode 100644
index 000000000000..154839fae6bb
--- /dev/null
+++ b/packages/contracts/src/worktreeMcp.ts
@@ -0,0 +1,127 @@
+import * as Schema from "effect/Schema";
+
+import { TrimmedNonEmptyString } from "./baseSchemas.ts";
+
+/**
+ * Input for the `t3_worktree_handoff` MCP tool.
+ *
+ * Creates a git worktree for the calling agent thread and re-points the
+ * thread at it. Changing the thread's workspace detaches the live provider
+ * session, so the current turn ends shortly after the handoff is recorded;
+ * the conversation continues inside the worktree on the thread's next run.
+ */
+export const WorktreeMcpHandoffInput = Schema.Struct({
+  branch: TrimmedNonEmptyString.annotate({
+    description: "Branch name to create for the worktree (e.g. 'feature/my-change').",
+  }),
+  baseRef: Schema.optional(
+    TrimmedNonEmptyString.annotate({
+      description:
+        "Branch or ref the worktree branch starts from. Defaults to the branch currently checked out in the project workspace.",
+    }),
+  ),
+  startFromOrigin: Schema.optional(
+    Schema.Boolean.annotate({
+      description:
+        "Fetch origin and start the worktree branch from the remote-tracking commit of baseRef instead of the local ref. Defaults to the server's 'new worktrees start from origin' setting.",
+    }),
+  ),
+  path: Schema.optional(
+    TrimmedNonEmptyString.check(
+      // Absolute POSIX (/...), Windows drive (C:\ or C:/), or UNC (\\host).
+      Schema.isPattern(/^(?:[A-Za-z]:[\\/]|[\\/])/),
+    ).annotate({
+      description:
+        "Absolute filesystem path for the new worktree. Relative paths are rejected. Defaults to the server-managed worktrees directory.",
+    }),
+  ),
+  runSetupScript: Schema.optional(
+    Schema.Boolean.annotate({
+      description:
+        "Run the project's configured setup script in the new worktree after handoff. Defaults to true.",
+    }),
+  ),
+  continuationPrompt: Schema.optional(
+    TrimmedNonEmptyString.check(Schema.isMaxLength(120_000)).annotate({
+      description:
+        "Message queued as the thread's next turn after the handoff. The handoff detaches the current provider session, so pass the remaining work here to automatically resume inside the worktree; omit it to stop after the handoff and wait for the next message.",
+    }),
+  ),
+});
+export type WorktreeMcpHandoffInput = typeof WorktreeMcpHandoffInput.Type;
+
+export const WorktreeMcpSetupScriptStatus = Schema.Union([
+  Schema.Struct({
+    status: Schema.Literal("started"),
+    scriptName: TrimmedNonEmptyString,
+    terminalId: TrimmedNonEmptyString,
+  }),
+  Schema.Struct({
+    status: Schema.Literal("no-script"),
+  }),
+  Schema.Struct({
+    status: Schema.Literal("skipped"),
+  }),
+  Schema.Struct({
+    status: Schema.Literal("failed"),
+    detail: Schema.String,
+  }),
+]);
+export type WorktreeMcpSetupScriptStatus = typeof WorktreeMcpSetupScriptStatus.Type;
+
+export const WorktreeMcpContinuationStatus = Schema.Union([
+  Schema.Struct({
+    status: Schema.Literal("scheduled"),
+    delivery: Schema.Literals(["started", "queued", "steered", "restarted"]),
+  }),
+  Schema.Struct({
+    status: Schema.Literal("skipped"),
+  }),
+  Schema.Struct({
+    status: Schema.Literal("failed"),
+    detail: Schema.String,
+  }),
+]);
+export type WorktreeMcpContinuationStatus = typeof WorktreeMcpContinuationStatus.Type;
+
+export const WorktreeMcpHandoffResult = Schema.Struct({
+  worktreePath: TrimmedNonEmptyString,
+  branch: TrimmedNonEmptyString,
+  baseRef: TrimmedNonEmptyString,
+  startedFromOrigin: Schema.Boolean,
+  setupScript: WorktreeMcpSetupScriptStatus,
+  continuation: WorktreeMcpContinuationStatus,
+  note: Schema.String,
+});
+export type WorktreeMcpHandoffResult = typeof WorktreeMcpHandoffResult.Type;
+
+export const WorktreeMcpStatusResult = Schema.Struct({
+  attached: Schema.Boolean.annotate({
+    description: "True when this thread is already attached to a git worktree.",
+  }),
+  worktreePath: Schema.NullOr(TrimmedNonEmptyString),
+  branch: Schema.NullOr(TrimmedNonEmptyString),
+  projectWorkspaceRoot: TrimmedNonEmptyString.annotate({
+    description: "Root of the project's main workspace checkout.",
+  }),
+  defaultStartFromOrigin: Schema.Boolean.annotate({
+    description: "Server default used by t3_worktree_handoff when startFromOrigin is omitted.",
+  }),
+});
+export type WorktreeMcpStatusResult = typeof WorktreeMcpStatusResult.Type;
+
+export class WorktreeMcpFailure extends Schema.TaggedErrorClass<WorktreeMcpFailure>()(
+  "WorktreeMcpFailure",
+  {
+    code: Schema.Literals([
+      "capability_denied",
+      "thread_not_found",
+      "project_not_found",
+      "already_in_worktree",
+      "handoff_in_progress",
+      "invalid_request",
+      "operation_failed",
+    ]),
+    message: Schema.String,
+  },
+) {}
diff --git a/packages/effect-acp/src/client.ts b/packages/effect-acp/src/client.ts
index 165d834bb6a0..86570bb8757d 100644
--- a/packages/effect-acp/src/client.ts
+++ b/packages/effect-acp/src/client.ts
@@ -27,6 +27,10 @@ export interface AcpClientOptions {
   readonly logIncoming?: boolean;
   readonly logOutgoing?: boolean;
   readonly logger?: (event: AcpProtocol.AcpProtocolLogEvent) => Effect.Effect<void, never>;
+  readonly onIncomingRequest?: AcpProtocol.AcpPatchedProtocolOptions["onIncomingRequest"];
+  readonly onTermination?: AcpProtocol.AcpPatchedProtocolOptions["onTermination"];
+  readonly onOutgoingResponseFailure?: AcpProtocol.AcpPatchedProtocolOptions["onOutgoingResponseFailure"];
+  readonly onOutgoingResponse?: AcpProtocol.AcpPatchedProtocolOptions["onOutgoingResponse"];
 }
 
 type AcpClientRaw = {
@@ -404,6 +408,12 @@ export const make = Effect.fn("effect-acp/AcpClient.make")(function* (
     ...(options.logIncoming !== undefined ? { logIncoming: options.logIncoming } : {}),
     ...(options.logOutgoing !== undefined ? { logOutgoing: options.logOutgoing } : {}),
     ...(options.logger ? { logger: options.logger } : {}),
+    ...(options.onIncomingRequest ? { onIncomingRequest: options.onIncomingRequest } : {}),
+    ...(options.onTermination ? { onTermination: options.onTermination } : {}),
+    ...(options.onOutgoingResponseFailure
+      ? { onOutgoingResponseFailure: options.onOutgoingResponseFailure }
+      : {}),
+    ...(options.onOutgoingResponse ? { onOutgoingResponse: options.onOutgoingResponse } : {}),
     onNotification: dispatchNotification,
     onExtRequest: dispatchExtRequest,
   });
diff --git a/packages/effect-acp/src/protocol.test.ts b/packages/effect-acp/src/protocol.test.ts
index a66cc75225da..cc32877a77d8 100644
--- a/packages/effect-acp/src/protocol.test.ts
+++ b/packages/effect-acp/src/protocol.test.ts
@@ -3,8 +3,12 @@ import * as AcpError from "./errors.ts";
 import * as Effect from "effect/Effect";
 import * as Deferred from "effect/Deferred";
 import * as Fiber from "effect/Fiber";
+import * as Exit from "effect/Exit";
 import * as Queue from "effect/Queue";
 import * as Schema from "effect/Schema";
+import * as Scope from "effect/Scope";
+import * as Sink from "effect/Sink";
+import * as Stdio from "effect/Stdio";
 import * as Stream from "effect/Stream";
 import * as Ref from "effect/Ref";
 import { ChildProcess, ChildProcessSpawner } from "effect/unstable/process";
@@ -491,6 +495,232 @@ it.layer(NodeServices.layer)("effect-acp protocol", (it) => {
     }),
   );
 
+  it.effect("acknowledges outgoing responses and reports encoding failures by request id", () =>
+    Effect.gen(function* () {
+      const { stdio } = yield* makeInMemoryStdio();
+      const acknowledged = yield* Deferred.make<string>();
+      const failed = yield* Deferred.make<readonly [string, AcpError.AcpError]>();
+      const transport = yield* AcpProtocol.makeAcpPatchedProtocol({
+        stdio,
+        serverRequestMethods: new Set(),
+        onOutgoingResponse: (requestId) =>
+          Deferred.succeed(acknowledged, requestId).pipe(Effect.asVoid),
+        onOutgoingResponseFailure: (requestId, error) =>
+          Deferred.succeed(failed, [requestId, error]).pipe(Effect.asVoid),
+      });
+
+      yield* transport.serverProtocol.send(0, {
+        _tag: "Exit",
+        requestId: "success-1",
+        exit: { _tag: "Success", value: { ok: true } },
+      });
+      assert.equal(yield* Deferred.await(acknowledged), "success-1");
+
+      const circular: { self?: unknown } = {};
+      circular.self = circular;
+      yield* transport.serverProtocol
+        .send(0, {
+          _tag: "Exit",
+          requestId: "failure-1",
+          exit: { _tag: "Success", value: circular },
+        })
+        .pipe(Effect.exit);
+      const [requestId, error] = yield* Deferred.await(failed);
+      assert.equal(requestId, "failure-1");
+      assert.instanceOf(error, AcpError.AcpProtocolParseError);
+    }),
+  );
+
+  it.effect("acknowledges a response only after the stdout write completes", () =>
+    Effect.gen(function* () {
+      const writeStarted = yield* Deferred.make<void>();
+      const releaseWrite = yield* Deferred.make<void>();
+      const acknowledged = yield* Deferred.make<string>();
+      const stdio = Stdio.make({
+        args: Effect.succeed([]),
+        stdin: Stream.never,
+        stdout: () =>
+          Sink.forEach(() =>
+            Deferred.succeed(writeStarted, undefined).pipe(
+              Effect.andThen(Deferred.await(releaseWrite)),
+            ),
+          ),
+        stderr: () => Sink.drain,
+      });
+      const transport = yield* AcpProtocol.makeAcpPatchedProtocol({
+        stdio,
+        serverRequestMethods: new Set(),
+        onOutgoingResponse: (requestId) =>
+          Deferred.succeed(acknowledged, requestId).pipe(Effect.asVoid),
+      });
+      const sendFiber = yield* transport.serverProtocol
+        .send(0, {
+          _tag: "Exit",
+          requestId: "held-write",
+          exit: { _tag: "Success", value: { ok: true } },
+        })
+        .pipe(Effect.forkScoped);
+
+      yield* Deferred.await(writeStarted);
+      assert.isUndefined(sendFiber.pollUnsafe());
+      assert.isFalse(yield* Deferred.isDone(acknowledged));
+      yield* Deferred.succeed(releaseWrite, undefined);
+      yield* Fiber.join(sendFiber);
+      assert.equal(yield* Deferred.await(acknowledged), "held-write");
+    }),
+  );
+
+  it.effect("fails current, queued, and future responses when the stdout writer fails", () =>
+    Effect.gen(function* () {
+      const writeStarted = yield* Deferred.make<void>();
+      const releaseFailure = yield* Deferred.make<void>();
+      const failures = yield* Queue.unbounded<string>();
+      const terminated = yield* Deferred.make<AcpError.AcpError>();
+      const stdio = Stdio.make({
+        args: Effect.succeed([]),
+        stdin: Stream.never,
+        stdout: () =>
+          Sink.forEach(() =>
+            Deferred.succeed(writeStarted, undefined).pipe(
+              Effect.andThen(Deferred.await(releaseFailure)),
+              Effect.andThen(Effect.die("stdout failed")),
+            ),
+          ),
+        stderr: () => Sink.drain,
+      });
+      const transport = yield* AcpProtocol.makeAcpPatchedProtocol({
+        stdio,
+        serverRequestMethods: new Set(),
+        onOutgoingResponseFailure: (requestId) => Queue.offer(failures, requestId),
+        onTermination: (error) => Deferred.succeed(terminated, error).pipe(Effect.asVoid),
+      });
+      const send = (requestId: string) =>
+        transport.serverProtocol
+          .send(0, {
+            _tag: "Exit",
+            requestId,
+            exit: { _tag: "Success", value: { ok: true } },
+          })
+          .pipe(Effect.exit);
+      const current = yield* send("current").pipe(Effect.forkScoped);
+      yield* Deferred.await(writeStarted);
+      const queued = yield* send("queued").pipe(Effect.forkScoped);
+      yield* Effect.yieldNow;
+      assert.isUndefined(current.pollUnsafe());
+      assert.isUndefined(queued.pollUnsafe());
+      yield* Deferred.succeed(releaseFailure, undefined);
+      assert.instanceOf(yield* Deferred.await(terminated), AcpError.AcpTransportError);
+      yield* Fiber.join(current);
+      yield* Fiber.join(queued);
+      yield* send("future");
+
+      assert.deepEqual(
+        new Set(yield* Queue.takeN(failures, 3)),
+        new Set(["current", "queued", "future"]),
+      );
+    }),
+  );
+
+  it.effect(
+    "atomically rejects an admitted response when the writer closes before queue offer",
+    () =>
+      Effect.gen(function* () {
+        const admitted = yield* Deferred.make<void>();
+        const releaseAdmission = yield* Deferred.make<void>();
+        const failures = yield* Queue.unbounded<string>();
+        const protocolScope = yield* Scope.make();
+        const stdio = Stdio.make({
+          args: Effect.succeed([]),
+          stdin: Stream.never,
+          stdout: () => Sink.drain,
+          stderr: () => Sink.drain,
+        });
+        const transport = yield* AcpProtocol.makeAcpPatchedProtocol({
+          stdio,
+          serverRequestMethods: new Set(),
+          onOutgoingResponseFailure: (requestId) => Queue.offer(failures, requestId),
+          testHooks: {
+            onOutgoingWriteAdmitted: () =>
+              Deferred.succeed(admitted, undefined).pipe(
+                Effect.andThen(Deferred.await(releaseAdmission)),
+              ),
+          },
+        }).pipe(Effect.provideService(Scope.Scope, protocolScope));
+        const send = (requestId: string) =>
+          transport.serverProtocol
+            .send(0, {
+              _tag: "Exit",
+              requestId,
+              exit: { _tag: "Success", value: { ok: true } },
+            })
+            .pipe(Effect.exit);
+        const admittedSend = yield* send("admitted").pipe(Effect.forkScoped);
+
+        yield* Deferred.await(admitted);
+        yield* Scope.close(protocolScope, Exit.void);
+        yield* Deferred.succeed(releaseAdmission, undefined);
+        yield* Fiber.join(admittedSend);
+        yield* send("future");
+
+        assert.deepEqual(yield* Queue.takeN(failures, 2), ["admitted", "future"]);
+      }),
+  );
+
+  it.effect("drops agent-internal JSON-RPC responses with non-numeric request ids", () =>
+    Effect.gen(function* () {
+      const { stdio, input } = yield* makeInMemoryStdio();
+      const notifications =
+        yield* Deferred.make<ReadonlyArray<AcpProtocol.AcpIncomingNotification>>();
+      const transport = yield* AcpProtocol.makeAcpPatchedProtocol({
+        stdio,
+        serverRequestMethods: new Set(),
+      });
+
+      yield* transport.incoming.pipe(
+        Stream.take(1),
+        Stream.runCollect,
+        Effect.flatMap((notificationChunk) => Deferred.succeed(notifications, notificationChunk)),
+        Effect.forkScoped,
+      );
+
+      yield* Queue.offer(
+        input,
+        encoder.encode(
+          `${encodeUnknownJsonString({
+            jsonrpc: "2.0",
+            id: "skills-reload",
+            result: {
+              reloaded: true,
+            },
+          })}\n`,
+        ),
+      );
+      yield* Queue.offer(
+        input,
+        yield* encodeJsonl(SessionUpdateNotification, {
+          jsonrpc: "2.0",
+          method: "session/update",
+          params: {
+            sessionId: "session-1",
+            update: {
+              sessionUpdate: "plan",
+              entries: [
+                {
+                  content: "Reload skills",
+                  priority: "high",
+                  status: "in_progress",
+                },
+              ],
+            },
+          },
+        }),
+      );
+
+      const [update] = yield* Deferred.await(notifications);
+      assert.equal(update?._tag, "SessionUpdate");
+    }),
+  );
+
   it.effect("cleans up interrupted extension requests before a late response arrives", () =>
     Effect.gen(function* () {
       const { stdio, input, output } = yield* makeInMemoryStdio();
@@ -596,6 +826,31 @@ it.layer(NodeServices.layer)("effect-acp protocol", (it) => {
     }),
   );
 
+  it.effect("does not treat intentional serverProtocol.end as a transport failure", () =>
+    Effect.gen(function* () {
+      const { stdio, input } = yield* makeInMemoryStdio();
+      const terminations = yield* Ref.make(0);
+      const writerExit = yield* Deferred.make<{ readonly intentionalEnd: boolean }>();
+      const transport = yield* AcpProtocol.makeAcpPatchedProtocol({
+        stdio,
+        serverRequestMethods: new Set(),
+        onTermination: () => Ref.update(terminations, (count) => count + 1),
+        testHooks: {
+          onOutgoingWriterExit: (detail) =>
+            Deferred.succeed(writerExit, detail).pipe(Effect.asVoid),
+        },
+      });
+
+      yield* transport.serverProtocol.end(0);
+      const exitDetail = yield* Deferred.await(writerExit);
+      assert.isTrue(exitDetail.intentionalEnd);
+      assert.equal(yield* Ref.get(terminations), 0);
+
+      // Tear down the forever input reader so the scoped test can finish.
+      yield* Queue.end(input);
+    }),
+  );
+
   it.effect("does not emit a second process-exit error after a decode failure", () =>
     Effect.gen(function* () {
       const handle = yield* makeHandle({
diff --git a/packages/effect-acp/src/protocol.ts b/packages/effect-acp/src/protocol.ts
index d61641fbb7b5..63fb879244bc 100644
--- a/packages/effect-acp/src/protocol.ts
+++ b/packages/effect-acp/src/protocol.ts
@@ -1,6 +1,7 @@
 import * as Cause from "effect/Cause";
 import * as Effect from "effect/Effect";
 import * as Deferred from "effect/Deferred";
+import * as Exit from "effect/Exit";
 import * as Queue from "effect/Queue";
 import * as Ref from "effect/Ref";
 import * as Schema from "effect/Schema";
@@ -48,6 +49,11 @@ export interface AcpPatchedProtocolOptions {
   readonly logIncoming?: boolean;
   readonly logOutgoing?: boolean;
   readonly logger?: (event: AcpProtocolLogEvent) => Effect.Effect<void, never>;
+  readonly onIncomingRequest?: (
+    requestId: string,
+    method: string,
+    payload: unknown,
+  ) => Effect.Effect<void, never>;
   readonly onNotification?: (
     notification: AcpIncomingNotification,
   ) => Effect.Effect<void, AcpError.AcpError, never>;
@@ -56,6 +62,18 @@ export interface AcpPatchedProtocolOptions {
     params: unknown,
   ) => Effect.Effect<unknown, AcpError.AcpError, never>;
   readonly onTermination?: (error: AcpError.AcpError) => Effect.Effect<void, never, never>;
+  readonly onOutgoingResponseFailure?: (
+    requestId: string,
+    error: AcpError.AcpError,
+  ) => Effect.Effect<void, never>;
+  readonly onOutgoingResponse?: (requestId: string) => Effect.Effect<void, never>;
+  readonly testHooks?: {
+    readonly onOutgoingWriteAdmitted?: () => Effect.Effect<void>;
+    /** Invoked from the stdout writer exit path (after intentional/unexpected handling). */
+    readonly onOutgoingWriterExit?: (input: {
+      readonly intentionalEnd: boolean;
+    }) => Effect.Effect<void>;
+  };
 }
 
 export interface AcpPatchedProtocol {
@@ -71,12 +89,26 @@ interface AcpPendingRequest {
   readonly method: string;
 }
 
+interface AcpOutgoingWrite {
+  readonly acknowledgement?: Deferred.Deferred<void, AcpError.AcpError>;
+  readonly payload: string | Uint8Array;
+}
+
+interface AcpOutgoingWriterState {
+  readonly outstandingAcknowledgements: ReadonlySet<Deferred.Deferred<void, AcpError.AcpError>>;
+  readonly intentionalEnd: boolean;
+  readonly terminalError?: AcpError.AcpError;
+}
+
 const decodeSessionUpdate = Schema.decodeUnknownEffect(AcpSchema.SessionNotification);
 const decodeElicitationComplete = Schema.decodeUnknownEffect(
   AcpSchema.ElicitationCompleteNotification,
 );
 const parserFactory = RpcSerialization.ndJsonRpc();
 
+const isEffectRpcRequestId = (requestId: AcpError.AcpRequestId): boolean =>
+  typeof requestId === "number" && Number.isSafeInteger(requestId);
+
 export const makeAcpPatchedProtocol = Effect.fn("makeAcpPatchedProtocol")(function* (
   options: AcpPatchedProtocolOptions,
 ): Effect.fn.Return<AcpPatchedProtocol, never, Scope.Scope> {
@@ -85,7 +117,11 @@ export const makeAcpPatchedProtocol = Effect.fn("makeAcpPatchedProtocol")(functi
   const clientQueue = yield* Queue.unbounded<RpcMessage.FromServerEncoded>();
   const notificationQueue = yield* Queue.unbounded<AcpIncomingNotification>();
   const disconnects = yield* Queue.unbounded<number>();
-  const outgoing = yield* Queue.unbounded<string | Uint8Array, Cause.Done<void>>();
+  const outgoing = yield* Queue.unbounded<AcpOutgoingWrite, AcpError.AcpError | Cause.Done<void>>();
+  const outgoingWriterState = yield* Ref.make<AcpOutgoingWriterState>({
+    intentionalEnd: false,
+    outstandingAcknowledgements: new Set(),
+  });
   const nextRequestId = yield* Ref.make(1);
   const terminationHandled = yield* Ref.make(false);
   const extPending = yield* Ref.make(new Map<string, AcpPendingRequest>());
@@ -132,7 +168,66 @@ export const makeAcpPatchedProtocol = Effect.fn("makeAcpPatchedProtocol")(functi
         payload: typeof encoded === "string" ? encoded : new TextDecoder().decode(encoded),
       });
 
-      yield* Queue.offer(outgoing, encoded).pipe(Effect.asVoid);
+      const acknowledgement =
+        message._tag === "Exit" ? yield* Deferred.make<void, AcpError.AcpError>() : undefined;
+      const admissionError = yield* Ref.modify(outgoingWriterState, (state) => {
+        if (state.terminalError !== undefined) {
+          return [state.terminalError, state] as const;
+        }
+        if (acknowledgement === undefined) {
+          return [undefined, state] as const;
+        }
+        return [
+          undefined,
+          {
+            ...state,
+            outstandingAcknowledgements: new Set(state.outstandingAcknowledgements).add(
+              acknowledgement,
+            ),
+          },
+        ] as const;
+      });
+      if (admissionError !== undefined) {
+        return yield* admissionError;
+      }
+      if (options.testHooks?.onOutgoingWriteAdmitted !== undefined) {
+        yield* options.testHooks.onOutgoingWriteAdmitted();
+      }
+      yield* Queue.offer(outgoing, {
+        payload: encoded,
+        ...(acknowledgement === undefined ? {} : { acknowledgement }),
+      }).pipe(
+        Effect.mapError(
+          (cause) =>
+            new AcpError.AcpTransportError({
+              detail: "Failed to queue an outgoing ACP message",
+              cause,
+            }),
+        ),
+        Effect.filterOrFail(
+          (accepted) => accepted,
+          () =>
+            new AcpError.AcpTransportError({
+              detail: "The ACP output queue was closed before accepting a message",
+              cause: "Output queue closed",
+            }),
+        ),
+        Effect.tapError((error) =>
+          acknowledgement === undefined
+            ? Effect.void
+            : Ref.update(outgoingWriterState, (state) => {
+                const updated = new Set(state.outstandingAcknowledgements);
+                updated.delete(acknowledgement);
+                return { ...state, outstandingAcknowledgements: updated };
+              }).pipe(Effect.andThen(Deferred.fail(acknowledgement, error)), Effect.asVoid),
+        ),
+      );
+      if (acknowledgement !== undefined) {
+        yield* Deferred.await(acknowledgement);
+      }
+      if (message._tag === "Exit" && options.onOutgoingResponse !== undefined) {
+        yield* options.onOutgoingResponse(String(message.requestId));
+      }
     }
   });
 
@@ -310,8 +405,11 @@ export const makeAcpPatchedProtocol = Effect.fn("makeAcpPatchedProtocol")(functi
       });
     }
 
+    const observeIncoming =
+      options.onIncomingRequest?.(String(message.id), message.tag, message.payload) ?? Effect.void;
+
     if (!options.serverRequestMethods.has(message.tag)) {
-      return handleExtRequest(message).pipe(
+      return observeIncoming.pipe(Effect.andThen(handleExtRequest(message))).pipe(
         Effect.catchTags({
           AcpProtocolParseError: (error) =>
             Effect.logWarning(error).pipe(
@@ -336,15 +434,22 @@ export const makeAcpPatchedProtocol = Effect.fn("makeAcpPatchedProtocol")(functi
       );
     }
 
-    return Queue.offer(serverQueue, message).pipe(Effect.asVoid);
+    return observeIncoming.pipe(Effect.andThen(Queue.offer(serverQueue, message)), Effect.asVoid);
   };
 
+  const forwardToRpcClient = (
+    message: RpcMessage.ResponseChunkEncoded | RpcMessage.ResponseExitEncoded,
+  ) =>
+    isEffectRpcRequestId(message.requestId)
+      ? Queue.offer(clientQueue, message).pipe(Effect.asVoid)
+      : Effect.void;
+
   const handleExitEncoded = (message: RpcMessage.ResponseExitEncoded) =>
     Ref.get(extPending).pipe(
       Effect.flatMap((pending) => {
         const pendingRequest = pending.get(String(message.requestId));
         if (!pendingRequest) {
-          return Queue.offer(clientQueue, message).pipe(Effect.asVoid);
+          return forwardToRpcClient(message);
         }
         if (message.exit._tag === "Success") {
           return completeExtPendingSuccess(message.requestId, message.exit.value);
@@ -391,7 +496,7 @@ export const makeAcpPatchedProtocol = Effect.fn("makeAcpPatchedProtocol")(functi
                     message.requestId,
                   ),
                 )
-              : Queue.offer(clientQueue, message).pipe(Effect.asVoid);
+              : forwardToRpcClient(message);
           }),
         );
       case "Defect":
@@ -475,7 +580,112 @@ export const makeAcpPatchedProtocol = Effect.fn("makeAcpPatchedProtocol")(functi
     Effect.forkScoped,
   );
 
-  yield* Stream.fromQueue(outgoing).pipe(Stream.run(options.stdio.stdout()), Effect.forkScoped);
+  const failOutgoingWrites = (error: AcpError.AcpError) =>
+    Ref.modify(outgoingWriterState, (state) => {
+      const terminalError = state.terminalError ?? error;
+      return [
+        [terminalError, state.outstandingAcknowledgements] as const,
+        {
+          ...state,
+          terminalError,
+          outstandingAcknowledgements: new Set<Deferred.Deferred<void, AcpError.AcpError>>(),
+        },
+      ] as const;
+    }).pipe(
+      Effect.flatMap((acknowledgements) =>
+        Effect.forEach(
+          acknowledgements[1],
+          (acknowledgement) => Deferred.fail(acknowledgement, acknowledgements[0]),
+          { concurrency: "unbounded", discard: true },
+        ),
+      ),
+      Effect.andThen(Queue.fail(outgoing, error)),
+      Effect.asVoid,
+    );
+  const completeOutgoingWrites = () =>
+    Ref.modify(outgoingWriterState, (state) => {
+      return [
+        state.outstandingAcknowledgements,
+        {
+          ...state,
+          outstandingAcknowledgements: new Set<Deferred.Deferred<void, AcpError.AcpError>>(),
+        },
+      ] as const;
+    }).pipe(
+      Effect.flatMap((acknowledgements) =>
+        Effect.forEach(
+          acknowledgements,
+          (acknowledgement) => Deferred.succeed(acknowledgement, undefined),
+          { concurrency: "unbounded", discard: true },
+        ),
+      ),
+      Effect.asVoid,
+    );
+  const acknowledgeOutgoingWrite = (acknowledgement: Deferred.Deferred<void, AcpError.AcpError>) =>
+    Ref.update(outgoingWriterState, (state) => {
+      const updated = new Set(state.outstandingAcknowledgements);
+      updated.delete(acknowledgement);
+      return { ...state, outstandingAcknowledgements: updated };
+    }).pipe(Effect.andThen(Deferred.succeed(acknowledgement, undefined)), Effect.asVoid);
+  yield* Stream.fromQueue(outgoing).pipe(
+    Stream.flatMap((write) => {
+      const acknowledgement = write.acknowledgement;
+      const completion =
+        acknowledgement === undefined
+          ? Stream.empty
+          : Stream.fromEffect(acknowledgeOutgoingWrite(acknowledgement)).pipe(Stream.drain);
+      return Stream.make(write.payload).pipe(Stream.concat(completion));
+    }),
+    Stream.run(options.stdio.stdout()),
+    Effect.onExit((exit) =>
+      Exit.match(exit, {
+        onFailure: (cause) => {
+          const error = new AcpError.AcpTransportError({
+            detail: Cause.hasInterruptsOnly(cause)
+              ? "The ACP output writer was interrupted while closing"
+              : "Failed to write an outgoing ACP message",
+            cause,
+          });
+          return failOutgoingWrites(error).pipe(
+            Effect.andThen(
+              Cause.hasInterruptsOnly(cause)
+                ? Effect.void
+                : handleTermination(() => Effect.succeed(error)),
+            ),
+          );
+        },
+        onSuccess: () =>
+          Ref.get(outgoingWriterState).pipe(
+            Effect.flatMap((state) => {
+              // Intentional Queue.end (serverProtocol.end) completes the writer
+              // successfully. Do not invent a transport failure or client protocol
+              // error for a clean RPC shutdown.
+              const handled = state.intentionalEnd
+                ? completeOutgoingWrites()
+                : (() => {
+                    const error = new AcpError.AcpTransportError({
+                      detail: "ACP output writer ended before the protocol closed",
+                      cause: "Output writer ended",
+                    });
+                    return failOutgoingWrites(error).pipe(
+                      Effect.andThen(handleTermination(() => Effect.succeed(error))),
+                    );
+                  })();
+              return handled.pipe(
+                Effect.andThen(
+                  options.testHooks?.onOutgoingWriterExit === undefined
+                    ? Effect.void
+                    : options.testHooks.onOutgoingWriterExit({
+                        intentionalEnd: state.intentionalEnd,
+                      }),
+                ),
+              );
+            }),
+          ),
+      }),
+    ),
+    Effect.forkScoped,
+  );
 
   const clientProtocol = RpcClient.Protocol.of({
     run: (_clientId, f) =>
@@ -506,8 +716,19 @@ export const makeAcpPatchedProtocol = Effect.fn("makeAcpPatchedProtocol")(functi
         Effect.forever,
       ),
     disconnects,
-    send: (_clientId, response) => offerOutgoing(response).pipe(Effect.orDie),
-    end: (_clientId) => Queue.end(outgoing),
+    send: (_clientId, response) =>
+      offerOutgoing(response).pipe(
+        Effect.tapError((error) =>
+          response._tag === "Exit" && options.onOutgoingResponseFailure !== undefined
+            ? options.onOutgoingResponseFailure(String(response.requestId), error)
+            : Effect.void,
+        ),
+        Effect.orDie,
+      ),
+    end: (_clientId) =>
+      Ref.update(outgoingWriterState, (state) => ({ ...state, intentionalEnd: true })).pipe(
+        Effect.andThen(Queue.end(outgoing)),
+      ),
     clientIds: Effect.succeed(new Set([0])),
     initialMessage: Effect.succeedNone,
     supportsAck: true,
diff --git a/packages/effect-acp/test/examples/cursor-acp-client.example.ts b/packages/effect-acp/test/examples/cursor-acp-client.example.ts
deleted file mode 100644
index b7a146cf5c21..000000000000
--- a/packages/effect-acp/test/examples/cursor-acp-client.example.ts
+++ /dev/null
@@ -1,81 +0,0 @@
-import * as Effect from "effect/Effect";
-import * as Console from "effect/Console";
-import { ChildProcess, ChildProcessSpawner } from "effect/unstable/process";
-
-import * as NodeServices from "@effect/platform-node/NodeServices";
-import * as NodeRuntime from "@effect/platform-node/NodeRuntime";
-
-import * as AcpClient from "../../src/client.ts";
-
-const program = Effect.gen(function* () {
-  const spawner = yield* ChildProcessSpawner.ChildProcessSpawner;
-  const command = ChildProcess.make("cursor-agent", ["acp"], {
-    cwd: process.cwd(),
-    shell: false,
-  });
-  const handle = yield* spawner.spawn(command);
-  const acpLayer = AcpClient.layerChildProcess(handle, {
-    logIncoming: true,
-    logOutgoing: true,
-  });
-
-  yield* Effect.gen(function* () {
-    const acp = yield* AcpClient.AcpClient;
-
-    yield* acp.handleRequestPermission(() =>
-      Effect.succeed({
-        outcome: {
-          outcome: "selected",
-          optionId: "allow",
-        },
-      }),
-    );
-    // yield* acp.handleSessionUpdate((notification) =>
-    //   Console.log("session/update", JSON.stringify(notification)),
-    // );
-
-    const initialized = yield* acp.agent.initialize({
-      protocolVersion: 1,
-      clientCapabilities: {
-        fs: { readTextFile: false, writeTextFile: false },
-        terminal: false,
-        _meta: {
-          parameterizedModelPicker: true,
-        },
-      },
-      clientInfo: {
-        name: "effect-acp-example",
-        version: "0.0.0",
-      },
-    });
-    yield* Console.log("initialized", initialized);
-
-    const session = yield* acp.agent.createSession({
-      cwd: process.cwd(),
-      mcpServers: [],
-    });
-
-    const config = yield* acp.agent.setSessionConfigOption({
-      sessionId: session.sessionId,
-      configId: "model",
-      value: "claude-opus-4-6",
-    });
-
-    yield* Console.log("config", config);
-
-    const result = yield* acp.agent.prompt({
-      sessionId: session.sessionId,
-      prompt: [
-        {
-          type: "text",
-          text: "Illustrate your ability to create todo lists and then execute all of them. Do not write the list to disk, illustrate your built in ability!",
-        },
-      ],
-    });
-
-    yield* Console.log("prompt result", result);
-    yield* acp.agent.cancel({ sessionId: session.sessionId });
-  }).pipe(Effect.provide(acpLayer));
-});
-
-program.pipe(Effect.scoped, Effect.provide(NodeServices.layer), NodeRuntime.runMain);
diff --git a/packages/effect-codex-app-server/package.json b/packages/effect-codex-app-server/package.json
index a067976c616a..a71f9a57a3e4 100644
--- a/packages/effect-codex-app-server/package.json
+++ b/packages/effect-codex-app-server/package.json
@@ -19,6 +19,10 @@
       "types": "./src/protocol.ts",
       "import": "./src/protocol.ts"
     },
+    "./replay": {
+      "types": "./src/replay.ts",
+      "import": "./src/replay.ts"
+    },
     "./errors": {
       "types": "./src/errors.ts",
       "import": "./src/errors.ts"
diff --git a/packages/effect-codex-app-server/src/client.ts b/packages/effect-codex-app-server/src/client.ts
index c0cb5b1dc23a..0f5635cda6c2 100644
--- a/packages/effect-codex-app-server/src/client.ts
+++ b/packages/effect-codex-app-server/src/client.ts
@@ -8,6 +8,7 @@ import * as Stream from "effect/Stream";
 import * as ChildProcessSpawner from "effect/unstable/process/ChildProcessSpawner";
 
 import * as CodexRpc from "./_generated/meta.gen.ts";
+import * as CodexSchema from "./_generated/schema.gen.ts";
 import * as CodexError from "./errors.ts";
 import * as CodexProtocol from "./protocol.ts";
 import {
@@ -84,6 +85,12 @@ type ServerNotificationHandler = (
   payload: unknown,
 ) => Effect.Effect<void, CodexError.CodexAppServerError>;
 
+const V2TurnStartParamsWithCollaborationMode = CodexSchema.V2TurnStartParams.pipe(
+  Schema.fieldsAssign({
+    collaborationMode: Schema.optionalKey(CodexSchema.ClientRequest__CollaborationMode),
+  }),
+);
+
 export const make = Effect.fn("effect-codex-app-server/CodexAppServerClient.make")(function* (
   stdio: Stdio.Stdio,
   options: CodexAppServerClientOptions = {},
@@ -117,7 +124,10 @@ export const make = Effect.fn("effect-codex-app-server/CodexAppServerClient.make
     method: M,
   ):
     | Schema.Codec<CodexRpc.ClientRequestParamsByMethod[M], CodexRpc.ClientRequestParamsByMethod[M]>
-    | undefined => CodexRpc.CLIENT_REQUEST_PARAMS[method] as never;
+    | undefined =>
+    method === "turn/start"
+      ? (V2TurnStartParamsWithCollaborationMode as never)
+      : (CodexRpc.CLIENT_REQUEST_PARAMS[method] as never);
 
   const getClientRequestResponseSchema = <M extends CodexRpc.ClientRequestMethod>(
     method: M,
diff --git a/packages/effect-codex-app-server/src/replay.test.ts b/packages/effect-codex-app-server/src/replay.test.ts
new file mode 100644
index 000000000000..804513d64190
--- /dev/null
+++ b/packages/effect-codex-app-server/src/replay.test.ts
@@ -0,0 +1,146 @@
+import * as Exit from "effect/Exit";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Schema from "effect/Schema";
+import * as Scope from "effect/Scope";
+
+import { assert, it } from "@effect/vitest";
+
+import * as CodexClient from "./client.ts";
+import * as CodexError from "./errors.ts";
+import * as CodexReplay from "./replay.ts";
+
+const isCodexAppServerTransportError = Schema.is(CodexError.CodexAppServerTransportError);
+const decodeReplayError = Schema.decodeUnknownEffect(CodexReplay.CodexAppServerReplayError);
+const encodeReplayError = Schema.encodeUnknownEffect(CodexReplay.CodexAppServerReplayError);
+
+const initializeParams = {
+  clientInfo: {
+    name: "effect-codex-app-server-test",
+    title: "Effect Codex App Server Test",
+    version: "0.0.0",
+  },
+  capabilities: {
+    experimentalApi: true,
+    optOutNotificationMethods: null,
+  },
+} as const;
+
+const initializeResponse = {
+  userAgent: "replay-codex-app-server",
+  codexHome: "/tmp/codex-home",
+  platformFamily: "unix",
+  platformOs: "macos",
+} as const;
+
+function buildContext(transcript: CodexReplay.CodexAppServerReplayTranscript) {
+  return Effect.gen(function* () {
+    const scope = yield* Scope.make();
+    const context = yield* Layer.buildWithScope(CodexReplay.layerReplay(transcript), scope);
+    return { context, scope };
+  });
+}
+
+it.effect("replays Codex app-server frames through the real client protocol", () =>
+  Effect.gen(function* () {
+    const { context, scope } = yield* buildContext({
+      provider: "codex",
+      protocol: "codex.app-server",
+      version: "test",
+      scenario: "initialize",
+      entries: [
+        {
+          type: "expect_outbound",
+          label: "initialize",
+          frame: {
+            id: 1,
+            method: "initialize",
+            params: {
+              ...initializeParams,
+              clientInfo: {
+                ...initializeParams.clientInfo,
+                version: "older-fixture-version",
+              },
+            },
+          },
+        },
+        {
+          type: "emit_inbound",
+          label: "initialize",
+          frame: {
+            id: 1,
+            result: initializeResponse,
+          },
+        },
+        {
+          type: "expect_outbound",
+          label: "initialized",
+          frame: {
+            method: "initialized",
+          },
+        },
+        {
+          type: "runtime_exit",
+          status: "success",
+        },
+      ],
+    });
+
+    yield* Effect.gen(function* () {
+      const client = yield* CodexClient.CodexAppServerClient;
+      assert.deepEqual(yield* client.request("initialize", initializeParams), initializeResponse);
+      yield* client.notify("initialized", undefined);
+    }).pipe(Effect.provide(context), Effect.ensuring(Scope.close(scope, Exit.void)));
+  }),
+);
+
+it.effect("fails pending client requests with a schema-serializable replay mismatch", () =>
+  Effect.gen(function* () {
+    const { context, scope } = yield* buildContext({
+      provider: "codex",
+      protocol: "codex.app-server",
+      version: "test",
+      scenario: "mismatch",
+      entries: [
+        {
+          type: "expect_outbound",
+          label: "initialize",
+          frame: {
+            id: 1,
+            method: "initialize",
+            params: initializeParams,
+          },
+        },
+        {
+          type: "runtime_exit",
+          status: "success",
+        },
+      ],
+    });
+
+    const error = yield* Effect.gen(function* () {
+      const client = yield* CodexClient.CodexAppServerClient;
+      return yield* client.request("account/read", {});
+    }).pipe(Effect.provide(context), Effect.flip, Effect.ensuring(Scope.close(scope, Exit.void)));
+
+    assert.equal(error._tag, "CodexAppServerTransportError");
+    if (!isCodexAppServerTransportError(error)) {
+      throw new Error("Expected transport error.");
+    }
+
+    const replayError = yield* decodeReplayError(error.cause);
+    const encoded = yield* encodeReplayError(replayError);
+
+    assert.equal(encoded._tag, "CodexAppServerReplayFrameMismatchError");
+    if (encoded._tag !== "CodexAppServerReplayFrameMismatchError") {
+      throw new Error("Expected frame mismatch error.");
+    }
+    assert.equal(encoded.scenario, "mismatch");
+    assert.equal(encoded.cursor, 0);
+    assert.deepEqual(encoded.actual, {
+      id: 1,
+      method: "account/read",
+      params: {},
+    });
+  }),
+);
diff --git a/packages/effect-codex-app-server/src/replay.ts b/packages/effect-codex-app-server/src/replay.ts
new file mode 100644
index 000000000000..dd03f6fc6cd7
--- /dev/null
+++ b/packages/effect-codex-app-server/src/replay.ts
@@ -0,0 +1,532 @@
+import * as Cause from "effect/Cause";
+import * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Queue from "effect/Queue";
+import * as Ref from "effect/Ref";
+import * as Schema from "effect/Schema";
+import * as Sink from "effect/Sink";
+import * as Stdio from "effect/Stdio";
+import * as Stream from "effect/Stream";
+
+import { CodexAppServerClient } from "./client.ts";
+import * as CodexClient from "./client.ts";
+import * as CodexError from "./errors.ts";
+
+export const CodexAppServerReplayEntry = Schema.Union([
+  Schema.Struct({
+    type: Schema.Literal("expect_outbound"),
+    label: Schema.optional(Schema.String),
+    frame: Schema.Unknown,
+  }),
+  Schema.Struct({
+    type: Schema.Literal("emit_inbound"),
+    label: Schema.optional(Schema.String),
+    frame: Schema.Unknown,
+    afterMs: Schema.optional(Schema.Number),
+  }),
+  Schema.Struct({
+    type: Schema.Literal("runtime_exit"),
+    status: Schema.Literals(["success", "error", "cancelled"]),
+    error: Schema.optional(Schema.Unknown),
+  }),
+]);
+export type CodexAppServerReplayEntry = typeof CodexAppServerReplayEntry.Type;
+
+export const CodexAppServerReplayTranscript = Schema.Struct({
+  provider: Schema.Literal("codex"),
+  protocol: Schema.Literal("codex.app-server"),
+  version: Schema.String,
+  scenario: Schema.String,
+  metadata: Schema.optional(Schema.Record(Schema.String, Schema.Unknown)),
+  entries: Schema.Array(CodexAppServerReplayEntry),
+});
+export type CodexAppServerReplayTranscript = typeof CodexAppServerReplayTranscript.Type;
+const decodeOutboundJsonFrame = Schema.decodeUnknownSync(Schema.fromJsonString(Schema.Unknown));
+
+export class CodexAppServerReplayJsonParseError extends Schema.TaggedErrorClass<CodexAppServerReplayJsonParseError>()(
+  "CodexAppServerReplayJsonParseError",
+  {
+    scenario: Schema.String,
+    line: Schema.String,
+    cause: Schema.Defect(),
+  },
+) {
+  override get message(): string {
+    return `Failed to parse outbound Codex app-server replay frame for scenario ${this.scenario}.`;
+  }
+}
+
+export class CodexAppServerReplayExhaustedError extends Schema.TaggedErrorClass<CodexAppServerReplayExhaustedError>()(
+  "CodexAppServerReplayExhaustedError",
+  {
+    scenario: Schema.String,
+    cursor: Schema.Number,
+    actual: Schema.Unknown,
+  },
+) {
+  override get message(): string {
+    return `Codex app-server replay transcript exhausted before outbound frame ${this.cursor} in scenario ${this.scenario}.`;
+  }
+}
+
+export class CodexAppServerReplayUnexpectedOutboundError extends Schema.TaggedErrorClass<CodexAppServerReplayUnexpectedOutboundError>()(
+  "CodexAppServerReplayUnexpectedOutboundError",
+  {
+    scenario: Schema.String,
+    cursor: Schema.Number,
+    expectedType: Schema.String,
+    actual: Schema.Unknown,
+  },
+) {
+  override get message(): string {
+    return `Unexpected outbound Codex app-server frame at replay cursor ${this.cursor} in scenario ${this.scenario}.`;
+  }
+}
+
+export class CodexAppServerReplayFrameMismatchError extends Schema.TaggedErrorClass<CodexAppServerReplayFrameMismatchError>()(
+  "CodexAppServerReplayFrameMismatchError",
+  {
+    scenario: Schema.String,
+    cursor: Schema.Number,
+    label: Schema.optional(Schema.String),
+    expected: Schema.Unknown,
+    actual: Schema.Unknown,
+  },
+) {
+  override get message(): string {
+    return `Outbound Codex app-server frame did not match replay cursor ${this.cursor} in scenario ${this.scenario}. Expected ${JSON.stringify(this.expected)}, received ${JSON.stringify(this.actual)}.`;
+  }
+}
+
+export class CodexAppServerReplayRuntimeExitError extends Schema.TaggedErrorClass<CodexAppServerReplayRuntimeExitError>()(
+  "CodexAppServerReplayRuntimeExitError",
+  {
+    scenario: Schema.String,
+    cursor: Schema.Number,
+    status: Schema.Literals(["error", "cancelled"]),
+    error: Schema.optional(Schema.Unknown),
+  },
+) {
+  override get message(): string {
+    return `Codex app-server replay exited with status ${this.status} at cursor ${this.cursor} in scenario ${this.scenario}.`;
+  }
+}
+
+export class CodexAppServerReplayIncompleteError extends Schema.TaggedErrorClass<CodexAppServerReplayIncompleteError>()(
+  "CodexAppServerReplayIncompleteError",
+  {
+    scenario: Schema.String,
+    cursor: Schema.Number,
+    remaining: Schema.Number,
+  },
+) {
+  override get message(): string {
+    return `Codex app-server replay ended with ${this.remaining} unconsumed entries in scenario ${this.scenario}.`;
+  }
+}
+
+export const CodexAppServerReplayError = Schema.Union([
+  CodexAppServerReplayJsonParseError,
+  CodexAppServerReplayExhaustedError,
+  CodexAppServerReplayUnexpectedOutboundError,
+  CodexAppServerReplayFrameMismatchError,
+  CodexAppServerReplayRuntimeExitError,
+  CodexAppServerReplayIncompleteError,
+]);
+export type CodexAppServerReplayError = typeof CodexAppServerReplayError.Type;
+
+export interface CodexAppServerReplayState {
+  readonly cursor: number;
+  readonly failure: CodexAppServerReplayError | null;
+}
+
+export interface CodexAppServerReplayDriver {
+  readonly transcript: CodexAppServerReplayTranscript;
+  readonly state: Ref.Ref<CodexAppServerReplayState>;
+  readonly beforeEmitInbound?: (
+    entry: Extract<CodexAppServerReplayEntry, { readonly type: "emit_inbound" }>,
+  ) => Effect.Effect<void>;
+}
+
+const encoder = new TextEncoder();
+
+function stableStringify(value: unknown): string {
+  if (Array.isArray(value)) {
+    return `[${value.map(stableStringify).join(",")}]`;
+  }
+  if (typeof value === "object" && value !== null) {
+    const record = value as Record<string, unknown>;
+    return `{${Object.keys(record)
+      .toSorted()
+      .map((key) => `${JSON.stringify(key)}:${stableStringify(record[key])}`)
+      .join(",")}}`;
+  }
+  return JSON.stringify(value);
+}
+
+function normalizeContextHandoffText(value: string): string {
+  if (!value.startsWith("Context handoff (")) {
+    return value;
+  }
+  const userMessageMarker = "\n\nUser message:\n";
+  const userMessageIndex = value.indexOf(userMessageMarker);
+  const headerEndIndex = value.indexOf(":\n");
+  if (headerEndIndex === -1 || userMessageIndex === -1 || headerEndIndex >= userMessageIndex) {
+    return value;
+  }
+  return `${value.slice(0, headerEndIndex + 2)}<dynamic-summary>${value.slice(userMessageIndex)}`;
+}
+
+function normalizeReplayFrame(value: unknown): unknown {
+  if (typeof value === "string") {
+    return normalizeContextHandoffText(value);
+  }
+  if (typeof value !== "object" || value === null) {
+    return value;
+  }
+  if (Array.isArray(value)) {
+    return value.map(normalizeReplayFrame);
+  }
+
+  const record = value as Record<string, unknown>;
+  const normalized = Object.fromEntries(
+    Object.entries(record).map(([key, entry]) => [key, normalizeReplayFrame(entry)]),
+  );
+
+  if (
+    normalized.method === "initialize" &&
+    typeof normalized.params === "object" &&
+    normalized.params !== null
+  ) {
+    const params = normalized.params as Record<string, unknown>;
+    if (typeof params.clientInfo === "object" && params.clientInfo !== null) {
+      normalized.params = {
+        ...params,
+        clientInfo: {
+          ...(params.clientInfo as Record<string, unknown>),
+          version: "<ignored>",
+        },
+      };
+    }
+  }
+
+  if (
+    normalized.method === "turn/start" &&
+    typeof normalized.params === "object" &&
+    normalized.params !== null
+  ) {
+    const params = { ...(normalized.params as Record<string, unknown>) };
+    if (params.approvalPolicy === "never") {
+      delete params.approvalPolicy;
+    }
+    if (
+      typeof params.sandboxPolicy === "object" &&
+      params.sandboxPolicy !== null &&
+      (params.sandboxPolicy as Record<string, unknown>).type === "dangerFullAccess"
+    ) {
+      delete params.sandboxPolicy;
+    }
+    if (typeof params.collaborationMode === "object" && params.collaborationMode !== null) {
+      const collaborationMode = {
+        ...(params.collaborationMode as Record<string, unknown>),
+      };
+      if (typeof collaborationMode.settings === "object" && collaborationMode.settings !== null) {
+        collaborationMode.settings = {
+          ...(collaborationMode.settings as Record<string, unknown>),
+          developer_instructions: "<ignored>",
+        };
+      }
+      params.collaborationMode = collaborationMode;
+    }
+    normalized.params = params;
+  }
+
+  if (
+    (normalized.method === "thread/start" ||
+      normalized.method === "thread/resume" ||
+      normalized.method === "thread/fork") &&
+    typeof normalized.params === "object" &&
+    normalized.params !== null
+  ) {
+    // Runtime-scoped thread settings are supplied by the host and commonly
+    // contain machine-local cwd and short-lived MCP authorization headers.
+    // They are orthogonal to the recorded provider protocol behavior.
+    const params = { ...(normalized.params as Record<string, unknown>) };
+    delete params.cwd;
+    delete params.model;
+    delete params.config;
+    normalized.params = params;
+  }
+
+  return normalized;
+}
+
+function sameFrame(left: unknown, right: unknown): boolean {
+  return (
+    stableStringify(normalizeReplayFrame(left)) === stableStringify(normalizeReplayFrame(right))
+  );
+}
+
+function normalizeLegacyInboundFrame(value: unknown): unknown {
+  if (Array.isArray(value)) {
+    return value.map(normalizeLegacyInboundFrame);
+  }
+  if (typeof value !== "object" || value === null) {
+    return value;
+  }
+  const record = value as Record<string, unknown>;
+  const normalized = Object.fromEntries(
+    Object.entries(record).map(([key, entry]) => [key, normalizeLegacyInboundFrame(entry)]),
+  );
+  if (
+    typeof normalized.id === "string" &&
+    normalized.sessionId === undefined &&
+    "modelProvider" in normalized &&
+    "status" in normalized
+  ) {
+    normalized.sessionId = normalized.id;
+  }
+  if (
+    (normalized.method === "item/started" || normalized.method === "item/completed") &&
+    typeof normalized.params === "object" &&
+    normalized.params !== null
+  ) {
+    const params = { ...(normalized.params as Record<string, unknown>) };
+    if (normalized.method === "item/started" && params.startedAtMs === undefined) {
+      params.startedAtMs = 0;
+    }
+    if (normalized.method === "item/completed" && params.completedAtMs === undefined) {
+      params.completedAtMs = 0;
+    }
+    normalized.params = params;
+  }
+  if (
+    typeof normalized.method === "string" &&
+    normalized.method.endsWith("/requestApproval") &&
+    typeof normalized.params === "object" &&
+    normalized.params !== null
+  ) {
+    const params = { ...(normalized.params as Record<string, unknown>) };
+    if (params.startedAtMs === undefined) {
+      params.startedAtMs = 0;
+    }
+    normalized.params = params;
+  }
+  return normalized;
+}
+
+function encodeInboundFrame(frame: unknown): Uint8Array {
+  return encoder.encode(`${JSON.stringify(normalizeLegacyInboundFrame(frame))}\n`);
+}
+
+function replayTransportError(
+  error: CodexAppServerReplayError,
+): CodexError.CodexAppServerTransportError {
+  return new CodexError.CodexAppServerTransportError({
+    operation: "read-input-stream",
+    cause: error,
+  });
+}
+
+export function layerReplay(
+  transcript: CodexAppServerReplayTranscript,
+): Layer.Layer<CodexAppServerClient, CodexAppServerReplayError> {
+  return Layer.effect(CodexAppServerClient, makeReplayClient(transcript));
+}
+
+export const makeReplayDriver = Effect.fn("effect-codex-app-server/replay.makeReplayDriver")(
+  function* (
+    transcript: CodexAppServerReplayTranscript,
+    options: Pick<CodexAppServerReplayDriver, "beforeEmitInbound"> = {},
+  ) {
+    return {
+      transcript,
+      state: yield* Ref.make<CodexAppServerReplayState>({ cursor: 0, failure: null }),
+      ...options,
+    } satisfies CodexAppServerReplayDriver;
+  },
+);
+
+export function layerReplayWithDriver(
+  driver: CodexAppServerReplayDriver,
+): Layer.Layer<CodexAppServerClient, CodexAppServerReplayError> {
+  return Layer.effect(CodexAppServerClient, makeReplayClientWithState(driver));
+}
+
+export const makeReplayClient = Effect.fn("effect-codex-app-server/replay.makeReplayClient")(
+  function* (
+    transcript: CodexAppServerReplayTranscript,
+    options: CodexClient.CodexAppServerClientOptions = {},
+  ) {
+    const driver = yield* makeReplayDriver(transcript);
+    return yield* makeReplayClientWithState(driver, options);
+  },
+);
+
+const makeReplayClientWithState = Effect.fn(
+  "effect-codex-app-server/replay.makeReplayClientWithState",
+)(function* (
+  driver: CodexAppServerReplayDriver,
+  options: CodexClient.CodexAppServerClientOptions = {},
+) {
+  const transcript = driver.transcript;
+  const input = yield* Queue.unbounded<Uint8Array, Cause.Done<void>>();
+  const state = driver.state;
+  const outboundRemainder = yield* Ref.make("");
+  const decoder = new TextDecoder();
+
+  const failReplay = (error: CodexAppServerReplayError) =>
+    Ref.update(state, (current) => ({
+      ...current,
+      failure: current.failure ?? error,
+    })).pipe(Effect.andThen(Queue.end(input)));
+
+  const drainInbound = Effect.fn("effect-codex-app-server/replay.drainInbound")(function* () {
+    while (true) {
+      const current = yield* Ref.get(state);
+      if (current.failure) {
+        return;
+      }
+
+      const entry = transcript.entries[current.cursor];
+      if (!entry) {
+        return;
+      }
+
+      if (entry.type === "emit_inbound") {
+        if (driver.beforeEmitInbound !== undefined) {
+          yield* driver.beforeEmitInbound(entry);
+        }
+        if (entry.afterMs !== undefined && entry.afterMs > 0) {
+          yield* Effect.sleep(Duration.millis(entry.afterMs));
+        }
+        yield* Queue.offer(input, encodeInboundFrame(entry.frame));
+        yield* Ref.update(state, (latest) => ({ ...latest, cursor: latest.cursor + 1 }));
+        continue;
+      }
+
+      if (entry.type === "runtime_exit") {
+        yield* Ref.update(state, (latest) => ({ ...latest, cursor: latest.cursor + 1 }));
+        if (entry.status === "success") {
+          yield* Queue.end(input);
+          return;
+        }
+        yield* failReplay(
+          new CodexAppServerReplayRuntimeExitError({
+            scenario: transcript.scenario,
+            cursor: current.cursor,
+            status: entry.status,
+            ...(entry.error === undefined ? {} : { error: entry.error }),
+          }),
+        );
+        return;
+      }
+
+      return;
+    }
+  });
+
+  const processOutboundFrame = (actual: unknown) =>
+    drainInbound().pipe(
+      Effect.andThen(
+        Effect.gen(function* () {
+          const current = yield* Ref.get(state);
+          if (current.failure) {
+            return;
+          }
+
+          const entry = transcript.entries[current.cursor];
+          if (!entry) {
+            yield* failReplay(
+              new CodexAppServerReplayExhaustedError({
+                scenario: transcript.scenario,
+                cursor: current.cursor,
+                actual,
+              }),
+            );
+            return;
+          }
+
+          if (entry.type !== "expect_outbound") {
+            yield* failReplay(
+              new CodexAppServerReplayUnexpectedOutboundError({
+                scenario: transcript.scenario,
+                cursor: current.cursor,
+                expectedType: entry.type,
+                actual,
+              }),
+            );
+            return;
+          }
+
+          if (!sameFrame(entry.frame, actual)) {
+            yield* failReplay(
+              new CodexAppServerReplayFrameMismatchError({
+                scenario: transcript.scenario,
+                cursor: current.cursor,
+                ...(entry.label === undefined ? {} : { label: entry.label }),
+                expected: entry.frame,
+                actual,
+              }),
+            );
+            return;
+          }
+
+          yield* Ref.update(state, (latest) => ({ ...latest, cursor: latest.cursor + 1 }));
+          yield* drainInbound();
+        }),
+      ),
+    );
+
+  const processOutboundLine = (line: string) => {
+    const trimmed = line.trim();
+    if (trimmed.length === 0) {
+      return Effect.void;
+    }
+    return Effect.try({
+      try: () => decodeOutboundJsonFrame(trimmed),
+      catch: (cause) =>
+        new CodexAppServerReplayJsonParseError({
+          scenario: transcript.scenario,
+          line: trimmed,
+          cause,
+        }),
+    }).pipe(
+      Effect.matchEffect({
+        onFailure: failReplay,
+        onSuccess: processOutboundFrame,
+      }),
+    );
+  };
+
+  const processOutboundChunk = (chunk: string | Uint8Array) =>
+    Ref.modify(outboundRemainder, (current) => {
+      const text = typeof chunk === "string" ? chunk : decoder.decode(chunk, { stream: true });
+      const combined = current + text;
+      const lines = combined.split("\n");
+      const nextRemainder = lines.pop() ?? "";
+      return [lines.map((line) => line.replace(/\r$/, "")), nextRemainder] as const;
+    }).pipe(
+      Effect.flatMap((lines) => Effect.forEach(lines, processOutboundLine, { discard: true })),
+    );
+
+  const terminationError: Effect.Effect<CodexError.CodexAppServerError> = Ref.get(state).pipe(
+    Effect.map((current) =>
+      current.failure
+        ? replayTransportError(current.failure)
+        : new CodexError.CodexAppServerProcessExitedError({ code: 0 }),
+    ),
+  );
+
+  const stdio = Stdio.make({
+    args: Effect.succeed([]),
+    stdin: Stream.fromQueue(input),
+    stdout: () => Sink.forEach(processOutboundChunk),
+    stderr: () => Sink.drain,
+  });
+
+  yield* drainInbound();
+
+  return yield* CodexClient.make(stdio, options, terminationError);
+});
diff --git a/packages/shared/package.json b/packages/shared/package.json
index eeaa5f59e087..9b6e7e6a47f5 100644
--- a/packages/shared/package.json
+++ b/packages/shared/package.json
@@ -3,6 +3,10 @@
   "private": true,
   "type": "module",
   "exports": {
+    "./Array": {
+      "types": "./src/Array.ts",
+      "import": "./src/Array.ts"
+    },
     "./themePalettes": {
       "types": "./src/themePalettes.ts",
       "import": "./src/themePalettes.ts"
@@ -79,6 +83,10 @@
       "types": "./src/toolActivity.ts",
       "import": "./src/toolActivity.ts"
     },
+    "./t3McpToolPresentation": {
+      "types": "./src/t3McpToolPresentation.ts",
+      "import": "./src/t3McpToolPresentation.ts"
+    },
     "./Struct": {
       "types": "./src/Struct.ts",
       "import": "./src/Struct.ts"
@@ -111,6 +119,14 @@
       "types": "./src/orchestrationTiming.ts",
       "import": "./src/orchestrationTiming.ts"
     },
+    "./orchestrationV2Timeline": {
+      "types": "./src/orchestrationV2Timeline.ts",
+      "import": "./src/orchestrationV2Timeline.ts"
+    },
+    "./orchestrationV2PendingBackgroundWork": {
+      "types": "./src/orchestrationV2PendingBackgroundWork.ts",
+      "import": "./src/orchestrationV2PendingBackgroundWork.ts"
+    },
     "./remote": {
       "types": "./src/remote.ts",
       "import": "./src/remote.ts"
diff --git a/packages/shared/src/Array.test.ts b/packages/shared/src/Array.test.ts
new file mode 100644
index 000000000000..ab4440ca6e35
--- /dev/null
+++ b/packages/shared/src/Array.test.ts
@@ -0,0 +1,12 @@
+import { describe, expect, it } from "vite-plus/test";
+
+import { copySorted } from "./Array.ts";
+
+describe("array copies", () => {
+  it("sorts a copy without mutating the source", () => {
+    const source = [3, 1, 2];
+
+    expect(copySorted(source, (left: number, right: number) => left - right)).toEqual([1, 2, 3]);
+    expect(source).toEqual([3, 1, 2]);
+  });
+});
diff --git a/packages/shared/src/Array.ts b/packages/shared/src/Array.ts
new file mode 100644
index 000000000000..dea902cfc47e
--- /dev/null
+++ b/packages/shared/src/Array.ts
@@ -0,0 +1,6 @@
+export function copySorted<T>(
+  values: ReadonlyArray<T>,
+  compareFn?: (left: T, right: T) => number,
+): T[] {
+  return [...values].sort(compareFn);
+}
diff --git a/packages/shared/src/agentAwareness.test.ts b/packages/shared/src/agentAwareness.test.ts
index 28e07c04e6f3..05f35fda7146 100644
--- a/packages/shared/src/agentAwareness.test.ts
+++ b/packages/shared/src/agentAwareness.test.ts
@@ -2,179 +2,86 @@ import { describe, expect, it } from "@effect/vitest";
 
 import type {
   EnvironmentId,
-  OrchestrationProjectShell,
-  OrchestrationThreadShell,
+  OrchestrationV2ThreadShell,
+  Project,
   ThreadId,
-  TurnId,
 } from "@t3tools/contracts";
-import { ProviderInstanceId } from "@t3tools/contracts";
+import { ProviderInstanceId, RuntimeRequestId } from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
 
-import { projectThreadAwareness } from "./agentAwareness.ts";
+import { projectThreadAwarenessV2 } from "./agentAwareness.ts";
 
 const NOW = "2026-05-22T12:00:00.000Z";
 
 const project = {
   title: "t3code",
-} satisfies Pick<OrchestrationProjectShell, "title">;
-
-function thread(
-  overrides: Partial<OrchestrationThreadShell> = {},
-): Pick<
-  OrchestrationThreadShell,
-  | "id"
-  | "title"
-  | "modelSelection"
-  | "session"
-  | "latestTurn"
-  | "updatedAt"
-  | "hasPendingApprovals"
-  | "hasPendingUserInput"
-> {
-  return {
-    id: "thread-1" as ThreadId,
-    title: "Fix failing CI",
+} satisfies Pick<Project, "title">;
+
+describe("projectThreadAwarenessV2", () => {
+  const updatedAt = DateTime.makeUnsafe(NOW);
+  const v2Thread = (
+    overrides: Partial<
+      Pick<OrchestrationV2ThreadShell, "activityRunStatus" | "status" | "pendingRuntimeRequest">
+    > = {},
+  ) => ({
+    id: "thread-2" as ThreadId,
+    title: "Integrate orchestration",
     modelSelection: { instanceId: ProviderInstanceId.make("codex"), model: "gpt-5.4" },
-    session: null,
-    latestTurn: null,
-    updatedAt: NOW,
-    hasPendingApprovals: false,
-    hasPendingUserInput: false,
+    status: "running" as const,
+    pendingRuntimeRequest: null,
+    updatedAt,
     ...overrides,
-  };
-}
+  });
 
-describe("projectThreadAwareness", () => {
-  it("returns null for idle threads without an active awareness state", () => {
+  it("projects V2 run state", () => {
     expect(
-      projectThreadAwareness({
+      projectThreadAwarenessV2({
         environmentId: "env-1" as EnvironmentId,
         project,
-        thread: thread(),
-      }),
-    ).toBeNull();
-  });
-
-  it("prioritizes approval requests over running state", () => {
-    const state = projectThreadAwareness({
-      environmentId: "env-1" as EnvironmentId,
-      project,
-      thread: thread({
-        hasPendingApprovals: true,
-        session: {
-          threadId: "thread-1" as ThreadId,
-          status: "running",
-          providerName: "Codex",
-          runtimeMode: "full-access",
-          activeTurnId: "turn-1" as TurnId,
-          lastError: null,
-          updatedAt: NOW,
-        },
+        thread: v2Thread(),
       }),
-    });
-
-    expect(state?.phase).toBe("waiting_for_approval");
-    expect(state?.headline).toBe("Approval needed");
+    ).toMatchObject({ phase: "running", headline: "Agent is working" });
   });
 
-  it("projects running provider sessions", () => {
-    const state = projectThreadAwareness({
-      environmentId: "env-1" as EnvironmentId,
-      project,
-      thread: thread({
-        session: {
-          threadId: "thread-1" as ThreadId,
-          status: "running",
-          providerName: "Codex",
-          runtimeMode: "full-access",
-          activeTurnId: "turn-1" as TurnId,
-          lastError: null,
-          updatedAt: NOW,
-        },
+  it("keeps an older activity run visible over a newer cancelled run", () => {
+    expect(
+      projectThreadAwarenessV2({
+        environmentId: "env-1" as EnvironmentId,
+        project,
+        thread: v2Thread({ status: "cancelled", activityRunStatus: "running" }),
       }),
-    });
-
-    expect(state).toMatchObject({
-      phase: "running",
-      headline: "Agent is working",
-      detail: "Codex is active.",
-      modelTitle: "gpt-5.4",
-      deepLink: "/threads/env-1/thread-1",
-    });
-  });
-
-  it("projects completed turns as completed even when teardown settled them as interrupted", () => {
-    const finishedTurn = {
-      turnId: "turn-1" as TurnId,
-      state: "interrupted" as const,
-      requestedAt: NOW,
-      startedAt: NOW,
-      completedAt: NOW,
-      assistantMessageId: null,
-    };
-    const state = projectThreadAwareness({
-      environmentId: "env-1" as EnvironmentId,
-      project,
-      thread: thread({ latestTurn: finishedTurn }),
-    });
-
-    // Session teardown settles still-running turns by session status, and
-    // that write can race turn.completed; the completion timestamp is the
-    // durable signal. Without this the thread resolves to null persistently
-    // and gets tombstoned off the lock-screen card instead of showing Done.
-    expect(state?.phase).toBe("completed");
-
-    const trulyInterrupted = projectThreadAwareness({
-      environmentId: "env-1" as EnvironmentId,
-      project,
-      thread: thread({ latestTurn: { ...finishedTurn, completedAt: null } }),
-    });
-    expect(trulyInterrupted).toBeNull();
+    ).toMatchObject({ phase: "running", headline: "Agent is working" });
   });
 
-  it("projects ready sessions with no materialized turn as completed", () => {
-    // Quick threads without code changes never get a checkpoint, so the SQL
-    // shell has no latestTurn row and latest_turn_id is cleared when the
-    // session settles; the ready session is the only completion signal left.
-    const state = projectThreadAwareness({
-      environmentId: "env-1" as EnvironmentId,
-      project,
-      thread: thread({
-        session: {
-          threadId: "thread-1" as ThreadId,
-          status: "ready",
-          providerName: "Codex",
-          runtimeMode: "full-access",
-          activeTurnId: null,
-          lastError: null,
-          updatedAt: NOW,
-        },
+  it("prioritizes V2 user-input requests", () => {
+    expect(
+      projectThreadAwarenessV2({
+        environmentId: "env-1" as EnvironmentId,
+        project,
+        thread: v2Thread({
+          pendingRuntimeRequest: {
+            id: RuntimeRequestId.make("request-1"),
+            kind: "user_input",
+            createdAt: updatedAt,
+          },
+        }),
       }),
-    });
-
-    expect(state?.phase).toBe("completed");
+    ).toMatchObject({ phase: "waiting_for_input", headline: "Waiting for input" });
   });
 
-  it("projects failures with the session error detail", () => {
-    const state = projectThreadAwareness({
-      environmentId: "env-1" as EnvironmentId,
-      project,
-      thread: thread({
-        session: {
-          threadId: "thread-1" as ThreadId,
-          status: "error",
-          providerName: "Codex",
-          runtimeMode: "full-access",
-          activeTurnId: null,
-          lastError: "Provider process exited.",
-          updatedAt: NOW,
-        },
+  it("does not present authentication refreshes as user approvals", () => {
+    expect(
+      projectThreadAwarenessV2({
+        environmentId: "env-1" as EnvironmentId,
+        project,
+        thread: v2Thread({
+          pendingRuntimeRequest: {
+            id: RuntimeRequestId.make("request-auth-refresh"),
+            kind: "auth_refresh",
+            createdAt: updatedAt,
+          },
+        }),
       }),
-    });
-
-    expect(state).toMatchObject({
-      phase: "failed",
-      headline: "Agent failed",
-      detail: "Provider process exited.",
-    });
+    ).toMatchObject({ phase: "running", headline: "Agent is working" });
   });
 });
diff --git a/packages/shared/src/agentAwareness.ts b/packages/shared/src/agentAwareness.ts
index c0f5842eb7c5..386f6c6e9cb0 100644
--- a/packages/shared/src/agentAwareness.ts
+++ b/packages/shared/src/agentAwareness.ts
@@ -1,9 +1,10 @@
 import type {
   EnvironmentId,
-  OrchestrationProjectShell,
-  OrchestrationThreadShell,
+  OrchestrationV2ThreadShell,
+  Project,
   ThreadId,
 } from "@t3tools/contracts";
+import * as DateTime from "effect/DateTime";
 
 export type AgentAwarenessPhase =
   | "starting"
@@ -27,39 +28,43 @@ export interface AgentAwarenessState {
   readonly deepLink: string;
 }
 
-export interface ProjectThreadAwarenessInput {
+export function buildAgentAwarenessDeepLink(input: {
   readonly environmentId: EnvironmentId;
-  readonly project: Pick<OrchestrationProjectShell, "title">;
+  readonly threadId: ThreadId;
+}): string {
+  return `/threads/${encodeURIComponent(input.environmentId)}/${encodeURIComponent(input.threadId)}`;
+}
+
+export interface ProjectThreadAwarenessV2Input {
+  readonly environmentId: EnvironmentId;
+  readonly project: Pick<Project, "title">;
   readonly thread: Pick<
-    OrchestrationThreadShell,
+    OrchestrationV2ThreadShell,
+    | "activityRunStatus"
     | "id"
-    | "title"
     | "modelSelection"
-    | "session"
-    | "latestTurn"
+    | "pendingRuntimeRequest"
+    | "status"
+    | "title"
     | "updatedAt"
-    | "hasPendingApprovals"
-    | "hasPendingUserInput"
   >;
 }
 
-export function buildAgentAwarenessDeepLink(input: {
-  readonly environmentId: EnvironmentId;
-  readonly threadId: ThreadId;
-}): string {
-  return `/threads/${encodeURIComponent(input.environmentId)}/${encodeURIComponent(input.threadId)}`;
-}
-
-export function projectThreadAwareness(
-  input: ProjectThreadAwarenessInput,
+/** Build relay activity directly from the V2 shell projection. */
+export function projectThreadAwarenessV2(
+  input: ProjectThreadAwarenessV2Input,
 ): AgentAwarenessState | null {
   const { environmentId, project, thread } = input;
-  const phase = resolveThreadAwarenessPhase(thread);
-  if (!phase) {
+  const phase = resolveThreadAwarenessPhaseV2(thread);
+  if (phase === null) {
     return null;
   }
-
-  const detail = detailForPhase(phase, thread);
+  const detail =
+    phase === "completed"
+      ? "Review the completed task."
+      : phase === "failed"
+        ? "The agent run failed."
+        : undefined;
   return {
     environmentId,
     threadId: thread.id,
@@ -69,51 +74,41 @@ export function projectThreadAwareness(
     headline: headlineForPhase(phase),
     ...(detail === undefined ? {} : { detail }),
     modelTitle: thread.modelSelection.model,
-    updatedAt: thread.updatedAt,
+    updatedAt: DateTime.formatIso(thread.updatedAt),
     deepLink: buildAgentAwarenessDeepLink({ environmentId, threadId: thread.id }),
   };
 }
 
-function resolveThreadAwarenessPhase(
-  thread: ProjectThreadAwarenessInput["thread"],
+function resolveThreadAwarenessPhaseV2(
+  thread: ProjectThreadAwarenessV2Input["thread"],
 ): AgentAwarenessPhase | null {
-  if (thread.hasPendingApprovals) {
-    return "waiting_for_approval";
-  }
-  if (thread.hasPendingUserInput) {
+  if (thread.pendingRuntimeRequest?.kind === "user_input") {
     return "waiting_for_input";
   }
-  if (thread.session?.status === "error" || thread.latestTurn?.state === "error") {
-    return "failed";
-  }
-  if (thread.session?.status === "starting") {
-    return "starting";
-  }
-  if (thread.session?.status === "running" || thread.latestTurn?.state === "running") {
-    return "running";
-  }
-  if (thread.latestTurn?.state === "completed") {
-    return "completed";
-  }
-  // A turn that finished can still read as "interrupted" here: session
-  // teardown settles still-running turns by session status, and that write
-  // can race the turn.completed one. completedAt survives the race — a turn
-  // that has a completion timestamp finished, whatever the state column says.
-  // Without this, quick finish-then-teardown threads resolve to null
-  // persistently and get tombstoned instead of published as completed.
-  if (thread.latestTurn?.state === "interrupted" && thread.latestTurn.completedAt !== null) {
-    return "completed";
+  if (
+    thread.pendingRuntimeRequest !== null &&
+    thread.pendingRuntimeRequest.kind !== "auth_refresh"
+  ) {
+    return "waiting_for_approval";
   }
-  // Threads whose turns never produce a checkpoint (no code changes) have no
-  // materialized latestTurn in the shell at all, and the session-set
-  // projection clears latest_turn_id the moment the session settles. The
-  // session status is then the only surviving completion signal: a live
-  // session at "ready"/"idle" with nothing pending and nothing running means
-  // the agent finished and is waiting for the next prompt — Done.
-  if (thread.session?.status === "ready" || thread.session?.status === "idle") {
-    return "completed";
+  switch (thread.activityRunStatus ?? thread.status) {
+    case "preparing":
+    case "starting":
+      return "starting";
+    case "running":
+    case "waiting":
+      return "running";
+    case "completed":
+      return "completed";
+    case "failed":
+      return "failed";
+    case "idle":
+    case "queued":
+    case "interrupted":
+    case "cancelled":
+    case "rolled_back":
+      return null;
   }
-  return null;
 }
 
 function headlineForPhase(phase: AgentAwarenessPhase): string {
@@ -134,19 +129,3 @@ function headlineForPhase(phase: AgentAwarenessPhase): string {
       return "Update delayed";
   }
 }
-
-function detailForPhase(
-  phase: AgentAwarenessPhase,
-  thread: ProjectThreadAwarenessInput["thread"],
-): string | undefined {
-  if (phase === "failed") {
-    return thread.session?.lastError ?? undefined;
-  }
-  if (phase === "completed") {
-    return "Review the completed task.";
-  }
-  if (phase === "running" && thread.session?.providerName) {
-    return `${thread.session.providerName} is active.`;
-  }
-  return undefined;
-}
diff --git a/packages/shared/src/model.test.ts b/packages/shared/src/model.test.ts
index bf54a4ea7fa0..279a97cf0e00 100644
--- a/packages/shared/src/model.test.ts
+++ b/packages/shared/src/model.test.ts
@@ -13,6 +13,7 @@ import {
   getProviderOptionStringSelectionValue,
   normalizeCustomModelSlug,
   normalizeModelSlug,
+  modelSelectionsEqual,
 } from "./model.ts";
 
 const codexCaps: ModelCapabilities = createModelCapabilities({
@@ -35,6 +36,15 @@ const codexCaps: ModelCapabilities = createModelCapabilities({
   ],
 });
 
+describe("model slug normalization", () => {
+  it("preserves exact custom slugs instead of expanding provider aliases", () => {
+    const claude = ProviderDriverKind.make("claudeAgent");
+
+    expect(normalizeModelSlug("opus", claude)).toBe("claude-opus-5");
+    expect(normalizeCustomModelSlug(" opus ")).toBe("opus");
+  });
+});
+
 const claudeCaps: ModelCapabilities = createModelCapabilities({
   optionDescriptors: [
     {
@@ -146,14 +156,28 @@ describe("descriptor helpers", () => {
     expect(getModelSelectionStringOptionValue(selection, "reasoningEffort")).toBe("high");
     expect(getModelSelectionBooleanOptionValue(selection, "fastMode")).toBe(true);
   });
-});
 
-describe("model slug normalization", () => {
-  it("preserves exact custom slugs instead of expanding provider aliases", () => {
-    const claude = ProviderDriverKind.make("claudeAgent");
+  it("compares complete model selections independent of option ordering", () => {
+    const left = createModelSelection(ProviderInstanceId.make("codex"), "gpt-5.4", [
+      { id: "reasoningEffort", value: "high" },
+      { id: "fastMode", value: true },
+    ]);
+    const reordered = createModelSelection(ProviderInstanceId.make("codex"), "gpt-5.4", [
+      { id: "fastMode", value: true },
+      { id: "reasoningEffort", value: "high" },
+    ]);
 
-    expect(normalizeModelSlug("opus", claude)).toBe("claude-opus-5");
-    expect(normalizeCustomModelSlug(" opus ")).toBe("opus");
+    expect(modelSelectionsEqual(left, reordered)).toBe(true);
+    expect(
+      modelSelectionsEqual(left, {
+        ...reordered,
+        options: [
+          { id: "fastMode", value: true },
+          { id: "reasoningEffort", value: "medium" },
+        ],
+      }),
+    ).toBe(false);
+    expect(modelSelectionsEqual(left, { ...reordered, model: "gpt-5.5" })).toBe(false);
   });
 });
 
diff --git a/packages/shared/src/model.ts b/packages/shared/src/model.ts
index 3e47de3fb1d9..9cced36c1500 100644
--- a/packages/shared/src/model.ts
+++ b/packages/shared/src/model.ts
@@ -9,6 +9,7 @@ import {
   type ProviderOptionDescriptor,
   type ProviderOptionSelection,
 } from "@t3tools/contracts";
+import { copySorted } from "./Array.ts";
 
 const DEFAULT_PROVIDER_DRIVER_KIND = ProviderDriverKind.make("codex");
 
@@ -77,6 +78,44 @@ export function getModelSelectionBooleanOptionValue(
   return getProviderOptionBooleanSelectionValue(modelSelection?.options, id);
 }
 
+function canonicalModelSelectionOptions(
+  modelSelection: ModelSelection,
+): ReadonlyArray<readonly [id: string, value: string | boolean]> {
+  return copySorted(
+    (modelSelection.options ?? []).map(
+      (selection): readonly [id: string, value: string | boolean] => [
+        selection.id,
+        selection.value,
+      ],
+    ),
+    (
+      [leftId, leftValue]: readonly [id: string, value: string | boolean],
+      [rightId, rightValue]: readonly [id: string, value: string | boolean],
+    ) => {
+      const idOrder = leftId.localeCompare(rightId);
+      return idOrder !== 0 ? idOrder : String(leftValue).localeCompare(String(rightValue));
+    },
+  );
+}
+
+/**
+ * Compares the complete provider selection while treating option ordering and
+ * an omitted empty option list as presentation details.
+ */
+export function modelSelectionsEqual(left: ModelSelection, right: ModelSelection): boolean {
+  if (left.instanceId !== right.instanceId || left.model !== right.model) {
+    return false;
+  }
+  const leftOptions = canonicalModelSelectionOptions(left);
+  const rightOptions = canonicalModelSelectionOptions(right);
+  return (
+    leftOptions.length === rightOptions.length &&
+    leftOptions.every(
+      ([id, value], index) => id === rightOptions[index]?.[0] && value === rightOptions[index]?.[1],
+    )
+  );
+}
+
 function resolveDescriptorChoiceValue(
   descriptor: Extract<ProviderOptionDescriptor, { type: "select" }>,
   raw: string | null | undefined,
diff --git a/packages/shared/src/orchestrationTiming.ts b/packages/shared/src/orchestrationTiming.ts
index 6914e1320d32..ec44464aaf9f 100644
--- a/packages/shared/src/orchestrationTiming.ts
+++ b/packages/shared/src/orchestrationTiming.ts
@@ -1,12 +1,12 @@
-type LatestTurnTiming = {
-  readonly turnId: string | null;
+type LatestRunTiming = {
+  readonly runId: string | null;
   readonly startedAt: string | null;
   readonly completedAt: string | null;
 };
 
-type SessionActivityState = {
+type RuntimeActivityState = {
   readonly orchestrationStatus: string;
-  readonly activeTurnId?: string | null;
+  readonly activeRunId?: string | null;
 };
 
 export function formatDuration(durationMs: number): string {
@@ -31,24 +31,24 @@ export function formatElapsed(startIso: string, endIso: string | undefined): str
   return formatDuration(endedAt - startedAt);
 }
 
-export function isLatestTurnSettled(
-  latestTurn: LatestTurnTiming | null,
-  session: SessionActivityState | null,
+export function isLatestRunSettled(
+  latestRun: LatestRunTiming | null,
+  runtime: RuntimeActivityState | null,
 ): boolean {
-  if (!latestTurn?.startedAt) return false;
-  if (!latestTurn.completedAt) return false;
-  if (!session) return true;
-  if (session.orchestrationStatus === "running") return false;
+  if (!latestRun?.startedAt) return false;
+  if (!latestRun.completedAt) return false;
+  if (!runtime) return true;
+  if (runtime.orchestrationStatus === "running") return false;
   return true;
 }
 
 export function deriveActiveWorkStartedAt(
-  latestTurn: LatestTurnTiming | null,
-  session: SessionActivityState | null,
+  latestRun: LatestRunTiming | null,
+  runtime: RuntimeActivityState | null,
   sendStartedAt: string | null,
 ): string | null {
-  if (!isLatestTurnSettled(latestTurn, session)) {
-    return latestTurn?.startedAt ?? sendStartedAt;
+  if (!isLatestRunSettled(latestRun, runtime)) {
+    return latestRun?.startedAt ?? sendStartedAt;
   }
   return sendStartedAt;
 }
diff --git a/packages/shared/src/orchestrationV2PendingBackgroundWork.test.ts b/packages/shared/src/orchestrationV2PendingBackgroundWork.test.ts
new file mode 100644
index 000000000000..1c9970bb8cea
--- /dev/null
+++ b/packages/shared/src/orchestrationV2PendingBackgroundWork.test.ts
@@ -0,0 +1,432 @@
+import { describe, expect, it } from "vite-plus/test";
+import {
+  derivePendingBackgroundWork,
+  formatPendingBackgroundWorkLabel,
+} from "./orchestrationV2PendingBackgroundWork.ts";
+
+describe("derivePendingBackgroundWork", () => {
+  it("returns empty while the latest run is not settled", () => {
+    const tasks = derivePendingBackgroundWork({
+      latestRun: { id: "run-1" as never, ordinal: 1, status: "running" },
+      providerThreads: [
+        {
+          id: "pt-1" as never,
+          pendingBackgroundTasks: [{ taskId: "bg-1", description: "sleep 20" }],
+        },
+      ],
+      turnItems: [
+        {
+          id: "item-1" as never,
+          type: "command_execution",
+          status: "running",
+          title: "npm test",
+          nativeItemRef: null,
+          input: "npm test",
+        },
+      ],
+    });
+    expect(tasks).toEqual([]);
+  });
+
+  it("returns pending work when the latest run is waiting (post-success, pre-checkpoint)", () => {
+    const tasks = derivePendingBackgroundWork({
+      latestRun: { id: "run-1" as never, ordinal: 1, status: "waiting" },
+      providerThreads: [{ id: "pt-1" as never }],
+      turnItems: [
+        {
+          id: "item-1" as never,
+          type: "command_execution",
+          status: "running",
+          title: "npm test",
+          nativeItemRef: { nativeId: "cmd-1" },
+          input: "npm test",
+        },
+      ],
+    });
+    expect(tasks).toEqual([
+      { taskId: "cmd-1", description: "npm test", taskType: "command_execution" },
+    ]);
+  });
+
+  it("still returns empty when the latest run is running even with background items", () => {
+    const tasks = derivePendingBackgroundWork({
+      latestRun: { id: "run-1" as never, ordinal: 1, status: "running" },
+      providerThreads: [
+        {
+          id: "pt-1" as never,
+          pendingBackgroundTasks: [{ taskId: "bg-1", description: "sleep 20" }],
+        },
+      ],
+      turnItems: [
+        {
+          id: "item-1" as never,
+          type: "subagent",
+          status: "running",
+          title: "review",
+          nativeItemRef: { nativeId: "sub-1" },
+          prompt: "review",
+        },
+      ],
+    });
+    expect(tasks).toEqual([]);
+  });
+
+  it("excludes rolled_back items when the latest run is waiting", () => {
+    const tasks = derivePendingBackgroundWork({
+      latestRun: { id: "run-2" as never, ordinal: 2, status: "waiting" },
+      providerThreads: [{ id: "pt-1" as never }],
+      runs: [
+        { id: "run-1" as never, ordinal: 1, status: "rolled_back" },
+        { id: "run-2" as never, ordinal: 2, status: "waiting" },
+      ],
+      turnItems: [
+        {
+          id: "item-old" as never,
+          type: "command_execution",
+          status: "running",
+          title: "from rolled-back run",
+          runId: "run-1",
+          nativeItemRef: { nativeId: "cmd-old" },
+          input: "sleep 99",
+        },
+        {
+          id: "item-new" as never,
+          type: "command_execution",
+          status: "running",
+          title: "still pending",
+          runId: "run-2",
+          nativeItemRef: { nativeId: "cmd-new" },
+          input: "npm test",
+        },
+      ],
+    });
+    expect(tasks).toEqual([
+      { taskId: "cmd-new", description: "still pending", taskType: "command_execution" },
+    ]);
+  });
+
+  it("returns the provider-thread roster after settlement", () => {
+    const tasks = derivePendingBackgroundWork({
+      latestRun: { id: "run-1" as never, ordinal: 1, status: "completed" },
+      providerThreads: [
+        {
+          id: "pt-1" as never,
+          pendingBackgroundTasks: [
+            { taskId: "bg-1", description: "Run Codex review", taskType: "local_bash" },
+          ],
+        },
+      ],
+      turnItems: [],
+      activeProviderThreadId: "pt-1",
+    });
+    expect(tasks).toEqual([
+      { taskId: "bg-1", description: "Run Codex review", taskType: "local_bash" },
+    ]);
+  });
+
+  it("includes nonterminal turn items and excludes completed ones", () => {
+    const tasks = derivePendingBackgroundWork({
+      latestRun: { id: "run-1" as never, ordinal: 1, status: "completed" },
+      providerThreads: [{ id: "pt-1" as never }],
+      turnItems: [
+        {
+          id: "item-1" as never,
+          type: "command_execution",
+          status: "running",
+          title: "npm test",
+          nativeItemRef: { nativeId: "cmd-1" },
+          input: "npm test",
+        },
+        {
+          id: "item-2" as never,
+          type: "command_execution",
+          status: "completed",
+          title: "done",
+          nativeItemRef: { nativeId: "cmd-2" },
+          input: "echo done",
+        },
+      ],
+    });
+    expect(tasks).toEqual([
+      { taskId: "cmd-1", description: "npm test", taskType: "command_execution" },
+    ]);
+  });
+
+  it("trims normalized background-work descriptions", () => {
+    const base = {
+      latestRun: { id: "run-1" as never, ordinal: 1, status: "completed" as const },
+      providerThreads: [
+        {
+          id: "pt-1" as never,
+          pendingBackgroundTasks: [
+            {
+              taskId: "native-task",
+              description: "  native background work  ",
+            },
+          ],
+        },
+      ],
+    };
+    expect(
+      derivePendingBackgroundWork({
+        ...base,
+        turnItems: [
+          {
+            id: "item-command" as never,
+            type: "command_execution",
+            status: "running",
+            title: "  npm test  ",
+            nativeItemRef: null,
+          },
+          {
+            id: "item-tool" as never,
+            type: "dynamic_tool",
+            status: "running",
+            title: null,
+            nativeItemRef: null,
+            toolName: "  browser.search  ",
+          } as never,
+        ],
+      }),
+    ).toEqual([
+      {
+        taskId: "native-task",
+        description: "native background work",
+      },
+      {
+        taskId: "item-command",
+        description: "npm test",
+        taskType: "command_execution",
+      },
+      {
+        taskId: "item-tool",
+        description: "browser.search",
+        taskType: "dynamic_tool",
+      },
+    ]);
+  });
+
+  it("dedupes roster entries against turn items by native task id", () => {
+    const tasks = derivePendingBackgroundWork({
+      latestRun: { id: "run-1" as never, ordinal: 1, status: "completed" },
+      providerThreads: [
+        {
+          id: "pt-1" as never,
+          pendingBackgroundTasks: [{ taskId: "task-9", description: "Agent review" }],
+        },
+      ],
+      turnItems: [
+        {
+          id: "item-sub" as never,
+          type: "subagent",
+          status: "running",
+          title: "Agent review",
+          nativeItemRef: { nativeId: "task-9" },
+          prompt: "review the plan",
+        },
+      ],
+    });
+    expect(tasks).toEqual([{ taskId: "task-9", description: "Agent review" }]);
+  });
+
+  it("excludes Grok persistent monitors", () => {
+    const tasks = derivePendingBackgroundWork({
+      latestRun: { id: "run-1" as never, ordinal: 1, status: "completed" },
+      providerThreads: [{ id: "pt-1" as never }],
+      turnItems: [
+        {
+          id: "item-1" as never,
+          type: "dynamic_tool",
+          status: "running",
+          title: "monitor logs",
+          nativeItemRef: { nativeId: "mon-1" },
+          input: { persistent: true, command: "tail -f" },
+        },
+        {
+          id: "item-2" as never,
+          type: "dynamic_tool",
+          status: "running",
+          title: "finite monitor",
+          nativeItemRef: { nativeId: "mon-2" },
+          input: { persistent: false, command: "sleep 5" },
+        },
+      ],
+    });
+    expect(tasks).toEqual([
+      { taskId: "mon-2", description: "finite monitor", taskType: "dynamic_tool" },
+    ]);
+  });
+
+  it("returns multiple tasks with stable ordering from insertion", () => {
+    const tasks = derivePendingBackgroundWork({
+      latestRun: { id: "run-1" as never, ordinal: 1, status: "completed" },
+      providerThreads: [
+        {
+          id: "pt-1" as never,
+          pendingBackgroundTasks: [
+            { taskId: "bg-1", description: "first" },
+            { taskId: "bg-2", description: "second" },
+          ],
+        },
+      ],
+      turnItems: [
+        {
+          id: "item-1" as never,
+          type: "command_execution",
+          status: "running",
+          title: "third",
+          nativeItemRef: { nativeId: "cmd-3" },
+          input: "third",
+        },
+      ],
+    });
+    expect(tasks.map((task) => task.taskId)).toEqual(["bg-1", "bg-2", "cmd-3"]);
+  });
+
+  it("excludes turn items owned by a rolled_back run", () => {
+    const tasks = derivePendingBackgroundWork({
+      latestRun: { id: "run-1" as never, ordinal: 1, status: "rolled_back" },
+      providerThreads: [{ id: "pt-1" as never }],
+      runs: [{ id: "run-1" as never, ordinal: 1, status: "rolled_back" }],
+      turnItems: [
+        {
+          id: "item-1" as never,
+          type: "command_execution",
+          status: "running",
+          title: "abandoned",
+          runId: "run-1",
+          nativeItemRef: { nativeId: "cmd-1" },
+          input: "sleep 99",
+        },
+      ],
+    });
+    expect(tasks).toEqual([]);
+  });
+
+  it("returns empty when the latest run is rolled_back even with a nonempty roster", () => {
+    const tasks = derivePendingBackgroundWork({
+      latestRun: { id: "run-1" as never, ordinal: 1, status: "rolled_back" },
+      providerThreads: [
+        {
+          id: "pt-1" as never,
+          pendingBackgroundTasks: [{ taskId: "bg-1", description: "sleep 20" }],
+        },
+      ],
+      turnItems: [
+        {
+          id: "item-1" as never,
+          type: "command_execution",
+          status: "running",
+          title: "abandoned",
+          runId: "run-1",
+          nativeItemRef: { nativeId: "cmd-1" },
+          input: "sleep 99",
+        },
+      ],
+    });
+    expect(tasks).toEqual([]);
+  });
+
+  it("excludes an older rolled_back nonterminal item when the latest run is completed", () => {
+    const tasks = derivePendingBackgroundWork({
+      latestRun: { id: "run-2" as never, ordinal: 2, status: "completed" },
+      providerThreads: [{ id: "pt-1" as never }],
+      runs: [
+        { id: "run-1" as never, ordinal: 1, status: "rolled_back" },
+        { id: "run-2" as never, ordinal: 2, status: "completed" },
+      ],
+      turnItems: [
+        {
+          id: "item-old" as never,
+          type: "command_execution",
+          status: "running",
+          title: "from rolled-back run",
+          runId: "run-1",
+          nativeItemRef: { nativeId: "cmd-old" },
+          input: "sleep 99",
+        },
+        {
+          id: "item-new" as never,
+          type: "command_execution",
+          status: "running",
+          title: "still pending",
+          runId: "run-2",
+          nativeItemRef: { nativeId: "cmd-new" },
+          input: "npm test",
+        },
+      ],
+    });
+    expect(tasks).toEqual([
+      { taskId: "cmd-new", description: "still pending", taskType: "command_execution" },
+    ]);
+  });
+
+  it("does not reclassify an older active run as background work", () => {
+    const tasks = derivePendingBackgroundWork({
+      latestRun: { id: "run-2" as never, ordinal: 2, status: "cancelled" },
+      providerThreads: [
+        {
+          id: "pt-1" as never,
+          pendingBackgroundTasks: [{ taskId: "provider-task" }],
+        },
+      ],
+      runs: [
+        { id: "run-1" as never, ordinal: 1, status: "running" },
+        { id: "run-2" as never, ordinal: 2, status: "cancelled" },
+      ],
+      turnItems: [
+        {
+          id: "item-active" as never,
+          type: "command_execution",
+          status: "running",
+          title: "foreground work",
+          runId: "run-1",
+          nativeItemRef: { nativeId: "cmd-active" },
+          input: "vp check",
+        },
+      ],
+    });
+
+    expect(tasks).toEqual([]);
+  });
+
+  it("includes items with a null run id even when runs list has rolled_back rows", () => {
+    const tasks = derivePendingBackgroundWork({
+      latestRun: { id: "run-1" as never, ordinal: 1, status: "completed" },
+      providerThreads: [{ id: "pt-1" as never }],
+      runs: [{ id: "run-1" as never, ordinal: 1, status: "rolled_back" }],
+      turnItems: [
+        {
+          id: "item-null-run" as never,
+          type: "command_execution",
+          status: "running",
+          title: "orphan item",
+          runId: null,
+          nativeItemRef: { nativeId: "cmd-null" },
+          input: "echo orphan",
+        },
+      ],
+    });
+    expect(tasks).toEqual([
+      { taskId: "cmd-null", description: "orphan item", taskType: "command_execution" },
+    ]);
+  });
+});
+
+describe("formatPendingBackgroundWorkLabel", () => {
+  it("formats single and multi-task labels", () => {
+    expect(formatPendingBackgroundWorkLabel([])).toBeNull();
+    expect(formatPendingBackgroundWorkLabel([{ taskId: "a" }])).toBe(
+      "Waiting on a background task",
+    );
+    expect(
+      formatPendingBackgroundWorkLabel([{ taskId: "a", description: "Run Codex review" }]),
+    ).toBe("Waiting on background task: Run Codex review");
+    expect(
+      formatPendingBackgroundWorkLabel([
+        { taskId: "a", description: "first" },
+        { taskId: "b", description: "second" },
+      ]),
+    ).toBe("Waiting on 2 background tasks: first, …");
+  });
+});
diff --git a/packages/shared/src/orchestrationV2PendingBackgroundWork.ts b/packages/shared/src/orchestrationV2PendingBackgroundWork.ts
new file mode 100644
index 000000000000..779fc8857ec6
--- /dev/null
+++ b/packages/shared/src/orchestrationV2PendingBackgroundWork.ts
@@ -0,0 +1,238 @@
+import type {
+  OrchestrationV2PendingBackgroundTask,
+  OrchestrationV2ProviderThread,
+  OrchestrationV2Run,
+  OrchestrationV2TurnItem,
+} from "@t3tools/contracts";
+
+const BACKGROUND_TURN_ITEM_TYPES = new Set<OrchestrationV2TurnItem["type"]>([
+  "command_execution",
+  "dynamic_tool",
+  "subagent",
+]);
+
+const TERMINAL_TURN_ITEM_STATUSES = new Set<OrchestrationV2TurnItem["status"]>([
+  "completed",
+  "interrupted",
+  "failed",
+  "cancelled",
+]);
+
+/**
+ * True terminal run statuses (includes `rolled_back`). Retained as the
+ * canonical terminal set for this module; do not widen or reuse it as the
+ * background-wait gate — that gate intentionally excludes `rolled_back`.
+ */
+const TERMINAL_RUN_STATUSES = new Set<OrchestrationV2Run["status"]>([
+  "cancelled",
+  "completed",
+  "failed",
+  "interrupted",
+  "rolled_back",
+]);
+
+/**
+ * Run statuses that allow a pending-background roster to surface.
+ * Includes `waiting`: a successful turn persists as waiting until checkpoint
+ * capture flips it to completed, and waiting is only set from completed.
+ * Excludes `rolled_back`: the provider-thread roster is not run-tied, so a
+ * rolled-back latest run must fail the gate entirely (not only item filter).
+ * Built explicitly rather than spreading or deleting from TERMINAL_RUN_STATUSES.
+ */
+const SETTLED_FOR_BACKGROUND_WAIT_RUN_STATUSES = new Set<OrchestrationV2Run["status"]>([
+  "cancelled",
+  "completed",
+  "failed",
+  "interrupted",
+  "waiting",
+]);
+
+// Keep TERMINAL_RUN_STATUSES referenced so the true-terminal set stays defined
+// next to the background-wait subset (rolled_back is terminal, not wait-settled).
+void TERMINAL_RUN_STATUSES;
+
+export type PendingBackgroundWorkTask = OrchestrationV2PendingBackgroundTask;
+
+type PendingBackgroundWorkRun = Pick<OrchestrationV2Run, "id" | "ordinal" | "status">;
+
+type PendingBackgroundWorkProviderThread = Pick<
+  OrchestrationV2ProviderThread,
+  "id" | "pendingBackgroundTasks"
+>;
+
+type PendingBackgroundWorkTurnItem = {
+  readonly id: OrchestrationV2TurnItem["id"] | string;
+  readonly type: OrchestrationV2TurnItem["type"];
+  readonly status: OrchestrationV2TurnItem["status"];
+  readonly title: string | null;
+  /** When present and the run is rolled_back, the item is abandoned, not pending. */
+  readonly runId?: OrchestrationV2Run["id"] | string | null;
+  readonly nativeItemRef?: {
+    readonly nativeId: string | null;
+  } | null;
+  readonly input?: unknown;
+  readonly prompt?: string | undefined;
+};
+
+function isTerminalTurnItemStatus(status: OrchestrationV2TurnItem["status"]): boolean {
+  return TERMINAL_TURN_ITEM_STATUSES.has(status);
+}
+
+function isLatestRunSettledForBackgroundWait(
+  latestRun: PendingBackgroundWorkRun | null | undefined,
+): boolean {
+  if (latestRun === undefined || latestRun === null) {
+    return false;
+  }
+  return SETTLED_FOR_BACKGROUND_WAIT_RUN_STATUSES.has(latestRun.status);
+}
+
+function isPersistentDynamicToolInput(input: unknown): boolean {
+  if (input === null || typeof input !== "object" || Array.isArray(input)) {
+    return false;
+  }
+  return Reflect.get(input, "persistent") === true;
+}
+
+function descriptionFromTurnItem(item: PendingBackgroundWorkTurnItem): string | undefined {
+  if (typeof item.title === "string" && item.title.trim().length > 0) {
+    return item.title.trim();
+  }
+  if (item.type === "command_execution" && typeof item.input === "string") {
+    const command = item.input.trim();
+    return command.length > 0 ? command : undefined;
+  }
+  if (item.type === "dynamic_tool") {
+    const toolName = Reflect.get(item, "toolName");
+    if (typeof toolName === "string" && toolName.trim().length > 0) {
+      return toolName.trim();
+    }
+  }
+  if (item.type === "subagent" && typeof item.prompt === "string") {
+    const prompt = item.prompt.trim();
+    return prompt.length > 0 ? prompt : undefined;
+  }
+  return undefined;
+}
+
+function nativeTaskIdFromTurnItem(item: PendingBackgroundWorkTurnItem): string {
+  const nativeId = item.nativeItemRef?.nativeId;
+  if (typeof nativeId === "string" && nativeId.length > 0) {
+    return nativeId;
+  }
+  return String(item.id);
+}
+
+/**
+ * Derive one normalized pending-background-work list for post-settlement UI.
+ *
+ * Sources:
+ * - Provider-thread roster (Claude SDK background tasks)
+ * - Nonterminal command_execution / dynamic_tool / subagent turn items
+ *
+ * Gated on latest root run settlement. Dedupes by native task ID. Excludes
+ * the roster while any interruptible foreground run remains active. Excludes
+ * Grok persistent monitors (`dynamic_tool` input with `persistent: true`).
+ * Excludes turn items whose run resolves to `rolled_back` (abandoned work);
+ * items with a null or absent run id stay eligible (matches SQL shell path).
+ * Does not consult subagent entities (those double-count turn items).
+ */
+export function derivePendingBackgroundWork(input: {
+  readonly latestRun: PendingBackgroundWorkRun | null | undefined;
+  readonly providerThreads: ReadonlyArray<PendingBackgroundWorkProviderThread>;
+  readonly turnItems: ReadonlyArray<PendingBackgroundWorkTurnItem>;
+  readonly activeProviderThreadId?: string | null;
+  readonly hasActiveRun?: boolean;
+  /**
+   * Run rows used to exclude items owned by rolled_back runs. Optional for
+   * callers that already filtered (SQL shell path); in-memory callers should
+   * pass projection runs so policy cannot drift.
+   */
+  readonly runs?: ReadonlyArray<PendingBackgroundWorkRun>;
+}): ReadonlyArray<PendingBackgroundWorkTask> {
+  const hasActiveRun =
+    input.hasActiveRun ??
+    input.runs?.some(
+      (run) => run.status === "preparing" || run.status === "starting" || run.status === "running",
+    ) ??
+    false;
+  if (hasActiveRun) {
+    return [];
+  }
+  if (!isLatestRunSettledForBackgroundWait(input.latestRun)) {
+    return [];
+  }
+
+  const byTaskId = new Map<string, PendingBackgroundWorkTask>();
+  const rolledBackRunIds = new Set(
+    (input.runs ?? []).filter((run) => run.status === "rolled_back").map((run) => String(run.id)),
+  );
+
+  const providerThreads =
+    input.activeProviderThreadId === undefined || input.activeProviderThreadId === null
+      ? input.providerThreads
+      : input.providerThreads.filter((thread) => thread.id === input.activeProviderThreadId);
+
+  for (const providerThread of providerThreads) {
+    for (const task of providerThread.pendingBackgroundTasks ?? []) {
+      if (task.taskId.length === 0 || byTaskId.has(task.taskId)) {
+        continue;
+      }
+      const description = task.description?.trim();
+      byTaskId.set(task.taskId, {
+        taskId: task.taskId,
+        ...(description === undefined || description.length === 0 ? {} : { description }),
+        ...(task.taskType === undefined ? {} : { taskType: task.taskType }),
+      });
+    }
+  }
+
+  for (const item of input.turnItems) {
+    if (!BACKGROUND_TURN_ITEM_TYPES.has(item.type)) {
+      continue;
+    }
+    if (isTerminalTurnItemStatus(item.status)) {
+      continue;
+    }
+    if (item.type === "dynamic_tool" && isPersistentDynamicToolInput(item.input)) {
+      continue;
+    }
+    // Null/absent run id stays eligible; only known rolled_back runs drop.
+    const itemRunId = item.runId;
+    if (itemRunId !== undefined && itemRunId !== null && rolledBackRunIds.has(String(itemRunId))) {
+      continue;
+    }
+
+    const taskId = nativeTaskIdFromTurnItem(item);
+    if (byTaskId.has(taskId)) {
+      continue;
+    }
+
+    const description = descriptionFromTurnItem(item);
+    byTaskId.set(taskId, {
+      taskId,
+      ...(description === undefined ? {} : { description }),
+      taskType: item.type,
+    });
+  }
+
+  return Array.from(byTaskId.values());
+}
+
+export function formatPendingBackgroundWorkLabel(
+  tasks: ReadonlyArray<PendingBackgroundWorkTask>,
+): string | null {
+  if (tasks.length === 0) {
+    return null;
+  }
+  const firstDescription = tasks[0]?.description?.trim();
+  if (tasks.length === 1) {
+    return firstDescription && firstDescription.length > 0
+      ? `Waiting on background task: ${firstDescription}`
+      : "Waiting on a background task";
+  }
+  if (firstDescription && firstDescription.length > 0) {
+    return `Waiting on ${tasks.length} background tasks: ${firstDescription}, …`;
+  }
+  return `Waiting on ${tasks.length} background tasks`;
+}
diff --git a/packages/shared/src/orchestrationV2Timeline.test.ts b/packages/shared/src/orchestrationV2Timeline.test.ts
new file mode 100644
index 000000000000..ad4facd370a4
--- /dev/null
+++ b/packages/shared/src/orchestrationV2Timeline.test.ts
@@ -0,0 +1,110 @@
+import { NodeId, RunId } from "@t3tools/contracts";
+import { describe, expect, it } from "vite-plus/test";
+
+import { isOrchestrationV2TurnItemVisible } from "./orchestrationV2Timeline.ts";
+
+const runId = RunId.make("run:timeline-visibility");
+const nodeId = NodeId.make("node:timeline-visibility");
+
+describe("isOrchestrationV2TurnItemVisible", () => {
+  it("hides unpaired interruption results from superseded attempts", () => {
+    expect(
+      isOrchestrationV2TurnItemVisible({
+        item: { type: "run_interrupt_result", runId, nodeId },
+        runs: [{ id: runId, status: "running" }],
+        attempts: [{ runId, rootNodeId: nodeId, status: "superseded" }],
+        items: [{ type: "run_interrupt_result", runId, nodeId }],
+      }),
+    ).toBe(false);
+  });
+
+  it("keeps paired interruption results from superseded attempts", () => {
+    expect(
+      isOrchestrationV2TurnItemVisible({
+        item: { type: "run_interrupt_result", runId, nodeId },
+        runs: [{ id: runId, status: "running" }],
+        attempts: [{ runId, rootNodeId: nodeId, status: "superseded" }],
+        items: [
+          { type: "run_interrupt_request", runId, nodeId },
+          { type: "run_interrupt_result", runId, nodeId },
+        ],
+      }),
+    ).toBe(true);
+  });
+
+  it("keeps interruption results from terminal attempts without a request", () => {
+    expect(
+      isOrchestrationV2TurnItemVisible({
+        item: { type: "run_interrupt_result", runId, nodeId },
+        runs: [{ id: runId, status: "interrupted" }],
+        attempts: [{ runId, rootNodeId: nodeId, status: "interrupted" }],
+        items: [{ type: "run_interrupt_result", runId, nodeId }],
+      }),
+    ).toBe(true);
+  });
+
+  it("keeps interruption results from terminal attempts with a request", () => {
+    expect(
+      isOrchestrationV2TurnItemVisible({
+        item: { type: "run_interrupt_result", runId, nodeId },
+        runs: [{ id: runId, status: "interrupted" }],
+        attempts: [{ runId, rootNodeId: nodeId, status: "interrupted" }],
+        items: [
+          { type: "run_interrupt_request", runId, nodeId },
+          { type: "run_interrupt_result", runId, nodeId },
+        ],
+      }),
+    ).toBe(true);
+  });
+
+  it("hides queued user messages once their run is cancelled", () => {
+    expect(
+      isOrchestrationV2TurnItemVisible({
+        item: { type: "user_message", inputIntent: "queued_turn", runId, nodeId },
+        runs: [{ id: runId, status: "cancelled" }],
+        attempts: [],
+        items: [{ type: "user_message", inputIntent: "queued_turn", runId, nodeId }],
+      }),
+    ).toBe(false);
+  });
+
+  it("keeps queued user messages while their run is queued", () => {
+    expect(
+      isOrchestrationV2TurnItemVisible({
+        item: { type: "user_message", inputIntent: "queued_turn", runId, nodeId },
+        runs: [{ id: runId, status: "queued" }],
+        attempts: [],
+        items: [{ type: "user_message", inputIntent: "queued_turn", runId, nodeId }],
+      }),
+    ).toBe(true);
+  });
+
+  it("keeps non-queued user messages on cancelled runs", () => {
+    expect(
+      isOrchestrationV2TurnItemVisible({
+        item: { type: "user_message", inputIntent: "turn_start", runId, nodeId },
+        runs: [{ id: runId, status: "cancelled" }],
+        attempts: [],
+        items: [{ type: "user_message", inputIntent: "turn_start", runId, nodeId }],
+      }),
+    ).toBe(true);
+  });
+
+  it("does not hide an interruption because another attempt was superseded", () => {
+    expect(
+      isOrchestrationV2TurnItemVisible({
+        item: { type: "run_interrupt_result", runId, nodeId },
+        runs: [{ id: runId, status: "interrupted" }],
+        attempts: [
+          {
+            runId,
+            rootNodeId: NodeId.make("node:timeline-visibility:older"),
+            status: "superseded",
+          },
+          { runId, rootNodeId: nodeId, status: "interrupted" },
+        ],
+        items: [{ type: "run_interrupt_result", runId, nodeId }],
+      }),
+    ).toBe(true);
+  });
+});
diff --git a/packages/shared/src/orchestrationV2Timeline.ts b/packages/shared/src/orchestrationV2Timeline.ts
new file mode 100644
index 000000000000..4dffc45d2ca5
--- /dev/null
+++ b/packages/shared/src/orchestrationV2Timeline.ts
@@ -0,0 +1,73 @@
+import type {
+  OrchestrationV2Run,
+  OrchestrationV2RunAttempt,
+  OrchestrationV2TurnItem,
+  OrchestrationV2UserMessageInputIntent,
+} from "@t3tools/contracts";
+
+type TimelineRun = Pick<OrchestrationV2Run, "id" | "status">;
+type TimelineRunAttempt = Pick<OrchestrationV2RunAttempt, "runId" | "rootNodeId" | "status">;
+type TimelineTurnItem = Pick<OrchestrationV2TurnItem, "type" | "runId" | "nodeId"> & {
+  readonly inputIntent?: OrchestrationV2UserMessageInputIntent;
+};
+
+export function isOrchestrationV2SupersededInterrupt(input: {
+  readonly item: TimelineTurnItem;
+  readonly attempts: ReadonlyArray<TimelineRunAttempt>;
+  readonly items: ReadonlyArray<TimelineTurnItem>;
+}): boolean {
+  const { item } = input;
+  if (item.type !== "run_interrupt_result" || item.runId === null || item.nodeId === null) {
+    return false;
+  }
+
+  const isSuperseded = input.attempts.some(
+    (attempt) =>
+      attempt.runId === item.runId &&
+      attempt.rootNodeId === item.nodeId &&
+      attempt.status === "superseded",
+  );
+  if (!isSuperseded) {
+    return false;
+  }
+
+  // Paired stop-then-steer results have a matching request on the same run and
+  // must stay visible. Legacy plain-steer results have no request and stay hidden.
+  const hasMatchingRequest = input.items.some(
+    (candidate) => candidate.type === "run_interrupt_request" && candidate.runId === item.runId,
+  );
+  return !hasMatchingRequest;
+}
+
+export function isOrchestrationV2TurnItemVisible(input: {
+  readonly item: TimelineTurnItem;
+  readonly runs: ReadonlyArray<TimelineRun>;
+  readonly attempts: ReadonlyArray<TimelineRunAttempt>;
+  readonly items: ReadonlyArray<TimelineTurnItem>;
+}): boolean {
+  const { item } = input;
+  if (
+    item.runId !== null &&
+    input.runs.some((run) => run.id === item.runId && run.status === "rolled_back")
+  ) {
+    return false;
+  }
+
+  // A queued message is composer state, not conversation history. When its run
+  // is cancelled the input never reached the provider, so it must not surface
+  // as a transcript row.
+  if (
+    item.type === "user_message" &&
+    item.inputIntent === "queued_turn" &&
+    item.runId !== null &&
+    input.runs.some((run) => run.id === item.runId && run.status === "cancelled")
+  ) {
+    return false;
+  }
+
+  return !isOrchestrationV2SupersededInterrupt({
+    item,
+    attempts: input.attempts,
+    items: input.items,
+  });
+}
diff --git a/packages/shared/src/t3McpToolPresentation.test.ts b/packages/shared/src/t3McpToolPresentation.test.ts
new file mode 100644
index 000000000000..06ef3147dcd1
--- /dev/null
+++ b/packages/shared/src/t3McpToolPresentation.test.ts
@@ -0,0 +1,52 @@
+import { describe, expect, it } from "vite-plus/test";
+
+import { resolveT3McpToolPresentation } from "./t3McpToolPresentation.ts";
+
+describe("resolveT3McpToolPresentation", () => {
+  it("pretty prints Claude and Cursor T3 MCP tool names", () => {
+    expect(resolveT3McpToolPresentation("mcp__t3-code__t3_thread_read")).toEqual({
+      displayName: "Read a T3 thread",
+      logo: "t3-code",
+    });
+  });
+
+  it("pretty prints Codex T3 MCP tool names", () => {
+    expect(resolveT3McpToolPresentation("t3-code.create_threads")).toEqual({
+      displayName: "Create T3 threads",
+      logo: "t3-code",
+    });
+  });
+
+  it("pretty prints bare T3 MCP toolkit names", () => {
+    expect(resolveT3McpToolPresentation("list_scheduled_tasks")).toEqual({
+      displayName: "List scheduled tasks",
+      logo: "t3-code",
+    });
+  });
+
+  it("pretty prints worktree T3 MCP tool names", () => {
+    expect(resolveT3McpToolPresentation("mcp__t3-code__t3_worktree_handoff")).toEqual({
+      displayName: "Hand off thread to a git worktree",
+      logo: "t3-code",
+    });
+    expect(resolveT3McpToolPresentation("t3-code.t3_worktree_status")).toEqual({
+      displayName: "Get thread worktree status",
+      logo: "t3-code",
+    });
+  });
+
+  it("pretty prints preview T3 MCP tool names", () => {
+    expect(resolveT3McpToolPresentation("T3-code.preview_open")).toEqual({
+      displayName: "Open a page in the preview browser",
+      logo: "t3-code",
+    });
+    expect(resolveT3McpToolPresentation("mcp__t3-code__preview_status")).toEqual({
+      displayName: "Get preview browser status",
+      logo: "t3-code",
+    });
+  });
+
+  it("keeps unknown MCP tools on the generic renderer path", () => {
+    expect(resolveT3McpToolPresentation("mcp__github__search_issues")).toBeNull();
+  });
+});
diff --git a/packages/shared/src/t3McpToolPresentation.ts b/packages/shared/src/t3McpToolPresentation.ts
new file mode 100644
index 000000000000..77498835757c
--- /dev/null
+++ b/packages/shared/src/t3McpToolPresentation.ts
@@ -0,0 +1,119 @@
+export type T3McpToolLogo = "t3-code";
+
+export interface T3McpToolPresentation {
+  readonly displayName: string;
+  readonly logo: T3McpToolLogo;
+}
+
+export type T3McpToolSummaryAction =
+  | "capabilities"
+  | "delegate"
+  | "task-status"
+  | "task-cancel"
+  | "schedule-create"
+  | "schedule-list"
+  | "schedule-update"
+  | "schedule-delete"
+  | "thread-create"
+  | "thread-list"
+  | "thread-read"
+  | "thread-send"
+  | "thread-wait"
+  | "thread-interrupt";
+
+const T3_MCP_SERVER_ALIASES = new Set(["t3-code", "t3_code", "t3code"]);
+
+const T3_MCP_TOOLS: Record<
+  string,
+  { readonly displayName: string; readonly summaryAction?: T3McpToolSummaryAction }
+> = {
+  orchestrator_capabilities: {
+    displayName: "Get orchestration capabilities",
+    summaryAction: "capabilities",
+  },
+  delegate_task: { displayName: "Delegate a child task", summaryAction: "delegate" },
+  task_status: { displayName: "Get delegated task status", summaryAction: "task-status" },
+  task_cancel: { displayName: "Cancel delegated task", summaryAction: "task-cancel" },
+  schedule_task: { displayName: "Schedule a recurring task", summaryAction: "schedule-create" },
+  list_scheduled_tasks: { displayName: "List scheduled tasks", summaryAction: "schedule-list" },
+  update_scheduled_task: {
+    displayName: "Update a scheduled task",
+    summaryAction: "schedule-update",
+  },
+  delete_scheduled_task: {
+    displayName: "Delete a scheduled task",
+    summaryAction: "schedule-delete",
+  },
+  create_threads: { displayName: "Create T3 threads", summaryAction: "thread-create" },
+  t3_thread_start: { displayName: "Start a T3 thread", summaryAction: "thread-create" },
+  t3_thread_list: { displayName: "List T3 threads", summaryAction: "thread-list" },
+  t3_thread_read: { displayName: "Read a T3 thread", summaryAction: "thread-read" },
+  t3_thread_send: { displayName: "Send to a T3 thread", summaryAction: "thread-send" },
+  t3_thread_wait: { displayName: "Wait for a T3 thread", summaryAction: "thread-wait" },
+  t3_thread_interrupt: { displayName: "Interrupt a T3 thread", summaryAction: "thread-interrupt" },
+  t3_worktree_handoff: { displayName: "Hand off thread to a git worktree" },
+  t3_worktree_status: { displayName: "Get thread worktree status" },
+  preview_status: { displayName: "Get preview browser status" },
+  preview_open: { displayName: "Open a page in the preview browser" },
+  preview_navigate: { displayName: "Navigate the preview browser" },
+  preview_snapshot: { displayName: "Snapshot the preview page" },
+  preview_click: { displayName: "Click in the preview browser" },
+  preview_press: { displayName: "Press a key in the preview browser" },
+  preview_type: { displayName: "Type in the preview browser" },
+  preview_scroll: { displayName: "Scroll the preview browser" },
+  preview_resize: { displayName: "Resize the preview browser" },
+  preview_evaluate: { displayName: "Evaluate script in the preview browser" },
+  preview_wait_for: { displayName: "Wait for the preview page" },
+  preview_set_appearance: { displayName: "Set preview browser appearance" },
+  preview_recording_start: { displayName: "Start recording the preview browser" },
+  preview_recording_stop: { displayName: "Stop recording the preview browser" },
+};
+
+function normalizeT3McpToolLabel(value: string): string {
+  return value.replace(/\s+(?:complete|completed)\s*$/i, "").trim();
+}
+
+function resolveT3McpToolName(value: string): string | null {
+  const label = normalizeT3McpToolLabel(value);
+  const mcpMatch = /^mcp__(?<server>.+?)__(?<tool>.+)$/.exec(label);
+  if (mcpMatch?.groups) {
+    const { server, tool } = mcpMatch.groups;
+    return server !== undefined &&
+      tool !== undefined &&
+      T3_MCP_SERVER_ALIASES.has(server.toLowerCase())
+      ? tool
+      : null;
+  }
+
+  const namespaceMatch = /^(?<server>t3-code|t3_code|t3code)[.:/](?<tool>.+)$/i.exec(label);
+  if (namespaceMatch?.groups) {
+    return namespaceMatch.groups.tool ?? null;
+  }
+
+  return Object.hasOwn(T3_MCP_TOOLS, label) ? label : null;
+}
+
+export function resolveT3McpToolPresentation(
+  toolName: string | null | undefined,
+): T3McpToolPresentation | null {
+  const resolvedToolName =
+    toolName === undefined || toolName === null ? null : resolveT3McpToolName(toolName);
+  if (resolvedToolName === null) {
+    return null;
+  }
+  const displayName = T3_MCP_TOOLS[resolvedToolName]?.displayName;
+  if (displayName === undefined) {
+    return null;
+  }
+  return {
+    displayName,
+    logo: "t3-code",
+  };
+}
+
+export function resolveT3McpToolSummaryAction(
+  toolName: string | null | undefined,
+): T3McpToolSummaryAction | null {
+  const name = toolName == null ? null : resolveT3McpToolName(toolName);
+  return name === null ? null : (T3_MCP_TOOLS[name]?.summaryAction ?? null);
+}
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index cdcca6f13e1f..7f8dbd3e8085 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -462,8 +462,17 @@ importers:
   apps/server:
     dependencies:
       '@anthropic-ai/claude-agent-sdk':
-        specifier: ^0.3.170
-        version: 0.3.170(@anthropic-ai/sdk@0.93.0(zod@4.4.3))(@modelcontextprotocol/sdk@1.29.0(zod@4.4.3))(zod@4.4.3)
+        specifier: ^0.3.205
+        version: 0.3.250(@anthropic-ai/sdk@0.93.0(zod@4.4.3))(@modelcontextprotocol/sdk@1.29.0(zod@4.4.3))(zod@4.4.3)
+      '@connectrpc/connect':
+        specifier: 1.7.0
+        version: 1.7.0(@bufbuild/protobuf@1.10.0)
+      '@connectrpc/connect-node':
+        specifier: 1.7.0
+        version: 1.7.0(@bufbuild/protobuf@1.10.0)(@connectrpc/connect@1.7.0(@bufbuild/protobuf@1.10.0))
+      '@cursor/sdk':
+        specifier: 1.0.22
+        version: 1.0.22
       '@effect/platform-bun':
         specifier: 4.0.0-beta.103
         version: 4.0.0-beta.103(bufferutil@4.1.0)(effect@4.0.0-beta.103(patch_hash=af36b7948b6f9c56623074662b51dade5699880c1a7c71245de73e13c3185fb6))(utf-8-validate@6.0.6)
@@ -978,8 +987,8 @@ packages:
   '@alchemy.run/node-utils@0.0.5':
     resolution: {integrity: sha512-5agdhQxWBodxa5hDRyjnpx91RTU3g+qd5fxYB7uNDCaOzB0XC47UU/KHR6zf6jhz/NXf61gJS+vhYwn8NHeRoQ==}
 
-  '@anthropic-ai/claude-agent-sdk@0.3.170':
-    resolution: {integrity: sha512-pAvhfk+iTodXZ6RF18Kz7BEUWFjL7EcR3tKuhUNdPpE1NAYCR3mSHGbafi72JsrNwKEDIs7FU31z3fqhwy8QzA==}
+  '@anthropic-ai/claude-agent-sdk@0.3.250':
+    resolution: {integrity: sha512-qT/1cBZs0+xPsQfqVOnwIk6pNW8XBkTpQS5RAXKHYb2XYCKqYc0UmOaeiYU2WeI6HEZKORa5iCaAZyKWGluShw==}
     engines: {node: '>=18.0.0'}
     peerDependencies:
       '@anthropic-ai/sdk': '>=0.93.0'
@@ -1663,6 +1672,9 @@ packages:
     cpu: [x64]
     os: [win32]
 
+  '@bufbuild/protobuf@1.10.0':
+    resolution: {integrity: sha512-QDdVFLoN93Zjg36NoQPZfsVH9tZew7wKDKyV5qRdj8ntT4wQCOradQjRaTdwMhWUYsgKsvCINKKm87FdEk96Ag==}
+
   '@callstack/liquid-glass@0.7.1':
     resolution: {integrity: sha512-N2rzs8g3kneI5G/98AZdVtjc6OUFBBFwPxVGVMoXUEI7QiioB4+aWwbImg5h8Z3Vb/T+fgLYWmmNhi27wHwE4g==}
     peerDependencies:
@@ -1839,6 +1851,58 @@ packages:
   '@cloudflare/workers-types@5.20260726.1':
     resolution: {integrity: sha512-fKgRSm3sDmOdak1LGWehS4vSPSj7/zeu0NfmE62VPjBMqWgODcOGljYvq6A75sL+7YfY3iGFGb0jVEDYq+hlmw==}
 
+  '@connectrpc/connect-node@1.7.0':
+    resolution: {integrity: sha512-6vaPIkG/NyhxlYgytLoR9KYbPhczEboFB2OYWkA9qvUz1K7efXfeGrlRxoLtpa+r8VxyIOw73w5ktNe743nD+A==}
+    engines: {node: '>=16.0.0'}
+    peerDependencies:
+      '@bufbuild/protobuf': ^1.10.0
+      '@connectrpc/connect': 1.7.0
+
+  '@connectrpc/connect-web@1.7.0':
+    resolution: {integrity: sha512-qyP0YOnUPRWwCc/VfsoydMJvkb7EyUPr2q9sHgBuJzbADjiqck1gKH5V5ZPzPhTLBvmz5UvG+wiZ5sMRQHU1MQ==}
+    peerDependencies:
+      '@bufbuild/protobuf': ^1.10.0
+      '@connectrpc/connect': 1.7.0
+
+  '@connectrpc/connect@1.7.0':
+    resolution: {integrity: sha512-iNKdJRi69YP3mq6AePRT8F/HrxWCewrhxnLMNm0vpqXAR8biwzRtO6Hjx80C6UvtKJ5sFmffQT7I4Baecz389w==}
+    peerDependencies:
+      '@bufbuild/protobuf': ^1.10.0
+
+  '@cursor/sdk-darwin-arm64@1.0.22':
+    resolution: {integrity: sha512-BdGH+cd2VtxbfwYQ52a6mHlPoJkbjpjKfUrmhFQTN3a/A0h/n2Iv6ZCfnzT+IiLv99lYDaQfqzikM2EAzEx+Qw==}
+    cpu: [arm64]
+    os: [darwin]
+    hasBin: true
+
+  '@cursor/sdk-darwin-x64@1.0.22':
+    resolution: {integrity: sha512-60rL0tYdJ8LYbOq/3cz5xlRyJsWn+LMkG8YQG6CckLsLyMFCzkK3POU0w7jIsRoC17cpSj2miJGtX2dEGSg8tg==}
+    cpu: [x64]
+    os: [darwin]
+    hasBin: true
+
+  '@cursor/sdk-linux-arm64@1.0.22':
+    resolution: {integrity: sha512-tpywB5MiBSvGUr9kErfcbG4bOmtHqOsiK+CNOVhjlUFMQ+iCRPfu0VCj+1VGAo258/V6a2GS/1d5CuR14Hq+Ow==}
+    cpu: [arm64]
+    os: [linux]
+    hasBin: true
+
+  '@cursor/sdk-linux-x64@1.0.22':
+    resolution: {integrity: sha512-tmX1kH/pyxhv0dQaJIcCQbdouLrPbKvv8iuALwMzh42piCI51q5pdRzUaWUUtH8VMdFjwZdVsDfumuSwqTlAIA==}
+    cpu: [x64]
+    os: [linux]
+    hasBin: true
+
+  '@cursor/sdk-win32-x64@1.0.22':
+    resolution: {integrity: sha512-Dy5aI6YN/9rWvGl78kG+UqqTCwdC/eT9SKf9NSPeLXriPaCRYs7JHH/93yuAUmO9IaX+mt/0tKl+CqsYaGimVg==}
+    cpu: [x64]
+    os: [win32]
+    hasBin: true
+
+  '@cursor/sdk@1.0.22':
+    resolution: {integrity: sha512-xn99xoMvq/JwIXmWrpmEGMSY88zPr6dgxGSZYv3m9PytOBrawkwx9CHKosXs8m3ihVcQ+Wrt+TaEIUsgSNc5YA==}
+    engines: {node: '>=22.13'}
+
   '@distilled.cloud/aws@0.30.2':
     resolution: {integrity: sha512-Uw2yZf7PJ2ienrKG49HN1ajnke65mTtHBUrSb/3ykeZ/8cLaSgwVhPscHxSzGByY0TEtYcYKNNmfUVISgGQl9g==}
     peerDependencies:
@@ -2638,6 +2702,10 @@ packages:
     resolution: {integrity: sha512-4aQzz9vgxcNXFfo/iyNgDDYfsU5XGKKxWxZopw0cVotHiW+U8IJbIxMaxsINs6bHhtkG3StKNPcOrn3eBuxKPw==}
     hasBin: true
 
+  '@fastify/busboy@2.1.1':
+    resolution: {integrity: sha512-vBZP4NlzfOlerQTnba4aqZoMhE/a9HY7HRqoOPaETQcSQuWEIyZMHGfVu6w9wGtGK5fED5qRs2DteVCjOH60sA==}
+    engines: {node: '>=14'}
+
   '@ff-labs/fff-bin-darwin-arm64@0.9.4':
     resolution: {integrity: sha512-xyivu2xB++O5xXDx5Qm50JsU2aXt8YgXlGVhH/HE7UMYDrE6L6f1RYdYs8Y0bn0D3D0+bFBrN5ELPszK9E4Wbw==}
     cpu: [arm64]
@@ -4376,6 +4444,12 @@ packages:
   '@standard-schema/spec@1.1.0':
     resolution: {integrity: sha512-l2aFy5jALhniG5HgqrD6jXLi/rUWrKvqN/qJx6yoJsgKhblVd+iqqU4RCXavm/jPityDo5TCvKMnpjKnOriy0w==}
 
+  '@statsig/client-core@3.31.0':
+    resolution: {integrity: sha512-SuxQD6TmVszPG7FoMKwTk/uyBuVFk7XnxI3T/E0uyb7PL7GNjONtfsoh+NqBBVUJVse0CUeSFfgJPoZy1ZOslQ==}
+
+  '@statsig/js-client@3.31.0':
+    resolution: {integrity: sha512-LFa5E0LjT6sTfZv3sNGoyRLSZ1078+agdgOA+Vm1ecjG+KbSOfBLTW7hMwimrJ29slRwbYDzbtKaPJo/R37N2g==}
+
   '@stripe/stripe-js@5.6.0':
     resolution: {integrity: sha512-w8CEY73X/7tw2KKlL3iOk679V9bWseE4GzNz3zlaYxcTjmcmWOathRb0emgo/QQ3eoNzmq68+2Y2gxluAv3xGw==}
     engines: {node: '>=12.16'}
@@ -9737,6 +9811,10 @@ packages:
   undici-types@7.16.0:
     resolution: {integrity: sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw==}
 
+  undici@5.29.0:
+    resolution: {integrity: sha512-raqeBD6NQK4SkWhQzeYKd1KmIG6dllBOTt55Rmkt4HtI9mwdWtJljnrXjAFUBLTSN67HWrOIZ3EPF4kjUw80Bg==}
+    engines: {node: '>=14.0'}
+
   undici@6.26.0:
     resolution: {integrity: sha512-4yqz8a3n5HmGTlsbADNtr/dJlhkh/55Rq798G6ibiULcXbDtaLpTl1pvdqcbFfeoj3iSi52lePFM7h9H21cw/A==}
     engines: {node: '>=18.17'}
@@ -10401,7 +10479,7 @@ snapshots:
 
   '@alchemy.run/node-utils@0.0.5': {}
 
-  '@anthropic-ai/claude-agent-sdk@0.3.170(@anthropic-ai/sdk@0.93.0(zod@4.4.3))(@modelcontextprotocol/sdk@1.29.0(zod@4.4.3))(zod@4.4.3)':
+  '@anthropic-ai/claude-agent-sdk@0.3.250(@anthropic-ai/sdk@0.93.0(zod@4.4.3))(@modelcontextprotocol/sdk@1.29.0(zod@4.4.3))(zod@4.4.3)':
     dependencies:
       '@anthropic-ai/sdk': 0.93.0(zod@4.4.3)
       '@modelcontextprotocol/sdk': 1.29.0(zod@4.4.3)
@@ -11327,6 +11405,8 @@ snapshots:
   '@bruits/satteri-win32-x64-msvc@0.9.3':
     optional: true
 
+  '@bufbuild/protobuf@1.10.0': {}
+
   '@callstack/liquid-glass@0.7.1(react-native@0.86.3(@babel/core@7.29.7)(@react-native/metro-config@0.86.3(@babel/core@7.29.7)(bufferutil@4.1.0)(utf-8-validate@6.0.6))(@types/react@19.2.16)(bufferutil@4.1.0)(react@19.2.3)(utf-8-validate@6.0.6))(react@19.2.3)':
     dependencies:
       react: 19.2.3
@@ -11516,6 +11596,51 @@ snapshots:
 
   '@cloudflare/workers-types@5.20260726.1': {}
 
+  '@connectrpc/connect-node@1.7.0(@bufbuild/protobuf@1.10.0)(@connectrpc/connect@1.7.0(@bufbuild/protobuf@1.10.0))':
+    dependencies:
+      '@bufbuild/protobuf': 1.10.0
+      '@connectrpc/connect': 1.7.0(@bufbuild/protobuf@1.10.0)
+      undici: 5.29.0
+
+  '@connectrpc/connect-web@1.7.0(@bufbuild/protobuf@1.10.0)(@connectrpc/connect@1.7.0(@bufbuild/protobuf@1.10.0))':
+    dependencies:
+      '@bufbuild/protobuf': 1.10.0
+      '@connectrpc/connect': 1.7.0(@bufbuild/protobuf@1.10.0)
+
+  '@connectrpc/connect@1.7.0(@bufbuild/protobuf@1.10.0)':
+    dependencies:
+      '@bufbuild/protobuf': 1.10.0
+
+  '@cursor/sdk-darwin-arm64@1.0.22':
+    optional: true
+
+  '@cursor/sdk-darwin-x64@1.0.22':
+    optional: true
+
+  '@cursor/sdk-linux-arm64@1.0.22':
+    optional: true
+
+  '@cursor/sdk-linux-x64@1.0.22':
+    optional: true
+
+  '@cursor/sdk-win32-x64@1.0.22':
+    optional: true
+
+  '@cursor/sdk@1.0.22':
+    dependencies:
+      '@bufbuild/protobuf': 1.10.0
+      '@connectrpc/connect': 1.7.0(@bufbuild/protobuf@1.10.0)
+      '@connectrpc/connect-node': 1.7.0(@bufbuild/protobuf@1.10.0)(@connectrpc/connect@1.7.0(@bufbuild/protobuf@1.10.0))
+      '@connectrpc/connect-web': 1.7.0(@bufbuild/protobuf@1.10.0)(@connectrpc/connect@1.7.0(@bufbuild/protobuf@1.10.0))
+      '@statsig/js-client': 3.31.0
+      zod: 3.25.76
+    optionalDependencies:
+      '@cursor/sdk-darwin-arm64': 1.0.22
+      '@cursor/sdk-darwin-x64': 1.0.22
+      '@cursor/sdk-linux-arm64': 1.0.22
+      '@cursor/sdk-linux-x64': 1.0.22
+      '@cursor/sdk-win32-x64': 1.0.22
+
   '@distilled.cloud/aws@0.30.2(effect@4.0.0-beta.103(patch_hash=af36b7948b6f9c56623074662b51dade5699880c1a7c71245de73e13c3185fb6))':
     dependencies:
       '@aws-crypto/crc32': 5.2.0
@@ -12584,6 +12709,8 @@ snapshots:
       chalk: 4.1.2
       js-yaml: 4.2.0
 
+  '@fastify/busboy@2.1.1': {}
+
   '@ff-labs/fff-bin-darwin-arm64@0.9.4':
     optional: true
 
@@ -14172,6 +14299,12 @@ snapshots:
 
   '@standard-schema/spec@1.1.0': {}
 
+  '@statsig/client-core@3.31.0': {}
+
+  '@statsig/js-client@3.31.0':
+    dependencies:
+      '@statsig/client-core': 3.31.0
+
   '@stripe/stripe-js@5.6.0': {}
 
   '@swc/helpers@0.5.21':
@@ -20510,6 +20643,10 @@ snapshots:
 
   undici-types@7.16.0: {}
 
+  undici@5.29.0:
+    dependencies:
+      '@fastify/busboy': 2.1.1
+
   undici@6.26.0: {}
 
   undici@7.27.1: {}
diff --git a/vite.config.ts b/vite.config.ts
index c5ceb42ed2ea..f624257b5c0b 100644
--- a/vite.config.ts
+++ b/vite.config.ts
@@ -12,6 +12,7 @@ export default defineConfig({
     environment: "node",
     exclude: [
       "**/.repos/**",
+      "**/.t3/**",
       "**/node_modules/**",
       "**/dist/**",
       "**/dist-electron/**",